diff --git a/CHANGELOG.md b/CHANGELOG.md
index 840a583b46d..c6251063cfb 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -16,6 +16,7 @@
 * Fix #6802: Java generator support for required spec and status
 * Fix #5993: Support for Kubernetes v1.31 (elli)
 * Fix #6767: Support for Kubernetes v1.32 (penelope) 
+* Fix #6777: Added Javadoc comments to all generated models
 
 #### _**Note**_: Breaking changes
 
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEAuthorization.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEAuthorization.java
index 7235343cdb5..2502b1054df 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEAuthorization.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEAuthorization.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ACMEAuthorization contains data returned from the ACME server on an authorization that must be completed in order validate a DNS name on an ACME Order resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -97,52 +100,82 @@ public ACMEAuthorization(List<ACMEChallenge> challenges, String identifier, Stri
         this.wildcard = wildcard;
     }
 
+    /**
+     * Challenges specifies the challenge types offered by the ACME server. One of these challenge types will be selected when validating the DNS name and an appropriate Challenge resource will be created to perform the ACME challenge process.
+     */
     @JsonProperty("challenges")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ACMEChallenge> getChallenges() {
         return challenges;
     }
 
+    /**
+     * Challenges specifies the challenge types offered by the ACME server. One of these challenge types will be selected when validating the DNS name and an appropriate Challenge resource will be created to perform the ACME challenge process.
+     */
     @JsonProperty("challenges")
     public void setChallenges(List<ACMEChallenge> challenges) {
         this.challenges = challenges;
     }
 
+    /**
+     * Identifier is the DNS name to be validated as part of this authorization
+     */
     @JsonProperty("identifier")
     public String getIdentifier() {
         return identifier;
     }
 
+    /**
+     * Identifier is the DNS name to be validated as part of this authorization
+     */
     @JsonProperty("identifier")
     public void setIdentifier(String identifier) {
         this.identifier = identifier;
     }
 
+    /**
+     * InitialState is the initial state of the ACME authorization when first fetched from the ACME server. If an Authorization is already 'valid', the Order controller will not create a Challenge resource for the authorization. This will occur when working with an ACME server that enables 'authz reuse' (such as Let's Encrypt's production endpoint). If not set and 'identifier' is set, the state is assumed to be pending and a Challenge will be created.
+     */
     @JsonProperty("initialState")
     public String getInitialState() {
         return initialState;
     }
 
+    /**
+     * InitialState is the initial state of the ACME authorization when first fetched from the ACME server. If an Authorization is already 'valid', the Order controller will not create a Challenge resource for the authorization. This will occur when working with an ACME server that enables 'authz reuse' (such as Let's Encrypt's production endpoint). If not set and 'identifier' is set, the state is assumed to be pending and a Challenge will be created.
+     */
     @JsonProperty("initialState")
     public void setInitialState(String initialState) {
         this.initialState = initialState;
     }
 
+    /**
+     * URL is the URL of the Authorization that must be completed
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * URL is the URL of the Authorization that must be completed
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
     }
 
+    /**
+     * Wildcard will be true if this authorization is for a wildcard DNS name. If this is true, the identifier will be the &#42;non-wildcard&#42; version of the DNS name. For example, if '&#42;.example.com' is the DNS name being validated, this field will be 'true' and the 'identifier' field will be 'example.com'.
+     */
     @JsonProperty("wildcard")
     public Boolean getWildcard() {
         return wildcard;
     }
 
+    /**
+     * Wildcard will be true if this authorization is for a wildcard DNS name. If this is true, the identifier will be the &#42;non-wildcard&#42; version of the DNS name. For example, if '&#42;.example.com' is the DNS name being validated, this field will be 'true' and the 'identifier' field will be 'example.com'.
+     */
     @JsonProperty("wildcard")
     public void setWildcard(Boolean wildcard) {
         this.wildcard = wildcard;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallenge.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallenge.java
index 0a6957654b7..762ab8a93a9 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallenge.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallenge.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Challenge specifies a challenge offered by the ACME server for an Order. An appropriate Challenge resource can be created to perform the ACME challenge process.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ACMEChallenge(String token, String type, String url) {
         this.url = url;
     }
 
+    /**
+     * Token is the token that must be presented for this challenge. This is used to compute the 'key' that must also be presented.
+     */
     @JsonProperty("token")
     public String getToken() {
         return token;
     }
 
+    /**
+     * Token is the token that must be presented for this challenge. This is used to compute the 'key' that must also be presented.
+     */
     @JsonProperty("token")
     public void setToken(String token) {
         this.token = token;
     }
 
+    /**
+     * Type is the type of challenge being offered, e.g. 'http-01', 'dns-01', 'tls-sni-01', etc. This is the raw value retrieved from the ACME server. Only 'http-01' and 'dns-01' are supported by cert-manager, other values will be ignored.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of challenge being offered, e.g. 'http-01', 'dns-01', 'tls-sni-01', etc. This is the raw value retrieved from the ACME server. Only 'http-01' and 'dns-01' are supported by cert-manager, other values will be ignored.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * URL is the URL of this challenge. It can be used to retrieve additional metadata about the Challenge from the ACME server.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * URL is the URL of this challenge. It can be used to retrieve additional metadata about the Challenge from the ACME server.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolver.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolver.java
index f61566eef0c..f7d38411a61 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolver.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolver.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * An ACMEChallengeSolver describes how to solve ACME challenges for the issuer it is part of. A selector may be provided to use different solving strategies for different DNS names. Only one of HTTP01 or DNS01 must be provided.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ACMEChallengeSolver(ACMEChallengeSolverDNS01 dns01, ACMEChallengeSolverHT
         this.selector = selector;
     }
 
+    /**
+     * An ACMEChallengeSolver describes how to solve ACME challenges for the issuer it is part of. A selector may be provided to use different solving strategies for different DNS names. Only one of HTTP01 or DNS01 must be provided.
+     */
     @JsonProperty("dns01")
     public ACMEChallengeSolverDNS01 getDns01() {
         return dns01;
     }
 
+    /**
+     * An ACMEChallengeSolver describes how to solve ACME challenges for the issuer it is part of. A selector may be provided to use different solving strategies for different DNS names. Only one of HTTP01 or DNS01 must be provided.
+     */
     @JsonProperty("dns01")
     public void setDns01(ACMEChallengeSolverDNS01 dns01) {
         this.dns01 = dns01;
     }
 
+    /**
+     * An ACMEChallengeSolver describes how to solve ACME challenges for the issuer it is part of. A selector may be provided to use different solving strategies for different DNS names. Only one of HTTP01 or DNS01 must be provided.
+     */
     @JsonProperty("http01")
     public ACMEChallengeSolverHTTP01 getHttp01() {
         return http01;
     }
 
+    /**
+     * An ACMEChallengeSolver describes how to solve ACME challenges for the issuer it is part of. A selector may be provided to use different solving strategies for different DNS names. Only one of HTTP01 or DNS01 must be provided.
+     */
     @JsonProperty("http01")
     public void setHttp01(ACMEChallengeSolverHTTP01 http01) {
         this.http01 = http01;
     }
 
+    /**
+     * An ACMEChallengeSolver describes how to solve ACME challenges for the issuer it is part of. A selector may be provided to use different solving strategies for different DNS names. Only one of HTTP01 or DNS01 must be provided.
+     */
     @JsonProperty("selector")
     public CertificateDNSNameSelector getSelector() {
         return selector;
     }
 
+    /**
+     * An ACMEChallengeSolver describes how to solve ACME challenges for the issuer it is part of. A selector may be provided to use different solving strategies for different DNS names. Only one of HTTP01 or DNS01 must be provided.
+     */
     @JsonProperty("selector")
     public void setSelector(CertificateDNSNameSelector selector) {
         this.selector = selector;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverDNS01.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverDNS01.java
index e6233896603..5a73d9da98d 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverDNS01.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverDNS01.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Used to configure a DNS01 challenge provider to be used when solving DNS01 challenges. Only one DNS provider may be configured per solver.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -114,101 +117,161 @@ public ACMEChallengeSolverDNS01(ACMEIssuerDNS01ProviderAcmeDNS acmeDNS, ACMEIssu
         this.webhook = webhook;
     }
 
+    /**
+     * Used to configure a DNS01 challenge provider to be used when solving DNS01 challenges. Only one DNS provider may be configured per solver.
+     */
     @JsonProperty("acmeDNS")
     public ACMEIssuerDNS01ProviderAcmeDNS getAcmeDNS() {
         return acmeDNS;
     }
 
+    /**
+     * Used to configure a DNS01 challenge provider to be used when solving DNS01 challenges. Only one DNS provider may be configured per solver.
+     */
     @JsonProperty("acmeDNS")
     public void setAcmeDNS(ACMEIssuerDNS01ProviderAcmeDNS acmeDNS) {
         this.acmeDNS = acmeDNS;
     }
 
+    /**
+     * Used to configure a DNS01 challenge provider to be used when solving DNS01 challenges. Only one DNS provider may be configured per solver.
+     */
     @JsonProperty("akamai")
     public ACMEIssuerDNS01ProviderAkamai getAkamai() {
         return akamai;
     }
 
+    /**
+     * Used to configure a DNS01 challenge provider to be used when solving DNS01 challenges. Only one DNS provider may be configured per solver.
+     */
     @JsonProperty("akamai")
     public void setAkamai(ACMEIssuerDNS01ProviderAkamai akamai) {
         this.akamai = akamai;
     }
 
+    /**
+     * Used to configure a DNS01 challenge provider to be used when solving DNS01 challenges. Only one DNS provider may be configured per solver.
+     */
     @JsonProperty("azureDNS")
     public ACMEIssuerDNS01ProviderAzureDNS getAzureDNS() {
         return azureDNS;
     }
 
+    /**
+     * Used to configure a DNS01 challenge provider to be used when solving DNS01 challenges. Only one DNS provider may be configured per solver.
+     */
     @JsonProperty("azureDNS")
     public void setAzureDNS(ACMEIssuerDNS01ProviderAzureDNS azureDNS) {
         this.azureDNS = azureDNS;
     }
 
+    /**
+     * Used to configure a DNS01 challenge provider to be used when solving DNS01 challenges. Only one DNS provider may be configured per solver.
+     */
     @JsonProperty("cloudDNS")
     public ACMEIssuerDNS01ProviderCloudDNS getCloudDNS() {
         return cloudDNS;
     }
 
+    /**
+     * Used to configure a DNS01 challenge provider to be used when solving DNS01 challenges. Only one DNS provider may be configured per solver.
+     */
     @JsonProperty("cloudDNS")
     public void setCloudDNS(ACMEIssuerDNS01ProviderCloudDNS cloudDNS) {
         this.cloudDNS = cloudDNS;
     }
 
+    /**
+     * Used to configure a DNS01 challenge provider to be used when solving DNS01 challenges. Only one DNS provider may be configured per solver.
+     */
     @JsonProperty("cloudflare")
     public ACMEIssuerDNS01ProviderCloudflare getCloudflare() {
         return cloudflare;
     }
 
+    /**
+     * Used to configure a DNS01 challenge provider to be used when solving DNS01 challenges. Only one DNS provider may be configured per solver.
+     */
     @JsonProperty("cloudflare")
     public void setCloudflare(ACMEIssuerDNS01ProviderCloudflare cloudflare) {
         this.cloudflare = cloudflare;
     }
 
+    /**
+     * CNAMEStrategy configures how the DNS01 provider should handle CNAME records when found in DNS zones.
+     */
     @JsonProperty("cnameStrategy")
     public String getCnameStrategy() {
         return cnameStrategy;
     }
 
+    /**
+     * CNAMEStrategy configures how the DNS01 provider should handle CNAME records when found in DNS zones.
+     */
     @JsonProperty("cnameStrategy")
     public void setCnameStrategy(String cnameStrategy) {
         this.cnameStrategy = cnameStrategy;
     }
 
+    /**
+     * Used to configure a DNS01 challenge provider to be used when solving DNS01 challenges. Only one DNS provider may be configured per solver.
+     */
     @JsonProperty("digitalocean")
     public ACMEIssuerDNS01ProviderDigitalOcean getDigitalocean() {
         return digitalocean;
     }
 
+    /**
+     * Used to configure a DNS01 challenge provider to be used when solving DNS01 challenges. Only one DNS provider may be configured per solver.
+     */
     @JsonProperty("digitalocean")
     public void setDigitalocean(ACMEIssuerDNS01ProviderDigitalOcean digitalocean) {
         this.digitalocean = digitalocean;
     }
 
+    /**
+     * Used to configure a DNS01 challenge provider to be used when solving DNS01 challenges. Only one DNS provider may be configured per solver.
+     */
     @JsonProperty("rfc2136")
     public ACMEIssuerDNS01ProviderRFC2136 getRfc2136() {
         return rfc2136;
     }
 
+    /**
+     * Used to configure a DNS01 challenge provider to be used when solving DNS01 challenges. Only one DNS provider may be configured per solver.
+     */
     @JsonProperty("rfc2136")
     public void setRfc2136(ACMEIssuerDNS01ProviderRFC2136 rfc2136) {
         this.rfc2136 = rfc2136;
     }
 
+    /**
+     * Used to configure a DNS01 challenge provider to be used when solving DNS01 challenges. Only one DNS provider may be configured per solver.
+     */
     @JsonProperty("route53")
     public ACMEIssuerDNS01ProviderRoute53 getRoute53() {
         return route53;
     }
 
+    /**
+     * Used to configure a DNS01 challenge provider to be used when solving DNS01 challenges. Only one DNS provider may be configured per solver.
+     */
     @JsonProperty("route53")
     public void setRoute53(ACMEIssuerDNS01ProviderRoute53 route53) {
         this.route53 = route53;
     }
 
+    /**
+     * Used to configure a DNS01 challenge provider to be used when solving DNS01 challenges. Only one DNS provider may be configured per solver.
+     */
     @JsonProperty("webhook")
     public ACMEIssuerDNS01ProviderWebhook getWebhook() {
         return webhook;
     }
 
+    /**
+     * Used to configure a DNS01 challenge provider to be used when solving DNS01 challenges. Only one DNS provider may be configured per solver.
+     */
     @JsonProperty("webhook")
     public void setWebhook(ACMEIssuerDNS01ProviderWebhook webhook) {
         this.webhook = webhook;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverHTTP01.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverHTTP01.java
index 53beec7b93f..ae30447537f 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverHTTP01.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverHTTP01.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ACMEChallengeSolverHTTP01 contains configuration detailing how to solve HTTP01 challenges within a Kubernetes cluster. Typically this is accomplished through creating 'routes' of some description that configure ingress controllers to direct traffic to 'solver pods', which are responsible for responding to the ACME server's HTTP requests. Only one of Ingress / Gateway can be specified.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ACMEChallengeSolverHTTP01(ACMEChallengeSolverHTTP01GatewayHTTPRoute gatew
         this.ingress = ingress;
     }
 
+    /**
+     * ACMEChallengeSolverHTTP01 contains configuration detailing how to solve HTTP01 challenges within a Kubernetes cluster. Typically this is accomplished through creating 'routes' of some description that configure ingress controllers to direct traffic to 'solver pods', which are responsible for responding to the ACME server's HTTP requests. Only one of Ingress / Gateway can be specified.
+     */
     @JsonProperty("gatewayHTTPRoute")
     public ACMEChallengeSolverHTTP01GatewayHTTPRoute getGatewayHTTPRoute() {
         return gatewayHTTPRoute;
     }
 
+    /**
+     * ACMEChallengeSolverHTTP01 contains configuration detailing how to solve HTTP01 challenges within a Kubernetes cluster. Typically this is accomplished through creating 'routes' of some description that configure ingress controllers to direct traffic to 'solver pods', which are responsible for responding to the ACME server's HTTP requests. Only one of Ingress / Gateway can be specified.
+     */
     @JsonProperty("gatewayHTTPRoute")
     public void setGatewayHTTPRoute(ACMEChallengeSolverHTTP01GatewayHTTPRoute gatewayHTTPRoute) {
         this.gatewayHTTPRoute = gatewayHTTPRoute;
     }
 
+    /**
+     * ACMEChallengeSolverHTTP01 contains configuration detailing how to solve HTTP01 challenges within a Kubernetes cluster. Typically this is accomplished through creating 'routes' of some description that configure ingress controllers to direct traffic to 'solver pods', which are responsible for responding to the ACME server's HTTP requests. Only one of Ingress / Gateway can be specified.
+     */
     @JsonProperty("ingress")
     public ACMEChallengeSolverHTTP01Ingress getIngress() {
         return ingress;
     }
 
+    /**
+     * ACMEChallengeSolverHTTP01 contains configuration detailing how to solve HTTP01 challenges within a Kubernetes cluster. Typically this is accomplished through creating 'routes' of some description that configure ingress controllers to direct traffic to 'solver pods', which are responsible for responding to the ACME server's HTTP requests. Only one of Ingress / Gateway can be specified.
+     */
     @JsonProperty("ingress")
     public void setIngress(ACMEChallengeSolverHTTP01Ingress ingress) {
         this.ingress = ingress;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverHTTP01GatewayHTTPRoute.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverHTTP01GatewayHTTPRoute.java
index beca2bb5ecc..838d0716786 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverHTTP01GatewayHTTPRoute.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverHTTP01GatewayHTTPRoute.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * The ACMEChallengeSolverHTTP01GatewayHTTPRoute solver will create HTTPRoute objects for a Gateway class routing to an ACME challenge solver pod.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,43 +98,67 @@ public ACMEChallengeSolverHTTP01GatewayHTTPRoute(Map<String, String> labels, Lis
         this.serviceType = serviceType;
     }
 
+    /**
+     * Custom labels that will be applied to HTTPRoutes created by cert-manager while solving HTTP-01 challenges.
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabels() {
         return labels;
     }
 
+    /**
+     * Custom labels that will be applied to HTTPRoutes created by cert-manager while solving HTTP-01 challenges.
+     */
     @JsonProperty("labels")
     public void setLabels(Map<String, String> labels) {
         this.labels = labels;
     }
 
+    /**
+     * When solving an HTTP-01 challenge, cert-manager creates an HTTPRoute. cert-manager needs to know which parentRefs should be used when creating the HTTPRoute. Usually, the parentRef references a Gateway. See: https://gateway-api.sigs.k8s.io/api-types/httproute/#attaching-to-gateways
+     */
     @JsonProperty("parentRefs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ParentReference> getParentRefs() {
         return parentRefs;
     }
 
+    /**
+     * When solving an HTTP-01 challenge, cert-manager creates an HTTPRoute. cert-manager needs to know which parentRefs should be used when creating the HTTPRoute. Usually, the parentRef references a Gateway. See: https://gateway-api.sigs.k8s.io/api-types/httproute/#attaching-to-gateways
+     */
     @JsonProperty("parentRefs")
     public void setParentRefs(List<ParentReference> parentRefs) {
         this.parentRefs = parentRefs;
     }
 
+    /**
+     * The ACMEChallengeSolverHTTP01GatewayHTTPRoute solver will create HTTPRoute objects for a Gateway class routing to an ACME challenge solver pod.
+     */
     @JsonProperty("podTemplate")
     public ACMEChallengeSolverHTTP01IngressPodTemplate getPodTemplate() {
         return podTemplate;
     }
 
+    /**
+     * The ACMEChallengeSolverHTTP01GatewayHTTPRoute solver will create HTTPRoute objects for a Gateway class routing to an ACME challenge solver pod.
+     */
     @JsonProperty("podTemplate")
     public void setPodTemplate(ACMEChallengeSolverHTTP01IngressPodTemplate podTemplate) {
         this.podTemplate = podTemplate;
     }
 
+    /**
+     * Optional service type for Kubernetes solver service. Supported values are NodePort or ClusterIP. If unset, defaults to NodePort.
+     */
     @JsonProperty("serviceType")
     public String getServiceType() {
         return serviceType;
     }
 
+    /**
+     * Optional service type for Kubernetes solver service. Supported values are NodePort or ClusterIP. If unset, defaults to NodePort.
+     */
     @JsonProperty("serviceType")
     public void setServiceType(String serviceType) {
         this.serviceType = serviceType;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverHTTP01Ingress.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverHTTP01Ingress.java
index 18c79fb00f2..04a1ef9e94c 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverHTTP01Ingress.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverHTTP01Ingress.java
@@ -98,21 +98,33 @@ public ACMEChallengeSolverHTTP01Ingress(String className, String ingressClassNam
         this.serviceType = serviceType;
     }
 
+    /**
+     * This field configures the annotation `kubernetes.io/ingress.class` when creating Ingress resources to solve ACME challenges that use this challenge solver. Only one of `class`, `name` or `ingressClassName` may be specified.
+     */
     @JsonProperty("class")
     public String getClassName() {
         return className;
     }
 
+    /**
+     * This field configures the annotation `kubernetes.io/ingress.class` when creating Ingress resources to solve ACME challenges that use this challenge solver. Only one of `class`, `name` or `ingressClassName` may be specified.
+     */
     @JsonProperty("class")
     public void setClassName(String className) {
         this.className = className;
     }
 
+    /**
+     * This field configures the field `ingressClassName` on the created Ingress resources used to solve ACME challenges that use this challenge solver. This is the recommended way of configuring the ingress class. Only one of `class`, `name` or `ingressClassName` may be specified.
+     */
     @JsonProperty("ingressClassName")
     public String getIngressClassName() {
         return ingressClassName;
     }
 
+    /**
+     * This field configures the field `ingressClassName` on the created Ingress resources used to solve ACME challenges that use this challenge solver. This is the recommended way of configuring the ingress class. Only one of `class`, `name` or `ingressClassName` may be specified.
+     */
     @JsonProperty("ingressClassName")
     public void setIngressClassName(String ingressClassName) {
         this.ingressClassName = ingressClassName;
@@ -128,11 +140,17 @@ public void setIngressTemplate(ACMEChallengeSolverHTTP01IngressTemplate ingressT
         this.ingressTemplate = ingressTemplate;
     }
 
+    /**
+     * The name of the ingress resource that should have ACME challenge solving routes inserted into it in order to solve HTTP01 challenges. This is typically used in conjunction with ingress controllers like ingress-gce, which maintains a 1:1 mapping between external IPs and ingress resources. Only one of `class`, `name` or `ingressClassName` may be specified.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The name of the ingress resource that should have ACME challenge solving routes inserted into it in order to solve HTTP01 challenges. This is typically used in conjunction with ingress controllers like ingress-gce, which maintains a 1:1 mapping between external IPs and ingress resources. Only one of `class`, `name` or `ingressClassName` may be specified.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
@@ -148,11 +166,17 @@ public void setPodTemplate(ACMEChallengeSolverHTTP01IngressPodTemplate podTempla
         this.podTemplate = podTemplate;
     }
 
+    /**
+     * Optional service type for Kubernetes solver service. Supported values are NodePort or ClusterIP. If unset, defaults to NodePort.
+     */
     @JsonProperty("serviceType")
     public String getServiceType() {
         return serviceType;
     }
 
+    /**
+     * Optional service type for Kubernetes solver service. Supported values are NodePort or ClusterIP. If unset, defaults to NodePort.
+     */
     @JsonProperty("serviceType")
     public void setServiceType(String serviceType) {
         this.serviceType = serviceType;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverHTTP01IngressObjectMeta.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverHTTP01IngressObjectMeta.java
index bcf4d4c3ff4..43362a3ca62 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverHTTP01IngressObjectMeta.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverHTTP01IngressObjectMeta.java
@@ -84,23 +84,35 @@ public ACMEChallengeSolverHTTP01IngressObjectMeta(Map<String, String> annotation
         this.labels = labels;
     }
 
+    /**
+     * Annotations that should be added to the created ACME HTTP01 solver ingress.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations that should be added to the created ACME HTTP01 solver ingress.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Labels that should be added to the created ACME HTTP01 solver ingress.
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabels() {
         return labels;
     }
 
+    /**
+     * Labels that should be added to the created ACME HTTP01 solver ingress.
+     */
     @JsonProperty("labels")
     public void setLabels(Map<String, String> labels) {
         this.labels = labels;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverHTTP01IngressPodObjectMeta.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverHTTP01IngressPodObjectMeta.java
index a695674842c..24897d4b35f 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverHTTP01IngressPodObjectMeta.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverHTTP01IngressPodObjectMeta.java
@@ -84,23 +84,35 @@ public ACMEChallengeSolverHTTP01IngressPodObjectMeta(Map<String, String> annotat
         this.labels = labels;
     }
 
+    /**
+     * Annotations that should be added to the created ACME HTTP01 solver pods.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations that should be added to the created ACME HTTP01 solver pods.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Labels that should be added to the created ACME HTTP01 solver pods.
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabels() {
         return labels;
     }
 
+    /**
+     * Labels that should be added to the created ACME HTTP01 solver pods.
+     */
     @JsonProperty("labels")
     public void setLabels(Map<String, String> labels) {
         this.labels = labels;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverHTTP01IngressPodSecurityContext.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverHTTP01IngressPodSecurityContext.java
index beff5aa2d4f..9e06a4ef795 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverHTTP01IngressPodSecurityContext.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverHTTP01IngressPodSecurityContext.java
@@ -117,51 +117,81 @@ public ACMEChallengeSolverHTTP01IngressPodSecurityContext(Long fsGroup, String f
         this.sysctls = sysctls;
     }
 
+    /**
+     * A special supplemental group that applies to all containers in a pod. Some volume types allow the Kubelet to change the ownership of that volume to be owned by the pod:<br><p> <br><p> 1. The owning GID will be the FSGroup 2. The setgid bit is set (new files created in the volume will be owned by FSGroup) 3. The permission bits are OR'd with rw-rw----<br><p> <br><p> If unset, the Kubelet will not modify the ownership and permissions of any volume. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("fsGroup")
     public Long getFsGroup() {
         return fsGroup;
     }
 
+    /**
+     * A special supplemental group that applies to all containers in a pod. Some volume types allow the Kubelet to change the ownership of that volume to be owned by the pod:<br><p> <br><p> 1. The owning GID will be the FSGroup 2. The setgid bit is set (new files created in the volume will be owned by FSGroup) 3. The permission bits are OR'd with rw-rw----<br><p> <br><p> If unset, the Kubelet will not modify the ownership and permissions of any volume. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("fsGroup")
     public void setFsGroup(Long fsGroup) {
         this.fsGroup = fsGroup;
     }
 
+    /**
+     * fsGroupChangePolicy defines behavior of changing ownership and permission of the volume before being exposed inside Pod. This field will only apply to volume types which support fsGroup based ownership(and permissions). It will have no effect on ephemeral volume types such as: secret, configmaps and emptydir. Valid values are "OnRootMismatch" and "Always". If not specified, "Always" is used. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("fsGroupChangePolicy")
     public String getFsGroupChangePolicy() {
         return fsGroupChangePolicy;
     }
 
+    /**
+     * fsGroupChangePolicy defines behavior of changing ownership and permission of the volume before being exposed inside Pod. This field will only apply to volume types which support fsGroup based ownership(and permissions). It will have no effect on ephemeral volume types such as: secret, configmaps and emptydir. Valid values are "OnRootMismatch" and "Always". If not specified, "Always" is used. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("fsGroupChangePolicy")
     public void setFsGroupChangePolicy(String fsGroupChangePolicy) {
         this.fsGroupChangePolicy = fsGroupChangePolicy;
     }
 
+    /**
+     * The GID to run the entrypoint of the container process. Uses runtime default if unset. May also be set in SecurityContext.  If set in both SecurityContext and PodSecurityContext, the value specified in SecurityContext takes precedence for that container. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("runAsGroup")
     public Long getRunAsGroup() {
         return runAsGroup;
     }
 
+    /**
+     * The GID to run the entrypoint of the container process. Uses runtime default if unset. May also be set in SecurityContext.  If set in both SecurityContext and PodSecurityContext, the value specified in SecurityContext takes precedence for that container. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("runAsGroup")
     public void setRunAsGroup(Long runAsGroup) {
         this.runAsGroup = runAsGroup;
     }
 
+    /**
+     * Indicates that the container must run as a non-root user. If true, the Kubelet will validate the image at runtime to ensure that it does not run as UID 0 (root) and fail to start the container if it does. If unset or false, no such validation will be performed. May also be set in SecurityContext.  If set in both SecurityContext and PodSecurityContext, the value specified in SecurityContext takes precedence.
+     */
     @JsonProperty("runAsNonRoot")
     public Boolean getRunAsNonRoot() {
         return runAsNonRoot;
     }
 
+    /**
+     * Indicates that the container must run as a non-root user. If true, the Kubelet will validate the image at runtime to ensure that it does not run as UID 0 (root) and fail to start the container if it does. If unset or false, no such validation will be performed. May also be set in SecurityContext.  If set in both SecurityContext and PodSecurityContext, the value specified in SecurityContext takes precedence.
+     */
     @JsonProperty("runAsNonRoot")
     public void setRunAsNonRoot(Boolean runAsNonRoot) {
         this.runAsNonRoot = runAsNonRoot;
     }
 
+    /**
+     * The UID to run the entrypoint of the container process. Defaults to user specified in image metadata if unspecified. May also be set in SecurityContext.  If set in both SecurityContext and PodSecurityContext, the value specified in SecurityContext takes precedence for that container. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("runAsUser")
     public Long getRunAsUser() {
         return runAsUser;
     }
 
+    /**
+     * The UID to run the entrypoint of the container process. Defaults to user specified in image metadata if unspecified. May also be set in SecurityContext.  If set in both SecurityContext and PodSecurityContext, the value specified in SecurityContext takes precedence for that container. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("runAsUser")
     public void setRunAsUser(Long runAsUser) {
         this.runAsUser = runAsUser;
@@ -187,23 +217,35 @@ public void setSeccompProfile(SeccompProfile seccompProfile) {
         this.seccompProfile = seccompProfile;
     }
 
+    /**
+     * A list of groups applied to the first process run in each container, in addition to the container's primary GID, the fsGroup (if specified), and group memberships defined in the container image for the uid of the container process. If unspecified, no additional groups are added to any container. Note that group memberships defined in the container image for the uid of the container process are still effective, even if they are not included in this list. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("supplementalGroups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Long> getSupplementalGroups() {
         return supplementalGroups;
     }
 
+    /**
+     * A list of groups applied to the first process run in each container, in addition to the container's primary GID, the fsGroup (if specified), and group memberships defined in the container image for the uid of the container process. If unspecified, no additional groups are added to any container. Note that group memberships defined in the container image for the uid of the container process are still effective, even if they are not included in this list. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("supplementalGroups")
     public void setSupplementalGroups(List<Long> supplementalGroups) {
         this.supplementalGroups = supplementalGroups;
     }
 
+    /**
+     * Sysctls hold a list of namespaced sysctls used for the pod. Pods with unsupported sysctls (by the container runtime) might fail to launch. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("sysctls")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Sysctl> getSysctls() {
         return sysctls;
     }
 
+    /**
+     * Sysctls hold a list of namespaced sysctls used for the pod. Pods with unsupported sysctls (by the container runtime) might fail to launch. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("sysctls")
     public void setSysctls(List<Sysctl> sysctls) {
         this.sysctls = sysctls;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverHTTP01IngressPodSpec.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverHTTP01IngressPodSpec.java
index 3bc0accd18d..4c5986a743e 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverHTTP01IngressPodSpec.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEChallengeSolverHTTP01IngressPodSpec.java
@@ -119,33 +119,51 @@ public void setAffinity(Affinity affinity) {
         this.affinity = affinity;
     }
 
+    /**
+     * If specified, the pod's imagePullSecrets
+     */
     @JsonProperty("imagePullSecrets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LocalObjectReference> getImagePullSecrets() {
         return imagePullSecrets;
     }
 
+    /**
+     * If specified, the pod's imagePullSecrets
+     */
     @JsonProperty("imagePullSecrets")
     public void setImagePullSecrets(List<LocalObjectReference> imagePullSecrets) {
         this.imagePullSecrets = imagePullSecrets;
     }
 
+    /**
+     * NodeSelector is a selector which must be true for the pod to fit on a node. Selector which must match a node's labels for the pod to be scheduled on that node. More info: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * NodeSelector is a selector which must be true for the pod to fit on a node. Selector which must match a node's labels for the pod to be scheduled on that node. More info: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * If specified, the pod's priorityClassName.
+     */
     @JsonProperty("priorityClassName")
     public String getPriorityClassName() {
         return priorityClassName;
     }
 
+    /**
+     * If specified, the pod's priorityClassName.
+     */
     @JsonProperty("priorityClassName")
     public void setPriorityClassName(String priorityClassName) {
         this.priorityClassName = priorityClassName;
@@ -161,22 +179,34 @@ public void setSecurityContext(ACMEChallengeSolverHTTP01IngressPodSecurityContex
         this.securityContext = securityContext;
     }
 
+    /**
+     * If specified, the pod's service account
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * If specified, the pod's service account
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * If specified, the pod's tolerations.
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * If specified, the pod's tolerations.
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEExternalAccountBinding.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEExternalAccountBinding.java
index e92a95d8350..38238620e76 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEExternalAccountBinding.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEExternalAccountBinding.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ACMEExternalAccountBinding is a reference to a CA external account of the ACME server.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,31 +90,49 @@ public ACMEExternalAccountBinding(String keyAlgorithm, String keyID, SecretKeySe
         this.keySecretRef = keySecretRef;
     }
 
+    /**
+     * Deprecated: keyAlgorithm field exists for historical compatibility reasons and should not be used. The algorithm is now hardcoded to HS256 in golang/x/crypto/acme.
+     */
     @JsonProperty("keyAlgorithm")
     public String getKeyAlgorithm() {
         return keyAlgorithm;
     }
 
+    /**
+     * Deprecated: keyAlgorithm field exists for historical compatibility reasons and should not be used. The algorithm is now hardcoded to HS256 in golang/x/crypto/acme.
+     */
     @JsonProperty("keyAlgorithm")
     public void setKeyAlgorithm(String keyAlgorithm) {
         this.keyAlgorithm = keyAlgorithm;
     }
 
+    /**
+     * keyID is the ID of the CA key that the External Account is bound to.
+     */
     @JsonProperty("keyID")
     public String getKeyID() {
         return keyID;
     }
 
+    /**
+     * keyID is the ID of the CA key that the External Account is bound to.
+     */
     @JsonProperty("keyID")
     public void setKeyID(String keyID) {
         this.keyID = keyID;
     }
 
+    /**
+     * ACMEExternalAccountBinding is a reference to a CA external account of the ACME server.
+     */
     @JsonProperty("keySecretRef")
     public SecretKeySelector getKeySecretRef() {
         return keySecretRef;
     }
 
+    /**
+     * ACMEExternalAccountBinding is a reference to a CA external account of the ACME server.
+     */
     @JsonProperty("keySecretRef")
     public void setKeySecretRef(SecretKeySelector keySecretRef) {
         this.keySecretRef = keySecretRef;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuer.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuer.java
index 5271909e03a..90c072b8844 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuer.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuer.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ACMEIssuer contains the specification for an ACME issuer. This uses the RFC8555 specification to obtain certificates by completing 'challenges' to prove ownership of domain identifiers. Earlier draft versions of the ACME specification are not supported.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -118,102 +121,162 @@ public ACMEIssuer(String caBundle, Boolean disableAccountKeyGeneration, String e
         this.solvers = solvers;
     }
 
+    /**
+     * Base64-encoded bundle of PEM CAs which can be used to validate the certificate chain presented by the ACME server. Mutually exclusive with SkipTLSVerify; prefer using CABundle to prevent various kinds of security vulnerabilities. If CABundle and SkipTLSVerify are unset, the system certificate bundle inside the container is used to validate the TLS connection.
+     */
     @JsonProperty("caBundle")
     public String getCaBundle() {
         return caBundle;
     }
 
+    /**
+     * Base64-encoded bundle of PEM CAs which can be used to validate the certificate chain presented by the ACME server. Mutually exclusive with SkipTLSVerify; prefer using CABundle to prevent various kinds of security vulnerabilities. If CABundle and SkipTLSVerify are unset, the system certificate bundle inside the container is used to validate the TLS connection.
+     */
     @JsonProperty("caBundle")
     public void setCaBundle(String caBundle) {
         this.caBundle = caBundle;
     }
 
+    /**
+     * Enables or disables generating a new ACME account key. If true, the Issuer resource will &#42;not&#42; request a new account but will expect the account key to be supplied via an existing secret. If false, the cert-manager system will generate a new ACME account key for the Issuer. Defaults to false.
+     */
     @JsonProperty("disableAccountKeyGeneration")
     public Boolean getDisableAccountKeyGeneration() {
         return disableAccountKeyGeneration;
     }
 
+    /**
+     * Enables or disables generating a new ACME account key. If true, the Issuer resource will &#42;not&#42; request a new account but will expect the account key to be supplied via an existing secret. If false, the cert-manager system will generate a new ACME account key for the Issuer. Defaults to false.
+     */
     @JsonProperty("disableAccountKeyGeneration")
     public void setDisableAccountKeyGeneration(Boolean disableAccountKeyGeneration) {
         this.disableAccountKeyGeneration = disableAccountKeyGeneration;
     }
 
+    /**
+     * Email is the email address to be associated with the ACME account. This field is optional, but it is strongly recommended to be set. It will be used to contact you in case of issues with your account or certificates, including expiry notification emails. This field may be updated after the account is initially registered.
+     */
     @JsonProperty("email")
     public String getEmail() {
         return email;
     }
 
+    /**
+     * Email is the email address to be associated with the ACME account. This field is optional, but it is strongly recommended to be set. It will be used to contact you in case of issues with your account or certificates, including expiry notification emails. This field may be updated after the account is initially registered.
+     */
     @JsonProperty("email")
     public void setEmail(String email) {
         this.email = email;
     }
 
+    /**
+     * Enables requesting a Not After date on certificates that matches the duration of the certificate. This is not supported by all ACME servers like Let's Encrypt. If set to true when the ACME server does not support it, it will create an error on the Order. Defaults to false.
+     */
     @JsonProperty("enableDurationFeature")
     public Boolean getEnableDurationFeature() {
         return enableDurationFeature;
     }
 
+    /**
+     * Enables requesting a Not After date on certificates that matches the duration of the certificate. This is not supported by all ACME servers like Let's Encrypt. If set to true when the ACME server does not support it, it will create an error on the Order. Defaults to false.
+     */
     @JsonProperty("enableDurationFeature")
     public void setEnableDurationFeature(Boolean enableDurationFeature) {
         this.enableDurationFeature = enableDurationFeature;
     }
 
+    /**
+     * ACMEIssuer contains the specification for an ACME issuer. This uses the RFC8555 specification to obtain certificates by completing 'challenges' to prove ownership of domain identifiers. Earlier draft versions of the ACME specification are not supported.
+     */
     @JsonProperty("externalAccountBinding")
     public ACMEExternalAccountBinding getExternalAccountBinding() {
         return externalAccountBinding;
     }
 
+    /**
+     * ACMEIssuer contains the specification for an ACME issuer. This uses the RFC8555 specification to obtain certificates by completing 'challenges' to prove ownership of domain identifiers. Earlier draft versions of the ACME specification are not supported.
+     */
     @JsonProperty("externalAccountBinding")
     public void setExternalAccountBinding(ACMEExternalAccountBinding externalAccountBinding) {
         this.externalAccountBinding = externalAccountBinding;
     }
 
+    /**
+     * PreferredChain is the chain to use if the ACME server outputs multiple. PreferredChain is no guarantee that this one gets delivered by the ACME endpoint. For example, for Let's Encrypt's DST crosssign you would use: "DST Root CA X3" or "ISRG Root X1" for the newer Let's Encrypt root CA. This value picks the first certificate bundle in the combined set of ACME default and alternative chains that has a root-most certificate with this value as its issuer's commonname.
+     */
     @JsonProperty("preferredChain")
     public String getPreferredChain() {
         return preferredChain;
     }
 
+    /**
+     * PreferredChain is the chain to use if the ACME server outputs multiple. PreferredChain is no guarantee that this one gets delivered by the ACME endpoint. For example, for Let's Encrypt's DST crosssign you would use: "DST Root CA X3" or "ISRG Root X1" for the newer Let's Encrypt root CA. This value picks the first certificate bundle in the combined set of ACME default and alternative chains that has a root-most certificate with this value as its issuer's commonname.
+     */
     @JsonProperty("preferredChain")
     public void setPreferredChain(String preferredChain) {
         this.preferredChain = preferredChain;
     }
 
+    /**
+     * ACMEIssuer contains the specification for an ACME issuer. This uses the RFC8555 specification to obtain certificates by completing 'challenges' to prove ownership of domain identifiers. Earlier draft versions of the ACME specification are not supported.
+     */
     @JsonProperty("privateKeySecretRef")
     public SecretKeySelector getPrivateKeySecretRef() {
         return privateKeySecretRef;
     }
 
+    /**
+     * ACMEIssuer contains the specification for an ACME issuer. This uses the RFC8555 specification to obtain certificates by completing 'challenges' to prove ownership of domain identifiers. Earlier draft versions of the ACME specification are not supported.
+     */
     @JsonProperty("privateKeySecretRef")
     public void setPrivateKeySecretRef(SecretKeySelector privateKeySecretRef) {
         this.privateKeySecretRef = privateKeySecretRef;
     }
 
+    /**
+     * Server is the URL used to access the ACME server's 'directory' endpoint. For example, for Let's Encrypt's staging endpoint, you would use: "https://acme-staging-v02.api.letsencrypt.org/directory". Only ACME v2 endpoints (i.e. RFC 8555) are supported.
+     */
     @JsonProperty("server")
     public String getServer() {
         return server;
     }
 
+    /**
+     * Server is the URL used to access the ACME server's 'directory' endpoint. For example, for Let's Encrypt's staging endpoint, you would use: "https://acme-staging-v02.api.letsencrypt.org/directory". Only ACME v2 endpoints (i.e. RFC 8555) are supported.
+     */
     @JsonProperty("server")
     public void setServer(String server) {
         this.server = server;
     }
 
+    /**
+     * INSECURE: Enables or disables validation of the ACME server TLS certificate. If true, requests to the ACME server will not have the TLS certificate chain validated. Mutually exclusive with CABundle; prefer using CABundle to prevent various kinds of security vulnerabilities. Only enable this option in development environments. If CABundle and SkipTLSVerify are unset, the system certificate bundle inside the container is used to validate the TLS connection. Defaults to false.
+     */
     @JsonProperty("skipTLSVerify")
     public Boolean getSkipTLSVerify() {
         return skipTLSVerify;
     }
 
+    /**
+     * INSECURE: Enables or disables validation of the ACME server TLS certificate. If true, requests to the ACME server will not have the TLS certificate chain validated. Mutually exclusive with CABundle; prefer using CABundle to prevent various kinds of security vulnerabilities. Only enable this option in development environments. If CABundle and SkipTLSVerify are unset, the system certificate bundle inside the container is used to validate the TLS connection. Defaults to false.
+     */
     @JsonProperty("skipTLSVerify")
     public void setSkipTLSVerify(Boolean skipTLSVerify) {
         this.skipTLSVerify = skipTLSVerify;
     }
 
+    /**
+     * Solvers is a list of challenge solvers that will be used to solve ACME challenges for the matching domains. Solver configurations must be provided in order to obtain certificates from an ACME server. For more information, see: https://cert-manager.io/docs/configuration/acme/
+     */
     @JsonProperty("solvers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ACMEChallengeSolver> getSolvers() {
         return solvers;
     }
 
+    /**
+     * Solvers is a list of challenge solvers that will be used to solve ACME challenges for the matching domains. Solver configurations must be provided in order to obtain certificates from an ACME server. For more information, see: https://cert-manager.io/docs/configuration/acme/
+     */
     @JsonProperty("solvers")
     public void setSolvers(List<ACMEChallengeSolver> solvers) {
         this.solvers = solvers;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderAcmeDNS.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderAcmeDNS.java
index 1be1a71d43e..861e9064067 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderAcmeDNS.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderAcmeDNS.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ACMEIssuerDNS01ProviderAcmeDNS is a structure containing the configuration for ACME-DNS servers
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public ACMEIssuerDNS01ProviderAcmeDNS(SecretKeySelector accountSecretRef, String
         this.host = host;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderAcmeDNS is a structure containing the configuration for ACME-DNS servers
+     */
     @JsonProperty("accountSecretRef")
     public SecretKeySelector getAccountSecretRef() {
         return accountSecretRef;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderAcmeDNS is a structure containing the configuration for ACME-DNS servers
+     */
     @JsonProperty("accountSecretRef")
     public void setAccountSecretRef(SecretKeySelector accountSecretRef) {
         this.accountSecretRef = accountSecretRef;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderAcmeDNS is a structure containing the configuration for ACME-DNS servers
+     */
     @JsonProperty("host")
     public String getHost() {
         return host;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderAcmeDNS is a structure containing the configuration for ACME-DNS servers
+     */
     @JsonProperty("host")
     public void setHost(String host) {
         this.host = host;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderAkamai.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderAkamai.java
index 2054f517665..4ac45b5e362 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderAkamai.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderAkamai.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ACMEIssuerDNS01ProviderAkamai is a structure containing the DNS configuration for Akamai DNS—Zone Record Management API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,41 +94,65 @@ public ACMEIssuerDNS01ProviderAkamai(SecretKeySelector accessTokenSecretRef, Sec
         this.serviceConsumerDomain = serviceConsumerDomain;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderAkamai is a structure containing the DNS configuration for Akamai DNS—Zone Record Management API
+     */
     @JsonProperty("accessTokenSecretRef")
     public SecretKeySelector getAccessTokenSecretRef() {
         return accessTokenSecretRef;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderAkamai is a structure containing the DNS configuration for Akamai DNS—Zone Record Management API
+     */
     @JsonProperty("accessTokenSecretRef")
     public void setAccessTokenSecretRef(SecretKeySelector accessTokenSecretRef) {
         this.accessTokenSecretRef = accessTokenSecretRef;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderAkamai is a structure containing the DNS configuration for Akamai DNS—Zone Record Management API
+     */
     @JsonProperty("clientSecretSecretRef")
     public SecretKeySelector getClientSecretSecretRef() {
         return clientSecretSecretRef;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderAkamai is a structure containing the DNS configuration for Akamai DNS—Zone Record Management API
+     */
     @JsonProperty("clientSecretSecretRef")
     public void setClientSecretSecretRef(SecretKeySelector clientSecretSecretRef) {
         this.clientSecretSecretRef = clientSecretSecretRef;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderAkamai is a structure containing the DNS configuration for Akamai DNS—Zone Record Management API
+     */
     @JsonProperty("clientTokenSecretRef")
     public SecretKeySelector getClientTokenSecretRef() {
         return clientTokenSecretRef;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderAkamai is a structure containing the DNS configuration for Akamai DNS—Zone Record Management API
+     */
     @JsonProperty("clientTokenSecretRef")
     public void setClientTokenSecretRef(SecretKeySelector clientTokenSecretRef) {
         this.clientTokenSecretRef = clientTokenSecretRef;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderAkamai is a structure containing the DNS configuration for Akamai DNS—Zone Record Management API
+     */
     @JsonProperty("serviceConsumerDomain")
     public String getServiceConsumerDomain() {
         return serviceConsumerDomain;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderAkamai is a structure containing the DNS configuration for Akamai DNS—Zone Record Management API
+     */
     @JsonProperty("serviceConsumerDomain")
     public void setServiceConsumerDomain(String serviceConsumerDomain) {
         this.serviceConsumerDomain = serviceConsumerDomain;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderAzureDNS.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderAzureDNS.java
index 1495f45460b..5499e3e065f 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderAzureDNS.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderAzureDNS.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ACMEIssuerDNS01ProviderAzureDNS is a structure containing the configuration for Azure DNS
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -107,81 +110,129 @@ public ACMEIssuerDNS01ProviderAzureDNS(String clientID, SecretKeySelector client
         this.tenantID = tenantID;
     }
 
+    /**
+     * Auth: Azure Service Principal: The ClientID of the Azure Service Principal used to authenticate with Azure DNS. If set, ClientSecret and TenantID must also be set.
+     */
     @JsonProperty("clientID")
     public String getClientID() {
         return clientID;
     }
 
+    /**
+     * Auth: Azure Service Principal: The ClientID of the Azure Service Principal used to authenticate with Azure DNS. If set, ClientSecret and TenantID must also be set.
+     */
     @JsonProperty("clientID")
     public void setClientID(String clientID) {
         this.clientID = clientID;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderAzureDNS is a structure containing the configuration for Azure DNS
+     */
     @JsonProperty("clientSecretSecretRef")
     public SecretKeySelector getClientSecretSecretRef() {
         return clientSecretSecretRef;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderAzureDNS is a structure containing the configuration for Azure DNS
+     */
     @JsonProperty("clientSecretSecretRef")
     public void setClientSecretSecretRef(SecretKeySelector clientSecretSecretRef) {
         this.clientSecretSecretRef = clientSecretSecretRef;
     }
 
+    /**
+     * name of the Azure environment (default AzurePublicCloud)
+     */
     @JsonProperty("environment")
     public String getEnvironment() {
         return environment;
     }
 
+    /**
+     * name of the Azure environment (default AzurePublicCloud)
+     */
     @JsonProperty("environment")
     public void setEnvironment(String environment) {
         this.environment = environment;
     }
 
+    /**
+     * name of the DNS zone that should be used
+     */
     @JsonProperty("hostedZoneName")
     public String getHostedZoneName() {
         return hostedZoneName;
     }
 
+    /**
+     * name of the DNS zone that should be used
+     */
     @JsonProperty("hostedZoneName")
     public void setHostedZoneName(String hostedZoneName) {
         this.hostedZoneName = hostedZoneName;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderAzureDNS is a structure containing the configuration for Azure DNS
+     */
     @JsonProperty("managedIdentity")
     public AzureManagedIdentity getManagedIdentity() {
         return managedIdentity;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderAzureDNS is a structure containing the configuration for Azure DNS
+     */
     @JsonProperty("managedIdentity")
     public void setManagedIdentity(AzureManagedIdentity managedIdentity) {
         this.managedIdentity = managedIdentity;
     }
 
+    /**
+     * resource group the DNS zone is located in
+     */
     @JsonProperty("resourceGroupName")
     public String getResourceGroupName() {
         return resourceGroupName;
     }
 
+    /**
+     * resource group the DNS zone is located in
+     */
     @JsonProperty("resourceGroupName")
     public void setResourceGroupName(String resourceGroupName) {
         this.resourceGroupName = resourceGroupName;
     }
 
+    /**
+     * ID of the Azure subscription
+     */
     @JsonProperty("subscriptionID")
     public String getSubscriptionID() {
         return subscriptionID;
     }
 
+    /**
+     * ID of the Azure subscription
+     */
     @JsonProperty("subscriptionID")
     public void setSubscriptionID(String subscriptionID) {
         this.subscriptionID = subscriptionID;
     }
 
+    /**
+     * Auth: Azure Service Principal: The TenantID of the Azure Service Principal used to authenticate with Azure DNS. If set, ClientID and ClientSecret must also be set.
+     */
     @JsonProperty("tenantID")
     public String getTenantID() {
         return tenantID;
     }
 
+    /**
+     * Auth: Azure Service Principal: The TenantID of the Azure Service Principal used to authenticate with Azure DNS. If set, ClientID and ClientSecret must also be set.
+     */
     @JsonProperty("tenantID")
     public void setTenantID(String tenantID) {
         this.tenantID = tenantID;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderCloudDNS.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderCloudDNS.java
index 7d2a37eadc9..4a07ca7de34 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderCloudDNS.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderCloudDNS.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ACMEIssuerDNS01ProviderCloudDNS is a structure containing the DNS configuration for Google Cloud DNS
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,31 +90,49 @@ public ACMEIssuerDNS01ProviderCloudDNS(String hostedZoneName, String project, Se
         this.serviceAccountSecretRef = serviceAccountSecretRef;
     }
 
+    /**
+     * HostedZoneName is an optional field that tells cert-manager in which Cloud DNS zone the challenge record has to be created. If left empty cert-manager will automatically choose a zone.
+     */
     @JsonProperty("hostedZoneName")
     public String getHostedZoneName() {
         return hostedZoneName;
     }
 
+    /**
+     * HostedZoneName is an optional field that tells cert-manager in which Cloud DNS zone the challenge record has to be created. If left empty cert-manager will automatically choose a zone.
+     */
     @JsonProperty("hostedZoneName")
     public void setHostedZoneName(String hostedZoneName) {
         this.hostedZoneName = hostedZoneName;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderCloudDNS is a structure containing the DNS configuration for Google Cloud DNS
+     */
     @JsonProperty("project")
     public String getProject() {
         return project;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderCloudDNS is a structure containing the DNS configuration for Google Cloud DNS
+     */
     @JsonProperty("project")
     public void setProject(String project) {
         this.project = project;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderCloudDNS is a structure containing the DNS configuration for Google Cloud DNS
+     */
     @JsonProperty("serviceAccountSecretRef")
     public SecretKeySelector getServiceAccountSecretRef() {
         return serviceAccountSecretRef;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderCloudDNS is a structure containing the DNS configuration for Google Cloud DNS
+     */
     @JsonProperty("serviceAccountSecretRef")
     public void setServiceAccountSecretRef(SecretKeySelector serviceAccountSecretRef) {
         this.serviceAccountSecretRef = serviceAccountSecretRef;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderCloudflare.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderCloudflare.java
index 1548f9be5f0..6c5c00ecfda 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderCloudflare.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderCloudflare.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ACMEIssuerDNS01ProviderCloudflare is a structure containing the DNS configuration for Cloudflare. One of `apiKeySecretRef` or `apiTokenSecretRef` must be provided.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,31 +90,49 @@ public ACMEIssuerDNS01ProviderCloudflare(SecretKeySelector apiKeySecretRef, Secr
         this.email = email;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderCloudflare is a structure containing the DNS configuration for Cloudflare. One of `apiKeySecretRef` or `apiTokenSecretRef` must be provided.
+     */
     @JsonProperty("apiKeySecretRef")
     public SecretKeySelector getApiKeySecretRef() {
         return apiKeySecretRef;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderCloudflare is a structure containing the DNS configuration for Cloudflare. One of `apiKeySecretRef` or `apiTokenSecretRef` must be provided.
+     */
     @JsonProperty("apiKeySecretRef")
     public void setApiKeySecretRef(SecretKeySelector apiKeySecretRef) {
         this.apiKeySecretRef = apiKeySecretRef;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderCloudflare is a structure containing the DNS configuration for Cloudflare. One of `apiKeySecretRef` or `apiTokenSecretRef` must be provided.
+     */
     @JsonProperty("apiTokenSecretRef")
     public SecretKeySelector getApiTokenSecretRef() {
         return apiTokenSecretRef;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderCloudflare is a structure containing the DNS configuration for Cloudflare. One of `apiKeySecretRef` or `apiTokenSecretRef` must be provided.
+     */
     @JsonProperty("apiTokenSecretRef")
     public void setApiTokenSecretRef(SecretKeySelector apiTokenSecretRef) {
         this.apiTokenSecretRef = apiTokenSecretRef;
     }
 
+    /**
+     * Email of the account, only required when using API key based authentication.
+     */
     @JsonProperty("email")
     public String getEmail() {
         return email;
     }
 
+    /**
+     * Email of the account, only required when using API key based authentication.
+     */
     @JsonProperty("email")
     public void setEmail(String email) {
         this.email = email;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderDigitalOcean.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderDigitalOcean.java
index 77211ee0aa9..82ff25c179c 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderDigitalOcean.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderDigitalOcean.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ACMEIssuerDNS01ProviderDigitalOcean is a structure containing the DNS configuration for DigitalOcean Domains
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,11 +82,17 @@ public ACMEIssuerDNS01ProviderDigitalOcean(SecretKeySelector tokenSecretRef) {
         this.tokenSecretRef = tokenSecretRef;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderDigitalOcean is a structure containing the DNS configuration for DigitalOcean Domains
+     */
     @JsonProperty("tokenSecretRef")
     public SecretKeySelector getTokenSecretRef() {
         return tokenSecretRef;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderDigitalOcean is a structure containing the DNS configuration for DigitalOcean Domains
+     */
     @JsonProperty("tokenSecretRef")
     public void setTokenSecretRef(SecretKeySelector tokenSecretRef) {
         this.tokenSecretRef = tokenSecretRef;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderRFC2136.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderRFC2136.java
index 98f5afe46a9..6e1dfc12a34 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderRFC2136.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderRFC2136.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ACMEIssuerDNS01ProviderRFC2136 is a structure containing the configuration for RFC2136 DNS
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,41 +94,65 @@ public ACMEIssuerDNS01ProviderRFC2136(String nameserver, String tsigAlgorithm, S
         this.tsigSecretSecretRef = tsigSecretSecretRef;
     }
 
+    /**
+     * The IP address or hostname of an authoritative DNS server supporting RFC2136 in the form host:port. If the host is an IPv6 address it must be enclosed in square brackets (e.g [2001:db8::1]) ; port is optional. This field is required.
+     */
     @JsonProperty("nameserver")
     public String getNameserver() {
         return nameserver;
     }
 
+    /**
+     * The IP address or hostname of an authoritative DNS server supporting RFC2136 in the form host:port. If the host is an IPv6 address it must be enclosed in square brackets (e.g [2001:db8::1]) ; port is optional. This field is required.
+     */
     @JsonProperty("nameserver")
     public void setNameserver(String nameserver) {
         this.nameserver = nameserver;
     }
 
+    /**
+     * The TSIG Algorithm configured in the DNS supporting RFC2136. Used only when ``tsigSecretSecretRef`` and ``tsigKeyName`` are defined. Supported values are (case-insensitive): ``HMACMD5`` (default), ``HMACSHA1``, ``HMACSHA256`` or ``HMACSHA512``.
+     */
     @JsonProperty("tsigAlgorithm")
     public String getTsigAlgorithm() {
         return tsigAlgorithm;
     }
 
+    /**
+     * The TSIG Algorithm configured in the DNS supporting RFC2136. Used only when ``tsigSecretSecretRef`` and ``tsigKeyName`` are defined. Supported values are (case-insensitive): ``HMACMD5`` (default), ``HMACSHA1``, ``HMACSHA256`` or ``HMACSHA512``.
+     */
     @JsonProperty("tsigAlgorithm")
     public void setTsigAlgorithm(String tsigAlgorithm) {
         this.tsigAlgorithm = tsigAlgorithm;
     }
 
+    /**
+     * The TSIG Key name configured in the DNS. If ``tsigSecretSecretRef`` is defined, this field is required.
+     */
     @JsonProperty("tsigKeyName")
     public String getTsigKeyName() {
         return tsigKeyName;
     }
 
+    /**
+     * The TSIG Key name configured in the DNS. If ``tsigSecretSecretRef`` is defined, this field is required.
+     */
     @JsonProperty("tsigKeyName")
     public void setTsigKeyName(String tsigKeyName) {
         this.tsigKeyName = tsigKeyName;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderRFC2136 is a structure containing the configuration for RFC2136 DNS
+     */
     @JsonProperty("tsigSecretSecretRef")
     public SecretKeySelector getTsigSecretSecretRef() {
         return tsigSecretSecretRef;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderRFC2136 is a structure containing the configuration for RFC2136 DNS
+     */
     @JsonProperty("tsigSecretSecretRef")
     public void setTsigSecretSecretRef(SecretKeySelector tsigSecretSecretRef) {
         this.tsigSecretSecretRef = tsigSecretSecretRef;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderRoute53.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderRoute53.java
index d3459e4ba19..b80558647b0 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderRoute53.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderRoute53.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ACMEIssuerDNS01ProviderRoute53 is a structure containing the Route 53 configuration for AWS
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -103,71 +106,113 @@ public ACMEIssuerDNS01ProviderRoute53(String accessKeyID, SecretKeySelector acce
         this.secretAccessKeySecretRef = secretAccessKeySecretRef;
     }
 
+    /**
+     * The AccessKeyID is used for authentication. Cannot be set when SecretAccessKeyID is set. If neither the Access Key nor Key ID are set, we fall-back to using env vars, shared credentials file or AWS Instance metadata, see: https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/configuring-sdk.html#specifying-credentials
+     */
     @JsonProperty("accessKeyID")
     public String getAccessKeyID() {
         return accessKeyID;
     }
 
+    /**
+     * The AccessKeyID is used for authentication. Cannot be set when SecretAccessKeyID is set. If neither the Access Key nor Key ID are set, we fall-back to using env vars, shared credentials file or AWS Instance metadata, see: https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/configuring-sdk.html#specifying-credentials
+     */
     @JsonProperty("accessKeyID")
     public void setAccessKeyID(String accessKeyID) {
         this.accessKeyID = accessKeyID;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderRoute53 is a structure containing the Route 53 configuration for AWS
+     */
     @JsonProperty("accessKeyIDSecretRef")
     public SecretKeySelector getAccessKeyIDSecretRef() {
         return accessKeyIDSecretRef;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderRoute53 is a structure containing the Route 53 configuration for AWS
+     */
     @JsonProperty("accessKeyIDSecretRef")
     public void setAccessKeyIDSecretRef(SecretKeySelector accessKeyIDSecretRef) {
         this.accessKeyIDSecretRef = accessKeyIDSecretRef;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderRoute53 is a structure containing the Route 53 configuration for AWS
+     */
     @JsonProperty("auth")
     public Route53Auth getAuth() {
         return auth;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderRoute53 is a structure containing the Route 53 configuration for AWS
+     */
     @JsonProperty("auth")
     public void setAuth(Route53Auth auth) {
         this.auth = auth;
     }
 
+    /**
+     * If set, the provider will manage only this zone in Route53 and will not do a lookup using the route53:ListHostedZonesByName api call.
+     */
     @JsonProperty("hostedZoneID")
     public String getHostedZoneID() {
         return hostedZoneID;
     }
 
+    /**
+     * If set, the provider will manage only this zone in Route53 and will not do a lookup using the route53:ListHostedZonesByName api call.
+     */
     @JsonProperty("hostedZoneID")
     public void setHostedZoneID(String hostedZoneID) {
         this.hostedZoneID = hostedZoneID;
     }
 
+    /**
+     * Override the AWS region.<br><p> <br><p> Route53 is a global service and does not have regional endpoints but the region specified here (or via environment variables) is used as a hint to help compute the correct AWS credential scope and partition when it connects to Route53. See: - [Amazon Route 53 endpoints and quotas](https://docs.aws.amazon.com/general/latest/gr/r53.html) - [Global services](https://docs.aws.amazon.com/whitepapers/latest/aws-fault-isolation-boundaries/global-services.html)<br><p> <br><p> If you omit this region field, cert-manager will use the region from AWS_REGION and AWS_DEFAULT_REGION environment variables, if they are set in the cert-manager controller Pod.<br><p> <br><p> The `region` field is not needed if you use [IAM Roles for Service Accounts (IRSA)](https://docs.aws.amazon.com/eks/latest/userguide/iam-roles-for-service-accounts.html). Instead an AWS_REGION environment variable is added to the cert-manager controller Pod by: [Amazon EKS Pod Identity Webhook](https://github.com/aws/amazon-eks-pod-identity-webhook). In this case this `region` field value is ignored.<br><p> <br><p> The `region` field is not needed if you use [EKS Pod Identities](https://docs.aws.amazon.com/eks/latest/userguide/pod-identities.html). Instead an AWS_REGION environment variable is added to the cert-manager controller Pod by: [Amazon EKS Pod Identity Agent](https://github.com/aws/eks-pod-identity-agent), In this case this `region` field value is ignored.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Override the AWS region.<br><p> <br><p> Route53 is a global service and does not have regional endpoints but the region specified here (or via environment variables) is used as a hint to help compute the correct AWS credential scope and partition when it connects to Route53. See: - [Amazon Route 53 endpoints and quotas](https://docs.aws.amazon.com/general/latest/gr/r53.html) - [Global services](https://docs.aws.amazon.com/whitepapers/latest/aws-fault-isolation-boundaries/global-services.html)<br><p> <br><p> If you omit this region field, cert-manager will use the region from AWS_REGION and AWS_DEFAULT_REGION environment variables, if they are set in the cert-manager controller Pod.<br><p> <br><p> The `region` field is not needed if you use [IAM Roles for Service Accounts (IRSA)](https://docs.aws.amazon.com/eks/latest/userguide/iam-roles-for-service-accounts.html). Instead an AWS_REGION environment variable is added to the cert-manager controller Pod by: [Amazon EKS Pod Identity Webhook](https://github.com/aws/amazon-eks-pod-identity-webhook). In this case this `region` field value is ignored.<br><p> <br><p> The `region` field is not needed if you use [EKS Pod Identities](https://docs.aws.amazon.com/eks/latest/userguide/pod-identities.html). Instead an AWS_REGION environment variable is added to the cert-manager controller Pod by: [Amazon EKS Pod Identity Agent](https://github.com/aws/eks-pod-identity-agent), In this case this `region` field value is ignored.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * Role is a Role ARN which the Route53 provider will assume using either the explicit credentials AccessKeyID/SecretAccessKey or the inferred credentials from environment variables, shared credentials file or AWS Instance metadata
+     */
     @JsonProperty("role")
     public String getRole() {
         return role;
     }
 
+    /**
+     * Role is a Role ARN which the Route53 provider will assume using either the explicit credentials AccessKeyID/SecretAccessKey or the inferred credentials from environment variables, shared credentials file or AWS Instance metadata
+     */
     @JsonProperty("role")
     public void setRole(String role) {
         this.role = role;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderRoute53 is a structure containing the Route 53 configuration for AWS
+     */
     @JsonProperty("secretAccessKeySecretRef")
     public SecretKeySelector getSecretAccessKeySecretRef() {
         return secretAccessKeySecretRef;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderRoute53 is a structure containing the Route 53 configuration for AWS
+     */
     @JsonProperty("secretAccessKeySecretRef")
     public void setSecretAccessKeySecretRef(SecretKeySelector secretAccessKeySecretRef) {
         this.secretAccessKeySecretRef = secretAccessKeySecretRef;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderWebhook.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderWebhook.java
index a8c62dab939..faa5479d67c 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderWebhook.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerDNS01ProviderWebhook.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ACMEIssuerDNS01ProviderWebhook specifies configuration for a webhook DNS01 provider, including where to POST ChallengePayload resources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,31 +90,49 @@ public ACMEIssuerDNS01ProviderWebhook(JsonNode config, String groupName, String
         this.solverName = solverName;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderWebhook specifies configuration for a webhook DNS01 provider, including where to POST ChallengePayload resources.
+     */
     @JsonProperty("config")
     public JsonNode getConfig() {
         return config;
     }
 
+    /**
+     * ACMEIssuerDNS01ProviderWebhook specifies configuration for a webhook DNS01 provider, including where to POST ChallengePayload resources.
+     */
     @JsonProperty("config")
     public void setConfig(JsonNode config) {
         this.config = config;
     }
 
+    /**
+     * The API group name that should be used when POSTing ChallengePayload resources to the webhook apiserver. This should be the same as the GroupName specified in the webhook provider implementation.
+     */
     @JsonProperty("groupName")
     public String getGroupName() {
         return groupName;
     }
 
+    /**
+     * The API group name that should be used when POSTing ChallengePayload resources to the webhook apiserver. This should be the same as the GroupName specified in the webhook provider implementation.
+     */
     @JsonProperty("groupName")
     public void setGroupName(String groupName) {
         this.groupName = groupName;
     }
 
+    /**
+     * The name of the solver to use, as defined in the webhook provider implementation. This will typically be the name of the provider, e.g. 'cloudflare'.
+     */
     @JsonProperty("solverName")
     public String getSolverName() {
         return solverName;
     }
 
+    /**
+     * The name of the solver to use, as defined in the webhook provider implementation. This will typically be the name of the provider, e.g. 'cloudflare'.
+     */
     @JsonProperty("solverName")
     public void setSolverName(String solverName) {
         this.solverName = solverName;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerStatus.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerStatus.java
index 1278562cd80..dbfa1b10c20 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerStatus.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ACMEIssuerStatus.java
@@ -86,31 +86,49 @@ public ACMEIssuerStatus(String lastPrivateKeyHash, String lastRegisteredEmail, S
         this.uri = uri;
     }
 
+    /**
+     * LastPrivateKeyHash is a hash of the private key associated with the latest registered ACME account, in order to track changes made to registered account associated with the Issuer
+     */
     @JsonProperty("lastPrivateKeyHash")
     public String getLastPrivateKeyHash() {
         return lastPrivateKeyHash;
     }
 
+    /**
+     * LastPrivateKeyHash is a hash of the private key associated with the latest registered ACME account, in order to track changes made to registered account associated with the Issuer
+     */
     @JsonProperty("lastPrivateKeyHash")
     public void setLastPrivateKeyHash(String lastPrivateKeyHash) {
         this.lastPrivateKeyHash = lastPrivateKeyHash;
     }
 
+    /**
+     * LastRegisteredEmail is the email associated with the latest registered ACME account, in order to track changes made to registered account associated with the  Issuer
+     */
     @JsonProperty("lastRegisteredEmail")
     public String getLastRegisteredEmail() {
         return lastRegisteredEmail;
     }
 
+    /**
+     * LastRegisteredEmail is the email associated with the latest registered ACME account, in order to track changes made to registered account associated with the  Issuer
+     */
     @JsonProperty("lastRegisteredEmail")
     public void setLastRegisteredEmail(String lastRegisteredEmail) {
         this.lastRegisteredEmail = lastRegisteredEmail;
     }
 
+    /**
+     * URI is the unique account identifier, which can also be used to retrieve account details from the CA
+     */
     @JsonProperty("uri")
     public String getUri() {
         return uri;
     }
 
+    /**
+     * URI is the unique account identifier, which can also be used to retrieve account details from the CA
+     */
     @JsonProperty("uri")
     public void setUri(String uri) {
         this.uri = uri;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/AzureManagedIdentity.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/AzureManagedIdentity.java
index da42178c71c..27fd5d0756d 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/AzureManagedIdentity.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/AzureManagedIdentity.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzureManagedIdentity contains the configuration for Azure Workload Identity or Azure Managed Service Identity If the AZURE_FEDERATED_TOKEN_FILE environment variable is set, the Azure Workload Identity will be used. Otherwise, we fall-back to using Azure Managed Service Identity.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public AzureManagedIdentity(String clientID, String resourceID) {
         this.resourceID = resourceID;
     }
 
+    /**
+     * client ID of the managed identity, can not be used at the same time as resourceID
+     */
     @JsonProperty("clientID")
     public String getClientID() {
         return clientID;
     }
 
+    /**
+     * client ID of the managed identity, can not be used at the same time as resourceID
+     */
     @JsonProperty("clientID")
     public void setClientID(String clientID) {
         this.clientID = clientID;
     }
 
+    /**
+     * resource ID of the managed identity, can not be used at the same time as clientID Cannot be used for Azure Managed Service Identity
+     */
     @JsonProperty("resourceID")
     public String getResourceID() {
         return resourceID;
     }
 
+    /**
+     * resource ID of the managed identity, can not be used at the same time as clientID Cannot be used for Azure Managed Service Identity
+     */
     @JsonProperty("resourceID")
     public void setResourceID(String resourceID) {
         this.resourceID = resourceID;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/CertificateDNSNameSelector.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/CertificateDNSNameSelector.java
index 08b4f45ac64..0decf404ea6 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/CertificateDNSNameSelector.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/CertificateDNSNameSelector.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CertificateDNSNameSelector selects certificates using a label selector, and can optionally select individual DNS names within those certificates. If both MatchLabels and DNSNames are empty, this selector will match all certificates and DNS names within them.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,34 +94,52 @@ public CertificateDNSNameSelector(List<String> dnsNames, List<String> dnsZones,
         this.matchLabels = matchLabels;
     }
 
+    /**
+     * List of DNSNames that this solver will be used to solve. If specified and a match is found, a dnsNames selector will take precedence over a dnsZones selector. If multiple solvers match with the same dnsNames value, the solver with the most matching labels in matchLabels will be selected. If neither has more matches, the solver defined earlier in the list will be selected.
+     */
     @JsonProperty("dnsNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDnsNames() {
         return dnsNames;
     }
 
+    /**
+     * List of DNSNames that this solver will be used to solve. If specified and a match is found, a dnsNames selector will take precedence over a dnsZones selector. If multiple solvers match with the same dnsNames value, the solver with the most matching labels in matchLabels will be selected. If neither has more matches, the solver defined earlier in the list will be selected.
+     */
     @JsonProperty("dnsNames")
     public void setDnsNames(List<String> dnsNames) {
         this.dnsNames = dnsNames;
     }
 
+    /**
+     * List of DNSZones that this solver will be used to solve. The most specific DNS zone match specified here will take precedence over other DNS zone matches, so a solver specifying sys.example.com will be selected over one specifying example.com for the domain www.sys.example.com. If multiple solvers match with the same dnsZones value, the solver with the most matching labels in matchLabels will be selected. If neither has more matches, the solver defined earlier in the list will be selected.
+     */
     @JsonProperty("dnsZones")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDnsZones() {
         return dnsZones;
     }
 
+    /**
+     * List of DNSZones that this solver will be used to solve. The most specific DNS zone match specified here will take precedence over other DNS zone matches, so a solver specifying sys.example.com will be selected over one specifying example.com for the domain www.sys.example.com. If multiple solvers match with the same dnsZones value, the solver with the most matching labels in matchLabels will be selected. If neither has more matches, the solver defined earlier in the list will be selected.
+     */
     @JsonProperty("dnsZones")
     public void setDnsZones(List<String> dnsZones) {
         this.dnsZones = dnsZones;
     }
 
+    /**
+     * A label selector that is used to refine the set of certificate's that this challenge solver will apply to.
+     */
     @JsonProperty("matchLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getMatchLabels() {
         return matchLabels;
     }
 
+    /**
+     * A label selector that is used to refine the set of certificate's that this challenge solver will apply to.
+     */
     @JsonProperty("matchLabels")
     public void setMatchLabels(Map<String, String> matchLabels) {
         this.matchLabels = matchLabels;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/Challenge.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/Challenge.java
index 78898824713..eca39df0f29 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/Challenge.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/Challenge.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Challenge is a type to represent a Challenge request with an ACME server
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Challenge implements Editable<ChallengeBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "acme.cert-manager.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Challenge";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Challenge(String apiVersion, String kind, ObjectMeta metadata, ChallengeS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Challenge is a type to represent a Challenge request with an ACME server
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Challenge is a type to represent a Challenge request with an ACME server
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Challenge is a type to represent a Challenge request with an ACME server
+     */
     @JsonProperty("spec")
     public ChallengeSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Challenge is a type to represent a Challenge request with an ACME server
+     */
     @JsonProperty("spec")
     public void setSpec(ChallengeSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Challenge is a type to represent a Challenge request with an ACME server
+     */
     @JsonProperty("status")
     public ChallengeStatus getStatus() {
         return status;
     }
 
+    /**
+     * Challenge is a type to represent a Challenge request with an ACME server
+     */
     @JsonProperty("status")
     public void setStatus(ChallengeStatus status) {
         this.status = status;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ChallengeList.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ChallengeList.java
index 21117e965e6..e383cebfaba 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ChallengeList.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ChallengeList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ChallengeList is a list of Challenges
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ChallengeList implements Editable<ChallengeListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.certmanager.api.model.acme.v1.Challenge>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "acme.cert-manager.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.certmanager.api.model.acme.v1.Challenge> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ChallengeList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ChallengeList(String apiVersion, List<io.fabric8.certmanager.api.model.ac
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ChallengeList is a list of Challenges
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.certmanager.api.model.acme.v1.Challenge> getItems() {
         return items;
     }
 
+    /**
+     * ChallengeList is a list of Challenges
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.certmanager.api.model.acme.v1.Challenge> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ChallengeList is a list of Challenges
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ChallengeList is a list of Challenges
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ChallengeSpec.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ChallengeSpec.java
index b2564d36b12..aab0b40beeb 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ChallengeSpec.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ChallengeSpec.java
@@ -110,21 +110,33 @@ public ChallengeSpec(String authorizationURL, String dnsName, ObjectReference is
         this.wildcard = wildcard;
     }
 
+    /**
+     * The URL to the ACME Authorization resource that this challenge is a part of.
+     */
     @JsonProperty("authorizationURL")
     public String getAuthorizationURL() {
         return authorizationURL;
     }
 
+    /**
+     * The URL to the ACME Authorization resource that this challenge is a part of.
+     */
     @JsonProperty("authorizationURL")
     public void setAuthorizationURL(String authorizationURL) {
         this.authorizationURL = authorizationURL;
     }
 
+    /**
+     * dnsName is the identifier that this challenge is for, e.g. example.com. If the requested DNSName is a 'wildcard', this field MUST be set to the non-wildcard domain, e.g. for `&#42;.example.com`, it must be `example.com`.
+     */
     @JsonProperty("dnsName")
     public String getDnsName() {
         return dnsName;
     }
 
+    /**
+     * dnsName is the identifier that this challenge is for, e.g. example.com. If the requested DNSName is a 'wildcard', this field MUST be set to the non-wildcard domain, e.g. for `&#42;.example.com`, it must be `example.com`.
+     */
     @JsonProperty("dnsName")
     public void setDnsName(String dnsName) {
         this.dnsName = dnsName;
@@ -140,11 +152,17 @@ public void setIssuerRef(ObjectReference issuerRef) {
         this.issuerRef = issuerRef;
     }
 
+    /**
+     * The ACME challenge key for this challenge For HTTP01 challenges, this is the value that must be responded with to complete the HTTP01 challenge in the format: `&lt;private key JWK thumbprint&gt;.&lt;key from acme server for challenge&gt;`. For DNS01 challenges, this is the base64 encoded SHA256 sum of the `&lt;private key JWK thumbprint&gt;.&lt;key from acme server for challenge&gt;` text that must be set as the TXT record content.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * The ACME challenge key for this challenge For HTTP01 challenges, this is the value that must be responded with to complete the HTTP01 challenge in the format: `&lt;private key JWK thumbprint&gt;.&lt;key from acme server for challenge&gt;`. For DNS01 challenges, this is the base64 encoded SHA256 sum of the `&lt;private key JWK thumbprint&gt;.&lt;key from acme server for challenge&gt;` text that must be set as the TXT record content.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
@@ -160,41 +178,65 @@ public void setSolver(ACMEChallengeSolver solver) {
         this.solver = solver;
     }
 
+    /**
+     * The ACME challenge token for this challenge. This is the raw value returned from the ACME server.
+     */
     @JsonProperty("token")
     public String getToken() {
         return token;
     }
 
+    /**
+     * The ACME challenge token for this challenge. This is the raw value returned from the ACME server.
+     */
     @JsonProperty("token")
     public void setToken(String token) {
         this.token = token;
     }
 
+    /**
+     * The type of ACME challenge this resource represents. One of "HTTP-01" or "DNS-01".
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * The type of ACME challenge this resource represents. One of "HTTP-01" or "DNS-01".
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * The URL of the ACME Challenge resource for this challenge. This can be used to lookup details about the status of this challenge.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * The URL of the ACME Challenge resource for this challenge. This can be used to lookup details about the status of this challenge.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
     }
 
+    /**
+     * wildcard will be true if this challenge is for a wildcard identifier, for example '&#42;.example.com'.
+     */
     @JsonProperty("wildcard")
     public Boolean getWildcard() {
         return wildcard;
     }
 
+    /**
+     * wildcard will be true if this challenge is for a wildcard identifier, for example '&#42;.example.com'.
+     */
     @JsonProperty("wildcard")
     public void setWildcard(Boolean wildcard) {
         this.wildcard = wildcard;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ChallengeStatus.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ChallengeStatus.java
index e4d691a191e..42507e05918 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ChallengeStatus.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ChallengeStatus.java
@@ -90,41 +90,65 @@ public ChallengeStatus(Boolean presented, Boolean processing, String reason, Str
         this.state = state;
     }
 
+    /**
+     * presented will be set to true if the challenge values for this challenge are currently 'presented'. This &#42;does not&#42; imply the self check is passing. Only that the values have been 'submitted' for the appropriate challenge mechanism (i.e. the DNS01 TXT record has been presented, or the HTTP01 configuration has been configured).
+     */
     @JsonProperty("presented")
     public Boolean getPresented() {
         return presented;
     }
 
+    /**
+     * presented will be set to true if the challenge values for this challenge are currently 'presented'. This &#42;does not&#42; imply the self check is passing. Only that the values have been 'submitted' for the appropriate challenge mechanism (i.e. the DNS01 TXT record has been presented, or the HTTP01 configuration has been configured).
+     */
     @JsonProperty("presented")
     public void setPresented(Boolean presented) {
         this.presented = presented;
     }
 
+    /**
+     * Used to denote whether this challenge should be processed or not. This field will only be set to true by the 'scheduling' component. It will only be set to false by the 'challenges' controller, after the challenge has reached a final state or timed out. If this field is set to false, the challenge controller will not take any more action.
+     */
     @JsonProperty("processing")
     public Boolean getProcessing() {
         return processing;
     }
 
+    /**
+     * Used to denote whether this challenge should be processed or not. This field will only be set to true by the 'scheduling' component. It will only be set to false by the 'challenges' controller, after the challenge has reached a final state or timed out. If this field is set to false, the challenge controller will not take any more action.
+     */
     @JsonProperty("processing")
     public void setProcessing(Boolean processing) {
         this.processing = processing;
     }
 
+    /**
+     * Contains human readable information on why the Challenge is in the current state.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Contains human readable information on why the Challenge is in the current state.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Contains the current 'state' of the challenge. If not set, the state of the challenge is unknown.
+     */
     @JsonProperty("state")
     public String getState() {
         return state;
     }
 
+    /**
+     * Contains the current 'state' of the challenge. If not set, the state of the challenge is unknown.
+     */
     @JsonProperty("state")
     public void setState(String state) {
         this.state = state;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/Order.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/Order.java
index c8578f014d3..f7e68d55a34 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/Order.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/Order.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Order is a type to represent an Order with an ACME server
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Order implements Editable<OrderBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "acme.cert-manager.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Order";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Order(String apiVersion, String kind, ObjectMeta metadata, OrderSpec spec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Order is a type to represent an Order with an ACME server
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Order is a type to represent an Order with an ACME server
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Order is a type to represent an Order with an ACME server
+     */
     @JsonProperty("spec")
     public OrderSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Order is a type to represent an Order with an ACME server
+     */
     @JsonProperty("spec")
     public void setSpec(OrderSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Order is a type to represent an Order with an ACME server
+     */
     @JsonProperty("status")
     public OrderStatus getStatus() {
         return status;
     }
 
+    /**
+     * Order is a type to represent an Order with an ACME server
+     */
     @JsonProperty("status")
     public void setStatus(OrderStatus status) {
         this.status = status;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/OrderList.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/OrderList.java
index 768fa4acb64..22de4a10b7b 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/OrderList.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/OrderList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OrderList is a list of Orders
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class OrderList implements Editable<OrderListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.certmanager.api.model.acme.v1.Order>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "acme.cert-manager.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.certmanager.api.model.acme.v1.Order> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OrderList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public OrderList(String apiVersion, List<io.fabric8.certmanager.api.model.acme.v
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * OrderList is a list of Orders
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.certmanager.api.model.acme.v1.Order> getItems() {
         return items;
     }
 
+    /**
+     * OrderList is a list of Orders
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.certmanager.api.model.acme.v1.Order> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OrderList is a list of Orders
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OrderList is a list of Orders
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/OrderSpec.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/OrderSpec.java
index 288b3b180e9..7b2c1a2c02c 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/OrderSpec.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/OrderSpec.java
@@ -103,22 +103,34 @@ public OrderSpec(String commonName, List<String> dnsNames, Duration duration, Li
         this.request = request;
     }
 
+    /**
+     * CommonName is the common name as specified on the DER encoded CSR. If specified, this value must also be present in `dnsNames` or `ipAddresses`. This field must match the corresponding field on the DER encoded CSR.
+     */
     @JsonProperty("commonName")
     public String getCommonName() {
         return commonName;
     }
 
+    /**
+     * CommonName is the common name as specified on the DER encoded CSR. If specified, this value must also be present in `dnsNames` or `ipAddresses`. This field must match the corresponding field on the DER encoded CSR.
+     */
     @JsonProperty("commonName")
     public void setCommonName(String commonName) {
         this.commonName = commonName;
     }
 
+    /**
+     * DNSNames is a list of DNS names that should be included as part of the Order validation process. This field must match the corresponding field on the DER encoded CSR.
+     */
     @JsonProperty("dnsNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDnsNames() {
         return dnsNames;
     }
 
+    /**
+     * DNSNames is a list of DNS names that should be included as part of the Order validation process. This field must match the corresponding field on the DER encoded CSR.
+     */
     @JsonProperty("dnsNames")
     public void setDnsNames(List<String> dnsNames) {
         this.dnsNames = dnsNames;
@@ -134,12 +146,18 @@ public void setDuration(Duration duration) {
         this.duration = duration;
     }
 
+    /**
+     * IPAddresses is a list of IP addresses that should be included as part of the Order validation process. This field must match the corresponding field on the DER encoded CSR.
+     */
     @JsonProperty("ipAddresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIpAddresses() {
         return ipAddresses;
     }
 
+    /**
+     * IPAddresses is a list of IP addresses that should be included as part of the Order validation process. This field must match the corresponding field on the DER encoded CSR.
+     */
     @JsonProperty("ipAddresses")
     public void setIpAddresses(List<String> ipAddresses) {
         this.ipAddresses = ipAddresses;
@@ -155,11 +173,17 @@ public void setIssuerRef(ObjectReference issuerRef) {
         this.issuerRef = issuerRef;
     }
 
+    /**
+     * Certificate signing request bytes in DER encoding. This will be used when finalizing the order. This field must be set on the order.
+     */
     @JsonProperty("request")
     public String getRequest() {
         return request;
     }
 
+    /**
+     * Certificate signing request bytes in DER encoding. This will be used when finalizing the order. This field must be set on the order.
+     */
     @JsonProperty("request")
     public void setRequest(String request) {
         this.request = request;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/OrderStatus.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/OrderStatus.java
index e1b6e59ca08..b509d7268a7 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/OrderStatus.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/OrderStatus.java
@@ -105,22 +105,34 @@ public OrderStatus(List<ACMEAuthorization> authorizations, String certificate, S
         this.url = url;
     }
 
+    /**
+     * Authorizations contains data returned from the ACME server on what authorizations must be completed in order to validate the DNS names specified on the Order.
+     */
     @JsonProperty("authorizations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ACMEAuthorization> getAuthorizations() {
         return authorizations;
     }
 
+    /**
+     * Authorizations contains data returned from the ACME server on what authorizations must be completed in order to validate the DNS names specified on the Order.
+     */
     @JsonProperty("authorizations")
     public void setAuthorizations(List<ACMEAuthorization> authorizations) {
         this.authorizations = authorizations;
     }
 
+    /**
+     * Certificate is a copy of the PEM encoded certificate for this Order. This field will be populated after the order has been successfully finalized with the ACME server, and the order has transitioned to the 'valid' state.
+     */
     @JsonProperty("certificate")
     public String getCertificate() {
         return certificate;
     }
 
+    /**
+     * Certificate is a copy of the PEM encoded certificate for this Order. This field will be populated after the order has been successfully finalized with the ACME server, and the order has transitioned to the 'valid' state.
+     */
     @JsonProperty("certificate")
     public void setCertificate(String certificate) {
         this.certificate = certificate;
@@ -136,41 +148,65 @@ public void setFailureTime(String failureTime) {
         this.failureTime = failureTime;
     }
 
+    /**
+     * FinalizeURL of the Order. This is used to obtain certificates for this order once it has been completed.
+     */
     @JsonProperty("finalizeURL")
     public String getFinalizeURL() {
         return finalizeURL;
     }
 
+    /**
+     * FinalizeURL of the Order. This is used to obtain certificates for this order once it has been completed.
+     */
     @JsonProperty("finalizeURL")
     public void setFinalizeURL(String finalizeURL) {
         this.finalizeURL = finalizeURL;
     }
 
+    /**
+     * Reason optionally provides more information about a why the order is in the current state.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason optionally provides more information about a why the order is in the current state.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * State contains the current state of this Order resource. States 'success' and 'expired' are 'final'
+     */
     @JsonProperty("state")
     public String getState() {
         return state;
     }
 
+    /**
+     * State contains the current state of this Order resource. States 'success' and 'expired' are 'final'
+     */
     @JsonProperty("state")
     public void setState(String state) {
         this.state = state;
     }
 
+    /**
+     * URL of the Order. This will initially be empty when the resource is first created. The Order controller will populate this field when the Order is first processed. This field will be immutable after it is initially set.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * URL of the Order. This will initially be empty when the resource is first created. The Order controller will populate this field when the Order is first processed. This field will be immutable after it is initially set.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/Route53Auth.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/Route53Auth.java
index e859ff2d3f9..da5c2fe56ea 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/Route53Auth.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/Route53Auth.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Route53Auth is configuration used to authenticate with a Route53.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public Route53Auth(Route53KubernetesAuth kubernetes) {
         this.kubernetes = kubernetes;
     }
 
+    /**
+     * Route53Auth is configuration used to authenticate with a Route53.
+     */
     @JsonProperty("kubernetes")
     public Route53KubernetesAuth getKubernetes() {
         return kubernetes;
     }
 
+    /**
+     * Route53Auth is configuration used to authenticate with a Route53.
+     */
     @JsonProperty("kubernetes")
     public void setKubernetes(Route53KubernetesAuth kubernetes) {
         this.kubernetes = kubernetes;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/Route53KubernetesAuth.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/Route53KubernetesAuth.java
index e05e96b09ea..e56711a7076 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/Route53KubernetesAuth.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/Route53KubernetesAuth.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Route53KubernetesAuth is a configuration to authenticate against Route53 using a bound Kubernetes ServiceAccount token.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public Route53KubernetesAuth(ServiceAccountRef serviceAccountRef) {
         this.serviceAccountRef = serviceAccountRef;
     }
 
+    /**
+     * Route53KubernetesAuth is a configuration to authenticate against Route53 using a bound Kubernetes ServiceAccount token.
+     */
     @JsonProperty("serviceAccountRef")
     public ServiceAccountRef getServiceAccountRef() {
         return serviceAccountRef;
     }
 
+    /**
+     * Route53KubernetesAuth is a configuration to authenticate against Route53 using a bound Kubernetes ServiceAccount token.
+     */
     @JsonProperty("serviceAccountRef")
     public void setServiceAccountRef(ServiceAccountRef serviceAccountRef) {
         this.serviceAccountRef = serviceAccountRef;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ServiceAccountRef.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ServiceAccountRef.java
index 42a3d2abd95..b4fa5922032 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ServiceAccountRef.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/acme/v1/ServiceAccountRef.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceAccountRef is a service account used by cert-manager to request a token. The expiration of the token is also set by cert-manager to 10 minutes.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public ServiceAccountRef(List<String> audiences, String name) {
         this.name = name;
     }
 
+    /**
+     * TokenAudiences is an optional list of audiences to include in the token passed to AWS. The default token consisting of the issuer's namespace and name is always included. If unset the audience defaults to `sts.amazonaws.com`.
+     */
     @JsonProperty("audiences")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAudiences() {
         return audiences;
     }
 
+    /**
+     * TokenAudiences is an optional list of audiences to include in the token passed to AWS. The default token consisting of the issuer's namespace and name is always included. If unset the audience defaults to `sts.amazonaws.com`.
+     */
     @JsonProperty("audiences")
     public void setAudiences(List<String> audiences) {
         this.audiences = audiences;
     }
 
+    /**
+     * Name of the ServiceAccount used to request a token.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the ServiceAccount used to request a token.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/meta/v1/LocalObjectReference.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/meta/v1/LocalObjectReference.java
index 251d1969df2..1f4bb2a6f0b 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/meta/v1/LocalObjectReference.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/meta/v1/LocalObjectReference.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * A reference to an object in the same namespace as the referent. If the referent is a cluster-scoped resource (e.g. a ClusterIssuer), the reference instead refers to the resource with the given name in the configured 'cluster resource namespace', which is set as a flag on the controller component (and defaults to the namespace that cert-manager runs in).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,11 +80,17 @@ public LocalObjectReference(String name) {
         this.name = name;
     }
 
+    /**
+     * Name of the resource being referred to. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the resource being referred to. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/meta/v1/ObjectReference.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/meta/v1/ObjectReference.java
index 3af1d410abf..c43dd0208b0 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/meta/v1/ObjectReference.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/meta/v1/ObjectReference.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ObjectReference is a reference to an object with a given name, kind and group.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,31 +88,49 @@ public ObjectReference(String group, String kind, String name) {
         this.name = name;
     }
 
+    /**
+     * Group of the resource being referred to.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * Group of the resource being referred to.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * Kind of the resource being referred to.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind of the resource being referred to.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name of the resource being referred to.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the resource being referred to.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/meta/v1/SecretKeySelector.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/meta/v1/SecretKeySelector.java
index b7dee4c7943..e2930eb8452 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/meta/v1/SecretKeySelector.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/meta/v1/SecretKeySelector.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * A reference to a specific 'key' within a Secret resource. In some instances, `key` is a required field.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public SecretKeySelector(String key, String name) {
         this.name = name;
     }
 
+    /**
+     * The key of the entry in the Secret resource's `data` field to be used. Some instances of this field may be defaulted, in others it may be required.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * The key of the entry in the Secret resource's `data` field to be used. Some instances of this field may be defaulted, in others it may be required.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * Name of the resource being referred to. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the resource being referred to. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CAIssuer.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CAIssuer.java
index a5f76d0992c..1f1f03e07a4 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CAIssuer.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CAIssuer.java
@@ -95,44 +95,68 @@ public CAIssuer(List<String> crlDistributionPoints, List<String> issuingCertific
         this.secretName = secretName;
     }
 
+    /**
+     * The CRL distribution points is an X.509 v3 certificate extension which identifies the location of the CRL from which the revocation of this certificate can be checked. If not set, certificates will be issued without distribution points set.
+     */
     @JsonProperty("crlDistributionPoints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCrlDistributionPoints() {
         return crlDistributionPoints;
     }
 
+    /**
+     * The CRL distribution points is an X.509 v3 certificate extension which identifies the location of the CRL from which the revocation of this certificate can be checked. If not set, certificates will be issued without distribution points set.
+     */
     @JsonProperty("crlDistributionPoints")
     public void setCrlDistributionPoints(List<String> crlDistributionPoints) {
         this.crlDistributionPoints = crlDistributionPoints;
     }
 
+    /**
+     * IssuingCertificateURLs is a list of URLs which this issuer should embed into certificates it creates. See https://www.rfc-editor.org/rfc/rfc5280#section-4.2.2.1 for more details. As an example, such a URL might be "http://ca.domain.com/ca.crt".
+     */
     @JsonProperty("issuingCertificateURLs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIssuingCertificateURLs() {
         return issuingCertificateURLs;
     }
 
+    /**
+     * IssuingCertificateURLs is a list of URLs which this issuer should embed into certificates it creates. See https://www.rfc-editor.org/rfc/rfc5280#section-4.2.2.1 for more details. As an example, such a URL might be "http://ca.domain.com/ca.crt".
+     */
     @JsonProperty("issuingCertificateURLs")
     public void setIssuingCertificateURLs(List<String> issuingCertificateURLs) {
         this.issuingCertificateURLs = issuingCertificateURLs;
     }
 
+    /**
+     * The OCSP server list is an X.509 v3 extension that defines a list of URLs of OCSP responders. The OCSP responders can be queried for the revocation status of an issued certificate. If not set, the certificate will be issued with no OCSP servers set. For example, an OCSP server URL could be "http://ocsp.int-x3.letsencrypt.org".
+     */
     @JsonProperty("ocspServers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getOcspServers() {
         return ocspServers;
     }
 
+    /**
+     * The OCSP server list is an X.509 v3 extension that defines a list of URLs of OCSP responders. The OCSP responders can be queried for the revocation status of an issued certificate. If not set, the certificate will be issued with no OCSP servers set. For example, an OCSP server URL could be "http://ocsp.int-x3.letsencrypt.org".
+     */
     @JsonProperty("ocspServers")
     public void setOcspServers(List<String> ocspServers) {
         this.ocspServers = ocspServers;
     }
 
+    /**
+     * SecretName is the name of the secret used to sign Certificates issued by this Issuer.
+     */
     @JsonProperty("secretName")
     public String getSecretName() {
         return secretName;
     }
 
+    /**
+     * SecretName is the name of the secret used to sign Certificates issued by this Issuer.
+     */
     @JsonProperty("secretName")
     public void setSecretName(String secretName) {
         this.secretName = secretName;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/Certificate.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/Certificate.java
index c09f88aa6f5..9cadbb10215 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/Certificate.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/Certificate.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * A Certificate resource should be created to ensure an up to date and signed X.509 certificate is stored in the Kubernetes Secret resource named in `spec.secretName`.<br><p> <br><p> The stored certificate will be renewed before it expires (as configured by `spec.renewBefore`).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Certificate implements Editable<CertificateBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cert-manager.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Certificate";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Certificate(String apiVersion, String kind, ObjectMeta metadata, Certific
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * A Certificate resource should be created to ensure an up to date and signed X.509 certificate is stored in the Kubernetes Secret resource named in `spec.secretName`.<br><p> <br><p> The stored certificate will be renewed before it expires (as configured by `spec.renewBefore`).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * A Certificate resource should be created to ensure an up to date and signed X.509 certificate is stored in the Kubernetes Secret resource named in `spec.secretName`.<br><p> <br><p> The stored certificate will be renewed before it expires (as configured by `spec.renewBefore`).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * A Certificate resource should be created to ensure an up to date and signed X.509 certificate is stored in the Kubernetes Secret resource named in `spec.secretName`.<br><p> <br><p> The stored certificate will be renewed before it expires (as configured by `spec.renewBefore`).
+     */
     @JsonProperty("spec")
     public CertificateSpec getSpec() {
         return spec;
     }
 
+    /**
+     * A Certificate resource should be created to ensure an up to date and signed X.509 certificate is stored in the Kubernetes Secret resource named in `spec.secretName`.<br><p> <br><p> The stored certificate will be renewed before it expires (as configured by `spec.renewBefore`).
+     */
     @JsonProperty("spec")
     public void setSpec(CertificateSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * A Certificate resource should be created to ensure an up to date and signed X.509 certificate is stored in the Kubernetes Secret resource named in `spec.secretName`.<br><p> <br><p> The stored certificate will be renewed before it expires (as configured by `spec.renewBefore`).
+     */
     @JsonProperty("status")
     public CertificateStatus getStatus() {
         return status;
     }
 
+    /**
+     * A Certificate resource should be created to ensure an up to date and signed X.509 certificate is stored in the Kubernetes Secret resource named in `spec.secretName`.<br><p> <br><p> The stored certificate will be renewed before it expires (as configured by `spec.renewBefore`).
+     */
     @JsonProperty("status")
     public void setStatus(CertificateStatus status) {
         this.status = status;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateAdditionalOutputFormat.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateAdditionalOutputFormat.java
index fd8859235da..95a31d20bf2 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateAdditionalOutputFormat.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateAdditionalOutputFormat.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CertificateAdditionalOutputFormat defines an additional output format of a Certificate resource. These contain supplementary data formats of the signed certificate chain and paired private key.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public CertificateAdditionalOutputFormat(String type) {
         this.type = type;
     }
 
+    /**
+     * Type is the name of the format type that should be written to the Certificate's target Secret.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the name of the format type that should be written to the Certificate's target Secret.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateCondition.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateCondition.java
index 6fa8f4b1cc7..41536f53dfe 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateCondition.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CertificateCondition contains condition information for a Certificate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public CertificateCondition(String lastTransitionTime, String message, Long obse
         this.type = type;
     }
 
+    /**
+     * CertificateCondition contains condition information for a Certificate.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * CertificateCondition contains condition information for a Certificate.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Message is a human readable description of the details of the last transition, complementing reason.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message is a human readable description of the details of the last transition, complementing reason.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * If set, this represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.condition[x].observedGeneration is 9, the condition is out of date with respect to the current state of the Certificate.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * If set, this represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.condition[x].observedGeneration is 9, the condition is out of date with respect to the current state of the Certificate.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Reason is a brief machine readable explanation for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason is a brief machine readable explanation for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of the condition, one of (`True`, `False`, `Unknown`).
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition, one of (`True`, `False`, `Unknown`).
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type of the condition, known values are (`Ready`, `Issuing`).
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of the condition, known values are (`Ready`, `Issuing`).
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateKeystores.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateKeystores.java
index 0a7222bca90..d267de6c637 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateKeystores.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateKeystores.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CertificateKeystores configures additional keystore output formats to be created in the Certificate's output Secret.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public CertificateKeystores(JKSKeystore jks, PKCS12Keystore pkcs12) {
         this.pkcs12 = pkcs12;
     }
 
+    /**
+     * CertificateKeystores configures additional keystore output formats to be created in the Certificate's output Secret.
+     */
     @JsonProperty("jks")
     public JKSKeystore getJks() {
         return jks;
     }
 
+    /**
+     * CertificateKeystores configures additional keystore output formats to be created in the Certificate's output Secret.
+     */
     @JsonProperty("jks")
     public void setJks(JKSKeystore jks) {
         this.jks = jks;
     }
 
+    /**
+     * CertificateKeystores configures additional keystore output formats to be created in the Certificate's output Secret.
+     */
     @JsonProperty("pkcs12")
     public PKCS12Keystore getPkcs12() {
         return pkcs12;
     }
 
+    /**
+     * CertificateKeystores configures additional keystore output formats to be created in the Certificate's output Secret.
+     */
     @JsonProperty("pkcs12")
     public void setPkcs12(PKCS12Keystore pkcs12) {
         this.pkcs12 = pkcs12;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateList.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateList.java
index 655783abd24..5e4059287ee 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateList.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CertificateList is a list of Certificates.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class CertificateList implements Editable<CertificateListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.certmanager.api.model.v1.Certificate>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cert-manager.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.certmanager.api.model.v1.Certificate> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CertificateList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CertificateList(String apiVersion, List<io.fabric8.certmanager.api.model.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of Certificates
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.certmanager.api.model.v1.Certificate> getItems() {
         return items;
     }
 
+    /**
+     * List of Certificates
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.certmanager.api.model.v1.Certificate> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CertificateList is a list of Certificates.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CertificateList is a list of Certificates.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificatePrivateKey.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificatePrivateKey.java
index 7f1672d1f31..1450632bed3 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificatePrivateKey.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificatePrivateKey.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CertificatePrivateKey contains configuration options for private keys used by the Certificate controller. These include the key algorithm and size, the used encoding and the rotation policy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public CertificatePrivateKey(String algorithm, String encoding, String rotationP
         this.size = size;
     }
 
+    /**
+     * Algorithm is the private key algorithm of the corresponding private key for this certificate.<br><p> <br><p> If provided, allowed values are either `RSA`, `ECDSA` or `Ed25519`. If `algorithm` is specified and `size` is not provided, key size of 2048 will be used for `RSA` key algorithm and key size of 256 will be used for `ECDSA` key algorithm. key size is ignored when using the `Ed25519` key algorithm.
+     */
     @JsonProperty("algorithm")
     public String getAlgorithm() {
         return algorithm;
     }
 
+    /**
+     * Algorithm is the private key algorithm of the corresponding private key for this certificate.<br><p> <br><p> If provided, allowed values are either `RSA`, `ECDSA` or `Ed25519`. If `algorithm` is specified and `size` is not provided, key size of 2048 will be used for `RSA` key algorithm and key size of 256 will be used for `ECDSA` key algorithm. key size is ignored when using the `Ed25519` key algorithm.
+     */
     @JsonProperty("algorithm")
     public void setAlgorithm(String algorithm) {
         this.algorithm = algorithm;
     }
 
+    /**
+     * The private key cryptography standards (PKCS) encoding for this certificate's private key to be encoded in.<br><p> <br><p> If provided, allowed values are `PKCS1` and `PKCS8` standing for PKCS#1 and PKCS#8, respectively. Defaults to `PKCS1` if not specified.
+     */
     @JsonProperty("encoding")
     public String getEncoding() {
         return encoding;
     }
 
+    /**
+     * The private key cryptography standards (PKCS) encoding for this certificate's private key to be encoded in.<br><p> <br><p> If provided, allowed values are `PKCS1` and `PKCS8` standing for PKCS#1 and PKCS#8, respectively. Defaults to `PKCS1` if not specified.
+     */
     @JsonProperty("encoding")
     public void setEncoding(String encoding) {
         this.encoding = encoding;
     }
 
+    /**
+     * RotationPolicy controls how private keys should be regenerated when a re-issuance is being processed.<br><p> <br><p> If set to `Never`, a private key will only be generated if one does not already exist in the target `spec.secretName`. If one does exist but it does not have the correct algorithm or size, a warning will be raised to await user intervention. If set to `Always`, a private key matching the specified requirements will be generated whenever a re-issuance occurs. Default is `Never` for backward compatibility.
+     */
     @JsonProperty("rotationPolicy")
     public String getRotationPolicy() {
         return rotationPolicy;
     }
 
+    /**
+     * RotationPolicy controls how private keys should be regenerated when a re-issuance is being processed.<br><p> <br><p> If set to `Never`, a private key will only be generated if one does not already exist in the target `spec.secretName`. If one does exist but it does not have the correct algorithm or size, a warning will be raised to await user intervention. If set to `Always`, a private key matching the specified requirements will be generated whenever a re-issuance occurs. Default is `Never` for backward compatibility.
+     */
     @JsonProperty("rotationPolicy")
     public void setRotationPolicy(String rotationPolicy) {
         this.rotationPolicy = rotationPolicy;
     }
 
+    /**
+     * Size is the key bit size of the corresponding private key for this certificate.<br><p> <br><p> If `algorithm` is set to `RSA`, valid values are `2048`, `4096` or `8192`, and will default to `2048` if not specified. If `algorithm` is set to `ECDSA`, valid values are `256`, `384` or `521`, and will default to `256` if not specified. If `algorithm` is set to `Ed25519`, Size is ignored. No other values are allowed.
+     */
     @JsonProperty("size")
     public Integer getSize() {
         return size;
     }
 
+    /**
+     * Size is the key bit size of the corresponding private key for this certificate.<br><p> <br><p> If `algorithm` is set to `RSA`, valid values are `2048`, `4096` or `8192`, and will default to `2048` if not specified. If `algorithm` is set to `ECDSA`, valid values are `256`, `384` or `521`, and will default to `256` if not specified. If `algorithm` is set to `Ed25519`, Size is ignored. No other values are allowed.
+     */
     @JsonProperty("size")
     public void setSize(Integer size) {
         this.size = size;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateRequest.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateRequest.java
index 35e1108614f..9a6d976c75c 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateRequest.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateRequest.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * A CertificateRequest is used to request a signed certificate from one of the configured issuers.<br><p> <br><p> All fields within the CertificateRequest's `spec` are immutable after creation. A CertificateRequest will either succeed or fail, as denoted by its `Ready` status condition and its `status.failureTime` field.<br><p> <br><p> A CertificateRequest is a one-shot resource, meaning it represents a single point in time request for a certificate and cannot be re-used.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class CertificateRequest implements Editable<CertificateRequestBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cert-manager.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CertificateRequest";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CertificateRequest(String apiVersion, String kind, ObjectMeta metadata, C
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * A CertificateRequest is used to request a signed certificate from one of the configured issuers.<br><p> <br><p> All fields within the CertificateRequest's `spec` are immutable after creation. A CertificateRequest will either succeed or fail, as denoted by its `Ready` status condition and its `status.failureTime` field.<br><p> <br><p> A CertificateRequest is a one-shot resource, meaning it represents a single point in time request for a certificate and cannot be re-used.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * A CertificateRequest is used to request a signed certificate from one of the configured issuers.<br><p> <br><p> All fields within the CertificateRequest's `spec` are immutable after creation. A CertificateRequest will either succeed or fail, as denoted by its `Ready` status condition and its `status.failureTime` field.<br><p> <br><p> A CertificateRequest is a one-shot resource, meaning it represents a single point in time request for a certificate and cannot be re-used.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * A CertificateRequest is used to request a signed certificate from one of the configured issuers.<br><p> <br><p> All fields within the CertificateRequest's `spec` are immutable after creation. A CertificateRequest will either succeed or fail, as denoted by its `Ready` status condition and its `status.failureTime` field.<br><p> <br><p> A CertificateRequest is a one-shot resource, meaning it represents a single point in time request for a certificate and cannot be re-used.
+     */
     @JsonProperty("spec")
     public CertificateRequestSpec getSpec() {
         return spec;
     }
 
+    /**
+     * A CertificateRequest is used to request a signed certificate from one of the configured issuers.<br><p> <br><p> All fields within the CertificateRequest's `spec` are immutable after creation. A CertificateRequest will either succeed or fail, as denoted by its `Ready` status condition and its `status.failureTime` field.<br><p> <br><p> A CertificateRequest is a one-shot resource, meaning it represents a single point in time request for a certificate and cannot be re-used.
+     */
     @JsonProperty("spec")
     public void setSpec(CertificateRequestSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * A CertificateRequest is used to request a signed certificate from one of the configured issuers.<br><p> <br><p> All fields within the CertificateRequest's `spec` are immutable after creation. A CertificateRequest will either succeed or fail, as denoted by its `Ready` status condition and its `status.failureTime` field.<br><p> <br><p> A CertificateRequest is a one-shot resource, meaning it represents a single point in time request for a certificate and cannot be re-used.
+     */
     @JsonProperty("status")
     public CertificateRequestStatus getStatus() {
         return status;
     }
 
+    /**
+     * A CertificateRequest is used to request a signed certificate from one of the configured issuers.<br><p> <br><p> All fields within the CertificateRequest's `spec` are immutable after creation. A CertificateRequest will either succeed or fail, as denoted by its `Ready` status condition and its `status.failureTime` field.<br><p> <br><p> A CertificateRequest is a one-shot resource, meaning it represents a single point in time request for a certificate and cannot be re-used.
+     */
     @JsonProperty("status")
     public void setStatus(CertificateRequestStatus status) {
         this.status = status;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateRequestCondition.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateRequestCondition.java
index 3fd3f6db5fa..9536c1cc952 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateRequestCondition.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateRequestCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CertificateRequestCondition contains condition information for a CertificateRequest.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public CertificateRequestCondition(String lastTransitionTime, String message, St
         this.type = type;
     }
 
+    /**
+     * CertificateRequestCondition contains condition information for a CertificateRequest.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * CertificateRequestCondition contains condition information for a CertificateRequest.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Message is a human readable description of the details of the last transition, complementing reason.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message is a human readable description of the details of the last transition, complementing reason.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Reason is a brief machine readable explanation for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason is a brief machine readable explanation for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of the condition, one of (`True`, `False`, `Unknown`).
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition, one of (`True`, `False`, `Unknown`).
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type of the condition, known values are (`Ready`, `InvalidRequest`, `Approved`, `Denied`).
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of the condition, known values are (`Ready`, `InvalidRequest`, `Approved`, `Denied`).
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateRequestList.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateRequestList.java
index 4c7799dfc07..23ef1e76ab4 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateRequestList.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateRequestList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CertificateRequestList is a list of CertificateRequests.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class CertificateRequestList implements Editable<CertificateRequestListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.certmanager.api.model.v1.CertificateRequest>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cert-manager.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.certmanager.api.model.v1.CertificateRequest> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CertificateRequestList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CertificateRequestList(String apiVersion, List<io.fabric8.certmanager.api
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of CertificateRequests
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.certmanager.api.model.v1.CertificateRequest> getItems() {
         return items;
     }
 
+    /**
+     * List of CertificateRequests
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.certmanager.api.model.v1.CertificateRequest> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CertificateRequestList is a list of CertificateRequests.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CertificateRequestList is a list of CertificateRequests.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateRequestSpec.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateRequestSpec.java
index 3b9a10833e0..ea7efab2069 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateRequestSpec.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateRequestSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CertificateRequestSpec defines the desired state of CertificateRequest<br><p> <br><p> NOTE: It is important to note that the issuer can choose to ignore or change any of the requested attributes. How the issuer maps a certificate request to a signed certificate is the full responsibility of the issuer itself. For example, as an edge case, an issuer that inverts the isCA value is free to do so.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -116,94 +119,148 @@ public CertificateRequestSpec(Duration duration, Map<String, List<String>> extra
         this.username = username;
     }
 
+    /**
+     * CertificateRequestSpec defines the desired state of CertificateRequest<br><p> <br><p> NOTE: It is important to note that the issuer can choose to ignore or change any of the requested attributes. How the issuer maps a certificate request to a signed certificate is the full responsibility of the issuer itself. For example, as an edge case, an issuer that inverts the isCA value is free to do so.
+     */
     @JsonProperty("duration")
     public Duration getDuration() {
         return duration;
     }
 
+    /**
+     * CertificateRequestSpec defines the desired state of CertificateRequest<br><p> <br><p> NOTE: It is important to note that the issuer can choose to ignore or change any of the requested attributes. How the issuer maps a certificate request to a signed certificate is the full responsibility of the issuer itself. For example, as an edge case, an issuer that inverts the isCA value is free to do so.
+     */
     @JsonProperty("duration")
     public void setDuration(Duration duration) {
         this.duration = duration;
     }
 
+    /**
+     * Extra contains extra attributes of the user that created the CertificateRequest. Populated by the cert-manager webhook on creation and immutable.
+     */
     @JsonProperty("extra")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<String>> getExtra() {
         return extra;
     }
 
+    /**
+     * Extra contains extra attributes of the user that created the CertificateRequest. Populated by the cert-manager webhook on creation and immutable.
+     */
     @JsonProperty("extra")
     public void setExtra(Map<String, List<String>> extra) {
         this.extra = extra;
     }
 
+    /**
+     * Groups contains group membership of the user that created the CertificateRequest. Populated by the cert-manager webhook on creation and immutable.
+     */
     @JsonProperty("groups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getGroups() {
         return groups;
     }
 
+    /**
+     * Groups contains group membership of the user that created the CertificateRequest. Populated by the cert-manager webhook on creation and immutable.
+     */
     @JsonProperty("groups")
     public void setGroups(List<String> groups) {
         this.groups = groups;
     }
 
+    /**
+     * Requested basic constraints isCA value. Note that the issuer may choose to ignore the requested isCA value, just like any other requested attribute.<br><p> <br><p> NOTE: If the CSR in the `Request` field has a BasicConstraints extension, it must have the same isCA value as specified here.<br><p> <br><p> If true, this will automatically add the `cert sign` usage to the list of requested `usages`.
+     */
     @JsonProperty("isCA")
     public Boolean getIsCA() {
         return isCA;
     }
 
+    /**
+     * Requested basic constraints isCA value. Note that the issuer may choose to ignore the requested isCA value, just like any other requested attribute.<br><p> <br><p> NOTE: If the CSR in the `Request` field has a BasicConstraints extension, it must have the same isCA value as specified here.<br><p> <br><p> If true, this will automatically add the `cert sign` usage to the list of requested `usages`.
+     */
     @JsonProperty("isCA")
     public void setIsCA(Boolean isCA) {
         this.isCA = isCA;
     }
 
+    /**
+     * CertificateRequestSpec defines the desired state of CertificateRequest<br><p> <br><p> NOTE: It is important to note that the issuer can choose to ignore or change any of the requested attributes. How the issuer maps a certificate request to a signed certificate is the full responsibility of the issuer itself. For example, as an edge case, an issuer that inverts the isCA value is free to do so.
+     */
     @JsonProperty("issuerRef")
     public ObjectReference getIssuerRef() {
         return issuerRef;
     }
 
+    /**
+     * CertificateRequestSpec defines the desired state of CertificateRequest<br><p> <br><p> NOTE: It is important to note that the issuer can choose to ignore or change any of the requested attributes. How the issuer maps a certificate request to a signed certificate is the full responsibility of the issuer itself. For example, as an edge case, an issuer that inverts the isCA value is free to do so.
+     */
     @JsonProperty("issuerRef")
     public void setIssuerRef(ObjectReference issuerRef) {
         this.issuerRef = issuerRef;
     }
 
+    /**
+     * The PEM-encoded X.509 certificate signing request to be submitted to the issuer for signing.<br><p> <br><p> If the CSR has a BasicConstraints extension, its isCA attribute must match the `isCA` value of this CertificateRequest. If the CSR has a KeyUsage extension, its key usages must match the key usages in the `usages` field of this CertificateRequest. If the CSR has a ExtKeyUsage extension, its extended key usages must match the extended key usages in the `usages` field of this CertificateRequest.
+     */
     @JsonProperty("request")
     public String getRequest() {
         return request;
     }
 
+    /**
+     * The PEM-encoded X.509 certificate signing request to be submitted to the issuer for signing.<br><p> <br><p> If the CSR has a BasicConstraints extension, its isCA attribute must match the `isCA` value of this CertificateRequest. If the CSR has a KeyUsage extension, its key usages must match the key usages in the `usages` field of this CertificateRequest. If the CSR has a ExtKeyUsage extension, its extended key usages must match the extended key usages in the `usages` field of this CertificateRequest.
+     */
     @JsonProperty("request")
     public void setRequest(String request) {
         this.request = request;
     }
 
+    /**
+     * UID contains the uid of the user that created the CertificateRequest. Populated by the cert-manager webhook on creation and immutable.
+     */
     @JsonProperty("uid")
     public String getUid() {
         return uid;
     }
 
+    /**
+     * UID contains the uid of the user that created the CertificateRequest. Populated by the cert-manager webhook on creation and immutable.
+     */
     @JsonProperty("uid")
     public void setUid(String uid) {
         this.uid = uid;
     }
 
+    /**
+     * Requested key usages and extended key usages.<br><p> <br><p> NOTE: If the CSR in the `Request` field has uses the KeyUsage or ExtKeyUsage extension, these extensions must have the same values as specified here without any additional values.<br><p> <br><p> If unset, defaults to `digital signature` and `key encipherment`.
+     */
     @JsonProperty("usages")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getUsages() {
         return usages;
     }
 
+    /**
+     * Requested key usages and extended key usages.<br><p> <br><p> NOTE: If the CSR in the `Request` field has uses the KeyUsage or ExtKeyUsage extension, these extensions must have the same values as specified here without any additional values.<br><p> <br><p> If unset, defaults to `digital signature` and `key encipherment`.
+     */
     @JsonProperty("usages")
     public void setUsages(List<String> usages) {
         this.usages = usages;
     }
 
+    /**
+     * Username contains the name of the user that created the CertificateRequest. Populated by the cert-manager webhook on creation and immutable.
+     */
     @JsonProperty("username")
     public String getUsername() {
         return username;
     }
 
+    /**
+     * Username contains the name of the user that created the CertificateRequest. Populated by the cert-manager webhook on creation and immutable.
+     */
     @JsonProperty("username")
     public void setUsername(String username) {
         this.username = username;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateRequestStatus.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateRequestStatus.java
index d037c174ff0..ffda7002f59 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateRequestStatus.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateRequestStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CertificateRequestStatus defines the observed state of CertificateRequest and resulting signed certificate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public CertificateRequestStatus(String ca, String certificate, List<CertificateR
         this.failureTime = failureTime;
     }
 
+    /**
+     * The PEM encoded X.509 certificate of the signer, also known as the CA (Certificate Authority). This is set on a best-effort basis by different issuers. If not set, the CA is assumed to be unknown/not available.
+     */
     @JsonProperty("ca")
     public String getCa() {
         return ca;
     }
 
+    /**
+     * The PEM encoded X.509 certificate of the signer, also known as the CA (Certificate Authority). This is set on a best-effort basis by different issuers. If not set, the CA is assumed to be unknown/not available.
+     */
     @JsonProperty("ca")
     public void setCa(String ca) {
         this.ca = ca;
     }
 
+    /**
+     * The PEM encoded X.509 certificate resulting from the certificate signing request. If not set, the CertificateRequest has either not been completed or has failed. More information on failure can be found by checking the `conditions` field.
+     */
     @JsonProperty("certificate")
     public String getCertificate() {
         return certificate;
     }
 
+    /**
+     * The PEM encoded X.509 certificate resulting from the certificate signing request. If not set, the CertificateRequest has either not been completed or has failed. More information on failure can be found by checking the `conditions` field.
+     */
     @JsonProperty("certificate")
     public void setCertificate(String certificate) {
         this.certificate = certificate;
     }
 
+    /**
+     * List of status conditions to indicate the status of a CertificateRequest. Known condition types are `Ready`, `InvalidRequest`, `Approved` and `Denied`.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CertificateRequestCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * List of status conditions to indicate the status of a CertificateRequest. Known condition types are `Ready`, `InvalidRequest`, `Approved` and `Denied`.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<CertificateRequestCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * CertificateRequestStatus defines the observed state of CertificateRequest and resulting signed certificate.
+     */
     @JsonProperty("failureTime")
     public String getFailureTime() {
         return failureTime;
     }
 
+    /**
+     * CertificateRequestStatus defines the observed state of CertificateRequest and resulting signed certificate.
+     */
     @JsonProperty("failureTime")
     public void setFailureTime(String failureTime) {
         this.failureTime = failureTime;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateSecretTemplate.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateSecretTemplate.java
index 764dafd318d..2472ec58e4b 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateSecretTemplate.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateSecretTemplate.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CertificateSecretTemplate defines the default labels and annotations to be copied to the Kubernetes Secret resource named in `CertificateSpec.secretName`.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -84,23 +87,35 @@ public CertificateSecretTemplate(Map<String, String> annotations, Map<String, St
         this.labels = labels;
     }
 
+    /**
+     * Annotations is a key value map to be copied to the target Kubernetes Secret.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is a key value map to be copied to the target Kubernetes Secret.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Labels is a key value map to be copied to the target Kubernetes Secret.
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabels() {
         return labels;
     }
 
+    /**
+     * Labels is a key value map to be copied to the target Kubernetes Secret.
+     */
     @JsonProperty("labels")
     public void setLabels(Map<String, String> labels) {
         this.labels = labels;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateSpec.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateSpec.java
index 17c19490c3c..14d31eee200 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateSpec.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CertificateSpec defines the desired state of Certificate.<br><p> <br><p> NOTE: The specification contains a lot of "requested" certificate attributes, it is important to note that the issuer can choose to ignore or change any of these requested attributes. How the issuer maps a certificate request to a signed certificate is the full responsibility of the issuer itself. For example, as an edge case, an issuer that inverts the isCA value is free to do so.<br><p> <br><p> A valid Certificate requires at least one of a CommonName, LiteralSubject, DNSName, or URI to be valid.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -172,228 +175,360 @@ public CertificateSpec(List<CertificateAdditionalOutputFormat> additionalOutputF
         this.usages = usages;
     }
 
+    /**
+     * Defines extra output formats of the private key and signed certificate chain to be written to this Certificate's target Secret.<br><p> <br><p> This is a Beta Feature enabled by default. It can be disabled with the `--feature-gates=AdditionalCertificateOutputFormats=false` option set on both the controller and webhook components.
+     */
     @JsonProperty("additionalOutputFormats")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CertificateAdditionalOutputFormat> getAdditionalOutputFormats() {
         return additionalOutputFormats;
     }
 
+    /**
+     * Defines extra output formats of the private key and signed certificate chain to be written to this Certificate's target Secret.<br><p> <br><p> This is a Beta Feature enabled by default. It can be disabled with the `--feature-gates=AdditionalCertificateOutputFormats=false` option set on both the controller and webhook components.
+     */
     @JsonProperty("additionalOutputFormats")
     public void setAdditionalOutputFormats(List<CertificateAdditionalOutputFormat> additionalOutputFormats) {
         this.additionalOutputFormats = additionalOutputFormats;
     }
 
+    /**
+     * Requested common name X509 certificate subject attribute. More info: https://datatracker.ietf.org/doc/html/rfc5280#section-4.1.2.6 NOTE: TLS clients will ignore this value when any subject alternative name is set (see https://tools.ietf.org/html/rfc6125#section-6.4.4).<br><p> <br><p> Should have a length of 64 characters or fewer to avoid generating invalid CSRs. Cannot be set if the `literalSubject` field is set.
+     */
     @JsonProperty("commonName")
     public String getCommonName() {
         return commonName;
     }
 
+    /**
+     * Requested common name X509 certificate subject attribute. More info: https://datatracker.ietf.org/doc/html/rfc5280#section-4.1.2.6 NOTE: TLS clients will ignore this value when any subject alternative name is set (see https://tools.ietf.org/html/rfc6125#section-6.4.4).<br><p> <br><p> Should have a length of 64 characters or fewer to avoid generating invalid CSRs. Cannot be set if the `literalSubject` field is set.
+     */
     @JsonProperty("commonName")
     public void setCommonName(String commonName) {
         this.commonName = commonName;
     }
 
+    /**
+     * Requested DNS subject alternative names.
+     */
     @JsonProperty("dnsNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDnsNames() {
         return dnsNames;
     }
 
+    /**
+     * Requested DNS subject alternative names.
+     */
     @JsonProperty("dnsNames")
     public void setDnsNames(List<String> dnsNames) {
         this.dnsNames = dnsNames;
     }
 
+    /**
+     * CertificateSpec defines the desired state of Certificate.<br><p> <br><p> NOTE: The specification contains a lot of "requested" certificate attributes, it is important to note that the issuer can choose to ignore or change any of these requested attributes. How the issuer maps a certificate request to a signed certificate is the full responsibility of the issuer itself. For example, as an edge case, an issuer that inverts the isCA value is free to do so.<br><p> <br><p> A valid Certificate requires at least one of a CommonName, LiteralSubject, DNSName, or URI to be valid.
+     */
     @JsonProperty("duration")
     public Duration getDuration() {
         return duration;
     }
 
+    /**
+     * CertificateSpec defines the desired state of Certificate.<br><p> <br><p> NOTE: The specification contains a lot of "requested" certificate attributes, it is important to note that the issuer can choose to ignore or change any of these requested attributes. How the issuer maps a certificate request to a signed certificate is the full responsibility of the issuer itself. For example, as an edge case, an issuer that inverts the isCA value is free to do so.<br><p> <br><p> A valid Certificate requires at least one of a CommonName, LiteralSubject, DNSName, or URI to be valid.
+     */
     @JsonProperty("duration")
     public void setDuration(Duration duration) {
         this.duration = duration;
     }
 
+    /**
+     * Requested email subject alternative names.
+     */
     @JsonProperty("emailAddresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEmailAddresses() {
         return emailAddresses;
     }
 
+    /**
+     * Requested email subject alternative names.
+     */
     @JsonProperty("emailAddresses")
     public void setEmailAddresses(List<String> emailAddresses) {
         this.emailAddresses = emailAddresses;
     }
 
+    /**
+     * Whether the KeyUsage and ExtKeyUsage extensions should be set in the encoded CSR.<br><p> <br><p> This option defaults to true, and should only be disabled if the target issuer does not support CSRs with these X509 KeyUsage/ ExtKeyUsage extensions.
+     */
     @JsonProperty("encodeUsagesInRequest")
     public Boolean getEncodeUsagesInRequest() {
         return encodeUsagesInRequest;
     }
 
+    /**
+     * Whether the KeyUsage and ExtKeyUsage extensions should be set in the encoded CSR.<br><p> <br><p> This option defaults to true, and should only be disabled if the target issuer does not support CSRs with these X509 KeyUsage/ ExtKeyUsage extensions.
+     */
     @JsonProperty("encodeUsagesInRequest")
     public void setEncodeUsagesInRequest(Boolean encodeUsagesInRequest) {
         this.encodeUsagesInRequest = encodeUsagesInRequest;
     }
 
+    /**
+     * Requested IP address subject alternative names.
+     */
     @JsonProperty("ipAddresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIpAddresses() {
         return ipAddresses;
     }
 
+    /**
+     * Requested IP address subject alternative names.
+     */
     @JsonProperty("ipAddresses")
     public void setIpAddresses(List<String> ipAddresses) {
         this.ipAddresses = ipAddresses;
     }
 
+    /**
+     * Requested basic constraints isCA value. The isCA value is used to set the `isCA` field on the created CertificateRequest resources. Note that the issuer may choose to ignore the requested isCA value, just like any other requested attribute.<br><p> <br><p> If true, this will automatically add the `cert sign` usage to the list of requested `usages`.
+     */
     @JsonProperty("isCA")
     public Boolean getIsCA() {
         return isCA;
     }
 
+    /**
+     * Requested basic constraints isCA value. The isCA value is used to set the `isCA` field on the created CertificateRequest resources. Note that the issuer may choose to ignore the requested isCA value, just like any other requested attribute.<br><p> <br><p> If true, this will automatically add the `cert sign` usage to the list of requested `usages`.
+     */
     @JsonProperty("isCA")
     public void setIsCA(Boolean isCA) {
         this.isCA = isCA;
     }
 
+    /**
+     * CertificateSpec defines the desired state of Certificate.<br><p> <br><p> NOTE: The specification contains a lot of "requested" certificate attributes, it is important to note that the issuer can choose to ignore or change any of these requested attributes. How the issuer maps a certificate request to a signed certificate is the full responsibility of the issuer itself. For example, as an edge case, an issuer that inverts the isCA value is free to do so.<br><p> <br><p> A valid Certificate requires at least one of a CommonName, LiteralSubject, DNSName, or URI to be valid.
+     */
     @JsonProperty("issuerRef")
     public ObjectReference getIssuerRef() {
         return issuerRef;
     }
 
+    /**
+     * CertificateSpec defines the desired state of Certificate.<br><p> <br><p> NOTE: The specification contains a lot of "requested" certificate attributes, it is important to note that the issuer can choose to ignore or change any of these requested attributes. How the issuer maps a certificate request to a signed certificate is the full responsibility of the issuer itself. For example, as an edge case, an issuer that inverts the isCA value is free to do so.<br><p> <br><p> A valid Certificate requires at least one of a CommonName, LiteralSubject, DNSName, or URI to be valid.
+     */
     @JsonProperty("issuerRef")
     public void setIssuerRef(ObjectReference issuerRef) {
         this.issuerRef = issuerRef;
     }
 
+    /**
+     * CertificateSpec defines the desired state of Certificate.<br><p> <br><p> NOTE: The specification contains a lot of "requested" certificate attributes, it is important to note that the issuer can choose to ignore or change any of these requested attributes. How the issuer maps a certificate request to a signed certificate is the full responsibility of the issuer itself. For example, as an edge case, an issuer that inverts the isCA value is free to do so.<br><p> <br><p> A valid Certificate requires at least one of a CommonName, LiteralSubject, DNSName, or URI to be valid.
+     */
     @JsonProperty("keystores")
     public CertificateKeystores getKeystores() {
         return keystores;
     }
 
+    /**
+     * CertificateSpec defines the desired state of Certificate.<br><p> <br><p> NOTE: The specification contains a lot of "requested" certificate attributes, it is important to note that the issuer can choose to ignore or change any of these requested attributes. How the issuer maps a certificate request to a signed certificate is the full responsibility of the issuer itself. For example, as an edge case, an issuer that inverts the isCA value is free to do so.<br><p> <br><p> A valid Certificate requires at least one of a CommonName, LiteralSubject, DNSName, or URI to be valid.
+     */
     @JsonProperty("keystores")
     public void setKeystores(CertificateKeystores keystores) {
         this.keystores = keystores;
     }
 
+    /**
+     * Requested X.509 certificate subject, represented using the LDAP "String Representation of a Distinguished Name" [1]. Important: the LDAP string format also specifies the order of the attributes in the subject, this is important when issuing certs for LDAP authentication. Example: `CN=foo,DC=corp,DC=example,DC=com` More info [1]: https://datatracker.ietf.org/doc/html/rfc4514 More info: https://github.com/cert-manager/cert-manager/issues/3203 More info: https://github.com/cert-manager/cert-manager/issues/4424<br><p> <br><p> Cannot be set if the `subject` or `commonName` field is set.
+     */
     @JsonProperty("literalSubject")
     public String getLiteralSubject() {
         return literalSubject;
     }
 
+    /**
+     * Requested X.509 certificate subject, represented using the LDAP "String Representation of a Distinguished Name" [1]. Important: the LDAP string format also specifies the order of the attributes in the subject, this is important when issuing certs for LDAP authentication. Example: `CN=foo,DC=corp,DC=example,DC=com` More info [1]: https://datatracker.ietf.org/doc/html/rfc4514 More info: https://github.com/cert-manager/cert-manager/issues/3203 More info: https://github.com/cert-manager/cert-manager/issues/4424<br><p> <br><p> Cannot be set if the `subject` or `commonName` field is set.
+     */
     @JsonProperty("literalSubject")
     public void setLiteralSubject(String literalSubject) {
         this.literalSubject = literalSubject;
     }
 
+    /**
+     * CertificateSpec defines the desired state of Certificate.<br><p> <br><p> NOTE: The specification contains a lot of "requested" certificate attributes, it is important to note that the issuer can choose to ignore or change any of these requested attributes. How the issuer maps a certificate request to a signed certificate is the full responsibility of the issuer itself. For example, as an edge case, an issuer that inverts the isCA value is free to do so.<br><p> <br><p> A valid Certificate requires at least one of a CommonName, LiteralSubject, DNSName, or URI to be valid.
+     */
     @JsonProperty("nameConstraints")
     public NameConstraints getNameConstraints() {
         return nameConstraints;
     }
 
+    /**
+     * CertificateSpec defines the desired state of Certificate.<br><p> <br><p> NOTE: The specification contains a lot of "requested" certificate attributes, it is important to note that the issuer can choose to ignore or change any of these requested attributes. How the issuer maps a certificate request to a signed certificate is the full responsibility of the issuer itself. For example, as an edge case, an issuer that inverts the isCA value is free to do so.<br><p> <br><p> A valid Certificate requires at least one of a CommonName, LiteralSubject, DNSName, or URI to be valid.
+     */
     @JsonProperty("nameConstraints")
     public void setNameConstraints(NameConstraints nameConstraints) {
         this.nameConstraints = nameConstraints;
     }
 
+    /**
+     * `otherNames` is an escape hatch for SAN that allows any type. We currently restrict the support to string like otherNames, cf RFC 5280 p 37 Any UTF8 String valued otherName can be passed with by setting the keys oid: x.x.x.x and UTF8Value: somevalue for `otherName`. Most commonly this would be UPN set with oid: 1.3.6.1.4.1.311.20.2.3 You should ensure that any OID passed is valid for the UTF8String type as we do not explicitly validate this.
+     */
     @JsonProperty("otherNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OtherName> getOtherNames() {
         return otherNames;
     }
 
+    /**
+     * `otherNames` is an escape hatch for SAN that allows any type. We currently restrict the support to string like otherNames, cf RFC 5280 p 37 Any UTF8 String valued otherName can be passed with by setting the keys oid: x.x.x.x and UTF8Value: somevalue for `otherName`. Most commonly this would be UPN set with oid: 1.3.6.1.4.1.311.20.2.3 You should ensure that any OID passed is valid for the UTF8String type as we do not explicitly validate this.
+     */
     @JsonProperty("otherNames")
     public void setOtherNames(List<OtherName> otherNames) {
         this.otherNames = otherNames;
     }
 
+    /**
+     * CertificateSpec defines the desired state of Certificate.<br><p> <br><p> NOTE: The specification contains a lot of "requested" certificate attributes, it is important to note that the issuer can choose to ignore or change any of these requested attributes. How the issuer maps a certificate request to a signed certificate is the full responsibility of the issuer itself. For example, as an edge case, an issuer that inverts the isCA value is free to do so.<br><p> <br><p> A valid Certificate requires at least one of a CommonName, LiteralSubject, DNSName, or URI to be valid.
+     */
     @JsonProperty("privateKey")
     public CertificatePrivateKey getPrivateKey() {
         return privateKey;
     }
 
+    /**
+     * CertificateSpec defines the desired state of Certificate.<br><p> <br><p> NOTE: The specification contains a lot of "requested" certificate attributes, it is important to note that the issuer can choose to ignore or change any of these requested attributes. How the issuer maps a certificate request to a signed certificate is the full responsibility of the issuer itself. For example, as an edge case, an issuer that inverts the isCA value is free to do so.<br><p> <br><p> A valid Certificate requires at least one of a CommonName, LiteralSubject, DNSName, or URI to be valid.
+     */
     @JsonProperty("privateKey")
     public void setPrivateKey(CertificatePrivateKey privateKey) {
         this.privateKey = privateKey;
     }
 
+    /**
+     * CertificateSpec defines the desired state of Certificate.<br><p> <br><p> NOTE: The specification contains a lot of "requested" certificate attributes, it is important to note that the issuer can choose to ignore or change any of these requested attributes. How the issuer maps a certificate request to a signed certificate is the full responsibility of the issuer itself. For example, as an edge case, an issuer that inverts the isCA value is free to do so.<br><p> <br><p> A valid Certificate requires at least one of a CommonName, LiteralSubject, DNSName, or URI to be valid.
+     */
     @JsonProperty("renewBefore")
     public Duration getRenewBefore() {
         return renewBefore;
     }
 
+    /**
+     * CertificateSpec defines the desired state of Certificate.<br><p> <br><p> NOTE: The specification contains a lot of "requested" certificate attributes, it is important to note that the issuer can choose to ignore or change any of these requested attributes. How the issuer maps a certificate request to a signed certificate is the full responsibility of the issuer itself. For example, as an edge case, an issuer that inverts the isCA value is free to do so.<br><p> <br><p> A valid Certificate requires at least one of a CommonName, LiteralSubject, DNSName, or URI to be valid.
+     */
     @JsonProperty("renewBefore")
     public void setRenewBefore(Duration renewBefore) {
         this.renewBefore = renewBefore;
     }
 
+    /**
+     * `renewBeforePercentage` is like `renewBefore`, except it is a relative percentage rather than an absolute duration. For example, if a certificate is valid for 60 minutes, and  `renewBeforePercentage=25`, cert-manager will begin to attempt to renew the certificate 45 minutes after it was issued (i.e. when there are 15 minutes (25%) remaining until the certificate is no longer valid).<br><p> <br><p> NOTE: The actual lifetime of the issued certificate is used to determine the renewal time. If an issuer returns a certificate with a different lifetime than the one requested, cert-manager will use the lifetime of the issued certificate.<br><p> <br><p> Value must be an integer in the range (0,100). The minimum effective `renewBefore` derived from the `renewBeforePercentage` and `duration` fields is 5 minutes. Cannot be set if the `renewBefore` field is set.
+     */
     @JsonProperty("renewBeforePercentage")
     public Integer getRenewBeforePercentage() {
         return renewBeforePercentage;
     }
 
+    /**
+     * `renewBeforePercentage` is like `renewBefore`, except it is a relative percentage rather than an absolute duration. For example, if a certificate is valid for 60 minutes, and  `renewBeforePercentage=25`, cert-manager will begin to attempt to renew the certificate 45 minutes after it was issued (i.e. when there are 15 minutes (25%) remaining until the certificate is no longer valid).<br><p> <br><p> NOTE: The actual lifetime of the issued certificate is used to determine the renewal time. If an issuer returns a certificate with a different lifetime than the one requested, cert-manager will use the lifetime of the issued certificate.<br><p> <br><p> Value must be an integer in the range (0,100). The minimum effective `renewBefore` derived from the `renewBeforePercentage` and `duration` fields is 5 minutes. Cannot be set if the `renewBefore` field is set.
+     */
     @JsonProperty("renewBeforePercentage")
     public void setRenewBeforePercentage(Integer renewBeforePercentage) {
         this.renewBeforePercentage = renewBeforePercentage;
     }
 
+    /**
+     * The maximum number of CertificateRequest revisions that are maintained in the Certificate's history. Each revision represents a single `CertificateRequest` created by this Certificate, either when it was created, renewed, or Spec was changed. Revisions will be removed by oldest first if the number of revisions exceeds this number.<br><p> <br><p> If set, revisionHistoryLimit must be a value of `1` or greater. If unset (`nil`), revisions will not be garbage collected. Default value is `nil`.
+     */
     @JsonProperty("revisionHistoryLimit")
     public Integer getRevisionHistoryLimit() {
         return revisionHistoryLimit;
     }
 
+    /**
+     * The maximum number of CertificateRequest revisions that are maintained in the Certificate's history. Each revision represents a single `CertificateRequest` created by this Certificate, either when it was created, renewed, or Spec was changed. Revisions will be removed by oldest first if the number of revisions exceeds this number.<br><p> <br><p> If set, revisionHistoryLimit must be a value of `1` or greater. If unset (`nil`), revisions will not be garbage collected. Default value is `nil`.
+     */
     @JsonProperty("revisionHistoryLimit")
     public void setRevisionHistoryLimit(Integer revisionHistoryLimit) {
         this.revisionHistoryLimit = revisionHistoryLimit;
     }
 
+    /**
+     * Name of the Secret resource that will be automatically created and managed by this Certificate resource. It will be populated with a private key and certificate, signed by the denoted issuer. The Secret resource lives in the same namespace as the Certificate resource.
+     */
     @JsonProperty("secretName")
     public String getSecretName() {
         return secretName;
     }
 
+    /**
+     * Name of the Secret resource that will be automatically created and managed by this Certificate resource. It will be populated with a private key and certificate, signed by the denoted issuer. The Secret resource lives in the same namespace as the Certificate resource.
+     */
     @JsonProperty("secretName")
     public void setSecretName(String secretName) {
         this.secretName = secretName;
     }
 
+    /**
+     * CertificateSpec defines the desired state of Certificate.<br><p> <br><p> NOTE: The specification contains a lot of "requested" certificate attributes, it is important to note that the issuer can choose to ignore or change any of these requested attributes. How the issuer maps a certificate request to a signed certificate is the full responsibility of the issuer itself. For example, as an edge case, an issuer that inverts the isCA value is free to do so.<br><p> <br><p> A valid Certificate requires at least one of a CommonName, LiteralSubject, DNSName, or URI to be valid.
+     */
     @JsonProperty("secretTemplate")
     public CertificateSecretTemplate getSecretTemplate() {
         return secretTemplate;
     }
 
+    /**
+     * CertificateSpec defines the desired state of Certificate.<br><p> <br><p> NOTE: The specification contains a lot of "requested" certificate attributes, it is important to note that the issuer can choose to ignore or change any of these requested attributes. How the issuer maps a certificate request to a signed certificate is the full responsibility of the issuer itself. For example, as an edge case, an issuer that inverts the isCA value is free to do so.<br><p> <br><p> A valid Certificate requires at least one of a CommonName, LiteralSubject, DNSName, or URI to be valid.
+     */
     @JsonProperty("secretTemplate")
     public void setSecretTemplate(CertificateSecretTemplate secretTemplate) {
         this.secretTemplate = secretTemplate;
     }
 
+    /**
+     * CertificateSpec defines the desired state of Certificate.<br><p> <br><p> NOTE: The specification contains a lot of "requested" certificate attributes, it is important to note that the issuer can choose to ignore or change any of these requested attributes. How the issuer maps a certificate request to a signed certificate is the full responsibility of the issuer itself. For example, as an edge case, an issuer that inverts the isCA value is free to do so.<br><p> <br><p> A valid Certificate requires at least one of a CommonName, LiteralSubject, DNSName, or URI to be valid.
+     */
     @JsonProperty("subject")
     public X509Subject getSubject() {
         return subject;
     }
 
+    /**
+     * CertificateSpec defines the desired state of Certificate.<br><p> <br><p> NOTE: The specification contains a lot of "requested" certificate attributes, it is important to note that the issuer can choose to ignore or change any of these requested attributes. How the issuer maps a certificate request to a signed certificate is the full responsibility of the issuer itself. For example, as an edge case, an issuer that inverts the isCA value is free to do so.<br><p> <br><p> A valid Certificate requires at least one of a CommonName, LiteralSubject, DNSName, or URI to be valid.
+     */
     @JsonProperty("subject")
     public void setSubject(X509Subject subject) {
         this.subject = subject;
     }
 
+    /**
+     * Requested URI subject alternative names.
+     */
     @JsonProperty("uris")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getUris() {
         return uris;
     }
 
+    /**
+     * Requested URI subject alternative names.
+     */
     @JsonProperty("uris")
     public void setUris(List<String> uris) {
         this.uris = uris;
     }
 
+    /**
+     * Requested key usages and extended key usages. These usages are used to set the `usages` field on the created CertificateRequest resources. If `encodeUsagesInRequest` is unset or set to `true`, the usages will additionally be encoded in the `request` field which contains the CSR blob.<br><p> <br><p> If unset, defaults to `digital signature` and `key encipherment`.
+     */
     @JsonProperty("usages")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getUsages() {
         return usages;
     }
 
+    /**
+     * Requested key usages and extended key usages. These usages are used to set the `usages` field on the created CertificateRequest resources. If `encodeUsagesInRequest` is unset or set to `true`, the usages will additionally be encoded in the `request` field which contains the CSR blob.<br><p> <br><p> If unset, defaults to `digital signature` and `key encipherment`.
+     */
     @JsonProperty("usages")
     public void setUsages(List<String> usages) {
         this.usages = usages;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateStatus.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateStatus.java
index c0e209fd127..94c9409181c 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateStatus.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/CertificateStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CertificateStatus defines the observed state of Certificate
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -109,82 +112,130 @@ public CertificateStatus(List<CertificateCondition> conditions, Integer failedIs
         this.revision = revision;
     }
 
+    /**
+     * List of status conditions to indicate the status of certificates. Known condition types are `Ready` and `Issuing`.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CertificateCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * List of status conditions to indicate the status of certificates. Known condition types are `Ready` and `Issuing`.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<CertificateCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * The number of continuous failed issuance attempts up till now. This field gets removed (if set) on a successful issuance and gets set to 1 if unset and an issuance has failed. If an issuance has failed, the delay till the next issuance will be calculated using formula time.Hour &#42; 2 ^ (failedIssuanceAttempts - 1).
+     */
     @JsonProperty("failedIssuanceAttempts")
     public Integer getFailedIssuanceAttempts() {
         return failedIssuanceAttempts;
     }
 
+    /**
+     * The number of continuous failed issuance attempts up till now. This field gets removed (if set) on a successful issuance and gets set to 1 if unset and an issuance has failed. If an issuance has failed, the delay till the next issuance will be calculated using formula time.Hour &#42; 2 ^ (failedIssuanceAttempts - 1).
+     */
     @JsonProperty("failedIssuanceAttempts")
     public void setFailedIssuanceAttempts(Integer failedIssuanceAttempts) {
         this.failedIssuanceAttempts = failedIssuanceAttempts;
     }
 
+    /**
+     * CertificateStatus defines the observed state of Certificate
+     */
     @JsonProperty("lastFailureTime")
     public String getLastFailureTime() {
         return lastFailureTime;
     }
 
+    /**
+     * CertificateStatus defines the observed state of Certificate
+     */
     @JsonProperty("lastFailureTime")
     public void setLastFailureTime(String lastFailureTime) {
         this.lastFailureTime = lastFailureTime;
     }
 
+    /**
+     * The name of the Secret resource containing the private key to be used for the next certificate iteration. The keymanager controller will automatically set this field if the `Issuing` condition is set to `True`. It will automatically unset this field when the Issuing condition is not set or False.
+     */
     @JsonProperty("nextPrivateKeySecretName")
     public String getNextPrivateKeySecretName() {
         return nextPrivateKeySecretName;
     }
 
+    /**
+     * The name of the Secret resource containing the private key to be used for the next certificate iteration. The keymanager controller will automatically set this field if the `Issuing` condition is set to `True`. It will automatically unset this field when the Issuing condition is not set or False.
+     */
     @JsonProperty("nextPrivateKeySecretName")
     public void setNextPrivateKeySecretName(String nextPrivateKeySecretName) {
         this.nextPrivateKeySecretName = nextPrivateKeySecretName;
     }
 
+    /**
+     * CertificateStatus defines the observed state of Certificate
+     */
     @JsonProperty("notAfter")
     public String getNotAfter() {
         return notAfter;
     }
 
+    /**
+     * CertificateStatus defines the observed state of Certificate
+     */
     @JsonProperty("notAfter")
     public void setNotAfter(String notAfter) {
         this.notAfter = notAfter;
     }
 
+    /**
+     * CertificateStatus defines the observed state of Certificate
+     */
     @JsonProperty("notBefore")
     public String getNotBefore() {
         return notBefore;
     }
 
+    /**
+     * CertificateStatus defines the observed state of Certificate
+     */
     @JsonProperty("notBefore")
     public void setNotBefore(String notBefore) {
         this.notBefore = notBefore;
     }
 
+    /**
+     * CertificateStatus defines the observed state of Certificate
+     */
     @JsonProperty("renewalTime")
     public String getRenewalTime() {
         return renewalTime;
     }
 
+    /**
+     * CertificateStatus defines the observed state of Certificate
+     */
     @JsonProperty("renewalTime")
     public void setRenewalTime(String renewalTime) {
         this.renewalTime = renewalTime;
     }
 
+    /**
+     * The current 'revision' of the certificate as issued.<br><p> <br><p> When a CertificateRequest resource is created, it will have the `cert-manager.io/certificate-revision` set to one greater than the current value of this field.<br><p> <br><p> Upon issuance, this field will be set to the value of the annotation on the CertificateRequest resource used to issue the certificate.<br><p> <br><p> Persisting the value on the CertificateRequest resource allows the certificates controller to know whether a request is part of an old issuance or if it is part of the ongoing revision's issuance by checking if the revision value in the annotation is greater than this field.
+     */
     @JsonProperty("revision")
     public Integer getRevision() {
         return revision;
     }
 
+    /**
+     * The current 'revision' of the certificate as issued.<br><p> <br><p> When a CertificateRequest resource is created, it will have the `cert-manager.io/certificate-revision` set to one greater than the current value of this field.<br><p> <br><p> Upon issuance, this field will be set to the value of the annotation on the CertificateRequest resource used to issue the certificate.<br><p> <br><p> Persisting the value on the CertificateRequest resource allows the certificates controller to know whether a request is part of an old issuance or if it is part of the ongoing revision's issuance by checking if the revision value in the annotation is greater than this field.
+     */
     @JsonProperty("revision")
     public void setRevision(Integer revision) {
         this.revision = revision;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/ClusterIssuer.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/ClusterIssuer.java
index d2579dde0be..a303aca3b45 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/ClusterIssuer.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/ClusterIssuer.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * A ClusterIssuer represents a certificate issuing authority which can be referenced as part of `issuerRef` fields. It is similar to an Issuer, however it is cluster-scoped and therefore can be referenced by resources that exist in &#42;any&#42; namespace, not just the same namespace as the referent.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ClusterIssuer implements Editable<ClusterIssuerBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cert-manager.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterIssuer";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public ClusterIssuer(String apiVersion, String kind, ObjectMeta metadata, Issuer
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * A ClusterIssuer represents a certificate issuing authority which can be referenced as part of `issuerRef` fields. It is similar to an Issuer, however it is cluster-scoped and therefore can be referenced by resources that exist in &#42;any&#42; namespace, not just the same namespace as the referent.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * A ClusterIssuer represents a certificate issuing authority which can be referenced as part of `issuerRef` fields. It is similar to an Issuer, however it is cluster-scoped and therefore can be referenced by resources that exist in &#42;any&#42; namespace, not just the same namespace as the referent.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * A ClusterIssuer represents a certificate issuing authority which can be referenced as part of `issuerRef` fields. It is similar to an Issuer, however it is cluster-scoped and therefore can be referenced by resources that exist in &#42;any&#42; namespace, not just the same namespace as the referent.
+     */
     @JsonProperty("spec")
     public IssuerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * A ClusterIssuer represents a certificate issuing authority which can be referenced as part of `issuerRef` fields. It is similar to an Issuer, however it is cluster-scoped and therefore can be referenced by resources that exist in &#42;any&#42; namespace, not just the same namespace as the referent.
+     */
     @JsonProperty("spec")
     public void setSpec(IssuerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * A ClusterIssuer represents a certificate issuing authority which can be referenced as part of `issuerRef` fields. It is similar to an Issuer, however it is cluster-scoped and therefore can be referenced by resources that exist in &#42;any&#42; namespace, not just the same namespace as the referent.
+     */
     @JsonProperty("status")
     public IssuerStatus getStatus() {
         return status;
     }
 
+    /**
+     * A ClusterIssuer represents a certificate issuing authority which can be referenced as part of `issuerRef` fields. It is similar to an Issuer, however it is cluster-scoped and therefore can be referenced by resources that exist in &#42;any&#42; namespace, not just the same namespace as the referent.
+     */
     @JsonProperty("status")
     public void setStatus(IssuerStatus status) {
         this.status = status;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/ClusterIssuerList.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/ClusterIssuerList.java
index fa85ddcba99..8132f2b7cfe 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/ClusterIssuerList.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/ClusterIssuerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterIssuerList is a list of Issuers
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ClusterIssuerList implements Editable<ClusterIssuerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.certmanager.api.model.v1.ClusterIssuer>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cert-manager.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.certmanager.api.model.v1.ClusterIssuer> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterIssuerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterIssuerList(String apiVersion, List<io.fabric8.certmanager.api.mode
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ClusterIssuerList is a list of Issuers
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.certmanager.api.model.v1.ClusterIssuer> getItems() {
         return items;
     }
 
+    /**
+     * ClusterIssuerList is a list of Issuers
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.certmanager.api.model.v1.ClusterIssuer> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterIssuerList is a list of Issuers
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterIssuerList is a list of Issuers
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/Issuer.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/Issuer.java
index 27a7eff2ce7..b752123c564 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/Issuer.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/Issuer.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * An Issuer represents a certificate issuing authority which can be referenced as part of `issuerRef` fields. It is scoped to a single namespace and can therefore only be referenced by resources within the same namespace.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Issuer implements Editable<IssuerBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cert-manager.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Issuer";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Issuer(String apiVersion, String kind, ObjectMeta metadata, IssuerSpec sp
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * An Issuer represents a certificate issuing authority which can be referenced as part of `issuerRef` fields. It is scoped to a single namespace and can therefore only be referenced by resources within the same namespace.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * An Issuer represents a certificate issuing authority which can be referenced as part of `issuerRef` fields. It is scoped to a single namespace and can therefore only be referenced by resources within the same namespace.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * An Issuer represents a certificate issuing authority which can be referenced as part of `issuerRef` fields. It is scoped to a single namespace and can therefore only be referenced by resources within the same namespace.
+     */
     @JsonProperty("spec")
     public IssuerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * An Issuer represents a certificate issuing authority which can be referenced as part of `issuerRef` fields. It is scoped to a single namespace and can therefore only be referenced by resources within the same namespace.
+     */
     @JsonProperty("spec")
     public void setSpec(IssuerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * An Issuer represents a certificate issuing authority which can be referenced as part of `issuerRef` fields. It is scoped to a single namespace and can therefore only be referenced by resources within the same namespace.
+     */
     @JsonProperty("status")
     public IssuerStatus getStatus() {
         return status;
     }
 
+    /**
+     * An Issuer represents a certificate issuing authority which can be referenced as part of `issuerRef` fields. It is scoped to a single namespace and can therefore only be referenced by resources within the same namespace.
+     */
     @JsonProperty("status")
     public void setStatus(IssuerStatus status) {
         this.status = status;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/IssuerCondition.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/IssuerCondition.java
index 6af42a225f4..1adf4c62457 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/IssuerCondition.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/IssuerCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IssuerCondition contains condition information for an Issuer.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public IssuerCondition(String lastTransitionTime, String message, Long observedG
         this.type = type;
     }
 
+    /**
+     * IssuerCondition contains condition information for an Issuer.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * IssuerCondition contains condition information for an Issuer.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Message is a human readable description of the details of the last transition, complementing reason.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message is a human readable description of the details of the last transition, complementing reason.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * If set, this represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.condition[x].observedGeneration is 9, the condition is out of date with respect to the current state of the Issuer.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * If set, this represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.condition[x].observedGeneration is 9, the condition is out of date with respect to the current state of the Issuer.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Reason is a brief machine readable explanation for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason is a brief machine readable explanation for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of the condition, one of (`True`, `False`, `Unknown`).
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition, one of (`True`, `False`, `Unknown`).
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type of the condition, known values are (`Ready`).
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of the condition, known values are (`Ready`).
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/IssuerConfig.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/IssuerConfig.java
index 7f4609f3feb..d0112813a17 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/IssuerConfig.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/IssuerConfig.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * The configuration for the issuer. Only one of these can be set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,51 +98,81 @@ public IssuerConfig(ACMEIssuer acme, CAIssuer ca, SelfSignedIssuer selfSigned, V
         this.venafi = venafi;
     }
 
+    /**
+     * The configuration for the issuer. Only one of these can be set.
+     */
     @JsonProperty("acme")
     public ACMEIssuer getAcme() {
         return acme;
     }
 
+    /**
+     * The configuration for the issuer. Only one of these can be set.
+     */
     @JsonProperty("acme")
     public void setAcme(ACMEIssuer acme) {
         this.acme = acme;
     }
 
+    /**
+     * The configuration for the issuer. Only one of these can be set.
+     */
     @JsonProperty("ca")
     public CAIssuer getCa() {
         return ca;
     }
 
+    /**
+     * The configuration for the issuer. Only one of these can be set.
+     */
     @JsonProperty("ca")
     public void setCa(CAIssuer ca) {
         this.ca = ca;
     }
 
+    /**
+     * The configuration for the issuer. Only one of these can be set.
+     */
     @JsonProperty("selfSigned")
     public SelfSignedIssuer getSelfSigned() {
         return selfSigned;
     }
 
+    /**
+     * The configuration for the issuer. Only one of these can be set.
+     */
     @JsonProperty("selfSigned")
     public void setSelfSigned(SelfSignedIssuer selfSigned) {
         this.selfSigned = selfSigned;
     }
 
+    /**
+     * The configuration for the issuer. Only one of these can be set.
+     */
     @JsonProperty("vault")
     public VaultIssuer getVault() {
         return vault;
     }
 
+    /**
+     * The configuration for the issuer. Only one of these can be set.
+     */
     @JsonProperty("vault")
     public void setVault(VaultIssuer vault) {
         this.vault = vault;
     }
 
+    /**
+     * The configuration for the issuer. Only one of these can be set.
+     */
     @JsonProperty("venafi")
     public VenafiIssuer getVenafi() {
         return venafi;
     }
 
+    /**
+     * The configuration for the issuer. Only one of these can be set.
+     */
     @JsonProperty("venafi")
     public void setVenafi(VenafiIssuer venafi) {
         this.venafi = venafi;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/IssuerList.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/IssuerList.java
index 04cb5c53668..31d2fc4caad 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/IssuerList.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/IssuerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IssuerList is a list of Issuers
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class IssuerList implements Editable<IssuerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.certmanager.api.model.v1.Issuer>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cert-manager.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.certmanager.api.model.v1.Issuer> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "IssuerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public IssuerList(String apiVersion, List<io.fabric8.certmanager.api.model.v1.Is
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * IssuerList is a list of Issuers
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.certmanager.api.model.v1.Issuer> getItems() {
         return items;
     }
 
+    /**
+     * IssuerList is a list of Issuers
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.certmanager.api.model.v1.Issuer> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * IssuerList is a list of Issuers
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * IssuerList is a list of Issuers
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/IssuerSpec.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/IssuerSpec.java
index 0d968fe89a7..e89d224f373 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/IssuerSpec.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/IssuerSpec.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IssuerSpec is the specification of an Issuer. This includes any configuration required for the issuer.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,51 +98,81 @@ public IssuerSpec(ACMEIssuer acme, CAIssuer ca, SelfSignedIssuer selfSigned, Vau
         this.venafi = venafi;
     }
 
+    /**
+     * IssuerSpec is the specification of an Issuer. This includes any configuration required for the issuer.
+     */
     @JsonProperty("acme")
     public ACMEIssuer getAcme() {
         return acme;
     }
 
+    /**
+     * IssuerSpec is the specification of an Issuer. This includes any configuration required for the issuer.
+     */
     @JsonProperty("acme")
     public void setAcme(ACMEIssuer acme) {
         this.acme = acme;
     }
 
+    /**
+     * IssuerSpec is the specification of an Issuer. This includes any configuration required for the issuer.
+     */
     @JsonProperty("ca")
     public CAIssuer getCa() {
         return ca;
     }
 
+    /**
+     * IssuerSpec is the specification of an Issuer. This includes any configuration required for the issuer.
+     */
     @JsonProperty("ca")
     public void setCa(CAIssuer ca) {
         this.ca = ca;
     }
 
+    /**
+     * IssuerSpec is the specification of an Issuer. This includes any configuration required for the issuer.
+     */
     @JsonProperty("selfSigned")
     public SelfSignedIssuer getSelfSigned() {
         return selfSigned;
     }
 
+    /**
+     * IssuerSpec is the specification of an Issuer. This includes any configuration required for the issuer.
+     */
     @JsonProperty("selfSigned")
     public void setSelfSigned(SelfSignedIssuer selfSigned) {
         this.selfSigned = selfSigned;
     }
 
+    /**
+     * IssuerSpec is the specification of an Issuer. This includes any configuration required for the issuer.
+     */
     @JsonProperty("vault")
     public VaultIssuer getVault() {
         return vault;
     }
 
+    /**
+     * IssuerSpec is the specification of an Issuer. This includes any configuration required for the issuer.
+     */
     @JsonProperty("vault")
     public void setVault(VaultIssuer vault) {
         this.vault = vault;
     }
 
+    /**
+     * IssuerSpec is the specification of an Issuer. This includes any configuration required for the issuer.
+     */
     @JsonProperty("venafi")
     public VenafiIssuer getVenafi() {
         return venafi;
     }
 
+    /**
+     * IssuerSpec is the specification of an Issuer. This includes any configuration required for the issuer.
+     */
     @JsonProperty("venafi")
     public void setVenafi(VenafiIssuer venafi) {
         this.venafi = venafi;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/IssuerStatus.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/IssuerStatus.java
index 63e4c0a5be9..96194d49e35 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/IssuerStatus.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/IssuerStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IssuerStatus contains status information about an Issuer
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,22 +89,34 @@ public IssuerStatus(ACMEIssuerStatus acme, List<IssuerCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * IssuerStatus contains status information about an Issuer
+     */
     @JsonProperty("acme")
     public ACMEIssuerStatus getAcme() {
         return acme;
     }
 
+    /**
+     * IssuerStatus contains status information about an Issuer
+     */
     @JsonProperty("acme")
     public void setAcme(ACMEIssuerStatus acme) {
         this.acme = acme;
     }
 
+    /**
+     * List of status conditions to indicate the status of a CertificateRequest. Known condition types are `Ready`.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IssuerCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * List of status conditions to indicate the status of a CertificateRequest. Known condition types are `Ready`.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<IssuerCondition> conditions) {
         this.conditions = conditions;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/JKSKeystore.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/JKSKeystore.java
index e4875c70d8e..0932d17dddb 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/JKSKeystore.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/JKSKeystore.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JKS configures options for storing a JKS keystore in the `spec.secretName` Secret resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,31 +90,49 @@ public JKSKeystore(String alias, Boolean create, SecretKeySelector passwordSecre
         this.passwordSecretRef = passwordSecretRef;
     }
 
+    /**
+     * Alias specifies the alias of the key in the keystore, required by the JKS format. If not provided, the default alias `certificate` will be used.
+     */
     @JsonProperty("alias")
     public String getAlias() {
         return alias;
     }
 
+    /**
+     * Alias specifies the alias of the key in the keystore, required by the JKS format. If not provided, the default alias `certificate` will be used.
+     */
     @JsonProperty("alias")
     public void setAlias(String alias) {
         this.alias = alias;
     }
 
+    /**
+     * Create enables JKS keystore creation for the Certificate. If true, a file named `keystore.jks` will be created in the target Secret resource, encrypted using the password stored in `passwordSecretRef`. The keystore file will be updated immediately. If the issuer provided a CA certificate, a file named `truststore.jks` will also be created in the target Secret resource, encrypted using the password stored in `passwordSecretRef` containing the issuing Certificate Authority
+     */
     @JsonProperty("create")
     public Boolean getCreate() {
         return create;
     }
 
+    /**
+     * Create enables JKS keystore creation for the Certificate. If true, a file named `keystore.jks` will be created in the target Secret resource, encrypted using the password stored in `passwordSecretRef`. The keystore file will be updated immediately. If the issuer provided a CA certificate, a file named `truststore.jks` will also be created in the target Secret resource, encrypted using the password stored in `passwordSecretRef` containing the issuing Certificate Authority
+     */
     @JsonProperty("create")
     public void setCreate(Boolean create) {
         this.create = create;
     }
 
+    /**
+     * JKS configures options for storing a JKS keystore in the `spec.secretName` Secret resource.
+     */
     @JsonProperty("passwordSecretRef")
     public SecretKeySelector getPasswordSecretRef() {
         return passwordSecretRef;
     }
 
+    /**
+     * JKS configures options for storing a JKS keystore in the `spec.secretName` Secret resource.
+     */
     @JsonProperty("passwordSecretRef")
     public void setPasswordSecretRef(SecretKeySelector passwordSecretRef) {
         this.passwordSecretRef = passwordSecretRef;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/NameConstraintItem.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/NameConstraintItem.java
index 91a7806be84..317e67dc048 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/NameConstraintItem.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/NameConstraintItem.java
@@ -96,45 +96,69 @@ public NameConstraintItem(List<String> dnsDomains, List<String> emailAddresses,
         this.uriDomains = uriDomains;
     }
 
+    /**
+     * DNSDomains is a list of DNS domains that are permitted or excluded.
+     */
     @JsonProperty("dnsDomains")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDnsDomains() {
         return dnsDomains;
     }
 
+    /**
+     * DNSDomains is a list of DNS domains that are permitted or excluded.
+     */
     @JsonProperty("dnsDomains")
     public void setDnsDomains(List<String> dnsDomains) {
         this.dnsDomains = dnsDomains;
     }
 
+    /**
+     * EmailAddresses is a list of Email Addresses that are permitted or excluded.
+     */
     @JsonProperty("emailAddresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEmailAddresses() {
         return emailAddresses;
     }
 
+    /**
+     * EmailAddresses is a list of Email Addresses that are permitted or excluded.
+     */
     @JsonProperty("emailAddresses")
     public void setEmailAddresses(List<String> emailAddresses) {
         this.emailAddresses = emailAddresses;
     }
 
+    /**
+     * IPRanges is a list of IP Ranges that are permitted or excluded. This should be a valid CIDR notation.
+     */
     @JsonProperty("ipRanges")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIpRanges() {
         return ipRanges;
     }
 
+    /**
+     * IPRanges is a list of IP Ranges that are permitted or excluded. This should be a valid CIDR notation.
+     */
     @JsonProperty("ipRanges")
     public void setIpRanges(List<String> ipRanges) {
         this.ipRanges = ipRanges;
     }
 
+    /**
+     * URIDomains is a list of URI domains that are permitted or excluded.
+     */
     @JsonProperty("uriDomains")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getUriDomains() {
         return uriDomains;
     }
 
+    /**
+     * URIDomains is a list of URI domains that are permitted or excluded.
+     */
     @JsonProperty("uriDomains")
     public void setUriDomains(List<String> uriDomains) {
         this.uriDomains = uriDomains;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/NameConstraints.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/NameConstraints.java
index 2e851579fbd..4095baf0082 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/NameConstraints.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/NameConstraints.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NameConstraints is a type to represent x509 NameConstraints
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public NameConstraints(Boolean critical, NameConstraintItem excluded, NameConstr
         this.permitted = permitted;
     }
 
+    /**
+     * if true then the name constraints are marked critical.
+     */
     @JsonProperty("critical")
     public Boolean getCritical() {
         return critical;
     }
 
+    /**
+     * if true then the name constraints are marked critical.
+     */
     @JsonProperty("critical")
     public void setCritical(Boolean critical) {
         this.critical = critical;
     }
 
+    /**
+     * NameConstraints is a type to represent x509 NameConstraints
+     */
     @JsonProperty("excluded")
     public NameConstraintItem getExcluded() {
         return excluded;
     }
 
+    /**
+     * NameConstraints is a type to represent x509 NameConstraints
+     */
     @JsonProperty("excluded")
     public void setExcluded(NameConstraintItem excluded) {
         this.excluded = excluded;
     }
 
+    /**
+     * NameConstraints is a type to represent x509 NameConstraints
+     */
     @JsonProperty("permitted")
     public NameConstraintItem getPermitted() {
         return permitted;
     }
 
+    /**
+     * NameConstraints is a type to represent x509 NameConstraints
+     */
     @JsonProperty("permitted")
     public void setPermitted(NameConstraintItem permitted) {
         this.permitted = permitted;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/OtherName.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/OtherName.java
index 1da42dbb023..6e7ab81859c 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/OtherName.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/OtherName.java
@@ -82,21 +82,33 @@ public OtherName(String oid, String utf8Value) {
         this.utf8Value = utf8Value;
     }
 
+    /**
+     * OID is the object identifier for the otherName SAN. The object identifier must be expressed as a dotted string, for example, "1.2.840.113556.1.4.221".
+     */
     @JsonProperty("oid")
     public String getOid() {
         return oid;
     }
 
+    /**
+     * OID is the object identifier for the otherName SAN. The object identifier must be expressed as a dotted string, for example, "1.2.840.113556.1.4.221".
+     */
     @JsonProperty("oid")
     public void setOid(String oid) {
         this.oid = oid;
     }
 
+    /**
+     * utf8Value is the string value of the otherName SAN. The utf8Value accepts any valid UTF8 string to set as value for the otherName SAN.
+     */
     @JsonProperty("utf8Value")
     public String getUtf8Value() {
         return utf8Value;
     }
 
+    /**
+     * utf8Value is the string value of the otherName SAN. The utf8Value accepts any valid UTF8 string to set as value for the otherName SAN.
+     */
     @JsonProperty("utf8Value")
     public void setUtf8Value(String utf8Value) {
         this.utf8Value = utf8Value;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/PKCS12Keystore.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/PKCS12Keystore.java
index ba5cabaf0dc..f3574c39f10 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/PKCS12Keystore.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/PKCS12Keystore.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PKCS12 configures options for storing a PKCS12 keystore in the `spec.secretName` Secret resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,31 +90,49 @@ public PKCS12Keystore(Boolean create, SecretKeySelector passwordSecretRef, Strin
         this.profile = profile;
     }
 
+    /**
+     * Create enables PKCS12 keystore creation for the Certificate. If true, a file named `keystore.p12` will be created in the target Secret resource, encrypted using the password stored in `passwordSecretRef`. The keystore file will be updated immediately. If the issuer provided a CA certificate, a file named `truststore.p12` will also be created in the target Secret resource, encrypted using the password stored in `passwordSecretRef` containing the issuing Certificate Authority
+     */
     @JsonProperty("create")
     public Boolean getCreate() {
         return create;
     }
 
+    /**
+     * Create enables PKCS12 keystore creation for the Certificate. If true, a file named `keystore.p12` will be created in the target Secret resource, encrypted using the password stored in `passwordSecretRef`. The keystore file will be updated immediately. If the issuer provided a CA certificate, a file named `truststore.p12` will also be created in the target Secret resource, encrypted using the password stored in `passwordSecretRef` containing the issuing Certificate Authority
+     */
     @JsonProperty("create")
     public void setCreate(Boolean create) {
         this.create = create;
     }
 
+    /**
+     * PKCS12 configures options for storing a PKCS12 keystore in the `spec.secretName` Secret resource.
+     */
     @JsonProperty("passwordSecretRef")
     public SecretKeySelector getPasswordSecretRef() {
         return passwordSecretRef;
     }
 
+    /**
+     * PKCS12 configures options for storing a PKCS12 keystore in the `spec.secretName` Secret resource.
+     */
     @JsonProperty("passwordSecretRef")
     public void setPasswordSecretRef(SecretKeySelector passwordSecretRef) {
         this.passwordSecretRef = passwordSecretRef;
     }
 
+    /**
+     * Profile specifies the key and certificate encryption algorithms and the HMAC algorithm used to create the PKCS12 keystore. Default value is `LegacyRC2` for backward compatibility.<br><p> <br><p> If provided, allowed values are: `LegacyRC2`: Deprecated. Not supported by default in OpenSSL 3 or Java 20. `LegacyDES`: Less secure algorithm. Use this option for maximal compatibility. `Modern2023`: Secure algorithm. Use this option in case you have to always use secure algorithms (eg. because of company policy). Please note that the security of the algorithm is not that important in reality, because the unencrypted certificate and private key are also stored in the Secret.
+     */
     @JsonProperty("profile")
     public String getProfile() {
         return profile;
     }
 
+    /**
+     * Profile specifies the key and certificate encryption algorithms and the HMAC algorithm used to create the PKCS12 keystore. Default value is `LegacyRC2` for backward compatibility.<br><p> <br><p> If provided, allowed values are: `LegacyRC2`: Deprecated. Not supported by default in OpenSSL 3 or Java 20. `LegacyDES`: Less secure algorithm. Use this option for maximal compatibility. `Modern2023`: Secure algorithm. Use this option in case you have to always use secure algorithms (eg. because of company policy). Please note that the security of the algorithm is not that important in reality, because the unencrypted certificate and private key are also stored in the Secret.
+     */
     @JsonProperty("profile")
     public void setProfile(String profile) {
         this.profile = profile;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/SelfSignedIssuer.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/SelfSignedIssuer.java
index a22b2a9acbc..dbdae8c7e80 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/SelfSignedIssuer.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/SelfSignedIssuer.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Configures an issuer to 'self sign' certificates using the private key used to create the CertificateRequest object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public SelfSignedIssuer(List<String> crlDistributionPoints) {
         this.crlDistributionPoints = crlDistributionPoints;
     }
 
+    /**
+     * The CRL distribution points is an X.509 v3 certificate extension which identifies the location of the CRL from which the revocation of this certificate can be checked. If not set certificate will be issued without CDP. Values are strings.
+     */
     @JsonProperty("crlDistributionPoints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCrlDistributionPoints() {
         return crlDistributionPoints;
     }
 
+    /**
+     * The CRL distribution points is an X.509 v3 certificate extension which identifies the location of the CRL from which the revocation of this certificate can be checked. If not set certificate will be issued without CDP. Values are strings.
+     */
     @JsonProperty("crlDistributionPoints")
     public void setCrlDistributionPoints(List<String> crlDistributionPoints) {
         this.crlDistributionPoints = crlDistributionPoints;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/ServiceAccountRef.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/ServiceAccountRef.java
index 586bb273bd9..3ffffbb66e0 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/ServiceAccountRef.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/ServiceAccountRef.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceAccountRef is a service account used by cert-manager to request a token. Default audience is generated by cert-manager and takes the form `vault://namespace-name/issuer-name` for an Issuer and `vault://issuer-name` for a ClusterIssuer. The expiration of the token is also set by cert-manager to 10 minutes.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public ServiceAccountRef(List<String> audiences, String name) {
         this.name = name;
     }
 
+    /**
+     * TokenAudiences is an optional list of extra audiences to include in the token passed to Vault. The default token consisting of the issuer's namespace and name is always included.
+     */
     @JsonProperty("audiences")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAudiences() {
         return audiences;
     }
 
+    /**
+     * TokenAudiences is an optional list of extra audiences to include in the token passed to Vault. The default token consisting of the issuer's namespace and name is always included.
+     */
     @JsonProperty("audiences")
     public void setAudiences(List<String> audiences) {
         this.audiences = audiences;
     }
 
+    /**
+     * Name of the ServiceAccount used to request a token.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the ServiceAccount used to request a token.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VaultAppRole.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VaultAppRole.java
index f3bd2cf8f59..73c89eebbb1 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VaultAppRole.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VaultAppRole.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VaultAppRole authenticates with Vault using the App Role auth mechanism, with the role and secret stored in a Kubernetes Secret resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,31 +90,49 @@ public VaultAppRole(String path, String roleId, SecretKeySelector secretRef) {
         this.secretRef = secretRef;
     }
 
+    /**
+     * Path where the App Role authentication backend is mounted in Vault, e.g: "approle"
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Path where the App Role authentication backend is mounted in Vault, e.g: "approle"
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * RoleID configured in the App Role authentication backend when setting up the authentication backend in Vault.
+     */
     @JsonProperty("roleId")
     public String getRoleId() {
         return roleId;
     }
 
+    /**
+     * RoleID configured in the App Role authentication backend when setting up the authentication backend in Vault.
+     */
     @JsonProperty("roleId")
     public void setRoleId(String roleId) {
         this.roleId = roleId;
     }
 
+    /**
+     * VaultAppRole authenticates with Vault using the App Role auth mechanism, with the role and secret stored in a Kubernetes Secret resource.
+     */
     @JsonProperty("secretRef")
     public SecretKeySelector getSecretRef() {
         return secretRef;
     }
 
+    /**
+     * VaultAppRole authenticates with Vault using the App Role auth mechanism, with the role and secret stored in a Kubernetes Secret resource.
+     */
     @JsonProperty("secretRef")
     public void setSecretRef(SecretKeySelector secretRef) {
         this.secretRef = secretRef;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VaultAuth.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VaultAuth.java
index c6f5ba86004..5fef34deebc 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VaultAuth.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VaultAuth.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VaultAuth is configuration used to authenticate with a Vault server. The order of precedence is [`tokenSecretRef`, `appRole`, `clientCertificate` or `kubernetes`].
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,41 +94,65 @@ public VaultAuth(VaultAppRole appRole, VaultClientCertificateAuth clientCertific
         this.tokenSecretRef = tokenSecretRef;
     }
 
+    /**
+     * VaultAuth is configuration used to authenticate with a Vault server. The order of precedence is [`tokenSecretRef`, `appRole`, `clientCertificate` or `kubernetes`].
+     */
     @JsonProperty("appRole")
     public VaultAppRole getAppRole() {
         return appRole;
     }
 
+    /**
+     * VaultAuth is configuration used to authenticate with a Vault server. The order of precedence is [`tokenSecretRef`, `appRole`, `clientCertificate` or `kubernetes`].
+     */
     @JsonProperty("appRole")
     public void setAppRole(VaultAppRole appRole) {
         this.appRole = appRole;
     }
 
+    /**
+     * VaultAuth is configuration used to authenticate with a Vault server. The order of precedence is [`tokenSecretRef`, `appRole`, `clientCertificate` or `kubernetes`].
+     */
     @JsonProperty("clientCertificate")
     public VaultClientCertificateAuth getClientCertificate() {
         return clientCertificate;
     }
 
+    /**
+     * VaultAuth is configuration used to authenticate with a Vault server. The order of precedence is [`tokenSecretRef`, `appRole`, `clientCertificate` or `kubernetes`].
+     */
     @JsonProperty("clientCertificate")
     public void setClientCertificate(VaultClientCertificateAuth clientCertificate) {
         this.clientCertificate = clientCertificate;
     }
 
+    /**
+     * VaultAuth is configuration used to authenticate with a Vault server. The order of precedence is [`tokenSecretRef`, `appRole`, `clientCertificate` or `kubernetes`].
+     */
     @JsonProperty("kubernetes")
     public VaultKubernetesAuth getKubernetes() {
         return kubernetes;
     }
 
+    /**
+     * VaultAuth is configuration used to authenticate with a Vault server. The order of precedence is [`tokenSecretRef`, `appRole`, `clientCertificate` or `kubernetes`].
+     */
     @JsonProperty("kubernetes")
     public void setKubernetes(VaultKubernetesAuth kubernetes) {
         this.kubernetes = kubernetes;
     }
 
+    /**
+     * VaultAuth is configuration used to authenticate with a Vault server. The order of precedence is [`tokenSecretRef`, `appRole`, `clientCertificate` or `kubernetes`].
+     */
     @JsonProperty("tokenSecretRef")
     public SecretKeySelector getTokenSecretRef() {
         return tokenSecretRef;
     }
 
+    /**
+     * VaultAuth is configuration used to authenticate with a Vault server. The order of precedence is [`tokenSecretRef`, `appRole`, `clientCertificate` or `kubernetes`].
+     */
     @JsonProperty("tokenSecretRef")
     public void setTokenSecretRef(SecretKeySelector tokenSecretRef) {
         this.tokenSecretRef = tokenSecretRef;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VaultClientCertificateAuth.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VaultClientCertificateAuth.java
index bfb223a787e..6f5b7523b78 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VaultClientCertificateAuth.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VaultClientCertificateAuth.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VaultKubernetesAuth is used to authenticate against Vault using a client certificate stored in a Secret.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public VaultClientCertificateAuth(String mountPath, String name, String secretNa
         this.secretName = secretName;
     }
 
+    /**
+     * The Vault mountPath here is the mount path to use when authenticating with Vault. For example, setting a value to `/v1/auth/foo`, will use the path `/v1/auth/foo/login` to authenticate with Vault. If unspecified, the default value "/v1/auth/cert" will be used.
+     */
     @JsonProperty("mountPath")
     public String getMountPath() {
         return mountPath;
     }
 
+    /**
+     * The Vault mountPath here is the mount path to use when authenticating with Vault. For example, setting a value to `/v1/auth/foo`, will use the path `/v1/auth/foo/login` to authenticate with Vault. If unspecified, the default value "/v1/auth/cert" will be used.
+     */
     @JsonProperty("mountPath")
     public void setMountPath(String mountPath) {
         this.mountPath = mountPath;
     }
 
+    /**
+     * Name of the certificate role to authenticate against. If not set, matching any certificate role, if available.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the certificate role to authenticate against. If not set, matching any certificate role, if available.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Reference to Kubernetes Secret of type "kubernetes.io/tls" (hence containing tls.crt and tls.key) used to authenticate to Vault using TLS client authentication.
+     */
     @JsonProperty("secretName")
     public String getSecretName() {
         return secretName;
     }
 
+    /**
+     * Reference to Kubernetes Secret of type "kubernetes.io/tls" (hence containing tls.crt and tls.key) used to authenticate to Vault using TLS client authentication.
+     */
     @JsonProperty("secretName")
     public void setSecretName(String secretName) {
         this.secretName = secretName;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VaultIssuer.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VaultIssuer.java
index 247586cfb32..f996fd3b91f 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VaultIssuer.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VaultIssuer.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Configures an issuer to sign certificates using a HashiCorp Vault PKI backend.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -107,81 +110,129 @@ public VaultIssuer(VaultAuth auth, String caBundle, SecretKeySelector caBundleSe
         this.server = server;
     }
 
+    /**
+     * Configures an issuer to sign certificates using a HashiCorp Vault PKI backend.
+     */
     @JsonProperty("auth")
     public VaultAuth getAuth() {
         return auth;
     }
 
+    /**
+     * Configures an issuer to sign certificates using a HashiCorp Vault PKI backend.
+     */
     @JsonProperty("auth")
     public void setAuth(VaultAuth auth) {
         this.auth = auth;
     }
 
+    /**
+     * Base64-encoded bundle of PEM CAs which will be used to validate the certificate chain presented by Vault. Only used if using HTTPS to connect to Vault and ignored for HTTP connections. Mutually exclusive with CABundleSecretRef. If neither CABundle nor CABundleSecretRef are defined, the certificate bundle in the cert-manager controller container is used to validate the TLS connection.
+     */
     @JsonProperty("caBundle")
     public String getCaBundle() {
         return caBundle;
     }
 
+    /**
+     * Base64-encoded bundle of PEM CAs which will be used to validate the certificate chain presented by Vault. Only used if using HTTPS to connect to Vault and ignored for HTTP connections. Mutually exclusive with CABundleSecretRef. If neither CABundle nor CABundleSecretRef are defined, the certificate bundle in the cert-manager controller container is used to validate the TLS connection.
+     */
     @JsonProperty("caBundle")
     public void setCaBundle(String caBundle) {
         this.caBundle = caBundle;
     }
 
+    /**
+     * Configures an issuer to sign certificates using a HashiCorp Vault PKI backend.
+     */
     @JsonProperty("caBundleSecretRef")
     public SecretKeySelector getCaBundleSecretRef() {
         return caBundleSecretRef;
     }
 
+    /**
+     * Configures an issuer to sign certificates using a HashiCorp Vault PKI backend.
+     */
     @JsonProperty("caBundleSecretRef")
     public void setCaBundleSecretRef(SecretKeySelector caBundleSecretRef) {
         this.caBundleSecretRef = caBundleSecretRef;
     }
 
+    /**
+     * Configures an issuer to sign certificates using a HashiCorp Vault PKI backend.
+     */
     @JsonProperty("clientCertSecretRef")
     public SecretKeySelector getClientCertSecretRef() {
         return clientCertSecretRef;
     }
 
+    /**
+     * Configures an issuer to sign certificates using a HashiCorp Vault PKI backend.
+     */
     @JsonProperty("clientCertSecretRef")
     public void setClientCertSecretRef(SecretKeySelector clientCertSecretRef) {
         this.clientCertSecretRef = clientCertSecretRef;
     }
 
+    /**
+     * Configures an issuer to sign certificates using a HashiCorp Vault PKI backend.
+     */
     @JsonProperty("clientKeySecretRef")
     public SecretKeySelector getClientKeySecretRef() {
         return clientKeySecretRef;
     }
 
+    /**
+     * Configures an issuer to sign certificates using a HashiCorp Vault PKI backend.
+     */
     @JsonProperty("clientKeySecretRef")
     public void setClientKeySecretRef(SecretKeySelector clientKeySecretRef) {
         this.clientKeySecretRef = clientKeySecretRef;
     }
 
+    /**
+     * Name of the vault namespace. Namespaces is a set of features within Vault Enterprise that allows Vault environments to support Secure Multi-tenancy. e.g: "ns1" More about namespaces can be found here https://www.vaultproject.io/docs/enterprise/namespaces
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Name of the vault namespace. Namespaces is a set of features within Vault Enterprise that allows Vault environments to support Secure Multi-tenancy. e.g: "ns1" More about namespaces can be found here https://www.vaultproject.io/docs/enterprise/namespaces
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Path is the mount path of the Vault PKI backend's `sign` endpoint, e.g: "my_pki_mount/sign/my-role-name".
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Path is the mount path of the Vault PKI backend's `sign` endpoint, e.g: "my_pki_mount/sign/my-role-name".
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * Server is the connection address for the Vault server, e.g: "https://vault.example.com:8200".
+     */
     @JsonProperty("server")
     public String getServer() {
         return server;
     }
 
+    /**
+     * Server is the connection address for the Vault server, e.g: "https://vault.example.com:8200".
+     */
     @JsonProperty("server")
     public void setServer(String server) {
         this.server = server;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VaultKubernetesAuth.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VaultKubernetesAuth.java
index c4dce15914b..29ffef95009 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VaultKubernetesAuth.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VaultKubernetesAuth.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Authenticate against Vault using a Kubernetes ServiceAccount token stored in a Secret.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,41 +94,65 @@ public VaultKubernetesAuth(String mountPath, String role, SecretKeySelector secr
         this.serviceAccountRef = serviceAccountRef;
     }
 
+    /**
+     * The Vault mountPath here is the mount path to use when authenticating with Vault. For example, setting a value to `/v1/auth/foo`, will use the path `/v1/auth/foo/login` to authenticate with Vault. If unspecified, the default value "/v1/auth/kubernetes" will be used.
+     */
     @JsonProperty("mountPath")
     public String getMountPath() {
         return mountPath;
     }
 
+    /**
+     * The Vault mountPath here is the mount path to use when authenticating with Vault. For example, setting a value to `/v1/auth/foo`, will use the path `/v1/auth/foo/login` to authenticate with Vault. If unspecified, the default value "/v1/auth/kubernetes" will be used.
+     */
     @JsonProperty("mountPath")
     public void setMountPath(String mountPath) {
         this.mountPath = mountPath;
     }
 
+    /**
+     * A required field containing the Vault Role to assume. A Role binds a Kubernetes ServiceAccount with a set of Vault policies.
+     */
     @JsonProperty("role")
     public String getRole() {
         return role;
     }
 
+    /**
+     * A required field containing the Vault Role to assume. A Role binds a Kubernetes ServiceAccount with a set of Vault policies.
+     */
     @JsonProperty("role")
     public void setRole(String role) {
         this.role = role;
     }
 
+    /**
+     * Authenticate against Vault using a Kubernetes ServiceAccount token stored in a Secret.
+     */
     @JsonProperty("secretRef")
     public SecretKeySelector getSecretRef() {
         return secretRef;
     }
 
+    /**
+     * Authenticate against Vault using a Kubernetes ServiceAccount token stored in a Secret.
+     */
     @JsonProperty("secretRef")
     public void setSecretRef(SecretKeySelector secretRef) {
         this.secretRef = secretRef;
     }
 
+    /**
+     * Authenticate against Vault using a Kubernetes ServiceAccount token stored in a Secret.
+     */
     @JsonProperty("serviceAccountRef")
     public ServiceAccountRef getServiceAccountRef() {
         return serviceAccountRef;
     }
 
+    /**
+     * Authenticate against Vault using a Kubernetes ServiceAccount token stored in a Secret.
+     */
     @JsonProperty("serviceAccountRef")
     public void setServiceAccountRef(ServiceAccountRef serviceAccountRef) {
         this.serviceAccountRef = serviceAccountRef;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VenafiCloud.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VenafiCloud.java
index c880ac69f12..95f812e4069 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VenafiCloud.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VenafiCloud.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VenafiCloud defines connection configuration details for Venafi Cloud
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public VenafiCloud(SecretKeySelector apiTokenSecretRef, String url) {
         this.url = url;
     }
 
+    /**
+     * VenafiCloud defines connection configuration details for Venafi Cloud
+     */
     @JsonProperty("apiTokenSecretRef")
     public SecretKeySelector getApiTokenSecretRef() {
         return apiTokenSecretRef;
     }
 
+    /**
+     * VenafiCloud defines connection configuration details for Venafi Cloud
+     */
     @JsonProperty("apiTokenSecretRef")
     public void setApiTokenSecretRef(SecretKeySelector apiTokenSecretRef) {
         this.apiTokenSecretRef = apiTokenSecretRef;
     }
 
+    /**
+     * URL is the base URL for Venafi Cloud. Defaults to "https://api.venafi.cloud/v1".
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * URL is the base URL for Venafi Cloud. Defaults to "https://api.venafi.cloud/v1".
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VenafiIssuer.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VenafiIssuer.java
index 41082af9598..13eb2135fe6 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VenafiIssuer.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VenafiIssuer.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Configures an issuer to sign certificates using a Venafi TPP or Cloud policy zone.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public VenafiIssuer(VenafiCloud cloud, VenafiTPP tpp, String zone) {
         this.zone = zone;
     }
 
+    /**
+     * Configures an issuer to sign certificates using a Venafi TPP or Cloud policy zone.
+     */
     @JsonProperty("cloud")
     public VenafiCloud getCloud() {
         return cloud;
     }
 
+    /**
+     * Configures an issuer to sign certificates using a Venafi TPP or Cloud policy zone.
+     */
     @JsonProperty("cloud")
     public void setCloud(VenafiCloud cloud) {
         this.cloud = cloud;
     }
 
+    /**
+     * Configures an issuer to sign certificates using a Venafi TPP or Cloud policy zone.
+     */
     @JsonProperty("tpp")
     public VenafiTPP getTpp() {
         return tpp;
     }
 
+    /**
+     * Configures an issuer to sign certificates using a Venafi TPP or Cloud policy zone.
+     */
     @JsonProperty("tpp")
     public void setTpp(VenafiTPP tpp) {
         this.tpp = tpp;
     }
 
+    /**
+     * Zone is the Venafi Policy Zone to use for this issuer. All requests made to the Venafi platform will be restricted by the named zone policy. This field is required.
+     */
     @JsonProperty("zone")
     public String getZone() {
         return zone;
     }
 
+    /**
+     * Zone is the Venafi Policy Zone to use for this issuer. All requests made to the Venafi platform will be restricted by the named zone policy. This field is required.
+     */
     @JsonProperty("zone")
     public void setZone(String zone) {
         this.zone = zone;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VenafiTPP.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VenafiTPP.java
index 096206f2e0e..2434d246bc7 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VenafiTPP.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/VenafiTPP.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VenafiTPP defines connection configuration details for a Venafi TPP instance
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,41 +94,65 @@ public VenafiTPP(String caBundle, SecretKeySelector caBundleSecretRef, LocalObje
         this.url = url;
     }
 
+    /**
+     * Base64-encoded bundle of PEM CAs which will be used to validate the certificate chain presented by the TPP server. Only used if using HTTPS; ignored for HTTP. If undefined, the certificate bundle in the cert-manager controller container is used to validate the chain.
+     */
     @JsonProperty("caBundle")
     public String getCaBundle() {
         return caBundle;
     }
 
+    /**
+     * Base64-encoded bundle of PEM CAs which will be used to validate the certificate chain presented by the TPP server. Only used if using HTTPS; ignored for HTTP. If undefined, the certificate bundle in the cert-manager controller container is used to validate the chain.
+     */
     @JsonProperty("caBundle")
     public void setCaBundle(String caBundle) {
         this.caBundle = caBundle;
     }
 
+    /**
+     * VenafiTPP defines connection configuration details for a Venafi TPP instance
+     */
     @JsonProperty("caBundleSecretRef")
     public SecretKeySelector getCaBundleSecretRef() {
         return caBundleSecretRef;
     }
 
+    /**
+     * VenafiTPP defines connection configuration details for a Venafi TPP instance
+     */
     @JsonProperty("caBundleSecretRef")
     public void setCaBundleSecretRef(SecretKeySelector caBundleSecretRef) {
         this.caBundleSecretRef = caBundleSecretRef;
     }
 
+    /**
+     * VenafiTPP defines connection configuration details for a Venafi TPP instance
+     */
     @JsonProperty("credentialsRef")
     public LocalObjectReference getCredentialsRef() {
         return credentialsRef;
     }
 
+    /**
+     * VenafiTPP defines connection configuration details for a Venafi TPP instance
+     */
     @JsonProperty("credentialsRef")
     public void setCredentialsRef(LocalObjectReference credentialsRef) {
         this.credentialsRef = credentialsRef;
     }
 
+    /**
+     * URL is the base URL for the vedsdk endpoint of the Venafi TPP instance, for example: "https://tpp.example.com/vedsdk".
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * URL is the base URL for the vedsdk endpoint of the Venafi TPP instance, for example: "https://tpp.example.com/vedsdk".
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/X509Subject.java b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/X509Subject.java
index 5174f39562f..2f9da3bcdf3 100644
--- a/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/X509Subject.java
+++ b/extensions/certmanager/model/src/generated/java/io/fabric8/certmanager/api/model/v1/X509Subject.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * X509Subject Full X509 name specification
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -115,88 +118,136 @@ public X509Subject(List<String> countries, List<String> localities, List<String>
         this.streetAddresses = streetAddresses;
     }
 
+    /**
+     * Countries to be used on the Certificate.
+     */
     @JsonProperty("countries")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCountries() {
         return countries;
     }
 
+    /**
+     * Countries to be used on the Certificate.
+     */
     @JsonProperty("countries")
     public void setCountries(List<String> countries) {
         this.countries = countries;
     }
 
+    /**
+     * Cities to be used on the Certificate.
+     */
     @JsonProperty("localities")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getLocalities() {
         return localities;
     }
 
+    /**
+     * Cities to be used on the Certificate.
+     */
     @JsonProperty("localities")
     public void setLocalities(List<String> localities) {
         this.localities = localities;
     }
 
+    /**
+     * Organizational Units to be used on the Certificate.
+     */
     @JsonProperty("organizationalUnits")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getOrganizationalUnits() {
         return organizationalUnits;
     }
 
+    /**
+     * Organizational Units to be used on the Certificate.
+     */
     @JsonProperty("organizationalUnits")
     public void setOrganizationalUnits(List<String> organizationalUnits) {
         this.organizationalUnits = organizationalUnits;
     }
 
+    /**
+     * Organizations to be used on the Certificate.
+     */
     @JsonProperty("organizations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getOrganizations() {
         return organizations;
     }
 
+    /**
+     * Organizations to be used on the Certificate.
+     */
     @JsonProperty("organizations")
     public void setOrganizations(List<String> organizations) {
         this.organizations = organizations;
     }
 
+    /**
+     * Postal codes to be used on the Certificate.
+     */
     @JsonProperty("postalCodes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPostalCodes() {
         return postalCodes;
     }
 
+    /**
+     * Postal codes to be used on the Certificate.
+     */
     @JsonProperty("postalCodes")
     public void setPostalCodes(List<String> postalCodes) {
         this.postalCodes = postalCodes;
     }
 
+    /**
+     * State/Provinces to be used on the Certificate.
+     */
     @JsonProperty("provinces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getProvinces() {
         return provinces;
     }
 
+    /**
+     * State/Provinces to be used on the Certificate.
+     */
     @JsonProperty("provinces")
     public void setProvinces(List<String> provinces) {
         this.provinces = provinces;
     }
 
+    /**
+     * Serial number to be used on the Certificate.
+     */
     @JsonProperty("serialNumber")
     public String getSerialNumber() {
         return serialNumber;
     }
 
+    /**
+     * Serial number to be used on the Certificate.
+     */
     @JsonProperty("serialNumber")
     public void setSerialNumber(String serialNumber) {
         this.serialNumber = serialNumber;
     }
 
+    /**
+     * Street addresses to be used on the Certificate.
+     */
     @JsonProperty("streetAddresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getStreetAddresses() {
         return streetAddresses;
     }
 
+    /**
+     * Street addresses to be used on the Certificate.
+     */
     @JsonProperty("streetAddresses")
     public void setStreetAddresses(List<String> streetAddresses) {
         this.streetAddresses = streetAddresses;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AWSChaos.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AWSChaos.java
index 3691788cabe..c23bda408fe 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AWSChaos.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AWSChaos.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSChaos is the Schema for the awschaos API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class AWSChaos implements Editable<AWSChaosBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AWSChaos";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public AWSChaos(String apiVersion, String kind, ObjectMeta metadata, AWSChaosSpe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AWSChaos is the Schema for the awschaos API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AWSChaos is the Schema for the awschaos API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * AWSChaos is the Schema for the awschaos API
+     */
     @JsonProperty("spec")
     public AWSChaosSpec getSpec() {
         return spec;
     }
 
+    /**
+     * AWSChaos is the Schema for the awschaos API
+     */
     @JsonProperty("spec")
     public void setSpec(AWSChaosSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * AWSChaos is the Schema for the awschaos API
+     */
     @JsonProperty("status")
     public AWSChaosStatus getStatus() {
         return status;
     }
 
+    /**
+     * AWSChaos is the Schema for the awschaos API
+     */
     @JsonProperty("status")
     public void setStatus(AWSChaosStatus status) {
         this.status = status;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AWSChaosList.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AWSChaosList.java
index 62ee3e76528..7a036d57e62 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AWSChaosList.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AWSChaosList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSChaosList contains a list of AWSChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class AWSChaosList implements Editable<AWSChaosListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.chaosmesh.v1alpha1.AWSChaos>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.chaosmesh.v1alpha1.AWSChaos> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AWSChaosList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public AWSChaosList(String apiVersion, List<io.fabric8.chaosmesh.v1alpha1.AWSCha
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * AWSChaosList contains a list of AWSChaos
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.chaosmesh.v1alpha1.AWSChaos> getItems() {
         return items;
     }
 
+    /**
+     * AWSChaosList contains a list of AWSChaos
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.chaosmesh.v1alpha1.AWSChaos> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AWSChaosList contains a list of AWSChaos
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AWSChaosList contains a list of AWSChaos
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AWSChaosSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AWSChaosSpec.java
index 0d95f0df27e..fb3d1f7974a 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AWSChaosSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AWSChaosSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSChaosSpec is the content of the specification for an AWSChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -110,91 +113,145 @@ public AWSChaosSpec(String action, String awsRegion, String deviceName, String d
         this.volumeID = volumeID;
     }
 
+    /**
+     * Action defines the specific aws chaos action. Supported action: ec2-stop / ec2-restart / detach-volume Default action: ec2-stop
+     */
     @JsonProperty("action")
     public String getAction() {
         return action;
     }
 
+    /**
+     * Action defines the specific aws chaos action. Supported action: ec2-stop / ec2-restart / detach-volume Default action: ec2-stop
+     */
     @JsonProperty("action")
     public void setAction(String action) {
         this.action = action;
     }
 
+    /**
+     * AWSRegion defines the region of aws.
+     */
     @JsonProperty("awsRegion")
     public String getAwsRegion() {
         return awsRegion;
     }
 
+    /**
+     * AWSRegion defines the region of aws.
+     */
     @JsonProperty("awsRegion")
     public void setAwsRegion(String awsRegion) {
         this.awsRegion = awsRegion;
     }
 
+    /**
+     * DeviceName indicates the name of the device. Needed in detach-volume.
+     */
     @JsonProperty("deviceName")
     public String getDeviceName() {
         return deviceName;
     }
 
+    /**
+     * DeviceName indicates the name of the device. Needed in detach-volume.
+     */
     @JsonProperty("deviceName")
     public void setDeviceName(String deviceName) {
         this.deviceName = deviceName;
     }
 
+    /**
+     * Duration represents the duration of the chaos action.
+     */
     @JsonProperty("duration")
     public String getDuration() {
         return duration;
     }
 
+    /**
+     * Duration represents the duration of the chaos action.
+     */
     @JsonProperty("duration")
     public void setDuration(String duration) {
         this.duration = duration;
     }
 
+    /**
+     * Ec2Instance indicates the ID of the ec2 instance.
+     */
     @JsonProperty("ec2Instance")
     public String getEc2Instance() {
         return ec2Instance;
     }
 
+    /**
+     * Ec2Instance indicates the ID of the ec2 instance.
+     */
     @JsonProperty("ec2Instance")
     public void setEc2Instance(String ec2Instance) {
         this.ec2Instance = ec2Instance;
     }
 
+    /**
+     * Endpoint indicates the endpoint of the aws server. Just used it in test now.
+     */
     @JsonProperty("endpoint")
     public String getEndpoint() {
         return endpoint;
     }
 
+    /**
+     * Endpoint indicates the endpoint of the aws server. Just used it in test now.
+     */
     @JsonProperty("endpoint")
     public void setEndpoint(String endpoint) {
         this.endpoint = endpoint;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public String getRemoteCluster() {
         return remoteCluster;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public void setRemoteCluster(String remoteCluster) {
         this.remoteCluster = remoteCluster;
     }
 
+    /**
+     * SecretName defines the name of kubernetes secret.
+     */
     @JsonProperty("secretName")
     public String getSecretName() {
         return secretName;
     }
 
+    /**
+     * SecretName defines the name of kubernetes secret.
+     */
     @JsonProperty("secretName")
     public void setSecretName(String secretName) {
         this.secretName = secretName;
     }
 
+    /**
+     * EbsVolume indicates the ID of the EBS volume. Needed in detach-volume.
+     */
     @JsonProperty("volumeID")
     public String getVolumeID() {
         return volumeID;
     }
 
+    /**
+     * EbsVolume indicates the ID of the EBS volume. Needed in detach-volume.
+     */
     @JsonProperty("volumeID")
     public void setVolumeID(String volumeID) {
         this.volumeID = volumeID;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AWSChaosStatus.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AWSChaosStatus.java
index 93ed4e5ed47..18805e16c64 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AWSChaosStatus.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AWSChaosStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSChaosStatus represents the status of an AWSChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public AWSChaosStatus(List<ChaosCondition> conditions, ExperimentStatus experime
         this.experiment = experiment;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ChaosCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ChaosCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * AWSChaosStatus represents the status of an AWSChaos
+     */
     @JsonProperty("experiment")
     public ExperimentStatus getExperiment() {
         return experiment;
     }
 
+    /**
+     * AWSChaosStatus represents the status of an AWSChaos
+     */
     @JsonProperty("experiment")
     public void setExperiment(ExperimentStatus experiment) {
         this.experiment = experiment;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AWSSelector.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AWSSelector.java
index 8f3a36fa7a8..bbf6af41667 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AWSSelector.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AWSSelector.java
@@ -94,51 +94,81 @@ public AWSSelector(String awsRegion, String deviceName, String ec2Instance, Stri
         this.volumeID = volumeID;
     }
 
+    /**
+     * AWSRegion defines the region of aws.
+     */
     @JsonProperty("awsRegion")
     public String getAwsRegion() {
         return awsRegion;
     }
 
+    /**
+     * AWSRegion defines the region of aws.
+     */
     @JsonProperty("awsRegion")
     public void setAwsRegion(String awsRegion) {
         this.awsRegion = awsRegion;
     }
 
+    /**
+     * DeviceName indicates the name of the device. Needed in detach-volume.
+     */
     @JsonProperty("deviceName")
     public String getDeviceName() {
         return deviceName;
     }
 
+    /**
+     * DeviceName indicates the name of the device. Needed in detach-volume.
+     */
     @JsonProperty("deviceName")
     public void setDeviceName(String deviceName) {
         this.deviceName = deviceName;
     }
 
+    /**
+     * Ec2Instance indicates the ID of the ec2 instance.
+     */
     @JsonProperty("ec2Instance")
     public String getEc2Instance() {
         return ec2Instance;
     }
 
+    /**
+     * Ec2Instance indicates the ID of the ec2 instance.
+     */
     @JsonProperty("ec2Instance")
     public void setEc2Instance(String ec2Instance) {
         this.ec2Instance = ec2Instance;
     }
 
+    /**
+     * Endpoint indicates the endpoint of the aws server. Just used it in test now.
+     */
     @JsonProperty("endpoint")
     public String getEndpoint() {
         return endpoint;
     }
 
+    /**
+     * Endpoint indicates the endpoint of the aws server. Just used it in test now.
+     */
     @JsonProperty("endpoint")
     public void setEndpoint(String endpoint) {
         this.endpoint = endpoint;
     }
 
+    /**
+     * EbsVolume indicates the ID of the EBS volume. Needed in detach-volume.
+     */
     @JsonProperty("volumeID")
     public String getVolumeID() {
         return volumeID;
     }
 
+    /**
+     * EbsVolume indicates the ID of the EBS volume. Needed in detach-volume.
+     */
     @JsonProperty("volumeID")
     public void setVolumeID(String volumeID) {
         this.volumeID = volumeID;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AttrOverrideSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AttrOverrideSpec.java
index 010fe294e14..c09aabf5bb4 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AttrOverrideSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AttrOverrideSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AttrOverrideSpec represents an override of attribution
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -122,121 +125,193 @@ public AttrOverrideSpec(Timespec atime, Long blocks, Timespec ctime, Long gid, L
         this.uid = uid;
     }
 
+    /**
+     * AttrOverrideSpec represents an override of attribution
+     */
     @JsonProperty("atime")
     public Timespec getAtime() {
         return atime;
     }
 
+    /**
+     * AttrOverrideSpec represents an override of attribution
+     */
     @JsonProperty("atime")
     public void setAtime(Timespec atime) {
         this.atime = atime;
     }
 
+    /**
+     * AttrOverrideSpec represents an override of attribution
+     */
     @JsonProperty("blocks")
     public Long getBlocks() {
         return blocks;
     }
 
+    /**
+     * AttrOverrideSpec represents an override of attribution
+     */
     @JsonProperty("blocks")
     public void setBlocks(Long blocks) {
         this.blocks = blocks;
     }
 
+    /**
+     * AttrOverrideSpec represents an override of attribution
+     */
     @JsonProperty("ctime")
     public Timespec getCtime() {
         return ctime;
     }
 
+    /**
+     * AttrOverrideSpec represents an override of attribution
+     */
     @JsonProperty("ctime")
     public void setCtime(Timespec ctime) {
         this.ctime = ctime;
     }
 
+    /**
+     * AttrOverrideSpec represents an override of attribution
+     */
     @JsonProperty("gid")
     public Long getGid() {
         return gid;
     }
 
+    /**
+     * AttrOverrideSpec represents an override of attribution
+     */
     @JsonProperty("gid")
     public void setGid(Long gid) {
         this.gid = gid;
     }
 
+    /**
+     * AttrOverrideSpec represents an override of attribution
+     */
     @JsonProperty("ino")
     public Long getIno() {
         return ino;
     }
 
+    /**
+     * AttrOverrideSpec represents an override of attribution
+     */
     @JsonProperty("ino")
     public void setIno(Long ino) {
         this.ino = ino;
     }
 
+    /**
+     * AttrOverrideSpec represents an override of attribution
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * AttrOverrideSpec represents an override of attribution
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AttrOverrideSpec represents an override of attribution
+     */
     @JsonProperty("mtime")
     public Timespec getMtime() {
         return mtime;
     }
 
+    /**
+     * AttrOverrideSpec represents an override of attribution
+     */
     @JsonProperty("mtime")
     public void setMtime(Timespec mtime) {
         this.mtime = mtime;
     }
 
+    /**
+     * AttrOverrideSpec represents an override of attribution
+     */
     @JsonProperty("nlink")
     public Long getNlink() {
         return nlink;
     }
 
+    /**
+     * AttrOverrideSpec represents an override of attribution
+     */
     @JsonProperty("nlink")
     public void setNlink(Long nlink) {
         this.nlink = nlink;
     }
 
+    /**
+     * AttrOverrideSpec represents an override of attribution
+     */
     @JsonProperty("perm")
     public Integer getPerm() {
         return perm;
     }
 
+    /**
+     * AttrOverrideSpec represents an override of attribution
+     */
     @JsonProperty("perm")
     public void setPerm(Integer perm) {
         this.perm = perm;
     }
 
+    /**
+     * AttrOverrideSpec represents an override of attribution
+     */
     @JsonProperty("rdev")
     public Long getRdev() {
         return rdev;
     }
 
+    /**
+     * AttrOverrideSpec represents an override of attribution
+     */
     @JsonProperty("rdev")
     public void setRdev(Long rdev) {
         this.rdev = rdev;
     }
 
+    /**
+     * AttrOverrideSpec represents an override of attribution
+     */
     @JsonProperty("size")
     public Long getSize() {
         return size;
     }
 
+    /**
+     * AttrOverrideSpec represents an override of attribution
+     */
     @JsonProperty("size")
     public void setSize(Long size) {
         this.size = size;
     }
 
+    /**
+     * AttrOverrideSpec represents an override of attribution
+     */
     @JsonProperty("uid")
     public Long getUid() {
         return uid;
     }
 
+    /**
+     * AttrOverrideSpec represents an override of attribution
+     */
     @JsonProperty("uid")
     public void setUid(Long uid) {
         this.uid = uid;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AzureChaos.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AzureChaos.java
index 64108d49511..ca73d16021f 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AzureChaos.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AzureChaos.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzureChaos is the Schema for the azurechaos API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class AzureChaos implements Editable<AzureChaosBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AzureChaos";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public AzureChaos(String apiVersion, String kind, ObjectMeta metadata, AzureChao
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AzureChaos is the Schema for the azurechaos API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AzureChaos is the Schema for the azurechaos API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * AzureChaos is the Schema for the azurechaos API
+     */
     @JsonProperty("spec")
     public AzureChaosSpec getSpec() {
         return spec;
     }
 
+    /**
+     * AzureChaos is the Schema for the azurechaos API
+     */
     @JsonProperty("spec")
     public void setSpec(AzureChaosSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * AzureChaos is the Schema for the azurechaos API
+     */
     @JsonProperty("status")
     public AzureChaosStatus getStatus() {
         return status;
     }
 
+    /**
+     * AzureChaos is the Schema for the azurechaos API
+     */
     @JsonProperty("status")
     public void setStatus(AzureChaosStatus status) {
         this.status = status;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AzureChaosList.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AzureChaosList.java
index 780d3d7f599..252709b9e7c 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AzureChaosList.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AzureChaosList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzureChaosList contains a list of AzureChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class AzureChaosList implements Editable<AzureChaosListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.chaosmesh.v1alpha1.AzureChaos>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.chaosmesh.v1alpha1.AzureChaos> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AzureChaosList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public AzureChaosList(String apiVersion, List<io.fabric8.chaosmesh.v1alpha1.Azur
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * AzureChaosList contains a list of AzureChaos
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.chaosmesh.v1alpha1.AzureChaos> getItems() {
         return items;
     }
 
+    /**
+     * AzureChaosList contains a list of AzureChaos
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.chaosmesh.v1alpha1.AzureChaos> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AzureChaosList contains a list of AzureChaos
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AzureChaosList contains a list of AzureChaos
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AzureChaosSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AzureChaosSpec.java
index 749d422cd07..122a383eb49 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AzureChaosSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AzureChaosSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzureChaosSpec is the content of the specification for an AzureChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -110,91 +113,145 @@ public AzureChaosSpec(String action, String diskName, String duration, Integer l
         this.vmName = vmName;
     }
 
+    /**
+     * Action defines the specific azure chaos action. Supported action: vm-stop / vm-restart / disk-detach Default action: vm-stop
+     */
     @JsonProperty("action")
     public String getAction() {
         return action;
     }
 
+    /**
+     * Action defines the specific azure chaos action. Supported action: vm-stop / vm-restart / disk-detach Default action: vm-stop
+     */
     @JsonProperty("action")
     public void setAction(String action) {
         this.action = action;
     }
 
+    /**
+     * DiskName indicates the name of the disk. Needed in disk-detach.
+     */
     @JsonProperty("diskName")
     public String getDiskName() {
         return diskName;
     }
 
+    /**
+     * DiskName indicates the name of the disk. Needed in disk-detach.
+     */
     @JsonProperty("diskName")
     public void setDiskName(String diskName) {
         this.diskName = diskName;
     }
 
+    /**
+     * Duration represents the duration of the chaos action.
+     */
     @JsonProperty("duration")
     public String getDuration() {
         return duration;
     }
 
+    /**
+     * Duration represents the duration of the chaos action.
+     */
     @JsonProperty("duration")
     public void setDuration(String duration) {
         this.duration = duration;
     }
 
+    /**
+     * LUN indicates the Logical Unit Number of the data disk. Needed in disk-detach.
+     */
     @JsonProperty("lun")
     public Integer getLun() {
         return lun;
     }
 
+    /**
+     * LUN indicates the Logical Unit Number of the data disk. Needed in disk-detach.
+     */
     @JsonProperty("lun")
     public void setLun(Integer lun) {
         this.lun = lun;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public String getRemoteCluster() {
         return remoteCluster;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public void setRemoteCluster(String remoteCluster) {
         this.remoteCluster = remoteCluster;
     }
 
+    /**
+     * ResourceGroupName defines the name of ResourceGroup
+     */
     @JsonProperty("resourceGroupName")
     public String getResourceGroupName() {
         return resourceGroupName;
     }
 
+    /**
+     * ResourceGroupName defines the name of ResourceGroup
+     */
     @JsonProperty("resourceGroupName")
     public void setResourceGroupName(String resourceGroupName) {
         this.resourceGroupName = resourceGroupName;
     }
 
+    /**
+     * SecretName defines the name of kubernetes secret. It is used for Azure credentials.
+     */
     @JsonProperty("secretName")
     public String getSecretName() {
         return secretName;
     }
 
+    /**
+     * SecretName defines the name of kubernetes secret. It is used for Azure credentials.
+     */
     @JsonProperty("secretName")
     public void setSecretName(String secretName) {
         this.secretName = secretName;
     }
 
+    /**
+     * SubscriptionID defines the id of Azure subscription.
+     */
     @JsonProperty("subscriptionID")
     public String getSubscriptionID() {
         return subscriptionID;
     }
 
+    /**
+     * SubscriptionID defines the id of Azure subscription.
+     */
     @JsonProperty("subscriptionID")
     public void setSubscriptionID(String subscriptionID) {
         this.subscriptionID = subscriptionID;
     }
 
+    /**
+     * VMName defines the name of Virtual Machine
+     */
     @JsonProperty("vmName")
     public String getVmName() {
         return vmName;
     }
 
+    /**
+     * VMName defines the name of Virtual Machine
+     */
     @JsonProperty("vmName")
     public void setVmName(String vmName) {
         this.vmName = vmName;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AzureChaosStatus.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AzureChaosStatus.java
index 0372dc764d2..2093658a48a 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AzureChaosStatus.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AzureChaosStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzureChaosStatus represents the status of an AzureChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public AzureChaosStatus(List<ChaosCondition> conditions, ExperimentStatus experi
         this.experiment = experiment;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ChaosCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ChaosCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * AzureChaosStatus represents the status of an AzureChaos
+     */
     @JsonProperty("experiment")
     public ExperimentStatus getExperiment() {
         return experiment;
     }
 
+    /**
+     * AzureChaosStatus represents the status of an AzureChaos
+     */
     @JsonProperty("experiment")
     public void setExperiment(ExperimentStatus experiment) {
         this.experiment = experiment;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AzureSelector.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AzureSelector.java
index 5aaf8feb3d0..3599904be2d 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AzureSelector.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/AzureSelector.java
@@ -102,71 +102,113 @@ public AzureSelector(String diskName, Integer lun, String remoteCluster, String
         this.vmName = vmName;
     }
 
+    /**
+     * DiskName indicates the name of the disk. Needed in disk-detach.
+     */
     @JsonProperty("diskName")
     public String getDiskName() {
         return diskName;
     }
 
+    /**
+     * DiskName indicates the name of the disk. Needed in disk-detach.
+     */
     @JsonProperty("diskName")
     public void setDiskName(String diskName) {
         this.diskName = diskName;
     }
 
+    /**
+     * LUN indicates the Logical Unit Number of the data disk. Needed in disk-detach.
+     */
     @JsonProperty("lun")
     public Integer getLun() {
         return lun;
     }
 
+    /**
+     * LUN indicates the Logical Unit Number of the data disk. Needed in disk-detach.
+     */
     @JsonProperty("lun")
     public void setLun(Integer lun) {
         this.lun = lun;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public String getRemoteCluster() {
         return remoteCluster;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public void setRemoteCluster(String remoteCluster) {
         this.remoteCluster = remoteCluster;
     }
 
+    /**
+     * ResourceGroupName defines the name of ResourceGroup
+     */
     @JsonProperty("resourceGroupName")
     public String getResourceGroupName() {
         return resourceGroupName;
     }
 
+    /**
+     * ResourceGroupName defines the name of ResourceGroup
+     */
     @JsonProperty("resourceGroupName")
     public void setResourceGroupName(String resourceGroupName) {
         this.resourceGroupName = resourceGroupName;
     }
 
+    /**
+     * SecretName defines the name of kubernetes secret. It is used for Azure credentials.
+     */
     @JsonProperty("secretName")
     public String getSecretName() {
         return secretName;
     }
 
+    /**
+     * SecretName defines the name of kubernetes secret. It is used for Azure credentials.
+     */
     @JsonProperty("secretName")
     public void setSecretName(String secretName) {
         this.secretName = secretName;
     }
 
+    /**
+     * SubscriptionID defines the id of Azure subscription.
+     */
     @JsonProperty("subscriptionID")
     public String getSubscriptionID() {
         return subscriptionID;
     }
 
+    /**
+     * SubscriptionID defines the id of Azure subscription.
+     */
     @JsonProperty("subscriptionID")
     public void setSubscriptionID(String subscriptionID) {
         this.subscriptionID = subscriptionID;
     }
 
+    /**
+     * VMName defines the name of Virtual Machine
+     */
     @JsonProperty("vmName")
     public String getVmName() {
         return vmName;
     }
 
+    /**
+     * VMName defines the name of Virtual Machine
+     */
     @JsonProperty("vmName")
     public void setVmName(String vmName) {
         this.vmName = vmName;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/BandwidthSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/BandwidthSpec.java
index 025f3de4190..5061a5631a3 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/BandwidthSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/BandwidthSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BandwidthSpec defines detail of bandwidth limit.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public BandwidthSpec(Long buffer, Long limit, Long minburst, Long peakrate, Stri
         this.rate = rate;
     }
 
+    /**
+     * Buffer is the maximum amount of bytes that tokens can be available for instantaneously.
+     */
     @JsonProperty("buffer")
     public Long getBuffer() {
         return buffer;
     }
 
+    /**
+     * Buffer is the maximum amount of bytes that tokens can be available for instantaneously.
+     */
     @JsonProperty("buffer")
     public void setBuffer(Long buffer) {
         this.buffer = buffer;
     }
 
+    /**
+     * Limit is the number of bytes that can be queued waiting for tokens to become available.
+     */
     @JsonProperty("limit")
     public Long getLimit() {
         return limit;
     }
 
+    /**
+     * Limit is the number of bytes that can be queued waiting for tokens to become available.
+     */
     @JsonProperty("limit")
     public void setLimit(Long limit) {
         this.limit = limit;
     }
 
+    /**
+     * Minburst specifies the size of the peakrate bucket. For perfect accuracy, should be set to the MTU of the interface.  If a peakrate is needed, but some burstiness is acceptable, this size can be raised. A 3000 byte minburst allows around 3mbit/s of peakrate, given 1000 byte packets.
+     */
     @JsonProperty("minburst")
     public Long getMinburst() {
         return minburst;
     }
 
+    /**
+     * Minburst specifies the size of the peakrate bucket. For perfect accuracy, should be set to the MTU of the interface.  If a peakrate is needed, but some burstiness is acceptable, this size can be raised. A 3000 byte minburst allows around 3mbit/s of peakrate, given 1000 byte packets.
+     */
     @JsonProperty("minburst")
     public void setMinburst(Long minburst) {
         this.minburst = minburst;
     }
 
+    /**
+     * Peakrate is the maximum depletion rate of the bucket. The peakrate does not need to be set, it is only necessary if perfect millisecond timescale shaping is required.
+     */
     @JsonProperty("peakrate")
     public Long getPeakrate() {
         return peakrate;
     }
 
+    /**
+     * Peakrate is the maximum depletion rate of the bucket. The peakrate does not need to be set, it is only necessary if perfect millisecond timescale shaping is required.
+     */
     @JsonProperty("peakrate")
     public void setPeakrate(Long peakrate) {
         this.peakrate = peakrate;
     }
 
+    /**
+     * Rate is the speed knob. Allows bit, kbit, mbit, gbit, tbit, bps, kbps, mbps, gbps, tbps unit. bps means bytes per second.
+     */
     @JsonProperty("rate")
     public String getRate() {
         return rate;
     }
 
+    /**
+     * Rate is the speed knob. Allows bit, kbit, mbit, gbit, tbit, bps, kbps, mbps, gbps, tbps unit. bps means bytes per second.
+     */
     @JsonProperty("rate")
     public void setRate(String rate) {
         this.rate = rate;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/BlockChaos.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/BlockChaos.java
index 1ecb1d36764..d7581e5f04d 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/BlockChaos.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/BlockChaos.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BlockChaos is the Schema for the blockchaos API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class BlockChaos implements Editable<BlockChaosBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "BlockChaos";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public BlockChaos(String apiVersion, String kind, ObjectMeta metadata, BlockChao
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * BlockChaos is the Schema for the blockchaos API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * BlockChaos is the Schema for the blockchaos API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * BlockChaos is the Schema for the blockchaos API
+     */
     @JsonProperty("spec")
     public BlockChaosSpec getSpec() {
         return spec;
     }
 
+    /**
+     * BlockChaos is the Schema for the blockchaos API
+     */
     @JsonProperty("spec")
     public void setSpec(BlockChaosSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * BlockChaos is the Schema for the blockchaos API
+     */
     @JsonProperty("status")
     public BlockChaosStatus getStatus() {
         return status;
     }
 
+    /**
+     * BlockChaos is the Schema for the blockchaos API
+     */
     @JsonProperty("status")
     public void setStatus(BlockChaosStatus status) {
         this.status = status;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/BlockChaosList.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/BlockChaosList.java
index 80b514bd538..ccafc32b569 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/BlockChaosList.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/BlockChaosList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BlockChaosList contains a list of BlockChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class BlockChaosList implements Editable<BlockChaosListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.chaosmesh.v1alpha1.BlockChaos>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.chaosmesh.v1alpha1.BlockChaos> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "BlockChaosList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public BlockChaosList(String apiVersion, List<io.fabric8.chaosmesh.v1alpha1.Bloc
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * BlockChaosList contains a list of BlockChaos
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.chaosmesh.v1alpha1.BlockChaos> getItems() {
         return items;
     }
 
+    /**
+     * BlockChaosList contains a list of BlockChaos
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.chaosmesh.v1alpha1.BlockChaos> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * BlockChaosList contains a list of BlockChaos
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * BlockChaosList contains a list of BlockChaos
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/BlockChaosSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/BlockChaosSpec.java
index b94db4e77c6..dd47ae0d89e 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/BlockChaosSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/BlockChaosSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BlockChaosSpec is the content of the specification for a BlockChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -113,92 +116,146 @@ public BlockChaosSpec(String action, List<String> containerNames, BlockDelaySpec
         this.volumeName = volumeName;
     }
 
+    /**
+     * Action defines the specific block chaos action. Supported action: delay
+     */
     @JsonProperty("action")
     public String getAction() {
         return action;
     }
 
+    /**
+     * Action defines the specific block chaos action. Supported action: delay
+     */
     @JsonProperty("action")
     public void setAction(String action) {
         this.action = action;
     }
 
+    /**
+     * ContainerNames indicates list of the name of affected container. If not set, the first container will be injected
+     */
     @JsonProperty("containerNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getContainerNames() {
         return containerNames;
     }
 
+    /**
+     * ContainerNames indicates list of the name of affected container. If not set, the first container will be injected
+     */
     @JsonProperty("containerNames")
     public void setContainerNames(List<String> containerNames) {
         this.containerNames = containerNames;
     }
 
+    /**
+     * BlockChaosSpec is the content of the specification for a BlockChaos
+     */
     @JsonProperty("delay")
     public BlockDelaySpec getDelay() {
         return delay;
     }
 
+    /**
+     * BlockChaosSpec is the content of the specification for a BlockChaos
+     */
     @JsonProperty("delay")
     public void setDelay(BlockDelaySpec delay) {
         this.delay = delay;
     }
 
+    /**
+     * Duration represents the duration of the chaos action.
+     */
     @JsonProperty("duration")
     public String getDuration() {
         return duration;
     }
 
+    /**
+     * Duration represents the duration of the chaos action.
+     */
     @JsonProperty("duration")
     public void setDuration(String duration) {
         this.duration = duration;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public String getRemoteCluster() {
         return remoteCluster;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public void setRemoteCluster(String remoteCluster) {
         this.remoteCluster = remoteCluster;
     }
 
+    /**
+     * BlockChaosSpec is the content of the specification for a BlockChaos
+     */
     @JsonProperty("selector")
     public PodSelectorSpec getSelector() {
         return selector;
     }
 
+    /**
+     * BlockChaosSpec is the content of the specification for a BlockChaos
+     */
     @JsonProperty("selector")
     public void setSelector(PodSelectorSpec selector) {
         this.selector = selector;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of pods to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of pods the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of pods to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of pods the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
     }
 
+    /**
+     * BlockChaosSpec is the content of the specification for a BlockChaos
+     */
     @JsonProperty("volumeName")
     public String getVolumeName() {
         return volumeName;
     }
 
+    /**
+     * BlockChaosSpec is the content of the specification for a BlockChaos
+     */
     @JsonProperty("volumeName")
     public void setVolumeName(String volumeName) {
         this.volumeName = volumeName;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/BlockChaosStatus.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/BlockChaosStatus.java
index 26e3285f65f..a7ea5288e6f 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/BlockChaosStatus.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/BlockChaosStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BlockChaosStatus represents the status of a BlockChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public BlockChaosStatus(List<ChaosCondition> conditions, ExperimentStatus experi
         this.ids = ids;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ChaosCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ChaosCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * BlockChaosStatus represents the status of a BlockChaos
+     */
     @JsonProperty("experiment")
     public ExperimentStatus getExperiment() {
         return experiment;
     }
 
+    /**
+     * BlockChaosStatus represents the status of a BlockChaos
+     */
     @JsonProperty("experiment")
     public void setExperiment(ExperimentStatus experiment) {
         this.experiment = experiment;
     }
 
+    /**
+     * InjectionIds always specifies the number of injected chaos action
+     */
     @JsonProperty("ids")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Integer> getIds() {
         return ids;
     }
 
+    /**
+     * InjectionIds always specifies the number of injected chaos action
+     */
     @JsonProperty("ids")
     public void setIds(Map<String, Integer> ids) {
         this.ids = ids;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/BlockDelaySpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/BlockDelaySpec.java
index 5128e42d3b0..6bfd2f5b157 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/BlockDelaySpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/BlockDelaySpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BlockDelaySpec describes the block delay specification
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public BlockDelaySpec(String correlation, String jitter, String latency) {
         this.latency = latency;
     }
 
+    /**
+     * BlockDelaySpec describes the block delay specification
+     */
     @JsonProperty("correlation")
     public String getCorrelation() {
         return correlation;
     }
 
+    /**
+     * BlockDelaySpec describes the block delay specification
+     */
     @JsonProperty("correlation")
     public void setCorrelation(String correlation) {
         this.correlation = correlation;
     }
 
+    /**
+     * BlockDelaySpec describes the block delay specification
+     */
     @JsonProperty("jitter")
     public String getJitter() {
         return jitter;
     }
 
+    /**
+     * BlockDelaySpec describes the block delay specification
+     */
     @JsonProperty("jitter")
     public void setJitter(String jitter) {
         this.jitter = jitter;
     }
 
+    /**
+     * Latency defines the latency of every io request.
+     */
     @JsonProperty("latency")
     public String getLatency() {
         return latency;
     }
 
+    /**
+     * Latency defines the latency of every io request.
+     */
     @JsonProperty("latency")
     public void setLatency(String latency) {
         this.latency = latency;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/CPUStressor.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/CPUStressor.java
index 20fb6603ea8..04973bb6fce 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/CPUStressor.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/CPUStressor.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CPUStressor defines how to stress CPU out
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public CPUStressor(Integer load, List<String> options, Integer workers) {
         this.workers = workers;
     }
 
+    /**
+     * Load specifies P percent loading per CPU worker. 0 is effectively a sleep (no load) and 100 is full loading.
+     */
     @JsonProperty("load")
     public Integer getLoad() {
         return load;
     }
 
+    /**
+     * Load specifies P percent loading per CPU worker. 0 is effectively a sleep (no load) and 100 is full loading.
+     */
     @JsonProperty("load")
     public void setLoad(Integer load) {
         this.load = load;
     }
 
+    /**
+     * extend stress-ng options
+     */
     @JsonProperty("options")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getOptions() {
         return options;
     }
 
+    /**
+     * extend stress-ng options
+     */
     @JsonProperty("options")
     public void setOptions(List<String> options) {
         this.options = options;
     }
 
+    /**
+     * Workers specifies N workers to apply the stressor. Maximum 8192 workers can run by stress-ng
+     */
     @JsonProperty("workers")
     public Integer getWorkers() {
         return workers;
     }
 
+    /**
+     * Workers specifies N workers to apply the stressor. Maximum 8192 workers can run by stress-ng
+     */
     @JsonProperty("workers")
     public void setWorkers(Integer workers) {
         this.workers = workers;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ChaosKind.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ChaosKind.java
index 7b60c71a1f6..3c5e6558cbe 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ChaosKind.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ChaosKind.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ChaosKind includes one kind of chaos and its list type
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ChaosOnlyScheduleSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ChaosOnlyScheduleSpec.java
index 535ececdc6b..eeb31ef6c31 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ChaosOnlyScheduleSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ChaosOnlyScheduleSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -150,191 +153,305 @@ public ChaosOnlyScheduleSpec(AWSChaosSpec awsChaos, AzureChaosSpec azureChaos, B
         this.type = type;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("awsChaos")
     public AWSChaosSpec getAwsChaos() {
         return awsChaos;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("awsChaos")
     public void setAwsChaos(AWSChaosSpec awsChaos) {
         this.awsChaos = awsChaos;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("azureChaos")
     public AzureChaosSpec getAzureChaos() {
         return azureChaos;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("azureChaos")
     public void setAzureChaos(AzureChaosSpec azureChaos) {
         this.azureChaos = azureChaos;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("blockChaos")
     public BlockChaosSpec getBlockChaos() {
         return blockChaos;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("blockChaos")
     public void setBlockChaos(BlockChaosSpec blockChaos) {
         this.blockChaos = blockChaos;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("concurrencyPolicy")
     public String getConcurrencyPolicy() {
         return concurrencyPolicy;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("concurrencyPolicy")
     public void setConcurrencyPolicy(String concurrencyPolicy) {
         this.concurrencyPolicy = concurrencyPolicy;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("dnsChaos")
     public DNSChaosSpec getDnsChaos() {
         return dnsChaos;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("dnsChaos")
     public void setDnsChaos(DNSChaosSpec dnsChaos) {
         this.dnsChaos = dnsChaos;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("gcpChaos")
     public GCPChaosSpec getGcpChaos() {
         return gcpChaos;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("gcpChaos")
     public void setGcpChaos(GCPChaosSpec gcpChaos) {
         this.gcpChaos = gcpChaos;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("historyLimit")
     public Integer getHistoryLimit() {
         return historyLimit;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("historyLimit")
     public void setHistoryLimit(Integer historyLimit) {
         this.historyLimit = historyLimit;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("httpChaos")
     public HTTPChaosSpec getHttpChaos() {
         return httpChaos;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("httpChaos")
     public void setHttpChaos(HTTPChaosSpec httpChaos) {
         this.httpChaos = httpChaos;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("ioChaos")
     public IOChaosSpec getIoChaos() {
         return ioChaos;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("ioChaos")
     public void setIoChaos(IOChaosSpec ioChaos) {
         this.ioChaos = ioChaos;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("jvmChaos")
     public JVMChaosSpec getJvmChaos() {
         return jvmChaos;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("jvmChaos")
     public void setJvmChaos(JVMChaosSpec jvmChaos) {
         this.jvmChaos = jvmChaos;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("kernelChaos")
     public KernelChaosSpec getKernelChaos() {
         return kernelChaos;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("kernelChaos")
     public void setKernelChaos(KernelChaosSpec kernelChaos) {
         this.kernelChaos = kernelChaos;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("networkChaos")
     public NetworkChaosSpec getNetworkChaos() {
         return networkChaos;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("networkChaos")
     public void setNetworkChaos(NetworkChaosSpec networkChaos) {
         this.networkChaos = networkChaos;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("physicalmachineChaos")
     public PhysicalMachineChaosSpec getPhysicalmachineChaos() {
         return physicalmachineChaos;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("physicalmachineChaos")
     public void setPhysicalmachineChaos(PhysicalMachineChaosSpec physicalmachineChaos) {
         this.physicalmachineChaos = physicalmachineChaos;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("podChaos")
     public PodChaosSpec getPodChaos() {
         return podChaos;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("podChaos")
     public void setPodChaos(PodChaosSpec podChaos) {
         this.podChaos = podChaos;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("schedule")
     public String getSchedule() {
         return schedule;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("schedule")
     public void setSchedule(String schedule) {
         this.schedule = schedule;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("startingDeadlineSeconds")
     public Long getStartingDeadlineSeconds() {
         return startingDeadlineSeconds;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("startingDeadlineSeconds")
     public void setStartingDeadlineSeconds(Long startingDeadlineSeconds) {
         this.startingDeadlineSeconds = startingDeadlineSeconds;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("stressChaos")
     public StressChaosSpec getStressChaos() {
         return stressChaos;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("stressChaos")
     public void setStressChaos(StressChaosSpec stressChaos) {
         this.stressChaos = stressChaos;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("timeChaos")
     public TimeChaosSpec getTimeChaos() {
         return timeChaos;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("timeChaos")
     public void setTimeChaos(TimeChaosSpec timeChaos) {
         this.timeChaos = timeChaos;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * ChaosOnlyScheduleSpec is very similar with ScheduleSpec, but it could not schedule Workflow because we could not resolve nested CRD now
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ChaosStatus.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ChaosStatus.java
index 2b633ee5f8c..04f60ccc26c 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ChaosStatus.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ChaosStatus.java
@@ -85,12 +85,18 @@ public ChaosStatus(List<ChaosCondition> conditions, ExperimentStatus experiment)
         this.experiment = experiment;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ChaosCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ChaosCondition> conditions) {
         this.conditions = conditions;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/CidrAndPort.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/CidrAndPort.java
index 5fc2b84a988..c293bd6b685 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/CidrAndPort.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/CidrAndPort.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CidrAndPort represents CIDR and port pair
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public CidrAndPort(String cidr, Integer port) {
         this.port = port;
     }
 
+    /**
+     * CidrAndPort represents CIDR and port pair
+     */
     @JsonProperty("cidr")
     public String getCidr() {
         return cidr;
     }
 
+    /**
+     * CidrAndPort represents CIDR and port pair
+     */
     @JsonProperty("cidr")
     public void setCidr(String cidr) {
         this.cidr = cidr;
     }
 
+    /**
+     * CidrAndPort represents CIDR and port pair
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * CidrAndPort represents CIDR and port pair
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ClockSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ClockSpec.java
index e747c432d16..d03c2054a44 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ClockSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ClockSpec.java
@@ -86,31 +86,49 @@ public ClockSpec(String clockIdsSlice, Integer pid, String timeOffset) {
         this.timeOffset = timeOffset;
     }
 
+    /**
+     * the identifier of the particular clock on which to act. More clock description in linux kernel can be found in man page of clock_getres, clock_gettime, clock_settime. Muti clock ids should be split with ","
+     */
     @JsonProperty("clock-ids-slice")
     public String getClockIdsSlice() {
         return clockIdsSlice;
     }
 
+    /**
+     * the identifier of the particular clock on which to act. More clock description in linux kernel can be found in man page of clock_getres, clock_gettime, clock_settime. Muti clock ids should be split with ","
+     */
     @JsonProperty("clock-ids-slice")
     public void setClockIdsSlice(String clockIdsSlice) {
         this.clockIdsSlice = clockIdsSlice;
     }
 
+    /**
+     * the pid of target program.
+     */
     @JsonProperty("pid")
     public Integer getPid() {
         return pid;
     }
 
+    /**
+     * the pid of target program.
+     */
     @JsonProperty("pid")
     public void setPid(Integer pid) {
         this.pid = pid;
     }
 
+    /**
+     * specifies the length of time offset.
+     */
     @JsonProperty("time-offset")
     public String getTimeOffset() {
         return timeOffset;
     }
 
+    /**
+     * specifies the length of time offset.
+     */
     @JsonProperty("time-offset")
     public void setTimeOffset(String timeOffset) {
         this.timeOffset = timeOffset;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ConditionalBranch.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ConditionalBranch.java
index 79de1676814..50ed0f7b971 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ConditionalBranch.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ConditionalBranch.java
@@ -82,21 +82,33 @@ public ConditionalBranch(String expression, String target) {
         this.target = target;
     }
 
+    /**
+     * Expression is the expression for this conditional branch, expected type of result is boolean. If expression is empty, this branch will always be selected/the template will be spawned.
+     */
     @JsonProperty("expression")
     public String getExpression() {
         return expression;
     }
 
+    /**
+     * Expression is the expression for this conditional branch, expected type of result is boolean. If expression is empty, this branch will always be selected/the template will be spawned.
+     */
     @JsonProperty("expression")
     public void setExpression(String expression) {
         this.expression = expression;
     }
 
+    /**
+     * Target is the name of other template, if expression is evaluated as true, this template will be spawned.
+     */
     @JsonProperty("target")
     public String getTarget() {
         return target;
     }
 
+    /**
+     * Target is the name of other template, if expression is evaluated as true, this template will be spawned.
+     */
     @JsonProperty("target")
     public void setTarget(String target) {
         this.target = target;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ContainerNodeVolumePathSelector.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ContainerNodeVolumePathSelector.java
index fad80affc04..fbe43dc30f9 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ContainerNodeVolumePathSelector.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ContainerNodeVolumePathSelector.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerNodeVolumePathSelector is the selector to select a node and a PV on it
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -97,52 +100,82 @@ public ContainerNodeVolumePathSelector(List<String> containerNames, String mode,
         this.volumeName = volumeName;
     }
 
+    /**
+     * ContainerNames indicates list of the name of affected container. If not set, the first container will be injected
+     */
     @JsonProperty("containerNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getContainerNames() {
         return containerNames;
     }
 
+    /**
+     * ContainerNames indicates list of the name of affected container. If not set, the first container will be injected
+     */
     @JsonProperty("containerNames")
     public void setContainerNames(List<String> containerNames) {
         this.containerNames = containerNames;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
     }
 
+    /**
+     * ContainerNodeVolumePathSelector is the selector to select a node and a PV on it
+     */
     @JsonProperty("selector")
     public PodSelectorSpec getSelector() {
         return selector;
     }
 
+    /**
+     * ContainerNodeVolumePathSelector is the selector to select a node and a PV on it
+     */
     @JsonProperty("selector")
     public void setSelector(PodSelectorSpec selector) {
         this.selector = selector;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of pods to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of pods the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of pods to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of pods the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
     }
 
+    /**
+     * ContainerNodeVolumePathSelector is the selector to select a node and a PV on it
+     */
     @JsonProperty("volumeName")
     public String getVolumeName() {
         return volumeName;
     }
 
+    /**
+     * ContainerNodeVolumePathSelector is the selector to select a node and a PV on it
+     */
     @JsonProperty("volumeName")
     public void setVolumeName(String volumeName) {
         this.volumeName = volumeName;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ContainerSelector.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ContainerSelector.java
index 528749f2db9..391b29d5d00 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ContainerSelector.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ContainerSelector.java
@@ -93,22 +93,34 @@ public ContainerSelector(List<String> containerNames, String mode, PodSelectorSp
         this.value = value;
     }
 
+    /**
+     * ContainerNames indicates list of the name of affected container. If not set, the first container will be injected
+     */
     @JsonProperty("containerNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getContainerNames() {
         return containerNames;
     }
 
+    /**
+     * ContainerNames indicates list of the name of affected container. If not set, the first container will be injected
+     */
     @JsonProperty("containerNames")
     public void setContainerNames(List<String> containerNames) {
         this.containerNames = containerNames;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
@@ -124,11 +136,17 @@ public void setSelector(PodSelectorSpec selector) {
         this.selector = selector;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of pods to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of pods the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of pods to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of pods the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/CorruptSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/CorruptSpec.java
index 85cc37c9a4b..50329ffcf44 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/CorruptSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/CorruptSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CorruptSpec defines detail of a corrupt action
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public CorruptSpec(String correlation, String corrupt) {
         this.corrupt = corrupt;
     }
 
+    /**
+     * CorruptSpec defines detail of a corrupt action
+     */
     @JsonProperty("correlation")
     public String getCorrelation() {
         return correlation;
     }
 
+    /**
+     * CorruptSpec defines detail of a corrupt action
+     */
     @JsonProperty("correlation")
     public void setCorrelation(String correlation) {
         this.correlation = correlation;
     }
 
+    /**
+     * CorruptSpec defines detail of a corrupt action
+     */
     @JsonProperty("corrupt")
     public String getCorrupt() {
         return corrupt;
     }
 
+    /**
+     * CorruptSpec defines detail of a corrupt action
+     */
     @JsonProperty("corrupt")
     public void setCorrupt(String corrupt) {
         this.corrupt = corrupt;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DNSChaos.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DNSChaos.java
index 8c032c22b00..6895adcc7a1 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DNSChaos.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DNSChaos.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSChaos is the Schema for the networkchaos API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class DNSChaos implements Editable<DNSChaosBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DNSChaos";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DNSChaos(String apiVersion, String kind, ObjectMeta metadata, DNSChaosSpe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DNSChaos is the Schema for the networkchaos API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DNSChaos is the Schema for the networkchaos API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * DNSChaos is the Schema for the networkchaos API
+     */
     @JsonProperty("spec")
     public DNSChaosSpec getSpec() {
         return spec;
     }
 
+    /**
+     * DNSChaos is the Schema for the networkchaos API
+     */
     @JsonProperty("spec")
     public void setSpec(DNSChaosSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * DNSChaos is the Schema for the networkchaos API
+     */
     @JsonProperty("status")
     public DNSChaosStatus getStatus() {
         return status;
     }
 
+    /**
+     * DNSChaos is the Schema for the networkchaos API
+     */
     @JsonProperty("status")
     public void setStatus(DNSChaosStatus status) {
         this.status = status;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DNSChaosList.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DNSChaosList.java
index 77a5422ed98..a768ff0ad13 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DNSChaosList.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DNSChaosList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSChaosList contains a list of DNSChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class DNSChaosList implements Editable<DNSChaosListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.chaosmesh.v1alpha1.DNSChaos>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.chaosmesh.v1alpha1.DNSChaos> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DNSChaosList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DNSChaosList(String apiVersion, List<io.fabric8.chaosmesh.v1alpha1.DNSCha
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * DNSChaosList contains a list of DNSChaos
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.chaosmesh.v1alpha1.DNSChaos> getItems() {
         return items;
     }
 
+    /**
+     * DNSChaosList contains a list of DNSChaos
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.chaosmesh.v1alpha1.DNSChaos> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DNSChaosList contains a list of DNSChaos
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DNSChaosList contains a list of DNSChaos
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DNSChaosSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DNSChaosSpec.java
index b7e809373c3..cbeb3fdf55a 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DNSChaosSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DNSChaosSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSChaosSpec defines the desired state of DNSChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -110,83 +113,131 @@ public DNSChaosSpec(String action, List<String> containerNames, String duration,
         this.value = value;
     }
 
+    /**
+     * Action defines the specific DNS chaos action. Supported action: error, random Default action: error
+     */
     @JsonProperty("action")
     public String getAction() {
         return action;
     }
 
+    /**
+     * Action defines the specific DNS chaos action. Supported action: error, random Default action: error
+     */
     @JsonProperty("action")
     public void setAction(String action) {
         this.action = action;
     }
 
+    /**
+     * ContainerNames indicates list of the name of affected container. If not set, the first container will be injected
+     */
     @JsonProperty("containerNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getContainerNames() {
         return containerNames;
     }
 
+    /**
+     * ContainerNames indicates list of the name of affected container. If not set, the first container will be injected
+     */
     @JsonProperty("containerNames")
     public void setContainerNames(List<String> containerNames) {
         this.containerNames = containerNames;
     }
 
+    /**
+     * Duration represents the duration of the chaos action
+     */
     @JsonProperty("duration")
     public String getDuration() {
         return duration;
     }
 
+    /**
+     * Duration represents the duration of the chaos action
+     */
     @JsonProperty("duration")
     public void setDuration(String duration) {
         this.duration = duration;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
     }
 
+    /**
+     * Choose which domain names to take effect, support the placeholder ? and wildcard &#42;, or the Specified domain name. Note:<br><p>      1. The wildcard &#42; must be at the end of the string. For example, chaos-&#42;.org is invalid.<br><p>      2. if the patterns is empty, will take effect on all the domain names.<br><p> For example:<br><p> 		The value is ["google.com", "github.&#42;", "chaos-mes?.org"],<br><p> 		will take effect on "google.com", "github.com" and "chaos-mesh.org"
+     */
     @JsonProperty("patterns")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPatterns() {
         return patterns;
     }
 
+    /**
+     * Choose which domain names to take effect, support the placeholder ? and wildcard &#42;, or the Specified domain name. Note:<br><p>      1. The wildcard &#42; must be at the end of the string. For example, chaos-&#42;.org is invalid.<br><p>      2. if the patterns is empty, will take effect on all the domain names.<br><p> For example:<br><p> 		The value is ["google.com", "github.&#42;", "chaos-mes?.org"],<br><p> 		will take effect on "google.com", "github.com" and "chaos-mesh.org"
+     */
     @JsonProperty("patterns")
     public void setPatterns(List<String> patterns) {
         this.patterns = patterns;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public String getRemoteCluster() {
         return remoteCluster;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public void setRemoteCluster(String remoteCluster) {
         this.remoteCluster = remoteCluster;
     }
 
+    /**
+     * DNSChaosSpec defines the desired state of DNSChaos
+     */
     @JsonProperty("selector")
     public PodSelectorSpec getSelector() {
         return selector;
     }
 
+    /**
+     * DNSChaosSpec defines the desired state of DNSChaos
+     */
     @JsonProperty("selector")
     public void setSelector(PodSelectorSpec selector) {
         this.selector = selector;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of pods to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of pods the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of pods to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of pods the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DNSChaosStatus.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DNSChaosStatus.java
index 30b76e5f459..d4b87902ef5 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DNSChaosStatus.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DNSChaosStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSChaosStatus defines the observed state of DNSChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public DNSChaosStatus(List<ChaosCondition> conditions, ExperimentStatus experime
         this.experiment = experiment;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ChaosCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ChaosCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * DNSChaosStatus defines the observed state of DNSChaos
+     */
     @JsonProperty("experiment")
     public ExperimentStatus getExperiment() {
         return experiment;
     }
 
+    /**
+     * DNSChaosStatus defines the observed state of DNSChaos
+     */
     @JsonProperty("experiment")
     public void setExperiment(ExperimentStatus experiment) {
         this.experiment = experiment;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DelaySpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DelaySpec.java
index d76d13f0a78..3f61a77d1f3 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DelaySpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DelaySpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DelaySpec defines detail of a delay action
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public DelaySpec(String correlation, String jitter, String latency, ReorderSpec
         this.reorder = reorder;
     }
 
+    /**
+     * DelaySpec defines detail of a delay action
+     */
     @JsonProperty("correlation")
     public String getCorrelation() {
         return correlation;
     }
 
+    /**
+     * DelaySpec defines detail of a delay action
+     */
     @JsonProperty("correlation")
     public void setCorrelation(String correlation) {
         this.correlation = correlation;
     }
 
+    /**
+     * DelaySpec defines detail of a delay action
+     */
     @JsonProperty("jitter")
     public String getJitter() {
         return jitter;
     }
 
+    /**
+     * DelaySpec defines detail of a delay action
+     */
     @JsonProperty("jitter")
     public void setJitter(String jitter) {
         this.jitter = jitter;
     }
 
+    /**
+     * DelaySpec defines detail of a delay action
+     */
     @JsonProperty("latency")
     public String getLatency() {
         return latency;
     }
 
+    /**
+     * DelaySpec defines detail of a delay action
+     */
     @JsonProperty("latency")
     public void setLatency(String latency) {
         this.latency = latency;
     }
 
+    /**
+     * DelaySpec defines detail of a delay action
+     */
     @JsonProperty("reorder")
     public ReorderSpec getReorder() {
         return reorder;
     }
 
+    /**
+     * DelaySpec defines detail of a delay action
+     */
     @JsonProperty("reorder")
     public void setReorder(ReorderSpec reorder) {
         this.reorder = reorder;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DiskFileSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DiskFileSpec.java
index 055cd5e0658..fb9400f9793 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DiskFileSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DiskFileSpec.java
@@ -82,21 +82,33 @@ public DiskFileSpec(String path, String size) {
         this.size = size;
     }
 
+    /**
+     * specifies the location to fill data in. if path not provided, payload will read/write from/into a temp file, temp file will be deleted after writing
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * specifies the location to fill data in. if path not provided, payload will read/write from/into a temp file, temp file will be deleted after writing
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * specifies how many units of data will write into the file path. support unit: c=1, w=2, b=512, kB=1000, K=1024, MB=1000&#42;1000, M=1024&#42;1024, GB=1000&#42;1000&#42;1000, G=1024&#42;1024&#42;1024 BYTES. example : 1M | 512kB
+     */
     @JsonProperty("size")
     public String getSize() {
         return size;
     }
 
+    /**
+     * specifies how many units of data will write into the file path. support unit: c=1, w=2, b=512, kB=1000, K=1024, MB=1000&#42;1000, M=1024&#42;1024, GB=1000&#42;1000&#42;1000, G=1024&#42;1024&#42;1024 BYTES. example : 1M | 512kB
+     */
     @JsonProperty("size")
     public void setSize(String size) {
         this.size = size;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DiskFillSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DiskFillSpec.java
index 869331f4af3..9c63f4d41e8 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DiskFillSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DiskFillSpec.java
@@ -86,31 +86,49 @@ public DiskFillSpec(Boolean fillByFallocate, String path, String size) {
         this.size = size;
     }
 
+    /**
+     * fill disk by fallocate
+     */
     @JsonProperty("fill-by-fallocate")
     public Boolean getFillByFallocate() {
         return fillByFallocate;
     }
 
+    /**
+     * fill disk by fallocate
+     */
     @JsonProperty("fill-by-fallocate")
     public void setFillByFallocate(Boolean fillByFallocate) {
         this.fillByFallocate = fillByFallocate;
     }
 
+    /**
+     * specifies the location to fill data in. if path not provided, payload will read/write from/into a temp file, temp file will be deleted after writing
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * specifies the location to fill data in. if path not provided, payload will read/write from/into a temp file, temp file will be deleted after writing
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * specifies how many units of data will write into the file path. support unit: c=1, w=2, b=512, kB=1000, K=1024, MB=1000&#42;1000, M=1024&#42;1024, GB=1000&#42;1000&#42;1000, G=1024&#42;1024&#42;1024 BYTES. example : 1M | 512kB
+     */
     @JsonProperty("size")
     public String getSize() {
         return size;
     }
 
+    /**
+     * specifies how many units of data will write into the file path. support unit: c=1, w=2, b=512, kB=1000, K=1024, MB=1000&#42;1000, M=1024&#42;1024, GB=1000&#42;1000&#42;1000, G=1024&#42;1024&#42;1024 BYTES. example : 1M | 512kB
+     */
     @JsonProperty("size")
     public void setSize(String size) {
         this.size = size;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DiskPayloadSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DiskPayloadSpec.java
index d8671c15017..7a5562c1ed3 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DiskPayloadSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DiskPayloadSpec.java
@@ -86,31 +86,49 @@ public DiskPayloadSpec(String path, Integer payloadProcessNum, String size) {
         this.size = size;
     }
 
+    /**
+     * specifies the location to fill data in. if path not provided, payload will read/write from/into a temp file, temp file will be deleted after writing
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * specifies the location to fill data in. if path not provided, payload will read/write from/into a temp file, temp file will be deleted after writing
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * specifies the number of process work on writing, default 1, only 1-255 is valid value
+     */
     @JsonProperty("payload-process-num")
     public Integer getPayloadProcessNum() {
         return payloadProcessNum;
     }
 
+    /**
+     * specifies the number of process work on writing, default 1, only 1-255 is valid value
+     */
     @JsonProperty("payload-process-num")
     public void setPayloadProcessNum(Integer payloadProcessNum) {
         this.payloadProcessNum = payloadProcessNum;
     }
 
+    /**
+     * specifies how many units of data will write into the file path. support unit: c=1, w=2, b=512, kB=1000, K=1024, MB=1000&#42;1000, M=1024&#42;1024, GB=1000&#42;1000&#42;1000, G=1024&#42;1024&#42;1024 BYTES. example : 1M | 512kB
+     */
     @JsonProperty("size")
     public String getSize() {
         return size;
     }
 
+    /**
+     * specifies how many units of data will write into the file path. support unit: c=1, w=2, b=512, kB=1000, K=1024, MB=1000&#42;1000, M=1024&#42;1024, GB=1000&#42;1000&#42;1000, G=1024&#42;1024&#42;1024 BYTES. example : 1M | 512kB
+     */
     @JsonProperty("size")
     public void setSize(String size) {
         this.size = size;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DuplicateSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DuplicateSpec.java
index 5616b341238..842417da813 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DuplicateSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/DuplicateSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DuplicateSpec defines detail of a duplicate action
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public DuplicateSpec(String correlation, String duplicate) {
         this.duplicate = duplicate;
     }
 
+    /**
+     * DuplicateSpec defines detail of a duplicate action
+     */
     @JsonProperty("correlation")
     public String getCorrelation() {
         return correlation;
     }
 
+    /**
+     * DuplicateSpec defines detail of a duplicate action
+     */
     @JsonProperty("correlation")
     public void setCorrelation(String correlation) {
         this.correlation = correlation;
     }
 
+    /**
+     * DuplicateSpec defines detail of a duplicate action
+     */
     @JsonProperty("duplicate")
     public String getDuplicate() {
         return duplicate;
     }
 
+    /**
+     * DuplicateSpec defines detail of a duplicate action
+     */
     @JsonProperty("duplicate")
     public void setDuplicate(String duplicate) {
         this.duplicate = duplicate;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ExperimentStatus.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ExperimentStatus.java
index a17d786137f..adba5ec4ea6 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ExperimentStatus.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ExperimentStatus.java
@@ -85,12 +85,18 @@ public ExperimentStatus(List<Record> containerRecords, String desiredPhase) {
         this.desiredPhase = desiredPhase;
     }
 
+    /**
+     * Records are used to track the running status
+     */
     @JsonProperty("containerRecords")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Record> getContainerRecords() {
         return containerRecords;
     }
 
+    /**
+     * Records are used to track the running status
+     */
     @JsonProperty("containerRecords")
     public void setContainerRecords(List<Record> containerRecords) {
         this.containerRecords = containerRecords;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/FailKernRequest.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/FailKernRequest.java
index f25cecfb038..7a641bbd81c 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/FailKernRequest.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/FailKernRequest.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FailKernRequest defines the injection conditions
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,53 +101,83 @@ public FailKernRequest(List<Frame> callchain, Integer failtype, List<String> hea
         this.times = times;
     }
 
+    /**
+     * Callchain indicate a special call chain, such as:<br><p>     ext4_mount<br><p>       -&gt; mount_subtree<br><p>          -&gt; ...<br><p>             -&gt; should_failslab<br><p> With an optional set of predicates and an optional set of parameters, which used with predicates. You can read call chan and predicate examples from https://github.com/chaos-mesh/bpfki/tree/develop/examples to learn more. If no special call chain, just keep Callchain empty, which means it will fail at any call chain with slab alloc (eg: kmalloc).
+     */
     @JsonProperty("callchain")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Frame> getCallchain() {
         return callchain;
     }
 
+    /**
+     * Callchain indicate a special call chain, such as:<br><p>     ext4_mount<br><p>       -&gt; mount_subtree<br><p>          -&gt; ...<br><p>             -&gt; should_failslab<br><p> With an optional set of predicates and an optional set of parameters, which used with predicates. You can read call chan and predicate examples from https://github.com/chaos-mesh/bpfki/tree/develop/examples to learn more. If no special call chain, just keep Callchain empty, which means it will fail at any call chain with slab alloc (eg: kmalloc).
+     */
     @JsonProperty("callchain")
     public void setCallchain(List<Frame> callchain) {
         this.callchain = callchain;
     }
 
+    /**
+     * FailType indicates what to fail, can be set to '0' / '1' / '2' If `0`, indicates slab to fail (should_failslab) If `1`, indicates alloc_page to fail (should_fail_alloc_page) If `2`, indicates bio to fail (should_fail_bio) You can read:<br><p>   1. https://www.kernel.org/doc/html/latest/fault-injection/fault-injection.html<br><p>   2. http://github.com/iovisor/bcc/blob/master/tools/inject_example.txt<br><p> to learn more
+     */
     @JsonProperty("failtype")
     public Integer getFailtype() {
         return failtype;
     }
 
+    /**
+     * FailType indicates what to fail, can be set to '0' / '1' / '2' If `0`, indicates slab to fail (should_failslab) If `1`, indicates alloc_page to fail (should_fail_alloc_page) If `2`, indicates bio to fail (should_fail_bio) You can read:<br><p>   1. https://www.kernel.org/doc/html/latest/fault-injection/fault-injection.html<br><p>   2. http://github.com/iovisor/bcc/blob/master/tools/inject_example.txt<br><p> to learn more
+     */
     @JsonProperty("failtype")
     public void setFailtype(Integer failtype) {
         this.failtype = failtype;
     }
 
+    /**
+     * Headers indicates the appropriate kernel headers you need. Eg: "linux/mmzone.h", "linux/blkdev.h" and so on
+     */
     @JsonProperty("headers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getHeaders() {
         return headers;
     }
 
+    /**
+     * Headers indicates the appropriate kernel headers you need. Eg: "linux/mmzone.h", "linux/blkdev.h" and so on
+     */
     @JsonProperty("headers")
     public void setHeaders(List<String> headers) {
         this.headers = headers;
     }
 
+    /**
+     * Probability indicates the fails with probability. If you want 1%, please set this field with 1.
+     */
     @JsonProperty("probability")
     public Long getProbability() {
         return probability;
     }
 
+    /**
+     * Probability indicates the fails with probability. If you want 1%, please set this field with 1.
+     */
     @JsonProperty("probability")
     public void setProbability(Long probability) {
         this.probability = probability;
     }
 
+    /**
+     * Times indicates the max times of fails.
+     */
     @JsonProperty("times")
     public Long getTimes() {
         return times;
     }
 
+    /**
+     * Times indicates the max times of fails.
+     */
     @JsonProperty("times")
     public void setTimes(Long times) {
         this.times = times;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/FileAppendSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/FileAppendSpec.java
index 8709ce08a89..5e4f64b07aa 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/FileAppendSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/FileAppendSpec.java
@@ -86,31 +86,49 @@ public FileAppendSpec(Integer count, String data, String fileName) {
         this.fileName = fileName;
     }
 
+    /**
+     * Count is the number of times to append the data.
+     */
     @JsonProperty("count")
     public Integer getCount() {
         return count;
     }
 
+    /**
+     * Count is the number of times to append the data.
+     */
     @JsonProperty("count")
     public void setCount(Integer count) {
         this.count = count;
     }
 
+    /**
+     * Data is the data for append.
+     */
     @JsonProperty("data")
     public String getData() {
         return data;
     }
 
+    /**
+     * Data is the data for append.
+     */
     @JsonProperty("data")
     public void setData(String data) {
         this.data = data;
     }
 
+    /**
+     * FileName is the name of the file to be created, modified, deleted, renamed, or appended.
+     */
     @JsonProperty("file-name")
     public String getFileName() {
         return fileName;
     }
 
+    /**
+     * FileName is the name of the file to be created, modified, deleted, renamed, or appended.
+     */
     @JsonProperty("file-name")
     public void setFileName(String fileName) {
         this.fileName = fileName;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/FileCreateSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/FileCreateSpec.java
index 3879a40ed8b..5248e0db28d 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/FileCreateSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/FileCreateSpec.java
@@ -82,21 +82,33 @@ public FileCreateSpec(String dirName, String fileName) {
         this.fileName = fileName;
     }
 
+    /**
+     * DirName is the directory name to create or delete.
+     */
     @JsonProperty("dir-name")
     public String getDirName() {
         return dirName;
     }
 
+    /**
+     * DirName is the directory name to create or delete.
+     */
     @JsonProperty("dir-name")
     public void setDirName(String dirName) {
         this.dirName = dirName;
     }
 
+    /**
+     * FileName is the name of the file to be created, modified, deleted, renamed, or appended.
+     */
     @JsonProperty("file-name")
     public String getFileName() {
         return fileName;
     }
 
+    /**
+     * FileName is the name of the file to be created, modified, deleted, renamed, or appended.
+     */
     @JsonProperty("file-name")
     public void setFileName(String fileName) {
         this.fileName = fileName;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/FileDeleteSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/FileDeleteSpec.java
index 5034f9aa3ae..2795a547e2a 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/FileDeleteSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/FileDeleteSpec.java
@@ -82,21 +82,33 @@ public FileDeleteSpec(String dirName, String fileName) {
         this.fileName = fileName;
     }
 
+    /**
+     * DirName is the directory name to create or delete.
+     */
     @JsonProperty("dir-name")
     public String getDirName() {
         return dirName;
     }
 
+    /**
+     * DirName is the directory name to create or delete.
+     */
     @JsonProperty("dir-name")
     public void setDirName(String dirName) {
         this.dirName = dirName;
     }
 
+    /**
+     * FileName is the name of the file to be created, modified, deleted, renamed, or appended.
+     */
     @JsonProperty("file-name")
     public String getFileName() {
         return fileName;
     }
 
+    /**
+     * FileName is the name of the file to be created, modified, deleted, renamed, or appended.
+     */
     @JsonProperty("file-name")
     public void setFileName(String fileName) {
         this.fileName = fileName;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/FileModifyPrivilegeSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/FileModifyPrivilegeSpec.java
index bfed2b296cd..1a751842db4 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/FileModifyPrivilegeSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/FileModifyPrivilegeSpec.java
@@ -82,21 +82,33 @@ public FileModifyPrivilegeSpec(String fileName, Long privilege) {
         this.privilege = privilege;
     }
 
+    /**
+     * FileName is the name of the file to be created, modified, deleted, renamed, or appended.
+     */
     @JsonProperty("file-name")
     public String getFileName() {
         return fileName;
     }
 
+    /**
+     * FileName is the name of the file to be created, modified, deleted, renamed, or appended.
+     */
     @JsonProperty("file-name")
     public void setFileName(String fileName) {
         this.fileName = fileName;
     }
 
+    /**
+     * Privilege is the file privilege to be set.
+     */
     @JsonProperty("privilege")
     public Long getPrivilege() {
         return privilege;
     }
 
+    /**
+     * Privilege is the file privilege to be set.
+     */
     @JsonProperty("privilege")
     public void setPrivilege(Long privilege) {
         this.privilege = privilege;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/FileRenameSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/FileRenameSpec.java
index 734c1d20aab..8189ab823b7 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/FileRenameSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/FileRenameSpec.java
@@ -82,21 +82,33 @@ public FileRenameSpec(String destFile, String sourceFile) {
         this.sourceFile = sourceFile;
     }
 
+    /**
+     * DestFile is the name to be renamed.
+     */
     @JsonProperty("dest-file")
     public String getDestFile() {
         return destFile;
     }
 
+    /**
+     * DestFile is the name to be renamed.
+     */
     @JsonProperty("dest-file")
     public void setDestFile(String destFile) {
         this.destFile = destFile;
     }
 
+    /**
+     * SourceFile is the name need to be renamed.
+     */
     @JsonProperty("source-file")
     public String getSourceFile() {
         return sourceFile;
     }
 
+    /**
+     * SourceFile is the name need to be renamed.
+     */
     @JsonProperty("source-file")
     public void setSourceFile(String sourceFile) {
         this.sourceFile = sourceFile;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/FileReplaceSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/FileReplaceSpec.java
index 14b4772561d..c70e107a6b9 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/FileReplaceSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/FileReplaceSpec.java
@@ -90,41 +90,65 @@ public FileReplaceSpec(String destString, String fileName, Integer line, String
         this.originString = originString;
     }
 
+    /**
+     * DestStr is the destination string of the file.
+     */
     @JsonProperty("dest-string")
     public String getDestString() {
         return destString;
     }
 
+    /**
+     * DestStr is the destination string of the file.
+     */
     @JsonProperty("dest-string")
     public void setDestString(String destString) {
         this.destString = destString;
     }
 
+    /**
+     * FileName is the name of the file to be created, modified, deleted, renamed, or appended.
+     */
     @JsonProperty("file-name")
     public String getFileName() {
         return fileName;
     }
 
+    /**
+     * FileName is the name of the file to be created, modified, deleted, renamed, or appended.
+     */
     @JsonProperty("file-name")
     public void setFileName(String fileName) {
         this.fileName = fileName;
     }
 
+    /**
+     * Line is the line number of the file to be replaced.
+     */
     @JsonProperty("line")
     public Integer getLine() {
         return line;
     }
 
+    /**
+     * Line is the line number of the file to be replaced.
+     */
     @JsonProperty("line")
     public void setLine(Integer line) {
         this.line = line;
     }
 
+    /**
+     * OriginStr is the origin string of the file.
+     */
     @JsonProperty("origin-string")
     public String getOriginString() {
         return originString;
     }
 
+    /**
+     * OriginStr is the origin string of the file.
+     */
     @JsonProperty("origin-string")
     public void setOriginString(String originString) {
         this.originString = originString;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Filter.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Filter.java
index 6040335d677..56b8d67372e 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Filter.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Filter.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Filter represents a filter of IOChaos action, which will define the scope of an IOChaosAction
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public Filter(List<String> methods, String path, Integer percent) {
         this.percent = percent;
     }
 
+    /**
+     * Methods represents the method that the action will inject in
+     */
     @JsonProperty("methods")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMethods() {
         return methods;
     }
 
+    /**
+     * Methods represents the method that the action will inject in
+     */
     @JsonProperty("methods")
     public void setMethods(List<String> methods) {
         this.methods = methods;
     }
 
+    /**
+     * Path represents a glob of injecting path
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Path represents a glob of injecting path
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * Percent represents the percent probability of injecting this action
+     */
     @JsonProperty("percent")
     public Integer getPercent() {
         return percent;
     }
 
+    /**
+     * Percent represents the percent probability of injecting this action
+     */
     @JsonProperty("percent")
     public void setPercent(Integer percent) {
         this.percent = percent;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Frame.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Frame.java
index 4093151ef66..e47b9cb83fa 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Frame.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Frame.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Frame defines the function signature and predicate in function's body
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public Frame(String funcname, String parameters, String predicate) {
         this.predicate = predicate;
     }
 
+    /**
+     * Funcname can be find from kernel source or `/proc/kallsyms`, such as `ext4_mount`
+     */
     @JsonProperty("funcname")
     public String getFuncname() {
         return funcname;
     }
 
+    /**
+     * Funcname can be find from kernel source or `/proc/kallsyms`, such as `ext4_mount`
+     */
     @JsonProperty("funcname")
     public void setFuncname(String funcname) {
         this.funcname = funcname;
     }
 
+    /**
+     * Parameters is used with predicate, for example, if you want to inject slab error in `d_alloc_parallel(struct dentry &#42;parent, const struct qstr &#42;name)` with a special name `bananas`, you need to set it to `struct dentry &#42;parent, const struct qstr &#42;name` otherwise omit it.
+     */
     @JsonProperty("parameters")
     public String getParameters() {
         return parameters;
     }
 
+    /**
+     * Parameters is used with predicate, for example, if you want to inject slab error in `d_alloc_parallel(struct dentry &#42;parent, const struct qstr &#42;name)` with a special name `bananas`, you need to set it to `struct dentry &#42;parent, const struct qstr &#42;name` otherwise omit it.
+     */
     @JsonProperty("parameters")
     public void setParameters(String parameters) {
         this.parameters = parameters;
     }
 
+    /**
+     * Predicate will access the arguments of this Frame, example with Parameters's, you can set it to `STRNCMP(name-&gt;name, "bananas", 8)` to make inject only with it, or omit it to inject for all d_alloc_parallel call chain.
+     */
     @JsonProperty("predicate")
     public String getPredicate() {
         return predicate;
     }
 
+    /**
+     * Predicate will access the arguments of this Frame, example with Parameters's, you can set it to `STRNCMP(name-&gt;name, "bananas", 8)` to make inject only with it, or omit it to inject for all d_alloc_parallel call chain.
+     */
     @JsonProperty("predicate")
     public void setPredicate(String predicate) {
         this.predicate = predicate;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/GCPChaos.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/GCPChaos.java
index a77f1fede13..d3c123a6892 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/GCPChaos.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/GCPChaos.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPChaos is the Schema for the gcpchaos API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class GCPChaos implements Editable<GCPChaosBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GCPChaos";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public GCPChaos(String apiVersion, String kind, ObjectMeta metadata, GCPChaosSpe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * GCPChaos is the Schema for the gcpchaos API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * GCPChaos is the Schema for the gcpchaos API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * GCPChaos is the Schema for the gcpchaos API
+     */
     @JsonProperty("spec")
     public GCPChaosSpec getSpec() {
         return spec;
     }
 
+    /**
+     * GCPChaos is the Schema for the gcpchaos API
+     */
     @JsonProperty("spec")
     public void setSpec(GCPChaosSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * GCPChaos is the Schema for the gcpchaos API
+     */
     @JsonProperty("status")
     public GCPChaosStatus getStatus() {
         return status;
     }
 
+    /**
+     * GCPChaos is the Schema for the gcpchaos API
+     */
     @JsonProperty("status")
     public void setStatus(GCPChaosStatus status) {
         this.status = status;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/GCPChaosList.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/GCPChaosList.java
index dc7ad217001..87d3e7f504e 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/GCPChaosList.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/GCPChaosList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPChaosList contains a list of GCPChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class GCPChaosList implements Editable<GCPChaosListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.chaosmesh.v1alpha1.GCPChaos>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.chaosmesh.v1alpha1.GCPChaos> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GCPChaosList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public GCPChaosList(String apiVersion, List<io.fabric8.chaosmesh.v1alpha1.GCPCha
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * GCPChaosList contains a list of GCPChaos
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.chaosmesh.v1alpha1.GCPChaos> getItems() {
         return items;
     }
 
+    /**
+     * GCPChaosList contains a list of GCPChaos
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.chaosmesh.v1alpha1.GCPChaos> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * GCPChaosList contains a list of GCPChaos
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * GCPChaosList contains a list of GCPChaos
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/GCPChaosSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/GCPChaosSpec.java
index 794ac371c2b..01623e7b455 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/GCPChaosSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/GCPChaosSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPChaosSpec is the content of the specification for a GCPChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -109,82 +112,130 @@ public GCPChaosSpec(String action, List<String> deviceNames, String duration, St
         this.zone = zone;
     }
 
+    /**
+     * Action defines the specific gcp chaos action. Supported action: node-stop / node-reset / disk-loss Default action: node-stop
+     */
     @JsonProperty("action")
     public String getAction() {
         return action;
     }
 
+    /**
+     * Action defines the specific gcp chaos action. Supported action: node-stop / node-reset / disk-loss Default action: node-stop
+     */
     @JsonProperty("action")
     public void setAction(String action) {
         this.action = action;
     }
 
+    /**
+     * The device name of disks to detach. Needed in disk-loss.
+     */
     @JsonProperty("deviceNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDeviceNames() {
         return deviceNames;
     }
 
+    /**
+     * The device name of disks to detach. Needed in disk-loss.
+     */
     @JsonProperty("deviceNames")
     public void setDeviceNames(List<String> deviceNames) {
         this.deviceNames = deviceNames;
     }
 
+    /**
+     * Duration represents the duration of the chaos action.
+     */
     @JsonProperty("duration")
     public String getDuration() {
         return duration;
     }
 
+    /**
+     * Duration represents the duration of the chaos action.
+     */
     @JsonProperty("duration")
     public void setDuration(String duration) {
         this.duration = duration;
     }
 
+    /**
+     * Instance defines the name of the instance
+     */
     @JsonProperty("instance")
     public String getInstance() {
         return instance;
     }
 
+    /**
+     * Instance defines the name of the instance
+     */
     @JsonProperty("instance")
     public void setInstance(String instance) {
         this.instance = instance;
     }
 
+    /**
+     * Project defines the ID of gcp project.
+     */
     @JsonProperty("project")
     public String getProject() {
         return project;
     }
 
+    /**
+     * Project defines the ID of gcp project.
+     */
     @JsonProperty("project")
     public void setProject(String project) {
         this.project = project;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public String getRemoteCluster() {
         return remoteCluster;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public void setRemoteCluster(String remoteCluster) {
         this.remoteCluster = remoteCluster;
     }
 
+    /**
+     * SecretName defines the name of kubernetes secret. It is used for GCP credentials.
+     */
     @JsonProperty("secretName")
     public String getSecretName() {
         return secretName;
     }
 
+    /**
+     * SecretName defines the name of kubernetes secret. It is used for GCP credentials.
+     */
     @JsonProperty("secretName")
     public void setSecretName(String secretName) {
         this.secretName = secretName;
     }
 
+    /**
+     * Zone defines the zone of gcp project.
+     */
     @JsonProperty("zone")
     public String getZone() {
         return zone;
     }
 
+    /**
+     * Zone defines the zone of gcp project.
+     */
     @JsonProperty("zone")
     public void setZone(String zone) {
         this.zone = zone;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/GCPChaosStatus.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/GCPChaosStatus.java
index 4779fbe1ed8..c81f6ad7c38 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/GCPChaosStatus.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/GCPChaosStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPChaosStatus represents the status of a GCPChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public GCPChaosStatus(List<String> attachedDiskStrings, List<ChaosCondition> con
         this.experiment = experiment;
     }
 
+    /**
+     * The attached disk info strings. Needed in disk-loss.
+     */
     @JsonProperty("attachedDiskStrings")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAttachedDiskStrings() {
         return attachedDiskStrings;
     }
 
+    /**
+     * The attached disk info strings. Needed in disk-loss.
+     */
     @JsonProperty("attachedDiskStrings")
     public void setAttachedDiskStrings(List<String> attachedDiskStrings) {
         this.attachedDiskStrings = attachedDiskStrings;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ChaosCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ChaosCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * GCPChaosStatus represents the status of a GCPChaos
+     */
     @JsonProperty("experiment")
     public ExperimentStatus getExperiment() {
         return experiment;
     }
 
+    /**
+     * GCPChaosStatus represents the status of a GCPChaos
+     */
     @JsonProperty("experiment")
     public void setExperiment(ExperimentStatus experiment) {
         this.experiment = experiment;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/GCPSelector.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/GCPSelector.java
index 456850d3ce8..f41a9dcef64 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/GCPSelector.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/GCPSelector.java
@@ -93,42 +93,66 @@ public GCPSelector(List<String> deviceNames, String instance, String project, St
         this.zone = zone;
     }
 
+    /**
+     * The device name of disks to detach. Needed in disk-loss.
+     */
     @JsonProperty("deviceNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDeviceNames() {
         return deviceNames;
     }
 
+    /**
+     * The device name of disks to detach. Needed in disk-loss.
+     */
     @JsonProperty("deviceNames")
     public void setDeviceNames(List<String> deviceNames) {
         this.deviceNames = deviceNames;
     }
 
+    /**
+     * Instance defines the name of the instance
+     */
     @JsonProperty("instance")
     public String getInstance() {
         return instance;
     }
 
+    /**
+     * Instance defines the name of the instance
+     */
     @JsonProperty("instance")
     public void setInstance(String instance) {
         this.instance = instance;
     }
 
+    /**
+     * Project defines the ID of gcp project.
+     */
     @JsonProperty("project")
     public String getProject() {
         return project;
     }
 
+    /**
+     * Project defines the ID of gcp project.
+     */
     @JsonProperty("project")
     public void setProject(String project) {
         this.project = project;
     }
 
+    /**
+     * Zone defines the zone of gcp project.
+     */
     @JsonProperty("zone")
     public String getZone() {
         return zone;
     }
 
+    /**
+     * Zone defines the zone of gcp project.
+     */
     @JsonProperty("zone")
     public void setZone(String zone) {
         this.zone = zone;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/GenericSelectorSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/GenericSelectorSpec.java
index c1bcacbbd79..0a549935505 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/GenericSelectorSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/GenericSelectorSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GenericSelectorSpec defines some selectors to select objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -96,45 +99,69 @@ public GenericSelectorSpec(Map<String, String> annotationSelectors, Map<String,
         this.namespaces = namespaces;
     }
 
+    /**
+     * Map of string keys and values that can be used to select objects. A selector based on annotations.
+     */
     @JsonProperty("annotationSelectors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotationSelectors() {
         return annotationSelectors;
     }
 
+    /**
+     * Map of string keys and values that can be used to select objects. A selector based on annotations.
+     */
     @JsonProperty("annotationSelectors")
     public void setAnnotationSelectors(Map<String, String> annotationSelectors) {
         this.annotationSelectors = annotationSelectors;
     }
 
+    /**
+     * Map of string keys and values that can be used to select objects. A selector based on fields.
+     */
     @JsonProperty("fieldSelectors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getFieldSelectors() {
         return fieldSelectors;
     }
 
+    /**
+     * Map of string keys and values that can be used to select objects. A selector based on fields.
+     */
     @JsonProperty("fieldSelectors")
     public void setFieldSelectors(Map<String, String> fieldSelectors) {
         this.fieldSelectors = fieldSelectors;
     }
 
+    /**
+     * Map of string keys and values that can be used to select objects. A selector based on labels.
+     */
     @JsonProperty("labelSelectors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabelSelectors() {
         return labelSelectors;
     }
 
+    /**
+     * Map of string keys and values that can be used to select objects. A selector based on labels.
+     */
     @JsonProperty("labelSelectors")
     public void setLabelSelectors(Map<String, String> labelSelectors) {
         this.labelSelectors = labelSelectors;
     }
 
+    /**
+     * Namespaces is a set of namespace to which objects belong.
+     */
     @JsonProperty("namespaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNamespaces() {
         return namespaces;
     }
 
+    /**
+     * Namespaces is a set of namespace to which objects belong.
+     */
     @JsonProperty("namespaces")
     public void setNamespaces(List<String> namespaces) {
         this.namespaces = namespaces;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPAbortSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPAbortSpec.java
index 04f1e84b20b..4a83b171fd1 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPAbortSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPAbortSpec.java
@@ -101,62 +101,98 @@ public HTTPAbortSpec(String code, String method, String path, Integer port, List
         this.target = target;
     }
 
+    /**
+     * Code is a rule to select target by http status code in response
+     */
     @JsonProperty("code")
     public String getCode() {
         return code;
     }
 
+    /**
+     * Code is a rule to select target by http status code in response
+     */
     @JsonProperty("code")
     public void setCode(String code) {
         this.code = code;
     }
 
+    /**
+     * HTTP method
+     */
     @JsonProperty("method")
     public String getMethod() {
         return method;
     }
 
+    /**
+     * HTTP method
+     */
     @JsonProperty("method")
     public void setMethod(String method) {
         this.method = method;
     }
 
+    /**
+     * Match path of Uri with wildcard matches
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Match path of Uri with wildcard matches
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * The TCP port that the target service listens on
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * The TCP port that the target service listens on
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * Composed with one of the port of HTTP connection, we will only attack HTTP connection with port inside proxy_ports
+     */
     @JsonProperty("proxy_ports")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Integer> getProxyPorts() {
         return proxyPorts;
     }
 
+    /**
+     * Composed with one of the port of HTTP connection, we will only attack HTTP connection with port inside proxy_ports
+     */
     @JsonProperty("proxy_ports")
     public void setProxyPorts(List<Integer> proxyPorts) {
         this.proxyPorts = proxyPorts;
     }
 
+    /**
+     * HTTP target: Request or Response
+     */
     @JsonProperty("target")
     public String getTarget() {
         return target;
     }
 
+    /**
+     * HTTP target: Request or Response
+     */
     @JsonProperty("target")
     public void setTarget(String target) {
         this.target = target;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPChaos.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPChaos.java
index e44ad7ed66d..0a50dbb744b 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPChaos.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPChaos.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPChaos is the Schema for the HTTPchaos API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class HTTPChaos implements Editable<HTTPChaosBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "HTTPChaos";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public HTTPChaos(String apiVersion, String kind, ObjectMeta metadata, HTTPChaosS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * HTTPChaos is the Schema for the HTTPchaos API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * HTTPChaos is the Schema for the HTTPchaos API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * HTTPChaos is the Schema for the HTTPchaos API
+     */
     @JsonProperty("spec")
     public HTTPChaosSpec getSpec() {
         return spec;
     }
 
+    /**
+     * HTTPChaos is the Schema for the HTTPchaos API
+     */
     @JsonProperty("spec")
     public void setSpec(HTTPChaosSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * HTTPChaos is the Schema for the HTTPchaos API
+     */
     @JsonProperty("status")
     public HTTPChaosStatus getStatus() {
         return status;
     }
 
+    /**
+     * HTTPChaos is the Schema for the HTTPchaos API
+     */
     @JsonProperty("status")
     public void setStatus(HTTPChaosStatus status) {
         this.status = status;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPChaosList.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPChaosList.java
index a99acf06c48..d7c1726e3e3 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPChaosList.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPChaosList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPChaosList contains a list of HTTPChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class HTTPChaosList implements Editable<HTTPChaosListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.chaosmesh.v1alpha1.HTTPChaos>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.chaosmesh.v1alpha1.HTTPChaos> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "HTTPChaosList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public HTTPChaosList(String apiVersion, List<io.fabric8.chaosmesh.v1alpha1.HTTPC
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * HTTPChaosList contains a list of HTTPChaos
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.chaosmesh.v1alpha1.HTTPChaos> getItems() {
         return items;
     }
 
+    /**
+     * HTTPChaosList contains a list of HTTPChaos
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.chaosmesh.v1alpha1.HTTPChaos> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * HTTPChaosList contains a list of HTTPChaos
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * HTTPChaosList contains a list of HTTPChaos
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPChaosSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPChaosSpec.java
index a6c4b90000b..ac3b4026d25 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPChaosSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPChaosSpec.java
@@ -144,61 +144,97 @@ public HTTPChaosSpec(Boolean abort, Integer code, String delay, String duration,
         this.value = value;
     }
 
+    /**
+     * Abort is a rule to abort a http session.
+     */
     @JsonProperty("abort")
     public Boolean getAbort() {
         return abort;
     }
 
+    /**
+     * Abort is a rule to abort a http session.
+     */
     @JsonProperty("abort")
     public void setAbort(Boolean abort) {
         this.abort = abort;
     }
 
+    /**
+     * Code is a rule to select target by http status code in response.
+     */
     @JsonProperty("code")
     public Integer getCode() {
         return code;
     }
 
+    /**
+     * Code is a rule to select target by http status code in response.
+     */
     @JsonProperty("code")
     public void setCode(Integer code) {
         this.code = code;
     }
 
+    /**
+     * Delay represents the delay of the target request/response. A duration string is a possibly unsigned sequence of decimal numbers, each with optional fraction and a unit suffix, such as "300ms", "2h45m". Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h".
+     */
     @JsonProperty("delay")
     public String getDelay() {
         return delay;
     }
 
+    /**
+     * Delay represents the delay of the target request/response. A duration string is a possibly unsigned sequence of decimal numbers, each with optional fraction and a unit suffix, such as "300ms", "2h45m". Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h".
+     */
     @JsonProperty("delay")
     public void setDelay(String delay) {
         this.delay = delay;
     }
 
+    /**
+     * Duration represents the duration of the chaos action.
+     */
     @JsonProperty("duration")
     public String getDuration() {
         return duration;
     }
 
+    /**
+     * Duration represents the duration of the chaos action.
+     */
     @JsonProperty("duration")
     public void setDuration(String duration) {
         this.duration = duration;
     }
 
+    /**
+     * Method is a rule to select target by http method in request.
+     */
     @JsonProperty("method")
     public String getMethod() {
         return method;
     }
 
+    /**
+     * Method is a rule to select target by http method in request.
+     */
     @JsonProperty("method")
     public void setMethod(String method) {
         this.method = method;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
@@ -214,31 +250,49 @@ public void setPatch(PodHttpChaosPatchActions patch) {
         this.patch = patch;
     }
 
+    /**
+     * Path is a rule to select target by uri path in http request.
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Path is a rule to select target by uri path in http request.
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * Port represents the target port to be proxy of.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * Port represents the target port to be proxy of.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public String getRemoteCluster() {
         return remoteCluster;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public void setRemoteCluster(String remoteCluster) {
         this.remoteCluster = remoteCluster;
@@ -254,23 +308,35 @@ public void setReplace(PodHttpChaosReplaceActions replace) {
         this.replace = replace;
     }
 
+    /**
+     * RequestHeaders is a rule to select target by http headers in request. The key-value pairs represent header name and header value pairs.
+     */
     @JsonProperty("request_headers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getRequestHeaders() {
         return requestHeaders;
     }
 
+    /**
+     * RequestHeaders is a rule to select target by http headers in request. The key-value pairs represent header name and header value pairs.
+     */
     @JsonProperty("request_headers")
     public void setRequestHeaders(Map<String, String> requestHeaders) {
         this.requestHeaders = requestHeaders;
     }
 
+    /**
+     * ResponseHeaders is a rule to select target by http headers in response. The key-value pairs represent header name and header value pairs.
+     */
     @JsonProperty("response_headers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getResponseHeaders() {
         return responseHeaders;
     }
 
+    /**
+     * ResponseHeaders is a rule to select target by http headers in response. The key-value pairs represent header name and header value pairs.
+     */
     @JsonProperty("response_headers")
     public void setResponseHeaders(Map<String, String> responseHeaders) {
         this.responseHeaders = responseHeaders;
@@ -286,11 +352,17 @@ public void setSelector(PodSelectorSpec selector) {
         this.selector = selector;
     }
 
+    /**
+     * Target is the object to be selected and injected.
+     */
     @JsonProperty("target")
     public String getTarget() {
         return target;
     }
 
+    /**
+     * Target is the object to be selected and injected.
+     */
     @JsonProperty("target")
     public void setTarget(String target) {
         this.target = target;
@@ -306,11 +378,17 @@ public void setTls(PodHttpChaosTLS tls) {
         this.tls = tls;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of pods to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of pods the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of pods to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of pods the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPChaosStatus.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPChaosStatus.java
index 3cd9763de19..50c02d436d8 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPChaosStatus.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPChaosStatus.java
@@ -90,12 +90,18 @@ public HTTPChaosStatus(List<ChaosCondition> conditions, ExperimentStatus experim
         this.instances = instances;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ChaosCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ChaosCondition> conditions) {
         this.conditions = conditions;
@@ -111,12 +117,18 @@ public void setExperiment(ExperimentStatus experiment) {
         this.experiment = experiment;
     }
 
+    /**
+     * Instances always specifies podhttpchaos generation or empty
+     */
     @JsonProperty("instances")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Long> getInstances() {
         return instances;
     }
 
+    /**
+     * Instances always specifies podhttpchaos generation or empty
+     */
     @JsonProperty("instances")
     public void setInstances(Map<String, Long> instances) {
         this.instances = instances;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPCommonSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPCommonSpec.java
index 1ae1e8a98a5..5d54a630fce 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPCommonSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPCommonSpec.java
@@ -101,62 +101,98 @@ public HTTPCommonSpec(String code, String method, String path, Integer port, Lis
         this.target = target;
     }
 
+    /**
+     * Code is a rule to select target by http status code in response
+     */
     @JsonProperty("code")
     public String getCode() {
         return code;
     }
 
+    /**
+     * Code is a rule to select target by http status code in response
+     */
     @JsonProperty("code")
     public void setCode(String code) {
         this.code = code;
     }
 
+    /**
+     * HTTP method
+     */
     @JsonProperty("method")
     public String getMethod() {
         return method;
     }
 
+    /**
+     * HTTP method
+     */
     @JsonProperty("method")
     public void setMethod(String method) {
         this.method = method;
     }
 
+    /**
+     * Match path of Uri with wildcard matches
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Match path of Uri with wildcard matches
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * The TCP port that the target service listens on
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * The TCP port that the target service listens on
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * Composed with one of the port of HTTP connection, we will only attack HTTP connection with port inside proxy_ports
+     */
     @JsonProperty("proxy_ports")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Integer> getProxyPorts() {
         return proxyPorts;
     }
 
+    /**
+     * Composed with one of the port of HTTP connection, we will only attack HTTP connection with port inside proxy_ports
+     */
     @JsonProperty("proxy_ports")
     public void setProxyPorts(List<Integer> proxyPorts) {
         this.proxyPorts = proxyPorts;
     }
 
+    /**
+     * HTTP target: Request or Response
+     */
     @JsonProperty("target")
     public String getTarget() {
         return target;
     }
 
+    /**
+     * HTTP target: Request or Response
+     */
     @JsonProperty("target")
     public void setTarget(String target) {
         this.target = target;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPConfigSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPConfigSpec.java
index 6023558044c..7ceb12829b8 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPConfigSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPConfigSpec.java
@@ -78,11 +78,17 @@ public HTTPConfigSpec(String filePath) {
         this.filePath = filePath;
     }
 
+    /**
+     * The config file path
+     */
     @JsonProperty("file_path")
     public String getFilePath() {
         return filePath;
     }
 
+    /**
+     * The config file path
+     */
     @JsonProperty("file_path")
     public void setFilePath(String filePath) {
         this.filePath = filePath;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPCriteria.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPCriteria.java
index de5091351f5..52feda43f76 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPCriteria.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPCriteria.java
@@ -78,11 +78,17 @@ public HTTPCriteria(String statusCode) {
         this.statusCode = statusCode;
     }
 
+    /**
+     * StatusCode defines the expected http status code for the request. A statusCode string could be a single code (e.g. 200), or an inclusive range (e.g. 200-400, both `200` and `400` are included).
+     */
     @JsonProperty("statusCode")
     public String getStatusCode() {
         return statusCode;
     }
 
+    /**
+     * StatusCode defines the expected http status code for the request. A statusCode string could be a single code (e.g. 200), or an inclusive range (e.g. 200-400, both `200` and `400` are included).
+     */
     @JsonProperty("statusCode")
     public void setStatusCode(String statusCode) {
         this.statusCode = statusCode;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPDelaySpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPDelaySpec.java
index 5d69831180d..d1ae76a733e 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPDelaySpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPDelaySpec.java
@@ -105,72 +105,114 @@ public HTTPDelaySpec(String code, String delay, String method, String path, Inte
         this.target = target;
     }
 
+    /**
+     * Code is a rule to select target by http status code in response
+     */
     @JsonProperty("code")
     public String getCode() {
         return code;
     }
 
+    /**
+     * Code is a rule to select target by http status code in response
+     */
     @JsonProperty("code")
     public void setCode(String code) {
         this.code = code;
     }
 
+    /**
+     * Delay represents the delay of the target request/response
+     */
     @JsonProperty("delay")
     public String getDelay() {
         return delay;
     }
 
+    /**
+     * Delay represents the delay of the target request/response
+     */
     @JsonProperty("delay")
     public void setDelay(String delay) {
         this.delay = delay;
     }
 
+    /**
+     * HTTP method
+     */
     @JsonProperty("method")
     public String getMethod() {
         return method;
     }
 
+    /**
+     * HTTP method
+     */
     @JsonProperty("method")
     public void setMethod(String method) {
         this.method = method;
     }
 
+    /**
+     * Match path of Uri with wildcard matches
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Match path of Uri with wildcard matches
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * The TCP port that the target service listens on
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * The TCP port that the target service listens on
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * Composed with one of the port of HTTP connection, we will only attack HTTP connection with port inside proxy_ports
+     */
     @JsonProperty("proxy_ports")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Integer> getProxyPorts() {
         return proxyPorts;
     }
 
+    /**
+     * Composed with one of the port of HTTP connection, we will only attack HTTP connection with port inside proxy_ports
+     */
     @JsonProperty("proxy_ports")
     public void setProxyPorts(List<Integer> proxyPorts) {
         this.proxyPorts = proxyPorts;
     }
 
+    /**
+     * HTTP target: Request or Response
+     */
     @JsonProperty("target")
     public String getTarget() {
         return target;
     }
 
+    /**
+     * HTTP target: Request or Response
+     */
     @JsonProperty("target")
     public void setTarget(String target) {
         this.target = target;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPRequestSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPRequestSpec.java
index 5807b304403..905a0c3e3c6 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPRequestSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/HTTPRequestSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * used for HTTP request, now only support GET
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public HTTPRequestSpec(Integer count, Boolean enableConnPool, String url) {
         this.url = url;
     }
 
+    /**
+     * The number of requests to send
+     */
     @JsonProperty("count")
     public Integer getCount() {
         return count;
     }
 
+    /**
+     * The number of requests to send
+     */
     @JsonProperty("count")
     public void setCount(Integer count) {
         this.count = count;
     }
 
+    /**
+     * Enable connection pool
+     */
     @JsonProperty("enable-conn-pool")
     public Boolean getEnableConnPool() {
         return enableConnPool;
     }
 
+    /**
+     * Enable connection pool
+     */
     @JsonProperty("enable-conn-pool")
     public void setEnableConnPool(Boolean enableConnPool) {
         this.enableConnPool = enableConnPool;
     }
 
+    /**
+     * Request to send"
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * Request to send"
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/IOChaos.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/IOChaos.java
index 2a77d6cb508..e45364b9f07 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/IOChaos.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/IOChaos.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IOChaos is the Schema for the iochaos API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class IOChaos implements Editable<IOChaosBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "IOChaos";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public IOChaos(String apiVersion, String kind, ObjectMeta metadata, IOChaosSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * IOChaos is the Schema for the iochaos API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * IOChaos is the Schema for the iochaos API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * IOChaos is the Schema for the iochaos API
+     */
     @JsonProperty("spec")
     public IOChaosSpec getSpec() {
         return spec;
     }
 
+    /**
+     * IOChaos is the Schema for the iochaos API
+     */
     @JsonProperty("spec")
     public void setSpec(IOChaosSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * IOChaos is the Schema for the iochaos API
+     */
     @JsonProperty("status")
     public IOChaosStatus getStatus() {
         return status;
     }
 
+    /**
+     * IOChaos is the Schema for the iochaos API
+     */
     @JsonProperty("status")
     public void setStatus(IOChaosStatus status) {
         this.status = status;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/IOChaosAction.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/IOChaosAction.java
index 13311a72693..c45d6e2134a 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/IOChaosAction.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/IOChaosAction.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IOChaosAction defines a possible action of IOChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -158,203 +161,323 @@ public IOChaosAction(Timespec atime, Long blocks, Timespec ctime, List<IoFault>
         this.uid = uid;
     }
 
+    /**
+     * IOChaosAction defines a possible action of IOChaos
+     */
     @JsonProperty("atime")
     public Timespec getAtime() {
         return atime;
     }
 
+    /**
+     * IOChaosAction defines a possible action of IOChaos
+     */
     @JsonProperty("atime")
     public void setAtime(Timespec atime) {
         this.atime = atime;
     }
 
+    /**
+     * IOChaosAction defines a possible action of IOChaos
+     */
     @JsonProperty("blocks")
     public Long getBlocks() {
         return blocks;
     }
 
+    /**
+     * IOChaosAction defines a possible action of IOChaos
+     */
     @JsonProperty("blocks")
     public void setBlocks(Long blocks) {
         this.blocks = blocks;
     }
 
+    /**
+     * IOChaosAction defines a possible action of IOChaos
+     */
     @JsonProperty("ctime")
     public Timespec getCtime() {
         return ctime;
     }
 
+    /**
+     * IOChaosAction defines a possible action of IOChaos
+     */
     @JsonProperty("ctime")
     public void setCtime(Timespec ctime) {
         this.ctime = ctime;
     }
 
+    /**
+     * Faults represents the fault to inject
+     */
     @JsonProperty("faults")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IoFault> getFaults() {
         return faults;
     }
 
+    /**
+     * Faults represents the fault to inject
+     */
     @JsonProperty("faults")
     public void setFaults(List<IoFault> faults) {
         this.faults = faults;
     }
 
+    /**
+     * IOChaosAction defines a possible action of IOChaos
+     */
     @JsonProperty("gid")
     public Long getGid() {
         return gid;
     }
 
+    /**
+     * IOChaosAction defines a possible action of IOChaos
+     */
     @JsonProperty("gid")
     public void setGid(Long gid) {
         this.gid = gid;
     }
 
+    /**
+     * IOChaosAction defines a possible action of IOChaos
+     */
     @JsonProperty("ino")
     public Long getIno() {
         return ino;
     }
 
+    /**
+     * IOChaosAction defines a possible action of IOChaos
+     */
     @JsonProperty("ino")
     public void setIno(Long ino) {
         this.ino = ino;
     }
 
+    /**
+     * IOChaosAction defines a possible action of IOChaos
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * IOChaosAction defines a possible action of IOChaos
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Latency represents the latency to inject
+     */
     @JsonProperty("latency")
     public String getLatency() {
         return latency;
     }
 
+    /**
+     * Latency represents the latency to inject
+     */
     @JsonProperty("latency")
     public void setLatency(String latency) {
         this.latency = latency;
     }
 
+    /**
+     * Methods represents the method that the action will inject in
+     */
     @JsonProperty("methods")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMethods() {
         return methods;
     }
 
+    /**
+     * Methods represents the method that the action will inject in
+     */
     @JsonProperty("methods")
     public void setMethods(List<String> methods) {
         this.methods = methods;
     }
 
+    /**
+     * IOChaosAction defines a possible action of IOChaos
+     */
     @JsonProperty("mistake")
     public MistakeSpec getMistake() {
         return mistake;
     }
 
+    /**
+     * IOChaosAction defines a possible action of IOChaos
+     */
     @JsonProperty("mistake")
     public void setMistake(MistakeSpec mistake) {
         this.mistake = mistake;
     }
 
+    /**
+     * IOChaosAction defines a possible action of IOChaos
+     */
     @JsonProperty("mtime")
     public Timespec getMtime() {
         return mtime;
     }
 
+    /**
+     * IOChaosAction defines a possible action of IOChaos
+     */
     @JsonProperty("mtime")
     public void setMtime(Timespec mtime) {
         this.mtime = mtime;
     }
 
+    /**
+     * IOChaosAction defines a possible action of IOChaos
+     */
     @JsonProperty("nlink")
     public Long getNlink() {
         return nlink;
     }
 
+    /**
+     * IOChaosAction defines a possible action of IOChaos
+     */
     @JsonProperty("nlink")
     public void setNlink(Long nlink) {
         this.nlink = nlink;
     }
 
+    /**
+     * Path represents a glob of injecting path
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Path represents a glob of injecting path
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * Percent represents the percent probability of injecting this action
+     */
     @JsonProperty("percent")
     public Integer getPercent() {
         return percent;
     }
 
+    /**
+     * Percent represents the percent probability of injecting this action
+     */
     @JsonProperty("percent")
     public void setPercent(Integer percent) {
         this.percent = percent;
     }
 
+    /**
+     * IOChaosAction defines a possible action of IOChaos
+     */
     @JsonProperty("perm")
     public Integer getPerm() {
         return perm;
     }
 
+    /**
+     * IOChaosAction defines a possible action of IOChaos
+     */
     @JsonProperty("perm")
     public void setPerm(Integer perm) {
         this.perm = perm;
     }
 
+    /**
+     * IOChaosAction defines a possible action of IOChaos
+     */
     @JsonProperty("rdev")
     public Long getRdev() {
         return rdev;
     }
 
+    /**
+     * IOChaosAction defines a possible action of IOChaos
+     */
     @JsonProperty("rdev")
     public void setRdev(Long rdev) {
         this.rdev = rdev;
     }
 
+    /**
+     * IOChaosAction defines a possible action of IOChaos
+     */
     @JsonProperty("size")
     public Long getSize() {
         return size;
     }
 
+    /**
+     * IOChaosAction defines a possible action of IOChaos
+     */
     @JsonProperty("size")
     public void setSize(Long size) {
         this.size = size;
     }
 
+    /**
+     * Source represents the source of current rules
+     */
     @JsonProperty("source")
     public String getSource() {
         return source;
     }
 
+    /**
+     * Source represents the source of current rules
+     */
     @JsonProperty("source")
     public void setSource(String source) {
         this.source = source;
     }
 
+    /**
+     * IOChaosAction defines a possible action of IOChaos
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * IOChaosAction defines a possible action of IOChaos
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * IOChaosAction defines a possible action of IOChaos
+     */
     @JsonProperty("uid")
     public Long getUid() {
         return uid;
     }
 
+    /**
+     * IOChaosAction defines a possible action of IOChaos
+     */
     @JsonProperty("uid")
     public void setUid(Long uid) {
         this.uid = uid;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/IOChaosList.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/IOChaosList.java
index e9eb2ac6d3f..716bb5cdf8f 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/IOChaosList.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/IOChaosList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IOChaosList contains a list of IOChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class IOChaosList implements Editable<IOChaosListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.chaosmesh.v1alpha1.IOChaos>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.chaosmesh.v1alpha1.IOChaos> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "IOChaosList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public IOChaosList(String apiVersion, List<io.fabric8.chaosmesh.v1alpha1.IOChaos
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * IOChaosList contains a list of IOChaos
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.chaosmesh.v1alpha1.IOChaos> getItems() {
         return items;
     }
 
+    /**
+     * IOChaosList contains a list of IOChaos
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.chaosmesh.v1alpha1.IOChaos> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * IOChaosList contains a list of IOChaos
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * IOChaosList contains a list of IOChaos
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/IOChaosSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/IOChaosSpec.java
index b891de3ddbc..c3ee3c084bf 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/IOChaosSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/IOChaosSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IOChaosSpec defines the desired state of IOChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -138,153 +141,243 @@ public IOChaosSpec(String action, AttrOverrideSpec attr, List<String> containerN
         this.volumePath = volumePath;
     }
 
+    /**
+     * Action defines the specific pod chaos action. Supported action: latency / fault / attrOverride / mistake
+     */
     @JsonProperty("action")
     public String getAction() {
         return action;
     }
 
+    /**
+     * Action defines the specific pod chaos action. Supported action: latency / fault / attrOverride / mistake
+     */
     @JsonProperty("action")
     public void setAction(String action) {
         this.action = action;
     }
 
+    /**
+     * IOChaosSpec defines the desired state of IOChaos
+     */
     @JsonProperty("attr")
     public AttrOverrideSpec getAttr() {
         return attr;
     }
 
+    /**
+     * IOChaosSpec defines the desired state of IOChaos
+     */
     @JsonProperty("attr")
     public void setAttr(AttrOverrideSpec attr) {
         this.attr = attr;
     }
 
+    /**
+     * ContainerNames indicates list of the name of affected container. If not set, the first container will be injected
+     */
     @JsonProperty("containerNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getContainerNames() {
         return containerNames;
     }
 
+    /**
+     * ContainerNames indicates list of the name of affected container. If not set, the first container will be injected
+     */
     @JsonProperty("containerNames")
     public void setContainerNames(List<String> containerNames) {
         this.containerNames = containerNames;
     }
 
+    /**
+     * Delay defines the value of I/O chaos action delay. A delay string is a possibly signed sequence of decimal numbers, each with optional fraction and a unit suffix, such as "300ms". Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h".
+     */
     @JsonProperty("delay")
     public String getDelay() {
         return delay;
     }
 
+    /**
+     * Delay defines the value of I/O chaos action delay. A delay string is a possibly signed sequence of decimal numbers, each with optional fraction and a unit suffix, such as "300ms". Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h".
+     */
     @JsonProperty("delay")
     public void setDelay(String delay) {
         this.delay = delay;
     }
 
+    /**
+     * Duration represents the duration of the chaos action. It is required when the action is `PodFailureAction`. A duration string is a possibly signed sequence of decimal numbers, each with optional fraction and a unit suffix, such as "300ms", "-1.5h" or "2h45m". Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h".
+     */
     @JsonProperty("duration")
     public String getDuration() {
         return duration;
     }
 
+    /**
+     * Duration represents the duration of the chaos action. It is required when the action is `PodFailureAction`. A duration string is a possibly signed sequence of decimal numbers, each with optional fraction and a unit suffix, such as "300ms", "-1.5h" or "2h45m". Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h".
+     */
     @JsonProperty("duration")
     public void setDuration(String duration) {
         this.duration = duration;
     }
 
+    /**
+     * Errno defines the error code that returned by I/O action. refer to: https://www-numi.fnal.gov/offline_software/srt_public_context/WebDocs/Errors/unix_system_errors.html
+     */
     @JsonProperty("errno")
     public Long getErrno() {
         return errno;
     }
 
+    /**
+     * Errno defines the error code that returned by I/O action. refer to: https://www-numi.fnal.gov/offline_software/srt_public_context/WebDocs/Errors/unix_system_errors.html
+     */
     @JsonProperty("errno")
     public void setErrno(Long errno) {
         this.errno = errno;
     }
 
+    /**
+     * Methods defines the I/O methods for injecting I/O chaos action. default: all I/O methods.
+     */
     @JsonProperty("methods")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMethods() {
         return methods;
     }
 
+    /**
+     * Methods defines the I/O methods for injecting I/O chaos action. default: all I/O methods.
+     */
     @JsonProperty("methods")
     public void setMethods(List<String> methods) {
         this.methods = methods;
     }
 
+    /**
+     * IOChaosSpec defines the desired state of IOChaos
+     */
     @JsonProperty("mistake")
     public MistakeSpec getMistake() {
         return mistake;
     }
 
+    /**
+     * IOChaosSpec defines the desired state of IOChaos
+     */
     @JsonProperty("mistake")
     public void setMistake(MistakeSpec mistake) {
         this.mistake = mistake;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
     }
 
+    /**
+     * Path defines the path of files for injecting I/O chaos action.
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Path defines the path of files for injecting I/O chaos action.
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * Percent defines the percentage of injection errors and provides a number from 0-100. default: 100.
+     */
     @JsonProperty("percent")
     public Integer getPercent() {
         return percent;
     }
 
+    /**
+     * Percent defines the percentage of injection errors and provides a number from 0-100. default: 100.
+     */
     @JsonProperty("percent")
     public void setPercent(Integer percent) {
         this.percent = percent;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public String getRemoteCluster() {
         return remoteCluster;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public void setRemoteCluster(String remoteCluster) {
         this.remoteCluster = remoteCluster;
     }
 
+    /**
+     * IOChaosSpec defines the desired state of IOChaos
+     */
     @JsonProperty("selector")
     public PodSelectorSpec getSelector() {
         return selector;
     }
 
+    /**
+     * IOChaosSpec defines the desired state of IOChaos
+     */
     @JsonProperty("selector")
     public void setSelector(PodSelectorSpec selector) {
         this.selector = selector;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of pods to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of pods the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of pods to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of pods the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
     }
 
+    /**
+     * VolumePath represents the mount path of injected volume
+     */
     @JsonProperty("volumePath")
     public String getVolumePath() {
         return volumePath;
     }
 
+    /**
+     * VolumePath represents the mount path of injected volume
+     */
     @JsonProperty("volumePath")
     public void setVolumePath(String volumePath) {
         this.volumePath = volumePath;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/IOChaosStatus.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/IOChaosStatus.java
index c687d56d251..8b7172a9120 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/IOChaosStatus.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/IOChaosStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IOChaosStatus defines the observed state of IOChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public IOChaosStatus(List<ChaosCondition> conditions, ExperimentStatus experimen
         this.instances = instances;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ChaosCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ChaosCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * IOChaosStatus defines the observed state of IOChaos
+     */
     @JsonProperty("experiment")
     public ExperimentStatus getExperiment() {
         return experiment;
     }
 
+    /**
+     * IOChaosStatus defines the observed state of IOChaos
+     */
     @JsonProperty("experiment")
     public void setExperiment(ExperimentStatus experiment) {
         this.experiment = experiment;
     }
 
+    /**
+     * Instances always specifies podiochaos generation or empty
+     */
     @JsonProperty("instances")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Long> getInstances() {
         return instances;
     }
 
+    /**
+     * Instances always specifies podiochaos generation or empty
+     */
     @JsonProperty("instances")
     public void setInstances(Map<String, Long> instances) {
         this.instances = instances;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/IoFault.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/IoFault.java
index b3536dad669..002e44eac7a 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/IoFault.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/IoFault.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IoFault represents the fault to inject and their weight
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public IoFault(Long errno, Integer weight) {
         this.weight = weight;
     }
 
+    /**
+     * IoFault represents the fault to inject and their weight
+     */
     @JsonProperty("errno")
     public Long getErrno() {
         return errno;
     }
 
+    /**
+     * IoFault represents the fault to inject and their weight
+     */
     @JsonProperty("errno")
     public void setErrno(Long errno) {
         this.errno = errno;
     }
 
+    /**
+     * IoFault represents the fault to inject and their weight
+     */
     @JsonProperty("weight")
     public Integer getWeight() {
         return weight;
     }
 
+    /**
+     * IoFault represents the fault to inject and their weight
+     */
     @JsonProperty("weight")
     public void setWeight(Integer weight) {
         this.weight = weight;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMChaos.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMChaos.java
index ba3e95034cd..12f86567402 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMChaos.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMChaos.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JVMChaos is the Schema for the jvmchaos API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class JVMChaos implements Editable<JVMChaosBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "JVMChaos";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public JVMChaos(String apiVersion, String kind, ObjectMeta metadata, JVMChaosSpe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * JVMChaos is the Schema for the jvmchaos API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * JVMChaos is the Schema for the jvmchaos API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * JVMChaos is the Schema for the jvmchaos API
+     */
     @JsonProperty("spec")
     public JVMChaosSpec getSpec() {
         return spec;
     }
 
+    /**
+     * JVMChaos is the Schema for the jvmchaos API
+     */
     @JsonProperty("spec")
     public void setSpec(JVMChaosSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * JVMChaos is the Schema for the jvmchaos API
+     */
     @JsonProperty("status")
     public JVMChaosStatus getStatus() {
         return status;
     }
 
+    /**
+     * JVMChaos is the Schema for the jvmchaos API
+     */
     @JsonProperty("status")
     public void setStatus(JVMChaosStatus status) {
         this.status = status;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMChaosList.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMChaosList.java
index 22bbdd8ffc6..60f163548b7 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMChaosList.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMChaosList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JVMChaosList contains a list of JVMChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class JVMChaosList implements Editable<JVMChaosListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.chaosmesh.v1alpha1.JVMChaos>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.chaosmesh.v1alpha1.JVMChaos> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "JVMChaosList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public JVMChaosList(String apiVersion, List<io.fabric8.chaosmesh.v1alpha1.JVMCha
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * JVMChaosList contains a list of JVMChaos
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.chaosmesh.v1alpha1.JVMChaos> getItems() {
         return items;
     }
 
+    /**
+     * JVMChaosList contains a list of JVMChaos
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.chaosmesh.v1alpha1.JVMChaos> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * JVMChaosList contains a list of JVMChaos
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * JVMChaosList contains a list of JVMChaos
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMChaosSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMChaosSpec.java
index c0f0e6daa43..b52da764e5a 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMChaosSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMChaosSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JVMChaosSpec defines the desired state of JVMChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -165,222 +168,354 @@ public JVMChaosSpec(String action, String className, List<String> containerNames
         this.value = value;
     }
 
+    /**
+     * Action defines the specific jvm chaos action. Supported action: latency;return;exception;stress;gc;ruleData
+     */
     @JsonProperty("action")
     public String getAction() {
         return action;
     }
 
+    /**
+     * Action defines the specific jvm chaos action. Supported action: latency;return;exception;stress;gc;ruleData
+     */
     @JsonProperty("action")
     public void setAction(String action) {
         this.action = action;
     }
 
+    /**
+     * Java class
+     */
     @JsonProperty("class")
     public String getClassName() {
         return className;
     }
 
+    /**
+     * Java class
+     */
     @JsonProperty("class")
     public void setClassName(String className) {
         this.className = className;
     }
 
+    /**
+     * ContainerNames indicates list of the name of affected container. If not set, the first container will be injected
+     */
     @JsonProperty("containerNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getContainerNames() {
         return containerNames;
     }
 
+    /**
+     * ContainerNames indicates list of the name of affected container. If not set, the first container will be injected
+     */
     @JsonProperty("containerNames")
     public void setContainerNames(List<String> containerNames) {
         this.containerNames = containerNames;
     }
 
+    /**
+     * the CPU core number needs to use, only set it when action is stress
+     */
     @JsonProperty("cpuCount")
     public Integer getCpuCount() {
         return cpuCount;
     }
 
+    /**
+     * the CPU core number needs to use, only set it when action is stress
+     */
     @JsonProperty("cpuCount")
     public void setCpuCount(Integer cpuCount) {
         this.cpuCount = cpuCount;
     }
 
+    /**
+     * the match database default value is "", means match all database
+     */
     @JsonProperty("database")
     public String getDatabase() {
         return database;
     }
 
+    /**
+     * the match database default value is "", means match all database
+     */
     @JsonProperty("database")
     public void setDatabase(String database) {
         this.database = database;
     }
 
+    /**
+     * Duration represents the duration of the chaos action
+     */
     @JsonProperty("duration")
     public String getDuration() {
         return duration;
     }
 
+    /**
+     * Duration represents the duration of the chaos action
+     */
     @JsonProperty("duration")
     public void setDuration(String duration) {
         this.duration = duration;
     }
 
+    /**
+     * the exception which needs to throw for action `exception` or the exception message needs to throw in action `mysql`
+     */
     @JsonProperty("exception")
     public String getException() {
         return exception;
     }
 
+    /**
+     * the exception which needs to throw for action `exception` or the exception message needs to throw in action `mysql`
+     */
     @JsonProperty("exception")
     public void setException(String exception) {
         this.exception = exception;
     }
 
+    /**
+     * the latency duration for action 'latency', unit ms or the latency duration in action `mysql`
+     */
     @JsonProperty("latency")
     public Integer getLatency() {
         return latency;
     }
 
+    /**
+     * the latency duration for action 'latency', unit ms or the latency duration in action `mysql`
+     */
     @JsonProperty("latency")
     public void setLatency(Integer latency) {
         this.latency = latency;
     }
 
+    /**
+     * the memory type needs to locate, only set it when action is stress, the value can be 'stack' or 'heap'
+     */
     @JsonProperty("memType")
     public String getMemType() {
         return memType;
     }
 
+    /**
+     * the memory type needs to locate, only set it when action is stress, the value can be 'stack' or 'heap'
+     */
     @JsonProperty("memType")
     public void setMemType(String memType) {
         this.memType = memType;
     }
 
+    /**
+     * the method in Java class
+     */
     @JsonProperty("method")
     public String getMethod() {
         return method;
     }
 
+    /**
+     * the method in Java class
+     */
     @JsonProperty("method")
     public void setMethod(String method) {
         this.method = method;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
     }
 
+    /**
+     * the version of mysql-connector-java, only support 5.X.X(set to "5") and 8.X.X(set to "8") now
+     */
     @JsonProperty("mysqlConnectorVersion")
     public String getMysqlConnectorVersion() {
         return mysqlConnectorVersion;
     }
 
+    /**
+     * the version of mysql-connector-java, only support 5.X.X(set to "5") and 8.X.X(set to "8") now
+     */
     @JsonProperty("mysqlConnectorVersion")
     public void setMysqlConnectorVersion(String mysqlConnectorVersion) {
         this.mysqlConnectorVersion = mysqlConnectorVersion;
     }
 
+    /**
+     * byteman rule name, should be unique, and will generate one if not set
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * byteman rule name, should be unique, and will generate one if not set
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * the pid of Java process which needs to attach
+     */
     @JsonProperty("pid")
     public Integer getPid() {
         return pid;
     }
 
+    /**
+     * the pid of Java process which needs to attach
+     */
     @JsonProperty("pid")
     public void setPid(Integer pid) {
         this.pid = pid;
     }
 
+    /**
+     * the port of agent server, default 9277
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * the port of agent server, default 9277
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public String getRemoteCluster() {
         return remoteCluster;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public void setRemoteCluster(String remoteCluster) {
         this.remoteCluster = remoteCluster;
     }
 
+    /**
+     * the return value for action 'return'
+     */
     @JsonProperty("returnValue")
     public String getReturnValue() {
         return returnValue;
     }
 
+    /**
+     * the return value for action 'return'
+     */
     @JsonProperty("returnValue")
     public void setReturnValue(String returnValue) {
         this.returnValue = returnValue;
     }
 
+    /**
+     * the byteman rule's data for action 'ruleData'
+     */
     @JsonProperty("ruleData")
     public String getRuleData() {
         return ruleData;
     }
 
+    /**
+     * the byteman rule's data for action 'ruleData'
+     */
     @JsonProperty("ruleData")
     public void setRuleData(String ruleData) {
         this.ruleData = ruleData;
     }
 
+    /**
+     * JVMChaosSpec defines the desired state of JVMChaos
+     */
     @JsonProperty("selector")
     public PodSelectorSpec getSelector() {
         return selector;
     }
 
+    /**
+     * JVMChaosSpec defines the desired state of JVMChaos
+     */
     @JsonProperty("selector")
     public void setSelector(PodSelectorSpec selector) {
         this.selector = selector;
     }
 
+    /**
+     * the match sql type default value is "", means match all SQL type. The value can be 'select', 'insert', 'update', 'delete', 'replace'.
+     */
     @JsonProperty("sqlType")
     public String getSqlType() {
         return sqlType;
     }
 
+    /**
+     * the match sql type default value is "", means match all SQL type. The value can be 'select', 'insert', 'update', 'delete', 'replace'.
+     */
     @JsonProperty("sqlType")
     public void setSqlType(String sqlType) {
         this.sqlType = sqlType;
     }
 
+    /**
+     * the match table default value is "", means match all table
+     */
     @JsonProperty("table")
     public String getTable() {
         return table;
     }
 
+    /**
+     * the match table default value is "", means match all table
+     */
     @JsonProperty("table")
     public void setTable(String table) {
         this.table = table;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of pods to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of pods the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of pods to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of pods the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMChaosStatus.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMChaosStatus.java
index 2c8e814ace6..81eee069169 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMChaosStatus.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMChaosStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JVMChaosStatus defines the observed state of JVMChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public JVMChaosStatus(List<ChaosCondition> conditions, ExperimentStatus experime
         this.experiment = experiment;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ChaosCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ChaosCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * JVMChaosStatus defines the observed state of JVMChaos
+     */
     @JsonProperty("experiment")
     public ExperimentStatus getExperiment() {
         return experiment;
     }
 
+    /**
+     * JVMChaosStatus defines the observed state of JVMChaos
+     */
     @JsonProperty("experiment")
     public void setExperiment(ExperimentStatus experiment) {
         this.experiment = experiment;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMClassMethodSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMClassMethodSpec.java
index c9598d63437..a59a18a2186 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMClassMethodSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMClassMethodSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JVMClassMethodSpec is the specification for class and method
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public JVMClassMethodSpec(String className, String method) {
         this.method = method;
     }
 
+    /**
+     * Java class
+     */
     @JsonProperty("class")
     public String getClassName() {
         return className;
     }
 
+    /**
+     * Java class
+     */
     @JsonProperty("class")
     public void setClassName(String className) {
         this.className = className;
     }
 
+    /**
+     * the method in Java class
+     */
     @JsonProperty("method")
     public String getMethod() {
         return method;
     }
 
+    /**
+     * the method in Java class
+     */
     @JsonProperty("method")
     public void setMethod(String method) {
         this.method = method;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMCommonSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMCommonSpec.java
index 9299e3f1535..5bc85011ffc 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMCommonSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMCommonSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JVMCommonSpec is the common specification for JVMChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public JVMCommonSpec(Integer pid, Integer port) {
         this.port = port;
     }
 
+    /**
+     * the pid of Java process which needs to attach
+     */
     @JsonProperty("pid")
     public Integer getPid() {
         return pid;
     }
 
+    /**
+     * the pid of Java process which needs to attach
+     */
     @JsonProperty("pid")
     public void setPid(Integer pid) {
         this.pid = pid;
     }
 
+    /**
+     * the port of agent server, default 9277
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * the port of agent server, default 9277
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMExceptionSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMExceptionSpec.java
index 4c6cf2cd913..04391764e50 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMExceptionSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMExceptionSpec.java
@@ -94,51 +94,81 @@ public JVMExceptionSpec(String className, String exception, String method, Integ
         this.port = port;
     }
 
+    /**
+     * Java class
+     */
     @JsonProperty("class")
     public String getClassName() {
         return className;
     }
 
+    /**
+     * Java class
+     */
     @JsonProperty("class")
     public void setClassName(String className) {
         this.className = className;
     }
 
+    /**
+     * the exception which needs to throw for action `exception`
+     */
     @JsonProperty("exception")
     public String getException() {
         return exception;
     }
 
+    /**
+     * the exception which needs to throw for action `exception`
+     */
     @JsonProperty("exception")
     public void setException(String exception) {
         this.exception = exception;
     }
 
+    /**
+     * the method in Java class
+     */
     @JsonProperty("method")
     public String getMethod() {
         return method;
     }
 
+    /**
+     * the method in Java class
+     */
     @JsonProperty("method")
     public void setMethod(String method) {
         this.method = method;
     }
 
+    /**
+     * the pid of Java process which needs to attach
+     */
     @JsonProperty("pid")
     public Integer getPid() {
         return pid;
     }
 
+    /**
+     * the pid of Java process which needs to attach
+     */
     @JsonProperty("pid")
     public void setPid(Integer pid) {
         this.pid = pid;
     }
 
+    /**
+     * the port of agent server, default 9277
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * the port of agent server, default 9277
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMGCSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMGCSpec.java
index 02416c5276e..90e4105988b 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMGCSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMGCSpec.java
@@ -82,21 +82,33 @@ public JVMGCSpec(Integer pid, Integer port) {
         this.port = port;
     }
 
+    /**
+     * the pid of Java process which needs to attach
+     */
     @JsonProperty("pid")
     public Integer getPid() {
         return pid;
     }
 
+    /**
+     * the pid of Java process which needs to attach
+     */
     @JsonProperty("pid")
     public void setPid(Integer pid) {
         this.pid = pid;
     }
 
+    /**
+     * the port of agent server, default 9277
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * the port of agent server, default 9277
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMLatencySpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMLatencySpec.java
index 20344b12133..a91049aec7d 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMLatencySpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMLatencySpec.java
@@ -94,51 +94,81 @@ public JVMLatencySpec(String className, Integer latency, String method, Integer
         this.port = port;
     }
 
+    /**
+     * Java class
+     */
     @JsonProperty("class")
     public String getClassName() {
         return className;
     }
 
+    /**
+     * Java class
+     */
     @JsonProperty("class")
     public void setClassName(String className) {
         this.className = className;
     }
 
+    /**
+     * the latency duration for action 'latency', unit ms
+     */
     @JsonProperty("latency")
     public Integer getLatency() {
         return latency;
     }
 
+    /**
+     * the latency duration for action 'latency', unit ms
+     */
     @JsonProperty("latency")
     public void setLatency(Integer latency) {
         this.latency = latency;
     }
 
+    /**
+     * the method in Java class
+     */
     @JsonProperty("method")
     public String getMethod() {
         return method;
     }
 
+    /**
+     * the method in Java class
+     */
     @JsonProperty("method")
     public void setMethod(String method) {
         this.method = method;
     }
 
+    /**
+     * the pid of Java process which needs to attach
+     */
     @JsonProperty("pid")
     public Integer getPid() {
         return pid;
     }
 
+    /**
+     * the pid of Java process which needs to attach
+     */
     @JsonProperty("pid")
     public void setPid(Integer pid) {
         this.pid = pid;
     }
 
+    /**
+     * the port of agent server, default 9277
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * the port of agent server, default 9277
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMMySQLSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMMySQLSpec.java
index 3137f719140..7b01a86845d 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMMySQLSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMMySQLSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JVMMySQLSpec is the specification of MySQL fault injection in JVM only when SQL match the Database, Table and SQLType, JVMChaos mesh will inject fault for examle:<br><p> <br><p> 	SQL is "select &#42; from test.t1",<br><p> 	only when ((Database == "test" || Database == "") &amp;&amp; (Table == "t1" || Table == "") &amp;&amp; (SQLType == "select" || SQLType == "")) is true, JVMChaos will inject fault
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public JVMMySQLSpec(String database, String mysqlConnectorVersion, String sqlTyp
         this.table = table;
     }
 
+    /**
+     * the match database default value is "", means match all database
+     */
     @JsonProperty("database")
     public String getDatabase() {
         return database;
     }
 
+    /**
+     * the match database default value is "", means match all database
+     */
     @JsonProperty("database")
     public void setDatabase(String database) {
         this.database = database;
     }
 
+    /**
+     * the version of mysql-connector-java, only support 5.X.X(set to "5") and 8.X.X(set to "8") now
+     */
     @JsonProperty("mysqlConnectorVersion")
     public String getMysqlConnectorVersion() {
         return mysqlConnectorVersion;
     }
 
+    /**
+     * the version of mysql-connector-java, only support 5.X.X(set to "5") and 8.X.X(set to "8") now
+     */
     @JsonProperty("mysqlConnectorVersion")
     public void setMysqlConnectorVersion(String mysqlConnectorVersion) {
         this.mysqlConnectorVersion = mysqlConnectorVersion;
     }
 
+    /**
+     * the match sql type default value is "", means match all SQL type. The value can be 'select', 'insert', 'update', 'delete', 'replace'.
+     */
     @JsonProperty("sqlType")
     public String getSqlType() {
         return sqlType;
     }
 
+    /**
+     * the match sql type default value is "", means match all SQL type. The value can be 'select', 'insert', 'update', 'delete', 'replace'.
+     */
     @JsonProperty("sqlType")
     public void setSqlType(String sqlType) {
         this.sqlType = sqlType;
     }
 
+    /**
+     * the match table default value is "", means match all table
+     */
     @JsonProperty("table")
     public String getTable() {
         return table;
     }
 
+    /**
+     * the match table default value is "", means match all table
+     */
     @JsonProperty("table")
     public void setTable(String table) {
         this.table = table;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMParameter.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMParameter.java
index 0949ad61492..9db03e6556d 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMParameter.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMParameter.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JVMParameter represents the detail about jvm chaos action definition
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -134,151 +137,241 @@ public JVMParameter(String className, Integer cpuCount, String database, String
         this.table = table;
     }
 
+    /**
+     * Java class
+     */
     @JsonProperty("class")
     public String getClassName() {
         return className;
     }
 
+    /**
+     * Java class
+     */
     @JsonProperty("class")
     public void setClassName(String className) {
         this.className = className;
     }
 
+    /**
+     * the CPU core number needs to use, only set it when action is stress
+     */
     @JsonProperty("cpuCount")
     public Integer getCpuCount() {
         return cpuCount;
     }
 
+    /**
+     * the CPU core number needs to use, only set it when action is stress
+     */
     @JsonProperty("cpuCount")
     public void setCpuCount(Integer cpuCount) {
         this.cpuCount = cpuCount;
     }
 
+    /**
+     * the match database default value is "", means match all database
+     */
     @JsonProperty("database")
     public String getDatabase() {
         return database;
     }
 
+    /**
+     * the match database default value is "", means match all database
+     */
     @JsonProperty("database")
     public void setDatabase(String database) {
         this.database = database;
     }
 
+    /**
+     * the exception which needs to throw for action `exception` or the exception message needs to throw in action `mysql`
+     */
     @JsonProperty("exception")
     public String getException() {
         return exception;
     }
 
+    /**
+     * the exception which needs to throw for action `exception` or the exception message needs to throw in action `mysql`
+     */
     @JsonProperty("exception")
     public void setException(String exception) {
         this.exception = exception;
     }
 
+    /**
+     * the latency duration for action 'latency', unit ms or the latency duration in action `mysql`
+     */
     @JsonProperty("latency")
     public Integer getLatency() {
         return latency;
     }
 
+    /**
+     * the latency duration for action 'latency', unit ms or the latency duration in action `mysql`
+     */
     @JsonProperty("latency")
     public void setLatency(Integer latency) {
         this.latency = latency;
     }
 
+    /**
+     * the memory type needs to locate, only set it when action is stress, the value can be 'stack' or 'heap'
+     */
     @JsonProperty("memType")
     public String getMemType() {
         return memType;
     }
 
+    /**
+     * the memory type needs to locate, only set it when action is stress, the value can be 'stack' or 'heap'
+     */
     @JsonProperty("memType")
     public void setMemType(String memType) {
         this.memType = memType;
     }
 
+    /**
+     * the method in Java class
+     */
     @JsonProperty("method")
     public String getMethod() {
         return method;
     }
 
+    /**
+     * the method in Java class
+     */
     @JsonProperty("method")
     public void setMethod(String method) {
         this.method = method;
     }
 
+    /**
+     * the version of mysql-connector-java, only support 5.X.X(set to "5") and 8.X.X(set to "8") now
+     */
     @JsonProperty("mysqlConnectorVersion")
     public String getMysqlConnectorVersion() {
         return mysqlConnectorVersion;
     }
 
+    /**
+     * the version of mysql-connector-java, only support 5.X.X(set to "5") and 8.X.X(set to "8") now
+     */
     @JsonProperty("mysqlConnectorVersion")
     public void setMysqlConnectorVersion(String mysqlConnectorVersion) {
         this.mysqlConnectorVersion = mysqlConnectorVersion;
     }
 
+    /**
+     * byteman rule name, should be unique, and will generate one if not set
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * byteman rule name, should be unique, and will generate one if not set
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * the pid of Java process which needs to attach
+     */
     @JsonProperty("pid")
     public Integer getPid() {
         return pid;
     }
 
+    /**
+     * the pid of Java process which needs to attach
+     */
     @JsonProperty("pid")
     public void setPid(Integer pid) {
         this.pid = pid;
     }
 
+    /**
+     * the port of agent server, default 9277
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * the port of agent server, default 9277
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * the return value for action 'return'
+     */
     @JsonProperty("returnValue")
     public String getReturnValue() {
         return returnValue;
     }
 
+    /**
+     * the return value for action 'return'
+     */
     @JsonProperty("returnValue")
     public void setReturnValue(String returnValue) {
         this.returnValue = returnValue;
     }
 
+    /**
+     * the byteman rule's data for action 'ruleData'
+     */
     @JsonProperty("ruleData")
     public String getRuleData() {
         return ruleData;
     }
 
+    /**
+     * the byteman rule's data for action 'ruleData'
+     */
     @JsonProperty("ruleData")
     public void setRuleData(String ruleData) {
         this.ruleData = ruleData;
     }
 
+    /**
+     * the match sql type default value is "", means match all SQL type. The value can be 'select', 'insert', 'update', 'delete', 'replace'.
+     */
     @JsonProperty("sqlType")
     public String getSqlType() {
         return sqlType;
     }
 
+    /**
+     * the match sql type default value is "", means match all SQL type. The value can be 'select', 'insert', 'update', 'delete', 'replace'.
+     */
     @JsonProperty("sqlType")
     public void setSqlType(String sqlType) {
         this.sqlType = sqlType;
     }
 
+    /**
+     * the match table default value is "", means match all table
+     */
     @JsonProperty("table")
     public String getTable() {
         return table;
     }
 
+    /**
+     * the match table default value is "", means match all table
+     */
     @JsonProperty("table")
     public void setTable(String table) {
         this.table = table;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMReturnSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMReturnSpec.java
index 76772311281..60269a6fbc2 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMReturnSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMReturnSpec.java
@@ -94,51 +94,81 @@ public JVMReturnSpec(String className, String method, Integer pid, Integer port,
         this.value = value;
     }
 
+    /**
+     * Java class
+     */
     @JsonProperty("class")
     public String getClassName() {
         return className;
     }
 
+    /**
+     * Java class
+     */
     @JsonProperty("class")
     public void setClassName(String className) {
         this.className = className;
     }
 
+    /**
+     * the method in Java class
+     */
     @JsonProperty("method")
     public String getMethod() {
         return method;
     }
 
+    /**
+     * the method in Java class
+     */
     @JsonProperty("method")
     public void setMethod(String method) {
         this.method = method;
     }
 
+    /**
+     * the pid of Java process which needs to attach
+     */
     @JsonProperty("pid")
     public Integer getPid() {
         return pid;
     }
 
+    /**
+     * the pid of Java process which needs to attach
+     */
     @JsonProperty("pid")
     public void setPid(Integer pid) {
         this.pid = pid;
     }
 
+    /**
+     * the port of agent server, default 9277
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * the port of agent server, default 9277
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * the return value for action 'return'
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * the return value for action 'return'
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMRuleDataSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMRuleDataSpec.java
index 659d3a4e8ef..8dc38f6894c 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMRuleDataSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMRuleDataSpec.java
@@ -86,31 +86,49 @@ public JVMRuleDataSpec(Integer pid, Integer port, String ruleData) {
         this.ruleData = ruleData;
     }
 
+    /**
+     * the pid of Java process which needs to attach
+     */
     @JsonProperty("pid")
     public Integer getPid() {
         return pid;
     }
 
+    /**
+     * the pid of Java process which needs to attach
+     */
     @JsonProperty("pid")
     public void setPid(Integer pid) {
         this.pid = pid;
     }
 
+    /**
+     * the port of agent server, default 9277
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * the port of agent server, default 9277
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * RuleData used to save the rule file's data, will use it when recover
+     */
     @JsonProperty("rule-data")
     public String getRuleData() {
         return ruleData;
     }
 
+    /**
+     * RuleData used to save the rule file's data, will use it when recover
+     */
     @JsonProperty("rule-data")
     public void setRuleData(String ruleData) {
         this.ruleData = ruleData;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMStressCfgSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMStressCfgSpec.java
index 7665f7e7a2d..cc4f14a00fc 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMStressCfgSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMStressCfgSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JVMStressSpec is the specification for stress
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public JVMStressCfgSpec(Integer cpuCount, String memType) {
         this.memType = memType;
     }
 
+    /**
+     * the CPU core number needs to use, only set it when action is stress
+     */
     @JsonProperty("cpuCount")
     public Integer getCpuCount() {
         return cpuCount;
     }
 
+    /**
+     * the CPU core number needs to use, only set it when action is stress
+     */
     @JsonProperty("cpuCount")
     public void setCpuCount(Integer cpuCount) {
         this.cpuCount = cpuCount;
     }
 
+    /**
+     * the memory type needs to locate, only set it when action is stress, the value can be 'stack' or 'heap'
+     */
     @JsonProperty("memType")
     public String getMemType() {
         return memType;
     }
 
+    /**
+     * the memory type needs to locate, only set it when action is stress, the value can be 'stack' or 'heap'
+     */
     @JsonProperty("memType")
     public void setMemType(String memType) {
         this.memType = memType;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMStressSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMStressSpec.java
index 43061ab1604..dee92db691c 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMStressSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/JVMStressSpec.java
@@ -90,41 +90,65 @@ public JVMStressSpec(Integer cpuCount, String memType, Integer pid, Integer port
         this.port = port;
     }
 
+    /**
+     * the CPU core number need to use, only set it when action is stress
+     */
     @JsonProperty("cpu-count")
     public Integer getCpuCount() {
         return cpuCount;
     }
 
+    /**
+     * the CPU core number need to use, only set it when action is stress
+     */
     @JsonProperty("cpu-count")
     public void setCpuCount(Integer cpuCount) {
         this.cpuCount = cpuCount;
     }
 
+    /**
+     * the memory type need to locate, only set it when action is stress, the value can be 'stack' or 'heap'
+     */
     @JsonProperty("mem-type")
     public String getMemType() {
         return memType;
     }
 
+    /**
+     * the memory type need to locate, only set it when action is stress, the value can be 'stack' or 'heap'
+     */
     @JsonProperty("mem-type")
     public void setMemType(String memType) {
         this.memType = memType;
     }
 
+    /**
+     * the pid of Java process which needs to attach
+     */
     @JsonProperty("pid")
     public Integer getPid() {
         return pid;
     }
 
+    /**
+     * the pid of Java process which needs to attach
+     */
     @JsonProperty("pid")
     public void setPid(Integer pid) {
         this.pid = pid;
     }
 
+    /**
+     * the port of agent server, default 9277
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * the port of agent server, default 9277
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KafkaCommonSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KafkaCommonSpec.java
index 174ae983465..402c3896504 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KafkaCommonSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KafkaCommonSpec.java
@@ -94,51 +94,81 @@ public KafkaCommonSpec(String host, String password, Integer port, String topic,
         this.username = username;
     }
 
+    /**
+     * The host of kafka server
+     */
     @JsonProperty("host")
     public String getHost() {
         return host;
     }
 
+    /**
+     * The host of kafka server
+     */
     @JsonProperty("host")
     public void setHost(String host) {
         this.host = host;
     }
 
+    /**
+     * The password of kafka client
+     */
     @JsonProperty("password")
     public String getPassword() {
         return password;
     }
 
+    /**
+     * The password of kafka client
+     */
     @JsonProperty("password")
     public void setPassword(String password) {
         this.password = password;
     }
 
+    /**
+     * The port of kafka server
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * The port of kafka server
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * The topic to attack
+     */
     @JsonProperty("topic")
     public String getTopic() {
         return topic;
     }
 
+    /**
+     * The topic to attack
+     */
     @JsonProperty("topic")
     public void setTopic(String topic) {
         this.topic = topic;
     }
 
+    /**
+     * The username of kafka client
+     */
     @JsonProperty("username")
     public String getUsername() {
         return username;
     }
 
+    /**
+     * The username of kafka client
+     */
     @JsonProperty("username")
     public void setUsername(String username) {
         this.username = username;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KafkaFillSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KafkaFillSpec.java
index 5ff39062126..09936a97e5f 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KafkaFillSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KafkaFillSpec.java
@@ -106,81 +106,129 @@ public KafkaFillSpec(String host, Long maxBytes, Integer messageSize, String pas
         this.username = username;
     }
 
+    /**
+     * The host of kafka server
+     */
     @JsonProperty("host")
     public String getHost() {
         return host;
     }
 
+    /**
+     * The host of kafka server
+     */
     @JsonProperty("host")
     public void setHost(String host) {
         this.host = host;
     }
 
+    /**
+     * The max bytes to fill
+     */
     @JsonProperty("maxBytes")
     public Long getMaxBytes() {
         return maxBytes;
     }
 
+    /**
+     * The max bytes to fill
+     */
     @JsonProperty("maxBytes")
     public void setMaxBytes(Long maxBytes) {
         this.maxBytes = maxBytes;
     }
 
+    /**
+     * The size of each message
+     */
     @JsonProperty("messageSize")
     public Integer getMessageSize() {
         return messageSize;
     }
 
+    /**
+     * The size of each message
+     */
     @JsonProperty("messageSize")
     public void setMessageSize(Integer messageSize) {
         this.messageSize = messageSize;
     }
 
+    /**
+     * The password of kafka client
+     */
     @JsonProperty("password")
     public String getPassword() {
         return password;
     }
 
+    /**
+     * The password of kafka client
+     */
     @JsonProperty("password")
     public void setPassword(String password) {
         this.password = password;
     }
 
+    /**
+     * The port of kafka server
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * The port of kafka server
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * The command to reload kafka config
+     */
     @JsonProperty("reloadCommand")
     public String getReloadCommand() {
         return reloadCommand;
     }
 
+    /**
+     * The command to reload kafka config
+     */
     @JsonProperty("reloadCommand")
     public void setReloadCommand(String reloadCommand) {
         this.reloadCommand = reloadCommand;
     }
 
+    /**
+     * The topic to attack
+     */
     @JsonProperty("topic")
     public String getTopic() {
         return topic;
     }
 
+    /**
+     * The topic to attack
+     */
     @JsonProperty("topic")
     public void setTopic(String topic) {
         this.topic = topic;
     }
 
+    /**
+     * The username of kafka client
+     */
     @JsonProperty("username")
     public String getUsername() {
         return username;
     }
 
+    /**
+     * The username of kafka client
+     */
     @JsonProperty("username")
     public void setUsername(String username) {
         this.username = username;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KafkaFloodSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KafkaFloodSpec.java
index 4f20b0e752a..f8225319aad 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KafkaFloodSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KafkaFloodSpec.java
@@ -102,71 +102,113 @@ public KafkaFloodSpec(String host, Integer messageSize, String password, Integer
         this.username = username;
     }
 
+    /**
+     * The host of kafka server
+     */
     @JsonProperty("host")
     public String getHost() {
         return host;
     }
 
+    /**
+     * The host of kafka server
+     */
     @JsonProperty("host")
     public void setHost(String host) {
         this.host = host;
     }
 
+    /**
+     * The size of each message
+     */
     @JsonProperty("messageSize")
     public Integer getMessageSize() {
         return messageSize;
     }
 
+    /**
+     * The size of each message
+     */
     @JsonProperty("messageSize")
     public void setMessageSize(Integer messageSize) {
         this.messageSize = messageSize;
     }
 
+    /**
+     * The password of kafka client
+     */
     @JsonProperty("password")
     public String getPassword() {
         return password;
     }
 
+    /**
+     * The password of kafka client
+     */
     @JsonProperty("password")
     public void setPassword(String password) {
         this.password = password;
     }
 
+    /**
+     * The port of kafka server
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * The port of kafka server
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * The number of worker threads
+     */
     @JsonProperty("threads")
     public Integer getThreads() {
         return threads;
     }
 
+    /**
+     * The number of worker threads
+     */
     @JsonProperty("threads")
     public void setThreads(Integer threads) {
         this.threads = threads;
     }
 
+    /**
+     * The topic to attack
+     */
     @JsonProperty("topic")
     public String getTopic() {
         return topic;
     }
 
+    /**
+     * The topic to attack
+     */
     @JsonProperty("topic")
     public void setTopic(String topic) {
         this.topic = topic;
     }
 
+    /**
+     * The username of kafka client
+     */
     @JsonProperty("username")
     public String getUsername() {
         return username;
     }
 
+    /**
+     * The username of kafka client
+     */
     @JsonProperty("username")
     public void setUsername(String username) {
         this.username = username;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KafkaIOSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KafkaIOSpec.java
index e96c0300e65..75470c44021 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KafkaIOSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KafkaIOSpec.java
@@ -90,41 +90,65 @@ public KafkaIOSpec(String configFile, Boolean nonReadable, Boolean nonWritable,
         this.topic = topic;
     }
 
+    /**
+     * The path of server config
+     */
     @JsonProperty("configFile")
     public String getConfigFile() {
         return configFile;
     }
 
+    /**
+     * The path of server config
+     */
     @JsonProperty("configFile")
     public void setConfigFile(String configFile) {
         this.configFile = configFile;
     }
 
+    /**
+     * Make kafka cluster non-readable
+     */
     @JsonProperty("nonReadable")
     public Boolean getNonReadable() {
         return nonReadable;
     }
 
+    /**
+     * Make kafka cluster non-readable
+     */
     @JsonProperty("nonReadable")
     public void setNonReadable(Boolean nonReadable) {
         this.nonReadable = nonReadable;
     }
 
+    /**
+     * Make kafka cluster non-writable
+     */
     @JsonProperty("nonWritable")
     public Boolean getNonWritable() {
         return nonWritable;
     }
 
+    /**
+     * Make kafka cluster non-writable
+     */
     @JsonProperty("nonWritable")
     public void setNonWritable(Boolean nonWritable) {
         this.nonWritable = nonWritable;
     }
 
+    /**
+     * The topic to attack
+     */
     @JsonProperty("topic")
     public String getTopic() {
         return topic;
     }
 
+    /**
+     * The topic to attack
+     */
     @JsonProperty("topic")
     public void setTopic(String topic) {
         this.topic = topic;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KernelChaos.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KernelChaos.java
index 6cea052ba55..878b7209f6e 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KernelChaos.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KernelChaos.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KernelChaos is the Schema for the kernelchaos API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class KernelChaos implements Editable<KernelChaosBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KernelChaos";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public KernelChaos(String apiVersion, String kind, ObjectMeta metadata, KernelCh
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KernelChaos is the Schema for the kernelchaos API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KernelChaos is the Schema for the kernelchaos API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * KernelChaos is the Schema for the kernelchaos API
+     */
     @JsonProperty("spec")
     public KernelChaosSpec getSpec() {
         return spec;
     }
 
+    /**
+     * KernelChaos is the Schema for the kernelchaos API
+     */
     @JsonProperty("spec")
     public void setSpec(KernelChaosSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * KernelChaos is the Schema for the kernelchaos API
+     */
     @JsonProperty("status")
     public KernelChaosStatus getStatus() {
         return status;
     }
 
+    /**
+     * KernelChaos is the Schema for the kernelchaos API
+     */
     @JsonProperty("status")
     public void setStatus(KernelChaosStatus status) {
         this.status = status;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KernelChaosList.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KernelChaosList.java
index 7a7a6f4bd35..23439e257ba 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KernelChaosList.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KernelChaosList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KernelChaosList contains a list of KernelChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class KernelChaosList implements Editable<KernelChaosListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.chaosmesh.v1alpha1.KernelChaos>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.chaosmesh.v1alpha1.KernelChaos> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KernelChaosList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public KernelChaosList(String apiVersion, List<io.fabric8.chaosmesh.v1alpha1.Ker
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * KernelChaosList contains a list of KernelChaos
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.chaosmesh.v1alpha1.KernelChaos> getItems() {
         return items;
     }
 
+    /**
+     * KernelChaosList contains a list of KernelChaos
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.chaosmesh.v1alpha1.KernelChaos> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KernelChaosList contains a list of KernelChaos
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KernelChaosList contains a list of KernelChaos
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KernelChaosSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KernelChaosSpec.java
index fc175700f7e..926b6e99e8d 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KernelChaosSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KernelChaosSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KernelChaosSpec defines the desired state of KernelChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -105,72 +108,114 @@ public KernelChaosSpec(List<String> containerNames, String duration, FailKernReq
         this.value = value;
     }
 
+    /**
+     * ContainerNames indicates list of the name of affected container. If not set, the first container will be injected
+     */
     @JsonProperty("containerNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getContainerNames() {
         return containerNames;
     }
 
+    /**
+     * ContainerNames indicates list of the name of affected container. If not set, the first container will be injected
+     */
     @JsonProperty("containerNames")
     public void setContainerNames(List<String> containerNames) {
         this.containerNames = containerNames;
     }
 
+    /**
+     * Duration represents the duration of the chaos action
+     */
     @JsonProperty("duration")
     public String getDuration() {
         return duration;
     }
 
+    /**
+     * Duration represents the duration of the chaos action
+     */
     @JsonProperty("duration")
     public void setDuration(String duration) {
         this.duration = duration;
     }
 
+    /**
+     * KernelChaosSpec defines the desired state of KernelChaos
+     */
     @JsonProperty("failKernRequest")
     public FailKernRequest getFailKernRequest() {
         return failKernRequest;
     }
 
+    /**
+     * KernelChaosSpec defines the desired state of KernelChaos
+     */
     @JsonProperty("failKernRequest")
     public void setFailKernRequest(FailKernRequest failKernRequest) {
         this.failKernRequest = failKernRequest;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public String getRemoteCluster() {
         return remoteCluster;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public void setRemoteCluster(String remoteCluster) {
         this.remoteCluster = remoteCluster;
     }
 
+    /**
+     * KernelChaosSpec defines the desired state of KernelChaos
+     */
     @JsonProperty("selector")
     public PodSelectorSpec getSelector() {
         return selector;
     }
 
+    /**
+     * KernelChaosSpec defines the desired state of KernelChaos
+     */
     @JsonProperty("selector")
     public void setSelector(PodSelectorSpec selector) {
         this.selector = selector;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of pods to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of pods the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of pods to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of pods the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KernelChaosStatus.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KernelChaosStatus.java
index 8243cba1744..5d12ae93f07 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KernelChaosStatus.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/KernelChaosStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KernelChaosStatus defines the observed state of KernelChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public KernelChaosStatus(List<ChaosCondition> conditions, ExperimentStatus exper
         this.experiment = experiment;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ChaosCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ChaosCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * KernelChaosStatus defines the observed state of KernelChaos
+     */
     @JsonProperty("experiment")
     public ExperimentStatus getExperiment() {
         return experiment;
     }
 
+    /**
+     * KernelChaosStatus defines the observed state of KernelChaos
+     */
     @JsonProperty("experiment")
     public void setExperiment(ExperimentStatus experiment) {
         this.experiment = experiment;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/LossSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/LossSpec.java
index c7e8a01a4a7..d7b1df0674b 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/LossSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/LossSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LossSpec defines detail of a loss action
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public LossSpec(String correlation, String loss) {
         this.loss = loss;
     }
 
+    /**
+     * LossSpec defines detail of a loss action
+     */
     @JsonProperty("correlation")
     public String getCorrelation() {
         return correlation;
     }
 
+    /**
+     * LossSpec defines detail of a loss action
+     */
     @JsonProperty("correlation")
     public void setCorrelation(String correlation) {
         this.correlation = correlation;
     }
 
+    /**
+     * LossSpec defines detail of a loss action
+     */
     @JsonProperty("loss")
     public String getLoss() {
         return loss;
     }
 
+    /**
+     * LossSpec defines detail of a loss action
+     */
     @JsonProperty("loss")
     public void setLoss(String loss) {
         this.loss = loss;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/MemoryStressor.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/MemoryStressor.java
index 64ad1e76669..e0ecee1c442 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/MemoryStressor.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/MemoryStressor.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MemoryStressor defines how to stress memory out
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public MemoryStressor(Integer oomScoreAdj, List<String> options, String size, In
         this.workers = workers;
     }
 
+    /**
+     * OOMScoreAdj sets the oom_score_adj of the stress process. See `man 5 proc` to know more about this option.
+     */
     @JsonProperty("oomScoreAdj")
     public Integer getOomScoreAdj() {
         return oomScoreAdj;
     }
 
+    /**
+     * OOMScoreAdj sets the oom_score_adj of the stress process. See `man 5 proc` to know more about this option.
+     */
     @JsonProperty("oomScoreAdj")
     public void setOomScoreAdj(Integer oomScoreAdj) {
         this.oomScoreAdj = oomScoreAdj;
     }
 
+    /**
+     * extend stress-ng options
+     */
     @JsonProperty("options")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getOptions() {
         return options;
     }
 
+    /**
+     * extend stress-ng options
+     */
     @JsonProperty("options")
     public void setOptions(List<String> options) {
         this.options = options;
     }
 
+    /**
+     * Size specifies N bytes consumed per vm worker, default is the total available memory. One can specify the size as % of total available memory or in units of B, KB/KiB, MB/MiB, GB/GiB, TB/TiB.
+     */
     @JsonProperty("size")
     public String getSize() {
         return size;
     }
 
+    /**
+     * Size specifies N bytes consumed per vm worker, default is the total available memory. One can specify the size as % of total available memory or in units of B, KB/KiB, MB/MiB, GB/GiB, TB/TiB.
+     */
     @JsonProperty("size")
     public void setSize(String size) {
         this.size = size;
     }
 
+    /**
+     * Workers specifies N workers to apply the stressor. Maximum 8192 workers can run by stress-ng
+     */
     @JsonProperty("workers")
     public Integer getWorkers() {
         return workers;
     }
 
+    /**
+     * Workers specifies N workers to apply the stressor. Maximum 8192 workers can run by stress-ng
+     */
     @JsonProperty("workers")
     public void setWorkers(Integer workers) {
         this.workers = workers;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/MistakeSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/MistakeSpec.java
index b56aa8fe756..2e4f7b98858 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/MistakeSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/MistakeSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MistakeSpec represents one type of mistake
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public MistakeSpec(String filling, Long maxLength, Long maxOccurrences) {
         this.maxOccurrences = maxOccurrences;
     }
 
+    /**
+     * Filling determines what is filled in the mistake data.
+     */
     @JsonProperty("filling")
     public String getFilling() {
         return filling;
     }
 
+    /**
+     * Filling determines what is filled in the mistake data.
+     */
     @JsonProperty("filling")
     public void setFilling(String filling) {
         this.filling = filling;
     }
 
+    /**
+     * Max length of each wrong data segment in bytes
+     */
     @JsonProperty("maxLength")
     public Long getMaxLength() {
         return maxLength;
     }
 
+    /**
+     * Max length of each wrong data segment in bytes
+     */
     @JsonProperty("maxLength")
     public void setMaxLength(Long maxLength) {
         this.maxLength = maxLength;
     }
 
+    /**
+     * There will be [1, MaxOccurrences] segments of wrong data.
+     */
     @JsonProperty("maxOccurrences")
     public Long getMaxOccurrences() {
         return maxOccurrences;
     }
 
+    /**
+     * There will be [1, MaxOccurrences] segments of wrong data.
+     */
     @JsonProperty("maxOccurrences")
     public void setMaxOccurrences(Long maxOccurrences) {
         this.maxOccurrences = maxOccurrences;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkChaos.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkChaos.java
index 36e54b75df5..5fdee43f150 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkChaos.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkChaos.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkChaos is the Schema for the networkchaos API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class NetworkChaos implements Editable<NetworkChaosBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "NetworkChaos";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public NetworkChaos(String apiVersion, String kind, ObjectMeta metadata, Network
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * NetworkChaos is the Schema for the networkchaos API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * NetworkChaos is the Schema for the networkchaos API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * NetworkChaos is the Schema for the networkchaos API
+     */
     @JsonProperty("spec")
     public NetworkChaosSpec getSpec() {
         return spec;
     }
 
+    /**
+     * NetworkChaos is the Schema for the networkchaos API
+     */
     @JsonProperty("spec")
     public void setSpec(NetworkChaosSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * NetworkChaos is the Schema for the networkchaos API
+     */
     @JsonProperty("status")
     public NetworkChaosStatus getStatus() {
         return status;
     }
 
+    /**
+     * NetworkChaos is the Schema for the networkchaos API
+     */
     @JsonProperty("status")
     public void setStatus(NetworkChaosStatus status) {
         this.status = status;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkChaosList.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkChaosList.java
index 21388852009..89107b0d30d 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkChaosList.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkChaosList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkChaosList contains a list of NetworkChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class NetworkChaosList implements Editable<NetworkChaosListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.chaosmesh.v1alpha1.NetworkChaos>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.chaosmesh.v1alpha1.NetworkChaos> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "NetworkChaosList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public NetworkChaosList(String apiVersion, List<io.fabric8.chaosmesh.v1alpha1.Ne
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * NetworkChaosList contains a list of NetworkChaos
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.chaosmesh.v1alpha1.NetworkChaos> getItems() {
         return items;
     }
 
+    /**
+     * NetworkChaosList contains a list of NetworkChaos
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.chaosmesh.v1alpha1.NetworkChaos> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * NetworkChaosList contains a list of NetworkChaos
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * NetworkChaosList contains a list of NetworkChaos
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkChaosSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkChaosSpec.java
index 57a88fc4ef5..84f47621f2c 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkChaosSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkChaosSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkChaosSpec defines the desired state of NetworkChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -145,172 +148,274 @@ public NetworkChaosSpec(String action, BandwidthSpec bandwidth, CorruptSpec corr
         this.value = value;
     }
 
+    /**
+     * Action defines the specific network chaos action. Supported action: partition, netem, delay, loss, duplicate, corrupt Default action: delay
+     */
     @JsonProperty("action")
     public String getAction() {
         return action;
     }
 
+    /**
+     * Action defines the specific network chaos action. Supported action: partition, netem, delay, loss, duplicate, corrupt Default action: delay
+     */
     @JsonProperty("action")
     public void setAction(String action) {
         this.action = action;
     }
 
+    /**
+     * NetworkChaosSpec defines the desired state of NetworkChaos
+     */
     @JsonProperty("bandwidth")
     public BandwidthSpec getBandwidth() {
         return bandwidth;
     }
 
+    /**
+     * NetworkChaosSpec defines the desired state of NetworkChaos
+     */
     @JsonProperty("bandwidth")
     public void setBandwidth(BandwidthSpec bandwidth) {
         this.bandwidth = bandwidth;
     }
 
+    /**
+     * NetworkChaosSpec defines the desired state of NetworkChaos
+     */
     @JsonProperty("corrupt")
     public CorruptSpec getCorrupt() {
         return corrupt;
     }
 
+    /**
+     * NetworkChaosSpec defines the desired state of NetworkChaos
+     */
     @JsonProperty("corrupt")
     public void setCorrupt(CorruptSpec corrupt) {
         this.corrupt = corrupt;
     }
 
+    /**
+     * NetworkChaosSpec defines the desired state of NetworkChaos
+     */
     @JsonProperty("delay")
     public DelaySpec getDelay() {
         return delay;
     }
 
+    /**
+     * NetworkChaosSpec defines the desired state of NetworkChaos
+     */
     @JsonProperty("delay")
     public void setDelay(DelaySpec delay) {
         this.delay = delay;
     }
 
+    /**
+     * Device represents the network device to be affected.
+     */
     @JsonProperty("device")
     public String getDevice() {
         return device;
     }
 
+    /**
+     * Device represents the network device to be affected.
+     */
     @JsonProperty("device")
     public void setDevice(String device) {
         this.device = device;
     }
 
+    /**
+     * Direction represents the direction, this applies on netem and network partition action
+     */
     @JsonProperty("direction")
     public String getDirection() {
         return direction;
     }
 
+    /**
+     * Direction represents the direction, this applies on netem and network partition action
+     */
     @JsonProperty("direction")
     public void setDirection(String direction) {
         this.direction = direction;
     }
 
+    /**
+     * NetworkChaosSpec defines the desired state of NetworkChaos
+     */
     @JsonProperty("duplicate")
     public DuplicateSpec getDuplicate() {
         return duplicate;
     }
 
+    /**
+     * NetworkChaosSpec defines the desired state of NetworkChaos
+     */
     @JsonProperty("duplicate")
     public void setDuplicate(DuplicateSpec duplicate) {
         this.duplicate = duplicate;
     }
 
+    /**
+     * Duration represents the duration of the chaos action
+     */
     @JsonProperty("duration")
     public String getDuration() {
         return duration;
     }
 
+    /**
+     * Duration represents the duration of the chaos action
+     */
     @JsonProperty("duration")
     public void setDuration(String duration) {
         this.duration = duration;
     }
 
+    /**
+     * ExternalTargets represents network targets outside k8s
+     */
     @JsonProperty("externalTargets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getExternalTargets() {
         return externalTargets;
     }
 
+    /**
+     * ExternalTargets represents network targets outside k8s
+     */
     @JsonProperty("externalTargets")
     public void setExternalTargets(List<String> externalTargets) {
         this.externalTargets = externalTargets;
     }
 
+    /**
+     * NetworkChaosSpec defines the desired state of NetworkChaos
+     */
     @JsonProperty("loss")
     public LossSpec getLoss() {
         return loss;
     }
 
+    /**
+     * NetworkChaosSpec defines the desired state of NetworkChaos
+     */
     @JsonProperty("loss")
     public void setLoss(LossSpec loss) {
         this.loss = loss;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
     }
 
+    /**
+     * NetworkChaosSpec defines the desired state of NetworkChaos
+     */
     @JsonProperty("rate")
     public RateSpec getRate() {
         return rate;
     }
 
+    /**
+     * NetworkChaosSpec defines the desired state of NetworkChaos
+     */
     @JsonProperty("rate")
     public void setRate(RateSpec rate) {
         this.rate = rate;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public String getRemoteCluster() {
         return remoteCluster;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public void setRemoteCluster(String remoteCluster) {
         this.remoteCluster = remoteCluster;
     }
 
+    /**
+     * NetworkChaosSpec defines the desired state of NetworkChaos
+     */
     @JsonProperty("selector")
     public PodSelectorSpec getSelector() {
         return selector;
     }
 
+    /**
+     * NetworkChaosSpec defines the desired state of NetworkChaos
+     */
     @JsonProperty("selector")
     public void setSelector(PodSelectorSpec selector) {
         this.selector = selector;
     }
 
+    /**
+     * NetworkChaosSpec defines the desired state of NetworkChaos
+     */
     @JsonProperty("target")
     public PodSelector getTarget() {
         return target;
     }
 
+    /**
+     * NetworkChaosSpec defines the desired state of NetworkChaos
+     */
     @JsonProperty("target")
     public void setTarget(PodSelector target) {
         this.target = target;
     }
 
+    /**
+     * TargetDevice represents the network device to be affected in target scope.
+     */
     @JsonProperty("targetDevice")
     public String getTargetDevice() {
         return targetDevice;
     }
 
+    /**
+     * TargetDevice represents the network device to be affected in target scope.
+     */
     @JsonProperty("targetDevice")
     public void setTargetDevice(String targetDevice) {
         this.targetDevice = targetDevice;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of pods to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of pods the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of pods to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of pods the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkChaosStatus.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkChaosStatus.java
index dc11809cf2f..cec24274117 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkChaosStatus.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkChaosStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkChaosStatus defines the observed state of NetworkChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public NetworkChaosStatus(List<ChaosCondition> conditions, ExperimentStatus expe
         this.instances = instances;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ChaosCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ChaosCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * NetworkChaosStatus defines the observed state of NetworkChaos
+     */
     @JsonProperty("experiment")
     public ExperimentStatus getExperiment() {
         return experiment;
     }
 
+    /**
+     * NetworkChaosStatus defines the observed state of NetworkChaos
+     */
     @JsonProperty("experiment")
     public void setExperiment(ExperimentStatus experiment) {
         this.experiment = experiment;
     }
 
+    /**
+     * Instances always specifies podnetworkchaos generation or empty
+     */
     @JsonProperty("instances")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Long> getInstances() {
         return instances;
     }
 
+    /**
+     * Instances always specifies podnetworkchaos generation or empty
+     */
     @JsonProperty("instances")
     public void setInstances(Map<String, Long> instances) {
         this.instances = instances;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkCommonSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkCommonSpec.java
index a9a3ba14964..47cd3f2b5ed 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkCommonSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkCommonSpec.java
@@ -102,71 +102,113 @@ public NetworkCommonSpec(String correlation, String device, String egressPort, S
         this.sourcePort = sourcePort;
     }
 
+    /**
+     * correlation is percentage (10 is 10%)
+     */
     @JsonProperty("correlation")
     public String getCorrelation() {
         return correlation;
     }
 
+    /**
+     * correlation is percentage (10 is 10%)
+     */
     @JsonProperty("correlation")
     public void setCorrelation(String correlation) {
         this.correlation = correlation;
     }
 
+    /**
+     * the network interface to impact
+     */
     @JsonProperty("device")
     public String getDevice() {
         return device;
     }
 
+    /**
+     * the network interface to impact
+     */
     @JsonProperty("device")
     public void setDevice(String device) {
         this.device = device;
     }
 
+    /**
+     * only impact egress traffic to these destination ports, use a ',' to separate or to indicate the range, such as 80, 8001:8010. it can only be used in conjunction with -p tcp or -p udp
+     */
     @JsonProperty("egress-port")
     public String getEgressPort() {
         return egressPort;
     }
 
+    /**
+     * only impact egress traffic to these destination ports, use a ',' to separate or to indicate the range, such as 80, 8001:8010. it can only be used in conjunction with -p tcp or -p udp
+     */
     @JsonProperty("egress-port")
     public void setEgressPort(String egressPort) {
         this.egressPort = egressPort;
     }
 
+    /**
+     * only impact traffic to these hostnames
+     */
     @JsonProperty("hostname")
     public String getHostname() {
         return hostname;
     }
 
+    /**
+     * only impact traffic to these hostnames
+     */
     @JsonProperty("hostname")
     public void setHostname(String hostname) {
         this.hostname = hostname;
     }
 
+    /**
+     * only impact egress traffic to these IP addresses
+     */
     @JsonProperty("ip-address")
     public String getIpAddress() {
         return ipAddress;
     }
 
+    /**
+     * only impact egress traffic to these IP addresses
+     */
     @JsonProperty("ip-address")
     public void setIpAddress(String ipAddress) {
         this.ipAddress = ipAddress;
     }
 
+    /**
+     * only impact traffic using this IP protocol, supported: tcp, udp, icmp, all
+     */
     @JsonProperty("ip-protocol")
     public String getIpProtocol() {
         return ipProtocol;
     }
 
+    /**
+     * only impact traffic using this IP protocol, supported: tcp, udp, icmp, all
+     */
     @JsonProperty("ip-protocol")
     public void setIpProtocol(String ipProtocol) {
         this.ipProtocol = ipProtocol;
     }
 
+    /**
+     * only impact egress traffic from these source ports, use a ',' to separate or to indicate the range, such as 80, 8001:8010. it can only be used in conjunction with -p tcp or -p udp
+     */
     @JsonProperty("source-port")
     public String getSourcePort() {
         return sourcePort;
     }
 
+    /**
+     * only impact egress traffic from these source ports, use a ',' to separate or to indicate the range, such as 80, 8001:8010. it can only be used in conjunction with -p tcp or -p udp
+     */
     @JsonProperty("source-port")
     public void setSourcePort(String sourcePort) {
         this.sourcePort = sourcePort;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkCorruptSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkCorruptSpec.java
index b43e5210abc..06c9ae39dc8 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkCorruptSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkCorruptSpec.java
@@ -106,81 +106,129 @@ public NetworkCorruptSpec(String correlation, String device, String egressPort,
         this.sourcePort = sourcePort;
     }
 
+    /**
+     * correlation is percentage (10 is 10%)
+     */
     @JsonProperty("correlation")
     public String getCorrelation() {
         return correlation;
     }
 
+    /**
+     * correlation is percentage (10 is 10%)
+     */
     @JsonProperty("correlation")
     public void setCorrelation(String correlation) {
         this.correlation = correlation;
     }
 
+    /**
+     * the network interface to impact
+     */
     @JsonProperty("device")
     public String getDevice() {
         return device;
     }
 
+    /**
+     * the network interface to impact
+     */
     @JsonProperty("device")
     public void setDevice(String device) {
         this.device = device;
     }
 
+    /**
+     * only impact egress traffic to these destination ports, use a ',' to separate or to indicate the range, such as 80, 8001:8010. it can only be used in conjunction with -p tcp or -p udp
+     */
     @JsonProperty("egress-port")
     public String getEgressPort() {
         return egressPort;
     }
 
+    /**
+     * only impact egress traffic to these destination ports, use a ',' to separate or to indicate the range, such as 80, 8001:8010. it can only be used in conjunction with -p tcp or -p udp
+     */
     @JsonProperty("egress-port")
     public void setEgressPort(String egressPort) {
         this.egressPort = egressPort;
     }
 
+    /**
+     * only impact traffic to these hostnames
+     */
     @JsonProperty("hostname")
     public String getHostname() {
         return hostname;
     }
 
+    /**
+     * only impact traffic to these hostnames
+     */
     @JsonProperty("hostname")
     public void setHostname(String hostname) {
         this.hostname = hostname;
     }
 
+    /**
+     * only impact egress traffic to these IP addresses
+     */
     @JsonProperty("ip-address")
     public String getIpAddress() {
         return ipAddress;
     }
 
+    /**
+     * only impact egress traffic to these IP addresses
+     */
     @JsonProperty("ip-address")
     public void setIpAddress(String ipAddress) {
         this.ipAddress = ipAddress;
     }
 
+    /**
+     * only impact traffic using this IP protocol, supported: tcp, udp, icmp, all
+     */
     @JsonProperty("ip-protocol")
     public String getIpProtocol() {
         return ipProtocol;
     }
 
+    /**
+     * only impact traffic using this IP protocol, supported: tcp, udp, icmp, all
+     */
     @JsonProperty("ip-protocol")
     public void setIpProtocol(String ipProtocol) {
         this.ipProtocol = ipProtocol;
     }
 
+    /**
+     * percentage of packets to corrupt (10 is 10%)
+     */
     @JsonProperty("percent")
     public String getPercent() {
         return percent;
     }
 
+    /**
+     * percentage of packets to corrupt (10 is 10%)
+     */
     @JsonProperty("percent")
     public void setPercent(String percent) {
         this.percent = percent;
     }
 
+    /**
+     * only impact egress traffic from these source ports, use a ',' to separate or to indicate the range, such as 80, 8001:8010. it can only be used in conjunction with -p tcp or -p udp
+     */
     @JsonProperty("source-port")
     public String getSourcePort() {
         return sourcePort;
     }
 
+    /**
+     * only impact egress traffic from these source ports, use a ',' to separate or to indicate the range, such as 80, 8001:8010. it can only be used in conjunction with -p tcp or -p udp
+     */
     @JsonProperty("source-port")
     public void setSourcePort(String sourcePort) {
         this.sourcePort = sourcePort;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkDNSSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkDNSSpec.java
index 5fb643e8700..20357e1fd16 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkDNSSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkDNSSpec.java
@@ -86,31 +86,49 @@ public NetworkDNSSpec(String dnsDomainName, String dnsIp, String dnsServer) {
         this.dnsServer = dnsServer;
     }
 
+    /**
+     * map this host to specified IP
+     */
     @JsonProperty("dns-domain-name")
     public String getDnsDomainName() {
         return dnsDomainName;
     }
 
+    /**
+     * map this host to specified IP
+     */
     @JsonProperty("dns-domain-name")
     public void setDnsDomainName(String dnsDomainName) {
         this.dnsDomainName = dnsDomainName;
     }
 
+    /**
+     * map specified host to this IP address
+     */
     @JsonProperty("dns-ip")
     public String getDnsIp() {
         return dnsIp;
     }
 
+    /**
+     * map specified host to this IP address
+     */
     @JsonProperty("dns-ip")
     public void setDnsIp(String dnsIp) {
         this.dnsIp = dnsIp;
     }
 
+    /**
+     * update the DNS server in /etc/resolv.conf with this value
+     */
     @JsonProperty("dns-server")
     public String getDnsServer() {
         return dnsServer;
     }
 
+    /**
+     * update the DNS server in /etc/resolv.conf with this value
+     */
     @JsonProperty("dns-server")
     public void setDnsServer(String dnsServer) {
         this.dnsServer = dnsServer;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkDelaySpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkDelaySpec.java
index c6a63d5422f..e73168bf07b 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkDelaySpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkDelaySpec.java
@@ -114,101 +114,161 @@ public NetworkDelaySpec(String acceptTcpFlags, String correlation, String device
         this.sourcePort = sourcePort;
     }
 
+    /**
+     * only the packet which match the tcp flag can be accepted, others will be dropped. only set when the IPProtocol is tcp, used for partition.
+     */
     @JsonProperty("accept-tcp-flags")
     public String getAcceptTcpFlags() {
         return acceptTcpFlags;
     }
 
+    /**
+     * only the packet which match the tcp flag can be accepted, others will be dropped. only set when the IPProtocol is tcp, used for partition.
+     */
     @JsonProperty("accept-tcp-flags")
     public void setAcceptTcpFlags(String acceptTcpFlags) {
         this.acceptTcpFlags = acceptTcpFlags;
     }
 
+    /**
+     * correlation is percentage (10 is 10%)
+     */
     @JsonProperty("correlation")
     public String getCorrelation() {
         return correlation;
     }
 
+    /**
+     * correlation is percentage (10 is 10%)
+     */
     @JsonProperty("correlation")
     public void setCorrelation(String correlation) {
         this.correlation = correlation;
     }
 
+    /**
+     * the network interface to impact
+     */
     @JsonProperty("device")
     public String getDevice() {
         return device;
     }
 
+    /**
+     * the network interface to impact
+     */
     @JsonProperty("device")
     public void setDevice(String device) {
         this.device = device;
     }
 
+    /**
+     * only impact egress traffic to these destination ports, use a ',' to separate or to indicate the range, such as 80, 8001:8010. it can only be used in conjunction with -p tcp or -p udp
+     */
     @JsonProperty("egress-port")
     public String getEgressPort() {
         return egressPort;
     }
 
+    /**
+     * only impact egress traffic to these destination ports, use a ',' to separate or to indicate the range, such as 80, 8001:8010. it can only be used in conjunction with -p tcp or -p udp
+     */
     @JsonProperty("egress-port")
     public void setEgressPort(String egressPort) {
         this.egressPort = egressPort;
     }
 
+    /**
+     * only impact traffic to these hostnames
+     */
     @JsonProperty("hostname")
     public String getHostname() {
         return hostname;
     }
 
+    /**
+     * only impact traffic to these hostnames
+     */
     @JsonProperty("hostname")
     public void setHostname(String hostname) {
         this.hostname = hostname;
     }
 
+    /**
+     * only impact egress traffic to these IP addresses
+     */
     @JsonProperty("ip-address")
     public String getIpAddress() {
         return ipAddress;
     }
 
+    /**
+     * only impact egress traffic to these IP addresses
+     */
     @JsonProperty("ip-address")
     public void setIpAddress(String ipAddress) {
         this.ipAddress = ipAddress;
     }
 
+    /**
+     * only impact traffic using this IP protocol, supported: tcp, udp, icmp, all
+     */
     @JsonProperty("ip-protocol")
     public String getIpProtocol() {
         return ipProtocol;
     }
 
+    /**
+     * only impact traffic using this IP protocol, supported: tcp, udp, icmp, all
+     */
     @JsonProperty("ip-protocol")
     public void setIpProtocol(String ipProtocol) {
         this.ipProtocol = ipProtocol;
     }
 
+    /**
+     * jitter time, time units: ns, us (or µs), ms, s, m, h.
+     */
     @JsonProperty("jitter")
     public String getJitter() {
         return jitter;
     }
 
+    /**
+     * jitter time, time units: ns, us (or µs), ms, s, m, h.
+     */
     @JsonProperty("jitter")
     public void setJitter(String jitter) {
         this.jitter = jitter;
     }
 
+    /**
+     * delay egress time, time units: ns, us (or µs), ms, s, m, h.
+     */
     @JsonProperty("latency")
     public String getLatency() {
         return latency;
     }
 
+    /**
+     * delay egress time, time units: ns, us (or µs), ms, s, m, h.
+     */
     @JsonProperty("latency")
     public void setLatency(String latency) {
         this.latency = latency;
     }
 
+    /**
+     * only impact egress traffic from these source ports, use a ',' to separate or to indicate the range, such as 80, 8001:8010. it can only be used in conjunction with -p tcp or -p udp
+     */
     @JsonProperty("source-port")
     public String getSourcePort() {
         return sourcePort;
     }
 
+    /**
+     * only impact egress traffic from these source ports, use a ',' to separate or to indicate the range, such as 80, 8001:8010. it can only be used in conjunction with -p tcp or -p udp
+     */
     @JsonProperty("source-port")
     public void setSourcePort(String sourcePort) {
         this.sourcePort = sourcePort;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkDownSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkDownSpec.java
index 76360e70e01..1a601cf4ffe 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkDownSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkDownSpec.java
@@ -82,21 +82,33 @@ public NetworkDownSpec(String device, String duration) {
         this.duration = duration;
     }
 
+    /**
+     * The network interface to impact
+     */
     @JsonProperty("device")
     public String getDevice() {
         return device;
     }
 
+    /**
+     * The network interface to impact
+     */
     @JsonProperty("device")
     public void setDevice(String device) {
         this.device = device;
     }
 
+    /**
+     * NIC down time, time units: ns, us (or µs), ms, s, m, h.
+     */
     @JsonProperty("duration")
     public String getDuration() {
         return duration;
     }
 
+    /**
+     * NIC down time, time units: ns, us (or µs), ms, s, m, h.
+     */
     @JsonProperty("duration")
     public void setDuration(String duration) {
         this.duration = duration;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkDuplicateSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkDuplicateSpec.java
index ba2e738e7ad..62073c54203 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkDuplicateSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkDuplicateSpec.java
@@ -106,81 +106,129 @@ public NetworkDuplicateSpec(String correlation, String device, String egressPort
         this.sourcePort = sourcePort;
     }
 
+    /**
+     * correlation is percentage (10 is 10%)
+     */
     @JsonProperty("correlation")
     public String getCorrelation() {
         return correlation;
     }
 
+    /**
+     * correlation is percentage (10 is 10%)
+     */
     @JsonProperty("correlation")
     public void setCorrelation(String correlation) {
         this.correlation = correlation;
     }
 
+    /**
+     * the network interface to impact
+     */
     @JsonProperty("device")
     public String getDevice() {
         return device;
     }
 
+    /**
+     * the network interface to impact
+     */
     @JsonProperty("device")
     public void setDevice(String device) {
         this.device = device;
     }
 
+    /**
+     * only impact egress traffic to these destination ports, use a ',' to separate or to indicate the range, such as 80, 8001:8010. it can only be used in conjunction with -p tcp or -p udp
+     */
     @JsonProperty("egress-port")
     public String getEgressPort() {
         return egressPort;
     }
 
+    /**
+     * only impact egress traffic to these destination ports, use a ',' to separate or to indicate the range, such as 80, 8001:8010. it can only be used in conjunction with -p tcp or -p udp
+     */
     @JsonProperty("egress-port")
     public void setEgressPort(String egressPort) {
         this.egressPort = egressPort;
     }
 
+    /**
+     * only impact traffic to these hostnames
+     */
     @JsonProperty("hostname")
     public String getHostname() {
         return hostname;
     }
 
+    /**
+     * only impact traffic to these hostnames
+     */
     @JsonProperty("hostname")
     public void setHostname(String hostname) {
         this.hostname = hostname;
     }
 
+    /**
+     * only impact egress traffic to these IP addresses
+     */
     @JsonProperty("ip-address")
     public String getIpAddress() {
         return ipAddress;
     }
 
+    /**
+     * only impact egress traffic to these IP addresses
+     */
     @JsonProperty("ip-address")
     public void setIpAddress(String ipAddress) {
         this.ipAddress = ipAddress;
     }
 
+    /**
+     * only impact traffic using this IP protocol, supported: tcp, udp, icmp, all
+     */
     @JsonProperty("ip-protocol")
     public String getIpProtocol() {
         return ipProtocol;
     }
 
+    /**
+     * only impact traffic using this IP protocol, supported: tcp, udp, icmp, all
+     */
     @JsonProperty("ip-protocol")
     public void setIpProtocol(String ipProtocol) {
         this.ipProtocol = ipProtocol;
     }
 
+    /**
+     * percentage of packets to duplicate (10 is 10%)
+     */
     @JsonProperty("percent")
     public String getPercent() {
         return percent;
     }
 
+    /**
+     * percentage of packets to duplicate (10 is 10%)
+     */
     @JsonProperty("percent")
     public void setPercent(String percent) {
         this.percent = percent;
     }
 
+    /**
+     * only impact egress traffic from these source ports, use a ',' to separate or to indicate the range, such as 80, 8001:8010. it can only be used in conjunction with -p tcp or -p udp
+     */
     @JsonProperty("source-port")
     public String getSourcePort() {
         return sourcePort;
     }
 
+    /**
+     * only impact egress traffic from these source ports, use a ',' to separate or to indicate the range, such as 80, 8001:8010. it can only be used in conjunction with -p tcp or -p udp
+     */
     @JsonProperty("source-port")
     public void setSourcePort(String sourcePort) {
         this.sourcePort = sourcePort;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkFloodSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkFloodSpec.java
index afa2ff7ea44..0855ed784ae 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkFloodSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkFloodSpec.java
@@ -94,51 +94,81 @@ public NetworkFloodSpec(String duration, String ipAddress, Integer parallel, Str
         this.rate = rate;
     }
 
+    /**
+     * The number of seconds to run the iperf test
+     */
     @JsonProperty("duration")
     public String getDuration() {
         return duration;
     }
 
+    /**
+     * The number of seconds to run the iperf test
+     */
     @JsonProperty("duration")
     public void setDuration(String duration) {
         this.duration = duration;
     }
 
+    /**
+     * Generate traffic to this IP address
+     */
     @JsonProperty("ip-address")
     public String getIpAddress() {
         return ipAddress;
     }
 
+    /**
+     * Generate traffic to this IP address
+     */
     @JsonProperty("ip-address")
     public void setIpAddress(String ipAddress) {
         this.ipAddress = ipAddress;
     }
 
+    /**
+     * The number of iperf parallel client threads to run
+     */
     @JsonProperty("parallel")
     public Integer getParallel() {
         return parallel;
     }
 
+    /**
+     * The number of iperf parallel client threads to run
+     */
     @JsonProperty("parallel")
     public void setParallel(Integer parallel) {
         this.parallel = parallel;
     }
 
+    /**
+     * Generate traffic to this port on the IP address
+     */
     @JsonProperty("port")
     public String getPort() {
         return port;
     }
 
+    /**
+     * Generate traffic to this port on the IP address
+     */
     @JsonProperty("port")
     public void setPort(String port) {
         this.port = port;
     }
 
+    /**
+     * The speed of network traffic, allows bps, kbps, mbps, gbps, tbps unit. bps means bytes per second
+     */
     @JsonProperty("rate")
     public String getRate() {
         return rate;
     }
 
+    /**
+     * The speed of network traffic, allows bps, kbps, mbps, gbps, tbps unit. bps means bytes per second
+     */
     @JsonProperty("rate")
     public void setRate(String rate) {
         this.rate = rate;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkLossSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkLossSpec.java
index ce539f6d1eb..49c5040812a 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkLossSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkLossSpec.java
@@ -106,81 +106,129 @@ public NetworkLossSpec(String correlation, String device, String egressPort, Str
         this.sourcePort = sourcePort;
     }
 
+    /**
+     * correlation is percentage (10 is 10%)
+     */
     @JsonProperty("correlation")
     public String getCorrelation() {
         return correlation;
     }
 
+    /**
+     * correlation is percentage (10 is 10%)
+     */
     @JsonProperty("correlation")
     public void setCorrelation(String correlation) {
         this.correlation = correlation;
     }
 
+    /**
+     * the network interface to impact
+     */
     @JsonProperty("device")
     public String getDevice() {
         return device;
     }
 
+    /**
+     * the network interface to impact
+     */
     @JsonProperty("device")
     public void setDevice(String device) {
         this.device = device;
     }
 
+    /**
+     * only impact egress traffic to these destination ports, use a ',' to separate or to indicate the range, such as 80, 8001:8010. it can only be used in conjunction with -p tcp or -p udp
+     */
     @JsonProperty("egress-port")
     public String getEgressPort() {
         return egressPort;
     }
 
+    /**
+     * only impact egress traffic to these destination ports, use a ',' to separate or to indicate the range, such as 80, 8001:8010. it can only be used in conjunction with -p tcp or -p udp
+     */
     @JsonProperty("egress-port")
     public void setEgressPort(String egressPort) {
         this.egressPort = egressPort;
     }
 
+    /**
+     * only impact traffic to these hostnames
+     */
     @JsonProperty("hostname")
     public String getHostname() {
         return hostname;
     }
 
+    /**
+     * only impact traffic to these hostnames
+     */
     @JsonProperty("hostname")
     public void setHostname(String hostname) {
         this.hostname = hostname;
     }
 
+    /**
+     * only impact egress traffic to these IP addresses
+     */
     @JsonProperty("ip-address")
     public String getIpAddress() {
         return ipAddress;
     }
 
+    /**
+     * only impact egress traffic to these IP addresses
+     */
     @JsonProperty("ip-address")
     public void setIpAddress(String ipAddress) {
         this.ipAddress = ipAddress;
     }
 
+    /**
+     * only impact traffic using this IP protocol, supported: tcp, udp, icmp, all
+     */
     @JsonProperty("ip-protocol")
     public String getIpProtocol() {
         return ipProtocol;
     }
 
+    /**
+     * only impact traffic using this IP protocol, supported: tcp, udp, icmp, all
+     */
     @JsonProperty("ip-protocol")
     public void setIpProtocol(String ipProtocol) {
         this.ipProtocol = ipProtocol;
     }
 
+    /**
+     * percentage of packets to loss (10 is 10%)
+     */
     @JsonProperty("percent")
     public String getPercent() {
         return percent;
     }
 
+    /**
+     * percentage of packets to loss (10 is 10%)
+     */
     @JsonProperty("percent")
     public void setPercent(String percent) {
         this.percent = percent;
     }
 
+    /**
+     * only impact egress traffic from these source ports, use a ',' to separate or to indicate the range, such as 80, 8001:8010. it can only be used in conjunction with -p tcp or -p udp
+     */
     @JsonProperty("source-port")
     public String getSourcePort() {
         return sourcePort;
     }
 
+    /**
+     * only impact egress traffic from these source ports, use a ',' to separate or to indicate the range, such as 80, 8001:8010. it can only be used in conjunction with -p tcp or -p udp
+     */
     @JsonProperty("source-port")
     public void setSourcePort(String sourcePort) {
         this.sourcePort = sourcePort;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkPartitionSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkPartitionSpec.java
index b40f00b8fc0..0848116cfa3 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkPartitionSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/NetworkPartitionSpec.java
@@ -98,61 +98,97 @@ public NetworkPartitionSpec(String acceptTcpFlags, String device, String directi
         this.ipProtocol = ipProtocol;
     }
 
+    /**
+     * only the packet which match the tcp flag can be accepted, others will be dropped. only set when the IPProtocol is tcp, used for partition.
+     */
     @JsonProperty("accept-tcp-flags")
     public String getAcceptTcpFlags() {
         return acceptTcpFlags;
     }
 
+    /**
+     * only the packet which match the tcp flag can be accepted, others will be dropped. only set when the IPProtocol is tcp, used for partition.
+     */
     @JsonProperty("accept-tcp-flags")
     public void setAcceptTcpFlags(String acceptTcpFlags) {
         this.acceptTcpFlags = acceptTcpFlags;
     }
 
+    /**
+     * the network interface to impact
+     */
     @JsonProperty("device")
     public String getDevice() {
         return device;
     }
 
+    /**
+     * the network interface to impact
+     */
     @JsonProperty("device")
     public void setDevice(String device) {
         this.device = device;
     }
 
+    /**
+     * specifies the partition direction, values can be 'from', 'to'. 'from' means packets coming from the 'IPAddress' or 'Hostname' and going to your server, 'to' means packets originating from your server and going to the 'IPAddress' or 'Hostname'.
+     */
     @JsonProperty("direction")
     public String getDirection() {
         return direction;
     }
 
+    /**
+     * specifies the partition direction, values can be 'from', 'to'. 'from' means packets coming from the 'IPAddress' or 'Hostname' and going to your server, 'to' means packets originating from your server and going to the 'IPAddress' or 'Hostname'.
+     */
     @JsonProperty("direction")
     public void setDirection(String direction) {
         this.direction = direction;
     }
 
+    /**
+     * only impact traffic to these hostnames
+     */
     @JsonProperty("hostname")
     public String getHostname() {
         return hostname;
     }
 
+    /**
+     * only impact traffic to these hostnames
+     */
     @JsonProperty("hostname")
     public void setHostname(String hostname) {
         this.hostname = hostname;
     }
 
+    /**
+     * only impact egress traffic to these IP addresses
+     */
     @JsonProperty("ip-address")
     public String getIpAddress() {
         return ipAddress;
     }
 
+    /**
+     * only impact egress traffic to these IP addresses
+     */
     @JsonProperty("ip-address")
     public void setIpAddress(String ipAddress) {
         this.ipAddress = ipAddress;
     }
 
+    /**
+     * only impact egress traffic to these IP addresses
+     */
     @JsonProperty("ip-protocol")
     public String getIpProtocol() {
         return ipProtocol;
     }
 
+    /**
+     * only impact egress traffic to these IP addresses
+     */
     @JsonProperty("ip-protocol")
     public void setIpProtocol(String ipProtocol) {
         this.ipProtocol = ipProtocol;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PMJVMMySQLSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PMJVMMySQLSpec.java
index 71c0d469e4b..b42c8613445 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PMJVMMySQLSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PMJVMMySQLSpec.java
@@ -106,81 +106,129 @@ public PMJVMMySQLSpec(String database, String exception, Integer latency, String
         this.table = table;
     }
 
+    /**
+     * the match database default value is "", means match all database
+     */
     @JsonProperty("database")
     public String getDatabase() {
         return database;
     }
 
+    /**
+     * the match database default value is "", means match all database
+     */
     @JsonProperty("database")
     public void setDatabase(String database) {
         this.database = database;
     }
 
+    /**
+     * The exception which needs to throw for action `exception` or the exception message needs to throw in action `mysql`
+     */
     @JsonProperty("exception")
     public String getException() {
         return exception;
     }
 
+    /**
+     * The exception which needs to throw for action `exception` or the exception message needs to throw in action `mysql`
+     */
     @JsonProperty("exception")
     public void setException(String exception) {
         this.exception = exception;
     }
 
+    /**
+     * The latency duration for action 'latency' or the latency duration in action `mysql`
+     */
     @JsonProperty("latency")
     public Integer getLatency() {
         return latency;
     }
 
+    /**
+     * The latency duration for action 'latency' or the latency duration in action `mysql`
+     */
     @JsonProperty("latency")
     public void setLatency(Integer latency) {
         this.latency = latency;
     }
 
+    /**
+     * the version of mysql-connector-java, only support 5.X.X(set to "5") and 8.X.X(set to "8") now
+     */
     @JsonProperty("mysqlConnectorVersion")
     public String getMysqlConnectorVersion() {
         return mysqlConnectorVersion;
     }
 
+    /**
+     * the version of mysql-connector-java, only support 5.X.X(set to "5") and 8.X.X(set to "8") now
+     */
     @JsonProperty("mysqlConnectorVersion")
     public void setMysqlConnectorVersion(String mysqlConnectorVersion) {
         this.mysqlConnectorVersion = mysqlConnectorVersion;
     }
 
+    /**
+     * the pid of Java process which needs to attach
+     */
     @JsonProperty("pid")
     public Integer getPid() {
         return pid;
     }
 
+    /**
+     * the pid of Java process which needs to attach
+     */
     @JsonProperty("pid")
     public void setPid(Integer pid) {
         this.pid = pid;
     }
 
+    /**
+     * the port of agent server, default 9277
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * the port of agent server, default 9277
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * the match sql type default value is "", means match all SQL type. The value can be 'select', 'insert', 'update', 'delete', 'replace'.
+     */
     @JsonProperty("sqlType")
     public String getSqlType() {
         return sqlType;
     }
 
+    /**
+     * the match sql type default value is "", means match all SQL type. The value can be 'select', 'insert', 'update', 'delete', 'replace'.
+     */
     @JsonProperty("sqlType")
     public void setSqlType(String sqlType) {
         this.sqlType = sqlType;
     }
 
+    /**
+     * the match table default value is "", means match all table
+     */
     @JsonProperty("table")
     public String getTable() {
         return table;
     }
 
+    /**
+     * the match table default value is "", means match all table
+     */
     @JsonProperty("table")
     public void setTable(String table) {
         this.table = table;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachine.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachine.java
index d10b0daa775..d36ccc4d31c 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachine.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachine.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PhysicalMachine is the Schema for the physical machine API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class PhysicalMachine implements Editable<PhysicalMachineBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PhysicalMachine";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public PhysicalMachine(String apiVersion, String kind, ObjectMeta metadata, Phys
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PhysicalMachine is the Schema for the physical machine API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PhysicalMachine is the Schema for the physical machine API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PhysicalMachine is the Schema for the physical machine API
+     */
     @JsonProperty("spec")
     public PhysicalMachineSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PhysicalMachine is the Schema for the physical machine API
+     */
     @JsonProperty("spec")
     public void setSpec(PhysicalMachineSpec spec) {
         this.spec = spec;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineChaos.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineChaos.java
index 287a049ace9..77d05dff65c 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineChaos.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineChaos.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PhysicalMachineChaos is the Schema for the physical machine chaos API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class PhysicalMachineChaos implements Editable<PhysicalMachineChaosBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PhysicalMachineChaos";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PhysicalMachineChaos(String apiVersion, String kind, ObjectMeta metadata,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PhysicalMachineChaos is the Schema for the physical machine chaos API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PhysicalMachineChaos is the Schema for the physical machine chaos API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PhysicalMachineChaos is the Schema for the physical machine chaos API
+     */
     @JsonProperty("spec")
     public PhysicalMachineChaosSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PhysicalMachineChaos is the Schema for the physical machine chaos API
+     */
     @JsonProperty("spec")
     public void setSpec(PhysicalMachineChaosSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PhysicalMachineChaos is the Schema for the physical machine chaos API
+     */
     @JsonProperty("status")
     public PhysicalMachineChaosStatus getStatus() {
         return status;
     }
 
+    /**
+     * PhysicalMachineChaos is the Schema for the physical machine chaos API
+     */
     @JsonProperty("status")
     public void setStatus(PhysicalMachineChaosStatus status) {
         this.status = status;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineChaosList.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineChaosList.java
index 591d89a010e..b7f2d4dae76 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineChaosList.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineChaosList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PhysicalMachineChaosList contains a list of PhysicalMachineChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PhysicalMachineChaosList implements Editable<PhysicalMachineChaosListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.chaosmesh.v1alpha1.PhysicalMachineChaos>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.chaosmesh.v1alpha1.PhysicalMachineChaos> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PhysicalMachineChaosList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PhysicalMachineChaosList(String apiVersion, List<io.fabric8.chaosmesh.v1a
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PhysicalMachineChaosList contains a list of PhysicalMachineChaos
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.chaosmesh.v1alpha1.PhysicalMachineChaos> getItems() {
         return items;
     }
 
+    /**
+     * PhysicalMachineChaosList contains a list of PhysicalMachineChaos
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.chaosmesh.v1alpha1.PhysicalMachineChaos> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PhysicalMachineChaosList contains a list of PhysicalMachineChaos
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PhysicalMachineChaosList contains a list of PhysicalMachineChaos
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineChaosSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineChaosSpec.java
index b75ebcabaca..ade46171d5d 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineChaosSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineChaosSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -277,502 +280,802 @@ public PhysicalMachineChaosSpec(String action, List<String> address, ClockSpec c
         this.vm = vm;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("action")
     public String getAction() {
         return action;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("action")
     public void setAction(String action) {
         this.action = action;
     }
 
+    /**
+     * DEPRECATED: Use Selector instead. Only one of Address and Selector could be specified.
+     */
     @JsonProperty("address")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAddress() {
         return address;
     }
 
+    /**
+     * DEPRECATED: Use Selector instead. Only one of Address and Selector could be specified.
+     */
     @JsonProperty("address")
     public void setAddress(List<String> address) {
         this.address = address;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("clock")
     public ClockSpec getClock() {
         return clock;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("clock")
     public void setClock(ClockSpec clock) {
         this.clock = clock;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("disk-fill")
     public DiskFillSpec getDiskFill() {
         return diskFill;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("disk-fill")
     public void setDiskFill(DiskFillSpec diskFill) {
         this.diskFill = diskFill;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("disk-read-payload")
     public DiskPayloadSpec getDiskReadPayload() {
         return diskReadPayload;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("disk-read-payload")
     public void setDiskReadPayload(DiskPayloadSpec diskReadPayload) {
         this.diskReadPayload = diskReadPayload;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("disk-write-payload")
     public DiskPayloadSpec getDiskWritePayload() {
         return diskWritePayload;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("disk-write-payload")
     public void setDiskWritePayload(DiskPayloadSpec diskWritePayload) {
         this.diskWritePayload = diskWritePayload;
     }
 
+    /**
+     * Duration represents the duration of the chaos action
+     */
     @JsonProperty("duration")
     public String getDuration() {
         return duration;
     }
 
+    /**
+     * Duration represents the duration of the chaos action
+     */
     @JsonProperty("duration")
     public void setDuration(String duration) {
         this.duration = duration;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("file-append")
     public FileAppendSpec getFileAppend() {
         return fileAppend;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("file-append")
     public void setFileAppend(FileAppendSpec fileAppend) {
         this.fileAppend = fileAppend;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("file-create")
     public FileCreateSpec getFileCreate() {
         return fileCreate;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("file-create")
     public void setFileCreate(FileCreateSpec fileCreate) {
         this.fileCreate = fileCreate;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("file-delete")
     public FileDeleteSpec getFileDelete() {
         return fileDelete;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("file-delete")
     public void setFileDelete(FileDeleteSpec fileDelete) {
         this.fileDelete = fileDelete;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("file-modify")
     public FileModifyPrivilegeSpec getFileModify() {
         return fileModify;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("file-modify")
     public void setFileModify(FileModifyPrivilegeSpec fileModify) {
         this.fileModify = fileModify;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("file-rename")
     public FileRenameSpec getFileRename() {
         return fileRename;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("file-rename")
     public void setFileRename(FileRenameSpec fileRename) {
         this.fileRename = fileRename;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("file-replace")
     public FileReplaceSpec getFileReplace() {
         return fileReplace;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("file-replace")
     public void setFileReplace(FileReplaceSpec fileReplace) {
         this.fileReplace = fileReplace;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("http-abort")
     public HTTPAbortSpec getHttpAbort() {
         return httpAbort;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("http-abort")
     public void setHttpAbort(HTTPAbortSpec httpAbort) {
         this.httpAbort = httpAbort;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("http-config")
     public HTTPConfigSpec getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("http-config")
     public void setHttpConfig(HTTPConfigSpec httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("http-delay")
     public HTTPDelaySpec getHttpDelay() {
         return httpDelay;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("http-delay")
     public void setHttpDelay(HTTPDelaySpec httpDelay) {
         this.httpDelay = httpDelay;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("http-request")
     public HTTPRequestSpec getHttpRequest() {
         return httpRequest;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("http-request")
     public void setHttpRequest(HTTPRequestSpec httpRequest) {
         this.httpRequest = httpRequest;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("jvm-exception")
     public JVMExceptionSpec getJvmException() {
         return jvmException;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("jvm-exception")
     public void setJvmException(JVMExceptionSpec jvmException) {
         this.jvmException = jvmException;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("jvm-gc")
     public JVMGCSpec getJvmGc() {
         return jvmGc;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("jvm-gc")
     public void setJvmGc(JVMGCSpec jvmGc) {
         this.jvmGc = jvmGc;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("jvm-latency")
     public JVMLatencySpec getJvmLatency() {
         return jvmLatency;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("jvm-latency")
     public void setJvmLatency(JVMLatencySpec jvmLatency) {
         this.jvmLatency = jvmLatency;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("jvm-mysql")
     public PMJVMMySQLSpec getJvmMysql() {
         return jvmMysql;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("jvm-mysql")
     public void setJvmMysql(PMJVMMySQLSpec jvmMysql) {
         this.jvmMysql = jvmMysql;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("jvm-return")
     public JVMReturnSpec getJvmReturn() {
         return jvmReturn;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("jvm-return")
     public void setJvmReturn(JVMReturnSpec jvmReturn) {
         this.jvmReturn = jvmReturn;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("jvm-rule-data")
     public JVMRuleDataSpec getJvmRuleData() {
         return jvmRuleData;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("jvm-rule-data")
     public void setJvmRuleData(JVMRuleDataSpec jvmRuleData) {
         this.jvmRuleData = jvmRuleData;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("jvm-stress")
     public JVMStressSpec getJvmStress() {
         return jvmStress;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("jvm-stress")
     public void setJvmStress(JVMStressSpec jvmStress) {
         this.jvmStress = jvmStress;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("kafka-fill")
     public KafkaFillSpec getKafkaFill() {
         return kafkaFill;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("kafka-fill")
     public void setKafkaFill(KafkaFillSpec kafkaFill) {
         this.kafkaFill = kafkaFill;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("kafka-flood")
     public KafkaFloodSpec getKafkaFlood() {
         return kafkaFlood;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("kafka-flood")
     public void setKafkaFlood(KafkaFloodSpec kafkaFlood) {
         this.kafkaFlood = kafkaFlood;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("kafka-io")
     public KafkaIOSpec getKafkaIo() {
         return kafkaIo;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("kafka-io")
     public void setKafkaIo(KafkaIOSpec kafkaIo) {
         this.kafkaIo = kafkaIo;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("network-bandwidth")
     public NetworkBandwidthSpec getNetworkBandwidth() {
         return networkBandwidth;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("network-bandwidth")
     public void setNetworkBandwidth(NetworkBandwidthSpec networkBandwidth) {
         this.networkBandwidth = networkBandwidth;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("network-corrupt")
     public NetworkCorruptSpec getNetworkCorrupt() {
         return networkCorrupt;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("network-corrupt")
     public void setNetworkCorrupt(NetworkCorruptSpec networkCorrupt) {
         this.networkCorrupt = networkCorrupt;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("network-delay")
     public NetworkDelaySpec getNetworkDelay() {
         return networkDelay;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("network-delay")
     public void setNetworkDelay(NetworkDelaySpec networkDelay) {
         this.networkDelay = networkDelay;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("network-dns")
     public NetworkDNSSpec getNetworkDns() {
         return networkDns;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("network-dns")
     public void setNetworkDns(NetworkDNSSpec networkDns) {
         this.networkDns = networkDns;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("network-down")
     public NetworkDownSpec getNetworkDown() {
         return networkDown;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("network-down")
     public void setNetworkDown(NetworkDownSpec networkDown) {
         this.networkDown = networkDown;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("network-duplicate")
     public NetworkDuplicateSpec getNetworkDuplicate() {
         return networkDuplicate;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("network-duplicate")
     public void setNetworkDuplicate(NetworkDuplicateSpec networkDuplicate) {
         this.networkDuplicate = networkDuplicate;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("network-flood")
     public NetworkFloodSpec getNetworkFlood() {
         return networkFlood;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("network-flood")
     public void setNetworkFlood(NetworkFloodSpec networkFlood) {
         this.networkFlood = networkFlood;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("network-loss")
     public NetworkLossSpec getNetworkLoss() {
         return networkLoss;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("network-loss")
     public void setNetworkLoss(NetworkLossSpec networkLoss) {
         this.networkLoss = networkLoss;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("network-partition")
     public NetworkPartitionSpec getNetworkPartition() {
         return networkPartition;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("network-partition")
     public void setNetworkPartition(NetworkPartitionSpec networkPartition) {
         this.networkPartition = networkPartition;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("process")
     public ProcessSpec getProcess() {
         return process;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("process")
     public void setProcess(ProcessSpec process) {
         this.process = process;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("redis-cacheLimit")
     public RedisCacheLimitSpec getRedisCacheLimit() {
         return redisCacheLimit;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("redis-cacheLimit")
     public void setRedisCacheLimit(RedisCacheLimitSpec redisCacheLimit) {
         this.redisCacheLimit = redisCacheLimit;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("redis-expiration")
     public RedisExpirationSpec getRedisExpiration() {
         return redisExpiration;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("redis-expiration")
     public void setRedisExpiration(RedisExpirationSpec redisExpiration) {
         this.redisExpiration = redisExpiration;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("redis-penetration")
     public RedisPenetrationSpec getRedisPenetration() {
         return redisPenetration;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("redis-penetration")
     public void setRedisPenetration(RedisPenetrationSpec redisPenetration) {
         this.redisPenetration = redisPenetration;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("redis-restart")
     public RedisSentinelRestartSpec getRedisRestart() {
         return redisRestart;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("redis-restart")
     public void setRedisRestart(RedisSentinelRestartSpec redisRestart) {
         this.redisRestart = redisRestart;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("redis-stop")
     public RedisSentinelStopSpec getRedisStop() {
         return redisStop;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("redis-stop")
     public void setRedisStop(RedisSentinelStopSpec redisStop) {
         this.redisStop = redisStop;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public String getRemoteCluster() {
         return remoteCluster;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public void setRemoteCluster(String remoteCluster) {
         this.remoteCluster = remoteCluster;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("selector")
     public PhysicalMachineSelectorSpec getSelector() {
         return selector;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("selector")
     public void setSelector(PhysicalMachineSelectorSpec selector) {
         this.selector = selector;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("stress-cpu")
     public StressCPUSpec getStressCpu() {
         return stressCpu;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("stress-cpu")
     public void setStressCpu(StressCPUSpec stressCpu) {
         this.stressCpu = stressCpu;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("stress-mem")
     public StressMemorySpec getStressMem() {
         return stressMem;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("stress-mem")
     public void setStressMem(StressMemorySpec stressMem) {
         this.stressMem = stressMem;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("user_defined")
     public UserDefinedSpec getUserDefined() {
         return userDefined;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("user_defined")
     public void setUserDefined(UserDefinedSpec userDefined) {
         this.userDefined = userDefined;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of physical machines to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of physical machines the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of physical machines to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of physical machines the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("vm")
     public VMSpec getVm() {
         return vm;
     }
 
+    /**
+     * PhysicalMachineChaosSpec defines the desired state of PhysicalMachineChaos
+     */
     @JsonProperty("vm")
     public void setVm(VMSpec vm) {
         this.vm = vm;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineChaosStatus.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineChaosStatus.java
index da95df10ddc..efc666f9d1a 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineChaosStatus.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineChaosStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PhysicalMachineChaosStatus defines the observed state of PhysicalMachineChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public PhysicalMachineChaosStatus(List<ChaosCondition> conditions, ExperimentSta
         this.experiment = experiment;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ChaosCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ChaosCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * PhysicalMachineChaosStatus defines the observed state of PhysicalMachineChaos
+     */
     @JsonProperty("experiment")
     public ExperimentStatus getExperiment() {
         return experiment;
     }
 
+    /**
+     * PhysicalMachineChaosStatus defines the observed state of PhysicalMachineChaos
+     */
     @JsonProperty("experiment")
     public void setExperiment(ExperimentStatus experiment) {
         this.experiment = experiment;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineList.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineList.java
index 6fb720820dc..7a902099a39 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineList.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PhysicalMachineList contains a list of PhysicalMachine
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PhysicalMachineList implements Editable<PhysicalMachineListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.chaosmesh.v1alpha1.PhysicalMachine>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.chaosmesh.v1alpha1.PhysicalMachine> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PhysicalMachineList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PhysicalMachineList(String apiVersion, List<io.fabric8.chaosmesh.v1alpha1
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PhysicalMachineList contains a list of PhysicalMachine
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.chaosmesh.v1alpha1.PhysicalMachine> getItems() {
         return items;
     }
 
+    /**
+     * PhysicalMachineList contains a list of PhysicalMachine
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.chaosmesh.v1alpha1.PhysicalMachine> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PhysicalMachineList contains a list of PhysicalMachine
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PhysicalMachineList contains a list of PhysicalMachine
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineSelector.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineSelector.java
index e78c16946e4..68c38de6f9e 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineSelector.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineSelector.java
@@ -93,22 +93,34 @@ public PhysicalMachineSelector(List<String> address, String mode, PhysicalMachin
         this.value = value;
     }
 
+    /**
+     * DEPRECATED: Use Selector instead. Only one of Address and Selector could be specified.
+     */
     @JsonProperty("address")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAddress() {
         return address;
     }
 
+    /**
+     * DEPRECATED: Use Selector instead. Only one of Address and Selector could be specified.
+     */
     @JsonProperty("address")
     public void setAddress(List<String> address) {
         this.address = address;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
@@ -124,11 +136,17 @@ public void setSelector(PhysicalMachineSelectorSpec selector) {
         this.selector = selector;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of physical machines to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of physical machines the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of physical machines to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of physical machines the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineSelectorSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineSelectorSpec.java
index af6e3de8087..e269e28a31b 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineSelectorSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineSelectorSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PhysicalMachineSelectorSpec defines some selectors to select objects. If the all selectors are empty, all objects will be used in chaos experiment.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,56 +104,86 @@ public PhysicalMachineSelectorSpec(Map<String, String> annotationSelectors, Map<
         this.physicalMachines = physicalMachines;
     }
 
+    /**
+     * Map of string keys and values that can be used to select objects. A selector based on annotations.
+     */
     @JsonProperty("annotationSelectors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotationSelectors() {
         return annotationSelectors;
     }
 
+    /**
+     * Map of string keys and values that can be used to select objects. A selector based on annotations.
+     */
     @JsonProperty("annotationSelectors")
     public void setAnnotationSelectors(Map<String, String> annotationSelectors) {
         this.annotationSelectors = annotationSelectors;
     }
 
+    /**
+     * Map of string keys and values that can be used to select objects. A selector based on fields.
+     */
     @JsonProperty("fieldSelectors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getFieldSelectors() {
         return fieldSelectors;
     }
 
+    /**
+     * Map of string keys and values that can be used to select objects. A selector based on fields.
+     */
     @JsonProperty("fieldSelectors")
     public void setFieldSelectors(Map<String, String> fieldSelectors) {
         this.fieldSelectors = fieldSelectors;
     }
 
+    /**
+     * Map of string keys and values that can be used to select objects. A selector based on labels.
+     */
     @JsonProperty("labelSelectors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabelSelectors() {
         return labelSelectors;
     }
 
+    /**
+     * Map of string keys and values that can be used to select objects. A selector based on labels.
+     */
     @JsonProperty("labelSelectors")
     public void setLabelSelectors(Map<String, String> labelSelectors) {
         this.labelSelectors = labelSelectors;
     }
 
+    /**
+     * Namespaces is a set of namespace to which objects belong.
+     */
     @JsonProperty("namespaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNamespaces() {
         return namespaces;
     }
 
+    /**
+     * Namespaces is a set of namespace to which objects belong.
+     */
     @JsonProperty("namespaces")
     public void setNamespaces(List<String> namespaces) {
         this.namespaces = namespaces;
     }
 
+    /**
+     * PhysicalMachines is a map of string keys and a set values that used to select physical machines. The key defines the namespace which physical machine belong, and each value is a set of physical machine names.
+     */
     @JsonProperty("physicalMachines")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<String>> getPhysicalMachines() {
         return physicalMachines;
     }
 
+    /**
+     * PhysicalMachines is a map of string keys and a set values that used to select physical machines. The key defines the namespace which physical machine belong, and each value is a set of physical machine names.
+     */
     @JsonProperty("physicalMachines")
     public void setPhysicalMachines(Map<String, List<String>> physicalMachines) {
         this.physicalMachines = physicalMachines;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineSpec.java
index 26cacb71add..90afec2d974 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PhysicalMachineSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PhysicalMachineSpec defines the desired state of PhysicalMachine
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public PhysicalMachineSpec(String address) {
         this.address = address;
     }
 
+    /**
+     * Address represents the address of the physical machine
+     */
     @JsonProperty("address")
     public String getAddress() {
         return address;
     }
 
+    /**
+     * Address represents the address of the physical machine
+     */
     @JsonProperty("address")
     public void setAddress(String address) {
         this.address = address;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodChaos.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodChaos.java
index e5dad9e7d3f..0204706d2bc 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodChaos.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodChaos.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodChaos is the control script`s spec.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class PodChaos implements Editable<PodChaosBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodChaos";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PodChaos(String apiVersion, String kind, ObjectMeta metadata, PodChaosSpe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodChaos is the control script`s spec.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodChaos is the control script`s spec.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PodChaos is the control script`s spec.
+     */
     @JsonProperty("spec")
     public PodChaosSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PodChaos is the control script`s spec.
+     */
     @JsonProperty("spec")
     public void setSpec(PodChaosSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PodChaos is the control script`s spec.
+     */
     @JsonProperty("status")
     public PodChaosStatus getStatus() {
         return status;
     }
 
+    /**
+     * PodChaos is the control script`s spec.
+     */
     @JsonProperty("status")
     public void setStatus(PodChaosStatus status) {
         this.status = status;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodChaosList.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodChaosList.java
index 88a90f3a1bf..6f053bcd79b 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodChaosList.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodChaosList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodChaosList contains a list of PodChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PodChaosList implements Editable<PodChaosListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.chaosmesh.v1alpha1.PodChaos>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.chaosmesh.v1alpha1.PodChaos> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodChaosList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PodChaosList(String apiVersion, List<io.fabric8.chaosmesh.v1alpha1.PodCha
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PodChaosList contains a list of PodChaos
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.chaosmesh.v1alpha1.PodChaos> getItems() {
         return items;
     }
 
+    /**
+     * PodChaosList contains a list of PodChaos
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.chaosmesh.v1alpha1.PodChaos> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodChaosList contains a list of PodChaos
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodChaosList contains a list of PodChaos
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodChaosSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodChaosSpec.java
index 6435f3946b7..fee97388d7a 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodChaosSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodChaosSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodChaosSpec defines the attributes that a user creates on a chaos experiment about pods.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -109,82 +112,130 @@ public PodChaosSpec(String action, List<String> containerNames, String duration,
         this.value = value;
     }
 
+    /**
+     * Action defines the specific pod chaos action. Supported action: pod-kill / pod-failure / container-kill Default action: pod-kill
+     */
     @JsonProperty("action")
     public String getAction() {
         return action;
     }
 
+    /**
+     * Action defines the specific pod chaos action. Supported action: pod-kill / pod-failure / container-kill Default action: pod-kill
+     */
     @JsonProperty("action")
     public void setAction(String action) {
         this.action = action;
     }
 
+    /**
+     * ContainerNames indicates list of the name of affected container. If not set, the first container will be injected
+     */
     @JsonProperty("containerNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getContainerNames() {
         return containerNames;
     }
 
+    /**
+     * ContainerNames indicates list of the name of affected container. If not set, the first container will be injected
+     */
     @JsonProperty("containerNames")
     public void setContainerNames(List<String> containerNames) {
         this.containerNames = containerNames;
     }
 
+    /**
+     * Duration represents the duration of the chaos action. It is required when the action is `PodFailureAction`. A duration string is a possibly signed sequence of decimal numbers, each with optional fraction and a unit suffix, such as "300ms", "-1.5h" or "2h45m". Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h".
+     */
     @JsonProperty("duration")
     public String getDuration() {
         return duration;
     }
 
+    /**
+     * Duration represents the duration of the chaos action. It is required when the action is `PodFailureAction`. A duration string is a possibly signed sequence of decimal numbers, each with optional fraction and a unit suffix, such as "300ms", "-1.5h" or "2h45m". Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h".
+     */
     @JsonProperty("duration")
     public void setDuration(String duration) {
         this.duration = duration;
     }
 
+    /**
+     * GracePeriod is used in pod-kill action. It represents the duration in seconds before the pod should be deleted. Value must be non-negative integer. The default value is zero that indicates delete immediately.
+     */
     @JsonProperty("gracePeriod")
     public Long getGracePeriod() {
         return gracePeriod;
     }
 
+    /**
+     * GracePeriod is used in pod-kill action. It represents the duration in seconds before the pod should be deleted. Value must be non-negative integer. The default value is zero that indicates delete immediately.
+     */
     @JsonProperty("gracePeriod")
     public void setGracePeriod(Long gracePeriod) {
         this.gracePeriod = gracePeriod;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public String getRemoteCluster() {
         return remoteCluster;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public void setRemoteCluster(String remoteCluster) {
         this.remoteCluster = remoteCluster;
     }
 
+    /**
+     * PodChaosSpec defines the attributes that a user creates on a chaos experiment about pods.
+     */
     @JsonProperty("selector")
     public PodSelectorSpec getSelector() {
         return selector;
     }
 
+    /**
+     * PodChaosSpec defines the attributes that a user creates on a chaos experiment about pods.
+     */
     @JsonProperty("selector")
     public void setSelector(PodSelectorSpec selector) {
         this.selector = selector;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of pods to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of pods the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of pods to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of pods the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodChaosStatus.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodChaosStatus.java
index e0d32239910..3eff6ecf537 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodChaosStatus.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodChaosStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodChaosStatus represents the current status of the chaos experiment about pods.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public PodChaosStatus(List<ChaosCondition> conditions, ExperimentStatus experime
         this.experiment = experiment;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ChaosCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ChaosCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * PodChaosStatus represents the current status of the chaos experiment about pods.
+     */
     @JsonProperty("experiment")
     public ExperimentStatus getExperiment() {
         return experiment;
     }
 
+    /**
+     * PodChaosStatus represents the current status of the chaos experiment about pods.
+     */
     @JsonProperty("experiment")
     public void setExperiment(ExperimentStatus experiment) {
         this.experiment = experiment;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaos.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaos.java
index 906a8442b80..86ff9198b9f 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaos.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaos.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodHttpChaos is the Schema for the podhttpchaos API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class PodHttpChaos implements Editable<PodHttpChaosBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodHttpChaos";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PodHttpChaos(String apiVersion, String kind, ObjectMeta metadata, PodHttp
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodHttpChaos is the Schema for the podhttpchaos API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodHttpChaos is the Schema for the podhttpchaos API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PodHttpChaos is the Schema for the podhttpchaos API
+     */
     @JsonProperty("spec")
     public PodHttpChaosSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PodHttpChaos is the Schema for the podhttpchaos API
+     */
     @JsonProperty("spec")
     public void setSpec(PodHttpChaosSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PodHttpChaos is the Schema for the podhttpchaos API
+     */
     @JsonProperty("status")
     public PodHttpChaosStatus getStatus() {
         return status;
     }
 
+    /**
+     * PodHttpChaos is the Schema for the podhttpchaos API
+     */
     @JsonProperty("status")
     public void setStatus(PodHttpChaosStatus status) {
         this.status = status;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosActions.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosActions.java
index cc73169473c..1ed6dd0bcc5 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosActions.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosActions.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodHttpChaosActions defines possible actions of HttpChaos.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public PodHttpChaosActions(Boolean abort, String delay, PodHttpChaosPatchActions
         this.replace = replace;
     }
 
+    /**
+     * Abort is a rule to abort a http session.
+     */
     @JsonProperty("abort")
     public Boolean getAbort() {
         return abort;
     }
 
+    /**
+     * Abort is a rule to abort a http session.
+     */
     @JsonProperty("abort")
     public void setAbort(Boolean abort) {
         this.abort = abort;
     }
 
+    /**
+     * Delay represents the delay of the target request/response. A duration string is a possibly unsigned sequence of decimal numbers, each with optional fraction and a unit suffix, such as "300ms", "2h45m". Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h".
+     */
     @JsonProperty("delay")
     public String getDelay() {
         return delay;
     }
 
+    /**
+     * Delay represents the delay of the target request/response. A duration string is a possibly unsigned sequence of decimal numbers, each with optional fraction and a unit suffix, such as "300ms", "2h45m". Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h".
+     */
     @JsonProperty("delay")
     public void setDelay(String delay) {
         this.delay = delay;
     }
 
+    /**
+     * PodHttpChaosActions defines possible actions of HttpChaos.
+     */
     @JsonProperty("patch")
     public PodHttpChaosPatchActions getPatch() {
         return patch;
     }
 
+    /**
+     * PodHttpChaosActions defines possible actions of HttpChaos.
+     */
     @JsonProperty("patch")
     public void setPatch(PodHttpChaosPatchActions patch) {
         this.patch = patch;
     }
 
+    /**
+     * PodHttpChaosActions defines possible actions of HttpChaos.
+     */
     @JsonProperty("replace")
     public PodHttpChaosReplaceActions getReplace() {
         return replace;
     }
 
+    /**
+     * PodHttpChaosActions defines possible actions of HttpChaos.
+     */
     @JsonProperty("replace")
     public void setReplace(PodHttpChaosReplaceActions replace) {
         this.replace = replace;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosBaseRule.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosBaseRule.java
index 34bb6bbb65f..977e22ffeb3 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosBaseRule.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosBaseRule.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodHttpChaosBaseRule defines the injection rule without source and port.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public PodHttpChaosBaseRule(PodHttpChaosActions actions, PodHttpChaosSelector se
         this.target = target;
     }
 
+    /**
+     * PodHttpChaosBaseRule defines the injection rule without source and port.
+     */
     @JsonProperty("actions")
     public PodHttpChaosActions getActions() {
         return actions;
     }
 
+    /**
+     * PodHttpChaosBaseRule defines the injection rule without source and port.
+     */
     @JsonProperty("actions")
     public void setActions(PodHttpChaosActions actions) {
         this.actions = actions;
     }
 
+    /**
+     * PodHttpChaosBaseRule defines the injection rule without source and port.
+     */
     @JsonProperty("selector")
     public PodHttpChaosSelector getSelector() {
         return selector;
     }
 
+    /**
+     * PodHttpChaosBaseRule defines the injection rule without source and port.
+     */
     @JsonProperty("selector")
     public void setSelector(PodHttpChaosSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * Target is the object to be selected and injected, &lt;Request|Response&gt;.
+     */
     @JsonProperty("target")
     public String getTarget() {
         return target;
     }
 
+    /**
+     * Target is the object to be selected and injected, &lt;Request|Response&gt;.
+     */
     @JsonProperty("target")
     public void setTarget(String target) {
         this.target = target;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosList.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosList.java
index afd9f400262..bea303ad3fd 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosList.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodHttpChaosList contains a list of PodHttpChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PodHttpChaosList implements Editable<PodHttpChaosListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.chaosmesh.v1alpha1.PodHttpChaos>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.chaosmesh.v1alpha1.PodHttpChaos> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodHttpChaosList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PodHttpChaosList(String apiVersion, List<io.fabric8.chaosmesh.v1alpha1.Po
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PodHttpChaosList contains a list of PodHttpChaos
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.chaosmesh.v1alpha1.PodHttpChaos> getItems() {
         return items;
     }
 
+    /**
+     * PodHttpChaosList contains a list of PodHttpChaos
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.chaosmesh.v1alpha1.PodHttpChaos> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodHttpChaosList contains a list of PodHttpChaos
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodHttpChaosList contains a list of PodHttpChaos
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosPatchActions.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosPatchActions.java
index 130320540be..67a06dc839c 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosPatchActions.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosPatchActions.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodHttpChaosPatchActions defines possible patch-actions of HttpChaos.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public PodHttpChaosPatchActions(PodHttpChaosPatchBodyAction body, List<List<Stri
         this.queries = queries;
     }
 
+    /**
+     * PodHttpChaosPatchActions defines possible patch-actions of HttpChaos.
+     */
     @JsonProperty("body")
     public PodHttpChaosPatchBodyAction getBody() {
         return body;
     }
 
+    /**
+     * PodHttpChaosPatchActions defines possible patch-actions of HttpChaos.
+     */
     @JsonProperty("body")
     public void setBody(PodHttpChaosPatchBodyAction body) {
         this.body = body;
     }
 
+    /**
+     * Headers is a rule to append http headers of target. For example: `[["Set-Cookie", "&lt;one cookie&gt;"], ["Set-Cookie", "&lt;another cookie&gt;"]]`.
+     */
     @JsonProperty("headers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<List<String>> getHeaders() {
         return headers;
     }
 
+    /**
+     * Headers is a rule to append http headers of target. For example: `[["Set-Cookie", "&lt;one cookie&gt;"], ["Set-Cookie", "&lt;another cookie&gt;"]]`.
+     */
     @JsonProperty("headers")
     public void setHeaders(List<List<String>> headers) {
         this.headers = headers;
     }
 
+    /**
+     * Queries is a rule to append uri queries of target(Request only). For example: `[["foo", "bar"], ["foo", "unknown"]]`.
+     */
     @JsonProperty("queries")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<List<String>> getQueries() {
         return queries;
     }
 
+    /**
+     * Queries is a rule to append uri queries of target(Request only). For example: `[["foo", "bar"], ["foo", "unknown"]]`.
+     */
     @JsonProperty("queries")
     public void setQueries(List<List<String>> queries) {
         this.queries = queries;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosPatchBodyAction.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosPatchBodyAction.java
index f8a290dcd4a..46bb0d86d1a 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosPatchBodyAction.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosPatchBodyAction.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodHttpChaosPatchBodyAction defines patch body action of HttpChaos.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PodHttpChaosPatchBodyAction(String type, String value) {
         this.value = value;
     }
 
+    /**
+     * Type represents the patch type, only support `JSON` as [merge patch json](https://tools.ietf.org/html/rfc7396) currently.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type represents the patch type, only support `JSON` as [merge patch json](https://tools.ietf.org/html/rfc7396) currently.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * Value is the patch contents.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is the patch contents.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosReplaceActions.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosReplaceActions.java
index 76e9512e5ec..c795bf22fb5 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosReplaceActions.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosReplaceActions.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodHttpChaosReplaceActions defines possible replace-actions of HttpChaos.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -100,63 +103,99 @@ public PodHttpChaosReplaceActions(String body, Integer code, Map<String, String>
         this.queries = queries;
     }
 
+    /**
+     * Body is a rule to replace http message body in target.
+     */
     @JsonProperty("body")
     public String getBody() {
         return body;
     }
 
+    /**
+     * Body is a rule to replace http message body in target.
+     */
     @JsonProperty("body")
     public void setBody(String body) {
         this.body = body;
     }
 
+    /**
+     * Code is a rule to replace http status code in response.
+     */
     @JsonProperty("code")
     public Integer getCode() {
         return code;
     }
 
+    /**
+     * Code is a rule to replace http status code in response.
+     */
     @JsonProperty("code")
     public void setCode(Integer code) {
         this.code = code;
     }
 
+    /**
+     * Headers is a rule to replace http headers of target. The key-value pairs represent header name and header value pairs.
+     */
     @JsonProperty("headers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getHeaders() {
         return headers;
     }
 
+    /**
+     * Headers is a rule to replace http headers of target. The key-value pairs represent header name and header value pairs.
+     */
     @JsonProperty("headers")
     public void setHeaders(Map<String, String> headers) {
         this.headers = headers;
     }
 
+    /**
+     * Method is a rule to replace http method in request.
+     */
     @JsonProperty("method")
     public String getMethod() {
         return method;
     }
 
+    /**
+     * Method is a rule to replace http method in request.
+     */
     @JsonProperty("method")
     public void setMethod(String method) {
         this.method = method;
     }
 
+    /**
+     * Path is rule to to replace uri path in http request.
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Path is rule to to replace uri path in http request.
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * Queries is a rule to replace uri queries in http request. For example, with value `{ "foo": "unknown" }`, the `/?foo=bar` will be altered to `/?foo=unknown`,
+     */
     @JsonProperty("queries")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getQueries() {
         return queries;
     }
 
+    /**
+     * Queries is a rule to replace uri queries in http request. For example, with value `{ "foo": "unknown" }`, the `/?foo=bar` will be altered to `/?foo=unknown`,
+     */
     @JsonProperty("queries")
     public void setQueries(Map<String, String> queries) {
         this.queries = queries;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosRule.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosRule.java
index 6f0390e462c..93379f07949 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosRule.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosRule.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodHttpChaosRule defines the injection rule for http.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public PodHttpChaosRule(PodHttpChaosActions actions, Integer port, PodHttpChaosS
         this.target = target;
     }
 
+    /**
+     * PodHttpChaosRule defines the injection rule for http.
+     */
     @JsonProperty("actions")
     public PodHttpChaosActions getActions() {
         return actions;
     }
 
+    /**
+     * PodHttpChaosRule defines the injection rule for http.
+     */
     @JsonProperty("actions")
     public void setActions(PodHttpChaosActions actions) {
         this.actions = actions;
     }
 
+    /**
+     * Port represents the target port to be proxy of.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * Port represents the target port to be proxy of.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * PodHttpChaosRule defines the injection rule for http.
+     */
     @JsonProperty("selector")
     public PodHttpChaosSelector getSelector() {
         return selector;
     }
 
+    /**
+     * PodHttpChaosRule defines the injection rule for http.
+     */
     @JsonProperty("selector")
     public void setSelector(PodHttpChaosSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * Source represents the source of current rules
+     */
     @JsonProperty("source")
     public String getSource() {
         return source;
     }
 
+    /**
+     * Source represents the source of current rules
+     */
     @JsonProperty("source")
     public void setSource(String source) {
         this.source = source;
     }
 
+    /**
+     * Target is the object to be selected and injected, &lt;Request|Response&gt;.
+     */
     @JsonProperty("target")
     public String getTarget() {
         return target;
     }
 
+    /**
+     * Target is the object to be selected and injected, &lt;Request|Response&gt;.
+     */
     @JsonProperty("target")
     public void setTarget(String target) {
         this.target = target;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosSelector.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosSelector.java
index b6b2d18d144..d2f18f8a7da 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosSelector.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosSelector.java
@@ -100,63 +100,99 @@ public PodHttpChaosSelector(Integer code, String method, String path, Integer po
         this.responseHeaders = responseHeaders;
     }
 
+    /**
+     * Code is a rule to select target by http status code in response.
+     */
     @JsonProperty("code")
     public Integer getCode() {
         return code;
     }
 
+    /**
+     * Code is a rule to select target by http status code in response.
+     */
     @JsonProperty("code")
     public void setCode(Integer code) {
         this.code = code;
     }
 
+    /**
+     * Method is a rule to select target by http method in request.
+     */
     @JsonProperty("method")
     public String getMethod() {
         return method;
     }
 
+    /**
+     * Method is a rule to select target by http method in request.
+     */
     @JsonProperty("method")
     public void setMethod(String method) {
         this.method = method;
     }
 
+    /**
+     * Path is a rule to select target by uri path in http request.
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Path is a rule to select target by uri path in http request.
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * Port is a rule to select server listening on specific port.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * Port is a rule to select server listening on specific port.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * RequestHeaders is a rule to select target by http headers in request. The key-value pairs represent header name and header value pairs.
+     */
     @JsonProperty("request_headers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getRequestHeaders() {
         return requestHeaders;
     }
 
+    /**
+     * RequestHeaders is a rule to select target by http headers in request. The key-value pairs represent header name and header value pairs.
+     */
     @JsonProperty("request_headers")
     public void setRequestHeaders(Map<String, String> requestHeaders) {
         this.requestHeaders = requestHeaders;
     }
 
+    /**
+     * ResponseHeaders is a rule to select target by http headers in response. The key-value pairs represent header name and header value pairs.
+     */
     @JsonProperty("response_headers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getResponseHeaders() {
         return responseHeaders;
     }
 
+    /**
+     * ResponseHeaders is a rule to select target by http headers in response. The key-value pairs represent header name and header value pairs.
+     */
     @JsonProperty("response_headers")
     public void setResponseHeaders(Map<String, String> responseHeaders) {
         this.responseHeaders = responseHeaders;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosSpec.java
index bd7a20427de..7d0c49f6e99 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodHttpChaosSpec defines the desired state of PodHttpChaos.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public PodHttpChaosSpec(List<PodHttpChaosRule> rules, PodHttpChaosTLS tls) {
         this.tls = tls;
     }
 
+    /**
+     * Rules are a list of injection rule for http request.
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PodHttpChaosRule> getRules() {
         return rules;
     }
 
+    /**
+     * Rules are a list of injection rule for http request.
+     */
     @JsonProperty("rules")
     public void setRules(List<PodHttpChaosRule> rules) {
         this.rules = rules;
     }
 
+    /**
+     * PodHttpChaosSpec defines the desired state of PodHttpChaos.
+     */
     @JsonProperty("tls")
     public PodHttpChaosTLS getTls() {
         return tls;
     }
 
+    /**
+     * PodHttpChaosSpec defines the desired state of PodHttpChaos.
+     */
     @JsonProperty("tls")
     public void setTls(PodHttpChaosTLS tls) {
         this.tls = tls;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosStatus.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosStatus.java
index b80b5c044f5..a9e7f4e986f 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosStatus.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodHttpChaosStatus defines the actual state of PodHttpChaos.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public PodHttpChaosStatus(String failedMessage, Long observedGeneration, Long pi
         this.startTime = startTime;
     }
 
+    /**
+     * PodHttpChaosStatus defines the actual state of PodHttpChaos.
+     */
     @JsonProperty("failedMessage")
     public String getFailedMessage() {
         return failedMessage;
     }
 
+    /**
+     * PodHttpChaosStatus defines the actual state of PodHttpChaos.
+     */
     @JsonProperty("failedMessage")
     public void setFailedMessage(String failedMessage) {
         this.failedMessage = failedMessage;
     }
 
+    /**
+     * PodHttpChaosStatus defines the actual state of PodHttpChaos.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * PodHttpChaosStatus defines the actual state of PodHttpChaos.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Pid represents a running tproxy process id.
+     */
     @JsonProperty("pid")
     public Long getPid() {
         return pid;
     }
 
+    /**
+     * Pid represents a running tproxy process id.
+     */
     @JsonProperty("pid")
     public void setPid(Long pid) {
         this.pid = pid;
     }
 
+    /**
+     * StartTime represents the start time of a tproxy process.
+     */
     @JsonProperty("startTime")
     public Long getStartTime() {
         return startTime;
     }
 
+    /**
+     * StartTime represents the start time of a tproxy process.
+     */
     @JsonProperty("startTime")
     public void setStartTime(Long startTime) {
         this.startTime = startTime;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosTLS.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosTLS.java
index 4e06cd40480..c68b4ed038a 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosTLS.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodHttpChaosTLS.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodHttpChaosTLS contains the tls config for HTTPChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public PodHttpChaosTLS(String caName, String certName, String keyName, String se
         this.secretNamespace = secretNamespace;
     }
 
+    /**
+     * CAName represents the data name of ca file in secret, `ca.crt` for example
+     */
     @JsonProperty("caName")
     public String getCaName() {
         return caName;
     }
 
+    /**
+     * CAName represents the data name of ca file in secret, `ca.crt` for example
+     */
     @JsonProperty("caName")
     public void setCaName(String caName) {
         this.caName = caName;
     }
 
+    /**
+     * CertName represents the data name of cert file in secret, `tls.crt` for example
+     */
     @JsonProperty("certName")
     public String getCertName() {
         return certName;
     }
 
+    /**
+     * CertName represents the data name of cert file in secret, `tls.crt` for example
+     */
     @JsonProperty("certName")
     public void setCertName(String certName) {
         this.certName = certName;
     }
 
+    /**
+     * KeyName represents the data name of key file in secret, `tls.key` for example
+     */
     @JsonProperty("keyName")
     public String getKeyName() {
         return keyName;
     }
 
+    /**
+     * KeyName represents the data name of key file in secret, `tls.key` for example
+     */
     @JsonProperty("keyName")
     public void setKeyName(String keyName) {
         this.keyName = keyName;
     }
 
+    /**
+     * SecretName represents the name of required secret resource
+     */
     @JsonProperty("secretName")
     public String getSecretName() {
         return secretName;
     }
 
+    /**
+     * SecretName represents the name of required secret resource
+     */
     @JsonProperty("secretName")
     public void setSecretName(String secretName) {
         this.secretName = secretName;
     }
 
+    /**
+     * SecretNamespace represents the namespace of required secret resource
+     */
     @JsonProperty("secretNamespace")
     public String getSecretNamespace() {
         return secretNamespace;
     }
 
+    /**
+     * SecretNamespace represents the namespace of required secret resource
+     */
     @JsonProperty("secretNamespace")
     public void setSecretNamespace(String secretNamespace) {
         this.secretNamespace = secretNamespace;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodIOChaos.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodIOChaos.java
index fc60245642e..4a550fa4a98 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodIOChaos.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodIOChaos.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodIOChaos is the Schema for the podiochaos API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class PodIOChaos implements Editable<PodIOChaosBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodIOChaos";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PodIOChaos(String apiVersion, String kind, ObjectMeta metadata, PodIOChao
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodIOChaos is the Schema for the podiochaos API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodIOChaos is the Schema for the podiochaos API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PodIOChaos is the Schema for the podiochaos API
+     */
     @JsonProperty("spec")
     public PodIOChaosSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PodIOChaos is the Schema for the podiochaos API
+     */
     @JsonProperty("spec")
     public void setSpec(PodIOChaosSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PodIOChaos is the Schema for the podiochaos API
+     */
     @JsonProperty("status")
     public PodIOChaosStatus getStatus() {
         return status;
     }
 
+    /**
+     * PodIOChaos is the Schema for the podiochaos API
+     */
     @JsonProperty("status")
     public void setStatus(PodIOChaosStatus status) {
         this.status = status;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodIOChaosList.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodIOChaosList.java
index 311c9e8adaf..6fc81ee27bc 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodIOChaosList.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodIOChaosList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodIOChaosList contains a list of PodIOChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PodIOChaosList implements Editable<PodIOChaosListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.chaosmesh.v1alpha1.PodIOChaos>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.chaosmesh.v1alpha1.PodIOChaos> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodIOChaosList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PodIOChaosList(String apiVersion, List<io.fabric8.chaosmesh.v1alpha1.PodI
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PodIOChaosList contains a list of PodIOChaos
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.chaosmesh.v1alpha1.PodIOChaos> getItems() {
         return items;
     }
 
+    /**
+     * PodIOChaosList contains a list of PodIOChaos
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.chaosmesh.v1alpha1.PodIOChaos> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodIOChaosList contains a list of PodIOChaos
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodIOChaosList contains a list of PodIOChaos
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodIOChaosSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodIOChaosSpec.java
index f995d9dfc32..a66c1074d19 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodIOChaosSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodIOChaosSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodIOChaosSpec defines the desired state of IOChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public PodIOChaosSpec(List<IOChaosAction> actions, String container, String volu
         this.volumeMountPath = volumeMountPath;
     }
 
+    /**
+     * Actions are a list of IOChaos actions
+     */
     @JsonProperty("actions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IOChaosAction> getActions() {
         return actions;
     }
 
+    /**
+     * Actions are a list of IOChaos actions
+     */
     @JsonProperty("actions")
     public void setActions(List<IOChaosAction> actions) {
         this.actions = actions;
     }
 
+    /**
+     * PodIOChaosSpec defines the desired state of IOChaos
+     */
     @JsonProperty("container")
     public String getContainer() {
         return container;
     }
 
+    /**
+     * PodIOChaosSpec defines the desired state of IOChaos
+     */
     @JsonProperty("container")
     public void setContainer(String container) {
         this.container = container;
     }
 
+    /**
+     * VolumeMountPath represents the target mount path It must be a root of mount path now.
+     */
     @JsonProperty("volumeMountPath")
     public String getVolumeMountPath() {
         return volumeMountPath;
     }
 
+    /**
+     * VolumeMountPath represents the target mount path It must be a root of mount path now.
+     */
     @JsonProperty("volumeMountPath")
     public void setVolumeMountPath(String volumeMountPath) {
         this.volumeMountPath = volumeMountPath;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodIOChaosStatus.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodIOChaosStatus.java
index 6571b87c5ea..d209c08125a 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodIOChaosStatus.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodIOChaosStatus.java
@@ -110,21 +110,33 @@ public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Pid represents a running toda process id
+     */
     @JsonProperty("pid")
     public Long getPid() {
         return pid;
     }
 
+    /**
+     * Pid represents a running toda process id
+     */
     @JsonProperty("pid")
     public void setPid(Long pid) {
         this.pid = pid;
     }
 
+    /**
+     * StartTime represents the start time of a toda process
+     */
     @JsonProperty("startTime")
     public Long getStartTime() {
         return startTime;
     }
 
+    /**
+     * StartTime represents the start time of a toda process
+     */
     @JsonProperty("startTime")
     public void setStartTime(Long startTime) {
         this.startTime = startTime;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodNetworkChaos.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodNetworkChaos.java
index 7b6d2c63995..4e2b9389f98 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodNetworkChaos.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodNetworkChaos.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodNetworkChaos is the Schema for the PodNetworkChaos API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class PodNetworkChaos implements Editable<PodNetworkChaosBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodNetworkChaos";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PodNetworkChaos(String apiVersion, String kind, ObjectMeta metadata, PodN
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodNetworkChaos is the Schema for the PodNetworkChaos API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodNetworkChaos is the Schema for the PodNetworkChaos API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PodNetworkChaos is the Schema for the PodNetworkChaos API
+     */
     @JsonProperty("spec")
     public PodNetworkChaosSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PodNetworkChaos is the Schema for the PodNetworkChaos API
+     */
     @JsonProperty("spec")
     public void setSpec(PodNetworkChaosSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PodNetworkChaos is the Schema for the PodNetworkChaos API
+     */
     @JsonProperty("status")
     public PodNetworkChaosStatus getStatus() {
         return status;
     }
 
+    /**
+     * PodNetworkChaos is the Schema for the PodNetworkChaos API
+     */
     @JsonProperty("status")
     public void setStatus(PodNetworkChaosStatus status) {
         this.status = status;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodNetworkChaosList.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodNetworkChaosList.java
index 06e8af22ece..791b1672ae0 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodNetworkChaosList.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodNetworkChaosList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodNetworkChaosList contains a list of PodNetworkChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PodNetworkChaosList implements Editable<PodNetworkChaosListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.chaosmesh.v1alpha1.PodNetworkChaos>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.chaosmesh.v1alpha1.PodNetworkChaos> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodNetworkChaosList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PodNetworkChaosList(String apiVersion, List<io.fabric8.chaosmesh.v1alpha1
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PodNetworkChaosList contains a list of PodNetworkChaos
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.chaosmesh.v1alpha1.PodNetworkChaos> getItems() {
         return items;
     }
 
+    /**
+     * PodNetworkChaosList contains a list of PodNetworkChaos
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.chaosmesh.v1alpha1.PodNetworkChaos> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodNetworkChaosList contains a list of PodNetworkChaos
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodNetworkChaosList contains a list of PodNetworkChaos
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodNetworkChaosSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodNetworkChaosSpec.java
index be2300140a1..62e6802f2bd 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodNetworkChaosSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodNetworkChaosSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodNetworkChaosSpec defines the desired state of PodNetworkChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,34 +94,52 @@ public PodNetworkChaosSpec(List<RawIPSet> ipsets, List<RawIptables> iptables, Li
         this.tcs = tcs;
     }
 
+    /**
+     * The ipset on the pod
+     */
     @JsonProperty("ipsets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RawIPSet> getIpsets() {
         return ipsets;
     }
 
+    /**
+     * The ipset on the pod
+     */
     @JsonProperty("ipsets")
     public void setIpsets(List<RawIPSet> ipsets) {
         this.ipsets = ipsets;
     }
 
+    /**
+     * The iptables rules on the pod
+     */
     @JsonProperty("iptables")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RawIptables> getIptables() {
         return iptables;
     }
 
+    /**
+     * The iptables rules on the pod
+     */
     @JsonProperty("iptables")
     public void setIptables(List<RawIptables> iptables) {
         this.iptables = iptables;
     }
 
+    /**
+     * The tc rules on the pod
+     */
     @JsonProperty("tcs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RawTrafficControl> getTcs() {
         return tcs;
     }
 
+    /**
+     * The tc rules on the pod
+     */
     @JsonProperty("tcs")
     public void setTcs(List<RawTrafficControl> tcs) {
         this.tcs = tcs;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodNetworkChaosStatus.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodNetworkChaosStatus.java
index bcb8e0a6fa7..50d75e27411 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodNetworkChaosStatus.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodNetworkChaosStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodNetworkChaosStatus defines the observed state of PodNetworkChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PodNetworkChaosStatus(String failedMessage, Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * PodNetworkChaosStatus defines the observed state of PodNetworkChaos
+     */
     @JsonProperty("failedMessage")
     public String getFailedMessage() {
         return failedMessage;
     }
 
+    /**
+     * PodNetworkChaosStatus defines the observed state of PodNetworkChaos
+     */
     @JsonProperty("failedMessage")
     public void setFailedMessage(String failedMessage) {
         this.failedMessage = failedMessage;
     }
 
+    /**
+     * PodNetworkChaosStatus defines the observed state of PodNetworkChaos
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * PodNetworkChaosStatus defines the observed state of PodNetworkChaos
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodSelector.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodSelector.java
index b1115526e4e..a06b95d4856 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodSelector.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodSelector.java
@@ -86,11 +86,17 @@ public PodSelector(String mode, PodSelectorSpec selector, String value) {
         this.value = value;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
@@ -106,11 +112,17 @@ public void setSelector(PodSelectorSpec selector) {
         this.selector = selector;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of pods to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of pods the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of pods to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of pods the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodSelectorSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodSelectorSpec.java
index a42c9c69824..192b641bbfa 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodSelectorSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/PodSelectorSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodSelectorSpec defines the some selectors to select objects. If the all selectors are empty, all objects will be used in chaos experiment.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -116,89 +119,137 @@ public PodSelectorSpec(Map<String, String> annotationSelectors, Map<String, Stri
         this.pods = pods;
     }
 
+    /**
+     * Map of string keys and values that can be used to select objects. A selector based on annotations.
+     */
     @JsonProperty("annotationSelectors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotationSelectors() {
         return annotationSelectors;
     }
 
+    /**
+     * Map of string keys and values that can be used to select objects. A selector based on annotations.
+     */
     @JsonProperty("annotationSelectors")
     public void setAnnotationSelectors(Map<String, String> annotationSelectors) {
         this.annotationSelectors = annotationSelectors;
     }
 
+    /**
+     * Map of string keys and values that can be used to select objects. A selector based on fields.
+     */
     @JsonProperty("fieldSelectors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getFieldSelectors() {
         return fieldSelectors;
     }
 
+    /**
+     * Map of string keys and values that can be used to select objects. A selector based on fields.
+     */
     @JsonProperty("fieldSelectors")
     public void setFieldSelectors(Map<String, String> fieldSelectors) {
         this.fieldSelectors = fieldSelectors;
     }
 
+    /**
+     * Map of string keys and values that can be used to select objects. A selector based on labels.
+     */
     @JsonProperty("labelSelectors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabelSelectors() {
         return labelSelectors;
     }
 
+    /**
+     * Map of string keys and values that can be used to select objects. A selector based on labels.
+     */
     @JsonProperty("labelSelectors")
     public void setLabelSelectors(Map<String, String> labelSelectors) {
         this.labelSelectors = labelSelectors;
     }
 
+    /**
+     * Namespaces is a set of namespace to which objects belong.
+     */
     @JsonProperty("namespaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNamespaces() {
         return namespaces;
     }
 
+    /**
+     * Namespaces is a set of namespace to which objects belong.
+     */
     @JsonProperty("namespaces")
     public void setNamespaces(List<String> namespaces) {
         this.namespaces = namespaces;
     }
 
+    /**
+     * Map of string keys and values that can be used to select nodes. Selector which must match a node's labels, and objects must belong to these selected nodes.
+     */
     @JsonProperty("nodeSelectors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelectors() {
         return nodeSelectors;
     }
 
+    /**
+     * Map of string keys and values that can be used to select nodes. Selector which must match a node's labels, and objects must belong to these selected nodes.
+     */
     @JsonProperty("nodeSelectors")
     public void setNodeSelectors(Map<String, String> nodeSelectors) {
         this.nodeSelectors = nodeSelectors;
     }
 
+    /**
+     * Nodes is a set of node name and objects must belong to these nodes.
+     */
     @JsonProperty("nodes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNodes() {
         return nodes;
     }
 
+    /**
+     * Nodes is a set of node name and objects must belong to these nodes.
+     */
     @JsonProperty("nodes")
     public void setNodes(List<String> nodes) {
         this.nodes = nodes;
     }
 
+    /**
+     * PodPhaseSelectors is a set of condition of a pod at the current time. supported value: Pending / Running / Succeeded / Failed / Unknown
+     */
     @JsonProperty("podPhaseSelectors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPodPhaseSelectors() {
         return podPhaseSelectors;
     }
 
+    /**
+     * PodPhaseSelectors is a set of condition of a pod at the current time. supported value: Pending / Running / Succeeded / Failed / Unknown
+     */
     @JsonProperty("podPhaseSelectors")
     public void setPodPhaseSelectors(List<String> podPhaseSelectors) {
         this.podPhaseSelectors = podPhaseSelectors;
     }
 
+    /**
+     * Pods is a map of string keys and a set values that used to select pods. The key defines the namespace which pods belong, and the each values is a set of pod names.
+     */
     @JsonProperty("pods")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<String>> getPods() {
         return pods;
     }
 
+    /**
+     * Pods is a map of string keys and a set values that used to select pods. The key defines the namespace which pods belong, and the each values is a set of pod names.
+     */
     @JsonProperty("pods")
     public void setPods(Map<String, List<String>> pods) {
         this.pods = pods;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ProcessSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ProcessSpec.java
index 7f231d50a83..1ccd1e0bbeb 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ProcessSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ProcessSpec.java
@@ -86,31 +86,49 @@ public ProcessSpec(String process, String recoverCmd, Integer signal) {
         this.signal = signal;
     }
 
+    /**
+     * the process name or the process ID
+     */
     @JsonProperty("process")
     public String getProcess() {
         return process;
     }
 
+    /**
+     * the process name or the process ID
+     */
     @JsonProperty("process")
     public void setProcess(String process) {
         this.process = process;
     }
 
+    /**
+     * the command to be run when recovering experiment
+     */
     @JsonProperty("recoverCmd")
     public String getRecoverCmd() {
         return recoverCmd;
     }
 
+    /**
+     * the command to be run when recovering experiment
+     */
     @JsonProperty("recoverCmd")
     public void setRecoverCmd(String recoverCmd) {
         this.recoverCmd = recoverCmd;
     }
 
+    /**
+     * the signal number to send
+     */
     @JsonProperty("signal")
     public Integer getSignal() {
         return signal;
     }
 
+    /**
+     * the signal number to send
+     */
     @JsonProperty("signal")
     public void setSignal(Integer signal) {
         this.signal = signal;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RateSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RateSpec.java
index a133316b1bc..f6dc4349a65 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RateSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RateSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RateSpec defines details of rate limit.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public RateSpec(String rate) {
         this.rate = rate;
     }
 
+    /**
+     * Rate is the speed knob. Allows bit, kbit, mbit, gbit, tbit, bps, kbps, mbps, gbps, tbps unit. bps means bytes per second.
+     */
     @JsonProperty("rate")
     public String getRate() {
         return rate;
     }
 
+    /**
+     * Rate is the speed knob. Allows bit, kbit, mbit, gbit, tbit, bps, kbps, mbps, gbps, tbps unit. bps means bytes per second.
+     */
     @JsonProperty("rate")
     public void setRate(String rate) {
         this.rate = rate;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RawIPSet.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RawIPSet.java
index 7e2b93f48eb..a971ec83044 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RawIPSet.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RawIPSet.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RawIPSet represents an ipset on specific pod
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -103,64 +106,100 @@ public RawIPSet(List<CidrAndPort> cidrAndPorts, List<String> cidrs, String ipset
         this.source = source;
     }
 
+    /**
+     * The contents of ipset. Only available when IPSetType is NetPortIPSet.
+     */
     @JsonProperty("cidrAndPorts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CidrAndPort> getCidrAndPorts() {
         return cidrAndPorts;
     }
 
+    /**
+     * The contents of ipset. Only available when IPSetType is NetPortIPSet.
+     */
     @JsonProperty("cidrAndPorts")
     public void setCidrAndPorts(List<CidrAndPort> cidrAndPorts) {
         this.cidrAndPorts = cidrAndPorts;
     }
 
+    /**
+     * The contents of ipset. Only available when IPSetType is NetIPSet.
+     */
     @JsonProperty("cidrs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCidrs() {
         return cidrs;
     }
 
+    /**
+     * The contents of ipset. Only available when IPSetType is NetIPSet.
+     */
     @JsonProperty("cidrs")
     public void setCidrs(List<String> cidrs) {
         this.cidrs = cidrs;
     }
 
+    /**
+     * RawIPSet represents an ipset on specific pod
+     */
     @JsonProperty("ipsetType")
     public String getIpsetType() {
         return ipsetType;
     }
 
+    /**
+     * RawIPSet represents an ipset on specific pod
+     */
     @JsonProperty("ipsetType")
     public void setIpsetType(String ipsetType) {
         this.ipsetType = ipsetType;
     }
 
+    /**
+     * The name of ipset
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The name of ipset
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * The contents of ipset. Only available when IPSetType is SetIPSet.
+     */
     @JsonProperty("setNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSetNames() {
         return setNames;
     }
 
+    /**
+     * The contents of ipset. Only available when IPSetType is SetIPSet.
+     */
     @JsonProperty("setNames")
     public void setSetNames(List<String> setNames) {
         this.setNames = setNames;
     }
 
+    /**
+     * RawIPSet represents an ipset on specific pod
+     */
     @JsonProperty("source")
     public String getSource() {
         return source;
     }
 
+    /**
+     * RawIPSet represents an ipset on specific pod
+     */
     @JsonProperty("source")
     public void setSource(String source) {
         this.source = source;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RawIptables.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RawIptables.java
index a8320f38ba3..ca31b8f61d5 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RawIptables.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RawIptables.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RawIptables represents the iptables rules on specific pod
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -97,52 +100,82 @@ public RawIptables(String device, String direction, List<String> ipsets, String
         this.source = source;
     }
 
+    /**
+     * Device represents the network device to be affected.
+     */
     @JsonProperty("device")
     public String getDevice() {
         return device;
     }
 
+    /**
+     * Device represents the network device to be affected.
+     */
     @JsonProperty("device")
     public void setDevice(String device) {
         this.device = device;
     }
 
+    /**
+     * The block direction of this iptables rule
+     */
     @JsonProperty("direction")
     public String getDirection() {
         return direction;
     }
 
+    /**
+     * The block direction of this iptables rule
+     */
     @JsonProperty("direction")
     public void setDirection(String direction) {
         this.direction = direction;
     }
 
+    /**
+     * The name of related ipset
+     */
     @JsonProperty("ipsets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIpsets() {
         return ipsets;
     }
 
+    /**
+     * The name of related ipset
+     */
     @JsonProperty("ipsets")
     public void setIpsets(List<String> ipsets) {
         this.ipsets = ipsets;
     }
 
+    /**
+     * The name of iptables chain
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The name of iptables chain
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * RawIptables represents the iptables rules on specific pod
+     */
     @JsonProperty("source")
     public String getSource() {
         return source;
     }
 
+    /**
+     * RawIptables represents the iptables rules on specific pod
+     */
     @JsonProperty("source")
     public void setSource(String source) {
         this.source = source;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RawRuleSource.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RawRuleSource.java
index 614648adc17..f99cd2d6f64 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RawRuleSource.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RawRuleSource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RawRuleSource represents the name and namespace of the source network chaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public RawRuleSource(String source) {
         this.source = source;
     }
 
+    /**
+     * RawRuleSource represents the name and namespace of the source network chaos
+     */
     @JsonProperty("source")
     public String getSource() {
         return source;
     }
 
+    /**
+     * RawRuleSource represents the name and namespace of the source network chaos
+     */
     @JsonProperty("source")
     public void setSource(String source) {
         this.source = source;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RawTrafficControl.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RawTrafficControl.java
index ea159d0896b..97efeec3e7d 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RawTrafficControl.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RawTrafficControl.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RawTrafficControl represents the traffic control chaos on specific pod
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -114,101 +117,161 @@ public RawTrafficControl(BandwidthSpec bandwidth, CorruptSpec corrupt, DelaySpec
         this.type = type;
     }
 
+    /**
+     * RawTrafficControl represents the traffic control chaos on specific pod
+     */
     @JsonProperty("bandwidth")
     public BandwidthSpec getBandwidth() {
         return bandwidth;
     }
 
+    /**
+     * RawTrafficControl represents the traffic control chaos on specific pod
+     */
     @JsonProperty("bandwidth")
     public void setBandwidth(BandwidthSpec bandwidth) {
         this.bandwidth = bandwidth;
     }
 
+    /**
+     * RawTrafficControl represents the traffic control chaos on specific pod
+     */
     @JsonProperty("corrupt")
     public CorruptSpec getCorrupt() {
         return corrupt;
     }
 
+    /**
+     * RawTrafficControl represents the traffic control chaos on specific pod
+     */
     @JsonProperty("corrupt")
     public void setCorrupt(CorruptSpec corrupt) {
         this.corrupt = corrupt;
     }
 
+    /**
+     * RawTrafficControl represents the traffic control chaos on specific pod
+     */
     @JsonProperty("delay")
     public DelaySpec getDelay() {
         return delay;
     }
 
+    /**
+     * RawTrafficControl represents the traffic control chaos on specific pod
+     */
     @JsonProperty("delay")
     public void setDelay(DelaySpec delay) {
         this.delay = delay;
     }
 
+    /**
+     * Device represents the network device to be affected.
+     */
     @JsonProperty("device")
     public String getDevice() {
         return device;
     }
 
+    /**
+     * Device represents the network device to be affected.
+     */
     @JsonProperty("device")
     public void setDevice(String device) {
         this.device = device;
     }
 
+    /**
+     * RawTrafficControl represents the traffic control chaos on specific pod
+     */
     @JsonProperty("duplicate")
     public DuplicateSpec getDuplicate() {
         return duplicate;
     }
 
+    /**
+     * RawTrafficControl represents the traffic control chaos on specific pod
+     */
     @JsonProperty("duplicate")
     public void setDuplicate(DuplicateSpec duplicate) {
         this.duplicate = duplicate;
     }
 
+    /**
+     * The name of target ipset
+     */
     @JsonProperty("ipset")
     public String getIpset() {
         return ipset;
     }
 
+    /**
+     * The name of target ipset
+     */
     @JsonProperty("ipset")
     public void setIpset(String ipset) {
         this.ipset = ipset;
     }
 
+    /**
+     * RawTrafficControl represents the traffic control chaos on specific pod
+     */
     @JsonProperty("loss")
     public LossSpec getLoss() {
         return loss;
     }
 
+    /**
+     * RawTrafficControl represents the traffic control chaos on specific pod
+     */
     @JsonProperty("loss")
     public void setLoss(LossSpec loss) {
         this.loss = loss;
     }
 
+    /**
+     * RawTrafficControl represents the traffic control chaos on specific pod
+     */
     @JsonProperty("rate")
     public RateSpec getRate() {
         return rate;
     }
 
+    /**
+     * RawTrafficControl represents the traffic control chaos on specific pod
+     */
     @JsonProperty("rate")
     public void setRate(RateSpec rate) {
         this.rate = rate;
     }
 
+    /**
+     * The name and namespace of the source network chaos
+     */
     @JsonProperty("source")
     public String getSource() {
         return source;
     }
 
+    /**
+     * The name and namespace of the source network chaos
+     */
     @JsonProperty("source")
     public void setSource(String source) {
         this.source = source;
     }
 
+    /**
+     * The type of traffic control
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * The type of traffic control
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Record.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Record.java
index acb4f0ef29d..3983aa3cba7 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Record.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Record.java
@@ -101,12 +101,18 @@ public Record(List<RecordEvent> events, String id, Integer injectedCount, String
         this.selectorKey = selectorKey;
     }
 
+    /**
+     * Events are the essential details about the injections and recoveries
+     */
     @JsonProperty("events")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RecordEvent> getEvents() {
         return events;
     }
 
+    /**
+     * Events are the essential details about the injections and recoveries
+     */
     @JsonProperty("events")
     public void setEvents(List<RecordEvent> events) {
         this.events = events;
@@ -122,11 +128,17 @@ public void setId(String id) {
         this.id = id;
     }
 
+    /**
+     * InjectedCount is a counter to record the sum of successful injections
+     */
     @JsonProperty("injectedCount")
     public Integer getInjectedCount() {
         return injectedCount;
     }
 
+    /**
+     * InjectedCount is a counter to record the sum of successful injections
+     */
     @JsonProperty("injectedCount")
     public void setInjectedCount(Integer injectedCount) {
         this.injectedCount = injectedCount;
@@ -142,11 +154,17 @@ public void setPhase(String phase) {
         this.phase = phase;
     }
 
+    /**
+     * RecoveredCount is a counter to record the sum of successful recoveries
+     */
     @JsonProperty("recoveredCount")
     public Integer getRecoveredCount() {
         return recoveredCount;
     }
 
+    /**
+     * RecoveredCount is a counter to record the sum of successful recoveries
+     */
     @JsonProperty("recoveredCount")
     public void setRecoveredCount(Integer recoveredCount) {
         this.recoveredCount = recoveredCount;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RecordEvent.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RecordEvent.java
index b5f7a370ad7..b2e5d935ac5 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RecordEvent.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RecordEvent.java
@@ -90,21 +90,33 @@ public RecordEvent(String message, String operation, String timestamp, String ty
         this.type = type;
     }
 
+    /**
+     * Message is the detail message, e.g. the reason why we failed to inject the chaos
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message is the detail message, e.g. the reason why we failed to inject the chaos
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Operation represents the operation we are doing, when we crate this event
+     */
     @JsonProperty("operation")
     public String getOperation() {
         return operation;
     }
 
+    /**
+     * Operation represents the operation we are doing, when we crate this event
+     */
     @JsonProperty("operation")
     public void setOperation(String operation) {
         this.operation = operation;
@@ -120,11 +132,17 @@ public void setTimestamp(String timestamp) {
         this.timestamp = timestamp;
     }
 
+    /**
+     * Type means the stage of this event
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type means the stage of this event
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RedisCacheLimitSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RedisCacheLimitSpec.java
index 86011e7670e..3a3034c641c 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RedisCacheLimitSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RedisCacheLimitSpec.java
@@ -90,41 +90,65 @@ public RedisCacheLimitSpec(String addr, String cacheSize, String password, Strin
         this.percent = percent;
     }
 
+    /**
+     * The adress of Redis server
+     */
     @JsonProperty("addr")
     public String getAddr() {
         return addr;
     }
 
+    /**
+     * The adress of Redis server
+     */
     @JsonProperty("addr")
     public void setAddr(String addr) {
         this.addr = addr;
     }
 
+    /**
+     * The size of `maxmemory`
+     */
     @JsonProperty("cacheSize")
     public String getCacheSize() {
         return cacheSize;
     }
 
+    /**
+     * The size of `maxmemory`
+     */
     @JsonProperty("cacheSize")
     public void setCacheSize(String cacheSize) {
         this.cacheSize = cacheSize;
     }
 
+    /**
+     * The password of Redis server
+     */
     @JsonProperty("password")
     public String getPassword() {
         return password;
     }
 
+    /**
+     * The password of Redis server
+     */
     @JsonProperty("password")
     public void setPassword(String password) {
         this.password = password;
     }
 
+    /**
+     * Specifies maxmemory as a percentage of the original value
+     */
     @JsonProperty("percent")
     public String getPercent() {
         return percent;
     }
 
+    /**
+     * Specifies maxmemory as a percentage of the original value
+     */
     @JsonProperty("percent")
     public void setPercent(String percent) {
         this.percent = percent;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RedisCommonSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RedisCommonSpec.java
index 6d79a7c404a..ec89f793732 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RedisCommonSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RedisCommonSpec.java
@@ -82,21 +82,33 @@ public RedisCommonSpec(String addr, String password) {
         this.password = password;
     }
 
+    /**
+     * The adress of Redis server
+     */
     @JsonProperty("addr")
     public String getAddr() {
         return addr;
     }
 
+    /**
+     * The adress of Redis server
+     */
     @JsonProperty("addr")
     public void setAddr(String addr) {
         this.addr = addr;
     }
 
+    /**
+     * The password of Redis server
+     */
     @JsonProperty("password")
     public String getPassword() {
         return password;
     }
 
+    /**
+     * The password of Redis server
+     */
     @JsonProperty("password")
     public void setPassword(String password) {
         this.password = password;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RedisExpirationSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RedisExpirationSpec.java
index 1f3ae9c702c..928ac7e7085 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RedisExpirationSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RedisExpirationSpec.java
@@ -94,51 +94,81 @@ public RedisExpirationSpec(String addr, String expiration, String key, String op
         this.password = password;
     }
 
+    /**
+     * The adress of Redis server
+     */
     @JsonProperty("addr")
     public String getAddr() {
         return addr;
     }
 
+    /**
+     * The adress of Redis server
+     */
     @JsonProperty("addr")
     public void setAddr(String addr) {
         this.addr = addr;
     }
 
+    /**
+     * The expiration of the keys
+     */
     @JsonProperty("expiration")
     public String getExpiration() {
         return expiration;
     }
 
+    /**
+     * The expiration of the keys
+     */
     @JsonProperty("expiration")
     public void setExpiration(String expiration) {
         this.expiration = expiration;
     }
 
+    /**
+     * The keys to be expired
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * The keys to be expired
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * Additional options for `expiration`
+     */
     @JsonProperty("option")
     public String getOption() {
         return option;
     }
 
+    /**
+     * Additional options for `expiration`
+     */
     @JsonProperty("option")
     public void setOption(String option) {
         this.option = option;
     }
 
+    /**
+     * The password of Redis server
+     */
     @JsonProperty("password")
     public String getPassword() {
         return password;
     }
 
+    /**
+     * The password of Redis server
+     */
     @JsonProperty("password")
     public void setPassword(String password) {
         this.password = password;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RedisPenetrationSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RedisPenetrationSpec.java
index 9297e46c3ba..354d49e559d 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RedisPenetrationSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RedisPenetrationSpec.java
@@ -86,31 +86,49 @@ public RedisPenetrationSpec(String addr, String password, Integer requestNum) {
         this.requestNum = requestNum;
     }
 
+    /**
+     * The adress of Redis server
+     */
     @JsonProperty("addr")
     public String getAddr() {
         return addr;
     }
 
+    /**
+     * The adress of Redis server
+     */
     @JsonProperty("addr")
     public void setAddr(String addr) {
         this.addr = addr;
     }
 
+    /**
+     * The password of Redis server
+     */
     @JsonProperty("password")
     public String getPassword() {
         return password;
     }
 
+    /**
+     * The password of Redis server
+     */
     @JsonProperty("password")
     public void setPassword(String password) {
         this.password = password;
     }
 
+    /**
+     * The number of requests to be sent
+     */
     @JsonProperty("requestNum")
     public Integer getRequestNum() {
         return requestNum;
     }
 
+    /**
+     * The number of requests to be sent
+     */
     @JsonProperty("requestNum")
     public void setRequestNum(Integer requestNum) {
         this.requestNum = requestNum;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RedisSentinelRestartSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RedisSentinelRestartSpec.java
index 93d8267f116..e2c72166075 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RedisSentinelRestartSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RedisSentinelRestartSpec.java
@@ -94,51 +94,81 @@ public RedisSentinelRestartSpec(String addr, String conf, Boolean flushConfig, S
         this.redisPath = redisPath;
     }
 
+    /**
+     * The adress of Redis server
+     */
     @JsonProperty("addr")
     public String getAddr() {
         return addr;
     }
 
+    /**
+     * The adress of Redis server
+     */
     @JsonProperty("addr")
     public void setAddr(String addr) {
         this.addr = addr;
     }
 
+    /**
+     * The path of Sentinel conf
+     */
     @JsonProperty("conf")
     public String getConf() {
         return conf;
     }
 
+    /**
+     * The path of Sentinel conf
+     */
     @JsonProperty("conf")
     public void setConf(String conf) {
         this.conf = conf;
     }
 
+    /**
+     * The control flag determines whether to flush config
+     */
     @JsonProperty("flushConfig")
     public Boolean getFlushConfig() {
         return flushConfig;
     }
 
+    /**
+     * The control flag determines whether to flush config
+     */
     @JsonProperty("flushConfig")
     public void setFlushConfig(Boolean flushConfig) {
         this.flushConfig = flushConfig;
     }
 
+    /**
+     * The password of Redis server
+     */
     @JsonProperty("password")
     public String getPassword() {
         return password;
     }
 
+    /**
+     * The password of Redis server
+     */
     @JsonProperty("password")
     public void setPassword(String password) {
         this.password = password;
     }
 
+    /**
+     * The path of `redis-server` command-line tool
+     */
     @JsonProperty("redisPath")
     public Boolean getRedisPath() {
         return redisPath;
     }
 
+    /**
+     * The path of `redis-server` command-line tool
+     */
     @JsonProperty("redisPath")
     public void setRedisPath(Boolean redisPath) {
         this.redisPath = redisPath;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RedisSentinelStopSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RedisSentinelStopSpec.java
index 5f7cb31e78f..fe8525ca8a8 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RedisSentinelStopSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RedisSentinelStopSpec.java
@@ -94,51 +94,81 @@ public RedisSentinelStopSpec(String addr, String conf, Boolean flushConfig, Stri
         this.redisPath = redisPath;
     }
 
+    /**
+     * The adress of Redis server
+     */
     @JsonProperty("addr")
     public String getAddr() {
         return addr;
     }
 
+    /**
+     * The adress of Redis server
+     */
     @JsonProperty("addr")
     public void setAddr(String addr) {
         this.addr = addr;
     }
 
+    /**
+     * The path of Sentinel conf
+     */
     @JsonProperty("conf")
     public String getConf() {
         return conf;
     }
 
+    /**
+     * The path of Sentinel conf
+     */
     @JsonProperty("conf")
     public void setConf(String conf) {
         this.conf = conf;
     }
 
+    /**
+     * The control flag determines whether to flush config
+     */
     @JsonProperty("flushConfig")
     public Boolean getFlushConfig() {
         return flushConfig;
     }
 
+    /**
+     * The control flag determines whether to flush config
+     */
     @JsonProperty("flushConfig")
     public void setFlushConfig(Boolean flushConfig) {
         this.flushConfig = flushConfig;
     }
 
+    /**
+     * The password of Redis server
+     */
     @JsonProperty("password")
     public String getPassword() {
         return password;
     }
 
+    /**
+     * The password of Redis server
+     */
     @JsonProperty("password")
     public void setPassword(String password) {
         this.password = password;
     }
 
+    /**
+     * The path of `redis-server` command-line tool
+     */
     @JsonProperty("redisPath")
     public Boolean getRedisPath() {
         return redisPath;
     }
 
+    /**
+     * The path of `redis-server` command-line tool
+     */
     @JsonProperty("redisPath")
     public void setRedisPath(Boolean redisPath) {
         this.redisPath = redisPath;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RemoteCluster.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RemoteCluster.java
index d391d7617e5..df86a80e394 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RemoteCluster.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RemoteCluster.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RemoteCluster defines a remote cluster
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class RemoteCluster implements Editable<RemoteClusterBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "RemoteCluster";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public RemoteCluster(String apiVersion, String kind, ObjectMeta metadata, Remote
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RemoteCluster defines a remote cluster
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RemoteCluster defines a remote cluster
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * RemoteCluster defines a remote cluster
+     */
     @JsonProperty("spec")
     public RemoteClusterSpec getSpec() {
         return spec;
     }
 
+    /**
+     * RemoteCluster defines a remote cluster
+     */
     @JsonProperty("spec")
     public void setSpec(RemoteClusterSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * RemoteCluster defines a remote cluster
+     */
     @JsonProperty("status")
     public RemoteClusterStatus getStatus() {
         return status;
     }
 
+    /**
+     * RemoteCluster defines a remote cluster
+     */
     @JsonProperty("status")
     public void setStatus(RemoteClusterStatus status) {
         this.status = status;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RemoteClusterKubeConfig.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RemoteClusterKubeConfig.java
index 6cbf3b00406..f0a9f69defb 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RemoteClusterKubeConfig.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RemoteClusterKubeConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RemoteClusterKubeConfig refers to a secret by which we'll use to connect remote cluster
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public RemoteClusterKubeConfig(RemoteClusterSecretRef secretRef) {
         this.secretRef = secretRef;
     }
 
+    /**
+     * RemoteClusterKubeConfig refers to a secret by which we'll use to connect remote cluster
+     */
     @JsonProperty("secretRef")
     public RemoteClusterSecretRef getSecretRef() {
         return secretRef;
     }
 
+    /**
+     * RemoteClusterKubeConfig refers to a secret by which we'll use to connect remote cluster
+     */
     @JsonProperty("secretRef")
     public void setSecretRef(RemoteClusterSecretRef secretRef) {
         this.secretRef = secretRef;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RemoteClusterList.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RemoteClusterList.java
index f151aba6230..e34c093eb5d 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RemoteClusterList.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RemoteClusterList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RemoteClusterList contains a list of RemoteCluster
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class RemoteClusterList implements Editable<RemoteClusterListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.chaosmesh.v1alpha1.RemoteCluster>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.chaosmesh.v1alpha1.RemoteCluster> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "RemoteClusterList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public RemoteClusterList(String apiVersion, List<io.fabric8.chaosmesh.v1alpha1.R
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * RemoteClusterList contains a list of RemoteCluster
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.chaosmesh.v1alpha1.RemoteCluster> getItems() {
         return items;
     }
 
+    /**
+     * RemoteClusterList contains a list of RemoteCluster
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.chaosmesh.v1alpha1.RemoteCluster> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RemoteClusterList contains a list of RemoteCluster
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RemoteClusterList contains a list of RemoteCluster
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RemoteClusterSecretRef.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RemoteClusterSecretRef.java
index 8830f430616..0ca42f18596 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RemoteClusterSecretRef.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RemoteClusterSecretRef.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RemoteClusterSecretRef refers to a secret in any namespaces
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public RemoteClusterSecretRef(String key, String name, String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * RemoteClusterSecretRef refers to a secret in any namespaces
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * RemoteClusterSecretRef refers to a secret in any namespaces
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * RemoteClusterSecretRef refers to a secret in any namespaces
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * RemoteClusterSecretRef refers to a secret in any namespaces
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * RemoteClusterSecretRef refers to a secret in any namespaces
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * RemoteClusterSecretRef refers to a secret in any namespaces
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RemoteClusterSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RemoteClusterSpec.java
index 50ccdd9837f..2077c42f221 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RemoteClusterSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RemoteClusterSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RemoteClusterSpec defines the specification of a remote cluster
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public RemoteClusterSpec(String configOverride, RemoteClusterKubeConfig kubeConf
         this.version = version;
     }
 
+    /**
+     * RemoteClusterSpec defines the specification of a remote cluster
+     */
     @JsonProperty("configOverride")
     public String getConfigOverride() {
         return configOverride;
     }
 
+    /**
+     * RemoteClusterSpec defines the specification of a remote cluster
+     */
     @JsonProperty("configOverride")
     public void setConfigOverride(String configOverride) {
         this.configOverride = configOverride;
     }
 
+    /**
+     * RemoteClusterSpec defines the specification of a remote cluster
+     */
     @JsonProperty("kubeConfig")
     public RemoteClusterKubeConfig getKubeConfig() {
         return kubeConfig;
     }
 
+    /**
+     * RemoteClusterSpec defines the specification of a remote cluster
+     */
     @JsonProperty("kubeConfig")
     public void setKubeConfig(RemoteClusterKubeConfig kubeConfig) {
         this.kubeConfig = kubeConfig;
     }
 
+    /**
+     * RemoteClusterSpec defines the specification of a remote cluster
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * RemoteClusterSpec defines the specification of a remote cluster
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * RemoteClusterSpec defines the specification of a remote cluster
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * RemoteClusterSpec defines the specification of a remote cluster
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RemoteClusterStatus.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RemoteClusterStatus.java
index d4a1f20ac16..30d722abc79 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RemoteClusterStatus.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/RemoteClusterStatus.java
@@ -89,12 +89,18 @@ public RemoteClusterStatus(List<RemoteClusterCondition> conditions, String curre
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Conditions represents the current condition of the remote cluster
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RemoteClusterCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions represents the current condition of the remote cluster
+     */
     @JsonProperty("conditions")
     public void setConditions(List<RemoteClusterCondition> conditions) {
         this.conditions = conditions;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ReorderSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ReorderSpec.java
index 39fd945c2ee..17a52296971 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ReorderSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ReorderSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ReorderSpec defines details of packet reorder.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ReorderSpec(String correlation, Integer gap, String reorder) {
         this.reorder = reorder;
     }
 
+    /**
+     * ReorderSpec defines details of packet reorder.
+     */
     @JsonProperty("correlation")
     public String getCorrelation() {
         return correlation;
     }
 
+    /**
+     * ReorderSpec defines details of packet reorder.
+     */
     @JsonProperty("correlation")
     public void setCorrelation(String correlation) {
         this.correlation = correlation;
     }
 
+    /**
+     * ReorderSpec defines details of packet reorder.
+     */
     @JsonProperty("gap")
     public Integer getGap() {
         return gap;
     }
 
+    /**
+     * ReorderSpec defines details of packet reorder.
+     */
     @JsonProperty("gap")
     public void setGap(Integer gap) {
         this.gap = gap;
     }
 
+    /**
+     * ReorderSpec defines details of packet reorder.
+     */
     @JsonProperty("reorder")
     public String getReorder() {
         return reorder;
     }
 
+    /**
+     * ReorderSpec defines details of packet reorder.
+     */
     @JsonProperty("reorder")
     public void setReorder(String reorder) {
         this.reorder = reorder;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Schedule.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Schedule.java
index aa419dc0475..14ae3744a97 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Schedule.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Schedule.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Schedule is the cronly schedule object
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Schedule implements Editable<ScheduleBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Schedule";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Schedule(String apiVersion, String kind, ObjectMeta metadata, ScheduleSpe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Schedule is the cronly schedule object
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Schedule is the cronly schedule object
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Schedule is the cronly schedule object
+     */
     @JsonProperty("spec")
     public ScheduleSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Schedule is the cronly schedule object
+     */
     @JsonProperty("spec")
     public void setSpec(ScheduleSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Schedule is the cronly schedule object
+     */
     @JsonProperty("status")
     public ScheduleStatus getStatus() {
         return status;
     }
 
+    /**
+     * Schedule is the cronly schedule object
+     */
     @JsonProperty("status")
     public void setStatus(ScheduleStatus status) {
         this.status = status;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ScheduleList.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ScheduleList.java
index c797bbb21f7..0ec8aa50bea 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ScheduleList.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ScheduleList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ScheduleList contains a list of Schedule
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ScheduleList implements Editable<ScheduleListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.chaosmesh.v1alpha1.Schedule>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.chaosmesh.v1alpha1.Schedule> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ScheduleList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ScheduleList(String apiVersion, List<io.fabric8.chaosmesh.v1alpha1.Schedu
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ScheduleList contains a list of Schedule
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.chaosmesh.v1alpha1.Schedule> getItems() {
         return items;
     }
 
+    /**
+     * ScheduleList contains a list of Schedule
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.chaosmesh.v1alpha1.Schedule> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ScheduleList contains a list of Schedule
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ScheduleList contains a list of Schedule
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ScheduleSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ScheduleSpec.java
index c528ec880aa..d4e9d2ee727 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ScheduleSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ScheduleSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ScheduleSpec is the specification of a schedule object
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -154,201 +157,321 @@ public ScheduleSpec(AWSChaosSpec awsChaos, AzureChaosSpec azureChaos, BlockChaos
         this.workflow = workflow;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("awsChaos")
     public AWSChaosSpec getAwsChaos() {
         return awsChaos;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("awsChaos")
     public void setAwsChaos(AWSChaosSpec awsChaos) {
         this.awsChaos = awsChaos;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("azureChaos")
     public AzureChaosSpec getAzureChaos() {
         return azureChaos;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("azureChaos")
     public void setAzureChaos(AzureChaosSpec azureChaos) {
         this.azureChaos = azureChaos;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("blockChaos")
     public BlockChaosSpec getBlockChaos() {
         return blockChaos;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("blockChaos")
     public void setBlockChaos(BlockChaosSpec blockChaos) {
         this.blockChaos = blockChaos;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("concurrencyPolicy")
     public String getConcurrencyPolicy() {
         return concurrencyPolicy;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("concurrencyPolicy")
     public void setConcurrencyPolicy(String concurrencyPolicy) {
         this.concurrencyPolicy = concurrencyPolicy;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("dnsChaos")
     public DNSChaosSpec getDnsChaos() {
         return dnsChaos;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("dnsChaos")
     public void setDnsChaos(DNSChaosSpec dnsChaos) {
         this.dnsChaos = dnsChaos;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("gcpChaos")
     public GCPChaosSpec getGcpChaos() {
         return gcpChaos;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("gcpChaos")
     public void setGcpChaos(GCPChaosSpec gcpChaos) {
         this.gcpChaos = gcpChaos;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("historyLimit")
     public Integer getHistoryLimit() {
         return historyLimit;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("historyLimit")
     public void setHistoryLimit(Integer historyLimit) {
         this.historyLimit = historyLimit;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("httpChaos")
     public HTTPChaosSpec getHttpChaos() {
         return httpChaos;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("httpChaos")
     public void setHttpChaos(HTTPChaosSpec httpChaos) {
         this.httpChaos = httpChaos;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("ioChaos")
     public IOChaosSpec getIoChaos() {
         return ioChaos;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("ioChaos")
     public void setIoChaos(IOChaosSpec ioChaos) {
         this.ioChaos = ioChaos;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("jvmChaos")
     public JVMChaosSpec getJvmChaos() {
         return jvmChaos;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("jvmChaos")
     public void setJvmChaos(JVMChaosSpec jvmChaos) {
         this.jvmChaos = jvmChaos;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("kernelChaos")
     public KernelChaosSpec getKernelChaos() {
         return kernelChaos;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("kernelChaos")
     public void setKernelChaos(KernelChaosSpec kernelChaos) {
         this.kernelChaos = kernelChaos;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("networkChaos")
     public NetworkChaosSpec getNetworkChaos() {
         return networkChaos;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("networkChaos")
     public void setNetworkChaos(NetworkChaosSpec networkChaos) {
         this.networkChaos = networkChaos;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("physicalmachineChaos")
     public PhysicalMachineChaosSpec getPhysicalmachineChaos() {
         return physicalmachineChaos;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("physicalmachineChaos")
     public void setPhysicalmachineChaos(PhysicalMachineChaosSpec physicalmachineChaos) {
         this.physicalmachineChaos = physicalmachineChaos;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("podChaos")
     public PodChaosSpec getPodChaos() {
         return podChaos;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("podChaos")
     public void setPodChaos(PodChaosSpec podChaos) {
         this.podChaos = podChaos;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("schedule")
     public String getSchedule() {
         return schedule;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("schedule")
     public void setSchedule(String schedule) {
         this.schedule = schedule;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("startingDeadlineSeconds")
     public Long getStartingDeadlineSeconds() {
         return startingDeadlineSeconds;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("startingDeadlineSeconds")
     public void setStartingDeadlineSeconds(Long startingDeadlineSeconds) {
         this.startingDeadlineSeconds = startingDeadlineSeconds;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("stressChaos")
     public StressChaosSpec getStressChaos() {
         return stressChaos;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("stressChaos")
     public void setStressChaos(StressChaosSpec stressChaos) {
         this.stressChaos = stressChaos;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("timeChaos")
     public TimeChaosSpec getTimeChaos() {
         return timeChaos;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("timeChaos")
     public void setTimeChaos(TimeChaosSpec timeChaos) {
         this.timeChaos = timeChaos;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("workflow")
     public WorkflowSpec getWorkflow() {
         return workflow;
     }
 
+    /**
+     * ScheduleSpec is the specification of a schedule object
+     */
     @JsonProperty("workflow")
     public void setWorkflow(WorkflowSpec workflow) {
         this.workflow = workflow;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ScheduleStatus.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ScheduleStatus.java
index 0087f792c7e..692cf055473 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ScheduleStatus.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/ScheduleStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ScheduleStatus is the status of a schedule object
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public ScheduleStatus(List<ObjectReference> active, String time) {
         this.time = time;
     }
 
+    /**
+     * ScheduleStatus is the status of a schedule object
+     */
     @JsonProperty("active")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ObjectReference> getActive() {
         return active;
     }
 
+    /**
+     * ScheduleStatus is the status of a schedule object
+     */
     @JsonProperty("active")
     public void setActive(List<ObjectReference> active) {
         this.active = active;
     }
 
+    /**
+     * ScheduleStatus is the status of a schedule object
+     */
     @JsonProperty("time")
     public String getTime() {
         return time;
     }
 
+    /**
+     * ScheduleStatus is the status of a schedule object
+     */
     @JsonProperty("time")
     public void setTime(String time) {
         this.time = time;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StatusCheck.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StatusCheck.java
index fb49fe7fecd..4d78402b561 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StatusCheck.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StatusCheck.java
@@ -76,14 +76,8 @@
 public class StatusCheck implements Editable<StatusCheckBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "StatusCheck";
     @JsonProperty("metadata")
@@ -111,7 +105,7 @@ public StatusCheck(String apiVersion, String kind, ObjectMeta metadata, StatusCh
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +113,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +121,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,7 +129,7 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StatusCheckList.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StatusCheckList.java
index a7449932984..0f75c7fbed1 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StatusCheckList.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StatusCheckList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StatusCheckList contains a list of StatusCheck
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class StatusCheckList implements Editable<StatusCheckListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.chaosmesh.v1alpha1.StatusCheck>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.chaosmesh.v1alpha1.StatusCheck> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "StatusCheckList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public StatusCheckList(String apiVersion, List<io.fabric8.chaosmesh.v1alpha1.Sta
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * StatusCheckList contains a list of StatusCheck
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.chaosmesh.v1alpha1.StatusCheck> getItems() {
         return items;
     }
 
+    /**
+     * StatusCheckList contains a list of StatusCheck
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.chaosmesh.v1alpha1.StatusCheck> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * StatusCheckList contains a list of StatusCheck
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * StatusCheckList contains a list of StatusCheck
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StatusCheckSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StatusCheckSpec.java
index ba01f4e4e50..b1027400193 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StatusCheckSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StatusCheckSpec.java
@@ -110,21 +110,33 @@ public StatusCheckSpec(String duration, Integer failureThreshold, HTTPStatusChec
         this.type = type;
     }
 
+    /**
+     * Duration defines the duration of the whole status check if the number of failed execution does not exceed the failure threshold. Duration is available to both `Synchronous` and `Continuous` mode. A duration string is a possibly signed sequence of decimal numbers, each with optional fraction and a unit suffix, such as "300ms", "-1.5h" or "2h45m". Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h".
+     */
     @JsonProperty("duration")
     public String getDuration() {
         return duration;
     }
 
+    /**
+     * Duration defines the duration of the whole status check if the number of failed execution does not exceed the failure threshold. Duration is available to both `Synchronous` and `Continuous` mode. A duration string is a possibly signed sequence of decimal numbers, each with optional fraction and a unit suffix, such as "300ms", "-1.5h" or "2h45m". Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h".
+     */
     @JsonProperty("duration")
     public void setDuration(String duration) {
         this.duration = duration;
     }
 
+    /**
+     * FailureThreshold defines the minimum consecutive failure for the status check to be considered failed.
+     */
     @JsonProperty("failureThreshold")
     public Integer getFailureThreshold() {
         return failureThreshold;
     }
 
+    /**
+     * FailureThreshold defines the minimum consecutive failure for the status check to be considered failed.
+     */
     @JsonProperty("failureThreshold")
     public void setFailureThreshold(Integer failureThreshold) {
         this.failureThreshold = failureThreshold;
@@ -140,61 +152,97 @@ public void setHttp(HTTPStatusCheck http) {
         this.http = http;
     }
 
+    /**
+     * IntervalSeconds defines how often (in seconds) to perform an execution of status check.
+     */
     @JsonProperty("intervalSeconds")
     public Integer getIntervalSeconds() {
         return intervalSeconds;
     }
 
+    /**
+     * IntervalSeconds defines how often (in seconds) to perform an execution of status check.
+     */
     @JsonProperty("intervalSeconds")
     public void setIntervalSeconds(Integer intervalSeconds) {
         this.intervalSeconds = intervalSeconds;
     }
 
+    /**
+     * Mode defines the execution mode of the status check. Support type: Synchronous / Continuous
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Mode defines the execution mode of the status check. Support type: Synchronous / Continuous
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
     }
 
+    /**
+     * RecordsHistoryLimit defines the number of record to retain.
+     */
     @JsonProperty("recordsHistoryLimit")
     public Integer getRecordsHistoryLimit() {
         return recordsHistoryLimit;
     }
 
+    /**
+     * RecordsHistoryLimit defines the number of record to retain.
+     */
     @JsonProperty("recordsHistoryLimit")
     public void setRecordsHistoryLimit(Integer recordsHistoryLimit) {
         this.recordsHistoryLimit = recordsHistoryLimit;
     }
 
+    /**
+     * SuccessThreshold defines the minimum consecutive successes for the status check to be considered successful. SuccessThreshold only works for `Synchronous` mode.
+     */
     @JsonProperty("successThreshold")
     public Integer getSuccessThreshold() {
         return successThreshold;
     }
 
+    /**
+     * SuccessThreshold defines the minimum consecutive successes for the status check to be considered successful. SuccessThreshold only works for `Synchronous` mode.
+     */
     @JsonProperty("successThreshold")
     public void setSuccessThreshold(Integer successThreshold) {
         this.successThreshold = successThreshold;
     }
 
+    /**
+     * TimeoutSeconds defines the number of seconds after which an execution of status check times out.
+     */
     @JsonProperty("timeoutSeconds")
     public Integer getTimeoutSeconds() {
         return timeoutSeconds;
     }
 
+    /**
+     * TimeoutSeconds defines the number of seconds after which an execution of status check times out.
+     */
     @JsonProperty("timeoutSeconds")
     public void setTimeoutSeconds(Integer timeoutSeconds) {
         this.timeoutSeconds = timeoutSeconds;
     }
 
+    /**
+     * Type defines the specific status check type. Support type: HTTP
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type defines the specific status check type. Support type: HTTP
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StatusCheckStatus.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StatusCheckStatus.java
index d5240d4bbf1..fd5308b35d0 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StatusCheckStatus.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StatusCheckStatus.java
@@ -108,33 +108,51 @@ public void setCompletionTime(String completionTime) {
         this.completionTime = completionTime;
     }
 
+    /**
+     * Conditions represents the latest available observations of a StatusCheck's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<StatusCheckCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions represents the latest available observations of a StatusCheck's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<StatusCheckCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Count represents the total number of the status check executed.
+     */
     @JsonProperty("count")
     public Long getCount() {
         return count;
     }
 
+    /**
+     * Count represents the total number of the status check executed.
+     */
     @JsonProperty("count")
     public void setCount(Long count) {
         this.count = count;
     }
 
+    /**
+     * Records contains the history of the execution of StatusCheck.
+     */
     @JsonProperty("records")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<StatusCheckRecord> getRecords() {
         return records;
     }
 
+    /**
+     * Records contains the history of the execution of StatusCheck.
+     */
     @JsonProperty("records")
     public void setRecords(List<StatusCheckRecord> records) {
         this.records = records;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StatusCheckTemplate.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StatusCheckTemplate.java
index a4ad45580fa..3be76f7336b 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StatusCheckTemplate.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StatusCheckTemplate.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StatusCheckTemplate represents a template of status check. A statusCheckTemplate would save in the ConfigMap named `template-status-check-&lt;template-name&gt;`.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -110,91 +113,145 @@ public StatusCheckTemplate(String duration, Integer failureThreshold, HTTPStatus
         this.type = type;
     }
 
+    /**
+     * Duration defines the duration of the whole status check if the number of failed execution does not exceed the failure threshold. Duration is available to both `Synchronous` and `Continuous` mode. A duration string is a possibly signed sequence of decimal numbers, each with optional fraction and a unit suffix, such as "300ms", "-1.5h" or "2h45m". Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h".
+     */
     @JsonProperty("duration")
     public String getDuration() {
         return duration;
     }
 
+    /**
+     * Duration defines the duration of the whole status check if the number of failed execution does not exceed the failure threshold. Duration is available to both `Synchronous` and `Continuous` mode. A duration string is a possibly signed sequence of decimal numbers, each with optional fraction and a unit suffix, such as "300ms", "-1.5h" or "2h45m". Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h".
+     */
     @JsonProperty("duration")
     public void setDuration(String duration) {
         this.duration = duration;
     }
 
+    /**
+     * FailureThreshold defines the minimum consecutive failure for the status check to be considered failed.
+     */
     @JsonProperty("failureThreshold")
     public Integer getFailureThreshold() {
         return failureThreshold;
     }
 
+    /**
+     * FailureThreshold defines the minimum consecutive failure for the status check to be considered failed.
+     */
     @JsonProperty("failureThreshold")
     public void setFailureThreshold(Integer failureThreshold) {
         this.failureThreshold = failureThreshold;
     }
 
+    /**
+     * StatusCheckTemplate represents a template of status check. A statusCheckTemplate would save in the ConfigMap named `template-status-check-&lt;template-name&gt;`.
+     */
     @JsonProperty("http")
     public HTTPStatusCheck getHttp() {
         return http;
     }
 
+    /**
+     * StatusCheckTemplate represents a template of status check. A statusCheckTemplate would save in the ConfigMap named `template-status-check-&lt;template-name&gt;`.
+     */
     @JsonProperty("http")
     public void setHttp(HTTPStatusCheck http) {
         this.http = http;
     }
 
+    /**
+     * IntervalSeconds defines how often (in seconds) to perform an execution of status check.
+     */
     @JsonProperty("intervalSeconds")
     public Integer getIntervalSeconds() {
         return intervalSeconds;
     }
 
+    /**
+     * IntervalSeconds defines how often (in seconds) to perform an execution of status check.
+     */
     @JsonProperty("intervalSeconds")
     public void setIntervalSeconds(Integer intervalSeconds) {
         this.intervalSeconds = intervalSeconds;
     }
 
+    /**
+     * Mode defines the execution mode of the status check. Support type: Synchronous / Continuous
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Mode defines the execution mode of the status check. Support type: Synchronous / Continuous
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
     }
 
+    /**
+     * RecordsHistoryLimit defines the number of record to retain.
+     */
     @JsonProperty("recordsHistoryLimit")
     public Integer getRecordsHistoryLimit() {
         return recordsHistoryLimit;
     }
 
+    /**
+     * RecordsHistoryLimit defines the number of record to retain.
+     */
     @JsonProperty("recordsHistoryLimit")
     public void setRecordsHistoryLimit(Integer recordsHistoryLimit) {
         this.recordsHistoryLimit = recordsHistoryLimit;
     }
 
+    /**
+     * SuccessThreshold defines the minimum consecutive successes for the status check to be considered successful. SuccessThreshold only works for `Synchronous` mode.
+     */
     @JsonProperty("successThreshold")
     public Integer getSuccessThreshold() {
         return successThreshold;
     }
 
+    /**
+     * SuccessThreshold defines the minimum consecutive successes for the status check to be considered successful. SuccessThreshold only works for `Synchronous` mode.
+     */
     @JsonProperty("successThreshold")
     public void setSuccessThreshold(Integer successThreshold) {
         this.successThreshold = successThreshold;
     }
 
+    /**
+     * TimeoutSeconds defines the number of seconds after which an execution of status check times out.
+     */
     @JsonProperty("timeoutSeconds")
     public Integer getTimeoutSeconds() {
         return timeoutSeconds;
     }
 
+    /**
+     * TimeoutSeconds defines the number of seconds after which an execution of status check times out.
+     */
     @JsonProperty("timeoutSeconds")
     public void setTimeoutSeconds(Integer timeoutSeconds) {
         this.timeoutSeconds = timeoutSeconds;
     }
 
+    /**
+     * Type defines the specific status check type. Support type: HTTP
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type defines the specific status check type. Support type: HTTP
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StressCPUSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StressCPUSpec.java
index 1c06da271ef..2f819aba062 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StressCPUSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StressCPUSpec.java
@@ -89,32 +89,50 @@ public StressCPUSpec(Integer load, List<String> options, Integer workers) {
         this.workers = workers;
     }
 
+    /**
+     * specifies P percent loading per CPU worker. 0 is effectively a sleep (no load) and 100 is full loading.
+     */
     @JsonProperty("load")
     public Integer getLoad() {
         return load;
     }
 
+    /**
+     * specifies P percent loading per CPU worker. 0 is effectively a sleep (no load) and 100 is full loading.
+     */
     @JsonProperty("load")
     public void setLoad(Integer load) {
         this.load = load;
     }
 
+    /**
+     * extend stress-ng options
+     */
     @JsonProperty("options")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getOptions() {
         return options;
     }
 
+    /**
+     * extend stress-ng options
+     */
     @JsonProperty("options")
     public void setOptions(List<String> options) {
         this.options = options;
     }
 
+    /**
+     * specifies N workers to apply the stressor.
+     */
     @JsonProperty("workers")
     public Integer getWorkers() {
         return workers;
     }
 
+    /**
+     * specifies N workers to apply the stressor.
+     */
     @JsonProperty("workers")
     public void setWorkers(Integer workers) {
         this.workers = workers;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StressChaos.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StressChaos.java
index a684330e67a..2e9efe26b44 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StressChaos.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StressChaos.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StressChaos is the Schema for the stresschaos API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class StressChaos implements Editable<StressChaosBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "StressChaos";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public StressChaos(String apiVersion, String kind, ObjectMeta metadata, StressCh
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * StressChaos is the Schema for the stresschaos API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * StressChaos is the Schema for the stresschaos API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * StressChaos is the Schema for the stresschaos API
+     */
     @JsonProperty("spec")
     public StressChaosSpec getSpec() {
         return spec;
     }
 
+    /**
+     * StressChaos is the Schema for the stresschaos API
+     */
     @JsonProperty("spec")
     public void setSpec(StressChaosSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * StressChaos is the Schema for the stresschaos API
+     */
     @JsonProperty("status")
     public StressChaosStatus getStatus() {
         return status;
     }
 
+    /**
+     * StressChaos is the Schema for the stresschaos API
+     */
     @JsonProperty("status")
     public void setStatus(StressChaosStatus status) {
         this.status = status;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StressChaosList.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StressChaosList.java
index 7722a9c9081..58f7ae19352 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StressChaosList.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StressChaosList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StressChaosList contains a list of StressChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class StressChaosList implements Editable<StressChaosListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.chaosmesh.v1alpha1.StressChaos>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.chaosmesh.v1alpha1.StressChaos> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "StressChaosList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public StressChaosList(String apiVersion, List<io.fabric8.chaosmesh.v1alpha1.Str
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * StressChaosList contains a list of StressChaos
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.chaosmesh.v1alpha1.StressChaos> getItems() {
         return items;
     }
 
+    /**
+     * StressChaosList contains a list of StressChaos
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.chaosmesh.v1alpha1.StressChaos> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * StressChaosList contains a list of StressChaos
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * StressChaosList contains a list of StressChaos
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StressChaosSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StressChaosSpec.java
index d3cf6651879..00456901f0a 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StressChaosSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StressChaosSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StressChaosSpec defines the desired state of StressChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -109,82 +112,130 @@ public StressChaosSpec(List<String> containerNames, String duration, String mode
         this.value = value;
     }
 
+    /**
+     * ContainerNames indicates list of the name of affected container. If not set, the first container will be injected
+     */
     @JsonProperty("containerNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getContainerNames() {
         return containerNames;
     }
 
+    /**
+     * ContainerNames indicates list of the name of affected container. If not set, the first container will be injected
+     */
     @JsonProperty("containerNames")
     public void setContainerNames(List<String> containerNames) {
         this.containerNames = containerNames;
     }
 
+    /**
+     * Duration represents the duration of the chaos action
+     */
     @JsonProperty("duration")
     public String getDuration() {
         return duration;
     }
 
+    /**
+     * Duration represents the duration of the chaos action
+     */
     @JsonProperty("duration")
     public void setDuration(String duration) {
         this.duration = duration;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public String getRemoteCluster() {
         return remoteCluster;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public void setRemoteCluster(String remoteCluster) {
         this.remoteCluster = remoteCluster;
     }
 
+    /**
+     * StressChaosSpec defines the desired state of StressChaos
+     */
     @JsonProperty("selector")
     public PodSelectorSpec getSelector() {
         return selector;
     }
 
+    /**
+     * StressChaosSpec defines the desired state of StressChaos
+     */
     @JsonProperty("selector")
     public void setSelector(PodSelectorSpec selector) {
         this.selector = selector;
     }
 
+    /**
+     * StressngStressors defines plenty of stressors just like `Stressors` except that it's an experimental feature and more powerful. You can define stressors in `stress-ng` (see also `man stress-ng`) dialect, however not all of the supported stressors are well tested. It maybe retired in later releases. You should always use `Stressors` to define the stressors and use this only when you want more stressors unsupported by `Stressors`. When both `StressngStressors` and `Stressors` are defined, `StressngStressors` wins.
+     */
     @JsonProperty("stressngStressors")
     public String getStressngStressors() {
         return stressngStressors;
     }
 
+    /**
+     * StressngStressors defines plenty of stressors just like `Stressors` except that it's an experimental feature and more powerful. You can define stressors in `stress-ng` (see also `man stress-ng`) dialect, however not all of the supported stressors are well tested. It maybe retired in later releases. You should always use `Stressors` to define the stressors and use this only when you want more stressors unsupported by `Stressors`. When both `StressngStressors` and `Stressors` are defined, `StressngStressors` wins.
+     */
     @JsonProperty("stressngStressors")
     public void setStressngStressors(String stressngStressors) {
         this.stressngStressors = stressngStressors;
     }
 
+    /**
+     * StressChaosSpec defines the desired state of StressChaos
+     */
     @JsonProperty("stressors")
     public Stressors getStressors() {
         return stressors;
     }
 
+    /**
+     * StressChaosSpec defines the desired state of StressChaos
+     */
     @JsonProperty("stressors")
     public void setStressors(Stressors stressors) {
         this.stressors = stressors;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of pods to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of pods the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of pods to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of pods the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StressChaosStatus.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StressChaosStatus.java
index 6f5db1a6967..886468f3fdb 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StressChaosStatus.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StressChaosStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StressChaosStatus defines the observed state of StressChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public StressChaosStatus(List<ChaosCondition> conditions, ExperimentStatus exper
         this.instances = instances;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ChaosCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ChaosCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * StressChaosStatus defines the observed state of StressChaos
+     */
     @JsonProperty("experiment")
     public ExperimentStatus getExperiment() {
         return experiment;
     }
 
+    /**
+     * StressChaosStatus defines the observed state of StressChaos
+     */
     @JsonProperty("experiment")
     public void setExperiment(ExperimentStatus experiment) {
         this.experiment = experiment;
     }
 
+    /**
+     * Instances always specifies stressing instances
+     */
     @JsonProperty("instances")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, StressInstance> getInstances() {
         return instances;
     }
 
+    /**
+     * Instances always specifies stressing instances
+     */
     @JsonProperty("instances")
     public void setInstances(Map<String, StressInstance> instances) {
         this.instances = instances;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StressInstance.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StressInstance.java
index 1331d9eecf5..e5a1cd7ec5d 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StressInstance.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StressInstance.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StressInstance is an instance generates stresses
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public StressInstance(String memoryStartTime, String memoryUid, String startTime
         this.uid = uid;
     }
 
+    /**
+     * StressInstance is an instance generates stresses
+     */
     @JsonProperty("memoryStartTime")
     public String getMemoryStartTime() {
         return memoryStartTime;
     }
 
+    /**
+     * StressInstance is an instance generates stresses
+     */
     @JsonProperty("memoryStartTime")
     public void setMemoryStartTime(String memoryStartTime) {
         this.memoryStartTime = memoryStartTime;
     }
 
+    /**
+     * MemoryUID is the memStress identifier
+     */
     @JsonProperty("memoryUid")
     public String getMemoryUid() {
         return memoryUid;
     }
 
+    /**
+     * MemoryUID is the memStress identifier
+     */
     @JsonProperty("memoryUid")
     public void setMemoryUid(String memoryUid) {
         this.memoryUid = memoryUid;
     }
 
+    /**
+     * StressInstance is an instance generates stresses
+     */
     @JsonProperty("startTime")
     public String getStartTime() {
         return startTime;
     }
 
+    /**
+     * StressInstance is an instance generates stresses
+     */
     @JsonProperty("startTime")
     public void setStartTime(String startTime) {
         this.startTime = startTime;
     }
 
+    /**
+     * UID is the stress-ng identifier
+     */
     @JsonProperty("uid")
     public String getUid() {
         return uid;
     }
 
+    /**
+     * UID is the stress-ng identifier
+     */
     @JsonProperty("uid")
     public void setUid(String uid) {
         this.uid = uid;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StressMemorySpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StressMemorySpec.java
index 5b935671926..9cce5046174 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StressMemorySpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/StressMemorySpec.java
@@ -85,22 +85,34 @@ public StressMemorySpec(List<String> options, String size) {
         this.size = size;
     }
 
+    /**
+     * extend stress-ng options
+     */
     @JsonProperty("options")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getOptions() {
         return options;
     }
 
+    /**
+     * extend stress-ng options
+     */
     @JsonProperty("options")
     public void setOptions(List<String> options) {
         this.options = options;
     }
 
+    /**
+     * specifies N bytes consumed per vm worker, default is the total available memory. One can specify the size as % of total available memory or in units of B, KB/KiB, MB/MiB, GB/GiB, TB/TiB..
+     */
     @JsonProperty("size")
     public String getSize() {
         return size;
     }
 
+    /**
+     * specifies N bytes consumed per vm worker, default is the total available memory. One can specify the size as % of total available memory or in units of B, KB/KiB, MB/MiB, GB/GiB, TB/TiB..
+     */
     @JsonProperty("size")
     public void setSize(String size) {
         this.size = size;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Stressor.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Stressor.java
index 63a49ea9136..72eb7e02a6f 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Stressor.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Stressor.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Stressor defines common configurations of a stressor
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public Stressor(Integer workers) {
         this.workers = workers;
     }
 
+    /**
+     * Workers specifies N workers to apply the stressor. Maximum 8192 workers can run by stress-ng
+     */
     @JsonProperty("workers")
     public Integer getWorkers() {
         return workers;
     }
 
+    /**
+     * Workers specifies N workers to apply the stressor. Maximum 8192 workers can run by stress-ng
+     */
     @JsonProperty("workers")
     public void setWorkers(Integer workers) {
         this.workers = workers;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Stressors.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Stressors.java
index 6b6aea9719f..caf1d820cd7 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Stressors.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Stressors.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Stressors defines plenty of stressors supported to stress system components out. You can use one or more of them to make up various kinds of stresses
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Stressors(CPUStressor cpu, MemoryStressor memory) {
         this.memory = memory;
     }
 
+    /**
+     * Stressors defines plenty of stressors supported to stress system components out. You can use one or more of them to make up various kinds of stresses
+     */
     @JsonProperty("cpu")
     public CPUStressor getCpu() {
         return cpu;
     }
 
+    /**
+     * Stressors defines plenty of stressors supported to stress system components out. You can use one or more of them to make up various kinds of stresses
+     */
     @JsonProperty("cpu")
     public void setCpu(CPUStressor cpu) {
         this.cpu = cpu;
     }
 
+    /**
+     * Stressors defines plenty of stressors supported to stress system components out. You can use one or more of them to make up various kinds of stresses
+     */
     @JsonProperty("memory")
     public MemoryStressor getMemory() {
         return memory;
     }
 
+    /**
+     * Stressors defines plenty of stressors supported to stress system components out. You can use one or more of them to make up various kinds of stresses
+     */
     @JsonProperty("memory")
     public void setMemory(MemoryStressor memory) {
         this.memory = memory;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Task.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Task.java
index 7ebcd3a9f78..5fb1297cc94 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Task.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Task.java
@@ -95,12 +95,18 @@ public void setContainer(Container container) {
         this.container = container;
     }
 
+    /**
+     * Volumes is a list of volumes that can be mounted by containers in a template.
+     */
     @JsonProperty("volumes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Volume> getVolumes() {
         return volumes;
     }
 
+    /**
+     * Volumes is a list of volumes that can be mounted by containers in a template.
+     */
     @JsonProperty("volumes")
     public void setVolumes(List<Volume> volumes) {
         this.volumes = volumes;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/TcParameter.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/TcParameter.java
index d892fa1257f..78c2e3c2dbd 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/TcParameter.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/TcParameter.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TcParameter represents the parameters for a traffic control chaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public TcParameter(BandwidthSpec bandwidth, CorruptSpec corrupt, DelaySpec delay
         this.rate = rate;
     }
 
+    /**
+     * TcParameter represents the parameters for a traffic control chaos
+     */
     @JsonProperty("bandwidth")
     public BandwidthSpec getBandwidth() {
         return bandwidth;
     }
 
+    /**
+     * TcParameter represents the parameters for a traffic control chaos
+     */
     @JsonProperty("bandwidth")
     public void setBandwidth(BandwidthSpec bandwidth) {
         this.bandwidth = bandwidth;
     }
 
+    /**
+     * TcParameter represents the parameters for a traffic control chaos
+     */
     @JsonProperty("corrupt")
     public CorruptSpec getCorrupt() {
         return corrupt;
     }
 
+    /**
+     * TcParameter represents the parameters for a traffic control chaos
+     */
     @JsonProperty("corrupt")
     public void setCorrupt(CorruptSpec corrupt) {
         this.corrupt = corrupt;
     }
 
+    /**
+     * TcParameter represents the parameters for a traffic control chaos
+     */
     @JsonProperty("delay")
     public DelaySpec getDelay() {
         return delay;
     }
 
+    /**
+     * TcParameter represents the parameters for a traffic control chaos
+     */
     @JsonProperty("delay")
     public void setDelay(DelaySpec delay) {
         this.delay = delay;
     }
 
+    /**
+     * TcParameter represents the parameters for a traffic control chaos
+     */
     @JsonProperty("duplicate")
     public DuplicateSpec getDuplicate() {
         return duplicate;
     }
 
+    /**
+     * TcParameter represents the parameters for a traffic control chaos
+     */
     @JsonProperty("duplicate")
     public void setDuplicate(DuplicateSpec duplicate) {
         this.duplicate = duplicate;
     }
 
+    /**
+     * TcParameter represents the parameters for a traffic control chaos
+     */
     @JsonProperty("loss")
     public LossSpec getLoss() {
         return loss;
     }
 
+    /**
+     * TcParameter represents the parameters for a traffic control chaos
+     */
     @JsonProperty("loss")
     public void setLoss(LossSpec loss) {
         this.loss = loss;
     }
 
+    /**
+     * TcParameter represents the parameters for a traffic control chaos
+     */
     @JsonProperty("rate")
     public RateSpec getRate() {
         return rate;
     }
 
+    /**
+     * TcParameter represents the parameters for a traffic control chaos
+     */
     @JsonProperty("rate")
     public void setRate(RateSpec rate) {
         this.rate = rate;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Template.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Template.java
index c32387b694b..28e6f775b34 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Template.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Template.java
@@ -170,11 +170,17 @@ public Template(Boolean abortWithStatusCheck, AWSChaosSpec awsChaos, AzureChaosS
         this.timeChaos = timeChaos;
     }
 
+    /**
+     * AbortWithStatusCheck describe whether to abort the workflow when the failure threshold of StatusCheck is exceeded. Only used when Type is TypeStatusCheck.
+     */
     @JsonProperty("abortWithStatusCheck")
     public Boolean getAbortWithStatusCheck() {
         return abortWithStatusCheck;
     }
 
+    /**
+     * AbortWithStatusCheck describe whether to abort the workflow when the failure threshold of StatusCheck is exceeded. Only used when Type is TypeStatusCheck.
+     */
     @JsonProperty("abortWithStatusCheck")
     public void setAbortWithStatusCheck(Boolean abortWithStatusCheck) {
         this.abortWithStatusCheck = abortWithStatusCheck;
@@ -210,23 +216,35 @@ public void setBlockChaos(BlockChaosSpec blockChaos) {
         this.blockChaos = blockChaos;
     }
 
+    /**
+     * Children describes the children steps of serial or parallel node. Only used when Type is TypeSerial or TypeParallel.
+     */
     @JsonProperty("children")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getChildren() {
         return children;
     }
 
+    /**
+     * Children describes the children steps of serial or parallel node. Only used when Type is TypeSerial or TypeParallel.
+     */
     @JsonProperty("children")
     public void setChildren(List<String> children) {
         this.children = children;
     }
 
+    /**
+     * ConditionalBranches describes the conditional branches of custom tasks. Only used when Type is TypeTask.
+     */
     @JsonProperty("conditionalBranches")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ConditionalBranch> getConditionalBranches() {
         return conditionalBranches;
     }
 
+    /**
+     * ConditionalBranches describes the conditional branches of custom tasks. Only used when Type is TypeTask.
+     */
     @JsonProperty("conditionalBranches")
     public void setConditionalBranches(List<ConditionalBranch> conditionalBranches) {
         this.conditionalBranches = conditionalBranches;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/TimeChaos.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/TimeChaos.java
index 8b4038bfde6..c0e852f6ab1 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/TimeChaos.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/TimeChaos.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TimeChaos is the Schema for the timechaos API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class TimeChaos implements Editable<TimeChaosBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TimeChaos";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TimeChaos(String apiVersion, String kind, ObjectMeta metadata, TimeChaosS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TimeChaos is the Schema for the timechaos API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TimeChaos is the Schema for the timechaos API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * TimeChaos is the Schema for the timechaos API
+     */
     @JsonProperty("spec")
     public TimeChaosSpec getSpec() {
         return spec;
     }
 
+    /**
+     * TimeChaos is the Schema for the timechaos API
+     */
     @JsonProperty("spec")
     public void setSpec(TimeChaosSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * TimeChaos is the Schema for the timechaos API
+     */
     @JsonProperty("status")
     public TimeChaosStatus getStatus() {
         return status;
     }
 
+    /**
+     * TimeChaos is the Schema for the timechaos API
+     */
     @JsonProperty("status")
     public void setStatus(TimeChaosStatus status) {
         this.status = status;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/TimeChaosList.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/TimeChaosList.java
index 1ba6fe61f9e..d28b9f3e64f 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/TimeChaosList.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/TimeChaosList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TimeChaosList contains a list of TimeChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class TimeChaosList implements Editable<TimeChaosListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.chaosmesh.v1alpha1.TimeChaos>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.chaosmesh.v1alpha1.TimeChaos> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TimeChaosList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TimeChaosList(String apiVersion, List<io.fabric8.chaosmesh.v1alpha1.TimeC
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * TimeChaosList contains a list of TimeChaos
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.chaosmesh.v1alpha1.TimeChaos> getItems() {
         return items;
     }
 
+    /**
+     * TimeChaosList contains a list of TimeChaos
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.chaosmesh.v1alpha1.TimeChaos> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TimeChaosList contains a list of TimeChaos
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TimeChaosList contains a list of TimeChaos
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/TimeChaosSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/TimeChaosSpec.java
index fb37d9eb8c7..fade5c77d78 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/TimeChaosSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/TimeChaosSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TimeChaosSpec defines the desired state of TimeChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -110,83 +113,131 @@ public TimeChaosSpec(List<String> clockIds, List<String> containerNames, String
         this.value = value;
     }
 
+    /**
+     * ClockIds defines all affected clock id All available options are ["CLOCK_REALTIME","CLOCK_MONOTONIC","CLOCK_PROCESS_CPUTIME_ID","CLOCK_THREAD_CPUTIME_ID", "CLOCK_MONOTONIC_RAW","CLOCK_REALTIME_COARSE","CLOCK_MONOTONIC_COARSE","CLOCK_BOOTTIME","CLOCK_REALTIME_ALARM", "CLOCK_BOOTTIME_ALARM"] Default value is ["CLOCK_REALTIME"]
+     */
     @JsonProperty("clockIds")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getClockIds() {
         return clockIds;
     }
 
+    /**
+     * ClockIds defines all affected clock id All available options are ["CLOCK_REALTIME","CLOCK_MONOTONIC","CLOCK_PROCESS_CPUTIME_ID","CLOCK_THREAD_CPUTIME_ID", "CLOCK_MONOTONIC_RAW","CLOCK_REALTIME_COARSE","CLOCK_MONOTONIC_COARSE","CLOCK_BOOTTIME","CLOCK_REALTIME_ALARM", "CLOCK_BOOTTIME_ALARM"] Default value is ["CLOCK_REALTIME"]
+     */
     @JsonProperty("clockIds")
     public void setClockIds(List<String> clockIds) {
         this.clockIds = clockIds;
     }
 
+    /**
+     * ContainerNames indicates list of the name of affected container. If not set, the first container will be injected
+     */
     @JsonProperty("containerNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getContainerNames() {
         return containerNames;
     }
 
+    /**
+     * ContainerNames indicates list of the name of affected container. If not set, the first container will be injected
+     */
     @JsonProperty("containerNames")
     public void setContainerNames(List<String> containerNames) {
         this.containerNames = containerNames;
     }
 
+    /**
+     * Duration represents the duration of the chaos action
+     */
     @JsonProperty("duration")
     public String getDuration() {
         return duration;
     }
 
+    /**
+     * Duration represents the duration of the chaos action
+     */
     @JsonProperty("duration")
     public void setDuration(String duration) {
         this.duration = duration;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Mode defines the mode to run chaos action. Supported mode: one / all / fixed / fixed-percent / random-max-percent
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public String getRemoteCluster() {
         return remoteCluster;
     }
 
+    /**
+     * RemoteCluster represents the remote cluster where the chaos will be deployed
+     */
     @JsonProperty("remoteCluster")
     public void setRemoteCluster(String remoteCluster) {
         this.remoteCluster = remoteCluster;
     }
 
+    /**
+     * TimeChaosSpec defines the desired state of TimeChaos
+     */
     @JsonProperty("selector")
     public PodSelectorSpec getSelector() {
         return selector;
     }
 
+    /**
+     * TimeChaosSpec defines the desired state of TimeChaos
+     */
     @JsonProperty("selector")
     public void setSelector(PodSelectorSpec selector) {
         this.selector = selector;
     }
 
+    /**
+     * TimeOffset defines the delta time of injected program. It's a possibly signed sequence of decimal numbers, such as "300ms", "-1.5h" or "2h45m". Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h".
+     */
     @JsonProperty("timeOffset")
     public String getTimeOffset() {
         return timeOffset;
     }
 
+    /**
+     * TimeOffset defines the delta time of injected program. It's a possibly signed sequence of decimal numbers, such as "300ms", "-1.5h" or "2h45m". Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h".
+     */
     @JsonProperty("timeOffset")
     public void setTimeOffset(String timeOffset) {
         this.timeOffset = timeOffset;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of pods to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of pods the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is required when the mode is set to `FixedMode` / `FixedPercentMode` / `RandomMaxPercentMode`. If `FixedMode`, provide an integer of pods to do chaos action. If `FixedPercentMode`, provide a number from 0-100 to specify the percent of pods the server can do chaos action. IF `RandomMaxPercentMode`,  provide a number from 0-100 to specify the max percent of pods to do chaos action
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/TimeChaosStatus.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/TimeChaosStatus.java
index 9866e5ad86f..1d0b75d8876 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/TimeChaosStatus.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/TimeChaosStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TimeChaosStatus defines the observed state of TimeChaos
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public TimeChaosStatus(List<ChaosCondition> conditions, ExperimentStatus experim
         this.experiment = experiment;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ChaosCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions represents the current global condition of the chaos
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ChaosCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * TimeChaosStatus defines the observed state of TimeChaos
+     */
     @JsonProperty("experiment")
     public ExperimentStatus getExperiment() {
         return experiment;
     }
 
+    /**
+     * TimeChaosStatus defines the observed state of TimeChaos
+     */
     @JsonProperty("experiment")
     public void setExperiment(ExperimentStatus experiment) {
         this.experiment = experiment;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Timespec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Timespec.java
index 25947249cf4..c595616502f 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Timespec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Timespec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Timespec represents a time
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Timespec(Long nsec, Long sec) {
         this.sec = sec;
     }
 
+    /**
+     * Timespec represents a time
+     */
     @JsonProperty("nsec")
     public Long getNsec() {
         return nsec;
     }
 
+    /**
+     * Timespec represents a time
+     */
     @JsonProperty("nsec")
     public void setNsec(Long nsec) {
         this.nsec = nsec;
     }
 
+    /**
+     * Timespec represents a time
+     */
     @JsonProperty("sec")
     public Long getSec() {
         return sec;
     }
 
+    /**
+     * Timespec represents a time
+     */
     @JsonProperty("sec")
     public void setSec(Long sec) {
         this.sec = sec;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/UserDefinedSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/UserDefinedSpec.java
index 18ebb43f7c7..4de8504869c 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/UserDefinedSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/UserDefinedSpec.java
@@ -82,21 +82,33 @@ public UserDefinedSpec(String attackCmd, String recoverCmd) {
         this.recoverCmd = recoverCmd;
     }
 
+    /**
+     * The command to be executed when attack
+     */
     @JsonProperty("attackCmd")
     public String getAttackCmd() {
         return attackCmd;
     }
 
+    /**
+     * The command to be executed when attack
+     */
     @JsonProperty("attackCmd")
     public void setAttackCmd(String attackCmd) {
         this.attackCmd = attackCmd;
     }
 
+    /**
+     * The command to be executed when recover
+     */
     @JsonProperty("recoverCmd")
     public String getRecoverCmd() {
         return recoverCmd;
     }
 
+    /**
+     * The command to be executed when recover
+     */
     @JsonProperty("recoverCmd")
     public void setRecoverCmd(String recoverCmd) {
         this.recoverCmd = recoverCmd;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/VMSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/VMSpec.java
index abf6f65e314..5c68f94b3f4 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/VMSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/VMSpec.java
@@ -78,11 +78,17 @@ public VMSpec(String vmName) {
         this.vmName = vmName;
     }
 
+    /**
+     * The name of the VM to be injected
+     */
     @JsonProperty("vm-name")
     public String getVmName() {
         return vmName;
     }
 
+    /**
+     * The name of the VM to be injected
+     */
     @JsonProperty("vm-name")
     public void setVmName(String vmName) {
         this.vmName = vmName;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Workflow.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Workflow.java
index 28d7dbf099b..71afbfe7635 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Workflow.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/Workflow.java
@@ -76,14 +76,8 @@
 public class Workflow implements Editable<WorkflowBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Workflow";
     @JsonProperty("metadata")
@@ -111,7 +105,7 @@ public Workflow(String apiVersion, String kind, ObjectMeta metadata, WorkflowSpe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +113,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +121,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,7 +129,7 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/WorkflowList.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/WorkflowList.java
index 000ff58ca1e..45cc3b8a50c 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/WorkflowList.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/WorkflowList.java
@@ -78,17 +78,11 @@
 public class WorkflowList implements Editable<WorkflowListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.chaosmesh.v1alpha1.Workflow>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.chaosmesh.v1alpha1.Workflow> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "WorkflowList";
     @JsonProperty("metadata")
@@ -111,7 +105,7 @@ public WorkflowList(String apiVersion, List<io.fabric8.chaosmesh.v1alpha1.Workfl
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +113,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -138,7 +132,7 @@ public void setItems(List<io.fabric8.chaosmesh.v1alpha1.Workflow> items) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,7 +140,7 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/WorkflowNode.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/WorkflowNode.java
index 01fd441d06f..326e018a42e 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/WorkflowNode.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/WorkflowNode.java
@@ -76,14 +76,8 @@
 public class WorkflowNode implements Editable<WorkflowNodeBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "WorkflowNode";
     @JsonProperty("metadata")
@@ -111,7 +105,7 @@ public WorkflowNode(String apiVersion, String kind, ObjectMeta metadata, Workflo
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +113,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +121,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,7 +129,7 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/WorkflowNodeList.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/WorkflowNodeList.java
index f6dda5c2d7d..e81614a521a 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/WorkflowNodeList.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/WorkflowNodeList.java
@@ -78,17 +78,11 @@
 public class WorkflowNodeList implements Editable<WorkflowNodeListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.chaosmesh.v1alpha1.WorkflowNode>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "chaos-mesh.org/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.chaosmesh.v1alpha1.WorkflowNode> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "WorkflowNodeList";
     @JsonProperty("metadata")
@@ -111,7 +105,7 @@ public WorkflowNodeList(String apiVersion, List<io.fabric8.chaosmesh.v1alpha1.Wo
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +113,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -138,7 +132,7 @@ public void setItems(List<io.fabric8.chaosmesh.v1alpha1.WorkflowNode> items) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,7 +140,7 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/WorkflowNodeSpec.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/WorkflowNodeSpec.java
index 3f8d5e83472..5354cfef251 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/WorkflowNodeSpec.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/WorkflowNodeSpec.java
@@ -178,11 +178,17 @@ public WorkflowNodeSpec(Boolean abortWithStatusCheck, AWSChaosSpec awsChaos, Azu
         this.workflowName = workflowName;
     }
 
+    /**
+     * AbortWithStatusCheck describe whether to abort the workflow when the failure threshold of StatusCheck is exceeded. Only used when Type is TypeStatusCheck.
+     */
     @JsonProperty("abortWithStatusCheck")
     public Boolean getAbortWithStatusCheck() {
         return abortWithStatusCheck;
     }
 
+    /**
+     * AbortWithStatusCheck describe whether to abort the workflow when the failure threshold of StatusCheck is exceeded. Only used when Type is TypeStatusCheck.
+     */
     @JsonProperty("abortWithStatusCheck")
     public void setAbortWithStatusCheck(Boolean abortWithStatusCheck) {
         this.abortWithStatusCheck = abortWithStatusCheck;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/WorkflowNodeStatus.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/WorkflowNodeStatus.java
index cf9a61680a2..f2dce114280 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/WorkflowNodeStatus.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/WorkflowNodeStatus.java
@@ -100,12 +100,18 @@ public WorkflowNodeStatus(List<LocalObjectReference> activeChildren, TypedLocalO
         this.finishedChildren = finishedChildren;
     }
 
+    /**
+     * ActiveChildren means the created children node
+     */
     @JsonProperty("activeChildren")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LocalObjectReference> getActiveChildren() {
         return activeChildren;
     }
 
+    /**
+     * ActiveChildren means the created children node
+     */
     @JsonProperty("activeChildren")
     public void setActiveChildren(List<LocalObjectReference> activeChildren) {
         this.activeChildren = activeChildren;
@@ -131,23 +137,35 @@ public void setConditionalBranchesStatus(ConditionalBranchesStatus conditionalBr
         this.conditionalBranchesStatus = conditionalBranchesStatus;
     }
 
+    /**
+     * Represents the latest available observations of a workflow node's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WorkflowNodeCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Represents the latest available observations of a workflow node's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<WorkflowNodeCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Children is necessary for representing the order when replicated child template references by parent template.
+     */
     @JsonProperty("finishedChildren")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LocalObjectReference> getFinishedChildren() {
         return finishedChildren;
     }
 
+    /**
+     * Children is necessary for representing the order when replicated child template references by parent template.
+     */
     @JsonProperty("finishedChildren")
     public void setFinishedChildren(List<LocalObjectReference> finishedChildren) {
         this.finishedChildren = finishedChildren;
diff --git a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/WorkflowStatus.java b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/WorkflowStatus.java
index d53e6ac809e..231998b8453 100644
--- a/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/WorkflowStatus.java
+++ b/extensions/chaosmesh/model/src/generated/java/io/fabric8/chaosmesh/v1alpha1/WorkflowStatus.java
@@ -93,12 +93,18 @@ public WorkflowStatus(List<WorkflowCondition> conditions, String endTime, String
         this.startTime = startTime;
     }
 
+    /**
+     * Represents the latest available observations of a workflow's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WorkflowCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Represents the latest available observations of a workflow's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<WorkflowCondition> conditions) {
         this.conditions = conditions;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/analysis/v1alpha1/AnalysisMessageBase.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/analysis/v1alpha1/AnalysisMessageBase.java
index 981bab06612..32f09a432c3 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/analysis/v1alpha1/AnalysisMessageBase.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/analysis/v1alpha1/AnalysisMessageBase.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AnalysisMessageBase describes some common information that is needed for all messages. All information should be static with respect to the error code.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public AnalysisMessageBase(String documentationUrl, AnalysisMessageBaseLevel lev
         this.type = type;
     }
 
+    /**
+     * A url pointing to the Istio documentation for this specific error type. Should be of the form `^http(s)?://(preliminary\.)?istio.io/docs/reference/config/analysis/` Required.
+     */
     @JsonProperty("documentationUrl")
     public String getDocumentationUrl() {
         return documentationUrl;
     }
 
+    /**
+     * A url pointing to the Istio documentation for this specific error type. Should be of the form `^http(s)?://(preliminary\.)?istio.io/docs/reference/config/analysis/` Required.
+     */
     @JsonProperty("documentationUrl")
     public void setDocumentationUrl(String documentationUrl) {
         this.documentationUrl = documentationUrl;
     }
 
+    /**
+     * AnalysisMessageBase describes some common information that is needed for all messages. All information should be static with respect to the error code.
+     */
     @JsonProperty("level")
     public AnalysisMessageBaseLevel getLevel() {
         return level;
     }
 
+    /**
+     * AnalysisMessageBase describes some common information that is needed for all messages. All information should be static with respect to the error code.
+     */
     @JsonProperty("level")
     public void setLevel(AnalysisMessageBaseLevel level) {
         this.level = level;
     }
 
+    /**
+     * AnalysisMessageBase describes some common information that is needed for all messages. All information should be static with respect to the error code.
+     */
     @JsonProperty("type")
     public AnalysisMessageBaseType getType() {
         return type;
     }
 
+    /**
+     * AnalysisMessageBase describes some common information that is needed for all messages. All information should be static with respect to the error code.
+     */
     @JsonProperty("type")
     public void setType(AnalysisMessageBaseType type) {
         this.type = type;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/analysis/v1alpha1/AnalysisMessageBaseLevel.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/analysis/v1alpha1/AnalysisMessageBaseLevel.java
index eb6dace9d4f..a083afc18e4 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/analysis/v1alpha1/AnalysisMessageBaseLevel.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/analysis/v1alpha1/AnalysisMessageBaseLevel.java
@@ -4,6 +4,9 @@
 import javax.annotation.Generated;
 import com.fasterxml.jackson.annotation.JsonCreator;
 
+/**
+ * The values here are chosen so that more severe messages get sorted higher, as well as leaving space in between to add more later
+ */
 @Generated("io.fabric8.kubernetes.schema.generator.model.ModelGenerator")
 public enum AnalysisMessageBaseLevel 
 {
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/analysis/v1alpha1/AnalysisMessageBaseType.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/analysis/v1alpha1/AnalysisMessageBaseType.java
index ba3403be5ef..fad3371d8b6 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/analysis/v1alpha1/AnalysisMessageBaseType.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/analysis/v1alpha1/AnalysisMessageBaseType.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * A unique identifier for the type of message. Name is intended to be human-readable, code is intended to be machine readable. There should be a one-to-one mapping between name and code. (i.e. do not re-use names or codes between message types.)
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public AnalysisMessageBaseType(String code, String name) {
         this.name = name;
     }
 
+    /**
+     * A 7 character code matching `^IST[0-9]{4}$` intended to uniquely identify the message type. (e.g. "IST0001" is mapped to the "InternalError" message type.) 0000-0100 are reserved. Required.
+     */
     @JsonProperty("code")
     public String getCode() {
         return code;
     }
 
+    /**
+     * A 7 character code matching `^IST[0-9]{4}$` intended to uniquely identify the message type. (e.g. "IST0001" is mapped to the "InternalError" message type.) 0000-0100 are reserved. Required.
+     */
     @JsonProperty("code")
     public void setCode(String code) {
         this.code = code;
     }
 
+    /**
+     * A human-readable name for the message type. e.g. "InternalError", "PodMissingProxy". This should be the same for all messages of the same type. Required.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * A human-readable name for the message type. e.g. "InternalError", "PodMissingProxy". This should be the same for all messages of the same type. Required.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/analysis/v1alpha1/AnalysisMessageWeakSchema.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/analysis/v1alpha1/AnalysisMessageWeakSchema.java
index 333835b4019..25b20b35ca0 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/analysis/v1alpha1/AnalysisMessageWeakSchema.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/analysis/v1alpha1/AnalysisMessageWeakSchema.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AnalysisMessageWeakSchema is the set of information that's needed to define a weakly-typed schema. The purpose of this proto is to provide a mechanism for validating istio/istio/galley/pkg/config/analysis/msg/messages.yaml to make sure that we don't allow committing underspecified types.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public AnalysisMessageWeakSchema(List<AnalysisMessageWeakSchemaArgType> args, St
         this.template = template;
     }
 
+    /**
+     * A description of the arguments for a particular message type
+     */
     @JsonProperty("args")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AnalysisMessageWeakSchemaArgType> getArgs() {
         return args;
     }
 
+    /**
+     * A description of the arguments for a particular message type
+     */
     @JsonProperty("args")
     public void setArgs(List<AnalysisMessageWeakSchemaArgType> args) {
         this.args = args;
     }
 
+    /**
+     * A human readable description of what the error means. Required.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * A human readable description of what the error means. Required.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * AnalysisMessageWeakSchema is the set of information that's needed to define a weakly-typed schema. The purpose of this proto is to provide a mechanism for validating istio/istio/galley/pkg/config/analysis/msg/messages.yaml to make sure that we don't allow committing underspecified types.
+     */
     @JsonProperty("messageBase")
     public AnalysisMessageBase getMessageBase() {
         return messageBase;
     }
 
+    /**
+     * AnalysisMessageWeakSchema is the set of information that's needed to define a weakly-typed schema. The purpose of this proto is to provide a mechanism for validating istio/istio/galley/pkg/config/analysis/msg/messages.yaml to make sure that we don't allow committing underspecified types.
+     */
     @JsonProperty("messageBase")
     public void setMessageBase(AnalysisMessageBase messageBase) {
         this.messageBase = messageBase;
     }
 
+    /**
+     * A go-style template string (https://golang.org/pkg/fmt/#hdr-Printing) defining how to combine the args for a  particular message into a log line. Required.
+     */
     @JsonProperty("template")
     public String getTemplate() {
         return template;
     }
 
+    /**
+     * A go-style template string (https://golang.org/pkg/fmt/#hdr-Printing) defining how to combine the args for a  particular message into a log line. Required.
+     */
     @JsonProperty("template")
     public void setTemplate(String template) {
         this.template = template;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/analysis/v1alpha1/AnalysisMessageWeakSchemaArgType.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/analysis/v1alpha1/AnalysisMessageWeakSchemaArgType.java
index 65c4bb08abf..3014eb97c3e 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/analysis/v1alpha1/AnalysisMessageWeakSchemaArgType.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/analysis/v1alpha1/AnalysisMessageWeakSchemaArgType.java
@@ -82,21 +82,33 @@ public AnalysisMessageWeakSchemaArgType(String goType, String name) {
         this.name = name;
     }
 
+    /**
+     * Required. Should be a golang type, used in code generation. Ideally this will change to a less language-pinned type before this gets out of alpha, but for compatibility with current istio/istio code it's go_type for now.
+     */
     @JsonProperty("goType")
     public String getGoType() {
         return goType;
     }
 
+    /**
+     * Required. Should be a golang type, used in code generation. Ideally this will change to a less language-pinned type before this gets out of alpha, but for compatibility with current istio/istio code it's go_type for now.
+     */
     @JsonProperty("goType")
     public void setGoType(String goType) {
         this.goType = goType;
     }
 
+    /**
+     * Required
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Required
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/analysis/v1alpha1/GenericAnalysisMessage.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/analysis/v1alpha1/GenericAnalysisMessage.java
index ec8bfbe476d..c9a884be123 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/analysis/v1alpha1/GenericAnalysisMessage.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/analysis/v1alpha1/GenericAnalysisMessage.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GenericAnalysisMessage is an instance of an AnalysisMessage defined by a schema, whose metaschema is AnalysisMessageWeakSchema. (Names are hard.) Code should be able to perform validation of arguments as needed by using the message type information to look at the AnalysisMessageWeakSchema and examine the list of args at runtime. Developers can also create stronger-typed versions of GenericAnalysisMessage for well-known and stable message types.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public GenericAnalysisMessage(Object args, AnalysisMessageBase messageBase, List
         this.resourcePaths = resourcePaths;
     }
 
+    /**
+     * GenericAnalysisMessage is an instance of an AnalysisMessage defined by a schema, whose metaschema is AnalysisMessageWeakSchema. (Names are hard.) Code should be able to perform validation of arguments as needed by using the message type information to look at the AnalysisMessageWeakSchema and examine the list of args at runtime. Developers can also create stronger-typed versions of GenericAnalysisMessage for well-known and stable message types.
+     */
     @JsonProperty("args")
     public Object getArgs() {
         return args;
     }
 
+    /**
+     * GenericAnalysisMessage is an instance of an AnalysisMessage defined by a schema, whose metaschema is AnalysisMessageWeakSchema. (Names are hard.) Code should be able to perform validation of arguments as needed by using the message type information to look at the AnalysisMessageWeakSchema and examine the list of args at runtime. Developers can also create stronger-typed versions of GenericAnalysisMessage for well-known and stable message types.
+     */
     @JsonProperty("args")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setArgs(Object args) {
         this.args = args;
     }
 
+    /**
+     * GenericAnalysisMessage is an instance of an AnalysisMessage defined by a schema, whose metaschema is AnalysisMessageWeakSchema. (Names are hard.) Code should be able to perform validation of arguments as needed by using the message type information to look at the AnalysisMessageWeakSchema and examine the list of args at runtime. Developers can also create stronger-typed versions of GenericAnalysisMessage for well-known and stable message types.
+     */
     @JsonProperty("messageBase")
     public AnalysisMessageBase getMessageBase() {
         return messageBase;
     }
 
+    /**
+     * GenericAnalysisMessage is an instance of an AnalysisMessage defined by a schema, whose metaschema is AnalysisMessageWeakSchema. (Names are hard.) Code should be able to perform validation of arguments as needed by using the message type information to look at the AnalysisMessageWeakSchema and examine the list of args at runtime. Developers can also create stronger-typed versions of GenericAnalysisMessage for well-known and stable message types.
+     */
     @JsonProperty("messageBase")
     public void setMessageBase(AnalysisMessageBase messageBase) {
         this.messageBase = messageBase;
     }
 
+    /**
+     * A list of strings specifying the resource identifiers that were the cause of message generation. A "path" here is a (NAMESPACE\/)?RESOURCETYPE/NAME tuple that uniquely identifies a particular resource. There doesn't seem to be a single concept for this, but this is intuitively taken from https://kubernetes.io/docs/reference/using-api/api-concepts/#standard-api-terminology At least one is required.
+     */
     @JsonProperty("resourcePaths")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getResourcePaths() {
         return resourcePaths;
     }
 
+    /**
+     * A list of strings specifying the resource identifiers that were the cause of message generation. A "path" here is a (NAMESPACE\/)?RESOURCETYPE/NAME tuple that uniquely identifies a particular resource. There doesn't seem to be a single concept for this, but this is intuitively taken from https://kubernetes.io/docs/reference/using-api/api-concepts/#standard-api-terminology At least one is required.
+     */
     @JsonProperty("resourcePaths")
     public void setResourcePaths(List<String> resourcePaths) {
         this.resourcePaths = resourcePaths;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/analysis/v1alpha1/InternalErrorAnalysisMessage.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/analysis/v1alpha1/InternalErrorAnalysisMessage.java
index 88bdd62bd0e..c568b41d0b8 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/analysis/v1alpha1/InternalErrorAnalysisMessage.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/analysis/v1alpha1/InternalErrorAnalysisMessage.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * InternalErrorAnalysisMessage is a strongly-typed message representing some error in Istio code that prevented us from performing analysis at all.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public InternalErrorAnalysisMessage(String detail, AnalysisMessageBase messageBa
         this.messageBase = messageBase;
     }
 
+    /**
+     * Any detail regarding specifics of the error. Should be human-readable.
+     */
     @JsonProperty("detail")
     public String getDetail() {
         return detail;
     }
 
+    /**
+     * Any detail regarding specifics of the error. Should be human-readable.
+     */
     @JsonProperty("detail")
     public void setDetail(String detail) {
         this.detail = detail;
     }
 
+    /**
+     * InternalErrorAnalysisMessage is a strongly-typed message representing some error in Istio code that prevented us from performing analysis at all.
+     */
     @JsonProperty("messageBase")
     public AnalysisMessageBase getMessageBase() {
         return messageBase;
     }
 
+    /**
+     * InternalErrorAnalysisMessage is a strongly-typed message representing some error in Istio code that prevented us from performing analysis at all.
+     */
     @JsonProperty("messageBase")
     public void setMessageBase(AnalysisMessageBase messageBase) {
         this.messageBase = messageBase;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/extensions/v1alpha1/EnvVar.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/extensions/v1alpha1/EnvVar.java
index e310574f6bf..ed7120bf0b9 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/extensions/v1alpha1/EnvVar.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/extensions/v1alpha1/EnvVar.java
@@ -85,21 +85,33 @@ public EnvVar(String name, String value, EnvValueSource valueFrom) {
         this.valueFrom = valueFrom;
     }
 
+    /**
+     * Name of the environment variable. Must be a C_IDENTIFIER.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the environment variable. Must be a C_IDENTIFIER.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Value for the environment variable. Only applicable if `valueFrom` is `HOST`. Defaults to "".
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value for the environment variable. Only applicable if `valueFrom` is `HOST`. Defaults to "".
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/extensions/v1alpha1/PluginPhase.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/extensions/v1alpha1/PluginPhase.java
index 9ecaf248172..b2dbf51d7dc 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/extensions/v1alpha1/PluginPhase.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/extensions/v1alpha1/PluginPhase.java
@@ -4,6 +4,9 @@
 import javax.annotation.Generated;
 import com.fasterxml.jackson.annotation.JsonCreator;
 
+/**
+ * The phase in the filter chain where the plugin will be injected.
+ */
 @Generated("io.fabric8.kubernetes.schema.generator.model.ModelGenerator")
 public enum PluginPhase 
 {
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/extensions/v1alpha1/PluginType.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/extensions/v1alpha1/PluginType.java
index 7da5bd824d6..cd6fadb7b31 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/extensions/v1alpha1/PluginType.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/extensions/v1alpha1/PluginType.java
@@ -4,6 +4,9 @@
 import javax.annotation.Generated;
 import com.fasterxml.jackson.annotation.JsonCreator;
 
+/**
+ * PluginType indicates the type of Wasm extension to be used. There are two types of extensions: `HTTP` and `NETWORK`.<br><p> <br><p> The `HTTP` extension works at Layer 7 (for example, as an HTTP filter in Envoy). The detailed HTTP interface can be found here: - [C++](https://github.com/proxy-wasm/proxy-wasm-cpp-host/blob/b7e690703c7f26707438a2f1ebd7c197bc8f0296/include/proxy-wasm/context_interface.h#L199) - [Rust](https://github.com/proxy-wasm/proxy-wasm-rust-sdk/blob/6b47aec926bc29971c727471d6f4c972ec407c7f/src/traits.rs#L309)<br><p> <br><p> The `NETWORK` extension works at Layer 4 (for example, as a network filter in Envoy). The detailed `NETWORK` interface can be found here: - [C++](https://github.com/proxy-wasm/proxy-wasm-cpp-host/blob/b7e690703c7f26707438a2f1ebd7c197bc8f0296/include/proxy-wasm/context_interface.h#L257) - [Rust](https://github.com/proxy-wasm/proxy-wasm-rust-sdk/blob/6b47aec926bc29971c727471d6f4c972ec407c7f/src/traits.rs#L257)<br><p> <br><p> The `NETWORK` extension can be applied to HTTP traffic as well.
+ */
 @Generated("io.fabric8.kubernetes.schema.generator.model.ModelGenerator")
 public enum PluginType 
 {
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/extensions/v1alpha1/PullPolicy.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/extensions/v1alpha1/PullPolicy.java
index 62dcdf2a22b..7e535794b99 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/extensions/v1alpha1/PullPolicy.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/extensions/v1alpha1/PullPolicy.java
@@ -4,6 +4,9 @@
 import javax.annotation.Generated;
 import com.fasterxml.jackson.annotation.JsonCreator;
 
+/**
+ * The pull behaviour to be applied when fetching a Wam module, mirroring K8s behaviour.<br><p> <br><p> &lt;!-- buf:lint:ignore ENUM_VALUE_UPPER_SNAKE_CASE --&gt;
+ */
 @Generated("io.fabric8.kubernetes.schema.generator.model.ModelGenerator")
 public enum PullPolicy 
 {
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/extensions/v1alpha1/VmConfig.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/extensions/v1alpha1/VmConfig.java
index 832c70b9c11..5492079764f 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/extensions/v1alpha1/VmConfig.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/extensions/v1alpha1/VmConfig.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Configuration for a Wasm VM. more details can be found [here](https://www.envoyproxy.io/docs/envoy/latest/api-v3/extensions/wasm/v3/wasm.proto#extensions-wasm-v3-vmconfig).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public VmConfig(List<EnvVar> env) {
         this.env = env;
     }
 
+    /**
+     * Specifies environment variables to be injected to this VM. Note that if a key does not exist, it will be ignored.
+     */
     @JsonProperty("env")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvVar> getEnv() {
         return env;
     }
 
+    /**
+     * Specifies environment variables to be injected to this VM. Note that if a key does not exist, it will be ignored.
+     */
     @JsonProperty("env")
     public void setEnv(List<EnvVar> env) {
         this.env = env;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/extensions/v1alpha1/WasmPlugin.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/extensions/v1alpha1/WasmPlugin.java
index 709b0955d33..9eb4102893b 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/extensions/v1alpha1/WasmPlugin.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/extensions/v1alpha1/WasmPlugin.java
@@ -41,6 +41,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WasmPlugins provides a mechanism to extend the functionality provided by the Istio proxy through WebAssembly filters.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -155,164 +158,260 @@ public WasmPlugin(FailStrategy failStrategy, PullPolicy imagePullPolicy, String
         this.vmConfig = vmConfig;
     }
 
+    /**
+     * WasmPlugins provides a mechanism to extend the functionality provided by the Istio proxy through WebAssembly filters.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("failStrategy")
     public FailStrategy getFailStrategy() {
         return failStrategy;
     }
 
+    /**
+     * WasmPlugins provides a mechanism to extend the functionality provided by the Istio proxy through WebAssembly filters.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("failStrategy")
     public void setFailStrategy(FailStrategy failStrategy) {
         this.failStrategy = failStrategy;
     }
 
+    /**
+     * WasmPlugins provides a mechanism to extend the functionality provided by the Istio proxy through WebAssembly filters.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("imagePullPolicy")
     public PullPolicy getImagePullPolicy() {
         return imagePullPolicy;
     }
 
+    /**
+     * WasmPlugins provides a mechanism to extend the functionality provided by the Istio proxy through WebAssembly filters.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("imagePullPolicy")
     public void setImagePullPolicy(PullPolicy imagePullPolicy) {
         this.imagePullPolicy = imagePullPolicy;
     }
 
+    /**
+     * Credentials to use for OCI image pulling. Name of a Kubernetes Secret in the same namespace as the `WasmPlugin` that contains a Docker pull secret which is to be used to authenticate against the registry when pulling the image.
+     */
     @JsonProperty("imagePullSecret")
     public String getImagePullSecret() {
         return imagePullSecret;
     }
 
+    /**
+     * Credentials to use for OCI image pulling. Name of a Kubernetes Secret in the same namespace as the `WasmPlugin` that contains a Docker pull secret which is to be used to authenticate against the registry when pulling the image.
+     */
     @JsonProperty("imagePullSecret")
     public void setImagePullSecret(String imagePullSecret) {
         this.imagePullSecret = imagePullSecret;
     }
 
+    /**
+     * Specifies the criteria to determine which traffic is passed to WasmPlugin. If a traffic satisfies any of TrafficSelectors, the traffic passes the WasmPlugin.
+     */
     @JsonProperty("match")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WasmPluginTrafficSelector> getMatch() {
         return match;
     }
 
+    /**
+     * Specifies the criteria to determine which traffic is passed to WasmPlugin. If a traffic satisfies any of TrafficSelectors, the traffic passes the WasmPlugin.
+     */
     @JsonProperty("match")
     public void setMatch(List<WasmPluginTrafficSelector> match) {
         this.match = match;
     }
 
+    /**
+     * WasmPlugins provides a mechanism to extend the functionality provided by the Istio proxy through WebAssembly filters.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("phase")
     public PluginPhase getPhase() {
         return phase;
     }
 
+    /**
+     * WasmPlugins provides a mechanism to extend the functionality provided by the Istio proxy through WebAssembly filters.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("phase")
     public void setPhase(PluginPhase phase) {
         this.phase = phase;
     }
 
+    /**
+     * WasmPlugins provides a mechanism to extend the functionality provided by the Istio proxy through WebAssembly filters.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("pluginConfig")
     public Object getPluginConfig() {
         return pluginConfig;
     }
 
+    /**
+     * WasmPlugins provides a mechanism to extend the functionality provided by the Istio proxy through WebAssembly filters.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("pluginConfig")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setPluginConfig(Object pluginConfig) {
         this.pluginConfig = pluginConfig;
     }
 
+    /**
+     * The plugin name to be used in the Envoy configuration (used to be called `rootID`). Some .wasm modules might require this value to select the Wasm plugin to execute.
+     */
     @JsonProperty("pluginName")
     public String getPluginName() {
         return pluginName;
     }
 
+    /**
+     * The plugin name to be used in the Envoy configuration (used to be called `rootID`). Some .wasm modules might require this value to select the Wasm plugin to execute.
+     */
     @JsonProperty("pluginName")
     public void setPluginName(String pluginName) {
         this.pluginName = pluginName;
     }
 
+    /**
+     * WasmPlugins provides a mechanism to extend the functionality provided by the Istio proxy through WebAssembly filters.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("priority")
     public Integer getPriority() {
         return priority;
     }
 
+    /**
+     * WasmPlugins provides a mechanism to extend the functionality provided by the Istio proxy through WebAssembly filters.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("priority")
     public void setPriority(Integer priority) {
         this.priority = priority;
     }
 
+    /**
+     * WasmPlugins provides a mechanism to extend the functionality provided by the Istio proxy through WebAssembly filters.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("selector")
     public WorkloadSelector getSelector() {
         return selector;
     }
 
+    /**
+     * WasmPlugins provides a mechanism to extend the functionality provided by the Istio proxy through WebAssembly filters.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("selector")
     public void setSelector(WorkloadSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * SHA256 checksum that will be used to verify Wasm module or OCI container. If the `url` field already references a SHA256 (using the `@sha256:` notation), it must match the value of this field. If an OCI image is referenced by tag and this field is set, its checksum will be verified against the contents of this field after pulling.
+     */
     @JsonProperty("sha256")
     public String getSha256() {
         return sha256;
     }
 
+    /**
+     * SHA256 checksum that will be used to verify Wasm module or OCI container. If the `url` field already references a SHA256 (using the `@sha256:` notation), it must match the value of this field. If an OCI image is referenced by tag and this field is set, its checksum will be verified against the contents of this field after pulling.
+     */
     @JsonProperty("sha256")
     public void setSha256(String sha256) {
         this.sha256 = sha256;
     }
 
+    /**
+     * WasmPlugins provides a mechanism to extend the functionality provided by the Istio proxy through WebAssembly filters.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("targetRef")
     public PolicyTargetReference getTargetRef() {
         return targetRef;
     }
 
+    /**
+     * WasmPlugins provides a mechanism to extend the functionality provided by the Istio proxy through WebAssembly filters.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("targetRef")
     public void setTargetRef(PolicyTargetReference targetRef) {
         this.targetRef = targetRef;
     }
 
+    /**
+     * Optional. The targetRefs specifies a list of resources the policy should be applied to. The targeted resources specified will determine which workloads the policy applies to.<br><p> <br><p> Currently, the following resource attachment types are supported: &#42; `kind: Gateway` with `group: gateway.networking.k8s.io` in the same namespace. &#42; `kind: Service` with `group: ""` or `group: "core"` in the same namespace. This type is only supported for waypoints.<br><p> <br><p> If not set, the policy is applied as defined by the selector. At most one of the selector and targetRefs can be set.<br><p> <br><p> NOTE: If you are using the `targetRefs` field in a multi-revision environment with Istio versions prior to 1.22, it is highly recommended that you pin the policy to a revision running 1.22+ via the `istio.io/rev` label. This is to prevent proxies connected to older control planes (that don't know about the `targetRefs` field) from misinterpreting the policy as namespace-wide during the upgrade process.<br><p> <br><p> NOTE: Waypoint proxies are required to use this field for policies to apply; `selector` policies will be ignored.
+     */
     @JsonProperty("targetRefs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PolicyTargetReference> getTargetRefs() {
         return targetRefs;
     }
 
+    /**
+     * Optional. The targetRefs specifies a list of resources the policy should be applied to. The targeted resources specified will determine which workloads the policy applies to.<br><p> <br><p> Currently, the following resource attachment types are supported: &#42; `kind: Gateway` with `group: gateway.networking.k8s.io` in the same namespace. &#42; `kind: Service` with `group: ""` or `group: "core"` in the same namespace. This type is only supported for waypoints.<br><p> <br><p> If not set, the policy is applied as defined by the selector. At most one of the selector and targetRefs can be set.<br><p> <br><p> NOTE: If you are using the `targetRefs` field in a multi-revision environment with Istio versions prior to 1.22, it is highly recommended that you pin the policy to a revision running 1.22+ via the `istio.io/rev` label. This is to prevent proxies connected to older control planes (that don't know about the `targetRefs` field) from misinterpreting the policy as namespace-wide during the upgrade process.<br><p> <br><p> NOTE: Waypoint proxies are required to use this field for policies to apply; `selector` policies will be ignored.
+     */
     @JsonProperty("targetRefs")
     public void setTargetRefs(List<PolicyTargetReference> targetRefs) {
         this.targetRefs = targetRefs;
     }
 
+    /**
+     * WasmPlugins provides a mechanism to extend the functionality provided by the Istio proxy through WebAssembly filters.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("type")
     public PluginType getType() {
         return type;
     }
 
+    /**
+     * WasmPlugins provides a mechanism to extend the functionality provided by the Istio proxy through WebAssembly filters.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("type")
     public void setType(PluginType type) {
         this.type = type;
     }
 
+    /**
+     * URL of a Wasm module or OCI container. If no scheme is present, defaults to `oci://`, referencing an OCI image. Other valid schemes are `file://` for referencing .wasm module files present locally within the proxy container, and `http[s]://` for `.wasm` module files hosted remotely.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * URL of a Wasm module or OCI container. If no scheme is present, defaults to `oci://`, referencing an OCI image. Other valid schemes are `file://` for referencing .wasm module files present locally within the proxy container, and `http[s]://` for `.wasm` module files hosted remotely.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
     }
 
+    /**
+     * $hide_from_docs Public key that will be used to verify signatures of signed OCI images or Wasm modules.<br><p> <br><p> At this moment, various ways for signing/verifying are emerging and being proposed. We can observe two major streams for signing OCI images: Cosign from Sigstore and Notary, which is used in Docker Content Trust. In case of Wasm module, multiple approaches are still in discussion.<br><p>   - https://github.com/WebAssembly/design/issues/1413<br><p>   - https://github.com/wasm-signatures/design (various signing tools are enumerated)<br><p> <br><p> In addition, for each method for signing&amp;verifying, we may need to consider to provide additional data or configuration (e.g., key rolling, KMS, root certs, ...) as well.<br><p> <br><p> To deal with this situation, we need to elaborate more generic way to describe how to sign and verify the image or wasm binary, and how to specify relevant data, including this `verification_key`.<br><p> <br><p> Therefore, this field will not be implemented until the detailed design is established. For the future use, just keep this field in proto and hide from documentation.
+     */
     @JsonProperty("verificationKey")
     public String getVerificationKey() {
         return verificationKey;
     }
 
+    /**
+     * $hide_from_docs Public key that will be used to verify signatures of signed OCI images or Wasm modules.<br><p> <br><p> At this moment, various ways for signing/verifying are emerging and being proposed. We can observe two major streams for signing OCI images: Cosign from Sigstore and Notary, which is used in Docker Content Trust. In case of Wasm module, multiple approaches are still in discussion.<br><p>   - https://github.com/WebAssembly/design/issues/1413<br><p>   - https://github.com/wasm-signatures/design (various signing tools are enumerated)<br><p> <br><p> In addition, for each method for signing&amp;verifying, we may need to consider to provide additional data or configuration (e.g., key rolling, KMS, root certs, ...) as well.<br><p> <br><p> To deal with this situation, we need to elaborate more generic way to describe how to sign and verify the image or wasm binary, and how to specify relevant data, including this `verification_key`.<br><p> <br><p> Therefore, this field will not be implemented until the detailed design is established. For the future use, just keep this field in proto and hide from documentation.
+     */
     @JsonProperty("verificationKey")
     public void setVerificationKey(String verificationKey) {
         this.verificationKey = verificationKey;
     }
 
+    /**
+     * WasmPlugins provides a mechanism to extend the functionality provided by the Istio proxy through WebAssembly filters.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("vmConfig")
     public VmConfig getVmConfig() {
         return vmConfig;
     }
 
+    /**
+     * WasmPlugins provides a mechanism to extend the functionality provided by the Istio proxy through WebAssembly filters.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("vmConfig")
     public void setVmConfig(VmConfig vmConfig) {
         this.vmConfig = vmConfig;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/extensions/v1alpha1/WasmPluginTrafficSelector.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/extensions/v1alpha1/WasmPluginTrafficSelector.java
index 2eb6363bcb1..cf1bb8cb6f3 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/extensions/v1alpha1/WasmPluginTrafficSelector.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/extensions/v1alpha1/WasmPluginTrafficSelector.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TrafficSelector provides a mechanism to select a specific traffic flow for which this Wasm Plugin will be enabled. When all the sub conditions in the TrafficSelector are satisfied, the traffic will be selected.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,22 +89,34 @@ public WasmPluginTrafficSelector(Integer mode, List<PortSelector> ports) {
         this.ports = ports;
     }
 
+    /**
+     * Criteria for selecting traffic by their direction. Note that `CLIENT` and `SERVER` are analogous to OUTBOUND and INBOUND, respectively. For the gateway, the field should be `CLIENT` or `CLIENT_AND_SERVER`. If not specified, the default value is `CLIENT_AND_SERVER`.
+     */
     @JsonProperty("mode")
     public Integer getMode() {
         return mode;
     }
 
+    /**
+     * Criteria for selecting traffic by their direction. Note that `CLIENT` and `SERVER` are analogous to OUTBOUND and INBOUND, respectively. For the gateway, the field should be `CLIENT` or `CLIENT_AND_SERVER`. If not specified, the default value is `CLIENT_AND_SERVER`.
+     */
     @JsonProperty("mode")
     public void setMode(Integer mode) {
         this.mode = mode;
     }
 
+    /**
+     * Criteria for selecting traffic by their destination port. More specifically, for the outbound traffic, the destination port would be the port of the target service. On the other hand, for the inbound traffic, the destination port is the port bound by the server process in the same Pod.<br><p> <br><p> If one of the given `ports` is matched, this condition is evaluated to true. If not specified, this condition is evaluated to true for any port.
+     */
     @JsonProperty("ports")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PortSelector> getPorts() {
         return ports;
     }
 
+    /**
+     * Criteria for selecting traffic by their destination port. More specifically, for the outbound traffic, the destination port would be the port of the target service. On the other hand, for the inbound traffic, the destination port is the port bound by the server process in the same Pod.<br><p> <br><p> If one of the given `ports` is matched, this condition is evaluated to true. If not specified, this condition is evaluated to true for any port.
+     */
     @JsonProperty("ports")
     public void setPorts(List<PortSelector> ports) {
         this.ports = ports;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/meta/v1alpha1/IstioCondition.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/meta/v1alpha1/IstioCondition.java
index f22d8ef4eee..f58e567cf65 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/meta/v1alpha1/IstioCondition.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/meta/v1alpha1/IstioCondition.java
@@ -118,41 +118,65 @@ public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status is the status of the condition. Can be True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status is the status of the condition. Can be True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type is the type of the condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of the condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/meta/v1alpha1/IstioStatus.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/meta/v1alpha1/IstioStatus.java
index 315552628f5..57c1e439f24 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/meta/v1alpha1/IstioStatus.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/meta/v1alpha1/IstioStatus.java
@@ -91,33 +91,51 @@ public IstioStatus(List<IstioCondition> conditions, Long observedGeneration, Lis
         this.validationMessages = validationMessages;
     }
 
+    /**
+     * Current service state of the resource. More info: https://istio.io/docs/reference/config/config-status/
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IstioCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Current service state of the resource. More info: https://istio.io/docs/reference/config/config-status/
+     */
     @JsonProperty("conditions")
     public void setConditions(List<IstioCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Resource Generation to which the Reconciled Condition refers. When this value is not equal to the object's metadata generation, reconciled condition  calculation for the current generation is still in progress.  See https://istio.io/latest/docs/reference/config/config-status/ for more info.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * Resource Generation to which the Reconciled Condition refers. When this value is not equal to the object's metadata generation, reconciled condition  calculation for the current generation is still in progress.  See https://istio.io/latest/docs/reference/config/config-status/ for more info.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Includes any errors or warnings detected by Istio's analyzers.
+     */
     @JsonProperty("validationMessages")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AnalysisMessageBase> getValidationMessages() {
         return validationMessages;
     }
 
+    /**
+     * Includes any errors or warnings detected by Istio's analyzers.
+     */
     @JsonProperty("validationMessages")
     public void setValidationMessages(List<AnalysisMessageBase> validationMessages) {
         this.validationMessages = validationMessages;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/CaptureMode.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/CaptureMode.java
index 47d2e6c2abc..64e37e79d89 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/CaptureMode.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/CaptureMode.java
@@ -4,6 +4,9 @@
 import javax.annotation.Generated;
 import com.fasterxml.jackson.annotation.JsonCreator;
 
+/**
+ * `CaptureMode` describes how traffic to a listener is expected to be captured. Applicable only when the listener is bound to an IP.
+ */
 @Generated("io.fabric8.kubernetes.schema.generator.model.ModelGenerator")
 public enum CaptureMode 
 {
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ClientTLSSettings.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ClientTLSSettings.java
index c25af147c8d..d425269404f 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ClientTLSSettings.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ClientTLSSettings.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SSL/TLS related settings for upstream connections. See Envoy's [TLS context](https://www.envoyproxy.io/docs/envoy/latest/api-v3/extensions/transport_sockets/tls/v3/common.proto.html#common-tls-configuration) for more details. These settings are common to both HTTP and TCP upstreams.<br><p> <br><p> For example, the following rule configures a client to use mutual TLS for connections to upstream database cluster.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: db-mtls<br><p> <br><p> spec:<br><p> <br><p> 	host: mydbserver.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  tls:<br><p> 	    mode: MUTUAL<br><p> 	    clientCertificate: /etc/certs/myclientcert.pem<br><p> 	    privateKey: /etc/certs/client_private_key.pem<br><p> 	    caCertificates: /etc/certs/rootcacerts.pem<br><p> <br><p> ```<br><p> <br><p> The following rule configures a client to use TLS when talking to a foreign service whose domain matches &#42;.foo.com.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: tls-foo<br><p> <br><p> spec:<br><p> <br><p> 	host: "&#42;.foo.com"<br><p> 	trafficPolicy:<br><p> 	  tls:<br><p> 	    mode: SIMPLE<br><p> <br><p> ```<br><p> <br><p> The following rule configures a client to use Istio mutual TLS when talking to rating services.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: ratings-istio-mtls<br><p> <br><p> spec:<br><p> <br><p> 	host: ratings.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  tls:<br><p> 	    mode: ISTIO_MUTUAL<br><p> <br><p> ```
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -113,92 +116,146 @@ public ClientTLSSettings(String caCertificates, String caCrl, String clientCerti
         this.subjectAltNames = subjectAltNames;
     }
 
+    /**
+     * OPTIONAL: The path to the file containing certificate authority certificates to use in verifying a presented server certificate. If omitted, the proxy will verify the server's certificate using the OS CA certificates. Should be empty if mode is `ISTIO_MUTUAL`.
+     */
     @JsonProperty("caCertificates")
     public String getCaCertificates() {
         return caCertificates;
     }
 
+    /**
+     * OPTIONAL: The path to the file containing certificate authority certificates to use in verifying a presented server certificate. If omitted, the proxy will verify the server's certificate using the OS CA certificates. Should be empty if mode is `ISTIO_MUTUAL`.
+     */
     @JsonProperty("caCertificates")
     public void setCaCertificates(String caCertificates) {
         this.caCertificates = caCertificates;
     }
 
+    /**
+     * OPTIONAL: The path to the file containing the certificate revocation list (CRL) to use in verifying a presented server certificate. `CRL` is a list of certificates that have been revoked by the CA (Certificate Authority) before their scheduled expiration date. If specified, the proxy will verify if the presented certificate is part of the revoked list of certificates. If omitted, the proxy will not verify the certificate against the `crl`. Note that if `credentialName` is set, `CRL` cannot be specified using `caCrl`, rather it has to be specified inside the credential.
+     */
     @JsonProperty("caCrl")
     public String getCaCrl() {
         return caCrl;
     }
 
+    /**
+     * OPTIONAL: The path to the file containing the certificate revocation list (CRL) to use in verifying a presented server certificate. `CRL` is a list of certificates that have been revoked by the CA (Certificate Authority) before their scheduled expiration date. If specified, the proxy will verify if the presented certificate is part of the revoked list of certificates. If omitted, the proxy will not verify the certificate against the `crl`. Note that if `credentialName` is set, `CRL` cannot be specified using `caCrl`, rather it has to be specified inside the credential.
+     */
     @JsonProperty("caCrl")
     public void setCaCrl(String caCrl) {
         this.caCrl = caCrl;
     }
 
+    /**
+     * REQUIRED if mode is `MUTUAL`. The path to the file holding the client-side TLS certificate to use. Should be empty if mode is `ISTIO_MUTUAL`.
+     */
     @JsonProperty("clientCertificate")
     public String getClientCertificate() {
         return clientCertificate;
     }
 
+    /**
+     * REQUIRED if mode is `MUTUAL`. The path to the file holding the client-side TLS certificate to use. Should be empty if mode is `ISTIO_MUTUAL`.
+     */
     @JsonProperty("clientCertificate")
     public void setClientCertificate(String clientCertificate) {
         this.clientCertificate = clientCertificate;
     }
 
+    /**
+     * The name of the secret that holds the TLS certs for the client including the CA certificates. This secret must exist in the namespace of the proxy using the certificates. An Opaque secret should contain the following keys and values: `key: &lt;privateKey&gt;`, `cert: &lt;clientCert&gt;`, `cacert: &lt;CACertificate&gt;`, `crl: &lt;certificateRevocationList&gt;` Here CACertificate is used to verify the server certificate. For mutual TLS, `cacert: &lt;CACertificate&gt;` can be provided in the same secret or a separate secret named `&lt;secret&gt;-cacert`. A TLS secret for client certificates with an additional `ca.crt` key for CA certificates and `ca.crl` key for certificate revocation list(CRL) is also supported. Only one of client certificates and CA certificate or credentialName can be specified.<br><p> <br><p> &#42;&#42;NOTE:&#42;&#42; This field is applicable at sidecars only if `DestinationRule` has a `workloadSelector` specified. Otherwise the field will be applicable only at gateways, and sidecars will continue to use the certificate paths.
+     */
     @JsonProperty("credentialName")
     public String getCredentialName() {
         return credentialName;
     }
 
+    /**
+     * The name of the secret that holds the TLS certs for the client including the CA certificates. This secret must exist in the namespace of the proxy using the certificates. An Opaque secret should contain the following keys and values: `key: &lt;privateKey&gt;`, `cert: &lt;clientCert&gt;`, `cacert: &lt;CACertificate&gt;`, `crl: &lt;certificateRevocationList&gt;` Here CACertificate is used to verify the server certificate. For mutual TLS, `cacert: &lt;CACertificate&gt;` can be provided in the same secret or a separate secret named `&lt;secret&gt;-cacert`. A TLS secret for client certificates with an additional `ca.crt` key for CA certificates and `ca.crl` key for certificate revocation list(CRL) is also supported. Only one of client certificates and CA certificate or credentialName can be specified.<br><p> <br><p> &#42;&#42;NOTE:&#42;&#42; This field is applicable at sidecars only if `DestinationRule` has a `workloadSelector` specified. Otherwise the field will be applicable only at gateways, and sidecars will continue to use the certificate paths.
+     */
     @JsonProperty("credentialName")
     public void setCredentialName(String credentialName) {
         this.credentialName = credentialName;
     }
 
+    /**
+     * SSL/TLS related settings for upstream connections. See Envoy's [TLS context](https://www.envoyproxy.io/docs/envoy/latest/api-v3/extensions/transport_sockets/tls/v3/common.proto.html#common-tls-configuration) for more details. These settings are common to both HTTP and TCP upstreams.<br><p> <br><p> For example, the following rule configures a client to use mutual TLS for connections to upstream database cluster.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: db-mtls<br><p> <br><p> spec:<br><p> <br><p> 	host: mydbserver.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  tls:<br><p> 	    mode: MUTUAL<br><p> 	    clientCertificate: /etc/certs/myclientcert.pem<br><p> 	    privateKey: /etc/certs/client_private_key.pem<br><p> 	    caCertificates: /etc/certs/rootcacerts.pem<br><p> <br><p> ```<br><p> <br><p> The following rule configures a client to use TLS when talking to a foreign service whose domain matches &#42;.foo.com.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: tls-foo<br><p> <br><p> spec:<br><p> <br><p> 	host: "&#42;.foo.com"<br><p> 	trafficPolicy:<br><p> 	  tls:<br><p> 	    mode: SIMPLE<br><p> <br><p> ```<br><p> <br><p> The following rule configures a client to use Istio mutual TLS when talking to rating services.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: ratings-istio-mtls<br><p> <br><p> spec:<br><p> <br><p> 	host: ratings.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  tls:<br><p> 	    mode: ISTIO_MUTUAL<br><p> <br><p> ```
+     */
     @JsonProperty("insecureSkipVerify")
     public Boolean getInsecureSkipVerify() {
         return insecureSkipVerify;
     }
 
+    /**
+     * SSL/TLS related settings for upstream connections. See Envoy's [TLS context](https://www.envoyproxy.io/docs/envoy/latest/api-v3/extensions/transport_sockets/tls/v3/common.proto.html#common-tls-configuration) for more details. These settings are common to both HTTP and TCP upstreams.<br><p> <br><p> For example, the following rule configures a client to use mutual TLS for connections to upstream database cluster.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: db-mtls<br><p> <br><p> spec:<br><p> <br><p> 	host: mydbserver.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  tls:<br><p> 	    mode: MUTUAL<br><p> 	    clientCertificate: /etc/certs/myclientcert.pem<br><p> 	    privateKey: /etc/certs/client_private_key.pem<br><p> 	    caCertificates: /etc/certs/rootcacerts.pem<br><p> <br><p> ```<br><p> <br><p> The following rule configures a client to use TLS when talking to a foreign service whose domain matches &#42;.foo.com.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: tls-foo<br><p> <br><p> spec:<br><p> <br><p> 	host: "&#42;.foo.com"<br><p> 	trafficPolicy:<br><p> 	  tls:<br><p> 	    mode: SIMPLE<br><p> <br><p> ```<br><p> <br><p> The following rule configures a client to use Istio mutual TLS when talking to rating services.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: ratings-istio-mtls<br><p> <br><p> spec:<br><p> <br><p> 	host: ratings.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  tls:<br><p> 	    mode: ISTIO_MUTUAL<br><p> <br><p> ```
+     */
     @JsonProperty("insecureSkipVerify")
     public void setInsecureSkipVerify(Boolean insecureSkipVerify) {
         this.insecureSkipVerify = insecureSkipVerify;
     }
 
+    /**
+     * SSL/TLS related settings for upstream connections. See Envoy's [TLS context](https://www.envoyproxy.io/docs/envoy/latest/api-v3/extensions/transport_sockets/tls/v3/common.proto.html#common-tls-configuration) for more details. These settings are common to both HTTP and TCP upstreams.<br><p> <br><p> For example, the following rule configures a client to use mutual TLS for connections to upstream database cluster.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: db-mtls<br><p> <br><p> spec:<br><p> <br><p> 	host: mydbserver.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  tls:<br><p> 	    mode: MUTUAL<br><p> 	    clientCertificate: /etc/certs/myclientcert.pem<br><p> 	    privateKey: /etc/certs/client_private_key.pem<br><p> 	    caCertificates: /etc/certs/rootcacerts.pem<br><p> <br><p> ```<br><p> <br><p> The following rule configures a client to use TLS when talking to a foreign service whose domain matches &#42;.foo.com.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: tls-foo<br><p> <br><p> spec:<br><p> <br><p> 	host: "&#42;.foo.com"<br><p> 	trafficPolicy:<br><p> 	  tls:<br><p> 	    mode: SIMPLE<br><p> <br><p> ```<br><p> <br><p> The following rule configures a client to use Istio mutual TLS when talking to rating services.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: ratings-istio-mtls<br><p> <br><p> spec:<br><p> <br><p> 	host: ratings.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  tls:<br><p> 	    mode: ISTIO_MUTUAL<br><p> <br><p> ```
+     */
     @JsonProperty("mode")
     public ClientTLSSettingsTLSmode getMode() {
         return mode;
     }
 
+    /**
+     * SSL/TLS related settings for upstream connections. See Envoy's [TLS context](https://www.envoyproxy.io/docs/envoy/latest/api-v3/extensions/transport_sockets/tls/v3/common.proto.html#common-tls-configuration) for more details. These settings are common to both HTTP and TCP upstreams.<br><p> <br><p> For example, the following rule configures a client to use mutual TLS for connections to upstream database cluster.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: db-mtls<br><p> <br><p> spec:<br><p> <br><p> 	host: mydbserver.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  tls:<br><p> 	    mode: MUTUAL<br><p> 	    clientCertificate: /etc/certs/myclientcert.pem<br><p> 	    privateKey: /etc/certs/client_private_key.pem<br><p> 	    caCertificates: /etc/certs/rootcacerts.pem<br><p> <br><p> ```<br><p> <br><p> The following rule configures a client to use TLS when talking to a foreign service whose domain matches &#42;.foo.com.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: tls-foo<br><p> <br><p> spec:<br><p> <br><p> 	host: "&#42;.foo.com"<br><p> 	trafficPolicy:<br><p> 	  tls:<br><p> 	    mode: SIMPLE<br><p> <br><p> ```<br><p> <br><p> The following rule configures a client to use Istio mutual TLS when talking to rating services.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: ratings-istio-mtls<br><p> <br><p> spec:<br><p> <br><p> 	host: ratings.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  tls:<br><p> 	    mode: ISTIO_MUTUAL<br><p> <br><p> ```
+     */
     @JsonProperty("mode")
     public void setMode(ClientTLSSettingsTLSmode mode) {
         this.mode = mode;
     }
 
+    /**
+     * REQUIRED if mode is `MUTUAL`. The path to the file holding the client's private key. Should be empty if mode is `ISTIO_MUTUAL`.
+     */
     @JsonProperty("privateKey")
     public String getPrivateKey() {
         return privateKey;
     }
 
+    /**
+     * REQUIRED if mode is `MUTUAL`. The path to the file holding the client's private key. Should be empty if mode is `ISTIO_MUTUAL`.
+     */
     @JsonProperty("privateKey")
     public void setPrivateKey(String privateKey) {
         this.privateKey = privateKey;
     }
 
+    /**
+     * SNI string to present to the server during TLS handshake. If unspecified, SNI will be automatically set based on downstream HTTP host/authority header for SIMPLE and MUTUAL TLS modes.
+     */
     @JsonProperty("sni")
     public String getSni() {
         return sni;
     }
 
+    /**
+     * SNI string to present to the server during TLS handshake. If unspecified, SNI will be automatically set based on downstream HTTP host/authority header for SIMPLE and MUTUAL TLS modes.
+     */
     @JsonProperty("sni")
     public void setSni(String sni) {
         this.sni = sni;
     }
 
+    /**
+     * A list of alternate names to verify the subject identity in the certificate. If specified, the proxy will verify that the server certificate's subject alt name matches one of the specified values. If specified, this list overrides the value of subject_alt_names from the ServiceEntry. If unspecified, automatic validation of upstream presented certificate for new upstream connections will be done based on the downstream HTTP host/authority header.
+     */
     @JsonProperty("subjectAltNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSubjectAltNames() {
         return subjectAltNames;
     }
 
+    /**
+     * A list of alternate names to verify the subject identity in the certificate. If specified, the proxy will verify that the server certificate's subject alt name matches one of the specified values. If specified, this list overrides the value of subject_alt_names from the ServiceEntry. If unspecified, automatic validation of upstream presented certificate for new upstream connections will be done based on the downstream HTTP host/authority header.
+     */
     @JsonProperty("subjectAltNames")
     public void setSubjectAltNames(List<String> subjectAltNames) {
         this.subjectAltNames = subjectAltNames;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ClientTLSSettingsTLSmode.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ClientTLSSettingsTLSmode.java
index aad4fe21db6..e4cba94b344 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ClientTLSSettingsTLSmode.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ClientTLSSettingsTLSmode.java
@@ -4,6 +4,9 @@
 import javax.annotation.Generated;
 import com.fasterxml.jackson.annotation.JsonCreator;
 
+/**
+ * TLS connection mode
+ */
 @Generated("io.fabric8.kubernetes.schema.generator.model.ModelGenerator")
 public enum ClientTLSSettingsTLSmode 
 {
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ConnectionPoolSettings.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ConnectionPoolSettings.java
index 847025e5b27..f031284a4cc 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ConnectionPoolSettings.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ConnectionPoolSettings.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Connection pool settings for an upstream host. The settings apply to each individual host in the upstream service.  See Envoy's [circuit breaker](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/circuit_breaking) for more details. Connection pool settings can be applied at the TCP level as well as at HTTP level.<br><p> <br><p> For example, the following rule sets a limit of 100 connections to redis service called myredissrv with a connect timeout of 30ms<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: bookinfo-redis<br><p> <br><p> spec:<br><p> <br><p> 	host: myredissrv.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  connectionPool:<br><p> 	    tcp:<br><p> 	      maxConnections: 100<br><p> 	      connectTimeout: 30ms<br><p> 	      tcpKeepalive:<br><p> 	        time: 7200s<br><p> 	        interval: 75s<br><p> <br><p> ```
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ConnectionPoolSettings(ConnectionPoolSettingsHTTPSettings http, Connectio
         this.tcp = tcp;
     }
 
+    /**
+     * Connection pool settings for an upstream host. The settings apply to each individual host in the upstream service.  See Envoy's [circuit breaker](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/circuit_breaking) for more details. Connection pool settings can be applied at the TCP level as well as at HTTP level.<br><p> <br><p> For example, the following rule sets a limit of 100 connections to redis service called myredissrv with a connect timeout of 30ms<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: bookinfo-redis<br><p> <br><p> spec:<br><p> <br><p> 	host: myredissrv.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  connectionPool:<br><p> 	    tcp:<br><p> 	      maxConnections: 100<br><p> 	      connectTimeout: 30ms<br><p> 	      tcpKeepalive:<br><p> 	        time: 7200s<br><p> 	        interval: 75s<br><p> <br><p> ```
+     */
     @JsonProperty("http")
     public ConnectionPoolSettingsHTTPSettings getHttp() {
         return http;
     }
 
+    /**
+     * Connection pool settings for an upstream host. The settings apply to each individual host in the upstream service.  See Envoy's [circuit breaker](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/circuit_breaking) for more details. Connection pool settings can be applied at the TCP level as well as at HTTP level.<br><p> <br><p> For example, the following rule sets a limit of 100 connections to redis service called myredissrv with a connect timeout of 30ms<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: bookinfo-redis<br><p> <br><p> spec:<br><p> <br><p> 	host: myredissrv.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  connectionPool:<br><p> 	    tcp:<br><p> 	      maxConnections: 100<br><p> 	      connectTimeout: 30ms<br><p> 	      tcpKeepalive:<br><p> 	        time: 7200s<br><p> 	        interval: 75s<br><p> <br><p> ```
+     */
     @JsonProperty("http")
     public void setHttp(ConnectionPoolSettingsHTTPSettings http) {
         this.http = http;
     }
 
+    /**
+     * Connection pool settings for an upstream host. The settings apply to each individual host in the upstream service.  See Envoy's [circuit breaker](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/circuit_breaking) for more details. Connection pool settings can be applied at the TCP level as well as at HTTP level.<br><p> <br><p> For example, the following rule sets a limit of 100 connections to redis service called myredissrv with a connect timeout of 30ms<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: bookinfo-redis<br><p> <br><p> spec:<br><p> <br><p> 	host: myredissrv.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  connectionPool:<br><p> 	    tcp:<br><p> 	      maxConnections: 100<br><p> 	      connectTimeout: 30ms<br><p> 	      tcpKeepalive:<br><p> 	        time: 7200s<br><p> 	        interval: 75s<br><p> <br><p> ```
+     */
     @JsonProperty("tcp")
     public ConnectionPoolSettingsTCPSettings getTcp() {
         return tcp;
     }
 
+    /**
+     * Connection pool settings for an upstream host. The settings apply to each individual host in the upstream service.  See Envoy's [circuit breaker](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/circuit_breaking) for more details. Connection pool settings can be applied at the TCP level as well as at HTTP level.<br><p> <br><p> For example, the following rule sets a limit of 100 connections to redis service called myredissrv with a connect timeout of 30ms<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: bookinfo-redis<br><p> <br><p> spec:<br><p> <br><p> 	host: myredissrv.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  connectionPool:<br><p> 	    tcp:<br><p> 	      maxConnections: 100<br><p> 	      connectTimeout: 30ms<br><p> 	      tcpKeepalive:<br><p> 	        time: 7200s<br><p> 	        interval: 75s<br><p> <br><p> ```
+     */
     @JsonProperty("tcp")
     public void setTcp(ConnectionPoolSettingsTCPSettings tcp) {
         this.tcp = tcp;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ConnectionPoolSettingsHTTPSettings.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ConnectionPoolSettingsHTTPSettings.java
index 9433dd3ba86..23a1f008e9d 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ConnectionPoolSettingsHTTPSettings.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ConnectionPoolSettingsHTTPSettings.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Settings applicable to HTTP1.1/HTTP2/GRPC connections.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -106,81 +109,129 @@ public ConnectionPoolSettingsHTTPSettings(ConnectionPoolSettingsHTTPSettingsH2Up
         this.useClientProtocol = useClientProtocol;
     }
 
+    /**
+     * Settings applicable to HTTP1.1/HTTP2/GRPC connections.
+     */
     @JsonProperty("h2UpgradePolicy")
     public ConnectionPoolSettingsHTTPSettingsH2UpgradePolicy getH2UpgradePolicy() {
         return h2UpgradePolicy;
     }
 
+    /**
+     * Settings applicable to HTTP1.1/HTTP2/GRPC connections.
+     */
     @JsonProperty("h2UpgradePolicy")
     public void setH2UpgradePolicy(ConnectionPoolSettingsHTTPSettingsH2UpgradePolicy h2UpgradePolicy) {
         this.h2UpgradePolicy = h2UpgradePolicy;
     }
 
+    /**
+     * Maximum number of requests that will be queued while waiting for a ready connection pool connection. Default 2^32-1. Refer to https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/circuit_breaking under which conditions a new connection is created for HTTP2. Please note that this is applicable to both HTTP/1.1 and HTTP2.
+     */
     @JsonProperty("http1MaxPendingRequests")
     public Integer getHttp1MaxPendingRequests() {
         return http1MaxPendingRequests;
     }
 
+    /**
+     * Maximum number of requests that will be queued while waiting for a ready connection pool connection. Default 2^32-1. Refer to https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/circuit_breaking under which conditions a new connection is created for HTTP2. Please note that this is applicable to both HTTP/1.1 and HTTP2.
+     */
     @JsonProperty("http1MaxPendingRequests")
     public void setHttp1MaxPendingRequests(Integer http1MaxPendingRequests) {
         this.http1MaxPendingRequests = http1MaxPendingRequests;
     }
 
+    /**
+     * Maximum number of active requests to a destination. Default 2^32-1. Please note that this is applicable to both HTTP/1.1 and HTTP2.
+     */
     @JsonProperty("http2MaxRequests")
     public Integer getHttp2MaxRequests() {
         return http2MaxRequests;
     }
 
+    /**
+     * Maximum number of active requests to a destination. Default 2^32-1. Please note that this is applicable to both HTTP/1.1 and HTTP2.
+     */
     @JsonProperty("http2MaxRequests")
     public void setHttp2MaxRequests(Integer http2MaxRequests) {
         this.http2MaxRequests = http2MaxRequests;
     }
 
+    /**
+     * Settings applicable to HTTP1.1/HTTP2/GRPC connections.
+     */
     @JsonProperty("idleTimeout")
     public String getIdleTimeout() {
         return idleTimeout;
     }
 
+    /**
+     * Settings applicable to HTTP1.1/HTTP2/GRPC connections.
+     */
     @JsonProperty("idleTimeout")
     public void setIdleTimeout(String idleTimeout) {
         this.idleTimeout = idleTimeout;
     }
 
+    /**
+     * The maximum number of concurrent streams allowed for a peer on one HTTP/2 connection. Defaults to 2^31-1.
+     */
     @JsonProperty("maxConcurrentStreams")
     public Integer getMaxConcurrentStreams() {
         return maxConcurrentStreams;
     }
 
+    /**
+     * The maximum number of concurrent streams allowed for a peer on one HTTP/2 connection. Defaults to 2^31-1.
+     */
     @JsonProperty("maxConcurrentStreams")
     public void setMaxConcurrentStreams(Integer maxConcurrentStreams) {
         this.maxConcurrentStreams = maxConcurrentStreams;
     }
 
+    /**
+     * Maximum number of requests per connection to a backend. Setting this parameter to 1 disables keep alive. Default 0, meaning "unlimited", up to 2^29.
+     */
     @JsonProperty("maxRequestsPerConnection")
     public Integer getMaxRequestsPerConnection() {
         return maxRequestsPerConnection;
     }
 
+    /**
+     * Maximum number of requests per connection to a backend. Setting this parameter to 1 disables keep alive. Default 0, meaning "unlimited", up to 2^29.
+     */
     @JsonProperty("maxRequestsPerConnection")
     public void setMaxRequestsPerConnection(Integer maxRequestsPerConnection) {
         this.maxRequestsPerConnection = maxRequestsPerConnection;
     }
 
+    /**
+     * Maximum number of retries that can be outstanding to all hosts in a cluster at a given time. Defaults to 2^32-1.
+     */
     @JsonProperty("maxRetries")
     public Integer getMaxRetries() {
         return maxRetries;
     }
 
+    /**
+     * Maximum number of retries that can be outstanding to all hosts in a cluster at a given time. Defaults to 2^32-1.
+     */
     @JsonProperty("maxRetries")
     public void setMaxRetries(Integer maxRetries) {
         this.maxRetries = maxRetries;
     }
 
+    /**
+     * If set to true, client protocol will be preserved while initiating connection to backend. Note that when this is set to true, h2_upgrade_policy will be ineffective i.e. the client connections will not be upgraded to http2.
+     */
     @JsonProperty("useClientProtocol")
     public Boolean getUseClientProtocol() {
         return useClientProtocol;
     }
 
+    /**
+     * If set to true, client protocol will be preserved while initiating connection to backend. Note that when this is set to true, h2_upgrade_policy will be ineffective i.e. the client connections will not be upgraded to http2.
+     */
     @JsonProperty("useClientProtocol")
     public void setUseClientProtocol(Boolean useClientProtocol) {
         this.useClientProtocol = useClientProtocol;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ConnectionPoolSettingsHTTPSettingsH2UpgradePolicy.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ConnectionPoolSettingsHTTPSettingsH2UpgradePolicy.java
index 8b43e6af23c..83babd5d314 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ConnectionPoolSettingsHTTPSettingsH2UpgradePolicy.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ConnectionPoolSettingsHTTPSettingsH2UpgradePolicy.java
@@ -4,6 +4,9 @@
 import javax.annotation.Generated;
 import com.fasterxml.jackson.annotation.JsonCreator;
 
+/**
+ * Policy for upgrading http1.1 connections to http2.
+ */
 @Generated("io.fabric8.kubernetes.schema.generator.model.ModelGenerator")
 public enum ConnectionPoolSettingsHTTPSettingsH2UpgradePolicy 
 {
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ConnectionPoolSettingsTCPSettings.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ConnectionPoolSettingsTCPSettings.java
index 3b5e4cb30ec..0e36cb77b00 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ConnectionPoolSettingsTCPSettings.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ConnectionPoolSettingsTCPSettings.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Settings common to both HTTP and TCP upstream connections.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public ConnectionPoolSettingsTCPSettings(String connectTimeout, String idleTimeo
         this.tcpKeepalive = tcpKeepalive;
     }
 
+    /**
+     * Settings common to both HTTP and TCP upstream connections.
+     */
     @JsonProperty("connectTimeout")
     public String getConnectTimeout() {
         return connectTimeout;
     }
 
+    /**
+     * Settings common to both HTTP and TCP upstream connections.
+     */
     @JsonProperty("connectTimeout")
     public void setConnectTimeout(String connectTimeout) {
         this.connectTimeout = connectTimeout;
     }
 
+    /**
+     * Settings common to both HTTP and TCP upstream connections.
+     */
     @JsonProperty("idleTimeout")
     public String getIdleTimeout() {
         return idleTimeout;
     }
 
+    /**
+     * Settings common to both HTTP and TCP upstream connections.
+     */
     @JsonProperty("idleTimeout")
     public void setIdleTimeout(String idleTimeout) {
         this.idleTimeout = idleTimeout;
     }
 
+    /**
+     * Settings common to both HTTP and TCP upstream connections.
+     */
     @JsonProperty("maxConnectionDuration")
     public String getMaxConnectionDuration() {
         return maxConnectionDuration;
     }
 
+    /**
+     * Settings common to both HTTP and TCP upstream connections.
+     */
     @JsonProperty("maxConnectionDuration")
     public void setMaxConnectionDuration(String maxConnectionDuration) {
         this.maxConnectionDuration = maxConnectionDuration;
     }
 
+    /**
+     * Maximum number of HTTP1 /TCP connections to a destination host. Default 2^32-1.
+     */
     @JsonProperty("maxConnections")
     public Integer getMaxConnections() {
         return maxConnections;
     }
 
+    /**
+     * Maximum number of HTTP1 /TCP connections to a destination host. Default 2^32-1.
+     */
     @JsonProperty("maxConnections")
     public void setMaxConnections(Integer maxConnections) {
         this.maxConnections = maxConnections;
     }
 
+    /**
+     * Settings common to both HTTP and TCP upstream connections.
+     */
     @JsonProperty("tcpKeepalive")
     public ConnectionPoolSettingsTCPSettingsTcpKeepalive getTcpKeepalive() {
         return tcpKeepalive;
     }
 
+    /**
+     * Settings common to both HTTP and TCP upstream connections.
+     */
     @JsonProperty("tcpKeepalive")
     public void setTcpKeepalive(ConnectionPoolSettingsTCPSettingsTcpKeepalive tcpKeepalive) {
         this.tcpKeepalive = tcpKeepalive;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ConnectionPoolSettingsTCPSettingsTcpKeepalive.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ConnectionPoolSettingsTCPSettingsTcpKeepalive.java
index bb49c1c7a3d..53064290d76 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ConnectionPoolSettingsTCPSettingsTcpKeepalive.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ConnectionPoolSettingsTCPSettingsTcpKeepalive.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TCP keepalive.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ConnectionPoolSettingsTCPSettingsTcpKeepalive(String interval, Long probe
         this.time = time;
     }
 
+    /**
+     * TCP keepalive.
+     */
     @JsonProperty("interval")
     public String getInterval() {
         return interval;
     }
 
+    /**
+     * TCP keepalive.
+     */
     @JsonProperty("interval")
     public void setInterval(String interval) {
         this.interval = interval;
     }
 
+    /**
+     * Maximum number of keepalive probes to send without response before deciding the connection is dead. Default is to use the OS level configuration (unless overridden, Linux defaults to 9.)
+     */
     @JsonProperty("probes")
     public Long getProbes() {
         return probes;
     }
 
+    /**
+     * Maximum number of keepalive probes to send without response before deciding the connection is dead. Default is to use the OS level configuration (unless overridden, Linux defaults to 9.)
+     */
     @JsonProperty("probes")
     public void setProbes(Long probes) {
         this.probes = probes;
     }
 
+    /**
+     * TCP keepalive.
+     */
     @JsonProperty("time")
     public String getTime() {
         return time;
     }
 
+    /**
+     * TCP keepalive.
+     */
     @JsonProperty("time")
     public void setTime(String time) {
         this.time = time;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/CorsPolicy.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/CorsPolicy.java
index dbce13c73c0..4b396d89a40 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/CorsPolicy.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/CorsPolicy.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Describes the Cross-Origin Resource Sharing (CORS) policy, for a given service. Refer to [CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/Access_control_CORS) for further details about cross origin resource sharing. For example, the following rule restricts cross origin requests to those originating from example.com domain using HTTP POST/GET, and sets the `Access-Control-Allow-Credentials` header to false. In addition, it only exposes `X-Foo-bar` header and sets an expiry period of 1 day.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	  corsPolicy:<br><p> 	    allowOrigins:<br><p> 	    - exact: https://example.com<br><p> 	    allowMethods:<br><p> 	    - POST<br><p> 	    - GET<br><p> 	    allowCredentials: false<br><p> 	    allowHeaders:<br><p> 	    - X-Foo-Bar<br><p> 	    maxAge: "24h"<br><p> <br><p> ```
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -113,86 +116,134 @@ public CorsPolicy(Boolean allowCredentials, List<String> allowHeaders, List<Stri
         this.unmatchedPreflights = unmatchedPreflights;
     }
 
+    /**
+     * Describes the Cross-Origin Resource Sharing (CORS) policy, for a given service. Refer to [CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/Access_control_CORS) for further details about cross origin resource sharing. For example, the following rule restricts cross origin requests to those originating from example.com domain using HTTP POST/GET, and sets the `Access-Control-Allow-Credentials` header to false. In addition, it only exposes `X-Foo-bar` header and sets an expiry period of 1 day.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	  corsPolicy:<br><p> 	    allowOrigins:<br><p> 	    - exact: https://example.com<br><p> 	    allowMethods:<br><p> 	    - POST<br><p> 	    - GET<br><p> 	    allowCredentials: false<br><p> 	    allowHeaders:<br><p> 	    - X-Foo-Bar<br><p> 	    maxAge: "24h"<br><p> <br><p> ```
+     */
     @JsonProperty("allowCredentials")
     public Boolean getAllowCredentials() {
         return allowCredentials;
     }
 
+    /**
+     * Describes the Cross-Origin Resource Sharing (CORS) policy, for a given service. Refer to [CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/Access_control_CORS) for further details about cross origin resource sharing. For example, the following rule restricts cross origin requests to those originating from example.com domain using HTTP POST/GET, and sets the `Access-Control-Allow-Credentials` header to false. In addition, it only exposes `X-Foo-bar` header and sets an expiry period of 1 day.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	  corsPolicy:<br><p> 	    allowOrigins:<br><p> 	    - exact: https://example.com<br><p> 	    allowMethods:<br><p> 	    - POST<br><p> 	    - GET<br><p> 	    allowCredentials: false<br><p> 	    allowHeaders:<br><p> 	    - X-Foo-Bar<br><p> 	    maxAge: "24h"<br><p> <br><p> ```
+     */
     @JsonProperty("allowCredentials")
     public void setAllowCredentials(Boolean allowCredentials) {
         this.allowCredentials = allowCredentials;
     }
 
+    /**
+     * List of HTTP headers that can be used when requesting the resource. Serialized to Access-Control-Allow-Headers header.
+     */
     @JsonProperty("allowHeaders")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAllowHeaders() {
         return allowHeaders;
     }
 
+    /**
+     * List of HTTP headers that can be used when requesting the resource. Serialized to Access-Control-Allow-Headers header.
+     */
     @JsonProperty("allowHeaders")
     public void setAllowHeaders(List<String> allowHeaders) {
         this.allowHeaders = allowHeaders;
     }
 
+    /**
+     * List of HTTP methods allowed to access the resource. The content will be serialized into the Access-Control-Allow-Methods header.
+     */
     @JsonProperty("allowMethods")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAllowMethods() {
         return allowMethods;
     }
 
+    /**
+     * List of HTTP methods allowed to access the resource. The content will be serialized into the Access-Control-Allow-Methods header.
+     */
     @JsonProperty("allowMethods")
     public void setAllowMethods(List<String> allowMethods) {
         this.allowMethods = allowMethods;
     }
 
+    /**
+     * The list of origins that are allowed to perform CORS requests. The content will be serialized into the Access-Control-Allow-Origin header. Wildcard &#42; will allow all origins. $hide_from_docs<br><p> <br><p> Deprecated: Marked as deprecated in networking/v1alpha3/virtual_service.proto.
+     */
     @JsonProperty("allowOrigin")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAllowOrigin() {
         return deprecatedAllowOrigin;
     }
 
+    /**
+     * The list of origins that are allowed to perform CORS requests. The content will be serialized into the Access-Control-Allow-Origin header. Wildcard &#42; will allow all origins. $hide_from_docs<br><p> <br><p> Deprecated: Marked as deprecated in networking/v1alpha3/virtual_service.proto.
+     */
     @JsonProperty("allowOrigin")
     public void setAllowOrigin(List<String> deprecatedAllowOrigin) {
         this.deprecatedAllowOrigin = deprecatedAllowOrigin;
     }
 
+    /**
+     * String patterns that match allowed origins. An origin is allowed if any of the string matchers match. If a match is found, then the outgoing Access-Control-Allow-Origin would be set to the origin as provided by the client.
+     */
     @JsonProperty("allowOrigins")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<StringMatch> getAllowOrigins() {
         return allowOrigins;
     }
 
+    /**
+     * String patterns that match allowed origins. An origin is allowed if any of the string matchers match. If a match is found, then the outgoing Access-Control-Allow-Origin would be set to the origin as provided by the client.
+     */
     @JsonProperty("allowOrigins")
     public void setAllowOrigins(List<StringMatch> allowOrigins) {
         this.allowOrigins = allowOrigins;
     }
 
+    /**
+     * A list of HTTP headers that the browsers are allowed to access. Serialized into Access-Control-Expose-Headers header.
+     */
     @JsonProperty("exposeHeaders")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getExposeHeaders() {
         return exposeHeaders;
     }
 
+    /**
+     * A list of HTTP headers that the browsers are allowed to access. Serialized into Access-Control-Expose-Headers header.
+     */
     @JsonProperty("exposeHeaders")
     public void setExposeHeaders(List<String> exposeHeaders) {
         this.exposeHeaders = exposeHeaders;
     }
 
+    /**
+     * Describes the Cross-Origin Resource Sharing (CORS) policy, for a given service. Refer to [CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/Access_control_CORS) for further details about cross origin resource sharing. For example, the following rule restricts cross origin requests to those originating from example.com domain using HTTP POST/GET, and sets the `Access-Control-Allow-Credentials` header to false. In addition, it only exposes `X-Foo-bar` header and sets an expiry period of 1 day.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	  corsPolicy:<br><p> 	    allowOrigins:<br><p> 	    - exact: https://example.com<br><p> 	    allowMethods:<br><p> 	    - POST<br><p> 	    - GET<br><p> 	    allowCredentials: false<br><p> 	    allowHeaders:<br><p> 	    - X-Foo-Bar<br><p> 	    maxAge: "24h"<br><p> <br><p> ```
+     */
     @JsonProperty("maxAge")
     public String getMaxAge() {
         return maxAge;
     }
 
+    /**
+     * Describes the Cross-Origin Resource Sharing (CORS) policy, for a given service. Refer to [CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/Access_control_CORS) for further details about cross origin resource sharing. For example, the following rule restricts cross origin requests to those originating from example.com domain using HTTP POST/GET, and sets the `Access-Control-Allow-Credentials` header to false. In addition, it only exposes `X-Foo-bar` header and sets an expiry period of 1 day.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	  corsPolicy:<br><p> 	    allowOrigins:<br><p> 	    - exact: https://example.com<br><p> 	    allowMethods:<br><p> 	    - POST<br><p> 	    - GET<br><p> 	    allowCredentials: false<br><p> 	    allowHeaders:<br><p> 	    - X-Foo-Bar<br><p> 	    maxAge: "24h"<br><p> <br><p> ```
+     */
     @JsonProperty("maxAge")
     public void setMaxAge(String maxAge) {
         this.maxAge = maxAge;
     }
 
+    /**
+     * Describes the Cross-Origin Resource Sharing (CORS) policy, for a given service. Refer to [CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/Access_control_CORS) for further details about cross origin resource sharing. For example, the following rule restricts cross origin requests to those originating from example.com domain using HTTP POST/GET, and sets the `Access-Control-Allow-Credentials` header to false. In addition, it only exposes `X-Foo-bar` header and sets an expiry period of 1 day.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	  corsPolicy:<br><p> 	    allowOrigins:<br><p> 	    - exact: https://example.com<br><p> 	    allowMethods:<br><p> 	    - POST<br><p> 	    - GET<br><p> 	    allowCredentials: false<br><p> 	    allowHeaders:<br><p> 	    - X-Foo-Bar<br><p> 	    maxAge: "24h"<br><p> <br><p> ```
+     */
     @JsonProperty("unmatchedPreflights")
     public CorsPolicyUnmatchedPreflights getUnmatchedPreflights() {
         return unmatchedPreflights;
     }
 
+    /**
+     * Describes the Cross-Origin Resource Sharing (CORS) policy, for a given service. Refer to [CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/Access_control_CORS) for further details about cross origin resource sharing. For example, the following rule restricts cross origin requests to those originating from example.com domain using HTTP POST/GET, and sets the `Access-Control-Allow-Credentials` header to false. In addition, it only exposes `X-Foo-bar` header and sets an expiry period of 1 day.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	  corsPolicy:<br><p> 	    allowOrigins:<br><p> 	    - exact: https://example.com<br><p> 	    allowMethods:<br><p> 	    - POST<br><p> 	    - GET<br><p> 	    allowCredentials: false<br><p> 	    allowHeaders:<br><p> 	    - X-Foo-Bar<br><p> 	    maxAge: "24h"<br><p> <br><p> ```
+     */
     @JsonProperty("unmatchedPreflights")
     public void setUnmatchedPreflights(CorsPolicyUnmatchedPreflights unmatchedPreflights) {
         this.unmatchedPreflights = unmatchedPreflights;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Delegate.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Delegate.java
index 3bd773d3723..7be7947d740 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Delegate.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Delegate.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Describes the delegate VirtualService. The following routing rules forward the traffic to `/productpage` by a delegate VirtualService named `productpage`, forward the traffic to `/reviews` by a delegate VirtualService named `reviews`.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: bookinfo<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- "bookinfo.com"<br><p> 	gateways:<br><p> 	- mygateway<br><p> 	http:<br><p> 	- match:<br><p> 	  - uri:<br><p> 	      prefix: "/productpage"<br><p> 	  delegate:<br><p> 	     name: productpage<br><p> 	     namespace: nsA<br><p> 	- match:<br><p> 	  - uri:<br><p> 	      prefix: "/reviews"<br><p> 	  delegate:<br><p> 	      name: reviews<br><p> 	      namespace: nsB<br><p> <br><p> ```<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: productpage<br><p> 	namespace: nsA<br><p> <br><p> spec:<br><p> <br><p> 	http:<br><p> 	- match:<br><p> 	   - uri:<br><p> 	      prefix: "/productpage/v1/"<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: productpage-v1.nsA.svc.cluster.local<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: productpage.nsA.svc.cluster.local<br><p> <br><p> ```<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: reviews<br><p> 	namespace: nsB<br><p> <br><p> spec:<br><p> <br><p> 	http:<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: reviews.nsB.svc.cluster.local<br><p> <br><p> ```
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Delegate(String name, String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Name specifies the name of the delegate VirtualService.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name specifies the name of the delegate VirtualService.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace specifies the namespace where the delegate VirtualService resides. By default, it is same to the root's.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace specifies the namespace where the delegate VirtualService resides. By default, it is same to the root's.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Destination.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Destination.java
index 1e802bbb9cc..c296a28a5db 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Destination.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Destination.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Destination indicates the network addressable service to which the request/connection will be sent after processing a routing rule. The destination.host should unambiguously refer to a service in the service registry. Istio's service registry is composed of all the services found in the platform's service registry (e.g., Kubernetes services, Consul services), as well as services declared through the [ServiceEntry](https://istio.io/docs/reference/config/networking/service-entry/#ServiceEntry) resource.<br><p> <br><p> &#42;Note for Kubernetes users&#42;: When short names are used (e.g. "reviews" instead of "reviews.default.svc.cluster.local"), Istio will interpret the short name based on the namespace of the rule, not the service. A rule in the "default" namespace containing a host "reviews" will be interpreted as "reviews.default.svc.cluster.local", irrespective of the actual namespace associated with the reviews service. _To avoid potential misconfigurations, it is recommended to always use fully qualified domain names over short names._<br><p> <br><p> The following Kubernetes example routes all traffic by default to pods of the reviews service with label "version: v1" (i.e., subset v1), and some to subset v2, in a Kubernetes environment.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: reviews-route<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- reviews # interpreted as reviews.foo.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - uri:<br><p> 	      prefix: "/wpcatalog"<br><p> 	  - uri:<br><p> 	      prefix: "/consumercatalog"<br><p> 	  rewrite:<br><p> 	    uri: "/newcatalog"<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: reviews # interpreted as reviews.foo.svc.cluster.local<br><p> 	      subset: v2<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: reviews # interpreted as reviews.foo.svc.cluster.local<br><p> 	      subset: v1<br><p> <br><p> ```<br><p> <br><p> # And the associated DestinationRule<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: reviews-destination<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	host: reviews # interpreted as reviews.foo.svc.cluster.local<br><p> 	subsets:<br><p> 	- name: v1<br><p> 	  labels:<br><p> 	    version: v1<br><p> 	- name: v2<br><p> 	  labels:<br><p> 	    version: v2<br><p> <br><p> ```<br><p> <br><p> The following VirtualService sets a timeout of 5s for all calls to productpage.prod.svc.cluster.local service in Kubernetes. Notice that there are no subsets defined in this rule. Istio will fetch all instances of productpage.prod.svc.cluster.local service from the service registry and populate the sidecar's load balancing pool. Also, notice that this rule is set in the istio-system namespace but uses the fully qualified domain name of the productpage service, productpage.prod.svc.cluster.local. Therefore the rule's namespace does not have an impact in resolving the name of the productpage service.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: my-productpage-rule<br><p> 	namespace: istio-system<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- productpage.prod.svc.cluster.local # ignores rule namespace<br><p> 	http:<br><p> 	- timeout: 5s<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: productpage.prod.svc.cluster.local<br><p> <br><p> ```<br><p> <br><p> To control routing for traffic bound to services outside the mesh, external services must first be added to Istio's internal service registry using the ServiceEntry resource. VirtualServices can then be defined to control traffic bound to these external services. For example, the following rules define a Service for wikipedia.org and set a timeout of 5s for HTTP requests.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: ServiceEntry metadata:<br><p> <br><p> 	name: external-svc-wikipedia<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- wikipedia.org<br><p> 	location: MESH_EXTERNAL<br><p> 	ports:<br><p> 	- number: 80<br><p> 	  name: example-http<br><p> 	  protocol: HTTP<br><p> 	resolution: DNS
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public Destination(String host, PortSelector port, String subset) {
         this.subset = subset;
     }
 
+    /**
+     * The name of a service from the service registry. Service names are looked up from the platform's service registry (e.g., Kubernetes services, Consul services, etc.) and from the hosts declared by [ServiceEntry](https://istio.io/docs/reference/config/networking/service-entry/#ServiceEntry). Traffic forwarded to destinations that are not found in either of the two, will be dropped.<br><p> <br><p> &#42;Note for Kubernetes users&#42;: When short names are used (e.g. "reviews" instead of "reviews.default.svc.cluster.local"), Istio will interpret the short name based on the namespace of the rule, not the service. A rule in the "default" namespace containing a host "reviews" will be interpreted as "reviews.default.svc.cluster.local", irrespective of the actual namespace associated with the reviews service. To avoid potential misconfiguration, it is recommended to always use fully qualified domain names over short names.
+     */
     @JsonProperty("host")
     public String getHost() {
         return host;
     }
 
+    /**
+     * The name of a service from the service registry. Service names are looked up from the platform's service registry (e.g., Kubernetes services, Consul services, etc.) and from the hosts declared by [ServiceEntry](https://istio.io/docs/reference/config/networking/service-entry/#ServiceEntry). Traffic forwarded to destinations that are not found in either of the two, will be dropped.<br><p> <br><p> &#42;Note for Kubernetes users&#42;: When short names are used (e.g. "reviews" instead of "reviews.default.svc.cluster.local"), Istio will interpret the short name based on the namespace of the rule, not the service. A rule in the "default" namespace containing a host "reviews" will be interpreted as "reviews.default.svc.cluster.local", irrespective of the actual namespace associated with the reviews service. To avoid potential misconfiguration, it is recommended to always use fully qualified domain names over short names.
+     */
     @JsonProperty("host")
     public void setHost(String host) {
         this.host = host;
     }
 
+    /**
+     * Destination indicates the network addressable service to which the request/connection will be sent after processing a routing rule. The destination.host should unambiguously refer to a service in the service registry. Istio's service registry is composed of all the services found in the platform's service registry (e.g., Kubernetes services, Consul services), as well as services declared through the [ServiceEntry](https://istio.io/docs/reference/config/networking/service-entry/#ServiceEntry) resource.<br><p> <br><p> &#42;Note for Kubernetes users&#42;: When short names are used (e.g. "reviews" instead of "reviews.default.svc.cluster.local"), Istio will interpret the short name based on the namespace of the rule, not the service. A rule in the "default" namespace containing a host "reviews" will be interpreted as "reviews.default.svc.cluster.local", irrespective of the actual namespace associated with the reviews service. _To avoid potential misconfigurations, it is recommended to always use fully qualified domain names over short names._<br><p> <br><p> The following Kubernetes example routes all traffic by default to pods of the reviews service with label "version: v1" (i.e., subset v1), and some to subset v2, in a Kubernetes environment.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: reviews-route<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- reviews # interpreted as reviews.foo.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - uri:<br><p> 	      prefix: "/wpcatalog"<br><p> 	  - uri:<br><p> 	      prefix: "/consumercatalog"<br><p> 	  rewrite:<br><p> 	    uri: "/newcatalog"<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: reviews # interpreted as reviews.foo.svc.cluster.local<br><p> 	      subset: v2<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: reviews # interpreted as reviews.foo.svc.cluster.local<br><p> 	      subset: v1<br><p> <br><p> ```<br><p> <br><p> # And the associated DestinationRule<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: reviews-destination<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	host: reviews # interpreted as reviews.foo.svc.cluster.local<br><p> 	subsets:<br><p> 	- name: v1<br><p> 	  labels:<br><p> 	    version: v1<br><p> 	- name: v2<br><p> 	  labels:<br><p> 	    version: v2<br><p> <br><p> ```<br><p> <br><p> The following VirtualService sets a timeout of 5s for all calls to productpage.prod.svc.cluster.local service in Kubernetes. Notice that there are no subsets defined in this rule. Istio will fetch all instances of productpage.prod.svc.cluster.local service from the service registry and populate the sidecar's load balancing pool. Also, notice that this rule is set in the istio-system namespace but uses the fully qualified domain name of the productpage service, productpage.prod.svc.cluster.local. Therefore the rule's namespace does not have an impact in resolving the name of the productpage service.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: my-productpage-rule<br><p> 	namespace: istio-system<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- productpage.prod.svc.cluster.local # ignores rule namespace<br><p> 	http:<br><p> 	- timeout: 5s<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: productpage.prod.svc.cluster.local<br><p> <br><p> ```<br><p> <br><p> To control routing for traffic bound to services outside the mesh, external services must first be added to Istio's internal service registry using the ServiceEntry resource. VirtualServices can then be defined to control traffic bound to these external services. For example, the following rules define a Service for wikipedia.org and set a timeout of 5s for HTTP requests.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: ServiceEntry metadata:<br><p> <br><p> 	name: external-svc-wikipedia<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- wikipedia.org<br><p> 	location: MESH_EXTERNAL<br><p> 	ports:<br><p> 	- number: 80<br><p> 	  name: example-http<br><p> 	  protocol: HTTP<br><p> 	resolution: DNS
+     */
     @JsonProperty("port")
     public PortSelector getPort() {
         return port;
     }
 
+    /**
+     * Destination indicates the network addressable service to which the request/connection will be sent after processing a routing rule. The destination.host should unambiguously refer to a service in the service registry. Istio's service registry is composed of all the services found in the platform's service registry (e.g., Kubernetes services, Consul services), as well as services declared through the [ServiceEntry](https://istio.io/docs/reference/config/networking/service-entry/#ServiceEntry) resource.<br><p> <br><p> &#42;Note for Kubernetes users&#42;: When short names are used (e.g. "reviews" instead of "reviews.default.svc.cluster.local"), Istio will interpret the short name based on the namespace of the rule, not the service. A rule in the "default" namespace containing a host "reviews" will be interpreted as "reviews.default.svc.cluster.local", irrespective of the actual namespace associated with the reviews service. _To avoid potential misconfigurations, it is recommended to always use fully qualified domain names over short names._<br><p> <br><p> The following Kubernetes example routes all traffic by default to pods of the reviews service with label "version: v1" (i.e., subset v1), and some to subset v2, in a Kubernetes environment.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: reviews-route<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- reviews # interpreted as reviews.foo.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - uri:<br><p> 	      prefix: "/wpcatalog"<br><p> 	  - uri:<br><p> 	      prefix: "/consumercatalog"<br><p> 	  rewrite:<br><p> 	    uri: "/newcatalog"<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: reviews # interpreted as reviews.foo.svc.cluster.local<br><p> 	      subset: v2<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: reviews # interpreted as reviews.foo.svc.cluster.local<br><p> 	      subset: v1<br><p> <br><p> ```<br><p> <br><p> # And the associated DestinationRule<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: reviews-destination<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	host: reviews # interpreted as reviews.foo.svc.cluster.local<br><p> 	subsets:<br><p> 	- name: v1<br><p> 	  labels:<br><p> 	    version: v1<br><p> 	- name: v2<br><p> 	  labels:<br><p> 	    version: v2<br><p> <br><p> ```<br><p> <br><p> The following VirtualService sets a timeout of 5s for all calls to productpage.prod.svc.cluster.local service in Kubernetes. Notice that there are no subsets defined in this rule. Istio will fetch all instances of productpage.prod.svc.cluster.local service from the service registry and populate the sidecar's load balancing pool. Also, notice that this rule is set in the istio-system namespace but uses the fully qualified domain name of the productpage service, productpage.prod.svc.cluster.local. Therefore the rule's namespace does not have an impact in resolving the name of the productpage service.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: my-productpage-rule<br><p> 	namespace: istio-system<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- productpage.prod.svc.cluster.local # ignores rule namespace<br><p> 	http:<br><p> 	- timeout: 5s<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: productpage.prod.svc.cluster.local<br><p> <br><p> ```<br><p> <br><p> To control routing for traffic bound to services outside the mesh, external services must first be added to Istio's internal service registry using the ServiceEntry resource. VirtualServices can then be defined to control traffic bound to these external services. For example, the following rules define a Service for wikipedia.org and set a timeout of 5s for HTTP requests.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: ServiceEntry metadata:<br><p> <br><p> 	name: external-svc-wikipedia<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- wikipedia.org<br><p> 	location: MESH_EXTERNAL<br><p> 	ports:<br><p> 	- number: 80<br><p> 	  name: example-http<br><p> 	  protocol: HTTP<br><p> 	resolution: DNS
+     */
     @JsonProperty("port")
     public void setPort(PortSelector port) {
         this.port = port;
     }
 
+    /**
+     * The name of a subset within the service. Applicable only to services within the mesh. The subset must be defined in a corresponding DestinationRule.
+     */
     @JsonProperty("subset")
     public String getSubset() {
         return subset;
     }
 
+    /**
+     * The name of a subset within the service. Applicable only to services within the mesh. The subset must be defined in a corresponding DestinationRule.
+     */
     @JsonProperty("subset")
     public void setSubset(String subset) {
         this.subset = subset;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/DestinationRule.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/DestinationRule.java
index e0346f6407f..56fa8165b45 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/DestinationRule.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/DestinationRule.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DestinationRule defines policies that apply to traffic intended for a service after routing has occurred.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -109,53 +112,83 @@ public DestinationRule(List<String> exportTo, String host, List<Subset> subsets,
         this.workloadSelector = workloadSelector;
     }
 
+    /**
+     * A list of namespaces to which this destination rule is exported. The resolution of a destination rule to apply to a service occurs in the context of a hierarchy of namespaces. Exporting a destination rule allows it to be included in the resolution hierarchy for services in other namespaces. This feature provides a mechanism for service owners and mesh administrators to control the visibility of destination rules across namespace boundaries.<br><p> <br><p> If no namespaces are specified then the destination rule is exported to all namespaces by default.<br><p> <br><p> The value "." is reserved and defines an export to the same namespace that the destination rule is declared in. Similarly, the value "&#42;" is reserved and defines an export to all namespaces.
+     */
     @JsonProperty("exportTo")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getExportTo() {
         return exportTo;
     }
 
+    /**
+     * A list of namespaces to which this destination rule is exported. The resolution of a destination rule to apply to a service occurs in the context of a hierarchy of namespaces. Exporting a destination rule allows it to be included in the resolution hierarchy for services in other namespaces. This feature provides a mechanism for service owners and mesh administrators to control the visibility of destination rules across namespace boundaries.<br><p> <br><p> If no namespaces are specified then the destination rule is exported to all namespaces by default.<br><p> <br><p> The value "." is reserved and defines an export to the same namespace that the destination rule is declared in. Similarly, the value "&#42;" is reserved and defines an export to all namespaces.
+     */
     @JsonProperty("exportTo")
     public void setExportTo(List<String> exportTo) {
         this.exportTo = exportTo;
     }
 
+    /**
+     * The name of a service from the service registry. Service names are looked up from the platform's service registry (e.g., Kubernetes services, Consul services, etc.) and from the hosts declared by [ServiceEntries](https://istio.io/docs/reference/config/networking/service-entry/#ServiceEntry). Rules defined for services that do not exist in the service registry will be ignored.<br><p> <br><p> &#42;Note for Kubernetes users&#42;: When short names are used (e.g. "reviews" instead of "reviews.default.svc.cluster.local"), Istio will interpret the short name based on the namespace of the rule, not the service. A rule in the "default" namespace containing a host "reviews" will be interpreted as "reviews.default.svc.cluster.local", irrespective of the actual namespace associated with the reviews service. _To avoid potential misconfigurations, it is recommended to always use fully qualified domain names over short names._<br><p> <br><p> Note that the host field applies to both HTTP and TCP services.
+     */
     @JsonProperty("host")
     public String getHost() {
         return host;
     }
 
+    /**
+     * The name of a service from the service registry. Service names are looked up from the platform's service registry (e.g., Kubernetes services, Consul services, etc.) and from the hosts declared by [ServiceEntries](https://istio.io/docs/reference/config/networking/service-entry/#ServiceEntry). Rules defined for services that do not exist in the service registry will be ignored.<br><p> <br><p> &#42;Note for Kubernetes users&#42;: When short names are used (e.g. "reviews" instead of "reviews.default.svc.cluster.local"), Istio will interpret the short name based on the namespace of the rule, not the service. A rule in the "default" namespace containing a host "reviews" will be interpreted as "reviews.default.svc.cluster.local", irrespective of the actual namespace associated with the reviews service. _To avoid potential misconfigurations, it is recommended to always use fully qualified domain names over short names._<br><p> <br><p> Note that the host field applies to both HTTP and TCP services.
+     */
     @JsonProperty("host")
     public void setHost(String host) {
         this.host = host;
     }
 
+    /**
+     * One or more named sets that represent individual versions of a service. Traffic policies can be overridden at subset level.
+     */
     @JsonProperty("subsets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Subset> getSubsets() {
         return subsets;
     }
 
+    /**
+     * One or more named sets that represent individual versions of a service. Traffic policies can be overridden at subset level.
+     */
     @JsonProperty("subsets")
     public void setSubsets(List<Subset> subsets) {
         this.subsets = subsets;
     }
 
+    /**
+     * DestinationRule defines policies that apply to traffic intended for a service after routing has occurred.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("trafficPolicy")
     public TrafficPolicy getTrafficPolicy() {
         return trafficPolicy;
     }
 
+    /**
+     * DestinationRule defines policies that apply to traffic intended for a service after routing has occurred.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("trafficPolicy")
     public void setTrafficPolicy(TrafficPolicy trafficPolicy) {
         this.trafficPolicy = trafficPolicy;
     }
 
+    /**
+     * DestinationRule defines policies that apply to traffic intended for a service after routing has occurred.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("workloadSelector")
     public WorkloadSelector getWorkloadSelector() {
         return workloadSelector;
     }
 
+    /**
+     * DestinationRule defines policies that apply to traffic intended for a service after routing has occurred.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("workloadSelector")
     public void setWorkloadSelector(WorkloadSelector workloadSelector) {
         this.workloadSelector = workloadSelector;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilter.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilter.java
index f205438af18..1682cd739f3 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilter.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilter.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EnvoyFilter provides a mechanism to customize the Envoy configuration generated by Istio Pilot.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -105,43 +108,67 @@ public EnvoyFilter(List<EnvoyFilterEnvoyConfigObjectPatch> configPatches, Intege
         this.workloadSelector = workloadSelector;
     }
 
+    /**
+     * One or more patches with match conditions.
+     */
     @JsonProperty("configPatches")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvoyFilterEnvoyConfigObjectPatch> getConfigPatches() {
         return configPatches;
     }
 
+    /**
+     * One or more patches with match conditions.
+     */
     @JsonProperty("configPatches")
     public void setConfigPatches(List<EnvoyFilterEnvoyConfigObjectPatch> configPatches) {
         this.configPatches = configPatches;
     }
 
+    /**
+     * Priority defines the order in which patch sets are applied within a context. When one patch depends on another patch, the order of patch application is significant. The API provides two primary ways to order patches. Patch sets in the root namespace are applied before the patch sets in the workload namespace. Patches within a patch set are processed in the order that they appear in the `configPatches` list.<br><p> <br><p> The default value for priority is 0 and the range is [ min-int32, max-int32 ]. A patch set with a negative priority is processed before the default. A patch set with a positive priority is processed after the default.<br><p> <br><p> It is recommended to start with priority values that are multiples of 10 to leave room for further insertion.<br><p> <br><p> Patch sets are sorted in the following ascending key order: priority, creation time, fully qualified resource name.
+     */
     @JsonProperty("priority")
     public Integer getPriority() {
         return priority;
     }
 
+    /**
+     * Priority defines the order in which patch sets are applied within a context. When one patch depends on another patch, the order of patch application is significant. The API provides two primary ways to order patches. Patch sets in the root namespace are applied before the patch sets in the workload namespace. Patches within a patch set are processed in the order that they appear in the `configPatches` list.<br><p> <br><p> The default value for priority is 0 and the range is [ min-int32, max-int32 ]. A patch set with a negative priority is processed before the default. A patch set with a positive priority is processed after the default.<br><p> <br><p> It is recommended to start with priority values that are multiples of 10 to leave room for further insertion.<br><p> <br><p> Patch sets are sorted in the following ascending key order: priority, creation time, fully qualified resource name.
+     */
     @JsonProperty("priority")
     public void setPriority(Integer priority) {
         this.priority = priority;
     }
 
+    /**
+     * Optional. The targetRefs specifies a list of resources the policy should be applied to. The targeted resources specified will determine which workloads the policy applies to.<br><p> <br><p> Currently, the following resource attachment types are supported: &#42; `kind: Gateway` with `group: gateway.networking.k8s.io` in the same namespace. &#42; `kind: Service` with `""` in the same namespace. This type is only supported for waypoints.<br><p> <br><p> If not set, the policy is applied as defined by the selector. At most one of the selector and targetRefs can be set.<br><p> <br><p> NOTE: If you are using the `targetRefs` field in a multi-revision environment with Istio versions prior to 1.22, it is highly recommended that you pin the policy to a revision running 1.22+ via the `istio.io/rev` label. This is to prevent proxies connected to older control planes (that don't know about the `targetRefs` field) from misinterpreting the policy as namespace-wide during the upgrade process.<br><p> <br><p> NOTE: Waypoint proxies are required to use this field for policies to apply; `selector` policies will be ignored.
+     */
     @JsonProperty("targetRefs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PolicyTargetReference> getTargetRefs() {
         return targetRefs;
     }
 
+    /**
+     * Optional. The targetRefs specifies a list of resources the policy should be applied to. The targeted resources specified will determine which workloads the policy applies to.<br><p> <br><p> Currently, the following resource attachment types are supported: &#42; `kind: Gateway` with `group: gateway.networking.k8s.io` in the same namespace. &#42; `kind: Service` with `""` in the same namespace. This type is only supported for waypoints.<br><p> <br><p> If not set, the policy is applied as defined by the selector. At most one of the selector and targetRefs can be set.<br><p> <br><p> NOTE: If you are using the `targetRefs` field in a multi-revision environment with Istio versions prior to 1.22, it is highly recommended that you pin the policy to a revision running 1.22+ via the `istio.io/rev` label. This is to prevent proxies connected to older control planes (that don't know about the `targetRefs` field) from misinterpreting the policy as namespace-wide during the upgrade process.<br><p> <br><p> NOTE: Waypoint proxies are required to use this field for policies to apply; `selector` policies will be ignored.
+     */
     @JsonProperty("targetRefs")
     public void setTargetRefs(List<PolicyTargetReference> targetRefs) {
         this.targetRefs = targetRefs;
     }
 
+    /**
+     * EnvoyFilter provides a mechanism to customize the Envoy configuration generated by Istio Pilot.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("workloadSelector")
     public WorkloadSelector getWorkloadSelector() {
         return workloadSelector;
     }
 
+    /**
+     * EnvoyFilter provides a mechanism to customize the Envoy configuration generated by Istio Pilot.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("workloadSelector")
     public void setWorkloadSelector(WorkloadSelector workloadSelector) {
         this.workloadSelector = workloadSelector;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterApplyTo.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterApplyTo.java
index bd935fc2015..1042571b179 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterApplyTo.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterApplyTo.java
@@ -4,6 +4,9 @@
 import javax.annotation.Generated;
 import com.fasterxml.jackson.annotation.JsonCreator;
 
+/**
+ * `ApplyTo` specifies where in the Envoy configuration, the given patch should be applied.
+ */
 @Generated("io.fabric8.kubernetes.schema.generator.model.ModelGenerator")
 public enum EnvoyFilterApplyTo 
 {
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterClusterMatch.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterClusterMatch.java
index b010ce4831f..1bf825018a1 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterClusterMatch.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterClusterMatch.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Conditions specified in `ClusterMatch` must be met for the patch to be applied to a cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public EnvoyFilterClusterMatch(String name, Long portNumber, String service, Str
         this.subset = subset;
     }
 
+    /**
+     * The exact name of the cluster to match. To match a specific cluster by name, such as the internally generated `Passthrough` cluster, leave all fields in clusterMatch empty, except the name.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The exact name of the cluster to match. To match a specific cluster by name, such as the internally generated `Passthrough` cluster, leave all fields in clusterMatch empty, except the name.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * The service port for which this cluster was generated.  If omitted, applies to clusters for any port. &#42;&#42;Note:&#42;&#42; for inbound cluster, it is the service target port.
+     */
     @JsonProperty("portNumber")
     public Long getPortNumber() {
         return portNumber;
     }
 
+    /**
+     * The service port for which this cluster was generated.  If omitted, applies to clusters for any port. &#42;&#42;Note:&#42;&#42; for inbound cluster, it is the service target port.
+     */
     @JsonProperty("portNumber")
     public void setPortNumber(Long portNumber) {
         this.portNumber = portNumber;
     }
 
+    /**
+     * The fully qualified service name for this cluster. If omitted, applies to clusters for any service. For services defined through service entries, the service name is same as the hosts defined in the service entry. &#42;&#42;Note:&#42;&#42; for inbound cluster, this is ignored.
+     */
     @JsonProperty("service")
     public String getService() {
         return service;
     }
 
+    /**
+     * The fully qualified service name for this cluster. If omitted, applies to clusters for any service. For services defined through service entries, the service name is same as the hosts defined in the service entry. &#42;&#42;Note:&#42;&#42; for inbound cluster, this is ignored.
+     */
     @JsonProperty("service")
     public void setService(String service) {
         this.service = service;
     }
 
+    /**
+     * The subset associated with the service. If omitted, applies to clusters for any subset of a service.
+     */
     @JsonProperty("subset")
     public String getSubset() {
         return subset;
     }
 
+    /**
+     * The subset associated with the service. If omitted, applies to clusters for any subset of a service.
+     */
     @JsonProperty("subset")
     public void setSubset(String subset) {
         this.subset = subset;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterEnvoyConfigObjectMatch.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterEnvoyConfigObjectMatch.java
index 430050efa9b..c26f7e51e79 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterEnvoyConfigObjectMatch.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterEnvoyConfigObjectMatch.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * One or more match conditions to be met before a patch is applied to the generated configuration for a given proxy.
+ */
 @JsonDeserialize(using = io.fabric8.kubernetes.model.jackson.JsonUnwrappedDeserializer.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -88,32 +91,50 @@ public EnvoyFilterEnvoyConfigObjectMatch(IsEnvoyFilterEnvoyConfigObjectMatchObje
         this.proxy = proxy;
     }
 
+    /**
+     * One or more match conditions to be met before a patch is applied to the generated configuration for a given proxy.
+     */
     @JsonProperty("ObjectTypes")
     @JsonUnwrapped
     public IsEnvoyFilterEnvoyConfigObjectMatchObjectTypes getObjectTypes() {
         return objectTypes;
     }
 
+    /**
+     * One or more match conditions to be met before a patch is applied to the generated configuration for a given proxy.
+     */
     @JsonProperty("ObjectTypes")
     public void setObjectTypes(IsEnvoyFilterEnvoyConfigObjectMatchObjectTypes objectTypes) {
         this.objectTypes = objectTypes;
     }
 
+    /**
+     * One or more match conditions to be met before a patch is applied to the generated configuration for a given proxy.
+     */
     @JsonProperty("context")
     public EnvoyFilterPatchContext getContext() {
         return context;
     }
 
+    /**
+     * One or more match conditions to be met before a patch is applied to the generated configuration for a given proxy.
+     */
     @JsonProperty("context")
     public void setContext(EnvoyFilterPatchContext context) {
         this.context = context;
     }
 
+    /**
+     * One or more match conditions to be met before a patch is applied to the generated configuration for a given proxy.
+     */
     @JsonProperty("proxy")
     public EnvoyFilterProxyMatch getProxy() {
         return proxy;
     }
 
+    /**
+     * One or more match conditions to be met before a patch is applied to the generated configuration for a given proxy.
+     */
     @JsonProperty("proxy")
     public void setProxy(EnvoyFilterProxyMatch proxy) {
         this.proxy = proxy;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterEnvoyConfigObjectPatch.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterEnvoyConfigObjectPatch.java
index b0dd79c0050..7bd84f4d863 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterEnvoyConfigObjectPatch.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterEnvoyConfigObjectPatch.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Changes to be made to various envoy config objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public EnvoyFilterEnvoyConfigObjectPatch(EnvoyFilterApplyTo applyTo, EnvoyFilter
         this.patch = patch;
     }
 
+    /**
+     * Changes to be made to various envoy config objects.
+     */
     @JsonProperty("applyTo")
     public EnvoyFilterApplyTo getApplyTo() {
         return applyTo;
     }
 
+    /**
+     * Changes to be made to various envoy config objects.
+     */
     @JsonProperty("applyTo")
     public void setApplyTo(EnvoyFilterApplyTo applyTo) {
         this.applyTo = applyTo;
     }
 
+    /**
+     * Changes to be made to various envoy config objects.
+     */
     @JsonProperty("match")
     public EnvoyFilterEnvoyConfigObjectMatch getMatch() {
         return match;
     }
 
+    /**
+     * Changes to be made to various envoy config objects.
+     */
     @JsonProperty("match")
     public void setMatch(EnvoyFilterEnvoyConfigObjectMatch match) {
         this.match = match;
     }
 
+    /**
+     * Changes to be made to various envoy config objects.
+     */
     @JsonProperty("patch")
     public EnvoyFilterPatch getPatch() {
         return patch;
     }
 
+    /**
+     * Changes to be made to various envoy config objects.
+     */
     @JsonProperty("patch")
     public void setPatch(EnvoyFilterPatch patch) {
         this.patch = patch;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterListenerMatch.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterListenerMatch.java
index 9bc1cf182c8..ea9a8ca4cba 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterListenerMatch.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterListenerMatch.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Conditions specified in a listener match must be met for the patch to be applied to a specific listener across all filter chains, or a specific filter chain inside the listener.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public EnvoyFilterListenerMatch(EnvoyFilterListenerMatchFilterChainMatch filterC
         this.portNumber = portNumber;
     }
 
+    /**
+     * Conditions specified in a listener match must be met for the patch to be applied to a specific listener across all filter chains, or a specific filter chain inside the listener.
+     */
     @JsonProperty("filterChain")
     public EnvoyFilterListenerMatchFilterChainMatch getFilterChain() {
         return filterChain;
     }
 
+    /**
+     * Conditions specified in a listener match must be met for the patch to be applied to a specific listener across all filter chains, or a specific filter chain inside the listener.
+     */
     @JsonProperty("filterChain")
     public void setFilterChain(EnvoyFilterListenerMatchFilterChainMatch filterChain) {
         this.filterChain = filterChain;
     }
 
+    /**
+     * Match a specific listener filter. If specified, the patch will be applied to the listener filter.
+     */
     @JsonProperty("listenerFilter")
     public String getListenerFilter() {
         return listenerFilter;
     }
 
+    /**
+     * Match a specific listener filter. If specified, the patch will be applied to the listener filter.
+     */
     @JsonProperty("listenerFilter")
     public void setListenerFilter(String listenerFilter) {
         this.listenerFilter = listenerFilter;
     }
 
+    /**
+     * Match a specific listener by its name. The listeners generated by Pilot are typically named as IP:Port.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Match a specific listener by its name. The listeners generated by Pilot are typically named as IP:Port.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Instead of using specific port numbers, a set of ports matching a given service's port name can be selected. Matching is case insensitive. Not implemented. $hide_from_docs
+     */
     @JsonProperty("portName")
     public String getPortName() {
         return portName;
     }
 
+    /**
+     * Instead of using specific port numbers, a set of ports matching a given service's port name can be selected. Matching is case insensitive. Not implemented. $hide_from_docs
+     */
     @JsonProperty("portName")
     public void setPortName(String portName) {
         this.portName = portName;
     }
 
+    /**
+     * The service port/gateway port to which traffic is being sent/received. If not specified, matches all listeners. Even though inbound listeners are generated for the instance/pod ports, only service ports should be used to match listeners.
+     */
     @JsonProperty("portNumber")
     public Long getPortNumber() {
         return portNumber;
     }
 
+    /**
+     * The service port/gateway port to which traffic is being sent/received. If not specified, matches all listeners. Even though inbound listeners are generated for the instance/pod ports, only service ports should be used to match listeners.
+     */
     @JsonProperty("portNumber")
     public void setPortNumber(Long portNumber) {
         this.portNumber = portNumber;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterListenerMatchFilterChainMatch.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterListenerMatchFilterChainMatch.java
index 49bf3616217..b8f9af2d08f 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterListenerMatchFilterChainMatch.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterListenerMatchFilterChainMatch.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * For listeners with multiple filter chains (e.g., inbound listeners on sidecars with permissive mTLS, gateway listeners with multiple SNI matches), the filter chain match can be used to select a specific filter chain to patch.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public EnvoyFilterListenerMatchFilterChainMatch(String applicationProtocols, Lon
         this.transportProtocol = transportProtocol;
     }
 
+    /**
+     * Applies only to sidecars. If non-empty, a comma separated set of application protocols to consider when determining a filter chain match.  This value will be compared against the application protocols of a new connection, when it's detected by one of the listener filters such as the `http_inspector`.<br><p> <br><p> Accepted values include: h2, http/1.1, http/1.0
+     */
     @JsonProperty("applicationProtocols")
     public String getApplicationProtocols() {
         return applicationProtocols;
     }
 
+    /**
+     * Applies only to sidecars. If non-empty, a comma separated set of application protocols to consider when determining a filter chain match.  This value will be compared against the application protocols of a new connection, when it's detected by one of the listener filters such as the `http_inspector`.<br><p> <br><p> Accepted values include: h2, http/1.1, http/1.0
+     */
     @JsonProperty("applicationProtocols")
     public void setApplicationProtocols(String applicationProtocols) {
         this.applicationProtocols = applicationProtocols;
     }
 
+    /**
+     * The destination_port value used by a filter chain's match condition. This condition will evaluate to false if the filter chain has no destination_port match.
+     */
     @JsonProperty("destinationPort")
     public Long getDestinationPort() {
         return destinationPort;
     }
 
+    /**
+     * The destination_port value used by a filter chain's match condition. This condition will evaluate to false if the filter chain has no destination_port match.
+     */
     @JsonProperty("destinationPort")
     public void setDestinationPort(Long destinationPort) {
         this.destinationPort = destinationPort;
     }
 
+    /**
+     * For listeners with multiple filter chains (e.g., inbound listeners on sidecars with permissive mTLS, gateway listeners with multiple SNI matches), the filter chain match can be used to select a specific filter chain to patch.
+     */
     @JsonProperty("filter")
     public EnvoyFilterListenerMatchFilterMatch getFilter() {
         return filter;
     }
 
+    /**
+     * For listeners with multiple filter chains (e.g., inbound listeners on sidecars with permissive mTLS, gateway listeners with multiple SNI matches), the filter chain match can be used to select a specific filter chain to patch.
+     */
     @JsonProperty("filter")
     public void setFilter(EnvoyFilterListenerMatchFilterMatch filter) {
         this.filter = filter;
     }
 
+    /**
+     * The name assigned to the filter chain.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The name assigned to the filter chain.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * The SNI value used by a filter chain's match condition.  This condition will evaluate to false if the filter chain has no sni match.
+     */
     @JsonProperty("sni")
     public String getSni() {
         return sni;
     }
 
+    /**
+     * The SNI value used by a filter chain's match condition.  This condition will evaluate to false if the filter chain has no sni match.
+     */
     @JsonProperty("sni")
     public void setSni(String sni) {
         this.sni = sni;
     }
 
+    /**
+     * Applies only to `SIDECAR_INBOUND` context. If non-empty, a transport protocol to consider when determining a filter chain match.  This value will be compared against the transport protocol of a new connection, when it's detected by the `tls_inspector` listener filter.<br><p> <br><p> Accepted values include:<br><p> <br><p> &#42; `raw_buffer` - default, used when no transport protocol is detected. &#42; `tls` - set when TLS protocol is detected by the TLS inspector.
+     */
     @JsonProperty("transportProtocol")
     public String getTransportProtocol() {
         return transportProtocol;
     }
 
+    /**
+     * Applies only to `SIDECAR_INBOUND` context. If non-empty, a transport protocol to consider when determining a filter chain match.  This value will be compared against the transport protocol of a new connection, when it's detected by the `tls_inspector` listener filter.<br><p> <br><p> Accepted values include:<br><p> <br><p> &#42; `raw_buffer` - default, used when no transport protocol is detected. &#42; `tls` - set when TLS protocol is detected by the TLS inspector.
+     */
     @JsonProperty("transportProtocol")
     public void setTransportProtocol(String transportProtocol) {
         this.transportProtocol = transportProtocol;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterListenerMatchFilterMatch.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterListenerMatchFilterMatch.java
index 69b4b39b10d..61677b3767e 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterListenerMatchFilterMatch.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterListenerMatchFilterMatch.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Conditions to match a specific filter within a filter chain.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public EnvoyFilterListenerMatchFilterMatch(String name, EnvoyFilterListenerMatch
         this.subFilter = subFilter;
     }
 
+    /**
+     * The filter name to match on. For standard Envoy filters, [canonical filter](https://www.envoyproxy.io/docs/envoy/latest/version_history/v1.14.0#deprecated) names should be used.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The filter name to match on. For standard Envoy filters, [canonical filter](https://www.envoyproxy.io/docs/envoy/latest/version_history/v1.14.0#deprecated) names should be used.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Conditions to match a specific filter within a filter chain.
+     */
     @JsonProperty("subFilter")
     public EnvoyFilterListenerMatchSubFilterMatch getSubFilter() {
         return subFilter;
     }
 
+    /**
+     * Conditions to match a specific filter within a filter chain.
+     */
     @JsonProperty("subFilter")
     public void setSubFilter(EnvoyFilterListenerMatchSubFilterMatch subFilter) {
         this.subFilter = subFilter;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterListenerMatchSubFilterMatch.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterListenerMatchSubFilterMatch.java
index 516e3894c5c..75f3644b7f9 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterListenerMatchSubFilterMatch.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterListenerMatchSubFilterMatch.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Conditions to match a specific filter within another filter. This field is typically useful to match a HTTP filter inside the `envoy.filters.network.http_connection_manager` network filter. This could also be applicable for thrift filters.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public EnvoyFilterListenerMatchSubFilterMatch(String name) {
         this.name = name;
     }
 
+    /**
+     * The filter name to match on.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The filter name to match on.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterPatch.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterPatch.java
index b6df4c05a1c..354717bad72 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterPatch.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterPatch.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Patch specifies how the selected object should be modified.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,31 +90,49 @@ public EnvoyFilterPatch(EnvoyFilterPatchFilterClass filterClass, EnvoyFilterPatc
         this.value = value;
     }
 
+    /**
+     * Patch specifies how the selected object should be modified.
+     */
     @JsonProperty("filterClass")
     public EnvoyFilterPatchFilterClass getFilterClass() {
         return filterClass;
     }
 
+    /**
+     * Patch specifies how the selected object should be modified.
+     */
     @JsonProperty("filterClass")
     public void setFilterClass(EnvoyFilterPatchFilterClass filterClass) {
         this.filterClass = filterClass;
     }
 
+    /**
+     * Patch specifies how the selected object should be modified.
+     */
     @JsonProperty("operation")
     public EnvoyFilterPatchOperation getOperation() {
         return operation;
     }
 
+    /**
+     * Patch specifies how the selected object should be modified.
+     */
     @JsonProperty("operation")
     public void setOperation(EnvoyFilterPatchOperation operation) {
         this.operation = operation;
     }
 
+    /**
+     * Patch specifies how the selected object should be modified.
+     */
     @JsonProperty("value")
     public Object getValue() {
         return value;
     }
 
+    /**
+     * Patch specifies how the selected object should be modified.
+     */
     @JsonProperty("value")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setValue(Object value) {
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterPatchContext.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterPatchContext.java
index eb266c93dbe..35818eb5905 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterPatchContext.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterPatchContext.java
@@ -4,6 +4,9 @@
 import javax.annotation.Generated;
 import com.fasterxml.jackson.annotation.JsonCreator;
 
+/**
+ * PatchContext selects a class of configurations based on the traffic flow direction and workload type.
+ */
 @Generated("io.fabric8.kubernetes.schema.generator.model.ModelGenerator")
 public enum EnvoyFilterPatchContext 
 {
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterPatchFilterClass.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterPatchFilterClass.java
index 0c61329b02a..ecf015d6d8b 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterPatchFilterClass.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterPatchFilterClass.java
@@ -4,6 +4,9 @@
 import javax.annotation.Generated;
 import com.fasterxml.jackson.annotation.JsonCreator;
 
+/**
+ * FilterClass determines the filter insertion point in the filter chain relative to the filters implicitly inserted by the control plane. It is used in conjunction with the `ADD` operation. This is the preferred insertion mechanism for adding filters over the `INSERT_&#42;` operations since those operations rely on potentially unstable filter names. Filter ordering is important if your filter depends on or affects the functioning of a another filter in the filter chain. Within a filter class, filters are inserted in the order of processing.
+ */
 @Generated("io.fabric8.kubernetes.schema.generator.model.ModelGenerator")
 public enum EnvoyFilterPatchFilterClass 
 {
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterPatchOperation.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterPatchOperation.java
index 765fb72f4bc..fd52fa8ea3a 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterPatchOperation.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterPatchOperation.java
@@ -4,6 +4,9 @@
 import javax.annotation.Generated;
 import com.fasterxml.jackson.annotation.JsonCreator;
 
+/**
+ * Operation denotes how the patch should be applied to the selected configuration.
+ */
 @Generated("io.fabric8.kubernetes.schema.generator.model.ModelGenerator")
 public enum EnvoyFilterPatchOperation 
 {
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterProxyMatch.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterProxyMatch.java
index 61dcffc38ae..c1d340e85b9 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterProxyMatch.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterProxyMatch.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * One or more properties of the proxy to match on.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,22 +86,34 @@ public EnvoyFilterProxyMatch(Map<String, String> metadata, String proxyVersion)
         this.proxyVersion = proxyVersion;
     }
 
+    /**
+     * Match on the node metadata supplied by a proxy when connecting to Istio Pilot. Note that while Envoy's node metadata is of type Struct, only string key-value pairs are processed by Pilot. All keys specified in the metadata must match with exact values. The match will fail if any of the specified keys are absent or the values fail to match.
+     */
     @JsonProperty("metadata")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getMetadata() {
         return metadata;
     }
 
+    /**
+     * Match on the node metadata supplied by a proxy when connecting to Istio Pilot. Note that while Envoy's node metadata is of type Struct, only string key-value pairs are processed by Pilot. All keys specified in the metadata must match with exact values. The match will fail if any of the specified keys are absent or the values fail to match.
+     */
     @JsonProperty("metadata")
     public void setMetadata(Map<String, String> metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * A regular expression in golang regex format (RE2) that can be used to select proxies using a specific version of istio proxy. The Istio version for a given proxy is obtained from the node metadata field `ISTIO_VERSION` supplied by the proxy when connecting to Pilot. This value is embedded as an environment variable (`ISTIO_META_ISTIO_VERSION`) in the Istio proxy docker image. Custom proxy implementations should provide this metadata variable to take advantage of the Istio version check option.
+     */
     @JsonProperty("proxyVersion")
     public String getProxyVersion() {
         return proxyVersion;
     }
 
+    /**
+     * A regular expression in golang regex format (RE2) that can be used to select proxies using a specific version of istio proxy. The Istio version for a given proxy is obtained from the node metadata field `ISTIO_VERSION` supplied by the proxy when connecting to Pilot. This value is embedded as an environment variable (`ISTIO_META_ISTIO_VERSION`) in the Istio proxy docker image. Custom proxy implementations should provide this metadata variable to take advantage of the Istio version check option.
+     */
     @JsonProperty("proxyVersion")
     public void setProxyVersion(String proxyVersion) {
         this.proxyVersion = proxyVersion;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterRouteConfigurationMatch.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterRouteConfigurationMatch.java
index 5fd56c473b1..4f0936bbbb0 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterRouteConfigurationMatch.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterRouteConfigurationMatch.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Conditions specified in RouteConfigurationMatch must be met for the patch to be applied to a route configuration object or a specific virtual host within the route configuration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public EnvoyFilterRouteConfigurationMatch(String gateway, String name, String po
         this.vhost = vhost;
     }
 
+    /**
+     * The Istio gateway config's namespace/name for which this route configuration was generated. Applies only if the context is GATEWAY. Should be in the namespace/name format. Use this field in conjunction with the `portNumber` and `portName` to accurately select the Envoy route configuration for a specific HTTPS server within a gateway config object.
+     */
     @JsonProperty("gateway")
     public String getGateway() {
         return gateway;
     }
 
+    /**
+     * The Istio gateway config's namespace/name for which this route configuration was generated. Applies only if the context is GATEWAY. Should be in the namespace/name format. Use this field in conjunction with the `portNumber` and `portName` to accurately select the Envoy route configuration for a specific HTTPS server within a gateway config object.
+     */
     @JsonProperty("gateway")
     public void setGateway(String gateway) {
         this.gateway = gateway;
     }
 
+    /**
+     * Route configuration name to match on. Can be used to match a specific route configuration by name, such as the internally generated `http_proxy` route configuration for all sidecars.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Route configuration name to match on. Can be used to match a specific route configuration by name, such as the internally generated `http_proxy` route configuration for all sidecars.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Applicable only for GATEWAY context. The gateway server port name for which this route configuration was generated.
+     */
     @JsonProperty("portName")
     public String getPortName() {
         return portName;
     }
 
+    /**
+     * Applicable only for GATEWAY context. The gateway server port name for which this route configuration was generated.
+     */
     @JsonProperty("portName")
     public void setPortName(String portName) {
         this.portName = portName;
     }
 
+    /**
+     * The service port number or gateway server port number for which this route configuration was generated. If omitted, applies to route configurations for all ports.
+     */
     @JsonProperty("portNumber")
     public Long getPortNumber() {
         return portNumber;
     }
 
+    /**
+     * The service port number or gateway server port number for which this route configuration was generated. If omitted, applies to route configurations for all ports.
+     */
     @JsonProperty("portNumber")
     public void setPortNumber(Long portNumber) {
         this.portNumber = portNumber;
     }
 
+    /**
+     * Conditions specified in RouteConfigurationMatch must be met for the patch to be applied to a route configuration object or a specific virtual host within the route configuration.
+     */
     @JsonProperty("vhost")
     public EnvoyFilterRouteConfigurationMatchVirtualHostMatch getVhost() {
         return vhost;
     }
 
+    /**
+     * Conditions specified in RouteConfigurationMatch must be met for the patch to be applied to a route configuration object or a specific virtual host within the route configuration.
+     */
     @JsonProperty("vhost")
     public void setVhost(EnvoyFilterRouteConfigurationMatchVirtualHostMatch vhost) {
         this.vhost = vhost;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterRouteConfigurationMatchRouteMatch.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterRouteConfigurationMatchRouteMatch.java
index 257ab1c6ca6..988973f7d33 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterRouteConfigurationMatchRouteMatch.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterRouteConfigurationMatchRouteMatch.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Match a specific route inside a virtual host in a route configuration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public EnvoyFilterRouteConfigurationMatchRouteMatch(EnvoyFilterRouteConfiguratio
         this.name = name;
     }
 
+    /**
+     * Match a specific route inside a virtual host in a route configuration.
+     */
     @JsonProperty("action")
     public EnvoyFilterRouteConfigurationMatchRouteMatchAction getAction() {
         return action;
     }
 
+    /**
+     * Match a specific route inside a virtual host in a route configuration.
+     */
     @JsonProperty("action")
     public void setAction(EnvoyFilterRouteConfigurationMatchRouteMatchAction action) {
         this.action = action;
     }
 
+    /**
+     * The Route objects generated by default are named as default.  Route objects generated using a virtual service will carry the name used in the virtual service's HTTP routes.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The Route objects generated by default are named as default.  Route objects generated using a virtual service will carry the name used in the virtual service's HTTP routes.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterRouteConfigurationMatchRouteMatchAction.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterRouteConfigurationMatchRouteMatchAction.java
index dae6b439638..fbc47c7eee2 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterRouteConfigurationMatchRouteMatchAction.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterRouteConfigurationMatchRouteMatchAction.java
@@ -4,6 +4,9 @@
 import javax.annotation.Generated;
 import com.fasterxml.jackson.annotation.JsonCreator;
 
+/**
+ * Action refers to the route action taken by Envoy when a http route matches.
+ */
 @Generated("io.fabric8.kubernetes.schema.generator.model.ModelGenerator")
 public enum EnvoyFilterRouteConfigurationMatchRouteMatchAction 
 {
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterRouteConfigurationMatchVirtualHostMatch.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterRouteConfigurationMatchVirtualHostMatch.java
index d35731c6f04..a2ce8ac3978 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterRouteConfigurationMatchVirtualHostMatch.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/EnvoyFilterRouteConfigurationMatchVirtualHostMatch.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Match a specific virtual host inside a route configuration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public EnvoyFilterRouteConfigurationMatchVirtualHostMatch(String name, EnvoyFilt
         this.route = route;
     }
 
+    /**
+     * The VirtualHosts objects generated by Istio are named as host:port, where the host typically corresponds to the VirtualService's host field or the hostname of a service in the registry.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The VirtualHosts objects generated by Istio are named as host:port, where the host typically corresponds to the VirtualService's host field or the hostname of a service in the registry.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Match a specific virtual host inside a route configuration.
+     */
     @JsonProperty("route")
     public EnvoyFilterRouteConfigurationMatchRouteMatch getRoute() {
         return route;
     }
 
+    /**
+     * Match a specific virtual host inside a route configuration.
+     */
     @JsonProperty("route")
     public void setRoute(EnvoyFilterRouteConfigurationMatchRouteMatch route) {
         this.route = route;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ExecHealthCheckConfig.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ExecHealthCheckConfig.java
index 6c99f478eba..772fef9429a 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ExecHealthCheckConfig.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ExecHealthCheckConfig.java
@@ -81,12 +81,18 @@ public ExecHealthCheckConfig(List<String> command) {
         this.command = command;
     }
 
+    /**
+     * Command to run. Exit status of 0 is treated as live/healthy and non-zero is unhealthy.
+     */
     @JsonProperty("command")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCommand() {
         return command;
     }
 
+    /**
+     * Command to run. Exit status of 0 is treated as live/healthy and non-zero is unhealthy.
+     */
     @JsonProperty("command")
     public void setCommand(List<String> command) {
         this.command = command;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Gateway.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Gateway.java
index 4d4e4be3508..d1dd58424fa 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Gateway.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Gateway.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Gateway describes a load balancer operating at the edge of the mesh receiving incoming or outgoing HTTP/TCP connections.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -96,23 +99,35 @@ public Gateway(Map<String, String> selector, List<Server> servers) {
         this.servers = servers;
     }
 
+    /**
+     * One or more labels that indicate a specific set of pods/VMs on which this gateway configuration should be applied. By default workloads are searched across all namespaces based on label selectors. This implies that a gateway resource in the namespace "foo" can select pods in the namespace "bar" based on labels. This behavior can be controlled via the `PILOT_SCOPE_GATEWAY_TO_NAMESPACE` environment variable in istiod. If this variable is set to true, the scope of label search is restricted to the configuration namespace in which the the resource is present. In other words, the Gateway resource must reside in the same namespace as the gateway workload instance. If selector is nil, the Gateway will be applied to all workloads.
+     */
     @JsonProperty("selector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getSelector() {
         return selector;
     }
 
+    /**
+     * One or more labels that indicate a specific set of pods/VMs on which this gateway configuration should be applied. By default workloads are searched across all namespaces based on label selectors. This implies that a gateway resource in the namespace "foo" can select pods in the namespace "bar" based on labels. This behavior can be controlled via the `PILOT_SCOPE_GATEWAY_TO_NAMESPACE` environment variable in istiod. If this variable is set to true, the scope of label search is restricted to the configuration namespace in which the the resource is present. In other words, the Gateway resource must reside in the same namespace as the gateway workload instance. If selector is nil, the Gateway will be applied to all workloads.
+     */
     @JsonProperty("selector")
     public void setSelector(Map<String, String> selector) {
         this.selector = selector;
     }
 
+    /**
+     * A list of server specifications.
+     */
     @JsonProperty("servers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Server> getServers() {
         return servers;
     }
 
+    /**
+     * A list of server specifications.
+     */
     @JsonProperty("servers")
     public void setServers(List<Server> servers) {
         this.servers = servers;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPBodyBytes.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPBodyBytes.java
index 15de00ceb48..0547a8041bf 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPBodyBytes.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPBodyBytes.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * response body as base64 encoded bytes.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public HTTPBodyBytes(String bytes) {
         this.bytes = bytes;
     }
 
+    /**
+     * response body as base64 encoded bytes.
+     */
     @JsonProperty("bytes")
     public String getBytes() {
         return bytes;
     }
 
+    /**
+     * response body as base64 encoded bytes.
+     */
     @JsonProperty("bytes")
     public void setBytes(String bytes) {
         this.bytes = bytes;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPBodyString.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPBodyString.java
index 2137e273973..10aa8512681 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPBodyString.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPBodyString.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * response body as a string
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public HTTPBodyString(String string) {
         this.string = string;
     }
 
+    /**
+     * response body as a string
+     */
     @JsonProperty("string")
     public String getString() {
         return string;
     }
 
+    /**
+     * response body as a string
+     */
     @JsonProperty("string")
     public void setString(String string) {
         this.string = string;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPDirectResponse.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPDirectResponse.java
index 5cf1adfebc7..d788ffa63ff 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPDirectResponse.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPDirectResponse.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPDirectResponse can be used to send a fixed response to clients. For example, the following rule returns a fixed 503 status with a body to requests for /v1/getProductRatings API.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - uri:<br><p> 	      exact: /v1/getProductRatings<br><p> 	  directResponse:<br><p> 	    status: 503<br><p> 	    body:<br><p> 	      string: "unknown error"<br><p> 	...<br><p> <br><p> ```<br><p> <br><p> It is also possible to specify a binary response body. This is mostly useful for non text-based protocols such as gRPC.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - uri:<br><p> 	      exact: /v1/getProductRatings<br><p> 	  directResponse:<br><p> 	    status: 503<br><p> 	    body:<br><p> 	      bytes: "dW5rbm93biBlcnJvcg==" # "unknown error" in base64<br><p> 	...<br><p> <br><p> ```<br><p> <br><p> It is good practice to add headers in the HTTPRoute as well as the direct_response, for example to specify the returned Content-Type.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - uri:<br><p> 	      exact: /v1/getProductRatings<br><p> 	  directResponse:<br><p> 	    status: 503<br><p> 	    body:<br><p> 	      string: "{\"error\": \"unknown error\"}"<br><p> 	  headers:<br><p> 	    response:<br><p> 	      set:<br><p> 	        content-type: "text/plain"<br><p> 	...<br><p> <br><p> ```
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public HTTPDirectResponse(HTTPBody body, Long status) {
         this.status = status;
     }
 
+    /**
+     * HTTPDirectResponse can be used to send a fixed response to clients. For example, the following rule returns a fixed 503 status with a body to requests for /v1/getProductRatings API.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - uri:<br><p> 	      exact: /v1/getProductRatings<br><p> 	  directResponse:<br><p> 	    status: 503<br><p> 	    body:<br><p> 	      string: "unknown error"<br><p> 	...<br><p> <br><p> ```<br><p> <br><p> It is also possible to specify a binary response body. This is mostly useful for non text-based protocols such as gRPC.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - uri:<br><p> 	      exact: /v1/getProductRatings<br><p> 	  directResponse:<br><p> 	    status: 503<br><p> 	    body:<br><p> 	      bytes: "dW5rbm93biBlcnJvcg==" # "unknown error" in base64<br><p> 	...<br><p> <br><p> ```<br><p> <br><p> It is good practice to add headers in the HTTPRoute as well as the direct_response, for example to specify the returned Content-Type.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - uri:<br><p> 	      exact: /v1/getProductRatings<br><p> 	  directResponse:<br><p> 	    status: 503<br><p> 	    body:<br><p> 	      string: "{\"error\": \"unknown error\"}"<br><p> 	  headers:<br><p> 	    response:<br><p> 	      set:<br><p> 	        content-type: "text/plain"<br><p> 	...<br><p> <br><p> ```
+     */
     @JsonProperty("body")
     public HTTPBody getBody() {
         return body;
     }
 
+    /**
+     * HTTPDirectResponse can be used to send a fixed response to clients. For example, the following rule returns a fixed 503 status with a body to requests for /v1/getProductRatings API.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - uri:<br><p> 	      exact: /v1/getProductRatings<br><p> 	  directResponse:<br><p> 	    status: 503<br><p> 	    body:<br><p> 	      string: "unknown error"<br><p> 	...<br><p> <br><p> ```<br><p> <br><p> It is also possible to specify a binary response body. This is mostly useful for non text-based protocols such as gRPC.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - uri:<br><p> 	      exact: /v1/getProductRatings<br><p> 	  directResponse:<br><p> 	    status: 503<br><p> 	    body:<br><p> 	      bytes: "dW5rbm93biBlcnJvcg==" # "unknown error" in base64<br><p> 	...<br><p> <br><p> ```<br><p> <br><p> It is good practice to add headers in the HTTPRoute as well as the direct_response, for example to specify the returned Content-Type.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - uri:<br><p> 	      exact: /v1/getProductRatings<br><p> 	  directResponse:<br><p> 	    status: 503<br><p> 	    body:<br><p> 	      string: "{\"error\": \"unknown error\"}"<br><p> 	  headers:<br><p> 	    response:<br><p> 	      set:<br><p> 	        content-type: "text/plain"<br><p> 	...<br><p> <br><p> ```
+     */
     @JsonProperty("body")
     public void setBody(HTTPBody body) {
         this.body = body;
     }
 
+    /**
+     * Specifies the HTTP response status to be returned.
+     */
     @JsonProperty("status")
     public Long getStatus() {
         return status;
     }
 
+    /**
+     * Specifies the HTTP response status to be returned.
+     */
     @JsonProperty("status")
     public void setStatus(Long status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjection.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjection.java
index 87d7fae4a8a..d8eca73c426 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjection.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjection.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPFaultInjection can be used to specify one or more faults to inject while forwarding HTTP requests to the destination specified in a route. Fault specification is part of a VirtualService rule. Faults include aborting the Http request from downstream service, and/or delaying proxying of requests. A fault rule MUST HAVE delay or abort or both.<br><p> <br><p> &#42;Note:&#42; Delay and abort faults are independent of one another, even if both are specified simultaneously.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public HTTPFaultInjection(HTTPFaultInjectionAbort abort, HTTPFaultInjectionDelay
         this.delay = delay;
     }
 
+    /**
+     * HTTPFaultInjection can be used to specify one or more faults to inject while forwarding HTTP requests to the destination specified in a route. Fault specification is part of a VirtualService rule. Faults include aborting the Http request from downstream service, and/or delaying proxying of requests. A fault rule MUST HAVE delay or abort or both.<br><p> <br><p> &#42;Note:&#42; Delay and abort faults are independent of one another, even if both are specified simultaneously.
+     */
     @JsonProperty("abort")
     public HTTPFaultInjectionAbort getAbort() {
         return abort;
     }
 
+    /**
+     * HTTPFaultInjection can be used to specify one or more faults to inject while forwarding HTTP requests to the destination specified in a route. Fault specification is part of a VirtualService rule. Faults include aborting the Http request from downstream service, and/or delaying proxying of requests. A fault rule MUST HAVE delay or abort or both.<br><p> <br><p> &#42;Note:&#42; Delay and abort faults are independent of one another, even if both are specified simultaneously.
+     */
     @JsonProperty("abort")
     public void setAbort(HTTPFaultInjectionAbort abort) {
         this.abort = abort;
     }
 
+    /**
+     * HTTPFaultInjection can be used to specify one or more faults to inject while forwarding HTTP requests to the destination specified in a route. Fault specification is part of a VirtualService rule. Faults include aborting the Http request from downstream service, and/or delaying proxying of requests. A fault rule MUST HAVE delay or abort or both.<br><p> <br><p> &#42;Note:&#42; Delay and abort faults are independent of one another, even if both are specified simultaneously.
+     */
     @JsonProperty("delay")
     public HTTPFaultInjectionDelay getDelay() {
         return delay;
     }
 
+    /**
+     * HTTPFaultInjection can be used to specify one or more faults to inject while forwarding HTTP requests to the destination specified in a route. Fault specification is part of a VirtualService rule. Faults include aborting the Http request from downstream service, and/or delaying proxying of requests. A fault rule MUST HAVE delay or abort or both.<br><p> <br><p> &#42;Note:&#42; Delay and abort faults are independent of one another, even if both are specified simultaneously.
+     */
     @JsonProperty("delay")
     public void setDelay(HTTPFaultInjectionDelay delay) {
         this.delay = delay;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjectionAbort.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjectionAbort.java
index a04816c78ab..9e1548d3218 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjectionAbort.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjectionAbort.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Abort specification is used to prematurely abort a request with a pre-specified error code. The following example will return an HTTP 400 error code for 1 out of every 1000 requests to the "ratings" service "v1".<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	  fault:<br><p> 	    abort:<br><p> 	      percentage:<br><p> 	        value: 0.1<br><p> 	      httpStatus: 400<br><p> <br><p> ```<br><p> <br><p> The _httpStatus_ field is used to indicate the HTTP status code to return to the caller. The optional _percentage_ field can be used to only abort a certain percentage of requests. If not specified, no request will be aborted.
+ */
 @JsonDeserialize(using = io.fabric8.kubernetes.model.jackson.JsonUnwrappedDeserializer.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -84,22 +87,34 @@ public HTTPFaultInjectionAbort(IsHTTPFaultInjectionAbortErrorType errorType, Per
         this.percentage = percentage;
     }
 
+    /**
+     * Abort specification is used to prematurely abort a request with a pre-specified error code. The following example will return an HTTP 400 error code for 1 out of every 1000 requests to the "ratings" service "v1".<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	  fault:<br><p> 	    abort:<br><p> 	      percentage:<br><p> 	        value: 0.1<br><p> 	      httpStatus: 400<br><p> <br><p> ```<br><p> <br><p> The _httpStatus_ field is used to indicate the HTTP status code to return to the caller. The optional _percentage_ field can be used to only abort a certain percentage of requests. If not specified, no request will be aborted.
+     */
     @JsonProperty("ErrorType")
     @JsonUnwrapped
     public IsHTTPFaultInjectionAbortErrorType getErrorType() {
         return errorType;
     }
 
+    /**
+     * Abort specification is used to prematurely abort a request with a pre-specified error code. The following example will return an HTTP 400 error code for 1 out of every 1000 requests to the "ratings" service "v1".<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	  fault:<br><p> 	    abort:<br><p> 	      percentage:<br><p> 	        value: 0.1<br><p> 	      httpStatus: 400<br><p> <br><p> ```<br><p> <br><p> The _httpStatus_ field is used to indicate the HTTP status code to return to the caller. The optional _percentage_ field can be used to only abort a certain percentage of requests. If not specified, no request will be aborted.
+     */
     @JsonProperty("ErrorType")
     public void setErrorType(IsHTTPFaultInjectionAbortErrorType errorType) {
         this.errorType = errorType;
     }
 
+    /**
+     * Abort specification is used to prematurely abort a request with a pre-specified error code. The following example will return an HTTP 400 error code for 1 out of every 1000 requests to the "ratings" service "v1".<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	  fault:<br><p> 	    abort:<br><p> 	      percentage:<br><p> 	        value: 0.1<br><p> 	      httpStatus: 400<br><p> <br><p> ```<br><p> <br><p> The _httpStatus_ field is used to indicate the HTTP status code to return to the caller. The optional _percentage_ field can be used to only abort a certain percentage of requests. If not specified, no request will be aborted.
+     */
     @JsonProperty("percentage")
     public Percent getPercentage() {
         return percentage;
     }
 
+    /**
+     * Abort specification is used to prematurely abort a request with a pre-specified error code. The following example will return an HTTP 400 error code for 1 out of every 1000 requests to the "ratings" service "v1".<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	  fault:<br><p> 	    abort:<br><p> 	      percentage:<br><p> 	        value: 0.1<br><p> 	      httpStatus: 400<br><p> <br><p> ```<br><p> <br><p> The _httpStatus_ field is used to indicate the HTTP status code to return to the caller. The optional _percentage_ field can be used to only abort a certain percentage of requests. If not specified, no request will be aborted.
+     */
     @JsonProperty("percentage")
     public void setPercentage(Percent percentage) {
         this.percentage = percentage;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjectionAbortGrpcStatus.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjectionAbortGrpcStatus.java
index f9319dc1098..78d3b659c1d 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjectionAbortGrpcStatus.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjectionAbortGrpcStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GRPC status code to use to abort the request. The supported codes are documented in https://github.com/grpc/grpc/blob/master/doc/statuscodes.md Note: If you want to return the status "Unavailable", then you should specify the code as `UNAVAILABLE`(all caps), but not `14`.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public HTTPFaultInjectionAbortGrpcStatus(String grpcStatus) {
         this.grpcStatus = grpcStatus;
     }
 
+    /**
+     * GRPC status code to use to abort the request. The supported codes are documented in https://github.com/grpc/grpc/blob/master/doc/statuscodes.md Note: If you want to return the status "Unavailable", then you should specify the code as `UNAVAILABLE`(all caps), but not `14`.
+     */
     @JsonProperty("grpcStatus")
     public String getGrpcStatus() {
         return grpcStatus;
     }
 
+    /**
+     * GRPC status code to use to abort the request. The supported codes are documented in https://github.com/grpc/grpc/blob/master/doc/statuscodes.md Note: If you want to return the status "Unavailable", then you should specify the code as `UNAVAILABLE`(all caps), but not `14`.
+     */
     @JsonProperty("grpcStatus")
     public void setGrpcStatus(String grpcStatus) {
         this.grpcStatus = grpcStatus;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjectionAbortHttp2Error.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjectionAbortHttp2Error.java
index 900a1c3e627..90206bb0310 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjectionAbortHttp2Error.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjectionAbortHttp2Error.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * $hide_from_docs
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public HTTPFaultInjectionAbortHttp2Error(String http2Error) {
         this.http2Error = http2Error;
     }
 
+    /**
+     * $hide_from_docs
+     */
     @JsonProperty("http2Error")
     public String getHttp2Error() {
         return http2Error;
     }
 
+    /**
+     * $hide_from_docs
+     */
     @JsonProperty("http2Error")
     public void setHttp2Error(String http2Error) {
         this.http2Error = http2Error;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjectionAbortHttpStatus.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjectionAbortHttpStatus.java
index b3675d58de0..42507f8bad7 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjectionAbortHttpStatus.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjectionAbortHttpStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTP status code to use to abort the Http request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public HTTPFaultInjectionAbortHttpStatus(Integer httpStatus) {
         this.httpStatus = httpStatus;
     }
 
+    /**
+     * HTTP status code to use to abort the Http request.
+     */
     @JsonProperty("httpStatus")
     public Integer getHttpStatus() {
         return httpStatus;
     }
 
+    /**
+     * HTTP status code to use to abort the Http request.
+     */
     @JsonProperty("httpStatus")
     public void setHttpStatus(Integer httpStatus) {
         this.httpStatus = httpStatus;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjectionDelay.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjectionDelay.java
index 9aa59619889..ace4a7ec9f9 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjectionDelay.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjectionDelay.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Delay specification is used to inject latency into the request forwarding path. The following example will introduce a 5 second delay in 1 out of every 1000 requests to the "v1" version of the "reviews" service from all pods with label env: prod<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: reviews-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- reviews.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - sourceLabels:<br><p> 	      env: prod<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: reviews.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	  fault:<br><p> 	    delay:<br><p> 	      percentage:<br><p> 	        value: 0.1<br><p> 	      fixedDelay: 5s<br><p> <br><p> ```<br><p> <br><p> The _fixedDelay_ field is used to indicate the amount of delay in seconds. The optional _percentage_ field can be used to only delay a certain percentage of requests. If left unspecified, no request will be delayed.
+ */
 @JsonDeserialize(using = io.fabric8.kubernetes.model.jackson.JsonUnwrappedDeserializer.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -88,32 +91,50 @@ public HTTPFaultInjectionDelay(IsHTTPFaultInjectionDelayHttpDelayType httpDelayT
         this.percentage = percentage;
     }
 
+    /**
+     * Delay specification is used to inject latency into the request forwarding path. The following example will introduce a 5 second delay in 1 out of every 1000 requests to the "v1" version of the "reviews" service from all pods with label env: prod<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: reviews-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- reviews.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - sourceLabels:<br><p> 	      env: prod<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: reviews.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	  fault:<br><p> 	    delay:<br><p> 	      percentage:<br><p> 	        value: 0.1<br><p> 	      fixedDelay: 5s<br><p> <br><p> ```<br><p> <br><p> The _fixedDelay_ field is used to indicate the amount of delay in seconds. The optional _percentage_ field can be used to only delay a certain percentage of requests. If left unspecified, no request will be delayed.
+     */
     @JsonProperty("HttpDelayType")
     @JsonUnwrapped
     public IsHTTPFaultInjectionDelayHttpDelayType getHttpDelayType() {
         return httpDelayType;
     }
 
+    /**
+     * Delay specification is used to inject latency into the request forwarding path. The following example will introduce a 5 second delay in 1 out of every 1000 requests to the "v1" version of the "reviews" service from all pods with label env: prod<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: reviews-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- reviews.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - sourceLabels:<br><p> 	      env: prod<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: reviews.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	  fault:<br><p> 	    delay:<br><p> 	      percentage:<br><p> 	        value: 0.1<br><p> 	      fixedDelay: 5s<br><p> <br><p> ```<br><p> <br><p> The _fixedDelay_ field is used to indicate the amount of delay in seconds. The optional _percentage_ field can be used to only delay a certain percentage of requests. If left unspecified, no request will be delayed.
+     */
     @JsonProperty("HttpDelayType")
     public void setHttpDelayType(IsHTTPFaultInjectionDelayHttpDelayType httpDelayType) {
         this.httpDelayType = httpDelayType;
     }
 
+    /**
+     * Percentage of requests on which the delay will be injected (0-100). Use of integer `percent` value is deprecated. Use the double `percentage` field instead.<br><p> <br><p> Deprecated: Marked as deprecated in networking/v1alpha3/virtual_service.proto.
+     */
     @JsonProperty("percent")
     public Integer getPercent() {
         return percent;
     }
 
+    /**
+     * Percentage of requests on which the delay will be injected (0-100). Use of integer `percent` value is deprecated. Use the double `percentage` field instead.<br><p> <br><p> Deprecated: Marked as deprecated in networking/v1alpha3/virtual_service.proto.
+     */
     @JsonProperty("percent")
     public void setPercent(Integer percent) {
         this.percent = percent;
     }
 
+    /**
+     * Delay specification is used to inject latency into the request forwarding path. The following example will introduce a 5 second delay in 1 out of every 1000 requests to the "v1" version of the "reviews" service from all pods with label env: prod<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: reviews-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- reviews.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - sourceLabels:<br><p> 	      env: prod<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: reviews.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	  fault:<br><p> 	    delay:<br><p> 	      percentage:<br><p> 	        value: 0.1<br><p> 	      fixedDelay: 5s<br><p> <br><p> ```<br><p> <br><p> The _fixedDelay_ field is used to indicate the amount of delay in seconds. The optional _percentage_ field can be used to only delay a certain percentage of requests. If left unspecified, no request will be delayed.
+     */
     @JsonProperty("percentage")
     public Percent getPercentage() {
         return percentage;
     }
 
+    /**
+     * Delay specification is used to inject latency into the request forwarding path. The following example will introduce a 5 second delay in 1 out of every 1000 requests to the "v1" version of the "reviews" service from all pods with label env: prod<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: reviews-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- reviews.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - sourceLabels:<br><p> 	      env: prod<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: reviews.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	  fault:<br><p> 	    delay:<br><p> 	      percentage:<br><p> 	        value: 0.1<br><p> 	      fixedDelay: 5s<br><p> <br><p> ```<br><p> <br><p> The _fixedDelay_ field is used to indicate the amount of delay in seconds. The optional _percentage_ field can be used to only delay a certain percentage of requests. If left unspecified, no request will be delayed.
+     */
     @JsonProperty("percentage")
     public void setPercentage(Percent percentage) {
         this.percentage = percentage;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjectionDelayExponentialDelay.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjectionDelayExponentialDelay.java
index 9751fcc1e41..bc0a9522654 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjectionDelayExponentialDelay.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjectionDelayExponentialDelay.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * $hide_from_docs
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public HTTPFaultInjectionDelayExponentialDelay(String exponentialDelay) {
         this.exponentialDelay = exponentialDelay;
     }
 
+    /**
+     * $hide_from_docs
+     */
     @JsonProperty("exponentialDelay")
     public String getExponentialDelay() {
         return exponentialDelay;
     }
 
+    /**
+     * $hide_from_docs
+     */
     @JsonProperty("exponentialDelay")
     public void setExponentialDelay(String exponentialDelay) {
         this.exponentialDelay = exponentialDelay;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjectionDelayFixedDelay.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjectionDelayFixedDelay.java
index c20b21f62e7..00bef2b82ef 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjectionDelayFixedDelay.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPFaultInjectionDelayFixedDelay.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Add a fixed delay before forwarding the request. Format: 1h/1m/1s/1ms. MUST be &gt;=1ms.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public HTTPFaultInjectionDelayFixedDelay(String fixedDelay) {
         this.fixedDelay = fixedDelay;
     }
 
+    /**
+     * Add a fixed delay before forwarding the request. Format: 1h/1m/1s/1ms. MUST be &gt;=1ms.
+     */
     @JsonProperty("fixedDelay")
     public String getFixedDelay() {
         return fixedDelay;
     }
 
+    /**
+     * Add a fixed delay before forwarding the request. Format: 1h/1m/1s/1ms. MUST be &gt;=1ms.
+     */
     @JsonProperty("fixedDelay")
     public void setFixedDelay(String fixedDelay) {
         this.fixedDelay = fixedDelay;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPHeader.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPHeader.java
index d46220b8dd7..7387c4c0208 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPHeader.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPHeader.java
@@ -82,21 +82,33 @@ public HTTPHeader(String name, String value) {
         this.value = value;
     }
 
+    /**
+     * The header field name
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The header field name
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * The header field value
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * The header field value
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPHealthCheckConfig.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPHealthCheckConfig.java
index ec8b8675dc2..46b1e4a5f77 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPHealthCheckConfig.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPHealthCheckConfig.java
@@ -97,52 +97,82 @@ public HTTPHealthCheckConfig(String host, List<HTTPHeader> httpHeaders, String p
         this.scheme = scheme;
     }
 
+    /**
+     * Host name to connect to, defaults to the pod IP. You probably want to set "Host" in httpHeaders instead.
+     */
     @JsonProperty("host")
     public String getHost() {
         return host;
     }
 
+    /**
+     * Host name to connect to, defaults to the pod IP. You probably want to set "Host" in httpHeaders instead.
+     */
     @JsonProperty("host")
     public void setHost(String host) {
         this.host = host;
     }
 
+    /**
+     * Headers the proxy will pass on to make the request. Allows repeated headers.
+     */
     @JsonProperty("httpHeaders")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HTTPHeader> getHttpHeaders() {
         return httpHeaders;
     }
 
+    /**
+     * Headers the proxy will pass on to make the request. Allows repeated headers.
+     */
     @JsonProperty("httpHeaders")
     public void setHttpHeaders(List<HTTPHeader> httpHeaders) {
         this.httpHeaders = httpHeaders;
     }
 
+    /**
+     * Path to access on the HTTP server.
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Path to access on the HTTP server.
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * Port on which the endpoint lives.
+     */
     @JsonProperty("port")
     public Long getPort() {
         return port;
     }
 
+    /**
+     * Port on which the endpoint lives.
+     */
     @JsonProperty("port")
     public void setPort(Long port) {
         this.port = port;
     }
 
+    /**
+     * HTTP or HTTPS, defaults to HTTP
+     */
     @JsonProperty("scheme")
     public String getScheme() {
         return scheme;
     }
 
+    /**
+     * HTTP or HTTPS, defaults to HTTP
+     */
     @JsonProperty("scheme")
     public void setScheme(String scheme) {
         this.scheme = scheme;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPMatchRequest.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPMatchRequest.java
index 974ad9d26d3..cbc193f67b8 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPMatchRequest.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPMatchRequest.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HttpMatchRequest specifies a set of criteria to be met in order for the rule to be applied to the HTTP request. For example, the following restricts the rule to match only requests where the URL path starts with /ratings/v2/ and the request contains a custom `end-user` header with value `jason`.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - headers:<br><p> 	      end-user:<br><p> 	        exact: jason<br><p> 	    uri:<br><p> 	      prefix: "/ratings/v2/"<br><p> 	    ignoreUriCase: true<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> <br><p> ```<br><p> <br><p> HTTPMatchRequest CANNOT be empty. &#42;&#42;Note:&#42;&#42; 1. If a root VirtualService have matched any property (path, header etc.) by regex, delegate VirtualServices should not have any other matches on the same property. 2. If a delegate VirtualService have matched any property (path, header etc.) by regex, root VirtualServices should not have any other matches on the same property.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -137,146 +140,230 @@ public HTTPMatchRequest(StringMatch authority, List<String> gateways, Map<String
         this.withoutHeaders = withoutHeaders;
     }
 
+    /**
+     * HttpMatchRequest specifies a set of criteria to be met in order for the rule to be applied to the HTTP request. For example, the following restricts the rule to match only requests where the URL path starts with /ratings/v2/ and the request contains a custom `end-user` header with value `jason`.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - headers:<br><p> 	      end-user:<br><p> 	        exact: jason<br><p> 	    uri:<br><p> 	      prefix: "/ratings/v2/"<br><p> 	    ignoreUriCase: true<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> <br><p> ```<br><p> <br><p> HTTPMatchRequest CANNOT be empty. &#42;&#42;Note:&#42;&#42; 1. If a root VirtualService have matched any property (path, header etc.) by regex, delegate VirtualServices should not have any other matches on the same property. 2. If a delegate VirtualService have matched any property (path, header etc.) by regex, root VirtualServices should not have any other matches on the same property.
+     */
     @JsonProperty("authority")
     public StringMatch getAuthority() {
         return authority;
     }
 
+    /**
+     * HttpMatchRequest specifies a set of criteria to be met in order for the rule to be applied to the HTTP request. For example, the following restricts the rule to match only requests where the URL path starts with /ratings/v2/ and the request contains a custom `end-user` header with value `jason`.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - headers:<br><p> 	      end-user:<br><p> 	        exact: jason<br><p> 	    uri:<br><p> 	      prefix: "/ratings/v2/"<br><p> 	    ignoreUriCase: true<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> <br><p> ```<br><p> <br><p> HTTPMatchRequest CANNOT be empty. &#42;&#42;Note:&#42;&#42; 1. If a root VirtualService have matched any property (path, header etc.) by regex, delegate VirtualServices should not have any other matches on the same property. 2. If a delegate VirtualService have matched any property (path, header etc.) by regex, root VirtualServices should not have any other matches on the same property.
+     */
     @JsonProperty("authority")
     public void setAuthority(StringMatch authority) {
         this.authority = authority;
     }
 
+    /**
+     * Names of gateways where the rule should be applied. Gateway names in the top-level `gateways` field of the VirtualService (if any) are overridden. The gateway match is independent of sourceLabels.
+     */
     @JsonProperty("gateways")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getGateways() {
         return gateways;
     }
 
+    /**
+     * Names of gateways where the rule should be applied. Gateway names in the top-level `gateways` field of the VirtualService (if any) are overridden. The gateway match is independent of sourceLabels.
+     */
     @JsonProperty("gateways")
     public void setGateways(List<String> gateways) {
         this.gateways = gateways;
     }
 
+    /**
+     * The header keys must be lowercase and use hyphen as the separator, e.g. _x-request-id_.<br><p> <br><p> Header values are case-sensitive and formatted as follows:<br><p> <br><p> - `exact: "value"` for exact string match<br><p> <br><p> - `prefix: "value"` for prefix-based match<br><p> <br><p> - `regex: "value"` for [RE2 style regex-based match](https://github.com/google/re2/wiki/Syntax).<br><p> <br><p> If the value is empty and only the name of header is specified, presence of the header is checked. To provide an empty value, use `{}`, for example:<br><p> <br><p> ```<br><p>   - match:<br><p>   - headers:<br><p>     myheader: {}<br><p> <br><p> ``` &#42;&#42;Note:&#42;&#42; The keys `uri`, `scheme`, `method`, and `authority` will be ignored.
+     */
     @JsonProperty("headers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, StringMatch> getHeaders() {
         return headers;
     }
 
+    /**
+     * The header keys must be lowercase and use hyphen as the separator, e.g. _x-request-id_.<br><p> <br><p> Header values are case-sensitive and formatted as follows:<br><p> <br><p> - `exact: "value"` for exact string match<br><p> <br><p> - `prefix: "value"` for prefix-based match<br><p> <br><p> - `regex: "value"` for [RE2 style regex-based match](https://github.com/google/re2/wiki/Syntax).<br><p> <br><p> If the value is empty and only the name of header is specified, presence of the header is checked. To provide an empty value, use `{}`, for example:<br><p> <br><p> ```<br><p>   - match:<br><p>   - headers:<br><p>     myheader: {}<br><p> <br><p> ``` &#42;&#42;Note:&#42;&#42; The keys `uri`, `scheme`, `method`, and `authority` will be ignored.
+     */
     @JsonProperty("headers")
     public void setHeaders(Map<String, StringMatch> headers) {
         this.headers = headers;
     }
 
+    /**
+     * Flag to specify whether the URI matching should be case-insensitive.<br><p> <br><p> &#42;&#42;Note:&#42;&#42; The case will be ignored only in the case of `exact` and `prefix` URI matches.
+     */
     @JsonProperty("ignoreUriCase")
     public Boolean getIgnoreUriCase() {
         return ignoreUriCase;
     }
 
+    /**
+     * Flag to specify whether the URI matching should be case-insensitive.<br><p> <br><p> &#42;&#42;Note:&#42;&#42; The case will be ignored only in the case of `exact` and `prefix` URI matches.
+     */
     @JsonProperty("ignoreUriCase")
     public void setIgnoreUriCase(Boolean ignoreUriCase) {
         this.ignoreUriCase = ignoreUriCase;
     }
 
+    /**
+     * HttpMatchRequest specifies a set of criteria to be met in order for the rule to be applied to the HTTP request. For example, the following restricts the rule to match only requests where the URL path starts with /ratings/v2/ and the request contains a custom `end-user` header with value `jason`.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - headers:<br><p> 	      end-user:<br><p> 	        exact: jason<br><p> 	    uri:<br><p> 	      prefix: "/ratings/v2/"<br><p> 	    ignoreUriCase: true<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> <br><p> ```<br><p> <br><p> HTTPMatchRequest CANNOT be empty. &#42;&#42;Note:&#42;&#42; 1. If a root VirtualService have matched any property (path, header etc.) by regex, delegate VirtualServices should not have any other matches on the same property. 2. If a delegate VirtualService have matched any property (path, header etc.) by regex, root VirtualServices should not have any other matches on the same property.
+     */
     @JsonProperty("method")
     public StringMatch getMethod() {
         return method;
     }
 
+    /**
+     * HttpMatchRequest specifies a set of criteria to be met in order for the rule to be applied to the HTTP request. For example, the following restricts the rule to match only requests where the URL path starts with /ratings/v2/ and the request contains a custom `end-user` header with value `jason`.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - headers:<br><p> 	      end-user:<br><p> 	        exact: jason<br><p> 	    uri:<br><p> 	      prefix: "/ratings/v2/"<br><p> 	    ignoreUriCase: true<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> <br><p> ```<br><p> <br><p> HTTPMatchRequest CANNOT be empty. &#42;&#42;Note:&#42;&#42; 1. If a root VirtualService have matched any property (path, header etc.) by regex, delegate VirtualServices should not have any other matches on the same property. 2. If a delegate VirtualService have matched any property (path, header etc.) by regex, root VirtualServices should not have any other matches on the same property.
+     */
     @JsonProperty("method")
     public void setMethod(StringMatch method) {
         this.method = method;
     }
 
+    /**
+     * The name assigned to a match. The match's name will be concatenated with the parent route's name and will be logged in the access logs for requests matching this route.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The name assigned to a match. The match's name will be concatenated with the parent route's name and will be logged in the access logs for requests matching this route.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Specifies the ports on the host that is being addressed. Many services only expose a single port or label ports with the protocols they support, in these cases it is not required to explicitly select the port.
+     */
     @JsonProperty("port")
     public Long getPort() {
         return port;
     }
 
+    /**
+     * Specifies the ports on the host that is being addressed. Many services only expose a single port or label ports with the protocols they support, in these cases it is not required to explicitly select the port.
+     */
     @JsonProperty("port")
     public void setPort(Long port) {
         this.port = port;
     }
 
+    /**
+     * Query parameters for matching.<br><p> <br><p> Ex:<br><p> <br><p>   - For a query parameter like "?key=true", the map key would be "key" and<br><p>     the string match could be defined as `exact: "true"`.<br><p> <br><p>   - For a query parameter like "?key", the map key would be "key" and the<br><p>     string match could be defined as `exact: ""`.<br><p> <br><p>   - For a query parameter like "?key=abc" or "?key=abx", the map key would be "key" and the<br><p>     string match could be defined as `prefix: "ab"`.<br><p> <br><p>   - For a query parameter like "?key=123", the map key would be "key" and the<br><p>     string match could be defined as `regex: "\d+$"`. Note that this<br><p>     configuration will only match values like "123" but not "a123" or "123a".
+     */
     @JsonProperty("queryParams")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, StringMatch> getQueryParams() {
         return queryParams;
     }
 
+    /**
+     * Query parameters for matching.<br><p> <br><p> Ex:<br><p> <br><p>   - For a query parameter like "?key=true", the map key would be "key" and<br><p>     the string match could be defined as `exact: "true"`.<br><p> <br><p>   - For a query parameter like "?key", the map key would be "key" and the<br><p>     string match could be defined as `exact: ""`.<br><p> <br><p>   - For a query parameter like "?key=abc" or "?key=abx", the map key would be "key" and the<br><p>     string match could be defined as `prefix: "ab"`.<br><p> <br><p>   - For a query parameter like "?key=123", the map key would be "key" and the<br><p>     string match could be defined as `regex: "\d+$"`. Note that this<br><p>     configuration will only match values like "123" but not "a123" or "123a".
+     */
     @JsonProperty("queryParams")
     public void setQueryParams(Map<String, StringMatch> queryParams) {
         this.queryParams = queryParams;
     }
 
+    /**
+     * HttpMatchRequest specifies a set of criteria to be met in order for the rule to be applied to the HTTP request. For example, the following restricts the rule to match only requests where the URL path starts with /ratings/v2/ and the request contains a custom `end-user` header with value `jason`.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - headers:<br><p> 	      end-user:<br><p> 	        exact: jason<br><p> 	    uri:<br><p> 	      prefix: "/ratings/v2/"<br><p> 	    ignoreUriCase: true<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> <br><p> ```<br><p> <br><p> HTTPMatchRequest CANNOT be empty. &#42;&#42;Note:&#42;&#42; 1. If a root VirtualService have matched any property (path, header etc.) by regex, delegate VirtualServices should not have any other matches on the same property. 2. If a delegate VirtualService have matched any property (path, header etc.) by regex, root VirtualServices should not have any other matches on the same property.
+     */
     @JsonProperty("scheme")
     public StringMatch getScheme() {
         return scheme;
     }
 
+    /**
+     * HttpMatchRequest specifies a set of criteria to be met in order for the rule to be applied to the HTTP request. For example, the following restricts the rule to match only requests where the URL path starts with /ratings/v2/ and the request contains a custom `end-user` header with value `jason`.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - headers:<br><p> 	      end-user:<br><p> 	        exact: jason<br><p> 	    uri:<br><p> 	      prefix: "/ratings/v2/"<br><p> 	    ignoreUriCase: true<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> <br><p> ```<br><p> <br><p> HTTPMatchRequest CANNOT be empty. &#42;&#42;Note:&#42;&#42; 1. If a root VirtualService have matched any property (path, header etc.) by regex, delegate VirtualServices should not have any other matches on the same property. 2. If a delegate VirtualService have matched any property (path, header etc.) by regex, root VirtualServices should not have any other matches on the same property.
+     */
     @JsonProperty("scheme")
     public void setScheme(StringMatch scheme) {
         this.scheme = scheme;
     }
 
+    /**
+     * One or more labels that constrain the applicability of a rule to source (client) workloads with the given labels. If the VirtualService has a list of gateways specified in the top-level `gateways` field, it must include the reserved gateway `mesh` for this field to be applicable.
+     */
     @JsonProperty("sourceLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getSourceLabels() {
         return sourceLabels;
     }
 
+    /**
+     * One or more labels that constrain the applicability of a rule to source (client) workloads with the given labels. If the VirtualService has a list of gateways specified in the top-level `gateways` field, it must include the reserved gateway `mesh` for this field to be applicable.
+     */
     @JsonProperty("sourceLabels")
     public void setSourceLabels(Map<String, String> sourceLabels) {
         this.sourceLabels = sourceLabels;
     }
 
+    /**
+     * Source namespace constraining the applicability of a rule to workloads in that namespace. If the VirtualService has a list of gateways specified in the top-level `gateways` field, it must include the reserved gateway `mesh` for this field to be applicable.
+     */
     @JsonProperty("sourceNamespace")
     public String getSourceNamespace() {
         return sourceNamespace;
     }
 
+    /**
+     * Source namespace constraining the applicability of a rule to workloads in that namespace. If the VirtualService has a list of gateways specified in the top-level `gateways` field, it must include the reserved gateway `mesh` for this field to be applicable.
+     */
     @JsonProperty("sourceNamespace")
     public void setSourceNamespace(String sourceNamespace) {
         this.sourceNamespace = sourceNamespace;
     }
 
+    /**
+     * The human readable prefix to use when emitting statistics for this route. The statistics are generated with prefix route.&lt;stat_prefix&gt;. This should be set for highly critical routes that one wishes to get "per-route" statistics on. This prefix is only for proxy-level statistics (envoy_&#42;) and not service-level (istio_&#42;) statistics. Refer to https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/route/v3/route_components.proto#envoy-v3-api-field-config-route-v3-route-stat-prefix for statistics that are generated when this is configured.
+     */
     @JsonProperty("statPrefix")
     public String getStatPrefix() {
         return statPrefix;
     }
 
+    /**
+     * The human readable prefix to use when emitting statistics for this route. The statistics are generated with prefix route.&lt;stat_prefix&gt;. This should be set for highly critical routes that one wishes to get "per-route" statistics on. This prefix is only for proxy-level statistics (envoy_&#42;) and not service-level (istio_&#42;) statistics. Refer to https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/route/v3/route_components.proto#envoy-v3-api-field-config-route-v3-route-stat-prefix for statistics that are generated when this is configured.
+     */
     @JsonProperty("statPrefix")
     public void setStatPrefix(String statPrefix) {
         this.statPrefix = statPrefix;
     }
 
+    /**
+     * HttpMatchRequest specifies a set of criteria to be met in order for the rule to be applied to the HTTP request. For example, the following restricts the rule to match only requests where the URL path starts with /ratings/v2/ and the request contains a custom `end-user` header with value `jason`.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - headers:<br><p> 	      end-user:<br><p> 	        exact: jason<br><p> 	    uri:<br><p> 	      prefix: "/ratings/v2/"<br><p> 	    ignoreUriCase: true<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> <br><p> ```<br><p> <br><p> HTTPMatchRequest CANNOT be empty. &#42;&#42;Note:&#42;&#42; 1. If a root VirtualService have matched any property (path, header etc.) by regex, delegate VirtualServices should not have any other matches on the same property. 2. If a delegate VirtualService have matched any property (path, header etc.) by regex, root VirtualServices should not have any other matches on the same property.
+     */
     @JsonProperty("uri")
     public StringMatch getUri() {
         return uri;
     }
 
+    /**
+     * HttpMatchRequest specifies a set of criteria to be met in order for the rule to be applied to the HTTP request. For example, the following restricts the rule to match only requests where the URL path starts with /ratings/v2/ and the request contains a custom `end-user` header with value `jason`.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - headers:<br><p> 	      end-user:<br><p> 	        exact: jason<br><p> 	    uri:<br><p> 	      prefix: "/ratings/v2/"<br><p> 	    ignoreUriCase: true<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> <br><p> ```<br><p> <br><p> HTTPMatchRequest CANNOT be empty. &#42;&#42;Note:&#42;&#42; 1. If a root VirtualService have matched any property (path, header etc.) by regex, delegate VirtualServices should not have any other matches on the same property. 2. If a delegate VirtualService have matched any property (path, header etc.) by regex, root VirtualServices should not have any other matches on the same property.
+     */
     @JsonProperty("uri")
     public void setUri(StringMatch uri) {
         this.uri = uri;
     }
 
+    /**
+     * withoutHeader has the same syntax with the header, but has opposite meaning. If a header is matched with a matching rule among withoutHeader, the traffic becomes not matched one.
+     */
     @JsonProperty("withoutHeaders")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, StringMatch> getWithoutHeaders() {
         return withoutHeaders;
     }
 
+    /**
+     * withoutHeader has the same syntax with the header, but has opposite meaning. If a header is matched with a matching rule among withoutHeader, the traffic becomes not matched one.
+     */
     @JsonProperty("withoutHeaders")
     public void setWithoutHeaders(Map<String, StringMatch> withoutHeaders) {
         this.withoutHeaders = withoutHeaders;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPMirrorPolicy.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPMirrorPolicy.java
index d123d946e76..196532d8321 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPMirrorPolicy.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPMirrorPolicy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPMirrorPolicy can be used to specify the destinations to mirror HTTP traffic in addition to the original destination. Mirrored traffic is on a best effort basis where the sidecar/gateway will not wait for the mirrored destinations to respond before returning the response from the original destination. Statistics will be generated for the mirrored destination.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public HTTPMirrorPolicy(Destination destination, Percent percentage) {
         this.percentage = percentage;
     }
 
+    /**
+     * HTTPMirrorPolicy can be used to specify the destinations to mirror HTTP traffic in addition to the original destination. Mirrored traffic is on a best effort basis where the sidecar/gateway will not wait for the mirrored destinations to respond before returning the response from the original destination. Statistics will be generated for the mirrored destination.
+     */
     @JsonProperty("destination")
     public Destination getDestination() {
         return destination;
     }
 
+    /**
+     * HTTPMirrorPolicy can be used to specify the destinations to mirror HTTP traffic in addition to the original destination. Mirrored traffic is on a best effort basis where the sidecar/gateway will not wait for the mirrored destinations to respond before returning the response from the original destination. Statistics will be generated for the mirrored destination.
+     */
     @JsonProperty("destination")
     public void setDestination(Destination destination) {
         this.destination = destination;
     }
 
+    /**
+     * HTTPMirrorPolicy can be used to specify the destinations to mirror HTTP traffic in addition to the original destination. Mirrored traffic is on a best effort basis where the sidecar/gateway will not wait for the mirrored destinations to respond before returning the response from the original destination. Statistics will be generated for the mirrored destination.
+     */
     @JsonProperty("percentage")
     public Percent getPercentage() {
         return percentage;
     }
 
+    /**
+     * HTTPMirrorPolicy can be used to specify the destinations to mirror HTTP traffic in addition to the original destination. Mirrored traffic is on a best effort basis where the sidecar/gateway will not wait for the mirrored destinations to respond before returning the response from the original destination. Statistics will be generated for the mirrored destination.
+     */
     @JsonProperty("percentage")
     public void setPercentage(Percent percentage) {
         this.percentage = percentage;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPRedirect.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPRedirect.java
index 5dfb8e2dc25..0984c3ba713 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPRedirect.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPRedirect.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPRedirect can be used to send a 301 redirect response to the caller, where the Authority/Host and the URI in the response can be swapped with the specified values. For example, the following rule redirects requests for /v1/getProductRatings API on the ratings service to /v1/bookRatings provided by the bookratings service.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - uri:<br><p> 	      exact: /v1/getProductRatings<br><p> 	  redirect:<br><p> 	    uri: /v1/bookRatings<br><p> 	    authority: newratings.default.svc.cluster.local<br><p> 	...<br><p> <br><p> ```
+ */
 @JsonDeserialize(using = io.fabric8.kubernetes.model.jackson.JsonUnwrappedDeserializer.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -96,52 +99,82 @@ public HTTPRedirect(IsHTTPRedirectRedirectPort redirectPort, String authority, L
         this.uri = uri;
     }
 
+    /**
+     * HTTPRedirect can be used to send a 301 redirect response to the caller, where the Authority/Host and the URI in the response can be swapped with the specified values. For example, the following rule redirects requests for /v1/getProductRatings API on the ratings service to /v1/bookRatings provided by the bookratings service.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - uri:<br><p> 	      exact: /v1/getProductRatings<br><p> 	  redirect:<br><p> 	    uri: /v1/bookRatings<br><p> 	    authority: newratings.default.svc.cluster.local<br><p> 	...<br><p> <br><p> ```
+     */
     @JsonProperty("RedirectPort")
     @JsonUnwrapped
     public IsHTTPRedirectRedirectPort getRedirectPort() {
         return redirectPort;
     }
 
+    /**
+     * HTTPRedirect can be used to send a 301 redirect response to the caller, where the Authority/Host and the URI in the response can be swapped with the specified values. For example, the following rule redirects requests for /v1/getProductRatings API on the ratings service to /v1/bookRatings provided by the bookratings service.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - uri:<br><p> 	      exact: /v1/getProductRatings<br><p> 	  redirect:<br><p> 	    uri: /v1/bookRatings<br><p> 	    authority: newratings.default.svc.cluster.local<br><p> 	...<br><p> <br><p> ```
+     */
     @JsonProperty("RedirectPort")
     public void setRedirectPort(IsHTTPRedirectRedirectPort redirectPort) {
         this.redirectPort = redirectPort;
     }
 
+    /**
+     * On a redirect, overwrite the Authority/Host portion of the URL with this value.
+     */
     @JsonProperty("authority")
     public String getAuthority() {
         return authority;
     }
 
+    /**
+     * On a redirect, overwrite the Authority/Host portion of the URL with this value.
+     */
     @JsonProperty("authority")
     public void setAuthority(String authority) {
         this.authority = authority;
     }
 
+    /**
+     * On a redirect, Specifies the HTTP status code to use in the redirect response. The default response code is MOVED_PERMANENTLY (301).
+     */
     @JsonProperty("redirectCode")
     public Long getRedirectCode() {
         return redirectCode;
     }
 
+    /**
+     * On a redirect, Specifies the HTTP status code to use in the redirect response. The default response code is MOVED_PERMANENTLY (301).
+     */
     @JsonProperty("redirectCode")
     public void setRedirectCode(Long redirectCode) {
         this.redirectCode = redirectCode;
     }
 
+    /**
+     * On a redirect, overwrite the scheme portion of the URL with this value. For example, `http` or `https`. If unset, the original scheme will be used. If `derivePort` is set to `FROM_PROTOCOL_DEFAULT`, this will impact the port used as well
+     */
     @JsonProperty("scheme")
     public String getScheme() {
         return scheme;
     }
 
+    /**
+     * On a redirect, overwrite the scheme portion of the URL with this value. For example, `http` or `https`. If unset, the original scheme will be used. If `derivePort` is set to `FROM_PROTOCOL_DEFAULT`, this will impact the port used as well
+     */
     @JsonProperty("scheme")
     public void setScheme(String scheme) {
         this.scheme = scheme;
     }
 
+    /**
+     * On a redirect, overwrite the Path portion of the URL with this value. Note that the entire path will be replaced, irrespective of the request URI being matched as an exact path or prefix.
+     */
     @JsonProperty("uri")
     public String getUri() {
         return uri;
     }
 
+    /**
+     * On a redirect, overwrite the Path portion of the URL with this value. Note that the entire path will be replaced, irrespective of the request URI being matched as an exact path or prefix.
+     */
     @JsonProperty("uri")
     public void setUri(String uri) {
         this.uri = uri;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPRedirectDerivePort.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPRedirectDerivePort.java
index 11e52a12db6..741e3975987 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPRedirectDerivePort.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPRedirectDerivePort.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * On a redirect, dynamically set the port: &#42; FROM_PROTOCOL_DEFAULT: automatically set to 80 for HTTP and 443 for HTTPS. &#42; FROM_REQUEST_PORT: automatically use the port of the request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public HTTPRedirectDerivePort(HTTPRedirectRedirectPortSelection derivePort) {
         this.derivePort = derivePort;
     }
 
+    /**
+     * On a redirect, dynamically set the port: &#42; FROM_PROTOCOL_DEFAULT: automatically set to 80 for HTTP and 443 for HTTPS. &#42; FROM_REQUEST_PORT: automatically use the port of the request.
+     */
     @JsonProperty("derivePort")
     public HTTPRedirectRedirectPortSelection getDerivePort() {
         return derivePort;
     }
 
+    /**
+     * On a redirect, dynamically set the port: &#42; FROM_PROTOCOL_DEFAULT: automatically set to 80 for HTTP and 443 for HTTPS. &#42; FROM_REQUEST_PORT: automatically use the port of the request.
+     */
     @JsonProperty("derivePort")
     public void setDerivePort(HTTPRedirectRedirectPortSelection derivePort) {
         this.derivePort = derivePort;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPRedirectPort.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPRedirectPort.java
index b0f7b5c4a7c..cd9eb367101 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPRedirectPort.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPRedirectPort.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * On a redirect, overwrite the port portion of the URL with this value.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public HTTPRedirectPort(Long port) {
         this.port = port;
     }
 
+    /**
+     * On a redirect, overwrite the port portion of the URL with this value.
+     */
     @JsonProperty("port")
     public Long getPort() {
         return port;
     }
 
+    /**
+     * On a redirect, overwrite the port portion of the URL with this value.
+     */
     @JsonProperty("port")
     public void setPort(Long port) {
         this.port = port;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPRetry.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPRetry.java
index ccc3f4d2c8b..5d40928b21b 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPRetry.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPRetry.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Describes the retry policy to use when a HTTP request fails. For example, the following rule sets the maximum number of retries to 3 when calling ratings:v1 service, with a 2s timeout per retry attempt. A retry will be attempted if there is a connect-failure, refused_stream or when the upstream server responds with Service Unavailable(503).<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	  retries:<br><p> 	    attempts: 3<br><p> 	    perTryTimeout: 2s<br><p> 	    retryOn: gateway-error,connect-failure,refused-stream<br><p> <br><p> ```
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public HTTPRetry(Integer attempts, String perTryTimeout, String retryOn, Boolean
         this.retryRemoteLocalities = retryRemoteLocalities;
     }
 
+    /**
+     * Number of retries to be allowed for a given request. The interval between retries will be determined automatically (25ms+). When request `timeout` of the [HTTP route](https://istio.io/docs/reference/config/networking/virtual-service/#HTTPRoute) or `per_try_timeout` is configured, the actual number of retries attempted also depends on the specified request `timeout` and `per_try_timeout` values. MUST BE &gt;= 0. If `0`, retries will be disabled. The maximum possible number of requests made will be 1 + `attempts`.
+     */
     @JsonProperty("attempts")
     public Integer getAttempts() {
         return attempts;
     }
 
+    /**
+     * Number of retries to be allowed for a given request. The interval between retries will be determined automatically (25ms+). When request `timeout` of the [HTTP route](https://istio.io/docs/reference/config/networking/virtual-service/#HTTPRoute) or `per_try_timeout` is configured, the actual number of retries attempted also depends on the specified request `timeout` and `per_try_timeout` values. MUST BE &gt;= 0. If `0`, retries will be disabled. The maximum possible number of requests made will be 1 + `attempts`.
+     */
     @JsonProperty("attempts")
     public void setAttempts(Integer attempts) {
         this.attempts = attempts;
     }
 
+    /**
+     * Describes the retry policy to use when a HTTP request fails. For example, the following rule sets the maximum number of retries to 3 when calling ratings:v1 service, with a 2s timeout per retry attempt. A retry will be attempted if there is a connect-failure, refused_stream or when the upstream server responds with Service Unavailable(503).<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	  retries:<br><p> 	    attempts: 3<br><p> 	    perTryTimeout: 2s<br><p> 	    retryOn: gateway-error,connect-failure,refused-stream<br><p> <br><p> ```
+     */
     @JsonProperty("perTryTimeout")
     public String getPerTryTimeout() {
         return perTryTimeout;
     }
 
+    /**
+     * Describes the retry policy to use when a HTTP request fails. For example, the following rule sets the maximum number of retries to 3 when calling ratings:v1 service, with a 2s timeout per retry attempt. A retry will be attempted if there is a connect-failure, refused_stream or when the upstream server responds with Service Unavailable(503).<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	  retries:<br><p> 	    attempts: 3<br><p> 	    perTryTimeout: 2s<br><p> 	    retryOn: gateway-error,connect-failure,refused-stream<br><p> <br><p> ```
+     */
     @JsonProperty("perTryTimeout")
     public void setPerTryTimeout(String perTryTimeout) {
         this.perTryTimeout = perTryTimeout;
     }
 
+    /**
+     * Specifies the conditions under which retry takes place. One or more policies can be specified using a ‘,’ delimited list. See the [retry policies](https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_filters/router_filter#x-envoy-retry-on) and [gRPC retry policies](https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_filters/router_filter#x-envoy-retry-grpc-on) for more details.<br><p> <br><p> In addition to the policies specified above, a list of HTTP status codes can be passed, such as `retryOn: "503,reset"`. Note these status codes refer to the actual responses received from the destination. For example, if a connection is reset, Istio will translate this to 503 for it's response. However, the destination did not return a 503 error, so this would not match `"503"` (it would, however, match `"reset"`).<br><p> <br><p> If not specified, this defaults to `connect-failure,refused-stream,unavailable,cancelled,503`.
+     */
     @JsonProperty("retryOn")
     public String getRetryOn() {
         return retryOn;
     }
 
+    /**
+     * Specifies the conditions under which retry takes place. One or more policies can be specified using a ‘,’ delimited list. See the [retry policies](https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_filters/router_filter#x-envoy-retry-on) and [gRPC retry policies](https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_filters/router_filter#x-envoy-retry-grpc-on) for more details.<br><p> <br><p> In addition to the policies specified above, a list of HTTP status codes can be passed, such as `retryOn: "503,reset"`. Note these status codes refer to the actual responses received from the destination. For example, if a connection is reset, Istio will translate this to 503 for it's response. However, the destination did not return a 503 error, so this would not match `"503"` (it would, however, match `"reset"`).<br><p> <br><p> If not specified, this defaults to `connect-failure,refused-stream,unavailable,cancelled,503`.
+     */
     @JsonProperty("retryOn")
     public void setRetryOn(String retryOn) {
         this.retryOn = retryOn;
     }
 
+    /**
+     * Describes the retry policy to use when a HTTP request fails. For example, the following rule sets the maximum number of retries to 3 when calling ratings:v1 service, with a 2s timeout per retry attempt. A retry will be attempted if there is a connect-failure, refused_stream or when the upstream server responds with Service Unavailable(503).<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	  retries:<br><p> 	    attempts: 3<br><p> 	    perTryTimeout: 2s<br><p> 	    retryOn: gateway-error,connect-failure,refused-stream<br><p> <br><p> ```
+     */
     @JsonProperty("retryRemoteLocalities")
     public Boolean getRetryRemoteLocalities() {
         return retryRemoteLocalities;
     }
 
+    /**
+     * Describes the retry policy to use when a HTTP request fails. For example, the following rule sets the maximum number of retries to 3 when calling ratings:v1 service, with a 2s timeout per retry attempt. A retry will be attempted if there is a connect-failure, refused_stream or when the upstream server responds with Service Unavailable(503).<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	  retries:<br><p> 	    attempts: 3<br><p> 	    perTryTimeout: 2s<br><p> 	    retryOn: gateway-error,connect-failure,refused-stream<br><p> <br><p> ```
+     */
     @JsonProperty("retryRemoteLocalities")
     public void setRetryRemoteLocalities(Boolean retryRemoteLocalities) {
         this.retryRemoteLocalities = retryRemoteLocalities;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPRewrite.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPRewrite.java
index 96ec346c5f1..3420e93dc8a 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPRewrite.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPRewrite.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPRewrite can be used to rewrite specific parts of a HTTP request before forwarding the request to the destination. Rewrite primitive can be used only with HTTPRouteDestination. The following example demonstrates how to rewrite the URL prefix for api call (/ratings) to ratings service before making the actual API call.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - uri:<br><p> 	      prefix: /ratings<br><p> 	  rewrite:<br><p> 	    uri: /v1/bookRatings<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> <br><p> ```
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public HTTPRewrite(String authority, String uri, RegexRewrite uriRegexRewrite) {
         this.uriRegexRewrite = uriRegexRewrite;
     }
 
+    /**
+     * rewrite the Authority/Host header with this value.
+     */
     @JsonProperty("authority")
     public String getAuthority() {
         return authority;
     }
 
+    /**
+     * rewrite the Authority/Host header with this value.
+     */
     @JsonProperty("authority")
     public void setAuthority(String authority) {
         this.authority = authority;
     }
 
+    /**
+     * rewrite the path (or the prefix) portion of the URI with this value. If the original URI was matched based on prefix, the value provided in this field will replace the corresponding matched prefix.
+     */
     @JsonProperty("uri")
     public String getUri() {
         return uri;
     }
 
+    /**
+     * rewrite the path (or the prefix) portion of the URI with this value. If the original URI was matched based on prefix, the value provided in this field will replace the corresponding matched prefix.
+     */
     @JsonProperty("uri")
     public void setUri(String uri) {
         this.uri = uri;
     }
 
+    /**
+     * HTTPRewrite can be used to rewrite specific parts of a HTTP request before forwarding the request to the destination. Rewrite primitive can be used only with HTTPRouteDestination. The following example demonstrates how to rewrite the URL prefix for api call (/ratings) to ratings service before making the actual API call.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - uri:<br><p> 	      prefix: /ratings<br><p> 	  rewrite:<br><p> 	    uri: /v1/bookRatings<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> <br><p> ```
+     */
     @JsonProperty("uriRegexRewrite")
     public RegexRewrite getUriRegexRewrite() {
         return uriRegexRewrite;
     }
 
+    /**
+     * HTTPRewrite can be used to rewrite specific parts of a HTTP request before forwarding the request to the destination. Rewrite primitive can be used only with HTTPRouteDestination. The following example demonstrates how to rewrite the URL prefix for api call (/ratings) to ratings service before making the actual API call.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: ratings-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- ratings.prod.svc.cluster.local<br><p> 	http:<br><p> 	- match:<br><p> 	  - uri:<br><p> 	      prefix: /ratings<br><p> 	  rewrite:<br><p> 	    uri: /v1/bookRatings<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: ratings.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> <br><p> ```
+     */
     @JsonProperty("uriRegexRewrite")
     public void setUriRegexRewrite(RegexRewrite uriRegexRewrite) {
         this.uriRegexRewrite = uriRegexRewrite;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPRoute.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPRoute.java
index 4399b2e1269..a1a5feb24a5 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPRoute.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPRoute.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Describes match conditions and actions for routing HTTP/1.1, HTTP2, and gRPC traffic. See VirtualService for usage examples.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -143,164 +146,260 @@ public HTTPRoute(CorsPolicy corsPolicy, Delegate delegate, HTTPDirectResponse di
         this.timeout = timeout;
     }
 
+    /**
+     * Describes match conditions and actions for routing HTTP/1.1, HTTP2, and gRPC traffic. See VirtualService for usage examples.
+     */
     @JsonProperty("corsPolicy")
     public CorsPolicy getCorsPolicy() {
         return corsPolicy;
     }
 
+    /**
+     * Describes match conditions and actions for routing HTTP/1.1, HTTP2, and gRPC traffic. See VirtualService for usage examples.
+     */
     @JsonProperty("corsPolicy")
     public void setCorsPolicy(CorsPolicy corsPolicy) {
         this.corsPolicy = corsPolicy;
     }
 
+    /**
+     * Describes match conditions and actions for routing HTTP/1.1, HTTP2, and gRPC traffic. See VirtualService for usage examples.
+     */
     @JsonProperty("delegate")
     public Delegate getDelegate() {
         return delegate;
     }
 
+    /**
+     * Describes match conditions and actions for routing HTTP/1.1, HTTP2, and gRPC traffic. See VirtualService for usage examples.
+     */
     @JsonProperty("delegate")
     public void setDelegate(Delegate delegate) {
         this.delegate = delegate;
     }
 
+    /**
+     * Describes match conditions and actions for routing HTTP/1.1, HTTP2, and gRPC traffic. See VirtualService for usage examples.
+     */
     @JsonProperty("directResponse")
     public HTTPDirectResponse getDirectResponse() {
         return directResponse;
     }
 
+    /**
+     * Describes match conditions and actions for routing HTTP/1.1, HTTP2, and gRPC traffic. See VirtualService for usage examples.
+     */
     @JsonProperty("directResponse")
     public void setDirectResponse(HTTPDirectResponse directResponse) {
         this.directResponse = directResponse;
     }
 
+    /**
+     * Describes match conditions and actions for routing HTTP/1.1, HTTP2, and gRPC traffic. See VirtualService for usage examples.
+     */
     @JsonProperty("fault")
     public HTTPFaultInjection getFault() {
         return fault;
     }
 
+    /**
+     * Describes match conditions and actions for routing HTTP/1.1, HTTP2, and gRPC traffic. See VirtualService for usage examples.
+     */
     @JsonProperty("fault")
     public void setFault(HTTPFaultInjection fault) {
         this.fault = fault;
     }
 
+    /**
+     * Describes match conditions and actions for routing HTTP/1.1, HTTP2, and gRPC traffic. See VirtualService for usage examples.
+     */
     @JsonProperty("headers")
     public Headers getHeaders() {
         return headers;
     }
 
+    /**
+     * Describes match conditions and actions for routing HTTP/1.1, HTTP2, and gRPC traffic. See VirtualService for usage examples.
+     */
     @JsonProperty("headers")
     public void setHeaders(Headers headers) {
         this.headers = headers;
     }
 
+    /**
+     * Match conditions to be satisfied for the rule to be activated. All conditions inside a single match block have AND semantics, while the list of match blocks have OR semantics. The rule is matched if any one of the match blocks succeed.
+     */
     @JsonProperty("match")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HTTPMatchRequest> getMatch() {
         return match;
     }
 
+    /**
+     * Match conditions to be satisfied for the rule to be activated. All conditions inside a single match block have AND semantics, while the list of match blocks have OR semantics. The rule is matched if any one of the match blocks succeed.
+     */
     @JsonProperty("match")
     public void setMatch(List<HTTPMatchRequest> match) {
         this.match = match;
     }
 
+    /**
+     * Describes match conditions and actions for routing HTTP/1.1, HTTP2, and gRPC traffic. See VirtualService for usage examples.
+     */
     @JsonProperty("mirror")
     public Destination getMirror() {
         return mirror;
     }
 
+    /**
+     * Describes match conditions and actions for routing HTTP/1.1, HTTP2, and gRPC traffic. See VirtualService for usage examples.
+     */
     @JsonProperty("mirror")
     public void setMirror(Destination mirror) {
         this.mirror = mirror;
     }
 
+    /**
+     * Describes match conditions and actions for routing HTTP/1.1, HTTP2, and gRPC traffic. See VirtualService for usage examples.
+     */
     @JsonProperty("mirrorPercent")
     public Integer getMirrorPercent() {
         return mirrorPercent;
     }
 
+    /**
+     * Describes match conditions and actions for routing HTTP/1.1, HTTP2, and gRPC traffic. See VirtualService for usage examples.
+     */
     @JsonProperty("mirrorPercent")
     public void setMirrorPercent(Integer mirrorPercent) {
         this.mirrorPercent = mirrorPercent;
     }
 
+    /**
+     * Describes match conditions and actions for routing HTTP/1.1, HTTP2, and gRPC traffic. See VirtualService for usage examples.
+     */
     @JsonProperty("mirrorPercentage")
     public Percent getMirrorPercentage() {
         return mirrorPercentage;
     }
 
+    /**
+     * Describes match conditions and actions for routing HTTP/1.1, HTTP2, and gRPC traffic. See VirtualService for usage examples.
+     */
     @JsonProperty("mirrorPercentage")
     public void setMirrorPercentage(Percent mirrorPercentage) {
         this.mirrorPercentage = mirrorPercentage;
     }
 
+    /**
+     * Specifies the destinations to mirror HTTP traffic in addition to the original destination. Mirrored traffic is on a best effort basis where the sidecar/gateway will not wait for the mirrored destinations to respond before returning the response from the original destination. Statistics will be generated for the mirrored destination.
+     */
     @JsonProperty("mirrors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HTTPMirrorPolicy> getMirrors() {
         return mirrors;
     }
 
+    /**
+     * Specifies the destinations to mirror HTTP traffic in addition to the original destination. Mirrored traffic is on a best effort basis where the sidecar/gateway will not wait for the mirrored destinations to respond before returning the response from the original destination. Statistics will be generated for the mirrored destination.
+     */
     @JsonProperty("mirrors")
     public void setMirrors(List<HTTPMirrorPolicy> mirrors) {
         this.mirrors = mirrors;
     }
 
+    /**
+     * The name assigned to the route for debugging purposes. The route's name will be concatenated with the match's name and will be logged in the access logs for requests matching this route/match.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The name assigned to the route for debugging purposes. The route's name will be concatenated with the match's name and will be logged in the access logs for requests matching this route/match.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Describes match conditions and actions for routing HTTP/1.1, HTTP2, and gRPC traffic. See VirtualService for usage examples.
+     */
     @JsonProperty("redirect")
     public HTTPRedirect getRedirect() {
         return redirect;
     }
 
+    /**
+     * Describes match conditions and actions for routing HTTP/1.1, HTTP2, and gRPC traffic. See VirtualService for usage examples.
+     */
     @JsonProperty("redirect")
     public void setRedirect(HTTPRedirect redirect) {
         this.redirect = redirect;
     }
 
+    /**
+     * Describes match conditions and actions for routing HTTP/1.1, HTTP2, and gRPC traffic. See VirtualService for usage examples.
+     */
     @JsonProperty("retries")
     public HTTPRetry getRetries() {
         return retries;
     }
 
+    /**
+     * Describes match conditions and actions for routing HTTP/1.1, HTTP2, and gRPC traffic. See VirtualService for usage examples.
+     */
     @JsonProperty("retries")
     public void setRetries(HTTPRetry retries) {
         this.retries = retries;
     }
 
+    /**
+     * Describes match conditions and actions for routing HTTP/1.1, HTTP2, and gRPC traffic. See VirtualService for usage examples.
+     */
     @JsonProperty("rewrite")
     public HTTPRewrite getRewrite() {
         return rewrite;
     }
 
+    /**
+     * Describes match conditions and actions for routing HTTP/1.1, HTTP2, and gRPC traffic. See VirtualService for usage examples.
+     */
     @JsonProperty("rewrite")
     public void setRewrite(HTTPRewrite rewrite) {
         this.rewrite = rewrite;
     }
 
+    /**
+     * A HTTP rule can either return a direct_response, redirect or forward (default) traffic. The forwarding target can be one of several versions of a service (see glossary in beginning of document). Weights associated with the service version determine the proportion of traffic it receives.
+     */
     @JsonProperty("route")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HTTPRouteDestination> getRoute() {
         return route;
     }
 
+    /**
+     * A HTTP rule can either return a direct_response, redirect or forward (default) traffic. The forwarding target can be one of several versions of a service (see glossary in beginning of document). Weights associated with the service version determine the proportion of traffic it receives.
+     */
     @JsonProperty("route")
     public void setRoute(List<HTTPRouteDestination> route) {
         this.route = route;
     }
 
+    /**
+     * Describes match conditions and actions for routing HTTP/1.1, HTTP2, and gRPC traffic. See VirtualService for usage examples.
+     */
     @JsonProperty("timeout")
     public String getTimeout() {
         return timeout;
     }
 
+    /**
+     * Describes match conditions and actions for routing HTTP/1.1, HTTP2, and gRPC traffic. See VirtualService for usage examples.
+     */
     @JsonProperty("timeout")
     public void setTimeout(String timeout) {
         this.timeout = timeout;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPRouteDestination.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPRouteDestination.java
index 785ee13de48..41ab4ca8edb 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPRouteDestination.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HTTPRouteDestination.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Each routing rule is associated with one or more service versions (see glossary in beginning of document). Weights associated with the version determine the proportion of traffic it receives. For example, the following rule will route 25% of traffic for the "reviews" service to instances with the "v2" tag and the remaining traffic (i.e., 75%) to "v1".<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: reviews-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- reviews.prod.svc.cluster.local<br><p> 	http:<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: reviews.prod.svc.cluster.local<br><p> 	      subset: v2<br><p> 	    weight: 25<br><p> 	  - destination:<br><p> 	      host: reviews.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	    weight: 75<br><p> <br><p> ```<br><p> <br><p> # And the associated DestinationRule<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: reviews-destination<br><p> <br><p> spec:<br><p> <br><p> 	host: reviews.prod.svc.cluster.local<br><p> 	subsets:<br><p> 	- name: v1<br><p> 	  labels:<br><p> 	    version: v1<br><p> 	- name: v2<br><p> 	  labels:<br><p> 	    version: v2<br><p> <br><p> ```<br><p> <br><p> Traffic can also be split across two entirely different services without having to define new subsets. For example, the following rule forwards 25% of traffic to reviews.com to dev.reviews.com<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: reviews-route-two-domains<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- reviews.com<br><p> 	http:<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: dev.reviews.com<br><p> 	    weight: 25<br><p> 	  - destination:<br><p> 	      host: reviews.com<br><p> 	    weight: 75<br><p> <br><p> ```
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public HTTPRouteDestination(Destination destination, Headers headers, Integer we
         this.weight = weight;
     }
 
+    /**
+     * Each routing rule is associated with one or more service versions (see glossary in beginning of document). Weights associated with the version determine the proportion of traffic it receives. For example, the following rule will route 25% of traffic for the "reviews" service to instances with the "v2" tag and the remaining traffic (i.e., 75%) to "v1".<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: reviews-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- reviews.prod.svc.cluster.local<br><p> 	http:<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: reviews.prod.svc.cluster.local<br><p> 	      subset: v2<br><p> 	    weight: 25<br><p> 	  - destination:<br><p> 	      host: reviews.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	    weight: 75<br><p> <br><p> ```<br><p> <br><p> # And the associated DestinationRule<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: reviews-destination<br><p> <br><p> spec:<br><p> <br><p> 	host: reviews.prod.svc.cluster.local<br><p> 	subsets:<br><p> 	- name: v1<br><p> 	  labels:<br><p> 	    version: v1<br><p> 	- name: v2<br><p> 	  labels:<br><p> 	    version: v2<br><p> <br><p> ```<br><p> <br><p> Traffic can also be split across two entirely different services without having to define new subsets. For example, the following rule forwards 25% of traffic to reviews.com to dev.reviews.com<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: reviews-route-two-domains<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- reviews.com<br><p> 	http:<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: dev.reviews.com<br><p> 	    weight: 25<br><p> 	  - destination:<br><p> 	      host: reviews.com<br><p> 	    weight: 75<br><p> <br><p> ```
+     */
     @JsonProperty("destination")
     public Destination getDestination() {
         return destination;
     }
 
+    /**
+     * Each routing rule is associated with one or more service versions (see glossary in beginning of document). Weights associated with the version determine the proportion of traffic it receives. For example, the following rule will route 25% of traffic for the "reviews" service to instances with the "v2" tag and the remaining traffic (i.e., 75%) to "v1".<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: reviews-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- reviews.prod.svc.cluster.local<br><p> 	http:<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: reviews.prod.svc.cluster.local<br><p> 	      subset: v2<br><p> 	    weight: 25<br><p> 	  - destination:<br><p> 	      host: reviews.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	    weight: 75<br><p> <br><p> ```<br><p> <br><p> # And the associated DestinationRule<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: reviews-destination<br><p> <br><p> spec:<br><p> <br><p> 	host: reviews.prod.svc.cluster.local<br><p> 	subsets:<br><p> 	- name: v1<br><p> 	  labels:<br><p> 	    version: v1<br><p> 	- name: v2<br><p> 	  labels:<br><p> 	    version: v2<br><p> <br><p> ```<br><p> <br><p> Traffic can also be split across two entirely different services without having to define new subsets. For example, the following rule forwards 25% of traffic to reviews.com to dev.reviews.com<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: reviews-route-two-domains<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- reviews.com<br><p> 	http:<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: dev.reviews.com<br><p> 	    weight: 25<br><p> 	  - destination:<br><p> 	      host: reviews.com<br><p> 	    weight: 75<br><p> <br><p> ```
+     */
     @JsonProperty("destination")
     public void setDestination(Destination destination) {
         this.destination = destination;
     }
 
+    /**
+     * Each routing rule is associated with one or more service versions (see glossary in beginning of document). Weights associated with the version determine the proportion of traffic it receives. For example, the following rule will route 25% of traffic for the "reviews" service to instances with the "v2" tag and the remaining traffic (i.e., 75%) to "v1".<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: reviews-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- reviews.prod.svc.cluster.local<br><p> 	http:<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: reviews.prod.svc.cluster.local<br><p> 	      subset: v2<br><p> 	    weight: 25<br><p> 	  - destination:<br><p> 	      host: reviews.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	    weight: 75<br><p> <br><p> ```<br><p> <br><p> # And the associated DestinationRule<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: reviews-destination<br><p> <br><p> spec:<br><p> <br><p> 	host: reviews.prod.svc.cluster.local<br><p> 	subsets:<br><p> 	- name: v1<br><p> 	  labels:<br><p> 	    version: v1<br><p> 	- name: v2<br><p> 	  labels:<br><p> 	    version: v2<br><p> <br><p> ```<br><p> <br><p> Traffic can also be split across two entirely different services without having to define new subsets. For example, the following rule forwards 25% of traffic to reviews.com to dev.reviews.com<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: reviews-route-two-domains<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- reviews.com<br><p> 	http:<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: dev.reviews.com<br><p> 	    weight: 25<br><p> 	  - destination:<br><p> 	      host: reviews.com<br><p> 	    weight: 75<br><p> <br><p> ```
+     */
     @JsonProperty("headers")
     public Headers getHeaders() {
         return headers;
     }
 
+    /**
+     * Each routing rule is associated with one or more service versions (see glossary in beginning of document). Weights associated with the version determine the proportion of traffic it receives. For example, the following rule will route 25% of traffic for the "reviews" service to instances with the "v2" tag and the remaining traffic (i.e., 75%) to "v1".<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: reviews-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- reviews.prod.svc.cluster.local<br><p> 	http:<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: reviews.prod.svc.cluster.local<br><p> 	      subset: v2<br><p> 	    weight: 25<br><p> 	  - destination:<br><p> 	      host: reviews.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	    weight: 75<br><p> <br><p> ```<br><p> <br><p> # And the associated DestinationRule<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: reviews-destination<br><p> <br><p> spec:<br><p> <br><p> 	host: reviews.prod.svc.cluster.local<br><p> 	subsets:<br><p> 	- name: v1<br><p> 	  labels:<br><p> 	    version: v1<br><p> 	- name: v2<br><p> 	  labels:<br><p> 	    version: v2<br><p> <br><p> ```<br><p> <br><p> Traffic can also be split across two entirely different services without having to define new subsets. For example, the following rule forwards 25% of traffic to reviews.com to dev.reviews.com<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: reviews-route-two-domains<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- reviews.com<br><p> 	http:<br><p> 	- route:<br><p> 	  - destination:<br><p> 	      host: dev.reviews.com<br><p> 	    weight: 25<br><p> 	  - destination:<br><p> 	      host: reviews.com<br><p> 	    weight: 75<br><p> <br><p> ```
+     */
     @JsonProperty("headers")
     public void setHeaders(Headers headers) {
         this.headers = headers;
     }
 
+    /**
+     * Weight specifies the relative proportion of traffic to be forwarded to the destination. A destination will receive `weight/(sum of all weights)` requests. If there is only one destination in a rule, it will receive all traffic. Otherwise, if weight is `0`, the destination will not receive any traffic.
+     */
     @JsonProperty("weight")
     public Integer getWeight() {
         return weight;
     }
 
+    /**
+     * Weight specifies the relative proportion of traffic to be forwarded to the destination. A destination will receive `weight/(sum of all weights)` requests. If there is only one destination in a rule, it will receive all traffic. Otherwise, if weight is `0`, the destination will not receive any traffic.
+     */
     @JsonProperty("weight")
     public void setWeight(Integer weight) {
         this.weight = weight;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Headers.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Headers.java
index 7db43ab9f5e..579c82e2d72 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Headers.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Headers.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Message headers can be manipulated when Envoy forwards requests to, or responses from, a destination service. Header manipulation rules can be specified for a specific route destination or for all destinations. The following VirtualService adds a `test` header with the value `true` to requests that are routed to any `reviews` service destination. It also removes the `foo` response header, but only from responses coming from the `v1` subset (version) of the `reviews` service.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: reviews-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- reviews.prod.svc.cluster.local<br><p> 	http:<br><p> 	- headers:<br><p> 	    request:<br><p> 	      set:<br><p> 	        test: "true"<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: reviews.prod.svc.cluster.local<br><p> 	      subset: v2<br><p> 	    weight: 25<br><p> 	  - destination:<br><p> 	      host: reviews.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	    headers:<br><p> 	      response:<br><p> 	        remove:<br><p> 	        - foo<br><p> 	    weight: 75<br><p> <br><p> ```
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Headers(HeadersHeaderOperations request, HeadersHeaderOperations response
         this.response = response;
     }
 
+    /**
+     * Message headers can be manipulated when Envoy forwards requests to, or responses from, a destination service. Header manipulation rules can be specified for a specific route destination or for all destinations. The following VirtualService adds a `test` header with the value `true` to requests that are routed to any `reviews` service destination. It also removes the `foo` response header, but only from responses coming from the `v1` subset (version) of the `reviews` service.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: reviews-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- reviews.prod.svc.cluster.local<br><p> 	http:<br><p> 	- headers:<br><p> 	    request:<br><p> 	      set:<br><p> 	        test: "true"<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: reviews.prod.svc.cluster.local<br><p> 	      subset: v2<br><p> 	    weight: 25<br><p> 	  - destination:<br><p> 	      host: reviews.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	    headers:<br><p> 	      response:<br><p> 	        remove:<br><p> 	        - foo<br><p> 	    weight: 75<br><p> <br><p> ```
+     */
     @JsonProperty("request")
     public HeadersHeaderOperations getRequest() {
         return request;
     }
 
+    /**
+     * Message headers can be manipulated when Envoy forwards requests to, or responses from, a destination service. Header manipulation rules can be specified for a specific route destination or for all destinations. The following VirtualService adds a `test` header with the value `true` to requests that are routed to any `reviews` service destination. It also removes the `foo` response header, but only from responses coming from the `v1` subset (version) of the `reviews` service.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: reviews-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- reviews.prod.svc.cluster.local<br><p> 	http:<br><p> 	- headers:<br><p> 	    request:<br><p> 	      set:<br><p> 	        test: "true"<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: reviews.prod.svc.cluster.local<br><p> 	      subset: v2<br><p> 	    weight: 25<br><p> 	  - destination:<br><p> 	      host: reviews.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	    headers:<br><p> 	      response:<br><p> 	        remove:<br><p> 	        - foo<br><p> 	    weight: 75<br><p> <br><p> ```
+     */
     @JsonProperty("request")
     public void setRequest(HeadersHeaderOperations request) {
         this.request = request;
     }
 
+    /**
+     * Message headers can be manipulated when Envoy forwards requests to, or responses from, a destination service. Header manipulation rules can be specified for a specific route destination or for all destinations. The following VirtualService adds a `test` header with the value `true` to requests that are routed to any `reviews` service destination. It also removes the `foo` response header, but only from responses coming from the `v1` subset (version) of the `reviews` service.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: reviews-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- reviews.prod.svc.cluster.local<br><p> 	http:<br><p> 	- headers:<br><p> 	    request:<br><p> 	      set:<br><p> 	        test: "true"<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: reviews.prod.svc.cluster.local<br><p> 	      subset: v2<br><p> 	    weight: 25<br><p> 	  - destination:<br><p> 	      host: reviews.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	    headers:<br><p> 	      response:<br><p> 	        remove:<br><p> 	        - foo<br><p> 	    weight: 75<br><p> <br><p> ```
+     */
     @JsonProperty("response")
     public HeadersHeaderOperations getResponse() {
         return response;
     }
 
+    /**
+     * Message headers can be manipulated when Envoy forwards requests to, or responses from, a destination service. Header manipulation rules can be specified for a specific route destination or for all destinations. The following VirtualService adds a `test` header with the value `true` to requests that are routed to any `reviews` service destination. It also removes the `foo` response header, but only from responses coming from the `v1` subset (version) of the `reviews` service.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: reviews-route<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- reviews.prod.svc.cluster.local<br><p> 	http:<br><p> 	- headers:<br><p> 	    request:<br><p> 	      set:<br><p> 	        test: "true"<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: reviews.prod.svc.cluster.local<br><p> 	      subset: v2<br><p> 	    weight: 25<br><p> 	  - destination:<br><p> 	      host: reviews.prod.svc.cluster.local<br><p> 	      subset: v1<br><p> 	    headers:<br><p> 	      response:<br><p> 	        remove:<br><p> 	        - foo<br><p> 	    weight: 75<br><p> <br><p> ```
+     */
     @JsonProperty("response")
     public void setResponse(HeadersHeaderOperations response) {
         this.response = response;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HeadersHeaderOperations.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HeadersHeaderOperations.java
index bcf3aaac039..8e9c41dc2be 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HeadersHeaderOperations.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/HeadersHeaderOperations.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HeaderOperations Describes the header manipulations to apply
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,34 +94,52 @@ public HeadersHeaderOperations(Map<String, String> add, List<String> remove, Map
         this.set = set;
     }
 
+    /**
+     * Append the given values to the headers specified by keys (will create a comma-separated list of values)
+     */
     @JsonProperty("add")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAdd() {
         return add;
     }
 
+    /**
+     * Append the given values to the headers specified by keys (will create a comma-separated list of values)
+     */
     @JsonProperty("add")
     public void setAdd(Map<String, String> add) {
         this.add = add;
     }
 
+    /**
+     * Remove the specified headers
+     */
     @JsonProperty("remove")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getRemove() {
         return remove;
     }
 
+    /**
+     * Remove the specified headers
+     */
     @JsonProperty("remove")
     public void setRemove(List<String> remove) {
         this.remove = remove;
     }
 
+    /**
+     * Overwrite the headers specified by key with the given values
+     */
     @JsonProperty("set")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getSet() {
         return set;
     }
 
+    /**
+     * Overwrite the headers specified by key with the given values
+     */
     @JsonProperty("set")
     public void setSet(Map<String, String> set) {
         this.set = set;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/IstioEgressListener.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/IstioEgressListener.java
index 2547426aedd..b0f77461710 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/IstioEgressListener.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/IstioEgressListener.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * `IstioEgressListener` specifies the properties of an outbound traffic listener on the sidecar proxy attached to a workload instance.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public IstioEgressListener(String bind, CaptureMode captureMode, List<String> ho
         this.port = port;
     }
 
+    /**
+     * The IP(IPv4 or IPv6) or the Unix domain socket to which the listener should be bound to. Port MUST be specified if bind is not empty. Format: IPv4 or IPv6 address formats or `unix:///path/to/uds` or `unix://@foobar` (Linux abstract namespace). If omitted, Istio will automatically configure the defaults based on imported services, the workload instances to which this configuration is applied to and the captureMode. If captureMode is `NONE`, bind will default to 127.0.0.1.
+     */
     @JsonProperty("bind")
     public String getBind() {
         return bind;
     }
 
+    /**
+     * The IP(IPv4 or IPv6) or the Unix domain socket to which the listener should be bound to. Port MUST be specified if bind is not empty. Format: IPv4 or IPv6 address formats or `unix:///path/to/uds` or `unix://@foobar` (Linux abstract namespace). If omitted, Istio will automatically configure the defaults based on imported services, the workload instances to which this configuration is applied to and the captureMode. If captureMode is `NONE`, bind will default to 127.0.0.1.
+     */
     @JsonProperty("bind")
     public void setBind(String bind) {
         this.bind = bind;
     }
 
+    /**
+     * `IstioEgressListener` specifies the properties of an outbound traffic listener on the sidecar proxy attached to a workload instance.
+     */
     @JsonProperty("captureMode")
     public CaptureMode getCaptureMode() {
         return captureMode;
     }
 
+    /**
+     * `IstioEgressListener` specifies the properties of an outbound traffic listener on the sidecar proxy attached to a workload instance.
+     */
     @JsonProperty("captureMode")
     public void setCaptureMode(CaptureMode captureMode) {
         this.captureMode = captureMode;
     }
 
+    /**
+     * One or more service hosts exposed by the listener in `namespace/dnsName` format. Services in the specified namespace matching `dnsName` will be exposed. The corresponding service can be a service in the service registry (e.g., a Kubernetes or cloud foundry service) or a service specified using a `ServiceEntry` or `VirtualService` configuration. Any associated `DestinationRule` in the same namespace will also be used.<br><p> <br><p> The `dnsName` should be specified using FQDN format, optionally including a wildcard character in the left-most component (e.g., `prod/&#42;.example.com`). Set the `dnsName` to `&#42;` to select all services from the specified namespace (e.g., `prod/&#42;`).<br><p> <br><p> The `namespace` can be set to `&#42;`, `.`, or `~`, representing any, the current, or no namespace, respectively. For example, `&#42;/foo.example.com` selects the service from any available namespace while `./foo.example.com` only selects the service from the namespace of the sidecar. If a host is set to `&#42;/&#42;`, Istio will configure the sidecar to be able to reach every service in the mesh that is exported to the sidecar's namespace. The value `~/&#42;` can be used to completely trim the configuration for sidecars that simply receive traffic and respond, but make no outbound connections of their own.<br><p> <br><p> NOTE: Only services and configuration artifacts exported to the sidecar's namespace (e.g., `exportTo` value of `&#42;`) can be referenced. Private configurations (e.g., `exportTo` set to `.`) will not be available. Refer to the `exportTo` setting in `VirtualService`, `DestinationRule`, and `ServiceEntry` configurations for details.
+     */
     @JsonProperty("hosts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getHosts() {
         return hosts;
     }
 
+    /**
+     * One or more service hosts exposed by the listener in `namespace/dnsName` format. Services in the specified namespace matching `dnsName` will be exposed. The corresponding service can be a service in the service registry (e.g., a Kubernetes or cloud foundry service) or a service specified using a `ServiceEntry` or `VirtualService` configuration. Any associated `DestinationRule` in the same namespace will also be used.<br><p> <br><p> The `dnsName` should be specified using FQDN format, optionally including a wildcard character in the left-most component (e.g., `prod/&#42;.example.com`). Set the `dnsName` to `&#42;` to select all services from the specified namespace (e.g., `prod/&#42;`).<br><p> <br><p> The `namespace` can be set to `&#42;`, `.`, or `~`, representing any, the current, or no namespace, respectively. For example, `&#42;/foo.example.com` selects the service from any available namespace while `./foo.example.com` only selects the service from the namespace of the sidecar. If a host is set to `&#42;/&#42;`, Istio will configure the sidecar to be able to reach every service in the mesh that is exported to the sidecar's namespace. The value `~/&#42;` can be used to completely trim the configuration for sidecars that simply receive traffic and respond, but make no outbound connections of their own.<br><p> <br><p> NOTE: Only services and configuration artifacts exported to the sidecar's namespace (e.g., `exportTo` value of `&#42;`) can be referenced. Private configurations (e.g., `exportTo` set to `.`) will not be available. Refer to the `exportTo` setting in `VirtualService`, `DestinationRule`, and `ServiceEntry` configurations for details.
+     */
     @JsonProperty("hosts")
     public void setHosts(List<String> hosts) {
         this.hosts = hosts;
     }
 
+    /**
+     * `IstioEgressListener` specifies the properties of an outbound traffic listener on the sidecar proxy attached to a workload instance.
+     */
     @JsonProperty("port")
     public SidecarPort getPort() {
         return port;
     }
 
+    /**
+     * `IstioEgressListener` specifies the properties of an outbound traffic listener on the sidecar proxy attached to a workload instance.
+     */
     @JsonProperty("port")
     public void setPort(SidecarPort port) {
         this.port = port;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/IstioIngressListener.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/IstioIngressListener.java
index b6eae95018f..745a2cf75b0 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/IstioIngressListener.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/IstioIngressListener.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * `IstioIngressListener` specifies the properties of an inbound traffic listener on the sidecar proxy attached to a workload instance.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public IstioIngressListener(String bind, CaptureMode captureMode, ConnectionPool
         this.tls = tls;
     }
 
+    /**
+     * The IP(IPv4 or IPv6) to which the listener should be bound. Unix domain socket addresses are not allowed in the bind field for ingress listeners. If omitted, Istio will automatically configure the defaults based on imported services and the workload instances to which this configuration is applied to.
+     */
     @JsonProperty("bind")
     public String getBind() {
         return bind;
     }
 
+    /**
+     * The IP(IPv4 or IPv6) to which the listener should be bound. Unix domain socket addresses are not allowed in the bind field for ingress listeners. If omitted, Istio will automatically configure the defaults based on imported services and the workload instances to which this configuration is applied to.
+     */
     @JsonProperty("bind")
     public void setBind(String bind) {
         this.bind = bind;
     }
 
+    /**
+     * `IstioIngressListener` specifies the properties of an inbound traffic listener on the sidecar proxy attached to a workload instance.
+     */
     @JsonProperty("captureMode")
     public CaptureMode getCaptureMode() {
         return captureMode;
     }
 
+    /**
+     * `IstioIngressListener` specifies the properties of an inbound traffic listener on the sidecar proxy attached to a workload instance.
+     */
     @JsonProperty("captureMode")
     public void setCaptureMode(CaptureMode captureMode) {
         this.captureMode = captureMode;
     }
 
+    /**
+     * `IstioIngressListener` specifies the properties of an inbound traffic listener on the sidecar proxy attached to a workload instance.
+     */
     @JsonProperty("connectionPool")
     public ConnectionPoolSettings getConnectionPool() {
         return connectionPool;
     }
 
+    /**
+     * `IstioIngressListener` specifies the properties of an inbound traffic listener on the sidecar proxy attached to a workload instance.
+     */
     @JsonProperty("connectionPool")
     public void setConnectionPool(ConnectionPoolSettings connectionPool) {
         this.connectionPool = connectionPool;
     }
 
+    /**
+     * The IP endpoint or Unix domain socket to which traffic should be forwarded to. This configuration can be used to redirect traffic arriving at the bind `IP:Port` on the sidecar to a `localhost:port` or Unix domain socket where the application workload instance is listening for connections. Arbitrary IPs are not supported. Format should be one of `127.0.0.1:PORT`, `[::1]:PORT` (forward to localhost), `0.0.0.0:PORT`, `[::]:PORT` (forward to the instance IP), or `unix:///path/to/socket` (forward to Unix domain socket).
+     */
     @JsonProperty("defaultEndpoint")
     public String getDefaultEndpoint() {
         return defaultEndpoint;
     }
 
+    /**
+     * The IP endpoint or Unix domain socket to which traffic should be forwarded to. This configuration can be used to redirect traffic arriving at the bind `IP:Port` on the sidecar to a `localhost:port` or Unix domain socket where the application workload instance is listening for connections. Arbitrary IPs are not supported. Format should be one of `127.0.0.1:PORT`, `[::1]:PORT` (forward to localhost), `0.0.0.0:PORT`, `[::]:PORT` (forward to the instance IP), or `unix:///path/to/socket` (forward to Unix domain socket).
+     */
     @JsonProperty("defaultEndpoint")
     public void setDefaultEndpoint(String defaultEndpoint) {
         this.defaultEndpoint = defaultEndpoint;
     }
 
+    /**
+     * `IstioIngressListener` specifies the properties of an inbound traffic listener on the sidecar proxy attached to a workload instance.
+     */
     @JsonProperty("port")
     public SidecarPort getPort() {
         return port;
     }
 
+    /**
+     * `IstioIngressListener` specifies the properties of an inbound traffic listener on the sidecar proxy attached to a workload instance.
+     */
     @JsonProperty("port")
     public void setPort(SidecarPort port) {
         this.port = port;
     }
 
+    /**
+     * `IstioIngressListener` specifies the properties of an inbound traffic listener on the sidecar proxy attached to a workload instance.
+     */
     @JsonProperty("tls")
     public ServerTLSSettings getTls() {
         return tls;
     }
 
+    /**
+     * `IstioIngressListener` specifies the properties of an inbound traffic listener on the sidecar proxy attached to a workload instance.
+     */
     @JsonProperty("tls")
     public void setTls(ServerTLSSettings tls) {
         this.tls = tls;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/L4MatchAttributes.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/L4MatchAttributes.java
index 6053811d10a..d922864ffe9 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/L4MatchAttributes.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/L4MatchAttributes.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * L4 connection match attributes. Note that L4 connection matching support is incomplete.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -103,64 +106,100 @@ public L4MatchAttributes(List<String> destinationSubnets, List<String> gateways,
         this.sourceSubnet = sourceSubnet;
     }
 
+    /**
+     * IPv4 or IPv6 ip addresses of destination with optional subnet.  E.g., a.b.c.d/xx form or just a.b.c.d.
+     */
     @JsonProperty("destinationSubnets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDestinationSubnets() {
         return destinationSubnets;
     }
 
+    /**
+     * IPv4 or IPv6 ip addresses of destination with optional subnet.  E.g., a.b.c.d/xx form or just a.b.c.d.
+     */
     @JsonProperty("destinationSubnets")
     public void setDestinationSubnets(List<String> destinationSubnets) {
         this.destinationSubnets = destinationSubnets;
     }
 
+    /**
+     * Names of gateways where the rule should be applied. Gateway names in the top-level `gateways` field of the VirtualService (if any) are overridden. The gateway match is independent of sourceLabels.
+     */
     @JsonProperty("gateways")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getGateways() {
         return gateways;
     }
 
+    /**
+     * Names of gateways where the rule should be applied. Gateway names in the top-level `gateways` field of the VirtualService (if any) are overridden. The gateway match is independent of sourceLabels.
+     */
     @JsonProperty("gateways")
     public void setGateways(List<String> gateways) {
         this.gateways = gateways;
     }
 
+    /**
+     * Specifies the port on the host that is being addressed. Many services only expose a single port or label ports with the protocols they support, in these cases it is not required to explicitly select the port.
+     */
     @JsonProperty("port")
     public Long getPort() {
         return port;
     }
 
+    /**
+     * Specifies the port on the host that is being addressed. Many services only expose a single port or label ports with the protocols they support, in these cases it is not required to explicitly select the port.
+     */
     @JsonProperty("port")
     public void setPort(Long port) {
         this.port = port;
     }
 
+    /**
+     * One or more labels that constrain the applicability of a rule to workloads with the given labels. If the VirtualService has a list of gateways specified in the top-level `gateways` field, it should include the reserved gateway `mesh` in order for this field to be applicable.
+     */
     @JsonProperty("sourceLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getSourceLabels() {
         return sourceLabels;
     }
 
+    /**
+     * One or more labels that constrain the applicability of a rule to workloads with the given labels. If the VirtualService has a list of gateways specified in the top-level `gateways` field, it should include the reserved gateway `mesh` in order for this field to be applicable.
+     */
     @JsonProperty("sourceLabels")
     public void setSourceLabels(Map<String, String> sourceLabels) {
         this.sourceLabels = sourceLabels;
     }
 
+    /**
+     * Source namespace constraining the applicability of a rule to workloads in that namespace. If the VirtualService has a list of gateways specified in the top-level `gateways` field, it must include the reserved gateway `mesh` for this field to be applicable.
+     */
     @JsonProperty("sourceNamespace")
     public String getSourceNamespace() {
         return sourceNamespace;
     }
 
+    /**
+     * Source namespace constraining the applicability of a rule to workloads in that namespace. If the VirtualService has a list of gateways specified in the top-level `gateways` field, it must include the reserved gateway `mesh` for this field to be applicable.
+     */
     @JsonProperty("sourceNamespace")
     public void setSourceNamespace(String sourceNamespace) {
         this.sourceNamespace = sourceNamespace;
     }
 
+    /**
+     * IPv4 or IPv6 ip address of source with optional subnet. E.g., a.b.c.d/xx form or just a.b.c.d $hide_from_docs
+     */
     @JsonProperty("sourceSubnet")
     public String getSourceSubnet() {
         return sourceSubnet;
     }
 
+    /**
+     * IPv4 or IPv6 ip address of source with optional subnet. E.g., a.b.c.d/xx form or just a.b.c.d $hide_from_docs
+     */
     @JsonProperty("sourceSubnet")
     public void setSourceSubnet(String sourceSubnet) {
         this.sourceSubnet = sourceSubnet;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettings.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettings.java
index aaef7de946d..cf4b071d610 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettings.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettings.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Load balancing policies to apply for a specific destination. See Envoy's load balancing [documentation](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/load_balancing/load_balancing) for more details.<br><p> <br><p> For example, the following rule uses a round robin load balancing policy for all traffic going to the ratings service.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: bookinfo-ratings<br><p> <br><p> spec:<br><p> <br><p> 	host: ratings.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  loadBalancer:<br><p> 	    simple: ROUND_ROBIN<br><p> <br><p> ```<br><p> <br><p> The following example sets up sticky sessions for the ratings service hashing-based load balancer for the same ratings service using the the User cookie as the hash key.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: bookinfo-ratings<br><p> <br><p> spec:<br><p> <br><p> 	host: ratings.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  loadBalancer:<br><p> 	    consistentHash:<br><p> 	      httpCookie:<br><p> 	        name: user<br><p> 	        ttl: 0s<br><p> <br><p> ```
+ */
 @JsonDeserialize(using = io.fabric8.kubernetes.model.jackson.JsonUnwrappedDeserializer.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -92,42 +95,66 @@ public LoadBalancerSettings(IsLoadBalancerSettingsLbPolicy lbPolicy, LocalityLoa
         this.warmupDurationSecs = warmupDurationSecs;
     }
 
+    /**
+     * Load balancing policies to apply for a specific destination. See Envoy's load balancing [documentation](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/load_balancing/load_balancing) for more details.<br><p> <br><p> For example, the following rule uses a round robin load balancing policy for all traffic going to the ratings service.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: bookinfo-ratings<br><p> <br><p> spec:<br><p> <br><p> 	host: ratings.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  loadBalancer:<br><p> 	    simple: ROUND_ROBIN<br><p> <br><p> ```<br><p> <br><p> The following example sets up sticky sessions for the ratings service hashing-based load balancer for the same ratings service using the the User cookie as the hash key.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: bookinfo-ratings<br><p> <br><p> spec:<br><p> <br><p> 	host: ratings.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  loadBalancer:<br><p> 	    consistentHash:<br><p> 	      httpCookie:<br><p> 	        name: user<br><p> 	        ttl: 0s<br><p> <br><p> ```
+     */
     @JsonProperty("LbPolicy")
     @JsonUnwrapped
     public IsLoadBalancerSettingsLbPolicy getLbPolicy() {
         return lbPolicy;
     }
 
+    /**
+     * Load balancing policies to apply for a specific destination. See Envoy's load balancing [documentation](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/load_balancing/load_balancing) for more details.<br><p> <br><p> For example, the following rule uses a round robin load balancing policy for all traffic going to the ratings service.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: bookinfo-ratings<br><p> <br><p> spec:<br><p> <br><p> 	host: ratings.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  loadBalancer:<br><p> 	    simple: ROUND_ROBIN<br><p> <br><p> ```<br><p> <br><p> The following example sets up sticky sessions for the ratings service hashing-based load balancer for the same ratings service using the the User cookie as the hash key.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: bookinfo-ratings<br><p> <br><p> spec:<br><p> <br><p> 	host: ratings.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  loadBalancer:<br><p> 	    consistentHash:<br><p> 	      httpCookie:<br><p> 	        name: user<br><p> 	        ttl: 0s<br><p> <br><p> ```
+     */
     @JsonProperty("LbPolicy")
     public void setLbPolicy(IsLoadBalancerSettingsLbPolicy lbPolicy) {
         this.lbPolicy = lbPolicy;
     }
 
+    /**
+     * Load balancing policies to apply for a specific destination. See Envoy's load balancing [documentation](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/load_balancing/load_balancing) for more details.<br><p> <br><p> For example, the following rule uses a round robin load balancing policy for all traffic going to the ratings service.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: bookinfo-ratings<br><p> <br><p> spec:<br><p> <br><p> 	host: ratings.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  loadBalancer:<br><p> 	    simple: ROUND_ROBIN<br><p> <br><p> ```<br><p> <br><p> The following example sets up sticky sessions for the ratings service hashing-based load balancer for the same ratings service using the the User cookie as the hash key.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: bookinfo-ratings<br><p> <br><p> spec:<br><p> <br><p> 	host: ratings.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  loadBalancer:<br><p> 	    consistentHash:<br><p> 	      httpCookie:<br><p> 	        name: user<br><p> 	        ttl: 0s<br><p> <br><p> ```
+     */
     @JsonProperty("localityLbSetting")
     public LocalityLoadBalancerSetting getLocalityLbSetting() {
         return localityLbSetting;
     }
 
+    /**
+     * Load balancing policies to apply for a specific destination. See Envoy's load balancing [documentation](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/load_balancing/load_balancing) for more details.<br><p> <br><p> For example, the following rule uses a round robin load balancing policy for all traffic going to the ratings service.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: bookinfo-ratings<br><p> <br><p> spec:<br><p> <br><p> 	host: ratings.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  loadBalancer:<br><p> 	    simple: ROUND_ROBIN<br><p> <br><p> ```<br><p> <br><p> The following example sets up sticky sessions for the ratings service hashing-based load balancer for the same ratings service using the the User cookie as the hash key.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: bookinfo-ratings<br><p> <br><p> spec:<br><p> <br><p> 	host: ratings.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  loadBalancer:<br><p> 	    consistentHash:<br><p> 	      httpCookie:<br><p> 	        name: user<br><p> 	        ttl: 0s<br><p> <br><p> ```
+     */
     @JsonProperty("localityLbSetting")
     public void setLocalityLbSetting(LocalityLoadBalancerSetting localityLbSetting) {
         this.localityLbSetting = localityLbSetting;
     }
 
+    /**
+     * Load balancing policies to apply for a specific destination. See Envoy's load balancing [documentation](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/load_balancing/load_balancing) for more details.<br><p> <br><p> For example, the following rule uses a round robin load balancing policy for all traffic going to the ratings service.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: bookinfo-ratings<br><p> <br><p> spec:<br><p> <br><p> 	host: ratings.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  loadBalancer:<br><p> 	    simple: ROUND_ROBIN<br><p> <br><p> ```<br><p> <br><p> The following example sets up sticky sessions for the ratings service hashing-based load balancer for the same ratings service using the the User cookie as the hash key.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: bookinfo-ratings<br><p> <br><p> spec:<br><p> <br><p> 	host: ratings.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  loadBalancer:<br><p> 	    consistentHash:<br><p> 	      httpCookie:<br><p> 	        name: user<br><p> 	        ttl: 0s<br><p> <br><p> ```
+     */
     @JsonProperty("warmup")
     public WarmupConfiguration getWarmup() {
         return warmup;
     }
 
+    /**
+     * Load balancing policies to apply for a specific destination. See Envoy's load balancing [documentation](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/load_balancing/load_balancing) for more details.<br><p> <br><p> For example, the following rule uses a round robin load balancing policy for all traffic going to the ratings service.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: bookinfo-ratings<br><p> <br><p> spec:<br><p> <br><p> 	host: ratings.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  loadBalancer:<br><p> 	    simple: ROUND_ROBIN<br><p> <br><p> ```<br><p> <br><p> The following example sets up sticky sessions for the ratings service hashing-based load balancer for the same ratings service using the the User cookie as the hash key.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: bookinfo-ratings<br><p> <br><p> spec:<br><p> <br><p> 	host: ratings.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  loadBalancer:<br><p> 	    consistentHash:<br><p> 	      httpCookie:<br><p> 	        name: user<br><p> 	        ttl: 0s<br><p> <br><p> ```
+     */
     @JsonProperty("warmup")
     public void setWarmup(WarmupConfiguration warmup) {
         this.warmup = warmup;
     }
 
+    /**
+     * Load balancing policies to apply for a specific destination. See Envoy's load balancing [documentation](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/load_balancing/load_balancing) for more details.<br><p> <br><p> For example, the following rule uses a round robin load balancing policy for all traffic going to the ratings service.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: bookinfo-ratings<br><p> <br><p> spec:<br><p> <br><p> 	host: ratings.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  loadBalancer:<br><p> 	    simple: ROUND_ROBIN<br><p> <br><p> ```<br><p> <br><p> The following example sets up sticky sessions for the ratings service hashing-based load balancer for the same ratings service using the the User cookie as the hash key.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: bookinfo-ratings<br><p> <br><p> spec:<br><p> <br><p> 	host: ratings.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  loadBalancer:<br><p> 	    consistentHash:<br><p> 	      httpCookie:<br><p> 	        name: user<br><p> 	        ttl: 0s<br><p> <br><p> ```
+     */
     @JsonProperty("warmupDurationSecs")
     public String getWarmupDurationSecs() {
         return warmupDurationSecs;
     }
 
+    /**
+     * Load balancing policies to apply for a specific destination. See Envoy's load balancing [documentation](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/load_balancing/load_balancing) for more details.<br><p> <br><p> For example, the following rule uses a round robin load balancing policy for all traffic going to the ratings service.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: bookinfo-ratings<br><p> <br><p> spec:<br><p> <br><p> 	host: ratings.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  loadBalancer:<br><p> 	    simple: ROUND_ROBIN<br><p> <br><p> ```<br><p> <br><p> The following example sets up sticky sessions for the ratings service hashing-based load balancer for the same ratings service using the the User cookie as the hash key.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: bookinfo-ratings<br><p> <br><p> spec:<br><p> <br><p> 	host: ratings.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  loadBalancer:<br><p> 	    consistentHash:<br><p> 	      httpCookie:<br><p> 	        name: user<br><p> 	        ttl: 0s<br><p> <br><p> ```
+     */
     @JsonProperty("warmupDurationSecs")
     public void setWarmupDurationSecs(String warmupDurationSecs) {
         this.warmupDurationSecs = warmupDurationSecs;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLB.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLB.java
index d578a299bce..c71c42903d9 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLB.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLB.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Consistent Hash-based load balancing can be used to provide soft session affinity based on HTTP headers, cookies or other properties. The affinity to a particular destination host may be lost when one or more hosts are added/removed from the destination service.<br><p> <br><p> Note: consistent hashing is less reliable at maintaining affinity than common "sticky sessions" implementations, which often encode a specific destination in a cookie, ensuring affinity is maintained as long as the backend remains. With consistent hash, the guarantees are weaker; any host addition or removal can break affinity for `1/backends` requests.<br><p> <br><p> Warning: consistent hashing depends on each proxy having a consistent view of endpoints. This is not the case when locality load balancing is enabled. Locality load balancing and consistent hash will only work together when all proxies are in the same locality, or a high level load balancer handles locality affinity.
+ */
 @JsonDeserialize(using = io.fabric8.kubernetes.model.jackson.JsonUnwrappedDeserializer.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,33 +92,51 @@ public LoadBalancerSettingsConsistentHashLB(IsLoadBalancerSettingsConsistentHash
         this.minimumRingSize = minimumRingSize;
     }
 
+    /**
+     * Consistent Hash-based load balancing can be used to provide soft session affinity based on HTTP headers, cookies or other properties. The affinity to a particular destination host may be lost when one or more hosts are added/removed from the destination service.<br><p> <br><p> Note: consistent hashing is less reliable at maintaining affinity than common "sticky sessions" implementations, which often encode a specific destination in a cookie, ensuring affinity is maintained as long as the backend remains. With consistent hash, the guarantees are weaker; any host addition or removal can break affinity for `1/backends` requests.<br><p> <br><p> Warning: consistent hashing depends on each proxy having a consistent view of endpoints. This is not the case when locality load balancing is enabled. Locality load balancing and consistent hash will only work together when all proxies are in the same locality, or a high level load balancer handles locality affinity.
+     */
     @JsonProperty("HashAlgorithm")
     @JsonUnwrapped
     public IsLoadBalancerSettingsConsistentHashLBHashAlgorithm getHashAlgorithm() {
         return hashAlgorithm;
     }
 
+    /**
+     * Consistent Hash-based load balancing can be used to provide soft session affinity based on HTTP headers, cookies or other properties. The affinity to a particular destination host may be lost when one or more hosts are added/removed from the destination service.<br><p> <br><p> Note: consistent hashing is less reliable at maintaining affinity than common "sticky sessions" implementations, which often encode a specific destination in a cookie, ensuring affinity is maintained as long as the backend remains. With consistent hash, the guarantees are weaker; any host addition or removal can break affinity for `1/backends` requests.<br><p> <br><p> Warning: consistent hashing depends on each proxy having a consistent view of endpoints. This is not the case when locality load balancing is enabled. Locality load balancing and consistent hash will only work together when all proxies are in the same locality, or a high level load balancer handles locality affinity.
+     */
     @JsonProperty("HashAlgorithm")
     public void setHashAlgorithm(IsLoadBalancerSettingsConsistentHashLBHashAlgorithm hashAlgorithm) {
         this.hashAlgorithm = hashAlgorithm;
     }
 
+    /**
+     * Consistent Hash-based load balancing can be used to provide soft session affinity based on HTTP headers, cookies or other properties. The affinity to a particular destination host may be lost when one or more hosts are added/removed from the destination service.<br><p> <br><p> Note: consistent hashing is less reliable at maintaining affinity than common "sticky sessions" implementations, which often encode a specific destination in a cookie, ensuring affinity is maintained as long as the backend remains. With consistent hash, the guarantees are weaker; any host addition or removal can break affinity for `1/backends` requests.<br><p> <br><p> Warning: consistent hashing depends on each proxy having a consistent view of endpoints. This is not the case when locality load balancing is enabled. Locality load balancing and consistent hash will only work together when all proxies are in the same locality, or a high level load balancer handles locality affinity.
+     */
     @JsonProperty("HashKey")
     @JsonUnwrapped
     public IsLoadBalancerSettingsConsistentHashLBHashKey getHashKey() {
         return hashKey;
     }
 
+    /**
+     * Consistent Hash-based load balancing can be used to provide soft session affinity based on HTTP headers, cookies or other properties. The affinity to a particular destination host may be lost when one or more hosts are added/removed from the destination service.<br><p> <br><p> Note: consistent hashing is less reliable at maintaining affinity than common "sticky sessions" implementations, which often encode a specific destination in a cookie, ensuring affinity is maintained as long as the backend remains. With consistent hash, the guarantees are weaker; any host addition or removal can break affinity for `1/backends` requests.<br><p> <br><p> Warning: consistent hashing depends on each proxy having a consistent view of endpoints. This is not the case when locality load balancing is enabled. Locality load balancing and consistent hash will only work together when all proxies are in the same locality, or a high level load balancer handles locality affinity.
+     */
     @JsonProperty("HashKey")
     public void setHashKey(IsLoadBalancerSettingsConsistentHashLBHashKey hashKey) {
         this.hashKey = hashKey;
     }
 
+    /**
+     * Deprecated. Use RingHash instead.<br><p> <br><p> Deprecated: Marked as deprecated in networking/v1alpha3/destination_rule.proto.
+     */
     @JsonProperty("minimumRingSize")
     public Long getMinimumRingSize() {
         return minimumRingSize;
     }
 
+    /**
+     * Deprecated. Use RingHash instead.<br><p> <br><p> Deprecated: Marked as deprecated in networking/v1alpha3/destination_rule.proto.
+     */
     @JsonProperty("minimumRingSize")
     public void setMinimumRingSize(Long minimumRingSize) {
         this.minimumRingSize = minimumRingSize;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBHTTPCookie_.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBHTTPCookie_.java
index d0fd6aec5ad..07f452fd6c8 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBHTTPCookie_.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBHTTPCookie_.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Describes a HTTP cookie that will be used as the hash key for the Consistent Hash load balancer.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public LoadBalancerSettingsConsistentHashLBHTTPCookie_(String name, String path,
         this.ttl = ttl;
     }
 
+    /**
+     * Name of the cookie.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the cookie.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Path to set for the cookie.
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Path to set for the cookie.
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * Describes a HTTP cookie that will be used as the hash key for the Consistent Hash load balancer.
+     */
     @JsonProperty("ttl")
     public String getTtl() {
         return ttl;
     }
 
+    /**
+     * Describes a HTTP cookie that will be used as the hash key for the Consistent Hash load balancer.
+     */
     @JsonProperty("ttl")
     public void setTtl(String ttl) {
         this.ttl = ttl;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBHttpCookie.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBHttpCookie.java
index 90d6bb314cb..0c9f110cfef 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBHttpCookie.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBHttpCookie.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Hash based on HTTP cookie.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public LoadBalancerSettingsConsistentHashLBHttpCookie(LoadBalancerSettingsConsis
         this.httpCookie = httpCookie;
     }
 
+    /**
+     * Hash based on HTTP cookie.
+     */
     @JsonProperty("httpCookie")
     public LoadBalancerSettingsConsistentHashLBHTTPCookie_ getHttpCookie() {
         return httpCookie;
     }
 
+    /**
+     * Hash based on HTTP cookie.
+     */
     @JsonProperty("httpCookie")
     public void setHttpCookie(LoadBalancerSettingsConsistentHashLBHTTPCookie_ httpCookie) {
         this.httpCookie = httpCookie;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBHttpHeaderName.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBHttpHeaderName.java
index 9513078daf9..92188136153 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBHttpHeaderName.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBHttpHeaderName.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Hash based on a specific HTTP header.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public LoadBalancerSettingsConsistentHashLBHttpHeaderName(String httpHeaderName)
         this.httpHeaderName = httpHeaderName;
     }
 
+    /**
+     * Hash based on a specific HTTP header.
+     */
     @JsonProperty("httpHeaderName")
     public String getHttpHeaderName() {
         return httpHeaderName;
     }
 
+    /**
+     * Hash based on a specific HTTP header.
+     */
     @JsonProperty("httpHeaderName")
     public void setHttpHeaderName(String httpHeaderName) {
         this.httpHeaderName = httpHeaderName;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBHttpQueryParameterName.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBHttpQueryParameterName.java
index dbad81d4c88..90856bfb777 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBHttpQueryParameterName.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBHttpQueryParameterName.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Hash based on a specific HTTP query parameter.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public LoadBalancerSettingsConsistentHashLBHttpQueryParameterName(String httpQue
         this.httpQueryParameterName = httpQueryParameterName;
     }
 
+    /**
+     * Hash based on a specific HTTP query parameter.
+     */
     @JsonProperty("httpQueryParameterName")
     public String getHttpQueryParameterName() {
         return httpQueryParameterName;
     }
 
+    /**
+     * Hash based on a specific HTTP query parameter.
+     */
     @JsonProperty("httpQueryParameterName")
     public void setHttpQueryParameterName(String httpQueryParameterName) {
         this.httpQueryParameterName = httpQueryParameterName;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBMagLev_.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBMagLev_.java
index beb332b8cce..36835c10ba6 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBMagLev_.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBMagLev_.java
@@ -78,11 +78,17 @@ public LoadBalancerSettingsConsistentHashLBMagLev_(Long tableSize) {
         this.tableSize = tableSize;
     }
 
+    /**
+     * The table size for Maglev hashing. This helps in controlling the disruption when the backend hosts change. Increasing the table size reduces the amount of disruption. The table size must be prime number less than 5000011. If it is not specified, the default is 65537.
+     */
     @JsonProperty("tableSize")
     public Long getTableSize() {
         return tableSize;
     }
 
+    /**
+     * The table size for Maglev hashing. This helps in controlling the disruption when the backend hosts change. Increasing the table size reduces the amount of disruption. The table size must be prime number less than 5000011. If it is not specified, the default is 65537.
+     */
     @JsonProperty("tableSize")
     public void setTableSize(Long tableSize) {
         this.tableSize = tableSize;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBMaglev.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBMaglev.java
index dd19ec71197..aa1758e4bc3 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBMaglev.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBMaglev.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * The Maglev load balancer implements consistent hashing to backend hosts.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public LoadBalancerSettingsConsistentHashLBMaglev(LoadBalancerSettingsConsistent
         this.maglev = maglev;
     }
 
+    /**
+     * The Maglev load balancer implements consistent hashing to backend hosts.
+     */
     @JsonProperty("maglev")
     public LoadBalancerSettingsConsistentHashLBMagLev_ getMaglev() {
         return maglev;
     }
 
+    /**
+     * The Maglev load balancer implements consistent hashing to backend hosts.
+     */
     @JsonProperty("maglev")
     public void setMaglev(LoadBalancerSettingsConsistentHashLBMagLev_ maglev) {
         this.maglev = maglev;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBRingHash.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBRingHash.java
index 296a56ec7b4..30e74e54d52 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBRingHash.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBRingHash.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * The ring/modulo hash load balancer implements consistent hashing to backend hosts.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public LoadBalancerSettingsConsistentHashLBRingHash(io.fabric8.istio.api.api.net
         this.ringHash = ringHash;
     }
 
+    /**
+     * The ring/modulo hash load balancer implements consistent hashing to backend hosts.
+     */
     @JsonProperty("ringHash")
     public io.fabric8.istio.api.api.networking.v1alpha3.LoadBalancerSettingsConsistentHashLBRingHash getRingHash() {
         return ringHash;
     }
 
+    /**
+     * The ring/modulo hash load balancer implements consistent hashing to backend hosts.
+     */
     @JsonProperty("ringHash")
     public void setRingHash(io.fabric8.istio.api.api.networking.v1alpha3.LoadBalancerSettingsConsistentHashLBRingHash ringHash) {
         this.ringHash = ringHash;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBUseSourceIp.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBUseSourceIp.java
index dd6922b9377..1ac6b52aed1 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBUseSourceIp.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsConsistentHashLBUseSourceIp.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Hash based on the source IP address. This is applicable for both TCP and HTTP connections.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public LoadBalancerSettingsConsistentHashLBUseSourceIp(Boolean useSourceIp) {
         this.useSourceIp = useSourceIp;
     }
 
+    /**
+     * Hash based on the source IP address. This is applicable for both TCP and HTTP connections.
+     */
     @JsonProperty("useSourceIp")
     public Boolean getUseSourceIp() {
         return useSourceIp;
     }
 
+    /**
+     * Hash based on the source IP address. This is applicable for both TCP and HTTP connections.
+     */
     @JsonProperty("useSourceIp")
     public void setUseSourceIp(Boolean useSourceIp) {
         this.useSourceIp = useSourceIp;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsSimpleLB.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsSimpleLB.java
index 130d3d3fea9..44c35631820 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsSimpleLB.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LoadBalancerSettingsSimpleLB.java
@@ -4,6 +4,9 @@
 import javax.annotation.Generated;
 import com.fasterxml.jackson.annotation.JsonCreator;
 
+/**
+ * Standard load balancing algorithms that require no tuning.
+ */
 @Generated("io.fabric8.kubernetes.schema.generator.model.ModelGenerator")
 public enum LoadBalancerSettingsSimpleLB 
 {
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LocalityLoadBalancerSetting.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LocalityLoadBalancerSetting.java
index 49d58d61a04..740a700416f 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LocalityLoadBalancerSetting.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LocalityLoadBalancerSetting.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Locality-weighted load balancing allows administrators to control the distribution of traffic to endpoints based on the localities of where the traffic originates and where it will terminate. These localities are specified using arbitrary labels that designate a hierarchy of localities in {region}/{zone}/{sub-zone} form. For additional detail refer to [Locality Weight](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/load_balancing/locality_weight) The following example shows how to setup locality weights mesh-wide.<br><p> <br><p> Given a mesh with workloads and their service deployed to "us-west/zone1/&#42;" and "us-west/zone2/&#42;". This example specifies that when traffic accessing a service originates from workloads in "us-west/zone1/&#42;", 80% of the traffic will be sent to endpoints in "us-west/zone1/&#42;", i.e the same zone, and the remaining 20% will go to endpoints in "us-west/zone2/&#42;". This setup is intended to favor routing traffic to endpoints in the same locality. A similar setting is specified for traffic originating in "us-west/zone2/&#42;".<br><p> <br><p> ```yaml<br><p> <br><p> 	distribute:<br><p> 	  - from: us-west/zone1/&#42;<br><p> 	    to:<br><p> 	      "us-west/zone1/&#42;": 80<br><p> 	      "us-west/zone2/&#42;": 20<br><p> 	  - from: us-west/zone2/&#42;<br><p> 	    to:<br><p> 	      "us-west/zone1/&#42;": 20<br><p> 	      "us-west/zone2/&#42;": 80<br><p> <br><p> ```<br><p> <br><p> If the goal of the operator is not to distribute load across zones and regions but rather to restrict the regionality of failover to meet other operational requirements an operator can set a 'failover' policy instead of a 'distribute' policy.<br><p> <br><p> The following example sets up a locality failover policy for regions. Assume a service resides in zones within us-east, us-west &amp; eu-west this example specifies that when endpoints within us-east become unhealthy traffic should failover to endpoints in any zone or sub-zone within eu-west and similarly us-west should failover to us-east.<br><p> <br><p> ```yaml<br><p> <br><p> 	failover:<br><p> 	  - from: us-east<br><p> 	    to: eu-west<br><p> 	  - from: us-west<br><p> 	    to: us-east<br><p> <br><p> ``` Locality load balancing settings.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,44 +98,68 @@ public LocalityLoadBalancerSetting(List<LocalityLoadBalancerSettingDistribute> d
         this.failoverPriority = failoverPriority;
     }
 
+    /**
+     * Optional: only one of distribute, failover or failoverPriority can be set. Explicitly specify loadbalancing weight across different zones and geographical locations. Refer to [Locality weighted load balancing](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/load_balancing/locality_weight) If empty, the locality weight is set according to the endpoints number within it.
+     */
     @JsonProperty("distribute")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LocalityLoadBalancerSettingDistribute> getDistribute() {
         return distribute;
     }
 
+    /**
+     * Optional: only one of distribute, failover or failoverPriority can be set. Explicitly specify loadbalancing weight across different zones and geographical locations. Refer to [Locality weighted load balancing](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/load_balancing/locality_weight) If empty, the locality weight is set according to the endpoints number within it.
+     */
     @JsonProperty("distribute")
     public void setDistribute(List<LocalityLoadBalancerSettingDistribute> distribute) {
         this.distribute = distribute;
     }
 
+    /**
+     * Locality-weighted load balancing allows administrators to control the distribution of traffic to endpoints based on the localities of where the traffic originates and where it will terminate. These localities are specified using arbitrary labels that designate a hierarchy of localities in {region}/{zone}/{sub-zone} form. For additional detail refer to [Locality Weight](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/load_balancing/locality_weight) The following example shows how to setup locality weights mesh-wide.<br><p> <br><p> Given a mesh with workloads and their service deployed to "us-west/zone1/&#42;" and "us-west/zone2/&#42;". This example specifies that when traffic accessing a service originates from workloads in "us-west/zone1/&#42;", 80% of the traffic will be sent to endpoints in "us-west/zone1/&#42;", i.e the same zone, and the remaining 20% will go to endpoints in "us-west/zone2/&#42;". This setup is intended to favor routing traffic to endpoints in the same locality. A similar setting is specified for traffic originating in "us-west/zone2/&#42;".<br><p> <br><p> ```yaml<br><p> <br><p> 	distribute:<br><p> 	  - from: us-west/zone1/&#42;<br><p> 	    to:<br><p> 	      "us-west/zone1/&#42;": 80<br><p> 	      "us-west/zone2/&#42;": 20<br><p> 	  - from: us-west/zone2/&#42;<br><p> 	    to:<br><p> 	      "us-west/zone1/&#42;": 20<br><p> 	      "us-west/zone2/&#42;": 80<br><p> <br><p> ```<br><p> <br><p> If the goal of the operator is not to distribute load across zones and regions but rather to restrict the regionality of failover to meet other operational requirements an operator can set a 'failover' policy instead of a 'distribute' policy.<br><p> <br><p> The following example sets up a locality failover policy for regions. Assume a service resides in zones within us-east, us-west &amp; eu-west this example specifies that when endpoints within us-east become unhealthy traffic should failover to endpoints in any zone or sub-zone within eu-west and similarly us-west should failover to us-east.<br><p> <br><p> ```yaml<br><p> <br><p> 	failover:<br><p> 	  - from: us-east<br><p> 	    to: eu-west<br><p> 	  - from: us-west<br><p> 	    to: us-east<br><p> <br><p> ``` Locality load balancing settings.
+     */
     @JsonProperty("enabled")
     public Boolean getEnabled() {
         return enabled;
     }
 
+    /**
+     * Locality-weighted load balancing allows administrators to control the distribution of traffic to endpoints based on the localities of where the traffic originates and where it will terminate. These localities are specified using arbitrary labels that designate a hierarchy of localities in {region}/{zone}/{sub-zone} form. For additional detail refer to [Locality Weight](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/load_balancing/locality_weight) The following example shows how to setup locality weights mesh-wide.<br><p> <br><p> Given a mesh with workloads and their service deployed to "us-west/zone1/&#42;" and "us-west/zone2/&#42;". This example specifies that when traffic accessing a service originates from workloads in "us-west/zone1/&#42;", 80% of the traffic will be sent to endpoints in "us-west/zone1/&#42;", i.e the same zone, and the remaining 20% will go to endpoints in "us-west/zone2/&#42;". This setup is intended to favor routing traffic to endpoints in the same locality. A similar setting is specified for traffic originating in "us-west/zone2/&#42;".<br><p> <br><p> ```yaml<br><p> <br><p> 	distribute:<br><p> 	  - from: us-west/zone1/&#42;<br><p> 	    to:<br><p> 	      "us-west/zone1/&#42;": 80<br><p> 	      "us-west/zone2/&#42;": 20<br><p> 	  - from: us-west/zone2/&#42;<br><p> 	    to:<br><p> 	      "us-west/zone1/&#42;": 20<br><p> 	      "us-west/zone2/&#42;": 80<br><p> <br><p> ```<br><p> <br><p> If the goal of the operator is not to distribute load across zones and regions but rather to restrict the regionality of failover to meet other operational requirements an operator can set a 'failover' policy instead of a 'distribute' policy.<br><p> <br><p> The following example sets up a locality failover policy for regions. Assume a service resides in zones within us-east, us-west &amp; eu-west this example specifies that when endpoints within us-east become unhealthy traffic should failover to endpoints in any zone or sub-zone within eu-west and similarly us-west should failover to us-east.<br><p> <br><p> ```yaml<br><p> <br><p> 	failover:<br><p> 	  - from: us-east<br><p> 	    to: eu-west<br><p> 	  - from: us-west<br><p> 	    to: us-east<br><p> <br><p> ``` Locality load balancing settings.
+     */
     @JsonProperty("enabled")
     public void setEnabled(Boolean enabled) {
         this.enabled = enabled;
     }
 
+    /**
+     * Optional: only one of distribute, failover or failoverPriority can be set. Explicitly specify the region traffic will land on when endpoints in local region becomes unhealthy. Should be used together with OutlierDetection to detect unhealthy endpoints. Note: if no OutlierDetection specified, this will not take effect.
+     */
     @JsonProperty("failover")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LocalityLoadBalancerSettingFailover> getFailover() {
         return failover;
     }
 
+    /**
+     * Optional: only one of distribute, failover or failoverPriority can be set. Explicitly specify the region traffic will land on when endpoints in local region becomes unhealthy. Should be used together with OutlierDetection to detect unhealthy endpoints. Note: if no OutlierDetection specified, this will not take effect.
+     */
     @JsonProperty("failover")
     public void setFailover(List<LocalityLoadBalancerSettingFailover> failover) {
         this.failover = failover;
     }
 
+    /**
+     * failoverPriority is an ordered list of labels used to sort endpoints to do priority based load balancing. This is to support traffic failover across different groups of endpoints. Two kinds of labels can be specified:<br><p> <br><p>   - Specify only label keys `[key1, key2, key3]`, istio would compare the label values of client with endpoints.<br><p>     Suppose there are total N label keys `[key1, key2, key3, ...keyN]` specified:<br><p> <br><p>     1. Endpoints matching all N labels with the client proxy have priority P(0) i.e. the highest priority.<br><p>     2. Endpoints matching the first N-1 labels with the client proxy have priority P(1) i.e. second highest priority.<br><p>     3. By extension of this logic, endpoints matching only the first label with the client proxy has priority P(N-1) i.e. second lowest priority.<br><p>     4. All the other endpoints have priority P(N) i.e. lowest priority.<br><p> <br><p>   - Specify labels with key and value `[key1=value1, key2=value2, key3=value3]`, istio would compare the labels with endpoints.<br><p>     Suppose there are total N labels `[key1=value1, key2=value2, key3=value3, ...keyN=valueN]` specified:<br><p> <br><p>     1. Endpoints matching all N labels have priority P(0) i.e. the highest priority.<br><p>     2. Endpoints matching the first N-1 labels have priority P(1) i.e. second highest priority.<br><p>     3. By extension of this logic, endpoints matching only the first label has priority P(N-1) i.e. second lowest priority.<br><p>     4. All the other endpoints have priority P(N) i.e. lowest priority.<br><p> <br><p> Note: For a label to be considered for match, the previous labels must match, i.e. nth label would be considered matched only if first n-1 labels match.<br><p> <br><p> It can be any label specified on both client and server workloads. The following labels which have special semantic meaning are also supported:<br><p> <br><p>   - `topology.istio.io/network` is used to match the network metadata of an endpoint, which can be specified by pod/namespace label `topology.istio.io/network`, sidecar env `ISTIO_META_NETWORK` or MeshNetworks.<br><p>   - `topology.istio.io/cluster` is used to match the clusterID of an endpoint, which can be specified by pod label `topology.istio.io/cluster` or pod env `ISTIO_META_CLUSTER_ID`.<br><p>   - `topology.kubernetes.io/region` is used to match the region metadata of an endpoint, which maps to Kubernetes node label `topology.kubernetes.io/region` or the deprecated label `failure-domain.beta.kubernetes.io/region`.<br><p>   - `topology.kubernetes.io/zone` is used to match the zone metadata of an endpoint, which maps to Kubernetes node label `topology.kubernetes.io/zone` or the deprecated label `failure-domain.beta.kubernetes.io/zone`.<br><p>   - `topology.istio.io/subzone` is used to match the subzone metadata of an endpoint, which maps to Istio node label `topology.istio.io/subzone`.<br><p>   - `kubernetes.io/hostname` is used to match the current node of an endpoint, which maps to Kubernetes node label `kubernetes.io/hostname`.<br><p> <br><p> The below topology config indicates the following priority levels:<br><p> <br><p> ```yaml failoverPriority: - "topology.istio.io/network" - "topology.kubernetes.io/region" - "topology.kubernetes.io/zone" - "topology.istio.io/subzone" ```<br><p> <br><p> 1. endpoints match same [network, region, zone, subzone] label with the client proxy have the highest priority. 2. endpoints have same [network, region, zone] label but different [subzone] label with the client proxy have the second highest priority. 3. endpoints have same [network, region] label but different [zone] label with the client proxy have the third highest priority. 4. endpoints have same [network] but different [region] labels with the client proxy have the fourth highest priority. 5. all the other endpoints have the same lowest priority.<br><p> <br><p> Suppose a service associated endpoints reside in multi clusters, the below example represents: 1. endpoints in `clusterA` and has `version=v1` label have P(0) priority. 2. endpoints not in `clusterA` but has `version=v1` label have P(1) priority. 2. all the other endpoints have P(2) priority.<br><p> <br><p> ```yaml failoverPriority: - "version=v1" - "topology.istio.io/cluster=clusterA" ```<br><p> <br><p> Optional: only one of distribute, failover or failoverPriority can be set. And it should be used together with `OutlierDetection` to detect unhealthy endpoints, otherwise has no effect.
+     */
     @JsonProperty("failoverPriority")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getFailoverPriority() {
         return failoverPriority;
     }
 
+    /**
+     * failoverPriority is an ordered list of labels used to sort endpoints to do priority based load balancing. This is to support traffic failover across different groups of endpoints. Two kinds of labels can be specified:<br><p> <br><p>   - Specify only label keys `[key1, key2, key3]`, istio would compare the label values of client with endpoints.<br><p>     Suppose there are total N label keys `[key1, key2, key3, ...keyN]` specified:<br><p> <br><p>     1. Endpoints matching all N labels with the client proxy have priority P(0) i.e. the highest priority.<br><p>     2. Endpoints matching the first N-1 labels with the client proxy have priority P(1) i.e. second highest priority.<br><p>     3. By extension of this logic, endpoints matching only the first label with the client proxy has priority P(N-1) i.e. second lowest priority.<br><p>     4. All the other endpoints have priority P(N) i.e. lowest priority.<br><p> <br><p>   - Specify labels with key and value `[key1=value1, key2=value2, key3=value3]`, istio would compare the labels with endpoints.<br><p>     Suppose there are total N labels `[key1=value1, key2=value2, key3=value3, ...keyN=valueN]` specified:<br><p> <br><p>     1. Endpoints matching all N labels have priority P(0) i.e. the highest priority.<br><p>     2. Endpoints matching the first N-1 labels have priority P(1) i.e. second highest priority.<br><p>     3. By extension of this logic, endpoints matching only the first label has priority P(N-1) i.e. second lowest priority.<br><p>     4. All the other endpoints have priority P(N) i.e. lowest priority.<br><p> <br><p> Note: For a label to be considered for match, the previous labels must match, i.e. nth label would be considered matched only if first n-1 labels match.<br><p> <br><p> It can be any label specified on both client and server workloads. The following labels which have special semantic meaning are also supported:<br><p> <br><p>   - `topology.istio.io/network` is used to match the network metadata of an endpoint, which can be specified by pod/namespace label `topology.istio.io/network`, sidecar env `ISTIO_META_NETWORK` or MeshNetworks.<br><p>   - `topology.istio.io/cluster` is used to match the clusterID of an endpoint, which can be specified by pod label `topology.istio.io/cluster` or pod env `ISTIO_META_CLUSTER_ID`.<br><p>   - `topology.kubernetes.io/region` is used to match the region metadata of an endpoint, which maps to Kubernetes node label `topology.kubernetes.io/region` or the deprecated label `failure-domain.beta.kubernetes.io/region`.<br><p>   - `topology.kubernetes.io/zone` is used to match the zone metadata of an endpoint, which maps to Kubernetes node label `topology.kubernetes.io/zone` or the deprecated label `failure-domain.beta.kubernetes.io/zone`.<br><p>   - `topology.istio.io/subzone` is used to match the subzone metadata of an endpoint, which maps to Istio node label `topology.istio.io/subzone`.<br><p>   - `kubernetes.io/hostname` is used to match the current node of an endpoint, which maps to Kubernetes node label `kubernetes.io/hostname`.<br><p> <br><p> The below topology config indicates the following priority levels:<br><p> <br><p> ```yaml failoverPriority: - "topology.istio.io/network" - "topology.kubernetes.io/region" - "topology.kubernetes.io/zone" - "topology.istio.io/subzone" ```<br><p> <br><p> 1. endpoints match same [network, region, zone, subzone] label with the client proxy have the highest priority. 2. endpoints have same [network, region, zone] label but different [subzone] label with the client proxy have the second highest priority. 3. endpoints have same [network, region] label but different [zone] label with the client proxy have the third highest priority. 4. endpoints have same [network] but different [region] labels with the client proxy have the fourth highest priority. 5. all the other endpoints have the same lowest priority.<br><p> <br><p> Suppose a service associated endpoints reside in multi clusters, the below example represents: 1. endpoints in `clusterA` and has `version=v1` label have P(0) priority. 2. endpoints not in `clusterA` but has `version=v1` label have P(1) priority. 2. all the other endpoints have P(2) priority.<br><p> <br><p> ```yaml failoverPriority: - "version=v1" - "topology.istio.io/cluster=clusterA" ```<br><p> <br><p> Optional: only one of distribute, failover or failoverPriority can be set. And it should be used together with `OutlierDetection` to detect unhealthy endpoints, otherwise has no effect.
+     */
     @JsonProperty("failoverPriority")
     public void setFailoverPriority(List<String> failoverPriority) {
         this.failoverPriority = failoverPriority;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LocalityLoadBalancerSettingDistribute.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LocalityLoadBalancerSettingDistribute.java
index 3ea329d2e2b..6f2ab3c84a2 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LocalityLoadBalancerSettingDistribute.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LocalityLoadBalancerSettingDistribute.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Describes how traffic originating in the 'from' zone or sub-zone is distributed over a set of 'to' zones. Syntax for specifying a zone is {region}/{zone}/{sub-zone} and terminal wildcards are allowed on any segment of the specification. Examples:<br><p> <br><p> `&#42;` - matches all localities<br><p> <br><p> `us-west/&#42;` - all zones and sub-zones within the us-west region<br><p> <br><p> `us-west/zone-1/&#42;` - all sub-zones within us-west/zone-1
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,22 +86,34 @@ public LocalityLoadBalancerSettingDistribute(String from, Map<String, Long> to)
         this.to = to;
     }
 
+    /**
+     * Originating locality, '/' separated, e.g. 'region/zone/sub_zone'.
+     */
     @JsonProperty("from")
     public String getFrom() {
         return from;
     }
 
+    /**
+     * Originating locality, '/' separated, e.g. 'region/zone/sub_zone'.
+     */
     @JsonProperty("from")
     public void setFrom(String from) {
         this.from = from;
     }
 
+    /**
+     * Map of upstream localities to traffic distribution weights. The sum of all weights should be 100. Any locality not present will receive no traffic.
+     */
     @JsonProperty("to")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Long> getTo() {
         return to;
     }
 
+    /**
+     * Map of upstream localities to traffic distribution weights. The sum of all weights should be 100. Any locality not present will receive no traffic.
+     */
     @JsonProperty("to")
     public void setTo(Map<String, Long> to) {
         this.to = to;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LocalityLoadBalancerSettingFailover.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LocalityLoadBalancerSettingFailover.java
index f1d88d51acc..2c92c03bdb3 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LocalityLoadBalancerSettingFailover.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/LocalityLoadBalancerSettingFailover.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Specify the traffic failover policy across regions. Since zone and sub-zone failover is supported by default this only needs to be specified for regions when the operator needs to constrain traffic failover so that the default behavior of failing over to any endpoint globally does not apply. This is useful when failing over traffic across regions would not improve service health or may need to be restricted for other reasons like regulatory controls.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public LocalityLoadBalancerSettingFailover(String from, String to) {
         this.to = to;
     }
 
+    /**
+     * Originating region.
+     */
     @JsonProperty("from")
     public String getFrom() {
         return from;
     }
 
+    /**
+     * Originating region.
+     */
     @JsonProperty("from")
     public void setFrom(String from) {
         this.from = from;
     }
 
+    /**
+     * Destination region the traffic will fail over to when endpoints in the 'from' region becomes unhealthy.
+     */
     @JsonProperty("to")
     public String getTo() {
         return to;
     }
 
+    /**
+     * Destination region the traffic will fail over to when endpoints in the 'from' region becomes unhealthy.
+     */
     @JsonProperty("to")
     public void setTo(String to) {
         this.to = to;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/OutboundTrafficPolicy.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/OutboundTrafficPolicy.java
index 940cea64ed0..cee8d2e8171 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/OutboundTrafficPolicy.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/OutboundTrafficPolicy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * `OutboundTrafficPolicy` sets the default behavior of the sidecar for handling unknown outbound traffic from the application.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public OutboundTrafficPolicy(Destination egressProxy, OutboundTrafficPolicyMode
         this.mode = mode;
     }
 
+    /**
+     * `OutboundTrafficPolicy` sets the default behavior of the sidecar for handling unknown outbound traffic from the application.
+     */
     @JsonProperty("egressProxy")
     public Destination getEgressProxy() {
         return egressProxy;
     }
 
+    /**
+     * `OutboundTrafficPolicy` sets the default behavior of the sidecar for handling unknown outbound traffic from the application.
+     */
     @JsonProperty("egressProxy")
     public void setEgressProxy(Destination egressProxy) {
         this.egressProxy = egressProxy;
     }
 
+    /**
+     * `OutboundTrafficPolicy` sets the default behavior of the sidecar for handling unknown outbound traffic from the application.
+     */
     @JsonProperty("mode")
     public OutboundTrafficPolicyMode getMode() {
         return mode;
     }
 
+    /**
+     * `OutboundTrafficPolicy` sets the default behavior of the sidecar for handling unknown outbound traffic from the application.
+     */
     @JsonProperty("mode")
     public void setMode(OutboundTrafficPolicyMode mode) {
         this.mode = mode;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/OutlierDetection.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/OutlierDetection.java
index 7f49e332ede..43117e66c6b 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/OutlierDetection.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/OutlierDetection.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * A Circuit breaker implementation that tracks the status of each individual host in the upstream service.  Applicable to both HTTP and TCP services.  For HTTP services, hosts that continually return 5xx errors for API calls are ejected from the pool for a pre-defined period of time. For TCP services, connection timeouts or connection failures to a given host counts as an error when measuring the consecutive errors metric. See Envoy's [outlier detection](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/outlier) for more details.<br><p> <br><p> The following rule sets a connection pool size of 100 HTTP1 connections with no more than 10 req/connection to the "reviews" service. In addition, it sets a limit of 1000 concurrent HTTP2 requests and configures upstream hosts to be scanned every 5 mins so that any host that fails 7 consecutive times with a 502, 503, or 504 error code will be ejected for 15 minutes.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: reviews-cb-policy<br><p> <br><p> spec:<br><p> <br><p> 	host: reviews.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  connectionPool:<br><p> 	    tcp:<br><p> 	      maxConnections: 100<br><p> 	    http:<br><p> 	      http2MaxRequests: 1000<br><p> 	      maxRequestsPerConnection: 10<br><p> 	  outlierDetection:<br><p> 	    consecutive5xxErrors: 7<br><p> 	    interval: 5m<br><p> 	    baseEjectionTime: 15m<br><p> <br><p> ```
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -110,91 +113,145 @@ public OutlierDetection(String baseEjectionTime, Integer consecutive5xxErrors, I
         this.splitExternalLocalOriginErrors = splitExternalLocalOriginErrors;
     }
 
+    /**
+     * A Circuit breaker implementation that tracks the status of each individual host in the upstream service.  Applicable to both HTTP and TCP services.  For HTTP services, hosts that continually return 5xx errors for API calls are ejected from the pool for a pre-defined period of time. For TCP services, connection timeouts or connection failures to a given host counts as an error when measuring the consecutive errors metric. See Envoy's [outlier detection](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/outlier) for more details.<br><p> <br><p> The following rule sets a connection pool size of 100 HTTP1 connections with no more than 10 req/connection to the "reviews" service. In addition, it sets a limit of 1000 concurrent HTTP2 requests and configures upstream hosts to be scanned every 5 mins so that any host that fails 7 consecutive times with a 502, 503, or 504 error code will be ejected for 15 minutes.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: reviews-cb-policy<br><p> <br><p> spec:<br><p> <br><p> 	host: reviews.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  connectionPool:<br><p> 	    tcp:<br><p> 	      maxConnections: 100<br><p> 	    http:<br><p> 	      http2MaxRequests: 1000<br><p> 	      maxRequestsPerConnection: 10<br><p> 	  outlierDetection:<br><p> 	    consecutive5xxErrors: 7<br><p> 	    interval: 5m<br><p> 	    baseEjectionTime: 15m<br><p> <br><p> ```
+     */
     @JsonProperty("baseEjectionTime")
     public String getBaseEjectionTime() {
         return baseEjectionTime;
     }
 
+    /**
+     * A Circuit breaker implementation that tracks the status of each individual host in the upstream service.  Applicable to both HTTP and TCP services.  For HTTP services, hosts that continually return 5xx errors for API calls are ejected from the pool for a pre-defined period of time. For TCP services, connection timeouts or connection failures to a given host counts as an error when measuring the consecutive errors metric. See Envoy's [outlier detection](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/outlier) for more details.<br><p> <br><p> The following rule sets a connection pool size of 100 HTTP1 connections with no more than 10 req/connection to the "reviews" service. In addition, it sets a limit of 1000 concurrent HTTP2 requests and configures upstream hosts to be scanned every 5 mins so that any host that fails 7 consecutive times with a 502, 503, or 504 error code will be ejected for 15 minutes.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: reviews-cb-policy<br><p> <br><p> spec:<br><p> <br><p> 	host: reviews.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  connectionPool:<br><p> 	    tcp:<br><p> 	      maxConnections: 100<br><p> 	    http:<br><p> 	      http2MaxRequests: 1000<br><p> 	      maxRequestsPerConnection: 10<br><p> 	  outlierDetection:<br><p> 	    consecutive5xxErrors: 7<br><p> 	    interval: 5m<br><p> 	    baseEjectionTime: 15m<br><p> <br><p> ```
+     */
     @JsonProperty("baseEjectionTime")
     public void setBaseEjectionTime(String baseEjectionTime) {
         this.baseEjectionTime = baseEjectionTime;
     }
 
+    /**
+     * A Circuit breaker implementation that tracks the status of each individual host in the upstream service.  Applicable to both HTTP and TCP services.  For HTTP services, hosts that continually return 5xx errors for API calls are ejected from the pool for a pre-defined period of time. For TCP services, connection timeouts or connection failures to a given host counts as an error when measuring the consecutive errors metric. See Envoy's [outlier detection](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/outlier) for more details.<br><p> <br><p> The following rule sets a connection pool size of 100 HTTP1 connections with no more than 10 req/connection to the "reviews" service. In addition, it sets a limit of 1000 concurrent HTTP2 requests and configures upstream hosts to be scanned every 5 mins so that any host that fails 7 consecutive times with a 502, 503, or 504 error code will be ejected for 15 minutes.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: reviews-cb-policy<br><p> <br><p> spec:<br><p> <br><p> 	host: reviews.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  connectionPool:<br><p> 	    tcp:<br><p> 	      maxConnections: 100<br><p> 	    http:<br><p> 	      http2MaxRequests: 1000<br><p> 	      maxRequestsPerConnection: 10<br><p> 	  outlierDetection:<br><p> 	    consecutive5xxErrors: 7<br><p> 	    interval: 5m<br><p> 	    baseEjectionTime: 15m<br><p> <br><p> ```
+     */
     @JsonProperty("consecutive5xxErrors")
     public Integer getConsecutive5xxErrors() {
         return consecutive5xxErrors;
     }
 
+    /**
+     * A Circuit breaker implementation that tracks the status of each individual host in the upstream service.  Applicable to both HTTP and TCP services.  For HTTP services, hosts that continually return 5xx errors for API calls are ejected from the pool for a pre-defined period of time. For TCP services, connection timeouts or connection failures to a given host counts as an error when measuring the consecutive errors metric. See Envoy's [outlier detection](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/outlier) for more details.<br><p> <br><p> The following rule sets a connection pool size of 100 HTTP1 connections with no more than 10 req/connection to the "reviews" service. In addition, it sets a limit of 1000 concurrent HTTP2 requests and configures upstream hosts to be scanned every 5 mins so that any host that fails 7 consecutive times with a 502, 503, or 504 error code will be ejected for 15 minutes.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: reviews-cb-policy<br><p> <br><p> spec:<br><p> <br><p> 	host: reviews.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  connectionPool:<br><p> 	    tcp:<br><p> 	      maxConnections: 100<br><p> 	    http:<br><p> 	      http2MaxRequests: 1000<br><p> 	      maxRequestsPerConnection: 10<br><p> 	  outlierDetection:<br><p> 	    consecutive5xxErrors: 7<br><p> 	    interval: 5m<br><p> 	    baseEjectionTime: 15m<br><p> <br><p> ```
+     */
     @JsonProperty("consecutive5xxErrors")
     public void setConsecutive5xxErrors(Integer consecutive5xxErrors) {
         this.consecutive5xxErrors = consecutive5xxErrors;
     }
 
+    /**
+     * Number of errors before a host is ejected from the connection pool. Defaults to 5. When the upstream host is accessed over HTTP, a 502, 503, or 504 return code qualifies as an error. When the upstream host is accessed over an opaque TCP connection, connect timeouts and connection error/failure events qualify as an error. $hide_from_docs<br><p> <br><p> Deprecated: Marked as deprecated in networking/v1alpha3/destination_rule.proto.
+     */
     @JsonProperty("consecutiveErrors")
     public Integer getConsecutiveErrors() {
         return consecutiveErrors;
     }
 
+    /**
+     * Number of errors before a host is ejected from the connection pool. Defaults to 5. When the upstream host is accessed over HTTP, a 502, 503, or 504 return code qualifies as an error. When the upstream host is accessed over an opaque TCP connection, connect timeouts and connection error/failure events qualify as an error. $hide_from_docs<br><p> <br><p> Deprecated: Marked as deprecated in networking/v1alpha3/destination_rule.proto.
+     */
     @JsonProperty("consecutiveErrors")
     public void setConsecutiveErrors(Integer consecutiveErrors) {
         this.consecutiveErrors = consecutiveErrors;
     }
 
+    /**
+     * A Circuit breaker implementation that tracks the status of each individual host in the upstream service.  Applicable to both HTTP and TCP services.  For HTTP services, hosts that continually return 5xx errors for API calls are ejected from the pool for a pre-defined period of time. For TCP services, connection timeouts or connection failures to a given host counts as an error when measuring the consecutive errors metric. See Envoy's [outlier detection](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/outlier) for more details.<br><p> <br><p> The following rule sets a connection pool size of 100 HTTP1 connections with no more than 10 req/connection to the "reviews" service. In addition, it sets a limit of 1000 concurrent HTTP2 requests and configures upstream hosts to be scanned every 5 mins so that any host that fails 7 consecutive times with a 502, 503, or 504 error code will be ejected for 15 minutes.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: reviews-cb-policy<br><p> <br><p> spec:<br><p> <br><p> 	host: reviews.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  connectionPool:<br><p> 	    tcp:<br><p> 	      maxConnections: 100<br><p> 	    http:<br><p> 	      http2MaxRequests: 1000<br><p> 	      maxRequestsPerConnection: 10<br><p> 	  outlierDetection:<br><p> 	    consecutive5xxErrors: 7<br><p> 	    interval: 5m<br><p> 	    baseEjectionTime: 15m<br><p> <br><p> ```
+     */
     @JsonProperty("consecutiveGatewayErrors")
     public Integer getConsecutiveGatewayErrors() {
         return consecutiveGatewayErrors;
     }
 
+    /**
+     * A Circuit breaker implementation that tracks the status of each individual host in the upstream service.  Applicable to both HTTP and TCP services.  For HTTP services, hosts that continually return 5xx errors for API calls are ejected from the pool for a pre-defined period of time. For TCP services, connection timeouts or connection failures to a given host counts as an error when measuring the consecutive errors metric. See Envoy's [outlier detection](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/outlier) for more details.<br><p> <br><p> The following rule sets a connection pool size of 100 HTTP1 connections with no more than 10 req/connection to the "reviews" service. In addition, it sets a limit of 1000 concurrent HTTP2 requests and configures upstream hosts to be scanned every 5 mins so that any host that fails 7 consecutive times with a 502, 503, or 504 error code will be ejected for 15 minutes.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: reviews-cb-policy<br><p> <br><p> spec:<br><p> <br><p> 	host: reviews.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  connectionPool:<br><p> 	    tcp:<br><p> 	      maxConnections: 100<br><p> 	    http:<br><p> 	      http2MaxRequests: 1000<br><p> 	      maxRequestsPerConnection: 10<br><p> 	  outlierDetection:<br><p> 	    consecutive5xxErrors: 7<br><p> 	    interval: 5m<br><p> 	    baseEjectionTime: 15m<br><p> <br><p> ```
+     */
     @JsonProperty("consecutiveGatewayErrors")
     public void setConsecutiveGatewayErrors(Integer consecutiveGatewayErrors) {
         this.consecutiveGatewayErrors = consecutiveGatewayErrors;
     }
 
+    /**
+     * A Circuit breaker implementation that tracks the status of each individual host in the upstream service.  Applicable to both HTTP and TCP services.  For HTTP services, hosts that continually return 5xx errors for API calls are ejected from the pool for a pre-defined period of time. For TCP services, connection timeouts or connection failures to a given host counts as an error when measuring the consecutive errors metric. See Envoy's [outlier detection](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/outlier) for more details.<br><p> <br><p> The following rule sets a connection pool size of 100 HTTP1 connections with no more than 10 req/connection to the "reviews" service. In addition, it sets a limit of 1000 concurrent HTTP2 requests and configures upstream hosts to be scanned every 5 mins so that any host that fails 7 consecutive times with a 502, 503, or 504 error code will be ejected for 15 minutes.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: reviews-cb-policy<br><p> <br><p> spec:<br><p> <br><p> 	host: reviews.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  connectionPool:<br><p> 	    tcp:<br><p> 	      maxConnections: 100<br><p> 	    http:<br><p> 	      http2MaxRequests: 1000<br><p> 	      maxRequestsPerConnection: 10<br><p> 	  outlierDetection:<br><p> 	    consecutive5xxErrors: 7<br><p> 	    interval: 5m<br><p> 	    baseEjectionTime: 15m<br><p> <br><p> ```
+     */
     @JsonProperty("consecutiveLocalOriginFailures")
     public Integer getConsecutiveLocalOriginFailures() {
         return consecutiveLocalOriginFailures;
     }
 
+    /**
+     * A Circuit breaker implementation that tracks the status of each individual host in the upstream service.  Applicable to both HTTP and TCP services.  For HTTP services, hosts that continually return 5xx errors for API calls are ejected from the pool for a pre-defined period of time. For TCP services, connection timeouts or connection failures to a given host counts as an error when measuring the consecutive errors metric. See Envoy's [outlier detection](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/outlier) for more details.<br><p> <br><p> The following rule sets a connection pool size of 100 HTTP1 connections with no more than 10 req/connection to the "reviews" service. In addition, it sets a limit of 1000 concurrent HTTP2 requests and configures upstream hosts to be scanned every 5 mins so that any host that fails 7 consecutive times with a 502, 503, or 504 error code will be ejected for 15 minutes.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: reviews-cb-policy<br><p> <br><p> spec:<br><p> <br><p> 	host: reviews.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  connectionPool:<br><p> 	    tcp:<br><p> 	      maxConnections: 100<br><p> 	    http:<br><p> 	      http2MaxRequests: 1000<br><p> 	      maxRequestsPerConnection: 10<br><p> 	  outlierDetection:<br><p> 	    consecutive5xxErrors: 7<br><p> 	    interval: 5m<br><p> 	    baseEjectionTime: 15m<br><p> <br><p> ```
+     */
     @JsonProperty("consecutiveLocalOriginFailures")
     public void setConsecutiveLocalOriginFailures(Integer consecutiveLocalOriginFailures) {
         this.consecutiveLocalOriginFailures = consecutiveLocalOriginFailures;
     }
 
+    /**
+     * A Circuit breaker implementation that tracks the status of each individual host in the upstream service.  Applicable to both HTTP and TCP services.  For HTTP services, hosts that continually return 5xx errors for API calls are ejected from the pool for a pre-defined period of time. For TCP services, connection timeouts or connection failures to a given host counts as an error when measuring the consecutive errors metric. See Envoy's [outlier detection](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/outlier) for more details.<br><p> <br><p> The following rule sets a connection pool size of 100 HTTP1 connections with no more than 10 req/connection to the "reviews" service. In addition, it sets a limit of 1000 concurrent HTTP2 requests and configures upstream hosts to be scanned every 5 mins so that any host that fails 7 consecutive times with a 502, 503, or 504 error code will be ejected for 15 minutes.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: reviews-cb-policy<br><p> <br><p> spec:<br><p> <br><p> 	host: reviews.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  connectionPool:<br><p> 	    tcp:<br><p> 	      maxConnections: 100<br><p> 	    http:<br><p> 	      http2MaxRequests: 1000<br><p> 	      maxRequestsPerConnection: 10<br><p> 	  outlierDetection:<br><p> 	    consecutive5xxErrors: 7<br><p> 	    interval: 5m<br><p> 	    baseEjectionTime: 15m<br><p> <br><p> ```
+     */
     @JsonProperty("interval")
     public String getInterval() {
         return interval;
     }
 
+    /**
+     * A Circuit breaker implementation that tracks the status of each individual host in the upstream service.  Applicable to both HTTP and TCP services.  For HTTP services, hosts that continually return 5xx errors for API calls are ejected from the pool for a pre-defined period of time. For TCP services, connection timeouts or connection failures to a given host counts as an error when measuring the consecutive errors metric. See Envoy's [outlier detection](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/outlier) for more details.<br><p> <br><p> The following rule sets a connection pool size of 100 HTTP1 connections with no more than 10 req/connection to the "reviews" service. In addition, it sets a limit of 1000 concurrent HTTP2 requests and configures upstream hosts to be scanned every 5 mins so that any host that fails 7 consecutive times with a 502, 503, or 504 error code will be ejected for 15 minutes.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: reviews-cb-policy<br><p> <br><p> spec:<br><p> <br><p> 	host: reviews.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  connectionPool:<br><p> 	    tcp:<br><p> 	      maxConnections: 100<br><p> 	    http:<br><p> 	      http2MaxRequests: 1000<br><p> 	      maxRequestsPerConnection: 10<br><p> 	  outlierDetection:<br><p> 	    consecutive5xxErrors: 7<br><p> 	    interval: 5m<br><p> 	    baseEjectionTime: 15m<br><p> <br><p> ```
+     */
     @JsonProperty("interval")
     public void setInterval(String interval) {
         this.interval = interval;
     }
 
+    /**
+     * Maximum % of hosts in the load balancing pool for the upstream service that can be ejected. Defaults to 10%.
+     */
     @JsonProperty("maxEjectionPercent")
     public Integer getMaxEjectionPercent() {
         return maxEjectionPercent;
     }
 
+    /**
+     * Maximum % of hosts in the load balancing pool for the upstream service that can be ejected. Defaults to 10%.
+     */
     @JsonProperty("maxEjectionPercent")
     public void setMaxEjectionPercent(Integer maxEjectionPercent) {
         this.maxEjectionPercent = maxEjectionPercent;
     }
 
+    /**
+     * Outlier detection will be enabled as long as the associated load balancing pool has at least min_health_percent hosts in healthy mode. When the percentage of healthy hosts in the load balancing pool drops below this threshold, outlier detection will be disabled and the proxy will load balance across all hosts in the pool (healthy and unhealthy). The threshold can be disabled by setting it to 0%. The default is 0% as it's not typically applicable in k8s environments with few pods per service.
+     */
     @JsonProperty("minHealthPercent")
     public Integer getMinHealthPercent() {
         return minHealthPercent;
     }
 
+    /**
+     * Outlier detection will be enabled as long as the associated load balancing pool has at least min_health_percent hosts in healthy mode. When the percentage of healthy hosts in the load balancing pool drops below this threshold, outlier detection will be disabled and the proxy will load balance across all hosts in the pool (healthy and unhealthy). The threshold can be disabled by setting it to 0%. The default is 0% as it's not typically applicable in k8s environments with few pods per service.
+     */
     @JsonProperty("minHealthPercent")
     public void setMinHealthPercent(Integer minHealthPercent) {
         this.minHealthPercent = minHealthPercent;
     }
 
+    /**
+     * Determines whether to distinguish local origin failures from external errors. If set to true consecutive_local_origin_failure is taken into account for outlier detection calculations. This should be used when you want to derive the outlier detection status based on the errors seen locally such as failure to connect, timeout while connecting etc. rather than the status code returned by upstream service. This is especially useful when the upstream service explicitly returns a 5xx for some requests and you want to ignore those responses from upstream service while determining the outlier detection status of a host. Defaults to false.
+     */
     @JsonProperty("splitExternalLocalOriginErrors")
     public Boolean getSplitExternalLocalOriginErrors() {
         return splitExternalLocalOriginErrors;
     }
 
+    /**
+     * Determines whether to distinguish local origin failures from external errors. If set to true consecutive_local_origin_failure is taken into account for outlier detection calculations. This should be used when you want to derive the outlier detection status based on the errors seen locally such as failure to connect, timeout while connecting etc. rather than the status code returned by upstream service. This is especially useful when the upstream service explicitly returns a 5xx for some requests and you want to ignore those responses from upstream service while determining the outlier detection status of a host. Defaults to false.
+     */
     @JsonProperty("splitExternalLocalOriginErrors")
     public void setSplitExternalLocalOriginErrors(Boolean splitExternalLocalOriginErrors) {
         this.splitExternalLocalOriginErrors = splitExternalLocalOriginErrors;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Percent.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Percent.java
index 22715235bab..ddb94e5cca6 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Percent.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Percent.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Percent specifies a percentage in the range of [0.0, 100.0].
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public Percent(Double value) {
         this.value = value;
     }
 
+    /**
+     * Percent specifies a percentage in the range of [0.0, 100.0].
+     */
     @JsonProperty("value")
     public Double getValue() {
         return value;
     }
 
+    /**
+     * Percent specifies a percentage in the range of [0.0, 100.0].
+     */
     @JsonProperty("value")
     public void setValue(Double value) {
         this.value = value;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Port.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Port.java
index 2660ff5c724..6910a69a131 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Port.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Port.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Port describes the properties of a specific port of a service.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public Port(String name, Long number, String protocol, Long targetPort) {
         this.targetPort = targetPort;
     }
 
+    /**
+     * Label assigned to the port.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Label assigned to the port.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * A valid non-negative integer port number.
+     */
     @JsonProperty("number")
     public Long getNumber() {
         return number;
     }
 
+    /**
+     * A valid non-negative integer port number.
+     */
     @JsonProperty("number")
     public void setNumber(Long number) {
         this.number = number;
     }
 
+    /**
+     * The protocol exposed on the port. MUST BE one of HTTP|HTTPS|GRPC|GRPC-WEB|HTTP2|MONGO|TCP|TLS. TLS can be either used to terminate non-HTTP based connections on a specific port or to route traffic based on SNI header to the destination without terminating the TLS connection.
+     */
     @JsonProperty("protocol")
     public String getProtocol() {
         return protocol;
     }
 
+    /**
+     * The protocol exposed on the port. MUST BE one of HTTP|HTTPS|GRPC|GRPC-WEB|HTTP2|MONGO|TCP|TLS. TLS can be either used to terminate non-HTTP based connections on a specific port or to route traffic based on SNI header to the destination without terminating the TLS connection.
+     */
     @JsonProperty("protocol")
     public void setProtocol(String protocol) {
         this.protocol = protocol;
     }
 
+    /**
+     * The port number on the endpoint where the traffic will be received. Applicable only when used with ServiceEntries. $hide_from_docs<br><p> <br><p> Deprecated: Marked as deprecated in networking/v1alpha3/gateway.proto.
+     */
     @JsonProperty("targetPort")
     public Long getTargetPort() {
         return targetPort;
     }
 
+    /**
+     * The port number on the endpoint where the traffic will be received. Applicable only when used with ServiceEntries. $hide_from_docs<br><p> <br><p> Deprecated: Marked as deprecated in networking/v1alpha3/gateway.proto.
+     */
     @JsonProperty("targetPort")
     public void setTargetPort(Long targetPort) {
         this.targetPort = targetPort;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/PortSelector.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/PortSelector.java
index e514d90b8e6..a83b17b29a4 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/PortSelector.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/PortSelector.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PortSelector specifies the number of a port to be used for matching or selection for final routing.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public PortSelector(Long number) {
         this.number = number;
     }
 
+    /**
+     * Valid port number
+     */
     @JsonProperty("number")
     public Long getNumber() {
         return number;
     }
 
+    /**
+     * Valid port number
+     */
     @JsonProperty("number")
     public void setNumber(Long number) {
         this.number = number;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ReadinessProbe.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ReadinessProbe.java
index 282c896f102..b14d174783a 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ReadinessProbe.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ReadinessProbe.java
@@ -111,51 +111,81 @@ public void setHealthCheckMethod(IsReadinessProbeHealthCheckMethod healthCheckMe
         this.healthCheckMethod = healthCheckMethod;
     }
 
+    /**
+     * Minimum consecutive failures for the probe to be considered failed after having succeeded. Defaults to 3 seconds.
+     */
     @JsonProperty("failureThreshold")
     public Integer getFailureThreshold() {
         return failureThreshold;
     }
 
+    /**
+     * Minimum consecutive failures for the probe to be considered failed after having succeeded. Defaults to 3 seconds.
+     */
     @JsonProperty("failureThreshold")
     public void setFailureThreshold(Integer failureThreshold) {
         this.failureThreshold = failureThreshold;
     }
 
+    /**
+     * Number of seconds after the container has started before readiness probes are initiated.
+     */
     @JsonProperty("initialDelaySeconds")
     public Integer getInitialDelaySeconds() {
         return initialDelaySeconds;
     }
 
+    /**
+     * Number of seconds after the container has started before readiness probes are initiated.
+     */
     @JsonProperty("initialDelaySeconds")
     public void setInitialDelaySeconds(Integer initialDelaySeconds) {
         this.initialDelaySeconds = initialDelaySeconds;
     }
 
+    /**
+     * How often (in seconds) to perform the probe. Default to 10 seconds. Minimum value is 1 second.
+     */
     @JsonProperty("periodSeconds")
     public Integer getPeriodSeconds() {
         return periodSeconds;
     }
 
+    /**
+     * How often (in seconds) to perform the probe. Default to 10 seconds. Minimum value is 1 second.
+     */
     @JsonProperty("periodSeconds")
     public void setPeriodSeconds(Integer periodSeconds) {
         this.periodSeconds = periodSeconds;
     }
 
+    /**
+     * Minimum consecutive successes for the probe to be considered successful after having failed. Defaults to 1 second.
+     */
     @JsonProperty("successThreshold")
     public Integer getSuccessThreshold() {
         return successThreshold;
     }
 
+    /**
+     * Minimum consecutive successes for the probe to be considered successful after having failed. Defaults to 1 second.
+     */
     @JsonProperty("successThreshold")
     public void setSuccessThreshold(Integer successThreshold) {
         this.successThreshold = successThreshold;
     }
 
+    /**
+     * Number of seconds after which the probe times out. Defaults to 1 second. Minimum value is 1 second.
+     */
     @JsonProperty("timeoutSeconds")
     public Integer getTimeoutSeconds() {
         return timeoutSeconds;
     }
 
+    /**
+     * Number of seconds after which the probe times out. Defaults to 1 second. Minimum value is 1 second.
+     */
     @JsonProperty("timeoutSeconds")
     public void setTimeoutSeconds(Integer timeoutSeconds) {
         this.timeoutSeconds = timeoutSeconds;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ReadinessProbeExec.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ReadinessProbeExec.java
index fb12a47ab2d..949bc9bc0ec 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ReadinessProbeExec.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ReadinessProbeExec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Health is determined by how the command that is executed exited.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ReadinessProbeExec(ExecHealthCheckConfig exec) {
         this.exec = exec;
     }
 
+    /**
+     * Health is determined by how the command that is executed exited.
+     */
     @JsonProperty("exec")
     public ExecHealthCheckConfig getExec() {
         return exec;
     }
 
+    /**
+     * Health is determined by how the command that is executed exited.
+     */
     @JsonProperty("exec")
     public void setExec(ExecHealthCheckConfig exec) {
         this.exec = exec;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ReadinessProbeHttpGet.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ReadinessProbeHttpGet.java
index 8c46759715a..8e5d4de3064 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ReadinessProbeHttpGet.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ReadinessProbeHttpGet.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * `httpGet` is performed to a given endpoint and the status/able to connect determines health.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ReadinessProbeHttpGet(HTTPHealthCheckConfig httpGet) {
         this.httpGet = httpGet;
     }
 
+    /**
+     * `httpGet` is performed to a given endpoint and the status/able to connect determines health.
+     */
     @JsonProperty("httpGet")
     public HTTPHealthCheckConfig getHttpGet() {
         return httpGet;
     }
 
+    /**
+     * `httpGet` is performed to a given endpoint and the status/able to connect determines health.
+     */
     @JsonProperty("httpGet")
     public void setHttpGet(HTTPHealthCheckConfig httpGet) {
         this.httpGet = httpGet;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ReadinessProbeTcpSocket.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ReadinessProbeTcpSocket.java
index d7972b055c2..1475d267688 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ReadinessProbeTcpSocket.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ReadinessProbeTcpSocket.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Health is determined by if the proxy is able to connect.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ReadinessProbeTcpSocket(TCPHealthCheckConfig tcpSocket) {
         this.tcpSocket = tcpSocket;
     }
 
+    /**
+     * Health is determined by if the proxy is able to connect.
+     */
     @JsonProperty("tcpSocket")
     public TCPHealthCheckConfig getTcpSocket() {
         return tcpSocket;
     }
 
+    /**
+     * Health is determined by if the proxy is able to connect.
+     */
     @JsonProperty("tcpSocket")
     public void setTcpSocket(TCPHealthCheckConfig tcpSocket) {
         this.tcpSocket = tcpSocket;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/RegexRewrite.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/RegexRewrite.java
index 99c46a41444..454d6139a02 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/RegexRewrite.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/RegexRewrite.java
@@ -82,21 +82,33 @@ public RegexRewrite(String match, String rewrite) {
         this.rewrite = rewrite;
     }
 
+    /**
+     * [RE2 style regex-based match](https://github.com/google/re2/wiki/Syntax).
+     */
     @JsonProperty("match")
     public String getMatch() {
         return match;
     }
 
+    /**
+     * [RE2 style regex-based match](https://github.com/google/re2/wiki/Syntax).
+     */
     @JsonProperty("match")
     public void setMatch(String match) {
         this.match = match;
     }
 
+    /**
+     * The string that should replace into matching portions of original URI. Capture groups in the pattern can be referenced in the new URI. Examples:<br><p> <br><p> Example 1: rewrite with capture groups Path pattern "/service/update/v1/api" with match "^/service/([^/]+)(/.&#42;)$" and rewrite string of "/customprefix/\2/\1" would transform into "/customprefix/v1/api/update".<br><p> <br><p> Example 2: case insensitive rewrite Path pattern "/aaa/XxX/bbb" with match "(?i)/xxx/" and a rewrite string of /yyy/ would do a case-insensitive match and transform the path to "/aaa/yyy/bbb".
+     */
     @JsonProperty("rewrite")
     public String getRewrite() {
         return rewrite;
     }
 
+    /**
+     * The string that should replace into matching portions of original URI. Capture groups in the pattern can be referenced in the new URI. Examples:<br><p> <br><p> Example 1: rewrite with capture groups Path pattern "/service/update/v1/api" with match "^/service/([^/]+)(/.&#42;)$" and rewrite string of "/customprefix/\2/\1" would transform into "/customprefix/v1/api/update".<br><p> <br><p> Example 2: case insensitive rewrite Path pattern "/aaa/XxX/bbb" with match "(?i)/xxx/" and a rewrite string of /yyy/ would do a case-insensitive match and transform the path to "/aaa/yyy/bbb".
+     */
     @JsonProperty("rewrite")
     public void setRewrite(String rewrite) {
         this.rewrite = rewrite;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/RouteDestination.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/RouteDestination.java
index 8c8c14ae7f3..58967ea01d7 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/RouteDestination.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/RouteDestination.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * L4 routing rule weighted destination.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public RouteDestination(Destination destination, Integer weight) {
         this.weight = weight;
     }
 
+    /**
+     * L4 routing rule weighted destination.
+     */
     @JsonProperty("destination")
     public Destination getDestination() {
         return destination;
     }
 
+    /**
+     * L4 routing rule weighted destination.
+     */
     @JsonProperty("destination")
     public void setDestination(Destination destination) {
         this.destination = destination;
     }
 
+    /**
+     * Weight specifies the relative proportion of traffic to be forwarded to the destination. A destination will receive `weight/(sum of all weights)` requests. If there is only one destination in a rule, it will receive all traffic. Otherwise, if weight is `0`, the destination will not receive any traffic.
+     */
     @JsonProperty("weight")
     public Integer getWeight() {
         return weight;
     }
 
+    /**
+     * Weight specifies the relative proportion of traffic to be forwarded to the destination. A destination will receive `weight/(sum of all weights)` requests. If there is only one destination in a rule, it will receive all traffic. Otherwise, if weight is `0`, the destination will not receive any traffic.
+     */
     @JsonProperty("weight")
     public void setWeight(Integer weight) {
         this.weight = weight;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Server.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Server.java
index 10f4dd49b54..26552fa5b26 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Server.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Server.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * `Server` describes the properties of the proxy on a given load balancer port. For example,<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: Gateway metadata:<br><p> <br><p> 	name: my-ingress<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  app: my-ingressgateway<br><p> 	servers:<br><p> 	- port:<br><p> 	    number: 80<br><p> 	    name: http2<br><p> 	    protocol: HTTP2<br><p> 	  hosts:<br><p> 	  - "&#42;"<br><p> <br><p> ```<br><p> <br><p> # Another example<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: Gateway metadata:<br><p> <br><p> 	name: my-tcp-ingress<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  app: my-tcp-ingressgateway<br><p> 	servers:<br><p> 	- port:<br><p> 	    number: 27018<br><p> 	    name: mongo<br><p> 	    protocol: MONGO<br><p> 	  hosts:<br><p> 	  - "&#42;"<br><p> <br><p> ```<br><p> <br><p> # The following is an example of TLS configuration for port 443<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: Gateway metadata:<br><p> <br><p> 	name: my-tls-ingress<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  app: my-tls-ingressgateway<br><p> 	servers:<br><p> 	- port:<br><p> 	    number: 443<br><p> 	    name: https<br><p> 	    protocol: HTTPS<br><p> 	  hosts:<br><p> 	  - "&#42;"<br><p> 	  tls:<br><p> 	    mode: SIMPLE<br><p> 	    credentialName: tls-cert<br><p> <br><p> ```
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,62 +104,98 @@ public Server(String bind, String defaultEndpoint, List<String> hosts, String na
         this.tls = tls;
     }
 
+    /**
+     * The ip or the Unix domain socket to which the listener should be bound to. Format: `x.x.x.x` or `unix:///path/to/uds` or `unix://@foobar` (Linux abstract namespace). When using Unix domain sockets, the port number should be 0. This can be used to restrict the reachability of this server to be gateway internal only. This is typically used when a gateway needs to communicate to another mesh service e.g. publishing metrics. In such case, the server created with the specified bind will not be available to external gateway clients.
+     */
     @JsonProperty("bind")
     public String getBind() {
         return bind;
     }
 
+    /**
+     * The ip or the Unix domain socket to which the listener should be bound to. Format: `x.x.x.x` or `unix:///path/to/uds` or `unix://@foobar` (Linux abstract namespace). When using Unix domain sockets, the port number should be 0. This can be used to restrict the reachability of this server to be gateway internal only. This is typically used when a gateway needs to communicate to another mesh service e.g. publishing metrics. In such case, the server created with the specified bind will not be available to external gateway clients.
+     */
     @JsonProperty("bind")
     public void setBind(String bind) {
         this.bind = bind;
     }
 
+    /**
+     * The loopback IP endpoint or Unix domain socket to which traffic should be forwarded to by default. Format should be `127.0.0.1:PORT` or `unix:///path/to/socket` or `unix://@foobar` (Linux abstract namespace). NOT IMPLEMENTED. $hide_from_docs
+     */
     @JsonProperty("defaultEndpoint")
     public String getDefaultEndpoint() {
         return defaultEndpoint;
     }
 
+    /**
+     * The loopback IP endpoint or Unix domain socket to which traffic should be forwarded to by default. Format should be `127.0.0.1:PORT` or `unix:///path/to/socket` or `unix://@foobar` (Linux abstract namespace). NOT IMPLEMENTED. $hide_from_docs
+     */
     @JsonProperty("defaultEndpoint")
     public void setDefaultEndpoint(String defaultEndpoint) {
         this.defaultEndpoint = defaultEndpoint;
     }
 
+    /**
+     * One or more hosts exposed by this gateway. While typically applicable to HTTP services, it can also be used for TCP services using TLS with SNI. A host is specified as a `dnsName` with an optional `namespace/` prefix. The `dnsName` should be specified using FQDN format, optionally including a wildcard character in the left-most component (e.g., `prod/&#42;.example.com`). Set the `dnsName` to `&#42;` to select all `VirtualService` hosts from the specified namespace (e.g.,`prod/&#42;`).<br><p> <br><p> The `namespace` can be set to `&#42;` or `.`, representing any or the current namespace, respectively. For example, `&#42;/foo.example.com` selects the service from any available namespace while `./foo.example.com` only selects the service from the namespace of the sidecar. The default, if no `namespace/` is specified, is `&#42;/`, that is, select services from any namespace. Any associated `DestinationRule` in the selected namespace will also be used.<br><p> <br><p> A `VirtualService` must be bound to the gateway and must have one or more hosts that match the hosts specified in a server. The match could be an exact match or a suffix match with the server's hosts. For example, if the server's hosts specifies `&#42;.example.com`, a `VirtualService` with hosts `dev.example.com` or `prod.example.com` will match. However, a `VirtualService` with host `example.com` or `newexample.com` will not match.<br><p> <br><p> NOTE: Only virtual services exported to the gateway's namespace (e.g., `exportTo` value of `&#42;`) can be referenced. Private configurations (e.g., `exportTo` set to `.`) will not be available. Refer to the `exportTo` setting in `VirtualService`, `DestinationRule`, and `ServiceEntry` configurations for details.
+     */
     @JsonProperty("hosts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getHosts() {
         return hosts;
     }
 
+    /**
+     * One or more hosts exposed by this gateway. While typically applicable to HTTP services, it can also be used for TCP services using TLS with SNI. A host is specified as a `dnsName` with an optional `namespace/` prefix. The `dnsName` should be specified using FQDN format, optionally including a wildcard character in the left-most component (e.g., `prod/&#42;.example.com`). Set the `dnsName` to `&#42;` to select all `VirtualService` hosts from the specified namespace (e.g.,`prod/&#42;`).<br><p> <br><p> The `namespace` can be set to `&#42;` or `.`, representing any or the current namespace, respectively. For example, `&#42;/foo.example.com` selects the service from any available namespace while `./foo.example.com` only selects the service from the namespace of the sidecar. The default, if no `namespace/` is specified, is `&#42;/`, that is, select services from any namespace. Any associated `DestinationRule` in the selected namespace will also be used.<br><p> <br><p> A `VirtualService` must be bound to the gateway and must have one or more hosts that match the hosts specified in a server. The match could be an exact match or a suffix match with the server's hosts. For example, if the server's hosts specifies `&#42;.example.com`, a `VirtualService` with hosts `dev.example.com` or `prod.example.com` will match. However, a `VirtualService` with host `example.com` or `newexample.com` will not match.<br><p> <br><p> NOTE: Only virtual services exported to the gateway's namespace (e.g., `exportTo` value of `&#42;`) can be referenced. Private configurations (e.g., `exportTo` set to `.`) will not be available. Refer to the `exportTo` setting in `VirtualService`, `DestinationRule`, and `ServiceEntry` configurations for details.
+     */
     @JsonProperty("hosts")
     public void setHosts(List<String> hosts) {
         this.hosts = hosts;
     }
 
+    /**
+     * An optional name of the server, when set must be unique across all servers. This will be used for variety of purposes like prefixing stats generated with this name etc.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * An optional name of the server, when set must be unique across all servers. This will be used for variety of purposes like prefixing stats generated with this name etc.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * `Server` describes the properties of the proxy on a given load balancer port. For example,<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: Gateway metadata:<br><p> <br><p> 	name: my-ingress<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  app: my-ingressgateway<br><p> 	servers:<br><p> 	- port:<br><p> 	    number: 80<br><p> 	    name: http2<br><p> 	    protocol: HTTP2<br><p> 	  hosts:<br><p> 	  - "&#42;"<br><p> <br><p> ```<br><p> <br><p> # Another example<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: Gateway metadata:<br><p> <br><p> 	name: my-tcp-ingress<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  app: my-tcp-ingressgateway<br><p> 	servers:<br><p> 	- port:<br><p> 	    number: 27018<br><p> 	    name: mongo<br><p> 	    protocol: MONGO<br><p> 	  hosts:<br><p> 	  - "&#42;"<br><p> <br><p> ```<br><p> <br><p> # The following is an example of TLS configuration for port 443<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: Gateway metadata:<br><p> <br><p> 	name: my-tls-ingress<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  app: my-tls-ingressgateway<br><p> 	servers:<br><p> 	- port:<br><p> 	    number: 443<br><p> 	    name: https<br><p> 	    protocol: HTTPS<br><p> 	  hosts:<br><p> 	  - "&#42;"<br><p> 	  tls:<br><p> 	    mode: SIMPLE<br><p> 	    credentialName: tls-cert<br><p> <br><p> ```
+     */
     @JsonProperty("port")
     public Port getPort() {
         return port;
     }
 
+    /**
+     * `Server` describes the properties of the proxy on a given load balancer port. For example,<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: Gateway metadata:<br><p> <br><p> 	name: my-ingress<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  app: my-ingressgateway<br><p> 	servers:<br><p> 	- port:<br><p> 	    number: 80<br><p> 	    name: http2<br><p> 	    protocol: HTTP2<br><p> 	  hosts:<br><p> 	  - "&#42;"<br><p> <br><p> ```<br><p> <br><p> # Another example<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: Gateway metadata:<br><p> <br><p> 	name: my-tcp-ingress<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  app: my-tcp-ingressgateway<br><p> 	servers:<br><p> 	- port:<br><p> 	    number: 27018<br><p> 	    name: mongo<br><p> 	    protocol: MONGO<br><p> 	  hosts:<br><p> 	  - "&#42;"<br><p> <br><p> ```<br><p> <br><p> # The following is an example of TLS configuration for port 443<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: Gateway metadata:<br><p> <br><p> 	name: my-tls-ingress<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  app: my-tls-ingressgateway<br><p> 	servers:<br><p> 	- port:<br><p> 	    number: 443<br><p> 	    name: https<br><p> 	    protocol: HTTPS<br><p> 	  hosts:<br><p> 	  - "&#42;"<br><p> 	  tls:<br><p> 	    mode: SIMPLE<br><p> 	    credentialName: tls-cert<br><p> <br><p> ```
+     */
     @JsonProperty("port")
     public void setPort(Port port) {
         this.port = port;
     }
 
+    /**
+     * `Server` describes the properties of the proxy on a given load balancer port. For example,<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: Gateway metadata:<br><p> <br><p> 	name: my-ingress<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  app: my-ingressgateway<br><p> 	servers:<br><p> 	- port:<br><p> 	    number: 80<br><p> 	    name: http2<br><p> 	    protocol: HTTP2<br><p> 	  hosts:<br><p> 	  - "&#42;"<br><p> <br><p> ```<br><p> <br><p> # Another example<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: Gateway metadata:<br><p> <br><p> 	name: my-tcp-ingress<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  app: my-tcp-ingressgateway<br><p> 	servers:<br><p> 	- port:<br><p> 	    number: 27018<br><p> 	    name: mongo<br><p> 	    protocol: MONGO<br><p> 	  hosts:<br><p> 	  - "&#42;"<br><p> <br><p> ```<br><p> <br><p> # The following is an example of TLS configuration for port 443<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: Gateway metadata:<br><p> <br><p> 	name: my-tls-ingress<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  app: my-tls-ingressgateway<br><p> 	servers:<br><p> 	- port:<br><p> 	    number: 443<br><p> 	    name: https<br><p> 	    protocol: HTTPS<br><p> 	  hosts:<br><p> 	  - "&#42;"<br><p> 	  tls:<br><p> 	    mode: SIMPLE<br><p> 	    credentialName: tls-cert<br><p> <br><p> ```
+     */
     @JsonProperty("tls")
     public ServerTLSSettings getTls() {
         return tls;
     }
 
+    /**
+     * `Server` describes the properties of the proxy on a given load balancer port. For example,<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: Gateway metadata:<br><p> <br><p> 	name: my-ingress<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  app: my-ingressgateway<br><p> 	servers:<br><p> 	- port:<br><p> 	    number: 80<br><p> 	    name: http2<br><p> 	    protocol: HTTP2<br><p> 	  hosts:<br><p> 	  - "&#42;"<br><p> <br><p> ```<br><p> <br><p> # Another example<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: Gateway metadata:<br><p> <br><p> 	name: my-tcp-ingress<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  app: my-tcp-ingressgateway<br><p> 	servers:<br><p> 	- port:<br><p> 	    number: 27018<br><p> 	    name: mongo<br><p> 	    protocol: MONGO<br><p> 	  hosts:<br><p> 	  - "&#42;"<br><p> <br><p> ```<br><p> <br><p> # The following is an example of TLS configuration for port 443<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: Gateway metadata:<br><p> <br><p> 	name: my-tls-ingress<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  app: my-tls-ingressgateway<br><p> 	servers:<br><p> 	- port:<br><p> 	    number: 443<br><p> 	    name: https<br><p> 	    protocol: HTTPS<br><p> 	  hosts:<br><p> 	  - "&#42;"<br><p> 	  tls:<br><p> 	    mode: SIMPLE<br><p> 	    credentialName: tls-cert<br><p> <br><p> ```
+     */
     @JsonProperty("tls")
     public void setTls(ServerTLSSettings tls) {
         this.tls = tls;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServerTLSSettings.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServerTLSSettings.java
index 6d15b78cbbe..47ccf95683d 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServerTLSSettings.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServerTLSSettings.java
@@ -132,52 +132,82 @@ public ServerTLSSettings(String caCertificates, String caCrl, List<String> ciphe
         this.verifyCertificateSpki = verifyCertificateSpki;
     }
 
+    /**
+     * REQUIRED if mode is `MUTUAL` or `OPTIONAL_MUTUAL`. The path to a file containing certificate authority certificates to use in verifying a presented client side certificate.
+     */
     @JsonProperty("caCertificates")
     public String getCaCertificates() {
         return caCertificates;
     }
 
+    /**
+     * REQUIRED if mode is `MUTUAL` or `OPTIONAL_MUTUAL`. The path to a file containing certificate authority certificates to use in verifying a presented client side certificate.
+     */
     @JsonProperty("caCertificates")
     public void setCaCertificates(String caCertificates) {
         this.caCertificates = caCertificates;
     }
 
+    /**
+     * OPTIONAL: The path to the file containing the certificate revocation list (CRL) to use in verifying a presented client side certificate. `CRL` is a list of certificates that have been revoked by the CA (Certificate Authority) before their scheduled expiration date. If specified, the proxy will verify if the presented certificate is part of the revoked list of certificates. If omitted, the proxy will not verify the certificate against the `crl`.
+     */
     @JsonProperty("caCrl")
     public String getCaCrl() {
         return caCrl;
     }
 
+    /**
+     * OPTIONAL: The path to the file containing the certificate revocation list (CRL) to use in verifying a presented client side certificate. `CRL` is a list of certificates that have been revoked by the CA (Certificate Authority) before their scheduled expiration date. If specified, the proxy will verify if the presented certificate is part of the revoked list of certificates. If omitted, the proxy will not verify the certificate against the `crl`.
+     */
     @JsonProperty("caCrl")
     public void setCaCrl(String caCrl) {
         this.caCrl = caCrl;
     }
 
+    /**
+     * Optional: If specified, only support the specified cipher list. Otherwise default to the default cipher list supported by Envoy as specified [here](https://www.envoyproxy.io/docs/envoy/latest/api-v3/extensions/transport_sockets/tls/v3/common.proto). The supported list of ciphers are: &#42; `ECDHE-ECDSA-AES128-GCM-SHA256` &#42; `ECDHE-RSA-AES128-GCM-SHA256` &#42; `ECDHE-ECDSA-AES256-GCM-SHA384` &#42; `ECDHE-RSA-AES256-GCM-SHA384` &#42; `ECDHE-ECDSA-CHACHA20-POLY1305` &#42; `ECDHE-RSA-CHACHA20-POLY1305` &#42; `ECDHE-ECDSA-AES128-SHA` &#42; `ECDHE-RSA-AES128-SHA` &#42; `ECDHE-ECDSA-AES256-SHA` &#42; `ECDHE-RSA-AES256-SHA` &#42; `AES128-GCM-SHA256` &#42; `AES256-GCM-SHA384` &#42; `AES128-SHA` &#42; `AES256-SHA` &#42; `DES-CBC3-SHA`
+     */
     @JsonProperty("cipherSuites")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCipherSuites() {
         return cipherSuites;
     }
 
+    /**
+     * Optional: If specified, only support the specified cipher list. Otherwise default to the default cipher list supported by Envoy as specified [here](https://www.envoyproxy.io/docs/envoy/latest/api-v3/extensions/transport_sockets/tls/v3/common.proto). The supported list of ciphers are: &#42; `ECDHE-ECDSA-AES128-GCM-SHA256` &#42; `ECDHE-RSA-AES128-GCM-SHA256` &#42; `ECDHE-ECDSA-AES256-GCM-SHA384` &#42; `ECDHE-RSA-AES256-GCM-SHA384` &#42; `ECDHE-ECDSA-CHACHA20-POLY1305` &#42; `ECDHE-RSA-CHACHA20-POLY1305` &#42; `ECDHE-ECDSA-AES128-SHA` &#42; `ECDHE-RSA-AES128-SHA` &#42; `ECDHE-ECDSA-AES256-SHA` &#42; `ECDHE-RSA-AES256-SHA` &#42; `AES128-GCM-SHA256` &#42; `AES256-GCM-SHA384` &#42; `AES128-SHA` &#42; `AES256-SHA` &#42; `DES-CBC3-SHA`
+     */
     @JsonProperty("cipherSuites")
     public void setCipherSuites(List<String> cipherSuites) {
         this.cipherSuites = cipherSuites;
     }
 
+    /**
+     * For gateways running on Kubernetes, the name of the secret that holds the TLS certs including the CA certificates. Applicable only on Kubernetes. An Opaque secret should contain the following keys and values: `tls.key: &lt;privateKey&gt;` and `tls.crt: &lt;serverCert&gt;` or `key: &lt;privateKey&gt;` and `cert: &lt;serverCert&gt;`. For mutual TLS, `cacert: &lt;CACertificate&gt;` and `crl: &lt;CertificateRevocationList&gt;` can be provided in the same secret or a separate secret named `&lt;secret&gt;-cacert`. A TLS secret for server certificates with an additional `tls.ocsp-staple` key for specifying OCSP staple information, `ca.crt` key for CA certificates and `ca.crl` for certificate revocation list is also supported. Only one of server certificates and CA certificate or credentialName can be specified.
+     */
     @JsonProperty("credentialName")
     public String getCredentialName() {
         return credentialName;
     }
 
+    /**
+     * For gateways running on Kubernetes, the name of the secret that holds the TLS certs including the CA certificates. Applicable only on Kubernetes. An Opaque secret should contain the following keys and values: `tls.key: &lt;privateKey&gt;` and `tls.crt: &lt;serverCert&gt;` or `key: &lt;privateKey&gt;` and `cert: &lt;serverCert&gt;`. For mutual TLS, `cacert: &lt;CACertificate&gt;` and `crl: &lt;CertificateRevocationList&gt;` can be provided in the same secret or a separate secret named `&lt;secret&gt;-cacert`. A TLS secret for server certificates with an additional `tls.ocsp-staple` key for specifying OCSP staple information, `ca.crt` key for CA certificates and `ca.crl` for certificate revocation list is also supported. Only one of server certificates and CA certificate or credentialName can be specified.
+     */
     @JsonProperty("credentialName")
     public void setCredentialName(String credentialName) {
         this.credentialName = credentialName;
     }
 
+    /**
+     * If set to true, the load balancer will send a 301 redirect for all http connections, asking the clients to use HTTPS.
+     */
     @JsonProperty("httpsRedirect")
     public Boolean getHttpsRedirect() {
         return httpsRedirect;
     }
 
+    /**
+     * If set to true, the load balancer will send a 301 redirect for all http connections, asking the clients to use HTTPS.
+     */
     @JsonProperty("httpsRedirect")
     public void setHttpsRedirect(Boolean httpsRedirect) {
         this.httpsRedirect = httpsRedirect;
@@ -213,54 +243,84 @@ public void setMode(ServerTLSSettingsTLSmode mode) {
         this.mode = mode;
     }
 
+    /**
+     * REQUIRED if mode is `SIMPLE` or `MUTUAL`. The path to the file holding the server's private key.
+     */
     @JsonProperty("privateKey")
     public String getPrivateKey() {
         return privateKey;
     }
 
+    /**
+     * REQUIRED if mode is `SIMPLE` or `MUTUAL`. The path to the file holding the server's private key.
+     */
     @JsonProperty("privateKey")
     public void setPrivateKey(String privateKey) {
         this.privateKey = privateKey;
     }
 
+    /**
+     * REQUIRED if mode is `SIMPLE` or `MUTUAL`. The path to the file holding the server-side TLS certificate to use.
+     */
     @JsonProperty("serverCertificate")
     public String getServerCertificate() {
         return serverCertificate;
     }
 
+    /**
+     * REQUIRED if mode is `SIMPLE` or `MUTUAL`. The path to the file holding the server-side TLS certificate to use.
+     */
     @JsonProperty("serverCertificate")
     public void setServerCertificate(String serverCertificate) {
         this.serverCertificate = serverCertificate;
     }
 
+    /**
+     * A list of alternate names to verify the subject identity in the certificate presented by the client.
+     */
     @JsonProperty("subjectAltNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSubjectAltNames() {
         return subjectAltNames;
     }
 
+    /**
+     * A list of alternate names to verify the subject identity in the certificate presented by the client.
+     */
     @JsonProperty("subjectAltNames")
     public void setSubjectAltNames(List<String> subjectAltNames) {
         this.subjectAltNames = subjectAltNames;
     }
 
+    /**
+     * An optional list of hex-encoded SHA-256 hashes of the authorized client certificates. Both simple and colon separated formats are acceptable. Note: When both verify_certificate_hash and verify_certificate_spki are specified, a hash matching either value will result in the certificate being accepted.
+     */
     @JsonProperty("verifyCertificateHash")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getVerifyCertificateHash() {
         return verifyCertificateHash;
     }
 
+    /**
+     * An optional list of hex-encoded SHA-256 hashes of the authorized client certificates. Both simple and colon separated formats are acceptable. Note: When both verify_certificate_hash and verify_certificate_spki are specified, a hash matching either value will result in the certificate being accepted.
+     */
     @JsonProperty("verifyCertificateHash")
     public void setVerifyCertificateHash(List<String> verifyCertificateHash) {
         this.verifyCertificateHash = verifyCertificateHash;
     }
 
+    /**
+     * An optional list of base64-encoded SHA-256 hashes of the SPKIs of authorized client certificates. Note: When both verify_certificate_hash and verify_certificate_spki are specified, a hash matching either value will result in the certificate being accepted.
+     */
     @JsonProperty("verifyCertificateSpki")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getVerifyCertificateSpki() {
         return verifyCertificateSpki;
     }
 
+    /**
+     * An optional list of base64-encoded SHA-256 hashes of the SPKIs of authorized client certificates. Note: When both verify_certificate_hash and verify_certificate_spki are specified, a hash matching either value will result in the certificate being accepted.
+     */
     @JsonProperty("verifyCertificateSpki")
     public void setVerifyCertificateSpki(List<String> verifyCertificateSpki) {
         this.verifyCertificateSpki = verifyCertificateSpki;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServerTLSSettingsTLSProtocol.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServerTLSSettingsTLSProtocol.java
index dfe325606b4..f0b475ccedb 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServerTLSSettingsTLSProtocol.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServerTLSSettingsTLSProtocol.java
@@ -4,6 +4,9 @@
 import javax.annotation.Generated;
 import com.fasterxml.jackson.annotation.JsonCreator;
 
+/**
+ * TLS protocol versions.
+ */
 @Generated("io.fabric8.kubernetes.schema.generator.model.ModelGenerator")
 public enum ServerTLSSettingsTLSProtocol 
 {
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServerTLSSettingsTLSmode.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServerTLSSettingsTLSmode.java
index de28d45363c..eb8857951b0 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServerTLSSettingsTLSmode.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServerTLSSettingsTLSmode.java
@@ -4,6 +4,9 @@
 import javax.annotation.Generated;
 import com.fasterxml.jackson.annotation.JsonCreator;
 
+/**
+ * TLS modes enforced by the proxy
+ */
 @Generated("io.fabric8.kubernetes.schema.generator.model.ModelGenerator")
 public enum ServerTLSSettingsTLSmode 
 {
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServiceEntry.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServiceEntry.java
index 80459b2f2a9..926c9327d11 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServiceEntry.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServiceEntry.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceEntry enables adding additional entries into Istio's internal service registry.<br><p> <br><p> &lt;!-- crd generation tags mesh or part of the mesh (MESH_EXTERNAL or MESH_INTERNAL)" (NONE, STATIC, or DNS)" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags istiostatus-override: ServiceEntryStatus: istio.io/api/networking/v1alpha3 --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -128,97 +131,151 @@ public ServiceEntry(List<String> addresses, List<WorkloadEntry> endpoints, List<
         this.workloadSelector = workloadSelector;
     }
 
+    /**
+     * The virtual IP addresses associated with the service. Could be CIDR prefix. For HTTP traffic, generated route configurations will include http route domains for both the `addresses` and `hosts` field values and the destination will be identified based on the HTTP Host/Authority header. If one or more IP addresses are specified, the incoming traffic will be identified as belonging to this service if the destination IP matches the IP/CIDRs specified in the addresses field. If the Addresses field is empty, traffic will be identified solely based on the destination port. In such scenarios, the port on which the service is being accessed must not be shared by any other service in the mesh. In other words, the sidecar will behave as a simple TCP proxy, forwarding incoming traffic on a specified port to the specified destination endpoint IP/host. Unix domain socket addresses are not supported in this field.
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAddresses() {
         return addresses;
     }
 
+    /**
+     * The virtual IP addresses associated with the service. Could be CIDR prefix. For HTTP traffic, generated route configurations will include http route domains for both the `addresses` and `hosts` field values and the destination will be identified based on the HTTP Host/Authority header. If one or more IP addresses are specified, the incoming traffic will be identified as belonging to this service if the destination IP matches the IP/CIDRs specified in the addresses field. If the Addresses field is empty, traffic will be identified solely based on the destination port. In such scenarios, the port on which the service is being accessed must not be shared by any other service in the mesh. In other words, the sidecar will behave as a simple TCP proxy, forwarding incoming traffic on a specified port to the specified destination endpoint IP/host. Unix domain socket addresses are not supported in this field.
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<String> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * One or more endpoints associated with the service. Only one of `endpoints` or `workloadSelector` can be specified.
+     */
     @JsonProperty("endpoints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WorkloadEntry> getEndpoints() {
         return endpoints;
     }
 
+    /**
+     * One or more endpoints associated with the service. Only one of `endpoints` or `workloadSelector` can be specified.
+     */
     @JsonProperty("endpoints")
     public void setEndpoints(List<WorkloadEntry> endpoints) {
         this.endpoints = endpoints;
     }
 
+    /**
+     * A list of namespaces to which this service is exported. Exporting a service allows it to be used by sidecars, gateways and virtual services defined in other namespaces. This feature provides a mechanism for service owners and mesh administrators to control the visibility of services across namespace boundaries.<br><p> <br><p> If no namespaces are specified then the service is exported to all namespaces by default.<br><p> <br><p> The value "." is reserved and defines an export to the same namespace that the service is declared in. Similarly the value "&#42;" is reserved and defines an export to all namespaces.<br><p> <br><p> For a Kubernetes Service, the equivalent effect can be achieved by setting the annotation "networking.istio.io/exportTo" to a comma-separated list of namespace names.
+     */
     @JsonProperty("exportTo")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getExportTo() {
         return exportTo;
     }
 
+    /**
+     * A list of namespaces to which this service is exported. Exporting a service allows it to be used by sidecars, gateways and virtual services defined in other namespaces. This feature provides a mechanism for service owners and mesh administrators to control the visibility of services across namespace boundaries.<br><p> <br><p> If no namespaces are specified then the service is exported to all namespaces by default.<br><p> <br><p> The value "." is reserved and defines an export to the same namespace that the service is declared in. Similarly the value "&#42;" is reserved and defines an export to all namespaces.<br><p> <br><p> For a Kubernetes Service, the equivalent effect can be achieved by setting the annotation "networking.istio.io/exportTo" to a comma-separated list of namespace names.
+     */
     @JsonProperty("exportTo")
     public void setExportTo(List<String> exportTo) {
         this.exportTo = exportTo;
     }
 
+    /**
+     * The hosts associated with the ServiceEntry. Could be a DNS name with wildcard prefix.<br><p> <br><p> 1. The hosts field is used to select matching hosts in VirtualServices and DestinationRules. 2. For HTTP traffic the HTTP Host/Authority header will be matched against the hosts field. 3. For HTTPs or TLS traffic containing Server Name Indication (SNI), the SNI value will be matched against the hosts field.<br><p> <br><p> &#42;&#42;NOTE 1:&#42;&#42; When resolution is set to type DNS and no endpoints are specified, the host field will be used as the DNS name of the endpoint to route traffic to.<br><p> <br><p> &#42;&#42;NOTE 2:&#42;&#42; If the hostname matches with the name of a service from another service registry such as Kubernetes that also supplies its own set of endpoints, the ServiceEntry will be treated as a decorator of the existing Kubernetes service. Properties in the service entry will be added to the Kubernetes service if applicable. Currently, only the following additional properties will be considered by `istiod`:<br><p> <br><p>  1. subjectAltNames: In addition to verifying the SANs of the<br><p>     service accounts associated with the pods of the service, the<br><p>     SANs specified here will also be verified.
+     */
     @JsonProperty("hosts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getHosts() {
         return hosts;
     }
 
+    /**
+     * The hosts associated with the ServiceEntry. Could be a DNS name with wildcard prefix.<br><p> <br><p> 1. The hosts field is used to select matching hosts in VirtualServices and DestinationRules. 2. For HTTP traffic the HTTP Host/Authority header will be matched against the hosts field. 3. For HTTPs or TLS traffic containing Server Name Indication (SNI), the SNI value will be matched against the hosts field.<br><p> <br><p> &#42;&#42;NOTE 1:&#42;&#42; When resolution is set to type DNS and no endpoints are specified, the host field will be used as the DNS name of the endpoint to route traffic to.<br><p> <br><p> &#42;&#42;NOTE 2:&#42;&#42; If the hostname matches with the name of a service from another service registry such as Kubernetes that also supplies its own set of endpoints, the ServiceEntry will be treated as a decorator of the existing Kubernetes service. Properties in the service entry will be added to the Kubernetes service if applicable. Currently, only the following additional properties will be considered by `istiod`:<br><p> <br><p>  1. subjectAltNames: In addition to verifying the SANs of the<br><p>     service accounts associated with the pods of the service, the<br><p>     SANs specified here will also be verified.
+     */
     @JsonProperty("hosts")
     public void setHosts(List<String> hosts) {
         this.hosts = hosts;
     }
 
+    /**
+     * ServiceEntry enables adding additional entries into Istio's internal service registry.<br><p> <br><p> &lt;!-- crd generation tags mesh or part of the mesh (MESH_EXTERNAL or MESH_INTERNAL)" (NONE, STATIC, or DNS)" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags istiostatus-override: ServiceEntryStatus: istio.io/api/networking/v1alpha3 --&gt;
+     */
     @JsonProperty("location")
     public ServiceEntryLocation getLocation() {
         return location;
     }
 
+    /**
+     * ServiceEntry enables adding additional entries into Istio's internal service registry.<br><p> <br><p> &lt;!-- crd generation tags mesh or part of the mesh (MESH_EXTERNAL or MESH_INTERNAL)" (NONE, STATIC, or DNS)" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags istiostatus-override: ServiceEntryStatus: istio.io/api/networking/v1alpha3 --&gt;
+     */
     @JsonProperty("location")
     public void setLocation(ServiceEntryLocation location) {
         this.location = location;
     }
 
+    /**
+     * The ports associated with the external service. If the Endpoints are Unix domain socket addresses, there must be exactly one port.
+     */
     @JsonProperty("ports")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ServicePort> getPorts() {
         return ports;
     }
 
+    /**
+     * The ports associated with the external service. If the Endpoints are Unix domain socket addresses, there must be exactly one port.
+     */
     @JsonProperty("ports")
     public void setPorts(List<ServicePort> ports) {
         this.ports = ports;
     }
 
+    /**
+     * ServiceEntry enables adding additional entries into Istio's internal service registry.<br><p> <br><p> &lt;!-- crd generation tags mesh or part of the mesh (MESH_EXTERNAL or MESH_INTERNAL)" (NONE, STATIC, or DNS)" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags istiostatus-override: ServiceEntryStatus: istio.io/api/networking/v1alpha3 --&gt;
+     */
     @JsonProperty("resolution")
     public ServiceEntryResolution getResolution() {
         return resolution;
     }
 
+    /**
+     * ServiceEntry enables adding additional entries into Istio's internal service registry.<br><p> <br><p> &lt;!-- crd generation tags mesh or part of the mesh (MESH_EXTERNAL or MESH_INTERNAL)" (NONE, STATIC, or DNS)" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags istiostatus-override: ServiceEntryStatus: istio.io/api/networking/v1alpha3 --&gt;
+     */
     @JsonProperty("resolution")
     public void setResolution(ServiceEntryResolution resolution) {
         this.resolution = resolution;
     }
 
+    /**
+     * If specified, the proxy will verify that the server certificate's subject alternate name matches one of the specified values.<br><p> <br><p> NOTE: When using the workloadEntry with workloadSelectors, the service account specified in the workloadEntry will also be used to derive the additional subject alternate names that should be verified.
+     */
     @JsonProperty("subjectAltNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSubjectAltNames() {
         return subjectAltNames;
     }
 
+    /**
+     * If specified, the proxy will verify that the server certificate's subject alternate name matches one of the specified values.<br><p> <br><p> NOTE: When using the workloadEntry with workloadSelectors, the service account specified in the workloadEntry will also be used to derive the additional subject alternate names that should be verified.
+     */
     @JsonProperty("subjectAltNames")
     public void setSubjectAltNames(List<String> subjectAltNames) {
         this.subjectAltNames = subjectAltNames;
     }
 
+    /**
+     * ServiceEntry enables adding additional entries into Istio's internal service registry.<br><p> <br><p> &lt;!-- crd generation tags mesh or part of the mesh (MESH_EXTERNAL or MESH_INTERNAL)" (NONE, STATIC, or DNS)" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags istiostatus-override: ServiceEntryStatus: istio.io/api/networking/v1alpha3 --&gt;
+     */
     @JsonProperty("workloadSelector")
     public WorkloadSelector getWorkloadSelector() {
         return workloadSelector;
     }
 
+    /**
+     * ServiceEntry enables adding additional entries into Istio's internal service registry.<br><p> <br><p> &lt;!-- crd generation tags mesh or part of the mesh (MESH_EXTERNAL or MESH_INTERNAL)" (NONE, STATIC, or DNS)" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags istiostatus-override: ServiceEntryStatus: istio.io/api/networking/v1alpha3 --&gt;
+     */
     @JsonProperty("workloadSelector")
     public void setWorkloadSelector(WorkloadSelector workloadSelector) {
         this.workloadSelector = workloadSelector;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServiceEntryAddress.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServiceEntryAddress.java
index 03e3ea2ce21..18c440f7486 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServiceEntryAddress.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServiceEntryAddress.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * minor abstraction to allow for adding hostnames if relevant
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ServiceEntryAddress(String host, String value) {
         this.value = value;
     }
 
+    /**
+     * Host is the name associated with this address
+     */
     @JsonProperty("host")
     public String getHost() {
         return host;
     }
 
+    /**
+     * Host is the name associated with this address
+     */
     @JsonProperty("host")
     public void setHost(String host) {
         this.host = host;
     }
 
+    /**
+     * Value is the address (192.168.0.2)
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is the address (192.168.0.2)
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServiceEntryLocation.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServiceEntryLocation.java
index 4548c84f200..12758bdecce 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServiceEntryLocation.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServiceEntryLocation.java
@@ -4,6 +4,9 @@
 import javax.annotation.Generated;
 import com.fasterxml.jackson.annotation.JsonCreator;
 
+/**
+ * Location specifies whether the service is part of Istio mesh or outside the mesh.  Location determines the behavior of several features, such as service-to-service mTLS authentication, policy enforcement, etc. When communicating with services outside the mesh, Istio's mTLS authentication is disabled, and policy enforcement is performed on the client-side as opposed to server-side.
+ */
 @Generated("io.fabric8.kubernetes.schema.generator.model.ModelGenerator")
 public enum ServiceEntryLocation 
 {
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServiceEntryResolution.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServiceEntryResolution.java
index 3d18c272020..e73bb3752af 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServiceEntryResolution.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServiceEntryResolution.java
@@ -4,6 +4,9 @@
 import javax.annotation.Generated;
 import com.fasterxml.jackson.annotation.JsonCreator;
 
+/**
+ * Resolution determines how the proxy will resolve the IP addresses of the network endpoints associated with the service, so that it can route to one of them. The resolution mode specified here has no impact on how the application resolves the IP address associated with the service. The application may still have to use DNS to resolve the service to an IP so that the outbound traffic can be captured by the Proxy. Alternatively, for HTTP services, the application could directly communicate with the proxy (e.g., by setting HTTP_PROXY) to talk to these services.
+ */
 @Generated("io.fabric8.kubernetes.schema.generator.model.ModelGenerator")
 public enum ServiceEntryResolution 
 {
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServiceEntryStatus.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServiceEntryStatus.java
index fffea5f8f9d..786edb74ad7 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServiceEntryStatus.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServiceEntryStatus.java
@@ -97,44 +97,68 @@ public ServiceEntryStatus(List<ServiceEntryAddress> addresses, List<IstioConditi
         this.validationMessages = validationMessages;
     }
 
+    /**
+     * List of addresses which were assigned to this ServiceEntry.
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ServiceEntryAddress> getAddresses() {
         return addresses;
     }
 
+    /**
+     * List of addresses which were assigned to this ServiceEntry.
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<ServiceEntryAddress> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * Current service state of ServiceEntry. More info: https://istio.io/docs/reference/config/config-status/
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IstioCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Current service state of ServiceEntry. More info: https://istio.io/docs/reference/config/config-status/
+     */
     @JsonProperty("conditions")
     public void setConditions(List<IstioCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Resource Generation to which the Reconciled Condition refers. When this value is not equal to the object's metadata generation, reconciled condition  calculation for the current generation is still in progress.  See https://istio.io/latest/docs/reference/config/config-status/ for more info.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * Resource Generation to which the Reconciled Condition refers. When this value is not equal to the object's metadata generation, reconciled condition  calculation for the current generation is still in progress.  See https://istio.io/latest/docs/reference/config/config-status/ for more info.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Includes any errors or warnings detected by Istio's analyzers.
+     */
     @JsonProperty("validationMessages")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AnalysisMessageBase> getValidationMessages() {
         return validationMessages;
     }
 
+    /**
+     * Includes any errors or warnings detected by Istio's analyzers.
+     */
     @JsonProperty("validationMessages")
     public void setValidationMessages(List<AnalysisMessageBase> validationMessages) {
         this.validationMessages = validationMessages;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServicePort.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServicePort.java
index 16f92087e43..2a974fea0b5 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServicePort.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/ServicePort.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServicePort describes the properties of a specific port of a service.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ServicePort(String name, Long number, String protocol, Long targetPort) {
         this.targetPort = targetPort;
     }
 
+    /**
+     * Label assigned to the port.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Label assigned to the port.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * A valid non-negative integer port number.
+     */
     @JsonProperty("number")
     public Long getNumber() {
         return number;
     }
 
+    /**
+     * A valid non-negative integer port number.
+     */
     @JsonProperty("number")
     public void setNumber(Long number) {
         this.number = number;
     }
 
+    /**
+     * The protocol exposed on the port. MUST BE one of HTTP|HTTPS|GRPC|HTTP2|MONGO|TCP|TLS. TLS implies the connection will be routed based on the SNI header to the destination without terminating the TLS connection.
+     */
     @JsonProperty("protocol")
     public String getProtocol() {
         return protocol;
     }
 
+    /**
+     * The protocol exposed on the port. MUST BE one of HTTP|HTTPS|GRPC|HTTP2|MONGO|TCP|TLS. TLS implies the connection will be routed based on the SNI header to the destination without terminating the TLS connection.
+     */
     @JsonProperty("protocol")
     public void setProtocol(String protocol) {
         this.protocol = protocol;
     }
 
+    /**
+     * The port number on the endpoint where the traffic will be received. If unset, default to `number`.
+     */
     @JsonProperty("targetPort")
     public Long getTargetPort() {
         return targetPort;
     }
 
+    /**
+     * The port number on the endpoint where the traffic will be received. If unset, default to `number`.
+     */
     @JsonProperty("targetPort")
     public void setTargetPort(Long targetPort) {
         this.targetPort = targetPort;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Sidecar.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Sidecar.java
index 71615c85d15..2cfb7c17d7a 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Sidecar.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Sidecar.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * `Sidecar` describes the configuration of the sidecar proxy that mediates inbound and outbound communication of the workload instance to which it is attached.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -108,53 +111,83 @@ public Sidecar(List<IstioEgressListener> egress, ConnectionPoolSettings inboundC
         this.workloadSelector = workloadSelector;
     }
 
+    /**
+     * Egress specifies the configuration of the sidecar for processing outbound traffic from the attached workload instance to other services in the mesh. If not specified, inherits the system detected defaults from the namespace-wide or the global default Sidecar.
+     */
     @JsonProperty("egress")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IstioEgressListener> getEgress() {
         return egress;
     }
 
+    /**
+     * Egress specifies the configuration of the sidecar for processing outbound traffic from the attached workload instance to other services in the mesh. If not specified, inherits the system detected defaults from the namespace-wide or the global default Sidecar.
+     */
     @JsonProperty("egress")
     public void setEgress(List<IstioEgressListener> egress) {
         this.egress = egress;
     }
 
+    /**
+     * `Sidecar` describes the configuration of the sidecar proxy that mediates inbound and outbound communication of the workload instance to which it is attached.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("inboundConnectionPool")
     public ConnectionPoolSettings getInboundConnectionPool() {
         return inboundConnectionPool;
     }
 
+    /**
+     * `Sidecar` describes the configuration of the sidecar proxy that mediates inbound and outbound communication of the workload instance to which it is attached.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("inboundConnectionPool")
     public void setInboundConnectionPool(ConnectionPoolSettings inboundConnectionPool) {
         this.inboundConnectionPool = inboundConnectionPool;
     }
 
+    /**
+     * Ingress specifies the configuration of the sidecar for processing inbound traffic to the attached workload instance. If omitted, Istio will automatically configure the sidecar based on the information about the workload obtained from the orchestration platform (e.g., exposed ports, services, etc.). If specified, inbound ports are configured if and only if the workload instance is associated with a service.
+     */
     @JsonProperty("ingress")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IstioIngressListener> getIngress() {
         return ingress;
     }
 
+    /**
+     * Ingress specifies the configuration of the sidecar for processing inbound traffic to the attached workload instance. If omitted, Istio will automatically configure the sidecar based on the information about the workload obtained from the orchestration platform (e.g., exposed ports, services, etc.). If specified, inbound ports are configured if and only if the workload instance is associated with a service.
+     */
     @JsonProperty("ingress")
     public void setIngress(List<IstioIngressListener> ingress) {
         this.ingress = ingress;
     }
 
+    /**
+     * `Sidecar` describes the configuration of the sidecar proxy that mediates inbound and outbound communication of the workload instance to which it is attached.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("outboundTrafficPolicy")
     public OutboundTrafficPolicy getOutboundTrafficPolicy() {
         return outboundTrafficPolicy;
     }
 
+    /**
+     * `Sidecar` describes the configuration of the sidecar proxy that mediates inbound and outbound communication of the workload instance to which it is attached.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("outboundTrafficPolicy")
     public void setOutboundTrafficPolicy(OutboundTrafficPolicy outboundTrafficPolicy) {
         this.outboundTrafficPolicy = outboundTrafficPolicy;
     }
 
+    /**
+     * `Sidecar` describes the configuration of the sidecar proxy that mediates inbound and outbound communication of the workload instance to which it is attached.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("workloadSelector")
     public WorkloadSelector getWorkloadSelector() {
         return workloadSelector;
     }
 
+    /**
+     * `Sidecar` describes the configuration of the sidecar proxy that mediates inbound and outbound communication of the workload instance to which it is attached.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("workloadSelector")
     public void setWorkloadSelector(WorkloadSelector workloadSelector) {
         this.workloadSelector = workloadSelector;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/SidecarPort.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/SidecarPort.java
index 8172d4c99ba..92a3516e16b 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/SidecarPort.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/SidecarPort.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Port describes the properties of a specific port of a service.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public SidecarPort(String name, Long number, String protocol, Long targetPort) {
         this.targetPort = targetPort;
     }
 
+    /**
+     * Label assigned to the port.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Label assigned to the port.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * A valid non-negative integer port number.
+     */
     @JsonProperty("number")
     public Long getNumber() {
         return number;
     }
 
+    /**
+     * A valid non-negative integer port number.
+     */
     @JsonProperty("number")
     public void setNumber(Long number) {
         this.number = number;
     }
 
+    /**
+     * The protocol exposed on the port. MUST BE one of HTTP|HTTPS|GRPC|HTTP2|MONGO|TCP|TLS. TLS can be either used to terminate non-HTTP based connections on a specific port or to route traffic based on SNI header to the destination without terminating the TLS connection.
+     */
     @JsonProperty("protocol")
     public String getProtocol() {
         return protocol;
     }
 
+    /**
+     * The protocol exposed on the port. MUST BE one of HTTP|HTTPS|GRPC|HTTP2|MONGO|TCP|TLS. TLS can be either used to terminate non-HTTP based connections on a specific port or to route traffic based on SNI header to the destination without terminating the TLS connection.
+     */
     @JsonProperty("protocol")
     public void setProtocol(String protocol) {
         this.protocol = protocol;
     }
 
+    /**
+     * Has no effect, only for backwards compatibility received. Applicable only when used with ServiceEntries. $hide_from_docs<br><p> <br><p> Deprecated: Marked as deprecated in networking/v1alpha3/sidecar.proto.
+     */
     @JsonProperty("targetPort")
     public Long getTargetPort() {
         return targetPort;
     }
 
+    /**
+     * Has no effect, only for backwards compatibility received. Applicable only when used with ServiceEntries. $hide_from_docs<br><p> <br><p> Deprecated: Marked as deprecated in networking/v1alpha3/sidecar.proto.
+     */
     @JsonProperty("targetPort")
     public void setTargetPort(Long targetPort) {
         this.targetPort = targetPort;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/StringMatch.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/StringMatch.java
index 9565b7a06fd..37173c9c880 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/StringMatch.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/StringMatch.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Describes how to match a given string in HTTP headers. `exact` and `prefix` matching is case-sensitive. `regex` matching supports case-insensitive matches.
+ */
 @JsonDeserialize(using = io.fabric8.kubernetes.model.jackson.JsonUnwrappedDeserializer.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -80,12 +83,18 @@ public StringMatch(IsStringMatchMatchType matchType) {
         this.matchType = matchType;
     }
 
+    /**
+     * Describes how to match a given string in HTTP headers. `exact` and `prefix` matching is case-sensitive. `regex` matching supports case-insensitive matches.
+     */
     @JsonProperty("MatchType")
     @JsonUnwrapped
     public IsStringMatchMatchType getMatchType() {
         return matchType;
     }
 
+    /**
+     * Describes how to match a given string in HTTP headers. `exact` and `prefix` matching is case-sensitive. `regex` matching supports case-insensitive matches.
+     */
     @JsonProperty("MatchType")
     public void setMatchType(IsStringMatchMatchType matchType) {
         this.matchType = matchType;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/StringMatchExact.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/StringMatchExact.java
index 953268db353..1684b11c4c2 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/StringMatchExact.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/StringMatchExact.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * exact string match
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public StringMatchExact(String exact) {
         this.exact = exact;
     }
 
+    /**
+     * exact string match
+     */
     @JsonProperty("exact")
     public String getExact() {
         return exact;
     }
 
+    /**
+     * exact string match
+     */
     @JsonProperty("exact")
     public void setExact(String exact) {
         this.exact = exact;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/StringMatchPrefix.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/StringMatchPrefix.java
index 91b0e17d2db..9808f2aafb7 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/StringMatchPrefix.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/StringMatchPrefix.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * prefix-based match
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public StringMatchPrefix(String prefix) {
         this.prefix = prefix;
     }
 
+    /**
+     * prefix-based match
+     */
     @JsonProperty("prefix")
     public String getPrefix() {
         return prefix;
     }
 
+    /**
+     * prefix-based match
+     */
     @JsonProperty("prefix")
     public void setPrefix(String prefix) {
         this.prefix = prefix;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/StringMatchRegex.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/StringMatchRegex.java
index d97e2001b29..673db441b09 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/StringMatchRegex.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/StringMatchRegex.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * [RE2 style regex-based match](https://github.com/google/re2/wiki/Syntax).<br><p> <br><p> Example: `(?i)^aaa$` can be used to case-insensitive match a string consisting of three a's.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public StringMatchRegex(String regex) {
         this.regex = regex;
     }
 
+    /**
+     * [RE2 style regex-based match](https://github.com/google/re2/wiki/Syntax).<br><p> <br><p> Example: `(?i)^aaa$` can be used to case-insensitive match a string consisting of three a's.
+     */
     @JsonProperty("regex")
     public String getRegex() {
         return regex;
     }
 
+    /**
+     * [RE2 style regex-based match](https://github.com/google/re2/wiki/Syntax).<br><p> <br><p> Example: `(?i)^aaa$` can be used to case-insensitive match a string consisting of three a's.
+     */
     @JsonProperty("regex")
     public void setRegex(String regex) {
         this.regex = regex;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Subset.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Subset.java
index 21f69872382..60962fd0ea2 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Subset.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/Subset.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * A subset of endpoints of a service. Subsets can be used for scenarios like A/B testing, or routing to a specific version of a service. Refer to [VirtualService](https://istio.io/docs/reference/config/networking/virtual-service/#VirtualService) documentation for examples of using subsets in these scenarios. In addition, traffic policies defined at the service-level can be overridden at a subset-level. The following rule uses a round robin load balancing policy for all traffic going to a subset named testversion that is composed of endpoints (e.g., pods) with labels (version:v3).<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: bookinfo-ratings<br><p> <br><p> spec:<br><p> <br><p> 	host: ratings.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  loadBalancer:<br><p> 	    simple: LEAST_REQUEST<br><p> 	subsets:<br><p> 	- name: testversion<br><p> 	  labels:<br><p> 	    version: v3<br><p> 	  trafficPolicy:<br><p> 	    loadBalancer:<br><p> 	      simple: ROUND_ROBIN<br><p> <br><p> ```<br><p> <br><p> &#42;&#42;Note:&#42;&#42; Policies specified for subsets will not take effect until a route rule explicitly sends traffic to this subset.<br><p> <br><p> One or more labels are typically required to identify the subset destination, however, when the corresponding DestinationRule represents a host that supports multiple SNI hosts (e.g., an egress gateway), a subset without labels may be meaningful. In this case a traffic policy with [ClientTLSSettings](#ClientTLSSettings) can be used to identify a specific SNI host corresponding to the named subset.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,32 +90,50 @@ public Subset(Map<String, String> labels, String name, TrafficPolicy trafficPoli
         this.trafficPolicy = trafficPolicy;
     }
 
+    /**
+     * Labels apply a filter over the endpoints of a service in the service registry. See route rules for examples of usage.
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabels() {
         return labels;
     }
 
+    /**
+     * Labels apply a filter over the endpoints of a service in the service registry. See route rules for examples of usage.
+     */
     @JsonProperty("labels")
     public void setLabels(Map<String, String> labels) {
         this.labels = labels;
     }
 
+    /**
+     * Name of the subset. The service name and the subset name can be used for traffic splitting in a route rule.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the subset. The service name and the subset name can be used for traffic splitting in a route rule.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * A subset of endpoints of a service. Subsets can be used for scenarios like A/B testing, or routing to a specific version of a service. Refer to [VirtualService](https://istio.io/docs/reference/config/networking/virtual-service/#VirtualService) documentation for examples of using subsets in these scenarios. In addition, traffic policies defined at the service-level can be overridden at a subset-level. The following rule uses a round robin load balancing policy for all traffic going to a subset named testversion that is composed of endpoints (e.g., pods) with labels (version:v3).<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: bookinfo-ratings<br><p> <br><p> spec:<br><p> <br><p> 	host: ratings.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  loadBalancer:<br><p> 	    simple: LEAST_REQUEST<br><p> 	subsets:<br><p> 	- name: testversion<br><p> 	  labels:<br><p> 	    version: v3<br><p> 	  trafficPolicy:<br><p> 	    loadBalancer:<br><p> 	      simple: ROUND_ROBIN<br><p> <br><p> ```<br><p> <br><p> &#42;&#42;Note:&#42;&#42; Policies specified for subsets will not take effect until a route rule explicitly sends traffic to this subset.<br><p> <br><p> One or more labels are typically required to identify the subset destination, however, when the corresponding DestinationRule represents a host that supports multiple SNI hosts (e.g., an egress gateway), a subset without labels may be meaningful. In this case a traffic policy with [ClientTLSSettings](#ClientTLSSettings) can be used to identify a specific SNI host corresponding to the named subset.
+     */
     @JsonProperty("trafficPolicy")
     public TrafficPolicy getTrafficPolicy() {
         return trafficPolicy;
     }
 
+    /**
+     * A subset of endpoints of a service. Subsets can be used for scenarios like A/B testing, or routing to a specific version of a service. Refer to [VirtualService](https://istio.io/docs/reference/config/networking/virtual-service/#VirtualService) documentation for examples of using subsets in these scenarios. In addition, traffic policies defined at the service-level can be overridden at a subset-level. The following rule uses a round robin load balancing policy for all traffic going to a subset named testversion that is composed of endpoints (e.g., pods) with labels (version:v3).<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: DestinationRule metadata:<br><p> <br><p> 	name: bookinfo-ratings<br><p> <br><p> spec:<br><p> <br><p> 	host: ratings.prod.svc.cluster.local<br><p> 	trafficPolicy:<br><p> 	  loadBalancer:<br><p> 	    simple: LEAST_REQUEST<br><p> 	subsets:<br><p> 	- name: testversion<br><p> 	  labels:<br><p> 	    version: v3<br><p> 	  trafficPolicy:<br><p> 	    loadBalancer:<br><p> 	      simple: ROUND_ROBIN<br><p> <br><p> ```<br><p> <br><p> &#42;&#42;Note:&#42;&#42; Policies specified for subsets will not take effect until a route rule explicitly sends traffic to this subset.<br><p> <br><p> One or more labels are typically required to identify the subset destination, however, when the corresponding DestinationRule represents a host that supports multiple SNI hosts (e.g., an egress gateway), a subset without labels may be meaningful. In this case a traffic policy with [ClientTLSSettings](#ClientTLSSettings) can be used to identify a specific SNI host corresponding to the named subset.
+     */
     @JsonProperty("trafficPolicy")
     public void setTrafficPolicy(TrafficPolicy trafficPolicy) {
         this.trafficPolicy = trafficPolicy;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/TCPHealthCheckConfig.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/TCPHealthCheckConfig.java
index 887d5de0481..fe1bd9cb5be 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/TCPHealthCheckConfig.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/TCPHealthCheckConfig.java
@@ -82,21 +82,33 @@ public TCPHealthCheckConfig(String host, Long port) {
         this.port = port;
     }
 
+    /**
+     * Host to connect to, defaults to localhost
+     */
     @JsonProperty("host")
     public String getHost() {
         return host;
     }
 
+    /**
+     * Host to connect to, defaults to localhost
+     */
     @JsonProperty("host")
     public void setHost(String host) {
         this.host = host;
     }
 
+    /**
+     * Port of host
+     */
     @JsonProperty("port")
     public Long getPort() {
         return port;
     }
 
+    /**
+     * Port of host
+     */
     @JsonProperty("port")
     public void setPort(Long port) {
         this.port = port;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/TCPRoute.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/TCPRoute.java
index 3b635a96f4c..c2029ddc279 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/TCPRoute.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/TCPRoute.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Describes match conditions and actions for routing TCP traffic. The following routing rule forwards traffic arriving at port 27017 for mongo.prod.svc.cluster.local to another Mongo server on port 5555.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: bookinfo-mongo<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- mongo.prod.svc.cluster.local<br><p> 	tcp:<br><p> 	- match:<br><p> 	  - port: 27017<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: mongo.backup.svc.cluster.local<br><p> 	      port:<br><p> 	        number: 5555<br><p> <br><p> ```
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public TCPRoute(List<L4MatchAttributes> match, List<RouteDestination> route) {
         this.route = route;
     }
 
+    /**
+     * Match conditions to be satisfied for the rule to be activated. All conditions inside a single match block have AND semantics, while the list of match blocks have OR semantics. The rule is matched if any one of the match blocks succeed.
+     */
     @JsonProperty("match")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<L4MatchAttributes> getMatch() {
         return match;
     }
 
+    /**
+     * Match conditions to be satisfied for the rule to be activated. All conditions inside a single match block have AND semantics, while the list of match blocks have OR semantics. The rule is matched if any one of the match blocks succeed.
+     */
     @JsonProperty("match")
     public void setMatch(List<L4MatchAttributes> match) {
         this.match = match;
     }
 
+    /**
+     * The destination to which the connection should be forwarded to.
+     */
     @JsonProperty("route")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RouteDestination> getRoute() {
         return route;
     }
 
+    /**
+     * The destination to which the connection should be forwarded to.
+     */
     @JsonProperty("route")
     public void setRoute(List<RouteDestination> route) {
         this.route = route;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/TLSMatchAttributes.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/TLSMatchAttributes.java
index 842e1a1f0b9..249ef7fb36b 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/TLSMatchAttributes.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/TLSMatchAttributes.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TLS connection match attributes.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -104,65 +107,101 @@ public TLSMatchAttributes(List<String> destinationSubnets, List<String> gateways
         this.sourceNamespace = sourceNamespace;
     }
 
+    /**
+     * IPv4 or IPv6 ip addresses of destination with optional subnet.  E.g., a.b.c.d/xx form or just a.b.c.d.
+     */
     @JsonProperty("destinationSubnets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDestinationSubnets() {
         return destinationSubnets;
     }
 
+    /**
+     * IPv4 or IPv6 ip addresses of destination with optional subnet.  E.g., a.b.c.d/xx form or just a.b.c.d.
+     */
     @JsonProperty("destinationSubnets")
     public void setDestinationSubnets(List<String> destinationSubnets) {
         this.destinationSubnets = destinationSubnets;
     }
 
+    /**
+     * Names of gateways where the rule should be applied. Gateway names in the top-level `gateways` field of the VirtualService (if any) are overridden. The gateway match is independent of sourceLabels.
+     */
     @JsonProperty("gateways")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getGateways() {
         return gateways;
     }
 
+    /**
+     * Names of gateways where the rule should be applied. Gateway names in the top-level `gateways` field of the VirtualService (if any) are overridden. The gateway match is independent of sourceLabels.
+     */
     @JsonProperty("gateways")
     public void setGateways(List<String> gateways) {
         this.gateways = gateways;
     }
 
+    /**
+     * Specifies the port on the host that is being addressed. Many services only expose a single port or label ports with the protocols they support, in these cases it is not required to explicitly select the port.
+     */
     @JsonProperty("port")
     public Long getPort() {
         return port;
     }
 
+    /**
+     * Specifies the port on the host that is being addressed. Many services only expose a single port or label ports with the protocols they support, in these cases it is not required to explicitly select the port.
+     */
     @JsonProperty("port")
     public void setPort(Long port) {
         this.port = port;
     }
 
+    /**
+     * SNI (server name indicator) to match on. Wildcard prefixes can be used in the SNI value, e.g., &#42;.com will match foo.example.com as well as example.com. An SNI value must be a subset (i.e., fall within the domain) of the corresponding virtual service's hosts.
+     */
     @JsonProperty("sniHosts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSniHosts() {
         return sniHosts;
     }
 
+    /**
+     * SNI (server name indicator) to match on. Wildcard prefixes can be used in the SNI value, e.g., &#42;.com will match foo.example.com as well as example.com. An SNI value must be a subset (i.e., fall within the domain) of the corresponding virtual service's hosts.
+     */
     @JsonProperty("sniHosts")
     public void setSniHosts(List<String> sniHosts) {
         this.sniHosts = sniHosts;
     }
 
+    /**
+     * One or more labels that constrain the applicability of a rule to workloads with the given labels. If the VirtualService has a list of gateways specified in the top-level `gateways` field, it should include the reserved gateway `mesh` in order for this field to be applicable.
+     */
     @JsonProperty("sourceLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getSourceLabels() {
         return sourceLabels;
     }
 
+    /**
+     * One or more labels that constrain the applicability of a rule to workloads with the given labels. If the VirtualService has a list of gateways specified in the top-level `gateways` field, it should include the reserved gateway `mesh` in order for this field to be applicable.
+     */
     @JsonProperty("sourceLabels")
     public void setSourceLabels(Map<String, String> sourceLabels) {
         this.sourceLabels = sourceLabels;
     }
 
+    /**
+     * Source namespace constraining the applicability of a rule to workloads in that namespace. If the VirtualService has a list of gateways specified in the top-level `gateways` field, it must include the reserved gateway `mesh` for this field to be applicable.
+     */
     @JsonProperty("sourceNamespace")
     public String getSourceNamespace() {
         return sourceNamespace;
     }
 
+    /**
+     * Source namespace constraining the applicability of a rule to workloads in that namespace. If the VirtualService has a list of gateways specified in the top-level `gateways` field, it must include the reserved gateway `mesh` for this field to be applicable.
+     */
     @JsonProperty("sourceNamespace")
     public void setSourceNamespace(String sourceNamespace) {
         this.sourceNamespace = sourceNamespace;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/TLSRoute.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/TLSRoute.java
index d771d83c2fa..2c604bcbcc8 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/TLSRoute.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/TLSRoute.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Describes match conditions and actions for routing unterminated TLS traffic (TLS/HTTPS) The following routing rule forwards unterminated TLS traffic arriving at port 443 of gateway called "mygateway" to internal services in the mesh based on the SNI value.<br><p> <br><p> ```yaml apiVersion: networking.istio.io/v1 kind: VirtualService metadata:<br><p> <br><p> 	name: bookinfo-sni<br><p> <br><p> spec:<br><p> <br><p> 	hosts:<br><p> 	- "&#42;.bookinfo.com"<br><p> 	gateways:<br><p> 	- mygateway<br><p> 	tls:<br><p> 	- match:<br><p> 	  - port: 443<br><p> 	    sniHosts:<br><p> 	    - login.bookinfo.com<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: login.prod.svc.cluster.local<br><p> 	- match:<br><p> 	  - port: 443<br><p> 	    sniHosts:<br><p> 	    - reviews.bookinfo.com<br><p> 	  route:<br><p> 	  - destination:<br><p> 	      host: reviews.prod.svc.cluster.local<br><p> <br><p> ```
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public TLSRoute(List<TLSMatchAttributes> match, List<RouteDestination> route) {
         this.route = route;
     }
 
+    /**
+     * Match conditions to be satisfied for the rule to be activated. All conditions inside a single match block have AND semantics, while the list of match blocks have OR semantics. The rule is matched if any one of the match blocks succeed.
+     */
     @JsonProperty("match")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TLSMatchAttributes> getMatch() {
         return match;
     }
 
+    /**
+     * Match conditions to be satisfied for the rule to be activated. All conditions inside a single match block have AND semantics, while the list of match blocks have OR semantics. The rule is matched if any one of the match blocks succeed.
+     */
     @JsonProperty("match")
     public void setMatch(List<TLSMatchAttributes> match) {
         this.match = match;
     }
 
+    /**
+     * The destination to which the connection should be forwarded to.
+     */
     @JsonProperty("route")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RouteDestination> getRoute() {
         return route;
     }
 
+    /**
+     * The destination to which the connection should be forwarded to.
+     */
     @JsonProperty("route")
     public void setRoute(List<RouteDestination> route) {
         this.route = route;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/TrafficPolicy.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/TrafficPolicy.java
index 7c8b82c2fb2..fcdc5afe6ab 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/TrafficPolicy.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/TrafficPolicy.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Traffic policies to apply for a specific destination, across all destination ports. See DestinationRule for examples.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -105,72 +108,114 @@ public TrafficPolicy(ConnectionPoolSettings connectionPool, LoadBalancerSettings
         this.tunnel = tunnel;
     }
 
+    /**
+     * Traffic policies to apply for a specific destination, across all destination ports. See DestinationRule for examples.
+     */
     @JsonProperty("connectionPool")
     public ConnectionPoolSettings getConnectionPool() {
         return connectionPool;
     }
 
+    /**
+     * Traffic policies to apply for a specific destination, across all destination ports. See DestinationRule for examples.
+     */
     @JsonProperty("connectionPool")
     public void setConnectionPool(ConnectionPoolSettings connectionPool) {
         this.connectionPool = connectionPool;
     }
 
+    /**
+     * Traffic policies to apply for a specific destination, across all destination ports. See DestinationRule for examples.
+     */
     @JsonProperty("loadBalancer")
     public LoadBalancerSettings getLoadBalancer() {
         return loadBalancer;
     }
 
+    /**
+     * Traffic policies to apply for a specific destination, across all destination ports. See DestinationRule for examples.
+     */
     @JsonProperty("loadBalancer")
     public void setLoadBalancer(LoadBalancerSettings loadBalancer) {
         this.loadBalancer = loadBalancer;
     }
 
+    /**
+     * Traffic policies to apply for a specific destination, across all destination ports. See DestinationRule for examples.
+     */
     @JsonProperty("outlierDetection")
     public OutlierDetection getOutlierDetection() {
         return outlierDetection;
     }
 
+    /**
+     * Traffic policies to apply for a specific destination, across all destination ports. See DestinationRule for examples.
+     */
     @JsonProperty("outlierDetection")
     public void setOutlierDetection(OutlierDetection outlierDetection) {
         this.outlierDetection = outlierDetection;
     }
 
+    /**
+     * Traffic policies specific to individual ports. Note that port level settings will override the destination-level settings. Traffic settings specified at the destination-level will not be inherited when overridden by port-level settings, i.e. default values will be applied to fields omitted in port-level traffic policies.
+     */
     @JsonProperty("portLevelSettings")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TrafficPolicyPortTrafficPolicy> getPortLevelSettings() {
         return portLevelSettings;
     }
 
+    /**
+     * Traffic policies specific to individual ports. Note that port level settings will override the destination-level settings. Traffic settings specified at the destination-level will not be inherited when overridden by port-level settings, i.e. default values will be applied to fields omitted in port-level traffic policies.
+     */
     @JsonProperty("portLevelSettings")
     public void setPortLevelSettings(List<TrafficPolicyPortTrafficPolicy> portLevelSettings) {
         this.portLevelSettings = portLevelSettings;
     }
 
+    /**
+     * Traffic policies to apply for a specific destination, across all destination ports. See DestinationRule for examples.
+     */
     @JsonProperty("proxyProtocol")
     public TrafficPolicyProxyProtocol getProxyProtocol() {
         return proxyProtocol;
     }
 
+    /**
+     * Traffic policies to apply for a specific destination, across all destination ports. See DestinationRule for examples.
+     */
     @JsonProperty("proxyProtocol")
     public void setProxyProtocol(TrafficPolicyProxyProtocol proxyProtocol) {
         this.proxyProtocol = proxyProtocol;
     }
 
+    /**
+     * Traffic policies to apply for a specific destination, across all destination ports. See DestinationRule for examples.
+     */
     @JsonProperty("tls")
     public ClientTLSSettings getTls() {
         return tls;
     }
 
+    /**
+     * Traffic policies to apply for a specific destination, across all destination ports. See DestinationRule for examples.
+     */
     @JsonProperty("tls")
     public void setTls(ClientTLSSettings tls) {
         this.tls = tls;
     }
 
+    /**
+     * Traffic policies to apply for a specific destination, across all destination ports. See DestinationRule for examples.
+     */
     @JsonProperty("tunnel")
     public TrafficPolicyTunnelSettings getTunnel() {
         return tunnel;
     }
 
+    /**
+     * Traffic policies to apply for a specific destination, across all destination ports. See DestinationRule for examples.
+     */
     @JsonProperty("tunnel")
     public void setTunnel(TrafficPolicyTunnelSettings tunnel) {
         this.tunnel = tunnel;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/TrafficPolicyPortTrafficPolicy.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/TrafficPolicyPortTrafficPolicy.java
index 8db6e574e1c..cd19e5f9f1e 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/TrafficPolicyPortTrafficPolicy.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/TrafficPolicyPortTrafficPolicy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Traffic policies that apply to specific ports of the service
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public TrafficPolicyPortTrafficPolicy(ConnectionPoolSettings connectionPool, Loa
         this.tls = tls;
     }
 
+    /**
+     * Traffic policies that apply to specific ports of the service
+     */
     @JsonProperty("connectionPool")
     public ConnectionPoolSettings getConnectionPool() {
         return connectionPool;
     }
 
+    /**
+     * Traffic policies that apply to specific ports of the service
+     */
     @JsonProperty("connectionPool")
     public void setConnectionPool(ConnectionPoolSettings connectionPool) {
         this.connectionPool = connectionPool;
     }
 
+    /**
+     * Traffic policies that apply to specific ports of the service
+     */
     @JsonProperty("loadBalancer")
     public LoadBalancerSettings getLoadBalancer() {
         return loadBalancer;
     }
 
+    /**
+     * Traffic policies that apply to specific ports of the service
+     */
     @JsonProperty("loadBalancer")
     public void setLoadBalancer(LoadBalancerSettings loadBalancer) {
         this.loadBalancer = loadBalancer;
     }
 
+    /**
+     * Traffic policies that apply to specific ports of the service
+     */
     @JsonProperty("outlierDetection")
     public OutlierDetection getOutlierDetection() {
         return outlierDetection;
     }
 
+    /**
+     * Traffic policies that apply to specific ports of the service
+     */
     @JsonProperty("outlierDetection")
     public void setOutlierDetection(OutlierDetection outlierDetection) {
         this.outlierDetection = outlierDetection;
     }
 
+    /**
+     * Traffic policies that apply to specific ports of the service
+     */
     @JsonProperty("port")
     public PortSelector getPort() {
         return port;
     }
 
+    /**
+     * Traffic policies that apply to specific ports of the service
+     */
     @JsonProperty("port")
     public void setPort(PortSelector port) {
         this.port = port;
     }
 
+    /**
+     * Traffic policies that apply to specific ports of the service
+     */
     @JsonProperty("tls")
     public ClientTLSSettings getTls() {
         return tls;
     }
 
+    /**
+     * Traffic policies that apply to specific ports of the service
+     */
     @JsonProperty("tls")
     public void setTls(ClientTLSSettings tls) {
         this.tls = tls;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/TrafficPolicyTunnelSettings.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/TrafficPolicyTunnelSettings.java
index 7681818ee67..f04a3c3c1c6 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/TrafficPolicyTunnelSettings.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/TrafficPolicyTunnelSettings.java
@@ -86,31 +86,49 @@ public TrafficPolicyTunnelSettings(String protocol, String targetHost, Long targ
         this.targetPort = targetPort;
     }
 
+    /**
+     * Specifies which protocol to use for tunneling the downstream connection. Supported protocols are:<br><p> <br><p> 	CONNECT - uses HTTP CONNECT;<br><p> 	POST - uses HTTP POST.<br><p> <br><p> CONNECT is used by default if not specified. HTTP version for upstream requests is determined by the service protocol defined for the proxy.
+     */
     @JsonProperty("protocol")
     public String getProtocol() {
         return protocol;
     }
 
+    /**
+     * Specifies which protocol to use for tunneling the downstream connection. Supported protocols are:<br><p> <br><p> 	CONNECT - uses HTTP CONNECT;<br><p> 	POST - uses HTTP POST.<br><p> <br><p> CONNECT is used by default if not specified. HTTP version for upstream requests is determined by the service protocol defined for the proxy.
+     */
     @JsonProperty("protocol")
     public void setProtocol(String protocol) {
         this.protocol = protocol;
     }
 
+    /**
+     * Specifies a host to which the downstream connection is tunneled. Target host must be an FQDN or IP address.
+     */
     @JsonProperty("targetHost")
     public String getTargetHost() {
         return targetHost;
     }
 
+    /**
+     * Specifies a host to which the downstream connection is tunneled. Target host must be an FQDN or IP address.
+     */
     @JsonProperty("targetHost")
     public void setTargetHost(String targetHost) {
         this.targetHost = targetHost;
     }
 
+    /**
+     * Specifies a port to which the downstream connection is tunneled.
+     */
     @JsonProperty("targetPort")
     public Long getTargetPort() {
         return targetPort;
     }
 
+    /**
+     * Specifies a port to which the downstream connection is tunneled.
+     */
     @JsonProperty("targetPort")
     public void setTargetPort(Long targetPort) {
         this.targetPort = targetPort;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/VirtualService.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/VirtualService.java
index 20b32cbfa99..4814174b52c 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/VirtualService.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/VirtualService.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Configuration affecting traffic routing.<br><p> <br><p> &lt;!-- crd generation tags that should apply these routes" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -116,67 +119,103 @@ public VirtualService(List<String> exportTo, List<String> gateways, List<String>
         this.tls = tls;
     }
 
+    /**
+     * A list of namespaces to which this virtual service is exported. Exporting a virtual service allows it to be used by sidecars and gateways defined in other namespaces. This feature provides a mechanism for service owners and mesh administrators to control the visibility of virtual services across namespace boundaries.<br><p> <br><p> If no namespaces are specified then the virtual service is exported to all namespaces by default.<br><p> <br><p> The value "." is reserved and defines an export to the same namespace that the virtual service is declared in. Similarly the value "&#42;" is reserved and defines an export to all namespaces.
+     */
     @JsonProperty("exportTo")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getExportTo() {
         return exportTo;
     }
 
+    /**
+     * A list of namespaces to which this virtual service is exported. Exporting a virtual service allows it to be used by sidecars and gateways defined in other namespaces. This feature provides a mechanism for service owners and mesh administrators to control the visibility of virtual services across namespace boundaries.<br><p> <br><p> If no namespaces are specified then the virtual service is exported to all namespaces by default.<br><p> <br><p> The value "." is reserved and defines an export to the same namespace that the virtual service is declared in. Similarly the value "&#42;" is reserved and defines an export to all namespaces.
+     */
     @JsonProperty("exportTo")
     public void setExportTo(List<String> exportTo) {
         this.exportTo = exportTo;
     }
 
+    /**
+     * The names of gateways and sidecars that should apply these routes. Gateways in other namespaces may be referred to by `&lt;gateway namespace&gt;/&lt;gateway name&gt;`; specifying a gateway with no namespace qualifier is the same as specifying the VirtualService's namespace. A single VirtualService is used for sidecars inside the mesh as well as for one or more gateways. The selection condition imposed by this field can be overridden using the source field in the match conditions of protocol-specific routes. The reserved word `mesh` is used to imply all the sidecars in the mesh. When this field is omitted, the default gateway (`mesh`) will be used, which would apply the rule to all sidecars in the mesh. If a list of gateway names is provided, the rules will apply only to the gateways. To apply the rules to both gateways and sidecars, specify `mesh` as one of the gateway names.
+     */
     @JsonProperty("gateways")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getGateways() {
         return gateways;
     }
 
+    /**
+     * The names of gateways and sidecars that should apply these routes. Gateways in other namespaces may be referred to by `&lt;gateway namespace&gt;/&lt;gateway name&gt;`; specifying a gateway with no namespace qualifier is the same as specifying the VirtualService's namespace. A single VirtualService is used for sidecars inside the mesh as well as for one or more gateways. The selection condition imposed by this field can be overridden using the source field in the match conditions of protocol-specific routes. The reserved word `mesh` is used to imply all the sidecars in the mesh. When this field is omitted, the default gateway (`mesh`) will be used, which would apply the rule to all sidecars in the mesh. If a list of gateway names is provided, the rules will apply only to the gateways. To apply the rules to both gateways and sidecars, specify `mesh` as one of the gateway names.
+     */
     @JsonProperty("gateways")
     public void setGateways(List<String> gateways) {
         this.gateways = gateways;
     }
 
+    /**
+     * The destination hosts to which traffic is being sent. Could be a DNS name with wildcard prefix or an IP address.  Depending on the platform, short-names can also be used instead of a FQDN (i.e. has no dots in the name). In such a scenario, the FQDN of the host would be derived based on the underlying platform.<br><p> <br><p> A single VirtualService can be used to describe all the traffic properties of the corresponding hosts, including those for multiple HTTP and TCP ports. Alternatively, the traffic properties of a host can be defined using more than one VirtualService, with certain caveats. Refer to the [Operations Guide](https://istio.io/docs/ops/best-practices/traffic-management/#split-virtual-services) for details.<br><p> <br><p> &#42;Note for Kubernetes users&#42;: When short names are used (e.g. "reviews" instead of "reviews.default.svc.cluster.local"), Istio will interpret the short name based on the namespace of the rule, not the service. A rule in the "default" namespace containing a host "reviews" will be interpreted as "reviews.default.svc.cluster.local", irrespective of the actual namespace associated with the reviews service. _To avoid potential misconfigurations, it is recommended to always use fully qualified domain names over short names._<br><p> <br><p> The hosts field applies to both HTTP and TCP services. Service inside the mesh, i.e., those found in the service registry, must always be referred to using their alphanumeric names. IP addresses are allowed only for services defined via the Gateway.<br><p> <br><p> &#42;Note&#42;: It must be empty for a delegate VirtualService.
+     */
     @JsonProperty("hosts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getHosts() {
         return hosts;
     }
 
+    /**
+     * The destination hosts to which traffic is being sent. Could be a DNS name with wildcard prefix or an IP address.  Depending on the platform, short-names can also be used instead of a FQDN (i.e. has no dots in the name). In such a scenario, the FQDN of the host would be derived based on the underlying platform.<br><p> <br><p> A single VirtualService can be used to describe all the traffic properties of the corresponding hosts, including those for multiple HTTP and TCP ports. Alternatively, the traffic properties of a host can be defined using more than one VirtualService, with certain caveats. Refer to the [Operations Guide](https://istio.io/docs/ops/best-practices/traffic-management/#split-virtual-services) for details.<br><p> <br><p> &#42;Note for Kubernetes users&#42;: When short names are used (e.g. "reviews" instead of "reviews.default.svc.cluster.local"), Istio will interpret the short name based on the namespace of the rule, not the service. A rule in the "default" namespace containing a host "reviews" will be interpreted as "reviews.default.svc.cluster.local", irrespective of the actual namespace associated with the reviews service. _To avoid potential misconfigurations, it is recommended to always use fully qualified domain names over short names._<br><p> <br><p> The hosts field applies to both HTTP and TCP services. Service inside the mesh, i.e., those found in the service registry, must always be referred to using their alphanumeric names. IP addresses are allowed only for services defined via the Gateway.<br><p> <br><p> &#42;Note&#42;: It must be empty for a delegate VirtualService.
+     */
     @JsonProperty("hosts")
     public void setHosts(List<String> hosts) {
         this.hosts = hosts;
     }
 
+    /**
+     * An ordered list of route rules for HTTP traffic. HTTP routes will be applied to platform service ports using HTTP/HTTP2/GRPC protocols, gateway ports with protocol HTTP/HTTP2/GRPC/TLS-terminated-HTTPS and service entry ports using HTTP/HTTP2/GRPC protocols.  The first rule matching an incoming request is used.
+     */
     @JsonProperty("http")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HTTPRoute> getHttp() {
         return http;
     }
 
+    /**
+     * An ordered list of route rules for HTTP traffic. HTTP routes will be applied to platform service ports using HTTP/HTTP2/GRPC protocols, gateway ports with protocol HTTP/HTTP2/GRPC/TLS-terminated-HTTPS and service entry ports using HTTP/HTTP2/GRPC protocols.  The first rule matching an incoming request is used.
+     */
     @JsonProperty("http")
     public void setHttp(List<HTTPRoute> http) {
         this.http = http;
     }
 
+    /**
+     * An ordered list of route rules for opaque TCP traffic. TCP routes will be applied to any port that is not a HTTP or TLS port. The first rule matching an incoming request is used.
+     */
     @JsonProperty("tcp")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TCPRoute> getTcp() {
         return tcp;
     }
 
+    /**
+     * An ordered list of route rules for opaque TCP traffic. TCP routes will be applied to any port that is not a HTTP or TLS port. The first rule matching an incoming request is used.
+     */
     @JsonProperty("tcp")
     public void setTcp(List<TCPRoute> tcp) {
         this.tcp = tcp;
     }
 
+    /**
+     * An ordered list of route rule for non-terminated TLS &amp; HTTPS traffic. Routing is typically performed using the SNI value presented by the ClientHello message. TLS routes will be applied to platform service ports named 'https-&#42;', 'tls-&#42;', unterminated gateway ports using HTTPS/TLS protocols (i.e. with "passthrough" TLS mode) and service entry ports using HTTPS/TLS protocols.  The first rule matching an incoming request is used.  NOTE: Traffic 'https-&#42;' or 'tls-&#42;' ports without associated virtual service will be treated as opaque TCP traffic.
+     */
     @JsonProperty("tls")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TLSRoute> getTls() {
         return tls;
     }
 
+    /**
+     * An ordered list of route rule for non-terminated TLS &amp; HTTPS traffic. Routing is typically performed using the SNI value presented by the ClientHello message. TLS routes will be applied to platform service ports named 'https-&#42;', 'tls-&#42;', unterminated gateway ports using HTTPS/TLS protocols (i.e. with "passthrough" TLS mode) and service entry ports using HTTPS/TLS protocols.  The first rule matching an incoming request is used.  NOTE: Traffic 'https-&#42;' or 'tls-&#42;' ports without associated virtual service will be treated as opaque TCP traffic.
+     */
     @JsonProperty("tls")
     public void setTls(List<TLSRoute> tls) {
         this.tls = tls;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/WorkloadEntry.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/WorkloadEntry.java
index ee7fd716a87..0d7cbbca42b 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/WorkloadEntry.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/WorkloadEntry.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WorkloadEntry enables specifying the properties of a single non-Kubernetes workload such a VM or a bare metal services that can be referred to by service entries.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -114,73 +117,115 @@ public WorkloadEntry(String address, Map<String, String> labels, String locality
         this.weight = weight;
     }
 
+    /**
+     * Address associated with the network endpoint without the port.  Domain names can be used if and only if the resolution is set to DNS, and must be fully-qualified without wildcards. Use the form unix:///absolute/path/to/socket for Unix domain socket endpoints. If address is empty, network must be specified.
+     */
     @JsonProperty("address")
     public String getAddress() {
         return address;
     }
 
+    /**
+     * Address associated with the network endpoint without the port.  Domain names can be used if and only if the resolution is set to DNS, and must be fully-qualified without wildcards. Use the form unix:///absolute/path/to/socket for Unix domain socket endpoints. If address is empty, network must be specified.
+     */
     @JsonProperty("address")
     public void setAddress(String address) {
         this.address = address;
     }
 
+    /**
+     * One or more labels associated with the endpoint.
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabels() {
         return labels;
     }
 
+    /**
+     * One or more labels associated with the endpoint.
+     */
     @JsonProperty("labels")
     public void setLabels(Map<String, String> labels) {
         this.labels = labels;
     }
 
+    /**
+     * The locality associated with the endpoint. A locality corresponds to a failure domain (e.g., country/region/zone). Arbitrary failure domain hierarchies can be represented by separating each encapsulating failure domain by /. For example, the locality of an an endpoint in US, in US-East-1 region, within availability zone az-1, in data center rack r11 can be represented as us/us-east-1/az-1/r11. Istio will configure the sidecar to route to endpoints within the same locality as the sidecar. If none of the endpoints in the locality are available, endpoints parent locality (but within the same network ID) will be chosen. For example, if there are two endpoints in same network (networkID "n1"), say e1 with locality us/us-east-1/az-1/r11 and e2 with locality us/us-east-1/az-2/r12, a sidecar from us/us-east-1/az-1/r11 locality will prefer e1 from the same locality over e2 from a different locality. Endpoint e2 could be the IP associated with a gateway (that bridges networks n1 and n2), or the IP associated with a standard service endpoint.
+     */
     @JsonProperty("locality")
     public String getLocality() {
         return locality;
     }
 
+    /**
+     * The locality associated with the endpoint. A locality corresponds to a failure domain (e.g., country/region/zone). Arbitrary failure domain hierarchies can be represented by separating each encapsulating failure domain by /. For example, the locality of an an endpoint in US, in US-East-1 region, within availability zone az-1, in data center rack r11 can be represented as us/us-east-1/az-1/r11. Istio will configure the sidecar to route to endpoints within the same locality as the sidecar. If none of the endpoints in the locality are available, endpoints parent locality (but within the same network ID) will be chosen. For example, if there are two endpoints in same network (networkID "n1"), say e1 with locality us/us-east-1/az-1/r11 and e2 with locality us/us-east-1/az-2/r12, a sidecar from us/us-east-1/az-1/r11 locality will prefer e1 from the same locality over e2 from a different locality. Endpoint e2 could be the IP associated with a gateway (that bridges networks n1 and n2), or the IP associated with a standard service endpoint.
+     */
     @JsonProperty("locality")
     public void setLocality(String locality) {
         this.locality = locality;
     }
 
+    /**
+     * Network enables Istio to group endpoints resident in the same L3 domain/network. All endpoints in the same network are assumed to be directly reachable from one another. When endpoints in different networks cannot reach each other directly, an Istio Gateway can be used to establish connectivity (usually using the `AUTO_PASSTHROUGH` mode in a Gateway Server). This is an advanced configuration used typically for spanning an Istio mesh over multiple clusters. Required if address is not provided.
+     */
     @JsonProperty("network")
     public String getNetwork() {
         return network;
     }
 
+    /**
+     * Network enables Istio to group endpoints resident in the same L3 domain/network. All endpoints in the same network are assumed to be directly reachable from one another. When endpoints in different networks cannot reach each other directly, an Istio Gateway can be used to establish connectivity (usually using the `AUTO_PASSTHROUGH` mode in a Gateway Server). This is an advanced configuration used typically for spanning an Istio mesh over multiple clusters. Required if address is not provided.
+     */
     @JsonProperty("network")
     public void setNetwork(String network) {
         this.network = network;
     }
 
+    /**
+     * Set of ports associated with the endpoint. If the port map is specified, it must be a map of servicePortName to this endpoint's port, such that traffic to the service port will be forwarded to the endpoint port that maps to the service's portName. If omitted, and the targetPort is specified as part of the service's port specification, traffic to the service port will be forwarded to one of the endpoints on the specified `targetPort`. If both the targetPort and endpoint's port map are not specified, traffic to a service port will be forwarded to one of the endpoints on the same port.<br><p> <br><p> &#42;&#42;NOTE 1:&#42;&#42; Do not use for `unix://` addresses.<br><p> <br><p> &#42;&#42;NOTE 2:&#42;&#42; endpoint port map takes precedence over targetPort.
+     */
     @JsonProperty("ports")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Long> getPorts() {
         return ports;
     }
 
+    /**
+     * Set of ports associated with the endpoint. If the port map is specified, it must be a map of servicePortName to this endpoint's port, such that traffic to the service port will be forwarded to the endpoint port that maps to the service's portName. If omitted, and the targetPort is specified as part of the service's port specification, traffic to the service port will be forwarded to one of the endpoints on the specified `targetPort`. If both the targetPort and endpoint's port map are not specified, traffic to a service port will be forwarded to one of the endpoints on the same port.<br><p> <br><p> &#42;&#42;NOTE 1:&#42;&#42; Do not use for `unix://` addresses.<br><p> <br><p> &#42;&#42;NOTE 2:&#42;&#42; endpoint port map takes precedence over targetPort.
+     */
     @JsonProperty("ports")
     public void setPorts(Map<String, Long> ports) {
         this.ports = ports;
     }
 
+    /**
+     * The service account associated with the workload if a sidecar is present in the workload. The service account must be present in the same namespace as the configuration ( WorkloadEntry or a ServiceEntry)
+     */
     @JsonProperty("serviceAccount")
     public String getServiceAccount() {
         return serviceAccount;
     }
 
+    /**
+     * The service account associated with the workload if a sidecar is present in the workload. The service account must be present in the same namespace as the configuration ( WorkloadEntry or a ServiceEntry)
+     */
     @JsonProperty("serviceAccount")
     public void setServiceAccount(String serviceAccount) {
         this.serviceAccount = serviceAccount;
     }
 
+    /**
+     * The load balancing weight associated with the endpoint. Endpoints with higher weights will receive proportionally higher traffic.
+     */
     @JsonProperty("weight")
     public Long getWeight() {
         return weight;
     }
 
+    /**
+     * The load balancing weight associated with the endpoint. Endpoints with higher weights will receive proportionally higher traffic.
+     */
     @JsonProperty("weight")
     public void setWeight(Long weight) {
         this.weight = weight;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/WorkloadGroup.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/WorkloadGroup.java
index 0b121165122..97cb4f13438 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/WorkloadGroup.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/WorkloadGroup.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * `WorkloadGroup` enables specifying the properties of a single workload for bootstrap and provides a template for `WorkloadEntry`, similar to how `Deployment` specifies properties of workloads via `Pod` templates. A `WorkloadGroup` can have more than one `WorkloadEntry`. `WorkloadGroup` has no relationship to resources which control service registry like `ServiceEntry` and as such doesn't configure host name for these workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -96,31 +99,49 @@ public WorkloadGroup(WorkloadGroupObjectMeta metadata, ReadinessProbe probe, Wor
         this.template = template;
     }
 
+    /**
+     * `WorkloadGroup` enables specifying the properties of a single workload for bootstrap and provides a template for `WorkloadEntry`, similar to how `Deployment` specifies properties of workloads via `Pod` templates. A `WorkloadGroup` can have more than one `WorkloadEntry`. `WorkloadGroup` has no relationship to resources which control service registry like `ServiceEntry` and as such doesn't configure host name for these workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public WorkloadGroupObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * `WorkloadGroup` enables specifying the properties of a single workload for bootstrap and provides a template for `WorkloadEntry`, similar to how `Deployment` specifies properties of workloads via `Pod` templates. A `WorkloadGroup` can have more than one `WorkloadEntry`. `WorkloadGroup` has no relationship to resources which control service registry like `ServiceEntry` and as such doesn't configure host name for these workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(WorkloadGroupObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * `WorkloadGroup` enables specifying the properties of a single workload for bootstrap and provides a template for `WorkloadEntry`, similar to how `Deployment` specifies properties of workloads via `Pod` templates. A `WorkloadGroup` can have more than one `WorkloadEntry`. `WorkloadGroup` has no relationship to resources which control service registry like `ServiceEntry` and as such doesn't configure host name for these workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("probe")
     public ReadinessProbe getProbe() {
         return probe;
     }
 
+    /**
+     * `WorkloadGroup` enables specifying the properties of a single workload for bootstrap and provides a template for `WorkloadEntry`, similar to how `Deployment` specifies properties of workloads via `Pod` templates. A `WorkloadGroup` can have more than one `WorkloadEntry`. `WorkloadGroup` has no relationship to resources which control service registry like `ServiceEntry` and as such doesn't configure host name for these workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("probe")
     public void setProbe(ReadinessProbe probe) {
         this.probe = probe;
     }
 
+    /**
+     * `WorkloadGroup` enables specifying the properties of a single workload for bootstrap and provides a template for `WorkloadEntry`, similar to how `Deployment` specifies properties of workloads via `Pod` templates. A `WorkloadGroup` can have more than one `WorkloadEntry`. `WorkloadGroup` has no relationship to resources which control service registry like `ServiceEntry` and as such doesn't configure host name for these workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("template")
     public WorkloadEntry getTemplate() {
         return template;
     }
 
+    /**
+     * `WorkloadGroup` enables specifying the properties of a single workload for bootstrap and provides a template for `WorkloadEntry`, similar to how `Deployment` specifies properties of workloads via `Pod` templates. A `WorkloadGroup` can have more than one `WorkloadEntry`. `WorkloadGroup` has no relationship to resources which control service registry like `ServiceEntry` and as such doesn't configure host name for these workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("template")
     public void setTemplate(WorkloadEntry template) {
         this.template = template;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/WorkloadGroupObjectMeta.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/WorkloadGroupObjectMeta.java
index c72c8e65cdf..ff2a33e9930 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/WorkloadGroupObjectMeta.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/WorkloadGroupObjectMeta.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * `ObjectMeta` describes metadata that will be attached to a `WorkloadEntry`. It is a subset of the supported Kubernetes metadata.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -84,23 +87,35 @@ public WorkloadGroupObjectMeta(Map<String, String> annotations, Map<String, Stri
         this.labels = labels;
     }
 
+    /**
+     * Annotations to attach
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations to attach
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Labels to attach
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabels() {
         return labels;
     }
 
+    /**
+     * Labels to attach
+     */
     @JsonProperty("labels")
     public void setLabels(Map<String, String> labels) {
         this.labels = labels;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/WorkloadSelector.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/WorkloadSelector.java
index 0525d7709f6..7ed5c3cb957 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/WorkloadSelector.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1alpha3/WorkloadSelector.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * `WorkloadSelector` specifies the criteria used to determine if the `Gateway`, `Sidecar`, `EnvoyFilter`, `ServiceEntry`, or `DestinationRule` configuration can be applied to a proxy. The matching criteria includes the metadata associated with a proxy, workload instance info such as labels attached to the pod/VM, or any other info that the proxy provides to Istio during the initial handshake. If multiple conditions are specified, all conditions need to match in order for the workload instance to be selected. Currently, only label based selection mechanism is supported.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,12 +82,18 @@ public WorkloadSelector(Map<String, String> labels) {
         this.labels = labels;
     }
 
+    /**
+     * One or more labels that indicate a specific set of pods/VMs on which the configuration should be applied. The scope of label search is restricted to the configuration namespace in which the the resource is present.
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabels() {
         return labels;
     }
 
+    /**
+     * One or more labels that indicate a specific set of pods/VMs on which the configuration should be applied. The scope of label search is restricted to the configuration namespace in which the the resource is present.
+     */
     @JsonProperty("labels")
     public void setLabels(Map<String, String> labels) {
         this.labels = labels;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1beta1/ProxyConfig.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1beta1/ProxyConfig.java
index e9c0d94033a..84fe486e0ac 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1beta1/ProxyConfig.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1beta1/ProxyConfig.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * `ProxyConfig` exposes proxy level configuration options.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,42 +105,66 @@ public ProxyConfig(Integer concurrency, Map<String, String> environmentVariables
         this.selector = selector;
     }
 
+    /**
+     * `ProxyConfig` exposes proxy level configuration options.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("concurrency")
     public Integer getConcurrency() {
         return concurrency;
     }
 
+    /**
+     * `ProxyConfig` exposes proxy level configuration options.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("concurrency")
     public void setConcurrency(Integer concurrency) {
         this.concurrency = concurrency;
     }
 
+    /**
+     * Additional environment variables for the proxy. Names starting with `ISTIO_META_` will be included in the generated bootstrap configuration and sent to the XDS server.
+     */
     @JsonProperty("environmentVariables")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getEnvironmentVariables() {
         return environmentVariables;
     }
 
+    /**
+     * Additional environment variables for the proxy. Names starting with `ISTIO_META_` will be included in the generated bootstrap configuration and sent to the XDS server.
+     */
     @JsonProperty("environmentVariables")
     public void setEnvironmentVariables(Map<String, String> environmentVariables) {
         this.environmentVariables = environmentVariables;
     }
 
+    /**
+     * `ProxyConfig` exposes proxy level configuration options.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("image")
     public ProxyImage getImage() {
         return image;
     }
 
+    /**
+     * `ProxyConfig` exposes proxy level configuration options.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("image")
     public void setImage(ProxyImage image) {
         this.image = image;
     }
 
+    /**
+     * `ProxyConfig` exposes proxy level configuration options.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("selector")
     public WorkloadSelector getSelector() {
         return selector;
     }
 
+    /**
+     * `ProxyConfig` exposes proxy level configuration options.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("selector")
     public void setSelector(WorkloadSelector selector) {
         this.selector = selector;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1beta1/ProxyImage.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1beta1/ProxyImage.java
index e011aa54ace..b459d67afbf 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1beta1/ProxyImage.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/networking/v1beta1/ProxyImage.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * The following values are used to construct proxy image url. format: `${hub}/${image_name}/${tag}-${image_type}`, example: `docker.io/istio/proxyv2:1.11.1` or `docker.io/istio/proxyv2:1.11.1-distroless`. This information was previously part of the Values API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ProxyImage(String imageType) {
         this.imageType = imageType;
     }
 
+    /**
+     * The image type of the image. Istio publishes default, debug, and distroless images. Other values are allowed if those image types (example: centos) are published to the specified hub. supported values: default, debug, distroless.
+     */
     @JsonProperty("imageType")
     public String getImageType() {
         return imageType;
     }
 
+    /**
+     * The image type of the image. Istio publishes default, debug, and distroless images. Other values are allowed if those image types (example: centos) are published to the specified hub. supported values: default, debug, distroless.
+     */
     @JsonProperty("imageType")
     public void setImageType(String imageType) {
         this.imageType = imageType;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1alpha1/IstioCertificateRequest.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1alpha1/IstioCertificateRequest.java
index 131e6fc7b34..eb4ab3129ba 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1alpha1/IstioCertificateRequest.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1alpha1/IstioCertificateRequest.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Certificate request message. The authentication should be based on: 1. Bearer tokens carried in the side channel; 2. Client-side certificate via Mutual TLS handshake. Note: the service implementation is REQUIRED to verify the authenticated caller is authorize to all SANs in the CSR. The server side may overwrite any requested certificate field based on its policies.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,32 +90,50 @@ public IstioCertificateRequest(String csr, Object metadata, Long validityDuratio
         this.validityDuration = validityDuration;
     }
 
+    /**
+     * PEM-encoded certificate request. The public key in the CSR is used to generate the certificate, and other fields in the generated certificate may be overwritten by the CA.
+     */
     @JsonProperty("csr")
     public String getCsr() {
         return csr;
     }
 
+    /**
+     * PEM-encoded certificate request. The public key in the CSR is used to generate the certificate, and other fields in the generated certificate may be overwritten by the CA.
+     */
     @JsonProperty("csr")
     public void setCsr(String csr) {
         this.csr = csr;
     }
 
+    /**
+     * Certificate request message. The authentication should be based on: 1. Bearer tokens carried in the side channel; 2. Client-side certificate via Mutual TLS handshake. Note: the service implementation is REQUIRED to verify the authenticated caller is authorize to all SANs in the CSR. The server side may overwrite any requested certificate field based on its policies.
+     */
     @JsonProperty("metadata")
     public Object getMetadata() {
         return metadata;
     }
 
+    /**
+     * Certificate request message. The authentication should be based on: 1. Bearer tokens carried in the side channel; 2. Client-side certificate via Mutual TLS handshake. Note: the service implementation is REQUIRED to verify the authenticated caller is authorize to all SANs in the CSR. The server side may overwrite any requested certificate field based on its policies.
+     */
     @JsonProperty("metadata")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setMetadata(Object metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Optional: requested certificate validity period, in seconds.
+     */
     @JsonProperty("validityDuration")
     public Long getValidityDuration() {
         return validityDuration;
     }
 
+    /**
+     * Optional: requested certificate validity period, in seconds.
+     */
     @JsonProperty("validityDuration")
     public void setValidityDuration(Long validityDuration) {
         this.validityDuration = validityDuration;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1alpha1/IstioCertificateResponse.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1alpha1/IstioCertificateResponse.java
index d9e25840665..760b6ee314e 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1alpha1/IstioCertificateResponse.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1alpha1/IstioCertificateResponse.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Certificate response message.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public IstioCertificateResponse(List<String> certChain) {
         this.certChain = certChain;
     }
 
+    /**
+     * PEM-encoded certificate chain. The leaf cert is the first element, and the root cert is the last element.
+     */
     @JsonProperty("certChain")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCertChain() {
         return certChain;
     }
 
+    /**
+     * PEM-encoded certificate chain. The leaf cert is the first element, and the root cert is the last element.
+     */
     @JsonProperty("certChain")
     public void setCertChain(List<String> certChain) {
         this.certChain = certChain;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1alpha1/UnimplementedIstioCertificateServiceServer.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1alpha1/UnimplementedIstioCertificateServiceServer.java
index 29f53fefb04..bb8da30b2cd 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1alpha1/UnimplementedIstioCertificateServiceServer.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1alpha1/UnimplementedIstioCertificateServiceServer.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UnimplementedIstioCertificateServiceServer must be embedded to have forward compatible implementations.<br><p> <br><p> NOTE: this should be embedded by value instead of pointer to avoid a nil pointer dereference when methods are called.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/AuthorizationPolicy.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/AuthorizationPolicy.java
index b6d77d83d63..971bca8d5de 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/AuthorizationPolicy.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/AuthorizationPolicy.java
@@ -42,6 +42,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AuthorizationPolicy enables access control on workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = io.fabric8.kubernetes.model.jackson.JsonUnwrappedDeserializer.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -116,64 +119,100 @@ public AuthorizationPolicy(IsAuthorizationPolicyActionDetail actionDetail, Autho
         this.targetRefs = targetRefs;
     }
 
+    /**
+     * AuthorizationPolicy enables access control on workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("ActionDetail")
     @JsonUnwrapped
     public IsAuthorizationPolicyActionDetail getActionDetail() {
         return actionDetail;
     }
 
+    /**
+     * AuthorizationPolicy enables access control on workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("ActionDetail")
     public void setActionDetail(IsAuthorizationPolicyActionDetail actionDetail) {
         this.actionDetail = actionDetail;
     }
 
+    /**
+     * AuthorizationPolicy enables access control on workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("action")
     public AuthorizationPolicyAction getAction() {
         return action;
     }
 
+    /**
+     * AuthorizationPolicy enables access control on workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("action")
     public void setAction(AuthorizationPolicyAction action) {
         this.action = action;
     }
 
+    /**
+     * Optional. A list of rules to match the request. A match occurs when at least one rule matches the request.<br><p> <br><p> If not set, the match will never occur. This is equivalent to setting a default of deny for the target workloads if the action is ALLOW.
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Rule> getRules() {
         return rules;
     }
 
+    /**
+     * Optional. A list of rules to match the request. A match occurs when at least one rule matches the request.<br><p> <br><p> If not set, the match will never occur. This is equivalent to setting a default of deny for the target workloads if the action is ALLOW.
+     */
     @JsonProperty("rules")
     public void setRules(List<Rule> rules) {
         this.rules = rules;
     }
 
+    /**
+     * AuthorizationPolicy enables access control on workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("selector")
     public WorkloadSelector getSelector() {
         return selector;
     }
 
+    /**
+     * AuthorizationPolicy enables access control on workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("selector")
     public void setSelector(WorkloadSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * AuthorizationPolicy enables access control on workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("targetRef")
     public PolicyTargetReference getTargetRef() {
         return targetRef;
     }
 
+    /**
+     * AuthorizationPolicy enables access control on workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("targetRef")
     public void setTargetRef(PolicyTargetReference targetRef) {
         this.targetRef = targetRef;
     }
 
+    /**
+     * Optional. The targetRefs specifies a list of resources the policy should be applied to. The targeted resources specified will determine which workloads the policy applies to.<br><p> <br><p> Currently, the following resource attachment types are supported: &#42; `kind: Gateway` with `group: gateway.networking.k8s.io` in the same namespace. &#42; `kind: Service` with `group: ""` or `group: "core"` in the same namespace. This type is only supported for waypoints.<br><p> <br><p> If not set, the policy is applied as defined by the selector. At most one of the selector and targetRefs can be set.<br><p> <br><p> NOTE: If you are using the `targetRefs` field in a multi-revision environment with Istio versions prior to 1.22, it is highly recommended that you pin the policy to a revision running 1.22+ via the `istio.io/rev` label. This is to prevent proxies connected to older control planes (that don't know about the `targetRefs` field) from misinterpreting the policy as namespace-wide during the upgrade process.<br><p> <br><p> NOTE: Waypoint proxies are required to use this field for policies to apply; `selector` policies will be ignored.
+     */
     @JsonProperty("targetRefs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PolicyTargetReference> getTargetRefs() {
         return targetRefs;
     }
 
+    /**
+     * Optional. The targetRefs specifies a list of resources the policy should be applied to. The targeted resources specified will determine which workloads the policy applies to.<br><p> <br><p> Currently, the following resource attachment types are supported: &#42; `kind: Gateway` with `group: gateway.networking.k8s.io` in the same namespace. &#42; `kind: Service` with `group: ""` or `group: "core"` in the same namespace. This type is only supported for waypoints.<br><p> <br><p> If not set, the policy is applied as defined by the selector. At most one of the selector and targetRefs can be set.<br><p> <br><p> NOTE: If you are using the `targetRefs` field in a multi-revision environment with Istio versions prior to 1.22, it is highly recommended that you pin the policy to a revision running 1.22+ via the `istio.io/rev` label. This is to prevent proxies connected to older control planes (that don't know about the `targetRefs` field) from misinterpreting the policy as namespace-wide during the upgrade process.<br><p> <br><p> NOTE: Waypoint proxies are required to use this field for policies to apply; `selector` policies will be ignored.
+     */
     @JsonProperty("targetRefs")
     public void setTargetRefs(List<PolicyTargetReference> targetRefs) {
         this.targetRefs = targetRefs;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/AuthorizationPolicyAction.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/AuthorizationPolicyAction.java
index a01ad5e87a6..81e4bcd8641 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/AuthorizationPolicyAction.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/AuthorizationPolicyAction.java
@@ -4,6 +4,9 @@
 import javax.annotation.Generated;
 import com.fasterxml.jackson.annotation.JsonCreator;
 
+/**
+ * Action specifies the operation to take.
+ */
 @Generated("io.fabric8.kubernetes.schema.generator.model.ModelGenerator")
 public enum AuthorizationPolicyAction 
 {
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/AuthorizationPolicyExtensionProvider.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/AuthorizationPolicyExtensionProvider.java
index 29a1e1703a9..140e65db07c 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/AuthorizationPolicyExtensionProvider.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/AuthorizationPolicyExtensionProvider.java
@@ -78,11 +78,17 @@ public AuthorizationPolicyExtensionProvider(String name) {
         this.name = name;
     }
 
+    /**
+     * Specifies the name of the extension provider. The list of available providers is defined in the MeshConfig. Note, currently at most 1 extension provider is allowed per workload. Different workloads can use different extension provider.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Specifies the name of the extension provider. The list of available providers is defined in the MeshConfig. Note, currently at most 1 extension provider is allowed per workload. Different workloads can use different extension provider.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/ClaimToHeader.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/ClaimToHeader.java
index cb89352f8dc..2d1f13cabc5 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/ClaimToHeader.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/ClaimToHeader.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * This message specifies the detail for copying claim to header.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ClaimToHeader(String claim, String header) {
         this.header = header;
     }
 
+    /**
+     * The name of the claim to be copied from. Only claim of type string/int/bool is supported. The header will not be there if the claim does not exist or the type of the claim is not supported.
+     */
     @JsonProperty("claim")
     public String getClaim() {
         return claim;
     }
 
+    /**
+     * The name of the claim to be copied from. Only claim of type string/int/bool is supported. The header will not be there if the claim does not exist or the type of the claim is not supported.
+     */
     @JsonProperty("claim")
     public void setClaim(String claim) {
         this.claim = claim;
     }
 
+    /**
+     * The name of the header to be created. The header will be overridden if it already exists in the request.
+     */
     @JsonProperty("header")
     public String getHeader() {
         return header;
     }
 
+    /**
+     * The name of the header to be created. The header will be overridden if it already exists in the request.
+     */
     @JsonProperty("header")
     public void setHeader(String header) {
         this.header = header;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/Condition.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/Condition.java
index d6b5e1ce2eb..a843320b7a5 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/Condition.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/Condition.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Condition specifies additional required attributes.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public Condition(String key, List<String> notValues, List<String> values) {
         this.values = values;
     }
 
+    /**
+     * The name of an Istio attribute. See the [full list of supported attributes](https://istio.io/docs/reference/config/security/conditions/).
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * The name of an Istio attribute. See the [full list of supported attributes](https://istio.io/docs/reference/config/security/conditions/).
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * Optional. A list of negative match of values for the attribute. Note: at least one of `values` or `notValues` must be set.
+     */
     @JsonProperty("notValues")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNotValues() {
         return notValues;
     }
 
+    /**
+     * Optional. A list of negative match of values for the attribute. Note: at least one of `values` or `notValues` must be set.
+     */
     @JsonProperty("notValues")
     public void setNotValues(List<String> notValues) {
         this.notValues = notValues;
     }
 
+    /**
+     * Optional. A list of allowed values for the attribute. Note: at least one of `values` or `notValues` must be set.
+     */
     @JsonProperty("values")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getValues() {
         return values;
     }
 
+    /**
+     * Optional. A list of allowed values for the attribute. Note: at least one of `values` or `notValues` must be set.
+     */
     @JsonProperty("values")
     public void setValues(List<String> values) {
         this.values = values;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/JWTHeader.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/JWTHeader.java
index 80da05ad6d4..b8120ffa575 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/JWTHeader.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/JWTHeader.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * This message specifies a header location to extract JWT token.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public JWTHeader(String name, String prefix) {
         this.prefix = prefix;
     }
 
+    /**
+     * The HTTP header name.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The HTTP header name.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * The prefix that should be stripped before decoding the token. For example, for `Authorization: Bearer &lt;token&gt;`, prefix=`Bearer` with a space at the end. If the header doesn't have this exact prefix, it is considered invalid.
+     */
     @JsonProperty("prefix")
     public String getPrefix() {
         return prefix;
     }
 
+    /**
+     * The prefix that should be stripped before decoding the token. For example, for `Authorization: Bearer &lt;token&gt;`, prefix=`Bearer` with a space at the end. If the header doesn't have this exact prefix, it is considered invalid.
+     */
     @JsonProperty("prefix")
     public void setPrefix(String prefix) {
         this.prefix = prefix;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/JWTRule.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/JWTRule.java
index 5bf983c0aec..1c3cff33835 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/JWTRule.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/JWTRule.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JSON Web Token (JWT) token format for authentication as defined by [RFC 7519](https://tools.ietf.org/html/rfc7519). See [OAuth 2.0](https://tools.ietf.org/html/rfc6749) and [OIDC 1.0](http://openid.net/connect) for how this is used in the whole authentication flow.<br><p> <br><p> Examples:<br><p> <br><p> Spec for a JWT that is issued by `https://example.com`, with the audience claims must be either `bookstore_android.apps.example.com` or `bookstore_web.apps.example.com`. The token should be presented at the `Authorization` header (default). The JSON Web Key Set (JWKS) will be discovered following OpenID Connect protocol.<br><p> <br><p> ```yaml issuer: https://example.com audiences:<br><p>   - bookstore_android.apps.example.com<br><p>     bookstore_web.apps.example.com<br><p> <br><p> ```<br><p> <br><p> This example specifies a token in a non-default location (`x-goog-iap-jwt-assertion` header). It also defines the URI to fetch JWKS explicitly.<br><p> <br><p> ```yaml issuer: https://example.com jwksUri: https://example.com/.secret/jwks.json fromHeaders: - "x-goog-iap-jwt-assertion" ```
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -125,116 +128,182 @@ public JWTRule(List<String> audiences, Boolean forwardOriginalToken, List<String
         this.timeout = timeout;
     }
 
+    /**
+     * The list of JWT [audiences](https://tools.ietf.org/html/rfc7519#section-4.1.3) that are allowed to access. A JWT containing any of these audiences will be accepted.<br><p> <br><p> The service name will be accepted if audiences is empty.<br><p> <br><p> Example:<br><p> <br><p> ```yaml audiences:<br><p>   - bookstore_android.apps.example.com<br><p>     bookstore_web.apps.example.com<br><p> <br><p> ```
+     */
     @JsonProperty("audiences")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAudiences() {
         return audiences;
     }
 
+    /**
+     * The list of JWT [audiences](https://tools.ietf.org/html/rfc7519#section-4.1.3) that are allowed to access. A JWT containing any of these audiences will be accepted.<br><p> <br><p> The service name will be accepted if audiences is empty.<br><p> <br><p> Example:<br><p> <br><p> ```yaml audiences:<br><p>   - bookstore_android.apps.example.com<br><p>     bookstore_web.apps.example.com<br><p> <br><p> ```
+     */
     @JsonProperty("audiences")
     public void setAudiences(List<String> audiences) {
         this.audiences = audiences;
     }
 
+    /**
+     * If set to true, the original token will be kept for the upstream request. Default is false.
+     */
     @JsonProperty("forwardOriginalToken")
     public Boolean getForwardOriginalToken() {
         return forwardOriginalToken;
     }
 
+    /**
+     * If set to true, the original token will be kept for the upstream request. Default is false.
+     */
     @JsonProperty("forwardOriginalToken")
     public void setForwardOriginalToken(Boolean forwardOriginalToken) {
         this.forwardOriginalToken = forwardOriginalToken;
     }
 
+    /**
+     * List of cookie names from which JWT is expected.	// For example, if config is:<br><p> <br><p> ``` yaml<br><p> <br><p> 	from_cookies:<br><p> 	- auth-token<br><p> <br><p> ``` Then JWT will be extracted from "auth-token" cookie in the request.<br><p> <br><p> Note: Requests with multiple tokens (at different locations) are not supported, the output principal of such requests is undefined.
+     */
     @JsonProperty("fromCookies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getFromCookies() {
         return fromCookies;
     }
 
+    /**
+     * List of cookie names from which JWT is expected.	// For example, if config is:<br><p> <br><p> ``` yaml<br><p> <br><p> 	from_cookies:<br><p> 	- auth-token<br><p> <br><p> ``` Then JWT will be extracted from "auth-token" cookie in the request.<br><p> <br><p> Note: Requests with multiple tokens (at different locations) are not supported, the output principal of such requests is undefined.
+     */
     @JsonProperty("fromCookies")
     public void setFromCookies(List<String> fromCookies) {
         this.fromCookies = fromCookies;
     }
 
+    /**
+     * List of header locations from which JWT is expected. For example, below is the location spec if JWT is expected to be found in `x-jwt-assertion` header, and have `Bearer` prefix:<br><p> <br><p> ```yaml<br><p> <br><p> 	fromHeaders:<br><p> 	- name: x-jwt-assertion<br><p> 	  prefix: "Bearer "<br><p> <br><p> ```<br><p> <br><p> Note: Requests with multiple tokens (at different locations) are not supported, the output principal of such requests is undefined.
+     */
     @JsonProperty("fromHeaders")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<JWTHeader> getFromHeaders() {
         return fromHeaders;
     }
 
+    /**
+     * List of header locations from which JWT is expected. For example, below is the location spec if JWT is expected to be found in `x-jwt-assertion` header, and have `Bearer` prefix:<br><p> <br><p> ```yaml<br><p> <br><p> 	fromHeaders:<br><p> 	- name: x-jwt-assertion<br><p> 	  prefix: "Bearer "<br><p> <br><p> ```<br><p> <br><p> Note: Requests with multiple tokens (at different locations) are not supported, the output principal of such requests is undefined.
+     */
     @JsonProperty("fromHeaders")
     public void setFromHeaders(List<JWTHeader> fromHeaders) {
         this.fromHeaders = fromHeaders;
     }
 
+    /**
+     * List of query parameters from which JWT is expected. For example, if JWT is provided via query parameter `my_token` (e.g `/path?my_token=&lt;JWT&gt;`), the config is:<br><p> <br><p> ```yaml<br><p> <br><p> 	fromParams:<br><p> 	- "my_token"<br><p> <br><p> ```<br><p> <br><p> Note: Requests with multiple tokens (at different locations) are not supported, the output principal of such requests is undefined.
+     */
     @JsonProperty("fromParams")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getFromParams() {
         return fromParams;
     }
 
+    /**
+     * List of query parameters from which JWT is expected. For example, if JWT is provided via query parameter `my_token` (e.g `/path?my_token=&lt;JWT&gt;`), the config is:<br><p> <br><p> ```yaml<br><p> <br><p> 	fromParams:<br><p> 	- "my_token"<br><p> <br><p> ```<br><p> <br><p> Note: Requests with multiple tokens (at different locations) are not supported, the output principal of such requests is undefined.
+     */
     @JsonProperty("fromParams")
     public void setFromParams(List<String> fromParams) {
         this.fromParams = fromParams;
     }
 
+    /**
+     * Identifies the issuer that issued the JWT. See [issuer](https://tools.ietf.org/html/rfc7519#section-4.1.1) A JWT with different `iss` claim will be rejected.<br><p> <br><p> Example: `https://foobar.auth0.com` Example: `1234567-compute@developer.gserviceaccount.com`
+     */
     @JsonProperty("issuer")
     public String getIssuer() {
         return issuer;
     }
 
+    /**
+     * Identifies the issuer that issued the JWT. See [issuer](https://tools.ietf.org/html/rfc7519#section-4.1.1) A JWT with different `iss` claim will be rejected.<br><p> <br><p> Example: `https://foobar.auth0.com` Example: `1234567-compute@developer.gserviceaccount.com`
+     */
     @JsonProperty("issuer")
     public void setIssuer(String issuer) {
         this.issuer = issuer;
     }
 
+    /**
+     * JSON Web Key Set of public keys to validate signature of the JWT. See https://auth0.com/docs/jwks.<br><p> <br><p> Note: Only one of `jwksUri` and `jwks` should be used.
+     */
     @JsonProperty("jwks")
     public String getJwks() {
         return jwks;
     }
 
+    /**
+     * JSON Web Key Set of public keys to validate signature of the JWT. See https://auth0.com/docs/jwks.<br><p> <br><p> Note: Only one of `jwksUri` and `jwks` should be used.
+     */
     @JsonProperty("jwks")
     public void setJwks(String jwks) {
         this.jwks = jwks;
     }
 
+    /**
+     * URL of the provider's public key set to validate signature of the JWT. See [OpenID Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata).<br><p> <br><p> Optional if the key set document can either (a) be retrieved from [OpenID Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html) of the issuer or (b) inferred from the email domain of the issuer (e.g. a Google service account).<br><p> <br><p> Example: `https://www.googleapis.com/oauth2/v1/certs`<br><p> <br><p> Note: Only one of `jwksUri` and `jwks` should be used.
+     */
     @JsonProperty("jwksUri")
     public String getJwksUri() {
         return jwksUri;
     }
 
+    /**
+     * URL of the provider's public key set to validate signature of the JWT. See [OpenID Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata).<br><p> <br><p> Optional if the key set document can either (a) be retrieved from [OpenID Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html) of the issuer or (b) inferred from the email domain of the issuer (e.g. a Google service account).<br><p> <br><p> Example: `https://www.googleapis.com/oauth2/v1/certs`<br><p> <br><p> Note: Only one of `jwksUri` and `jwks` should be used.
+     */
     @JsonProperty("jwksUri")
     public void setJwksUri(String jwksUri) {
         this.jwksUri = jwksUri;
     }
 
+    /**
+     * This field specifies a list of operations to copy the claim to HTTP headers on a successfully verified token. This differs from the `output_payload_to_header` by allowing outputting individual claims instead of the whole payload. The header specified in each operation in the list must be unique. Nested claims of type string/int/bool is supported as well. ```<br><p> <br><p> 	outputClaimToHeaders:<br><p> 	- header: x-my-company-jwt-group<br><p> 	  claim: my-group<br><p> 	- header: x-test-environment-flag<br><p> 	  claim: test-flag<br><p> 	- header: x-jwt-claim-group<br><p> 	  claim: nested.key.group<br><p> <br><p> ``` [Experimental] This feature is a experimental feature.
+     */
     @JsonProperty("outputClaimToHeaders")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ClaimToHeader> getOutputClaimToHeaders() {
         return outputClaimToHeaders;
     }
 
+    /**
+     * This field specifies a list of operations to copy the claim to HTTP headers on a successfully verified token. This differs from the `output_payload_to_header` by allowing outputting individual claims instead of the whole payload. The header specified in each operation in the list must be unique. Nested claims of type string/int/bool is supported as well. ```<br><p> <br><p> 	outputClaimToHeaders:<br><p> 	- header: x-my-company-jwt-group<br><p> 	  claim: my-group<br><p> 	- header: x-test-environment-flag<br><p> 	  claim: test-flag<br><p> 	- header: x-jwt-claim-group<br><p> 	  claim: nested.key.group<br><p> <br><p> ``` [Experimental] This feature is a experimental feature.
+     */
     @JsonProperty("outputClaimToHeaders")
     public void setOutputClaimToHeaders(List<ClaimToHeader> outputClaimToHeaders) {
         this.outputClaimToHeaders = outputClaimToHeaders;
     }
 
+    /**
+     * This field specifies the header name to output a successfully verified JWT payload to the backend. The forwarded data is `base64_encoded(jwt_payload_in_JSON)`. If it is not specified, the payload will not be emitted.
+     */
     @JsonProperty("outputPayloadToHeader")
     public String getOutputPayloadToHeader() {
         return outputPayloadToHeader;
     }
 
+    /**
+     * This field specifies the header name to output a successfully verified JWT payload to the backend. The forwarded data is `base64_encoded(jwt_payload_in_JSON)`. If it is not specified, the payload will not be emitted.
+     */
     @JsonProperty("outputPayloadToHeader")
     public void setOutputPayloadToHeader(String outputPayloadToHeader) {
         this.outputPayloadToHeader = outputPayloadToHeader;
     }
 
+    /**
+     * JSON Web Token (JWT) token format for authentication as defined by [RFC 7519](https://tools.ietf.org/html/rfc7519). See [OAuth 2.0](https://tools.ietf.org/html/rfc6749) and [OIDC 1.0](http://openid.net/connect) for how this is used in the whole authentication flow.<br><p> <br><p> Examples:<br><p> <br><p> Spec for a JWT that is issued by `https://example.com`, with the audience claims must be either `bookstore_android.apps.example.com` or `bookstore_web.apps.example.com`. The token should be presented at the `Authorization` header (default). The JSON Web Key Set (JWKS) will be discovered following OpenID Connect protocol.<br><p> <br><p> ```yaml issuer: https://example.com audiences:<br><p>   - bookstore_android.apps.example.com<br><p>     bookstore_web.apps.example.com<br><p> <br><p> ```<br><p> <br><p> This example specifies a token in a non-default location (`x-goog-iap-jwt-assertion` header). It also defines the URI to fetch JWKS explicitly.<br><p> <br><p> ```yaml issuer: https://example.com jwksUri: https://example.com/.secret/jwks.json fromHeaders: - "x-goog-iap-jwt-assertion" ```
+     */
     @JsonProperty("timeout")
     public String getTimeout() {
         return timeout;
     }
 
+    /**
+     * JSON Web Token (JWT) token format for authentication as defined by [RFC 7519](https://tools.ietf.org/html/rfc7519). See [OAuth 2.0](https://tools.ietf.org/html/rfc6749) and [OIDC 1.0](http://openid.net/connect) for how this is used in the whole authentication flow.<br><p> <br><p> Examples:<br><p> <br><p> Spec for a JWT that is issued by `https://example.com`, with the audience claims must be either `bookstore_android.apps.example.com` or `bookstore_web.apps.example.com`. The token should be presented at the `Authorization` header (default). The JSON Web Key Set (JWKS) will be discovered following OpenID Connect protocol.<br><p> <br><p> ```yaml issuer: https://example.com audiences:<br><p>   - bookstore_android.apps.example.com<br><p>     bookstore_web.apps.example.com<br><p> <br><p> ```<br><p> <br><p> This example specifies a token in a non-default location (`x-goog-iap-jwt-assertion` header). It also defines the URI to fetch JWKS explicitly.<br><p> <br><p> ```yaml issuer: https://example.com jwksUri: https://example.com/.secret/jwks.json fromHeaders: - "x-goog-iap-jwt-assertion" ```
+     */
     @JsonProperty("timeout")
     public void setTimeout(String timeout) {
         this.timeout = timeout;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/Operation.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/Operation.java
index d5b094221f9..84b7279c930 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/Operation.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/Operation.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Operation specifies the operations of a request. Fields in the operation are ANDed together.<br><p> <br><p> For example, the following operation matches if the host has suffix `.example.com` and the method is `GET` or `HEAD` and the path doesn't have prefix `/admin`.<br><p> <br><p> ```yaml hosts: ["&#42;.example.com"] methods: ["GET", "HEAD"] notPaths: ["/admin&#42;"] ```
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -116,89 +119,137 @@ public Operation(List<String> hosts, List<String> methods, List<String> notHosts
         this.ports = ports;
     }
 
+    /**
+     * Optional. A list of hosts as specified in the HTTP request. The match is case-insensitive. See the [security best practices](https://istio.io/latest/docs/ops/best-practices/security/#writing-host-match-policies) for recommended usage of this field.<br><p> <br><p> If not set, any host is allowed. Must be used only with HTTP.
+     */
     @JsonProperty("hosts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getHosts() {
         return hosts;
     }
 
+    /**
+     * Optional. A list of hosts as specified in the HTTP request. The match is case-insensitive. See the [security best practices](https://istio.io/latest/docs/ops/best-practices/security/#writing-host-match-policies) for recommended usage of this field.<br><p> <br><p> If not set, any host is allowed. Must be used only with HTTP.
+     */
     @JsonProperty("hosts")
     public void setHosts(List<String> hosts) {
         this.hosts = hosts;
     }
 
+    /**
+     * Optional. A list of methods as specified in the HTTP request. For gRPC service, this will always be `POST`.<br><p> <br><p> If not set, any method is allowed. Must be used only with HTTP.
+     */
     @JsonProperty("methods")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMethods() {
         return methods;
     }
 
+    /**
+     * Optional. A list of methods as specified in the HTTP request. For gRPC service, this will always be `POST`.<br><p> <br><p> If not set, any method is allowed. Must be used only with HTTP.
+     */
     @JsonProperty("methods")
     public void setMethods(List<String> methods) {
         this.methods = methods;
     }
 
+    /**
+     * Optional. A list of negative match of hosts as specified in the HTTP request. The match is case-insensitive.
+     */
     @JsonProperty("notHosts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNotHosts() {
         return notHosts;
     }
 
+    /**
+     * Optional. A list of negative match of hosts as specified in the HTTP request. The match is case-insensitive.
+     */
     @JsonProperty("notHosts")
     public void setNotHosts(List<String> notHosts) {
         this.notHosts = notHosts;
     }
 
+    /**
+     * Optional. A list of negative match of methods as specified in the HTTP request.
+     */
     @JsonProperty("notMethods")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNotMethods() {
         return notMethods;
     }
 
+    /**
+     * Optional. A list of negative match of methods as specified in the HTTP request.
+     */
     @JsonProperty("notMethods")
     public void setNotMethods(List<String> notMethods) {
         this.notMethods = notMethods;
     }
 
+    /**
+     * Optional. A list of negative match of paths.
+     */
     @JsonProperty("notPaths")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNotPaths() {
         return notPaths;
     }
 
+    /**
+     * Optional. A list of negative match of paths.
+     */
     @JsonProperty("notPaths")
     public void setNotPaths(List<String> notPaths) {
         this.notPaths = notPaths;
     }
 
+    /**
+     * Optional. A list of negative match of ports as specified in the connection.
+     */
     @JsonProperty("notPorts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNotPorts() {
         return notPorts;
     }
 
+    /**
+     * Optional. A list of negative match of ports as specified in the connection.
+     */
     @JsonProperty("notPorts")
     public void setNotPorts(List<String> notPorts) {
         this.notPorts = notPorts;
     }
 
+    /**
+     * Optional. A list of paths as specified in the HTTP request. See the [Authorization Policy Normalization](https://istio.io/latest/docs/reference/config/security/normalization/) for details of the path normalization. For gRPC service, this will be the fully-qualified name in the form of `/package.service/method`.<br><p> <br><p> If a path in the list contains the `{&#42;}` or `{&#42;&#42;}` path template operator, it will be interpreted as an [Envoy Uri Template](https://www.envoyproxy.io/docs/envoy/latest/api-v3/extensions/path/match/uri_template/v3/uri_template_match.proto). To be a valid path template, the path must not contain `&#42;`, `{`, or `}` outside of a supported operator. No other characters are allowed in the path segment with the path template operator. - `{&#42;}` matches a single glob that cannot extend beyond a path segment. - `{&#42;&#42;}` matches zero or more globs. If a path contains `{&#42;&#42;}`, it must be the last operator.<br><p> <br><p> Examples: - `/foo/{&#42;}` matches `/foo/bar` but not `/foo/bar/baz` - `/foo/{&#42;&#42;}/` matches `/foo/bar/`, `/foo/bar/baz.txt`, and `/foo//` but not `/foo/bar` - `/foo/{&#42;}/bar/{&#42;&#42;}` matches `/foo/buzz/bar/` and `/foo/buzz/bar/baz` - `/&#42;/baz/{&#42;}` is not a valid path template since it includes `&#42;` outside of a supported operator - `/&#42;&#42;/baz/{&#42;}` is not a valid path template since it includes `&#42;&#42;` outside of a supported operator - `/{&#42;&#42;}/foo/{&#42;}` is not a valid path template since `{&#42;&#42;}` is not the last operator - `/foo/{&#42;}.txt` is invalid since there are characters other than `{&#42;}` in the path segment<br><p> <br><p> If not set, any path is allowed. Must be used only with HTTP.
+     */
     @JsonProperty("paths")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPaths() {
         return paths;
     }
 
+    /**
+     * Optional. A list of paths as specified in the HTTP request. See the [Authorization Policy Normalization](https://istio.io/latest/docs/reference/config/security/normalization/) for details of the path normalization. For gRPC service, this will be the fully-qualified name in the form of `/package.service/method`.<br><p> <br><p> If a path in the list contains the `{&#42;}` or `{&#42;&#42;}` path template operator, it will be interpreted as an [Envoy Uri Template](https://www.envoyproxy.io/docs/envoy/latest/api-v3/extensions/path/match/uri_template/v3/uri_template_match.proto). To be a valid path template, the path must not contain `&#42;`, `{`, or `}` outside of a supported operator. No other characters are allowed in the path segment with the path template operator. - `{&#42;}` matches a single glob that cannot extend beyond a path segment. - `{&#42;&#42;}` matches zero or more globs. If a path contains `{&#42;&#42;}`, it must be the last operator.<br><p> <br><p> Examples: - `/foo/{&#42;}` matches `/foo/bar` but not `/foo/bar/baz` - `/foo/{&#42;&#42;}/` matches `/foo/bar/`, `/foo/bar/baz.txt`, and `/foo//` but not `/foo/bar` - `/foo/{&#42;}/bar/{&#42;&#42;}` matches `/foo/buzz/bar/` and `/foo/buzz/bar/baz` - `/&#42;/baz/{&#42;}` is not a valid path template since it includes `&#42;` outside of a supported operator - `/&#42;&#42;/baz/{&#42;}` is not a valid path template since it includes `&#42;&#42;` outside of a supported operator - `/{&#42;&#42;}/foo/{&#42;}` is not a valid path template since `{&#42;&#42;}` is not the last operator - `/foo/{&#42;}.txt` is invalid since there are characters other than `{&#42;}` in the path segment<br><p> <br><p> If not set, any path is allowed. Must be used only with HTTP.
+     */
     @JsonProperty("paths")
     public void setPaths(List<String> paths) {
         this.paths = paths;
     }
 
+    /**
+     * Optional. A list of ports as specified in the connection.<br><p> <br><p> If not set, any port is allowed.
+     */
     @JsonProperty("ports")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPorts() {
         return ports;
     }
 
+    /**
+     * Optional. A list of ports as specified in the connection.<br><p> <br><p> If not set, any port is allowed.
+     */
     @JsonProperty("ports")
     public void setPorts(List<String> ports) {
         this.ports = ports;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/PeerAuthentication.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/PeerAuthentication.java
index 235272165e1..29c2cbf8980 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/PeerAuthentication.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/PeerAuthentication.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PeerAuthentication defines mutual TLS (mTLS) requirements for incoming connections.<br><p> <br><p> In sidecar mode, PeerAuthentication determines whether or not mTLS is allowed or required for connections to an Envoy proxy sidecar.<br><p> <br><p> In ambient mode, security is transparently enabled for a pod by the ztunnel node agent. (Traffic between proxies uses the HBONE protocol, which includes encryption with mTLS.) Because of this, `DISABLE` mode is not supported. `STRICT` mode is useful to ensure that connections that bypass the mesh are not possible.<br><p> <br><p> Examples:<br><p> <br><p> Policy to require mTLS traffic for all workloads under namespace `foo`: ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: STRICT<br><p> <br><p> ``` For mesh level, put the policy in root-namespace according to your Istio installation.<br><p> <br><p> Policies to allow both mTLS and plaintext traffic for all workloads under namespace `foo`, but require mTLS for workload `finance`. ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: PERMISSIVE
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,32 +101,50 @@ public PeerAuthentication(PeerAuthenticationMutualTLS mtls, Map<String, PeerAuth
         this.selector = selector;
     }
 
+    /**
+     * PeerAuthentication defines mutual TLS (mTLS) requirements for incoming connections.<br><p> <br><p> In sidecar mode, PeerAuthentication determines whether or not mTLS is allowed or required for connections to an Envoy proxy sidecar.<br><p> <br><p> In ambient mode, security is transparently enabled for a pod by the ztunnel node agent. (Traffic between proxies uses the HBONE protocol, which includes encryption with mTLS.) Because of this, `DISABLE` mode is not supported. `STRICT` mode is useful to ensure that connections that bypass the mesh are not possible.<br><p> <br><p> Examples:<br><p> <br><p> Policy to require mTLS traffic for all workloads under namespace `foo`: ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: STRICT<br><p> <br><p> ``` For mesh level, put the policy in root-namespace according to your Istio installation.<br><p> <br><p> Policies to allow both mTLS and plaintext traffic for all workloads under namespace `foo`, but require mTLS for workload `finance`. ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: PERMISSIVE
+     */
     @JsonProperty("mtls")
     public PeerAuthenticationMutualTLS getMtls() {
         return mtls;
     }
 
+    /**
+     * PeerAuthentication defines mutual TLS (mTLS) requirements for incoming connections.<br><p> <br><p> In sidecar mode, PeerAuthentication determines whether or not mTLS is allowed or required for connections to an Envoy proxy sidecar.<br><p> <br><p> In ambient mode, security is transparently enabled for a pod by the ztunnel node agent. (Traffic between proxies uses the HBONE protocol, which includes encryption with mTLS.) Because of this, `DISABLE` mode is not supported. `STRICT` mode is useful to ensure that connections that bypass the mesh are not possible.<br><p> <br><p> Examples:<br><p> <br><p> Policy to require mTLS traffic for all workloads under namespace `foo`: ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: STRICT<br><p> <br><p> ``` For mesh level, put the policy in root-namespace according to your Istio installation.<br><p> <br><p> Policies to allow both mTLS and plaintext traffic for all workloads under namespace `foo`, but require mTLS for workload `finance`. ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: PERMISSIVE
+     */
     @JsonProperty("mtls")
     public void setMtls(PeerAuthenticationMutualTLS mtls) {
         this.mtls = mtls;
     }
 
+    /**
+     * Port specific mutual TLS settings. These only apply when a workload selector is specified. The port refers to the port of the workload, not the port of the Kubernetes service.
+     */
     @JsonProperty("portLevelMtls")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, PeerAuthenticationMutualTLS> getPortLevelMtls() {
         return portLevelMtls;
     }
 
+    /**
+     * Port specific mutual TLS settings. These only apply when a workload selector is specified. The port refers to the port of the workload, not the port of the Kubernetes service.
+     */
     @JsonProperty("portLevelMtls")
     public void setPortLevelMtls(Map<String, PeerAuthenticationMutualTLS> portLevelMtls) {
         this.portLevelMtls = portLevelMtls;
     }
 
+    /**
+     * PeerAuthentication defines mutual TLS (mTLS) requirements for incoming connections.<br><p> <br><p> In sidecar mode, PeerAuthentication determines whether or not mTLS is allowed or required for connections to an Envoy proxy sidecar.<br><p> <br><p> In ambient mode, security is transparently enabled for a pod by the ztunnel node agent. (Traffic between proxies uses the HBONE protocol, which includes encryption with mTLS.) Because of this, `DISABLE` mode is not supported. `STRICT` mode is useful to ensure that connections that bypass the mesh are not possible.<br><p> <br><p> Examples:<br><p> <br><p> Policy to require mTLS traffic for all workloads under namespace `foo`: ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: STRICT<br><p> <br><p> ``` For mesh level, put the policy in root-namespace according to your Istio installation.<br><p> <br><p> Policies to allow both mTLS and plaintext traffic for all workloads under namespace `foo`, but require mTLS for workload `finance`. ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: PERMISSIVE
+     */
     @JsonProperty("selector")
     public WorkloadSelector getSelector() {
         return selector;
     }
 
+    /**
+     * PeerAuthentication defines mutual TLS (mTLS) requirements for incoming connections.<br><p> <br><p> In sidecar mode, PeerAuthentication determines whether or not mTLS is allowed or required for connections to an Envoy proxy sidecar.<br><p> <br><p> In ambient mode, security is transparently enabled for a pod by the ztunnel node agent. (Traffic between proxies uses the HBONE protocol, which includes encryption with mTLS.) Because of this, `DISABLE` mode is not supported. `STRICT` mode is useful to ensure that connections that bypass the mesh are not possible.<br><p> <br><p> Examples:<br><p> <br><p> Policy to require mTLS traffic for all workloads under namespace `foo`: ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: STRICT<br><p> <br><p> ``` For mesh level, put the policy in root-namespace according to your Istio installation.<br><p> <br><p> Policies to allow both mTLS and plaintext traffic for all workloads under namespace `foo`, but require mTLS for workload `finance`. ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: PERMISSIVE
+     */
     @JsonProperty("selector")
     public void setSelector(WorkloadSelector selector) {
         this.selector = selector;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/PeerAuthenticationMutualTLS.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/PeerAuthenticationMutualTLS.java
index 2d177543336..c8ec830974a 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/PeerAuthenticationMutualTLS.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/PeerAuthenticationMutualTLS.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Mutual TLS settings.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public PeerAuthenticationMutualTLS(PeerAuthenticationMutualTLSMode mode) {
         this.mode = mode;
     }
 
+    /**
+     * Mutual TLS settings.
+     */
     @JsonProperty("mode")
     public PeerAuthenticationMutualTLSMode getMode() {
         return mode;
     }
 
+    /**
+     * Mutual TLS settings.
+     */
     @JsonProperty("mode")
     public void setMode(PeerAuthenticationMutualTLSMode mode) {
         this.mode = mode;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/RequestAuthentication.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/RequestAuthentication.java
index e46abd54ae9..2352216ac6b 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/RequestAuthentication.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/RequestAuthentication.java
@@ -41,6 +41,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RequestAuthentication defines what request authentication methods are supported by a workload. It will reject a request if the request contains invalid authentication information, based on the configured authentication rules. A request that does not contain any authentication credentials will be accepted but will not have any authenticated identity. To restrict access to authenticated requests only, this should be accompanied by an authorization rule. Examples:<br><p> <br><p> - Require JWT for all request for workloads that have label `app:httpbin`<br><p> <br><p> ```yaml apiVersion: security.istio.io/v1 kind: RequestAuthentication metadata:<br><p> <br><p> 	name: httpbin<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  matchLabels:<br><p> 	    app: httpbin<br><p> 	jwtRules:<br><p> 	- issuer: "issuer-foo"<br><p> 	  jwksUri: https://example.com/.well-known/jwks.json
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -106,43 +109,67 @@ public RequestAuthentication(List<JWTRule> jwtRules, WorkloadSelector selector,
         this.targetRefs = targetRefs;
     }
 
+    /**
+     * Define the list of JWTs that can be validated at the selected workloads' proxy. A valid token will be used to extract the authenticated identity. Each rule will be activated only when a token is presented at the location recognized by the rule. The token will be validated based on the JWT rule config. If validation fails, the request will be rejected. Note: Requests with multiple tokens (at different locations) are not supported, the output principal of such requests is undefined.
+     */
     @JsonProperty("jwtRules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<JWTRule> getJwtRules() {
         return jwtRules;
     }
 
+    /**
+     * Define the list of JWTs that can be validated at the selected workloads' proxy. A valid token will be used to extract the authenticated identity. Each rule will be activated only when a token is presented at the location recognized by the rule. The token will be validated based on the JWT rule config. If validation fails, the request will be rejected. Note: Requests with multiple tokens (at different locations) are not supported, the output principal of such requests is undefined.
+     */
     @JsonProperty("jwtRules")
     public void setJwtRules(List<JWTRule> jwtRules) {
         this.jwtRules = jwtRules;
     }
 
+    /**
+     * RequestAuthentication defines what request authentication methods are supported by a workload. It will reject a request if the request contains invalid authentication information, based on the configured authentication rules. A request that does not contain any authentication credentials will be accepted but will not have any authenticated identity. To restrict access to authenticated requests only, this should be accompanied by an authorization rule. Examples:<br><p> <br><p> - Require JWT for all request for workloads that have label `app:httpbin`<br><p> <br><p> ```yaml apiVersion: security.istio.io/v1 kind: RequestAuthentication metadata:<br><p> <br><p> 	name: httpbin<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  matchLabels:<br><p> 	    app: httpbin<br><p> 	jwtRules:<br><p> 	- issuer: "issuer-foo"<br><p> 	  jwksUri: https://example.com/.well-known/jwks.json
+     */
     @JsonProperty("selector")
     public WorkloadSelector getSelector() {
         return selector;
     }
 
+    /**
+     * RequestAuthentication defines what request authentication methods are supported by a workload. It will reject a request if the request contains invalid authentication information, based on the configured authentication rules. A request that does not contain any authentication credentials will be accepted but will not have any authenticated identity. To restrict access to authenticated requests only, this should be accompanied by an authorization rule. Examples:<br><p> <br><p> - Require JWT for all request for workloads that have label `app:httpbin`<br><p> <br><p> ```yaml apiVersion: security.istio.io/v1 kind: RequestAuthentication metadata:<br><p> <br><p> 	name: httpbin<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  matchLabels:<br><p> 	    app: httpbin<br><p> 	jwtRules:<br><p> 	- issuer: "issuer-foo"<br><p> 	  jwksUri: https://example.com/.well-known/jwks.json
+     */
     @JsonProperty("selector")
     public void setSelector(WorkloadSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * RequestAuthentication defines what request authentication methods are supported by a workload. It will reject a request if the request contains invalid authentication information, based on the configured authentication rules. A request that does not contain any authentication credentials will be accepted but will not have any authenticated identity. To restrict access to authenticated requests only, this should be accompanied by an authorization rule. Examples:<br><p> <br><p> - Require JWT for all request for workloads that have label `app:httpbin`<br><p> <br><p> ```yaml apiVersion: security.istio.io/v1 kind: RequestAuthentication metadata:<br><p> <br><p> 	name: httpbin<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  matchLabels:<br><p> 	    app: httpbin<br><p> 	jwtRules:<br><p> 	- issuer: "issuer-foo"<br><p> 	  jwksUri: https://example.com/.well-known/jwks.json
+     */
     @JsonProperty("targetRef")
     public PolicyTargetReference getTargetRef() {
         return targetRef;
     }
 
+    /**
+     * RequestAuthentication defines what request authentication methods are supported by a workload. It will reject a request if the request contains invalid authentication information, based on the configured authentication rules. A request that does not contain any authentication credentials will be accepted but will not have any authenticated identity. To restrict access to authenticated requests only, this should be accompanied by an authorization rule. Examples:<br><p> <br><p> - Require JWT for all request for workloads that have label `app:httpbin`<br><p> <br><p> ```yaml apiVersion: security.istio.io/v1 kind: RequestAuthentication metadata:<br><p> <br><p> 	name: httpbin<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  matchLabels:<br><p> 	    app: httpbin<br><p> 	jwtRules:<br><p> 	- issuer: "issuer-foo"<br><p> 	  jwksUri: https://example.com/.well-known/jwks.json
+     */
     @JsonProperty("targetRef")
     public void setTargetRef(PolicyTargetReference targetRef) {
         this.targetRef = targetRef;
     }
 
+    /**
+     * Optional. The targetRefs specifies a list of resources the policy should be applied to. The targeted resources specified will determine which workloads the policy applies to.<br><p> <br><p> Currently, the following resource attachment types are supported: &#42; `kind: Gateway` with `group: gateway.networking.k8s.io` in the same namespace. &#42; `kind: Service` with `group: ""` or `group: "core"` in the same namespace. This type is only supported for waypoints.<br><p> <br><p> If not set, the policy is applied as defined by the selector. At most one of the selector and targetRefs can be set.<br><p> <br><p> NOTE: If you are using the `targetRefs` field in a multi-revision environment with Istio versions prior to 1.22, it is highly recommended that you pin the policy to a revision running 1.22+ via the `istio.io/rev` label. This is to prevent proxies connected to older control planes (that don't know about the `targetRefs` field) from misinterpreting the policy as namespace-wide during the upgrade process.<br><p> <br><p> NOTE: Waypoint proxies are required to use this field for policies to apply; `selector` policies will be ignored.
+     */
     @JsonProperty("targetRefs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PolicyTargetReference> getTargetRefs() {
         return targetRefs;
     }
 
+    /**
+     * Optional. The targetRefs specifies a list of resources the policy should be applied to. The targeted resources specified will determine which workloads the policy applies to.<br><p> <br><p> Currently, the following resource attachment types are supported: &#42; `kind: Gateway` with `group: gateway.networking.k8s.io` in the same namespace. &#42; `kind: Service` with `group: ""` or `group: "core"` in the same namespace. This type is only supported for waypoints.<br><p> <br><p> If not set, the policy is applied as defined by the selector. At most one of the selector and targetRefs can be set.<br><p> <br><p> NOTE: If you are using the `targetRefs` field in a multi-revision environment with Istio versions prior to 1.22, it is highly recommended that you pin the policy to a revision running 1.22+ via the `istio.io/rev` label. This is to prevent proxies connected to older control planes (that don't know about the `targetRefs` field) from misinterpreting the policy as namespace-wide during the upgrade process.<br><p> <br><p> NOTE: Waypoint proxies are required to use this field for policies to apply; `selector` policies will be ignored.
+     */
     @JsonProperty("targetRefs")
     public void setTargetRefs(List<PolicyTargetReference> targetRefs) {
         this.targetRefs = targetRefs;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/Rule.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/Rule.java
index 92af0f17a61..f0902bb6295 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/Rule.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/Rule.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Rule matches requests from a list of sources that perform a list of operations subject to a list of conditions. A match occurs when at least one source, one operation and all conditions matches the request. An empty rule is always matched.<br><p> <br><p> Any string field in the rule supports Exact, Prefix, Suffix and Presence match:<br><p> <br><p> - Exact match: `abc` will match on value `abc`. - Prefix match: `abc&#42;` will match on value `abc` and `abcd`. - Suffix match: `&#42;abc` will match on value `abc` and `xabc`. - Presence match: `&#42;` will match when value is not empty.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,34 +94,52 @@ public Rule(List<RuleFrom> from, List<RuleTo> to, List<Condition> when) {
         this.when = when;
     }
 
+    /**
+     * Optional. `from` specifies the source of a request.<br><p> <br><p> If not set, any source is allowed.
+     */
     @JsonProperty("from")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RuleFrom> getFrom() {
         return from;
     }
 
+    /**
+     * Optional. `from` specifies the source of a request.<br><p> <br><p> If not set, any source is allowed.
+     */
     @JsonProperty("from")
     public void setFrom(List<RuleFrom> from) {
         this.from = from;
     }
 
+    /**
+     * Optional. `to` specifies the operation of a request.<br><p> <br><p> If not set, any operation is allowed.
+     */
     @JsonProperty("to")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RuleTo> getTo() {
         return to;
     }
 
+    /**
+     * Optional. `to` specifies the operation of a request.<br><p> <br><p> If not set, any operation is allowed.
+     */
     @JsonProperty("to")
     public void setTo(List<RuleTo> to) {
         this.to = to;
     }
 
+    /**
+     * Optional. `when` specifies a list of additional conditions of a request.<br><p> <br><p> If not set, any condition is allowed.
+     */
     @JsonProperty("when")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getWhen() {
         return when;
     }
 
+    /**
+     * Optional. `when` specifies a list of additional conditions of a request.<br><p> <br><p> If not set, any condition is allowed.
+     */
     @JsonProperty("when")
     public void setWhen(List<Condition> when) {
         this.when = when;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/RuleFrom.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/RuleFrom.java
index 805489eb89d..fc79cde9052 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/RuleFrom.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/RuleFrom.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * From includes a list of sources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public RuleFrom(Source source) {
         this.source = source;
     }
 
+    /**
+     * From includes a list of sources.
+     */
     @JsonProperty("source")
     public Source getSource() {
         return source;
     }
 
+    /**
+     * From includes a list of sources.
+     */
     @JsonProperty("source")
     public void setSource(Source source) {
         this.source = source;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/RuleTo.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/RuleTo.java
index dc5ad76e9e9..88e02999aaf 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/RuleTo.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/RuleTo.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * To includes a list of operations.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public RuleTo(Operation operation) {
         this.operation = operation;
     }
 
+    /**
+     * To includes a list of operations.
+     */
     @JsonProperty("operation")
     public Operation getOperation() {
         return operation;
     }
 
+    /**
+     * To includes a list of operations.
+     */
     @JsonProperty("operation")
     public void setOperation(Operation operation) {
         this.operation = operation;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/Source.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/Source.java
index 0b69f38cf94..a7ddd5315d7 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/Source.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/security/v1beta1/Source.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Source specifies the source identities of a request. Fields in the source are ANDed together.<br><p> <br><p> For example, the following source matches if the principal is `admin` or `dev` and the namespace is `prod` or `test` and the ip is not `203.0.113.4`.<br><p> <br><p> ```yaml principals: ["admin", "dev"] namespaces: ["prod", "test"] notIpBlocks: ["203.0.113.4"] ```
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -126,111 +129,171 @@ public Source(List<String> ipBlocks, List<String> namespaces, List<String> notIp
         this.requestPrincipals = requestPrincipals;
     }
 
+    /**
+     * Optional. A list of IP blocks, populated from the source address of the IP packet. Single IP (e.g. `203.0.113.4`) and CIDR (e.g. `203.0.113.0/24`) are supported. This is the same as the `source.ip` attribute.<br><p> <br><p> If not set, any IP is allowed.
+     */
     @JsonProperty("ipBlocks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIpBlocks() {
         return ipBlocks;
     }
 
+    /**
+     * Optional. A list of IP blocks, populated from the source address of the IP packet. Single IP (e.g. `203.0.113.4`) and CIDR (e.g. `203.0.113.0/24`) are supported. This is the same as the `source.ip` attribute.<br><p> <br><p> If not set, any IP is allowed.
+     */
     @JsonProperty("ipBlocks")
     public void setIpBlocks(List<String> ipBlocks) {
         this.ipBlocks = ipBlocks;
     }
 
+    /**
+     * Optional. A list of namespaces derived from the peer certificate. This field requires mTLS enabled and is the same as the `source.namespace` attribute.<br><p> <br><p> If not set, any namespace is allowed.
+     */
     @JsonProperty("namespaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNamespaces() {
         return namespaces;
     }
 
+    /**
+     * Optional. A list of namespaces derived from the peer certificate. This field requires mTLS enabled and is the same as the `source.namespace` attribute.<br><p> <br><p> If not set, any namespace is allowed.
+     */
     @JsonProperty("namespaces")
     public void setNamespaces(List<String> namespaces) {
         this.namespaces = namespaces;
     }
 
+    /**
+     * Optional. A list of negative match of IP blocks.
+     */
     @JsonProperty("notIpBlocks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNotIpBlocks() {
         return notIpBlocks;
     }
 
+    /**
+     * Optional. A list of negative match of IP blocks.
+     */
     @JsonProperty("notIpBlocks")
     public void setNotIpBlocks(List<String> notIpBlocks) {
         this.notIpBlocks = notIpBlocks;
     }
 
+    /**
+     * Optional. A list of negative match of namespaces.
+     */
     @JsonProperty("notNamespaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNotNamespaces() {
         return notNamespaces;
     }
 
+    /**
+     * Optional. A list of negative match of namespaces.
+     */
     @JsonProperty("notNamespaces")
     public void setNotNamespaces(List<String> notNamespaces) {
         this.notNamespaces = notNamespaces;
     }
 
+    /**
+     * Optional. A list of negative match of peer identities.
+     */
     @JsonProperty("notPrincipals")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNotPrincipals() {
         return notPrincipals;
     }
 
+    /**
+     * Optional. A list of negative match of peer identities.
+     */
     @JsonProperty("notPrincipals")
     public void setNotPrincipals(List<String> notPrincipals) {
         this.notPrincipals = notPrincipals;
     }
 
+    /**
+     * Optional. A list of negative match of remote IP blocks.
+     */
     @JsonProperty("notRemoteIpBlocks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNotRemoteIpBlocks() {
         return notRemoteIpBlocks;
     }
 
+    /**
+     * Optional. A list of negative match of remote IP blocks.
+     */
     @JsonProperty("notRemoteIpBlocks")
     public void setNotRemoteIpBlocks(List<String> notRemoteIpBlocks) {
         this.notRemoteIpBlocks = notRemoteIpBlocks;
     }
 
+    /**
+     * Optional. A list of negative match of request identities.
+     */
     @JsonProperty("notRequestPrincipals")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNotRequestPrincipals() {
         return notRequestPrincipals;
     }
 
+    /**
+     * Optional. A list of negative match of request identities.
+     */
     @JsonProperty("notRequestPrincipals")
     public void setNotRequestPrincipals(List<String> notRequestPrincipals) {
         this.notRequestPrincipals = notRequestPrincipals;
     }
 
+    /**
+     * Optional. A list of peer identities derived from the peer certificate. The peer identity is in the format of `"&lt;TRUST_DOMAIN&gt;/ns/&lt;NAMESPACE&gt;/sa/&lt;SERVICE_ACCOUNT&gt;"`, for example, `"cluster.local/ns/default/sa/productpage"`. This field requires mTLS enabled and is the same as the `source.principal` attribute.<br><p> <br><p> If not set, any principal is allowed.
+     */
     @JsonProperty("principals")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPrincipals() {
         return principals;
     }
 
+    /**
+     * Optional. A list of peer identities derived from the peer certificate. The peer identity is in the format of `"&lt;TRUST_DOMAIN&gt;/ns/&lt;NAMESPACE&gt;/sa/&lt;SERVICE_ACCOUNT&gt;"`, for example, `"cluster.local/ns/default/sa/productpage"`. This field requires mTLS enabled and is the same as the `source.principal` attribute.<br><p> <br><p> If not set, any principal is allowed.
+     */
     @JsonProperty("principals")
     public void setPrincipals(List<String> principals) {
         this.principals = principals;
     }
 
+    /**
+     * Optional. A list of IP blocks, populated from `X-Forwarded-For` header or proxy protocol. To make use of this field, you must configure the `numTrustedProxies` field of the `gatewayTopology` under the `meshConfig` when you install Istio or using an annotation on the ingress gateway.  See the documentation here: [Configuring Gateway Network Topology](https://istio.io/latest/docs/ops/configuration/traffic-management/network-topologies/). Single IP (e.g. `203.0.113.4`) and CIDR (e.g. `203.0.113.0/24`) are supported. This is the same as the `remote.ip` attribute.<br><p> <br><p> If not set, any IP is allowed.
+     */
     @JsonProperty("remoteIpBlocks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getRemoteIpBlocks() {
         return remoteIpBlocks;
     }
 
+    /**
+     * Optional. A list of IP blocks, populated from `X-Forwarded-For` header or proxy protocol. To make use of this field, you must configure the `numTrustedProxies` field of the `gatewayTopology` under the `meshConfig` when you install Istio or using an annotation on the ingress gateway.  See the documentation here: [Configuring Gateway Network Topology](https://istio.io/latest/docs/ops/configuration/traffic-management/network-topologies/). Single IP (e.g. `203.0.113.4`) and CIDR (e.g. `203.0.113.0/24`) are supported. This is the same as the `remote.ip` attribute.<br><p> <br><p> If not set, any IP is allowed.
+     */
     @JsonProperty("remoteIpBlocks")
     public void setRemoteIpBlocks(List<String> remoteIpBlocks) {
         this.remoteIpBlocks = remoteIpBlocks;
     }
 
+    /**
+     * Optional. A list of request identities derived from the JWT. The request identity is in the format of `"&lt;ISS&gt;/&lt;SUB&gt;"`, for example, `"example.com/sub-1"`. This field requires request authentication enabled and is the same as the `request.auth.principal` attribute.<br><p> <br><p> If not set, any request principal is allowed.
+     */
     @JsonProperty("requestPrincipals")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getRequestPrincipals() {
         return requestPrincipals;
     }
 
+    /**
+     * Optional. A list of request identities derived from the JWT. The request identity is in the format of `"&lt;ISS&gt;/&lt;SUB&gt;"`, for example, `"example.com/sub-1"`. This field requires request authentication enabled and is the same as the `request.auth.principal` attribute.<br><p> <br><p> If not set, any request principal is allowed.
+     */
     @JsonProperty("requestPrincipals")
     public void setRequestPrincipals(List<String> requestPrincipals) {
         this.requestPrincipals = requestPrincipals;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/AccessLogging.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/AccessLogging.java
index da24756929c..ec7e82946e7 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/AccessLogging.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/AccessLogging.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Access logging defines the workload-level overrides for access log generation. It can be used to select provider or enable/disable access log generation for a workload.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public AccessLogging(Boolean disabled, AccessLoggingFilter filter, AccessLogging
         this.providers = providers;
     }
 
+    /**
+     * Access logging defines the workload-level overrides for access log generation. It can be used to select provider or enable/disable access log generation for a workload.
+     */
     @JsonProperty("disabled")
     public Boolean getDisabled() {
         return disabled;
     }
 
+    /**
+     * Access logging defines the workload-level overrides for access log generation. It can be used to select provider or enable/disable access log generation for a workload.
+     */
     @JsonProperty("disabled")
     public void setDisabled(Boolean disabled) {
         this.disabled = disabled;
     }
 
+    /**
+     * Access logging defines the workload-level overrides for access log generation. It can be used to select provider or enable/disable access log generation for a workload.
+     */
     @JsonProperty("filter")
     public AccessLoggingFilter getFilter() {
         return filter;
     }
 
+    /**
+     * Access logging defines the workload-level overrides for access log generation. It can be used to select provider or enable/disable access log generation for a workload.
+     */
     @JsonProperty("filter")
     public void setFilter(AccessLoggingFilter filter) {
         this.filter = filter;
     }
 
+    /**
+     * Access logging defines the workload-level overrides for access log generation. It can be used to select provider or enable/disable access log generation for a workload.
+     */
     @JsonProperty("match")
     public AccessLoggingLogSelector getMatch() {
         return match;
     }
 
+    /**
+     * Access logging defines the workload-level overrides for access log generation. It can be used to select provider or enable/disable access log generation for a workload.
+     */
     @JsonProperty("match")
     public void setMatch(AccessLoggingLogSelector match) {
         this.match = match;
     }
 
+    /**
+     * Optional. Name of providers to which this configuration should apply. If a provider is not specified, the [default logging provider](https://istio.io/docs/reference/config/istio.mesh.v1alpha1/#MeshConfig-DefaultProviders) will be used.
+     */
     @JsonProperty("providers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ProviderRef> getProviders() {
         return providers;
     }
 
+    /**
+     * Optional. Name of providers to which this configuration should apply. If a provider is not specified, the [default logging provider](https://istio.io/docs/reference/config/istio.mesh.v1alpha1/#MeshConfig-DefaultProviders) will be used.
+     */
     @JsonProperty("providers")
     public void setProviders(List<ProviderRef> providers) {
         this.providers = providers;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/AccessLoggingFilter.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/AccessLoggingFilter.java
index 81e03e6b715..a1bcc8eb636 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/AccessLoggingFilter.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/AccessLoggingFilter.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Allows specification of an access log filter.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public AccessLoggingFilter(String expression) {
         this.expression = expression;
     }
 
+    /**
+     * CEL expression for selecting when requests/connections should be logged.<br><p> <br><p> Examples:<br><p> <br><p> - `response.code &gt;= 400` - `connection.mtls &amp;&amp; request.url_path.contains('v1beta3')` - `!has(request.useragent) || !(request.useragent.startsWith("Amazon-Route53-Health-Check-Service"))`
+     */
     @JsonProperty("expression")
     public String getExpression() {
         return expression;
     }
 
+    /**
+     * CEL expression for selecting when requests/connections should be logged.<br><p> <br><p> Examples:<br><p> <br><p> - `response.code &gt;= 400` - `connection.mtls &amp;&amp; request.url_path.contains('v1beta3')` - `!has(request.useragent) || !(request.useragent.startsWith("Amazon-Route53-Health-Check-Service"))`
+     */
     @JsonProperty("expression")
     public void setExpression(String expression) {
         this.expression = expression;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/AccessLoggingLogSelector.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/AccessLoggingLogSelector.java
index 857316aabd3..e0387bc1b92 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/AccessLoggingLogSelector.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/AccessLoggingLogSelector.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LogSelector provides a coarse-grained ability to configure logging behavior based on certain traffic metadata (such as traffic direction). LogSelector applies to traffic metadata which is not represented in the attribute set currently supported by [filters](https://istio.io/latest/docs/reference/config/telemetry/#AccessLogging-Filter). It allows control planes to limit the configuration sent to individual workloads. Finer-grained logging behavior can be further configured via `filter`.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public AccessLoggingLogSelector(WorkloadMode mode) {
         this.mode = mode;
     }
 
+    /**
+     * LogSelector provides a coarse-grained ability to configure logging behavior based on certain traffic metadata (such as traffic direction). LogSelector applies to traffic metadata which is not represented in the attribute set currently supported by [filters](https://istio.io/latest/docs/reference/config/telemetry/#AccessLogging-Filter). It allows control planes to limit the configuration sent to individual workloads. Finer-grained logging behavior can be further configured via `filter`.
+     */
     @JsonProperty("mode")
     public WorkloadMode getMode() {
         return mode;
     }
 
+    /**
+     * LogSelector provides a coarse-grained ability to configure logging behavior based on certain traffic metadata (such as traffic direction). LogSelector applies to traffic metadata which is not represented in the attribute set currently supported by [filters](https://istio.io/latest/docs/reference/config/telemetry/#AccessLogging-Filter). It allows control planes to limit the configuration sent to individual workloads. Finer-grained logging behavior can be further configured via `filter`.
+     */
     @JsonProperty("mode")
     public void setMode(WorkloadMode mode) {
         this.mode = mode;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/MetricSelector.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/MetricSelector.java
index b9f88de626b..905eefea3db 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/MetricSelector.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/MetricSelector.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Provides a mechanism for matching metrics for the application of override behaviors.
+ */
 @JsonDeserialize(using = io.fabric8.kubernetes.model.jackson.JsonUnwrappedDeserializer.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -84,22 +87,34 @@ public MetricSelector(IsMetricSelectorMetricMatch metricMatch, WorkloadMode mode
         this.mode = mode;
     }
 
+    /**
+     * Provides a mechanism for matching metrics for the application of override behaviors.
+     */
     @JsonProperty("MetricMatch")
     @JsonUnwrapped
     public IsMetricSelectorMetricMatch getMetricMatch() {
         return metricMatch;
     }
 
+    /**
+     * Provides a mechanism for matching metrics for the application of override behaviors.
+     */
     @JsonProperty("MetricMatch")
     public void setMetricMatch(IsMetricSelectorMetricMatch metricMatch) {
         this.metricMatch = metricMatch;
     }
 
+    /**
+     * Provides a mechanism for matching metrics for the application of override behaviors.
+     */
     @JsonProperty("mode")
     public WorkloadMode getMode() {
         return mode;
     }
 
+    /**
+     * Provides a mechanism for matching metrics for the application of override behaviors.
+     */
     @JsonProperty("mode")
     public void setMode(WorkloadMode mode) {
         this.mode = mode;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/MetricSelectorCustomMetric.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/MetricSelectorCustomMetric.java
index 26d3723b1d1..c55dab341ce 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/MetricSelectorCustomMetric.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/MetricSelectorCustomMetric.java
@@ -78,11 +78,17 @@ public MetricSelectorCustomMetric(String customMetric) {
         this.customMetric = customMetric;
     }
 
+    /**
+     * Allows free-form specification of a metric. No validation of custom metrics is provided.
+     */
     @JsonProperty("customMetric")
     public String getCustomMetric() {
         return customMetric;
     }
 
+    /**
+     * Allows free-form specification of a metric. No validation of custom metrics is provided.
+     */
     @JsonProperty("customMetric")
     public void setCustomMetric(String customMetric) {
         this.customMetric = customMetric;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/MetricSelectorIstioMetric.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/MetricSelectorIstioMetric.java
index 734dc48b00c..2d6ad873538 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/MetricSelectorIstioMetric.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/MetricSelectorIstioMetric.java
@@ -4,6 +4,9 @@
 import javax.annotation.Generated;
 import com.fasterxml.jackson.annotation.JsonCreator;
 
+/**
+ * Curated list of known metric types that is supported by Istio metric providers. See also: https://istio.io/latest/docs/reference/config/metrics/#metrics
+ */
 @Generated("io.fabric8.kubernetes.schema.generator.model.ModelGenerator")
 public enum MetricSelectorIstioMetric 
 {
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/Metrics.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/Metrics.java
index dd9ce4185ca..2e6d2df4b27 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/Metrics.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/Metrics.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metrics defines the workload-level overrides for metrics generation behavior within a mesh. It can be used to enable/disable metrics generation, as well as to customize the dimensions of the generated metrics.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public Metrics(List<MetricsOverrides> overrides, List<ProviderRef> providers, St
         this.reportingInterval = reportingInterval;
     }
 
+    /**
+     * Optional. Ordered list of overrides to metrics generation behavior.<br><p> <br><p> Specified overrides will be applied in order. They will be applied on top of inherited overrides from other resources in the hierarchy in the following order: 1. Mesh-scoped overrides 2. Namespace-scoped overrides 3. Workload-scoped overrides<br><p> <br><p> Because overrides are applied in order, users are advised to order their overrides from least specific to most specific matches. That is, it is a best practice to list any universal overrides first, with tailored overrides following them.
+     */
     @JsonProperty("overrides")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MetricsOverrides> getOverrides() {
         return overrides;
     }
 
+    /**
+     * Optional. Ordered list of overrides to metrics generation behavior.<br><p> <br><p> Specified overrides will be applied in order. They will be applied on top of inherited overrides from other resources in the hierarchy in the following order: 1. Mesh-scoped overrides 2. Namespace-scoped overrides 3. Workload-scoped overrides<br><p> <br><p> Because overrides are applied in order, users are advised to order their overrides from least specific to most specific matches. That is, it is a best practice to list any universal overrides first, with tailored overrides following them.
+     */
     @JsonProperty("overrides")
     public void setOverrides(List<MetricsOverrides> overrides) {
         this.overrides = overrides;
     }
 
+    /**
+     * Optional. Name of providers to which this configuration should apply. If a provider is not specified, the [default metrics provider](https://istio.io/docs/reference/config/istio.mesh.v1alpha1/#MeshConfig-DefaultProviders) will be used.
+     */
     @JsonProperty("providers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ProviderRef> getProviders() {
         return providers;
     }
 
+    /**
+     * Optional. Name of providers to which this configuration should apply. If a provider is not specified, the [default metrics provider](https://istio.io/docs/reference/config/istio.mesh.v1alpha1/#MeshConfig-DefaultProviders) will be used.
+     */
     @JsonProperty("providers")
     public void setProviders(List<ProviderRef> providers) {
         this.providers = providers;
     }
 
+    /**
+     * Metrics defines the workload-level overrides for metrics generation behavior within a mesh. It can be used to enable/disable metrics generation, as well as to customize the dimensions of the generated metrics.
+     */
     @JsonProperty("reportingInterval")
     public String getReportingInterval() {
         return reportingInterval;
     }
 
+    /**
+     * Metrics defines the workload-level overrides for metrics generation behavior within a mesh. It can be used to enable/disable metrics generation, as well as to customize the dimensions of the generated metrics.
+     */
     @JsonProperty("reportingInterval")
     public void setReportingInterval(String reportingInterval) {
         this.reportingInterval = reportingInterval;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/MetricsOverrides.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/MetricsOverrides.java
index f6391685b7c..0d8c14395a1 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/MetricsOverrides.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/MetricsOverrides.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MetricsOverrides defines custom metric generation behavior for an individual metric or the set of all standard metrics.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,32 +90,50 @@ public MetricsOverrides(Boolean disabled, MetricSelector match, Map<String, Metr
         this.tagOverrides = tagOverrides;
     }
 
+    /**
+     * MetricsOverrides defines custom metric generation behavior for an individual metric or the set of all standard metrics.
+     */
     @JsonProperty("disabled")
     public Boolean getDisabled() {
         return disabled;
     }
 
+    /**
+     * MetricsOverrides defines custom metric generation behavior for an individual metric or the set of all standard metrics.
+     */
     @JsonProperty("disabled")
     public void setDisabled(Boolean disabled) {
         this.disabled = disabled;
     }
 
+    /**
+     * MetricsOverrides defines custom metric generation behavior for an individual metric or the set of all standard metrics.
+     */
     @JsonProperty("match")
     public MetricSelector getMatch() {
         return match;
     }
 
+    /**
+     * MetricsOverrides defines custom metric generation behavior for an individual metric or the set of all standard metrics.
+     */
     @JsonProperty("match")
     public void setMatch(MetricSelector match) {
         this.match = match;
     }
 
+    /**
+     * Optional. Collection of tag names and tag expressions to override in the selected metric(s). The key in the map is the name of the tag. The value in the map is the operation to perform on the the tag. WARNING: some providers may not support adding/removing tags. See also: https://istio.io/latest/docs/reference/config/metrics/#labels
+     */
     @JsonProperty("tagOverrides")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, MetricsOverridesTagOverride> getTagOverrides() {
         return tagOverrides;
     }
 
+    /**
+     * Optional. Collection of tag names and tag expressions to override in the selected metric(s). The key in the map is the name of the tag. The value in the map is the operation to perform on the the tag. WARNING: some providers may not support adding/removing tags. See also: https://istio.io/latest/docs/reference/config/metrics/#labels
+     */
     @JsonProperty("tagOverrides")
     public void setTagOverrides(Map<String, MetricsOverridesTagOverride> tagOverrides) {
         this.tagOverrides = tagOverrides;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/MetricsOverridesTagOverride.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/MetricsOverridesTagOverride.java
index 488f0e49571..11229757644 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/MetricsOverridesTagOverride.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/MetricsOverridesTagOverride.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TagOverride specifies an operation to perform on a metric dimension (also known as a `label`). Tags may be added, removed, or have their default values overridden.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public MetricsOverridesTagOverride(MetricsOverridesTagOverrideOperation operatio
         this.value = value;
     }
 
+    /**
+     * TagOverride specifies an operation to perform on a metric dimension (also known as a `label`). Tags may be added, removed, or have their default values overridden.
+     */
     @JsonProperty("operation")
     public MetricsOverridesTagOverrideOperation getOperation() {
         return operation;
     }
 
+    /**
+     * TagOverride specifies an operation to perform on a metric dimension (also known as a `label`). Tags may be added, removed, or have their default values overridden.
+     */
     @JsonProperty("operation")
     public void setOperation(MetricsOverridesTagOverrideOperation operation) {
         this.operation = operation;
     }
 
+    /**
+     * Value is only considered if the operation is `UPSERT`. Values are [CEL expressions](https://opensource.google/projects/cel) over attributes. Examples include: `string(destination.port)` and `request.host`. Istio exposes all standard [Envoy attributes](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/advanced/attributes). Additionally, Istio exposes node metadata as attributes. More information is provided in the [customization docs](https://istio.io/latest/docs/tasks/observability/metrics/customize-metrics/#use-expressions-for-values).
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is only considered if the operation is `UPSERT`. Values are [CEL expressions](https://opensource.google/projects/cel) over attributes. Examples include: `string(destination.port)` and `request.host`. Istio exposes all standard [Envoy attributes](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/advanced/attributes). Additionally, Istio exposes node metadata as attributes. More information is provided in the [customization docs](https://istio.io/latest/docs/tasks/observability/metrics/customize-metrics/#use-expressions-for-values).
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/ProviderRef.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/ProviderRef.java
index eebe3806c22..308af2594c5 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/ProviderRef.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/ProviderRef.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Used to bind Telemetry configuration to specific providers for targeted customization.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ProviderRef(String name) {
         this.name = name;
     }
 
+    /**
+     * Required. Name of Telemetry provider in [MeshConfig](https://istio.io/latest/docs/reference/config/istio.mesh.v1alpha1/#MeshConfig-ExtensionProvider).
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Required. Name of Telemetry provider in [MeshConfig](https://istio.io/latest/docs/reference/config/istio.mesh.v1alpha1/#MeshConfig-ExtensionProvider).
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/Telemetry.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/Telemetry.java
index 4b01f2a4ad8..aabe04d194e 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/Telemetry.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/Telemetry.java
@@ -41,6 +41,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * &lt;!-- crd generation tags is a timestamp representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -116,65 +119,101 @@ public Telemetry(List<AccessLogging> accessLogging, List<Metrics> metrics, Workl
         this.tracing = tracing;
     }
 
+    /**
+     * Optional. Access logging configures the access logging behavior for all selected workloads.
+     */
     @JsonProperty("accessLogging")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AccessLogging> getAccessLogging() {
         return accessLogging;
     }
 
+    /**
+     * Optional. Access logging configures the access logging behavior for all selected workloads.
+     */
     @JsonProperty("accessLogging")
     public void setAccessLogging(List<AccessLogging> accessLogging) {
         this.accessLogging = accessLogging;
     }
 
+    /**
+     * Optional. Metrics configures the metrics behavior for all selected workloads.
+     */
     @JsonProperty("metrics")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Metrics> getMetrics() {
         return metrics;
     }
 
+    /**
+     * Optional. Metrics configures the metrics behavior for all selected workloads.
+     */
     @JsonProperty("metrics")
     public void setMetrics(List<Metrics> metrics) {
         this.metrics = metrics;
     }
 
+    /**
+     * &lt;!-- crd generation tags is a timestamp representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("selector")
     public WorkloadSelector getSelector() {
         return selector;
     }
 
+    /**
+     * &lt;!-- crd generation tags is a timestamp representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("selector")
     public void setSelector(WorkloadSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * &lt;!-- crd generation tags is a timestamp representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("targetRef")
     public PolicyTargetReference getTargetRef() {
         return targetRef;
     }
 
+    /**
+     * &lt;!-- crd generation tags is a timestamp representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("targetRef")
     public void setTargetRef(PolicyTargetReference targetRef) {
         this.targetRef = targetRef;
     }
 
+    /**
+     * Optional. The targetRefs specifies a list of resources the policy should be applied to. The targeted resources specified will determine which workloads the policy applies to.<br><p> <br><p> Currently, the following resource attachment types are supported: &#42; `kind: Gateway` with `group: gateway.networking.k8s.io` in the same namespace. &#42; `kind: Service` with `group: ""` or `group: "core"` in the same namespace. This type is only supported for waypoints.<br><p> <br><p> If not set, the policy is applied as defined by the selector. At most one of the selector and targetRefs can be set.<br><p> <br><p> NOTE: If you are using the `targetRefs` field in a multi-revision environment with Istio versions prior to 1.22, it is highly recommended that you pin the policy to a revision running 1.22+ via the `istio.io/rev` label. This is to prevent proxies connected to older control planes (that don't know about the `targetRefs` field) from misinterpreting the policy as namespace-wide during the upgrade process.<br><p> <br><p> NOTE: Waypoint proxies are required to use this field for policies to apply; `selector` policies will be ignored.
+     */
     @JsonProperty("targetRefs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PolicyTargetReference> getTargetRefs() {
         return targetRefs;
     }
 
+    /**
+     * Optional. The targetRefs specifies a list of resources the policy should be applied to. The targeted resources specified will determine which workloads the policy applies to.<br><p> <br><p> Currently, the following resource attachment types are supported: &#42; `kind: Gateway` with `group: gateway.networking.k8s.io` in the same namespace. &#42; `kind: Service` with `group: ""` or `group: "core"` in the same namespace. This type is only supported for waypoints.<br><p> <br><p> If not set, the policy is applied as defined by the selector. At most one of the selector and targetRefs can be set.<br><p> <br><p> NOTE: If you are using the `targetRefs` field in a multi-revision environment with Istio versions prior to 1.22, it is highly recommended that you pin the policy to a revision running 1.22+ via the `istio.io/rev` label. This is to prevent proxies connected to older control planes (that don't know about the `targetRefs` field) from misinterpreting the policy as namespace-wide during the upgrade process.<br><p> <br><p> NOTE: Waypoint proxies are required to use this field for policies to apply; `selector` policies will be ignored.
+     */
     @JsonProperty("targetRefs")
     public void setTargetRefs(List<PolicyTargetReference> targetRefs) {
         this.targetRefs = targetRefs;
     }
 
+    /**
+     * Optional. Tracing configures the tracing behavior for all selected workloads.
+     */
     @JsonProperty("tracing")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Tracing> getTracing() {
         return tracing;
     }
 
+    /**
+     * Optional. Tracing configures the tracing behavior for all selected workloads.
+     */
     @JsonProperty("tracing")
     public void setTracing(List<Tracing> tracing) {
         this.tracing = tracing;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/Tracing.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/Tracing.java
index 809d0418d05..cb9d204fa27 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/Tracing.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/Tracing.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Tracing configures tracing behavior for workloads within a mesh. It can be used to enable/disable tracing, as well as to set sampling rates and custom tag extraction.<br><p> <br><p> Tracing configuration support overrides of the fields `providers`, `random_sampling_percentage`, `disable_span_reporting`, and `custom_tags` at each level in the configuration hierarchy, with missing values filled in from parent resources. However, when specified, `custom_tags` will fully replace any values provided by parent configuration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,63 +105,99 @@ public Tracing(Map<String, TracingCustomTag> customTags, Boolean disableSpanRepo
         this.useRequestIdForTraceSampling = useRequestIdForTraceSampling;
     }
 
+    /**
+     * Optional. Configures additional custom tags to the generated trace spans.
+     */
     @JsonProperty("customTags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, TracingCustomTag> getCustomTags() {
         return customTags;
     }
 
+    /**
+     * Optional. Configures additional custom tags to the generated trace spans.
+     */
     @JsonProperty("customTags")
     public void setCustomTags(Map<String, TracingCustomTag> customTags) {
         this.customTags = customTags;
     }
 
+    /**
+     * Tracing configures tracing behavior for workloads within a mesh. It can be used to enable/disable tracing, as well as to set sampling rates and custom tag extraction.<br><p> <br><p> Tracing configuration support overrides of the fields `providers`, `random_sampling_percentage`, `disable_span_reporting`, and `custom_tags` at each level in the configuration hierarchy, with missing values filled in from parent resources. However, when specified, `custom_tags` will fully replace any values provided by parent configuration.
+     */
     @JsonProperty("disableSpanReporting")
     public Boolean getDisableSpanReporting() {
         return disableSpanReporting;
     }
 
+    /**
+     * Tracing configures tracing behavior for workloads within a mesh. It can be used to enable/disable tracing, as well as to set sampling rates and custom tag extraction.<br><p> <br><p> Tracing configuration support overrides of the fields `providers`, `random_sampling_percentage`, `disable_span_reporting`, and `custom_tags` at each level in the configuration hierarchy, with missing values filled in from parent resources. However, when specified, `custom_tags` will fully replace any values provided by parent configuration.
+     */
     @JsonProperty("disableSpanReporting")
     public void setDisableSpanReporting(Boolean disableSpanReporting) {
         this.disableSpanReporting = disableSpanReporting;
     }
 
+    /**
+     * Tracing configures tracing behavior for workloads within a mesh. It can be used to enable/disable tracing, as well as to set sampling rates and custom tag extraction.<br><p> <br><p> Tracing configuration support overrides of the fields `providers`, `random_sampling_percentage`, `disable_span_reporting`, and `custom_tags` at each level in the configuration hierarchy, with missing values filled in from parent resources. However, when specified, `custom_tags` will fully replace any values provided by parent configuration.
+     */
     @JsonProperty("match")
     public TracingTracingSelector getMatch() {
         return match;
     }
 
+    /**
+     * Tracing configures tracing behavior for workloads within a mesh. It can be used to enable/disable tracing, as well as to set sampling rates and custom tag extraction.<br><p> <br><p> Tracing configuration support overrides of the fields `providers`, `random_sampling_percentage`, `disable_span_reporting`, and `custom_tags` at each level in the configuration hierarchy, with missing values filled in from parent resources. However, when specified, `custom_tags` will fully replace any values provided by parent configuration.
+     */
     @JsonProperty("match")
     public void setMatch(TracingTracingSelector match) {
         this.match = match;
     }
 
+    /**
+     * Optional. Name of provider(s) to use for span reporting. If a provider is not specified, the [default tracing provider](https://istio.io/docs/reference/config/istio.mesh.v1alpha1/#MeshConfig-DefaultProviders) will be used. NOTE: At the moment, only a single provider can be specified in a given Tracing rule.
+     */
     @JsonProperty("providers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ProviderRef> getProviders() {
         return providers;
     }
 
+    /**
+     * Optional. Name of provider(s) to use for span reporting. If a provider is not specified, the [default tracing provider](https://istio.io/docs/reference/config/istio.mesh.v1alpha1/#MeshConfig-DefaultProviders) will be used. NOTE: At the moment, only a single provider can be specified in a given Tracing rule.
+     */
     @JsonProperty("providers")
     public void setProviders(List<ProviderRef> providers) {
         this.providers = providers;
     }
 
+    /**
+     * Tracing configures tracing behavior for workloads within a mesh. It can be used to enable/disable tracing, as well as to set sampling rates and custom tag extraction.<br><p> <br><p> Tracing configuration support overrides of the fields `providers`, `random_sampling_percentage`, `disable_span_reporting`, and `custom_tags` at each level in the configuration hierarchy, with missing values filled in from parent resources. However, when specified, `custom_tags` will fully replace any values provided by parent configuration.
+     */
     @JsonProperty("randomSamplingPercentage")
     public Double getRandomSamplingPercentage() {
         return randomSamplingPercentage;
     }
 
+    /**
+     * Tracing configures tracing behavior for workloads within a mesh. It can be used to enable/disable tracing, as well as to set sampling rates and custom tag extraction.<br><p> <br><p> Tracing configuration support overrides of the fields `providers`, `random_sampling_percentage`, `disable_span_reporting`, and `custom_tags` at each level in the configuration hierarchy, with missing values filled in from parent resources. However, when specified, `custom_tags` will fully replace any values provided by parent configuration.
+     */
     @JsonProperty("randomSamplingPercentage")
     public void setRandomSamplingPercentage(Double randomSamplingPercentage) {
         this.randomSamplingPercentage = randomSamplingPercentage;
     }
 
+    /**
+     * Tracing configures tracing behavior for workloads within a mesh. It can be used to enable/disable tracing, as well as to set sampling rates and custom tag extraction.<br><p> <br><p> Tracing configuration support overrides of the fields `providers`, `random_sampling_percentage`, `disable_span_reporting`, and `custom_tags` at each level in the configuration hierarchy, with missing values filled in from parent resources. However, when specified, `custom_tags` will fully replace any values provided by parent configuration.
+     */
     @JsonProperty("useRequestIdForTraceSampling")
     public Boolean getUseRequestIdForTraceSampling() {
         return useRequestIdForTraceSampling;
     }
 
+    /**
+     * Tracing configures tracing behavior for workloads within a mesh. It can be used to enable/disable tracing, as well as to set sampling rates and custom tag extraction.<br><p> <br><p> Tracing configuration support overrides of the fields `providers`, `random_sampling_percentage`, `disable_span_reporting`, and `custom_tags` at each level in the configuration hierarchy, with missing values filled in from parent resources. However, when specified, `custom_tags` will fully replace any values provided by parent configuration.
+     */
     @JsonProperty("useRequestIdForTraceSampling")
     public void setUseRequestIdForTraceSampling(Boolean useRequestIdForTraceSampling) {
         this.useRequestIdForTraceSampling = useRequestIdForTraceSampling;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/TracingCustomTag.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/TracingCustomTag.java
index b7d85f5c08c..d146561a26e 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/TracingCustomTag.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/TracingCustomTag.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomTag defines a tag to be added to a trace span that is based on an operator-supplied value. This value can either be a hard-coded value, a value taken from an environment variable known to the sidecar proxy, or from a request header.<br><p> <br><p> NOTE: when specified, `custom_tags` will fully replace any values provided by parent configuration.
+ */
 @JsonDeserialize(using = io.fabric8.kubernetes.model.jackson.JsonUnwrappedDeserializer.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -80,12 +83,18 @@ public TracingCustomTag(IsTracingCustomTagType type) {
         this.type = type;
     }
 
+    /**
+     * CustomTag defines a tag to be added to a trace span that is based on an operator-supplied value. This value can either be a hard-coded value, a value taken from an environment variable known to the sidecar proxy, or from a request header.<br><p> <br><p> NOTE: when specified, `custom_tags` will fully replace any values provided by parent configuration.
+     */
     @JsonProperty("Type")
     @JsonUnwrapped
     public IsTracingCustomTagType getType() {
         return type;
     }
 
+    /**
+     * CustomTag defines a tag to be added to a trace span that is based on an operator-supplied value. This value can either be a hard-coded value, a value taken from an environment variable known to the sidecar proxy, or from a request header.<br><p> <br><p> NOTE: when specified, `custom_tags` will fully replace any values provided by parent configuration.
+     */
     @JsonProperty("Type")
     public void setType(IsTracingCustomTagType type) {
         this.type = type;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/TracingEnvironment.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/TracingEnvironment.java
index 8aa033b10f2..9710c56381d 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/TracingEnvironment.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/TracingEnvironment.java
@@ -82,21 +82,33 @@ public TracingEnvironment(String defaultValue, String name) {
         this.name = name;
     }
 
+    /**
+     * Optional. If the environment variable is not found, this value will be used instead.
+     */
     @JsonProperty("defaultValue")
     public String getDefaultValue() {
         return defaultValue;
     }
 
+    /**
+     * Optional. If the environment variable is not found, this value will be used instead.
+     */
     @JsonProperty("defaultValue")
     public void setDefaultValue(String defaultValue) {
         this.defaultValue = defaultValue;
     }
 
+    /**
+     * Name of the environment variable from which to extract the tag value.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the environment variable from which to extract the tag value.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/TracingLiteral.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/TracingLiteral.java
index 22ecdbed2d4..afdcb0a5506 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/TracingLiteral.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/TracingLiteral.java
@@ -78,11 +78,17 @@ public TracingLiteral(String value) {
         this.value = value;
     }
 
+    /**
+     * The tag value to use.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * The tag value to use.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/TracingRequestHeader.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/TracingRequestHeader.java
index c2143d61444..527a34df3a0 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/TracingRequestHeader.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/TracingRequestHeader.java
@@ -82,21 +82,33 @@ public TracingRequestHeader(String defaultValue, String name) {
         this.name = name;
     }
 
+    /**
+     * Optional. If the header is not found, this value will be used instead.
+     */
     @JsonProperty("defaultValue")
     public String getDefaultValue() {
         return defaultValue;
     }
 
+    /**
+     * Optional. If the header is not found, this value will be used instead.
+     */
     @JsonProperty("defaultValue")
     public void setDefaultValue(String defaultValue) {
         this.defaultValue = defaultValue;
     }
 
+    /**
+     * Name of the header from which to extract the tag value.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the header from which to extract the tag value.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/TracingTracingSelector.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/TracingTracingSelector.java
index 4bcd4ec6182..99435eb5abf 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/TracingTracingSelector.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/TracingTracingSelector.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TracingSelector provides a coarse-grained ability to configure tracing behavior based on certain traffic metadata (such as traffic direction).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public TracingTracingSelector(WorkloadMode mode) {
         this.mode = mode;
     }
 
+    /**
+     * TracingSelector provides a coarse-grained ability to configure tracing behavior based on certain traffic metadata (such as traffic direction).
+     */
     @JsonProperty("mode")
     public WorkloadMode getMode() {
         return mode;
     }
 
+    /**
+     * TracingSelector provides a coarse-grained ability to configure tracing behavior based on certain traffic metadata (such as traffic direction).
+     */
     @JsonProperty("mode")
     public void setMode(WorkloadMode mode) {
         this.mode = mode;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/WorkloadMode.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/WorkloadMode.java
index dff3fc00a9e..c932fb6bfa8 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/WorkloadMode.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/telemetry/v1alpha1/WorkloadMode.java
@@ -4,6 +4,9 @@
 import javax.annotation.Generated;
 import com.fasterxml.jackson.annotation.JsonCreator;
 
+/**
+ * WorkloadMode allows selection of the role of the underlying workload in network traffic. A workload is considered as acting as a `SERVER` if it is the destination of the traffic (that is, traffic direction, from the perspective of the workload is &#42;inbound&#42;). If the workload is the source of the network traffic, it is considered to be in `CLIENT` mode (traffic is &#42;outbound&#42; from the workload).
+ */
 @Generated("io.fabric8.kubernetes.schema.generator.model.ModelGenerator")
 public enum WorkloadMode 
 {
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/type/v1beta1/PolicyTargetReference.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/type/v1beta1/PolicyTargetReference.java
index 1e6efb71abb..ffe92475fa4 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/type/v1beta1/PolicyTargetReference.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/type/v1beta1/PolicyTargetReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PolicyTargetReference format as defined by [GEP-2648](https://gateway-api.sigs.k8s.io/geps/gep-2648/#direct-policy-design-rules).<br><p> <br><p> PolicyTargetReference specifies the targeted resource which the policy should be applied to. It must only target a single resource at a time, but it can be used to target larger resources such as Gateways that may apply to multiple child resources. The PolicyTargetReference will be used instead of a WorkloadSelector in the RequestAuthentication, AuthorizationPolicy, Telemetry, and WasmPlugin CRDs to target a Kubernetes Gateway.<br><p> <br><p> The following is an example of an AuthorizationPolicy bound to a waypoint proxy using a PolicyTargetReference. The example sets `action` to `DENY` to create a deny policy. It denies all the requests with `POST` method on port `8080` directed through the `waypoint` Gateway in the `foo` namespace.<br><p> <br><p> ```yaml apiVersion: security.istio.io/v1 kind: AuthorizationPolicy metadata:<br><p> <br><p> 	name: httpbin<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	targetRefs:<br><p> 	- name: waypoint<br><p> 	  kind: Gateway<br><p> 	  group: gateway.networking.k8s.io<br><p> 	action: DENY<br><p> 	rules:<br><p> 	- to:<br><p> 	  - operation:<br><p> 	      methods: ["POST"]<br><p> 	      ports: ["8080"]<br><p> <br><p> ```
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public PolicyTargetReference(String group, String kind, String name, String name
         this.namespace = namespace;
     }
 
+    /**
+     * group is the group of the target resource.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * group is the group of the target resource.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * kind is kind of the target resource.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * kind is kind of the target resource.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * name is the name of the target resource.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the target resource.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * namespace is the namespace of the referent. When unspecified, the local namespace is inferred.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * namespace is the namespace of the referent. When unspecified, the local namespace is inferred.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/type/v1beta1/PortSelector.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/type/v1beta1/PortSelector.java
index b622c78f703..c98b5c6f3db 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/type/v1beta1/PortSelector.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/type/v1beta1/PortSelector.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PortSelector is the criteria for specifying if a policy can be applied to a listener having a specific port.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public PortSelector(Long number) {
         this.number = number;
     }
 
+    /**
+     * Port number
+     */
     @JsonProperty("number")
     public Long getNumber() {
         return number;
     }
 
+    /**
+     * Port number
+     */
     @JsonProperty("number")
     public void setNumber(Long number) {
         this.number = number;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/type/v1beta1/WorkloadSelector.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/type/v1beta1/WorkloadSelector.java
index 7f4ee980f8f..1f40e257cd4 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/type/v1beta1/WorkloadSelector.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/api/type/v1beta1/WorkloadSelector.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WorkloadSelector specifies the criteria used to determine if a policy can be applied to a proxy. The matching criteria includes the metadata associated with a proxy, workload instance info such as labels attached to the pod/VM, or any other info that the proxy provides to Istio during the initial handshake. If multiple conditions are specified, all conditions need to match in order for the workload instance to be selected. Currently, only label based selection mechanism is supported.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,12 +82,18 @@ public WorkloadSelector(Map<String, String> matchLabels) {
         this.matchLabels = matchLabels;
     }
 
+    /**
+     * One or more labels that indicate a specific set of pods/VMs on which a policy should be applied. The scope of label search is restricted to the configuration namespace in which the resource is present.
+     */
     @JsonProperty("matchLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getMatchLabels() {
         return matchLabels;
     }
 
+    /**
+     * One or more labels that indicate a specific set of pods/VMs on which a policy should be applied. The scope of label search is restricted to the configuration namespace in which the resource is present.
+     */
     @JsonProperty("matchLabels")
     public void setMatchLabels(Map<String, String> matchLabels) {
         this.matchLabels = matchLabels;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/extensions/v1alpha1/WasmPlugin.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/extensions/v1alpha1/WasmPlugin.java
index ef48a45b2ab..f8bcccc2200 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/extensions/v1alpha1/WasmPlugin.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/extensions/v1alpha1/WasmPlugin.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WasmPlugins provides a mechanism to extend the functionality provided by the Istio proxy through WebAssembly filters.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class WasmPlugin implements Editable<WasmPluginBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "extensions.istio.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "WasmPlugin";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public WasmPlugin(String apiVersion, String kind, ObjectMeta metadata, io.fabric
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * WasmPlugins provides a mechanism to extend the functionality provided by the Istio proxy through WebAssembly filters.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * WasmPlugins provides a mechanism to extend the functionality provided by the Istio proxy through WebAssembly filters.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * WasmPlugins provides a mechanism to extend the functionality provided by the Istio proxy through WebAssembly filters.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.extensions.v1alpha1.WasmPlugin getSpec() {
         return spec;
     }
 
+    /**
+     * WasmPlugins provides a mechanism to extend the functionality provided by the Istio proxy through WebAssembly filters.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.extensions.v1alpha1.WasmPlugin spec) {
         this.spec = spec;
     }
 
+    /**
+     * WasmPlugins provides a mechanism to extend the functionality provided by the Istio proxy through WebAssembly filters.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * WasmPlugins provides a mechanism to extend the functionality provided by the Istio proxy through WebAssembly filters.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/extensions/v1alpha1/WasmPluginList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/extensions/v1alpha1/WasmPluginList.java
index fb4312c4ed6..60b42d97c06 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/extensions/v1alpha1/WasmPluginList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/extensions/v1alpha1/WasmPluginList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WasmPluginList is a collection of WasmPlugins.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class WasmPluginList implements Editable<WasmPluginListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.extensions.v1alpha1.WasmPlugin>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "extensions.istio.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.extensions.v1alpha1.WasmPlugin> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "WasmPluginList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public WasmPluginList(String apiVersion, List<io.fabric8.istio.api.extensions.v1
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * WasmPluginList is a collection of WasmPlugins.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.extensions.v1alpha1.WasmPlugin> getItems() {
         return items;
     }
 
+    /**
+     * WasmPluginList is a collection of WasmPlugins.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.extensions.v1alpha1.WasmPlugin> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * WasmPluginList is a collection of WasmPlugins.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * WasmPluginList is a collection of WasmPlugins.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/DestinationRule.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/DestinationRule.java
index 37bc7422862..5cc7b4a0c8a 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/DestinationRule.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/DestinationRule.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DestinationRule defines policies that apply to traffic intended for a service after routing has occurred.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class DestinationRule implements Editable<DestinationRuleBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DestinationRule";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public DestinationRule(String apiVersion, String kind, ObjectMeta metadata, io.f
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DestinationRule defines policies that apply to traffic intended for a service after routing has occurred.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DestinationRule defines policies that apply to traffic intended for a service after routing has occurred.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * DestinationRule defines policies that apply to traffic intended for a service after routing has occurred.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.networking.v1alpha3.DestinationRule getSpec() {
         return spec;
     }
 
+    /**
+     * DestinationRule defines policies that apply to traffic intended for a service after routing has occurred.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.networking.v1alpha3.DestinationRule spec) {
         this.spec = spec;
     }
 
+    /**
+     * DestinationRule defines policies that apply to traffic intended for a service after routing has occurred.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * DestinationRule defines policies that apply to traffic intended for a service after routing has occurred.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/DestinationRuleList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/DestinationRuleList.java
index 5a160358f55..f6b03ee46d9 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/DestinationRuleList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/DestinationRuleList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DestinationRuleList is a collection of DestinationRules.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class DestinationRuleList implements Editable<DestinationRuleListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.networking.v1.DestinationRule>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.networking.v1.DestinationRule> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DestinationRuleList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DestinationRuleList(String apiVersion, List<io.fabric8.istio.api.networki
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * DestinationRuleList is a collection of DestinationRules.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.networking.v1.DestinationRule> getItems() {
         return items;
     }
 
+    /**
+     * DestinationRuleList is a collection of DestinationRules.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.networking.v1.DestinationRule> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DestinationRuleList is a collection of DestinationRules.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DestinationRuleList is a collection of DestinationRules.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/Gateway.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/Gateway.java
index a8b454e63c7..b39f3738a56 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/Gateway.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/Gateway.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Gateway describes a load balancer operating at the edge of the mesh receiving incoming or outgoing HTTP/TCP connections.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class Gateway implements Editable<GatewayBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Gateway";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public Gateway(String apiVersion, String kind, ObjectMeta metadata, io.fabric8.i
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Gateway describes a load balancer operating at the edge of the mesh receiving incoming or outgoing HTTP/TCP connections.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Gateway describes a load balancer operating at the edge of the mesh receiving incoming or outgoing HTTP/TCP connections.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Gateway describes a load balancer operating at the edge of the mesh receiving incoming or outgoing HTTP/TCP connections.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.networking.v1alpha3.Gateway getSpec() {
         return spec;
     }
 
+    /**
+     * Gateway describes a load balancer operating at the edge of the mesh receiving incoming or outgoing HTTP/TCP connections.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.networking.v1alpha3.Gateway spec) {
         this.spec = spec;
     }
 
+    /**
+     * Gateway describes a load balancer operating at the edge of the mesh receiving incoming or outgoing HTTP/TCP connections.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * Gateway describes a load balancer operating at the edge of the mesh receiving incoming or outgoing HTTP/TCP connections.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/GatewayList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/GatewayList.java
index 79054fe602c..d9629cb0df6 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/GatewayList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/GatewayList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GatewayList is a collection of Gateways.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class GatewayList implements Editable<GatewayListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.networking.v1.Gateway>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.networking.v1.Gateway> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GatewayList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public GatewayList(String apiVersion, List<io.fabric8.istio.api.networking.v1.Ga
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * GatewayList is a collection of Gateways.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.networking.v1.Gateway> getItems() {
         return items;
     }
 
+    /**
+     * GatewayList is a collection of Gateways.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.networking.v1.Gateway> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * GatewayList is a collection of Gateways.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * GatewayList is a collection of Gateways.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/ServiceEntry.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/ServiceEntry.java
index 19ee554a235..00916aa72aa 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/ServiceEntry.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/ServiceEntry.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceEntry enables adding additional entries into Istio's internal service registry.<br><p> <br><p> &lt;!-- crd generation tags mesh or part of the mesh (MESH_EXTERNAL or MESH_INTERNAL)" (NONE, STATIC, or DNS)" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags istiostatus-override: ServiceEntryStatus: istio.io/api/networking/v1alpha3 --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class ServiceEntry implements Editable<ServiceEntryBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ServiceEntry";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public ServiceEntry(String apiVersion, String kind, ObjectMeta metadata, io.fabr
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ServiceEntry enables adding additional entries into Istio's internal service registry.<br><p> <br><p> &lt;!-- crd generation tags mesh or part of the mesh (MESH_EXTERNAL or MESH_INTERNAL)" (NONE, STATIC, or DNS)" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags istiostatus-override: ServiceEntryStatus: istio.io/api/networking/v1alpha3 --&gt;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ServiceEntry enables adding additional entries into Istio's internal service registry.<br><p> <br><p> &lt;!-- crd generation tags mesh or part of the mesh (MESH_EXTERNAL or MESH_INTERNAL)" (NONE, STATIC, or DNS)" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags istiostatus-override: ServiceEntryStatus: istio.io/api/networking/v1alpha3 --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ServiceEntry enables adding additional entries into Istio's internal service registry.<br><p> <br><p> &lt;!-- crd generation tags mesh or part of the mesh (MESH_EXTERNAL or MESH_INTERNAL)" (NONE, STATIC, or DNS)" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags istiostatus-override: ServiceEntryStatus: istio.io/api/networking/v1alpha3 --&gt;
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.networking.v1alpha3.ServiceEntry getSpec() {
         return spec;
     }
 
+    /**
+     * ServiceEntry enables adding additional entries into Istio's internal service registry.<br><p> <br><p> &lt;!-- crd generation tags mesh or part of the mesh (MESH_EXTERNAL or MESH_INTERNAL)" (NONE, STATIC, or DNS)" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags istiostatus-override: ServiceEntryStatus: istio.io/api/networking/v1alpha3 --&gt;
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.networking.v1alpha3.ServiceEntry spec) {
         this.spec = spec;
     }
 
+    /**
+     * ServiceEntry enables adding additional entries into Istio's internal service registry.<br><p> <br><p> &lt;!-- crd generation tags mesh or part of the mesh (MESH_EXTERNAL or MESH_INTERNAL)" (NONE, STATIC, or DNS)" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags istiostatus-override: ServiceEntryStatus: istio.io/api/networking/v1alpha3 --&gt;
+     */
     @JsonProperty("status")
     public ServiceEntryStatus getStatus() {
         return status;
     }
 
+    /**
+     * ServiceEntry enables adding additional entries into Istio's internal service registry.<br><p> <br><p> &lt;!-- crd generation tags mesh or part of the mesh (MESH_EXTERNAL or MESH_INTERNAL)" (NONE, STATIC, or DNS)" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags istiostatus-override: ServiceEntryStatus: istio.io/api/networking/v1alpha3 --&gt;
+     */
     @JsonProperty("status")
     public void setStatus(ServiceEntryStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/ServiceEntryList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/ServiceEntryList.java
index 04f2ce25372..18bf066a79a 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/ServiceEntryList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/ServiceEntryList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceEntryList is a collection of ServiceEntries.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ServiceEntryList implements Editable<ServiceEntryListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.networking.v1.ServiceEntry>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.networking.v1.ServiceEntry> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ServiceEntryList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ServiceEntryList(String apiVersion, List<io.fabric8.istio.api.networking.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ServiceEntryList is a collection of ServiceEntries.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.networking.v1.ServiceEntry> getItems() {
         return items;
     }
 
+    /**
+     * ServiceEntryList is a collection of ServiceEntries.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.networking.v1.ServiceEntry> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ServiceEntryList is a collection of ServiceEntries.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ServiceEntryList is a collection of ServiceEntries.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/Sidecar.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/Sidecar.java
index 24a14ea495a..f193fecf95f 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/Sidecar.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/Sidecar.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * `Sidecar` describes the configuration of the sidecar proxy that mediates inbound and outbound communication of the workload instance to which it is attached.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class Sidecar implements Editable<SidecarBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Sidecar";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public Sidecar(String apiVersion, String kind, ObjectMeta metadata, io.fabric8.i
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * `Sidecar` describes the configuration of the sidecar proxy that mediates inbound and outbound communication of the workload instance to which it is attached.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * `Sidecar` describes the configuration of the sidecar proxy that mediates inbound and outbound communication of the workload instance to which it is attached.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * `Sidecar` describes the configuration of the sidecar proxy that mediates inbound and outbound communication of the workload instance to which it is attached.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.networking.v1alpha3.Sidecar getSpec() {
         return spec;
     }
 
+    /**
+     * `Sidecar` describes the configuration of the sidecar proxy that mediates inbound and outbound communication of the workload instance to which it is attached.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.networking.v1alpha3.Sidecar spec) {
         this.spec = spec;
     }
 
+    /**
+     * `Sidecar` describes the configuration of the sidecar proxy that mediates inbound and outbound communication of the workload instance to which it is attached.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * `Sidecar` describes the configuration of the sidecar proxy that mediates inbound and outbound communication of the workload instance to which it is attached.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/SidecarList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/SidecarList.java
index c3467f7708f..0bd88e33daf 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/SidecarList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/SidecarList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SidecarList is a collection of Sidecars.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class SidecarList implements Editable<SidecarListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.networking.v1.Sidecar>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.networking.v1.Sidecar> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SidecarList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public SidecarList(String apiVersion, List<io.fabric8.istio.api.networking.v1.Si
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * SidecarList is a collection of Sidecars.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.networking.v1.Sidecar> getItems() {
         return items;
     }
 
+    /**
+     * SidecarList is a collection of Sidecars.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.networking.v1.Sidecar> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SidecarList is a collection of Sidecars.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SidecarList is a collection of Sidecars.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/VirtualService.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/VirtualService.java
index 40044647291..88959bb1710 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/VirtualService.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/VirtualService.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Configuration affecting traffic routing.<br><p> <br><p> &lt;!-- crd generation tags that should apply these routes" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class VirtualService implements Editable<VirtualServiceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VirtualService";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public VirtualService(String apiVersion, String kind, ObjectMeta metadata, io.fa
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Configuration affecting traffic routing.<br><p> <br><p> &lt;!-- crd generation tags that should apply these routes" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Configuration affecting traffic routing.<br><p> <br><p> &lt;!-- crd generation tags that should apply these routes" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Configuration affecting traffic routing.<br><p> <br><p> &lt;!-- crd generation tags that should apply these routes" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.networking.v1alpha3.VirtualService getSpec() {
         return spec;
     }
 
+    /**
+     * Configuration affecting traffic routing.<br><p> <br><p> &lt;!-- crd generation tags that should apply these routes" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.networking.v1alpha3.VirtualService spec) {
         this.spec = spec;
     }
 
+    /**
+     * Configuration affecting traffic routing.<br><p> <br><p> &lt;!-- crd generation tags that should apply these routes" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * Configuration affecting traffic routing.<br><p> <br><p> &lt;!-- crd generation tags that should apply these routes" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/VirtualServiceList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/VirtualServiceList.java
index b5b5d5e2d6e..b722aaf279e 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/VirtualServiceList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/VirtualServiceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VirtualServiceList is a collection of VirtualServices.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class VirtualServiceList implements Editable<VirtualServiceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.networking.v1.VirtualService>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.networking.v1.VirtualService> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VirtualServiceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public VirtualServiceList(String apiVersion, List<io.fabric8.istio.api.networkin
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * VirtualServiceList is a collection of VirtualServices.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.networking.v1.VirtualService> getItems() {
         return items;
     }
 
+    /**
+     * VirtualServiceList is a collection of VirtualServices.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.networking.v1.VirtualService> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VirtualServiceList is a collection of VirtualServices.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VirtualServiceList is a collection of VirtualServices.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/WorkloadEntry.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/WorkloadEntry.java
index 7451a44a14b..29be99ea4a9 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/WorkloadEntry.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/WorkloadEntry.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WorkloadEntry enables specifying the properties of a single non-Kubernetes workload such a VM or a bare metal services that can be referred to by service entries.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class WorkloadEntry implements Editable<WorkloadEntryBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "WorkloadEntry";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public WorkloadEntry(String apiVersion, String kind, ObjectMeta metadata, io.fab
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * WorkloadEntry enables specifying the properties of a single non-Kubernetes workload such a VM or a bare metal services that can be referred to by service entries.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * WorkloadEntry enables specifying the properties of a single non-Kubernetes workload such a VM or a bare metal services that can be referred to by service entries.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * WorkloadEntry enables specifying the properties of a single non-Kubernetes workload such a VM or a bare metal services that can be referred to by service entries.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.networking.v1alpha3.WorkloadEntry getSpec() {
         return spec;
     }
 
+    /**
+     * WorkloadEntry enables specifying the properties of a single non-Kubernetes workload such a VM or a bare metal services that can be referred to by service entries.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.networking.v1alpha3.WorkloadEntry spec) {
         this.spec = spec;
     }
 
+    /**
+     * WorkloadEntry enables specifying the properties of a single non-Kubernetes workload such a VM or a bare metal services that can be referred to by service entries.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * WorkloadEntry enables specifying the properties of a single non-Kubernetes workload such a VM or a bare metal services that can be referred to by service entries.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/WorkloadEntryList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/WorkloadEntryList.java
index fe91cedf99a..1df1b2559e6 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/WorkloadEntryList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/WorkloadEntryList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WorkloadEntryList is a collection of WorkloadEntries.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class WorkloadEntryList implements Editable<WorkloadEntryListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.networking.v1.WorkloadEntry>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.networking.v1.WorkloadEntry> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "WorkloadEntryList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public WorkloadEntryList(String apiVersion, List<io.fabric8.istio.api.networking
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * WorkloadEntryList is a collection of WorkloadEntries.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.networking.v1.WorkloadEntry> getItems() {
         return items;
     }
 
+    /**
+     * WorkloadEntryList is a collection of WorkloadEntries.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.networking.v1.WorkloadEntry> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * WorkloadEntryList is a collection of WorkloadEntries.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * WorkloadEntryList is a collection of WorkloadEntries.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/WorkloadGroup.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/WorkloadGroup.java
index 0215ae1b888..b0165be8bfa 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/WorkloadGroup.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/WorkloadGroup.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * `WorkloadGroup` enables specifying the properties of a single workload for bootstrap and provides a template for `WorkloadEntry`, similar to how `Deployment` specifies properties of workloads via `Pod` templates. A `WorkloadGroup` can have more than one `WorkloadEntry`. `WorkloadGroup` has no relationship to resources which control service registry like `ServiceEntry` and as such doesn't configure host name for these workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class WorkloadGroup implements Editable<WorkloadGroupBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "WorkloadGroup";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public WorkloadGroup(String apiVersion, String kind, ObjectMeta metadata, io.fab
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * `WorkloadGroup` enables specifying the properties of a single workload for bootstrap and provides a template for `WorkloadEntry`, similar to how `Deployment` specifies properties of workloads via `Pod` templates. A `WorkloadGroup` can have more than one `WorkloadEntry`. `WorkloadGroup` has no relationship to resources which control service registry like `ServiceEntry` and as such doesn't configure host name for these workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * `WorkloadGroup` enables specifying the properties of a single workload for bootstrap and provides a template for `WorkloadEntry`, similar to how `Deployment` specifies properties of workloads via `Pod` templates. A `WorkloadGroup` can have more than one `WorkloadEntry`. `WorkloadGroup` has no relationship to resources which control service registry like `ServiceEntry` and as such doesn't configure host name for these workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * `WorkloadGroup` enables specifying the properties of a single workload for bootstrap and provides a template for `WorkloadEntry`, similar to how `Deployment` specifies properties of workloads via `Pod` templates. A `WorkloadGroup` can have more than one `WorkloadEntry`. `WorkloadGroup` has no relationship to resources which control service registry like `ServiceEntry` and as such doesn't configure host name for these workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.networking.v1alpha3.WorkloadGroup getSpec() {
         return spec;
     }
 
+    /**
+     * `WorkloadGroup` enables specifying the properties of a single workload for bootstrap and provides a template for `WorkloadEntry`, similar to how `Deployment` specifies properties of workloads via `Pod` templates. A `WorkloadGroup` can have more than one `WorkloadEntry`. `WorkloadGroup` has no relationship to resources which control service registry like `ServiceEntry` and as such doesn't configure host name for these workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.networking.v1alpha3.WorkloadGroup spec) {
         this.spec = spec;
     }
 
+    /**
+     * `WorkloadGroup` enables specifying the properties of a single workload for bootstrap and provides a template for `WorkloadEntry`, similar to how `Deployment` specifies properties of workloads via `Pod` templates. A `WorkloadGroup` can have more than one `WorkloadEntry`. `WorkloadGroup` has no relationship to resources which control service registry like `ServiceEntry` and as such doesn't configure host name for these workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * `WorkloadGroup` enables specifying the properties of a single workload for bootstrap and provides a template for `WorkloadEntry`, similar to how `Deployment` specifies properties of workloads via `Pod` templates. A `WorkloadGroup` can have more than one `WorkloadEntry`. `WorkloadGroup` has no relationship to resources which control service registry like `ServiceEntry` and as such doesn't configure host name for these workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/WorkloadGroupList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/WorkloadGroupList.java
index 71989416eb3..3424cd2609a 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/WorkloadGroupList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1/WorkloadGroupList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WorkloadGroupList is a collection of WorkloadGroups.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class WorkloadGroupList implements Editable<WorkloadGroupListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.networking.v1.WorkloadGroup>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.networking.v1.WorkloadGroup> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "WorkloadGroupList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public WorkloadGroupList(String apiVersion, List<io.fabric8.istio.api.networking
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * WorkloadGroupList is a collection of WorkloadGroups.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.networking.v1.WorkloadGroup> getItems() {
         return items;
     }
 
+    /**
+     * WorkloadGroupList is a collection of WorkloadGroups.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.networking.v1.WorkloadGroup> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * WorkloadGroupList is a collection of WorkloadGroups.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * WorkloadGroupList is a collection of WorkloadGroups.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/DestinationRule.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/DestinationRule.java
index 164c1ac3df0..ffed4ff2b79 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/DestinationRule.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/DestinationRule.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DestinationRule defines policies that apply to traffic intended for a service after routing has occurred.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class DestinationRule implements Editable<DestinationRuleBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1alpha3";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DestinationRule";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public DestinationRule(String apiVersion, String kind, ObjectMeta metadata, io.f
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DestinationRule defines policies that apply to traffic intended for a service after routing has occurred.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DestinationRule defines policies that apply to traffic intended for a service after routing has occurred.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * DestinationRule defines policies that apply to traffic intended for a service after routing has occurred.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.networking.v1alpha3.DestinationRule getSpec() {
         return spec;
     }
 
+    /**
+     * DestinationRule defines policies that apply to traffic intended for a service after routing has occurred.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.networking.v1alpha3.DestinationRule spec) {
         this.spec = spec;
     }
 
+    /**
+     * DestinationRule defines policies that apply to traffic intended for a service after routing has occurred.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * DestinationRule defines policies that apply to traffic intended for a service after routing has occurred.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/DestinationRuleList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/DestinationRuleList.java
index 6eda4bba78f..011eae2c834 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/DestinationRuleList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/DestinationRuleList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DestinationRuleList is a collection of DestinationRules.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class DestinationRuleList implements Editable<DestinationRuleListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.networking.v1alpha3.DestinationRule>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1alpha3";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.networking.v1alpha3.DestinationRule> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DestinationRuleList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DestinationRuleList(String apiVersion, List<io.fabric8.istio.api.networki
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * DestinationRuleList is a collection of DestinationRules.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.networking.v1alpha3.DestinationRule> getItems() {
         return items;
     }
 
+    /**
+     * DestinationRuleList is a collection of DestinationRules.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.networking.v1alpha3.DestinationRule> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DestinationRuleList is a collection of DestinationRules.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DestinationRuleList is a collection of DestinationRules.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/EnvoyFilter.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/EnvoyFilter.java
index 63f32fa7616..a44295f16f8 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/EnvoyFilter.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/EnvoyFilter.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EnvoyFilter provides a mechanism to customize the Envoy configuration generated by Istio Pilot.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class EnvoyFilter implements Editable<EnvoyFilterBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1alpha3";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EnvoyFilter";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public EnvoyFilter(String apiVersion, String kind, ObjectMeta metadata, io.fabri
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EnvoyFilter provides a mechanism to customize the Envoy configuration generated by Istio Pilot.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EnvoyFilter provides a mechanism to customize the Envoy configuration generated by Istio Pilot.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * EnvoyFilter provides a mechanism to customize the Envoy configuration generated by Istio Pilot.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.networking.v1alpha3.EnvoyFilter getSpec() {
         return spec;
     }
 
+    /**
+     * EnvoyFilter provides a mechanism to customize the Envoy configuration generated by Istio Pilot.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.networking.v1alpha3.EnvoyFilter spec) {
         this.spec = spec;
     }
 
+    /**
+     * EnvoyFilter provides a mechanism to customize the Envoy configuration generated by Istio Pilot.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * EnvoyFilter provides a mechanism to customize the Envoy configuration generated by Istio Pilot.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/EnvoyFilterList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/EnvoyFilterList.java
index ee6b63e149e..734ac168ad5 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/EnvoyFilterList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/EnvoyFilterList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EnvoyFilterList is a collection of EnvoyFilters.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class EnvoyFilterList implements Editable<EnvoyFilterListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.networking.v1alpha3.EnvoyFilter>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1alpha3";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.networking.v1alpha3.EnvoyFilter> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EnvoyFilterList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EnvoyFilterList(String apiVersion, List<io.fabric8.istio.api.networking.v
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * EnvoyFilterList is a collection of EnvoyFilters.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.networking.v1alpha3.EnvoyFilter> getItems() {
         return items;
     }
 
+    /**
+     * EnvoyFilterList is a collection of EnvoyFilters.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.networking.v1alpha3.EnvoyFilter> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EnvoyFilterList is a collection of EnvoyFilters.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EnvoyFilterList is a collection of EnvoyFilters.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/Gateway.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/Gateway.java
index 66d274c2214..6d66f5f2ab6 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/Gateway.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/Gateway.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Gateway describes a load balancer operating at the edge of the mesh receiving incoming or outgoing HTTP/TCP connections.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class Gateway implements Editable<GatewayBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1alpha3";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Gateway";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public Gateway(String apiVersion, String kind, ObjectMeta metadata, io.fabric8.i
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Gateway describes a load balancer operating at the edge of the mesh receiving incoming or outgoing HTTP/TCP connections.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Gateway describes a load balancer operating at the edge of the mesh receiving incoming or outgoing HTTP/TCP connections.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Gateway describes a load balancer operating at the edge of the mesh receiving incoming or outgoing HTTP/TCP connections.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.networking.v1alpha3.Gateway getSpec() {
         return spec;
     }
 
+    /**
+     * Gateway describes a load balancer operating at the edge of the mesh receiving incoming or outgoing HTTP/TCP connections.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.networking.v1alpha3.Gateway spec) {
         this.spec = spec;
     }
 
+    /**
+     * Gateway describes a load balancer operating at the edge of the mesh receiving incoming or outgoing HTTP/TCP connections.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * Gateway describes a load balancer operating at the edge of the mesh receiving incoming or outgoing HTTP/TCP connections.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/GatewayList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/GatewayList.java
index a68ccc1aba1..8a246d69e2e 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/GatewayList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/GatewayList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GatewayList is a collection of Gateways.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class GatewayList implements Editable<GatewayListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.networking.v1alpha3.Gateway>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1alpha3";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.networking.v1alpha3.Gateway> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GatewayList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public GatewayList(String apiVersion, List<io.fabric8.istio.api.networking.v1alp
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * GatewayList is a collection of Gateways.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.networking.v1alpha3.Gateway> getItems() {
         return items;
     }
 
+    /**
+     * GatewayList is a collection of Gateways.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.networking.v1alpha3.Gateway> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * GatewayList is a collection of Gateways.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * GatewayList is a collection of Gateways.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/ServiceEntry.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/ServiceEntry.java
index fb6c23d3108..ed2a4029d77 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/ServiceEntry.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/ServiceEntry.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceEntry enables adding additional entries into Istio's internal service registry.<br><p> <br><p> &lt;!-- crd generation tags mesh or part of the mesh (MESH_EXTERNAL or MESH_INTERNAL)" (NONE, STATIC, or DNS)" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags istiostatus-override: ServiceEntryStatus: istio.io/api/networking/v1alpha3 --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class ServiceEntry implements Editable<ServiceEntryBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1alpha3";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ServiceEntry";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public ServiceEntry(String apiVersion, String kind, ObjectMeta metadata, io.fabr
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ServiceEntry enables adding additional entries into Istio's internal service registry.<br><p> <br><p> &lt;!-- crd generation tags mesh or part of the mesh (MESH_EXTERNAL or MESH_INTERNAL)" (NONE, STATIC, or DNS)" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags istiostatus-override: ServiceEntryStatus: istio.io/api/networking/v1alpha3 --&gt;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ServiceEntry enables adding additional entries into Istio's internal service registry.<br><p> <br><p> &lt;!-- crd generation tags mesh or part of the mesh (MESH_EXTERNAL or MESH_INTERNAL)" (NONE, STATIC, or DNS)" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags istiostatus-override: ServiceEntryStatus: istio.io/api/networking/v1alpha3 --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ServiceEntry enables adding additional entries into Istio's internal service registry.<br><p> <br><p> &lt;!-- crd generation tags mesh or part of the mesh (MESH_EXTERNAL or MESH_INTERNAL)" (NONE, STATIC, or DNS)" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags istiostatus-override: ServiceEntryStatus: istio.io/api/networking/v1alpha3 --&gt;
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.networking.v1alpha3.ServiceEntry getSpec() {
         return spec;
     }
 
+    /**
+     * ServiceEntry enables adding additional entries into Istio's internal service registry.<br><p> <br><p> &lt;!-- crd generation tags mesh or part of the mesh (MESH_EXTERNAL or MESH_INTERNAL)" (NONE, STATIC, or DNS)" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags istiostatus-override: ServiceEntryStatus: istio.io/api/networking/v1alpha3 --&gt;
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.networking.v1alpha3.ServiceEntry spec) {
         this.spec = spec;
     }
 
+    /**
+     * ServiceEntry enables adding additional entries into Istio's internal service registry.<br><p> <br><p> &lt;!-- crd generation tags mesh or part of the mesh (MESH_EXTERNAL or MESH_INTERNAL)" (NONE, STATIC, or DNS)" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags istiostatus-override: ServiceEntryStatus: istio.io/api/networking/v1alpha3 --&gt;
+     */
     @JsonProperty("status")
     public ServiceEntryStatus getStatus() {
         return status;
     }
 
+    /**
+     * ServiceEntry enables adding additional entries into Istio's internal service registry.<br><p> <br><p> &lt;!-- crd generation tags mesh or part of the mesh (MESH_EXTERNAL or MESH_INTERNAL)" (NONE, STATIC, or DNS)" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags istiostatus-override: ServiceEntryStatus: istio.io/api/networking/v1alpha3 --&gt;
+     */
     @JsonProperty("status")
     public void setStatus(ServiceEntryStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/ServiceEntryList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/ServiceEntryList.java
index 73e32574986..053e568d440 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/ServiceEntryList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/ServiceEntryList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceEntryList is a collection of ServiceEntries.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ServiceEntryList implements Editable<ServiceEntryListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.networking.v1alpha3.ServiceEntry>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1alpha3";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.networking.v1alpha3.ServiceEntry> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ServiceEntryList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ServiceEntryList(String apiVersion, List<io.fabric8.istio.api.networking.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ServiceEntryList is a collection of ServiceEntries.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.networking.v1alpha3.ServiceEntry> getItems() {
         return items;
     }
 
+    /**
+     * ServiceEntryList is a collection of ServiceEntries.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.networking.v1alpha3.ServiceEntry> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ServiceEntryList is a collection of ServiceEntries.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ServiceEntryList is a collection of ServiceEntries.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/Sidecar.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/Sidecar.java
index 4927a374042..e73f4891b17 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/Sidecar.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/Sidecar.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * `Sidecar` describes the configuration of the sidecar proxy that mediates inbound and outbound communication of the workload instance to which it is attached.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class Sidecar implements Editable<SidecarBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1alpha3";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Sidecar";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public Sidecar(String apiVersion, String kind, ObjectMeta metadata, io.fabric8.i
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * `Sidecar` describes the configuration of the sidecar proxy that mediates inbound and outbound communication of the workload instance to which it is attached.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * `Sidecar` describes the configuration of the sidecar proxy that mediates inbound and outbound communication of the workload instance to which it is attached.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * `Sidecar` describes the configuration of the sidecar proxy that mediates inbound and outbound communication of the workload instance to which it is attached.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.networking.v1alpha3.Sidecar getSpec() {
         return spec;
     }
 
+    /**
+     * `Sidecar` describes the configuration of the sidecar proxy that mediates inbound and outbound communication of the workload instance to which it is attached.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.networking.v1alpha3.Sidecar spec) {
         this.spec = spec;
     }
 
+    /**
+     * `Sidecar` describes the configuration of the sidecar proxy that mediates inbound and outbound communication of the workload instance to which it is attached.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * `Sidecar` describes the configuration of the sidecar proxy that mediates inbound and outbound communication of the workload instance to which it is attached.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/SidecarList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/SidecarList.java
index eee2478acef..bff1432fc04 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/SidecarList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/SidecarList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SidecarList is a collection of Sidecars.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class SidecarList implements Editable<SidecarListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.networking.v1alpha3.Sidecar>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1alpha3";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.networking.v1alpha3.Sidecar> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SidecarList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public SidecarList(String apiVersion, List<io.fabric8.istio.api.networking.v1alp
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * SidecarList is a collection of Sidecars.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.networking.v1alpha3.Sidecar> getItems() {
         return items;
     }
 
+    /**
+     * SidecarList is a collection of Sidecars.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.networking.v1alpha3.Sidecar> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SidecarList is a collection of Sidecars.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SidecarList is a collection of Sidecars.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/VirtualService.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/VirtualService.java
index c4613581d0b..9259ca6dd65 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/VirtualService.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/VirtualService.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Configuration affecting traffic routing.<br><p> <br><p> &lt;!-- crd generation tags that should apply these routes" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class VirtualService implements Editable<VirtualServiceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1alpha3";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VirtualService";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public VirtualService(String apiVersion, String kind, ObjectMeta metadata, io.fa
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Configuration affecting traffic routing.<br><p> <br><p> &lt;!-- crd generation tags that should apply these routes" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Configuration affecting traffic routing.<br><p> <br><p> &lt;!-- crd generation tags that should apply these routes" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Configuration affecting traffic routing.<br><p> <br><p> &lt;!-- crd generation tags that should apply these routes" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.networking.v1alpha3.VirtualService getSpec() {
         return spec;
     }
 
+    /**
+     * Configuration affecting traffic routing.<br><p> <br><p> &lt;!-- crd generation tags that should apply these routes" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.networking.v1alpha3.VirtualService spec) {
         this.spec = spec;
     }
 
+    /**
+     * Configuration affecting traffic routing.<br><p> <br><p> &lt;!-- crd generation tags that should apply these routes" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * Configuration affecting traffic routing.<br><p> <br><p> &lt;!-- crd generation tags that should apply these routes" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/VirtualServiceList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/VirtualServiceList.java
index 87e7b133c8d..1a517f4d784 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/VirtualServiceList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/VirtualServiceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VirtualServiceList is a collection of VirtualServices.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class VirtualServiceList implements Editable<VirtualServiceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.networking.v1alpha3.VirtualService>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1alpha3";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.networking.v1alpha3.VirtualService> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VirtualServiceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public VirtualServiceList(String apiVersion, List<io.fabric8.istio.api.networkin
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * VirtualServiceList is a collection of VirtualServices.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.networking.v1alpha3.VirtualService> getItems() {
         return items;
     }
 
+    /**
+     * VirtualServiceList is a collection of VirtualServices.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.networking.v1alpha3.VirtualService> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VirtualServiceList is a collection of VirtualServices.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VirtualServiceList is a collection of VirtualServices.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/WorkloadEntry.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/WorkloadEntry.java
index fe0d7b58297..2109961bcba 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/WorkloadEntry.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/WorkloadEntry.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WorkloadEntry enables specifying the properties of a single non-Kubernetes workload such a VM or a bare metal services that can be referred to by service entries.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class WorkloadEntry implements Editable<WorkloadEntryBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1alpha3";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "WorkloadEntry";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public WorkloadEntry(String apiVersion, String kind, ObjectMeta metadata, io.fab
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * WorkloadEntry enables specifying the properties of a single non-Kubernetes workload such a VM or a bare metal services that can be referred to by service entries.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * WorkloadEntry enables specifying the properties of a single non-Kubernetes workload such a VM or a bare metal services that can be referred to by service entries.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * WorkloadEntry enables specifying the properties of a single non-Kubernetes workload such a VM or a bare metal services that can be referred to by service entries.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.networking.v1alpha3.WorkloadEntry getSpec() {
         return spec;
     }
 
+    /**
+     * WorkloadEntry enables specifying the properties of a single non-Kubernetes workload such a VM or a bare metal services that can be referred to by service entries.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.networking.v1alpha3.WorkloadEntry spec) {
         this.spec = spec;
     }
 
+    /**
+     * WorkloadEntry enables specifying the properties of a single non-Kubernetes workload such a VM or a bare metal services that can be referred to by service entries.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * WorkloadEntry enables specifying the properties of a single non-Kubernetes workload such a VM or a bare metal services that can be referred to by service entries.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/WorkloadEntryList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/WorkloadEntryList.java
index bad2b3991b7..055c70ed7f4 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/WorkloadEntryList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/WorkloadEntryList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WorkloadEntryList is a collection of WorkloadEntries.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class WorkloadEntryList implements Editable<WorkloadEntryListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.networking.v1alpha3.WorkloadEntry>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1alpha3";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.networking.v1alpha3.WorkloadEntry> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "WorkloadEntryList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public WorkloadEntryList(String apiVersion, List<io.fabric8.istio.api.networking
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * WorkloadEntryList is a collection of WorkloadEntries.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.networking.v1alpha3.WorkloadEntry> getItems() {
         return items;
     }
 
+    /**
+     * WorkloadEntryList is a collection of WorkloadEntries.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.networking.v1alpha3.WorkloadEntry> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * WorkloadEntryList is a collection of WorkloadEntries.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * WorkloadEntryList is a collection of WorkloadEntries.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/WorkloadGroup.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/WorkloadGroup.java
index 69434dc40a9..13823a105c0 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/WorkloadGroup.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/WorkloadGroup.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * `WorkloadGroup` enables specifying the properties of a single workload for bootstrap and provides a template for `WorkloadEntry`, similar to how `Deployment` specifies properties of workloads via `Pod` templates. A `WorkloadGroup` can have more than one `WorkloadEntry`. `WorkloadGroup` has no relationship to resources which control service registry like `ServiceEntry` and as such doesn't configure host name for these workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class WorkloadGroup implements Editable<WorkloadGroupBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1alpha3";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "WorkloadGroup";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public WorkloadGroup(String apiVersion, String kind, ObjectMeta metadata, io.fab
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * `WorkloadGroup` enables specifying the properties of a single workload for bootstrap and provides a template for `WorkloadEntry`, similar to how `Deployment` specifies properties of workloads via `Pod` templates. A `WorkloadGroup` can have more than one `WorkloadEntry`. `WorkloadGroup` has no relationship to resources which control service registry like `ServiceEntry` and as such doesn't configure host name for these workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * `WorkloadGroup` enables specifying the properties of a single workload for bootstrap and provides a template for `WorkloadEntry`, similar to how `Deployment` specifies properties of workloads via `Pod` templates. A `WorkloadGroup` can have more than one `WorkloadEntry`. `WorkloadGroup` has no relationship to resources which control service registry like `ServiceEntry` and as such doesn't configure host name for these workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * `WorkloadGroup` enables specifying the properties of a single workload for bootstrap and provides a template for `WorkloadEntry`, similar to how `Deployment` specifies properties of workloads via `Pod` templates. A `WorkloadGroup` can have more than one `WorkloadEntry`. `WorkloadGroup` has no relationship to resources which control service registry like `ServiceEntry` and as such doesn't configure host name for these workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.networking.v1alpha3.WorkloadGroup getSpec() {
         return spec;
     }
 
+    /**
+     * `WorkloadGroup` enables specifying the properties of a single workload for bootstrap and provides a template for `WorkloadEntry`, similar to how `Deployment` specifies properties of workloads via `Pod` templates. A `WorkloadGroup` can have more than one `WorkloadEntry`. `WorkloadGroup` has no relationship to resources which control service registry like `ServiceEntry` and as such doesn't configure host name for these workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.networking.v1alpha3.WorkloadGroup spec) {
         this.spec = spec;
     }
 
+    /**
+     * `WorkloadGroup` enables specifying the properties of a single workload for bootstrap and provides a template for `WorkloadEntry`, similar to how `Deployment` specifies properties of workloads via `Pod` templates. A `WorkloadGroup` can have more than one `WorkloadEntry`. `WorkloadGroup` has no relationship to resources which control service registry like `ServiceEntry` and as such doesn't configure host name for these workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * `WorkloadGroup` enables specifying the properties of a single workload for bootstrap and provides a template for `WorkloadEntry`, similar to how `Deployment` specifies properties of workloads via `Pod` templates. A `WorkloadGroup` can have more than one `WorkloadEntry`. `WorkloadGroup` has no relationship to resources which control service registry like `ServiceEntry` and as such doesn't configure host name for these workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/WorkloadGroupList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/WorkloadGroupList.java
index 45d4c339edb..82fec7be4e6 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/WorkloadGroupList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1alpha3/WorkloadGroupList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WorkloadGroupList is a collection of WorkloadGroups.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class WorkloadGroupList implements Editable<WorkloadGroupListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.networking.v1alpha3.WorkloadGroup>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1alpha3";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.networking.v1alpha3.WorkloadGroup> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "WorkloadGroupList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public WorkloadGroupList(String apiVersion, List<io.fabric8.istio.api.networking
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * WorkloadGroupList is a collection of WorkloadGroups.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.networking.v1alpha3.WorkloadGroup> getItems() {
         return items;
     }
 
+    /**
+     * WorkloadGroupList is a collection of WorkloadGroups.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.networking.v1alpha3.WorkloadGroup> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * WorkloadGroupList is a collection of WorkloadGroups.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * WorkloadGroupList is a collection of WorkloadGroups.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/DestinationRule.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/DestinationRule.java
index b5195adea1d..b72cd81e31d 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/DestinationRule.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/DestinationRule.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DestinationRule defines policies that apply to traffic intended for a service after routing has occurred.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class DestinationRule implements Editable<DestinationRuleBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DestinationRule";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public DestinationRule(String apiVersion, String kind, ObjectMeta metadata, io.f
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DestinationRule defines policies that apply to traffic intended for a service after routing has occurred.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DestinationRule defines policies that apply to traffic intended for a service after routing has occurred.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * DestinationRule defines policies that apply to traffic intended for a service after routing has occurred.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.networking.v1alpha3.DestinationRule getSpec() {
         return spec;
     }
 
+    /**
+     * DestinationRule defines policies that apply to traffic intended for a service after routing has occurred.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.networking.v1alpha3.DestinationRule spec) {
         this.spec = spec;
     }
 
+    /**
+     * DestinationRule defines policies that apply to traffic intended for a service after routing has occurred.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * DestinationRule defines policies that apply to traffic intended for a service after routing has occurred.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/DestinationRuleList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/DestinationRuleList.java
index 32c2433a2e6..80d7c47554a 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/DestinationRuleList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/DestinationRuleList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DestinationRuleList is a collection of DestinationRules.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class DestinationRuleList implements Editable<DestinationRuleListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.networking.v1beta1.DestinationRule>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.networking.v1beta1.DestinationRule> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DestinationRuleList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DestinationRuleList(String apiVersion, List<io.fabric8.istio.api.networki
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * DestinationRuleList is a collection of DestinationRules.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.networking.v1beta1.DestinationRule> getItems() {
         return items;
     }
 
+    /**
+     * DestinationRuleList is a collection of DestinationRules.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.networking.v1beta1.DestinationRule> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DestinationRuleList is a collection of DestinationRules.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DestinationRuleList is a collection of DestinationRules.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/Gateway.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/Gateway.java
index 8eaf4ba4563..f6f8dc98177 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/Gateway.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/Gateway.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Gateway describes a load balancer operating at the edge of the mesh receiving incoming or outgoing HTTP/TCP connections.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class Gateway implements Editable<GatewayBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Gateway";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public Gateway(String apiVersion, String kind, ObjectMeta metadata, io.fabric8.i
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Gateway describes a load balancer operating at the edge of the mesh receiving incoming or outgoing HTTP/TCP connections.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Gateway describes a load balancer operating at the edge of the mesh receiving incoming or outgoing HTTP/TCP connections.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Gateway describes a load balancer operating at the edge of the mesh receiving incoming or outgoing HTTP/TCP connections.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.networking.v1alpha3.Gateway getSpec() {
         return spec;
     }
 
+    /**
+     * Gateway describes a load balancer operating at the edge of the mesh receiving incoming or outgoing HTTP/TCP connections.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.networking.v1alpha3.Gateway spec) {
         this.spec = spec;
     }
 
+    /**
+     * Gateway describes a load balancer operating at the edge of the mesh receiving incoming or outgoing HTTP/TCP connections.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * Gateway describes a load balancer operating at the edge of the mesh receiving incoming or outgoing HTTP/TCP connections.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/GatewayList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/GatewayList.java
index e960f80f8a9..ac5a2dcac60 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/GatewayList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/GatewayList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GatewayList is a collection of Gateways.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class GatewayList implements Editable<GatewayListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.networking.v1beta1.Gateway>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.networking.v1beta1.Gateway> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GatewayList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public GatewayList(String apiVersion, List<io.fabric8.istio.api.networking.v1bet
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * GatewayList is a collection of Gateways.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.networking.v1beta1.Gateway> getItems() {
         return items;
     }
 
+    /**
+     * GatewayList is a collection of Gateways.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.networking.v1beta1.Gateway> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * GatewayList is a collection of Gateways.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * GatewayList is a collection of Gateways.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/ProxyConfig.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/ProxyConfig.java
index b1fdab76427..da480e75cc2 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/ProxyConfig.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/ProxyConfig.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * `ProxyConfig` exposes proxy level configuration options.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class ProxyConfig implements Editable<ProxyConfigBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ProxyConfig";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public ProxyConfig(String apiVersion, String kind, ObjectMeta metadata, io.fabri
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * `ProxyConfig` exposes proxy level configuration options.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * `ProxyConfig` exposes proxy level configuration options.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * `ProxyConfig` exposes proxy level configuration options.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.networking.v1beta1.ProxyConfig getSpec() {
         return spec;
     }
 
+    /**
+     * `ProxyConfig` exposes proxy level configuration options.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.networking.v1beta1.ProxyConfig spec) {
         this.spec = spec;
     }
 
+    /**
+     * `ProxyConfig` exposes proxy level configuration options.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * `ProxyConfig` exposes proxy level configuration options.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/ProxyConfigList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/ProxyConfigList.java
index bc0023c09ef..3dc420d1c32 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/ProxyConfigList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/ProxyConfigList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ProxyConfigList is a collection of ProxyConfigs.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ProxyConfigList implements Editable<ProxyConfigListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.networking.v1beta1.ProxyConfig>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.networking.v1beta1.ProxyConfig> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ProxyConfigList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ProxyConfigList(String apiVersion, List<io.fabric8.istio.api.networking.v
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ProxyConfigList is a collection of ProxyConfigs.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.networking.v1beta1.ProxyConfig> getItems() {
         return items;
     }
 
+    /**
+     * ProxyConfigList is a collection of ProxyConfigs.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.networking.v1beta1.ProxyConfig> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ProxyConfigList is a collection of ProxyConfigs.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ProxyConfigList is a collection of ProxyConfigs.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/ServiceEntry.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/ServiceEntry.java
index 8b5840272ff..405fd47d09b 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/ServiceEntry.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/ServiceEntry.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceEntry enables adding additional entries into Istio's internal service registry.<br><p> <br><p> &lt;!-- crd generation tags mesh or part of the mesh (MESH_EXTERNAL or MESH_INTERNAL)" (NONE, STATIC, or DNS)" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags istiostatus-override: ServiceEntryStatus: istio.io/api/networking/v1alpha3 --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class ServiceEntry implements Editable<ServiceEntryBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ServiceEntry";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public ServiceEntry(String apiVersion, String kind, ObjectMeta metadata, io.fabr
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ServiceEntry enables adding additional entries into Istio's internal service registry.<br><p> <br><p> &lt;!-- crd generation tags mesh or part of the mesh (MESH_EXTERNAL or MESH_INTERNAL)" (NONE, STATIC, or DNS)" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags istiostatus-override: ServiceEntryStatus: istio.io/api/networking/v1alpha3 --&gt;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ServiceEntry enables adding additional entries into Istio's internal service registry.<br><p> <br><p> &lt;!-- crd generation tags mesh or part of the mesh (MESH_EXTERNAL or MESH_INTERNAL)" (NONE, STATIC, or DNS)" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags istiostatus-override: ServiceEntryStatus: istio.io/api/networking/v1alpha3 --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ServiceEntry enables adding additional entries into Istio's internal service registry.<br><p> <br><p> &lt;!-- crd generation tags mesh or part of the mesh (MESH_EXTERNAL or MESH_INTERNAL)" (NONE, STATIC, or DNS)" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags istiostatus-override: ServiceEntryStatus: istio.io/api/networking/v1alpha3 --&gt;
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.networking.v1alpha3.ServiceEntry getSpec() {
         return spec;
     }
 
+    /**
+     * ServiceEntry enables adding additional entries into Istio's internal service registry.<br><p> <br><p> &lt;!-- crd generation tags mesh or part of the mesh (MESH_EXTERNAL or MESH_INTERNAL)" (NONE, STATIC, or DNS)" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags istiostatus-override: ServiceEntryStatus: istio.io/api/networking/v1alpha3 --&gt;
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.networking.v1alpha3.ServiceEntry spec) {
         this.spec = spec;
     }
 
+    /**
+     * ServiceEntry enables adding additional entries into Istio's internal service registry.<br><p> <br><p> &lt;!-- crd generation tags mesh or part of the mesh (MESH_EXTERNAL or MESH_INTERNAL)" (NONE, STATIC, or DNS)" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags istiostatus-override: ServiceEntryStatus: istio.io/api/networking/v1alpha3 --&gt;
+     */
     @JsonProperty("status")
     public ServiceEntryStatus getStatus() {
         return status;
     }
 
+    /**
+     * ServiceEntry enables adding additional entries into Istio's internal service registry.<br><p> <br><p> &lt;!-- crd generation tags mesh or part of the mesh (MESH_EXTERNAL or MESH_INTERNAL)" (NONE, STATIC, or DNS)" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags istiostatus-override: ServiceEntryStatus: istio.io/api/networking/v1alpha3 --&gt;
+     */
     @JsonProperty("status")
     public void setStatus(ServiceEntryStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/ServiceEntryList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/ServiceEntryList.java
index 11f58016538..1c198dc1fd3 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/ServiceEntryList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/ServiceEntryList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceEntryList is a collection of ServiceEntries.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ServiceEntryList implements Editable<ServiceEntryListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.networking.v1beta1.ServiceEntry>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.networking.v1beta1.ServiceEntry> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ServiceEntryList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ServiceEntryList(String apiVersion, List<io.fabric8.istio.api.networking.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ServiceEntryList is a collection of ServiceEntries.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.networking.v1beta1.ServiceEntry> getItems() {
         return items;
     }
 
+    /**
+     * ServiceEntryList is a collection of ServiceEntries.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.networking.v1beta1.ServiceEntry> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ServiceEntryList is a collection of ServiceEntries.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ServiceEntryList is a collection of ServiceEntries.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/Sidecar.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/Sidecar.java
index f1434e47853..eeeafab0f45 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/Sidecar.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/Sidecar.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * `Sidecar` describes the configuration of the sidecar proxy that mediates inbound and outbound communication of the workload instance to which it is attached.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class Sidecar implements Editable<SidecarBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Sidecar";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public Sidecar(String apiVersion, String kind, ObjectMeta metadata, io.fabric8.i
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * `Sidecar` describes the configuration of the sidecar proxy that mediates inbound and outbound communication of the workload instance to which it is attached.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * `Sidecar` describes the configuration of the sidecar proxy that mediates inbound and outbound communication of the workload instance to which it is attached.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * `Sidecar` describes the configuration of the sidecar proxy that mediates inbound and outbound communication of the workload instance to which it is attached.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.networking.v1alpha3.Sidecar getSpec() {
         return spec;
     }
 
+    /**
+     * `Sidecar` describes the configuration of the sidecar proxy that mediates inbound and outbound communication of the workload instance to which it is attached.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.networking.v1alpha3.Sidecar spec) {
         this.spec = spec;
     }
 
+    /**
+     * `Sidecar` describes the configuration of the sidecar proxy that mediates inbound and outbound communication of the workload instance to which it is attached.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * `Sidecar` describes the configuration of the sidecar proxy that mediates inbound and outbound communication of the workload instance to which it is attached.<br><p> <br><p> &lt;!-- crd generation tags --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/SidecarList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/SidecarList.java
index 01161661684..3ef79495505 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/SidecarList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/SidecarList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SidecarList is a collection of Sidecars.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class SidecarList implements Editable<SidecarListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.networking.v1beta1.Sidecar>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.networking.v1beta1.Sidecar> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SidecarList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public SidecarList(String apiVersion, List<io.fabric8.istio.api.networking.v1bet
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * SidecarList is a collection of Sidecars.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.networking.v1beta1.Sidecar> getItems() {
         return items;
     }
 
+    /**
+     * SidecarList is a collection of Sidecars.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.networking.v1beta1.Sidecar> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SidecarList is a collection of Sidecars.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SidecarList is a collection of Sidecars.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/VirtualService.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/VirtualService.java
index bcea456ab8f..4848e4d2bd3 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/VirtualService.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/VirtualService.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Configuration affecting traffic routing.<br><p> <br><p> &lt;!-- crd generation tags that should apply these routes" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class VirtualService implements Editable<VirtualServiceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VirtualService";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public VirtualService(String apiVersion, String kind, ObjectMeta metadata, io.fa
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Configuration affecting traffic routing.<br><p> <br><p> &lt;!-- crd generation tags that should apply these routes" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Configuration affecting traffic routing.<br><p> <br><p> &lt;!-- crd generation tags that should apply these routes" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Configuration affecting traffic routing.<br><p> <br><p> &lt;!-- crd generation tags that should apply these routes" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.networking.v1alpha3.VirtualService getSpec() {
         return spec;
     }
 
+    /**
+     * Configuration affecting traffic routing.<br><p> <br><p> &lt;!-- crd generation tags that should apply these routes" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.networking.v1alpha3.VirtualService spec) {
         this.spec = spec;
     }
 
+    /**
+     * Configuration affecting traffic routing.<br><p> <br><p> &lt;!-- crd generation tags that should apply these routes" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * Configuration affecting traffic routing.<br><p> <br><p> &lt;!-- crd generation tags that should apply these routes" representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/VirtualServiceList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/VirtualServiceList.java
index 96977a8028f..00a78514d40 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/VirtualServiceList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/VirtualServiceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VirtualServiceList is a collection of VirtualServices.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class VirtualServiceList implements Editable<VirtualServiceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.networking.v1beta1.VirtualService>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.networking.v1beta1.VirtualService> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VirtualServiceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public VirtualServiceList(String apiVersion, List<io.fabric8.istio.api.networkin
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * VirtualServiceList is a collection of VirtualServices.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.networking.v1beta1.VirtualService> getItems() {
         return items;
     }
 
+    /**
+     * VirtualServiceList is a collection of VirtualServices.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.networking.v1beta1.VirtualService> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VirtualServiceList is a collection of VirtualServices.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VirtualServiceList is a collection of VirtualServices.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/WorkloadEntry.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/WorkloadEntry.java
index 475a2ff855b..52c7bfefbf0 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/WorkloadEntry.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/WorkloadEntry.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WorkloadEntry enables specifying the properties of a single non-Kubernetes workload such a VM or a bare metal services that can be referred to by service entries.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class WorkloadEntry implements Editable<WorkloadEntryBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "WorkloadEntry";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public WorkloadEntry(String apiVersion, String kind, ObjectMeta metadata, io.fab
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * WorkloadEntry enables specifying the properties of a single non-Kubernetes workload such a VM or a bare metal services that can be referred to by service entries.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * WorkloadEntry enables specifying the properties of a single non-Kubernetes workload such a VM or a bare metal services that can be referred to by service entries.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * WorkloadEntry enables specifying the properties of a single non-Kubernetes workload such a VM or a bare metal services that can be referred to by service entries.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.networking.v1alpha3.WorkloadEntry getSpec() {
         return spec;
     }
 
+    /**
+     * WorkloadEntry enables specifying the properties of a single non-Kubernetes workload such a VM or a bare metal services that can be referred to by service entries.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.networking.v1alpha3.WorkloadEntry spec) {
         this.spec = spec;
     }
 
+    /**
+     * WorkloadEntry enables specifying the properties of a single non-Kubernetes workload such a VM or a bare metal services that can be referred to by service entries.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * WorkloadEntry enables specifying the properties of a single non-Kubernetes workload such a VM or a bare metal services that can be referred to by service entries.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/WorkloadEntryList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/WorkloadEntryList.java
index 01f3eb745e0..98f1578b1d7 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/WorkloadEntryList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/WorkloadEntryList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WorkloadEntryList is a collection of WorkloadEntries.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class WorkloadEntryList implements Editable<WorkloadEntryListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.networking.v1beta1.WorkloadEntry>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.networking.v1beta1.WorkloadEntry> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "WorkloadEntryList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public WorkloadEntryList(String apiVersion, List<io.fabric8.istio.api.networking
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * WorkloadEntryList is a collection of WorkloadEntries.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.networking.v1beta1.WorkloadEntry> getItems() {
         return items;
     }
 
+    /**
+     * WorkloadEntryList is a collection of WorkloadEntries.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.networking.v1beta1.WorkloadEntry> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * WorkloadEntryList is a collection of WorkloadEntries.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * WorkloadEntryList is a collection of WorkloadEntries.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/WorkloadGroup.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/WorkloadGroup.java
index 28d95a1b21e..ce08075fa7e 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/WorkloadGroup.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/WorkloadGroup.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * `WorkloadGroup` enables specifying the properties of a single workload for bootstrap and provides a template for `WorkloadEntry`, similar to how `Deployment` specifies properties of workloads via `Pod` templates. A `WorkloadGroup` can have more than one `WorkloadEntry`. `WorkloadGroup` has no relationship to resources which control service registry like `ServiceEntry` and as such doesn't configure host name for these workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class WorkloadGroup implements Editable<WorkloadGroupBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "WorkloadGroup";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public WorkloadGroup(String apiVersion, String kind, ObjectMeta metadata, io.fab
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * `WorkloadGroup` enables specifying the properties of a single workload for bootstrap and provides a template for `WorkloadEntry`, similar to how `Deployment` specifies properties of workloads via `Pod` templates. A `WorkloadGroup` can have more than one `WorkloadEntry`. `WorkloadGroup` has no relationship to resources which control service registry like `ServiceEntry` and as such doesn't configure host name for these workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * `WorkloadGroup` enables specifying the properties of a single workload for bootstrap and provides a template for `WorkloadEntry`, similar to how `Deployment` specifies properties of workloads via `Pod` templates. A `WorkloadGroup` can have more than one `WorkloadEntry`. `WorkloadGroup` has no relationship to resources which control service registry like `ServiceEntry` and as such doesn't configure host name for these workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * `WorkloadGroup` enables specifying the properties of a single workload for bootstrap and provides a template for `WorkloadEntry`, similar to how `Deployment` specifies properties of workloads via `Pod` templates. A `WorkloadGroup` can have more than one `WorkloadEntry`. `WorkloadGroup` has no relationship to resources which control service registry like `ServiceEntry` and as such doesn't configure host name for these workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.networking.v1alpha3.WorkloadGroup getSpec() {
         return spec;
     }
 
+    /**
+     * `WorkloadGroup` enables specifying the properties of a single workload for bootstrap and provides a template for `WorkloadEntry`, similar to how `Deployment` specifies properties of workloads via `Pod` templates. A `WorkloadGroup` can have more than one `WorkloadEntry`. `WorkloadGroup` has no relationship to resources which control service registry like `ServiceEntry` and as such doesn't configure host name for these workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.networking.v1alpha3.WorkloadGroup spec) {
         this.spec = spec;
     }
 
+    /**
+     * `WorkloadGroup` enables specifying the properties of a single workload for bootstrap and provides a template for `WorkloadEntry`, similar to how `Deployment` specifies properties of workloads via `Pod` templates. A `WorkloadGroup` can have more than one `WorkloadEntry`. `WorkloadGroup` has no relationship to resources which control service registry like `ServiceEntry` and as such doesn't configure host name for these workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * `WorkloadGroup` enables specifying the properties of a single workload for bootstrap and provides a template for `WorkloadEntry`, similar to how `Deployment` specifies properties of workloads via `Pod` templates. A `WorkloadGroup` can have more than one `WorkloadEntry`. `WorkloadGroup` has no relationship to resources which control service registry like `ServiceEntry` and as such doesn't configure host name for these workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/WorkloadGroupList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/WorkloadGroupList.java
index fb51c4916e3..9e803b23ba5 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/WorkloadGroupList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/networking/v1beta1/WorkloadGroupList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WorkloadGroupList is a collection of WorkloadGroups.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class WorkloadGroupList implements Editable<WorkloadGroupListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.networking.v1beta1.WorkloadGroup>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.istio.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.networking.v1beta1.WorkloadGroup> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "WorkloadGroupList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public WorkloadGroupList(String apiVersion, List<io.fabric8.istio.api.networking
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * WorkloadGroupList is a collection of WorkloadGroups.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.networking.v1beta1.WorkloadGroup> getItems() {
         return items;
     }
 
+    /**
+     * WorkloadGroupList is a collection of WorkloadGroups.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.networking.v1beta1.WorkloadGroup> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * WorkloadGroupList is a collection of WorkloadGroups.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * WorkloadGroupList is a collection of WorkloadGroups.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1/AuthorizationPolicy.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1/AuthorizationPolicy.java
index 0612175607c..785305ef222 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1/AuthorizationPolicy.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1/AuthorizationPolicy.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AuthorizationPolicy enables access control on workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class AuthorizationPolicy implements Editable<AuthorizationPolicyBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "security.istio.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AuthorizationPolicy";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public AuthorizationPolicy(String apiVersion, String kind, ObjectMeta metadata,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AuthorizationPolicy enables access control on workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AuthorizationPolicy enables access control on workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * AuthorizationPolicy enables access control on workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.security.v1beta1.AuthorizationPolicy getSpec() {
         return spec;
     }
 
+    /**
+     * AuthorizationPolicy enables access control on workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.security.v1beta1.AuthorizationPolicy spec) {
         this.spec = spec;
     }
 
+    /**
+     * AuthorizationPolicy enables access control on workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * AuthorizationPolicy enables access control on workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1/AuthorizationPolicyList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1/AuthorizationPolicyList.java
index 6c36797f31c..47b660fa0de 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1/AuthorizationPolicyList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1/AuthorizationPolicyList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AuthorizationPolicyList is a collection of AuthorizationPolicies.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class AuthorizationPolicyList implements Editable<AuthorizationPolicyListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.security.v1.AuthorizationPolicy>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "security.istio.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.security.v1.AuthorizationPolicy> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AuthorizationPolicyList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public AuthorizationPolicyList(String apiVersion, List<io.fabric8.istio.api.secu
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * AuthorizationPolicyList is a collection of AuthorizationPolicies.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.security.v1.AuthorizationPolicy> getItems() {
         return items;
     }
 
+    /**
+     * AuthorizationPolicyList is a collection of AuthorizationPolicies.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.security.v1.AuthorizationPolicy> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AuthorizationPolicyList is a collection of AuthorizationPolicies.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AuthorizationPolicyList is a collection of AuthorizationPolicies.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1/PeerAuthentication.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1/PeerAuthentication.java
index 81e9b19d0e8..d3c098d73bf 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1/PeerAuthentication.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1/PeerAuthentication.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PeerAuthentication defines mutual TLS (mTLS) requirements for incoming connections.<br><p> <br><p> In sidecar mode, PeerAuthentication determines whether or not mTLS is allowed or required for connections to an Envoy proxy sidecar.<br><p> <br><p> In ambient mode, security is transparently enabled for a pod by the ztunnel node agent. (Traffic between proxies uses the HBONE protocol, which includes encryption with mTLS.) Because of this, `DISABLE` mode is not supported. `STRICT` mode is useful to ensure that connections that bypass the mesh are not possible.<br><p> <br><p> Examples:<br><p> <br><p> Policy to require mTLS traffic for all workloads under namespace `foo`: ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: STRICT<br><p> <br><p> ``` For mesh level, put the policy in root-namespace according to your Istio installation.<br><p> <br><p> Policies to allow both mTLS and plaintext traffic for all workloads under namespace `foo`, but require mTLS for workload `finance`. ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: PERMISSIVE
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class PeerAuthentication implements Editable<PeerAuthenticationBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "security.istio.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PeerAuthentication";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public PeerAuthentication(String apiVersion, String kind, ObjectMeta metadata, i
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PeerAuthentication defines mutual TLS (mTLS) requirements for incoming connections.<br><p> <br><p> In sidecar mode, PeerAuthentication determines whether or not mTLS is allowed or required for connections to an Envoy proxy sidecar.<br><p> <br><p> In ambient mode, security is transparently enabled for a pod by the ztunnel node agent. (Traffic between proxies uses the HBONE protocol, which includes encryption with mTLS.) Because of this, `DISABLE` mode is not supported. `STRICT` mode is useful to ensure that connections that bypass the mesh are not possible.<br><p> <br><p> Examples:<br><p> <br><p> Policy to require mTLS traffic for all workloads under namespace `foo`: ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: STRICT<br><p> <br><p> ``` For mesh level, put the policy in root-namespace according to your Istio installation.<br><p> <br><p> Policies to allow both mTLS and plaintext traffic for all workloads under namespace `foo`, but require mTLS for workload `finance`. ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: PERMISSIVE
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PeerAuthentication defines mutual TLS (mTLS) requirements for incoming connections.<br><p> <br><p> In sidecar mode, PeerAuthentication determines whether or not mTLS is allowed or required for connections to an Envoy proxy sidecar.<br><p> <br><p> In ambient mode, security is transparently enabled for a pod by the ztunnel node agent. (Traffic between proxies uses the HBONE protocol, which includes encryption with mTLS.) Because of this, `DISABLE` mode is not supported. `STRICT` mode is useful to ensure that connections that bypass the mesh are not possible.<br><p> <br><p> Examples:<br><p> <br><p> Policy to require mTLS traffic for all workloads under namespace `foo`: ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: STRICT<br><p> <br><p> ``` For mesh level, put the policy in root-namespace according to your Istio installation.<br><p> <br><p> Policies to allow both mTLS and plaintext traffic for all workloads under namespace `foo`, but require mTLS for workload `finance`. ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: PERMISSIVE
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PeerAuthentication defines mutual TLS (mTLS) requirements for incoming connections.<br><p> <br><p> In sidecar mode, PeerAuthentication determines whether or not mTLS is allowed or required for connections to an Envoy proxy sidecar.<br><p> <br><p> In ambient mode, security is transparently enabled for a pod by the ztunnel node agent. (Traffic between proxies uses the HBONE protocol, which includes encryption with mTLS.) Because of this, `DISABLE` mode is not supported. `STRICT` mode is useful to ensure that connections that bypass the mesh are not possible.<br><p> <br><p> Examples:<br><p> <br><p> Policy to require mTLS traffic for all workloads under namespace `foo`: ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: STRICT<br><p> <br><p> ``` For mesh level, put the policy in root-namespace according to your Istio installation.<br><p> <br><p> Policies to allow both mTLS and plaintext traffic for all workloads under namespace `foo`, but require mTLS for workload `finance`. ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: PERMISSIVE
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.security.v1beta1.PeerAuthentication getSpec() {
         return spec;
     }
 
+    /**
+     * PeerAuthentication defines mutual TLS (mTLS) requirements for incoming connections.<br><p> <br><p> In sidecar mode, PeerAuthentication determines whether or not mTLS is allowed or required for connections to an Envoy proxy sidecar.<br><p> <br><p> In ambient mode, security is transparently enabled for a pod by the ztunnel node agent. (Traffic between proxies uses the HBONE protocol, which includes encryption with mTLS.) Because of this, `DISABLE` mode is not supported. `STRICT` mode is useful to ensure that connections that bypass the mesh are not possible.<br><p> <br><p> Examples:<br><p> <br><p> Policy to require mTLS traffic for all workloads under namespace `foo`: ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: STRICT<br><p> <br><p> ``` For mesh level, put the policy in root-namespace according to your Istio installation.<br><p> <br><p> Policies to allow both mTLS and plaintext traffic for all workloads under namespace `foo`, but require mTLS for workload `finance`. ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: PERMISSIVE
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.security.v1beta1.PeerAuthentication spec) {
         this.spec = spec;
     }
 
+    /**
+     * PeerAuthentication defines mutual TLS (mTLS) requirements for incoming connections.<br><p> <br><p> In sidecar mode, PeerAuthentication determines whether or not mTLS is allowed or required for connections to an Envoy proxy sidecar.<br><p> <br><p> In ambient mode, security is transparently enabled for a pod by the ztunnel node agent. (Traffic between proxies uses the HBONE protocol, which includes encryption with mTLS.) Because of this, `DISABLE` mode is not supported. `STRICT` mode is useful to ensure that connections that bypass the mesh are not possible.<br><p> <br><p> Examples:<br><p> <br><p> Policy to require mTLS traffic for all workloads under namespace `foo`: ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: STRICT<br><p> <br><p> ``` For mesh level, put the policy in root-namespace according to your Istio installation.<br><p> <br><p> Policies to allow both mTLS and plaintext traffic for all workloads under namespace `foo`, but require mTLS for workload `finance`. ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: PERMISSIVE
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * PeerAuthentication defines mutual TLS (mTLS) requirements for incoming connections.<br><p> <br><p> In sidecar mode, PeerAuthentication determines whether or not mTLS is allowed or required for connections to an Envoy proxy sidecar.<br><p> <br><p> In ambient mode, security is transparently enabled for a pod by the ztunnel node agent. (Traffic between proxies uses the HBONE protocol, which includes encryption with mTLS.) Because of this, `DISABLE` mode is not supported. `STRICT` mode is useful to ensure that connections that bypass the mesh are not possible.<br><p> <br><p> Examples:<br><p> <br><p> Policy to require mTLS traffic for all workloads under namespace `foo`: ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: STRICT<br><p> <br><p> ``` For mesh level, put the policy in root-namespace according to your Istio installation.<br><p> <br><p> Policies to allow both mTLS and plaintext traffic for all workloads under namespace `foo`, but require mTLS for workload `finance`. ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: PERMISSIVE
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1/PeerAuthenticationList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1/PeerAuthenticationList.java
index a7c05d40ddb..330932a883b 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1/PeerAuthenticationList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1/PeerAuthenticationList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PeerAuthenticationList is a collection of PeerAuthentications.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PeerAuthenticationList implements Editable<PeerAuthenticationListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.security.v1.PeerAuthentication>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "security.istio.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.security.v1.PeerAuthentication> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PeerAuthenticationList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PeerAuthenticationList(String apiVersion, List<io.fabric8.istio.api.secur
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PeerAuthenticationList is a collection of PeerAuthentications.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.security.v1.PeerAuthentication> getItems() {
         return items;
     }
 
+    /**
+     * PeerAuthenticationList is a collection of PeerAuthentications.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.security.v1.PeerAuthentication> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PeerAuthenticationList is a collection of PeerAuthentications.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PeerAuthenticationList is a collection of PeerAuthentications.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1/RequestAuthentication.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1/RequestAuthentication.java
index bda292e6c36..47292d71e68 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1/RequestAuthentication.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1/RequestAuthentication.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RequestAuthentication defines what request authentication methods are supported by a workload. It will reject a request if the request contains invalid authentication information, based on the configured authentication rules. A request that does not contain any authentication credentials will be accepted but will not have any authenticated identity. To restrict access to authenticated requests only, this should be accompanied by an authorization rule. Examples:<br><p> <br><p> - Require JWT for all request for workloads that have label `app:httpbin`<br><p> <br><p> ```yaml apiVersion: security.istio.io/v1 kind: RequestAuthentication metadata:<br><p> <br><p> 	name: httpbin<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  matchLabels:<br><p> 	    app: httpbin<br><p> 	jwtRules:<br><p> 	- issuer: "issuer-foo"<br><p> 	  jwksUri: https://example.com/.well-known/jwks.json
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class RequestAuthentication implements Editable<RequestAuthenticationBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "security.istio.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "RequestAuthentication";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public RequestAuthentication(String apiVersion, String kind, ObjectMeta metadata
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RequestAuthentication defines what request authentication methods are supported by a workload. It will reject a request if the request contains invalid authentication information, based on the configured authentication rules. A request that does not contain any authentication credentials will be accepted but will not have any authenticated identity. To restrict access to authenticated requests only, this should be accompanied by an authorization rule. Examples:<br><p> <br><p> - Require JWT for all request for workloads that have label `app:httpbin`<br><p> <br><p> ```yaml apiVersion: security.istio.io/v1 kind: RequestAuthentication metadata:<br><p> <br><p> 	name: httpbin<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  matchLabels:<br><p> 	    app: httpbin<br><p> 	jwtRules:<br><p> 	- issuer: "issuer-foo"<br><p> 	  jwksUri: https://example.com/.well-known/jwks.json
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RequestAuthentication defines what request authentication methods are supported by a workload. It will reject a request if the request contains invalid authentication information, based on the configured authentication rules. A request that does not contain any authentication credentials will be accepted but will not have any authenticated identity. To restrict access to authenticated requests only, this should be accompanied by an authorization rule. Examples:<br><p> <br><p> - Require JWT for all request for workloads that have label `app:httpbin`<br><p> <br><p> ```yaml apiVersion: security.istio.io/v1 kind: RequestAuthentication metadata:<br><p> <br><p> 	name: httpbin<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  matchLabels:<br><p> 	    app: httpbin<br><p> 	jwtRules:<br><p> 	- issuer: "issuer-foo"<br><p> 	  jwksUri: https://example.com/.well-known/jwks.json
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * RequestAuthentication defines what request authentication methods are supported by a workload. It will reject a request if the request contains invalid authentication information, based on the configured authentication rules. A request that does not contain any authentication credentials will be accepted but will not have any authenticated identity. To restrict access to authenticated requests only, this should be accompanied by an authorization rule. Examples:<br><p> <br><p> - Require JWT for all request for workloads that have label `app:httpbin`<br><p> <br><p> ```yaml apiVersion: security.istio.io/v1 kind: RequestAuthentication metadata:<br><p> <br><p> 	name: httpbin<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  matchLabels:<br><p> 	    app: httpbin<br><p> 	jwtRules:<br><p> 	- issuer: "issuer-foo"<br><p> 	  jwksUri: https://example.com/.well-known/jwks.json
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.security.v1beta1.RequestAuthentication getSpec() {
         return spec;
     }
 
+    /**
+     * RequestAuthentication defines what request authentication methods are supported by a workload. It will reject a request if the request contains invalid authentication information, based on the configured authentication rules. A request that does not contain any authentication credentials will be accepted but will not have any authenticated identity. To restrict access to authenticated requests only, this should be accompanied by an authorization rule. Examples:<br><p> <br><p> - Require JWT for all request for workloads that have label `app:httpbin`<br><p> <br><p> ```yaml apiVersion: security.istio.io/v1 kind: RequestAuthentication metadata:<br><p> <br><p> 	name: httpbin<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  matchLabels:<br><p> 	    app: httpbin<br><p> 	jwtRules:<br><p> 	- issuer: "issuer-foo"<br><p> 	  jwksUri: https://example.com/.well-known/jwks.json
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.security.v1beta1.RequestAuthentication spec) {
         this.spec = spec;
     }
 
+    /**
+     * RequestAuthentication defines what request authentication methods are supported by a workload. It will reject a request if the request contains invalid authentication information, based on the configured authentication rules. A request that does not contain any authentication credentials will be accepted but will not have any authenticated identity. To restrict access to authenticated requests only, this should be accompanied by an authorization rule. Examples:<br><p> <br><p> - Require JWT for all request for workloads that have label `app:httpbin`<br><p> <br><p> ```yaml apiVersion: security.istio.io/v1 kind: RequestAuthentication metadata:<br><p> <br><p> 	name: httpbin<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  matchLabels:<br><p> 	    app: httpbin<br><p> 	jwtRules:<br><p> 	- issuer: "issuer-foo"<br><p> 	  jwksUri: https://example.com/.well-known/jwks.json
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * RequestAuthentication defines what request authentication methods are supported by a workload. It will reject a request if the request contains invalid authentication information, based on the configured authentication rules. A request that does not contain any authentication credentials will be accepted but will not have any authenticated identity. To restrict access to authenticated requests only, this should be accompanied by an authorization rule. Examples:<br><p> <br><p> - Require JWT for all request for workloads that have label `app:httpbin`<br><p> <br><p> ```yaml apiVersion: security.istio.io/v1 kind: RequestAuthentication metadata:<br><p> <br><p> 	name: httpbin<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  matchLabels:<br><p> 	    app: httpbin<br><p> 	jwtRules:<br><p> 	- issuer: "issuer-foo"<br><p> 	  jwksUri: https://example.com/.well-known/jwks.json
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1/RequestAuthenticationList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1/RequestAuthenticationList.java
index ac44a127123..a52247ef021 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1/RequestAuthenticationList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1/RequestAuthenticationList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RequestAuthenticationList is a collection of RequestAuthentications.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class RequestAuthenticationList implements Editable<RequestAuthenticationListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.security.v1.RequestAuthentication>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "security.istio.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.security.v1.RequestAuthentication> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "RequestAuthenticationList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public RequestAuthenticationList(String apiVersion, List<io.fabric8.istio.api.se
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * RequestAuthenticationList is a collection of RequestAuthentications.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.security.v1.RequestAuthentication> getItems() {
         return items;
     }
 
+    /**
+     * RequestAuthenticationList is a collection of RequestAuthentications.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.security.v1.RequestAuthentication> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RequestAuthenticationList is a collection of RequestAuthentications.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RequestAuthenticationList is a collection of RequestAuthentications.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1beta1/AuthorizationPolicy.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1beta1/AuthorizationPolicy.java
index d16567be314..f4c36112942 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1beta1/AuthorizationPolicy.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1beta1/AuthorizationPolicy.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AuthorizationPolicy enables access control on workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class AuthorizationPolicy implements Editable<AuthorizationPolicyBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "security.istio.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AuthorizationPolicy";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public AuthorizationPolicy(String apiVersion, String kind, ObjectMeta metadata,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AuthorizationPolicy enables access control on workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AuthorizationPolicy enables access control on workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * AuthorizationPolicy enables access control on workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.security.v1beta1.AuthorizationPolicy getSpec() {
         return spec;
     }
 
+    /**
+     * AuthorizationPolicy enables access control on workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.security.v1beta1.AuthorizationPolicy spec) {
         this.spec = spec;
     }
 
+    /**
+     * AuthorizationPolicy enables access control on workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * AuthorizationPolicy enables access control on workloads.<br><p> <br><p> &lt;!-- crd generation tags representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1beta1/AuthorizationPolicyList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1beta1/AuthorizationPolicyList.java
index 17f3ddaef8e..08de51acc52 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1beta1/AuthorizationPolicyList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1beta1/AuthorizationPolicyList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AuthorizationPolicyList is a collection of AuthorizationPolicies.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class AuthorizationPolicyList implements Editable<AuthorizationPolicyListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.security.v1beta1.AuthorizationPolicy>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "security.istio.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.security.v1beta1.AuthorizationPolicy> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AuthorizationPolicyList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public AuthorizationPolicyList(String apiVersion, List<io.fabric8.istio.api.secu
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * AuthorizationPolicyList is a collection of AuthorizationPolicies.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.security.v1beta1.AuthorizationPolicy> getItems() {
         return items;
     }
 
+    /**
+     * AuthorizationPolicyList is a collection of AuthorizationPolicies.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.security.v1beta1.AuthorizationPolicy> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AuthorizationPolicyList is a collection of AuthorizationPolicies.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AuthorizationPolicyList is a collection of AuthorizationPolicies.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1beta1/PeerAuthentication.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1beta1/PeerAuthentication.java
index 9be3933a22c..4ed7235c680 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1beta1/PeerAuthentication.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1beta1/PeerAuthentication.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PeerAuthentication defines mutual TLS (mTLS) requirements for incoming connections.<br><p> <br><p> In sidecar mode, PeerAuthentication determines whether or not mTLS is allowed or required for connections to an Envoy proxy sidecar.<br><p> <br><p> In ambient mode, security is transparently enabled for a pod by the ztunnel node agent. (Traffic between proxies uses the HBONE protocol, which includes encryption with mTLS.) Because of this, `DISABLE` mode is not supported. `STRICT` mode is useful to ensure that connections that bypass the mesh are not possible.<br><p> <br><p> Examples:<br><p> <br><p> Policy to require mTLS traffic for all workloads under namespace `foo`: ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: STRICT<br><p> <br><p> ``` For mesh level, put the policy in root-namespace according to your Istio installation.<br><p> <br><p> Policies to allow both mTLS and plaintext traffic for all workloads under namespace `foo`, but require mTLS for workload `finance`. ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: PERMISSIVE
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class PeerAuthentication implements Editable<PeerAuthenticationBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "security.istio.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PeerAuthentication";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public PeerAuthentication(String apiVersion, String kind, ObjectMeta metadata, i
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PeerAuthentication defines mutual TLS (mTLS) requirements for incoming connections.<br><p> <br><p> In sidecar mode, PeerAuthentication determines whether or not mTLS is allowed or required for connections to an Envoy proxy sidecar.<br><p> <br><p> In ambient mode, security is transparently enabled for a pod by the ztunnel node agent. (Traffic between proxies uses the HBONE protocol, which includes encryption with mTLS.) Because of this, `DISABLE` mode is not supported. `STRICT` mode is useful to ensure that connections that bypass the mesh are not possible.<br><p> <br><p> Examples:<br><p> <br><p> Policy to require mTLS traffic for all workloads under namespace `foo`: ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: STRICT<br><p> <br><p> ``` For mesh level, put the policy in root-namespace according to your Istio installation.<br><p> <br><p> Policies to allow both mTLS and plaintext traffic for all workloads under namespace `foo`, but require mTLS for workload `finance`. ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: PERMISSIVE
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PeerAuthentication defines mutual TLS (mTLS) requirements for incoming connections.<br><p> <br><p> In sidecar mode, PeerAuthentication determines whether or not mTLS is allowed or required for connections to an Envoy proxy sidecar.<br><p> <br><p> In ambient mode, security is transparently enabled for a pod by the ztunnel node agent. (Traffic between proxies uses the HBONE protocol, which includes encryption with mTLS.) Because of this, `DISABLE` mode is not supported. `STRICT` mode is useful to ensure that connections that bypass the mesh are not possible.<br><p> <br><p> Examples:<br><p> <br><p> Policy to require mTLS traffic for all workloads under namespace `foo`: ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: STRICT<br><p> <br><p> ``` For mesh level, put the policy in root-namespace according to your Istio installation.<br><p> <br><p> Policies to allow both mTLS and plaintext traffic for all workloads under namespace `foo`, but require mTLS for workload `finance`. ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: PERMISSIVE
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PeerAuthentication defines mutual TLS (mTLS) requirements for incoming connections.<br><p> <br><p> In sidecar mode, PeerAuthentication determines whether or not mTLS is allowed or required for connections to an Envoy proxy sidecar.<br><p> <br><p> In ambient mode, security is transparently enabled for a pod by the ztunnel node agent. (Traffic between proxies uses the HBONE protocol, which includes encryption with mTLS.) Because of this, `DISABLE` mode is not supported. `STRICT` mode is useful to ensure that connections that bypass the mesh are not possible.<br><p> <br><p> Examples:<br><p> <br><p> Policy to require mTLS traffic for all workloads under namespace `foo`: ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: STRICT<br><p> <br><p> ``` For mesh level, put the policy in root-namespace according to your Istio installation.<br><p> <br><p> Policies to allow both mTLS and plaintext traffic for all workloads under namespace `foo`, but require mTLS for workload `finance`. ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: PERMISSIVE
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.security.v1beta1.PeerAuthentication getSpec() {
         return spec;
     }
 
+    /**
+     * PeerAuthentication defines mutual TLS (mTLS) requirements for incoming connections.<br><p> <br><p> In sidecar mode, PeerAuthentication determines whether or not mTLS is allowed or required for connections to an Envoy proxy sidecar.<br><p> <br><p> In ambient mode, security is transparently enabled for a pod by the ztunnel node agent. (Traffic between proxies uses the HBONE protocol, which includes encryption with mTLS.) Because of this, `DISABLE` mode is not supported. `STRICT` mode is useful to ensure that connections that bypass the mesh are not possible.<br><p> <br><p> Examples:<br><p> <br><p> Policy to require mTLS traffic for all workloads under namespace `foo`: ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: STRICT<br><p> <br><p> ``` For mesh level, put the policy in root-namespace according to your Istio installation.<br><p> <br><p> Policies to allow both mTLS and plaintext traffic for all workloads under namespace `foo`, but require mTLS for workload `finance`. ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: PERMISSIVE
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.security.v1beta1.PeerAuthentication spec) {
         this.spec = spec;
     }
 
+    /**
+     * PeerAuthentication defines mutual TLS (mTLS) requirements for incoming connections.<br><p> <br><p> In sidecar mode, PeerAuthentication determines whether or not mTLS is allowed or required for connections to an Envoy proxy sidecar.<br><p> <br><p> In ambient mode, security is transparently enabled for a pod by the ztunnel node agent. (Traffic between proxies uses the HBONE protocol, which includes encryption with mTLS.) Because of this, `DISABLE` mode is not supported. `STRICT` mode is useful to ensure that connections that bypass the mesh are not possible.<br><p> <br><p> Examples:<br><p> <br><p> Policy to require mTLS traffic for all workloads under namespace `foo`: ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: STRICT<br><p> <br><p> ``` For mesh level, put the policy in root-namespace according to your Istio installation.<br><p> <br><p> Policies to allow both mTLS and plaintext traffic for all workloads under namespace `foo`, but require mTLS for workload `finance`. ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: PERMISSIVE
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * PeerAuthentication defines mutual TLS (mTLS) requirements for incoming connections.<br><p> <br><p> In sidecar mode, PeerAuthentication determines whether or not mTLS is allowed or required for connections to an Envoy proxy sidecar.<br><p> <br><p> In ambient mode, security is transparently enabled for a pod by the ztunnel node agent. (Traffic between proxies uses the HBONE protocol, which includes encryption with mTLS.) Because of this, `DISABLE` mode is not supported. `STRICT` mode is useful to ensure that connections that bypass the mesh are not possible.<br><p> <br><p> Examples:<br><p> <br><p> Policy to require mTLS traffic for all workloads under namespace `foo`: ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: STRICT<br><p> <br><p> ``` For mesh level, put the policy in root-namespace according to your Istio installation.<br><p> <br><p> Policies to allow both mTLS and plaintext traffic for all workloads under namespace `foo`, but require mTLS for workload `finance`. ```yaml apiVersion: security.istio.io/v1 kind: PeerAuthentication metadata:<br><p> <br><p> 	name: default<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	mtls:<br><p> 	  mode: PERMISSIVE
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1beta1/PeerAuthenticationList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1beta1/PeerAuthenticationList.java
index bab62d5feb1..21d73c16688 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1beta1/PeerAuthenticationList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1beta1/PeerAuthenticationList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PeerAuthenticationList is a collection of PeerAuthentications.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PeerAuthenticationList implements Editable<PeerAuthenticationListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.security.v1beta1.PeerAuthentication>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "security.istio.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.security.v1beta1.PeerAuthentication> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PeerAuthenticationList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PeerAuthenticationList(String apiVersion, List<io.fabric8.istio.api.secur
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PeerAuthenticationList is a collection of PeerAuthentications.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.security.v1beta1.PeerAuthentication> getItems() {
         return items;
     }
 
+    /**
+     * PeerAuthenticationList is a collection of PeerAuthentications.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.security.v1beta1.PeerAuthentication> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PeerAuthenticationList is a collection of PeerAuthentications.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PeerAuthenticationList is a collection of PeerAuthentications.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1beta1/RequestAuthentication.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1beta1/RequestAuthentication.java
index 8a44c27baa5..00de2e45bcd 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1beta1/RequestAuthentication.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1beta1/RequestAuthentication.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RequestAuthentication defines what request authentication methods are supported by a workload. It will reject a request if the request contains invalid authentication information, based on the configured authentication rules. A request that does not contain any authentication credentials will be accepted but will not have any authenticated identity. To restrict access to authenticated requests only, this should be accompanied by an authorization rule. Examples:<br><p> <br><p> - Require JWT for all request for workloads that have label `app:httpbin`<br><p> <br><p> ```yaml apiVersion: security.istio.io/v1 kind: RequestAuthentication metadata:<br><p> <br><p> 	name: httpbin<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  matchLabels:<br><p> 	    app: httpbin<br><p> 	jwtRules:<br><p> 	- issuer: "issuer-foo"<br><p> 	  jwksUri: https://example.com/.well-known/jwks.json
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class RequestAuthentication implements Editable<RequestAuthenticationBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "security.istio.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "RequestAuthentication";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public RequestAuthentication(String apiVersion, String kind, ObjectMeta metadata
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RequestAuthentication defines what request authentication methods are supported by a workload. It will reject a request if the request contains invalid authentication information, based on the configured authentication rules. A request that does not contain any authentication credentials will be accepted but will not have any authenticated identity. To restrict access to authenticated requests only, this should be accompanied by an authorization rule. Examples:<br><p> <br><p> - Require JWT for all request for workloads that have label `app:httpbin`<br><p> <br><p> ```yaml apiVersion: security.istio.io/v1 kind: RequestAuthentication metadata:<br><p> <br><p> 	name: httpbin<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  matchLabels:<br><p> 	    app: httpbin<br><p> 	jwtRules:<br><p> 	- issuer: "issuer-foo"<br><p> 	  jwksUri: https://example.com/.well-known/jwks.json
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RequestAuthentication defines what request authentication methods are supported by a workload. It will reject a request if the request contains invalid authentication information, based on the configured authentication rules. A request that does not contain any authentication credentials will be accepted but will not have any authenticated identity. To restrict access to authenticated requests only, this should be accompanied by an authorization rule. Examples:<br><p> <br><p> - Require JWT for all request for workloads that have label `app:httpbin`<br><p> <br><p> ```yaml apiVersion: security.istio.io/v1 kind: RequestAuthentication metadata:<br><p> <br><p> 	name: httpbin<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  matchLabels:<br><p> 	    app: httpbin<br><p> 	jwtRules:<br><p> 	- issuer: "issuer-foo"<br><p> 	  jwksUri: https://example.com/.well-known/jwks.json
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * RequestAuthentication defines what request authentication methods are supported by a workload. It will reject a request if the request contains invalid authentication information, based on the configured authentication rules. A request that does not contain any authentication credentials will be accepted but will not have any authenticated identity. To restrict access to authenticated requests only, this should be accompanied by an authorization rule. Examples:<br><p> <br><p> - Require JWT for all request for workloads that have label `app:httpbin`<br><p> <br><p> ```yaml apiVersion: security.istio.io/v1 kind: RequestAuthentication metadata:<br><p> <br><p> 	name: httpbin<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  matchLabels:<br><p> 	    app: httpbin<br><p> 	jwtRules:<br><p> 	- issuer: "issuer-foo"<br><p> 	  jwksUri: https://example.com/.well-known/jwks.json
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.security.v1beta1.RequestAuthentication getSpec() {
         return spec;
     }
 
+    /**
+     * RequestAuthentication defines what request authentication methods are supported by a workload. It will reject a request if the request contains invalid authentication information, based on the configured authentication rules. A request that does not contain any authentication credentials will be accepted but will not have any authenticated identity. To restrict access to authenticated requests only, this should be accompanied by an authorization rule. Examples:<br><p> <br><p> - Require JWT for all request for workloads that have label `app:httpbin`<br><p> <br><p> ```yaml apiVersion: security.istio.io/v1 kind: RequestAuthentication metadata:<br><p> <br><p> 	name: httpbin<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  matchLabels:<br><p> 	    app: httpbin<br><p> 	jwtRules:<br><p> 	- issuer: "issuer-foo"<br><p> 	  jwksUri: https://example.com/.well-known/jwks.json
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.security.v1beta1.RequestAuthentication spec) {
         this.spec = spec;
     }
 
+    /**
+     * RequestAuthentication defines what request authentication methods are supported by a workload. It will reject a request if the request contains invalid authentication information, based on the configured authentication rules. A request that does not contain any authentication credentials will be accepted but will not have any authenticated identity. To restrict access to authenticated requests only, this should be accompanied by an authorization rule. Examples:<br><p> <br><p> - Require JWT for all request for workloads that have label `app:httpbin`<br><p> <br><p> ```yaml apiVersion: security.istio.io/v1 kind: RequestAuthentication metadata:<br><p> <br><p> 	name: httpbin<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  matchLabels:<br><p> 	    app: httpbin<br><p> 	jwtRules:<br><p> 	- issuer: "issuer-foo"<br><p> 	  jwksUri: https://example.com/.well-known/jwks.json
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * RequestAuthentication defines what request authentication methods are supported by a workload. It will reject a request if the request contains invalid authentication information, based on the configured authentication rules. A request that does not contain any authentication credentials will be accepted but will not have any authenticated identity. To restrict access to authenticated requests only, this should be accompanied by an authorization rule. Examples:<br><p> <br><p> - Require JWT for all request for workloads that have label `app:httpbin`<br><p> <br><p> ```yaml apiVersion: security.istio.io/v1 kind: RequestAuthentication metadata:<br><p> <br><p> 	name: httpbin<br><p> 	namespace: foo<br><p> <br><p> spec:<br><p> <br><p> 	selector:<br><p> 	  matchLabels:<br><p> 	    app: httpbin<br><p> 	jwtRules:<br><p> 	- issuer: "issuer-foo"<br><p> 	  jwksUri: https://example.com/.well-known/jwks.json
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1beta1/RequestAuthenticationList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1beta1/RequestAuthenticationList.java
index 537a8a65ae8..c33018d0470 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1beta1/RequestAuthenticationList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/security/v1beta1/RequestAuthenticationList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RequestAuthenticationList is a collection of RequestAuthentications.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class RequestAuthenticationList implements Editable<RequestAuthenticationListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.security.v1beta1.RequestAuthentication>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "security.istio.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.security.v1beta1.RequestAuthentication> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "RequestAuthenticationList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public RequestAuthenticationList(String apiVersion, List<io.fabric8.istio.api.se
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * RequestAuthenticationList is a collection of RequestAuthentications.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.security.v1beta1.RequestAuthentication> getItems() {
         return items;
     }
 
+    /**
+     * RequestAuthenticationList is a collection of RequestAuthentications.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.security.v1beta1.RequestAuthentication> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RequestAuthenticationList is a collection of RequestAuthentications.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RequestAuthenticationList is a collection of RequestAuthentications.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/telemetry/v1/Telemetry.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/telemetry/v1/Telemetry.java
index 1b23ef0a06a..b4e51e1dc85 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/telemetry/v1/Telemetry.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/telemetry/v1/Telemetry.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * &lt;!-- crd generation tags is a timestamp representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class Telemetry implements Editable<TelemetryBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "telemetry.istio.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Telemetry";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public Telemetry(String apiVersion, String kind, ObjectMeta metadata, io.fabric8
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * &lt;!-- crd generation tags is a timestamp representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * &lt;!-- crd generation tags is a timestamp representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * &lt;!-- crd generation tags is a timestamp representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.telemetry.v1alpha1.Telemetry getSpec() {
         return spec;
     }
 
+    /**
+     * &lt;!-- crd generation tags is a timestamp representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.telemetry.v1alpha1.Telemetry spec) {
         this.spec = spec;
     }
 
+    /**
+     * &lt;!-- crd generation tags is a timestamp representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * &lt;!-- crd generation tags is a timestamp representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/telemetry/v1/TelemetryList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/telemetry/v1/TelemetryList.java
index 8773979482f..9df0255adfe 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/telemetry/v1/TelemetryList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/telemetry/v1/TelemetryList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TelemetryList is a collection of Telemetries.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class TelemetryList implements Editable<TelemetryListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.telemetry.v1.Telemetry>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "telemetry.istio.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.telemetry.v1.Telemetry> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TelemetryList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TelemetryList(String apiVersion, List<io.fabric8.istio.api.telemetry.v1.T
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * TelemetryList is a collection of Telemetries.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.telemetry.v1.Telemetry> getItems() {
         return items;
     }
 
+    /**
+     * TelemetryList is a collection of Telemetries.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.telemetry.v1.Telemetry> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TelemetryList is a collection of Telemetries.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TelemetryList is a collection of Telemetries.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/telemetry/v1alpha1/Telemetry.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/telemetry/v1alpha1/Telemetry.java
index 9ef6bdb3c46..7d3e4d60858 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/telemetry/v1alpha1/Telemetry.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/telemetry/v1alpha1/Telemetry.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * &lt;!-- crd generation tags is a timestamp representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class Telemetry implements Editable<TelemetryBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "telemetry.istio.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Telemetry";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public Telemetry(String apiVersion, String kind, ObjectMeta metadata, io.fabric8
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * &lt;!-- crd generation tags is a timestamp representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * &lt;!-- crd generation tags is a timestamp representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * &lt;!-- crd generation tags is a timestamp representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public io.fabric8.istio.api.api.telemetry.v1alpha1.Telemetry getSpec() {
         return spec;
     }
 
+    /**
+     * &lt;!-- crd generation tags is a timestamp representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("spec")
     public void setSpec(io.fabric8.istio.api.api.telemetry.v1alpha1.Telemetry spec) {
         this.spec = spec;
     }
 
+    /**
+     * &lt;!-- crd generation tags is a timestamp representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public IstioStatus getStatus() {
         return status;
     }
 
+    /**
+     * &lt;!-- crd generation tags is a timestamp representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata" --&gt;<br><p> <br><p> &lt;!-- go code generation tags --&gt;
+     */
     @JsonProperty("status")
     public void setStatus(IstioStatus status) {
         this.status = status;
diff --git a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/telemetry/v1alpha1/TelemetryList.java b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/telemetry/v1alpha1/TelemetryList.java
index d7a5c12cb64..62fe6770250 100644
--- a/extensions/istio/model/src/generated/java/io/fabric8/istio/api/telemetry/v1alpha1/TelemetryList.java
+++ b/extensions/istio/model/src/generated/java/io/fabric8/istio/api/telemetry/v1alpha1/TelemetryList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TelemetryList is a collection of Telemetries.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class TelemetryList implements Editable<TelemetryListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.istio.api.telemetry.v1alpha1.Telemetry>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "telemetry.istio.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.istio.api.telemetry.v1alpha1.Telemetry> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TelemetryList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TelemetryList(String apiVersion, List<io.fabric8.istio.api.telemetry.v1al
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * TelemetryList is a collection of Telemetries.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.istio.api.telemetry.v1alpha1.Telemetry> getItems() {
         return items;
     }
 
+    /**
+     * TelemetryList is a collection of Telemetries.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.istio.api.telemetry.v1alpha1.Telemetry> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TelemetryList is a collection of Telemetries.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TelemetryList is a collection of Telemetries.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1/KafkaAuthSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1/KafkaAuthSpec.java
index d92061019c2..33b49c34457 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1/KafkaAuthSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1/KafkaAuthSpec.java
@@ -85,12 +85,18 @@ public KafkaAuthSpec(List<String> bootstrapServers, KafkaNetSpec net) {
         this.net = net;
     }
 
+    /**
+     * Bootstrap servers are the Kafka servers the consumer will connect to.
+     */
     @JsonProperty("bootstrapServers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getBootstrapServers() {
         return bootstrapServers;
     }
 
+    /**
+     * Bootstrap servers are the Kafka servers the consumer will connect to.
+     */
     @JsonProperty("bootstrapServers")
     public void setBootstrapServers(List<String> bootstrapServers) {
         this.bootstrapServers = bootstrapServers;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1/KafkaBinding.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1/KafkaBinding.java
index b718a112b4e..a6f0b117570 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1/KafkaBinding.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1/KafkaBinding.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KafkaBinding is the Schema for the kafkasources API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class KafkaBinding implements Editable<KafkaBindingBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "bindings.knative.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KafkaBinding";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public KafkaBinding(String apiVersion, String kind, ObjectMeta metadata, KafkaBi
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KafkaBinding is the Schema for the kafkasources API.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KafkaBinding is the Schema for the kafkasources API.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * KafkaBinding is the Schema for the kafkasources API.
+     */
     @JsonProperty("spec")
     public KafkaBindingSpec getSpec() {
         return spec;
     }
 
+    /**
+     * KafkaBinding is the Schema for the kafkasources API.
+     */
     @JsonProperty("spec")
     public void setSpec(KafkaBindingSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * KafkaBinding is the Schema for the kafkasources API.
+     */
     @JsonProperty("status")
     public KafkaBindingStatus getStatus() {
         return status;
     }
 
+    /**
+     * KafkaBinding is the Schema for the kafkasources API.
+     */
     @JsonProperty("status")
     public void setStatus(KafkaBindingStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1/KafkaBindingList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1/KafkaBindingList.java
index d27ae2a9c89..82e7e64b13c 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1/KafkaBindingList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1/KafkaBindingList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KafkaBindingList contains a list of KafkaBindings.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class KafkaBindingList implements Editable<KafkaBindingListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.bindings.v1.KafkaBinding>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "bindings.knative.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.bindings.v1.KafkaBinding> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KafkaBindingList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public KafkaBindingList(String apiVersion, List<io.fabric8.knative.bindings.v1.K
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * KafkaBindingList contains a list of KafkaBindings.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.bindings.v1.KafkaBinding> getItems() {
         return items;
     }
 
+    /**
+     * KafkaBindingList contains a list of KafkaBindings.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.bindings.v1.KafkaBinding> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KafkaBindingList contains a list of KafkaBindings.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KafkaBindingList contains a list of KafkaBindings.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1/KafkaBindingSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1/KafkaBindingSpec.java
index 80b4192a915..71613f6ae78 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1/KafkaBindingSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1/KafkaBindingSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KafkaBindingSpec defines the desired state of the KafkaBinding.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,32 +93,50 @@ public KafkaBindingSpec(List<String> bootstrapServers, KafkaNetSpec net, Referen
         this.subject = subject;
     }
 
+    /**
+     * Bootstrap servers are the Kafka servers the consumer will connect to.
+     */
     @JsonProperty("bootstrapServers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getBootstrapServers() {
         return bootstrapServers;
     }
 
+    /**
+     * Bootstrap servers are the Kafka servers the consumer will connect to.
+     */
     @JsonProperty("bootstrapServers")
     public void setBootstrapServers(List<String> bootstrapServers) {
         this.bootstrapServers = bootstrapServers;
     }
 
+    /**
+     * KafkaBindingSpec defines the desired state of the KafkaBinding.
+     */
     @JsonProperty("net")
     public KafkaNetSpec getNet() {
         return net;
     }
 
+    /**
+     * KafkaBindingSpec defines the desired state of the KafkaBinding.
+     */
     @JsonProperty("net")
     public void setNet(KafkaNetSpec net) {
         this.net = net;
     }
 
+    /**
+     * KafkaBindingSpec defines the desired state of the KafkaBinding.
+     */
     @JsonProperty("subject")
     public Reference getSubject() {
         return subject;
     }
 
+    /**
+     * KafkaBindingSpec defines the desired state of the KafkaBinding.
+     */
     @JsonProperty("subject")
     public void setSubject(Reference subject) {
         this.subject = subject;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1/KafkaBindingStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1/KafkaBindingStatus.java
index 3ab9d022689..31fbb1f095e 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1/KafkaBindingStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1/KafkaBindingStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KafkaBindingStatus defines the observed state of KafkaBinding.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,33 +94,51 @@ public KafkaBindingStatus(Map<String, String> annotations, List<Condition> condi
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1/SecretValueFromSource.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1/SecretValueFromSource.java
index 495255d85af..b07e62f16ca 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1/SecretValueFromSource.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1/SecretValueFromSource.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SecretValueFromSource represents the source of a secret value
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,11 +82,17 @@ public SecretValueFromSource(SecretKeySelector secretKeyRef) {
         this.secretKeyRef = secretKeyRef;
     }
 
+    /**
+     * SecretValueFromSource represents the source of a secret value
+     */
     @JsonProperty("secretKeyRef")
     public SecretKeySelector getSecretKeyRef() {
         return secretKeyRef;
     }
 
+    /**
+     * SecretValueFromSource represents the source of a secret value
+     */
     @JsonProperty("secretKeyRef")
     public void setSecretKeyRef(SecretKeySelector secretKeyRef) {
         this.secretKeyRef = secretKeyRef;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitHubBinding.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitHubBinding.java
index d9dfabc246b..b7427c69907 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitHubBinding.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitHubBinding.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GitHubBinding describes a Binding that is also a Source. The `sink` (from the Source duck) is resolved to a URL and then projected into the `subject` by augmenting the runtime contract of the referenced containers to have a `K_SINK` environment variable holding the endpoint to which to send cloud events.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class GitHubBinding implements Editable<GitHubBindingBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "bindings.knative.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GitHubBinding";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public GitHubBinding(String apiVersion, String kind, ObjectMeta metadata, GitHub
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * GitHubBinding describes a Binding that is also a Source. The `sink` (from the Source duck) is resolved to a URL and then projected into the `subject` by augmenting the runtime contract of the referenced containers to have a `K_SINK` environment variable holding the endpoint to which to send cloud events.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * GitHubBinding describes a Binding that is also a Source. The `sink` (from the Source duck) is resolved to a URL and then projected into the `subject` by augmenting the runtime contract of the referenced containers to have a `K_SINK` environment variable holding the endpoint to which to send cloud events.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * GitHubBinding describes a Binding that is also a Source. The `sink` (from the Source duck) is resolved to a URL and then projected into the `subject` by augmenting the runtime contract of the referenced containers to have a `K_SINK` environment variable holding the endpoint to which to send cloud events.
+     */
     @JsonProperty("spec")
     public GitHubBindingSpec getSpec() {
         return spec;
     }
 
+    /**
+     * GitHubBinding describes a Binding that is also a Source. The `sink` (from the Source duck) is resolved to a URL and then projected into the `subject` by augmenting the runtime contract of the referenced containers to have a `K_SINK` environment variable holding the endpoint to which to send cloud events.
+     */
     @JsonProperty("spec")
     public void setSpec(GitHubBindingSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * GitHubBinding describes a Binding that is also a Source. The `sink` (from the Source duck) is resolved to a URL and then projected into the `subject` by augmenting the runtime contract of the referenced containers to have a `K_SINK` environment variable holding the endpoint to which to send cloud events.
+     */
     @JsonProperty("status")
     public GitHubBindingStatus getStatus() {
         return status;
     }
 
+    /**
+     * GitHubBinding describes a Binding that is also a Source. The `sink` (from the Source duck) is resolved to a URL and then projected into the `subject` by augmenting the runtime contract of the referenced containers to have a `K_SINK` environment variable holding the endpoint to which to send cloud events.
+     */
     @JsonProperty("status")
     public void setStatus(GitHubBindingStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitHubBindingList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitHubBindingList.java
index df8f8e4b1a9..cbc7a8de5e0 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitHubBindingList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitHubBindingList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GitHubBindingList contains a list of GitHubBinding
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class GitHubBindingList implements Editable<GitHubBindingListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.bindings.v1alpha1.GitHubBinding>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "bindings.knative.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.bindings.v1alpha1.GitHubBinding> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GitHubBindingList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public GitHubBindingList(String apiVersion, List<io.fabric8.knative.bindings.v1a
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * GitHubBindingList contains a list of GitHubBinding
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.bindings.v1alpha1.GitHubBinding> getItems() {
         return items;
     }
 
+    /**
+     * GitHubBindingList contains a list of GitHubBinding
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.bindings.v1alpha1.GitHubBinding> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * GitHubBindingList contains a list of GitHubBinding
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * GitHubBindingList contains a list of GitHubBinding
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitHubBindingSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitHubBindingSpec.java
index 743ff5ad913..59f02f61bde 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitHubBindingSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitHubBindingSpec.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GitHubBindingSpec holds the desired state of the GitHubBinding (from the client).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public GitHubBindingSpec(SecretValueFromSource accessToken, Reference subject) {
         this.subject = subject;
     }
 
+    /**
+     * GitHubBindingSpec holds the desired state of the GitHubBinding (from the client).
+     */
     @JsonProperty("accessToken")
     public SecretValueFromSource getAccessToken() {
         return accessToken;
     }
 
+    /**
+     * GitHubBindingSpec holds the desired state of the GitHubBinding (from the client).
+     */
     @JsonProperty("accessToken")
     public void setAccessToken(SecretValueFromSource accessToken) {
         this.accessToken = accessToken;
     }
 
+    /**
+     * GitHubBindingSpec holds the desired state of the GitHubBinding (from the client).
+     */
     @JsonProperty("subject")
     public Reference getSubject() {
         return subject;
     }
 
+    /**
+     * GitHubBindingSpec holds the desired state of the GitHubBinding (from the client).
+     */
     @JsonProperty("subject")
     public void setSubject(Reference subject) {
         this.subject = subject;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitHubBindingStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitHubBindingStatus.java
index db5a66dd6a4..4c1b2610980 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitHubBindingStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitHubBindingStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GitHubBindingStatus communicates the observed state of the GitHubBinding (from the controller).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -114,84 +117,132 @@ public GitHubBindingStatus(Map<String, String> annotations, AuthStatus auth, Lis
         this.sinkUri = sinkUri;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * GitHubBindingStatus communicates the observed state of the GitHubBinding (from the controller).
+     */
     @JsonProperty("auth")
     public AuthStatus getAuth() {
         return auth;
     }
 
+    /**
+     * GitHubBindingStatus communicates the observed state of the GitHubBinding (from the controller).
+     */
     @JsonProperty("auth")
     public void setAuth(AuthStatus auth) {
         this.auth = auth;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CloudEventAttributes> getCeAttributes() {
         return ceAttributes;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     public void setCeAttributes(List<CloudEventAttributes> ceAttributes) {
         this.ceAttributes = ceAttributes;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public String getSinkAudience() {
         return sinkAudience;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public void setSinkAudience(String sinkAudience) {
         this.sinkAudience = sinkAudience;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public String getSinkCACerts() {
         return sinkCACerts;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public void setSinkCACerts(String sinkCACerts) {
         this.sinkCACerts = sinkCACerts;
     }
 
+    /**
+     * GitHubBindingStatus communicates the observed state of the GitHubBinding (from the controller).
+     */
     @JsonProperty("sinkUri")
     public String getSinkUri() {
         return sinkUri;
     }
 
+    /**
+     * GitHubBindingStatus communicates the observed state of the GitHubBinding (from the controller).
+     */
     @JsonProperty("sinkUri")
     public void setSinkUri(String sinkUri) {
         this.sinkUri = sinkUri;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitLabBinding.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitLabBinding.java
index 701a44617cb..a0f1f8ac830 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitLabBinding.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitLabBinding.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GitLabBinding describes a Binding that is also a Source. The `sink` (from the Source duck) is resolved to a URL and then projected into the `subject` by augmenting the runtime contract of the referenced containers to have a `K_SINK` environment variable holding the endpoint to which to send cloud events.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class GitLabBinding implements Editable<GitLabBindingBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "bindings.knative.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GitLabBinding";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public GitLabBinding(String apiVersion, String kind, ObjectMeta metadata, GitLab
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * GitLabBinding describes a Binding that is also a Source. The `sink` (from the Source duck) is resolved to a URL and then projected into the `subject` by augmenting the runtime contract of the referenced containers to have a `K_SINK` environment variable holding the endpoint to which to send cloud events.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * GitLabBinding describes a Binding that is also a Source. The `sink` (from the Source duck) is resolved to a URL and then projected into the `subject` by augmenting the runtime contract of the referenced containers to have a `K_SINK` environment variable holding the endpoint to which to send cloud events.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * GitLabBinding describes a Binding that is also a Source. The `sink` (from the Source duck) is resolved to a URL and then projected into the `subject` by augmenting the runtime contract of the referenced containers to have a `K_SINK` environment variable holding the endpoint to which to send cloud events.
+     */
     @JsonProperty("spec")
     public GitLabBindingSpec getSpec() {
         return spec;
     }
 
+    /**
+     * GitLabBinding describes a Binding that is also a Source. The `sink` (from the Source duck) is resolved to a URL and then projected into the `subject` by augmenting the runtime contract of the referenced containers to have a `K_SINK` environment variable holding the endpoint to which to send cloud events.
+     */
     @JsonProperty("spec")
     public void setSpec(GitLabBindingSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * GitLabBinding describes a Binding that is also a Source. The `sink` (from the Source duck) is resolved to a URL and then projected into the `subject` by augmenting the runtime contract of the referenced containers to have a `K_SINK` environment variable holding the endpoint to which to send cloud events.
+     */
     @JsonProperty("status")
     public GitLabBindingStatus getStatus() {
         return status;
     }
 
+    /**
+     * GitLabBinding describes a Binding that is also a Source. The `sink` (from the Source duck) is resolved to a URL and then projected into the `subject` by augmenting the runtime contract of the referenced containers to have a `K_SINK` environment variable holding the endpoint to which to send cloud events.
+     */
     @JsonProperty("status")
     public void setStatus(GitLabBindingStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitLabBindingList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitLabBindingList.java
index 8e39fed5b79..773e7513f77 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitLabBindingList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitLabBindingList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GitLabBindingList contains a list of GitLabBinding
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class GitLabBindingList implements Editable<GitLabBindingListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.bindings.v1alpha1.GitLabBinding>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "bindings.knative.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.bindings.v1alpha1.GitLabBinding> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GitLabBindingList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public GitLabBindingList(String apiVersion, List<io.fabric8.knative.bindings.v1a
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * GitLabBindingList contains a list of GitLabBinding
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.bindings.v1alpha1.GitLabBinding> getItems() {
         return items;
     }
 
+    /**
+     * GitLabBindingList contains a list of GitLabBinding
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.bindings.v1alpha1.GitLabBinding> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * GitLabBindingList contains a list of GitLabBinding
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * GitLabBindingList contains a list of GitLabBinding
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitLabBindingSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitLabBindingSpec.java
index bc80f135384..11c07416f25 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitLabBindingSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitLabBindingSpec.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GitLabBindingSpec holds the desired state of the GitLabBinding (from the client).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public GitLabBindingSpec(SecretValueFromSource accessToken, Reference subject) {
         this.subject = subject;
     }
 
+    /**
+     * GitLabBindingSpec holds the desired state of the GitLabBinding (from the client).
+     */
     @JsonProperty("accessToken")
     public SecretValueFromSource getAccessToken() {
         return accessToken;
     }
 
+    /**
+     * GitLabBindingSpec holds the desired state of the GitLabBinding (from the client).
+     */
     @JsonProperty("accessToken")
     public void setAccessToken(SecretValueFromSource accessToken) {
         this.accessToken = accessToken;
     }
 
+    /**
+     * GitLabBindingSpec holds the desired state of the GitLabBinding (from the client).
+     */
     @JsonProperty("subject")
     public Reference getSubject() {
         return subject;
     }
 
+    /**
+     * GitLabBindingSpec holds the desired state of the GitLabBinding (from the client).
+     */
     @JsonProperty("subject")
     public void setSubject(Reference subject) {
         this.subject = subject;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitLabBindingStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitLabBindingStatus.java
index b6bfb305b8f..dff1553c770 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitLabBindingStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/GitLabBindingStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GitLabBindingStatus communicates the observed state of the GitLabBinding (from the controller).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -114,84 +117,132 @@ public GitLabBindingStatus(Map<String, String> annotations, AuthStatus auth, Lis
         this.sinkUri = sinkUri;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * GitLabBindingStatus communicates the observed state of the GitLabBinding (from the controller).
+     */
     @JsonProperty("auth")
     public AuthStatus getAuth() {
         return auth;
     }
 
+    /**
+     * GitLabBindingStatus communicates the observed state of the GitLabBinding (from the controller).
+     */
     @JsonProperty("auth")
     public void setAuth(AuthStatus auth) {
         this.auth = auth;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CloudEventAttributes> getCeAttributes() {
         return ceAttributes;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     public void setCeAttributes(List<CloudEventAttributes> ceAttributes) {
         this.ceAttributes = ceAttributes;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public String getSinkAudience() {
         return sinkAudience;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public void setSinkAudience(String sinkAudience) {
         this.sinkAudience = sinkAudience;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public String getSinkCACerts() {
         return sinkCACerts;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public void setSinkCACerts(String sinkCACerts) {
         this.sinkCACerts = sinkCACerts;
     }
 
+    /**
+     * GitLabBindingStatus communicates the observed state of the GitLabBinding (from the controller).
+     */
     @JsonProperty("sinkUri")
     public String getSinkUri() {
         return sinkUri;
     }
 
+    /**
+     * GitLabBindingStatus communicates the observed state of the GitLabBinding (from the controller).
+     */
     @JsonProperty("sinkUri")
     public void setSinkUri(String sinkUri) {
         this.sinkUri = sinkUri;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/SecretValueFromSource.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/SecretValueFromSource.java
index 8898558db0e..dd016e75234 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/SecretValueFromSource.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1alpha1/SecretValueFromSource.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SecretValueFromSource represents the source of a secret value
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,11 +82,17 @@ public SecretValueFromSource(SecretKeySelector secretKeyRef) {
         this.secretKeyRef = secretKeyRef;
     }
 
+    /**
+     * SecretValueFromSource represents the source of a secret value
+     */
     @JsonProperty("secretKeyRef")
     public SecretKeySelector getSecretKeyRef() {
         return secretKeyRef;
     }
 
+    /**
+     * SecretValueFromSource represents the source of a secret value
+     */
     @JsonProperty("secretKeyRef")
     public void setSecretKeyRef(SecretKeySelector secretKeyRef) {
         this.secretKeyRef = secretKeyRef;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1beta1/KafkaAuthSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1beta1/KafkaAuthSpec.java
index 2667c7bdbe7..064e6b02a10 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1beta1/KafkaAuthSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1beta1/KafkaAuthSpec.java
@@ -85,12 +85,18 @@ public KafkaAuthSpec(List<String> bootstrapServers, KafkaNetSpec net) {
         this.net = net;
     }
 
+    /**
+     * Bootstrap servers are the Kafka servers the consumer will connect to.
+     */
     @JsonProperty("bootstrapServers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getBootstrapServers() {
         return bootstrapServers;
     }
 
+    /**
+     * Bootstrap servers are the Kafka servers the consumer will connect to.
+     */
     @JsonProperty("bootstrapServers")
     public void setBootstrapServers(List<String> bootstrapServers) {
         this.bootstrapServers = bootstrapServers;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1beta1/KafkaBinding.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1beta1/KafkaBinding.java
index 27e5bfcdcae..75648f0f495 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1beta1/KafkaBinding.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1beta1/KafkaBinding.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KafkaBinding is the Schema for the kafkasources API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class KafkaBinding implements Editable<KafkaBindingBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "bindings.knative.dev/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KafkaBinding";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public KafkaBinding(String apiVersion, String kind, ObjectMeta metadata, KafkaBi
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KafkaBinding is the Schema for the kafkasources API.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KafkaBinding is the Schema for the kafkasources API.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * KafkaBinding is the Schema for the kafkasources API.
+     */
     @JsonProperty("spec")
     public KafkaBindingSpec getSpec() {
         return spec;
     }
 
+    /**
+     * KafkaBinding is the Schema for the kafkasources API.
+     */
     @JsonProperty("spec")
     public void setSpec(KafkaBindingSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * KafkaBinding is the Schema for the kafkasources API.
+     */
     @JsonProperty("status")
     public KafkaBindingStatus getStatus() {
         return status;
     }
 
+    /**
+     * KafkaBinding is the Schema for the kafkasources API.
+     */
     @JsonProperty("status")
     public void setStatus(KafkaBindingStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1beta1/KafkaBindingList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1beta1/KafkaBindingList.java
index 62795dc1ac6..20f9b5dbe48 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1beta1/KafkaBindingList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1beta1/KafkaBindingList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KafkaBindingList contains a list of KafkaBindings.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class KafkaBindingList implements Editable<KafkaBindingListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.bindings.v1beta1.KafkaBinding>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "bindings.knative.dev/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.bindings.v1beta1.KafkaBinding> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KafkaBindingList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public KafkaBindingList(String apiVersion, List<io.fabric8.knative.bindings.v1be
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * KafkaBindingList contains a list of KafkaBindings.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.bindings.v1beta1.KafkaBinding> getItems() {
         return items;
     }
 
+    /**
+     * KafkaBindingList contains a list of KafkaBindings.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.bindings.v1beta1.KafkaBinding> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KafkaBindingList contains a list of KafkaBindings.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KafkaBindingList contains a list of KafkaBindings.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1beta1/KafkaBindingSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1beta1/KafkaBindingSpec.java
index 50b473fc195..f88bb3b99a9 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1beta1/KafkaBindingSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1beta1/KafkaBindingSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KafkaBindingSpec defines the desired state of the KafkaBinding.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,32 +93,50 @@ public KafkaBindingSpec(List<String> bootstrapServers, KafkaNetSpec net, Referen
         this.subject = subject;
     }
 
+    /**
+     * Bootstrap servers are the Kafka servers the consumer will connect to.
+     */
     @JsonProperty("bootstrapServers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getBootstrapServers() {
         return bootstrapServers;
     }
 
+    /**
+     * Bootstrap servers are the Kafka servers the consumer will connect to.
+     */
     @JsonProperty("bootstrapServers")
     public void setBootstrapServers(List<String> bootstrapServers) {
         this.bootstrapServers = bootstrapServers;
     }
 
+    /**
+     * KafkaBindingSpec defines the desired state of the KafkaBinding.
+     */
     @JsonProperty("net")
     public KafkaNetSpec getNet() {
         return net;
     }
 
+    /**
+     * KafkaBindingSpec defines the desired state of the KafkaBinding.
+     */
     @JsonProperty("net")
     public void setNet(KafkaNetSpec net) {
         this.net = net;
     }
 
+    /**
+     * KafkaBindingSpec defines the desired state of the KafkaBinding.
+     */
     @JsonProperty("subject")
     public Reference getSubject() {
         return subject;
     }
 
+    /**
+     * KafkaBindingSpec defines the desired state of the KafkaBinding.
+     */
     @JsonProperty("subject")
     public void setSubject(Reference subject) {
         this.subject = subject;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1beta1/KafkaBindingStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1beta1/KafkaBindingStatus.java
index 90cf826607b..214bf955215 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1beta1/KafkaBindingStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1beta1/KafkaBindingStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KafkaBindingStatus defines the observed state of KafkaBinding.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,33 +94,51 @@ public KafkaBindingStatus(Map<String, String> annotations, List<Condition> condi
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1beta1/SecretValueFromSource.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1beta1/SecretValueFromSource.java
index 645ae1dfbb9..df2b9de4429 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1beta1/SecretValueFromSource.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/bindings/v1beta1/SecretValueFromSource.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SecretValueFromSource represents the source of a secret value
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,11 +82,17 @@ public SecretValueFromSource(SecretKeySelector secretKeyRef) {
         this.secretKeyRef = secretKeyRef;
     }
 
+    /**
+     * SecretValueFromSource represents the source of a secret value
+     */
     @JsonProperty("secretKeyRef")
     public SecretKeySelector getSecretKeyRef() {
         return secretKeyRef;
     }
 
+    /**
+     * SecretValueFromSource represents the source of a secret value
+     */
     @JsonProperty("secretKeyRef")
     public void setSecretKeyRef(SecretKeySelector secretKeyRef) {
         this.secretKeyRef = secretKeyRef;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AddressStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AddressStatus.java
index be65b83ef64..782a2927d95 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AddressStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AddressStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AddressStatus shows how we expect folks to embed Addressable in their Status field.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public AddressStatus(Addressable address, List<Addressable> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * AddressStatus shows how we expect folks to embed Addressable in their Status field.
+     */
     @JsonProperty("address")
     public Addressable getAddress() {
         return address;
     }
 
+    /**
+     * AddressStatus shows how we expect folks to embed Addressable in their Status field.
+     */
     @JsonProperty("address")
     public void setAddress(Addressable address) {
         this.address = address;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Addressable> getAddresses() {
         return addresses;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<Addressable> addresses) {
         this.addresses = addresses;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Addressable.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Addressable.java
index fc2311961a9..7b89b6b1dc4 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Addressable.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Addressable.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Addressable provides a generic mechanism for a custom resource definition to indicate a destination for message delivery.<br><p> <br><p> Addressable is the schema for the destination information. This is typically stored in the object's `status`, as this information may be generated by the controller.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public Addressable(String cACerts, String audience, String name, String url) {
         this.url = url;
     }
 
+    /**
+     * CACerts is the Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("CACerts")
     public String getCACerts() {
         return cACerts;
     }
 
+    /**
+     * CACerts is the Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("CACerts")
     public void setCACerts(String cACerts) {
         this.cACerts = cACerts;
     }
 
+    /**
+     * Audience is the OIDC audience for this address.
+     */
     @JsonProperty("audience")
     public String getAudience() {
         return audience;
     }
 
+    /**
+     * Audience is the OIDC audience for this address.
+     */
     @JsonProperty("audience")
     public void setAudience(String audience) {
         this.audience = audience;
     }
 
+    /**
+     * Name is the name of the address.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the address.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Addressable provides a generic mechanism for a custom resource definition to indicate a destination for message delivery.<br><p> <br><p> Addressable is the schema for the destination information. This is typically stored in the object's `status`, as this information may be generated by the controller.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * Addressable provides a generic mechanism for a custom resource definition to indicate a destination for message delivery.<br><p> <br><p> Addressable is the schema for the destination information. This is typically stored in the object's `status`, as this information may be generated by the controller.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AddressableType.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AddressableType.java
index cc5295b5e66..9843b12b2d6 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AddressableType.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AddressableType.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AddressableType is a skeleton type wrapping Addressable in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Addressable ObjectReferences and access the Addressable data.  This is not a real resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class AddressableType implements Editable<AddressableTypeBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AddressableType";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public AddressableType(String apiVersion, String kind, ObjectMeta metadata, Addr
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AddressableType is a skeleton type wrapping Addressable in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Addressable ObjectReferences and access the Addressable data.  This is not a real resource.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AddressableType is a skeleton type wrapping Addressable in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Addressable ObjectReferences and access the Addressable data.  This is not a real resource.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * AddressableType is a skeleton type wrapping Addressable in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Addressable ObjectReferences and access the Addressable data.  This is not a real resource.
+     */
     @JsonProperty("status")
     public AddressStatus getStatus() {
         return status;
     }
 
+    /**
+     * AddressableType is a skeleton type wrapping Addressable in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Addressable ObjectReferences and access the Addressable data.  This is not a real resource.
+     */
     @JsonProperty("status")
     public void setStatus(AddressStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AddressableTypeList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AddressableTypeList.java
index e305902dee5..fc28b356ac3 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AddressableTypeList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AddressableTypeList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AddressableTypeList is a list of AddressableType resources
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class AddressableTypeList implements Editable<AddressableTypeListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.duck.v1.AddressableType>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.duck.v1.AddressableType> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AddressableTypeList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public AddressableTypeList(String apiVersion, List<io.fabric8.knative.duck.v1.Ad
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * AddressableTypeList is a list of AddressableType resources
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.duck.v1.AddressableType> getItems() {
         return items;
     }
 
+    /**
+     * AddressableTypeList is a list of AddressableType resources
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.duck.v1.AddressableType> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AddressableTypeList is a list of AddressableType resources
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AddressableTypeList is a list of AddressableType resources
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AppliedEventPoliciesStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AppliedEventPoliciesStatus.java
index 465cf764701..a978e387376 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AppliedEventPoliciesStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AppliedEventPoliciesStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AppliedEventPoliciesStatus contains the list of policies which apply to a resource. This type is intended to be embedded into a status struct.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public AppliedEventPoliciesStatus(List<AppliedEventPolicyRef> policies) {
         this.policies = policies;
     }
 
+    /**
+     * Policies holds the list of applied EventPolicies
+     */
     @JsonProperty("policies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AppliedEventPolicyRef> getPolicies() {
         return policies;
     }
 
+    /**
+     * Policies holds the list of applied EventPolicies
+     */
     @JsonProperty("policies")
     public void setPolicies(List<AppliedEventPolicyRef> policies) {
         this.policies = policies;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AppliedEventPolicyRef.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AppliedEventPolicyRef.java
index 00e996e75a9..ea696326ea9 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AppliedEventPolicyRef.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AppliedEventPolicyRef.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AppliedEventPolicyRef is the reference to an EventPolicy
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public AppliedEventPolicyRef(String apiVersion, String name) {
         this.name = name;
     }
 
+    /**
+     * APIVersion of the applied EventPolicy. This indicates, which version of EventPolicy is supported by the resource.
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * APIVersion of the applied EventPolicy. This indicates, which version of EventPolicy is supported by the resource.
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Name of the applied EventPolicy
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the applied EventPolicy
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AuthStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AuthStatus.java
index e5aa689625b..389f3c155bb 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AuthStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AuthStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AuthStatus is meant to provide the generated service account name in the resource status.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public AuthStatus(String serviceAccountName, List<String> serviceAccountNames) {
         this.serviceAccountNames = serviceAccountNames;
     }
 
+    /**
+     * ServiceAccountName is the name of the generated service account used for this components OIDC authentication.
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * ServiceAccountName is the name of the generated service account used for this components OIDC authentication.
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * ServiceAccountNames is the list of names of the generated service accounts used for this components OIDC authentication. This list can have len() &gt; 1, when the component uses multiple identities (e.g. in case of a Parallel).
+     */
     @JsonProperty("serviceAccountNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getServiceAccountNames() {
         return serviceAccountNames;
     }
 
+    /**
+     * ServiceAccountNames is the list of names of the generated service accounts used for this components OIDC authentication. This list can have len() &gt; 1, when the component uses multiple identities (e.g. in case of a Parallel).
+     */
     @JsonProperty("serviceAccountNames")
     public void setServiceAccountNames(List<String> serviceAccountNames) {
         this.serviceAccountNames = serviceAccountNames;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AuthenticatableType.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AuthenticatableType.java
index 9846e8006a9..f45d3ca04bc 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AuthenticatableType.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AuthenticatableType.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AuthenticatableType is a skeleton type wrapping AuthStatus in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize AuthenticatableType ObjectReferences and access the AuthenticatableType data.  This is not a real resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class AuthenticatableType implements Editable<AuthenticatableTypeBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AuthenticatableType";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public AuthenticatableType(String apiVersion, String kind, ObjectMeta metadata,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AuthenticatableType is a skeleton type wrapping AuthStatus in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize AuthenticatableType ObjectReferences and access the AuthenticatableType data.  This is not a real resource.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AuthenticatableType is a skeleton type wrapping AuthStatus in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize AuthenticatableType ObjectReferences and access the AuthenticatableType data.  This is not a real resource.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * AuthenticatableType is a skeleton type wrapping AuthStatus in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize AuthenticatableType ObjectReferences and access the AuthenticatableType data.  This is not a real resource.
+     */
     @JsonProperty("status")
     public AuthenticatableStatus getStatus() {
         return status;
     }
 
+    /**
+     * AuthenticatableType is a skeleton type wrapping AuthStatus in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize AuthenticatableType ObjectReferences and access the AuthenticatableType data.  This is not a real resource.
+     */
     @JsonProperty("status")
     public void setStatus(AuthenticatableStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AuthenticatableTypeList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AuthenticatableTypeList.java
index 9a644ddb2cf..42fdcb32496 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AuthenticatableTypeList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/AuthenticatableTypeList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AuthenticatableTypeList is a list of AuthenticatableType resources
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class AuthenticatableTypeList implements Editable<AuthenticatableTypeListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.duck.v1.AuthenticatableType>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.duck.v1.AuthenticatableType> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AuthenticatableTypeList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public AuthenticatableTypeList(String apiVersion, List<io.fabric8.knative.duck.v
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * AuthenticatableTypeList is a list of AuthenticatableType resources
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.duck.v1.AuthenticatableType> getItems() {
         return items;
     }
 
+    /**
+     * AuthenticatableTypeList is a list of AuthenticatableType resources
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.duck.v1.AuthenticatableType> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AuthenticatableTypeList is a list of AuthenticatableType resources
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AuthenticatableTypeList is a list of AuthenticatableType resources
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Binding.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Binding.java
index 2966623a738..09a59e82756 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Binding.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Binding.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Binding is a duck type that specifies the partial schema to which all Binding implementations should adhere.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Binding implements Editable<BindingBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Binding";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public Binding(String apiVersion, String kind, ObjectMeta metadata, BindingSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Binding is a duck type that specifies the partial schema to which all Binding implementations should adhere.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Binding is a duck type that specifies the partial schema to which all Binding implementations should adhere.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Binding is a duck type that specifies the partial schema to which all Binding implementations should adhere.
+     */
     @JsonProperty("spec")
     public BindingSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Binding is a duck type that specifies the partial schema to which all Binding implementations should adhere.
+     */
     @JsonProperty("spec")
     public void setSpec(BindingSpec spec) {
         this.spec = spec;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/BindingList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/BindingList.java
index 74767635000..075b1e32ea1 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/BindingList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/BindingList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BindingList is a list of Binding resources
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class BindingList implements Editable<BindingListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.duck.v1.Binding>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.duck.v1.Binding> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "BindingList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public BindingList(String apiVersion, List<io.fabric8.knative.duck.v1.Binding> i
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * BindingList is a list of Binding resources
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.duck.v1.Binding> getItems() {
         return items;
     }
 
+    /**
+     * BindingList is a list of Binding resources
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.duck.v1.Binding> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * BindingList is a list of Binding resources
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * BindingList is a list of Binding resources
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/BindingSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/BindingSpec.java
index 7b56ca51948..cfa39e1821d 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/BindingSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/BindingSpec.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BindingSpec specifies the spec portion of the Binding partial-schema.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,11 +82,17 @@ public BindingSpec(Reference subject) {
         this.subject = subject;
     }
 
+    /**
+     * BindingSpec specifies the spec portion of the Binding partial-schema.
+     */
     @JsonProperty("subject")
     public Reference getSubject() {
         return subject;
     }
 
+    /**
+     * BindingSpec specifies the spec portion of the Binding partial-schema.
+     */
     @JsonProperty("subject")
     public void setSubject(Reference subject) {
         this.subject = subject;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Channelable.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Channelable.java
index 85ff9c174d5..00b81b34fc6 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Channelable.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Channelable.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Channelable is a skeleton type wrapping Subscribable and Addressable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize Channelable ObjectReferences and access their subscription and address data.  This is not a real resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Channelable implements Editable<ChannelableBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Channelable";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Channelable(String apiVersion, String kind, ObjectMeta metadata, Channela
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Channelable is a skeleton type wrapping Subscribable and Addressable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize Channelable ObjectReferences and access their subscription and address data.  This is not a real resource.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Channelable is a skeleton type wrapping Subscribable and Addressable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize Channelable ObjectReferences and access their subscription and address data.  This is not a real resource.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Channelable is a skeleton type wrapping Subscribable and Addressable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize Channelable ObjectReferences and access their subscription and address data.  This is not a real resource.
+     */
     @JsonProperty("spec")
     public ChannelableSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Channelable is a skeleton type wrapping Subscribable and Addressable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize Channelable ObjectReferences and access their subscription and address data.  This is not a real resource.
+     */
     @JsonProperty("spec")
     public void setSpec(ChannelableSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Channelable is a skeleton type wrapping Subscribable and Addressable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize Channelable ObjectReferences and access their subscription and address data.  This is not a real resource.
+     */
     @JsonProperty("status")
     public ChannelableStatus getStatus() {
         return status;
     }
 
+    /**
+     * Channelable is a skeleton type wrapping Subscribable and Addressable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize Channelable ObjectReferences and access their subscription and address data.  This is not a real resource.
+     */
     @JsonProperty("status")
     public void setStatus(ChannelableStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/ChannelableList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/ChannelableList.java
index 00518450edc..50f57e4f3d5 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/ChannelableList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/ChannelableList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ChannelableList is a list of Channelable resources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ChannelableList implements Editable<ChannelableListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.duck.v1.Channelable>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.duck.v1.Channelable> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ChannelableList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ChannelableList(String apiVersion, List<io.fabric8.knative.duck.v1.Channe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ChannelableList is a list of Channelable resources.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.duck.v1.Channelable> getItems() {
         return items;
     }
 
+    /**
+     * ChannelableList is a list of Channelable resources.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.duck.v1.Channelable> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ChannelableList is a list of Channelable resources.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ChannelableList is a list of Channelable resources.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/ChannelableSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/ChannelableSpec.java
index a3ba8ce4161..72f00257424 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/ChannelableSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/ChannelableSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ChannelableSpec contains Spec of the Channelable object
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public ChannelableSpec(DeliverySpec delivery, List<SubscriberSpec> subscribers)
         this.subscribers = subscribers;
     }
 
+    /**
+     * ChannelableSpec contains Spec of the Channelable object
+     */
     @JsonProperty("delivery")
     public DeliverySpec getDelivery() {
         return delivery;
     }
 
+    /**
+     * ChannelableSpec contains Spec of the Channelable object
+     */
     @JsonProperty("delivery")
     public void setDelivery(DeliverySpec delivery) {
         this.delivery = delivery;
     }
 
+    /**
+     * This is the list of subscriptions for this subscribable.
+     */
     @JsonProperty("subscribers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SubscriberSpec> getSubscribers() {
         return subscribers;
     }
 
+    /**
+     * This is the list of subscriptions for this subscribable.
+     */
     @JsonProperty("subscribers")
     public void setSubscribers(List<SubscriberSpec> subscribers) {
         this.subscribers = subscribers;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/ChannelableStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/ChannelableStatus.java
index 2ea2e57a8e8..daa357ce2f6 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/ChannelableStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/ChannelableStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ChannelableStatus contains the Status of a Channelable object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -122,106 +125,166 @@ public ChannelableStatus(Addressable address, List<Addressable> addresses, Map<S
         this.subscribers = subscribers;
     }
 
+    /**
+     * ChannelableStatus contains the Status of a Channelable object.
+     */
     @JsonProperty("address")
     public Addressable getAddress() {
         return address;
     }
 
+    /**
+     * ChannelableStatus contains the Status of a Channelable object.
+     */
     @JsonProperty("address")
     public void setAddress(Addressable address) {
         this.address = address;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Addressable> getAddresses() {
         return addresses;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<Addressable> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * DeadLetterSinkAudience is the OIDC audience of the DeadLetterSink
+     */
     @JsonProperty("deadLetterSinkAudience")
     public String getDeadLetterSinkAudience() {
         return deadLetterSinkAudience;
     }
 
+    /**
+     * DeadLetterSinkAudience is the OIDC audience of the DeadLetterSink
+     */
     @JsonProperty("deadLetterSinkAudience")
     public void setDeadLetterSinkAudience(String deadLetterSinkAudience) {
         this.deadLetterSinkAudience = deadLetterSinkAudience;
     }
 
+    /**
+     * DeadLetterSinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("deadLetterSinkCACerts")
     public String getDeadLetterSinkCACerts() {
         return deadLetterSinkCACerts;
     }
 
+    /**
+     * DeadLetterSinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("deadLetterSinkCACerts")
     public void setDeadLetterSinkCACerts(String deadLetterSinkCACerts) {
         this.deadLetterSinkCACerts = deadLetterSinkCACerts;
     }
 
+    /**
+     * ChannelableStatus contains the Status of a Channelable object.
+     */
     @JsonProperty("deadLetterSinkUri")
     public String getDeadLetterSinkUri() {
         return deadLetterSinkUri;
     }
 
+    /**
+     * ChannelableStatus contains the Status of a Channelable object.
+     */
     @JsonProperty("deadLetterSinkUri")
     public void setDeadLetterSinkUri(String deadLetterSinkUri) {
         this.deadLetterSinkUri = deadLetterSinkUri;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Policies holds the list of applied EventPolicies
+     */
     @JsonProperty("policies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AppliedEventPolicyRef> getPolicies() {
         return policies;
     }
 
+    /**
+     * Policies holds the list of applied EventPolicies
+     */
     @JsonProperty("policies")
     public void setPolicies(List<AppliedEventPolicyRef> policies) {
         this.policies = policies;
     }
 
+    /**
+     * This is the list of subscription's statuses for this channel.
+     */
     @JsonProperty("subscribers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SubscriberStatus> getSubscribers() {
         return subscribers;
     }
 
+    /**
+     * This is the list of subscription's statuses for this channel.
+     */
     @JsonProperty("subscribers")
     public void setSubscribers(List<SubscriberStatus> subscribers) {
         this.subscribers = subscribers;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/CloudEventAttributes.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/CloudEventAttributes.java
index 0a31000ce5a..14af9732ed3 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/CloudEventAttributes.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/CloudEventAttributes.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CloudEventAttributes specifies the attributes that a Source uses as part of its CloudEvents.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public CloudEventAttributes(String source, String type) {
         this.type = type;
     }
 
+    /**
+     * Source is the CloudEvents source attribute.
+     */
     @JsonProperty("source")
     public String getSource() {
         return source;
     }
 
+    /**
+     * Source is the CloudEvents source attribute.
+     */
     @JsonProperty("source")
     public void setSource(String source) {
         this.source = source;
     }
 
+    /**
+     * Type refers to the CloudEvent type attribute.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type refers to the CloudEvent type attribute.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/CloudEventOverrides.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/CloudEventOverrides.java
index 09512c827eb..dd93bb00a69 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/CloudEventOverrides.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/CloudEventOverrides.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CloudEventOverrides defines arguments for a Source that control the output format of the CloudEvents produced by the Source.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,12 +82,18 @@ public CloudEventOverrides(Map<String, String> extensions) {
         this.extensions = extensions;
     }
 
+    /**
+     * Extensions specify what attribute are added or overridden on the outbound event. Each `Extensions` key-value pair are set on the event as an attribute extension independently.
+     */
     @JsonProperty("extensions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getExtensions() {
         return extensions;
     }
 
+    /**
+     * Extensions specify what attribute are added or overridden on the outbound event. Each `Extensions` key-value pair are set on the event as an attribute extension independently.
+     */
     @JsonProperty("extensions")
     public void setExtensions(Map<String, String> extensions) {
         this.extensions = extensions;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/CronJob.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/CronJob.java
index 15af5fdad9e..5073c9900f9 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/CronJob.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/CronJob.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CronJob is a wrapper around CronJob resource, which supports our interfaces for webhooks
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class CronJob implements Editable<CronJobBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CronJob";
     @JsonProperty("metadata")
@@ -108,7 +105,7 @@ public CronJob(String apiVersion, String kind, ObjectMeta metadata, CronJobSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -116,7 +113,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -124,7 +121,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -132,28 +129,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CronJob is a wrapper around CronJob resource, which supports our interfaces for webhooks
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CronJob is a wrapper around CronJob resource, which supports our interfaces for webhooks
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * CronJob is a wrapper around CronJob resource, which supports our interfaces for webhooks
+     */
     @JsonProperty("spec")
     public CronJobSpec getSpec() {
         return spec;
     }
 
+    /**
+     * CronJob is a wrapper around CronJob resource, which supports our interfaces for webhooks
+     */
     @JsonProperty("spec")
     public void setSpec(CronJobSpec spec) {
         this.spec = spec;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/CronJobList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/CronJobList.java
index 3cd6fec5bb3..6347280a4d1 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/CronJobList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/CronJobList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CronJobList is a list of CronJob resources
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class CronJobList implements Editable<CronJobListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.duck.v1.CronJob>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.duck.v1.CronJob> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CronJobList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CronJobList(String apiVersion, List<io.fabric8.knative.duck.v1.CronJob> i
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * CronJobList is a list of CronJob resources
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.duck.v1.CronJob> getItems() {
         return items;
     }
 
+    /**
+     * CronJobList is a list of CronJob resources
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.duck.v1.CronJob> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CronJobList is a list of CronJob resources
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CronJobList is a list of CronJob resources
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/DeliverySpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/DeliverySpec.java
index 5d906805f9c..7bdd6530adc 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/DeliverySpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/DeliverySpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeliverySpec contains the delivery options for event senders, such as channelable and source.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,71 +105,113 @@ public DeliverySpec(String backoffDelay, String backoffPolicy, Destination deadL
         this.timeout = timeout;
     }
 
+    /**
+     * BackoffDelay is the delay before retrying. More information on Duration format:<br><p>  - https://www.iso.org/iso-8601-date-and-time-format.html<br><p>  - https://en.wikipedia.org/wiki/ISO_8601<br><p> <br><p> For linear policy, backoff delay is backoffDelay&#42;&lt;numberOfRetries&gt;. For exponential policy, backoff delay is backoffDelay&#42;2^&lt;numberOfRetries&gt;.
+     */
     @JsonProperty("backoffDelay")
     public String getBackoffDelay() {
         return backoffDelay;
     }
 
+    /**
+     * BackoffDelay is the delay before retrying. More information on Duration format:<br><p>  - https://www.iso.org/iso-8601-date-and-time-format.html<br><p>  - https://en.wikipedia.org/wiki/ISO_8601<br><p> <br><p> For linear policy, backoff delay is backoffDelay&#42;&lt;numberOfRetries&gt;. For exponential policy, backoff delay is backoffDelay&#42;2^&lt;numberOfRetries&gt;.
+     */
     @JsonProperty("backoffDelay")
     public void setBackoffDelay(String backoffDelay) {
         this.backoffDelay = backoffDelay;
     }
 
+    /**
+     * BackoffPolicy is the retry backoff policy (linear, exponential).
+     */
     @JsonProperty("backoffPolicy")
     public String getBackoffPolicy() {
         return backoffPolicy;
     }
 
+    /**
+     * BackoffPolicy is the retry backoff policy (linear, exponential).
+     */
     @JsonProperty("backoffPolicy")
     public void setBackoffPolicy(String backoffPolicy) {
         this.backoffPolicy = backoffPolicy;
     }
 
+    /**
+     * DeliverySpec contains the delivery options for event senders, such as channelable and source.
+     */
     @JsonProperty("deadLetterSink")
     public Destination getDeadLetterSink() {
         return deadLetterSink;
     }
 
+    /**
+     * DeliverySpec contains the delivery options for event senders, such as channelable and source.
+     */
     @JsonProperty("deadLetterSink")
     public void setDeadLetterSink(Destination deadLetterSink) {
         this.deadLetterSink = deadLetterSink;
     }
 
+    /**
+     * format specifies the desired event format for the cloud event. It can be one of the following values: - nil: default value, no specific format required. - "JSON": indicates the event should be in structured mode. - "binary": indicates the event should be in binary mode.
+     */
     @JsonProperty("format")
     public String getFormat() {
         return format;
     }
 
+    /**
+     * format specifies the desired event format for the cloud event. It can be one of the following values: - nil: default value, no specific format required. - "JSON": indicates the event should be in structured mode. - "binary": indicates the event should be in binary mode.
+     */
     @JsonProperty("format")
     public void setFormat(String format) {
         this.format = format;
     }
 
+    /**
+     * Retry is the minimum number of retries the sender should attempt when sending an event before moving it to the dead letter sink.
+     */
     @JsonProperty("retry")
     public Integer getRetry() {
         return retry;
     }
 
+    /**
+     * Retry is the minimum number of retries the sender should attempt when sending an event before moving it to the dead letter sink.
+     */
     @JsonProperty("retry")
     public void setRetry(Integer retry) {
         this.retry = retry;
     }
 
+    /**
+     * RetryAfterMax provides an optional upper bound on the duration specified in a "Retry-After" header when calculating backoff times for retrying 429 and 503 response codes.  Setting the value to zero ("PT0S") can be used to opt-out of respecting "Retry-After" header values altogether. This value only takes effect if "Retry" is configured, and also depends on specific implementations (Channels, Sources, etc.) choosing to provide this capability.<br><p> <br><p> Note: This API is EXPERIMENTAL and might be changed at anytime. While this experimental<br><p>       feature is in the Alpha/Beta stage, you must provide a valid value to opt-in for<br><p>       supporting "Retry-After" headers.  When the feature becomes Stable/GA "Retry-After"<br><p>       headers will be respected by default, and you can choose to specify "PT0S" to<br><p>       opt-out of supporting "Retry-After" headers.<br><p>       For more details: https://github.com/knative/eventing/issues/5811<br><p> <br><p> More information on Duration format:<br><p>  - https://www.iso.org/iso-8601-date-and-time-format.html<br><p>  - https://en.wikipedia.org/wiki/ISO_8601
+     */
     @JsonProperty("retryAfterMax")
     public String getRetryAfterMax() {
         return retryAfterMax;
     }
 
+    /**
+     * RetryAfterMax provides an optional upper bound on the duration specified in a "Retry-After" header when calculating backoff times for retrying 429 and 503 response codes.  Setting the value to zero ("PT0S") can be used to opt-out of respecting "Retry-After" header values altogether. This value only takes effect if "Retry" is configured, and also depends on specific implementations (Channels, Sources, etc.) choosing to provide this capability.<br><p> <br><p> Note: This API is EXPERIMENTAL and might be changed at anytime. While this experimental<br><p>       feature is in the Alpha/Beta stage, you must provide a valid value to opt-in for<br><p>       supporting "Retry-After" headers.  When the feature becomes Stable/GA "Retry-After"<br><p>       headers will be respected by default, and you can choose to specify "PT0S" to<br><p>       opt-out of supporting "Retry-After" headers.<br><p>       For more details: https://github.com/knative/eventing/issues/5811<br><p> <br><p> More information on Duration format:<br><p>  - https://www.iso.org/iso-8601-date-and-time-format.html<br><p>  - https://en.wikipedia.org/wiki/ISO_8601
+     */
     @JsonProperty("retryAfterMax")
     public void setRetryAfterMax(String retryAfterMax) {
         this.retryAfterMax = retryAfterMax;
     }
 
+    /**
+     * Timeout is the timeout of each single request. The value must be greater than 0. More information on Duration format:<br><p>  - https://www.iso.org/iso-8601-date-and-time-format.html<br><p>  - https://en.wikipedia.org/wiki/ISO_8601<br><p> <br><p> Note: This API is EXPERIMENTAL and might break anytime. For more details: https://github.com/knative/eventing/issues/5148
+     */
     @JsonProperty("timeout")
     public String getTimeout() {
         return timeout;
     }
 
+    /**
+     * Timeout is the timeout of each single request. The value must be greater than 0. More information on Duration format:<br><p>  - https://www.iso.org/iso-8601-date-and-time-format.html<br><p>  - https://en.wikipedia.org/wiki/ISO_8601<br><p> <br><p> Note: This API is EXPERIMENTAL and might break anytime. For more details: https://github.com/knative/eventing/issues/5148
+     */
     @JsonProperty("timeout")
     public void setTimeout(String timeout) {
         this.timeout = timeout;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/DeliveryStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/DeliveryStatus.java
index c4ae0ecf52d..1556416e22b 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/DeliveryStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/DeliveryStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeliveryStatus contains the Status of an object supporting delivery options. This type is intended to be embedded into a status struct.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public DeliveryStatus(String deadLetterSinkAudience, String deadLetterSinkCACert
         this.deadLetterSinkUri = deadLetterSinkUri;
     }
 
+    /**
+     * DeadLetterSinkAudience is the OIDC audience of the DeadLetterSink
+     */
     @JsonProperty("deadLetterSinkAudience")
     public String getDeadLetterSinkAudience() {
         return deadLetterSinkAudience;
     }
 
+    /**
+     * DeadLetterSinkAudience is the OIDC audience of the DeadLetterSink
+     */
     @JsonProperty("deadLetterSinkAudience")
     public void setDeadLetterSinkAudience(String deadLetterSinkAudience) {
         this.deadLetterSinkAudience = deadLetterSinkAudience;
     }
 
+    /**
+     * DeadLetterSinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("deadLetterSinkCACerts")
     public String getDeadLetterSinkCACerts() {
         return deadLetterSinkCACerts;
     }
 
+    /**
+     * DeadLetterSinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("deadLetterSinkCACerts")
     public void setDeadLetterSinkCACerts(String deadLetterSinkCACerts) {
         this.deadLetterSinkCACerts = deadLetterSinkCACerts;
     }
 
+    /**
+     * DeliveryStatus contains the Status of an object supporting delivery options. This type is intended to be embedded into a status struct.
+     */
     @JsonProperty("deadLetterSinkUri")
     public String getDeadLetterSinkUri() {
         return deadLetterSinkUri;
     }
 
+    /**
+     * DeliveryStatus contains the Status of an object supporting delivery options. This type is intended to be embedded into a status struct.
+     */
     @JsonProperty("deadLetterSinkUri")
     public void setDeadLetterSinkUri(String deadLetterSinkUri) {
         this.deadLetterSinkUri = deadLetterSinkUri;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Destination.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Destination.java
index 95a2f32ae32..75d064ffd31 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Destination.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Destination.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Destination represents a target of an invocation over HTTP.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public Destination(String cACerts, String audience, KReference ref, String uri)
         this.uri = uri;
     }
 
+    /**
+     * CACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468. If set, these CAs are appended to the set of CAs provided by the Addressable target, if any.
+     */
     @JsonProperty("CACerts")
     public String getCACerts() {
         return cACerts;
     }
 
+    /**
+     * CACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468. If set, these CAs are appended to the set of CAs provided by the Addressable target, if any.
+     */
     @JsonProperty("CACerts")
     public void setCACerts(String cACerts) {
         this.cACerts = cACerts;
     }
 
+    /**
+     * Audience is the OIDC audience. This need only be set, if the target is not an Addressable and thus the Audience can't be received from the Addressable itself. In case the Addressable specifies an Audience too, the Destinations Audience takes preference.
+     */
     @JsonProperty("audience")
     public String getAudience() {
         return audience;
     }
 
+    /**
+     * Audience is the OIDC audience. This need only be set, if the target is not an Addressable and thus the Audience can't be received from the Addressable itself. In case the Addressable specifies an Audience too, the Destinations Audience takes preference.
+     */
     @JsonProperty("audience")
     public void setAudience(String audience) {
         this.audience = audience;
     }
 
+    /**
+     * Destination represents a target of an invocation over HTTP.
+     */
     @JsonProperty("ref")
     public KReference getRef() {
         return ref;
     }
 
+    /**
+     * Destination represents a target of an invocation over HTTP.
+     */
     @JsonProperty("ref")
     public void setRef(KReference ref) {
         this.ref = ref;
     }
 
+    /**
+     * Destination represents a target of an invocation over HTTP.
+     */
     @JsonProperty("uri")
     public String getUri() {
         return uri;
     }
 
+    /**
+     * Destination represents a target of an invocation over HTTP.
+     */
     @JsonProperty("uri")
     public void setUri(String uri) {
         this.uri = uri;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/KReference.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/KReference.java
index f258f4fa197..8ef152cf3cb 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/KReference.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/KReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KReference contains enough information to refer to another object. It's a trimmed down version of corev1.ObjectReference.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public KReference(String address, String apiVersion, String group, String kind,
         this.namespace = namespace;
     }
 
+    /**
+     * Address points to a specific Address Name.
+     */
     @JsonProperty("address")
     public String getAddress() {
         return address;
     }
 
+    /**
+     * Address points to a specific Address Name.
+     */
     @JsonProperty("address")
     public void setAddress(String address) {
         this.address = address;
     }
 
+    /**
+     * API version of the referent.
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * API version of the referent.
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Group of the API, without the version of the group. This can be used as an alternative to the APIVersion, and then resolved using ResolveGroup. Note: This API is EXPERIMENTAL and might break anytime. For more details: https://github.com/knative/eventing/issues/5086
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * Group of the API, without the version of the group. This can be used as an alternative to the APIVersion, and then resolved using ResolveGroup. Note: This API is EXPERIMENTAL and might break anytime. For more details: https://github.com/knative/eventing/issues/5086
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ This is optional field, it gets defaulted to the object holding it if left out.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ This is optional field, it gets defaulted to the object holding it if left out.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/KResource.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/KResource.java
index cd0fb4c39da..30c98279002 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/KResource.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/KResource.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KResource is a skeleton type wrapping Conditions in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Conditions ObjectReferences and access the Conditions data.  This is not a real resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class KResource implements Editable<KResourceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KResource";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public KResource(String apiVersion, String kind, ObjectMeta metadata, Status sta
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KResource is a skeleton type wrapping Conditions in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Conditions ObjectReferences and access the Conditions data.  This is not a real resource.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KResource is a skeleton type wrapping Conditions in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Conditions ObjectReferences and access the Conditions data.  This is not a real resource.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * KResource is a skeleton type wrapping Conditions in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Conditions ObjectReferences and access the Conditions data.  This is not a real resource.
+     */
     @JsonProperty("status")
     public Status getStatus() {
         return status;
     }
 
+    /**
+     * KResource is a skeleton type wrapping Conditions in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Conditions ObjectReferences and access the Conditions data.  This is not a real resource.
+     */
     @JsonProperty("status")
     public void setStatus(Status status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/KResourceList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/KResourceList.java
index 2a6bfe28205..ec566ec38e8 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/KResourceList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/KResourceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KResourceList is a list of KResource resources
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class KResourceList implements Editable<KResourceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.duck.v1.KResource>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.duck.v1.KResource> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KResourceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public KResourceList(String apiVersion, List<io.fabric8.knative.duck.v1.KResourc
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * KResourceList is a list of KResource resources
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.duck.v1.KResource> getItems() {
         return items;
     }
 
+    /**
+     * KResourceList is a list of KResource resources
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.duck.v1.KResource> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KResourceList is a list of KResource resources
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KResourceList is a list of KResource resources
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Pod.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Pod.java
index 32e89a4840a..c0fa0dae43d 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Pod.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Pod.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Pod is a wrapper around Pod-like resource, which supports our interfaces for webhooks
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Pod implements Editable<PodBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Pod";
     @JsonProperty("metadata")
@@ -108,7 +105,7 @@ public Pod(String apiVersion, String kind, ObjectMeta metadata, PodSpec spec) {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -116,7 +113,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -124,7 +121,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -132,28 +129,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Pod is a wrapper around Pod-like resource, which supports our interfaces for webhooks
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Pod is a wrapper around Pod-like resource, which supports our interfaces for webhooks
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Pod is a wrapper around Pod-like resource, which supports our interfaces for webhooks
+     */
     @JsonProperty("spec")
     public PodSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Pod is a wrapper around Pod-like resource, which supports our interfaces for webhooks
+     */
     @JsonProperty("spec")
     public void setSpec(PodSpec spec) {
         this.spec = spec;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/PodList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/PodList.java
index 3218f0aef0b..9a9a030762e 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/PodList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/PodList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodList is a list of WithPod resources
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PodList implements Editable<PodListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.duck.v1.WithPod>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.duck.v1.WithPod> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PodList(String apiVersion, List<io.fabric8.knative.duck.v1.WithPod> items
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PodList is a list of WithPod resources
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.duck.v1.WithPod> getItems() {
         return items;
     }
 
+    /**
+     * PodList is a list of WithPod resources
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.duck.v1.WithPod> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodList is a list of WithPod resources
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodList is a list of WithPod resources
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/PodSpecable.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/PodSpecable.java
index 1e53bece126..5b6d6423896 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/PodSpecable.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/PodSpecable.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodSpecable is implemented by types containing a PodTemplateSpec in the manner of ReplicaSet, Deployment, DaemonSet, StatefulSet.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public PodSpecable(ObjectMeta metadata, PodSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PodSpecable is implemented by types containing a PodTemplateSpec in the manner of ReplicaSet, Deployment, DaemonSet, StatefulSet.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodSpecable is implemented by types containing a PodTemplateSpec in the manner of ReplicaSet, Deployment, DaemonSet, StatefulSet.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PodSpecable is implemented by types containing a PodTemplateSpec in the manner of ReplicaSet, Deployment, DaemonSet, StatefulSet.
+     */
     @JsonProperty("spec")
     public PodSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PodSpecable is implemented by types containing a PodTemplateSpec in the manner of ReplicaSet, Deployment, DaemonSet, StatefulSet.
+     */
     @JsonProperty("spec")
     public void setSpec(PodSpec spec) {
         this.spec = spec;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Source.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Source.java
index 3913e79828f..465b7ec961b 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Source.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Source.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Source is the minimum resource shape to adhere to the Source Specification. This duck type is intended to allow implementors of Sources and Importers to verify their own resources meet the expectations. This is not a real resource. NOTE: The Source Specification is in progress and the shape and names could be modified until it has been accepted.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Source implements Editable<SourceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Source";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Source(String apiVersion, String kind, ObjectMeta metadata, SourceSpec sp
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Source is the minimum resource shape to adhere to the Source Specification. This duck type is intended to allow implementors of Sources and Importers to verify their own resources meet the expectations. This is not a real resource. NOTE: The Source Specification is in progress and the shape and names could be modified until it has been accepted.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Source is the minimum resource shape to adhere to the Source Specification. This duck type is intended to allow implementors of Sources and Importers to verify their own resources meet the expectations. This is not a real resource. NOTE: The Source Specification is in progress and the shape and names could be modified until it has been accepted.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Source is the minimum resource shape to adhere to the Source Specification. This duck type is intended to allow implementors of Sources and Importers to verify their own resources meet the expectations. This is not a real resource. NOTE: The Source Specification is in progress and the shape and names could be modified until it has been accepted.
+     */
     @JsonProperty("spec")
     public SourceSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Source is the minimum resource shape to adhere to the Source Specification. This duck type is intended to allow implementors of Sources and Importers to verify their own resources meet the expectations. This is not a real resource. NOTE: The Source Specification is in progress and the shape and names could be modified until it has been accepted.
+     */
     @JsonProperty("spec")
     public void setSpec(SourceSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Source is the minimum resource shape to adhere to the Source Specification. This duck type is intended to allow implementors of Sources and Importers to verify their own resources meet the expectations. This is not a real resource. NOTE: The Source Specification is in progress and the shape and names could be modified until it has been accepted.
+     */
     @JsonProperty("status")
     public SourceStatus getStatus() {
         return status;
     }
 
+    /**
+     * Source is the minimum resource shape to adhere to the Source Specification. This duck type is intended to allow implementors of Sources and Importers to verify their own resources meet the expectations. This is not a real resource. NOTE: The Source Specification is in progress and the shape and names could be modified until it has been accepted.
+     */
     @JsonProperty("status")
     public void setStatus(SourceStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/SourceList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/SourceList.java
index 786b1006ebe..4bdd3475d9a 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/SourceList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/SourceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SourceList is a list of Source resources
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class SourceList implements Editable<SourceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.duck.v1.Source>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.duck.v1.Source> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SourceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public SourceList(String apiVersion, List<io.fabric8.knative.duck.v1.Source> ite
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * SourceList is a list of Source resources
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.duck.v1.Source> getItems() {
         return items;
     }
 
+    /**
+     * SourceList is a list of Source resources
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.duck.v1.Source> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SourceList is a list of Source resources
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SourceList is a list of Source resources
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/SourceStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/SourceStatus.java
index 09d71a99f17..3397fab4e13 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/SourceStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/SourceStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SourceStatus shows how we expect folks to embed Addressable in their Status field.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -112,84 +115,132 @@ public SourceStatus(Map<String, String> annotations, AuthStatus auth, List<Cloud
         this.sinkUri = sinkUri;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * SourceStatus shows how we expect folks to embed Addressable in their Status field.
+     */
     @JsonProperty("auth")
     public AuthStatus getAuth() {
         return auth;
     }
 
+    /**
+     * SourceStatus shows how we expect folks to embed Addressable in their Status field.
+     */
     @JsonProperty("auth")
     public void setAuth(AuthStatus auth) {
         this.auth = auth;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CloudEventAttributes> getCeAttributes() {
         return ceAttributes;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     public void setCeAttributes(List<CloudEventAttributes> ceAttributes) {
         this.ceAttributes = ceAttributes;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public String getSinkAudience() {
         return sinkAudience;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public void setSinkAudience(String sinkAudience) {
         this.sinkAudience = sinkAudience;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public String getSinkCACerts() {
         return sinkCACerts;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public void setSinkCACerts(String sinkCACerts) {
         this.sinkCACerts = sinkCACerts;
     }
 
+    /**
+     * SourceStatus shows how we expect folks to embed Addressable in their Status field.
+     */
     @JsonProperty("sinkUri")
     public String getSinkUri() {
         return sinkUri;
     }
 
+    /**
+     * SourceStatus shows how we expect folks to embed Addressable in their Status field.
+     */
     @JsonProperty("sinkUri")
     public void setSinkUri(String sinkUri) {
         this.sinkUri = sinkUri;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Status.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Status.java
index a4d7065d6a1..d36b72f5e1f 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Status.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Status.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Status shows how we expect folks to embed Conditions in their Status field. WARNING: Adding fields to this struct will add them to all Knative resources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,33 +94,51 @@ public Status(Map<String, String> annotations, List<Condition> conditions, Long
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Subscribable.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Subscribable.java
index 704aa8d51a3..124dabebd34 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Subscribable.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/Subscribable.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Subscribable is a skeleton type wrapping Subscribable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize SubscribableType ObjectReferences and access the Subscription data.  This is not a real resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Subscribable implements Editable<SubscribableBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Subscribable";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Subscribable(String apiVersion, String kind, ObjectMeta metadata, Subscri
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Subscribable is a skeleton type wrapping Subscribable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize SubscribableType ObjectReferences and access the Subscription data.  This is not a real resource.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Subscribable is a skeleton type wrapping Subscribable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize SubscribableType ObjectReferences and access the Subscription data.  This is not a real resource.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Subscribable is a skeleton type wrapping Subscribable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize SubscribableType ObjectReferences and access the Subscription data.  This is not a real resource.
+     */
     @JsonProperty("spec")
     public SubscribableSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Subscribable is a skeleton type wrapping Subscribable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize SubscribableType ObjectReferences and access the Subscription data.  This is not a real resource.
+     */
     @JsonProperty("spec")
     public void setSpec(SubscribableSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Subscribable is a skeleton type wrapping Subscribable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize SubscribableType ObjectReferences and access the Subscription data.  This is not a real resource.
+     */
     @JsonProperty("status")
     public SubscribableStatus getStatus() {
         return status;
     }
 
+    /**
+     * Subscribable is a skeleton type wrapping Subscribable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize SubscribableType ObjectReferences and access the Subscription data.  This is not a real resource.
+     */
     @JsonProperty("status")
     public void setStatus(SubscribableStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/SubscribableList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/SubscribableList.java
index 8916c3eecd9..5fdb67a1e56 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/SubscribableList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/SubscribableList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubscribableTypeList is a list of SubscribableType resources
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class SubscribableList implements Editable<SubscribableListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.duck.v1.Subscribable>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.duck.v1.Subscribable> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SubscribableList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public SubscribableList(String apiVersion, List<io.fabric8.knative.duck.v1.Subsc
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * SubscribableTypeList is a list of SubscribableType resources
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.duck.v1.Subscribable> getItems() {
         return items;
     }
 
+    /**
+     * SubscribableTypeList is a list of SubscribableType resources
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.duck.v1.Subscribable> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SubscribableTypeList is a list of SubscribableType resources
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SubscribableTypeList is a list of SubscribableType resources
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/SubscribableSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/SubscribableSpec.java
index c0e677637b9..c02f0d80258 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/SubscribableSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/SubscribableSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubscribableSpec shows how we expect folks to embed Subscribable in their Spec field.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public SubscribableSpec(List<SubscriberSpec> subscribers) {
         this.subscribers = subscribers;
     }
 
+    /**
+     * This is the list of subscriptions for this subscribable.
+     */
     @JsonProperty("subscribers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SubscriberSpec> getSubscribers() {
         return subscribers;
     }
 
+    /**
+     * This is the list of subscriptions for this subscribable.
+     */
     @JsonProperty("subscribers")
     public void setSubscribers(List<SubscriberSpec> subscribers) {
         this.subscribers = subscribers;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/SubscribableStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/SubscribableStatus.java
index ff19946ff24..0e860f3331c 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/SubscribableStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/SubscribableStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubscribableStatus is the schema for the subscribable's status portion of the status section of the resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public SubscribableStatus(List<SubscriberStatus> subscribers) {
         this.subscribers = subscribers;
     }
 
+    /**
+     * This is the list of subscription's statuses for this channel.
+     */
     @JsonProperty("subscribers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SubscriberStatus> getSubscribers() {
         return subscribers;
     }
 
+    /**
+     * This is the list of subscription's statuses for this channel.
+     */
     @JsonProperty("subscribers")
     public void setSubscribers(List<SubscriberStatus> subscribers) {
         this.subscribers = subscribers;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/SubscriberSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/SubscriberSpec.java
index 35768ba2e79..219dc692dc1 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/SubscriberSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/SubscriberSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubscriberSpec defines a single subscriber to a Subscribable.<br><p> <br><p> At least one of SubscriberURI and ReplyURI must be present
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -118,111 +121,177 @@ public SubscriberSpec(AuthStatus auth, DeliverySpec delivery, Long generation, S
         this.uid = uid;
     }
 
+    /**
+     * SubscriberSpec defines a single subscriber to a Subscribable.<br><p> <br><p> At least one of SubscriberURI and ReplyURI must be present
+     */
     @JsonProperty("auth")
     public AuthStatus getAuth() {
         return auth;
     }
 
+    /**
+     * SubscriberSpec defines a single subscriber to a Subscribable.<br><p> <br><p> At least one of SubscriberURI and ReplyURI must be present
+     */
     @JsonProperty("auth")
     public void setAuth(AuthStatus auth) {
         this.auth = auth;
     }
 
+    /**
+     * SubscriberSpec defines a single subscriber to a Subscribable.<br><p> <br><p> At least one of SubscriberURI and ReplyURI must be present
+     */
     @JsonProperty("delivery")
     public DeliverySpec getDelivery() {
         return delivery;
     }
 
+    /**
+     * SubscriberSpec defines a single subscriber to a Subscribable.<br><p> <br><p> At least one of SubscriberURI and ReplyURI must be present
+     */
     @JsonProperty("delivery")
     public void setDelivery(DeliverySpec delivery) {
         this.delivery = delivery;
     }
 
+    /**
+     * Generation of the origin of the subscriber with uid:UID.
+     */
     @JsonProperty("generation")
     public Long getGeneration() {
         return generation;
     }
 
+    /**
+     * Generation of the origin of the subscriber with uid:UID.
+     */
     @JsonProperty("generation")
     public void setGeneration(Long generation) {
         this.generation = generation;
     }
 
+    /**
+     * Name is used to identify the original subscription object.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is used to identify the original subscription object.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * ReplyAudience is the OIDC audience for the replyUri.
+     */
     @JsonProperty("replyAudience")
     public String getReplyAudience() {
         return replyAudience;
     }
 
+    /**
+     * ReplyAudience is the OIDC audience for the replyUri.
+     */
     @JsonProperty("replyAudience")
     public void setReplyAudience(String replyAudience) {
         this.replyAudience = replyAudience;
     }
 
+    /**
+     * ReplyCACerts is the Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468 for the replyUri.
+     */
     @JsonProperty("replyCACerts")
     public String getReplyCACerts() {
         return replyCACerts;
     }
 
+    /**
+     * ReplyCACerts is the Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468 for the replyUri.
+     */
     @JsonProperty("replyCACerts")
     public void setReplyCACerts(String replyCACerts) {
         this.replyCACerts = replyCACerts;
     }
 
+    /**
+     * SubscriberSpec defines a single subscriber to a Subscribable.<br><p> <br><p> At least one of SubscriberURI and ReplyURI must be present
+     */
     @JsonProperty("replyUri")
     public String getReplyUri() {
         return replyUri;
     }
 
+    /**
+     * SubscriberSpec defines a single subscriber to a Subscribable.<br><p> <br><p> At least one of SubscriberURI and ReplyURI must be present
+     */
     @JsonProperty("replyUri")
     public void setReplyUri(String replyUri) {
         this.replyUri = replyUri;
     }
 
+    /**
+     * SubscriberAudience is the OIDC audience for the subscriberUri.
+     */
     @JsonProperty("subscriberAudience")
     public String getSubscriberAudience() {
         return subscriberAudience;
     }
 
+    /**
+     * SubscriberAudience is the OIDC audience for the subscriberUri.
+     */
     @JsonProperty("subscriberAudience")
     public void setSubscriberAudience(String subscriberAudience) {
         this.subscriberAudience = subscriberAudience;
     }
 
+    /**
+     * SubscriberCACerts is the Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468 for the subscriberUri
+     */
     @JsonProperty("subscriberCACerts")
     public String getSubscriberCACerts() {
         return subscriberCACerts;
     }
 
+    /**
+     * SubscriberCACerts is the Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468 for the subscriberUri
+     */
     @JsonProperty("subscriberCACerts")
     public void setSubscriberCACerts(String subscriberCACerts) {
         this.subscriberCACerts = subscriberCACerts;
     }
 
+    /**
+     * SubscriberSpec defines a single subscriber to a Subscribable.<br><p> <br><p> At least one of SubscriberURI and ReplyURI must be present
+     */
     @JsonProperty("subscriberUri")
     public String getSubscriberUri() {
         return subscriberUri;
     }
 
+    /**
+     * SubscriberSpec defines a single subscriber to a Subscribable.<br><p> <br><p> At least one of SubscriberURI and ReplyURI must be present
+     */
     @JsonProperty("subscriberUri")
     public void setSubscriberUri(String subscriberUri) {
         this.subscriberUri = subscriberUri;
     }
 
+    /**
+     * UID is used to understand the origin of the subscriber.
+     */
     @JsonProperty("uid")
     public String getUid() {
         return uid;
     }
 
+    /**
+     * UID is used to understand the origin of the subscriber.
+     */
     @JsonProperty("uid")
     public void setUid(String uid) {
         this.uid = uid;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/SubscriberStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/SubscriberStatus.java
index f5f47fa6d8c..1cc321368f0 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/SubscriberStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/SubscriberStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubscriberStatus defines the status of a single subscriber to a Channel.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public SubscriberStatus(AuthStatus auth, String message, Long observedGeneration
         this.uid = uid;
     }
 
+    /**
+     * SubscriberStatus defines the status of a single subscriber to a Channel.
+     */
     @JsonProperty("auth")
     public AuthStatus getAuth() {
         return auth;
     }
 
+    /**
+     * SubscriberStatus defines the status of a single subscriber to a Channel.
+     */
     @JsonProperty("auth")
     public void setAuth(AuthStatus auth) {
         this.auth = auth;
     }
 
+    /**
+     * A human readable message indicating details of Ready status.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * A human readable message indicating details of Ready status.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Generation of the origin of the subscriber with uid:UID.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * Generation of the origin of the subscriber with uid:UID.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Status of the subscriber.
+     */
     @JsonProperty("ready")
     public String getReady() {
         return ready;
     }
 
+    /**
+     * Status of the subscriber.
+     */
     @JsonProperty("ready")
     public void setReady(String ready) {
         this.ready = ready;
     }
 
+    /**
+     * UID is used to understand the origin of the subscriber.
+     */
     @JsonProperty("uid")
     public String getUid() {
         return uid;
     }
 
+    /**
+     * UID is used to understand the origin of the subscriber.
+     */
     @JsonProperty("uid")
     public void setUid(String uid) {
         this.uid = uid;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/WithPod.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/WithPod.java
index 088df26e8e0..32d926d48fa 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/WithPod.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/WithPod.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WithPod is the shell that demonstrates how PodSpecable types wrap a PodSpec.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class WithPod implements Editable<WithPodBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "WithPod";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public WithPod(String apiVersion, String kind, ObjectMeta metadata, WithPodSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * WithPod is the shell that demonstrates how PodSpecable types wrap a PodSpec.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * WithPod is the shell that demonstrates how PodSpecable types wrap a PodSpec.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * WithPod is the shell that demonstrates how PodSpecable types wrap a PodSpec.
+     */
     @JsonProperty("spec")
     public WithPodSpec getSpec() {
         return spec;
     }
 
+    /**
+     * WithPod is the shell that demonstrates how PodSpecable types wrap a PodSpec.
+     */
     @JsonProperty("spec")
     public void setSpec(WithPodSpec spec) {
         this.spec = spec;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/WithPodList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/WithPodList.java
index 8ee492e8c5e..63053b76bae 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/WithPodList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/WithPodList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WithPodList is a list of WithPod resources
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class WithPodList implements Editable<WithPodListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.duck.v1.WithPod>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.duck.v1.WithPod> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "WithPodList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public WithPodList(String apiVersion, List<io.fabric8.knative.duck.v1.WithPod> i
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * WithPodList is a list of WithPod resources
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.duck.v1.WithPod> getItems() {
         return items;
     }
 
+    /**
+     * WithPodList is a list of WithPod resources
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.duck.v1.WithPod> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * WithPodList is a list of WithPod resources
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * WithPodList is a list of WithPod resources
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/WithPodSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/WithPodSpec.java
index 1ec4c19add8..554de8e9a41 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/WithPodSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1/WithPodSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WithPodSpec is the shell around the PodSpecable within WithPod.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public WithPodSpec(PodSpecable template) {
         this.template = template;
     }
 
+    /**
+     * WithPodSpec is the shell around the PodSpecable within WithPod.
+     */
     @JsonProperty("template")
     public PodSpecable getTemplate() {
         return template;
     }
 
+    /**
+     * WithPodSpec is the shell around the PodSpecable within WithPod.
+     */
     @JsonProperty("template")
     public void setTemplate(PodSpecable template) {
         this.template = template;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/AddressStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/AddressStatus.java
index 11a9e3a92aa..753798f4ad2 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/AddressStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/AddressStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AddressStatus shows how we expect folks to embed Addressable in their Status field.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public AddressStatus(Addressable address, List<Addressable> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * AddressStatus shows how we expect folks to embed Addressable in their Status field.
+     */
     @JsonProperty("address")
     public Addressable getAddress() {
         return address;
     }
 
+    /**
+     * AddressStatus shows how we expect folks to embed Addressable in their Status field.
+     */
     @JsonProperty("address")
     public void setAddress(Addressable address) {
         this.address = address;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Addressable> getAddresses() {
         return addresses;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<Addressable> addresses) {
         this.addresses = addresses;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/Addressable.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/Addressable.java
index 26a3ab8fa77..1575e98629b 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/Addressable.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/Addressable.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Addressable provides a generic mechanism for a custom resource definition to indicate a destination for message delivery.<br><p> <br><p> Addressable is the schema for the destination information. This is typically stored in the object's `status`, as this information may be generated by the controller.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public Addressable(String hostname) {
         this.hostname = hostname;
     }
 
+    /**
+     * Addressable provides a generic mechanism for a custom resource definition to indicate a destination for message delivery.<br><p> <br><p> Addressable is the schema for the destination information. This is typically stored in the object's `status`, as this information may be generated by the controller.
+     */
     @JsonProperty("hostname")
     public String getHostname() {
         return hostname;
     }
 
+    /**
+     * Addressable provides a generic mechanism for a custom resource definition to indicate a destination for message delivery.<br><p> <br><p> Addressable is the schema for the destination information. This is typically stored in the object's `status`, as this information may be generated by the controller.
+     */
     @JsonProperty("hostname")
     public void setHostname(String hostname) {
         this.hostname = hostname;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/AddressableType.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/AddressableType.java
index 17a5c87c737..2ee33217ef1 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/AddressableType.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/AddressableType.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AddressableType is a skeleton type wrapping Addressable in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Addressable ObjectReferences and access the Addressable data.  This is not a real resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class AddressableType implements Editable<AddressableTypeBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AddressableType";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public AddressableType(String apiVersion, String kind, ObjectMeta metadata, Addr
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AddressableType is a skeleton type wrapping Addressable in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Addressable ObjectReferences and access the Addressable data.  This is not a real resource.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AddressableType is a skeleton type wrapping Addressable in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Addressable ObjectReferences and access the Addressable data.  This is not a real resource.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * AddressableType is a skeleton type wrapping Addressable in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Addressable ObjectReferences and access the Addressable data.  This is not a real resource.
+     */
     @JsonProperty("status")
     public AddressStatus getStatus() {
         return status;
     }
 
+    /**
+     * AddressableType is a skeleton type wrapping Addressable in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Addressable ObjectReferences and access the Addressable data.  This is not a real resource.
+     */
     @JsonProperty("status")
     public void setStatus(AddressStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/AddressableTypeList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/AddressableTypeList.java
index a09eb4eee31..305e498e13e 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/AddressableTypeList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/AddressableTypeList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AddressableTypeList is a list of AddressableType resources
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class AddressableTypeList implements Editable<AddressableTypeListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.duck.v1alpha1.AddressableType>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.duck.v1alpha1.AddressableType> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AddressableTypeList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public AddressableTypeList(String apiVersion, List<io.fabric8.knative.duck.v1alp
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * AddressableTypeList is a list of AddressableType resources
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.duck.v1alpha1.AddressableType> getItems() {
         return items;
     }
 
+    /**
+     * AddressableTypeList is a list of AddressableType resources
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.duck.v1alpha1.AddressableType> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AddressableTypeList is a list of AddressableType resources
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AddressableTypeList is a list of AddressableType resources
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/Binding.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/Binding.java
index e963edc72ad..c1f8efe395c 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/Binding.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/Binding.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Binding is a duck type that specifies the partial schema to which all Binding implementations should adhere.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Binding implements Editable<BindingBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Binding";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public Binding(String apiVersion, String kind, ObjectMeta metadata, BindingSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Binding is a duck type that specifies the partial schema to which all Binding implementations should adhere.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Binding is a duck type that specifies the partial schema to which all Binding implementations should adhere.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Binding is a duck type that specifies the partial schema to which all Binding implementations should adhere.
+     */
     @JsonProperty("spec")
     public BindingSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Binding is a duck type that specifies the partial schema to which all Binding implementations should adhere.
+     */
     @JsonProperty("spec")
     public void setSpec(BindingSpec spec) {
         this.spec = spec;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/BindingList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/BindingList.java
index ea56e0ff22b..87f37d89876 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/BindingList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/BindingList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BindingList is a list of Binding resources
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class BindingList implements Editable<BindingListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.duck.v1alpha1.Binding>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.duck.v1alpha1.Binding> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "BindingList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public BindingList(String apiVersion, List<io.fabric8.knative.duck.v1alpha1.Bind
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * BindingList is a list of Binding resources
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.duck.v1alpha1.Binding> getItems() {
         return items;
     }
 
+    /**
+     * BindingList is a list of Binding resources
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.duck.v1alpha1.Binding> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * BindingList is a list of Binding resources
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * BindingList is a list of Binding resources
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/BindingSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/BindingSpec.java
index 01f5bb22a2e..45865f3e067 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/BindingSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/BindingSpec.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BindingSpec specifies the spec portion of the Binding partial-schema.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,11 +82,17 @@ public BindingSpec(Reference subject) {
         this.subject = subject;
     }
 
+    /**
+     * BindingSpec specifies the spec portion of the Binding partial-schema.
+     */
     @JsonProperty("subject")
     public Reference getSubject() {
         return subject;
     }
 
+    /**
+     * BindingSpec specifies the spec portion of the Binding partial-schema.
+     */
     @JsonProperty("subject")
     public void setSubject(Reference subject) {
         this.subject = subject;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/LegacyTarget.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/LegacyTarget.java
index cc082795304..34a50f988ae 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/LegacyTarget.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/LegacyTarget.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LegacyTarget is a skeleton type wrapping LegacyTargetable in the manner we want to support unless they get migrated into supporting Legacy. We will typically use this type to deserialize LegacyTargetable ObjectReferences and access the LegacyTargetable data.  This is not a real resource. &#42;&#42; Do not use this for any new resources &#42;&#42;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class LegacyTarget implements Editable<LegacyTargetBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "LegacyTarget";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public LegacyTarget(String apiVersion, String kind, ObjectMeta metadata, LegacyT
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * LegacyTarget is a skeleton type wrapping LegacyTargetable in the manner we want to support unless they get migrated into supporting Legacy. We will typically use this type to deserialize LegacyTargetable ObjectReferences and access the LegacyTargetable data.  This is not a real resource. &#42;&#42; Do not use this for any new resources &#42;&#42;
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * LegacyTarget is a skeleton type wrapping LegacyTargetable in the manner we want to support unless they get migrated into supporting Legacy. We will typically use this type to deserialize LegacyTargetable ObjectReferences and access the LegacyTargetable data.  This is not a real resource. &#42;&#42; Do not use this for any new resources &#42;&#42;
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * LegacyTarget is a skeleton type wrapping LegacyTargetable in the manner we want to support unless they get migrated into supporting Legacy. We will typically use this type to deserialize LegacyTargetable ObjectReferences and access the LegacyTargetable data.  This is not a real resource. &#42;&#42; Do not use this for any new resources &#42;&#42;
+     */
     @JsonProperty("status")
     public LegacyTargetable getStatus() {
         return status;
     }
 
+    /**
+     * LegacyTarget is a skeleton type wrapping LegacyTargetable in the manner we want to support unless they get migrated into supporting Legacy. We will typically use this type to deserialize LegacyTargetable ObjectReferences and access the LegacyTargetable data.  This is not a real resource. &#42;&#42; Do not use this for any new resources &#42;&#42;
+     */
     @JsonProperty("status")
     public void setStatus(LegacyTargetable status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/LegacyTargetList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/LegacyTargetList.java
index 87c4f7d2776..8c6acb4649a 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/LegacyTargetList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/LegacyTargetList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LegacyTargetList is a list of LegacyTarget resources
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class LegacyTargetList implements Editable<LegacyTargetListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.duck.v1alpha1.LegacyTarget>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.duck.v1alpha1.LegacyTarget> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "LegacyTargetList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public LegacyTargetList(String apiVersion, List<io.fabric8.knative.duck.v1alpha1
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * LegacyTargetList is a list of LegacyTarget resources
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.duck.v1alpha1.LegacyTarget> getItems() {
         return items;
     }
 
+    /**
+     * LegacyTargetList is a list of LegacyTarget resources
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.duck.v1alpha1.LegacyTarget> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * LegacyTargetList is a list of LegacyTarget resources
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * LegacyTargetList is a list of LegacyTarget resources
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/LegacyTargetable.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/LegacyTargetable.java
index abe2ba075c7..2dccbadb30f 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/LegacyTargetable.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/LegacyTargetable.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LegacyTargetable left around until we migrate to Addressable in the dependent resources. Addressable has more structure in the way it defines the fields. LegacyTargetable only assumed a single string in the Status field and we're moving towards defining proper structs under Status rather than strings. This is to support existing resources until they migrate.<br><p> <br><p> # Do not use this for anything new, use Addressable<br><p> <br><p> LegacyTargetable is the old schema for the addressable portion of the payload<br><p> <br><p> For new resources use Addressable.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public LegacyTargetable(String domainInternal) {
         this.domainInternal = domainInternal;
     }
 
+    /**
+     * LegacyTargetable left around until we migrate to Addressable in the dependent resources. Addressable has more structure in the way it defines the fields. LegacyTargetable only assumed a single string in the Status field and we're moving towards defining proper structs under Status rather than strings. This is to support existing resources until they migrate.<br><p> <br><p> # Do not use this for anything new, use Addressable<br><p> <br><p> LegacyTargetable is the old schema for the addressable portion of the payload<br><p> <br><p> For new resources use Addressable.
+     */
     @JsonProperty("domainInternal")
     public String getDomainInternal() {
         return domainInternal;
     }
 
+    /**
+     * LegacyTargetable left around until we migrate to Addressable in the dependent resources. Addressable has more structure in the way it defines the fields. LegacyTargetable only assumed a single string in the Status field and we're moving towards defining proper structs under Status rather than strings. This is to support existing resources until they migrate.<br><p> <br><p> # Do not use this for anything new, use Addressable<br><p> <br><p> LegacyTargetable is the old schema for the addressable portion of the payload<br><p> <br><p> For new resources use Addressable.
+     */
     @JsonProperty("domainInternal")
     public void setDomainInternal(String domainInternal) {
         this.domainInternal = domainInternal;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/Placeable.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/Placeable.java
index 815172b39a9..c687d5854cd 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/Placeable.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/Placeable.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Placeable is a list of podName and virtual replicas pairs. Each pair represents the assignment of virtual replicas to a pod
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public Placeable(Integer maxAllowedVReplicas, List<Placement> placements) {
         this.placements = placements;
     }
 
+    /**
+     * Placeable is a list of podName and virtual replicas pairs. Each pair represents the assignment of virtual replicas to a pod
+     */
     @JsonProperty("maxAllowedVReplicas")
     public Integer getMaxAllowedVReplicas() {
         return maxAllowedVReplicas;
     }
 
+    /**
+     * Placeable is a list of podName and virtual replicas pairs. Each pair represents the assignment of virtual replicas to a pod
+     */
     @JsonProperty("maxAllowedVReplicas")
     public void setMaxAllowedVReplicas(Integer maxAllowedVReplicas) {
         this.maxAllowedVReplicas = maxAllowedVReplicas;
     }
 
+    /**
+     * Placeable is a list of podName and virtual replicas pairs. Each pair represents the assignment of virtual replicas to a pod
+     */
     @JsonProperty("placements")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Placement> getPlacements() {
         return placements;
     }
 
+    /**
+     * Placeable is a list of podName and virtual replicas pairs. Each pair represents the assignment of virtual replicas to a pod
+     */
     @JsonProperty("placements")
     public void setPlacements(List<Placement> placements) {
         this.placements = placements;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/PlaceableType.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/PlaceableType.java
index 668009f761e..efb9b540920 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/PlaceableType.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/PlaceableType.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PlaceableType is a skeleton type wrapping Placeable in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Placeable ObjectReferences and access the Placeable data.  This is not a real resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class PlaceableType implements Editable<PlaceableTypeBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PlaceableType";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public PlaceableType(String apiVersion, String kind, ObjectMeta metadata, Placea
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PlaceableType is a skeleton type wrapping Placeable in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Placeable ObjectReferences and access the Placeable data.  This is not a real resource.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PlaceableType is a skeleton type wrapping Placeable in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Placeable ObjectReferences and access the Placeable data.  This is not a real resource.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PlaceableType is a skeleton type wrapping Placeable in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Placeable ObjectReferences and access the Placeable data.  This is not a real resource.
+     */
     @JsonProperty("status")
     public PlaceableStatus getStatus() {
         return status;
     }
 
+    /**
+     * PlaceableType is a skeleton type wrapping Placeable in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Placeable ObjectReferences and access the Placeable data.  This is not a real resource.
+     */
     @JsonProperty("status")
     public void setStatus(PlaceableStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/Placement.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/Placement.java
index b54f21e425b..505f7b7f2e1 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/Placement.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/Placement.java
@@ -82,21 +82,33 @@ public Placement(String podName, Integer vreplicas) {
         this.vreplicas = vreplicas;
     }
 
+    /**
+     * PodName is the name of the pod where the resource is placed
+     */
     @JsonProperty("podName")
     public String getPodName() {
         return podName;
     }
 
+    /**
+     * PodName is the name of the pod where the resource is placed
+     */
     @JsonProperty("podName")
     public void setPodName(String podName) {
         this.podName = podName;
     }
 
+    /**
+     * VReplicas is the number of virtual replicas assigned to in the pod
+     */
     @JsonProperty("vreplicas")
     public Integer getVreplicas() {
         return vreplicas;
     }
 
+    /**
+     * VReplicas is the number of virtual replicas assigned to in the pod
+     */
     @JsonProperty("vreplicas")
     public void setVreplicas(Integer vreplicas) {
         this.vreplicas = vreplicas;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/Target.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/Target.java
index 7dd278f5602..b6cb496d170 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/Target.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/Target.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Target is a skeleton type wrapping Targetable in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Targetable ObjectReferences and access the Targetable data.  This is not a real resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Target implements Editable<TargetBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Target";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public Target(String apiVersion, String kind, ObjectMeta metadata, TargetStatus
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Target is a skeleton type wrapping Targetable in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Targetable ObjectReferences and access the Targetable data.  This is not a real resource.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Target is a skeleton type wrapping Targetable in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Targetable ObjectReferences and access the Targetable data.  This is not a real resource.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Target is a skeleton type wrapping Targetable in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Targetable ObjectReferences and access the Targetable data.  This is not a real resource.
+     */
     @JsonProperty("status")
     public TargetStatus getStatus() {
         return status;
     }
 
+    /**
+     * Target is a skeleton type wrapping Targetable in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Targetable ObjectReferences and access the Targetable data.  This is not a real resource.
+     */
     @JsonProperty("status")
     public void setStatus(TargetStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/TargetList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/TargetList.java
index 4a07accbeb3..09a69ba4d63 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/TargetList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/TargetList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TargetList is a list of Target resources
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class TargetList implements Editable<TargetListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.duck.v1alpha1.Target>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.duck.v1alpha1.Target> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TargetList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TargetList(String apiVersion, List<io.fabric8.knative.duck.v1alpha1.Targe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * TargetList is a list of Target resources
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.duck.v1alpha1.Target> getItems() {
         return items;
     }
 
+    /**
+     * TargetList is a list of Target resources
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.duck.v1alpha1.Target> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TargetList is a list of Target resources
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TargetList is a list of Target resources
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/TargetStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/TargetStatus.java
index c5de2c9f6af..b00045e1cb1 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/TargetStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/TargetStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TargetStatus shows how we expect folks to embed Targetable in their Status field.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public TargetStatus(Targetable targetable) {
         this.targetable = targetable;
     }
 
+    /**
+     * TargetStatus shows how we expect folks to embed Targetable in their Status field.
+     */
     @JsonProperty("targetable")
     public Targetable getTargetable() {
         return targetable;
     }
 
+    /**
+     * TargetStatus shows how we expect folks to embed Targetable in their Status field.
+     */
     @JsonProperty("targetable")
     public void setTargetable(Targetable targetable) {
         this.targetable = targetable;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/Targetable.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/Targetable.java
index 258bc0bb6d8..94ce1e7b8cb 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/Targetable.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1alpha1/Targetable.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Targetable is an earlier version of the Callable interface. Callable is a higher-level interface which implements Addressable but further promises that the destination may synchronously return response messages in reply to a message.<br><p> <br><p> Targetable implementations should instead implement Addressable and include an `eventing.knative.dev/returns=any` annotation.<br><p> <br><p> Targetable is retired; implement Addressable for now.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public Targetable(String domainInternal) {
         this.domainInternal = domainInternal;
     }
 
+    /**
+     * Targetable is an earlier version of the Callable interface. Callable is a higher-level interface which implements Addressable but further promises that the destination may synchronously return response messages in reply to a message.<br><p> <br><p> Targetable implementations should instead implement Addressable and include an `eventing.knative.dev/returns=any` annotation.<br><p> <br><p> Targetable is retired; implement Addressable for now.
+     */
     @JsonProperty("domainInternal")
     public String getDomainInternal() {
         return domainInternal;
     }
 
+    /**
+     * Targetable is an earlier version of the Callable interface. Callable is a higher-level interface which implements Addressable but further promises that the destination may synchronously return response messages in reply to a message.<br><p> <br><p> Targetable implementations should instead implement Addressable and include an `eventing.knative.dev/returns=any` annotation.<br><p> <br><p> Targetable is retired; implement Addressable for now.
+     */
     @JsonProperty("domainInternal")
     public void setDomainInternal(String domainInternal) {
         this.domainInternal = domainInternal;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/AddressStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/AddressStatus.java
index c8a2b582d16..d7c4b7585df 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/AddressStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/AddressStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AddressStatus shows how we expect folks to embed Addressable in their Status field.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public AddressStatus(Addressable address, List<Addressable> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * AddressStatus shows how we expect folks to embed Addressable in their Status field.
+     */
     @JsonProperty("address")
     public Addressable getAddress() {
         return address;
     }
 
+    /**
+     * AddressStatus shows how we expect folks to embed Addressable in their Status field.
+     */
     @JsonProperty("address")
     public void setAddress(Addressable address) {
         this.address = address;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Addressable> getAddresses() {
         return addresses;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<Addressable> addresses) {
         this.addresses = addresses;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/Addressable.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/Addressable.java
index 73ec5deaf93..a4c2c26cea5 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/Addressable.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/Addressable.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Addressable provides a generic mechanism for a custom resource definition to indicate a destination for message delivery.<br><p> <br><p> Addressable is the schema for the destination information. This is typically stored in the object's `status`, as this information may be generated by the controller.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public Addressable(String cACerts, String name, String url) {
         this.url = url;
     }
 
+    /**
+     * CACerts is the Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("CACerts")
     public String getCACerts() {
         return cACerts;
     }
 
+    /**
+     * CACerts is the Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("CACerts")
     public void setCACerts(String cACerts) {
         this.cACerts = cACerts;
     }
 
+    /**
+     * Name is the name of the address.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the address.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Addressable provides a generic mechanism for a custom resource definition to indicate a destination for message delivery.<br><p> <br><p> Addressable is the schema for the destination information. This is typically stored in the object's `status`, as this information may be generated by the controller.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * Addressable provides a generic mechanism for a custom resource definition to indicate a destination for message delivery.<br><p> <br><p> Addressable is the schema for the destination information. This is typically stored in the object's `status`, as this information may be generated by the controller.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/AddressableType.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/AddressableType.java
index 5d6553c751d..8b102c5b4a4 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/AddressableType.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/AddressableType.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AddressableType is a skeleton type wrapping Addressable in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Addressable ObjectReferences and access the Addressable data.  This is not a real resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class AddressableType implements Editable<AddressableTypeBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AddressableType";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public AddressableType(String apiVersion, String kind, ObjectMeta metadata, Addr
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AddressableType is a skeleton type wrapping Addressable in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Addressable ObjectReferences and access the Addressable data.  This is not a real resource.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AddressableType is a skeleton type wrapping Addressable in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Addressable ObjectReferences and access the Addressable data.  This is not a real resource.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * AddressableType is a skeleton type wrapping Addressable in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Addressable ObjectReferences and access the Addressable data.  This is not a real resource.
+     */
     @JsonProperty("status")
     public AddressStatus getStatus() {
         return status;
     }
 
+    /**
+     * AddressableType is a skeleton type wrapping Addressable in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Addressable ObjectReferences and access the Addressable data.  This is not a real resource.
+     */
     @JsonProperty("status")
     public void setStatus(AddressStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/AddressableTypeList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/AddressableTypeList.java
index 2cedd1df658..7bb8e940f3a 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/AddressableTypeList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/AddressableTypeList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AddressableTypeList is a list of AddressableType resources
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class AddressableTypeList implements Editable<AddressableTypeListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.duck.v1beta1.AddressableType>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.duck.v1beta1.AddressableType> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AddressableTypeList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public AddressableTypeList(String apiVersion, List<io.fabric8.knative.duck.v1bet
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * AddressableTypeList is a list of AddressableType resources
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.duck.v1beta1.AddressableType> getItems() {
         return items;
     }
 
+    /**
+     * AddressableTypeList is a list of AddressableType resources
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.duck.v1beta1.AddressableType> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AddressableTypeList is a list of AddressableType resources
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AddressableTypeList is a list of AddressableType resources
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/Binding.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/Binding.java
index 5d61a021b3d..78cb664e495 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/Binding.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/Binding.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Binding is a duck type that specifies the partial schema to which all Binding implementations should adhere.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Binding implements Editable<BindingBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Binding";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public Binding(String apiVersion, String kind, ObjectMeta metadata, BindingSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Binding is a duck type that specifies the partial schema to which all Binding implementations should adhere.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Binding is a duck type that specifies the partial schema to which all Binding implementations should adhere.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Binding is a duck type that specifies the partial schema to which all Binding implementations should adhere.
+     */
     @JsonProperty("spec")
     public BindingSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Binding is a duck type that specifies the partial schema to which all Binding implementations should adhere.
+     */
     @JsonProperty("spec")
     public void setSpec(BindingSpec spec) {
         this.spec = spec;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/BindingList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/BindingList.java
index f93fb2f219d..65936902a61 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/BindingList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/BindingList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BindingList is a list of Binding resources
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class BindingList implements Editable<BindingListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.duck.v1beta1.Binding>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.duck.v1beta1.Binding> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "BindingList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public BindingList(String apiVersion, List<io.fabric8.knative.duck.v1beta1.Bindi
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * BindingList is a list of Binding resources
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.duck.v1beta1.Binding> getItems() {
         return items;
     }
 
+    /**
+     * BindingList is a list of Binding resources
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.duck.v1beta1.Binding> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * BindingList is a list of Binding resources
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * BindingList is a list of Binding resources
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/BindingSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/BindingSpec.java
index 2fdee3eb08c..496dfb84a4f 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/BindingSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/BindingSpec.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BindingSpec specifies the spec portion of the Binding partial-schema.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,11 +82,17 @@ public BindingSpec(Reference subject) {
         this.subject = subject;
     }
 
+    /**
+     * BindingSpec specifies the spec portion of the Binding partial-schema.
+     */
     @JsonProperty("subject")
     public Reference getSubject() {
         return subject;
     }
 
+    /**
+     * BindingSpec specifies the spec portion of the Binding partial-schema.
+     */
     @JsonProperty("subject")
     public void setSubject(Reference subject) {
         this.subject = subject;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/Channelable.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/Channelable.java
index 749a6b01438..3afd5e5d21f 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/Channelable.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/Channelable.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Channelable is a skeleton type wrapping Subscribable and Addressable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize Channelable ObjectReferences and access their subscription and address data.  This is not a real resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Channelable implements Editable<ChannelableBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Channelable";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Channelable(String apiVersion, String kind, ObjectMeta metadata, Channela
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Channelable is a skeleton type wrapping Subscribable and Addressable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize Channelable ObjectReferences and access their subscription and address data.  This is not a real resource.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Channelable is a skeleton type wrapping Subscribable and Addressable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize Channelable ObjectReferences and access their subscription and address data.  This is not a real resource.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Channelable is a skeleton type wrapping Subscribable and Addressable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize Channelable ObjectReferences and access their subscription and address data.  This is not a real resource.
+     */
     @JsonProperty("spec")
     public ChannelableSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Channelable is a skeleton type wrapping Subscribable and Addressable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize Channelable ObjectReferences and access their subscription and address data.  This is not a real resource.
+     */
     @JsonProperty("spec")
     public void setSpec(ChannelableSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Channelable is a skeleton type wrapping Subscribable and Addressable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize Channelable ObjectReferences and access their subscription and address data.  This is not a real resource.
+     */
     @JsonProperty("status")
     public ChannelableStatus getStatus() {
         return status;
     }
 
+    /**
+     * Channelable is a skeleton type wrapping Subscribable and Addressable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize Channelable ObjectReferences and access their subscription and address data.  This is not a real resource.
+     */
     @JsonProperty("status")
     public void setStatus(ChannelableStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/ChannelableList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/ChannelableList.java
index 6d1450c88c6..fdc4da119a5 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/ChannelableList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/ChannelableList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ChannelableList is a list of Channelable resources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ChannelableList implements Editable<ChannelableListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.duck.v1beta1.Channelable>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.duck.v1beta1.Channelable> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ChannelableList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ChannelableList(String apiVersion, List<io.fabric8.knative.duck.v1beta1.C
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ChannelableList is a list of Channelable resources.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.duck.v1beta1.Channelable> getItems() {
         return items;
     }
 
+    /**
+     * ChannelableList is a list of Channelable resources.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.duck.v1beta1.Channelable> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ChannelableList is a list of Channelable resources.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ChannelableList is a list of Channelable resources.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/ChannelableSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/ChannelableSpec.java
index ce46ef87c2e..f2c3987e775 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/ChannelableSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/ChannelableSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ChannelableSpec contains Spec of the Channelable object
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public ChannelableSpec(DeliverySpec delivery, List<SubscriberSpec> subscribers)
         this.subscribers = subscribers;
     }
 
+    /**
+     * ChannelableSpec contains Spec of the Channelable object
+     */
     @JsonProperty("delivery")
     public DeliverySpec getDelivery() {
         return delivery;
     }
 
+    /**
+     * ChannelableSpec contains Spec of the Channelable object
+     */
     @JsonProperty("delivery")
     public void setDelivery(DeliverySpec delivery) {
         this.delivery = delivery;
     }
 
+    /**
+     * This is the list of subscriptions for this subscribable.
+     */
     @JsonProperty("subscribers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SubscriberSpec> getSubscribers() {
         return subscribers;
     }
 
+    /**
+     * This is the list of subscriptions for this subscribable.
+     */
     @JsonProperty("subscribers")
     public void setSubscribers(List<SubscriberSpec> subscribers) {
         this.subscribers = subscribers;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/ChannelableStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/ChannelableStatus.java
index 4aaeb1f27c0..e79298b3cf9 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/ChannelableStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/ChannelableStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ChannelableStatus contains the Status of a Channelable object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -111,75 +114,117 @@ public ChannelableStatus(Addressable address, List<Addressable> addresses, Map<S
         this.subscribers = subscribers;
     }
 
+    /**
+     * ChannelableStatus contains the Status of a Channelable object.
+     */
     @JsonProperty("address")
     public Addressable getAddress() {
         return address;
     }
 
+    /**
+     * ChannelableStatus contains the Status of a Channelable object.
+     */
     @JsonProperty("address")
     public void setAddress(Addressable address) {
         this.address = address;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Addressable> getAddresses() {
         return addresses;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<Addressable> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ChannelableStatus contains the Status of a Channelable object.
+     */
     @JsonProperty("deadLetterChannel")
     public KReference getDeadLetterChannel() {
         return deadLetterChannel;
     }
 
+    /**
+     * ChannelableStatus contains the Status of a Channelable object.
+     */
     @JsonProperty("deadLetterChannel")
     public void setDeadLetterChannel(KReference deadLetterChannel) {
         this.deadLetterChannel = deadLetterChannel;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * This is the list of subscription's statuses for this channel.
+     */
     @JsonProperty("subscribers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SubscriberStatus> getSubscribers() {
         return subscribers;
     }
 
+    /**
+     * This is the list of subscription's statuses for this channel.
+     */
     @JsonProperty("subscribers")
     public void setSubscribers(List<SubscriberStatus> subscribers) {
         this.subscribers = subscribers;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/CloudEventOverrides.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/CloudEventOverrides.java
index 08939c2137e..b9ae222beee 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/CloudEventOverrides.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/CloudEventOverrides.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CloudEventOverrides defines arguments for a Source that control the output format of the CloudEvents produced by the Source.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,12 +82,18 @@ public CloudEventOverrides(Map<String, String> extensions) {
         this.extensions = extensions;
     }
 
+    /**
+     * Extensions specify what attribute are added or overridden on the outbound event. Each `Extensions` key-value pair are set on the event as an attribute extension independently.
+     */
     @JsonProperty("extensions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getExtensions() {
         return extensions;
     }
 
+    /**
+     * Extensions specify what attribute are added or overridden on the outbound event. Each `Extensions` key-value pair are set on the event as an attribute extension independently.
+     */
     @JsonProperty("extensions")
     public void setExtensions(Map<String, String> extensions) {
         this.extensions = extensions;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/DeliverySpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/DeliverySpec.java
index 82c406f4a1a..4c936489b4c 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/DeliverySpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/DeliverySpec.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeliverySpec contains the delivery options for event senders, such as channelable and source.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,51 +98,81 @@ public DeliverySpec(String backoffDelay, String backoffPolicy, Destination deadL
         this.timeout = timeout;
     }
 
+    /**
+     * BackoffDelay is the delay before retrying. More information on Duration format:<br><p>  - https://www.iso.org/iso-8601-date-and-time-format.html<br><p>  - https://en.wikipedia.org/wiki/ISO_8601<br><p> <br><p> For linear policy, backoff delay is backoffDelay&#42;&lt;numberOfRetries&gt;. For exponential policy, backoff delay is backoffDelay&#42;2^&lt;numberOfRetries&gt;.
+     */
     @JsonProperty("backoffDelay")
     public String getBackoffDelay() {
         return backoffDelay;
     }
 
+    /**
+     * BackoffDelay is the delay before retrying. More information on Duration format:<br><p>  - https://www.iso.org/iso-8601-date-and-time-format.html<br><p>  - https://en.wikipedia.org/wiki/ISO_8601<br><p> <br><p> For linear policy, backoff delay is backoffDelay&#42;&lt;numberOfRetries&gt;. For exponential policy, backoff delay is backoffDelay&#42;2^&lt;numberOfRetries&gt;.
+     */
     @JsonProperty("backoffDelay")
     public void setBackoffDelay(String backoffDelay) {
         this.backoffDelay = backoffDelay;
     }
 
+    /**
+     * BackoffPolicy is the retry backoff policy (linear, exponential).
+     */
     @JsonProperty("backoffPolicy")
     public String getBackoffPolicy() {
         return backoffPolicy;
     }
 
+    /**
+     * BackoffPolicy is the retry backoff policy (linear, exponential).
+     */
     @JsonProperty("backoffPolicy")
     public void setBackoffPolicy(String backoffPolicy) {
         this.backoffPolicy = backoffPolicy;
     }
 
+    /**
+     * DeliverySpec contains the delivery options for event senders, such as channelable and source.
+     */
     @JsonProperty("deadLetterSink")
     public Destination getDeadLetterSink() {
         return deadLetterSink;
     }
 
+    /**
+     * DeliverySpec contains the delivery options for event senders, such as channelable and source.
+     */
     @JsonProperty("deadLetterSink")
     public void setDeadLetterSink(Destination deadLetterSink) {
         this.deadLetterSink = deadLetterSink;
     }
 
+    /**
+     * Retry is the minimum number of retries the sender should attempt when sending an event before moving it to the dead letter sink.
+     */
     @JsonProperty("retry")
     public Integer getRetry() {
         return retry;
     }
 
+    /**
+     * Retry is the minimum number of retries the sender should attempt when sending an event before moving it to the dead letter sink.
+     */
     @JsonProperty("retry")
     public void setRetry(Integer retry) {
         this.retry = retry;
     }
 
+    /**
+     * Timeout is the timeout of each single request. More information on Duration format:<br><p>  - https://www.iso.org/iso-8601-date-and-time-format.html<br><p>  - https://en.wikipedia.org/wiki/ISO_8601
+     */
     @JsonProperty("timeout")
     public String getTimeout() {
         return timeout;
     }
 
+    /**
+     * Timeout is the timeout of each single request. More information on Duration format:<br><p>  - https://www.iso.org/iso-8601-date-and-time-format.html<br><p>  - https://en.wikipedia.org/wiki/ISO_8601
+     */
     @JsonProperty("timeout")
     public void setTimeout(String timeout) {
         this.timeout = timeout;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/DeliveryStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/DeliveryStatus.java
index 60a2d845349..02480d9000f 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/DeliveryStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/DeliveryStatus.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeliveryStatus contains the Status of an object supporting delivery options.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,11 +82,17 @@ public DeliveryStatus(KReference deadLetterChannel) {
         this.deadLetterChannel = deadLetterChannel;
     }
 
+    /**
+     * DeliveryStatus contains the Status of an object supporting delivery options.
+     */
     @JsonProperty("deadLetterChannel")
     public KReference getDeadLetterChannel() {
         return deadLetterChannel;
     }
 
+    /**
+     * DeliveryStatus contains the Status of an object supporting delivery options.
+     */
     @JsonProperty("deadLetterChannel")
     public void setDeadLetterChannel(KReference deadLetterChannel) {
         this.deadLetterChannel = deadLetterChannel;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/Destination.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/Destination.java
index 854eb7e8564..b655e0bfa83 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/Destination.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/Destination.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Destination represents a target of an invocation over HTTP.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,71 +105,113 @@ public Destination(String cACerts, String apiVersion, String kind, String name,
         this.uri = uri;
     }
 
+    /**
+     * CACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468. If set, these CAs are appended to the set of CAs provided by the Addressable target, if any.
+     */
     @JsonProperty("CACerts")
     public String getCACerts() {
         return cACerts;
     }
 
+    /**
+     * CACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468. If set, these CAs are appended to the set of CAs provided by the Addressable target, if any.
+     */
     @JsonProperty("CACerts")
     public void setCACerts(String cACerts) {
         this.cACerts = cACerts;
     }
 
+    /**
+     * Destination represents a target of an invocation over HTTP.
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * Destination represents a target of an invocation over HTTP.
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Destination represents a target of an invocation over HTTP.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Destination represents a target of an invocation over HTTP.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Destination represents a target of an invocation over HTTP.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Destination represents a target of an invocation over HTTP.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Destination represents a target of an invocation over HTTP.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Destination represents a target of an invocation over HTTP.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Destination represents a target of an invocation over HTTP.
+     */
     @JsonProperty("ref")
     public ObjectReference getRef() {
         return ref;
     }
 
+    /**
+     * Destination represents a target of an invocation over HTTP.
+     */
     @JsonProperty("ref")
     public void setRef(ObjectReference ref) {
         this.ref = ref;
     }
 
+    /**
+     * Destination represents a target of an invocation over HTTP.
+     */
     @JsonProperty("uri")
     public String getUri() {
         return uri;
     }
 
+    /**
+     * Destination represents a target of an invocation over HTTP.
+     */
     @JsonProperty("uri")
     public void setUri(String uri) {
         this.uri = uri;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/KResource.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/KResource.java
index be25184dd83..df9924643bd 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/KResource.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/KResource.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KResource is a skeleton type wrapping Conditions in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Conditions ObjectReferences and access the Conditions data.  This is not a real resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class KResource implements Editable<KResourceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KResource";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public KResource(String apiVersion, String kind, ObjectMeta metadata, Status sta
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KResource is a skeleton type wrapping Conditions in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Conditions ObjectReferences and access the Conditions data.  This is not a real resource.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KResource is a skeleton type wrapping Conditions in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Conditions ObjectReferences and access the Conditions data.  This is not a real resource.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * KResource is a skeleton type wrapping Conditions in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Conditions ObjectReferences and access the Conditions data.  This is not a real resource.
+     */
     @JsonProperty("status")
     public Status getStatus() {
         return status;
     }
 
+    /**
+     * KResource is a skeleton type wrapping Conditions in the manner we expect resource writers defining compatible resources to embed it.  We will typically use this type to deserialize Conditions ObjectReferences and access the Conditions data.  This is not a real resource.
+     */
     @JsonProperty("status")
     public void setStatus(Status status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/KResourceList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/KResourceList.java
index 8fabf723dba..bc780871f31 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/KResourceList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/KResourceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KResourceList is a list of KResource resources
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class KResourceList implements Editable<KResourceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.duck.v1beta1.KResource>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.duck.v1beta1.KResource> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KResourceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public KResourceList(String apiVersion, List<io.fabric8.knative.duck.v1beta1.KRe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * KResourceList is a list of KResource resources
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.duck.v1beta1.KResource> getItems() {
         return items;
     }
 
+    /**
+     * KResourceList is a list of KResource resources
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.duck.v1beta1.KResource> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KResourceList is a list of KResource resources
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KResourceList is a list of KResource resources
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/Source.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/Source.java
index e82f9d73b88..bb36303871f 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/Source.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/Source.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Source is the minimum resource shape to adhere to the Source Specification. This duck type is intended to allow implementors of Sources and Importers to verify their own resources meet the expectations. This is not a real resource. NOTE: The Source Specification is in progress and the shape and names could be modified until it has been accepted.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Source implements Editable<SourceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Source";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Source(String apiVersion, String kind, ObjectMeta metadata, SourceSpec sp
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Source is the minimum resource shape to adhere to the Source Specification. This duck type is intended to allow implementors of Sources and Importers to verify their own resources meet the expectations. This is not a real resource. NOTE: The Source Specification is in progress and the shape and names could be modified until it has been accepted.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Source is the minimum resource shape to adhere to the Source Specification. This duck type is intended to allow implementors of Sources and Importers to verify their own resources meet the expectations. This is not a real resource. NOTE: The Source Specification is in progress and the shape and names could be modified until it has been accepted.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Source is the minimum resource shape to adhere to the Source Specification. This duck type is intended to allow implementors of Sources and Importers to verify their own resources meet the expectations. This is not a real resource. NOTE: The Source Specification is in progress and the shape and names could be modified until it has been accepted.
+     */
     @JsonProperty("spec")
     public SourceSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Source is the minimum resource shape to adhere to the Source Specification. This duck type is intended to allow implementors of Sources and Importers to verify their own resources meet the expectations. This is not a real resource. NOTE: The Source Specification is in progress and the shape and names could be modified until it has been accepted.
+     */
     @JsonProperty("spec")
     public void setSpec(SourceSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Source is the minimum resource shape to adhere to the Source Specification. This duck type is intended to allow implementors of Sources and Importers to verify their own resources meet the expectations. This is not a real resource. NOTE: The Source Specification is in progress and the shape and names could be modified until it has been accepted.
+     */
     @JsonProperty("status")
     public SourceStatus getStatus() {
         return status;
     }
 
+    /**
+     * Source is the minimum resource shape to adhere to the Source Specification. This duck type is intended to allow implementors of Sources and Importers to verify their own resources meet the expectations. This is not a real resource. NOTE: The Source Specification is in progress and the shape and names could be modified until it has been accepted.
+     */
     @JsonProperty("status")
     public void setStatus(SourceStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/SourceList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/SourceList.java
index 70ea9876261..2939d69775b 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/SourceList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/SourceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SourceList is a list of Source resources
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class SourceList implements Editable<SourceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.duck.v1beta1.Source>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.duck.v1beta1.Source> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SourceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public SourceList(String apiVersion, List<io.fabric8.knative.duck.v1beta1.Source
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * SourceList is a list of Source resources
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.duck.v1beta1.Source> getItems() {
         return items;
     }
 
+    /**
+     * SourceList is a list of Source resources
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.duck.v1beta1.Source> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SourceList is a list of Source resources
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SourceList is a list of Source resources
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/SourceStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/SourceStatus.java
index c1c80d2ea81..a88795213a9 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/SourceStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/SourceStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SourceStatus shows how we expect folks to embed Addressable in their Status field.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,43 +98,67 @@ public SourceStatus(Map<String, String> annotations, List<Condition> conditions,
         this.sinkUri = sinkUri;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * SourceStatus shows how we expect folks to embed Addressable in their Status field.
+     */
     @JsonProperty("sinkUri")
     public String getSinkUri() {
         return sinkUri;
     }
 
+    /**
+     * SourceStatus shows how we expect folks to embed Addressable in their Status field.
+     */
     @JsonProperty("sinkUri")
     public void setSinkUri(String sinkUri) {
         this.sinkUri = sinkUri;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/Status.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/Status.java
index 5a198d0118c..14528ba6597 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/Status.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/Status.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Status shows how we expect folks to embed Conditions in their Status field. WARNING: Adding fields to this struct will add them to all Knative resources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,33 +94,51 @@ public Status(Map<String, String> annotations, List<Condition> conditions, Long
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/Subscribable.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/Subscribable.java
index 46f257e6f0d..0ad0ec55973 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/Subscribable.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/Subscribable.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Subscribable is a skeleton type wrapping Subscribable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize SubscribableType ObjectReferences and access the Subscription data.  This is not a real resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Subscribable implements Editable<SubscribableBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Subscribable";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Subscribable(String apiVersion, String kind, ObjectMeta metadata, Subscri
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Subscribable is a skeleton type wrapping Subscribable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize SubscribableType ObjectReferences and access the Subscription data.  This is not a real resource.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Subscribable is a skeleton type wrapping Subscribable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize SubscribableType ObjectReferences and access the Subscription data.  This is not a real resource.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Subscribable is a skeleton type wrapping Subscribable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize SubscribableType ObjectReferences and access the Subscription data.  This is not a real resource.
+     */
     @JsonProperty("spec")
     public SubscribableSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Subscribable is a skeleton type wrapping Subscribable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize SubscribableType ObjectReferences and access the Subscription data.  This is not a real resource.
+     */
     @JsonProperty("spec")
     public void setSpec(SubscribableSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Subscribable is a skeleton type wrapping Subscribable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize SubscribableType ObjectReferences and access the Subscription data.  This is not a real resource.
+     */
     @JsonProperty("status")
     public SubscribableStatus getStatus() {
         return status;
     }
 
+    /**
+     * Subscribable is a skeleton type wrapping Subscribable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize SubscribableType ObjectReferences and access the Subscription data.  This is not a real resource.
+     */
     @JsonProperty("status")
     public void setStatus(SubscribableStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/SubscribableList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/SubscribableList.java
index c2d92f61e82..deab7cfa8c1 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/SubscribableList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/SubscribableList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubscribableTypeList is a list of SubscribableType resources
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class SubscribableList implements Editable<SubscribableListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.duck.v1beta1.Subscribable>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "duck.knative.dev/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.duck.v1beta1.Subscribable> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SubscribableList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public SubscribableList(String apiVersion, List<io.fabric8.knative.duck.v1beta1.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * SubscribableTypeList is a list of SubscribableType resources
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.duck.v1beta1.Subscribable> getItems() {
         return items;
     }
 
+    /**
+     * SubscribableTypeList is a list of SubscribableType resources
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.duck.v1beta1.Subscribable> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SubscribableTypeList is a list of SubscribableType resources
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SubscribableTypeList is a list of SubscribableType resources
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/SubscribableSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/SubscribableSpec.java
index ba12214b883..deb890053ea 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/SubscribableSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/SubscribableSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubscribableSpec shows how we expect folks to embed Subscribable in their Spec field.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public SubscribableSpec(List<SubscriberSpec> subscribers) {
         this.subscribers = subscribers;
     }
 
+    /**
+     * This is the list of subscriptions for this subscribable.
+     */
     @JsonProperty("subscribers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SubscriberSpec> getSubscribers() {
         return subscribers;
     }
 
+    /**
+     * This is the list of subscriptions for this subscribable.
+     */
     @JsonProperty("subscribers")
     public void setSubscribers(List<SubscriberSpec> subscribers) {
         this.subscribers = subscribers;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/SubscribableStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/SubscribableStatus.java
index 35cac79b1db..e18d590dbce 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/SubscribableStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/SubscribableStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubscribableStatus is the schema for the subscribable's status portion of the status section of the resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public SubscribableStatus(List<SubscriberStatus> subscribers) {
         this.subscribers = subscribers;
     }
 
+    /**
+     * This is the list of subscription's statuses for this channel.
+     */
     @JsonProperty("subscribers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SubscriberStatus> getSubscribers() {
         return subscribers;
     }
 
+    /**
+     * This is the list of subscription's statuses for this channel.
+     */
     @JsonProperty("subscribers")
     public void setSubscribers(List<SubscriberStatus> subscribers) {
         this.subscribers = subscribers;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/SubscriberSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/SubscriberSpec.java
index e850a8fc3bd..7dbb8e51df4 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/SubscriberSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/SubscriberSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubscriberSpec defines a single subscriber to a Subscribable.<br><p> <br><p> At least one of SubscriberURI and ReplyURI must be present
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public SubscriberSpec(DeliverySpec delivery, Long generation, String replyUri, S
         this.uid = uid;
     }
 
+    /**
+     * SubscriberSpec defines a single subscriber to a Subscribable.<br><p> <br><p> At least one of SubscriberURI and ReplyURI must be present
+     */
     @JsonProperty("delivery")
     public DeliverySpec getDelivery() {
         return delivery;
     }
 
+    /**
+     * SubscriberSpec defines a single subscriber to a Subscribable.<br><p> <br><p> At least one of SubscriberURI and ReplyURI must be present
+     */
     @JsonProperty("delivery")
     public void setDelivery(DeliverySpec delivery) {
         this.delivery = delivery;
     }
 
+    /**
+     * Generation of the origin of the subscriber with uid:UID.
+     */
     @JsonProperty("generation")
     public Long getGeneration() {
         return generation;
     }
 
+    /**
+     * Generation of the origin of the subscriber with uid:UID.
+     */
     @JsonProperty("generation")
     public void setGeneration(Long generation) {
         this.generation = generation;
     }
 
+    /**
+     * SubscriberSpec defines a single subscriber to a Subscribable.<br><p> <br><p> At least one of SubscriberURI and ReplyURI must be present
+     */
     @JsonProperty("replyUri")
     public String getReplyUri() {
         return replyUri;
     }
 
+    /**
+     * SubscriberSpec defines a single subscriber to a Subscribable.<br><p> <br><p> At least one of SubscriberURI and ReplyURI must be present
+     */
     @JsonProperty("replyUri")
     public void setReplyUri(String replyUri) {
         this.replyUri = replyUri;
     }
 
+    /**
+     * SubscriberSpec defines a single subscriber to a Subscribable.<br><p> <br><p> At least one of SubscriberURI and ReplyURI must be present
+     */
     @JsonProperty("subscriberUri")
     public String getSubscriberUri() {
         return subscriberUri;
     }
 
+    /**
+     * SubscriberSpec defines a single subscriber to a Subscribable.<br><p> <br><p> At least one of SubscriberURI and ReplyURI must be present
+     */
     @JsonProperty("subscriberUri")
     public void setSubscriberUri(String subscriberUri) {
         this.subscriberUri = subscriberUri;
     }
 
+    /**
+     * UID is used to understand the origin of the subscriber.
+     */
     @JsonProperty("uid")
     public String getUid() {
         return uid;
     }
 
+    /**
+     * UID is used to understand the origin of the subscriber.
+     */
     @JsonProperty("uid")
     public void setUid(String uid) {
         this.uid = uid;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/SubscriberStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/SubscriberStatus.java
index 50fca9bd018..1d6bd282854 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/SubscriberStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/duck/v1beta1/SubscriberStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubscriberStatus defines the status of a single subscriber to a Channel.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public SubscriberStatus(String message, Long observedGeneration, String ready, S
         this.uid = uid;
     }
 
+    /**
+     * A human readable message indicating details of Ready status.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * A human readable message indicating details of Ready status.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Generation of the origin of the subscriber with uid:UID.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * Generation of the origin of the subscriber with uid:UID.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Status of the subscriber.
+     */
     @JsonProperty("ready")
     public String getReady() {
         return ready;
     }
 
+    /**
+     * Status of the subscriber.
+     */
     @JsonProperty("ready")
     public void setReady(String ready) {
         this.ready = ready;
     }
 
+    /**
+     * UID is used to understand the origin of the subscriber.
+     */
     @JsonProperty("uid")
     public String getUid() {
         return uid;
     }
 
+    /**
+     * UID is used to understand the origin of the subscriber.
+     */
     @JsonProperty("uid")
     public void setUid(String uid) {
         this.uid = uid;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/pkg/apis/common/integration/v1alpha1/AWSCommon.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/pkg/apis/common/integration/v1alpha1/AWSCommon.java
index 2d4b4528a9c..fbe23a056aa 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/pkg/apis/common/integration/v1alpha1/AWSCommon.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/pkg/apis/common/integration/v1alpha1/AWSCommon.java
@@ -86,31 +86,49 @@ public AWSCommon(Boolean overrideEndpoint, String region, String uriEndpointOver
         this.uriEndpointOverride = uriEndpointOverride;
     }
 
+    /**
+     * Override endpoint URI
+     */
     @JsonProperty("overrideEndpoint")
     public Boolean getOverrideEndpoint() {
         return overrideEndpoint;
     }
 
+    /**
+     * Override endpoint URI
+     */
     @JsonProperty("overrideEndpoint")
     public void setOverrideEndpoint(Boolean overrideEndpoint) {
         this.overrideEndpoint = overrideEndpoint;
     }
 
+    /**
+     * Auth is the S3 authentication (accessKey/secretKey) configuration.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Auth is the S3 authentication (accessKey/secretKey) configuration.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * AWS region
+     */
     @JsonProperty("uriEndpointOverride")
     public String getUriEndpointOverride() {
         return uriEndpointOverride;
     }
 
+    /**
+     * AWS region
+     */
     @JsonProperty("uriEndpointOverride")
     public void setUriEndpointOverride(String uriEndpointOverride) {
         this.uriEndpointOverride = uriEndpointOverride;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/pkg/apis/common/integration/v1alpha1/AWSDDBStreams.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/pkg/apis/common/integration/v1alpha1/AWSDDBStreams.java
index 92c2768e149..6e7c49004c0 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/pkg/apis/common/integration/v1alpha1/AWSDDBStreams.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/pkg/apis/common/integration/v1alpha1/AWSDDBStreams.java
@@ -98,61 +98,97 @@ public AWSDDBStreams(Integer delay, Boolean overrideEndpoint, String region, Str
         this.uriEndpointOverride = uriEndpointOverride;
     }
 
+    /**
+     * Defines where in the DynamoDB stream to start getting records
+     */
     @JsonProperty("delay")
     public Integer getDelay() {
         return delay;
     }
 
+    /**
+     * Defines where in the DynamoDB stream to start getting records
+     */
     @JsonProperty("delay")
     public void setDelay(Integer delay) {
         this.delay = delay;
     }
 
+    /**
+     * Override endpoint URI
+     */
     @JsonProperty("overrideEndpoint")
     public Boolean getOverrideEndpoint() {
         return overrideEndpoint;
     }
 
+    /**
+     * Override endpoint URI
+     */
     @JsonProperty("overrideEndpoint")
     public void setOverrideEndpoint(Boolean overrideEndpoint) {
         this.overrideEndpoint = overrideEndpoint;
     }
 
+    /**
+     * Auth is the S3 authentication (accessKey/secretKey) configuration.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Auth is the S3 authentication (accessKey/secretKey) configuration.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * The name of the DynamoDB table
+     */
     @JsonProperty("streamIteratorType")
     public String getStreamIteratorType() {
         return streamIteratorType;
     }
 
+    /**
+     * The name of the DynamoDB table
+     */
     @JsonProperty("streamIteratorType")
     public void setStreamIteratorType(String streamIteratorType) {
         this.streamIteratorType = streamIteratorType;
     }
 
+    /**
+     * Embeds AWSCommon to inherit its fields in JSON
+     */
     @JsonProperty("table")
     public String getTable() {
         return table;
     }
 
+    /**
+     * Embeds AWSCommon to inherit its fields in JSON
+     */
     @JsonProperty("table")
     public void setTable(String table) {
         this.table = table;
     }
 
+    /**
+     * AWS region
+     */
     @JsonProperty("uriEndpointOverride")
     public String getUriEndpointOverride() {
         return uriEndpointOverride;
     }
 
+    /**
+     * AWS region
+     */
     @JsonProperty("uriEndpointOverride")
     public void setUriEndpointOverride(String uriEndpointOverride) {
         this.uriEndpointOverride = uriEndpointOverride;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/pkg/apis/common/integration/v1alpha1/AWSS3.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/pkg/apis/common/integration/v1alpha1/AWSS3.java
index 719664c2ae9..52c36c0976f 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/pkg/apis/common/integration/v1alpha1/AWSS3.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/pkg/apis/common/integration/v1alpha1/AWSS3.java
@@ -134,151 +134,241 @@ public AWSS3(String arn, Boolean autoCreateBucket, Integer delay, Boolean delete
         this.uriEndpointOverride = uriEndpointOverride;
     }
 
+    /**
+     * Embeds AWSCommon to inherit its fields in JSON
+     */
     @JsonProperty("arn")
     public String getArn() {
         return arn;
     }
 
+    /**
+     * Embeds AWSCommon to inherit its fields in JSON
+     */
     @JsonProperty("arn")
     public void setArn(String arn) {
         this.arn = arn;
     }
 
+    /**
+     * Suffix for moved objects
+     */
     @JsonProperty("autoCreateBucket")
     public Boolean getAutoCreateBucket() {
         return autoCreateBucket;
     }
 
+    /**
+     * Suffix for moved objects
+     */
     @JsonProperty("autoCreateBucket")
     public void setAutoCreateBucket(Boolean autoCreateBucket) {
         this.autoCreateBucket = autoCreateBucket;
     }
 
+    /**
+     * Force path style for bucket access
+     */
     @JsonProperty("delay")
     public Integer getDelay() {
         return delay;
     }
 
+    /**
+     * Force path style for bucket access
+     */
     @JsonProperty("delay")
     public void setDelay(Integer delay) {
         this.delay = delay;
     }
 
+    /**
+     * S3 ARN
+     */
     @JsonProperty("deleteAfterRead")
     public Boolean getDeleteAfterRead() {
         return deleteAfterRead;
     }
 
+    /**
+     * S3 ARN
+     */
     @JsonProperty("deleteAfterRead")
     public void setDeleteAfterRead(Boolean deleteAfterRead) {
         this.deleteAfterRead = deleteAfterRead;
     }
 
+    /**
+     * Move objects after reading
+     */
     @JsonProperty("destinationBucket")
     public String getDestinationBucket() {
         return destinationBucket;
     }
 
+    /**
+     * Move objects after reading
+     */
     @JsonProperty("destinationBucket")
     public void setDestinationBucket(String destinationBucket) {
         this.destinationBucket = destinationBucket;
     }
 
+    /**
+     * Destination bucket for moved objects
+     */
     @JsonProperty("destinationBucketPrefix")
     public String getDestinationBucketPrefix() {
         return destinationBucketPrefix;
     }
 
+    /**
+     * Destination bucket for moved objects
+     */
     @JsonProperty("destinationBucketPrefix")
     public void setDestinationBucketPrefix(String destinationBucketPrefix) {
         this.destinationBucketPrefix = destinationBucketPrefix;
     }
 
+    /**
+     * Prefix for moved objects
+     */
     @JsonProperty("destinationBucketSuffix")
     public String getDestinationBucketSuffix() {
         return destinationBucketSuffix;
     }
 
+    /**
+     * Prefix for moved objects
+     */
     @JsonProperty("destinationBucketSuffix")
     public void setDestinationBucketSuffix(String destinationBucketSuffix) {
         this.destinationBucketSuffix = destinationBucketSuffix;
     }
 
+    /**
+     * Ignore object body
+     */
     @JsonProperty("forcePathStyle")
     public Boolean getForcePathStyle() {
         return forcePathStyle;
     }
 
+    /**
+     * Ignore object body
+     */
     @JsonProperty("forcePathStyle")
     public void setForcePathStyle(Boolean forcePathStyle) {
         this.forcePathStyle = forcePathStyle;
     }
 
+    /**
+     * S3 bucket prefix for search
+     */
     @JsonProperty("ignoreBody")
     public Boolean getIgnoreBody() {
         return ignoreBody;
     }
 
+    /**
+     * S3 bucket prefix for search
+     */
     @JsonProperty("ignoreBody")
     public void setIgnoreBody(Boolean ignoreBody) {
         this.ignoreBody = ignoreBody;
     }
 
+    /**
+     * Delay between polls in milliseconds
+     */
     @JsonProperty("maxMessagesPerPoll")
     public Integer getMaxMessagesPerPoll() {
         return maxMessagesPerPoll;
     }
 
+    /**
+     * Delay between polls in milliseconds
+     */
     @JsonProperty("maxMessagesPerPoll")
     public void setMaxMessagesPerPoll(Integer maxMessagesPerPoll) {
         this.maxMessagesPerPoll = maxMessagesPerPoll;
     }
 
+    /**
+     * Auto-delete objects after reading
+     */
     @JsonProperty("moveAfterRead")
     public Boolean getMoveAfterRead() {
         return moveAfterRead;
     }
 
+    /**
+     * Auto-delete objects after reading
+     */
     @JsonProperty("moveAfterRead")
     public void setMoveAfterRead(Boolean moveAfterRead) {
         this.moveAfterRead = moveAfterRead;
     }
 
+    /**
+     * Override endpoint URI
+     */
     @JsonProperty("overrideEndpoint")
     public Boolean getOverrideEndpoint() {
         return overrideEndpoint;
     }
 
+    /**
+     * Override endpoint URI
+     */
     @JsonProperty("overrideEndpoint")
     public void setOverrideEndpoint(Boolean overrideEndpoint) {
         this.overrideEndpoint = overrideEndpoint;
     }
 
+    /**
+     * Auto-create S3 bucket
+     */
     @JsonProperty("prefix")
     public String getPrefix() {
         return prefix;
     }
 
+    /**
+     * Auto-create S3 bucket
+     */
     @JsonProperty("prefix")
     public void setPrefix(String prefix) {
         this.prefix = prefix;
     }
 
+    /**
+     * Auth is the S3 authentication (accessKey/secretKey) configuration.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Auth is the S3 authentication (accessKey/secretKey) configuration.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * AWS region
+     */
     @JsonProperty("uriEndpointOverride")
     public String getUriEndpointOverride() {
         return uriEndpointOverride;
     }
 
+    /**
+     * AWS region
+     */
     @JsonProperty("uriEndpointOverride")
     public void setUriEndpointOverride(String uriEndpointOverride) {
         this.uriEndpointOverride = uriEndpointOverride;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/pkg/apis/common/integration/v1alpha1/AWSSNS.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/pkg/apis/common/integration/v1alpha1/AWSSNS.java
index 7a2298de66a..62035939a0f 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/pkg/apis/common/integration/v1alpha1/AWSSNS.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/pkg/apis/common/integration/v1alpha1/AWSSNS.java
@@ -94,51 +94,81 @@ public AWSSNS(String arn, Boolean autoCreateTopic, Boolean overrideEndpoint, Str
         this.uriEndpointOverride = uriEndpointOverride;
     }
 
+    /**
+     * Embeds AWSCommon to inherit its fields in JSON
+     */
     @JsonProperty("arn")
     public String getArn() {
         return arn;
     }
 
+    /**
+     * Embeds AWSCommon to inherit its fields in JSON
+     */
     @JsonProperty("arn")
     public void setArn(String arn) {
         this.arn = arn;
     }
 
+    /**
+     * SNS ARN
+     */
     @JsonProperty("autoCreateTopic")
     public Boolean getAutoCreateTopic() {
         return autoCreateTopic;
     }
 
+    /**
+     * SNS ARN
+     */
     @JsonProperty("autoCreateTopic")
     public void setAutoCreateTopic(Boolean autoCreateTopic) {
         this.autoCreateTopic = autoCreateTopic;
     }
 
+    /**
+     * Override endpoint URI
+     */
     @JsonProperty("overrideEndpoint")
     public Boolean getOverrideEndpoint() {
         return overrideEndpoint;
     }
 
+    /**
+     * Override endpoint URI
+     */
     @JsonProperty("overrideEndpoint")
     public void setOverrideEndpoint(Boolean overrideEndpoint) {
         this.overrideEndpoint = overrideEndpoint;
     }
 
+    /**
+     * Auth is the S3 authentication (accessKey/secretKey) configuration.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Auth is the S3 authentication (accessKey/secretKey) configuration.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * AWS region
+     */
     @JsonProperty("uriEndpointOverride")
     public String getUriEndpointOverride() {
         return uriEndpointOverride;
     }
 
+    /**
+     * AWS region
+     */
     @JsonProperty("uriEndpointOverride")
     public void setUriEndpointOverride(String uriEndpointOverride) {
         this.uriEndpointOverride = uriEndpointOverride;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/pkg/apis/common/integration/v1alpha1/AWSSQS.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/pkg/apis/common/integration/v1alpha1/AWSSQS.java
index 17d26fd3368..fa80d2b126a 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/pkg/apis/common/integration/v1alpha1/AWSSQS.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/pkg/apis/common/integration/v1alpha1/AWSSQS.java
@@ -130,141 +130,225 @@ public AWSSQS(String arn, Boolean autoCreateQueue, Integer delay, Boolean delete
         this.waitTimeSeconds = waitTimeSeconds;
     }
 
+    /**
+     * Embeds AWSCommon to inherit its fields in JSON
+     */
     @JsonProperty("arn")
     public String getArn() {
         return arn;
     }
 
+    /**
+     * Embeds AWSCommon to inherit its fields in JSON
+     */
     @JsonProperty("arn")
     public void setArn(String arn) {
         this.arn = arn;
     }
 
+    /**
+     * Auto-delete messages after reading
+     */
     @JsonProperty("autoCreateQueue")
     public Boolean getAutoCreateQueue() {
         return autoCreateQueue;
     }
 
+    /**
+     * Auto-delete messages after reading
+     */
     @JsonProperty("autoCreateQueue")
     public void setAutoCreateQueue(Boolean autoCreateQueue) {
         this.autoCreateQueue = autoCreateQueue;
     }
 
+    /**
+     * Greedy scheduler
+     */
     @JsonProperty("delay")
     public Integer getDelay() {
         return delay;
     }
 
+    /**
+     * Greedy scheduler
+     */
     @JsonProperty("delay")
     public void setDelay(Integer delay) {
         this.delay = delay;
     }
 
+    /**
+     * SQS ARN
+     */
     @JsonProperty("deleteAfterRead")
     public Boolean getDeleteAfterRead() {
         return deleteAfterRead;
     }
 
+    /**
+     * SQS ARN
+     */
     @JsonProperty("deleteAfterRead")
     public void setDeleteAfterRead(Boolean deleteAfterRead) {
         this.deleteAfterRead = deleteAfterRead;
     }
 
+    /**
+     * Full SQS queue URL
+     */
     @JsonProperty("greedy")
     public Boolean getGreedy() {
         return greedy;
     }
 
+    /**
+     * Full SQS queue URL
+     */
     @JsonProperty("greedy")
     public void setGreedy(Boolean greedy) {
         this.greedy = greedy;
     }
 
+    /**
+     * Auto-create SQS queue
+     */
     @JsonProperty("host")
     public String getHost() {
         return host;
     }
 
+    /**
+     * Auto-create SQS queue
+     */
     @JsonProperty("host")
     public void setHost(String host) {
         this.host = host;
     }
 
+    /**
+     * Delay between polls in milliseconds
+     */
     @JsonProperty("maxMessagesPerPoll")
     public Integer getMaxMessagesPerPoll() {
         return maxMessagesPerPoll;
     }
 
+    /**
+     * Delay between polls in milliseconds
+     */
     @JsonProperty("maxMessagesPerPoll")
     public void setMaxMessagesPerPoll(Integer maxMessagesPerPoll) {
         this.maxMessagesPerPoll = maxMessagesPerPoll;
     }
 
+    /**
+     * Override endpoint URI
+     */
     @JsonProperty("overrideEndpoint")
     public Boolean getOverrideEndpoint() {
         return overrideEndpoint;
     }
 
+    /**
+     * Override endpoint URI
+     */
     @JsonProperty("overrideEndpoint")
     public void setOverrideEndpoint(Boolean overrideEndpoint) {
         this.overrideEndpoint = overrideEndpoint;
     }
 
+    /**
+     * AWS host
+     */
     @JsonProperty("protocol")
     public String getProtocol() {
         return protocol;
     }
 
+    /**
+     * AWS host
+     */
     @JsonProperty("protocol")
     public void setProtocol(String protocol) {
         this.protocol = protocol;
     }
 
+    /**
+     * Communication protocol (http/https)
+     */
     @JsonProperty("queueURL")
     public String getQueueURL() {
         return queueURL;
     }
 
+    /**
+     * Communication protocol (http/https)
+     */
     @JsonProperty("queueURL")
     public void setQueueURL(String queueURL) {
         this.queueURL = queueURL;
     }
 
+    /**
+     * Auth is the S3 authentication (accessKey/secretKey) configuration.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Auth is the S3 authentication (accessKey/secretKey) configuration.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * AWS region
+     */
     @JsonProperty("uriEndpointOverride")
     public String getUriEndpointOverride() {
         return uriEndpointOverride;
     }
 
+    /**
+     * AWS region
+     */
     @JsonProperty("uriEndpointOverride")
     public void setUriEndpointOverride(String uriEndpointOverride) {
         this.uriEndpointOverride = uriEndpointOverride;
     }
 
+    /**
+     * Wait time for messages
+     */
     @JsonProperty("visibilityTimeout")
     public Integer getVisibilityTimeout() {
         return visibilityTimeout;
     }
 
+    /**
+     * Wait time for messages
+     */
     @JsonProperty("visibilityTimeout")
     public void setVisibilityTimeout(Integer visibilityTimeout) {
         this.visibilityTimeout = visibilityTimeout;
     }
 
+    /**
+     * Max messages to return (1-10)
+     */
     @JsonProperty("waitTimeSeconds")
     public Integer getWaitTimeSeconds() {
         return waitTimeSeconds;
     }
 
+    /**
+     * Max messages to return (1-10)
+     */
     @JsonProperty("waitTimeSeconds")
     public void setWaitTimeSeconds(Integer waitTimeSeconds) {
         this.waitTimeSeconds = waitTimeSeconds;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/pkg/apis/common/integration/v1alpha1/Auth.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/pkg/apis/common/integration/v1alpha1/Auth.java
index 81145387f3a..e068db466d3 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/pkg/apis/common/integration/v1alpha1/Auth.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/pkg/apis/common/integration/v1alpha1/Auth.java
@@ -86,11 +86,17 @@ public Auth(String accessKey, Secret secret, String secretKey) {
         this.secretKey = secretKey;
     }
 
+    /**
+     * AccessKey is the AWS access key ID.
+     */
     @JsonProperty("accessKey")
     public String getAccessKey() {
         return accessKey;
     }
 
+    /**
+     * AccessKey is the AWS access key ID.
+     */
     @JsonProperty("accessKey")
     public void setAccessKey(String accessKey) {
         this.accessKey = accessKey;
@@ -106,11 +112,17 @@ public void setSecret(Secret secret) {
         this.secret = secret;
     }
 
+    /**
+     * SecretKey is the AWS secret access key.
+     */
     @JsonProperty("secretKey")
     public String getSecretKey() {
         return secretKey;
     }
 
+    /**
+     * SecretKey is the AWS secret access key.
+     */
     @JsonProperty("secretKey")
     public void setSecretKey(String secretKey) {
         this.secretKey = secretKey;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/pkg/apis/common/integration/v1alpha1/SecretReference.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/pkg/apis/common/integration/v1alpha1/SecretReference.java
index 4fb8872ec78..9e69a7f3dfd 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/pkg/apis/common/integration/v1alpha1/SecretReference.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/pkg/apis/common/integration/v1alpha1/SecretReference.java
@@ -78,11 +78,17 @@ public SecretReference(String name) {
         this.name = name;
     }
 
+    /**
+     * Secret name.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Secret name.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/Broker.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/Broker.java
index b9e582dba75..64c3ebc6497 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/Broker.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/Broker.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Broker collects a pool of events that are consumable using Triggers. Brokers provide a well-known endpoint for event delivery that senders can use with minimal knowledge of the event routing strategy. Subscribers use Triggers to request delivery of events from a Broker's pool to a specific URL or Addressable endpoint.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Broker implements Editable<BrokerBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "eventing.knative.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Broker";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Broker(String apiVersion, String kind, ObjectMeta metadata, BrokerSpec sp
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Broker collects a pool of events that are consumable using Triggers. Brokers provide a well-known endpoint for event delivery that senders can use with minimal knowledge of the event routing strategy. Subscribers use Triggers to request delivery of events from a Broker's pool to a specific URL or Addressable endpoint.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Broker collects a pool of events that are consumable using Triggers. Brokers provide a well-known endpoint for event delivery that senders can use with minimal knowledge of the event routing strategy. Subscribers use Triggers to request delivery of events from a Broker's pool to a specific URL or Addressable endpoint.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Broker collects a pool of events that are consumable using Triggers. Brokers provide a well-known endpoint for event delivery that senders can use with minimal knowledge of the event routing strategy. Subscribers use Triggers to request delivery of events from a Broker's pool to a specific URL or Addressable endpoint.
+     */
     @JsonProperty("spec")
     public BrokerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Broker collects a pool of events that are consumable using Triggers. Brokers provide a well-known endpoint for event delivery that senders can use with minimal knowledge of the event routing strategy. Subscribers use Triggers to request delivery of events from a Broker's pool to a specific URL or Addressable endpoint.
+     */
     @JsonProperty("spec")
     public void setSpec(BrokerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Broker collects a pool of events that are consumable using Triggers. Brokers provide a well-known endpoint for event delivery that senders can use with minimal knowledge of the event routing strategy. Subscribers use Triggers to request delivery of events from a Broker's pool to a specific URL or Addressable endpoint.
+     */
     @JsonProperty("status")
     public BrokerStatus getStatus() {
         return status;
     }
 
+    /**
+     * Broker collects a pool of events that are consumable using Triggers. Brokers provide a well-known endpoint for event delivery that senders can use with minimal knowledge of the event routing strategy. Subscribers use Triggers to request delivery of events from a Broker's pool to a specific URL or Addressable endpoint.
+     */
     @JsonProperty("status")
     public void setStatus(BrokerStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/BrokerList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/BrokerList.java
index c52e28be582..743e8530987 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/BrokerList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/BrokerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BrokerList is a collection of Brokers.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class BrokerList implements Editable<BrokerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.eventing.v1.Broker>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "eventing.knative.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.eventing.v1.Broker> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "BrokerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public BrokerList(String apiVersion, List<io.fabric8.knative.eventing.v1.Broker>
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * BrokerList is a collection of Brokers.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.eventing.v1.Broker> getItems() {
         return items;
     }
 
+    /**
+     * BrokerList is a collection of Brokers.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.eventing.v1.Broker> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * BrokerList is a collection of Brokers.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * BrokerList is a collection of Brokers.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/BrokerStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/BrokerStatus.java
index b3201a519fd..ed2dc46dece 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/BrokerStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/BrokerStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BrokerStatus represents the current state of a Broker.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -119,95 +122,149 @@ public BrokerStatus(Addressable address, List<Addressable> addresses, Map<String
         this.policies = policies;
     }
 
+    /**
+     * BrokerStatus represents the current state of a Broker.
+     */
     @JsonProperty("address")
     public Addressable getAddress() {
         return address;
     }
 
+    /**
+     * BrokerStatus represents the current state of a Broker.
+     */
     @JsonProperty("address")
     public void setAddress(Addressable address) {
         this.address = address;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Addressable> getAddresses() {
         return addresses;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<Addressable> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * DeadLetterSinkAudience is the OIDC audience of the DeadLetterSink
+     */
     @JsonProperty("deadLetterSinkAudience")
     public String getDeadLetterSinkAudience() {
         return deadLetterSinkAudience;
     }
 
+    /**
+     * DeadLetterSinkAudience is the OIDC audience of the DeadLetterSink
+     */
     @JsonProperty("deadLetterSinkAudience")
     public void setDeadLetterSinkAudience(String deadLetterSinkAudience) {
         this.deadLetterSinkAudience = deadLetterSinkAudience;
     }
 
+    /**
+     * DeadLetterSinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("deadLetterSinkCACerts")
     public String getDeadLetterSinkCACerts() {
         return deadLetterSinkCACerts;
     }
 
+    /**
+     * DeadLetterSinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("deadLetterSinkCACerts")
     public void setDeadLetterSinkCACerts(String deadLetterSinkCACerts) {
         this.deadLetterSinkCACerts = deadLetterSinkCACerts;
     }
 
+    /**
+     * BrokerStatus represents the current state of a Broker.
+     */
     @JsonProperty("deadLetterSinkUri")
     public String getDeadLetterSinkUri() {
         return deadLetterSinkUri;
     }
 
+    /**
+     * BrokerStatus represents the current state of a Broker.
+     */
     @JsonProperty("deadLetterSinkUri")
     public void setDeadLetterSinkUri(String deadLetterSinkUri) {
         this.deadLetterSinkUri = deadLetterSinkUri;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Policies holds the list of applied EventPolicies
+     */
     @JsonProperty("policies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AppliedEventPolicyRef> getPolicies() {
         return policies;
     }
 
+    /**
+     * Policies holds the list of applied EventPolicies
+     */
     @JsonProperty("policies")
     public void setPolicies(List<AppliedEventPolicyRef> policies) {
         this.policies = policies;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/SubscriptionsAPIFilter.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/SubscriptionsAPIFilter.java
index a0582bf4d2b..d4d13146c4a 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/SubscriptionsAPIFilter.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/SubscriptionsAPIFilter.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubscriptionsAPIFilter allows defining a filter expression using CloudEvents Subscriptions API. If multiple filters are specified, then the same semantics of SubscriptionsAPIFilter.All is applied. If no filter dialect or empty object is specified, then the filter always accept the events.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -109,76 +112,118 @@ public SubscriptionsAPIFilter(List<io.fabric8.knative.eventing.v1.SubscriptionsA
         this.suffix = suffix;
     }
 
+    /**
+     * All evaluates to true if all the nested expressions evaluate to true. It must contain at least one filter expression.
+     */
     @JsonProperty("all")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.eventing.v1.SubscriptionsAPIFilter> getAll() {
         return all;
     }
 
+    /**
+     * All evaluates to true if all the nested expressions evaluate to true. It must contain at least one filter expression.
+     */
     @JsonProperty("all")
     public void setAll(List<io.fabric8.knative.eventing.v1.SubscriptionsAPIFilter> all) {
         this.all = all;
     }
 
+    /**
+     * Any evaluates to true if at least one of the nested expressions evaluates to true. It must contain at least one filter expression.
+     */
     @JsonProperty("any")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.eventing.v1.SubscriptionsAPIFilter> getAny() {
         return any;
     }
 
+    /**
+     * Any evaluates to true if at least one of the nested expressions evaluates to true. It must contain at least one filter expression.
+     */
     @JsonProperty("any")
     public void setAny(List<io.fabric8.knative.eventing.v1.SubscriptionsAPIFilter> any) {
         this.any = any;
     }
 
+    /**
+     * CESQL is a CloudEvents SQL expression that will be evaluated to true or false against each CloudEvent.
+     */
     @JsonProperty("cesql")
     public String getCesql() {
         return cesql;
     }
 
+    /**
+     * CESQL is a CloudEvents SQL expression that will be evaluated to true or false against each CloudEvent.
+     */
     @JsonProperty("cesql")
     public void setCesql(String cesql) {
         this.cesql = cesql;
     }
 
+    /**
+     * Exact evaluates to true if the values of the matching CloudEvents attributes MUST all exactly match with the associated value String specified (case-sensitive). The keys are the names of the CloudEvents attributes to be matched, and their values are the String values to use in the comparison. The attribute name and value specified in the filter express MUST NOT be empty strings.
+     */
     @JsonProperty("exact")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getExact() {
         return exact;
     }
 
+    /**
+     * Exact evaluates to true if the values of the matching CloudEvents attributes MUST all exactly match with the associated value String specified (case-sensitive). The keys are the names of the CloudEvents attributes to be matched, and their values are the String values to use in the comparison. The attribute name and value specified in the filter express MUST NOT be empty strings.
+     */
     @JsonProperty("exact")
     public void setExact(Map<String, String> exact) {
         this.exact = exact;
     }
 
+    /**
+     * SubscriptionsAPIFilter allows defining a filter expression using CloudEvents Subscriptions API. If multiple filters are specified, then the same semantics of SubscriptionsAPIFilter.All is applied. If no filter dialect or empty object is specified, then the filter always accept the events.
+     */
     @JsonProperty("not")
     public io.fabric8.knative.eventing.v1.SubscriptionsAPIFilter getNot() {
         return not;
     }
 
+    /**
+     * SubscriptionsAPIFilter allows defining a filter expression using CloudEvents Subscriptions API. If multiple filters are specified, then the same semantics of SubscriptionsAPIFilter.All is applied. If no filter dialect or empty object is specified, then the filter always accept the events.
+     */
     @JsonProperty("not")
     public void setNot(io.fabric8.knative.eventing.v1.SubscriptionsAPIFilter not) {
         this.not = not;
     }
 
+    /**
+     * Prefix evaluates to true if the values of the matching CloudEvents attributes MUST all start with the associated value String specified (case sensitive). The keys are the names of the CloudEvents attributes to be matched, and their values are the String values to use in the comparison. The attribute name and value specified in the filter express MUST NOT be empty strings.
+     */
     @JsonProperty("prefix")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getPrefix() {
         return prefix;
     }
 
+    /**
+     * Prefix evaluates to true if the values of the matching CloudEvents attributes MUST all start with the associated value String specified (case sensitive). The keys are the names of the CloudEvents attributes to be matched, and their values are the String values to use in the comparison. The attribute name and value specified in the filter express MUST NOT be empty strings.
+     */
     @JsonProperty("prefix")
     public void setPrefix(Map<String, String> prefix) {
         this.prefix = prefix;
     }
 
+    /**
+     * Suffix evaluates to true if the values of the matching CloudEvents attributes MUST all end with the associated value String specified (case sensitive). The keys are the names of the CloudEvents attributes to be matched, and their values are the String values to use in the comparison. The attribute name and value specified in the filter express MUST NOT be empty strings.
+     */
     @JsonProperty("suffix")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getSuffix() {
         return suffix;
     }
 
+    /**
+     * Suffix evaluates to true if the values of the matching CloudEvents attributes MUST all end with the associated value String specified (case sensitive). The keys are the names of the CloudEvents attributes to be matched, and their values are the String values to use in the comparison. The attribute name and value specified in the filter express MUST NOT be empty strings.
+     */
     @JsonProperty("suffix")
     public void setSuffix(Map<String, String> suffix) {
         this.suffix = suffix;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/Trigger.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/Trigger.java
index e5f17ddca0b..ecdf4dbbba4 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/Trigger.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/Trigger.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Trigger represents a request to have events delivered to a subscriber from a Broker's event pool.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Trigger implements Editable<TriggerBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "eventing.knative.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Trigger";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Trigger(String apiVersion, String kind, ObjectMeta metadata, TriggerSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Trigger represents a request to have events delivered to a subscriber from a Broker's event pool.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Trigger represents a request to have events delivered to a subscriber from a Broker's event pool.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Trigger represents a request to have events delivered to a subscriber from a Broker's event pool.
+     */
     @JsonProperty("spec")
     public TriggerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Trigger represents a request to have events delivered to a subscriber from a Broker's event pool.
+     */
     @JsonProperty("spec")
     public void setSpec(TriggerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Trigger represents a request to have events delivered to a subscriber from a Broker's event pool.
+     */
     @JsonProperty("status")
     public TriggerStatus getStatus() {
         return status;
     }
 
+    /**
+     * Trigger represents a request to have events delivered to a subscriber from a Broker's event pool.
+     */
     @JsonProperty("status")
     public void setStatus(TriggerStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/TriggerFilter.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/TriggerFilter.java
index fc8bfa34239..d1f9f332414 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/TriggerFilter.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/TriggerFilter.java
@@ -79,12 +79,18 @@ public TriggerFilter(Map<String, String> attributes) {
         this.attributes = attributes;
     }
 
+    /**
+     * Attributes filters events by exact match on event context attributes. Each key in the map is compared with the equivalent key in the event context. An event passes the filter if all values are equal to the specified values. Nested context attributes are not supported as keys. Only string values are supported.
+     */
     @JsonProperty("attributes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAttributes() {
         return attributes;
     }
 
+    /**
+     * Attributes filters events by exact match on event context attributes. Each key in the map is compared with the equivalent key in the event context. An event passes the filter if all values are equal to the specified values. Nested context attributes are not supported as keys. Only string values are supported.
+     */
     @JsonProperty("attributes")
     public void setAttributes(Map<String, String> attributes) {
         this.attributes = attributes;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/TriggerList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/TriggerList.java
index 1144f1d9925..6993502d9f4 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/TriggerList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/TriggerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TriggerList is a collection of Triggers.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class TriggerList implements Editable<TriggerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.eventing.v1.Trigger>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "eventing.knative.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.eventing.v1.Trigger> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TriggerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TriggerList(String apiVersion, List<io.fabric8.knative.eventing.v1.Trigge
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * TriggerList is a collection of Triggers.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.eventing.v1.Trigger> getItems() {
         return items;
     }
 
+    /**
+     * TriggerList is a collection of Triggers.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.eventing.v1.Trigger> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TriggerList is a collection of Triggers.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TriggerList is a collection of Triggers.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/TriggerSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/TriggerSpec.java
index 6c6529a8785..a6c9de00479 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/TriggerSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/TriggerSpec.java
@@ -104,11 +104,17 @@ public TriggerSpec(String broker, KReference brokerRef, DeliverySpec delivery, T
         this.subscriber = subscriber;
     }
 
+    /**
+     * Broker is the broker that this trigger receives events from.
+     */
     @JsonProperty("broker")
     public String getBroker() {
         return broker;
     }
 
+    /**
+     * Broker is the broker that this trigger receives events from.
+     */
     @JsonProperty("broker")
     public void setBroker(String broker) {
         this.broker = broker;
@@ -144,12 +150,18 @@ public void setFilter(TriggerFilter filter) {
         this.filter = filter;
     }
 
+    /**
+     * Filters is an experimental field that conforms to the CNCF CloudEvents Subscriptions API. It's an array of filter expressions that evaluate to true or false. If any filter expression in the array evaluates to false, the event MUST NOT be sent to the Subscriber. If all the filter expressions in the array evaluate to true, the event MUST be attempted to be delivered. Absence of a filter or empty array implies a value of true. In the event of users specifying both Filter and Filters, then the latter will override the former. This will allow users to try out the effect of the new Filters field without compromising the existing attribute-based Filter and try it out on existing Trigger objects.
+     */
     @JsonProperty("filters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SubscriptionsAPIFilter> getFilters() {
         return filters;
     }
 
+    /**
+     * Filters is an experimental field that conforms to the CNCF CloudEvents Subscriptions API. It's an array of filter expressions that evaluate to true or false. If any filter expression in the array evaluates to false, the event MUST NOT be sent to the Subscriber. If all the filter expressions in the array evaluate to true, the event MUST be attempted to be delivered. Absence of a filter or empty array implies a value of true. In the event of users specifying both Filter and Filters, then the latter will override the former. This will allow users to try out the effect of the new Filters field without compromising the existing attribute-based Filter and try it out on existing Trigger objects.
+     */
     @JsonProperty("filters")
     public void setFilters(List<SubscriptionsAPIFilter> filters) {
         this.filters = filters;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/TriggerStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/TriggerStatus.java
index b180c742a96..0e83bdb4da1 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/TriggerStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1/TriggerStatus.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TriggerStatus represents the current state of a Trigger.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -120,103 +123,163 @@ public TriggerStatus(Map<String, String> annotations, AuthStatus auth, List<Cond
         this.subscriberUri = subscriberUri;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * TriggerStatus represents the current state of a Trigger.
+     */
     @JsonProperty("auth")
     public AuthStatus getAuth() {
         return auth;
     }
 
+    /**
+     * TriggerStatus represents the current state of a Trigger.
+     */
     @JsonProperty("auth")
     public void setAuth(AuthStatus auth) {
         this.auth = auth;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * DeadLetterSinkAudience is the OIDC audience of the DeadLetterSink
+     */
     @JsonProperty("deadLetterSinkAudience")
     public String getDeadLetterSinkAudience() {
         return deadLetterSinkAudience;
     }
 
+    /**
+     * DeadLetterSinkAudience is the OIDC audience of the DeadLetterSink
+     */
     @JsonProperty("deadLetterSinkAudience")
     public void setDeadLetterSinkAudience(String deadLetterSinkAudience) {
         this.deadLetterSinkAudience = deadLetterSinkAudience;
     }
 
+    /**
+     * DeadLetterSinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("deadLetterSinkCACerts")
     public String getDeadLetterSinkCACerts() {
         return deadLetterSinkCACerts;
     }
 
+    /**
+     * DeadLetterSinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("deadLetterSinkCACerts")
     public void setDeadLetterSinkCACerts(String deadLetterSinkCACerts) {
         this.deadLetterSinkCACerts = deadLetterSinkCACerts;
     }
 
+    /**
+     * TriggerStatus represents the current state of a Trigger.
+     */
     @JsonProperty("deadLetterSinkUri")
     public String getDeadLetterSinkUri() {
         return deadLetterSinkUri;
     }
 
+    /**
+     * TriggerStatus represents the current state of a Trigger.
+     */
     @JsonProperty("deadLetterSinkUri")
     public void setDeadLetterSinkUri(String deadLetterSinkUri) {
         this.deadLetterSinkUri = deadLetterSinkUri;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * SubscriberAudience is the OIDC audience of the subscriber.
+     */
     @JsonProperty("subscriberAudience")
     public String getSubscriberAudience() {
         return subscriberAudience;
     }
 
+    /**
+     * SubscriberAudience is the OIDC audience of the subscriber.
+     */
     @JsonProperty("subscriberAudience")
     public void setSubscriberAudience(String subscriberAudience) {
         this.subscriberAudience = subscriberAudience;
     }
 
+    /**
+     * SubscriberCACerts is the Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468 of the receiver for this Trigger.
+     */
     @JsonProperty("subscriberCACerts")
     public String getSubscriberCACerts() {
         return subscriberCACerts;
     }
 
+    /**
+     * SubscriberCACerts is the Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468 of the receiver for this Trigger.
+     */
     @JsonProperty("subscriberCACerts")
     public void setSubscriberCACerts(String subscriberCACerts) {
         this.subscriberCACerts = subscriberCACerts;
     }
 
+    /**
+     * TriggerStatus represents the current state of a Trigger.
+     */
     @JsonProperty("subscriberUri")
     public String getSubscriberUri() {
         return subscriberUri;
     }
 
+    /**
+     * TriggerStatus represents the current state of a Trigger.
+     */
     @JsonProperty("subscriberUri")
     public void setSubscriberUri(String subscriberUri) {
         this.subscriberUri = subscriberUri;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicy.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicy.java
index e9a46a2b9b6..c14eb4cd8c0 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicy.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicy.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventPolicy represents a policy for addressable resources (Broker, Channel, sinks).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class EventPolicy implements Editable<EventPolicyBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "eventing.knative.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EventPolicy";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EventPolicy(String apiVersion, String kind, ObjectMeta metadata, EventPol
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EventPolicy represents a policy for addressable resources (Broker, Channel, sinks).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EventPolicy represents a policy for addressable resources (Broker, Channel, sinks).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * EventPolicy represents a policy for addressable resources (Broker, Channel, sinks).
+     */
     @JsonProperty("spec")
     public EventPolicySpec getSpec() {
         return spec;
     }
 
+    /**
+     * EventPolicy represents a policy for addressable resources (Broker, Channel, sinks).
+     */
     @JsonProperty("spec")
     public void setSpec(EventPolicySpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * EventPolicy represents a policy for addressable resources (Broker, Channel, sinks).
+     */
     @JsonProperty("status")
     public EventPolicyStatus getStatus() {
         return status;
     }
 
+    /**
+     * EventPolicy represents a policy for addressable resources (Broker, Channel, sinks).
+     */
     @JsonProperty("status")
     public void setStatus(EventPolicyStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicyFromReference.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicyFromReference.java
index 0d1d00d3b76..41cceca14d8 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicyFromReference.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicyFromReference.java
@@ -90,41 +90,65 @@ public EventPolicyFromReference(String apiVersion, String kind, String name, Str
         this.namespace = namespace;
     }
 
+    /**
+     * API version of the referent.
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * API version of the referent.
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ This is optional field, it gets defaulted to the object holding it if left out.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ This is optional field, it gets defaulted to the object holding it if left out.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicyList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicyList.java
index 231ad7c78f6..0f113c9fef0 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicyList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicyList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventPolicyList is a collection of EventPolicy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class EventPolicyList implements Editable<EventPolicyListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.eventing.v1alpha1.EventPolicy>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "eventing.knative.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.eventing.v1alpha1.EventPolicy> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EventPolicyList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EventPolicyList(String apiVersion, List<io.fabric8.knative.eventing.v1alp
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * EventPolicyList is a collection of EventPolicy.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.eventing.v1alpha1.EventPolicy> getItems() {
         return items;
     }
 
+    /**
+     * EventPolicyList is a collection of EventPolicy.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.eventing.v1alpha1.EventPolicy> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EventPolicyList is a collection of EventPolicy.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EventPolicyList is a collection of EventPolicy.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicySelector.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicySelector.java
index 20cdfe88bab..9dccdff0108 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicySelector.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicySelector.java
@@ -95,43 +95,67 @@ public EventPolicySelector(String apiVersion, String kind, List<LabelSelectorReq
         this.matchLabels = matchLabels;
     }
 
+    /**
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * matchExpressions is a list of label selector requirements. The requirements are ANDed.
+     */
     @JsonProperty("matchExpressions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LabelSelectorRequirement> getMatchExpressions() {
         return matchExpressions;
     }
 
+    /**
+     * matchExpressions is a list of label selector requirements. The requirements are ANDed.
+     */
     @JsonProperty("matchExpressions")
     public void setMatchExpressions(List<LabelSelectorRequirement> matchExpressions) {
         this.matchExpressions = matchExpressions;
     }
 
+    /**
+     * matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels map is equivalent to an element of matchExpressions, whose key field is "key", the operator is "In", and the values array contains only "value". The requirements are ANDed.
+     */
     @JsonProperty("matchLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getMatchLabels() {
         return matchLabels;
     }
 
+    /**
+     * matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels map is equivalent to an element of matchExpressions, whose key field is "key", the operator is "In", and the values array contains only "value". The requirements are ANDed.
+     */
     @JsonProperty("matchLabels")
     public void setMatchLabels(Map<String, String> matchLabels) {
         this.matchLabels = matchLabels;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicySpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicySpec.java
index f2527815a8e..c816caea945 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicySpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicySpec.java
@@ -92,34 +92,52 @@ public EventPolicySpec(List<SubscriptionsAPIFilter> filters, List<EventPolicySpe
         this.to = to;
     }
 
+    /**
+     * Filters is the list of SubscriptoinsApi filters which determine whether or not the event is accepted. It is an array of filter expressions that evaluate to true or false. If any filter expression in the array evaluates to false, the event will not pass the target resource's ingress. Absence of any filters implies that the filters always evaluate to true.
+     */
     @JsonProperty("filters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SubscriptionsAPIFilter> getFilters() {
         return filters;
     }
 
+    /**
+     * Filters is the list of SubscriptoinsApi filters which determine whether or not the event is accepted. It is an array of filter expressions that evaluate to true or false. If any filter expression in the array evaluates to false, the event will not pass the target resource's ingress. Absence of any filters implies that the filters always evaluate to true.
+     */
     @JsonProperty("filters")
     public void setFilters(List<SubscriptionsAPIFilter> filters) {
         this.filters = filters;
     }
 
+    /**
+     * From is the list of sources or oidc identities, which are allowed to send events to the targets (.spec.to).
+     */
     @JsonProperty("from")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EventPolicySpecFrom> getFrom() {
         return from;
     }
 
+    /**
+     * From is the list of sources or oidc identities, which are allowed to send events to the targets (.spec.to).
+     */
     @JsonProperty("from")
     public void setFrom(List<EventPolicySpecFrom> from) {
         this.from = from;
     }
 
+    /**
+     * To lists all resources for which this policy applies. Resources in this list must act like an ingress and have an audience. The resources are part of the same namespace as the EventPolicy. An empty list means it applies to all resources in the EventPolicies namespace
+     */
     @JsonProperty("to")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EventPolicySpecTo> getTo() {
         return to;
     }
 
+    /**
+     * To lists all resources for which this policy applies. Resources in this list must act like an ingress and have an audience. The resources are part of the same namespace as the EventPolicy. An empty list means it applies to all resources in the EventPolicies namespace
+     */
     @JsonProperty("to")
     public void setTo(List<EventPolicySpecTo> to) {
         this.to = to;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicySpecFrom.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicySpecFrom.java
index 90239d8431e..b8d2c617b7a 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicySpecFrom.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicySpecFrom.java
@@ -92,11 +92,17 @@ public void setRef(EventPolicyFromReference ref) {
         this.ref = ref;
     }
 
+    /**
+     * Sub sets the OIDC identity name to be allowed to send events to the target. It is also possible to set a glob-like pattern to match any suffix.
+     */
     @JsonProperty("sub")
     public String getSub() {
         return sub;
     }
 
+    /**
+     * Sub sets the OIDC identity name to be allowed to send events to the target. It is also possible to set a glob-like pattern to match any suffix.
+     */
     @JsonProperty("sub")
     public void setSub(String sub) {
         this.sub = sub;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicyStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicyStatus.java
index 6bb1093083d..09c279b40ee 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicyStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicyStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventPolicyStatus represents the current state of a EventPolicy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -96,44 +99,68 @@ public EventPolicyStatus(Map<String, String> annotations, List<Condition> condit
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * From is the list of resolved oidc identities from .spec.from
+     */
     @JsonProperty("from")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getFrom() {
         return from;
     }
 
+    /**
+     * From is the list of resolved oidc identities from .spec.from
+     */
     @JsonProperty("from")
     public void setFrom(List<String> from) {
         this.from = from;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicyToReference.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicyToReference.java
index 7b05430a0f5..ebbe18812c2 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicyToReference.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/EventPolicyToReference.java
@@ -86,31 +86,49 @@ public EventPolicyToReference(String apiVersion, String kind, String name) {
         this.name = name;
     }
 
+    /**
+     * API version of the referent.
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * API version of the referent.
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/KafkaSink.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/KafkaSink.java
index 77a29eec6da..c7fa2d6f6db 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/KafkaSink.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/KafkaSink.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KafkaSink is an addressable resource that represent a Kafka topic.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class KafkaSink implements Editable<KafkaSinkBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "eventing.knative.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KafkaSink";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public KafkaSink(String apiVersion, String kind, ObjectMeta metadata, KafkaSinkS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KafkaSink is an addressable resource that represent a Kafka topic.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KafkaSink is an addressable resource that represent a Kafka topic.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * KafkaSink is an addressable resource that represent a Kafka topic.
+     */
     @JsonProperty("spec")
     public KafkaSinkSpec getSpec() {
         return spec;
     }
 
+    /**
+     * KafkaSink is an addressable resource that represent a Kafka topic.
+     */
     @JsonProperty("spec")
     public void setSpec(KafkaSinkSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * KafkaSink is an addressable resource that represent a Kafka topic.
+     */
     @JsonProperty("status")
     public KafkaSinkStatus getStatus() {
         return status;
     }
 
+    /**
+     * KafkaSink is an addressable resource that represent a Kafka topic.
+     */
     @JsonProperty("status")
     public void setStatus(KafkaSinkStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/KafkaSinkList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/KafkaSinkList.java
index bdb07de1430..3bdd80a1066 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/KafkaSinkList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/KafkaSinkList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KafkaSinkList defines a list of Kafka Sink.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class KafkaSinkList implements Editable<KafkaSinkListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.eventing.v1alpha1.KafkaSink>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "eventing.knative.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.eventing.v1alpha1.KafkaSink> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KafkaSinkList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public KafkaSinkList(String apiVersion, List<io.fabric8.knative.eventing.v1alpha
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * KafkaSinkList defines a list of Kafka Sink.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.eventing.v1alpha1.KafkaSink> getItems() {
         return items;
     }
 
+    /**
+     * KafkaSinkList defines a list of Kafka Sink.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.eventing.v1alpha1.KafkaSink> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KafkaSinkList defines a list of Kafka Sink.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KafkaSinkList defines a list of Kafka Sink.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/KafkaSinkSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/KafkaSinkSpec.java
index b785e8a8d10..d056bb74c2c 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/KafkaSinkSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/KafkaSinkSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KafkaSinkSpec defines the desired state of the Kafka Sink.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,62 +104,98 @@ public KafkaSinkSpec(Auth auth, List<String> bootstrapServers, String contentMod
         this.topic = topic;
     }
 
+    /**
+     * KafkaSinkSpec defines the desired state of the Kafka Sink.
+     */
     @JsonProperty("auth")
     public Auth getAuth() {
         return auth;
     }
 
+    /**
+     * KafkaSinkSpec defines the desired state of the Kafka Sink.
+     */
     @JsonProperty("auth")
     public void setAuth(Auth auth) {
         this.auth = auth;
     }
 
+    /**
+     * Kafka Broker bootstrap servers.
+     */
     @JsonProperty("bootstrapServers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getBootstrapServers() {
         return bootstrapServers;
     }
 
+    /**
+     * Kafka Broker bootstrap servers.
+     */
     @JsonProperty("bootstrapServers")
     public void setBootstrapServers(List<String> bootstrapServers) {
         this.bootstrapServers = bootstrapServers;
     }
 
+    /**
+     * CloudEvent content mode of Kafka messages sent to the topic. Possible values: - structured - binary<br><p> <br><p> - default: binary.<br><p> <br><p> - https://github.com/cloudevents/spec/blob/v1.0/spec.md#message<br><p> 	 - https://github.com/cloudevents/spec/blob/v1.0/kafka-protocol-binding.md#32-binary-content-mode'<br><p> 	 - https://github.com/cloudevents/spec/blob/v1.0/kafka-protocol-binding.md#33-structured-content-mode
+     */
     @JsonProperty("contentMode")
     public String getContentMode() {
         return contentMode;
     }
 
+    /**
+     * CloudEvent content mode of Kafka messages sent to the topic. Possible values: - structured - binary<br><p> <br><p> - default: binary.<br><p> <br><p> - https://github.com/cloudevents/spec/blob/v1.0/spec.md#message<br><p> 	 - https://github.com/cloudevents/spec/blob/v1.0/kafka-protocol-binding.md#32-binary-content-mode'<br><p> 	 - https://github.com/cloudevents/spec/blob/v1.0/kafka-protocol-binding.md#33-structured-content-mode
+     */
     @JsonProperty("contentMode")
     public void setContentMode(String contentMode) {
         this.contentMode = contentMode;
     }
 
+    /**
+     * Number of topic partitions.
+     */
     @JsonProperty("numPartitions")
     public Integer getNumPartitions() {
         return numPartitions;
     }
 
+    /**
+     * Number of topic partitions.
+     */
     @JsonProperty("numPartitions")
     public void setNumPartitions(Integer numPartitions) {
         this.numPartitions = numPartitions;
     }
 
+    /**
+     * Topic replication factor
+     */
     @JsonProperty("replicationFactor")
     public Integer getReplicationFactor() {
         return replicationFactor;
     }
 
+    /**
+     * Topic replication factor
+     */
     @JsonProperty("replicationFactor")
     public void setReplicationFactor(Integer replicationFactor) {
         this.replicationFactor = replicationFactor;
     }
 
+    /**
+     * Topic name to send events.
+     */
     @JsonProperty("topic")
     public String getTopic() {
         return topic;
     }
 
+    /**
+     * Topic name to send events.
+     */
     @JsonProperty("topic")
     public void setTopic(String topic) {
         this.topic = topic;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/KafkaSinkStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/KafkaSinkStatus.java
index 2fe609432b9..f97453faa79 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/KafkaSinkStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/KafkaSinkStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KafkaSinkStatus represents the current state of the KafkaSink.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,54 +105,84 @@ public KafkaSinkStatus(AddressStatus addressStatus, Map<String, String> annotati
         this.policies = policies;
     }
 
+    /**
+     * KafkaSinkStatus represents the current state of the KafkaSink.
+     */
     @JsonProperty("AddressStatus")
     public AddressStatus getAddressStatus() {
         return addressStatus;
     }
 
+    /**
+     * KafkaSinkStatus represents the current state of the KafkaSink.
+     */
     @JsonProperty("AddressStatus")
     public void setAddressStatus(AddressStatus addressStatus) {
         this.addressStatus = addressStatus;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Policies holds the list of applied EventPolicies
+     */
     @JsonProperty("policies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AppliedEventPolicyRef> getPolicies() {
         return policies;
     }
 
+    /**
+     * Policies holds the list of applied EventPolicies
+     */
     @JsonProperty("policies")
     public void setPolicies(List<AppliedEventPolicyRef> policies) {
         this.policies = policies;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/RequestReply.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/RequestReply.java
index c26f752c509..3a3107de977 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/RequestReply.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/RequestReply.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RequestRepluy represents synchronous interface to sending and receiving events from a Broker.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class RequestReply implements Editable<RequestReplyBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "eventing.knative.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "RequestReply";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public RequestReply(String apiVersion, String kind, ObjectMeta metadata, Request
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RequestRepluy represents synchronous interface to sending and receiving events from a Broker.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RequestRepluy represents synchronous interface to sending and receiving events from a Broker.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * RequestRepluy represents synchronous interface to sending and receiving events from a Broker.
+     */
     @JsonProperty("spec")
     public RequestReplySpec getSpec() {
         return spec;
     }
 
+    /**
+     * RequestRepluy represents synchronous interface to sending and receiving events from a Broker.
+     */
     @JsonProperty("spec")
     public void setSpec(RequestReplySpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * RequestRepluy represents synchronous interface to sending and receiving events from a Broker.
+     */
     @JsonProperty("status")
     public RequestReplyStatus getStatus() {
         return status;
     }
 
+    /**
+     * RequestRepluy represents synchronous interface to sending and receiving events from a Broker.
+     */
     @JsonProperty("status")
     public void setStatus(RequestReplyStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/RequestReplyList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/RequestReplyList.java
index 43056dc6cca..b7bd40e8bad 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/RequestReplyList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/RequestReplyList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RequestReplyList is a collection of RequestReplies.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class RequestReplyList implements Editable<RequestReplyListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.eventing.v1alpha1.RequestReply>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "eventing.knative.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.eventing.v1alpha1.RequestReply> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "RequestReplyList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public RequestReplyList(String apiVersion, List<io.fabric8.knative.eventing.v1al
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * RequestReplyList is a collection of RequestReplies.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.eventing.v1alpha1.RequestReply> getItems() {
         return items;
     }
 
+    /**
+     * RequestReplyList is a collection of RequestReplies.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.eventing.v1alpha1.RequestReply> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RequestReplyList is a collection of RequestReplies.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RequestReplyList is a collection of RequestReplies.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/RequestReplyStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/RequestReplyStatus.java
index 075a2d24222..3fcf8f29d97 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/RequestReplyStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/RequestReplyStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RequestReplyStatus represents the current state of a RequestReply.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -107,65 +110,101 @@ public RequestReplyStatus(Addressable address, List<Addressable> addresses, Map<
         this.policies = policies;
     }
 
+    /**
+     * RequestReplyStatus represents the current state of a RequestReply.
+     */
     @JsonProperty("address")
     public Addressable getAddress() {
         return address;
     }
 
+    /**
+     * RequestReplyStatus represents the current state of a RequestReply.
+     */
     @JsonProperty("address")
     public void setAddress(Addressable address) {
         this.address = address;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Addressable> getAddresses() {
         return addresses;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<Addressable> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Policies holds the list of applied EventPolicies
+     */
     @JsonProperty("policies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AppliedEventPolicyRef> getPolicies() {
         return policies;
     }
 
+    /**
+     * Policies holds the list of applied EventPolicies
+     */
     @JsonProperty("policies")
     public void setPolicies(List<AppliedEventPolicyRef> policies) {
         this.policies = policies;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/SecretReference.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/SecretReference.java
index ba330b9df78..6efdb2263ea 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/SecretReference.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1alpha1/SecretReference.java
@@ -78,11 +78,17 @@ public SecretReference(String name) {
         this.name = name;
     }
 
+    /**
+     * Secret name.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Secret name.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta1/EventType.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta1/EventType.java
index 8a9189c5aca..53816b4c94b 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta1/EventType.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta1/EventType.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventType represents a type of event that can be consumed from a Broker. Deprecated: use v1beta2.EventType instead.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class EventType implements Editable<EventTypeBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "eventing.knative.dev/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EventType";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EventType(String apiVersion, String kind, ObjectMeta metadata, EventTypeS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EventType represents a type of event that can be consumed from a Broker. Deprecated: use v1beta2.EventType instead.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EventType represents a type of event that can be consumed from a Broker. Deprecated: use v1beta2.EventType instead.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * EventType represents a type of event that can be consumed from a Broker. Deprecated: use v1beta2.EventType instead.
+     */
     @JsonProperty("spec")
     public EventTypeSpec getSpec() {
         return spec;
     }
 
+    /**
+     * EventType represents a type of event that can be consumed from a Broker. Deprecated: use v1beta2.EventType instead.
+     */
     @JsonProperty("spec")
     public void setSpec(EventTypeSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * EventType represents a type of event that can be consumed from a Broker. Deprecated: use v1beta2.EventType instead.
+     */
     @JsonProperty("status")
     public EventTypeStatus getStatus() {
         return status;
     }
 
+    /**
+     * EventType represents a type of event that can be consumed from a Broker. Deprecated: use v1beta2.EventType instead.
+     */
     @JsonProperty("status")
     public void setStatus(EventTypeStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta1/EventTypeList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta1/EventTypeList.java
index abe9353eee0..4aec6c4d9bf 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta1/EventTypeList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta1/EventTypeList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventTypeList is a collection of EventTypes.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class EventTypeList implements Editable<EventTypeListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.eventing.v1beta1.EventType>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "eventing.knative.dev/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.eventing.v1beta1.EventType> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EventTypeList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EventTypeList(String apiVersion, List<io.fabric8.knative.eventing.v1beta1
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * EventTypeList is a collection of EventTypes.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.eventing.v1beta1.EventType> getItems() {
         return items;
     }
 
+    /**
+     * EventTypeList is a collection of EventTypes.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.eventing.v1beta1.EventType> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EventTypeList is a collection of EventTypes.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EventTypeList is a collection of EventTypes.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta1/EventTypeSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta1/EventTypeSpec.java
index 62ef0e1f253..4d08e8234bc 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta1/EventTypeSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta1/EventTypeSpec.java
@@ -103,21 +103,33 @@ public EventTypeSpec(String broker, String description, KReference reference, St
         this.type = type;
     }
 
+    /**
+     * Broker refers to the Broker that can provide the EventType.
+     */
     @JsonProperty("broker")
     public String getBroker() {
         return broker;
     }
 
+    /**
+     * Broker refers to the Broker that can provide the EventType.
+     */
     @JsonProperty("broker")
     public void setBroker(String broker) {
         this.broker = broker;
     }
 
+    /**
+     * Description is an optional field used to describe the EventType, in any meaningful way.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is an optional field used to describe the EventType, in any meaningful way.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
@@ -143,11 +155,17 @@ public void setSchema(String schema) {
         this.schema = schema;
     }
 
+    /**
+     * SchemaData allows the CloudEvents schema to be stored directly in the EventType. Content is dependent on the encoding. Optional attribute. The contents are not validated or manipulated by the system.
+     */
     @JsonProperty("schemaData")
     public String getSchemaData() {
         return schemaData;
     }
 
+    /**
+     * SchemaData allows the CloudEvents schema to be stored directly in the EventType. Content is dependent on the encoding. Optional attribute. The contents are not validated or manipulated by the system.
+     */
     @JsonProperty("schemaData")
     public void setSchemaData(String schemaData) {
         this.schemaData = schemaData;
@@ -163,11 +181,17 @@ public void setSource(String source) {
         this.source = source;
     }
 
+    /**
+     * Type represents the CloudEvents type. It is authoritative.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type represents the CloudEvents type. It is authoritative.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta1/EventTypeStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta1/EventTypeStatus.java
index 3aa1416abcb..2e3f8054c49 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta1/EventTypeStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta1/EventTypeStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventTypeStatus represents the current state of a EventType.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,33 +94,51 @@ public EventTypeStatus(Map<String, String> annotations, List<Condition> conditio
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta2/EventType.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta2/EventType.java
index e19b4abb32c..bfb0c7066b4 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta2/EventType.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta2/EventType.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventType represents a type of event that can be consumed from a Broker.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class EventType implements Editable<EventTypeBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "eventing.knative.dev/v1beta2";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EventType";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EventType(String apiVersion, String kind, ObjectMeta metadata, EventTypeS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EventType represents a type of event that can be consumed from a Broker.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EventType represents a type of event that can be consumed from a Broker.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * EventType represents a type of event that can be consumed from a Broker.
+     */
     @JsonProperty("spec")
     public EventTypeSpec getSpec() {
         return spec;
     }
 
+    /**
+     * EventType represents a type of event that can be consumed from a Broker.
+     */
     @JsonProperty("spec")
     public void setSpec(EventTypeSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * EventType represents a type of event that can be consumed from a Broker.
+     */
     @JsonProperty("status")
     public EventTypeStatus getStatus() {
         return status;
     }
 
+    /**
+     * EventType represents a type of event that can be consumed from a Broker.
+     */
     @JsonProperty("status")
     public void setStatus(EventTypeStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta2/EventTypeList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta2/EventTypeList.java
index 2a345fb8eb5..44d2eaf5d50 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta2/EventTypeList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta2/EventTypeList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventTypeList is a collection of EventTypes.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class EventTypeList implements Editable<EventTypeListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.eventing.v1beta2.EventType>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "eventing.knative.dev/v1beta2";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.eventing.v1beta2.EventType> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EventTypeList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EventTypeList(String apiVersion, List<io.fabric8.knative.eventing.v1beta2
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * EventTypeList is a collection of EventTypes.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.eventing.v1beta2.EventType> getItems() {
         return items;
     }
 
+    /**
+     * EventTypeList is a collection of EventTypes.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.eventing.v1beta2.EventType> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EventTypeList is a collection of EventTypes.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EventTypeList is a collection of EventTypes.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta2/EventTypeSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta2/EventTypeSpec.java
index 54084215d60..b8ec0d32d8a 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta2/EventTypeSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta2/EventTypeSpec.java
@@ -103,21 +103,33 @@ public EventTypeSpec(String broker, String description, KReference reference, St
         this.type = type;
     }
 
+    /**
+     * Broker refers to the Broker that can provide the EventType. Deprecated: This field is deprecated and will be removed in a future release.
+     */
     @JsonProperty("broker")
     public String getBroker() {
         return broker;
     }
 
+    /**
+     * Broker refers to the Broker that can provide the EventType. Deprecated: This field is deprecated and will be removed in a future release.
+     */
     @JsonProperty("broker")
     public void setBroker(String broker) {
         this.broker = broker;
     }
 
+    /**
+     * Description is an optional field used to describe the EventType, in any meaningful way.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is an optional field used to describe the EventType, in any meaningful way.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
@@ -143,11 +155,17 @@ public void setSchema(String schema) {
         this.schema = schema;
     }
 
+    /**
+     * SchemaData allows the CloudEvents schema to be stored directly in the EventType. Content is dependent on the encoding. Optional attribute. The contents are not validated or manipulated by the system.
+     */
     @JsonProperty("schemaData")
     public String getSchemaData() {
         return schemaData;
     }
 
+    /**
+     * SchemaData allows the CloudEvents schema to be stored directly in the EventType. Content is dependent on the encoding. Optional attribute. The contents are not validated or manipulated by the system.
+     */
     @JsonProperty("schemaData")
     public void setSchemaData(String schemaData) {
         this.schemaData = schemaData;
@@ -163,11 +181,17 @@ public void setSource(String source) {
         this.source = source;
     }
 
+    /**
+     * Type represents the CloudEvents type. It is authoritative.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type represents the CloudEvents type. It is authoritative.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta2/EventTypeStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta2/EventTypeStatus.java
index d9e687ac940..6886c9c6f05 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta2/EventTypeStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta2/EventTypeStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventTypeStatus represents the current state of a EventType.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,33 +94,51 @@ public EventTypeStatus(Map<String, String> annotations, List<Condition> conditio
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta3/EventAttributeDefinition.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta3/EventAttributeDefinition.java
index 5929327907d..8f3ff90d337 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta3/EventAttributeDefinition.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta3/EventAttributeDefinition.java
@@ -86,31 +86,49 @@ public EventAttributeDefinition(String name, Boolean required, String value) {
         this.value = value;
     }
 
+    /**
+     * Name is the name of the CloudEvents attribute.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the CloudEvents attribute.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Required determines whether this attribute must be set on corresponding CloudEvents.
+     */
     @JsonProperty("required")
     public Boolean getRequired() {
         return required;
     }
 
+    /**
+     * Required determines whether this attribute must be set on corresponding CloudEvents.
+     */
     @JsonProperty("required")
     public void setRequired(Boolean required) {
         this.required = required;
     }
 
+    /**
+     * Value is a string representing the allowable values for the EventType attribute. It may be a single value such as "/apis/v1/namespaces/default/pingsource/ps", or it could be a template for the allowed values, such as "/apis/v1/namespaces/{namespace}/pingsource/{sourceName}. To specify a section of the string value which may change between different CloudEvents you can use curly brackets {} and optionally a variable name between them.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is a string representing the allowable values for the EventType attribute. It may be a single value such as "/apis/v1/namespaces/default/pingsource/ps", or it could be a template for the allowed values, such as "/apis/v1/namespaces/{namespace}/pingsource/{sourceName}. To specify a section of the string value which may change between different CloudEvents you can use curly brackets {} and optionally a variable name between them.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta3/EventType.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta3/EventType.java
index 99a3fe49f4f..6bd56169aae 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta3/EventType.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta3/EventType.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventType represents a type of event that can be consumed from a Broker.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class EventType implements Editable<EventTypeBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "eventing.knative.dev/v1beta3";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EventType";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EventType(String apiVersion, String kind, ObjectMeta metadata, EventTypeS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EventType represents a type of event that can be consumed from a Broker.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EventType represents a type of event that can be consumed from a Broker.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * EventType represents a type of event that can be consumed from a Broker.
+     */
     @JsonProperty("spec")
     public EventTypeSpec getSpec() {
         return spec;
     }
 
+    /**
+     * EventType represents a type of event that can be consumed from a Broker.
+     */
     @JsonProperty("spec")
     public void setSpec(EventTypeSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * EventType represents a type of event that can be consumed from a Broker.
+     */
     @JsonProperty("status")
     public EventTypeStatus getStatus() {
         return status;
     }
 
+    /**
+     * EventType represents a type of event that can be consumed from a Broker.
+     */
     @JsonProperty("status")
     public void setStatus(EventTypeStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta3/EventTypeList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta3/EventTypeList.java
index b6df8967f9b..2ad016552a3 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta3/EventTypeList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta3/EventTypeList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventTypeList is a collection of EventTypes.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class EventTypeList implements Editable<EventTypeListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.eventing.v1beta3.EventType>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "eventing.knative.dev/v1beta3";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.eventing.v1beta3.EventType> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EventTypeList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EventTypeList(String apiVersion, List<io.fabric8.knative.eventing.v1beta3
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * EventTypeList is a collection of EventTypes.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.eventing.v1beta3.EventType> getItems() {
         return items;
     }
 
+    /**
+     * EventTypeList is a collection of EventTypes.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.eventing.v1beta3.EventType> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EventTypeList is a collection of EventTypes.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EventTypeList is a collection of EventTypes.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta3/EventTypeSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta3/EventTypeSpec.java
index a4319b53675..69d5cdf7639 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta3/EventTypeSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta3/EventTypeSpec.java
@@ -90,22 +90,34 @@ public EventTypeSpec(List<EventAttributeDefinition> attributes, String descripti
         this.reference = reference;
     }
 
+    /**
+     * Attributes is an array of CloudEvent attributes and extension attributes.
+     */
     @JsonProperty("attributes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EventAttributeDefinition> getAttributes() {
         return attributes;
     }
 
+    /**
+     * Attributes is an array of CloudEvent attributes and extension attributes.
+     */
     @JsonProperty("attributes")
     public void setAttributes(List<EventAttributeDefinition> attributes) {
         this.attributes = attributes;
     }
 
+    /**
+     * Description is an optional field used to describe the EventType, in any meaningful way.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is an optional field used to describe the EventType, in any meaningful way.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta3/EventTypeStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta3/EventTypeStatus.java
index 84f9435c45e..c874d35372e 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta3/EventTypeStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/eventing/v1beta3/EventTypeStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventTypeStatus represents the current state of a EventType.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,33 +94,51 @@ public EventTypeStatus(Map<String, String> annotations, List<Condition> conditio
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/Parallel.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/Parallel.java
index 278cb61cf59..7328c8a5c3c 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/Parallel.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/Parallel.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Parallel defines conditional branches that will be wired in series through Channels and Subscriptions.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Parallel implements Editable<ParallelBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "flows.knative.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Parallel";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Parallel(String apiVersion, String kind, ObjectMeta metadata, ParallelSpe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Parallel defines conditional branches that will be wired in series through Channels and Subscriptions.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Parallel defines conditional branches that will be wired in series through Channels and Subscriptions.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Parallel defines conditional branches that will be wired in series through Channels and Subscriptions.
+     */
     @JsonProperty("spec")
     public ParallelSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Parallel defines conditional branches that will be wired in series through Channels and Subscriptions.
+     */
     @JsonProperty("spec")
     public void setSpec(ParallelSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Parallel defines conditional branches that will be wired in series through Channels and Subscriptions.
+     */
     @JsonProperty("status")
     public ParallelStatus getStatus() {
         return status;
     }
 
+    /**
+     * Parallel defines conditional branches that will be wired in series through Channels and Subscriptions.
+     */
     @JsonProperty("status")
     public void setStatus(ParallelStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/ParallelBranchStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/ParallelBranchStatus.java
index be7c415bc68..2c265f5401b 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/ParallelBranchStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/ParallelBranchStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ParallelBranchStatus represents the current state of a Parallel branch
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ParallelBranchStatus(ParallelChannelStatus filterChannelStatus, ParallelS
         this.subscriberSubscriptionStatus = subscriberSubscriptionStatus;
     }
 
+    /**
+     * ParallelBranchStatus represents the current state of a Parallel branch
+     */
     @JsonProperty("filterChannelStatus")
     public ParallelChannelStatus getFilterChannelStatus() {
         return filterChannelStatus;
     }
 
+    /**
+     * ParallelBranchStatus represents the current state of a Parallel branch
+     */
     @JsonProperty("filterChannelStatus")
     public void setFilterChannelStatus(ParallelChannelStatus filterChannelStatus) {
         this.filterChannelStatus = filterChannelStatus;
     }
 
+    /**
+     * ParallelBranchStatus represents the current state of a Parallel branch
+     */
     @JsonProperty("filterSubscriptionStatus")
     public ParallelSubscriptionStatus getFilterSubscriptionStatus() {
         return filterSubscriptionStatus;
     }
 
+    /**
+     * ParallelBranchStatus represents the current state of a Parallel branch
+     */
     @JsonProperty("filterSubscriptionStatus")
     public void setFilterSubscriptionStatus(ParallelSubscriptionStatus filterSubscriptionStatus) {
         this.filterSubscriptionStatus = filterSubscriptionStatus;
     }
 
+    /**
+     * ParallelBranchStatus represents the current state of a Parallel branch
+     */
     @JsonProperty("subscriberSubscriptionStatus")
     public ParallelSubscriptionStatus getSubscriberSubscriptionStatus() {
         return subscriberSubscriptionStatus;
     }
 
+    /**
+     * ParallelBranchStatus represents the current state of a Parallel branch
+     */
     @JsonProperty("subscriberSubscriptionStatus")
     public void setSubscriberSubscriptionStatus(ParallelSubscriptionStatus subscriberSubscriptionStatus) {
         this.subscriberSubscriptionStatus = subscriberSubscriptionStatus;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/ParallelList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/ParallelList.java
index 16bf52ef56e..1fbb381938e 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/ParallelList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/ParallelList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ParallelList is a collection of Parallels.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ParallelList implements Editable<ParallelListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.flows.v1.Parallel>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "flows.knative.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.flows.v1.Parallel> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ParallelList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ParallelList(String apiVersion, List<io.fabric8.knative.flows.v1.Parallel
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ParallelList is a collection of Parallels.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.flows.v1.Parallel> getItems() {
         return items;
     }
 
+    /**
+     * ParallelList is a collection of Parallels.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.flows.v1.Parallel> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ParallelList is a collection of Parallels.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ParallelList is a collection of Parallels.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/ParallelSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/ParallelSpec.java
index 70e9121cff1..6a7579c0402 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/ParallelSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/ParallelSpec.java
@@ -91,12 +91,18 @@ public ParallelSpec(List<ParallelBranch> branches, ChannelTemplateSpec channelTe
         this.reply = reply;
     }
 
+    /**
+     * Branches is the list of Filter/Subscribers pairs.
+     */
     @JsonProperty("branches")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ParallelBranch> getBranches() {
         return branches;
     }
 
+    /**
+     * Branches is the list of Filter/Subscribers pairs.
+     */
     @JsonProperty("branches")
     public void setBranches(List<ParallelBranch> branches) {
         this.branches = branches;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/ParallelStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/ParallelStatus.java
index 587962982cb..f11eda1ab15 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/ParallelStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/ParallelStatus.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ParallelStatus represents the current state of a Parallel.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -121,96 +124,150 @@ public ParallelStatus(Addressable address, List<Addressable> addresses, Map<Stri
         this.policies = policies;
     }
 
+    /**
+     * ParallelStatus represents the current state of a Parallel.
+     */
     @JsonProperty("address")
     public Addressable getAddress() {
         return address;
     }
 
+    /**
+     * ParallelStatus represents the current state of a Parallel.
+     */
     @JsonProperty("address")
     public void setAddress(Addressable address) {
         this.address = address;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Addressable> getAddresses() {
         return addresses;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<Addressable> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * ParallelStatus represents the current state of a Parallel.
+     */
     @JsonProperty("auth")
     public AuthStatus getAuth() {
         return auth;
     }
 
+    /**
+     * ParallelStatus represents the current state of a Parallel.
+     */
     @JsonProperty("auth")
     public void setAuth(AuthStatus auth) {
         this.auth = auth;
     }
 
+    /**
+     * BranchStatuses is an array of corresponding to branch statuses. Matches the Spec.Branches array in the order.
+     */
     @JsonProperty("branchStatuses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ParallelBranchStatus> getBranchStatuses() {
         return branchStatuses;
     }
 
+    /**
+     * BranchStatuses is an array of corresponding to branch statuses. Matches the Spec.Branches array in the order.
+     */
     @JsonProperty("branchStatuses")
     public void setBranchStatuses(List<ParallelBranchStatus> branchStatuses) {
         this.branchStatuses = branchStatuses;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ParallelStatus represents the current state of a Parallel.
+     */
     @JsonProperty("ingressChannelStatus")
     public ParallelChannelStatus getIngressChannelStatus() {
         return ingressChannelStatus;
     }
 
+    /**
+     * ParallelStatus represents the current state of a Parallel.
+     */
     @JsonProperty("ingressChannelStatus")
     public void setIngressChannelStatus(ParallelChannelStatus ingressChannelStatus) {
         this.ingressChannelStatus = ingressChannelStatus;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Policies holds the list of applied EventPolicies
+     */
     @JsonProperty("policies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AppliedEventPolicyRef> getPolicies() {
         return policies;
     }
 
+    /**
+     * Policies holds the list of applied EventPolicies
+     */
     @JsonProperty("policies")
     public void setPolicies(List<AppliedEventPolicyRef> policies) {
         this.policies = policies;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/Sequence.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/Sequence.java
index 48b97c8ed1f..a8fd48990e4 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/Sequence.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/Sequence.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Sequence defines a sequence of Subscribers that will be wired in series through Channels and Subscriptions.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Sequence implements Editable<SequenceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "flows.knative.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Sequence";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Sequence(String apiVersion, String kind, ObjectMeta metadata, SequenceSpe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Sequence defines a sequence of Subscribers that will be wired in series through Channels and Subscriptions.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Sequence defines a sequence of Subscribers that will be wired in series through Channels and Subscriptions.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Sequence defines a sequence of Subscribers that will be wired in series through Channels and Subscriptions.
+     */
     @JsonProperty("spec")
     public SequenceSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Sequence defines a sequence of Subscribers that will be wired in series through Channels and Subscriptions.
+     */
     @JsonProperty("spec")
     public void setSpec(SequenceSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Sequence defines a sequence of Subscribers that will be wired in series through Channels and Subscriptions.
+     */
     @JsonProperty("status")
     public SequenceStatus getStatus() {
         return status;
     }
 
+    /**
+     * Sequence defines a sequence of Subscribers that will be wired in series through Channels and Subscriptions.
+     */
     @JsonProperty("status")
     public void setStatus(SequenceStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/SequenceList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/SequenceList.java
index 425daa63496..cb1065443bf 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/SequenceList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/SequenceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SequenceList is a collection of Sequences.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class SequenceList implements Editable<SequenceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.flows.v1.Sequence>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "flows.knative.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.flows.v1.Sequence> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SequenceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public SequenceList(String apiVersion, List<io.fabric8.knative.flows.v1.Sequence
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * SequenceList is a collection of Sequences.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.flows.v1.Sequence> getItems() {
         return items;
     }
 
+    /**
+     * SequenceList is a collection of Sequences.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.flows.v1.Sequence> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SequenceList is a collection of Sequences.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SequenceList is a collection of Sequences.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/SequenceSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/SequenceSpec.java
index 0a9cce55f5e..be37481682a 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/SequenceSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/SequenceSpec.java
@@ -111,12 +111,18 @@ public void setReply(Destination reply) {
         this.reply = reply;
     }
 
+    /**
+     * Steps is the list of Destinations (processors / functions) that will be called in the order provided. Each step has its own delivery options
+     */
     @JsonProperty("steps")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SequenceStep> getSteps() {
         return steps;
     }
 
+    /**
+     * Steps is the list of Destinations (processors / functions) that will be called in the order provided. Each step has its own delivery options
+     */
     @JsonProperty("steps")
     public void setSteps(List<SequenceStep> steps) {
         this.steps = steps;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/SequenceStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/SequenceStatus.java
index cabfda49e00..29486cdf21a 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/SequenceStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/SequenceStatus.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SequenceStatus represents the current state of a Sequence.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -117,86 +120,134 @@ public SequenceStatus(Addressable address, Map<String, String> annotations, Auth
         this.subscriptionStatuses = subscriptionStatuses;
     }
 
+    /**
+     * SequenceStatus represents the current state of a Sequence.
+     */
     @JsonProperty("address")
     public Addressable getAddress() {
         return address;
     }
 
+    /**
+     * SequenceStatus represents the current state of a Sequence.
+     */
     @JsonProperty("address")
     public void setAddress(Addressable address) {
         this.address = address;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * SequenceStatus represents the current state of a Sequence.
+     */
     @JsonProperty("auth")
     public AuthStatus getAuth() {
         return auth;
     }
 
+    /**
+     * SequenceStatus represents the current state of a Sequence.
+     */
     @JsonProperty("auth")
     public void setAuth(AuthStatus auth) {
         this.auth = auth;
     }
 
+    /**
+     * ChannelStatuses is an array of corresponding Channel statuses. Matches the Spec.Steps array in the order.
+     */
     @JsonProperty("channelStatuses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SequenceChannelStatus> getChannelStatuses() {
         return channelStatuses;
     }
 
+    /**
+     * ChannelStatuses is an array of corresponding Channel statuses. Matches the Spec.Steps array in the order.
+     */
     @JsonProperty("channelStatuses")
     public void setChannelStatuses(List<SequenceChannelStatus> channelStatuses) {
         this.channelStatuses = channelStatuses;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Policies holds the list of applied EventPolicies
+     */
     @JsonProperty("policies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AppliedEventPolicyRef> getPolicies() {
         return policies;
     }
 
+    /**
+     * Policies holds the list of applied EventPolicies
+     */
     @JsonProperty("policies")
     public void setPolicies(List<AppliedEventPolicyRef> policies) {
         this.policies = policies;
     }
 
+    /**
+     * SubscriptionStatuses is an array of corresponding Subscription statuses. Matches the Spec.Steps array in the order.
+     */
     @JsonProperty("subscriptionStatuses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SequenceSubscriptionStatus> getSubscriptionStatuses() {
         return subscriptionStatuses;
     }
 
+    /**
+     * SubscriptionStatuses is an array of corresponding Subscription statuses. Matches the Spec.Steps array in the order.
+     */
     @JsonProperty("subscriptionStatuses")
     public void setSubscriptionStatuses(List<SequenceSubscriptionStatus> subscriptionStatuses) {
         this.subscriptionStatuses = subscriptionStatuses;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/SequenceStep.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/SequenceStep.java
index 89a028e757d..3af75a1a46e 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/SequenceStep.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/flows/v1/SequenceStep.java
@@ -96,21 +96,33 @@ public SequenceStep(String cACerts, String audience, DeliverySpec delivery, KRef
         this.uri = uri;
     }
 
+    /**
+     * CACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468. If set, these CAs are appended to the set of CAs provided by the Addressable target, if any.
+     */
     @JsonProperty("CACerts")
     public String getCACerts() {
         return cACerts;
     }
 
+    /**
+     * CACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468. If set, these CAs are appended to the set of CAs provided by the Addressable target, if any.
+     */
     @JsonProperty("CACerts")
     public void setCACerts(String cACerts) {
         this.cACerts = cACerts;
     }
 
+    /**
+     * Audience is the OIDC audience. This need only be set, if the target is not an Addressable and thus the Audience can't be received from the Addressable itself. In case the Addressable specifies an Audience too, the Destinations Audience takes preference.
+     */
     @JsonProperty("audience")
     public String getAudience() {
         return audience;
     }
 
+    /**
+     * Audience is the OIDC audience. This need only be set, if the target is not an Addressable and thus the Audience can't be received from the Addressable itself. In case the Addressable specifies an Audience too, the Destinations Audience takes preference.
+     */
     @JsonProperty("audience")
     public void setAudience(String audience) {
         this.audience = audience;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/Metric.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/Metric.java
index 3c4f4bfb913..cbd18dc2aea 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/Metric.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/Metric.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metric represents a resource to configure the metric collector with.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Metric implements Editable<MetricBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling.internal.knative.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Metric";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Metric(String apiVersion, String kind, ObjectMeta metadata, MetricSpec sp
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Metric represents a resource to configure the metric collector with.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Metric represents a resource to configure the metric collector with.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Metric represents a resource to configure the metric collector with.
+     */
     @JsonProperty("spec")
     public MetricSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Metric represents a resource to configure the metric collector with.
+     */
     @JsonProperty("spec")
     public void setSpec(MetricSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Metric represents a resource to configure the metric collector with.
+     */
     @JsonProperty("status")
     public MetricStatus getStatus() {
         return status;
     }
 
+    /**
+     * Metric represents a resource to configure the metric collector with.
+     */
     @JsonProperty("status")
     public void setStatus(MetricStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/MetricList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/MetricList.java
index 1ead6dacf34..40c2caf8fe4 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/MetricList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/MetricList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MetricList is a list of Metric resources
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class MetricList implements Editable<MetricListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.internal.autoscaling.v1alpha1.Metric>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling.internal.knative.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.internal.autoscaling.v1alpha1.Metric> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MetricList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public MetricList(String apiVersion, List<io.fabric8.knative.internal.autoscalin
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * MetricList is a list of Metric resources
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.internal.autoscaling.v1alpha1.Metric> getItems() {
         return items;
     }
 
+    /**
+     * MetricList is a list of Metric resources
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.internal.autoscaling.v1alpha1.Metric> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MetricList is a list of Metric resources
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MetricList is a list of Metric resources
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/MetricSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/MetricSpec.java
index 6f7497090f3..b60a451674c 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/MetricSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/MetricSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MetricSpec contains all values a metric collector needs to operate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public MetricSpec(Long panicWindow, String scrapeTarget, Long stableWindow) {
         this.stableWindow = stableWindow;
     }
 
+    /**
+     * PanicWindow is the aggregation window for metrics where quick reactions are needed.
+     */
     @JsonProperty("panicWindow")
     public Long getPanicWindow() {
         return panicWindow;
     }
 
+    /**
+     * PanicWindow is the aggregation window for metrics where quick reactions are needed.
+     */
     @JsonProperty("panicWindow")
     public void setPanicWindow(Long panicWindow) {
         this.panicWindow = panicWindow;
     }
 
+    /**
+     * ScrapeTarget is the K8s service that publishes the metric endpoint.
+     */
     @JsonProperty("scrapeTarget")
     public String getScrapeTarget() {
         return scrapeTarget;
     }
 
+    /**
+     * ScrapeTarget is the K8s service that publishes the metric endpoint.
+     */
     @JsonProperty("scrapeTarget")
     public void setScrapeTarget(String scrapeTarget) {
         this.scrapeTarget = scrapeTarget;
     }
 
+    /**
+     * StableWindow is the aggregation window for metrics in a stable state.
+     */
     @JsonProperty("stableWindow")
     public Long getStableWindow() {
         return stableWindow;
     }
 
+    /**
+     * StableWindow is the aggregation window for metrics in a stable state.
+     */
     @JsonProperty("stableWindow")
     public void setStableWindow(Long stableWindow) {
         this.stableWindow = stableWindow;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/MetricStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/MetricStatus.java
index 5bf03ac68c6..57b5d99f042 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/MetricStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/MetricStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MetricStatus reflects the status of metric collection for this specific entity.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,33 +94,51 @@ public MetricStatus(Map<String, String> annotations, List<Condition> conditions,
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodAutoscaler.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodAutoscaler.java
index c4cddf44b66..73a961c9fdf 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodAutoscaler.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodAutoscaler.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodAutoscaler is a Knative abstraction that encapsulates the interface by which Knative components instantiate autoscalers.  This definition is an abstraction that may be backed by multiple definitions.  For more information, see the Knative Pluggability presentation: https://docs.google.com/presentation/d/19vW9HFZ6Puxt31biNZF3uLRejDmu82rxJIk1cWmxF7w/edit
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class PodAutoscaler implements Editable<PodAutoscalerBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling.internal.knative.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodAutoscaler";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PodAutoscaler(String apiVersion, String kind, ObjectMeta metadata, PodAut
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodAutoscaler is a Knative abstraction that encapsulates the interface by which Knative components instantiate autoscalers.  This definition is an abstraction that may be backed by multiple definitions.  For more information, see the Knative Pluggability presentation: https://docs.google.com/presentation/d/19vW9HFZ6Puxt31biNZF3uLRejDmu82rxJIk1cWmxF7w/edit
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodAutoscaler is a Knative abstraction that encapsulates the interface by which Knative components instantiate autoscalers.  This definition is an abstraction that may be backed by multiple definitions.  For more information, see the Knative Pluggability presentation: https://docs.google.com/presentation/d/19vW9HFZ6Puxt31biNZF3uLRejDmu82rxJIk1cWmxF7w/edit
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PodAutoscaler is a Knative abstraction that encapsulates the interface by which Knative components instantiate autoscalers.  This definition is an abstraction that may be backed by multiple definitions.  For more information, see the Knative Pluggability presentation: https://docs.google.com/presentation/d/19vW9HFZ6Puxt31biNZF3uLRejDmu82rxJIk1cWmxF7w/edit
+     */
     @JsonProperty("spec")
     public PodAutoscalerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PodAutoscaler is a Knative abstraction that encapsulates the interface by which Knative components instantiate autoscalers.  This definition is an abstraction that may be backed by multiple definitions.  For more information, see the Knative Pluggability presentation: https://docs.google.com/presentation/d/19vW9HFZ6Puxt31biNZF3uLRejDmu82rxJIk1cWmxF7w/edit
+     */
     @JsonProperty("spec")
     public void setSpec(PodAutoscalerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PodAutoscaler is a Knative abstraction that encapsulates the interface by which Knative components instantiate autoscalers.  This definition is an abstraction that may be backed by multiple definitions.  For more information, see the Knative Pluggability presentation: https://docs.google.com/presentation/d/19vW9HFZ6Puxt31biNZF3uLRejDmu82rxJIk1cWmxF7w/edit
+     */
     @JsonProperty("status")
     public PodAutoscalerStatus getStatus() {
         return status;
     }
 
+    /**
+     * PodAutoscaler is a Knative abstraction that encapsulates the interface by which Knative components instantiate autoscalers.  This definition is an abstraction that may be backed by multiple definitions.  For more information, see the Knative Pluggability presentation: https://docs.google.com/presentation/d/19vW9HFZ6Puxt31biNZF3uLRejDmu82rxJIk1cWmxF7w/edit
+     */
     @JsonProperty("status")
     public void setStatus(PodAutoscalerStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodAutoscalerList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodAutoscalerList.java
index 4fd6912f3d3..d5cc3f03f73 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodAutoscalerList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodAutoscalerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodAutoscalerList is a list of PodAutoscaler resources
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PodAutoscalerList implements Editable<PodAutoscalerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.internal.autoscaling.v1alpha1.PodAutoscaler>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling.internal.knative.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.internal.autoscaling.v1alpha1.PodAutoscaler> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodAutoscalerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PodAutoscalerList(String apiVersion, List<io.fabric8.knative.internal.aut
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PodAutoscalerList is a list of PodAutoscaler resources
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.internal.autoscaling.v1alpha1.PodAutoscaler> getItems() {
         return items;
     }
 
+    /**
+     * PodAutoscalerList is a list of PodAutoscaler resources
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.internal.autoscaling.v1alpha1.PodAutoscaler> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodAutoscalerList is a list of PodAutoscaler resources
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodAutoscalerList is a list of PodAutoscaler resources
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodAutoscalerSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodAutoscalerSpec.java
index 2c07da39020..be141c0bef0 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodAutoscalerSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodAutoscalerSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodAutoscalerSpec holds the desired state of the PodAutoscaler (from the client).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public PodAutoscalerSpec(Long containerConcurrency, String protocolType, String
         this.scaleTargetRef = scaleTargetRef;
     }
 
+    /**
+     * ContainerConcurrency specifies the maximum allowed in-flight (concurrent) requests per container of the Revision. Defaults to `0` which means unlimited concurrency.
+     */
     @JsonProperty("containerConcurrency")
     public Long getContainerConcurrency() {
         return containerConcurrency;
     }
 
+    /**
+     * ContainerConcurrency specifies the maximum allowed in-flight (concurrent) requests per container of the Revision. Defaults to `0` which means unlimited concurrency.
+     */
     @JsonProperty("containerConcurrency")
     public void setContainerConcurrency(Long containerConcurrency) {
         this.containerConcurrency = containerConcurrency;
     }
 
+    /**
+     * The application-layer protocol. Matches `ProtocolType` inferred from the revision spec.
+     */
     @JsonProperty("protocolType")
     public String getProtocolType() {
         return protocolType;
     }
 
+    /**
+     * The application-layer protocol. Matches `ProtocolType` inferred from the revision spec.
+     */
     @JsonProperty("protocolType")
     public void setProtocolType(String protocolType) {
         this.protocolType = protocolType;
     }
 
+    /**
+     * Reachability specifies whether or not the `ScaleTargetRef` can be reached (ie. has a route). Defaults to `ReachabilityUnknown`
+     */
     @JsonProperty("reachability")
     public String getReachability() {
         return reachability;
     }
 
+    /**
+     * Reachability specifies whether or not the `ScaleTargetRef` can be reached (ie. has a route). Defaults to `ReachabilityUnknown`
+     */
     @JsonProperty("reachability")
     public void setReachability(String reachability) {
         this.reachability = reachability;
     }
 
+    /**
+     * PodAutoscalerSpec holds the desired state of the PodAutoscaler (from the client).
+     */
     @JsonProperty("scaleTargetRef")
     public ObjectReference getScaleTargetRef() {
         return scaleTargetRef;
     }
 
+    /**
+     * PodAutoscalerSpec holds the desired state of the PodAutoscaler (from the client).
+     */
     @JsonProperty("scaleTargetRef")
     public void setScaleTargetRef(ObjectReference scaleTargetRef) {
         this.scaleTargetRef = scaleTargetRef;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodAutoscalerStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodAutoscalerStatus.java
index bee68f6f962..6c671a56658 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodAutoscalerStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodAutoscalerStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodAutoscalerStatus communicates the observed state of the PodAutoscaler (from the controller).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -107,73 +110,115 @@ public PodAutoscalerStatus(Integer actualScale, Map<String, String> annotations,
         this.serviceName = serviceName;
     }
 
+    /**
+     * ActualScale shows the actual number of replicas for the revision.
+     */
     @JsonProperty("actualScale")
     public Integer getActualScale() {
         return actualScale;
     }
 
+    /**
+     * ActualScale shows the actual number of replicas for the revision.
+     */
     @JsonProperty("actualScale")
     public void setActualScale(Integer actualScale) {
         this.actualScale = actualScale;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * DesiredScale shows the current desired number of replicas for the revision.
+     */
     @JsonProperty("desiredScale")
     public Integer getDesiredScale() {
         return desiredScale;
     }
 
+    /**
+     * DesiredScale shows the current desired number of replicas for the revision.
+     */
     @JsonProperty("desiredScale")
     public void setDesiredScale(Integer desiredScale) {
         this.desiredScale = desiredScale;
     }
 
+    /**
+     * MetricsServiceName is the K8s Service name that provides revision metrics. The service is managed by the PA object.
+     */
     @JsonProperty("metricsServiceName")
     public String getMetricsServiceName() {
         return metricsServiceName;
     }
 
+    /**
+     * MetricsServiceName is the K8s Service name that provides revision metrics. The service is managed by the PA object.
+     */
     @JsonProperty("metricsServiceName")
     public void setMetricsServiceName(String metricsServiceName) {
         this.metricsServiceName = metricsServiceName;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * ServiceName is the K8s Service name that serves the revision, scaled by this PA. The service is created and owned by the ServerlessService object owned by this PA.
+     */
     @JsonProperty("serviceName")
     public String getServiceName() {
         return serviceName;
     }
 
+    /**
+     * ServiceName is the K8s Service name that serves the revision, scaled by this PA. The service is created and owned by the ServerlessService object owned by this PA.
+     */
     @JsonProperty("serviceName")
     public void setServiceName(String serviceName) {
         this.serviceName = serviceName;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodScalable.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodScalable.java
index 998cb3961fa..b2eaa8ca2a0 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodScalable.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodScalable.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodScalable is a duck type that the resources referenced by the PodAutoscaler's ScaleTargetRef must implement.  They must also implement the `/scale` sub-resource for use with `/scale` based implementations (e.g. HPA), but this further constrains the shape the referenced resources may take.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class PodScalable implements Editable<PodScalableBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling.internal.knative.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodScalable";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PodScalable(String apiVersion, String kind, ObjectMeta metadata, PodScala
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodScalable is a duck type that the resources referenced by the PodAutoscaler's ScaleTargetRef must implement.  They must also implement the `/scale` sub-resource for use with `/scale` based implementations (e.g. HPA), but this further constrains the shape the referenced resources may take.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodScalable is a duck type that the resources referenced by the PodAutoscaler's ScaleTargetRef must implement.  They must also implement the `/scale` sub-resource for use with `/scale` based implementations (e.g. HPA), but this further constrains the shape the referenced resources may take.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PodScalable is a duck type that the resources referenced by the PodAutoscaler's ScaleTargetRef must implement.  They must also implement the `/scale` sub-resource for use with `/scale` based implementations (e.g. HPA), but this further constrains the shape the referenced resources may take.
+     */
     @JsonProperty("spec")
     public PodScalableSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PodScalable is a duck type that the resources referenced by the PodAutoscaler's ScaleTargetRef must implement.  They must also implement the `/scale` sub-resource for use with `/scale` based implementations (e.g. HPA), but this further constrains the shape the referenced resources may take.
+     */
     @JsonProperty("spec")
     public void setSpec(PodScalableSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PodScalable is a duck type that the resources referenced by the PodAutoscaler's ScaleTargetRef must implement.  They must also implement the `/scale` sub-resource for use with `/scale` based implementations (e.g. HPA), but this further constrains the shape the referenced resources may take.
+     */
     @JsonProperty("status")
     public PodScalableStatus getStatus() {
         return status;
     }
 
+    /**
+     * PodScalable is a duck type that the resources referenced by the PodAutoscaler's ScaleTargetRef must implement.  They must also implement the `/scale` sub-resource for use with `/scale` based implementations (e.g. HPA), but this further constrains the shape the referenced resources may take.
+     */
     @JsonProperty("status")
     public void setStatus(PodScalableStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodScalableList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodScalableList.java
index f4613ff6bf5..3e55c58ac75 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodScalableList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodScalableList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodScalableList is a list of PodScalable resources
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PodScalableList implements Editable<PodScalableListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.internal.autoscaling.v1alpha1.PodScalable>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling.internal.knative.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.internal.autoscaling.v1alpha1.PodScalable> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodScalableList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PodScalableList(String apiVersion, List<io.fabric8.knative.internal.autos
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PodScalableList is a list of PodScalable resources
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.internal.autoscaling.v1alpha1.PodScalable> getItems() {
         return items;
     }
 
+    /**
+     * PodScalableList is a list of PodScalable resources
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.internal.autoscaling.v1alpha1.PodScalable> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodScalableList is a list of PodScalable resources
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodScalableList is a list of PodScalable resources
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodScalableSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodScalableSpec.java
index a281e660c90..bdeb3e300aa 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodScalableSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodScalableSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodScalableSpec is the specification for the desired state of a PodScalable (or at least our shared portion).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public PodScalableSpec(Integer replicas, LabelSelector selector, PodTemplateSpec
         this.template = template;
     }
 
+    /**
+     * PodScalableSpec is the specification for the desired state of a PodScalable (or at least our shared portion).
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * PodScalableSpec is the specification for the desired state of a PodScalable (or at least our shared portion).
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * PodScalableSpec is the specification for the desired state of a PodScalable (or at least our shared portion).
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * PodScalableSpec is the specification for the desired state of a PodScalable (or at least our shared portion).
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * PodScalableSpec is the specification for the desired state of a PodScalable (or at least our shared portion).
+     */
     @JsonProperty("template")
     public PodTemplateSpec getTemplate() {
         return template;
     }
 
+    /**
+     * PodScalableSpec is the specification for the desired state of a PodScalable (or at least our shared portion).
+     */
     @JsonProperty("template")
     public void setTemplate(PodTemplateSpec template) {
         this.template = template;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodScalableStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodScalableStatus.java
index 0cc1a30898d..4b9b896e331 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodScalableStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/autoscaling/v1alpha1/PodScalableStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodScalableStatus is the observed state of a PodScalable (or at least our shared portion).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public PodScalableStatus(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * PodScalableStatus is the observed state of a PodScalable (or at least our shared portion).
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * PodScalableStatus is the observed state of a PodScalable (or at least our shared portion).
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/caching/v1alpha1/Image.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/caching/v1alpha1/Image.java
index 41b4c8be1f0..584f5a6e5e9 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/caching/v1alpha1/Image.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/caching/v1alpha1/Image.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Image is a Knative abstraction that encapsulates the interface by which Knative components express a desire to have a particular image cached.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Image implements Editable<ImageBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "caching.internal.knative.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Image";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Image(String apiVersion, String kind, ObjectMeta metadata, ImageSpec spec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Image is a Knative abstraction that encapsulates the interface by which Knative components express a desire to have a particular image cached.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Image is a Knative abstraction that encapsulates the interface by which Knative components express a desire to have a particular image cached.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Image is a Knative abstraction that encapsulates the interface by which Knative components express a desire to have a particular image cached.
+     */
     @JsonProperty("spec")
     public ImageSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Image is a Knative abstraction that encapsulates the interface by which Knative components express a desire to have a particular image cached.
+     */
     @JsonProperty("spec")
     public void setSpec(ImageSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Image is a Knative abstraction that encapsulates the interface by which Knative components express a desire to have a particular image cached.
+     */
     @JsonProperty("status")
     public ImageStatus getStatus() {
         return status;
     }
 
+    /**
+     * Image is a Knative abstraction that encapsulates the interface by which Knative components express a desire to have a particular image cached.
+     */
     @JsonProperty("status")
     public void setStatus(ImageStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/caching/v1alpha1/ImageList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/caching/v1alpha1/ImageList.java
index d6aa88d1633..6368709540b 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/caching/v1alpha1/ImageList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/caching/v1alpha1/ImageList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageList is a list of Image resources
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ImageList implements Editable<ImageListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.internal.caching.v1alpha1.Image>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "caching.internal.knative.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.internal.caching.v1alpha1.Image> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ImageList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ImageList(String apiVersion, List<io.fabric8.knative.internal.caching.v1a
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ImageList is a list of Image resources
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.internal.caching.v1alpha1.Image> getItems() {
         return items;
     }
 
+    /**
+     * ImageList is a list of Image resources
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.internal.caching.v1alpha1.Image> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ImageList is a list of Image resources
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ImageList is a list of Image resources
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/caching/v1alpha1/ImageSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/caching/v1alpha1/ImageSpec.java
index b33c323057c..3fc7f0d5990 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/caching/v1alpha1/ImageSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/caching/v1alpha1/ImageSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageSpec holds the desired state of the Image (from the client).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public ImageSpec(String image, List<LocalObjectReference> imagePullSecrets, Stri
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * Image is the name of the container image url to cache across the cluster.
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * Image is the name of the container image url to cache across the cluster.
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
     }
 
+    /**
+     * ImagePullSecrets contains the names of the Kubernetes Secrets containing login information used by the Pods which will run this container.
+     */
     @JsonProperty("imagePullSecrets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LocalObjectReference> getImagePullSecrets() {
         return imagePullSecrets;
     }
 
+    /**
+     * ImagePullSecrets contains the names of the Kubernetes Secrets containing login information used by the Pods which will run this container.
+     */
     @JsonProperty("imagePullSecrets")
     public void setImagePullSecrets(List<LocalObjectReference> imagePullSecrets) {
         this.imagePullSecrets = imagePullSecrets;
     }
 
+    /**
+     * ServiceAccountName is the name of the Kubernetes ServiceAccount as which the Pods will run this container.  This is potentially used to authenticate the image pull if the service account has attached pull secrets.  For more information: https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/#add-imagepullsecrets-to-a-service-account
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * ServiceAccountName is the name of the Kubernetes ServiceAccount as which the Pods will run this container.  This is potentially used to authenticate the image pull if the service account has attached pull secrets.  For more information: https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/#add-imagepullsecrets-to-a-service-account
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/caching/v1alpha1/ImageStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/caching/v1alpha1/ImageStatus.java
index 5124666865b..f10e6778f62 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/caching/v1alpha1/ImageStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/caching/v1alpha1/ImageStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageStatus communicates the observed state of the Image (from the controller).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,33 +94,51 @@ public ImageStatus(Map<String, String> annotations, List<Condition> conditions,
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/Certificate.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/Certificate.java
index 0846da69ef5..50e98ab6983 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/Certificate.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/Certificate.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Certificate is responsible for provisioning a SSL certificate for the given hosts. It is a Knative abstraction for various SSL certificate provisioning solutions (such as cert-manager or self-signed SSL certificate).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Certificate implements Editable<CertificateBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.internal.knative.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Certificate";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Certificate(String apiVersion, String kind, ObjectMeta metadata, Certific
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Certificate is responsible for provisioning a SSL certificate for the given hosts. It is a Knative abstraction for various SSL certificate provisioning solutions (such as cert-manager or self-signed SSL certificate).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Certificate is responsible for provisioning a SSL certificate for the given hosts. It is a Knative abstraction for various SSL certificate provisioning solutions (such as cert-manager or self-signed SSL certificate).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Certificate is responsible for provisioning a SSL certificate for the given hosts. It is a Knative abstraction for various SSL certificate provisioning solutions (such as cert-manager or self-signed SSL certificate).
+     */
     @JsonProperty("spec")
     public CertificateSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Certificate is responsible for provisioning a SSL certificate for the given hosts. It is a Knative abstraction for various SSL certificate provisioning solutions (such as cert-manager or self-signed SSL certificate).
+     */
     @JsonProperty("spec")
     public void setSpec(CertificateSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Certificate is responsible for provisioning a SSL certificate for the given hosts. It is a Knative abstraction for various SSL certificate provisioning solutions (such as cert-manager or self-signed SSL certificate).
+     */
     @JsonProperty("status")
     public CertificateStatus getStatus() {
         return status;
     }
 
+    /**
+     * Certificate is responsible for provisioning a SSL certificate for the given hosts. It is a Knative abstraction for various SSL certificate provisioning solutions (such as cert-manager or self-signed SSL certificate).
+     */
     @JsonProperty("status")
     public void setStatus(CertificateStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/CertificateList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/CertificateList.java
index de416295e8f..a0e0f6fc109 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/CertificateList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/CertificateList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CertificateList is a collection of `Certificate`.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class CertificateList implements Editable<CertificateListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.internal.networking.v1alpha1.Certificate>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.internal.knative.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.internal.networking.v1alpha1.Certificate> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CertificateList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CertificateList(String apiVersion, List<io.fabric8.knative.internal.netwo
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of `Certificate`.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.internal.networking.v1alpha1.Certificate> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of `Certificate`.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.internal.networking.v1alpha1.Certificate> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CertificateList is a collection of `Certificate`.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CertificateList is a collection of `Certificate`.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/CertificateSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/CertificateSpec.java
index 8af0d52fbbc..7181b9fa02d 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/CertificateSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/CertificateSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CertificateSpec defines the desired state of a `Certificate`.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public CertificateSpec(List<String> dnsNames, String domain, String secretName)
         this.secretName = secretName;
     }
 
+    /**
+     * DNSNames is a list of DNS names the Certificate could support. The wildcard format of DNSNames (e.g. &#42;.default.example.com) is supported.
+     */
     @JsonProperty("dnsNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDnsNames() {
         return dnsNames;
     }
 
+    /**
+     * DNSNames is a list of DNS names the Certificate could support. The wildcard format of DNSNames (e.g. &#42;.default.example.com) is supported.
+     */
     @JsonProperty("dnsNames")
     public void setDnsNames(List<String> dnsNames) {
         this.dnsNames = dnsNames;
     }
 
+    /**
+     * Domain is the top level domain of the values for DNSNames.
+     */
     @JsonProperty("domain")
     public String getDomain() {
         return domain;
     }
 
+    /**
+     * Domain is the top level domain of the values for DNSNames.
+     */
     @JsonProperty("domain")
     public void setDomain(String domain) {
         this.domain = domain;
     }
 
+    /**
+     * SecretName is the name of the secret resource to store the SSL certificate in.
+     */
     @JsonProperty("secretName")
     public String getSecretName() {
         return secretName;
     }
 
+    /**
+     * SecretName is the name of the secret resource to store the SSL certificate in.
+     */
     @JsonProperty("secretName")
     public void setSecretName(String secretName) {
         this.secretName = secretName;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/CertificateStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/CertificateStatus.java
index d2f80d9cc7f..c96e9c94d99 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/CertificateStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/CertificateStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CertificateStatus defines the observed state of a `Certificate`.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -100,54 +103,84 @@ public CertificateStatus(Map<String, String> annotations, List<Condition> condit
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * HTTP01Challenges is a list of HTTP01 challenges that need to be fulfilled in order to get the TLS certificate..
+     */
     @JsonProperty("http01Challenges")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HTTP01Challenge> getHttp01Challenges() {
         return http01Challenges;
     }
 
+    /**
+     * HTTP01Challenges is a list of HTTP01 challenges that need to be fulfilled in order to get the TLS certificate..
+     */
     @JsonProperty("http01Challenges")
     public void setHttp01Challenges(List<HTTP01Challenge> http01Challenges) {
         this.http01Challenges = http01Challenges;
     }
 
+    /**
+     * CertificateStatus defines the observed state of a `Certificate`.
+     */
     @JsonProperty("notAfter")
     public String getNotAfter() {
         return notAfter;
     }
 
+    /**
+     * CertificateStatus defines the observed state of a `Certificate`.
+     */
     @JsonProperty("notAfter")
     public void setNotAfter(String notAfter) {
         this.notAfter = notAfter;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/ClusterDomainClaim.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/ClusterDomainClaim.java
index a730d812d0d..a69581a9dcc 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/ClusterDomainClaim.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/ClusterDomainClaim.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterDomainClaim is a cluster-wide reservation for a particular domain name.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class ClusterDomainClaim implements Editable<ClusterDomainClaimBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.internal.knative.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterDomainClaim";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public ClusterDomainClaim(String apiVersion, String kind, ObjectMeta metadata, C
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterDomainClaim is a cluster-wide reservation for a particular domain name.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterDomainClaim is a cluster-wide reservation for a particular domain name.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ClusterDomainClaim is a cluster-wide reservation for a particular domain name.
+     */
     @JsonProperty("spec")
     public ClusterDomainClaimSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ClusterDomainClaim is a cluster-wide reservation for a particular domain name.
+     */
     @JsonProperty("spec")
     public void setSpec(ClusterDomainClaimSpec spec) {
         this.spec = spec;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/ClusterDomainClaimList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/ClusterDomainClaimList.java
index d8aefdc5f7b..1619d809364 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/ClusterDomainClaimList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/ClusterDomainClaimList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterDomainClaimList is a collection of ClusterDomainClaim objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ClusterDomainClaimList implements Editable<ClusterDomainClaimListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.internal.networking.v1alpha1.ClusterDomainClaim>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.internal.knative.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.internal.networking.v1alpha1.ClusterDomainClaim> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterDomainClaimList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterDomainClaimList(String apiVersion, List<io.fabric8.knative.interna
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of ClusterDomainClaim objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.internal.networking.v1alpha1.ClusterDomainClaim> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of ClusterDomainClaim objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.internal.networking.v1alpha1.ClusterDomainClaim> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterDomainClaimList is a collection of ClusterDomainClaim objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterDomainClaimList is a collection of ClusterDomainClaim objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/ClusterDomainClaimSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/ClusterDomainClaimSpec.java
index 097ce3ed2ff..6bce5aae0a7 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/ClusterDomainClaimSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/ClusterDomainClaimSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterDomainClaimSpec is the desired state of the ClusterDomainClaim. Its only field is `namespace`, which controls which namespace currently owns the ability to create a DomainMapping with the ClusterDomainClaim's name.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ClusterDomainClaimSpec(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Namespace is the namespace which is allowed to create a DomainMapping using this ClusterDomainClaim's name.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace which is allowed to create a DomainMapping using this ClusterDomainClaim's name.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/HTTP01Challenge.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/HTTP01Challenge.java
index fbee0791f8c..fae1e850ac5 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/HTTP01Challenge.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/HTTP01Challenge.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTP01Challenge defines the status of a HTTP01 challenge that a certificate needs to fulfill.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public HTTP01Challenge(String serviceName, String serviceNamespace, IntOrString
         this.url = url;
     }
 
+    /**
+     * ServiceName is the name of the service to serve HTTP01 challenge requests.
+     */
     @JsonProperty("serviceName")
     public String getServiceName() {
         return serviceName;
     }
 
+    /**
+     * ServiceName is the name of the service to serve HTTP01 challenge requests.
+     */
     @JsonProperty("serviceName")
     public void setServiceName(String serviceName) {
         this.serviceName = serviceName;
     }
 
+    /**
+     * ServiceNamespace is the namespace of the service to serve HTTP01 challenge requests.
+     */
     @JsonProperty("serviceNamespace")
     public String getServiceNamespace() {
         return serviceNamespace;
     }
 
+    /**
+     * ServiceNamespace is the namespace of the service to serve HTTP01 challenge requests.
+     */
     @JsonProperty("serviceNamespace")
     public void setServiceNamespace(String serviceNamespace) {
         this.serviceNamespace = serviceNamespace;
     }
 
+    /**
+     * HTTP01Challenge defines the status of a HTTP01 challenge that a certificate needs to fulfill.
+     */
     @JsonProperty("servicePort")
     public IntOrString getServicePort() {
         return servicePort;
     }
 
+    /**
+     * HTTP01Challenge defines the status of a HTTP01 challenge that a certificate needs to fulfill.
+     */
     @JsonProperty("servicePort")
     public void setServicePort(IntOrString servicePort) {
         this.servicePort = servicePort;
     }
 
+    /**
+     * HTTP01Challenge defines the status of a HTTP01 challenge that a certificate needs to fulfill.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * HTTP01Challenge defines the status of a HTTP01 challenge that a certificate needs to fulfill.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/HTTPIngressPath.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/HTTPIngressPath.java
index 3462c8324b0..829799cdea6 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/HTTPIngressPath.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/HTTPIngressPath.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPIngressPath associates a path regex with a backend. Incoming URLs matching the path are forwarded to the backend.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -99,54 +102,84 @@ public HTTPIngressPath(Map<String, String> appendHeaders, Map<String, HeaderMatc
         this.splits = splits;
     }
 
+    /**
+     * AppendHeaders allow specifying additional HTTP headers to add before forwarding a request to the destination service.<br><p> <br><p> NOTE: This differs from K8s Ingress which doesn't allow header appending.
+     */
     @JsonProperty("appendHeaders")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAppendHeaders() {
         return appendHeaders;
     }
 
+    /**
+     * AppendHeaders allow specifying additional HTTP headers to add before forwarding a request to the destination service.<br><p> <br><p> NOTE: This differs from K8s Ingress which doesn't allow header appending.
+     */
     @JsonProperty("appendHeaders")
     public void setAppendHeaders(Map<String, String> appendHeaders) {
         this.appendHeaders = appendHeaders;
     }
 
+    /**
+     * Headers defines header matching rules which is a map from a header name to HeaderMatch which specify a matching condition. When a request matched with all the header matching rules, the request is routed by the corresponding ingress rule. If it is empty, the headers are not used for matching
+     */
     @JsonProperty("headers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, HeaderMatch> getHeaders() {
         return headers;
     }
 
+    /**
+     * Headers defines header matching rules which is a map from a header name to HeaderMatch which specify a matching condition. When a request matched with all the header matching rules, the request is routed by the corresponding ingress rule. If it is empty, the headers are not used for matching
+     */
     @JsonProperty("headers")
     public void setHeaders(Map<String, HeaderMatch> headers) {
         this.headers = headers;
     }
 
+    /**
+     * Path represents a literal prefix to which this rule should apply. Currently it can contain characters disallowed from the conventional "path" part of a URL as defined by RFC 3986. Paths must begin with a '/'. If unspecified, the path defaults to a catch all sending traffic to the backend.
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Path represents a literal prefix to which this rule should apply. Currently it can contain characters disallowed from the conventional "path" part of a URL as defined by RFC 3986. Paths must begin with a '/'. If unspecified, the path defaults to a catch all sending traffic to the backend.
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * RewriteHost rewrites the incoming request's host header.<br><p> <br><p> This field is currently experimental and not supported by all Ingress implementations.
+     */
     @JsonProperty("rewriteHost")
     public String getRewriteHost() {
         return rewriteHost;
     }
 
+    /**
+     * RewriteHost rewrites the incoming request's host header.<br><p> <br><p> This field is currently experimental and not supported by all Ingress implementations.
+     */
     @JsonProperty("rewriteHost")
     public void setRewriteHost(String rewriteHost) {
         this.rewriteHost = rewriteHost;
     }
 
+    /**
+     * Splits defines the referenced service endpoints to which the traffic will be forwarded to.
+     */
     @JsonProperty("splits")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IngressBackendSplit> getSplits() {
         return splits;
     }
 
+    /**
+     * Splits defines the referenced service endpoints to which the traffic will be forwarded to.
+     */
     @JsonProperty("splits")
     public void setSplits(List<IngressBackendSplit> splits) {
         this.splits = splits;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/HTTPIngressRuleValue.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/HTTPIngressRuleValue.java
index c84ac16bd69..db2a9b69014 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/HTTPIngressRuleValue.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/HTTPIngressRuleValue.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPIngressRuleValue is a list of http selectors pointing to backends. In the example: http://&lt;host&gt;/&lt;path&gt;?&lt;searchpart&gt; -&gt; backend where where parts of the url correspond to RFC 3986, this resource will be used to match against everything after the last '/' and before the first '?' or '#'.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public HTTPIngressRuleValue(List<HTTPIngressPath> paths) {
         this.paths = paths;
     }
 
+    /**
+     * A collection of paths that map requests to backends.<br><p> <br><p> If they are multiple matching paths, the first match takes precedence.
+     */
     @JsonProperty("paths")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HTTPIngressPath> getPaths() {
         return paths;
     }
 
+    /**
+     * A collection of paths that map requests to backends.<br><p> <br><p> If they are multiple matching paths, the first match takes precedence.
+     */
     @JsonProperty("paths")
     public void setPaths(List<HTTPIngressPath> paths) {
         this.paths = paths;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/HTTPRetry.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/HTTPRetry.java
index a7339f7f8d3..61b100cd012 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/HTTPRetry.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/HTTPRetry.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPRetry is DEPRECATED. Retry is not used in KIngress.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public HTTPRetry(Integer attempts, Duration perTryTimeout) {
         this.perTryTimeout = perTryTimeout;
     }
 
+    /**
+     * Number of retries for a given request.
+     */
     @JsonProperty("attempts")
     public Integer getAttempts() {
         return attempts;
     }
 
+    /**
+     * Number of retries for a given request.
+     */
     @JsonProperty("attempts")
     public void setAttempts(Integer attempts) {
         this.attempts = attempts;
     }
 
+    /**
+     * HTTPRetry is DEPRECATED. Retry is not used in KIngress.
+     */
     @JsonProperty("perTryTimeout")
     public Duration getPerTryTimeout() {
         return perTryTimeout;
     }
 
+    /**
+     * HTTPRetry is DEPRECATED. Retry is not used in KIngress.
+     */
     @JsonProperty("perTryTimeout")
     public void setPerTryTimeout(Duration perTryTimeout) {
         this.perTryTimeout = perTryTimeout;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/HeaderMatch.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/HeaderMatch.java
index 8add9c5f3e9..9be31f3c487 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/HeaderMatch.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/HeaderMatch.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HeaderMatch represents a matching value of Headers in HTTPIngressPath. Currently, only the exact matching is supported.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public HeaderMatch(String exact) {
         this.exact = exact;
     }
 
+    /**
+     * HeaderMatch represents a matching value of Headers in HTTPIngressPath. Currently, only the exact matching is supported.
+     */
     @JsonProperty("exact")
     public String getExact() {
         return exact;
     }
 
+    /**
+     * HeaderMatch represents a matching value of Headers in HTTPIngressPath. Currently, only the exact matching is supported.
+     */
     @JsonProperty("exact")
     public void setExact(String exact) {
         this.exact = exact;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/Ingress.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/Ingress.java
index 7b4bc4479b5..2edbdf3553a 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/Ingress.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/Ingress.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable URLs, load balance traffic, offer name based virtual hosting, etc.<br><p> <br><p> This is heavily based on K8s Ingress https://godoc.org/k8s.io/api/networking/v1beta1#Ingress which some highlighted modifications.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Ingress implements Editable<IngressBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.internal.knative.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Ingress";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Ingress(String apiVersion, String kind, ObjectMeta metadata, IngressSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable URLs, load balance traffic, offer name based virtual hosting, etc.<br><p> <br><p> This is heavily based on K8s Ingress https://godoc.org/k8s.io/api/networking/v1beta1#Ingress which some highlighted modifications.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable URLs, load balance traffic, offer name based virtual hosting, etc.<br><p> <br><p> This is heavily based on K8s Ingress https://godoc.org/k8s.io/api/networking/v1beta1#Ingress which some highlighted modifications.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable URLs, load balance traffic, offer name based virtual hosting, etc.<br><p> <br><p> This is heavily based on K8s Ingress https://godoc.org/k8s.io/api/networking/v1beta1#Ingress which some highlighted modifications.
+     */
     @JsonProperty("spec")
     public IngressSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable URLs, load balance traffic, offer name based virtual hosting, etc.<br><p> <br><p> This is heavily based on K8s Ingress https://godoc.org/k8s.io/api/networking/v1beta1#Ingress which some highlighted modifications.
+     */
     @JsonProperty("spec")
     public void setSpec(IngressSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable URLs, load balance traffic, offer name based virtual hosting, etc.<br><p> <br><p> This is heavily based on K8s Ingress https://godoc.org/k8s.io/api/networking/v1beta1#Ingress which some highlighted modifications.
+     */
     @JsonProperty("status")
     public IngressStatus getStatus() {
         return status;
     }
 
+    /**
+     * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable URLs, load balance traffic, offer name based virtual hosting, etc.<br><p> <br><p> This is heavily based on K8s Ingress https://godoc.org/k8s.io/api/networking/v1beta1#Ingress which some highlighted modifications.
+     */
     @JsonProperty("status")
     public void setStatus(IngressStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/IngressBackend.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/IngressBackend.java
index c56efd0dec7..26ddbe9421b 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/IngressBackend.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/IngressBackend.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressBackend describes all endpoints for a given service and port.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public IngressBackend(String serviceName, String serviceNamespace, IntOrString s
         this.servicePort = servicePort;
     }
 
+    /**
+     * Specifies the name of the referenced service.
+     */
     @JsonProperty("serviceName")
     public String getServiceName() {
         return serviceName;
     }
 
+    /**
+     * Specifies the name of the referenced service.
+     */
     @JsonProperty("serviceName")
     public void setServiceName(String serviceName) {
         this.serviceName = serviceName;
     }
 
+    /**
+     * Specifies the namespace of the referenced service.<br><p> <br><p> NOTE: This differs from K8s Ingress to allow routing to different namespaces.
+     */
     @JsonProperty("serviceNamespace")
     public String getServiceNamespace() {
         return serviceNamespace;
     }
 
+    /**
+     * Specifies the namespace of the referenced service.<br><p> <br><p> NOTE: This differs from K8s Ingress to allow routing to different namespaces.
+     */
     @JsonProperty("serviceNamespace")
     public void setServiceNamespace(String serviceNamespace) {
         this.serviceNamespace = serviceNamespace;
     }
 
+    /**
+     * IngressBackend describes all endpoints for a given service and port.
+     */
     @JsonProperty("servicePort")
     public IntOrString getServicePort() {
         return servicePort;
     }
 
+    /**
+     * IngressBackend describes all endpoints for a given service and port.
+     */
     @JsonProperty("servicePort")
     public void setServicePort(IntOrString servicePort) {
         this.servicePort = servicePort;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/IngressBackendSplit.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/IngressBackendSplit.java
index 32d4fc70ff6..12e5ea18a81 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/IngressBackendSplit.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/IngressBackendSplit.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressBackendSplit describes all endpoints for a given service and port.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,52 +98,82 @@ public IngressBackendSplit(Map<String, String> appendHeaders, Integer percent, S
         this.servicePort = servicePort;
     }
 
+    /**
+     * AppendHeaders allow specifying additional HTTP headers to add before forwarding a request to the destination service.<br><p> <br><p> NOTE: This differs from K8s Ingress which doesn't allow header appending.
+     */
     @JsonProperty("appendHeaders")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAppendHeaders() {
         return appendHeaders;
     }
 
+    /**
+     * AppendHeaders allow specifying additional HTTP headers to add before forwarding a request to the destination service.<br><p> <br><p> NOTE: This differs from K8s Ingress which doesn't allow header appending.
+     */
     @JsonProperty("appendHeaders")
     public void setAppendHeaders(Map<String, String> appendHeaders) {
         this.appendHeaders = appendHeaders;
     }
 
+    /**
+     * Specifies the split percentage, a number between 0 and 100.  If only one split is specified, we default to 100.<br><p> <br><p> NOTE: This differs from K8s Ingress to allow percentage split.
+     */
     @JsonProperty("percent")
     public Integer getPercent() {
         return percent;
     }
 
+    /**
+     * Specifies the split percentage, a number between 0 and 100.  If only one split is specified, we default to 100.<br><p> <br><p> NOTE: This differs from K8s Ingress to allow percentage split.
+     */
     @JsonProperty("percent")
     public void setPercent(Integer percent) {
         this.percent = percent;
     }
 
+    /**
+     * Specifies the name of the referenced service.
+     */
     @JsonProperty("serviceName")
     public String getServiceName() {
         return serviceName;
     }
 
+    /**
+     * Specifies the name of the referenced service.
+     */
     @JsonProperty("serviceName")
     public void setServiceName(String serviceName) {
         this.serviceName = serviceName;
     }
 
+    /**
+     * Specifies the namespace of the referenced service.<br><p> <br><p> NOTE: This differs from K8s Ingress to allow routing to different namespaces.
+     */
     @JsonProperty("serviceNamespace")
     public String getServiceNamespace() {
         return serviceNamespace;
     }
 
+    /**
+     * Specifies the namespace of the referenced service.<br><p> <br><p> NOTE: This differs from K8s Ingress to allow routing to different namespaces.
+     */
     @JsonProperty("serviceNamespace")
     public void setServiceNamespace(String serviceNamespace) {
         this.serviceNamespace = serviceNamespace;
     }
 
+    /**
+     * IngressBackendSplit describes all endpoints for a given service and port.
+     */
     @JsonProperty("servicePort")
     public IntOrString getServicePort() {
         return servicePort;
     }
 
+    /**
+     * IngressBackendSplit describes all endpoints for a given service and port.
+     */
     @JsonProperty("servicePort")
     public void setServicePort(IntOrString servicePort) {
         this.servicePort = servicePort;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/IngressList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/IngressList.java
index 3e3ded8f2f4..1c30ad01fb7 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/IngressList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/IngressList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressList is a collection of Ingress objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class IngressList implements Editable<IngressListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.internal.networking.v1alpha1.Ingress>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.internal.knative.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.internal.networking.v1alpha1.Ingress> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "IngressList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public IngressList(String apiVersion, List<io.fabric8.knative.internal.networkin
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of Ingress objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.internal.networking.v1alpha1.Ingress> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of Ingress objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.internal.networking.v1alpha1.Ingress> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * IngressList is a collection of Ingress objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * IngressList is a collection of Ingress objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/IngressRule.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/IngressRule.java
index ecda40428d8..f22939e6659 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/IngressRule.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/IngressRule.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressRule represents the rules mapping the paths under a specified host to the related backend services. Incoming requests are first evaluated for a host match, then routed to the backend associated with the matching IngressRuleValue.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public IngressRule(List<String> hosts, HTTPIngressRuleValue http, String visibil
         this.visibility = visibility;
     }
 
+    /**
+     * Host is the fully qualified domain name of a network host, as defined by RFC 3986. Note the following deviations from the "host" part of the URI as defined in the RFC: 1. IPs are not allowed. Currently a rule value can only apply to the<br><p> 	  IP in the Spec of the parent .<br><p> 2. The `:` delimiter is not respected because ports are not allowed.<br><p> 	  Currently the port of an Ingress is implicitly :80 for http and<br><p> 	  :443 for https.<br><p> Both these may change in the future. If the host is unspecified, the Ingress routes all traffic based on the specified IngressRuleValue. If multiple matching Hosts were provided, the first rule will take precedent.
+     */
     @JsonProperty("hosts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getHosts() {
         return hosts;
     }
 
+    /**
+     * Host is the fully qualified domain name of a network host, as defined by RFC 3986. Note the following deviations from the "host" part of the URI as defined in the RFC: 1. IPs are not allowed. Currently a rule value can only apply to the<br><p> 	  IP in the Spec of the parent .<br><p> 2. The `:` delimiter is not respected because ports are not allowed.<br><p> 	  Currently the port of an Ingress is implicitly :80 for http and<br><p> 	  :443 for https.<br><p> Both these may change in the future. If the host is unspecified, the Ingress routes all traffic based on the specified IngressRuleValue. If multiple matching Hosts were provided, the first rule will take precedent.
+     */
     @JsonProperty("hosts")
     public void setHosts(List<String> hosts) {
         this.hosts = hosts;
     }
 
+    /**
+     * IngressRule represents the rules mapping the paths under a specified host to the related backend services. Incoming requests are first evaluated for a host match, then routed to the backend associated with the matching IngressRuleValue.
+     */
     @JsonProperty("http")
     public HTTPIngressRuleValue getHttp() {
         return http;
     }
 
+    /**
+     * IngressRule represents the rules mapping the paths under a specified host to the related backend services. Incoming requests are first evaluated for a host match, then routed to the backend associated with the matching IngressRuleValue.
+     */
     @JsonProperty("http")
     public void setHttp(HTTPIngressRuleValue http) {
         this.http = http;
     }
 
+    /**
+     * Visibility signifies whether this rule should `ClusterLocal`. If it's not specified then it defaults to `ExternalIP`.
+     */
     @JsonProperty("visibility")
     public String getVisibility() {
         return visibility;
     }
 
+    /**
+     * Visibility signifies whether this rule should `ClusterLocal`. If it's not specified then it defaults to `ExternalIP`.
+     */
     @JsonProperty("visibility")
     public void setVisibility(String visibility) {
         this.visibility = visibility;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/IngressSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/IngressSpec.java
index b845a988801..5e9d9b617d1 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/IngressSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/IngressSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressSpec describes the Ingress the user wishes to exist.<br><p> <br><p> In general this follows the same shape as K8s Ingress. Some notable differences: - Backends now can have namespace: - Traffic can be split across multiple backends. - Timeout &amp; Retry can be configured. - Headers can be appended.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public IngressSpec(String httpOption, List<IngressRule> rules, List<IngressTLS>
         this.tls = tls;
     }
 
+    /**
+     * HTTPOption is the option of HTTP. It has the following two values: `HTTPOptionEnabled`, `HTTPOptionRedirected`
+     */
     @JsonProperty("httpOption")
     public String getHttpOption() {
         return httpOption;
     }
 
+    /**
+     * HTTPOption is the option of HTTP. It has the following two values: `HTTPOptionEnabled`, `HTTPOptionRedirected`
+     */
     @JsonProperty("httpOption")
     public void setHttpOption(String httpOption) {
         this.httpOption = httpOption;
     }
 
+    /**
+     * A list of host rules used to configure the Ingress.
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IngressRule> getRules() {
         return rules;
     }
 
+    /**
+     * A list of host rules used to configure the Ingress.
+     */
     @JsonProperty("rules")
     public void setRules(List<IngressRule> rules) {
         this.rules = rules;
     }
 
+    /**
+     * TLS configuration. Currently Ingress only supports a single TLS port: 443. If multiple members of this list specify different hosts, they will be multiplexed on the same port according to the hostname specified through the SNI TLS extension, if the ingress controller fulfilling the ingress supports SNI.
+     */
     @JsonProperty("tls")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IngressTLS> getTls() {
         return tls;
     }
 
+    /**
+     * TLS configuration. Currently Ingress only supports a single TLS port: 443. If multiple members of this list specify different hosts, they will be multiplexed on the same port according to the hostname specified through the SNI TLS extension, if the ingress controller fulfilling the ingress supports SNI.
+     */
     @JsonProperty("tls")
     public void setTls(List<IngressTLS> tls) {
         this.tls = tls;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/IngressStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/IngressStatus.java
index 17ecd5395f3..d0b4a5e9d0f 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/IngressStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/IngressStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressStatus describe the current state of the Ingress.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -99,53 +102,83 @@ public IngressStatus(Map<String, String> annotations, List<Condition> conditions
         this.publicLoadBalancer = publicLoadBalancer;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * IngressStatus describe the current state of the Ingress.
+     */
     @JsonProperty("privateLoadBalancer")
     public LoadBalancerStatus getPrivateLoadBalancer() {
         return privateLoadBalancer;
     }
 
+    /**
+     * IngressStatus describe the current state of the Ingress.
+     */
     @JsonProperty("privateLoadBalancer")
     public void setPrivateLoadBalancer(LoadBalancerStatus privateLoadBalancer) {
         this.privateLoadBalancer = privateLoadBalancer;
     }
 
+    /**
+     * IngressStatus describe the current state of the Ingress.
+     */
     @JsonProperty("publicLoadBalancer")
     public LoadBalancerStatus getPublicLoadBalancer() {
         return publicLoadBalancer;
     }
 
+    /**
+     * IngressStatus describe the current state of the Ingress.
+     */
     @JsonProperty("publicLoadBalancer")
     public void setPublicLoadBalancer(LoadBalancerStatus publicLoadBalancer) {
         this.publicLoadBalancer = publicLoadBalancer;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/IngressTLS.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/IngressTLS.java
index 4d1d3248ef0..ad5c5e5fad8 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/IngressTLS.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/IngressTLS.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressTLS describes the transport layer security associated with an Ingress.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public IngressTLS(List<String> hosts, String secretName, String secretNamespace)
         this.secretNamespace = secretNamespace;
     }
 
+    /**
+     * Hosts is a list of hosts included in the TLS certificate. The values in this list must match the name/s used in the tlsSecret. Defaults to the wildcard host setting for the loadbalancer controller fulfilling this Ingress, if left unspecified.
+     */
     @JsonProperty("hosts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getHosts() {
         return hosts;
     }
 
+    /**
+     * Hosts is a list of hosts included in the TLS certificate. The values in this list must match the name/s used in the tlsSecret. Defaults to the wildcard host setting for the loadbalancer controller fulfilling this Ingress, if left unspecified.
+     */
     @JsonProperty("hosts")
     public void setHosts(List<String> hosts) {
         this.hosts = hosts;
     }
 
+    /**
+     * SecretName is the name of the secret used to terminate SSL traffic.
+     */
     @JsonProperty("secretName")
     public String getSecretName() {
         return secretName;
     }
 
+    /**
+     * SecretName is the name of the secret used to terminate SSL traffic.
+     */
     @JsonProperty("secretName")
     public void setSecretName(String secretName) {
         this.secretName = secretName;
     }
 
+    /**
+     * SecretNamespace is the namespace of the secret used to terminate SSL traffic. If not set the namespace should be assumed to be the same as the Ingress. If set the secret should have the same namespace as the Ingress otherwise the behaviour is undefined and not supported.
+     */
     @JsonProperty("secretNamespace")
     public String getSecretNamespace() {
         return secretNamespace;
     }
 
+    /**
+     * SecretNamespace is the namespace of the secret used to terminate SSL traffic. If not set the namespace should be assumed to be the same as the Ingress. If set the secret should have the same namespace as the Ingress otherwise the behaviour is undefined and not supported.
+     */
     @JsonProperty("secretNamespace")
     public void setSecretNamespace(String secretNamespace) {
         this.secretNamespace = secretNamespace;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/LoadBalancerIngressStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/LoadBalancerIngressStatus.java
index 2937972e7ad..de663c2e2d1 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/LoadBalancerIngressStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/LoadBalancerIngressStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LoadBalancerIngressStatus represents the status of a load-balancer ingress point: traffic intended for the service should be sent to an ingress point.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public LoadBalancerIngressStatus(String domain, String domainInternal, String ip
         this.meshOnly = meshOnly;
     }
 
+    /**
+     * Domain is set for load-balancer ingress points that are DNS based (typically AWS load-balancers)
+     */
     @JsonProperty("domain")
     public String getDomain() {
         return domain;
     }
 
+    /**
+     * Domain is set for load-balancer ingress points that are DNS based (typically AWS load-balancers)
+     */
     @JsonProperty("domain")
     public void setDomain(String domain) {
         this.domain = domain;
     }
 
+    /**
+     * DomainInternal is set if there is a cluster-local DNS name to access the Ingress.<br><p> <br><p> NOTE: This differs from K8s Ingress, since we also desire to have a cluster-local<br><p>       DNS name to allow routing in case of not having a mesh.
+     */
     @JsonProperty("domainInternal")
     public String getDomainInternal() {
         return domainInternal;
     }
 
+    /**
+     * DomainInternal is set if there is a cluster-local DNS name to access the Ingress.<br><p> <br><p> NOTE: This differs from K8s Ingress, since we also desire to have a cluster-local<br><p>       DNS name to allow routing in case of not having a mesh.
+     */
     @JsonProperty("domainInternal")
     public void setDomainInternal(String domainInternal) {
         this.domainInternal = domainInternal;
     }
 
+    /**
+     * IP is set for load-balancer ingress points that are IP based (typically GCE or OpenStack load-balancers)
+     */
     @JsonProperty("ip")
     public String getIp() {
         return ip;
     }
 
+    /**
+     * IP is set for load-balancer ingress points that are IP based (typically GCE or OpenStack load-balancers)
+     */
     @JsonProperty("ip")
     public void setIp(String ip) {
         this.ip = ip;
     }
 
+    /**
+     * MeshOnly is set if the Ingress is only load-balanced through a Service mesh.
+     */
     @JsonProperty("meshOnly")
     public Boolean getMeshOnly() {
         return meshOnly;
     }
 
+    /**
+     * MeshOnly is set if the Ingress is only load-balanced through a Service mesh.
+     */
     @JsonProperty("meshOnly")
     public void setMeshOnly(Boolean meshOnly) {
         this.meshOnly = meshOnly;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/LoadBalancerStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/LoadBalancerStatus.java
index c6ddf095738..bca483ee044 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/LoadBalancerStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/LoadBalancerStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LoadBalancerStatus represents the status of a load-balancer.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public LoadBalancerStatus(List<LoadBalancerIngressStatus> ingress) {
         this.ingress = ingress;
     }
 
+    /**
+     * Ingress is a list containing ingress points for the load-balancer. Traffic intended for the service should be sent to these ingress points.
+     */
     @JsonProperty("ingress")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LoadBalancerIngressStatus> getIngress() {
         return ingress;
     }
 
+    /**
+     * Ingress is a list containing ingress points for the load-balancer. Traffic intended for the service should be sent to these ingress points.
+     */
     @JsonProperty("ingress")
     public void setIngress(List<LoadBalancerIngressStatus> ingress) {
         this.ingress = ingress;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/ServerlessService.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/ServerlessService.java
index 1b0927ca3c2..befeefe8c8b 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/ServerlessService.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/ServerlessService.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServerlessService is a proxy for the K8s service objects containing the endpoints for the revision, whether those are endpoints of the activator or revision pods. See: https://knative.page.link/naxz for details.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class ServerlessService implements Editable<ServerlessServiceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.internal.knative.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ServerlessService";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ServerlessService(String apiVersion, String kind, ObjectMeta metadata, Se
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ServerlessService is a proxy for the K8s service objects containing the endpoints for the revision, whether those are endpoints of the activator or revision pods. See: https://knative.page.link/naxz for details.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ServerlessService is a proxy for the K8s service objects containing the endpoints for the revision, whether those are endpoints of the activator or revision pods. See: https://knative.page.link/naxz for details.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ServerlessService is a proxy for the K8s service objects containing the endpoints for the revision, whether those are endpoints of the activator or revision pods. See: https://knative.page.link/naxz for details.
+     */
     @JsonProperty("spec")
     public ServerlessServiceSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ServerlessService is a proxy for the K8s service objects containing the endpoints for the revision, whether those are endpoints of the activator or revision pods. See: https://knative.page.link/naxz for details.
+     */
     @JsonProperty("spec")
     public void setSpec(ServerlessServiceSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ServerlessService is a proxy for the K8s service objects containing the endpoints for the revision, whether those are endpoints of the activator or revision pods. See: https://knative.page.link/naxz for details.
+     */
     @JsonProperty("status")
     public ServerlessServiceStatus getStatus() {
         return status;
     }
 
+    /**
+     * ServerlessService is a proxy for the K8s service objects containing the endpoints for the revision, whether those are endpoints of the activator or revision pods. See: https://knative.page.link/naxz for details.
+     */
     @JsonProperty("status")
     public void setStatus(ServerlessServiceStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/ServerlessServiceList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/ServerlessServiceList.java
index de4911e6179..5c33911881a 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/ServerlessServiceList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/ServerlessServiceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServerlessServiceList is a collection of ServerlessService.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ServerlessServiceList implements Editable<ServerlessServiceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.internal.networking.v1alpha1.ServerlessService>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.internal.knative.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.internal.networking.v1alpha1.ServerlessService> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ServerlessServiceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ServerlessServiceList(String apiVersion, List<io.fabric8.knative.internal
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of ServerlessService.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.internal.networking.v1alpha1.ServerlessService> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of ServerlessService.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.internal.networking.v1alpha1.ServerlessService> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ServerlessServiceList is a collection of ServerlessService.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ServerlessServiceList is a collection of ServerlessService.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/ServerlessServiceSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/ServerlessServiceSpec.java
index 06a26217ab1..e05204ab9ee 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/ServerlessServiceSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/ServerlessServiceSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServerlessServiceSpec describes the ServerlessService.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ServerlessServiceSpec(String mode, Integer numActivators, ObjectReference
         this.protocolType = protocolType;
     }
 
+    /**
+     * Mode describes the mode of operation of the ServerlessService.
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Mode describes the mode of operation of the ServerlessService.
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
     }
 
+    /**
+     * NumActivators contains number of Activators that this revision should be assigned. O means — assign all.
+     */
     @JsonProperty("numActivators")
     public Integer getNumActivators() {
         return numActivators;
     }
 
+    /**
+     * NumActivators contains number of Activators that this revision should be assigned. O means — assign all.
+     */
     @JsonProperty("numActivators")
     public void setNumActivators(Integer numActivators) {
         this.numActivators = numActivators;
     }
 
+    /**
+     * ServerlessServiceSpec describes the ServerlessService.
+     */
     @JsonProperty("objectRef")
     public ObjectReference getObjectRef() {
         return objectRef;
     }
 
+    /**
+     * ServerlessServiceSpec describes the ServerlessService.
+     */
     @JsonProperty("objectRef")
     public void setObjectRef(ObjectReference objectRef) {
         this.objectRef = objectRef;
     }
 
+    /**
+     * The application-layer protocol. Matches `RevisionProtocolType` set on the owning pa/revision. serving imports networking, so just use string.
+     */
     @JsonProperty("protocolType")
     public String getProtocolType() {
         return protocolType;
     }
 
+    /**
+     * The application-layer protocol. Matches `RevisionProtocolType` set on the owning pa/revision. serving imports networking, so just use string.
+     */
     @JsonProperty("protocolType")
     public void setProtocolType(String protocolType) {
         this.protocolType = protocolType;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/ServerlessServiceStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/ServerlessServiceStatus.java
index 8b699fccaf4..1e1694bbbf2 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/ServerlessServiceStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/internal/networking/v1alpha1/ServerlessServiceStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServerlessServiceStatus describes the current state of the ServerlessService.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -99,53 +102,83 @@ public ServerlessServiceStatus(Map<String, String> annotations, List<Condition>
         this.serviceName = serviceName;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * PrivateServiceName holds the name of a core K8s Service resource that load balances over the user service pods backing this Revision.
+     */
     @JsonProperty("privateServiceName")
     public String getPrivateServiceName() {
         return privateServiceName;
     }
 
+    /**
+     * PrivateServiceName holds the name of a core K8s Service resource that load balances over the user service pods backing this Revision.
+     */
     @JsonProperty("privateServiceName")
     public void setPrivateServiceName(String privateServiceName) {
         this.privateServiceName = privateServiceName;
     }
 
+    /**
+     * ServiceName holds the name of a core K8s Service resource that load balances over the pods backing this Revision (activator or revision).
+     */
     @JsonProperty("serviceName")
     public String getServiceName() {
         return serviceName;
     }
 
+    /**
+     * ServiceName holds the name of a core K8s Service resource that load balances over the pods backing this Revision (activator or revision).
+     */
     @JsonProperty("serviceName")
     public void setServiceName(String serviceName) {
         this.serviceName = serviceName;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/Channel.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/Channel.java
index f19adbbb68e..20f97ac5a13 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/Channel.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/Channel.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Channel represents a generic Channel. It is normally used when we want a Channel, but do not need a specific Channel implementation.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Channel implements Editable<ChannelBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "messaging.knative.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Channel";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Channel(String apiVersion, String kind, ObjectMeta metadata, ChannelSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Channel represents a generic Channel. It is normally used when we want a Channel, but do not need a specific Channel implementation.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Channel represents a generic Channel. It is normally used when we want a Channel, but do not need a specific Channel implementation.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Channel represents a generic Channel. It is normally used when we want a Channel, but do not need a specific Channel implementation.
+     */
     @JsonProperty("spec")
     public ChannelSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Channel represents a generic Channel. It is normally used when we want a Channel, but do not need a specific Channel implementation.
+     */
     @JsonProperty("spec")
     public void setSpec(ChannelSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Channel represents a generic Channel. It is normally used when we want a Channel, but do not need a specific Channel implementation.
+     */
     @JsonProperty("status")
     public ChannelStatus getStatus() {
         return status;
     }
 
+    /**
+     * Channel represents a generic Channel. It is normally used when we want a Channel, but do not need a specific Channel implementation.
+     */
     @JsonProperty("status")
     public void setStatus(ChannelStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/ChannelList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/ChannelList.java
index 3cf365b5851..aaaf2fb39e8 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/ChannelList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/ChannelList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ChannelList is a collection of Channels.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ChannelList implements Editable<ChannelListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.messaging.v1.Channel>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "messaging.knative.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.messaging.v1.Channel> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ChannelList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ChannelList(String apiVersion, List<io.fabric8.knative.messaging.v1.Chann
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ChannelList is a collection of Channels.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.messaging.v1.Channel> getItems() {
         return items;
     }
 
+    /**
+     * ChannelList is a collection of Channels.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.messaging.v1.Channel> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ChannelList is a collection of Channels.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ChannelList is a collection of Channels.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/ChannelSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/ChannelSpec.java
index 15f5f29f3b4..b62bbbc5d09 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/ChannelSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/ChannelSpec.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ChannelSpec defines which subscribers have expressed interest in receiving events from this Channel. It also defines the ChannelTemplate to use in order to create the CRD Channel backing this Channel.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,32 +94,50 @@ public ChannelSpec(ChannelTemplateSpec channelTemplate, DeliverySpec delivery, L
         this.subscribers = subscribers;
     }
 
+    /**
+     * ChannelSpec defines which subscribers have expressed interest in receiving events from this Channel. It also defines the ChannelTemplate to use in order to create the CRD Channel backing this Channel.
+     */
     @JsonProperty("channelTemplate")
     public ChannelTemplateSpec getChannelTemplate() {
         return channelTemplate;
     }
 
+    /**
+     * ChannelSpec defines which subscribers have expressed interest in receiving events from this Channel. It also defines the ChannelTemplate to use in order to create the CRD Channel backing this Channel.
+     */
     @JsonProperty("channelTemplate")
     public void setChannelTemplate(ChannelTemplateSpec channelTemplate) {
         this.channelTemplate = channelTemplate;
     }
 
+    /**
+     * ChannelSpec defines which subscribers have expressed interest in receiving events from this Channel. It also defines the ChannelTemplate to use in order to create the CRD Channel backing this Channel.
+     */
     @JsonProperty("delivery")
     public DeliverySpec getDelivery() {
         return delivery;
     }
 
+    /**
+     * ChannelSpec defines which subscribers have expressed interest in receiving events from this Channel. It also defines the ChannelTemplate to use in order to create the CRD Channel backing this Channel.
+     */
     @JsonProperty("delivery")
     public void setDelivery(DeliverySpec delivery) {
         this.delivery = delivery;
     }
 
+    /**
+     * This is the list of subscriptions for this subscribable.
+     */
     @JsonProperty("subscribers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SubscriberSpec> getSubscribers() {
         return subscribers;
     }
 
+    /**
+     * This is the list of subscriptions for this subscribable.
+     */
     @JsonProperty("subscribers")
     public void setSubscribers(List<SubscriberSpec> subscribers) {
         this.subscribers = subscribers;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/ChannelStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/ChannelStatus.java
index de5160766d9..6ae2d07015f 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/ChannelStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/ChannelStatus.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ChannelStatus represents the current state of a Channel.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -130,116 +133,182 @@ public ChannelStatus(Addressable address, List<Addressable> addresses, Map<Strin
         this.subscribers = subscribers;
     }
 
+    /**
+     * ChannelStatus represents the current state of a Channel.
+     */
     @JsonProperty("address")
     public Addressable getAddress() {
         return address;
     }
 
+    /**
+     * ChannelStatus represents the current state of a Channel.
+     */
     @JsonProperty("address")
     public void setAddress(Addressable address) {
         this.address = address;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Addressable> getAddresses() {
         return addresses;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<Addressable> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * ChannelStatus represents the current state of a Channel.
+     */
     @JsonProperty("channel")
     public KReference getChannel() {
         return channel;
     }
 
+    /**
+     * ChannelStatus represents the current state of a Channel.
+     */
     @JsonProperty("channel")
     public void setChannel(KReference channel) {
         this.channel = channel;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * DeadLetterSinkAudience is the OIDC audience of the DeadLetterSink
+     */
     @JsonProperty("deadLetterSinkAudience")
     public String getDeadLetterSinkAudience() {
         return deadLetterSinkAudience;
     }
 
+    /**
+     * DeadLetterSinkAudience is the OIDC audience of the DeadLetterSink
+     */
     @JsonProperty("deadLetterSinkAudience")
     public void setDeadLetterSinkAudience(String deadLetterSinkAudience) {
         this.deadLetterSinkAudience = deadLetterSinkAudience;
     }
 
+    /**
+     * DeadLetterSinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("deadLetterSinkCACerts")
     public String getDeadLetterSinkCACerts() {
         return deadLetterSinkCACerts;
     }
 
+    /**
+     * DeadLetterSinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("deadLetterSinkCACerts")
     public void setDeadLetterSinkCACerts(String deadLetterSinkCACerts) {
         this.deadLetterSinkCACerts = deadLetterSinkCACerts;
     }
 
+    /**
+     * ChannelStatus represents the current state of a Channel.
+     */
     @JsonProperty("deadLetterSinkUri")
     public String getDeadLetterSinkUri() {
         return deadLetterSinkUri;
     }
 
+    /**
+     * ChannelStatus represents the current state of a Channel.
+     */
     @JsonProperty("deadLetterSinkUri")
     public void setDeadLetterSinkUri(String deadLetterSinkUri) {
         this.deadLetterSinkUri = deadLetterSinkUri;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Policies holds the list of applied EventPolicies
+     */
     @JsonProperty("policies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AppliedEventPolicyRef> getPolicies() {
         return policies;
     }
 
+    /**
+     * Policies holds the list of applied EventPolicies
+     */
     @JsonProperty("policies")
     public void setPolicies(List<AppliedEventPolicyRef> policies) {
         this.policies = policies;
     }
 
+    /**
+     * This is the list of subscription's statuses for this channel.
+     */
     @JsonProperty("subscribers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SubscriberStatus> getSubscribers() {
         return subscribers;
     }
 
+    /**
+     * This is the list of subscription's statuses for this channel.
+     */
     @JsonProperty("subscribers")
     public void setSubscribers(List<SubscriberStatus> subscribers) {
         this.subscribers = subscribers;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/ChannelTemplateSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/ChannelTemplateSpec.java
index 299ed0cdee0..eea0fbfcbaa 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/ChannelTemplateSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/ChannelTemplateSpec.java
@@ -74,14 +74,8 @@
 public class ChannelTemplateSpec implements Editable<ChannelTemplateSpecBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "messaging.knative.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ChannelTemplateSpec";
     @JsonProperty("spec")
@@ -104,7 +98,7 @@ public ChannelTemplateSpec(String apiVersion, String kind, Object spec) {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -112,7 +106,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -120,7 +114,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -128,7 +122,7 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/InMemoryChannel.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/InMemoryChannel.java
index 27802a4fa59..0fcd7fcae39 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/InMemoryChannel.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/InMemoryChannel.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * InMemoryChannel is a resource representing an in memory channel
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class InMemoryChannel implements Editable<InMemoryChannelBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "messaging.knative.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "InMemoryChannel";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public InMemoryChannel(String apiVersion, String kind, ObjectMeta metadata, InMe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * InMemoryChannel is a resource representing an in memory channel
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * InMemoryChannel is a resource representing an in memory channel
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * InMemoryChannel is a resource representing an in memory channel
+     */
     @JsonProperty("spec")
     public InMemoryChannelSpec getSpec() {
         return spec;
     }
 
+    /**
+     * InMemoryChannel is a resource representing an in memory channel
+     */
     @JsonProperty("spec")
     public void setSpec(InMemoryChannelSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * InMemoryChannel is a resource representing an in memory channel
+     */
     @JsonProperty("status")
     public InMemoryChannelStatus getStatus() {
         return status;
     }
 
+    /**
+     * InMemoryChannel is a resource representing an in memory channel
+     */
     @JsonProperty("status")
     public void setStatus(InMemoryChannelStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/InMemoryChannelList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/InMemoryChannelList.java
index 6bf42340e7e..0110e4ba733 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/InMemoryChannelList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/InMemoryChannelList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * InMemoryChannelList is a collection of in-memory channels.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class InMemoryChannelList implements Editable<InMemoryChannelListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.messaging.v1.InMemoryChannel>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "messaging.knative.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.messaging.v1.InMemoryChannel> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "InMemoryChannelList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public InMemoryChannelList(String apiVersion, List<io.fabric8.knative.messaging.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * InMemoryChannelList is a collection of in-memory channels.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.messaging.v1.InMemoryChannel> getItems() {
         return items;
     }
 
+    /**
+     * InMemoryChannelList is a collection of in-memory channels.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.messaging.v1.InMemoryChannel> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * InMemoryChannelList is a collection of in-memory channels.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * InMemoryChannelList is a collection of in-memory channels.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/InMemoryChannelSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/InMemoryChannelSpec.java
index d3291904f70..1d003fd0ed8 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/InMemoryChannelSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/InMemoryChannelSpec.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * InMemoryChannelSpec defines which subscribers have expressed interest in receiving events from this InMemoryChannel. arguments for a Channel.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,22 +90,34 @@ public InMemoryChannelSpec(DeliverySpec delivery, List<SubscriberSpec> subscribe
         this.subscribers = subscribers;
     }
 
+    /**
+     * InMemoryChannelSpec defines which subscribers have expressed interest in receiving events from this InMemoryChannel. arguments for a Channel.
+     */
     @JsonProperty("delivery")
     public DeliverySpec getDelivery() {
         return delivery;
     }
 
+    /**
+     * InMemoryChannelSpec defines which subscribers have expressed interest in receiving events from this InMemoryChannel. arguments for a Channel.
+     */
     @JsonProperty("delivery")
     public void setDelivery(DeliverySpec delivery) {
         this.delivery = delivery;
     }
 
+    /**
+     * This is the list of subscriptions for this subscribable.
+     */
     @JsonProperty("subscribers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SubscriberSpec> getSubscribers() {
         return subscribers;
     }
 
+    /**
+     * This is the list of subscriptions for this subscribable.
+     */
     @JsonProperty("subscribers")
     public void setSubscribers(List<SubscriberSpec> subscribers) {
         this.subscribers = subscribers;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/InMemoryChannelStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/InMemoryChannelStatus.java
index c10bfa6531e..7b5746a9d86 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/InMemoryChannelStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/InMemoryChannelStatus.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ChannelStatus represents the current state of a Channel.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -125,106 +128,166 @@ public InMemoryChannelStatus(Addressable address, List<Addressable> addresses, M
         this.subscribers = subscribers;
     }
 
+    /**
+     * ChannelStatus represents the current state of a Channel.
+     */
     @JsonProperty("address")
     public Addressable getAddress() {
         return address;
     }
 
+    /**
+     * ChannelStatus represents the current state of a Channel.
+     */
     @JsonProperty("address")
     public void setAddress(Addressable address) {
         this.address = address;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Addressable> getAddresses() {
         return addresses;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<Addressable> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * DeadLetterSinkAudience is the OIDC audience of the DeadLetterSink
+     */
     @JsonProperty("deadLetterSinkAudience")
     public String getDeadLetterSinkAudience() {
         return deadLetterSinkAudience;
     }
 
+    /**
+     * DeadLetterSinkAudience is the OIDC audience of the DeadLetterSink
+     */
     @JsonProperty("deadLetterSinkAudience")
     public void setDeadLetterSinkAudience(String deadLetterSinkAudience) {
         this.deadLetterSinkAudience = deadLetterSinkAudience;
     }
 
+    /**
+     * DeadLetterSinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("deadLetterSinkCACerts")
     public String getDeadLetterSinkCACerts() {
         return deadLetterSinkCACerts;
     }
 
+    /**
+     * DeadLetterSinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("deadLetterSinkCACerts")
     public void setDeadLetterSinkCACerts(String deadLetterSinkCACerts) {
         this.deadLetterSinkCACerts = deadLetterSinkCACerts;
     }
 
+    /**
+     * ChannelStatus represents the current state of a Channel.
+     */
     @JsonProperty("deadLetterSinkUri")
     public String getDeadLetterSinkUri() {
         return deadLetterSinkUri;
     }
 
+    /**
+     * ChannelStatus represents the current state of a Channel.
+     */
     @JsonProperty("deadLetterSinkUri")
     public void setDeadLetterSinkUri(String deadLetterSinkUri) {
         this.deadLetterSinkUri = deadLetterSinkUri;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Policies holds the list of applied EventPolicies
+     */
     @JsonProperty("policies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AppliedEventPolicyRef> getPolicies() {
         return policies;
     }
 
+    /**
+     * Policies holds the list of applied EventPolicies
+     */
     @JsonProperty("policies")
     public void setPolicies(List<AppliedEventPolicyRef> policies) {
         this.policies = policies;
     }
 
+    /**
+     * This is the list of subscription's statuses for this channel.
+     */
     @JsonProperty("subscribers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SubscriberStatus> getSubscribers() {
         return subscribers;
     }
 
+    /**
+     * This is the list of subscription's statuses for this channel.
+     */
     @JsonProperty("subscribers")
     public void setSubscribers(List<SubscriberStatus> subscribers) {
         this.subscribers = subscribers;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/Subscription.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/Subscription.java
index c8dc2ce01ca..18a6ee045b1 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/Subscription.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/Subscription.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Subscription routes events received on a Channel to a DNS name and corresponds to the subscriptions.channels.knative.dev CRD.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Subscription implements Editable<SubscriptionBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "messaging.knative.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Subscription";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Subscription(String apiVersion, String kind, ObjectMeta metadata, Subscri
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Subscription routes events received on a Channel to a DNS name and corresponds to the subscriptions.channels.knative.dev CRD.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Subscription routes events received on a Channel to a DNS name and corresponds to the subscriptions.channels.knative.dev CRD.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Subscription routes events received on a Channel to a DNS name and corresponds to the subscriptions.channels.knative.dev CRD.
+     */
     @JsonProperty("spec")
     public SubscriptionSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Subscription routes events received on a Channel to a DNS name and corresponds to the subscriptions.channels.knative.dev CRD.
+     */
     @JsonProperty("spec")
     public void setSpec(SubscriptionSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Subscription routes events received on a Channel to a DNS name and corresponds to the subscriptions.channels.knative.dev CRD.
+     */
     @JsonProperty("status")
     public SubscriptionStatus getStatus() {
         return status;
     }
 
+    /**
+     * Subscription routes events received on a Channel to a DNS name and corresponds to the subscriptions.channels.knative.dev CRD.
+     */
     @JsonProperty("status")
     public void setStatus(SubscriptionStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/SubscriptionList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/SubscriptionList.java
index 0ca7fdafc5d..22c8b58295d 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/SubscriptionList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/SubscriptionList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubscriptionList returned in list operations
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class SubscriptionList implements Editable<SubscriptionListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.messaging.v1.Subscription>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "messaging.knative.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.messaging.v1.Subscription> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SubscriptionList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public SubscriptionList(String apiVersion, List<io.fabric8.knative.messaging.v1.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * SubscriptionList returned in list operations
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.messaging.v1.Subscription> getItems() {
         return items;
     }
 
+    /**
+     * SubscriptionList returned in list operations
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.messaging.v1.Subscription> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SubscriptionList returned in list operations
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SubscriptionList returned in list operations
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/SubscriptionSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/SubscriptionSpec.java
index 92b23b81c9d..1bdd0920e10 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/SubscriptionSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/SubscriptionSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubscriptionSpec specifies the Channel for incoming events, a Subscriber target for processing those events and where to put the result of the processing. Only From (where the events are coming from) is always required. You can optionally only Process the events (results in no output events) by leaving out the Reply. You can also perform an identity transformation on the incoming events by leaving out the Subscriber and only specifying Reply.<br><p> <br><p> The following are all valid specifications: channel --[subscriber]--&gt; reply Sink, no outgoing events: channel -- subscriber no-op function (identity transformation): channel --&gt; reply
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,41 +96,65 @@ public SubscriptionSpec(KReference channel, DeliverySpec delivery, Destination r
         this.subscriber = subscriber;
     }
 
+    /**
+     * SubscriptionSpec specifies the Channel for incoming events, a Subscriber target for processing those events and where to put the result of the processing. Only From (where the events are coming from) is always required. You can optionally only Process the events (results in no output events) by leaving out the Reply. You can also perform an identity transformation on the incoming events by leaving out the Subscriber and only specifying Reply.<br><p> <br><p> The following are all valid specifications: channel --[subscriber]--&gt; reply Sink, no outgoing events: channel -- subscriber no-op function (identity transformation): channel --&gt; reply
+     */
     @JsonProperty("channel")
     public KReference getChannel() {
         return channel;
     }
 
+    /**
+     * SubscriptionSpec specifies the Channel for incoming events, a Subscriber target for processing those events and where to put the result of the processing. Only From (where the events are coming from) is always required. You can optionally only Process the events (results in no output events) by leaving out the Reply. You can also perform an identity transformation on the incoming events by leaving out the Subscriber and only specifying Reply.<br><p> <br><p> The following are all valid specifications: channel --[subscriber]--&gt; reply Sink, no outgoing events: channel -- subscriber no-op function (identity transformation): channel --&gt; reply
+     */
     @JsonProperty("channel")
     public void setChannel(KReference channel) {
         this.channel = channel;
     }
 
+    /**
+     * SubscriptionSpec specifies the Channel for incoming events, a Subscriber target for processing those events and where to put the result of the processing. Only From (where the events are coming from) is always required. You can optionally only Process the events (results in no output events) by leaving out the Reply. You can also perform an identity transformation on the incoming events by leaving out the Subscriber and only specifying Reply.<br><p> <br><p> The following are all valid specifications: channel --[subscriber]--&gt; reply Sink, no outgoing events: channel -- subscriber no-op function (identity transformation): channel --&gt; reply
+     */
     @JsonProperty("delivery")
     public DeliverySpec getDelivery() {
         return delivery;
     }
 
+    /**
+     * SubscriptionSpec specifies the Channel for incoming events, a Subscriber target for processing those events and where to put the result of the processing. Only From (where the events are coming from) is always required. You can optionally only Process the events (results in no output events) by leaving out the Reply. You can also perform an identity transformation on the incoming events by leaving out the Subscriber and only specifying Reply.<br><p> <br><p> The following are all valid specifications: channel --[subscriber]--&gt; reply Sink, no outgoing events: channel -- subscriber no-op function (identity transformation): channel --&gt; reply
+     */
     @JsonProperty("delivery")
     public void setDelivery(DeliverySpec delivery) {
         this.delivery = delivery;
     }
 
+    /**
+     * SubscriptionSpec specifies the Channel for incoming events, a Subscriber target for processing those events and where to put the result of the processing. Only From (where the events are coming from) is always required. You can optionally only Process the events (results in no output events) by leaving out the Reply. You can also perform an identity transformation on the incoming events by leaving out the Subscriber and only specifying Reply.<br><p> <br><p> The following are all valid specifications: channel --[subscriber]--&gt; reply Sink, no outgoing events: channel -- subscriber no-op function (identity transformation): channel --&gt; reply
+     */
     @JsonProperty("reply")
     public Destination getReply() {
         return reply;
     }
 
+    /**
+     * SubscriptionSpec specifies the Channel for incoming events, a Subscriber target for processing those events and where to put the result of the processing. Only From (where the events are coming from) is always required. You can optionally only Process the events (results in no output events) by leaving out the Reply. You can also perform an identity transformation on the incoming events by leaving out the Subscriber and only specifying Reply.<br><p> <br><p> The following are all valid specifications: channel --[subscriber]--&gt; reply Sink, no outgoing events: channel -- subscriber no-op function (identity transformation): channel --&gt; reply
+     */
     @JsonProperty("reply")
     public void setReply(Destination reply) {
         this.reply = reply;
     }
 
+    /**
+     * SubscriptionSpec specifies the Channel for incoming events, a Subscriber target for processing those events and where to put the result of the processing. Only From (where the events are coming from) is always required. You can optionally only Process the events (results in no output events) by leaving out the Reply. You can also perform an identity transformation on the incoming events by leaving out the Subscriber and only specifying Reply.<br><p> <br><p> The following are all valid specifications: channel --[subscriber]--&gt; reply Sink, no outgoing events: channel -- subscriber no-op function (identity transformation): channel --&gt; reply
+     */
     @JsonProperty("subscriber")
     public Destination getSubscriber() {
         return subscriber;
     }
 
+    /**
+     * SubscriptionSpec specifies the Channel for incoming events, a Subscriber target for processing those events and where to put the result of the processing. Only From (where the events are coming from) is always required. You can optionally only Process the events (results in no output events) by leaving out the Reply. You can also perform an identity transformation on the incoming events by leaving out the Subscriber and only specifying Reply.<br><p> <br><p> The following are all valid specifications: channel --[subscriber]--&gt; reply Sink, no outgoing events: channel -- subscriber no-op function (identity transformation): channel --&gt; reply
+     */
     @JsonProperty("subscriber")
     public void setSubscriber(Destination subscriber) {
         this.subscriber = subscriber;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/SubscriptionStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/SubscriptionStatus.java
index 49ccaa97675..fa852b3154e 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/SubscriptionStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/SubscriptionStatus.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubscriptionStatus (computed) for a subscription
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -100,53 +103,83 @@ public SubscriptionStatus(Map<String, String> annotations, AuthStatus auth, List
         this.physicalSubscription = physicalSubscription;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * SubscriptionStatus (computed) for a subscription
+     */
     @JsonProperty("auth")
     public AuthStatus getAuth() {
         return auth;
     }
 
+    /**
+     * SubscriptionStatus (computed) for a subscription
+     */
     @JsonProperty("auth")
     public void setAuth(AuthStatus auth) {
         this.auth = auth;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * SubscriptionStatus (computed) for a subscription
+     */
     @JsonProperty("physicalSubscription")
     public SubscriptionStatusPhysicalSubscription getPhysicalSubscription() {
         return physicalSubscription;
     }
 
+    /**
+     * SubscriptionStatus (computed) for a subscription
+     */
     @JsonProperty("physicalSubscription")
     public void setPhysicalSubscription(SubscriptionStatusPhysicalSubscription physicalSubscription) {
         this.physicalSubscription = physicalSubscription;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/SubscriptionStatusPhysicalSubscription.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/SubscriptionStatusPhysicalSubscription.java
index 0760140c72e..e9e63b916cd 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/SubscriptionStatusPhysicalSubscription.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1/SubscriptionStatusPhysicalSubscription.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubscriptionStatusPhysicalSubscription represents the fully resolved values for this Subscription.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -110,91 +113,145 @@ public SubscriptionStatusPhysicalSubscription(String deadLetterSinkAudience, Str
         this.subscriberUri = subscriberUri;
     }
 
+    /**
+     * DeadLetterSinkAudience is the OIDC audience of the DeadLetterSink
+     */
     @JsonProperty("deadLetterSinkAudience")
     public String getDeadLetterSinkAudience() {
         return deadLetterSinkAudience;
     }
 
+    /**
+     * DeadLetterSinkAudience is the OIDC audience of the DeadLetterSink
+     */
     @JsonProperty("deadLetterSinkAudience")
     public void setDeadLetterSinkAudience(String deadLetterSinkAudience) {
         this.deadLetterSinkAudience = deadLetterSinkAudience;
     }
 
+    /**
+     * DeadLetterSinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("deadLetterSinkCACerts")
     public String getDeadLetterSinkCACerts() {
         return deadLetterSinkCACerts;
     }
 
+    /**
+     * DeadLetterSinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("deadLetterSinkCACerts")
     public void setDeadLetterSinkCACerts(String deadLetterSinkCACerts) {
         this.deadLetterSinkCACerts = deadLetterSinkCACerts;
     }
 
+    /**
+     * SubscriptionStatusPhysicalSubscription represents the fully resolved values for this Subscription.
+     */
     @JsonProperty("deadLetterSinkUri")
     public String getDeadLetterSinkUri() {
         return deadLetterSinkUri;
     }
 
+    /**
+     * SubscriptionStatusPhysicalSubscription represents the fully resolved values for this Subscription.
+     */
     @JsonProperty("deadLetterSinkUri")
     public void setDeadLetterSinkUri(String deadLetterSinkUri) {
         this.deadLetterSinkUri = deadLetterSinkUri;
     }
 
+    /**
+     * ReplyAudience is the OIDC audience for the the resolved URI for spec.reply.
+     */
     @JsonProperty("replyAudience")
     public String getReplyAudience() {
         return replyAudience;
     }
 
+    /**
+     * ReplyAudience is the OIDC audience for the the resolved URI for spec.reply.
+     */
     @JsonProperty("replyAudience")
     public void setReplyAudience(String replyAudience) {
         this.replyAudience = replyAudience;
     }
 
+    /**
+     * ReplyCACerts is the Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468 for the resolved URI for the spec.reply.
+     */
     @JsonProperty("replyCACerts")
     public String getReplyCACerts() {
         return replyCACerts;
     }
 
+    /**
+     * ReplyCACerts is the Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468 for the resolved URI for the spec.reply.
+     */
     @JsonProperty("replyCACerts")
     public void setReplyCACerts(String replyCACerts) {
         this.replyCACerts = replyCACerts;
     }
 
+    /**
+     * SubscriptionStatusPhysicalSubscription represents the fully resolved values for this Subscription.
+     */
     @JsonProperty("replyUri")
     public String getReplyUri() {
         return replyUri;
     }
 
+    /**
+     * SubscriptionStatusPhysicalSubscription represents the fully resolved values for this Subscription.
+     */
     @JsonProperty("replyUri")
     public void setReplyUri(String replyUri) {
         this.replyUri = replyUri;
     }
 
+    /**
+     * SubscriberAudience is the OIDC audience for the the resolved URI for spec.subscriber.
+     */
     @JsonProperty("subscriberAudience")
     public String getSubscriberAudience() {
         return subscriberAudience;
     }
 
+    /**
+     * SubscriberAudience is the OIDC audience for the the resolved URI for spec.subscriber.
+     */
     @JsonProperty("subscriberAudience")
     public void setSubscriberAudience(String subscriberAudience) {
         this.subscriberAudience = subscriberAudience;
     }
 
+    /**
+     * SubscriberCACerts is the Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468 for the resolved URI for spec.subscriber.
+     */
     @JsonProperty("subscriberCACerts")
     public String getSubscriberCACerts() {
         return subscriberCACerts;
     }
 
+    /**
+     * SubscriberCACerts is the Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468 for the resolved URI for spec.subscriber.
+     */
     @JsonProperty("subscriberCACerts")
     public void setSubscriberCACerts(String subscriberCACerts) {
         this.subscriberCACerts = subscriberCACerts;
     }
 
+    /**
+     * SubscriptionStatusPhysicalSubscription represents the fully resolved values for this Subscription.
+     */
     @JsonProperty("subscriberUri")
     public String getSubscriberUri() {
         return subscriberUri;
     }
 
+    /**
+     * SubscriptionStatusPhysicalSubscription represents the fully resolved values for this Subscription.
+     */
     @JsonProperty("subscriberUri")
     public void setSubscriberUri(String subscriberUri) {
         this.subscriberUri = subscriberUri;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1beta1/KafkaChannel.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1beta1/KafkaChannel.java
index e544b453143..db0a98339ca 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1beta1/KafkaChannel.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1beta1/KafkaChannel.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KafkaChannel is a resource representing a Kafka Channel.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class KafkaChannel implements Editable<KafkaChannelBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "messaging.knative.dev/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KafkaChannel";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public KafkaChannel(String apiVersion, String kind, ObjectMeta metadata, KafkaCh
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KafkaChannel is a resource representing a Kafka Channel.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KafkaChannel is a resource representing a Kafka Channel.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * KafkaChannel is a resource representing a Kafka Channel.
+     */
     @JsonProperty("spec")
     public KafkaChannelSpec getSpec() {
         return spec;
     }
 
+    /**
+     * KafkaChannel is a resource representing a Kafka Channel.
+     */
     @JsonProperty("spec")
     public void setSpec(KafkaChannelSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * KafkaChannel is a resource representing a Kafka Channel.
+     */
     @JsonProperty("status")
     public KafkaChannelStatus getStatus() {
         return status;
     }
 
+    /**
+     * KafkaChannel is a resource representing a Kafka Channel.
+     */
     @JsonProperty("status")
     public void setStatus(KafkaChannelStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1beta1/KafkaChannelList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1beta1/KafkaChannelList.java
index b9f73cfa986..4d4acaf0eff 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1beta1/KafkaChannelList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1beta1/KafkaChannelList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KafkaChannelList is a collection of KafkaChannels.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class KafkaChannelList implements Editable<KafkaChannelListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.messaging.v1beta1.KafkaChannel>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "messaging.knative.dev/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.messaging.v1beta1.KafkaChannel> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KafkaChannelList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public KafkaChannelList(String apiVersion, List<io.fabric8.knative.messaging.v1b
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * KafkaChannelList is a collection of KafkaChannels.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.messaging.v1beta1.KafkaChannel> getItems() {
         return items;
     }
 
+    /**
+     * KafkaChannelList is a collection of KafkaChannels.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.messaging.v1beta1.KafkaChannel> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KafkaChannelList is a collection of KafkaChannels.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KafkaChannelList is a collection of KafkaChannels.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1beta1/KafkaChannelSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1beta1/KafkaChannelSpec.java
index d140be80ed1..984c62cbaea 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1beta1/KafkaChannelSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1beta1/KafkaChannelSpec.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KafkaChannelSpec defines the specification for a KafkaChannel.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -99,52 +102,82 @@ public KafkaChannelSpec(DeliverySpec delivery, Integer numPartitions, Integer re
         this.subscribers = subscribers;
     }
 
+    /**
+     * KafkaChannelSpec defines the specification for a KafkaChannel.
+     */
     @JsonProperty("delivery")
     public DeliverySpec getDelivery() {
         return delivery;
     }
 
+    /**
+     * KafkaChannelSpec defines the specification for a KafkaChannel.
+     */
     @JsonProperty("delivery")
     public void setDelivery(DeliverySpec delivery) {
         this.delivery = delivery;
     }
 
+    /**
+     * NumPartitions is the number of partitions of a Kafka topic. By default, it is set to 1.
+     */
     @JsonProperty("numPartitions")
     public Integer getNumPartitions() {
         return numPartitions;
     }
 
+    /**
+     * NumPartitions is the number of partitions of a Kafka topic. By default, it is set to 1.
+     */
     @JsonProperty("numPartitions")
     public void setNumPartitions(Integer numPartitions) {
         this.numPartitions = numPartitions;
     }
 
+    /**
+     * ReplicationFactor is the replication factor of a Kafka topic. By default, it is set to 1.
+     */
     @JsonProperty("replicationFactor")
     public Integer getReplicationFactor() {
         return replicationFactor;
     }
 
+    /**
+     * ReplicationFactor is the replication factor of a Kafka topic. By default, it is set to 1.
+     */
     @JsonProperty("replicationFactor")
     public void setReplicationFactor(Integer replicationFactor) {
         this.replicationFactor = replicationFactor;
     }
 
+    /**
+     * RetentionDuration is the duration for which events will be retained in the Kafka Topic. By default, it is set to 168 hours, which is the precise form for 7 days. More information on Duration format:<br><p>  - https://www.iso.org/iso-8601-date-and-time-format.html<br><p>  - https://en.wikipedia.org/wiki/ISO_8601
+     */
     @JsonProperty("retentionDuration")
     public String getRetentionDuration() {
         return retentionDuration;
     }
 
+    /**
+     * RetentionDuration is the duration for which events will be retained in the Kafka Topic. By default, it is set to 168 hours, which is the precise form for 7 days. More information on Duration format:<br><p>  - https://www.iso.org/iso-8601-date-and-time-format.html<br><p>  - https://en.wikipedia.org/wiki/ISO_8601
+     */
     @JsonProperty("retentionDuration")
     public void setRetentionDuration(String retentionDuration) {
         this.retentionDuration = retentionDuration;
     }
 
+    /**
+     * This is the list of subscriptions for this subscribable.
+     */
     @JsonProperty("subscribers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SubscriberSpec> getSubscribers() {
         return subscribers;
     }
 
+    /**
+     * This is the list of subscriptions for this subscribable.
+     */
     @JsonProperty("subscribers")
     public void setSubscribers(List<SubscriberSpec> subscribers) {
         this.subscribers = subscribers;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1beta1/KafkaChannelStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1beta1/KafkaChannelStatus.java
index 23f33d3ed9a..3a64803983e 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1beta1/KafkaChannelStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/messaging/v1beta1/KafkaChannelStatus.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KafkaChannelStatus represents the current state of a KafkaChannel.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -125,106 +128,166 @@ public KafkaChannelStatus(Addressable address, List<Addressable> addresses, Map<
         this.subscribers = subscribers;
     }
 
+    /**
+     * KafkaChannelStatus represents the current state of a KafkaChannel.
+     */
     @JsonProperty("address")
     public Addressable getAddress() {
         return address;
     }
 
+    /**
+     * KafkaChannelStatus represents the current state of a KafkaChannel.
+     */
     @JsonProperty("address")
     public void setAddress(Addressable address) {
         this.address = address;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Addressable> getAddresses() {
         return addresses;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<Addressable> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * DeadLetterSinkAudience is the OIDC audience of the DeadLetterSink
+     */
     @JsonProperty("deadLetterSinkAudience")
     public String getDeadLetterSinkAudience() {
         return deadLetterSinkAudience;
     }
 
+    /**
+     * DeadLetterSinkAudience is the OIDC audience of the DeadLetterSink
+     */
     @JsonProperty("deadLetterSinkAudience")
     public void setDeadLetterSinkAudience(String deadLetterSinkAudience) {
         this.deadLetterSinkAudience = deadLetterSinkAudience;
     }
 
+    /**
+     * DeadLetterSinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("deadLetterSinkCACerts")
     public String getDeadLetterSinkCACerts() {
         return deadLetterSinkCACerts;
     }
 
+    /**
+     * DeadLetterSinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("deadLetterSinkCACerts")
     public void setDeadLetterSinkCACerts(String deadLetterSinkCACerts) {
         this.deadLetterSinkCACerts = deadLetterSinkCACerts;
     }
 
+    /**
+     * KafkaChannelStatus represents the current state of a KafkaChannel.
+     */
     @JsonProperty("deadLetterSinkUri")
     public String getDeadLetterSinkUri() {
         return deadLetterSinkUri;
     }
 
+    /**
+     * KafkaChannelStatus represents the current state of a KafkaChannel.
+     */
     @JsonProperty("deadLetterSinkUri")
     public void setDeadLetterSinkUri(String deadLetterSinkUri) {
         this.deadLetterSinkUri = deadLetterSinkUri;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Policies holds the list of applied EventPolicies
+     */
     @JsonProperty("policies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AppliedEventPolicyRef> getPolicies() {
         return policies;
     }
 
+    /**
+     * Policies holds the list of applied EventPolicies
+     */
     @JsonProperty("policies")
     public void setPolicies(List<AppliedEventPolicyRef> policies) {
         this.policies = policies;
     }
 
+    /**
+     * This is the list of subscription's statuses for this channel.
+     */
     @JsonProperty("subscribers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SubscriberStatus> getSubscribers() {
         return subscribers;
     }
 
+    /**
+     * This is the list of subscription's statuses for this channel.
+     */
     @JsonProperty("subscribers")
     public void setSubscribers(List<SubscriberStatus> subscribers) {
         this.subscribers = subscribers;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/pkg/apis/Condition.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/pkg/apis/Condition.java
index c67123bcf6b..5774c9fa2fa 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/pkg/apis/Condition.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/pkg/apis/Condition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Condition defines a readiness condition for a Knative resource. See: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#typical-status-properties
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public Condition(VolatileTime lastTransitionTime, String message, String reason,
         this.type = type;
     }
 
+    /**
+     * Condition defines a readiness condition for a Knative resource. See: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#typical-status-properties
+     */
     @JsonProperty("lastTransitionTime")
     public VolatileTime getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * Condition defines a readiness condition for a Knative resource. See: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#typical-status-properties
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(VolatileTime lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Severity with which to treat failures of this type of condition. When this is not specified, it defaults to Error.
+     */
     @JsonProperty("severity")
     public String getSeverity() {
         return severity;
     }
 
+    /**
+     * Severity with which to treat failures of this type of condition. When this is not specified, it defaults to Error.
+     */
     @JsonProperty("severity")
     public void setSeverity(String severity) {
         this.severity = severity;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type of condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/pkg/apis/ConditionSet.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/pkg/apis/ConditionSet.java
index 0dfc582aa3b..62ad3af9117 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/pkg/apis/ConditionSet.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/pkg/apis/ConditionSet.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConditionSet is an abstract collection of the possible ConditionType values that a particular resource might expose.  It also holds the "happy condition" for that resource, which we define to be one of Ready or Succeeded depending on whether it is a Living or Batch process respectively.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/pkg/apis/FieldError.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/pkg/apis/FieldError.java
index 580102e9ec7..1a0eba01c1b 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/pkg/apis/FieldError.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/pkg/apis/FieldError.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FieldError is used to propagate the context of errors pertaining to specific fields in a manner suitable for use in a recursive walk, so that errors contain the appropriate field context. FieldError methods are non-mutating.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public FieldError(String details, Integer level, String message, List<String> pa
         this.paths = paths;
     }
 
+    /**
+     * Details contains an optional longer payload.
+     */
     @JsonProperty("Details")
     public String getDetails() {
         return details;
     }
 
+    /**
+     * Details contains an optional longer payload.
+     */
     @JsonProperty("Details")
     public void setDetails(String details) {
         this.details = details;
     }
 
+    /**
+     * Level holds the severity of the diagnostic. If empty, this defaults to ErrorLevel.
+     */
     @JsonProperty("Level")
     public Integer getLevel() {
         return level;
     }
 
+    /**
+     * Level holds the severity of the diagnostic. If empty, this defaults to ErrorLevel.
+     */
     @JsonProperty("Level")
     public void setLevel(Integer level) {
         this.level = level;
     }
 
+    /**
+     * Message holds the main diagnostic message carried by this FieldError
+     */
     @JsonProperty("Message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message holds the main diagnostic message carried by this FieldError
+     */
     @JsonProperty("Message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Paths holds a list of paths to which this diagnostic pertains
+     */
     @JsonProperty("Paths")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPaths() {
         return paths;
     }
 
+    /**
+     * Paths holds a list of paths to which this diagnostic pertains
+     */
     @JsonProperty("Paths")
     public void setPaths(List<String> paths) {
         this.paths = paths;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/pkg/apis/VolatileTime.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/pkg/apis/VolatileTime.java
index e70b695f0d7..b5196bc2098 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/pkg/apis/VolatileTime.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/pkg/apis/VolatileTime.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolatileTime wraps metav1.Time<br><p> <br><p> Unlike metav1.Time, VolatileTimes are considered semantically equal when using kubernetes semantic equality checks. Thus differing VolatileTime values are not considered different. Note, go-cmp will still return inequality, see unit test if you need this behavior for go-cmp.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public VolatileTime(String time) {
         this.time = time;
     }
 
+    /**
+     * VolatileTime wraps metav1.Time<br><p> <br><p> Unlike metav1.Time, VolatileTimes are considered semantically equal when using kubernetes semantic equality checks. Thus differing VolatileTime values are not considered different. Note, go-cmp will still return inequality, see unit test if you need this behavior for go-cmp.
+     */
     @JsonProperty("Time")
     public String getTime() {
         return time;
     }
 
+    /**
+     * VolatileTime wraps metav1.Time<br><p> <br><p> Unlike metav1.Time, VolatileTimes are considered semantically equal when using kubernetes semantic equality checks. Thus differing VolatileTime values are not considered different. Note, go-cmp will still return inequality, see unit test if you need this behavior for go-cmp.
+     */
     @JsonProperty("Time")
     public void setTime(String time) {
         this.time = time;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/pkg/tracker/Reference.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/pkg/tracker/Reference.java
index b03ff0e2142..c7135d89621 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/pkg/tracker/Reference.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/pkg/tracker/Reference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Reference is modeled after corev1.ObjectReference, but omits fields unsupported by the tracker, and permits us to extend things in divergent ways.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public Reference(String apiVersion, String kind, String name, String namespace,
         this.selector = selector;
     }
 
+    /**
+     * API version of the referent.
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * API version of the referent.
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Kind of the referent.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind of the referent.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name of the referent. Mutually exclusive with Selector.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referent. Mutually exclusive with Selector.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace of the referent.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace of the referent.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Reference is modeled after corev1.ObjectReference, but omits fields unsupported by the tracker, and permits us to extend things in divergent ways.
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * Reference is modeled after corev1.ObjectReference, but omits fields unsupported by the tracker, and permits us to extend things in divergent ways.
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/Configuration.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/Configuration.java
index 21b94e16092..f45e8406f0f 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/Configuration.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/Configuration.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Configuration represents the "floating HEAD" of a linear history of Revisions. Users create new Revisions by updating the Configuration's spec. The "latest created" revision's name is available under status, as is the "latest ready" revision's name. See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#configuration
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Configuration implements Editable<ConfigurationBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "serving.knative.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Configuration";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Configuration(String apiVersion, String kind, ObjectMeta metadata, Config
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Configuration represents the "floating HEAD" of a linear history of Revisions. Users create new Revisions by updating the Configuration's spec. The "latest created" revision's name is available under status, as is the "latest ready" revision's name. See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#configuration
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Configuration represents the "floating HEAD" of a linear history of Revisions. Users create new Revisions by updating the Configuration's spec. The "latest created" revision's name is available under status, as is the "latest ready" revision's name. See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#configuration
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Configuration represents the "floating HEAD" of a linear history of Revisions. Users create new Revisions by updating the Configuration's spec. The "latest created" revision's name is available under status, as is the "latest ready" revision's name. See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#configuration
+     */
     @JsonProperty("spec")
     public ConfigurationSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Configuration represents the "floating HEAD" of a linear history of Revisions. Users create new Revisions by updating the Configuration's spec. The "latest created" revision's name is available under status, as is the "latest ready" revision's name. See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#configuration
+     */
     @JsonProperty("spec")
     public void setSpec(ConfigurationSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Configuration represents the "floating HEAD" of a linear history of Revisions. Users create new Revisions by updating the Configuration's spec. The "latest created" revision's name is available under status, as is the "latest ready" revision's name. See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#configuration
+     */
     @JsonProperty("status")
     public ConfigurationStatus getStatus() {
         return status;
     }
 
+    /**
+     * Configuration represents the "floating HEAD" of a linear history of Revisions. Users create new Revisions by updating the Configuration's spec. The "latest created" revision's name is available under status, as is the "latest ready" revision's name. See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#configuration
+     */
     @JsonProperty("status")
     public void setStatus(ConfigurationStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ConfigurationList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ConfigurationList.java
index fc27425f081..ee378fd3e0a 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ConfigurationList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ConfigurationList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConfigurationList is a list of Configuration resources
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ConfigurationList implements Editable<ConfigurationListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.serving.v1.Configuration>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "serving.knative.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.serving.v1.Configuration> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ConfigurationList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ConfigurationList(String apiVersion, List<io.fabric8.knative.serving.v1.C
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ConfigurationList is a list of Configuration resources
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.serving.v1.Configuration> getItems() {
         return items;
     }
 
+    /**
+     * ConfigurationList is a list of Configuration resources
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.serving.v1.Configuration> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ConfigurationList is a list of Configuration resources
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ConfigurationList is a list of Configuration resources
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ConfigurationSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ConfigurationSpec.java
index 96c619ed30b..eaf4fc2bb02 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ConfigurationSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ConfigurationSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConfigurationSpec holds the desired state of the Configuration (from the client).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ConfigurationSpec(RevisionTemplateSpec template) {
         this.template = template;
     }
 
+    /**
+     * ConfigurationSpec holds the desired state of the Configuration (from the client).
+     */
     @JsonProperty("template")
     public RevisionTemplateSpec getTemplate() {
         return template;
     }
 
+    /**
+     * ConfigurationSpec holds the desired state of the Configuration (from the client).
+     */
     @JsonProperty("template")
     public void setTemplate(RevisionTemplateSpec template) {
         this.template = template;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ConfigurationStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ConfigurationStatus.java
index a17c878cdc5..657d92936f5 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ConfigurationStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ConfigurationStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConfigurationStatus communicates the observed state of the Configuration (from the controller).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -99,53 +102,83 @@ public ConfigurationStatus(Map<String, String> annotations, List<Condition> cond
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * LatestCreatedRevisionName is the last revision that was created from this Configuration. It might not be ready yet, for that use LatestReadyRevisionName.
+     */
     @JsonProperty("latestCreatedRevisionName")
     public String getLatestCreatedRevisionName() {
         return latestCreatedRevisionName;
     }
 
+    /**
+     * LatestCreatedRevisionName is the last revision that was created from this Configuration. It might not be ready yet, for that use LatestReadyRevisionName.
+     */
     @JsonProperty("latestCreatedRevisionName")
     public void setLatestCreatedRevisionName(String latestCreatedRevisionName) {
         this.latestCreatedRevisionName = latestCreatedRevisionName;
     }
 
+    /**
+     * LatestReadyRevisionName holds the name of the latest Revision stamped out from this Configuration that has had its "Ready" condition become "True".
+     */
     @JsonProperty("latestReadyRevisionName")
     public String getLatestReadyRevisionName() {
         return latestReadyRevisionName;
     }
 
+    /**
+     * LatestReadyRevisionName holds the name of the latest Revision stamped out from this Configuration that has had its "Ready" condition become "True".
+     */
     @JsonProperty("latestReadyRevisionName")
     public void setLatestReadyRevisionName(String latestReadyRevisionName) {
         this.latestReadyRevisionName = latestReadyRevisionName;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ConfigurationStatusFields.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ConfigurationStatusFields.java
index f7a993e5345..08807ee722c 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ConfigurationStatusFields.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ConfigurationStatusFields.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConfigurationStatusFields holds the fields of Configuration's status that are not generally shared.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ConfigurationStatusFields(String latestCreatedRevisionName, String latest
         this.latestReadyRevisionName = latestReadyRevisionName;
     }
 
+    /**
+     * LatestCreatedRevisionName is the last revision that was created from this Configuration. It might not be ready yet, for that use LatestReadyRevisionName.
+     */
     @JsonProperty("latestCreatedRevisionName")
     public String getLatestCreatedRevisionName() {
         return latestCreatedRevisionName;
     }
 
+    /**
+     * LatestCreatedRevisionName is the last revision that was created from this Configuration. It might not be ready yet, for that use LatestReadyRevisionName.
+     */
     @JsonProperty("latestCreatedRevisionName")
     public void setLatestCreatedRevisionName(String latestCreatedRevisionName) {
         this.latestCreatedRevisionName = latestCreatedRevisionName;
     }
 
+    /**
+     * LatestReadyRevisionName holds the name of the latest Revision stamped out from this Configuration that has had its "Ready" condition become "True".
+     */
     @JsonProperty("latestReadyRevisionName")
     public String getLatestReadyRevisionName() {
         return latestReadyRevisionName;
     }
 
+    /**
+     * LatestReadyRevisionName holds the name of the latest Revision stamped out from this Configuration that has had its "Ready" condition become "True".
+     */
     @JsonProperty("latestReadyRevisionName")
     public void setLatestReadyRevisionName(String latestReadyRevisionName) {
         this.latestReadyRevisionName = latestReadyRevisionName;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ContainerStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ContainerStatus.java
index 4f3c3131df0..f32ff469eed 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ContainerStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ContainerStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerStatus holds the information of container name and image digest value
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ContainerStatus(String imageDigest, String name) {
         this.name = name;
     }
 
+    /**
+     * ContainerStatus holds the information of container name and image digest value
+     */
     @JsonProperty("imageDigest")
     public String getImageDigest() {
         return imageDigest;
     }
 
+    /**
+     * ContainerStatus holds the information of container name and image digest value
+     */
     @JsonProperty("imageDigest")
     public void setImageDigest(String imageDigest) {
         this.imageDigest = imageDigest;
     }
 
+    /**
+     * ContainerStatus holds the information of container name and image digest value
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * ContainerStatus holds the information of container name and image digest value
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/Revision.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/Revision.java
index ba7b3da5362..be7430c1245 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/Revision.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/Revision.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Revision is an immutable snapshot of code and configuration.  A revision references a container image. Revisions are created by updates to a Configuration.<br><p> <br><p> See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#revision
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Revision implements Editable<RevisionBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "serving.knative.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Revision";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Revision(String apiVersion, String kind, ObjectMeta metadata, RevisionSpe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Revision is an immutable snapshot of code and configuration.  A revision references a container image. Revisions are created by updates to a Configuration.<br><p> <br><p> See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#revision
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Revision is an immutable snapshot of code and configuration.  A revision references a container image. Revisions are created by updates to a Configuration.<br><p> <br><p> See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#revision
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Revision is an immutable snapshot of code and configuration.  A revision references a container image. Revisions are created by updates to a Configuration.<br><p> <br><p> See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#revision
+     */
     @JsonProperty("spec")
     public RevisionSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Revision is an immutable snapshot of code and configuration.  A revision references a container image. Revisions are created by updates to a Configuration.<br><p> <br><p> See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#revision
+     */
     @JsonProperty("spec")
     public void setSpec(RevisionSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Revision is an immutable snapshot of code and configuration.  A revision references a container image. Revisions are created by updates to a Configuration.<br><p> <br><p> See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#revision
+     */
     @JsonProperty("status")
     public RevisionStatus getStatus() {
         return status;
     }
 
+    /**
+     * Revision is an immutable snapshot of code and configuration.  A revision references a container image. Revisions are created by updates to a Configuration.<br><p> <br><p> See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#revision
+     */
     @JsonProperty("status")
     public void setStatus(RevisionStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RevisionList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RevisionList.java
index fde728302b3..7c95825c262 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RevisionList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RevisionList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RevisionList is a list of Revision resources
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class RevisionList implements Editable<RevisionListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.serving.v1.Revision>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "serving.knative.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.serving.v1.Revision> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "RevisionList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public RevisionList(String apiVersion, List<io.fabric8.knative.serving.v1.Revisi
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * RevisionList is a list of Revision resources
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.serving.v1.Revision> getItems() {
         return items;
     }
 
+    /**
+     * RevisionList is a list of Revision resources
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.serving.v1.Revision> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RevisionList is a list of Revision resources
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RevisionList is a list of Revision resources
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RevisionSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RevisionSpec.java
index 71b1b670c6f..98de1c654f4 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RevisionSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RevisionSpec.java
@@ -46,6 +46,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RevisionSpec holds the desired state of the Revision (from the client).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -273,444 +276,702 @@ public RevisionSpec(Long activeDeadlineSeconds, Affinity affinity, Boolean autom
         this.volumes = volumes;
     }
 
+    /**
+     * Optional duration in seconds the pod may be active on the node relative to StartTime before the system will actively try to mark it failed and kill associated containers. Value must be a positive integer.
+     */
     @JsonProperty("activeDeadlineSeconds")
     public Long getActiveDeadlineSeconds() {
         return activeDeadlineSeconds;
     }
 
+    /**
+     * Optional duration in seconds the pod may be active on the node relative to StartTime before the system will actively try to mark it failed and kill associated containers. Value must be a positive integer.
+     */
     @JsonProperty("activeDeadlineSeconds")
     public void setActiveDeadlineSeconds(Long activeDeadlineSeconds) {
         this.activeDeadlineSeconds = activeDeadlineSeconds;
     }
 
+    /**
+     * RevisionSpec holds the desired state of the Revision (from the client).
+     */
     @JsonProperty("affinity")
     public Affinity getAffinity() {
         return affinity;
     }
 
+    /**
+     * RevisionSpec holds the desired state of the Revision (from the client).
+     */
     @JsonProperty("affinity")
     public void setAffinity(Affinity affinity) {
         this.affinity = affinity;
     }
 
+    /**
+     * AutomountServiceAccountToken indicates whether a service account token should be automatically mounted.
+     */
     @JsonProperty("automountServiceAccountToken")
     public Boolean getAutomountServiceAccountToken() {
         return automountServiceAccountToken;
     }
 
+    /**
+     * AutomountServiceAccountToken indicates whether a service account token should be automatically mounted.
+     */
     @JsonProperty("automountServiceAccountToken")
     public void setAutomountServiceAccountToken(Boolean automountServiceAccountToken) {
         this.automountServiceAccountToken = automountServiceAccountToken;
     }
 
+    /**
+     * ContainerConcurrency specifies the maximum allowed in-flight (concurrent) requests per container of the Revision.  Defaults to `0` which means concurrency to the application is not limited, and the system decides the target concurrency for the autoscaler.
+     */
     @JsonProperty("containerConcurrency")
     public Long getContainerConcurrency() {
         return containerConcurrency;
     }
 
+    /**
+     * ContainerConcurrency specifies the maximum allowed in-flight (concurrent) requests per container of the Revision.  Defaults to `0` which means concurrency to the application is not limited, and the system decides the target concurrency for the autoscaler.
+     */
     @JsonProperty("containerConcurrency")
     public void setContainerConcurrency(Long containerConcurrency) {
         this.containerConcurrency = containerConcurrency;
     }
 
+    /**
+     * List of containers belonging to the pod. Containers cannot currently be added or removed. There must be at least one container in a Pod. Cannot be updated.
+     */
     @JsonProperty("containers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Container> getContainers() {
         return containers;
     }
 
+    /**
+     * List of containers belonging to the pod. Containers cannot currently be added or removed. There must be at least one container in a Pod. Cannot be updated.
+     */
     @JsonProperty("containers")
     public void setContainers(List<Container> containers) {
         this.containers = containers;
     }
 
+    /**
+     * RevisionSpec holds the desired state of the Revision (from the client).
+     */
     @JsonProperty("dnsConfig")
     public PodDNSConfig getDnsConfig() {
         return dnsConfig;
     }
 
+    /**
+     * RevisionSpec holds the desired state of the Revision (from the client).
+     */
     @JsonProperty("dnsConfig")
     public void setDnsConfig(PodDNSConfig dnsConfig) {
         this.dnsConfig = dnsConfig;
     }
 
+    /**
+     * Set DNS policy for the pod. Defaults to "ClusterFirst". Valid values are 'ClusterFirstWithHostNet', 'ClusterFirst', 'Default' or 'None'. DNS parameters given in DNSConfig will be merged with the policy selected with DNSPolicy. To have DNS options set along with hostNetwork, you have to specify DNS policy explicitly to 'ClusterFirstWithHostNet'.
+     */
     @JsonProperty("dnsPolicy")
     public String getDnsPolicy() {
         return dnsPolicy;
     }
 
+    /**
+     * Set DNS policy for the pod. Defaults to "ClusterFirst". Valid values are 'ClusterFirstWithHostNet', 'ClusterFirst', 'Default' or 'None'. DNS parameters given in DNSConfig will be merged with the policy selected with DNSPolicy. To have DNS options set along with hostNetwork, you have to specify DNS policy explicitly to 'ClusterFirstWithHostNet'.
+     */
     @JsonProperty("dnsPolicy")
     public void setDnsPolicy(String dnsPolicy) {
         this.dnsPolicy = dnsPolicy;
     }
 
+    /**
+     * EnableServiceLinks indicates whether information about services should be injected into pod's environment variables, matching the syntax of Docker links. Optional: Defaults to true.
+     */
     @JsonProperty("enableServiceLinks")
     public Boolean getEnableServiceLinks() {
         return enableServiceLinks;
     }
 
+    /**
+     * EnableServiceLinks indicates whether information about services should be injected into pod's environment variables, matching the syntax of Docker links. Optional: Defaults to true.
+     */
     @JsonProperty("enableServiceLinks")
     public void setEnableServiceLinks(Boolean enableServiceLinks) {
         this.enableServiceLinks = enableServiceLinks;
     }
 
+    /**
+     * List of ephemeral containers run in this pod. Ephemeral containers may be run in an existing pod to perform user-initiated actions such as debugging. This list cannot be specified when creating a pod, and it cannot be modified by updating the pod spec. In order to add an ephemeral container to an existing pod, use the pod's ephemeralcontainers subresource.
+     */
     @JsonProperty("ephemeralContainers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EphemeralContainer> getEphemeralContainers() {
         return ephemeralContainers;
     }
 
+    /**
+     * List of ephemeral containers run in this pod. Ephemeral containers may be run in an existing pod to perform user-initiated actions such as debugging. This list cannot be specified when creating a pod, and it cannot be modified by updating the pod spec. In order to add an ephemeral container to an existing pod, use the pod's ephemeralcontainers subresource.
+     */
     @JsonProperty("ephemeralContainers")
     public void setEphemeralContainers(List<EphemeralContainer> ephemeralContainers) {
         this.ephemeralContainers = ephemeralContainers;
     }
 
+    /**
+     * HostAliases is an optional list of hosts and IPs that will be injected into the pod's hosts file if specified.
+     */
     @JsonProperty("hostAliases")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HostAlias> getHostAliases() {
         return hostAliases;
     }
 
+    /**
+     * HostAliases is an optional list of hosts and IPs that will be injected into the pod's hosts file if specified.
+     */
     @JsonProperty("hostAliases")
     public void setHostAliases(List<HostAlias> hostAliases) {
         this.hostAliases = hostAliases;
     }
 
+    /**
+     * Use the host's ipc namespace. Optional: Default to false.
+     */
     @JsonProperty("hostIPC")
     public Boolean getHostIPC() {
         return hostIPC;
     }
 
+    /**
+     * Use the host's ipc namespace. Optional: Default to false.
+     */
     @JsonProperty("hostIPC")
     public void setHostIPC(Boolean hostIPC) {
         this.hostIPC = hostIPC;
     }
 
+    /**
+     * Host networking requested for this pod. Use the host's network namespace. If this option is set, the ports that will be used must be specified. Default to false.
+     */
     @JsonProperty("hostNetwork")
     public Boolean getHostNetwork() {
         return hostNetwork;
     }
 
+    /**
+     * Host networking requested for this pod. Use the host's network namespace. If this option is set, the ports that will be used must be specified. Default to false.
+     */
     @JsonProperty("hostNetwork")
     public void setHostNetwork(Boolean hostNetwork) {
         this.hostNetwork = hostNetwork;
     }
 
+    /**
+     * Use the host's pid namespace. Optional: Default to false.
+     */
     @JsonProperty("hostPID")
     public Boolean getHostPID() {
         return hostPID;
     }
 
+    /**
+     * Use the host's pid namespace. Optional: Default to false.
+     */
     @JsonProperty("hostPID")
     public void setHostPID(Boolean hostPID) {
         this.hostPID = hostPID;
     }
 
+    /**
+     * Use the host's user namespace. Optional: Default to true. If set to true or not present, the pod will be run in the host user namespace, useful for when the pod needs a feature only available to the host user namespace, such as loading a kernel module with CAP_SYS_MODULE. When set to false, a new userns is created for the pod. Setting false is useful for mitigating container breakout vulnerabilities even allowing users to run their containers as root without actually having root privileges on the host. This field is alpha-level and is only honored by servers that enable the UserNamespacesSupport feature.
+     */
     @JsonProperty("hostUsers")
     public Boolean getHostUsers() {
         return hostUsers;
     }
 
+    /**
+     * Use the host's user namespace. Optional: Default to true. If set to true or not present, the pod will be run in the host user namespace, useful for when the pod needs a feature only available to the host user namespace, such as loading a kernel module with CAP_SYS_MODULE. When set to false, a new userns is created for the pod. Setting false is useful for mitigating container breakout vulnerabilities even allowing users to run their containers as root without actually having root privileges on the host. This field is alpha-level and is only honored by servers that enable the UserNamespacesSupport feature.
+     */
     @JsonProperty("hostUsers")
     public void setHostUsers(Boolean hostUsers) {
         this.hostUsers = hostUsers;
     }
 
+    /**
+     * Specifies the hostname of the Pod If not specified, the pod's hostname will be set to a system-defined value.
+     */
     @JsonProperty("hostname")
     public String getHostname() {
         return hostname;
     }
 
+    /**
+     * Specifies the hostname of the Pod If not specified, the pod's hostname will be set to a system-defined value.
+     */
     @JsonProperty("hostname")
     public void setHostname(String hostname) {
         this.hostname = hostname;
     }
 
+    /**
+     * IdleTimeoutSeconds is the maximum duration in seconds a request will be allowed to stay open while not receiving any bytes from the user's application. If unspecified, a system default will be provided.
+     */
     @JsonProperty("idleTimeoutSeconds")
     public Long getIdleTimeoutSeconds() {
         return idleTimeoutSeconds;
     }
 
+    /**
+     * IdleTimeoutSeconds is the maximum duration in seconds a request will be allowed to stay open while not receiving any bytes from the user's application. If unspecified, a system default will be provided.
+     */
     @JsonProperty("idleTimeoutSeconds")
     public void setIdleTimeoutSeconds(Long idleTimeoutSeconds) {
         this.idleTimeoutSeconds = idleTimeoutSeconds;
     }
 
+    /**
+     * ImagePullSecrets is an optional list of references to secrets in the same namespace to use for pulling any of the images used by this PodSpec. If specified, these secrets will be passed to individual puller implementations for them to use. More info: https://kubernetes.io/docs/concepts/containers/images#specifying-imagepullsecrets-on-a-pod
+     */
     @JsonProperty("imagePullSecrets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LocalObjectReference> getImagePullSecrets() {
         return imagePullSecrets;
     }
 
+    /**
+     * ImagePullSecrets is an optional list of references to secrets in the same namespace to use for pulling any of the images used by this PodSpec. If specified, these secrets will be passed to individual puller implementations for them to use. More info: https://kubernetes.io/docs/concepts/containers/images#specifying-imagepullsecrets-on-a-pod
+     */
     @JsonProperty("imagePullSecrets")
     public void setImagePullSecrets(List<LocalObjectReference> imagePullSecrets) {
         this.imagePullSecrets = imagePullSecrets;
     }
 
+    /**
+     * List of initialization containers belonging to the pod. Init containers are executed in order prior to containers being started. If any init container fails, the pod is considered to have failed and is handled according to its restartPolicy. The name for an init container or normal container must be unique among all containers. Init containers may not have Lifecycle actions, Readiness probes, Liveness probes, or Startup probes. The resourceRequirements of an init container are taken into account during scheduling by finding the highest request/limit for each resource type, and then using the max of of that value or the sum of the normal containers. Limits are applied to init containers in a similar fashion. Init containers cannot currently be added or removed. Cannot be updated. More info: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/
+     */
     @JsonProperty("initContainers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Container> getInitContainers() {
         return initContainers;
     }
 
+    /**
+     * List of initialization containers belonging to the pod. Init containers are executed in order prior to containers being started. If any init container fails, the pod is considered to have failed and is handled according to its restartPolicy. The name for an init container or normal container must be unique among all containers. Init containers may not have Lifecycle actions, Readiness probes, Liveness probes, or Startup probes. The resourceRequirements of an init container are taken into account during scheduling by finding the highest request/limit for each resource type, and then using the max of of that value or the sum of the normal containers. Limits are applied to init containers in a similar fashion. Init containers cannot currently be added or removed. Cannot be updated. More info: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/
+     */
     @JsonProperty("initContainers")
     public void setInitContainers(List<Container> initContainers) {
         this.initContainers = initContainers;
     }
 
+    /**
+     * NodeName indicates in which node this pod is scheduled. If empty, this pod is a candidate for scheduling by the scheduler defined in schedulerName. Once this field is set, the kubelet for this node becomes responsible for the lifecycle of this pod. This field should not be used to express a desire for the pod to be scheduled on a specific node. https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/#nodename
+     */
     @JsonProperty("nodeName")
     public String getNodeName() {
         return nodeName;
     }
 
+    /**
+     * NodeName indicates in which node this pod is scheduled. If empty, this pod is a candidate for scheduling by the scheduler defined in schedulerName. Once this field is set, the kubelet for this node becomes responsible for the lifecycle of this pod. This field should not be used to express a desire for the pod to be scheduled on a specific node. https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/#nodename
+     */
     @JsonProperty("nodeName")
     public void setNodeName(String nodeName) {
         this.nodeName = nodeName;
     }
 
+    /**
+     * NodeSelector is a selector which must be true for the pod to fit on a node. Selector which must match a node's labels for the pod to be scheduled on that node. More info: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * NodeSelector is a selector which must be true for the pod to fit on a node. Selector which must match a node's labels for the pod to be scheduled on that node. More info: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * RevisionSpec holds the desired state of the Revision (from the client).
+     */
     @JsonProperty("os")
     public PodOS getOs() {
         return os;
     }
 
+    /**
+     * RevisionSpec holds the desired state of the Revision (from the client).
+     */
     @JsonProperty("os")
     public void setOs(PodOS os) {
         this.os = os;
     }
 
+    /**
+     * Overhead represents the resource overhead associated with running a pod for a given RuntimeClass. This field will be autopopulated at admission time by the RuntimeClass admission controller. If the RuntimeClass admission controller is enabled, overhead must not be set in Pod create requests. The RuntimeClass admission controller will reject Pod create requests which have the overhead already set. If RuntimeClass is configured and selected in the PodSpec, Overhead will be set to the value defined in the corresponding RuntimeClass, otherwise it will remain unset and treated as zero. More info: https://git.k8s.io/enhancements/keps/sig-node/688-pod-overhead/README.md
+     */
     @JsonProperty("overhead")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getOverhead() {
         return overhead;
     }
 
+    /**
+     * Overhead represents the resource overhead associated with running a pod for a given RuntimeClass. This field will be autopopulated at admission time by the RuntimeClass admission controller. If the RuntimeClass admission controller is enabled, overhead must not be set in Pod create requests. The RuntimeClass admission controller will reject Pod create requests which have the overhead already set. If RuntimeClass is configured and selected in the PodSpec, Overhead will be set to the value defined in the corresponding RuntimeClass, otherwise it will remain unset and treated as zero. More info: https://git.k8s.io/enhancements/keps/sig-node/688-pod-overhead/README.md
+     */
     @JsonProperty("overhead")
     public void setOverhead(Map<String, Quantity> overhead) {
         this.overhead = overhead;
     }
 
+    /**
+     * PreemptionPolicy is the Policy for preempting pods with lower priority. One of Never, PreemptLowerPriority. Defaults to PreemptLowerPriority if unset.
+     */
     @JsonProperty("preemptionPolicy")
     public String getPreemptionPolicy() {
         return preemptionPolicy;
     }
 
+    /**
+     * PreemptionPolicy is the Policy for preempting pods with lower priority. One of Never, PreemptLowerPriority. Defaults to PreemptLowerPriority if unset.
+     */
     @JsonProperty("preemptionPolicy")
     public void setPreemptionPolicy(String preemptionPolicy) {
         this.preemptionPolicy = preemptionPolicy;
     }
 
+    /**
+     * The priority value. Various system components use this field to find the priority of the pod. When Priority Admission Controller is enabled, it prevents users from setting this field. The admission controller populates this field from PriorityClassName. The higher the value, the higher the priority.
+     */
     @JsonProperty("priority")
     public Integer getPriority() {
         return priority;
     }
 
+    /**
+     * The priority value. Various system components use this field to find the priority of the pod. When Priority Admission Controller is enabled, it prevents users from setting this field. The admission controller populates this field from PriorityClassName. The higher the value, the higher the priority.
+     */
     @JsonProperty("priority")
     public void setPriority(Integer priority) {
         this.priority = priority;
     }
 
+    /**
+     * If specified, indicates the pod's priority. "system-node-critical" and "system-cluster-critical" are two special keywords which indicate the highest priorities with the former being the highest priority. Any other name must be defined by creating a PriorityClass object with that name. If not specified, the pod priority will be default or zero if there is no default.
+     */
     @JsonProperty("priorityClassName")
     public String getPriorityClassName() {
         return priorityClassName;
     }
 
+    /**
+     * If specified, indicates the pod's priority. "system-node-critical" and "system-cluster-critical" are two special keywords which indicate the highest priorities with the former being the highest priority. Any other name must be defined by creating a PriorityClass object with that name. If not specified, the pod priority will be default or zero if there is no default.
+     */
     @JsonProperty("priorityClassName")
     public void setPriorityClassName(String priorityClassName) {
         this.priorityClassName = priorityClassName;
     }
 
+    /**
+     * If specified, all readiness gates will be evaluated for pod readiness. A pod is ready when all its containers are ready AND all conditions specified in the readiness gates have status equal to "True" More info: https://git.k8s.io/enhancements/keps/sig-network/580-pod-readiness-gates
+     */
     @JsonProperty("readinessGates")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PodReadinessGate> getReadinessGates() {
         return readinessGates;
     }
 
+    /**
+     * If specified, all readiness gates will be evaluated for pod readiness. A pod is ready when all its containers are ready AND all conditions specified in the readiness gates have status equal to "True" More info: https://git.k8s.io/enhancements/keps/sig-network/580-pod-readiness-gates
+     */
     @JsonProperty("readinessGates")
     public void setReadinessGates(List<PodReadinessGate> readinessGates) {
         this.readinessGates = readinessGates;
     }
 
+    /**
+     * ResourceClaims defines which ResourceClaims must be allocated and reserved before the Pod is allowed to start. The resources will be made available to those containers which consume them by name.<br><p> <br><p> This is an alpha field and requires enabling the DynamicResourceAllocation feature gate.<br><p> <br><p> This field is immutable.
+     */
     @JsonProperty("resourceClaims")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PodResourceClaim> getResourceClaims() {
         return resourceClaims;
     }
 
+    /**
+     * ResourceClaims defines which ResourceClaims must be allocated and reserved before the Pod is allowed to start. The resources will be made available to those containers which consume them by name.<br><p> <br><p> This is an alpha field and requires enabling the DynamicResourceAllocation feature gate.<br><p> <br><p> This field is immutable.
+     */
     @JsonProperty("resourceClaims")
     public void setResourceClaims(List<PodResourceClaim> resourceClaims) {
         this.resourceClaims = resourceClaims;
     }
 
+    /**
+     * ResponseStartTimeoutSeconds is the maximum duration in seconds that the request routing layer will wait for a request delivered to a container to begin sending any network traffic.
+     */
     @JsonProperty("responseStartTimeoutSeconds")
     public Long getResponseStartTimeoutSeconds() {
         return responseStartTimeoutSeconds;
     }
 
+    /**
+     * ResponseStartTimeoutSeconds is the maximum duration in seconds that the request routing layer will wait for a request delivered to a container to begin sending any network traffic.
+     */
     @JsonProperty("responseStartTimeoutSeconds")
     public void setResponseStartTimeoutSeconds(Long responseStartTimeoutSeconds) {
         this.responseStartTimeoutSeconds = responseStartTimeoutSeconds;
     }
 
+    /**
+     * Restart policy for all containers within the pod. One of Always, OnFailure, Never. In some contexts, only a subset of those values may be permitted. Default to Always. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#restart-policy
+     */
     @JsonProperty("restartPolicy")
     public String getRestartPolicy() {
         return restartPolicy;
     }
 
+    /**
+     * Restart policy for all containers within the pod. One of Always, OnFailure, Never. In some contexts, only a subset of those values may be permitted. Default to Always. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#restart-policy
+     */
     @JsonProperty("restartPolicy")
     public void setRestartPolicy(String restartPolicy) {
         this.restartPolicy = restartPolicy;
     }
 
+    /**
+     * RuntimeClassName refers to a RuntimeClass object in the node.k8s.io group, which should be used to run this pod.  If no RuntimeClass resource matches the named class, the pod will not be run. If unset or empty, the "legacy" RuntimeClass will be used, which is an implicit class with an empty definition that uses the default runtime handler. More info: https://git.k8s.io/enhancements/keps/sig-node/585-runtime-class
+     */
     @JsonProperty("runtimeClassName")
     public String getRuntimeClassName() {
         return runtimeClassName;
     }
 
+    /**
+     * RuntimeClassName refers to a RuntimeClass object in the node.k8s.io group, which should be used to run this pod.  If no RuntimeClass resource matches the named class, the pod will not be run. If unset or empty, the "legacy" RuntimeClass will be used, which is an implicit class with an empty definition that uses the default runtime handler. More info: https://git.k8s.io/enhancements/keps/sig-node/585-runtime-class
+     */
     @JsonProperty("runtimeClassName")
     public void setRuntimeClassName(String runtimeClassName) {
         this.runtimeClassName = runtimeClassName;
     }
 
+    /**
+     * If specified, the pod will be dispatched by specified scheduler. If not specified, the pod will be dispatched by default scheduler.
+     */
     @JsonProperty("schedulerName")
     public String getSchedulerName() {
         return schedulerName;
     }
 
+    /**
+     * If specified, the pod will be dispatched by specified scheduler. If not specified, the pod will be dispatched by default scheduler.
+     */
     @JsonProperty("schedulerName")
     public void setSchedulerName(String schedulerName) {
         this.schedulerName = schedulerName;
     }
 
+    /**
+     * SchedulingGates is an opaque list of values that if specified will block scheduling the pod. If schedulingGates is not empty, the pod will stay in the SchedulingGated state and the scheduler will not attempt to schedule the pod.<br><p> <br><p> SchedulingGates can only be set at pod creation time, and be removed only afterwards.
+     */
     @JsonProperty("schedulingGates")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PodSchedulingGate> getSchedulingGates() {
         return schedulingGates;
     }
 
+    /**
+     * SchedulingGates is an opaque list of values that if specified will block scheduling the pod. If schedulingGates is not empty, the pod will stay in the SchedulingGated state and the scheduler will not attempt to schedule the pod.<br><p> <br><p> SchedulingGates can only be set at pod creation time, and be removed only afterwards.
+     */
     @JsonProperty("schedulingGates")
     public void setSchedulingGates(List<PodSchedulingGate> schedulingGates) {
         this.schedulingGates = schedulingGates;
     }
 
+    /**
+     * RevisionSpec holds the desired state of the Revision (from the client).
+     */
     @JsonProperty("securityContext")
     public PodSecurityContext getSecurityContext() {
         return securityContext;
     }
 
+    /**
+     * RevisionSpec holds the desired state of the Revision (from the client).
+     */
     @JsonProperty("securityContext")
     public void setSecurityContext(PodSecurityContext securityContext) {
         this.securityContext = securityContext;
     }
 
+    /**
+     * DeprecatedServiceAccount is a deprecated alias for ServiceAccountName. Deprecated: Use serviceAccountName instead.
+     */
     @JsonProperty("serviceAccount")
     public String getServiceAccount() {
         return serviceAccount;
     }
 
+    /**
+     * DeprecatedServiceAccount is a deprecated alias for ServiceAccountName. Deprecated: Use serviceAccountName instead.
+     */
     @JsonProperty("serviceAccount")
     public void setServiceAccount(String serviceAccount) {
         this.serviceAccount = serviceAccount;
     }
 
+    /**
+     * ServiceAccountName is the name of the ServiceAccount to use to run this pod. More info: https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * ServiceAccountName is the name of the ServiceAccount to use to run this pod. More info: https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * If true the pod's hostname will be configured as the pod's FQDN, rather than the leaf name (the default). In Linux containers, this means setting the FQDN in the hostname field of the kernel (the nodename field of struct utsname). In Windows containers, this means setting the registry value of hostname for the registry key HKEY_LOCAL_MACHINE\\SYSTEM\\CurrentControlSet\\Services\\Tcpip\\Parameters to FQDN. If a pod does not have FQDN, this has no effect. Default to false.
+     */
     @JsonProperty("setHostnameAsFQDN")
     public Boolean getSetHostnameAsFQDN() {
         return setHostnameAsFQDN;
     }
 
+    /**
+     * If true the pod's hostname will be configured as the pod's FQDN, rather than the leaf name (the default). In Linux containers, this means setting the FQDN in the hostname field of the kernel (the nodename field of struct utsname). In Windows containers, this means setting the registry value of hostname for the registry key HKEY_LOCAL_MACHINE\\SYSTEM\\CurrentControlSet\\Services\\Tcpip\\Parameters to FQDN. If a pod does not have FQDN, this has no effect. Default to false.
+     */
     @JsonProperty("setHostnameAsFQDN")
     public void setSetHostnameAsFQDN(Boolean setHostnameAsFQDN) {
         this.setHostnameAsFQDN = setHostnameAsFQDN;
     }
 
+    /**
+     * Share a single process namespace between all of the containers in a pod. When this is set containers will be able to view and signal processes from other containers in the same pod, and the first process in each container will not be assigned PID 1. HostPID and ShareProcessNamespace cannot both be set. Optional: Default to false.
+     */
     @JsonProperty("shareProcessNamespace")
     public Boolean getShareProcessNamespace() {
         return shareProcessNamespace;
     }
 
+    /**
+     * Share a single process namespace between all of the containers in a pod. When this is set containers will be able to view and signal processes from other containers in the same pod, and the first process in each container will not be assigned PID 1. HostPID and ShareProcessNamespace cannot both be set. Optional: Default to false.
+     */
     @JsonProperty("shareProcessNamespace")
     public void setShareProcessNamespace(Boolean shareProcessNamespace) {
         this.shareProcessNamespace = shareProcessNamespace;
     }
 
+    /**
+     * If specified, the fully qualified Pod hostname will be "&lt;hostname&gt;.&lt;subdomain&gt;.&lt;pod namespace&gt;.svc.&lt;cluster domain&gt;". If not specified, the pod will not have a domainname at all.
+     */
     @JsonProperty("subdomain")
     public String getSubdomain() {
         return subdomain;
     }
 
+    /**
+     * If specified, the fully qualified Pod hostname will be "&lt;hostname&gt;.&lt;subdomain&gt;.&lt;pod namespace&gt;.svc.&lt;cluster domain&gt;". If not specified, the pod will not have a domainname at all.
+     */
     @JsonProperty("subdomain")
     public void setSubdomain(String subdomain) {
         this.subdomain = subdomain;
     }
 
+    /**
+     * Optional duration in seconds the pod needs to terminate gracefully. May be decreased in delete request. Value must be non-negative integer. The value zero indicates stop immediately via the kill signal (no opportunity to shut down). If this value is nil, the default grace period will be used instead. The grace period is the duration in seconds after the processes running in the pod are sent a termination signal and the time when the processes are forcibly halted with a kill signal. Set this value longer than the expected cleanup time for your process. Defaults to 30 seconds.
+     */
     @JsonProperty("terminationGracePeriodSeconds")
     public Long getTerminationGracePeriodSeconds() {
         return terminationGracePeriodSeconds;
     }
 
+    /**
+     * Optional duration in seconds the pod needs to terminate gracefully. May be decreased in delete request. Value must be non-negative integer. The value zero indicates stop immediately via the kill signal (no opportunity to shut down). If this value is nil, the default grace period will be used instead. The grace period is the duration in seconds after the processes running in the pod are sent a termination signal and the time when the processes are forcibly halted with a kill signal. Set this value longer than the expected cleanup time for your process. Defaults to 30 seconds.
+     */
     @JsonProperty("terminationGracePeriodSeconds")
     public void setTerminationGracePeriodSeconds(Long terminationGracePeriodSeconds) {
         this.terminationGracePeriodSeconds = terminationGracePeriodSeconds;
     }
 
+    /**
+     * TimeoutSeconds is the maximum duration in seconds that the request instance is allowed to respond to a request. If unspecified, a system default will be provided.
+     */
     @JsonProperty("timeoutSeconds")
     public Long getTimeoutSeconds() {
         return timeoutSeconds;
     }
 
+    /**
+     * TimeoutSeconds is the maximum duration in seconds that the request instance is allowed to respond to a request. If unspecified, a system default will be provided.
+     */
     @JsonProperty("timeoutSeconds")
     public void setTimeoutSeconds(Long timeoutSeconds) {
         this.timeoutSeconds = timeoutSeconds;
     }
 
+    /**
+     * If specified, the pod's tolerations.
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * If specified, the pod's tolerations.
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
     }
 
+    /**
+     * TopologySpreadConstraints describes how a group of pods ought to spread across topology domains. Scheduler will schedule pods in a way which abides by the constraints. All topologySpreadConstraints are ANDed.
+     */
     @JsonProperty("topologySpreadConstraints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TopologySpreadConstraint> getTopologySpreadConstraints() {
         return topologySpreadConstraints;
     }
 
+    /**
+     * TopologySpreadConstraints describes how a group of pods ought to spread across topology domains. Scheduler will schedule pods in a way which abides by the constraints. All topologySpreadConstraints are ANDed.
+     */
     @JsonProperty("topologySpreadConstraints")
     public void setTopologySpreadConstraints(List<TopologySpreadConstraint> topologySpreadConstraints) {
         this.topologySpreadConstraints = topologySpreadConstraints;
     }
 
+    /**
+     * List of volumes that can be mounted by containers belonging to the pod. More info: https://kubernetes.io/docs/concepts/storage/volumes
+     */
     @JsonProperty("volumes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Volume> getVolumes() {
         return volumes;
     }
 
+    /**
+     * List of volumes that can be mounted by containers belonging to the pod. More info: https://kubernetes.io/docs/concepts/storage/volumes
+     */
     @JsonProperty("volumes")
     public void setVolumes(List<Volume> volumes) {
         this.volumes = volumes;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RevisionStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RevisionStatus.java
index 7b4d00e0e45..5a6ec96d694 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RevisionStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RevisionStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RevisionStatus communicates the observed state of the Revision (from the controller).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -113,85 +116,133 @@ public RevisionStatus(Integer actualReplicas, Map<String, String> annotations, L
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * ActualReplicas reflects the amount of ready pods running this revision.
+     */
     @JsonProperty("actualReplicas")
     public Integer getActualReplicas() {
         return actualReplicas;
     }
 
+    /**
+     * ActualReplicas reflects the amount of ready pods running this revision.
+     */
     @JsonProperty("actualReplicas")
     public void setActualReplicas(Integer actualReplicas) {
         this.actualReplicas = actualReplicas;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ContainerStatuses is a slice of images present in .Spec.Container[&#42;].Image to their respective digests and their container name. The digests are resolved during the creation of Revision. ContainerStatuses holds the container name and image digests for both serving and non serving containers. ref: http://bit.ly/image-digests
+     */
     @JsonProperty("containerStatuses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ContainerStatus> getContainerStatuses() {
         return containerStatuses;
     }
 
+    /**
+     * ContainerStatuses is a slice of images present in .Spec.Container[&#42;].Image to their respective digests and their container name. The digests are resolved during the creation of Revision. ContainerStatuses holds the container name and image digests for both serving and non serving containers. ref: http://bit.ly/image-digests
+     */
     @JsonProperty("containerStatuses")
     public void setContainerStatuses(List<ContainerStatus> containerStatuses) {
         this.containerStatuses = containerStatuses;
     }
 
+    /**
+     * DesiredReplicas reflects the desired amount of pods running this revision.
+     */
     @JsonProperty("desiredReplicas")
     public Integer getDesiredReplicas() {
         return desiredReplicas;
     }
 
+    /**
+     * DesiredReplicas reflects the desired amount of pods running this revision.
+     */
     @JsonProperty("desiredReplicas")
     public void setDesiredReplicas(Integer desiredReplicas) {
         this.desiredReplicas = desiredReplicas;
     }
 
+    /**
+     * InitContainerStatuses is a slice of images present in .Spec.InitContainer[&#42;].Image to their respective digests and their container name. The digests are resolved during the creation of Revision. ContainerStatuses holds the container name and image digests for both serving and non serving containers. ref: http://bit.ly/image-digests
+     */
     @JsonProperty("initContainerStatuses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ContainerStatus> getInitContainerStatuses() {
         return initContainerStatuses;
     }
 
+    /**
+     * InitContainerStatuses is a slice of images present in .Spec.InitContainer[&#42;].Image to their respective digests and their container name. The digests are resolved during the creation of Revision. ContainerStatuses holds the container name and image digests for both serving and non serving containers. ref: http://bit.ly/image-digests
+     */
     @JsonProperty("initContainerStatuses")
     public void setInitContainerStatuses(List<ContainerStatus> initContainerStatuses) {
         this.initContainerStatuses = initContainerStatuses;
     }
 
+    /**
+     * LogURL specifies the generated logging url for this particular revision based on the revision url template specified in the controller's config.
+     */
     @JsonProperty("logUrl")
     public String getLogUrl() {
         return logUrl;
     }
 
+    /**
+     * LogURL specifies the generated logging url for this particular revision based on the revision url template specified in the controller's config.
+     */
     @JsonProperty("logUrl")
     public void setLogUrl(String logUrl) {
         this.logUrl = logUrl;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RevisionTemplateSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RevisionTemplateSpec.java
index 1e624581cbe..4802829623d 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RevisionTemplateSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RevisionTemplateSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RevisionTemplateSpec describes the data a revision should have when created from a template. Based on: https://github.com/kubernetes/api/blob/e771f807/core/v1/types.go#L3179-L3190
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public RevisionTemplateSpec(ObjectMeta metadata, RevisionSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * RevisionTemplateSpec describes the data a revision should have when created from a template. Based on: https://github.com/kubernetes/api/blob/e771f807/core/v1/types.go#L3179-L3190
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RevisionTemplateSpec describes the data a revision should have when created from a template. Based on: https://github.com/kubernetes/api/blob/e771f807/core/v1/types.go#L3179-L3190
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * RevisionTemplateSpec describes the data a revision should have when created from a template. Based on: https://github.com/kubernetes/api/blob/e771f807/core/v1/types.go#L3179-L3190
+     */
     @JsonProperty("spec")
     public RevisionSpec getSpec() {
         return spec;
     }
 
+    /**
+     * RevisionTemplateSpec describes the data a revision should have when created from a template. Based on: https://github.com/kubernetes/api/blob/e771f807/core/v1/types.go#L3179-L3190
+     */
     @JsonProperty("spec")
     public void setSpec(RevisionSpec spec) {
         this.spec = spec;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/Route.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/Route.java
index 2bb838cc37f..ed5c96e2402 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/Route.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/Route.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Route is responsible for configuring ingress over a collection of Revisions. Some of the Revisions a Route distributes traffic over may be specified by referencing the Configuration responsible for creating them; in these cases the Route is additionally responsible for monitoring the Configuration for "latest ready revision" changes, and smoothly rolling out latest revisions. See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#route
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Route implements Editable<RouteBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "serving.knative.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Route";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Route(String apiVersion, String kind, ObjectMeta metadata, RouteSpec spec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Route is responsible for configuring ingress over a collection of Revisions. Some of the Revisions a Route distributes traffic over may be specified by referencing the Configuration responsible for creating them; in these cases the Route is additionally responsible for monitoring the Configuration for "latest ready revision" changes, and smoothly rolling out latest revisions. See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#route
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Route is responsible for configuring ingress over a collection of Revisions. Some of the Revisions a Route distributes traffic over may be specified by referencing the Configuration responsible for creating them; in these cases the Route is additionally responsible for monitoring the Configuration for "latest ready revision" changes, and smoothly rolling out latest revisions. See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#route
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Route is responsible for configuring ingress over a collection of Revisions. Some of the Revisions a Route distributes traffic over may be specified by referencing the Configuration responsible for creating them; in these cases the Route is additionally responsible for monitoring the Configuration for "latest ready revision" changes, and smoothly rolling out latest revisions. See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#route
+     */
     @JsonProperty("spec")
     public RouteSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Route is responsible for configuring ingress over a collection of Revisions. Some of the Revisions a Route distributes traffic over may be specified by referencing the Configuration responsible for creating them; in these cases the Route is additionally responsible for monitoring the Configuration for "latest ready revision" changes, and smoothly rolling out latest revisions. See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#route
+     */
     @JsonProperty("spec")
     public void setSpec(RouteSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Route is responsible for configuring ingress over a collection of Revisions. Some of the Revisions a Route distributes traffic over may be specified by referencing the Configuration responsible for creating them; in these cases the Route is additionally responsible for monitoring the Configuration for "latest ready revision" changes, and smoothly rolling out latest revisions. See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#route
+     */
     @JsonProperty("status")
     public RouteStatus getStatus() {
         return status;
     }
 
+    /**
+     * Route is responsible for configuring ingress over a collection of Revisions. Some of the Revisions a Route distributes traffic over may be specified by referencing the Configuration responsible for creating them; in these cases the Route is additionally responsible for monitoring the Configuration for "latest ready revision" changes, and smoothly rolling out latest revisions. See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#route
+     */
     @JsonProperty("status")
     public void setStatus(RouteStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RouteList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RouteList.java
index 99ee0cb873c..649bf8d6992 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RouteList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RouteList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RouteList is a list of Route resources
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class RouteList implements Editable<RouteListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.serving.v1.Route>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "serving.knative.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.serving.v1.Route> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "RouteList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public RouteList(String apiVersion, List<io.fabric8.knative.serving.v1.Route> it
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * RouteList is a list of Route resources
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.serving.v1.Route> getItems() {
         return items;
     }
 
+    /**
+     * RouteList is a list of Route resources
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.serving.v1.Route> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RouteList is a list of Route resources
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RouteList is a list of Route resources
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RouteSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RouteSpec.java
index 867e3049a40..e038c454b6f 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RouteSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RouteSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RouteSpec holds the desired state of the Route (from the client).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public RouteSpec(List<TrafficTarget> traffic) {
         this.traffic = traffic;
     }
 
+    /**
+     * Traffic specifies how to distribute traffic over a collection of revisions and configurations.
+     */
     @JsonProperty("traffic")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TrafficTarget> getTraffic() {
         return traffic;
     }
 
+    /**
+     * Traffic specifies how to distribute traffic over a collection of revisions and configurations.
+     */
     @JsonProperty("traffic")
     public void setTraffic(List<TrafficTarget> traffic) {
         this.traffic = traffic;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RouteStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RouteStatus.java
index 9806716aea4..b70347cfe57 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RouteStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RouteStatus.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RouteStatus communicates the observed state of the Route (from the controller).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -105,64 +108,100 @@ public RouteStatus(Addressable address, Map<String, String> annotations, List<Co
         this.url = url;
     }
 
+    /**
+     * RouteStatus communicates the observed state of the Route (from the controller).
+     */
     @JsonProperty("address")
     public Addressable getAddress() {
         return address;
     }
 
+    /**
+     * RouteStatus communicates the observed state of the Route (from the controller).
+     */
     @JsonProperty("address")
     public void setAddress(Addressable address) {
         this.address = address;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Traffic holds the configured traffic distribution. These entries will always contain RevisionName references. When ConfigurationName appears in the spec, this will hold the LatestReadyRevisionName that we last observed.
+     */
     @JsonProperty("traffic")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TrafficTarget> getTraffic() {
         return traffic;
     }
 
+    /**
+     * Traffic holds the configured traffic distribution. These entries will always contain RevisionName references. When ConfigurationName appears in the spec, this will hold the LatestReadyRevisionName that we last observed.
+     */
     @JsonProperty("traffic")
     public void setTraffic(List<TrafficTarget> traffic) {
         this.traffic = traffic;
     }
 
+    /**
+     * RouteStatus communicates the observed state of the Route (from the controller).
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * RouteStatus communicates the observed state of the Route (from the controller).
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RouteStatusFields.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RouteStatusFields.java
index 28d67763382..076a086157e 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RouteStatusFields.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/RouteStatusFields.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RouteStatusFields holds the fields of Route's status that are not generally shared.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,32 +93,50 @@ public RouteStatusFields(Addressable address, List<TrafficTarget> traffic, Strin
         this.url = url;
     }
 
+    /**
+     * RouteStatusFields holds the fields of Route's status that are not generally shared.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("address")
     public Addressable getAddress() {
         return address;
     }
 
+    /**
+     * RouteStatusFields holds the fields of Route's status that are not generally shared.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("address")
     public void setAddress(Addressable address) {
         this.address = address;
     }
 
+    /**
+     * Traffic holds the configured traffic distribution. These entries will always contain RevisionName references. When ConfigurationName appears in the spec, this will hold the LatestReadyRevisionName that we last observed.
+     */
     @JsonProperty("traffic")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TrafficTarget> getTraffic() {
         return traffic;
     }
 
+    /**
+     * Traffic holds the configured traffic distribution. These entries will always contain RevisionName references. When ConfigurationName appears in the spec, this will hold the LatestReadyRevisionName that we last observed.
+     */
     @JsonProperty("traffic")
     public void setTraffic(List<TrafficTarget> traffic) {
         this.traffic = traffic;
     }
 
+    /**
+     * RouteStatusFields holds the fields of Route's status that are not generally shared.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * RouteStatusFields holds the fields of Route's status that are not generally shared.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/Service.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/Service.java
index e09e4bd0a3f..6c8134d3c2f 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/Service.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/Service.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Service acts as a top-level container that manages a Route and Configuration which implement a network service. Service exists to provide a singular abstraction which can be access controlled, reasoned about, and which encapsulates software lifecycle decisions such as rollout policy and team resource ownership. Service acts only as an orchestrator of the underlying Routes and Configurations (much as a kubernetes Deployment orchestrates ReplicaSets), and its usage is optional but recommended.<br><p> <br><p> The Service's controller will track the statuses of its owned Configuration and Route, reflecting their statuses and conditions as its own.<br><p> <br><p> See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#service
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Service implements Editable<ServiceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "serving.knative.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Service";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Service(String apiVersion, String kind, ObjectMeta metadata, ServiceSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Service acts as a top-level container that manages a Route and Configuration which implement a network service. Service exists to provide a singular abstraction which can be access controlled, reasoned about, and which encapsulates software lifecycle decisions such as rollout policy and team resource ownership. Service acts only as an orchestrator of the underlying Routes and Configurations (much as a kubernetes Deployment orchestrates ReplicaSets), and its usage is optional but recommended.<br><p> <br><p> The Service's controller will track the statuses of its owned Configuration and Route, reflecting their statuses and conditions as its own.<br><p> <br><p> See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#service
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Service acts as a top-level container that manages a Route and Configuration which implement a network service. Service exists to provide a singular abstraction which can be access controlled, reasoned about, and which encapsulates software lifecycle decisions such as rollout policy and team resource ownership. Service acts only as an orchestrator of the underlying Routes and Configurations (much as a kubernetes Deployment orchestrates ReplicaSets), and its usage is optional but recommended.<br><p> <br><p> The Service's controller will track the statuses of its owned Configuration and Route, reflecting their statuses and conditions as its own.<br><p> <br><p> See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#service
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Service acts as a top-level container that manages a Route and Configuration which implement a network service. Service exists to provide a singular abstraction which can be access controlled, reasoned about, and which encapsulates software lifecycle decisions such as rollout policy and team resource ownership. Service acts only as an orchestrator of the underlying Routes and Configurations (much as a kubernetes Deployment orchestrates ReplicaSets), and its usage is optional but recommended.<br><p> <br><p> The Service's controller will track the statuses of its owned Configuration and Route, reflecting their statuses and conditions as its own.<br><p> <br><p> See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#service
+     */
     @JsonProperty("spec")
     public ServiceSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Service acts as a top-level container that manages a Route and Configuration which implement a network service. Service exists to provide a singular abstraction which can be access controlled, reasoned about, and which encapsulates software lifecycle decisions such as rollout policy and team resource ownership. Service acts only as an orchestrator of the underlying Routes and Configurations (much as a kubernetes Deployment orchestrates ReplicaSets), and its usage is optional but recommended.<br><p> <br><p> The Service's controller will track the statuses of its owned Configuration and Route, reflecting their statuses and conditions as its own.<br><p> <br><p> See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#service
+     */
     @JsonProperty("spec")
     public void setSpec(ServiceSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Service acts as a top-level container that manages a Route and Configuration which implement a network service. Service exists to provide a singular abstraction which can be access controlled, reasoned about, and which encapsulates software lifecycle decisions such as rollout policy and team resource ownership. Service acts only as an orchestrator of the underlying Routes and Configurations (much as a kubernetes Deployment orchestrates ReplicaSets), and its usage is optional but recommended.<br><p> <br><p> The Service's controller will track the statuses of its owned Configuration and Route, reflecting their statuses and conditions as its own.<br><p> <br><p> See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#service
+     */
     @JsonProperty("status")
     public ServiceStatus getStatus() {
         return status;
     }
 
+    /**
+     * Service acts as a top-level container that manages a Route and Configuration which implement a network service. Service exists to provide a singular abstraction which can be access controlled, reasoned about, and which encapsulates software lifecycle decisions such as rollout policy and team resource ownership. Service acts only as an orchestrator of the underlying Routes and Configurations (much as a kubernetes Deployment orchestrates ReplicaSets), and its usage is optional but recommended.<br><p> <br><p> The Service's controller will track the statuses of its owned Configuration and Route, reflecting their statuses and conditions as its own.<br><p> <br><p> See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#service
+     */
     @JsonProperty("status")
     public void setStatus(ServiceStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ServiceList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ServiceList.java
index 6e7e9d1dbfb..56483cf04ec 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ServiceList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ServiceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceList is a list of Service resources
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ServiceList implements Editable<ServiceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.serving.v1.Service>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "serving.knative.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.serving.v1.Service> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ServiceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ServiceList(String apiVersion, List<io.fabric8.knative.serving.v1.Service
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ServiceList is a list of Service resources
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.serving.v1.Service> getItems() {
         return items;
     }
 
+    /**
+     * ServiceList is a list of Service resources
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.serving.v1.Service> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ServiceList is a list of Service resources
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ServiceList is a list of Service resources
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ServiceSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ServiceSpec.java
index 04830cce435..0db94499fab 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ServiceSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ServiceSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceSpec represents the configuration for the Service object. A Service's specification is the union of the specifications for a Route and Configuration.  The Service restricts what can be expressed in these fields, e.g. the Route must reference the provided Configuration; however, these limitations also enable friendlier defaulting, e.g. Route never needs a Configuration name, and may be defaulted to the appropriate "run latest" spec.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public ServiceSpec(RevisionTemplateSpec template, List<TrafficTarget> traffic) {
         this.traffic = traffic;
     }
 
+    /**
+     * ServiceSpec represents the configuration for the Service object. A Service's specification is the union of the specifications for a Route and Configuration.  The Service restricts what can be expressed in these fields, e.g. the Route must reference the provided Configuration; however, these limitations also enable friendlier defaulting, e.g. Route never needs a Configuration name, and may be defaulted to the appropriate "run latest" spec.
+     */
     @JsonProperty("template")
     public RevisionTemplateSpec getTemplate() {
         return template;
     }
 
+    /**
+     * ServiceSpec represents the configuration for the Service object. A Service's specification is the union of the specifications for a Route and Configuration.  The Service restricts what can be expressed in these fields, e.g. the Route must reference the provided Configuration; however, these limitations also enable friendlier defaulting, e.g. Route never needs a Configuration name, and may be defaulted to the appropriate "run latest" spec.
+     */
     @JsonProperty("template")
     public void setTemplate(RevisionTemplateSpec template) {
         this.template = template;
     }
 
+    /**
+     * Traffic specifies how to distribute traffic over a collection of revisions and configurations.
+     */
     @JsonProperty("traffic")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TrafficTarget> getTraffic() {
         return traffic;
     }
 
+    /**
+     * Traffic specifies how to distribute traffic over a collection of revisions and configurations.
+     */
     @JsonProperty("traffic")
     public void setTraffic(List<TrafficTarget> traffic) {
         this.traffic = traffic;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ServiceStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ServiceStatus.java
index 52a27dfba67..5620cee86a3 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ServiceStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/ServiceStatus.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceStatus represents the Status stanza of the Service resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -113,84 +116,132 @@ public ServiceStatus(Addressable address, Map<String, String> annotations, List<
         this.url = url;
     }
 
+    /**
+     * ServiceStatus represents the Status stanza of the Service resource.
+     */
     @JsonProperty("address")
     public Addressable getAddress() {
         return address;
     }
 
+    /**
+     * ServiceStatus represents the Status stanza of the Service resource.
+     */
     @JsonProperty("address")
     public void setAddress(Addressable address) {
         this.address = address;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * LatestCreatedRevisionName is the last revision that was created from this Configuration. It might not be ready yet, for that use LatestReadyRevisionName.
+     */
     @JsonProperty("latestCreatedRevisionName")
     public String getLatestCreatedRevisionName() {
         return latestCreatedRevisionName;
     }
 
+    /**
+     * LatestCreatedRevisionName is the last revision that was created from this Configuration. It might not be ready yet, for that use LatestReadyRevisionName.
+     */
     @JsonProperty("latestCreatedRevisionName")
     public void setLatestCreatedRevisionName(String latestCreatedRevisionName) {
         this.latestCreatedRevisionName = latestCreatedRevisionName;
     }
 
+    /**
+     * LatestReadyRevisionName holds the name of the latest Revision stamped out from this Configuration that has had its "Ready" condition become "True".
+     */
     @JsonProperty("latestReadyRevisionName")
     public String getLatestReadyRevisionName() {
         return latestReadyRevisionName;
     }
 
+    /**
+     * LatestReadyRevisionName holds the name of the latest Revision stamped out from this Configuration that has had its "Ready" condition become "True".
+     */
     @JsonProperty("latestReadyRevisionName")
     public void setLatestReadyRevisionName(String latestReadyRevisionName) {
         this.latestReadyRevisionName = latestReadyRevisionName;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Traffic holds the configured traffic distribution. These entries will always contain RevisionName references. When ConfigurationName appears in the spec, this will hold the LatestReadyRevisionName that we last observed.
+     */
     @JsonProperty("traffic")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TrafficTarget> getTraffic() {
         return traffic;
     }
 
+    /**
+     * Traffic holds the configured traffic distribution. These entries will always contain RevisionName references. When ConfigurationName appears in the spec, this will hold the LatestReadyRevisionName that we last observed.
+     */
     @JsonProperty("traffic")
     public void setTraffic(List<TrafficTarget> traffic) {
         this.traffic = traffic;
     }
 
+    /**
+     * ServiceStatus represents the Status stanza of the Service resource.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * ServiceStatus represents the Status stanza of the Service resource.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/TrafficTarget.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/TrafficTarget.java
index c1f2f22a6bb..9474aaed1de 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/TrafficTarget.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1/TrafficTarget.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TrafficTarget holds a single entry of the routing table for a Route.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public TrafficTarget(String configurationName, Boolean latestRevision, Long perc
         this.url = url;
     }
 
+    /**
+     * ConfigurationName of a configuration to whose latest revision we will send this portion of traffic. When the "status.latestReadyRevisionName" of the referenced configuration changes, we will automatically migrate traffic from the prior "latest ready" revision to the new one.  This field is never set in Route's status, only its spec.  This is mutually exclusive with RevisionName.
+     */
     @JsonProperty("configurationName")
     public String getConfigurationName() {
         return configurationName;
     }
 
+    /**
+     * ConfigurationName of a configuration to whose latest revision we will send this portion of traffic. When the "status.latestReadyRevisionName" of the referenced configuration changes, we will automatically migrate traffic from the prior "latest ready" revision to the new one.  This field is never set in Route's status, only its spec.  This is mutually exclusive with RevisionName.
+     */
     @JsonProperty("configurationName")
     public void setConfigurationName(String configurationName) {
         this.configurationName = configurationName;
     }
 
+    /**
+     * LatestRevision may be optionally provided to indicate that the latest ready Revision of the Configuration should be used for this traffic target.  When provided LatestRevision must be true if RevisionName is empty; it must be false when RevisionName is non-empty.
+     */
     @JsonProperty("latestRevision")
     public Boolean getLatestRevision() {
         return latestRevision;
     }
 
+    /**
+     * LatestRevision may be optionally provided to indicate that the latest ready Revision of the Configuration should be used for this traffic target.  When provided LatestRevision must be true if RevisionName is empty; it must be false when RevisionName is non-empty.
+     */
     @JsonProperty("latestRevision")
     public void setLatestRevision(Boolean latestRevision) {
         this.latestRevision = latestRevision;
     }
 
+    /**
+     * Percent indicates that percentage based routing should be used and the value indicates the percent of traffic that is be routed to this Revision or Configuration. `0` (zero) mean no traffic, `100` means all traffic. When percentage based routing is being used the follow rules apply: - the sum of all percent values must equal 100 - when not specified, the implied value for `percent` is zero for<br><p>   that particular Revision or Configuration
+     */
     @JsonProperty("percent")
     public Long getPercent() {
         return percent;
     }
 
+    /**
+     * Percent indicates that percentage based routing should be used and the value indicates the percent of traffic that is be routed to this Revision or Configuration. `0` (zero) mean no traffic, `100` means all traffic. When percentage based routing is being used the follow rules apply: - the sum of all percent values must equal 100 - when not specified, the implied value for `percent` is zero for<br><p>   that particular Revision or Configuration
+     */
     @JsonProperty("percent")
     public void setPercent(Long percent) {
         this.percent = percent;
     }
 
+    /**
+     * RevisionName of a specific revision to which to send this portion of traffic.  This is mutually exclusive with ConfigurationName.
+     */
     @JsonProperty("revisionName")
     public String getRevisionName() {
         return revisionName;
     }
 
+    /**
+     * RevisionName of a specific revision to which to send this portion of traffic.  This is mutually exclusive with ConfigurationName.
+     */
     @JsonProperty("revisionName")
     public void setRevisionName(String revisionName) {
         this.revisionName = revisionName;
     }
 
+    /**
+     * Tag is optionally used to expose a dedicated url for referencing this target exclusively.
+     */
     @JsonProperty("tag")
     public String getTag() {
         return tag;
     }
 
+    /**
+     * Tag is optionally used to expose a dedicated url for referencing this target exclusively.
+     */
     @JsonProperty("tag")
     public void setTag(String tag) {
         this.tag = tag;
     }
 
+    /**
+     * TrafficTarget holds a single entry of the routing table for a Route.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * TrafficTarget holds a single entry of the routing table for a Route.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1alpha1/CannotConvertError.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1alpha1/CannotConvertError.java
index 2afa4316eb4..592b458bced 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1alpha1/CannotConvertError.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1alpha1/CannotConvertError.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CannotConvertError is returned when a field cannot be converted.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public CannotConvertError(String field, String message) {
         this.message = message;
     }
 
+    /**
+     * CannotConvertError is returned when a field cannot be converted.
+     */
     @JsonProperty("Field")
     public String getField() {
         return field;
     }
 
+    /**
+     * CannotConvertError is returned when a field cannot be converted.
+     */
     @JsonProperty("Field")
     public void setField(String field) {
         this.field = field;
     }
 
+    /**
+     * CannotConvertError is returned when a field cannot be converted.
+     */
     @JsonProperty("Message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * CannotConvertError is returned when a field cannot be converted.
+     */
     @JsonProperty("Message")
     public void setMessage(String message) {
         this.message = message;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1beta1/CannotConvertError.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1beta1/CannotConvertError.java
index 0d91bc80a4e..76005e7ae39 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1beta1/CannotConvertError.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1beta1/CannotConvertError.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CannotConvertError is returned when a field cannot be converted.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public CannotConvertError(String field, String message) {
         this.message = message;
     }
 
+    /**
+     * CannotConvertError is returned when a field cannot be converted.
+     */
     @JsonProperty("Field")
     public String getField() {
         return field;
     }
 
+    /**
+     * CannotConvertError is returned when a field cannot be converted.
+     */
     @JsonProperty("Field")
     public void setField(String field) {
         this.field = field;
     }
 
+    /**
+     * CannotConvertError is returned when a field cannot be converted.
+     */
     @JsonProperty("Message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * CannotConvertError is returned when a field cannot be converted.
+     */
     @JsonProperty("Message")
     public void setMessage(String message) {
         this.message = message;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1beta1/DomainMapping.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1beta1/DomainMapping.java
index b4c8b067664..227a159e18f 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1beta1/DomainMapping.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1beta1/DomainMapping.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DomainMapping is a mapping from a custom hostname to an Addressable.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class DomainMapping implements Editable<DomainMappingBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "serving.knative.dev/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DomainMapping";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DomainMapping(String apiVersion, String kind, ObjectMeta metadata, Domain
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DomainMapping is a mapping from a custom hostname to an Addressable.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DomainMapping is a mapping from a custom hostname to an Addressable.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * DomainMapping is a mapping from a custom hostname to an Addressable.
+     */
     @JsonProperty("spec")
     public DomainMappingSpec getSpec() {
         return spec;
     }
 
+    /**
+     * DomainMapping is a mapping from a custom hostname to an Addressable.
+     */
     @JsonProperty("spec")
     public void setSpec(DomainMappingSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * DomainMapping is a mapping from a custom hostname to an Addressable.
+     */
     @JsonProperty("status")
     public DomainMappingStatus getStatus() {
         return status;
     }
 
+    /**
+     * DomainMapping is a mapping from a custom hostname to an Addressable.
+     */
     @JsonProperty("status")
     public void setStatus(DomainMappingStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1beta1/DomainMappingList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1beta1/DomainMappingList.java
index 81ee39f8677..dbfed517b93 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1beta1/DomainMappingList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1beta1/DomainMappingList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DomainMappingList is a collection of DomainMapping objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class DomainMappingList implements Editable<DomainMappingListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.serving.v1beta1.DomainMapping>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "serving.knative.dev/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.serving.v1beta1.DomainMapping> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DomainMappingList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DomainMappingList(String apiVersion, List<io.fabric8.knative.serving.v1be
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of DomainMapping objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.serving.v1beta1.DomainMapping> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of DomainMapping objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.serving.v1beta1.DomainMapping> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DomainMappingList is a collection of DomainMapping objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DomainMappingList is a collection of DomainMapping objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1beta1/DomainMappingSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1beta1/DomainMappingSpec.java
index ecc8e84aea1..b9499e4ee28 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1beta1/DomainMappingSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1beta1/DomainMappingSpec.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DomainMappingSpec describes the DomainMapping the user wishes to exist.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public DomainMappingSpec(KReference ref, SecretTLS tls) {
         this.tls = tls;
     }
 
+    /**
+     * DomainMappingSpec describes the DomainMapping the user wishes to exist.
+     */
     @JsonProperty("ref")
     public KReference getRef() {
         return ref;
     }
 
+    /**
+     * DomainMappingSpec describes the DomainMapping the user wishes to exist.
+     */
     @JsonProperty("ref")
     public void setRef(KReference ref) {
         this.ref = ref;
     }
 
+    /**
+     * DomainMappingSpec describes the DomainMapping the user wishes to exist.
+     */
     @JsonProperty("tls")
     public SecretTLS getTls() {
         return tls;
     }
 
+    /**
+     * DomainMappingSpec describes the DomainMapping the user wishes to exist.
+     */
     @JsonProperty("tls")
     public void setTls(SecretTLS tls) {
         this.tls = tls;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1beta1/DomainMappingStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1beta1/DomainMappingStatus.java
index a8e7d82c5d6..06b7f5defbd 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1beta1/DomainMappingStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1beta1/DomainMappingStatus.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DomainMappingStatus describes the current state of the DomainMapping.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -100,53 +103,83 @@ public DomainMappingStatus(Addressable address, Map<String, String> annotations,
         this.url = url;
     }
 
+    /**
+     * DomainMappingStatus describes the current state of the DomainMapping.
+     */
     @JsonProperty("address")
     public Addressable getAddress() {
         return address;
     }
 
+    /**
+     * DomainMappingStatus describes the current state of the DomainMapping.
+     */
     @JsonProperty("address")
     public void setAddress(Addressable address) {
         this.address = address;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * DomainMappingStatus describes the current state of the DomainMapping.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * DomainMappingStatus describes the current state of the DomainMapping.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1beta1/SecretTLS.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1beta1/SecretTLS.java
index 97d8cdeb16d..c33ca81bcfa 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1beta1/SecretTLS.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/serving/v1beta1/SecretTLS.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SecretTLS wrapper for TLS SecretName.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public SecretTLS(String secretName) {
         this.secretName = secretName;
     }
 
+    /**
+     * SecretName is the name of the existing secret used to terminate TLS traffic.
+     */
     @JsonProperty("secretName")
     public String getSecretName() {
         return secretName;
     }
 
+    /**
+     * SecretName is the name of the existing secret used to terminate TLS traffic.
+     */
     @JsonProperty("secretName")
     public void setSecretName(String secretName) {
         this.secretName = secretName;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/IntegrationSink.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/IntegrationSink.java
index 81175a2cb9c..db7a032985c 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/IntegrationSink.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/IntegrationSink.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IntegrationSink is the Schema for the IntegrationSink API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class IntegrationSink implements Editable<IntegrationSinkBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sinks.knative.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "IntegrationSink";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public IntegrationSink(String apiVersion, String kind, ObjectMeta metadata, Inte
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * IntegrationSink is the Schema for the IntegrationSink API.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * IntegrationSink is the Schema for the IntegrationSink API.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * IntegrationSink is the Schema for the IntegrationSink API.
+     */
     @JsonProperty("spec")
     public IntegrationSinkSpec getSpec() {
         return spec;
     }
 
+    /**
+     * IntegrationSink is the Schema for the IntegrationSink API.
+     */
     @JsonProperty("spec")
     public void setSpec(IntegrationSinkSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * IntegrationSink is the Schema for the IntegrationSink API.
+     */
     @JsonProperty("status")
     public IntegrationSinkStatus getStatus() {
         return status;
     }
 
+    /**
+     * IntegrationSink is the Schema for the IntegrationSink API.
+     */
     @JsonProperty("status")
     public void setStatus(IntegrationSinkStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/IntegrationSinkList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/IntegrationSinkList.java
index 510bbf3086f..fce17eff575 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/IntegrationSinkList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/IntegrationSinkList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IntegrationSinkList contains a list of IntegrationSink
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class IntegrationSinkList implements Editable<IntegrationSinkListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.sinks.v1alpha1.IntegrationSink>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sinks.knative.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.sinks.v1alpha1.IntegrationSink> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "IntegrationSinkList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public IntegrationSinkList(String apiVersion, List<io.fabric8.knative.sinks.v1al
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * IntegrationSinkList contains a list of IntegrationSink
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.sinks.v1alpha1.IntegrationSink> getItems() {
         return items;
     }
 
+    /**
+     * IntegrationSinkList contains a list of IntegrationSink
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.sinks.v1alpha1.IntegrationSink> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * IntegrationSinkList contains a list of IntegrationSink
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * IntegrationSinkList contains a list of IntegrationSink
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/IntegrationSinkStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/IntegrationSinkStatus.java
index 8a4ff82c8c5..0896c1a6929 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/IntegrationSinkStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/IntegrationSinkStatus.java
@@ -117,55 +117,85 @@ public void setAddress(Addressable address) {
         this.address = address;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Addressable> getAddresses() {
         return addresses;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<Addressable> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Policies holds the list of applied EventPolicies
+     */
     @JsonProperty("policies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AppliedEventPolicyRef> getPolicies() {
         return policies;
     }
 
+    /**
+     * Policies holds the list of applied EventPolicies
+     */
     @JsonProperty("policies")
     public void setPolicies(List<AppliedEventPolicyRef> policies) {
         this.policies = policies;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/JobSink.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/JobSink.java
index d001bf845b0..6761d401993 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/JobSink.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/JobSink.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JobSink is the Schema for the JobSink API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class JobSink implements Editable<JobSinkBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sinks.knative.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "JobSink";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public JobSink(String apiVersion, String kind, ObjectMeta metadata, JobSinkSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * JobSink is the Schema for the JobSink API.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * JobSink is the Schema for the JobSink API.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * JobSink is the Schema for the JobSink API.
+     */
     @JsonProperty("spec")
     public JobSinkSpec getSpec() {
         return spec;
     }
 
+    /**
+     * JobSink is the Schema for the JobSink API.
+     */
     @JsonProperty("spec")
     public void setSpec(JobSinkSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * JobSink is the Schema for the JobSink API.
+     */
     @JsonProperty("status")
     public JobSinkStatus getStatus() {
         return status;
     }
 
+    /**
+     * JobSink is the Schema for the JobSink API.
+     */
     @JsonProperty("status")
     public void setStatus(JobSinkStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/JobSinkList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/JobSinkList.java
index cb4d6e6877d..5ca1ff76f18 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/JobSinkList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/JobSinkList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JobSinkList contains a list of JobSink.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class JobSinkList implements Editable<JobSinkListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.sinks.v1alpha1.JobSink>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sinks.knative.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.sinks.v1alpha1.JobSink> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "JobSinkList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public JobSinkList(String apiVersion, List<io.fabric8.knative.sinks.v1alpha1.Job
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * JobSinkList contains a list of JobSink.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.sinks.v1alpha1.JobSink> getItems() {
         return items;
     }
 
+    /**
+     * JobSinkList contains a list of JobSink.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.sinks.v1alpha1.JobSink> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * JobSinkList contains a list of JobSink.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * JobSinkList contains a list of JobSink.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/JobSinkSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/JobSinkSpec.java
index e207fc3da5d..c917cfe9361 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/JobSinkSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/JobSinkSpec.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JobSinkSpec defines the desired state of the JobSink.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,11 +82,17 @@ public JobSinkSpec(Job job) {
         this.job = job;
     }
 
+    /**
+     * JobSinkSpec defines the desired state of the JobSink.
+     */
     @JsonProperty("job")
     public Job getJob() {
         return job;
     }
 
+    /**
+     * JobSinkSpec defines the desired state of the JobSink.
+     */
     @JsonProperty("job")
     public void setJob(Job job) {
         this.job = job;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/JobSinkStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/JobSinkStatus.java
index 7c13175c3c7..08b2459539c 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/JobSinkStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/JobSinkStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JobSinkStatus defines the observed state of JobSink.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -111,75 +114,117 @@ public JobSinkStatus(Addressable address, List<Addressable> addresses, Map<Strin
         this.policies = policies;
     }
 
+    /**
+     * JobSinkStatus defines the observed state of JobSink.
+     */
     @JsonProperty("address")
     public Addressable getAddress() {
         return address;
     }
 
+    /**
+     * JobSinkStatus defines the observed state of JobSink.
+     */
     @JsonProperty("address")
     public void setAddress(Addressable address) {
         this.address = address;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Addressable> getAddresses() {
         return addresses;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<Addressable> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * JobSinkStatus defines the observed state of JobSink.
+     */
     @JsonProperty("job")
     public JobStatus getJob() {
         return job;
     }
 
+    /**
+     * JobSinkStatus defines the observed state of JobSink.
+     */
     @JsonProperty("job")
     public void setJob(JobStatus job) {
         this.job = job;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Policies holds the list of applied EventPolicies
+     */
     @JsonProperty("policies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AppliedEventPolicyRef> getPolicies() {
         return policies;
     }
 
+    /**
+     * Policies holds the list of applied EventPolicies
+     */
     @JsonProperty("policies")
     public void setPolicies(List<AppliedEventPolicyRef> policies) {
         this.policies = policies;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/Log.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/Log.java
index a887111c3a5..b83c4ab4f5e 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/Log.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sinks/v1alpha1/Log.java
@@ -126,21 +126,33 @@ public Log(String level, Boolean logMask, String loggerName, String marker, Bool
         this.showStreams = showStreams;
     }
 
+    /**
+     * Name of the logging category to use
+     */
     @JsonProperty("level")
     public String getLevel() {
         return level;
     }
 
+    /**
+     * Name of the logging category to use
+     */
     @JsonProperty("level")
     public void setLevel(String level) {
         this.level = level;
     }
 
+    /**
+     * Logging level to use
+     */
     @JsonProperty("logMask")
     public Boolean getLogMask() {
         return logMask;
     }
 
+    /**
+     * Logging level to use
+     */
     @JsonProperty("logMask")
     public void setLogMask(Boolean logMask) {
         this.logMask = logMask;
@@ -156,101 +168,161 @@ public void setLoggerName(String loggerName) {
         this.loggerName = loggerName;
     }
 
+    /**
+     * Mask sensitive information in the log
+     */
     @JsonProperty("marker")
     public String getMarker() {
         return marker;
     }
 
+    /**
+     * Mask sensitive information in the log
+     */
     @JsonProperty("marker")
     public void setMarker(String marker) {
         this.marker = marker;
     }
 
+    /**
+     * An optional Marker name to use
+     */
     @JsonProperty("multiline")
     public Boolean getMultiline() {
         return multiline;
     }
 
+    /**
+     * An optional Marker name to use
+     */
     @JsonProperty("multiline")
     public void setMultiline(Boolean multiline) {
         this.multiline = multiline;
     }
 
+    /**
+     * If enabled, outputs each information on a newline
+     */
     @JsonProperty("showAllProperties")
     public Boolean getShowAllProperties() {
         return showAllProperties;
     }
 
+    /**
+     * If enabled, outputs each information on a newline
+     */
     @JsonProperty("showAllProperties")
     public void setShowAllProperties(Boolean showAllProperties) {
         this.showAllProperties = showAllProperties;
     }
 
+    /**
+     * Show all of the exchange properties (both internal and custom)
+     */
     @JsonProperty("showBody")
     public Boolean getShowBody() {
         return showBody;
     }
 
+    /**
+     * Show all of the exchange properties (both internal and custom)
+     */
     @JsonProperty("showBody")
     public void setShowBody(Boolean showBody) {
         this.showBody = showBody;
     }
 
+    /**
+     * Show the message body
+     */
     @JsonProperty("showBodyType")
     public Boolean getShowBodyType() {
         return showBodyType;
     }
 
+    /**
+     * Show the message body
+     */
     @JsonProperty("showBodyType")
     public void setShowBodyType(Boolean showBodyType) {
         this.showBodyType = showBodyType;
     }
 
+    /**
+     * Show the stream bodies
+     */
     @JsonProperty("showCachedStreams")
     public Boolean getShowCachedStreams() {
         return showCachedStreams;
     }
 
+    /**
+     * Show the stream bodies
+     */
     @JsonProperty("showCachedStreams")
     public void setShowCachedStreams(Boolean showCachedStreams) {
         this.showCachedStreams = showCachedStreams;
     }
 
+    /**
+     * Show the body Java type
+     */
     @JsonProperty("showExchangePattern")
     public Boolean getShowExchangePattern() {
         return showExchangePattern;
     }
 
+    /**
+     * Show the body Java type
+     */
     @JsonProperty("showExchangePattern")
     public void setShowExchangePattern(Boolean showExchangePattern) {
         this.showExchangePattern = showExchangePattern;
     }
 
+    /**
+     * Show the Message Exchange Pattern (MEP)
+     */
     @JsonProperty("showHeaders")
     public Boolean getShowHeaders() {
         return showHeaders;
     }
 
+    /**
+     * Show the Message Exchange Pattern (MEP)
+     */
     @JsonProperty("showHeaders")
     public void setShowHeaders(Boolean showHeaders) {
         this.showHeaders = showHeaders;
     }
 
+    /**
+     * Show the headers received
+     */
     @JsonProperty("showProperties")
     public Boolean getShowProperties() {
         return showProperties;
     }
 
+    /**
+     * Show the headers received
+     */
     @JsonProperty("showProperties")
     public void setShowProperties(Boolean showProperties) {
         this.showProperties = showProperties;
     }
 
+    /**
+     * Show the exchange properties (only custom)
+     */
     @JsonProperty("showStreams")
     public Boolean getShowStreams() {
         return showStreams;
     }
 
+    /**
+     * Show the exchange properties (only custom)
+     */
     @JsonProperty("showStreams")
     public void setShowStreams(Boolean showStreams) {
         this.showStreams = showStreams;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/APIVersionKind.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/APIVersionKind.java
index c33f235f233..e83581beb4c 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/APIVersionKind.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/APIVersionKind.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * APIVersionKind is an APIVersion and Kind tuple.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public APIVersionKind(String apiVersion, String kind) {
         this.kind = kind;
     }
 
+    /**
+     * APIVersion - the API version of the resource to watch.
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * APIVersion - the API version of the resource to watch.
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Kind of the resource to watch. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind of the resource to watch. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/APIVersionKindSelector.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/APIVersionKindSelector.java
index d3dafab5c59..63ac4a67963 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/APIVersionKindSelector.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/APIVersionKindSelector.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * APIVersionKindSelector is an APIVersion Kind tuple with a LabelSelector.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public APIVersionKindSelector(String apiVersion, String kind, LabelSelector sele
         this.selector = selector;
     }
 
+    /**
+     * APIVersion - the API version of the resource to watch.
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * APIVersion - the API version of the resource to watch.
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Kind of the resource to watch. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind of the resource to watch. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * APIVersionKindSelector is an APIVersion Kind tuple with a LabelSelector.
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * APIVersionKindSelector is an APIVersion Kind tuple with a LabelSelector.
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ApiServerSource.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ApiServerSource.java
index 72ada8ea957..7bfac0ad93e 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ApiServerSource.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ApiServerSource.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ApiServerSource is the Schema for the apiserversources API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class ApiServerSource implements Editable<ApiServerSourceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sources.knative.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ApiServerSource";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ApiServerSource(String apiVersion, String kind, ObjectMeta metadata, ApiS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ApiServerSource is the Schema for the apiserversources API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ApiServerSource is the Schema for the apiserversources API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ApiServerSource is the Schema for the apiserversources API
+     */
     @JsonProperty("spec")
     public ApiServerSourceSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ApiServerSource is the Schema for the apiserversources API
+     */
     @JsonProperty("spec")
     public void setSpec(ApiServerSourceSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ApiServerSource is the Schema for the apiserversources API
+     */
     @JsonProperty("status")
     public ApiServerSourceStatus getStatus() {
         return status;
     }
 
+    /**
+     * ApiServerSource is the Schema for the apiserversources API
+     */
     @JsonProperty("status")
     public void setStatus(ApiServerSourceStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ApiServerSourceList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ApiServerSourceList.java
index c7fbb766304..e2f4ab77ff4 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ApiServerSourceList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ApiServerSourceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ApiServerSourceList contains a list of ApiServerSource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ApiServerSourceList implements Editable<ApiServerSourceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.sources.v1.ApiServerSource>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sources.knative.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.sources.v1.ApiServerSource> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ApiServerSourceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ApiServerSourceList(String apiVersion, List<io.fabric8.knative.sources.v1
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ApiServerSourceList contains a list of ApiServerSource
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.sources.v1.ApiServerSource> getItems() {
         return items;
     }
 
+    /**
+     * ApiServerSourceList contains a list of ApiServerSource
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.sources.v1.ApiServerSource> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ApiServerSourceList contains a list of ApiServerSource
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ApiServerSourceList contains a list of ApiServerSource
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ApiServerSourceSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ApiServerSourceSpec.java
index 9c576554639..1c3a7b8a402 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ApiServerSourceSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ApiServerSourceSpec.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ApiServerSourceSpec defines the desired state of ApiServerSource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -113,83 +116,131 @@ public ApiServerSourceSpec(CloudEventOverrides ceOverrides, List<SubscriptionsAP
         this.sink = sink;
     }
 
+    /**
+     * ApiServerSourceSpec defines the desired state of ApiServerSource
+     */
     @JsonProperty("ceOverrides")
     public CloudEventOverrides getCeOverrides() {
         return ceOverrides;
     }
 
+    /**
+     * ApiServerSourceSpec defines the desired state of ApiServerSource
+     */
     @JsonProperty("ceOverrides")
     public void setCeOverrides(CloudEventOverrides ceOverrides) {
         this.ceOverrides = ceOverrides;
     }
 
+    /**
+     * Filters is an experimental field that conforms to the CNCF CloudEvents Subscriptions API. It's an array of filter expressions that evaluate to true or false. If any filter expression in the array evaluates to false, the event MUST NOT be sent to the Sink. If all the filter expressions in the array evaluate to true, the event MUST be attempted to be delivered. Absence of a filter or empty array implies a value of true.
+     */
     @JsonProperty("filters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SubscriptionsAPIFilter> getFilters() {
         return filters;
     }
 
+    /**
+     * Filters is an experimental field that conforms to the CNCF CloudEvents Subscriptions API. It's an array of filter expressions that evaluate to true or false. If any filter expression in the array evaluates to false, the event MUST NOT be sent to the Sink. If all the filter expressions in the array evaluate to true, the event MUST be attempted to be delivered. Absence of a filter or empty array implies a value of true.
+     */
     @JsonProperty("filters")
     public void setFilters(List<SubscriptionsAPIFilter> filters) {
         this.filters = filters;
     }
 
+    /**
+     * EventMode controls the format of the event. `Reference` sends a dataref event type for the resource under watch. `Resource` send the full resource lifecycle event. Defaults to `Reference`
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * EventMode controls the format of the event. `Reference` sends a dataref event type for the resource under watch. `Resource` send the full resource lifecycle event. Defaults to `Reference`
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
     }
 
+    /**
+     * ApiServerSourceSpec defines the desired state of ApiServerSource
+     */
     @JsonProperty("namespaceSelector")
     public LabelSelector getNamespaceSelector() {
         return namespaceSelector;
     }
 
+    /**
+     * ApiServerSourceSpec defines the desired state of ApiServerSource
+     */
     @JsonProperty("namespaceSelector")
     public void setNamespaceSelector(LabelSelector namespaceSelector) {
         this.namespaceSelector = namespaceSelector;
     }
 
+    /**
+     * ApiServerSourceSpec defines the desired state of ApiServerSource
+     */
     @JsonProperty("owner")
     public APIVersionKind getOwner() {
         return owner;
     }
 
+    /**
+     * ApiServerSourceSpec defines the desired state of ApiServerSource
+     */
     @JsonProperty("owner")
     public void setOwner(APIVersionKind owner) {
         this.owner = owner;
     }
 
+    /**
+     * Resource are the resources this source will track and send related lifecycle events from the Kubernetes ApiServer, with an optional label selector to help filter.
+     */
     @JsonProperty("resources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<APIVersionKindSelector> getResources() {
         return resources;
     }
 
+    /**
+     * Resource are the resources this source will track and send related lifecycle events from the Kubernetes ApiServer, with an optional label selector to help filter.
+     */
     @JsonProperty("resources")
     public void setResources(List<APIVersionKindSelector> resources) {
         this.resources = resources;
     }
 
+    /**
+     * ServiceAccountName is the name of the ServiceAccount to use to run this source. Defaults to default if not set.
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * ServiceAccountName is the name of the ServiceAccount to use to run this source. Defaults to default if not set.
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * ApiServerSourceSpec defines the desired state of ApiServerSource
+     */
     @JsonProperty("sink")
     public Destination getSink() {
         return sink;
     }
 
+    /**
+     * ApiServerSourceSpec defines the desired state of ApiServerSource
+     */
     @JsonProperty("sink")
     public void setSink(Destination sink) {
         this.sink = sink;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ApiServerSourceStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ApiServerSourceStatus.java
index 4dd7f59da82..25b33ccc6e0 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ApiServerSourceStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ApiServerSourceStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ApiServerSourceStatus defines the observed state of ApiServerSource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -119,95 +122,149 @@ public ApiServerSourceStatus(Map<String, String> annotations, AuthStatus auth, L
         this.sinkUri = sinkUri;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * ApiServerSourceStatus defines the observed state of ApiServerSource
+     */
     @JsonProperty("auth")
     public AuthStatus getAuth() {
         return auth;
     }
 
+    /**
+     * ApiServerSourceStatus defines the observed state of ApiServerSource
+     */
     @JsonProperty("auth")
     public void setAuth(AuthStatus auth) {
         this.auth = auth;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CloudEventAttributes> getCeAttributes() {
         return ceAttributes;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     public void setCeAttributes(List<CloudEventAttributes> ceAttributes) {
         this.ceAttributes = ceAttributes;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Namespaces show the namespaces currently watched by the ApiServerSource
+     */
     @JsonProperty("namespaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNamespaces() {
         return namespaces;
     }
 
+    /**
+     * Namespaces show the namespaces currently watched by the ApiServerSource
+     */
     @JsonProperty("namespaces")
     public void setNamespaces(List<String> namespaces) {
         this.namespaces = namespaces;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public String getSinkAudience() {
         return sinkAudience;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public void setSinkAudience(String sinkAudience) {
         this.sinkAudience = sinkAudience;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public String getSinkCACerts() {
         return sinkCACerts;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public void setSinkCACerts(String sinkCACerts) {
         this.sinkCACerts = sinkCACerts;
     }
 
+    /**
+     * ApiServerSourceStatus defines the observed state of ApiServerSource
+     */
     @JsonProperty("sinkUri")
     public String getSinkUri() {
         return sinkUri;
     }
 
+    /**
+     * ApiServerSourceStatus defines the observed state of ApiServerSource
+     */
     @JsonProperty("sinkUri")
     public void setSinkUri(String sinkUri) {
         this.sinkUri = sinkUri;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ContainerSource.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ContainerSource.java
index 0badcabcd4e..a16c8d743bc 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ContainerSource.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ContainerSource.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerSource is the Schema for the containersources API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class ContainerSource implements Editable<ContainerSourceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sources.knative.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ContainerSource";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ContainerSource(String apiVersion, String kind, ObjectMeta metadata, Cont
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ContainerSource is the Schema for the containersources API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ContainerSource is the Schema for the containersources API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ContainerSource is the Schema for the containersources API
+     */
     @JsonProperty("spec")
     public ContainerSourceSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ContainerSource is the Schema for the containersources API
+     */
     @JsonProperty("spec")
     public void setSpec(ContainerSourceSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ContainerSource is the Schema for the containersources API
+     */
     @JsonProperty("status")
     public ContainerSourceStatus getStatus() {
         return status;
     }
 
+    /**
+     * ContainerSource is the Schema for the containersources API
+     */
     @JsonProperty("status")
     public void setStatus(ContainerSourceStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ContainerSourceList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ContainerSourceList.java
index 866b3f75a4c..871443024fa 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ContainerSourceList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ContainerSourceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerSourceList contains a list of ContainerSource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ContainerSourceList implements Editable<ContainerSourceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.sources.v1.ContainerSource>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sources.knative.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.sources.v1.ContainerSource> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ContainerSourceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ContainerSourceList(String apiVersion, List<io.fabric8.knative.sources.v1
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ContainerSourceList contains a list of ContainerSource
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.sources.v1.ContainerSource> getItems() {
         return items;
     }
 
+    /**
+     * ContainerSourceList contains a list of ContainerSource
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.sources.v1.ContainerSource> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ContainerSourceList contains a list of ContainerSource
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ContainerSourceList contains a list of ContainerSource
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ContainerSourceSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ContainerSourceSpec.java
index 90f50bcbf54..69e50147f10 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ContainerSourceSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ContainerSourceSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerSourceSpec defines the desired state of ContainerSource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -88,31 +91,49 @@ public ContainerSourceSpec(CloudEventOverrides ceOverrides, Destination sink, Po
         this.template = template;
     }
 
+    /**
+     * ContainerSourceSpec defines the desired state of ContainerSource
+     */
     @JsonProperty("ceOverrides")
     public CloudEventOverrides getCeOverrides() {
         return ceOverrides;
     }
 
+    /**
+     * ContainerSourceSpec defines the desired state of ContainerSource
+     */
     @JsonProperty("ceOverrides")
     public void setCeOverrides(CloudEventOverrides ceOverrides) {
         this.ceOverrides = ceOverrides;
     }
 
+    /**
+     * ContainerSourceSpec defines the desired state of ContainerSource
+     */
     @JsonProperty("sink")
     public Destination getSink() {
         return sink;
     }
 
+    /**
+     * ContainerSourceSpec defines the desired state of ContainerSource
+     */
     @JsonProperty("sink")
     public void setSink(Destination sink) {
         this.sink = sink;
     }
 
+    /**
+     * ContainerSourceSpec defines the desired state of ContainerSource
+     */
     @JsonProperty("template")
     public PodTemplateSpec getTemplate() {
         return template;
     }
 
+    /**
+     * ContainerSourceSpec defines the desired state of ContainerSource
+     */
     @JsonProperty("template")
     public void setTemplate(PodTemplateSpec template) {
         this.template = template;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ContainerSourceStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ContainerSourceStatus.java
index ba299bfab2e..e3c3556dd95 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ContainerSourceStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/ContainerSourceStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerSourceStatus defines the observed state of ContainerSource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -114,84 +117,132 @@ public ContainerSourceStatus(Map<String, String> annotations, AuthStatus auth, L
         this.sinkUri = sinkUri;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * ContainerSourceStatus defines the observed state of ContainerSource
+     */
     @JsonProperty("auth")
     public AuthStatus getAuth() {
         return auth;
     }
 
+    /**
+     * ContainerSourceStatus defines the observed state of ContainerSource
+     */
     @JsonProperty("auth")
     public void setAuth(AuthStatus auth) {
         this.auth = auth;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CloudEventAttributes> getCeAttributes() {
         return ceAttributes;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     public void setCeAttributes(List<CloudEventAttributes> ceAttributes) {
         this.ceAttributes = ceAttributes;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public String getSinkAudience() {
         return sinkAudience;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public void setSinkAudience(String sinkAudience) {
         this.sinkAudience = sinkAudience;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public String getSinkCACerts() {
         return sinkCACerts;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public void setSinkCACerts(String sinkCACerts) {
         this.sinkCACerts = sinkCACerts;
     }
 
+    /**
+     * ContainerSourceStatus defines the observed state of ContainerSource
+     */
     @JsonProperty("sinkUri")
     public String getSinkUri() {
         return sinkUri;
     }
 
+    /**
+     * ContainerSourceStatus defines the observed state of ContainerSource
+     */
     @JsonProperty("sinkUri")
     public void setSinkUri(String sinkUri) {
         this.sinkUri = sinkUri;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/KafkaSource.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/KafkaSource.java
index 8432770abe3..241b4d98fbe 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/KafkaSource.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/KafkaSource.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KafkaSource is the Schema for the kafkasources API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class KafkaSource implements Editable<KafkaSourceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sources.knative.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KafkaSource";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public KafkaSource(String apiVersion, String kind, ObjectMeta metadata, KafkaSou
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KafkaSource is the Schema for the kafkasources API.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KafkaSource is the Schema for the kafkasources API.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * KafkaSource is the Schema for the kafkasources API.
+     */
     @JsonProperty("spec")
     public KafkaSourceSpec getSpec() {
         return spec;
     }
 
+    /**
+     * KafkaSource is the Schema for the kafkasources API.
+     */
     @JsonProperty("spec")
     public void setSpec(KafkaSourceSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * KafkaSource is the Schema for the kafkasources API.
+     */
     @JsonProperty("status")
     public KafkaSourceStatus getStatus() {
         return status;
     }
 
+    /**
+     * KafkaSource is the Schema for the kafkasources API.
+     */
     @JsonProperty("status")
     public void setStatus(KafkaSourceStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/KafkaSourceList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/KafkaSourceList.java
index 51bdd459c4f..eb738d817e1 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/KafkaSourceList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/KafkaSourceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KafkaSourceList contains a list of KafkaSources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class KafkaSourceList implements Editable<KafkaSourceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.sources.v1.KafkaSource>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sources.knative.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.sources.v1.KafkaSource> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KafkaSourceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public KafkaSourceList(String apiVersion, List<io.fabric8.knative.sources.v1.Kaf
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * KafkaSourceList contains a list of KafkaSources.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.sources.v1.KafkaSource> getItems() {
         return items;
     }
 
+    /**
+     * KafkaSourceList contains a list of KafkaSources.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.sources.v1.KafkaSource> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KafkaSourceList contains a list of KafkaSources.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KafkaSourceList contains a list of KafkaSources.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/KafkaSourceSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/KafkaSourceSpec.java
index 5ba8ce4416c..19fc9770bc3 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/KafkaSourceSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/KafkaSourceSpec.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KafkaSourceSpec defines the desired state of the KafkaSource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -122,103 +125,163 @@ public KafkaSourceSpec(List<String> bootstrapServers, CloudEventOverrides ceOver
         this.topics = topics;
     }
 
+    /**
+     * Bootstrap servers are the Kafka servers the consumer will connect to.
+     */
     @JsonProperty("bootstrapServers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getBootstrapServers() {
         return bootstrapServers;
     }
 
+    /**
+     * Bootstrap servers are the Kafka servers the consumer will connect to.
+     */
     @JsonProperty("bootstrapServers")
     public void setBootstrapServers(List<String> bootstrapServers) {
         this.bootstrapServers = bootstrapServers;
     }
 
+    /**
+     * KafkaSourceSpec defines the desired state of the KafkaSource.
+     */
     @JsonProperty("ceOverrides")
     public CloudEventOverrides getCeOverrides() {
         return ceOverrides;
     }
 
+    /**
+     * KafkaSourceSpec defines the desired state of the KafkaSource.
+     */
     @JsonProperty("ceOverrides")
     public void setCeOverrides(CloudEventOverrides ceOverrides) {
         this.ceOverrides = ceOverrides;
     }
 
+    /**
+     * ConsumerGroupID is the consumer group ID.
+     */
     @JsonProperty("consumerGroup")
     public String getConsumerGroup() {
         return consumerGroup;
     }
 
+    /**
+     * ConsumerGroupID is the consumer group ID.
+     */
     @JsonProperty("consumerGroup")
     public void setConsumerGroup(String consumerGroup) {
         this.consumerGroup = consumerGroup;
     }
 
+    /**
+     * Number of desired consumers running in the consumer group. Defaults to 1.<br><p> <br><p> This is a pointer to distinguish between explicit zero and not specified.
+     */
     @JsonProperty("consumers")
     public Integer getConsumers() {
         return consumers;
     }
 
+    /**
+     * Number of desired consumers running in the consumer group. Defaults to 1.<br><p> <br><p> This is a pointer to distinguish between explicit zero and not specified.
+     */
     @JsonProperty("consumers")
     public void setConsumers(Integer consumers) {
         this.consumers = consumers;
     }
 
+    /**
+     * KafkaSourceSpec defines the desired state of the KafkaSource.
+     */
     @JsonProperty("delivery")
     public DeliverySpec getDelivery() {
         return delivery;
     }
 
+    /**
+     * KafkaSourceSpec defines the desired state of the KafkaSource.
+     */
     @JsonProperty("delivery")
     public void setDelivery(DeliverySpec delivery) {
         this.delivery = delivery;
     }
 
+    /**
+     * InitialOffset is the Initial Offset for the consumer group. should be earliest or latest
+     */
     @JsonProperty("initialOffset")
     public String getInitialOffset() {
         return initialOffset;
     }
 
+    /**
+     * InitialOffset is the Initial Offset for the consumer group. should be earliest or latest
+     */
     @JsonProperty("initialOffset")
     public void setInitialOffset(String initialOffset) {
         this.initialOffset = initialOffset;
     }
 
+    /**
+     * KafkaSourceSpec defines the desired state of the KafkaSource.
+     */
     @JsonProperty("net")
     public KafkaNetSpec getNet() {
         return net;
     }
 
+    /**
+     * KafkaSourceSpec defines the desired state of the KafkaSource.
+     */
     @JsonProperty("net")
     public void setNet(KafkaNetSpec net) {
         this.net = net;
     }
 
+    /**
+     * Ordering is the type of the consumer verticle. Should be ordered or unordered. By default, it is ordered.
+     */
     @JsonProperty("ordering")
     public String getOrdering() {
         return ordering;
     }
 
+    /**
+     * Ordering is the type of the consumer verticle. Should be ordered or unordered. By default, it is ordered.
+     */
     @JsonProperty("ordering")
     public void setOrdering(String ordering) {
         this.ordering = ordering;
     }
 
+    /**
+     * KafkaSourceSpec defines the desired state of the KafkaSource.
+     */
     @JsonProperty("sink")
     public Destination getSink() {
         return sink;
     }
 
+    /**
+     * KafkaSourceSpec defines the desired state of the KafkaSource.
+     */
     @JsonProperty("sink")
     public void setSink(Destination sink) {
         this.sink = sink;
     }
 
+    /**
+     * Topic topics to consume messages from
+     */
     @JsonProperty("topics")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getTopics() {
         return topics;
     }
 
+    /**
+     * Topic topics to consume messages from
+     */
     @JsonProperty("topics")
     public void setTopics(List<String> topics) {
         this.topics = topics;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/KafkaSourceStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/KafkaSourceStatus.java
index 1924a895891..1267d791e98 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/KafkaSourceStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/KafkaSourceStatus.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KafkaSourceStatus defines the observed state of KafkaSource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -136,135 +139,213 @@ public KafkaSourceStatus(Map<String, String> annotations, AuthStatus auth, List<
         this.sinkUri = sinkUri;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * KafkaSourceStatus defines the observed state of KafkaSource.
+     */
     @JsonProperty("auth")
     public AuthStatus getAuth() {
         return auth;
     }
 
+    /**
+     * KafkaSourceStatus defines the observed state of KafkaSource.
+     */
     @JsonProperty("auth")
     public void setAuth(AuthStatus auth) {
         this.auth = auth;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CloudEventAttributes> getCeAttributes() {
         return ceAttributes;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     public void setCeAttributes(List<CloudEventAttributes> ceAttributes) {
         this.ceAttributes = ceAttributes;
     }
 
+    /**
+     * Claims consumed by this KafkaSource instance
+     */
     @JsonProperty("claims")
     public String getClaims() {
         return claims;
     }
 
+    /**
+     * Claims consumed by this KafkaSource instance
+     */
     @JsonProperty("claims")
     public void setClaims(String claims) {
         this.claims = claims;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Total number of consumers actually running in the consumer group.
+     */
     @JsonProperty("consumers")
     public Integer getConsumers() {
         return consumers;
     }
 
+    /**
+     * Total number of consumers actually running in the consumer group.
+     */
     @JsonProperty("consumers")
     public void setConsumers(Integer consumers) {
         this.consumers = consumers;
     }
 
+    /**
+     * KafkaSourceStatus defines the observed state of KafkaSource.
+     */
     @JsonProperty("maxAllowedVReplicas")
     public Integer getMaxAllowedVReplicas() {
         return maxAllowedVReplicas;
     }
 
+    /**
+     * KafkaSourceStatus defines the observed state of KafkaSource.
+     */
     @JsonProperty("maxAllowedVReplicas")
     public void setMaxAllowedVReplicas(Integer maxAllowedVReplicas) {
         this.maxAllowedVReplicas = maxAllowedVReplicas;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * KafkaSourceStatus defines the observed state of KafkaSource.
+     */
     @JsonProperty("placements")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Placement> getPlacements() {
         return placements;
     }
 
+    /**
+     * KafkaSourceStatus defines the observed state of KafkaSource.
+     */
     @JsonProperty("placements")
     public void setPlacements(List<Placement> placements) {
         this.placements = placements;
     }
 
+    /**
+     * Use for labelSelectorPath when scaling Kafka source
+     */
     @JsonProperty("selector")
     public String getSelector() {
         return selector;
     }
 
+    /**
+     * Use for labelSelectorPath when scaling Kafka source
+     */
     @JsonProperty("selector")
     public void setSelector(String selector) {
         this.selector = selector;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public String getSinkAudience() {
         return sinkAudience;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public void setSinkAudience(String sinkAudience) {
         this.sinkAudience = sinkAudience;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public String getSinkCACerts() {
         return sinkCACerts;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public void setSinkCACerts(String sinkCACerts) {
         this.sinkCACerts = sinkCACerts;
     }
 
+    /**
+     * KafkaSourceStatus defines the observed state of KafkaSource.
+     */
     @JsonProperty("sinkUri")
     public String getSinkUri() {
         return sinkUri;
     }
 
+    /**
+     * KafkaSourceStatus defines the observed state of KafkaSource.
+     */
     @JsonProperty("sinkUri")
     public void setSinkUri(String sinkUri) {
         this.sinkUri = sinkUri;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/PingSource.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/PingSource.java
index 6c6250433cf..362e7ac8b6a 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/PingSource.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/PingSource.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PingSource is the Schema for the PingSources API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class PingSource implements Editable<PingSourceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sources.knative.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PingSource";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PingSource(String apiVersion, String kind, ObjectMeta metadata, PingSourc
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PingSource is the Schema for the PingSources API.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PingSource is the Schema for the PingSources API.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PingSource is the Schema for the PingSources API.
+     */
     @JsonProperty("spec")
     public PingSourceSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PingSource is the Schema for the PingSources API.
+     */
     @JsonProperty("spec")
     public void setSpec(PingSourceSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PingSource is the Schema for the PingSources API.
+     */
     @JsonProperty("status")
     public PingSourceStatus getStatus() {
         return status;
     }
 
+    /**
+     * PingSource is the Schema for the PingSources API.
+     */
     @JsonProperty("status")
     public void setStatus(PingSourceStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/PingSourceList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/PingSourceList.java
index d85d56cf0cc..22ebb5de92e 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/PingSourceList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/PingSourceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PingSourceList contains a list of PingSources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PingSourceList implements Editable<PingSourceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.sources.v1.PingSource>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sources.knative.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.sources.v1.PingSource> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PingSourceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PingSourceList(String apiVersion, List<io.fabric8.knative.sources.v1.Ping
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PingSourceList contains a list of PingSources.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.sources.v1.PingSource> getItems() {
         return items;
     }
 
+    /**
+     * PingSourceList contains a list of PingSources.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.sources.v1.PingSource> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PingSourceList contains a list of PingSources.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PingSourceList contains a list of PingSources.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/PingSourceSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/PingSourceSpec.java
index 7254144b837..9065ecdbc08 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/PingSourceSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/PingSourceSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PingSourceSpec defines the desired state of the PingSource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -104,71 +107,113 @@ public PingSourceSpec(CloudEventOverrides ceOverrides, String contentType, Strin
         this.timezone = timezone;
     }
 
+    /**
+     * PingSourceSpec defines the desired state of the PingSource.
+     */
     @JsonProperty("ceOverrides")
     public CloudEventOverrides getCeOverrides() {
         return ceOverrides;
     }
 
+    /**
+     * PingSourceSpec defines the desired state of the PingSource.
+     */
     @JsonProperty("ceOverrides")
     public void setCeOverrides(CloudEventOverrides ceOverrides) {
         this.ceOverrides = ceOverrides;
     }
 
+    /**
+     * ContentType is the media type of Data or DataBase64. Default is empty.
+     */
     @JsonProperty("contentType")
     public String getContentType() {
         return contentType;
     }
 
+    /**
+     * ContentType is the media type of Data or DataBase64. Default is empty.
+     */
     @JsonProperty("contentType")
     public void setContentType(String contentType) {
         this.contentType = contentType;
     }
 
+    /**
+     * Data is data used as the body of the event posted to the sink. Default is empty. Mutually exclusive with DataBase64.
+     */
     @JsonProperty("data")
     public String getData() {
         return data;
     }
 
+    /**
+     * Data is data used as the body of the event posted to the sink. Default is empty. Mutually exclusive with DataBase64.
+     */
     @JsonProperty("data")
     public void setData(String data) {
         this.data = data;
     }
 
+    /**
+     * DataBase64 is the base64-encoded string of the actual event's body posted to the sink. Default is empty. Mutually exclusive with Data.
+     */
     @JsonProperty("dataBase64")
     public String getDataBase64() {
         return dataBase64;
     }
 
+    /**
+     * DataBase64 is the base64-encoded string of the actual event's body posted to the sink. Default is empty. Mutually exclusive with Data.
+     */
     @JsonProperty("dataBase64")
     public void setDataBase64(String dataBase64) {
         this.dataBase64 = dataBase64;
     }
 
+    /**
+     * Schedule is the cron schedule. Defaults to `&#42; &#42; &#42; &#42; &#42;`.
+     */
     @JsonProperty("schedule")
     public String getSchedule() {
         return schedule;
     }
 
+    /**
+     * Schedule is the cron schedule. Defaults to `&#42; &#42; &#42; &#42; &#42;`.
+     */
     @JsonProperty("schedule")
     public void setSchedule(String schedule) {
         this.schedule = schedule;
     }
 
+    /**
+     * PingSourceSpec defines the desired state of the PingSource.
+     */
     @JsonProperty("sink")
     public Destination getSink() {
         return sink;
     }
 
+    /**
+     * PingSourceSpec defines the desired state of the PingSource.
+     */
     @JsonProperty("sink")
     public void setSink(Destination sink) {
         this.sink = sink;
     }
 
+    /**
+     * Timezone modifies the actual time relative to the specified timezone. Defaults to the system time zone. More general information about time zones: https://www.iana.org/time-zones List of valid timezone values: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+     */
     @JsonProperty("timezone")
     public String getTimezone() {
         return timezone;
     }
 
+    /**
+     * Timezone modifies the actual time relative to the specified timezone. Defaults to the system time zone. More general information about time zones: https://www.iana.org/time-zones List of valid timezone values: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+     */
     @JsonProperty("timezone")
     public void setTimezone(String timezone) {
         this.timezone = timezone;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/PingSourceStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/PingSourceStatus.java
index 4bd14b345fd..ad242768660 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/PingSourceStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/PingSourceStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PingSourceStatus defines the observed state of PingSource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -114,84 +117,132 @@ public PingSourceStatus(Map<String, String> annotations, AuthStatus auth, List<C
         this.sinkUri = sinkUri;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * PingSourceStatus defines the observed state of PingSource.
+     */
     @JsonProperty("auth")
     public AuthStatus getAuth() {
         return auth;
     }
 
+    /**
+     * PingSourceStatus defines the observed state of PingSource.
+     */
     @JsonProperty("auth")
     public void setAuth(AuthStatus auth) {
         this.auth = auth;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CloudEventAttributes> getCeAttributes() {
         return ceAttributes;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     public void setCeAttributes(List<CloudEventAttributes> ceAttributes) {
         this.ceAttributes = ceAttributes;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public String getSinkAudience() {
         return sinkAudience;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public void setSinkAudience(String sinkAudience) {
         this.sinkAudience = sinkAudience;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public String getSinkCACerts() {
         return sinkCACerts;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public void setSinkCACerts(String sinkCACerts) {
         this.sinkCACerts = sinkCACerts;
     }
 
+    /**
+     * PingSourceStatus defines the observed state of PingSource.
+     */
     @JsonProperty("sinkUri")
     public String getSinkUri() {
         return sinkUri;
     }
 
+    /**
+     * PingSourceStatus defines the observed state of PingSource.
+     */
     @JsonProperty("sinkUri")
     public void setSinkUri(String sinkUri) {
         this.sinkUri = sinkUri;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/SinkBinding.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/SinkBinding.java
index eb7da66444a..18fd2014df5 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/SinkBinding.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/SinkBinding.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SinkBinding describes a Binding that is also a Source. The `sink` (from the Source duck) is resolved to a URL and then projected into the `subject` by augmenting the runtime contract of the referenced containers to have a `K_SINK` environment variable holding the endpoint to which to send cloud events.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class SinkBinding implements Editable<SinkBindingBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sources.knative.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SinkBinding";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public SinkBinding(String apiVersion, String kind, ObjectMeta metadata, SinkBind
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SinkBinding describes a Binding that is also a Source. The `sink` (from the Source duck) is resolved to a URL and then projected into the `subject` by augmenting the runtime contract of the referenced containers to have a `K_SINK` environment variable holding the endpoint to which to send cloud events.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SinkBinding describes a Binding that is also a Source. The `sink` (from the Source duck) is resolved to a URL and then projected into the `subject` by augmenting the runtime contract of the referenced containers to have a `K_SINK` environment variable holding the endpoint to which to send cloud events.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * SinkBinding describes a Binding that is also a Source. The `sink` (from the Source duck) is resolved to a URL and then projected into the `subject` by augmenting the runtime contract of the referenced containers to have a `K_SINK` environment variable holding the endpoint to which to send cloud events.
+     */
     @JsonProperty("spec")
     public SinkBindingSpec getSpec() {
         return spec;
     }
 
+    /**
+     * SinkBinding describes a Binding that is also a Source. The `sink` (from the Source duck) is resolved to a URL and then projected into the `subject` by augmenting the runtime contract of the referenced containers to have a `K_SINK` environment variable holding the endpoint to which to send cloud events.
+     */
     @JsonProperty("spec")
     public void setSpec(SinkBindingSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * SinkBinding describes a Binding that is also a Source. The `sink` (from the Source duck) is resolved to a URL and then projected into the `subject` by augmenting the runtime contract of the referenced containers to have a `K_SINK` environment variable holding the endpoint to which to send cloud events.
+     */
     @JsonProperty("status")
     public SinkBindingStatus getStatus() {
         return status;
     }
 
+    /**
+     * SinkBinding describes a Binding that is also a Source. The `sink` (from the Source duck) is resolved to a URL and then projected into the `subject` by augmenting the runtime contract of the referenced containers to have a `K_SINK` environment variable holding the endpoint to which to send cloud events.
+     */
     @JsonProperty("status")
     public void setStatus(SinkBindingStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/SinkBindingList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/SinkBindingList.java
index cf93d8c424d..f6104a2b7b0 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/SinkBindingList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/SinkBindingList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SinkBindingList contains a list of SinkBinding
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class SinkBindingList implements Editable<SinkBindingListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.sources.v1.SinkBinding>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sources.knative.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.sources.v1.SinkBinding> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SinkBindingList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public SinkBindingList(String apiVersion, List<io.fabric8.knative.sources.v1.Sin
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * SinkBindingList contains a list of SinkBinding
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.sources.v1.SinkBinding> getItems() {
         return items;
     }
 
+    /**
+     * SinkBindingList contains a list of SinkBinding
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.sources.v1.SinkBinding> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SinkBindingList contains a list of SinkBinding
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SinkBindingList contains a list of SinkBinding
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/SinkBindingSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/SinkBindingSpec.java
index 5cd3cf199dd..e559d06c104 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/SinkBindingSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/SinkBindingSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SinkBindingSpec holds the desired state of the SinkBinding (from the client).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,31 +92,49 @@ public SinkBindingSpec(CloudEventOverrides ceOverrides, Destination sink, Refere
         this.subject = subject;
     }
 
+    /**
+     * SinkBindingSpec holds the desired state of the SinkBinding (from the client).
+     */
     @JsonProperty("ceOverrides")
     public CloudEventOverrides getCeOverrides() {
         return ceOverrides;
     }
 
+    /**
+     * SinkBindingSpec holds the desired state of the SinkBinding (from the client).
+     */
     @JsonProperty("ceOverrides")
     public void setCeOverrides(CloudEventOverrides ceOverrides) {
         this.ceOverrides = ceOverrides;
     }
 
+    /**
+     * SinkBindingSpec holds the desired state of the SinkBinding (from the client).
+     */
     @JsonProperty("sink")
     public Destination getSink() {
         return sink;
     }
 
+    /**
+     * SinkBindingSpec holds the desired state of the SinkBinding (from the client).
+     */
     @JsonProperty("sink")
     public void setSink(Destination sink) {
         this.sink = sink;
     }
 
+    /**
+     * SinkBindingSpec holds the desired state of the SinkBinding (from the client).
+     */
     @JsonProperty("subject")
     public Reference getSubject() {
         return subject;
     }
 
+    /**
+     * SinkBindingSpec holds the desired state of the SinkBinding (from the client).
+     */
     @JsonProperty("subject")
     public void setSubject(Reference subject) {
         this.subject = subject;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/SinkBindingStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/SinkBindingStatus.java
index 20169ae90d3..678791529e8 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/SinkBindingStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1/SinkBindingStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SinkBindingStatus communicates the observed state of the SinkBinding (from the controller).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -118,94 +121,148 @@ public SinkBindingStatus(Map<String, String> annotations, AuthStatus auth, List<
         this.sinkUri = sinkUri;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * SinkBindingStatus communicates the observed state of the SinkBinding (from the controller).
+     */
     @JsonProperty("auth")
     public AuthStatus getAuth() {
         return auth;
     }
 
+    /**
+     * SinkBindingStatus communicates the observed state of the SinkBinding (from the controller).
+     */
     @JsonProperty("auth")
     public void setAuth(AuthStatus auth) {
         this.auth = auth;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CloudEventAttributes> getCeAttributes() {
         return ceAttributes;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     public void setCeAttributes(List<CloudEventAttributes> ceAttributes) {
         this.ceAttributes = ceAttributes;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * OIDCTokenSecretName is the name of the secret containing the token for this SinkBindings OIDC authentication
+     */
     @JsonProperty("oidcTokenSecretName")
     public String getOidcTokenSecretName() {
         return oidcTokenSecretName;
     }
 
+    /**
+     * OIDCTokenSecretName is the name of the secret containing the token for this SinkBindings OIDC authentication
+     */
     @JsonProperty("oidcTokenSecretName")
     public void setOidcTokenSecretName(String oidcTokenSecretName) {
         this.oidcTokenSecretName = oidcTokenSecretName;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public String getSinkAudience() {
         return sinkAudience;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public void setSinkAudience(String sinkAudience) {
         this.sinkAudience = sinkAudience;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public String getSinkCACerts() {
         return sinkCACerts;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public void setSinkCACerts(String sinkCACerts) {
         this.sinkCACerts = sinkCACerts;
     }
 
+    /**
+     * SinkBindingStatus communicates the observed state of the SinkBinding (from the controller).
+     */
     @JsonProperty("sinkUri")
     public String getSinkUri() {
         return sinkUri;
     }
 
+    /**
+     * SinkBindingStatus communicates the observed state of the SinkBinding (from the controller).
+     */
     @JsonProperty("sinkUri")
     public void setSinkUri(String sinkUri) {
         this.sinkUri = sinkUri;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/AwsSqsSource.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/AwsSqsSource.java
index 4a4bb2ec879..6fe1aa5fbcf 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/AwsSqsSource.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/AwsSqsSource.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AwsSqsSource is the Schema for the AWS SQS API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class AwsSqsSource implements Editable<AwsSqsSourceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sources.knative.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AwsSqsSource";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public AwsSqsSource(String apiVersion, String kind, ObjectMeta metadata, AwsSqsS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AwsSqsSource is the Schema for the AWS SQS API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AwsSqsSource is the Schema for the AWS SQS API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * AwsSqsSource is the Schema for the AWS SQS API
+     */
     @JsonProperty("spec")
     public AwsSqsSourceSpec getSpec() {
         return spec;
     }
 
+    /**
+     * AwsSqsSource is the Schema for the AWS SQS API
+     */
     @JsonProperty("spec")
     public void setSpec(AwsSqsSourceSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * AwsSqsSource is the Schema for the AWS SQS API
+     */
     @JsonProperty("status")
     public AwsSqsSourceStatus getStatus() {
         return status;
     }
 
+    /**
+     * AwsSqsSource is the Schema for the AWS SQS API
+     */
     @JsonProperty("status")
     public void setStatus(AwsSqsSourceStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/AwsSqsSourceList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/AwsSqsSourceList.java
index c353f3296c7..b7fb91e1852 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/AwsSqsSourceList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/AwsSqsSourceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AwsSqsSourceList contains a list of AwsSqsSource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class AwsSqsSourceList implements Editable<AwsSqsSourceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.sources.v1alpha1.AwsSqsSource>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sources.knative.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.sources.v1alpha1.AwsSqsSource> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AwsSqsSourceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public AwsSqsSourceList(String apiVersion, List<io.fabric8.knative.sources.v1alp
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * AwsSqsSourceList contains a list of AwsSqsSource
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.sources.v1alpha1.AwsSqsSource> getItems() {
         return items;
     }
 
+    /**
+     * AwsSqsSourceList contains a list of AwsSqsSource
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.sources.v1alpha1.AwsSqsSource> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AwsSqsSourceList contains a list of AwsSqsSource
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AwsSqsSourceList contains a list of AwsSqsSource
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/AwsSqsSourceSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/AwsSqsSourceSpec.java
index 7729dadccf3..d2b7dffde44 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/AwsSqsSourceSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/AwsSqsSourceSpec.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AwsSqsSourceSpec defines the desired state of the source.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -96,52 +99,82 @@ public AwsSqsSourceSpec(Map<String, String> annotations, SecretKeySelector awsCr
         this.sink = sink;
     }
 
+    /**
+     * Annotations to add to the pod, mostly used for Kube2IAM role
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations to add to the pod, mostly used for Kube2IAM role
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * AwsSqsSourceSpec defines the desired state of the source.
+     */
     @JsonProperty("awsCredsSecret")
     public SecretKeySelector getAwsCredsSecret() {
         return awsCredsSecret;
     }
 
+    /**
+     * AwsSqsSourceSpec defines the desired state of the source.
+     */
     @JsonProperty("awsCredsSecret")
     public void setAwsCredsSecret(SecretKeySelector awsCredsSecret) {
         this.awsCredsSecret = awsCredsSecret;
     }
 
+    /**
+     * QueueURL of the SQS queue that we will poll from.
+     */
     @JsonProperty("queueUrl")
     public String getQueueUrl() {
         return queueUrl;
     }
 
+    /**
+     * QueueURL of the SQS queue that we will poll from.
+     */
     @JsonProperty("queueUrl")
     public void setQueueUrl(String queueUrl) {
         this.queueUrl = queueUrl;
     }
 
+    /**
+     * ServiceAccoutName is the name of the ServiceAccount that will be used to run the Receive Adapter Deployment.
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * ServiceAccoutName is the name of the ServiceAccount that will be used to run the Receive Adapter Deployment.
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * AwsSqsSourceSpec defines the desired state of the source.
+     */
     @JsonProperty("sink")
     public ObjectReference getSink() {
         return sink;
     }
 
+    /**
+     * AwsSqsSourceSpec defines the desired state of the source.
+     */
     @JsonProperty("sink")
     public void setSink(ObjectReference sink) {
         this.sink = sink;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/AwsSqsSourceStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/AwsSqsSourceStatus.java
index 0e000428c21..902f3d97e5d 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/AwsSqsSourceStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/AwsSqsSourceStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AwsSqsSourceStatus defines the observed state of the source.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -114,84 +117,132 @@ public AwsSqsSourceStatus(Map<String, String> annotations, AuthStatus auth, List
         this.sinkUri = sinkUri;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * AwsSqsSourceStatus defines the observed state of the source.
+     */
     @JsonProperty("auth")
     public AuthStatus getAuth() {
         return auth;
     }
 
+    /**
+     * AwsSqsSourceStatus defines the observed state of the source.
+     */
     @JsonProperty("auth")
     public void setAuth(AuthStatus auth) {
         this.auth = auth;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CloudEventAttributes> getCeAttributes() {
         return ceAttributes;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     public void setCeAttributes(List<CloudEventAttributes> ceAttributes) {
         this.ceAttributes = ceAttributes;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public String getSinkAudience() {
         return sinkAudience;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public void setSinkAudience(String sinkAudience) {
         this.sinkAudience = sinkAudience;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public String getSinkCACerts() {
         return sinkCACerts;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public void setSinkCACerts(String sinkCACerts) {
         this.sinkCACerts = sinkCACerts;
     }
 
+    /**
+     * AwsSqsSourceStatus defines the observed state of the source.
+     */
     @JsonProperty("sinkUri")
     public String getSinkUri() {
         return sinkUri;
     }
 
+    /**
+     * AwsSqsSourceStatus defines the observed state of the source.
+     */
     @JsonProperty("sinkUri")
     public void setSinkUri(String sinkUri) {
         this.sinkUri = sinkUri;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/CouchDbSource.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/CouchDbSource.java
index 8c1b572988f..6a9524b3f6a 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/CouchDbSource.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/CouchDbSource.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CouchDbSource is the Schema for the githubsources API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class CouchDbSource implements Editable<CouchDbSourceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sources.knative.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CouchDbSource";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CouchDbSource(String apiVersion, String kind, ObjectMeta metadata, CouchD
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CouchDbSource is the Schema for the githubsources API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CouchDbSource is the Schema for the githubsources API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * CouchDbSource is the Schema for the githubsources API
+     */
     @JsonProperty("spec")
     public CouchDbSourceSpec getSpec() {
         return spec;
     }
 
+    /**
+     * CouchDbSource is the Schema for the githubsources API
+     */
     @JsonProperty("spec")
     public void setSpec(CouchDbSourceSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * CouchDbSource is the Schema for the githubsources API
+     */
     @JsonProperty("status")
     public CouchDbSourceStatus getStatus() {
         return status;
     }
 
+    /**
+     * CouchDbSource is the Schema for the githubsources API
+     */
     @JsonProperty("status")
     public void setStatus(CouchDbSourceStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/CouchDbSourceList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/CouchDbSourceList.java
index 1b2df6cfee5..43bdba8e8b7 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/CouchDbSourceList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/CouchDbSourceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CouchDbSourceList contains a list of CouchDbSource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class CouchDbSourceList implements Editable<CouchDbSourceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.sources.v1alpha1.CouchDbSource>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sources.knative.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.sources.v1alpha1.CouchDbSource> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CouchDbSourceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CouchDbSourceList(String apiVersion, List<io.fabric8.knative.sources.v1al
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * CouchDbSourceList contains a list of CouchDbSource
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.sources.v1alpha1.CouchDbSource> getItems() {
         return items;
     }
 
+    /**
+     * CouchDbSourceList contains a list of CouchDbSource
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.sources.v1alpha1.CouchDbSource> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CouchDbSourceList contains a list of CouchDbSource
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CouchDbSourceList contains a list of CouchDbSource
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/CouchDbSourceSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/CouchDbSourceSpec.java
index 9e8e9c77403..78943540cfd 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/CouchDbSourceSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/CouchDbSourceSpec.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CouchDbSourceSpec defines the desired state of CouchDbSource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,51 +98,81 @@ public CouchDbSourceSpec(ObjectReference credentials, String database, String fe
         this.sink = sink;
     }
 
+    /**
+     * CouchDbSourceSpec defines the desired state of CouchDbSource
+     */
     @JsonProperty("credentials")
     public ObjectReference getCredentials() {
         return credentials;
     }
 
+    /**
+     * CouchDbSourceSpec defines the desired state of CouchDbSource
+     */
     @JsonProperty("credentials")
     public void setCredentials(ObjectReference credentials) {
         this.credentials = credentials;
     }
 
+    /**
+     * Database is the database to watch for changes
+     */
     @JsonProperty("database")
     public String getDatabase() {
         return database;
     }
 
+    /**
+     * Database is the database to watch for changes
+     */
     @JsonProperty("database")
     public void setDatabase(String database) {
         this.database = database;
     }
 
+    /**
+     * Feed changes how CouchDB sends the response. More information: https://docs.couchdb.org/en/stable/api/database/changes.html#changes-feeds
+     */
     @JsonProperty("feed")
     public String getFeed() {
         return feed;
     }
 
+    /**
+     * Feed changes how CouchDB sends the response. More information: https://docs.couchdb.org/en/stable/api/database/changes.html#changes-feeds
+     */
     @JsonProperty("feed")
     public void setFeed(String feed) {
         this.feed = feed;
     }
 
+    /**
+     * ServiceAccountName holds the name of the Kubernetes service account as which the underlying K8s resources should be run. If unspecified this will default to the "default" service account for the namespace in which the CouchDbSource exists.
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * ServiceAccountName holds the name of the Kubernetes service account as which the underlying K8s resources should be run. If unspecified this will default to the "default" service account for the namespace in which the CouchDbSource exists.
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * CouchDbSourceSpec defines the desired state of CouchDbSource
+     */
     @JsonProperty("sink")
     public Destination getSink() {
         return sink;
     }
 
+    /**
+     * CouchDbSourceSpec defines the desired state of CouchDbSource
+     */
     @JsonProperty("sink")
     public void setSink(Destination sink) {
         this.sink = sink;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/CouchDbSourceStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/CouchDbSourceStatus.java
index 793314c955f..fc0603c62bb 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/CouchDbSourceStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/CouchDbSourceStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CouchDbSourceStatus defines the observed state of CouchDbSource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -114,84 +117,132 @@ public CouchDbSourceStatus(Map<String, String> annotations, AuthStatus auth, Lis
         this.sinkUri = sinkUri;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * CouchDbSourceStatus defines the observed state of CouchDbSource
+     */
     @JsonProperty("auth")
     public AuthStatus getAuth() {
         return auth;
     }
 
+    /**
+     * CouchDbSourceStatus defines the observed state of CouchDbSource
+     */
     @JsonProperty("auth")
     public void setAuth(AuthStatus auth) {
         this.auth = auth;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CloudEventAttributes> getCeAttributes() {
         return ceAttributes;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     public void setCeAttributes(List<CloudEventAttributes> ceAttributes) {
         this.ceAttributes = ceAttributes;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public String getSinkAudience() {
         return sinkAudience;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public void setSinkAudience(String sinkAudience) {
         this.sinkAudience = sinkAudience;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public String getSinkCACerts() {
         return sinkCACerts;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public void setSinkCACerts(String sinkCACerts) {
         this.sinkCACerts = sinkCACerts;
     }
 
+    /**
+     * CouchDbSourceStatus defines the observed state of CouchDbSource
+     */
     @JsonProperty("sinkUri")
     public String getSinkUri() {
         return sinkUri;
     }
 
+    /**
+     * CouchDbSourceStatus defines the observed state of CouchDbSource
+     */
     @JsonProperty("sinkUri")
     public void setSinkUri(String sinkUri) {
         this.sinkUri = sinkUri;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitHubSource.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitHubSource.java
index 9a24f23a2eb..d4ee0113d3f 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitHubSource.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitHubSource.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GitHubSource is the Schema for the githubsources API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class GitHubSource implements Editable<GitHubSourceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sources.knative.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GitHubSource";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public GitHubSource(String apiVersion, String kind, ObjectMeta metadata, GitHubS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * GitHubSource is the Schema for the githubsources API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * GitHubSource is the Schema for the githubsources API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * GitHubSource is the Schema for the githubsources API
+     */
     @JsonProperty("spec")
     public GitHubSourceSpec getSpec() {
         return spec;
     }
 
+    /**
+     * GitHubSource is the Schema for the githubsources API
+     */
     @JsonProperty("spec")
     public void setSpec(GitHubSourceSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * GitHubSource is the Schema for the githubsources API
+     */
     @JsonProperty("status")
     public GitHubSourceStatus getStatus() {
         return status;
     }
 
+    /**
+     * GitHubSource is the Schema for the githubsources API
+     */
     @JsonProperty("status")
     public void setStatus(GitHubSourceStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitHubSourceList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitHubSourceList.java
index 9aa10e2cbce..6d5a7e3f1d8 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitHubSourceList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitHubSourceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GitHubSourceList contains a list of GitHubSource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class GitHubSourceList implements Editable<GitHubSourceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.sources.v1alpha1.GitHubSource>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sources.knative.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.sources.v1alpha1.GitHubSource> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GitHubSourceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public GitHubSourceList(String apiVersion, List<io.fabric8.knative.sources.v1alp
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * GitHubSourceList contains a list of GitHubSource
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.sources.v1alpha1.GitHubSource> getItems() {
         return items;
     }
 
+    /**
+     * GitHubSourceList contains a list of GitHubSource
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.sources.v1alpha1.GitHubSource> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * GitHubSourceList contains a list of GitHubSource
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * GitHubSourceList contains a list of GitHubSource
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitHubSourceSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitHubSourceSpec.java
index 4487a8c9f4b..83ec7741b62 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitHubSourceSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitHubSourceSpec.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GitHubSourceSpec defines the desired state of GitHubSource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -115,92 +118,146 @@ public GitHubSourceSpec(SecretValueFromSource accessToken, CloudEventOverrides c
         this.sink = sink;
     }
 
+    /**
+     * GitHubSourceSpec defines the desired state of GitHubSource
+     */
     @JsonProperty("accessToken")
     public SecretValueFromSource getAccessToken() {
         return accessToken;
     }
 
+    /**
+     * GitHubSourceSpec defines the desired state of GitHubSource
+     */
     @JsonProperty("accessToken")
     public void setAccessToken(SecretValueFromSource accessToken) {
         this.accessToken = accessToken;
     }
 
+    /**
+     * GitHubSourceSpec defines the desired state of GitHubSource
+     */
     @JsonProperty("ceOverrides")
     public CloudEventOverrides getCeOverrides() {
         return ceOverrides;
     }
 
+    /**
+     * GitHubSourceSpec defines the desired state of GitHubSource
+     */
     @JsonProperty("ceOverrides")
     public void setCeOverrides(CloudEventOverrides ceOverrides) {
         this.ceOverrides = ceOverrides;
     }
 
+    /**
+     * EventType is the type of event to receive from GitHub. These correspond to the "Webhook event name" values listed at https://developer.github.com/v3/activity/events/types/ - ie "pull_request"
+     */
     @JsonProperty("eventTypes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEventTypes() {
         return eventTypes;
     }
 
+    /**
+     * EventType is the type of event to receive from GitHub. These correspond to the "Webhook event name" values listed at https://developer.github.com/v3/activity/events/types/ - ie "pull_request"
+     */
     @JsonProperty("eventTypes")
     public void setEventTypes(List<String> eventTypes) {
         this.eventTypes = eventTypes;
     }
 
+    /**
+     * API URL if using github enterprise (default https://api.github.com)
+     */
     @JsonProperty("githubAPIURL")
     public String getGithubAPIURL() {
         return githubAPIURL;
     }
 
+    /**
+     * API URL if using github enterprise (default https://api.github.com)
+     */
     @JsonProperty("githubAPIURL")
     public void setGithubAPIURL(String githubAPIURL) {
         this.githubAPIURL = githubAPIURL;
     }
 
+    /**
+     * OwnerAndRepository is the GitHub owner/org and repository to receive events from. The repository may be left off to receive events from an entire organization. Examples:<br><p>  myuser/project<br><p>  myorganization
+     */
     @JsonProperty("ownerAndRepository")
     public String getOwnerAndRepository() {
         return ownerAndRepository;
     }
 
+    /**
+     * OwnerAndRepository is the GitHub owner/org and repository to receive events from. The repository may be left off to receive events from an entire organization. Examples:<br><p>  myuser/project<br><p>  myorganization
+     */
     @JsonProperty("ownerAndRepository")
     public void setOwnerAndRepository(String ownerAndRepository) {
         this.ownerAndRepository = ownerAndRepository;
     }
 
+    /**
+     * GitHubSourceSpec defines the desired state of GitHubSource
+     */
     @JsonProperty("secretToken")
     public SecretValueFromSource getSecretToken() {
         return secretToken;
     }
 
+    /**
+     * GitHubSourceSpec defines the desired state of GitHubSource
+     */
     @JsonProperty("secretToken")
     public void setSecretToken(SecretValueFromSource secretToken) {
         this.secretToken = secretToken;
     }
 
+    /**
+     * Secure can be set to true to configure the webhook to use https, or false to use http.  Omitting it relies on the scheme of the Knative Service created (e.g. if auto-TLS is enabled it should do the right thing).
+     */
     @JsonProperty("secure")
     public Boolean getSecure() {
         return secure;
     }
 
+    /**
+     * Secure can be set to true to configure the webhook to use https, or false to use http.  Omitting it relies on the scheme of the Knative Service created (e.g. if auto-TLS is enabled it should do the right thing).
+     */
     @JsonProperty("secure")
     public void setSecure(Boolean secure) {
         this.secure = secure;
     }
 
+    /**
+     * ServiceAccountName holds the name of the Kubernetes service account as which the underlying K8s resources should be run. If unspecified this will default to the "default" service account for the namespace in which the GitHubSource exists.
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * ServiceAccountName holds the name of the Kubernetes service account as which the underlying K8s resources should be run. If unspecified this will default to the "default" service account for the namespace in which the GitHubSource exists.
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * GitHubSourceSpec defines the desired state of GitHubSource
+     */
     @JsonProperty("sink")
     public Destination getSink() {
         return sink;
     }
 
+    /**
+     * GitHubSourceSpec defines the desired state of GitHubSource
+     */
     @JsonProperty("sink")
     public void setSink(Destination sink) {
         this.sink = sink;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitHubSourceStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitHubSourceStatus.java
index 41707ba7872..3d244142169 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitHubSourceStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitHubSourceStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GitHubSourceStatus defines the observed state of GitHubSource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -118,94 +121,148 @@ public GitHubSourceStatus(Map<String, String> annotations, AuthStatus auth, List
         this.webhookIDKey = webhookIDKey;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * GitHubSourceStatus defines the observed state of GitHubSource
+     */
     @JsonProperty("auth")
     public AuthStatus getAuth() {
         return auth;
     }
 
+    /**
+     * GitHubSourceStatus defines the observed state of GitHubSource
+     */
     @JsonProperty("auth")
     public void setAuth(AuthStatus auth) {
         this.auth = auth;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CloudEventAttributes> getCeAttributes() {
         return ceAttributes;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     public void setCeAttributes(List<CloudEventAttributes> ceAttributes) {
         this.ceAttributes = ceAttributes;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public String getSinkAudience() {
         return sinkAudience;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public void setSinkAudience(String sinkAudience) {
         this.sinkAudience = sinkAudience;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public String getSinkCACerts() {
         return sinkCACerts;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public void setSinkCACerts(String sinkCACerts) {
         this.sinkCACerts = sinkCACerts;
     }
 
+    /**
+     * GitHubSourceStatus defines the observed state of GitHubSource
+     */
     @JsonProperty("sinkUri")
     public String getSinkUri() {
         return sinkUri;
     }
 
+    /**
+     * GitHubSourceStatus defines the observed state of GitHubSource
+     */
     @JsonProperty("sinkUri")
     public void setSinkUri(String sinkUri) {
         this.sinkUri = sinkUri;
     }
 
+    /**
+     * WebhookIDKey is the ID of the webhook registered with GitHub
+     */
     @JsonProperty("webhookIDKey")
     public String getWebhookIDKey() {
         return webhookIDKey;
     }
 
+    /**
+     * WebhookIDKey is the ID of the webhook registered with GitHub
+     */
     @JsonProperty("webhookIDKey")
     public void setWebhookIDKey(String webhookIDKey) {
         this.webhookIDKey = webhookIDKey;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitLabSource.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitLabSource.java
index 2460037b62f..ab389761aa8 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitLabSource.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitLabSource.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GitLabSource is the Schema for the gitlabsources API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class GitLabSource implements Editable<GitLabSourceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sources.knative.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GitLabSource";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public GitLabSource(String apiVersion, String kind, ObjectMeta metadata, GitLabS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * GitLabSource is the Schema for the gitlabsources API.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * GitLabSource is the Schema for the gitlabsources API.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * GitLabSource is the Schema for the gitlabsources API.
+     */
     @JsonProperty("spec")
     public GitLabSourceSpec getSpec() {
         return spec;
     }
 
+    /**
+     * GitLabSource is the Schema for the gitlabsources API.
+     */
     @JsonProperty("spec")
     public void setSpec(GitLabSourceSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * GitLabSource is the Schema for the gitlabsources API.
+     */
     @JsonProperty("status")
     public GitLabSourceStatus getStatus() {
         return status;
     }
 
+    /**
+     * GitLabSource is the Schema for the gitlabsources API.
+     */
     @JsonProperty("status")
     public void setStatus(GitLabSourceStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitLabSourceList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitLabSourceList.java
index bb586332d14..02d9b8d8640 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitLabSourceList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitLabSourceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GitLabSourceList contains a list of GitLabSource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class GitLabSourceList implements Editable<GitLabSourceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.sources.v1alpha1.GitLabSource>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sources.knative.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.sources.v1alpha1.GitLabSource> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GitLabSourceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public GitLabSourceList(String apiVersion, List<io.fabric8.knative.sources.v1alp
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * GitLabSourceList contains a list of GitLabSource.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.sources.v1alpha1.GitLabSource> getItems() {
         return items;
     }
 
+    /**
+     * GitLabSourceList contains a list of GitLabSource.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.sources.v1alpha1.GitLabSource> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * GitLabSourceList contains a list of GitLabSource.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * GitLabSourceList contains a list of GitLabSource.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitLabSourceSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitLabSourceSpec.java
index daadb7cc895..dd12f2a11e6 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitLabSourceSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitLabSourceSpec.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GitLabSourceSpec defines the desired state of GitLabSource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -111,82 +114,130 @@ public GitLabSourceSpec(SecretValueFromSource accessToken, CloudEventOverrides c
         this.sslverify = sslverify;
     }
 
+    /**
+     * GitLabSourceSpec defines the desired state of GitLabSource
+     */
     @JsonProperty("accessToken")
     public SecretValueFromSource getAccessToken() {
         return accessToken;
     }
 
+    /**
+     * GitLabSourceSpec defines the desired state of GitLabSource
+     */
     @JsonProperty("accessToken")
     public void setAccessToken(SecretValueFromSource accessToken) {
         this.accessToken = accessToken;
     }
 
+    /**
+     * GitLabSourceSpec defines the desired state of GitLabSource
+     */
     @JsonProperty("ceOverrides")
     public CloudEventOverrides getCeOverrides() {
         return ceOverrides;
     }
 
+    /**
+     * GitLabSourceSpec defines the desired state of GitLabSource
+     */
     @JsonProperty("ceOverrides")
     public void setCeOverrides(CloudEventOverrides ceOverrides) {
         this.ceOverrides = ceOverrides;
     }
 
+    /**
+     * List of webhooks to enable on the selected GitLab project. Those correspond to the attributes enumerated at https://docs.gitlab.com/ee/api/projects.html#add-project-hook
+     */
     @JsonProperty("eventTypes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEventTypes() {
         return eventTypes;
     }
 
+    /**
+     * List of webhooks to enable on the selected GitLab project. Those correspond to the attributes enumerated at https://docs.gitlab.com/ee/api/projects.html#add-project-hook
+     */
     @JsonProperty("eventTypes")
     public void setEventTypes(List<String> eventTypes) {
         this.eventTypes = eventTypes;
     }
 
+    /**
+     * ProjectURL is the url of the GitLab project for which we are interested to receive events from. Examples:<br><p>   https://gitlab.com/gitlab-org/gitlab-foss
+     */
     @JsonProperty("projectUrl")
     public String getProjectUrl() {
         return projectUrl;
     }
 
+    /**
+     * ProjectURL is the url of the GitLab project for which we are interested to receive events from. Examples:<br><p>   https://gitlab.com/gitlab-org/gitlab-foss
+     */
     @JsonProperty("projectUrl")
     public void setProjectUrl(String projectUrl) {
         this.projectUrl = projectUrl;
     }
 
+    /**
+     * GitLabSourceSpec defines the desired state of GitLabSource
+     */
     @JsonProperty("secretToken")
     public SecretValueFromSource getSecretToken() {
         return secretToken;
     }
 
+    /**
+     * GitLabSourceSpec defines the desired state of GitLabSource
+     */
     @JsonProperty("secretToken")
     public void setSecretToken(SecretValueFromSource secretToken) {
         this.secretToken = secretToken;
     }
 
+    /**
+     * ServiceAccountName holds the name of the Kubernetes service account as which the underlying K8s resources should be run. If unspecified this will default to the "default" service account for the namespace in which the GitLabSource exists.
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * ServiceAccountName holds the name of the Kubernetes service account as which the underlying K8s resources should be run. If unspecified this will default to the "default" service account for the namespace in which the GitLabSource exists.
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * GitLabSourceSpec defines the desired state of GitLabSource
+     */
     @JsonProperty("sink")
     public Destination getSink() {
         return sink;
     }
 
+    /**
+     * GitLabSourceSpec defines the desired state of GitLabSource
+     */
     @JsonProperty("sink")
     public void setSink(Destination sink) {
         this.sink = sink;
     }
 
+    /**
+     * SSLVerify if true configure webhook so the ssl verification is done when triggering the hook
+     */
     @JsonProperty("sslverify")
     public Boolean getSslverify() {
         return sslverify;
     }
 
+    /**
+     * SSLVerify if true configure webhook so the ssl verification is done when triggering the hook
+     */
     @JsonProperty("sslverify")
     public void setSslverify(Boolean sslverify) {
         this.sslverify = sslverify;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitLabSourceStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitLabSourceStatus.java
index 0144ae6b7ac..b988a2520da 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitLabSourceStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/GitLabSourceStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GitLabSourceStatus defines the observed state of GitLabSource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -118,94 +121,148 @@ public GitLabSourceStatus(Map<String, String> annotations, AuthStatus auth, List
         this.webhookID = webhookID;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * GitLabSourceStatus defines the observed state of GitLabSource
+     */
     @JsonProperty("auth")
     public AuthStatus getAuth() {
         return auth;
     }
 
+    /**
+     * GitLabSourceStatus defines the observed state of GitLabSource
+     */
     @JsonProperty("auth")
     public void setAuth(AuthStatus auth) {
         this.auth = auth;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CloudEventAttributes> getCeAttributes() {
         return ceAttributes;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     public void setCeAttributes(List<CloudEventAttributes> ceAttributes) {
         this.ceAttributes = ceAttributes;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public String getSinkAudience() {
         return sinkAudience;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public void setSinkAudience(String sinkAudience) {
         this.sinkAudience = sinkAudience;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public String getSinkCACerts() {
         return sinkCACerts;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public void setSinkCACerts(String sinkCACerts) {
         this.sinkCACerts = sinkCACerts;
     }
 
+    /**
+     * GitLabSourceStatus defines the observed state of GitLabSource
+     */
     @JsonProperty("sinkUri")
     public String getSinkUri() {
         return sinkUri;
     }
 
+    /**
+     * GitLabSourceStatus defines the observed state of GitLabSource
+     */
     @JsonProperty("sinkUri")
     public void setSinkUri(String sinkUri) {
         this.sinkUri = sinkUri;
     }
 
+    /**
+     * WebhookID of the project hook registered with GitLab
+     */
     @JsonProperty("webhookID")
     public Integer getWebhookID() {
         return webhookID;
     }
 
+    /**
+     * WebhookID of the project hook registered with GitLab
+     */
     @JsonProperty("webhookID")
     public void setWebhookID(Integer webhookID) {
         this.webhookID = webhookID;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/IntegrationSource.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/IntegrationSource.java
index 92a6e255b10..b1666555a25 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/IntegrationSource.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/IntegrationSource.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IntegrationSource is the Schema for the Integrationsources API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class IntegrationSource implements Editable<IntegrationSourceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sources.knative.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "IntegrationSource";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public IntegrationSource(String apiVersion, String kind, ObjectMeta metadata, In
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * IntegrationSource is the Schema for the Integrationsources API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * IntegrationSource is the Schema for the Integrationsources API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * IntegrationSource is the Schema for the Integrationsources API
+     */
     @JsonProperty("spec")
     public IntegrationSourceSpec getSpec() {
         return spec;
     }
 
+    /**
+     * IntegrationSource is the Schema for the Integrationsources API
+     */
     @JsonProperty("spec")
     public void setSpec(IntegrationSourceSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * IntegrationSource is the Schema for the Integrationsources API
+     */
     @JsonProperty("status")
     public IntegrationSourceStatus getStatus() {
         return status;
     }
 
+    /**
+     * IntegrationSource is the Schema for the Integrationsources API
+     */
     @JsonProperty("status")
     public void setStatus(IntegrationSourceStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/IntegrationSourceList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/IntegrationSourceList.java
index a881dad9271..3117b991366 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/IntegrationSourceList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/IntegrationSourceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IntegrationSourceList contains a list of IntegrationSource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class IntegrationSourceList implements Editable<IntegrationSourceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.sources.v1alpha1.IntegrationSource>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sources.knative.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.sources.v1alpha1.IntegrationSource> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "IntegrationSourceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public IntegrationSourceList(String apiVersion, List<io.fabric8.knative.sources.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * IntegrationSourceList contains a list of IntegrationSource
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.sources.v1alpha1.IntegrationSource> getItems() {
         return items;
     }
 
+    /**
+     * IntegrationSourceList contains a list of IntegrationSource
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.sources.v1alpha1.IntegrationSource> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * IntegrationSourceList contains a list of IntegrationSource
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * IntegrationSourceList contains a list of IntegrationSource
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/IntegrationSourceSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/IntegrationSourceSpec.java
index 07dfeaff5ce..c8d1c51838d 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/IntegrationSourceSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/IntegrationSourceSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IntegrationSourceSpec defines the desired state of IntegrationSource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -92,41 +95,65 @@ public IntegrationSourceSpec(Aws aws, CloudEventOverrides ceOverrides, Destinati
         this.timer = timer;
     }
 
+    /**
+     * IntegrationSourceSpec defines the desired state of IntegrationSource
+     */
     @JsonProperty("aws")
     public Aws getAws() {
         return aws;
     }
 
+    /**
+     * IntegrationSourceSpec defines the desired state of IntegrationSource
+     */
     @JsonProperty("aws")
     public void setAws(Aws aws) {
         this.aws = aws;
     }
 
+    /**
+     * IntegrationSourceSpec defines the desired state of IntegrationSource
+     */
     @JsonProperty("ceOverrides")
     public CloudEventOverrides getCeOverrides() {
         return ceOverrides;
     }
 
+    /**
+     * IntegrationSourceSpec defines the desired state of IntegrationSource
+     */
     @JsonProperty("ceOverrides")
     public void setCeOverrides(CloudEventOverrides ceOverrides) {
         this.ceOverrides = ceOverrides;
     }
 
+    /**
+     * IntegrationSourceSpec defines the desired state of IntegrationSource
+     */
     @JsonProperty("sink")
     public Destination getSink() {
         return sink;
     }
 
+    /**
+     * IntegrationSourceSpec defines the desired state of IntegrationSource
+     */
     @JsonProperty("sink")
     public void setSink(Destination sink) {
         this.sink = sink;
     }
 
+    /**
+     * IntegrationSourceSpec defines the desired state of IntegrationSource
+     */
     @JsonProperty("timer")
     public Timer getTimer() {
         return timer;
     }
 
+    /**
+     * IntegrationSourceSpec defines the desired state of IntegrationSource
+     */
     @JsonProperty("timer")
     public void setTimer(Timer timer) {
         this.timer = timer;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/IntegrationSourceStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/IntegrationSourceStatus.java
index 9a0144d6a3b..d7034cd4661 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/IntegrationSourceStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/IntegrationSourceStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IntegrationSourceStatus defines the observed state of IntegrationSource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -114,84 +117,132 @@ public IntegrationSourceStatus(Map<String, String> annotations, AuthStatus auth,
         this.sinkUri = sinkUri;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * IntegrationSourceStatus defines the observed state of IntegrationSource
+     */
     @JsonProperty("auth")
     public AuthStatus getAuth() {
         return auth;
     }
 
+    /**
+     * IntegrationSourceStatus defines the observed state of IntegrationSource
+     */
     @JsonProperty("auth")
     public void setAuth(AuthStatus auth) {
         this.auth = auth;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CloudEventAttributes> getCeAttributes() {
         return ceAttributes;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     public void setCeAttributes(List<CloudEventAttributes> ceAttributes) {
         this.ceAttributes = ceAttributes;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public String getSinkAudience() {
         return sinkAudience;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public void setSinkAudience(String sinkAudience) {
         this.sinkAudience = sinkAudience;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public String getSinkCACerts() {
         return sinkCACerts;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public void setSinkCACerts(String sinkCACerts) {
         this.sinkCACerts = sinkCACerts;
     }
 
+    /**
+     * IntegrationSourceStatus defines the observed state of IntegrationSource
+     */
     @JsonProperty("sinkUri")
     public String getSinkUri() {
         return sinkUri;
     }
 
+    /**
+     * IntegrationSourceStatus defines the observed state of IntegrationSource
+     */
     @JsonProperty("sinkUri")
     public void setSinkUri(String sinkUri) {
         this.sinkUri = sinkUri;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/PrometheusSource.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/PrometheusSource.java
index 7bdc9355a47..1efe7b1a88b 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/PrometheusSource.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/PrometheusSource.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PrometheusSource is the Schema for the prometheussources API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class PrometheusSource implements Editable<PrometheusSourceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sources.knative.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PrometheusSource";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PrometheusSource(String apiVersion, String kind, ObjectMeta metadata, Pro
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PrometheusSource is the Schema for the prometheussources API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PrometheusSource is the Schema for the prometheussources API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PrometheusSource is the Schema for the prometheussources API
+     */
     @JsonProperty("spec")
     public PrometheusSourceSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PrometheusSource is the Schema for the prometheussources API
+     */
     @JsonProperty("spec")
     public void setSpec(PrometheusSourceSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PrometheusSource is the Schema for the prometheussources API
+     */
     @JsonProperty("status")
     public PrometheusSourceStatus getStatus() {
         return status;
     }
 
+    /**
+     * PrometheusSource is the Schema for the prometheussources API
+     */
     @JsonProperty("status")
     public void setStatus(PrometheusSourceStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/PrometheusSourceList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/PrometheusSourceList.java
index 67fae3a38d3..2671c5d205d 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/PrometheusSourceList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/PrometheusSourceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PrometheusSourceList contains a list of PrometheusSource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PrometheusSourceList implements Editable<PrometheusSourceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.sources.v1alpha1.PrometheusSource>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sources.knative.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.sources.v1alpha1.PrometheusSource> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PrometheusSourceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PrometheusSourceList(String apiVersion, List<io.fabric8.knative.sources.v
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PrometheusSourceList contains a list of PrometheusSource
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.sources.v1alpha1.PrometheusSource> getItems() {
         return items;
     }
 
+    /**
+     * PrometheusSourceList contains a list of PrometheusSource
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.sources.v1alpha1.PrometheusSource> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PrometheusSourceList contains a list of PrometheusSource
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PrometheusSourceList contains a list of PrometheusSource
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/PrometheusSourceSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/PrometheusSourceSpec.java
index d72331beb1b..fd13df5969c 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/PrometheusSourceSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/PrometheusSourceSpec.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PrometheusSourceSpec defines the desired state of PrometheusSource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -107,81 +110,129 @@ public PrometheusSourceSpec(String authTokenFile, String caCertConfigMap, String
         this.step = step;
     }
 
+    /**
+     * The name of the file containing the authenication token
+     */
     @JsonProperty("authTokenFile")
     public String getAuthTokenFile() {
         return authTokenFile;
     }
 
+    /**
+     * The name of the file containing the authenication token
+     */
     @JsonProperty("authTokenFile")
     public void setAuthTokenFile(String authTokenFile) {
         this.authTokenFile = authTokenFile;
     }
 
+    /**
+     * The name of the config map containing the CA certificate of the Prometheus service's signer.
+     */
     @JsonProperty("caCertConfigMap")
     public String getCaCertConfigMap() {
         return caCertConfigMap;
     }
 
+    /**
+     * The name of the config map containing the CA certificate of the Prometheus service's signer.
+     */
     @JsonProperty("caCertConfigMap")
     public void setCaCertConfigMap(String caCertConfigMap) {
         this.caCertConfigMap = caCertConfigMap;
     }
 
+    /**
+     * PromQL is the Prometheus query for this source
+     */
     @JsonProperty("promQL")
     public String getPromQL() {
         return promQL;
     }
 
+    /**
+     * PromQL is the Prometheus query for this source
+     */
     @JsonProperty("promQL")
     public void setPromQL(String promQL) {
         this.promQL = promQL;
     }
 
+    /**
+     * A crontab-formatted schedule for running the PromQL query
+     */
     @JsonProperty("schedule")
     public String getSchedule() {
         return schedule;
     }
 
+    /**
+     * A crontab-formatted schedule for running the PromQL query
+     */
     @JsonProperty("schedule")
     public void setSchedule(String schedule) {
         this.schedule = schedule;
     }
 
+    /**
+     * ServerURL is the URL of the Prometheus server
+     */
     @JsonProperty("serverURL")
     public String getServerURL() {
         return serverURL;
     }
 
+    /**
+     * ServerURL is the URL of the Prometheus server
+     */
     @JsonProperty("serverURL")
     public void setServerURL(String serverURL) {
         this.serverURL = serverURL;
     }
 
+    /**
+     * ServiceAccountName holds the name of the Kubernetes service account as which the underlying K8s resources should be run. If unspecified this will default to the "default" service account for the namespace in which the PrometheusSource exists.
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * ServiceAccountName holds the name of the Kubernetes service account as which the underlying K8s resources should be run. If unspecified this will default to the "default" service account for the namespace in which the PrometheusSource exists.
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * PrometheusSourceSpec defines the desired state of PrometheusSource
+     */
     @JsonProperty("sink")
     public Destination getSink() {
         return sink;
     }
 
+    /**
+     * PrometheusSourceSpec defines the desired state of PrometheusSource
+     */
     @JsonProperty("sink")
     public void setSink(Destination sink) {
         this.sink = sink;
     }
 
+    /**
+     * Query resolution step width in duration format or float number of seconds. Prometheus duration strings are of the form [0-9]+[smhdwy].
+     */
     @JsonProperty("step")
     public String getStep() {
         return step;
     }
 
+    /**
+     * Query resolution step width in duration format or float number of seconds. Prometheus duration strings are of the form [0-9]+[smhdwy].
+     */
     @JsonProperty("step")
     public void setStep(String step) {
         this.step = step;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/PrometheusSourceStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/PrometheusSourceStatus.java
index ac7ddfc2739..0a8b1e71c90 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/PrometheusSourceStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/PrometheusSourceStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PrometheusSourceStatus defines the observed state of PrometheusSource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -114,84 +117,132 @@ public PrometheusSourceStatus(Map<String, String> annotations, AuthStatus auth,
         this.sinkUri = sinkUri;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * PrometheusSourceStatus defines the observed state of PrometheusSource
+     */
     @JsonProperty("auth")
     public AuthStatus getAuth() {
         return auth;
     }
 
+    /**
+     * PrometheusSourceStatus defines the observed state of PrometheusSource
+     */
     @JsonProperty("auth")
     public void setAuth(AuthStatus auth) {
         this.auth = auth;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CloudEventAttributes> getCeAttributes() {
         return ceAttributes;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     public void setCeAttributes(List<CloudEventAttributes> ceAttributes) {
         this.ceAttributes = ceAttributes;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public String getSinkAudience() {
         return sinkAudience;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public void setSinkAudience(String sinkAudience) {
         this.sinkAudience = sinkAudience;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public String getSinkCACerts() {
         return sinkCACerts;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public void setSinkCACerts(String sinkCACerts) {
         this.sinkCACerts = sinkCACerts;
     }
 
+    /**
+     * PrometheusSourceStatus defines the observed state of PrometheusSource
+     */
     @JsonProperty("sinkUri")
     public String getSinkUri() {
         return sinkUri;
     }
 
+    /**
+     * PrometheusSourceStatus defines the observed state of PrometheusSource
+     */
     @JsonProperty("sinkUri")
     public void setSinkUri(String sinkUri) {
         this.sinkUri = sinkUri;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/SecretValueFromSource.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/SecretValueFromSource.java
index dc17de77e08..37e92217b61 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/SecretValueFromSource.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/SecretValueFromSource.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SecretValueFromSource represents the source of a secret value
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,11 +82,17 @@ public SecretValueFromSource(SecretKeySelector secretKeyRef) {
         this.secretKeyRef = secretKeyRef;
     }
 
+    /**
+     * SecretValueFromSource represents the source of a secret value
+     */
     @JsonProperty("secretKeyRef")
     public SecretKeySelector getSecretKeyRef() {
         return secretKeyRef;
     }
 
+    /**
+     * SecretValueFromSource represents the source of a secret value
+     */
     @JsonProperty("secretKeyRef")
     public void setSecretKeyRef(SecretKeySelector secretKeyRef) {
         this.secretKeyRef = secretKeyRef;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/Timer.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/Timer.java
index d77cb5565a1..877f546f508 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/Timer.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1alpha1/Timer.java
@@ -90,21 +90,33 @@ public Timer(String contentType, String message, Integer period, Integer repeatC
         this.repeatCount = repeatCount;
     }
 
+    /**
+     * Message to generate
+     */
     @JsonProperty("contentType")
     public String getContentType() {
         return contentType;
     }
 
+    /**
+     * Message to generate
+     */
     @JsonProperty("contentType")
     public void setContentType(String contentType) {
         this.contentType = contentType;
     }
 
+    /**
+     * Interval (in milliseconds) between producing messages
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Interval (in milliseconds) between producing messages
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
@@ -120,11 +132,17 @@ public void setPeriod(Integer period) {
         this.period = period;
     }
 
+    /**
+     * Content type of generated message
+     */
     @JsonProperty("repeatCount")
     public Integer getRepeatCount() {
         return repeatCount;
     }
 
+    /**
+     * Content type of generated message
+     */
     @JsonProperty("repeatCount")
     public void setRepeatCount(Integer repeatCount) {
         this.repeatCount = repeatCount;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta1/KafkaSource.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta1/KafkaSource.java
index 3b0a55a82fb..f57e672adad 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta1/KafkaSource.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta1/KafkaSource.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KafkaSource is the Schema for the kafkasources API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class KafkaSource implements Editable<KafkaSourceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sources.knative.dev/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KafkaSource";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public KafkaSource(String apiVersion, String kind, ObjectMeta metadata, KafkaSou
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KafkaSource is the Schema for the kafkasources API.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KafkaSource is the Schema for the kafkasources API.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * KafkaSource is the Schema for the kafkasources API.
+     */
     @JsonProperty("spec")
     public KafkaSourceSpec getSpec() {
         return spec;
     }
 
+    /**
+     * KafkaSource is the Schema for the kafkasources API.
+     */
     @JsonProperty("spec")
     public void setSpec(KafkaSourceSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * KafkaSource is the Schema for the kafkasources API.
+     */
     @JsonProperty("status")
     public KafkaSourceStatus getStatus() {
         return status;
     }
 
+    /**
+     * KafkaSource is the Schema for the kafkasources API.
+     */
     @JsonProperty("status")
     public void setStatus(KafkaSourceStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta1/KafkaSourceList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta1/KafkaSourceList.java
index d16bb601c38..2b13f2b24df 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta1/KafkaSourceList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta1/KafkaSourceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KafkaSourceList contains a list of KafkaSources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class KafkaSourceList implements Editable<KafkaSourceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.sources.v1beta1.KafkaSource>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sources.knative.dev/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.sources.v1beta1.KafkaSource> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KafkaSourceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public KafkaSourceList(String apiVersion, List<io.fabric8.knative.sources.v1beta
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * KafkaSourceList contains a list of KafkaSources.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.sources.v1beta1.KafkaSource> getItems() {
         return items;
     }
 
+    /**
+     * KafkaSourceList contains a list of KafkaSources.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.sources.v1beta1.KafkaSource> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KafkaSourceList contains a list of KafkaSources.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KafkaSourceList contains a list of KafkaSources.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta1/KafkaSourceSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta1/KafkaSourceSpec.java
index 1d509e98ccb..8b3fb0af569 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta1/KafkaSourceSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta1/KafkaSourceSpec.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KafkaSourceSpec defines the desired state of the KafkaSource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -122,103 +125,163 @@ public KafkaSourceSpec(List<String> bootstrapServers, CloudEventOverrides ceOver
         this.topics = topics;
     }
 
+    /**
+     * Bootstrap servers are the Kafka servers the consumer will connect to.
+     */
     @JsonProperty("bootstrapServers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getBootstrapServers() {
         return bootstrapServers;
     }
 
+    /**
+     * Bootstrap servers are the Kafka servers the consumer will connect to.
+     */
     @JsonProperty("bootstrapServers")
     public void setBootstrapServers(List<String> bootstrapServers) {
         this.bootstrapServers = bootstrapServers;
     }
 
+    /**
+     * KafkaSourceSpec defines the desired state of the KafkaSource.
+     */
     @JsonProperty("ceOverrides")
     public CloudEventOverrides getCeOverrides() {
         return ceOverrides;
     }
 
+    /**
+     * KafkaSourceSpec defines the desired state of the KafkaSource.
+     */
     @JsonProperty("ceOverrides")
     public void setCeOverrides(CloudEventOverrides ceOverrides) {
         this.ceOverrides = ceOverrides;
     }
 
+    /**
+     * ConsumerGroupID is the consumer group ID.
+     */
     @JsonProperty("consumerGroup")
     public String getConsumerGroup() {
         return consumerGroup;
     }
 
+    /**
+     * ConsumerGroupID is the consumer group ID.
+     */
     @JsonProperty("consumerGroup")
     public void setConsumerGroup(String consumerGroup) {
         this.consumerGroup = consumerGroup;
     }
 
+    /**
+     * Number of desired consumers running in the consumer group. Defaults to 1.<br><p> <br><p> This is a pointer to distinguish between explicit zero and not specified.
+     */
     @JsonProperty("consumers")
     public Integer getConsumers() {
         return consumers;
     }
 
+    /**
+     * Number of desired consumers running in the consumer group. Defaults to 1.<br><p> <br><p> This is a pointer to distinguish between explicit zero and not specified.
+     */
     @JsonProperty("consumers")
     public void setConsumers(Integer consumers) {
         this.consumers = consumers;
     }
 
+    /**
+     * KafkaSourceSpec defines the desired state of the KafkaSource.
+     */
     @JsonProperty("delivery")
     public DeliverySpec getDelivery() {
         return delivery;
     }
 
+    /**
+     * KafkaSourceSpec defines the desired state of the KafkaSource.
+     */
     @JsonProperty("delivery")
     public void setDelivery(DeliverySpec delivery) {
         this.delivery = delivery;
     }
 
+    /**
+     * InitialOffset is the Initial Offset for the consumer group. should be earliest or latest
+     */
     @JsonProperty("initialOffset")
     public String getInitialOffset() {
         return initialOffset;
     }
 
+    /**
+     * InitialOffset is the Initial Offset for the consumer group. should be earliest or latest
+     */
     @JsonProperty("initialOffset")
     public void setInitialOffset(String initialOffset) {
         this.initialOffset = initialOffset;
     }
 
+    /**
+     * KafkaSourceSpec defines the desired state of the KafkaSource.
+     */
     @JsonProperty("net")
     public KafkaNetSpec getNet() {
         return net;
     }
 
+    /**
+     * KafkaSourceSpec defines the desired state of the KafkaSource.
+     */
     @JsonProperty("net")
     public void setNet(KafkaNetSpec net) {
         this.net = net;
     }
 
+    /**
+     * Ordering is the type of the consumer verticle. Should be ordered or unordered. By default, it is ordered.
+     */
     @JsonProperty("ordering")
     public String getOrdering() {
         return ordering;
     }
 
+    /**
+     * Ordering is the type of the consumer verticle. Should be ordered or unordered. By default, it is ordered.
+     */
     @JsonProperty("ordering")
     public void setOrdering(String ordering) {
         this.ordering = ordering;
     }
 
+    /**
+     * KafkaSourceSpec defines the desired state of the KafkaSource.
+     */
     @JsonProperty("sink")
     public Destination getSink() {
         return sink;
     }
 
+    /**
+     * KafkaSourceSpec defines the desired state of the KafkaSource.
+     */
     @JsonProperty("sink")
     public void setSink(Destination sink) {
         this.sink = sink;
     }
 
+    /**
+     * Topic topics to consume messages from
+     */
     @JsonProperty("topics")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getTopics() {
         return topics;
     }
 
+    /**
+     * Topic topics to consume messages from
+     */
     @JsonProperty("topics")
     public void setTopics(List<String> topics) {
         this.topics = topics;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta1/KafkaSourceStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta1/KafkaSourceStatus.java
index d772de8f9ce..ad3589eb756 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta1/KafkaSourceStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta1/KafkaSourceStatus.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KafkaSourceStatus defines the observed state of KafkaSource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -136,135 +139,213 @@ public KafkaSourceStatus(Map<String, String> annotations, AuthStatus auth, List<
         this.sinkUri = sinkUri;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * KafkaSourceStatus defines the observed state of KafkaSource.
+     */
     @JsonProperty("auth")
     public AuthStatus getAuth() {
         return auth;
     }
 
+    /**
+     * KafkaSourceStatus defines the observed state of KafkaSource.
+     */
     @JsonProperty("auth")
     public void setAuth(AuthStatus auth) {
         this.auth = auth;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CloudEventAttributes> getCeAttributes() {
         return ceAttributes;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     public void setCeAttributes(List<CloudEventAttributes> ceAttributes) {
         this.ceAttributes = ceAttributes;
     }
 
+    /**
+     * Claims consumed by this KafkaSource instance
+     */
     @JsonProperty("claims")
     public String getClaims() {
         return claims;
     }
 
+    /**
+     * Claims consumed by this KafkaSource instance
+     */
     @JsonProperty("claims")
     public void setClaims(String claims) {
         this.claims = claims;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Total number of consumers actually running in the consumer group.
+     */
     @JsonProperty("consumers")
     public Integer getConsumers() {
         return consumers;
     }
 
+    /**
+     * Total number of consumers actually running in the consumer group.
+     */
     @JsonProperty("consumers")
     public void setConsumers(Integer consumers) {
         this.consumers = consumers;
     }
 
+    /**
+     * KafkaSourceStatus defines the observed state of KafkaSource.
+     */
     @JsonProperty("maxAllowedVReplicas")
     public Integer getMaxAllowedVReplicas() {
         return maxAllowedVReplicas;
     }
 
+    /**
+     * KafkaSourceStatus defines the observed state of KafkaSource.
+     */
     @JsonProperty("maxAllowedVReplicas")
     public void setMaxAllowedVReplicas(Integer maxAllowedVReplicas) {
         this.maxAllowedVReplicas = maxAllowedVReplicas;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * KafkaSourceStatus defines the observed state of KafkaSource.
+     */
     @JsonProperty("placements")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Placement> getPlacements() {
         return placements;
     }
 
+    /**
+     * KafkaSourceStatus defines the observed state of KafkaSource.
+     */
     @JsonProperty("placements")
     public void setPlacements(List<Placement> placements) {
         this.placements = placements;
     }
 
+    /**
+     * Use for labelSelectorPath when scaling Kafka source
+     */
     @JsonProperty("selector")
     public String getSelector() {
         return selector;
     }
 
+    /**
+     * Use for labelSelectorPath when scaling Kafka source
+     */
     @JsonProperty("selector")
     public void setSelector(String selector) {
         this.selector = selector;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public String getSinkAudience() {
         return sinkAudience;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public void setSinkAudience(String sinkAudience) {
         this.sinkAudience = sinkAudience;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public String getSinkCACerts() {
         return sinkCACerts;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public void setSinkCACerts(String sinkCACerts) {
         this.sinkCACerts = sinkCACerts;
     }
 
+    /**
+     * KafkaSourceStatus defines the observed state of KafkaSource.
+     */
     @JsonProperty("sinkUri")
     public String getSinkUri() {
         return sinkUri;
     }
 
+    /**
+     * KafkaSourceStatus defines the observed state of KafkaSource.
+     */
     @JsonProperty("sinkUri")
     public void setSinkUri(String sinkUri) {
         this.sinkUri = sinkUri;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta2/PingSource.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta2/PingSource.java
index de7478295bd..8e75b0f361c 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta2/PingSource.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta2/PingSource.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PingSource is the Schema for the PingSources API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class PingSource implements Editable<PingSourceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sources.knative.dev/v1beta2";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PingSource";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PingSource(String apiVersion, String kind, ObjectMeta metadata, PingSourc
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PingSource is the Schema for the PingSources API.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PingSource is the Schema for the PingSources API.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PingSource is the Schema for the PingSources API.
+     */
     @JsonProperty("spec")
     public PingSourceSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PingSource is the Schema for the PingSources API.
+     */
     @JsonProperty("spec")
     public void setSpec(PingSourceSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PingSource is the Schema for the PingSources API.
+     */
     @JsonProperty("status")
     public PingSourceStatus getStatus() {
         return status;
     }
 
+    /**
+     * PingSource is the Schema for the PingSources API.
+     */
     @JsonProperty("status")
     public void setStatus(PingSourceStatus status) {
         this.status = status;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta2/PingSourceList.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta2/PingSourceList.java
index ca76dded483..4ad92e02374 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta2/PingSourceList.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta2/PingSourceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PingSourceList contains a list of PingSources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PingSourceList implements Editable<PingSourceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.knative.sources.v1beta2.PingSource>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "sources.knative.dev/v1beta2";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.knative.sources.v1beta2.PingSource> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PingSourceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PingSourceList(String apiVersion, List<io.fabric8.knative.sources.v1beta2
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PingSourceList contains a list of PingSources.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.knative.sources.v1beta2.PingSource> getItems() {
         return items;
     }
 
+    /**
+     * PingSourceList contains a list of PingSources.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.knative.sources.v1beta2.PingSource> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PingSourceList contains a list of PingSources.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PingSourceList contains a list of PingSources.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta2/PingSourceSpec.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta2/PingSourceSpec.java
index 91151f10e8c..dfd8546163d 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta2/PingSourceSpec.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta2/PingSourceSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PingSourceSpec defines the desired state of the PingSource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -104,71 +107,113 @@ public PingSourceSpec(CloudEventOverrides ceOverrides, String contentType, Strin
         this.timezone = timezone;
     }
 
+    /**
+     * PingSourceSpec defines the desired state of the PingSource.
+     */
     @JsonProperty("ceOverrides")
     public CloudEventOverrides getCeOverrides() {
         return ceOverrides;
     }
 
+    /**
+     * PingSourceSpec defines the desired state of the PingSource.
+     */
     @JsonProperty("ceOverrides")
     public void setCeOverrides(CloudEventOverrides ceOverrides) {
         this.ceOverrides = ceOverrides;
     }
 
+    /**
+     * ContentType is the media type of Data or DataBase64. Default is empty.
+     */
     @JsonProperty("contentType")
     public String getContentType() {
         return contentType;
     }
 
+    /**
+     * ContentType is the media type of Data or DataBase64. Default is empty.
+     */
     @JsonProperty("contentType")
     public void setContentType(String contentType) {
         this.contentType = contentType;
     }
 
+    /**
+     * Data is data used as the body of the event posted to the sink. Default is empty. Mutually exclusive with DataBase64.
+     */
     @JsonProperty("data")
     public String getData() {
         return data;
     }
 
+    /**
+     * Data is data used as the body of the event posted to the sink. Default is empty. Mutually exclusive with DataBase64.
+     */
     @JsonProperty("data")
     public void setData(String data) {
         this.data = data;
     }
 
+    /**
+     * DataBase64 is the base64-encoded string of the actual event's body posted to the sink. Default is empty. Mutually exclusive with Data.
+     */
     @JsonProperty("dataBase64")
     public String getDataBase64() {
         return dataBase64;
     }
 
+    /**
+     * DataBase64 is the base64-encoded string of the actual event's body posted to the sink. Default is empty. Mutually exclusive with Data.
+     */
     @JsonProperty("dataBase64")
     public void setDataBase64(String dataBase64) {
         this.dataBase64 = dataBase64;
     }
 
+    /**
+     * Schedule is the cron schedule. Defaults to `&#42; &#42; &#42; &#42; &#42;`.
+     */
     @JsonProperty("schedule")
     public String getSchedule() {
         return schedule;
     }
 
+    /**
+     * Schedule is the cron schedule. Defaults to `&#42; &#42; &#42; &#42; &#42;`.
+     */
     @JsonProperty("schedule")
     public void setSchedule(String schedule) {
         this.schedule = schedule;
     }
 
+    /**
+     * PingSourceSpec defines the desired state of the PingSource.
+     */
     @JsonProperty("sink")
     public Destination getSink() {
         return sink;
     }
 
+    /**
+     * PingSourceSpec defines the desired state of the PingSource.
+     */
     @JsonProperty("sink")
     public void setSink(Destination sink) {
         this.sink = sink;
     }
 
+    /**
+     * Timezone modifies the actual time relative to the specified timezone. Defaults to the system time zone. More general information about time zones: https://www.iana.org/time-zones List of valid timezone values: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+     */
     @JsonProperty("timezone")
     public String getTimezone() {
         return timezone;
     }
 
+    /**
+     * Timezone modifies the actual time relative to the specified timezone. Defaults to the system time zone. More general information about time zones: https://www.iana.org/time-zones List of valid timezone values: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+     */
     @JsonProperty("timezone")
     public void setTimezone(String timezone) {
         this.timezone = timezone;
diff --git a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta2/PingSourceStatus.java b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta2/PingSourceStatus.java
index 32e980e81b9..af3f5a35cac 100644
--- a/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta2/PingSourceStatus.java
+++ b/extensions/knative/model/src/generated/java/io/fabric8/knative/sources/v1beta2/PingSourceStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PingSourceStatus defines the observed state of PingSource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -114,84 +117,132 @@ public PingSourceStatus(Map<String, String> annotations, AuthStatus auth, List<C
         this.sinkUri = sinkUri;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * PingSourceStatus defines the observed state of PingSource.
+     */
     @JsonProperty("auth")
     public AuthStatus getAuth() {
         return auth;
     }
 
+    /**
+     * PingSourceStatus defines the observed state of PingSource.
+     */
     @JsonProperty("auth")
     public void setAuth(AuthStatus auth) {
         this.auth = auth;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CloudEventAttributes> getCeAttributes() {
         return ceAttributes;
     }
 
+    /**
+     * CloudEventAttributes are the specific attributes that the Source uses as part of its CloudEvents.
+     */
     @JsonProperty("ceAttributes")
     public void setCeAttributes(List<CloudEventAttributes> ceAttributes) {
         this.ceAttributes = ceAttributes;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public String getSinkAudience() {
         return sinkAudience;
     }
 
+    /**
+     * SinkAudience is the OIDC audience of the sink.
+     */
     @JsonProperty("sinkAudience")
     public void setSinkAudience(String sinkAudience) {
         this.sinkAudience = sinkAudience;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public String getSinkCACerts() {
         return sinkCACerts;
     }
 
+    /**
+     * SinkCACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
+     */
     @JsonProperty("sinkCACerts")
     public void setSinkCACerts(String sinkCACerts) {
         this.sinkCACerts = sinkCACerts;
     }
 
+    /**
+     * PingSourceStatus defines the observed state of PingSource.
+     */
     @JsonProperty("sinkUri")
     public String getSinkUri() {
         return sinkUri;
     }
 
+    /**
+     * PingSourceStatus defines the observed state of PingSource.
+     */
     @JsonProperty("sinkUri")
     public void setSinkUri(String sinkUri) {
         this.sinkUri = sinkUri;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/AddonAgentConfig.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/AddonAgentConfig.java
index d2d1b08a280..c1a9ff0a1eb 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/AddonAgentConfig.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/AddonAgentConfig.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AddonAgentConfig is the configurations for addon agents.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -100,62 +103,98 @@ public AddonAgentConfig(String imagePullPolicy, String imagePullSecret, String i
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * AddonAgentConfig is the configurations for addon agents.
+     */
     @JsonProperty("ImagePullPolicy")
     public String getImagePullPolicy() {
         return imagePullPolicy;
     }
 
+    /**
+     * AddonAgentConfig is the configurations for addon agents.
+     */
     @JsonProperty("ImagePullPolicy")
     public void setImagePullPolicy(String imagePullPolicy) {
         this.imagePullPolicy = imagePullPolicy;
     }
 
+    /**
+     * AddonAgentConfig is the configurations for addon agents.
+     */
     @JsonProperty("ImagePullSecret")
     public String getImagePullSecret() {
         return imagePullSecret;
     }
 
+    /**
+     * AddonAgentConfig is the configurations for addon agents.
+     */
     @JsonProperty("ImagePullSecret")
     public void setImagePullSecret(String imagePullSecret) {
         this.imagePullSecret = imagePullSecret;
     }
 
+    /**
+     * AddonAgentConfig is the configurations for addon agents.
+     */
     @JsonProperty("ImagePullSecretNamespace")
     public String getImagePullSecretNamespace() {
         return imagePullSecretNamespace;
     }
 
+    /**
+     * AddonAgentConfig is the configurations for addon agents.
+     */
     @JsonProperty("ImagePullSecretNamespace")
     public void setImagePullSecretNamespace(String imagePullSecretNamespace) {
         this.imagePullSecretNamespace = imagePullSecretNamespace;
     }
 
+    /**
+     * AddonAgentConfig is the configurations for addon agents.
+     */
     @JsonProperty("KlusterletAddonConfig")
     public KlusterletAddonConfig getKlusterletAddonConfig() {
         return klusterletAddonConfig;
     }
 
+    /**
+     * AddonAgentConfig is the configurations for addon agents.
+     */
     @JsonProperty("KlusterletAddonConfig")
     public void setKlusterletAddonConfig(KlusterletAddonConfig klusterletAddonConfig) {
         this.klusterletAddonConfig = klusterletAddonConfig;
     }
 
+    /**
+     * AddonAgentConfig is the configurations for addon agents.
+     */
     @JsonProperty("ManagedCluster")
     public ManagedCluster getManagedCluster() {
         return managedCluster;
     }
 
+    /**
+     * AddonAgentConfig is the configurations for addon agents.
+     */
     @JsonProperty("ManagedCluster")
     public void setManagedCluster(ManagedCluster managedCluster) {
         this.managedCluster = managedCluster;
     }
 
+    /**
+     * AddonAgentConfig is the configurations for addon agents.
+     */
     @JsonProperty("NodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * AddonAgentConfig is the configurations for addon agents.
+     */
     @JsonProperty("NodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/GlobalValues.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/GlobalValues.java
index 7f3e9a36032..abd009dc881 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/GlobalValues.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/GlobalValues.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GlobalValues defines the global values
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -97,54 +100,84 @@ public GlobalValues(Map<String, String> imageOverrides, String imagePullPolicy,
         this.proxyConfig = proxyConfig;
     }
 
+    /**
+     * GlobalValues defines the global values
+     */
     @JsonProperty("imageOverrides")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getImageOverrides() {
         return imageOverrides;
     }
 
+    /**
+     * GlobalValues defines the global values
+     */
     @JsonProperty("imageOverrides")
     public void setImageOverrides(Map<String, String> imageOverrides) {
         this.imageOverrides = imageOverrides;
     }
 
+    /**
+     * GlobalValues defines the global values
+     */
     @JsonProperty("imagePullPolicy")
     public String getImagePullPolicy() {
         return imagePullPolicy;
     }
 
+    /**
+     * GlobalValues defines the global values
+     */
     @JsonProperty("imagePullPolicy")
     public void setImagePullPolicy(String imagePullPolicy) {
         this.imagePullPolicy = imagePullPolicy;
     }
 
+    /**
+     * GlobalValues defines the global values
+     */
     @JsonProperty("imagePullSecret")
     public String getImagePullSecret() {
         return imagePullSecret;
     }
 
+    /**
+     * GlobalValues defines the global values
+     */
     @JsonProperty("imagePullSecret")
     public void setImagePullSecret(String imagePullSecret) {
         this.imagePullSecret = imagePullSecret;
     }
 
+    /**
+     * GlobalValues defines the global values
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * GlobalValues defines the global values
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * GlobalValues defines the global values
+     */
     @JsonProperty("proxyConfig")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getProxyConfig() {
         return proxyConfig;
     }
 
+    /**
+     * GlobalValues defines the global values
+     */
     @JsonProperty("proxyConfig")
     public void setProxyConfig(Map<String, String> proxyConfig) {
         this.proxyConfig = proxyConfig;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/KlusterletAddonAgentConfigSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/KlusterletAddonAgentConfigSpec.java
index ee666aefacf..79697c8cb2f 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/KlusterletAddonAgentConfigSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/KlusterletAddonAgentConfigSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KlusterletAddonAgentConfigSpec defines configuration for each addon agent.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public KlusterletAddonAgentConfigSpec(Boolean enabled, String proxyPolicy) {
         this.proxyPolicy = proxyPolicy;
     }
 
+    /**
+     * Enabled is the flag to enable/disable the addon. default is false.
+     */
     @JsonProperty("enabled")
     public Boolean getEnabled() {
         return enabled;
     }
 
+    /**
+     * Enabled is the flag to enable/disable the addon. default is false.
+     */
     @JsonProperty("enabled")
     public void setEnabled(Boolean enabled) {
         this.enabled = enabled;
     }
 
+    /**
+     * ProxyPolicy defines the policy to set proxy for each addon agent. default is Disabled. Disabled means that the addon agent pods do not configure the proxy env variables. OCPGlobalProxy means that the addon agent pods use the cluster-wide proxy config of OCP cluster provisioned by ACM. CustomProxy means that the addon agent pods use the ProxyConfig specified in KlusterletAddonConfig.
+     */
     @JsonProperty("proxyPolicy")
     public String getProxyPolicy() {
         return proxyPolicy;
     }
 
+    /**
+     * ProxyPolicy defines the policy to set proxy for each addon agent. default is Disabled. Disabled means that the addon agent pods do not configure the proxy env variables. OCPGlobalProxy means that the addon agent pods use the cluster-wide proxy config of OCP cluster provisioned by ACM. CustomProxy means that the addon agent pods use the ProxyConfig specified in KlusterletAddonConfig.
+     */
     @JsonProperty("proxyPolicy")
     public void setProxyPolicy(String proxyPolicy) {
         this.proxyPolicy = proxyPolicy;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/KlusterletAddonConfig.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/KlusterletAddonConfig.java
index ae479908aa5..7fb1f1b9009 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/KlusterletAddonConfig.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/KlusterletAddonConfig.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KlusterletAddonConfig is the Schema for the klusterletaddonconfigs API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class KlusterletAddonConfig implements Editable<KlusterletAddonConfigBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "agent.open-cluster-management.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KlusterletAddonConfig";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public KlusterletAddonConfig(String apiVersion, String kind, ObjectMeta metadata
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KlusterletAddonConfig is the Schema for the klusterletaddonconfigs API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KlusterletAddonConfig is the Schema for the klusterletaddonconfigs API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * KlusterletAddonConfig is the Schema for the klusterletaddonconfigs API
+     */
     @JsonProperty("spec")
     public KlusterletAddonConfigSpec getSpec() {
         return spec;
     }
 
+    /**
+     * KlusterletAddonConfig is the Schema for the klusterletaddonconfigs API
+     */
     @JsonProperty("spec")
     public void setSpec(KlusterletAddonConfigSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * KlusterletAddonConfig is the Schema for the klusterletaddonconfigs API
+     */
     @JsonProperty("status")
     public KlusterletAddonConfigStatus getStatus() {
         return status;
     }
 
+    /**
+     * KlusterletAddonConfig is the Schema for the klusterletaddonconfigs API
+     */
     @JsonProperty("status")
     public void setStatus(KlusterletAddonConfigStatus status) {
         this.status = status;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/KlusterletAddonConfigList.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/KlusterletAddonConfigList.java
index 1c0f5abb28f..98ae6e01e02 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/KlusterletAddonConfigList.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/KlusterletAddonConfigList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KlusterletAddonConfigList contains a list of klusterletAddonConfig
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class KlusterletAddonConfigList implements Editable<KlusterletAddonConfigListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openclustermanagement.api.model.agent.v1.KlusterletAddonConfig>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "agent.open-cluster-management.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openclustermanagement.api.model.agent.v1.KlusterletAddonConfig> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KlusterletAddonConfigList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public KlusterletAddonConfigList(String apiVersion, List<io.fabric8.openclusterm
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * KlusterletAddonConfigList contains a list of klusterletAddonConfig
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openclustermanagement.api.model.agent.v1.KlusterletAddonConfig> getItems() {
         return items;
     }
 
+    /**
+     * KlusterletAddonConfigList contains a list of klusterletAddonConfig
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openclustermanagement.api.model.agent.v1.KlusterletAddonConfig> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KlusterletAddonConfigList contains a list of klusterletAddonConfig
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KlusterletAddonConfigList contains a list of klusterletAddonConfig
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/KlusterletAddonConfigSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/KlusterletAddonConfigSpec.java
index ac2486da0ab..1501a33b152 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/KlusterletAddonConfigSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/KlusterletAddonConfigSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KlusterletAddonConfigSpec defines the desired state of KlusterletAddonConfig
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -115,102 +118,162 @@ public KlusterletAddonConfigSpec(KlusterletAddonAgentConfigSpec applicationManag
         this.version = version;
     }
 
+    /**
+     * KlusterletAddonConfigSpec defines the desired state of KlusterletAddonConfig
+     */
     @JsonProperty("applicationManager")
     public KlusterletAddonAgentConfigSpec getApplicationManager() {
         return applicationManager;
     }
 
+    /**
+     * KlusterletAddonConfigSpec defines the desired state of KlusterletAddonConfig
+     */
     @JsonProperty("applicationManager")
     public void setApplicationManager(KlusterletAddonAgentConfigSpec applicationManager) {
         this.applicationManager = applicationManager;
     }
 
+    /**
+     * KlusterletAddonConfigSpec defines the desired state of KlusterletAddonConfig
+     */
     @JsonProperty("certPolicyController")
     public KlusterletAddonAgentConfigSpec getCertPolicyController() {
         return certPolicyController;
     }
 
+    /**
+     * KlusterletAddonConfigSpec defines the desired state of KlusterletAddonConfig
+     */
     @JsonProperty("certPolicyController")
     public void setCertPolicyController(KlusterletAddonAgentConfigSpec certPolicyController) {
         this.certPolicyController = certPolicyController;
     }
 
+    /**
+     * DEPRECATED in release 2.4 and will be removed in the future since not used anymore.
+     */
     @JsonProperty("clusterLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getClusterLabels() {
         return clusterLabels;
     }
 
+    /**
+     * DEPRECATED in release 2.4 and will be removed in the future since not used anymore.
+     */
     @JsonProperty("clusterLabels")
     public void setClusterLabels(Map<String, String> clusterLabels) {
         this.clusterLabels = clusterLabels;
     }
 
+    /**
+     * DEPRECATED in release 2.4 and will be removed in the future since not used anymore.
+     */
     @JsonProperty("clusterName")
     public String getClusterName() {
         return clusterName;
     }
 
+    /**
+     * DEPRECATED in release 2.4 and will be removed in the future since not used anymore.
+     */
     @JsonProperty("clusterName")
     public void setClusterName(String clusterName) {
         this.clusterName = clusterName;
     }
 
+    /**
+     * DEPRECATED in release 2.4 and will be removed in the future since not used anymore.
+     */
     @JsonProperty("clusterNamespace")
     public String getClusterNamespace() {
         return clusterNamespace;
     }
 
+    /**
+     * DEPRECATED in release 2.4 and will be removed in the future since not used anymore.
+     */
     @JsonProperty("clusterNamespace")
     public void setClusterNamespace(String clusterNamespace) {
         this.clusterNamespace = clusterNamespace;
     }
 
+    /**
+     * KlusterletAddonConfigSpec defines the desired state of KlusterletAddonConfig
+     */
     @JsonProperty("iamPolicyController")
     public KlusterletAddonAgentConfigSpec getIamPolicyController() {
         return iamPolicyController;
     }
 
+    /**
+     * KlusterletAddonConfigSpec defines the desired state of KlusterletAddonConfig
+     */
     @JsonProperty("iamPolicyController")
     public void setIamPolicyController(KlusterletAddonAgentConfigSpec iamPolicyController) {
         this.iamPolicyController = iamPolicyController;
     }
 
+    /**
+     * KlusterletAddonConfigSpec defines the desired state of KlusterletAddonConfig
+     */
     @JsonProperty("policyController")
     public KlusterletAddonAgentConfigSpec getPolicyController() {
         return policyController;
     }
 
+    /**
+     * KlusterletAddonConfigSpec defines the desired state of KlusterletAddonConfig
+     */
     @JsonProperty("policyController")
     public void setPolicyController(KlusterletAddonAgentConfigSpec policyController) {
         this.policyController = policyController;
     }
 
+    /**
+     * KlusterletAddonConfigSpec defines the desired state of KlusterletAddonConfig
+     */
     @JsonProperty("proxyConfig")
     public ProxyConfig getProxyConfig() {
         return proxyConfig;
     }
 
+    /**
+     * KlusterletAddonConfigSpec defines the desired state of KlusterletAddonConfig
+     */
     @JsonProperty("proxyConfig")
     public void setProxyConfig(ProxyConfig proxyConfig) {
         this.proxyConfig = proxyConfig;
     }
 
+    /**
+     * KlusterletAddonConfigSpec defines the desired state of KlusterletAddonConfig
+     */
     @JsonProperty("searchCollector")
     public KlusterletAddonAgentConfigSpec getSearchCollector() {
         return searchCollector;
     }
 
+    /**
+     * KlusterletAddonConfigSpec defines the desired state of KlusterletAddonConfig
+     */
     @JsonProperty("searchCollector")
     public void setSearchCollector(KlusterletAddonAgentConfigSpec searchCollector) {
         this.searchCollector = searchCollector;
     }
 
+    /**
+     * DEPRECATED in release 2.4 and will be removed in the future since not used anymore.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * DEPRECATED in release 2.4 and will be removed in the future since not used anymore.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/KlusterletAddonConfigStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/KlusterletAddonConfigStatus.java
index 72affb700fd..57f3ffda84f 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/KlusterletAddonConfigStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/KlusterletAddonConfigStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KlusterletAddonConfigStatus defines the observed state of KlusterletAddonConfig
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,22 +89,34 @@ public KlusterletAddonConfigStatus(List<Condition> conditions, ProxyConfig ocpGl
         this.ocpGlobalProxy = ocpGlobalProxy;
     }
 
+    /**
+     * Conditions contains condition information for the klusterletAddonConfig
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions contains condition information for the klusterletAddonConfig
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * KlusterletAddonConfigStatus defines the observed state of KlusterletAddonConfig
+     */
     @JsonProperty("ocpGlobalProxy")
     public ProxyConfig getOcpGlobalProxy() {
         return ocpGlobalProxy;
     }
 
+    /**
+     * KlusterletAddonConfigStatus defines the observed state of KlusterletAddonConfig
+     */
     @JsonProperty("ocpGlobalProxy")
     public void setOcpGlobalProxy(ProxyConfig ocpGlobalProxy) {
         this.ocpGlobalProxy = ocpGlobalProxy;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/ProxyConfig.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/ProxyConfig.java
index cd77124bb32..c293b8ee7a4 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/ProxyConfig.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/agent/v1/ProxyConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ProxyConfig defines the global proxy env for OCP cluster
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ProxyConfig(String httpProxy, String httpsProxy, String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * HTTPProxy is the URL of the proxy for HTTP requests.  Empty means unset and will not result in an env var.
+     */
     @JsonProperty("httpProxy")
     public String getHttpProxy() {
         return httpProxy;
     }
 
+    /**
+     * HTTPProxy is the URL of the proxy for HTTP requests.  Empty means unset and will not result in an env var.
+     */
     @JsonProperty("httpProxy")
     public void setHttpProxy(String httpProxy) {
         this.httpProxy = httpProxy;
     }
 
+    /**
+     * HTTPSProxy is the URL of the proxy for HTTPS requests.  Empty means unset and will not result in an env var.
+     */
     @JsonProperty("httpsProxy")
     public String getHttpsProxy() {
         return httpsProxy;
     }
 
+    /**
+     * HTTPSProxy is the URL of the proxy for HTTPS requests.  Empty means unset and will not result in an env var.
+     */
     @JsonProperty("httpsProxy")
     public void setHttpsProxy(String httpsProxy) {
         this.httpsProxy = httpsProxy;
     }
 
+    /**
+     * NoProxy is a comma-separated list of hostnames and/or CIDRs for which the proxy should not be used. Empty means unset and will not result in an env var. The API Server of Hub cluster should be added here. And If you scale up workers that are not included in the network defined by the networking.machineNetwork[].cidr field from the installation configuration, you must add them to this list to prevent connection issues.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * NoProxy is a comma-separated list of hostnames and/or CIDRs for which the proxy should not be used. Empty means unset and will not result in an env var. The API Server of Hub cluster should be added here. And If you scale up workers that are not included in the network defined by the networking.machineNetwork[].cidr field from the installation configuration, you must add them to this list to prevent connection issues.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/AllowDenyItem.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/AllowDenyItem.java
index 6b3908a11d3..7982f6fb751 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/AllowDenyItem.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/AllowDenyItem.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AllowDenyItem defines a group of resources allowed or denied for deployment
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public AllowDenyItem(String apiVersion, List<String> kinds) {
         this.kinds = kinds;
     }
 
+    /**
+     * APIVersion specifies the API version for the group of resources
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * APIVersion specifies the API version for the group of resources
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Kinds specifies a list of kinds under the same API version for the group of resources
+     */
     @JsonProperty("kinds")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getKinds() {
         return kinds;
     }
 
+    /**
+     * Kinds specifies a list of kinds under the same API version for the group of resources
+     */
     @JsonProperty("kinds")
     public void setKinds(List<String> kinds) {
         this.kinds = kinds;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/AnsibleJobsStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/AnsibleJobsStatus.java
index 592d11c5a41..3214a3b6c44 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/AnsibleJobsStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/AnsibleJobsStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AnsibleJobsStatus defines status of ansible jobs propagated by the subscription
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,43 +97,67 @@ public AnsibleJobsStatus(String lastposthookjob, String lastprehookjob, List<Str
         this.prehookjobshistory = prehookjobshistory;
     }
 
+    /**
+     * The lastly propagated posthook job
+     */
     @JsonProperty("lastposthookjob")
     public String getLastposthookjob() {
         return lastposthookjob;
     }
 
+    /**
+     * The lastly propagated posthook job
+     */
     @JsonProperty("lastposthookjob")
     public void setLastposthookjob(String lastposthookjob) {
         this.lastposthookjob = lastposthookjob;
     }
 
+    /**
+     * The lastly propagated prehook job
+     */
     @JsonProperty("lastprehookjob")
     public String getLastprehookjob() {
         return lastprehookjob;
     }
 
+    /**
+     * The lastly propagated prehook job
+     */
     @JsonProperty("lastprehookjob")
     public void setLastprehookjob(String lastprehookjob) {
         this.lastprehookjob = lastprehookjob;
     }
 
+    /**
+     * reserved for backward compatibility
+     */
     @JsonProperty("posthookjobshistory")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPosthookjobshistory() {
         return posthookjobshistory;
     }
 
+    /**
+     * reserved for backward compatibility
+     */
     @JsonProperty("posthookjobshistory")
     public void setPosthookjobshistory(List<String> posthookjobshistory) {
         this.posthookjobshistory = posthookjobshistory;
     }
 
+    /**
+     * reserved for backward compatibility
+     */
     @JsonProperty("prehookjobshistory")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPrehookjobshistory() {
         return prehookjobshistory;
     }
 
+    /**
+     * reserved for backward compatibility
+     */
     @JsonProperty("prehookjobshistory")
     public void setPrehookjobshistory(List<String> prehookjobshistory) {
         this.prehookjobshistory = prehookjobshistory;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/Channel.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/Channel.java
index 10ab35da8ee..96536074029 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/Channel.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/Channel.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Channel provides a repository containing application resources which can be deployed to clusters by subscriptions. The following 3 types of channels are supported: Git repository, Helm release registry, and Object storage repository.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Channel implements Editable<ChannelBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apps.open-cluster-management.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Channel";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Channel(String apiVersion, String kind, ObjectMeta metadata, ChannelSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Channel provides a repository containing application resources which can be deployed to clusters by subscriptions. The following 3 types of channels are supported: Git repository, Helm release registry, and Object storage repository.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Channel provides a repository containing application resources which can be deployed to clusters by subscriptions. The following 3 types of channels are supported: Git repository, Helm release registry, and Object storage repository.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Channel provides a repository containing application resources which can be deployed to clusters by subscriptions. The following 3 types of channels are supported: Git repository, Helm release registry, and Object storage repository.
+     */
     @JsonProperty("spec")
     public ChannelSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Channel provides a repository containing application resources which can be deployed to clusters by subscriptions. The following 3 types of channels are supported: Git repository, Helm release registry, and Object storage repository.
+     */
     @JsonProperty("spec")
     public void setSpec(ChannelSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Channel provides a repository containing application resources which can be deployed to clusters by subscriptions. The following 3 types of channels are supported: Git repository, Helm release registry, and Object storage repository.
+     */
     @JsonProperty("status")
     public ChannelStatus getStatus() {
         return status;
     }
 
+    /**
+     * Channel provides a repository containing application resources which can be deployed to clusters by subscriptions. The following 3 types of channels are supported: Git repository, Helm release registry, and Object storage repository.
+     */
     @JsonProperty("status")
     public void setStatus(ChannelStatus status) {
         this.status = status;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ChannelGate.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ChannelGate.java
index 338a3bdc970..8a60dd72e8f 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ChannelGate.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ChannelGate.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ChannelGate defines a criteria for promoting a Deployable from the sourceNamespaces to Channel.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,32 +90,50 @@ public ChannelGate(Map<String, String> annotations, LabelSelector labelSelector,
         this.name = name;
     }
 
+    /**
+     * The annotations for selecting the Deployables to be eligible for promotion.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * The annotations for selecting the Deployables to be eligible for promotion.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * ChannelGate defines a criteria for promoting a Deployable from the sourceNamespaces to Channel.
+     */
     @JsonProperty("labelSelector")
     public LabelSelector getLabelSelector() {
         return labelSelector;
     }
 
+    /**
+     * ChannelGate defines a criteria for promoting a Deployable from the sourceNamespaces to Channel.
+     */
     @JsonProperty("labelSelector")
     public void setLabelSelector(LabelSelector labelSelector) {
         this.labelSelector = labelSelector;
     }
 
+    /**
+     * ChannelGate defines a criteria for promoting a Deployable from the sourceNamespaces to Channel.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * ChannelGate defines a criteria for promoting a Deployable from the sourceNamespaces to Channel.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ChannelList.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ChannelList.java
index 223052d9506..20a15870a25 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ChannelList.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ChannelList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ChannelList provides a list of channels
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ChannelList implements Editable<ChannelListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openclustermanagement.api.model.apps.v1.Channel>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apps.open-cluster-management.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openclustermanagement.api.model.apps.v1.Channel> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ChannelList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ChannelList(String apiVersion, List<io.fabric8.openclustermanagement.api.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * A list of Channel objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openclustermanagement.api.model.apps.v1.Channel> getItems() {
         return items;
     }
 
+    /**
+     * A list of Channel objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openclustermanagement.api.model.apps.v1.Channel> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ChannelList provides a list of channels
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ChannelList provides a list of channels
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ChannelSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ChannelSpec.java
index a925102e0c4..f7241211059 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ChannelSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ChannelSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ChannelSpec defines the desired state of Channel
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -105,72 +108,114 @@ public ChannelSpec(ObjectReference configMapRef, ChannelGate gates, Boolean inse
         this.type = type;
     }
 
+    /**
+     * ChannelSpec defines the desired state of Channel
+     */
     @JsonProperty("configMapRef")
     public ObjectReference getConfigMapRef() {
         return configMapRef;
     }
 
+    /**
+     * ChannelSpec defines the desired state of Channel
+     */
     @JsonProperty("configMapRef")
     public void setConfigMapRef(ObjectReference configMapRef) {
         this.configMapRef = configMapRef;
     }
 
+    /**
+     * ChannelSpec defines the desired state of Channel
+     */
     @JsonProperty("gates")
     public ChannelGate getGates() {
         return gates;
     }
 
+    /**
+     * ChannelSpec defines the desired state of Channel
+     */
     @JsonProperty("gates")
     public void setGates(ChannelGate gates) {
         this.gates = gates;
     }
 
+    /**
+     * Skip server TLS certificate verification for Git or Helm channel.
+     */
     @JsonProperty("insecureSkipVerify")
     public Boolean getInsecureSkipVerify() {
         return insecureSkipVerify;
     }
 
+    /**
+     * Skip server TLS certificate verification for Git or Helm channel.
+     */
     @JsonProperty("insecureSkipVerify")
     public void setInsecureSkipVerify(Boolean insecureSkipVerify) {
         this.insecureSkipVerify = insecureSkipVerify;
     }
 
+    /**
+     * For a `helmrepo` or `github` channel, pathname is the repo URL. For a `objectbucket` channel, pathname is the Object store URL with the name of the bucket.
+     */
     @JsonProperty("pathname")
     public String getPathname() {
         return pathname;
     }
 
+    /**
+     * For a `helmrepo` or `github` channel, pathname is the repo URL. For a `objectbucket` channel, pathname is the Object store URL with the name of the bucket.
+     */
     @JsonProperty("pathname")
     public void setPathname(String pathname) {
         this.pathname = pathname;
     }
 
+    /**
+     * ChannelSpec defines the desired state of Channel
+     */
     @JsonProperty("secretRef")
     public ObjectReference getSecretRef() {
         return secretRef;
     }
 
+    /**
+     * ChannelSpec defines the desired state of Channel
+     */
     @JsonProperty("secretRef")
     public void setSecretRef(ObjectReference secretRef) {
         this.secretRef = secretRef;
     }
 
+    /**
+     * A list of namespace names from which Deployables can be promoted.
+     */
     @JsonProperty("sourceNamespaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSourceNamespaces() {
         return sourceNamespaces;
     }
 
+    /**
+     * A list of namespace names from which Deployables can be promoted.
+     */
     @JsonProperty("sourceNamespaces")
     public void setSourceNamespaces(List<String> sourceNamespaces) {
         this.sourceNamespaces = sourceNamespaces;
     }
 
+    /**
+     * ChannelSpec defines the desired state of Channel
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * ChannelSpec defines the desired state of Channel
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ChannelStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ChannelStatus.java
index dea482de54c..33e8a5f3b73 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ChannelStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ChannelStatus.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ChannelStatus defines the observed state of Channel
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ClusterConditionFilter.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ClusterConditionFilter.java
index fd64d897585..e9a74fd3d66 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ClusterConditionFilter.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ClusterConditionFilter.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterConditionFilter defines filter to filter cluster condition
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ClusterConditionFilter(String status, String type) {
         this.type = type;
     }
 
+    /**
+     * ClusterConditionFilter defines filter to filter cluster condition
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * ClusterConditionFilter defines filter to filter cluster condition
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * ClusterConditionFilter defines filter to filter cluster condition
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * ClusterConditionFilter defines filter to filter cluster condition
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ClusterOverride.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ClusterOverride.java
index 30a1e120d51..ba4d1af72bc 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ClusterOverride.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ClusterOverride.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterOverride defines the contents for override rules
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ClusterOverrides.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ClusterOverrides.java
index 14a8d9c0ba4..f0114c54b03 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ClusterOverrides.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ClusterOverrides.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterOverrides defines a list of contents that will be overridden to a given cluster
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public ClusterOverrides(String clusterName, List<ClusterOverride> clusterOverrid
         this.clusterOverrides = clusterOverrides;
     }
 
+    /**
+     * Cluster name
+     */
     @JsonProperty("clusterName")
     public String getClusterName() {
         return clusterName;
     }
 
+    /**
+     * Cluster name
+     */
     @JsonProperty("clusterName")
     public void setClusterName(String clusterName) {
         this.clusterName = clusterName;
     }
 
+    /**
+     * ClusterOverrides defines a list of content for override
+     */
     @JsonProperty("clusterOverrides")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ClusterOverride> getClusterOverrides() {
         return clusterOverrides;
     }
 
+    /**
+     * ClusterOverrides defines a list of content for override
+     */
     @JsonProperty("clusterOverrides")
     public void setClusterOverrides(List<ClusterOverride> clusterOverrides) {
         this.clusterOverrides = clusterOverrides;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/GenericClusterReference.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/GenericClusterReference.java
index 255e947f2de..1e9c74b8714 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/GenericClusterReference.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/GenericClusterReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GenericClusterReference - in alignment with kubefed
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public GenericClusterReference(String name) {
         this.name = name;
     }
 
+    /**
+     * GenericClusterReference - in alignment with kubefed
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * GenericClusterReference - in alignment with kubefed
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/GenericPlacementFields.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/GenericPlacementFields.java
index 14e94b9f376..197ddfee69c 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/GenericPlacementFields.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/GenericPlacementFields.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GenericPlacementFields - in alignment with kubefed
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public GenericPlacementFields(LabelSelector clusterSelector, List<GenericCluster
         this.clusters = clusters;
     }
 
+    /**
+     * GenericPlacementFields - in alignment with kubefed
+     */
     @JsonProperty("clusterSelector")
     public LabelSelector getClusterSelector() {
         return clusterSelector;
     }
 
+    /**
+     * GenericPlacementFields - in alignment with kubefed
+     */
     @JsonProperty("clusterSelector")
     public void setClusterSelector(LabelSelector clusterSelector) {
         this.clusterSelector = clusterSelector;
     }
 
+    /**
+     * GenericPlacementFields - in alignment with kubefed
+     */
     @JsonProperty("clusters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenericClusterReference> getClusters() {
         return clusters;
     }
 
+    /**
+     * GenericPlacementFields - in alignment with kubefed
+     */
     @JsonProperty("clusters")
     public void setClusters(List<GenericClusterReference> clusters) {
         this.clusters = clusters;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/HourRange.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/HourRange.java
index c1300f200a0..292df89d162 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/HourRange.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/HourRange.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HourRange defines the time format, refer to https://golang.org/pkg/time/#pkg-constants
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public HourRange(String end, String start) {
         this.start = start;
     }
 
+    /**
+     * End time of the hour range
+     */
     @JsonProperty("end")
     public String getEnd() {
         return end;
     }
 
+    /**
+     * End time of the hour range
+     */
     @JsonProperty("end")
     public void setEnd(String end) {
         this.end = end;
     }
 
+    /**
+     * Start time of the hour range
+     */
     @JsonProperty("start")
     public String getStart() {
         return start;
     }
 
+    /**
+     * Start time of the hour range
+     */
     @JsonProperty("start")
     public void setStart(String start) {
         this.start = start;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/Overrides.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/Overrides.java
index 7cae6ae67b9..1c0850dc8ec 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/Overrides.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/Overrides.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Overrides defines a list of contents that will be overridden to a given resource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public Overrides(String packageAlias, String packageName, List<PackageOverride>
         this.packageOverrides = packageOverrides;
     }
 
+    /**
+     * PackageAlias defines the alias of the package name that will be onverriden
+     */
     @JsonProperty("packageAlias")
     public String getPackageAlias() {
         return packageAlias;
     }
 
+    /**
+     * PackageAlias defines the alias of the package name that will be onverriden
+     */
     @JsonProperty("packageAlias")
     public void setPackageAlias(String packageAlias) {
         this.packageAlias = packageAlias;
     }
 
+    /**
+     * PackageName defines the package name that will be onverriden
+     */
     @JsonProperty("packageName")
     public String getPackageName() {
         return packageName;
     }
 
+    /**
+     * PackageName defines the package name that will be onverriden
+     */
     @JsonProperty("packageName")
     public void setPackageName(String packageName) {
         this.packageName = packageName;
     }
 
+    /**
+     * PackageOverrides defines a list of content for override
+     */
     @JsonProperty("packageOverrides")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PackageOverride> getPackageOverrides() {
         return packageOverrides;
     }
 
+    /**
+     * PackageOverrides defines a list of content for override
+     */
     @JsonProperty("packageOverrides")
     public void setPackageOverrides(List<PackageOverride> packageOverrides) {
         this.packageOverrides = packageOverrides;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/PackageFilter.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/PackageFilter.java
index 9b4b5276f8e..e8a9d9bd046 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/PackageFilter.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/PackageFilter.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PackageFilter defines various types of filters for selecting resources
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,42 +94,66 @@ public PackageFilter(Map<String, String> annotations, LocalObjectReference filte
         this.version = version;
     }
 
+    /**
+     * Annotations defines a type of filter for selecting resources by annotations
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations defines a type of filter for selecting resources by annotations
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * PackageFilter defines various types of filters for selecting resources
+     */
     @JsonProperty("filterRef")
     public LocalObjectReference getFilterRef() {
         return filterRef;
     }
 
+    /**
+     * PackageFilter defines various types of filters for selecting resources
+     */
     @JsonProperty("filterRef")
     public void setFilterRef(LocalObjectReference filterRef) {
         this.filterRef = filterRef;
     }
 
+    /**
+     * PackageFilter defines various types of filters for selecting resources
+     */
     @JsonProperty("labelSelector")
     public LabelSelector getLabelSelector() {
         return labelSelector;
     }
 
+    /**
+     * PackageFilter defines various types of filters for selecting resources
+     */
     @JsonProperty("labelSelector")
     public void setLabelSelector(LabelSelector labelSelector) {
         this.labelSelector = labelSelector;
     }
 
+    /**
+     * Version defines a type of filter for selecting resources by version
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * Version defines a type of filter for selecting resources by version
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/PackageOverride.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/PackageOverride.java
index 1c3bd39fb91..4ce3708c73a 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/PackageOverride.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/PackageOverride.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PackageOverride provides the contents for overriding a package
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/Placement.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/Placement.java
index c68ef2fc948..85508f676c6 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/Placement.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/Placement.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Placement field to be referenced in specs, align with Fedv2, add placementref
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public Placement(LabelSelector clusterSelector, List<GenericClusterReference> cl
         this.placementRef = placementRef;
     }
 
+    /**
+     * Placement field to be referenced in specs, align with Fedv2, add placementref
+     */
     @JsonProperty("clusterSelector")
     public LabelSelector getClusterSelector() {
         return clusterSelector;
     }
 
+    /**
+     * Placement field to be referenced in specs, align with Fedv2, add placementref
+     */
     @JsonProperty("clusterSelector")
     public void setClusterSelector(LabelSelector clusterSelector) {
         this.clusterSelector = clusterSelector;
     }
 
+    /**
+     * Placement field to be referenced in specs, align with Fedv2, add placementref
+     */
     @JsonProperty("clusters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenericClusterReference> getClusters() {
         return clusters;
     }
 
+    /**
+     * Placement field to be referenced in specs, align with Fedv2, add placementref
+     */
     @JsonProperty("clusters")
     public void setClusters(List<GenericClusterReference> clusters) {
         this.clusters = clusters;
     }
 
+    /**
+     * It indicates a standalone subscription if the Local pointer is set to be true
+     */
     @JsonProperty("local")
     public Boolean getLocal() {
         return local;
     }
 
+    /**
+     * It indicates a standalone subscription if the Local pointer is set to be true
+     */
     @JsonProperty("local")
     public void setLocal(Boolean local) {
         this.local = local;
     }
 
+    /**
+     * Placement field to be referenced in specs, align with Fedv2, add placementref
+     */
     @JsonProperty("placementRef")
     public ObjectReference getPlacementRef() {
         return placementRef;
     }
 
+    /**
+     * Placement field to be referenced in specs, align with Fedv2, add placementref
+     */
     @JsonProperty("placementRef")
     public void setPlacementRef(ObjectReference placementRef) {
         this.placementRef = placementRef;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/PlacementDecision.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/PlacementDecision.java
index 9808023e651..8e9f7272be2 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/PlacementDecision.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/PlacementDecision.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PlacementDecision defines the decision made by controller
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PlacementDecision(String clusterName, String clusterNamespace) {
         this.clusterNamespace = clusterNamespace;
     }
 
+    /**
+     * PlacementDecision defines the decision made by controller
+     */
     @JsonProperty("clusterName")
     public String getClusterName() {
         return clusterName;
     }
 
+    /**
+     * PlacementDecision defines the decision made by controller
+     */
     @JsonProperty("clusterName")
     public void setClusterName(String clusterName) {
         this.clusterName = clusterName;
     }
 
+    /**
+     * PlacementDecision defines the decision made by controller
+     */
     @JsonProperty("clusterNamespace")
     public String getClusterNamespace() {
         return clusterNamespace;
     }
 
+    /**
+     * PlacementDecision defines the decision made by controller
+     */
     @JsonProperty("clusterNamespace")
     public void setClusterNamespace(String clusterNamespace) {
         this.clusterNamespace = clusterNamespace;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/PlacementRule.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/PlacementRule.java
index 51e504abedf..ddace5912d6 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/PlacementRule.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/PlacementRule.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PlacementRule is the Schema for the placementrules API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class PlacementRule implements Editable<PlacementRuleBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apps.open-cluster-management.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PlacementRule";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PlacementRule(String apiVersion, String kind, ObjectMeta metadata, Placem
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PlacementRule is the Schema for the placementrules API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PlacementRule is the Schema for the placementrules API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PlacementRule is the Schema for the placementrules API
+     */
     @JsonProperty("spec")
     public PlacementRuleSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PlacementRule is the Schema for the placementrules API
+     */
     @JsonProperty("spec")
     public void setSpec(PlacementRuleSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PlacementRule is the Schema for the placementrules API
+     */
     @JsonProperty("status")
     public PlacementRuleStatus getStatus() {
         return status;
     }
 
+    /**
+     * PlacementRule is the Schema for the placementrules API
+     */
     @JsonProperty("status")
     public void setStatus(PlacementRuleStatus status) {
         this.status = status;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/PlacementRuleList.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/PlacementRuleList.java
index c1164327b6f..b066de947fd 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/PlacementRuleList.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/PlacementRuleList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PlacementRuleList contains a list of PlacementRule
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PlacementRuleList implements Editable<PlacementRuleListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openclustermanagement.api.model.apps.v1.PlacementRule>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apps.open-cluster-management.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openclustermanagement.api.model.apps.v1.PlacementRule> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PlacementRuleList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PlacementRuleList(String apiVersion, List<io.fabric8.openclustermanagemen
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PlacementRuleList contains a list of PlacementRule
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openclustermanagement.api.model.apps.v1.PlacementRule> getItems() {
         return items;
     }
 
+    /**
+     * PlacementRuleList contains a list of PlacementRule
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openclustermanagement.api.model.apps.v1.PlacementRule> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PlacementRuleList contains a list of PlacementRule
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PlacementRuleList contains a list of PlacementRule
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/PlacementRuleSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/PlacementRuleSpec.java
index 68208b1af8d..42258120639 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/PlacementRuleSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/PlacementRuleSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PlacementRuleSpec defines the desired state of PlacementRule
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -107,74 +110,116 @@ public PlacementRuleSpec(List<ClusterConditionFilter> clusterConditions, Integer
         this.schedulerName = schedulerName;
     }
 
+    /**
+     * PlacementRuleSpec defines the desired state of PlacementRule
+     */
     @JsonProperty("clusterConditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ClusterConditionFilter> getClusterConditions() {
         return clusterConditions;
     }
 
+    /**
+     * PlacementRuleSpec defines the desired state of PlacementRule
+     */
     @JsonProperty("clusterConditions")
     public void setClusterConditions(List<ClusterConditionFilter> clusterConditions) {
         this.clusterConditions = clusterConditions;
     }
 
+    /**
+     * number of replicas Application wants to
+     */
     @JsonProperty("clusterReplicas")
     public Integer getClusterReplicas() {
         return clusterReplicas;
     }
 
+    /**
+     * number of replicas Application wants to
+     */
     @JsonProperty("clusterReplicas")
     public void setClusterReplicas(Integer clusterReplicas) {
         this.clusterReplicas = clusterReplicas;
     }
 
+    /**
+     * PlacementRuleSpec defines the desired state of PlacementRule
+     */
     @JsonProperty("clusterSelector")
     public LabelSelector getClusterSelector() {
         return clusterSelector;
     }
 
+    /**
+     * PlacementRuleSpec defines the desired state of PlacementRule
+     */
     @JsonProperty("clusterSelector")
     public void setClusterSelector(LabelSelector clusterSelector) {
         this.clusterSelector = clusterSelector;
     }
 
+    /**
+     * PlacementRuleSpec defines the desired state of PlacementRule
+     */
     @JsonProperty("clusters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenericClusterReference> getClusters() {
         return clusters;
     }
 
+    /**
+     * PlacementRuleSpec defines the desired state of PlacementRule
+     */
     @JsonProperty("clusters")
     public void setClusters(List<GenericClusterReference> clusters) {
         this.clusters = clusters;
     }
 
+    /**
+     * Set Policy Filters
+     */
     @JsonProperty("policies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ObjectReference> getPolicies() {
         return policies;
     }
 
+    /**
+     * Set Policy Filters
+     */
     @JsonProperty("policies")
     public void setPolicies(List<ObjectReference> policies) {
         this.policies = policies;
     }
 
+    /**
+     * PlacementRuleSpec defines the desired state of PlacementRule
+     */
     @JsonProperty("resourceHint")
     public ResourceHint getResourceHint() {
         return resourceHint;
     }
 
+    /**
+     * PlacementRuleSpec defines the desired state of PlacementRule
+     */
     @JsonProperty("resourceHint")
     public void setResourceHint(ResourceHint resourceHint) {
         this.resourceHint = resourceHint;
     }
 
+    /**
+     * INSERT ADDITIONAL SPEC FIELDS - desired state of cluster Important: Run "make" to regenerate code after modifying this file schedulerName, default to use mcm controller
+     */
     @JsonProperty("schedulerName")
     public String getSchedulerName() {
         return schedulerName;
     }
 
+    /**
+     * INSERT ADDITIONAL SPEC FIELDS - desired state of cluster Important: Run "make" to regenerate code after modifying this file schedulerName, default to use mcm controller
+     */
     @JsonProperty("schedulerName")
     public void setSchedulerName(String schedulerName) {
         this.schedulerName = schedulerName;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/PlacementRuleStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/PlacementRuleStatus.java
index 21b883f309c..6d8fdc4d107 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/PlacementRuleStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/PlacementRuleStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PlacementRuleStatus defines the observed state of PlacementRule
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public PlacementRuleStatus(List<PlacementDecision> decisions) {
         this.decisions = decisions;
     }
 
+    /**
+     * INSERT ADDITIONAL STATUS FIELD - define observed state of cluster Important: Run "make" to regenerate code after modifying this file
+     */
     @JsonProperty("decisions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PlacementDecision> getDecisions() {
         return decisions;
     }
 
+    /**
+     * INSERT ADDITIONAL STATUS FIELD - define observed state of cluster Important: Run "make" to regenerate code after modifying this file
+     */
     @JsonProperty("decisions")
     public void setDecisions(List<PlacementDecision> decisions) {
         this.decisions = decisions;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ResourceHint.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ResourceHint.java
index 9c365f554f6..ca0cb87ddf2 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ResourceHint.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/ResourceHint.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceHint is used to sort the output
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ResourceHint(String order, String type) {
         this.type = type;
     }
 
+    /**
+     * ResourceHint is used to sort the output
+     */
     @JsonProperty("order")
     public String getOrder() {
         return order;
     }
 
+    /**
+     * ResourceHint is used to sort the output
+     */
     @JsonProperty("order")
     public void setOrder(String order) {
         this.order = order;
     }
 
+    /**
+     * ResourceHint is used to sort the output
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * ResourceHint is used to sort the output
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/SubscriberItem.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/SubscriberItem.java
index 05b156809c1..b6e7276833b 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/SubscriberItem.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/SubscriberItem.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubscriberItem defines subscriber item to share subscribers with different channel types
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -108,81 +111,129 @@ public SubscriberItem(Channel channel, ConfigMap channelConfigMap, Secret channe
         this.subscriptionConfigMap = subscriptionConfigMap;
     }
 
+    /**
+     * SubscriberItem defines subscriber item to share subscribers with different channel types
+     */
     @JsonProperty("Channel")
     public Channel getChannel() {
         return channel;
     }
 
+    /**
+     * SubscriberItem defines subscriber item to share subscribers with different channel types
+     */
     @JsonProperty("Channel")
     public void setChannel(Channel channel) {
         this.channel = channel;
     }
 
+    /**
+     * SubscriberItem defines subscriber item to share subscribers with different channel types
+     */
     @JsonProperty("ChannelConfigMap")
     public ConfigMap getChannelConfigMap() {
         return channelConfigMap;
     }
 
+    /**
+     * SubscriberItem defines subscriber item to share subscribers with different channel types
+     */
     @JsonProperty("ChannelConfigMap")
     public void setChannelConfigMap(ConfigMap channelConfigMap) {
         this.channelConfigMap = channelConfigMap;
     }
 
+    /**
+     * SubscriberItem defines subscriber item to share subscribers with different channel types
+     */
     @JsonProperty("ChannelSecret")
     public Secret getChannelSecret() {
         return channelSecret;
     }
 
+    /**
+     * SubscriberItem defines subscriber item to share subscribers with different channel types
+     */
     @JsonProperty("ChannelSecret")
     public void setChannelSecret(Secret channelSecret) {
         this.channelSecret = channelSecret;
     }
 
+    /**
+     * SubscriberItem defines subscriber item to share subscribers with different channel types
+     */
     @JsonProperty("SecondaryChannel")
     public Channel getSecondaryChannel() {
         return secondaryChannel;
     }
 
+    /**
+     * SubscriberItem defines subscriber item to share subscribers with different channel types
+     */
     @JsonProperty("SecondaryChannel")
     public void setSecondaryChannel(Channel secondaryChannel) {
         this.secondaryChannel = secondaryChannel;
     }
 
+    /**
+     * SubscriberItem defines subscriber item to share subscribers with different channel types
+     */
     @JsonProperty("SecondaryChannelConfigMap")
     public ConfigMap getSecondaryChannelConfigMap() {
         return secondaryChannelConfigMap;
     }
 
+    /**
+     * SubscriberItem defines subscriber item to share subscribers with different channel types
+     */
     @JsonProperty("SecondaryChannelConfigMap")
     public void setSecondaryChannelConfigMap(ConfigMap secondaryChannelConfigMap) {
         this.secondaryChannelConfigMap = secondaryChannelConfigMap;
     }
 
+    /**
+     * SubscriberItem defines subscriber item to share subscribers with different channel types
+     */
     @JsonProperty("SecondaryChannelSecret")
     public Secret getSecondaryChannelSecret() {
         return secondaryChannelSecret;
     }
 
+    /**
+     * SubscriberItem defines subscriber item to share subscribers with different channel types
+     */
     @JsonProperty("SecondaryChannelSecret")
     public void setSecondaryChannelSecret(Secret secondaryChannelSecret) {
         this.secondaryChannelSecret = secondaryChannelSecret;
     }
 
+    /**
+     * SubscriberItem defines subscriber item to share subscribers with different channel types
+     */
     @JsonProperty("Subscription")
     public Subscription getSubscription() {
         return subscription;
     }
 
+    /**
+     * SubscriberItem defines subscriber item to share subscribers with different channel types
+     */
     @JsonProperty("Subscription")
     public void setSubscription(Subscription subscription) {
         this.subscription = subscription;
     }
 
+    /**
+     * SubscriberItem defines subscriber item to share subscribers with different channel types
+     */
     @JsonProperty("SubscriptionConfigMap")
     public ConfigMap getSubscriptionConfigMap() {
         return subscriptionConfigMap;
     }
 
+    /**
+     * SubscriberItem defines subscriber item to share subscribers with different channel types
+     */
     @JsonProperty("SubscriptionConfigMap")
     public void setSubscriptionConfigMap(ConfigMap subscriptionConfigMap) {
         this.subscriptionConfigMap = subscriptionConfigMap;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/Subscription.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/Subscription.java
index 540b84feb51..3fdea6efb72 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/Subscription.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/Subscription.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Subscription is the Schema for the subscriptions API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Subscription implements Editable<SubscriptionBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apps.open-cluster-management.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Subscription";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Subscription(String apiVersion, String kind, ObjectMeta metadata, Subscri
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Subscription is the Schema for the subscriptions API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Subscription is the Schema for the subscriptions API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Subscription is the Schema for the subscriptions API
+     */
     @JsonProperty("spec")
     public SubscriptionSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Subscription is the Schema for the subscriptions API
+     */
     @JsonProperty("spec")
     public void setSpec(SubscriptionSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Subscription is the Schema for the subscriptions API
+     */
     @JsonProperty("status")
     public SubscriptionStatus getStatus() {
         return status;
     }
 
+    /**
+     * Subscription is the Schema for the subscriptions API
+     */
     @JsonProperty("status")
     public void setStatus(SubscriptionStatus status) {
         this.status = status;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/SubscriptionList.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/SubscriptionList.java
index 02d12d25197..0ae7642d90a 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/SubscriptionList.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/SubscriptionList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubscriptionList contains a list of Subscription
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class SubscriptionList implements Editable<SubscriptionListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openclustermanagement.api.model.apps.v1.Subscription>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apps.open-cluster-management.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openclustermanagement.api.model.apps.v1.Subscription> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SubscriptionList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public SubscriptionList(String apiVersion, List<io.fabric8.openclustermanagement
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * SubscriptionList contains a list of Subscription
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openclustermanagement.api.model.apps.v1.Subscription> getItems() {
         return items;
     }
 
+    /**
+     * SubscriptionList contains a list of Subscription
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openclustermanagement.api.model.apps.v1.Subscription> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SubscriptionList contains a list of Subscription
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SubscriptionList contains a list of Subscription
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/SubscriptionPerClusterStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/SubscriptionPerClusterStatus.java
index 4531af29df0..aae30779dc3 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/SubscriptionPerClusterStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/SubscriptionPerClusterStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubscriptionPerClusterStatus defines status of each subscription in a cluster, key is package name
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,12 +82,18 @@ public SubscriptionPerClusterStatus(Map<String, SubscriptionUnitStatus> packages
         this.packages = packages;
     }
 
+    /**
+     * SubscriptionPerClusterStatus defines status of each subscription in a cluster, key is package name
+     */
     @JsonProperty("packages")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, SubscriptionUnitStatus> getPackages() {
         return packages;
     }
 
+    /**
+     * SubscriptionPerClusterStatus defines status of each subscription in a cluster, key is package name
+     */
     @JsonProperty("packages")
     public void setPackages(Map<String, SubscriptionUnitStatus> packages) {
         this.packages = packages;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/SubscriptionSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/SubscriptionSpec.java
index cc395f9c3db..7b14e3ccdc6 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/SubscriptionSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/SubscriptionSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubscriptionSpec defines the desired state of Subscription
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -128,125 +131,197 @@ public SubscriptionSpec(List<AllowDenyItem> allow, String channel, List<AllowDen
         this.watchHelmNamespaceScopedResources = watchHelmNamespaceScopedResources;
     }
 
+    /**
+     * Specify a list of resources allowed for deployment
+     */
     @JsonProperty("allow")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AllowDenyItem> getAllow() {
         return allow;
     }
 
+    /**
+     * Specify a list of resources allowed for deployment
+     */
     @JsonProperty("allow")
     public void setAllow(List<AllowDenyItem> allow) {
         this.allow = allow;
     }
 
+    /**
+     * The primary channel namespaced name used by the subscription. Its format is "&lt;channel NameSpace&gt;/&lt;channel Name&gt;"
+     */
     @JsonProperty("channel")
     public String getChannel() {
         return channel;
     }
 
+    /**
+     * The primary channel namespaced name used by the subscription. Its format is "&lt;channel NameSpace&gt;/&lt;channel Name&gt;"
+     */
     @JsonProperty("channel")
     public void setChannel(String channel) {
         this.channel = channel;
     }
 
+    /**
+     * Specify a list of resources denied for deployment
+     */
     @JsonProperty("deny")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AllowDenyItem> getDeny() {
         return deny;
     }
 
+    /**
+     * Specify a list of resources denied for deployment
+     */
     @JsonProperty("deny")
     public void setDeny(List<AllowDenyItem> deny) {
         this.deny = deny;
     }
 
+    /**
+     * SubscriptionSpec defines the desired state of Subscription
+     */
     @JsonProperty("hooksecretref")
     public ObjectReference getHooksecretref() {
         return hooksecretref;
     }
 
+    /**
+     * SubscriptionSpec defines the desired state of Subscription
+     */
     @JsonProperty("hooksecretref")
     public void setHooksecretref(ObjectReference hooksecretref) {
         this.hooksecretref = hooksecretref;
     }
 
+    /**
+     * Subscribe a package by its package name
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Subscribe a package by its package name
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Specify overrides when applied to clusters. Hub use only
+     */
     @JsonProperty("overrides")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ClusterOverrides> getOverrides() {
         return overrides;
     }
 
+    /**
+     * Specify overrides when applied to clusters. Hub use only
+     */
     @JsonProperty("overrides")
     public void setOverrides(List<ClusterOverrides> overrides) {
         this.overrides = overrides;
     }
 
+    /**
+     * SubscriptionSpec defines the desired state of Subscription
+     */
     @JsonProperty("packageFilter")
     public PackageFilter getPackageFilter() {
         return packageFilter;
     }
 
+    /**
+     * SubscriptionSpec defines the desired state of Subscription
+     */
     @JsonProperty("packageFilter")
     public void setPackageFilter(PackageFilter packageFilter) {
         this.packageFilter = packageFilter;
     }
 
+    /**
+     * Override packages
+     */
     @JsonProperty("packageOverrides")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Overrides> getPackageOverrides() {
         return packageOverrides;
     }
 
+    /**
+     * Override packages
+     */
     @JsonProperty("packageOverrides")
     public void setPackageOverrides(List<Overrides> packageOverrides) {
         this.packageOverrides = packageOverrides;
     }
 
+    /**
+     * SubscriptionSpec defines the desired state of Subscription
+     */
     @JsonProperty("placement")
     public Placement getPlacement() {
         return placement;
     }
 
+    /**
+     * SubscriptionSpec defines the desired state of Subscription
+     */
     @JsonProperty("placement")
     public void setPlacement(Placement placement) {
         this.placement = placement;
     }
 
+    /**
+     * The secondary channel will be applied if the primary channel fails to connect
+     */
     @JsonProperty("secondaryChannel")
     public String getSecondaryChannel() {
         return secondaryChannel;
     }
 
+    /**
+     * The secondary channel will be applied if the primary channel fails to connect
+     */
     @JsonProperty("secondaryChannel")
     public void setSecondaryChannel(String secondaryChannel) {
         this.secondaryChannel = secondaryChannel;
     }
 
+    /**
+     * SubscriptionSpec defines the desired state of Subscription
+     */
     @JsonProperty("timewindow")
     public TimeWindow getTimewindow() {
         return timewindow;
     }
 
+    /**
+     * SubscriptionSpec defines the desired state of Subscription
+     */
     @JsonProperty("timewindow")
     public void setTimewindow(TimeWindow timewindow) {
         this.timewindow = timewindow;
     }
 
+    /**
+     * WatchHelmNamespaceScopedResources is used to enable watching namespace scope Helm chart resources
+     */
     @JsonProperty("watchHelmNamespaceScopedResources")
     public Boolean getWatchHelmNamespaceScopedResources() {
         return watchHelmNamespaceScopedResources;
     }
 
+    /**
+     * WatchHelmNamespaceScopedResources is used to enable watching namespace scope Helm chart resources
+     */
     @JsonProperty("watchHelmNamespaceScopedResources")
     public void setWatchHelmNamespaceScopedResources(Boolean watchHelmNamespaceScopedResources) {
         this.watchHelmNamespaceScopedResources = watchHelmNamespaceScopedResources;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/SubscriptionStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/SubscriptionStatus.java
index 9186603dc50..9359cccaa70 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/SubscriptionStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/SubscriptionStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubscriptionStatus defines the observed status of a subscription
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -103,72 +106,114 @@ public SubscriptionStatus(AnsibleJobsStatus ansiblejobs, String appstatusReferen
         this.statuses = statuses;
     }
 
+    /**
+     * SubscriptionStatus defines the observed status of a subscription
+     */
     @JsonProperty("ansiblejobs")
     public AnsibleJobsStatus getAnsiblejobs() {
         return ansiblejobs;
     }
 
+    /**
+     * SubscriptionStatus defines the observed status of a subscription
+     */
     @JsonProperty("ansiblejobs")
     public void setAnsiblejobs(AnsibleJobsStatus ansiblejobs) {
         this.ansiblejobs = ansiblejobs;
     }
 
+    /**
+     * The CLI reference for getting the subscription status output
+     */
     @JsonProperty("appstatusReference")
     public String getAppstatusReference() {
         return appstatusReference;
     }
 
+    /**
+     * The CLI reference for getting the subscription status output
+     */
     @JsonProperty("appstatusReference")
     public void setAppstatusReference(String appstatusReference) {
         this.appstatusReference = appstatusReference;
     }
 
+    /**
+     * SubscriptionStatus defines the observed status of a subscription
+     */
     @JsonProperty("lastUpdateTime")
     public String getLastUpdateTime() {
         return lastUpdateTime;
     }
 
+    /**
+     * SubscriptionStatus defines the observed status of a subscription
+     */
     @JsonProperty("lastUpdateTime")
     public void setLastUpdateTime(String lastUpdateTime) {
         this.lastUpdateTime = lastUpdateTime;
     }
 
+    /**
+     * Informational message of the subscription deployment
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Informational message of the subscription deployment
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Phase of the subscription deployment
+     */
     @JsonProperty("phase")
     public String getPhase() {
         return phase;
     }
 
+    /**
+     * Phase of the subscription deployment
+     */
     @JsonProperty("phase")
     public void setPhase(String phase) {
         this.phase = phase;
     }
 
+    /**
+     * additional error output of the subscription deployment
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * additional error output of the subscription deployment
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * SubscriptionStatus defines the observed status of a subscription
+     */
     @JsonProperty("statuses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, SubscriptionPerClusterStatus> getStatuses() {
         return statuses;
     }
 
+    /**
+     * SubscriptionStatus defines the observed status of a subscription
+     */
     @JsonProperty("statuses")
     public void setStatuses(Map<String, SubscriptionPerClusterStatus> statuses) {
         this.statuses = statuses;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/SubscriptionUnitStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/SubscriptionUnitStatus.java
index aae3f7578f9..ae819584bd8 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/SubscriptionUnitStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/SubscriptionUnitStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubscriptionUnitStatus defines status of each package in a subscription
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,51 +98,81 @@ public SubscriptionUnitStatus(String lastUpdateTime, String message, String phas
         this.resourceStatus = resourceStatus;
     }
 
+    /**
+     * SubscriptionUnitStatus defines status of each package in a subscription
+     */
     @JsonProperty("lastUpdateTime")
     public String getLastUpdateTime() {
         return lastUpdateTime;
     }
 
+    /**
+     * SubscriptionUnitStatus defines status of each package in a subscription
+     */
     @JsonProperty("lastUpdateTime")
     public void setLastUpdateTime(String lastUpdateTime) {
         this.lastUpdateTime = lastUpdateTime;
     }
 
+    /**
+     * Informational message from the deployment of the package.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Informational message from the deployment of the package.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Phase of the deployment package (Propagated/Subscribed/Failed/PropagationFailed/PreHookSucessful).
+     */
     @JsonProperty("phase")
     public String getPhase() {
         return phase;
     }
 
+    /**
+     * Phase of the deployment package (Propagated/Subscribed/Failed/PropagationFailed/PreHookSucessful).
+     */
     @JsonProperty("phase")
     public void setPhase(String phase) {
         this.phase = phase;
     }
 
+    /**
+     * additional error output from the deployment of the package.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * additional error output from the deployment of the package.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * SubscriptionUnitStatus defines status of each package in a subscription
+     */
     @JsonProperty("resourceStatus")
     public Object getResourceStatus() {
         return resourceStatus;
     }
 
+    /**
+     * SubscriptionUnitStatus defines status of each package in a subscription
+     */
     @JsonProperty("resourceStatus")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setResourceStatus(Object resourceStatus) {
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/TimeWindow.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/TimeWindow.java
index 0e9350109ce..400faeaec78 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/TimeWindow.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/apps/v1/TimeWindow.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TimeWindow defines a time window for the subscription to run or be blocked
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,43 +97,67 @@ public TimeWindow(List<String> daysofweek, List<HourRange> hours, String locatio
         this.windowtype = windowtype;
     }
 
+    /**
+     * A list of days of a week, valid values include: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
+     */
     @JsonProperty("daysofweek")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDaysofweek() {
         return daysofweek;
     }
 
+    /**
+     * A list of days of a week, valid values include: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
+     */
     @JsonProperty("daysofweek")
     public void setDaysofweek(List<String> daysofweek) {
         this.daysofweek = daysofweek;
     }
 
+    /**
+     * A list of hour ranges
+     */
     @JsonProperty("hours")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HourRange> getHours() {
         return hours;
     }
 
+    /**
+     * A list of hour ranges
+     */
     @JsonProperty("hours")
     public void setHours(List<HourRange> hours) {
         this.hours = hours;
     }
 
+    /**
+     * time zone location, refer to TZ identifier in https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+     */
     @JsonProperty("location")
     public String getLocation() {
         return location;
     }
 
+    /**
+     * time zone location, refer to TZ identifier in https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+     */
     @JsonProperty("location")
     public void setLocation(String location) {
         this.location = location;
     }
 
+    /**
+     * Activiate time window or not. The subscription deployment will only be handled during these active windows Valid values include: active,blocked,Active,Blocked
+     */
     @JsonProperty("windowtype")
     public String getWindowtype() {
         return windowtype;
     }
 
+    /**
+     * Activiate time window or not. The subscription deployment will only be handled during these active windows Valid values include: active,blocked,Active,Blocked
+     */
     @JsonProperty("windowtype")
     public void setWindowtype(String windowtype) {
         this.windowtype = windowtype;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/ClientConfig.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/ClientConfig.java
index 4d14e3630a2..7a5fed7253f 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/ClientConfig.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/ClientConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClientConfig represents the apiserver address of the managed cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ClientConfig(String caBundle, String url) {
         this.url = url;
     }
 
+    /**
+     * CABundle is the ca bundle to connect to apiserver of the managed cluster. System certs are used if it is not set.
+     */
     @JsonProperty("caBundle")
     public String getCaBundle() {
         return caBundle;
     }
 
+    /**
+     * CABundle is the ca bundle to connect to apiserver of the managed cluster. System certs are used if it is not set.
+     */
     @JsonProperty("caBundle")
     public void setCaBundle(String caBundle) {
         this.caBundle = caBundle;
     }
 
+    /**
+     * URL is the URL of apiserver endpoint of the managed cluster.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * URL is the URL of apiserver endpoint of the managed cluster.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/ManagedCluster.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/ManagedCluster.java
index f8a751ded76..1e7820d4932 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/ManagedCluster.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/ManagedCluster.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ManagedCluster represents the desired state and current status of a managed cluster. ManagedCluster is a cluster-scoped resource. The name is the cluster UID.<br><p> <br><p> The cluster join process is a double opt-in process. See the following join process steps:<br><p> <br><p> 1. The agent on the managed cluster creates a CSR on the hub with the cluster UID and agent name. 2. The agent on the managed cluster creates a ManagedCluster on the hub. 3. The cluster admin on the hub cluster approves the CSR for the UID and agent name of the ManagedCluster. 4. The cluster admin sets the spec.acceptClient of the ManagedCluster to true. 5. The cluster admin on the managed cluster creates a credential of the kubeconfig for the hub cluster.<br><p> <br><p> After the hub cluster creates the cluster namespace, the klusterlet agent on the ManagedCluster pushes the credential to the hub cluster to use against the kube-apiserver of the ManagedCluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ManagedCluster implements Editable<ManagedClusterBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cluster.open-cluster-management.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ManagedCluster";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public ManagedCluster(String apiVersion, String kind, ObjectMeta metadata, Manag
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ManagedCluster represents the desired state and current status of a managed cluster. ManagedCluster is a cluster-scoped resource. The name is the cluster UID.<br><p> <br><p> The cluster join process is a double opt-in process. See the following join process steps:<br><p> <br><p> 1. The agent on the managed cluster creates a CSR on the hub with the cluster UID and agent name. 2. The agent on the managed cluster creates a ManagedCluster on the hub. 3. The cluster admin on the hub cluster approves the CSR for the UID and agent name of the ManagedCluster. 4. The cluster admin sets the spec.acceptClient of the ManagedCluster to true. 5. The cluster admin on the managed cluster creates a credential of the kubeconfig for the hub cluster.<br><p> <br><p> After the hub cluster creates the cluster namespace, the klusterlet agent on the ManagedCluster pushes the credential to the hub cluster to use against the kube-apiserver of the ManagedCluster.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ManagedCluster represents the desired state and current status of a managed cluster. ManagedCluster is a cluster-scoped resource. The name is the cluster UID.<br><p> <br><p> The cluster join process is a double opt-in process. See the following join process steps:<br><p> <br><p> 1. The agent on the managed cluster creates a CSR on the hub with the cluster UID and agent name. 2. The agent on the managed cluster creates a ManagedCluster on the hub. 3. The cluster admin on the hub cluster approves the CSR for the UID and agent name of the ManagedCluster. 4. The cluster admin sets the spec.acceptClient of the ManagedCluster to true. 5. The cluster admin on the managed cluster creates a credential of the kubeconfig for the hub cluster.<br><p> <br><p> After the hub cluster creates the cluster namespace, the klusterlet agent on the ManagedCluster pushes the credential to the hub cluster to use against the kube-apiserver of the ManagedCluster.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ManagedCluster represents the desired state and current status of a managed cluster. ManagedCluster is a cluster-scoped resource. The name is the cluster UID.<br><p> <br><p> The cluster join process is a double opt-in process. See the following join process steps:<br><p> <br><p> 1. The agent on the managed cluster creates a CSR on the hub with the cluster UID and agent name. 2. The agent on the managed cluster creates a ManagedCluster on the hub. 3. The cluster admin on the hub cluster approves the CSR for the UID and agent name of the ManagedCluster. 4. The cluster admin sets the spec.acceptClient of the ManagedCluster to true. 5. The cluster admin on the managed cluster creates a credential of the kubeconfig for the hub cluster.<br><p> <br><p> After the hub cluster creates the cluster namespace, the klusterlet agent on the ManagedCluster pushes the credential to the hub cluster to use against the kube-apiserver of the ManagedCluster.
+     */
     @JsonProperty("spec")
     public ManagedClusterSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ManagedCluster represents the desired state and current status of a managed cluster. ManagedCluster is a cluster-scoped resource. The name is the cluster UID.<br><p> <br><p> The cluster join process is a double opt-in process. See the following join process steps:<br><p> <br><p> 1. The agent on the managed cluster creates a CSR on the hub with the cluster UID and agent name. 2. The agent on the managed cluster creates a ManagedCluster on the hub. 3. The cluster admin on the hub cluster approves the CSR for the UID and agent name of the ManagedCluster. 4. The cluster admin sets the spec.acceptClient of the ManagedCluster to true. 5. The cluster admin on the managed cluster creates a credential of the kubeconfig for the hub cluster.<br><p> <br><p> After the hub cluster creates the cluster namespace, the klusterlet agent on the ManagedCluster pushes the credential to the hub cluster to use against the kube-apiserver of the ManagedCluster.
+     */
     @JsonProperty("spec")
     public void setSpec(ManagedClusterSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ManagedCluster represents the desired state and current status of a managed cluster. ManagedCluster is a cluster-scoped resource. The name is the cluster UID.<br><p> <br><p> The cluster join process is a double opt-in process. See the following join process steps:<br><p> <br><p> 1. The agent on the managed cluster creates a CSR on the hub with the cluster UID and agent name. 2. The agent on the managed cluster creates a ManagedCluster on the hub. 3. The cluster admin on the hub cluster approves the CSR for the UID and agent name of the ManagedCluster. 4. The cluster admin sets the spec.acceptClient of the ManagedCluster to true. 5. The cluster admin on the managed cluster creates a credential of the kubeconfig for the hub cluster.<br><p> <br><p> After the hub cluster creates the cluster namespace, the klusterlet agent on the ManagedCluster pushes the credential to the hub cluster to use against the kube-apiserver of the ManagedCluster.
+     */
     @JsonProperty("status")
     public ManagedClusterStatus getStatus() {
         return status;
     }
 
+    /**
+     * ManagedCluster represents the desired state and current status of a managed cluster. ManagedCluster is a cluster-scoped resource. The name is the cluster UID.<br><p> <br><p> The cluster join process is a double opt-in process. See the following join process steps:<br><p> <br><p> 1. The agent on the managed cluster creates a CSR on the hub with the cluster UID and agent name. 2. The agent on the managed cluster creates a ManagedCluster on the hub. 3. The cluster admin on the hub cluster approves the CSR for the UID and agent name of the ManagedCluster. 4. The cluster admin sets the spec.acceptClient of the ManagedCluster to true. 5. The cluster admin on the managed cluster creates a credential of the kubeconfig for the hub cluster.<br><p> <br><p> After the hub cluster creates the cluster namespace, the klusterlet agent on the ManagedCluster pushes the credential to the hub cluster to use against the kube-apiserver of the ManagedCluster.
+     */
     @JsonProperty("status")
     public void setStatus(ManagedClusterStatus status) {
         this.status = status;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/ManagedClusterClaim.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/ManagedClusterClaim.java
index 9f069d4aba3..7a2a5685c0b 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/ManagedClusterClaim.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/ManagedClusterClaim.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ManagedClusterClaim represents a ClusterClaim collected from a managed cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ManagedClusterClaim(String name, String value) {
         this.value = value;
     }
 
+    /**
+     * Name is the name of a ClusterClaim resource on managed cluster. It's a well known or customized name to identify the claim.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of a ClusterClaim resource on managed cluster. It's a well known or customized name to identify the claim.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Value is a claim-dependent string
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is a claim-dependent string
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/ManagedClusterList.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/ManagedClusterList.java
index 7350b5fc3b1..70191d28f63 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/ManagedClusterList.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/ManagedClusterList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ManagedClusterList is a collection of managed cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ManagedClusterList implements Editable<ManagedClusterListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openclustermanagement.api.model.cluster.v1.ManagedCluster>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cluster.open-cluster-management.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openclustermanagement.api.model.cluster.v1.ManagedCluster> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ManagedClusterList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ManagedClusterList(String apiVersion, List<io.fabric8.openclustermanageme
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of managed clusters.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openclustermanagement.api.model.cluster.v1.ManagedCluster> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of managed clusters.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openclustermanagement.api.model.cluster.v1.ManagedCluster> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ManagedClusterList is a collection of managed cluster.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ManagedClusterList is a collection of managed cluster.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/ManagedClusterSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/ManagedClusterSpec.java
index 65048261353..73cdb53a7d4 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/ManagedClusterSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/ManagedClusterSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ManagedClusterSpec provides the information to securely connect to a remote server and verify its identity.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,43 +97,67 @@ public ManagedClusterSpec(Boolean hubAcceptsClient, Integer leaseDurationSeconds
         this.taints = taints;
     }
 
+    /**
+     * hubAcceptsClient represents that hub accepts the joining of Klusterlet agent on the managed cluster with the hub. The default value is false, and can only be set true when the user on hub has an RBAC rule to UPDATE on the virtual subresource of managedclusters/accept. When the value is set true, a namespace whose name is the same as the name of ManagedCluster is created on the hub. This namespace represents the managed cluster, also role/rolebinding is created on the namespace to grant the permision of access from the agent on the managed cluster. When the value is set to false, the namespace representing the managed cluster is deleted.
+     */
     @JsonProperty("hubAcceptsClient")
     public Boolean getHubAcceptsClient() {
         return hubAcceptsClient;
     }
 
+    /**
+     * hubAcceptsClient represents that hub accepts the joining of Klusterlet agent on the managed cluster with the hub. The default value is false, and can only be set true when the user on hub has an RBAC rule to UPDATE on the virtual subresource of managedclusters/accept. When the value is set true, a namespace whose name is the same as the name of ManagedCluster is created on the hub. This namespace represents the managed cluster, also role/rolebinding is created on the namespace to grant the permision of access from the agent on the managed cluster. When the value is set to false, the namespace representing the managed cluster is deleted.
+     */
     @JsonProperty("hubAcceptsClient")
     public void setHubAcceptsClient(Boolean hubAcceptsClient) {
         this.hubAcceptsClient = hubAcceptsClient;
     }
 
+    /**
+     * LeaseDurationSeconds is used to coordinate the lease update time of Klusterlet agents on the managed cluster. If its value is zero, the Klusterlet agent will update its lease every 60 seconds by default
+     */
     @JsonProperty("leaseDurationSeconds")
     public Integer getLeaseDurationSeconds() {
         return leaseDurationSeconds;
     }
 
+    /**
+     * LeaseDurationSeconds is used to coordinate the lease update time of Klusterlet agents on the managed cluster. If its value is zero, the Klusterlet agent will update its lease every 60 seconds by default
+     */
     @JsonProperty("leaseDurationSeconds")
     public void setLeaseDurationSeconds(Integer leaseDurationSeconds) {
         this.leaseDurationSeconds = leaseDurationSeconds;
     }
 
+    /**
+     * ManagedClusterClientConfigs represents a list of the apiserver address of the managed cluster. If it is empty, the managed cluster has no accessible address for the hub to connect with it.
+     */
     @JsonProperty("managedClusterClientConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ClientConfig> getManagedClusterClientConfigs() {
         return managedClusterClientConfigs;
     }
 
+    /**
+     * ManagedClusterClientConfigs represents a list of the apiserver address of the managed cluster. If it is empty, the managed cluster has no accessible address for the hub to connect with it.
+     */
     @JsonProperty("managedClusterClientConfigs")
     public void setManagedClusterClientConfigs(List<ClientConfig> managedClusterClientConfigs) {
         this.managedClusterClientConfigs = managedClusterClientConfigs;
     }
 
+    /**
+     * Taints is a property of managed cluster that allow the cluster to be repelled when scheduling. Taints, including 'ManagedClusterUnavailable' and 'ManagedClusterUnreachable', can not be added/removed by agent running on the managed cluster; while it's fine to add/remove other taints from either hub cluser or managed cluster.
+     */
     @JsonProperty("taints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Taint> getTaints() {
         return taints;
     }
 
+    /**
+     * Taints is a property of managed cluster that allow the cluster to be repelled when scheduling. Taints, including 'ManagedClusterUnavailable' and 'ManagedClusterUnreachable', can not be added/removed by agent running on the managed cluster; while it's fine to add/remove other taints from either hub cluser or managed cluster.
+     */
     @JsonProperty("taints")
     public void setTaints(List<Taint> taints) {
         this.taints = taints;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/ManagedClusterStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/ManagedClusterStatus.java
index a66fd6b6a21..c59988274d6 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/ManagedClusterStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/ManagedClusterStatus.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ManagedClusterStatus represents the current status of joined managed cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,55 +105,85 @@ public ManagedClusterStatus(Map<String, Quantity> allocatable, Map<String, Quant
         this.version = version;
     }
 
+    /**
+     * Allocatable represents the total allocatable resources on the managed cluster.
+     */
     @JsonProperty("allocatable")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getAllocatable() {
         return allocatable;
     }
 
+    /**
+     * Allocatable represents the total allocatable resources on the managed cluster.
+     */
     @JsonProperty("allocatable")
     public void setAllocatable(Map<String, Quantity> allocatable) {
         this.allocatable = allocatable;
     }
 
+    /**
+     * Capacity represents the total resource capacity from all nodeStatuses on the managed cluster.
+     */
     @JsonProperty("capacity")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getCapacity() {
         return capacity;
     }
 
+    /**
+     * Capacity represents the total resource capacity from all nodeStatuses on the managed cluster.
+     */
     @JsonProperty("capacity")
     public void setCapacity(Map<String, Quantity> capacity) {
         this.capacity = capacity;
     }
 
+    /**
+     * ClusterClaims represents cluster information that a managed cluster claims, for example a unique cluster identifier (id.k8s.io) and kubernetes version (kubeversion.open-cluster-management.io). They are written from the managed cluster. The set of claims is not uniform across a fleet, some claims can be vendor or version specific and may not be included from all managed clusters.
+     */
     @JsonProperty("clusterClaims")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ManagedClusterClaim> getClusterClaims() {
         return clusterClaims;
     }
 
+    /**
+     * ClusterClaims represents cluster information that a managed cluster claims, for example a unique cluster identifier (id.k8s.io) and kubernetes version (kubeversion.open-cluster-management.io). They are written from the managed cluster. The set of claims is not uniform across a fleet, some claims can be vendor or version specific and may not be included from all managed clusters.
+     */
     @JsonProperty("clusterClaims")
     public void setClusterClaims(List<ManagedClusterClaim> clusterClaims) {
         this.clusterClaims = clusterClaims;
     }
 
+    /**
+     * Conditions contains the different condition statuses for this managed cluster.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions contains the different condition statuses for this managed cluster.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ManagedClusterStatus represents the current status of joined managed cluster.
+     */
     @JsonProperty("version")
     public ManagedClusterVersion getVersion() {
         return version;
     }
 
+    /**
+     * ManagedClusterStatus represents the current status of joined managed cluster.
+     */
     @JsonProperty("version")
     public void setVersion(ManagedClusterVersion version) {
         this.version = version;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/ManagedClusterVersion.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/ManagedClusterVersion.java
index 3b6ed26162a..35740107298 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/ManagedClusterVersion.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/ManagedClusterVersion.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ManagedClusterVersion represents version information about the managed cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ManagedClusterVersion(String kubernetes) {
         this.kubernetes = kubernetes;
     }
 
+    /**
+     * Kubernetes is the kubernetes version of managed cluster.
+     */
     @JsonProperty("kubernetes")
     public String getKubernetes() {
         return kubernetes;
     }
 
+    /**
+     * Kubernetes is the kubernetes version of managed cluster.
+     */
     @JsonProperty("kubernetes")
     public void setKubernetes(String kubernetes) {
         this.kubernetes = kubernetes;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/Taint.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/Taint.java
index fe1675bb1e5..f63334fabed 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/Taint.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1/Taint.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * The managed cluster this Taint is attached to has the "effect" on any placement that does not tolerate the Taint.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public Taint(String effect, String key, String timeAdded, String value) {
         this.value = value;
     }
 
+    /**
+     * Effect indicates the effect of the taint on placements that do not tolerate the taint. Valid effects are NoSelect, PreferNoSelect and NoSelectIfNew.
+     */
     @JsonProperty("effect")
     public String getEffect() {
         return effect;
     }
 
+    /**
+     * Effect indicates the effect of the taint on placements that do not tolerate the taint. Valid effects are NoSelect, PreferNoSelect and NoSelectIfNew.
+     */
     @JsonProperty("effect")
     public void setEffect(String effect) {
         this.effect = effect;
     }
 
+    /**
+     * Key is the taint key applied to a cluster. e.g. bar or foo.example.com/bar. The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt)
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * Key is the taint key applied to a cluster. e.g. bar or foo.example.com/bar. The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt)
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * The managed cluster this Taint is attached to has the "effect" on any placement that does not tolerate the Taint.
+     */
     @JsonProperty("timeAdded")
     public String getTimeAdded() {
         return timeAdded;
     }
 
+    /**
+     * The managed cluster this Taint is attached to has the "effect" on any placement that does not tolerate the Taint.
+     */
     @JsonProperty("timeAdded")
     public void setTimeAdded(String timeAdded) {
         this.timeAdded = timeAdded;
     }
 
+    /**
+     * Value is the taint value corresponding to the taint key.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is the taint value corresponding to the taint key.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/AddOnPlacementScore.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/AddOnPlacementScore.java
index dc7808578c1..ac7b4bb4997 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/AddOnPlacementScore.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/AddOnPlacementScore.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AddOnPlacementScore represents a bundle of scores of one managed cluster, which could be used by placement. AddOnPlacementScore is a namespace scoped resource. The namespace of the resource is the cluster namespace.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class AddOnPlacementScore implements Editable<AddOnPlacementScoreBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cluster.open-cluster-management.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AddOnPlacementScore";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public AddOnPlacementScore(String apiVersion, String kind, ObjectMeta metadata,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AddOnPlacementScore represents a bundle of scores of one managed cluster, which could be used by placement. AddOnPlacementScore is a namespace scoped resource. The namespace of the resource is the cluster namespace.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AddOnPlacementScore represents a bundle of scores of one managed cluster, which could be used by placement. AddOnPlacementScore is a namespace scoped resource. The namespace of the resource is the cluster namespace.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * AddOnPlacementScore represents a bundle of scores of one managed cluster, which could be used by placement. AddOnPlacementScore is a namespace scoped resource. The namespace of the resource is the cluster namespace.
+     */
     @JsonProperty("status")
     public AddOnPlacementScoreStatus getStatus() {
         return status;
     }
 
+    /**
+     * AddOnPlacementScore represents a bundle of scores of one managed cluster, which could be used by placement. AddOnPlacementScore is a namespace scoped resource. The namespace of the resource is the cluster namespace.
+     */
     @JsonProperty("status")
     public void setStatus(AddOnPlacementScoreStatus status) {
         this.status = status;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/AddOnPlacementScoreItem.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/AddOnPlacementScoreItem.java
index ede5a6e409b..d0165410b77 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/AddOnPlacementScoreItem.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/AddOnPlacementScoreItem.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AddOnPlacementScoreItem represents the score name and value.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public AddOnPlacementScoreItem(String name, Integer value) {
         this.value = value;
     }
 
+    /**
+     * Name is the name of the score
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the score
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Value is the value of the score. The score range is from -100 to 100.
+     */
     @JsonProperty("value")
     public Integer getValue() {
         return value;
     }
 
+    /**
+     * Value is the value of the score. The score range is from -100 to 100.
+     */
     @JsonProperty("value")
     public void setValue(Integer value) {
         this.value = value;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/AddOnPlacementScoreList.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/AddOnPlacementScoreList.java
index e3852f6fa32..f3ad836460b 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/AddOnPlacementScoreList.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/AddOnPlacementScoreList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AddOnPlacementScoreList is a collection of AddOnPlacementScore.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class AddOnPlacementScoreList implements Editable<AddOnPlacementScoreListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openclustermanagement.api.model.cluster.v1alpha1.AddOnPlacementScore>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cluster.open-cluster-management.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openclustermanagement.api.model.cluster.v1alpha1.AddOnPlacementScore> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AddOnPlacementScoreList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public AddOnPlacementScoreList(String apiVersion, List<io.fabric8.openclusterman
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of AddOnPlacementScore
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openclustermanagement.api.model.cluster.v1alpha1.AddOnPlacementScore> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of AddOnPlacementScore
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openclustermanagement.api.model.cluster.v1alpha1.AddOnPlacementScore> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AddOnPlacementScoreList is a collection of AddOnPlacementScore.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AddOnPlacementScoreList is a collection of AddOnPlacementScore.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/AddOnPlacementScoreStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/AddOnPlacementScoreStatus.java
index bbff04369e3..44d258402f8 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/AddOnPlacementScoreStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/AddOnPlacementScoreStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AddOnPlacementScoreStatus represents the current status of AddOnPlacementScore.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,33 +94,51 @@ public AddOnPlacementScoreStatus(List<Condition> conditions, List<AddOnPlacement
         this.validUntil = validUntil;
     }
 
+    /**
+     * Conditions contain the different condition statuses for this AddOnPlacementScore.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions contain the different condition statuses for this AddOnPlacementScore.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Scores contain a list of score name and value of this managed cluster.
+     */
     @JsonProperty("scores")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AddOnPlacementScoreItem> getScores() {
         return scores;
     }
 
+    /**
+     * Scores contain a list of score name and value of this managed cluster.
+     */
     @JsonProperty("scores")
     public void setScores(List<AddOnPlacementScoreItem> scores) {
         this.scores = scores;
     }
 
+    /**
+     * AddOnPlacementScoreStatus represents the current status of AddOnPlacementScore.
+     */
     @JsonProperty("validUntil")
     public String getValidUntil() {
         return validUntil;
     }
 
+    /**
+     * AddOnPlacementScoreStatus represents the current status of AddOnPlacementScore.
+     */
     @JsonProperty("validUntil")
     public void setValidUntil(String validUntil) {
         this.validUntil = validUntil;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/ClusterClaim.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/ClusterClaim.java
index 2ef9b4424a9..e275bbff270 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/ClusterClaim.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/ClusterClaim.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterClaim represents cluster information that a managed cluster claims ClusterClaims with well known names include,<br><p>  1. id.k8s.io, it contains a unique identifier for the cluster.<br><p>  2. clusterset.k8s.io, it contains an identifier that relates the cluster<br><p>     to the ClusterSet in which it belongs.<br><p> <br><p> ClusterClaims created on a managed cluster will be collected and saved into the status of the corresponding ManagedCluster on hub.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class ClusterClaim implements Editable<ClusterClaimBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cluster.open-cluster-management.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterClaim";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public ClusterClaim(String apiVersion, String kind, ObjectMeta metadata, Cluster
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterClaim represents cluster information that a managed cluster claims ClusterClaims with well known names include,<br><p>  1. id.k8s.io, it contains a unique identifier for the cluster.<br><p>  2. clusterset.k8s.io, it contains an identifier that relates the cluster<br><p>     to the ClusterSet in which it belongs.<br><p> <br><p> ClusterClaims created on a managed cluster will be collected and saved into the status of the corresponding ManagedCluster on hub.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterClaim represents cluster information that a managed cluster claims ClusterClaims with well known names include,<br><p>  1. id.k8s.io, it contains a unique identifier for the cluster.<br><p>  2. clusterset.k8s.io, it contains an identifier that relates the cluster<br><p>     to the ClusterSet in which it belongs.<br><p> <br><p> ClusterClaims created on a managed cluster will be collected and saved into the status of the corresponding ManagedCluster on hub.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ClusterClaim represents cluster information that a managed cluster claims ClusterClaims with well known names include,<br><p>  1. id.k8s.io, it contains a unique identifier for the cluster.<br><p>  2. clusterset.k8s.io, it contains an identifier that relates the cluster<br><p>     to the ClusterSet in which it belongs.<br><p> <br><p> ClusterClaims created on a managed cluster will be collected and saved into the status of the corresponding ManagedCluster on hub.
+     */
     @JsonProperty("spec")
     public ClusterClaimSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ClusterClaim represents cluster information that a managed cluster claims ClusterClaims with well known names include,<br><p>  1. id.k8s.io, it contains a unique identifier for the cluster.<br><p>  2. clusterset.k8s.io, it contains an identifier that relates the cluster<br><p>     to the ClusterSet in which it belongs.<br><p> <br><p> ClusterClaims created on a managed cluster will be collected and saved into the status of the corresponding ManagedCluster on hub.
+     */
     @JsonProperty("spec")
     public void setSpec(ClusterClaimSpec spec) {
         this.spec = spec;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/ClusterClaimList.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/ClusterClaimList.java
index 2275dfe8b97..78226de16e6 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/ClusterClaimList.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/ClusterClaimList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterClaimList is a collection of ClusterClaim.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ClusterClaimList implements Editable<ClusterClaimListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openclustermanagement.api.model.cluster.v1alpha1.ClusterClaim>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cluster.open-cluster-management.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openclustermanagement.api.model.cluster.v1alpha1.ClusterClaim> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterClaimList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterClaimList(String apiVersion, List<io.fabric8.openclustermanagement
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of ClusterClaim.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openclustermanagement.api.model.cluster.v1alpha1.ClusterClaim> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of ClusterClaim.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openclustermanagement.api.model.cluster.v1alpha1.ClusterClaim> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterClaimList is a collection of ClusterClaim.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterClaimList is a collection of ClusterClaim.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/ClusterClaimSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/ClusterClaimSpec.java
index 026c7912625..59cdae6f7a7 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/ClusterClaimSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/ClusterClaimSpec.java
@@ -78,11 +78,17 @@ public ClusterClaimSpec(String value) {
         this.value = value;
     }
 
+    /**
+     * Value is a claim-dependent string
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is a claim-dependent string
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/MandatoryDecisionGroup.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/MandatoryDecisionGroup.java
index 7fc3084beeb..4f652f74a72 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/MandatoryDecisionGroup.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/MandatoryDecisionGroup.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MandatoryDecisionGroup set the decision group name or group index. GroupName is considered first to select the decisionGroups then GroupIndex.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public MandatoryDecisionGroup(Integer groupIndex, String groupName) {
         this.groupName = groupName;
     }
 
+    /**
+     * GroupIndex of the decision group should match the placementDecisions label value with label key cluster.open-cluster-management.io/decision-group-index
+     */
     @JsonProperty("groupIndex")
     public Integer getGroupIndex() {
         return groupIndex;
     }
 
+    /**
+     * GroupIndex of the decision group should match the placementDecisions label value with label key cluster.open-cluster-management.io/decision-group-index
+     */
     @JsonProperty("groupIndex")
     public void setGroupIndex(Integer groupIndex) {
         this.groupIndex = groupIndex;
     }
 
+    /**
+     * GroupName of the decision group should match the placementDecisions label value with label key cluster.open-cluster-management.io/decision-group-name
+     */
     @JsonProperty("groupName")
     public String getGroupName() {
         return groupName;
     }
 
+    /**
+     * GroupName of the decision group should match the placementDecisions label value with label key cluster.open-cluster-management.io/decision-group-name
+     */
     @JsonProperty("groupName")
     public void setGroupName(String groupName) {
         this.groupName = groupName;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/MandatoryDecisionGroups.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/MandatoryDecisionGroups.java
index 5f837534661..cf1ab9fbfcc 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/MandatoryDecisionGroups.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/MandatoryDecisionGroups.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MandatoryDecisionGroups
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public MandatoryDecisionGroups(List<MandatoryDecisionGroup> mandatoryDecisionGro
         this.mandatoryDecisionGroups = mandatoryDecisionGroups;
     }
 
+    /**
+     * List of the decision groups names or indexes to apply the workload first and fail if workload did not reach successful state. GroupName or GroupIndex must match with the decisionGroups defined in the placement's decisionStrategy
+     */
     @JsonProperty("mandatoryDecisionGroups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MandatoryDecisionGroup> getMandatoryDecisionGroups() {
         return mandatoryDecisionGroups;
     }
 
+    /**
+     * List of the decision groups names or indexes to apply the workload first and fail if workload did not reach successful state. GroupName or GroupIndex must match with the decisionGroups defined in the placement's decisionStrategy
+     */
     @JsonProperty("mandatoryDecisionGroups")
     public void setMandatoryDecisionGroups(List<MandatoryDecisionGroup> mandatoryDecisionGroups) {
         this.mandatoryDecisionGroups = mandatoryDecisionGroups;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/RolloutAll.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/RolloutAll.java
index b5f0e759b11..a10ba1229d5 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/RolloutAll.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/RolloutAll.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RolloutAll is a RolloutStrategy Type
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,31 +90,49 @@ public RolloutAll(IntOrString maxFailures, Duration minSuccessTime, String progr
         this.progressDeadline = progressDeadline;
     }
 
+    /**
+     * RolloutAll is a RolloutStrategy Type
+     */
     @JsonProperty("maxFailures")
     public IntOrString getMaxFailures() {
         return maxFailures;
     }
 
+    /**
+     * RolloutAll is a RolloutStrategy Type
+     */
     @JsonProperty("maxFailures")
     public void setMaxFailures(IntOrString maxFailures) {
         this.maxFailures = maxFailures;
     }
 
+    /**
+     * RolloutAll is a RolloutStrategy Type
+     */
     @JsonProperty("minSuccessTime")
     public Duration getMinSuccessTime() {
         return minSuccessTime;
     }
 
+    /**
+     * RolloutAll is a RolloutStrategy Type
+     */
     @JsonProperty("minSuccessTime")
     public void setMinSuccessTime(Duration minSuccessTime) {
         this.minSuccessTime = minSuccessTime;
     }
 
+    /**
+     * ProgressDeadline defines how long workload applier controller will wait for the workload to reach a successful state in the cluster. If the workload does not reach a successful state after ProgressDeadline, will stop waiting and workload will be treated as "timeout" and be counted into MaxFailures. Once the MaxFailures is breached, the rollout will stop. ProgressDeadline default value is "None", meaning the workload applier will wait for a successful state indefinitely. ProgressDeadline must be defined in [0-9h]|[0-9m]|[0-9s] format examples; 2h , 90m , 360s
+     */
     @JsonProperty("progressDeadline")
     public String getProgressDeadline() {
         return progressDeadline;
     }
 
+    /**
+     * ProgressDeadline defines how long workload applier controller will wait for the workload to reach a successful state in the cluster. If the workload does not reach a successful state after ProgressDeadline, will stop waiting and workload will be treated as "timeout" and be counted into MaxFailures. Once the MaxFailures is breached, the rollout will stop. ProgressDeadline default value is "None", meaning the workload applier will wait for a successful state indefinitely. ProgressDeadline must be defined in [0-9h]|[0-9m]|[0-9s] format examples; 2h , 90m , 360s
+     */
     @JsonProperty("progressDeadline")
     public void setProgressDeadline(String progressDeadline) {
         this.progressDeadline = progressDeadline;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/RolloutConfig.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/RolloutConfig.java
index 166eeea1c4a..cc5c81a5838 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/RolloutConfig.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/RolloutConfig.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Timeout to consider while applying the workload.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,31 +90,49 @@ public RolloutConfig(IntOrString maxFailures, Duration minSuccessTime, String pr
         this.progressDeadline = progressDeadline;
     }
 
+    /**
+     * Timeout to consider while applying the workload.
+     */
     @JsonProperty("maxFailures")
     public IntOrString getMaxFailures() {
         return maxFailures;
     }
 
+    /**
+     * Timeout to consider while applying the workload.
+     */
     @JsonProperty("maxFailures")
     public void setMaxFailures(IntOrString maxFailures) {
         this.maxFailures = maxFailures;
     }
 
+    /**
+     * Timeout to consider while applying the workload.
+     */
     @JsonProperty("minSuccessTime")
     public Duration getMinSuccessTime() {
         return minSuccessTime;
     }
 
+    /**
+     * Timeout to consider while applying the workload.
+     */
     @JsonProperty("minSuccessTime")
     public void setMinSuccessTime(Duration minSuccessTime) {
         this.minSuccessTime = minSuccessTime;
     }
 
+    /**
+     * ProgressDeadline defines how long workload applier controller will wait for the workload to reach a successful state in the cluster. If the workload does not reach a successful state after ProgressDeadline, will stop waiting and workload will be treated as "timeout" and be counted into MaxFailures. Once the MaxFailures is breached, the rollout will stop. ProgressDeadline default value is "None", meaning the workload applier will wait for a successful state indefinitely. ProgressDeadline must be defined in [0-9h]|[0-9m]|[0-9s] format examples; 2h , 90m , 360s
+     */
     @JsonProperty("progressDeadline")
     public String getProgressDeadline() {
         return progressDeadline;
     }
 
+    /**
+     * ProgressDeadline defines how long workload applier controller will wait for the workload to reach a successful state in the cluster. If the workload does not reach a successful state after ProgressDeadline, will stop waiting and workload will be treated as "timeout" and be counted into MaxFailures. Once the MaxFailures is breached, the rollout will stop. ProgressDeadline default value is "None", meaning the workload applier will wait for a successful state indefinitely. ProgressDeadline must be defined in [0-9h]|[0-9m]|[0-9s] format examples; 2h , 90m , 360s
+     */
     @JsonProperty("progressDeadline")
     public void setProgressDeadline(String progressDeadline) {
         this.progressDeadline = progressDeadline;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/RolloutProgressive.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/RolloutProgressive.java
index f47129bc6db..80b8d535380 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/RolloutProgressive.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/RolloutProgressive.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RolloutProgressive is a RolloutStrategy Type
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,52 +101,82 @@ public RolloutProgressive(List<MandatoryDecisionGroup> mandatoryDecisionGroups,
         this.progressDeadline = progressDeadline;
     }
 
+    /**
+     * List of the decision groups names or indexes to apply the workload first and fail if workload did not reach successful state. GroupName or GroupIndex must match with the decisionGroups defined in the placement's decisionStrategy
+     */
     @JsonProperty("mandatoryDecisionGroups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MandatoryDecisionGroup> getMandatoryDecisionGroups() {
         return mandatoryDecisionGroups;
     }
 
+    /**
+     * List of the decision groups names or indexes to apply the workload first and fail if workload did not reach successful state. GroupName or GroupIndex must match with the decisionGroups defined in the placement's decisionStrategy
+     */
     @JsonProperty("mandatoryDecisionGroups")
     public void setMandatoryDecisionGroups(List<MandatoryDecisionGroup> mandatoryDecisionGroups) {
         this.mandatoryDecisionGroups = mandatoryDecisionGroups;
     }
 
+    /**
+     * RolloutProgressive is a RolloutStrategy Type
+     */
     @JsonProperty("maxConcurrency")
     public IntOrString getMaxConcurrency() {
         return maxConcurrency;
     }
 
+    /**
+     * RolloutProgressive is a RolloutStrategy Type
+     */
     @JsonProperty("maxConcurrency")
     public void setMaxConcurrency(IntOrString maxConcurrency) {
         this.maxConcurrency = maxConcurrency;
     }
 
+    /**
+     * RolloutProgressive is a RolloutStrategy Type
+     */
     @JsonProperty("maxFailures")
     public IntOrString getMaxFailures() {
         return maxFailures;
     }
 
+    /**
+     * RolloutProgressive is a RolloutStrategy Type
+     */
     @JsonProperty("maxFailures")
     public void setMaxFailures(IntOrString maxFailures) {
         this.maxFailures = maxFailures;
     }
 
+    /**
+     * RolloutProgressive is a RolloutStrategy Type
+     */
     @JsonProperty("minSuccessTime")
     public Duration getMinSuccessTime() {
         return minSuccessTime;
     }
 
+    /**
+     * RolloutProgressive is a RolloutStrategy Type
+     */
     @JsonProperty("minSuccessTime")
     public void setMinSuccessTime(Duration minSuccessTime) {
         this.minSuccessTime = minSuccessTime;
     }
 
+    /**
+     * ProgressDeadline defines how long workload applier controller will wait for the workload to reach a successful state in the cluster. If the workload does not reach a successful state after ProgressDeadline, will stop waiting and workload will be treated as "timeout" and be counted into MaxFailures. Once the MaxFailures is breached, the rollout will stop. ProgressDeadline default value is "None", meaning the workload applier will wait for a successful state indefinitely. ProgressDeadline must be defined in [0-9h]|[0-9m]|[0-9s] format examples; 2h , 90m , 360s
+     */
     @JsonProperty("progressDeadline")
     public String getProgressDeadline() {
         return progressDeadline;
     }
 
+    /**
+     * ProgressDeadline defines how long workload applier controller will wait for the workload to reach a successful state in the cluster. If the workload does not reach a successful state after ProgressDeadline, will stop waiting and workload will be treated as "timeout" and be counted into MaxFailures. Once the MaxFailures is breached, the rollout will stop. ProgressDeadline default value is "None", meaning the workload applier will wait for a successful state indefinitely. ProgressDeadline must be defined in [0-9h]|[0-9m]|[0-9s] format examples; 2h , 90m , 360s
+     */
     @JsonProperty("progressDeadline")
     public void setProgressDeadline(String progressDeadline) {
         this.progressDeadline = progressDeadline;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/RolloutProgressivePerGroup.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/RolloutProgressivePerGroup.java
index 7dc930be29a..110f17e1ec2 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/RolloutProgressivePerGroup.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/RolloutProgressivePerGroup.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RolloutProgressivePerGroup is a RolloutStrategy Type
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,42 +97,66 @@ public RolloutProgressivePerGroup(List<MandatoryDecisionGroup> mandatoryDecision
         this.progressDeadline = progressDeadline;
     }
 
+    /**
+     * List of the decision groups names or indexes to apply the workload first and fail if workload did not reach successful state. GroupName or GroupIndex must match with the decisionGroups defined in the placement's decisionStrategy
+     */
     @JsonProperty("mandatoryDecisionGroups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MandatoryDecisionGroup> getMandatoryDecisionGroups() {
         return mandatoryDecisionGroups;
     }
 
+    /**
+     * List of the decision groups names or indexes to apply the workload first and fail if workload did not reach successful state. GroupName or GroupIndex must match with the decisionGroups defined in the placement's decisionStrategy
+     */
     @JsonProperty("mandatoryDecisionGroups")
     public void setMandatoryDecisionGroups(List<MandatoryDecisionGroup> mandatoryDecisionGroups) {
         this.mandatoryDecisionGroups = mandatoryDecisionGroups;
     }
 
+    /**
+     * RolloutProgressivePerGroup is a RolloutStrategy Type
+     */
     @JsonProperty("maxFailures")
     public IntOrString getMaxFailures() {
         return maxFailures;
     }
 
+    /**
+     * RolloutProgressivePerGroup is a RolloutStrategy Type
+     */
     @JsonProperty("maxFailures")
     public void setMaxFailures(IntOrString maxFailures) {
         this.maxFailures = maxFailures;
     }
 
+    /**
+     * RolloutProgressivePerGroup is a RolloutStrategy Type
+     */
     @JsonProperty("minSuccessTime")
     public Duration getMinSuccessTime() {
         return minSuccessTime;
     }
 
+    /**
+     * RolloutProgressivePerGroup is a RolloutStrategy Type
+     */
     @JsonProperty("minSuccessTime")
     public void setMinSuccessTime(Duration minSuccessTime) {
         this.minSuccessTime = minSuccessTime;
     }
 
+    /**
+     * ProgressDeadline defines how long workload applier controller will wait for the workload to reach a successful state in the cluster. If the workload does not reach a successful state after ProgressDeadline, will stop waiting and workload will be treated as "timeout" and be counted into MaxFailures. Once the MaxFailures is breached, the rollout will stop. ProgressDeadline default value is "None", meaning the workload applier will wait for a successful state indefinitely. ProgressDeadline must be defined in [0-9h]|[0-9m]|[0-9s] format examples; 2h , 90m , 360s
+     */
     @JsonProperty("progressDeadline")
     public String getProgressDeadline() {
         return progressDeadline;
     }
 
+    /**
+     * ProgressDeadline defines how long workload applier controller will wait for the workload to reach a successful state in the cluster. If the workload does not reach a successful state after ProgressDeadline, will stop waiting and workload will be treated as "timeout" and be counted into MaxFailures. Once the MaxFailures is breached, the rollout will stop. ProgressDeadline default value is "None", meaning the workload applier will wait for a successful state indefinitely. ProgressDeadline must be defined in [0-9h]|[0-9m]|[0-9s] format examples; 2h , 90m , 360s
+     */
     @JsonProperty("progressDeadline")
     public void setProgressDeadline(String progressDeadline) {
         this.progressDeadline = progressDeadline;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/RolloutStrategy.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/RolloutStrategy.java
index 82080009336..284a9d2aa0f 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/RolloutStrategy.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1alpha1/RolloutStrategy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Rollout strategy to apply workload to the selected clusters by Placement and DecisionStrategy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public RolloutStrategy(RolloutAll all, RolloutProgressive progressive, RolloutPr
         this.type = type;
     }
 
+    /**
+     * Rollout strategy to apply workload to the selected clusters by Placement and DecisionStrategy.
+     */
     @JsonProperty("all")
     public RolloutAll getAll() {
         return all;
     }
 
+    /**
+     * Rollout strategy to apply workload to the selected clusters by Placement and DecisionStrategy.
+     */
     @JsonProperty("all")
     public void setAll(RolloutAll all) {
         this.all = all;
     }
 
+    /**
+     * Rollout strategy to apply workload to the selected clusters by Placement and DecisionStrategy.
+     */
     @JsonProperty("progressive")
     public RolloutProgressive getProgressive() {
         return progressive;
     }
 
+    /**
+     * Rollout strategy to apply workload to the selected clusters by Placement and DecisionStrategy.
+     */
     @JsonProperty("progressive")
     public void setProgressive(RolloutProgressive progressive) {
         this.progressive = progressive;
     }
 
+    /**
+     * Rollout strategy to apply workload to the selected clusters by Placement and DecisionStrategy.
+     */
     @JsonProperty("progressivePerGroup")
     public RolloutProgressivePerGroup getProgressivePerGroup() {
         return progressivePerGroup;
     }
 
+    /**
+     * Rollout strategy to apply workload to the selected clusters by Placement and DecisionStrategy.
+     */
     @JsonProperty("progressivePerGroup")
     public void setProgressivePerGroup(RolloutProgressivePerGroup progressivePerGroup) {
         this.progressivePerGroup = progressivePerGroup;
     }
 
+    /**
+     * Rollout strategy to apply workload to the selected clusters by Placement and DecisionStrategy.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Rollout strategy to apply workload to the selected clusters by Placement and DecisionStrategy.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/AddOnScore.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/AddOnScore.java
index 6c1e6ac1aec..f6d8a63fb24 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/AddOnScore.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/AddOnScore.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AddOnScore represents the configuration of the addon score source.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public AddOnScore(String resourceName, String scoreName) {
         this.scoreName = scoreName;
     }
 
+    /**
+     * ResourceName defines the resource name of the AddOnPlacementScore. The placement prioritizer selects AddOnPlacementScore CR by this name.
+     */
     @JsonProperty("resourceName")
     public String getResourceName() {
         return resourceName;
     }
 
+    /**
+     * ResourceName defines the resource name of the AddOnPlacementScore. The placement prioritizer selects AddOnPlacementScore CR by this name.
+     */
     @JsonProperty("resourceName")
     public void setResourceName(String resourceName) {
         this.resourceName = resourceName;
     }
 
+    /**
+     * ScoreName defines the score name inside AddOnPlacementScore. AddOnPlacementScore contains a list of score name and score value, ScoreName specify the score to be used by the prioritizer.
+     */
     @JsonProperty("scoreName")
     public String getScoreName() {
         return scoreName;
     }
 
+    /**
+     * ScoreName defines the score name inside AddOnPlacementScore. AddOnPlacementScore contains a list of score name and score value, ScoreName specify the score to be used by the prioritizer.
+     */
     @JsonProperty("scoreName")
     public void setScoreName(String scoreName) {
         this.scoreName = scoreName;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/ClusterClaimSelector.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/ClusterClaimSelector.java
index 5fa31b52560..0f30811ba67 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/ClusterClaimSelector.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/ClusterClaimSelector.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterClaimSelector is a claim query over a set of ManagedClusters. An empty cluster claim selector matches all objects. A null cluster claim selector matches no objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,12 +85,18 @@ public ClusterClaimSelector(List<LabelSelectorRequirement> matchExpressions) {
         this.matchExpressions = matchExpressions;
     }
 
+    /**
+     * matchExpressions is a list of cluster claim selector requirements. The requirements are ANDed.
+     */
     @JsonProperty("matchExpressions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LabelSelectorRequirement> getMatchExpressions() {
         return matchExpressions;
     }
 
+    /**
+     * matchExpressions is a list of cluster claim selector requirements. The requirements are ANDed.
+     */
     @JsonProperty("matchExpressions")
     public void setMatchExpressions(List<LabelSelectorRequirement> matchExpressions) {
         this.matchExpressions = matchExpressions;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/ClusterDecision.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/ClusterDecision.java
index f82734e27bd..a8bf62e07f8 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/ClusterDecision.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/ClusterDecision.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterDecision represents a decision from a placement An empty ClusterDecision indicates it is not scheduled yet.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ClusterDecision(String clusterName, String reason) {
         this.reason = reason;
     }
 
+    /**
+     * ClusterName is the name of the ManagedCluster. If it is not empty, its value should be unique cross all placement decisions for the Placement.
+     */
     @JsonProperty("clusterName")
     public String getClusterName() {
         return clusterName;
     }
 
+    /**
+     * ClusterName is the name of the ManagedCluster. If it is not empty, its value should be unique cross all placement decisions for the Placement.
+     */
     @JsonProperty("clusterName")
     public void setClusterName(String clusterName) {
         this.clusterName = clusterName;
     }
 
+    /**
+     * Reason represents the reason why the ManagedCluster is selected.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason represents the reason why the ManagedCluster is selected.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/ClusterPredicate.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/ClusterPredicate.java
index 95d1c1cf0d6..b8ae5d1fc4b 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/ClusterPredicate.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/ClusterPredicate.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterPredicate represents a predicate to select ManagedClusters.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ClusterPredicate(ClusterSelector requiredClusterSelector) {
         this.requiredClusterSelector = requiredClusterSelector;
     }
 
+    /**
+     * ClusterPredicate represents a predicate to select ManagedClusters.
+     */
     @JsonProperty("requiredClusterSelector")
     public ClusterSelector getRequiredClusterSelector() {
         return requiredClusterSelector;
     }
 
+    /**
+     * ClusterPredicate represents a predicate to select ManagedClusters.
+     */
     @JsonProperty("requiredClusterSelector")
     public void setRequiredClusterSelector(ClusterSelector requiredClusterSelector) {
         this.requiredClusterSelector = requiredClusterSelector;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/ClusterSelector.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/ClusterSelector.java
index c8683ad914d..a38458dc777 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/ClusterSelector.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/ClusterSelector.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterSelector represents the AND of the containing selectors. An empty cluster selector matches all objects. A null cluster selector matches no objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ClusterSelector(ClusterClaimSelector claimSelector, LabelSelector labelSe
         this.labelSelector = labelSelector;
     }
 
+    /**
+     * ClusterSelector represents the AND of the containing selectors. An empty cluster selector matches all objects. A null cluster selector matches no objects.
+     */
     @JsonProperty("claimSelector")
     public ClusterClaimSelector getClaimSelector() {
         return claimSelector;
     }
 
+    /**
+     * ClusterSelector represents the AND of the containing selectors. An empty cluster selector matches all objects. A null cluster selector matches no objects.
+     */
     @JsonProperty("claimSelector")
     public void setClaimSelector(ClusterClaimSelector claimSelector) {
         this.claimSelector = claimSelector;
     }
 
+    /**
+     * ClusterSelector represents the AND of the containing selectors. An empty cluster selector matches all objects. A null cluster selector matches no objects.
+     */
     @JsonProperty("labelSelector")
     public LabelSelector getLabelSelector() {
         return labelSelector;
     }
 
+    /**
+     * ClusterSelector represents the AND of the containing selectors. An empty cluster selector matches all objects. A null cluster selector matches no objects.
+     */
     @JsonProperty("labelSelector")
     public void setLabelSelector(LabelSelector labelSelector) {
         this.labelSelector = labelSelector;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/DecisionGroup.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/DecisionGroup.java
index 8d25a93a7a6..af85532f3c5 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/DecisionGroup.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/DecisionGroup.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DecisionGroup define a subset of clusters that will be added to placementDecisions with groupName label.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public DecisionGroup(ClusterSelector groupClusterSelector, String groupName) {
         this.groupName = groupName;
     }
 
+    /**
+     * DecisionGroup define a subset of clusters that will be added to placementDecisions with groupName label.
+     */
     @JsonProperty("groupClusterSelector")
     public ClusterSelector getGroupClusterSelector() {
         return groupClusterSelector;
     }
 
+    /**
+     * DecisionGroup define a subset of clusters that will be added to placementDecisions with groupName label.
+     */
     @JsonProperty("groupClusterSelector")
     public void setGroupClusterSelector(ClusterSelector groupClusterSelector) {
         this.groupClusterSelector = groupClusterSelector;
     }
 
+    /**
+     * Group name to be added as label value to the created placement Decisions labels with label key cluster.open-cluster-management.io/decision-group-name
+     */
     @JsonProperty("groupName")
     public String getGroupName() {
         return groupName;
     }
 
+    /**
+     * Group name to be added as label value to the created placement Decisions labels with label key cluster.open-cluster-management.io/decision-group-name
+     */
     @JsonProperty("groupName")
     public void setGroupName(String groupName) {
         this.groupName = groupName;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/DecisionGroupStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/DecisionGroupStatus.java
index 07687efb78d..5adb02812bc 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/DecisionGroupStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/DecisionGroupStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Present decision groups status based on the DecisionStrategy definition.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public DecisionGroupStatus(Integer clusterCount, Integer decisionGroupIndex, Str
         this.decisions = decisions;
     }
 
+    /**
+     * Total number of clusters in the decision group. Clusters count is equal or less than the clusterPerDecisionGroups defined in the decision strategy.
+     */
     @JsonProperty("clusterCount")
     public Integer getClusterCount() {
         return clusterCount;
     }
 
+    /**
+     * Total number of clusters in the decision group. Clusters count is equal or less than the clusterPerDecisionGroups defined in the decision strategy.
+     */
     @JsonProperty("clusterCount")
     public void setClusterCount(Integer clusterCount) {
         this.clusterCount = clusterCount;
     }
 
+    /**
+     * Present the decision group index. If there is no decision strategy defined all placement decisions will be in group index 0
+     */
     @JsonProperty("decisionGroupIndex")
     public Integer getDecisionGroupIndex() {
         return decisionGroupIndex;
     }
 
+    /**
+     * Present the decision group index. If there is no decision strategy defined all placement decisions will be in group index 0
+     */
     @JsonProperty("decisionGroupIndex")
     public void setDecisionGroupIndex(Integer decisionGroupIndex) {
         this.decisionGroupIndex = decisionGroupIndex;
     }
 
+    /**
+     * Decision group name that is defined in the DecisionStrategy's DecisionGroup.
+     */
     @JsonProperty("decisionGroupName")
     public String getDecisionGroupName() {
         return decisionGroupName;
     }
 
+    /**
+     * Decision group name that is defined in the DecisionStrategy's DecisionGroup.
+     */
     @JsonProperty("decisionGroupName")
     public void setDecisionGroupName(String decisionGroupName) {
         this.decisionGroupName = decisionGroupName;
     }
 
+    /**
+     * List of placement decisions names associated with the decision group
+     */
     @JsonProperty("decisions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDecisions() {
         return decisions;
     }
 
+    /**
+     * List of placement decisions names associated with the decision group
+     */
     @JsonProperty("decisions")
     public void setDecisions(List<String> decisions) {
         this.decisions = decisions;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/DecisionStrategy.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/DecisionStrategy.java
index 93eebb8c1a6..a305f35e826 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/DecisionStrategy.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/DecisionStrategy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DecisionStrategy divide the created placement decision to groups and define number of clusters per decision group.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public DecisionStrategy(GroupStrategy groupStrategy) {
         this.groupStrategy = groupStrategy;
     }
 
+    /**
+     * DecisionStrategy divide the created placement decision to groups and define number of clusters per decision group.
+     */
     @JsonProperty("groupStrategy")
     public GroupStrategy getGroupStrategy() {
         return groupStrategy;
     }
 
+    /**
+     * DecisionStrategy divide the created placement decision to groups and define number of clusters per decision group.
+     */
     @JsonProperty("groupStrategy")
     public void setGroupStrategy(GroupStrategy groupStrategy) {
         this.groupStrategy = groupStrategy;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/GroupStrategy.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/GroupStrategy.java
index 853aa9e052f..aeaee4a11c7 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/GroupStrategy.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/GroupStrategy.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Group the created placementDecision into decision groups based on the number of clusters per decision group.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public GroupStrategy(IntOrString clustersPerDecisionGroup, List<DecisionGroup> d
         this.decisionGroups = decisionGroups;
     }
 
+    /**
+     * Group the created placementDecision into decision groups based on the number of clusters per decision group.
+     */
     @JsonProperty("clustersPerDecisionGroup")
     public IntOrString getClustersPerDecisionGroup() {
         return clustersPerDecisionGroup;
     }
 
+    /**
+     * Group the created placementDecision into decision groups based on the number of clusters per decision group.
+     */
     @JsonProperty("clustersPerDecisionGroup")
     public void setClustersPerDecisionGroup(IntOrString clustersPerDecisionGroup) {
         this.clustersPerDecisionGroup = clustersPerDecisionGroup;
     }
 
+    /**
+     * DecisionGroups represents a list of predefined groups to put decision results. Decision groups will be constructed based on the DecisionGroups field at first. The clusters not included in the DecisionGroups will be divided to other decision groups afterwards. Each decision group should not have the number of clusters larger than the ClustersPerDecisionGroup.
+     */
     @JsonProperty("decisionGroups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DecisionGroup> getDecisionGroups() {
         return decisionGroups;
     }
 
+    /**
+     * DecisionGroups represents a list of predefined groups to put decision results. Decision groups will be constructed based on the DecisionGroups field at first. The clusters not included in the DecisionGroups will be divided to other decision groups afterwards. Each decision group should not have the number of clusters larger than the ClustersPerDecisionGroup.
+     */
     @JsonProperty("decisionGroups")
     public void setDecisionGroups(List<DecisionGroup> decisionGroups) {
         this.decisionGroups = decisionGroups;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/Placement.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/Placement.java
index b29339445f3..7bc9a6e8ac8 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/Placement.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/Placement.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Placement defines a rule to select a set of ManagedClusters from the ManagedClusterSets bound to the placement namespace.<br><p> <br><p> Here is how the placement policy combines with other selection methods to determine a matching list of ManagedClusters:<br><p>  1. Kubernetes clusters are registered with hub as cluster-scoped ManagedClusters;<br><p>  2. ManagedClusters are organized into cluster-scoped ManagedClusterSets;<br><p>  3. ManagedClusterSets are bound to workload namespaces;<br><p>  4. Namespace-scoped Placements specify a slice of ManagedClusterSets which select a working set<br><p>     of potential ManagedClusters;<br><p>  5. Then Placements subselect from that working set using label/claim selection.<br><p> <br><p> A ManagedCluster will not be selected if no ManagedClusterSet is bound to the placement namespace. A user is able to bind a ManagedClusterSet to a namespace by creating a ManagedClusterSetBinding in that namespace if they have an RBAC rule to CREATE on the virtual subresource of `managedclustersets/bind`.<br><p> <br><p> A slice of PlacementDecisions with the label cluster.open-cluster-management.io/placement={placement name} will be created to represent the ManagedClusters selected by this placement.<br><p> <br><p> If a ManagedCluster is selected and added into the PlacementDecisions, other components may apply workload on it; once it is removed from the PlacementDecisions, the workload applied on this ManagedCluster should be evicted accordingly.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Placement implements Editable<PlacementBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cluster.open-cluster-management.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Placement";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Placement(String apiVersion, String kind, ObjectMeta metadata, PlacementS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Placement defines a rule to select a set of ManagedClusters from the ManagedClusterSets bound to the placement namespace.<br><p> <br><p> Here is how the placement policy combines with other selection methods to determine a matching list of ManagedClusters:<br><p>  1. Kubernetes clusters are registered with hub as cluster-scoped ManagedClusters;<br><p>  2. ManagedClusters are organized into cluster-scoped ManagedClusterSets;<br><p>  3. ManagedClusterSets are bound to workload namespaces;<br><p>  4. Namespace-scoped Placements specify a slice of ManagedClusterSets which select a working set<br><p>     of potential ManagedClusters;<br><p>  5. Then Placements subselect from that working set using label/claim selection.<br><p> <br><p> A ManagedCluster will not be selected if no ManagedClusterSet is bound to the placement namespace. A user is able to bind a ManagedClusterSet to a namespace by creating a ManagedClusterSetBinding in that namespace if they have an RBAC rule to CREATE on the virtual subresource of `managedclustersets/bind`.<br><p> <br><p> A slice of PlacementDecisions with the label cluster.open-cluster-management.io/placement={placement name} will be created to represent the ManagedClusters selected by this placement.<br><p> <br><p> If a ManagedCluster is selected and added into the PlacementDecisions, other components may apply workload on it; once it is removed from the PlacementDecisions, the workload applied on this ManagedCluster should be evicted accordingly.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Placement defines a rule to select a set of ManagedClusters from the ManagedClusterSets bound to the placement namespace.<br><p> <br><p> Here is how the placement policy combines with other selection methods to determine a matching list of ManagedClusters:<br><p>  1. Kubernetes clusters are registered with hub as cluster-scoped ManagedClusters;<br><p>  2. ManagedClusters are organized into cluster-scoped ManagedClusterSets;<br><p>  3. ManagedClusterSets are bound to workload namespaces;<br><p>  4. Namespace-scoped Placements specify a slice of ManagedClusterSets which select a working set<br><p>     of potential ManagedClusters;<br><p>  5. Then Placements subselect from that working set using label/claim selection.<br><p> <br><p> A ManagedCluster will not be selected if no ManagedClusterSet is bound to the placement namespace. A user is able to bind a ManagedClusterSet to a namespace by creating a ManagedClusterSetBinding in that namespace if they have an RBAC rule to CREATE on the virtual subresource of `managedclustersets/bind`.<br><p> <br><p> A slice of PlacementDecisions with the label cluster.open-cluster-management.io/placement={placement name} will be created to represent the ManagedClusters selected by this placement.<br><p> <br><p> If a ManagedCluster is selected and added into the PlacementDecisions, other components may apply workload on it; once it is removed from the PlacementDecisions, the workload applied on this ManagedCluster should be evicted accordingly.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Placement defines a rule to select a set of ManagedClusters from the ManagedClusterSets bound to the placement namespace.<br><p> <br><p> Here is how the placement policy combines with other selection methods to determine a matching list of ManagedClusters:<br><p>  1. Kubernetes clusters are registered with hub as cluster-scoped ManagedClusters;<br><p>  2. ManagedClusters are organized into cluster-scoped ManagedClusterSets;<br><p>  3. ManagedClusterSets are bound to workload namespaces;<br><p>  4. Namespace-scoped Placements specify a slice of ManagedClusterSets which select a working set<br><p>     of potential ManagedClusters;<br><p>  5. Then Placements subselect from that working set using label/claim selection.<br><p> <br><p> A ManagedCluster will not be selected if no ManagedClusterSet is bound to the placement namespace. A user is able to bind a ManagedClusterSet to a namespace by creating a ManagedClusterSetBinding in that namespace if they have an RBAC rule to CREATE on the virtual subresource of `managedclustersets/bind`.<br><p> <br><p> A slice of PlacementDecisions with the label cluster.open-cluster-management.io/placement={placement name} will be created to represent the ManagedClusters selected by this placement.<br><p> <br><p> If a ManagedCluster is selected and added into the PlacementDecisions, other components may apply workload on it; once it is removed from the PlacementDecisions, the workload applied on this ManagedCluster should be evicted accordingly.
+     */
     @JsonProperty("spec")
     public PlacementSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Placement defines a rule to select a set of ManagedClusters from the ManagedClusterSets bound to the placement namespace.<br><p> <br><p> Here is how the placement policy combines with other selection methods to determine a matching list of ManagedClusters:<br><p>  1. Kubernetes clusters are registered with hub as cluster-scoped ManagedClusters;<br><p>  2. ManagedClusters are organized into cluster-scoped ManagedClusterSets;<br><p>  3. ManagedClusterSets are bound to workload namespaces;<br><p>  4. Namespace-scoped Placements specify a slice of ManagedClusterSets which select a working set<br><p>     of potential ManagedClusters;<br><p>  5. Then Placements subselect from that working set using label/claim selection.<br><p> <br><p> A ManagedCluster will not be selected if no ManagedClusterSet is bound to the placement namespace. A user is able to bind a ManagedClusterSet to a namespace by creating a ManagedClusterSetBinding in that namespace if they have an RBAC rule to CREATE on the virtual subresource of `managedclustersets/bind`.<br><p> <br><p> A slice of PlacementDecisions with the label cluster.open-cluster-management.io/placement={placement name} will be created to represent the ManagedClusters selected by this placement.<br><p> <br><p> If a ManagedCluster is selected and added into the PlacementDecisions, other components may apply workload on it; once it is removed from the PlacementDecisions, the workload applied on this ManagedCluster should be evicted accordingly.
+     */
     @JsonProperty("spec")
     public void setSpec(PlacementSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Placement defines a rule to select a set of ManagedClusters from the ManagedClusterSets bound to the placement namespace.<br><p> <br><p> Here is how the placement policy combines with other selection methods to determine a matching list of ManagedClusters:<br><p>  1. Kubernetes clusters are registered with hub as cluster-scoped ManagedClusters;<br><p>  2. ManagedClusters are organized into cluster-scoped ManagedClusterSets;<br><p>  3. ManagedClusterSets are bound to workload namespaces;<br><p>  4. Namespace-scoped Placements specify a slice of ManagedClusterSets which select a working set<br><p>     of potential ManagedClusters;<br><p>  5. Then Placements subselect from that working set using label/claim selection.<br><p> <br><p> A ManagedCluster will not be selected if no ManagedClusterSet is bound to the placement namespace. A user is able to bind a ManagedClusterSet to a namespace by creating a ManagedClusterSetBinding in that namespace if they have an RBAC rule to CREATE on the virtual subresource of `managedclustersets/bind`.<br><p> <br><p> A slice of PlacementDecisions with the label cluster.open-cluster-management.io/placement={placement name} will be created to represent the ManagedClusters selected by this placement.<br><p> <br><p> If a ManagedCluster is selected and added into the PlacementDecisions, other components may apply workload on it; once it is removed from the PlacementDecisions, the workload applied on this ManagedCluster should be evicted accordingly.
+     */
     @JsonProperty("status")
     public PlacementStatus getStatus() {
         return status;
     }
 
+    /**
+     * Placement defines a rule to select a set of ManagedClusters from the ManagedClusterSets bound to the placement namespace.<br><p> <br><p> Here is how the placement policy combines with other selection methods to determine a matching list of ManagedClusters:<br><p>  1. Kubernetes clusters are registered with hub as cluster-scoped ManagedClusters;<br><p>  2. ManagedClusters are organized into cluster-scoped ManagedClusterSets;<br><p>  3. ManagedClusterSets are bound to workload namespaces;<br><p>  4. Namespace-scoped Placements specify a slice of ManagedClusterSets which select a working set<br><p>     of potential ManagedClusters;<br><p>  5. Then Placements subselect from that working set using label/claim selection.<br><p> <br><p> A ManagedCluster will not be selected if no ManagedClusterSet is bound to the placement namespace. A user is able to bind a ManagedClusterSet to a namespace by creating a ManagedClusterSetBinding in that namespace if they have an RBAC rule to CREATE on the virtual subresource of `managedclustersets/bind`.<br><p> <br><p> A slice of PlacementDecisions with the label cluster.open-cluster-management.io/placement={placement name} will be created to represent the ManagedClusters selected by this placement.<br><p> <br><p> If a ManagedCluster is selected and added into the PlacementDecisions, other components may apply workload on it; once it is removed from the PlacementDecisions, the workload applied on this ManagedCluster should be evicted accordingly.
+     */
     @JsonProperty("status")
     public void setStatus(PlacementStatus status) {
         this.status = status;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PlacementDecision.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PlacementDecision.java
index 1c8bfd6168f..c8f709ca4c8 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PlacementDecision.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PlacementDecision.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PlacementDecision indicates a decision from a placement. PlacementDecision must have a cluster.open-cluster-management.io/placement={placement name} label to reference a certain placement.<br><p> <br><p> If a placement has spec.numberOfClusters specified, the total number of decisions contained in the status.decisions of PlacementDecisions must be the same as NumberOfClusters. Otherwise, the total number of decisions must equal the number of ManagedClusters that match the placement requirements.<br><p> <br><p> Some of the decisions might be empty when there are not enough ManagedClusters to meet the placement requirements.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class PlacementDecision implements Editable<PlacementDecisionBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cluster.open-cluster-management.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PlacementDecision";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public PlacementDecision(String apiVersion, String kind, ObjectMeta metadata, Pl
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PlacementDecision indicates a decision from a placement. PlacementDecision must have a cluster.open-cluster-management.io/placement={placement name} label to reference a certain placement.<br><p> <br><p> If a placement has spec.numberOfClusters specified, the total number of decisions contained in the status.decisions of PlacementDecisions must be the same as NumberOfClusters. Otherwise, the total number of decisions must equal the number of ManagedClusters that match the placement requirements.<br><p> <br><p> Some of the decisions might be empty when there are not enough ManagedClusters to meet the placement requirements.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PlacementDecision indicates a decision from a placement. PlacementDecision must have a cluster.open-cluster-management.io/placement={placement name} label to reference a certain placement.<br><p> <br><p> If a placement has spec.numberOfClusters specified, the total number of decisions contained in the status.decisions of PlacementDecisions must be the same as NumberOfClusters. Otherwise, the total number of decisions must equal the number of ManagedClusters that match the placement requirements.<br><p> <br><p> Some of the decisions might be empty when there are not enough ManagedClusters to meet the placement requirements.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PlacementDecision indicates a decision from a placement. PlacementDecision must have a cluster.open-cluster-management.io/placement={placement name} label to reference a certain placement.<br><p> <br><p> If a placement has spec.numberOfClusters specified, the total number of decisions contained in the status.decisions of PlacementDecisions must be the same as NumberOfClusters. Otherwise, the total number of decisions must equal the number of ManagedClusters that match the placement requirements.<br><p> <br><p> Some of the decisions might be empty when there are not enough ManagedClusters to meet the placement requirements.
+     */
     @JsonProperty("status")
     public PlacementDecisionStatus getStatus() {
         return status;
     }
 
+    /**
+     * PlacementDecision indicates a decision from a placement. PlacementDecision must have a cluster.open-cluster-management.io/placement={placement name} label to reference a certain placement.<br><p> <br><p> If a placement has spec.numberOfClusters specified, the total number of decisions contained in the status.decisions of PlacementDecisions must be the same as NumberOfClusters. Otherwise, the total number of decisions must equal the number of ManagedClusters that match the placement requirements.<br><p> <br><p> Some of the decisions might be empty when there are not enough ManagedClusters to meet the placement requirements.
+     */
     @JsonProperty("status")
     public void setStatus(PlacementDecisionStatus status) {
         this.status = status;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PlacementDecisionList.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PlacementDecisionList.java
index 64dc8641fd5..271ef131fc4 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PlacementDecisionList.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PlacementDecisionList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterDecisionList is a collection of PlacementDecision.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PlacementDecisionList implements Editable<PlacementDecisionListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openclustermanagement.api.model.cluster.v1beta1.PlacementDecision>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cluster.open-cluster-management.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openclustermanagement.api.model.cluster.v1beta1.PlacementDecision> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PlacementDecisionList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PlacementDecisionList(String apiVersion, List<io.fabric8.openclustermanag
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of PlacementDecision.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openclustermanagement.api.model.cluster.v1beta1.PlacementDecision> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of PlacementDecision.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openclustermanagement.api.model.cluster.v1beta1.PlacementDecision> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterDecisionList is a collection of PlacementDecision.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterDecisionList is a collection of PlacementDecision.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PlacementDecisionStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PlacementDecisionStatus.java
index f5831d8f337..06db4b7c71d 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PlacementDecisionStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PlacementDecisionStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PlacementDecisionStatus represents the current status of the PlacementDecision.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public PlacementDecisionStatus(List<ClusterDecision> decisions) {
         this.decisions = decisions;
     }
 
+    /**
+     * Decisions is a slice of decisions according to a placement The number of decisions should not be larger than 100
+     */
     @JsonProperty("decisions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ClusterDecision> getDecisions() {
         return decisions;
     }
 
+    /**
+     * Decisions is a slice of decisions according to a placement The number of decisions should not be larger than 100
+     */
     @JsonProperty("decisions")
     public void setDecisions(List<ClusterDecision> decisions) {
         this.decisions = decisions;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PlacementList.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PlacementList.java
index 7039135e603..e233e1781c6 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PlacementList.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PlacementList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PlacementList is a collection of Placements.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PlacementList implements Editable<PlacementListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openclustermanagement.api.model.cluster.v1beta1.Placement>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cluster.open-cluster-management.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openclustermanagement.api.model.cluster.v1beta1.Placement> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PlacementList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PlacementList(String apiVersion, List<io.fabric8.openclustermanagement.ap
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of Placements.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openclustermanagement.api.model.cluster.v1beta1.Placement> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of Placements.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openclustermanagement.api.model.cluster.v1beta1.Placement> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PlacementList is a collection of Placements.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PlacementList is a collection of Placements.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PlacementSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PlacementSpec.java
index 46c92b5dabf..86b70e58f05 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PlacementSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PlacementSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PlacementSpec defines the attributes of Placement. An empty PlacementSpec selects all ManagedClusters from the ManagedClusterSets bound to the placement namespace. The containing fields are ANDed.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -107,74 +110,116 @@ public PlacementSpec(List<String> clusterSets, DecisionStrategy decisionStrategy
         this.tolerations = tolerations;
     }
 
+    /**
+     * ClusterSets represent the ManagedClusterSets from which the ManagedClusters are selected. If the slice is empty, ManagedClusters will be selected from the ManagedClusterSets bound to the placement namespace, otherwise ManagedClusters will be selected from the intersection of this slice and the ManagedClusterSets bound to the placement namespace.
+     */
     @JsonProperty("clusterSets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getClusterSets() {
         return clusterSets;
     }
 
+    /**
+     * ClusterSets represent the ManagedClusterSets from which the ManagedClusters are selected. If the slice is empty, ManagedClusters will be selected from the ManagedClusterSets bound to the placement namespace, otherwise ManagedClusters will be selected from the intersection of this slice and the ManagedClusterSets bound to the placement namespace.
+     */
     @JsonProperty("clusterSets")
     public void setClusterSets(List<String> clusterSets) {
         this.clusterSets = clusterSets;
     }
 
+    /**
+     * PlacementSpec defines the attributes of Placement. An empty PlacementSpec selects all ManagedClusters from the ManagedClusterSets bound to the placement namespace. The containing fields are ANDed.
+     */
     @JsonProperty("decisionStrategy")
     public DecisionStrategy getDecisionStrategy() {
         return decisionStrategy;
     }
 
+    /**
+     * PlacementSpec defines the attributes of Placement. An empty PlacementSpec selects all ManagedClusters from the ManagedClusterSets bound to the placement namespace. The containing fields are ANDed.
+     */
     @JsonProperty("decisionStrategy")
     public void setDecisionStrategy(DecisionStrategy decisionStrategy) {
         this.decisionStrategy = decisionStrategy;
     }
 
+    /**
+     * NumberOfClusters represents the desired number of ManagedClusters to be selected which meet the placement requirements. 1) If not specified, all ManagedClusters which meet the placement requirements (including ClusterSets,<br><p>    and Predicates) will be selected;<br><p> 2) Otherwise if the nubmer of ManagedClusters meet the placement requirements is larger than<br><p>    NumberOfClusters, a random subset with desired number of ManagedClusters will be selected;<br><p> 3) If the nubmer of ManagedClusters meet the placement requirements is equal to NumberOfClusters,<br><p>    all of them will be selected;<br><p> 4) If the nubmer of ManagedClusters meet the placement requirements is less than NumberOfClusters,<br><p>    all of them will be selected, and the status of condition `PlacementConditionSatisfied` will be<br><p>    set to false;
+     */
     @JsonProperty("numberOfClusters")
     public Integer getNumberOfClusters() {
         return numberOfClusters;
     }
 
+    /**
+     * NumberOfClusters represents the desired number of ManagedClusters to be selected which meet the placement requirements. 1) If not specified, all ManagedClusters which meet the placement requirements (including ClusterSets,<br><p>    and Predicates) will be selected;<br><p> 2) Otherwise if the nubmer of ManagedClusters meet the placement requirements is larger than<br><p>    NumberOfClusters, a random subset with desired number of ManagedClusters will be selected;<br><p> 3) If the nubmer of ManagedClusters meet the placement requirements is equal to NumberOfClusters,<br><p>    all of them will be selected;<br><p> 4) If the nubmer of ManagedClusters meet the placement requirements is less than NumberOfClusters,<br><p>    all of them will be selected, and the status of condition `PlacementConditionSatisfied` will be<br><p>    set to false;
+     */
     @JsonProperty("numberOfClusters")
     public void setNumberOfClusters(Integer numberOfClusters) {
         this.numberOfClusters = numberOfClusters;
     }
 
+    /**
+     * Predicates represent a slice of predicates to select ManagedClusters. The predicates are ORed.
+     */
     @JsonProperty("predicates")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ClusterPredicate> getPredicates() {
         return predicates;
     }
 
+    /**
+     * Predicates represent a slice of predicates to select ManagedClusters. The predicates are ORed.
+     */
     @JsonProperty("predicates")
     public void setPredicates(List<ClusterPredicate> predicates) {
         this.predicates = predicates;
     }
 
+    /**
+     * PlacementSpec defines the attributes of Placement. An empty PlacementSpec selects all ManagedClusters from the ManagedClusterSets bound to the placement namespace. The containing fields are ANDed.
+     */
     @JsonProperty("prioritizerPolicy")
     public PrioritizerPolicy getPrioritizerPolicy() {
         return prioritizerPolicy;
     }
 
+    /**
+     * PlacementSpec defines the attributes of Placement. An empty PlacementSpec selects all ManagedClusters from the ManagedClusterSets bound to the placement namespace. The containing fields are ANDed.
+     */
     @JsonProperty("prioritizerPolicy")
     public void setPrioritizerPolicy(PrioritizerPolicy prioritizerPolicy) {
         this.prioritizerPolicy = prioritizerPolicy;
     }
 
+    /**
+     * PlacementSpec defines the attributes of Placement. An empty PlacementSpec selects all ManagedClusters from the ManagedClusterSets bound to the placement namespace. The containing fields are ANDed.
+     */
     @JsonProperty("spreadPolicy")
     public SpreadPolicy getSpreadPolicy() {
         return spreadPolicy;
     }
 
+    /**
+     * PlacementSpec defines the attributes of Placement. An empty PlacementSpec selects all ManagedClusters from the ManagedClusterSets bound to the placement namespace. The containing fields are ANDed.
+     */
     @JsonProperty("spreadPolicy")
     public void setSpreadPolicy(SpreadPolicy spreadPolicy) {
         this.spreadPolicy = spreadPolicy;
     }
 
+    /**
+     * Tolerations are applied to placements, and allow (but do not require) the managed clusters with certain taints to be selected by placements with matching tolerations.
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * Tolerations are applied to placements, and allow (but do not require) the managed clusters with certain taints to be selected by placements with matching tolerations.
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PlacementStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PlacementStatus.java
index bd5f97ff8e4..65bc8f124b2 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PlacementStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PlacementStatus.java
@@ -91,33 +91,51 @@ public PlacementStatus(List<Condition> conditions, List<DecisionGroupStatus> dec
         this.numberOfSelectedClusters = numberOfSelectedClusters;
     }
 
+    /**
+     * Conditions contains the different condition status for this Placement.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions contains the different condition status for this Placement.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * List of decision groups determined by the placement and DecisionStrategy.
+     */
     @JsonProperty("decisionGroups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DecisionGroupStatus> getDecisionGroups() {
         return decisionGroups;
     }
 
+    /**
+     * List of decision groups determined by the placement and DecisionStrategy.
+     */
     @JsonProperty("decisionGroups")
     public void setDecisionGroups(List<DecisionGroupStatus> decisionGroups) {
         this.decisionGroups = decisionGroups;
     }
 
+    /**
+     * NumberOfSelectedClusters represents the number of selected ManagedClusters
+     */
     @JsonProperty("numberOfSelectedClusters")
     public Integer getNumberOfSelectedClusters() {
         return numberOfSelectedClusters;
     }
 
+    /**
+     * NumberOfSelectedClusters represents the number of selected ManagedClusters
+     */
     @JsonProperty("numberOfSelectedClusters")
     public void setNumberOfSelectedClusters(Integer numberOfSelectedClusters) {
         this.numberOfSelectedClusters = numberOfSelectedClusters;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PrioritizerConfig.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PrioritizerConfig.java
index ff476f66dce..f963cf49161 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PrioritizerConfig.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PrioritizerConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PrioritizerConfig represents the configuration of prioritizer
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PrioritizerConfig(ScoreCoordinate scoreCoordinate, Integer weight) {
         this.weight = weight;
     }
 
+    /**
+     * PrioritizerConfig represents the configuration of prioritizer
+     */
     @JsonProperty("scoreCoordinate")
     public ScoreCoordinate getScoreCoordinate() {
         return scoreCoordinate;
     }
 
+    /**
+     * PrioritizerConfig represents the configuration of prioritizer
+     */
     @JsonProperty("scoreCoordinate")
     public void setScoreCoordinate(ScoreCoordinate scoreCoordinate) {
         this.scoreCoordinate = scoreCoordinate;
     }
 
+    /**
+     * Weight defines the weight of the prioritizer score. The value must be ranged in [-10,10]. Each prioritizer will calculate an integer score of a cluster in the range of [-100, 100]. The final score of a cluster will be sum(weight &#42; prioritizer_score). A higher weight indicates that the prioritizer weights more in the cluster selection, while 0 weight indicates that the prioritizer is disabled. A negative weight indicates wants to select the last ones.
+     */
     @JsonProperty("weight")
     public Integer getWeight() {
         return weight;
     }
 
+    /**
+     * Weight defines the weight of the prioritizer score. The value must be ranged in [-10,10]. Each prioritizer will calculate an integer score of a cluster in the range of [-100, 100]. The final score of a cluster will be sum(weight &#42; prioritizer_score). A higher weight indicates that the prioritizer weights more in the cluster selection, while 0 weight indicates that the prioritizer is disabled. A negative weight indicates wants to select the last ones.
+     */
     @JsonProperty("weight")
     public void setWeight(Integer weight) {
         this.weight = weight;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PrioritizerPolicy.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PrioritizerPolicy.java
index 88b800baae2..49e2fa729c3 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PrioritizerPolicy.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/PrioritizerPolicy.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PrioritizerPolicy represents the policy of prioritizer
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public PrioritizerPolicy(List<PrioritizerConfig> configurations, String mode) {
         this.mode = mode;
     }
 
+    /**
+     * PrioritizerPolicy represents the policy of prioritizer
+     */
     @JsonProperty("configurations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PrioritizerConfig> getConfigurations() {
         return configurations;
     }
 
+    /**
+     * PrioritizerPolicy represents the policy of prioritizer
+     */
     @JsonProperty("configurations")
     public void setConfigurations(List<PrioritizerConfig> configurations) {
         this.configurations = configurations;
     }
 
+    /**
+     * Mode is either Exact, Additive, "" where "" is Additive by default. In Additive mode, any prioritizer not explicitly enumerated is enabled in its default Configurations, in which Steady and Balance prioritizers have the weight of 1 while other prioritizers have the weight of 0. Additive doesn't require configuring all prioritizers. The default Configurations may change in the future, and additional prioritization will happen. In Exact mode, any prioritizer not explicitly enumerated is weighted as zero. Exact requires knowing the full set of prioritizers you want, but avoids behavior changes between releases.
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Mode is either Exact, Additive, "" where "" is Additive by default. In Additive mode, any prioritizer not explicitly enumerated is enabled in its default Configurations, in which Steady and Balance prioritizers have the weight of 1 while other prioritizers have the weight of 0. Additive doesn't require configuring all prioritizers. The default Configurations may change in the future, and additional prioritization will happen. In Exact mode, any prioritizer not explicitly enumerated is weighted as zero. Exact requires knowing the full set of prioritizers you want, but avoids behavior changes between releases.
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/ScoreCoordinate.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/ScoreCoordinate.java
index 928b9c3ba5c..389e6ec402a 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/ScoreCoordinate.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/ScoreCoordinate.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ScoreCoordinate represents the configuration of the score type and score source
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ScoreCoordinate(AddOnScore addOn, String builtIn, String type) {
         this.type = type;
     }
 
+    /**
+     * ScoreCoordinate represents the configuration of the score type and score source
+     */
     @JsonProperty("addOn")
     public AddOnScore getAddOn() {
         return addOn;
     }
 
+    /**
+     * ScoreCoordinate represents the configuration of the score type and score source
+     */
     @JsonProperty("addOn")
     public void setAddOn(AddOnScore addOn) {
         this.addOn = addOn;
     }
 
+    /**
+     * BuiltIn defines the name of a BuiltIn prioritizer. Below are the valid BuiltIn prioritizer names. 1) Balance: balance the decisions among the clusters. 2) Steady: ensure the existing decision is stabilized. 3) ResourceAllocatableCPU &amp; ResourceAllocatableMemory: sort clusters based on the allocatable. 4) Spread: spread the workload evenly to topologies.
+     */
     @JsonProperty("builtIn")
     public String getBuiltIn() {
         return builtIn;
     }
 
+    /**
+     * BuiltIn defines the name of a BuiltIn prioritizer. Below are the valid BuiltIn prioritizer names. 1) Balance: balance the decisions among the clusters. 2) Steady: ensure the existing decision is stabilized. 3) ResourceAllocatableCPU &amp; ResourceAllocatableMemory: sort clusters based on the allocatable. 4) Spread: spread the workload evenly to topologies.
+     */
     @JsonProperty("builtIn")
     public void setBuiltIn(String builtIn) {
         this.builtIn = builtIn;
     }
 
+    /**
+     * Type defines the type of the prioritizer score. Type is either "BuiltIn", "AddOn" or "", where "" is "BuiltIn" by default. When the type is "BuiltIn", need to specify a BuiltIn prioritizer name in BuiltIn. When the type is "AddOn", need to configure the score source in AddOn.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type defines the type of the prioritizer score. Type is either "BuiltIn", "AddOn" or "", where "" is "BuiltIn" by default. When the type is "BuiltIn", need to specify a BuiltIn prioritizer name in BuiltIn. When the type is "AddOn", need to configure the score source in AddOn.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/SpreadConstraintsTerm.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/SpreadConstraintsTerm.java
index 63dae0e3eeb..c82bfb6a6e8 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/SpreadConstraintsTerm.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/SpreadConstraintsTerm.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SpreadConstraintsTerm defines a terminology to spread placement decisions.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public SpreadConstraintsTerm(Integer maxSkew, String topologyKey, String topolog
         this.whenUnsatisfiable = whenUnsatisfiable;
     }
 
+    /**
+     * MaxSkew represents the degree to which the workload may be unevenly distributed. Skew is the maximum difference between the number of selected ManagedClusters in a topology and the global minimum. The global minimum is the minimum number of selected ManagedClusters for the topologies within the same TopologyKey. The minimum possible value of MaxSkew is 1, and the default value is 1.
+     */
     @JsonProperty("maxSkew")
     public Integer getMaxSkew() {
         return maxSkew;
     }
 
+    /**
+     * MaxSkew represents the degree to which the workload may be unevenly distributed. Skew is the maximum difference between the number of selected ManagedClusters in a topology and the global minimum. The global minimum is the minimum number of selected ManagedClusters for the topologies within the same TopologyKey. The minimum possible value of MaxSkew is 1, and the default value is 1.
+     */
     @JsonProperty("maxSkew")
     public void setMaxSkew(Integer maxSkew) {
         this.maxSkew = maxSkew;
     }
 
+    /**
+     * TopologyKey is either a label key or a cluster claim name of ManagedClusters.
+     */
     @JsonProperty("topologyKey")
     public String getTopologyKey() {
         return topologyKey;
     }
 
+    /**
+     * TopologyKey is either a label key or a cluster claim name of ManagedClusters.
+     */
     @JsonProperty("topologyKey")
     public void setTopologyKey(String topologyKey) {
         this.topologyKey = topologyKey;
     }
 
+    /**
+     * TopologyKeyType indicates the type of TopologyKey. It could be Label or Claim.
+     */
     @JsonProperty("topologyKeyType")
     public String getTopologyKeyType() {
         return topologyKeyType;
     }
 
+    /**
+     * TopologyKeyType indicates the type of TopologyKey. It could be Label or Claim.
+     */
     @JsonProperty("topologyKeyType")
     public void setTopologyKeyType(String topologyKeyType) {
         this.topologyKeyType = topologyKeyType;
     }
 
+    /**
+     * WhenUnsatisfiable represents the action of the scheduler when MaxSkew cannot be satisfied. It could be DoNotSchedule or ScheduleAnyway. The default value is ScheduleAnyway. DoNotSchedule instructs the scheduler not to schedule more ManagedClusters when MaxSkew is not satisfied. ScheduleAnyway instructs the scheduler to keep scheduling even if MaxSkew is not satisfied.
+     */
     @JsonProperty("whenUnsatisfiable")
     public String getWhenUnsatisfiable() {
         return whenUnsatisfiable;
     }
 
+    /**
+     * WhenUnsatisfiable represents the action of the scheduler when MaxSkew cannot be satisfied. It could be DoNotSchedule or ScheduleAnyway. The default value is ScheduleAnyway. DoNotSchedule instructs the scheduler not to schedule more ManagedClusters when MaxSkew is not satisfied. ScheduleAnyway instructs the scheduler to keep scheduling even if MaxSkew is not satisfied.
+     */
     @JsonProperty("whenUnsatisfiable")
     public void setWhenUnsatisfiable(String whenUnsatisfiable) {
         this.whenUnsatisfiable = whenUnsatisfiable;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/SpreadPolicy.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/SpreadPolicy.java
index fc5d3454dcf..941aa11b55e 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/SpreadPolicy.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/SpreadPolicy.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SpreadPolicy defines how the placement decision should be spread among the ManagedClusters.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public SpreadPolicy(List<SpreadConstraintsTerm> spreadConstraints) {
         this.spreadConstraints = spreadConstraints;
     }
 
+    /**
+     * SpreadConstraints defines how the placement decision should be distributed among a set of ManagedClusters. The importance of the SpreadConstraintsTerms follows the natural order of their index in the slice. The scheduler first consider SpreadConstraintsTerms with smaller index then those with larger index to distribute the placement decision.
+     */
     @JsonProperty("spreadConstraints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SpreadConstraintsTerm> getSpreadConstraints() {
         return spreadConstraints;
     }
 
+    /**
+     * SpreadConstraints defines how the placement decision should be distributed among a set of ManagedClusters. The importance of the SpreadConstraintsTerms follows the natural order of their index in the slice. The scheduler first consider SpreadConstraintsTerms with smaller index then those with larger index to distribute the placement decision.
+     */
     @JsonProperty("spreadConstraints")
     public void setSpreadConstraints(List<SpreadConstraintsTerm> spreadConstraints) {
         this.spreadConstraints = spreadConstraints;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/Toleration.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/Toleration.java
index 77dc0d9bb4c..b89c9709b44 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/Toleration.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta1/Toleration.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Toleration represents the toleration object that can be attached to a placement. The placement this Toleration is attached to tolerates any taint that matches the triple &lt;key,value,effect&gt; using the matching operator &lt;operator&gt;.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public Toleration(String effect, String key, String operator, Long tolerationSec
         this.value = value;
     }
 
+    /**
+     * Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSelect, PreferNoSelect and NoSelectIfNew.
+     */
     @JsonProperty("effect")
     public String getEffect() {
         return effect;
     }
 
+    /**
+     * Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSelect, PreferNoSelect and NoSelectIfNew.
+     */
     @JsonProperty("effect")
     public void setEffect(String effect) {
         this.effect = effect;
     }
 
+    /**
+     * Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a placement can tolerate all taints of a particular category.
+     */
     @JsonProperty("operator")
     public String getOperator() {
         return operator;
     }
 
+    /**
+     * Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a placement can tolerate all taints of a particular category.
+     */
     @JsonProperty("operator")
     public void setOperator(String operator) {
         this.operator = operator;
     }
 
+    /**
+     * TolerationSeconds represents the period of time the toleration (which must be of effect NoSelect/PreferNoSelect, otherwise this field is ignored) tolerates the taint. The default value is nil, which indicates it tolerates the taint forever. The start time of counting the TolerationSeconds should be the TimeAdded in Taint, not the cluster scheduled time or TolerationSeconds added time.
+     */
     @JsonProperty("tolerationSeconds")
     public Long getTolerationSeconds() {
         return tolerationSeconds;
     }
 
+    /**
+     * TolerationSeconds represents the period of time the toleration (which must be of effect NoSelect/PreferNoSelect, otherwise this field is ignored) tolerates the taint. The default value is nil, which indicates it tolerates the taint forever. The start time of counting the TolerationSeconds should be the TimeAdded in Taint, not the cluster scheduled time or TolerationSeconds added time.
+     */
     @JsonProperty("tolerationSeconds")
     public void setTolerationSeconds(Long tolerationSeconds) {
         this.tolerationSeconds = tolerationSeconds;
     }
 
+    /**
+     * Value is the taint value the toleration matches to. If the operator is Exists, the value should be empty, otherwise just a regular string.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is the taint value the toleration matches to. If the operator is Exists, the value should be empty, otherwise just a regular string.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSelector.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSelector.java
index ab7fee9cba7..4ad929cf2d7 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSelector.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSelector.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ManagedClusterSelector represents a selector of ManagedClusters
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ManagedClusterSelector(LabelSelector labelSelector, String selectorType)
         this.selectorType = selectorType;
     }
 
+    /**
+     * ManagedClusterSelector represents a selector of ManagedClusters
+     */
     @JsonProperty("labelSelector")
     public LabelSelector getLabelSelector() {
         return labelSelector;
     }
 
+    /**
+     * ManagedClusterSelector represents a selector of ManagedClusters
+     */
     @JsonProperty("labelSelector")
     public void setLabelSelector(LabelSelector labelSelector) {
         this.labelSelector = labelSelector;
     }
 
+    /**
+     * SelectorType could only be "ExclusiveClusterSetLabel" or "LabelSelector" "ExclusiveClusterSetLabel" means to use label "cluster.open-cluster-management.io/clusterset:&lt;ManagedClusterSet Name&gt;"" to select target clusters. "LabelSelector" means use labelSelector to select target managedClusters
+     */
     @JsonProperty("selectorType")
     public String getSelectorType() {
         return selectorType;
     }
 
+    /**
+     * SelectorType could only be "ExclusiveClusterSetLabel" or "LabelSelector" "ExclusiveClusterSetLabel" means to use label "cluster.open-cluster-management.io/clusterset:&lt;ManagedClusterSet Name&gt;"" to select target clusters. "LabelSelector" means use labelSelector to select target managedClusters
+     */
     @JsonProperty("selectorType")
     public void setSelectorType(String selectorType) {
         this.selectorType = selectorType;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSet.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSet.java
index 17f3200e9b0..02d2422bd6e 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSet.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSet.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ManagedClusterSet defines a group of ManagedClusters that you can run workloads on. You can define a workload to be deployed on a ManagedClusterSet. See the following options  for the workload: - The workload can run on any ManagedCluster in the ManagedClusterSet - The workload cannot run on any ManagedCluster outside the ManagedClusterSet - The service exposed by the workload can be shared in any ManagedCluster in the ManagedClusterSet<br><p> <br><p> To assign a ManagedCluster to a certain ManagedClusterSet, add a label with the name cluster.open-cluster-management.io/clusterset on the ManagedCluster to refer to the ManagedClusterSet. You are not allowed to add or remove this label on a ManagedCluster unless you have an RBAC rule to CREATE on a virtual subresource of managedclustersets/join. To update this label, you must have the permission on both the old and new ManagedClusterSet.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ManagedClusterSet implements Editable<ManagedClusterSetBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cluster.open-cluster-management.io/v1beta2";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ManagedClusterSet";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public ManagedClusterSet(String apiVersion, String kind, ObjectMeta metadata, Ma
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ManagedClusterSet defines a group of ManagedClusters that you can run workloads on. You can define a workload to be deployed on a ManagedClusterSet. See the following options  for the workload: - The workload can run on any ManagedCluster in the ManagedClusterSet - The workload cannot run on any ManagedCluster outside the ManagedClusterSet - The service exposed by the workload can be shared in any ManagedCluster in the ManagedClusterSet<br><p> <br><p> To assign a ManagedCluster to a certain ManagedClusterSet, add a label with the name cluster.open-cluster-management.io/clusterset on the ManagedCluster to refer to the ManagedClusterSet. You are not allowed to add or remove this label on a ManagedCluster unless you have an RBAC rule to CREATE on a virtual subresource of managedclustersets/join. To update this label, you must have the permission on both the old and new ManagedClusterSet.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ManagedClusterSet defines a group of ManagedClusters that you can run workloads on. You can define a workload to be deployed on a ManagedClusterSet. See the following options  for the workload: - The workload can run on any ManagedCluster in the ManagedClusterSet - The workload cannot run on any ManagedCluster outside the ManagedClusterSet - The service exposed by the workload can be shared in any ManagedCluster in the ManagedClusterSet<br><p> <br><p> To assign a ManagedCluster to a certain ManagedClusterSet, add a label with the name cluster.open-cluster-management.io/clusterset on the ManagedCluster to refer to the ManagedClusterSet. You are not allowed to add or remove this label on a ManagedCluster unless you have an RBAC rule to CREATE on a virtual subresource of managedclustersets/join. To update this label, you must have the permission on both the old and new ManagedClusterSet.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ManagedClusterSet defines a group of ManagedClusters that you can run workloads on. You can define a workload to be deployed on a ManagedClusterSet. See the following options  for the workload: - The workload can run on any ManagedCluster in the ManagedClusterSet - The workload cannot run on any ManagedCluster outside the ManagedClusterSet - The service exposed by the workload can be shared in any ManagedCluster in the ManagedClusterSet<br><p> <br><p> To assign a ManagedCluster to a certain ManagedClusterSet, add a label with the name cluster.open-cluster-management.io/clusterset on the ManagedCluster to refer to the ManagedClusterSet. You are not allowed to add or remove this label on a ManagedCluster unless you have an RBAC rule to CREATE on a virtual subresource of managedclustersets/join. To update this label, you must have the permission on both the old and new ManagedClusterSet.
+     */
     @JsonProperty("spec")
     public ManagedClusterSetSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ManagedClusterSet defines a group of ManagedClusters that you can run workloads on. You can define a workload to be deployed on a ManagedClusterSet. See the following options  for the workload: - The workload can run on any ManagedCluster in the ManagedClusterSet - The workload cannot run on any ManagedCluster outside the ManagedClusterSet - The service exposed by the workload can be shared in any ManagedCluster in the ManagedClusterSet<br><p> <br><p> To assign a ManagedCluster to a certain ManagedClusterSet, add a label with the name cluster.open-cluster-management.io/clusterset on the ManagedCluster to refer to the ManagedClusterSet. You are not allowed to add or remove this label on a ManagedCluster unless you have an RBAC rule to CREATE on a virtual subresource of managedclustersets/join. To update this label, you must have the permission on both the old and new ManagedClusterSet.
+     */
     @JsonProperty("spec")
     public void setSpec(ManagedClusterSetSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ManagedClusterSet defines a group of ManagedClusters that you can run workloads on. You can define a workload to be deployed on a ManagedClusterSet. See the following options  for the workload: - The workload can run on any ManagedCluster in the ManagedClusterSet - The workload cannot run on any ManagedCluster outside the ManagedClusterSet - The service exposed by the workload can be shared in any ManagedCluster in the ManagedClusterSet<br><p> <br><p> To assign a ManagedCluster to a certain ManagedClusterSet, add a label with the name cluster.open-cluster-management.io/clusterset on the ManagedCluster to refer to the ManagedClusterSet. You are not allowed to add or remove this label on a ManagedCluster unless you have an RBAC rule to CREATE on a virtual subresource of managedclustersets/join. To update this label, you must have the permission on both the old and new ManagedClusterSet.
+     */
     @JsonProperty("status")
     public ManagedClusterSetStatus getStatus() {
         return status;
     }
 
+    /**
+     * ManagedClusterSet defines a group of ManagedClusters that you can run workloads on. You can define a workload to be deployed on a ManagedClusterSet. See the following options  for the workload: - The workload can run on any ManagedCluster in the ManagedClusterSet - The workload cannot run on any ManagedCluster outside the ManagedClusterSet - The service exposed by the workload can be shared in any ManagedCluster in the ManagedClusterSet<br><p> <br><p> To assign a ManagedCluster to a certain ManagedClusterSet, add a label with the name cluster.open-cluster-management.io/clusterset on the ManagedCluster to refer to the ManagedClusterSet. You are not allowed to add or remove this label on a ManagedCluster unless you have an RBAC rule to CREATE on a virtual subresource of managedclustersets/join. To update this label, you must have the permission on both the old and new ManagedClusterSet.
+     */
     @JsonProperty("status")
     public void setStatus(ManagedClusterSetStatus status) {
         this.status = status;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSetBinding.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSetBinding.java
index af7d4f67bb3..8f1de0c7f38 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSetBinding.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSetBinding.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ManagedClusterSetBinding projects a ManagedClusterSet into a certain namespace. You can create a ManagedClusterSetBinding in a namespace and bind it to a ManagedClusterSet if both have a RBAC rules to CREATE on the virtual subresource of managedclustersets/bind. Workloads that you create in the same namespace can only be distributed to ManagedClusters in ManagedClusterSets that are bound in this namespace by higher-level controllers.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class ManagedClusterSetBinding implements Editable<ManagedClusterSetBindingBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cluster.open-cluster-management.io/v1beta2";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ManagedClusterSetBinding";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ManagedClusterSetBinding(String apiVersion, String kind, ObjectMeta metad
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ManagedClusterSetBinding projects a ManagedClusterSet into a certain namespace. You can create a ManagedClusterSetBinding in a namespace and bind it to a ManagedClusterSet if both have a RBAC rules to CREATE on the virtual subresource of managedclustersets/bind. Workloads that you create in the same namespace can only be distributed to ManagedClusters in ManagedClusterSets that are bound in this namespace by higher-level controllers.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ManagedClusterSetBinding projects a ManagedClusterSet into a certain namespace. You can create a ManagedClusterSetBinding in a namespace and bind it to a ManagedClusterSet if both have a RBAC rules to CREATE on the virtual subresource of managedclustersets/bind. Workloads that you create in the same namespace can only be distributed to ManagedClusters in ManagedClusterSets that are bound in this namespace by higher-level controllers.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ManagedClusterSetBinding projects a ManagedClusterSet into a certain namespace. You can create a ManagedClusterSetBinding in a namespace and bind it to a ManagedClusterSet if both have a RBAC rules to CREATE on the virtual subresource of managedclustersets/bind. Workloads that you create in the same namespace can only be distributed to ManagedClusters in ManagedClusterSets that are bound in this namespace by higher-level controllers.
+     */
     @JsonProperty("spec")
     public ManagedClusterSetBindingSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ManagedClusterSetBinding projects a ManagedClusterSet into a certain namespace. You can create a ManagedClusterSetBinding in a namespace and bind it to a ManagedClusterSet if both have a RBAC rules to CREATE on the virtual subresource of managedclustersets/bind. Workloads that you create in the same namespace can only be distributed to ManagedClusters in ManagedClusterSets that are bound in this namespace by higher-level controllers.
+     */
     @JsonProperty("spec")
     public void setSpec(ManagedClusterSetBindingSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ManagedClusterSetBinding projects a ManagedClusterSet into a certain namespace. You can create a ManagedClusterSetBinding in a namespace and bind it to a ManagedClusterSet if both have a RBAC rules to CREATE on the virtual subresource of managedclustersets/bind. Workloads that you create in the same namespace can only be distributed to ManagedClusters in ManagedClusterSets that are bound in this namespace by higher-level controllers.
+     */
     @JsonProperty("status")
     public ManagedClusterSetBindingStatus getStatus() {
         return status;
     }
 
+    /**
+     * ManagedClusterSetBinding projects a ManagedClusterSet into a certain namespace. You can create a ManagedClusterSetBinding in a namespace and bind it to a ManagedClusterSet if both have a RBAC rules to CREATE on the virtual subresource of managedclustersets/bind. Workloads that you create in the same namespace can only be distributed to ManagedClusters in ManagedClusterSets that are bound in this namespace by higher-level controllers.
+     */
     @JsonProperty("status")
     public void setStatus(ManagedClusterSetBindingStatus status) {
         this.status = status;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSetBindingList.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSetBindingList.java
index a286e62c003..67b972fbbba 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSetBindingList.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSetBindingList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ManagedClusterSetBindingList is a collection of ManagedClusterSetBinding.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ManagedClusterSetBindingList implements Editable<ManagedClusterSetBindingListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openclustermanagement.api.model.cluster.v1beta2.ManagedClusterSetBinding>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cluster.open-cluster-management.io/v1beta2";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openclustermanagement.api.model.cluster.v1beta2.ManagedClusterSetBinding> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ManagedClusterSetBindingList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ManagedClusterSetBindingList(String apiVersion, List<io.fabric8.openclust
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of ManagedClusterSetBinding.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openclustermanagement.api.model.cluster.v1beta2.ManagedClusterSetBinding> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of ManagedClusterSetBinding.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openclustermanagement.api.model.cluster.v1beta2.ManagedClusterSetBinding> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ManagedClusterSetBindingList is a collection of ManagedClusterSetBinding.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ManagedClusterSetBindingList is a collection of ManagedClusterSetBinding.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSetBindingSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSetBindingSpec.java
index 94886749142..b6891c2993f 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSetBindingSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSetBindingSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ManagedClusterSetBindingSpec defines the attributes of ManagedClusterSetBinding.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ManagedClusterSetBindingSpec(String clusterSet) {
         this.clusterSet = clusterSet;
     }
 
+    /**
+     * ClusterSet is the name of the ManagedClusterSet to bind. It must match the instance name of the ManagedClusterSetBinding and cannot change once created. User is allowed to set this field if they have an RBAC rule to CREATE on the virtual subresource of managedclustersets/bind.
+     */
     @JsonProperty("clusterSet")
     public String getClusterSet() {
         return clusterSet;
     }
 
+    /**
+     * ClusterSet is the name of the ManagedClusterSet to bind. It must match the instance name of the ManagedClusterSetBinding and cannot change once created. User is allowed to set this field if they have an RBAC rule to CREATE on the virtual subresource of managedclustersets/bind.
+     */
     @JsonProperty("clusterSet")
     public void setClusterSet(String clusterSet) {
         this.clusterSet = clusterSet;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSetBindingStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSetBindingStatus.java
index 8ca46277d5c..e9ac5bfda55 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSetBindingStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSetBindingStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ManagedClusterSetBindingStatus represents the current status of the ManagedClusterSetBinding.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,12 +85,18 @@ public ManagedClusterSetBindingStatus(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Conditions contains the different condition statuses for this ManagedClusterSetBinding.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions contains the different condition statuses for this ManagedClusterSetBinding.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSetList.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSetList.java
index 803f234fc70..184dac890cd 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSetList.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSetList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ManagedClusterSetList is a collection of ManagedClusterSet.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ManagedClusterSetList implements Editable<ManagedClusterSetListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openclustermanagement.api.model.cluster.v1beta2.ManagedClusterSet>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cluster.open-cluster-management.io/v1beta2";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openclustermanagement.api.model.cluster.v1beta2.ManagedClusterSet> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ManagedClusterSetList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ManagedClusterSetList(String apiVersion, List<io.fabric8.openclustermanag
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of ManagedClusterSet.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openclustermanagement.api.model.cluster.v1beta2.ManagedClusterSet> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of ManagedClusterSet.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openclustermanagement.api.model.cluster.v1beta2.ManagedClusterSet> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ManagedClusterSetList is a collection of ManagedClusterSet.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ManagedClusterSetList is a collection of ManagedClusterSet.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSetSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSetSpec.java
index 3889e14f4bf..7e3c1aefee4 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSetSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSetSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ManagedClusterSetSpec describes the attributes of the ManagedClusterSet
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ManagedClusterSetSpec(ManagedClusterSelector clusterSelector) {
         this.clusterSelector = clusterSelector;
     }
 
+    /**
+     * ManagedClusterSetSpec describes the attributes of the ManagedClusterSet
+     */
     @JsonProperty("clusterSelector")
     public ManagedClusterSelector getClusterSelector() {
         return clusterSelector;
     }
 
+    /**
+     * ManagedClusterSetSpec describes the attributes of the ManagedClusterSet
+     */
     @JsonProperty("clusterSelector")
     public void setClusterSelector(ManagedClusterSelector clusterSelector) {
         this.clusterSelector = clusterSelector;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSetStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSetStatus.java
index 79a3c1518fc..6cb29a51016 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSetStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/cluster/v1beta2/ManagedClusterSetStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ManagedClusterSetStatus represents the current status of the ManagedClusterSet.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,12 +85,18 @@ public ManagedClusterSetStatus(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Conditions contains the different condition statuses for this ManagedClusterSet.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions contains the different condition statuses for this ManagedClusterSet.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveredCluster.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveredCluster.java
index 4c969fd8ab1..4d73b7dfee4 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveredCluster.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveredCluster.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DiscoveredCluster is the Schema for the discoveredclusters API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class DiscoveredCluster implements Editable<DiscoveredClusterBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "discovery.open-cluster-management.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DiscoveredCluster";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DiscoveredCluster(String apiVersion, String kind, ObjectMeta metadata, Di
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DiscoveredCluster is the Schema for the discoveredclusters API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DiscoveredCluster is the Schema for the discoveredclusters API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * DiscoveredCluster is the Schema for the discoveredclusters API
+     */
     @JsonProperty("spec")
     public DiscoveredClusterSpec getSpec() {
         return spec;
     }
 
+    /**
+     * DiscoveredCluster is the Schema for the discoveredclusters API
+     */
     @JsonProperty("spec")
     public void setSpec(DiscoveredClusterSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * DiscoveredCluster is the Schema for the discoveredclusters API
+     */
     @JsonProperty("status")
     public DiscoveredClusterStatus getStatus() {
         return status;
     }
 
+    /**
+     * DiscoveredCluster is the Schema for the discoveredclusters API
+     */
     @JsonProperty("status")
     public void setStatus(DiscoveredClusterStatus status) {
         this.status = status;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveredClusterCondition.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveredClusterCondition.java
index c097eb79f00..feb1d91ac39 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveredClusterCondition.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveredClusterCondition.java
@@ -110,21 +110,33 @@ public void setLastUpdateTime(String lastUpdateTime) {
         this.lastUpdateTime = lastUpdateTime;
     }
 
+    /**
+     * Status is the status of the condition. One of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status is the status of the condition. One of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type is the type of the discovered cluster condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of the discovered cluster condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveredClusterList.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveredClusterList.java
index 8789ae1f04a..87956fe7054 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveredClusterList.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveredClusterList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DiscoveredClusterList contains a list of DiscoveredCluster
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class DiscoveredClusterList implements Editable<DiscoveredClusterListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openclustermanagement.api.model.discovery.v1.DiscoveredCluster>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "discovery.open-cluster-management.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openclustermanagement.api.model.discovery.v1.DiscoveredCluster> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DiscoveredClusterList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DiscoveredClusterList(String apiVersion, List<io.fabric8.openclustermanag
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * DiscoveredClusterList contains a list of DiscoveredCluster
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openclustermanagement.api.model.discovery.v1.DiscoveredCluster> getItems() {
         return items;
     }
 
+    /**
+     * DiscoveredClusterList contains a list of DiscoveredCluster
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openclustermanagement.api.model.discovery.v1.DiscoveredCluster> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DiscoveredClusterList contains a list of DiscoveredCluster
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DiscoveredClusterList contains a list of DiscoveredCluster
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveredClusterSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveredClusterSpec.java
index 88d0c1c9095..8a8250cbd9c 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveredClusterSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveredClusterSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -142,171 +145,273 @@ public DiscoveredClusterSpec(String activityTimestamp, String apiUrl, String clo
         this.type = type;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("activityTimestamp")
     public String getActivityTimestamp() {
         return activityTimestamp;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("activityTimestamp")
     public void setActivityTimestamp(String activityTimestamp) {
         this.activityTimestamp = activityTimestamp;
     }
 
+    /**
+     * APIURL ...
+     */
     @JsonProperty("apiUrl")
     public String getApiUrl() {
         return apiUrl;
     }
 
+    /**
+     * APIURL ...
+     */
     @JsonProperty("apiUrl")
     public void setApiUrl(String apiUrl) {
         this.apiUrl = apiUrl;
     }
 
+    /**
+     * CloudProvider ...
+     */
     @JsonProperty("cloudProvider")
     public String getCloudProvider() {
         return cloudProvider;
     }
 
+    /**
+     * CloudProvider ...
+     */
     @JsonProperty("cloudProvider")
     public void setCloudProvider(String cloudProvider) {
         this.cloudProvider = cloudProvider;
     }
 
+    /**
+     * Console ...
+     */
     @JsonProperty("console")
     public String getConsole() {
         return console;
     }
 
+    /**
+     * Console ...
+     */
     @JsonProperty("console")
     public void setConsole(String console) {
         this.console = console;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("creationTimestamp")
     public String getCreationTimestamp() {
         return creationTimestamp;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("creationTimestamp")
     public void setCreationTimestamp(String creationTimestamp) {
         this.creationTimestamp = creationTimestamp;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("credential")
     public ObjectReference getCredential() {
         return credential;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("credential")
     public void setCredential(ObjectReference credential) {
         this.credential = credential;
     }
 
+    /**
+     * DisplayName ...
+     */
     @JsonProperty("displayName")
     public String getDisplayName() {
         return displayName;
     }
 
+    /**
+     * DisplayName ...
+     */
     @JsonProperty("displayName")
     public void setDisplayName(String displayName) {
         this.displayName = displayName;
     }
 
+    /**
+     * ImportAsManagedCluster ...
+     */
     @JsonProperty("importAsManagedCluster")
     public Boolean getImportAsManagedCluster() {
         return importAsManagedCluster;
     }
 
+    /**
+     * ImportAsManagedCluster ...
+     */
     @JsonProperty("importAsManagedCluster")
     public void setImportAsManagedCluster(Boolean importAsManagedCluster) {
         this.importAsManagedCluster = importAsManagedCluster;
     }
 
+    /**
+     * IsManagedCluster ...
+     */
     @JsonProperty("isManagedCluster")
     public Boolean getIsManagedCluster() {
         return isManagedCluster;
     }
 
+    /**
+     * IsManagedCluster ...
+     */
     @JsonProperty("isManagedCluster")
     public void setIsManagedCluster(Boolean isManagedCluster) {
         this.isManagedCluster = isManagedCluster;
     }
 
+    /**
+     * Name ...
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name ...
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * OCPClusterID ...
+     */
     @JsonProperty("ocpClusterId")
     public String getOcpClusterId() {
         return ocpClusterId;
     }
 
+    /**
+     * OCPClusterID ...
+     */
     @JsonProperty("ocpClusterId")
     public void setOcpClusterId(String ocpClusterId) {
         this.ocpClusterId = ocpClusterId;
     }
 
+    /**
+     * OpenshiftVersion ...
+     */
     @JsonProperty("openshiftVersion")
     public String getOpenshiftVersion() {
         return openshiftVersion;
     }
 
+    /**
+     * OpenshiftVersion ...
+     */
     @JsonProperty("openshiftVersion")
     public void setOpenshiftVersion(String openshiftVersion) {
         this.openshiftVersion = openshiftVersion;
     }
 
+    /**
+     * Owner ...
+     */
     @JsonProperty("owner")
     public String getOwner() {
         return owner;
     }
 
+    /**
+     * Owner ...
+     */
     @JsonProperty("owner")
     public void setOwner(String owner) {
         this.owner = owner;
     }
 
+    /**
+     * Region ...
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Region ...
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * RHOCMClusterID ...
+     */
     @JsonProperty("rhocmClusterId")
     public String getRhocmClusterId() {
         return rhocmClusterId;
     }
 
+    /**
+     * RHOCMClusterID ...
+     */
     @JsonProperty("rhocmClusterId")
     public void setRhocmClusterId(String rhocmClusterId) {
         this.rhocmClusterId = rhocmClusterId;
     }
 
+    /**
+     * Status ...
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status ...
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type ...
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type ...
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveredClusterStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveredClusterStatus.java
index 9a4fb01b5cc..8171f1b5ec4 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveredClusterStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveredClusterStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DiscoveredClusterStatus defines the observed state of DiscoveredCluster
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public DiscoveredClusterStatus(List<DiscoveredClusterCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * INSERT ADDITIONAL STATUS FIELD - define observed state of cluster Important: Run "make" to regenerate code after modifying this file
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DiscoveredClusterCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * INSERT ADDITIONAL STATUS FIELD - define observed state of cluster Important: Run "make" to regenerate code after modifying this file
+     */
     @JsonProperty("conditions")
     public void setConditions(List<DiscoveredClusterCondition> conditions) {
         this.conditions = conditions;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveryConfig.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveryConfig.java
index 1c21962efa9..045965bac47 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveryConfig.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveryConfig.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DiscoveryConfig is the Schema for the discoveryconfigs API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class DiscoveryConfig implements Editable<DiscoveryConfigBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "discovery.open-cluster-management.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DiscoveryConfig";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DiscoveryConfig(String apiVersion, String kind, ObjectMeta metadata, Disc
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DiscoveryConfig is the Schema for the discoveryconfigs API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DiscoveryConfig is the Schema for the discoveryconfigs API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * DiscoveryConfig is the Schema for the discoveryconfigs API
+     */
     @JsonProperty("spec")
     public DiscoveryConfigSpec getSpec() {
         return spec;
     }
 
+    /**
+     * DiscoveryConfig is the Schema for the discoveryconfigs API
+     */
     @JsonProperty("spec")
     public void setSpec(DiscoveryConfigSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * DiscoveryConfig is the Schema for the discoveryconfigs API
+     */
     @JsonProperty("status")
     public DiscoveryConfigStatus getStatus() {
         return status;
     }
 
+    /**
+     * DiscoveryConfig is the Schema for the discoveryconfigs API
+     */
     @JsonProperty("status")
     public void setStatus(DiscoveryConfigStatus status) {
         this.status = status;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveryConfigList.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveryConfigList.java
index af64d290ca4..5fa63eb0a03 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveryConfigList.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveryConfigList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DiscoveryConfigList contains a list of DiscoveryConfig
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class DiscoveryConfigList implements Editable<DiscoveryConfigListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openclustermanagement.api.model.discovery.v1.DiscoveryConfig>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "discovery.open-cluster-management.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openclustermanagement.api.model.discovery.v1.DiscoveryConfig> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DiscoveryConfigList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DiscoveryConfigList(String apiVersion, List<io.fabric8.openclustermanagem
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * DiscoveryConfigList contains a list of DiscoveryConfig
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openclustermanagement.api.model.discovery.v1.DiscoveryConfig> getItems() {
         return items;
     }
 
+    /**
+     * DiscoveryConfigList contains a list of DiscoveryConfig
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openclustermanagement.api.model.discovery.v1.DiscoveryConfig> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DiscoveryConfigList contains a list of DiscoveryConfig
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DiscoveryConfigList contains a list of DiscoveryConfig
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveryConfigSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveryConfigSpec.java
index 299cd012b48..30ee0bbca56 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveryConfigSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveryConfigSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DiscoveryConfigSpec defines the desired state of DiscoveryConfig
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public DiscoveryConfigSpec(String credential, Filter filters) {
         this.filters = filters;
     }
 
+    /**
+     * Credential is the secret containing credentials to connect to the OCM api on behalf of a user
+     */
     @JsonProperty("credential")
     public String getCredential() {
         return credential;
     }
 
+    /**
+     * Credential is the secret containing credentials to connect to the OCM api on behalf of a user
+     */
     @JsonProperty("credential")
     public void setCredential(String credential) {
         this.credential = credential;
     }
 
+    /**
+     * DiscoveryConfigSpec defines the desired state of DiscoveryConfig
+     */
     @JsonProperty("filters")
     public Filter getFilters() {
         return filters;
     }
 
+    /**
+     * DiscoveryConfigSpec defines the desired state of DiscoveryConfig
+     */
     @JsonProperty("filters")
     public void setFilters(Filter filters) {
         this.filters = filters;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveryConfigStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveryConfigStatus.java
index ac924b9515b..bd976b1d59f 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveryConfigStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/DiscoveryConfigStatus.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DiscoveryConfigStatus defines the observed state of DiscoveryConfig
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/Filter.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/Filter.java
index 57be90b13dd..27e186ae965 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/Filter.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1/Filter.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Filter ...
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public Filter(Integer lastActive, List<String> openShiftVersions) {
         this.openShiftVersions = openShiftVersions;
     }
 
+    /**
+     * LastActive is the last active in days of clusters to discover, determined by activity timestamp
+     */
     @JsonProperty("lastActive")
     public Integer getLastActive() {
         return lastActive;
     }
 
+    /**
+     * LastActive is the last active in days of clusters to discover, determined by activity timestamp
+     */
     @JsonProperty("lastActive")
     public void setLastActive(Integer lastActive) {
         this.lastActive = lastActive;
     }
 
+    /**
+     * OpenShiftVersions is the list of release versions of OpenShift of the form "&lt;Major&gt;.&lt;Minor&gt;"
+     */
     @JsonProperty("openShiftVersions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getOpenShiftVersions() {
         return openShiftVersions;
     }
 
+    /**
+     * OpenShiftVersions is the list of release versions of OpenShift of the form "&lt;Major&gt;.&lt;Minor&gt;"
+     */
     @JsonProperty("openShiftVersions")
     public void setOpenShiftVersions(List<String> openShiftVersions) {
         this.openShiftVersions = openShiftVersions;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveredCluster.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveredCluster.java
index 7635d09485e..3a2609e4cea 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveredCluster.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveredCluster.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DiscoveredCluster is the Schema for the discoveredclusters API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class DiscoveredCluster implements Editable<DiscoveredClusterBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "discovery.open-cluster-management.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DiscoveredCluster";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DiscoveredCluster(String apiVersion, String kind, ObjectMeta metadata, Di
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DiscoveredCluster is the Schema for the discoveredclusters API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DiscoveredCluster is the Schema for the discoveredclusters API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * DiscoveredCluster is the Schema for the discoveredclusters API
+     */
     @JsonProperty("spec")
     public DiscoveredClusterSpec getSpec() {
         return spec;
     }
 
+    /**
+     * DiscoveredCluster is the Schema for the discoveredclusters API
+     */
     @JsonProperty("spec")
     public void setSpec(DiscoveredClusterSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * DiscoveredCluster is the Schema for the discoveredclusters API
+     */
     @JsonProperty("status")
     public DiscoveredClusterStatus getStatus() {
         return status;
     }
 
+    /**
+     * DiscoveredCluster is the Schema for the discoveredclusters API
+     */
     @JsonProperty("status")
     public void setStatus(DiscoveredClusterStatus status) {
         this.status = status;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveredClusterList.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveredClusterList.java
index cb08af3e337..91cf862ff34 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveredClusterList.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveredClusterList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DiscoveredClusterList contains a list of DiscoveredCluster
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class DiscoveredClusterList implements Editable<DiscoveredClusterListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openclustermanagement.api.model.discovery.v1alpha1.DiscoveredCluster>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "discovery.open-cluster-management.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openclustermanagement.api.model.discovery.v1alpha1.DiscoveredCluster> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DiscoveredClusterList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DiscoveredClusterList(String apiVersion, List<io.fabric8.openclustermanag
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * DiscoveredClusterList contains a list of DiscoveredCluster
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openclustermanagement.api.model.discovery.v1alpha1.DiscoveredCluster> getItems() {
         return items;
     }
 
+    /**
+     * DiscoveredClusterList contains a list of DiscoveredCluster
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openclustermanagement.api.model.discovery.v1alpha1.DiscoveredCluster> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DiscoveredClusterList contains a list of DiscoveredCluster
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DiscoveredClusterList contains a list of DiscoveredCluster
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveredClusterSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveredClusterSpec.java
index 7ac13624b18..56474481d9a 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveredClusterSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveredClusterSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -122,121 +125,193 @@ public DiscoveredClusterSpec(String activityTimestamp, String apiUrl, String clo
         this.type = type;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("activityTimestamp")
     public String getActivityTimestamp() {
         return activityTimestamp;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("activityTimestamp")
     public void setActivityTimestamp(String activityTimestamp) {
         this.activityTimestamp = activityTimestamp;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("apiUrl")
     public String getApiUrl() {
         return apiUrl;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("apiUrl")
     public void setApiUrl(String apiUrl) {
         this.apiUrl = apiUrl;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("cloudProvider")
     public String getCloudProvider() {
         return cloudProvider;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("cloudProvider")
     public void setCloudProvider(String cloudProvider) {
         this.cloudProvider = cloudProvider;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("console")
     public String getConsole() {
         return console;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("console")
     public void setConsole(String console) {
         this.console = console;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("creationTimestamp")
     public String getCreationTimestamp() {
         return creationTimestamp;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("creationTimestamp")
     public void setCreationTimestamp(String creationTimestamp) {
         this.creationTimestamp = creationTimestamp;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("credential")
     public ObjectReference getCredential() {
         return credential;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("credential")
     public void setCredential(ObjectReference credential) {
         this.credential = credential;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("displayName")
     public String getDisplayName() {
         return displayName;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("displayName")
     public void setDisplayName(String displayName) {
         this.displayName = displayName;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("isManagedCluster")
     public Boolean getIsManagedCluster() {
         return isManagedCluster;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("isManagedCluster")
     public void setIsManagedCluster(Boolean isManagedCluster) {
         this.isManagedCluster = isManagedCluster;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("openshiftVersion")
     public String getOpenshiftVersion() {
         return openshiftVersion;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("openshiftVersion")
     public void setOpenshiftVersion(String openshiftVersion) {
         this.openshiftVersion = openshiftVersion;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * DiscoveredClusterSpec defines the desired state of DiscoveredCluster
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveredClusterStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveredClusterStatus.java
index 97f84942bf9..5c1512029fb 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveredClusterStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveredClusterStatus.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DiscoveredClusterStatus defines the observed state of DiscoveredCluster
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveryConfig.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveryConfig.java
index e444dc63077..6b82376979a 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveryConfig.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveryConfig.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DiscoveryConfig is the Schema for the discoveryconfigs API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class DiscoveryConfig implements Editable<DiscoveryConfigBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "discovery.open-cluster-management.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DiscoveryConfig";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DiscoveryConfig(String apiVersion, String kind, ObjectMeta metadata, Disc
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DiscoveryConfig is the Schema for the discoveryconfigs API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DiscoveryConfig is the Schema for the discoveryconfigs API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * DiscoveryConfig is the Schema for the discoveryconfigs API
+     */
     @JsonProperty("spec")
     public DiscoveryConfigSpec getSpec() {
         return spec;
     }
 
+    /**
+     * DiscoveryConfig is the Schema for the discoveryconfigs API
+     */
     @JsonProperty("spec")
     public void setSpec(DiscoveryConfigSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * DiscoveryConfig is the Schema for the discoveryconfigs API
+     */
     @JsonProperty("status")
     public DiscoveryConfigStatus getStatus() {
         return status;
     }
 
+    /**
+     * DiscoveryConfig is the Schema for the discoveryconfigs API
+     */
     @JsonProperty("status")
     public void setStatus(DiscoveryConfigStatus status) {
         this.status = status;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveryConfigList.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveryConfigList.java
index 89f5ddd9abc..5b5a5721b40 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveryConfigList.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveryConfigList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DiscoveryConfigList contains a list of DiscoveryConfig
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class DiscoveryConfigList implements Editable<DiscoveryConfigListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openclustermanagement.api.model.discovery.v1alpha1.DiscoveryConfig>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "discovery.open-cluster-management.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openclustermanagement.api.model.discovery.v1alpha1.DiscoveryConfig> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DiscoveryConfigList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DiscoveryConfigList(String apiVersion, List<io.fabric8.openclustermanagem
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * DiscoveryConfigList contains a list of DiscoveryConfig
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openclustermanagement.api.model.discovery.v1alpha1.DiscoveryConfig> getItems() {
         return items;
     }
 
+    /**
+     * DiscoveryConfigList contains a list of DiscoveryConfig
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openclustermanagement.api.model.discovery.v1alpha1.DiscoveryConfig> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DiscoveryConfigList contains a list of DiscoveryConfig
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DiscoveryConfigList contains a list of DiscoveryConfig
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveryConfigSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveryConfigSpec.java
index d7ebadb47a0..014b9729ce4 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveryConfigSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveryConfigSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DiscoveryConfigSpec defines the desired state of DiscoveryConfig
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public DiscoveryConfigSpec(String credential, Filter filters) {
         this.filters = filters;
     }
 
+    /**
+     * Credential is the secret containing credentials to connect to the OCM api on behalf of a user
+     */
     @JsonProperty("credential")
     public String getCredential() {
         return credential;
     }
 
+    /**
+     * Credential is the secret containing credentials to connect to the OCM api on behalf of a user
+     */
     @JsonProperty("credential")
     public void setCredential(String credential) {
         this.credential = credential;
     }
 
+    /**
+     * DiscoveryConfigSpec defines the desired state of DiscoveryConfig
+     */
     @JsonProperty("filters")
     public Filter getFilters() {
         return filters;
     }
 
+    /**
+     * DiscoveryConfigSpec defines the desired state of DiscoveryConfig
+     */
     @JsonProperty("filters")
     public void setFilters(Filter filters) {
         this.filters = filters;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveryConfigStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveryConfigStatus.java
index 3eea7c80b62..881145bb7c7 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveryConfigStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/DiscoveryConfigStatus.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DiscoveryConfigStatus defines the observed state of DiscoveryConfig
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/Filter.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/Filter.java
index a37e3bb5076..4eb138553cd 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/Filter.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/discovery/v1alpha1/Filter.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Filter ...
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public Filter(Integer lastActive, List<String> openShiftVersions) {
         this.openShiftVersions = openShiftVersions;
     }
 
+    /**
+     * LastActive is the last active in days of clusters to discover, determined by activity timestamp
+     */
     @JsonProperty("lastActive")
     public Integer getLastActive() {
         return lastActive;
     }
 
+    /**
+     * LastActive is the last active in days of clusters to discover, determined by activity timestamp
+     */
     @JsonProperty("lastActive")
     public void setLastActive(Integer lastActive) {
         this.lastActive = lastActive;
     }
 
+    /**
+     * OpenShiftVersions is the list of release versions of OpenShift of the form "&lt;Major&gt;.&lt;Minor&gt;"
+     */
     @JsonProperty("openShiftVersions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getOpenShiftVersions() {
         return openShiftVersions;
     }
 
+    /**
+     * OpenShiftVersions is the list of release versions of OpenShift of the form "&lt;Major&gt;.&lt;Minor&gt;"
+     */
     @JsonProperty("openShiftVersions")
     public void setOpenShiftVersions(List<String> openShiftVersions) {
         this.openShiftVersions = openShiftVersions;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/MultiClusterObservability.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/MultiClusterObservability.java
index a86958fb373..5f7ebade171 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/MultiClusterObservability.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/MultiClusterObservability.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MultiClusterObservability defines the configuration for the Observability installation on Hub and Managed Clusters all through this one custom resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class MultiClusterObservability implements Editable<MultiClusterObservabilityBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "observability.open-cluster-management.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MultiClusterObservability";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public MultiClusterObservability(String apiVersion, String kind, ObjectMeta meta
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MultiClusterObservability defines the configuration for the Observability installation on Hub and Managed Clusters all through this one custom resource.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MultiClusterObservability defines the configuration for the Observability installation on Hub and Managed Clusters all through this one custom resource.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * MultiClusterObservability defines the configuration for the Observability installation on Hub and Managed Clusters all through this one custom resource.
+     */
     @JsonProperty("spec")
     public MultiClusterObservabilitySpec getSpec() {
         return spec;
     }
 
+    /**
+     * MultiClusterObservability defines the configuration for the Observability installation on Hub and Managed Clusters all through this one custom resource.
+     */
     @JsonProperty("spec")
     public void setSpec(MultiClusterObservabilitySpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * MultiClusterObservability defines the configuration for the Observability installation on Hub and Managed Clusters all through this one custom resource.
+     */
     @JsonProperty("status")
     public MultiClusterObservabilityStatus getStatus() {
         return status;
     }
 
+    /**
+     * MultiClusterObservability defines the configuration for the Observability installation on Hub and Managed Clusters all through this one custom resource.
+     */
     @JsonProperty("status")
     public void setStatus(MultiClusterObservabilityStatus status) {
         this.status = status;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/MultiClusterObservabilityList.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/MultiClusterObservabilityList.java
index a65d27de1d8..4c229fe808a 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/MultiClusterObservabilityList.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/MultiClusterObservabilityList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MultiClusterObservabilityList contains a list of MultiClusterObservability
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class MultiClusterObservabilityList implements Editable<MultiClusterObservabilityListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openclustermanagement.api.model.observability.v1beta1.MultiClusterObservability>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "observability.open-cluster-management.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openclustermanagement.api.model.observability.v1beta1.MultiClusterObservability> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MultiClusterObservabilityList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public MultiClusterObservabilityList(String apiVersion, List<io.fabric8.openclus
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * MultiClusterObservabilityList contains a list of MultiClusterObservability
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openclustermanagement.api.model.observability.v1beta1.MultiClusterObservability> getItems() {
         return items;
     }
 
+    /**
+     * MultiClusterObservabilityList contains a list of MultiClusterObservability
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openclustermanagement.api.model.observability.v1beta1.MultiClusterObservability> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MultiClusterObservabilityList contains a list of MultiClusterObservability
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MultiClusterObservabilityList contains a list of MultiClusterObservability
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/MultiClusterObservabilitySpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/MultiClusterObservabilitySpec.java
index d69529853b0..aa493b615f5 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/MultiClusterObservabilitySpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/MultiClusterObservabilitySpec.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MultiClusterObservabilitySpec defines the desired state of MultiClusterObservability.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -124,113 +127,179 @@ public MultiClusterObservabilitySpec(String availabilityConfig, Boolean enableDo
         this.tolerations = tolerations;
     }
 
+    /**
+     * ReplicaCount for HA support. Does not affect data stores. Enabled will toggle HA support. This will provide better support in cases of failover but consumes more resources. Options are: Basic and High (default).
+     */
     @JsonProperty("availabilityConfig")
     public String getAvailabilityConfig() {
         return availabilityConfig;
     }
 
+    /**
+     * ReplicaCount for HA support. Does not affect data stores. Enabled will toggle HA support. This will provide better support in cases of failover but consumes more resources. Options are: Basic and High (default).
+     */
     @JsonProperty("availabilityConfig")
     public void setAvailabilityConfig(String availabilityConfig) {
         this.availabilityConfig = availabilityConfig;
     }
 
+    /**
+     * Enable or disable the downsample. The default value is false. This is not recommended as querying long time ranges without non-downsampled data is not efficient and useful.
+     */
     @JsonProperty("enableDownSampling")
     public Boolean getEnableDownSampling() {
         return enableDownSampling;
     }
 
+    /**
+     * Enable or disable the downsample. The default value is false. This is not recommended as querying long time ranges without non-downsampled data is not efficient and useful.
+     */
     @JsonProperty("enableDownSampling")
     public void setEnableDownSampling(Boolean enableDownSampling) {
         this.enableDownSampling = enableDownSampling;
     }
 
+    /**
+     * Pull policy of the MultiClusterObservability images
+     */
     @JsonProperty("imagePullPolicy")
     public String getImagePullPolicy() {
         return imagePullPolicy;
     }
 
+    /**
+     * Pull policy of the MultiClusterObservability images
+     */
     @JsonProperty("imagePullPolicy")
     public void setImagePullPolicy(String imagePullPolicy) {
         this.imagePullPolicy = imagePullPolicy;
     }
 
+    /**
+     * Pull secret of the MultiClusterObservability images
+     */
     @JsonProperty("imagePullSecret")
     public String getImagePullSecret() {
         return imagePullSecret;
     }
 
+    /**
+     * Pull secret of the MultiClusterObservability images
+     */
     @JsonProperty("imagePullSecret")
     public void setImagePullSecret(String imagePullSecret) {
         this.imagePullSecret = imagePullSecret;
     }
 
+    /**
+     * Spec of NodeSelector
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * Spec of NodeSelector
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * MultiClusterObservabilitySpec defines the desired state of MultiClusterObservability.
+     */
     @JsonProperty("observabilityAddonSpec")
     public ObservabilityAddonSpec getObservabilityAddonSpec() {
         return observabilityAddonSpec;
     }
 
+    /**
+     * MultiClusterObservabilitySpec defines the desired state of MultiClusterObservability.
+     */
     @JsonProperty("observabilityAddonSpec")
     public void setObservabilityAddonSpec(ObservabilityAddonSpec observabilityAddonSpec) {
         this.observabilityAddonSpec = observabilityAddonSpec;
     }
 
+    /**
+     * How long to retain samples of resolution 2 (1 hour) in bucket.
+     */
     @JsonProperty("retentionResolution1h")
     public String getRetentionResolution1h() {
         return retentionResolution1h;
     }
 
+    /**
+     * How long to retain samples of resolution 2 (1 hour) in bucket.
+     */
     @JsonProperty("retentionResolution1h")
     public void setRetentionResolution1h(String retentionResolution1h) {
         this.retentionResolution1h = retentionResolution1h;
     }
 
+    /**
+     * How long to retain samples of resolution 1 (5 minutes) in bucket.
+     */
     @JsonProperty("retentionResolution5m")
     public String getRetentionResolution5m() {
         return retentionResolution5m;
     }
 
+    /**
+     * How long to retain samples of resolution 1 (5 minutes) in bucket.
+     */
     @JsonProperty("retentionResolution5m")
     public void setRetentionResolution5m(String retentionResolution5m) {
         this.retentionResolution5m = retentionResolution5m;
     }
 
+    /**
+     * How long to retain raw samples in a bucket.
+     */
     @JsonProperty("retentionResolutionRaw")
     public String getRetentionResolutionRaw() {
         return retentionResolutionRaw;
     }
 
+    /**
+     * How long to retain raw samples in a bucket.
+     */
     @JsonProperty("retentionResolutionRaw")
     public void setRetentionResolutionRaw(String retentionResolutionRaw) {
         this.retentionResolutionRaw = retentionResolutionRaw;
     }
 
+    /**
+     * MultiClusterObservabilitySpec defines the desired state of MultiClusterObservability.
+     */
     @JsonProperty("storageConfigObject")
     public StorageConfigObject getStorageConfigObject() {
         return storageConfigObject;
     }
 
+    /**
+     * MultiClusterObservabilitySpec defines the desired state of MultiClusterObservability.
+     */
     @JsonProperty("storageConfigObject")
     public void setStorageConfigObject(StorageConfigObject storageConfigObject) {
         this.storageConfigObject = storageConfigObject;
     }
 
+    /**
+     * Tolerations causes all components to tolerate any taints.
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * Tolerations causes all components to tolerate any taints.
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/MultiClusterObservabilityStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/MultiClusterObservabilityStatus.java
index 9338e8f6021..41617653b3e 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/MultiClusterObservabilityStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/MultiClusterObservabilityStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MultiClusterObservabilityStatus defines the observed state of MultiClusterObservability.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,12 +85,18 @@ public MultiClusterObservabilityStatus(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Represents the status of each deployment
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Represents the status of each deployment
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/ObservabilityAddon.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/ObservabilityAddon.java
index 203d80531e5..fb82df4445c 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/ObservabilityAddon.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/ObservabilityAddon.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ObservabilityAddon is the Schema for the observabilityaddon API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class ObservabilityAddon implements Editable<ObservabilityAddonBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "observability.open-cluster-management.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ObservabilityAddon";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public ObservabilityAddon(String apiVersion, String kind, ObjectMeta metadata, O
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ObservabilityAddon is the Schema for the observabilityaddon API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ObservabilityAddon is the Schema for the observabilityaddon API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ObservabilityAddon is the Schema for the observabilityaddon API
+     */
     @JsonProperty("spec")
     public ObservabilityAddonSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ObservabilityAddon is the Schema for the observabilityaddon API
+     */
     @JsonProperty("spec")
     public void setSpec(ObservabilityAddonSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ObservabilityAddon is the Schema for the observabilityaddon API
+     */
     @JsonProperty("status")
     public ObservabilityAddonStatus getStatus() {
         return status;
     }
 
+    /**
+     * ObservabilityAddon is the Schema for the observabilityaddon API
+     */
     @JsonProperty("status")
     public void setStatus(ObservabilityAddonStatus status) {
         this.status = status;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/ObservabilityAddonList.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/ObservabilityAddonList.java
index 879528dd720..d07a17374f2 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/ObservabilityAddonList.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/ObservabilityAddonList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ObservabilityAddonList contains a list of ObservabilityAddon
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ObservabilityAddonList implements Editable<ObservabilityAddonListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openclustermanagement.api.model.observability.v1beta1.ObservabilityAddon>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "observability.open-cluster-management.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openclustermanagement.api.model.observability.v1beta1.ObservabilityAddon> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ObservabilityAddonList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ObservabilityAddonList(String apiVersion, List<io.fabric8.openclustermana
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ObservabilityAddonList contains a list of ObservabilityAddon
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openclustermanagement.api.model.observability.v1beta1.ObservabilityAddon> getItems() {
         return items;
     }
 
+    /**
+     * ObservabilityAddonList contains a list of ObservabilityAddon
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openclustermanagement.api.model.observability.v1beta1.ObservabilityAddon> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ObservabilityAddonList contains a list of ObservabilityAddon
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ObservabilityAddonList contains a list of ObservabilityAddon
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/ObservabilityAddonStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/ObservabilityAddonStatus.java
index 202787bd49f..0f0ac5a42d9 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/ObservabilityAddonStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/ObservabilityAddonStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ObservabilityAddonStatus defines the observed state of ObservabilityAddon
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public ObservabilityAddonStatus(List<StatusCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservabilityAddonStatus defines the observed state of ObservabilityAddon
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<StatusCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * ObservabilityAddonStatus defines the observed state of ObservabilityAddon
+     */
     @JsonProperty("conditions")
     public void setConditions(List<StatusCondition> conditions) {
         this.conditions = conditions;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/StatusCondition.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/StatusCondition.java
index c7a6133af91..d3fa24a6bed 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/StatusCondition.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/StatusCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StatusCondition contains condition information for an observability addon
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public StatusCondition(String lastTransitionTime, String message, String reason,
         this.type = type;
     }
 
+    /**
+     * StatusCondition contains condition information for an observability addon
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * StatusCondition contains condition information for an observability addon
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * StatusCondition contains condition information for an observability addon
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * StatusCondition contains condition information for an observability addon
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * StatusCondition contains condition information for an observability addon
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * StatusCondition contains condition information for an observability addon
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * StatusCondition contains condition information for an observability addon
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * StatusCondition contains condition information for an observability addon
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * StatusCondition contains condition information for an observability addon
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * StatusCondition contains condition information for an observability addon
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/StorageConfigObject.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/StorageConfigObject.java
index ddd184df572..38ab2bf832d 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/StorageConfigObject.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta1/StorageConfigObject.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StorageConfigObject is the spec of object storage.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,31 +90,49 @@ public StorageConfigObject(PreConfiguredStorage metricObjectStorage, String stat
         this.statefulSetStorageClass = statefulSetStorageClass;
     }
 
+    /**
+     * StorageConfigObject is the spec of object storage.
+     */
     @JsonProperty("metricObjectStorage")
     public PreConfiguredStorage getMetricObjectStorage() {
         return metricObjectStorage;
     }
 
+    /**
+     * StorageConfigObject is the spec of object storage.
+     */
     @JsonProperty("metricObjectStorage")
     public void setMetricObjectStorage(PreConfiguredStorage metricObjectStorage) {
         this.metricObjectStorage = metricObjectStorage;
     }
 
+    /**
+     * The amount of storage applied to the Observability stateful sets, i.e. Thanos store, Rule, compact and receiver.
+     */
     @JsonProperty("statefulSetSize")
     public String getStatefulSetSize() {
         return statefulSetSize;
     }
 
+    /**
+     * The amount of storage applied to the Observability stateful sets, i.e. Thanos store, Rule, compact and receiver.
+     */
     @JsonProperty("statefulSetSize")
     public void setStatefulSetSize(String statefulSetSize) {
         this.statefulSetSize = statefulSetSize;
     }
 
+    /**
+     * Specify the storageClass Stateful Sets. This storage class will also<br><p> be used for Object Storage if MetricObjectStorage was configured for the system to create the storage.
+     */
     @JsonProperty("statefulSetStorageClass")
     public String getStatefulSetStorageClass() {
         return statefulSetStorageClass;
     }
 
+    /**
+     * Specify the storageClass Stateful Sets. This storage class will also<br><p> be used for Object Storage if MetricObjectStorage was configured for the system to create the storage.
+     */
     @JsonProperty("statefulSetStorageClass")
     public void setStatefulSetStorageClass(String statefulSetStorageClass) {
         this.statefulSetStorageClass = statefulSetStorageClass;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/AdvancedConfig.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/AdvancedConfig.java
index 54b841e9d23..df2821439fe 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/AdvancedConfig.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/AdvancedConfig.java
@@ -158,21 +158,33 @@ public void setCompact(CompactSpec compact) {
         this.compact = compact;
     }
 
+    /**
+     * CustomAlertmanagerHubURL overrides the alertmanager URL to send alerts from the spoke to the hub server. For the alertmanager that runs in the hub this setting has no effect.
+     */
     @JsonProperty("customAlertmanagerHubURL")
     public String getCustomAlertmanagerHubURL() {
         return customAlertmanagerHubURL;
     }
 
+    /**
+     * CustomAlertmanagerHubURL overrides the alertmanager URL to send alerts from the spoke to the hub server. For the alertmanager that runs in the hub this setting has no effect.
+     */
     @JsonProperty("customAlertmanagerHubURL")
     public void setCustomAlertmanagerHubURL(String customAlertmanagerHubURL) {
         this.customAlertmanagerHubURL = customAlertmanagerHubURL;
     }
 
+    /**
+     * CustomObservabilityHubURL overrides the endpoint used by the metrics-collector to send metrics to the hub server. For the metrics-collector that runs in the hub this setting has no effect.
+     */
     @JsonProperty("customObservabilityHubURL")
     public String getCustomObservabilityHubURL() {
         return customObservabilityHubURL;
     }
 
+    /**
+     * CustomObservabilityHubURL overrides the endpoint used by the metrics-collector to send metrics to the hub server. For the metrics-collector that runs in the hub this setting has no effect.
+     */
     @JsonProperty("customObservabilityHubURL")
     public void setCustomObservabilityHubURL(String customObservabilityHubURL) {
         this.customObservabilityHubURL = customObservabilityHubURL;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/AlertmanagerSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/AlertmanagerSpec.java
index 59add21d4a1..c3caf57dc88 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/AlertmanagerSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/AlertmanagerSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AlertmanagerSpec defines the spec for the Alertmanager component.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public AlertmanagerSpec(Integer replicas, ResourceRequirements resources, List<S
         this.secrets = secrets;
     }
 
+    /**
+     * Replicas for this component.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Replicas for this component.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * AlertmanagerSpec defines the spec for the Alertmanager component.
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * AlertmanagerSpec defines the spec for the Alertmanager component.
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * Secrets is a list of Secrets in the same namespace as the MCO object. Each of these Secrets shall be mounted into the Alertmanager Pods. Secrets are added to the StatefulSet as a volume named secret-&lt;secret-name&gt;. Secrets are mounted into /etc/alertmanager/secrets/&lt;secret-name&gt; in the 'alertmanager' container.
+     */
     @JsonProperty("secrets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSecrets() {
         return secrets;
     }
 
+    /**
+     * Secrets is a list of Secrets in the same namespace as the MCO object. Each of these Secrets shall be mounted into the Alertmanager Pods. Secrets are added to the StatefulSet as a volume named secret-&lt;secret-name&gt;. Secrets are mounted into /etc/alertmanager/secrets/&lt;secret-name&gt; in the 'alertmanager' container.
+     */
     @JsonProperty("secrets")
     public void setSecrets(List<String> secrets) {
         this.secrets = secrets;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/CacheConfig.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/CacheConfig.java
index c1831ab0790..e3b8aa123e3 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/CacheConfig.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/CacheConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CacheConfig is the spec of memcached.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public CacheConfig(Integer connectionLimit, String maxItemSize, Integer memoryLi
         this.resources = resources;
     }
 
+    /**
+     * Max simultaneous connections of Memcached.
+     */
     @JsonProperty("connectionLimit")
     public Integer getConnectionLimit() {
         return connectionLimit;
     }
 
+    /**
+     * Max simultaneous connections of Memcached.
+     */
     @JsonProperty("connectionLimit")
     public void setConnectionLimit(Integer connectionLimit) {
         this.connectionLimit = connectionLimit;
     }
 
+    /**
+     * Max item size of Memcached (default: 1m, min: 1k, max: 1024m).
+     */
     @JsonProperty("maxItemSize")
     public String getMaxItemSize() {
         return maxItemSize;
     }
 
+    /**
+     * Max item size of Memcached (default: 1m, min: 1k, max: 1024m).
+     */
     @JsonProperty("maxItemSize")
     public void setMaxItemSize(String maxItemSize) {
         this.maxItemSize = maxItemSize;
     }
 
+    /**
+     * Memory limit of Memcached in megabytes.
+     */
     @JsonProperty("memoryLimitMb")
     public Integer getMemoryLimitMb() {
         return memoryLimitMb;
     }
 
+    /**
+     * Memory limit of Memcached in megabytes.
+     */
     @JsonProperty("memoryLimitMb")
     public void setMemoryLimitMb(Integer memoryLimitMb) {
         this.memoryLimitMb = memoryLimitMb;
     }
 
+    /**
+     * Replicas for this component.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Replicas for this component.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * CacheConfig is the spec of memcached.
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * CacheConfig is the spec of memcached.
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/CapabilitiesSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/CapabilitiesSpec.java
index 53cd4b38277..e0f129e2840 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/CapabilitiesSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/CapabilitiesSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CapabilitiesSpec defines the platform and user workload observabilities capabilities managed exclusively by the multicluster-observability-addon. Enabling any of these capabilities will result in deploying the following resources:<br><p>   - The addon Deployment, ServiceAccount and RBAC.<br><p>   - A ClusterManagementAddon managing placement for capability related custom resources.<br><p>   - An AddonDeploymentConfig managing the addon feature gates for activated capabilities.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public CapabilitiesSpec(PlatformCapabilitiesSpec platform, UserWorkloadCapabilit
         this.userWorkloads = userWorkloads;
     }
 
+    /**
+     * CapabilitiesSpec defines the platform and user workload observabilities capabilities managed exclusively by the multicluster-observability-addon. Enabling any of these capabilities will result in deploying the following resources:<br><p>   - The addon Deployment, ServiceAccount and RBAC.<br><p>   - A ClusterManagementAddon managing placement for capability related custom resources.<br><p>   - An AddonDeploymentConfig managing the addon feature gates for activated capabilities.
+     */
     @JsonProperty("platform")
     public PlatformCapabilitiesSpec getPlatform() {
         return platform;
     }
 
+    /**
+     * CapabilitiesSpec defines the platform and user workload observabilities capabilities managed exclusively by the multicluster-observability-addon. Enabling any of these capabilities will result in deploying the following resources:<br><p>   - The addon Deployment, ServiceAccount and RBAC.<br><p>   - A ClusterManagementAddon managing placement for capability related custom resources.<br><p>   - An AddonDeploymentConfig managing the addon feature gates for activated capabilities.
+     */
     @JsonProperty("platform")
     public void setPlatform(PlatformCapabilitiesSpec platform) {
         this.platform = platform;
     }
 
+    /**
+     * CapabilitiesSpec defines the platform and user workload observabilities capabilities managed exclusively by the multicluster-observability-addon. Enabling any of these capabilities will result in deploying the following resources:<br><p>   - The addon Deployment, ServiceAccount and RBAC.<br><p>   - A ClusterManagementAddon managing placement for capability related custom resources.<br><p>   - An AddonDeploymentConfig managing the addon feature gates for activated capabilities.
+     */
     @JsonProperty("userWorkloads")
     public UserWorkloadCapabilitiesSpec getUserWorkloads() {
         return userWorkloads;
     }
 
+    /**
+     * CapabilitiesSpec defines the platform and user workload observabilities capabilities managed exclusively by the multicluster-observability-addon. Enabling any of these capabilities will result in deploying the following resources:<br><p>   - The addon Deployment, ServiceAccount and RBAC.<br><p>   - A ClusterManagementAddon managing placement for capability related custom resources.<br><p>   - An AddonDeploymentConfig managing the addon feature gates for activated capabilities.
+     */
     @JsonProperty("userWorkloads")
     public void setUserWorkloads(UserWorkloadCapabilitiesSpec userWorkloads) {
         this.userWorkloads = userWorkloads;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/ClusterLogForwarderSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/ClusterLogForwarderSpec.java
index fd96ea9e9d7..01de9700801 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/ClusterLogForwarderSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/ClusterLogForwarderSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterLogForwarderSpec defines the spec for the addon to collect and forward logs using the ClusterLogForwarder custom resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ClusterLogForwarderSpec(Boolean enabled) {
         this.enabled = enabled;
     }
 
+    /**
+     * Enabled defines a flag to enable/disable the platform log collection using the ClusterLogForwarder resource.
+     */
     @JsonProperty("enabled")
     public Boolean getEnabled() {
         return enabled;
     }
 
+    /**
+     * Enabled defines a flag to enable/disable the platform log collection using the ClusterLogForwarder resource.
+     */
     @JsonProperty("enabled")
     public void setEnabled(Boolean enabled) {
         this.enabled = enabled;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/CommonSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/CommonSpec.java
index 6ad2af1e925..93901780f60 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/CommonSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/CommonSpec.java
@@ -82,11 +82,17 @@ public CommonSpec(Integer replicas, ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * Replicas for this component.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Replicas for this component.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/CompactSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/CompactSpec.java
index c8cf2106d4f..c3a5633e21e 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/CompactSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/CompactSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Thanos Compact Spec.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public CompactSpec(List<Container> containers, ResourceRequirements resources, M
         this.serviceAccountAnnotations = serviceAccountAnnotations;
     }
 
+    /**
+     * WARNING: Use only with guidance from Red Hat Support. Using this feature incorrectly can lead to an unrecoverable state, data loss, or both, which is not covered by Red Hat Support.
+     */
     @JsonProperty("containers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Container> getContainers() {
         return containers;
     }
 
+    /**
+     * WARNING: Use only with guidance from Red Hat Support. Using this feature incorrectly can lead to an unrecoverable state, data loss, or both, which is not covered by Red Hat Support.
+     */
     @JsonProperty("containers")
     public void setContainers(List<Container> containers) {
         this.containers = containers;
     }
 
+    /**
+     * Thanos Compact Spec.
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * Thanos Compact Spec.
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * Annotations is an unstructured key value map stored with a service account
+     */
     @JsonProperty("serviceAccountAnnotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getServiceAccountAnnotations() {
         return serviceAccountAnnotations;
     }
 
+    /**
+     * Annotations is an unstructured key value map stored with a service account
+     */
     @JsonProperty("serviceAccountAnnotations")
     public void setServiceAccountAnnotations(Map<String, String> serviceAccountAnnotations) {
         this.serviceAccountAnnotations = serviceAccountAnnotations;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/InstrumentationSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/InstrumentationSpec.java
index ec7f973df34..3553a99b9ab 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/InstrumentationSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/InstrumentationSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OpenTelemetryCollectorSpec defines the spec for the addon to collect observability signals using the Instrumentation custom resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public InstrumentationSpec(Boolean enabled) {
         this.enabled = enabled;
     }
 
+    /**
+     * Enabled defines a flag to enable/disable the user workload observability collection using the Instrumentation resource.
+     */
     @JsonProperty("enabled")
     public Boolean getEnabled() {
         return enabled;
     }
 
+    /**
+     * Enabled defines a flag to enable/disable the user workload observability collection using the Instrumentation resource.
+     */
     @JsonProperty("enabled")
     public void setEnabled(Boolean enabled) {
         this.enabled = enabled;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/MultiClusterObservability.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/MultiClusterObservability.java
index afeef7a266d..2f04357507c 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/MultiClusterObservability.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/MultiClusterObservability.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MultiClusterObservability defines the configuration for the Observability installation on Hub and Managed Clusters all through this one custom resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class MultiClusterObservability implements Editable<MultiClusterObservabilityBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "observability.open-cluster-management.io/v1beta2";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MultiClusterObservability";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public MultiClusterObservability(String apiVersion, String kind, ObjectMeta meta
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MultiClusterObservability defines the configuration for the Observability installation on Hub and Managed Clusters all through this one custom resource.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MultiClusterObservability defines the configuration for the Observability installation on Hub and Managed Clusters all through this one custom resource.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * MultiClusterObservability defines the configuration for the Observability installation on Hub and Managed Clusters all through this one custom resource.
+     */
     @JsonProperty("spec")
     public MultiClusterObservabilitySpec getSpec() {
         return spec;
     }
 
+    /**
+     * MultiClusterObservability defines the configuration for the Observability installation on Hub and Managed Clusters all through this one custom resource.
+     */
     @JsonProperty("spec")
     public void setSpec(MultiClusterObservabilitySpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * MultiClusterObservability defines the configuration for the Observability installation on Hub and Managed Clusters all through this one custom resource.
+     */
     @JsonProperty("status")
     public MultiClusterObservabilityStatus getStatus() {
         return status;
     }
 
+    /**
+     * MultiClusterObservability defines the configuration for the Observability installation on Hub and Managed Clusters all through this one custom resource.
+     */
     @JsonProperty("status")
     public void setStatus(MultiClusterObservabilityStatus status) {
         this.status = status;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/MultiClusterObservabilityList.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/MultiClusterObservabilityList.java
index 12d41b12f88..c7749c57459 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/MultiClusterObservabilityList.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/MultiClusterObservabilityList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MultiClusterObservabilityList contains a list of MultiClusterObservability
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class MultiClusterObservabilityList implements Editable<MultiClusterObservabilityListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openclustermanagement.api.model.observability.v1beta2.MultiClusterObservability>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "observability.open-cluster-management.io/v1beta2";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openclustermanagement.api.model.observability.v1beta2.MultiClusterObservability> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MultiClusterObservabilityList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public MultiClusterObservabilityList(String apiVersion, List<io.fabric8.openclus
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * MultiClusterObservabilityList contains a list of MultiClusterObservability
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openclustermanagement.api.model.observability.v1beta2.MultiClusterObservability> getItems() {
         return items;
     }
 
+    /**
+     * MultiClusterObservabilityList contains a list of MultiClusterObservability
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openclustermanagement.api.model.observability.v1beta2.MultiClusterObservability> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MultiClusterObservabilityList contains a list of MultiClusterObservability
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MultiClusterObservabilityList contains a list of MultiClusterObservability
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/MultiClusterObservabilitySpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/MultiClusterObservabilitySpec.java
index b90b36dc94f..b999fcc5f93 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/MultiClusterObservabilitySpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/MultiClusterObservabilitySpec.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MultiClusterObservabilitySpec defines the desired state of MultiClusterObservability.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -120,103 +123,163 @@ public MultiClusterObservabilitySpec(AdvancedConfig advanced, CapabilitiesSpec c
         this.tolerations = tolerations;
     }
 
+    /**
+     * MultiClusterObservabilitySpec defines the desired state of MultiClusterObservability.
+     */
     @JsonProperty("advanced")
     public AdvancedConfig getAdvanced() {
         return advanced;
     }
 
+    /**
+     * MultiClusterObservabilitySpec defines the desired state of MultiClusterObservability.
+     */
     @JsonProperty("advanced")
     public void setAdvanced(AdvancedConfig advanced) {
         this.advanced = advanced;
     }
 
+    /**
+     * MultiClusterObservabilitySpec defines the desired state of MultiClusterObservability.
+     */
     @JsonProperty("capabilities")
     public CapabilitiesSpec getCapabilities() {
         return capabilities;
     }
 
+    /**
+     * MultiClusterObservabilitySpec defines the desired state of MultiClusterObservability.
+     */
     @JsonProperty("capabilities")
     public void setCapabilities(CapabilitiesSpec capabilities) {
         this.capabilities = capabilities;
     }
 
+    /**
+     * Enable or disable the downsample.
+     */
     @JsonProperty("enableDownsampling")
     public Boolean getEnableDownsampling() {
         return enableDownsampling;
     }
 
+    /**
+     * Enable or disable the downsample.
+     */
     @JsonProperty("enableDownsampling")
     public void setEnableDownsampling(Boolean enableDownsampling) {
         this.enableDownsampling = enableDownsampling;
     }
 
+    /**
+     * Pull policy of the MultiClusterObservability images
+     */
     @JsonProperty("imagePullPolicy")
     public String getImagePullPolicy() {
         return imagePullPolicy;
     }
 
+    /**
+     * Pull policy of the MultiClusterObservability images
+     */
     @JsonProperty("imagePullPolicy")
     public void setImagePullPolicy(String imagePullPolicy) {
         this.imagePullPolicy = imagePullPolicy;
     }
 
+    /**
+     * Pull secret of the MultiClusterObservability images
+     */
     @JsonProperty("imagePullSecret")
     public String getImagePullSecret() {
         return imagePullSecret;
     }
 
+    /**
+     * Pull secret of the MultiClusterObservability images
+     */
     @JsonProperty("imagePullSecret")
     public void setImagePullSecret(String imagePullSecret) {
         this.imagePullSecret = imagePullSecret;
     }
 
+    /**
+     * Size read and write paths of your Observability instance
+     */
     @JsonProperty("instanceSize")
     public String getInstanceSize() {
         return instanceSize;
     }
 
+    /**
+     * Size read and write paths of your Observability instance
+     */
     @JsonProperty("instanceSize")
     public void setInstanceSize(String instanceSize) {
         this.instanceSize = instanceSize;
     }
 
+    /**
+     * Spec of NodeSelector
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * Spec of NodeSelector
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * MultiClusterObservabilitySpec defines the desired state of MultiClusterObservability.
+     */
     @JsonProperty("observabilityAddonSpec")
     public ObservabilityAddonSpec getObservabilityAddonSpec() {
         return observabilityAddonSpec;
     }
 
+    /**
+     * MultiClusterObservabilitySpec defines the desired state of MultiClusterObservability.
+     */
     @JsonProperty("observabilityAddonSpec")
     public void setObservabilityAddonSpec(ObservabilityAddonSpec observabilityAddonSpec) {
         this.observabilityAddonSpec = observabilityAddonSpec;
     }
 
+    /**
+     * MultiClusterObservabilitySpec defines the desired state of MultiClusterObservability.
+     */
     @JsonProperty("storageConfig")
     public StorageConfig getStorageConfig() {
         return storageConfig;
     }
 
+    /**
+     * MultiClusterObservabilitySpec defines the desired state of MultiClusterObservability.
+     */
     @JsonProperty("storageConfig")
     public void setStorageConfig(StorageConfig storageConfig) {
         this.storageConfig = storageConfig;
     }
 
+    /**
+     * Tolerations causes all components to tolerate any taints.
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * Tolerations causes all components to tolerate any taints.
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/MultiClusterObservabilityStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/MultiClusterObservabilityStatus.java
index 65500251124..c0da92b385b 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/MultiClusterObservabilityStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/MultiClusterObservabilityStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MultiClusterObservabilityStatus defines the observed state of MultiClusterObservability.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,12 +85,18 @@ public MultiClusterObservabilityStatus(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Represents the status of each deployment
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Represents the status of each deployment
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/OpenTelemetryCollectionSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/OpenTelemetryCollectionSpec.java
index 62a38c41406..ae778ab2544 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/OpenTelemetryCollectionSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/OpenTelemetryCollectionSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OpenTelemetryCollectionSpec defines the spec for the addon to collect and forward observability signals from user workloads hosted on fleet managed clusters using the OpenTelemetryCollector with or without instrumentation.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public OpenTelemetryCollectionSpec(OpenTelemetryCollectorSpec collector, Instrum
         this.instrumentation = instrumentation;
     }
 
+    /**
+     * OpenTelemetryCollectionSpec defines the spec for the addon to collect and forward observability signals from user workloads hosted on fleet managed clusters using the OpenTelemetryCollector with or without instrumentation.
+     */
     @JsonProperty("collector")
     public OpenTelemetryCollectorSpec getCollector() {
         return collector;
     }
 
+    /**
+     * OpenTelemetryCollectionSpec defines the spec for the addon to collect and forward observability signals from user workloads hosted on fleet managed clusters using the OpenTelemetryCollector with or without instrumentation.
+     */
     @JsonProperty("collector")
     public void setCollector(OpenTelemetryCollectorSpec collector) {
         this.collector = collector;
     }
 
+    /**
+     * OpenTelemetryCollectionSpec defines the spec for the addon to collect and forward observability signals from user workloads hosted on fleet managed clusters using the OpenTelemetryCollector with or without instrumentation.
+     */
     @JsonProperty("instrumentation")
     public InstrumentationSpec getInstrumentation() {
         return instrumentation;
     }
 
+    /**
+     * OpenTelemetryCollectionSpec defines the spec for the addon to collect and forward observability signals from user workloads hosted on fleet managed clusters using the OpenTelemetryCollector with or without instrumentation.
+     */
     @JsonProperty("instrumentation")
     public void setInstrumentation(InstrumentationSpec instrumentation) {
         this.instrumentation = instrumentation;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/OpenTelemetryCollectorSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/OpenTelemetryCollectorSpec.java
index 4603f165849..072907a0475 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/OpenTelemetryCollectorSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/OpenTelemetryCollectorSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OpenTelemetryCollectorSpec defines the spec for the addon to collect and forward observability signals using the OpenTelemetryCollector custom resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public OpenTelemetryCollectorSpec(Boolean enabled) {
         this.enabled = enabled;
     }
 
+    /**
+     * Enabled defines a flag to enable/disable the user workload observability collection using the OpenTelemetryCollector resource.
+     */
     @JsonProperty("enabled")
     public Boolean getEnabled() {
         return enabled;
     }
 
+    /**
+     * Enabled defines a flag to enable/disable the user workload observability collection using the OpenTelemetryCollector resource.
+     */
     @JsonProperty("enabled")
     public void setEnabled(Boolean enabled) {
         this.enabled = enabled;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/PlatformCapabilitiesSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/PlatformCapabilitiesSpec.java
index 615f5ae905c..9a71077427e 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/PlatformCapabilitiesSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/PlatformCapabilitiesSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PlatformCapabilitiesSpec defines the observability capabilities managed by the addon for platform components.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public PlatformCapabilitiesSpec(PlatformLogsSpec logs) {
         this.logs = logs;
     }
 
+    /**
+     * PlatformCapabilitiesSpec defines the observability capabilities managed by the addon for platform components.
+     */
     @JsonProperty("logs")
     public PlatformLogsSpec getLogs() {
         return logs;
     }
 
+    /**
+     * PlatformCapabilitiesSpec defines the observability capabilities managed by the addon for platform components.
+     */
     @JsonProperty("logs")
     public void setLogs(PlatformLogsSpec logs) {
         this.logs = logs;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/PlatformLogsCollectionSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/PlatformLogsCollectionSpec.java
index 076dcead79a..587d10e37b9 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/PlatformLogsCollectionSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/PlatformLogsCollectionSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PlatformLogsCollectionSpec defines the spec for the addon to collect and forward logs from fleet managed clusters using the ClusterLogForwarder custom resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public PlatformLogsCollectionSpec(Boolean enabled) {
         this.enabled = enabled;
     }
 
+    /**
+     * Enabled defines a flag to enable/disable the platform log collection.
+     */
     @JsonProperty("enabled")
     public Boolean getEnabled() {
         return enabled;
     }
 
+    /**
+     * Enabled defines a flag to enable/disable the platform log collection.
+     */
     @JsonProperty("enabled")
     public void setEnabled(Boolean enabled) {
         this.enabled = enabled;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/PlatformLogsSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/PlatformLogsSpec.java
index 18cad3db15b..7e1d0f011a1 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/PlatformLogsSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/PlatformLogsSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PlatformLogsSpec defines the spec for the addon to collect, forward and store logs from fleet managed clusters.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public PlatformLogsSpec(PlatformLogsCollectionSpec collection) {
         this.collection = collection;
     }
 
+    /**
+     * PlatformLogsSpec defines the spec for the addon to collect, forward and store logs from fleet managed clusters.
+     */
     @JsonProperty("collection")
     public PlatformLogsCollectionSpec getCollection() {
         return collection;
     }
 
+    /**
+     * PlatformLogsSpec defines the spec for the addon to collect, forward and store logs from fleet managed clusters.
+     */
     @JsonProperty("collection")
     public void setCollection(PlatformLogsCollectionSpec collection) {
         this.collection = collection;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/QueryFrontendSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/QueryFrontendSpec.java
index 8440dc387d4..690ec9d491d 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/QueryFrontendSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/QueryFrontendSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Thanos QueryFrontend Spec.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public QueryFrontendSpec(List<Container> containers, Integer replicas, ResourceR
         this.resources = resources;
     }
 
+    /**
+     * WARNING: Use only with guidance from Red Hat Support. Using this feature incorrectly can lead to an unrecoverable state, data loss, or both, which is not covered by Red Hat Support.
+     */
     @JsonProperty("containers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Container> getContainers() {
         return containers;
     }
 
+    /**
+     * WARNING: Use only with guidance from Red Hat Support. Using this feature incorrectly can lead to an unrecoverable state, data loss, or both, which is not covered by Red Hat Support.
+     */
     @JsonProperty("containers")
     public void setContainers(List<Container> containers) {
         this.containers = containers;
     }
 
+    /**
+     * Replicas for this component.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Replicas for this component.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * Thanos QueryFrontend Spec.
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * Thanos QueryFrontend Spec.
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/QuerySpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/QuerySpec.java
index f6bb5daf67a..217ad96f7c8 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/QuerySpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/QuerySpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Thanos Query Spec.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,53 +101,83 @@ public QuerySpec(List<Container> containers, Integer replicas, ResourceRequireme
         this.usePrometheusEngine = usePrometheusEngine;
     }
 
+    /**
+     * WARNING: Use only with guidance from Red Hat Support. Using this feature incorrectly can lead to an unrecoverable state, data loss, or both, which is not covered by Red Hat Support.
+     */
     @JsonProperty("containers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Container> getContainers() {
         return containers;
     }
 
+    /**
+     * WARNING: Use only with guidance from Red Hat Support. Using this feature incorrectly can lead to an unrecoverable state, data loss, or both, which is not covered by Red Hat Support.
+     */
     @JsonProperty("containers")
     public void setContainers(List<Container> containers) {
         this.containers = containers;
     }
 
+    /**
+     * Replicas for this component.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Replicas for this component.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * Thanos Query Spec.
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * Thanos Query Spec.
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * Annotations is an unstructured key value map stored with a service account
+     */
     @JsonProperty("serviceAccountAnnotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getServiceAccountAnnotations() {
         return serviceAccountAnnotations;
     }
 
+    /**
+     * Annotations is an unstructured key value map stored with a service account
+     */
     @JsonProperty("serviceAccountAnnotations")
     public void setServiceAccountAnnotations(Map<String, String> serviceAccountAnnotations) {
         this.serviceAccountAnnotations = serviceAccountAnnotations;
     }
 
+    /**
+     * Set to true to use the old Prometheus engine for PromQL queries.
+     */
     @JsonProperty("usePrometheusEngine")
     public Boolean getUsePrometheusEngine() {
         return usePrometheusEngine;
     }
 
+    /**
+     * Set to true to use the old Prometheus engine for PromQL queries.
+     */
     @JsonProperty("usePrometheusEngine")
     public void setUsePrometheusEngine(Boolean usePrometheusEngine) {
         this.usePrometheusEngine = usePrometheusEngine;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/ReceiveSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/ReceiveSpec.java
index 97837d643c1..11be61005a4 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/ReceiveSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/ReceiveSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Thanos Receive Spec.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,43 +97,67 @@ public ReceiveSpec(List<Container> containers, Integer replicas, ResourceRequire
         this.serviceAccountAnnotations = serviceAccountAnnotations;
     }
 
+    /**
+     * WARNING: Use only with guidance from Red Hat Support. Using this feature incorrectly can lead to an unrecoverable state, data loss, or both, which is not covered by Red Hat Support.
+     */
     @JsonProperty("containers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Container> getContainers() {
         return containers;
     }
 
+    /**
+     * WARNING: Use only with guidance from Red Hat Support. Using this feature incorrectly can lead to an unrecoverable state, data loss, or both, which is not covered by Red Hat Support.
+     */
     @JsonProperty("containers")
     public void setContainers(List<Container> containers) {
         this.containers = containers;
     }
 
+    /**
+     * Replicas for this component.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Replicas for this component.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * Thanos Receive Spec.
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * Thanos Receive Spec.
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * Annotations is an unstructured key value map stored with a service account
+     */
     @JsonProperty("serviceAccountAnnotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getServiceAccountAnnotations() {
         return serviceAccountAnnotations;
     }
 
+    /**
+     * Annotations is an unstructured key value map stored with a service account
+     */
     @JsonProperty("serviceAccountAnnotations")
     public void setServiceAccountAnnotations(Map<String, String> serviceAccountAnnotations) {
         this.serviceAccountAnnotations = serviceAccountAnnotations;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/RetentionConfig.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/RetentionConfig.java
index bd598eaad01..4031082d596 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/RetentionConfig.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/RetentionConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RetentionConfig is the spec of retention configurations.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public RetentionConfig(String blockDuration, String deleteDelay, String retentio
         this.retentionResolutionRaw = retentionResolutionRaw;
     }
 
+    /**
+     * configure --tsdb.block-duration in rule (Block duration for TSDB block)
+     */
     @JsonProperty("blockDuration")
     public String getBlockDuration() {
         return blockDuration;
     }
 
+    /**
+     * configure --tsdb.block-duration in rule (Block duration for TSDB block)
+     */
     @JsonProperty("blockDuration")
     public void setBlockDuration(String blockDuration) {
         this.blockDuration = blockDuration;
     }
 
+    /**
+     * configure --delete-delay in compact Time before a block marked for deletion is deleted from bucket.
+     */
     @JsonProperty("deleteDelay")
     public String getDeleteDelay() {
         return deleteDelay;
     }
 
+    /**
+     * configure --delete-delay in compact Time before a block marked for deletion is deleted from bucket.
+     */
     @JsonProperty("deleteDelay")
     public void setDeleteDelay(String deleteDelay) {
         this.deleteDelay = deleteDelay;
     }
 
+    /**
+     * How long to retain raw samples in a local disk. It applies to rule/receive: --tsdb.retention in receive --tsdb.retention in rule
+     */
     @JsonProperty("retentionInLocal")
     public String getRetentionInLocal() {
         return retentionInLocal;
     }
 
+    /**
+     * How long to retain raw samples in a local disk. It applies to rule/receive: --tsdb.retention in receive --tsdb.retention in rule
+     */
     @JsonProperty("retentionInLocal")
     public void setRetentionInLocal(String retentionInLocal) {
         this.retentionInLocal = retentionInLocal;
     }
 
+    /**
+     * How long to retain samples of resolution 2 (1 hour) in bucket. It applies to --retention.resolution-1h in compact.
+     */
     @JsonProperty("retentionResolution1h")
     public String getRetentionResolution1h() {
         return retentionResolution1h;
     }
 
+    /**
+     * How long to retain samples of resolution 2 (1 hour) in bucket. It applies to --retention.resolution-1h in compact.
+     */
     @JsonProperty("retentionResolution1h")
     public void setRetentionResolution1h(String retentionResolution1h) {
         this.retentionResolution1h = retentionResolution1h;
     }
 
+    /**
+     * How long to retain samples of resolution 1 (5 minutes) in bucket. It applies to --retention.resolution-5m in compact.
+     */
     @JsonProperty("retentionResolution5m")
     public String getRetentionResolution5m() {
         return retentionResolution5m;
     }
 
+    /**
+     * How long to retain samples of resolution 1 (5 minutes) in bucket. It applies to --retention.resolution-5m in compact.
+     */
     @JsonProperty("retentionResolution5m")
     public void setRetentionResolution5m(String retentionResolution5m) {
         this.retentionResolution5m = retentionResolution5m;
     }
 
+    /**
+     * How long to retain raw samples in a bucket. It applies to --retention.resolution-raw in compact.
+     */
     @JsonProperty("retentionResolutionRaw")
     public String getRetentionResolutionRaw() {
         return retentionResolutionRaw;
     }
 
+    /**
+     * How long to retain raw samples in a bucket. It applies to --retention.resolution-raw in compact.
+     */
     @JsonProperty("retentionResolutionRaw")
     public void setRetentionResolutionRaw(String retentionResolutionRaw) {
         this.retentionResolutionRaw = retentionResolutionRaw;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/RuleSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/RuleSpec.java
index c8c0c880de4..df858df23cf 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/RuleSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/RuleSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Thanos Rule Spec.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,53 +101,83 @@ public RuleSpec(List<Container> containers, String evalInterval, Integer replica
         this.serviceAccountAnnotations = serviceAccountAnnotations;
     }
 
+    /**
+     * WARNING: Use only with guidance from Red Hat Support. Using this feature incorrectly can lead to an unrecoverable state, data loss, or both, which is not covered by Red Hat Support.
+     */
     @JsonProperty("containers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Container> getContainers() {
         return containers;
     }
 
+    /**
+     * WARNING: Use only with guidance from Red Hat Support. Using this feature incorrectly can lead to an unrecoverable state, data loss, or both, which is not covered by Red Hat Support.
+     */
     @JsonProperty("containers")
     public void setContainers(List<Container> containers) {
         this.containers = containers;
     }
 
+    /**
+     * Evaluation interval
+     */
     @JsonProperty("evalInterval")
     public String getEvalInterval() {
         return evalInterval;
     }
 
+    /**
+     * Evaluation interval
+     */
     @JsonProperty("evalInterval")
     public void setEvalInterval(String evalInterval) {
         this.evalInterval = evalInterval;
     }
 
+    /**
+     * Replicas for this component.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Replicas for this component.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * Thanos Rule Spec.
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * Thanos Rule Spec.
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * Annotations is an unstructured key value map stored with a service account
+     */
     @JsonProperty("serviceAccountAnnotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getServiceAccountAnnotations() {
         return serviceAccountAnnotations;
     }
 
+    /**
+     * Annotations is an unstructured key value map stored with a service account
+     */
     @JsonProperty("serviceAccountAnnotations")
     public void setServiceAccountAnnotations(Map<String, String> serviceAccountAnnotations) {
         this.serviceAccountAnnotations = serviceAccountAnnotations;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/StorageConfig.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/StorageConfig.java
index 3fdc20b5962..67aec39c622 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/StorageConfig.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/StorageConfig.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StorageConfig is the spec of object storage.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -110,82 +113,130 @@ public StorageConfig(String alertmanagerStorageSize, String compactStorageSize,
         this.writeStorage = writeStorage;
     }
 
+    /**
+     * The amount of storage applied to alertmanager stateful sets,
+     */
     @JsonProperty("alertmanagerStorageSize")
     public String getAlertmanagerStorageSize() {
         return alertmanagerStorageSize;
     }
 
+    /**
+     * The amount of storage applied to alertmanager stateful sets,
+     */
     @JsonProperty("alertmanagerStorageSize")
     public void setAlertmanagerStorageSize(String alertmanagerStorageSize) {
         this.alertmanagerStorageSize = alertmanagerStorageSize;
     }
 
+    /**
+     * The amount of storage applied to thanos compact stateful sets,
+     */
     @JsonProperty("compactStorageSize")
     public String getCompactStorageSize() {
         return compactStorageSize;
     }
 
+    /**
+     * The amount of storage applied to thanos compact stateful sets,
+     */
     @JsonProperty("compactStorageSize")
     public void setCompactStorageSize(String compactStorageSize) {
         this.compactStorageSize = compactStorageSize;
     }
 
+    /**
+     * StorageConfig is the spec of object storage.
+     */
     @JsonProperty("metricObjectStorage")
     public PreConfiguredStorage getMetricObjectStorage() {
         return metricObjectStorage;
     }
 
+    /**
+     * StorageConfig is the spec of object storage.
+     */
     @JsonProperty("metricObjectStorage")
     public void setMetricObjectStorage(PreConfiguredStorage metricObjectStorage) {
         this.metricObjectStorage = metricObjectStorage;
     }
 
+    /**
+     * The amount of storage applied to thanos receive stateful sets,
+     */
     @JsonProperty("receiveStorageSize")
     public String getReceiveStorageSize() {
         return receiveStorageSize;
     }
 
+    /**
+     * The amount of storage applied to thanos receive stateful sets,
+     */
     @JsonProperty("receiveStorageSize")
     public void setReceiveStorageSize(String receiveStorageSize) {
         this.receiveStorageSize = receiveStorageSize;
     }
 
+    /**
+     * The amount of storage applied to thanos rule stateful sets,
+     */
     @JsonProperty("ruleStorageSize")
     public String getRuleStorageSize() {
         return ruleStorageSize;
     }
 
+    /**
+     * The amount of storage applied to thanos rule stateful sets,
+     */
     @JsonProperty("ruleStorageSize")
     public void setRuleStorageSize(String ruleStorageSize) {
         this.ruleStorageSize = ruleStorageSize;
     }
 
+    /**
+     * Specify the storageClass Stateful Sets. This storage class will also be used for Object Storage if MetricObjectStorage was configured for the system to create the storage.
+     */
     @JsonProperty("storageClass")
     public String getStorageClass() {
         return storageClass;
     }
 
+    /**
+     * Specify the storageClass Stateful Sets. This storage class will also be used for Object Storage if MetricObjectStorage was configured for the system to create the storage.
+     */
     @JsonProperty("storageClass")
     public void setStorageClass(String storageClass) {
         this.storageClass = storageClass;
     }
 
+    /**
+     * The amount of storage applied to thanos store stateful sets,
+     */
     @JsonProperty("storeStorageSize")
     public String getStoreStorageSize() {
         return storeStorageSize;
     }
 
+    /**
+     * The amount of storage applied to thanos store stateful sets,
+     */
     @JsonProperty("storeStorageSize")
     public void setStoreStorageSize(String storeStorageSize) {
         this.storeStorageSize = storeStorageSize;
     }
 
+    /**
+     * WriteStorage storage config secret list for metrics
+     */
     @JsonProperty("writeStorage")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PreConfiguredStorage> getWriteStorage() {
         return writeStorage;
     }
 
+    /**
+     * WriteStorage storage config secret list for metrics
+     */
     @JsonProperty("writeStorage")
     public void setWriteStorage(List<PreConfiguredStorage> writeStorage) {
         this.writeStorage = writeStorage;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/StoreSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/StoreSpec.java
index 41a73279cd6..b9d17533e59 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/StoreSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/StoreSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Thanos Store Spec.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,43 +97,67 @@ public StoreSpec(List<Container> containers, Integer replicas, ResourceRequireme
         this.serviceAccountAnnotations = serviceAccountAnnotations;
     }
 
+    /**
+     * WARNING: Use only with guidance from Red Hat Support. Using this feature incorrectly can lead to an unrecoverable state, data loss, or both, which is not covered by Red Hat Support.
+     */
     @JsonProperty("containers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Container> getContainers() {
         return containers;
     }
 
+    /**
+     * WARNING: Use only with guidance from Red Hat Support. Using this feature incorrectly can lead to an unrecoverable state, data loss, or both, which is not covered by Red Hat Support.
+     */
     @JsonProperty("containers")
     public void setContainers(List<Container> containers) {
         this.containers = containers;
     }
 
+    /**
+     * Replicas for this component.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Replicas for this component.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * Thanos Store Spec.
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * Thanos Store Spec.
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * Annotations is an unstructured key value map stored with a service account
+     */
     @JsonProperty("serviceAccountAnnotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getServiceAccountAnnotations() {
         return serviceAccountAnnotations;
     }
 
+    /**
+     * Annotations is an unstructured key value map stored with a service account
+     */
     @JsonProperty("serviceAccountAnnotations")
     public void setServiceAccountAnnotations(Map<String, String> serviceAccountAnnotations) {
         this.serviceAccountAnnotations = serviceAccountAnnotations;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/UserWorkloadCapabilitiesSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/UserWorkloadCapabilitiesSpec.java
index cb512efbaea..0954a2eb3a0 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/UserWorkloadCapabilitiesSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/UserWorkloadCapabilitiesSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UserWorkloadCapabilitiesSpec defines the spec for user workload observability capabilities managed by the addon.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public UserWorkloadCapabilitiesSpec(UserWorkloadLogsSpec logs, UserWorkloadTrace
         this.traces = traces;
     }
 
+    /**
+     * UserWorkloadCapabilitiesSpec defines the spec for user workload observability capabilities managed by the addon.
+     */
     @JsonProperty("logs")
     public UserWorkloadLogsSpec getLogs() {
         return logs;
     }
 
+    /**
+     * UserWorkloadCapabilitiesSpec defines the spec for user workload observability capabilities managed by the addon.
+     */
     @JsonProperty("logs")
     public void setLogs(UserWorkloadLogsSpec logs) {
         this.logs = logs;
     }
 
+    /**
+     * UserWorkloadCapabilitiesSpec defines the spec for user workload observability capabilities managed by the addon.
+     */
     @JsonProperty("traces")
     public UserWorkloadTracesSpec getTraces() {
         return traces;
     }
 
+    /**
+     * UserWorkloadCapabilitiesSpec defines the spec for user workload observability capabilities managed by the addon.
+     */
     @JsonProperty("traces")
     public void setTraces(UserWorkloadTracesSpec traces) {
         this.traces = traces;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/UserWorkloadLogsCollectionSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/UserWorkloadLogsCollectionSpec.java
index 94d85b31c91..4c54afde2be 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/UserWorkloadLogsCollectionSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/UserWorkloadLogsCollectionSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UserWorkloadLogsCollectionSpec defines the spec for the addon to collect and forward logs from user workloads hosted on fleet managed clusters.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public UserWorkloadLogsCollectionSpec(ClusterLogForwarderSpec clusterLogForwarde
         this.clusterLogForwarder = clusterLogForwarder;
     }
 
+    /**
+     * UserWorkloadLogsCollectionSpec defines the spec for the addon to collect and forward logs from user workloads hosted on fleet managed clusters.
+     */
     @JsonProperty("clusterLogForwarder")
     public ClusterLogForwarderSpec getClusterLogForwarder() {
         return clusterLogForwarder;
     }
 
+    /**
+     * UserWorkloadLogsCollectionSpec defines the spec for the addon to collect and forward logs from user workloads hosted on fleet managed clusters.
+     */
     @JsonProperty("clusterLogForwarder")
     public void setClusterLogForwarder(ClusterLogForwarderSpec clusterLogForwarder) {
         this.clusterLogForwarder = clusterLogForwarder;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/UserWorkloadLogsSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/UserWorkloadLogsSpec.java
index 3aee6e19887..3a68783bab3 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/UserWorkloadLogsSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/UserWorkloadLogsSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UserWorkloadLogsSpec defines the spec for the addon to collect,forward and store logs from user workloads hosted on fleet managed clusters.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public UserWorkloadLogsSpec(UserWorkloadLogsCollectionSpec collection) {
         this.collection = collection;
     }
 
+    /**
+     * UserWorkloadLogsSpec defines the spec for the addon to collect,forward and store logs from user workloads hosted on fleet managed clusters.
+     */
     @JsonProperty("collection")
     public UserWorkloadLogsCollectionSpec getCollection() {
         return collection;
     }
 
+    /**
+     * UserWorkloadLogsSpec defines the spec for the addon to collect,forward and store logs from user workloads hosted on fleet managed clusters.
+     */
     @JsonProperty("collection")
     public void setCollection(UserWorkloadLogsCollectionSpec collection) {
         this.collection = collection;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/UserWorkloadTracesSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/UserWorkloadTracesSpec.java
index b4034e53e85..5512c1ed89a 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/UserWorkloadTracesSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/observability/v1beta2/UserWorkloadTracesSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UserWorkloadTracesSpec defines the spec for the addon to collect, forward and store traces from user workloads hosted on fleet managed clusters.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public UserWorkloadTracesSpec(OpenTelemetryCollectionSpec collection) {
         this.collection = collection;
     }
 
+    /**
+     * UserWorkloadTracesSpec defines the spec for the addon to collect, forward and store traces from user workloads hosted on fleet managed clusters.
+     */
     @JsonProperty("collection")
     public OpenTelemetryCollectionSpec getCollection() {
         return collection;
     }
 
+    /**
+     * UserWorkloadTracesSpec defines the spec for the addon to collect, forward and store traces from user workloads hosted on fleet managed clusters.
+     */
     @JsonProperty("collection")
     public void setCollection(OpenTelemetryCollectionSpec collection) {
         this.collection = collection;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/AddOnManagerConfiguration.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/AddOnManagerConfiguration.java
index 02585be57d4..78a58eb597f 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/AddOnManagerConfiguration.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/AddOnManagerConfiguration.java
@@ -81,12 +81,18 @@ public AddOnManagerConfiguration(List<FeatureGate> featureGates) {
         this.featureGates = featureGates;
     }
 
+    /**
+     * FeatureGates represents the list of feature gates for addon manager If it is set empty, default feature gates will be used. If it is set, featuregate/Foo is an example of one item in FeatureGates:<br><p>   1. If featuregate/Foo does not exist, registration-operator will discard it<br><p>   2. If featuregate/Foo exists and is false by default. It is now possible to set featuregate/Foo=[false|true]<br><p>   3. If featuregate/Foo exists and is true by default. If a cluster-admin upgrading from 1 to 2 wants to continue having featuregate/Foo=false,<br><p>  	he can set featuregate/Foo=false before upgrading. Let's say the cluster-admin wants featuregate/Foo=false.
+     */
     @JsonProperty("featureGates")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<FeatureGate> getFeatureGates() {
         return featureGates;
     }
 
+    /**
+     * FeatureGates represents the list of feature gates for addon manager If it is set empty, default feature gates will be used. If it is set, featuregate/Foo is an example of one item in FeatureGates:<br><p>   1. If featuregate/Foo does not exist, registration-operator will discard it<br><p>   2. If featuregate/Foo exists and is false by default. It is now possible to set featuregate/Foo=[false|true]<br><p>   3. If featuregate/Foo exists and is true by default. If a cluster-admin upgrading from 1 to 2 wants to continue having featuregate/Foo=false,<br><p>  	he can set featuregate/Foo=false before upgrading. Let's say the cluster-admin wants featuregate/Foo=false.
+     */
     @JsonProperty("featureGates")
     public void setFeatureGates(List<FeatureGate> featureGates) {
         this.featureGates = featureGates;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/AwsIrsa.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/AwsIrsa.java
index 91aad739dfa..1873589c5d9 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/AwsIrsa.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/AwsIrsa.java
@@ -82,21 +82,33 @@ public AwsIrsa(String hubClusterArn, String managedClusterArn) {
         this.managedClusterArn = managedClusterArn;
     }
 
+    /**
+     * The arn of the hub cluster (ie: an EKS cluster). This will be required to pass information to hub, which hub will use to create IAM identities for this klusterlet. Example - arn:eks:us-west-2:12345678910:cluster/hub-cluster1.
+     */
     @JsonProperty("hubClusterArn")
     public String getHubClusterArn() {
         return hubClusterArn;
     }
 
+    /**
+     * The arn of the hub cluster (ie: an EKS cluster). This will be required to pass information to hub, which hub will use to create IAM identities for this klusterlet. Example - arn:eks:us-west-2:12345678910:cluster/hub-cluster1.
+     */
     @JsonProperty("hubClusterArn")
     public void setHubClusterArn(String hubClusterArn) {
         this.hubClusterArn = hubClusterArn;
     }
 
+    /**
+     * The arn of the managed cluster (ie: an EKS cluster). This will be required to generate the md5hash which will be used as a suffix to create IAM role on hub as well as used by kluslerlet-agent, to assume role suffixed with the md5hash, on startup. Example - arn:eks:us-west-2:12345678910:cluster/managed-cluster1.
+     */
     @JsonProperty("managedClusterArn")
     public String getManagedClusterArn() {
         return managedClusterArn;
     }
 
+    /**
+     * The arn of the managed cluster (ie: an EKS cluster). This will be required to generate the md5hash which will be used as a suffix to create IAM role on hub as well as used by kluslerlet-agent, to assume role suffixed with the md5hash, on startup. Example - arn:eks:us-west-2:12345678910:cluster/managed-cluster1.
+     */
     @JsonProperty("managedClusterArn")
     public void setManagedClusterArn(String managedClusterArn) {
         this.managedClusterArn = managedClusterArn;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/BackupConfig.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/BackupConfig.java
index de52970152b..acc928d32a1 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/BackupConfig.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/BackupConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BackupConfig contains settings for the Velero backup integration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public BackupConfig(Integer minBackupPeriodSeconds, VeleroBackupConfig velero) {
         this.velero = velero;
     }
 
+    /**
+     * (Deprecated) MinBackupPeriodSeconds specifies that a minimum of MinBackupPeriodSeconds will occur in between each backup. This is used to rate limit backups. This potentially batches together multiple changes into 1 backup. No backups will be lost as changes that happen during this interval are queued up and will result in a backup happening once the interval has been completed.
+     */
     @JsonProperty("minBackupPeriodSeconds")
     public Integer getMinBackupPeriodSeconds() {
         return minBackupPeriodSeconds;
     }
 
+    /**
+     * (Deprecated) MinBackupPeriodSeconds specifies that a minimum of MinBackupPeriodSeconds will occur in between each backup. This is used to rate limit backups. This potentially batches together multiple changes into 1 backup. No backups will be lost as changes that happen during this interval are queued up and will result in a backup happening once the interval has been completed.
+     */
     @JsonProperty("minBackupPeriodSeconds")
     public void setMinBackupPeriodSeconds(Integer minBackupPeriodSeconds) {
         this.minBackupPeriodSeconds = minBackupPeriodSeconds;
     }
 
+    /**
+     * BackupConfig contains settings for the Velero backup integration.
+     */
     @JsonProperty("velero")
     public VeleroBackupConfig getVelero() {
         return velero;
     }
 
+    /**
+     * BackupConfig contains settings for the Velero backup integration.
+     */
     @JsonProperty("velero")
     public void setVelero(VeleroBackupConfig velero) {
         this.velero = velero;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/BootstrapKubeConfigs.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/BootstrapKubeConfigs.java
index bedf3cfade4..5f938071c4d 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/BootstrapKubeConfigs.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/BootstrapKubeConfigs.java
@@ -92,11 +92,17 @@ public void setLocalSecretsConfig(LocalSecretsConfig localSecretsConfig) {
         this.localSecretsConfig = localSecretsConfig;
     }
 
+    /**
+     * Type specifies the type of priority bootstrap kubeconfigs. By default, it is set to None, representing no priority bootstrap kubeconfigs are set.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type specifies the type of priority bootstrap kubeconfigs. By default, it is set to None, representing no priority bootstrap kubeconfigs are set.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ClusterManager.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ClusterManager.java
index 7c8f815182c..7fe1f6d72d6 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ClusterManager.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ClusterManager.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterManager configures the controllers on the hub that govern registration and work distribution for attached Klusterlets. In Default mode, ClusterManager will only be deployed in open-cluster-management-hub namespace. In Hosted mode, ClusterManager will be deployed in the namespace with the same name as cluster manager.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ClusterManager implements Editable<ClusterManagerBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.open-cluster-management.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterManager";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public ClusterManager(String apiVersion, String kind, ObjectMeta metadata, Clust
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterManager configures the controllers on the hub that govern registration and work distribution for attached Klusterlets. In Default mode, ClusterManager will only be deployed in open-cluster-management-hub namespace. In Hosted mode, ClusterManager will be deployed in the namespace with the same name as cluster manager.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterManager configures the controllers on the hub that govern registration and work distribution for attached Klusterlets. In Default mode, ClusterManager will only be deployed in open-cluster-management-hub namespace. In Hosted mode, ClusterManager will be deployed in the namespace with the same name as cluster manager.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ClusterManager configures the controllers on the hub that govern registration and work distribution for attached Klusterlets. In Default mode, ClusterManager will only be deployed in open-cluster-management-hub namespace. In Hosted mode, ClusterManager will be deployed in the namespace with the same name as cluster manager.
+     */
     @JsonProperty("spec")
     public ClusterManagerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ClusterManager configures the controllers on the hub that govern registration and work distribution for attached Klusterlets. In Default mode, ClusterManager will only be deployed in open-cluster-management-hub namespace. In Hosted mode, ClusterManager will be deployed in the namespace with the same name as cluster manager.
+     */
     @JsonProperty("spec")
     public void setSpec(ClusterManagerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ClusterManager configures the controllers on the hub that govern registration and work distribution for attached Klusterlets. In Default mode, ClusterManager will only be deployed in open-cluster-management-hub namespace. In Hosted mode, ClusterManager will be deployed in the namespace with the same name as cluster manager.
+     */
     @JsonProperty("status")
     public ClusterManagerStatus getStatus() {
         return status;
     }
 
+    /**
+     * ClusterManager configures the controllers on the hub that govern registration and work distribution for attached Klusterlets. In Default mode, ClusterManager will only be deployed in open-cluster-management-hub namespace. In Hosted mode, ClusterManager will be deployed in the namespace with the same name as cluster manager.
+     */
     @JsonProperty("status")
     public void setStatus(ClusterManagerStatus status) {
         this.status = status;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ClusterManagerDeployOption.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ClusterManagerDeployOption.java
index 99ce1c7b5ba..26490011de8 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ClusterManagerDeployOption.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ClusterManagerDeployOption.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterManagerDeployOption describes the deployment options for cluster-manager
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ClusterManagerDeployOption(HostedClusterManagerConfiguration hosted, Stri
         this.mode = mode;
     }
 
+    /**
+     * ClusterManagerDeployOption describes the deployment options for cluster-manager
+     */
     @JsonProperty("hosted")
     public HostedClusterManagerConfiguration getHosted() {
         return hosted;
     }
 
+    /**
+     * ClusterManagerDeployOption describes the deployment options for cluster-manager
+     */
     @JsonProperty("hosted")
     public void setHosted(HostedClusterManagerConfiguration hosted) {
         this.hosted = hosted;
     }
 
+    /**
+     * Mode can be Default or Hosted. In Default mode, the Hub is installed as a whole and all parts of Hub are deployed in the same cluster. In Hosted mode, only crd and configurations are installed on one cluster(defined as hub-cluster). Controllers run in another cluster (defined as management-cluster) and connect to the hub with the kubeconfig in secret of "external-hub-kubeconfig"(a kubeconfig of hub-cluster with cluster-admin permission). Note: Do not modify the Mode field once it's applied.
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Mode can be Default or Hosted. In Default mode, the Hub is installed as a whole and all parts of Hub are deployed in the same cluster. In Hosted mode, only crd and configurations are installed on one cluster(defined as hub-cluster). Controllers run in another cluster (defined as management-cluster) and connect to the hub with the kubeconfig in secret of "external-hub-kubeconfig"(a kubeconfig of hub-cluster with cluster-admin permission). Note: Do not modify the Mode field once it's applied.
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ClusterManagerList.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ClusterManagerList.java
index 6b9b134fcf4..6121e533bd8 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ClusterManagerList.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ClusterManagerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterManagerList is a collection of deployment configurations for registration and work distribution controllers.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ClusterManagerList implements Editable<ClusterManagerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openclustermanagement.api.model.operator.v1.ClusterManager>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.open-cluster-management.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openclustermanagement.api.model.operator.v1.ClusterManager> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterManagerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterManagerList(String apiVersion, List<io.fabric8.openclustermanageme
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of deployment configurations for registration and work distribution controllers.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openclustermanagement.api.model.operator.v1.ClusterManager> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of deployment configurations for registration and work distribution controllers.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openclustermanagement.api.model.operator.v1.ClusterManager> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterManagerList is a collection of deployment configurations for registration and work distribution controllers.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterManagerList is a collection of deployment configurations for registration and work distribution controllers.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ClusterManagerSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ClusterManagerSpec.java
index d97bde93da5..09b48f2827f 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ClusterManagerSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ClusterManagerSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterManagerSpec represents a desired deployment configuration of controllers that govern registration and work distribution for attached Klusterlets.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -114,101 +117,161 @@ public ClusterManagerSpec(AddOnManagerConfiguration addOnManagerConfiguration, S
         this.workImagePullSpec = workImagePullSpec;
     }
 
+    /**
+     * ClusterManagerSpec represents a desired deployment configuration of controllers that govern registration and work distribution for attached Klusterlets.
+     */
     @JsonProperty("addOnManagerConfiguration")
     public AddOnManagerConfiguration getAddOnManagerConfiguration() {
         return addOnManagerConfiguration;
     }
 
+    /**
+     * ClusterManagerSpec represents a desired deployment configuration of controllers that govern registration and work distribution for attached Klusterlets.
+     */
     @JsonProperty("addOnManagerConfiguration")
     public void setAddOnManagerConfiguration(AddOnManagerConfiguration addOnManagerConfiguration) {
         this.addOnManagerConfiguration = addOnManagerConfiguration;
     }
 
+    /**
+     * AddOnManagerImagePullSpec represents the desired image configuration of addon manager controller/webhook installed on hub.
+     */
     @JsonProperty("addOnManagerImagePullSpec")
     public String getAddOnManagerImagePullSpec() {
         return addOnManagerImagePullSpec;
     }
 
+    /**
+     * AddOnManagerImagePullSpec represents the desired image configuration of addon manager controller/webhook installed on hub.
+     */
     @JsonProperty("addOnManagerImagePullSpec")
     public void setAddOnManagerImagePullSpec(String addOnManagerImagePullSpec) {
         this.addOnManagerImagePullSpec = addOnManagerImagePullSpec;
     }
 
+    /**
+     * ClusterManagerSpec represents a desired deployment configuration of controllers that govern registration and work distribution for attached Klusterlets.
+     */
     @JsonProperty("deployOption")
     public ClusterManagerDeployOption getDeployOption() {
         return deployOption;
     }
 
+    /**
+     * ClusterManagerSpec represents a desired deployment configuration of controllers that govern registration and work distribution for attached Klusterlets.
+     */
     @JsonProperty("deployOption")
     public void setDeployOption(ClusterManagerDeployOption deployOption) {
         this.deployOption = deployOption;
     }
 
+    /**
+     * ClusterManagerSpec represents a desired deployment configuration of controllers that govern registration and work distribution for attached Klusterlets.
+     */
     @JsonProperty("nodePlacement")
     public NodePlacement getNodePlacement() {
         return nodePlacement;
     }
 
+    /**
+     * ClusterManagerSpec represents a desired deployment configuration of controllers that govern registration and work distribution for attached Klusterlets.
+     */
     @JsonProperty("nodePlacement")
     public void setNodePlacement(NodePlacement nodePlacement) {
         this.nodePlacement = nodePlacement;
     }
 
+    /**
+     * PlacementImagePullSpec represents the desired image configuration of placement controller/webhook installed on hub.
+     */
     @JsonProperty("placementImagePullSpec")
     public String getPlacementImagePullSpec() {
         return placementImagePullSpec;
     }
 
+    /**
+     * PlacementImagePullSpec represents the desired image configuration of placement controller/webhook installed on hub.
+     */
     @JsonProperty("placementImagePullSpec")
     public void setPlacementImagePullSpec(String placementImagePullSpec) {
         this.placementImagePullSpec = placementImagePullSpec;
     }
 
+    /**
+     * ClusterManagerSpec represents a desired deployment configuration of controllers that govern registration and work distribution for attached Klusterlets.
+     */
     @JsonProperty("registrationConfiguration")
     public RegistrationHubConfiguration getRegistrationConfiguration() {
         return registrationConfiguration;
     }
 
+    /**
+     * ClusterManagerSpec represents a desired deployment configuration of controllers that govern registration and work distribution for attached Klusterlets.
+     */
     @JsonProperty("registrationConfiguration")
     public void setRegistrationConfiguration(RegistrationHubConfiguration registrationConfiguration) {
         this.registrationConfiguration = registrationConfiguration;
     }
 
+    /**
+     * RegistrationImagePullSpec represents the desired image of registration controller/webhook installed on hub.
+     */
     @JsonProperty("registrationImagePullSpec")
     public String getRegistrationImagePullSpec() {
         return registrationImagePullSpec;
     }
 
+    /**
+     * RegistrationImagePullSpec represents the desired image of registration controller/webhook installed on hub.
+     */
     @JsonProperty("registrationImagePullSpec")
     public void setRegistrationImagePullSpec(String registrationImagePullSpec) {
         this.registrationImagePullSpec = registrationImagePullSpec;
     }
 
+    /**
+     * ClusterManagerSpec represents a desired deployment configuration of controllers that govern registration and work distribution for attached Klusterlets.
+     */
     @JsonProperty("resourceRequirement")
     public ResourceRequirement getResourceRequirement() {
         return resourceRequirement;
     }
 
+    /**
+     * ClusterManagerSpec represents a desired deployment configuration of controllers that govern registration and work distribution for attached Klusterlets.
+     */
     @JsonProperty("resourceRequirement")
     public void setResourceRequirement(ResourceRequirement resourceRequirement) {
         this.resourceRequirement = resourceRequirement;
     }
 
+    /**
+     * ClusterManagerSpec represents a desired deployment configuration of controllers that govern registration and work distribution for attached Klusterlets.
+     */
     @JsonProperty("workConfiguration")
     public WorkConfiguration getWorkConfiguration() {
         return workConfiguration;
     }
 
+    /**
+     * ClusterManagerSpec represents a desired deployment configuration of controllers that govern registration and work distribution for attached Klusterlets.
+     */
     @JsonProperty("workConfiguration")
     public void setWorkConfiguration(WorkConfiguration workConfiguration) {
         this.workConfiguration = workConfiguration;
     }
 
+    /**
+     * WorkImagePullSpec represents the desired image configuration of work controller/webhook installed on hub.
+     */
     @JsonProperty("workImagePullSpec")
     public String getWorkImagePullSpec() {
         return workImagePullSpec;
     }
 
+    /**
+     * WorkImagePullSpec represents the desired image configuration of work controller/webhook installed on hub.
+     */
     @JsonProperty("workImagePullSpec")
     public void setWorkImagePullSpec(String workImagePullSpec) {
         this.workImagePullSpec = workImagePullSpec;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ClusterManagerStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ClusterManagerStatus.java
index 64bf9532947..e105a6ef553 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ClusterManagerStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ClusterManagerStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterManagerStatus represents the current status of the registration and work distribution controllers running on the hub.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -96,44 +99,68 @@ public ClusterManagerStatus(List<Condition> conditions, List<GenerationStatus> g
         this.relatedResources = relatedResources;
     }
 
+    /**
+     * Conditions contain the different condition statuses for this ClusterManager. Valid condition types are: Applied: Components in hub are applied. Available: Components in hub are available and ready to serve. Progressing: Components in hub are in a transitioning state. Degraded: Components in hub do not match the desired configuration and only provide degraded service.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions contain the different condition statuses for this ClusterManager. Valid condition types are: Applied: Components in hub are applied. Available: Components in hub are available and ready to serve. Progressing: Components in hub are in a transitioning state. Degraded: Components in hub do not match the desired configuration and only provide degraded service.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenerationStatus> getGenerations() {
         return generations;
     }
 
+    /**
+     * Generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     public void setGenerations(List<GenerationStatus> generations) {
         this.generations = generations;
     }
 
+    /**
+     * ObservedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * RelatedResources are used to track the resources that are related to this ClusterManager.
+     */
     @JsonProperty("relatedResources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RelatedResourceMeta> getRelatedResources() {
         return relatedResources;
     }
 
+    /**
+     * RelatedResources are used to track the resources that are related to this ClusterManager.
+     */
     @JsonProperty("relatedResources")
     public void setRelatedResources(List<RelatedResourceMeta> relatedResources) {
         this.relatedResources = relatedResources;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ComponentConfig.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ComponentConfig.java
index cbcc28e2ea2..3b698ccb3d9 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ComponentConfig.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ComponentConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ComponentConfig provides optional configuration items for individual components
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ComponentConfig(Boolean enabled, String name) {
         this.name = name;
     }
 
+    /**
+     * ComponentConfig provides optional configuration items for individual components
+     */
     @JsonProperty("enabled")
     public Boolean getEnabled() {
         return enabled;
     }
 
+    /**
+     * ComponentConfig provides optional configuration items for individual components
+     */
     @JsonProperty("enabled")
     public void setEnabled(Boolean enabled) {
         this.enabled = enabled;
     }
 
+    /**
+     * ComponentConfig provides optional configuration items for individual components
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * ComponentConfig provides optional configuration items for individual components
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ExternalDNSAWSConfig.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ExternalDNSAWSConfig.java
index f8d173e87c7..86f369a6bbd 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ExternalDNSAWSConfig.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ExternalDNSAWSConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ExternalDNSAWSConfig contains AWS-specific settings for external DNS
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ExternalDNSAWSConfig(LocalObjectReference credentials) {
         this.credentials = credentials;
     }
 
+    /**
+     * ExternalDNSAWSConfig contains AWS-specific settings for external DNS
+     */
     @JsonProperty("credentials")
     public LocalObjectReference getCredentials() {
         return credentials;
     }
 
+    /**
+     * ExternalDNSAWSConfig contains AWS-specific settings for external DNS
+     */
     @JsonProperty("credentials")
     public void setCredentials(LocalObjectReference credentials) {
         this.credentials = credentials;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ExternalDNSConfig.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ExternalDNSConfig.java
index 922d17c607d..f76b8f57a4f 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ExternalDNSConfig.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ExternalDNSConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ExternalDNSConfig contains settings for running external-dns in a Hive environment.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ExternalDNSConfig(ExternalDNSAWSConfig aws, ExternalDNSGCPConfig gcp) {
         this.gcp = gcp;
     }
 
+    /**
+     * ExternalDNSConfig contains settings for running external-dns in a Hive environment.
+     */
     @JsonProperty("aws")
     public ExternalDNSAWSConfig getAws() {
         return aws;
     }
 
+    /**
+     * ExternalDNSConfig contains settings for running external-dns in a Hive environment.
+     */
     @JsonProperty("aws")
     public void setAws(ExternalDNSAWSConfig aws) {
         this.aws = aws;
     }
 
+    /**
+     * ExternalDNSConfig contains settings for running external-dns in a Hive environment.
+     */
     @JsonProperty("gcp")
     public ExternalDNSGCPConfig getGcp() {
         return gcp;
     }
 
+    /**
+     * ExternalDNSConfig contains settings for running external-dns in a Hive environment.
+     */
     @JsonProperty("gcp")
     public void setGcp(ExternalDNSGCPConfig gcp) {
         this.gcp = gcp;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ExternalDNSGCPConfig.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ExternalDNSGCPConfig.java
index 8bdf9eedc61..26f29736a09 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ExternalDNSGCPConfig.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ExternalDNSGCPConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ExternalDNSGCPConfig contains GCP-specific settings for external DNS
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ExternalDNSGCPConfig(LocalObjectReference credentials) {
         this.credentials = credentials;
     }
 
+    /**
+     * ExternalDNSGCPConfig contains GCP-specific settings for external DNS
+     */
     @JsonProperty("credentials")
     public LocalObjectReference getCredentials() {
         return credentials;
     }
 
+    /**
+     * ExternalDNSGCPConfig contains GCP-specific settings for external DNS
+     */
     @JsonProperty("credentials")
     public void setCredentials(LocalObjectReference credentials) {
         this.credentials = credentials;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/FailedProvisionConfig.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/FailedProvisionConfig.java
index 90c7eb35a9b..5234cfbb994 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/FailedProvisionConfig.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/FailedProvisionConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FailedProvisionConfig contains settings to control behavior undertaken by Hive when an installation attempt fails.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public FailedProvisionConfig(Boolean skipGatherLogs) {
         this.skipGatherLogs = skipGatherLogs;
     }
 
+    /**
+     * (Deprecated) SkipGatherLogs disables functionality that attempts to gather full logs from the cluster if an installation fails for any reason. The logs will be stored in a persistent volume for up to 7 days.
+     */
     @JsonProperty("skipGatherLogs")
     public Boolean getSkipGatherLogs() {
         return skipGatherLogs;
     }
 
+    /**
+     * (Deprecated) SkipGatherLogs disables functionality that attempts to gather full logs from the cluster if an installation fails for any reason. The logs will be stored in a persistent volume for up to 7 days.
+     */
     @JsonProperty("skipGatherLogs")
     public void setSkipGatherLogs(Boolean skipGatherLogs) {
         this.skipGatherLogs = skipGatherLogs;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/FeatureGate.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/FeatureGate.java
index 281483a6afd..6b4d1eb8749 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/FeatureGate.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/FeatureGate.java
@@ -82,21 +82,33 @@ public FeatureGate(String feature, String mode) {
         this.mode = mode;
     }
 
+    /**
+     * Feature is the key of feature gate. e.g. featuregate/Foo.
+     */
     @JsonProperty("feature")
     public String getFeature() {
         return feature;
     }
 
+    /**
+     * Feature is the key of feature gate. e.g. featuregate/Foo.
+     */
     @JsonProperty("feature")
     public void setFeature(String feature) {
         this.feature = feature;
     }
 
+    /**
+     * Mode is either Enable, Disable, "" where "" is Disable by default. In Enable mode, a valid feature gate `featuregate/Foo` will be set to "--featuregate/Foo=true". In Disable mode, a valid feature gate `featuregate/Foo` will be set to "--featuregate/Foo=false".
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Mode is either Enable, Disable, "" where "" is Disable by default. In Enable mode, a valid feature gate `featuregate/Foo` will be set to "--featuregate/Foo=true". In Disable mode, a valid feature gate `featuregate/Foo` will be set to "--featuregate/Foo=false".
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/GenerationStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/GenerationStatus.java
index 6453b7d472c..0f2de85885c 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/GenerationStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/GenerationStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GenerationStatus keeps track of the generation for a given resource so that decisions about forced updates can be made. The definition matches the GenerationStatus defined in github.com/openshift/api/v1
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public GenerationStatus(String group, Long lastGeneration, String name, String n
         this.version = version;
     }
 
+    /**
+     * group is the group of the resource that you're tracking
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * group is the group of the resource that you're tracking
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * lastGeneration is the last generation of the resource that controller applies
+     */
     @JsonProperty("lastGeneration")
     public Long getLastGeneration() {
         return lastGeneration;
     }
 
+    /**
+     * lastGeneration is the last generation of the resource that controller applies
+     */
     @JsonProperty("lastGeneration")
     public void setLastGeneration(Long lastGeneration) {
         this.lastGeneration = lastGeneration;
     }
 
+    /**
+     * name is the name of the resource that you're tracking
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the resource that you're tracking
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * namespace is where the resource that you're tracking is
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * namespace is where the resource that you're tracking is
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * resource is the resource type of the resource that you're tracking
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * resource is the resource type of the resource that you're tracking
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
     }
 
+    /**
+     * version is the version of the resource that you're tracking
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the version of the resource that you're tracking
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/HiveConfigSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/HiveConfigSpec.java
index b47fd429cf3..e7bc3829ad4 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/HiveConfigSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/HiveConfigSpec.java
@@ -101,12 +101,18 @@ public HiveConfigSpec(List<LocalObjectReference> additionalCertificateAuthoritie
         this.maintenanceMode = maintenanceMode;
     }
 
+    /**
+     * (Deprecated) AdditionalCertificateAuthorities is a list of references to secrets in the 'hive' namespace that contain an additional Certificate Authority to use when communicating with target clusters. These certificate authorities will be used in addition to any self-signed CA generated by each cluster on installation.
+     */
     @JsonProperty("additionalCertificateAuthorities")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LocalObjectReference> getAdditionalCertificateAuthorities() {
         return additionalCertificateAuthorities;
     }
 
+    /**
+     * (Deprecated) AdditionalCertificateAuthorities is a list of references to secrets in the 'hive' namespace that contain an additional Certificate Authority to use when communicating with target clusters. These certificate authorities will be used in addition to any self-signed CA generated by each cluster on installation.
+     */
     @JsonProperty("additionalCertificateAuthorities")
     public void setAdditionalCertificateAuthorities(List<LocalObjectReference> additionalCertificateAuthorities) {
         this.additionalCertificateAuthorities = additionalCertificateAuthorities;
@@ -152,11 +158,17 @@ public void setGlobalPullSecret(LocalObjectReference globalPullSecret) {
         this.globalPullSecret = globalPullSecret;
     }
 
+    /**
+     * (Deprecated) MaintenanceMode can be set to true to disable the hive controllers in situations where we need to ensure nothing is running that will add or act upon finalizers on Hive types. This should rarely be needed. Sets replicas to 0 for the hive-controllers deployment to accomplish this.
+     */
     @JsonProperty("maintenanceMode")
     public Boolean getMaintenanceMode() {
         return maintenanceMode;
     }
 
+    /**
+     * (Deprecated) MaintenanceMode can be set to true to disable the hive controllers in situations where we need to ensure nothing is running that will add or act upon finalizers on Hive types. This should rarely be needed. Sets replicas to 0 for the hive-controllers deployment to accomplish this.
+     */
     @JsonProperty("maintenanceMode")
     public void setMaintenanceMode(Boolean maintenanceMode) {
         this.maintenanceMode = maintenanceMode;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/HiveConfigStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/HiveConfigStatus.java
index 4184226d9aa..2c93e40637a 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/HiveConfigStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/HiveConfigStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HiveConfigStatus defines the observed state of Hive
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public HiveConfigStatus(String aggregatorClientCAHash) {
         this.aggregatorClientCAHash = aggregatorClientCAHash;
     }
 
+    /**
+     * (Deprecated) AggregatorClientCAHash keeps an md5 hash of the aggregator client CA configmap data from the openshift-config-managed namespace. When the configmap changes, admission is redeployed.
+     */
     @JsonProperty("aggregatorClientCAHash")
     public String getAggregatorClientCAHash() {
         return aggregatorClientCAHash;
     }
 
+    /**
+     * (Deprecated) AggregatorClientCAHash keeps an md5 hash of the aggregator client CA configmap data from the openshift-config-managed namespace. When the configmap changes, admission is redeployed.
+     */
     @JsonProperty("aggregatorClientCAHash")
     public void setAggregatorClientCAHash(String aggregatorClientCAHash) {
         this.aggregatorClientCAHash = aggregatorClientCAHash;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/HostedClusterManagerConfiguration.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/HostedClusterManagerConfiguration.java
index c6ce44c0a35..45436aa94cd 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/HostedClusterManagerConfiguration.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/HostedClusterManagerConfiguration.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HostedClusterManagerConfiguration represents customized configurations we need to set for clustermanager in the Hosted mode.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public HostedClusterManagerConfiguration(WebhookConfiguration registrationWebhoo
         this.workWebhookConfiguration = workWebhookConfiguration;
     }
 
+    /**
+     * HostedClusterManagerConfiguration represents customized configurations we need to set for clustermanager in the Hosted mode.
+     */
     @JsonProperty("registrationWebhookConfiguration")
     public WebhookConfiguration getRegistrationWebhookConfiguration() {
         return registrationWebhookConfiguration;
     }
 
+    /**
+     * HostedClusterManagerConfiguration represents customized configurations we need to set for clustermanager in the Hosted mode.
+     */
     @JsonProperty("registrationWebhookConfiguration")
     public void setRegistrationWebhookConfiguration(WebhookConfiguration registrationWebhookConfiguration) {
         this.registrationWebhookConfiguration = registrationWebhookConfiguration;
     }
 
+    /**
+     * HostedClusterManagerConfiguration represents customized configurations we need to set for clustermanager in the Hosted mode.
+     */
     @JsonProperty("workWebhookConfiguration")
     public WebhookConfiguration getWorkWebhookConfiguration() {
         return workWebhookConfiguration;
     }
 
+    /**
+     * HostedClusterManagerConfiguration represents customized configurations we need to set for clustermanager in the Hosted mode.
+     */
     @JsonProperty("workWebhookConfiguration")
     public void setWorkWebhookConfiguration(WebhookConfiguration workWebhookConfiguration) {
         this.workWebhookConfiguration = workWebhookConfiguration;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/HubApiServerHostAlias.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/HubApiServerHostAlias.java
index f36a126fb68..85b46a9708c 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/HubApiServerHostAlias.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/HubApiServerHostAlias.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HubApiServerHostAlias holds the mapping between IP and hostname that will be injected as an entry in the pod's hosts file.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public HubApiServerHostAlias(String hostname, String ip) {
         this.ip = ip;
     }
 
+    /**
+     * Hostname for the above IP address.
+     */
     @JsonProperty("hostname")
     public String getHostname() {
         return hostname;
     }
 
+    /**
+     * Hostname for the above IP address.
+     */
     @JsonProperty("hostname")
     public void setHostname(String hostname) {
         this.hostname = hostname;
     }
 
+    /**
+     * IP address of the host file entry.
+     */
     @JsonProperty("ip")
     public String getIp() {
         return ip;
     }
 
+    /**
+     * IP address of the host file entry.
+     */
     @JsonProperty("ip")
     public void setIp(String ip) {
         this.ip = ip;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/HubCondition.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/HubCondition.java
index 61f4d9115df..4c523fd3009 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/HubCondition.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/HubCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StatusCondition contains condition information.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public HubCondition(String lastTransitionTime, String lastUpdateTime, String mes
         this.type = type;
     }
 
+    /**
+     * StatusCondition contains condition information.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * StatusCondition contains condition information.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * StatusCondition contains condition information.
+     */
     @JsonProperty("lastUpdateTime")
     public String getLastUpdateTime() {
         return lastUpdateTime;
     }
 
+    /**
+     * StatusCondition contains condition information.
+     */
     @JsonProperty("lastUpdateTime")
     public void setLastUpdateTime(String lastUpdateTime) {
         this.lastUpdateTime = lastUpdateTime;
     }
 
+    /**
+     * Message is a human-readable message indicating details about the last status change.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message is a human-readable message indicating details about the last status change.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Reason is a (brief) reason for the condition's last status change.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason is a (brief) reason for the condition's last status change.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status is the status of the condition. One of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status is the status of the condition. One of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type is the type of the cluster condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of the cluster condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/IngressSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/IngressSpec.java
index a70c7e500f4..5966d7cb4a5 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/IngressSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/IngressSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressSpec specifies configuration options for ingress management
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public IngressSpec(List<String> sslCiphers) {
         this.sslCiphers = sslCiphers;
     }
 
+    /**
+     * List of SSL ciphers enabled for management ingress. Defaults to full list of supported ciphers
+     */
     @JsonProperty("sslCiphers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSslCiphers() {
         return sslCiphers;
     }
 
+    /**
+     * List of SSL ciphers enabled for management ingress. Defaults to full list of supported ciphers
+     */
     @JsonProperty("sslCiphers")
     public void setSslCiphers(List<String> sslCiphers) {
         this.sslCiphers = sslCiphers;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/Klusterlet.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/Klusterlet.java
index e43ec9ac59a..010993c0bd9 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/Klusterlet.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/Klusterlet.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Klusterlet represents controllers to install the resources for a managed cluster. When configured, the Klusterlet requires a secret named bootstrap-hub-kubeconfig in the agent namespace to allow API requests to the hub for the registration protocol. In Hosted mode, the Klusterlet requires an additional secret named external-managed-kubeconfig in the agent namespace to allow API requests to the managed cluster for resources installation.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Klusterlet implements Editable<KlusterletBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.open-cluster-management.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Klusterlet";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public Klusterlet(String apiVersion, String kind, ObjectMeta metadata, Klusterle
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Klusterlet represents controllers to install the resources for a managed cluster. When configured, the Klusterlet requires a secret named bootstrap-hub-kubeconfig in the agent namespace to allow API requests to the hub for the registration protocol. In Hosted mode, the Klusterlet requires an additional secret named external-managed-kubeconfig in the agent namespace to allow API requests to the managed cluster for resources installation.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Klusterlet represents controllers to install the resources for a managed cluster. When configured, the Klusterlet requires a secret named bootstrap-hub-kubeconfig in the agent namespace to allow API requests to the hub for the registration protocol. In Hosted mode, the Klusterlet requires an additional secret named external-managed-kubeconfig in the agent namespace to allow API requests to the managed cluster for resources installation.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Klusterlet represents controllers to install the resources for a managed cluster. When configured, the Klusterlet requires a secret named bootstrap-hub-kubeconfig in the agent namespace to allow API requests to the hub for the registration protocol. In Hosted mode, the Klusterlet requires an additional secret named external-managed-kubeconfig in the agent namespace to allow API requests to the managed cluster for resources installation.
+     */
     @JsonProperty("spec")
     public KlusterletSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Klusterlet represents controllers to install the resources for a managed cluster. When configured, the Klusterlet requires a secret named bootstrap-hub-kubeconfig in the agent namespace to allow API requests to the hub for the registration protocol. In Hosted mode, the Klusterlet requires an additional secret named external-managed-kubeconfig in the agent namespace to allow API requests to the managed cluster for resources installation.
+     */
     @JsonProperty("spec")
     public void setSpec(KlusterletSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Klusterlet represents controllers to install the resources for a managed cluster. When configured, the Klusterlet requires a secret named bootstrap-hub-kubeconfig in the agent namespace to allow API requests to the hub for the registration protocol. In Hosted mode, the Klusterlet requires an additional secret named external-managed-kubeconfig in the agent namespace to allow API requests to the managed cluster for resources installation.
+     */
     @JsonProperty("status")
     public KlusterletStatus getStatus() {
         return status;
     }
 
+    /**
+     * Klusterlet represents controllers to install the resources for a managed cluster. When configured, the Klusterlet requires a secret named bootstrap-hub-kubeconfig in the agent namespace to allow API requests to the hub for the registration protocol. In Hosted mode, the Klusterlet requires an additional secret named external-managed-kubeconfig in the agent namespace to allow API requests to the managed cluster for resources installation.
+     */
     @JsonProperty("status")
     public void setStatus(KlusterletStatus status) {
         this.status = status;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/KlusterletDeployOption.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/KlusterletDeployOption.java
index fd9df503f0e..c09eaa5f996 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/KlusterletDeployOption.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/KlusterletDeployOption.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KlusterletDeployOption describes the deployment options for klusterlet
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public KlusterletDeployOption(String mode) {
         this.mode = mode;
     }
 
+    /**
+     * Mode can be Default, Hosted, Singleton or SingletonHosted. It is Default mode if not specified In Default mode, all klusterlet related resources are deployed on the managed cluster. In Hosted mode, only crd and configurations are installed on the spoke/managed cluster. Controllers run in another cluster (defined as management-cluster) and connect to the mangaged cluster with the kubeconfig in secret of "external-managed-kubeconfig"(a kubeconfig of managed-cluster with cluster-admin permission). In Singleton mode, registration/work agent is started as a single deployment. In SingletonHosted mode, agent is started as a single deployment in hosted mode. Note: Do not modify the Mode field once it's applied.
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Mode can be Default, Hosted, Singleton or SingletonHosted. It is Default mode if not specified In Default mode, all klusterlet related resources are deployed on the managed cluster. In Hosted mode, only crd and configurations are installed on the spoke/managed cluster. Controllers run in another cluster (defined as management-cluster) and connect to the mangaged cluster with the kubeconfig in secret of "external-managed-kubeconfig"(a kubeconfig of managed-cluster with cluster-admin permission). In Singleton mode, registration/work agent is started as a single deployment. In SingletonHosted mode, agent is started as a single deployment in hosted mode. Note: Do not modify the Mode field once it's applied.
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/KlusterletList.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/KlusterletList.java
index ae199609ee4..17cd4caf5ab 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/KlusterletList.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/KlusterletList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KlusterletList is a collection of Klusterlet agents.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class KlusterletList implements Editable<KlusterletListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openclustermanagement.api.model.operator.v1.Klusterlet>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.open-cluster-management.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openclustermanagement.api.model.operator.v1.Klusterlet> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KlusterletList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public KlusterletList(String apiVersion, List<io.fabric8.openclustermanagement.a
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of Klusterlet agents.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openclustermanagement.api.model.operator.v1.Klusterlet> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of Klusterlet agents.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openclustermanagement.api.model.operator.v1.Klusterlet> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KlusterletList is a collection of Klusterlet agents.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KlusterletList is a collection of Klusterlet agents.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/KlusterletSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/KlusterletSpec.java
index 3140965508e..50eff1af30e 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/KlusterletSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/KlusterletSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KlusterletSpec represents the desired deployment configuration of Klusterlet agent.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -129,132 +132,210 @@ public KlusterletSpec(String clusterName, KlusterletDeployOption deployOption, L
         this.workImagePullSpec = workImagePullSpec;
     }
 
+    /**
+     * ClusterName is the name of the managed cluster to be created on hub. The Klusterlet agent generates a random name if it is not set, or discovers the appropriate cluster name on OpenShift.
+     */
     @JsonProperty("clusterName")
     public String getClusterName() {
         return clusterName;
     }
 
+    /**
+     * ClusterName is the name of the managed cluster to be created on hub. The Klusterlet agent generates a random name if it is not set, or discovers the appropriate cluster name on OpenShift.
+     */
     @JsonProperty("clusterName")
     public void setClusterName(String clusterName) {
         this.clusterName = clusterName;
     }
 
+    /**
+     * KlusterletSpec represents the desired deployment configuration of Klusterlet agent.
+     */
     @JsonProperty("deployOption")
     public KlusterletDeployOption getDeployOption() {
         return deployOption;
     }
 
+    /**
+     * KlusterletSpec represents the desired deployment configuration of Klusterlet agent.
+     */
     @JsonProperty("deployOption")
     public void setDeployOption(KlusterletDeployOption deployOption) {
         this.deployOption = deployOption;
     }
 
+    /**
+     * ExternalServerURLs represents a list of apiserver urls and ca bundles that is accessible externally If it is set empty, managed cluster has no externally accessible url that hub cluster can visit.
+     */
     @JsonProperty("externalServerURLs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ServerURL> getExternalServerURLs() {
         return externalServerURLs;
     }
 
+    /**
+     * ExternalServerURLs represents a list of apiserver urls and ca bundles that is accessible externally If it is set empty, managed cluster has no externally accessible url that hub cluster can visit.
+     */
     @JsonProperty("externalServerURLs")
     public void setExternalServerURLs(List<ServerURL> externalServerURLs) {
         this.externalServerURLs = externalServerURLs;
     }
 
+    /**
+     * KlusterletSpec represents the desired deployment configuration of Klusterlet agent.
+     */
     @JsonProperty("hubApiServerHostAlias")
     public HubApiServerHostAlias getHubApiServerHostAlias() {
         return hubApiServerHostAlias;
     }
 
+    /**
+     * KlusterletSpec represents the desired deployment configuration of Klusterlet agent.
+     */
     @JsonProperty("hubApiServerHostAlias")
     public void setHubApiServerHostAlias(HubApiServerHostAlias hubApiServerHostAlias) {
         this.hubApiServerHostAlias = hubApiServerHostAlias;
     }
 
+    /**
+     * ImagePullSpec represents the desired image configuration of agent, it takes effect only when singleton mode is set. quay.io/open-cluster-management.io/registration-operator:latest will be used if unspecified
+     */
     @JsonProperty("imagePullSpec")
     public String getImagePullSpec() {
         return imagePullSpec;
     }
 
+    /**
+     * ImagePullSpec represents the desired image configuration of agent, it takes effect only when singleton mode is set. quay.io/open-cluster-management.io/registration-operator:latest will be used if unspecified
+     */
     @JsonProperty("imagePullSpec")
     public void setImagePullSpec(String imagePullSpec) {
         this.imagePullSpec = imagePullSpec;
     }
 
+    /**
+     * Namespace is the namespace to deploy the agent on the managed cluster. The namespace must have a prefix of "open-cluster-management-", and if it is not set, the namespace of "open-cluster-management-agent" is used to deploy agent. In addition, the add-ons are deployed to the namespace of "{Namespace}-addon". In the Hosted mode, this namespace still exists on the managed cluster to contain necessary resources, like service accounts, roles and rolebindings, while the agent is deployed to the namespace with the same name as klusterlet on the management cluster.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace to deploy the agent on the managed cluster. The namespace must have a prefix of "open-cluster-management-", and if it is not set, the namespace of "open-cluster-management-agent" is used to deploy agent. In addition, the add-ons are deployed to the namespace of "{Namespace}-addon". In the Hosted mode, this namespace still exists on the managed cluster to contain necessary resources, like service accounts, roles and rolebindings, while the agent is deployed to the namespace with the same name as klusterlet on the management cluster.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * KlusterletSpec represents the desired deployment configuration of Klusterlet agent.
+     */
     @JsonProperty("nodePlacement")
     public NodePlacement getNodePlacement() {
         return nodePlacement;
     }
 
+    /**
+     * KlusterletSpec represents the desired deployment configuration of Klusterlet agent.
+     */
     @JsonProperty("nodePlacement")
     public void setNodePlacement(NodePlacement nodePlacement) {
         this.nodePlacement = nodePlacement;
     }
 
+    /**
+     * PriorityClassName is the name of the PriorityClass that will be used by the deployed klusterlet agent. It will be ignored when the PriorityClass/v1 API is not available on the managed cluster.
+     */
     @JsonProperty("priorityClassName")
     public String getPriorityClassName() {
         return priorityClassName;
     }
 
+    /**
+     * PriorityClassName is the name of the PriorityClass that will be used by the deployed klusterlet agent. It will be ignored when the PriorityClass/v1 API is not available on the managed cluster.
+     */
     @JsonProperty("priorityClassName")
     public void setPriorityClassName(String priorityClassName) {
         this.priorityClassName = priorityClassName;
     }
 
+    /**
+     * KlusterletSpec represents the desired deployment configuration of Klusterlet agent.
+     */
     @JsonProperty("registrationConfiguration")
     public RegistrationConfiguration getRegistrationConfiguration() {
         return registrationConfiguration;
     }
 
+    /**
+     * KlusterletSpec represents the desired deployment configuration of Klusterlet agent.
+     */
     @JsonProperty("registrationConfiguration")
     public void setRegistrationConfiguration(RegistrationConfiguration registrationConfiguration) {
         this.registrationConfiguration = registrationConfiguration;
     }
 
+    /**
+     * RegistrationImagePullSpec represents the desired image configuration of registration agent. quay.io/open-cluster-management.io/registration:latest will be used if unspecified.
+     */
     @JsonProperty("registrationImagePullSpec")
     public String getRegistrationImagePullSpec() {
         return registrationImagePullSpec;
     }
 
+    /**
+     * RegistrationImagePullSpec represents the desired image configuration of registration agent. quay.io/open-cluster-management.io/registration:latest will be used if unspecified.
+     */
     @JsonProperty("registrationImagePullSpec")
     public void setRegistrationImagePullSpec(String registrationImagePullSpec) {
         this.registrationImagePullSpec = registrationImagePullSpec;
     }
 
+    /**
+     * KlusterletSpec represents the desired deployment configuration of Klusterlet agent.
+     */
     @JsonProperty("resourceRequirement")
     public ResourceRequirement getResourceRequirement() {
         return resourceRequirement;
     }
 
+    /**
+     * KlusterletSpec represents the desired deployment configuration of Klusterlet agent.
+     */
     @JsonProperty("resourceRequirement")
     public void setResourceRequirement(ResourceRequirement resourceRequirement) {
         this.resourceRequirement = resourceRequirement;
     }
 
+    /**
+     * KlusterletSpec represents the desired deployment configuration of Klusterlet agent.
+     */
     @JsonProperty("workConfiguration")
     public WorkAgentConfiguration getWorkConfiguration() {
         return workConfiguration;
     }
 
+    /**
+     * KlusterletSpec represents the desired deployment configuration of Klusterlet agent.
+     */
     @JsonProperty("workConfiguration")
     public void setWorkConfiguration(WorkAgentConfiguration workConfiguration) {
         this.workConfiguration = workConfiguration;
     }
 
+    /**
+     * WorkImagePullSpec represents the desired image configuration of work agent. quay.io/open-cluster-management.io/work:latest will be used if unspecified.
+     */
     @JsonProperty("workImagePullSpec")
     public String getWorkImagePullSpec() {
         return workImagePullSpec;
     }
 
+    /**
+     * WorkImagePullSpec represents the desired image configuration of work agent. quay.io/open-cluster-management.io/work:latest will be used if unspecified.
+     */
     @JsonProperty("workImagePullSpec")
     public void setWorkImagePullSpec(String workImagePullSpec) {
         this.workImagePullSpec = workImagePullSpec;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/KlusterletStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/KlusterletStatus.java
index 1ce6685ced6..a509df0ab99 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/KlusterletStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/KlusterletStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KlusterletStatus represents the current status of Klusterlet agent.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -96,44 +99,68 @@ public KlusterletStatus(List<Condition> conditions, List<GenerationStatus> gener
         this.relatedResources = relatedResources;
     }
 
+    /**
+     * Conditions contain the different condition statuses for this Klusterlet. Valid condition types are: Applied: Components have been applied in the managed cluster. Available: Components in the managed cluster are available and ready to serve. Progressing: Components in the managed cluster are in a transitioning state. Degraded: Components in the managed cluster do not match the desired configuration and only provide degraded service.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions contain the different condition statuses for this Klusterlet. Valid condition types are: Applied: Components have been applied in the managed cluster. Available: Components in the managed cluster are available and ready to serve. Progressing: Components in the managed cluster are in a transitioning state. Degraded: Components in the managed cluster do not match the desired configuration and only provide degraded service.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenerationStatus> getGenerations() {
         return generations;
     }
 
+    /**
+     * Generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     public void setGenerations(List<GenerationStatus> generations) {
         this.generations = generations;
     }
 
+    /**
+     * ObservedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * RelatedResources are used to track the resources that are related to this Klusterlet.
+     */
     @JsonProperty("relatedResources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RelatedResourceMeta> getRelatedResources() {
         return relatedResources;
     }
 
+    /**
+     * RelatedResources are used to track the resources that are related to this Klusterlet.
+     */
     @JsonProperty("relatedResources")
     public void setRelatedResources(List<RelatedResourceMeta> relatedResources) {
         this.relatedResources = relatedResources;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/KubeConfigSecret.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/KubeConfigSecret.java
index c289350ca59..e812377c5db 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/KubeConfigSecret.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/KubeConfigSecret.java
@@ -78,11 +78,17 @@ public KubeConfigSecret(String name) {
         this.name = name;
     }
 
+    /**
+     * Name is the name of the secret.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the secret.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/LocalSecretsConfig.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/LocalSecretsConfig.java
index b470d9c077d..5a667fe0b7a 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/LocalSecretsConfig.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/LocalSecretsConfig.java
@@ -85,22 +85,34 @@ public LocalSecretsConfig(Integer hubConnectionTimeoutSeconds, List<KubeConfigSe
         this.kubeConfigSecrets = kubeConfigSecrets;
     }
 
+    /**
+     * HubConnectionTimeoutSeconds is used to set the timeout of connecting to the hub cluster. When agent loses the connection to the hub over the timeout seconds, the agent do a rebootstrap. By default is 10 mins.
+     */
     @JsonProperty("hubConnectionTimeoutSeconds")
     public Integer getHubConnectionTimeoutSeconds() {
         return hubConnectionTimeoutSeconds;
     }
 
+    /**
+     * HubConnectionTimeoutSeconds is used to set the timeout of connecting to the hub cluster. When agent loses the connection to the hub over the timeout seconds, the agent do a rebootstrap. By default is 10 mins.
+     */
     @JsonProperty("hubConnectionTimeoutSeconds")
     public void setHubConnectionTimeoutSeconds(Integer hubConnectionTimeoutSeconds) {
         this.hubConnectionTimeoutSeconds = hubConnectionTimeoutSeconds;
     }
 
+    /**
+     * KubeConfigSecrets is a list of secret names. The secrets are in the same namespace where the agent controller runs.
+     */
     @JsonProperty("kubeConfigSecrets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<KubeConfigSecret> getKubeConfigSecrets() {
         return kubeConfigSecrets;
     }
 
+    /**
+     * KubeConfigSecrets is a list of secret names. The secrets are in the same namespace where the agent controller runs.
+     */
     @JsonProperty("kubeConfigSecrets")
     public void setKubeConfigSecrets(List<KubeConfigSecret> kubeConfigSecrets) {
         this.kubeConfigSecrets = kubeConfigSecrets;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/MultiClusterHub.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/MultiClusterHub.java
index adaa7debb75..efe7562ddcb 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/MultiClusterHub.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/MultiClusterHub.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MulticlusterHub defines the configuration for an instance of a multicluster hub, a central point for managing multiple Kubernetes-based clusters. The deployment of multicluster hub components is determined based on the configuration that is defined in this resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class MultiClusterHub implements Editable<MultiClusterHubBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.open-cluster-management.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MultiClusterHub";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public MultiClusterHub(String apiVersion, String kind, ObjectMeta metadata, Mult
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MulticlusterHub defines the configuration for an instance of a multicluster hub, a central point for managing multiple Kubernetes-based clusters. The deployment of multicluster hub components is determined based on the configuration that is defined in this resource.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MulticlusterHub defines the configuration for an instance of a multicluster hub, a central point for managing multiple Kubernetes-based clusters. The deployment of multicluster hub components is determined based on the configuration that is defined in this resource.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * MulticlusterHub defines the configuration for an instance of a multicluster hub, a central point for managing multiple Kubernetes-based clusters. The deployment of multicluster hub components is determined based on the configuration that is defined in this resource.
+     */
     @JsonProperty("spec")
     public MultiClusterHubSpec getSpec() {
         return spec;
     }
 
+    /**
+     * MulticlusterHub defines the configuration for an instance of a multicluster hub, a central point for managing multiple Kubernetes-based clusters. The deployment of multicluster hub components is determined based on the configuration that is defined in this resource.
+     */
     @JsonProperty("spec")
     public void setSpec(MultiClusterHubSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * MulticlusterHub defines the configuration for an instance of a multicluster hub, a central point for managing multiple Kubernetes-based clusters. The deployment of multicluster hub components is determined based on the configuration that is defined in this resource.
+     */
     @JsonProperty("status")
     public MultiClusterHubStatus getStatus() {
         return status;
     }
 
+    /**
+     * MulticlusterHub defines the configuration for an instance of a multicluster hub, a central point for managing multiple Kubernetes-based clusters. The deployment of multicluster hub components is determined based on the configuration that is defined in this resource.
+     */
     @JsonProperty("status")
     public void setStatus(MultiClusterHubStatus status) {
         this.status = status;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/MultiClusterHubList.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/MultiClusterHubList.java
index eb48150efd4..0c72915aceb 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/MultiClusterHubList.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/MultiClusterHubList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MultiClusterHubList contains a list of MultiClusterHub
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class MultiClusterHubList implements Editable<MultiClusterHubListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openclustermanagement.api.model.operator.v1.MultiClusterHub>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.open-cluster-management.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openclustermanagement.api.model.operator.v1.MultiClusterHub> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MultiClusterHubList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public MultiClusterHubList(String apiVersion, List<io.fabric8.openclustermanagem
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * MultiClusterHubList contains a list of MultiClusterHub
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openclustermanagement.api.model.operator.v1.MultiClusterHub> getItems() {
         return items;
     }
 
+    /**
+     * MultiClusterHubList contains a list of MultiClusterHub
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openclustermanagement.api.model.operator.v1.MultiClusterHub> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MultiClusterHubList contains a list of MultiClusterHub
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MultiClusterHubList contains a list of MultiClusterHub
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/MultiClusterHubSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/MultiClusterHubSpec.java
index 543582f6f2f..a2899f877f6 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/MultiClusterHubSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/MultiClusterHubSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MultiClusterHubSpec defines the desired state of MultiClusterHub
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -131,133 +134,211 @@ public MultiClusterHubSpec(String availabilityConfig, String customCAConfigmap,
         this.tolerations = tolerations;
     }
 
+    /**
+     * Specifies deployment replication for improved availability. Options are: Basic and High (default)
+     */
     @JsonProperty("availabilityConfig")
     public String getAvailabilityConfig() {
         return availabilityConfig;
     }
 
+    /**
+     * Specifies deployment replication for improved availability. Options are: Basic and High (default)
+     */
     @JsonProperty("availabilityConfig")
     public void setAvailabilityConfig(String availabilityConfig) {
         this.availabilityConfig = availabilityConfig;
     }
 
+    /**
+     * (Deprecated) Provide the customized OpenShift default ingress CA certificate to RHACM
+     */
     @JsonProperty("customCAConfigmap")
     public String getCustomCAConfigmap() {
         return customCAConfigmap;
     }
 
+    /**
+     * (Deprecated) Provide the customized OpenShift default ingress CA certificate to RHACM
+     */
     @JsonProperty("customCAConfigmap")
     public void setCustomCAConfigmap(String customCAConfigmap) {
         this.customCAConfigmap = customCAConfigmap;
     }
 
+    /**
+     * Disable automatic import of the hub cluster as a managed cluster
+     */
     @JsonProperty("disableHubSelfManagement")
     public Boolean getDisableHubSelfManagement() {
         return disableHubSelfManagement;
     }
 
+    /**
+     * Disable automatic import of the hub cluster as a managed cluster
+     */
     @JsonProperty("disableHubSelfManagement")
     public void setDisableHubSelfManagement(Boolean disableHubSelfManagement) {
         this.disableHubSelfManagement = disableHubSelfManagement;
     }
 
+    /**
+     * Disable automatic update of ClusterImageSets
+     */
     @JsonProperty("disableUpdateClusterImageSets")
     public Boolean getDisableUpdateClusterImageSets() {
         return disableUpdateClusterImageSets;
     }
 
+    /**
+     * Disable automatic update of ClusterImageSets
+     */
     @JsonProperty("disableUpdateClusterImageSets")
     public void setDisableUpdateClusterImageSets(Boolean disableUpdateClusterImageSets) {
         this.disableUpdateClusterImageSets = disableUpdateClusterImageSets;
     }
 
+    /**
+     * (Deprecated) Enable cluster backup
+     */
     @JsonProperty("enableClusterBackup")
     public Boolean getEnableClusterBackup() {
         return enableClusterBackup;
     }
 
+    /**
+     * (Deprecated) Enable cluster backup
+     */
     @JsonProperty("enableClusterBackup")
     public void setEnableClusterBackup(Boolean enableClusterBackup) {
         this.enableClusterBackup = enableClusterBackup;
     }
 
+    /**
+     * (Deprecated) Enable cluster proxy addon
+     */
     @JsonProperty("enableClusterProxyAddon")
     public Boolean getEnableClusterProxyAddon() {
         return enableClusterProxyAddon;
     }
 
+    /**
+     * (Deprecated) Enable cluster proxy addon
+     */
     @JsonProperty("enableClusterProxyAddon")
     public void setEnableClusterProxyAddon(Boolean enableClusterProxyAddon) {
         this.enableClusterProxyAddon = enableClusterProxyAddon;
     }
 
+    /**
+     * MultiClusterHubSpec defines the desired state of MultiClusterHub
+     */
     @JsonProperty("hive")
     public HiveConfigSpec getHive() {
         return hive;
     }
 
+    /**
+     * MultiClusterHubSpec defines the desired state of MultiClusterHub
+     */
     @JsonProperty("hive")
     public void setHive(HiveConfigSpec hive) {
         this.hive = hive;
     }
 
+    /**
+     * Override pull secret for accessing MultiClusterHub operand and endpoint images
+     */
     @JsonProperty("imagePullSecret")
     public String getImagePullSecret() {
         return imagePullSecret;
     }
 
+    /**
+     * Override pull secret for accessing MultiClusterHub operand and endpoint images
+     */
     @JsonProperty("imagePullSecret")
     public void setImagePullSecret(String imagePullSecret) {
         this.imagePullSecret = imagePullSecret;
     }
 
+    /**
+     * MultiClusterHubSpec defines the desired state of MultiClusterHub
+     */
     @JsonProperty("ingress")
     public IngressSpec getIngress() {
         return ingress;
     }
 
+    /**
+     * MultiClusterHubSpec defines the desired state of MultiClusterHub
+     */
     @JsonProperty("ingress")
     public void setIngress(IngressSpec ingress) {
         this.ingress = ingress;
     }
 
+    /**
+     * Set the nodeselectors
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * Set the nodeselectors
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * MultiClusterHubSpec defines the desired state of MultiClusterHub
+     */
     @JsonProperty("overrides")
     public Overrides getOverrides() {
         return overrides;
     }
 
+    /**
+     * MultiClusterHubSpec defines the desired state of MultiClusterHub
+     */
     @JsonProperty("overrides")
     public void setOverrides(Overrides overrides) {
         this.overrides = overrides;
     }
 
+    /**
+     * (Deprecated) Install cert-manager into its own namespace
+     */
     @JsonProperty("separateCertificateManagement")
     public Boolean getSeparateCertificateManagement() {
         return separateCertificateManagement;
     }
 
+    /**
+     * (Deprecated) Install cert-manager into its own namespace
+     */
     @JsonProperty("separateCertificateManagement")
     public void setSeparateCertificateManagement(Boolean separateCertificateManagement) {
         this.separateCertificateManagement = separateCertificateManagement;
     }
 
+    /**
+     * Tolerations causes all components to tolerate any taints.
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * Tolerations causes all components to tolerate any taints.
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/MultiClusterHubStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/MultiClusterHubStatus.java
index 2ea6308fc3b..76f72b5ad2e 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/MultiClusterHubStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/MultiClusterHubStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MultiClusterHubStatus defines the observed state of MultiClusterHub
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,53 +101,83 @@ public MultiClusterHubStatus(Map<String, StatusCondition> components, List<HubCo
         this.phase = phase;
     }
 
+    /**
+     * Components []ComponentCondition `json:"manifests,omitempty"`
+     */
     @JsonProperty("components")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, StatusCondition> getComponents() {
         return components;
     }
 
+    /**
+     * Components []ComponentCondition `json:"manifests,omitempty"`
+     */
     @JsonProperty("components")
     public void setComponents(Map<String, StatusCondition> components) {
         this.components = components;
     }
 
+    /**
+     * Conditions contains the different condition statuses for the MultiClusterHub
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HubCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions contains the different condition statuses for the MultiClusterHub
+     */
     @JsonProperty("conditions")
     public void setConditions(List<HubCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * CurrentVersion indicates the current version
+     */
     @JsonProperty("currentVersion")
     public String getCurrentVersion() {
         return currentVersion;
     }
 
+    /**
+     * CurrentVersion indicates the current version
+     */
     @JsonProperty("currentVersion")
     public void setCurrentVersion(String currentVersion) {
         this.currentVersion = currentVersion;
     }
 
+    /**
+     * DesiredVersion indicates the desired version
+     */
     @JsonProperty("desiredVersion")
     public String getDesiredVersion() {
         return desiredVersion;
     }
 
+    /**
+     * DesiredVersion indicates the desired version
+     */
     @JsonProperty("desiredVersion")
     public void setDesiredVersion(String desiredVersion) {
         this.desiredVersion = desiredVersion;
     }
 
+    /**
+     * Represents the running phase of the MultiClusterHub
+     */
     @JsonProperty("phase")
     public String getPhase() {
         return phase;
     }
 
+    /**
+     * Represents the running phase of the MultiClusterHub
+     */
     @JsonProperty("phase")
     public void setPhase(String phase) {
         this.phase = phase;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/NodePlacement.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/NodePlacement.java
index 771e4571774..356e34382c8 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/NodePlacement.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/NodePlacement.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NodePlacement describes node scheduling configuration for the pods.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,23 +90,35 @@ public NodePlacement(Map<String, String> nodeSelector, List<Toleration> tolerati
         this.tolerations = tolerations;
     }
 
+    /**
+     * NodeSelector defines which Nodes the Pods are scheduled on. The default is an empty list.
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * NodeSelector defines which Nodes the Pods are scheduled on. The default is an empty list.
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * Tolerations are attached by pods to tolerate any taint that matches the triple &lt;key,value,effect&gt; using the matching operator &lt;operator&gt;. The default is an empty list.
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * Tolerations are attached by pods to tolerate any taint that matches the triple &lt;key,value,effect&gt; using the matching operator &lt;operator&gt;. The default is an empty list.
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/Overrides.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/Overrides.java
index f13963d83a2..1ca8724a4c4 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/Overrides.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/Overrides.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Overrides provides developer overrides for MCH installation
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public Overrides(List<ComponentConfig> components, String imagePullPolicy) {
         this.imagePullPolicy = imagePullPolicy;
     }
 
+    /**
+     * Provides optional configuration for components, the list of which can be found here: https://github.com/stolostron/multiclusterhub-operator/tree/main/docs/available-components.md
+     */
     @JsonProperty("components")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ComponentConfig> getComponents() {
         return components;
     }
 
+    /**
+     * Provides optional configuration for components, the list of which can be found here: https://github.com/stolostron/multiclusterhub-operator/tree/main/docs/available-components.md
+     */
     @JsonProperty("components")
     public void setComponents(List<ComponentConfig> components) {
         this.components = components;
     }
 
+    /**
+     * Pull policy of the MultiCluster hub images
+     */
     @JsonProperty("imagePullPolicy")
     public String getImagePullPolicy() {
         return imagePullPolicy;
     }
 
+    /**
+     * Pull policy of the MultiCluster hub images
+     */
     @JsonProperty("imagePullPolicy")
     public void setImagePullPolicy(String imagePullPolicy) {
         this.imagePullPolicy = imagePullPolicy;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/RegistrationConfiguration.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/RegistrationConfiguration.java
index cbc07b3daa7..7e98de1973a 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/RegistrationConfiguration.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/RegistrationConfiguration.java
@@ -116,53 +116,83 @@ public void setBootstrapKubeConfigs(BootstrapKubeConfigs bootstrapKubeConfigs) {
         this.bootstrapKubeConfigs = bootstrapKubeConfigs;
     }
 
+    /**
+     * clientCertExpirationSeconds represents the seconds of a client certificate to expire. If it is not set or 0, the default duration seconds will be set by the hub cluster. If the value is larger than the max signing duration seconds set on the hub cluster, the max signing duration seconds will be set.
+     */
     @JsonProperty("clientCertExpirationSeconds")
     public Integer getClientCertExpirationSeconds() {
         return clientCertExpirationSeconds;
     }
 
+    /**
+     * clientCertExpirationSeconds represents the seconds of a client certificate to expire. If it is not set or 0, the default duration seconds will be set by the hub cluster. If the value is larger than the max signing duration seconds set on the hub cluster, the max signing duration seconds will be set.
+     */
     @JsonProperty("clientCertExpirationSeconds")
     public void setClientCertExpirationSeconds(Integer clientCertExpirationSeconds) {
         this.clientCertExpirationSeconds = clientCertExpirationSeconds;
     }
 
+    /**
+     * ClusterAnnotations is annotations with the reserve prefix "agent.open-cluster-management.io" set on ManagedCluster when creating only, other actors can update it afterwards.
+     */
     @JsonProperty("clusterAnnotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getClusterAnnotations() {
         return clusterAnnotations;
     }
 
+    /**
+     * ClusterAnnotations is annotations with the reserve prefix "agent.open-cluster-management.io" set on ManagedCluster when creating only, other actors can update it afterwards.
+     */
     @JsonProperty("clusterAnnotations")
     public void setClusterAnnotations(Map<String, String> clusterAnnotations) {
         this.clusterAnnotations = clusterAnnotations;
     }
 
+    /**
+     * FeatureGates represents the list of feature gates for registration If it is set empty, default feature gates will be used. If it is set, featuregate/Foo is an example of one item in FeatureGates:<br><p>   1. If featuregate/Foo does not exist, registration-operator will discard it<br><p>   2. If featuregate/Foo exists and is false by default. It is now possible to set featuregate/Foo=[false|true]<br><p>   3. If featuregate/Foo exists and is true by default. If a cluster-admin upgrading from 1 to 2 wants to continue having featuregate/Foo=false,<br><p>  	he can set featuregate/Foo=false before upgrading. Let's say the cluster-admin wants featuregate/Foo=false.
+     */
     @JsonProperty("featureGates")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<FeatureGate> getFeatureGates() {
         return featureGates;
     }
 
+    /**
+     * FeatureGates represents the list of feature gates for registration If it is set empty, default feature gates will be used. If it is set, featuregate/Foo is an example of one item in FeatureGates:<br><p>   1. If featuregate/Foo does not exist, registration-operator will discard it<br><p>   2. If featuregate/Foo exists and is false by default. It is now possible to set featuregate/Foo=[false|true]<br><p>   3. If featuregate/Foo exists and is true by default. If a cluster-admin upgrading from 1 to 2 wants to continue having featuregate/Foo=false,<br><p>  	he can set featuregate/Foo=false before upgrading. Let's say the cluster-admin wants featuregate/Foo=false.
+     */
     @JsonProperty("featureGates")
     public void setFeatureGates(List<FeatureGate> featureGates) {
         this.featureGates = featureGates;
     }
 
+    /**
+     * KubeAPIBurst indicates the maximum burst of the throttle while talking with apiserver of hub cluster from the spoke cluster. If it is set empty, use the default value: 100
+     */
     @JsonProperty("kubeAPIBurst")
     public Integer getKubeAPIBurst() {
         return kubeAPIBurst;
     }
 
+    /**
+     * KubeAPIBurst indicates the maximum burst of the throttle while talking with apiserver of hub cluster from the spoke cluster. If it is set empty, use the default value: 100
+     */
     @JsonProperty("kubeAPIBurst")
     public void setKubeAPIBurst(Integer kubeAPIBurst) {
         this.kubeAPIBurst = kubeAPIBurst;
     }
 
+    /**
+     * KubeAPIQPS indicates the maximum QPS while talking with apiserver of hub cluster from the spoke cluster. If it is set empty, use the default value: 50
+     */
     @JsonProperty("kubeAPIQPS")
     public Integer getKubeAPIQPS() {
         return kubeAPIQPS;
     }
 
+    /**
+     * KubeAPIQPS indicates the maximum QPS while talking with apiserver of hub cluster from the spoke cluster. If it is set empty, use the default value: 50
+     */
     @JsonProperty("kubeAPIQPS")
     public void setKubeAPIQPS(Integer kubeAPIQPS) {
         this.kubeAPIQPS = kubeAPIQPS;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/RegistrationDriver.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/RegistrationDriver.java
index d83f211e4ce..c5d521aa005 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/RegistrationDriver.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/RegistrationDriver.java
@@ -82,11 +82,17 @@ public RegistrationDriver(String authType, AwsIrsa awsIrsa) {
         this.awsIrsa = awsIrsa;
     }
 
+    /**
+     * Type of the authentication used by managedcluster to register as well as pull work from hub. Possible values are csr and awsirsa.
+     */
     @JsonProperty("authType")
     public String getAuthType() {
         return authType;
     }
 
+    /**
+     * Type of the authentication used by managedcluster to register as well as pull work from hub. Possible values are csr and awsirsa.
+     */
     @JsonProperty("authType")
     public void setAuthType(String authType) {
         this.authType = authType;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/RegistrationHubConfiguration.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/RegistrationHubConfiguration.java
index e9d99dba0f9..3877f66a9b9 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/RegistrationHubConfiguration.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/RegistrationHubConfiguration.java
@@ -86,23 +86,35 @@ public RegistrationHubConfiguration(List<String> autoApproveUsers, List<FeatureG
         this.featureGates = featureGates;
     }
 
+    /**
+     * AutoApproveUser represents a list of users that can auto approve CSR and accept client. If the credential of the bootstrap-hub-kubeconfig matches to the users, the cluster created by the bootstrap-hub-kubeconfig will be auto-registered into the hub cluster. This takes effect only when ManagedClusterAutoApproval feature gate is enabled.
+     */
     @JsonProperty("autoApproveUsers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAutoApproveUsers() {
         return autoApproveUsers;
     }
 
+    /**
+     * AutoApproveUser represents a list of users that can auto approve CSR and accept client. If the credential of the bootstrap-hub-kubeconfig matches to the users, the cluster created by the bootstrap-hub-kubeconfig will be auto-registered into the hub cluster. This takes effect only when ManagedClusterAutoApproval feature gate is enabled.
+     */
     @JsonProperty("autoApproveUsers")
     public void setAutoApproveUsers(List<String> autoApproveUsers) {
         this.autoApproveUsers = autoApproveUsers;
     }
 
+    /**
+     * FeatureGates represents the list of feature gates for registration If it is set empty, default feature gates will be used. If it is set, featuregate/Foo is an example of one item in FeatureGates:<br><p>   1. If featuregate/Foo does not exist, registration-operator will discard it<br><p>   2. If featuregate/Foo exists and is false by default. It is now possible to set featuregate/Foo=[false|true]<br><p>   3. If featuregate/Foo exists and is true by default. If a cluster-admin upgrading from 1 to 2 wants to continue having featuregate/Foo=false,<br><p>  	he can set featuregate/Foo=false before upgrading. Let's say the cluster-admin wants featuregate/Foo=false.
+     */
     @JsonProperty("featureGates")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<FeatureGate> getFeatureGates() {
         return featureGates;
     }
 
+    /**
+     * FeatureGates represents the list of feature gates for registration If it is set empty, default feature gates will be used. If it is set, featuregate/Foo is an example of one item in FeatureGates:<br><p>   1. If featuregate/Foo does not exist, registration-operator will discard it<br><p>   2. If featuregate/Foo exists and is false by default. It is now possible to set featuregate/Foo=[false|true]<br><p>   3. If featuregate/Foo exists and is true by default. If a cluster-admin upgrading from 1 to 2 wants to continue having featuregate/Foo=false,<br><p>  	he can set featuregate/Foo=false before upgrading. Let's say the cluster-admin wants featuregate/Foo=false.
+     */
     @JsonProperty("featureGates")
     public void setFeatureGates(List<FeatureGate> featureGates) {
         this.featureGates = featureGates;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/RelatedResourceMeta.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/RelatedResourceMeta.java
index db379c8810d..7ce2fc1c3bd 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/RelatedResourceMeta.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/RelatedResourceMeta.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RelatedResourceMeta represents the resource that is managed by an operator
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public RelatedResourceMeta(String group, String name, String namespace, String r
         this.version = version;
     }
 
+    /**
+     * group is the group of the resource that you're tracking
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * group is the group of the resource that you're tracking
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * name is the name of the resource that you're tracking
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the resource that you're tracking
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * namespace is where the thing you're tracking is
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * namespace is where the thing you're tracking is
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * resource is the resource type of the resource that you're tracking
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * resource is the resource type of the resource that you're tracking
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
     }
 
+    /**
+     * version is the version of the thing you're tracking
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the version of the thing you're tracking
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ResourceRequirement.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ResourceRequirement.java
index f051d662f4d..d5896ca0b05 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ResourceRequirement.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ResourceRequirement.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceRequirement allow user override the default pod QoS classes
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ResourceRequirement(ResourceRequirements resourceRequirements, String typ
         this.type = type;
     }
 
+    /**
+     * ResourceRequirement allow user override the default pod QoS classes
+     */
     @JsonProperty("resourceRequirements")
     public ResourceRequirements getResourceRequirements() {
         return resourceRequirements;
     }
 
+    /**
+     * ResourceRequirement allow user override the default pod QoS classes
+     */
     @JsonProperty("resourceRequirements")
     public void setResourceRequirements(ResourceRequirements resourceRequirements) {
         this.resourceRequirements = resourceRequirements;
     }
 
+    /**
+     * ResourceRequirement allow user override the default pod QoS classes
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * ResourceRequirement allow user override the default pod QoS classes
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ServerURL.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ServerURL.java
index f3c16a55240..00e44760ce9 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ServerURL.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/ServerURL.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServerURL represents the apiserver url and ca bundle that is accessible externally
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ServerURL(String caBundle, String url) {
         this.url = url;
     }
 
+    /**
+     * CABundle is the ca bundle to connect to apiserver of the managed cluster. System certs are used if it is not set.
+     */
     @JsonProperty("caBundle")
     public String getCaBundle() {
         return caBundle;
     }
 
+    /**
+     * CABundle is the ca bundle to connect to apiserver of the managed cluster. System certs are used if it is not set.
+     */
     @JsonProperty("caBundle")
     public void setCaBundle(String caBundle) {
         this.caBundle = caBundle;
     }
 
+    /**
+     * URL is the url of apiserver endpoint of the managed cluster.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * URL is the url of apiserver endpoint of the managed cluster.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/StatusCondition.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/StatusCondition.java
index 51c54725f05..3b1828d168f 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/StatusCondition.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/StatusCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StatusCondition contains condition information.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,71 +105,113 @@ public StatusCondition(String kind, String lastTransitionTime, String message, S
         this.type = type;
     }
 
+    /**
+     * The resource kind this condition represents
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * The resource kind this condition represents
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * StatusCondition contains condition information.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * StatusCondition contains condition information.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Message is a human-readable message indicating details about the last status change.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message is a human-readable message indicating details about the last status change.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * The component name
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The component name
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Reason is a (brief) reason for the condition's last status change.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason is a (brief) reason for the condition's last status change.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status is the status of the condition. One of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status is the status of the condition. One of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type is the type of the cluster condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of the cluster condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/VeleroBackupConfig.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/VeleroBackupConfig.java
index feb9102b8d9..e425ba5cb1a 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/VeleroBackupConfig.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/VeleroBackupConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VeleroBackupConfig contains settings for the Velero backup integration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public VeleroBackupConfig(Boolean enabled) {
         this.enabled = enabled;
     }
 
+    /**
+     * (Deprecated) Enabled dictates if Velero backup integration is enabled. If not specified, the default is disabled.
+     */
     @JsonProperty("enabled")
     public Boolean getEnabled() {
         return enabled;
     }
 
+    /**
+     * (Deprecated) Enabled dictates if Velero backup integration is enabled. If not specified, the default is disabled.
+     */
     @JsonProperty("enabled")
     public void setEnabled(Boolean enabled) {
         this.enabled = enabled;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/WebhookConfiguration.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/WebhookConfiguration.java
index 720f6c4565a..865c178dfc7 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/WebhookConfiguration.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/WebhookConfiguration.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WebhookConfiguration has two properties: Address and Port.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public WebhookConfiguration(String address, Integer port) {
         this.port = port;
     }
 
+    /**
+     * Address represents the address of a webhook-server. It could be in IP format or fqdn format. The Address must be reachable by apiserver of the hub cluster.
+     */
     @JsonProperty("address")
     public String getAddress() {
         return address;
     }
 
+    /**
+     * Address represents the address of a webhook-server. It could be in IP format or fqdn format. The Address must be reachable by apiserver of the hub cluster.
+     */
     @JsonProperty("address")
     public void setAddress(String address) {
         this.address = address;
     }
 
+    /**
+     * Port represents the port of a webhook-server. The default value of Port is 443.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * Port represents the port of a webhook-server. The default value of Port is 443.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/WorkAgentConfiguration.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/WorkAgentConfiguration.java
index 1939e1f1bf9..f0bac329db4 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/WorkAgentConfiguration.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/WorkAgentConfiguration.java
@@ -104,32 +104,50 @@ public void setAppliedManifestWorkEvictionGracePeriod(Duration appliedManifestWo
         this.appliedManifestWorkEvictionGracePeriod = appliedManifestWorkEvictionGracePeriod;
     }
 
+    /**
+     * FeatureGates represents the list of feature gates for work If it is set empty, default feature gates will be used. If it is set, featuregate/Foo is an example of one item in FeatureGates:<br><p>   1. If featuregate/Foo does not exist, registration-operator will discard it<br><p>   2. If featuregate/Foo exists and is false by default. It is now possible to set featuregate/Foo=[false|true]<br><p>   3. If featuregate/Foo exists and is true by default. If a cluster-admin upgrading from 1 to 2 wants to continue having featuregate/Foo=false,<br><p>  	he can set featuregate/Foo=false before upgrading. Let's say the cluster-admin wants featuregate/Foo=false.
+     */
     @JsonProperty("featureGates")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<FeatureGate> getFeatureGates() {
         return featureGates;
     }
 
+    /**
+     * FeatureGates represents the list of feature gates for work If it is set empty, default feature gates will be used. If it is set, featuregate/Foo is an example of one item in FeatureGates:<br><p>   1. If featuregate/Foo does not exist, registration-operator will discard it<br><p>   2. If featuregate/Foo exists and is false by default. It is now possible to set featuregate/Foo=[false|true]<br><p>   3. If featuregate/Foo exists and is true by default. If a cluster-admin upgrading from 1 to 2 wants to continue having featuregate/Foo=false,<br><p>  	he can set featuregate/Foo=false before upgrading. Let's say the cluster-admin wants featuregate/Foo=false.
+     */
     @JsonProperty("featureGates")
     public void setFeatureGates(List<FeatureGate> featureGates) {
         this.featureGates = featureGates;
     }
 
+    /**
+     * KubeAPIBurst indicates the maximum burst of the throttle while talking with apiserver of hub cluster from the spoke cluster. If it is set empty, use the default value: 100
+     */
     @JsonProperty("kubeAPIBurst")
     public Integer getKubeAPIBurst() {
         return kubeAPIBurst;
     }
 
+    /**
+     * KubeAPIBurst indicates the maximum burst of the throttle while talking with apiserver of hub cluster from the spoke cluster. If it is set empty, use the default value: 100
+     */
     @JsonProperty("kubeAPIBurst")
     public void setKubeAPIBurst(Integer kubeAPIBurst) {
         this.kubeAPIBurst = kubeAPIBurst;
     }
 
+    /**
+     * KubeAPIQPS indicates the maximum QPS while talking with apiserver of hub cluster from the spoke cluster. If it is set empty, use the default value: 50
+     */
     @JsonProperty("kubeAPIQPS")
     public Integer getKubeAPIQPS() {
         return kubeAPIQPS;
     }
 
+    /**
+     * KubeAPIQPS indicates the maximum QPS while talking with apiserver of hub cluster from the spoke cluster. If it is set empty, use the default value: 50
+     */
     @JsonProperty("kubeAPIQPS")
     public void setKubeAPIQPS(Integer kubeAPIQPS) {
         this.kubeAPIQPS = kubeAPIQPS;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/WorkConfiguration.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/WorkConfiguration.java
index d2384ca5ec2..da9ed58b199 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/WorkConfiguration.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/operator/v1/WorkConfiguration.java
@@ -85,22 +85,34 @@ public WorkConfiguration(List<FeatureGate> featureGates, String workDriver) {
         this.workDriver = workDriver;
     }
 
+    /**
+     * FeatureGates represents the list of feature gates for work If it is set empty, default feature gates will be used. If it is set, featuregate/Foo is an example of one item in FeatureGates:<br><p>   1. If featuregate/Foo does not exist, registration-operator will discard it<br><p>   2. If featuregate/Foo exists and is false by default. It is now possible to set featuregate/Foo=[false|true]<br><p>   3. If featuregate/Foo exists and is true by default. If a cluster-admin upgrading from 1 to 2 wants to continue having featuregate/Foo=false,<br><p>  	he can set featuregate/Foo=false before upgrading. Let's say the cluster-admin wants featuregate/Foo=false.
+     */
     @JsonProperty("featureGates")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<FeatureGate> getFeatureGates() {
         return featureGates;
     }
 
+    /**
+     * FeatureGates represents the list of feature gates for work If it is set empty, default feature gates will be used. If it is set, featuregate/Foo is an example of one item in FeatureGates:<br><p>   1. If featuregate/Foo does not exist, registration-operator will discard it<br><p>   2. If featuregate/Foo exists and is false by default. It is now possible to set featuregate/Foo=[false|true]<br><p>   3. If featuregate/Foo exists and is true by default. If a cluster-admin upgrading from 1 to 2 wants to continue having featuregate/Foo=false,<br><p>  	he can set featuregate/Foo=false before upgrading. Let's say the cluster-admin wants featuregate/Foo=false.
+     */
     @JsonProperty("featureGates")
     public void setFeatureGates(List<FeatureGate> featureGates) {
         this.featureGates = featureGates;
     }
 
+    /**
+     * WorkDriver represents the type of work driver. Possible values are "kube", "mqtt", or "grpc". If not provided, the default value is "kube". If set to non-"kube" drivers, the klusterlet need to use the same driver. and the driver configuration must be provided in a secret named "work-driver-config" in the namespace where the cluster manager is running, adhering to the following structure: config.yaml: |<br><p>   &lt;driver-config-in-yaml&gt;<br><p> <br><p> For detailed driver configuration, please refer to the sdk-go documentation: https://github.com/open-cluster-management-io/sdk-go/blob/main/pkg/cloudevents/README.md#supported-protocols-and-drivers
+     */
     @JsonProperty("workDriver")
     public String getWorkDriver() {
         return workDriver;
     }
 
+    /**
+     * WorkDriver represents the type of work driver. Possible values are "kube", "mqtt", or "grpc". If not provided, the default value is "kube". If set to non-"kube" drivers, the klusterlet need to use the same driver. and the driver configuration must be provided in a secret named "work-driver-config" in the namespace where the cluster manager is running, adhering to the following structure: config.yaml: |<br><p>   &lt;driver-config-in-yaml&gt;<br><p> <br><p> For detailed driver configuration, please refer to the sdk-go documentation: https://github.com/open-cluster-management-io/sdk-go/blob/main/pkg/cloudevents/README.md#supported-protocols-and-drivers
+     */
     @JsonProperty("workDriver")
     public void setWorkDriver(String workDriver) {
         this.workDriver = workDriver;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/BindingOverrides.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/BindingOverrides.java
index eb29a6ec8f2..10df1119370 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/BindingOverrides.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/BindingOverrides.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BindingOverrides defines the overrides for the subjects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public BindingOverrides(String remediationAction) {
         this.remediationAction = remediationAction;
     }
 
+    /**
+     * RemediationAction overrides the policy remediationAction on target clusters. This parameter is optional. If you set it, you must set it to "enforce".
+     */
     @JsonProperty("remediationAction")
     public String getRemediationAction() {
         return remediationAction;
     }
 
+    /**
+     * RemediationAction overrides the policy remediationAction on target clusters. This parameter is optional. If you set it, you must set it to "enforce".
+     */
     @JsonProperty("remediationAction")
     public void setRemediationAction(String remediationAction) {
         this.remediationAction = remediationAction;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/ComplianceHistory.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/ComplianceHistory.java
index c34f7d35cb8..988382d6e63 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/ComplianceHistory.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/ComplianceHistory.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ComplianceHistory reports a compliance message from a given time and event.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ComplianceHistory(String eventName, String lastTimestamp, String message)
         this.message = message;
     }
 
+    /**
+     * EventName is the name of the event attached to the message.
+     */
     @JsonProperty("eventName")
     public String getEventName() {
         return eventName;
     }
 
+    /**
+     * EventName is the name of the event attached to the message.
+     */
     @JsonProperty("eventName")
     public void setEventName(String eventName) {
         this.eventName = eventName;
     }
 
+    /**
+     * ComplianceHistory reports a compliance message from a given time and event.
+     */
     @JsonProperty("lastTimestamp")
     public String getLastTimestamp() {
         return lastTimestamp;
     }
 
+    /**
+     * ComplianceHistory reports a compliance message from a given time and event.
+     */
     @JsonProperty("lastTimestamp")
     public void setLastTimestamp(String lastTimestamp) {
         this.lastTimestamp = lastTimestamp;
     }
 
+    /**
+     * Message is the compliance message resulting from evaluating the policy resource.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message is the compliance message resulting from evaluating the policy resource.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/CompliancePerClusterStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/CompliancePerClusterStatus.java
index 7b5a5a552f5..8201b24503d 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/CompliancePerClusterStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/CompliancePerClusterStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CompliancePerClusterStatus reports the name of a managed cluster and its compliance state for this policy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public CompliancePerClusterStatus(String clustername, String clusternamespace, S
         this.compliant = compliant;
     }
 
+    /**
+     * CompliancePerClusterStatus reports the name of a managed cluster and its compliance state for this policy.
+     */
     @JsonProperty("clustername")
     public String getClustername() {
         return clustername;
     }
 
+    /**
+     * CompliancePerClusterStatus reports the name of a managed cluster and its compliance state for this policy.
+     */
     @JsonProperty("clustername")
     public void setClustername(String clustername) {
         this.clustername = clustername;
     }
 
+    /**
+     * CompliancePerClusterStatus reports the name of a managed cluster and its compliance state for this policy.
+     */
     @JsonProperty("clusternamespace")
     public String getClusternamespace() {
         return clusternamespace;
     }
 
+    /**
+     * CompliancePerClusterStatus reports the name of a managed cluster and its compliance state for this policy.
+     */
     @JsonProperty("clusternamespace")
     public void setClusternamespace(String clusternamespace) {
         this.clusternamespace = clusternamespace;
     }
 
+    /**
+     * CompliancePerClusterStatus reports the name of a managed cluster and its compliance state for this policy.
+     */
     @JsonProperty("compliant")
     public String getCompliant() {
         return compliant;
     }
 
+    /**
+     * CompliancePerClusterStatus reports the name of a managed cluster and its compliance state for this policy.
+     */
     @JsonProperty("compliant")
     public void setCompliant(String compliant) {
         this.compliant = compliant;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/DetailsPerTemplate.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/DetailsPerTemplate.java
index d7533c87e6f..c0d9b999e41 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/DetailsPerTemplate.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/DetailsPerTemplate.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DetailsPerTemplate reports the current compliance state and list of recent compliance messages for a given policy template.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public DetailsPerTemplate(String compliant, List<ComplianceHistory> history, Obj
         this.templateMeta = templateMeta;
     }
 
+    /**
+     * DetailsPerTemplate reports the current compliance state and list of recent compliance messages for a given policy template.
+     */
     @JsonProperty("compliant")
     public String getCompliant() {
         return compliant;
     }
 
+    /**
+     * DetailsPerTemplate reports the current compliance state and list of recent compliance messages for a given policy template.
+     */
     @JsonProperty("compliant")
     public void setCompliant(String compliant) {
         this.compliant = compliant;
     }
 
+    /**
+     * DetailsPerTemplate reports the current compliance state and list of recent compliance messages for a given policy template.
+     */
     @JsonProperty("history")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ComplianceHistory> getHistory() {
         return history;
     }
 
+    /**
+     * DetailsPerTemplate reports the current compliance state and list of recent compliance messages for a given policy template.
+     */
     @JsonProperty("history")
     public void setHistory(List<ComplianceHistory> history) {
         this.history = history;
     }
 
+    /**
+     * DetailsPerTemplate reports the current compliance state and list of recent compliance messages for a given policy template.
+     */
     @JsonProperty("templateMeta")
     public ObjectMeta getTemplateMeta() {
         return templateMeta;
     }
 
+    /**
+     * DetailsPerTemplate reports the current compliance state and list of recent compliance messages for a given policy template.
+     */
     @JsonProperty("templateMeta")
     public void setTemplateMeta(ObjectMeta templateMeta) {
         this.templateMeta = templateMeta;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/HubTemplateOptions.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/HubTemplateOptions.java
index 6da70e9806d..1fb99cc1702 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/HubTemplateOptions.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/HubTemplateOptions.java
@@ -78,11 +78,17 @@ public HubTemplateOptions(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * ServiceAccountName is the name of a service account in the same namespace as the policy to use for all hub template lookups. The service account must have list and watch permissions on any object the hub templates look up. If not specified, lookups are restricted to namespaced objects in the same namespace as the policy and to the `ManagedCluster` object associated with the propagated policy.
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * ServiceAccountName is the name of a service account in the same namespace as the policy to use for all hub template lookups. The service account must have list and watch permissions on any object the hub templates look up. If not specified, lookups are restricted to namespaced objects in the same namespace as the policy and to the `ManagedCluster` object associated with the propagated policy.
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/Placement.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/Placement.java
index 7331f401e25..a3c3e0009e6 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/Placement.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/Placement.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Placement reports how and what managed cluster placement resources are attached to the policy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -97,52 +100,82 @@ public Placement(List<PlacementDecision> decisions, String placement, String pla
         this.policySet = policySet;
     }
 
+    /**
+     * Decisions is the list of managed clusters returned by the placement resource for this binding.
+     */
     @JsonProperty("decisions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PlacementDecision> getDecisions() {
         return decisions;
     }
 
+    /**
+     * Decisions is the list of managed clusters returned by the placement resource for this binding.
+     */
     @JsonProperty("decisions")
     public void setDecisions(List<PlacementDecision> decisions) {
         this.decisions = decisions;
     }
 
+    /**
+     * Placement is the name of the Placement resource, from the cluster.open-cluster-management.io API group, that is bound to the policy.
+     */
     @JsonProperty("placement")
     public String getPlacement() {
         return placement;
     }
 
+    /**
+     * Placement is the name of the Placement resource, from the cluster.open-cluster-management.io API group, that is bound to the policy.
+     */
     @JsonProperty("placement")
     public void setPlacement(String placement) {
         this.placement = placement;
     }
 
+    /**
+     * PlacementBinding is the name of the PlacementBinding resource, from the policies.open-cluster-management.io API group, that binds the placement resource to the policy.
+     */
     @JsonProperty("placementBinding")
     public String getPlacementBinding() {
         return placementBinding;
     }
 
+    /**
+     * PlacementBinding is the name of the PlacementBinding resource, from the policies.open-cluster-management.io API group, that binds the placement resource to the policy.
+     */
     @JsonProperty("placementBinding")
     public void setPlacementBinding(String placementBinding) {
         this.placementBinding = placementBinding;
     }
 
+    /**
+     * PlacementRule (deprecated) is the name of the PlacementRule resource, from the apps.open-cluster-management.io API group, that is bound to the policy.
+     */
     @JsonProperty("placementRule")
     public String getPlacementRule() {
         return placementRule;
     }
 
+    /**
+     * PlacementRule (deprecated) is the name of the PlacementRule resource, from the apps.open-cluster-management.io API group, that is bound to the policy.
+     */
     @JsonProperty("placementRule")
     public void setPlacementRule(String placementRule) {
         this.placementRule = placementRule;
     }
 
+    /**
+     * PolicySet is the name of the policy set containing this policy and bound to the placement. If specified, then for this placement the policy is being propagated through this policy set rather than the policy being bound directly to a placement and propagated individually.
+     */
     @JsonProperty("policySet")
     public String getPolicySet() {
         return policySet;
     }
 
+    /**
+     * PolicySet is the name of the policy set containing this policy and bound to the placement. If specified, then for this placement the policy is being propagated through this policy set rather than the policy being bound directly to a placement and propagated individually.
+     */
     @JsonProperty("policySet")
     public void setPolicySet(String policySet) {
         this.policySet = policySet;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PlacementBinding.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PlacementBinding.java
index 0af6d95693c..19a33c6e002 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PlacementBinding.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PlacementBinding.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PlacementBinding is the schema for the placementbindings API. A PlacementBinding resource binds a managed cluster placement resource to a policy or policy set, along with configurable overrides.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,16 +84,10 @@
 public class PlacementBinding implements Editable<PlacementBindingBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "policy.open-cluster-management.io/v1";
     @JsonProperty("bindingOverrides")
     private BindingOverrides bindingOverrides;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PlacementBinding";
     @JsonProperty("metadata")
@@ -126,7 +123,7 @@ public PlacementBinding(String apiVersion, BindingOverrides bindingOverrides, St
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -134,25 +131,31 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PlacementBinding is the schema for the placementbindings API. A PlacementBinding resource binds a managed cluster placement resource to a policy or policy set, along with configurable overrides.
+     */
     @JsonProperty("bindingOverrides")
     public BindingOverrides getBindingOverrides() {
         return bindingOverrides;
     }
 
+    /**
+     * PlacementBinding is the schema for the placementbindings API. A PlacementBinding resource binds a managed cluster placement resource to a policy or policy set, along with configurable overrides.
+     */
     @JsonProperty("bindingOverrides")
     public void setBindingOverrides(BindingOverrides bindingOverrides) {
         this.bindingOverrides = bindingOverrides;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -160,59 +163,89 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PlacementBinding is the schema for the placementbindings API. A PlacementBinding resource binds a managed cluster placement resource to a policy or policy set, along with configurable overrides.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PlacementBinding is the schema for the placementbindings API. A PlacementBinding resource binds a managed cluster placement resource to a policy or policy set, along with configurable overrides.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PlacementBinding is the schema for the placementbindings API. A PlacementBinding resource binds a managed cluster placement resource to a policy or policy set, along with configurable overrides.
+     */
     @JsonProperty("placementRef")
     public PlacementSubject getPlacementRef() {
         return placementRef;
     }
 
+    /**
+     * PlacementBinding is the schema for the placementbindings API. A PlacementBinding resource binds a managed cluster placement resource to a policy or policy set, along with configurable overrides.
+     */
     @JsonProperty("placementRef")
     public void setPlacementRef(PlacementSubject placementRef) {
         this.placementRef = placementRef;
     }
 
+    /**
+     * PlacementBinding is the schema for the placementbindings API. A PlacementBinding resource binds a managed cluster placement resource to a policy or policy set, along with configurable overrides.
+     */
     @JsonProperty("status")
     public PlacementBindingStatus getStatus() {
         return status;
     }
 
+    /**
+     * PlacementBinding is the schema for the placementbindings API. A PlacementBinding resource binds a managed cluster placement resource to a policy or policy set, along with configurable overrides.
+     */
     @JsonProperty("status")
     public void setStatus(PlacementBindingStatus status) {
         this.status = status;
     }
 
+    /**
+     * PlacementBinding is the schema for the placementbindings API. A PlacementBinding resource binds a managed cluster placement resource to a policy or policy set, along with configurable overrides.
+     */
     @JsonProperty("subFilter")
     public String getSubFilter() {
         return subFilter;
     }
 
+    /**
+     * PlacementBinding is the schema for the placementbindings API. A PlacementBinding resource binds a managed cluster placement resource to a policy or policy set, along with configurable overrides.
+     */
     @JsonProperty("subFilter")
     public void setSubFilter(String subFilter) {
         this.subFilter = subFilter;
     }
 
+    /**
+     * PlacementBinding is the schema for the placementbindings API. A PlacementBinding resource binds a managed cluster placement resource to a policy or policy set, along with configurable overrides.
+     */
     @JsonProperty("subjects")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Subject> getSubjects() {
         return subjects;
     }
 
+    /**
+     * PlacementBinding is the schema for the placementbindings API. A PlacementBinding resource binds a managed cluster placement resource to a policy or policy set, along with configurable overrides.
+     */
     @JsonProperty("subjects")
     public void setSubjects(List<Subject> subjects) {
         this.subjects = subjects;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PlacementBindingList.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PlacementBindingList.java
index 543a39390ce..d7911bde104 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PlacementBindingList.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PlacementBindingList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PlacementBindingList contains a list of placement bindings.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PlacementBindingList implements Editable<PlacementBindingListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openclustermanagement.api.model.policy.v1.PlacementBinding>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "policy.open-cluster-management.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openclustermanagement.api.model.policy.v1.PlacementBinding> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PlacementBindingList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PlacementBindingList(String apiVersion, List<io.fabric8.openclustermanage
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PlacementBindingList contains a list of placement bindings.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openclustermanagement.api.model.policy.v1.PlacementBinding> getItems() {
         return items;
     }
 
+    /**
+     * PlacementBindingList contains a list of placement bindings.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openclustermanagement.api.model.policy.v1.PlacementBinding> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PlacementBindingList contains a list of placement bindings.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PlacementBindingList contains a list of placement bindings.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PlacementBindingStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PlacementBindingStatus.java
index 129911e7177..10a660127e1 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PlacementBindingStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PlacementBindingStatus.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PlacementBindingStatus defines the observed state of the PlacementBinding resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PlacementDecision.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PlacementDecision.java
index 40a8d56123b..bcb6cff2048 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PlacementDecision.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PlacementDecision.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PlacementDecision is the cluster name returned by the placement resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PlacementDecision(String clusterName, String clusterNamespace) {
         this.clusterNamespace = clusterNamespace;
     }
 
+    /**
+     * PlacementDecision is the cluster name returned by the placement resource.
+     */
     @JsonProperty("clusterName")
     public String getClusterName() {
         return clusterName;
     }
 
+    /**
+     * PlacementDecision is the cluster name returned by the placement resource.
+     */
     @JsonProperty("clusterName")
     public void setClusterName(String clusterName) {
         this.clusterName = clusterName;
     }
 
+    /**
+     * PlacementDecision is the cluster name returned by the placement resource.
+     */
     @JsonProperty("clusterNamespace")
     public String getClusterNamespace() {
         return clusterNamespace;
     }
 
+    /**
+     * PlacementDecision is the cluster name returned by the placement resource.
+     */
     @JsonProperty("clusterNamespace")
     public void setClusterNamespace(String clusterNamespace) {
         this.clusterNamespace = clusterNamespace;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PlacementSubject.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PlacementSubject.java
index f8ac467bf44..0f64c18072f 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PlacementSubject.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PlacementSubject.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PlacementSubject defines the placement resource that is being bound to the subjects defined in the placement binding.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public PlacementSubject(String apiGroup, String kind, String name) {
         this.name = name;
     }
 
+    /**
+     * APIGroup is the API group to which the kind belongs. Must be set to "cluster.open-cluster-management.io" for Placement or "apps.open-cluster-management.io" for PlacementRule (deprecated).
+     */
     @JsonProperty("apiGroup")
     public String getApiGroup() {
         return apiGroup;
     }
 
+    /**
+     * APIGroup is the API group to which the kind belongs. Must be set to "cluster.open-cluster-management.io" for Placement or "apps.open-cluster-management.io" for PlacementRule (deprecated).
+     */
     @JsonProperty("apiGroup")
     public void setApiGroup(String apiGroup) {
         this.apiGroup = apiGroup;
     }
 
+    /**
+     * Kind is the kind of the placement resource. Must be set to either "Placement" or "PlacementRule" (deprecated).
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is the kind of the placement resource. Must be set to either "Placement" or "PlacementRule" (deprecated).
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of the placement resource being bound.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the placement resource being bound.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/Policy.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/Policy.java
index 7711123c0f0..fccaf1792dc 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/Policy.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/Policy.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Policy is the schema for the policies API. Policy wraps other policy engine resources in its "policy-templates" array in order to deliver the resources to managed clusters.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Policy implements Editable<PolicyBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "policy.open-cluster-management.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Policy";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Policy(String apiVersion, String kind, ObjectMeta metadata, PolicySpec sp
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Policy is the schema for the policies API. Policy wraps other policy engine resources in its "policy-templates" array in order to deliver the resources to managed clusters.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Policy is the schema for the policies API. Policy wraps other policy engine resources in its "policy-templates" array in order to deliver the resources to managed clusters.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Policy is the schema for the policies API. Policy wraps other policy engine resources in its "policy-templates" array in order to deliver the resources to managed clusters.
+     */
     @JsonProperty("spec")
     public PolicySpec getSpec() {
         return spec;
     }
 
+    /**
+     * Policy is the schema for the policies API. Policy wraps other policy engine resources in its "policy-templates" array in order to deliver the resources to managed clusters.
+     */
     @JsonProperty("spec")
     public void setSpec(PolicySpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Policy is the schema for the policies API. Policy wraps other policy engine resources in its "policy-templates" array in order to deliver the resources to managed clusters.
+     */
     @JsonProperty("status")
     public PolicyStatus getStatus() {
         return status;
     }
 
+    /**
+     * Policy is the schema for the policies API. Policy wraps other policy engine resources in its "policy-templates" array in order to deliver the resources to managed clusters.
+     */
     @JsonProperty("status")
     public void setStatus(PolicyStatus status) {
         this.status = status;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PolicyDependency.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PolicyDependency.java
index 230ebb19ec5..08a4b54146a 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PolicyDependency.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PolicyDependency.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Each PolicyDependency defines an object reference which must be in a certain compliance state before the policy should be created.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,16 +79,10 @@
 public class PolicyDependency implements Editable<PolicyDependencyBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "policy.open-cluster-management.io/v1";
     @JsonProperty("compliance")
     private String compliance;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PolicyDependency";
     @JsonProperty("name")
@@ -111,7 +108,7 @@ public PolicyDependency(String apiVersion, String compliance, String kind, Strin
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,25 +116,31 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Compliance is the required ComplianceState of the object that the policy depends on, at the following path, .status.compliant.
+     */
     @JsonProperty("compliance")
     public String getCompliance() {
         return compliance;
     }
 
+    /**
+     * Compliance is the required ComplianceState of the object that the policy depends on, at the following path, .status.compliant.
+     */
     @JsonProperty("compliance")
     public void setCompliance(String compliance) {
         this.compliance = compliance;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -145,28 +148,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of the object that the policy depends on.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the object that the policy depends on.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace is the namespace of the object that the policy depends on (optional).
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace of the object that the policy depends on (optional).
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PolicyList.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PolicyList.java
index 2b446b89aa9..baf4aa29afe 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PolicyList.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PolicyList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PolicyList contains a list of policies.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PolicyList implements Editable<PolicyListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openclustermanagement.api.model.policy.v1.Policy>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "policy.open-cluster-management.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openclustermanagement.api.model.policy.v1.Policy> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PolicyList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PolicyList(String apiVersion, List<io.fabric8.openclustermanagement.api.m
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PolicyList contains a list of policies.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openclustermanagement.api.model.policy.v1.Policy> getItems() {
         return items;
     }
 
+    /**
+     * PolicyList contains a list of policies.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openclustermanagement.api.model.policy.v1.Policy> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PolicyList contains a list of policies.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PolicyList contains a list of policies.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PolicySpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PolicySpec.java
index def36f06b23..5f6784e575c 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PolicySpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PolicySpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PolicySpec defines the configurations of the policy engine resources to deliver to the managed clusters.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,63 +105,99 @@ public PolicySpec(Boolean copyPolicyMetadata, List<PolicyDependency> dependencie
         this.remediationAction = remediationAction;
     }
 
+    /**
+     * CopyPolicyMetadata specifies whether the labels and annotations of a policy should be copied when replicating the policy to a managed cluster. If set to "true", all of the labels and annotations of the policy are copied to the replicated policy. If set to "false", only the policy framework-specific policy labels and annotations are copied to the replicated policy. This setting is useful if there is tracking for metadata that should only exist on the root policy. It is recommended to set this to "false" when using Argo CD to deploy the policy definition since Argo CD uses metadata for tracking that should not be replicated. The default value is "true".
+     */
     @JsonProperty("copyPolicyMetadata")
     public Boolean getCopyPolicyMetadata() {
         return copyPolicyMetadata;
     }
 
+    /**
+     * CopyPolicyMetadata specifies whether the labels and annotations of a policy should be copied when replicating the policy to a managed cluster. If set to "true", all of the labels and annotations of the policy are copied to the replicated policy. If set to "false", only the policy framework-specific policy labels and annotations are copied to the replicated policy. This setting is useful if there is tracking for metadata that should only exist on the root policy. It is recommended to set this to "false" when using Argo CD to deploy the policy definition since Argo CD uses metadata for tracking that should not be replicated. The default value is "true".
+     */
     @JsonProperty("copyPolicyMetadata")
     public void setCopyPolicyMetadata(Boolean copyPolicyMetadata) {
         this.copyPolicyMetadata = copyPolicyMetadata;
     }
 
+    /**
+     * PolicyDependencies is a list of dependency objects detailed with extra considerations for compliance that should be fulfilled before applying the policies to the managed clusters.
+     */
     @JsonProperty("dependencies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PolicyDependency> getDependencies() {
         return dependencies;
     }
 
+    /**
+     * PolicyDependencies is a list of dependency objects detailed with extra considerations for compliance that should be fulfilled before applying the policies to the managed clusters.
+     */
     @JsonProperty("dependencies")
     public void setDependencies(List<PolicyDependency> dependencies) {
         this.dependencies = dependencies;
     }
 
+    /**
+     * Disabled is a boolean parameter you can use to enable and disable the policy. When disabled, the policy is removed from managed clusters.
+     */
     @JsonProperty("disabled")
     public Boolean getDisabled() {
         return disabled;
     }
 
+    /**
+     * Disabled is a boolean parameter you can use to enable and disable the policy. When disabled, the policy is removed from managed clusters.
+     */
     @JsonProperty("disabled")
     public void setDisabled(Boolean disabled) {
         this.disabled = disabled;
     }
 
+    /**
+     * PolicySpec defines the configurations of the policy engine resources to deliver to the managed clusters.
+     */
     @JsonProperty("hubTemplateOptions")
     public HubTemplateOptions getHubTemplateOptions() {
         return hubTemplateOptions;
     }
 
+    /**
+     * PolicySpec defines the configurations of the policy engine resources to deliver to the managed clusters.
+     */
     @JsonProperty("hubTemplateOptions")
     public void setHubTemplateOptions(HubTemplateOptions hubTemplateOptions) {
         this.hubTemplateOptions = hubTemplateOptions;
     }
 
+    /**
+     * PolicyTemplates is a list of definitions of policy engine resources to apply to managed clusters along with configurations on how it should be applied.
+     */
     @JsonProperty("policy-templates")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PolicyTemplate> getPolicyTemplates() {
         return policyTemplates;
     }
 
+    /**
+     * PolicyTemplates is a list of definitions of policy engine resources to apply to managed clusters along with configurations on how it should be applied.
+     */
     @JsonProperty("policy-templates")
     public void setPolicyTemplates(List<PolicyTemplate> policyTemplates) {
         this.policyTemplates = policyTemplates;
     }
 
+    /**
+     * RemediationAction specifies the remediation of the policy. The parameter values are "enforce" and "inform". If specified, the value that is defined overrides any remediationAction parameter defined in the child policies in the "policy-templates" section. Important: Not all policy engine kinds support the enforce feature.
+     */
     @JsonProperty("remediationAction")
     public String getRemediationAction() {
         return remediationAction;
     }
 
+    /**
+     * RemediationAction specifies the remediation of the policy. The parameter values are "enforce" and "inform". If specified, the value that is defined overrides any remediationAction parameter defined in the child policies in the "policy-templates" section. Important: Not all policy engine kinds support the enforce feature.
+     */
     @JsonProperty("remediationAction")
     public void setRemediationAction(String remediationAction) {
         this.remediationAction = remediationAction;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PolicyStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PolicyStatus.java
index 58645b56eae..df35d81c121 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PolicyStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PolicyStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PolicyStatus reports the observed status of the policy resulting from its policy templates.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,44 +98,68 @@ public PolicyStatus(String compliant, List<DetailsPerTemplate> details, List<Pla
         this.status = status;
     }
 
+    /**
+     * ComplianceState reports the observed status resulting from the definitions of this policy. This status field is only used in the replicated policy in the managed cluster namespace.
+     */
     @JsonProperty("compliant")
     public String getCompliant() {
         return compliant;
     }
 
+    /**
+     * ComplianceState reports the observed status resulting from the definitions of this policy. This status field is only used in the replicated policy in the managed cluster namespace.
+     */
     @JsonProperty("compliant")
     public void setCompliant(String compliant) {
         this.compliant = compliant;
     }
 
+    /**
+     * Details is the list of compliance details for each policy template definition. This status field is only used in the replicated policy in the managed cluster namespace.
+     */
     @JsonProperty("details")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DetailsPerTemplate> getDetails() {
         return details;
     }
 
+    /**
+     * Details is the list of compliance details for each policy template definition. This status field is only used in the replicated policy in the managed cluster namespace.
+     */
     @JsonProperty("details")
     public void setDetails(List<DetailsPerTemplate> details) {
         this.details = details;
     }
 
+    /**
+     * Placement is a list of managed cluster placement resources bound to the policy. This status field is only used in the root policy on the hub cluster.
+     */
     @JsonProperty("placement")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Placement> getPlacement() {
         return placement;
     }
 
+    /**
+     * Placement is a list of managed cluster placement resources bound to the policy. This status field is only used in the root policy on the hub cluster.
+     */
     @JsonProperty("placement")
     public void setPlacement(List<Placement> placement) {
         this.placement = placement;
     }
 
+    /**
+     * Status is a list of managed clusters and the current compliance state of each one. This status field is only used in the root policy on the hub cluster.
+     */
     @JsonProperty("status")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CompliancePerClusterStatus> getStatus() {
         return status;
     }
 
+    /**
+     * Status is a list of managed clusters and the current compliance state of each one. This status field is only used in the root policy on the hub cluster.
+     */
     @JsonProperty("status")
     public void setStatus(List<CompliancePerClusterStatus> status) {
         this.status = status;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PolicyTemplate.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PolicyTemplate.java
index 570c176a839..0f7f4c72b8a 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PolicyTemplate.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/PolicyTemplate.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PolicyTemplate is the definition of the policy engine resource to apply to the managed cluster, along with configurations on how it should be applied.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,32 +93,50 @@ public PolicyTemplate(List<PolicyDependency> extraDependencies, Boolean ignorePe
         this.objectDefinition = objectDefinition;
     }
 
+    /**
+     * ExtraDependencies is additional PolicyDependencies that only apply to this policy template. ExtraDependencies is a list of dependency objects detailed with extra considerations for compliance that should be fulfilled before applying the policy template to the managed clusters.
+     */
     @JsonProperty("extraDependencies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PolicyDependency> getExtraDependencies() {
         return extraDependencies;
     }
 
+    /**
+     * ExtraDependencies is additional PolicyDependencies that only apply to this policy template. ExtraDependencies is a list of dependency objects detailed with extra considerations for compliance that should be fulfilled before applying the policy template to the managed clusters.
+     */
     @JsonProperty("extraDependencies")
     public void setExtraDependencies(List<PolicyDependency> extraDependencies) {
         this.extraDependencies = extraDependencies;
     }
 
+    /**
+     * IgnorePending is a boolean parameter to specify whether to ignore the "Pending" status of this template when calculating the overall policy status. The default value is "false" to not ignore a "Pending" status.
+     */
     @JsonProperty("ignorePending")
     public Boolean getIgnorePending() {
         return ignorePending;
     }
 
+    /**
+     * IgnorePending is a boolean parameter to specify whether to ignore the "Pending" status of this template when calculating the overall policy status. The default value is "false" to not ignore a "Pending" status.
+     */
     @JsonProperty("ignorePending")
     public void setIgnorePending(Boolean ignorePending) {
         this.ignorePending = ignorePending;
     }
 
+    /**
+     * PolicyTemplate is the definition of the policy engine resource to apply to the managed cluster, along with configurations on how it should be applied.
+     */
     @JsonProperty("objectDefinition")
     public Object getObjectDefinition() {
         return objectDefinition;
     }
 
+    /**
+     * PolicyTemplate is the definition of the policy engine resource to apply to the managed cluster, along with configurations on how it should be applied.
+     */
     @JsonProperty("objectDefinition")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setObjectDefinition(Object objectDefinition) {
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/Subject.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/Subject.java
index 350c5711ace..04ac4bcc40c 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/Subject.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1/Subject.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Subject defines the resource to bind to the placement resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public Subject(String apiGroup, String kind, String name) {
         this.name = name;
     }
 
+    /**
+     * APIGroup is the API group to which the kind belongs. Must be set to "policy.open-cluster-management.io".
+     */
     @JsonProperty("apiGroup")
     public String getApiGroup() {
         return apiGroup;
     }
 
+    /**
+     * APIGroup is the API group to which the kind belongs. Must be set to "policy.open-cluster-management.io".
+     */
     @JsonProperty("apiGroup")
     public void setApiGroup(String apiGroup) {
         this.apiGroup = apiGroup;
     }
 
+    /**
+     * Kind is the kind of the object to bind to the placement resource. Must be set to either "Policy" or "PolicySet".
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is the kind of the object to bind to the placement resource. Must be set to either "Policy" or "PolicySet".
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of the policy or policy set to bind to the placement resource.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the policy or policy set to bind to the placement resource.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/AutomationDef.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/AutomationDef.java
index a2d90810c82..2f7da8ca41b 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/AutomationDef.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/AutomationDef.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AutomationDef defines the automation to invoke.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -99,62 +102,98 @@ public AutomationDef(Object extraVars, Integer jobTtl, String name, Integer poli
         this.type = type;
     }
 
+    /**
+     * AutomationDef defines the automation to invoke.
+     */
     @JsonProperty("extra_vars")
     public Object getExtraVars() {
         return extraVars;
     }
 
+    /**
+     * AutomationDef defines the automation to invoke.
+     */
     @JsonProperty("extra_vars")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setExtraVars(Object extraVars) {
         this.extraVars = extraVars;
     }
 
+    /**
+     * JobTTL sets the time to live for the Kubernetes Job object after the Ansible job playbook run has finished.
+     */
     @JsonProperty("jobTtl")
     public Integer getJobTtl() {
         return jobTtl;
     }
 
+    /**
+     * JobTTL sets the time to live for the Kubernetes Job object after the Ansible job playbook run has finished.
+     */
     @JsonProperty("jobTtl")
     public void setJobTtl(Integer jobTtl) {
         this.jobTtl = jobTtl;
     }
 
+    /**
+     * Name of the Ansible Template to run in Ansible Automation Platform as a job.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the Ansible Template to run in Ansible Automation Platform as a job.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * The maximum number of violating cluster contexts that are provided to the Ansible job as extra variables. When policyViolationsLimit is set to "0", it means no limit. The default value is "1000".
+     */
     @JsonProperty("policyViolationsLimit")
     public Integer getPolicyViolationsLimit() {
         return policyViolationsLimit;
     }
 
+    /**
+     * The maximum number of violating cluster contexts that are provided to the Ansible job as extra variables. When policyViolationsLimit is set to "0", it means no limit. The default value is "1000".
+     */
     @JsonProperty("policyViolationsLimit")
     public void setPolicyViolationsLimit(Integer policyViolationsLimit) {
         this.policyViolationsLimit = policyViolationsLimit;
     }
 
+    /**
+     * TowerSecret is the name of the secret that contains the Ansible Automation Platform credential.
+     */
     @JsonProperty("secret")
     public String getSecret() {
         return secret;
     }
 
+    /**
+     * TowerSecret is the name of the secret that contains the Ansible Automation Platform credential.
+     */
     @JsonProperty("secret")
     public void setSecret(String secret) {
         this.secret = secret;
     }
 
+    /**
+     * Type of the automation to invoke
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of the automation to invoke
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/ClusterEvent.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/ClusterEvent.java
index c88052ecacb..af471cf417e 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/ClusterEvent.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/ClusterEvent.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterEvent shows the PolicyAutomation event on each target cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ClusterEvent(String automationStartTime, String eventTime) {
         this.eventTime = eventTime;
     }
 
+    /**
+     * AutomationStartTime is the policy automation start time for everyEvent mode.
+     */
     @JsonProperty("automationStartTime")
     public String getAutomationStartTime() {
         return automationStartTime;
     }
 
+    /**
+     * AutomationStartTime is the policy automation start time for everyEvent mode.
+     */
     @JsonProperty("automationStartTime")
     public void setAutomationStartTime(String automationStartTime) {
         this.automationStartTime = automationStartTime;
     }
 
+    /**
+     * EventTime is the last policy compliance transition event time.
+     */
     @JsonProperty("eventTime")
     public String getEventTime() {
         return eventTime;
     }
 
+    /**
+     * EventTime is the last policy compliance transition event time.
+     */
     @JsonProperty("eventTime")
     public void setEventTime(String eventTime) {
         this.eventTime = eventTime;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicyAutomation.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicyAutomation.java
index 82ffae52c3e..90ce5cd77c7 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicyAutomation.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicyAutomation.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PolicyAutomation is the schema for the policyautomations API. PolicyAutomation configures creation of an AnsibleJob, from the tower.ansible.com API group, to initiate Ansible to run upon noncompliant events of the attached policy, or when you manually initiate the run with the "policy.open-cluster-management.io/rerun=true" annotation.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class PolicyAutomation implements Editable<PolicyAutomationBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "policy.open-cluster-management.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PolicyAutomation";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PolicyAutomation(String apiVersion, String kind, ObjectMeta metadata, Pol
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PolicyAutomation is the schema for the policyautomations API. PolicyAutomation configures creation of an AnsibleJob, from the tower.ansible.com API group, to initiate Ansible to run upon noncompliant events of the attached policy, or when you manually initiate the run with the "policy.open-cluster-management.io/rerun=true" annotation.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PolicyAutomation is the schema for the policyautomations API. PolicyAutomation configures creation of an AnsibleJob, from the tower.ansible.com API group, to initiate Ansible to run upon noncompliant events of the attached policy, or when you manually initiate the run with the "policy.open-cluster-management.io/rerun=true" annotation.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PolicyAutomation is the schema for the policyautomations API. PolicyAutomation configures creation of an AnsibleJob, from the tower.ansible.com API group, to initiate Ansible to run upon noncompliant events of the attached policy, or when you manually initiate the run with the "policy.open-cluster-management.io/rerun=true" annotation.
+     */
     @JsonProperty("spec")
     public PolicyAutomationSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PolicyAutomation is the schema for the policyautomations API. PolicyAutomation configures creation of an AnsibleJob, from the tower.ansible.com API group, to initiate Ansible to run upon noncompliant events of the attached policy, or when you manually initiate the run with the "policy.open-cluster-management.io/rerun=true" annotation.
+     */
     @JsonProperty("spec")
     public void setSpec(PolicyAutomationSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PolicyAutomation is the schema for the policyautomations API. PolicyAutomation configures creation of an AnsibleJob, from the tower.ansible.com API group, to initiate Ansible to run upon noncompliant events of the attached policy, or when you manually initiate the run with the "policy.open-cluster-management.io/rerun=true" annotation.
+     */
     @JsonProperty("status")
     public PolicyAutomationStatus getStatus() {
         return status;
     }
 
+    /**
+     * PolicyAutomation is the schema for the policyautomations API. PolicyAutomation configures creation of an AnsibleJob, from the tower.ansible.com API group, to initiate Ansible to run upon noncompliant events of the attached policy, or when you manually initiate the run with the "policy.open-cluster-management.io/rerun=true" annotation.
+     */
     @JsonProperty("status")
     public void setStatus(PolicyAutomationStatus status) {
         this.status = status;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicyAutomationList.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicyAutomationList.java
index b008802320f..c2d8a0c3122 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicyAutomationList.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicyAutomationList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PolicyAutomationList contains a list of policy automations.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PolicyAutomationList implements Editable<PolicyAutomationListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openclustermanagement.api.model.policy.v1beta1.PolicyAutomation>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "policy.open-cluster-management.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openclustermanagement.api.model.policy.v1beta1.PolicyAutomation> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PolicyAutomationList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PolicyAutomationList(String apiVersion, List<io.fabric8.openclustermanage
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PolicyAutomationList contains a list of policy automations.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openclustermanagement.api.model.policy.v1beta1.PolicyAutomation> getItems() {
         return items;
     }
 
+    /**
+     * PolicyAutomationList contains a list of policy automations.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openclustermanagement.api.model.policy.v1beta1.PolicyAutomation> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PolicyAutomationList contains a list of policy automations.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PolicyAutomationList contains a list of policy automations.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicyAutomationSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicyAutomationSpec.java
index d1f90d7b7cb..4216f158721 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicyAutomationSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicyAutomationSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PolicyAutomationSpec defines how and when automation is initiated for the referenced policy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public PolicyAutomationSpec(AutomationDef automationDef, Integer delayAfterRunSe
         this.rescanAfter = rescanAfter;
     }
 
+    /**
+     * PolicyAutomationSpec defines how and when automation is initiated for the referenced policy.
+     */
     @JsonProperty("automationDef")
     public AutomationDef getAutomationDef() {
         return automationDef;
     }
 
+    /**
+     * PolicyAutomationSpec defines how and when automation is initiated for the referenced policy.
+     */
     @JsonProperty("automationDef")
     public void setAutomationDef(AutomationDef automationDef) {
         this.automationDef = automationDef;
     }
 
+    /**
+     * DelayAfterRunSeconds sets the minimum number of seconds before an automation can run again due to a new violation on the same managed cluster. This only applies to the EveryEvent mode. The default value is "0".
+     */
     @JsonProperty("delayAfterRunSeconds")
     public Integer getDelayAfterRunSeconds() {
         return delayAfterRunSeconds;
     }
 
+    /**
+     * DelayAfterRunSeconds sets the minimum number of seconds before an automation can run again due to a new violation on the same managed cluster. This only applies to the EveryEvent mode. The default value is "0".
+     */
     @JsonProperty("delayAfterRunSeconds")
     public void setDelayAfterRunSeconds(Integer delayAfterRunSeconds) {
         this.delayAfterRunSeconds = delayAfterRunSeconds;
     }
 
+    /**
+     * EventHook specifies the compliance state that initiates automation. This must be set to "noncompliant".
+     */
     @JsonProperty("eventHook")
     public String getEventHook() {
         return eventHook;
     }
 
+    /**
+     * EventHook specifies the compliance state that initiates automation. This must be set to "noncompliant".
+     */
     @JsonProperty("eventHook")
     public void setEventHook(String eventHook) {
         this.eventHook = eventHook;
     }
 
+    /**
+     * PolicyAutomationSpec defines how and when automation is initiated for the referenced policy.
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * PolicyAutomationSpec defines how and when automation is initiated for the referenced policy.
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
     }
 
+    /**
+     * PolicyRef is the name of the policy that this automation resource is bound to.
+     */
     @JsonProperty("policyRef")
     public String getPolicyRef() {
         return policyRef;
     }
 
+    /**
+     * PolicyRef is the name of the policy that this automation resource is bound to.
+     */
     @JsonProperty("policyRef")
     public void setPolicyRef(String policyRef) {
         this.policyRef = policyRef;
     }
 
+    /**
+     * RescanAfter is reserved for future use and should not be set.
+     */
     @JsonProperty("rescanAfter")
     public String getRescanAfter() {
         return rescanAfter;
     }
 
+    /**
+     * RescanAfter is reserved for future use and should not be set.
+     */
     @JsonProperty("rescanAfter")
     public void setRescanAfter(String rescanAfter) {
         this.rescanAfter = rescanAfter;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicyAutomationStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicyAutomationStatus.java
index ed8a664e2ce..0fb883c4f6a 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicyAutomationStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicyAutomationStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PolicyAutomationStatus defines the observed state of the PolicyAutomation resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,12 +82,18 @@ public PolicyAutomationStatus(Map<String, ClusterEvent> clustersWithEvent) {
         this.clustersWithEvent = clustersWithEvent;
     }
 
+    /**
+     * Cluster name as the key of ClustersWithEvent
+     */
     @JsonProperty("clustersWithEvent")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, ClusterEvent> getClustersWithEvent() {
         return clustersWithEvent;
     }
 
+    /**
+     * Cluster name as the key of ClustersWithEvent
+     */
     @JsonProperty("clustersWithEvent")
     public void setClustersWithEvent(Map<String, ClusterEvent> clustersWithEvent) {
         this.clustersWithEvent = clustersWithEvent;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicySet.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicySet.java
index a42eef96988..6ca626637ae 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicySet.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicySet.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PolicySet is the schema for the policysets API. A policy set is a logical grouping of policies from the same namespace. The policy set is bound to a placement resource and applies the placement to all policies within the set. The status reports the overall compliance of the set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class PolicySet implements Editable<PolicySetBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "policy.open-cluster-management.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PolicySet";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PolicySet(String apiVersion, String kind, ObjectMeta metadata, PolicySetS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PolicySet is the schema for the policysets API. A policy set is a logical grouping of policies from the same namespace. The policy set is bound to a placement resource and applies the placement to all policies within the set. The status reports the overall compliance of the set.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PolicySet is the schema for the policysets API. A policy set is a logical grouping of policies from the same namespace. The policy set is bound to a placement resource and applies the placement to all policies within the set. The status reports the overall compliance of the set.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PolicySet is the schema for the policysets API. A policy set is a logical grouping of policies from the same namespace. The policy set is bound to a placement resource and applies the placement to all policies within the set. The status reports the overall compliance of the set.
+     */
     @JsonProperty("spec")
     public PolicySetSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PolicySet is the schema for the policysets API. A policy set is a logical grouping of policies from the same namespace. The policy set is bound to a placement resource and applies the placement to all policies within the set. The status reports the overall compliance of the set.
+     */
     @JsonProperty("spec")
     public void setSpec(PolicySetSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PolicySet is the schema for the policysets API. A policy set is a logical grouping of policies from the same namespace. The policy set is bound to a placement resource and applies the placement to all policies within the set. The status reports the overall compliance of the set.
+     */
     @JsonProperty("status")
     public PolicySetStatus getStatus() {
         return status;
     }
 
+    /**
+     * PolicySet is the schema for the policysets API. A policy set is a logical grouping of policies from the same namespace. The policy set is bound to a placement resource and applies the placement to all policies within the set. The status reports the overall compliance of the set.
+     */
     @JsonProperty("status")
     public void setStatus(PolicySetStatus status) {
         this.status = status;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicySetList.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicySetList.java
index 358807cab68..b301072b2b3 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicySetList.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicySetList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PolicySetList contains a list of policy sets.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PolicySetList implements Editable<PolicySetListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openclustermanagement.api.model.policy.v1beta1.PolicySet>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "policy.open-cluster-management.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openclustermanagement.api.model.policy.v1beta1.PolicySet> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PolicySetList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PolicySetList(String apiVersion, List<io.fabric8.openclustermanagement.ap
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PolicySetList contains a list of policy sets.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openclustermanagement.api.model.policy.v1beta1.PolicySet> getItems() {
         return items;
     }
 
+    /**
+     * PolicySetList contains a list of policy sets.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openclustermanagement.api.model.policy.v1beta1.PolicySet> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PolicySetList contains a list of policy sets.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PolicySetList contains a list of policy sets.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicySetSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicySetSpec.java
index 202a2886131..72aca01c71a 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicySetSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicySetSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PolicySetSpec defines the group of policies to be included in the policy set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public PolicySetSpec(String description, List<String> policies) {
         this.policies = policies;
     }
 
+    /**
+     * Description is the description of this policy set.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is the description of this policy set.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * Policies is a list of policy names that are contained within the policy set.
+     */
     @JsonProperty("policies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPolicies() {
         return policies;
     }
 
+    /**
+     * Policies is a list of policy names that are contained within the policy set.
+     */
     @JsonProperty("policies")
     public void setPolicies(List<String> policies) {
         this.policies = policies;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicySetStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicySetStatus.java
index e7916ba1a15..b90c7214b62 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicySetStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicySetStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PolicySetStatus reports the observed status of the policy set resulting from its policies.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public PolicySetStatus(String compliant, List<PolicySetStatusPlacement> placemen
         this.statusMessage = statusMessage;
     }
 
+    /**
+     * Compliant reports the observed status resulting from the compliance of the policies within.
+     */
     @JsonProperty("compliant")
     public String getCompliant() {
         return compliant;
     }
 
+    /**
+     * Compliant reports the observed status resulting from the compliance of the policies within.
+     */
     @JsonProperty("compliant")
     public void setCompliant(String compliant) {
         this.compliant = compliant;
     }
 
+    /**
+     * PolicySetStatus reports the observed status of the policy set resulting from its policies.
+     */
     @JsonProperty("placement")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PolicySetStatusPlacement> getPlacement() {
         return placement;
     }
 
+    /**
+     * PolicySetStatus reports the observed status of the policy set resulting from its policies.
+     */
     @JsonProperty("placement")
     public void setPlacement(List<PolicySetStatusPlacement> placement) {
         this.placement = placement;
     }
 
+    /**
+     * StatusMessge reports the current state while determining the compliance of the policy set.
+     */
     @JsonProperty("statusMessage")
     public String getStatusMessage() {
         return statusMessage;
     }
 
+    /**
+     * StatusMessge reports the current state while determining the compliance of the policy set.
+     */
     @JsonProperty("statusMessage")
     public void setStatusMessage(String statusMessage) {
         this.statusMessage = statusMessage;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicySetStatusPlacement.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicySetStatusPlacement.java
index aa0bf782804..ffa4232f3f7 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicySetStatusPlacement.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/PolicySetStatusPlacement.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PolicySetStatusPlacement reports how and what managed cluster placement resources are attached to the policy set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public PolicySetStatusPlacement(String placement, String placementBinding, Strin
         this.placementRule = placementRule;
     }
 
+    /**
+     * Placement is the name of the Placement resource, from the cluster.open-cluster-management.io API group, that is bound to the policy.
+     */
     @JsonProperty("placement")
     public String getPlacement() {
         return placement;
     }
 
+    /**
+     * Placement is the name of the Placement resource, from the cluster.open-cluster-management.io API group, that is bound to the policy.
+     */
     @JsonProperty("placement")
     public void setPlacement(String placement) {
         this.placement = placement;
     }
 
+    /**
+     * PlacementBinding is the name of the PlacementBinding resource, from the policies.open-cluster-management.io API group, that binds the placement resource to the policy set.
+     */
     @JsonProperty("placementBinding")
     public String getPlacementBinding() {
         return placementBinding;
     }
 
+    /**
+     * PlacementBinding is the name of the PlacementBinding resource, from the policies.open-cluster-management.io API group, that binds the placement resource to the policy set.
+     */
     @JsonProperty("placementBinding")
     public void setPlacementBinding(String placementBinding) {
         this.placementBinding = placementBinding;
     }
 
+    /**
+     * PlacementRule (deprecated) is the name of the PlacementRule resource, from the apps.open-cluster-management.io API group, that is bound to the policy.
+     */
     @JsonProperty("placementRule")
     public String getPlacementRule() {
         return placementRule;
     }
 
+    /**
+     * PlacementRule (deprecated) is the name of the PlacementRule resource, from the apps.open-cluster-management.io API group, that is bound to the policy.
+     */
     @JsonProperty("placementRule")
     public void setPlacementRule(String placementRule) {
         this.placementRule = placementRule;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/ReplicatedComplianceHistory.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/ReplicatedComplianceHistory.java
index a768f0a1cd7..95ac6a8bb99 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/ReplicatedComplianceHistory.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/ReplicatedComplianceHistory.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ReplicatedComplianceHistory defines the replicated policy compliance details history.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ReplicatedComplianceHistory(String lastTimestamp, String message) {
         this.message = message;
     }
 
+    /**
+     * ReplicatedComplianceHistory defines the replicated policy compliance details history.
+     */
     @JsonProperty("lastTimestamp")
     public String getLastTimestamp() {
         return lastTimestamp;
     }
 
+    /**
+     * ReplicatedComplianceHistory defines the replicated policy compliance details history.
+     */
     @JsonProperty("lastTimestamp")
     public void setLastTimestamp(String lastTimestamp) {
         this.lastTimestamp = lastTimestamp;
     }
 
+    /**
+     * ReplicatedComplianceHistory defines the replicated policy compliance details history.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * ReplicatedComplianceHistory defines the replicated policy compliance details history.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/ReplicatedDetailsPerTemplate.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/ReplicatedDetailsPerTemplate.java
index 7f6cf7c2046..846464c7c93 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/ReplicatedDetailsPerTemplate.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/ReplicatedDetailsPerTemplate.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ReplicatedDetailsPerTemplate defines the replicated policy compliance details and history.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public ReplicatedDetailsPerTemplate(String compliant, List<ReplicatedComplianceH
         this.history = history;
     }
 
+    /**
+     * ReplicatedDetailsPerTemplate defines the replicated policy compliance details and history.
+     */
     @JsonProperty("compliant")
     public String getCompliant() {
         return compliant;
     }
 
+    /**
+     * ReplicatedDetailsPerTemplate defines the replicated policy compliance details and history.
+     */
     @JsonProperty("compliant")
     public void setCompliant(String compliant) {
         this.compliant = compliant;
     }
 
+    /**
+     * ReplicatedDetailsPerTemplate defines the replicated policy compliance details and history.
+     */
     @JsonProperty("history")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ReplicatedComplianceHistory> getHistory() {
         return history;
     }
 
+    /**
+     * ReplicatedDetailsPerTemplate defines the replicated policy compliance details and history.
+     */
     @JsonProperty("history")
     public void setHistory(List<ReplicatedComplianceHistory> history) {
         this.history = history;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/ReplicatedPolicyStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/ReplicatedPolicyStatus.java
index 4d3d2b4a484..9f7aa294bac 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/ReplicatedPolicyStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/ReplicatedPolicyStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ReplicatedPolicyStatus defines the replicated policy status.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public ReplicatedPolicyStatus(String compliant, List<ReplicatedDetailsPerTemplat
         this.violationMessage = violationMessage;
     }
 
+    /**
+     * ReplicatedPolicyStatus defines the replicated policy status.
+     */
     @JsonProperty("compliant")
     public String getCompliant() {
         return compliant;
     }
 
+    /**
+     * ReplicatedPolicyStatus defines the replicated policy status.
+     */
     @JsonProperty("compliant")
     public void setCompliant(String compliant) {
         this.compliant = compliant;
     }
 
+    /**
+     * used by replicated policy
+     */
     @JsonProperty("details")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ReplicatedDetailsPerTemplate> getDetails() {
         return details;
     }
 
+    /**
+     * used by replicated policy
+     */
     @JsonProperty("details")
     public void setDetails(List<ReplicatedDetailsPerTemplate> details) {
         this.details = details;
     }
 
+    /**
+     * used by replicated policy
+     */
     @JsonProperty("violation_message")
     public String getViolationMessage() {
         return violationMessage;
     }
 
+    /**
+     * used by replicated policy
+     */
     @JsonProperty("violation_message")
     public void setViolationMessage(String violationMessage) {
         this.violationMessage = violationMessage;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/ViolationContext.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/ViolationContext.java
index ccffdc03d9e..c5ad9011aa9 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/ViolationContext.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/policy/v1beta1/ViolationContext.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ViolationContext defines the noncompliant replicated policy information that is sent to the AnsibleJob through the extra_vars parameter.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -103,64 +106,100 @@ public ViolationContext(String hubCluster, String policyName, String policyNames
         this.targetClusters = targetClusters;
     }
 
+    /**
+     * ViolationContext defines the noncompliant replicated policy information that is sent to the AnsibleJob through the extra_vars parameter.
+     */
     @JsonProperty("hubCluster")
     public String getHubCluster() {
         return hubCluster;
     }
 
+    /**
+     * ViolationContext defines the noncompliant replicated policy information that is sent to the AnsibleJob through the extra_vars parameter.
+     */
     @JsonProperty("hubCluster")
     public void setHubCluster(String hubCluster) {
         this.hubCluster = hubCluster;
     }
 
+    /**
+     * ViolationContext defines the noncompliant replicated policy information that is sent to the AnsibleJob through the extra_vars parameter.
+     */
     @JsonProperty("policyName")
     public String getPolicyName() {
         return policyName;
     }
 
+    /**
+     * ViolationContext defines the noncompliant replicated policy information that is sent to the AnsibleJob through the extra_vars parameter.
+     */
     @JsonProperty("policyName")
     public void setPolicyName(String policyName) {
         this.policyName = policyName;
     }
 
+    /**
+     * ViolationContext defines the noncompliant replicated policy information that is sent to the AnsibleJob through the extra_vars parameter.
+     */
     @JsonProperty("policyNamespace")
     public String getPolicyNamespace() {
         return policyNamespace;
     }
 
+    /**
+     * ViolationContext defines the noncompliant replicated policy information that is sent to the AnsibleJob through the extra_vars parameter.
+     */
     @JsonProperty("policyNamespace")
     public void setPolicyNamespace(String policyNamespace) {
         this.policyNamespace = policyNamespace;
     }
 
+    /**
+     * ViolationContext defines the noncompliant replicated policy information that is sent to the AnsibleJob through the extra_vars parameter.
+     */
     @JsonProperty("policySets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPolicySets() {
         return policySets;
     }
 
+    /**
+     * ViolationContext defines the noncompliant replicated policy information that is sent to the AnsibleJob through the extra_vars parameter.
+     */
     @JsonProperty("policySets")
     public void setPolicySets(List<String> policySets) {
         this.policySets = policySets;
     }
 
+    /**
+     * ViolationContext defines the noncompliant replicated policy information that is sent to the AnsibleJob through the extra_vars parameter.
+     */
     @JsonProperty("policyViolations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, ReplicatedPolicyStatus> getPolicyViolations() {
         return policyViolations;
     }
 
+    /**
+     * ViolationContext defines the noncompliant replicated policy information that is sent to the AnsibleJob through the extra_vars parameter.
+     */
     @JsonProperty("policyViolations")
     public void setPolicyViolations(Map<String, ReplicatedPolicyStatus> policyViolations) {
         this.policyViolations = policyViolations;
     }
 
+    /**
+     * ViolationContext defines the noncompliant replicated policy information that is sent to the AnsibleJob through the extra_vars parameter.
+     */
     @JsonProperty("targetClusters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getTargetClusters() {
         return targetClusters;
     }
 
+    /**
+     * ViolationContext defines the noncompliant replicated policy information that is sent to the AnsibleJob through the extra_vars parameter.
+     */
     @JsonProperty("targetClusters")
     public void setTargetClusters(List<String> targetClusters) {
         this.targetClusters = targetClusters;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/search/v1alpha1/DeploymentConfig.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/search/v1alpha1/DeploymentConfig.java
index a2b503f0d24..51fef945011 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/search/v1alpha1/DeploymentConfig.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/search/v1alpha1/DeploymentConfig.java
@@ -98,43 +98,67 @@ public DeploymentConfig(List<String> arguments, List<EnvVar> envVar, String imag
         this.resources = resources;
     }
 
+    /**
+     * Container Arguments
+     */
     @JsonProperty("arguments")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getArguments() {
         return arguments;
     }
 
+    /**
+     * Container Arguments
+     */
     @JsonProperty("arguments")
     public void setArguments(List<String> arguments) {
         this.arguments = arguments;
     }
 
+    /**
+     * Container Env variables
+     */
     @JsonProperty("envVar")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvVar> getEnvVar() {
         return envVar;
     }
 
+    /**
+     * Container Env variables
+     */
     @JsonProperty("envVar")
     public void setEnvVar(List<EnvVar> envVar) {
         this.envVar = envVar;
     }
 
+    /**
+     * Image_override
+     */
     @JsonProperty("imageOverride")
     public String getImageOverride() {
         return imageOverride;
     }
 
+    /**
+     * Image_override
+     */
     @JsonProperty("imageOverride")
     public void setImageOverride(String imageOverride) {
         this.imageOverride = imageOverride;
     }
 
+    /**
+     * Number of pod instances for the deployment.
+     */
     @JsonProperty("replicaCount")
     public Integer getReplicaCount() {
         return replicaCount;
     }
 
+    /**
+     * Number of pod instances for the deployment.
+     */
     @JsonProperty("replicaCount")
     public void setReplicaCount(Integer replicaCount) {
         this.replicaCount = replicaCount;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/search/v1alpha1/Search.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/search/v1alpha1/Search.java
index d0e2a9d51d0..12c8746057e 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/search/v1alpha1/Search.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/search/v1alpha1/Search.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Search is the schema for the searches API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Search implements Editable<SearchBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "search.open-cluster-management.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Search";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Search(String apiVersion, String kind, ObjectMeta metadata, SearchSpec sp
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Search is the schema for the searches API.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Search is the schema for the searches API.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Search is the schema for the searches API.
+     */
     @JsonProperty("spec")
     public SearchSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Search is the schema for the searches API.
+     */
     @JsonProperty("spec")
     public void setSpec(SearchSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Search is the schema for the searches API.
+     */
     @JsonProperty("status")
     public SearchStatus getStatus() {
         return status;
     }
 
+    /**
+     * Search is the schema for the searches API.
+     */
     @JsonProperty("status")
     public void setStatus(SearchStatus status) {
         this.status = status;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/search/v1alpha1/SearchList.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/search/v1alpha1/SearchList.java
index d149351df68..87048d7f472 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/search/v1alpha1/SearchList.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/search/v1alpha1/SearchList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SearchList contains a list of Search.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class SearchList implements Editable<SearchListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openclustermanagement.api.model.search.v1alpha1.Search>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "search.open-cluster-management.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openclustermanagement.api.model.search.v1alpha1.Search> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SearchList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public SearchList(String apiVersion, List<io.fabric8.openclustermanagement.api.m
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * SearchList contains a list of Search.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openclustermanagement.api.model.search.v1alpha1.Search> getItems() {
         return items;
     }
 
+    /**
+     * SearchList contains a list of Search.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openclustermanagement.api.model.search.v1alpha1.Search> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SearchList contains a list of Search.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SearchList contains a list of Search.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/search/v1alpha1/SearchSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/search/v1alpha1/SearchSpec.java
index cffee61b20f..ff14f3486b5 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/search/v1alpha1/SearchSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/search/v1alpha1/SearchSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SearchSpec defines the desired state of Search.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -115,93 +118,147 @@ public SearchSpec(String availabilityConfig, String dbConfig, StorageSpec dbStor
         this.tolerations = tolerations;
     }
 
+    /**
+     * [PLACEHOLDER, NOT IMPLEMENTED] Specifies deployment replication for improved availability. Options are: Basic and High (default)
+     */
     @JsonProperty("availabilityConfig")
     public String getAvailabilityConfig() {
         return availabilityConfig;
     }
 
+    /**
+     * [PLACEHOLDER, NOT IMPLEMENTED] Specifies deployment replication for improved availability. Options are: Basic and High (default)
+     */
     @JsonProperty("availabilityConfig")
     public void setAvailabilityConfig(String availabilityConfig) {
         this.availabilityConfig = availabilityConfig;
     }
 
+    /**
+     * The config map name contains parameters to override default database parameters.
+     */
     @JsonProperty("dbConfig")
     public String getDbConfig() {
         return dbConfig;
     }
 
+    /**
+     * The config map name contains parameters to override default database parameters.
+     */
     @JsonProperty("dbConfig")
     public void setDbConfig(String dbConfig) {
         this.dbConfig = dbConfig;
     }
 
+    /**
+     * SearchSpec defines the desired state of Search.
+     */
     @JsonProperty("dbStorage")
     public StorageSpec getDbStorage() {
         return dbStorage;
     }
 
+    /**
+     * SearchSpec defines the desired state of Search.
+     */
     @JsonProperty("dbStorage")
     public void setDbStorage(StorageSpec dbStorage) {
         this.dbStorage = dbStorage;
     }
 
+    /**
+     * SearchSpec defines the desired state of Search.
+     */
     @JsonProperty("deployments")
     public SearchDeployments getDeployments() {
         return deployments;
     }
 
+    /**
+     * SearchSpec defines the desired state of Search.
+     */
     @JsonProperty("deployments")
     public void setDeployments(SearchDeployments deployments) {
         this.deployments = deployments;
     }
 
+    /**
+     * [PLACEHOLDER, NOT IMPLEMENTED] Kubernetes secret name containing user provided db secret Secret should contain connection parameters [db_host, db_port, db_user, db_password, db_name, ca_cert] Not supported for development preview.
+     */
     @JsonProperty("externalDBInstance")
     public String getExternalDBInstance() {
         return externalDBInstance;
     }
 
+    /**
+     * [PLACEHOLDER, NOT IMPLEMENTED] Kubernetes secret name containing user provided db secret Secret should contain connection parameters [db_host, db_port, db_user, db_password, db_name, ca_cert] Not supported for development preview.
+     */
     @JsonProperty("externalDBInstance")
     public void setExternalDBInstance(String externalDBInstance) {
         this.externalDBInstance = externalDBInstance;
     }
 
+    /**
+     * ImagePullPolicy
+     */
     @JsonProperty("imagePullPolicy")
     public String getImagePullPolicy() {
         return imagePullPolicy;
     }
 
+    /**
+     * ImagePullPolicy
+     */
     @JsonProperty("imagePullPolicy")
     public void setImagePullPolicy(String imagePullPolicy) {
         this.imagePullPolicy = imagePullPolicy;
     }
 
+    /**
+     * ImagePullSecret
+     */
     @JsonProperty("imagePullSecret")
     public String getImagePullSecret() {
         return imagePullSecret;
     }
 
+    /**
+     * ImagePullSecret
+     */
     @JsonProperty("imagePullSecret")
     public void setImagePullSecret(String imagePullSecret) {
         this.imagePullSecret = imagePullSecret;
     }
 
+    /**
+     * Define the nodes that you want to schedule with matching labels.
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * Define the nodes that you want to schedule with matching labels.
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * Define tolerations to schedule pods on nodes with matching taints.
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * Define tolerations to schedule pods on nodes with matching taints.
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/search/v1alpha1/SearchStatus.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/search/v1alpha1/SearchStatus.java
index d8baebec4c0..e822b402a77 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/search/v1alpha1/SearchStatus.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/search/v1alpha1/SearchStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SearchStatus defines the observed state of Search.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,32 +93,50 @@ public SearchStatus(List<Condition> conditions, String db, String storage) {
         this.storage = storage;
     }
 
+    /**
+     * Conditions
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Database used by Search.
+     */
     @JsonProperty("db")
     public String getDb() {
         return db;
     }
 
+    /**
+     * Database used by Search.
+     */
     @JsonProperty("db")
     public void setDb(String db) {
         this.db = db;
     }
 
+    /**
+     * Storage used by database
+     */
     @JsonProperty("storage")
     public String getStorage() {
         return storage;
     }
 
+    /**
+     * Storage used by database
+     */
     @JsonProperty("storage")
     public void setStorage(String storage) {
         this.storage = storage;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/search/v1alpha1/StorageSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/search/v1alpha1/StorageSpec.java
index 0d7b02daffa..335949df1a7 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/search/v1alpha1/StorageSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/search/v1alpha1/StorageSpec.java
@@ -93,11 +93,17 @@ public void setSize(Quantity size) {
         this.size = size;
     }
 
+    /**
+     * name of the storage class
+     */
     @JsonProperty("storageClassName")
     public String getStorageClassName() {
         return storageClassName;
     }
 
+    /**
+     * name of the storage class
+     */
     @JsonProperty("storageClassName")
     public void setStorageClassName(String storageClassName) {
         this.storageClassName = storageClassName;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/shared/Condition.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/shared/Condition.java
index 17c8a7fc506..095fcf8e1d0 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/shared/Condition.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/shared/Condition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Condition is from metav1.Condition. Cannot use it directly because the upgrade issue. Have to mark LastTransitionTime and Status as optional.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public Condition(String lastTransitionTime, String message, Long observedGenerat
         this.type = type;
     }
 
+    /**
+     * Condition is from metav1.Condition. Cannot use it directly because the upgrade issue. Have to mark LastTransitionTime and Status as optional.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * Condition is from metav1.Condition. Cannot use it directly because the upgrade issue. Have to mark LastTransitionTime and Status as optional.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * message is a human readable message indicating details about the transition. This may be an empty string.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message is a human readable message indicating details about the transition. This may be an empty string.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * observedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date with respect to the current state of the instance.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date with respect to the current state of the instance.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * reason contains a programmatic identifier indicating the reason for the condition's last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * reason contains a programmatic identifier indicating the reason for the condition's last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * type of condition in CamelCase or in foo.example.com/CamelCase.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type of condition in CamelCase or in foo.example.com/CamelCase.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/shared/ObservabilityAddonSpec.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/shared/ObservabilityAddonSpec.java
index 9c495672fb6..80c7c14975b 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/shared/ObservabilityAddonSpec.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/shared/ObservabilityAddonSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ObservabilityAddonSpec is the spec of observability addon.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public ObservabilityAddonSpec(Boolean enableMetrics, Integer interval, ResourceR
         this.workers = workers;
     }
 
+    /**
+     * EnableMetrics indicates the observability addon push metrics to hub server.
+     */
     @JsonProperty("enableMetrics")
     public Boolean getEnableMetrics() {
         return enableMetrics;
     }
 
+    /**
+     * EnableMetrics indicates the observability addon push metrics to hub server.
+     */
     @JsonProperty("enableMetrics")
     public void setEnableMetrics(Boolean enableMetrics) {
         this.enableMetrics = enableMetrics;
     }
 
+    /**
+     * Interval for the observability addon push metrics to hub server.
+     */
     @JsonProperty("interval")
     public Integer getInterval() {
         return interval;
     }
 
+    /**
+     * Interval for the observability addon push metrics to hub server.
+     */
     @JsonProperty("interval")
     public void setInterval(Integer interval) {
         this.interval = interval;
     }
 
+    /**
+     * ObservabilityAddonSpec is the spec of observability addon.
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * ObservabilityAddonSpec is the spec of observability addon.
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * ScrapeSizeLimitBytes is the max size in bytes for a single metrics scrape from in-cluster Prometheus. Default is 1 GiB.
+     */
     @JsonProperty("scrapeSizeLimitBytes")
     public Integer getScrapeSizeLimitBytes() {
         return scrapeSizeLimitBytes;
     }
 
+    /**
+     * ScrapeSizeLimitBytes is the max size in bytes for a single metrics scrape from in-cluster Prometheus. Default is 1 GiB.
+     */
     @JsonProperty("scrapeSizeLimitBytes")
     public void setScrapeSizeLimitBytes(Integer scrapeSizeLimitBytes) {
         this.scrapeSizeLimitBytes = scrapeSizeLimitBytes;
     }
 
+    /**
+     * Workers is the number of workers in metrics-collector that work in parallel to push metrics to hub server. If set to &gt; 1, metrics-collector will shard /federate calls to Prometheus, based on matcher rules provided by allowlist. Ensure that number of matchers exceeds number of workers.
+     */
     @JsonProperty("workers")
     public Integer getWorkers() {
         return workers;
     }
 
+    /**
+     * Workers is the number of workers in metrics-collector that work in parallel to push metrics to hub server. If set to &gt; 1, metrics-collector will shard /federate calls to Prometheus, based on matcher rules provided by allowlist. Ensure that number of matchers exceeds number of workers.
+     */
     @JsonProperty("workers")
     public void setWorkers(Integer workers) {
         this.workers = workers;
diff --git a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/shared/PreConfiguredStorage.java b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/shared/PreConfiguredStorage.java
index 6d7fd680fe9..0a59b31af93 100644
--- a/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/shared/PreConfiguredStorage.java
+++ b/extensions/open-cluster-management/model/src/generated/java/io/fabric8/openclustermanagement/api/model/shared/PreConfiguredStorage.java
@@ -94,51 +94,81 @@ public PreConfiguredStorage(String key, String name, Boolean serviceAccountProje
         this.tlsSecretName = tlsSecretName;
     }
 
+    /**
+     * The key of the secret to select from. Must be a valid secret key. Refer to https://thanos.io/tip/thanos/storage.md/#configuring-access-to-object-storage for a valid content of key.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * The key of the secret to select from. Must be a valid secret key. Refer to https://thanos.io/tip/thanos/storage.md/#configuring-access-to-object-storage for a valid content of key.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * serviceAccountProjection indicates whether mount service account token to thanos pods. Default is false.
+     */
     @JsonProperty("serviceAccountProjection")
     public Boolean getServiceAccountProjection() {
         return serviceAccountProjection;
     }
 
+    /**
+     * serviceAccountProjection indicates whether mount service account token to thanos pods. Default is false.
+     */
     @JsonProperty("serviceAccountProjection")
     public void setServiceAccountProjection(Boolean serviceAccountProjection) {
         this.serviceAccountProjection = serviceAccountProjection;
     }
 
+    /**
+     * TLS secret mount path for the custom certificate for the object store
+     */
     @JsonProperty("tlsSecretMountPath")
     public String getTlsSecretMountPath() {
         return tlsSecretMountPath;
     }
 
+    /**
+     * TLS secret mount path for the custom certificate for the object store
+     */
     @JsonProperty("tlsSecretMountPath")
     public void setTlsSecretMountPath(String tlsSecretMountPath) {
         this.tlsSecretMountPath = tlsSecretMountPath;
     }
 
+    /**
+     * TLS secret contains the custom certificate for the object store
+     */
     @JsonProperty("tlsSecretName")
     public String getTlsSecretName() {
         return tlsSecretName;
     }
 
+    /**
+     * TLS secret contains the custom certificate for the object store
+     */
     @JsonProperty("tlsSecretName")
     public void setTlsSecretName(String tlsSecretName) {
         this.tlsSecretName = tlsSecretName;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/AdminPolicyBasedExternalRoute.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/AdminPolicyBasedExternalRoute.java
index 806be68151d..2160b0b527c 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/AdminPolicyBasedExternalRoute.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/AdminPolicyBasedExternalRoute.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AdminPolicyBasedExternalRoute is a CRD allowing the cluster administrators to configure policies for external gateway IPs to be applied to all the pods contained in selected namespaces. Egress traffic from the pods that belong to the selected namespaces to outside the cluster is routed through these external gateway IPs.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class AdminPolicyBasedExternalRoute implements Editable<AdminPolicyBasedExternalRouteBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "k8s.ovn.org/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AdminPolicyBasedExternalRoute";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public AdminPolicyBasedExternalRoute(String apiVersion, String kind, ObjectMeta
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AdminPolicyBasedExternalRoute is a CRD allowing the cluster administrators to configure policies for external gateway IPs to be applied to all the pods contained in selected namespaces. Egress traffic from the pods that belong to the selected namespaces to outside the cluster is routed through these external gateway IPs.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AdminPolicyBasedExternalRoute is a CRD allowing the cluster administrators to configure policies for external gateway IPs to be applied to all the pods contained in selected namespaces. Egress traffic from the pods that belong to the selected namespaces to outside the cluster is routed through these external gateway IPs.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * AdminPolicyBasedExternalRoute is a CRD allowing the cluster administrators to configure policies for external gateway IPs to be applied to all the pods contained in selected namespaces. Egress traffic from the pods that belong to the selected namespaces to outside the cluster is routed through these external gateway IPs.
+     */
     @JsonProperty("spec")
     public AdminPolicyBasedExternalRouteSpec getSpec() {
         return spec;
     }
 
+    /**
+     * AdminPolicyBasedExternalRoute is a CRD allowing the cluster administrators to configure policies for external gateway IPs to be applied to all the pods contained in selected namespaces. Egress traffic from the pods that belong to the selected namespaces to outside the cluster is routed through these external gateway IPs.
+     */
     @JsonProperty("spec")
     public void setSpec(AdminPolicyBasedExternalRouteSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * AdminPolicyBasedExternalRoute is a CRD allowing the cluster administrators to configure policies for external gateway IPs to be applied to all the pods contained in selected namespaces. Egress traffic from the pods that belong to the selected namespaces to outside the cluster is routed through these external gateway IPs.
+     */
     @JsonProperty("status")
     public AdminPolicyBasedRouteStatus getStatus() {
         return status;
     }
 
+    /**
+     * AdminPolicyBasedExternalRoute is a CRD allowing the cluster administrators to configure policies for external gateway IPs to be applied to all the pods contained in selected namespaces. Egress traffic from the pods that belong to the selected namespaces to outside the cluster is routed through these external gateway IPs.
+     */
     @JsonProperty("status")
     public void setStatus(AdminPolicyBasedRouteStatus status) {
         this.status = status;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/AdminPolicyBasedExternalRouteList.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/AdminPolicyBasedExternalRouteList.java
index 0344e502476..39e7726d2f3 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/AdminPolicyBasedExternalRouteList.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/AdminPolicyBasedExternalRouteList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AdminPolicyBasedExternalRouteList contains a list of AdminPolicyBasedExternalRoutes
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class AdminPolicyBasedExternalRouteList implements Editable<AdminPolicyBasedExternalRouteListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.ovn.v1.AdminPolicyBasedExternalRoute>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "k8s.ovn.org/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.ovn.v1.AdminPolicyBasedExternalRoute> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AdminPolicyBasedExternalRouteList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public AdminPolicyBasedExternalRouteList(String apiVersion, List<io.fabric8.kube
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * AdminPolicyBasedExternalRouteList contains a list of AdminPolicyBasedExternalRoutes
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.ovn.v1.AdminPolicyBasedExternalRoute> getItems() {
         return items;
     }
 
+    /**
+     * AdminPolicyBasedExternalRouteList contains a list of AdminPolicyBasedExternalRoutes
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.ovn.v1.AdminPolicyBasedExternalRoute> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AdminPolicyBasedExternalRouteList contains a list of AdminPolicyBasedExternalRoutes
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AdminPolicyBasedExternalRouteList contains a list of AdminPolicyBasedExternalRoutes
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/AdminPolicyBasedExternalRouteSpec.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/AdminPolicyBasedExternalRouteSpec.java
index 28478de2ef6..cf4847e369c 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/AdminPolicyBasedExternalRouteSpec.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/AdminPolicyBasedExternalRouteSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AdminPolicyBasedExternalRouteSpec defines the desired state of AdminPolicyBasedExternalRoute
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public AdminPolicyBasedExternalRouteSpec(ExternalNetworkSource from, ExternalNex
         this.nextHops = nextHops;
     }
 
+    /**
+     * AdminPolicyBasedExternalRouteSpec defines the desired state of AdminPolicyBasedExternalRoute
+     */
     @JsonProperty("from")
     public ExternalNetworkSource getFrom() {
         return from;
     }
 
+    /**
+     * AdminPolicyBasedExternalRouteSpec defines the desired state of AdminPolicyBasedExternalRoute
+     */
     @JsonProperty("from")
     public void setFrom(ExternalNetworkSource from) {
         this.from = from;
     }
 
+    /**
+     * AdminPolicyBasedExternalRouteSpec defines the desired state of AdminPolicyBasedExternalRoute
+     */
     @JsonProperty("nextHops")
     public ExternalNextHops getNextHops() {
         return nextHops;
     }
 
+    /**
+     * AdminPolicyBasedExternalRouteSpec defines the desired state of AdminPolicyBasedExternalRoute
+     */
     @JsonProperty("nextHops")
     public void setNextHops(ExternalNextHops nextHops) {
         this.nextHops = nextHops;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/AdminPolicyBasedRouteStatus.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/AdminPolicyBasedRouteStatus.java
index b29236d6d3e..0780800c3c3 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/AdminPolicyBasedRouteStatus.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/AdminPolicyBasedRouteStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AdminPolicyBasedRouteStatus contains the observed status of the AdminPolicyBased route types.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public AdminPolicyBasedRouteStatus(String lastTransitionTime, List<String> messa
         this.status = status;
     }
 
+    /**
+     * AdminPolicyBasedRouteStatus contains the observed status of the AdminPolicyBased route types.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * AdminPolicyBasedRouteStatus contains the observed status of the AdminPolicyBased route types.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * An array of Human-readable messages indicating details about the status of the object.
+     */
     @JsonProperty("messages")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMessages() {
         return messages;
     }
 
+    /**
+     * An array of Human-readable messages indicating details about the status of the object.
+     */
     @JsonProperty("messages")
     public void setMessages(List<String> messages) {
         this.messages = messages;
     }
 
+    /**
+     * A concise indication of whether the AdminPolicyBasedRoute resource is applied with success
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * A concise indication of whether the AdminPolicyBasedRoute resource is applied with success
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/DynamicHop.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/DynamicHop.java
index 0ad41cdfc63..3cb827474b4 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/DynamicHop.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/DynamicHop.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DynamicHop defines the configuration for a dynamic external gateway interface. These interfaces are wrapped around a pod object that resides inside the cluster. The field NetworkAttachmentName captures the name of the multus network name to use when retrieving the gateway IP to use. The PodSelector and the NamespaceSelector are mandatory fields.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public DynamicHop(Boolean bfdEnabled, LabelSelector namespaceSelector, String ne
         this.podSelector = podSelector;
     }
 
+    /**
+     * BFDEnabled determines if the interface implements the Bidirectional Forward Detection protocol. Defaults to false.
+     */
     @JsonProperty("bfdEnabled")
     public Boolean getBfdEnabled() {
         return bfdEnabled;
     }
 
+    /**
+     * BFDEnabled determines if the interface implements the Bidirectional Forward Detection protocol. Defaults to false.
+     */
     @JsonProperty("bfdEnabled")
     public void setBfdEnabled(Boolean bfdEnabled) {
         this.bfdEnabled = bfdEnabled;
     }
 
+    /**
+     * DynamicHop defines the configuration for a dynamic external gateway interface. These interfaces are wrapped around a pod object that resides inside the cluster. The field NetworkAttachmentName captures the name of the multus network name to use when retrieving the gateway IP to use. The PodSelector and the NamespaceSelector are mandatory fields.
+     */
     @JsonProperty("namespaceSelector")
     public LabelSelector getNamespaceSelector() {
         return namespaceSelector;
     }
 
+    /**
+     * DynamicHop defines the configuration for a dynamic external gateway interface. These interfaces are wrapped around a pod object that resides inside the cluster. The field NetworkAttachmentName captures the name of the multus network name to use when retrieving the gateway IP to use. The PodSelector and the NamespaceSelector are mandatory fields.
+     */
     @JsonProperty("namespaceSelector")
     public void setNamespaceSelector(LabelSelector namespaceSelector) {
         this.namespaceSelector = namespaceSelector;
     }
 
+    /**
+     * NetworkAttachmentName determines the multus network name to use when retrieving the pod IPs that will be used as the gateway IP. When this field is empty, the logic assumes that the pod is configured with HostNetwork and is using the node's IP as gateway.
+     */
     @JsonProperty("networkAttachmentName")
     public String getNetworkAttachmentName() {
         return networkAttachmentName;
     }
 
+    /**
+     * NetworkAttachmentName determines the multus network name to use when retrieving the pod IPs that will be used as the gateway IP. When this field is empty, the logic assumes that the pod is configured with HostNetwork and is using the node's IP as gateway.
+     */
     @JsonProperty("networkAttachmentName")
     public void setNetworkAttachmentName(String networkAttachmentName) {
         this.networkAttachmentName = networkAttachmentName;
     }
 
+    /**
+     * DynamicHop defines the configuration for a dynamic external gateway interface. These interfaces are wrapped around a pod object that resides inside the cluster. The field NetworkAttachmentName captures the name of the multus network name to use when retrieving the gateway IP to use. The PodSelector and the NamespaceSelector are mandatory fields.
+     */
     @JsonProperty("podSelector")
     public LabelSelector getPodSelector() {
         return podSelector;
     }
 
+    /**
+     * DynamicHop defines the configuration for a dynamic external gateway interface. These interfaces are wrapped around a pod object that resides inside the cluster. The field NetworkAttachmentName captures the name of the multus network name to use when retrieving the gateway IP to use. The PodSelector and the NamespaceSelector are mandatory fields.
+     */
     @JsonProperty("podSelector")
     public void setPodSelector(LabelSelector podSelector) {
         this.podSelector = podSelector;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressFirewall.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressFirewall.java
index e2e4aefbfe2..be136573a01 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressFirewall.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressFirewall.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressFirewall describes the current egress firewall for a Namespace. Traffic from a pod to an IP address outside the cluster will be checked against each EgressFirewallRule in the pod's namespace's EgressFirewall, in order. If no rule matches (or no EgressFirewall is present) then the traffic will be allowed by default.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class EgressFirewall implements Editable<EgressFirewallBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "k8s.ovn.org/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EgressFirewall";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EgressFirewall(String apiVersion, String kind, ObjectMeta metadata, Egres
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EgressFirewall describes the current egress firewall for a Namespace. Traffic from a pod to an IP address outside the cluster will be checked against each EgressFirewallRule in the pod's namespace's EgressFirewall, in order. If no rule matches (or no EgressFirewall is present) then the traffic will be allowed by default.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EgressFirewall describes the current egress firewall for a Namespace. Traffic from a pod to an IP address outside the cluster will be checked against each EgressFirewallRule in the pod's namespace's EgressFirewall, in order. If no rule matches (or no EgressFirewall is present) then the traffic will be allowed by default.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * EgressFirewall describes the current egress firewall for a Namespace. Traffic from a pod to an IP address outside the cluster will be checked against each EgressFirewallRule in the pod's namespace's EgressFirewall, in order. If no rule matches (or no EgressFirewall is present) then the traffic will be allowed by default.
+     */
     @JsonProperty("spec")
     public EgressFirewallSpec getSpec() {
         return spec;
     }
 
+    /**
+     * EgressFirewall describes the current egress firewall for a Namespace. Traffic from a pod to an IP address outside the cluster will be checked against each EgressFirewallRule in the pod's namespace's EgressFirewall, in order. If no rule matches (or no EgressFirewall is present) then the traffic will be allowed by default.
+     */
     @JsonProperty("spec")
     public void setSpec(EgressFirewallSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * EgressFirewall describes the current egress firewall for a Namespace. Traffic from a pod to an IP address outside the cluster will be checked against each EgressFirewallRule in the pod's namespace's EgressFirewall, in order. If no rule matches (or no EgressFirewall is present) then the traffic will be allowed by default.
+     */
     @JsonProperty("status")
     public EgressFirewallStatus getStatus() {
         return status;
     }
 
+    /**
+     * EgressFirewall describes the current egress firewall for a Namespace. Traffic from a pod to an IP address outside the cluster will be checked against each EgressFirewallRule in the pod's namespace's EgressFirewall, in order. If no rule matches (or no EgressFirewall is present) then the traffic will be allowed by default.
+     */
     @JsonProperty("status")
     public void setStatus(EgressFirewallStatus status) {
         this.status = status;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressFirewallDestination.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressFirewallDestination.java
index 635768c8f90..30ff8915b90 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressFirewallDestination.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressFirewallDestination.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressFirewallDestination is the target that traffic is either allowed or denied to
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public EgressFirewallDestination(String cidrSelector, String dnsName, LabelSelec
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * cidrSelector is the CIDR range to allow/deny traffic to. If this is set, dnsName and nodeSelector must be unset.
+     */
     @JsonProperty("cidrSelector")
     public String getCidrSelector() {
         return cidrSelector;
     }
 
+    /**
+     * cidrSelector is the CIDR range to allow/deny traffic to. If this is set, dnsName and nodeSelector must be unset.
+     */
     @JsonProperty("cidrSelector")
     public void setCidrSelector(String cidrSelector) {
         this.cidrSelector = cidrSelector;
     }
 
+    /**
+     * dnsName is the domain name to allow/deny traffic to. If this is set, cidrSelector and nodeSelector must be unset. For a wildcard DNS name, the '&#42;' will match only one label. Additionally, only a single '&#42;' can be used at the beginning of the wildcard DNS name. For example, '&#42;.example.com' will match 'sub1.example.com' but won't match 'sub2.sub1.example.com'.
+     */
     @JsonProperty("dnsName")
     public String getDnsName() {
         return dnsName;
     }
 
+    /**
+     * dnsName is the domain name to allow/deny traffic to. If this is set, cidrSelector and nodeSelector must be unset. For a wildcard DNS name, the '&#42;' will match only one label. Additionally, only a single '&#42;' can be used at the beginning of the wildcard DNS name. For example, '&#42;.example.com' will match 'sub1.example.com' but won't match 'sub2.sub1.example.com'.
+     */
     @JsonProperty("dnsName")
     public void setDnsName(String dnsName) {
         this.dnsName = dnsName;
     }
 
+    /**
+     * EgressFirewallDestination is the target that traffic is either allowed or denied to
+     */
     @JsonProperty("nodeSelector")
     public LabelSelector getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * EgressFirewallDestination is the target that traffic is either allowed or denied to
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(LabelSelector nodeSelector) {
         this.nodeSelector = nodeSelector;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressFirewallList.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressFirewallList.java
index 4a7d7b4cbfd..b5695e725af 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressFirewallList.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressFirewallList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressFirewallList is the list of EgressFirewalls.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class EgressFirewallList implements Editable<EgressFirewallListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.ovn.v1.EgressFirewall>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "k8s.ovn.org/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.ovn.v1.EgressFirewall> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EgressFirewallList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EgressFirewallList(String apiVersion, List<io.fabric8.kubernetes.api.mode
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of EgressFirewalls.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.ovn.v1.EgressFirewall> getItems() {
         return items;
     }
 
+    /**
+     * List of EgressFirewalls.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.ovn.v1.EgressFirewall> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EgressFirewallList is the list of EgressFirewalls.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EgressFirewallList is the list of EgressFirewalls.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressFirewallPort.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressFirewallPort.java
index 03869ce36c0..179f677565b 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressFirewallPort.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressFirewallPort.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressFirewallPort specifies the port to allow or deny traffic to
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public EgressFirewallPort(Integer port, String protocol) {
         this.protocol = protocol;
     }
 
+    /**
+     * port that the traffic must match
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * port that the traffic must match
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * protocol (tcp, udp, sctp) that the traffic must match.
+     */
     @JsonProperty("protocol")
     public String getProtocol() {
         return protocol;
     }
 
+    /**
+     * protocol (tcp, udp, sctp) that the traffic must match.
+     */
     @JsonProperty("protocol")
     public void setProtocol(String protocol) {
         this.protocol = protocol;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressFirewallRule.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressFirewallRule.java
index dffeba0878e..114906b4b83 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressFirewallRule.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressFirewallRule.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressFirewallRule is a single egressfirewall rule object
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public EgressFirewallRule(List<EgressFirewallPort> ports, EgressFirewallDestinat
         this.type = type;
     }
 
+    /**
+     * ports specify what ports and protocols the rule applies to
+     */
     @JsonProperty("ports")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EgressFirewallPort> getPorts() {
         return ports;
     }
 
+    /**
+     * ports specify what ports and protocols the rule applies to
+     */
     @JsonProperty("ports")
     public void setPorts(List<EgressFirewallPort> ports) {
         this.ports = ports;
     }
 
+    /**
+     * EgressFirewallRule is a single egressfirewall rule object
+     */
     @JsonProperty("to")
     public EgressFirewallDestination getTo() {
         return to;
     }
 
+    /**
+     * EgressFirewallRule is a single egressfirewall rule object
+     */
     @JsonProperty("to")
     public void setTo(EgressFirewallDestination to) {
         this.to = to;
     }
 
+    /**
+     * type marks this as an "Allow" or "Deny" rule
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type marks this as an "Allow" or "Deny" rule
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressFirewallSpec.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressFirewallSpec.java
index bb13a059ea8..79ec1012a4e 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressFirewallSpec.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressFirewallSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressFirewallSpec is a desired state description of EgressFirewall.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public EgressFirewallSpec(List<EgressFirewallRule> egress) {
         this.egress = egress;
     }
 
+    /**
+     * a collection of egress firewall rule objects
+     */
     @JsonProperty("egress")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EgressFirewallRule> getEgress() {
         return egress;
     }
 
+    /**
+     * a collection of egress firewall rule objects
+     */
     @JsonProperty("egress")
     public void setEgress(List<EgressFirewallRule> egress) {
         this.egress = egress;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressIP.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressIP.java
index a80fdd98c75..4b470489260 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressIP.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressIP.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressIP is a CRD allowing the user to define a fixed source IP for all egress traffic originating from any pods which match the EgressIP resource according to its spec definition.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class EgressIP implements Editable<EgressIPBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "k8s.ovn.org/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EgressIP";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public EgressIP(String apiVersion, String kind, ObjectMeta metadata, EgressIPSpe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EgressIP is a CRD allowing the user to define a fixed source IP for all egress traffic originating from any pods which match the EgressIP resource according to its spec definition.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EgressIP is a CRD allowing the user to define a fixed source IP for all egress traffic originating from any pods which match the EgressIP resource according to its spec definition.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * EgressIP is a CRD allowing the user to define a fixed source IP for all egress traffic originating from any pods which match the EgressIP resource according to its spec definition.
+     */
     @JsonProperty("spec")
     public EgressIPSpec getSpec() {
         return spec;
     }
 
+    /**
+     * EgressIP is a CRD allowing the user to define a fixed source IP for all egress traffic originating from any pods which match the EgressIP resource according to its spec definition.
+     */
     @JsonProperty("spec")
     public void setSpec(EgressIPSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * EgressIP is a CRD allowing the user to define a fixed source IP for all egress traffic originating from any pods which match the EgressIP resource according to its spec definition.
+     */
     @JsonProperty("status")
     public EgressIPStatus getStatus() {
         return status;
     }
 
+    /**
+     * EgressIP is a CRD allowing the user to define a fixed source IP for all egress traffic originating from any pods which match the EgressIP resource according to its spec definition.
+     */
     @JsonProperty("status")
     public void setStatus(EgressIPStatus status) {
         this.status = status;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressIPList.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressIPList.java
index abe65516f1c..8321a8f264f 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressIPList.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressIPList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressIPList is the list of EgressIPList.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class EgressIPList implements Editable<EgressIPListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.ovn.v1.EgressIP>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "k8s.ovn.org/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.ovn.v1.EgressIP> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EgressIPList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EgressIPList(String apiVersion, List<io.fabric8.kubernetes.api.model.ovn.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of EgressIP.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.ovn.v1.EgressIP> getItems() {
         return items;
     }
 
+    /**
+     * List of EgressIP.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.ovn.v1.EgressIP> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EgressIPList is the list of EgressIPList.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EgressIPList is the list of EgressIPList.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressIPSpec.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressIPSpec.java
index c5c585e4d06..7f41e7fd803 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressIPSpec.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressIPSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressIPSpec is a desired state description of EgressIP.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public EgressIPSpec(List<String> egressIPs, LabelSelector namespaceSelector, Lab
         this.podSelector = podSelector;
     }
 
+    /**
+     * EgressIPs is the list of egress IP addresses requested. Can be IPv4 and/or IPv6. This field is mandatory.
+     */
     @JsonProperty("egressIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEgressIPs() {
         return egressIPs;
     }
 
+    /**
+     * EgressIPs is the list of egress IP addresses requested. Can be IPv4 and/or IPv6. This field is mandatory.
+     */
     @JsonProperty("egressIPs")
     public void setEgressIPs(List<String> egressIPs) {
         this.egressIPs = egressIPs;
     }
 
+    /**
+     * EgressIPSpec is a desired state description of EgressIP.
+     */
     @JsonProperty("namespaceSelector")
     public LabelSelector getNamespaceSelector() {
         return namespaceSelector;
     }
 
+    /**
+     * EgressIPSpec is a desired state description of EgressIP.
+     */
     @JsonProperty("namespaceSelector")
     public void setNamespaceSelector(LabelSelector namespaceSelector) {
         this.namespaceSelector = namespaceSelector;
     }
 
+    /**
+     * EgressIPSpec is a desired state description of EgressIP.
+     */
     @JsonProperty("podSelector")
     public LabelSelector getPodSelector() {
         return podSelector;
     }
 
+    /**
+     * EgressIPSpec is a desired state description of EgressIP.
+     */
     @JsonProperty("podSelector")
     public void setPodSelector(LabelSelector podSelector) {
         this.podSelector = podSelector;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressIPStatus.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressIPStatus.java
index 83ffa3e6902..c15999ea4f5 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressIPStatus.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressIPStatus.java
@@ -81,12 +81,18 @@ public EgressIPStatus(List<EgressIPStatusItem> items) {
         this.items = items;
     }
 
+    /**
+     * The list of assigned egress IPs and their corresponding node assignment.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EgressIPStatusItem> getItems() {
         return items;
     }
 
+    /**
+     * The list of assigned egress IPs and their corresponding node assignment.
+     */
     @JsonProperty("items")
     public void setItems(List<EgressIPStatusItem> items) {
         this.items = items;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressIPStatusItem.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressIPStatusItem.java
index 6eb5a363fdf..9cd0d8c6ac5 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressIPStatusItem.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressIPStatusItem.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * The per node status, for those egress IPs who have been assigned.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public EgressIPStatusItem(String egressIP, String node) {
         this.node = node;
     }
 
+    /**
+     * Assigned egress IP
+     */
     @JsonProperty("egressIP")
     public String getEgressIP() {
         return egressIP;
     }
 
+    /**
+     * Assigned egress IP
+     */
     @JsonProperty("egressIP")
     public void setEgressIP(String egressIP) {
         this.egressIP = egressIP;
     }
 
+    /**
+     * Assigned node name
+     */
     @JsonProperty("node")
     public String getNode() {
         return node;
     }
 
+    /**
+     * Assigned node name
+     */
     @JsonProperty("node")
     public void setNode(String node) {
         this.node = node;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressQoS.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressQoS.java
index 3a34b6be56d..bb73453e5b6 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressQoS.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressQoS.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressQoS is a CRD that allows the user to define a DSCP value for pods egress traffic on its namespace to specified CIDRs. Traffic from these pods will be checked against each EgressQoSRule in the namespace's EgressQoS, and if there is a match the traffic is marked with the relevant DSCP value.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class EgressQoS implements Editable<EgressQoSBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "k8s.ovn.org/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EgressQoS";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EgressQoS(String apiVersion, String kind, ObjectMeta metadata, EgressQoSS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EgressQoS is a CRD that allows the user to define a DSCP value for pods egress traffic on its namespace to specified CIDRs. Traffic from these pods will be checked against each EgressQoSRule in the namespace's EgressQoS, and if there is a match the traffic is marked with the relevant DSCP value.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EgressQoS is a CRD that allows the user to define a DSCP value for pods egress traffic on its namespace to specified CIDRs. Traffic from these pods will be checked against each EgressQoSRule in the namespace's EgressQoS, and if there is a match the traffic is marked with the relevant DSCP value.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * EgressQoS is a CRD that allows the user to define a DSCP value for pods egress traffic on its namespace to specified CIDRs. Traffic from these pods will be checked against each EgressQoSRule in the namespace's EgressQoS, and if there is a match the traffic is marked with the relevant DSCP value.
+     */
     @JsonProperty("spec")
     public EgressQoSSpec getSpec() {
         return spec;
     }
 
+    /**
+     * EgressQoS is a CRD that allows the user to define a DSCP value for pods egress traffic on its namespace to specified CIDRs. Traffic from these pods will be checked against each EgressQoSRule in the namespace's EgressQoS, and if there is a match the traffic is marked with the relevant DSCP value.
+     */
     @JsonProperty("spec")
     public void setSpec(EgressQoSSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * EgressQoS is a CRD that allows the user to define a DSCP value for pods egress traffic on its namespace to specified CIDRs. Traffic from these pods will be checked against each EgressQoSRule in the namespace's EgressQoS, and if there is a match the traffic is marked with the relevant DSCP value.
+     */
     @JsonProperty("status")
     public EgressQoSStatus getStatus() {
         return status;
     }
 
+    /**
+     * EgressQoS is a CRD that allows the user to define a DSCP value for pods egress traffic on its namespace to specified CIDRs. Traffic from these pods will be checked against each EgressQoSRule in the namespace's EgressQoS, and if there is a match the traffic is marked with the relevant DSCP value.
+     */
     @JsonProperty("status")
     public void setStatus(EgressQoSStatus status) {
         this.status = status;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressQoSList.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressQoSList.java
index f714a99c3ef..1ff99d0b895 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressQoSList.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressQoSList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressQoSList contains a list of EgressQoS
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class EgressQoSList implements Editable<EgressQoSListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.ovn.v1.EgressQoS>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "k8s.ovn.org/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.ovn.v1.EgressQoS> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EgressQoSList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EgressQoSList(String apiVersion, List<io.fabric8.kubernetes.api.model.ovn
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * EgressQoSList contains a list of EgressQoS
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.ovn.v1.EgressQoS> getItems() {
         return items;
     }
 
+    /**
+     * EgressQoSList contains a list of EgressQoS
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.ovn.v1.EgressQoS> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EgressQoSList contains a list of EgressQoS
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EgressQoSList contains a list of EgressQoS
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressQoSRule.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressQoSRule.java
index e0ccc90ae33..1ce023595a9 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressQoSRule.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressQoSRule.java
@@ -86,21 +86,33 @@ public EgressQoSRule(Integer dscp, String dstCIDR, LabelSelector podSelector) {
         this.podSelector = podSelector;
     }
 
+    /**
+     * DSCP marking value for matching pods' traffic.
+     */
     @JsonProperty("dscp")
     public Integer getDscp() {
         return dscp;
     }
 
+    /**
+     * DSCP marking value for matching pods' traffic.
+     */
     @JsonProperty("dscp")
     public void setDscp(Integer dscp) {
         this.dscp = dscp;
     }
 
+    /**
+     * DstCIDR specifies the destination's CIDR. Only traffic heading to this CIDR will be marked with the DSCP value. This field is optional, and in case it is not set the rule is applied to all egress traffic regardless of the destination.
+     */
     @JsonProperty("dstCIDR")
     public String getDstCIDR() {
         return dstCIDR;
     }
 
+    /**
+     * DstCIDR specifies the destination's CIDR. Only traffic heading to this CIDR will be marked with the DSCP value. This field is optional, and in case it is not set the rule is applied to all egress traffic regardless of the destination.
+     */
     @JsonProperty("dstCIDR")
     public void setDstCIDR(String dstCIDR) {
         this.dstCIDR = dstCIDR;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressQoSSpec.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressQoSSpec.java
index ec6faf71ba9..a60d0d5a975 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressQoSSpec.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressQoSSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressQoSSpec defines the desired state of EgressQoS
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public EgressQoSSpec(List<EgressQoSRule> egress) {
         this.egress = egress;
     }
 
+    /**
+     * a collection of Egress QoS rule objects
+     */
     @JsonProperty("egress")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EgressQoSRule> getEgress() {
         return egress;
     }
 
+    /**
+     * a collection of Egress QoS rule objects
+     */
     @JsonProperty("egress")
     public void setEgress(List<EgressQoSRule> egress) {
         this.egress = egress;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressQoSStatus.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressQoSStatus.java
index f0e240c3834..7bf858e5022 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressQoSStatus.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressQoSStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressQoSStatus defines the observed state of EgressQoS
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,22 +89,34 @@ public EgressQoSStatus(List<Condition> conditions, String status) {
         this.status = status;
     }
 
+    /**
+     * An array of condition objects indicating details about status of EgressQoS object.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * An array of condition objects indicating details about status of EgressQoS object.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * A concise indication of whether the EgressQoS resource is applied with success.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * A concise indication of whether the EgressQoS resource is applied with success.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressService.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressService.java
index fa64ab31b0e..69341dc4680 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressService.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressService.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressService is a CRD that allows the user to request that the source IP of egress packets originating from all of the pods that are endpoints of the corresponding LoadBalancer Service would be its ingress IP. In addition, it allows the user to request that egress packets originating from all of the pods that are endpoints of the LoadBalancer service would use a different network than the main one.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class EgressService implements Editable<EgressServiceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "k8s.ovn.org/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EgressService";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EgressService(String apiVersion, String kind, ObjectMeta metadata, Egress
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EgressService is a CRD that allows the user to request that the source IP of egress packets originating from all of the pods that are endpoints of the corresponding LoadBalancer Service would be its ingress IP. In addition, it allows the user to request that egress packets originating from all of the pods that are endpoints of the LoadBalancer service would use a different network than the main one.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EgressService is a CRD that allows the user to request that the source IP of egress packets originating from all of the pods that are endpoints of the corresponding LoadBalancer Service would be its ingress IP. In addition, it allows the user to request that egress packets originating from all of the pods that are endpoints of the LoadBalancer service would use a different network than the main one.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * EgressService is a CRD that allows the user to request that the source IP of egress packets originating from all of the pods that are endpoints of the corresponding LoadBalancer Service would be its ingress IP. In addition, it allows the user to request that egress packets originating from all of the pods that are endpoints of the LoadBalancer service would use a different network than the main one.
+     */
     @JsonProperty("spec")
     public EgressServiceSpec getSpec() {
         return spec;
     }
 
+    /**
+     * EgressService is a CRD that allows the user to request that the source IP of egress packets originating from all of the pods that are endpoints of the corresponding LoadBalancer Service would be its ingress IP. In addition, it allows the user to request that egress packets originating from all of the pods that are endpoints of the LoadBalancer service would use a different network than the main one.
+     */
     @JsonProperty("spec")
     public void setSpec(EgressServiceSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * EgressService is a CRD that allows the user to request that the source IP of egress packets originating from all of the pods that are endpoints of the corresponding LoadBalancer Service would be its ingress IP. In addition, it allows the user to request that egress packets originating from all of the pods that are endpoints of the LoadBalancer service would use a different network than the main one.
+     */
     @JsonProperty("status")
     public EgressServiceStatus getStatus() {
         return status;
     }
 
+    /**
+     * EgressService is a CRD that allows the user to request that the source IP of egress packets originating from all of the pods that are endpoints of the corresponding LoadBalancer Service would be its ingress IP. In addition, it allows the user to request that egress packets originating from all of the pods that are endpoints of the LoadBalancer service would use a different network than the main one.
+     */
     @JsonProperty("status")
     public void setStatus(EgressServiceStatus status) {
         this.status = status;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressServiceList.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressServiceList.java
index 84027233cea..68376d06a1b 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressServiceList.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressServiceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressServiceList contains a list of EgressServices
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class EgressServiceList implements Editable<EgressServiceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.ovn.v1.EgressService>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "k8s.ovn.org/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.ovn.v1.EgressService> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EgressServiceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EgressServiceList(String apiVersion, List<io.fabric8.kubernetes.api.model
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * EgressServiceList contains a list of EgressServices
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.ovn.v1.EgressService> getItems() {
         return items;
     }
 
+    /**
+     * EgressServiceList contains a list of EgressServices
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.ovn.v1.EgressService> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EgressServiceList contains a list of EgressServices
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EgressServiceList contains a list of EgressServices
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressServiceSpec.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressServiceSpec.java
index ffdedc6a9cf..5fa85ac456b 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressServiceSpec.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressServiceSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressServiceSpec defines the desired state of EgressService
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public EgressServiceSpec(String network, LabelSelector nodeSelector, String sour
         this.sourceIPBy = sourceIPBy;
     }
 
+    /**
+     * The network which this service should send egress and corresponding ingress replies to. This is typically implemented as VRF mapping, representing a numeric id or string name of a routing table which by omission uses the default host routing.
+     */
     @JsonProperty("network")
     public String getNetwork() {
         return network;
     }
 
+    /**
+     * The network which this service should send egress and corresponding ingress replies to. This is typically implemented as VRF mapping, representing a numeric id or string name of a routing table which by omission uses the default host routing.
+     */
     @JsonProperty("network")
     public void setNetwork(String network) {
         this.network = network;
     }
 
+    /**
+     * EgressServiceSpec defines the desired state of EgressService
+     */
     @JsonProperty("nodeSelector")
     public LabelSelector getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * EgressServiceSpec defines the desired state of EgressService
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(LabelSelector nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * Determines the source IP of egress traffic originating from the pods backing the LoadBalancer Service. When `LoadBalancerIP` the source IP is set to its LoadBalancer ingress IP. When `Network` the source IP is set according to the interface of the Network, leveraging the masquerade rules that are already in place. Typically these rules specify SNAT to the IP of the outgoing interface, which means the packet will typically leave with the IP of the node.
+     */
     @JsonProperty("sourceIPBy")
     public String getSourceIPBy() {
         return sourceIPBy;
     }
 
+    /**
+     * Determines the source IP of egress traffic originating from the pods backing the LoadBalancer Service. When `LoadBalancerIP` the source IP is set to its LoadBalancer ingress IP. When `Network` the source IP is set according to the interface of the Network, leveraging the masquerade rules that are already in place. Typically these rules specify SNAT to the IP of the outgoing interface, which means the packet will typically leave with the IP of the node.
+     */
     @JsonProperty("sourceIPBy")
     public void setSourceIPBy(String sourceIPBy) {
         this.sourceIPBy = sourceIPBy;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressServiceStatus.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressServiceStatus.java
index f9e3719ead2..9ee589e14fe 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressServiceStatus.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/EgressServiceStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressServiceStatus defines the observed state of EgressService
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public EgressServiceStatus(String host) {
         this.host = host;
     }
 
+    /**
+     * The name of the node selected to handle the service's traffic. In case sourceIPBy=Network the field will be set to "ALL".
+     */
     @JsonProperty("host")
     public String getHost() {
         return host;
     }
 
+    /**
+     * The name of the node selected to handle the service's traffic. In case sourceIPBy=Network the field will be set to "ALL".
+     */
     @JsonProperty("host")
     public void setHost(String host) {
         this.host = host;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/ExternalNetworkSource.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/ExternalNetworkSource.java
index 72c18889b7c..918da7deae0 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/ExternalNetworkSource.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/ExternalNetworkSource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ExternalNetworkSource contains the selectors used to determine the namespaces where the policy will be applied to
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ExternalNetworkSource(LabelSelector namespaceSelector) {
         this.namespaceSelector = namespaceSelector;
     }
 
+    /**
+     * ExternalNetworkSource contains the selectors used to determine the namespaces where the policy will be applied to
+     */
     @JsonProperty("namespaceSelector")
     public LabelSelector getNamespaceSelector() {
         return namespaceSelector;
     }
 
+    /**
+     * ExternalNetworkSource contains the selectors used to determine the namespaces where the policy will be applied to
+     */
     @JsonProperty("namespaceSelector")
     public void setNamespaceSelector(LabelSelector namespaceSelector) {
         this.namespaceSelector = namespaceSelector;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/ExternalNextHops.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/ExternalNextHops.java
index 4f07626139f..0ffa3e875ad 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/ExternalNextHops.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/ExternalNextHops.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ExternalNextHops contains slices of StaticHops and DynamicHops structures. Minimum is one StaticHop or one DynamicHop.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public ExternalNextHops(List<DynamicHop> dynamic, List<StaticHop> _static) {
         this._static = _static;
     }
 
+    /**
+     * DynamicHops defines a slices of DynamicHop. This field is optional.
+     */
     @JsonProperty("dynamic")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DynamicHop> getDynamic() {
         return dynamic;
     }
 
+    /**
+     * DynamicHops defines a slices of DynamicHop. This field is optional.
+     */
     @JsonProperty("dynamic")
     public void setDynamic(List<DynamicHop> dynamic) {
         this.dynamic = dynamic;
     }
 
+    /**
+     * StaticHops defines a slice of StaticHop. This field is optional.
+     */
     @JsonProperty("static")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<StaticHop> getStatic() {
         return _static;
     }
 
+    /**
+     * StaticHops defines a slice of StaticHop. This field is optional.
+     */
     @JsonProperty("static")
     public void setStatic(List<StaticHop> _static) {
         this._static = _static;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/Layer2Config.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/Layer2Config.java
index 81ca5ae1d80..936632392fb 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/Layer2Config.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/Layer2Config.java
@@ -98,53 +98,83 @@ public Layer2Config(String ipamLifecycle, List<String> joinSubnets, Integer mtu,
         this.subnets = subnets;
     }
 
+    /**
+     * IPAMLifecycle controls IP addresses management lifecycle.<br><p> <br><p> The only allowed value is Persistent. When set, OVN Kubernetes assigned IP addresses will be persisted in an `ipamclaims.k8s.cni.cncf.io` object. These IP addresses will be reused by other pods if requested. Only supported when "subnets" are set.
+     */
     @JsonProperty("ipamLifecycle")
     public String getIpamLifecycle() {
         return ipamLifecycle;
     }
 
+    /**
+     * IPAMLifecycle controls IP addresses management lifecycle.<br><p> <br><p> The only allowed value is Persistent. When set, OVN Kubernetes assigned IP addresses will be persisted in an `ipamclaims.k8s.cni.cncf.io` object. These IP addresses will be reused by other pods if requested. Only supported when "subnets" are set.
+     */
     @JsonProperty("ipamLifecycle")
     public void setIpamLifecycle(String ipamLifecycle) {
         this.ipamLifecycle = ipamLifecycle;
     }
 
+    /**
+     * JoinSubnets are used inside the OVN network topology.<br><p> <br><p> Dual-stack clusters may set 2 subnets (one for each IP family), otherwise only 1 subnet is allowed. This field is only allowed for "Primary" network. It is not recommended to set this field without explicit need and understanding of the OVN network topology. When omitted, the platform will choose a reasonable default which is subject to change over time.
+     */
     @JsonProperty("joinSubnets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getJoinSubnets() {
         return joinSubnets;
     }
 
+    /**
+     * JoinSubnets are used inside the OVN network topology.<br><p> <br><p> Dual-stack clusters may set 2 subnets (one for each IP family), otherwise only 1 subnet is allowed. This field is only allowed for "Primary" network. It is not recommended to set this field without explicit need and understanding of the OVN network topology. When omitted, the platform will choose a reasonable default which is subject to change over time.
+     */
     @JsonProperty("joinSubnets")
     public void setJoinSubnets(List<String> joinSubnets) {
         this.joinSubnets = joinSubnets;
     }
 
+    /**
+     * MTU is the maximum transmission unit for a network. MTU is optional, if not provided, the globally configured value in OVN-Kubernetes (defaults to 1400) is used for the network.
+     */
     @JsonProperty("mtu")
     public Integer getMtu() {
         return mtu;
     }
 
+    /**
+     * MTU is the maximum transmission unit for a network. MTU is optional, if not provided, the globally configured value in OVN-Kubernetes (defaults to 1400) is used for the network.
+     */
     @JsonProperty("mtu")
     public void setMtu(Integer mtu) {
         this.mtu = mtu;
     }
 
+    /**
+     * Role describes the network role in the pod.<br><p> <br><p> Allowed value is "Secondary". Secondary network is only assigned to pods that use `k8s.v1.cni.cncf.io/networks` annotation to select given network.
+     */
     @JsonProperty("role")
     public String getRole() {
         return role;
     }
 
+    /**
+     * Role describes the network role in the pod.<br><p> <br><p> Allowed value is "Secondary". Secondary network is only assigned to pods that use `k8s.v1.cni.cncf.io/networks` annotation to select given network.
+     */
     @JsonProperty("role")
     public void setRole(String role) {
         this.role = role;
     }
 
+    /**
+     * Subnets are used for the pod network across the cluster. Dual-stack clusters may set 2 subnets (one for each IP family), otherwise only 1 subnet is allowed.<br><p> <br><p> The format should match standard CIDR notation (for example, "10.128.0.0/16"). This field may be omitted. In that case the logical switch implementing the network only provides layer 2 communication, and users must configure IP addresses for the pods. As a consequence, Port security only prevents MAC spoofing.
+     */
     @JsonProperty("subnets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSubnets() {
         return subnets;
     }
 
+    /**
+     * Subnets are used for the pod network across the cluster. Dual-stack clusters may set 2 subnets (one for each IP family), otherwise only 1 subnet is allowed.<br><p> <br><p> The format should match standard CIDR notation (for example, "10.128.0.0/16"). This field may be omitted. In that case the logical switch implementing the network only provides layer 2 communication, and users must configure IP addresses for the pods. As a consequence, Port security only prevents MAC spoofing.
+     */
     @JsonProperty("subnets")
     public void setSubnets(List<String> subnets) {
         this.subnets = subnets;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/Layer3Config.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/Layer3Config.java
index 1e77293de9c..6cdb2e21dfd 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/Layer3Config.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/Layer3Config.java
@@ -94,43 +94,67 @@ public Layer3Config(List<String> joinSubnets, Integer mtu, String role, List<Lay
         this.subnets = subnets;
     }
 
+    /**
+     * JoinSubnets are used inside the OVN network topology.<br><p> <br><p> Dual-stack clusters may set 2 subnets (one for each IP family), otherwise only 1 subnet is allowed. This field is only allowed for "Primary" network. It is not recommended to set this field without explicit need and understanding of the OVN network topology. When omitted, the platform will choose a reasonable default which is subject to change over time.
+     */
     @JsonProperty("joinSubnets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getJoinSubnets() {
         return joinSubnets;
     }
 
+    /**
+     * JoinSubnets are used inside the OVN network topology.<br><p> <br><p> Dual-stack clusters may set 2 subnets (one for each IP family), otherwise only 1 subnet is allowed. This field is only allowed for "Primary" network. It is not recommended to set this field without explicit need and understanding of the OVN network topology. When omitted, the platform will choose a reasonable default which is subject to change over time.
+     */
     @JsonProperty("joinSubnets")
     public void setJoinSubnets(List<String> joinSubnets) {
         this.joinSubnets = joinSubnets;
     }
 
+    /**
+     * MTU is the maximum transmission unit for a network.<br><p> <br><p> MTU is optional, if not provided, the globally configured value in OVN-Kubernetes (defaults to 1400) is used for the network.
+     */
     @JsonProperty("mtu")
     public Integer getMtu() {
         return mtu;
     }
 
+    /**
+     * MTU is the maximum transmission unit for a network.<br><p> <br><p> MTU is optional, if not provided, the globally configured value in OVN-Kubernetes (defaults to 1400) is used for the network.
+     */
     @JsonProperty("mtu")
     public void setMtu(Integer mtu) {
         this.mtu = mtu;
     }
 
+    /**
+     * Role describes the network role in the pod.<br><p> <br><p> Allowed values are "Primary" and "Secondary". Primary network is automatically assigned to every pod created in the same namespace. Secondary network is only assigned to pods that use `k8s.v1.cni.cncf.io/networks` annotation to select given network.
+     */
     @JsonProperty("role")
     public String getRole() {
         return role;
     }
 
+    /**
+     * Role describes the network role in the pod.<br><p> <br><p> Allowed values are "Primary" and "Secondary". Primary network is automatically assigned to every pod created in the same namespace. Secondary network is only assigned to pods that use `k8s.v1.cni.cncf.io/networks` annotation to select given network.
+     */
     @JsonProperty("role")
     public void setRole(String role) {
         this.role = role;
     }
 
+    /**
+     * Subnets are used for the pod network across the cluster.<br><p> <br><p> Dual-stack clusters may set 2 subnets (one for each IP family), otherwise only 1 subnet is allowed. Given subnet is split into smaller subnets for every node.
+     */
     @JsonProperty("subnets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Layer3Subnet> getSubnets() {
         return subnets;
     }
 
+    /**
+     * Subnets are used for the pod network across the cluster.<br><p> <br><p> Dual-stack clusters may set 2 subnets (one for each IP family), otherwise only 1 subnet is allowed. Given subnet is split into smaller subnets for every node.
+     */
     @JsonProperty("subnets")
     public void setSubnets(List<Layer3Subnet> subnets) {
         this.subnets = subnets;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/Layer3Subnet.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/Layer3Subnet.java
index 3cd077f7382..3f220a98ef6 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/Layer3Subnet.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/Layer3Subnet.java
@@ -82,21 +82,33 @@ public Layer3Subnet(String cidr, Integer hostSubnet) {
         this.hostSubnet = hostSubnet;
     }
 
+    /**
+     * CIDR specifies L3Subnet, which is split into smaller subnets for every node.
+     */
     @JsonProperty("cidr")
     public String getCidr() {
         return cidr;
     }
 
+    /**
+     * CIDR specifies L3Subnet, which is split into smaller subnets for every node.
+     */
     @JsonProperty("cidr")
     public void setCidr(String cidr) {
         this.cidr = cidr;
     }
 
+    /**
+     * HostSubnet specifies the subnet size for every node.<br><p> <br><p> When not set, it will be assigned automatically.
+     */
     @JsonProperty("hostSubnet")
     public Integer getHostSubnet() {
         return hostSubnet;
     }
 
+    /**
+     * HostSubnet specifies the subnet size for every node.<br><p> <br><p> When not set, it will be assigned automatically.
+     */
     @JsonProperty("hostSubnet")
     public void setHostSubnet(Integer hostSubnet) {
         this.hostSubnet = hostSubnet;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/StaticHop.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/StaticHop.java
index c945ad383de..38d492b15bd 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/StaticHop.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/StaticHop.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StaticHop defines the configuration of a static IP that acts as an external Gateway Interface. IP field is mandatory.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public StaticHop(Boolean bfdEnabled, String ip) {
         this.ip = ip;
     }
 
+    /**
+     * BFDEnabled determines if the interface implements the Bidirectional Forward Detection protocol. Defaults to false.
+     */
     @JsonProperty("bfdEnabled")
     public Boolean getBfdEnabled() {
         return bfdEnabled;
     }
 
+    /**
+     * BFDEnabled determines if the interface implements the Bidirectional Forward Detection protocol. Defaults to false.
+     */
     @JsonProperty("bfdEnabled")
     public void setBfdEnabled(Boolean bfdEnabled) {
         this.bfdEnabled = bfdEnabled;
     }
 
+    /**
+     * IP defines the static IP to be used for egress traffic. The IP can be either IPv4 or IPv6.
+     */
     @JsonProperty("ip")
     public String getIp() {
         return ip;
     }
 
+    /**
+     * IP defines the static IP to be used for egress traffic. The IP can be either IPv4 or IPv6.
+     */
     @JsonProperty("ip")
     public void setIp(String ip) {
         this.ip = ip;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/UserDefinedNetwork.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/UserDefinedNetwork.java
index 0d859567e96..f6ff56da7ad 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/UserDefinedNetwork.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/UserDefinedNetwork.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UserDefinedNetwork describe network request for a Namespace.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class UserDefinedNetwork implements Editable<UserDefinedNetworkBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "k8s.ovn.org/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "UserDefinedNetwork";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public UserDefinedNetwork(String apiVersion, String kind, ObjectMeta metadata, U
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * UserDefinedNetwork describe network request for a Namespace.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * UserDefinedNetwork describe network request for a Namespace.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * UserDefinedNetwork describe network request for a Namespace.
+     */
     @JsonProperty("spec")
     public UserDefinedNetworkSpec getSpec() {
         return spec;
     }
 
+    /**
+     * UserDefinedNetwork describe network request for a Namespace.
+     */
     @JsonProperty("spec")
     public void setSpec(UserDefinedNetworkSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * UserDefinedNetwork describe network request for a Namespace.
+     */
     @JsonProperty("status")
     public UserDefinedNetworkStatus getStatus() {
         return status;
     }
 
+    /**
+     * UserDefinedNetwork describe network request for a Namespace.
+     */
     @JsonProperty("status")
     public void setStatus(UserDefinedNetworkStatus status) {
         this.status = status;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/UserDefinedNetworkList.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/UserDefinedNetworkList.java
index 3bfd96836b9..17cb3587d72 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/UserDefinedNetworkList.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/UserDefinedNetworkList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UserDefinedNetworkList contains a list of UserDefinedNetwork.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class UserDefinedNetworkList implements Editable<UserDefinedNetworkListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.ovn.v1.UserDefinedNetwork>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "k8s.ovn.org/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.ovn.v1.UserDefinedNetwork> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "UserDefinedNetworkList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public UserDefinedNetworkList(String apiVersion, List<io.fabric8.kubernetes.api.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * UserDefinedNetworkList contains a list of UserDefinedNetwork.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.ovn.v1.UserDefinedNetwork> getItems() {
         return items;
     }
 
+    /**
+     * UserDefinedNetworkList contains a list of UserDefinedNetwork.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.ovn.v1.UserDefinedNetwork> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * UserDefinedNetworkList contains a list of UserDefinedNetwork.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * UserDefinedNetworkList contains a list of UserDefinedNetwork.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/UserDefinedNetworkSpec.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/UserDefinedNetworkSpec.java
index eb42206c397..f707c136f27 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/UserDefinedNetworkSpec.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/UserDefinedNetworkSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UserDefinedNetworkSpec defines the desired state of UserDefinedNetworkSpec.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public UserDefinedNetworkSpec(Layer2Config layer2, Layer3Config layer3, String t
         this.topology = topology;
     }
 
+    /**
+     * UserDefinedNetworkSpec defines the desired state of UserDefinedNetworkSpec.
+     */
     @JsonProperty("layer2")
     public Layer2Config getLayer2() {
         return layer2;
     }
 
+    /**
+     * UserDefinedNetworkSpec defines the desired state of UserDefinedNetworkSpec.
+     */
     @JsonProperty("layer2")
     public void setLayer2(Layer2Config layer2) {
         this.layer2 = layer2;
     }
 
+    /**
+     * UserDefinedNetworkSpec defines the desired state of UserDefinedNetworkSpec.
+     */
     @JsonProperty("layer3")
     public Layer3Config getLayer3() {
         return layer3;
     }
 
+    /**
+     * UserDefinedNetworkSpec defines the desired state of UserDefinedNetworkSpec.
+     */
     @JsonProperty("layer3")
     public void setLayer3(Layer3Config layer3) {
         this.layer3 = layer3;
     }
 
+    /**
+     * Topology describes network configuration.<br><p> <br><p> Allowed values are "Layer3", "Layer2". Layer3 topology creates a layer 2 segment per node, each with a different subnet. Layer 3 routing is used to interconnect node subnets. Layer2 topology creates one logical switch shared by all nodes.
+     */
     @JsonProperty("topology")
     public String getTopology() {
         return topology;
     }
 
+    /**
+     * Topology describes network configuration.<br><p> <br><p> Allowed values are "Layer3", "Layer2". Layer3 topology creates a layer 2 segment per node, each with a different subnet. Layer 3 routing is used to interconnect node subnets. Layer2 topology creates one logical switch shared by all nodes.
+     */
     @JsonProperty("topology")
     public void setTopology(String topology) {
         this.topology = topology;
diff --git a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/UserDefinedNetworkStatus.java b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/UserDefinedNetworkStatus.java
index 7e3159f2e70..21cf16b70cb 100644
--- a/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/UserDefinedNetworkStatus.java
+++ b/extensions/open-virtual-network/model/src/generated/java/io/fabric8/kubernetes/api/model/ovn/v1/UserDefinedNetworkStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UserDefinedNetworkStatus contains the observed status of the UserDefinedNetwork.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,12 +85,18 @@ public UserDefinedNetworkStatus(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * UserDefinedNetworkStatus contains the observed status of the UserDefinedNetwork.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * UserDefinedNetworkStatus contains the observed status of the UserDefinedNetwork.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/pipeline/pkg/apis/config/FeatureFlags.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/pipeline/pkg/apis/config/FeatureFlags.java
index 209ec39a3a0..8646e6b3367 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/pipeline/pkg/apis/config/FeatureFlags.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/pipeline/pkg/apis/config/FeatureFlags.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FeatureFlags holds the features configurations
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -162,221 +165,353 @@ public FeatureFlags(Boolean awaitSidecarReadiness, String coschedule, Boolean di
         this.verificationNoMatchPolicy = verificationNoMatchPolicy;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("AwaitSidecarReadiness")
     public Boolean getAwaitSidecarReadiness() {
         return awaitSidecarReadiness;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("AwaitSidecarReadiness")
     public void setAwaitSidecarReadiness(Boolean awaitSidecarReadiness) {
         this.awaitSidecarReadiness = awaitSidecarReadiness;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("Coschedule")
     public String getCoschedule() {
         return coschedule;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("Coschedule")
     public void setCoschedule(String coschedule) {
         this.coschedule = coschedule;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("DisableAffinityAssistant")
     public Boolean getDisableAffinityAssistant() {
         return disableAffinityAssistant;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("DisableAffinityAssistant")
     public void setDisableAffinityAssistant(Boolean disableAffinityAssistant) {
         this.disableAffinityAssistant = disableAffinityAssistant;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("DisableCredsInit")
     public Boolean getDisableCredsInit() {
         return disableCredsInit;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("DisableCredsInit")
     public void setDisableCredsInit(Boolean disableCredsInit) {
         this.disableCredsInit = disableCredsInit;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("DisableInlineSpec")
     public String getDisableInlineSpec() {
         return disableInlineSpec;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("DisableInlineSpec")
     public void setDisableInlineSpec(String disableInlineSpec) {
         this.disableInlineSpec = disableInlineSpec;
     }
 
+    /**
+     * EnableTektonOCIBundles           bool // Deprecated: this is now ignored ScopeWhenExpressionsToTask       bool // Deprecated: this is now ignored
+     */
     @JsonProperty("EnableAPIFields")
     public String getEnableAPIFields() {
         return enableAPIFields;
     }
 
+    /**
+     * EnableTektonOCIBundles           bool // Deprecated: this is now ignored ScopeWhenExpressionsToTask       bool // Deprecated: this is now ignored
+     */
     @JsonProperty("EnableAPIFields")
     public void setEnableAPIFields(String enableAPIFields) {
         this.enableAPIFields = enableAPIFields;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("EnableArtifacts")
     public Boolean getEnableArtifacts() {
         return enableArtifacts;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("EnableArtifacts")
     public void setEnableArtifacts(Boolean enableArtifacts) {
         this.enableArtifacts = enableArtifacts;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("EnableCELInWhenExpression")
     public Boolean getEnableCELInWhenExpression() {
         return enableCELInWhenExpression;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("EnableCELInWhenExpression")
     public void setEnableCELInWhenExpression(Boolean enableCELInWhenExpression) {
         this.enableCELInWhenExpression = enableCELInWhenExpression;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("EnableConciseResolverSyntax")
     public Boolean getEnableConciseResolverSyntax() {
         return enableConciseResolverSyntax;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("EnableConciseResolverSyntax")
     public void setEnableConciseResolverSyntax(Boolean enableConciseResolverSyntax) {
         this.enableConciseResolverSyntax = enableConciseResolverSyntax;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("EnableKeepPodOnCancel")
     public Boolean getEnableKeepPodOnCancel() {
         return enableKeepPodOnCancel;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("EnableKeepPodOnCancel")
     public void setEnableKeepPodOnCancel(Boolean enableKeepPodOnCancel) {
         this.enableKeepPodOnCancel = enableKeepPodOnCancel;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("EnableKubernetesSidecar")
     public Boolean getEnableKubernetesSidecar() {
         return enableKubernetesSidecar;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("EnableKubernetesSidecar")
     public void setEnableKubernetesSidecar(Boolean enableKubernetesSidecar) {
         this.enableKubernetesSidecar = enableKubernetesSidecar;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("EnableParamEnum")
     public Boolean getEnableParamEnum() {
         return enableParamEnum;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("EnableParamEnum")
     public void setEnableParamEnum(Boolean enableParamEnum) {
         this.enableParamEnum = enableParamEnum;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("EnableProvenanceInStatus")
     public Boolean getEnableProvenanceInStatus() {
         return enableProvenanceInStatus;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("EnableProvenanceInStatus")
     public void setEnableProvenanceInStatus(Boolean enableProvenanceInStatus) {
         this.enableProvenanceInStatus = enableProvenanceInStatus;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("EnableStepActions")
     public Boolean getEnableStepActions() {
         return enableStepActions;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("EnableStepActions")
     public void setEnableStepActions(Boolean enableStepActions) {
         this.enableStepActions = enableStepActions;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("EnforceNonfalsifiability")
     public String getEnforceNonfalsifiability() {
         return enforceNonfalsifiability;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("EnforceNonfalsifiability")
     public void setEnforceNonfalsifiability(String enforceNonfalsifiability) {
         this.enforceNonfalsifiability = enforceNonfalsifiability;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("MaxResultSize")
     public Integer getMaxResultSize() {
         return maxResultSize;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("MaxResultSize")
     public void setMaxResultSize(Integer maxResultSize) {
         this.maxResultSize = maxResultSize;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("RequireGitSSHSecretKnownHosts")
     public Boolean getRequireGitSSHSecretKnownHosts() {
         return requireGitSSHSecretKnownHosts;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("RequireGitSSHSecretKnownHosts")
     public void setRequireGitSSHSecretKnownHosts(Boolean requireGitSSHSecretKnownHosts) {
         this.requireGitSSHSecretKnownHosts = requireGitSSHSecretKnownHosts;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("ResultExtractionMethod")
     public String getResultExtractionMethod() {
         return resultExtractionMethod;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("ResultExtractionMethod")
     public void setResultExtractionMethod(String resultExtractionMethod) {
         this.resultExtractionMethod = resultExtractionMethod;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("RunningInEnvWithInjectedSidecars")
     public Boolean getRunningInEnvWithInjectedSidecars() {
         return runningInEnvWithInjectedSidecars;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("RunningInEnvWithInjectedSidecars")
     public void setRunningInEnvWithInjectedSidecars(Boolean runningInEnvWithInjectedSidecars) {
         this.runningInEnvWithInjectedSidecars = runningInEnvWithInjectedSidecars;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("SendCloudEventsForRuns")
     public Boolean getSendCloudEventsForRuns() {
         return sendCloudEventsForRuns;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("SendCloudEventsForRuns")
     public void setSendCloudEventsForRuns(Boolean sendCloudEventsForRuns) {
         this.sendCloudEventsForRuns = sendCloudEventsForRuns;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("SetSecurityContext")
     public Boolean getSetSecurityContext() {
         return setSecurityContext;
     }
 
+    /**
+     * FeatureFlags holds the features configurations
+     */
     @JsonProperty("SetSecurityContext")
     public void setSetSecurityContext(Boolean setSecurityContext) {
         this.setSecurityContext = setSecurityContext;
     }
 
+    /**
+     * VerificationNoMatchPolicy is the feature flag for "trusted-resources-verification-no-match-policy" VerificationNoMatchPolicy can be set to "ignore", "warn" and "fail" values. ignore: skip trusted resources verification when no matching verification policies found warn: skip trusted resources verification when no matching verification policies found and log a warning fail: fail the taskrun or pipelines run if no matching verification policies found
+     */
     @JsonProperty("VerificationNoMatchPolicy")
     public String getVerificationNoMatchPolicy() {
         return verificationNoMatchPolicy;
     }
 
+    /**
+     * VerificationNoMatchPolicy is the feature flag for "trusted-resources-verification-no-match-policy" VerificationNoMatchPolicy can be set to "ignore", "warn" and "fail" values. ignore: skip trusted resources verification when no matching verification policies found warn: skip trusted resources verification when no matching verification policies found and log a warning fail: fail the taskrun or pipelines run if no matching verification policies found
+     */
     @JsonProperty("VerificationNoMatchPolicy")
     public void setVerificationNoMatchPolicy(String verificationNoMatchPolicy) {
         this.verificationNoMatchPolicy = verificationNoMatchPolicy;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/pipeline/pkg/result/RunResult.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/pipeline/pkg/result/RunResult.java
index 001a344bff9..97c8684fc31 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/pipeline/pkg/result/RunResult.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/pipeline/pkg/result/RunResult.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RunResult is used to write key/value pairs to TaskRun pod termination messages. The key/value pairs may come from the entrypoint binary, or represent a TaskRunResult. If they represent a TaskRunResult, the key is the name of the result and the value is the JSON-serialized value of the result.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public RunResult(String key, String resourceName, Integer type, String value) {
         this.value = value;
     }
 
+    /**
+     * RunResult is used to write key/value pairs to TaskRun pod termination messages. The key/value pairs may come from the entrypoint binary, or represent a TaskRunResult. If they represent a TaskRunResult, the key is the name of the result and the value is the JSON-serialized value of the result.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * RunResult is used to write key/value pairs to TaskRun pod termination messages. The key/value pairs may come from the entrypoint binary, or represent a TaskRunResult. If they represent a TaskRunResult, the key is the name of the result and the value is the JSON-serialized value of the result.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * ResourceName may be used in tests, but it is not populated in termination messages. It is preserved here for backwards compatibility and will not be ported to v1.
+     */
     @JsonProperty("resourceName")
     public String getResourceName() {
         return resourceName;
     }
 
+    /**
+     * ResourceName may be used in tests, but it is not populated in termination messages. It is preserved here for backwards compatibility and will not be ported to v1.
+     */
     @JsonProperty("resourceName")
     public void setResourceName(String resourceName) {
         this.resourceName = resourceName;
     }
 
+    /**
+     * RunResult is used to write key/value pairs to TaskRun pod termination messages. The key/value pairs may come from the entrypoint binary, or represent a TaskRunResult. If they represent a TaskRunResult, the key is the name of the result and the value is the JSON-serialized value of the result.
+     */
     @JsonProperty("type")
     public Integer getType() {
         return type;
     }
 
+    /**
+     * RunResult is used to write key/value pairs to TaskRun pod termination messages. The key/value pairs may come from the entrypoint binary, or represent a TaskRunResult. If they represent a TaskRunResult, the key is the name of the result and the value is the JSON-serialized value of the result.
+     */
     @JsonProperty("type")
     public void setType(Integer type) {
         this.type = type;
     }
 
+    /**
+     * RunResult is used to write key/value pairs to TaskRun pod termination messages. The key/value pairs may come from the entrypoint binary, or represent a TaskRunResult. If they represent a TaskRunResult, the key is the name of the result and the value is the JSON-serialized value of the result.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * RunResult is used to write key/value pairs to TaskRun pod termination messages. The key/value pairs may come from the entrypoint binary, or represent a TaskRunResult. If they represent a TaskRunResult, the key is the name of the result and the value is the JSON-serialized value of the result.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/pod/AffinityAssistantTemplate.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/pod/AffinityAssistantTemplate.java
index 8a374fa9b87..3ab28878dfe 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/pod/AffinityAssistantTemplate.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/pod/AffinityAssistantTemplate.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AffinityAssistantTemplate holds pod specific configuration and is a subset of the generic pod Template
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,54 +104,84 @@ public AffinityAssistantTemplate(List<LocalObjectReference> imagePullSecrets, Ma
         this.tolerations = tolerations;
     }
 
+    /**
+     * ImagePullSecrets gives the name of the secret used by the pod to pull the image if specified
+     */
     @JsonProperty("imagePullSecrets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LocalObjectReference> getImagePullSecrets() {
         return imagePullSecrets;
     }
 
+    /**
+     * ImagePullSecrets gives the name of the secret used by the pod to pull the image if specified
+     */
     @JsonProperty("imagePullSecrets")
     public void setImagePullSecrets(List<LocalObjectReference> imagePullSecrets) {
         this.imagePullSecrets = imagePullSecrets;
     }
 
+    /**
+     * NodeSelector is a selector which must be true for the pod to fit on a node. Selector which must match a node's labels for the pod to be scheduled on that node. More info: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * NodeSelector is a selector which must be true for the pod to fit on a node. Selector which must match a node's labels for the pod to be scheduled on that node. More info: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * If specified, indicates the pod's priority. "system-node-critical" and "system-cluster-critical" are two special keywords which indicate the highest priorities with the former being the highest priority. Any other name must be defined by creating a PriorityClass object with that name. If not specified, the pod priority will be default or zero if there is no default.
+     */
     @JsonProperty("priorityClassName")
     public String getPriorityClassName() {
         return priorityClassName;
     }
 
+    /**
+     * If specified, indicates the pod's priority. "system-node-critical" and "system-cluster-critical" are two special keywords which indicate the highest priorities with the former being the highest priority. Any other name must be defined by creating a PriorityClass object with that name. If not specified, the pod priority will be default or zero if there is no default.
+     */
     @JsonProperty("priorityClassName")
     public void setPriorityClassName(String priorityClassName) {
         this.priorityClassName = priorityClassName;
     }
 
+    /**
+     * AffinityAssistantTemplate holds pod specific configuration and is a subset of the generic pod Template
+     */
     @JsonProperty("securityContext")
     public PodSecurityContext getSecurityContext() {
         return securityContext;
     }
 
+    /**
+     * AffinityAssistantTemplate holds pod specific configuration and is a subset of the generic pod Template
+     */
     @JsonProperty("securityContext")
     public void setSecurityContext(PodSecurityContext securityContext) {
         this.securityContext = securityContext;
     }
 
+    /**
+     * If specified, the pod's tolerations.
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * If specified, the pod's tolerations.
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/pod/Template.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/pod/Template.java
index 4bdf6ba6d10..99476498169 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/pod/Template.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/pod/Template.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Template holds pod specific configuration
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -157,178 +160,280 @@ public Template(Affinity affinity, Boolean automountServiceAccountToken, PodDNSC
         this.volumes = volumes;
     }
 
+    /**
+     * Template holds pod specific configuration
+     */
     @JsonProperty("affinity")
     public Affinity getAffinity() {
         return affinity;
     }
 
+    /**
+     * Template holds pod specific configuration
+     */
     @JsonProperty("affinity")
     public void setAffinity(Affinity affinity) {
         this.affinity = affinity;
     }
 
+    /**
+     * AutomountServiceAccountToken indicates whether pods running as this service account should have an API token automatically mounted.
+     */
     @JsonProperty("automountServiceAccountToken")
     public Boolean getAutomountServiceAccountToken() {
         return automountServiceAccountToken;
     }
 
+    /**
+     * AutomountServiceAccountToken indicates whether pods running as this service account should have an API token automatically mounted.
+     */
     @JsonProperty("automountServiceAccountToken")
     public void setAutomountServiceAccountToken(Boolean automountServiceAccountToken) {
         this.automountServiceAccountToken = automountServiceAccountToken;
     }
 
+    /**
+     * Template holds pod specific configuration
+     */
     @JsonProperty("dnsConfig")
     public PodDNSConfig getDnsConfig() {
         return dnsConfig;
     }
 
+    /**
+     * Template holds pod specific configuration
+     */
     @JsonProperty("dnsConfig")
     public void setDnsConfig(PodDNSConfig dnsConfig) {
         this.dnsConfig = dnsConfig;
     }
 
+    /**
+     * Set DNS policy for the pod. Defaults to "ClusterFirst". Valid values are 'ClusterFirst', 'Default' or 'None'. DNS parameters given in DNSConfig will be merged with the policy selected with DNSPolicy.
+     */
     @JsonProperty("dnsPolicy")
     public String getDnsPolicy() {
         return dnsPolicy;
     }
 
+    /**
+     * Set DNS policy for the pod. Defaults to "ClusterFirst". Valid values are 'ClusterFirst', 'Default' or 'None'. DNS parameters given in DNSConfig will be merged with the policy selected with DNSPolicy.
+     */
     @JsonProperty("dnsPolicy")
     public void setDnsPolicy(String dnsPolicy) {
         this.dnsPolicy = dnsPolicy;
     }
 
+    /**
+     * EnableServiceLinks indicates whether information about services should be injected into pod's environment variables, matching the syntax of Docker links. Optional: Defaults to true.
+     */
     @JsonProperty("enableServiceLinks")
     public Boolean getEnableServiceLinks() {
         return enableServiceLinks;
     }
 
+    /**
+     * EnableServiceLinks indicates whether information about services should be injected into pod's environment variables, matching the syntax of Docker links. Optional: Defaults to true.
+     */
     @JsonProperty("enableServiceLinks")
     public void setEnableServiceLinks(Boolean enableServiceLinks) {
         this.enableServiceLinks = enableServiceLinks;
     }
 
+    /**
+     * List of environment variables that can be provided to the containers belonging to the pod.
+     */
     @JsonProperty("env")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvVar> getEnv() {
         return env;
     }
 
+    /**
+     * List of environment variables that can be provided to the containers belonging to the pod.
+     */
     @JsonProperty("env")
     public void setEnv(List<EnvVar> env) {
         this.env = env;
     }
 
+    /**
+     * HostAliases is an optional list of hosts and IPs that will be injected into the pod's hosts file if specified. This is only valid for non-hostNetwork pods.
+     */
     @JsonProperty("hostAliases")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HostAlias> getHostAliases() {
         return hostAliases;
     }
 
+    /**
+     * HostAliases is an optional list of hosts and IPs that will be injected into the pod's hosts file if specified. This is only valid for non-hostNetwork pods.
+     */
     @JsonProperty("hostAliases")
     public void setHostAliases(List<HostAlias> hostAliases) {
         this.hostAliases = hostAliases;
     }
 
+    /**
+     * HostNetwork specifies whether the pod may use the node network namespace
+     */
     @JsonProperty("hostNetwork")
     public Boolean getHostNetwork() {
         return hostNetwork;
     }
 
+    /**
+     * HostNetwork specifies whether the pod may use the node network namespace
+     */
     @JsonProperty("hostNetwork")
     public void setHostNetwork(Boolean hostNetwork) {
         this.hostNetwork = hostNetwork;
     }
 
+    /**
+     * ImagePullSecrets gives the name of the secret used by the pod to pull the image if specified
+     */
     @JsonProperty("imagePullSecrets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LocalObjectReference> getImagePullSecrets() {
         return imagePullSecrets;
     }
 
+    /**
+     * ImagePullSecrets gives the name of the secret used by the pod to pull the image if specified
+     */
     @JsonProperty("imagePullSecrets")
     public void setImagePullSecrets(List<LocalObjectReference> imagePullSecrets) {
         this.imagePullSecrets = imagePullSecrets;
     }
 
+    /**
+     * NodeSelector is a selector which must be true for the pod to fit on a node. Selector which must match a node's labels for the pod to be scheduled on that node. More info: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * NodeSelector is a selector which must be true for the pod to fit on a node. Selector which must match a node's labels for the pod to be scheduled on that node. More info: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * If specified, indicates the pod's priority. "system-node-critical" and "system-cluster-critical" are two special keywords which indicate the highest priorities with the former being the highest priority. Any other name must be defined by creating a PriorityClass object with that name. If not specified, the pod priority will be default or zero if there is no default.
+     */
     @JsonProperty("priorityClassName")
     public String getPriorityClassName() {
         return priorityClassName;
     }
 
+    /**
+     * If specified, indicates the pod's priority. "system-node-critical" and "system-cluster-critical" are two special keywords which indicate the highest priorities with the former being the highest priority. Any other name must be defined by creating a PriorityClass object with that name. If not specified, the pod priority will be default or zero if there is no default.
+     */
     @JsonProperty("priorityClassName")
     public void setPriorityClassName(String priorityClassName) {
         this.priorityClassName = priorityClassName;
     }
 
+    /**
+     * RuntimeClassName refers to a RuntimeClass object in the node.k8s.io group, which should be used to run this pod. If no RuntimeClass resource matches the named class, the pod will not be run. If unset or empty, the "legacy" RuntimeClass will be used, which is an implicit class with an empty definition that uses the default runtime handler. More info: https://git.k8s.io/enhancements/keps/sig-node/runtime-class.md This is a beta feature as of Kubernetes v1.14.
+     */
     @JsonProperty("runtimeClassName")
     public String getRuntimeClassName() {
         return runtimeClassName;
     }
 
+    /**
+     * RuntimeClassName refers to a RuntimeClass object in the node.k8s.io group, which should be used to run this pod. If no RuntimeClass resource matches the named class, the pod will not be run. If unset or empty, the "legacy" RuntimeClass will be used, which is an implicit class with an empty definition that uses the default runtime handler. More info: https://git.k8s.io/enhancements/keps/sig-node/runtime-class.md This is a beta feature as of Kubernetes v1.14.
+     */
     @JsonProperty("runtimeClassName")
     public void setRuntimeClassName(String runtimeClassName) {
         this.runtimeClassName = runtimeClassName;
     }
 
+    /**
+     * SchedulerName specifies the scheduler to be used to dispatch the Pod
+     */
     @JsonProperty("schedulerName")
     public String getSchedulerName() {
         return schedulerName;
     }
 
+    /**
+     * SchedulerName specifies the scheduler to be used to dispatch the Pod
+     */
     @JsonProperty("schedulerName")
     public void setSchedulerName(String schedulerName) {
         this.schedulerName = schedulerName;
     }
 
+    /**
+     * Template holds pod specific configuration
+     */
     @JsonProperty("securityContext")
     public PodSecurityContext getSecurityContext() {
         return securityContext;
     }
 
+    /**
+     * Template holds pod specific configuration
+     */
     @JsonProperty("securityContext")
     public void setSecurityContext(PodSecurityContext securityContext) {
         this.securityContext = securityContext;
     }
 
+    /**
+     * If specified, the pod's tolerations.
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * If specified, the pod's tolerations.
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
     }
 
+    /**
+     * TopologySpreadConstraints controls how Pods are spread across your cluster among failure-domains such as regions, zones, nodes, and other user-defined topology domains.
+     */
     @JsonProperty("topologySpreadConstraints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TopologySpreadConstraint> getTopologySpreadConstraints() {
         return topologySpreadConstraints;
     }
 
+    /**
+     * TopologySpreadConstraints controls how Pods are spread across your cluster among failure-domains such as regions, zones, nodes, and other user-defined topology domains.
+     */
     @JsonProperty("topologySpreadConstraints")
     public void setTopologySpreadConstraints(List<TopologySpreadConstraint> topologySpreadConstraints) {
         this.topologySpreadConstraints = topologySpreadConstraints;
     }
 
+    /**
+     * List of volumes that can be mounted by containers belonging to the pod. More info: https://kubernetes.io/docs/concepts/storage/volumes
+     */
     @JsonProperty("volumes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Volume> getVolumes() {
         return volumes;
     }
 
+    /**
+     * List of volumes that can be mounted by containers belonging to the pod. More info: https://kubernetes.io/docs/concepts/storage/volumes
+     */
     @JsonProperty("volumes")
     public void setVolumes(List<Volume> volumes) {
         this.volumes = volumes;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1alpha1/ResolutionRequest.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1alpha1/ResolutionRequest.java
index 810cb127ed2..0e79b8ea65c 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1alpha1/ResolutionRequest.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1alpha1/ResolutionRequest.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResolutionRequest is an object for requesting the content of a Tekton resource like a pipeline.yaml.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class ResolutionRequest implements Editable<ResolutionRequestBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resolution.tekton.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResolutionRequest";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ResolutionRequest(String apiVersion, String kind, ObjectMeta metadata, Re
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResolutionRequest is an object for requesting the content of a Tekton resource like a pipeline.yaml.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResolutionRequest is an object for requesting the content of a Tekton resource like a pipeline.yaml.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ResolutionRequest is an object for requesting the content of a Tekton resource like a pipeline.yaml.
+     */
     @JsonProperty("spec")
     public ResolutionRequestSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ResolutionRequest is an object for requesting the content of a Tekton resource like a pipeline.yaml.
+     */
     @JsonProperty("spec")
     public void setSpec(ResolutionRequestSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ResolutionRequest is an object for requesting the content of a Tekton resource like a pipeline.yaml.
+     */
     @JsonProperty("status")
     public ResolutionRequestStatus getStatus() {
         return status;
     }
 
+    /**
+     * ResolutionRequest is an object for requesting the content of a Tekton resource like a pipeline.yaml.
+     */
     @JsonProperty("status")
     public void setStatus(ResolutionRequestStatus status) {
         this.status = status;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1alpha1/ResolutionRequestList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1alpha1/ResolutionRequestList.java
index 9228deefaa4..b2a215e8109 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1alpha1/ResolutionRequestList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1alpha1/ResolutionRequestList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResolutionRequestList is a list of ResolutionRequests.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ResolutionRequestList implements Editable<ResolutionRequestListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.resolution.v1alpha1.ResolutionRequest>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resolution.tekton.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.resolution.v1alpha1.ResolutionRequest> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResolutionRequestList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ResolutionRequestList(String apiVersion, List<io.fabric8.tekton.resolutio
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ResolutionRequestList is a list of ResolutionRequests.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.resolution.v1alpha1.ResolutionRequest> getItems() {
         return items;
     }
 
+    /**
+     * ResolutionRequestList is a list of ResolutionRequests.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.resolution.v1alpha1.ResolutionRequest> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResolutionRequestList is a list of ResolutionRequests.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResolutionRequestList is a list of ResolutionRequests.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1alpha1/ResolutionRequestSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1alpha1/ResolutionRequestSpec.java
index da039a0daf7..83f8919e58a 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1alpha1/ResolutionRequestSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1alpha1/ResolutionRequestSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResolutionRequestSpec are all the fields in the spec of the ResolutionRequest CRD.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,12 +82,18 @@ public ResolutionRequestSpec(Map<String, String> params) {
         this.params = params;
     }
 
+    /**
+     * Parameters are the runtime attributes passed to the resolver to help it figure out how to resolve the resource being requested. For example: repo URL, commit SHA, path to file, the kind of authentication to leverage, etc.
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getParams() {
         return params;
     }
 
+    /**
+     * Parameters are the runtime attributes passed to the resolver to help it figure out how to resolve the resource being requested. For example: repo URL, commit SHA, path to file, the kind of authentication to leverage, etc.
+     */
     @JsonProperty("params")
     public void setParams(Map<String, String> params) {
         this.params = params;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1alpha1/ResolutionRequestStatus.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1alpha1/ResolutionRequestStatus.java
index 19753631e66..31492ad04d4 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1alpha1/ResolutionRequestStatus.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1alpha1/ResolutionRequestStatus.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResolutionRequestStatus are all the fields in a ResolutionRequest's status subresource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -100,53 +103,83 @@ public ResolutionRequestStatus(Map<String, String> annotations, List<Condition>
         this.refSource = refSource;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Data is a string representation of the resolved content of the requested resource in-lined into the ResolutionRequest object.
+     */
     @JsonProperty("data")
     public String getData() {
         return data;
     }
 
+    /**
+     * Data is a string representation of the resolved content of the requested resource in-lined into the ResolutionRequest object.
+     */
     @JsonProperty("data")
     public void setData(String data) {
         this.data = data;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * ResolutionRequestStatus are all the fields in a ResolutionRequest's status subresource.
+     */
     @JsonProperty("refSource")
     public RefSource getRefSource() {
         return refSource;
     }
 
+    /**
+     * ResolutionRequestStatus are all the fields in a ResolutionRequest's status subresource.
+     */
     @JsonProperty("refSource")
     public void setRefSource(RefSource refSource) {
         this.refSource = refSource;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1alpha1/ResolutionRequestStatusFields.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1alpha1/ResolutionRequestStatusFields.java
index 719055023c3..4b031f9ea32 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1alpha1/ResolutionRequestStatusFields.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1alpha1/ResolutionRequestStatusFields.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResolutionRequestStatusFields are the ResolutionRequest-specific fields for the status subresource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public ResolutionRequestStatusFields(String data, RefSource refSource) {
         this.refSource = refSource;
     }
 
+    /**
+     * Data is a string representation of the resolved content of the requested resource in-lined into the ResolutionRequest object.
+     */
     @JsonProperty("data")
     public String getData() {
         return data;
     }
 
+    /**
+     * Data is a string representation of the resolved content of the requested resource in-lined into the ResolutionRequest object.
+     */
     @JsonProperty("data")
     public void setData(String data) {
         this.data = data;
     }
 
+    /**
+     * ResolutionRequestStatusFields are the ResolutionRequest-specific fields for the status subresource.
+     */
     @JsonProperty("refSource")
     public RefSource getRefSource() {
         return refSource;
     }
 
+    /**
+     * ResolutionRequestStatusFields are the ResolutionRequest-specific fields for the status subresource.
+     */
     @JsonProperty("refSource")
     public void setRefSource(RefSource refSource) {
         this.refSource = refSource;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1beta1/ResolutionRequest.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1beta1/ResolutionRequest.java
index 34822914ea0..3494a1aae7f 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1beta1/ResolutionRequest.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1beta1/ResolutionRequest.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResolutionRequest is an object for requesting the content of a Tekton resource like a pipeline.yaml.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class ResolutionRequest implements Editable<ResolutionRequestBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resolution.tekton.dev/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResolutionRequest";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ResolutionRequest(String apiVersion, String kind, ObjectMeta metadata, Re
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResolutionRequest is an object for requesting the content of a Tekton resource like a pipeline.yaml.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResolutionRequest is an object for requesting the content of a Tekton resource like a pipeline.yaml.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ResolutionRequest is an object for requesting the content of a Tekton resource like a pipeline.yaml.
+     */
     @JsonProperty("spec")
     public ResolutionRequestSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ResolutionRequest is an object for requesting the content of a Tekton resource like a pipeline.yaml.
+     */
     @JsonProperty("spec")
     public void setSpec(ResolutionRequestSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ResolutionRequest is an object for requesting the content of a Tekton resource like a pipeline.yaml.
+     */
     @JsonProperty("status")
     public ResolutionRequestStatus getStatus() {
         return status;
     }
 
+    /**
+     * ResolutionRequest is an object for requesting the content of a Tekton resource like a pipeline.yaml.
+     */
     @JsonProperty("status")
     public void setStatus(ResolutionRequestStatus status) {
         this.status = status;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1beta1/ResolutionRequestList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1beta1/ResolutionRequestList.java
index 292bda0fccd..81efd64b0d3 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1beta1/ResolutionRequestList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1beta1/ResolutionRequestList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResolutionRequestList is a list of ResolutionRequests.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ResolutionRequestList implements Editable<ResolutionRequestListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.resolution.v1beta1.ResolutionRequest>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resolution.tekton.dev/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.resolution.v1beta1.ResolutionRequest> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResolutionRequestList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ResolutionRequestList(String apiVersion, List<io.fabric8.tekton.resolutio
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ResolutionRequestList is a list of ResolutionRequests.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.resolution.v1beta1.ResolutionRequest> getItems() {
         return items;
     }
 
+    /**
+     * ResolutionRequestList is a list of ResolutionRequests.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.resolution.v1beta1.ResolutionRequest> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResolutionRequestList is a list of ResolutionRequests.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResolutionRequestList is a list of ResolutionRequests.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1beta1/ResolutionRequestSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1beta1/ResolutionRequestSpec.java
index f66ea50cdae..f334ee8b770 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1beta1/ResolutionRequestSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1beta1/ResolutionRequestSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResolutionRequestSpec are all the fields in the spec of the ResolutionRequest CRD.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,22 +89,34 @@ public ResolutionRequestSpec(List<Param> params, String url) {
         this.url = url;
     }
 
+    /**
+     * Parameters are the runtime attributes passed to the resolver to help it figure out how to resolve the resource being requested. For example: repo URL, commit SHA, path to file, the kind of authentication to leverage, etc.
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Param> getParams() {
         return params;
     }
 
+    /**
+     * Parameters are the runtime attributes passed to the resolver to help it figure out how to resolve the resource being requested. For example: repo URL, commit SHA, path to file, the kind of authentication to leverage, etc.
+     */
     @JsonProperty("params")
     public void setParams(List<Param> params) {
         this.params = params;
     }
 
+    /**
+     * URL is the runtime url passed to the resolver to help it figure out how to resolver the resource being requested. This is currently at an ALPHA stability level and subject to alpha API compatibility policies.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * URL is the runtime url passed to the resolver to help it figure out how to resolver the resource being requested. This is currently at an ALPHA stability level and subject to alpha API compatibility policies.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1beta1/ResolutionRequestStatus.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1beta1/ResolutionRequestStatus.java
index f40ef780617..a6260e95656 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1beta1/ResolutionRequestStatus.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1beta1/ResolutionRequestStatus.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResolutionRequestStatus are all the fields in a ResolutionRequest's status subresource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -104,63 +107,99 @@ public ResolutionRequestStatus(Map<String, String> annotations, List<Condition>
         this.source = source;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Data is a string representation of the resolved content of the requested resource in-lined into the ResolutionRequest object.
+     */
     @JsonProperty("data")
     public String getData() {
         return data;
     }
 
+    /**
+     * Data is a string representation of the resolved content of the requested resource in-lined into the ResolutionRequest object.
+     */
     @JsonProperty("data")
     public void setData(String data) {
         this.data = data;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * ResolutionRequestStatus are all the fields in a ResolutionRequest's status subresource.
+     */
     @JsonProperty("refSource")
     public RefSource getRefSource() {
         return refSource;
     }
 
+    /**
+     * ResolutionRequestStatus are all the fields in a ResolutionRequest's status subresource.
+     */
     @JsonProperty("refSource")
     public void setRefSource(RefSource refSource) {
         this.refSource = refSource;
     }
 
+    /**
+     * ResolutionRequestStatus are all the fields in a ResolutionRequest's status subresource.
+     */
     @JsonProperty("source")
     public RefSource getSource() {
         return source;
     }
 
+    /**
+     * ResolutionRequestStatus are all the fields in a ResolutionRequest's status subresource.
+     */
     @JsonProperty("source")
     public void setSource(RefSource source) {
         this.source = source;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1beta1/ResolutionRequestStatusFields.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1beta1/ResolutionRequestStatusFields.java
index fbe974bb638..db00ba9931a 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1beta1/ResolutionRequestStatusFields.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/resolution/v1beta1/ResolutionRequestStatusFields.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResolutionRequestStatusFields are the ResolutionRequest-specific fields for the status subresource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,31 +90,49 @@ public ResolutionRequestStatusFields(String data, RefSource refSource, RefSource
         this.source = source;
     }
 
+    /**
+     * Data is a string representation of the resolved content of the requested resource in-lined into the ResolutionRequest object.
+     */
     @JsonProperty("data")
     public String getData() {
         return data;
     }
 
+    /**
+     * Data is a string representation of the resolved content of the requested resource in-lined into the ResolutionRequest object.
+     */
     @JsonProperty("data")
     public void setData(String data) {
         this.data = data;
     }
 
+    /**
+     * ResolutionRequestStatusFields are the ResolutionRequest-specific fields for the status subresource.
+     */
     @JsonProperty("refSource")
     public RefSource getRefSource() {
         return refSource;
     }
 
+    /**
+     * ResolutionRequestStatusFields are the ResolutionRequest-specific fields for the status subresource.
+     */
     @JsonProperty("refSource")
     public void setRefSource(RefSource refSource) {
         this.refSource = refSource;
     }
 
+    /**
+     * ResolutionRequestStatusFields are the ResolutionRequest-specific fields for the status subresource.
+     */
     @JsonProperty("source")
     public RefSource getSource() {
         return source;
     }
 
+    /**
+     * ResolutionRequestStatusFields are the ResolutionRequest-specific fields for the status subresource.
+     */
     @JsonProperty("source")
     public void setSource(RefSource source) {
         this.source = source;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/BitbucketInterceptor.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/BitbucketInterceptor.java
index ae6476c702b..2157a352724 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/BitbucketInterceptor.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/BitbucketInterceptor.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BitbucketInterceptor provides a webhook to intercept and pre-process events
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public BitbucketInterceptor(List<String> eventTypes, SecretRef secretRef) {
         this.secretRef = secretRef;
     }
 
+    /**
+     * BitbucketInterceptor provides a webhook to intercept and pre-process events
+     */
     @JsonProperty("eventTypes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEventTypes() {
         return eventTypes;
     }
 
+    /**
+     * BitbucketInterceptor provides a webhook to intercept and pre-process events
+     */
     @JsonProperty("eventTypes")
     public void setEventTypes(List<String> eventTypes) {
         this.eventTypes = eventTypes;
     }
 
+    /**
+     * BitbucketInterceptor provides a webhook to intercept and pre-process events
+     */
     @JsonProperty("secretRef")
     public SecretRef getSecretRef() {
         return secretRef;
     }
 
+    /**
+     * BitbucketInterceptor provides a webhook to intercept and pre-process events
+     */
     @JsonProperty("secretRef")
     public void setSecretRef(SecretRef secretRef) {
         this.secretRef = secretRef;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/CELInterceptor.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/CELInterceptor.java
index d5c271a73c0..1cf12fc188d 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/CELInterceptor.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/CELInterceptor.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CELInterceptor provides a webhook to intercept and pre-process events
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public CELInterceptor(String filter, List<CELOverlay> overlays) {
         this.overlays = overlays;
     }
 
+    /**
+     * CELInterceptor provides a webhook to intercept and pre-process events
+     */
     @JsonProperty("filter")
     public String getFilter() {
         return filter;
     }
 
+    /**
+     * CELInterceptor provides a webhook to intercept and pre-process events
+     */
     @JsonProperty("filter")
     public void setFilter(String filter) {
         this.filter = filter;
     }
 
+    /**
+     * CELInterceptor provides a webhook to intercept and pre-process events
+     */
     @JsonProperty("overlays")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CELOverlay> getOverlays() {
         return overlays;
     }
 
+    /**
+     * CELInterceptor provides a webhook to intercept and pre-process events
+     */
     @JsonProperty("overlays")
     public void setOverlays(List<CELOverlay> overlays) {
         this.overlays = overlays;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/CELOverlay.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/CELOverlay.java
index 2f77fc3b02b..4adcb3d1bb7 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/CELOverlay.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/CELOverlay.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CELOverlay provides a way to modify the request body using DeprecatedCEL expressions
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public CELOverlay(String expression, String key) {
         this.key = key;
     }
 
+    /**
+     * CELOverlay provides a way to modify the request body using DeprecatedCEL expressions
+     */
     @JsonProperty("expression")
     public String getExpression() {
         return expression;
     }
 
+    /**
+     * CELOverlay provides a way to modify the request body using DeprecatedCEL expressions
+     */
     @JsonProperty("expression")
     public void setExpression(String expression) {
         this.expression = expression;
     }
 
+    /**
+     * CELOverlay provides a way to modify the request body using DeprecatedCEL expressions
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * CELOverlay provides a way to modify the request body using DeprecatedCEL expressions
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ClientConfig.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ClientConfig.java
index de2c93f31e8..e86184f2aa8 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ClientConfig.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ClientConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClientConfig describes how a client can communicate with the Interceptor
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ClientConfig(String caBundle, ServiceReference service, String url) {
         this.url = url;
     }
 
+    /**
+     * CaBundle is a PEM encoded CA bundle which will be used to validate the clusterinterceptor server certificate
+     */
     @JsonProperty("caBundle")
     public String getCaBundle() {
         return caBundle;
     }
 
+    /**
+     * CaBundle is a PEM encoded CA bundle which will be used to validate the clusterinterceptor server certificate
+     */
     @JsonProperty("caBundle")
     public void setCaBundle(String caBundle) {
         this.caBundle = caBundle;
     }
 
+    /**
+     * ClientConfig describes how a client can communicate with the Interceptor
+     */
     @JsonProperty("service")
     public ServiceReference getService() {
         return service;
     }
 
+    /**
+     * ClientConfig describes how a client can communicate with the Interceptor
+     */
     @JsonProperty("service")
     public void setService(ServiceReference service) {
         this.service = service;
     }
 
+    /**
+     * ClientConfig describes how a client can communicate with the Interceptor
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * ClientConfig describes how a client can communicate with the Interceptor
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ClusterInterceptor.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ClusterInterceptor.java
index fe28931c3b5..a0703d1917d 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ClusterInterceptor.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ClusterInterceptor.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterInterceptor describes a pluggable interceptor including configuration such as the fields it accepts and its deployment address. The type is based on the Validating/MutatingWebhookConfiguration types for configuring AdmissionWebhooks
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ClusterInterceptor implements Editable<ClusterInterceptorBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "triggers.tekton.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterInterceptor";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public ClusterInterceptor(String apiVersion, String kind, ObjectMeta metadata, C
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterInterceptor describes a pluggable interceptor including configuration such as the fields it accepts and its deployment address. The type is based on the Validating/MutatingWebhookConfiguration types for configuring AdmissionWebhooks
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterInterceptor describes a pluggable interceptor including configuration such as the fields it accepts and its deployment address. The type is based on the Validating/MutatingWebhookConfiguration types for configuring AdmissionWebhooks
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ClusterInterceptor describes a pluggable interceptor including configuration such as the fields it accepts and its deployment address. The type is based on the Validating/MutatingWebhookConfiguration types for configuring AdmissionWebhooks
+     */
     @JsonProperty("spec")
     public ClusterInterceptorSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ClusterInterceptor describes a pluggable interceptor including configuration such as the fields it accepts and its deployment address. The type is based on the Validating/MutatingWebhookConfiguration types for configuring AdmissionWebhooks
+     */
     @JsonProperty("spec")
     public void setSpec(ClusterInterceptorSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ClusterInterceptor describes a pluggable interceptor including configuration such as the fields it accepts and its deployment address. The type is based on the Validating/MutatingWebhookConfiguration types for configuring AdmissionWebhooks
+     */
     @JsonProperty("status")
     public ClusterInterceptorStatus getStatus() {
         return status;
     }
 
+    /**
+     * ClusterInterceptor describes a pluggable interceptor including configuration such as the fields it accepts and its deployment address. The type is based on the Validating/MutatingWebhookConfiguration types for configuring AdmissionWebhooks
+     */
     @JsonProperty("status")
     public void setStatus(ClusterInterceptorStatus status) {
         this.status = status;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ClusterInterceptorList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ClusterInterceptorList.java
index c20482e7794..06406f291c5 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ClusterInterceptorList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ClusterInterceptorList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterInterceptorList contains a list of ClusterInterceptor We don't use this but it's required for certain codegen features.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ClusterInterceptorList implements Editable<ClusterInterceptorListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.triggers.v1alpha1.ClusterInterceptor>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "triggers.tekton.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.triggers.v1alpha1.ClusterInterceptor> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterInterceptorList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterInterceptorList(String apiVersion, List<io.fabric8.tekton.triggers
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ClusterInterceptorList contains a list of ClusterInterceptor We don't use this but it's required for certain codegen features.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.triggers.v1alpha1.ClusterInterceptor> getItems() {
         return items;
     }
 
+    /**
+     * ClusterInterceptorList contains a list of ClusterInterceptor We don't use this but it's required for certain codegen features.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.triggers.v1alpha1.ClusterInterceptor> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterInterceptorList contains a list of ClusterInterceptor We don't use this but it's required for certain codegen features.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterInterceptorList contains a list of ClusterInterceptor We don't use this but it's required for certain codegen features.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ClusterInterceptorSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ClusterInterceptorSpec.java
index d03ffe0e5ca..68391ff1914 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ClusterInterceptorSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ClusterInterceptorSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterInterceptorSpec describes the Spec for an ClusterInterceptor
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ClusterInterceptorSpec(ClientConfig clientConfig) {
         this.clientConfig = clientConfig;
     }
 
+    /**
+     * ClusterInterceptorSpec describes the Spec for an ClusterInterceptor
+     */
     @JsonProperty("clientConfig")
     public ClientConfig getClientConfig() {
         return clientConfig;
     }
 
+    /**
+     * ClusterInterceptorSpec describes the Spec for an ClusterInterceptor
+     */
     @JsonProperty("clientConfig")
     public void setClientConfig(ClientConfig clientConfig) {
         this.clientConfig = clientConfig;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ClusterInterceptorStatus.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ClusterInterceptorStatus.java
index abb8d2ce7be..903d801faa9 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ClusterInterceptorStatus.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ClusterInterceptorStatus.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterInterceptorStatus holds the status of the ClusterInterceptor
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,54 +104,84 @@ public ClusterInterceptorStatus(Addressable address, List<Addressable> addresses
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * ClusterInterceptorStatus holds the status of the ClusterInterceptor
+     */
     @JsonProperty("address")
     public Addressable getAddress() {
         return address;
     }
 
+    /**
+     * ClusterInterceptorStatus holds the status of the ClusterInterceptor
+     */
     @JsonProperty("address")
     public void setAddress(Addressable address) {
         this.address = address;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Addressable> getAddresses() {
         return addresses;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<Addressable> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ClusterTriggerBinding.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ClusterTriggerBinding.java
index bde7169a438..d949253a75a 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ClusterTriggerBinding.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ClusterTriggerBinding.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterTriggerBinding is a TriggerBinding with a cluster scope. ClusterTriggerBindings are used to represent TriggerBindings that should be publicly addressable from any namespace in the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ClusterTriggerBinding implements Editable<ClusterTriggerBindingBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "triggers.tekton.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterTriggerBinding";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public ClusterTriggerBinding(String apiVersion, String kind, ObjectMeta metadata
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterTriggerBinding is a TriggerBinding with a cluster scope. ClusterTriggerBindings are used to represent TriggerBindings that should be publicly addressable from any namespace in the cluster.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterTriggerBinding is a TriggerBinding with a cluster scope. ClusterTriggerBindings are used to represent TriggerBindings that should be publicly addressable from any namespace in the cluster.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ClusterTriggerBinding is a TriggerBinding with a cluster scope. ClusterTriggerBindings are used to represent TriggerBindings that should be publicly addressable from any namespace in the cluster.
+     */
     @JsonProperty("spec")
     public TriggerBindingSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ClusterTriggerBinding is a TriggerBinding with a cluster scope. ClusterTriggerBindings are used to represent TriggerBindings that should be publicly addressable from any namespace in the cluster.
+     */
     @JsonProperty("spec")
     public void setSpec(TriggerBindingSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ClusterTriggerBinding is a TriggerBinding with a cluster scope. ClusterTriggerBindings are used to represent TriggerBindings that should be publicly addressable from any namespace in the cluster.
+     */
     @JsonProperty("status")
     public TriggerBindingStatus getStatus() {
         return status;
     }
 
+    /**
+     * ClusterTriggerBinding is a TriggerBinding with a cluster scope. ClusterTriggerBindings are used to represent TriggerBindings that should be publicly addressable from any namespace in the cluster.
+     */
     @JsonProperty("status")
     public void setStatus(TriggerBindingStatus status) {
         this.status = status;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ClusterTriggerBindingList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ClusterTriggerBindingList.java
index 8385cdbf59c..d2b93289aab 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ClusterTriggerBindingList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ClusterTriggerBindingList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterTriggerBindingList contains a list of ClusterTriggerBinding
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ClusterTriggerBindingList implements Editable<ClusterTriggerBindingListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.triggers.v1alpha1.ClusterTriggerBinding>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "triggers.tekton.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.triggers.v1alpha1.ClusterTriggerBinding> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterTriggerBindingList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterTriggerBindingList(String apiVersion, List<io.fabric8.tekton.trigg
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ClusterTriggerBindingList contains a list of ClusterTriggerBinding
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.triggers.v1alpha1.ClusterTriggerBinding> getItems() {
         return items;
     }
 
+    /**
+     * ClusterTriggerBindingList contains a list of ClusterTriggerBinding
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.triggers.v1alpha1.ClusterTriggerBinding> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterTriggerBindingList contains a list of ClusterTriggerBinding
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterTriggerBindingList contains a list of ClusterTriggerBinding
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/EventListener.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/EventListener.java
index 06125551fd8..3e376547d0f 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/EventListener.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/EventListener.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventListener exposes a service to accept HTTP event payloads.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class EventListener implements Editable<EventListenerBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "triggers.tekton.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EventListener";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EventListener(String apiVersion, String kind, ObjectMeta metadata, EventL
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EventListener exposes a service to accept HTTP event payloads.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EventListener exposes a service to accept HTTP event payloads.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * EventListener exposes a service to accept HTTP event payloads.
+     */
     @JsonProperty("spec")
     public EventListenerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * EventListener exposes a service to accept HTTP event payloads.
+     */
     @JsonProperty("spec")
     public void setSpec(EventListenerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * EventListener exposes a service to accept HTTP event payloads.
+     */
     @JsonProperty("status")
     public EventListenerStatus getStatus() {
         return status;
     }
 
+    /**
+     * EventListener exposes a service to accept HTTP event payloads.
+     */
     @JsonProperty("status")
     public void setStatus(EventListenerStatus status) {
         this.status = status;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/EventListenerConfig.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/EventListenerConfig.java
index 5e7146df72b..bb73a2b1c0a 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/EventListenerConfig.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/EventListenerConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventListenerConfig stores configuration for resources generated by the EventListener
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public EventListenerConfig(String generatedName) {
         this.generatedName = generatedName;
     }
 
+    /**
+     * GeneratedResourceName is the name given to all resources reconciled by the EventListener
+     */
     @JsonProperty("generatedName")
     public String getGeneratedName() {
         return generatedName;
     }
 
+    /**
+     * GeneratedResourceName is the name given to all resources reconciled by the EventListener
+     */
     @JsonProperty("generatedName")
     public void setGeneratedName(String generatedName) {
         this.generatedName = generatedName;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/EventListenerList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/EventListenerList.java
index 3dd304214bd..f059cf2ecea 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/EventListenerList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/EventListenerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventListenerList contains a list of TriggerBinding
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class EventListenerList implements Editable<EventListenerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.triggers.v1alpha1.EventListener>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "triggers.tekton.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.triggers.v1alpha1.EventListener> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EventListenerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EventListenerList(String apiVersion, List<io.fabric8.tekton.triggers.v1al
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * EventListenerList contains a list of TriggerBinding
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.triggers.v1alpha1.EventListener> getItems() {
         return items;
     }
 
+    /**
+     * EventListenerList contains a list of TriggerBinding
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.triggers.v1alpha1.EventListener> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EventListenerList contains a list of TriggerBinding
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EventListenerList contains a list of TriggerBinding
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/EventListenerSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/EventListenerSpec.java
index 188439246ca..79806ef7bbc 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/EventListenerSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/EventListenerSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventListenerSpec defines the desired state of the EventListener, represented by a list of Triggers.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -97,52 +100,82 @@ public EventListenerSpec(LabelSelector labelSelector, NamespaceSelector namespac
         this.triggers = triggers;
     }
 
+    /**
+     * EventListenerSpec defines the desired state of the EventListener, represented by a list of Triggers.
+     */
     @JsonProperty("labelSelector")
     public LabelSelector getLabelSelector() {
         return labelSelector;
     }
 
+    /**
+     * EventListenerSpec defines the desired state of the EventListener, represented by a list of Triggers.
+     */
     @JsonProperty("labelSelector")
     public void setLabelSelector(LabelSelector labelSelector) {
         this.labelSelector = labelSelector;
     }
 
+    /**
+     * EventListenerSpec defines the desired state of the EventListener, represented by a list of Triggers.
+     */
     @JsonProperty("namespaceSelector")
     public NamespaceSelector getNamespaceSelector() {
         return namespaceSelector;
     }
 
+    /**
+     * EventListenerSpec defines the desired state of the EventListener, represented by a list of Triggers.
+     */
     @JsonProperty("namespaceSelector")
     public void setNamespaceSelector(NamespaceSelector namespaceSelector) {
         this.namespaceSelector = namespaceSelector;
     }
 
+    /**
+     * EventListenerSpec defines the desired state of the EventListener, represented by a list of Triggers.
+     */
     @JsonProperty("resources")
     public Resources getResources() {
         return resources;
     }
 
+    /**
+     * EventListenerSpec defines the desired state of the EventListener, represented by a list of Triggers.
+     */
     @JsonProperty("resources")
     public void setResources(Resources resources) {
         this.resources = resources;
     }
 
+    /**
+     * EventListenerSpec defines the desired state of the EventListener, represented by a list of Triggers.
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * EventListenerSpec defines the desired state of the EventListener, represented by a list of Triggers.
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * EventListenerSpec defines the desired state of the EventListener, represented by a list of Triggers.
+     */
     @JsonProperty("triggers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EventListenerTrigger> getTriggers() {
         return triggers;
     }
 
+    /**
+     * EventListenerSpec defines the desired state of the EventListener, represented by a list of Triggers.
+     */
     @JsonProperty("triggers")
     public void setTriggers(List<EventListenerTrigger> triggers) {
         this.triggers = triggers;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/EventListenerStatus.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/EventListenerStatus.java
index a5e2e0672ee..50d675652f6 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/EventListenerStatus.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/EventListenerStatus.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventListenerStatus holds the status of the EventListener
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -105,64 +108,100 @@ public EventListenerStatus(Addressable address, List<Addressable> addresses, Map
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * EventListenerStatus holds the status of the EventListener
+     */
     @JsonProperty("address")
     public Addressable getAddress() {
         return address;
     }
 
+    /**
+     * EventListenerStatus holds the status of the EventListener
+     */
     @JsonProperty("address")
     public void setAddress(Addressable address) {
         this.address = address;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Addressable> getAddresses() {
         return addresses;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<Addressable> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * EventListenerStatus holds the status of the EventListener
+     */
     @JsonProperty("configuration")
     public EventListenerConfig getConfiguration() {
         return configuration;
     }
 
+    /**
+     * EventListenerStatus holds the status of the EventListener
+     */
     @JsonProperty("configuration")
     public void setConfiguration(EventListenerConfig configuration) {
         this.configuration = configuration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/EventListenerTrigger.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/EventListenerTrigger.java
index 6aa469238d2..a760db37d8f 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/EventListenerTrigger.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/EventListenerTrigger.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventListenerTrigger represents a connection between TriggerBinding, Params, and TriggerTemplate; TriggerBinding provides extracted values for TriggerTemplate to then create resources from. TriggerRef can also be provided instead of TriggerBinding, Interceptors and TriggerTemplate
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,63 +105,99 @@ public EventListenerTrigger(List<TriggerSpecBinding> bindings, List<TriggerInter
         this.triggerRef = triggerRef;
     }
 
+    /**
+     * EventListenerTrigger represents a connection between TriggerBinding, Params, and TriggerTemplate; TriggerBinding provides extracted values for TriggerTemplate to then create resources from. TriggerRef can also be provided instead of TriggerBinding, Interceptors and TriggerTemplate
+     */
     @JsonProperty("bindings")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TriggerSpecBinding> getBindings() {
         return bindings;
     }
 
+    /**
+     * EventListenerTrigger represents a connection between TriggerBinding, Params, and TriggerTemplate; TriggerBinding provides extracted values for TriggerTemplate to then create resources from. TriggerRef can also be provided instead of TriggerBinding, Interceptors and TriggerTemplate
+     */
     @JsonProperty("bindings")
     public void setBindings(List<TriggerSpecBinding> bindings) {
         this.bindings = bindings;
     }
 
+    /**
+     * EventListenerTrigger represents a connection between TriggerBinding, Params, and TriggerTemplate; TriggerBinding provides extracted values for TriggerTemplate to then create resources from. TriggerRef can also be provided instead of TriggerBinding, Interceptors and TriggerTemplate
+     */
     @JsonProperty("interceptors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TriggerInterceptor> getInterceptors() {
         return interceptors;
     }
 
+    /**
+     * EventListenerTrigger represents a connection between TriggerBinding, Params, and TriggerTemplate; TriggerBinding provides extracted values for TriggerTemplate to then create resources from. TriggerRef can also be provided instead of TriggerBinding, Interceptors and TriggerTemplate
+     */
     @JsonProperty("interceptors")
     public void setInterceptors(List<TriggerInterceptor> interceptors) {
         this.interceptors = interceptors;
     }
 
+    /**
+     * EventListenerTrigger represents a connection between TriggerBinding, Params, and TriggerTemplate; TriggerBinding provides extracted values for TriggerTemplate to then create resources from. TriggerRef can also be provided instead of TriggerBinding, Interceptors and TriggerTemplate
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * EventListenerTrigger represents a connection between TriggerBinding, Params, and TriggerTemplate; TriggerBinding provides extracted values for TriggerTemplate to then create resources from. TriggerRef can also be provided instead of TriggerBinding, Interceptors and TriggerTemplate
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * ServiceAccountName optionally associates credentials with each trigger; more granular authorization for who is allowed to utilize the associated pipeline vs. defaulting to whatever permissions are associated with the entire EventListener and associated sink facilitates multi-tenant model based scenarios
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * ServiceAccountName optionally associates credentials with each trigger; more granular authorization for who is allowed to utilize the associated pipeline vs. defaulting to whatever permissions are associated with the entire EventListener and associated sink facilitates multi-tenant model based scenarios
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * EventListenerTrigger represents a connection between TriggerBinding, Params, and TriggerTemplate; TriggerBinding provides extracted values for TriggerTemplate to then create resources from. TriggerRef can also be provided instead of TriggerBinding, Interceptors and TriggerTemplate
+     */
     @JsonProperty("template")
     public TriggerSpecTemplate getTemplate() {
         return template;
     }
 
+    /**
+     * EventListenerTrigger represents a connection between TriggerBinding, Params, and TriggerTemplate; TriggerBinding provides extracted values for TriggerTemplate to then create resources from. TriggerRef can also be provided instead of TriggerBinding, Interceptors and TriggerTemplate
+     */
     @JsonProperty("template")
     public void setTemplate(TriggerSpecTemplate template) {
         this.template = template;
     }
 
+    /**
+     * EventListenerTrigger represents a connection between TriggerBinding, Params, and TriggerTemplate; TriggerBinding provides extracted values for TriggerTemplate to then create resources from. TriggerRef can also be provided instead of TriggerBinding, Interceptors and TriggerTemplate
+     */
     @JsonProperty("triggerRef")
     public String getTriggerRef() {
         return triggerRef;
     }
 
+    /**
+     * EventListenerTrigger represents a connection between TriggerBinding, Params, and TriggerTemplate; TriggerBinding provides extracted values for TriggerTemplate to then create resources from. TriggerRef can also be provided instead of TriggerBinding, Interceptors and TriggerTemplate
+     */
     @JsonProperty("triggerRef")
     public void setTriggerRef(String triggerRef) {
         this.triggerRef = triggerRef;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/GitHubInterceptor.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/GitHubInterceptor.java
index 60927c61d01..1c263c3d6b0 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/GitHubInterceptor.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/GitHubInterceptor.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GitHubInterceptor provides a webhook to intercept and pre-process events
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public GitHubInterceptor(List<String> eventTypes, SecretRef secretRef) {
         this.secretRef = secretRef;
     }
 
+    /**
+     * GitHubInterceptor provides a webhook to intercept and pre-process events
+     */
     @JsonProperty("eventTypes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEventTypes() {
         return eventTypes;
     }
 
+    /**
+     * GitHubInterceptor provides a webhook to intercept and pre-process events
+     */
     @JsonProperty("eventTypes")
     public void setEventTypes(List<String> eventTypes) {
         this.eventTypes = eventTypes;
     }
 
+    /**
+     * GitHubInterceptor provides a webhook to intercept and pre-process events
+     */
     @JsonProperty("secretRef")
     public SecretRef getSecretRef() {
         return secretRef;
     }
 
+    /**
+     * GitHubInterceptor provides a webhook to intercept and pre-process events
+     */
     @JsonProperty("secretRef")
     public void setSecretRef(SecretRef secretRef) {
         this.secretRef = secretRef;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/GitLabInterceptor.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/GitLabInterceptor.java
index bb17f53ae5b..c78f12deef2 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/GitLabInterceptor.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/GitLabInterceptor.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GitLabInterceptor provides a webhook to intercept and pre-process events
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public GitLabInterceptor(List<String> eventTypes, SecretRef secretRef) {
         this.secretRef = secretRef;
     }
 
+    /**
+     * GitLabInterceptor provides a webhook to intercept and pre-process events
+     */
     @JsonProperty("eventTypes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEventTypes() {
         return eventTypes;
     }
 
+    /**
+     * GitLabInterceptor provides a webhook to intercept and pre-process events
+     */
     @JsonProperty("eventTypes")
     public void setEventTypes(List<String> eventTypes) {
         this.eventTypes = eventTypes;
     }
 
+    /**
+     * GitLabInterceptor provides a webhook to intercept and pre-process events
+     */
     @JsonProperty("secretRef")
     public SecretRef getSecretRef() {
         return secretRef;
     }
 
+    /**
+     * GitLabInterceptor provides a webhook to intercept and pre-process events
+     */
     @JsonProperty("secretRef")
     public void setSecretRef(SecretRef secretRef) {
         this.secretRef = secretRef;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/Interceptor.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/Interceptor.java
index f23e33ebc6d..e8a19f10ada 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/Interceptor.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/Interceptor.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Interceptor describes a pluggable interceptor including configuration such as the fields it accepts and its deployment address. The type is based on the Validating/MutatingWebhookConfiguration types for configuring AdmissionWebhooks
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Interceptor implements Editable<InterceptorBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "triggers.tekton.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Interceptor";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Interceptor(String apiVersion, String kind, ObjectMeta metadata, Intercep
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Interceptor describes a pluggable interceptor including configuration such as the fields it accepts and its deployment address. The type is based on the Validating/MutatingWebhookConfiguration types for configuring AdmissionWebhooks
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Interceptor describes a pluggable interceptor including configuration such as the fields it accepts and its deployment address. The type is based on the Validating/MutatingWebhookConfiguration types for configuring AdmissionWebhooks
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Interceptor describes a pluggable interceptor including configuration such as the fields it accepts and its deployment address. The type is based on the Validating/MutatingWebhookConfiguration types for configuring AdmissionWebhooks
+     */
     @JsonProperty("spec")
     public InterceptorSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Interceptor describes a pluggable interceptor including configuration such as the fields it accepts and its deployment address. The type is based on the Validating/MutatingWebhookConfiguration types for configuring AdmissionWebhooks
+     */
     @JsonProperty("spec")
     public void setSpec(InterceptorSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Interceptor describes a pluggable interceptor including configuration such as the fields it accepts and its deployment address. The type is based on the Validating/MutatingWebhookConfiguration types for configuring AdmissionWebhooks
+     */
     @JsonProperty("status")
     public InterceptorStatus getStatus() {
         return status;
     }
 
+    /**
+     * Interceptor describes a pluggable interceptor including configuration such as the fields it accepts and its deployment address. The type is based on the Validating/MutatingWebhookConfiguration types for configuring AdmissionWebhooks
+     */
     @JsonProperty("status")
     public void setStatus(InterceptorStatus status) {
         this.status = status;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/InterceptorList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/InterceptorList.java
index 591b46114c5..1f60403c3ca 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/InterceptorList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/InterceptorList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * InterceptorList contains a list of Interceptor We don't use this but it's required for certain codegen features.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class InterceptorList implements Editable<InterceptorListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.triggers.v1alpha1.Interceptor>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "triggers.tekton.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.triggers.v1alpha1.Interceptor> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "InterceptorList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public InterceptorList(String apiVersion, List<io.fabric8.tekton.triggers.v1alph
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * InterceptorList contains a list of Interceptor We don't use this but it's required for certain codegen features.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.triggers.v1alpha1.Interceptor> getItems() {
         return items;
     }
 
+    /**
+     * InterceptorList contains a list of Interceptor We don't use this but it's required for certain codegen features.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.triggers.v1alpha1.Interceptor> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * InterceptorList contains a list of Interceptor We don't use this but it's required for certain codegen features.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * InterceptorList contains a list of Interceptor We don't use this but it's required for certain codegen features.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/InterceptorParams.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/InterceptorParams.java
index 29a965a08d1..12669aebfae 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/InterceptorParams.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/InterceptorParams.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * InterceptorParams defines a key-value pair that can be passed on an interceptor
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public InterceptorParams(String name, JsonNode value) {
         this.value = value;
     }
 
+    /**
+     * InterceptorParams defines a key-value pair that can be passed on an interceptor
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * InterceptorParams defines a key-value pair that can be passed on an interceptor
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * InterceptorParams defines a key-value pair that can be passed on an interceptor
+     */
     @JsonProperty("value")
     public JsonNode getValue() {
         return value;
     }
 
+    /**
+     * InterceptorParams defines a key-value pair that can be passed on an interceptor
+     */
     @JsonProperty("value")
     public void setValue(JsonNode value) {
         this.value = value;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/InterceptorRef.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/InterceptorRef.java
index 7de957c36fb..b3957a22930 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/InterceptorRef.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/InterceptorRef.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * InterceptorRef provides a Reference to a ClusterInterceptor
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public InterceptorRef(String apiVersion, String kind, String name) {
         this.name = name;
     }
 
+    /**
+     * API version of the referent
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * API version of the referent
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * InterceptorKind indicates the kind of the Interceptor, namespaced or cluster scoped.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * InterceptorKind indicates the kind of the Interceptor, namespaced or cluster scoped.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name of the referent; More info: http://kubernetes.io/docs/user-guide/identifiers#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referent; More info: http://kubernetes.io/docs/user-guide/identifiers#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/InterceptorRequest.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/InterceptorRequest.java
index de77ca6e878..2fc1118a730 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/InterceptorRequest.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/InterceptorRequest.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Do not generate DeepCopy(). See #827
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -100,55 +103,85 @@ public InterceptorRequest(String body, TriggerContext context, Map<String, Objec
         this.interceptorParams = interceptorParams;
     }
 
+    /**
+     * Body is the incoming HTTP event body. We use a "string" representation of the JSON body in order to preserve the body exactly as it was sent (including spaces etc.). This is necessary for some interceptors e.g. GitHub for validating the body with a signature. While []byte can also store an exact representation of the body, `json.Marshal` will compact []byte to a base64 encoded string which means that we will lose the spaces any time we marshal this struct.
+     */
     @JsonProperty("body")
     public String getBody() {
         return body;
     }
 
+    /**
+     * Body is the incoming HTTP event body. We use a "string" representation of the JSON body in order to preserve the body exactly as it was sent (including spaces etc.). This is necessary for some interceptors e.g. GitHub for validating the body with a signature. While []byte can also store an exact representation of the body, `json.Marshal` will compact []byte to a base64 encoded string which means that we will lose the spaces any time we marshal this struct.
+     */
     @JsonProperty("body")
     public void setBody(String body) {
         this.body = body;
     }
 
+    /**
+     * Do not generate DeepCopy(). See #827
+     */
     @JsonProperty("context")
     public TriggerContext getContext() {
         return context;
     }
 
+    /**
+     * Do not generate DeepCopy(). See #827
+     */
     @JsonProperty("context")
     public void setContext(TriggerContext context) {
         this.context = context;
     }
 
+    /**
+     * Extensions are extra values that are added by previous interceptors in a chain
+     */
     @JsonProperty("extensions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Object> getExtensions() {
         return extensions;
     }
 
+    /**
+     * Extensions are extra values that are added by previous interceptors in a chain
+     */
     @JsonProperty("extensions")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializerForMap.class)
     public void setExtensions(Map<String, Object> extensions) {
         this.extensions = extensions;
     }
 
+    /**
+     * Header are the headers for the incoming HTTP event
+     */
     @JsonProperty("header")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<String>> getHeader() {
         return header;
     }
 
+    /**
+     * Header are the headers for the incoming HTTP event
+     */
     @JsonProperty("header")
     public void setHeader(Map<String, List<String>> header) {
         this.header = header;
     }
 
+    /**
+     * InterceptorParams are the user specified params for interceptor in the Trigger
+     */
     @JsonProperty("interceptor_params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Object> getInterceptorParams() {
         return interceptorParams;
     }
 
+    /**
+     * InterceptorParams are the user specified params for interceptor in the Trigger
+     */
     @JsonProperty("interceptor_params")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializerForMap.class)
     public void setInterceptorParams(Map<String, Object> interceptorParams) {
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/InterceptorResponse.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/InterceptorResponse.java
index a00ad152ed3..d5c6319493c 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/InterceptorResponse.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/InterceptorResponse.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Do not generate Deepcopy(). See #827
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -88,33 +91,51 @@ public InterceptorResponse(Boolean _continue, Map<String, Object> extensions, St
         this.status = status;
     }
 
+    /**
+     * Continue indicates if the EventListener should continue processing the Trigger or not
+     */
     @JsonProperty("continue")
     public Boolean getContinue() {
         return _continue;
     }
 
+    /**
+     * Continue indicates if the EventListener should continue processing the Trigger or not
+     */
     @JsonProperty("continue")
     public void setContinue(Boolean _continue) {
         this._continue = _continue;
     }
 
+    /**
+     * Extensions are additional fields that is added to the interceptor event.
+     */
     @JsonProperty("extensions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Object> getExtensions() {
         return extensions;
     }
 
+    /**
+     * Extensions are additional fields that is added to the interceptor event.
+     */
     @JsonProperty("extensions")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializerForMap.class)
     public void setExtensions(Map<String, Object> extensions) {
         this.extensions = extensions;
     }
 
+    /**
+     * Do not generate Deepcopy(). See #827
+     */
     @JsonProperty("status")
     public Status getStatus() {
         return status;
     }
 
+    /**
+     * Do not generate Deepcopy(). See #827
+     */
     @JsonProperty("status")
     public void setStatus(Status status) {
         this.status = status;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/InterceptorSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/InterceptorSpec.java
index 6fb6c42a9da..f60631ce114 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/InterceptorSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/InterceptorSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * InterceptorSpec describes the Spec for an Interceptor
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public InterceptorSpec(ClientConfig clientConfig) {
         this.clientConfig = clientConfig;
     }
 
+    /**
+     * InterceptorSpec describes the Spec for an Interceptor
+     */
     @JsonProperty("clientConfig")
     public ClientConfig getClientConfig() {
         return clientConfig;
     }
 
+    /**
+     * InterceptorSpec describes the Spec for an Interceptor
+     */
     @JsonProperty("clientConfig")
     public void setClientConfig(ClientConfig clientConfig) {
         this.clientConfig = clientConfig;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/InterceptorStatus.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/InterceptorStatus.java
index 53303798386..4919cf2abdf 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/InterceptorStatus.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/InterceptorStatus.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * InterceptorStatus holds the status of the Interceptor
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,54 +104,84 @@ public InterceptorStatus(Addressable address, List<Addressable> addresses, Map<S
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * InterceptorStatus holds the status of the Interceptor
+     */
     @JsonProperty("address")
     public Addressable getAddress() {
         return address;
     }
 
+    /**
+     * InterceptorStatus holds the status of the Interceptor
+     */
     @JsonProperty("address")
     public void setAddress(Addressable address) {
         this.address = address;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Addressable> getAddresses() {
         return addresses;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<Addressable> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/NamespaceSelector.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/NamespaceSelector.java
index b3463e79e03..032f7f23322 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/NamespaceSelector.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/NamespaceSelector.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NamespaceSelector is a selector for selecting either all namespaces or a list of namespaces.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public NamespaceSelector(List<String> matchNames) {
         this.matchNames = matchNames;
     }
 
+    /**
+     * List of namespace names.
+     */
     @JsonProperty("matchNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMatchNames() {
         return matchNames;
     }
 
+    /**
+     * List of namespace names.
+     */
     @JsonProperty("matchNames")
     public void setMatchNames(List<String> matchNames) {
         this.matchNames = matchNames;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/Param.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/Param.java
index 89e35eebf7e..65fe5142757 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/Param.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/Param.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Param defines a string value to be used for a ParamSpec with the same name.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Param(String name, String value) {
         this.value = value;
     }
 
+    /**
+     * Param defines a string value to be used for a ParamSpec with the same name.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Param defines a string value to be used for a ParamSpec with the same name.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Param defines a string value to be used for a ParamSpec with the same name.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Param defines a string value to be used for a ParamSpec with the same name.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ParamSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ParamSpec.java
index 8fde20b8390..32e9a6eeced 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ParamSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ParamSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ParamSpec defines an arbitrary named  input whose value can be supplied by a `Param`.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ParamSpec(String _default, String description, String name) {
         this.name = name;
     }
 
+    /**
+     * Default is the value a parameter takes if no input value via a Param is supplied.
+     */
     @JsonProperty("default")
     public String getDefault() {
         return _default;
     }
 
+    /**
+     * Default is the value a parameter takes if no input value via a Param is supplied.
+     */
     @JsonProperty("default")
     public void setDefault(String _default) {
         this._default = _default;
     }
 
+    /**
+     * Description is a user-facing description of the parameter that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is a user-facing description of the parameter that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * Name declares the name by which a parameter is referenced.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name declares the name by which a parameter is referenced.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/SecretRef.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/SecretRef.java
index a5c92efda42..cc2777be1ec 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/SecretRef.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/SecretRef.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SecretRef contains the information required to reference a single secret string This is needed because the other secretRef types are not cross-namespace and do not actually contain the "SecretName" field, which allows us to access a single secret value.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public SecretRef(String secretKey, String secretName) {
         this.secretName = secretName;
     }
 
+    /**
+     * SecretRef contains the information required to reference a single secret string This is needed because the other secretRef types are not cross-namespace and do not actually contain the "SecretName" field, which allows us to access a single secret value.
+     */
     @JsonProperty("secretKey")
     public String getSecretKey() {
         return secretKey;
     }
 
+    /**
+     * SecretRef contains the information required to reference a single secret string This is needed because the other secretRef types are not cross-namespace and do not actually contain the "SecretName" field, which allows us to access a single secret value.
+     */
     @JsonProperty("secretKey")
     public void setSecretKey(String secretKey) {
         this.secretKey = secretKey;
     }
 
+    /**
+     * SecretRef contains the information required to reference a single secret string This is needed because the other secretRef types are not cross-namespace and do not actually contain the "SecretName" field, which allows us to access a single secret value.
+     */
     @JsonProperty("secretName")
     public String getSecretName() {
         return secretName;
     }
 
+    /**
+     * SecretRef contains the information required to reference a single secret string This is needed because the other secretRef types are not cross-namespace and do not actually contain the "SecretName" field, which allows us to access a single secret value.
+     */
     @JsonProperty("secretName")
     public void setSecretName(String secretName) {
         this.secretName = secretName;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ServiceReference.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ServiceReference.java
index c6a4a80f348..be37b7907c1 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ServiceReference.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/ServiceReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceReference is a reference to a Service object with an optional path
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ServiceReference(String name, String namespace, String path, Integer port
         this.port = port;
     }
 
+    /**
+     * Name is the name of the service
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the service
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace is the namespace of the service
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace of the service
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Path is an optional URL path
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Path is an optional URL path
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * Port is a valid port number
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * Port is a valid port number
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/Status.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/Status.java
index 7ad0c26a8bb..ace5be8c71f 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/Status.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/Status.java
@@ -82,21 +82,33 @@ public Status(Long code, String message) {
         this.message = message;
     }
 
+    /**
+     * The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
+     */
     @JsonProperty("code")
     public Long getCode() {
         return code;
     }
 
+    /**
+     * The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
+     */
     @JsonProperty("code")
     public void setCode(Long code) {
         this.code = code;
     }
 
+    /**
+     * A developer-facing error message, which should be in English.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * A developer-facing error message, which should be in English.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/Trigger.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/Trigger.java
index a43cf8392fa..0ff7484736a 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/Trigger.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/Trigger.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Trigger defines a mapping of an input event to parameters. This is used to extract information from events to be passed to TriggerTemplates within a Trigger.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Trigger implements Editable<TriggerBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "triggers.tekton.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Trigger";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public Trigger(String apiVersion, String kind, ObjectMeta metadata, TriggerSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Trigger defines a mapping of an input event to parameters. This is used to extract information from events to be passed to TriggerTemplates within a Trigger.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Trigger defines a mapping of an input event to parameters. This is used to extract information from events to be passed to TriggerTemplates within a Trigger.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Trigger defines a mapping of an input event to parameters. This is used to extract information from events to be passed to TriggerTemplates within a Trigger.
+     */
     @JsonProperty("spec")
     public TriggerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Trigger defines a mapping of an input event to parameters. This is used to extract information from events to be passed to TriggerTemplates within a Trigger.
+     */
     @JsonProperty("spec")
     public void setSpec(TriggerSpec spec) {
         this.spec = spec;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerBinding.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerBinding.java
index 2994cfe1bac..8de7cb6e703 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerBinding.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerBinding.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TriggerBinding defines a mapping of an input event to parameters. This is used to extract information from events to be passed to TriggerTemplates within a Trigger.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class TriggerBinding implements Editable<TriggerBindingBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "triggers.tekton.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TriggerBinding";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TriggerBinding(String apiVersion, String kind, ObjectMeta metadata, Trigg
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TriggerBinding defines a mapping of an input event to parameters. This is used to extract information from events to be passed to TriggerTemplates within a Trigger.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TriggerBinding defines a mapping of an input event to parameters. This is used to extract information from events to be passed to TriggerTemplates within a Trigger.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * TriggerBinding defines a mapping of an input event to parameters. This is used to extract information from events to be passed to TriggerTemplates within a Trigger.
+     */
     @JsonProperty("spec")
     public TriggerBindingSpec getSpec() {
         return spec;
     }
 
+    /**
+     * TriggerBinding defines a mapping of an input event to parameters. This is used to extract information from events to be passed to TriggerTemplates within a Trigger.
+     */
     @JsonProperty("spec")
     public void setSpec(TriggerBindingSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * TriggerBinding defines a mapping of an input event to parameters. This is used to extract information from events to be passed to TriggerTemplates within a Trigger.
+     */
     @JsonProperty("status")
     public TriggerBindingStatus getStatus() {
         return status;
     }
 
+    /**
+     * TriggerBinding defines a mapping of an input event to parameters. This is used to extract information from events to be passed to TriggerTemplates within a Trigger.
+     */
     @JsonProperty("status")
     public void setStatus(TriggerBindingStatus status) {
         this.status = status;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerBindingList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerBindingList.java
index 9404d817ea6..8f6259c1e39 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerBindingList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerBindingList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TriggerBindingList contains a list of TriggerBindings. We don't use this but it's required for certain codegen features.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class TriggerBindingList implements Editable<TriggerBindingListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.triggers.v1alpha1.TriggerBinding>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "triggers.tekton.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.triggers.v1alpha1.TriggerBinding> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TriggerBindingList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TriggerBindingList(String apiVersion, List<io.fabric8.tekton.triggers.v1a
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * TriggerBindingList contains a list of TriggerBindings. We don't use this but it's required for certain codegen features.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.triggers.v1alpha1.TriggerBinding> getItems() {
         return items;
     }
 
+    /**
+     * TriggerBindingList contains a list of TriggerBindings. We don't use this but it's required for certain codegen features.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.triggers.v1alpha1.TriggerBinding> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TriggerBindingList contains a list of TriggerBindings. We don't use this but it's required for certain codegen features.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TriggerBindingList contains a list of TriggerBindings. We don't use this but it's required for certain codegen features.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerBindingSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerBindingSpec.java
index 826a794784a..cb38ecca85e 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerBindingSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerBindingSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TriggerBindingSpec defines the desired state of the TriggerBinding.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public TriggerBindingSpec(List<Param> params) {
         this.params = params;
     }
 
+    /**
+     * Params defines the parameter mapping from the given input event.
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Param> getParams() {
         return params;
     }
 
+    /**
+     * Params defines the parameter mapping from the given input event.
+     */
     @JsonProperty("params")
     public void setParams(List<Param> params) {
         this.params = params;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerBindingStatus.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerBindingStatus.java
index 26722955f23..804f3f7fae7 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerBindingStatus.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerBindingStatus.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TriggerBindingStatus defines the observed state of TriggerBinding.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerContext.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerContext.java
index e28633d83cd..b276c65c2da 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerContext.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerContext.java
@@ -86,31 +86,49 @@ public TriggerContext(String eventId, String eventUrl, String triggerId) {
         this.triggerId = triggerId;
     }
 
+    /**
+     * EventID is a unique ID assigned by Triggers to each event
+     */
     @JsonProperty("event_id")
     public String getEventId() {
         return eventId;
     }
 
+    /**
+     * EventID is a unique ID assigned by Triggers to each event
+     */
     @JsonProperty("event_id")
     public void setEventId(String eventId) {
         this.eventId = eventId;
     }
 
+    /**
+     * EventURL is the URL of the incoming event
+     */
     @JsonProperty("event_url")
     public String getEventUrl() {
         return eventUrl;
     }
 
+    /**
+     * EventURL is the URL of the incoming event
+     */
     @JsonProperty("event_url")
     public void setEventUrl(String eventUrl) {
         this.eventUrl = eventUrl;
     }
 
+    /**
+     * TriggerID is of the form namespace/$ns/triggers/$name
+     */
     @JsonProperty("trigger_id")
     public String getTriggerId() {
         return triggerId;
     }
 
+    /**
+     * TriggerID is of the form namespace/$ns/triggers/$name
+     */
     @JsonProperty("trigger_id")
     public void setTriggerId(String triggerId) {
         this.triggerId = triggerId;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerInterceptor.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerInterceptor.java
index aba90ad1e07..13313a87613 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerInterceptor.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerInterceptor.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TriggerInterceptor provides a hook to intercept and pre-process events
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -109,82 +112,130 @@ public TriggerInterceptor(BitbucketInterceptor bitbucket, CELInterceptor cel, Gi
         this.webhook = webhook;
     }
 
+    /**
+     * TriggerInterceptor provides a hook to intercept and pre-process events
+     */
     @JsonProperty("bitbucket")
     public BitbucketInterceptor getBitbucket() {
         return bitbucket;
     }
 
+    /**
+     * TriggerInterceptor provides a hook to intercept and pre-process events
+     */
     @JsonProperty("bitbucket")
     public void setBitbucket(BitbucketInterceptor bitbucket) {
         this.bitbucket = bitbucket;
     }
 
+    /**
+     * TriggerInterceptor provides a hook to intercept and pre-process events
+     */
     @JsonProperty("cel")
     public CELInterceptor getCel() {
         return cel;
     }
 
+    /**
+     * TriggerInterceptor provides a hook to intercept and pre-process events
+     */
     @JsonProperty("cel")
     public void setCel(CELInterceptor cel) {
         this.cel = cel;
     }
 
+    /**
+     * TriggerInterceptor provides a hook to intercept and pre-process events
+     */
     @JsonProperty("github")
     public GitHubInterceptor getGithub() {
         return github;
     }
 
+    /**
+     * TriggerInterceptor provides a hook to intercept and pre-process events
+     */
     @JsonProperty("github")
     public void setGithub(GitHubInterceptor github) {
         this.github = github;
     }
 
+    /**
+     * TriggerInterceptor provides a hook to intercept and pre-process events
+     */
     @JsonProperty("gitlab")
     public GitLabInterceptor getGitlab() {
         return gitlab;
     }
 
+    /**
+     * TriggerInterceptor provides a hook to intercept and pre-process events
+     */
     @JsonProperty("gitlab")
     public void setGitlab(GitLabInterceptor gitlab) {
         this.gitlab = gitlab;
     }
 
+    /**
+     * Optional name to identify the current interceptor configuration
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Optional name to identify the current interceptor configuration
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Params are the params to send to the interceptor
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<InterceptorParams> getParams() {
         return params;
     }
 
+    /**
+     * Params are the params to send to the interceptor
+     */
     @JsonProperty("params")
     public void setParams(List<InterceptorParams> params) {
         this.params = params;
     }
 
+    /**
+     * TriggerInterceptor provides a hook to intercept and pre-process events
+     */
     @JsonProperty("ref")
     public InterceptorRef getRef() {
         return ref;
     }
 
+    /**
+     * TriggerInterceptor provides a hook to intercept and pre-process events
+     */
     @JsonProperty("ref")
     public void setRef(InterceptorRef ref) {
         this.ref = ref;
     }
 
+    /**
+     * TriggerInterceptor provides a hook to intercept and pre-process events
+     */
     @JsonProperty("webhook")
     public WebhookInterceptor getWebhook() {
         return webhook;
     }
 
+    /**
+     * TriggerInterceptor provides a hook to intercept and pre-process events
+     */
     @JsonProperty("webhook")
     public void setWebhook(WebhookInterceptor webhook) {
         this.webhook = webhook;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerList.java
index 756b9994156..48cd1adbd77 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TriggerList contains a list of Triggers. We don't use this but it's required for certain codegen features.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class TriggerList implements Editable<TriggerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.triggers.v1alpha1.Trigger>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "triggers.tekton.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.triggers.v1alpha1.Trigger> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TriggerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TriggerList(String apiVersion, List<io.fabric8.tekton.triggers.v1alpha1.T
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * TriggerList contains a list of Triggers. We don't use this but it's required for certain codegen features.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.triggers.v1alpha1.Trigger> getItems() {
         return items;
     }
 
+    /**
+     * TriggerList contains a list of Triggers. We don't use this but it's required for certain codegen features.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.triggers.v1alpha1.Trigger> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TriggerList contains a list of Triggers. We don't use this but it's required for certain codegen features.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TriggerList contains a list of Triggers. We don't use this but it's required for certain codegen features.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerResourceTemplate.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerResourceTemplate.java
index 1e2233c347a..7b69405a9e2 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerResourceTemplate.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerResourceTemplate.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TriggerResourceTemplate describes a resource to create
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerSpec.java
index 9965f5a548a..b949335b5fc 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TriggerSpec represents a connection between TriggerSpecBinding, and TriggerSpecTemplate; TriggerSpecBinding provides extracted values for TriggerSpecTemplate to then create resources from.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,53 +101,83 @@ public TriggerSpec(List<TriggerSpecBinding> bindings, List<TriggerInterceptor> i
         this.template = template;
     }
 
+    /**
+     * TriggerSpec represents a connection between TriggerSpecBinding, and TriggerSpecTemplate; TriggerSpecBinding provides extracted values for TriggerSpecTemplate to then create resources from.
+     */
     @JsonProperty("bindings")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TriggerSpecBinding> getBindings() {
         return bindings;
     }
 
+    /**
+     * TriggerSpec represents a connection between TriggerSpecBinding, and TriggerSpecTemplate; TriggerSpecBinding provides extracted values for TriggerSpecTemplate to then create resources from.
+     */
     @JsonProperty("bindings")
     public void setBindings(List<TriggerSpecBinding> bindings) {
         this.bindings = bindings;
     }
 
+    /**
+     * TriggerSpec represents a connection between TriggerSpecBinding, and TriggerSpecTemplate; TriggerSpecBinding provides extracted values for TriggerSpecTemplate to then create resources from.
+     */
     @JsonProperty("interceptors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TriggerInterceptor> getInterceptors() {
         return interceptors;
     }
 
+    /**
+     * TriggerSpec represents a connection between TriggerSpecBinding, and TriggerSpecTemplate; TriggerSpecBinding provides extracted values for TriggerSpecTemplate to then create resources from.
+     */
     @JsonProperty("interceptors")
     public void setInterceptors(List<TriggerInterceptor> interceptors) {
         this.interceptors = interceptors;
     }
 
+    /**
+     * TriggerSpec represents a connection between TriggerSpecBinding, and TriggerSpecTemplate; TriggerSpecBinding provides extracted values for TriggerSpecTemplate to then create resources from.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * TriggerSpec represents a connection between TriggerSpecBinding, and TriggerSpecTemplate; TriggerSpecBinding provides extracted values for TriggerSpecTemplate to then create resources from.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * ServiceAccountName optionally associates credentials with each trigger; Unlike EventListeners, this should be scoped to the same namespace as the Trigger itself
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * ServiceAccountName optionally associates credentials with each trigger; Unlike EventListeners, this should be scoped to the same namespace as the Trigger itself
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * TriggerSpec represents a connection between TriggerSpecBinding, and TriggerSpecTemplate; TriggerSpecBinding provides extracted values for TriggerSpecTemplate to then create resources from.
+     */
     @JsonProperty("template")
     public TriggerSpecTemplate getTemplate() {
         return template;
     }
 
+    /**
+     * TriggerSpec represents a connection between TriggerSpecBinding, and TriggerSpecTemplate; TriggerSpecBinding provides extracted values for TriggerSpecTemplate to then create resources from.
+     */
     @JsonProperty("template")
     public void setTemplate(TriggerSpecTemplate template) {
         this.template = template;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerSpecBinding.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerSpecBinding.java
index a336a73629f..bd93c527f31 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerSpecBinding.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerSpecBinding.java
@@ -94,51 +94,81 @@ public TriggerSpecBinding(String apiversion, String kind, String name, String re
         this.value = value;
     }
 
+    /**
+     * APIVersion of the binding ref
+     */
     @JsonProperty("apiversion")
     public String getApiversion() {
         return apiversion;
     }
 
+    /**
+     * APIVersion of the binding ref
+     */
     @JsonProperty("apiversion")
     public void setApiversion(String apiversion) {
         this.apiversion = apiversion;
     }
 
+    /**
+     * Kind can only be provided if Ref is also provided. Defaults to TriggerBinding
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind can only be provided if Ref is also provided. Defaults to TriggerBinding
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of the binding param Mutually exclusive with Ref
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the binding param Mutually exclusive with Ref
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Ref is a reference to a TriggerBinding kind. Mutually exclusive with Name
+     */
     @JsonProperty("ref")
     public String getRef() {
         return ref;
     }
 
+    /**
+     * Ref is a reference to a TriggerBinding kind. Mutually exclusive with Name
+     */
     @JsonProperty("ref")
     public void setRef(String ref) {
         this.ref = ref;
     }
 
+    /**
+     * Value is the value of the binding param. Can contain JSONPath Has to be pointer since "" is a valid value Required if Name is also specified.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is the value of the binding param. Can contain JSONPath Has to be pointer since "" is a valid value Required if Name is also specified.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerTemplate.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerTemplate.java
index 046dfba87ff..5a958f2dcb8 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerTemplate.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerTemplate.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TriggerTemplate takes parameters and uses them to create CRDs
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class TriggerTemplate implements Editable<TriggerTemplateBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "triggers.tekton.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TriggerTemplate";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TriggerTemplate(String apiVersion, String kind, ObjectMeta metadata, Trig
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TriggerTemplate takes parameters and uses them to create CRDs
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TriggerTemplate takes parameters and uses them to create CRDs
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * TriggerTemplate takes parameters and uses them to create CRDs
+     */
     @JsonProperty("spec")
     public TriggerTemplateSpec getSpec() {
         return spec;
     }
 
+    /**
+     * TriggerTemplate takes parameters and uses them to create CRDs
+     */
     @JsonProperty("spec")
     public void setSpec(TriggerTemplateSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * TriggerTemplate takes parameters and uses them to create CRDs
+     */
     @JsonProperty("status")
     public TriggerTemplateStatus getStatus() {
         return status;
     }
 
+    /**
+     * TriggerTemplate takes parameters and uses them to create CRDs
+     */
     @JsonProperty("status")
     public void setStatus(TriggerTemplateStatus status) {
         this.status = status;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerTemplateList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerTemplateList.java
index a32d5849250..7bee011178f 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerTemplateList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerTemplateList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TriggerTemplateList contains a list of TriggerTemplate
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class TriggerTemplateList implements Editable<TriggerTemplateListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.triggers.v1alpha1.TriggerTemplate>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "triggers.tekton.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.triggers.v1alpha1.TriggerTemplate> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TriggerTemplateList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TriggerTemplateList(String apiVersion, List<io.fabric8.tekton.triggers.v1
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * TriggerTemplateList contains a list of TriggerTemplate
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.triggers.v1alpha1.TriggerTemplate> getItems() {
         return items;
     }
 
+    /**
+     * TriggerTemplateList contains a list of TriggerTemplate
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.triggers.v1alpha1.TriggerTemplate> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TriggerTemplateList contains a list of TriggerTemplate
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TriggerTemplateList contains a list of TriggerTemplate
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerTemplateSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerTemplateSpec.java
index f542f236521..bced57df816 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerTemplateSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerTemplateSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TriggerTemplateSpec holds the desired state of TriggerTemplate
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public TriggerTemplateSpec(List<ParamSpec> params, List<TriggerResourceTemplate>
         this.resourcetemplates = resourcetemplates;
     }
 
+    /**
+     * TriggerTemplateSpec holds the desired state of TriggerTemplate
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ParamSpec> getParams() {
         return params;
     }
 
+    /**
+     * TriggerTemplateSpec holds the desired state of TriggerTemplate
+     */
     @JsonProperty("params")
     public void setParams(List<ParamSpec> params) {
         this.params = params;
     }
 
+    /**
+     * TriggerTemplateSpec holds the desired state of TriggerTemplate
+     */
     @JsonProperty("resourcetemplates")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TriggerResourceTemplate> getResourcetemplates() {
         return resourcetemplates;
     }
 
+    /**
+     * TriggerTemplateSpec holds the desired state of TriggerTemplate
+     */
     @JsonProperty("resourcetemplates")
     public void setResourcetemplates(List<TriggerResourceTemplate> resourcetemplates) {
         this.resourcetemplates = resourcetemplates;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerTemplateStatus.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerTemplateStatus.java
index a0c797131c3..47c93388c98 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerTemplateStatus.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/TriggerTemplateStatus.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TriggerTemplateStatus describes the desired state of TriggerTemplate
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/WebhookInterceptor.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/WebhookInterceptor.java
index eba28e9bc78..740985055e7 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/WebhookInterceptor.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1alpha1/WebhookInterceptor.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WebhookInterceptor provides a webhook to intercept and pre-process events
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,32 +93,50 @@ public WebhookInterceptor(List<Param> header, ObjectReference objectRef, String
         this.url = url;
     }
 
+    /**
+     * Header is a group of key-value pairs that can be appended to the interceptor request headers. This allows the interceptor to make decisions specific to an EventListenerTrigger.
+     */
     @JsonProperty("header")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Param> getHeader() {
         return header;
     }
 
+    /**
+     * Header is a group of key-value pairs that can be appended to the interceptor request headers. This allows the interceptor to make decisions specific to an EventListenerTrigger.
+     */
     @JsonProperty("header")
     public void setHeader(List<Param> header) {
         this.header = header;
     }
 
+    /**
+     * WebhookInterceptor provides a webhook to intercept and pre-process events
+     */
     @JsonProperty("objectRef")
     public ObjectReference getObjectRef() {
         return objectRef;
     }
 
+    /**
+     * WebhookInterceptor provides a webhook to intercept and pre-process events
+     */
     @JsonProperty("objectRef")
     public void setObjectRef(ObjectReference objectRef) {
         this.objectRef = objectRef;
     }
 
+    /**
+     * WebhookInterceptor provides a webhook to intercept and pre-process events
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * WebhookInterceptor provides a webhook to intercept and pre-process events
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/ClusterTriggerBinding.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/ClusterTriggerBinding.java
index 3b7c1629457..572c1a9de7c 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/ClusterTriggerBinding.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/ClusterTriggerBinding.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterTriggerBinding is a TriggerBinding with a cluster scope. ClusterTriggerBindings are used to represent TriggerBindings that should be publicly addressable from any namespace in the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ClusterTriggerBinding implements Editable<ClusterTriggerBindingBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "triggers.tekton.dev/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterTriggerBinding";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public ClusterTriggerBinding(String apiVersion, String kind, ObjectMeta metadata
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterTriggerBinding is a TriggerBinding with a cluster scope. ClusterTriggerBindings are used to represent TriggerBindings that should be publicly addressable from any namespace in the cluster.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterTriggerBinding is a TriggerBinding with a cluster scope. ClusterTriggerBindings are used to represent TriggerBindings that should be publicly addressable from any namespace in the cluster.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ClusterTriggerBinding is a TriggerBinding with a cluster scope. ClusterTriggerBindings are used to represent TriggerBindings that should be publicly addressable from any namespace in the cluster.
+     */
     @JsonProperty("spec")
     public TriggerBindingSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ClusterTriggerBinding is a TriggerBinding with a cluster scope. ClusterTriggerBindings are used to represent TriggerBindings that should be publicly addressable from any namespace in the cluster.
+     */
     @JsonProperty("spec")
     public void setSpec(TriggerBindingSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ClusterTriggerBinding is a TriggerBinding with a cluster scope. ClusterTriggerBindings are used to represent TriggerBindings that should be publicly addressable from any namespace in the cluster.
+     */
     @JsonProperty("status")
     public TriggerBindingStatus getStatus() {
         return status;
     }
 
+    /**
+     * ClusterTriggerBinding is a TriggerBinding with a cluster scope. ClusterTriggerBindings are used to represent TriggerBindings that should be publicly addressable from any namespace in the cluster.
+     */
     @JsonProperty("status")
     public void setStatus(TriggerBindingStatus status) {
         this.status = status;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/ClusterTriggerBindingList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/ClusterTriggerBindingList.java
index e0df496115a..e9772f8fb15 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/ClusterTriggerBindingList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/ClusterTriggerBindingList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterTriggerBindingList contains a list of ClusterTriggerBinding
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ClusterTriggerBindingList implements Editable<ClusterTriggerBindingListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.triggers.v1beta1.ClusterTriggerBinding>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "triggers.tekton.dev/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.triggers.v1beta1.ClusterTriggerBinding> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterTriggerBindingList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterTriggerBindingList(String apiVersion, List<io.fabric8.tekton.trigg
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ClusterTriggerBindingList contains a list of ClusterTriggerBinding
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.triggers.v1beta1.ClusterTriggerBinding> getItems() {
         return items;
     }
 
+    /**
+     * ClusterTriggerBindingList contains a list of ClusterTriggerBinding
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.triggers.v1beta1.ClusterTriggerBinding> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterTriggerBindingList contains a list of ClusterTriggerBinding
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterTriggerBindingList contains a list of ClusterTriggerBinding
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListener.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListener.java
index 5e68ba72ef2..8e9a979cb52 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListener.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListener.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventListener exposes a service to accept HTTP event payloads.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class EventListener implements Editable<EventListenerBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "triggers.tekton.dev/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EventListener";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EventListener(String apiVersion, String kind, ObjectMeta metadata, EventL
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EventListener exposes a service to accept HTTP event payloads.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EventListener exposes a service to accept HTTP event payloads.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * EventListener exposes a service to accept HTTP event payloads.
+     */
     @JsonProperty("spec")
     public EventListenerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * EventListener exposes a service to accept HTTP event payloads.
+     */
     @JsonProperty("spec")
     public void setSpec(EventListenerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * EventListener exposes a service to accept HTTP event payloads.
+     */
     @JsonProperty("status")
     public EventListenerStatus getStatus() {
         return status;
     }
 
+    /**
+     * EventListener exposes a service to accept HTTP event payloads.
+     */
     @JsonProperty("status")
     public void setStatus(EventListenerStatus status) {
         this.status = status;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListenerConfig.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListenerConfig.java
index 7c444714103..3cee4d1ebd2 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListenerConfig.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListenerConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventListenerConfig stores configuration for resources generated by the EventListener
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public EventListenerConfig(String generatedName) {
         this.generatedName = generatedName;
     }
 
+    /**
+     * GeneratedResourceName is the name given to all resources reconciled by the EventListener
+     */
     @JsonProperty("generatedName")
     public String getGeneratedName() {
         return generatedName;
     }
 
+    /**
+     * GeneratedResourceName is the name given to all resources reconciled by the EventListener
+     */
     @JsonProperty("generatedName")
     public void setGeneratedName(String generatedName) {
         this.generatedName = generatedName;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListenerList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListenerList.java
index 8b204f41367..cc05e1db9ca 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListenerList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListenerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventListenerList contains a list of TriggerBinding
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class EventListenerList implements Editable<EventListenerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.triggers.v1beta1.EventListener>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "triggers.tekton.dev/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.triggers.v1beta1.EventListener> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EventListenerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EventListenerList(String apiVersion, List<io.fabric8.tekton.triggers.v1be
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * EventListenerList contains a list of TriggerBinding
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.triggers.v1beta1.EventListener> getItems() {
         return items;
     }
 
+    /**
+     * EventListenerList contains a list of TriggerBinding
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.triggers.v1beta1.EventListener> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EventListenerList contains a list of TriggerBinding
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EventListenerList contains a list of TriggerBinding
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListenerSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListenerSpec.java
index 7f894b0f06e..dd557522ba2 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListenerSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListenerSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventListenerSpec defines the desired state of the EventListener, represented by a list of Triggers.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -106,73 +109,115 @@ public EventListenerSpec(String cloudEventURI, LabelSelector labelSelector, Name
         this.triggers = triggers;
     }
 
+    /**
+     * EventListenerSpec defines the desired state of the EventListener, represented by a list of Triggers.
+     */
     @JsonProperty("cloudEventURI")
     public String getCloudEventURI() {
         return cloudEventURI;
     }
 
+    /**
+     * EventListenerSpec defines the desired state of the EventListener, represented by a list of Triggers.
+     */
     @JsonProperty("cloudEventURI")
     public void setCloudEventURI(String cloudEventURI) {
         this.cloudEventURI = cloudEventURI;
     }
 
+    /**
+     * EventListenerSpec defines the desired state of the EventListener, represented by a list of Triggers.
+     */
     @JsonProperty("labelSelector")
     public LabelSelector getLabelSelector() {
         return labelSelector;
     }
 
+    /**
+     * EventListenerSpec defines the desired state of the EventListener, represented by a list of Triggers.
+     */
     @JsonProperty("labelSelector")
     public void setLabelSelector(LabelSelector labelSelector) {
         this.labelSelector = labelSelector;
     }
 
+    /**
+     * EventListenerSpec defines the desired state of the EventListener, represented by a list of Triggers.
+     */
     @JsonProperty("namespaceSelector")
     public NamespaceSelector getNamespaceSelector() {
         return namespaceSelector;
     }
 
+    /**
+     * EventListenerSpec defines the desired state of the EventListener, represented by a list of Triggers.
+     */
     @JsonProperty("namespaceSelector")
     public void setNamespaceSelector(NamespaceSelector namespaceSelector) {
         this.namespaceSelector = namespaceSelector;
     }
 
+    /**
+     * EventListenerSpec defines the desired state of the EventListener, represented by a list of Triggers.
+     */
     @JsonProperty("resources")
     public Resources getResources() {
         return resources;
     }
 
+    /**
+     * EventListenerSpec defines the desired state of the EventListener, represented by a list of Triggers.
+     */
     @JsonProperty("resources")
     public void setResources(Resources resources) {
         this.resources = resources;
     }
 
+    /**
+     * EventListenerSpec defines the desired state of the EventListener, represented by a list of Triggers.
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * EventListenerSpec defines the desired state of the EventListener, represented by a list of Triggers.
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * Trigger groups allow for centralized processing of an interceptor chain
+     */
     @JsonProperty("triggerGroups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EventListenerTriggerGroup> getTriggerGroups() {
         return triggerGroups;
     }
 
+    /**
+     * Trigger groups allow for centralized processing of an interceptor chain
+     */
     @JsonProperty("triggerGroups")
     public void setTriggerGroups(List<EventListenerTriggerGroup> triggerGroups) {
         this.triggerGroups = triggerGroups;
     }
 
+    /**
+     * EventListenerSpec defines the desired state of the EventListener, represented by a list of Triggers.
+     */
     @JsonProperty("triggers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EventListenerTrigger> getTriggers() {
         return triggers;
     }
 
+    /**
+     * EventListenerSpec defines the desired state of the EventListener, represented by a list of Triggers.
+     */
     @JsonProperty("triggers")
     public void setTriggers(List<EventListenerTrigger> triggers) {
         this.triggers = triggers;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListenerStatus.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListenerStatus.java
index 23b095d144a..7739bd22f9b 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListenerStatus.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListenerStatus.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventListenerStatus holds the status of the EventListener
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -105,64 +108,100 @@ public EventListenerStatus(Addressable address, List<Addressable> addresses, Map
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * EventListenerStatus holds the status of the EventListener
+     */
     @JsonProperty("address")
     public Addressable getAddress() {
         return address;
     }
 
+    /**
+     * EventListenerStatus holds the status of the EventListener
+     */
     @JsonProperty("address")
     public void setAddress(Addressable address) {
         this.address = address;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Addressable> getAddresses() {
         return addresses;
     }
 
+    /**
+     * Addresses is a list of addresses for different protocols (HTTP and HTTPS) If Addresses is present, Address must be ignored by clients.
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<Addressable> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * EventListenerStatus holds the status of the EventListener
+     */
     @JsonProperty("configuration")
     public EventListenerConfig getConfiguration() {
         return configuration;
     }
 
+    /**
+     * EventListenerStatus holds the status of the EventListener
+     */
     @JsonProperty("configuration")
     public void setConfiguration(EventListenerConfig configuration) {
         this.configuration = configuration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListenerTrigger.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListenerTrigger.java
index 2a50044493a..9105077f543 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListenerTrigger.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListenerTrigger.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventListenerTrigger represents a connection between TriggerBinding, Params, and TriggerTemplate; TriggerBinding provides extracted values for TriggerTemplate to then create resources from. TriggerRef can also be provided instead of TriggerBinding, Interceptors and TriggerTemplate
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,63 +105,99 @@ public EventListenerTrigger(List<TriggerSpecBinding> bindings, List<TriggerInter
         this.triggerRef = triggerRef;
     }
 
+    /**
+     * EventListenerTrigger represents a connection between TriggerBinding, Params, and TriggerTemplate; TriggerBinding provides extracted values for TriggerTemplate to then create resources from. TriggerRef can also be provided instead of TriggerBinding, Interceptors and TriggerTemplate
+     */
     @JsonProperty("bindings")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TriggerSpecBinding> getBindings() {
         return bindings;
     }
 
+    /**
+     * EventListenerTrigger represents a connection between TriggerBinding, Params, and TriggerTemplate; TriggerBinding provides extracted values for TriggerTemplate to then create resources from. TriggerRef can also be provided instead of TriggerBinding, Interceptors and TriggerTemplate
+     */
     @JsonProperty("bindings")
     public void setBindings(List<TriggerSpecBinding> bindings) {
         this.bindings = bindings;
     }
 
+    /**
+     * EventListenerTrigger represents a connection between TriggerBinding, Params, and TriggerTemplate; TriggerBinding provides extracted values for TriggerTemplate to then create resources from. TriggerRef can also be provided instead of TriggerBinding, Interceptors and TriggerTemplate
+     */
     @JsonProperty("interceptors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TriggerInterceptor> getInterceptors() {
         return interceptors;
     }
 
+    /**
+     * EventListenerTrigger represents a connection between TriggerBinding, Params, and TriggerTemplate; TriggerBinding provides extracted values for TriggerTemplate to then create resources from. TriggerRef can also be provided instead of TriggerBinding, Interceptors and TriggerTemplate
+     */
     @JsonProperty("interceptors")
     public void setInterceptors(List<TriggerInterceptor> interceptors) {
         this.interceptors = interceptors;
     }
 
+    /**
+     * EventListenerTrigger represents a connection between TriggerBinding, Params, and TriggerTemplate; TriggerBinding provides extracted values for TriggerTemplate to then create resources from. TriggerRef can also be provided instead of TriggerBinding, Interceptors and TriggerTemplate
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * EventListenerTrigger represents a connection between TriggerBinding, Params, and TriggerTemplate; TriggerBinding provides extracted values for TriggerTemplate to then create resources from. TriggerRef can also be provided instead of TriggerBinding, Interceptors and TriggerTemplate
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * ServiceAccountName optionally associates credentials with each trigger; more granular authorization for who is allowed to utilize the associated pipeline vs. defaulting to whatever permissions are associated with the entire EventListener and associated sink facilitates multi-tenant model based scenarios
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * ServiceAccountName optionally associates credentials with each trigger; more granular authorization for who is allowed to utilize the associated pipeline vs. defaulting to whatever permissions are associated with the entire EventListener and associated sink facilitates multi-tenant model based scenarios
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * EventListenerTrigger represents a connection between TriggerBinding, Params, and TriggerTemplate; TriggerBinding provides extracted values for TriggerTemplate to then create resources from. TriggerRef can also be provided instead of TriggerBinding, Interceptors and TriggerTemplate
+     */
     @JsonProperty("template")
     public TriggerSpecTemplate getTemplate() {
         return template;
     }
 
+    /**
+     * EventListenerTrigger represents a connection between TriggerBinding, Params, and TriggerTemplate; TriggerBinding provides extracted values for TriggerTemplate to then create resources from. TriggerRef can also be provided instead of TriggerBinding, Interceptors and TriggerTemplate
+     */
     @JsonProperty("template")
     public void setTemplate(TriggerSpecTemplate template) {
         this.template = template;
     }
 
+    /**
+     * EventListenerTrigger represents a connection between TriggerBinding, Params, and TriggerTemplate; TriggerBinding provides extracted values for TriggerTemplate to then create resources from. TriggerRef can also be provided instead of TriggerBinding, Interceptors and TriggerTemplate
+     */
     @JsonProperty("triggerRef")
     public String getTriggerRef() {
         return triggerRef;
     }
 
+    /**
+     * EventListenerTrigger represents a connection between TriggerBinding, Params, and TriggerTemplate; TriggerBinding provides extracted values for TriggerTemplate to then create resources from. TriggerRef can also be provided instead of TriggerBinding, Interceptors and TriggerTemplate
+     */
     @JsonProperty("triggerRef")
     public void setTriggerRef(String triggerRef) {
         this.triggerRef = triggerRef;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListenerTriggerGroup.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListenerTriggerGroup.java
index 13aa8fa997d..bbb43e4ff50 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListenerTriggerGroup.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListenerTriggerGroup.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventListenerTriggerGroup defines a group of Triggers that share a common set of interceptors
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public EventListenerTriggerGroup(List<TriggerInterceptor> interceptors, String n
         this.triggerSelector = triggerSelector;
     }
 
+    /**
+     * EventListenerTriggerGroup defines a group of Triggers that share a common set of interceptors
+     */
     @JsonProperty("interceptors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TriggerInterceptor> getInterceptors() {
         return interceptors;
     }
 
+    /**
+     * EventListenerTriggerGroup defines a group of Triggers that share a common set of interceptors
+     */
     @JsonProperty("interceptors")
     public void setInterceptors(List<TriggerInterceptor> interceptors) {
         this.interceptors = interceptors;
     }
 
+    /**
+     * EventListenerTriggerGroup defines a group of Triggers that share a common set of interceptors
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * EventListenerTriggerGroup defines a group of Triggers that share a common set of interceptors
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * EventListenerTriggerGroup defines a group of Triggers that share a common set of interceptors
+     */
     @JsonProperty("triggerSelector")
     public EventListenerTriggerSelector getTriggerSelector() {
         return triggerSelector;
     }
 
+    /**
+     * EventListenerTriggerGroup defines a group of Triggers that share a common set of interceptors
+     */
     @JsonProperty("triggerSelector")
     public void setTriggerSelector(EventListenerTriggerSelector triggerSelector) {
         this.triggerSelector = triggerSelector;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListenerTriggerSelector.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListenerTriggerSelector.java
index adcfbdec7a9..9f36eed72f3 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListenerTriggerSelector.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/EventListenerTriggerSelector.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventListenerTriggerSelector  defines ways to select a group of triggers using their metadata
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public EventListenerTriggerSelector(LabelSelector labelSelector, NamespaceSelect
         this.namespaceSelector = namespaceSelector;
     }
 
+    /**
+     * EventListenerTriggerSelector  defines ways to select a group of triggers using their metadata
+     */
     @JsonProperty("labelSelector")
     public LabelSelector getLabelSelector() {
         return labelSelector;
     }
 
+    /**
+     * EventListenerTriggerSelector  defines ways to select a group of triggers using their metadata
+     */
     @JsonProperty("labelSelector")
     public void setLabelSelector(LabelSelector labelSelector) {
         this.labelSelector = labelSelector;
     }
 
+    /**
+     * EventListenerTriggerSelector  defines ways to select a group of triggers using their metadata
+     */
     @JsonProperty("namespaceSelector")
     public NamespaceSelector getNamespaceSelector() {
         return namespaceSelector;
     }
 
+    /**
+     * EventListenerTriggerSelector  defines ways to select a group of triggers using their metadata
+     */
     @JsonProperty("namespaceSelector")
     public void setNamespaceSelector(NamespaceSelector namespaceSelector) {
         this.namespaceSelector = namespaceSelector;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/InterceptorParams.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/InterceptorParams.java
index c4efec427aa..78c12d4a251 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/InterceptorParams.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/InterceptorParams.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * InterceptorParams defines a key-value pair that can be passed on an interceptor
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public InterceptorParams(String name, JsonNode value) {
         this.value = value;
     }
 
+    /**
+     * InterceptorParams defines a key-value pair that can be passed on an interceptor
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * InterceptorParams defines a key-value pair that can be passed on an interceptor
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * InterceptorParams defines a key-value pair that can be passed on an interceptor
+     */
     @JsonProperty("value")
     public JsonNode getValue() {
         return value;
     }
 
+    /**
+     * InterceptorParams defines a key-value pair that can be passed on an interceptor
+     */
     @JsonProperty("value")
     public void setValue(JsonNode value) {
         this.value = value;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/InterceptorRef.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/InterceptorRef.java
index b12443309a3..c4a34cf707c 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/InterceptorRef.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/InterceptorRef.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * InterceptorRef provides a Reference to a ClusterInterceptor
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public InterceptorRef(String apiVersion, String kind, String name) {
         this.name = name;
     }
 
+    /**
+     * API version of the referent
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * API version of the referent
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * InterceptorKind indicates the kind of the Interceptor, namespaced or cluster scoped.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * InterceptorKind indicates the kind of the Interceptor, namespaced or cluster scoped.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name of the referent; More info: http://kubernetes.io/docs/user-guide/identifiers#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referent; More info: http://kubernetes.io/docs/user-guide/identifiers#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/InterceptorRequest.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/InterceptorRequest.java
index 9e2df0fd31d..39f4dd10bf5 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/InterceptorRequest.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/InterceptorRequest.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Do not generate DeepCopy(). See #827
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -100,55 +103,85 @@ public InterceptorRequest(String body, TriggerContext context, Map<String, Objec
         this.interceptorParams = interceptorParams;
     }
 
+    /**
+     * Body is the incoming HTTP event body. We use a "string" representation of the JSON body in order to preserve the body exactly as it was sent (including spaces etc.). This is necessary for some interceptors e.g. GitHub for validating the body with a signature. While []byte can also store an exact representation of the body, `json.Marshal` will compact []byte to a base64 encoded string which means that we will lose the spaces any time we marshal this struct.
+     */
     @JsonProperty("body")
     public String getBody() {
         return body;
     }
 
+    /**
+     * Body is the incoming HTTP event body. We use a "string" representation of the JSON body in order to preserve the body exactly as it was sent (including spaces etc.). This is necessary for some interceptors e.g. GitHub for validating the body with a signature. While []byte can also store an exact representation of the body, `json.Marshal` will compact []byte to a base64 encoded string which means that we will lose the spaces any time we marshal this struct.
+     */
     @JsonProperty("body")
     public void setBody(String body) {
         this.body = body;
     }
 
+    /**
+     * Do not generate DeepCopy(). See #827
+     */
     @JsonProperty("context")
     public TriggerContext getContext() {
         return context;
     }
 
+    /**
+     * Do not generate DeepCopy(). See #827
+     */
     @JsonProperty("context")
     public void setContext(TriggerContext context) {
         this.context = context;
     }
 
+    /**
+     * Extensions are extra values that are added by previous interceptors in a chain
+     */
     @JsonProperty("extensions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Object> getExtensions() {
         return extensions;
     }
 
+    /**
+     * Extensions are extra values that are added by previous interceptors in a chain
+     */
     @JsonProperty("extensions")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializerForMap.class)
     public void setExtensions(Map<String, Object> extensions) {
         this.extensions = extensions;
     }
 
+    /**
+     * Header are the headers for the incoming HTTP event
+     */
     @JsonProperty("header")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<String>> getHeader() {
         return header;
     }
 
+    /**
+     * Header are the headers for the incoming HTTP event
+     */
     @JsonProperty("header")
     public void setHeader(Map<String, List<String>> header) {
         this.header = header;
     }
 
+    /**
+     * InterceptorParams are the user specified params for interceptor in the Trigger
+     */
     @JsonProperty("interceptor_params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Object> getInterceptorParams() {
         return interceptorParams;
     }
 
+    /**
+     * InterceptorParams are the user specified params for interceptor in the Trigger
+     */
     @JsonProperty("interceptor_params")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializerForMap.class)
     public void setInterceptorParams(Map<String, Object> interceptorParams) {
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/InterceptorResponse.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/InterceptorResponse.java
index 7baa288d17d..9055b6950e4 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/InterceptorResponse.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/InterceptorResponse.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Do not generate Deepcopy(). See #827
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -88,33 +91,51 @@ public InterceptorResponse(Boolean _continue, Map<String, Object> extensions, St
         this.status = status;
     }
 
+    /**
+     * Continue indicates if the EventListener should continue processing the Trigger or not
+     */
     @JsonProperty("continue")
     public Boolean getContinue() {
         return _continue;
     }
 
+    /**
+     * Continue indicates if the EventListener should continue processing the Trigger or not
+     */
     @JsonProperty("continue")
     public void setContinue(Boolean _continue) {
         this._continue = _continue;
     }
 
+    /**
+     * Extensions are additional fields that is added to the interceptor event.
+     */
     @JsonProperty("extensions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Object> getExtensions() {
         return extensions;
     }
 
+    /**
+     * Extensions are additional fields that is added to the interceptor event.
+     */
     @JsonProperty("extensions")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializerForMap.class)
     public void setExtensions(Map<String, Object> extensions) {
         this.extensions = extensions;
     }
 
+    /**
+     * Do not generate Deepcopy(). See #827
+     */
     @JsonProperty("status")
     public Status getStatus() {
         return status;
     }
 
+    /**
+     * Do not generate Deepcopy(). See #827
+     */
     @JsonProperty("status")
     public void setStatus(Status status) {
         this.status = status;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/NamespaceSelector.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/NamespaceSelector.java
index 324607d9cf5..4775827adac 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/NamespaceSelector.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/NamespaceSelector.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NamespaceSelector is a selector for selecting either all namespaces or a list of namespaces.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public NamespaceSelector(List<String> matchNames) {
         this.matchNames = matchNames;
     }
 
+    /**
+     * List of namespace names.
+     */
     @JsonProperty("matchNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMatchNames() {
         return matchNames;
     }
 
+    /**
+     * List of namespace names.
+     */
     @JsonProperty("matchNames")
     public void setMatchNames(List<String> matchNames) {
         this.matchNames = matchNames;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/Param.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/Param.java
index 0aeb7557277..172d2d27436 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/Param.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/Param.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Param defines a string value to be used for a ParamSpec with the same name.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Param(String name, String value) {
         this.value = value;
     }
 
+    /**
+     * Param defines a string value to be used for a ParamSpec with the same name.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Param defines a string value to be used for a ParamSpec with the same name.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Param defines a string value to be used for a ParamSpec with the same name.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Param defines a string value to be used for a ParamSpec with the same name.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/ParamSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/ParamSpec.java
index 3249c637cb4..18457cfb025 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/ParamSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/ParamSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ParamSpec defines an arbitrary named  input whose value can be supplied by a `Param`.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ParamSpec(String _default, String description, String name) {
         this.name = name;
     }
 
+    /**
+     * Default is the value a parameter takes if no input value via a Param is supplied.
+     */
     @JsonProperty("default")
     public String getDefault() {
         return _default;
     }
 
+    /**
+     * Default is the value a parameter takes if no input value via a Param is supplied.
+     */
     @JsonProperty("default")
     public void setDefault(String _default) {
         this._default = _default;
     }
 
+    /**
+     * Description is a user-facing description of the parameter that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is a user-facing description of the parameter that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * Name declares the name by which a parameter is referenced.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name declares the name by which a parameter is referenced.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/SecretRef.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/SecretRef.java
index cc2c9963096..f95e0815ca8 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/SecretRef.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/SecretRef.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SecretRef contains the information required to reference a single secret string This is needed because the other secretRef types are not cross-namespace and do not actually contain the "SecretName" field, which allows us to access a single secret value.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public SecretRef(String secretKey, String secretName) {
         this.secretName = secretName;
     }
 
+    /**
+     * SecretRef contains the information required to reference a single secret string This is needed because the other secretRef types are not cross-namespace and do not actually contain the "SecretName" field, which allows us to access a single secret value.
+     */
     @JsonProperty("secretKey")
     public String getSecretKey() {
         return secretKey;
     }
 
+    /**
+     * SecretRef contains the information required to reference a single secret string This is needed because the other secretRef types are not cross-namespace and do not actually contain the "SecretName" field, which allows us to access a single secret value.
+     */
     @JsonProperty("secretKey")
     public void setSecretKey(String secretKey) {
         this.secretKey = secretKey;
     }
 
+    /**
+     * SecretRef contains the information required to reference a single secret string This is needed because the other secretRef types are not cross-namespace and do not actually contain the "SecretName" field, which allows us to access a single secret value.
+     */
     @JsonProperty("secretName")
     public String getSecretName() {
         return secretName;
     }
 
+    /**
+     * SecretRef contains the information required to reference a single secret string This is needed because the other secretRef types are not cross-namespace and do not actually contain the "SecretName" field, which allows us to access a single secret value.
+     */
     @JsonProperty("secretName")
     public void setSecretName(String secretName) {
         this.secretName = secretName;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/Status.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/Status.java
index aa2954e496d..48305453717 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/Status.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/Status.java
@@ -82,21 +82,33 @@ public Status(Long code, String message) {
         this.message = message;
     }
 
+    /**
+     * The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
+     */
     @JsonProperty("code")
     public Long getCode() {
         return code;
     }
 
+    /**
+     * The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
+     */
     @JsonProperty("code")
     public void setCode(Long code) {
         this.code = code;
     }
 
+    /**
+     * A developer-facing error message, which should be in English.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * A developer-facing error message, which should be in English.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/Trigger.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/Trigger.java
index 269e6056f3a..bc831d29f77 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/Trigger.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/Trigger.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Trigger defines a mapping of an input event to parameters. This is used to extract information from events to be passed to TriggerTemplates within a Trigger.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Trigger implements Editable<TriggerBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "triggers.tekton.dev/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Trigger";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public Trigger(String apiVersion, String kind, ObjectMeta metadata, TriggerSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Trigger defines a mapping of an input event to parameters. This is used to extract information from events to be passed to TriggerTemplates within a Trigger.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Trigger defines a mapping of an input event to parameters. This is used to extract information from events to be passed to TriggerTemplates within a Trigger.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Trigger defines a mapping of an input event to parameters. This is used to extract information from events to be passed to TriggerTemplates within a Trigger.
+     */
     @JsonProperty("spec")
     public TriggerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Trigger defines a mapping of an input event to parameters. This is used to extract information from events to be passed to TriggerTemplates within a Trigger.
+     */
     @JsonProperty("spec")
     public void setSpec(TriggerSpec spec) {
         this.spec = spec;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerBinding.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerBinding.java
index 50cf45c8197..673b896b3ae 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerBinding.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerBinding.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TriggerBinding defines a mapping of an input event to parameters. This is used to extract information from events to be passed to TriggerTemplates within a Trigger.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class TriggerBinding implements Editable<TriggerBindingBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "triggers.tekton.dev/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TriggerBinding";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TriggerBinding(String apiVersion, String kind, ObjectMeta metadata, Trigg
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TriggerBinding defines a mapping of an input event to parameters. This is used to extract information from events to be passed to TriggerTemplates within a Trigger.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TriggerBinding defines a mapping of an input event to parameters. This is used to extract information from events to be passed to TriggerTemplates within a Trigger.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * TriggerBinding defines a mapping of an input event to parameters. This is used to extract information from events to be passed to TriggerTemplates within a Trigger.
+     */
     @JsonProperty("spec")
     public TriggerBindingSpec getSpec() {
         return spec;
     }
 
+    /**
+     * TriggerBinding defines a mapping of an input event to parameters. This is used to extract information from events to be passed to TriggerTemplates within a Trigger.
+     */
     @JsonProperty("spec")
     public void setSpec(TriggerBindingSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * TriggerBinding defines a mapping of an input event to parameters. This is used to extract information from events to be passed to TriggerTemplates within a Trigger.
+     */
     @JsonProperty("status")
     public TriggerBindingStatus getStatus() {
         return status;
     }
 
+    /**
+     * TriggerBinding defines a mapping of an input event to parameters. This is used to extract information from events to be passed to TriggerTemplates within a Trigger.
+     */
     @JsonProperty("status")
     public void setStatus(TriggerBindingStatus status) {
         this.status = status;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerBindingList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerBindingList.java
index 495bc5dc9e6..cf254195129 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerBindingList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerBindingList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TriggerBindingList contains a list of TriggerBindings. We don't use this but it's required for certain codegen features.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class TriggerBindingList implements Editable<TriggerBindingListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.triggers.v1beta1.TriggerBinding>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "triggers.tekton.dev/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.triggers.v1beta1.TriggerBinding> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TriggerBindingList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TriggerBindingList(String apiVersion, List<io.fabric8.tekton.triggers.v1b
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * TriggerBindingList contains a list of TriggerBindings. We don't use this but it's required for certain codegen features.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.triggers.v1beta1.TriggerBinding> getItems() {
         return items;
     }
 
+    /**
+     * TriggerBindingList contains a list of TriggerBindings. We don't use this but it's required for certain codegen features.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.triggers.v1beta1.TriggerBinding> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TriggerBindingList contains a list of TriggerBindings. We don't use this but it's required for certain codegen features.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TriggerBindingList contains a list of TriggerBindings. We don't use this but it's required for certain codegen features.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerBindingSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerBindingSpec.java
index 5c5f4abe178..7f0f54a73a8 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerBindingSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerBindingSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TriggerBindingSpec defines the desired state of the TriggerBinding.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public TriggerBindingSpec(List<Param> params) {
         this.params = params;
     }
 
+    /**
+     * Params defines the parameter mapping from the given input event.
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Param> getParams() {
         return params;
     }
 
+    /**
+     * Params defines the parameter mapping from the given input event.
+     */
     @JsonProperty("params")
     public void setParams(List<Param> params) {
         this.params = params;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerBindingStatus.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerBindingStatus.java
index 9c055fc4cd6..1b836f474dc 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerBindingStatus.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerBindingStatus.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TriggerBindingStatus defines the observed state of TriggerBinding.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerContext.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerContext.java
index 14400935fb0..18976b8ba55 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerContext.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerContext.java
@@ -86,31 +86,49 @@ public TriggerContext(String eventId, String eventUrl, String triggerId) {
         this.triggerId = triggerId;
     }
 
+    /**
+     * EventID is a unique ID assigned by Triggers to each event
+     */
     @JsonProperty("event_id")
     public String getEventId() {
         return eventId;
     }
 
+    /**
+     * EventID is a unique ID assigned by Triggers to each event
+     */
     @JsonProperty("event_id")
     public void setEventId(String eventId) {
         this.eventId = eventId;
     }
 
+    /**
+     * EventURL is the URL of the incoming event
+     */
     @JsonProperty("event_url")
     public String getEventUrl() {
         return eventUrl;
     }
 
+    /**
+     * EventURL is the URL of the incoming event
+     */
     @JsonProperty("event_url")
     public void setEventUrl(String eventUrl) {
         this.eventUrl = eventUrl;
     }
 
+    /**
+     * TriggerID is of the form namespace/$ns/triggers/$name
+     */
     @JsonProperty("trigger_id")
     public String getTriggerId() {
         return triggerId;
     }
 
+    /**
+     * TriggerID is of the form namespace/$ns/triggers/$name
+     */
     @JsonProperty("trigger_id")
     public void setTriggerId(String triggerId) {
         this.triggerId = triggerId;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerInterceptor.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerInterceptor.java
index bc4adfa34d2..10194335572 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerInterceptor.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerInterceptor.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TriggerInterceptor provides a hook to intercept and pre-process events
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public TriggerInterceptor(String name, List<InterceptorParams> params, Intercept
         this.webhook = webhook;
     }
 
+    /**
+     * Optional name to identify the current interceptor configuration
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Optional name to identify the current interceptor configuration
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Params are the params to send to the interceptor
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<InterceptorParams> getParams() {
         return params;
     }
 
+    /**
+     * Params are the params to send to the interceptor
+     */
     @JsonProperty("params")
     public void setParams(List<InterceptorParams> params) {
         this.params = params;
     }
 
+    /**
+     * TriggerInterceptor provides a hook to intercept and pre-process events
+     */
     @JsonProperty("ref")
     public InterceptorRef getRef() {
         return ref;
     }
 
+    /**
+     * TriggerInterceptor provides a hook to intercept and pre-process events
+     */
     @JsonProperty("ref")
     public void setRef(InterceptorRef ref) {
         this.ref = ref;
     }
 
+    /**
+     * TriggerInterceptor provides a hook to intercept and pre-process events
+     */
     @JsonProperty("webhook")
     public WebhookInterceptor getWebhook() {
         return webhook;
     }
 
+    /**
+     * TriggerInterceptor provides a hook to intercept and pre-process events
+     */
     @JsonProperty("webhook")
     public void setWebhook(WebhookInterceptor webhook) {
         this.webhook = webhook;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerList.java
index 68ac1e7a232..815788b61ee 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TriggerList contains a list of Triggers. We don't use this but it's required for certain codegen features.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class TriggerList implements Editable<TriggerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.triggers.v1beta1.Trigger>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "triggers.tekton.dev/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.triggers.v1beta1.Trigger> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TriggerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TriggerList(String apiVersion, List<io.fabric8.tekton.triggers.v1beta1.Tr
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * TriggerList contains a list of Triggers. We don't use this but it's required for certain codegen features.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.triggers.v1beta1.Trigger> getItems() {
         return items;
     }
 
+    /**
+     * TriggerList contains a list of Triggers. We don't use this but it's required for certain codegen features.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.triggers.v1beta1.Trigger> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TriggerList contains a list of Triggers. We don't use this but it's required for certain codegen features.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TriggerList contains a list of Triggers. We don't use this but it's required for certain codegen features.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerResourceTemplate.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerResourceTemplate.java
index 885317f7630..70425abe1ab 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerResourceTemplate.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerResourceTemplate.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TriggerResourceTemplate describes a resource to create
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerSpec.java
index 049bcc8673f..cc4e603fbce 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TriggerSpec represents a connection between TriggerSpecBinding, and TriggerSpecTemplate; TriggerSpecBinding provides extracted values for TriggerSpecTemplate to then create resources from.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,53 +101,83 @@ public TriggerSpec(List<TriggerSpecBinding> bindings, List<TriggerInterceptor> i
         this.template = template;
     }
 
+    /**
+     * TriggerSpec represents a connection between TriggerSpecBinding, and TriggerSpecTemplate; TriggerSpecBinding provides extracted values for TriggerSpecTemplate to then create resources from.
+     */
     @JsonProperty("bindings")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TriggerSpecBinding> getBindings() {
         return bindings;
     }
 
+    /**
+     * TriggerSpec represents a connection between TriggerSpecBinding, and TriggerSpecTemplate; TriggerSpecBinding provides extracted values for TriggerSpecTemplate to then create resources from.
+     */
     @JsonProperty("bindings")
     public void setBindings(List<TriggerSpecBinding> bindings) {
         this.bindings = bindings;
     }
 
+    /**
+     * TriggerSpec represents a connection between TriggerSpecBinding, and TriggerSpecTemplate; TriggerSpecBinding provides extracted values for TriggerSpecTemplate to then create resources from.
+     */
     @JsonProperty("interceptors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TriggerInterceptor> getInterceptors() {
         return interceptors;
     }
 
+    /**
+     * TriggerSpec represents a connection between TriggerSpecBinding, and TriggerSpecTemplate; TriggerSpecBinding provides extracted values for TriggerSpecTemplate to then create resources from.
+     */
     @JsonProperty("interceptors")
     public void setInterceptors(List<TriggerInterceptor> interceptors) {
         this.interceptors = interceptors;
     }
 
+    /**
+     * TriggerSpec represents a connection between TriggerSpecBinding, and TriggerSpecTemplate; TriggerSpecBinding provides extracted values for TriggerSpecTemplate to then create resources from.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * TriggerSpec represents a connection between TriggerSpecBinding, and TriggerSpecTemplate; TriggerSpecBinding provides extracted values for TriggerSpecTemplate to then create resources from.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * ServiceAccountName optionally associates credentials with each trigger; Unlike EventListeners, this should be scoped to the same namespace as the Trigger itself
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * ServiceAccountName optionally associates credentials with each trigger; Unlike EventListeners, this should be scoped to the same namespace as the Trigger itself
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * TriggerSpec represents a connection between TriggerSpecBinding, and TriggerSpecTemplate; TriggerSpecBinding provides extracted values for TriggerSpecTemplate to then create resources from.
+     */
     @JsonProperty("template")
     public TriggerSpecTemplate getTemplate() {
         return template;
     }
 
+    /**
+     * TriggerSpec represents a connection between TriggerSpecBinding, and TriggerSpecTemplate; TriggerSpecBinding provides extracted values for TriggerSpecTemplate to then create resources from.
+     */
     @JsonProperty("template")
     public void setTemplate(TriggerSpecTemplate template) {
         this.template = template;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerSpecBinding.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerSpecBinding.java
index deddf23bb0c..ba18b273742 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerSpecBinding.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerSpecBinding.java
@@ -94,51 +94,81 @@ public TriggerSpecBinding(String apiversion, String kind, String name, String re
         this.value = value;
     }
 
+    /**
+     * APIVersion of the binding ref
+     */
     @JsonProperty("apiversion")
     public String getApiversion() {
         return apiversion;
     }
 
+    /**
+     * APIVersion of the binding ref
+     */
     @JsonProperty("apiversion")
     public void setApiversion(String apiversion) {
         this.apiversion = apiversion;
     }
 
+    /**
+     * Kind can only be provided if Ref is also provided. Defaults to TriggerBinding
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind can only be provided if Ref is also provided. Defaults to TriggerBinding
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of the binding param Mutually exclusive with Ref
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the binding param Mutually exclusive with Ref
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Ref is a reference to a TriggerBinding kind. Mutually exclusive with Name
+     */
     @JsonProperty("ref")
     public String getRef() {
         return ref;
     }
 
+    /**
+     * Ref is a reference to a TriggerBinding kind. Mutually exclusive with Name
+     */
     @JsonProperty("ref")
     public void setRef(String ref) {
         this.ref = ref;
     }
 
+    /**
+     * Value is the value of the binding param. Can contain JSONPath Has to be pointer since "" is a valid value Required if Name is also specified.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is the value of the binding param. Can contain JSONPath Has to be pointer since "" is a valid value Required if Name is also specified.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerTemplate.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerTemplate.java
index d732e407e26..75d5da6d005 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerTemplate.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerTemplate.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TriggerTemplate takes parameters and uses them to create CRDs
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class TriggerTemplate implements Editable<TriggerTemplateBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "triggers.tekton.dev/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TriggerTemplate";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TriggerTemplate(String apiVersion, String kind, ObjectMeta metadata, Trig
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TriggerTemplate takes parameters and uses them to create CRDs
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TriggerTemplate takes parameters and uses them to create CRDs
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * TriggerTemplate takes parameters and uses them to create CRDs
+     */
     @JsonProperty("spec")
     public TriggerTemplateSpec getSpec() {
         return spec;
     }
 
+    /**
+     * TriggerTemplate takes parameters and uses them to create CRDs
+     */
     @JsonProperty("spec")
     public void setSpec(TriggerTemplateSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * TriggerTemplate takes parameters and uses them to create CRDs
+     */
     @JsonProperty("status")
     public TriggerTemplateStatus getStatus() {
         return status;
     }
 
+    /**
+     * TriggerTemplate takes parameters and uses them to create CRDs
+     */
     @JsonProperty("status")
     public void setStatus(TriggerTemplateStatus status) {
         this.status = status;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerTemplateList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerTemplateList.java
index 82243930990..60631f52791 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerTemplateList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerTemplateList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TriggerTemplateList contains a list of TriggerTemplate
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class TriggerTemplateList implements Editable<TriggerTemplateListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.triggers.v1beta1.TriggerTemplate>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "triggers.tekton.dev/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.triggers.v1beta1.TriggerTemplate> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TriggerTemplateList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TriggerTemplateList(String apiVersion, List<io.fabric8.tekton.triggers.v1
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * TriggerTemplateList contains a list of TriggerTemplate
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.triggers.v1beta1.TriggerTemplate> getItems() {
         return items;
     }
 
+    /**
+     * TriggerTemplateList contains a list of TriggerTemplate
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.triggers.v1beta1.TriggerTemplate> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TriggerTemplateList contains a list of TriggerTemplate
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TriggerTemplateList contains a list of TriggerTemplate
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerTemplateSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerTemplateSpec.java
index c668d86ef3e..975f844636e 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerTemplateSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerTemplateSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TriggerTemplateSpec holds the desired state of TriggerTemplate
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public TriggerTemplateSpec(List<ParamSpec> params, List<TriggerResourceTemplate>
         this.resourcetemplates = resourcetemplates;
     }
 
+    /**
+     * TriggerTemplateSpec holds the desired state of TriggerTemplate
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ParamSpec> getParams() {
         return params;
     }
 
+    /**
+     * TriggerTemplateSpec holds the desired state of TriggerTemplate
+     */
     @JsonProperty("params")
     public void setParams(List<ParamSpec> params) {
         this.params = params;
     }
 
+    /**
+     * TriggerTemplateSpec holds the desired state of TriggerTemplate
+     */
     @JsonProperty("resourcetemplates")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TriggerResourceTemplate> getResourcetemplates() {
         return resourcetemplates;
     }
 
+    /**
+     * TriggerTemplateSpec holds the desired state of TriggerTemplate
+     */
     @JsonProperty("resourcetemplates")
     public void setResourcetemplates(List<TriggerResourceTemplate> resourcetemplates) {
         this.resourcetemplates = resourcetemplates;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerTemplateStatus.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerTemplateStatus.java
index f45dfc350d8..5621b2e8890 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerTemplateStatus.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/TriggerTemplateStatus.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TriggerTemplateStatus describes the desired state of TriggerTemplate
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/WebhookInterceptor.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/WebhookInterceptor.java
index 4008029de97..81eb71ec205 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/WebhookInterceptor.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/triggers/v1beta1/WebhookInterceptor.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WebhookInterceptor provides a webhook to intercept and pre-process events
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,32 +93,50 @@ public WebhookInterceptor(List<Param> header, ObjectReference objectRef, String
         this.url = url;
     }
 
+    /**
+     * Header is a group of key-value pairs that can be appended to the interceptor request headers. This allows the interceptor to make decisions specific to an EventListenerTrigger.
+     */
     @JsonProperty("header")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Param> getHeader() {
         return header;
     }
 
+    /**
+     * Header is a group of key-value pairs that can be appended to the interceptor request headers. This allows the interceptor to make decisions specific to an EventListenerTrigger.
+     */
     @JsonProperty("header")
     public void setHeader(List<Param> header) {
         this.header = header;
     }
 
+    /**
+     * WebhookInterceptor provides a webhook to intercept and pre-process events
+     */
     @JsonProperty("objectRef")
     public ObjectReference getObjectRef() {
         return objectRef;
     }
 
+    /**
+     * WebhookInterceptor provides a webhook to intercept and pre-process events
+     */
     @JsonProperty("objectRef")
     public void setObjectRef(ObjectReference objectRef) {
         this.objectRef = objectRef;
     }
 
+    /**
+     * WebhookInterceptor provides a webhook to intercept and pre-process events
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * WebhookInterceptor provides a webhook to intercept and pre-process events
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Artifact.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Artifact.java
index 64b8a47499c..45c7a3bede6 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Artifact.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Artifact.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskRunStepArtifact represents an artifact produced or used by a step within a task run. It directly uses the Artifact type for its structure.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public Artifact(Boolean buildOutput, String name, List<ArtifactValue> values) {
         this.values = values;
     }
 
+    /**
+     * Indicate if the artifact is a build output or a by-product
+     */
     @JsonProperty("buildOutput")
     public Boolean getBuildOutput() {
         return buildOutput;
     }
 
+    /**
+     * Indicate if the artifact is a build output or a by-product
+     */
     @JsonProperty("buildOutput")
     public void setBuildOutput(Boolean buildOutput) {
         this.buildOutput = buildOutput;
     }
 
+    /**
+     * The artifact's identifying category name
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The artifact's identifying category name
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * A collection of values related to the artifact
+     */
     @JsonProperty("values")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ArtifactValue> getValues() {
         return values;
     }
 
+    /**
+     * A collection of values related to the artifact
+     */
     @JsonProperty("values")
     public void setValues(List<ArtifactValue> values) {
         this.values = values;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/ArtifactValue.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/ArtifactValue.java
index bd49b73693b..c4e4842d22d 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/ArtifactValue.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/ArtifactValue.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ArtifactValue represents a specific value or data element within an Artifact.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,22 +86,34 @@ public ArtifactValue(Map<String, String> digest, String uri) {
         this.uri = uri;
     }
 
+    /**
+     * ArtifactValue represents a specific value or data element within an Artifact.
+     */
     @JsonProperty("digest")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getDigest() {
         return digest;
     }
 
+    /**
+     * ArtifactValue represents a specific value or data element within an Artifact.
+     */
     @JsonProperty("digest")
     public void setDigest(Map<String, String> digest) {
         this.digest = digest;
     }
 
+    /**
+     * Algorithm-specific digests for verifying the content (e.g., SHA256)
+     */
     @JsonProperty("uri")
     public String getUri() {
         return uri;
     }
 
+    /**
+     * Algorithm-specific digests for verifying the content (e.g., SHA256)
+     */
     @JsonProperty("uri")
     public void setUri(String uri) {
         this.uri = uri;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Artifacts.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Artifacts.java
index 59b420c6793..53456acaea8 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Artifacts.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Artifacts.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Artifacts represents the collection of input and output artifacts associated with a task run or a similar process. Artifacts in this context are units of data or resources that the process either consumes as input or produces as output.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public Artifacts(List<Artifact> inputs, List<Artifact> outputs) {
         this.outputs = outputs;
     }
 
+    /**
+     * Artifacts represents the collection of input and output artifacts associated with a task run or a similar process. Artifacts in this context are units of data or resources that the process either consumes as input or produces as output.
+     */
     @JsonProperty("inputs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Artifact> getInputs() {
         return inputs;
     }
 
+    /**
+     * Artifacts represents the collection of input and output artifacts associated with a task run or a similar process. Artifacts in this context are units of data or resources that the process either consumes as input or produces as output.
+     */
     @JsonProperty("inputs")
     public void setInputs(List<Artifact> inputs) {
         this.inputs = inputs;
     }
 
+    /**
+     * Artifacts represents the collection of input and output artifacts associated with a task run or a similar process. Artifacts in this context are units of data or resources that the process either consumes as input or produces as output.
+     */
     @JsonProperty("outputs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Artifact> getOutputs() {
         return outputs;
     }
 
+    /**
+     * Artifacts represents the collection of input and output artifacts associated with a task run or a similar process. Artifacts in this context are units of data or resources that the process either consumes as input or produces as output.
+     */
     @JsonProperty("outputs")
     public void setOutputs(List<Artifact> outputs) {
         this.outputs = outputs;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/ChildStatusReference.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/ChildStatusReference.java
index 8beb3cd50ae..7f8283f1649 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/ChildStatusReference.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/ChildStatusReference.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ChildStatusReference is used to point to the statuses of individual TaskRuns and Runs within this PipelineRun.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,62 +104,98 @@ public ChildStatusReference(String apiVersion, String displayName, String kind,
         this.whenExpressions = whenExpressions;
     }
 
+    /**
+     * ChildStatusReference is used to point to the statuses of individual TaskRuns and Runs within this PipelineRun.
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * ChildStatusReference is used to point to the statuses of individual TaskRuns and Runs within this PipelineRun.
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * DisplayName is a user-facing name of the pipelineTask that may be used to populate a UI.
+     */
     @JsonProperty("displayName")
     public String getDisplayName() {
         return displayName;
     }
 
+    /**
+     * DisplayName is a user-facing name of the pipelineTask that may be used to populate a UI.
+     */
     @JsonProperty("displayName")
     public void setDisplayName(String displayName) {
         this.displayName = displayName;
     }
 
+    /**
+     * ChildStatusReference is used to point to the statuses of individual TaskRuns and Runs within this PipelineRun.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * ChildStatusReference is used to point to the statuses of individual TaskRuns and Runs within this PipelineRun.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of the TaskRun or Run this is referencing.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the TaskRun or Run this is referencing.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * PipelineTaskName is the name of the PipelineTask this is referencing.
+     */
     @JsonProperty("pipelineTaskName")
     public String getPipelineTaskName() {
         return pipelineTaskName;
     }
 
+    /**
+     * PipelineTaskName is the name of the PipelineTask this is referencing.
+     */
     @JsonProperty("pipelineTaskName")
     public void setPipelineTaskName(String pipelineTaskName) {
         this.pipelineTaskName = pipelineTaskName;
     }
 
+    /**
+     * WhenExpressions is the list of checks guarding the execution of the PipelineTask
+     */
     @JsonProperty("whenExpressions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WhenExpression> getWhenExpressions() {
         return whenExpressions;
     }
 
+    /**
+     * WhenExpressions is the list of checks guarding the execution of the PipelineTask
+     */
     @JsonProperty("whenExpressions")
     public void setWhenExpressions(List<WhenExpression> whenExpressions) {
         this.whenExpressions = whenExpressions;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/EmbeddedTask.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/EmbeddedTask.java
index b013ccea383..1d750c9d8f5 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/EmbeddedTask.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/EmbeddedTask.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EmbeddedTask is used to define a Task inline within a Pipeline's PipelineTasks.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -135,138 +138,216 @@ public EmbeddedTask(String apiVersion, String description, String displayName, S
         this.workspaces = workspaces;
     }
 
+    /**
+     * EmbeddedTask is used to define a Task inline within a Pipeline's PipelineTasks.
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * EmbeddedTask is used to define a Task inline within a Pipeline's PipelineTasks.
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Description is a user-facing description of the task that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is a user-facing description of the task that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * DisplayName is a user-facing name of the task that may be used to populate a UI.
+     */
     @JsonProperty("displayName")
     public String getDisplayName() {
         return displayName;
     }
 
+    /**
+     * DisplayName is a user-facing name of the task that may be used to populate a UI.
+     */
     @JsonProperty("displayName")
     public void setDisplayName(String displayName) {
         this.displayName = displayName;
     }
 
+    /**
+     * EmbeddedTask is used to define a Task inline within a Pipeline's PipelineTasks.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * EmbeddedTask is used to define a Task inline within a Pipeline's PipelineTasks.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EmbeddedTask is used to define a Task inline within a Pipeline's PipelineTasks.
+     */
     @JsonProperty("metadata")
     public PipelineTaskMetadata getMetadata() {
         return metadata;
     }
 
+    /**
+     * EmbeddedTask is used to define a Task inline within a Pipeline's PipelineTasks.
+     */
     @JsonProperty("metadata")
     public void setMetadata(PipelineTaskMetadata metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Params is a list of input parameters required to run the task. Params must be supplied as inputs in TaskRuns unless they declare a default value.
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ParamSpec> getParams() {
         return params;
     }
 
+    /**
+     * Params is a list of input parameters required to run the task. Params must be supplied as inputs in TaskRuns unless they declare a default value.
+     */
     @JsonProperty("params")
     public void setParams(List<ParamSpec> params) {
         this.params = params;
     }
 
+    /**
+     * Results are values that this Task can output
+     */
     @JsonProperty("results")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TaskResult> getResults() {
         return results;
     }
 
+    /**
+     * Results are values that this Task can output
+     */
     @JsonProperty("results")
     public void setResults(List<TaskResult> results) {
         this.results = results;
     }
 
+    /**
+     * Sidecars are run alongside the Task's step containers. They begin before the steps start and end after the steps complete.
+     */
     @JsonProperty("sidecars")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Sidecar> getSidecars() {
         return sidecars;
     }
 
+    /**
+     * Sidecars are run alongside the Task's step containers. They begin before the steps start and end after the steps complete.
+     */
     @JsonProperty("sidecars")
     public void setSidecars(List<Sidecar> sidecars) {
         this.sidecars = sidecars;
     }
 
+    /**
+     * EmbeddedTask is used to define a Task inline within a Pipeline's PipelineTasks.
+     */
     @JsonProperty("spec")
     public Object getSpec() {
         return spec;
     }
 
+    /**
+     * EmbeddedTask is used to define a Task inline within a Pipeline's PipelineTasks.
+     */
     @JsonProperty("spec")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setSpec(Object spec) {
         this.spec = spec;
     }
 
+    /**
+     * EmbeddedTask is used to define a Task inline within a Pipeline's PipelineTasks.
+     */
     @JsonProperty("stepTemplate")
     public StepTemplate getStepTemplate() {
         return stepTemplate;
     }
 
+    /**
+     * EmbeddedTask is used to define a Task inline within a Pipeline's PipelineTasks.
+     */
     @JsonProperty("stepTemplate")
     public void setStepTemplate(StepTemplate stepTemplate) {
         this.stepTemplate = stepTemplate;
     }
 
+    /**
+     * Steps are the steps of the build; each step is run sequentially with the source mounted into /workspace.
+     */
     @JsonProperty("steps")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Step> getSteps() {
         return steps;
     }
 
+    /**
+     * Steps are the steps of the build; each step is run sequentially with the source mounted into /workspace.
+     */
     @JsonProperty("steps")
     public void setSteps(List<Step> steps) {
         this.steps = steps;
     }
 
+    /**
+     * Volumes is a collection of volumes that are available to mount into the steps of the build.
+     */
     @JsonProperty("volumes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Volume> getVolumes() {
         return volumes;
     }
 
+    /**
+     * Volumes is a collection of volumes that are available to mount into the steps of the build.
+     */
     @JsonProperty("volumes")
     public void setVolumes(List<Volume> volumes) {
         this.volumes = volumes;
     }
 
+    /**
+     * Workspaces are the volumes that this Task requires.
+     */
     @JsonProperty("workspaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WorkspaceDeclaration> getWorkspaces() {
         return workspaces;
     }
 
+    /**
+     * Workspaces are the volumes that this Task requires.
+     */
     @JsonProperty("workspaces")
     public void setWorkspaces(List<WorkspaceDeclaration> workspaces) {
         this.workspaces = workspaces;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/IncludeParams.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/IncludeParams.java
index d37d721d2dc..813df79e149 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/IncludeParams.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/IncludeParams.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IncludeParams allows passing in a specific combinations of Parameters into the Matrix.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public IncludeParams(String name, List<Param> params) {
         this.params = params;
     }
 
+    /**
+     * Name the specified combination
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name the specified combination
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Params takes only `Parameters` of type `"string"` The names of the `params` must match the names of the `params` in the underlying `Task`
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Param> getParams() {
         return params;
     }
 
+    /**
+     * Params takes only `Parameters` of type `"string"` The names of the `params` must match the names of the `params` in the underlying `Task`
+     */
     @JsonProperty("params")
     public void setParams(List<Param> params) {
         this.params = params;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Matrix.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Matrix.java
index b31f385ff74..d06ecbe6f10 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Matrix.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Matrix.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Matrix is used to fan out Tasks in a Pipeline
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public Matrix(List<IncludeParams> include, List<Param> params) {
         this.params = params;
     }
 
+    /**
+     * Include is a list of IncludeParams which allows passing in specific combinations of Parameters into the Matrix.
+     */
     @JsonProperty("include")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IncludeParams> getInclude() {
         return include;
     }
 
+    /**
+     * Include is a list of IncludeParams which allows passing in specific combinations of Parameters into the Matrix.
+     */
     @JsonProperty("include")
     public void setInclude(List<IncludeParams> include) {
         this.include = include;
     }
 
+    /**
+     * Params is a list of parameters used to fan out the pipelineTask Params takes only `Parameters` of type `"array"` Each array element is supplied to the `PipelineTask` by substituting `params` of type `"string"` in the underlying `Task`. The names of the `params` in the `Matrix` must match the names of the `params` in the underlying `Task` that they will be substituting.
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Param> getParams() {
         return params;
     }
 
+    /**
+     * Params is a list of parameters used to fan out the pipelineTask Params takes only `Parameters` of type `"array"` Each array element is supplied to the `PipelineTask` by substituting `params` of type `"string"` in the underlying `Task`. The names of the `params` in the `Matrix` must match the names of the `params` in the underlying `Task` that they will be substituting.
+     */
     @JsonProperty("params")
     public void setParams(List<Param> params) {
         this.params = params;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Param.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Param.java
index 2279adbdc53..6414d748c1e 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Param.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Param.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Param declares an ParamValues to use for the parameter called name.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Param(String name, ParamValue value) {
         this.value = value;
     }
 
+    /**
+     * Param declares an ParamValues to use for the parameter called name.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Param declares an ParamValues to use for the parameter called name.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Param declares an ParamValues to use for the parameter called name.
+     */
     @JsonProperty("value")
     public ParamValue getValue() {
         return value;
     }
 
+    /**
+     * Param declares an ParamValues to use for the parameter called name.
+     */
     @JsonProperty("value")
     public void setValue(ParamValue value) {
         this.value = value;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/ParamSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/ParamSpec.java
index cbaed80c776..9c0f57c4f2a 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/ParamSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/ParamSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ParamSpec defines arbitrary parameters needed beyond typed inputs (such as resources). Parameter values are provided by users as inputs on a TaskRun or PipelineRun.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,63 +105,99 @@ public ParamSpec(ParamValue _default, String description, List<String> _enum, St
         this.type = type;
     }
 
+    /**
+     * ParamSpec defines arbitrary parameters needed beyond typed inputs (such as resources). Parameter values are provided by users as inputs on a TaskRun or PipelineRun.
+     */
     @JsonProperty("default")
     public ParamValue getDefault() {
         return _default;
     }
 
+    /**
+     * ParamSpec defines arbitrary parameters needed beyond typed inputs (such as resources). Parameter values are provided by users as inputs on a TaskRun or PipelineRun.
+     */
     @JsonProperty("default")
     public void setDefault(ParamValue _default) {
         this._default = _default;
     }
 
+    /**
+     * Description is a user-facing description of the parameter that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is a user-facing description of the parameter that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * Enum declares a set of allowed param input values for tasks/pipelines that can be validated. If Enum is not set, no input validation is performed for the param.
+     */
     @JsonProperty("enum")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEnum() {
         return _enum;
     }
 
+    /**
+     * Enum declares a set of allowed param input values for tasks/pipelines that can be validated. If Enum is not set, no input validation is performed for the param.
+     */
     @JsonProperty("enum")
     public void setEnum(List<String> _enum) {
         this._enum = _enum;
     }
 
+    /**
+     * Name declares the name by which a parameter is referenced.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name declares the name by which a parameter is referenced.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Properties is the JSON Schema properties to support key-value pairs parameter.
+     */
     @JsonProperty("properties")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, PropertySpec> getProperties() {
         return properties;
     }
 
+    /**
+     * Properties is the JSON Schema properties to support key-value pairs parameter.
+     */
     @JsonProperty("properties")
     public void setProperties(Map<String, PropertySpec> properties) {
         this.properties = properties;
     }
 
+    /**
+     * Type is the user-specified type of the parameter. The possible types are currently "string", "array" and "object", and "string" is the default.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the user-specified type of the parameter. The possible types are currently "string", "array" and "object", and "string" is the default.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Pipeline.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Pipeline.java
index 371e1b29ea3..62bf46be88d 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Pipeline.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Pipeline.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Pipeline describes a list of Tasks to execute. It expresses how outputs of tasks feed into inputs of subsequent tasks.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Pipeline implements Editable<PipelineBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Pipeline";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public Pipeline(String apiVersion, String kind, ObjectMeta metadata, PipelineSpe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Pipeline describes a list of Tasks to execute. It expresses how outputs of tasks feed into inputs of subsequent tasks.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Pipeline describes a list of Tasks to execute. It expresses how outputs of tasks feed into inputs of subsequent tasks.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Pipeline describes a list of Tasks to execute. It expresses how outputs of tasks feed into inputs of subsequent tasks.
+     */
     @JsonProperty("spec")
     public PipelineSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Pipeline describes a list of Tasks to execute. It expresses how outputs of tasks feed into inputs of subsequent tasks.
+     */
     @JsonProperty("spec")
     public void setSpec(PipelineSpec spec) {
         this.spec = spec;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineList.java
index 83a477803f7..9bce3f4f40b 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineList contains a list of Pipeline
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PipelineList implements Editable<PipelineListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.v1.Pipeline>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.v1.Pipeline> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PipelineList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PipelineList(String apiVersion, List<io.fabric8.tekton.v1.Pipeline> items
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PipelineList contains a list of Pipeline
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.v1.Pipeline> getItems() {
         return items;
     }
 
+    /**
+     * PipelineList contains a list of Pipeline
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.v1.Pipeline> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PipelineList contains a list of Pipeline
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PipelineList contains a list of Pipeline
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRef.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRef.java
index 261b78415c2..819818be030 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRef.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRef.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineRef can be used to refer to a specific instance of a Pipeline.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PipelineRef(String apiVersion, String name) {
         this.name = name;
     }
 
+    /**
+     * API version of the referent
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * API version of the referent
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Name of the referent; More info: http://kubernetes.io/docs/user-guide/identifiers#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referent; More info: http://kubernetes.io/docs/user-guide/identifiers#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineResult.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineResult.java
index 18376e8ffb6..10423a1e4bf 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineResult.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineResult.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineResult used to describe the results of a pipeline
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public PipelineResult(String description, String name, String type, ParamValue v
         this.value = value;
     }
 
+    /**
+     * Description is a human-readable description of the result
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is a human-readable description of the result
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * Name the given name
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name the given name
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Type is the user-specified type of the result. The possible types are 'string', 'array', and 'object', with 'string' as the default. 'array' and 'object' types are alpha features.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the user-specified type of the result. The possible types are 'string', 'array', and 'object', with 'string' as the default. 'array' and 'object' types are alpha features.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * PipelineResult used to describe the results of a pipeline
+     */
     @JsonProperty("value")
     public ParamValue getValue() {
         return value;
     }
 
+    /**
+     * PipelineResult used to describe the results of a pipeline
+     */
     @JsonProperty("value")
     public void setValue(ParamValue value) {
         this.value = value;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRun.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRun.java
index c8e249c96fa..b9a13e4a3a8 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRun.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRun.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineRun represents a single execution of a Pipeline. PipelineRuns are how the graph of Tasks declared in a Pipeline are executed; they specify inputs to Pipelines such as parameter values and capture operational aspects of the Tasks execution such as service account and tolerations. Creating a PipelineRun creates TaskRuns for Tasks in the referenced Pipeline.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class PipelineRun implements Editable<PipelineRunBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PipelineRun";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PipelineRun(String apiVersion, String kind, ObjectMeta metadata, Pipeline
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PipelineRun represents a single execution of a Pipeline. PipelineRuns are how the graph of Tasks declared in a Pipeline are executed; they specify inputs to Pipelines such as parameter values and capture operational aspects of the Tasks execution such as service account and tolerations. Creating a PipelineRun creates TaskRuns for Tasks in the referenced Pipeline.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PipelineRun represents a single execution of a Pipeline. PipelineRuns are how the graph of Tasks declared in a Pipeline are executed; they specify inputs to Pipelines such as parameter values and capture operational aspects of the Tasks execution such as service account and tolerations. Creating a PipelineRun creates TaskRuns for Tasks in the referenced Pipeline.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PipelineRun represents a single execution of a Pipeline. PipelineRuns are how the graph of Tasks declared in a Pipeline are executed; they specify inputs to Pipelines such as parameter values and capture operational aspects of the Tasks execution such as service account and tolerations. Creating a PipelineRun creates TaskRuns for Tasks in the referenced Pipeline.
+     */
     @JsonProperty("spec")
     public PipelineRunSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PipelineRun represents a single execution of a Pipeline. PipelineRuns are how the graph of Tasks declared in a Pipeline are executed; they specify inputs to Pipelines such as parameter values and capture operational aspects of the Tasks execution such as service account and tolerations. Creating a PipelineRun creates TaskRuns for Tasks in the referenced Pipeline.
+     */
     @JsonProperty("spec")
     public void setSpec(PipelineRunSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PipelineRun represents a single execution of a Pipeline. PipelineRuns are how the graph of Tasks declared in a Pipeline are executed; they specify inputs to Pipelines such as parameter values and capture operational aspects of the Tasks execution such as service account and tolerations. Creating a PipelineRun creates TaskRuns for Tasks in the referenced Pipeline.
+     */
     @JsonProperty("status")
     public PipelineRunStatus getStatus() {
         return status;
     }
 
+    /**
+     * PipelineRun represents a single execution of a Pipeline. PipelineRuns are how the graph of Tasks declared in a Pipeline are executed; they specify inputs to Pipelines such as parameter values and capture operational aspects of the Tasks execution such as service account and tolerations. Creating a PipelineRun creates TaskRuns for Tasks in the referenced Pipeline.
+     */
     @JsonProperty("status")
     public void setStatus(PipelineRunStatus status) {
         this.status = status;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRunList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRunList.java
index 10a56f1839d..6604611ef78 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRunList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRunList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineRunList contains a list of PipelineRun
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PipelineRunList implements Editable<PipelineRunListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.v1.PipelineRun>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.v1.PipelineRun> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PipelineRunList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PipelineRunList(String apiVersion, List<io.fabric8.tekton.v1.PipelineRun>
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PipelineRunList contains a list of PipelineRun
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.v1.PipelineRun> getItems() {
         return items;
     }
 
+    /**
+     * PipelineRunList contains a list of PipelineRun
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.v1.PipelineRun> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PipelineRunList contains a list of PipelineRun
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PipelineRunList contains a list of PipelineRun
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRunResult.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRunResult.java
index 61335e4ed92..baad2c4ac37 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRunResult.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRunResult.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineRunResult used to describe the results of a pipeline
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PipelineRunResult(String name, ParamValue value) {
         this.value = value;
     }
 
+    /**
+     * Name is the result's name as declared by the Pipeline
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the result's name as declared by the Pipeline
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * PipelineRunResult used to describe the results of a pipeline
+     */
     @JsonProperty("value")
     public ParamValue getValue() {
         return value;
     }
 
+    /**
+     * PipelineRunResult used to describe the results of a pipeline
+     */
     @JsonProperty("value")
     public void setValue(ParamValue value) {
         this.value = value;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRunRunStatus.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRunRunStatus.java
index e26fa447902..f0fef5b1710 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRunRunStatus.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRunRunStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineRunRunStatus contains the name of the PipelineTask for this Run and the Run's Status
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,32 +93,50 @@ public PipelineRunRunStatus(String pipelineTaskName, CustomRunStatus status, Lis
         this.whenExpressions = whenExpressions;
     }
 
+    /**
+     * PipelineTaskName is the name of the PipelineTask.
+     */
     @JsonProperty("pipelineTaskName")
     public String getPipelineTaskName() {
         return pipelineTaskName;
     }
 
+    /**
+     * PipelineTaskName is the name of the PipelineTask.
+     */
     @JsonProperty("pipelineTaskName")
     public void setPipelineTaskName(String pipelineTaskName) {
         this.pipelineTaskName = pipelineTaskName;
     }
 
+    /**
+     * PipelineRunRunStatus contains the name of the PipelineTask for this Run and the Run's Status
+     */
     @JsonProperty("status")
     public CustomRunStatus getStatus() {
         return status;
     }
 
+    /**
+     * PipelineRunRunStatus contains the name of the PipelineTask for this Run and the Run's Status
+     */
     @JsonProperty("status")
     public void setStatus(CustomRunStatus status) {
         this.status = status;
     }
 
+    /**
+     * WhenExpressions is the list of checks guarding the execution of the PipelineTask
+     */
     @JsonProperty("whenExpressions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WhenExpression> getWhenExpressions() {
         return whenExpressions;
     }
 
+    /**
+     * WhenExpressions is the list of checks guarding the execution of the PipelineTask
+     */
     @JsonProperty("whenExpressions")
     public void setWhenExpressions(List<WhenExpression> whenExpressions) {
         this.whenExpressions = whenExpressions;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRunSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRunSpec.java
index 5a8db732038..e9b07894b22 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRunSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRunSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineRunSpec defines the desired state of PipelineRun
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -111,84 +114,132 @@ public PipelineRunSpec(List<Param> params, PipelineRef pipelineRef, PipelineSpec
         this.workspaces = workspaces;
     }
 
+    /**
+     * Params is a list of parameter names and values.
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Param> getParams() {
         return params;
     }
 
+    /**
+     * Params is a list of parameter names and values.
+     */
     @JsonProperty("params")
     public void setParams(List<Param> params) {
         this.params = params;
     }
 
+    /**
+     * PipelineRunSpec defines the desired state of PipelineRun
+     */
     @JsonProperty("pipelineRef")
     public PipelineRef getPipelineRef() {
         return pipelineRef;
     }
 
+    /**
+     * PipelineRunSpec defines the desired state of PipelineRun
+     */
     @JsonProperty("pipelineRef")
     public void setPipelineRef(PipelineRef pipelineRef) {
         this.pipelineRef = pipelineRef;
     }
 
+    /**
+     * PipelineRunSpec defines the desired state of PipelineRun
+     */
     @JsonProperty("pipelineSpec")
     public PipelineSpec getPipelineSpec() {
         return pipelineSpec;
     }
 
+    /**
+     * PipelineRunSpec defines the desired state of PipelineRun
+     */
     @JsonProperty("pipelineSpec")
     public void setPipelineSpec(PipelineSpec pipelineSpec) {
         this.pipelineSpec = pipelineSpec;
     }
 
+    /**
+     * Used for cancelling a pipelinerun (and maybe more later on)
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Used for cancelling a pipelinerun (and maybe more later on)
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * TaskRunSpecs holds a set of runtime specs
+     */
     @JsonProperty("taskRunSpecs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PipelineTaskRunSpec> getTaskRunSpecs() {
         return taskRunSpecs;
     }
 
+    /**
+     * TaskRunSpecs holds a set of runtime specs
+     */
     @JsonProperty("taskRunSpecs")
     public void setTaskRunSpecs(List<PipelineTaskRunSpec> taskRunSpecs) {
         this.taskRunSpecs = taskRunSpecs;
     }
 
+    /**
+     * PipelineRunSpec defines the desired state of PipelineRun
+     */
     @JsonProperty("taskRunTemplate")
     public PipelineTaskRunTemplate getTaskRunTemplate() {
         return taskRunTemplate;
     }
 
+    /**
+     * PipelineRunSpec defines the desired state of PipelineRun
+     */
     @JsonProperty("taskRunTemplate")
     public void setTaskRunTemplate(PipelineTaskRunTemplate taskRunTemplate) {
         this.taskRunTemplate = taskRunTemplate;
     }
 
+    /**
+     * PipelineRunSpec defines the desired state of PipelineRun
+     */
     @JsonProperty("timeouts")
     public TimeoutFields getTimeouts() {
         return timeouts;
     }
 
+    /**
+     * PipelineRunSpec defines the desired state of PipelineRun
+     */
     @JsonProperty("timeouts")
     public void setTimeouts(TimeoutFields timeouts) {
         this.timeouts = timeouts;
     }
 
+    /**
+     * Workspaces holds a set of workspace bindings that must match names with those declared in the pipeline.
+     */
     @JsonProperty("workspaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WorkspaceBinding> getWorkspaces() {
         return workspaces;
     }
 
+    /**
+     * Workspaces holds a set of workspace bindings that must match names with those declared in the pipeline.
+     */
     @JsonProperty("workspaces")
     public void setWorkspaces(List<WorkspaceBinding> workspaces) {
         this.workspaces = workspaces;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRunStatus.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRunStatus.java
index d2aba6f224c..5b661112815 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRunStatus.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRunStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineRunStatus defines the observed state of PipelineRun
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -131,127 +134,199 @@ public PipelineRunStatus(Map<String, String> annotations, List<ChildStatusRefere
         this.startTime = startTime;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * list of TaskRun and Run names, PipelineTask names, and API versions/kinds for children of this PipelineRun.
+     */
     @JsonProperty("childReferences")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ChildStatusReference> getChildReferences() {
         return childReferences;
     }
 
+    /**
+     * list of TaskRun and Run names, PipelineTask names, and API versions/kinds for children of this PipelineRun.
+     */
     @JsonProperty("childReferences")
     public void setChildReferences(List<ChildStatusReference> childReferences) {
         this.childReferences = childReferences;
     }
 
+    /**
+     * PipelineRunStatus defines the observed state of PipelineRun
+     */
     @JsonProperty("completionTime")
     public String getCompletionTime() {
         return completionTime;
     }
 
+    /**
+     * PipelineRunStatus defines the observed state of PipelineRun
+     */
     @JsonProperty("completionTime")
     public void setCompletionTime(String completionTime) {
         this.completionTime = completionTime;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * PipelineRunStatus defines the observed state of PipelineRun
+     */
     @JsonProperty("finallyStartTime")
     public String getFinallyStartTime() {
         return finallyStartTime;
     }
 
+    /**
+     * PipelineRunStatus defines the observed state of PipelineRun
+     */
     @JsonProperty("finallyStartTime")
     public void setFinallyStartTime(String finallyStartTime) {
         this.finallyStartTime = finallyStartTime;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * PipelineRunStatus defines the observed state of PipelineRun
+     */
     @JsonProperty("pipelineSpec")
     public PipelineSpec getPipelineSpec() {
         return pipelineSpec;
     }
 
+    /**
+     * PipelineRunStatus defines the observed state of PipelineRun
+     */
     @JsonProperty("pipelineSpec")
     public void setPipelineSpec(PipelineSpec pipelineSpec) {
         this.pipelineSpec = pipelineSpec;
     }
 
+    /**
+     * PipelineRunStatus defines the observed state of PipelineRun
+     */
     @JsonProperty("provenance")
     public Provenance getProvenance() {
         return provenance;
     }
 
+    /**
+     * PipelineRunStatus defines the observed state of PipelineRun
+     */
     @JsonProperty("provenance")
     public void setProvenance(Provenance provenance) {
         this.provenance = provenance;
     }
 
+    /**
+     * Results are the list of results written out by the pipeline task's containers
+     */
     @JsonProperty("results")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PipelineRunResult> getResults() {
         return results;
     }
 
+    /**
+     * Results are the list of results written out by the pipeline task's containers
+     */
     @JsonProperty("results")
     public void setResults(List<PipelineRunResult> results) {
         this.results = results;
     }
 
+    /**
+     * list of tasks that were skipped due to when expressions evaluating to false
+     */
     @JsonProperty("skippedTasks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SkippedTask> getSkippedTasks() {
         return skippedTasks;
     }
 
+    /**
+     * list of tasks that were skipped due to when expressions evaluating to false
+     */
     @JsonProperty("skippedTasks")
     public void setSkippedTasks(List<SkippedTask> skippedTasks) {
         this.skippedTasks = skippedTasks;
     }
 
+    /**
+     * SpanContext contains tracing span context fields
+     */
     @JsonProperty("spanContext")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getSpanContext() {
         return spanContext;
     }
 
+    /**
+     * SpanContext contains tracing span context fields
+     */
     @JsonProperty("spanContext")
     public void setSpanContext(Map<String, String> spanContext) {
         this.spanContext = spanContext;
     }
 
+    /**
+     * PipelineRunStatus defines the observed state of PipelineRun
+     */
     @JsonProperty("startTime")
     public String getStartTime() {
         return startTime;
     }
 
+    /**
+     * PipelineRunStatus defines the observed state of PipelineRun
+     */
     @JsonProperty("startTime")
     public void setStartTime(String startTime) {
         this.startTime = startTime;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRunStatusFields.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRunStatusFields.java
index 594bde42766..0a11e9b7df2 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRunStatusFields.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRunStatusFields.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineRunStatusFields holds the fields of PipelineRunStatus' status. This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -116,95 +119,149 @@ public PipelineRunStatusFields(List<ChildStatusReference> childReferences, Strin
         this.startTime = startTime;
     }
 
+    /**
+     * list of TaskRun and Run names, PipelineTask names, and API versions/kinds for children of this PipelineRun.
+     */
     @JsonProperty("childReferences")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ChildStatusReference> getChildReferences() {
         return childReferences;
     }
 
+    /**
+     * list of TaskRun and Run names, PipelineTask names, and API versions/kinds for children of this PipelineRun.
+     */
     @JsonProperty("childReferences")
     public void setChildReferences(List<ChildStatusReference> childReferences) {
         this.childReferences = childReferences;
     }
 
+    /**
+     * PipelineRunStatusFields holds the fields of PipelineRunStatus' status. This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("completionTime")
     public String getCompletionTime() {
         return completionTime;
     }
 
+    /**
+     * PipelineRunStatusFields holds the fields of PipelineRunStatus' status. This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("completionTime")
     public void setCompletionTime(String completionTime) {
         this.completionTime = completionTime;
     }
 
+    /**
+     * PipelineRunStatusFields holds the fields of PipelineRunStatus' status. This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("finallyStartTime")
     public String getFinallyStartTime() {
         return finallyStartTime;
     }
 
+    /**
+     * PipelineRunStatusFields holds the fields of PipelineRunStatus' status. This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("finallyStartTime")
     public void setFinallyStartTime(String finallyStartTime) {
         this.finallyStartTime = finallyStartTime;
     }
 
+    /**
+     * PipelineRunStatusFields holds the fields of PipelineRunStatus' status. This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("pipelineSpec")
     public PipelineSpec getPipelineSpec() {
         return pipelineSpec;
     }
 
+    /**
+     * PipelineRunStatusFields holds the fields of PipelineRunStatus' status. This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("pipelineSpec")
     public void setPipelineSpec(PipelineSpec pipelineSpec) {
         this.pipelineSpec = pipelineSpec;
     }
 
+    /**
+     * PipelineRunStatusFields holds the fields of PipelineRunStatus' status. This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("provenance")
     public Provenance getProvenance() {
         return provenance;
     }
 
+    /**
+     * PipelineRunStatusFields holds the fields of PipelineRunStatus' status. This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("provenance")
     public void setProvenance(Provenance provenance) {
         this.provenance = provenance;
     }
 
+    /**
+     * Results are the list of results written out by the pipeline task's containers
+     */
     @JsonProperty("results")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PipelineRunResult> getResults() {
         return results;
     }
 
+    /**
+     * Results are the list of results written out by the pipeline task's containers
+     */
     @JsonProperty("results")
     public void setResults(List<PipelineRunResult> results) {
         this.results = results;
     }
 
+    /**
+     * list of tasks that were skipped due to when expressions evaluating to false
+     */
     @JsonProperty("skippedTasks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SkippedTask> getSkippedTasks() {
         return skippedTasks;
     }
 
+    /**
+     * list of tasks that were skipped due to when expressions evaluating to false
+     */
     @JsonProperty("skippedTasks")
     public void setSkippedTasks(List<SkippedTask> skippedTasks) {
         this.skippedTasks = skippedTasks;
     }
 
+    /**
+     * SpanContext contains tracing span context fields
+     */
     @JsonProperty("spanContext")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getSpanContext() {
         return spanContext;
     }
 
+    /**
+     * SpanContext contains tracing span context fields
+     */
     @JsonProperty("spanContext")
     public void setSpanContext(Map<String, String> spanContext) {
         this.spanContext = spanContext;
     }
 
+    /**
+     * PipelineRunStatusFields holds the fields of PipelineRunStatus' status. This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("startTime")
     public String getStartTime() {
         return startTime;
     }
 
+    /**
+     * PipelineRunStatusFields holds the fields of PipelineRunStatus' status. This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("startTime")
     public void setStartTime(String startTime) {
         this.startTime = startTime;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRunTaskRunStatus.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRunTaskRunStatus.java
index 9d5404c741a..3decb1d7334 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRunTaskRunStatus.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineRunTaskRunStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineRunTaskRunStatus contains the name of the PipelineTask for this TaskRun and the TaskRun's Status
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public PipelineRunTaskRunStatus(String pipelineTaskName, TaskRunStatus status, L
         this.whenExpressions = whenExpressions;
     }
 
+    /**
+     * PipelineTaskName is the name of the PipelineTask.
+     */
     @JsonProperty("pipelineTaskName")
     public String getPipelineTaskName() {
         return pipelineTaskName;
     }
 
+    /**
+     * PipelineTaskName is the name of the PipelineTask.
+     */
     @JsonProperty("pipelineTaskName")
     public void setPipelineTaskName(String pipelineTaskName) {
         this.pipelineTaskName = pipelineTaskName;
     }
 
+    /**
+     * PipelineRunTaskRunStatus contains the name of the PipelineTask for this TaskRun and the TaskRun's Status
+     */
     @JsonProperty("status")
     public TaskRunStatus getStatus() {
         return status;
     }
 
+    /**
+     * PipelineRunTaskRunStatus contains the name of the PipelineTask for this TaskRun and the TaskRun's Status
+     */
     @JsonProperty("status")
     public void setStatus(TaskRunStatus status) {
         this.status = status;
     }
 
+    /**
+     * WhenExpressions is the list of checks guarding the execution of the PipelineTask
+     */
     @JsonProperty("whenExpressions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WhenExpression> getWhenExpressions() {
         return whenExpressions;
     }
 
+    /**
+     * WhenExpressions is the list of checks guarding the execution of the PipelineTask
+     */
     @JsonProperty("whenExpressions")
     public void setWhenExpressions(List<WhenExpression> whenExpressions) {
         this.whenExpressions = whenExpressions;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineSpec.java
index fdc730284ae..32759ebcd4b 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineSpec defines the desired state of Pipeline.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -109,76 +112,118 @@ public PipelineSpec(String description, String displayName, List<PipelineTask> _
         this.workspaces = workspaces;
     }
 
+    /**
+     * Description is a user-facing description of the pipeline that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is a user-facing description of the pipeline that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * DisplayName is a user-facing name of the pipeline that may be used to populate a UI.
+     */
     @JsonProperty("displayName")
     public String getDisplayName() {
         return displayName;
     }
 
+    /**
+     * DisplayName is a user-facing name of the pipeline that may be used to populate a UI.
+     */
     @JsonProperty("displayName")
     public void setDisplayName(String displayName) {
         this.displayName = displayName;
     }
 
+    /**
+     * Finally declares the list of Tasks that execute just before leaving the Pipeline i.e. either after all Tasks are finished executing successfully or after a failure which would result in ending the Pipeline
+     */
     @JsonProperty("finally")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PipelineTask> getFinally() {
         return _finally;
     }
 
+    /**
+     * Finally declares the list of Tasks that execute just before leaving the Pipeline i.e. either after all Tasks are finished executing successfully or after a failure which would result in ending the Pipeline
+     */
     @JsonProperty("finally")
     public void setFinally(List<PipelineTask> _finally) {
         this._finally = _finally;
     }
 
+    /**
+     * Params declares a list of input parameters that must be supplied when this Pipeline is run.
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ParamSpec> getParams() {
         return params;
     }
 
+    /**
+     * Params declares a list of input parameters that must be supplied when this Pipeline is run.
+     */
     @JsonProperty("params")
     public void setParams(List<ParamSpec> params) {
         this.params = params;
     }
 
+    /**
+     * Results are values that this pipeline can output once run
+     */
     @JsonProperty("results")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PipelineResult> getResults() {
         return results;
     }
 
+    /**
+     * Results are values that this pipeline can output once run
+     */
     @JsonProperty("results")
     public void setResults(List<PipelineResult> results) {
         this.results = results;
     }
 
+    /**
+     * Tasks declares the graph of Tasks that execute when this Pipeline is run.
+     */
     @JsonProperty("tasks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PipelineTask> getTasks() {
         return tasks;
     }
 
+    /**
+     * Tasks declares the graph of Tasks that execute when this Pipeline is run.
+     */
     @JsonProperty("tasks")
     public void setTasks(List<PipelineTask> tasks) {
         this.tasks = tasks;
     }
 
+    /**
+     * Workspaces declares a set of named workspaces that are expected to be provided by a PipelineRun.
+     */
     @JsonProperty("workspaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PipelineWorkspaceDeclaration> getWorkspaces() {
         return workspaces;
     }
 
+    /**
+     * Workspaces declares a set of named workspaces that are expected to be provided by a PipelineRun.
+     */
     @JsonProperty("workspaces")
     public void setWorkspaces(List<PipelineWorkspaceDeclaration> workspaces) {
         this.workspaces = workspaces;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineTask.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineTask.java
index 4ea826dea7b..3151e4b14f5 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineTask.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineTask.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineTask defines a task in a Pipeline, passing inputs from both Params and from the output of previous tasks.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -141,155 +144,245 @@ public PipelineTask(String description, String displayName, Matrix matrix, Strin
         this.workspaces = workspaces;
     }
 
+    /**
+     * Description is the description of this task within the context of a Pipeline. This description may be used to populate a UI.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is the description of this task within the context of a Pipeline. This description may be used to populate a UI.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * DisplayName is the display name of this task within the context of a Pipeline. This display name may be used to populate a UI.
+     */
     @JsonProperty("displayName")
     public String getDisplayName() {
         return displayName;
     }
 
+    /**
+     * DisplayName is the display name of this task within the context of a Pipeline. This display name may be used to populate a UI.
+     */
     @JsonProperty("displayName")
     public void setDisplayName(String displayName) {
         this.displayName = displayName;
     }
 
+    /**
+     * PipelineTask defines a task in a Pipeline, passing inputs from both Params and from the output of previous tasks.
+     */
     @JsonProperty("matrix")
     public Matrix getMatrix() {
         return matrix;
     }
 
+    /**
+     * PipelineTask defines a task in a Pipeline, passing inputs from both Params and from the output of previous tasks.
+     */
     @JsonProperty("matrix")
     public void setMatrix(Matrix matrix) {
         this.matrix = matrix;
     }
 
+    /**
+     * Name is the name of this task within the context of a Pipeline. Name is used as a coordinate with the `from` and `runAfter` fields to establish the execution order of tasks relative to one another.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of this task within the context of a Pipeline. Name is used as a coordinate with the `from` and `runAfter` fields to establish the execution order of tasks relative to one another.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * OnError defines the exiting behavior of a PipelineRun on error can be set to [ continue | stopAndFail ]
+     */
     @JsonProperty("onError")
     public String getOnError() {
         return onError;
     }
 
+    /**
+     * OnError defines the exiting behavior of a PipelineRun on error can be set to [ continue | stopAndFail ]
+     */
     @JsonProperty("onError")
     public void setOnError(String onError) {
         this.onError = onError;
     }
 
+    /**
+     * Parameters declares parameters passed to this task.
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Param> getParams() {
         return params;
     }
 
+    /**
+     * Parameters declares parameters passed to this task.
+     */
     @JsonProperty("params")
     public void setParams(List<Param> params) {
         this.params = params;
     }
 
+    /**
+     * PipelineTask defines a task in a Pipeline, passing inputs from both Params and from the output of previous tasks.
+     */
     @JsonProperty("pipelineRef")
     public PipelineRef getPipelineRef() {
         return pipelineRef;
     }
 
+    /**
+     * PipelineTask defines a task in a Pipeline, passing inputs from both Params and from the output of previous tasks.
+     */
     @JsonProperty("pipelineRef")
     public void setPipelineRef(PipelineRef pipelineRef) {
         this.pipelineRef = pipelineRef;
     }
 
+    /**
+     * PipelineTask defines a task in a Pipeline, passing inputs from both Params and from the output of previous tasks.
+     */
     @JsonProperty("pipelineSpec")
     public PipelineSpec getPipelineSpec() {
         return pipelineSpec;
     }
 
+    /**
+     * PipelineTask defines a task in a Pipeline, passing inputs from both Params and from the output of previous tasks.
+     */
     @JsonProperty("pipelineSpec")
     public void setPipelineSpec(PipelineSpec pipelineSpec) {
         this.pipelineSpec = pipelineSpec;
     }
 
+    /**
+     * Retries represents how many times this task should be retried in case of task failure: ConditionSucceeded set to False
+     */
     @JsonProperty("retries")
     public Integer getRetries() {
         return retries;
     }
 
+    /**
+     * Retries represents how many times this task should be retried in case of task failure: ConditionSucceeded set to False
+     */
     @JsonProperty("retries")
     public void setRetries(Integer retries) {
         this.retries = retries;
     }
 
+    /**
+     * RunAfter is the list of PipelineTask names that should be executed before this Task executes. (Used to force a specific ordering in graph execution.)
+     */
     @JsonProperty("runAfter")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getRunAfter() {
         return runAfter;
     }
 
+    /**
+     * RunAfter is the list of PipelineTask names that should be executed before this Task executes. (Used to force a specific ordering in graph execution.)
+     */
     @JsonProperty("runAfter")
     public void setRunAfter(List<String> runAfter) {
         this.runAfter = runAfter;
     }
 
+    /**
+     * PipelineTask defines a task in a Pipeline, passing inputs from both Params and from the output of previous tasks.
+     */
     @JsonProperty("taskRef")
     public TaskRef getTaskRef() {
         return taskRef;
     }
 
+    /**
+     * PipelineTask defines a task in a Pipeline, passing inputs from both Params and from the output of previous tasks.
+     */
     @JsonProperty("taskRef")
     public void setTaskRef(TaskRef taskRef) {
         this.taskRef = taskRef;
     }
 
+    /**
+     * PipelineTask defines a task in a Pipeline, passing inputs from both Params and from the output of previous tasks.
+     */
     @JsonProperty("taskSpec")
     public EmbeddedTask getTaskSpec() {
         return taskSpec;
     }
 
+    /**
+     * PipelineTask defines a task in a Pipeline, passing inputs from both Params and from the output of previous tasks.
+     */
     @JsonProperty("taskSpec")
     public void setTaskSpec(EmbeddedTask taskSpec) {
         this.taskSpec = taskSpec;
     }
 
+    /**
+     * PipelineTask defines a task in a Pipeline, passing inputs from both Params and from the output of previous tasks.
+     */
     @JsonProperty("timeout")
     public Duration getTimeout() {
         return timeout;
     }
 
+    /**
+     * PipelineTask defines a task in a Pipeline, passing inputs from both Params and from the output of previous tasks.
+     */
     @JsonProperty("timeout")
     public void setTimeout(Duration timeout) {
         this.timeout = timeout;
     }
 
+    /**
+     * When is a list of when expressions that need to be true for the task to run
+     */
     @JsonProperty("when")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WhenExpression> getWhen() {
         return when;
     }
 
+    /**
+     * When is a list of when expressions that need to be true for the task to run
+     */
     @JsonProperty("when")
     public void setWhen(List<WhenExpression> when) {
         this.when = when;
     }
 
+    /**
+     * Workspaces maps workspaces from the pipeline spec to the workspaces declared in the Task.
+     */
     @JsonProperty("workspaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WorkspacePipelineTaskBinding> getWorkspaces() {
         return workspaces;
     }
 
+    /**
+     * Workspaces maps workspaces from the pipeline spec to the workspaces declared in the Task.
+     */
     @JsonProperty("workspaces")
     public void setWorkspaces(List<WorkspacePipelineTaskBinding> workspaces) {
         this.workspaces = workspaces;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineTaskMetadata.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineTaskMetadata.java
index 2324a68109e..c67b5a3c631 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineTaskMetadata.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineTaskMetadata.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineTaskMetadata contains the labels or annotations for an EmbeddedTask
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -84,23 +87,35 @@ public PipelineTaskMetadata(Map<String, String> annotations, Map<String, String>
         this.labels = labels;
     }
 
+    /**
+     * PipelineTaskMetadata contains the labels or annotations for an EmbeddedTask
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * PipelineTaskMetadata contains the labels or annotations for an EmbeddedTask
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * PipelineTaskMetadata contains the labels or annotations for an EmbeddedTask
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabels() {
         return labels;
     }
 
+    /**
+     * PipelineTaskMetadata contains the labels or annotations for an EmbeddedTask
+     */
     @JsonProperty("labels")
     public void setLabels(Map<String, String> labels) {
         this.labels = labels;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineTaskParam.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineTaskParam.java
index 5be99bedb64..27f7cfad594 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineTaskParam.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineTaskParam.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineTaskParam is used to provide arbitrary string parameters to a Task.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PipelineTaskParam(String name, String value) {
         this.value = value;
     }
 
+    /**
+     * PipelineTaskParam is used to provide arbitrary string parameters to a Task.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * PipelineTaskParam is used to provide arbitrary string parameters to a Task.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * PipelineTaskParam is used to provide arbitrary string parameters to a Task.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * PipelineTaskParam is used to provide arbitrary string parameters to a Task.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineTaskRun.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineTaskRun.java
index a3af09993e1..6a6744de5cb 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineTaskRun.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineTaskRun.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineTaskRun reports the results of running a step in the Task. Each task has the potential to succeed or fail (based on the exit code) and produces logs.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public PipelineTaskRun(String name) {
         this.name = name;
     }
 
+    /**
+     * PipelineTaskRun reports the results of running a step in the Task. Each task has the potential to succeed or fail (based on the exit code) and produces logs.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * PipelineTaskRun reports the results of running a step in the Task. Each task has the potential to succeed or fail (based on the exit code) and produces logs.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineTaskRunSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineTaskRunSpec.java
index 225774d2b7f..aa26d30831c 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineTaskRunSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineTaskRunSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -107,73 +110,115 @@ public PipelineTaskRunSpec(ResourceRequirements computeResources, PipelineTaskMe
         this.stepSpecs = stepSpecs;
     }
 
+    /**
+     * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+     */
     @JsonProperty("computeResources")
     public ResourceRequirements getComputeResources() {
         return computeResources;
     }
 
+    /**
+     * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+     */
     @JsonProperty("computeResources")
     public void setComputeResources(ResourceRequirements computeResources) {
         this.computeResources = computeResources;
     }
 
+    /**
+     * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+     */
     @JsonProperty("metadata")
     public PipelineTaskMetadata getMetadata() {
         return metadata;
     }
 
+    /**
+     * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+     */
     @JsonProperty("metadata")
     public void setMetadata(PipelineTaskMetadata metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+     */
     @JsonProperty("pipelineTaskName")
     public String getPipelineTaskName() {
         return pipelineTaskName;
     }
 
+    /**
+     * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+     */
     @JsonProperty("pipelineTaskName")
     public void setPipelineTaskName(String pipelineTaskName) {
         this.pipelineTaskName = pipelineTaskName;
     }
 
+    /**
+     * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+     */
     @JsonProperty("podTemplate")
     public Template getPodTemplate() {
         return podTemplate;
     }
 
+    /**
+     * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+     */
     @JsonProperty("podTemplate")
     public void setPodTemplate(Template podTemplate) {
         this.podTemplate = podTemplate;
     }
 
+    /**
+     * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+     */
     @JsonProperty("sidecarSpecs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TaskRunSidecarSpec> getSidecarSpecs() {
         return sidecarSpecs;
     }
 
+    /**
+     * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+     */
     @JsonProperty("sidecarSpecs")
     public void setSidecarSpecs(List<TaskRunSidecarSpec> sidecarSpecs) {
         this.sidecarSpecs = sidecarSpecs;
     }
 
+    /**
+     * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+     */
     @JsonProperty("stepSpecs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TaskRunStepSpec> getStepSpecs() {
         return stepSpecs;
     }
 
+    /**
+     * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+     */
     @JsonProperty("stepSpecs")
     public void setStepSpecs(List<TaskRunStepSpec> stepSpecs) {
         this.stepSpecs = stepSpecs;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineTaskRunTemplate.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineTaskRunTemplate.java
index 2c7b9059184..2b9dc72f92b 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineTaskRunTemplate.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineTaskRunTemplate.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineTaskRunTemplate is used to specify run specifications for all Task in pipelinerun.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public PipelineTaskRunTemplate(Template podTemplate, String serviceAccountName)
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * PipelineTaskRunTemplate is used to specify run specifications for all Task in pipelinerun.
+     */
     @JsonProperty("podTemplate")
     public Template getPodTemplate() {
         return podTemplate;
     }
 
+    /**
+     * PipelineTaskRunTemplate is used to specify run specifications for all Task in pipelinerun.
+     */
     @JsonProperty("podTemplate")
     public void setPodTemplate(Template podTemplate) {
         this.podTemplate = podTemplate;
     }
 
+    /**
+     * PipelineTaskRunTemplate is used to specify run specifications for all Task in pipelinerun.
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * PipelineTaskRunTemplate is used to specify run specifications for all Task in pipelinerun.
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineWorkspaceDeclaration.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineWorkspaceDeclaration.java
index f5304ba8bd6..6bac31b6480 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineWorkspaceDeclaration.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PipelineWorkspaceDeclaration.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WorkspacePipelineDeclaration creates a named slot in a Pipeline that a PipelineRun is expected to populate with a workspace binding.<br><p> <br><p> Deprecated: use PipelineWorkspaceDeclaration type instead
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public PipelineWorkspaceDeclaration(String description, String name, Boolean opt
         this.optional = optional;
     }
 
+    /**
+     * Description is a human readable string describing how the workspace will be used in the Pipeline. It can be useful to include a bit of detail about which tasks are intended to have access to the data on the workspace.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is a human readable string describing how the workspace will be used in the Pipeline. It can be useful to include a bit of detail about which tasks are intended to have access to the data on the workspace.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * Name is the name of a workspace to be provided by a PipelineRun.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of a workspace to be provided by a PipelineRun.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Optional marks a Workspace as not being required in PipelineRuns. By default this field is false and so declared workspaces are required.
+     */
     @JsonProperty("optional")
     public Boolean getOptional() {
         return optional;
     }
 
+    /**
+     * Optional marks a Workspace as not being required in PipelineRuns. By default this field is false and so declared workspaces are required.
+     */
     @JsonProperty("optional")
     public void setOptional(Boolean optional) {
         this.optional = optional;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PropertySpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PropertySpec.java
index aa98261258a..4e98db7ab99 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PropertySpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/PropertySpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PropertySpec defines the struct for object keys
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public PropertySpec(String type) {
         this.type = type;
     }
 
+    /**
+     * PropertySpec defines the struct for object keys
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * PropertySpec defines the struct for object keys
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Provenance.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Provenance.java
index 3bb2e161a5d..d7e960e0747 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Provenance.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Provenance.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Provenance contains metadata about resources used in the TaskRun/PipelineRun such as the source from where a remote build definition was fetched. This field aims to carry minimum amoumt of metadata in &#42;Run status so that Tekton Chains can capture them in the provenance.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public Provenance(FeatureFlags featureFlags, RefSource refSource) {
         this.refSource = refSource;
     }
 
+    /**
+     * Provenance contains metadata about resources used in the TaskRun/PipelineRun such as the source from where a remote build definition was fetched. This field aims to carry minimum amoumt of metadata in &#42;Run status so that Tekton Chains can capture them in the provenance.
+     */
     @JsonProperty("featureFlags")
     public FeatureFlags getFeatureFlags() {
         return featureFlags;
     }
 
+    /**
+     * Provenance contains metadata about resources used in the TaskRun/PipelineRun such as the source from where a remote build definition was fetched. This field aims to carry minimum amoumt of metadata in &#42;Run status so that Tekton Chains can capture them in the provenance.
+     */
     @JsonProperty("featureFlags")
     public void setFeatureFlags(FeatureFlags featureFlags) {
         this.featureFlags = featureFlags;
     }
 
+    /**
+     * Provenance contains metadata about resources used in the TaskRun/PipelineRun such as the source from where a remote build definition was fetched. This field aims to carry minimum amoumt of metadata in &#42;Run status so that Tekton Chains can capture them in the provenance.
+     */
     @JsonProperty("refSource")
     public RefSource getRefSource() {
         return refSource;
     }
 
+    /**
+     * Provenance contains metadata about resources used in the TaskRun/PipelineRun such as the source from where a remote build definition was fetched. This field aims to carry minimum amoumt of metadata in &#42;Run status so that Tekton Chains can capture them in the provenance.
+     */
     @JsonProperty("refSource")
     public void setRefSource(RefSource refSource) {
         this.refSource = refSource;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Ref.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Ref.java
index ac27f8686af..cdfc1ca94c1 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Ref.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Ref.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Ref can be used to refer to a specific instance of a StepAction.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public Ref(String name) {
         this.name = name;
     }
 
+    /**
+     * Name of the referenced step
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referenced step
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/RefSource.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/RefSource.java
index f21acc5c21a..43de7c4f4d1 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/RefSource.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/RefSource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RefSource contains the information that can uniquely identify where a remote built definition came from i.e. Git repositories, Tekton Bundles in OCI registry and hub.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,32 +90,50 @@ public RefSource(Map<String, String> digest, String entryPoint, String uri) {
         this.uri = uri;
     }
 
+    /**
+     * Digest is a collection of cryptographic digests for the contents of the artifact specified by URI. Example: {"sha1": "f99d13e554ffcb696dee719fa85b695cb5b0f428"}
+     */
     @JsonProperty("digest")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getDigest() {
         return digest;
     }
 
+    /**
+     * Digest is a collection of cryptographic digests for the contents of the artifact specified by URI. Example: {"sha1": "f99d13e554ffcb696dee719fa85b695cb5b0f428"}
+     */
     @JsonProperty("digest")
     public void setDigest(Map<String, String> digest) {
         this.digest = digest;
     }
 
+    /**
+     * EntryPoint identifies the entry point into the build. This is often a path to a build definition file and/or a target label within that file. Example: "task/git-clone/0.8/git-clone.yaml"
+     */
     @JsonProperty("entryPoint")
     public String getEntryPoint() {
         return entryPoint;
     }
 
+    /**
+     * EntryPoint identifies the entry point into the build. This is often a path to a build definition file and/or a target label within that file. Example: "task/git-clone/0.8/git-clone.yaml"
+     */
     @JsonProperty("entryPoint")
     public void setEntryPoint(String entryPoint) {
         this.entryPoint = entryPoint;
     }
 
+    /**
+     * URI indicates the identity of the source of the build definition. Example: "https://github.com/tektoncd/catalog"
+     */
     @JsonProperty("uri")
     public String getUri() {
         return uri;
     }
 
+    /**
+     * URI indicates the identity of the source of the build definition. Example: "https://github.com/tektoncd/catalog"
+     */
     @JsonProperty("uri")
     public void setUri(String uri) {
         this.uri = uri;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/ResolverRef.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/ResolverRef.java
index 382e57e74a9..ed58ccc1ed2 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/ResolverRef.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/ResolverRef.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResolverRef can be used to refer to a Pipeline or Task in a remote location like a git repo. This feature is in beta and these fields are only available when the beta feature gate is enabled.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public ResolverRef(List<Param> params, String resolver) {
         this.resolver = resolver;
     }
 
+    /**
+     * Params contains the parameters used to identify the referenced Tekton resource. Example entries might include "repo" or "path" but the set of params ultimately depends on the chosen resolver.
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Param> getParams() {
         return params;
     }
 
+    /**
+     * Params contains the parameters used to identify the referenced Tekton resource. Example entries might include "repo" or "path" but the set of params ultimately depends on the chosen resolver.
+     */
     @JsonProperty("params")
     public void setParams(List<Param> params) {
         this.params = params;
     }
 
+    /**
+     * Resolver is the name of the resolver that should perform resolution of the referenced Tekton resource, such as "git".
+     */
     @JsonProperty("resolver")
     public String getResolver() {
         return resolver;
     }
 
+    /**
+     * Resolver is the name of the resolver that should perform resolution of the referenced Tekton resource, such as "git".
+     */
     @JsonProperty("resolver")
     public void setResolver(String resolver) {
         this.resolver = resolver;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/ResultRef.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/ResultRef.java
index b9422a8ac8b..faa41082cfc 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/ResultRef.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/ResultRef.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResultRef is a type that represents a reference to a task run result
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ResultRef(String pipelineTask, String property, String result, Integer re
         this.resultsIndex = resultsIndex;
     }
 
+    /**
+     * ResultRef is a type that represents a reference to a task run result
+     */
     @JsonProperty("pipelineTask")
     public String getPipelineTask() {
         return pipelineTask;
     }
 
+    /**
+     * ResultRef is a type that represents a reference to a task run result
+     */
     @JsonProperty("pipelineTask")
     public void setPipelineTask(String pipelineTask) {
         this.pipelineTask = pipelineTask;
     }
 
+    /**
+     * ResultRef is a type that represents a reference to a task run result
+     */
     @JsonProperty("property")
     public String getProperty() {
         return property;
     }
 
+    /**
+     * ResultRef is a type that represents a reference to a task run result
+     */
     @JsonProperty("property")
     public void setProperty(String property) {
         this.property = property;
     }
 
+    /**
+     * ResultRef is a type that represents a reference to a task run result
+     */
     @JsonProperty("result")
     public String getResult() {
         return result;
     }
 
+    /**
+     * ResultRef is a type that represents a reference to a task run result
+     */
     @JsonProperty("result")
     public void setResult(String result) {
         this.result = result;
     }
 
+    /**
+     * ResultRef is a type that represents a reference to a task run result
+     */
     @JsonProperty("resultsIndex")
     public Integer getResultsIndex() {
         return resultsIndex;
     }
 
+    /**
+     * ResultRef is a type that represents a reference to a task run result
+     */
     @JsonProperty("resultsIndex")
     public void setResultsIndex(Integer resultsIndex) {
         this.resultsIndex = resultsIndex;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Sidecar.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Sidecar.java
index b69d1e0ea8c..4593f3535ef 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Sidecar.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Sidecar.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Sidecar has nearly the same data structure as Step but does not have the ability to timeout.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -189,259 +192,409 @@ public Sidecar(List<String> args, List<String> command, ResourceRequirements com
         this.workspaces = workspaces;
     }
 
+    /**
+     * Arguments to the entrypoint. The image's CMD is used if this is not provided. Variable references $(VAR_NAME) are expanded using the Sidecar's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("args")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getArgs() {
         return args;
     }
 
+    /**
+     * Arguments to the entrypoint. The image's CMD is used if this is not provided. Variable references $(VAR_NAME) are expanded using the Sidecar's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("args")
     public void setArgs(List<String> args) {
         this.args = args;
     }
 
+    /**
+     * Entrypoint array. Not executed within a shell. The image's ENTRYPOINT is used if this is not provided. Variable references $(VAR_NAME) are expanded using the Sidecar's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("command")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCommand() {
         return command;
     }
 
+    /**
+     * Entrypoint array. Not executed within a shell. The image's ENTRYPOINT is used if this is not provided. Variable references $(VAR_NAME) are expanded using the Sidecar's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("command")
     public void setCommand(List<String> command) {
         this.command = command;
     }
 
+    /**
+     * Sidecar has nearly the same data structure as Step but does not have the ability to timeout.
+     */
     @JsonProperty("computeResources")
     public ResourceRequirements getComputeResources() {
         return computeResources;
     }
 
+    /**
+     * Sidecar has nearly the same data structure as Step but does not have the ability to timeout.
+     */
     @JsonProperty("computeResources")
     public void setComputeResources(ResourceRequirements computeResources) {
         this.computeResources = computeResources;
     }
 
+    /**
+     * List of environment variables to set in the Sidecar. Cannot be updated.
+     */
     @JsonProperty("env")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvVar> getEnv() {
         return env;
     }
 
+    /**
+     * List of environment variables to set in the Sidecar. Cannot be updated.
+     */
     @JsonProperty("env")
     public void setEnv(List<EnvVar> env) {
         this.env = env;
     }
 
+    /**
+     * List of sources to populate environment variables in the Sidecar. The keys defined within a source must be a C_IDENTIFIER. All invalid keys will be reported as an event when the container is starting. When a key exists in multiple sources, the value associated with the last source will take precedence. Values defined by an Env with a duplicate key will take precedence. Cannot be updated.
+     */
     @JsonProperty("envFrom")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvFromSource> getEnvFrom() {
         return envFrom;
     }
 
+    /**
+     * List of sources to populate environment variables in the Sidecar. The keys defined within a source must be a C_IDENTIFIER. All invalid keys will be reported as an event when the container is starting. When a key exists in multiple sources, the value associated with the last source will take precedence. Values defined by an Env with a duplicate key will take precedence. Cannot be updated.
+     */
     @JsonProperty("envFrom")
     public void setEnvFrom(List<EnvFromSource> envFrom) {
         this.envFrom = envFrom;
     }
 
+    /**
+     * Image reference name. More info: https://kubernetes.io/docs/concepts/containers/images
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * Image reference name. More info: https://kubernetes.io/docs/concepts/containers/images
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
     }
 
+    /**
+     * Image pull policy. One of Always, Never, IfNotPresent. Defaults to Always if :latest tag is specified, or IfNotPresent otherwise. Cannot be updated. More info: https://kubernetes.io/docs/concepts/containers/images#updating-images
+     */
     @JsonProperty("imagePullPolicy")
     public String getImagePullPolicy() {
         return imagePullPolicy;
     }
 
+    /**
+     * Image pull policy. One of Always, Never, IfNotPresent. Defaults to Always if :latest tag is specified, or IfNotPresent otherwise. Cannot be updated. More info: https://kubernetes.io/docs/concepts/containers/images#updating-images
+     */
     @JsonProperty("imagePullPolicy")
     public void setImagePullPolicy(String imagePullPolicy) {
         this.imagePullPolicy = imagePullPolicy;
     }
 
+    /**
+     * Sidecar has nearly the same data structure as Step but does not have the ability to timeout.
+     */
     @JsonProperty("lifecycle")
     public Lifecycle getLifecycle() {
         return lifecycle;
     }
 
+    /**
+     * Sidecar has nearly the same data structure as Step but does not have the ability to timeout.
+     */
     @JsonProperty("lifecycle")
     public void setLifecycle(Lifecycle lifecycle) {
         this.lifecycle = lifecycle;
     }
 
+    /**
+     * Sidecar has nearly the same data structure as Step but does not have the ability to timeout.
+     */
     @JsonProperty("livenessProbe")
     public Probe getLivenessProbe() {
         return livenessProbe;
     }
 
+    /**
+     * Sidecar has nearly the same data structure as Step but does not have the ability to timeout.
+     */
     @JsonProperty("livenessProbe")
     public void setLivenessProbe(Probe livenessProbe) {
         this.livenessProbe = livenessProbe;
     }
 
+    /**
+     * Name of the Sidecar specified as a DNS_LABEL. Each Sidecar in a Task must have a unique name (DNS_LABEL). Cannot be updated.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the Sidecar specified as a DNS_LABEL. Each Sidecar in a Task must have a unique name (DNS_LABEL). Cannot be updated.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * List of ports to expose from the Sidecar. Exposing a port here gives the system additional information about the network connections a container uses, but is primarily informational. Not specifying a port here DOES NOT prevent that port from being exposed. Any port which is listening on the default "0.0.0.0" address inside a container will be accessible from the network. Cannot be updated.
+     */
     @JsonProperty("ports")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ContainerPort> getPorts() {
         return ports;
     }
 
+    /**
+     * List of ports to expose from the Sidecar. Exposing a port here gives the system additional information about the network connections a container uses, but is primarily informational. Not specifying a port here DOES NOT prevent that port from being exposed. Any port which is listening on the default "0.0.0.0" address inside a container will be accessible from the network. Cannot be updated.
+     */
     @JsonProperty("ports")
     public void setPorts(List<ContainerPort> ports) {
         this.ports = ports;
     }
 
+    /**
+     * Sidecar has nearly the same data structure as Step but does not have the ability to timeout.
+     */
     @JsonProperty("readinessProbe")
     public Probe getReadinessProbe() {
         return readinessProbe;
     }
 
+    /**
+     * Sidecar has nearly the same data structure as Step but does not have the ability to timeout.
+     */
     @JsonProperty("readinessProbe")
     public void setReadinessProbe(Probe readinessProbe) {
         this.readinessProbe = readinessProbe;
     }
 
+    /**
+     * RestartPolicy refers to kubernetes RestartPolicy. It can only be set for an initContainer and must have it's policy set to "Always". It is currently left optional to help support Kubernetes versions prior to 1.29 when this feature was introduced.
+     */
     @JsonProperty("restartPolicy")
     public String getRestartPolicy() {
         return restartPolicy;
     }
 
+    /**
+     * RestartPolicy refers to kubernetes RestartPolicy. It can only be set for an initContainer and must have it's policy set to "Always". It is currently left optional to help support Kubernetes versions prior to 1.29 when this feature was introduced.
+     */
     @JsonProperty("restartPolicy")
     public void setRestartPolicy(String restartPolicy) {
         this.restartPolicy = restartPolicy;
     }
 
+    /**
+     * Script is the contents of an executable file to execute.<br><p> <br><p> If Script is not empty, the Step cannot have an Command or Args.
+     */
     @JsonProperty("script")
     public String getScript() {
         return script;
     }
 
+    /**
+     * Script is the contents of an executable file to execute.<br><p> <br><p> If Script is not empty, the Step cannot have an Command or Args.
+     */
     @JsonProperty("script")
     public void setScript(String script) {
         this.script = script;
     }
 
+    /**
+     * Sidecar has nearly the same data structure as Step but does not have the ability to timeout.
+     */
     @JsonProperty("securityContext")
     public SecurityContext getSecurityContext() {
         return securityContext;
     }
 
+    /**
+     * Sidecar has nearly the same data structure as Step but does not have the ability to timeout.
+     */
     @JsonProperty("securityContext")
     public void setSecurityContext(SecurityContext securityContext) {
         this.securityContext = securityContext;
     }
 
+    /**
+     * Sidecar has nearly the same data structure as Step but does not have the ability to timeout.
+     */
     @JsonProperty("startupProbe")
     public Probe getStartupProbe() {
         return startupProbe;
     }
 
+    /**
+     * Sidecar has nearly the same data structure as Step but does not have the ability to timeout.
+     */
     @JsonProperty("startupProbe")
     public void setStartupProbe(Probe startupProbe) {
         this.startupProbe = startupProbe;
     }
 
+    /**
+     * Whether this Sidecar should allocate a buffer for stdin in the container runtime. If this is not set, reads from stdin in the Sidecar will always result in EOF. Default is false.
+     */
     @JsonProperty("stdin")
     public Boolean getStdin() {
         return stdin;
     }
 
+    /**
+     * Whether this Sidecar should allocate a buffer for stdin in the container runtime. If this is not set, reads from stdin in the Sidecar will always result in EOF. Default is false.
+     */
     @JsonProperty("stdin")
     public void setStdin(Boolean stdin) {
         this.stdin = stdin;
     }
 
+    /**
+     * Whether the container runtime should close the stdin channel after it has been opened by a single attach. When stdin is true the stdin stream will remain open across multiple attach sessions. If stdinOnce is set to true, stdin is opened on Sidecar start, is empty until the first client attaches to stdin, and then remains open and accepts data until the client disconnects, at which time stdin is closed and remains closed until the Sidecar is restarted. If this flag is false, a container processes that reads from stdin will never receive an EOF. Default is false
+     */
     @JsonProperty("stdinOnce")
     public Boolean getStdinOnce() {
         return stdinOnce;
     }
 
+    /**
+     * Whether the container runtime should close the stdin channel after it has been opened by a single attach. When stdin is true the stdin stream will remain open across multiple attach sessions. If stdinOnce is set to true, stdin is opened on Sidecar start, is empty until the first client attaches to stdin, and then remains open and accepts data until the client disconnects, at which time stdin is closed and remains closed until the Sidecar is restarted. If this flag is false, a container processes that reads from stdin will never receive an EOF. Default is false
+     */
     @JsonProperty("stdinOnce")
     public void setStdinOnce(Boolean stdinOnce) {
         this.stdinOnce = stdinOnce;
     }
 
+    /**
+     * Optional: Path at which the file to which the Sidecar's termination message will be written is mounted into the Sidecar's filesystem. Message written is intended to be brief final status, such as an assertion failure message. Will be truncated by the node if greater than 4096 bytes. The total message length across all containers will be limited to 12kb. Defaults to /dev/termination-log. Cannot be updated.
+     */
     @JsonProperty("terminationMessagePath")
     public String getTerminationMessagePath() {
         return terminationMessagePath;
     }
 
+    /**
+     * Optional: Path at which the file to which the Sidecar's termination message will be written is mounted into the Sidecar's filesystem. Message written is intended to be brief final status, such as an assertion failure message. Will be truncated by the node if greater than 4096 bytes. The total message length across all containers will be limited to 12kb. Defaults to /dev/termination-log. Cannot be updated.
+     */
     @JsonProperty("terminationMessagePath")
     public void setTerminationMessagePath(String terminationMessagePath) {
         this.terminationMessagePath = terminationMessagePath;
     }
 
+    /**
+     * Indicate how the termination message should be populated. File will use the contents of terminationMessagePath to populate the Sidecar status message on both success and failure. FallbackToLogsOnError will use the last chunk of Sidecar log output if the termination message file is empty and the Sidecar exited with an error. The log output is limited to 2048 bytes or 80 lines, whichever is smaller. Defaults to File. Cannot be updated.
+     */
     @JsonProperty("terminationMessagePolicy")
     public String getTerminationMessagePolicy() {
         return terminationMessagePolicy;
     }
 
+    /**
+     * Indicate how the termination message should be populated. File will use the contents of terminationMessagePath to populate the Sidecar status message on both success and failure. FallbackToLogsOnError will use the last chunk of Sidecar log output if the termination message file is empty and the Sidecar exited with an error. The log output is limited to 2048 bytes or 80 lines, whichever is smaller. Defaults to File. Cannot be updated.
+     */
     @JsonProperty("terminationMessagePolicy")
     public void setTerminationMessagePolicy(String terminationMessagePolicy) {
         this.terminationMessagePolicy = terminationMessagePolicy;
     }
 
+    /**
+     * Whether this Sidecar should allocate a TTY for itself, also requires 'stdin' to be true. Default is false.
+     */
     @JsonProperty("tty")
     public Boolean getTty() {
         return tty;
     }
 
+    /**
+     * Whether this Sidecar should allocate a TTY for itself, also requires 'stdin' to be true. Default is false.
+     */
     @JsonProperty("tty")
     public void setTty(Boolean tty) {
         this.tty = tty;
     }
 
+    /**
+     * volumeDevices is the list of block devices to be used by the Sidecar.
+     */
     @JsonProperty("volumeDevices")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VolumeDevice> getVolumeDevices() {
         return volumeDevices;
     }
 
+    /**
+     * volumeDevices is the list of block devices to be used by the Sidecar.
+     */
     @JsonProperty("volumeDevices")
     public void setVolumeDevices(List<VolumeDevice> volumeDevices) {
         this.volumeDevices = volumeDevices;
     }
 
+    /**
+     * Volumes to mount into the Sidecar's filesystem. Cannot be updated.
+     */
     @JsonProperty("volumeMounts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VolumeMount> getVolumeMounts() {
         return volumeMounts;
     }
 
+    /**
+     * Volumes to mount into the Sidecar's filesystem. Cannot be updated.
+     */
     @JsonProperty("volumeMounts")
     public void setVolumeMounts(List<VolumeMount> volumeMounts) {
         this.volumeMounts = volumeMounts;
     }
 
+    /**
+     * Sidecar's working directory. If not specified, the container runtime's default will be used, which might be configured in the container image. Cannot be updated.
+     */
     @JsonProperty("workingDir")
     public String getWorkingDir() {
         return workingDir;
     }
 
+    /**
+     * Sidecar's working directory. If not specified, the container runtime's default will be used, which might be configured in the container image. Cannot be updated.
+     */
     @JsonProperty("workingDir")
     public void setWorkingDir(String workingDir) {
         this.workingDir = workingDir;
     }
 
+    /**
+     * This is an alpha field. You must set the "enable-api-fields" feature flag to "alpha" for this field to be supported.<br><p> <br><p> Workspaces is a list of workspaces from the Task that this Sidecar wants exclusive access to. Adding a workspace to this list means that any other Step or Sidecar that does not also request this Workspace will not have access to it.
+     */
     @JsonProperty("workspaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WorkspaceUsage> getWorkspaces() {
         return workspaces;
     }
 
+    /**
+     * This is an alpha field. You must set the "enable-api-fields" feature flag to "alpha" for this field to be supported.<br><p> <br><p> Workspaces is a list of workspaces from the Task that this Sidecar wants exclusive access to. Adding a workspace to this list means that any other Step or Sidecar that does not also request this Workspace will not have access to it.
+     */
     @JsonProperty("workspaces")
     public void setWorkspaces(List<WorkspaceUsage> workspaces) {
         this.workspaces = workspaces;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/SidecarState.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/SidecarState.java
index b98f01dd5ac..85dbafb6d47 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/SidecarState.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/SidecarState.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SidecarState reports the results of running a sidecar in a Task.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,61 +104,97 @@ public SidecarState(String container, String imageID, String name, ContainerStat
         this.waiting = waiting;
     }
 
+    /**
+     * SidecarState reports the results of running a sidecar in a Task.
+     */
     @JsonProperty("container")
     public String getContainer() {
         return container;
     }
 
+    /**
+     * SidecarState reports the results of running a sidecar in a Task.
+     */
     @JsonProperty("container")
     public void setContainer(String container) {
         this.container = container;
     }
 
+    /**
+     * SidecarState reports the results of running a sidecar in a Task.
+     */
     @JsonProperty("imageID")
     public String getImageID() {
         return imageID;
     }
 
+    /**
+     * SidecarState reports the results of running a sidecar in a Task.
+     */
     @JsonProperty("imageID")
     public void setImageID(String imageID) {
         this.imageID = imageID;
     }
 
+    /**
+     * SidecarState reports the results of running a sidecar in a Task.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * SidecarState reports the results of running a sidecar in a Task.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * SidecarState reports the results of running a sidecar in a Task.
+     */
     @JsonProperty("running")
     public ContainerStateRunning getRunning() {
         return running;
     }
 
+    /**
+     * SidecarState reports the results of running a sidecar in a Task.
+     */
     @JsonProperty("running")
     public void setRunning(ContainerStateRunning running) {
         this.running = running;
     }
 
+    /**
+     * SidecarState reports the results of running a sidecar in a Task.
+     */
     @JsonProperty("terminated")
     public ContainerStateTerminated getTerminated() {
         return terminated;
     }
 
+    /**
+     * SidecarState reports the results of running a sidecar in a Task.
+     */
     @JsonProperty("terminated")
     public void setTerminated(ContainerStateTerminated terminated) {
         this.terminated = terminated;
     }
 
+    /**
+     * SidecarState reports the results of running a sidecar in a Task.
+     */
     @JsonProperty("waiting")
     public ContainerStateWaiting getWaiting() {
         return waiting;
     }
 
+    /**
+     * SidecarState reports the results of running a sidecar in a Task.
+     */
     @JsonProperty("waiting")
     public void setWaiting(ContainerStateWaiting waiting) {
         this.waiting = waiting;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/SkippedTask.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/SkippedTask.java
index b2c5238e8f1..9a121345af5 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/SkippedTask.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/SkippedTask.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SkippedTask is used to describe the Tasks that were skipped due to their When Expressions evaluating to False. This is a struct because we are looking into including more details about the When Expressions that caused this Task to be skipped.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public SkippedTask(String name, String reason, List<WhenExpression> whenExpressi
         this.whenExpressions = whenExpressions;
     }
 
+    /**
+     * Name is the Pipeline Task name
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the Pipeline Task name
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Reason is the cause of the PipelineTask being skipped.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason is the cause of the PipelineTask being skipped.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * WhenExpressions is the list of checks guarding the execution of the PipelineTask
+     */
     @JsonProperty("whenExpressions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WhenExpression> getWhenExpressions() {
         return whenExpressions;
     }
 
+    /**
+     * WhenExpressions is the list of checks guarding the execution of the PipelineTask
+     */
     @JsonProperty("whenExpressions")
     public void setWhenExpressions(List<WhenExpression> whenExpressions) {
         this.whenExpressions = whenExpressions;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Step.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Step.java
index 5b7f3ddb066..a19d09452d3 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Step.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Step.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Step runs a subcomponent of a Task
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -178,231 +181,363 @@ public Step(List<String> args, List<String> command, ResourceRequirements comput
         this.workspaces = workspaces;
     }
 
+    /**
+     * Arguments to the entrypoint. The image's CMD is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("args")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getArgs() {
         return args;
     }
 
+    /**
+     * Arguments to the entrypoint. The image's CMD is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("args")
     public void setArgs(List<String> args) {
         this.args = args;
     }
 
+    /**
+     * Entrypoint array. Not executed within a shell. The image's ENTRYPOINT is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("command")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCommand() {
         return command;
     }
 
+    /**
+     * Entrypoint array. Not executed within a shell. The image's ENTRYPOINT is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("command")
     public void setCommand(List<String> command) {
         this.command = command;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("computeResources")
     public ResourceRequirements getComputeResources() {
         return computeResources;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("computeResources")
     public void setComputeResources(ResourceRequirements computeResources) {
         this.computeResources = computeResources;
     }
 
+    /**
+     * List of environment variables to set in the Step. Cannot be updated.
+     */
     @JsonProperty("env")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvVar> getEnv() {
         return env;
     }
 
+    /**
+     * List of environment variables to set in the Step. Cannot be updated.
+     */
     @JsonProperty("env")
     public void setEnv(List<EnvVar> env) {
         this.env = env;
     }
 
+    /**
+     * List of sources to populate environment variables in the Step. The keys defined within a source must be a C_IDENTIFIER. All invalid keys will be reported as an event when the Step is starting. When a key exists in multiple sources, the value associated with the last source will take precedence. Values defined by an Env with a duplicate key will take precedence. Cannot be updated.
+     */
     @JsonProperty("envFrom")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvFromSource> getEnvFrom() {
         return envFrom;
     }
 
+    /**
+     * List of sources to populate environment variables in the Step. The keys defined within a source must be a C_IDENTIFIER. All invalid keys will be reported as an event when the Step is starting. When a key exists in multiple sources, the value associated with the last source will take precedence. Values defined by an Env with a duplicate key will take precedence. Cannot be updated.
+     */
     @JsonProperty("envFrom")
     public void setEnvFrom(List<EnvFromSource> envFrom) {
         this.envFrom = envFrom;
     }
 
+    /**
+     * Docker image name. More info: https://kubernetes.io/docs/concepts/containers/images
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * Docker image name. More info: https://kubernetes.io/docs/concepts/containers/images
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
     }
 
+    /**
+     * Image pull policy. One of Always, Never, IfNotPresent. Defaults to Always if :latest tag is specified, or IfNotPresent otherwise. Cannot be updated. More info: https://kubernetes.io/docs/concepts/containers/images#updating-images
+     */
     @JsonProperty("imagePullPolicy")
     public String getImagePullPolicy() {
         return imagePullPolicy;
     }
 
+    /**
+     * Image pull policy. One of Always, Never, IfNotPresent. Defaults to Always if :latest tag is specified, or IfNotPresent otherwise. Cannot be updated. More info: https://kubernetes.io/docs/concepts/containers/images#updating-images
+     */
     @JsonProperty("imagePullPolicy")
     public void setImagePullPolicy(String imagePullPolicy) {
         this.imagePullPolicy = imagePullPolicy;
     }
 
+    /**
+     * Name of the Step specified as a DNS_LABEL. Each Step in a Task must have a unique name.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the Step specified as a DNS_LABEL. Each Step in a Task must have a unique name.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * OnError defines the exiting behavior of a container on error can be set to [ continue | stopAndFail ]
+     */
     @JsonProperty("onError")
     public String getOnError() {
         return onError;
     }
 
+    /**
+     * OnError defines the exiting behavior of a container on error can be set to [ continue | stopAndFail ]
+     */
     @JsonProperty("onError")
     public void setOnError(String onError) {
         this.onError = onError;
     }
 
+    /**
+     * Params declares parameters passed to this step action.
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Param> getParams() {
         return params;
     }
 
+    /**
+     * Params declares parameters passed to this step action.
+     */
     @JsonProperty("params")
     public void setParams(List<Param> params) {
         this.params = params;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("ref")
     public Ref getRef() {
         return ref;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("ref")
     public void setRef(Ref ref) {
         this.ref = ref;
     }
 
+    /**
+     * Results declares StepResults produced by the Step.<br><p> <br><p> This is field is at an ALPHA stability level and gated by "enable-step-actions" feature flag.<br><p> <br><p> It can be used in an inlined Step when used to store Results to $(step.results.resultName.path). It cannot be used when referencing StepActions using [v1.Step.Ref]. The Results declared by the StepActions will be stored here instead.
+     */
     @JsonProperty("results")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<StepResult> getResults() {
         return results;
     }
 
+    /**
+     * Results declares StepResults produced by the Step.<br><p> <br><p> This is field is at an ALPHA stability level and gated by "enable-step-actions" feature flag.<br><p> <br><p> It can be used in an inlined Step when used to store Results to $(step.results.resultName.path). It cannot be used when referencing StepActions using [v1.Step.Ref]. The Results declared by the StepActions will be stored here instead.
+     */
     @JsonProperty("results")
     public void setResults(List<StepResult> results) {
         this.results = results;
     }
 
+    /**
+     * Script is the contents of an executable file to execute.<br><p> <br><p> If Script is not empty, the Step cannot have an Command and the Args will be passed to the Script.
+     */
     @JsonProperty("script")
     public String getScript() {
         return script;
     }
 
+    /**
+     * Script is the contents of an executable file to execute.<br><p> <br><p> If Script is not empty, the Step cannot have an Command and the Args will be passed to the Script.
+     */
     @JsonProperty("script")
     public void setScript(String script) {
         this.script = script;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("securityContext")
     public SecurityContext getSecurityContext() {
         return securityContext;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("securityContext")
     public void setSecurityContext(SecurityContext securityContext) {
         this.securityContext = securityContext;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("stderrConfig")
     public StepOutputConfig getStderrConfig() {
         return stderrConfig;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("stderrConfig")
     public void setStderrConfig(StepOutputConfig stderrConfig) {
         this.stderrConfig = stderrConfig;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("stdoutConfig")
     public StepOutputConfig getStdoutConfig() {
         return stdoutConfig;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("stdoutConfig")
     public void setStdoutConfig(StepOutputConfig stdoutConfig) {
         this.stdoutConfig = stdoutConfig;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("timeout")
     public Duration getTimeout() {
         return timeout;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("timeout")
     public void setTimeout(Duration timeout) {
         this.timeout = timeout;
     }
 
+    /**
+     * volumeDevices is the list of block devices to be used by the Step.
+     */
     @JsonProperty("volumeDevices")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VolumeDevice> getVolumeDevices() {
         return volumeDevices;
     }
 
+    /**
+     * volumeDevices is the list of block devices to be used by the Step.
+     */
     @JsonProperty("volumeDevices")
     public void setVolumeDevices(List<VolumeDevice> volumeDevices) {
         this.volumeDevices = volumeDevices;
     }
 
+    /**
+     * Volumes to mount into the Step's filesystem. Cannot be updated.
+     */
     @JsonProperty("volumeMounts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VolumeMount> getVolumeMounts() {
         return volumeMounts;
     }
 
+    /**
+     * Volumes to mount into the Step's filesystem. Cannot be updated.
+     */
     @JsonProperty("volumeMounts")
     public void setVolumeMounts(List<VolumeMount> volumeMounts) {
         this.volumeMounts = volumeMounts;
     }
 
+    /**
+     * When is a list of when expressions that need to be true for the task to run
+     */
     @JsonProperty("when")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WhenExpression> getWhen() {
         return when;
     }
 
+    /**
+     * When is a list of when expressions that need to be true for the task to run
+     */
     @JsonProperty("when")
     public void setWhen(List<WhenExpression> when) {
         this.when = when;
     }
 
+    /**
+     * Step's working directory. If not specified, the container runtime's default will be used, which might be configured in the container image. Cannot be updated.
+     */
     @JsonProperty("workingDir")
     public String getWorkingDir() {
         return workingDir;
     }
 
+    /**
+     * Step's working directory. If not specified, the container runtime's default will be used, which might be configured in the container image. Cannot be updated.
+     */
     @JsonProperty("workingDir")
     public void setWorkingDir(String workingDir) {
         this.workingDir = workingDir;
     }
 
+    /**
+     * This is an alpha field. You must set the "enable-api-fields" feature flag to "alpha" for this field to be supported.<br><p> <br><p> Workspaces is a list of workspaces from the Task that this Step wants exclusive access to. Adding a workspace to this list means that any other Step or Sidecar that does not also request this Workspace will not have access to it.
+     */
     @JsonProperty("workspaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WorkspaceUsage> getWorkspaces() {
         return workspaces;
     }
 
+    /**
+     * This is an alpha field. You must set the "enable-api-fields" feature flag to "alpha" for this field to be supported.<br><p> <br><p> Workspaces is a list of workspaces from the Task that this Step wants exclusive access to. Adding a workspace to this list means that any other Step or Sidecar that does not also request this Workspace will not have access to it.
+     */
     @JsonProperty("workspaces")
     public void setWorkspaces(List<WorkspaceUsage> workspaces) {
         this.workspaces = workspaces;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/StepOutputConfig.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/StepOutputConfig.java
index 4bc29c9f352..65e39b297bb 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/StepOutputConfig.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/StepOutputConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StepOutputConfig stores configuration for a step output stream.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public StepOutputConfig(String path) {
         this.path = path;
     }
 
+    /**
+     * Path to duplicate stdout stream to on container's local filesystem.
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Path to duplicate stdout stream to on container's local filesystem.
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/StepResult.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/StepResult.java
index fcc9b8f6b32..83ca92e4c81 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/StepResult.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/StepResult.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StepResult used to describe the Results of a Step.<br><p> <br><p> This is field is at an BETA stability level and gated by "enable-step-actions" feature flag.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,42 +94,66 @@ public StepResult(String description, String name, Map<String, PropertySpec> pro
         this.type = type;
     }
 
+    /**
+     * Description is a human-readable description of the result
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is a human-readable description of the result
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * Name the given name
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name the given name
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Properties is the JSON Schema properties to support key-value pairs results.
+     */
     @JsonProperty("properties")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, PropertySpec> getProperties() {
         return properties;
     }
 
+    /**
+     * Properties is the JSON Schema properties to support key-value pairs results.
+     */
     @JsonProperty("properties")
     public void setProperties(Map<String, PropertySpec> properties) {
         this.properties = properties;
     }
 
+    /**
+     * The possible types are 'string', 'array', and 'object', with 'string' as the default.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * The possible types are 'string', 'array', and 'object', with 'string' as the default.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/StepState.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/StepState.java
index b264b5de6af..727c4b7f5b0 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/StepState.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/StepState.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StepState reports the results of running a step in a Task.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -126,114 +129,180 @@ public StepState(String container, String imageID, List<Artifact> inputs, String
         this.waiting = waiting;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("container")
     public String getContainer() {
         return container;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("container")
     public void setContainer(String container) {
         this.container = container;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("imageID")
     public String getImageID() {
         return imageID;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("imageID")
     public void setImageID(String imageID) {
         this.imageID = imageID;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("inputs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Artifact> getInputs() {
         return inputs;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("inputs")
     public void setInputs(List<Artifact> inputs) {
         this.inputs = inputs;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("outputs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Artifact> getOutputs() {
         return outputs;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("outputs")
     public void setOutputs(List<Artifact> outputs) {
         this.outputs = outputs;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("provenance")
     public Provenance getProvenance() {
         return provenance;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("provenance")
     public void setProvenance(Provenance provenance) {
         this.provenance = provenance;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("results")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TaskRunResult> getResults() {
         return results;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("results")
     public void setResults(List<TaskRunResult> results) {
         this.results = results;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("running")
     public ContainerStateRunning getRunning() {
         return running;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("running")
     public void setRunning(ContainerStateRunning running) {
         this.running = running;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("terminated")
     public ContainerStateTerminated getTerminated() {
         return terminated;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("terminated")
     public void setTerminated(ContainerStateTerminated terminated) {
         this.terminated = terminated;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("terminationReason")
     public String getTerminationReason() {
         return terminationReason;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("terminationReason")
     public void setTerminationReason(String terminationReason) {
         this.terminationReason = terminationReason;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("waiting")
     public ContainerStateWaiting getWaiting() {
         return waiting;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("waiting")
     public void setWaiting(ContainerStateWaiting waiting) {
         this.waiting = waiting;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/StepTemplate.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/StepTemplate.java
index 1cfda88c3a8..ee39e327a78 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/StepTemplate.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/StepTemplate.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StepTemplate is a template for a Step
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -129,117 +132,183 @@ public StepTemplate(List<String> args, List<String> command, ResourceRequirement
         this.workingDir = workingDir;
     }
 
+    /**
+     * Arguments to the entrypoint. The image's CMD is used if this is not provided. Variable references $(VAR_NAME) are expanded using the Step's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("args")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getArgs() {
         return args;
     }
 
+    /**
+     * Arguments to the entrypoint. The image's CMD is used if this is not provided. Variable references $(VAR_NAME) are expanded using the Step's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("args")
     public void setArgs(List<String> args) {
         this.args = args;
     }
 
+    /**
+     * Entrypoint array. Not executed within a shell. The image's ENTRYPOINT is used if this is not provided. Variable references $(VAR_NAME) are expanded using the Step's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("command")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCommand() {
         return command;
     }
 
+    /**
+     * Entrypoint array. Not executed within a shell. The image's ENTRYPOINT is used if this is not provided. Variable references $(VAR_NAME) are expanded using the Step's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("command")
     public void setCommand(List<String> command) {
         this.command = command;
     }
 
+    /**
+     * StepTemplate is a template for a Step
+     */
     @JsonProperty("computeResources")
     public ResourceRequirements getComputeResources() {
         return computeResources;
     }
 
+    /**
+     * StepTemplate is a template for a Step
+     */
     @JsonProperty("computeResources")
     public void setComputeResources(ResourceRequirements computeResources) {
         this.computeResources = computeResources;
     }
 
+    /**
+     * List of environment variables to set in the Step. Cannot be updated.
+     */
     @JsonProperty("env")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvVar> getEnv() {
         return env;
     }
 
+    /**
+     * List of environment variables to set in the Step. Cannot be updated.
+     */
     @JsonProperty("env")
     public void setEnv(List<EnvVar> env) {
         this.env = env;
     }
 
+    /**
+     * List of sources to populate environment variables in the Step. The keys defined within a source must be a C_IDENTIFIER. All invalid keys will be reported as an event when the Step is starting. When a key exists in multiple sources, the value associated with the last source will take precedence. Values defined by an Env with a duplicate key will take precedence. Cannot be updated.
+     */
     @JsonProperty("envFrom")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvFromSource> getEnvFrom() {
         return envFrom;
     }
 
+    /**
+     * List of sources to populate environment variables in the Step. The keys defined within a source must be a C_IDENTIFIER. All invalid keys will be reported as an event when the Step is starting. When a key exists in multiple sources, the value associated with the last source will take precedence. Values defined by an Env with a duplicate key will take precedence. Cannot be updated.
+     */
     @JsonProperty("envFrom")
     public void setEnvFrom(List<EnvFromSource> envFrom) {
         this.envFrom = envFrom;
     }
 
+    /**
+     * Image reference name. More info: https://kubernetes.io/docs/concepts/containers/images
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * Image reference name. More info: https://kubernetes.io/docs/concepts/containers/images
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
     }
 
+    /**
+     * Image pull policy. One of Always, Never, IfNotPresent. Defaults to Always if :latest tag is specified, or IfNotPresent otherwise. Cannot be updated. More info: https://kubernetes.io/docs/concepts/containers/images#updating-images
+     */
     @JsonProperty("imagePullPolicy")
     public String getImagePullPolicy() {
         return imagePullPolicy;
     }
 
+    /**
+     * Image pull policy. One of Always, Never, IfNotPresent. Defaults to Always if :latest tag is specified, or IfNotPresent otherwise. Cannot be updated. More info: https://kubernetes.io/docs/concepts/containers/images#updating-images
+     */
     @JsonProperty("imagePullPolicy")
     public void setImagePullPolicy(String imagePullPolicy) {
         this.imagePullPolicy = imagePullPolicy;
     }
 
+    /**
+     * StepTemplate is a template for a Step
+     */
     @JsonProperty("securityContext")
     public SecurityContext getSecurityContext() {
         return securityContext;
     }
 
+    /**
+     * StepTemplate is a template for a Step
+     */
     @JsonProperty("securityContext")
     public void setSecurityContext(SecurityContext securityContext) {
         this.securityContext = securityContext;
     }
 
+    /**
+     * volumeDevices is the list of block devices to be used by the Step.
+     */
     @JsonProperty("volumeDevices")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VolumeDevice> getVolumeDevices() {
         return volumeDevices;
     }
 
+    /**
+     * volumeDevices is the list of block devices to be used by the Step.
+     */
     @JsonProperty("volumeDevices")
     public void setVolumeDevices(List<VolumeDevice> volumeDevices) {
         this.volumeDevices = volumeDevices;
     }
 
+    /**
+     * Volumes to mount into the Step's filesystem. Cannot be updated.
+     */
     @JsonProperty("volumeMounts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VolumeMount> getVolumeMounts() {
         return volumeMounts;
     }
 
+    /**
+     * Volumes to mount into the Step's filesystem. Cannot be updated.
+     */
     @JsonProperty("volumeMounts")
     public void setVolumeMounts(List<VolumeMount> volumeMounts) {
         this.volumeMounts = volumeMounts;
     }
 
+    /**
+     * Step's working directory. If not specified, the container runtime's default will be used, which might be configured in the container image. Cannot be updated.
+     */
     @JsonProperty("workingDir")
     public String getWorkingDir() {
         return workingDir;
     }
 
+    /**
+     * Step's working directory. If not specified, the container runtime's default will be used, which might be configured in the container image. Cannot be updated.
+     */
     @JsonProperty("workingDir")
     public void setWorkingDir(String workingDir) {
         this.workingDir = workingDir;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Task.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Task.java
index bbaf3293df4..16d08e44ea8 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Task.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/Task.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Task represents a collection of sequential steps that are run as part of a Pipeline using a set of inputs and producing a set of outputs. Tasks execute when TaskRuns are created that provide the input parameters and resources and output resources the Task requires.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Task implements Editable<TaskBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Task";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public Task(String apiVersion, String kind, ObjectMeta metadata, TaskSpec spec)
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Task represents a collection of sequential steps that are run as part of a Pipeline using a set of inputs and producing a set of outputs. Tasks execute when TaskRuns are created that provide the input parameters and resources and output resources the Task requires.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Task represents a collection of sequential steps that are run as part of a Pipeline using a set of inputs and producing a set of outputs. Tasks execute when TaskRuns are created that provide the input parameters and resources and output resources the Task requires.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Task represents a collection of sequential steps that are run as part of a Pipeline using a set of inputs and producing a set of outputs. Tasks execute when TaskRuns are created that provide the input parameters and resources and output resources the Task requires.
+     */
     @JsonProperty("spec")
     public TaskSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Task represents a collection of sequential steps that are run as part of a Pipeline using a set of inputs and producing a set of outputs. Tasks execute when TaskRuns are created that provide the input parameters and resources and output resources the Task requires.
+     */
     @JsonProperty("spec")
     public void setSpec(TaskSpec spec) {
         this.spec = spec;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskBreakpoints.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskBreakpoints.java
index 0a40072072a..1cd86043ddc 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskBreakpoints.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskBreakpoints.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskBreakpoints defines the breakpoint config for a particular Task
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public TaskBreakpoints(List<String> beforeSteps, String onFailure) {
         this.onFailure = onFailure;
     }
 
+    /**
+     * TaskBreakpoints defines the breakpoint config for a particular Task
+     */
     @JsonProperty("beforeSteps")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getBeforeSteps() {
         return beforeSteps;
     }
 
+    /**
+     * TaskBreakpoints defines the breakpoint config for a particular Task
+     */
     @JsonProperty("beforeSteps")
     public void setBeforeSteps(List<String> beforeSteps) {
         this.beforeSteps = beforeSteps;
     }
 
+    /**
+     * if enabled, pause TaskRun on failure of a step failed step will not exit
+     */
     @JsonProperty("onFailure")
     public String getOnFailure() {
         return onFailure;
     }
 
+    /**
+     * if enabled, pause TaskRun on failure of a step failed step will not exit
+     */
     @JsonProperty("onFailure")
     public void setOnFailure(String onFailure) {
         this.onFailure = onFailure;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskList.java
index e6240b8f3de..d04d0601a17 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskList contains a list of Task
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class TaskList implements Editable<TaskListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.v1.Task>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.v1.Task> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TaskList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TaskList(String apiVersion, List<io.fabric8.tekton.v1.Task> items, String
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * TaskList contains a list of Task
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.v1.Task> getItems() {
         return items;
     }
 
+    /**
+     * TaskList contains a list of Task
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.v1.Task> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TaskList contains a list of Task
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TaskList contains a list of Task
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRef.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRef.java
index 481f0d052d8..75d9b6f7def 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRef.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRef.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskRef can be used to refer to a specific instance of a task.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public TaskRef(String apiVersion, String kind, String name) {
         this.name = name;
     }
 
+    /**
+     * API version of the referent Note: A Task with non-empty APIVersion and Kind is considered a Custom Task
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * API version of the referent Note: A Task with non-empty APIVersion and Kind is considered a Custom Task
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * TaskKind indicates the Kind of the Task: 1. Namespaced Task when Kind is set to "Task". If Kind is "", it defaults to "Task". 2. Custom Task when Kind is non-empty and APIVersion is non-empty
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * TaskKind indicates the Kind of the Task: 1. Namespaced Task when Kind is set to "Task". If Kind is "", it defaults to "Task". 2. Custom Task when Kind is non-empty and APIVersion is non-empty
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name of the referent; More info: http://kubernetes.io/docs/user-guide/identifiers#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referent; More info: http://kubernetes.io/docs/user-guide/identifiers#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskResult.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskResult.java
index beadba094aa..eaa1072d279 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskResult.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskResult.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskResult used to describe the results of a task
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,52 +98,82 @@ public TaskResult(String description, String name, Map<String, PropertySpec> pro
         this.value = value;
     }
 
+    /**
+     * Description is a human-readable description of the result
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is a human-readable description of the result
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * Name the given name
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name the given name
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Properties is the JSON Schema properties to support key-value pairs results.
+     */
     @JsonProperty("properties")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, PropertySpec> getProperties() {
         return properties;
     }
 
+    /**
+     * Properties is the JSON Schema properties to support key-value pairs results.
+     */
     @JsonProperty("properties")
     public void setProperties(Map<String, PropertySpec> properties) {
         this.properties = properties;
     }
 
+    /**
+     * Type is the user-specified type of the result. The possible type is currently "string" and will support "array" in following work.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the user-specified type of the result. The possible type is currently "string" and will support "array" in following work.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * TaskResult used to describe the results of a task
+     */
     @JsonProperty("value")
     public ParamValue getValue() {
         return value;
     }
 
+    /**
+     * TaskResult used to describe the results of a task
+     */
     @JsonProperty("value")
     public void setValue(ParamValue value) {
         this.value = value;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRun.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRun.java
index 7527b843844..b66bc466bc5 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRun.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRun.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskRun represents a single execution of a Task. TaskRuns are how the steps specified in a Task are executed; they specify the parameters and resources used to run the steps in a Task.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class TaskRun implements Editable<TaskRunBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TaskRun";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TaskRun(String apiVersion, String kind, ObjectMeta metadata, TaskRunSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TaskRun represents a single execution of a Task. TaskRuns are how the steps specified in a Task are executed; they specify the parameters and resources used to run the steps in a Task.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TaskRun represents a single execution of a Task. TaskRuns are how the steps specified in a Task are executed; they specify the parameters and resources used to run the steps in a Task.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * TaskRun represents a single execution of a Task. TaskRuns are how the steps specified in a Task are executed; they specify the parameters and resources used to run the steps in a Task.
+     */
     @JsonProperty("spec")
     public TaskRunSpec getSpec() {
         return spec;
     }
 
+    /**
+     * TaskRun represents a single execution of a Task. TaskRuns are how the steps specified in a Task are executed; they specify the parameters and resources used to run the steps in a Task.
+     */
     @JsonProperty("spec")
     public void setSpec(TaskRunSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * TaskRun represents a single execution of a Task. TaskRuns are how the steps specified in a Task are executed; they specify the parameters and resources used to run the steps in a Task.
+     */
     @JsonProperty("status")
     public TaskRunStatus getStatus() {
         return status;
     }
 
+    /**
+     * TaskRun represents a single execution of a Task. TaskRuns are how the steps specified in a Task are executed; they specify the parameters and resources used to run the steps in a Task.
+     */
     @JsonProperty("status")
     public void setStatus(TaskRunStatus status) {
         this.status = status;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunDebug.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunDebug.java
index 33f57a7103e..d96c7c674e8 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunDebug.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunDebug.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskRunDebug defines the breakpoint config for a particular TaskRun
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public TaskRunDebug(TaskBreakpoints breakpoints) {
         this.breakpoints = breakpoints;
     }
 
+    /**
+     * TaskRunDebug defines the breakpoint config for a particular TaskRun
+     */
     @JsonProperty("breakpoints")
     public TaskBreakpoints getBreakpoints() {
         return breakpoints;
     }
 
+    /**
+     * TaskRunDebug defines the breakpoint config for a particular TaskRun
+     */
     @JsonProperty("breakpoints")
     public void setBreakpoints(TaskBreakpoints breakpoints) {
         this.breakpoints = breakpoints;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunInputs.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunInputs.java
index e5fb1ede6bd..ff33b70ab67 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunInputs.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunInputs.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskRunInputs holds the input values that this task was invoked with.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public TaskRunInputs(List<Param> params) {
         this.params = params;
     }
 
+    /**
+     * TaskRunInputs holds the input values that this task was invoked with.
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Param> getParams() {
         return params;
     }
 
+    /**
+     * TaskRunInputs holds the input values that this task was invoked with.
+     */
     @JsonProperty("params")
     public void setParams(List<Param> params) {
         this.params = params;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunList.java
index c366279a56b..2bd2bfb9f74 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskRunList contains a list of TaskRun
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class TaskRunList implements Editable<TaskRunListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.v1.TaskRun>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.v1.TaskRun> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TaskRunList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TaskRunList(String apiVersion, List<io.fabric8.tekton.v1.TaskRun> items,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * TaskRunList contains a list of TaskRun
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.v1.TaskRun> getItems() {
         return items;
     }
 
+    /**
+     * TaskRunList contains a list of TaskRun
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.v1.TaskRun> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TaskRunList contains a list of TaskRun
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TaskRunList contains a list of TaskRun
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunResult.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunResult.java
index 3bcc5b84652..58bcc324dea 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunResult.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunResult.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskRunStepResult is a type alias of TaskRunResult
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public TaskRunResult(String name, String type, ParamValue value) {
         this.value = value;
     }
 
+    /**
+     * Name the given name
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name the given name
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Type is the user-specified type of the result. The possible type is currently "string" and will support "array" in following work.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the user-specified type of the result. The possible type is currently "string" and will support "array" in following work.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * TaskRunStepResult is a type alias of TaskRunResult
+     */
     @JsonProperty("value")
     public ParamValue getValue() {
         return value;
     }
 
+    /**
+     * TaskRunStepResult is a type alias of TaskRunResult
+     */
     @JsonProperty("value")
     public void setValue(ParamValue value) {
         this.value = value;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunSidecarSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunSidecarSpec.java
index 86bf8b53cde..452137f3da6 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunSidecarSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunSidecarSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskRunSidecarSpec is used to override the values of a Sidecar in the corresponding Task.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public TaskRunSidecarSpec(ResourceRequirements computeResources, String name) {
         this.name = name;
     }
 
+    /**
+     * TaskRunSidecarSpec is used to override the values of a Sidecar in the corresponding Task.
+     */
     @JsonProperty("computeResources")
     public ResourceRequirements getComputeResources() {
         return computeResources;
     }
 
+    /**
+     * TaskRunSidecarSpec is used to override the values of a Sidecar in the corresponding Task.
+     */
     @JsonProperty("computeResources")
     public void setComputeResources(ResourceRequirements computeResources) {
         this.computeResources = computeResources;
     }
 
+    /**
+     * The name of the Sidecar to override.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The name of the Sidecar to override.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunSpec.java
index 988a2fde671..aeb632ae46c 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunSpec.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskRunSpec defines the desired state of TaskRun
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -138,145 +141,229 @@ public TaskRunSpec(ResourceRequirements computeResources, TaskRunDebug debug, Li
         this.workspaces = workspaces;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("computeResources")
     public ResourceRequirements getComputeResources() {
         return computeResources;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("computeResources")
     public void setComputeResources(ResourceRequirements computeResources) {
         this.computeResources = computeResources;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("debug")
     public TaskRunDebug getDebug() {
         return debug;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("debug")
     public void setDebug(TaskRunDebug debug) {
         this.debug = debug;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Param> getParams() {
         return params;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("params")
     public void setParams(List<Param> params) {
         this.params = params;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("podTemplate")
     public Template getPodTemplate() {
         return podTemplate;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("podTemplate")
     public void setPodTemplate(Template podTemplate) {
         this.podTemplate = podTemplate;
     }
 
+    /**
+     * Retries represents how many times this TaskRun should be retried in the event of task failure.
+     */
     @JsonProperty("retries")
     public Integer getRetries() {
         return retries;
     }
 
+    /**
+     * Retries represents how many times this TaskRun should be retried in the event of task failure.
+     */
     @JsonProperty("retries")
     public void setRetries(Integer retries) {
         this.retries = retries;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * Specs to apply to Sidecars in this TaskRun. If a field is specified in both a Sidecar and a SidecarSpec, the value from the SidecarSpec will be used. This field is only supported when the alpha feature gate is enabled.
+     */
     @JsonProperty("sidecarSpecs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TaskRunSidecarSpec> getSidecarSpecs() {
         return sidecarSpecs;
     }
 
+    /**
+     * Specs to apply to Sidecars in this TaskRun. If a field is specified in both a Sidecar and a SidecarSpec, the value from the SidecarSpec will be used. This field is only supported when the alpha feature gate is enabled.
+     */
     @JsonProperty("sidecarSpecs")
     public void setSidecarSpecs(List<TaskRunSidecarSpec> sidecarSpecs) {
         this.sidecarSpecs = sidecarSpecs;
     }
 
+    /**
+     * Used for cancelling a TaskRun (and maybe more later on)
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Used for cancelling a TaskRun (and maybe more later on)
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Status message for cancellation.
+     */
     @JsonProperty("statusMessage")
     public String getStatusMessage() {
         return statusMessage;
     }
 
+    /**
+     * Status message for cancellation.
+     */
     @JsonProperty("statusMessage")
     public void setStatusMessage(String statusMessage) {
         this.statusMessage = statusMessage;
     }
 
+    /**
+     * Specs to apply to Steps in this TaskRun. If a field is specified in both a Step and a StepSpec, the value from the StepSpec will be used. This field is only supported when the alpha feature gate is enabled.
+     */
     @JsonProperty("stepSpecs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TaskRunStepSpec> getStepSpecs() {
         return stepSpecs;
     }
 
+    /**
+     * Specs to apply to Steps in this TaskRun. If a field is specified in both a Step and a StepSpec, the value from the StepSpec will be used. This field is only supported when the alpha feature gate is enabled.
+     */
     @JsonProperty("stepSpecs")
     public void setStepSpecs(List<TaskRunStepSpec> stepSpecs) {
         this.stepSpecs = stepSpecs;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("taskRef")
     public TaskRef getTaskRef() {
         return taskRef;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("taskRef")
     public void setTaskRef(TaskRef taskRef) {
         this.taskRef = taskRef;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("taskSpec")
     public TaskSpec getTaskSpec() {
         return taskSpec;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("taskSpec")
     public void setTaskSpec(TaskSpec taskSpec) {
         this.taskSpec = taskSpec;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("timeout")
     public Duration getTimeout() {
         return timeout;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("timeout")
     public void setTimeout(Duration timeout) {
         this.timeout = timeout;
     }
 
+    /**
+     * Workspaces is a list of WorkspaceBindings from volumes to workspaces.
+     */
     @JsonProperty("workspaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WorkspaceBinding> getWorkspaces() {
         return workspaces;
     }
 
+    /**
+     * Workspaces is a list of WorkspaceBindings from volumes to workspaces.
+     */
     @JsonProperty("workspaces")
     public void setWorkspaces(List<WorkspaceBinding> workspaces) {
         this.workspaces = workspaces;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunStatus.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunStatus.java
index 4ac2d545340..1fb9c5b95e4 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunStatus.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskRunStatus defines the observed state of TaskRun
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -140,148 +143,232 @@ public TaskRunStatus(Map<String, String> annotations, Artifacts artifacts, Strin
         this.taskSpec = taskSpec;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * TaskRunStatus defines the observed state of TaskRun
+     */
     @JsonProperty("artifacts")
     public Artifacts getArtifacts() {
         return artifacts;
     }
 
+    /**
+     * TaskRunStatus defines the observed state of TaskRun
+     */
     @JsonProperty("artifacts")
     public void setArtifacts(Artifacts artifacts) {
         this.artifacts = artifacts;
     }
 
+    /**
+     * TaskRunStatus defines the observed state of TaskRun
+     */
     @JsonProperty("completionTime")
     public String getCompletionTime() {
         return completionTime;
     }
 
+    /**
+     * TaskRunStatus defines the observed state of TaskRun
+     */
     @JsonProperty("completionTime")
     public void setCompletionTime(String completionTime) {
         this.completionTime = completionTime;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * PodName is the name of the pod responsible for executing this task's steps.
+     */
     @JsonProperty("podName")
     public String getPodName() {
         return podName;
     }
 
+    /**
+     * PodName is the name of the pod responsible for executing this task's steps.
+     */
     @JsonProperty("podName")
     public void setPodName(String podName) {
         this.podName = podName;
     }
 
+    /**
+     * TaskRunStatus defines the observed state of TaskRun
+     */
     @JsonProperty("provenance")
     public Provenance getProvenance() {
         return provenance;
     }
 
+    /**
+     * TaskRunStatus defines the observed state of TaskRun
+     */
     @JsonProperty("provenance")
     public void setProvenance(Provenance provenance) {
         this.provenance = provenance;
     }
 
+    /**
+     * Results are the list of results written out by the task's containers
+     */
     @JsonProperty("results")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TaskRunResult> getResults() {
         return results;
     }
 
+    /**
+     * Results are the list of results written out by the task's containers
+     */
     @JsonProperty("results")
     public void setResults(List<TaskRunResult> results) {
         this.results = results;
     }
 
+    /**
+     * RetriesStatus contains the history of TaskRunStatus in case of a retry in order to keep record of failures. All TaskRunStatus stored in RetriesStatus will have no date within the RetriesStatus as is redundant.
+     */
     @JsonProperty("retriesStatus")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.v1.TaskRunStatus> getRetriesStatus() {
         return retriesStatus;
     }
 
+    /**
+     * RetriesStatus contains the history of TaskRunStatus in case of a retry in order to keep record of failures. All TaskRunStatus stored in RetriesStatus will have no date within the RetriesStatus as is redundant.
+     */
     @JsonProperty("retriesStatus")
     public void setRetriesStatus(List<io.fabric8.tekton.v1.TaskRunStatus> retriesStatus) {
         this.retriesStatus = retriesStatus;
     }
 
+    /**
+     * The list has one entry per sidecar in the manifest. Each entry is represents the imageid of the corresponding sidecar.
+     */
     @JsonProperty("sidecars")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SidecarState> getSidecars() {
         return sidecars;
     }
 
+    /**
+     * The list has one entry per sidecar in the manifest. Each entry is represents the imageid of the corresponding sidecar.
+     */
     @JsonProperty("sidecars")
     public void setSidecars(List<SidecarState> sidecars) {
         this.sidecars = sidecars;
     }
 
+    /**
+     * SpanContext contains tracing span context fields
+     */
     @JsonProperty("spanContext")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getSpanContext() {
         return spanContext;
     }
 
+    /**
+     * SpanContext contains tracing span context fields
+     */
     @JsonProperty("spanContext")
     public void setSpanContext(Map<String, String> spanContext) {
         this.spanContext = spanContext;
     }
 
+    /**
+     * TaskRunStatus defines the observed state of TaskRun
+     */
     @JsonProperty("startTime")
     public String getStartTime() {
         return startTime;
     }
 
+    /**
+     * TaskRunStatus defines the observed state of TaskRun
+     */
     @JsonProperty("startTime")
     public void setStartTime(String startTime) {
         this.startTime = startTime;
     }
 
+    /**
+     * Steps describes the state of each build step container.
+     */
     @JsonProperty("steps")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<StepState> getSteps() {
         return steps;
     }
 
+    /**
+     * Steps describes the state of each build step container.
+     */
     @JsonProperty("steps")
     public void setSteps(List<StepState> steps) {
         this.steps = steps;
     }
 
+    /**
+     * TaskRunStatus defines the observed state of TaskRun
+     */
     @JsonProperty("taskSpec")
     public TaskSpec getTaskSpec() {
         return taskSpec;
     }
 
+    /**
+     * TaskRunStatus defines the observed state of TaskRun
+     */
     @JsonProperty("taskSpec")
     public void setTaskSpec(TaskSpec taskSpec) {
         this.taskSpec = taskSpec;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunStatusFields.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunStatusFields.java
index 996cc0c0136..072969031ae 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunStatusFields.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunStatusFields.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskRunStatusFields holds the fields of TaskRun's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -125,116 +128,182 @@ public TaskRunStatusFields(Artifacts artifacts, String completionTime, String po
         this.taskSpec = taskSpec;
     }
 
+    /**
+     * TaskRunStatusFields holds the fields of TaskRun's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("artifacts")
     public Artifacts getArtifacts() {
         return artifacts;
     }
 
+    /**
+     * TaskRunStatusFields holds the fields of TaskRun's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("artifacts")
     public void setArtifacts(Artifacts artifacts) {
         this.artifacts = artifacts;
     }
 
+    /**
+     * TaskRunStatusFields holds the fields of TaskRun's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("completionTime")
     public String getCompletionTime() {
         return completionTime;
     }
 
+    /**
+     * TaskRunStatusFields holds the fields of TaskRun's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("completionTime")
     public void setCompletionTime(String completionTime) {
         this.completionTime = completionTime;
     }
 
+    /**
+     * PodName is the name of the pod responsible for executing this task's steps.
+     */
     @JsonProperty("podName")
     public String getPodName() {
         return podName;
     }
 
+    /**
+     * PodName is the name of the pod responsible for executing this task's steps.
+     */
     @JsonProperty("podName")
     public void setPodName(String podName) {
         this.podName = podName;
     }
 
+    /**
+     * TaskRunStatusFields holds the fields of TaskRun's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("provenance")
     public Provenance getProvenance() {
         return provenance;
     }
 
+    /**
+     * TaskRunStatusFields holds the fields of TaskRun's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("provenance")
     public void setProvenance(Provenance provenance) {
         this.provenance = provenance;
     }
 
+    /**
+     * Results are the list of results written out by the task's containers
+     */
     @JsonProperty("results")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TaskRunResult> getResults() {
         return results;
     }
 
+    /**
+     * Results are the list of results written out by the task's containers
+     */
     @JsonProperty("results")
     public void setResults(List<TaskRunResult> results) {
         this.results = results;
     }
 
+    /**
+     * RetriesStatus contains the history of TaskRunStatus in case of a retry in order to keep record of failures. All TaskRunStatus stored in RetriesStatus will have no date within the RetriesStatus as is redundant.
+     */
     @JsonProperty("retriesStatus")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TaskRunStatus> getRetriesStatus() {
         return retriesStatus;
     }
 
+    /**
+     * RetriesStatus contains the history of TaskRunStatus in case of a retry in order to keep record of failures. All TaskRunStatus stored in RetriesStatus will have no date within the RetriesStatus as is redundant.
+     */
     @JsonProperty("retriesStatus")
     public void setRetriesStatus(List<TaskRunStatus> retriesStatus) {
         this.retriesStatus = retriesStatus;
     }
 
+    /**
+     * The list has one entry per sidecar in the manifest. Each entry is represents the imageid of the corresponding sidecar.
+     */
     @JsonProperty("sidecars")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SidecarState> getSidecars() {
         return sidecars;
     }
 
+    /**
+     * The list has one entry per sidecar in the manifest. Each entry is represents the imageid of the corresponding sidecar.
+     */
     @JsonProperty("sidecars")
     public void setSidecars(List<SidecarState> sidecars) {
         this.sidecars = sidecars;
     }
 
+    /**
+     * SpanContext contains tracing span context fields
+     */
     @JsonProperty("spanContext")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getSpanContext() {
         return spanContext;
     }
 
+    /**
+     * SpanContext contains tracing span context fields
+     */
     @JsonProperty("spanContext")
     public void setSpanContext(Map<String, String> spanContext) {
         this.spanContext = spanContext;
     }
 
+    /**
+     * TaskRunStatusFields holds the fields of TaskRun's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("startTime")
     public String getStartTime() {
         return startTime;
     }
 
+    /**
+     * TaskRunStatusFields holds the fields of TaskRun's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("startTime")
     public void setStartTime(String startTime) {
         this.startTime = startTime;
     }
 
+    /**
+     * Steps describes the state of each build step container.
+     */
     @JsonProperty("steps")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<StepState> getSteps() {
         return steps;
     }
 
+    /**
+     * Steps describes the state of each build step container.
+     */
     @JsonProperty("steps")
     public void setSteps(List<StepState> steps) {
         this.steps = steps;
     }
 
+    /**
+     * TaskRunStatusFields holds the fields of TaskRun's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("taskSpec")
     public TaskSpec getTaskSpec() {
         return taskSpec;
     }
 
+    /**
+     * TaskRunStatusFields holds the fields of TaskRun's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("taskSpec")
     public void setTaskSpec(TaskSpec taskSpec) {
         this.taskSpec = taskSpec;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunStepSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunStepSpec.java
index 12719bb51e4..236c46c77a7 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunStepSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskRunStepSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskRunStepSpec is used to override the values of a Step in the corresponding Task.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public TaskRunStepSpec(ResourceRequirements computeResources, String name) {
         this.name = name;
     }
 
+    /**
+     * TaskRunStepSpec is used to override the values of a Step in the corresponding Task.
+     */
     @JsonProperty("computeResources")
     public ResourceRequirements getComputeResources() {
         return computeResources;
     }
 
+    /**
+     * TaskRunStepSpec is used to override the values of a Step in the corresponding Task.
+     */
     @JsonProperty("computeResources")
     public void setComputeResources(ResourceRequirements computeResources) {
         this.computeResources = computeResources;
     }
 
+    /**
+     * The name of the Step to override.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The name of the Step to override.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskSpec.java
index 59799432988..b8ba752afcb 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TaskSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskSpec defines the desired state of Task.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -118,97 +121,151 @@ public TaskSpec(String description, String displayName, List<ParamSpec> params,
         this.workspaces = workspaces;
     }
 
+    /**
+     * Description is a user-facing description of the task that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is a user-facing description of the task that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * DisplayName is a user-facing name of the task that may be used to populate a UI.
+     */
     @JsonProperty("displayName")
     public String getDisplayName() {
         return displayName;
     }
 
+    /**
+     * DisplayName is a user-facing name of the task that may be used to populate a UI.
+     */
     @JsonProperty("displayName")
     public void setDisplayName(String displayName) {
         this.displayName = displayName;
     }
 
+    /**
+     * Params is a list of input parameters required to run the task. Params must be supplied as inputs in TaskRuns unless they declare a default value.
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ParamSpec> getParams() {
         return params;
     }
 
+    /**
+     * Params is a list of input parameters required to run the task. Params must be supplied as inputs in TaskRuns unless they declare a default value.
+     */
     @JsonProperty("params")
     public void setParams(List<ParamSpec> params) {
         this.params = params;
     }
 
+    /**
+     * Results are values that this Task can output
+     */
     @JsonProperty("results")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TaskResult> getResults() {
         return results;
     }
 
+    /**
+     * Results are values that this Task can output
+     */
     @JsonProperty("results")
     public void setResults(List<TaskResult> results) {
         this.results = results;
     }
 
+    /**
+     * Sidecars are run alongside the Task's step containers. They begin before the steps start and end after the steps complete.
+     */
     @JsonProperty("sidecars")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Sidecar> getSidecars() {
         return sidecars;
     }
 
+    /**
+     * Sidecars are run alongside the Task's step containers. They begin before the steps start and end after the steps complete.
+     */
     @JsonProperty("sidecars")
     public void setSidecars(List<Sidecar> sidecars) {
         this.sidecars = sidecars;
     }
 
+    /**
+     * TaskSpec defines the desired state of Task.
+     */
     @JsonProperty("stepTemplate")
     public StepTemplate getStepTemplate() {
         return stepTemplate;
     }
 
+    /**
+     * TaskSpec defines the desired state of Task.
+     */
     @JsonProperty("stepTemplate")
     public void setStepTemplate(StepTemplate stepTemplate) {
         this.stepTemplate = stepTemplate;
     }
 
+    /**
+     * Steps are the steps of the build; each step is run sequentially with the source mounted into /workspace.
+     */
     @JsonProperty("steps")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Step> getSteps() {
         return steps;
     }
 
+    /**
+     * Steps are the steps of the build; each step is run sequentially with the source mounted into /workspace.
+     */
     @JsonProperty("steps")
     public void setSteps(List<Step> steps) {
         this.steps = steps;
     }
 
+    /**
+     * Volumes is a collection of volumes that are available to mount into the steps of the build.
+     */
     @JsonProperty("volumes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Volume> getVolumes() {
         return volumes;
     }
 
+    /**
+     * Volumes is a collection of volumes that are available to mount into the steps of the build.
+     */
     @JsonProperty("volumes")
     public void setVolumes(List<Volume> volumes) {
         this.volumes = volumes;
     }
 
+    /**
+     * Workspaces are the volumes that this Task requires.
+     */
     @JsonProperty("workspaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WorkspaceDeclaration> getWorkspaces() {
         return workspaces;
     }
 
+    /**
+     * Workspaces are the volumes that this Task requires.
+     */
     @JsonProperty("workspaces")
     public void setWorkspaces(List<WorkspaceDeclaration> workspaces) {
         this.workspaces = workspaces;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TimeoutFields.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TimeoutFields.java
index 3006d80c239..6d9f9d4d79e 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TimeoutFields.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/TimeoutFields.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TimeoutFields allows granular specification of pipeline, task, and finally timeouts
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,31 +90,49 @@ public TimeoutFields(Duration _finally, Duration pipeline, Duration tasks) {
         this.tasks = tasks;
     }
 
+    /**
+     * TimeoutFields allows granular specification of pipeline, task, and finally timeouts
+     */
     @JsonProperty("finally")
     public Duration getFinally() {
         return _finally;
     }
 
+    /**
+     * TimeoutFields allows granular specification of pipeline, task, and finally timeouts
+     */
     @JsonProperty("finally")
     public void setFinally(Duration _finally) {
         this._finally = _finally;
     }
 
+    /**
+     * TimeoutFields allows granular specification of pipeline, task, and finally timeouts
+     */
     @JsonProperty("pipeline")
     public Duration getPipeline() {
         return pipeline;
     }
 
+    /**
+     * TimeoutFields allows granular specification of pipeline, task, and finally timeouts
+     */
     @JsonProperty("pipeline")
     public void setPipeline(Duration pipeline) {
         this.pipeline = pipeline;
     }
 
+    /**
+     * TimeoutFields allows granular specification of pipeline, task, and finally timeouts
+     */
     @JsonProperty("tasks")
     public Duration getTasks() {
         return tasks;
     }
 
+    /**
+     * TimeoutFields allows granular specification of pipeline, task, and finally timeouts
+     */
     @JsonProperty("tasks")
     public void setTasks(Duration tasks) {
         this.tasks = tasks;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/WhenExpression.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/WhenExpression.java
index 7797d19476d..2626f1ff165 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/WhenExpression.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/WhenExpression.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WhenExpression allows a PipelineTask to declare expressions to be evaluated before the Task is run to determine whether the Task should be executed or skipped
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public WhenExpression(String cel, String input, String operator, List<String> va
         this.values = values;
     }
 
+    /**
+     * CEL is a string of Common Language Expression, which can be used to conditionally execute the task based on the result of the expression evaluation More info about CEL syntax: https://github.com/google/cel-spec/blob/master/doc/langdef.md
+     */
     @JsonProperty("cel")
     public String getCel() {
         return cel;
     }
 
+    /**
+     * CEL is a string of Common Language Expression, which can be used to conditionally execute the task based on the result of the expression evaluation More info about CEL syntax: https://github.com/google/cel-spec/blob/master/doc/langdef.md
+     */
     @JsonProperty("cel")
     public void setCel(String cel) {
         this.cel = cel;
     }
 
+    /**
+     * Input is the string for guard checking which can be a static input or an output from a parent Task
+     */
     @JsonProperty("input")
     public String getInput() {
         return input;
     }
 
+    /**
+     * Input is the string for guard checking which can be a static input or an output from a parent Task
+     */
     @JsonProperty("input")
     public void setInput(String input) {
         this.input = input;
     }
 
+    /**
+     * Operator that represents an Input's relationship to the values
+     */
     @JsonProperty("operator")
     public String getOperator() {
         return operator;
     }
 
+    /**
+     * Operator that represents an Input's relationship to the values
+     */
     @JsonProperty("operator")
     public void setOperator(String operator) {
         this.operator = operator;
     }
 
+    /**
+     * Values is an array of strings, which is compared against the input, for guard checking It must be non-empty
+     */
     @JsonProperty("values")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getValues() {
         return values;
     }
 
+    /**
+     * Values is an array of strings, which is compared against the input, for guard checking It must be non-empty
+     */
     @JsonProperty("values")
     public void setValues(List<String> values) {
         this.values = values;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/WorkspaceBinding.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/WorkspaceBinding.java
index 75eb642895e..13a3a9d371f 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/WorkspaceBinding.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/WorkspaceBinding.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WorkspaceBinding maps a Task's declared workspace to a Volume.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -116,91 +119,145 @@ public WorkspaceBinding(ConfigMapVolumeSource configMap, CSIVolumeSource csi, Em
         this.volumeClaimTemplate = volumeClaimTemplate;
     }
 
+    /**
+     * WorkspaceBinding maps a Task's declared workspace to a Volume.
+     */
     @JsonProperty("configMap")
     public ConfigMapVolumeSource getConfigMap() {
         return configMap;
     }
 
+    /**
+     * WorkspaceBinding maps a Task's declared workspace to a Volume.
+     */
     @JsonProperty("configMap")
     public void setConfigMap(ConfigMapVolumeSource configMap) {
         this.configMap = configMap;
     }
 
+    /**
+     * WorkspaceBinding maps a Task's declared workspace to a Volume.
+     */
     @JsonProperty("csi")
     public CSIVolumeSource getCsi() {
         return csi;
     }
 
+    /**
+     * WorkspaceBinding maps a Task's declared workspace to a Volume.
+     */
     @JsonProperty("csi")
     public void setCsi(CSIVolumeSource csi) {
         this.csi = csi;
     }
 
+    /**
+     * WorkspaceBinding maps a Task's declared workspace to a Volume.
+     */
     @JsonProperty("emptyDir")
     public EmptyDirVolumeSource getEmptyDir() {
         return emptyDir;
     }
 
+    /**
+     * WorkspaceBinding maps a Task's declared workspace to a Volume.
+     */
     @JsonProperty("emptyDir")
     public void setEmptyDir(EmptyDirVolumeSource emptyDir) {
         this.emptyDir = emptyDir;
     }
 
+    /**
+     * Name is the name of the workspace populated by the volume.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the workspace populated by the volume.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * WorkspaceBinding maps a Task's declared workspace to a Volume.
+     */
     @JsonProperty("persistentVolumeClaim")
     public PersistentVolumeClaimVolumeSource getPersistentVolumeClaim() {
         return persistentVolumeClaim;
     }
 
+    /**
+     * WorkspaceBinding maps a Task's declared workspace to a Volume.
+     */
     @JsonProperty("persistentVolumeClaim")
     public void setPersistentVolumeClaim(PersistentVolumeClaimVolumeSource persistentVolumeClaim) {
         this.persistentVolumeClaim = persistentVolumeClaim;
     }
 
+    /**
+     * WorkspaceBinding maps a Task's declared workspace to a Volume.
+     */
     @JsonProperty("projected")
     public ProjectedVolumeSource getProjected() {
         return projected;
     }
 
+    /**
+     * WorkspaceBinding maps a Task's declared workspace to a Volume.
+     */
     @JsonProperty("projected")
     public void setProjected(ProjectedVolumeSource projected) {
         this.projected = projected;
     }
 
+    /**
+     * WorkspaceBinding maps a Task's declared workspace to a Volume.
+     */
     @JsonProperty("secret")
     public SecretVolumeSource getSecret() {
         return secret;
     }
 
+    /**
+     * WorkspaceBinding maps a Task's declared workspace to a Volume.
+     */
     @JsonProperty("secret")
     public void setSecret(SecretVolumeSource secret) {
         this.secret = secret;
     }
 
+    /**
+     * SubPath is optionally a directory on the volume which should be used for this binding (i.e. the volume will be mounted at this sub directory).
+     */
     @JsonProperty("subPath")
     public String getSubPath() {
         return subPath;
     }
 
+    /**
+     * SubPath is optionally a directory on the volume which should be used for this binding (i.e. the volume will be mounted at this sub directory).
+     */
     @JsonProperty("subPath")
     public void setSubPath(String subPath) {
         this.subPath = subPath;
     }
 
+    /**
+     * WorkspaceBinding maps a Task's declared workspace to a Volume.
+     */
     @JsonProperty("volumeClaimTemplate")
     public PersistentVolumeClaim getVolumeClaimTemplate() {
         return volumeClaimTemplate;
     }
 
+    /**
+     * WorkspaceBinding maps a Task's declared workspace to a Volume.
+     */
     @JsonProperty("volumeClaimTemplate")
     public void setVolumeClaimTemplate(PersistentVolumeClaim volumeClaimTemplate) {
         this.volumeClaimTemplate = volumeClaimTemplate;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/WorkspaceDeclaration.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/WorkspaceDeclaration.java
index 0a28bc94dac..d463eb8e707 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/WorkspaceDeclaration.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/WorkspaceDeclaration.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WorkspaceDeclaration is a declaration of a volume that a Task requires.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public WorkspaceDeclaration(String description, String mountPath, String name, B
         this.readOnly = readOnly;
     }
 
+    /**
+     * Description is an optional human readable description of this volume.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is an optional human readable description of this volume.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * MountPath overrides the directory that the volume will be made available at.
+     */
     @JsonProperty("mountPath")
     public String getMountPath() {
         return mountPath;
     }
 
+    /**
+     * MountPath overrides the directory that the volume will be made available at.
+     */
     @JsonProperty("mountPath")
     public void setMountPath(String mountPath) {
         this.mountPath = mountPath;
     }
 
+    /**
+     * Name is the name by which you can bind the volume at runtime.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name by which you can bind the volume at runtime.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Optional marks a Workspace as not being required in TaskRuns. By default this field is false and so declared workspaces are required.
+     */
     @JsonProperty("optional")
     public Boolean getOptional() {
         return optional;
     }
 
+    /**
+     * Optional marks a Workspace as not being required in TaskRuns. By default this field is false and so declared workspaces are required.
+     */
     @JsonProperty("optional")
     public void setOptional(Boolean optional) {
         this.optional = optional;
     }
 
+    /**
+     * ReadOnly dictates whether a mounted volume is writable. By default this field is false and so mounted volumes are writable.
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * ReadOnly dictates whether a mounted volume is writable. By default this field is false and so mounted volumes are writable.
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/WorkspacePipelineTaskBinding.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/WorkspacePipelineTaskBinding.java
index 6eaf97b120c..34fcf991047 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/WorkspacePipelineTaskBinding.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/WorkspacePipelineTaskBinding.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WorkspacePipelineTaskBinding describes how a workspace passed into the pipeline should be mapped to a task's declared workspace.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public WorkspacePipelineTaskBinding(String name, String subPath, String workspac
         this.workspace = workspace;
     }
 
+    /**
+     * Name is the name of the workspace as declared by the task
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the workspace as declared by the task
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * SubPath is optionally a directory on the volume which should be used for this binding (i.e. the volume will be mounted at this sub directory).
+     */
     @JsonProperty("subPath")
     public String getSubPath() {
         return subPath;
     }
 
+    /**
+     * SubPath is optionally a directory on the volume which should be used for this binding (i.e. the volume will be mounted at this sub directory).
+     */
     @JsonProperty("subPath")
     public void setSubPath(String subPath) {
         this.subPath = subPath;
     }
 
+    /**
+     * Workspace is the name of the workspace declared by the pipeline
+     */
     @JsonProperty("workspace")
     public String getWorkspace() {
         return workspace;
     }
 
+    /**
+     * Workspace is the name of the workspace declared by the pipeline
+     */
     @JsonProperty("workspace")
     public void setWorkspace(String workspace) {
         this.workspace = workspace;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/WorkspaceUsage.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/WorkspaceUsage.java
index 7ef05208acb..1a804ee881c 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/WorkspaceUsage.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1/WorkspaceUsage.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WorkspaceUsage is used by a Step or Sidecar to declare that it wants isolated access to a Workspace defined in a Task.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public WorkspaceUsage(String mountPath, String name) {
         this.name = name;
     }
 
+    /**
+     * MountPath is the path that the workspace should be mounted to inside the Step or Sidecar, overriding any MountPath specified in the Task's WorkspaceDeclaration.
+     */
     @JsonProperty("mountPath")
     public String getMountPath() {
         return mountPath;
     }
 
+    /**
+     * MountPath is the path that the workspace should be mounted to inside the Step or Sidecar, overriding any MountPath specified in the Task's WorkspaceDeclaration.
+     */
     @JsonProperty("mountPath")
     public void setMountPath(String mountPath) {
         this.mountPath = mountPath;
     }
 
+    /**
+     * Name is the name of the workspace this Step or Sidecar wants access to.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the workspace this Step or Sidecar wants access to.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/Authority.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/Authority.java
index f3cde752fa6..a3201071672 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/Authority.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/Authority.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * The Authority block defines the keys for validating signatures.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Authority(KeyRef key, String name) {
         this.name = name;
     }
 
+    /**
+     * The Authority block defines the keys for validating signatures.
+     */
     @JsonProperty("key")
     public KeyRef getKey() {
         return key;
     }
 
+    /**
+     * The Authority block defines the keys for validating signatures.
+     */
     @JsonProperty("key")
     public void setKey(KeyRef key) {
         this.key = key;
     }
 
+    /**
+     * Name is the name for this authority.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name for this authority.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/EmbeddedRunSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/EmbeddedRunSpec.java
index fe63e861ea4..805c7828992 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/EmbeddedRunSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/EmbeddedRunSpec.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EmbeddedRunSpec allows custom task definitions to be embedded
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -92,41 +95,65 @@ public EmbeddedRunSpec(String apiVersion, String kind, PipelineTaskMetadata meta
         this.spec = spec;
     }
 
+    /**
+     * EmbeddedRunSpec allows custom task definitions to be embedded
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * EmbeddedRunSpec allows custom task definitions to be embedded
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * EmbeddedRunSpec allows custom task definitions to be embedded
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * EmbeddedRunSpec allows custom task definitions to be embedded
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EmbeddedRunSpec allows custom task definitions to be embedded
+     */
     @JsonProperty("metadata")
     public PipelineTaskMetadata getMetadata() {
         return metadata;
     }
 
+    /**
+     * EmbeddedRunSpec allows custom task definitions to be embedded
+     */
     @JsonProperty("metadata")
     public void setMetadata(PipelineTaskMetadata metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * EmbeddedRunSpec allows custom task definitions to be embedded
+     */
     @JsonProperty("spec")
     public Object getSpec() {
         return spec;
     }
 
+    /**
+     * EmbeddedRunSpec allows custom task definitions to be embedded
+     */
     @JsonProperty("spec")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setSpec(Object spec) {
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/KeyRef.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/KeyRef.java
index c03de287881..85d607652ac 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/KeyRef.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/KeyRef.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KeyRef defines the reference to a public key
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,41 +94,65 @@ public KeyRef(String data, String hashAlgorithm, String kms, SecretReference sec
         this.secretRef = secretRef;
     }
 
+    /**
+     * Data contains the inline public key.
+     */
     @JsonProperty("data")
     public String getData() {
         return data;
     }
 
+    /**
+     * Data contains the inline public key.
+     */
     @JsonProperty("data")
     public void setData(String data) {
         this.data = data;
     }
 
+    /**
+     * HashAlgorithm always defaults to sha256 if the algorithm hasn't been explicitly set
+     */
     @JsonProperty("hashAlgorithm")
     public String getHashAlgorithm() {
         return hashAlgorithm;
     }
 
+    /**
+     * HashAlgorithm always defaults to sha256 if the algorithm hasn't been explicitly set
+     */
     @JsonProperty("hashAlgorithm")
     public void setHashAlgorithm(String hashAlgorithm) {
         this.hashAlgorithm = hashAlgorithm;
     }
 
+    /**
+     * KMS contains the KMS url of the public key Supported formats differ based on the KMS system used. One example of a KMS url could be: gcpkms://projects/[PROJECT]/locations/[LOCATION]&gt;/keyRings/[KEYRING]/cryptoKeys/[KEY]/cryptoKeyVersions/[KEY_VERSION] For more examples please refer https://docs.sigstore.dev/cosign/kms_support. Note that the KMS is not supported yet.
+     */
     @JsonProperty("kms")
     public String getKms() {
         return kms;
     }
 
+    /**
+     * KMS contains the KMS url of the public key Supported formats differ based on the KMS system used. One example of a KMS url could be: gcpkms://projects/[PROJECT]/locations/[LOCATION]&gt;/keyRings/[KEYRING]/cryptoKeys/[KEY]/cryptoKeyVersions/[KEY_VERSION] For more examples please refer https://docs.sigstore.dev/cosign/kms_support. Note that the KMS is not supported yet.
+     */
     @JsonProperty("kms")
     public void setKms(String kms) {
         this.kms = kms;
     }
 
+    /**
+     * KeyRef defines the reference to a public key
+     */
     @JsonProperty("secretRef")
     public SecretReference getSecretRef() {
         return secretRef;
     }
 
+    /**
+     * KeyRef defines the reference to a public key
+     */
     @JsonProperty("secretRef")
     public void setSecretRef(SecretReference secretRef) {
         this.secretRef = secretRef;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/PipelineResource.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/PipelineResource.java
index e27625a5370..d1039eb3b2c 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/PipelineResource.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/PipelineResource.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineResource describes a resource that is an input to or output from a Task.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class PipelineResource implements Editable<PipelineResourceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PipelineResource";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PipelineResource(String apiVersion, String kind, ObjectMeta metadata, Pip
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PipelineResource describes a resource that is an input to or output from a Task.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PipelineResource describes a resource that is an input to or output from a Task.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PipelineResource describes a resource that is an input to or output from a Task.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("spec")
     public PipelineResourceSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PipelineResource describes a resource that is an input to or output from a Task.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("spec")
     public void setSpec(PipelineResourceSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PipelineResource describes a resource that is an input to or output from a Task.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("status")
     public PipelineResourceStatus getStatus() {
         return status;
     }
 
+    /**
+     * PipelineResource describes a resource that is an input to or output from a Task.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("status")
     public void setStatus(PipelineResourceStatus status) {
         this.status = status;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/PipelineResourceList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/PipelineResourceList.java
index c44fe53da28..3186f3b9e69 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/PipelineResourceList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/PipelineResourceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineResourceList contains a list of PipelineResources<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PipelineResourceList implements Editable<PipelineResourceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.v1alpha1.PipelineResource>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.v1alpha1.PipelineResource> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PipelineResourceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PipelineResourceList(String apiVersion, List<io.fabric8.tekton.v1alpha1.P
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PipelineResourceList contains a list of PipelineResources<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.v1alpha1.PipelineResource> getItems() {
         return items;
     }
 
+    /**
+     * PipelineResourceList contains a list of PipelineResources<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.v1alpha1.PipelineResource> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PipelineResourceList contains a list of PipelineResources<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PipelineResourceList contains a list of PipelineResources<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/PipelineResourceSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/PipelineResourceSpec.java
index b7f2b07391f..a292ac75c93 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/PipelineResourceSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/PipelineResourceSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineResourceSpec defines an individual resources used in the pipeline.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,43 +97,67 @@ public PipelineResourceSpec(String description, List<ResourceParam> params, List
         this.type = type;
     }
 
+    /**
+     * Description is a user-facing description of the resource that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is a user-facing description of the resource that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * PipelineResourceSpec defines an individual resources used in the pipeline.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ResourceParam> getParams() {
         return params;
     }
 
+    /**
+     * PipelineResourceSpec defines an individual resources used in the pipeline.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("params")
     public void setParams(List<ResourceParam> params) {
         this.params = params;
     }
 
+    /**
+     * Secrets to fetch to populate some of resource fields
+     */
     @JsonProperty("secrets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SecretParam> getSecrets() {
         return secrets;
     }
 
+    /**
+     * Secrets to fetch to populate some of resource fields
+     */
     @JsonProperty("secrets")
     public void setSecrets(List<SecretParam> secrets) {
         this.secrets = secrets;
     }
 
+    /**
+     * PipelineResourceSpec defines an individual resources used in the pipeline.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * PipelineResourceSpec defines an individual resources used in the pipeline.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/PipelineResourceStatus.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/PipelineResourceStatus.java
index de34eb81b66..9458c4c0958 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/PipelineResourceStatus.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/PipelineResourceStatus.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineResourceStatus does not contain anything because PipelineResources on their own do not have a status<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/ResourceDeclaration.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/ResourceDeclaration.java
index 8af8589da9b..1663015c0ac 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/ResourceDeclaration.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/ResourceDeclaration.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceDeclaration defines an input or output PipelineResource declared as a requirement by another type such as a Task or Condition. The Name field will be used to refer to these PipelineResources within the type's definition, and when provided as an Input, the Name will be the path to the volume mounted containing this PipelineResource as an input (e.g. an input Resource named `workspace` will be mounted at `/workspace`).<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public ResourceDeclaration(String description, String name, Boolean optional, St
         this.type = type;
     }
 
+    /**
+     * Description is a user-facing description of the declared resource that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is a user-facing description of the declared resource that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * Name declares the name by which a resource is referenced in the definition. Resources may be referenced by name in the definition of a Task's steps.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name declares the name by which a resource is referenced in the definition. Resources may be referenced by name in the definition of a Task's steps.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Optional declares the resource as optional. By default optional is set to false which makes a resource required. optional: true - the resource is considered optional optional: false - the resource is considered required (equivalent of not specifying it)
+     */
     @JsonProperty("optional")
     public Boolean getOptional() {
         return optional;
     }
 
+    /**
+     * Optional declares the resource as optional. By default optional is set to false which makes a resource required. optional: true - the resource is considered optional optional: false - the resource is considered required (equivalent of not specifying it)
+     */
     @JsonProperty("optional")
     public void setOptional(Boolean optional) {
         this.optional = optional;
     }
 
+    /**
+     * TargetPath is the path in workspace directory where the resource will be copied.
+     */
     @JsonProperty("targetPath")
     public String getTargetPath() {
         return targetPath;
     }
 
+    /**
+     * TargetPath is the path in workspace directory where the resource will be copied.
+     */
     @JsonProperty("targetPath")
     public void setTargetPath(String targetPath) {
         this.targetPath = targetPath;
     }
 
+    /**
+     * Type is the type of this resource;
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of this resource;
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/ResourceParam.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/ResourceParam.java
index 7468986e340..ec3864ba39c 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/ResourceParam.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/ResourceParam.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceParam declares a string value to use for the parameter called Name, and is used in the specific context of PipelineResources.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ResourceParam(String name, String value) {
         this.value = value;
     }
 
+    /**
+     * ResourceParam declares a string value to use for the parameter called Name, and is used in the specific context of PipelineResources.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * ResourceParam declares a string value to use for the parameter called Name, and is used in the specific context of PipelineResources.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * ResourceParam declares a string value to use for the parameter called Name, and is used in the specific context of PipelineResources.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * ResourceParam declares a string value to use for the parameter called Name, and is used in the specific context of PipelineResources.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/ResourcePattern.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/ResourcePattern.java
index c7a7a0f8679..0e717a7a068 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/ResourcePattern.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/ResourcePattern.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourcePattern defines the pattern of the resource source
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ResourcePattern(String pattern) {
         this.pattern = pattern;
     }
 
+    /**
+     * Pattern defines a resource pattern. Regex is created to filter resources based on `Pattern` Example patterns: GitHub resource: https://github.com/tektoncd/catalog.git, https://github.com/tektoncd/&#42; Bundle resource: gcr.io/tekton-releases/catalog/upstream/git-clone, gcr.io/tekton-releases/catalog/upstream/&#42; Hub resource: https://artifacthub.io/&#42;,
+     */
     @JsonProperty("pattern")
     public String getPattern() {
         return pattern;
     }
 
+    /**
+     * Pattern defines a resource pattern. Regex is created to filter resources based on `Pattern` Example patterns: GitHub resource: https://github.com/tektoncd/catalog.git, https://github.com/tektoncd/&#42; Bundle resource: gcr.io/tekton-releases/catalog/upstream/git-clone, gcr.io/tekton-releases/catalog/upstream/&#42; Hub resource: https://artifacthub.io/&#42;,
+     */
     @JsonProperty("pattern")
     public void setPattern(String pattern) {
         this.pattern = pattern;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/Run.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/Run.java
index 5b03add6d54..32adebfff5f 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/Run.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/Run.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Run represents a single execution of a Custom Task.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Run implements Editable<RunBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Run";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Run(String apiVersion, String kind, ObjectMeta metadata, RunSpec spec, Ru
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Run represents a single execution of a Custom Task.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Run represents a single execution of a Custom Task.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Run represents a single execution of a Custom Task.
+     */
     @JsonProperty("spec")
     public RunSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Run represents a single execution of a Custom Task.
+     */
     @JsonProperty("spec")
     public void setSpec(RunSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Run represents a single execution of a Custom Task.
+     */
     @JsonProperty("status")
     public RunStatus getStatus() {
         return status;
     }
 
+    /**
+     * Run represents a single execution of a Custom Task.
+     */
     @JsonProperty("status")
     public void setStatus(RunStatus status) {
         this.status = status;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/RunList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/RunList.java
index 2c7a91460b4..8e9d1c7a2bb 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/RunList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/RunList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RunList contains a list of Run
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class RunList implements Editable<RunListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.v1alpha1.Run>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.v1alpha1.Run> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "RunList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public RunList(String apiVersion, List<io.fabric8.tekton.v1alpha1.Run> items, St
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * RunList contains a list of Run
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.v1alpha1.Run> getItems() {
         return items;
     }
 
+    /**
+     * RunList contains a list of Run
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.v1alpha1.Run> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RunList contains a list of Run
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RunList contains a list of Run
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/RunResult.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/RunResult.java
index 29522cb30c1..3b46c2d5577 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/RunResult.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/RunResult.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RunResult used to describe the results of a task
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public RunResult(String name, String value) {
         this.value = value;
     }
 
+    /**
+     * Name the given name
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name the given name
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Value the given value of the result
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value the given value of the result
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/RunSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/RunSpec.java
index 1fd0bb0bac9..9d62488aa9f 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/RunSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/RunSpec.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RunSpec defines the desired state of Run
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -123,103 +126,163 @@ public RunSpec(List<Param> params, Template podTemplate, TaskRef ref, Integer re
         this.workspaces = workspaces;
     }
 
+    /**
+     * RunSpec defines the desired state of Run
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Param> getParams() {
         return params;
     }
 
+    /**
+     * RunSpec defines the desired state of Run
+     */
     @JsonProperty("params")
     public void setParams(List<Param> params) {
         this.params = params;
     }
 
+    /**
+     * RunSpec defines the desired state of Run
+     */
     @JsonProperty("podTemplate")
     public Template getPodTemplate() {
         return podTemplate;
     }
 
+    /**
+     * RunSpec defines the desired state of Run
+     */
     @JsonProperty("podTemplate")
     public void setPodTemplate(Template podTemplate) {
         this.podTemplate = podTemplate;
     }
 
+    /**
+     * RunSpec defines the desired state of Run
+     */
     @JsonProperty("ref")
     public TaskRef getRef() {
         return ref;
     }
 
+    /**
+     * RunSpec defines the desired state of Run
+     */
     @JsonProperty("ref")
     public void setRef(TaskRef ref) {
         this.ref = ref;
     }
 
+    /**
+     * Used for propagating retries count to custom tasks
+     */
     @JsonProperty("retries")
     public Integer getRetries() {
         return retries;
     }
 
+    /**
+     * Used for propagating retries count to custom tasks
+     */
     @JsonProperty("retries")
     public void setRetries(Integer retries) {
         this.retries = retries;
     }
 
+    /**
+     * RunSpec defines the desired state of Run
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * RunSpec defines the desired state of Run
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * RunSpec defines the desired state of Run
+     */
     @JsonProperty("spec")
     public EmbeddedRunSpec getSpec() {
         return spec;
     }
 
+    /**
+     * RunSpec defines the desired state of Run
+     */
     @JsonProperty("spec")
     public void setSpec(EmbeddedRunSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Used for cancelling a run (and maybe more later on)
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Used for cancelling a run (and maybe more later on)
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Status message for cancellation.
+     */
     @JsonProperty("statusMessage")
     public String getStatusMessage() {
         return statusMessage;
     }
 
+    /**
+     * Status message for cancellation.
+     */
     @JsonProperty("statusMessage")
     public void setStatusMessage(String statusMessage) {
         this.statusMessage = statusMessage;
     }
 
+    /**
+     * RunSpec defines the desired state of Run
+     */
     @JsonProperty("timeout")
     public Duration getTimeout() {
         return timeout;
     }
 
+    /**
+     * RunSpec defines the desired state of Run
+     */
     @JsonProperty("timeout")
     public void setTimeout(Duration timeout) {
         this.timeout = timeout;
     }
 
+    /**
+     * Workspaces is a list of WorkspaceBindings from volumes to workspaces.
+     */
     @JsonProperty("workspaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WorkspaceBinding> getWorkspaces() {
         return workspaces;
     }
 
+    /**
+     * Workspaces is a list of WorkspaceBindings from volumes to workspaces.
+     */
     @JsonProperty("workspaces")
     public void setWorkspaces(List<WorkspaceBinding> workspaces) {
         this.workspaces = workspaces;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/RunStatus.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/RunStatus.java
index 3d2407299f8..238a342fc96 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/RunStatus.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/RunStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RunStatus defines the observed state of Run.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -114,86 +117,134 @@ public RunStatus(Map<String, String> annotations, String completionTime, List<Co
         this.startTime = startTime;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * RunStatus defines the observed state of Run.
+     */
     @JsonProperty("completionTime")
     public String getCompletionTime() {
         return completionTime;
     }
 
+    /**
+     * RunStatus defines the observed state of Run.
+     */
     @JsonProperty("completionTime")
     public void setCompletionTime(String completionTime) {
         this.completionTime = completionTime;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * RunStatus defines the observed state of Run.
+     */
     @JsonProperty("extraFields")
     public Object getExtraFields() {
         return extraFields;
     }
 
+    /**
+     * RunStatus defines the observed state of Run.
+     */
     @JsonProperty("extraFields")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setExtraFields(Object extraFields) {
         this.extraFields = extraFields;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Results reports any output result values to be consumed by later tasks in a pipeline.
+     */
     @JsonProperty("results")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RunResult> getResults() {
         return results;
     }
 
+    /**
+     * Results reports any output result values to be consumed by later tasks in a pipeline.
+     */
     @JsonProperty("results")
     public void setResults(List<RunResult> results) {
         this.results = results;
     }
 
+    /**
+     * RetriesStatus contains the history of RunStatus, in case of a retry.
+     */
     @JsonProperty("retriesStatus")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.v1alpha1.RunStatus> getRetriesStatus() {
         return retriesStatus;
     }
 
+    /**
+     * RetriesStatus contains the history of RunStatus, in case of a retry.
+     */
     @JsonProperty("retriesStatus")
     public void setRetriesStatus(List<io.fabric8.tekton.v1alpha1.RunStatus> retriesStatus) {
         this.retriesStatus = retriesStatus;
     }
 
+    /**
+     * RunStatus defines the observed state of Run.
+     */
     @JsonProperty("startTime")
     public String getStartTime() {
         return startTime;
     }
 
+    /**
+     * RunStatus defines the observed state of Run.
+     */
     @JsonProperty("startTime")
     public void setStartTime(String startTime) {
         this.startTime = startTime;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/RunStatusFields.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/RunStatusFields.java
index 4571fae0ed1..55c167feaed 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/RunStatusFields.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/RunStatusFields.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RunStatusFields holds the fields of Run's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -99,54 +102,84 @@ public RunStatusFields(String completionTime, Object extraFields, List<RunResult
         this.startTime = startTime;
     }
 
+    /**
+     * RunStatusFields holds the fields of Run's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("completionTime")
     public String getCompletionTime() {
         return completionTime;
     }
 
+    /**
+     * RunStatusFields holds the fields of Run's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("completionTime")
     public void setCompletionTime(String completionTime) {
         this.completionTime = completionTime;
     }
 
+    /**
+     * RunStatusFields holds the fields of Run's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("extraFields")
     public Object getExtraFields() {
         return extraFields;
     }
 
+    /**
+     * RunStatusFields holds the fields of Run's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("extraFields")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setExtraFields(Object extraFields) {
         this.extraFields = extraFields;
     }
 
+    /**
+     * Results reports any output result values to be consumed by later tasks in a pipeline.
+     */
     @JsonProperty("results")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RunResult> getResults() {
         return results;
     }
 
+    /**
+     * Results reports any output result values to be consumed by later tasks in a pipeline.
+     */
     @JsonProperty("results")
     public void setResults(List<RunResult> results) {
         this.results = results;
     }
 
+    /**
+     * RetriesStatus contains the history of RunStatus, in case of a retry.
+     */
     @JsonProperty("retriesStatus")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RunStatus> getRetriesStatus() {
         return retriesStatus;
     }
 
+    /**
+     * RetriesStatus contains the history of RunStatus, in case of a retry.
+     */
     @JsonProperty("retriesStatus")
     public void setRetriesStatus(List<RunStatus> retriesStatus) {
         this.retriesStatus = retriesStatus;
     }
 
+    /**
+     * RunStatusFields holds the fields of Run's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("startTime")
     public String getStartTime() {
         return startTime;
     }
 
+    /**
+     * RunStatusFields holds the fields of Run's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("startTime")
     public void setStartTime(String startTime) {
         this.startTime = startTime;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/SecretParam.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/SecretParam.java
index 2c175d5e3da..493bdacaf80 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/SecretParam.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/SecretParam.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SecretParam indicates which secret can be used to populate a field of the resource<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public SecretParam(String fieldName, String secretKey, String secretName) {
         this.secretName = secretName;
     }
 
+    /**
+     * SecretParam indicates which secret can be used to populate a field of the resource<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("fieldName")
     public String getFieldName() {
         return fieldName;
     }
 
+    /**
+     * SecretParam indicates which secret can be used to populate a field of the resource<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("fieldName")
     public void setFieldName(String fieldName) {
         this.fieldName = fieldName;
     }
 
+    /**
+     * SecretParam indicates which secret can be used to populate a field of the resource<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("secretKey")
     public String getSecretKey() {
         return secretKey;
     }
 
+    /**
+     * SecretParam indicates which secret can be used to populate a field of the resource<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("secretKey")
     public void setSecretKey(String secretKey) {
         this.secretKey = secretKey;
     }
 
+    /**
+     * SecretParam indicates which secret can be used to populate a field of the resource<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("secretName")
     public String getSecretName() {
         return secretName;
     }
 
+    /**
+     * SecretParam indicates which secret can be used to populate a field of the resource<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("secretName")
     public void setSecretName(String secretName) {
         this.secretName = secretName;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/StepAction.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/StepAction.java
index 00646bc3b2f..12735869829 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/StepAction.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/StepAction.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StepAction represents the actionable components of Step. The Step can only reference it from the cluster or using remote resolution.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class StepAction implements Editable<StepActionBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "StepAction";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public StepAction(String apiVersion, String kind, ObjectMeta metadata, StepActio
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * StepAction represents the actionable components of Step. The Step can only reference it from the cluster or using remote resolution.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * StepAction represents the actionable components of Step. The Step can only reference it from the cluster or using remote resolution.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * StepAction represents the actionable components of Step. The Step can only reference it from the cluster or using remote resolution.
+     */
     @JsonProperty("spec")
     public StepActionSpec getSpec() {
         return spec;
     }
 
+    /**
+     * StepAction represents the actionable components of Step. The Step can only reference it from the cluster or using remote resolution.
+     */
     @JsonProperty("spec")
     public void setSpec(StepActionSpec spec) {
         this.spec = spec;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/StepActionList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/StepActionList.java
index a77efc02d74..6beea8d703e 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/StepActionList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/StepActionList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StepActionList contains a list of StepActions
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class StepActionList implements Editable<StepActionListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.v1alpha1.StepAction>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.v1alpha1.StepAction> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "StepActionList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public StepActionList(String apiVersion, List<io.fabric8.tekton.v1alpha1.StepAct
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * StepActionList contains a list of StepActions
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.v1alpha1.StepAction> getItems() {
         return items;
     }
 
+    /**
+     * StepActionList contains a list of StepActions
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.v1alpha1.StepAction> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * StepActionList contains a list of StepActions
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * StepActionList contains a list of StepActions
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/StepActionSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/StepActionSpec.java
index 511b94a77a8..bd9c088e0b2 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/StepActionSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/StepActionSpec.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StepActionSpec contains the actionable components of a step.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -129,117 +132,183 @@ public StepActionSpec(List<String> args, List<String> command, String descriptio
         this.workingDir = workingDir;
     }
 
+    /**
+     * Arguments to the entrypoint. The image's CMD is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("args")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getArgs() {
         return args;
     }
 
+    /**
+     * Arguments to the entrypoint. The image's CMD is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("args")
     public void setArgs(List<String> args) {
         this.args = args;
     }
 
+    /**
+     * Entrypoint array. Not executed within a shell. The image's ENTRYPOINT is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("command")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCommand() {
         return command;
     }
 
+    /**
+     * Entrypoint array. Not executed within a shell. The image's ENTRYPOINT is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("command")
     public void setCommand(List<String> command) {
         this.command = command;
     }
 
+    /**
+     * Description is a user-facing description of the stepaction that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is a user-facing description of the stepaction that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * List of environment variables to set in the container. Cannot be updated.
+     */
     @JsonProperty("env")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvVar> getEnv() {
         return env;
     }
 
+    /**
+     * List of environment variables to set in the container. Cannot be updated.
+     */
     @JsonProperty("env")
     public void setEnv(List<EnvVar> env) {
         this.env = env;
     }
 
+    /**
+     * Image reference name to run for this StepAction. More info: https://kubernetes.io/docs/concepts/containers/images
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * Image reference name to run for this StepAction. More info: https://kubernetes.io/docs/concepts/containers/images
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
     }
 
+    /**
+     * Params is a list of input parameters required to run the stepAction. Params must be supplied as inputs in Steps unless they declare a defaultvalue.
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ParamSpec> getParams() {
         return params;
     }
 
+    /**
+     * Params is a list of input parameters required to run the stepAction. Params must be supplied as inputs in Steps unless they declare a defaultvalue.
+     */
     @JsonProperty("params")
     public void setParams(List<ParamSpec> params) {
         this.params = params;
     }
 
+    /**
+     * Results are values that this StepAction can output
+     */
     @JsonProperty("results")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<StepResult> getResults() {
         return results;
     }
 
+    /**
+     * Results are values that this StepAction can output
+     */
     @JsonProperty("results")
     public void setResults(List<StepResult> results) {
         this.results = results;
     }
 
+    /**
+     * Script is the contents of an executable file to execute.<br><p> <br><p> If Script is not empty, the Step cannot have an Command and the Args will be passed to the Script.
+     */
     @JsonProperty("script")
     public String getScript() {
         return script;
     }
 
+    /**
+     * Script is the contents of an executable file to execute.<br><p> <br><p> If Script is not empty, the Step cannot have an Command and the Args will be passed to the Script.
+     */
     @JsonProperty("script")
     public void setScript(String script) {
         this.script = script;
     }
 
+    /**
+     * StepActionSpec contains the actionable components of a step.
+     */
     @JsonProperty("securityContext")
     public SecurityContext getSecurityContext() {
         return securityContext;
     }
 
+    /**
+     * StepActionSpec contains the actionable components of a step.
+     */
     @JsonProperty("securityContext")
     public void setSecurityContext(SecurityContext securityContext) {
         this.securityContext = securityContext;
     }
 
+    /**
+     * Volumes to mount into the Step's filesystem. Cannot be updated.
+     */
     @JsonProperty("volumeMounts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VolumeMount> getVolumeMounts() {
         return volumeMounts;
     }
 
+    /**
+     * Volumes to mount into the Step's filesystem. Cannot be updated.
+     */
     @JsonProperty("volumeMounts")
     public void setVolumeMounts(List<VolumeMount> volumeMounts) {
         this.volumeMounts = volumeMounts;
     }
 
+    /**
+     * Step's working directory. If not specified, the container runtime's default will be used, which might be configured in the container image. Cannot be updated.
+     */
     @JsonProperty("workingDir")
     public String getWorkingDir() {
         return workingDir;
     }
 
+    /**
+     * Step's working directory. If not specified, the container runtime's default will be used, which might be configured in the container image. Cannot be updated.
+     */
     @JsonProperty("workingDir")
     public void setWorkingDir(String workingDir) {
         this.workingDir = workingDir;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/VerificationPolicy.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/VerificationPolicy.java
index 8a6d1255892..0309f753d99 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/VerificationPolicy.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/VerificationPolicy.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerificationPolicy defines the rules to verify Tekton resources. VerificationPolicy can config the mapping from resources to a list of public keys, so when verifying the resources we can use the corresponding public keys.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class VerificationPolicy implements Editable<VerificationPolicyBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VerificationPolicy";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public VerificationPolicy(String apiVersion, String kind, ObjectMeta metadata, V
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VerificationPolicy defines the rules to verify Tekton resources. VerificationPolicy can config the mapping from resources to a list of public keys, so when verifying the resources we can use the corresponding public keys.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VerificationPolicy defines the rules to verify Tekton resources. VerificationPolicy can config the mapping from resources to a list of public keys, so when verifying the resources we can use the corresponding public keys.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * VerificationPolicy defines the rules to verify Tekton resources. VerificationPolicy can config the mapping from resources to a list of public keys, so when verifying the resources we can use the corresponding public keys.
+     */
     @JsonProperty("spec")
     public VerificationPolicySpec getSpec() {
         return spec;
     }
 
+    /**
+     * VerificationPolicy defines the rules to verify Tekton resources. VerificationPolicy can config the mapping from resources to a list of public keys, so when verifying the resources we can use the corresponding public keys.
+     */
     @JsonProperty("spec")
     public void setSpec(VerificationPolicySpec spec) {
         this.spec = spec;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/VerificationPolicyList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/VerificationPolicyList.java
index 97d6884ea37..fc4f4a550dc 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/VerificationPolicyList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/VerificationPolicyList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerificationPolicyList contains a list of VerificationPolicy
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class VerificationPolicyList implements Editable<VerificationPolicyListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.v1alpha1.VerificationPolicy>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.v1alpha1.VerificationPolicy> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VerificationPolicyList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public VerificationPolicyList(String apiVersion, List<io.fabric8.tekton.v1alpha1
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * VerificationPolicyList contains a list of VerificationPolicy
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.v1alpha1.VerificationPolicy> getItems() {
         return items;
     }
 
+    /**
+     * VerificationPolicyList contains a list of VerificationPolicy
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.v1alpha1.VerificationPolicy> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VerificationPolicyList contains a list of VerificationPolicy
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VerificationPolicyList contains a list of VerificationPolicy
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/VerificationPolicySpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/VerificationPolicySpec.java
index 50f0ed28cc4..d9a12705791 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/VerificationPolicySpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1alpha1/VerificationPolicySpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerificationPolicySpec defines the patterns and authorities.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public VerificationPolicySpec(List<Authority> authorities, String mode, List<Res
         this.resources = resources;
     }
 
+    /**
+     * Authorities defines the rules for validating signatures.
+     */
     @JsonProperty("authorities")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Authority> getAuthorities() {
         return authorities;
     }
 
+    /**
+     * Authorities defines the rules for validating signatures.
+     */
     @JsonProperty("authorities")
     public void setAuthorities(List<Authority> authorities) {
         this.authorities = authorities;
     }
 
+    /**
+     * Mode controls whether a failing policy will fail the taskrun/pipelinerun, or only log the warnings enforce - fail the taskrun/pipelinerun if verification fails (default) warn - don't fail the taskrun/pipelinerun if verification fails but log warnings
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Mode controls whether a failing policy will fail the taskrun/pipelinerun, or only log the warnings enforce - fail the taskrun/pipelinerun if verification fails (default) warn - don't fail the taskrun/pipelinerun if verification fails but log warnings
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
     }
 
+    /**
+     * Resources defines the patterns of resources sources that should be subject to this policy. For example, we may want to apply this Policy from a certain GitHub repo. Then the ResourcesPattern should be valid regex. E.g. If using gitresolver, and we want to config keys from a certain git repo. `ResourcesPattern` can be `https://github.com/tektoncd/catalog.git`, we will use regex to filter out those resources.
+     */
     @JsonProperty("resources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ResourcePattern> getResources() {
         return resources;
     }
 
+    /**
+     * Resources defines the patterns of resources sources that should be subject to this policy. For example, we may want to apply this Policy from a certain GitHub repo. Then the ResourcesPattern should be valid regex. E.g. If using gitresolver, and we want to config keys from a certain git repo. `ResourcesPattern` can be `https://github.com/tektoncd/catalog.git`, we will use regex to filter out those resources.
+     */
     @JsonProperty("resources")
     public void setResources(List<ResourcePattern> resources) {
         this.resources = resources;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Artifact.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Artifact.java
index 8bcc7c4f402..768bdaacf07 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Artifact.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Artifact.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskRunStepArtifact represents an artifact produced or used by a step within a task run. It directly uses the Artifact type for its structure.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public Artifact(Boolean buildOutput, String name, List<ArtifactValue> values) {
         this.values = values;
     }
 
+    /**
+     * Indicate if the artifact is a build output or a by-product
+     */
     @JsonProperty("buildOutput")
     public Boolean getBuildOutput() {
         return buildOutput;
     }
 
+    /**
+     * Indicate if the artifact is a build output or a by-product
+     */
     @JsonProperty("buildOutput")
     public void setBuildOutput(Boolean buildOutput) {
         this.buildOutput = buildOutput;
     }
 
+    /**
+     * The artifact's identifying category name
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The artifact's identifying category name
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * A collection of values related to the artifact
+     */
     @JsonProperty("values")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ArtifactValue> getValues() {
         return values;
     }
 
+    /**
+     * A collection of values related to the artifact
+     */
     @JsonProperty("values")
     public void setValues(List<ArtifactValue> values) {
         this.values = values;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ArtifactValue.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ArtifactValue.java
index f92d42b8b1f..ba1b9e6ac9c 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ArtifactValue.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ArtifactValue.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ArtifactValue represents a specific value or data element within an Artifact.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,22 +86,34 @@ public ArtifactValue(Map<String, String> digest, String uri) {
         this.uri = uri;
     }
 
+    /**
+     * ArtifactValue represents a specific value or data element within an Artifact.
+     */
     @JsonProperty("digest")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getDigest() {
         return digest;
     }
 
+    /**
+     * ArtifactValue represents a specific value or data element within an Artifact.
+     */
     @JsonProperty("digest")
     public void setDigest(Map<String, String> digest) {
         this.digest = digest;
     }
 
+    /**
+     * Algorithm-specific digests for verifying the content (e.g., SHA256)
+     */
     @JsonProperty("uri")
     public String getUri() {
         return uri;
     }
 
+    /**
+     * Algorithm-specific digests for verifying the content (e.g., SHA256)
+     */
     @JsonProperty("uri")
     public void setUri(String uri) {
         this.uri = uri;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Artifacts.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Artifacts.java
index bf752e59675..8a529178317 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Artifacts.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Artifacts.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Artifacts represents the collection of input and output artifacts associated with a task run or a similar process. Artifacts in this context are units of data or resources that the process either consumes as input or produces as output.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public Artifacts(List<Artifact> inputs, List<Artifact> outputs) {
         this.outputs = outputs;
     }
 
+    /**
+     * Artifacts represents the collection of input and output artifacts associated with a task run or a similar process. Artifacts in this context are units of data or resources that the process either consumes as input or produces as output.
+     */
     @JsonProperty("inputs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Artifact> getInputs() {
         return inputs;
     }
 
+    /**
+     * Artifacts represents the collection of input and output artifacts associated with a task run or a similar process. Artifacts in this context are units of data or resources that the process either consumes as input or produces as output.
+     */
     @JsonProperty("inputs")
     public void setInputs(List<Artifact> inputs) {
         this.inputs = inputs;
     }
 
+    /**
+     * Artifacts represents the collection of input and output artifacts associated with a task run or a similar process. Artifacts in this context are units of data or resources that the process either consumes as input or produces as output.
+     */
     @JsonProperty("outputs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Artifact> getOutputs() {
         return outputs;
     }
 
+    /**
+     * Artifacts represents the collection of input and output artifacts associated with a task run or a similar process. Artifacts in this context are units of data or resources that the process either consumes as input or produces as output.
+     */
     @JsonProperty("outputs")
     public void setOutputs(List<Artifact> outputs) {
         this.outputs = outputs;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ChildStatusReference.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ChildStatusReference.java
index ca985770029..2a1635eb58e 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ChildStatusReference.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ChildStatusReference.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ChildStatusReference is used to point to the statuses of individual TaskRuns and Runs within this PipelineRun.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,62 +104,98 @@ public ChildStatusReference(String apiVersion, String displayName, String kind,
         this.whenExpressions = whenExpressions;
     }
 
+    /**
+     * ChildStatusReference is used to point to the statuses of individual TaskRuns and Runs within this PipelineRun.
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * ChildStatusReference is used to point to the statuses of individual TaskRuns and Runs within this PipelineRun.
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * DisplayName is a user-facing name of the pipelineTask that may be used to populate a UI.
+     */
     @JsonProperty("displayName")
     public String getDisplayName() {
         return displayName;
     }
 
+    /**
+     * DisplayName is a user-facing name of the pipelineTask that may be used to populate a UI.
+     */
     @JsonProperty("displayName")
     public void setDisplayName(String displayName) {
         this.displayName = displayName;
     }
 
+    /**
+     * ChildStatusReference is used to point to the statuses of individual TaskRuns and Runs within this PipelineRun.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * ChildStatusReference is used to point to the statuses of individual TaskRuns and Runs within this PipelineRun.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of the TaskRun or Run this is referencing.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the TaskRun or Run this is referencing.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * PipelineTaskName is the name of the PipelineTask this is referencing.
+     */
     @JsonProperty("pipelineTaskName")
     public String getPipelineTaskName() {
         return pipelineTaskName;
     }
 
+    /**
+     * PipelineTaskName is the name of the PipelineTask this is referencing.
+     */
     @JsonProperty("pipelineTaskName")
     public void setPipelineTaskName(String pipelineTaskName) {
         this.pipelineTaskName = pipelineTaskName;
     }
 
+    /**
+     * WhenExpressions is the list of checks guarding the execution of the PipelineTask
+     */
     @JsonProperty("whenExpressions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WhenExpression> getWhenExpressions() {
         return whenExpressions;
     }
 
+    /**
+     * WhenExpressions is the list of checks guarding the execution of the PipelineTask
+     */
     @JsonProperty("whenExpressions")
     public void setWhenExpressions(List<WhenExpression> whenExpressions) {
         this.whenExpressions = whenExpressions;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CloudEventDelivery.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CloudEventDelivery.java
index bf31ab0656a..6f9dac40c3f 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CloudEventDelivery.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CloudEventDelivery.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CloudEventDelivery is the target of a cloud event along with the state of delivery.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public CloudEventDelivery(CloudEventDeliveryState status, String target) {
         this.target = target;
     }
 
+    /**
+     * CloudEventDelivery is the target of a cloud event along with the state of delivery.
+     */
     @JsonProperty("status")
     public CloudEventDeliveryState getStatus() {
         return status;
     }
 
+    /**
+     * CloudEventDelivery is the target of a cloud event along with the state of delivery.
+     */
     @JsonProperty("status")
     public void setStatus(CloudEventDeliveryState status) {
         this.status = status;
     }
 
+    /**
+     * Target points to an addressable
+     */
     @JsonProperty("target")
     public String getTarget() {
         return target;
     }
 
+    /**
+     * Target points to an addressable
+     */
     @JsonProperty("target")
     public void setTarget(String target) {
         this.target = target;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CloudEventDeliveryState.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CloudEventDeliveryState.java
index a020460c239..8b7a593571e 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CloudEventDeliveryState.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CloudEventDeliveryState.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CloudEventDeliveryState reports the state of a cloud event to be sent.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public CloudEventDeliveryState(String condition, String message, Integer retryCo
         this.sentAt = sentAt;
     }
 
+    /**
+     * Current status
+     */
     @JsonProperty("condition")
     public String getCondition() {
         return condition;
     }
 
+    /**
+     * Current status
+     */
     @JsonProperty("condition")
     public void setCondition(String condition) {
         this.condition = condition;
     }
 
+    /**
+     * Error is the text of error (if any)
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Error is the text of error (if any)
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * RetryCount is the number of attempts of sending the cloud event
+     */
     @JsonProperty("retryCount")
     public Integer getRetryCount() {
         return retryCount;
     }
 
+    /**
+     * RetryCount is the number of attempts of sending the cloud event
+     */
     @JsonProperty("retryCount")
     public void setRetryCount(Integer retryCount) {
         this.retryCount = retryCount;
     }
 
+    /**
+     * CloudEventDeliveryState reports the state of a cloud event to be sent.
+     */
     @JsonProperty("sentAt")
     public String getSentAt() {
         return sentAt;
     }
 
+    /**
+     * CloudEventDeliveryState reports the state of a cloud event to be sent.
+     */
     @JsonProperty("sentAt")
     public void setSentAt(String sentAt) {
         this.sentAt = sentAt;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ClusterTask.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ClusterTask.java
index 046288ce53b..f201e9d8ff5 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ClusterTask.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ClusterTask.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterTask is a Task with a cluster scope. ClusterTasks are used to represent Tasks that should be publicly addressable from any namespace in the cluster.<br><p> <br><p> Deprecated: Please use the cluster resolver instead.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class ClusterTask implements Editable<ClusterTaskBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterTask";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public ClusterTask(String apiVersion, String kind, ObjectMeta metadata, TaskSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterTask is a Task with a cluster scope. ClusterTasks are used to represent Tasks that should be publicly addressable from any namespace in the cluster.<br><p> <br><p> Deprecated: Please use the cluster resolver instead.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterTask is a Task with a cluster scope. ClusterTasks are used to represent Tasks that should be publicly addressable from any namespace in the cluster.<br><p> <br><p> Deprecated: Please use the cluster resolver instead.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ClusterTask is a Task with a cluster scope. ClusterTasks are used to represent Tasks that should be publicly addressable from any namespace in the cluster.<br><p> <br><p> Deprecated: Please use the cluster resolver instead.
+     */
     @JsonProperty("spec")
     public TaskSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ClusterTask is a Task with a cluster scope. ClusterTasks are used to represent Tasks that should be publicly addressable from any namespace in the cluster.<br><p> <br><p> Deprecated: Please use the cluster resolver instead.
+     */
     @JsonProperty("spec")
     public void setSpec(TaskSpec spec) {
         this.spec = spec;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ClusterTaskList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ClusterTaskList.java
index aa527c982e7..c7aeaa01e00 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ClusterTaskList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ClusterTaskList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterTaskList contains a list of ClusterTask
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ClusterTaskList implements Editable<ClusterTaskListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.v1beta1.ClusterTask>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.v1beta1.ClusterTask> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterTaskList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterTaskList(String apiVersion, List<io.fabric8.tekton.v1beta1.Cluster
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ClusterTaskList contains a list of ClusterTask
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.v1beta1.ClusterTask> getItems() {
         return items;
     }
 
+    /**
+     * ClusterTaskList contains a list of ClusterTask
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.v1beta1.ClusterTask> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterTaskList contains a list of ClusterTask
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterTaskList contains a list of ClusterTask
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ConfigSource.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ConfigSource.java
index 6c3c59c2852..2675aa03bd3 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ConfigSource.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ConfigSource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConfigSource contains the information that can uniquely identify where a remote built definition came from i.e. Git repositories, Tekton Bundles in OCI registry and hub.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,32 +90,50 @@ public ConfigSource(Map<String, String> digest, String entryPoint, String uri) {
         this.uri = uri;
     }
 
+    /**
+     * Digest is a collection of cryptographic digests for the contents of the artifact specified by URI. Example: {"sha1": "f99d13e554ffcb696dee719fa85b695cb5b0f428"}
+     */
     @JsonProperty("digest")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getDigest() {
         return digest;
     }
 
+    /**
+     * Digest is a collection of cryptographic digests for the contents of the artifact specified by URI. Example: {"sha1": "f99d13e554ffcb696dee719fa85b695cb5b0f428"}
+     */
     @JsonProperty("digest")
     public void setDigest(Map<String, String> digest) {
         this.digest = digest;
     }
 
+    /**
+     * EntryPoint identifies the entry point into the build. This is often a path to a build definition file and/or a target label within that file. Example: "task/git-clone/0.8/git-clone.yaml"
+     */
     @JsonProperty("entryPoint")
     public String getEntryPoint() {
         return entryPoint;
     }
 
+    /**
+     * EntryPoint identifies the entry point into the build. This is often a path to a build definition file and/or a target label within that file. Example: "task/git-clone/0.8/git-clone.yaml"
+     */
     @JsonProperty("entryPoint")
     public void setEntryPoint(String entryPoint) {
         this.entryPoint = entryPoint;
     }
 
+    /**
+     * URI indicates the identity of the source of the build definition. Example: "https://github.com/tektoncd/catalog"
+     */
     @JsonProperty("uri")
     public String getUri() {
         return uri;
     }
 
+    /**
+     * URI indicates the identity of the source of the build definition. Example: "https://github.com/tektoncd/catalog"
+     */
     @JsonProperty("uri")
     public void setUri(String uri) {
         this.uri = uri;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CustomRun.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CustomRun.java
index 2e38ac8858f..c30a591d23c 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CustomRun.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CustomRun.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomRun represents a single execution of a Custom Task.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class CustomRun implements Editable<CustomRunBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CustomRun";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CustomRun(String apiVersion, String kind, ObjectMeta metadata, CustomRunS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CustomRun represents a single execution of a Custom Task.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CustomRun represents a single execution of a Custom Task.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * CustomRun represents a single execution of a Custom Task.
+     */
     @JsonProperty("spec")
     public CustomRunSpec getSpec() {
         return spec;
     }
 
+    /**
+     * CustomRun represents a single execution of a Custom Task.
+     */
     @JsonProperty("spec")
     public void setSpec(CustomRunSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * CustomRun represents a single execution of a Custom Task.
+     */
     @JsonProperty("status")
     public CustomRunStatus getStatus() {
         return status;
     }
 
+    /**
+     * CustomRun represents a single execution of a Custom Task.
+     */
     @JsonProperty("status")
     public void setStatus(CustomRunStatus status) {
         this.status = status;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CustomRunList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CustomRunList.java
index 2fecc2fc432..81e461db22f 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CustomRunList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CustomRunList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomRunList contains a list of CustomRun
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class CustomRunList implements Editable<CustomRunListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.v1beta1.CustomRun>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.v1beta1.CustomRun> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CustomRunList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CustomRunList(String apiVersion, List<io.fabric8.tekton.v1beta1.CustomRun
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * CustomRunList contains a list of CustomRun
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.v1beta1.CustomRun> getItems() {
         return items;
     }
 
+    /**
+     * CustomRunList contains a list of CustomRun
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.v1beta1.CustomRun> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CustomRunList contains a list of CustomRun
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CustomRunList contains a list of CustomRun
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CustomRunResult.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CustomRunResult.java
index cad045be0a3..e1e1ec15df8 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CustomRunResult.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CustomRunResult.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomRunResult used to describe the results of a task
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public CustomRunResult(String name, String value) {
         this.value = value;
     }
 
+    /**
+     * Name the given name
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name the given name
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Value the given value of the result
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value the given value of the result
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CustomRunSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CustomRunSpec.java
index e648dc2ec1d..04d63923f29 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CustomRunSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CustomRunSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomRunSpec defines the desired state of CustomRun
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -115,93 +118,147 @@ public CustomRunSpec(TaskRef customRef, EmbeddedCustomRunSpec customSpec, List<P
         this.workspaces = workspaces;
     }
 
+    /**
+     * CustomRunSpec defines the desired state of CustomRun
+     */
     @JsonProperty("customRef")
     public TaskRef getCustomRef() {
         return customRef;
     }
 
+    /**
+     * CustomRunSpec defines the desired state of CustomRun
+     */
     @JsonProperty("customRef")
     public void setCustomRef(TaskRef customRef) {
         this.customRef = customRef;
     }
 
+    /**
+     * CustomRunSpec defines the desired state of CustomRun
+     */
     @JsonProperty("customSpec")
     public EmbeddedCustomRunSpec getCustomSpec() {
         return customSpec;
     }
 
+    /**
+     * CustomRunSpec defines the desired state of CustomRun
+     */
     @JsonProperty("customSpec")
     public void setCustomSpec(EmbeddedCustomRunSpec customSpec) {
         this.customSpec = customSpec;
     }
 
+    /**
+     * CustomRunSpec defines the desired state of CustomRun
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Param> getParams() {
         return params;
     }
 
+    /**
+     * CustomRunSpec defines the desired state of CustomRun
+     */
     @JsonProperty("params")
     public void setParams(List<Param> params) {
         this.params = params;
     }
 
+    /**
+     * Used for propagating retries count to custom tasks
+     */
     @JsonProperty("retries")
     public Integer getRetries() {
         return retries;
     }
 
+    /**
+     * Used for propagating retries count to custom tasks
+     */
     @JsonProperty("retries")
     public void setRetries(Integer retries) {
         this.retries = retries;
     }
 
+    /**
+     * CustomRunSpec defines the desired state of CustomRun
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * CustomRunSpec defines the desired state of CustomRun
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * Used for cancelling a customrun (and maybe more later on)
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Used for cancelling a customrun (and maybe more later on)
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Status message for cancellation.
+     */
     @JsonProperty("statusMessage")
     public String getStatusMessage() {
         return statusMessage;
     }
 
+    /**
+     * Status message for cancellation.
+     */
     @JsonProperty("statusMessage")
     public void setStatusMessage(String statusMessage) {
         this.statusMessage = statusMessage;
     }
 
+    /**
+     * CustomRunSpec defines the desired state of CustomRun
+     */
     @JsonProperty("timeout")
     public Duration getTimeout() {
         return timeout;
     }
 
+    /**
+     * CustomRunSpec defines the desired state of CustomRun
+     */
     @JsonProperty("timeout")
     public void setTimeout(Duration timeout) {
         this.timeout = timeout;
     }
 
+    /**
+     * Workspaces is a list of WorkspaceBindings from volumes to workspaces.
+     */
     @JsonProperty("workspaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WorkspaceBinding> getWorkspaces() {
         return workspaces;
     }
 
+    /**
+     * Workspaces is a list of WorkspaceBindings from volumes to workspaces.
+     */
     @JsonProperty("workspaces")
     public void setWorkspaces(List<WorkspaceBinding> workspaces) {
         this.workspaces = workspaces;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CustomRunStatus.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CustomRunStatus.java
index 140cf677b8f..4fa0a8d0744 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CustomRunStatus.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CustomRunStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomRunStatus defines the observed state of CustomRun.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -114,86 +117,134 @@ public CustomRunStatus(Map<String, String> annotations, String completionTime, L
         this.startTime = startTime;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * CustomRunStatus defines the observed state of CustomRun.
+     */
     @JsonProperty("completionTime")
     public String getCompletionTime() {
         return completionTime;
     }
 
+    /**
+     * CustomRunStatus defines the observed state of CustomRun.
+     */
     @JsonProperty("completionTime")
     public void setCompletionTime(String completionTime) {
         this.completionTime = completionTime;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * CustomRunStatus defines the observed state of CustomRun.
+     */
     @JsonProperty("extraFields")
     public Object getExtraFields() {
         return extraFields;
     }
 
+    /**
+     * CustomRunStatus defines the observed state of CustomRun.
+     */
     @JsonProperty("extraFields")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setExtraFields(Object extraFields) {
         this.extraFields = extraFields;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Results reports any output result values to be consumed by later tasks in a pipeline.
+     */
     @JsonProperty("results")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CustomRunResult> getResults() {
         return results;
     }
 
+    /**
+     * Results reports any output result values to be consumed by later tasks in a pipeline.
+     */
     @JsonProperty("results")
     public void setResults(List<CustomRunResult> results) {
         this.results = results;
     }
 
+    /**
+     * RetriesStatus contains the history of CustomRunStatus, in case of a retry.
+     */
     @JsonProperty("retriesStatus")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.v1beta1.CustomRunStatus> getRetriesStatus() {
         return retriesStatus;
     }
 
+    /**
+     * RetriesStatus contains the history of CustomRunStatus, in case of a retry.
+     */
     @JsonProperty("retriesStatus")
     public void setRetriesStatus(List<io.fabric8.tekton.v1beta1.CustomRunStatus> retriesStatus) {
         this.retriesStatus = retriesStatus;
     }
 
+    /**
+     * CustomRunStatus defines the observed state of CustomRun.
+     */
     @JsonProperty("startTime")
     public String getStartTime() {
         return startTime;
     }
 
+    /**
+     * CustomRunStatus defines the observed state of CustomRun.
+     */
     @JsonProperty("startTime")
     public void setStartTime(String startTime) {
         this.startTime = startTime;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CustomRunStatusFields.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CustomRunStatusFields.java
index 21f74273b16..c3eff1e0ce1 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CustomRunStatusFields.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/CustomRunStatusFields.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomRunStatusFields holds the fields of CustomRun's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -99,54 +102,84 @@ public CustomRunStatusFields(String completionTime, Object extraFields, List<Cus
         this.startTime = startTime;
     }
 
+    /**
+     * CustomRunStatusFields holds the fields of CustomRun's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("completionTime")
     public String getCompletionTime() {
         return completionTime;
     }
 
+    /**
+     * CustomRunStatusFields holds the fields of CustomRun's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("completionTime")
     public void setCompletionTime(String completionTime) {
         this.completionTime = completionTime;
     }
 
+    /**
+     * CustomRunStatusFields holds the fields of CustomRun's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("extraFields")
     public Object getExtraFields() {
         return extraFields;
     }
 
+    /**
+     * CustomRunStatusFields holds the fields of CustomRun's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("extraFields")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setExtraFields(Object extraFields) {
         this.extraFields = extraFields;
     }
 
+    /**
+     * Results reports any output result values to be consumed by later tasks in a pipeline.
+     */
     @JsonProperty("results")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CustomRunResult> getResults() {
         return results;
     }
 
+    /**
+     * Results reports any output result values to be consumed by later tasks in a pipeline.
+     */
     @JsonProperty("results")
     public void setResults(List<CustomRunResult> results) {
         this.results = results;
     }
 
+    /**
+     * RetriesStatus contains the history of CustomRunStatus, in case of a retry.
+     */
     @JsonProperty("retriesStatus")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CustomRunStatus> getRetriesStatus() {
         return retriesStatus;
     }
 
+    /**
+     * RetriesStatus contains the history of CustomRunStatus, in case of a retry.
+     */
     @JsonProperty("retriesStatus")
     public void setRetriesStatus(List<CustomRunStatus> retriesStatus) {
         this.retriesStatus = retriesStatus;
     }
 
+    /**
+     * CustomRunStatusFields holds the fields of CustomRun's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("startTime")
     public String getStartTime() {
         return startTime;
     }
 
+    /**
+     * CustomRunStatusFields holds the fields of CustomRun's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("startTime")
     public void setStartTime(String startTime) {
         this.startTime = startTime;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/EmbeddedCustomRunSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/EmbeddedCustomRunSpec.java
index 0fe26120073..c0e1c904b91 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/EmbeddedCustomRunSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/EmbeddedCustomRunSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EmbeddedCustomRunSpec allows custom task definitions to be embedded
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,41 +94,65 @@ public EmbeddedCustomRunSpec(String apiVersion, String kind, PipelineTaskMetadat
         this.spec = spec;
     }
 
+    /**
+     * EmbeddedCustomRunSpec allows custom task definitions to be embedded
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * EmbeddedCustomRunSpec allows custom task definitions to be embedded
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * EmbeddedCustomRunSpec allows custom task definitions to be embedded
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * EmbeddedCustomRunSpec allows custom task definitions to be embedded
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EmbeddedCustomRunSpec allows custom task definitions to be embedded
+     */
     @JsonProperty("metadata")
     public PipelineTaskMetadata getMetadata() {
         return metadata;
     }
 
+    /**
+     * EmbeddedCustomRunSpec allows custom task definitions to be embedded
+     */
     @JsonProperty("metadata")
     public void setMetadata(PipelineTaskMetadata metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * EmbeddedCustomRunSpec allows custom task definitions to be embedded
+     */
     @JsonProperty("spec")
     public Object getSpec() {
         return spec;
     }
 
+    /**
+     * EmbeddedCustomRunSpec allows custom task definitions to be embedded
+     */
     @JsonProperty("spec")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setSpec(Object spec) {
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/EmbeddedTask.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/EmbeddedTask.java
index af7ca140797..100901b3f44 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/EmbeddedTask.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/EmbeddedTask.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EmbeddedTask is used to define a Task inline within a Pipeline's PipelineTasks.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -139,148 +142,232 @@ public EmbeddedTask(String apiVersion, String description, String displayName, S
         this.workspaces = workspaces;
     }
 
+    /**
+     * EmbeddedTask is used to define a Task inline within a Pipeline's PipelineTasks.
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * EmbeddedTask is used to define a Task inline within a Pipeline's PipelineTasks.
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Description is a user-facing description of the task that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is a user-facing description of the task that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * DisplayName is a user-facing name of the task that may be used to populate a UI.
+     */
     @JsonProperty("displayName")
     public String getDisplayName() {
         return displayName;
     }
 
+    /**
+     * DisplayName is a user-facing name of the task that may be used to populate a UI.
+     */
     @JsonProperty("displayName")
     public void setDisplayName(String displayName) {
         this.displayName = displayName;
     }
 
+    /**
+     * EmbeddedTask is used to define a Task inline within a Pipeline's PipelineTasks.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * EmbeddedTask is used to define a Task inline within a Pipeline's PipelineTasks.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EmbeddedTask is used to define a Task inline within a Pipeline's PipelineTasks.
+     */
     @JsonProperty("metadata")
     public PipelineTaskMetadata getMetadata() {
         return metadata;
     }
 
+    /**
+     * EmbeddedTask is used to define a Task inline within a Pipeline's PipelineTasks.
+     */
     @JsonProperty("metadata")
     public void setMetadata(PipelineTaskMetadata metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Params is a list of input parameters required to run the task. Params must be supplied as inputs in TaskRuns unless they declare a default value.
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ParamSpec> getParams() {
         return params;
     }
 
+    /**
+     * Params is a list of input parameters required to run the task. Params must be supplied as inputs in TaskRuns unless they declare a default value.
+     */
     @JsonProperty("params")
     public void setParams(List<ParamSpec> params) {
         this.params = params;
     }
 
+    /**
+     * EmbeddedTask is used to define a Task inline within a Pipeline's PipelineTasks.
+     */
     @JsonProperty("resources")
     public TaskResources getResources() {
         return resources;
     }
 
+    /**
+     * EmbeddedTask is used to define a Task inline within a Pipeline's PipelineTasks.
+     */
     @JsonProperty("resources")
     public void setResources(TaskResources resources) {
         this.resources = resources;
     }
 
+    /**
+     * Results are values that this Task can output
+     */
     @JsonProperty("results")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TaskResult> getResults() {
         return results;
     }
 
+    /**
+     * Results are values that this Task can output
+     */
     @JsonProperty("results")
     public void setResults(List<TaskResult> results) {
         this.results = results;
     }
 
+    /**
+     * Sidecars are run alongside the Task's step containers. They begin before the steps start and end after the steps complete.
+     */
     @JsonProperty("sidecars")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Sidecar> getSidecars() {
         return sidecars;
     }
 
+    /**
+     * Sidecars are run alongside the Task's step containers. They begin before the steps start and end after the steps complete.
+     */
     @JsonProperty("sidecars")
     public void setSidecars(List<Sidecar> sidecars) {
         this.sidecars = sidecars;
     }
 
+    /**
+     * EmbeddedTask is used to define a Task inline within a Pipeline's PipelineTasks.
+     */
     @JsonProperty("spec")
     public Object getSpec() {
         return spec;
     }
 
+    /**
+     * EmbeddedTask is used to define a Task inline within a Pipeline's PipelineTasks.
+     */
     @JsonProperty("spec")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setSpec(Object spec) {
         this.spec = spec;
     }
 
+    /**
+     * EmbeddedTask is used to define a Task inline within a Pipeline's PipelineTasks.
+     */
     @JsonProperty("stepTemplate")
     public StepTemplate getStepTemplate() {
         return stepTemplate;
     }
 
+    /**
+     * EmbeddedTask is used to define a Task inline within a Pipeline's PipelineTasks.
+     */
     @JsonProperty("stepTemplate")
     public void setStepTemplate(StepTemplate stepTemplate) {
         this.stepTemplate = stepTemplate;
     }
 
+    /**
+     * Steps are the steps of the build; each step is run sequentially with the source mounted into /workspace.
+     */
     @JsonProperty("steps")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Step> getSteps() {
         return steps;
     }
 
+    /**
+     * Steps are the steps of the build; each step is run sequentially with the source mounted into /workspace.
+     */
     @JsonProperty("steps")
     public void setSteps(List<Step> steps) {
         this.steps = steps;
     }
 
+    /**
+     * Volumes is a collection of volumes that are available to mount into the steps of the build.
+     */
     @JsonProperty("volumes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Volume> getVolumes() {
         return volumes;
     }
 
+    /**
+     * Volumes is a collection of volumes that are available to mount into the steps of the build.
+     */
     @JsonProperty("volumes")
     public void setVolumes(List<Volume> volumes) {
         this.volumes = volumes;
     }
 
+    /**
+     * Workspaces are the volumes that this Task requires.
+     */
     @JsonProperty("workspaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WorkspaceDeclaration> getWorkspaces() {
         return workspaces;
     }
 
+    /**
+     * Workspaces are the volumes that this Task requires.
+     */
     @JsonProperty("workspaces")
     public void setWorkspaces(List<WorkspaceDeclaration> workspaces) {
         this.workspaces = workspaces;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/IncludeParams.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/IncludeParams.java
index 7eea8fa7f5b..46bc7eb858f 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/IncludeParams.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/IncludeParams.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IncludeParams allows passing in a specific combinations of Parameters into the Matrix.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public IncludeParams(String name, List<Param> params) {
         this.params = params;
     }
 
+    /**
+     * Name the specified combination
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name the specified combination
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Params takes only `Parameters` of type `"string"` The names of the `params` must match the names of the `params` in the underlying `Task`
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Param> getParams() {
         return params;
     }
 
+    /**
+     * Params takes only `Parameters` of type `"string"` The names of the `params` must match the names of the `params` in the underlying `Task`
+     */
     @JsonProperty("params")
     public void setParams(List<Param> params) {
         this.params = params;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/InternalTaskModifier.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/InternalTaskModifier.java
index 963c9f45af2..2b9e67d0810 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/InternalTaskModifier.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/InternalTaskModifier.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * InternalTaskModifier implements TaskModifier for resources that are built-in to Tekton Pipelines.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,34 +94,52 @@ public InternalTaskModifier(List<Step> stepsToAppend, List<Step> stepsToPrepend,
         this.volumes = volumes;
     }
 
+    /**
+     * InternalTaskModifier implements TaskModifier for resources that are built-in to Tekton Pipelines.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("stepsToAppend")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Step> getStepsToAppend() {
         return stepsToAppend;
     }
 
+    /**
+     * InternalTaskModifier implements TaskModifier for resources that are built-in to Tekton Pipelines.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("stepsToAppend")
     public void setStepsToAppend(List<Step> stepsToAppend) {
         this.stepsToAppend = stepsToAppend;
     }
 
+    /**
+     * InternalTaskModifier implements TaskModifier for resources that are built-in to Tekton Pipelines.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("stepsToPrepend")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Step> getStepsToPrepend() {
         return stepsToPrepend;
     }
 
+    /**
+     * InternalTaskModifier implements TaskModifier for resources that are built-in to Tekton Pipelines.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("stepsToPrepend")
     public void setStepsToPrepend(List<Step> stepsToPrepend) {
         this.stepsToPrepend = stepsToPrepend;
     }
 
+    /**
+     * InternalTaskModifier implements TaskModifier for resources that are built-in to Tekton Pipelines.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("volumes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Volume> getVolumes() {
         return volumes;
     }
 
+    /**
+     * InternalTaskModifier implements TaskModifier for resources that are built-in to Tekton Pipelines.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("volumes")
     public void setVolumes(List<Volume> volumes) {
         this.volumes = volumes;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Matrix.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Matrix.java
index 920676360dd..936b4f2fd11 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Matrix.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Matrix.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Matrix is used to fan out Tasks in a Pipeline
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public Matrix(List<IncludeParams> include, List<Param> params) {
         this.params = params;
     }
 
+    /**
+     * Include is a list of IncludeParams which allows passing in specific combinations of Parameters into the Matrix.
+     */
     @JsonProperty("include")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IncludeParams> getInclude() {
         return include;
     }
 
+    /**
+     * Include is a list of IncludeParams which allows passing in specific combinations of Parameters into the Matrix.
+     */
     @JsonProperty("include")
     public void setInclude(List<IncludeParams> include) {
         this.include = include;
     }
 
+    /**
+     * Params is a list of parameters used to fan out the pipelineTask Params takes only `Parameters` of type `"array"` Each array element is supplied to the `PipelineTask` by substituting `params` of type `"string"` in the underlying `Task`. The names of the `params` in the `Matrix` must match the names of the `params` in the underlying `Task` that they will be substituting.
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Param> getParams() {
         return params;
     }
 
+    /**
+     * Params is a list of parameters used to fan out the pipelineTask Params takes only `Parameters` of type `"array"` Each array element is supplied to the `PipelineTask` by substituting `params` of type `"string"` in the underlying `Task`. The names of the `params` in the `Matrix` must match the names of the `params` in the underlying `Task` that they will be substituting.
+     */
     @JsonProperty("params")
     public void setParams(List<Param> params) {
         this.params = params;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Param.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Param.java
index e9b9e4e26e0..7b0a3b0661c 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Param.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Param.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Param declares an ParamValues to use for the parameter called name.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Param(String name, ParamValue value) {
         this.value = value;
     }
 
+    /**
+     * Param declares an ParamValues to use for the parameter called name.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Param declares an ParamValues to use for the parameter called name.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Param declares an ParamValues to use for the parameter called name.
+     */
     @JsonProperty("value")
     public ParamValue getValue() {
         return value;
     }
 
+    /**
+     * Param declares an ParamValues to use for the parameter called name.
+     */
     @JsonProperty("value")
     public void setValue(ParamValue value) {
         this.value = value;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ParamSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ParamSpec.java
index 31df3f73f3b..81fbf6fbce2 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ParamSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ParamSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ParamSpec defines arbitrary parameters needed beyond typed inputs (such as resources). Parameter values are provided by users as inputs on a TaskRun or PipelineRun.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,63 +105,99 @@ public ParamSpec(ParamValue _default, String description, List<String> _enum, St
         this.type = type;
     }
 
+    /**
+     * ParamSpec defines arbitrary parameters needed beyond typed inputs (such as resources). Parameter values are provided by users as inputs on a TaskRun or PipelineRun.
+     */
     @JsonProperty("default")
     public ParamValue getDefault() {
         return _default;
     }
 
+    /**
+     * ParamSpec defines arbitrary parameters needed beyond typed inputs (such as resources). Parameter values are provided by users as inputs on a TaskRun or PipelineRun.
+     */
     @JsonProperty("default")
     public void setDefault(ParamValue _default) {
         this._default = _default;
     }
 
+    /**
+     * Description is a user-facing description of the parameter that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is a user-facing description of the parameter that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * Enum declares a set of allowed param input values for tasks/pipelines that can be validated. If Enum is not set, no input validation is performed for the param.
+     */
     @JsonProperty("enum")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEnum() {
         return _enum;
     }
 
+    /**
+     * Enum declares a set of allowed param input values for tasks/pipelines that can be validated. If Enum is not set, no input validation is performed for the param.
+     */
     @JsonProperty("enum")
     public void setEnum(List<String> _enum) {
         this._enum = _enum;
     }
 
+    /**
+     * Name declares the name by which a parameter is referenced.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name declares the name by which a parameter is referenced.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Properties is the JSON Schema properties to support key-value pairs parameter.
+     */
     @JsonProperty("properties")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, PropertySpec> getProperties() {
         return properties;
     }
 
+    /**
+     * Properties is the JSON Schema properties to support key-value pairs parameter.
+     */
     @JsonProperty("properties")
     public void setProperties(Map<String, PropertySpec> properties) {
         this.properties = properties;
     }
 
+    /**
+     * Type is the user-specified type of the parameter. The possible types are currently "string", "array" and "object", and "string" is the default.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the user-specified type of the parameter. The possible types are currently "string", "array" and "object", and "string" is the default.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Pipeline.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Pipeline.java
index 1449c0f9223..c6f556a7d44 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Pipeline.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Pipeline.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Pipeline describes a list of Tasks to execute. It expresses how outputs of tasks feed into inputs of subsequent tasks.<br><p> <br><p> Deprecated: Please use v1.Pipeline instead.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Pipeline implements Editable<PipelineBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Pipeline";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public Pipeline(String apiVersion, String kind, ObjectMeta metadata, PipelineSpe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Pipeline describes a list of Tasks to execute. It expresses how outputs of tasks feed into inputs of subsequent tasks.<br><p> <br><p> Deprecated: Please use v1.Pipeline instead.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Pipeline describes a list of Tasks to execute. It expresses how outputs of tasks feed into inputs of subsequent tasks.<br><p> <br><p> Deprecated: Please use v1.Pipeline instead.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Pipeline describes a list of Tasks to execute. It expresses how outputs of tasks feed into inputs of subsequent tasks.<br><p> <br><p> Deprecated: Please use v1.Pipeline instead.
+     */
     @JsonProperty("spec")
     public PipelineSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Pipeline describes a list of Tasks to execute. It expresses how outputs of tasks feed into inputs of subsequent tasks.<br><p> <br><p> Deprecated: Please use v1.Pipeline instead.
+     */
     @JsonProperty("spec")
     public void setSpec(PipelineSpec spec) {
         this.spec = spec;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineDeclaredResource.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineDeclaredResource.java
index ebd05aebd3a..c5993bf4b93 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineDeclaredResource.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineDeclaredResource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineDeclaredResource is used by a Pipeline to declare the types of the PipelineResources that it will required to run and names which can be used to refer to these PipelineResources in PipelineTaskResourceBindings.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public PipelineDeclaredResource(String name, Boolean optional, String type) {
         this.type = type;
     }
 
+    /**
+     * Name is the name that will be used by the Pipeline to refer to this resource. It does not directly correspond to the name of any PipelineResources Task inputs or outputs, and it does not correspond to the actual names of the PipelineResources that will be bound in the PipelineRun.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name that will be used by the Pipeline to refer to this resource. It does not directly correspond to the name of any PipelineResources Task inputs or outputs, and it does not correspond to the actual names of the PipelineResources that will be bound in the PipelineRun.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Optional declares the resource as optional. optional: true - the resource is considered optional optional: false - the resource is considered required (default/equivalent of not specifying it)
+     */
     @JsonProperty("optional")
     public Boolean getOptional() {
         return optional;
     }
 
+    /**
+     * Optional declares the resource as optional. optional: true - the resource is considered optional optional: false - the resource is considered required (default/equivalent of not specifying it)
+     */
     @JsonProperty("optional")
     public void setOptional(Boolean optional) {
         this.optional = optional;
     }
 
+    /**
+     * Type is the type of the PipelineResource.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of the PipelineResource.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineList.java
index ba4d3e82647..ff468759c4a 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineList contains a list of Pipeline
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PipelineList implements Editable<PipelineListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.v1beta1.Pipeline>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.v1beta1.Pipeline> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PipelineList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PipelineList(String apiVersion, List<io.fabric8.tekton.v1beta1.Pipeline>
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PipelineList contains a list of Pipeline
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.v1beta1.Pipeline> getItems() {
         return items;
     }
 
+    /**
+     * PipelineList contains a list of Pipeline
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.v1beta1.Pipeline> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PipelineList contains a list of Pipeline
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PipelineList contains a list of Pipeline
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRef.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRef.java
index 369b82efe7a..af1b81a7454 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRef.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRef.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineRef can be used to refer to a specific instance of a Pipeline.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public PipelineRef(String apiVersion, String bundle, String name) {
         this.name = name;
     }
 
+    /**
+     * API version of the referent
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * API version of the referent
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Bundle url reference to a Tekton Bundle.<br><p> <br><p> Deprecated: Please use ResolverRef with the bundles resolver instead. The field is staying there for go client backward compatibility, but is not used/allowed anymore.
+     */
     @JsonProperty("bundle")
     public String getBundle() {
         return bundle;
     }
 
+    /**
+     * Bundle url reference to a Tekton Bundle.<br><p> <br><p> Deprecated: Please use ResolverRef with the bundles resolver instead. The field is staying there for go client backward compatibility, but is not used/allowed anymore.
+     */
     @JsonProperty("bundle")
     public void setBundle(String bundle) {
         this.bundle = bundle;
     }
 
+    /**
+     * Name of the referent; More info: http://kubernetes.io/docs/user-guide/identifiers#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referent; More info: http://kubernetes.io/docs/user-guide/identifiers#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineResourceBinding.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineResourceBinding.java
index 9beadcd8fe9..8a4ea37f7f8 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineResourceBinding.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineResourceBinding.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineResourceBinding connects a reference to an instance of a PipelineResource with a PipelineResource dependency that the Pipeline has declared<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,31 +90,49 @@ public PipelineResourceBinding(String name, PipelineResourceRef resourceRef, Pip
         this.resourceSpec = resourceSpec;
     }
 
+    /**
+     * Name is the name of the PipelineResource in the Pipeline's declaration
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the PipelineResource in the Pipeline's declaration
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * PipelineResourceBinding connects a reference to an instance of a PipelineResource with a PipelineResource dependency that the Pipeline has declared<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("resourceRef")
     public PipelineResourceRef getResourceRef() {
         return resourceRef;
     }
 
+    /**
+     * PipelineResourceBinding connects a reference to an instance of a PipelineResource with a PipelineResource dependency that the Pipeline has declared<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("resourceRef")
     public void setResourceRef(PipelineResourceRef resourceRef) {
         this.resourceRef = resourceRef;
     }
 
+    /**
+     * PipelineResourceBinding connects a reference to an instance of a PipelineResource with a PipelineResource dependency that the Pipeline has declared<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("resourceSpec")
     public PipelineResourceSpec getResourceSpec() {
         return resourceSpec;
     }
 
+    /**
+     * PipelineResourceBinding connects a reference to an instance of a PipelineResource with a PipelineResource dependency that the Pipeline has declared<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("resourceSpec")
     public void setResourceSpec(PipelineResourceSpec resourceSpec) {
         this.resourceSpec = resourceSpec;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineResourceRef.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineResourceRef.java
index dc56e530e3f..e12de9f5c65 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineResourceRef.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineResourceRef.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineResourceRef can be used to refer to a specific instance of a Resource<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PipelineResourceRef(String apiVersion, String name) {
         this.name = name;
     }
 
+    /**
+     * API version of the referent
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * API version of the referent
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Name of the referent; More info: http://kubernetes.io/docs/user-guide/identifiers#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referent; More info: http://kubernetes.io/docs/user-guide/identifiers#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineResult.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineResult.java
index 662ff660d1d..13d298b211b 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineResult.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineResult.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineResult used to describe the results of a pipeline
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public PipelineResult(String description, String name, String type, ParamValue v
         this.value = value;
     }
 
+    /**
+     * Description is a human-readable description of the result
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is a human-readable description of the result
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * Name the given name
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name the given name
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Type is the user-specified type of the result. The possible types are 'string', 'array', and 'object', with 'string' as the default. 'array' and 'object' types are alpha features.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the user-specified type of the result. The possible types are 'string', 'array', and 'object', with 'string' as the default. 'array' and 'object' types are alpha features.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * PipelineResult used to describe the results of a pipeline
+     */
     @JsonProperty("value")
     public ParamValue getValue() {
         return value;
     }
 
+    /**
+     * PipelineResult used to describe the results of a pipeline
+     */
     @JsonProperty("value")
     public void setValue(ParamValue value) {
         this.value = value;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRun.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRun.java
index 3db6de30239..43f64e58555 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRun.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRun.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineRun represents a single execution of a Pipeline. PipelineRuns are how the graph of Tasks declared in a Pipeline are executed; they specify inputs to Pipelines such as parameter values and capture operational aspects of the Tasks execution such as service account and tolerations. Creating a PipelineRun creates TaskRuns for Tasks in the referenced Pipeline.<br><p> <br><p> Deprecated: Please use v1.PipelineRun instead.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class PipelineRun implements Editable<PipelineRunBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PipelineRun";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PipelineRun(String apiVersion, String kind, ObjectMeta metadata, Pipeline
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PipelineRun represents a single execution of a Pipeline. PipelineRuns are how the graph of Tasks declared in a Pipeline are executed; they specify inputs to Pipelines such as parameter values and capture operational aspects of the Tasks execution such as service account and tolerations. Creating a PipelineRun creates TaskRuns for Tasks in the referenced Pipeline.<br><p> <br><p> Deprecated: Please use v1.PipelineRun instead.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PipelineRun represents a single execution of a Pipeline. PipelineRuns are how the graph of Tasks declared in a Pipeline are executed; they specify inputs to Pipelines such as parameter values and capture operational aspects of the Tasks execution such as service account and tolerations. Creating a PipelineRun creates TaskRuns for Tasks in the referenced Pipeline.<br><p> <br><p> Deprecated: Please use v1.PipelineRun instead.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PipelineRun represents a single execution of a Pipeline. PipelineRuns are how the graph of Tasks declared in a Pipeline are executed; they specify inputs to Pipelines such as parameter values and capture operational aspects of the Tasks execution such as service account and tolerations. Creating a PipelineRun creates TaskRuns for Tasks in the referenced Pipeline.<br><p> <br><p> Deprecated: Please use v1.PipelineRun instead.
+     */
     @JsonProperty("spec")
     public PipelineRunSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PipelineRun represents a single execution of a Pipeline. PipelineRuns are how the graph of Tasks declared in a Pipeline are executed; they specify inputs to Pipelines such as parameter values and capture operational aspects of the Tasks execution such as service account and tolerations. Creating a PipelineRun creates TaskRuns for Tasks in the referenced Pipeline.<br><p> <br><p> Deprecated: Please use v1.PipelineRun instead.
+     */
     @JsonProperty("spec")
     public void setSpec(PipelineRunSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PipelineRun represents a single execution of a Pipeline. PipelineRuns are how the graph of Tasks declared in a Pipeline are executed; they specify inputs to Pipelines such as parameter values and capture operational aspects of the Tasks execution such as service account and tolerations. Creating a PipelineRun creates TaskRuns for Tasks in the referenced Pipeline.<br><p> <br><p> Deprecated: Please use v1.PipelineRun instead.
+     */
     @JsonProperty("status")
     public PipelineRunStatus getStatus() {
         return status;
     }
 
+    /**
+     * PipelineRun represents a single execution of a Pipeline. PipelineRuns are how the graph of Tasks declared in a Pipeline are executed; they specify inputs to Pipelines such as parameter values and capture operational aspects of the Tasks execution such as service account and tolerations. Creating a PipelineRun creates TaskRuns for Tasks in the referenced Pipeline.<br><p> <br><p> Deprecated: Please use v1.PipelineRun instead.
+     */
     @JsonProperty("status")
     public void setStatus(PipelineRunStatus status) {
         this.status = status;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRunList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRunList.java
index 66f9b313dd5..153f36f3bfc 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRunList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRunList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineRunList contains a list of PipelineRun
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PipelineRunList implements Editable<PipelineRunListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.v1beta1.PipelineRun>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.v1beta1.PipelineRun> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PipelineRunList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PipelineRunList(String apiVersion, List<io.fabric8.tekton.v1beta1.Pipelin
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PipelineRunList contains a list of PipelineRun
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.v1beta1.PipelineRun> getItems() {
         return items;
     }
 
+    /**
+     * PipelineRunList contains a list of PipelineRun
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.v1beta1.PipelineRun> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PipelineRunList contains a list of PipelineRun
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PipelineRunList contains a list of PipelineRun
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRunResult.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRunResult.java
index e6ea5cac90d..b98e8aac4b1 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRunResult.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRunResult.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineRunResult used to describe the results of a pipeline
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PipelineRunResult(String name, ParamValue value) {
         this.value = value;
     }
 
+    /**
+     * Name is the result's name as declared by the Pipeline
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the result's name as declared by the Pipeline
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * PipelineRunResult used to describe the results of a pipeline
+     */
     @JsonProperty("value")
     public ParamValue getValue() {
         return value;
     }
 
+    /**
+     * PipelineRunResult used to describe the results of a pipeline
+     */
     @JsonProperty("value")
     public void setValue(ParamValue value) {
         this.value = value;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRunRunStatus.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRunRunStatus.java
index 5f3fb398c42..a93ff2e1b49 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRunRunStatus.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRunRunStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineRunRunStatus contains the name of the PipelineTask for this CustomRun or Run and the CustomRun or Run's Status
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public PipelineRunRunStatus(String pipelineTaskName, CustomRunStatus status, Lis
         this.whenExpressions = whenExpressions;
     }
 
+    /**
+     * PipelineTaskName is the name of the PipelineTask.
+     */
     @JsonProperty("pipelineTaskName")
     public String getPipelineTaskName() {
         return pipelineTaskName;
     }
 
+    /**
+     * PipelineTaskName is the name of the PipelineTask.
+     */
     @JsonProperty("pipelineTaskName")
     public void setPipelineTaskName(String pipelineTaskName) {
         this.pipelineTaskName = pipelineTaskName;
     }
 
+    /**
+     * PipelineRunRunStatus contains the name of the PipelineTask for this CustomRun or Run and the CustomRun or Run's Status
+     */
     @JsonProperty("status")
     public CustomRunStatus getStatus() {
         return status;
     }
 
+    /**
+     * PipelineRunRunStatus contains the name of the PipelineTask for this CustomRun or Run and the CustomRun or Run's Status
+     */
     @JsonProperty("status")
     public void setStatus(CustomRunStatus status) {
         this.status = status;
     }
 
+    /**
+     * WhenExpressions is the list of checks guarding the execution of the PipelineTask
+     */
     @JsonProperty("whenExpressions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WhenExpression> getWhenExpressions() {
         return whenExpressions;
     }
 
+    /**
+     * WhenExpressions is the list of checks guarding the execution of the PipelineTask
+     */
     @JsonProperty("whenExpressions")
     public void setWhenExpressions(List<WhenExpression> whenExpressions) {
         this.whenExpressions = whenExpressions;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRunSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRunSpec.java
index 5d5b5c7e8cf..4c2fd7fe767 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRunSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRunSpec.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineRunSpec defines the desired state of PipelineRun
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -126,115 +129,181 @@ public PipelineRunSpec(List<Param> params, PipelineRef pipelineRef, PipelineSpec
         this.workspaces = workspaces;
     }
 
+    /**
+     * Params is a list of parameter names and values.
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Param> getParams() {
         return params;
     }
 
+    /**
+     * Params is a list of parameter names and values.
+     */
     @JsonProperty("params")
     public void setParams(List<Param> params) {
         this.params = params;
     }
 
+    /**
+     * PipelineRunSpec defines the desired state of PipelineRun
+     */
     @JsonProperty("pipelineRef")
     public PipelineRef getPipelineRef() {
         return pipelineRef;
     }
 
+    /**
+     * PipelineRunSpec defines the desired state of PipelineRun
+     */
     @JsonProperty("pipelineRef")
     public void setPipelineRef(PipelineRef pipelineRef) {
         this.pipelineRef = pipelineRef;
     }
 
+    /**
+     * PipelineRunSpec defines the desired state of PipelineRun
+     */
     @JsonProperty("pipelineSpec")
     public PipelineSpec getPipelineSpec() {
         return pipelineSpec;
     }
 
+    /**
+     * PipelineRunSpec defines the desired state of PipelineRun
+     */
     @JsonProperty("pipelineSpec")
     public void setPipelineSpec(PipelineSpec pipelineSpec) {
         this.pipelineSpec = pipelineSpec;
     }
 
+    /**
+     * PipelineRunSpec defines the desired state of PipelineRun
+     */
     @JsonProperty("podTemplate")
     public Template getPodTemplate() {
         return podTemplate;
     }
 
+    /**
+     * PipelineRunSpec defines the desired state of PipelineRun
+     */
     @JsonProperty("podTemplate")
     public void setPodTemplate(Template podTemplate) {
         this.podTemplate = podTemplate;
     }
 
+    /**
+     * Resources is a list of bindings specifying which actual instances of PipelineResources to use for the resources the Pipeline has declared it needs.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("resources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PipelineResourceBinding> getResources() {
         return resources;
     }
 
+    /**
+     * Resources is a list of bindings specifying which actual instances of PipelineResources to use for the resources the Pipeline has declared it needs.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("resources")
     public void setResources(List<PipelineResourceBinding> resources) {
         this.resources = resources;
     }
 
+    /**
+     * PipelineRunSpec defines the desired state of PipelineRun
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * PipelineRunSpec defines the desired state of PipelineRun
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * Used for cancelling a pipelinerun (and maybe more later on)
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Used for cancelling a pipelinerun (and maybe more later on)
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * TaskRunSpecs holds a set of runtime specs
+     */
     @JsonProperty("taskRunSpecs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PipelineTaskRunSpec> getTaskRunSpecs() {
         return taskRunSpecs;
     }
 
+    /**
+     * TaskRunSpecs holds a set of runtime specs
+     */
     @JsonProperty("taskRunSpecs")
     public void setTaskRunSpecs(List<PipelineTaskRunSpec> taskRunSpecs) {
         this.taskRunSpecs = taskRunSpecs;
     }
 
+    /**
+     * PipelineRunSpec defines the desired state of PipelineRun
+     */
     @JsonProperty("timeout")
     public Duration getTimeout() {
         return timeout;
     }
 
+    /**
+     * PipelineRunSpec defines the desired state of PipelineRun
+     */
     @JsonProperty("timeout")
     public void setTimeout(Duration timeout) {
         this.timeout = timeout;
     }
 
+    /**
+     * PipelineRunSpec defines the desired state of PipelineRun
+     */
     @JsonProperty("timeouts")
     public TimeoutFields getTimeouts() {
         return timeouts;
     }
 
+    /**
+     * PipelineRunSpec defines the desired state of PipelineRun
+     */
     @JsonProperty("timeouts")
     public void setTimeouts(TimeoutFields timeouts) {
         this.timeouts = timeouts;
     }
 
+    /**
+     * Workspaces holds a set of workspace bindings that must match names with those declared in the pipeline.
+     */
     @JsonProperty("workspaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WorkspaceBinding> getWorkspaces() {
         return workspaces;
     }
 
+    /**
+     * Workspaces holds a set of workspace bindings that must match names with those declared in the pipeline.
+     */
     @JsonProperty("workspaces")
     public void setWorkspaces(List<WorkspaceBinding> workspaces) {
         this.workspaces = workspaces;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRunStatus.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRunStatus.java
index 574260d904b..e416f4daed6 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRunStatus.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRunStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineRunStatus defines the observed state of PipelineRun
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -141,149 +144,233 @@ public PipelineRunStatus(Map<String, String> annotations, List<ChildStatusRefere
         this.taskRuns = taskRuns;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * list of TaskRun and Run names, PipelineTask names, and API versions/kinds for children of this PipelineRun.
+     */
     @JsonProperty("childReferences")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ChildStatusReference> getChildReferences() {
         return childReferences;
     }
 
+    /**
+     * list of TaskRun and Run names, PipelineTask names, and API versions/kinds for children of this PipelineRun.
+     */
     @JsonProperty("childReferences")
     public void setChildReferences(List<ChildStatusReference> childReferences) {
         this.childReferences = childReferences;
     }
 
+    /**
+     * PipelineRunStatus defines the observed state of PipelineRun
+     */
     @JsonProperty("completionTime")
     public String getCompletionTime() {
         return completionTime;
     }
 
+    /**
+     * PipelineRunStatus defines the observed state of PipelineRun
+     */
     @JsonProperty("completionTime")
     public void setCompletionTime(String completionTime) {
         this.completionTime = completionTime;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * PipelineRunStatus defines the observed state of PipelineRun
+     */
     @JsonProperty("finallyStartTime")
     public String getFinallyStartTime() {
         return finallyStartTime;
     }
 
+    /**
+     * PipelineRunStatus defines the observed state of PipelineRun
+     */
     @JsonProperty("finallyStartTime")
     public void setFinallyStartTime(String finallyStartTime) {
         this.finallyStartTime = finallyStartTime;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * PipelineResults are the list of results written out by the pipeline task's containers
+     */
     @JsonProperty("pipelineResults")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PipelineRunResult> getPipelineResults() {
         return pipelineResults;
     }
 
+    /**
+     * PipelineResults are the list of results written out by the pipeline task's containers
+     */
     @JsonProperty("pipelineResults")
     public void setPipelineResults(List<PipelineRunResult> pipelineResults) {
         this.pipelineResults = pipelineResults;
     }
 
+    /**
+     * PipelineRunStatus defines the observed state of PipelineRun
+     */
     @JsonProperty("pipelineSpec")
     public PipelineSpec getPipelineSpec() {
         return pipelineSpec;
     }
 
+    /**
+     * PipelineRunStatus defines the observed state of PipelineRun
+     */
     @JsonProperty("pipelineSpec")
     public void setPipelineSpec(PipelineSpec pipelineSpec) {
         this.pipelineSpec = pipelineSpec;
     }
 
+    /**
+     * PipelineRunStatus defines the observed state of PipelineRun
+     */
     @JsonProperty("provenance")
     public Provenance getProvenance() {
         return provenance;
     }
 
+    /**
+     * PipelineRunStatus defines the observed state of PipelineRun
+     */
     @JsonProperty("provenance")
     public void setProvenance(Provenance provenance) {
         this.provenance = provenance;
     }
 
+    /**
+     * Runs is a map of PipelineRunRunStatus with the run name as the key<br><p> <br><p> Deprecated: use ChildReferences instead. As of v0.45.0, this field is no longer populated and is only included for backwards compatibility with older server versions.
+     */
     @JsonProperty("runs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, PipelineRunRunStatus> getRuns() {
         return runs;
     }
 
+    /**
+     * Runs is a map of PipelineRunRunStatus with the run name as the key<br><p> <br><p> Deprecated: use ChildReferences instead. As of v0.45.0, this field is no longer populated and is only included for backwards compatibility with older server versions.
+     */
     @JsonProperty("runs")
     public void setRuns(Map<String, PipelineRunRunStatus> runs) {
         this.runs = runs;
     }
 
+    /**
+     * list of tasks that were skipped due to when expressions evaluating to false
+     */
     @JsonProperty("skippedTasks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SkippedTask> getSkippedTasks() {
         return skippedTasks;
     }
 
+    /**
+     * list of tasks that were skipped due to when expressions evaluating to false
+     */
     @JsonProperty("skippedTasks")
     public void setSkippedTasks(List<SkippedTask> skippedTasks) {
         this.skippedTasks = skippedTasks;
     }
 
+    /**
+     * SpanContext contains tracing span context fields
+     */
     @JsonProperty("spanContext")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getSpanContext() {
         return spanContext;
     }
 
+    /**
+     * SpanContext contains tracing span context fields
+     */
     @JsonProperty("spanContext")
     public void setSpanContext(Map<String, String> spanContext) {
         this.spanContext = spanContext;
     }
 
+    /**
+     * PipelineRunStatus defines the observed state of PipelineRun
+     */
     @JsonProperty("startTime")
     public String getStartTime() {
         return startTime;
     }
 
+    /**
+     * PipelineRunStatus defines the observed state of PipelineRun
+     */
     @JsonProperty("startTime")
     public void setStartTime(String startTime) {
         this.startTime = startTime;
     }
 
+    /**
+     * TaskRuns is a map of PipelineRunTaskRunStatus with the taskRun name as the key.<br><p> <br><p> Deprecated: use ChildReferences instead. As of v0.45.0, this field is no longer populated and is only included for backwards compatibility with older server versions.
+     */
     @JsonProperty("taskRuns")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, PipelineRunTaskRunStatus> getTaskRuns() {
         return taskRuns;
     }
 
+    /**
+     * TaskRuns is a map of PipelineRunTaskRunStatus with the taskRun name as the key.<br><p> <br><p> Deprecated: use ChildReferences instead. As of v0.45.0, this field is no longer populated and is only included for backwards compatibility with older server versions.
+     */
     @JsonProperty("taskRuns")
     public void setTaskRuns(Map<String, PipelineRunTaskRunStatus> taskRuns) {
         this.taskRuns = taskRuns;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRunStatusFields.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRunStatusFields.java
index 319a1959ec1..369f130b473 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRunStatusFields.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRunStatusFields.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineRunStatusFields holds the fields of PipelineRunStatus' status. This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -126,117 +129,183 @@ public PipelineRunStatusFields(List<ChildStatusReference> childReferences, Strin
         this.taskRuns = taskRuns;
     }
 
+    /**
+     * list of TaskRun and Run names, PipelineTask names, and API versions/kinds for children of this PipelineRun.
+     */
     @JsonProperty("childReferences")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ChildStatusReference> getChildReferences() {
         return childReferences;
     }
 
+    /**
+     * list of TaskRun and Run names, PipelineTask names, and API versions/kinds for children of this PipelineRun.
+     */
     @JsonProperty("childReferences")
     public void setChildReferences(List<ChildStatusReference> childReferences) {
         this.childReferences = childReferences;
     }
 
+    /**
+     * PipelineRunStatusFields holds the fields of PipelineRunStatus' status. This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("completionTime")
     public String getCompletionTime() {
         return completionTime;
     }
 
+    /**
+     * PipelineRunStatusFields holds the fields of PipelineRunStatus' status. This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("completionTime")
     public void setCompletionTime(String completionTime) {
         this.completionTime = completionTime;
     }
 
+    /**
+     * PipelineRunStatusFields holds the fields of PipelineRunStatus' status. This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("finallyStartTime")
     public String getFinallyStartTime() {
         return finallyStartTime;
     }
 
+    /**
+     * PipelineRunStatusFields holds the fields of PipelineRunStatus' status. This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("finallyStartTime")
     public void setFinallyStartTime(String finallyStartTime) {
         this.finallyStartTime = finallyStartTime;
     }
 
+    /**
+     * PipelineResults are the list of results written out by the pipeline task's containers
+     */
     @JsonProperty("pipelineResults")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PipelineRunResult> getPipelineResults() {
         return pipelineResults;
     }
 
+    /**
+     * PipelineResults are the list of results written out by the pipeline task's containers
+     */
     @JsonProperty("pipelineResults")
     public void setPipelineResults(List<PipelineRunResult> pipelineResults) {
         this.pipelineResults = pipelineResults;
     }
 
+    /**
+     * PipelineRunStatusFields holds the fields of PipelineRunStatus' status. This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("pipelineSpec")
     public PipelineSpec getPipelineSpec() {
         return pipelineSpec;
     }
 
+    /**
+     * PipelineRunStatusFields holds the fields of PipelineRunStatus' status. This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("pipelineSpec")
     public void setPipelineSpec(PipelineSpec pipelineSpec) {
         this.pipelineSpec = pipelineSpec;
     }
 
+    /**
+     * PipelineRunStatusFields holds the fields of PipelineRunStatus' status. This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("provenance")
     public Provenance getProvenance() {
         return provenance;
     }
 
+    /**
+     * PipelineRunStatusFields holds the fields of PipelineRunStatus' status. This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("provenance")
     public void setProvenance(Provenance provenance) {
         this.provenance = provenance;
     }
 
+    /**
+     * Runs is a map of PipelineRunRunStatus with the run name as the key<br><p> <br><p> Deprecated: use ChildReferences instead. As of v0.45.0, this field is no longer populated and is only included for backwards compatibility with older server versions.
+     */
     @JsonProperty("runs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, PipelineRunRunStatus> getRuns() {
         return runs;
     }
 
+    /**
+     * Runs is a map of PipelineRunRunStatus with the run name as the key<br><p> <br><p> Deprecated: use ChildReferences instead. As of v0.45.0, this field is no longer populated and is only included for backwards compatibility with older server versions.
+     */
     @JsonProperty("runs")
     public void setRuns(Map<String, PipelineRunRunStatus> runs) {
         this.runs = runs;
     }
 
+    /**
+     * list of tasks that were skipped due to when expressions evaluating to false
+     */
     @JsonProperty("skippedTasks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SkippedTask> getSkippedTasks() {
         return skippedTasks;
     }
 
+    /**
+     * list of tasks that were skipped due to when expressions evaluating to false
+     */
     @JsonProperty("skippedTasks")
     public void setSkippedTasks(List<SkippedTask> skippedTasks) {
         this.skippedTasks = skippedTasks;
     }
 
+    /**
+     * SpanContext contains tracing span context fields
+     */
     @JsonProperty("spanContext")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getSpanContext() {
         return spanContext;
     }
 
+    /**
+     * SpanContext contains tracing span context fields
+     */
     @JsonProperty("spanContext")
     public void setSpanContext(Map<String, String> spanContext) {
         this.spanContext = spanContext;
     }
 
+    /**
+     * PipelineRunStatusFields holds the fields of PipelineRunStatus' status. This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("startTime")
     public String getStartTime() {
         return startTime;
     }
 
+    /**
+     * PipelineRunStatusFields holds the fields of PipelineRunStatus' status. This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("startTime")
     public void setStartTime(String startTime) {
         this.startTime = startTime;
     }
 
+    /**
+     * TaskRuns is a map of PipelineRunTaskRunStatus with the taskRun name as the key.<br><p> <br><p> Deprecated: use ChildReferences instead. As of v0.45.0, this field is no longer populated and is only included for backwards compatibility with older server versions.
+     */
     @JsonProperty("taskRuns")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, PipelineRunTaskRunStatus> getTaskRuns() {
         return taskRuns;
     }
 
+    /**
+     * TaskRuns is a map of PipelineRunTaskRunStatus with the taskRun name as the key.<br><p> <br><p> Deprecated: use ChildReferences instead. As of v0.45.0, this field is no longer populated and is only included for backwards compatibility with older server versions.
+     */
     @JsonProperty("taskRuns")
     public void setTaskRuns(Map<String, PipelineRunTaskRunStatus> taskRuns) {
         this.taskRuns = taskRuns;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRunTaskRunStatus.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRunTaskRunStatus.java
index 23d3dba6afe..6e4cdf33022 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRunTaskRunStatus.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineRunTaskRunStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineRunTaskRunStatus contains the name of the PipelineTask for this TaskRun and the TaskRun's Status
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public PipelineRunTaskRunStatus(String pipelineTaskName, TaskRunStatus status, L
         this.whenExpressions = whenExpressions;
     }
 
+    /**
+     * PipelineTaskName is the name of the PipelineTask.
+     */
     @JsonProperty("pipelineTaskName")
     public String getPipelineTaskName() {
         return pipelineTaskName;
     }
 
+    /**
+     * PipelineTaskName is the name of the PipelineTask.
+     */
     @JsonProperty("pipelineTaskName")
     public void setPipelineTaskName(String pipelineTaskName) {
         this.pipelineTaskName = pipelineTaskName;
     }
 
+    /**
+     * PipelineRunTaskRunStatus contains the name of the PipelineTask for this TaskRun and the TaskRun's Status
+     */
     @JsonProperty("status")
     public TaskRunStatus getStatus() {
         return status;
     }
 
+    /**
+     * PipelineRunTaskRunStatus contains the name of the PipelineTask for this TaskRun and the TaskRun's Status
+     */
     @JsonProperty("status")
     public void setStatus(TaskRunStatus status) {
         this.status = status;
     }
 
+    /**
+     * WhenExpressions is the list of checks guarding the execution of the PipelineTask
+     */
     @JsonProperty("whenExpressions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WhenExpression> getWhenExpressions() {
         return whenExpressions;
     }
 
+    /**
+     * WhenExpressions is the list of checks guarding the execution of the PipelineTask
+     */
     @JsonProperty("whenExpressions")
     public void setWhenExpressions(List<WhenExpression> whenExpressions) {
         this.whenExpressions = whenExpressions;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineSpec.java
index cb41d5bcee1..5a8bc06cd34 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineSpec defines the desired state of Pipeline.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -114,87 +117,135 @@ public PipelineSpec(String description, String displayName, List<PipelineTask> _
         this.workspaces = workspaces;
     }
 
+    /**
+     * Description is a user-facing description of the pipeline that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is a user-facing description of the pipeline that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * DisplayName is a user-facing name of the pipeline that may be used to populate a UI.
+     */
     @JsonProperty("displayName")
     public String getDisplayName() {
         return displayName;
     }
 
+    /**
+     * DisplayName is a user-facing name of the pipeline that may be used to populate a UI.
+     */
     @JsonProperty("displayName")
     public void setDisplayName(String displayName) {
         this.displayName = displayName;
     }
 
+    /**
+     * Finally declares the list of Tasks that execute just before leaving the Pipeline i.e. either after all Tasks are finished executing successfully or after a failure which would result in ending the Pipeline
+     */
     @JsonProperty("finally")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PipelineTask> getFinally() {
         return _finally;
     }
 
+    /**
+     * Finally declares the list of Tasks that execute just before leaving the Pipeline i.e. either after all Tasks are finished executing successfully or after a failure which would result in ending the Pipeline
+     */
     @JsonProperty("finally")
     public void setFinally(List<PipelineTask> _finally) {
         this._finally = _finally;
     }
 
+    /**
+     * Params declares a list of input parameters that must be supplied when this Pipeline is run.
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ParamSpec> getParams() {
         return params;
     }
 
+    /**
+     * Params declares a list of input parameters that must be supplied when this Pipeline is run.
+     */
     @JsonProperty("params")
     public void setParams(List<ParamSpec> params) {
         this.params = params;
     }
 
+    /**
+     * Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("resources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PipelineDeclaredResource> getResources() {
         return resources;
     }
 
+    /**
+     * Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("resources")
     public void setResources(List<PipelineDeclaredResource> resources) {
         this.resources = resources;
     }
 
+    /**
+     * Results are values that this pipeline can output once run
+     */
     @JsonProperty("results")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PipelineResult> getResults() {
         return results;
     }
 
+    /**
+     * Results are values that this pipeline can output once run
+     */
     @JsonProperty("results")
     public void setResults(List<PipelineResult> results) {
         this.results = results;
     }
 
+    /**
+     * Tasks declares the graph of Tasks that execute when this Pipeline is run.
+     */
     @JsonProperty("tasks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PipelineTask> getTasks() {
         return tasks;
     }
 
+    /**
+     * Tasks declares the graph of Tasks that execute when this Pipeline is run.
+     */
     @JsonProperty("tasks")
     public void setTasks(List<PipelineTask> tasks) {
         this.tasks = tasks;
     }
 
+    /**
+     * Workspaces declares a set of named workspaces that are expected to be provided by a PipelineRun.
+     */
     @JsonProperty("workspaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PipelineWorkspaceDeclaration> getWorkspaces() {
         return workspaces;
     }
 
+    /**
+     * Workspaces declares a set of named workspaces that are expected to be provided by a PipelineRun.
+     */
     @JsonProperty("workspaces")
     public void setWorkspaces(List<PipelineWorkspaceDeclaration> workspaces) {
         this.workspaces = workspaces;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTask.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTask.java
index 630cc257367..a89cf51986d 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTask.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTask.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineTask defines a task in a Pipeline, passing inputs from both Params and from the output of previous tasks.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -145,165 +148,261 @@ public PipelineTask(String description, String displayName, Matrix matrix, Strin
         this.workspaces = workspaces;
     }
 
+    /**
+     * Description is the description of this task within the context of a Pipeline. This description may be used to populate a UI.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is the description of this task within the context of a Pipeline. This description may be used to populate a UI.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * DisplayName is the display name of this task within the context of a Pipeline. This display name may be used to populate a UI.
+     */
     @JsonProperty("displayName")
     public String getDisplayName() {
         return displayName;
     }
 
+    /**
+     * DisplayName is the display name of this task within the context of a Pipeline. This display name may be used to populate a UI.
+     */
     @JsonProperty("displayName")
     public void setDisplayName(String displayName) {
         this.displayName = displayName;
     }
 
+    /**
+     * PipelineTask defines a task in a Pipeline, passing inputs from both Params and from the output of previous tasks.
+     */
     @JsonProperty("matrix")
     public Matrix getMatrix() {
         return matrix;
     }
 
+    /**
+     * PipelineTask defines a task in a Pipeline, passing inputs from both Params and from the output of previous tasks.
+     */
     @JsonProperty("matrix")
     public void setMatrix(Matrix matrix) {
         this.matrix = matrix;
     }
 
+    /**
+     * Name is the name of this task within the context of a Pipeline. Name is used as a coordinate with the `from` and `runAfter` fields to establish the execution order of tasks relative to one another.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of this task within the context of a Pipeline. Name is used as a coordinate with the `from` and `runAfter` fields to establish the execution order of tasks relative to one another.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * OnError defines the exiting behavior of a PipelineRun on error can be set to [ continue | stopAndFail ]
+     */
     @JsonProperty("onError")
     public String getOnError() {
         return onError;
     }
 
+    /**
+     * OnError defines the exiting behavior of a PipelineRun on error can be set to [ continue | stopAndFail ]
+     */
     @JsonProperty("onError")
     public void setOnError(String onError) {
         this.onError = onError;
     }
 
+    /**
+     * Parameters declares parameters passed to this task.
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Param> getParams() {
         return params;
     }
 
+    /**
+     * Parameters declares parameters passed to this task.
+     */
     @JsonProperty("params")
     public void setParams(List<Param> params) {
         this.params = params;
     }
 
+    /**
+     * PipelineTask defines a task in a Pipeline, passing inputs from both Params and from the output of previous tasks.
+     */
     @JsonProperty("pipelineRef")
     public PipelineRef getPipelineRef() {
         return pipelineRef;
     }
 
+    /**
+     * PipelineTask defines a task in a Pipeline, passing inputs from both Params and from the output of previous tasks.
+     */
     @JsonProperty("pipelineRef")
     public void setPipelineRef(PipelineRef pipelineRef) {
         this.pipelineRef = pipelineRef;
     }
 
+    /**
+     * PipelineTask defines a task in a Pipeline, passing inputs from both Params and from the output of previous tasks.
+     */
     @JsonProperty("pipelineSpec")
     public PipelineSpec getPipelineSpec() {
         return pipelineSpec;
     }
 
+    /**
+     * PipelineTask defines a task in a Pipeline, passing inputs from both Params and from the output of previous tasks.
+     */
     @JsonProperty("pipelineSpec")
     public void setPipelineSpec(PipelineSpec pipelineSpec) {
         this.pipelineSpec = pipelineSpec;
     }
 
+    /**
+     * PipelineTask defines a task in a Pipeline, passing inputs from both Params and from the output of previous tasks.
+     */
     @JsonProperty("resources")
     public PipelineTaskResources getResources() {
         return resources;
     }
 
+    /**
+     * PipelineTask defines a task in a Pipeline, passing inputs from both Params and from the output of previous tasks.
+     */
     @JsonProperty("resources")
     public void setResources(PipelineTaskResources resources) {
         this.resources = resources;
     }
 
+    /**
+     * Retries represents how many times this task should be retried in case of task failure: ConditionSucceeded set to False
+     */
     @JsonProperty("retries")
     public Integer getRetries() {
         return retries;
     }
 
+    /**
+     * Retries represents how many times this task should be retried in case of task failure: ConditionSucceeded set to False
+     */
     @JsonProperty("retries")
     public void setRetries(Integer retries) {
         this.retries = retries;
     }
 
+    /**
+     * RunAfter is the list of PipelineTask names that should be executed before this Task executes. (Used to force a specific ordering in graph execution.)
+     */
     @JsonProperty("runAfter")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getRunAfter() {
         return runAfter;
     }
 
+    /**
+     * RunAfter is the list of PipelineTask names that should be executed before this Task executes. (Used to force a specific ordering in graph execution.)
+     */
     @JsonProperty("runAfter")
     public void setRunAfter(List<String> runAfter) {
         this.runAfter = runAfter;
     }
 
+    /**
+     * PipelineTask defines a task in a Pipeline, passing inputs from both Params and from the output of previous tasks.
+     */
     @JsonProperty("taskRef")
     public TaskRef getTaskRef() {
         return taskRef;
     }
 
+    /**
+     * PipelineTask defines a task in a Pipeline, passing inputs from both Params and from the output of previous tasks.
+     */
     @JsonProperty("taskRef")
     public void setTaskRef(TaskRef taskRef) {
         this.taskRef = taskRef;
     }
 
+    /**
+     * PipelineTask defines a task in a Pipeline, passing inputs from both Params and from the output of previous tasks.
+     */
     @JsonProperty("taskSpec")
     public EmbeddedTask getTaskSpec() {
         return taskSpec;
     }
 
+    /**
+     * PipelineTask defines a task in a Pipeline, passing inputs from both Params and from the output of previous tasks.
+     */
     @JsonProperty("taskSpec")
     public void setTaskSpec(EmbeddedTask taskSpec) {
         this.taskSpec = taskSpec;
     }
 
+    /**
+     * PipelineTask defines a task in a Pipeline, passing inputs from both Params and from the output of previous tasks.
+     */
     @JsonProperty("timeout")
     public Duration getTimeout() {
         return timeout;
     }
 
+    /**
+     * PipelineTask defines a task in a Pipeline, passing inputs from both Params and from the output of previous tasks.
+     */
     @JsonProperty("timeout")
     public void setTimeout(Duration timeout) {
         this.timeout = timeout;
     }
 
+    /**
+     * WhenExpressions is a list of when expressions that need to be true for the task to run
+     */
     @JsonProperty("when")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WhenExpression> getWhen() {
         return when;
     }
 
+    /**
+     * WhenExpressions is a list of when expressions that need to be true for the task to run
+     */
     @JsonProperty("when")
     public void setWhen(List<WhenExpression> when) {
         this.when = when;
     }
 
+    /**
+     * Workspaces maps workspaces from the pipeline spec to the workspaces declared in the Task.
+     */
     @JsonProperty("workspaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WorkspacePipelineTaskBinding> getWorkspaces() {
         return workspaces;
     }
 
+    /**
+     * Workspaces maps workspaces from the pipeline spec to the workspaces declared in the Task.
+     */
     @JsonProperty("workspaces")
     public void setWorkspaces(List<WorkspacePipelineTaskBinding> workspaces) {
         this.workspaces = workspaces;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTaskInputResource.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTaskInputResource.java
index 1af714dbf4b..57852984a2b 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTaskInputResource.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTaskInputResource.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineTaskInputResource maps the name of a declared PipelineResource input dependency in a Task to the resource in the Pipeline's DeclaredPipelineResources that should be used. This input may come from a previous task.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public PipelineTaskInputResource(List<String> from, String name, String resource
         this.resource = resource;
     }
 
+    /**
+     * From is the list of PipelineTask names that the resource has to come from. (Implies an ordering in the execution graph.)
+     */
     @JsonProperty("from")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getFrom() {
         return from;
     }
 
+    /**
+     * From is the list of PipelineTask names that the resource has to come from. (Implies an ordering in the execution graph.)
+     */
     @JsonProperty("from")
     public void setFrom(List<String> from) {
         this.from = from;
     }
 
+    /**
+     * Name is the name of the PipelineResource as declared by the Task.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the PipelineResource as declared by the Task.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Resource is the name of the DeclaredPipelineResource to use.
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * Resource is the name of the DeclaredPipelineResource to use.
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTaskMetadata.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTaskMetadata.java
index 8a2a3bc7fdc..b72f8566009 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTaskMetadata.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTaskMetadata.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineTaskMetadata contains the labels or annotations for an EmbeddedTask
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -84,23 +87,35 @@ public PipelineTaskMetadata(Map<String, String> annotations, Map<String, String>
         this.labels = labels;
     }
 
+    /**
+     * PipelineTaskMetadata contains the labels or annotations for an EmbeddedTask
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * PipelineTaskMetadata contains the labels or annotations for an EmbeddedTask
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * PipelineTaskMetadata contains the labels or annotations for an EmbeddedTask
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabels() {
         return labels;
     }
 
+    /**
+     * PipelineTaskMetadata contains the labels or annotations for an EmbeddedTask
+     */
     @JsonProperty("labels")
     public void setLabels(Map<String, String> labels) {
         this.labels = labels;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTaskOutputResource.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTaskOutputResource.java
index 603023c1c97..06f7343c389 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTaskOutputResource.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTaskOutputResource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineTaskOutputResource maps the name of a declared PipelineResource output dependency in a Task to the resource in the Pipeline's DeclaredPipelineResources that should be used.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PipelineTaskOutputResource(String name, String resource) {
         this.resource = resource;
     }
 
+    /**
+     * Name is the name of the PipelineResource as declared by the Task.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the PipelineResource as declared by the Task.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Resource is the name of the DeclaredPipelineResource to use.
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * Resource is the name of the DeclaredPipelineResource to use.
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTaskParam.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTaskParam.java
index fda4d933660..c0b58507d91 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTaskParam.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTaskParam.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineTaskParam is used to provide arbitrary string parameters to a Task.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PipelineTaskParam(String name, String value) {
         this.value = value;
     }
 
+    /**
+     * PipelineTaskParam is used to provide arbitrary string parameters to a Task.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * PipelineTaskParam is used to provide arbitrary string parameters to a Task.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * PipelineTaskParam is used to provide arbitrary string parameters to a Task.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * PipelineTaskParam is used to provide arbitrary string parameters to a Task.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTaskResources.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTaskResources.java
index f32dbf57412..e963d509238 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTaskResources.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTaskResources.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineTaskResources allows a Pipeline to declare how its DeclaredPipelineResources should be provided to a Task as its inputs and outputs.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public PipelineTaskResources(List<PipelineTaskInputResource> inputs, List<Pipeli
         this.outputs = outputs;
     }
 
+    /**
+     * Inputs holds the mapping from the PipelineResources declared in DeclaredPipelineResources to the input PipelineResources required by the Task.
+     */
     @JsonProperty("inputs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PipelineTaskInputResource> getInputs() {
         return inputs;
     }
 
+    /**
+     * Inputs holds the mapping from the PipelineResources declared in DeclaredPipelineResources to the input PipelineResources required by the Task.
+     */
     @JsonProperty("inputs")
     public void setInputs(List<PipelineTaskInputResource> inputs) {
         this.inputs = inputs;
     }
 
+    /**
+     * Outputs holds the mapping from the PipelineResources declared in DeclaredPipelineResources to the input PipelineResources required by the Task.
+     */
     @JsonProperty("outputs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PipelineTaskOutputResource> getOutputs() {
         return outputs;
     }
 
+    /**
+     * Outputs holds the mapping from the PipelineResources declared in DeclaredPipelineResources to the input PipelineResources required by the Task.
+     */
     @JsonProperty("outputs")
     public void setOutputs(List<PipelineTaskOutputResource> outputs) {
         this.outputs = outputs;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTaskRun.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTaskRun.java
index b6f29aedf26..c60be60baf5 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTaskRun.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTaskRun.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineTaskRun reports the results of running a step in the Task. Each task has the potential to succeed or fail (based on the exit code) and produces logs.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public PipelineTaskRun(String name) {
         this.name = name;
     }
 
+    /**
+     * PipelineTaskRun reports the results of running a step in the Task. Each task has the potential to succeed or fail (based on the exit code) and produces logs.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * PipelineTaskRun reports the results of running a step in the Task. Each task has the potential to succeed or fail (based on the exit code) and produces logs.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTaskRunSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTaskRunSpec.java
index d0b28aa2a8e..72e4730710f 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTaskRunSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineTaskRunSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -107,73 +110,115 @@ public PipelineTaskRunSpec(ResourceRequirements computeResources, PipelineTaskMe
         this.taskServiceAccountName = taskServiceAccountName;
     }
 
+    /**
+     * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+     */
     @JsonProperty("computeResources")
     public ResourceRequirements getComputeResources() {
         return computeResources;
     }
 
+    /**
+     * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+     */
     @JsonProperty("computeResources")
     public void setComputeResources(ResourceRequirements computeResources) {
         this.computeResources = computeResources;
     }
 
+    /**
+     * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+     */
     @JsonProperty("metadata")
     public PipelineTaskMetadata getMetadata() {
         return metadata;
     }
 
+    /**
+     * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+     */
     @JsonProperty("metadata")
     public void setMetadata(PipelineTaskMetadata metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+     */
     @JsonProperty("pipelineTaskName")
     public String getPipelineTaskName() {
         return pipelineTaskName;
     }
 
+    /**
+     * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+     */
     @JsonProperty("pipelineTaskName")
     public void setPipelineTaskName(String pipelineTaskName) {
         this.pipelineTaskName = pipelineTaskName;
     }
 
+    /**
+     * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+     */
     @JsonProperty("sidecarOverrides")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TaskRunSidecarOverride> getSidecarOverrides() {
         return sidecarOverrides;
     }
 
+    /**
+     * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+     */
     @JsonProperty("sidecarOverrides")
     public void setSidecarOverrides(List<TaskRunSidecarOverride> sidecarOverrides) {
         this.sidecarOverrides = sidecarOverrides;
     }
 
+    /**
+     * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+     */
     @JsonProperty("stepOverrides")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TaskRunStepOverride> getStepOverrides() {
         return stepOverrides;
     }
 
+    /**
+     * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+     */
     @JsonProperty("stepOverrides")
     public void setStepOverrides(List<TaskRunStepOverride> stepOverrides) {
         this.stepOverrides = stepOverrides;
     }
 
+    /**
+     * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+     */
     @JsonProperty("taskPodTemplate")
     public Template getTaskPodTemplate() {
         return taskPodTemplate;
     }
 
+    /**
+     * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+     */
     @JsonProperty("taskPodTemplate")
     public void setTaskPodTemplate(Template taskPodTemplate) {
         this.taskPodTemplate = taskPodTemplate;
     }
 
+    /**
+     * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+     */
     @JsonProperty("taskServiceAccountName")
     public String getTaskServiceAccountName() {
         return taskServiceAccountName;
     }
 
+    /**
+     * PipelineTaskRunSpec  can be used to configure specific specs for a concrete Task
+     */
     @JsonProperty("taskServiceAccountName")
     public void setTaskServiceAccountName(String taskServiceAccountName) {
         this.taskServiceAccountName = taskServiceAccountName;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineWorkspaceDeclaration.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineWorkspaceDeclaration.java
index a72bbc5ecbc..093062036de 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineWorkspaceDeclaration.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PipelineWorkspaceDeclaration.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WorkspacePipelineDeclaration creates a named slot in a Pipeline that a PipelineRun is expected to populate with a workspace binding.<br><p> <br><p> Deprecated: use PipelineWorkspaceDeclaration type instead
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public PipelineWorkspaceDeclaration(String description, String name, Boolean opt
         this.optional = optional;
     }
 
+    /**
+     * Description is a human readable string describing how the workspace will be used in the Pipeline. It can be useful to include a bit of detail about which tasks are intended to have access to the data on the workspace.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is a human readable string describing how the workspace will be used in the Pipeline. It can be useful to include a bit of detail about which tasks are intended to have access to the data on the workspace.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * Name is the name of a workspace to be provided by a PipelineRun.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of a workspace to be provided by a PipelineRun.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Optional marks a Workspace as not being required in PipelineRuns. By default this field is false and so declared workspaces are required.
+     */
     @JsonProperty("optional")
     public Boolean getOptional() {
         return optional;
     }
 
+    /**
+     * Optional marks a Workspace as not being required in PipelineRuns. By default this field is false and so declared workspaces are required.
+     */
     @JsonProperty("optional")
     public void setOptional(Boolean optional) {
         this.optional = optional;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PropertySpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PropertySpec.java
index 545e8fbf73e..483f67f8665 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PropertySpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/PropertySpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PropertySpec defines the struct for object keys
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public PropertySpec(String type) {
         this.type = type;
     }
 
+    /**
+     * PropertySpec defines the struct for object keys
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * PropertySpec defines the struct for object keys
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Provenance.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Provenance.java
index 591140a67bb..3fcb743ef76 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Provenance.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Provenance.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Provenance contains metadata about resources used in the TaskRun/PipelineRun such as the source from where a remote build definition was fetched. This field aims to carry minimum amoumt of metadata in &#42;Run status so that Tekton Chains can capture them in the provenance.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,31 +90,49 @@ public Provenance(ConfigSource configSource, FeatureFlags featureFlags, RefSourc
         this.refSource = refSource;
     }
 
+    /**
+     * Provenance contains metadata about resources used in the TaskRun/PipelineRun such as the source from where a remote build definition was fetched. This field aims to carry minimum amoumt of metadata in &#42;Run status so that Tekton Chains can capture them in the provenance.
+     */
     @JsonProperty("configSource")
     public ConfigSource getConfigSource() {
         return configSource;
     }
 
+    /**
+     * Provenance contains metadata about resources used in the TaskRun/PipelineRun such as the source from where a remote build definition was fetched. This field aims to carry minimum amoumt of metadata in &#42;Run status so that Tekton Chains can capture them in the provenance.
+     */
     @JsonProperty("configSource")
     public void setConfigSource(ConfigSource configSource) {
         this.configSource = configSource;
     }
 
+    /**
+     * Provenance contains metadata about resources used in the TaskRun/PipelineRun such as the source from where a remote build definition was fetched. This field aims to carry minimum amoumt of metadata in &#42;Run status so that Tekton Chains can capture them in the provenance.
+     */
     @JsonProperty("featureFlags")
     public FeatureFlags getFeatureFlags() {
         return featureFlags;
     }
 
+    /**
+     * Provenance contains metadata about resources used in the TaskRun/PipelineRun such as the source from where a remote build definition was fetched. This field aims to carry minimum amoumt of metadata in &#42;Run status so that Tekton Chains can capture them in the provenance.
+     */
     @JsonProperty("featureFlags")
     public void setFeatureFlags(FeatureFlags featureFlags) {
         this.featureFlags = featureFlags;
     }
 
+    /**
+     * Provenance contains metadata about resources used in the TaskRun/PipelineRun such as the source from where a remote build definition was fetched. This field aims to carry minimum amoumt of metadata in &#42;Run status so that Tekton Chains can capture them in the provenance.
+     */
     @JsonProperty("refSource")
     public RefSource getRefSource() {
         return refSource;
     }
 
+    /**
+     * Provenance contains metadata about resources used in the TaskRun/PipelineRun such as the source from where a remote build definition was fetched. This field aims to carry minimum amoumt of metadata in &#42;Run status so that Tekton Chains can capture them in the provenance.
+     */
     @JsonProperty("refSource")
     public void setRefSource(RefSource refSource) {
         this.refSource = refSource;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Ref.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Ref.java
index f4fff904502..f876cffd666 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Ref.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Ref.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Ref can be used to refer to a specific instance of a StepAction.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public Ref(String name) {
         this.name = name;
     }
 
+    /**
+     * Name of the referenced step
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referenced step
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/RefSource.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/RefSource.java
index 0c4647121d9..b32e8385ecf 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/RefSource.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/RefSource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RefSource contains the information that can uniquely identify where a remote built definition came from i.e. Git repositories, Tekton Bundles in OCI registry and hub.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,32 +90,50 @@ public RefSource(Map<String, String> digest, String entryPoint, String uri) {
         this.uri = uri;
     }
 
+    /**
+     * Digest is a collection of cryptographic digests for the contents of the artifact specified by URI. Example: {"sha1": "f99d13e554ffcb696dee719fa85b695cb5b0f428"}
+     */
     @JsonProperty("digest")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getDigest() {
         return digest;
     }
 
+    /**
+     * Digest is a collection of cryptographic digests for the contents of the artifact specified by URI. Example: {"sha1": "f99d13e554ffcb696dee719fa85b695cb5b0f428"}
+     */
     @JsonProperty("digest")
     public void setDigest(Map<String, String> digest) {
         this.digest = digest;
     }
 
+    /**
+     * EntryPoint identifies the entry point into the build. This is often a path to a build definition file and/or a target label within that file. Example: "task/git-clone/0.8/git-clone.yaml"
+     */
     @JsonProperty("entryPoint")
     public String getEntryPoint() {
         return entryPoint;
     }
 
+    /**
+     * EntryPoint identifies the entry point into the build. This is often a path to a build definition file and/or a target label within that file. Example: "task/git-clone/0.8/git-clone.yaml"
+     */
     @JsonProperty("entryPoint")
     public void setEntryPoint(String entryPoint) {
         this.entryPoint = entryPoint;
     }
 
+    /**
+     * URI indicates the identity of the source of the build definition. Example: "https://github.com/tektoncd/catalog"
+     */
     @JsonProperty("uri")
     public String getUri() {
         return uri;
     }
 
+    /**
+     * URI indicates the identity of the source of the build definition. Example: "https://github.com/tektoncd/catalog"
+     */
     @JsonProperty("uri")
     public void setUri(String uri) {
         this.uri = uri;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ResolverRef.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ResolverRef.java
index 00a45545792..1c1449094cb 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ResolverRef.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ResolverRef.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResolverRef can be used to refer to a Pipeline or Task in a remote location like a git repo.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public ResolverRef(List<Param> params, String resolver) {
         this.resolver = resolver;
     }
 
+    /**
+     * Params contains the parameters used to identify the referenced Tekton resource. Example entries might include "repo" or "path" but the set of params ultimately depends on the chosen resolver.
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Param> getParams() {
         return params;
     }
 
+    /**
+     * Params contains the parameters used to identify the referenced Tekton resource. Example entries might include "repo" or "path" but the set of params ultimately depends on the chosen resolver.
+     */
     @JsonProperty("params")
     public void setParams(List<Param> params) {
         this.params = params;
     }
 
+    /**
+     * Resolver is the name of the resolver that should perform resolution of the referenced Tekton resource, such as "git".
+     */
     @JsonProperty("resolver")
     public String getResolver() {
         return resolver;
     }
 
+    /**
+     * Resolver is the name of the resolver that should perform resolution of the referenced Tekton resource, such as "git".
+     */
     @JsonProperty("resolver")
     public void setResolver(String resolver) {
         this.resolver = resolver;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ResultRef.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ResultRef.java
index 4f24760a5b1..13b5aab990c 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ResultRef.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/ResultRef.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResultRef is a type that represents a reference to a task run result
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ResultRef(String pipelineTask, String property, String result, Integer re
         this.resultsIndex = resultsIndex;
     }
 
+    /**
+     * ResultRef is a type that represents a reference to a task run result
+     */
     @JsonProperty("pipelineTask")
     public String getPipelineTask() {
         return pipelineTask;
     }
 
+    /**
+     * ResultRef is a type that represents a reference to a task run result
+     */
     @JsonProperty("pipelineTask")
     public void setPipelineTask(String pipelineTask) {
         this.pipelineTask = pipelineTask;
     }
 
+    /**
+     * ResultRef is a type that represents a reference to a task run result
+     */
     @JsonProperty("property")
     public String getProperty() {
         return property;
     }
 
+    /**
+     * ResultRef is a type that represents a reference to a task run result
+     */
     @JsonProperty("property")
     public void setProperty(String property) {
         this.property = property;
     }
 
+    /**
+     * ResultRef is a type that represents a reference to a task run result
+     */
     @JsonProperty("result")
     public String getResult() {
         return result;
     }
 
+    /**
+     * ResultRef is a type that represents a reference to a task run result
+     */
     @JsonProperty("result")
     public void setResult(String result) {
         this.result = result;
     }
 
+    /**
+     * ResultRef is a type that represents a reference to a task run result
+     */
     @JsonProperty("resultsIndex")
     public Integer getResultsIndex() {
         return resultsIndex;
     }
 
+    /**
+     * ResultRef is a type that represents a reference to a task run result
+     */
     @JsonProperty("resultsIndex")
     public void setResultsIndex(Integer resultsIndex) {
         this.resultsIndex = resultsIndex;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Sidecar.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Sidecar.java
index 1bdd8e9da84..741a0183678 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Sidecar.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Sidecar.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Sidecar has nearly the same data structure as Step but does not have the ability to timeout.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -189,259 +192,409 @@ public Sidecar(List<String> args, List<String> command, List<EnvVar> env, List<E
         this.workspaces = workspaces;
     }
 
+    /**
+     * Arguments to the entrypoint. The image's CMD is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("args")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getArgs() {
         return args;
     }
 
+    /**
+     * Arguments to the entrypoint. The image's CMD is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("args")
     public void setArgs(List<String> args) {
         this.args = args;
     }
 
+    /**
+     * Entrypoint array. Not executed within a shell. The image's ENTRYPOINT is used if this is not provided. Variable references $(VAR_NAME) are expanded using the Sidecar's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("command")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCommand() {
         return command;
     }
 
+    /**
+     * Entrypoint array. Not executed within a shell. The image's ENTRYPOINT is used if this is not provided. Variable references $(VAR_NAME) are expanded using the Sidecar's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("command")
     public void setCommand(List<String> command) {
         this.command = command;
     }
 
+    /**
+     * List of environment variables to set in the Sidecar. Cannot be updated.
+     */
     @JsonProperty("env")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvVar> getEnv() {
         return env;
     }
 
+    /**
+     * List of environment variables to set in the Sidecar. Cannot be updated.
+     */
     @JsonProperty("env")
     public void setEnv(List<EnvVar> env) {
         this.env = env;
     }
 
+    /**
+     * List of sources to populate environment variables in the Sidecar. The keys defined within a source must be a C_IDENTIFIER. All invalid keys will be reported as an event when the Sidecar is starting. When a key exists in multiple sources, the value associated with the last source will take precedence. Values defined by an Env with a duplicate key will take precedence. Cannot be updated.
+     */
     @JsonProperty("envFrom")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvFromSource> getEnvFrom() {
         return envFrom;
     }
 
+    /**
+     * List of sources to populate environment variables in the Sidecar. The keys defined within a source must be a C_IDENTIFIER. All invalid keys will be reported as an event when the Sidecar is starting. When a key exists in multiple sources, the value associated with the last source will take precedence. Values defined by an Env with a duplicate key will take precedence. Cannot be updated.
+     */
     @JsonProperty("envFrom")
     public void setEnvFrom(List<EnvFromSource> envFrom) {
         this.envFrom = envFrom;
     }
 
+    /**
+     * Image name to be used by the Sidecar. More info: https://kubernetes.io/docs/concepts/containers/images
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * Image name to be used by the Sidecar. More info: https://kubernetes.io/docs/concepts/containers/images
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
     }
 
+    /**
+     * Image pull policy. One of Always, Never, IfNotPresent. Defaults to Always if :latest tag is specified, or IfNotPresent otherwise. Cannot be updated. More info: https://kubernetes.io/docs/concepts/containers/images#updating-images
+     */
     @JsonProperty("imagePullPolicy")
     public String getImagePullPolicy() {
         return imagePullPolicy;
     }
 
+    /**
+     * Image pull policy. One of Always, Never, IfNotPresent. Defaults to Always if :latest tag is specified, or IfNotPresent otherwise. Cannot be updated. More info: https://kubernetes.io/docs/concepts/containers/images#updating-images
+     */
     @JsonProperty("imagePullPolicy")
     public void setImagePullPolicy(String imagePullPolicy) {
         this.imagePullPolicy = imagePullPolicy;
     }
 
+    /**
+     * Sidecar has nearly the same data structure as Step but does not have the ability to timeout.
+     */
     @JsonProperty("lifecycle")
     public Lifecycle getLifecycle() {
         return lifecycle;
     }
 
+    /**
+     * Sidecar has nearly the same data structure as Step but does not have the ability to timeout.
+     */
     @JsonProperty("lifecycle")
     public void setLifecycle(Lifecycle lifecycle) {
         this.lifecycle = lifecycle;
     }
 
+    /**
+     * Sidecar has nearly the same data structure as Step but does not have the ability to timeout.
+     */
     @JsonProperty("livenessProbe")
     public Probe getLivenessProbe() {
         return livenessProbe;
     }
 
+    /**
+     * Sidecar has nearly the same data structure as Step but does not have the ability to timeout.
+     */
     @JsonProperty("livenessProbe")
     public void setLivenessProbe(Probe livenessProbe) {
         this.livenessProbe = livenessProbe;
     }
 
+    /**
+     * Name of the Sidecar specified as a DNS_LABEL. Each Sidecar in a Task must have a unique name (DNS_LABEL). Cannot be updated.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the Sidecar specified as a DNS_LABEL. Each Sidecar in a Task must have a unique name (DNS_LABEL). Cannot be updated.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * List of ports to expose from the Sidecar. Exposing a port here gives the system additional information about the network connections a container uses, but is primarily informational. Not specifying a port here DOES NOT prevent that port from being exposed. Any port which is listening on the default "0.0.0.0" address inside a container will be accessible from the network. Cannot be updated.
+     */
     @JsonProperty("ports")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ContainerPort> getPorts() {
         return ports;
     }
 
+    /**
+     * List of ports to expose from the Sidecar. Exposing a port here gives the system additional information about the network connections a container uses, but is primarily informational. Not specifying a port here DOES NOT prevent that port from being exposed. Any port which is listening on the default "0.0.0.0" address inside a container will be accessible from the network. Cannot be updated.
+     */
     @JsonProperty("ports")
     public void setPorts(List<ContainerPort> ports) {
         this.ports = ports;
     }
 
+    /**
+     * Sidecar has nearly the same data structure as Step but does not have the ability to timeout.
+     */
     @JsonProperty("readinessProbe")
     public Probe getReadinessProbe() {
         return readinessProbe;
     }
 
+    /**
+     * Sidecar has nearly the same data structure as Step but does not have the ability to timeout.
+     */
     @JsonProperty("readinessProbe")
     public void setReadinessProbe(Probe readinessProbe) {
         this.readinessProbe = readinessProbe;
     }
 
+    /**
+     * Sidecar has nearly the same data structure as Step but does not have the ability to timeout.
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * Sidecar has nearly the same data structure as Step but does not have the ability to timeout.
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * RestartPolicy refers to kubernetes RestartPolicy. It can only be set for an initContainer and must have it's policy set to "Always". It is currently left optional to help support Kubernetes versions prior to 1.29 when this feature was introduced.
+     */
     @JsonProperty("restartPolicy")
     public String getRestartPolicy() {
         return restartPolicy;
     }
 
+    /**
+     * RestartPolicy refers to kubernetes RestartPolicy. It can only be set for an initContainer and must have it's policy set to "Always". It is currently left optional to help support Kubernetes versions prior to 1.29 when this feature was introduced.
+     */
     @JsonProperty("restartPolicy")
     public void setRestartPolicy(String restartPolicy) {
         this.restartPolicy = restartPolicy;
     }
 
+    /**
+     * Script is the contents of an executable file to execute.<br><p> <br><p> If Script is not empty, the Step cannot have an Command or Args.
+     */
     @JsonProperty("script")
     public String getScript() {
         return script;
     }
 
+    /**
+     * Script is the contents of an executable file to execute.<br><p> <br><p> If Script is not empty, the Step cannot have an Command or Args.
+     */
     @JsonProperty("script")
     public void setScript(String script) {
         this.script = script;
     }
 
+    /**
+     * Sidecar has nearly the same data structure as Step but does not have the ability to timeout.
+     */
     @JsonProperty("securityContext")
     public SecurityContext getSecurityContext() {
         return securityContext;
     }
 
+    /**
+     * Sidecar has nearly the same data structure as Step but does not have the ability to timeout.
+     */
     @JsonProperty("securityContext")
     public void setSecurityContext(SecurityContext securityContext) {
         this.securityContext = securityContext;
     }
 
+    /**
+     * Sidecar has nearly the same data structure as Step but does not have the ability to timeout.
+     */
     @JsonProperty("startupProbe")
     public Probe getStartupProbe() {
         return startupProbe;
     }
 
+    /**
+     * Sidecar has nearly the same data structure as Step but does not have the ability to timeout.
+     */
     @JsonProperty("startupProbe")
     public void setStartupProbe(Probe startupProbe) {
         this.startupProbe = startupProbe;
     }
 
+    /**
+     * Whether this Sidecar should allocate a buffer for stdin in the container runtime. If this is not set, reads from stdin in the Sidecar will always result in EOF. Default is false.
+     */
     @JsonProperty("stdin")
     public Boolean getStdin() {
         return stdin;
     }
 
+    /**
+     * Whether this Sidecar should allocate a buffer for stdin in the container runtime. If this is not set, reads from stdin in the Sidecar will always result in EOF. Default is false.
+     */
     @JsonProperty("stdin")
     public void setStdin(Boolean stdin) {
         this.stdin = stdin;
     }
 
+    /**
+     * Whether the container runtime should close the stdin channel after it has been opened by a single attach. When stdin is true the stdin stream will remain open across multiple attach sessions. If stdinOnce is set to true, stdin is opened on Sidecar start, is empty until the first client attaches to stdin, and then remains open and accepts data until the client disconnects, at which time stdin is closed and remains closed until the Sidecar is restarted. If this flag is false, a container processes that reads from stdin will never receive an EOF. Default is false
+     */
     @JsonProperty("stdinOnce")
     public Boolean getStdinOnce() {
         return stdinOnce;
     }
 
+    /**
+     * Whether the container runtime should close the stdin channel after it has been opened by a single attach. When stdin is true the stdin stream will remain open across multiple attach sessions. If stdinOnce is set to true, stdin is opened on Sidecar start, is empty until the first client attaches to stdin, and then remains open and accepts data until the client disconnects, at which time stdin is closed and remains closed until the Sidecar is restarted. If this flag is false, a container processes that reads from stdin will never receive an EOF. Default is false
+     */
     @JsonProperty("stdinOnce")
     public void setStdinOnce(Boolean stdinOnce) {
         this.stdinOnce = stdinOnce;
     }
 
+    /**
+     * Optional: Path at which the file to which the Sidecar's termination message will be written is mounted into the Sidecar's filesystem. Message written is intended to be brief final status, such as an assertion failure message. Will be truncated by the node if greater than 4096 bytes. The total message length across all containers will be limited to 12kb. Defaults to /dev/termination-log. Cannot be updated.
+     */
     @JsonProperty("terminationMessagePath")
     public String getTerminationMessagePath() {
         return terminationMessagePath;
     }
 
+    /**
+     * Optional: Path at which the file to which the Sidecar's termination message will be written is mounted into the Sidecar's filesystem. Message written is intended to be brief final status, such as an assertion failure message. Will be truncated by the node if greater than 4096 bytes. The total message length across all containers will be limited to 12kb. Defaults to /dev/termination-log. Cannot be updated.
+     */
     @JsonProperty("terminationMessagePath")
     public void setTerminationMessagePath(String terminationMessagePath) {
         this.terminationMessagePath = terminationMessagePath;
     }
 
+    /**
+     * Indicate how the termination message should be populated. File will use the contents of terminationMessagePath to populate the Sidecar status message on both success and failure. FallbackToLogsOnError will use the last chunk of Sidecar log output if the termination message file is empty and the Sidecar exited with an error. The log output is limited to 2048 bytes or 80 lines, whichever is smaller. Defaults to File. Cannot be updated.
+     */
     @JsonProperty("terminationMessagePolicy")
     public String getTerminationMessagePolicy() {
         return terminationMessagePolicy;
     }
 
+    /**
+     * Indicate how the termination message should be populated. File will use the contents of terminationMessagePath to populate the Sidecar status message on both success and failure. FallbackToLogsOnError will use the last chunk of Sidecar log output if the termination message file is empty and the Sidecar exited with an error. The log output is limited to 2048 bytes or 80 lines, whichever is smaller. Defaults to File. Cannot be updated.
+     */
     @JsonProperty("terminationMessagePolicy")
     public void setTerminationMessagePolicy(String terminationMessagePolicy) {
         this.terminationMessagePolicy = terminationMessagePolicy;
     }
 
+    /**
+     * Whether this Sidecar should allocate a TTY for itself, also requires 'stdin' to be true. Default is false.
+     */
     @JsonProperty("tty")
     public Boolean getTty() {
         return tty;
     }
 
+    /**
+     * Whether this Sidecar should allocate a TTY for itself, also requires 'stdin' to be true. Default is false.
+     */
     @JsonProperty("tty")
     public void setTty(Boolean tty) {
         this.tty = tty;
     }
 
+    /**
+     * volumeDevices is the list of block devices to be used by the Sidecar.
+     */
     @JsonProperty("volumeDevices")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VolumeDevice> getVolumeDevices() {
         return volumeDevices;
     }
 
+    /**
+     * volumeDevices is the list of block devices to be used by the Sidecar.
+     */
     @JsonProperty("volumeDevices")
     public void setVolumeDevices(List<VolumeDevice> volumeDevices) {
         this.volumeDevices = volumeDevices;
     }
 
+    /**
+     * Volumes to mount into the Sidecar's filesystem. Cannot be updated.
+     */
     @JsonProperty("volumeMounts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VolumeMount> getVolumeMounts() {
         return volumeMounts;
     }
 
+    /**
+     * Volumes to mount into the Sidecar's filesystem. Cannot be updated.
+     */
     @JsonProperty("volumeMounts")
     public void setVolumeMounts(List<VolumeMount> volumeMounts) {
         this.volumeMounts = volumeMounts;
     }
 
+    /**
+     * Sidecar's working directory. If not specified, the container runtime's default will be used, which might be configured in the container image. Cannot be updated.
+     */
     @JsonProperty("workingDir")
     public String getWorkingDir() {
         return workingDir;
     }
 
+    /**
+     * Sidecar's working directory. If not specified, the container runtime's default will be used, which might be configured in the container image. Cannot be updated.
+     */
     @JsonProperty("workingDir")
     public void setWorkingDir(String workingDir) {
         this.workingDir = workingDir;
     }
 
+    /**
+     * This is an alpha field. You must set the "enable-api-fields" feature flag to "alpha" for this field to be supported.<br><p> <br><p> Workspaces is a list of workspaces from the Task that this Sidecar wants exclusive access to. Adding a workspace to this list means that any other Step or Sidecar that does not also request this Workspace will not have access to it.
+     */
     @JsonProperty("workspaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WorkspaceUsage> getWorkspaces() {
         return workspaces;
     }
 
+    /**
+     * This is an alpha field. You must set the "enable-api-fields" feature flag to "alpha" for this field to be supported.<br><p> <br><p> Workspaces is a list of workspaces from the Task that this Sidecar wants exclusive access to. Adding a workspace to this list means that any other Step or Sidecar that does not also request this Workspace will not have access to it.
+     */
     @JsonProperty("workspaces")
     public void setWorkspaces(List<WorkspaceUsage> workspaces) {
         this.workspaces = workspaces;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/SidecarState.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/SidecarState.java
index 7fcb77af3ea..9721f6433df 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/SidecarState.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/SidecarState.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SidecarState reports the results of running a sidecar in a Task.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,61 +104,97 @@ public SidecarState(String container, String imageID, String name, ContainerStat
         this.waiting = waiting;
     }
 
+    /**
+     * SidecarState reports the results of running a sidecar in a Task.
+     */
     @JsonProperty("container")
     public String getContainer() {
         return container;
     }
 
+    /**
+     * SidecarState reports the results of running a sidecar in a Task.
+     */
     @JsonProperty("container")
     public void setContainer(String container) {
         this.container = container;
     }
 
+    /**
+     * SidecarState reports the results of running a sidecar in a Task.
+     */
     @JsonProperty("imageID")
     public String getImageID() {
         return imageID;
     }
 
+    /**
+     * SidecarState reports the results of running a sidecar in a Task.
+     */
     @JsonProperty("imageID")
     public void setImageID(String imageID) {
         this.imageID = imageID;
     }
 
+    /**
+     * SidecarState reports the results of running a sidecar in a Task.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * SidecarState reports the results of running a sidecar in a Task.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * SidecarState reports the results of running a sidecar in a Task.
+     */
     @JsonProperty("running")
     public ContainerStateRunning getRunning() {
         return running;
     }
 
+    /**
+     * SidecarState reports the results of running a sidecar in a Task.
+     */
     @JsonProperty("running")
     public void setRunning(ContainerStateRunning running) {
         this.running = running;
     }
 
+    /**
+     * SidecarState reports the results of running a sidecar in a Task.
+     */
     @JsonProperty("terminated")
     public ContainerStateTerminated getTerminated() {
         return terminated;
     }
 
+    /**
+     * SidecarState reports the results of running a sidecar in a Task.
+     */
     @JsonProperty("terminated")
     public void setTerminated(ContainerStateTerminated terminated) {
         this.terminated = terminated;
     }
 
+    /**
+     * SidecarState reports the results of running a sidecar in a Task.
+     */
     @JsonProperty("waiting")
     public ContainerStateWaiting getWaiting() {
         return waiting;
     }
 
+    /**
+     * SidecarState reports the results of running a sidecar in a Task.
+     */
     @JsonProperty("waiting")
     public void setWaiting(ContainerStateWaiting waiting) {
         this.waiting = waiting;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/SkippedTask.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/SkippedTask.java
index 0225f231025..cc8da91a824 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/SkippedTask.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/SkippedTask.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SkippedTask is used to describe the Tasks that were skipped due to their When Expressions evaluating to False. This is a struct because we are looking into including more details about the When Expressions that caused this Task to be skipped.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public SkippedTask(String name, String reason, List<WhenExpression> whenExpressi
         this.whenExpressions = whenExpressions;
     }
 
+    /**
+     * Name is the Pipeline Task name
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the Pipeline Task name
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Reason is the cause of the PipelineTask being skipped.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason is the cause of the PipelineTask being skipped.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * WhenExpressions is the list of checks guarding the execution of the PipelineTask
+     */
     @JsonProperty("whenExpressions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WhenExpression> getWhenExpressions() {
         return whenExpressions;
     }
 
+    /**
+     * WhenExpressions is the list of checks guarding the execution of the PipelineTask
+     */
     @JsonProperty("whenExpressions")
     public void setWhenExpressions(List<WhenExpression> whenExpressions) {
         this.whenExpressions = whenExpressions;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Step.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Step.java
index 3022d9ed5ed..1b6316061d3 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Step.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Step.java
@@ -41,6 +41,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Step runs a subcomponent of a Task
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -222,332 +225,524 @@ public Step(List<String> args, List<String> command, List<EnvVar> env, List<EnvF
         this.workspaces = workspaces;
     }
 
+    /**
+     * Arguments to the entrypoint. The image's CMD is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("args")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getArgs() {
         return args;
     }
 
+    /**
+     * Arguments to the entrypoint. The image's CMD is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("args")
     public void setArgs(List<String> args) {
         this.args = args;
     }
 
+    /**
+     * Entrypoint array. Not executed within a shell. The image's ENTRYPOINT is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("command")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCommand() {
         return command;
     }
 
+    /**
+     * Entrypoint array. Not executed within a shell. The image's ENTRYPOINT is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("command")
     public void setCommand(List<String> command) {
         this.command = command;
     }
 
+    /**
+     * List of environment variables to set in the container. Cannot be updated.
+     */
     @JsonProperty("env")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvVar> getEnv() {
         return env;
     }
 
+    /**
+     * List of environment variables to set in the container. Cannot be updated.
+     */
     @JsonProperty("env")
     public void setEnv(List<EnvVar> env) {
         this.env = env;
     }
 
+    /**
+     * List of sources to populate environment variables in the container. The keys defined within a source must be a C_IDENTIFIER. All invalid keys will be reported as an event when the container is starting. When a key exists in multiple sources, the value associated with the last source will take precedence. Values defined by an Env with a duplicate key will take precedence. Cannot be updated.
+     */
     @JsonProperty("envFrom")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvFromSource> getEnvFrom() {
         return envFrom;
     }
 
+    /**
+     * List of sources to populate environment variables in the container. The keys defined within a source must be a C_IDENTIFIER. All invalid keys will be reported as an event when the container is starting. When a key exists in multiple sources, the value associated with the last source will take precedence. Values defined by an Env with a duplicate key will take precedence. Cannot be updated.
+     */
     @JsonProperty("envFrom")
     public void setEnvFrom(List<EnvFromSource> envFrom) {
         this.envFrom = envFrom;
     }
 
+    /**
+     * Image reference name to run for this Step. More info: https://kubernetes.io/docs/concepts/containers/images
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * Image reference name to run for this Step. More info: https://kubernetes.io/docs/concepts/containers/images
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
     }
 
+    /**
+     * Image pull policy. One of Always, Never, IfNotPresent. Defaults to Always if :latest tag is specified, or IfNotPresent otherwise. Cannot be updated. More info: https://kubernetes.io/docs/concepts/containers/images#updating-images
+     */
     @JsonProperty("imagePullPolicy")
     public String getImagePullPolicy() {
         return imagePullPolicy;
     }
 
+    /**
+     * Image pull policy. One of Always, Never, IfNotPresent. Defaults to Always if :latest tag is specified, or IfNotPresent otherwise. Cannot be updated. More info: https://kubernetes.io/docs/concepts/containers/images#updating-images
+     */
     @JsonProperty("imagePullPolicy")
     public void setImagePullPolicy(String imagePullPolicy) {
         this.imagePullPolicy = imagePullPolicy;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("lifecycle")
     public Lifecycle getLifecycle() {
         return lifecycle;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("lifecycle")
     public void setLifecycle(Lifecycle lifecycle) {
         this.lifecycle = lifecycle;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("livenessProbe")
     public Probe getLivenessProbe() {
         return livenessProbe;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("livenessProbe")
     public void setLivenessProbe(Probe livenessProbe) {
         this.livenessProbe = livenessProbe;
     }
 
+    /**
+     * Name of the Step specified as a DNS_LABEL. Each Step in a Task must have a unique name.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the Step specified as a DNS_LABEL. Each Step in a Task must have a unique name.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * OnError defines the exiting behavior of a container on error can be set to [ continue | stopAndFail ]
+     */
     @JsonProperty("onError")
     public String getOnError() {
         return onError;
     }
 
+    /**
+     * OnError defines the exiting behavior of a container on error can be set to [ continue | stopAndFail ]
+     */
     @JsonProperty("onError")
     public void setOnError(String onError) {
         this.onError = onError;
     }
 
+    /**
+     * Params declares parameters passed to this step action.
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Param> getParams() {
         return params;
     }
 
+    /**
+     * Params declares parameters passed to this step action.
+     */
     @JsonProperty("params")
     public void setParams(List<Param> params) {
         this.params = params;
     }
 
+    /**
+     * List of ports to expose from the Step's container. Exposing a port here gives the system additional information about the network connections a container uses, but is primarily informational. Not specifying a port here DOES NOT prevent that port from being exposed. Any port which is listening on the default "0.0.0.0" address inside a container will be accessible from the network. Cannot be updated.<br><p> <br><p> Deprecated: This field will be removed in a future release.
+     */
     @JsonProperty("ports")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ContainerPort> getPorts() {
         return ports;
     }
 
+    /**
+     * List of ports to expose from the Step's container. Exposing a port here gives the system additional information about the network connections a container uses, but is primarily informational. Not specifying a port here DOES NOT prevent that port from being exposed. Any port which is listening on the default "0.0.0.0" address inside a container will be accessible from the network. Cannot be updated.<br><p> <br><p> Deprecated: This field will be removed in a future release.
+     */
     @JsonProperty("ports")
     public void setPorts(List<ContainerPort> ports) {
         this.ports = ports;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("readinessProbe")
     public Probe getReadinessProbe() {
         return readinessProbe;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("readinessProbe")
     public void setReadinessProbe(Probe readinessProbe) {
         this.readinessProbe = readinessProbe;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("ref")
     public Ref getRef() {
         return ref;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("ref")
     public void setRef(Ref ref) {
         this.ref = ref;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * Results declares StepResults produced by the Step.<br><p> <br><p> This is field is at an ALPHA stability level and gated by "enable-step-actions" feature flag.<br><p> <br><p> It can be used in an inlined Step when used to store Results to $(step.results.resultName.path). It cannot be used when referencing StepActions using [v1beta1.Step.Ref]. The Results declared by the StepActions will be stored here instead.
+     */
     @JsonProperty("results")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<StepResult> getResults() {
         return results;
     }
 
+    /**
+     * Results declares StepResults produced by the Step.<br><p> <br><p> This is field is at an ALPHA stability level and gated by "enable-step-actions" feature flag.<br><p> <br><p> It can be used in an inlined Step when used to store Results to $(step.results.resultName.path). It cannot be used when referencing StepActions using [v1beta1.Step.Ref]. The Results declared by the StepActions will be stored here instead.
+     */
     @JsonProperty("results")
     public void setResults(List<StepResult> results) {
         this.results = results;
     }
 
+    /**
+     * Script is the contents of an executable file to execute.<br><p> <br><p> If Script is not empty, the Step cannot have an Command and the Args will be passed to the Script.
+     */
     @JsonProperty("script")
     public String getScript() {
         return script;
     }
 
+    /**
+     * Script is the contents of an executable file to execute.<br><p> <br><p> If Script is not empty, the Step cannot have an Command and the Args will be passed to the Script.
+     */
     @JsonProperty("script")
     public void setScript(String script) {
         this.script = script;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("securityContext")
     public SecurityContext getSecurityContext() {
         return securityContext;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("securityContext")
     public void setSecurityContext(SecurityContext securityContext) {
         this.securityContext = securityContext;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("startupProbe")
     public Probe getStartupProbe() {
         return startupProbe;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("startupProbe")
     public void setStartupProbe(Probe startupProbe) {
         this.startupProbe = startupProbe;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("stderrConfig")
     public StepOutputConfig getStderrConfig() {
         return stderrConfig;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("stderrConfig")
     public void setStderrConfig(StepOutputConfig stderrConfig) {
         this.stderrConfig = stderrConfig;
     }
 
+    /**
+     * Whether this container should allocate a buffer for stdin in the container runtime. If this is not set, reads from stdin in the container will always result in EOF. Default is false.<br><p> <br><p> Deprecated: This field will be removed in a future release.
+     */
     @JsonProperty("stdin")
     public Boolean getStdin() {
         return stdin;
     }
 
+    /**
+     * Whether this container should allocate a buffer for stdin in the container runtime. If this is not set, reads from stdin in the container will always result in EOF. Default is false.<br><p> <br><p> Deprecated: This field will be removed in a future release.
+     */
     @JsonProperty("stdin")
     public void setStdin(Boolean stdin) {
         this.stdin = stdin;
     }
 
+    /**
+     * Whether the container runtime should close the stdin channel after it has been opened by a single attach. When stdin is true the stdin stream will remain open across multiple attach sessions. If stdinOnce is set to true, stdin is opened on container start, is empty until the first client attaches to stdin, and then remains open and accepts data until the client disconnects, at which time stdin is closed and remains closed until the container is restarted. If this flag is false, a container processes that reads from stdin will never receive an EOF. Default is false<br><p> <br><p> Deprecated: This field will be removed in a future release.
+     */
     @JsonProperty("stdinOnce")
     public Boolean getStdinOnce() {
         return stdinOnce;
     }
 
+    /**
+     * Whether the container runtime should close the stdin channel after it has been opened by a single attach. When stdin is true the stdin stream will remain open across multiple attach sessions. If stdinOnce is set to true, stdin is opened on container start, is empty until the first client attaches to stdin, and then remains open and accepts data until the client disconnects, at which time stdin is closed and remains closed until the container is restarted. If this flag is false, a container processes that reads from stdin will never receive an EOF. Default is false<br><p> <br><p> Deprecated: This field will be removed in a future release.
+     */
     @JsonProperty("stdinOnce")
     public void setStdinOnce(Boolean stdinOnce) {
         this.stdinOnce = stdinOnce;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("stdoutConfig")
     public StepOutputConfig getStdoutConfig() {
         return stdoutConfig;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("stdoutConfig")
     public void setStdoutConfig(StepOutputConfig stdoutConfig) {
         this.stdoutConfig = stdoutConfig;
     }
 
+    /**
+     * Deprecated: This field will be removed in a future release and can't be meaningfully used.
+     */
     @JsonProperty("terminationMessagePath")
     public String getTerminationMessagePath() {
         return terminationMessagePath;
     }
 
+    /**
+     * Deprecated: This field will be removed in a future release and can't be meaningfully used.
+     */
     @JsonProperty("terminationMessagePath")
     public void setTerminationMessagePath(String terminationMessagePath) {
         this.terminationMessagePath = terminationMessagePath;
     }
 
+    /**
+     * Deprecated: This field will be removed in a future release and can't be meaningfully used.
+     */
     @JsonProperty("terminationMessagePolicy")
     public String getTerminationMessagePolicy() {
         return terminationMessagePolicy;
     }
 
+    /**
+     * Deprecated: This field will be removed in a future release and can't be meaningfully used.
+     */
     @JsonProperty("terminationMessagePolicy")
     public void setTerminationMessagePolicy(String terminationMessagePolicy) {
         this.terminationMessagePolicy = terminationMessagePolicy;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("timeout")
     public Duration getTimeout() {
         return timeout;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("timeout")
     public void setTimeout(Duration timeout) {
         this.timeout = timeout;
     }
 
+    /**
+     * Whether this container should allocate a DeprecatedTTY for itself, also requires 'stdin' to be true. Default is false.<br><p> <br><p> Deprecated: This field will be removed in a future release.
+     */
     @JsonProperty("tty")
     public Boolean getTty() {
         return tty;
     }
 
+    /**
+     * Whether this container should allocate a DeprecatedTTY for itself, also requires 'stdin' to be true. Default is false.<br><p> <br><p> Deprecated: This field will be removed in a future release.
+     */
     @JsonProperty("tty")
     public void setTty(Boolean tty) {
         this.tty = tty;
     }
 
+    /**
+     * volumeDevices is the list of block devices to be used by the Step.
+     */
     @JsonProperty("volumeDevices")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VolumeDevice> getVolumeDevices() {
         return volumeDevices;
     }
 
+    /**
+     * volumeDevices is the list of block devices to be used by the Step.
+     */
     @JsonProperty("volumeDevices")
     public void setVolumeDevices(List<VolumeDevice> volumeDevices) {
         this.volumeDevices = volumeDevices;
     }
 
+    /**
+     * Volumes to mount into the Step's filesystem. Cannot be updated.
+     */
     @JsonProperty("volumeMounts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VolumeMount> getVolumeMounts() {
         return volumeMounts;
     }
 
+    /**
+     * Volumes to mount into the Step's filesystem. Cannot be updated.
+     */
     @JsonProperty("volumeMounts")
     public void setVolumeMounts(List<VolumeMount> volumeMounts) {
         this.volumeMounts = volumeMounts;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("when")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WhenExpression> getWhen() {
         return when;
     }
 
+    /**
+     * Step runs a subcomponent of a Task
+     */
     @JsonProperty("when")
     public void setWhen(List<WhenExpression> when) {
         this.when = when;
     }
 
+    /**
+     * Step's working directory. If not specified, the container runtime's default will be used, which might be configured in the container image. Cannot be updated.
+     */
     @JsonProperty("workingDir")
     public String getWorkingDir() {
         return workingDir;
     }
 
+    /**
+     * Step's working directory. If not specified, the container runtime's default will be used, which might be configured in the container image. Cannot be updated.
+     */
     @JsonProperty("workingDir")
     public void setWorkingDir(String workingDir) {
         this.workingDir = workingDir;
     }
 
+    /**
+     * This is an alpha field. You must set the "enable-api-fields" feature flag to "alpha" for this field to be supported.<br><p> <br><p> Workspaces is a list of workspaces from the Task that this Step wants exclusive access to. Adding a workspace to this list means that any other Step or Sidecar that does not also request this Workspace will not have access to it.
+     */
     @JsonProperty("workspaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WorkspaceUsage> getWorkspaces() {
         return workspaces;
     }
 
+    /**
+     * This is an alpha field. You must set the "enable-api-fields" feature flag to "alpha" for this field to be supported.<br><p> <br><p> Workspaces is a list of workspaces from the Task that this Step wants exclusive access to. Adding a workspace to this list means that any other Step or Sidecar that does not also request this Workspace will not have access to it.
+     */
     @JsonProperty("workspaces")
     public void setWorkspaces(List<WorkspaceUsage> workspaces) {
         this.workspaces = workspaces;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/StepAction.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/StepAction.java
index ef0acf2a680..25954d062bd 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/StepAction.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/StepAction.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StepAction represents the actionable components of Step. The Step can only reference it from the cluster or using remote resolution.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class StepAction implements Editable<StepActionBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "StepAction";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public StepAction(String apiVersion, String kind, ObjectMeta metadata, StepActio
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * StepAction represents the actionable components of Step. The Step can only reference it from the cluster or using remote resolution.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * StepAction represents the actionable components of Step. The Step can only reference it from the cluster or using remote resolution.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * StepAction represents the actionable components of Step. The Step can only reference it from the cluster or using remote resolution.
+     */
     @JsonProperty("spec")
     public StepActionSpec getSpec() {
         return spec;
     }
 
+    /**
+     * StepAction represents the actionable components of Step. The Step can only reference it from the cluster or using remote resolution.
+     */
     @JsonProperty("spec")
     public void setSpec(StepActionSpec spec) {
         this.spec = spec;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/StepActionList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/StepActionList.java
index 3cb30bca951..255a4d56bc3 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/StepActionList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/StepActionList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StepActionList contains a list of StepActions
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class StepActionList implements Editable<StepActionListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.v1beta1.StepAction>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.v1beta1.StepAction> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "StepActionList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public StepActionList(String apiVersion, List<io.fabric8.tekton.v1beta1.StepActi
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * StepActionList contains a list of StepActions
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.v1beta1.StepAction> getItems() {
         return items;
     }
 
+    /**
+     * StepActionList contains a list of StepActions
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.v1beta1.StepAction> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * StepActionList contains a list of StepActions
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * StepActionList contains a list of StepActions
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/StepActionSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/StepActionSpec.java
index 9eede1fe831..2a12319eaa1 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/StepActionSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/StepActionSpec.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StepActionSpec contains the actionable components of a step.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -129,117 +132,183 @@ public StepActionSpec(List<String> args, List<String> command, String descriptio
         this.workingDir = workingDir;
     }
 
+    /**
+     * Arguments to the entrypoint. The image's CMD is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("args")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getArgs() {
         return args;
     }
 
+    /**
+     * Arguments to the entrypoint. The image's CMD is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("args")
     public void setArgs(List<String> args) {
         this.args = args;
     }
 
+    /**
+     * Entrypoint array. Not executed within a shell. The image's ENTRYPOINT is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("command")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCommand() {
         return command;
     }
 
+    /**
+     * Entrypoint array. Not executed within a shell. The image's ENTRYPOINT is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("command")
     public void setCommand(List<String> command) {
         this.command = command;
     }
 
+    /**
+     * Description is a user-facing description of the stepaction that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is a user-facing description of the stepaction that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * List of environment variables to set in the container. Cannot be updated.
+     */
     @JsonProperty("env")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvVar> getEnv() {
         return env;
     }
 
+    /**
+     * List of environment variables to set in the container. Cannot be updated.
+     */
     @JsonProperty("env")
     public void setEnv(List<EnvVar> env) {
         this.env = env;
     }
 
+    /**
+     * Image reference name to run for this StepAction. More info: https://kubernetes.io/docs/concepts/containers/images
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * Image reference name to run for this StepAction. More info: https://kubernetes.io/docs/concepts/containers/images
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
     }
 
+    /**
+     * Params is a list of input parameters required to run the stepAction. Params must be supplied as inputs in Steps unless they declare a defaultvalue.
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ParamSpec> getParams() {
         return params;
     }
 
+    /**
+     * Params is a list of input parameters required to run the stepAction. Params must be supplied as inputs in Steps unless they declare a defaultvalue.
+     */
     @JsonProperty("params")
     public void setParams(List<ParamSpec> params) {
         this.params = params;
     }
 
+    /**
+     * Results are values that this StepAction can output
+     */
     @JsonProperty("results")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<StepResult> getResults() {
         return results;
     }
 
+    /**
+     * Results are values that this StepAction can output
+     */
     @JsonProperty("results")
     public void setResults(List<StepResult> results) {
         this.results = results;
     }
 
+    /**
+     * Script is the contents of an executable file to execute.<br><p> <br><p> If Script is not empty, the Step cannot have an Command and the Args will be passed to the Script.
+     */
     @JsonProperty("script")
     public String getScript() {
         return script;
     }
 
+    /**
+     * Script is the contents of an executable file to execute.<br><p> <br><p> If Script is not empty, the Step cannot have an Command and the Args will be passed to the Script.
+     */
     @JsonProperty("script")
     public void setScript(String script) {
         this.script = script;
     }
 
+    /**
+     * StepActionSpec contains the actionable components of a step.
+     */
     @JsonProperty("securityContext")
     public SecurityContext getSecurityContext() {
         return securityContext;
     }
 
+    /**
+     * StepActionSpec contains the actionable components of a step.
+     */
     @JsonProperty("securityContext")
     public void setSecurityContext(SecurityContext securityContext) {
         this.securityContext = securityContext;
     }
 
+    /**
+     * Volumes to mount into the Step's filesystem. Cannot be updated.
+     */
     @JsonProperty("volumeMounts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VolumeMount> getVolumeMounts() {
         return volumeMounts;
     }
 
+    /**
+     * Volumes to mount into the Step's filesystem. Cannot be updated.
+     */
     @JsonProperty("volumeMounts")
     public void setVolumeMounts(List<VolumeMount> volumeMounts) {
         this.volumeMounts = volumeMounts;
     }
 
+    /**
+     * Step's working directory. If not specified, the container runtime's default will be used, which might be configured in the container image. Cannot be updated.
+     */
     @JsonProperty("workingDir")
     public String getWorkingDir() {
         return workingDir;
     }
 
+    /**
+     * Step's working directory. If not specified, the container runtime's default will be used, which might be configured in the container image. Cannot be updated.
+     */
     @JsonProperty("workingDir")
     public void setWorkingDir(String workingDir) {
         this.workingDir = workingDir;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/StepOutputConfig.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/StepOutputConfig.java
index f52b1677c2c..d2fb9442599 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/StepOutputConfig.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/StepOutputConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StepOutputConfig stores configuration for a step output stream.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public StepOutputConfig(String path) {
         this.path = path;
     }
 
+    /**
+     * Path to duplicate stdout stream to on container's local filesystem.
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Path to duplicate stdout stream to on container's local filesystem.
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/StepState.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/StepState.java
index 9f76f5e0ed1..fae34508db6 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/StepState.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/StepState.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StepState reports the results of running a step in a Task.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -122,104 +125,164 @@ public StepState(String container, String imageID, List<Artifact> inputs, String
         this.waiting = waiting;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("container")
     public String getContainer() {
         return container;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("container")
     public void setContainer(String container) {
         this.container = container;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("imageID")
     public String getImageID() {
         return imageID;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("imageID")
     public void setImageID(String imageID) {
         this.imageID = imageID;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("inputs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Artifact> getInputs() {
         return inputs;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("inputs")
     public void setInputs(List<Artifact> inputs) {
         this.inputs = inputs;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("outputs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Artifact> getOutputs() {
         return outputs;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("outputs")
     public void setOutputs(List<Artifact> outputs) {
         this.outputs = outputs;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("provenance")
     public Provenance getProvenance() {
         return provenance;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("provenance")
     public void setProvenance(Provenance provenance) {
         this.provenance = provenance;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("results")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TaskRunResult> getResults() {
         return results;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("results")
     public void setResults(List<TaskRunResult> results) {
         this.results = results;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("running")
     public ContainerStateRunning getRunning() {
         return running;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("running")
     public void setRunning(ContainerStateRunning running) {
         this.running = running;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("terminated")
     public ContainerStateTerminated getTerminated() {
         return terminated;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("terminated")
     public void setTerminated(ContainerStateTerminated terminated) {
         this.terminated = terminated;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("waiting")
     public ContainerStateWaiting getWaiting() {
         return waiting;
     }
 
+    /**
+     * StepState reports the results of running a step in a Task.
+     */
     @JsonProperty("waiting")
     public void setWaiting(ContainerStateWaiting waiting) {
         this.waiting = waiting;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/StepTemplate.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/StepTemplate.java
index 5648dd013a6..c6ea966b4c8 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/StepTemplate.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/StepTemplate.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StepTemplate is a template for a Step
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -176,228 +179,360 @@ public StepTemplate(List<String> args, List<String> command, List<EnvVar> env, L
         this.workingDir = workingDir;
     }
 
+    /**
+     * Arguments to the entrypoint. The image's CMD is used if this is not provided. Variable references $(VAR_NAME) are expanded using the Step's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("args")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getArgs() {
         return args;
     }
 
+    /**
+     * Arguments to the entrypoint. The image's CMD is used if this is not provided. Variable references $(VAR_NAME) are expanded using the Step's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("args")
     public void setArgs(List<String> args) {
         this.args = args;
     }
 
+    /**
+     * Entrypoint array. Not executed within a shell. The docker image's ENTRYPOINT is used if this is not provided. Variable references $(VAR_NAME) are expanded using the Step's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("command")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCommand() {
         return command;
     }
 
+    /**
+     * Entrypoint array. Not executed within a shell. The docker image's ENTRYPOINT is used if this is not provided. Variable references $(VAR_NAME) are expanded using the Step's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("command")
     public void setCommand(List<String> command) {
         this.command = command;
     }
 
+    /**
+     * List of environment variables to set in the container. Cannot be updated.
+     */
     @JsonProperty("env")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvVar> getEnv() {
         return env;
     }
 
+    /**
+     * List of environment variables to set in the container. Cannot be updated.
+     */
     @JsonProperty("env")
     public void setEnv(List<EnvVar> env) {
         this.env = env;
     }
 
+    /**
+     * List of sources to populate environment variables in the Step. The keys defined within a source must be a C_IDENTIFIER. All invalid keys will be reported as an event when the container is starting. When a key exists in multiple sources, the value associated with the last source will take precedence. Values defined by an Env with a duplicate key will take precedence. Cannot be updated.
+     */
     @JsonProperty("envFrom")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvFromSource> getEnvFrom() {
         return envFrom;
     }
 
+    /**
+     * List of sources to populate environment variables in the Step. The keys defined within a source must be a C_IDENTIFIER. All invalid keys will be reported as an event when the container is starting. When a key exists in multiple sources, the value associated with the last source will take precedence. Values defined by an Env with a duplicate key will take precedence. Cannot be updated.
+     */
     @JsonProperty("envFrom")
     public void setEnvFrom(List<EnvFromSource> envFrom) {
         this.envFrom = envFrom;
     }
 
+    /**
+     * Default image name to use for each Step. More info: https://kubernetes.io/docs/concepts/containers/images This field is optional to allow higher level config management to default or override container images in workload controllers like Deployments and StatefulSets.
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * Default image name to use for each Step. More info: https://kubernetes.io/docs/concepts/containers/images This field is optional to allow higher level config management to default or override container images in workload controllers like Deployments and StatefulSets.
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
     }
 
+    /**
+     * Image pull policy. One of Always, Never, IfNotPresent. Defaults to Always if :latest tag is specified, or IfNotPresent otherwise. Cannot be updated. More info: https://kubernetes.io/docs/concepts/containers/images#updating-images
+     */
     @JsonProperty("imagePullPolicy")
     public String getImagePullPolicy() {
         return imagePullPolicy;
     }
 
+    /**
+     * Image pull policy. One of Always, Never, IfNotPresent. Defaults to Always if :latest tag is specified, or IfNotPresent otherwise. Cannot be updated. More info: https://kubernetes.io/docs/concepts/containers/images#updating-images
+     */
     @JsonProperty("imagePullPolicy")
     public void setImagePullPolicy(String imagePullPolicy) {
         this.imagePullPolicy = imagePullPolicy;
     }
 
+    /**
+     * StepTemplate is a template for a Step
+     */
     @JsonProperty("lifecycle")
     public Lifecycle getLifecycle() {
         return lifecycle;
     }
 
+    /**
+     * StepTemplate is a template for a Step
+     */
     @JsonProperty("lifecycle")
     public void setLifecycle(Lifecycle lifecycle) {
         this.lifecycle = lifecycle;
     }
 
+    /**
+     * StepTemplate is a template for a Step
+     */
     @JsonProperty("livenessProbe")
     public Probe getLivenessProbe() {
         return livenessProbe;
     }
 
+    /**
+     * StepTemplate is a template for a Step
+     */
     @JsonProperty("livenessProbe")
     public void setLivenessProbe(Probe livenessProbe) {
         this.livenessProbe = livenessProbe;
     }
 
+    /**
+     * Default name for each Step specified as a DNS_LABEL. Each Step in a Task must have a unique name. Cannot be updated.<br><p> <br><p> Deprecated: This field will be removed in a future release.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Default name for each Step specified as a DNS_LABEL. Each Step in a Task must have a unique name. Cannot be updated.<br><p> <br><p> Deprecated: This field will be removed in a future release.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * List of ports to expose from the Step's container. Exposing a port here gives the system additional information about the network connections a container uses, but is primarily informational. Not specifying a port here DOES NOT prevent that port from being exposed. Any port which is listening on the default "0.0.0.0" address inside a container will be accessible from the network. Cannot be updated.<br><p> <br><p> Deprecated: This field will be removed in a future release.
+     */
     @JsonProperty("ports")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ContainerPort> getPorts() {
         return ports;
     }
 
+    /**
+     * List of ports to expose from the Step's container. Exposing a port here gives the system additional information about the network connections a container uses, but is primarily informational. Not specifying a port here DOES NOT prevent that port from being exposed. Any port which is listening on the default "0.0.0.0" address inside a container will be accessible from the network. Cannot be updated.<br><p> <br><p> Deprecated: This field will be removed in a future release.
+     */
     @JsonProperty("ports")
     public void setPorts(List<ContainerPort> ports) {
         this.ports = ports;
     }
 
+    /**
+     * StepTemplate is a template for a Step
+     */
     @JsonProperty("readinessProbe")
     public Probe getReadinessProbe() {
         return readinessProbe;
     }
 
+    /**
+     * StepTemplate is a template for a Step
+     */
     @JsonProperty("readinessProbe")
     public void setReadinessProbe(Probe readinessProbe) {
         this.readinessProbe = readinessProbe;
     }
 
+    /**
+     * StepTemplate is a template for a Step
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * StepTemplate is a template for a Step
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * StepTemplate is a template for a Step
+     */
     @JsonProperty("securityContext")
     public SecurityContext getSecurityContext() {
         return securityContext;
     }
 
+    /**
+     * StepTemplate is a template for a Step
+     */
     @JsonProperty("securityContext")
     public void setSecurityContext(SecurityContext securityContext) {
         this.securityContext = securityContext;
     }
 
+    /**
+     * StepTemplate is a template for a Step
+     */
     @JsonProperty("startupProbe")
     public Probe getStartupProbe() {
         return startupProbe;
     }
 
+    /**
+     * StepTemplate is a template for a Step
+     */
     @JsonProperty("startupProbe")
     public void setStartupProbe(Probe startupProbe) {
         this.startupProbe = startupProbe;
     }
 
+    /**
+     * Whether this Step should allocate a buffer for stdin in the container runtime. If this is not set, reads from stdin in the Step will always result in EOF. Default is false.<br><p> <br><p> Deprecated: This field will be removed in a future release.
+     */
     @JsonProperty("stdin")
     public Boolean getStdin() {
         return stdin;
     }
 
+    /**
+     * Whether this Step should allocate a buffer for stdin in the container runtime. If this is not set, reads from stdin in the Step will always result in EOF. Default is false.<br><p> <br><p> Deprecated: This field will be removed in a future release.
+     */
     @JsonProperty("stdin")
     public void setStdin(Boolean stdin) {
         this.stdin = stdin;
     }
 
+    /**
+     * Whether the container runtime should close the stdin channel after it has been opened by a single attach. When stdin is true the stdin stream will remain open across multiple attach sessions. If stdinOnce is set to true, stdin is opened on container start, is empty until the first client attaches to stdin, and then remains open and accepts data until the client disconnects, at which time stdin is closed and remains closed until the container is restarted. If this flag is false, a container processes that reads from stdin will never receive an EOF. Default is false<br><p> <br><p> Deprecated: This field will be removed in a future release.
+     */
     @JsonProperty("stdinOnce")
     public Boolean getStdinOnce() {
         return stdinOnce;
     }
 
+    /**
+     * Whether the container runtime should close the stdin channel after it has been opened by a single attach. When stdin is true the stdin stream will remain open across multiple attach sessions. If stdinOnce is set to true, stdin is opened on container start, is empty until the first client attaches to stdin, and then remains open and accepts data until the client disconnects, at which time stdin is closed and remains closed until the container is restarted. If this flag is false, a container processes that reads from stdin will never receive an EOF. Default is false<br><p> <br><p> Deprecated: This field will be removed in a future release.
+     */
     @JsonProperty("stdinOnce")
     public void setStdinOnce(Boolean stdinOnce) {
         this.stdinOnce = stdinOnce;
     }
 
+    /**
+     * Deprecated: This field will be removed in a future release and cannot be meaningfully used.
+     */
     @JsonProperty("terminationMessagePath")
     public String getTerminationMessagePath() {
         return terminationMessagePath;
     }
 
+    /**
+     * Deprecated: This field will be removed in a future release and cannot be meaningfully used.
+     */
     @JsonProperty("terminationMessagePath")
     public void setTerminationMessagePath(String terminationMessagePath) {
         this.terminationMessagePath = terminationMessagePath;
     }
 
+    /**
+     * Deprecated: This field will be removed in a future release and cannot be meaningfully used.
+     */
     @JsonProperty("terminationMessagePolicy")
     public String getTerminationMessagePolicy() {
         return terminationMessagePolicy;
     }
 
+    /**
+     * Deprecated: This field will be removed in a future release and cannot be meaningfully used.
+     */
     @JsonProperty("terminationMessagePolicy")
     public void setTerminationMessagePolicy(String terminationMessagePolicy) {
         this.terminationMessagePolicy = terminationMessagePolicy;
     }
 
+    /**
+     * Whether this Step should allocate a DeprecatedTTY for itself, also requires 'stdin' to be true. Default is false.<br><p> <br><p> Deprecated: This field will be removed in a future release.
+     */
     @JsonProperty("tty")
     public Boolean getTty() {
         return tty;
     }
 
+    /**
+     * Whether this Step should allocate a DeprecatedTTY for itself, also requires 'stdin' to be true. Default is false.<br><p> <br><p> Deprecated: This field will be removed in a future release.
+     */
     @JsonProperty("tty")
     public void setTty(Boolean tty) {
         this.tty = tty;
     }
 
+    /**
+     * volumeDevices is the list of block devices to be used by the Step.
+     */
     @JsonProperty("volumeDevices")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VolumeDevice> getVolumeDevices() {
         return volumeDevices;
     }
 
+    /**
+     * volumeDevices is the list of block devices to be used by the Step.
+     */
     @JsonProperty("volumeDevices")
     public void setVolumeDevices(List<VolumeDevice> volumeDevices) {
         this.volumeDevices = volumeDevices;
     }
 
+    /**
+     * Volumes to mount into the Step's filesystem. Cannot be updated.
+     */
     @JsonProperty("volumeMounts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VolumeMount> getVolumeMounts() {
         return volumeMounts;
     }
 
+    /**
+     * Volumes to mount into the Step's filesystem. Cannot be updated.
+     */
     @JsonProperty("volumeMounts")
     public void setVolumeMounts(List<VolumeMount> volumeMounts) {
         this.volumeMounts = volumeMounts;
     }
 
+    /**
+     * Step's working directory. If not specified, the container runtime's default will be used, which might be configured in the container image. Cannot be updated.
+     */
     @JsonProperty("workingDir")
     public String getWorkingDir() {
         return workingDir;
     }
 
+    /**
+     * Step's working directory. If not specified, the container runtime's default will be used, which might be configured in the container image. Cannot be updated.
+     */
     @JsonProperty("workingDir")
     public void setWorkingDir(String workingDir) {
         this.workingDir = workingDir;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Task.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Task.java
index d08a4016768..f0e0f22a072 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Task.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/Task.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Task represents a collection of sequential steps that are run as part of a Pipeline using a set of inputs and producing a set of outputs. Tasks execute when TaskRuns are created that provide the input parameters and resources and output resources the Task requires.<br><p> <br><p> Deprecated: Please use v1.Task instead.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Task implements Editable<TaskBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Task";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public Task(String apiVersion, String kind, ObjectMeta metadata, TaskSpec spec)
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Task represents a collection of sequential steps that are run as part of a Pipeline using a set of inputs and producing a set of outputs. Tasks execute when TaskRuns are created that provide the input parameters and resources and output resources the Task requires.<br><p> <br><p> Deprecated: Please use v1.Task instead.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Task represents a collection of sequential steps that are run as part of a Pipeline using a set of inputs and producing a set of outputs. Tasks execute when TaskRuns are created that provide the input parameters and resources and output resources the Task requires.<br><p> <br><p> Deprecated: Please use v1.Task instead.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Task represents a collection of sequential steps that are run as part of a Pipeline using a set of inputs and producing a set of outputs. Tasks execute when TaskRuns are created that provide the input parameters and resources and output resources the Task requires.<br><p> <br><p> Deprecated: Please use v1.Task instead.
+     */
     @JsonProperty("spec")
     public TaskSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Task represents a collection of sequential steps that are run as part of a Pipeline using a set of inputs and producing a set of outputs. Tasks execute when TaskRuns are created that provide the input parameters and resources and output resources the Task requires.<br><p> <br><p> Deprecated: Please use v1.Task instead.
+     */
     @JsonProperty("spec")
     public void setSpec(TaskSpec spec) {
         this.spec = spec;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskBreakpoints.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskBreakpoints.java
index 3ea2642cdb2..5eb0bedd98b 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskBreakpoints.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskBreakpoints.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskBreakpoints defines the breakpoint config for a particular Task
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public TaskBreakpoints(List<String> beforeSteps, String onFailure) {
         this.onFailure = onFailure;
     }
 
+    /**
+     * TaskBreakpoints defines the breakpoint config for a particular Task
+     */
     @JsonProperty("beforeSteps")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getBeforeSteps() {
         return beforeSteps;
     }
 
+    /**
+     * TaskBreakpoints defines the breakpoint config for a particular Task
+     */
     @JsonProperty("beforeSteps")
     public void setBeforeSteps(List<String> beforeSteps) {
         this.beforeSteps = beforeSteps;
     }
 
+    /**
+     * if enabled, pause TaskRun on failure of a step failed step will not exit
+     */
     @JsonProperty("onFailure")
     public String getOnFailure() {
         return onFailure;
     }
 
+    /**
+     * if enabled, pause TaskRun on failure of a step failed step will not exit
+     */
     @JsonProperty("onFailure")
     public void setOnFailure(String onFailure) {
         this.onFailure = onFailure;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskList.java
index e688863e9b4..1c29a480cdb 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskList contains a list of Task
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class TaskList implements Editable<TaskListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.v1beta1.Task>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.v1beta1.Task> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TaskList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TaskList(String apiVersion, List<io.fabric8.tekton.v1beta1.Task> items, S
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * TaskList contains a list of Task
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.v1beta1.Task> getItems() {
         return items;
     }
 
+    /**
+     * TaskList contains a list of Task
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.v1beta1.Task> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TaskList contains a list of Task
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TaskList contains a list of Task
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRef.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRef.java
index 6af3884d683..02dbbe7d3cf 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRef.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRef.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskRef can be used to refer to a specific instance of a task.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public TaskRef(String apiVersion, String bundle, String kind, String name) {
         this.name = name;
     }
 
+    /**
+     * API version of the referent Note: A Task with non-empty APIVersion and Kind is considered a Custom Task
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * API version of the referent Note: A Task with non-empty APIVersion and Kind is considered a Custom Task
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Bundle url reference to a Tekton Bundle.<br><p> <br><p> Deprecated: Please use ResolverRef with the bundles resolver instead. The field is staying there for go client backward compatibility, but is not used/allowed anymore.
+     */
     @JsonProperty("bundle")
     public String getBundle() {
         return bundle;
     }
 
+    /**
+     * Bundle url reference to a Tekton Bundle.<br><p> <br><p> Deprecated: Please use ResolverRef with the bundles resolver instead. The field is staying there for go client backward compatibility, but is not used/allowed anymore.
+     */
     @JsonProperty("bundle")
     public void setBundle(String bundle) {
         this.bundle = bundle;
     }
 
+    /**
+     * TaskKind indicates the Kind of the Task: 1. Namespaced Task when Kind is set to "Task". If Kind is "", it defaults to "Task". 2. Cluster-Scoped Task when Kind is set to "ClusterTask" 3. Custom Task when Kind is non-empty and APIVersion is non-empty
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * TaskKind indicates the Kind of the Task: 1. Namespaced Task when Kind is set to "Task". If Kind is "", it defaults to "Task". 2. Cluster-Scoped Task when Kind is set to "ClusterTask" 3. Custom Task when Kind is non-empty and APIVersion is non-empty
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name of the referent; More info: http://kubernetes.io/docs/user-guide/identifiers#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referent; More info: http://kubernetes.io/docs/user-guide/identifiers#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskResource.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskResource.java
index ceacdae9275..636100fcd2b 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskResource.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskResource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskResource defines an input or output Resource declared as a requirement by a Task. The Name field will be used to refer to these Resources within the Task definition, and when provided as an Input, the Name will be the path to the volume mounted containing this Resource as an input (e.g. an input Resource named `workspace` will be mounted at `/workspace`).<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public TaskResource(String description, String name, Boolean optional, String ta
         this.type = type;
     }
 
+    /**
+     * Description is a user-facing description of the declared resource that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is a user-facing description of the declared resource that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * Name declares the name by which a resource is referenced in the definition. Resources may be referenced by name in the definition of a Task's steps.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name declares the name by which a resource is referenced in the definition. Resources may be referenced by name in the definition of a Task's steps.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Optional declares the resource as optional. By default optional is set to false which makes a resource required. optional: true - the resource is considered optional optional: false - the resource is considered required (equivalent of not specifying it)
+     */
     @JsonProperty("optional")
     public Boolean getOptional() {
         return optional;
     }
 
+    /**
+     * Optional declares the resource as optional. By default optional is set to false which makes a resource required. optional: true - the resource is considered optional optional: false - the resource is considered required (equivalent of not specifying it)
+     */
     @JsonProperty("optional")
     public void setOptional(Boolean optional) {
         this.optional = optional;
     }
 
+    /**
+     * TargetPath is the path in workspace directory where the resource will be copied.
+     */
     @JsonProperty("targetPath")
     public String getTargetPath() {
         return targetPath;
     }
 
+    /**
+     * TargetPath is the path in workspace directory where the resource will be copied.
+     */
     @JsonProperty("targetPath")
     public void setTargetPath(String targetPath) {
         this.targetPath = targetPath;
     }
 
+    /**
+     * Type is the type of this resource;
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of this resource;
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskResourceBinding.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskResourceBinding.java
index b7471f90ead..12a4aeb4060 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskResourceBinding.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskResourceBinding.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskResourceBinding points to the PipelineResource that will be used for the Task input or output called Name.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,42 +97,66 @@ public TaskResourceBinding(String name, List<String> paths, PipelineResourceRef
         this.resourceSpec = resourceSpec;
     }
 
+    /**
+     * Name is the name of the PipelineResource in the Pipeline's declaration
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the PipelineResource in the Pipeline's declaration
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Paths will probably be removed in #1284, and then PipelineResourceBinding can be used instead. The optional Path field corresponds to a path on disk at which the Resource can be found (used when providing the resource via mounted volume, overriding the default logic to fetch the Resource).
+     */
     @JsonProperty("paths")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPaths() {
         return paths;
     }
 
+    /**
+     * Paths will probably be removed in #1284, and then PipelineResourceBinding can be used instead. The optional Path field corresponds to a path on disk at which the Resource can be found (used when providing the resource via mounted volume, overriding the default logic to fetch the Resource).
+     */
     @JsonProperty("paths")
     public void setPaths(List<String> paths) {
         this.paths = paths;
     }
 
+    /**
+     * TaskResourceBinding points to the PipelineResource that will be used for the Task input or output called Name.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("resourceRef")
     public PipelineResourceRef getResourceRef() {
         return resourceRef;
     }
 
+    /**
+     * TaskResourceBinding points to the PipelineResource that will be used for the Task input or output called Name.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("resourceRef")
     public void setResourceRef(PipelineResourceRef resourceRef) {
         this.resourceRef = resourceRef;
     }
 
+    /**
+     * TaskResourceBinding points to the PipelineResource that will be used for the Task input or output called Name.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("resourceSpec")
     public PipelineResourceSpec getResourceSpec() {
         return resourceSpec;
     }
 
+    /**
+     * TaskResourceBinding points to the PipelineResource that will be used for the Task input or output called Name.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("resourceSpec")
     public void setResourceSpec(PipelineResourceSpec resourceSpec) {
         this.resourceSpec = resourceSpec;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskResources.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskResources.java
index 638c870e125..fabff3f87e8 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskResources.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskResources.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskResources allows a Pipeline to declare how its DeclaredPipelineResources should be provided to a Task as its inputs and outputs.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public TaskResources(List<TaskResource> inputs, List<TaskResource> outputs) {
         this.outputs = outputs;
     }
 
+    /**
+     * Inputs holds the mapping from the PipelineResources declared in DeclaredPipelineResources to the input PipelineResources required by the Task.
+     */
     @JsonProperty("inputs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TaskResource> getInputs() {
         return inputs;
     }
 
+    /**
+     * Inputs holds the mapping from the PipelineResources declared in DeclaredPipelineResources to the input PipelineResources required by the Task.
+     */
     @JsonProperty("inputs")
     public void setInputs(List<TaskResource> inputs) {
         this.inputs = inputs;
     }
 
+    /**
+     * Outputs holds the mapping from the PipelineResources declared in DeclaredPipelineResources to the input PipelineResources required by the Task.
+     */
     @JsonProperty("outputs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TaskResource> getOutputs() {
         return outputs;
     }
 
+    /**
+     * Outputs holds the mapping from the PipelineResources declared in DeclaredPipelineResources to the input PipelineResources required by the Task.
+     */
     @JsonProperty("outputs")
     public void setOutputs(List<TaskResource> outputs) {
         this.outputs = outputs;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskResult.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskResult.java
index ec7cade1415..77322453671 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskResult.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskResult.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskResult used to describe the results of a task
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,52 +98,82 @@ public TaskResult(String description, String name, Map<String, PropertySpec> pro
         this.value = value;
     }
 
+    /**
+     * Description is a human-readable description of the result
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is a human-readable description of the result
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * Name the given name
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name the given name
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Properties is the JSON Schema properties to support key-value pairs results.
+     */
     @JsonProperty("properties")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, PropertySpec> getProperties() {
         return properties;
     }
 
+    /**
+     * Properties is the JSON Schema properties to support key-value pairs results.
+     */
     @JsonProperty("properties")
     public void setProperties(Map<String, PropertySpec> properties) {
         this.properties = properties;
     }
 
+    /**
+     * Type is the user-specified type of the result. The possible type is currently "string" and will support "array" in following work.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the user-specified type of the result. The possible type is currently "string" and will support "array" in following work.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * TaskResult used to describe the results of a task
+     */
     @JsonProperty("value")
     public ParamValue getValue() {
         return value;
     }
 
+    /**
+     * TaskResult used to describe the results of a task
+     */
     @JsonProperty("value")
     public void setValue(ParamValue value) {
         this.value = value;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRun.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRun.java
index 17939274e84..9117c6b942e 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRun.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRun.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskRun represents a single execution of a Task. TaskRuns are how the steps specified in a Task are executed; they specify the parameters and resources used to run the steps in a Task.<br><p> <br><p> Deprecated: Please use v1.TaskRun instead.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class TaskRun implements Editable<TaskRunBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TaskRun";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TaskRun(String apiVersion, String kind, ObjectMeta metadata, TaskRunSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TaskRun represents a single execution of a Task. TaskRuns are how the steps specified in a Task are executed; they specify the parameters and resources used to run the steps in a Task.<br><p> <br><p> Deprecated: Please use v1.TaskRun instead.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TaskRun represents a single execution of a Task. TaskRuns are how the steps specified in a Task are executed; they specify the parameters and resources used to run the steps in a Task.<br><p> <br><p> Deprecated: Please use v1.TaskRun instead.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * TaskRun represents a single execution of a Task. TaskRuns are how the steps specified in a Task are executed; they specify the parameters and resources used to run the steps in a Task.<br><p> <br><p> Deprecated: Please use v1.TaskRun instead.
+     */
     @JsonProperty("spec")
     public TaskRunSpec getSpec() {
         return spec;
     }
 
+    /**
+     * TaskRun represents a single execution of a Task. TaskRuns are how the steps specified in a Task are executed; they specify the parameters and resources used to run the steps in a Task.<br><p> <br><p> Deprecated: Please use v1.TaskRun instead.
+     */
     @JsonProperty("spec")
     public void setSpec(TaskRunSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * TaskRun represents a single execution of a Task. TaskRuns are how the steps specified in a Task are executed; they specify the parameters and resources used to run the steps in a Task.<br><p> <br><p> Deprecated: Please use v1.TaskRun instead.
+     */
     @JsonProperty("status")
     public TaskRunStatus getStatus() {
         return status;
     }
 
+    /**
+     * TaskRun represents a single execution of a Task. TaskRuns are how the steps specified in a Task are executed; they specify the parameters and resources used to run the steps in a Task.<br><p> <br><p> Deprecated: Please use v1.TaskRun instead.
+     */
     @JsonProperty("status")
     public void setStatus(TaskRunStatus status) {
         this.status = status;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunDebug.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunDebug.java
index 2367926c2b9..00046b354e3 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunDebug.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunDebug.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskRunDebug defines the breakpoint config for a particular TaskRun
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public TaskRunDebug(TaskBreakpoints breakpoints) {
         this.breakpoints = breakpoints;
     }
 
+    /**
+     * TaskRunDebug defines the breakpoint config for a particular TaskRun
+     */
     @JsonProperty("breakpoints")
     public TaskBreakpoints getBreakpoints() {
         return breakpoints;
     }
 
+    /**
+     * TaskRunDebug defines the breakpoint config for a particular TaskRun
+     */
     @JsonProperty("breakpoints")
     public void setBreakpoints(TaskBreakpoints breakpoints) {
         this.breakpoints = breakpoints;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunInputs.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunInputs.java
index eed4985a224..853d6a1e9aa 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunInputs.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunInputs.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskRunInputs holds the input values that this task was invoked with.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public TaskRunInputs(List<Param> params, List<TaskResourceBinding> resources) {
         this.resources = resources;
     }
 
+    /**
+     * TaskRunInputs holds the input values that this task was invoked with.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Param> getParams() {
         return params;
     }
 
+    /**
+     * TaskRunInputs holds the input values that this task was invoked with.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("params")
     public void setParams(List<Param> params) {
         this.params = params;
     }
 
+    /**
+     * TaskRunInputs holds the input values that this task was invoked with.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("resources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TaskResourceBinding> getResources() {
         return resources;
     }
 
+    /**
+     * TaskRunInputs holds the input values that this task was invoked with.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("resources")
     public void setResources(List<TaskResourceBinding> resources) {
         this.resources = resources;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunList.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunList.java
index 3fcae25997b..b83be639f6f 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunList.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskRunList contains a list of TaskRun
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class TaskRunList implements Editable<TaskRunListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.tekton.v1beta1.TaskRun>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tekton.dev/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.tekton.v1beta1.TaskRun> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TaskRunList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TaskRunList(String apiVersion, List<io.fabric8.tekton.v1beta1.TaskRun> it
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * TaskRunList contains a list of TaskRun
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.v1beta1.TaskRun> getItems() {
         return items;
     }
 
+    /**
+     * TaskRunList contains a list of TaskRun
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.tekton.v1beta1.TaskRun> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TaskRunList contains a list of TaskRun
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TaskRunList contains a list of TaskRun
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunOutputs.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunOutputs.java
index af467469d12..314771ecbee 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunOutputs.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunOutputs.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskRunOutputs holds the output values that this task was invoked with.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public TaskRunOutputs(List<TaskResourceBinding> resources) {
         this.resources = resources;
     }
 
+    /**
+     * TaskRunOutputs holds the output values that this task was invoked with.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("resources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TaskResourceBinding> getResources() {
         return resources;
     }
 
+    /**
+     * TaskRunOutputs holds the output values that this task was invoked with.<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+     */
     @JsonProperty("resources")
     public void setResources(List<TaskResourceBinding> resources) {
         this.resources = resources;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunResources.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunResources.java
index a73f31791dd..108f8e7d57e 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunResources.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunResources.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskRunResources allows a TaskRun to declare inputs and outputs TaskResourceBinding<br><p> <br><p> Deprecated: Unused, preserved only for backwards compatibility
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public TaskRunResources(List<TaskResourceBinding> inputs, List<TaskResourceBindi
         this.outputs = outputs;
     }
 
+    /**
+     * Inputs holds the inputs resources this task was invoked with
+     */
     @JsonProperty("inputs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TaskResourceBinding> getInputs() {
         return inputs;
     }
 
+    /**
+     * Inputs holds the inputs resources this task was invoked with
+     */
     @JsonProperty("inputs")
     public void setInputs(List<TaskResourceBinding> inputs) {
         this.inputs = inputs;
     }
 
+    /**
+     * Outputs holds the inputs resources this task was invoked with
+     */
     @JsonProperty("outputs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TaskResourceBinding> getOutputs() {
         return outputs;
     }
 
+    /**
+     * Outputs holds the inputs resources this task was invoked with
+     */
     @JsonProperty("outputs")
     public void setOutputs(List<TaskResourceBinding> outputs) {
         this.outputs = outputs;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunResult.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunResult.java
index de8cf70b05a..1c2e0076daf 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunResult.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunResult.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskRunStepResult is a type alias of TaskRunResult
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public TaskRunResult(String name, String type, ParamValue value) {
         this.value = value;
     }
 
+    /**
+     * Name the given name
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name the given name
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Type is the user-specified type of the result. The possible type is currently "string" and will support "array" in following work.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the user-specified type of the result. The possible type is currently "string" and will support "array" in following work.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * TaskRunStepResult is a type alias of TaskRunResult
+     */
     @JsonProperty("value")
     public ParamValue getValue() {
         return value;
     }
 
+    /**
+     * TaskRunStepResult is a type alias of TaskRunResult
+     */
     @JsonProperty("value")
     public void setValue(ParamValue value) {
         this.value = value;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunSidecarOverride.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunSidecarOverride.java
index 1f4259f9f42..9f56e0d9967 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunSidecarOverride.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunSidecarOverride.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskRunSidecarOverride is used to override the values of a Sidecar in the corresponding Task.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public TaskRunSidecarOverride(String name, ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * The name of the Sidecar to override.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The name of the Sidecar to override.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * TaskRunSidecarOverride is used to override the values of a Sidecar in the corresponding Task.
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * TaskRunSidecarOverride is used to override the values of a Sidecar in the corresponding Task.
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunSpec.java
index 36410640587..58044c3c9f7 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunSpec.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskRunSpec defines the desired state of TaskRun
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -142,155 +145,245 @@ public TaskRunSpec(ResourceRequirements computeResources, TaskRunDebug debug, Li
         this.workspaces = workspaces;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("computeResources")
     public ResourceRequirements getComputeResources() {
         return computeResources;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("computeResources")
     public void setComputeResources(ResourceRequirements computeResources) {
         this.computeResources = computeResources;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("debug")
     public TaskRunDebug getDebug() {
         return debug;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("debug")
     public void setDebug(TaskRunDebug debug) {
         this.debug = debug;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Param> getParams() {
         return params;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("params")
     public void setParams(List<Param> params) {
         this.params = params;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("podTemplate")
     public Template getPodTemplate() {
         return podTemplate;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("podTemplate")
     public void setPodTemplate(Template podTemplate) {
         this.podTemplate = podTemplate;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("resources")
     public TaskRunResources getResources() {
         return resources;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("resources")
     public void setResources(TaskRunResources resources) {
         this.resources = resources;
     }
 
+    /**
+     * Retries represents how many times this TaskRun should be retried in the event of Task failure.
+     */
     @JsonProperty("retries")
     public Integer getRetries() {
         return retries;
     }
 
+    /**
+     * Retries represents how many times this TaskRun should be retried in the event of Task failure.
+     */
     @JsonProperty("retries")
     public void setRetries(Integer retries) {
         this.retries = retries;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * Overrides to apply to Sidecars in this TaskRun. If a field is specified in both a Sidecar and a SidecarOverride, the value from the SidecarOverride will be used. This field is only supported when the alpha feature gate is enabled.
+     */
     @JsonProperty("sidecarOverrides")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TaskRunSidecarOverride> getSidecarOverrides() {
         return sidecarOverrides;
     }
 
+    /**
+     * Overrides to apply to Sidecars in this TaskRun. If a field is specified in both a Sidecar and a SidecarOverride, the value from the SidecarOverride will be used. This field is only supported when the alpha feature gate is enabled.
+     */
     @JsonProperty("sidecarOverrides")
     public void setSidecarOverrides(List<TaskRunSidecarOverride> sidecarOverrides) {
         this.sidecarOverrides = sidecarOverrides;
     }
 
+    /**
+     * Used for cancelling a TaskRun (and maybe more later on)
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Used for cancelling a TaskRun (and maybe more later on)
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Status message for cancellation.
+     */
     @JsonProperty("statusMessage")
     public String getStatusMessage() {
         return statusMessage;
     }
 
+    /**
+     * Status message for cancellation.
+     */
     @JsonProperty("statusMessage")
     public void setStatusMessage(String statusMessage) {
         this.statusMessage = statusMessage;
     }
 
+    /**
+     * Overrides to apply to Steps in this TaskRun. If a field is specified in both a Step and a StepOverride, the value from the StepOverride will be used. This field is only supported when the alpha feature gate is enabled.
+     */
     @JsonProperty("stepOverrides")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TaskRunStepOverride> getStepOverrides() {
         return stepOverrides;
     }
 
+    /**
+     * Overrides to apply to Steps in this TaskRun. If a field is specified in both a Step and a StepOverride, the value from the StepOverride will be used. This field is only supported when the alpha feature gate is enabled.
+     */
     @JsonProperty("stepOverrides")
     public void setStepOverrides(List<TaskRunStepOverride> stepOverrides) {
         this.stepOverrides = stepOverrides;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("taskRef")
     public TaskRef getTaskRef() {
         return taskRef;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("taskRef")
     public void setTaskRef(TaskRef taskRef) {
         this.taskRef = taskRef;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("taskSpec")
     public TaskSpec getTaskSpec() {
         return taskSpec;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("taskSpec")
     public void setTaskSpec(TaskSpec taskSpec) {
         this.taskSpec = taskSpec;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("timeout")
     public Duration getTimeout() {
         return timeout;
     }
 
+    /**
+     * TaskRunSpec defines the desired state of TaskRun
+     */
     @JsonProperty("timeout")
     public void setTimeout(Duration timeout) {
         this.timeout = timeout;
     }
 
+    /**
+     * Workspaces is a list of WorkspaceBindings from volumes to workspaces.
+     */
     @JsonProperty("workspaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WorkspaceBinding> getWorkspaces() {
         return workspaces;
     }
 
+    /**
+     * Workspaces is a list of WorkspaceBindings from volumes to workspaces.
+     */
     @JsonProperty("workspaces")
     public void setWorkspaces(List<WorkspaceBinding> workspaces) {
         this.workspaces = workspaces;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunStatus.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunStatus.java
index a1d3b62daff..dd3e19e69cc 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunStatus.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunStatus.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskRunStatus defines the observed state of TaskRun
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -147,160 +150,250 @@ public TaskRunStatus(Map<String, String> annotations, List<CloudEventDelivery> c
         this.taskSpec = taskSpec;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * CloudEvents describe the state of each cloud event requested via a CloudEventResource.<br><p> <br><p> Deprecated: Removed in v0.44.0.
+     */
     @JsonProperty("cloudEvents")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CloudEventDelivery> getCloudEvents() {
         return cloudEvents;
     }
 
+    /**
+     * CloudEvents describe the state of each cloud event requested via a CloudEventResource.<br><p> <br><p> Deprecated: Removed in v0.44.0.
+     */
     @JsonProperty("cloudEvents")
     public void setCloudEvents(List<CloudEventDelivery> cloudEvents) {
         this.cloudEvents = cloudEvents;
     }
 
+    /**
+     * TaskRunStatus defines the observed state of TaskRun
+     */
     @JsonProperty("completionTime")
     public String getCompletionTime() {
         return completionTime;
     }
 
+    /**
+     * TaskRunStatus defines the observed state of TaskRun
+     */
     @JsonProperty("completionTime")
     public void setCompletionTime(String completionTime) {
         this.completionTime = completionTime;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions the latest available observations of a resource's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the 'Generation' of the Service that was last processed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * PodName is the name of the pod responsible for executing this task's steps.
+     */
     @JsonProperty("podName")
     public String getPodName() {
         return podName;
     }
 
+    /**
+     * PodName is the name of the pod responsible for executing this task's steps.
+     */
     @JsonProperty("podName")
     public void setPodName(String podName) {
         this.podName = podName;
     }
 
+    /**
+     * TaskRunStatus defines the observed state of TaskRun
+     */
     @JsonProperty("provenance")
     public Provenance getProvenance() {
         return provenance;
     }
 
+    /**
+     * TaskRunStatus defines the observed state of TaskRun
+     */
     @JsonProperty("provenance")
     public void setProvenance(Provenance provenance) {
         this.provenance = provenance;
     }
 
+    /**
+     * Results from Resources built during the TaskRun. This is tomb-stoned along with the removal of pipelineResources Deprecated: this field is not populated and is preserved only for backwards compatibility
+     */
     @JsonProperty("resourcesResult")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RunResult> getResourcesResult() {
         return resourcesResult;
     }
 
+    /**
+     * Results from Resources built during the TaskRun. This is tomb-stoned along with the removal of pipelineResources Deprecated: this field is not populated and is preserved only for backwards compatibility
+     */
     @JsonProperty("resourcesResult")
     public void setResourcesResult(List<RunResult> resourcesResult) {
         this.resourcesResult = resourcesResult;
     }
 
+    /**
+     * RetriesStatus contains the history of TaskRunStatus in case of a retry in order to keep record of failures. All TaskRunStatus stored in RetriesStatus will have no date within the RetriesStatus as is redundant.
+     */
     @JsonProperty("retriesStatus")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.tekton.v1beta1.TaskRunStatus> getRetriesStatus() {
         return retriesStatus;
     }
 
+    /**
+     * RetriesStatus contains the history of TaskRunStatus in case of a retry in order to keep record of failures. All TaskRunStatus stored in RetriesStatus will have no date within the RetriesStatus as is redundant.
+     */
     @JsonProperty("retriesStatus")
     public void setRetriesStatus(List<io.fabric8.tekton.v1beta1.TaskRunStatus> retriesStatus) {
         this.retriesStatus = retriesStatus;
     }
 
+    /**
+     * The list has one entry per sidecar in the manifest. Each entry is represents the imageid of the corresponding sidecar.
+     */
     @JsonProperty("sidecars")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SidecarState> getSidecars() {
         return sidecars;
     }
 
+    /**
+     * The list has one entry per sidecar in the manifest. Each entry is represents the imageid of the corresponding sidecar.
+     */
     @JsonProperty("sidecars")
     public void setSidecars(List<SidecarState> sidecars) {
         this.sidecars = sidecars;
     }
 
+    /**
+     * SpanContext contains tracing span context fields
+     */
     @JsonProperty("spanContext")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getSpanContext() {
         return spanContext;
     }
 
+    /**
+     * SpanContext contains tracing span context fields
+     */
     @JsonProperty("spanContext")
     public void setSpanContext(Map<String, String> spanContext) {
         this.spanContext = spanContext;
     }
 
+    /**
+     * TaskRunStatus defines the observed state of TaskRun
+     */
     @JsonProperty("startTime")
     public String getStartTime() {
         return startTime;
     }
 
+    /**
+     * TaskRunStatus defines the observed state of TaskRun
+     */
     @JsonProperty("startTime")
     public void setStartTime(String startTime) {
         this.startTime = startTime;
     }
 
+    /**
+     * Steps describes the state of each build step container.
+     */
     @JsonProperty("steps")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<StepState> getSteps() {
         return steps;
     }
 
+    /**
+     * Steps describes the state of each build step container.
+     */
     @JsonProperty("steps")
     public void setSteps(List<StepState> steps) {
         this.steps = steps;
     }
 
+    /**
+     * TaskRunResults are the list of results written out by the task's containers
+     */
     @JsonProperty("taskResults")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TaskRunResult> getTaskResults() {
         return taskResults;
     }
 
+    /**
+     * TaskRunResults are the list of results written out by the task's containers
+     */
     @JsonProperty("taskResults")
     public void setTaskResults(List<TaskRunResult> taskResults) {
         this.taskResults = taskResults;
     }
 
+    /**
+     * TaskRunStatus defines the observed state of TaskRun
+     */
     @JsonProperty("taskSpec")
     public TaskSpec getTaskSpec() {
         return taskSpec;
     }
 
+    /**
+     * TaskRunStatus defines the observed state of TaskRun
+     */
     @JsonProperty("taskSpec")
     public void setTaskSpec(TaskSpec taskSpec) {
         this.taskSpec = taskSpec;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunStatusFields.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunStatusFields.java
index 6e946eebdc3..a586eb0e4b8 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunStatusFields.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunStatusFields.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskRunStatusFields holds the fields of TaskRun's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -132,128 +135,200 @@ public TaskRunStatusFields(List<CloudEventDelivery> cloudEvents, String completi
         this.taskSpec = taskSpec;
     }
 
+    /**
+     * CloudEvents describe the state of each cloud event requested via a CloudEventResource.<br><p> <br><p> Deprecated: Removed in v0.44.0.
+     */
     @JsonProperty("cloudEvents")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CloudEventDelivery> getCloudEvents() {
         return cloudEvents;
     }
 
+    /**
+     * CloudEvents describe the state of each cloud event requested via a CloudEventResource.<br><p> <br><p> Deprecated: Removed in v0.44.0.
+     */
     @JsonProperty("cloudEvents")
     public void setCloudEvents(List<CloudEventDelivery> cloudEvents) {
         this.cloudEvents = cloudEvents;
     }
 
+    /**
+     * TaskRunStatusFields holds the fields of TaskRun's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("completionTime")
     public String getCompletionTime() {
         return completionTime;
     }
 
+    /**
+     * TaskRunStatusFields holds the fields of TaskRun's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("completionTime")
     public void setCompletionTime(String completionTime) {
         this.completionTime = completionTime;
     }
 
+    /**
+     * PodName is the name of the pod responsible for executing this task's steps.
+     */
     @JsonProperty("podName")
     public String getPodName() {
         return podName;
     }
 
+    /**
+     * PodName is the name of the pod responsible for executing this task's steps.
+     */
     @JsonProperty("podName")
     public void setPodName(String podName) {
         this.podName = podName;
     }
 
+    /**
+     * TaskRunStatusFields holds the fields of TaskRun's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("provenance")
     public Provenance getProvenance() {
         return provenance;
     }
 
+    /**
+     * TaskRunStatusFields holds the fields of TaskRun's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("provenance")
     public void setProvenance(Provenance provenance) {
         this.provenance = provenance;
     }
 
+    /**
+     * Results from Resources built during the TaskRun. This is tomb-stoned along with the removal of pipelineResources Deprecated: this field is not populated and is preserved only for backwards compatibility
+     */
     @JsonProperty("resourcesResult")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RunResult> getResourcesResult() {
         return resourcesResult;
     }
 
+    /**
+     * Results from Resources built during the TaskRun. This is tomb-stoned along with the removal of pipelineResources Deprecated: this field is not populated and is preserved only for backwards compatibility
+     */
     @JsonProperty("resourcesResult")
     public void setResourcesResult(List<RunResult> resourcesResult) {
         this.resourcesResult = resourcesResult;
     }
 
+    /**
+     * RetriesStatus contains the history of TaskRunStatus in case of a retry in order to keep record of failures. All TaskRunStatus stored in RetriesStatus will have no date within the RetriesStatus as is redundant.
+     */
     @JsonProperty("retriesStatus")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TaskRunStatus> getRetriesStatus() {
         return retriesStatus;
     }
 
+    /**
+     * RetriesStatus contains the history of TaskRunStatus in case of a retry in order to keep record of failures. All TaskRunStatus stored in RetriesStatus will have no date within the RetriesStatus as is redundant.
+     */
     @JsonProperty("retriesStatus")
     public void setRetriesStatus(List<TaskRunStatus> retriesStatus) {
         this.retriesStatus = retriesStatus;
     }
 
+    /**
+     * The list has one entry per sidecar in the manifest. Each entry is represents the imageid of the corresponding sidecar.
+     */
     @JsonProperty("sidecars")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SidecarState> getSidecars() {
         return sidecars;
     }
 
+    /**
+     * The list has one entry per sidecar in the manifest. Each entry is represents the imageid of the corresponding sidecar.
+     */
     @JsonProperty("sidecars")
     public void setSidecars(List<SidecarState> sidecars) {
         this.sidecars = sidecars;
     }
 
+    /**
+     * SpanContext contains tracing span context fields
+     */
     @JsonProperty("spanContext")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getSpanContext() {
         return spanContext;
     }
 
+    /**
+     * SpanContext contains tracing span context fields
+     */
     @JsonProperty("spanContext")
     public void setSpanContext(Map<String, String> spanContext) {
         this.spanContext = spanContext;
     }
 
+    /**
+     * TaskRunStatusFields holds the fields of TaskRun's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("startTime")
     public String getStartTime() {
         return startTime;
     }
 
+    /**
+     * TaskRunStatusFields holds the fields of TaskRun's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("startTime")
     public void setStartTime(String startTime) {
         this.startTime = startTime;
     }
 
+    /**
+     * Steps describes the state of each build step container.
+     */
     @JsonProperty("steps")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<StepState> getSteps() {
         return steps;
     }
 
+    /**
+     * Steps describes the state of each build step container.
+     */
     @JsonProperty("steps")
     public void setSteps(List<StepState> steps) {
         this.steps = steps;
     }
 
+    /**
+     * TaskRunResults are the list of results written out by the task's containers
+     */
     @JsonProperty("taskResults")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TaskRunResult> getTaskResults() {
         return taskResults;
     }
 
+    /**
+     * TaskRunResults are the list of results written out by the task's containers
+     */
     @JsonProperty("taskResults")
     public void setTaskResults(List<TaskRunResult> taskResults) {
         this.taskResults = taskResults;
     }
 
+    /**
+     * TaskRunStatusFields holds the fields of TaskRun's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("taskSpec")
     public TaskSpec getTaskSpec() {
         return taskSpec;
     }
 
+    /**
+     * TaskRunStatusFields holds the fields of TaskRun's status.  This is defined separately and inlined so that other types can readily consume these fields via duck typing.
+     */
     @JsonProperty("taskSpec")
     public void setTaskSpec(TaskSpec taskSpec) {
         this.taskSpec = taskSpec;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunStepOverride.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunStepOverride.java
index 268552f4703..e837d26fbdb 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunStepOverride.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskRunStepOverride.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskRunStepOverride is used to override the values of a Step in the corresponding Task.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public TaskRunStepOverride(String name, ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * The name of the Step to override.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The name of the Step to override.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * TaskRunStepOverride is used to override the values of a Step in the corresponding Task.
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * TaskRunStepOverride is used to override the values of a Step in the corresponding Task.
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskSpec.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskSpec.java
index 0cccaf3781a..0fa7ab07b37 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskSpec.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TaskSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskSpec defines the desired state of Task.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -122,107 +125,167 @@ public TaskSpec(String description, String displayName, List<ParamSpec> params,
         this.workspaces = workspaces;
     }
 
+    /**
+     * Description is a user-facing description of the task that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is a user-facing description of the task that may be used to populate a UI.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * DisplayName is a user-facing name of the task that may be used to populate a UI.
+     */
     @JsonProperty("displayName")
     public String getDisplayName() {
         return displayName;
     }
 
+    /**
+     * DisplayName is a user-facing name of the task that may be used to populate a UI.
+     */
     @JsonProperty("displayName")
     public void setDisplayName(String displayName) {
         this.displayName = displayName;
     }
 
+    /**
+     * Params is a list of input parameters required to run the task. Params must be supplied as inputs in TaskRuns unless they declare a default value.
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ParamSpec> getParams() {
         return params;
     }
 
+    /**
+     * Params is a list of input parameters required to run the task. Params must be supplied as inputs in TaskRuns unless they declare a default value.
+     */
     @JsonProperty("params")
     public void setParams(List<ParamSpec> params) {
         this.params = params;
     }
 
+    /**
+     * TaskSpec defines the desired state of Task.
+     */
     @JsonProperty("resources")
     public TaskResources getResources() {
         return resources;
     }
 
+    /**
+     * TaskSpec defines the desired state of Task.
+     */
     @JsonProperty("resources")
     public void setResources(TaskResources resources) {
         this.resources = resources;
     }
 
+    /**
+     * Results are values that this Task can output
+     */
     @JsonProperty("results")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TaskResult> getResults() {
         return results;
     }
 
+    /**
+     * Results are values that this Task can output
+     */
     @JsonProperty("results")
     public void setResults(List<TaskResult> results) {
         this.results = results;
     }
 
+    /**
+     * Sidecars are run alongside the Task's step containers. They begin before the steps start and end after the steps complete.
+     */
     @JsonProperty("sidecars")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Sidecar> getSidecars() {
         return sidecars;
     }
 
+    /**
+     * Sidecars are run alongside the Task's step containers. They begin before the steps start and end after the steps complete.
+     */
     @JsonProperty("sidecars")
     public void setSidecars(List<Sidecar> sidecars) {
         this.sidecars = sidecars;
     }
 
+    /**
+     * TaskSpec defines the desired state of Task.
+     */
     @JsonProperty("stepTemplate")
     public StepTemplate getStepTemplate() {
         return stepTemplate;
     }
 
+    /**
+     * TaskSpec defines the desired state of Task.
+     */
     @JsonProperty("stepTemplate")
     public void setStepTemplate(StepTemplate stepTemplate) {
         this.stepTemplate = stepTemplate;
     }
 
+    /**
+     * Steps are the steps of the build; each step is run sequentially with the source mounted into /workspace.
+     */
     @JsonProperty("steps")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Step> getSteps() {
         return steps;
     }
 
+    /**
+     * Steps are the steps of the build; each step is run sequentially with the source mounted into /workspace.
+     */
     @JsonProperty("steps")
     public void setSteps(List<Step> steps) {
         this.steps = steps;
     }
 
+    /**
+     * Volumes is a collection of volumes that are available to mount into the steps of the build.
+     */
     @JsonProperty("volumes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Volume> getVolumes() {
         return volumes;
     }
 
+    /**
+     * Volumes is a collection of volumes that are available to mount into the steps of the build.
+     */
     @JsonProperty("volumes")
     public void setVolumes(List<Volume> volumes) {
         this.volumes = volumes;
     }
 
+    /**
+     * Workspaces are the volumes that this Task requires.
+     */
     @JsonProperty("workspaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WorkspaceDeclaration> getWorkspaces() {
         return workspaces;
     }
 
+    /**
+     * Workspaces are the volumes that this Task requires.
+     */
     @JsonProperty("workspaces")
     public void setWorkspaces(List<WorkspaceDeclaration> workspaces) {
         this.workspaces = workspaces;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TimeoutFields.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TimeoutFields.java
index 0bd0d1bd3d2..66a6d5206fb 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TimeoutFields.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/TimeoutFields.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TimeoutFields allows granular specification of pipeline, task, and finally timeouts
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,31 +90,49 @@ public TimeoutFields(Duration _finally, Duration pipeline, Duration tasks) {
         this.tasks = tasks;
     }
 
+    /**
+     * TimeoutFields allows granular specification of pipeline, task, and finally timeouts
+     */
     @JsonProperty("finally")
     public Duration getFinally() {
         return _finally;
     }
 
+    /**
+     * TimeoutFields allows granular specification of pipeline, task, and finally timeouts
+     */
     @JsonProperty("finally")
     public void setFinally(Duration _finally) {
         this._finally = _finally;
     }
 
+    /**
+     * TimeoutFields allows granular specification of pipeline, task, and finally timeouts
+     */
     @JsonProperty("pipeline")
     public Duration getPipeline() {
         return pipeline;
     }
 
+    /**
+     * TimeoutFields allows granular specification of pipeline, task, and finally timeouts
+     */
     @JsonProperty("pipeline")
     public void setPipeline(Duration pipeline) {
         this.pipeline = pipeline;
     }
 
+    /**
+     * TimeoutFields allows granular specification of pipeline, task, and finally timeouts
+     */
     @JsonProperty("tasks")
     public Duration getTasks() {
         return tasks;
     }
 
+    /**
+     * TimeoutFields allows granular specification of pipeline, task, and finally timeouts
+     */
     @JsonProperty("tasks")
     public void setTasks(Duration tasks) {
         this.tasks = tasks;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/WhenExpression.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/WhenExpression.java
index 273e7262202..bd682d5b219 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/WhenExpression.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/WhenExpression.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WhenExpression allows a PipelineTask to declare expressions to be evaluated before the Task is run to determine whether the Task should be executed or skipped
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public WhenExpression(String cel, String input, String operator, List<String> va
         this.values = values;
     }
 
+    /**
+     * CEL is a string of Common Language Expression, which can be used to conditionally execute the task based on the result of the expression evaluation More info about CEL syntax: https://github.com/google/cel-spec/blob/master/doc/langdef.md
+     */
     @JsonProperty("cel")
     public String getCel() {
         return cel;
     }
 
+    /**
+     * CEL is a string of Common Language Expression, which can be used to conditionally execute the task based on the result of the expression evaluation More info about CEL syntax: https://github.com/google/cel-spec/blob/master/doc/langdef.md
+     */
     @JsonProperty("cel")
     public void setCel(String cel) {
         this.cel = cel;
     }
 
+    /**
+     * Input is the string for guard checking which can be a static input or an output from a parent Task
+     */
     @JsonProperty("input")
     public String getInput() {
         return input;
     }
 
+    /**
+     * Input is the string for guard checking which can be a static input or an output from a parent Task
+     */
     @JsonProperty("input")
     public void setInput(String input) {
         this.input = input;
     }
 
+    /**
+     * Operator that represents an Input's relationship to the values
+     */
     @JsonProperty("operator")
     public String getOperator() {
         return operator;
     }
 
+    /**
+     * Operator that represents an Input's relationship to the values
+     */
     @JsonProperty("operator")
     public void setOperator(String operator) {
         this.operator = operator;
     }
 
+    /**
+     * Values is an array of strings, which is compared against the input, for guard checking It must be non-empty
+     */
     @JsonProperty("values")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getValues() {
         return values;
     }
 
+    /**
+     * Values is an array of strings, which is compared against the input, for guard checking It must be non-empty
+     */
     @JsonProperty("values")
     public void setValues(List<String> values) {
         this.values = values;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/WorkspaceBinding.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/WorkspaceBinding.java
index 62da0cea7be..7cabfe69e5b 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/WorkspaceBinding.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/WorkspaceBinding.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WorkspaceBinding maps a Task's declared workspace to a Volume.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -116,91 +119,145 @@ public WorkspaceBinding(ConfigMapVolumeSource configMap, CSIVolumeSource csi, Em
         this.volumeClaimTemplate = volumeClaimTemplate;
     }
 
+    /**
+     * WorkspaceBinding maps a Task's declared workspace to a Volume.
+     */
     @JsonProperty("configMap")
     public ConfigMapVolumeSource getConfigMap() {
         return configMap;
     }
 
+    /**
+     * WorkspaceBinding maps a Task's declared workspace to a Volume.
+     */
     @JsonProperty("configMap")
     public void setConfigMap(ConfigMapVolumeSource configMap) {
         this.configMap = configMap;
     }
 
+    /**
+     * WorkspaceBinding maps a Task's declared workspace to a Volume.
+     */
     @JsonProperty("csi")
     public CSIVolumeSource getCsi() {
         return csi;
     }
 
+    /**
+     * WorkspaceBinding maps a Task's declared workspace to a Volume.
+     */
     @JsonProperty("csi")
     public void setCsi(CSIVolumeSource csi) {
         this.csi = csi;
     }
 
+    /**
+     * WorkspaceBinding maps a Task's declared workspace to a Volume.
+     */
     @JsonProperty("emptyDir")
     public EmptyDirVolumeSource getEmptyDir() {
         return emptyDir;
     }
 
+    /**
+     * WorkspaceBinding maps a Task's declared workspace to a Volume.
+     */
     @JsonProperty("emptyDir")
     public void setEmptyDir(EmptyDirVolumeSource emptyDir) {
         this.emptyDir = emptyDir;
     }
 
+    /**
+     * Name is the name of the workspace populated by the volume.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the workspace populated by the volume.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * WorkspaceBinding maps a Task's declared workspace to a Volume.
+     */
     @JsonProperty("persistentVolumeClaim")
     public PersistentVolumeClaimVolumeSource getPersistentVolumeClaim() {
         return persistentVolumeClaim;
     }
 
+    /**
+     * WorkspaceBinding maps a Task's declared workspace to a Volume.
+     */
     @JsonProperty("persistentVolumeClaim")
     public void setPersistentVolumeClaim(PersistentVolumeClaimVolumeSource persistentVolumeClaim) {
         this.persistentVolumeClaim = persistentVolumeClaim;
     }
 
+    /**
+     * WorkspaceBinding maps a Task's declared workspace to a Volume.
+     */
     @JsonProperty("projected")
     public ProjectedVolumeSource getProjected() {
         return projected;
     }
 
+    /**
+     * WorkspaceBinding maps a Task's declared workspace to a Volume.
+     */
     @JsonProperty("projected")
     public void setProjected(ProjectedVolumeSource projected) {
         this.projected = projected;
     }
 
+    /**
+     * WorkspaceBinding maps a Task's declared workspace to a Volume.
+     */
     @JsonProperty("secret")
     public SecretVolumeSource getSecret() {
         return secret;
     }
 
+    /**
+     * WorkspaceBinding maps a Task's declared workspace to a Volume.
+     */
     @JsonProperty("secret")
     public void setSecret(SecretVolumeSource secret) {
         this.secret = secret;
     }
 
+    /**
+     * SubPath is optionally a directory on the volume which should be used for this binding (i.e. the volume will be mounted at this sub directory).
+     */
     @JsonProperty("subPath")
     public String getSubPath() {
         return subPath;
     }
 
+    /**
+     * SubPath is optionally a directory on the volume which should be used for this binding (i.e. the volume will be mounted at this sub directory).
+     */
     @JsonProperty("subPath")
     public void setSubPath(String subPath) {
         this.subPath = subPath;
     }
 
+    /**
+     * WorkspaceBinding maps a Task's declared workspace to a Volume.
+     */
     @JsonProperty("volumeClaimTemplate")
     public PersistentVolumeClaim getVolumeClaimTemplate() {
         return volumeClaimTemplate;
     }
 
+    /**
+     * WorkspaceBinding maps a Task's declared workspace to a Volume.
+     */
     @JsonProperty("volumeClaimTemplate")
     public void setVolumeClaimTemplate(PersistentVolumeClaim volumeClaimTemplate) {
         this.volumeClaimTemplate = volumeClaimTemplate;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/WorkspaceDeclaration.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/WorkspaceDeclaration.java
index e4696df575f..92948d43344 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/WorkspaceDeclaration.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/WorkspaceDeclaration.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WorkspaceDeclaration is a declaration of a volume that a Task requires.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public WorkspaceDeclaration(String description, String mountPath, String name, B
         this.readOnly = readOnly;
     }
 
+    /**
+     * Description is an optional human readable description of this volume.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is an optional human readable description of this volume.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * MountPath overrides the directory that the volume will be made available at.
+     */
     @JsonProperty("mountPath")
     public String getMountPath() {
         return mountPath;
     }
 
+    /**
+     * MountPath overrides the directory that the volume will be made available at.
+     */
     @JsonProperty("mountPath")
     public void setMountPath(String mountPath) {
         this.mountPath = mountPath;
     }
 
+    /**
+     * Name is the name by which you can bind the volume at runtime.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name by which you can bind the volume at runtime.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Optional marks a Workspace as not being required in TaskRuns. By default this field is false and so declared workspaces are required.
+     */
     @JsonProperty("optional")
     public Boolean getOptional() {
         return optional;
     }
 
+    /**
+     * Optional marks a Workspace as not being required in TaskRuns. By default this field is false and so declared workspaces are required.
+     */
     @JsonProperty("optional")
     public void setOptional(Boolean optional) {
         this.optional = optional;
     }
 
+    /**
+     * ReadOnly dictates whether a mounted volume is writable. By default this field is false and so mounted volumes are writable.
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * ReadOnly dictates whether a mounted volume is writable. By default this field is false and so mounted volumes are writable.
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/WorkspacePipelineTaskBinding.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/WorkspacePipelineTaskBinding.java
index 6f54e20e703..2a7700996eb 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/WorkspacePipelineTaskBinding.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/WorkspacePipelineTaskBinding.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WorkspacePipelineTaskBinding describes how a workspace passed into the pipeline should be mapped to a task's declared workspace.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public WorkspacePipelineTaskBinding(String name, String subPath, String workspac
         this.workspace = workspace;
     }
 
+    /**
+     * Name is the name of the workspace as declared by the task
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the workspace as declared by the task
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * SubPath is optionally a directory on the volume which should be used for this binding (i.e. the volume will be mounted at this sub directory).
+     */
     @JsonProperty("subPath")
     public String getSubPath() {
         return subPath;
     }
 
+    /**
+     * SubPath is optionally a directory on the volume which should be used for this binding (i.e. the volume will be mounted at this sub directory).
+     */
     @JsonProperty("subPath")
     public void setSubPath(String subPath) {
         this.subPath = subPath;
     }
 
+    /**
+     * Workspace is the name of the workspace declared by the pipeline
+     */
     @JsonProperty("workspace")
     public String getWorkspace() {
         return workspace;
     }
 
+    /**
+     * Workspace is the name of the workspace declared by the pipeline
+     */
     @JsonProperty("workspace")
     public void setWorkspace(String workspace) {
         this.workspace = workspace;
diff --git a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/WorkspaceUsage.java b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/WorkspaceUsage.java
index f33723e291d..261477c6369 100644
--- a/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/WorkspaceUsage.java
+++ b/extensions/tekton/model/src/generated/java/io/fabric8/tekton/v1beta1/WorkspaceUsage.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WorkspaceUsage is used by a Step or Sidecar to declare that it wants isolated access to a Workspace defined in a Task.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public WorkspaceUsage(String mountPath, String name) {
         this.name = name;
     }
 
+    /**
+     * MountPath is the path that the workspace should be mounted to inside the Step or Sidecar, overriding any MountPath specified in the Task's WorkspaceDeclaration.
+     */
     @JsonProperty("mountPath")
     public String getMountPath() {
         return mountPath;
     }
 
+    /**
+     * MountPath is the path that the workspace should be mounted to inside the Step or Sidecar, overriding any MountPath specified in the Task's WorkspaceDeclaration.
+     */
     @JsonProperty("mountPath")
     public void setMountPath(String mountPath) {
         this.mountPath = mountPath;
     }
 
+    /**
+     * Name is the name of the workspace this Step or Sidecar wants access to.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the workspace this Step or Sidecar wants access to.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/ContainerResourcePolicy.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/ContainerResourcePolicy.java
index 116f2bb2b33..420f84e72a5 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/ContainerResourcePolicy.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/ContainerResourcePolicy.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerResourcePolicy controls how autoscaler computes the recommended resources for a specific container.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -104,64 +107,100 @@ public ContainerResourcePolicy(String containerName, List<String> controlledReso
         this.mode = mode;
     }
 
+    /**
+     * Name of the container or DefaultContainerResourcePolicy, in which case the policy is used by the containers that don't have their own policy specified.
+     */
     @JsonProperty("containerName")
     public String getContainerName() {
         return containerName;
     }
 
+    /**
+     * Name of the container or DefaultContainerResourcePolicy, in which case the policy is used by the containers that don't have their own policy specified.
+     */
     @JsonProperty("containerName")
     public void setContainerName(String containerName) {
         this.containerName = containerName;
     }
 
+    /**
+     * Specifies the type of recommendations that will be computed (and possibly applied) by VPA. If not specified, the default of [ResourceCPU, ResourceMemory] will be used.
+     */
     @JsonProperty("controlledResources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getControlledResources() {
         return controlledResources;
     }
 
+    /**
+     * Specifies the type of recommendations that will be computed (and possibly applied) by VPA. If not specified, the default of [ResourceCPU, ResourceMemory] will be used.
+     */
     @JsonProperty("controlledResources")
     public void setControlledResources(List<String> controlledResources) {
         this.controlledResources = controlledResources;
     }
 
+    /**
+     * Specifies which resource values should be controlled. The default is "RequestsAndLimits".
+     */
     @JsonProperty("controlledValues")
     public String getControlledValues() {
         return controlledValues;
     }
 
+    /**
+     * Specifies which resource values should be controlled. The default is "RequestsAndLimits".
+     */
     @JsonProperty("controlledValues")
     public void setControlledValues(String controlledValues) {
         this.controlledValues = controlledValues;
     }
 
+    /**
+     * Specifies the maximum amount of resources that will be recommended for the container. The default is no maximum.
+     */
     @JsonProperty("maxAllowed")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getMaxAllowed() {
         return maxAllowed;
     }
 
+    /**
+     * Specifies the maximum amount of resources that will be recommended for the container. The default is no maximum.
+     */
     @JsonProperty("maxAllowed")
     public void setMaxAllowed(Map<String, Quantity> maxAllowed) {
         this.maxAllowed = maxAllowed;
     }
 
+    /**
+     * Specifies the minimal amount of resources that will be recommended for the container. The default is no minimum.
+     */
     @JsonProperty("minAllowed")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getMinAllowed() {
         return minAllowed;
     }
 
+    /**
+     * Specifies the minimal amount of resources that will be recommended for the container. The default is no minimum.
+     */
     @JsonProperty("minAllowed")
     public void setMinAllowed(Map<String, Quantity> minAllowed) {
         this.minAllowed = minAllowed;
     }
 
+    /**
+     * Whether autoscaler is enabled for the container. The default is "Auto".
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Whether autoscaler is enabled for the container. The default is "Auto".
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/EvictionRequirement.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/EvictionRequirement.java
index 8f5776aa01c..4515232e74c 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/EvictionRequirement.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/EvictionRequirement.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EvictionRequirement defines a single condition which needs to be true in order to evict a Pod
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public EvictionRequirement(String changeRequirement, List<String> resources) {
         this.resources = resources;
     }
 
+    /**
+     * EvictionRequirement defines a single condition which needs to be true in order to evict a Pod
+     */
     @JsonProperty("changeRequirement")
     public String getChangeRequirement() {
         return changeRequirement;
     }
 
+    /**
+     * EvictionRequirement defines a single condition which needs to be true in order to evict a Pod
+     */
     @JsonProperty("changeRequirement")
     public void setChangeRequirement(String changeRequirement) {
         this.changeRequirement = changeRequirement;
     }
 
+    /**
+     * Resources is a list of one or more resources that the condition applies to. If more than one resource is given, the EvictionRequirement is fulfilled if at least one resource meets `changeRequirement`.
+     */
     @JsonProperty("resources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getResources() {
         return resources;
     }
 
+    /**
+     * Resources is a list of one or more resources that the condition applies to. If more than one resource is given, the EvictionRequirement is fulfilled if at least one resource meets `changeRequirement`.
+     */
     @JsonProperty("resources")
     public void setResources(List<String> resources) {
         this.resources = resources;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/HistogramCheckpoint.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/HistogramCheckpoint.java
index 0bdb2bed101..213227cc45d 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/HistogramCheckpoint.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/HistogramCheckpoint.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HistogramCheckpoint contains data needed to reconstruct the histogram.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,32 +90,50 @@ public HistogramCheckpoint(Map<String, Long> bucketWeights, String referenceTime
         this.totalWeight = totalWeight;
     }
 
+    /**
+     * Map from bucket index to bucket weight.
+     */
     @JsonProperty("bucketWeights")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Long> getBucketWeights() {
         return bucketWeights;
     }
 
+    /**
+     * Map from bucket index to bucket weight.
+     */
     @JsonProperty("bucketWeights")
     public void setBucketWeights(Map<String, Long> bucketWeights) {
         this.bucketWeights = bucketWeights;
     }
 
+    /**
+     * HistogramCheckpoint contains data needed to reconstruct the histogram.
+     */
     @JsonProperty("referenceTimestamp")
     public String getReferenceTimestamp() {
         return referenceTimestamp;
     }
 
+    /**
+     * HistogramCheckpoint contains data needed to reconstruct the histogram.
+     */
     @JsonProperty("referenceTimestamp")
     public void setReferenceTimestamp(String referenceTimestamp) {
         this.referenceTimestamp = referenceTimestamp;
     }
 
+    /**
+     * Sum of samples to be used as denominator for weights from BucketWeights.
+     */
     @JsonProperty("totalWeight")
     public Double getTotalWeight() {
         return totalWeight;
     }
 
+    /**
+     * Sum of samples to be used as denominator for weights from BucketWeights.
+     */
     @JsonProperty("totalWeight")
     public void setTotalWeight(Double totalWeight) {
         this.totalWeight = totalWeight;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/PodResourcePolicy.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/PodResourcePolicy.java
index 3789881dc63..36067353930 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/PodResourcePolicy.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/PodResourcePolicy.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodResourcePolicy controls how autoscaler computes the recommended resources for containers belonging to the pod. There can be at most one entry for every named container and optionally a single wildcard entry with `containerName` = '&#42;', which handles all containers that don't have individual policies.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public PodResourcePolicy(List<ContainerResourcePolicy> containerPolicies) {
         this.containerPolicies = containerPolicies;
     }
 
+    /**
+     * Per-container resource policies.
+     */
     @JsonProperty("containerPolicies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ContainerResourcePolicy> getContainerPolicies() {
         return containerPolicies;
     }
 
+    /**
+     * Per-container resource policies.
+     */
     @JsonProperty("containerPolicies")
     public void setContainerPolicies(List<ContainerResourcePolicy> containerPolicies) {
         this.containerPolicies = containerPolicies;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/PodUpdatePolicy.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/PodUpdatePolicy.java
index dbc3306344e..fa4c3a1e3f2 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/PodUpdatePolicy.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/PodUpdatePolicy.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodUpdatePolicy describes the rules on how changes are applied to the pods.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public PodUpdatePolicy(List<EvictionRequirement> evictionRequirements, Integer m
         this.updateMode = updateMode;
     }
 
+    /**
+     * EvictionRequirements is a list of EvictionRequirements that need to evaluate to true in order for a Pod to be evicted. If more than one EvictionRequirement is specified, all of them need to be fulfilled to allow eviction.
+     */
     @JsonProperty("evictionRequirements")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EvictionRequirement> getEvictionRequirements() {
         return evictionRequirements;
     }
 
+    /**
+     * EvictionRequirements is a list of EvictionRequirements that need to evaluate to true in order for a Pod to be evicted. If more than one EvictionRequirement is specified, all of them need to be fulfilled to allow eviction.
+     */
     @JsonProperty("evictionRequirements")
     public void setEvictionRequirements(List<EvictionRequirement> evictionRequirements) {
         this.evictionRequirements = evictionRequirements;
     }
 
+    /**
+     * Minimal number of replicas which need to be alive for Updater to attempt pod eviction (pending other checks like PDB). Only positive values are allowed. Overrides global '--min-replicas' flag.
+     */
     @JsonProperty("minReplicas")
     public Integer getMinReplicas() {
         return minReplicas;
     }
 
+    /**
+     * Minimal number of replicas which need to be alive for Updater to attempt pod eviction (pending other checks like PDB). Only positive values are allowed. Overrides global '--min-replicas' flag.
+     */
     @JsonProperty("minReplicas")
     public void setMinReplicas(Integer minReplicas) {
         this.minReplicas = minReplicas;
     }
 
+    /**
+     * Controls when autoscaler applies changes to the pod resources. The default is 'Auto'.
+     */
     @JsonProperty("updateMode")
     public String getUpdateMode() {
         return updateMode;
     }
 
+    /**
+     * Controls when autoscaler applies changes to the pod resources. The default is 'Auto'.
+     */
     @JsonProperty("updateMode")
     public void setUpdateMode(String updateMode) {
         this.updateMode = updateMode;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/RecommendedContainerResources.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/RecommendedContainerResources.java
index 2ea9c0c6c12..fe0d8d4cb73 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/RecommendedContainerResources.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/RecommendedContainerResources.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RecommendedContainerResources is the recommendation of resources computed by autoscaler for a specific container. Respects the container resource policy if present in the spec. In particular the recommendation is not produced for containers with `ContainerScalingMode` set to 'Off'.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -99,55 +102,85 @@ public RecommendedContainerResources(String containerName, Map<String, Quantity>
         this.upperBound = upperBound;
     }
 
+    /**
+     * Name of the container.
+     */
     @JsonProperty("containerName")
     public String getContainerName() {
         return containerName;
     }
 
+    /**
+     * Name of the container.
+     */
     @JsonProperty("containerName")
     public void setContainerName(String containerName) {
         this.containerName = containerName;
     }
 
+    /**
+     * Minimum recommended amount of resources. Observes ContainerResourcePolicy. This amount is not guaranteed to be sufficient for the application to operate in a stable way, however running with less resources is likely to have significant impact on performance/availability.
+     */
     @JsonProperty("lowerBound")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getLowerBound() {
         return lowerBound;
     }
 
+    /**
+     * Minimum recommended amount of resources. Observes ContainerResourcePolicy. This amount is not guaranteed to be sufficient for the application to operate in a stable way, however running with less resources is likely to have significant impact on performance/availability.
+     */
     @JsonProperty("lowerBound")
     public void setLowerBound(Map<String, Quantity> lowerBound) {
         this.lowerBound = lowerBound;
     }
 
+    /**
+     * Recommended amount of resources. Observes ContainerResourcePolicy.
+     */
     @JsonProperty("target")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getTarget() {
         return target;
     }
 
+    /**
+     * Recommended amount of resources. Observes ContainerResourcePolicy.
+     */
     @JsonProperty("target")
     public void setTarget(Map<String, Quantity> target) {
         this.target = target;
     }
 
+    /**
+     * The most recent recommended resources target computed by the autoscaler for the controlled pods, based only on actual resource usage, not taking into account the ContainerResourcePolicy. May differ from the Recommendation if the actual resource usage causes the target to violate the ContainerResourcePolicy (lower than MinAllowed or higher that MaxAllowed). Used only as status indication, will not affect actual resource assignment.
+     */
     @JsonProperty("uncappedTarget")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getUncappedTarget() {
         return uncappedTarget;
     }
 
+    /**
+     * The most recent recommended resources target computed by the autoscaler for the controlled pods, based only on actual resource usage, not taking into account the ContainerResourcePolicy. May differ from the Recommendation if the actual resource usage causes the target to violate the ContainerResourcePolicy (lower than MinAllowed or higher that MaxAllowed). Used only as status indication, will not affect actual resource assignment.
+     */
     @JsonProperty("uncappedTarget")
     public void setUncappedTarget(Map<String, Quantity> uncappedTarget) {
         this.uncappedTarget = uncappedTarget;
     }
 
+    /**
+     * Maximum recommended amount of resources. Observes ContainerResourcePolicy. Any resources allocated beyond this value are likely wasted. This value may be larger than the maximum amount of application is actually capable of consuming.
+     */
     @JsonProperty("upperBound")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getUpperBound() {
         return upperBound;
     }
 
+    /**
+     * Maximum recommended amount of resources. Observes ContainerResourcePolicy. Any resources allocated beyond this value are likely wasted. This value may be larger than the maximum amount of application is actually capable of consuming.
+     */
     @JsonProperty("upperBound")
     public void setUpperBound(Map<String, Quantity> upperBound) {
         this.upperBound = upperBound;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/RecommendedPodResources.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/RecommendedPodResources.java
index e72277004a3..41374c744bc 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/RecommendedPodResources.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/RecommendedPodResources.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RecommendedPodResources is the recommendation of resources computed by autoscaler. It contains a recommendation for each container in the pod (except for those with `ContainerScalingMode` set to 'Off').
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public RecommendedPodResources(List<RecommendedContainerResources> containerReco
         this.containerRecommendations = containerRecommendations;
     }
 
+    /**
+     * Resources recommended by the autoscaler for each container.
+     */
     @JsonProperty("containerRecommendations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RecommendedContainerResources> getContainerRecommendations() {
         return containerRecommendations;
     }
 
+    /**
+     * Resources recommended by the autoscaler for each container.
+     */
     @JsonProperty("containerRecommendations")
     public void setContainerRecommendations(List<RecommendedContainerResources> containerRecommendations) {
         this.containerRecommendations = containerRecommendations;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscaler.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscaler.java
index 4d489879015..6f9bbbb9979 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscaler.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscaler.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerticalPodAutoscaler is the configuration for a vertical pod autoscaler, which automatically manages pod resources based on historical and real time resource utilization.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class VerticalPodAutoscaler implements Editable<VerticalPodAutoscalerBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VerticalPodAutoscaler";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public VerticalPodAutoscaler(String apiVersion, String kind, ObjectMeta metadata
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VerticalPodAutoscaler is the configuration for a vertical pod autoscaler, which automatically manages pod resources based on historical and real time resource utilization.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VerticalPodAutoscaler is the configuration for a vertical pod autoscaler, which automatically manages pod resources based on historical and real time resource utilization.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * VerticalPodAutoscaler is the configuration for a vertical pod autoscaler, which automatically manages pod resources based on historical and real time resource utilization.
+     */
     @JsonProperty("spec")
     public VerticalPodAutoscalerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * VerticalPodAutoscaler is the configuration for a vertical pod autoscaler, which automatically manages pod resources based on historical and real time resource utilization.
+     */
     @JsonProperty("spec")
     public void setSpec(VerticalPodAutoscalerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * VerticalPodAutoscaler is the configuration for a vertical pod autoscaler, which automatically manages pod resources based on historical and real time resource utilization.
+     */
     @JsonProperty("status")
     public VerticalPodAutoscalerStatus getStatus() {
         return status;
     }
 
+    /**
+     * VerticalPodAutoscaler is the configuration for a vertical pod autoscaler, which automatically manages pod resources based on historical and real time resource utilization.
+     */
     @JsonProperty("status")
     public void setStatus(VerticalPodAutoscalerStatus status) {
         this.status = status;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerCheckpoint.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerCheckpoint.java
index c4c5b1c8b8c..e2ecd36fbf5 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerCheckpoint.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerCheckpoint.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerticalPodAutoscalerCheckpoint is the checkpoint of the internal state of VPA that is used for recovery after recommender's restart.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class VerticalPodAutoscalerCheckpoint implements Editable<VerticalPodAutoscalerCheckpointBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VerticalPodAutoscalerCheckpoint";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public VerticalPodAutoscalerCheckpoint(String apiVersion, String kind, ObjectMet
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpoint is the checkpoint of the internal state of VPA that is used for recovery after recommender's restart.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpoint is the checkpoint of the internal state of VPA that is used for recovery after recommender's restart.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpoint is the checkpoint of the internal state of VPA that is used for recovery after recommender's restart.
+     */
     @JsonProperty("spec")
     public VerticalPodAutoscalerCheckpointSpec getSpec() {
         return spec;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpoint is the checkpoint of the internal state of VPA that is used for recovery after recommender's restart.
+     */
     @JsonProperty("spec")
     public void setSpec(VerticalPodAutoscalerCheckpointSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpoint is the checkpoint of the internal state of VPA that is used for recovery after recommender's restart.
+     */
     @JsonProperty("status")
     public VerticalPodAutoscalerCheckpointStatus getStatus() {
         return status;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpoint is the checkpoint of the internal state of VPA that is used for recovery after recommender's restart.
+     */
     @JsonProperty("status")
     public void setStatus(VerticalPodAutoscalerCheckpointStatus status) {
         this.status = status;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerCheckpointList.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerCheckpointList.java
index c53cabeb17e..2456884484a 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerCheckpointList.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerCheckpointList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerticalPodAutoscalerCheckpointList is a list of VerticalPodAutoscalerCheckpoint objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class VerticalPodAutoscalerCheckpointList implements Editable<VerticalPodAutoscalerCheckpointListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.autoscaling.api.model.v1.VerticalPodAutoscalerCheckpoint>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.autoscaling.api.model.v1.VerticalPodAutoscalerCheckpoint> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VerticalPodAutoscalerCheckpointList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public VerticalPodAutoscalerCheckpointList(String apiVersion, List<io.fabric8.au
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointList is a list of VerticalPodAutoscalerCheckpoint objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.autoscaling.api.model.v1.VerticalPodAutoscalerCheckpoint> getItems() {
         return items;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointList is a list of VerticalPodAutoscalerCheckpoint objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.autoscaling.api.model.v1.VerticalPodAutoscalerCheckpoint> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointList is a list of VerticalPodAutoscalerCheckpoint objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointList is a list of VerticalPodAutoscalerCheckpoint objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerCheckpointSpec.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerCheckpointSpec.java
index 8a958509052..389c9e5bbc4 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerCheckpointSpec.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerCheckpointSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerticalPodAutoscalerCheckpointSpec is the specification of the checkpoint object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public VerticalPodAutoscalerCheckpointSpec(String containerName, String vpaObjec
         this.vpaObjectName = vpaObjectName;
     }
 
+    /**
+     * Name of the checkpointed container.
+     */
     @JsonProperty("containerName")
     public String getContainerName() {
         return containerName;
     }
 
+    /**
+     * Name of the checkpointed container.
+     */
     @JsonProperty("containerName")
     public void setContainerName(String containerName) {
         this.containerName = containerName;
     }
 
+    /**
+     * Name of the VPA object that stored VerticalPodAutoscalerCheckpoint object.
+     */
     @JsonProperty("vpaObjectName")
     public String getVpaObjectName() {
         return vpaObjectName;
     }
 
+    /**
+     * Name of the VPA object that stored VerticalPodAutoscalerCheckpoint object.
+     */
     @JsonProperty("vpaObjectName")
     public void setVpaObjectName(String vpaObjectName) {
         this.vpaObjectName = vpaObjectName;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerCheckpointStatus.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerCheckpointStatus.java
index 3bedcb596e1..29bda303f75 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerCheckpointStatus.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerCheckpointStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,71 +105,113 @@ public VerticalPodAutoscalerCheckpointStatus(HistogramCheckpoint cpuHistogram, S
         this.version = version;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("cpuHistogram")
     public HistogramCheckpoint getCpuHistogram() {
         return cpuHistogram;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("cpuHistogram")
     public void setCpuHistogram(HistogramCheckpoint cpuHistogram) {
         this.cpuHistogram = cpuHistogram;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("firstSampleStart")
     public String getFirstSampleStart() {
         return firstSampleStart;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("firstSampleStart")
     public void setFirstSampleStart(String firstSampleStart) {
         this.firstSampleStart = firstSampleStart;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("lastSampleStart")
     public String getLastSampleStart() {
         return lastSampleStart;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("lastSampleStart")
     public void setLastSampleStart(String lastSampleStart) {
         this.lastSampleStart = lastSampleStart;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("lastUpdateTime")
     public String getLastUpdateTime() {
         return lastUpdateTime;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("lastUpdateTime")
     public void setLastUpdateTime(String lastUpdateTime) {
         this.lastUpdateTime = lastUpdateTime;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("memoryHistogram")
     public HistogramCheckpoint getMemoryHistogram() {
         return memoryHistogram;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("memoryHistogram")
     public void setMemoryHistogram(HistogramCheckpoint memoryHistogram) {
         this.memoryHistogram = memoryHistogram;
     }
 
+    /**
+     * Total number of samples in the histograms.
+     */
     @JsonProperty("totalSamplesCount")
     public Integer getTotalSamplesCount() {
         return totalSamplesCount;
     }
 
+    /**
+     * Total number of samples in the histograms.
+     */
     @JsonProperty("totalSamplesCount")
     public void setTotalSamplesCount(Integer totalSamplesCount) {
         this.totalSamplesCount = totalSamplesCount;
     }
 
+    /**
+     * Version of the format of the stored data.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * Version of the format of the stored data.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerCondition.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerCondition.java
index 4bc1cb8a7d3..83d5e02f04c 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerCondition.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerticalPodAutoscalerCondition describes the state of a VerticalPodAutoscaler at a certain point.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public VerticalPodAutoscalerCondition(String lastTransitionTime, String message,
         this.type = type;
     }
 
+    /**
+     * VerticalPodAutoscalerCondition describes the state of a VerticalPodAutoscaler at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * VerticalPodAutoscalerCondition describes the state of a VerticalPodAutoscaler at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * message is a human-readable explanation containing details about the transition
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message is a human-readable explanation containing details about the transition
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * reason is the reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * reason is the reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * status is the status of the condition (True, False, Unknown)
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * status is the status of the condition (True, False, Unknown)
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * type describes the current condition
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type describes the current condition
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerList.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerList.java
index 884eb0835ba..436601d0afd 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerList.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerticalPodAutoscalerList is a list of VerticalPodAutoscaler objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class VerticalPodAutoscalerList implements Editable<VerticalPodAutoscalerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.autoscaling.api.model.v1.VerticalPodAutoscaler>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.autoscaling.api.model.v1.VerticalPodAutoscaler> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VerticalPodAutoscalerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public VerticalPodAutoscalerList(String apiVersion, List<io.fabric8.autoscaling.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of vertical pod autoscaler objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.autoscaling.api.model.v1.VerticalPodAutoscaler> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of vertical pod autoscaler objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.autoscaling.api.model.v1.VerticalPodAutoscaler> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VerticalPodAutoscalerList is a list of VerticalPodAutoscaler objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VerticalPodAutoscalerList is a list of VerticalPodAutoscaler objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerRecommenderSelector.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerRecommenderSelector.java
index 90effaedfee..f8e2bc63c48 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerRecommenderSelector.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerRecommenderSelector.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerticalPodAutoscalerRecommenderSelector points to a specific Vertical Pod Autoscaler recommender. In the future it might pass parameters to the recommender.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public VerticalPodAutoscalerRecommenderSelector(String name) {
         this.name = name;
     }
 
+    /**
+     * Name of the recommender responsible for generating recommendation for this object.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the recommender responsible for generating recommendation for this object.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerSpec.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerSpec.java
index 62791bba52c..8f9bb90c3bf 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerSpec.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerticalPodAutoscalerSpec is the specification of the behavior of the autoscaler.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,42 +97,66 @@ public VerticalPodAutoscalerSpec(List<VerticalPodAutoscalerRecommenderSelector>
         this.updatePolicy = updatePolicy;
     }
 
+    /**
+     * Recommender responsible for generating recommendation for this object. List should be empty (then the default recommender will generate the recommendation) or contain exactly one recommender.
+     */
     @JsonProperty("recommenders")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VerticalPodAutoscalerRecommenderSelector> getRecommenders() {
         return recommenders;
     }
 
+    /**
+     * Recommender responsible for generating recommendation for this object. List should be empty (then the default recommender will generate the recommendation) or contain exactly one recommender.
+     */
     @JsonProperty("recommenders")
     public void setRecommenders(List<VerticalPodAutoscalerRecommenderSelector> recommenders) {
         this.recommenders = recommenders;
     }
 
+    /**
+     * VerticalPodAutoscalerSpec is the specification of the behavior of the autoscaler.
+     */
     @JsonProperty("resourcePolicy")
     public PodResourcePolicy getResourcePolicy() {
         return resourcePolicy;
     }
 
+    /**
+     * VerticalPodAutoscalerSpec is the specification of the behavior of the autoscaler.
+     */
     @JsonProperty("resourcePolicy")
     public void setResourcePolicy(PodResourcePolicy resourcePolicy) {
         this.resourcePolicy = resourcePolicy;
     }
 
+    /**
+     * VerticalPodAutoscalerSpec is the specification of the behavior of the autoscaler.
+     */
     @JsonProperty("targetRef")
     public CrossVersionObjectReference getTargetRef() {
         return targetRef;
     }
 
+    /**
+     * VerticalPodAutoscalerSpec is the specification of the behavior of the autoscaler.
+     */
     @JsonProperty("targetRef")
     public void setTargetRef(CrossVersionObjectReference targetRef) {
         this.targetRef = targetRef;
     }
 
+    /**
+     * VerticalPodAutoscalerSpec is the specification of the behavior of the autoscaler.
+     */
     @JsonProperty("updatePolicy")
     public PodUpdatePolicy getUpdatePolicy() {
         return updatePolicy;
     }
 
+    /**
+     * VerticalPodAutoscalerSpec is the specification of the behavior of the autoscaler.
+     */
     @JsonProperty("updatePolicy")
     public void setUpdatePolicy(PodUpdatePolicy updatePolicy) {
         this.updatePolicy = updatePolicy;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerStatus.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerStatus.java
index bd1e47e6b42..6a3e07946e7 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerStatus.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1/VerticalPodAutoscalerStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerticalPodAutoscalerStatus describes the runtime state of the autoscaler.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public VerticalPodAutoscalerStatus(List<VerticalPodAutoscalerCondition> conditio
         this.recommendation = recommendation;
     }
 
+    /**
+     * Conditions is the set of conditions required for this autoscaler to scale its target, and indicates whether or not those conditions are met.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VerticalPodAutoscalerCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions is the set of conditions required for this autoscaler to scale its target, and indicates whether or not those conditions are met.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<VerticalPodAutoscalerCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * VerticalPodAutoscalerStatus describes the runtime state of the autoscaler.
+     */
     @JsonProperty("recommendation")
     public RecommendedPodResources getRecommendation() {
         return recommendation;
     }
 
+    /**
+     * VerticalPodAutoscalerStatus describes the runtime state of the autoscaler.
+     */
     @JsonProperty("recommendation")
     public void setRecommendation(RecommendedPodResources recommendation) {
         this.recommendation = recommendation;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/ContainerResourcePolicy.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/ContainerResourcePolicy.java
index 51871015f67..ff2007e4e1b 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/ContainerResourcePolicy.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/ContainerResourcePolicy.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerResourcePolicy controls how autoscaler computes the recommended resources for a specific container.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,43 +96,67 @@ public ContainerResourcePolicy(String containerName, Map<String, Quantity> maxAl
         this.mode = mode;
     }
 
+    /**
+     * Name of the container or DefaultContainerResourcePolicy, in which case the policy is used by the containers that don't have their own policy specified.
+     */
     @JsonProperty("containerName")
     public String getContainerName() {
         return containerName;
     }
 
+    /**
+     * Name of the container or DefaultContainerResourcePolicy, in which case the policy is used by the containers that don't have their own policy specified.
+     */
     @JsonProperty("containerName")
     public void setContainerName(String containerName) {
         this.containerName = containerName;
     }
 
+    /**
+     * Specifies the maximum amount of resources that will be recommended for the container. The default is no maximum.
+     */
     @JsonProperty("maxAllowed")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getMaxAllowed() {
         return maxAllowed;
     }
 
+    /**
+     * Specifies the maximum amount of resources that will be recommended for the container. The default is no maximum.
+     */
     @JsonProperty("maxAllowed")
     public void setMaxAllowed(Map<String, Quantity> maxAllowed) {
         this.maxAllowed = maxAllowed;
     }
 
+    /**
+     * Specifies the minimal amount of resources that will be recommended for the container. The default is no minimum.
+     */
     @JsonProperty("minAllowed")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getMinAllowed() {
         return minAllowed;
     }
 
+    /**
+     * Specifies the minimal amount of resources that will be recommended for the container. The default is no minimum.
+     */
     @JsonProperty("minAllowed")
     public void setMinAllowed(Map<String, Quantity> minAllowed) {
         this.minAllowed = minAllowed;
     }
 
+    /**
+     * Whether autoscaler is enabled for the container. The default is "Auto".
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Whether autoscaler is enabled for the container. The default is "Auto".
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/HistogramCheckpoint.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/HistogramCheckpoint.java
index 674d6f15d60..e9ccda58ad1 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/HistogramCheckpoint.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/HistogramCheckpoint.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HistogramCheckpoint contains data needed to reconstruct the histogram.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,32 +90,50 @@ public HistogramCheckpoint(Map<String, Long> bucketWeights, String referenceTime
         this.totalWeight = totalWeight;
     }
 
+    /**
+     * Map from bucket index to bucket weight.
+     */
     @JsonProperty("bucketWeights")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Long> getBucketWeights() {
         return bucketWeights;
     }
 
+    /**
+     * Map from bucket index to bucket weight.
+     */
     @JsonProperty("bucketWeights")
     public void setBucketWeights(Map<String, Long> bucketWeights) {
         this.bucketWeights = bucketWeights;
     }
 
+    /**
+     * HistogramCheckpoint contains data needed to reconstruct the histogram.
+     */
     @JsonProperty("referenceTimestamp")
     public String getReferenceTimestamp() {
         return referenceTimestamp;
     }
 
+    /**
+     * HistogramCheckpoint contains data needed to reconstruct the histogram.
+     */
     @JsonProperty("referenceTimestamp")
     public void setReferenceTimestamp(String referenceTimestamp) {
         this.referenceTimestamp = referenceTimestamp;
     }
 
+    /**
+     * Sum of samples to be used as denominator for weights from BucketWeights.
+     */
     @JsonProperty("totalWeight")
     public Double getTotalWeight() {
         return totalWeight;
     }
 
+    /**
+     * Sum of samples to be used as denominator for weights from BucketWeights.
+     */
     @JsonProperty("totalWeight")
     public void setTotalWeight(Double totalWeight) {
         this.totalWeight = totalWeight;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/PodResourcePolicy.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/PodResourcePolicy.java
index 57ba570af54..63d0663e278 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/PodResourcePolicy.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/PodResourcePolicy.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodResourcePolicy controls how autoscaler computes the recommended resources for containers belonging to the pod. There can be at most one entry for every named container and optionally a single wildcard entry with `containerName` = '&#42;', which handles all containers that don't have individual policies.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public PodResourcePolicy(List<ContainerResourcePolicy> containerPolicies) {
         this.containerPolicies = containerPolicies;
     }
 
+    /**
+     * Per-container resource policies.
+     */
     @JsonProperty("containerPolicies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ContainerResourcePolicy> getContainerPolicies() {
         return containerPolicies;
     }
 
+    /**
+     * Per-container resource policies.
+     */
     @JsonProperty("containerPolicies")
     public void setContainerPolicies(List<ContainerResourcePolicy> containerPolicies) {
         this.containerPolicies = containerPolicies;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/PodUpdatePolicy.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/PodUpdatePolicy.java
index 371957c2e76..8e14df9541e 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/PodUpdatePolicy.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/PodUpdatePolicy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodUpdatePolicy describes the rules on how changes are applied to the pods.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public PodUpdatePolicy(String updateMode) {
         this.updateMode = updateMode;
     }
 
+    /**
+     * Controls when autoscaler applies changes to the pod resources. The default is 'Auto'.
+     */
     @JsonProperty("updateMode")
     public String getUpdateMode() {
         return updateMode;
     }
 
+    /**
+     * Controls when autoscaler applies changes to the pod resources. The default is 'Auto'.
+     */
     @JsonProperty("updateMode")
     public void setUpdateMode(String updateMode) {
         this.updateMode = updateMode;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/RecommendedContainerResources.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/RecommendedContainerResources.java
index 072e36df37e..ff0601eff01 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/RecommendedContainerResources.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/RecommendedContainerResources.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RecommendedContainerResources is the recommendation of resources computed by autoscaler for a specific container. Respects the container resource policy if present in the spec. In particular the recommendation is not produced for containers with `ContainerScalingMode` set to 'Off'.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -99,55 +102,85 @@ public RecommendedContainerResources(String containerName, Map<String, Quantity>
         this.upperBound = upperBound;
     }
 
+    /**
+     * Name of the container.
+     */
     @JsonProperty("containerName")
     public String getContainerName() {
         return containerName;
     }
 
+    /**
+     * Name of the container.
+     */
     @JsonProperty("containerName")
     public void setContainerName(String containerName) {
         this.containerName = containerName;
     }
 
+    /**
+     * Minimum recommended amount of resources. Observes ContainerResourcePolicy. This amount is not guaranteed to be sufficient for the application to operate in a stable way, however running with less resources is likely to have significant impact on performance/availability.
+     */
     @JsonProperty("lowerBound")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getLowerBound() {
         return lowerBound;
     }
 
+    /**
+     * Minimum recommended amount of resources. Observes ContainerResourcePolicy. This amount is not guaranteed to be sufficient for the application to operate in a stable way, however running with less resources is likely to have significant impact on performance/availability.
+     */
     @JsonProperty("lowerBound")
     public void setLowerBound(Map<String, Quantity> lowerBound) {
         this.lowerBound = lowerBound;
     }
 
+    /**
+     * Recommended amount of resources. Observes ContainerResourcePolicy.
+     */
     @JsonProperty("target")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getTarget() {
         return target;
     }
 
+    /**
+     * Recommended amount of resources. Observes ContainerResourcePolicy.
+     */
     @JsonProperty("target")
     public void setTarget(Map<String, Quantity> target) {
         this.target = target;
     }
 
+    /**
+     * The most recent recommended resources target computed by the autoscaler for the controlled pods, based only on actual resource usage, not taking into account the ContainerResourcePolicy. May differ from the Recommendation if the actual resource usage causes the target to violate the ContainerResourcePolicy (lower than MinAllowed or higher that MaxAllowed). Used only as status indication, will not affect actual resource assignment.
+     */
     @JsonProperty("uncappedTarget")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getUncappedTarget() {
         return uncappedTarget;
     }
 
+    /**
+     * The most recent recommended resources target computed by the autoscaler for the controlled pods, based only on actual resource usage, not taking into account the ContainerResourcePolicy. May differ from the Recommendation if the actual resource usage causes the target to violate the ContainerResourcePolicy (lower than MinAllowed or higher that MaxAllowed). Used only as status indication, will not affect actual resource assignment.
+     */
     @JsonProperty("uncappedTarget")
     public void setUncappedTarget(Map<String, Quantity> uncappedTarget) {
         this.uncappedTarget = uncappedTarget;
     }
 
+    /**
+     * Maximum recommended amount of resources. Observes ContainerResourcePolicy. Any resources allocated beyond this value are likely wasted. This value may be larger than the maximum amount of application is actually capable of consuming.
+     */
     @JsonProperty("upperBound")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getUpperBound() {
         return upperBound;
     }
 
+    /**
+     * Maximum recommended amount of resources. Observes ContainerResourcePolicy. Any resources allocated beyond this value are likely wasted. This value may be larger than the maximum amount of application is actually capable of consuming.
+     */
     @JsonProperty("upperBound")
     public void setUpperBound(Map<String, Quantity> upperBound) {
         this.upperBound = upperBound;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/RecommendedPodResources.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/RecommendedPodResources.java
index e6d983bf2db..3ffeaaec643 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/RecommendedPodResources.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/RecommendedPodResources.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RecommendedPodResources is the recommendation of resources computed by autoscaler. It contains a recommendation for each container in the pod (except for those with `ContainerScalingMode` set to 'Off').
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public RecommendedPodResources(List<RecommendedContainerResources> containerReco
         this.containerRecommendations = containerRecommendations;
     }
 
+    /**
+     * Resources recommended by the autoscaler for each container.
+     */
     @JsonProperty("containerRecommendations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RecommendedContainerResources> getContainerRecommendations() {
         return containerRecommendations;
     }
 
+    /**
+     * Resources recommended by the autoscaler for each container.
+     */
     @JsonProperty("containerRecommendations")
     public void setContainerRecommendations(List<RecommendedContainerResources> containerRecommendations) {
         this.containerRecommendations = containerRecommendations;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscaler.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscaler.java
index 4c8969726ef..7967222e121 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscaler.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscaler.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerticalPodAutoscaler is the configuration for a vertical pod autoscaler, which automatically manages pod resources based on historical and real time resource utilization.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class VerticalPodAutoscaler implements Editable<VerticalPodAutoscalerBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VerticalPodAutoscaler";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public VerticalPodAutoscaler(String apiVersion, String kind, ObjectMeta metadata
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VerticalPodAutoscaler is the configuration for a vertical pod autoscaler, which automatically manages pod resources based on historical and real time resource utilization.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VerticalPodAutoscaler is the configuration for a vertical pod autoscaler, which automatically manages pod resources based on historical and real time resource utilization.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * VerticalPodAutoscaler is the configuration for a vertical pod autoscaler, which automatically manages pod resources based on historical and real time resource utilization.
+     */
     @JsonProperty("spec")
     public VerticalPodAutoscalerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * VerticalPodAutoscaler is the configuration for a vertical pod autoscaler, which automatically manages pod resources based on historical and real time resource utilization.
+     */
     @JsonProperty("spec")
     public void setSpec(VerticalPodAutoscalerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * VerticalPodAutoscaler is the configuration for a vertical pod autoscaler, which automatically manages pod resources based on historical and real time resource utilization.
+     */
     @JsonProperty("status")
     public VerticalPodAutoscalerStatus getStatus() {
         return status;
     }
 
+    /**
+     * VerticalPodAutoscaler is the configuration for a vertical pod autoscaler, which automatically manages pod resources based on historical and real time resource utilization.
+     */
     @JsonProperty("status")
     public void setStatus(VerticalPodAutoscalerStatus status) {
         this.status = status;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerCheckpoint.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerCheckpoint.java
index f33b861b95b..1b0880eaaea 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerCheckpoint.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerCheckpoint.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerticalPodAutoscalerCheckpoint is the checkpoint of the internal state of VPA that is used for recovery after recommender's restart.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class VerticalPodAutoscalerCheckpoint implements Editable<VerticalPodAutoscalerCheckpointBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VerticalPodAutoscalerCheckpoint";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public VerticalPodAutoscalerCheckpoint(String apiVersion, String kind, ObjectMet
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpoint is the checkpoint of the internal state of VPA that is used for recovery after recommender's restart.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpoint is the checkpoint of the internal state of VPA that is used for recovery after recommender's restart.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpoint is the checkpoint of the internal state of VPA that is used for recovery after recommender's restart.
+     */
     @JsonProperty("spec")
     public VerticalPodAutoscalerCheckpointSpec getSpec() {
         return spec;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpoint is the checkpoint of the internal state of VPA that is used for recovery after recommender's restart.
+     */
     @JsonProperty("spec")
     public void setSpec(VerticalPodAutoscalerCheckpointSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpoint is the checkpoint of the internal state of VPA that is used for recovery after recommender's restart.
+     */
     @JsonProperty("status")
     public VerticalPodAutoscalerCheckpointStatus getStatus() {
         return status;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpoint is the checkpoint of the internal state of VPA that is used for recovery after recommender's restart.
+     */
     @JsonProperty("status")
     public void setStatus(VerticalPodAutoscalerCheckpointStatus status) {
         this.status = status;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerCheckpointList.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerCheckpointList.java
index e15792c9b46..d978d45a0fa 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerCheckpointList.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerCheckpointList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerticalPodAutoscalerCheckpointList is a list of VerticalPodAutoscalerCheckpoint objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class VerticalPodAutoscalerCheckpointList implements Editable<VerticalPodAutoscalerCheckpointListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.autoscaling.api.model.v1beta1.VerticalPodAutoscalerCheckpoint>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.autoscaling.api.model.v1beta1.VerticalPodAutoscalerCheckpoint> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VerticalPodAutoscalerCheckpointList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public VerticalPodAutoscalerCheckpointList(String apiVersion, List<io.fabric8.au
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointList is a list of VerticalPodAutoscalerCheckpoint objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.autoscaling.api.model.v1beta1.VerticalPodAutoscalerCheckpoint> getItems() {
         return items;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointList is a list of VerticalPodAutoscalerCheckpoint objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.autoscaling.api.model.v1beta1.VerticalPodAutoscalerCheckpoint> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointList is a list of VerticalPodAutoscalerCheckpoint objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointList is a list of VerticalPodAutoscalerCheckpoint objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerCheckpointSpec.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerCheckpointSpec.java
index 839ed3ec04d..9f114d4d95b 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerCheckpointSpec.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerCheckpointSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerticalPodAutoscalerCheckpointSpec is the specification of the checkpoint object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public VerticalPodAutoscalerCheckpointSpec(String containerName, String vpaObjec
         this.vpaObjectName = vpaObjectName;
     }
 
+    /**
+     * Name of the checkpointed container.
+     */
     @JsonProperty("containerName")
     public String getContainerName() {
         return containerName;
     }
 
+    /**
+     * Name of the checkpointed container.
+     */
     @JsonProperty("containerName")
     public void setContainerName(String containerName) {
         this.containerName = containerName;
     }
 
+    /**
+     * Name of the VPA object that stored VerticalPodAutoscalerCheckpoint object.
+     */
     @JsonProperty("vpaObjectName")
     public String getVpaObjectName() {
         return vpaObjectName;
     }
 
+    /**
+     * Name of the VPA object that stored VerticalPodAutoscalerCheckpoint object.
+     */
     @JsonProperty("vpaObjectName")
     public void setVpaObjectName(String vpaObjectName) {
         this.vpaObjectName = vpaObjectName;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerCheckpointStatus.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerCheckpointStatus.java
index 56088e03380..31f8507f75e 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerCheckpointStatus.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerCheckpointStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,71 +105,113 @@ public VerticalPodAutoscalerCheckpointStatus(HistogramCheckpoint cpuHistogram, S
         this.version = version;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("cpuHistogram")
     public HistogramCheckpoint getCpuHistogram() {
         return cpuHistogram;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("cpuHistogram")
     public void setCpuHistogram(HistogramCheckpoint cpuHistogram) {
         this.cpuHistogram = cpuHistogram;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("firstSampleStart")
     public String getFirstSampleStart() {
         return firstSampleStart;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("firstSampleStart")
     public void setFirstSampleStart(String firstSampleStart) {
         this.firstSampleStart = firstSampleStart;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("lastSampleStart")
     public String getLastSampleStart() {
         return lastSampleStart;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("lastSampleStart")
     public void setLastSampleStart(String lastSampleStart) {
         this.lastSampleStart = lastSampleStart;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("lastUpdateTime")
     public String getLastUpdateTime() {
         return lastUpdateTime;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("lastUpdateTime")
     public void setLastUpdateTime(String lastUpdateTime) {
         this.lastUpdateTime = lastUpdateTime;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("memoryHistogram")
     public HistogramCheckpoint getMemoryHistogram() {
         return memoryHistogram;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("memoryHistogram")
     public void setMemoryHistogram(HistogramCheckpoint memoryHistogram) {
         this.memoryHistogram = memoryHistogram;
     }
 
+    /**
+     * Total number of samples in the histograms.
+     */
     @JsonProperty("totalSamplesCount")
     public Integer getTotalSamplesCount() {
         return totalSamplesCount;
     }
 
+    /**
+     * Total number of samples in the histograms.
+     */
     @JsonProperty("totalSamplesCount")
     public void setTotalSamplesCount(Integer totalSamplesCount) {
         this.totalSamplesCount = totalSamplesCount;
     }
 
+    /**
+     * Version of the format of the stored data.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * Version of the format of the stored data.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerCondition.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerCondition.java
index 798cfe3b6ec..7c5c9eca19d 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerCondition.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerticalPodAutoscalerCondition describes the state of a VerticalPodAutoscaler at a certain point.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public VerticalPodAutoscalerCondition(String lastTransitionTime, String message,
         this.type = type;
     }
 
+    /**
+     * VerticalPodAutoscalerCondition describes the state of a VerticalPodAutoscaler at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * VerticalPodAutoscalerCondition describes the state of a VerticalPodAutoscaler at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * message is a human-readable explanation containing details about the transition
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message is a human-readable explanation containing details about the transition
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * reason is the reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * reason is the reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * status is the status of the condition (True, False, Unknown)
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * status is the status of the condition (True, False, Unknown)
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * type describes the current condition
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type describes the current condition
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerList.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerList.java
index c9cf4cffd02..96d005ab5fd 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerList.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerticalPodAutoscalerList is a list of VerticalPodAutoscaler objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class VerticalPodAutoscalerList implements Editable<VerticalPodAutoscalerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.autoscaling.api.model.v1beta1.VerticalPodAutoscaler>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.autoscaling.api.model.v1beta1.VerticalPodAutoscaler> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VerticalPodAutoscalerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public VerticalPodAutoscalerList(String apiVersion, List<io.fabric8.autoscaling.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of vertical pod autoscaler objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.autoscaling.api.model.v1beta1.VerticalPodAutoscaler> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of vertical pod autoscaler objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.autoscaling.api.model.v1beta1.VerticalPodAutoscaler> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VerticalPodAutoscalerList is a list of VerticalPodAutoscaler objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VerticalPodAutoscalerList is a list of VerticalPodAutoscaler objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerSpec.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerSpec.java
index d0ecba336f8..0f3c16dde09 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerSpec.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerticalPodAutoscalerSpec is the specification of the behavior of the autoscaler.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public VerticalPodAutoscalerSpec(PodResourcePolicy resourcePolicy, LabelSelector
         this.updatePolicy = updatePolicy;
     }
 
+    /**
+     * VerticalPodAutoscalerSpec is the specification of the behavior of the autoscaler.
+     */
     @JsonProperty("resourcePolicy")
     public PodResourcePolicy getResourcePolicy() {
         return resourcePolicy;
     }
 
+    /**
+     * VerticalPodAutoscalerSpec is the specification of the behavior of the autoscaler.
+     */
     @JsonProperty("resourcePolicy")
     public void setResourcePolicy(PodResourcePolicy resourcePolicy) {
         this.resourcePolicy = resourcePolicy;
     }
 
+    /**
+     * VerticalPodAutoscalerSpec is the specification of the behavior of the autoscaler.
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * VerticalPodAutoscalerSpec is the specification of the behavior of the autoscaler.
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * VerticalPodAutoscalerSpec is the specification of the behavior of the autoscaler.
+     */
     @JsonProperty("updatePolicy")
     public PodUpdatePolicy getUpdatePolicy() {
         return updatePolicy;
     }
 
+    /**
+     * VerticalPodAutoscalerSpec is the specification of the behavior of the autoscaler.
+     */
     @JsonProperty("updatePolicy")
     public void setUpdatePolicy(PodUpdatePolicy updatePolicy) {
         this.updatePolicy = updatePolicy;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerStatus.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerStatus.java
index 76d2c9314f7..28a0366660f 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerStatus.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta1/VerticalPodAutoscalerStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerticalPodAutoscalerStatus describes the runtime state of the autoscaler.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public VerticalPodAutoscalerStatus(List<VerticalPodAutoscalerCondition> conditio
         this.recommendation = recommendation;
     }
 
+    /**
+     * Conditions is the set of conditions required for this autoscaler to scale its target, and indicates whether or not those conditions are met.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VerticalPodAutoscalerCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions is the set of conditions required for this autoscaler to scale its target, and indicates whether or not those conditions are met.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<VerticalPodAutoscalerCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * VerticalPodAutoscalerStatus describes the runtime state of the autoscaler.
+     */
     @JsonProperty("recommendation")
     public RecommendedPodResources getRecommendation() {
         return recommendation;
     }
 
+    /**
+     * VerticalPodAutoscalerStatus describes the runtime state of the autoscaler.
+     */
     @JsonProperty("recommendation")
     public void setRecommendation(RecommendedPodResources recommendation) {
         this.recommendation = recommendation;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/ContainerResourcePolicy.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/ContainerResourcePolicy.java
index d556a20e4a5..dbd82f6e4ad 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/ContainerResourcePolicy.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/ContainerResourcePolicy.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerResourcePolicy controls how autoscaler computes the recommended resources for a specific container.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,43 +96,67 @@ public ContainerResourcePolicy(String containerName, Map<String, Quantity> maxAl
         this.mode = mode;
     }
 
+    /**
+     * Name of the container or DefaultContainerResourcePolicy, in which case the policy is used by the containers that don't have their own policy specified.
+     */
     @JsonProperty("containerName")
     public String getContainerName() {
         return containerName;
     }
 
+    /**
+     * Name of the container or DefaultContainerResourcePolicy, in which case the policy is used by the containers that don't have their own policy specified.
+     */
     @JsonProperty("containerName")
     public void setContainerName(String containerName) {
         this.containerName = containerName;
     }
 
+    /**
+     * Specifies the maximum amount of resources that will be recommended for the container. The default is no maximum.
+     */
     @JsonProperty("maxAllowed")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getMaxAllowed() {
         return maxAllowed;
     }
 
+    /**
+     * Specifies the maximum amount of resources that will be recommended for the container. The default is no maximum.
+     */
     @JsonProperty("maxAllowed")
     public void setMaxAllowed(Map<String, Quantity> maxAllowed) {
         this.maxAllowed = maxAllowed;
     }
 
+    /**
+     * Specifies the minimal amount of resources that will be recommended for the container. The default is no minimum.
+     */
     @JsonProperty("minAllowed")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getMinAllowed() {
         return minAllowed;
     }
 
+    /**
+     * Specifies the minimal amount of resources that will be recommended for the container. The default is no minimum.
+     */
     @JsonProperty("minAllowed")
     public void setMinAllowed(Map<String, Quantity> minAllowed) {
         this.minAllowed = minAllowed;
     }
 
+    /**
+     * Whether autoscaler is enabled for the container. The default is "Auto".
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Whether autoscaler is enabled for the container. The default is "Auto".
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/HistogramCheckpoint.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/HistogramCheckpoint.java
index 6f488183178..20980da8f8f 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/HistogramCheckpoint.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/HistogramCheckpoint.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HistogramCheckpoint contains data needed to reconstruct the histogram.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,32 +90,50 @@ public HistogramCheckpoint(Map<String, Long> bucketWeights, String referenceTime
         this.totalWeight = totalWeight;
     }
 
+    /**
+     * Map from bucket index to bucket weight.
+     */
     @JsonProperty("bucketWeights")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Long> getBucketWeights() {
         return bucketWeights;
     }
 
+    /**
+     * Map from bucket index to bucket weight.
+     */
     @JsonProperty("bucketWeights")
     public void setBucketWeights(Map<String, Long> bucketWeights) {
         this.bucketWeights = bucketWeights;
     }
 
+    /**
+     * HistogramCheckpoint contains data needed to reconstruct the histogram.
+     */
     @JsonProperty("referenceTimestamp")
     public String getReferenceTimestamp() {
         return referenceTimestamp;
     }
 
+    /**
+     * HistogramCheckpoint contains data needed to reconstruct the histogram.
+     */
     @JsonProperty("referenceTimestamp")
     public void setReferenceTimestamp(String referenceTimestamp) {
         this.referenceTimestamp = referenceTimestamp;
     }
 
+    /**
+     * Sum of samples to be used as denominator for weights from BucketWeights.
+     */
     @JsonProperty("totalWeight")
     public Double getTotalWeight() {
         return totalWeight;
     }
 
+    /**
+     * Sum of samples to be used as denominator for weights from BucketWeights.
+     */
     @JsonProperty("totalWeight")
     public void setTotalWeight(Double totalWeight) {
         this.totalWeight = totalWeight;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/PodResourcePolicy.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/PodResourcePolicy.java
index b0893bd3c86..df84d37529e 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/PodResourcePolicy.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/PodResourcePolicy.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodResourcePolicy controls how autoscaler computes the recommended resources for containers belonging to the pod. There can be at most one entry for every named container and optionally a single wildcard entry with `containerName` = '&#42;', which handles all containers that don't have individual policies.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public PodResourcePolicy(List<ContainerResourcePolicy> containerPolicies) {
         this.containerPolicies = containerPolicies;
     }
 
+    /**
+     * Per-container resource policies.
+     */
     @JsonProperty("containerPolicies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ContainerResourcePolicy> getContainerPolicies() {
         return containerPolicies;
     }
 
+    /**
+     * Per-container resource policies.
+     */
     @JsonProperty("containerPolicies")
     public void setContainerPolicies(List<ContainerResourcePolicy> containerPolicies) {
         this.containerPolicies = containerPolicies;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/PodUpdatePolicy.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/PodUpdatePolicy.java
index 0adce289e67..793cf37388c 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/PodUpdatePolicy.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/PodUpdatePolicy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodUpdatePolicy describes the rules on how changes are applied to the pods.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public PodUpdatePolicy(String updateMode) {
         this.updateMode = updateMode;
     }
 
+    /**
+     * Controls when autoscaler applies changes to the pod resources. The default is 'Auto'.
+     */
     @JsonProperty("updateMode")
     public String getUpdateMode() {
         return updateMode;
     }
 
+    /**
+     * Controls when autoscaler applies changes to the pod resources. The default is 'Auto'.
+     */
     @JsonProperty("updateMode")
     public void setUpdateMode(String updateMode) {
         this.updateMode = updateMode;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/RecommendedContainerResources.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/RecommendedContainerResources.java
index 3ec228d6799..8820b156e02 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/RecommendedContainerResources.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/RecommendedContainerResources.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RecommendedContainerResources is the recommendation of resources computed by autoscaler for a specific container. Respects the container resource policy if present in the spec. In particular the recommendation is not produced for containers with `ContainerScalingMode` set to 'Off'.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -99,55 +102,85 @@ public RecommendedContainerResources(String containerName, Map<String, Quantity>
         this.upperBound = upperBound;
     }
 
+    /**
+     * Name of the container.
+     */
     @JsonProperty("containerName")
     public String getContainerName() {
         return containerName;
     }
 
+    /**
+     * Name of the container.
+     */
     @JsonProperty("containerName")
     public void setContainerName(String containerName) {
         this.containerName = containerName;
     }
 
+    /**
+     * Minimum recommended amount of resources. Observes ContainerResourcePolicy. This amount is not guaranteed to be sufficient for the application to operate in a stable way, however running with less resources is likely to have significant impact on performance/availability.
+     */
     @JsonProperty("lowerBound")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getLowerBound() {
         return lowerBound;
     }
 
+    /**
+     * Minimum recommended amount of resources. Observes ContainerResourcePolicy. This amount is not guaranteed to be sufficient for the application to operate in a stable way, however running with less resources is likely to have significant impact on performance/availability.
+     */
     @JsonProperty("lowerBound")
     public void setLowerBound(Map<String, Quantity> lowerBound) {
         this.lowerBound = lowerBound;
     }
 
+    /**
+     * Recommended amount of resources. Observes ContainerResourcePolicy.
+     */
     @JsonProperty("target")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getTarget() {
         return target;
     }
 
+    /**
+     * Recommended amount of resources. Observes ContainerResourcePolicy.
+     */
     @JsonProperty("target")
     public void setTarget(Map<String, Quantity> target) {
         this.target = target;
     }
 
+    /**
+     * The most recent recommended resources target computed by the autoscaler for the controlled pods, based only on actual resource usage, not taking into account the ContainerResourcePolicy. May differ from the Recommendation if the actual resource usage causes the target to violate the ContainerResourcePolicy (lower than MinAllowed or higher that MaxAllowed). Used only as status indication, will not affect actual resource assignment.
+     */
     @JsonProperty("uncappedTarget")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getUncappedTarget() {
         return uncappedTarget;
     }
 
+    /**
+     * The most recent recommended resources target computed by the autoscaler for the controlled pods, based only on actual resource usage, not taking into account the ContainerResourcePolicy. May differ from the Recommendation if the actual resource usage causes the target to violate the ContainerResourcePolicy (lower than MinAllowed or higher that MaxAllowed). Used only as status indication, will not affect actual resource assignment.
+     */
     @JsonProperty("uncappedTarget")
     public void setUncappedTarget(Map<String, Quantity> uncappedTarget) {
         this.uncappedTarget = uncappedTarget;
     }
 
+    /**
+     * Maximum recommended amount of resources. Observes ContainerResourcePolicy. Any resources allocated beyond this value are likely wasted. This value may be larger than the maximum amount of application is actually capable of consuming.
+     */
     @JsonProperty("upperBound")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getUpperBound() {
         return upperBound;
     }
 
+    /**
+     * Maximum recommended amount of resources. Observes ContainerResourcePolicy. Any resources allocated beyond this value are likely wasted. This value may be larger than the maximum amount of application is actually capable of consuming.
+     */
     @JsonProperty("upperBound")
     public void setUpperBound(Map<String, Quantity> upperBound) {
         this.upperBound = upperBound;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/RecommendedPodResources.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/RecommendedPodResources.java
index dca4eba841e..c116dc81311 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/RecommendedPodResources.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/RecommendedPodResources.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RecommendedPodResources is the recommendation of resources computed by autoscaler. It contains a recommendation for each container in the pod (except for those with `ContainerScalingMode` set to 'Off').
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public RecommendedPodResources(List<RecommendedContainerResources> containerReco
         this.containerRecommendations = containerRecommendations;
     }
 
+    /**
+     * Resources recommended by the autoscaler for each container.
+     */
     @JsonProperty("containerRecommendations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RecommendedContainerResources> getContainerRecommendations() {
         return containerRecommendations;
     }
 
+    /**
+     * Resources recommended by the autoscaler for each container.
+     */
     @JsonProperty("containerRecommendations")
     public void setContainerRecommendations(List<RecommendedContainerResources> containerRecommendations) {
         this.containerRecommendations = containerRecommendations;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscaler.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscaler.java
index 738aad7a8c2..87ab4539f28 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscaler.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscaler.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerticalPodAutoscaler is the configuration for a vertical pod autoscaler, which automatically manages pod resources based on historical and real time resource utilization.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class VerticalPodAutoscaler implements Editable<VerticalPodAutoscalerBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling.k8s.io/v1beta2";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VerticalPodAutoscaler";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public VerticalPodAutoscaler(String apiVersion, String kind, ObjectMeta metadata
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VerticalPodAutoscaler is the configuration for a vertical pod autoscaler, which automatically manages pod resources based on historical and real time resource utilization.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VerticalPodAutoscaler is the configuration for a vertical pod autoscaler, which automatically manages pod resources based on historical and real time resource utilization.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * VerticalPodAutoscaler is the configuration for a vertical pod autoscaler, which automatically manages pod resources based on historical and real time resource utilization.
+     */
     @JsonProperty("spec")
     public VerticalPodAutoscalerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * VerticalPodAutoscaler is the configuration for a vertical pod autoscaler, which automatically manages pod resources based on historical and real time resource utilization.
+     */
     @JsonProperty("spec")
     public void setSpec(VerticalPodAutoscalerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * VerticalPodAutoscaler is the configuration for a vertical pod autoscaler, which automatically manages pod resources based on historical and real time resource utilization.
+     */
     @JsonProperty("status")
     public VerticalPodAutoscalerStatus getStatus() {
         return status;
     }
 
+    /**
+     * VerticalPodAutoscaler is the configuration for a vertical pod autoscaler, which automatically manages pod resources based on historical and real time resource utilization.
+     */
     @JsonProperty("status")
     public void setStatus(VerticalPodAutoscalerStatus status) {
         this.status = status;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerCheckpoint.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerCheckpoint.java
index 26d01a504cd..a55576cc5ba 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerCheckpoint.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerCheckpoint.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerticalPodAutoscalerCheckpoint is the checkpoint of the internal state of VPA that is used for recovery after recommender's restart.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class VerticalPodAutoscalerCheckpoint implements Editable<VerticalPodAutoscalerCheckpointBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling.k8s.io/v1beta2";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VerticalPodAutoscalerCheckpoint";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public VerticalPodAutoscalerCheckpoint(String apiVersion, String kind, ObjectMet
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpoint is the checkpoint of the internal state of VPA that is used for recovery after recommender's restart.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpoint is the checkpoint of the internal state of VPA that is used for recovery after recommender's restart.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpoint is the checkpoint of the internal state of VPA that is used for recovery after recommender's restart.
+     */
     @JsonProperty("spec")
     public VerticalPodAutoscalerCheckpointSpec getSpec() {
         return spec;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpoint is the checkpoint of the internal state of VPA that is used for recovery after recommender's restart.
+     */
     @JsonProperty("spec")
     public void setSpec(VerticalPodAutoscalerCheckpointSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpoint is the checkpoint of the internal state of VPA that is used for recovery after recommender's restart.
+     */
     @JsonProperty("status")
     public VerticalPodAutoscalerCheckpointStatus getStatus() {
         return status;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpoint is the checkpoint of the internal state of VPA that is used for recovery after recommender's restart.
+     */
     @JsonProperty("status")
     public void setStatus(VerticalPodAutoscalerCheckpointStatus status) {
         this.status = status;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerCheckpointList.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerCheckpointList.java
index 8e7b846240f..e916fb98967 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerCheckpointList.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerCheckpointList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerticalPodAutoscalerCheckpointList is a list of VerticalPodAutoscalerCheckpoint objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class VerticalPodAutoscalerCheckpointList implements Editable<VerticalPodAutoscalerCheckpointListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.autoscaling.api.model.v1beta2.VerticalPodAutoscalerCheckpoint>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling.k8s.io/v1beta2";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.autoscaling.api.model.v1beta2.VerticalPodAutoscalerCheckpoint> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VerticalPodAutoscalerCheckpointList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public VerticalPodAutoscalerCheckpointList(String apiVersion, List<io.fabric8.au
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointList is a list of VerticalPodAutoscalerCheckpoint objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.autoscaling.api.model.v1beta2.VerticalPodAutoscalerCheckpoint> getItems() {
         return items;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointList is a list of VerticalPodAutoscalerCheckpoint objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.autoscaling.api.model.v1beta2.VerticalPodAutoscalerCheckpoint> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointList is a list of VerticalPodAutoscalerCheckpoint objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointList is a list of VerticalPodAutoscalerCheckpoint objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerCheckpointSpec.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerCheckpointSpec.java
index 198a5268ecc..f96de73afe4 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerCheckpointSpec.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerCheckpointSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerticalPodAutoscalerCheckpointSpec is the specification of the checkpoint object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public VerticalPodAutoscalerCheckpointSpec(String containerName, String vpaObjec
         this.vpaObjectName = vpaObjectName;
     }
 
+    /**
+     * Name of the checkpointed container.
+     */
     @JsonProperty("containerName")
     public String getContainerName() {
         return containerName;
     }
 
+    /**
+     * Name of the checkpointed container.
+     */
     @JsonProperty("containerName")
     public void setContainerName(String containerName) {
         this.containerName = containerName;
     }
 
+    /**
+     * Name of the VPA object that stored VerticalPodAutoscalerCheckpoint object.
+     */
     @JsonProperty("vpaObjectName")
     public String getVpaObjectName() {
         return vpaObjectName;
     }
 
+    /**
+     * Name of the VPA object that stored VerticalPodAutoscalerCheckpoint object.
+     */
     @JsonProperty("vpaObjectName")
     public void setVpaObjectName(String vpaObjectName) {
         this.vpaObjectName = vpaObjectName;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerCheckpointStatus.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerCheckpointStatus.java
index d11342be4f5..be1d803b60d 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerCheckpointStatus.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerCheckpointStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,71 +105,113 @@ public VerticalPodAutoscalerCheckpointStatus(HistogramCheckpoint cpuHistogram, S
         this.version = version;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("cpuHistogram")
     public HistogramCheckpoint getCpuHistogram() {
         return cpuHistogram;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("cpuHistogram")
     public void setCpuHistogram(HistogramCheckpoint cpuHistogram) {
         this.cpuHistogram = cpuHistogram;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("firstSampleStart")
     public String getFirstSampleStart() {
         return firstSampleStart;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("firstSampleStart")
     public void setFirstSampleStart(String firstSampleStart) {
         this.firstSampleStart = firstSampleStart;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("lastSampleStart")
     public String getLastSampleStart() {
         return lastSampleStart;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("lastSampleStart")
     public void setLastSampleStart(String lastSampleStart) {
         this.lastSampleStart = lastSampleStart;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("lastUpdateTime")
     public String getLastUpdateTime() {
         return lastUpdateTime;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("lastUpdateTime")
     public void setLastUpdateTime(String lastUpdateTime) {
         this.lastUpdateTime = lastUpdateTime;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("memoryHistogram")
     public HistogramCheckpoint getMemoryHistogram() {
         return memoryHistogram;
     }
 
+    /**
+     * VerticalPodAutoscalerCheckpointStatus contains data of the checkpoint.
+     */
     @JsonProperty("memoryHistogram")
     public void setMemoryHistogram(HistogramCheckpoint memoryHistogram) {
         this.memoryHistogram = memoryHistogram;
     }
 
+    /**
+     * Total number of samples in the histograms.
+     */
     @JsonProperty("totalSamplesCount")
     public Integer getTotalSamplesCount() {
         return totalSamplesCount;
     }
 
+    /**
+     * Total number of samples in the histograms.
+     */
     @JsonProperty("totalSamplesCount")
     public void setTotalSamplesCount(Integer totalSamplesCount) {
         this.totalSamplesCount = totalSamplesCount;
     }
 
+    /**
+     * Version of the format of the stored data.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * Version of the format of the stored data.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerCondition.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerCondition.java
index ef3f4e09b16..e060a1619e9 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerCondition.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerticalPodAutoscalerCondition describes the state of a VerticalPodAutoscaler at a certain point.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public VerticalPodAutoscalerCondition(String lastTransitionTime, String message,
         this.type = type;
     }
 
+    /**
+     * VerticalPodAutoscalerCondition describes the state of a VerticalPodAutoscaler at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * VerticalPodAutoscalerCondition describes the state of a VerticalPodAutoscaler at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * message is a human-readable explanation containing details about the transition
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message is a human-readable explanation containing details about the transition
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * reason is the reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * reason is the reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * status is the status of the condition (True, False, Unknown)
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * status is the status of the condition (True, False, Unknown)
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * type describes the current condition
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type describes the current condition
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerList.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerList.java
index f7997327de4..c09d68c139e 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerList.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerticalPodAutoscalerList is a list of VerticalPodAutoscaler objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class VerticalPodAutoscalerList implements Editable<VerticalPodAutoscalerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.autoscaling.api.model.v1beta2.VerticalPodAutoscaler>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling.k8s.io/v1beta2";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.autoscaling.api.model.v1beta2.VerticalPodAutoscaler> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VerticalPodAutoscalerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public VerticalPodAutoscalerList(String apiVersion, List<io.fabric8.autoscaling.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of vertical pod autoscaler objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.autoscaling.api.model.v1beta2.VerticalPodAutoscaler> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of vertical pod autoscaler objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.autoscaling.api.model.v1beta2.VerticalPodAutoscaler> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VerticalPodAutoscalerList is a list of VerticalPodAutoscaler objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VerticalPodAutoscalerList is a list of VerticalPodAutoscaler objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerSpec.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerSpec.java
index e6d5b0e1e3e..d9f6ba5f52f 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerSpec.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerSpec.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerticalPodAutoscalerSpec is the specification of the behavior of the autoscaler.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,31 +90,49 @@ public VerticalPodAutoscalerSpec(PodResourcePolicy resourcePolicy, CrossVersionO
         this.updatePolicy = updatePolicy;
     }
 
+    /**
+     * VerticalPodAutoscalerSpec is the specification of the behavior of the autoscaler.
+     */
     @JsonProperty("resourcePolicy")
     public PodResourcePolicy getResourcePolicy() {
         return resourcePolicy;
     }
 
+    /**
+     * VerticalPodAutoscalerSpec is the specification of the behavior of the autoscaler.
+     */
     @JsonProperty("resourcePolicy")
     public void setResourcePolicy(PodResourcePolicy resourcePolicy) {
         this.resourcePolicy = resourcePolicy;
     }
 
+    /**
+     * VerticalPodAutoscalerSpec is the specification of the behavior of the autoscaler.
+     */
     @JsonProperty("targetRef")
     public CrossVersionObjectReference getTargetRef() {
         return targetRef;
     }
 
+    /**
+     * VerticalPodAutoscalerSpec is the specification of the behavior of the autoscaler.
+     */
     @JsonProperty("targetRef")
     public void setTargetRef(CrossVersionObjectReference targetRef) {
         this.targetRef = targetRef;
     }
 
+    /**
+     * VerticalPodAutoscalerSpec is the specification of the behavior of the autoscaler.
+     */
     @JsonProperty("updatePolicy")
     public PodUpdatePolicy getUpdatePolicy() {
         return updatePolicy;
     }
 
+    /**
+     * VerticalPodAutoscalerSpec is the specification of the behavior of the autoscaler.
+     */
     @JsonProperty("updatePolicy")
     public void setUpdatePolicy(PodUpdatePolicy updatePolicy) {
         this.updatePolicy = updatePolicy;
diff --git a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerStatus.java b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerStatus.java
index 3f6d60ccdb4..934ba40de75 100644
--- a/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerStatus.java
+++ b/extensions/verticalpodautoscaler/model/src/generated/java/io/fabric8/autoscaling/api/model/v1beta2/VerticalPodAutoscalerStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VerticalPodAutoscalerStatus describes the runtime state of the autoscaler.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public VerticalPodAutoscalerStatus(List<VerticalPodAutoscalerCondition> conditio
         this.recommendation = recommendation;
     }
 
+    /**
+     * Conditions is the set of conditions required for this autoscaler to scale its target, and indicates whether or not those conditions are met.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VerticalPodAutoscalerCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions is the set of conditions required for this autoscaler to scale its target, and indicates whether or not those conditions are met.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<VerticalPodAutoscalerCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * VerticalPodAutoscalerStatus describes the runtime state of the autoscaler.
+     */
     @JsonProperty("recommendation")
     public RecommendedPodResources getRecommendation() {
         return recommendation;
     }
 
+    /**
+     * VerticalPodAutoscalerStatus describes the runtime state of the autoscaler.
+     */
     @JsonProperty("recommendation")
     public void setRecommendation(RecommendedPodResources recommendation) {
         this.recommendation = recommendation;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/DependsOn.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/DependsOn.java
index a4d5ec60475..4bced5d9057 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/DependsOn.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/DependsOn.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DependsOn represents the tasks that this task depends on and their dependencies
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public DependsOn(String iteration, List<String> name) {
         this.name = name;
     }
 
+    /**
+     * This field specifies that when there are multiple dependent tasks, as long as one task becomes the specified state, the task scheduling is triggered or all tasks must be changed to the specified state to trigger the task scheduling
+     */
     @JsonProperty("iteration")
     public String getIteration() {
         return iteration;
     }
 
+    /**
+     * This field specifies that when there are multiple dependent tasks, as long as one task becomes the specified state, the task scheduling is triggered or all tasks must be changed to the specified state to trigger the task scheduling
+     */
     @JsonProperty("iteration")
     public void setIteration(String iteration) {
         this.iteration = iteration;
     }
 
+    /**
+     * Indicates the name of the tasks that this task depends on, which can depend on multiple tasks
+     */
     @JsonProperty("name")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getName() {
         return name;
     }
 
+    /**
+     * Indicates the name of the tasks that this task depends on, which can depend on multiple tasks
+     */
     @JsonProperty("name")
     public void setName(List<String> name) {
         this.name = name;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/Job.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/Job.java
index 06efb45a5d0..247b6777154 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/Job.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/Job.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Job defines the volcano job.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Job implements Editable<JobBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "batch.volcano.sh/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Job";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Job(String apiVersion, String kind, ObjectMeta metadata, JobSpec spec, Jo
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Job defines the volcano job.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Job defines the volcano job.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Job defines the volcano job.
+     */
     @JsonProperty("spec")
     public JobSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Job defines the volcano job.
+     */
     @JsonProperty("spec")
     public void setSpec(JobSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Job defines the volcano job.
+     */
     @JsonProperty("status")
     public JobStatus getStatus() {
         return status;
     }
 
+    /**
+     * Job defines the volcano job.
+     */
     @JsonProperty("status")
     public void setStatus(JobStatus status) {
         this.status = status;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/JobCondition.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/JobCondition.java
index 14b82356ebb..a79864005f1 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/JobCondition.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/JobCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JobCondition contains details for the current condition of this job.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public JobCondition(String lastTransitionTime, String status) {
         this.status = status;
     }
 
+    /**
+     * JobCondition contains details for the current condition of this job.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * JobCondition contains details for the current condition of this job.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Status is the new phase of job after performing the state's action.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status is the new phase of job after performing the state's action.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/JobList.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/JobList.java
index b3d6cec0ecd..317568fe858 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/JobList.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/JobList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JobList defines the list of jobs.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class JobList implements Editable<JobListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.volcano.api.model.batch.v1alpha1.Job>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "batch.volcano.sh/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.volcano.api.model.batch.v1alpha1.Job> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "JobList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public JobList(String apiVersion, List<io.fabric8.volcano.api.model.batch.v1alph
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * JobList defines the list of jobs.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.volcano.api.model.batch.v1alpha1.Job> getItems() {
         return items;
     }
 
+    /**
+     * JobList defines the list of jobs.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.volcano.api.model.batch.v1alpha1.Job> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * JobList defines the list of jobs.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * JobList defines the list of jobs.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/JobSpec.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/JobSpec.java
index 9eeb880347c..0d89aa1c86d 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/JobSpec.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/JobSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JobSpec describes how the job execution will look like and when it will actually run.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -129,125 +132,197 @@ public JobSpec(Integer maxRetry, Integer minAvailable, Integer minSuccess, Map<S
         this.volumes = volumes;
     }
 
+    /**
+     * Specifies the maximum number of retries before marking this Job failed. Defaults to 3.
+     */
     @JsonProperty("maxRetry")
     public Integer getMaxRetry() {
         return maxRetry;
     }
 
+    /**
+     * Specifies the maximum number of retries before marking this Job failed. Defaults to 3.
+     */
     @JsonProperty("maxRetry")
     public void setMaxRetry(Integer maxRetry) {
         this.maxRetry = maxRetry;
     }
 
+    /**
+     * The minimal available pods to run for this Job Defaults to the summary of tasks' replicas
+     */
     @JsonProperty("minAvailable")
     public Integer getMinAvailable() {
         return minAvailable;
     }
 
+    /**
+     * The minimal available pods to run for this Job Defaults to the summary of tasks' replicas
+     */
     @JsonProperty("minAvailable")
     public void setMinAvailable(Integer minAvailable) {
         this.minAvailable = minAvailable;
     }
 
+    /**
+     * The minimal success pods to run for this Job
+     */
     @JsonProperty("minSuccess")
     public Integer getMinSuccess() {
         return minSuccess;
     }
 
+    /**
+     * The minimal success pods to run for this Job
+     */
     @JsonProperty("minSuccess")
     public void setMinSuccess(Integer minSuccess) {
         this.minSuccess = minSuccess;
     }
 
+    /**
+     * Specifies the plugin of job Key is plugin name, value is the arguments of the plugin
+     */
     @JsonProperty("plugins")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<String>> getPlugins() {
         return plugins;
     }
 
+    /**
+     * Specifies the plugin of job Key is plugin name, value is the arguments of the plugin
+     */
     @JsonProperty("plugins")
     public void setPlugins(Map<String, List<String>> plugins) {
         this.plugins = plugins;
     }
 
+    /**
+     * Specifies the default lifecycle of tasks
+     */
     @JsonProperty("policies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LifecyclePolicy> getPolicies() {
         return policies;
     }
 
+    /**
+     * Specifies the default lifecycle of tasks
+     */
     @JsonProperty("policies")
     public void setPolicies(List<LifecyclePolicy> policies) {
         this.policies = policies;
     }
 
+    /**
+     * If specified, indicates the job's priority.
+     */
     @JsonProperty("priorityClassName")
     public String getPriorityClassName() {
         return priorityClassName;
     }
 
+    /**
+     * If specified, indicates the job's priority.
+     */
     @JsonProperty("priorityClassName")
     public void setPriorityClassName(String priorityClassName) {
         this.priorityClassName = priorityClassName;
     }
 
+    /**
+     * Specifies the queue that will be used in the scheduler, "default" queue is used this leaves empty.
+     */
     @JsonProperty("queue")
     public String getQueue() {
         return queue;
     }
 
+    /**
+     * Specifies the queue that will be used in the scheduler, "default" queue is used this leaves empty.
+     */
     @JsonProperty("queue")
     public void setQueue(String queue) {
         this.queue = queue;
     }
 
+    /**
+     * JobSpec describes how the job execution will look like and when it will actually run.
+     */
     @JsonProperty("runningEstimate")
     public Duration getRunningEstimate() {
         return runningEstimate;
     }
 
+    /**
+     * JobSpec describes how the job execution will look like and when it will actually run.
+     */
     @JsonProperty("runningEstimate")
     public void setRunningEstimate(Duration runningEstimate) {
         this.runningEstimate = runningEstimate;
     }
 
+    /**
+     * SchedulerName is the default value of `tasks.template.spec.schedulerName`.
+     */
     @JsonProperty("schedulerName")
     public String getSchedulerName() {
         return schedulerName;
     }
 
+    /**
+     * SchedulerName is the default value of `tasks.template.spec.schedulerName`.
+     */
     @JsonProperty("schedulerName")
     public void setSchedulerName(String schedulerName) {
         this.schedulerName = schedulerName;
     }
 
+    /**
+     * Tasks specifies the task specification of Job
+     */
     @JsonProperty("tasks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TaskSpec> getTasks() {
         return tasks;
     }
 
+    /**
+     * Tasks specifies the task specification of Job
+     */
     @JsonProperty("tasks")
     public void setTasks(List<TaskSpec> tasks) {
         this.tasks = tasks;
     }
 
+    /**
+     * ttlSecondsAfterFinished limits the lifetime of a Job that has finished execution (either Completed or Failed). If this field is set, ttlSecondsAfterFinished after the Job finishes, it is eligible to be automatically deleted. If this field is unset, the Job won't be automatically deleted. If this field is set to zero, the Job becomes eligible to be deleted immediately after it finishes.
+     */
     @JsonProperty("ttlSecondsAfterFinished")
     public Integer getTtlSecondsAfterFinished() {
         return ttlSecondsAfterFinished;
     }
 
+    /**
+     * ttlSecondsAfterFinished limits the lifetime of a Job that has finished execution (either Completed or Failed). If this field is set, ttlSecondsAfterFinished after the Job finishes, it is eligible to be automatically deleted. If this field is unset, the Job won't be automatically deleted. If this field is set to zero, the Job becomes eligible to be deleted immediately after it finishes.
+     */
     @JsonProperty("ttlSecondsAfterFinished")
     public void setTtlSecondsAfterFinished(Integer ttlSecondsAfterFinished) {
         this.ttlSecondsAfterFinished = ttlSecondsAfterFinished;
     }
 
+    /**
+     * The volumes mount on Job
+     */
     @JsonProperty("volumes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VolumeSpec> getVolumes() {
         return volumes;
     }
 
+    /**
+     * The volumes mount on Job
+     */
     @JsonProperty("volumes")
     public void setVolumes(List<VolumeSpec> volumes) {
         this.volumes = volumes;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/JobState.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/JobState.java
index 80dbce768f5..6a230ff78f7 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/JobState.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/JobState.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JobState contains details for the current state of the job.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public JobState(String lastTransitionTime, String message, String phase, String
         this.reason = reason;
     }
 
+    /**
+     * JobState contains details for the current state of the job.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * JobState contains details for the current state of the job.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * The phase of Job.
+     */
     @JsonProperty("phase")
     public String getPhase() {
         return phase;
     }
 
+    /**
+     * The phase of Job.
+     */
     @JsonProperty("phase")
     public void setPhase(String phase) {
         this.phase = phase;
     }
 
+    /**
+     * Unique, one-word, CamelCase reason for the phase's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Unique, one-word, CamelCase reason for the phase's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/JobStatus.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/JobStatus.java
index c45d01341a0..95db7e081bf 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/JobStatus.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/JobStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JobStatus represents the current status of a Job.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -136,144 +139,228 @@ public JobStatus(List<JobCondition> conditions, Map<String, String> controlledRe
         this.version = version;
     }
 
+    /**
+     * Which conditions caused the current job state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<JobCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Which conditions caused the current job state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<JobCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * The resources that controlled by this job, e.g. Service, ConfigMap
+     */
     @JsonProperty("controlledResources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getControlledResources() {
         return controlledResources;
     }
 
+    /**
+     * The resources that controlled by this job, e.g. Service, ConfigMap
+     */
     @JsonProperty("controlledResources")
     public void setControlledResources(Map<String, String> controlledResources) {
         this.controlledResources = controlledResources;
     }
 
+    /**
+     * The number of pods which reached phase Failed.
+     */
     @JsonProperty("failed")
     public Integer getFailed() {
         return failed;
     }
 
+    /**
+     * The number of pods which reached phase Failed.
+     */
     @JsonProperty("failed")
     public void setFailed(Integer failed) {
         this.failed = failed;
     }
 
+    /**
+     * The minimal available pods to run for this Job
+     */
     @JsonProperty("minAvailable")
     public Integer getMinAvailable() {
         return minAvailable;
     }
 
+    /**
+     * The minimal available pods to run for this Job
+     */
     @JsonProperty("minAvailable")
     public void setMinAvailable(Integer minAvailable) {
         this.minAvailable = minAvailable;
     }
 
+    /**
+     * The number of pending pods.
+     */
     @JsonProperty("pending")
     public Integer getPending() {
         return pending;
     }
 
+    /**
+     * The number of pending pods.
+     */
     @JsonProperty("pending")
     public void setPending(Integer pending) {
         this.pending = pending;
     }
 
+    /**
+     * The number of Job retries.
+     */
     @JsonProperty("retryCount")
     public Integer getRetryCount() {
         return retryCount;
     }
 
+    /**
+     * The number of Job retries.
+     */
     @JsonProperty("retryCount")
     public void setRetryCount(Integer retryCount) {
         this.retryCount = retryCount;
     }
 
+    /**
+     * The number of running pods.
+     */
     @JsonProperty("running")
     public Integer getRunning() {
         return running;
     }
 
+    /**
+     * The number of running pods.
+     */
     @JsonProperty("running")
     public void setRunning(Integer running) {
         this.running = running;
     }
 
+    /**
+     * JobStatus represents the current status of a Job.
+     */
     @JsonProperty("runningDuration")
     public Duration getRunningDuration() {
         return runningDuration;
     }
 
+    /**
+     * JobStatus represents the current status of a Job.
+     */
     @JsonProperty("runningDuration")
     public void setRunningDuration(Duration runningDuration) {
         this.runningDuration = runningDuration;
     }
 
+    /**
+     * JobStatus represents the current status of a Job.
+     */
     @JsonProperty("state")
     public JobState getState() {
         return state;
     }
 
+    /**
+     * JobStatus represents the current status of a Job.
+     */
     @JsonProperty("state")
     public void setState(JobState state) {
         this.state = state;
     }
 
+    /**
+     * The number of pods which reached phase Succeeded.
+     */
     @JsonProperty("succeeded")
     public Integer getSucceeded() {
         return succeeded;
     }
 
+    /**
+     * The number of pods which reached phase Succeeded.
+     */
     @JsonProperty("succeeded")
     public void setSucceeded(Integer succeeded) {
         this.succeeded = succeeded;
     }
 
+    /**
+     * The status of pods for each task
+     */
     @JsonProperty("taskStatusCount")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, TaskState> getTaskStatusCount() {
         return taskStatusCount;
     }
 
+    /**
+     * The status of pods for each task
+     */
     @JsonProperty("taskStatusCount")
     public void setTaskStatusCount(Map<String, TaskState> taskStatusCount) {
         this.taskStatusCount = taskStatusCount;
     }
 
+    /**
+     * The number of pods which reached phase Terminating.
+     */
     @JsonProperty("terminating")
     public Integer getTerminating() {
         return terminating;
     }
 
+    /**
+     * The number of pods which reached phase Terminating.
+     */
     @JsonProperty("terminating")
     public void setTerminating(Integer terminating) {
         this.terminating = terminating;
     }
 
+    /**
+     * The number of pods which reached phase Unknown.
+     */
     @JsonProperty("unknown")
     public Integer getUnknown() {
         return unknown;
     }
 
+    /**
+     * The number of pods which reached phase Unknown.
+     */
     @JsonProperty("unknown")
     public void setUnknown(Integer unknown) {
         this.unknown = unknown;
     }
 
+    /**
+     * Current version of job
+     */
     @JsonProperty("version")
     public Integer getVersion() {
         return version;
     }
 
+    /**
+     * Current version of job
+     */
     @JsonProperty("version")
     public void setVersion(Integer version) {
         this.version = version;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/LifecyclePolicy.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/LifecyclePolicy.java
index 9dcf9db54da..c2c2ca3b9cd 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/LifecyclePolicy.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/LifecyclePolicy.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LifecyclePolicy specifies the lifecycle and error handling of task and job.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,52 +101,82 @@ public LifecyclePolicy(String action, String event, List<String> events, Integer
         this.timeout = timeout;
     }
 
+    /**
+     * The action that will be taken to the PodGroup according to Event. One of "Restart", "None". Default to None.
+     */
     @JsonProperty("action")
     public String getAction() {
         return action;
     }
 
+    /**
+     * The action that will be taken to the PodGroup according to Event. One of "Restart", "None". Default to None.
+     */
     @JsonProperty("action")
     public void setAction(String action) {
         this.action = action;
     }
 
+    /**
+     * The Event recorded by scheduler; the controller takes actions according to this Event.
+     */
     @JsonProperty("event")
     public String getEvent() {
         return event;
     }
 
+    /**
+     * The Event recorded by scheduler; the controller takes actions according to this Event.
+     */
     @JsonProperty("event")
     public void setEvent(String event) {
         this.event = event;
     }
 
+    /**
+     * The Events recorded by scheduler; the controller takes actions according to this Events.
+     */
     @JsonProperty("events")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEvents() {
         return events;
     }
 
+    /**
+     * The Events recorded by scheduler; the controller takes actions according to this Events.
+     */
     @JsonProperty("events")
     public void setEvents(List<String> events) {
         this.events = events;
     }
 
+    /**
+     * The exit code of the pod container, controller will take action according to this code. Note: only one of `Event` or `ExitCode` can be specified.
+     */
     @JsonProperty("exitCode")
     public Integer getExitCode() {
         return exitCode;
     }
 
+    /**
+     * The exit code of the pod container, controller will take action according to this code. Note: only one of `Event` or `ExitCode` can be specified.
+     */
     @JsonProperty("exitCode")
     public void setExitCode(Integer exitCode) {
         this.exitCode = exitCode;
     }
 
+    /**
+     * LifecyclePolicy specifies the lifecycle and error handling of task and job.
+     */
     @JsonProperty("timeout")
     public Duration getTimeout() {
         return timeout;
     }
 
+    /**
+     * LifecyclePolicy specifies the lifecycle and error handling of task and job.
+     */
     @JsonProperty("timeout")
     public void setTimeout(Duration timeout) {
         this.timeout = timeout;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/TaskSpec.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/TaskSpec.java
index b070106317a..1e470a73e45 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/TaskSpec.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/TaskSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskSpec specifies the task specification of Job.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -109,82 +112,130 @@ public TaskSpec(DependsOn dependsOn, Integer maxRetry, Integer minAvailable, Str
         this.topologyPolicy = topologyPolicy;
     }
 
+    /**
+     * TaskSpec specifies the task specification of Job.
+     */
     @JsonProperty("dependsOn")
     public DependsOn getDependsOn() {
         return dependsOn;
     }
 
+    /**
+     * TaskSpec specifies the task specification of Job.
+     */
     @JsonProperty("dependsOn")
     public void setDependsOn(DependsOn dependsOn) {
         this.dependsOn = dependsOn;
     }
 
+    /**
+     * Specifies the maximum number of retries before marking this Task failed. Defaults to 3.
+     */
     @JsonProperty("maxRetry")
     public Integer getMaxRetry() {
         return maxRetry;
     }
 
+    /**
+     * Specifies the maximum number of retries before marking this Task failed. Defaults to 3.
+     */
     @JsonProperty("maxRetry")
     public void setMaxRetry(Integer maxRetry) {
         this.maxRetry = maxRetry;
     }
 
+    /**
+     * The minimal available pods to run for this Task Defaults to the task replicas
+     */
     @JsonProperty("minAvailable")
     public Integer getMinAvailable() {
         return minAvailable;
     }
 
+    /**
+     * The minimal available pods to run for this Task Defaults to the task replicas
+     */
     @JsonProperty("minAvailable")
     public void setMinAvailable(Integer minAvailable) {
         this.minAvailable = minAvailable;
     }
 
+    /**
+     * Name specifies the name of tasks
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name specifies the name of tasks
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Specifies the lifecycle of task
+     */
     @JsonProperty("policies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LifecyclePolicy> getPolicies() {
         return policies;
     }
 
+    /**
+     * Specifies the lifecycle of task
+     */
     @JsonProperty("policies")
     public void setPolicies(List<LifecyclePolicy> policies) {
         this.policies = policies;
     }
 
+    /**
+     * Replicas specifies the replicas of this TaskSpec in Job
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Replicas specifies the replicas of this TaskSpec in Job
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * TaskSpec specifies the task specification of Job.
+     */
     @JsonProperty("template")
     public PodTemplateSpec getTemplate() {
         return template;
     }
 
+    /**
+     * TaskSpec specifies the task specification of Job.
+     */
     @JsonProperty("template")
     public void setTemplate(PodTemplateSpec template) {
         this.template = template;
     }
 
+    /**
+     * Specifies the topology policy of task
+     */
     @JsonProperty("topologyPolicy")
     public String getTopologyPolicy() {
         return topologyPolicy;
     }
 
+    /**
+     * Specifies the topology policy of task
+     */
     @JsonProperty("topologyPolicy")
     public void setTopologyPolicy(String topologyPolicy) {
         this.topologyPolicy = topologyPolicy;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/TaskState.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/TaskState.java
index 0c9aeaa9b5e..0a2e452b144 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/TaskState.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/TaskState.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaskState contains details for the current state of the task.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,12 +82,18 @@ public TaskState(Map<String, Integer> phase) {
         this.phase = phase;
     }
 
+    /**
+     * The phase of Task.
+     */
     @JsonProperty("phase")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Integer> getPhase() {
         return phase;
     }
 
+    /**
+     * The phase of Task.
+     */
     @JsonProperty("phase")
     public void setPhase(Map<String, Integer> phase) {
         this.phase = phase;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/VolumeSpec.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/VolumeSpec.java
index fe6aed757ac..c3bd65359ac 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/VolumeSpec.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/batch/v1alpha1/VolumeSpec.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeSpec defines the specification of Volume, e.g. PVC.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,31 +90,49 @@ public VolumeSpec(String mountPath, PersistentVolumeClaimSpec volumeClaim, Strin
         this.volumeClaimName = volumeClaimName;
     }
 
+    /**
+     * Path within the container at which the volume should be mounted.  Must not contain ':'.
+     */
     @JsonProperty("mountPath")
     public String getMountPath() {
         return mountPath;
     }
 
+    /**
+     * Path within the container at which the volume should be mounted.  Must not contain ':'.
+     */
     @JsonProperty("mountPath")
     public void setMountPath(String mountPath) {
         this.mountPath = mountPath;
     }
 
+    /**
+     * VolumeSpec defines the specification of Volume, e.g. PVC.
+     */
     @JsonProperty("volumeClaim")
     public PersistentVolumeClaimSpec getVolumeClaim() {
         return volumeClaim;
     }
 
+    /**
+     * VolumeSpec defines the specification of Volume, e.g. PVC.
+     */
     @JsonProperty("volumeClaim")
     public void setVolumeClaim(PersistentVolumeClaimSpec volumeClaim) {
         this.volumeClaim = volumeClaim;
     }
 
+    /**
+     * defined the PVC name
+     */
     @JsonProperty("volumeClaimName")
     public String getVolumeClaimName() {
         return volumeClaimName;
     }
 
+    /**
+     * defined the PVC name
+     */
     @JsonProperty("volumeClaimName")
     public void setVolumeClaimName(String volumeClaimName) {
         this.volumeClaimName = volumeClaimName;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/bus/v1alpha1/Command.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/bus/v1alpha1/Command.java
index 188763b41bb..fe0e3bff414 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/bus/v1alpha1/Command.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/bus/v1alpha1/Command.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Command defines command structure.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,14 +84,8 @@ public class Command implements Editable<CommandBuilder>, HasMetadata, Namespace
 
     @JsonProperty("action")
     private String action;
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "bus.volcano.sh/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Command";
     @JsonProperty("message")
@@ -119,18 +116,24 @@ public Command(String action, String apiVersion, String kind, String message, Ob
         this.target = target;
     }
 
+    /**
+     * Action defines the action that will be took to the target object.
+     */
     @JsonProperty("action")
     public String getAction() {
         return action;
     }
 
+    /**
+     * Action defines the action that will be took to the target object.
+     */
     @JsonProperty("action")
     public void setAction(String action) {
         this.action = action;
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -138,7 +141,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -146,7 +149,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -154,48 +157,72 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Human-readable message indicating details of this command.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Human-readable message indicating details of this command.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Command defines command structure.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Command defines command structure.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Unique, one-word, CamelCase reason for this command.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Unique, one-word, CamelCase reason for this command.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Command defines command structure.
+     */
     @JsonProperty("target")
     public OwnerReference getTarget() {
         return target;
     }
 
+    /**
+     * Command defines command structure.
+     */
     @JsonProperty("target")
     public void setTarget(OwnerReference target) {
         this.target = target;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/bus/v1alpha1/CommandList.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/bus/v1alpha1/CommandList.java
index 8135ce83f9a..149b2a97d55 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/bus/v1alpha1/CommandList.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/bus/v1alpha1/CommandList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CommandList defines list of commands.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class CommandList implements Editable<CommandListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.volcano.api.model.bus.v1alpha1.Command>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "bus.volcano.sh/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.volcano.api.model.bus.v1alpha1.Command> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CommandList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CommandList(String apiVersion, List<io.fabric8.volcano.api.model.bus.v1al
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * CommandList defines list of commands.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.volcano.api.model.bus.v1alpha1.Command> getItems() {
         return items;
     }
 
+    /**
+     * CommandList defines list of commands.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.volcano.api.model.bus.v1alpha1.Command> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CommandList defines list of commands.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CommandList defines list of commands.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/Flow.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/Flow.java
index 6e62896e8f1..cc24db15544 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/Flow.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/Flow.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Flow defines the dependent of jobs
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Flow(DependsOn dependsOn, String name) {
         this.name = name;
     }
 
+    /**
+     * Flow defines the dependent of jobs
+     */
     @JsonProperty("dependsOn")
     public DependsOn getDependsOn() {
         return dependsOn;
     }
 
+    /**
+     * Flow defines the dependent of jobs
+     */
     @JsonProperty("dependsOn")
     public void setDependsOn(DependsOn dependsOn) {
         this.dependsOn = dependsOn;
     }
 
+    /**
+     * Flow defines the dependent of jobs
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Flow defines the dependent of jobs
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobFlow.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobFlow.java
index beb7d8db5f6..f270582536f 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobFlow.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobFlow.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JobFlow is the Schema for the jobflows API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class JobFlow implements Editable<JobFlowBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "flow.volcano.sh/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "JobFlow";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public JobFlow(String apiVersion, String kind, ObjectMeta metadata, JobFlowSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * JobFlow is the Schema for the jobflows API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * JobFlow is the Schema for the jobflows API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * JobFlow is the Schema for the jobflows API
+     */
     @JsonProperty("spec")
     public JobFlowSpec getSpec() {
         return spec;
     }
 
+    /**
+     * JobFlow is the Schema for the jobflows API
+     */
     @JsonProperty("spec")
     public void setSpec(JobFlowSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * JobFlow is the Schema for the jobflows API
+     */
     @JsonProperty("status")
     public JobFlowStatus getStatus() {
         return status;
     }
 
+    /**
+     * JobFlow is the Schema for the jobflows API
+     */
     @JsonProperty("status")
     public void setStatus(JobFlowStatus status) {
         this.status = status;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobFlowList.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobFlowList.java
index 84b8e00f999..5605cc536e4 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobFlowList.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobFlowList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JobFlowList contains a list of JobFlow
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class JobFlowList implements Editable<JobFlowListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.volcano.api.model.flow.v1alpha1.JobFlow>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "flow.volcano.sh/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.volcano.api.model.flow.v1alpha1.JobFlow> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "JobFlowList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public JobFlowList(String apiVersion, List<io.fabric8.volcano.api.model.flow.v1a
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * JobFlowList contains a list of JobFlow
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.volcano.api.model.flow.v1alpha1.JobFlow> getItems() {
         return items;
     }
 
+    /**
+     * JobFlowList contains a list of JobFlow
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.volcano.api.model.flow.v1alpha1.JobFlow> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * JobFlowList contains a list of JobFlow
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * JobFlowList contains a list of JobFlow
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobFlowSpec.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobFlowSpec.java
index ec3c7285329..5f87c2a1d72 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobFlowSpec.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobFlowSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JobFlowSpec defines the desired state of JobFlow
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public JobFlowSpec(List<Flow> flows, String jobRetainPolicy) {
         this.jobRetainPolicy = jobRetainPolicy;
     }
 
+    /**
+     * Foo is an example field of JobFlow. Edit jobflow_types.go to remove/update
+     */
     @JsonProperty("flows")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Flow> getFlows() {
         return flows;
     }
 
+    /**
+     * Foo is an example field of JobFlow. Edit jobflow_types.go to remove/update
+     */
     @JsonProperty("flows")
     public void setFlows(List<Flow> flows) {
         this.flows = flows;
     }
 
+    /**
+     * JobFlowSpec defines the desired state of JobFlow
+     */
     @JsonProperty("jobRetainPolicy")
     public String getJobRetainPolicy() {
         return jobRetainPolicy;
     }
 
+    /**
+     * JobFlowSpec defines the desired state of JobFlow
+     */
     @JsonProperty("jobRetainPolicy")
     public void setJobRetainPolicy(String jobRetainPolicy) {
         this.jobRetainPolicy = jobRetainPolicy;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobFlowStatus.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobFlowStatus.java
index d1c38826cfb..be39613794b 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobFlowStatus.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobFlowStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JobFlowStatus defines the observed state of JobFlow
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -120,99 +123,153 @@ public JobFlowStatus(List<String> completedJobs, Map<String, Condition> conditio
         this.unKnowJobs = unKnowJobs;
     }
 
+    /**
+     * JobFlowStatus defines the observed state of JobFlow
+     */
     @JsonProperty("completedJobs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCompletedJobs() {
         return completedJobs;
     }
 
+    /**
+     * JobFlowStatus defines the observed state of JobFlow
+     */
     @JsonProperty("completedJobs")
     public void setCompletedJobs(List<String> completedJobs) {
         this.completedJobs = completedJobs;
     }
 
+    /**
+     * JobFlowStatus defines the observed state of JobFlow
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * JobFlowStatus defines the observed state of JobFlow
+     */
     @JsonProperty("conditions")
     public void setConditions(Map<String, Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * JobFlowStatus defines the observed state of JobFlow
+     */
     @JsonProperty("failedJobs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getFailedJobs() {
         return failedJobs;
     }
 
+    /**
+     * JobFlowStatus defines the observed state of JobFlow
+     */
     @JsonProperty("failedJobs")
     public void setFailedJobs(List<String> failedJobs) {
         this.failedJobs = failedJobs;
     }
 
+    /**
+     * JobFlowStatus defines the observed state of JobFlow
+     */
     @JsonProperty("jobStatusList")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<JobStatus> getJobStatusList() {
         return jobStatusList;
     }
 
+    /**
+     * JobFlowStatus defines the observed state of JobFlow
+     */
     @JsonProperty("jobStatusList")
     public void setJobStatusList(List<JobStatus> jobStatusList) {
         this.jobStatusList = jobStatusList;
     }
 
+    /**
+     * JobFlowStatus defines the observed state of JobFlow
+     */
     @JsonProperty("pendingJobs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPendingJobs() {
         return pendingJobs;
     }
 
+    /**
+     * JobFlowStatus defines the observed state of JobFlow
+     */
     @JsonProperty("pendingJobs")
     public void setPendingJobs(List<String> pendingJobs) {
         this.pendingJobs = pendingJobs;
     }
 
+    /**
+     * JobFlowStatus defines the observed state of JobFlow
+     */
     @JsonProperty("runningJobs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getRunningJobs() {
         return runningJobs;
     }
 
+    /**
+     * JobFlowStatus defines the observed state of JobFlow
+     */
     @JsonProperty("runningJobs")
     public void setRunningJobs(List<String> runningJobs) {
         this.runningJobs = runningJobs;
     }
 
+    /**
+     * JobFlowStatus defines the observed state of JobFlow
+     */
     @JsonProperty("state")
     public State getState() {
         return state;
     }
 
+    /**
+     * JobFlowStatus defines the observed state of JobFlow
+     */
     @JsonProperty("state")
     public void setState(State state) {
         this.state = state;
     }
 
+    /**
+     * JobFlowStatus defines the observed state of JobFlow
+     */
     @JsonProperty("terminatedJobs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getTerminatedJobs() {
         return terminatedJobs;
     }
 
+    /**
+     * JobFlowStatus defines the observed state of JobFlow
+     */
     @JsonProperty("terminatedJobs")
     public void setTerminatedJobs(List<String> terminatedJobs) {
         this.terminatedJobs = terminatedJobs;
     }
 
+    /**
+     * JobFlowStatus defines the observed state of JobFlow
+     */
     @JsonProperty("unKnowJobs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getUnKnowJobs() {
         return unKnowJobs;
     }
 
+    /**
+     * JobFlowStatus defines the observed state of JobFlow
+     */
     @JsonProperty("unKnowJobs")
     public void setUnKnowJobs(List<String> unKnowJobs) {
         this.unKnowJobs = unKnowJobs;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobTemplate.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobTemplate.java
index 8894bc54f2a..2dbe309b7a4 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobTemplate.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobTemplate.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JobTemplate is the Schema for the jobtemplates API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class JobTemplate implements Editable<JobTemplateBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "flow.volcano.sh/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "JobTemplate";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public JobTemplate(String apiVersion, String kind, ObjectMeta metadata, JobSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * JobTemplate is the Schema for the jobtemplates API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * JobTemplate is the Schema for the jobtemplates API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * JobTemplate is the Schema for the jobtemplates API
+     */
     @JsonProperty("spec")
     public JobSpec getSpec() {
         return spec;
     }
 
+    /**
+     * JobTemplate is the Schema for the jobtemplates API
+     */
     @JsonProperty("spec")
     public void setSpec(JobSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * JobTemplate is the Schema for the jobtemplates API
+     */
     @JsonProperty("status")
     public JobTemplateStatus getStatus() {
         return status;
     }
 
+    /**
+     * JobTemplate is the Schema for the jobtemplates API
+     */
     @JsonProperty("status")
     public void setStatus(JobTemplateStatus status) {
         this.status = status;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobTemplateList.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobTemplateList.java
index eda8ad018c9..9b51b6a521d 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobTemplateList.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobTemplateList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JobTemplateList contains a list of JobTemplate
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class JobTemplateList implements Editable<JobTemplateListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.volcano.api.model.flow.v1alpha1.JobTemplate>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "flow.volcano.sh/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.volcano.api.model.flow.v1alpha1.JobTemplate> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "JobTemplateList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public JobTemplateList(String apiVersion, List<io.fabric8.volcano.api.model.flow
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * JobTemplateList contains a list of JobTemplate
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.volcano.api.model.flow.v1alpha1.JobTemplate> getItems() {
         return items;
     }
 
+    /**
+     * JobTemplateList contains a list of JobTemplate
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.volcano.api.model.flow.v1alpha1.JobTemplate> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * JobTemplateList contains a list of JobTemplate
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * JobTemplateList contains a list of JobTemplate
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobTemplateSpec.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobTemplateSpec.java
index a728798bad8..9f3414eac84 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobTemplateSpec.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobTemplateSpec.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JobTemplateSpec defines the desired state of JobTemplate
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,11 +82,17 @@ public JobTemplateSpec(JobSpec jobSpec) {
         this.jobSpec = jobSpec;
     }
 
+    /**
+     * JobTemplateSpec defines the desired state of JobTemplate
+     */
     @JsonProperty("JobSpec")
     public JobSpec getJobSpec() {
         return jobSpec;
     }
 
+    /**
+     * JobTemplateSpec defines the desired state of JobTemplate
+     */
     @JsonProperty("JobSpec")
     public void setJobSpec(JobSpec jobSpec) {
         this.jobSpec = jobSpec;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobTemplateStatus.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobTemplateStatus.java
index af40f305057..f0b52b2858f 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobTemplateStatus.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/flow/v1alpha1/JobTemplateStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JobTemplateStatus defines the observed state of JobTemplate
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public JobTemplateStatus(List<String> jobDependsOnList) {
         this.jobDependsOnList = jobDependsOnList;
     }
 
+    /**
+     * Describes the Jobs generated from the JobTemplate
+     */
     @JsonProperty("jobDependsOnList")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getJobDependsOnList() {
         return jobDependsOnList;
     }
 
+    /**
+     * Describes the Jobs generated from the JobTemplate
+     */
     @JsonProperty("jobDependsOnList")
     public void setJobDependsOnList(List<String> jobDependsOnList) {
         this.jobDependsOnList = jobDependsOnList;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/nodeinfo/v1alpha1/CPUInfo.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/nodeinfo/v1alpha1/CPUInfo.java
index 73d4861a6ff..043fae4e593 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/nodeinfo/v1alpha1/CPUInfo.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/nodeinfo/v1alpha1/CPUInfo.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CPUInfo is the cpu topology detail
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public CPUInfo(Integer core, Integer numa, Integer socket) {
         this.socket = socket;
     }
 
+    /**
+     * CPUInfo is the cpu topology detail
+     */
     @JsonProperty("core")
     public Integer getCore() {
         return core;
     }
 
+    /**
+     * CPUInfo is the cpu topology detail
+     */
     @JsonProperty("core")
     public void setCore(Integer core) {
         this.core = core;
     }
 
+    /**
+     * CPUInfo is the cpu topology detail
+     */
     @JsonProperty("numa")
     public Integer getNuma() {
         return numa;
     }
 
+    /**
+     * CPUInfo is the cpu topology detail
+     */
     @JsonProperty("numa")
     public void setNuma(Integer numa) {
         this.numa = numa;
     }
 
+    /**
+     * CPUInfo is the cpu topology detail
+     */
     @JsonProperty("socket")
     public Integer getSocket() {
         return socket;
     }
 
+    /**
+     * CPUInfo is the cpu topology detail
+     */
     @JsonProperty("socket")
     public void setSocket(Integer socket) {
         this.socket = socket;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/nodeinfo/v1alpha1/NumatopoSpec.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/nodeinfo/v1alpha1/NumatopoSpec.java
index 9335ab86466..c38e4f15680 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/nodeinfo/v1alpha1/NumatopoSpec.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/nodeinfo/v1alpha1/NumatopoSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NumatopoSpec defines the desired state of Numatopology
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,45 +97,69 @@ public NumatopoSpec(Map<String, CPUInfo> cpuDetail, Map<String, ResourceInfo> nu
         this.resReserved = resReserved;
     }
 
+    /**
+     * Specifies the cpu topology info Key is cpu id
+     */
     @JsonProperty("cpuDetail")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, CPUInfo> getCpuDetail() {
         return cpuDetail;
     }
 
+    /**
+     * Specifies the cpu topology info Key is cpu id
+     */
     @JsonProperty("cpuDetail")
     public void setCpuDetail(Map<String, CPUInfo> cpuDetail) {
         this.cpuDetail = cpuDetail;
     }
 
+    /**
+     * Specifies the numa info for the resource Key is resource name
+     */
     @JsonProperty("numares")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, ResourceInfo> getNumares() {
         return numares;
     }
 
+    /**
+     * Specifies the numa info for the resource Key is resource name
+     */
     @JsonProperty("numares")
     public void setNumares(Map<String, ResourceInfo> numares) {
         this.numares = numares;
     }
 
+    /**
+     * Specifies the policy of the manager
+     */
     @JsonProperty("policies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getPolicies() {
         return policies;
     }
 
+    /**
+     * Specifies the policy of the manager
+     */
     @JsonProperty("policies")
     public void setPolicies(Map<String, String> policies) {
         this.policies = policies;
     }
 
+    /**
+     * Specifies the reserved resource of the node Key is resource name
+     */
     @JsonProperty("resReserved")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getResReserved() {
         return resReserved;
     }
 
+    /**
+     * Specifies the reserved resource of the node Key is resource name
+     */
     @JsonProperty("resReserved")
     public void setResReserved(Map<String, String> resReserved) {
         this.resReserved = resReserved;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/nodeinfo/v1alpha1/Numatopology.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/nodeinfo/v1alpha1/Numatopology.java
index 80ffbc253dd..9e779a47512 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/nodeinfo/v1alpha1/Numatopology.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/nodeinfo/v1alpha1/Numatopology.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Numatopology is the Schema for the Numatopologies API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class Numatopology implements Editable<NumatopologyBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "nodeinfo.volcano.sh/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Numatopology";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public Numatopology(String apiVersion, String kind, ObjectMeta metadata, Numatop
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Numatopology is the Schema for the Numatopologies API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Numatopology is the Schema for the Numatopologies API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Numatopology is the Schema for the Numatopologies API
+     */
     @JsonProperty("spec")
     public NumatopoSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Numatopology is the Schema for the Numatopologies API
+     */
     @JsonProperty("spec")
     public void setSpec(NumatopoSpec spec) {
         this.spec = spec;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/nodeinfo/v1alpha1/NumatopologyList.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/nodeinfo/v1alpha1/NumatopologyList.java
index 1aa13cb229b..b269ca37dbe 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/nodeinfo/v1alpha1/NumatopologyList.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/nodeinfo/v1alpha1/NumatopologyList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NumatopologyList contains a list of Numatopology
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class NumatopologyList implements Editable<NumatopologyListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.volcano.api.model.nodeinfo.v1alpha1.Numatopology>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "nodeinfo.volcano.sh/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.volcano.api.model.nodeinfo.v1alpha1.Numatopology> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "NumatopologyList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public NumatopologyList(String apiVersion, List<io.fabric8.volcano.api.model.nod
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * NumatopologyList contains a list of Numatopology
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.volcano.api.model.nodeinfo.v1alpha1.Numatopology> getItems() {
         return items;
     }
 
+    /**
+     * NumatopologyList contains a list of Numatopology
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.volcano.api.model.nodeinfo.v1alpha1.Numatopology> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * NumatopologyList contains a list of Numatopology
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * NumatopologyList contains a list of Numatopology
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/nodeinfo/v1alpha1/ResourceInfo.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/nodeinfo/v1alpha1/ResourceInfo.java
index 0084bdeb070..fd2aa258def 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/nodeinfo/v1alpha1/ResourceInfo.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/nodeinfo/v1alpha1/ResourceInfo.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceInfo is the sets about resource capacity and allocatable
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ResourceInfo(String allocatable, Integer capacity) {
         this.capacity = capacity;
     }
 
+    /**
+     * ResourceInfo is the sets about resource capacity and allocatable
+     */
     @JsonProperty("allocatable")
     public String getAllocatable() {
         return allocatable;
     }
 
+    /**
+     * ResourceInfo is the sets about resource capacity and allocatable
+     */
     @JsonProperty("allocatable")
     public void setAllocatable(String allocatable) {
         this.allocatable = allocatable;
     }
 
+    /**
+     * ResourceInfo is the sets about resource capacity and allocatable
+     */
     @JsonProperty("capacity")
     public Integer getCapacity() {
         return capacity;
     }
 
+    /**
+     * ResourceInfo is the sets about resource capacity and allocatable
+     */
     @JsonProperty("capacity")
     public void setCapacity(Integer capacity) {
         this.capacity = capacity;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/Affinity.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/Affinity.java
index 9af363df3bd..394824ff88d 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/Affinity.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/Affinity.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Affinity is a group of affinity scheduling rules.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Affinity(NodeGroupAffinity nodeGroupAffinity, NodeGroupAntiAffinity nodeG
         this.nodeGroupAntiAffinity = nodeGroupAntiAffinity;
     }
 
+    /**
+     * Affinity is a group of affinity scheduling rules.
+     */
     @JsonProperty("nodeGroupAffinity")
     public NodeGroupAffinity getNodeGroupAffinity() {
         return nodeGroupAffinity;
     }
 
+    /**
+     * Affinity is a group of affinity scheduling rules.
+     */
     @JsonProperty("nodeGroupAffinity")
     public void setNodeGroupAffinity(NodeGroupAffinity nodeGroupAffinity) {
         this.nodeGroupAffinity = nodeGroupAffinity;
     }
 
+    /**
+     * Affinity is a group of affinity scheduling rules.
+     */
     @JsonProperty("nodeGroupAntiAffinity")
     public NodeGroupAntiAffinity getNodeGroupAntiAffinity() {
         return nodeGroupAntiAffinity;
     }
 
+    /**
+     * Affinity is a group of affinity scheduling rules.
+     */
     @JsonProperty("nodeGroupAntiAffinity")
     public void setNodeGroupAntiAffinity(NodeGroupAntiAffinity nodeGroupAntiAffinity) {
         this.nodeGroupAntiAffinity = nodeGroupAntiAffinity;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/Cluster.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/Cluster.java
index 0a74e43a178..9a1a0c38f03 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/Cluster.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/Cluster.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CluterSpec represents the template of Cluster
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -88,32 +91,50 @@ public Cluster(Map<String, Quantity> capacity, String name, Integer weight) {
         this.weight = weight;
     }
 
+    /**
+     * CluterSpec represents the template of Cluster
+     */
     @JsonProperty("capacity")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getCapacity() {
         return capacity;
     }
 
+    /**
+     * CluterSpec represents the template of Cluster
+     */
     @JsonProperty("capacity")
     public void setCapacity(Map<String, Quantity> capacity) {
         this.capacity = capacity;
     }
 
+    /**
+     * CluterSpec represents the template of Cluster
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * CluterSpec represents the template of Cluster
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * CluterSpec represents the template of Cluster
+     */
     @JsonProperty("weight")
     public Integer getWeight() {
         return weight;
     }
 
+    /**
+     * CluterSpec represents the template of Cluster
+     */
     @JsonProperty("weight")
     public void setWeight(Integer weight) {
         this.weight = weight;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/Guarantee.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/Guarantee.java
index 8fd47ae0a3f..0224dee2fbf 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/Guarantee.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/Guarantee.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Guarantee represents configuration of queue resource reservation
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -80,12 +83,18 @@ public Guarantee(Map<String, Quantity> resource) {
         this.resource = resource;
     }
 
+    /**
+     * The amount of cluster resource reserved for queue. Just set either `percentage` or `resource`
+     */
     @JsonProperty("resource")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getResource() {
         return resource;
     }
 
+    /**
+     * The amount of cluster resource reserved for queue. Just set either `percentage` or `resource`
+     */
     @JsonProperty("resource")
     public void setResource(Map<String, Quantity> resource) {
         this.resource = resource;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/PodGroup.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/PodGroup.java
index 768e220ab9f..d4449b7dd05 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/PodGroup.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/PodGroup.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodGroup is a collection of Pod; used for batch workload.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class PodGroup implements Editable<PodGroupBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "scheduling.volcano.sh/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodGroup";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PodGroup(String apiVersion, String kind, ObjectMeta metadata, PodGroupSpe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodGroup is a collection of Pod; used for batch workload.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodGroup is a collection of Pod; used for batch workload.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PodGroup is a collection of Pod; used for batch workload.
+     */
     @JsonProperty("spec")
     public PodGroupSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PodGroup is a collection of Pod; used for batch workload.
+     */
     @JsonProperty("spec")
     public void setSpec(PodGroupSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PodGroup is a collection of Pod; used for batch workload.
+     */
     @JsonProperty("status")
     public PodGroupStatus getStatus() {
         return status;
     }
 
+    /**
+     * PodGroup is a collection of Pod; used for batch workload.
+     */
     @JsonProperty("status")
     public void setStatus(PodGroupStatus status) {
         this.status = status;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/PodGroupCondition.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/PodGroupCondition.java
index dc8a4acfe3d..a2ba43b89c2 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/PodGroupCondition.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/PodGroupCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodGroupCondition contains details for the current state of this pod group.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public PodGroupCondition(String lastTransitionTime, String message, String reaso
         this.type = type;
     }
 
+    /**
+     * PodGroupCondition contains details for the current state of this pod group.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * PodGroupCondition contains details for the current state of this pod group.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Unique, one-word, CamelCase reason for the phase's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Unique, one-word, CamelCase reason for the phase's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status is the status of the condition.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status is the status of the condition.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * The ID of condition transition.
+     */
     @JsonProperty("transitionID")
     public String getTransitionID() {
         return transitionID;
     }
 
+    /**
+     * The ID of condition transition.
+     */
     @JsonProperty("transitionID")
     public void setTransitionID(String transitionID) {
         this.transitionID = transitionID;
     }
 
+    /**
+     * Type is the type of the condition
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of the condition
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/PodGroupList.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/PodGroupList.java
index 9866160e8eb..392e24e12be 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/PodGroupList.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/PodGroupList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodGroupList is a collection of pod groups.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PodGroupList implements Editable<PodGroupListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.volcano.api.model.scheduling.v1beta1.PodGroup>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "scheduling.volcano.sh/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.volcano.api.model.scheduling.v1beta1.PodGroup> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodGroupList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PodGroupList(String apiVersion, List<io.fabric8.volcano.api.model.schedul
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of PodGroup
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.volcano.api.model.scheduling.v1beta1.PodGroup> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of PodGroup
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.volcano.api.model.scheduling.v1beta1.PodGroup> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodGroupList is a collection of pod groups.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodGroupList is a collection of pod groups.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/PodGroupSpec.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/PodGroupSpec.java
index 79eed79eab2..2bbdc6d41c2 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/PodGroupSpec.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/PodGroupSpec.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodGroupSpec represents the template of a pod group.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -97,53 +100,83 @@ public PodGroupSpec(Integer minMember, Map<String, Quantity> minResources, Map<S
         this.queue = queue;
     }
 
+    /**
+     * MinMember defines the minimal number of members/tasks to run the pod group; if there's not enough resources to start all tasks, the scheduler will not start anyone.
+     */
     @JsonProperty("minMember")
     public Integer getMinMember() {
         return minMember;
     }
 
+    /**
+     * MinMember defines the minimal number of members/tasks to run the pod group; if there's not enough resources to start all tasks, the scheduler will not start anyone.
+     */
     @JsonProperty("minMember")
     public void setMinMember(Integer minMember) {
         this.minMember = minMember;
     }
 
+    /**
+     * MinResources defines the minimal resource of members/tasks to run the pod group; if there's not enough resources to start all tasks, the scheduler will not start anyone.
+     */
     @JsonProperty("minResources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getMinResources() {
         return minResources;
     }
 
+    /**
+     * MinResources defines the minimal resource of members/tasks to run the pod group; if there's not enough resources to start all tasks, the scheduler will not start anyone.
+     */
     @JsonProperty("minResources")
     public void setMinResources(Map<String, Quantity> minResources) {
         this.minResources = minResources;
     }
 
+    /**
+     * MinTaskMember defines the minimal number of pods to run each task in the pod group; if there's not enough resources to start each task, the scheduler will not start anyone.
+     */
     @JsonProperty("minTaskMember")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Integer> getMinTaskMember() {
         return minTaskMember;
     }
 
+    /**
+     * MinTaskMember defines the minimal number of pods to run each task in the pod group; if there's not enough resources to start each task, the scheduler will not start anyone.
+     */
     @JsonProperty("minTaskMember")
     public void setMinTaskMember(Map<String, Integer> minTaskMember) {
         this.minTaskMember = minTaskMember;
     }
 
+    /**
+     * If specified, indicates the PodGroup's priority. "system-node-critical" and "system-cluster-critical" are two special keywords which indicate the highest priorities with the former being the highest priority. Any other name must be defined by creating a PriorityClass object with that name. If not specified, the PodGroup priority will be default or zero if there is no default.
+     */
     @JsonProperty("priorityClassName")
     public String getPriorityClassName() {
         return priorityClassName;
     }
 
+    /**
+     * If specified, indicates the PodGroup's priority. "system-node-critical" and "system-cluster-critical" are two special keywords which indicate the highest priorities with the former being the highest priority. Any other name must be defined by creating a PriorityClass object with that name. If not specified, the PodGroup priority will be default or zero if there is no default.
+     */
     @JsonProperty("priorityClassName")
     public void setPriorityClassName(String priorityClassName) {
         this.priorityClassName = priorityClassName;
     }
 
+    /**
+     * Queue defines the queue to allocate resource for PodGroup; if queue does not exist, the PodGroup will not be scheduled. Defaults to `default` Queue with the lowest weight.
+     */
     @JsonProperty("queue")
     public String getQueue() {
         return queue;
     }
 
+    /**
+     * Queue defines the queue to allocate resource for PodGroup; if queue does not exist, the PodGroup will not be scheduled. Defaults to `default` Queue with the lowest weight.
+     */
     @JsonProperty("queue")
     public void setQueue(String queue) {
         this.queue = queue;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/PodGroupStatus.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/PodGroupStatus.java
index 21c7a50e350..fb437543f5b 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/PodGroupStatus.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/PodGroupStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodGroupStatus represents the current state of a pod group.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -97,52 +100,82 @@ public PodGroupStatus(List<PodGroupCondition> conditions, Integer failed, String
         this.succeeded = succeeded;
     }
 
+    /**
+     * The conditions of PodGroup.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PodGroupCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * The conditions of PodGroup.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<PodGroupCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * The number of pods which reached phase Failed.
+     */
     @JsonProperty("failed")
     public Integer getFailed() {
         return failed;
     }
 
+    /**
+     * The number of pods which reached phase Failed.
+     */
     @JsonProperty("failed")
     public void setFailed(Integer failed) {
         this.failed = failed;
     }
 
+    /**
+     * Current phase of PodGroup.
+     */
     @JsonProperty("phase")
     public String getPhase() {
         return phase;
     }
 
+    /**
+     * Current phase of PodGroup.
+     */
     @JsonProperty("phase")
     public void setPhase(String phase) {
         this.phase = phase;
     }
 
+    /**
+     * The number of actively running pods.
+     */
     @JsonProperty("running")
     public Integer getRunning() {
         return running;
     }
 
+    /**
+     * The number of actively running pods.
+     */
     @JsonProperty("running")
     public void setRunning(Integer running) {
         this.running = running;
     }
 
+    /**
+     * The number of pods which reached phase Succeeded.
+     */
     @JsonProperty("succeeded")
     public Integer getSucceeded() {
         return succeeded;
     }
 
+    /**
+     * The number of pods which reached phase Succeeded.
+     */
     @JsonProperty("succeeded")
     public void setSucceeded(Integer succeeded) {
         this.succeeded = succeeded;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/Queue.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/Queue.java
index c490e788866..d1b00b9e5d4 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/Queue.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/Queue.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Queue is a queue of PodGroup.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Queue implements Editable<QueueBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "scheduling.volcano.sh/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Queue";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public Queue(String apiVersion, String kind, ObjectMeta metadata, QueueSpec spec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Queue is a queue of PodGroup.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Queue is a queue of PodGroup.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Queue is a queue of PodGroup.
+     */
     @JsonProperty("spec")
     public QueueSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Queue is a queue of PodGroup.
+     */
     @JsonProperty("spec")
     public void setSpec(QueueSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Queue is a queue of PodGroup.
+     */
     @JsonProperty("status")
     public QueueStatus getStatus() {
         return status;
     }
 
+    /**
+     * Queue is a queue of PodGroup.
+     */
     @JsonProperty("status")
     public void setStatus(QueueStatus status) {
         this.status = status;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/QueueList.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/QueueList.java
index b11e69a902a..c89b158eabe 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/QueueList.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/QueueList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * QueueList is a collection of queues.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class QueueList implements Editable<QueueListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.volcano.api.model.scheduling.v1beta1.Queue>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "scheduling.volcano.sh/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.volcano.api.model.scheduling.v1beta1.Queue> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "QueueList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public QueueList(String apiVersion, List<io.fabric8.volcano.api.model.scheduling
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of PodGroup
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.volcano.api.model.scheduling.v1beta1.Queue> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of PodGroup
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.volcano.api.model.scheduling.v1beta1.Queue> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * QueueList is a collection of queues.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * QueueList is a collection of queues.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/QueueSpec.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/QueueSpec.java
index 90bd08a8c70..f720e86938c 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/QueueSpec.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/QueueSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * QueueSpec represents the template of Queue.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -120,104 +123,164 @@ public QueueSpec(Affinity affinity, Map<String, Quantity> capability, Map<String
         this.weight = weight;
     }
 
+    /**
+     * QueueSpec represents the template of Queue.
+     */
     @JsonProperty("affinity")
     public Affinity getAffinity() {
         return affinity;
     }
 
+    /**
+     * QueueSpec represents the template of Queue.
+     */
     @JsonProperty("affinity")
     public void setAffinity(Affinity affinity) {
         this.affinity = affinity;
     }
 
+    /**
+     * QueueSpec represents the template of Queue.
+     */
     @JsonProperty("capability")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getCapability() {
         return capability;
     }
 
+    /**
+     * QueueSpec represents the template of Queue.
+     */
     @JsonProperty("capability")
     public void setCapability(Map<String, Quantity> capability) {
         this.capability = capability;
     }
 
+    /**
+     * The amount of resources configured by the user. This part of resource can be shared with other queues and reclaimed back.
+     */
     @JsonProperty("deserved")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getDeserved() {
         return deserved;
     }
 
+    /**
+     * The amount of resources configured by the user. This part of resource can be shared with other queues and reclaimed back.
+     */
     @JsonProperty("deserved")
     public void setDeserved(Map<String, Quantity> deserved) {
         this.deserved = deserved;
     }
 
+    /**
+     * extendCluster indicate the jobs in this Queue will be dispatched to these clusters.
+     */
     @JsonProperty("extendClusters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Cluster> getExtendClusters() {
         return extendClusters;
     }
 
+    /**
+     * extendCluster indicate the jobs in this Queue will be dispatched to these clusters.
+     */
     @JsonProperty("extendClusters")
     public void setExtendClusters(List<Cluster> extendClusters) {
         this.extendClusters = extendClusters;
     }
 
+    /**
+     * QueueSpec represents the template of Queue.
+     */
     @JsonProperty("guarantee")
     public Guarantee getGuarantee() {
         return guarantee;
     }
 
+    /**
+     * QueueSpec represents the template of Queue.
+     */
     @JsonProperty("guarantee")
     public void setGuarantee(Guarantee guarantee) {
         this.guarantee = guarantee;
     }
 
+    /**
+     * Parent define the parent of queue
+     */
     @JsonProperty("parent")
     public String getParent() {
         return parent;
     }
 
+    /**
+     * Parent define the parent of queue
+     */
     @JsonProperty("parent")
     public void setParent(String parent) {
         this.parent = parent;
     }
 
+    /**
+     * Priority define the priority of queue. Higher values are prioritized for scheduling and considered later during reclamation.
+     */
     @JsonProperty("priority")
     public Integer getPriority() {
         return priority;
     }
 
+    /**
+     * Priority define the priority of queue. Higher values are prioritized for scheduling and considered later during reclamation.
+     */
     @JsonProperty("priority")
     public void setPriority(Integer priority) {
         this.priority = priority;
     }
 
+    /**
+     * Reclaimable indicate whether the queue can be reclaimed by other queue
+     */
     @JsonProperty("reclaimable")
     public Boolean getReclaimable() {
         return reclaimable;
     }
 
+    /**
+     * Reclaimable indicate whether the queue can be reclaimed by other queue
+     */
     @JsonProperty("reclaimable")
     public void setReclaimable(Boolean reclaimable) {
         this.reclaimable = reclaimable;
     }
 
+    /**
+     * Type define the type of queue
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type define the type of queue
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * QueueSpec represents the template of Queue.
+     */
     @JsonProperty("weight")
     public Integer getWeight() {
         return weight;
     }
 
+    /**
+     * QueueSpec represents the template of Queue.
+     */
     @JsonProperty("weight")
     public void setWeight(Integer weight) {
         this.weight = weight;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/QueueStatus.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/QueueStatus.java
index f03d1948c5d..5caf722d9b9 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/QueueStatus.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/QueueStatus.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * QueueStatus represents the status of Queue.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -108,82 +111,130 @@ public QueueStatus(Map<String, Quantity> allocated, Integer completed, Integer i
         this.unknown = unknown;
     }
 
+    /**
+     * Allocated is allocated resources in queue
+     */
     @JsonProperty("allocated")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getAllocated() {
         return allocated;
     }
 
+    /**
+     * Allocated is allocated resources in queue
+     */
     @JsonProperty("allocated")
     public void setAllocated(Map<String, Quantity> allocated) {
         this.allocated = allocated;
     }
 
+    /**
+     * The number of `Completed` PodGroup in this queue.
+     */
     @JsonProperty("completed")
     public Integer getCompleted() {
         return completed;
     }
 
+    /**
+     * The number of `Completed` PodGroup in this queue.
+     */
     @JsonProperty("completed")
     public void setCompleted(Integer completed) {
         this.completed = completed;
     }
 
+    /**
+     * The number of `Inqueue` PodGroup in this queue.
+     */
     @JsonProperty("inqueue")
     public Integer getInqueue() {
         return inqueue;
     }
 
+    /**
+     * The number of `Inqueue` PodGroup in this queue.
+     */
     @JsonProperty("inqueue")
     public void setInqueue(Integer inqueue) {
         this.inqueue = inqueue;
     }
 
+    /**
+     * The number of 'Pending' PodGroup in this queue.
+     */
     @JsonProperty("pending")
     public Integer getPending() {
         return pending;
     }
 
+    /**
+     * The number of 'Pending' PodGroup in this queue.
+     */
     @JsonProperty("pending")
     public void setPending(Integer pending) {
         this.pending = pending;
     }
 
+    /**
+     * QueueStatus represents the status of Queue.
+     */
     @JsonProperty("reservation")
     public Reservation getReservation() {
         return reservation;
     }
 
+    /**
+     * QueueStatus represents the status of Queue.
+     */
     @JsonProperty("reservation")
     public void setReservation(Reservation reservation) {
         this.reservation = reservation;
     }
 
+    /**
+     * The number of 'Running' PodGroup in this queue.
+     */
     @JsonProperty("running")
     public Integer getRunning() {
         return running;
     }
 
+    /**
+     * The number of 'Running' PodGroup in this queue.
+     */
     @JsonProperty("running")
     public void setRunning(Integer running) {
         this.running = running;
     }
 
+    /**
+     * State is state of queue
+     */
     @JsonProperty("state")
     public String getState() {
         return state;
     }
 
+    /**
+     * State is state of queue
+     */
     @JsonProperty("state")
     public void setState(String state) {
         this.state = state;
     }
 
+    /**
+     * The number of 'Unknown' PodGroup in this queue.
+     */
     @JsonProperty("unknown")
     public Integer getUnknown() {
         return unknown;
     }
 
+    /**
+     * The number of 'Unknown' PodGroup in this queue.
+     */
     @JsonProperty("unknown")
     public void setUnknown(Integer unknown) {
         this.unknown = unknown;
diff --git a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/Reservation.java b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/Reservation.java
index 7f24de57887..b5e3d2f473e 100644
--- a/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/Reservation.java
+++ b/extensions/volcano/model/src/generated/java/io/fabric8/volcano/api/model/scheduling/v1beta1/Reservation.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Reservation represents current condition about resource reservation
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,23 +90,35 @@ public Reservation(List<String> nodes, Map<String, Quantity> resource) {
         this.resource = resource;
     }
 
+    /**
+     * Nodes are Locked nodes for queue
+     */
     @JsonProperty("nodes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNodes() {
         return nodes;
     }
 
+    /**
+     * Nodes are Locked nodes for queue
+     */
     @JsonProperty("nodes")
     public void setNodes(List<String> nodes) {
         this.nodes = nodes;
     }
 
+    /**
+     * Resource is a list of total idle resource in locked nodes.
+     */
     @JsonProperty("resource")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getResource() {
         return resource;
     }
 
+    /**
+     * Resource is a list of total idle resource in locked nodes.
+     */
     @JsonProperty("resource")
     public void setResource(Map<String, Quantity> resource) {
         this.resource = resource;
diff --git a/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshot.java b/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshot.java
index ee26e446f42..97c630f4c1e 100644
--- a/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshot.java
+++ b/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshot.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeSnapshot is a user's request for either creating a point-in-time snapshot of a persistent volume, or binding to a pre-existing snapshot.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class VolumeSnapshot implements Editable<VolumeSnapshotBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "snapshot.storage.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VolumeSnapshot";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public VolumeSnapshot(String apiVersion, String kind, ObjectMeta metadata, Volum
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VolumeSnapshot is a user's request for either creating a point-in-time snapshot of a persistent volume, or binding to a pre-existing snapshot.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VolumeSnapshot is a user's request for either creating a point-in-time snapshot of a persistent volume, or binding to a pre-existing snapshot.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * VolumeSnapshot is a user's request for either creating a point-in-time snapshot of a persistent volume, or binding to a pre-existing snapshot.
+     */
     @JsonProperty("spec")
     public VolumeSnapshotSpec getSpec() {
         return spec;
     }
 
+    /**
+     * VolumeSnapshot is a user's request for either creating a point-in-time snapshot of a persistent volume, or binding to a pre-existing snapshot.
+     */
     @JsonProperty("spec")
     public void setSpec(VolumeSnapshotSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * VolumeSnapshot is a user's request for either creating a point-in-time snapshot of a persistent volume, or binding to a pre-existing snapshot.
+     */
     @JsonProperty("status")
     public VolumeSnapshotStatus getStatus() {
         return status;
     }
 
+    /**
+     * VolumeSnapshot is a user's request for either creating a point-in-time snapshot of a persistent volume, or binding to a pre-existing snapshot.
+     */
     @JsonProperty("status")
     public void setStatus(VolumeSnapshotStatus status) {
         this.status = status;
diff --git a/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotClass.java b/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotClass.java
index ea39a416499..309bd56c371 100644
--- a/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotClass.java
+++ b/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotClass.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeSnapshotClass specifies parameters that a underlying storage system uses when creating a volume snapshot. A specific VolumeSnapshotClass is used by specifying its name in a VolumeSnapshot object. VolumeSnapshotClasses are non-namespaced
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,18 +79,12 @@
 public class VolumeSnapshotClass implements Editable<VolumeSnapshotClassBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "snapshot.storage.k8s.io/v1";
     @JsonProperty("deletionPolicy")
     private String deletionPolicy;
     @JsonProperty("driver")
     private String driver;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VolumeSnapshotClass";
     @JsonProperty("metadata")
@@ -115,7 +112,7 @@ public VolumeSnapshotClass(String apiVersion, String deletionPolicy, String driv
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -123,35 +120,47 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * deletionPolicy determines whether a VolumeSnapshotContent created through the VolumeSnapshotClass should be deleted when its bound VolumeSnapshot is deleted. Supported values are "Retain" and "Delete". "Retain" means that the VolumeSnapshotContent and its physical snapshot on underlying storage system are kept. "Delete" means that the VolumeSnapshotContent and its physical snapshot on underlying storage system are deleted. Required.
+     */
     @JsonProperty("deletionPolicy")
     public String getDeletionPolicy() {
         return deletionPolicy;
     }
 
+    /**
+     * deletionPolicy determines whether a VolumeSnapshotContent created through the VolumeSnapshotClass should be deleted when its bound VolumeSnapshot is deleted. Supported values are "Retain" and "Delete". "Retain" means that the VolumeSnapshotContent and its physical snapshot on underlying storage system are kept. "Delete" means that the VolumeSnapshotContent and its physical snapshot on underlying storage system are deleted. Required.
+     */
     @JsonProperty("deletionPolicy")
     public void setDeletionPolicy(String deletionPolicy) {
         this.deletionPolicy = deletionPolicy;
     }
 
+    /**
+     * driver is the name of the storage driver that handles this VolumeSnapshotClass. Required.
+     */
     @JsonProperty("driver")
     public String getDriver() {
         return driver;
     }
 
+    /**
+     * driver is the name of the storage driver that handles this VolumeSnapshotClass. Required.
+     */
     @JsonProperty("driver")
     public void setDriver(String driver) {
         this.driver = driver;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -159,29 +168,41 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VolumeSnapshotClass specifies parameters that a underlying storage system uses when creating a volume snapshot. A specific VolumeSnapshotClass is used by specifying its name in a VolumeSnapshot object. VolumeSnapshotClasses are non-namespaced
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VolumeSnapshotClass specifies parameters that a underlying storage system uses when creating a volume snapshot. A specific VolumeSnapshotClass is used by specifying its name in a VolumeSnapshot object. VolumeSnapshotClasses are non-namespaced
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * parameters is a key-value map with storage driver specific parameters for creating snapshots. These values are opaque to Kubernetes.
+     */
     @JsonProperty("parameters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getParameters() {
         return parameters;
     }
 
+    /**
+     * parameters is a key-value map with storage driver specific parameters for creating snapshots. These values are opaque to Kubernetes.
+     */
     @JsonProperty("parameters")
     public void setParameters(Map<String, String> parameters) {
         this.parameters = parameters;
diff --git a/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotClassList.java b/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotClassList.java
index ba6e8e3324d..0d36e7cf30b 100644
--- a/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotClassList.java
+++ b/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotClassList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeSnapshotClassList is a collection of VolumeSnapshotClasses.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class VolumeSnapshotClassList implements Editable<VolumeSnapshotClassListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.volumesnapshot.api.model.VolumeSnapshotClass>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "snapshot.storage.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.volumesnapshot.api.model.VolumeSnapshotClass> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VolumeSnapshotClassList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public VolumeSnapshotClassList(String apiVersion, List<io.fabric8.volumesnapshot
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of VolumeSnapshotClasses
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.volumesnapshot.api.model.VolumeSnapshotClass> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of VolumeSnapshotClasses
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.volumesnapshot.api.model.VolumeSnapshotClass> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VolumeSnapshotClassList is a collection of VolumeSnapshotClasses.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VolumeSnapshotClassList is a collection of VolumeSnapshotClasses.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotContent.java b/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotContent.java
index e20258ba9ef..2c1640b4a79 100644
--- a/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotContent.java
+++ b/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotContent.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeSnapshotContent represents the actual "on-disk" snapshot object in the underlying storage system
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class VolumeSnapshotContent implements Editable<VolumeSnapshotContentBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "snapshot.storage.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VolumeSnapshotContent";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public VolumeSnapshotContent(String apiVersion, String kind, ObjectMeta metadata
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VolumeSnapshotContent represents the actual "on-disk" snapshot object in the underlying storage system
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VolumeSnapshotContent represents the actual "on-disk" snapshot object in the underlying storage system
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * VolumeSnapshotContent represents the actual "on-disk" snapshot object in the underlying storage system
+     */
     @JsonProperty("spec")
     public VolumeSnapshotContentSpec getSpec() {
         return spec;
     }
 
+    /**
+     * VolumeSnapshotContent represents the actual "on-disk" snapshot object in the underlying storage system
+     */
     @JsonProperty("spec")
     public void setSpec(VolumeSnapshotContentSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * VolumeSnapshotContent represents the actual "on-disk" snapshot object in the underlying storage system
+     */
     @JsonProperty("status")
     public VolumeSnapshotContentStatus getStatus() {
         return status;
     }
 
+    /**
+     * VolumeSnapshotContent represents the actual "on-disk" snapshot object in the underlying storage system
+     */
     @JsonProperty("status")
     public void setStatus(VolumeSnapshotContentStatus status) {
         this.status = status;
diff --git a/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotContentList.java b/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotContentList.java
index 2634d83796e..e3c16e923fd 100644
--- a/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotContentList.java
+++ b/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotContentList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeSnapshotContentList is a list of VolumeSnapshotContent objects
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class VolumeSnapshotContentList implements Editable<VolumeSnapshotContentListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.volumesnapshot.api.model.VolumeSnapshotContent>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "snapshot.storage.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.volumesnapshot.api.model.VolumeSnapshotContent> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VolumeSnapshotContentList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public VolumeSnapshotContentList(String apiVersion, List<io.fabric8.volumesnapsh
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of VolumeSnapshotContents
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.volumesnapshot.api.model.VolumeSnapshotContent> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of VolumeSnapshotContents
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.volumesnapshot.api.model.VolumeSnapshotContent> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VolumeSnapshotContentList is a list of VolumeSnapshotContent objects
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VolumeSnapshotContentList is a list of VolumeSnapshotContent objects
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotContentSource.java b/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotContentSource.java
index 6fb93507d4e..4b301202a91 100644
--- a/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotContentSource.java
+++ b/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotContentSource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeSnapshotContentSource represents the CSI source of a snapshot. Exactly one of its members must be set. Members in VolumeSnapshotContentSource are immutable.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public VolumeSnapshotContentSource(String snapshotHandle, String volumeHandle) {
         this.volumeHandle = volumeHandle;
     }
 
+    /**
+     * snapshotHandle specifies the CSI "snapshot_id" of a pre-existing snapshot on the underlying storage system for which a Kubernetes object representation was (or should be) created. This field is immutable.
+     */
     @JsonProperty("snapshotHandle")
     public String getSnapshotHandle() {
         return snapshotHandle;
     }
 
+    /**
+     * snapshotHandle specifies the CSI "snapshot_id" of a pre-existing snapshot on the underlying storage system for which a Kubernetes object representation was (or should be) created. This field is immutable.
+     */
     @JsonProperty("snapshotHandle")
     public void setSnapshotHandle(String snapshotHandle) {
         this.snapshotHandle = snapshotHandle;
     }
 
+    /**
+     * volumeHandle specifies the CSI "volume_id" of the volume from which a snapshot should be dynamically taken from. This field is immutable.
+     */
     @JsonProperty("volumeHandle")
     public String getVolumeHandle() {
         return volumeHandle;
     }
 
+    /**
+     * volumeHandle specifies the CSI "volume_id" of the volume from which a snapshot should be dynamically taken from. This field is immutable.
+     */
     @JsonProperty("volumeHandle")
     public void setVolumeHandle(String volumeHandle) {
         this.volumeHandle = volumeHandle;
diff --git a/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotContentSpec.java b/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotContentSpec.java
index e7b3e71cf0d..225a4c2b4e3 100644
--- a/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotContentSpec.java
+++ b/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotContentSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeSnapshotContentSpec is the specification of a VolumeSnapshotContent
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public VolumeSnapshotContentSpec(String deletionPolicy, String driver, VolumeSna
         this.volumeSnapshotRef = volumeSnapshotRef;
     }
 
+    /**
+     * deletionPolicy determines whether this VolumeSnapshotContent and its physical snapshot on the underlying storage system should be deleted when its bound VolumeSnapshot is deleted. Supported values are "Retain" and "Delete". "Retain" means that the VolumeSnapshotContent and its physical snapshot on underlying storage system are kept. "Delete" means that the VolumeSnapshotContent and its physical snapshot on underlying storage system are deleted. For dynamically provisioned snapshots, this field will automatically be filled in by the CSI snapshotter sidecar with the "DeletionPolicy" field defined in the corresponding VolumeSnapshotClass. For pre-existing snapshots, users MUST specify this field when creating the<br><p>  VolumeSnapshotContent object.<br><p> Required.
+     */
     @JsonProperty("deletionPolicy")
     public String getDeletionPolicy() {
         return deletionPolicy;
     }
 
+    /**
+     * deletionPolicy determines whether this VolumeSnapshotContent and its physical snapshot on the underlying storage system should be deleted when its bound VolumeSnapshot is deleted. Supported values are "Retain" and "Delete". "Retain" means that the VolumeSnapshotContent and its physical snapshot on underlying storage system are kept. "Delete" means that the VolumeSnapshotContent and its physical snapshot on underlying storage system are deleted. For dynamically provisioned snapshots, this field will automatically be filled in by the CSI snapshotter sidecar with the "DeletionPolicy" field defined in the corresponding VolumeSnapshotClass. For pre-existing snapshots, users MUST specify this field when creating the<br><p>  VolumeSnapshotContent object.<br><p> Required.
+     */
     @JsonProperty("deletionPolicy")
     public void setDeletionPolicy(String deletionPolicy) {
         this.deletionPolicy = deletionPolicy;
     }
 
+    /**
+     * driver is the name of the CSI driver used to create the physical snapshot on the underlying storage system. This MUST be the same as the name returned by the CSI GetPluginName() call for that driver. Required.
+     */
     @JsonProperty("driver")
     public String getDriver() {
         return driver;
     }
 
+    /**
+     * driver is the name of the CSI driver used to create the physical snapshot on the underlying storage system. This MUST be the same as the name returned by the CSI GetPluginName() call for that driver. Required.
+     */
     @JsonProperty("driver")
     public void setDriver(String driver) {
         this.driver = driver;
     }
 
+    /**
+     * VolumeSnapshotContentSpec is the specification of a VolumeSnapshotContent
+     */
     @JsonProperty("source")
     public VolumeSnapshotContentSource getSource() {
         return source;
     }
 
+    /**
+     * VolumeSnapshotContentSpec is the specification of a VolumeSnapshotContent
+     */
     @JsonProperty("source")
     public void setSource(VolumeSnapshotContentSource source) {
         this.source = source;
     }
 
+    /**
+     * SourceVolumeMode is the mode of the volume whose snapshot is taken. Can be either "Filesystem" or "Block". If not specified, it indicates the source volume's mode is unknown. This field is immutable. This field is an alpha field.
+     */
     @JsonProperty("sourceVolumeMode")
     public String getSourceVolumeMode() {
         return sourceVolumeMode;
     }
 
+    /**
+     * SourceVolumeMode is the mode of the volume whose snapshot is taken. Can be either "Filesystem" or "Block". If not specified, it indicates the source volume's mode is unknown. This field is immutable. This field is an alpha field.
+     */
     @JsonProperty("sourceVolumeMode")
     public void setSourceVolumeMode(String sourceVolumeMode) {
         this.sourceVolumeMode = sourceVolumeMode;
     }
 
+    /**
+     * name of the VolumeSnapshotClass from which this snapshot was (or will be) created. Note that after provisioning, the VolumeSnapshotClass may be deleted or recreated with different set of values, and as such, should not be referenced post-snapshot creation.
+     */
     @JsonProperty("volumeSnapshotClassName")
     public String getVolumeSnapshotClassName() {
         return volumeSnapshotClassName;
     }
 
+    /**
+     * name of the VolumeSnapshotClass from which this snapshot was (or will be) created. Note that after provisioning, the VolumeSnapshotClass may be deleted or recreated with different set of values, and as such, should not be referenced post-snapshot creation.
+     */
     @JsonProperty("volumeSnapshotClassName")
     public void setVolumeSnapshotClassName(String volumeSnapshotClassName) {
         this.volumeSnapshotClassName = volumeSnapshotClassName;
     }
 
+    /**
+     * VolumeSnapshotContentSpec is the specification of a VolumeSnapshotContent
+     */
     @JsonProperty("volumeSnapshotRef")
     public ObjectReference getVolumeSnapshotRef() {
         return volumeSnapshotRef;
     }
 
+    /**
+     * VolumeSnapshotContentSpec is the specification of a VolumeSnapshotContent
+     */
     @JsonProperty("volumeSnapshotRef")
     public void setVolumeSnapshotRef(ObjectReference volumeSnapshotRef) {
         this.volumeSnapshotRef = volumeSnapshotRef;
diff --git a/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotContentStatus.java b/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotContentStatus.java
index d67bd3e42b7..97778602dfa 100644
--- a/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotContentStatus.java
+++ b/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotContentStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeSnapshotContentStatus is the status of a VolumeSnapshotContent object Note that CreationTime, RestoreSize, ReadyToUse, and Error are in both VolumeSnapshotStatus and VolumeSnapshotContentStatus. Fields in VolumeSnapshotStatus are updated based on fields in VolumeSnapshotContentStatus. They are eventual consistency. These fields are duplicate in both objects due to the following reasons:<br><p>   - Fields in VolumeSnapshotContentStatus can be used for filtering when importing a<br><p>     volumesnapshot.<br><p>   - VolumsnapshotStatus is used by end users because they cannot see VolumeSnapshotContent.<br><p>   - CSI snapshotter sidecar is light weight as it only watches VolumeSnapshotContent<br><p>     object, not VolumeSnapshot object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public VolumeSnapshotContentStatus(Long creationTime, VolumeSnapshotError error,
         this.volumeGroupSnapshotHandle = volumeGroupSnapshotHandle;
     }
 
+    /**
+     * creationTime is the timestamp when the point-in-time snapshot is taken by the underlying storage system. In dynamic snapshot creation case, this field will be filled in by the CSI snapshotter sidecar with the "creation_time" value returned from CSI "CreateSnapshot" gRPC call. For a pre-existing snapshot, this field will be filled with the "creation_time" value returned from the CSI "ListSnapshots" gRPC call if the driver supports it. If not specified, it indicates the creation time is unknown. The format of this field is a Unix nanoseconds time encoded as an int64. On Unix, the command `date +%s%N` returns the current time in nanoseconds since 1970-01-01 00:00:00 UTC.
+     */
     @JsonProperty("creationTime")
     public Long getCreationTime() {
         return creationTime;
     }
 
+    /**
+     * creationTime is the timestamp when the point-in-time snapshot is taken by the underlying storage system. In dynamic snapshot creation case, this field will be filled in by the CSI snapshotter sidecar with the "creation_time" value returned from CSI "CreateSnapshot" gRPC call. For a pre-existing snapshot, this field will be filled with the "creation_time" value returned from the CSI "ListSnapshots" gRPC call if the driver supports it. If not specified, it indicates the creation time is unknown. The format of this field is a Unix nanoseconds time encoded as an int64. On Unix, the command `date +%s%N` returns the current time in nanoseconds since 1970-01-01 00:00:00 UTC.
+     */
     @JsonProperty("creationTime")
     public void setCreationTime(Long creationTime) {
         this.creationTime = creationTime;
     }
 
+    /**
+     * VolumeSnapshotContentStatus is the status of a VolumeSnapshotContent object Note that CreationTime, RestoreSize, ReadyToUse, and Error are in both VolumeSnapshotStatus and VolumeSnapshotContentStatus. Fields in VolumeSnapshotStatus are updated based on fields in VolumeSnapshotContentStatus. They are eventual consistency. These fields are duplicate in both objects due to the following reasons:<br><p>   - Fields in VolumeSnapshotContentStatus can be used for filtering when importing a<br><p>     volumesnapshot.<br><p>   - VolumsnapshotStatus is used by end users because they cannot see VolumeSnapshotContent.<br><p>   - CSI snapshotter sidecar is light weight as it only watches VolumeSnapshotContent<br><p>     object, not VolumeSnapshot object.
+     */
     @JsonProperty("error")
     public VolumeSnapshotError getError() {
         return error;
     }
 
+    /**
+     * VolumeSnapshotContentStatus is the status of a VolumeSnapshotContent object Note that CreationTime, RestoreSize, ReadyToUse, and Error are in both VolumeSnapshotStatus and VolumeSnapshotContentStatus. Fields in VolumeSnapshotStatus are updated based on fields in VolumeSnapshotContentStatus. They are eventual consistency. These fields are duplicate in both objects due to the following reasons:<br><p>   - Fields in VolumeSnapshotContentStatus can be used for filtering when importing a<br><p>     volumesnapshot.<br><p>   - VolumsnapshotStatus is used by end users because they cannot see VolumeSnapshotContent.<br><p>   - CSI snapshotter sidecar is light weight as it only watches VolumeSnapshotContent<br><p>     object, not VolumeSnapshot object.
+     */
     @JsonProperty("error")
     public void setError(VolumeSnapshotError error) {
         this.error = error;
     }
 
+    /**
+     * readyToUse indicates if a snapshot is ready to be used to restore a volume. In dynamic snapshot creation case, this field will be filled in by the CSI snapshotter sidecar with the "ready_to_use" value returned from CSI "CreateSnapshot" gRPC call. For a pre-existing snapshot, this field will be filled with the "ready_to_use" value returned from the CSI "ListSnapshots" gRPC call if the driver supports it, otherwise, this field will be set to "True". If not specified, it means the readiness of a snapshot is unknown.
+     */
     @JsonProperty("readyToUse")
     public Boolean getReadyToUse() {
         return readyToUse;
     }
 
+    /**
+     * readyToUse indicates if a snapshot is ready to be used to restore a volume. In dynamic snapshot creation case, this field will be filled in by the CSI snapshotter sidecar with the "ready_to_use" value returned from CSI "CreateSnapshot" gRPC call. For a pre-existing snapshot, this field will be filled with the "ready_to_use" value returned from the CSI "ListSnapshots" gRPC call if the driver supports it, otherwise, this field will be set to "True". If not specified, it means the readiness of a snapshot is unknown.
+     */
     @JsonProperty("readyToUse")
     public void setReadyToUse(Boolean readyToUse) {
         this.readyToUse = readyToUse;
     }
 
+    /**
+     * restoreSize represents the complete size of the snapshot in bytes. In dynamic snapshot creation case, this field will be filled in by the CSI snapshotter sidecar with the "size_bytes" value returned from CSI "CreateSnapshot" gRPC call. For a pre-existing snapshot, this field will be filled with the "size_bytes" value returned from the CSI "ListSnapshots" gRPC call if the driver supports it. When restoring a volume from this snapshot, the size of the volume MUST NOT be smaller than the restoreSize if it is specified, otherwise the restoration will fail. If not specified, it indicates that the size is unknown.
+     */
     @JsonProperty("restoreSize")
     public Long getRestoreSize() {
         return restoreSize;
     }
 
+    /**
+     * restoreSize represents the complete size of the snapshot in bytes. In dynamic snapshot creation case, this field will be filled in by the CSI snapshotter sidecar with the "size_bytes" value returned from CSI "CreateSnapshot" gRPC call. For a pre-existing snapshot, this field will be filled with the "size_bytes" value returned from the CSI "ListSnapshots" gRPC call if the driver supports it. When restoring a volume from this snapshot, the size of the volume MUST NOT be smaller than the restoreSize if it is specified, otherwise the restoration will fail. If not specified, it indicates that the size is unknown.
+     */
     @JsonProperty("restoreSize")
     public void setRestoreSize(Long restoreSize) {
         this.restoreSize = restoreSize;
     }
 
+    /**
+     * snapshotHandle is the CSI "snapshot_id" of a snapshot on the underlying storage system. If not specified, it indicates that dynamic snapshot creation has either failed or it is still in progress.
+     */
     @JsonProperty("snapshotHandle")
     public String getSnapshotHandle() {
         return snapshotHandle;
     }
 
+    /**
+     * snapshotHandle is the CSI "snapshot_id" of a snapshot on the underlying storage system. If not specified, it indicates that dynamic snapshot creation has either failed or it is still in progress.
+     */
     @JsonProperty("snapshotHandle")
     public void setSnapshotHandle(String snapshotHandle) {
         this.snapshotHandle = snapshotHandle;
     }
 
+    /**
+     * VolumeGroupSnapshotHandle is the CSI "group_snapshot_id" of a group snapshot on the underlying storage system.
+     */
     @JsonProperty("volumeGroupSnapshotHandle")
     public String getVolumeGroupSnapshotHandle() {
         return volumeGroupSnapshotHandle;
     }
 
+    /**
+     * VolumeGroupSnapshotHandle is the CSI "group_snapshot_id" of a group snapshot on the underlying storage system.
+     */
     @JsonProperty("volumeGroupSnapshotHandle")
     public void setVolumeGroupSnapshotHandle(String volumeGroupSnapshotHandle) {
         this.volumeGroupSnapshotHandle = volumeGroupSnapshotHandle;
diff --git a/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotError.java b/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotError.java
index 37e61d3fbea..334cf3e166f 100644
--- a/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotError.java
+++ b/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotError.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeSnapshotError describes an error encountered during snapshot creation.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public VolumeSnapshotError(String message, String time) {
         this.time = time;
     }
 
+    /**
+     * message is a string detailing the encountered error during snapshot creation if specified. NOTE: message may be logged, and it should not contain sensitive information.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message is a string detailing the encountered error during snapshot creation if specified. NOTE: message may be logged, and it should not contain sensitive information.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * VolumeSnapshotError describes an error encountered during snapshot creation.
+     */
     @JsonProperty("time")
     public String getTime() {
         return time;
     }
 
+    /**
+     * VolumeSnapshotError describes an error encountered during snapshot creation.
+     */
     @JsonProperty("time")
     public void setTime(String time) {
         this.time = time;
diff --git a/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotList.java b/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotList.java
index 2c6a6170469..fe540c7ea76 100644
--- a/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotList.java
+++ b/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeSnapshotList is a list of VolumeSnapshot objects
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class VolumeSnapshotList implements Editable<VolumeSnapshotListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.volumesnapshot.api.model.VolumeSnapshot>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "snapshot.storage.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.volumesnapshot.api.model.VolumeSnapshot> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VolumeSnapshotList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public VolumeSnapshotList(String apiVersion, List<io.fabric8.volumesnapshot.api.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of VolumeSnapshots
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.volumesnapshot.api.model.VolumeSnapshot> getItems() {
         return items;
     }
 
+    /**
+     * List of VolumeSnapshots
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.volumesnapshot.api.model.VolumeSnapshot> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VolumeSnapshotList is a list of VolumeSnapshot objects
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VolumeSnapshotList is a list of VolumeSnapshot objects
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotSource.java b/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotSource.java
index 5c01a155b6b..be8ae74c50a 100644
--- a/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotSource.java
+++ b/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotSource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeSnapshotSource specifies whether the underlying snapshot should be dynamically taken upon creation or if a pre-existing VolumeSnapshotContent object should be used. Exactly one of its members must be set. Members in VolumeSnapshotSource are immutable.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public VolumeSnapshotSource(String persistentVolumeClaimName, String volumeSnaps
         this.volumeSnapshotContentName = volumeSnapshotContentName;
     }
 
+    /**
+     * persistentVolumeClaimName specifies the name of the PersistentVolumeClaim object representing the volume from which a snapshot should be created. This PVC is assumed to be in the same namespace as the VolumeSnapshot object. This field should be set if the snapshot does not exists, and needs to be created. This field is immutable.
+     */
     @JsonProperty("persistentVolumeClaimName")
     public String getPersistentVolumeClaimName() {
         return persistentVolumeClaimName;
     }
 
+    /**
+     * persistentVolumeClaimName specifies the name of the PersistentVolumeClaim object representing the volume from which a snapshot should be created. This PVC is assumed to be in the same namespace as the VolumeSnapshot object. This field should be set if the snapshot does not exists, and needs to be created. This field is immutable.
+     */
     @JsonProperty("persistentVolumeClaimName")
     public void setPersistentVolumeClaimName(String persistentVolumeClaimName) {
         this.persistentVolumeClaimName = persistentVolumeClaimName;
     }
 
+    /**
+     * volumeSnapshotContentName specifies the name of a pre-existing VolumeSnapshotContent object representing an existing volume snapshot. This field should be set if the snapshot already exists and only needs a representation in Kubernetes. This field is immutable.
+     */
     @JsonProperty("volumeSnapshotContentName")
     public String getVolumeSnapshotContentName() {
         return volumeSnapshotContentName;
     }
 
+    /**
+     * volumeSnapshotContentName specifies the name of a pre-existing VolumeSnapshotContent object representing an existing volume snapshot. This field should be set if the snapshot already exists and only needs a representation in Kubernetes. This field is immutable.
+     */
     @JsonProperty("volumeSnapshotContentName")
     public void setVolumeSnapshotContentName(String volumeSnapshotContentName) {
         this.volumeSnapshotContentName = volumeSnapshotContentName;
diff --git a/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotSpec.java b/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotSpec.java
index b5a28e6d9a3..c3f5377c42a 100644
--- a/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotSpec.java
+++ b/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeSnapshotSpec describes the common attributes of a volume snapshot.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public VolumeSnapshotSpec(VolumeSnapshotSource source, String volumeSnapshotClas
         this.volumeSnapshotClassName = volumeSnapshotClassName;
     }
 
+    /**
+     * VolumeSnapshotSpec describes the common attributes of a volume snapshot.
+     */
     @JsonProperty("source")
     public VolumeSnapshotSource getSource() {
         return source;
     }
 
+    /**
+     * VolumeSnapshotSpec describes the common attributes of a volume snapshot.
+     */
     @JsonProperty("source")
     public void setSource(VolumeSnapshotSource source) {
         this.source = source;
     }
 
+    /**
+     * VolumeSnapshotClassName is the name of the VolumeSnapshotClass requested by the VolumeSnapshot. VolumeSnapshotClassName may be left nil to indicate that the default SnapshotClass should be used. A given cluster may have multiple default Volume SnapshotClasses: one default per CSI Driver. If a VolumeSnapshot does not specify a SnapshotClass, VolumeSnapshotSource will be checked to figure out what the associated CSI Driver is, and the default VolumeSnapshotClass associated with that CSI Driver will be used. If more than one VolumeSnapshotClass exist for a given CSI Driver and more than one have been marked as default, CreateSnapshot will fail and generate an event. Empty string is not allowed for this field.
+     */
     @JsonProperty("volumeSnapshotClassName")
     public String getVolumeSnapshotClassName() {
         return volumeSnapshotClassName;
     }
 
+    /**
+     * VolumeSnapshotClassName is the name of the VolumeSnapshotClass requested by the VolumeSnapshot. VolumeSnapshotClassName may be left nil to indicate that the default SnapshotClass should be used. A given cluster may have multiple default Volume SnapshotClasses: one default per CSI Driver. If a VolumeSnapshot does not specify a SnapshotClass, VolumeSnapshotSource will be checked to figure out what the associated CSI Driver is, and the default VolumeSnapshotClass associated with that CSI Driver will be used. If more than one VolumeSnapshotClass exist for a given CSI Driver and more than one have been marked as default, CreateSnapshot will fail and generate an event. Empty string is not allowed for this field.
+     */
     @JsonProperty("volumeSnapshotClassName")
     public void setVolumeSnapshotClassName(String volumeSnapshotClassName) {
         this.volumeSnapshotClassName = volumeSnapshotClassName;
diff --git a/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotStatus.java b/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotStatus.java
index 80e3dc51e87..61c47d668a5 100644
--- a/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotStatus.java
+++ b/extensions/volumesnapshot/model/src/generated/java/io/fabric8/volumesnapshot/api/model/VolumeSnapshotStatus.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeSnapshotStatus is the status of the VolumeSnapshot Note that CreationTime, RestoreSize, ReadyToUse, and Error are in both VolumeSnapshotStatus and VolumeSnapshotContentStatus. Fields in VolumeSnapshotStatus are updated based on fields in VolumeSnapshotContentStatus. They are eventual consistency. These fields are duplicate in both objects due to the following reasons:<br><p>   - Fields in VolumeSnapshotContentStatus can be used for filtering when importing a<br><p>     volumesnapshot.<br><p>   - VolumsnapshotStatus is used by end users because they cannot see VolumeSnapshotContent.<br><p>   - CSI snapshotter sidecar is light weight as it only watches VolumeSnapshotContent<br><p>     object, not VolumeSnapshot object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -99,61 +102,97 @@ public VolumeSnapshotStatus(String boundVolumeSnapshotContentName, String creati
         this.volumeGroupSnapshotName = volumeGroupSnapshotName;
     }
 
+    /**
+     * boundVolumeSnapshotContentName is the name of the VolumeSnapshotContent object to which this VolumeSnapshot object intends to bind to. If not specified, it indicates that the VolumeSnapshot object has not been successfully bound to a VolumeSnapshotContent object yet. NOTE: To avoid possible security issues, consumers must verify binding between VolumeSnapshot and VolumeSnapshotContent objects is successful (by validating that both VolumeSnapshot and VolumeSnapshotContent point at each other) before using this object.
+     */
     @JsonProperty("boundVolumeSnapshotContentName")
     public String getBoundVolumeSnapshotContentName() {
         return boundVolumeSnapshotContentName;
     }
 
+    /**
+     * boundVolumeSnapshotContentName is the name of the VolumeSnapshotContent object to which this VolumeSnapshot object intends to bind to. If not specified, it indicates that the VolumeSnapshot object has not been successfully bound to a VolumeSnapshotContent object yet. NOTE: To avoid possible security issues, consumers must verify binding between VolumeSnapshot and VolumeSnapshotContent objects is successful (by validating that both VolumeSnapshot and VolumeSnapshotContent point at each other) before using this object.
+     */
     @JsonProperty("boundVolumeSnapshotContentName")
     public void setBoundVolumeSnapshotContentName(String boundVolumeSnapshotContentName) {
         this.boundVolumeSnapshotContentName = boundVolumeSnapshotContentName;
     }
 
+    /**
+     * VolumeSnapshotStatus is the status of the VolumeSnapshot Note that CreationTime, RestoreSize, ReadyToUse, and Error are in both VolumeSnapshotStatus and VolumeSnapshotContentStatus. Fields in VolumeSnapshotStatus are updated based on fields in VolumeSnapshotContentStatus. They are eventual consistency. These fields are duplicate in both objects due to the following reasons:<br><p>   - Fields in VolumeSnapshotContentStatus can be used for filtering when importing a<br><p>     volumesnapshot.<br><p>   - VolumsnapshotStatus is used by end users because they cannot see VolumeSnapshotContent.<br><p>   - CSI snapshotter sidecar is light weight as it only watches VolumeSnapshotContent<br><p>     object, not VolumeSnapshot object.
+     */
     @JsonProperty("creationTime")
     public String getCreationTime() {
         return creationTime;
     }
 
+    /**
+     * VolumeSnapshotStatus is the status of the VolumeSnapshot Note that CreationTime, RestoreSize, ReadyToUse, and Error are in both VolumeSnapshotStatus and VolumeSnapshotContentStatus. Fields in VolumeSnapshotStatus are updated based on fields in VolumeSnapshotContentStatus. They are eventual consistency. These fields are duplicate in both objects due to the following reasons:<br><p>   - Fields in VolumeSnapshotContentStatus can be used for filtering when importing a<br><p>     volumesnapshot.<br><p>   - VolumsnapshotStatus is used by end users because they cannot see VolumeSnapshotContent.<br><p>   - CSI snapshotter sidecar is light weight as it only watches VolumeSnapshotContent<br><p>     object, not VolumeSnapshot object.
+     */
     @JsonProperty("creationTime")
     public void setCreationTime(String creationTime) {
         this.creationTime = creationTime;
     }
 
+    /**
+     * VolumeSnapshotStatus is the status of the VolumeSnapshot Note that CreationTime, RestoreSize, ReadyToUse, and Error are in both VolumeSnapshotStatus and VolumeSnapshotContentStatus. Fields in VolumeSnapshotStatus are updated based on fields in VolumeSnapshotContentStatus. They are eventual consistency. These fields are duplicate in both objects due to the following reasons:<br><p>   - Fields in VolumeSnapshotContentStatus can be used for filtering when importing a<br><p>     volumesnapshot.<br><p>   - VolumsnapshotStatus is used by end users because they cannot see VolumeSnapshotContent.<br><p>   - CSI snapshotter sidecar is light weight as it only watches VolumeSnapshotContent<br><p>     object, not VolumeSnapshot object.
+     */
     @JsonProperty("error")
     public VolumeSnapshotError getError() {
         return error;
     }
 
+    /**
+     * VolumeSnapshotStatus is the status of the VolumeSnapshot Note that CreationTime, RestoreSize, ReadyToUse, and Error are in both VolumeSnapshotStatus and VolumeSnapshotContentStatus. Fields in VolumeSnapshotStatus are updated based on fields in VolumeSnapshotContentStatus. They are eventual consistency. These fields are duplicate in both objects due to the following reasons:<br><p>   - Fields in VolumeSnapshotContentStatus can be used for filtering when importing a<br><p>     volumesnapshot.<br><p>   - VolumsnapshotStatus is used by end users because they cannot see VolumeSnapshotContent.<br><p>   - CSI snapshotter sidecar is light weight as it only watches VolumeSnapshotContent<br><p>     object, not VolumeSnapshot object.
+     */
     @JsonProperty("error")
     public void setError(VolumeSnapshotError error) {
         this.error = error;
     }
 
+    /**
+     * readyToUse indicates if the snapshot is ready to be used to restore a volume. In dynamic snapshot creation case, this field will be filled in by the snapshot controller with the "ready_to_use" value returned from CSI "CreateSnapshot" gRPC call. For a pre-existing snapshot, this field will be filled with the "ready_to_use" value returned from the CSI "ListSnapshots" gRPC call if the driver supports it, otherwise, this field will be set to "True". If not specified, it means the readiness of a snapshot is unknown.
+     */
     @JsonProperty("readyToUse")
     public Boolean getReadyToUse() {
         return readyToUse;
     }
 
+    /**
+     * readyToUse indicates if the snapshot is ready to be used to restore a volume. In dynamic snapshot creation case, this field will be filled in by the snapshot controller with the "ready_to_use" value returned from CSI "CreateSnapshot" gRPC call. For a pre-existing snapshot, this field will be filled with the "ready_to_use" value returned from the CSI "ListSnapshots" gRPC call if the driver supports it, otherwise, this field will be set to "True". If not specified, it means the readiness of a snapshot is unknown.
+     */
     @JsonProperty("readyToUse")
     public void setReadyToUse(Boolean readyToUse) {
         this.readyToUse = readyToUse;
     }
 
+    /**
+     * VolumeSnapshotStatus is the status of the VolumeSnapshot Note that CreationTime, RestoreSize, ReadyToUse, and Error are in both VolumeSnapshotStatus and VolumeSnapshotContentStatus. Fields in VolumeSnapshotStatus are updated based on fields in VolumeSnapshotContentStatus. They are eventual consistency. These fields are duplicate in both objects due to the following reasons:<br><p>   - Fields in VolumeSnapshotContentStatus can be used for filtering when importing a<br><p>     volumesnapshot.<br><p>   - VolumsnapshotStatus is used by end users because they cannot see VolumeSnapshotContent.<br><p>   - CSI snapshotter sidecar is light weight as it only watches VolumeSnapshotContent<br><p>     object, not VolumeSnapshot object.
+     */
     @JsonProperty("restoreSize")
     public Quantity getRestoreSize() {
         return restoreSize;
     }
 
+    /**
+     * VolumeSnapshotStatus is the status of the VolumeSnapshot Note that CreationTime, RestoreSize, ReadyToUse, and Error are in both VolumeSnapshotStatus and VolumeSnapshotContentStatus. Fields in VolumeSnapshotStatus are updated based on fields in VolumeSnapshotContentStatus. They are eventual consistency. These fields are duplicate in both objects due to the following reasons:<br><p>   - Fields in VolumeSnapshotContentStatus can be used for filtering when importing a<br><p>     volumesnapshot.<br><p>   - VolumsnapshotStatus is used by end users because they cannot see VolumeSnapshotContent.<br><p>   - CSI snapshotter sidecar is light weight as it only watches VolumeSnapshotContent<br><p>     object, not VolumeSnapshot object.
+     */
     @JsonProperty("restoreSize")
     public void setRestoreSize(Quantity restoreSize) {
         this.restoreSize = restoreSize;
     }
 
+    /**
+     * VolumeGroupSnapshotName is the name of the VolumeGroupSnapshot of which this VolumeSnapshot is a part of.
+     */
     @JsonProperty("volumeGroupSnapshotName")
     public String getVolumeGroupSnapshotName() {
         return volumeGroupSnapshotName;
     }
 
+    /**
+     * VolumeGroupSnapshotName is the name of the VolumeGroupSnapshot of which this VolumeSnapshot is a part of.
+     */
     @JsonProperty("volumeGroupSnapshotName")
     public void setVolumeGroupSnapshotName(String volumeGroupSnapshotName) {
         this.volumeGroupSnapshotName = volumeGroupSnapshotName;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admission/v1/AdmissionReview.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admission/v1/AdmissionReview.java
index 65f98bc328c..3f58ca02b9c 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admission/v1/AdmissionReview.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admission/v1/AdmissionReview.java
@@ -74,14 +74,8 @@
 public class AdmissionReview implements Editable<AdmissionReviewBuilder>, KubernetesResource
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "admission.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AdmissionReview";
     @JsonProperty("request")
@@ -105,33 +99,21 @@ public AdmissionReview(String apiVersion, String kind, AdmissionRequest request,
         this.response = response;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admission/v1beta1/AdmissionReview.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admission/v1beta1/AdmissionReview.java
index 6c2a7edd659..90fb414de2f 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admission/v1beta1/AdmissionReview.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admission/v1beta1/AdmissionReview.java
@@ -74,14 +74,8 @@
 public class AdmissionReview implements Editable<AdmissionReviewBuilder>, KubernetesResource
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "admission.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AdmissionReview";
     @JsonProperty("request")
@@ -105,33 +99,21 @@ public AdmissionReview(String apiVersion, String kind, AdmissionRequest request,
         this.response = response;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/AuditAnnotation.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/AuditAnnotation.java
index fee239d5730..a216b0aa009 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/AuditAnnotation.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/AuditAnnotation.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AuditAnnotation describes how to produce an audit annotation for an API request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public AuditAnnotation(String key, String valueExpression) {
         this.valueExpression = valueExpression;
     }
 
+    /**
+     * key specifies the audit annotation key. The audit annotation keys of a ValidatingAdmissionPolicy must be unique. The key must be a qualified name ([A-Za-z0-9][-A-Za-z0-9_.]&#42;) no more than 63 bytes in length.<br><p> <br><p> The key is combined with the resource name of the ValidatingAdmissionPolicy to construct an audit annotation key: "{ValidatingAdmissionPolicy name}/{key}".<br><p> <br><p> If an admission webhook uses the same resource name as this ValidatingAdmissionPolicy and the same audit annotation key, the annotation key will be identical. In this case, the first annotation written with the key will be included in the audit event and all subsequent annotations with the same key will be discarded.<br><p> <br><p> Required.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * key specifies the audit annotation key. The audit annotation keys of a ValidatingAdmissionPolicy must be unique. The key must be a qualified name ([A-Za-z0-9][-A-Za-z0-9_.]&#42;) no more than 63 bytes in length.<br><p> <br><p> The key is combined with the resource name of the ValidatingAdmissionPolicy to construct an audit annotation key: "{ValidatingAdmissionPolicy name}/{key}".<br><p> <br><p> If an admission webhook uses the same resource name as this ValidatingAdmissionPolicy and the same audit annotation key, the annotation key will be identical. In this case, the first annotation written with the key will be included in the audit event and all subsequent annotations with the same key will be discarded.<br><p> <br><p> Required.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * valueExpression represents the expression which is evaluated by CEL to produce an audit annotation value. The expression must evaluate to either a string or null value. If the expression evaluates to a string, the audit annotation is included with the string value. If the expression evaluates to null or empty string the audit annotation will be omitted. The valueExpression may be no longer than 5kb in length. If the result of the valueExpression is more than 10kb in length, it will be truncated to 10kb.<br><p> <br><p> If multiple ValidatingAdmissionPolicyBinding resources match an API request, then the valueExpression will be evaluated for each binding. All unique values produced by the valueExpressions will be joined together in a comma-separated list.<br><p> <br><p> Required.
+     */
     @JsonProperty("valueExpression")
     public String getValueExpression() {
         return valueExpression;
     }
 
+    /**
+     * valueExpression represents the expression which is evaluated by CEL to produce an audit annotation value. The expression must evaluate to either a string or null value. If the expression evaluates to a string, the audit annotation is included with the string value. If the expression evaluates to null or empty string the audit annotation will be omitted. The valueExpression may be no longer than 5kb in length. If the result of the valueExpression is more than 10kb in length, it will be truncated to 10kb.<br><p> <br><p> If multiple ValidatingAdmissionPolicyBinding resources match an API request, then the valueExpression will be evaluated for each binding. All unique values produced by the valueExpressions will be joined together in a comma-separated list.<br><p> <br><p> Required.
+     */
     @JsonProperty("valueExpression")
     public void setValueExpression(String valueExpression) {
         this.valueExpression = valueExpression;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ExpressionWarning.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ExpressionWarning.java
index 38490027674..e9c899c4616 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ExpressionWarning.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ExpressionWarning.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ExpressionWarning is a warning information that targets a specific expression.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ExpressionWarning(String fieldRef, String warning) {
         this.warning = warning;
     }
 
+    /**
+     * The path to the field that refers the expression. For example, the reference to the expression of the first item of validations is "spec.validations[0].expression"
+     */
     @JsonProperty("fieldRef")
     public String getFieldRef() {
         return fieldRef;
     }
 
+    /**
+     * The path to the field that refers the expression. For example, the reference to the expression of the first item of validations is "spec.validations[0].expression"
+     */
     @JsonProperty("fieldRef")
     public void setFieldRef(String fieldRef) {
         this.fieldRef = fieldRef;
     }
 
+    /**
+     * The content of type checking information in a human-readable form. Each line of the warning contains the type that the expression is checked against, followed by the type check error from the compiler.
+     */
     @JsonProperty("warning")
     public String getWarning() {
         return warning;
     }
 
+    /**
+     * The content of type checking information in a human-readable form. Each line of the warning contains the type that the expression is checked against, followed by the type check error from the compiler.
+     */
     @JsonProperty("warning")
     public void setWarning(String warning) {
         this.warning = warning;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/MatchCondition.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/MatchCondition.java
index 262eb98d66b..5bdf3305f8f 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/MatchCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/MatchCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MatchCondition represents a condition which must by fulfilled for a request to be sent to a webhook.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public MatchCondition(String expression, String name) {
         this.name = name;
     }
 
+    /**
+     * Expression represents the expression which will be evaluated by CEL. Must evaluate to bool. CEL expressions have access to the contents of the AdmissionRequest and Authorizer, organized into CEL variables:<br><p> <br><p> 'object' - The object from the incoming request. The value is null for DELETE requests. 'oldObject' - The existing object. The value is null for CREATE requests. 'request' - Attributes of the admission request(/pkg/apis/admission/types.go#AdmissionRequest). 'authorizer' - A CEL Authorizer. May be used to perform authorization checks for the principal (user or service account) of the request.<br><p>   See https://pkg.go.dev/k8s.io/apiserver/pkg/cel/library#Authz<br><p> 'authorizer.requestResource' - A CEL ResourceCheck constructed from the 'authorizer' and configured with the<br><p>   request resource.<br><p> Documentation on CEL: https://kubernetes.io/docs/reference/using-api/cel/<br><p> <br><p> Required.
+     */
     @JsonProperty("expression")
     public String getExpression() {
         return expression;
     }
 
+    /**
+     * Expression represents the expression which will be evaluated by CEL. Must evaluate to bool. CEL expressions have access to the contents of the AdmissionRequest and Authorizer, organized into CEL variables:<br><p> <br><p> 'object' - The object from the incoming request. The value is null for DELETE requests. 'oldObject' - The existing object. The value is null for CREATE requests. 'request' - Attributes of the admission request(/pkg/apis/admission/types.go#AdmissionRequest). 'authorizer' - A CEL Authorizer. May be used to perform authorization checks for the principal (user or service account) of the request.<br><p>   See https://pkg.go.dev/k8s.io/apiserver/pkg/cel/library#Authz<br><p> 'authorizer.requestResource' - A CEL ResourceCheck constructed from the 'authorizer' and configured with the<br><p>   request resource.<br><p> Documentation on CEL: https://kubernetes.io/docs/reference/using-api/cel/<br><p> <br><p> Required.
+     */
     @JsonProperty("expression")
     public void setExpression(String expression) {
         this.expression = expression;
     }
 
+    /**
+     * Name is an identifier for this match condition, used for strategic merging of MatchConditions, as well as providing an identifier for logging purposes. A good name should be descriptive of the associated expression. Name must be a qualified name consisting of alphanumeric characters, '-', '_' or '.', and must start and end with an alphanumeric character (e.g. 'MyName',  or 'my.name',  or '123-abc', regex used for validation is '([A-Za-z0-9][-A-Za-z0-9_.]&#42;)?[A-Za-z0-9]') with an optional DNS subdomain prefix and '/' (e.g. 'example.com/MyName')<br><p> <br><p> Required.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is an identifier for this match condition, used for strategic merging of MatchConditions, as well as providing an identifier for logging purposes. A good name should be descriptive of the associated expression. Name must be a qualified name consisting of alphanumeric characters, '-', '_' or '.', and must start and end with an alphanumeric character (e.g. 'MyName',  or 'my.name',  or '123-abc', regex used for validation is '([A-Za-z0-9][-A-Za-z0-9_.]&#42;)?[A-Za-z0-9]') with an optional DNS subdomain prefix and '/' (e.g. 'example.com/MyName')<br><p> <br><p> Required.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/MatchResources.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/MatchResources.java
index 9c6f55ce2da..b8b4428c247 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/MatchResources.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/MatchResources.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MatchResources decides whether to run the admission control policy on an object based on whether it meets the match criteria. The exclude rules take precedence over include rules (if a resource matches both, it is excluded)
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,53 +101,83 @@ public MatchResources(List<NamedRuleWithOperations> excludeResourceRules, String
         this.resourceRules = resourceRules;
     }
 
+    /**
+     * ExcludeResourceRules describes what operations on what resources/subresources the ValidatingAdmissionPolicy should not care about. The exclude rules take precedence over include rules (if a resource matches both, it is excluded)
+     */
     @JsonProperty("excludeResourceRules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NamedRuleWithOperations> getExcludeResourceRules() {
         return excludeResourceRules;
     }
 
+    /**
+     * ExcludeResourceRules describes what operations on what resources/subresources the ValidatingAdmissionPolicy should not care about. The exclude rules take precedence over include rules (if a resource matches both, it is excluded)
+     */
     @JsonProperty("excludeResourceRules")
     public void setExcludeResourceRules(List<NamedRuleWithOperations> excludeResourceRules) {
         this.excludeResourceRules = excludeResourceRules;
     }
 
+    /**
+     * matchPolicy defines how the "MatchResources" list is used to match incoming requests. Allowed values are "Exact" or "Equivalent".<br><p> <br><p> - Exact: match a request only if it exactly matches a specified rule. For example, if deployments can be modified via apps/v1, apps/v1beta1, and extensions/v1beta1, but "rules" only included `apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]`, a request to apps/v1beta1 or extensions/v1beta1 would not be sent to the ValidatingAdmissionPolicy.<br><p> <br><p> - Equivalent: match a request if modifies a resource listed in rules, even via another API group or version. For example, if deployments can be modified via apps/v1, apps/v1beta1, and extensions/v1beta1, and "rules" only included `apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]`, a request to apps/v1beta1 or extensions/v1beta1 would be converted to apps/v1 and sent to the ValidatingAdmissionPolicy.<br><p> <br><p> Defaults to "Equivalent"
+     */
     @JsonProperty("matchPolicy")
     public String getMatchPolicy() {
         return matchPolicy;
     }
 
+    /**
+     * matchPolicy defines how the "MatchResources" list is used to match incoming requests. Allowed values are "Exact" or "Equivalent".<br><p> <br><p> - Exact: match a request only if it exactly matches a specified rule. For example, if deployments can be modified via apps/v1, apps/v1beta1, and extensions/v1beta1, but "rules" only included `apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]`, a request to apps/v1beta1 or extensions/v1beta1 would not be sent to the ValidatingAdmissionPolicy.<br><p> <br><p> - Equivalent: match a request if modifies a resource listed in rules, even via another API group or version. For example, if deployments can be modified via apps/v1, apps/v1beta1, and extensions/v1beta1, and "rules" only included `apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]`, a request to apps/v1beta1 or extensions/v1beta1 would be converted to apps/v1 and sent to the ValidatingAdmissionPolicy.<br><p> <br><p> Defaults to "Equivalent"
+     */
     @JsonProperty("matchPolicy")
     public void setMatchPolicy(String matchPolicy) {
         this.matchPolicy = matchPolicy;
     }
 
+    /**
+     * MatchResources decides whether to run the admission control policy on an object based on whether it meets the match criteria. The exclude rules take precedence over include rules (if a resource matches both, it is excluded)
+     */
     @JsonProperty("namespaceSelector")
     public LabelSelector getNamespaceSelector() {
         return namespaceSelector;
     }
 
+    /**
+     * MatchResources decides whether to run the admission control policy on an object based on whether it meets the match criteria. The exclude rules take precedence over include rules (if a resource matches both, it is excluded)
+     */
     @JsonProperty("namespaceSelector")
     public void setNamespaceSelector(LabelSelector namespaceSelector) {
         this.namespaceSelector = namespaceSelector;
     }
 
+    /**
+     * MatchResources decides whether to run the admission control policy on an object based on whether it meets the match criteria. The exclude rules take precedence over include rules (if a resource matches both, it is excluded)
+     */
     @JsonProperty("objectSelector")
     public LabelSelector getObjectSelector() {
         return objectSelector;
     }
 
+    /**
+     * MatchResources decides whether to run the admission control policy on an object based on whether it meets the match criteria. The exclude rules take precedence over include rules (if a resource matches both, it is excluded)
+     */
     @JsonProperty("objectSelector")
     public void setObjectSelector(LabelSelector objectSelector) {
         this.objectSelector = objectSelector;
     }
 
+    /**
+     * ResourceRules describes what operations on what resources/subresources the ValidatingAdmissionPolicy matches. The policy cares about an operation if it matches _any_ Rule.
+     */
     @JsonProperty("resourceRules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NamedRuleWithOperations> getResourceRules() {
         return resourceRules;
     }
 
+    /**
+     * ResourceRules describes what operations on what resources/subresources the ValidatingAdmissionPolicy matches. The policy cares about an operation if it matches _any_ Rule.
+     */
     @JsonProperty("resourceRules")
     public void setResourceRules(List<NamedRuleWithOperations> resourceRules) {
         this.resourceRules = resourceRules;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/MutatingWebhook.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/MutatingWebhook.java
index 9fe2e2974c3..ea41910e45b 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/MutatingWebhook.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/MutatingWebhook.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MutatingWebhook describes an admission webhook and the resources and operations it applies to.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -127,124 +130,196 @@ public MutatingWebhook(List<String> admissionReviewVersions, WebhookClientConfig
         this.timeoutSeconds = timeoutSeconds;
     }
 
+    /**
+     * AdmissionReviewVersions is an ordered list of preferred `AdmissionReview` versions the Webhook expects. API server will try to use first version in the list which it supports. If none of the versions specified in this list supported by API server, validation will fail for this object. If a persisted webhook configuration specifies allowed versions and does not include any versions known to the API Server, calls to the webhook will fail and be subject to the failure policy.
+     */
     @JsonProperty("admissionReviewVersions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAdmissionReviewVersions() {
         return admissionReviewVersions;
     }
 
+    /**
+     * AdmissionReviewVersions is an ordered list of preferred `AdmissionReview` versions the Webhook expects. API server will try to use first version in the list which it supports. If none of the versions specified in this list supported by API server, validation will fail for this object. If a persisted webhook configuration specifies allowed versions and does not include any versions known to the API Server, calls to the webhook will fail and be subject to the failure policy.
+     */
     @JsonProperty("admissionReviewVersions")
     public void setAdmissionReviewVersions(List<String> admissionReviewVersions) {
         this.admissionReviewVersions = admissionReviewVersions;
     }
 
+    /**
+     * MutatingWebhook describes an admission webhook and the resources and operations it applies to.
+     */
     @JsonProperty("clientConfig")
     public WebhookClientConfig getClientConfig() {
         return clientConfig;
     }
 
+    /**
+     * MutatingWebhook describes an admission webhook and the resources and operations it applies to.
+     */
     @JsonProperty("clientConfig")
     public void setClientConfig(WebhookClientConfig clientConfig) {
         this.clientConfig = clientConfig;
     }
 
+    /**
+     * FailurePolicy defines how unrecognized errors from the admission endpoint are handled - allowed values are Ignore or Fail. Defaults to Fail.
+     */
     @JsonProperty("failurePolicy")
     public String getFailurePolicy() {
         return failurePolicy;
     }
 
+    /**
+     * FailurePolicy defines how unrecognized errors from the admission endpoint are handled - allowed values are Ignore or Fail. Defaults to Fail.
+     */
     @JsonProperty("failurePolicy")
     public void setFailurePolicy(String failurePolicy) {
         this.failurePolicy = failurePolicy;
     }
 
+    /**
+     * MatchConditions is a list of conditions that must be met for a request to be sent to this webhook. Match conditions filter requests that have already been matched by the rules, namespaceSelector, and objectSelector. An empty list of matchConditions matches all requests. There are a maximum of 64 match conditions allowed.<br><p> <br><p> The exact matching logic is (in order):<br><p>   1. If ANY matchCondition evaluates to FALSE, the webhook is skipped.<br><p>   2. If ALL matchConditions evaluate to TRUE, the webhook is called.<br><p>   3. If any matchCondition evaluates to an error (but none are FALSE):<br><p>      - If failurePolicy=Fail, reject the request<br><p>      - If failurePolicy=Ignore, the error is ignored and the webhook is skipped
+     */
     @JsonProperty("matchConditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MatchCondition> getMatchConditions() {
         return matchConditions;
     }
 
+    /**
+     * MatchConditions is a list of conditions that must be met for a request to be sent to this webhook. Match conditions filter requests that have already been matched by the rules, namespaceSelector, and objectSelector. An empty list of matchConditions matches all requests. There are a maximum of 64 match conditions allowed.<br><p> <br><p> The exact matching logic is (in order):<br><p>   1. If ANY matchCondition evaluates to FALSE, the webhook is skipped.<br><p>   2. If ALL matchConditions evaluate to TRUE, the webhook is called.<br><p>   3. If any matchCondition evaluates to an error (but none are FALSE):<br><p>      - If failurePolicy=Fail, reject the request<br><p>      - If failurePolicy=Ignore, the error is ignored and the webhook is skipped
+     */
     @JsonProperty("matchConditions")
     public void setMatchConditions(List<MatchCondition> matchConditions) {
         this.matchConditions = matchConditions;
     }
 
+    /**
+     * matchPolicy defines how the "rules" list is used to match incoming requests. Allowed values are "Exact" or "Equivalent".<br><p> <br><p> - Exact: match a request only if it exactly matches a specified rule. For example, if deployments can be modified via apps/v1, apps/v1beta1, and extensions/v1beta1, but "rules" only included `apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]`, a request to apps/v1beta1 or extensions/v1beta1 would not be sent to the webhook.<br><p> <br><p> - Equivalent: match a request if modifies a resource listed in rules, even via another API group or version. For example, if deployments can be modified via apps/v1, apps/v1beta1, and extensions/v1beta1, and "rules" only included `apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]`, a request to apps/v1beta1 or extensions/v1beta1 would be converted to apps/v1 and sent to the webhook.<br><p> <br><p> Defaults to "Equivalent"
+     */
     @JsonProperty("matchPolicy")
     public String getMatchPolicy() {
         return matchPolicy;
     }
 
+    /**
+     * matchPolicy defines how the "rules" list is used to match incoming requests. Allowed values are "Exact" or "Equivalent".<br><p> <br><p> - Exact: match a request only if it exactly matches a specified rule. For example, if deployments can be modified via apps/v1, apps/v1beta1, and extensions/v1beta1, but "rules" only included `apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]`, a request to apps/v1beta1 or extensions/v1beta1 would not be sent to the webhook.<br><p> <br><p> - Equivalent: match a request if modifies a resource listed in rules, even via another API group or version. For example, if deployments can be modified via apps/v1, apps/v1beta1, and extensions/v1beta1, and "rules" only included `apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]`, a request to apps/v1beta1 or extensions/v1beta1 would be converted to apps/v1 and sent to the webhook.<br><p> <br><p> Defaults to "Equivalent"
+     */
     @JsonProperty("matchPolicy")
     public void setMatchPolicy(String matchPolicy) {
         this.matchPolicy = matchPolicy;
     }
 
+    /**
+     * The name of the admission webhook. Name should be fully qualified, e.g., imagepolicy.kubernetes.io, where "imagepolicy" is the name of the webhook, and kubernetes.io is the name of the organization. Required.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The name of the admission webhook. Name should be fully qualified, e.g., imagepolicy.kubernetes.io, where "imagepolicy" is the name of the webhook, and kubernetes.io is the name of the organization. Required.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * MutatingWebhook describes an admission webhook and the resources and operations it applies to.
+     */
     @JsonProperty("namespaceSelector")
     public LabelSelector getNamespaceSelector() {
         return namespaceSelector;
     }
 
+    /**
+     * MutatingWebhook describes an admission webhook and the resources and operations it applies to.
+     */
     @JsonProperty("namespaceSelector")
     public void setNamespaceSelector(LabelSelector namespaceSelector) {
         this.namespaceSelector = namespaceSelector;
     }
 
+    /**
+     * MutatingWebhook describes an admission webhook and the resources and operations it applies to.
+     */
     @JsonProperty("objectSelector")
     public LabelSelector getObjectSelector() {
         return objectSelector;
     }
 
+    /**
+     * MutatingWebhook describes an admission webhook and the resources and operations it applies to.
+     */
     @JsonProperty("objectSelector")
     public void setObjectSelector(LabelSelector objectSelector) {
         this.objectSelector = objectSelector;
     }
 
+    /**
+     * reinvocationPolicy indicates whether this webhook should be called multiple times as part of a single admission evaluation. Allowed values are "Never" and "IfNeeded".<br><p> <br><p> Never: the webhook will not be called more than once in a single admission evaluation.<br><p> <br><p> IfNeeded: the webhook will be called at least one additional time as part of the admission evaluation if the object being admitted is modified by other admission plugins after the initial webhook call. Webhooks that specify this option &#42;must&#42; be idempotent, able to process objects they previously admitted. Note: &#42; the number of additional invocations is not guaranteed to be exactly one. &#42; if additional invocations result in further modifications to the object, webhooks are not guaranteed to be invoked again. &#42; webhooks that use this option may be reordered to minimize the number of additional invocations. &#42; to validate an object after all mutations are guaranteed complete, use a validating admission webhook instead.<br><p> <br><p> Defaults to "Never".
+     */
     @JsonProperty("reinvocationPolicy")
     public String getReinvocationPolicy() {
         return reinvocationPolicy;
     }
 
+    /**
+     * reinvocationPolicy indicates whether this webhook should be called multiple times as part of a single admission evaluation. Allowed values are "Never" and "IfNeeded".<br><p> <br><p> Never: the webhook will not be called more than once in a single admission evaluation.<br><p> <br><p> IfNeeded: the webhook will be called at least one additional time as part of the admission evaluation if the object being admitted is modified by other admission plugins after the initial webhook call. Webhooks that specify this option &#42;must&#42; be idempotent, able to process objects they previously admitted. Note: &#42; the number of additional invocations is not guaranteed to be exactly one. &#42; if additional invocations result in further modifications to the object, webhooks are not guaranteed to be invoked again. &#42; webhooks that use this option may be reordered to minimize the number of additional invocations. &#42; to validate an object after all mutations are guaranteed complete, use a validating admission webhook instead.<br><p> <br><p> Defaults to "Never".
+     */
     @JsonProperty("reinvocationPolicy")
     public void setReinvocationPolicy(String reinvocationPolicy) {
         this.reinvocationPolicy = reinvocationPolicy;
     }
 
+    /**
+     * Rules describes what operations on what resources/subresources the webhook cares about. The webhook cares about an operation if it matches _any_ Rule. However, in order to prevent ValidatingAdmissionWebhooks and MutatingAdmissionWebhooks from putting the cluster in a state which cannot be recovered from without completely disabling the plugin, ValidatingAdmissionWebhooks and MutatingAdmissionWebhooks are never called on admission requests for ValidatingWebhookConfiguration and MutatingWebhookConfiguration objects.
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RuleWithOperations> getRules() {
         return rules;
     }
 
+    /**
+     * Rules describes what operations on what resources/subresources the webhook cares about. The webhook cares about an operation if it matches _any_ Rule. However, in order to prevent ValidatingAdmissionWebhooks and MutatingAdmissionWebhooks from putting the cluster in a state which cannot be recovered from without completely disabling the plugin, ValidatingAdmissionWebhooks and MutatingAdmissionWebhooks are never called on admission requests for ValidatingWebhookConfiguration and MutatingWebhookConfiguration objects.
+     */
     @JsonProperty("rules")
     public void setRules(List<RuleWithOperations> rules) {
         this.rules = rules;
     }
 
+    /**
+     * SideEffects states whether this webhook has side effects. Acceptable values are: None, NoneOnDryRun (webhooks created via v1beta1 may also specify Some or Unknown). Webhooks with side effects MUST implement a reconciliation system, since a request may be rejected by a future step in the admission chain and the side effects therefore need to be undone. Requests with the dryRun attribute will be auto-rejected if they match a webhook with sideEffects == Unknown or Some.
+     */
     @JsonProperty("sideEffects")
     public String getSideEffects() {
         return sideEffects;
     }
 
+    /**
+     * SideEffects states whether this webhook has side effects. Acceptable values are: None, NoneOnDryRun (webhooks created via v1beta1 may also specify Some or Unknown). Webhooks with side effects MUST implement a reconciliation system, since a request may be rejected by a future step in the admission chain and the side effects therefore need to be undone. Requests with the dryRun attribute will be auto-rejected if they match a webhook with sideEffects == Unknown or Some.
+     */
     @JsonProperty("sideEffects")
     public void setSideEffects(String sideEffects) {
         this.sideEffects = sideEffects;
     }
 
+    /**
+     * TimeoutSeconds specifies the timeout for this webhook. After the timeout passes, the webhook call will be ignored or the API call will fail based on the failure policy. The timeout value must be between 1 and 30 seconds. Default to 10 seconds.
+     */
     @JsonProperty("timeoutSeconds")
     public Integer getTimeoutSeconds() {
         return timeoutSeconds;
     }
 
+    /**
+     * TimeoutSeconds specifies the timeout for this webhook. After the timeout passes, the webhook call will be ignored or the API call will fail based on the failure policy. The timeout value must be between 1 and 30 seconds. Default to 10 seconds.
+     */
     @JsonProperty("timeoutSeconds")
     public void setTimeoutSeconds(Integer timeoutSeconds) {
         this.timeoutSeconds = timeoutSeconds;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/MutatingWebhookConfiguration.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/MutatingWebhookConfiguration.java
index ba4790f1b33..cde715d645a 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/MutatingWebhookConfiguration.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/MutatingWebhookConfiguration.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MutatingWebhookConfiguration describes the configuration of and admission webhook that accept or reject and may change the object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class MutatingWebhookConfiguration implements Editable<MutatingWebhookConfigurationBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "admissionregistration.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MutatingWebhookConfiguration";
     @JsonProperty("metadata")
@@ -109,7 +106,7 @@ public MutatingWebhookConfiguration(String apiVersion, String kind, ObjectMeta m
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -117,7 +114,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -125,7 +122,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -133,29 +130,41 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MutatingWebhookConfiguration describes the configuration of and admission webhook that accept or reject and may change the object.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MutatingWebhookConfiguration describes the configuration of and admission webhook that accept or reject and may change the object.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Webhooks is a list of webhooks and the affected resources and operations.
+     */
     @JsonProperty("webhooks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MutatingWebhook> getWebhooks() {
         return webhooks;
     }
 
+    /**
+     * Webhooks is a list of webhooks and the affected resources and operations.
+     */
     @JsonProperty("webhooks")
     public void setWebhooks(List<MutatingWebhook> webhooks) {
         this.webhooks = webhooks;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/MutatingWebhookConfigurationList.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/MutatingWebhookConfigurationList.java
index 0e60372588e..056b3f7b31b 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/MutatingWebhookConfigurationList.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/MutatingWebhookConfigurationList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MutatingWebhookConfigurationList is a list of MutatingWebhookConfiguration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class MutatingWebhookConfigurationList implements Editable<MutatingWebhookConfigurationListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.admissionregistration.v1.MutatingWebhookConfiguration>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "admissionregistration.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.admissionregistration.v1.MutatingWebhookConfiguration> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MutatingWebhookConfigurationList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public MutatingWebhookConfigurationList(String apiVersion, List<io.fabric8.kuber
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of MutatingWebhookConfiguration.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.admissionregistration.v1.MutatingWebhookConfiguration> getItems() {
         return items;
     }
 
+    /**
+     * List of MutatingWebhookConfiguration.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.admissionregistration.v1.MutatingWebhookConfiguration> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MutatingWebhookConfigurationList is a list of MutatingWebhookConfiguration.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MutatingWebhookConfigurationList is a list of MutatingWebhookConfiguration.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/NamedRuleWithOperations.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/NamedRuleWithOperations.java
index c9f643ff40a..d40deeac8c9 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/NamedRuleWithOperations.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/NamedRuleWithOperations.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NamedRuleWithOperations is a tuple of Operations and Resources with ResourceNames.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -105,66 +108,102 @@ public NamedRuleWithOperations(List<String> apiGroups, List<String> apiVersions,
         this.scope = scope;
     }
 
+    /**
+     * APIGroups is the API groups the resources belong to. '&#42;' is all groups. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("apiGroups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiGroups() {
         return apiGroups;
     }
 
+    /**
+     * APIGroups is the API groups the resources belong to. '&#42;' is all groups. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("apiGroups")
     public void setApiGroups(List<String> apiGroups) {
         this.apiGroups = apiGroups;
     }
 
+    /**
+     * APIVersions is the API versions the resources belong to. '&#42;' is all versions. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("apiVersions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiVersions() {
         return apiVersions;
     }
 
+    /**
+     * APIVersions is the API versions the resources belong to. '&#42;' is all versions. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("apiVersions")
     public void setApiVersions(List<String> apiVersions) {
         this.apiVersions = apiVersions;
     }
 
+    /**
+     * Operations is the operations the admission hook cares about - CREATE, UPDATE, DELETE, CONNECT or &#42; for all of those operations and any future admission operations that are added. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("operations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getOperations() {
         return operations;
     }
 
+    /**
+     * Operations is the operations the admission hook cares about - CREATE, UPDATE, DELETE, CONNECT or &#42; for all of those operations and any future admission operations that are added. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("operations")
     public void setOperations(List<String> operations) {
         this.operations = operations;
     }
 
+    /**
+     * ResourceNames is an optional white list of names that the rule applies to.  An empty set means that everything is allowed.
+     */
     @JsonProperty("resourceNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getResourceNames() {
         return resourceNames;
     }
 
+    /**
+     * ResourceNames is an optional white list of names that the rule applies to.  An empty set means that everything is allowed.
+     */
     @JsonProperty("resourceNames")
     public void setResourceNames(List<String> resourceNames) {
         this.resourceNames = resourceNames;
     }
 
+    /**
+     * Resources is a list of resources this rule applies to.<br><p> <br><p> For example: 'pods' means pods. 'pods/log' means the log subresource of pods. '&#42;' means all resources, but not subresources. 'pods/&#42;' means all subresources of pods. '&#42;/scale' means all scale subresources. '&#42;/&#42;' means all resources and their subresources.<br><p> <br><p> If wildcard is present, the validation rule will ensure resources do not overlap with each other.<br><p> <br><p> Depending on the enclosing object, subresources might not be allowed. Required.
+     */
     @JsonProperty("resources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getResources() {
         return resources;
     }
 
+    /**
+     * Resources is a list of resources this rule applies to.<br><p> <br><p> For example: 'pods' means pods. 'pods/log' means the log subresource of pods. '&#42;' means all resources, but not subresources. 'pods/&#42;' means all subresources of pods. '&#42;/scale' means all scale subresources. '&#42;/&#42;' means all resources and their subresources.<br><p> <br><p> If wildcard is present, the validation rule will ensure resources do not overlap with each other.<br><p> <br><p> Depending on the enclosing object, subresources might not be allowed. Required.
+     */
     @JsonProperty("resources")
     public void setResources(List<String> resources) {
         this.resources = resources;
     }
 
+    /**
+     * scope specifies the scope of this rule. Valid values are "Cluster", "Namespaced", and "&#42;" "Cluster" means that only cluster-scoped resources will match this rule. Namespace API objects are cluster-scoped. "Namespaced" means that only namespaced resources will match this rule. "&#42;" means that there are no scope restrictions. Subresources match the scope of their parent resource. Default is "&#42;".
+     */
     @JsonProperty("scope")
     public String getScope() {
         return scope;
     }
 
+    /**
+     * scope specifies the scope of this rule. Valid values are "Cluster", "Namespaced", and "&#42;" "Cluster" means that only cluster-scoped resources will match this rule. Namespace API objects are cluster-scoped. "Namespaced" means that only namespaced resources will match this rule. "&#42;" means that there are no scope restrictions. Subresources match the scope of their parent resource. Default is "&#42;".
+     */
     @JsonProperty("scope")
     public void setScope(String scope) {
         this.scope = scope;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ParamKind.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ParamKind.java
index 65684fe00c6..e02d96ee875 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ParamKind.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ParamKind.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ParamKind is a tuple of Group Kind and Version.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ParamKind(String apiVersion, String kind) {
         this.kind = kind;
     }
 
+    /**
+     * APIVersion is the API group version the resources belong to. In format of "group/version". Required.
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * APIVersion is the API group version the resources belong to. In format of "group/version". Required.
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Kind is the API kind the resources belong to. Required.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is the API kind the resources belong to. Required.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ParamRef.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ParamRef.java
index bcacaf7db1f..b389049e09b 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ParamRef.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ParamRef.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ParamRef describes how to locate the params to be used as input to expressions of rules applied by a policy binding.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ParamRef(String name, String namespace, String parameterNotFoundAction, L
         this.selector = selector;
     }
 
+    /**
+     * name is the name of the resource being referenced.<br><p> <br><p> One of `name` or `selector` must be set, but `name` and `selector` are mutually exclusive properties. If one is set, the other must be unset.<br><p> <br><p> A single parameter used for all admission requests can be configured by setting the `name` field, leaving `selector` blank, and setting namespace if `paramKind` is namespace-scoped.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the resource being referenced.<br><p> <br><p> One of `name` or `selector` must be set, but `name` and `selector` are mutually exclusive properties. If one is set, the other must be unset.<br><p> <br><p> A single parameter used for all admission requests can be configured by setting the `name` field, leaving `selector` blank, and setting namespace if `paramKind` is namespace-scoped.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * namespace is the namespace of the referenced resource. Allows limiting the search for params to a specific namespace. Applies to both `name` and `selector` fields.<br><p> <br><p> A per-namespace parameter may be used by specifying a namespace-scoped `paramKind` in the policy and leaving this field empty.<br><p> <br><p> - If `paramKind` is cluster-scoped, this field MUST be unset. Setting this field results in a configuration error.<br><p> <br><p> - If `paramKind` is namespace-scoped, the namespace of the object being evaluated for admission will be used when this field is left unset. Take care that if this is left empty the binding must not match any cluster-scoped resources, which will result in an error.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * namespace is the namespace of the referenced resource. Allows limiting the search for params to a specific namespace. Applies to both `name` and `selector` fields.<br><p> <br><p> A per-namespace parameter may be used by specifying a namespace-scoped `paramKind` in the policy and leaving this field empty.<br><p> <br><p> - If `paramKind` is cluster-scoped, this field MUST be unset. Setting this field results in a configuration error.<br><p> <br><p> - If `paramKind` is namespace-scoped, the namespace of the object being evaluated for admission will be used when this field is left unset. Take care that if this is left empty the binding must not match any cluster-scoped resources, which will result in an error.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * `parameterNotFoundAction` controls the behavior of the binding when the resource exists, and name or selector is valid, but there are no parameters matched by the binding. If the value is set to `Allow`, then no matched parameters will be treated as successful validation by the binding. If set to `Deny`, then no matched parameters will be subject to the `failurePolicy` of the policy.<br><p> <br><p> Allowed values are `Allow` or `Deny`<br><p> <br><p> Required
+     */
     @JsonProperty("parameterNotFoundAction")
     public String getParameterNotFoundAction() {
         return parameterNotFoundAction;
     }
 
+    /**
+     * `parameterNotFoundAction` controls the behavior of the binding when the resource exists, and name or selector is valid, but there are no parameters matched by the binding. If the value is set to `Allow`, then no matched parameters will be treated as successful validation by the binding. If set to `Deny`, then no matched parameters will be subject to the `failurePolicy` of the policy.<br><p> <br><p> Allowed values are `Allow` or `Deny`<br><p> <br><p> Required
+     */
     @JsonProperty("parameterNotFoundAction")
     public void setParameterNotFoundAction(String parameterNotFoundAction) {
         this.parameterNotFoundAction = parameterNotFoundAction;
     }
 
+    /**
+     * ParamRef describes how to locate the params to be used as input to expressions of rules applied by a policy binding.
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * ParamRef describes how to locate the params to be used as input to expressions of rules applied by a policy binding.
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/RuleWithOperations.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/RuleWithOperations.java
index 47875b33698..84d71e64957 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/RuleWithOperations.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/RuleWithOperations.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RuleWithOperations is a tuple of Operations and Resources. It is recommended to make sure that all the tuple expansions are valid.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -100,55 +103,85 @@ public RuleWithOperations(List<String> apiGroups, List<String> apiVersions, List
         this.scope = scope;
     }
 
+    /**
+     * APIGroups is the API groups the resources belong to. '&#42;' is all groups. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("apiGroups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiGroups() {
         return apiGroups;
     }
 
+    /**
+     * APIGroups is the API groups the resources belong to. '&#42;' is all groups. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("apiGroups")
     public void setApiGroups(List<String> apiGroups) {
         this.apiGroups = apiGroups;
     }
 
+    /**
+     * APIVersions is the API versions the resources belong to. '&#42;' is all versions. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("apiVersions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiVersions() {
         return apiVersions;
     }
 
+    /**
+     * APIVersions is the API versions the resources belong to. '&#42;' is all versions. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("apiVersions")
     public void setApiVersions(List<String> apiVersions) {
         this.apiVersions = apiVersions;
     }
 
+    /**
+     * Operations is the operations the admission hook cares about - CREATE, UPDATE, DELETE, CONNECT or &#42; for all of those operations and any future admission operations that are added. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("operations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getOperations() {
         return operations;
     }
 
+    /**
+     * Operations is the operations the admission hook cares about - CREATE, UPDATE, DELETE, CONNECT or &#42; for all of those operations and any future admission operations that are added. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("operations")
     public void setOperations(List<String> operations) {
         this.operations = operations;
     }
 
+    /**
+     * Resources is a list of resources this rule applies to.<br><p> <br><p> For example: 'pods' means pods. 'pods/log' means the log subresource of pods. '&#42;' means all resources, but not subresources. 'pods/&#42;' means all subresources of pods. '&#42;/scale' means all scale subresources. '&#42;/&#42;' means all resources and their subresources.<br><p> <br><p> If wildcard is present, the validation rule will ensure resources do not overlap with each other.<br><p> <br><p> Depending on the enclosing object, subresources might not be allowed. Required.
+     */
     @JsonProperty("resources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getResources() {
         return resources;
     }
 
+    /**
+     * Resources is a list of resources this rule applies to.<br><p> <br><p> For example: 'pods' means pods. 'pods/log' means the log subresource of pods. '&#42;' means all resources, but not subresources. 'pods/&#42;' means all subresources of pods. '&#42;/scale' means all scale subresources. '&#42;/&#42;' means all resources and their subresources.<br><p> <br><p> If wildcard is present, the validation rule will ensure resources do not overlap with each other.<br><p> <br><p> Depending on the enclosing object, subresources might not be allowed. Required.
+     */
     @JsonProperty("resources")
     public void setResources(List<String> resources) {
         this.resources = resources;
     }
 
+    /**
+     * scope specifies the scope of this rule. Valid values are "Cluster", "Namespaced", and "&#42;" "Cluster" means that only cluster-scoped resources will match this rule. Namespace API objects are cluster-scoped. "Namespaced" means that only namespaced resources will match this rule. "&#42;" means that there are no scope restrictions. Subresources match the scope of their parent resource. Default is "&#42;".
+     */
     @JsonProperty("scope")
     public String getScope() {
         return scope;
     }
 
+    /**
+     * scope specifies the scope of this rule. Valid values are "Cluster", "Namespaced", and "&#42;" "Cluster" means that only cluster-scoped resources will match this rule. Namespace API objects are cluster-scoped. "Namespaced" means that only namespaced resources will match this rule. "&#42;" means that there are no scope restrictions. Subresources match the scope of their parent resource. Default is "&#42;".
+     */
     @JsonProperty("scope")
     public void setScope(String scope) {
         this.scope = scope;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ServiceReference.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ServiceReference.java
index ddcd3ec3f7b..ad76281ffb9 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ServiceReference.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ServiceReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceReference holds a reference to Service.legacy.k8s.io
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ServiceReference(String name, String namespace, String path, Integer port
         this.port = port;
     }
 
+    /**
+     * `name` is the name of the service. Required
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * `name` is the name of the service. Required
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * `namespace` is the namespace of the service. Required
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * `namespace` is the namespace of the service. Required
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * `path` is an optional URL path which will be sent in any request to this service.
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * `path` is an optional URL path which will be sent in any request to this service.
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * If specified, the port on the service that hosting webhook. Default to 443 for backward compatibility. `port` should be a valid port number (1-65535, inclusive).
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * If specified, the port on the service that hosting webhook. Default to 443 for backward compatibility. `port` should be a valid port number (1-65535, inclusive).
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/TypeChecking.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/TypeChecking.java
index f08f99edd3e..3767306f5bd 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/TypeChecking.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/TypeChecking.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TypeChecking contains results of type checking the expressions in the ValidatingAdmissionPolicy
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public TypeChecking(List<ExpressionWarning> expressionWarnings) {
         this.expressionWarnings = expressionWarnings;
     }
 
+    /**
+     * The type checking warnings for each expression.
+     */
     @JsonProperty("expressionWarnings")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ExpressionWarning> getExpressionWarnings() {
         return expressionWarnings;
     }
 
+    /**
+     * The type checking warnings for each expression.
+     */
     @JsonProperty("expressionWarnings")
     public void setExpressionWarnings(List<ExpressionWarning> expressionWarnings) {
         this.expressionWarnings = expressionWarnings;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingAdmissionPolicy.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingAdmissionPolicy.java
index b92a576c351..bebf2fed2ef 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingAdmissionPolicy.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingAdmissionPolicy.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ValidatingAdmissionPolicy describes the definition of an admission validation policy that accepts or rejects an object without changing it.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ValidatingAdmissionPolicy implements Editable<ValidatingAdmissionPolicyBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "admissionregistration.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ValidatingAdmissionPolicy";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public ValidatingAdmissionPolicy(String apiVersion, String kind, ObjectMeta meta
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ValidatingAdmissionPolicy describes the definition of an admission validation policy that accepts or rejects an object without changing it.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ValidatingAdmissionPolicy describes the definition of an admission validation policy that accepts or rejects an object without changing it.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ValidatingAdmissionPolicy describes the definition of an admission validation policy that accepts or rejects an object without changing it.
+     */
     @JsonProperty("spec")
     public ValidatingAdmissionPolicySpec getSpec() {
         return spec;
     }
 
+    /**
+     * ValidatingAdmissionPolicy describes the definition of an admission validation policy that accepts or rejects an object without changing it.
+     */
     @JsonProperty("spec")
     public void setSpec(ValidatingAdmissionPolicySpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ValidatingAdmissionPolicy describes the definition of an admission validation policy that accepts or rejects an object without changing it.
+     */
     @JsonProperty("status")
     public ValidatingAdmissionPolicyStatus getStatus() {
         return status;
     }
 
+    /**
+     * ValidatingAdmissionPolicy describes the definition of an admission validation policy that accepts or rejects an object without changing it.
+     */
     @JsonProperty("status")
     public void setStatus(ValidatingAdmissionPolicyStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingAdmissionPolicyBinding.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingAdmissionPolicyBinding.java
index 8f8d5412caa..a809ce4bfb8 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingAdmissionPolicyBinding.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingAdmissionPolicyBinding.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ValidatingAdmissionPolicyBinding binds the ValidatingAdmissionPolicy with paramerized resources. ValidatingAdmissionPolicyBinding and parameter CRDs together define how cluster administrators configure policies for clusters.<br><p> <br><p> For a given admission request, each binding will cause its policy to be evaluated N times, where N is 1 for policies/bindings that don't use params, otherwise N is the number of parameters selected by the binding.<br><p> <br><p> The CEL expressions of a policy must have a computed CEL cost below the maximum CEL budget. Each evaluation of the policy is given an independent CEL cost budget. Adding/removing policies, bindings, or params can not affect whether a given (policy, binding, param) combination is within its own CEL budget.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class ValidatingAdmissionPolicyBinding implements Editable<ValidatingAdmissionPolicyBindingBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "admissionregistration.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ValidatingAdmissionPolicyBinding";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public ValidatingAdmissionPolicyBinding(String apiVersion, String kind, ObjectMe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ValidatingAdmissionPolicyBinding binds the ValidatingAdmissionPolicy with paramerized resources. ValidatingAdmissionPolicyBinding and parameter CRDs together define how cluster administrators configure policies for clusters.<br><p> <br><p> For a given admission request, each binding will cause its policy to be evaluated N times, where N is 1 for policies/bindings that don't use params, otherwise N is the number of parameters selected by the binding.<br><p> <br><p> The CEL expressions of a policy must have a computed CEL cost below the maximum CEL budget. Each evaluation of the policy is given an independent CEL cost budget. Adding/removing policies, bindings, or params can not affect whether a given (policy, binding, param) combination is within its own CEL budget.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ValidatingAdmissionPolicyBinding binds the ValidatingAdmissionPolicy with paramerized resources. ValidatingAdmissionPolicyBinding and parameter CRDs together define how cluster administrators configure policies for clusters.<br><p> <br><p> For a given admission request, each binding will cause its policy to be evaluated N times, where N is 1 for policies/bindings that don't use params, otherwise N is the number of parameters selected by the binding.<br><p> <br><p> The CEL expressions of a policy must have a computed CEL cost below the maximum CEL budget. Each evaluation of the policy is given an independent CEL cost budget. Adding/removing policies, bindings, or params can not affect whether a given (policy, binding, param) combination is within its own CEL budget.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ValidatingAdmissionPolicyBinding binds the ValidatingAdmissionPolicy with paramerized resources. ValidatingAdmissionPolicyBinding and parameter CRDs together define how cluster administrators configure policies for clusters.<br><p> <br><p> For a given admission request, each binding will cause its policy to be evaluated N times, where N is 1 for policies/bindings that don't use params, otherwise N is the number of parameters selected by the binding.<br><p> <br><p> The CEL expressions of a policy must have a computed CEL cost below the maximum CEL budget. Each evaluation of the policy is given an independent CEL cost budget. Adding/removing policies, bindings, or params can not affect whether a given (policy, binding, param) combination is within its own CEL budget.
+     */
     @JsonProperty("spec")
     public ValidatingAdmissionPolicyBindingSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ValidatingAdmissionPolicyBinding binds the ValidatingAdmissionPolicy with paramerized resources. ValidatingAdmissionPolicyBinding and parameter CRDs together define how cluster administrators configure policies for clusters.<br><p> <br><p> For a given admission request, each binding will cause its policy to be evaluated N times, where N is 1 for policies/bindings that don't use params, otherwise N is the number of parameters selected by the binding.<br><p> <br><p> The CEL expressions of a policy must have a computed CEL cost below the maximum CEL budget. Each evaluation of the policy is given an independent CEL cost budget. Adding/removing policies, bindings, or params can not affect whether a given (policy, binding, param) combination is within its own CEL budget.
+     */
     @JsonProperty("spec")
     public void setSpec(ValidatingAdmissionPolicyBindingSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingAdmissionPolicyBindingList.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingAdmissionPolicyBindingList.java
index ce683866f3c..c26f8cbcc2f 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingAdmissionPolicyBindingList.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingAdmissionPolicyBindingList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ValidatingAdmissionPolicyBindingList is a list of ValidatingAdmissionPolicyBinding.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ValidatingAdmissionPolicyBindingList implements Editable<ValidatingAdmissionPolicyBindingListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.admissionregistration.v1.ValidatingAdmissionPolicyBinding>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "admissionregistration.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.admissionregistration.v1.ValidatingAdmissionPolicyBinding> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ValidatingAdmissionPolicyBindingList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ValidatingAdmissionPolicyBindingList(String apiVersion, List<io.fabric8.k
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of PolicyBinding.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.admissionregistration.v1.ValidatingAdmissionPolicyBinding> getItems() {
         return items;
     }
 
+    /**
+     * List of PolicyBinding.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.admissionregistration.v1.ValidatingAdmissionPolicyBinding> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ValidatingAdmissionPolicyBindingList is a list of ValidatingAdmissionPolicyBinding.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ValidatingAdmissionPolicyBindingList is a list of ValidatingAdmissionPolicyBinding.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingAdmissionPolicyBindingSpec.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingAdmissionPolicyBindingSpec.java
index 9b413614b06..111b8326912 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingAdmissionPolicyBindingSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingAdmissionPolicyBindingSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ValidatingAdmissionPolicyBindingSpec is the specification of the ValidatingAdmissionPolicyBinding.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public ValidatingAdmissionPolicyBindingSpec(MatchResources matchResources, Param
         this.validationActions = validationActions;
     }
 
+    /**
+     * ValidatingAdmissionPolicyBindingSpec is the specification of the ValidatingAdmissionPolicyBinding.
+     */
     @JsonProperty("matchResources")
     public MatchResources getMatchResources() {
         return matchResources;
     }
 
+    /**
+     * ValidatingAdmissionPolicyBindingSpec is the specification of the ValidatingAdmissionPolicyBinding.
+     */
     @JsonProperty("matchResources")
     public void setMatchResources(MatchResources matchResources) {
         this.matchResources = matchResources;
     }
 
+    /**
+     * ValidatingAdmissionPolicyBindingSpec is the specification of the ValidatingAdmissionPolicyBinding.
+     */
     @JsonProperty("paramRef")
     public ParamRef getParamRef() {
         return paramRef;
     }
 
+    /**
+     * ValidatingAdmissionPolicyBindingSpec is the specification of the ValidatingAdmissionPolicyBinding.
+     */
     @JsonProperty("paramRef")
     public void setParamRef(ParamRef paramRef) {
         this.paramRef = paramRef;
     }
 
+    /**
+     * PolicyName references a ValidatingAdmissionPolicy name which the ValidatingAdmissionPolicyBinding binds to. If the referenced resource does not exist, this binding is considered invalid and will be ignored Required.
+     */
     @JsonProperty("policyName")
     public String getPolicyName() {
         return policyName;
     }
 
+    /**
+     * PolicyName references a ValidatingAdmissionPolicy name which the ValidatingAdmissionPolicyBinding binds to. If the referenced resource does not exist, this binding is considered invalid and will be ignored Required.
+     */
     @JsonProperty("policyName")
     public void setPolicyName(String policyName) {
         this.policyName = policyName;
     }
 
+    /**
+     * validationActions declares how Validations of the referenced ValidatingAdmissionPolicy are enforced. If a validation evaluates to false it is always enforced according to these actions.<br><p> <br><p> Failures defined by the ValidatingAdmissionPolicy's FailurePolicy are enforced according to these actions only if the FailurePolicy is set to Fail, otherwise the failures are ignored. This includes compilation errors, runtime errors and misconfigurations of the policy.<br><p> <br><p> validationActions is declared as a set of action values. Order does not matter. validationActions may not contain duplicates of the same action.<br><p> <br><p> The supported actions values are:<br><p> <br><p> "Deny" specifies that a validation failure results in a denied request.<br><p> <br><p> "Warn" specifies that a validation failure is reported to the request client in HTTP Warning headers, with a warning code of 299. Warnings can be sent both for allowed or denied admission responses.<br><p> <br><p> "Audit" specifies that a validation failure is included in the published audit event for the request. The audit event will contain a `validation.policy.admission.k8s.io/validation_failure` audit annotation with a value containing the details of the validation failures, formatted as a JSON list of objects, each with the following fields: - message: The validation failure message string - policy: The resource name of the ValidatingAdmissionPolicy - binding: The resource name of the ValidatingAdmissionPolicyBinding - expressionIndex: The index of the failed validations in the ValidatingAdmissionPolicy - validationActions: The enforcement actions enacted for the validation failure Example audit annotation: `"validation.policy.admission.k8s.io/validation_failure": "[{\"message\": \"Invalid value\", {\"policy\": \"policy.example.com\", {\"binding\": \"policybinding.example.com\", {\"expressionIndex\": \"1\", {\"validationActions\": [\"Audit\"]}]"`<br><p> <br><p> Clients should expect to handle additional values by ignoring any values not recognized.<br><p> <br><p> "Deny" and "Warn" may not be used together since this combination needlessly duplicates the validation failure both in the API response body and the HTTP warning headers.<br><p> <br><p> Required.
+     */
     @JsonProperty("validationActions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getValidationActions() {
         return validationActions;
     }
 
+    /**
+     * validationActions declares how Validations of the referenced ValidatingAdmissionPolicy are enforced. If a validation evaluates to false it is always enforced according to these actions.<br><p> <br><p> Failures defined by the ValidatingAdmissionPolicy's FailurePolicy are enforced according to these actions only if the FailurePolicy is set to Fail, otherwise the failures are ignored. This includes compilation errors, runtime errors and misconfigurations of the policy.<br><p> <br><p> validationActions is declared as a set of action values. Order does not matter. validationActions may not contain duplicates of the same action.<br><p> <br><p> The supported actions values are:<br><p> <br><p> "Deny" specifies that a validation failure results in a denied request.<br><p> <br><p> "Warn" specifies that a validation failure is reported to the request client in HTTP Warning headers, with a warning code of 299. Warnings can be sent both for allowed or denied admission responses.<br><p> <br><p> "Audit" specifies that a validation failure is included in the published audit event for the request. The audit event will contain a `validation.policy.admission.k8s.io/validation_failure` audit annotation with a value containing the details of the validation failures, formatted as a JSON list of objects, each with the following fields: - message: The validation failure message string - policy: The resource name of the ValidatingAdmissionPolicy - binding: The resource name of the ValidatingAdmissionPolicyBinding - expressionIndex: The index of the failed validations in the ValidatingAdmissionPolicy - validationActions: The enforcement actions enacted for the validation failure Example audit annotation: `"validation.policy.admission.k8s.io/validation_failure": "[{\"message\": \"Invalid value\", {\"policy\": \"policy.example.com\", {\"binding\": \"policybinding.example.com\", {\"expressionIndex\": \"1\", {\"validationActions\": [\"Audit\"]}]"`<br><p> <br><p> Clients should expect to handle additional values by ignoring any values not recognized.<br><p> <br><p> "Deny" and "Warn" may not be used together since this combination needlessly duplicates the validation failure both in the API response body and the HTTP warning headers.<br><p> <br><p> Required.
+     */
     @JsonProperty("validationActions")
     public void setValidationActions(List<String> validationActions) {
         this.validationActions = validationActions;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingAdmissionPolicyList.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingAdmissionPolicyList.java
index d473e542570..7d0cf7de8db 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingAdmissionPolicyList.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingAdmissionPolicyList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ValidatingAdmissionPolicyList is a list of ValidatingAdmissionPolicy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ValidatingAdmissionPolicyList implements Editable<ValidatingAdmissionPolicyListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.admissionregistration.v1.ValidatingAdmissionPolicy>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "admissionregistration.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.admissionregistration.v1.ValidatingAdmissionPolicy> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ValidatingAdmissionPolicyList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ValidatingAdmissionPolicyList(String apiVersion, List<io.fabric8.kubernet
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of ValidatingAdmissionPolicy.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.admissionregistration.v1.ValidatingAdmissionPolicy> getItems() {
         return items;
     }
 
+    /**
+     * List of ValidatingAdmissionPolicy.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.admissionregistration.v1.ValidatingAdmissionPolicy> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ValidatingAdmissionPolicyList is a list of ValidatingAdmissionPolicy.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ValidatingAdmissionPolicyList is a list of ValidatingAdmissionPolicy.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingAdmissionPolicySpec.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingAdmissionPolicySpec.java
index 4ec90d3952d..7e77052e61d 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingAdmissionPolicySpec.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingAdmissionPolicySpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ValidatingAdmissionPolicySpec is the specification of the desired behavior of the AdmissionPolicy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -108,75 +111,117 @@ public ValidatingAdmissionPolicySpec(List<AuditAnnotation> auditAnnotations, Str
         this.variables = variables;
     }
 
+    /**
+     * auditAnnotations contains CEL expressions which are used to produce audit annotations for the audit event of the API request. validations and auditAnnotations may not both be empty; a least one of validations or auditAnnotations is required.
+     */
     @JsonProperty("auditAnnotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AuditAnnotation> getAuditAnnotations() {
         return auditAnnotations;
     }
 
+    /**
+     * auditAnnotations contains CEL expressions which are used to produce audit annotations for the audit event of the API request. validations and auditAnnotations may not both be empty; a least one of validations or auditAnnotations is required.
+     */
     @JsonProperty("auditAnnotations")
     public void setAuditAnnotations(List<AuditAnnotation> auditAnnotations) {
         this.auditAnnotations = auditAnnotations;
     }
 
+    /**
+     * failurePolicy defines how to handle failures for the admission policy. Failures can occur from CEL expression parse errors, type check errors, runtime errors and invalid or mis-configured policy definitions or bindings.<br><p> <br><p> A policy is invalid if spec.paramKind refers to a non-existent Kind. A binding is invalid if spec.paramRef.name refers to a non-existent resource.<br><p> <br><p> failurePolicy does not define how validations that evaluate to false are handled.<br><p> <br><p> When failurePolicy is set to Fail, ValidatingAdmissionPolicyBinding validationActions define how failures are enforced.<br><p> <br><p> Allowed values are Ignore or Fail. Defaults to Fail.
+     */
     @JsonProperty("failurePolicy")
     public String getFailurePolicy() {
         return failurePolicy;
     }
 
+    /**
+     * failurePolicy defines how to handle failures for the admission policy. Failures can occur from CEL expression parse errors, type check errors, runtime errors and invalid or mis-configured policy definitions or bindings.<br><p> <br><p> A policy is invalid if spec.paramKind refers to a non-existent Kind. A binding is invalid if spec.paramRef.name refers to a non-existent resource.<br><p> <br><p> failurePolicy does not define how validations that evaluate to false are handled.<br><p> <br><p> When failurePolicy is set to Fail, ValidatingAdmissionPolicyBinding validationActions define how failures are enforced.<br><p> <br><p> Allowed values are Ignore or Fail. Defaults to Fail.
+     */
     @JsonProperty("failurePolicy")
     public void setFailurePolicy(String failurePolicy) {
         this.failurePolicy = failurePolicy;
     }
 
+    /**
+     * MatchConditions is a list of conditions that must be met for a request to be validated. Match conditions filter requests that have already been matched by the rules, namespaceSelector, and objectSelector. An empty list of matchConditions matches all requests. There are a maximum of 64 match conditions allowed.<br><p> <br><p> If a parameter object is provided, it can be accessed via the `params` handle in the same manner as validation expressions.<br><p> <br><p> The exact matching logic is (in order):<br><p>   1. If ANY matchCondition evaluates to FALSE, the policy is skipped.<br><p>   2. If ALL matchConditions evaluate to TRUE, the policy is evaluated.<br><p>   3. If any matchCondition evaluates to an error (but none are FALSE):<br><p>      - If failurePolicy=Fail, reject the request<br><p>      - If failurePolicy=Ignore, the policy is skipped
+     */
     @JsonProperty("matchConditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MatchCondition> getMatchConditions() {
         return matchConditions;
     }
 
+    /**
+     * MatchConditions is a list of conditions that must be met for a request to be validated. Match conditions filter requests that have already been matched by the rules, namespaceSelector, and objectSelector. An empty list of matchConditions matches all requests. There are a maximum of 64 match conditions allowed.<br><p> <br><p> If a parameter object is provided, it can be accessed via the `params` handle in the same manner as validation expressions.<br><p> <br><p> The exact matching logic is (in order):<br><p>   1. If ANY matchCondition evaluates to FALSE, the policy is skipped.<br><p>   2. If ALL matchConditions evaluate to TRUE, the policy is evaluated.<br><p>   3. If any matchCondition evaluates to an error (but none are FALSE):<br><p>      - If failurePolicy=Fail, reject the request<br><p>      - If failurePolicy=Ignore, the policy is skipped
+     */
     @JsonProperty("matchConditions")
     public void setMatchConditions(List<MatchCondition> matchConditions) {
         this.matchConditions = matchConditions;
     }
 
+    /**
+     * ValidatingAdmissionPolicySpec is the specification of the desired behavior of the AdmissionPolicy.
+     */
     @JsonProperty("matchConstraints")
     public MatchResources getMatchConstraints() {
         return matchConstraints;
     }
 
+    /**
+     * ValidatingAdmissionPolicySpec is the specification of the desired behavior of the AdmissionPolicy.
+     */
     @JsonProperty("matchConstraints")
     public void setMatchConstraints(MatchResources matchConstraints) {
         this.matchConstraints = matchConstraints;
     }
 
+    /**
+     * ValidatingAdmissionPolicySpec is the specification of the desired behavior of the AdmissionPolicy.
+     */
     @JsonProperty("paramKind")
     public ParamKind getParamKind() {
         return paramKind;
     }
 
+    /**
+     * ValidatingAdmissionPolicySpec is the specification of the desired behavior of the AdmissionPolicy.
+     */
     @JsonProperty("paramKind")
     public void setParamKind(ParamKind paramKind) {
         this.paramKind = paramKind;
     }
 
+    /**
+     * Validations contain CEL expressions which is used to apply the validation. Validations and AuditAnnotations may not both be empty; a minimum of one Validations or AuditAnnotations is required.
+     */
     @JsonProperty("validations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Validation> getValidations() {
         return validations;
     }
 
+    /**
+     * Validations contain CEL expressions which is used to apply the validation. Validations and AuditAnnotations may not both be empty; a minimum of one Validations or AuditAnnotations is required.
+     */
     @JsonProperty("validations")
     public void setValidations(List<Validation> validations) {
         this.validations = validations;
     }
 
+    /**
+     * Variables contain definitions of variables that can be used in composition of other expressions. Each variable is defined as a named CEL expression. The variables defined here will be available under `variables` in other expressions of the policy except MatchConditions because MatchConditions are evaluated before the rest of the policy.<br><p> <br><p> The expression of a variable can refer to other variables defined earlier in the list but not those after. Thus, Variables must be sorted by the order of first appearance and acyclic.
+     */
     @JsonProperty("variables")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Variable> getVariables() {
         return variables;
     }
 
+    /**
+     * Variables contain definitions of variables that can be used in composition of other expressions. Each variable is defined as a named CEL expression. The variables defined here will be available under `variables` in other expressions of the policy except MatchConditions because MatchConditions are evaluated before the rest of the policy.<br><p> <br><p> The expression of a variable can refer to other variables defined earlier in the list but not those after. Thus, Variables must be sorted by the order of first appearance and acyclic.
+     */
     @JsonProperty("variables")
     public void setVariables(List<Variable> variables) {
         this.variables = variables;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingAdmissionPolicyStatus.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingAdmissionPolicyStatus.java
index 4215b77e07d..7b0ee5d2565 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingAdmissionPolicyStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingAdmissionPolicyStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ValidatingAdmissionPolicyStatus represents the status of an admission validation policy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,32 +93,50 @@ public ValidatingAdmissionPolicyStatus(List<Condition> conditions, Long observed
         this.typeChecking = typeChecking;
     }
 
+    /**
+     * The conditions represent the latest available observations of a policy's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * The conditions represent the latest available observations of a policy's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * The generation observed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * The generation observed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * ValidatingAdmissionPolicyStatus represents the status of an admission validation policy.
+     */
     @JsonProperty("typeChecking")
     public TypeChecking getTypeChecking() {
         return typeChecking;
     }
 
+    /**
+     * ValidatingAdmissionPolicyStatus represents the status of an admission validation policy.
+     */
     @JsonProperty("typeChecking")
     public void setTypeChecking(TypeChecking typeChecking) {
         this.typeChecking = typeChecking;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingWebhook.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingWebhook.java
index e9ebe2dbc59..9faae45a1b1 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingWebhook.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingWebhook.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ValidatingWebhook describes an admission webhook and the resources and operations it applies to.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -123,114 +126,180 @@ public ValidatingWebhook(List<String> admissionReviewVersions, WebhookClientConf
         this.timeoutSeconds = timeoutSeconds;
     }
 
+    /**
+     * AdmissionReviewVersions is an ordered list of preferred `AdmissionReview` versions the Webhook expects. API server will try to use first version in the list which it supports. If none of the versions specified in this list supported by API server, validation will fail for this object. If a persisted webhook configuration specifies allowed versions and does not include any versions known to the API Server, calls to the webhook will fail and be subject to the failure policy.
+     */
     @JsonProperty("admissionReviewVersions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAdmissionReviewVersions() {
         return admissionReviewVersions;
     }
 
+    /**
+     * AdmissionReviewVersions is an ordered list of preferred `AdmissionReview` versions the Webhook expects. API server will try to use first version in the list which it supports. If none of the versions specified in this list supported by API server, validation will fail for this object. If a persisted webhook configuration specifies allowed versions and does not include any versions known to the API Server, calls to the webhook will fail and be subject to the failure policy.
+     */
     @JsonProperty("admissionReviewVersions")
     public void setAdmissionReviewVersions(List<String> admissionReviewVersions) {
         this.admissionReviewVersions = admissionReviewVersions;
     }
 
+    /**
+     * ValidatingWebhook describes an admission webhook and the resources and operations it applies to.
+     */
     @JsonProperty("clientConfig")
     public WebhookClientConfig getClientConfig() {
         return clientConfig;
     }
 
+    /**
+     * ValidatingWebhook describes an admission webhook and the resources and operations it applies to.
+     */
     @JsonProperty("clientConfig")
     public void setClientConfig(WebhookClientConfig clientConfig) {
         this.clientConfig = clientConfig;
     }
 
+    /**
+     * FailurePolicy defines how unrecognized errors from the admission endpoint are handled - allowed values are Ignore or Fail. Defaults to Fail.
+     */
     @JsonProperty("failurePolicy")
     public String getFailurePolicy() {
         return failurePolicy;
     }
 
+    /**
+     * FailurePolicy defines how unrecognized errors from the admission endpoint are handled - allowed values are Ignore or Fail. Defaults to Fail.
+     */
     @JsonProperty("failurePolicy")
     public void setFailurePolicy(String failurePolicy) {
         this.failurePolicy = failurePolicy;
     }
 
+    /**
+     * MatchConditions is a list of conditions that must be met for a request to be sent to this webhook. Match conditions filter requests that have already been matched by the rules, namespaceSelector, and objectSelector. An empty list of matchConditions matches all requests. There are a maximum of 64 match conditions allowed.<br><p> <br><p> The exact matching logic is (in order):<br><p>   1. If ANY matchCondition evaluates to FALSE, the webhook is skipped.<br><p>   2. If ALL matchConditions evaluate to TRUE, the webhook is called.<br><p>   3. If any matchCondition evaluates to an error (but none are FALSE):<br><p>      - If failurePolicy=Fail, reject the request<br><p>      - If failurePolicy=Ignore, the error is ignored and the webhook is skipped
+     */
     @JsonProperty("matchConditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MatchCondition> getMatchConditions() {
         return matchConditions;
     }
 
+    /**
+     * MatchConditions is a list of conditions that must be met for a request to be sent to this webhook. Match conditions filter requests that have already been matched by the rules, namespaceSelector, and objectSelector. An empty list of matchConditions matches all requests. There are a maximum of 64 match conditions allowed.<br><p> <br><p> The exact matching logic is (in order):<br><p>   1. If ANY matchCondition evaluates to FALSE, the webhook is skipped.<br><p>   2. If ALL matchConditions evaluate to TRUE, the webhook is called.<br><p>   3. If any matchCondition evaluates to an error (but none are FALSE):<br><p>      - If failurePolicy=Fail, reject the request<br><p>      - If failurePolicy=Ignore, the error is ignored and the webhook is skipped
+     */
     @JsonProperty("matchConditions")
     public void setMatchConditions(List<MatchCondition> matchConditions) {
         this.matchConditions = matchConditions;
     }
 
+    /**
+     * matchPolicy defines how the "rules" list is used to match incoming requests. Allowed values are "Exact" or "Equivalent".<br><p> <br><p> - Exact: match a request only if it exactly matches a specified rule. For example, if deployments can be modified via apps/v1, apps/v1beta1, and extensions/v1beta1, but "rules" only included `apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]`, a request to apps/v1beta1 or extensions/v1beta1 would not be sent to the webhook.<br><p> <br><p> - Equivalent: match a request if modifies a resource listed in rules, even via another API group or version. For example, if deployments can be modified via apps/v1, apps/v1beta1, and extensions/v1beta1, and "rules" only included `apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]`, a request to apps/v1beta1 or extensions/v1beta1 would be converted to apps/v1 and sent to the webhook.<br><p> <br><p> Defaults to "Equivalent"
+     */
     @JsonProperty("matchPolicy")
     public String getMatchPolicy() {
         return matchPolicy;
     }
 
+    /**
+     * matchPolicy defines how the "rules" list is used to match incoming requests. Allowed values are "Exact" or "Equivalent".<br><p> <br><p> - Exact: match a request only if it exactly matches a specified rule. For example, if deployments can be modified via apps/v1, apps/v1beta1, and extensions/v1beta1, but "rules" only included `apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]`, a request to apps/v1beta1 or extensions/v1beta1 would not be sent to the webhook.<br><p> <br><p> - Equivalent: match a request if modifies a resource listed in rules, even via another API group or version. For example, if deployments can be modified via apps/v1, apps/v1beta1, and extensions/v1beta1, and "rules" only included `apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]`, a request to apps/v1beta1 or extensions/v1beta1 would be converted to apps/v1 and sent to the webhook.<br><p> <br><p> Defaults to "Equivalent"
+     */
     @JsonProperty("matchPolicy")
     public void setMatchPolicy(String matchPolicy) {
         this.matchPolicy = matchPolicy;
     }
 
+    /**
+     * The name of the admission webhook. Name should be fully qualified, e.g., imagepolicy.kubernetes.io, where "imagepolicy" is the name of the webhook, and kubernetes.io is the name of the organization. Required.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The name of the admission webhook. Name should be fully qualified, e.g., imagepolicy.kubernetes.io, where "imagepolicy" is the name of the webhook, and kubernetes.io is the name of the organization. Required.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * ValidatingWebhook describes an admission webhook and the resources and operations it applies to.
+     */
     @JsonProperty("namespaceSelector")
     public LabelSelector getNamespaceSelector() {
         return namespaceSelector;
     }
 
+    /**
+     * ValidatingWebhook describes an admission webhook and the resources and operations it applies to.
+     */
     @JsonProperty("namespaceSelector")
     public void setNamespaceSelector(LabelSelector namespaceSelector) {
         this.namespaceSelector = namespaceSelector;
     }
 
+    /**
+     * ValidatingWebhook describes an admission webhook and the resources and operations it applies to.
+     */
     @JsonProperty("objectSelector")
     public LabelSelector getObjectSelector() {
         return objectSelector;
     }
 
+    /**
+     * ValidatingWebhook describes an admission webhook and the resources and operations it applies to.
+     */
     @JsonProperty("objectSelector")
     public void setObjectSelector(LabelSelector objectSelector) {
         this.objectSelector = objectSelector;
     }
 
+    /**
+     * Rules describes what operations on what resources/subresources the webhook cares about. The webhook cares about an operation if it matches _any_ Rule. However, in order to prevent ValidatingAdmissionWebhooks and MutatingAdmissionWebhooks from putting the cluster in a state which cannot be recovered from without completely disabling the plugin, ValidatingAdmissionWebhooks and MutatingAdmissionWebhooks are never called on admission requests for ValidatingWebhookConfiguration and MutatingWebhookConfiguration objects.
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RuleWithOperations> getRules() {
         return rules;
     }
 
+    /**
+     * Rules describes what operations on what resources/subresources the webhook cares about. The webhook cares about an operation if it matches _any_ Rule. However, in order to prevent ValidatingAdmissionWebhooks and MutatingAdmissionWebhooks from putting the cluster in a state which cannot be recovered from without completely disabling the plugin, ValidatingAdmissionWebhooks and MutatingAdmissionWebhooks are never called on admission requests for ValidatingWebhookConfiguration and MutatingWebhookConfiguration objects.
+     */
     @JsonProperty("rules")
     public void setRules(List<RuleWithOperations> rules) {
         this.rules = rules;
     }
 
+    /**
+     * SideEffects states whether this webhook has side effects. Acceptable values are: None, NoneOnDryRun (webhooks created via v1beta1 may also specify Some or Unknown). Webhooks with side effects MUST implement a reconciliation system, since a request may be rejected by a future step in the admission chain and the side effects therefore need to be undone. Requests with the dryRun attribute will be auto-rejected if they match a webhook with sideEffects == Unknown or Some.
+     */
     @JsonProperty("sideEffects")
     public String getSideEffects() {
         return sideEffects;
     }
 
+    /**
+     * SideEffects states whether this webhook has side effects. Acceptable values are: None, NoneOnDryRun (webhooks created via v1beta1 may also specify Some or Unknown). Webhooks with side effects MUST implement a reconciliation system, since a request may be rejected by a future step in the admission chain and the side effects therefore need to be undone. Requests with the dryRun attribute will be auto-rejected if they match a webhook with sideEffects == Unknown or Some.
+     */
     @JsonProperty("sideEffects")
     public void setSideEffects(String sideEffects) {
         this.sideEffects = sideEffects;
     }
 
+    /**
+     * TimeoutSeconds specifies the timeout for this webhook. After the timeout passes, the webhook call will be ignored or the API call will fail based on the failure policy. The timeout value must be between 1 and 30 seconds. Default to 10 seconds.
+     */
     @JsonProperty("timeoutSeconds")
     public Integer getTimeoutSeconds() {
         return timeoutSeconds;
     }
 
+    /**
+     * TimeoutSeconds specifies the timeout for this webhook. After the timeout passes, the webhook call will be ignored or the API call will fail based on the failure policy. The timeout value must be between 1 and 30 seconds. Default to 10 seconds.
+     */
     @JsonProperty("timeoutSeconds")
     public void setTimeoutSeconds(Integer timeoutSeconds) {
         this.timeoutSeconds = timeoutSeconds;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingWebhookConfiguration.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingWebhookConfiguration.java
index 8f4bc5001b9..d5bc52e155d 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingWebhookConfiguration.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingWebhookConfiguration.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ValidatingWebhookConfiguration describes the configuration of and admission webhook that accept or reject and object without changing it.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class ValidatingWebhookConfiguration implements Editable<ValidatingWebhookConfigurationBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "admissionregistration.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ValidatingWebhookConfiguration";
     @JsonProperty("metadata")
@@ -109,7 +106,7 @@ public ValidatingWebhookConfiguration(String apiVersion, String kind, ObjectMeta
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -117,7 +114,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -125,7 +122,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -133,29 +130,41 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ValidatingWebhookConfiguration describes the configuration of and admission webhook that accept or reject and object without changing it.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ValidatingWebhookConfiguration describes the configuration of and admission webhook that accept or reject and object without changing it.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Webhooks is a list of webhooks and the affected resources and operations.
+     */
     @JsonProperty("webhooks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ValidatingWebhook> getWebhooks() {
         return webhooks;
     }
 
+    /**
+     * Webhooks is a list of webhooks and the affected resources and operations.
+     */
     @JsonProperty("webhooks")
     public void setWebhooks(List<ValidatingWebhook> webhooks) {
         this.webhooks = webhooks;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingWebhookConfigurationList.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingWebhookConfigurationList.java
index 63b644391b5..770dd8db0a0 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingWebhookConfigurationList.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/ValidatingWebhookConfigurationList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ValidatingWebhookConfigurationList is a list of ValidatingWebhookConfiguration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ValidatingWebhookConfigurationList implements Editable<ValidatingWebhookConfigurationListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.admissionregistration.v1.ValidatingWebhookConfiguration>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "admissionregistration.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.admissionregistration.v1.ValidatingWebhookConfiguration> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ValidatingWebhookConfigurationList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ValidatingWebhookConfigurationList(String apiVersion, List<io.fabric8.kub
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of ValidatingWebhookConfiguration.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.admissionregistration.v1.ValidatingWebhookConfiguration> getItems() {
         return items;
     }
 
+    /**
+     * List of ValidatingWebhookConfiguration.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.admissionregistration.v1.ValidatingWebhookConfiguration> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ValidatingWebhookConfigurationList is a list of ValidatingWebhookConfiguration.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ValidatingWebhookConfigurationList is a list of ValidatingWebhookConfiguration.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/Validation.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/Validation.java
index a2ae4902195..366c745f197 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/Validation.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/Validation.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Validation specifies the CEL expression which is used to apply the validation.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public Validation(String expression, String message, String messageExpression, S
         this.reason = reason;
     }
 
+    /**
+     * Expression represents the expression which will be evaluated by CEL. ref: https://github.com/google/cel-spec CEL expressions have access to the contents of the API request/response, organized into CEL variables as well as some other useful variables:<br><p> <br><p> - 'object' - The object from the incoming request. The value is null for DELETE requests. - 'oldObject' - The existing object. The value is null for CREATE requests. - 'request' - Attributes of the API request([ref](/pkg/apis/admission/types.go#AdmissionRequest)). - 'params' - Parameter resource referred to by the policy binding being evaluated. Only populated if the policy has a ParamKind. - 'namespaceObject' - The namespace object that the incoming object belongs to. The value is null for cluster-scoped resources. - 'variables' - Map of composited variables, from its name to its lazily evaluated value.<br><p>   For example, a variable named 'foo' can be accessed as 'variables.foo'.<br><p> - 'authorizer' - A CEL Authorizer. May be used to perform authorization checks for the principal (user or service account) of the request.<br><p>   See https://pkg.go.dev/k8s.io/apiserver/pkg/cel/library#Authz<br><p> - 'authorizer.requestResource' - A CEL ResourceCheck constructed from the 'authorizer' and configured with the<br><p>   request resource.<br><p> <br><p> The `apiVersion`, `kind`, `metadata.name` and `metadata.generateName` are always accessible from the root of the object. No other metadata properties are accessible.<br><p> <br><p> Only property names of the form `[a-zA-Z_.-/][a-zA-Z0-9_.-/]&#42;` are accessible. Accessible property names are escaped according to the following rules when accessed in the expression: - '__' escapes to '__underscores__' - '.' escapes to '__dot__' - '-' escapes to '__dash__' - '/' escapes to '__slash__' - Property names that exactly match a CEL RESERVED keyword escape to '__{keyword}__'. The keywords are:<br><p> 	  "true", "false", "null", "in", "as", "break", "const", "continue", "else", "for", "function", "if",<br><p> 	  "import", "let", "loop", "package", "namespace", "return".<br><p> Examples:<br><p>   - Expression accessing a property named "namespace": {"Expression": "object.__namespace__ &gt; 0"}<br><p>   - Expression accessing a property named "x-prop": {"Expression": "object.x__dash__prop &gt; 0"}<br><p>   - Expression accessing a property named "redact__d": {"Expression": "object.redact__underscores__d &gt; 0"}<br><p> <br><p> Equality on arrays with list type of 'set' or 'map' ignores element order, i.e. [1, 2] == [2, 1]. Concatenation on arrays with x-kubernetes-list-type use the semantics of the list type:<br><p>   - 'set': `X + Y` performs a union where the array positions of all elements in `X` are preserved and<br><p>     non-intersecting elements in `Y` are appended, retaining their partial order.<br><p>   - 'map': `X + Y` performs a merge where the array positions of all keys in `X` are preserved but the values<br><p>     are overwritten by values in `Y` when the key sets of `X` and `Y` intersect. Elements in `Y` with<br><p>     non-intersecting keys are appended, retaining their partial order.<br><p> Required.
+     */
     @JsonProperty("expression")
     public String getExpression() {
         return expression;
     }
 
+    /**
+     * Expression represents the expression which will be evaluated by CEL. ref: https://github.com/google/cel-spec CEL expressions have access to the contents of the API request/response, organized into CEL variables as well as some other useful variables:<br><p> <br><p> - 'object' - The object from the incoming request. The value is null for DELETE requests. - 'oldObject' - The existing object. The value is null for CREATE requests. - 'request' - Attributes of the API request([ref](/pkg/apis/admission/types.go#AdmissionRequest)). - 'params' - Parameter resource referred to by the policy binding being evaluated. Only populated if the policy has a ParamKind. - 'namespaceObject' - The namespace object that the incoming object belongs to. The value is null for cluster-scoped resources. - 'variables' - Map of composited variables, from its name to its lazily evaluated value.<br><p>   For example, a variable named 'foo' can be accessed as 'variables.foo'.<br><p> - 'authorizer' - A CEL Authorizer. May be used to perform authorization checks for the principal (user or service account) of the request.<br><p>   See https://pkg.go.dev/k8s.io/apiserver/pkg/cel/library#Authz<br><p> - 'authorizer.requestResource' - A CEL ResourceCheck constructed from the 'authorizer' and configured with the<br><p>   request resource.<br><p> <br><p> The `apiVersion`, `kind`, `metadata.name` and `metadata.generateName` are always accessible from the root of the object. No other metadata properties are accessible.<br><p> <br><p> Only property names of the form `[a-zA-Z_.-/][a-zA-Z0-9_.-/]&#42;` are accessible. Accessible property names are escaped according to the following rules when accessed in the expression: - '__' escapes to '__underscores__' - '.' escapes to '__dot__' - '-' escapes to '__dash__' - '/' escapes to '__slash__' - Property names that exactly match a CEL RESERVED keyword escape to '__{keyword}__'. The keywords are:<br><p> 	  "true", "false", "null", "in", "as", "break", "const", "continue", "else", "for", "function", "if",<br><p> 	  "import", "let", "loop", "package", "namespace", "return".<br><p> Examples:<br><p>   - Expression accessing a property named "namespace": {"Expression": "object.__namespace__ &gt; 0"}<br><p>   - Expression accessing a property named "x-prop": {"Expression": "object.x__dash__prop &gt; 0"}<br><p>   - Expression accessing a property named "redact__d": {"Expression": "object.redact__underscores__d &gt; 0"}<br><p> <br><p> Equality on arrays with list type of 'set' or 'map' ignores element order, i.e. [1, 2] == [2, 1]. Concatenation on arrays with x-kubernetes-list-type use the semantics of the list type:<br><p>   - 'set': `X + Y` performs a union where the array positions of all elements in `X` are preserved and<br><p>     non-intersecting elements in `Y` are appended, retaining their partial order.<br><p>   - 'map': `X + Y` performs a merge where the array positions of all keys in `X` are preserved but the values<br><p>     are overwritten by values in `Y` when the key sets of `X` and `Y` intersect. Elements in `Y` with<br><p>     non-intersecting keys are appended, retaining their partial order.<br><p> Required.
+     */
     @JsonProperty("expression")
     public void setExpression(String expression) {
         this.expression = expression;
     }
 
+    /**
+     * Message represents the message displayed when validation fails. The message is required if the Expression contains line breaks. The message must not contain line breaks. If unset, the message is "failed rule: {Rule}". e.g. "must be a URL with the host matching spec.host" If the Expression contains line breaks. Message is required. The message must not contain line breaks. If unset, the message is "failed Expression: {Expression}".
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message represents the message displayed when validation fails. The message is required if the Expression contains line breaks. The message must not contain line breaks. If unset, the message is "failed rule: {Rule}". e.g. "must be a URL with the host matching spec.host" If the Expression contains line breaks. Message is required. The message must not contain line breaks. If unset, the message is "failed Expression: {Expression}".
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * messageExpression declares a CEL expression that evaluates to the validation failure message that is returned when this rule fails. Since messageExpression is used as a failure message, it must evaluate to a string. If both message and messageExpression are present on a validation, then messageExpression will be used if validation fails. If messageExpression results in a runtime error, the runtime error is logged, and the validation failure message is produced as if the messageExpression field were unset. If messageExpression evaluates to an empty string, a string with only spaces, or a string that contains line breaks, then the validation failure message will also be produced as if the messageExpression field were unset, and the fact that messageExpression produced an empty string/string with only spaces/string with line breaks will be logged. messageExpression has access to all the same variables as the `expression` except for 'authorizer' and 'authorizer.requestResource'. Example: "object.x must be less than max ("+string(params.max)+")"
+     */
     @JsonProperty("messageExpression")
     public String getMessageExpression() {
         return messageExpression;
     }
 
+    /**
+     * messageExpression declares a CEL expression that evaluates to the validation failure message that is returned when this rule fails. Since messageExpression is used as a failure message, it must evaluate to a string. If both message and messageExpression are present on a validation, then messageExpression will be used if validation fails. If messageExpression results in a runtime error, the runtime error is logged, and the validation failure message is produced as if the messageExpression field were unset. If messageExpression evaluates to an empty string, a string with only spaces, or a string that contains line breaks, then the validation failure message will also be produced as if the messageExpression field were unset, and the fact that messageExpression produced an empty string/string with only spaces/string with line breaks will be logged. messageExpression has access to all the same variables as the `expression` except for 'authorizer' and 'authorizer.requestResource'. Example: "object.x must be less than max ("+string(params.max)+")"
+     */
     @JsonProperty("messageExpression")
     public void setMessageExpression(String messageExpression) {
         this.messageExpression = messageExpression;
     }
 
+    /**
+     * Reason represents a machine-readable description of why this validation failed. If this is the first validation in the list to fail, this reason, as well as the corresponding HTTP response code, are used in the HTTP response to the client. The currently supported reasons are: "Unauthorized", "Forbidden", "Invalid", "RequestEntityTooLarge". If not set, StatusReasonInvalid is used in the response to the client.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason represents a machine-readable description of why this validation failed. If this is the first validation in the list to fail, this reason, as well as the corresponding HTTP response code, are used in the HTTP response to the client. The currently supported reasons are: "Unauthorized", "Forbidden", "Invalid", "RequestEntityTooLarge". If not set, StatusReasonInvalid is used in the response to the client.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/Variable.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/Variable.java
index 57db8cc0c7f..f3f48466899 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/Variable.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/Variable.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Variable is the definition of a variable that is used for composition. A variable is defined as a named expression.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Variable(String expression, String name) {
         this.name = name;
     }
 
+    /**
+     * Expression is the expression that will be evaluated as the value of the variable. The CEL expression has access to the same identifiers as the CEL expressions in Validation.
+     */
     @JsonProperty("expression")
     public String getExpression() {
         return expression;
     }
 
+    /**
+     * Expression is the expression that will be evaluated as the value of the variable. The CEL expression has access to the same identifiers as the CEL expressions in Validation.
+     */
     @JsonProperty("expression")
     public void setExpression(String expression) {
         this.expression = expression;
     }
 
+    /**
+     * Name is the name of the variable. The name must be a valid CEL identifier and unique among all variables. The variable can be accessed in other expressions through `variables` For example, if name is "foo", the variable will be available as `variables.foo`
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the variable. The name must be a valid CEL identifier and unique among all variables. The variable can be accessed in other expressions through `variables` For example, if name is "foo", the variable will be available as `variables.foo`
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/WebhookClientConfig.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/WebhookClientConfig.java
index 916391c22f9..bb2e162628b 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/WebhookClientConfig.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1/WebhookClientConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WebhookClientConfig contains the information to make a TLS connection with the webhook
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public WebhookClientConfig(String caBundle, ServiceReference service, String url
         this.url = url;
     }
 
+    /**
+     * `caBundle` is a PEM encoded CA bundle which will be used to validate the webhook's server certificate. If unspecified, system trust roots on the apiserver are used.
+     */
     @JsonProperty("caBundle")
     public String getCaBundle() {
         return caBundle;
     }
 
+    /**
+     * `caBundle` is a PEM encoded CA bundle which will be used to validate the webhook's server certificate. If unspecified, system trust roots on the apiserver are used.
+     */
     @JsonProperty("caBundle")
     public void setCaBundle(String caBundle) {
         this.caBundle = caBundle;
     }
 
+    /**
+     * WebhookClientConfig contains the information to make a TLS connection with the webhook
+     */
     @JsonProperty("service")
     public ServiceReference getService() {
         return service;
     }
 
+    /**
+     * WebhookClientConfig contains the information to make a TLS connection with the webhook
+     */
     @JsonProperty("service")
     public void setService(ServiceReference service) {
         this.service = service;
     }
 
+    /**
+     * `url` gives the location of the webhook, in standard URL form (`scheme://host:port/path`). Exactly one of `url` or `service` must be specified.<br><p> <br><p> The `host` should not refer to a service running in the cluster; use the `service` field instead. The host might be resolved via external DNS in some apiservers (e.g., `kube-apiserver` cannot resolve in-cluster DNS as that would be a layering violation). `host` may also be an IP address.<br><p> <br><p> Please note that using `localhost` or `127.0.0.1` as a `host` is risky unless you take great care to run this webhook on all hosts which run an apiserver which might need to make calls to this webhook. Such installs are likely to be non-portable, i.e., not easy to turn up in a new cluster.<br><p> <br><p> The scheme must be "https"; the URL must begin with "https://".<br><p> <br><p> A path is optional, and if present may be any string permissible in a URL. You may use the path to pass an arbitrary string to the webhook, for example, a cluster identifier.<br><p> <br><p> Attempting to use a user or basic auth e.g. "user:password@" is not allowed. Fragments ("#...") and query parameters ("?...") are not allowed, either.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * `url` gives the location of the webhook, in standard URL form (`scheme://host:port/path`). Exactly one of `url` or `service` must be specified.<br><p> <br><p> The `host` should not refer to a service running in the cluster; use the `service` field instead. The host might be resolved via external DNS in some apiservers (e.g., `kube-apiserver` cannot resolve in-cluster DNS as that would be a layering violation). `host` may also be an IP address.<br><p> <br><p> Please note that using `localhost` or `127.0.0.1` as a `host` is risky unless you take great care to run this webhook on all hosts which run an apiserver which might need to make calls to this webhook. Such installs are likely to be non-portable, i.e., not easy to turn up in a new cluster.<br><p> <br><p> The scheme must be "https"; the URL must begin with "https://".<br><p> <br><p> A path is optional, and if present may be any string permissible in a URL. You may use the path to pass an arbitrary string to the webhook, for example, a cluster identifier.<br><p> <br><p> Attempting to use a user or basic auth e.g. "user:password@" is not allowed. Fragments ("#...") and query parameters ("?...") are not allowed, either.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/ApplyConfiguration.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/ApplyConfiguration.java
index bcdc94f60a8..5a5f58c60da 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/ApplyConfiguration.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/ApplyConfiguration.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ApplyConfiguration defines the desired configuration values of an object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ApplyConfiguration(String expression) {
         this.expression = expression;
     }
 
+    /**
+     * expression will be evaluated by CEL to create an apply configuration. ref: https://github.com/google/cel-spec<br><p> <br><p> Apply configurations are declared in CEL using object initialization. For example, this CEL expression returns an apply configuration to set a single field:<br><p> <br><p> 	Object{<br><p> 	  spec: Object.spec{<br><p> 	    serviceAccountName: "example"<br><p> 	  }<br><p> 	}<br><p> <br><p> Apply configurations may not modify atomic structs, maps or arrays due to the risk of accidental deletion of values not included in the apply configuration.<br><p> <br><p> CEL expressions have access to the object types needed to create apply configurations:<br><p> <br><p> - 'Object' - CEL type of the resource object. - 'Object.&lt;fieldName&gt;' - CEL type of object field (such as 'Object.spec') - 'Object.&lt;fieldName1&gt;.&lt;fieldName2&gt;...&lt;fieldNameN&gt;` - CEL type of nested field (such as 'Object.spec.containers')<br><p> <br><p> CEL expressions have access to the contents of the API request, organized into CEL variables as well as some other useful variables:<br><p> <br><p> - 'object' - The object from the incoming request. The value is null for DELETE requests. - 'oldObject' - The existing object. The value is null for CREATE requests. - 'request' - Attributes of the API request([ref](/pkg/apis/admission/types.go#AdmissionRequest)). - 'params' - Parameter resource referred to by the policy binding being evaluated. Only populated if the policy has a ParamKind. - 'namespaceObject' - The namespace object that the incoming object belongs to. The value is null for cluster-scoped resources. - 'variables' - Map of composited variables, from its name to its lazily evaluated value.<br><p>   For example, a variable named 'foo' can be accessed as 'variables.foo'.<br><p> - 'authorizer' - A CEL Authorizer. May be used to perform authorization checks for the principal (user or service account) of the request.<br><p>   See https://pkg.go.dev/k8s.io/apiserver/pkg/cel/library#Authz<br><p> - 'authorizer.requestResource' - A CEL ResourceCheck constructed from the 'authorizer' and configured with the<br><p>   request resource.<br><p> <br><p> The `apiVersion`, `kind`, `metadata.name` and `metadata.generateName` are always accessible from the root of the object. No other metadata properties are accessible.<br><p> <br><p> Only property names of the form `[a-zA-Z_.-/][a-zA-Z0-9_.-/]&#42;` are accessible. Required.
+     */
     @JsonProperty("expression")
     public String getExpression() {
         return expression;
     }
 
+    /**
+     * expression will be evaluated by CEL to create an apply configuration. ref: https://github.com/google/cel-spec<br><p> <br><p> Apply configurations are declared in CEL using object initialization. For example, this CEL expression returns an apply configuration to set a single field:<br><p> <br><p> 	Object{<br><p> 	  spec: Object.spec{<br><p> 	    serviceAccountName: "example"<br><p> 	  }<br><p> 	}<br><p> <br><p> Apply configurations may not modify atomic structs, maps or arrays due to the risk of accidental deletion of values not included in the apply configuration.<br><p> <br><p> CEL expressions have access to the object types needed to create apply configurations:<br><p> <br><p> - 'Object' - CEL type of the resource object. - 'Object.&lt;fieldName&gt;' - CEL type of object field (such as 'Object.spec') - 'Object.&lt;fieldName1&gt;.&lt;fieldName2&gt;...&lt;fieldNameN&gt;` - CEL type of nested field (such as 'Object.spec.containers')<br><p> <br><p> CEL expressions have access to the contents of the API request, organized into CEL variables as well as some other useful variables:<br><p> <br><p> - 'object' - The object from the incoming request. The value is null for DELETE requests. - 'oldObject' - The existing object. The value is null for CREATE requests. - 'request' - Attributes of the API request([ref](/pkg/apis/admission/types.go#AdmissionRequest)). - 'params' - Parameter resource referred to by the policy binding being evaluated. Only populated if the policy has a ParamKind. - 'namespaceObject' - The namespace object that the incoming object belongs to. The value is null for cluster-scoped resources. - 'variables' - Map of composited variables, from its name to its lazily evaluated value.<br><p>   For example, a variable named 'foo' can be accessed as 'variables.foo'.<br><p> - 'authorizer' - A CEL Authorizer. May be used to perform authorization checks for the principal (user or service account) of the request.<br><p>   See https://pkg.go.dev/k8s.io/apiserver/pkg/cel/library#Authz<br><p> - 'authorizer.requestResource' - A CEL ResourceCheck constructed from the 'authorizer' and configured with the<br><p>   request resource.<br><p> <br><p> The `apiVersion`, `kind`, `metadata.name` and `metadata.generateName` are always accessible from the root of the object. No other metadata properties are accessible.<br><p> <br><p> Only property names of the form `[a-zA-Z_.-/][a-zA-Z0-9_.-/]&#42;` are accessible. Required.
+     */
     @JsonProperty("expression")
     public void setExpression(String expression) {
         this.expression = expression;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/JSONPatch.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/JSONPatch.java
index 84d9dd4bc1c..b56cc56f9f6 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/JSONPatch.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/JSONPatch.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JSONPatch defines a JSON Patch.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public JSONPatch(String expression) {
         this.expression = expression;
     }
 
+    /**
+     * expression will be evaluated by CEL to create a [JSON patch](https://jsonpatch.com/). ref: https://github.com/google/cel-spec<br><p> <br><p> expression must return an array of JSONPatch values.<br><p> <br><p> For example, this CEL expression returns a JSON patch to conditionally modify a value:<br><p> <br><p> 	  [<br><p> 	    JSONPatch{op: "test", path: "/spec/example", value: "Red"},<br><p> 	    JSONPatch{op: "replace", path: "/spec/example", value: "Green"}<br><p> 	  ]<br><p> <br><p> To define an object for the patch value, use Object types. For example:<br><p> <br><p> 	  [<br><p> 	    JSONPatch{<br><p> 	      op: "add",<br><p> 	      path: "/spec/selector",<br><p> 	      value: Object.spec.selector{matchLabels: {"environment": "test"}}<br><p> 	    }<br><p> 	  ]<br><p> <br><p> To use strings containing '/' and '~' as JSONPatch path keys, use "jsonpatch.escapeKey". For example:<br><p> <br><p> 	  [<br><p> 	    JSONPatch{<br><p> 	      op: "add",<br><p> 	      path: "/metadata/labels/" + jsonpatch.escapeKey("example.com/environment"),<br><p> 	      value: "test"<br><p> 	    },<br><p> 	  ]<br><p> <br><p> CEL expressions have access to the types needed to create JSON patches and objects:<br><p> <br><p> - 'JSONPatch' - CEL type of JSON Patch operations. JSONPatch has the fields 'op', 'from', 'path' and 'value'.<br><p>   See [JSON patch](https://jsonpatch.com/) for more details. The 'value' field may be set to any of: string,<br><p>   integer, array, map or object.  If set, the 'path' and 'from' fields must be set to a<br><p>   [JSON pointer](https://datatracker.ietf.org/doc/html/rfc6901/) string, where the 'jsonpatch.escapeKey()' CEL<br><p>   function may be used to escape path keys containing '/' and '~'.<br><p> - 'Object' - CEL type of the resource object. - 'Object.&lt;fieldName&gt;' - CEL type of object field (such as 'Object.spec') - 'Object.&lt;fieldName1&gt;.&lt;fieldName2&gt;...&lt;fieldNameN&gt;` - CEL type of nested field (such as 'Object.spec.containers')<br><p> <br><p> CEL expressions have access to the contents of the API request, organized into CEL variables as well as some other useful variables:<br><p> <br><p> - 'object' - The object from the incoming request. The value is null for DELETE requests. - 'oldObject' - The existing object. The value is null for CREATE requests. - 'request' - Attributes of the API request([ref](/pkg/apis/admission/types.go#AdmissionRequest)). - 'params' - Parameter resource referred to by the policy binding being evaluated. Only populated if the policy has a ParamKind. - 'namespaceObject' - The namespace object that the incoming object belongs to. The value is null for cluster-scoped resources. - 'variables' - Map of composited variables, from its name to its lazily evaluated value.<br><p>   For example, a variable named 'foo' can be accessed as 'variables.foo'.<br><p> - 'authorizer' - A CEL Authorizer. May be used to perform authorization checks for the principal (user or service account) of the request.<br><p>   See https://pkg.go.dev/k8s.io/apiserver/pkg/cel/library#Authz<br><p> - 'authorizer.requestResource' - A CEL ResourceCheck constructed from the 'authorizer' and configured with the<br><p>   request resource.<br><p> <br><p> CEL expressions have access to [Kubernetes CEL function libraries](https://kubernetes.io/docs/reference/using-api/cel/#cel-options-language-features-and-libraries) as well as:<br><p> <br><p> - 'jsonpatch.escapeKey' - Performs JSONPatch key escaping. '~' and  '/' are escaped as '~0' and `~1' respectively).<br><p> <br><p> Only property names of the form `[a-zA-Z_.-/][a-zA-Z0-9_.-/]&#42;` are accessible. Required.
+     */
     @JsonProperty("expression")
     public String getExpression() {
         return expression;
     }
 
+    /**
+     * expression will be evaluated by CEL to create a [JSON patch](https://jsonpatch.com/). ref: https://github.com/google/cel-spec<br><p> <br><p> expression must return an array of JSONPatch values.<br><p> <br><p> For example, this CEL expression returns a JSON patch to conditionally modify a value:<br><p> <br><p> 	  [<br><p> 	    JSONPatch{op: "test", path: "/spec/example", value: "Red"},<br><p> 	    JSONPatch{op: "replace", path: "/spec/example", value: "Green"}<br><p> 	  ]<br><p> <br><p> To define an object for the patch value, use Object types. For example:<br><p> <br><p> 	  [<br><p> 	    JSONPatch{<br><p> 	      op: "add",<br><p> 	      path: "/spec/selector",<br><p> 	      value: Object.spec.selector{matchLabels: {"environment": "test"}}<br><p> 	    }<br><p> 	  ]<br><p> <br><p> To use strings containing '/' and '~' as JSONPatch path keys, use "jsonpatch.escapeKey". For example:<br><p> <br><p> 	  [<br><p> 	    JSONPatch{<br><p> 	      op: "add",<br><p> 	      path: "/metadata/labels/" + jsonpatch.escapeKey("example.com/environment"),<br><p> 	      value: "test"<br><p> 	    },<br><p> 	  ]<br><p> <br><p> CEL expressions have access to the types needed to create JSON patches and objects:<br><p> <br><p> - 'JSONPatch' - CEL type of JSON Patch operations. JSONPatch has the fields 'op', 'from', 'path' and 'value'.<br><p>   See [JSON patch](https://jsonpatch.com/) for more details. The 'value' field may be set to any of: string,<br><p>   integer, array, map or object.  If set, the 'path' and 'from' fields must be set to a<br><p>   [JSON pointer](https://datatracker.ietf.org/doc/html/rfc6901/) string, where the 'jsonpatch.escapeKey()' CEL<br><p>   function may be used to escape path keys containing '/' and '~'.<br><p> - 'Object' - CEL type of the resource object. - 'Object.&lt;fieldName&gt;' - CEL type of object field (such as 'Object.spec') - 'Object.&lt;fieldName1&gt;.&lt;fieldName2&gt;...&lt;fieldNameN&gt;` - CEL type of nested field (such as 'Object.spec.containers')<br><p> <br><p> CEL expressions have access to the contents of the API request, organized into CEL variables as well as some other useful variables:<br><p> <br><p> - 'object' - The object from the incoming request. The value is null for DELETE requests. - 'oldObject' - The existing object. The value is null for CREATE requests. - 'request' - Attributes of the API request([ref](/pkg/apis/admission/types.go#AdmissionRequest)). - 'params' - Parameter resource referred to by the policy binding being evaluated. Only populated if the policy has a ParamKind. - 'namespaceObject' - The namespace object that the incoming object belongs to. The value is null for cluster-scoped resources. - 'variables' - Map of composited variables, from its name to its lazily evaluated value.<br><p>   For example, a variable named 'foo' can be accessed as 'variables.foo'.<br><p> - 'authorizer' - A CEL Authorizer. May be used to perform authorization checks for the principal (user or service account) of the request.<br><p>   See https://pkg.go.dev/k8s.io/apiserver/pkg/cel/library#Authz<br><p> - 'authorizer.requestResource' - A CEL ResourceCheck constructed from the 'authorizer' and configured with the<br><p>   request resource.<br><p> <br><p> CEL expressions have access to [Kubernetes CEL function libraries](https://kubernetes.io/docs/reference/using-api/cel/#cel-options-language-features-and-libraries) as well as:<br><p> <br><p> - 'jsonpatch.escapeKey' - Performs JSONPatch key escaping. '~' and  '/' are escaped as '~0' and `~1' respectively).<br><p> <br><p> Only property names of the form `[a-zA-Z_.-/][a-zA-Z0-9_.-/]&#42;` are accessible. Required.
+     */
     @JsonProperty("expression")
     public void setExpression(String expression) {
         this.expression = expression;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MatchCondition.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MatchCondition.java
index 1cad99d8b46..b33171e088d 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MatchCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MatchCondition.java
@@ -82,21 +82,33 @@ public MatchCondition(String expression, String name) {
         this.name = name;
     }
 
+    /**
+     * Expression represents the expression which will be evaluated by CEL. Must evaluate to bool. CEL expressions have access to the contents of the AdmissionRequest and Authorizer, organized into CEL variables:<br><p> <br><p> 'object' - The object from the incoming request. The value is null for DELETE requests. 'oldObject' - The existing object. The value is null for CREATE requests. 'request' - Attributes of the admission request(/pkg/apis/admission/types.go#AdmissionRequest). 'authorizer' - A CEL Authorizer. May be used to perform authorization checks for the principal (user or service account) of the request.<br><p>   See https://pkg.go.dev/k8s.io/apiserver/pkg/cel/library#Authz<br><p> 'authorizer.requestResource' - A CEL ResourceCheck constructed from the 'authorizer' and configured with the<br><p>   request resource.<br><p> Documentation on CEL: https://kubernetes.io/docs/reference/using-api/cel/<br><p> <br><p> Required.
+     */
     @JsonProperty("expression")
     public String getExpression() {
         return expression;
     }
 
+    /**
+     * Expression represents the expression which will be evaluated by CEL. Must evaluate to bool. CEL expressions have access to the contents of the AdmissionRequest and Authorizer, organized into CEL variables:<br><p> <br><p> 'object' - The object from the incoming request. The value is null for DELETE requests. 'oldObject' - The existing object. The value is null for CREATE requests. 'request' - Attributes of the admission request(/pkg/apis/admission/types.go#AdmissionRequest). 'authorizer' - A CEL Authorizer. May be used to perform authorization checks for the principal (user or service account) of the request.<br><p>   See https://pkg.go.dev/k8s.io/apiserver/pkg/cel/library#Authz<br><p> 'authorizer.requestResource' - A CEL ResourceCheck constructed from the 'authorizer' and configured with the<br><p>   request resource.<br><p> Documentation on CEL: https://kubernetes.io/docs/reference/using-api/cel/<br><p> <br><p> Required.
+     */
     @JsonProperty("expression")
     public void setExpression(String expression) {
         this.expression = expression;
     }
 
+    /**
+     * Name is an identifier for this match condition, used for strategic merging of MatchConditions, as well as providing an identifier for logging purposes. A good name should be descriptive of the associated expression. Name must be a qualified name consisting of alphanumeric characters, '-', '_' or '.', and must start and end with an alphanumeric character (e.g. 'MyName',  or 'my.name',  or '123-abc', regex used for validation is '([A-Za-z0-9][-A-Za-z0-9_.]&#42;)?[A-Za-z0-9]') with an optional DNS subdomain prefix and '/' (e.g. 'example.com/MyName')<br><p> <br><p> Required.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is an identifier for this match condition, used for strategic merging of MatchConditions, as well as providing an identifier for logging purposes. A good name should be descriptive of the associated expression. Name must be a qualified name consisting of alphanumeric characters, '-', '_' or '.', and must start and end with an alphanumeric character (e.g. 'MyName',  or 'my.name',  or '123-abc', regex used for validation is '([A-Za-z0-9][-A-Za-z0-9_.]&#42;)?[A-Za-z0-9]') with an optional DNS subdomain prefix and '/' (e.g. 'example.com/MyName')<br><p> <br><p> Required.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MatchResources.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MatchResources.java
index 6fc4262bec3..a89e53dbd05 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MatchResources.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MatchResources.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MatchResources decides whether to run the admission control policy on an object based on whether it meets the match criteria. The exclude rules take precedence over include rules (if a resource matches both, it is excluded)
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,53 +101,83 @@ public MatchResources(List<NamedRuleWithOperations> excludeResourceRules, String
         this.resourceRules = resourceRules;
     }
 
+    /**
+     * ExcludeResourceRules describes what operations on what resources/subresources the ValidatingAdmissionPolicy should not care about. The exclude rules take precedence over include rules (if a resource matches both, it is excluded)
+     */
     @JsonProperty("excludeResourceRules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NamedRuleWithOperations> getExcludeResourceRules() {
         return excludeResourceRules;
     }
 
+    /**
+     * ExcludeResourceRules describes what operations on what resources/subresources the ValidatingAdmissionPolicy should not care about. The exclude rules take precedence over include rules (if a resource matches both, it is excluded)
+     */
     @JsonProperty("excludeResourceRules")
     public void setExcludeResourceRules(List<NamedRuleWithOperations> excludeResourceRules) {
         this.excludeResourceRules = excludeResourceRules;
     }
 
+    /**
+     * matchPolicy defines how the "MatchResources" list is used to match incoming requests. Allowed values are "Exact" or "Equivalent".<br><p> <br><p> - Exact: match a request only if it exactly matches a specified rule. For example, if deployments can be modified via apps/v1, apps/v1beta1, and extensions/v1beta1, but "rules" only included `apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]`, a request to apps/v1beta1 or extensions/v1beta1 would not be sent to the ValidatingAdmissionPolicy.<br><p> <br><p> - Equivalent: match a request if modifies a resource listed in rules, even via another API group or version. For example, if deployments can be modified via apps/v1, apps/v1beta1, and extensions/v1beta1, and "rules" only included `apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]`, a request to apps/v1beta1 or extensions/v1beta1 would be converted to apps/v1 and sent to the ValidatingAdmissionPolicy.<br><p> <br><p> Defaults to "Equivalent"
+     */
     @JsonProperty("matchPolicy")
     public String getMatchPolicy() {
         return matchPolicy;
     }
 
+    /**
+     * matchPolicy defines how the "MatchResources" list is used to match incoming requests. Allowed values are "Exact" or "Equivalent".<br><p> <br><p> - Exact: match a request only if it exactly matches a specified rule. For example, if deployments can be modified via apps/v1, apps/v1beta1, and extensions/v1beta1, but "rules" only included `apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]`, a request to apps/v1beta1 or extensions/v1beta1 would not be sent to the ValidatingAdmissionPolicy.<br><p> <br><p> - Equivalent: match a request if modifies a resource listed in rules, even via another API group or version. For example, if deployments can be modified via apps/v1, apps/v1beta1, and extensions/v1beta1, and "rules" only included `apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]`, a request to apps/v1beta1 or extensions/v1beta1 would be converted to apps/v1 and sent to the ValidatingAdmissionPolicy.<br><p> <br><p> Defaults to "Equivalent"
+     */
     @JsonProperty("matchPolicy")
     public void setMatchPolicy(String matchPolicy) {
         this.matchPolicy = matchPolicy;
     }
 
+    /**
+     * MatchResources decides whether to run the admission control policy on an object based on whether it meets the match criteria. The exclude rules take precedence over include rules (if a resource matches both, it is excluded)
+     */
     @JsonProperty("namespaceSelector")
     public LabelSelector getNamespaceSelector() {
         return namespaceSelector;
     }
 
+    /**
+     * MatchResources decides whether to run the admission control policy on an object based on whether it meets the match criteria. The exclude rules take precedence over include rules (if a resource matches both, it is excluded)
+     */
     @JsonProperty("namespaceSelector")
     public void setNamespaceSelector(LabelSelector namespaceSelector) {
         this.namespaceSelector = namespaceSelector;
     }
 
+    /**
+     * MatchResources decides whether to run the admission control policy on an object based on whether it meets the match criteria. The exclude rules take precedence over include rules (if a resource matches both, it is excluded)
+     */
     @JsonProperty("objectSelector")
     public LabelSelector getObjectSelector() {
         return objectSelector;
     }
 
+    /**
+     * MatchResources decides whether to run the admission control policy on an object based on whether it meets the match criteria. The exclude rules take precedence over include rules (if a resource matches both, it is excluded)
+     */
     @JsonProperty("objectSelector")
     public void setObjectSelector(LabelSelector objectSelector) {
         this.objectSelector = objectSelector;
     }
 
+    /**
+     * ResourceRules describes what operations on what resources/subresources the ValidatingAdmissionPolicy matches. The policy cares about an operation if it matches _any_ Rule.
+     */
     @JsonProperty("resourceRules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NamedRuleWithOperations> getResourceRules() {
         return resourceRules;
     }
 
+    /**
+     * ResourceRules describes what operations on what resources/subresources the ValidatingAdmissionPolicy matches. The policy cares about an operation if it matches _any_ Rule.
+     */
     @JsonProperty("resourceRules")
     public void setResourceRules(List<NamedRuleWithOperations> resourceRules) {
         this.resourceRules = resourceRules;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MutatingAdmissionPolicy.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MutatingAdmissionPolicy.java
index d47f926db9f..393026b810c 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MutatingAdmissionPolicy.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MutatingAdmissionPolicy.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MutatingAdmissionPolicy describes the definition of an admission mutation policy that mutates the object coming into admission chain.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class MutatingAdmissionPolicy implements Editable<MutatingAdmissionPolicyBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "admissionregistration.k8s.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MutatingAdmissionPolicy";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public MutatingAdmissionPolicy(String apiVersion, String kind, ObjectMeta metada
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MutatingAdmissionPolicy describes the definition of an admission mutation policy that mutates the object coming into admission chain.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MutatingAdmissionPolicy describes the definition of an admission mutation policy that mutates the object coming into admission chain.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * MutatingAdmissionPolicy describes the definition of an admission mutation policy that mutates the object coming into admission chain.
+     */
     @JsonProperty("spec")
     public MutatingAdmissionPolicySpec getSpec() {
         return spec;
     }
 
+    /**
+     * MutatingAdmissionPolicy describes the definition of an admission mutation policy that mutates the object coming into admission chain.
+     */
     @JsonProperty("spec")
     public void setSpec(MutatingAdmissionPolicySpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MutatingAdmissionPolicyBinding.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MutatingAdmissionPolicyBinding.java
index 0d2b0e4159e..a518718ffca 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MutatingAdmissionPolicyBinding.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MutatingAdmissionPolicyBinding.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MutatingAdmissionPolicyBinding binds the MutatingAdmissionPolicy with parametrized resources. MutatingAdmissionPolicyBinding and the optional parameter resource together define how cluster administrators configure policies for clusters.<br><p> <br><p> For a given admission request, each binding will cause its policy to be evaluated N times, where N is 1 for policies/bindings that don't use params, otherwise N is the number of parameters selected by the binding. Each evaluation is constrained by a [runtime cost budget](https://kubernetes.io/docs/reference/using-api/cel/#runtime-cost-budget).<br><p> <br><p> Adding/removing policies, bindings, or params can not affect whether a given (policy, binding, param) combination is within its own CEL budget.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class MutatingAdmissionPolicyBinding implements Editable<MutatingAdmissionPolicyBindingBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "admissionregistration.k8s.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MutatingAdmissionPolicyBinding";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public MutatingAdmissionPolicyBinding(String apiVersion, String kind, ObjectMeta
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MutatingAdmissionPolicyBinding binds the MutatingAdmissionPolicy with parametrized resources. MutatingAdmissionPolicyBinding and the optional parameter resource together define how cluster administrators configure policies for clusters.<br><p> <br><p> For a given admission request, each binding will cause its policy to be evaluated N times, where N is 1 for policies/bindings that don't use params, otherwise N is the number of parameters selected by the binding. Each evaluation is constrained by a [runtime cost budget](https://kubernetes.io/docs/reference/using-api/cel/#runtime-cost-budget).<br><p> <br><p> Adding/removing policies, bindings, or params can not affect whether a given (policy, binding, param) combination is within its own CEL budget.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MutatingAdmissionPolicyBinding binds the MutatingAdmissionPolicy with parametrized resources. MutatingAdmissionPolicyBinding and the optional parameter resource together define how cluster administrators configure policies for clusters.<br><p> <br><p> For a given admission request, each binding will cause its policy to be evaluated N times, where N is 1 for policies/bindings that don't use params, otherwise N is the number of parameters selected by the binding. Each evaluation is constrained by a [runtime cost budget](https://kubernetes.io/docs/reference/using-api/cel/#runtime-cost-budget).<br><p> <br><p> Adding/removing policies, bindings, or params can not affect whether a given (policy, binding, param) combination is within its own CEL budget.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * MutatingAdmissionPolicyBinding binds the MutatingAdmissionPolicy with parametrized resources. MutatingAdmissionPolicyBinding and the optional parameter resource together define how cluster administrators configure policies for clusters.<br><p> <br><p> For a given admission request, each binding will cause its policy to be evaluated N times, where N is 1 for policies/bindings that don't use params, otherwise N is the number of parameters selected by the binding. Each evaluation is constrained by a [runtime cost budget](https://kubernetes.io/docs/reference/using-api/cel/#runtime-cost-budget).<br><p> <br><p> Adding/removing policies, bindings, or params can not affect whether a given (policy, binding, param) combination is within its own CEL budget.
+     */
     @JsonProperty("spec")
     public MutatingAdmissionPolicyBindingSpec getSpec() {
         return spec;
     }
 
+    /**
+     * MutatingAdmissionPolicyBinding binds the MutatingAdmissionPolicy with parametrized resources. MutatingAdmissionPolicyBinding and the optional parameter resource together define how cluster administrators configure policies for clusters.<br><p> <br><p> For a given admission request, each binding will cause its policy to be evaluated N times, where N is 1 for policies/bindings that don't use params, otherwise N is the number of parameters selected by the binding. Each evaluation is constrained by a [runtime cost budget](https://kubernetes.io/docs/reference/using-api/cel/#runtime-cost-budget).<br><p> <br><p> Adding/removing policies, bindings, or params can not affect whether a given (policy, binding, param) combination is within its own CEL budget.
+     */
     @JsonProperty("spec")
     public void setSpec(MutatingAdmissionPolicyBindingSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MutatingAdmissionPolicyBindingList.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MutatingAdmissionPolicyBindingList.java
index 148bc70a0e4..f2921992c95 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MutatingAdmissionPolicyBindingList.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MutatingAdmissionPolicyBindingList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MutatingAdmissionPolicyBindingList is a list of MutatingAdmissionPolicyBinding.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class MutatingAdmissionPolicyBindingList implements Editable<MutatingAdmissionPolicyBindingListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.admissionregistration.v1alpha1.MutatingAdmissionPolicyBinding>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "admissionregistration.k8s.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.admissionregistration.v1alpha1.MutatingAdmissionPolicyBinding> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MutatingAdmissionPolicyBindingList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public MutatingAdmissionPolicyBindingList(String apiVersion, List<io.fabric8.kub
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of PolicyBinding.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.admissionregistration.v1alpha1.MutatingAdmissionPolicyBinding> getItems() {
         return items;
     }
 
+    /**
+     * List of PolicyBinding.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.admissionregistration.v1alpha1.MutatingAdmissionPolicyBinding> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MutatingAdmissionPolicyBindingList is a list of MutatingAdmissionPolicyBinding.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MutatingAdmissionPolicyBindingList is a list of MutatingAdmissionPolicyBinding.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MutatingAdmissionPolicyBindingSpec.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MutatingAdmissionPolicyBindingSpec.java
index 38f47dfd4b6..1b8754059cf 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MutatingAdmissionPolicyBindingSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MutatingAdmissionPolicyBindingSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MutatingAdmissionPolicyBindingSpec is the specification of the MutatingAdmissionPolicyBinding.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public MutatingAdmissionPolicyBindingSpec(MatchResources matchResources, ParamRe
         this.policyName = policyName;
     }
 
+    /**
+     * MutatingAdmissionPolicyBindingSpec is the specification of the MutatingAdmissionPolicyBinding.
+     */
     @JsonProperty("matchResources")
     public MatchResources getMatchResources() {
         return matchResources;
     }
 
+    /**
+     * MutatingAdmissionPolicyBindingSpec is the specification of the MutatingAdmissionPolicyBinding.
+     */
     @JsonProperty("matchResources")
     public void setMatchResources(MatchResources matchResources) {
         this.matchResources = matchResources;
     }
 
+    /**
+     * MutatingAdmissionPolicyBindingSpec is the specification of the MutatingAdmissionPolicyBinding.
+     */
     @JsonProperty("paramRef")
     public ParamRef getParamRef() {
         return paramRef;
     }
 
+    /**
+     * MutatingAdmissionPolicyBindingSpec is the specification of the MutatingAdmissionPolicyBinding.
+     */
     @JsonProperty("paramRef")
     public void setParamRef(ParamRef paramRef) {
         this.paramRef = paramRef;
     }
 
+    /**
+     * policyName references a MutatingAdmissionPolicy name which the MutatingAdmissionPolicyBinding binds to. If the referenced resource does not exist, this binding is considered invalid and will be ignored Required.
+     */
     @JsonProperty("policyName")
     public String getPolicyName() {
         return policyName;
     }
 
+    /**
+     * policyName references a MutatingAdmissionPolicy name which the MutatingAdmissionPolicyBinding binds to. If the referenced resource does not exist, this binding is considered invalid and will be ignored Required.
+     */
     @JsonProperty("policyName")
     public void setPolicyName(String policyName) {
         this.policyName = policyName;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MutatingAdmissionPolicyList.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MutatingAdmissionPolicyList.java
index f633bfa2d7c..e9f431e4b6c 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MutatingAdmissionPolicyList.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MutatingAdmissionPolicyList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MutatingAdmissionPolicyList is a list of MutatingAdmissionPolicy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class MutatingAdmissionPolicyList implements Editable<MutatingAdmissionPolicyListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.admissionregistration.v1alpha1.MutatingAdmissionPolicy>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "admissionregistration.k8s.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.admissionregistration.v1alpha1.MutatingAdmissionPolicy> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MutatingAdmissionPolicyList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public MutatingAdmissionPolicyList(String apiVersion, List<io.fabric8.kubernetes
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of ValidatingAdmissionPolicy.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.admissionregistration.v1alpha1.MutatingAdmissionPolicy> getItems() {
         return items;
     }
 
+    /**
+     * List of ValidatingAdmissionPolicy.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.admissionregistration.v1alpha1.MutatingAdmissionPolicy> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MutatingAdmissionPolicyList is a list of MutatingAdmissionPolicy.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MutatingAdmissionPolicyList is a list of MutatingAdmissionPolicy.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MutatingAdmissionPolicySpec.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MutatingAdmissionPolicySpec.java
index 3de54f72f11..cebecd87abb 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MutatingAdmissionPolicySpec.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/MutatingAdmissionPolicySpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MutatingAdmissionPolicySpec is the specification of the desired behavior of the admission policy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -107,74 +110,116 @@ public MutatingAdmissionPolicySpec(String failurePolicy, List<MatchCondition> ma
         this.variables = variables;
     }
 
+    /**
+     * failurePolicy defines how to handle failures for the admission policy. Failures can occur from CEL expression parse errors, type check errors, runtime errors and invalid or mis-configured policy definitions or bindings.<br><p> <br><p> A policy is invalid if paramKind refers to a non-existent Kind. A binding is invalid if paramRef.name refers to a non-existent resource.<br><p> <br><p> failurePolicy does not define how validations that evaluate to false are handled.<br><p> <br><p> Allowed values are Ignore or Fail. Defaults to Fail.
+     */
     @JsonProperty("failurePolicy")
     public String getFailurePolicy() {
         return failurePolicy;
     }
 
+    /**
+     * failurePolicy defines how to handle failures for the admission policy. Failures can occur from CEL expression parse errors, type check errors, runtime errors and invalid or mis-configured policy definitions or bindings.<br><p> <br><p> A policy is invalid if paramKind refers to a non-existent Kind. A binding is invalid if paramRef.name refers to a non-existent resource.<br><p> <br><p> failurePolicy does not define how validations that evaluate to false are handled.<br><p> <br><p> Allowed values are Ignore or Fail. Defaults to Fail.
+     */
     @JsonProperty("failurePolicy")
     public void setFailurePolicy(String failurePolicy) {
         this.failurePolicy = failurePolicy;
     }
 
+    /**
+     * matchConditions is a list of conditions that must be met for a request to be validated. Match conditions filter requests that have already been matched by the matchConstraints. An empty list of matchConditions matches all requests. There are a maximum of 64 match conditions allowed.<br><p> <br><p> If a parameter object is provided, it can be accessed via the `params` handle in the same manner as validation expressions.<br><p> <br><p> The exact matching logic is (in order):<br><p>   1. If ANY matchCondition evaluates to FALSE, the policy is skipped.<br><p>   2. If ALL matchConditions evaluate to TRUE, the policy is evaluated.<br><p>   3. If any matchCondition evaluates to an error (but none are FALSE):<br><p>      - If failurePolicy=Fail, reject the request<br><p>      - If failurePolicy=Ignore, the policy is skipped
+     */
     @JsonProperty("matchConditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MatchCondition> getMatchConditions() {
         return matchConditions;
     }
 
+    /**
+     * matchConditions is a list of conditions that must be met for a request to be validated. Match conditions filter requests that have already been matched by the matchConstraints. An empty list of matchConditions matches all requests. There are a maximum of 64 match conditions allowed.<br><p> <br><p> If a parameter object is provided, it can be accessed via the `params` handle in the same manner as validation expressions.<br><p> <br><p> The exact matching logic is (in order):<br><p>   1. If ANY matchCondition evaluates to FALSE, the policy is skipped.<br><p>   2. If ALL matchConditions evaluate to TRUE, the policy is evaluated.<br><p>   3. If any matchCondition evaluates to an error (but none are FALSE):<br><p>      - If failurePolicy=Fail, reject the request<br><p>      - If failurePolicy=Ignore, the policy is skipped
+     */
     @JsonProperty("matchConditions")
     public void setMatchConditions(List<MatchCondition> matchConditions) {
         this.matchConditions = matchConditions;
     }
 
+    /**
+     * MutatingAdmissionPolicySpec is the specification of the desired behavior of the admission policy.
+     */
     @JsonProperty("matchConstraints")
     public MatchResources getMatchConstraints() {
         return matchConstraints;
     }
 
+    /**
+     * MutatingAdmissionPolicySpec is the specification of the desired behavior of the admission policy.
+     */
     @JsonProperty("matchConstraints")
     public void setMatchConstraints(MatchResources matchConstraints) {
         this.matchConstraints = matchConstraints;
     }
 
+    /**
+     * mutations contain operations to perform on matching objects. mutations may not be empty; a minimum of one mutation is required. mutations are evaluated in order, and are reinvoked according to the reinvocationPolicy. The mutations of a policy are invoked for each binding of this policy and reinvocation of mutations occurs on a per binding basis.
+     */
     @JsonProperty("mutations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Mutation> getMutations() {
         return mutations;
     }
 
+    /**
+     * mutations contain operations to perform on matching objects. mutations may not be empty; a minimum of one mutation is required. mutations are evaluated in order, and are reinvoked according to the reinvocationPolicy. The mutations of a policy are invoked for each binding of this policy and reinvocation of mutations occurs on a per binding basis.
+     */
     @JsonProperty("mutations")
     public void setMutations(List<Mutation> mutations) {
         this.mutations = mutations;
     }
 
+    /**
+     * MutatingAdmissionPolicySpec is the specification of the desired behavior of the admission policy.
+     */
     @JsonProperty("paramKind")
     public ParamKind getParamKind() {
         return paramKind;
     }
 
+    /**
+     * MutatingAdmissionPolicySpec is the specification of the desired behavior of the admission policy.
+     */
     @JsonProperty("paramKind")
     public void setParamKind(ParamKind paramKind) {
         this.paramKind = paramKind;
     }
 
+    /**
+     * reinvocationPolicy indicates whether mutations may be called multiple times per MutatingAdmissionPolicyBinding as part of a single admission evaluation. Allowed values are "Never" and "IfNeeded".<br><p> <br><p> Never: These mutations will not be called more than once per binding in a single admission evaluation.<br><p> <br><p> IfNeeded: These mutations may be invoked more than once per binding for a single admission request and there is no guarantee of order with respect to other admission plugins, admission webhooks, bindings of this policy and admission policies.  Mutations are only reinvoked when mutations change the object after this mutation is invoked. Required.
+     */
     @JsonProperty("reinvocationPolicy")
     public String getReinvocationPolicy() {
         return reinvocationPolicy;
     }
 
+    /**
+     * reinvocationPolicy indicates whether mutations may be called multiple times per MutatingAdmissionPolicyBinding as part of a single admission evaluation. Allowed values are "Never" and "IfNeeded".<br><p> <br><p> Never: These mutations will not be called more than once per binding in a single admission evaluation.<br><p> <br><p> IfNeeded: These mutations may be invoked more than once per binding for a single admission request and there is no guarantee of order with respect to other admission plugins, admission webhooks, bindings of this policy and admission policies.  Mutations are only reinvoked when mutations change the object after this mutation is invoked. Required.
+     */
     @JsonProperty("reinvocationPolicy")
     public void setReinvocationPolicy(String reinvocationPolicy) {
         this.reinvocationPolicy = reinvocationPolicy;
     }
 
+    /**
+     * variables contain definitions of variables that can be used in composition of other expressions. Each variable is defined as a named CEL expression. The variables defined here will be available under `variables` in other expressions of the policy except matchConditions because matchConditions are evaluated before the rest of the policy.<br><p> <br><p> The expression of a variable can refer to other variables defined earlier in the list but not those after. Thus, variables must be sorted by the order of first appearance and acyclic.
+     */
     @JsonProperty("variables")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Variable> getVariables() {
         return variables;
     }
 
+    /**
+     * variables contain definitions of variables that can be used in composition of other expressions. Each variable is defined as a named CEL expression. The variables defined here will be available under `variables` in other expressions of the policy except matchConditions because matchConditions are evaluated before the rest of the policy.<br><p> <br><p> The expression of a variable can refer to other variables defined earlier in the list but not those after. Thus, variables must be sorted by the order of first appearance and acyclic.
+     */
     @JsonProperty("variables")
     public void setVariables(List<Variable> variables) {
         this.variables = variables;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/Mutation.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/Mutation.java
index 2dded502da7..fb47caa05b5 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/Mutation.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/Mutation.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Mutation specifies the CEL expression which is used to apply the Mutation.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public Mutation(ApplyConfiguration applyConfiguration, JSONPatch jsonPatch, Stri
         this.patchType = patchType;
     }
 
+    /**
+     * Mutation specifies the CEL expression which is used to apply the Mutation.
+     */
     @JsonProperty("applyConfiguration")
     public ApplyConfiguration getApplyConfiguration() {
         return applyConfiguration;
     }
 
+    /**
+     * Mutation specifies the CEL expression which is used to apply the Mutation.
+     */
     @JsonProperty("applyConfiguration")
     public void setApplyConfiguration(ApplyConfiguration applyConfiguration) {
         this.applyConfiguration = applyConfiguration;
     }
 
+    /**
+     * Mutation specifies the CEL expression which is used to apply the Mutation.
+     */
     @JsonProperty("jsonPatch")
     public JSONPatch getJsonPatch() {
         return jsonPatch;
     }
 
+    /**
+     * Mutation specifies the CEL expression which is used to apply the Mutation.
+     */
     @JsonProperty("jsonPatch")
     public void setJsonPatch(JSONPatch jsonPatch) {
         this.jsonPatch = jsonPatch;
     }
 
+    /**
+     * patchType indicates the patch strategy used. Allowed values are "ApplyConfiguration" and "JSONPatch". Required.
+     */
     @JsonProperty("patchType")
     public String getPatchType() {
         return patchType;
     }
 
+    /**
+     * patchType indicates the patch strategy used. Allowed values are "ApplyConfiguration" and "JSONPatch". Required.
+     */
     @JsonProperty("patchType")
     public void setPatchType(String patchType) {
         this.patchType = patchType;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/NamedRuleWithOperations.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/NamedRuleWithOperations.java
index 3b379a160a7..22fbd43c590 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/NamedRuleWithOperations.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/NamedRuleWithOperations.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NamedRuleWithOperations is a tuple of Operations and Resources with ResourceNames.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -105,66 +108,102 @@ public NamedRuleWithOperations(List<String> apiGroups, List<String> apiVersions,
         this.scope = scope;
     }
 
+    /**
+     * APIGroups is the API groups the resources belong to. '&#42;' is all groups. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("apiGroups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiGroups() {
         return apiGroups;
     }
 
+    /**
+     * APIGroups is the API groups the resources belong to. '&#42;' is all groups. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("apiGroups")
     public void setApiGroups(List<String> apiGroups) {
         this.apiGroups = apiGroups;
     }
 
+    /**
+     * APIVersions is the API versions the resources belong to. '&#42;' is all versions. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("apiVersions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiVersions() {
         return apiVersions;
     }
 
+    /**
+     * APIVersions is the API versions the resources belong to. '&#42;' is all versions. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("apiVersions")
     public void setApiVersions(List<String> apiVersions) {
         this.apiVersions = apiVersions;
     }
 
+    /**
+     * Operations is the operations the admission hook cares about - CREATE, UPDATE, DELETE, CONNECT or &#42; for all of those operations and any future admission operations that are added. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("operations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getOperations() {
         return operations;
     }
 
+    /**
+     * Operations is the operations the admission hook cares about - CREATE, UPDATE, DELETE, CONNECT or &#42; for all of those operations and any future admission operations that are added. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("operations")
     public void setOperations(List<String> operations) {
         this.operations = operations;
     }
 
+    /**
+     * ResourceNames is an optional white list of names that the rule applies to.  An empty set means that everything is allowed.
+     */
     @JsonProperty("resourceNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getResourceNames() {
         return resourceNames;
     }
 
+    /**
+     * ResourceNames is an optional white list of names that the rule applies to.  An empty set means that everything is allowed.
+     */
     @JsonProperty("resourceNames")
     public void setResourceNames(List<String> resourceNames) {
         this.resourceNames = resourceNames;
     }
 
+    /**
+     * Resources is a list of resources this rule applies to.<br><p> <br><p> For example: 'pods' means pods. 'pods/log' means the log subresource of pods. '&#42;' means all resources, but not subresources. 'pods/&#42;' means all subresources of pods. '&#42;/scale' means all scale subresources. '&#42;/&#42;' means all resources and their subresources.<br><p> <br><p> If wildcard is present, the validation rule will ensure resources do not overlap with each other.<br><p> <br><p> Depending on the enclosing object, subresources might not be allowed. Required.
+     */
     @JsonProperty("resources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getResources() {
         return resources;
     }
 
+    /**
+     * Resources is a list of resources this rule applies to.<br><p> <br><p> For example: 'pods' means pods. 'pods/log' means the log subresource of pods. '&#42;' means all resources, but not subresources. 'pods/&#42;' means all subresources of pods. '&#42;/scale' means all scale subresources. '&#42;/&#42;' means all resources and their subresources.<br><p> <br><p> If wildcard is present, the validation rule will ensure resources do not overlap with each other.<br><p> <br><p> Depending on the enclosing object, subresources might not be allowed. Required.
+     */
     @JsonProperty("resources")
     public void setResources(List<String> resources) {
         this.resources = resources;
     }
 
+    /**
+     * scope specifies the scope of this rule. Valid values are "Cluster", "Namespaced", and "&#42;" "Cluster" means that only cluster-scoped resources will match this rule. Namespace API objects are cluster-scoped. "Namespaced" means that only namespaced resources will match this rule. "&#42;" means that there are no scope restrictions. Subresources match the scope of their parent resource. Default is "&#42;".
+     */
     @JsonProperty("scope")
     public String getScope() {
         return scope;
     }
 
+    /**
+     * scope specifies the scope of this rule. Valid values are "Cluster", "Namespaced", and "&#42;" "Cluster" means that only cluster-scoped resources will match this rule. Namespace API objects are cluster-scoped. "Namespaced" means that only namespaced resources will match this rule. "&#42;" means that there are no scope restrictions. Subresources match the scope of their parent resource. Default is "&#42;".
+     */
     @JsonProperty("scope")
     public void setScope(String scope) {
         this.scope = scope;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/ParamKind.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/ParamKind.java
index 49cd4112362..9bb081fa2f2 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/ParamKind.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/ParamKind.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ParamKind is a tuple of Group Kind and Version.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ParamKind(String apiVersion, String kind) {
         this.kind = kind;
     }
 
+    /**
+     * APIVersion is the API group version the resources belong to. In format of "group/version". Required.
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * APIVersion is the API group version the resources belong to. In format of "group/version". Required.
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Kind is the API kind the resources belong to. Required.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is the API kind the resources belong to. Required.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/ParamRef.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/ParamRef.java
index 5a5d9d8d71d..a21ddf73386 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/ParamRef.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/ParamRef.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ParamRef describes how to locate the params to be used as input to expressions of rules applied by a policy binding.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ParamRef(String name, String namespace, String parameterNotFoundAction, L
         this.selector = selector;
     }
 
+    /**
+     * `name` is the name of the resource being referenced.<br><p> <br><p> `name` and `selector` are mutually exclusive properties. If one is set, the other must be unset.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * `name` is the name of the resource being referenced.<br><p> <br><p> `name` and `selector` are mutually exclusive properties. If one is set, the other must be unset.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * namespace is the namespace of the referenced resource. Allows limiting the search for params to a specific namespace. Applies to both `name` and `selector` fields.<br><p> <br><p> A per-namespace parameter may be used by specifying a namespace-scoped `paramKind` in the policy and leaving this field empty.<br><p> <br><p> - If `paramKind` is cluster-scoped, this field MUST be unset. Setting this field results in a configuration error.<br><p> <br><p> - If `paramKind` is namespace-scoped, the namespace of the object being evaluated for admission will be used when this field is left unset. Take care that if this is left empty the binding must not match any cluster-scoped resources, which will result in an error.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * namespace is the namespace of the referenced resource. Allows limiting the search for params to a specific namespace. Applies to both `name` and `selector` fields.<br><p> <br><p> A per-namespace parameter may be used by specifying a namespace-scoped `paramKind` in the policy and leaving this field empty.<br><p> <br><p> - If `paramKind` is cluster-scoped, this field MUST be unset. Setting this field results in a configuration error.<br><p> <br><p> - If `paramKind` is namespace-scoped, the namespace of the object being evaluated for admission will be used when this field is left unset. Take care that if this is left empty the binding must not match any cluster-scoped resources, which will result in an error.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * `parameterNotFoundAction` controls the behavior of the binding when the resource exists, and name or selector is valid, but there are no parameters matched by the binding. If the value is set to `Allow`, then no matched parameters will be treated as successful validation by the binding. If set to `Deny`, then no matched parameters will be subject to the `failurePolicy` of the policy.<br><p> <br><p> Allowed values are `Allow` or `Deny` Default to `Deny`
+     */
     @JsonProperty("parameterNotFoundAction")
     public String getParameterNotFoundAction() {
         return parameterNotFoundAction;
     }
 
+    /**
+     * `parameterNotFoundAction` controls the behavior of the binding when the resource exists, and name or selector is valid, but there are no parameters matched by the binding. If the value is set to `Allow`, then no matched parameters will be treated as successful validation by the binding. If set to `Deny`, then no matched parameters will be subject to the `failurePolicy` of the policy.<br><p> <br><p> Allowed values are `Allow` or `Deny` Default to `Deny`
+     */
     @JsonProperty("parameterNotFoundAction")
     public void setParameterNotFoundAction(String parameterNotFoundAction) {
         this.parameterNotFoundAction = parameterNotFoundAction;
     }
 
+    /**
+     * ParamRef describes how to locate the params to be used as input to expressions of rules applied by a policy binding.
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * ParamRef describes how to locate the params to be used as input to expressions of rules applied by a policy binding.
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/Variable.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/Variable.java
index d4a30b105aa..0e0e9c4a8d0 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/Variable.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1alpha1/Variable.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Variable is the definition of a variable that is used for composition.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Variable(String expression, String name) {
         this.name = name;
     }
 
+    /**
+     * Expression is the expression that will be evaluated as the value of the variable. The CEL expression has access to the same identifiers as the CEL expressions in Validation.
+     */
     @JsonProperty("expression")
     public String getExpression() {
         return expression;
     }
 
+    /**
+     * Expression is the expression that will be evaluated as the value of the variable. The CEL expression has access to the same identifiers as the CEL expressions in Validation.
+     */
     @JsonProperty("expression")
     public void setExpression(String expression) {
         this.expression = expression;
     }
 
+    /**
+     * Name is the name of the variable. The name must be a valid CEL identifier and unique among all variables. The variable can be accessed in other expressions through `variables` For example, if name is "foo", the variable will be available as `variables.foo`
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the variable. The name must be a valid CEL identifier and unique among all variables. The variable can be accessed in other expressions through `variables` For example, if name is "foo", the variable will be available as `variables.foo`
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/AuditAnnotation.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/AuditAnnotation.java
index c3e4c64e5ff..85d1da2a684 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/AuditAnnotation.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/AuditAnnotation.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AuditAnnotation describes how to produce an audit annotation for an API request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public AuditAnnotation(String key, String valueExpression) {
         this.valueExpression = valueExpression;
     }
 
+    /**
+     * key specifies the audit annotation key. The audit annotation keys of a ValidatingAdmissionPolicy must be unique. The key must be a qualified name ([A-Za-z0-9][-A-Za-z0-9_.]&#42;) no more than 63 bytes in length.<br><p> <br><p> The key is combined with the resource name of the ValidatingAdmissionPolicy to construct an audit annotation key: "{ValidatingAdmissionPolicy name}/{key}".<br><p> <br><p> If an admission webhook uses the same resource name as this ValidatingAdmissionPolicy and the same audit annotation key, the annotation key will be identical. In this case, the first annotation written with the key will be included in the audit event and all subsequent annotations with the same key will be discarded.<br><p> <br><p> Required.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * key specifies the audit annotation key. The audit annotation keys of a ValidatingAdmissionPolicy must be unique. The key must be a qualified name ([A-Za-z0-9][-A-Za-z0-9_.]&#42;) no more than 63 bytes in length.<br><p> <br><p> The key is combined with the resource name of the ValidatingAdmissionPolicy to construct an audit annotation key: "{ValidatingAdmissionPolicy name}/{key}".<br><p> <br><p> If an admission webhook uses the same resource name as this ValidatingAdmissionPolicy and the same audit annotation key, the annotation key will be identical. In this case, the first annotation written with the key will be included in the audit event and all subsequent annotations with the same key will be discarded.<br><p> <br><p> Required.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * valueExpression represents the expression which is evaluated by CEL to produce an audit annotation value. The expression must evaluate to either a string or null value. If the expression evaluates to a string, the audit annotation is included with the string value. If the expression evaluates to null or empty string the audit annotation will be omitted. The valueExpression may be no longer than 5kb in length. If the result of the valueExpression is more than 10kb in length, it will be truncated to 10kb.<br><p> <br><p> If multiple ValidatingAdmissionPolicyBinding resources match an API request, then the valueExpression will be evaluated for each binding. All unique values produced by the valueExpressions will be joined together in a comma-separated list.<br><p> <br><p> Required.
+     */
     @JsonProperty("valueExpression")
     public String getValueExpression() {
         return valueExpression;
     }
 
+    /**
+     * valueExpression represents the expression which is evaluated by CEL to produce an audit annotation value. The expression must evaluate to either a string or null value. If the expression evaluates to a string, the audit annotation is included with the string value. If the expression evaluates to null or empty string the audit annotation will be omitted. The valueExpression may be no longer than 5kb in length. If the result of the valueExpression is more than 10kb in length, it will be truncated to 10kb.<br><p> <br><p> If multiple ValidatingAdmissionPolicyBinding resources match an API request, then the valueExpression will be evaluated for each binding. All unique values produced by the valueExpressions will be joined together in a comma-separated list.<br><p> <br><p> Required.
+     */
     @JsonProperty("valueExpression")
     public void setValueExpression(String valueExpression) {
         this.valueExpression = valueExpression;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ExpressionWarning.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ExpressionWarning.java
index a75750ef383..ad80c952479 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ExpressionWarning.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ExpressionWarning.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ExpressionWarning is a warning information that targets a specific expression.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ExpressionWarning(String fieldRef, String warning) {
         this.warning = warning;
     }
 
+    /**
+     * The path to the field that refers the expression. For example, the reference to the expression of the first item of validations is "spec.validations[0].expression"
+     */
     @JsonProperty("fieldRef")
     public String getFieldRef() {
         return fieldRef;
     }
 
+    /**
+     * The path to the field that refers the expression. For example, the reference to the expression of the first item of validations is "spec.validations[0].expression"
+     */
     @JsonProperty("fieldRef")
     public void setFieldRef(String fieldRef) {
         this.fieldRef = fieldRef;
     }
 
+    /**
+     * The content of type checking information in a human-readable form. Each line of the warning contains the type that the expression is checked against, followed by the type check error from the compiler.
+     */
     @JsonProperty("warning")
     public String getWarning() {
         return warning;
     }
 
+    /**
+     * The content of type checking information in a human-readable form. Each line of the warning contains the type that the expression is checked against, followed by the type check error from the compiler.
+     */
     @JsonProperty("warning")
     public void setWarning(String warning) {
         this.warning = warning;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/MatchCondition.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/MatchCondition.java
index 3b1ce66d00a..0ab665b2961 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/MatchCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/MatchCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MatchCondition represents a condition which must be fulfilled for a request to be sent to a webhook.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public MatchCondition(String expression, String name) {
         this.name = name;
     }
 
+    /**
+     * Expression represents the expression which will be evaluated by CEL. Must evaluate to bool. CEL expressions have access to the contents of the AdmissionRequest and Authorizer, organized into CEL variables:<br><p> <br><p> 'object' - The object from the incoming request. The value is null for DELETE requests. 'oldObject' - The existing object. The value is null for CREATE requests. 'request' - Attributes of the admission request(/pkg/apis/admission/types.go#AdmissionRequest). 'authorizer' - A CEL Authorizer. May be used to perform authorization checks for the principal (user or service account) of the request.<br><p>   See https://pkg.go.dev/k8s.io/apiserver/pkg/cel/library#Authz<br><p> 'authorizer.requestResource' - A CEL ResourceCheck constructed from the 'authorizer' and configured with the<br><p>   request resource.<br><p> Documentation on CEL: https://kubernetes.io/docs/reference/using-api/cel/<br><p> <br><p> Required.
+     */
     @JsonProperty("expression")
     public String getExpression() {
         return expression;
     }
 
+    /**
+     * Expression represents the expression which will be evaluated by CEL. Must evaluate to bool. CEL expressions have access to the contents of the AdmissionRequest and Authorizer, organized into CEL variables:<br><p> <br><p> 'object' - The object from the incoming request. The value is null for DELETE requests. 'oldObject' - The existing object. The value is null for CREATE requests. 'request' - Attributes of the admission request(/pkg/apis/admission/types.go#AdmissionRequest). 'authorizer' - A CEL Authorizer. May be used to perform authorization checks for the principal (user or service account) of the request.<br><p>   See https://pkg.go.dev/k8s.io/apiserver/pkg/cel/library#Authz<br><p> 'authorizer.requestResource' - A CEL ResourceCheck constructed from the 'authorizer' and configured with the<br><p>   request resource.<br><p> Documentation on CEL: https://kubernetes.io/docs/reference/using-api/cel/<br><p> <br><p> Required.
+     */
     @JsonProperty("expression")
     public void setExpression(String expression) {
         this.expression = expression;
     }
 
+    /**
+     * Name is an identifier for this match condition, used for strategic merging of MatchConditions, as well as providing an identifier for logging purposes. A good name should be descriptive of the associated expression. Name must be a qualified name consisting of alphanumeric characters, '-', '_' or '.', and must start and end with an alphanumeric character (e.g. 'MyName',  or 'my.name',  or '123-abc', regex used for validation is '([A-Za-z0-9][-A-Za-z0-9_.]&#42;)?[A-Za-z0-9]') with an optional DNS subdomain prefix and '/' (e.g. 'example.com/MyName')<br><p> <br><p> Required.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is an identifier for this match condition, used for strategic merging of MatchConditions, as well as providing an identifier for logging purposes. A good name should be descriptive of the associated expression. Name must be a qualified name consisting of alphanumeric characters, '-', '_' or '.', and must start and end with an alphanumeric character (e.g. 'MyName',  or 'my.name',  or '123-abc', regex used for validation is '([A-Za-z0-9][-A-Za-z0-9_.]&#42;)?[A-Za-z0-9]') with an optional DNS subdomain prefix and '/' (e.g. 'example.com/MyName')<br><p> <br><p> Required.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/MatchResources.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/MatchResources.java
index acd7b03f22d..332296610ab 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/MatchResources.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/MatchResources.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MatchResources decides whether to run the admission control policy on an object based on whether it meets the match criteria. The exclude rules take precedence over include rules (if a resource matches both, it is excluded)
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,53 +101,83 @@ public MatchResources(List<NamedRuleWithOperations> excludeResourceRules, String
         this.resourceRules = resourceRules;
     }
 
+    /**
+     * ExcludeResourceRules describes what operations on what resources/subresources the ValidatingAdmissionPolicy should not care about. The exclude rules take precedence over include rules (if a resource matches both, it is excluded)
+     */
     @JsonProperty("excludeResourceRules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NamedRuleWithOperations> getExcludeResourceRules() {
         return excludeResourceRules;
     }
 
+    /**
+     * ExcludeResourceRules describes what operations on what resources/subresources the ValidatingAdmissionPolicy should not care about. The exclude rules take precedence over include rules (if a resource matches both, it is excluded)
+     */
     @JsonProperty("excludeResourceRules")
     public void setExcludeResourceRules(List<NamedRuleWithOperations> excludeResourceRules) {
         this.excludeResourceRules = excludeResourceRules;
     }
 
+    /**
+     * matchPolicy defines how the "MatchResources" list is used to match incoming requests. Allowed values are "Exact" or "Equivalent".<br><p> <br><p> - Exact: match a request only if it exactly matches a specified rule. For example, if deployments can be modified via apps/v1, apps/v1beta1, and extensions/v1beta1, but "rules" only included `apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]`, a request to apps/v1beta1 or extensions/v1beta1 would not be sent to the ValidatingAdmissionPolicy.<br><p> <br><p> - Equivalent: match a request if modifies a resource listed in rules, even via another API group or version. For example, if deployments can be modified via apps/v1, apps/v1beta1, and extensions/v1beta1, and "rules" only included `apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]`, a request to apps/v1beta1 or extensions/v1beta1 would be converted to apps/v1 and sent to the ValidatingAdmissionPolicy.<br><p> <br><p> Defaults to "Equivalent"
+     */
     @JsonProperty("matchPolicy")
     public String getMatchPolicy() {
         return matchPolicy;
     }
 
+    /**
+     * matchPolicy defines how the "MatchResources" list is used to match incoming requests. Allowed values are "Exact" or "Equivalent".<br><p> <br><p> - Exact: match a request only if it exactly matches a specified rule. For example, if deployments can be modified via apps/v1, apps/v1beta1, and extensions/v1beta1, but "rules" only included `apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]`, a request to apps/v1beta1 or extensions/v1beta1 would not be sent to the ValidatingAdmissionPolicy.<br><p> <br><p> - Equivalent: match a request if modifies a resource listed in rules, even via another API group or version. For example, if deployments can be modified via apps/v1, apps/v1beta1, and extensions/v1beta1, and "rules" only included `apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]`, a request to apps/v1beta1 or extensions/v1beta1 would be converted to apps/v1 and sent to the ValidatingAdmissionPolicy.<br><p> <br><p> Defaults to "Equivalent"
+     */
     @JsonProperty("matchPolicy")
     public void setMatchPolicy(String matchPolicy) {
         this.matchPolicy = matchPolicy;
     }
 
+    /**
+     * MatchResources decides whether to run the admission control policy on an object based on whether it meets the match criteria. The exclude rules take precedence over include rules (if a resource matches both, it is excluded)
+     */
     @JsonProperty("namespaceSelector")
     public LabelSelector getNamespaceSelector() {
         return namespaceSelector;
     }
 
+    /**
+     * MatchResources decides whether to run the admission control policy on an object based on whether it meets the match criteria. The exclude rules take precedence over include rules (if a resource matches both, it is excluded)
+     */
     @JsonProperty("namespaceSelector")
     public void setNamespaceSelector(LabelSelector namespaceSelector) {
         this.namespaceSelector = namespaceSelector;
     }
 
+    /**
+     * MatchResources decides whether to run the admission control policy on an object based on whether it meets the match criteria. The exclude rules take precedence over include rules (if a resource matches both, it is excluded)
+     */
     @JsonProperty("objectSelector")
     public LabelSelector getObjectSelector() {
         return objectSelector;
     }
 
+    /**
+     * MatchResources decides whether to run the admission control policy on an object based on whether it meets the match criteria. The exclude rules take precedence over include rules (if a resource matches both, it is excluded)
+     */
     @JsonProperty("objectSelector")
     public void setObjectSelector(LabelSelector objectSelector) {
         this.objectSelector = objectSelector;
     }
 
+    /**
+     * ResourceRules describes what operations on what resources/subresources the ValidatingAdmissionPolicy matches. The policy cares about an operation if it matches _any_ Rule.
+     */
     @JsonProperty("resourceRules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NamedRuleWithOperations> getResourceRules() {
         return resourceRules;
     }
 
+    /**
+     * ResourceRules describes what operations on what resources/subresources the ValidatingAdmissionPolicy matches. The policy cares about an operation if it matches _any_ Rule.
+     */
     @JsonProperty("resourceRules")
     public void setResourceRules(List<NamedRuleWithOperations> resourceRules) {
         this.resourceRules = resourceRules;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/MutatingWebhook.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/MutatingWebhook.java
index a1cc273bd22..a5ccb9d9862 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/MutatingWebhook.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/MutatingWebhook.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MutatingWebhook describes an admission webhook and the resources and operations it applies to.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -122,113 +125,179 @@ public MutatingWebhook(List<String> admissionReviewVersions, WebhookClientConfig
         this.timeoutSeconds = timeoutSeconds;
     }
 
+    /**
+     * AdmissionReviewVersions is an ordered list of preferred `AdmissionReview` versions the Webhook expects. API server will try to use first version in the list which it supports. If none of the versions specified in this list supported by API server, validation will fail for this object. If a persisted webhook configuration specifies allowed versions and does not include any versions known to the API Server, calls to the webhook will fail and be subject to the failure policy. Default to `['v1beta1']`.
+     */
     @JsonProperty("admissionReviewVersions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAdmissionReviewVersions() {
         return admissionReviewVersions;
     }
 
+    /**
+     * AdmissionReviewVersions is an ordered list of preferred `AdmissionReview` versions the Webhook expects. API server will try to use first version in the list which it supports. If none of the versions specified in this list supported by API server, validation will fail for this object. If a persisted webhook configuration specifies allowed versions and does not include any versions known to the API Server, calls to the webhook will fail and be subject to the failure policy. Default to `['v1beta1']`.
+     */
     @JsonProperty("admissionReviewVersions")
     public void setAdmissionReviewVersions(List<String> admissionReviewVersions) {
         this.admissionReviewVersions = admissionReviewVersions;
     }
 
+    /**
+     * MutatingWebhook describes an admission webhook and the resources and operations it applies to.
+     */
     @JsonProperty("clientConfig")
     public WebhookClientConfig getClientConfig() {
         return clientConfig;
     }
 
+    /**
+     * MutatingWebhook describes an admission webhook and the resources and operations it applies to.
+     */
     @JsonProperty("clientConfig")
     public void setClientConfig(WebhookClientConfig clientConfig) {
         this.clientConfig = clientConfig;
     }
 
+    /**
+     * FailurePolicy defines how unrecognized errors from the admission endpoint are handled - allowed values are Ignore or Fail. Defaults to Ignore.
+     */
     @JsonProperty("failurePolicy")
     public String getFailurePolicy() {
         return failurePolicy;
     }
 
+    /**
+     * FailurePolicy defines how unrecognized errors from the admission endpoint are handled - allowed values are Ignore or Fail. Defaults to Ignore.
+     */
     @JsonProperty("failurePolicy")
     public void setFailurePolicy(String failurePolicy) {
         this.failurePolicy = failurePolicy;
     }
 
+    /**
+     * matchPolicy defines how the "rules" list is used to match incoming requests. Allowed values are "Exact" or "Equivalent".<br><p> <br><p> - Exact: match a request only if it exactly matches a specified rule. For example, if deployments can be modified via apps/v1, apps/v1beta1, and extensions/v1beta1, but "rules" only included `apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]`, a request to apps/v1beta1 or extensions/v1beta1 would not be sent to the webhook.<br><p> <br><p> - Equivalent: match a request if modifies a resource listed in rules, even via another API group or version. For example, if deployments can be modified via apps/v1, apps/v1beta1, and extensions/v1beta1, and "rules" only included `apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]`, a request to apps/v1beta1 or extensions/v1beta1 would be converted to apps/v1 and sent to the webhook.<br><p> <br><p> Defaults to "Exact"
+     */
     @JsonProperty("matchPolicy")
     public String getMatchPolicy() {
         return matchPolicy;
     }
 
+    /**
+     * matchPolicy defines how the "rules" list is used to match incoming requests. Allowed values are "Exact" or "Equivalent".<br><p> <br><p> - Exact: match a request only if it exactly matches a specified rule. For example, if deployments can be modified via apps/v1, apps/v1beta1, and extensions/v1beta1, but "rules" only included `apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]`, a request to apps/v1beta1 or extensions/v1beta1 would not be sent to the webhook.<br><p> <br><p> - Equivalent: match a request if modifies a resource listed in rules, even via another API group or version. For example, if deployments can be modified via apps/v1, apps/v1beta1, and extensions/v1beta1, and "rules" only included `apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]`, a request to apps/v1beta1 or extensions/v1beta1 would be converted to apps/v1 and sent to the webhook.<br><p> <br><p> Defaults to "Exact"
+     */
     @JsonProperty("matchPolicy")
     public void setMatchPolicy(String matchPolicy) {
         this.matchPolicy = matchPolicy;
     }
 
+    /**
+     * The name of the admission webhook. Name should be fully qualified, e.g., imagepolicy.kubernetes.io, where "imagepolicy" is the name of the webhook, and kubernetes.io is the name of the organization. Required.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The name of the admission webhook. Name should be fully qualified, e.g., imagepolicy.kubernetes.io, where "imagepolicy" is the name of the webhook, and kubernetes.io is the name of the organization. Required.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * MutatingWebhook describes an admission webhook and the resources and operations it applies to.
+     */
     @JsonProperty("namespaceSelector")
     public LabelSelector getNamespaceSelector() {
         return namespaceSelector;
     }
 
+    /**
+     * MutatingWebhook describes an admission webhook and the resources and operations it applies to.
+     */
     @JsonProperty("namespaceSelector")
     public void setNamespaceSelector(LabelSelector namespaceSelector) {
         this.namespaceSelector = namespaceSelector;
     }
 
+    /**
+     * MutatingWebhook describes an admission webhook and the resources and operations it applies to.
+     */
     @JsonProperty("objectSelector")
     public LabelSelector getObjectSelector() {
         return objectSelector;
     }
 
+    /**
+     * MutatingWebhook describes an admission webhook and the resources and operations it applies to.
+     */
     @JsonProperty("objectSelector")
     public void setObjectSelector(LabelSelector objectSelector) {
         this.objectSelector = objectSelector;
     }
 
+    /**
+     * reinvocationPolicy indicates whether this webhook should be called multiple times as part of a single admission evaluation. Allowed values are "Never" and "IfNeeded".<br><p> <br><p> Never: the webhook will not be called more than once in a single admission evaluation.<br><p> <br><p> IfNeeded: the webhook will be called at least one additional time as part of the admission evaluation if the object being admitted is modified by other admission plugins after the initial webhook call. Webhooks that specify this option &#42;must&#42; be idempotent, able to process objects they previously admitted. Note: &#42; the number of additional invocations is not guaranteed to be exactly one. &#42; if additional invocations result in further modifications to the object, webhooks are not guaranteed to be invoked again. &#42; webhooks that use this option may be reordered to minimize the number of additional invocations. &#42; to validate an object after all mutations are guaranteed complete, use a validating admission webhook instead.<br><p> <br><p> Defaults to "Never".
+     */
     @JsonProperty("reinvocationPolicy")
     public String getReinvocationPolicy() {
         return reinvocationPolicy;
     }
 
+    /**
+     * reinvocationPolicy indicates whether this webhook should be called multiple times as part of a single admission evaluation. Allowed values are "Never" and "IfNeeded".<br><p> <br><p> Never: the webhook will not be called more than once in a single admission evaluation.<br><p> <br><p> IfNeeded: the webhook will be called at least one additional time as part of the admission evaluation if the object being admitted is modified by other admission plugins after the initial webhook call. Webhooks that specify this option &#42;must&#42; be idempotent, able to process objects they previously admitted. Note: &#42; the number of additional invocations is not guaranteed to be exactly one. &#42; if additional invocations result in further modifications to the object, webhooks are not guaranteed to be invoked again. &#42; webhooks that use this option may be reordered to minimize the number of additional invocations. &#42; to validate an object after all mutations are guaranteed complete, use a validating admission webhook instead.<br><p> <br><p> Defaults to "Never".
+     */
     @JsonProperty("reinvocationPolicy")
     public void setReinvocationPolicy(String reinvocationPolicy) {
         this.reinvocationPolicy = reinvocationPolicy;
     }
 
+    /**
+     * Rules describes what operations on what resources/subresources the webhook cares about. The webhook cares about an operation if it matches _any_ Rule. However, in order to prevent ValidatingAdmissionWebhooks and MutatingAdmissionWebhooks from putting the cluster in a state which cannot be recovered from without completely disabling the plugin, ValidatingAdmissionWebhooks and MutatingAdmissionWebhooks are never called on admission requests for ValidatingWebhookConfiguration and MutatingWebhookConfiguration objects.
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RuleWithOperations> getRules() {
         return rules;
     }
 
+    /**
+     * Rules describes what operations on what resources/subresources the webhook cares about. The webhook cares about an operation if it matches _any_ Rule. However, in order to prevent ValidatingAdmissionWebhooks and MutatingAdmissionWebhooks from putting the cluster in a state which cannot be recovered from without completely disabling the plugin, ValidatingAdmissionWebhooks and MutatingAdmissionWebhooks are never called on admission requests for ValidatingWebhookConfiguration and MutatingWebhookConfiguration objects.
+     */
     @JsonProperty("rules")
     public void setRules(List<RuleWithOperations> rules) {
         this.rules = rules;
     }
 
+    /**
+     * SideEffects states whether this webhook has side effects. Acceptable values are: Unknown, None, Some, NoneOnDryRun Webhooks with side effects MUST implement a reconciliation system, since a request may be rejected by a future step in the admission chain and the side effects therefore need to be undone. Requests with the dryRun attribute will be auto-rejected if they match a webhook with sideEffects == Unknown or Some. Defaults to Unknown.
+     */
     @JsonProperty("sideEffects")
     public String getSideEffects() {
         return sideEffects;
     }
 
+    /**
+     * SideEffects states whether this webhook has side effects. Acceptable values are: Unknown, None, Some, NoneOnDryRun Webhooks with side effects MUST implement a reconciliation system, since a request may be rejected by a future step in the admission chain and the side effects therefore need to be undone. Requests with the dryRun attribute will be auto-rejected if they match a webhook with sideEffects == Unknown or Some. Defaults to Unknown.
+     */
     @JsonProperty("sideEffects")
     public void setSideEffects(String sideEffects) {
         this.sideEffects = sideEffects;
     }
 
+    /**
+     * TimeoutSeconds specifies the timeout for this webhook. After the timeout passes, the webhook call will be ignored or the API call will fail based on the failure policy. The timeout value must be between 1 and 30 seconds. Default to 30 seconds.
+     */
     @JsonProperty("timeoutSeconds")
     public Integer getTimeoutSeconds() {
         return timeoutSeconds;
     }
 
+    /**
+     * TimeoutSeconds specifies the timeout for this webhook. After the timeout passes, the webhook call will be ignored or the API call will fail based on the failure policy. The timeout value must be between 1 and 30 seconds. Default to 30 seconds.
+     */
     @JsonProperty("timeoutSeconds")
     public void setTimeoutSeconds(Integer timeoutSeconds) {
         this.timeoutSeconds = timeoutSeconds;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/MutatingWebhookConfiguration.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/MutatingWebhookConfiguration.java
index f5626987d07..e5adc8a077f 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/MutatingWebhookConfiguration.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/MutatingWebhookConfiguration.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MutatingWebhookConfiguration describes the configuration of and admission webhook that accept or reject and may change the object. Deprecated in v1.16, planned for removal in v1.19. Use admissionregistration.k8s.io/v1 MutatingWebhookConfiguration instead.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class MutatingWebhookConfiguration implements Editable<MutatingWebhookConfigurationBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "admissionregistration.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MutatingWebhookConfiguration";
     @JsonProperty("metadata")
@@ -109,7 +106,7 @@ public MutatingWebhookConfiguration(String apiVersion, String kind, ObjectMeta m
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -117,7 +114,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -125,7 +122,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -133,29 +130,41 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MutatingWebhookConfiguration describes the configuration of and admission webhook that accept or reject and may change the object. Deprecated in v1.16, planned for removal in v1.19. Use admissionregistration.k8s.io/v1 MutatingWebhookConfiguration instead.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MutatingWebhookConfiguration describes the configuration of and admission webhook that accept or reject and may change the object. Deprecated in v1.16, planned for removal in v1.19. Use admissionregistration.k8s.io/v1 MutatingWebhookConfiguration instead.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Webhooks is a list of webhooks and the affected resources and operations.
+     */
     @JsonProperty("webhooks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MutatingWebhook> getWebhooks() {
         return webhooks;
     }
 
+    /**
+     * Webhooks is a list of webhooks and the affected resources and operations.
+     */
     @JsonProperty("webhooks")
     public void setWebhooks(List<MutatingWebhook> webhooks) {
         this.webhooks = webhooks;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/MutatingWebhookConfigurationList.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/MutatingWebhookConfigurationList.java
index 77050b2b0c9..4a6495070d2 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/MutatingWebhookConfigurationList.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/MutatingWebhookConfigurationList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MutatingWebhookConfigurationList is a list of MutatingWebhookConfiguration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class MutatingWebhookConfigurationList implements Editable<MutatingWebhookConfigurationListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.admissionregistration.v1beta1.MutatingWebhookConfiguration>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "admissionregistration.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.admissionregistration.v1beta1.MutatingWebhookConfiguration> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MutatingWebhookConfigurationList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public MutatingWebhookConfigurationList(String apiVersion, List<io.fabric8.kuber
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of MutatingWebhookConfiguration.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.admissionregistration.v1beta1.MutatingWebhookConfiguration> getItems() {
         return items;
     }
 
+    /**
+     * List of MutatingWebhookConfiguration.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.admissionregistration.v1beta1.MutatingWebhookConfiguration> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MutatingWebhookConfigurationList is a list of MutatingWebhookConfiguration.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MutatingWebhookConfigurationList is a list of MutatingWebhookConfiguration.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/NamedRuleWithOperations.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/NamedRuleWithOperations.java
index 51e185322d7..51df3427398 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/NamedRuleWithOperations.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/NamedRuleWithOperations.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NamedRuleWithOperations is a tuple of Operations and Resources with ResourceNames.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -105,66 +108,102 @@ public NamedRuleWithOperations(List<String> apiGroups, List<String> apiVersions,
         this.scope = scope;
     }
 
+    /**
+     * APIGroups is the API groups the resources belong to. '&#42;' is all groups. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("apiGroups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiGroups() {
         return apiGroups;
     }
 
+    /**
+     * APIGroups is the API groups the resources belong to. '&#42;' is all groups. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("apiGroups")
     public void setApiGroups(List<String> apiGroups) {
         this.apiGroups = apiGroups;
     }
 
+    /**
+     * APIVersions is the API versions the resources belong to. '&#42;' is all versions. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("apiVersions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiVersions() {
         return apiVersions;
     }
 
+    /**
+     * APIVersions is the API versions the resources belong to. '&#42;' is all versions. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("apiVersions")
     public void setApiVersions(List<String> apiVersions) {
         this.apiVersions = apiVersions;
     }
 
+    /**
+     * Operations is the operations the admission hook cares about - CREATE, UPDATE, DELETE, CONNECT or &#42; for all of those operations and any future admission operations that are added. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("operations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getOperations() {
         return operations;
     }
 
+    /**
+     * Operations is the operations the admission hook cares about - CREATE, UPDATE, DELETE, CONNECT or &#42; for all of those operations and any future admission operations that are added. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("operations")
     public void setOperations(List<String> operations) {
         this.operations = operations;
     }
 
+    /**
+     * ResourceNames is an optional white list of names that the rule applies to.  An empty set means that everything is allowed.
+     */
     @JsonProperty("resourceNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getResourceNames() {
         return resourceNames;
     }
 
+    /**
+     * ResourceNames is an optional white list of names that the rule applies to.  An empty set means that everything is allowed.
+     */
     @JsonProperty("resourceNames")
     public void setResourceNames(List<String> resourceNames) {
         this.resourceNames = resourceNames;
     }
 
+    /**
+     * Resources is a list of resources this rule applies to.<br><p> <br><p> For example: 'pods' means pods. 'pods/log' means the log subresource of pods. '&#42;' means all resources, but not subresources. 'pods/&#42;' means all subresources of pods. '&#42;/scale' means all scale subresources. '&#42;/&#42;' means all resources and their subresources.<br><p> <br><p> If wildcard is present, the validation rule will ensure resources do not overlap with each other.<br><p> <br><p> Depending on the enclosing object, subresources might not be allowed. Required.
+     */
     @JsonProperty("resources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getResources() {
         return resources;
     }
 
+    /**
+     * Resources is a list of resources this rule applies to.<br><p> <br><p> For example: 'pods' means pods. 'pods/log' means the log subresource of pods. '&#42;' means all resources, but not subresources. 'pods/&#42;' means all subresources of pods. '&#42;/scale' means all scale subresources. '&#42;/&#42;' means all resources and their subresources.<br><p> <br><p> If wildcard is present, the validation rule will ensure resources do not overlap with each other.<br><p> <br><p> Depending on the enclosing object, subresources might not be allowed. Required.
+     */
     @JsonProperty("resources")
     public void setResources(List<String> resources) {
         this.resources = resources;
     }
 
+    /**
+     * scope specifies the scope of this rule. Valid values are "Cluster", "Namespaced", and "&#42;" "Cluster" means that only cluster-scoped resources will match this rule. Namespace API objects are cluster-scoped. "Namespaced" means that only namespaced resources will match this rule. "&#42;" means that there are no scope restrictions. Subresources match the scope of their parent resource. Default is "&#42;".
+     */
     @JsonProperty("scope")
     public String getScope() {
         return scope;
     }
 
+    /**
+     * scope specifies the scope of this rule. Valid values are "Cluster", "Namespaced", and "&#42;" "Cluster" means that only cluster-scoped resources will match this rule. Namespace API objects are cluster-scoped. "Namespaced" means that only namespaced resources will match this rule. "&#42;" means that there are no scope restrictions. Subresources match the scope of their parent resource. Default is "&#42;".
+     */
     @JsonProperty("scope")
     public void setScope(String scope) {
         this.scope = scope;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ParamKind.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ParamKind.java
index 2ac6600ef91..5bb2e3ef540 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ParamKind.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ParamKind.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ParamKind is a tuple of Group Kind and Version.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ParamKind(String apiVersion, String kind) {
         this.kind = kind;
     }
 
+    /**
+     * APIVersion is the API group version the resources belong to. In format of "group/version". Required.
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * APIVersion is the API group version the resources belong to. In format of "group/version". Required.
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Kind is the API kind the resources belong to. Required.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is the API kind the resources belong to. Required.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ParamRef.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ParamRef.java
index 4aa98a071ab..6e5f9ca1b74 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ParamRef.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ParamRef.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ParamRef describes how to locate the params to be used as input to expressions of rules applied by a policy binding.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ParamRef(String name, String namespace, String parameterNotFoundAction, L
         this.selector = selector;
     }
 
+    /**
+     * name is the name of the resource being referenced.<br><p> <br><p> One of `name` or `selector` must be set, but `name` and `selector` are mutually exclusive properties. If one is set, the other must be unset.<br><p> <br><p> A single parameter used for all admission requests can be configured by setting the `name` field, leaving `selector` blank, and setting namespace if `paramKind` is namespace-scoped.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the resource being referenced.<br><p> <br><p> One of `name` or `selector` must be set, but `name` and `selector` are mutually exclusive properties. If one is set, the other must be unset.<br><p> <br><p> A single parameter used for all admission requests can be configured by setting the `name` field, leaving `selector` blank, and setting namespace if `paramKind` is namespace-scoped.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * namespace is the namespace of the referenced resource. Allows limiting the search for params to a specific namespace. Applies to both `name` and `selector` fields.<br><p> <br><p> A per-namespace parameter may be used by specifying a namespace-scoped `paramKind` in the policy and leaving this field empty.<br><p> <br><p> - If `paramKind` is cluster-scoped, this field MUST be unset. Setting this field results in a configuration error.<br><p> <br><p> - If `paramKind` is namespace-scoped, the namespace of the object being evaluated for admission will be used when this field is left unset. Take care that if this is left empty the binding must not match any cluster-scoped resources, which will result in an error.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * namespace is the namespace of the referenced resource. Allows limiting the search for params to a specific namespace. Applies to both `name` and `selector` fields.<br><p> <br><p> A per-namespace parameter may be used by specifying a namespace-scoped `paramKind` in the policy and leaving this field empty.<br><p> <br><p> - If `paramKind` is cluster-scoped, this field MUST be unset. Setting this field results in a configuration error.<br><p> <br><p> - If `paramKind` is namespace-scoped, the namespace of the object being evaluated for admission will be used when this field is left unset. Take care that if this is left empty the binding must not match any cluster-scoped resources, which will result in an error.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * `parameterNotFoundAction` controls the behavior of the binding when the resource exists, and name or selector is valid, but there are no parameters matched by the binding. If the value is set to `Allow`, then no matched parameters will be treated as successful validation by the binding. If set to `Deny`, then no matched parameters will be subject to the `failurePolicy` of the policy.<br><p> <br><p> Allowed values are `Allow` or `Deny`<br><p> <br><p> Required
+     */
     @JsonProperty("parameterNotFoundAction")
     public String getParameterNotFoundAction() {
         return parameterNotFoundAction;
     }
 
+    /**
+     * `parameterNotFoundAction` controls the behavior of the binding when the resource exists, and name or selector is valid, but there are no parameters matched by the binding. If the value is set to `Allow`, then no matched parameters will be treated as successful validation by the binding. If set to `Deny`, then no matched parameters will be subject to the `failurePolicy` of the policy.<br><p> <br><p> Allowed values are `Allow` or `Deny`<br><p> <br><p> Required
+     */
     @JsonProperty("parameterNotFoundAction")
     public void setParameterNotFoundAction(String parameterNotFoundAction) {
         this.parameterNotFoundAction = parameterNotFoundAction;
     }
 
+    /**
+     * ParamRef describes how to locate the params to be used as input to expressions of rules applied by a policy binding.
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * ParamRef describes how to locate the params to be used as input to expressions of rules applied by a policy binding.
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/RuleWithOperations.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/RuleWithOperations.java
index 28e40633bd2..6b167678bc3 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/RuleWithOperations.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/RuleWithOperations.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RuleWithOperations is a tuple of Operations and Resources. It is recommended to make sure that all the tuple expansions are valid.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -100,55 +103,85 @@ public RuleWithOperations(List<String> apiGroups, List<String> apiVersions, List
         this.scope = scope;
     }
 
+    /**
+     * APIGroups is the API groups the resources belong to. '&#42;' is all groups. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("apiGroups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiGroups() {
         return apiGroups;
     }
 
+    /**
+     * APIGroups is the API groups the resources belong to. '&#42;' is all groups. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("apiGroups")
     public void setApiGroups(List<String> apiGroups) {
         this.apiGroups = apiGroups;
     }
 
+    /**
+     * APIVersions is the API versions the resources belong to. '&#42;' is all versions. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("apiVersions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiVersions() {
         return apiVersions;
     }
 
+    /**
+     * APIVersions is the API versions the resources belong to. '&#42;' is all versions. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("apiVersions")
     public void setApiVersions(List<String> apiVersions) {
         this.apiVersions = apiVersions;
     }
 
+    /**
+     * Operations is the operations the admission hook cares about - CREATE, UPDATE, DELETE, CONNECT or &#42; for all of those operations and any future admission operations that are added. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("operations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getOperations() {
         return operations;
     }
 
+    /**
+     * Operations is the operations the admission hook cares about - CREATE, UPDATE, DELETE, CONNECT or &#42; for all of those operations and any future admission operations that are added. If '&#42;' is present, the length of the slice must be one. Required.
+     */
     @JsonProperty("operations")
     public void setOperations(List<String> operations) {
         this.operations = operations;
     }
 
+    /**
+     * Resources is a list of resources this rule applies to.<br><p> <br><p> For example: 'pods' means pods. 'pods/log' means the log subresource of pods. '&#42;' means all resources, but not subresources. 'pods/&#42;' means all subresources of pods. '&#42;/scale' means all scale subresources. '&#42;/&#42;' means all resources and their subresources.<br><p> <br><p> If wildcard is present, the validation rule will ensure resources do not overlap with each other.<br><p> <br><p> Depending on the enclosing object, subresources might not be allowed. Required.
+     */
     @JsonProperty("resources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getResources() {
         return resources;
     }
 
+    /**
+     * Resources is a list of resources this rule applies to.<br><p> <br><p> For example: 'pods' means pods. 'pods/log' means the log subresource of pods. '&#42;' means all resources, but not subresources. 'pods/&#42;' means all subresources of pods. '&#42;/scale' means all scale subresources. '&#42;/&#42;' means all resources and their subresources.<br><p> <br><p> If wildcard is present, the validation rule will ensure resources do not overlap with each other.<br><p> <br><p> Depending on the enclosing object, subresources might not be allowed. Required.
+     */
     @JsonProperty("resources")
     public void setResources(List<String> resources) {
         this.resources = resources;
     }
 
+    /**
+     * scope specifies the scope of this rule. Valid values are "Cluster", "Namespaced", and "&#42;" "Cluster" means that only cluster-scoped resources will match this rule. Namespace API objects are cluster-scoped. "Namespaced" means that only namespaced resources will match this rule. "&#42;" means that there are no scope restrictions. Subresources match the scope of their parent resource. Default is "&#42;".
+     */
     @JsonProperty("scope")
     public String getScope() {
         return scope;
     }
 
+    /**
+     * scope specifies the scope of this rule. Valid values are "Cluster", "Namespaced", and "&#42;" "Cluster" means that only cluster-scoped resources will match this rule. Namespace API objects are cluster-scoped. "Namespaced" means that only namespaced resources will match this rule. "&#42;" means that there are no scope restrictions. Subresources match the scope of their parent resource. Default is "&#42;".
+     */
     @JsonProperty("scope")
     public void setScope(String scope) {
         this.scope = scope;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ServiceReference.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ServiceReference.java
index c8f5f1c4993..e4cd03582be 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ServiceReference.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ServiceReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceReference holds a reference to Service.legacy.k8s.io
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ServiceReference(String name, String namespace, String path, Integer port
         this.port = port;
     }
 
+    /**
+     * `name` is the name of the service. Required
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * `name` is the name of the service. Required
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * `namespace` is the namespace of the service. Required
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * `namespace` is the namespace of the service. Required
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * `path` is an optional URL path which will be sent in any request to this service.
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * `path` is an optional URL path which will be sent in any request to this service.
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * If specified, the port on the service that hosting webhook. Default to 443 for backward compatibility. `port` should be a valid port number (1-65535, inclusive).
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * If specified, the port on the service that hosting webhook. Default to 443 for backward compatibility. `port` should be a valid port number (1-65535, inclusive).
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/TypeChecking.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/TypeChecking.java
index 0a651d1d5ff..0678d6126e1 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/TypeChecking.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/TypeChecking.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TypeChecking contains results of type checking the expressions in the ValidatingAdmissionPolicy
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public TypeChecking(List<ExpressionWarning> expressionWarnings) {
         this.expressionWarnings = expressionWarnings;
     }
 
+    /**
+     * The type checking warnings for each expression.
+     */
     @JsonProperty("expressionWarnings")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ExpressionWarning> getExpressionWarnings() {
         return expressionWarnings;
     }
 
+    /**
+     * The type checking warnings for each expression.
+     */
     @JsonProperty("expressionWarnings")
     public void setExpressionWarnings(List<ExpressionWarning> expressionWarnings) {
         this.expressionWarnings = expressionWarnings;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingAdmissionPolicy.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingAdmissionPolicy.java
index f10813eaa3f..6406045faae 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingAdmissionPolicy.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingAdmissionPolicy.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ValidatingAdmissionPolicy describes the definition of an admission validation policy that accepts or rejects an object without changing it.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ValidatingAdmissionPolicy implements Editable<ValidatingAdmissionPolicyBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "admissionregistration.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ValidatingAdmissionPolicy";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public ValidatingAdmissionPolicy(String apiVersion, String kind, ObjectMeta meta
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ValidatingAdmissionPolicy describes the definition of an admission validation policy that accepts or rejects an object without changing it.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ValidatingAdmissionPolicy describes the definition of an admission validation policy that accepts or rejects an object without changing it.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ValidatingAdmissionPolicy describes the definition of an admission validation policy that accepts or rejects an object without changing it.
+     */
     @JsonProperty("spec")
     public ValidatingAdmissionPolicySpec getSpec() {
         return spec;
     }
 
+    /**
+     * ValidatingAdmissionPolicy describes the definition of an admission validation policy that accepts or rejects an object without changing it.
+     */
     @JsonProperty("spec")
     public void setSpec(ValidatingAdmissionPolicySpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ValidatingAdmissionPolicy describes the definition of an admission validation policy that accepts or rejects an object without changing it.
+     */
     @JsonProperty("status")
     public ValidatingAdmissionPolicyStatus getStatus() {
         return status;
     }
 
+    /**
+     * ValidatingAdmissionPolicy describes the definition of an admission validation policy that accepts or rejects an object without changing it.
+     */
     @JsonProperty("status")
     public void setStatus(ValidatingAdmissionPolicyStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingAdmissionPolicyBinding.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingAdmissionPolicyBinding.java
index fa6010569de..6d1b94d79a7 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingAdmissionPolicyBinding.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingAdmissionPolicyBinding.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ValidatingAdmissionPolicyBinding binds the ValidatingAdmissionPolicy with paramerized resources. ValidatingAdmissionPolicyBinding and parameter CRDs together define how cluster administrators configure policies for clusters.<br><p> <br><p> For a given admission request, each binding will cause its policy to be evaluated N times, where N is 1 for policies/bindings that don't use params, otherwise N is the number of parameters selected by the binding.<br><p> <br><p> The CEL expressions of a policy must have a computed CEL cost below the maximum CEL budget. Each evaluation of the policy is given an independent CEL cost budget. Adding/removing policies, bindings, or params can not affect whether a given (policy, binding, param) combination is within its own CEL budget.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class ValidatingAdmissionPolicyBinding implements Editable<ValidatingAdmissionPolicyBindingBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "admissionregistration.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ValidatingAdmissionPolicyBinding";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public ValidatingAdmissionPolicyBinding(String apiVersion, String kind, ObjectMe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ValidatingAdmissionPolicyBinding binds the ValidatingAdmissionPolicy with paramerized resources. ValidatingAdmissionPolicyBinding and parameter CRDs together define how cluster administrators configure policies for clusters.<br><p> <br><p> For a given admission request, each binding will cause its policy to be evaluated N times, where N is 1 for policies/bindings that don't use params, otherwise N is the number of parameters selected by the binding.<br><p> <br><p> The CEL expressions of a policy must have a computed CEL cost below the maximum CEL budget. Each evaluation of the policy is given an independent CEL cost budget. Adding/removing policies, bindings, or params can not affect whether a given (policy, binding, param) combination is within its own CEL budget.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ValidatingAdmissionPolicyBinding binds the ValidatingAdmissionPolicy with paramerized resources. ValidatingAdmissionPolicyBinding and parameter CRDs together define how cluster administrators configure policies for clusters.<br><p> <br><p> For a given admission request, each binding will cause its policy to be evaluated N times, where N is 1 for policies/bindings that don't use params, otherwise N is the number of parameters selected by the binding.<br><p> <br><p> The CEL expressions of a policy must have a computed CEL cost below the maximum CEL budget. Each evaluation of the policy is given an independent CEL cost budget. Adding/removing policies, bindings, or params can not affect whether a given (policy, binding, param) combination is within its own CEL budget.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ValidatingAdmissionPolicyBinding binds the ValidatingAdmissionPolicy with paramerized resources. ValidatingAdmissionPolicyBinding and parameter CRDs together define how cluster administrators configure policies for clusters.<br><p> <br><p> For a given admission request, each binding will cause its policy to be evaluated N times, where N is 1 for policies/bindings that don't use params, otherwise N is the number of parameters selected by the binding.<br><p> <br><p> The CEL expressions of a policy must have a computed CEL cost below the maximum CEL budget. Each evaluation of the policy is given an independent CEL cost budget. Adding/removing policies, bindings, or params can not affect whether a given (policy, binding, param) combination is within its own CEL budget.
+     */
     @JsonProperty("spec")
     public ValidatingAdmissionPolicyBindingSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ValidatingAdmissionPolicyBinding binds the ValidatingAdmissionPolicy with paramerized resources. ValidatingAdmissionPolicyBinding and parameter CRDs together define how cluster administrators configure policies for clusters.<br><p> <br><p> For a given admission request, each binding will cause its policy to be evaluated N times, where N is 1 for policies/bindings that don't use params, otherwise N is the number of parameters selected by the binding.<br><p> <br><p> The CEL expressions of a policy must have a computed CEL cost below the maximum CEL budget. Each evaluation of the policy is given an independent CEL cost budget. Adding/removing policies, bindings, or params can not affect whether a given (policy, binding, param) combination is within its own CEL budget.
+     */
     @JsonProperty("spec")
     public void setSpec(ValidatingAdmissionPolicyBindingSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingAdmissionPolicyBindingList.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingAdmissionPolicyBindingList.java
index 511708d1165..f67dfdb8862 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingAdmissionPolicyBindingList.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingAdmissionPolicyBindingList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ValidatingAdmissionPolicyBindingList is a list of ValidatingAdmissionPolicyBinding.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ValidatingAdmissionPolicyBindingList implements Editable<ValidatingAdmissionPolicyBindingListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.admissionregistration.v1beta1.ValidatingAdmissionPolicyBinding>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "admissionregistration.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.admissionregistration.v1beta1.ValidatingAdmissionPolicyBinding> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ValidatingAdmissionPolicyBindingList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ValidatingAdmissionPolicyBindingList(String apiVersion, List<io.fabric8.k
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of PolicyBinding.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.admissionregistration.v1beta1.ValidatingAdmissionPolicyBinding> getItems() {
         return items;
     }
 
+    /**
+     * List of PolicyBinding.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.admissionregistration.v1beta1.ValidatingAdmissionPolicyBinding> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ValidatingAdmissionPolicyBindingList is a list of ValidatingAdmissionPolicyBinding.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ValidatingAdmissionPolicyBindingList is a list of ValidatingAdmissionPolicyBinding.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingAdmissionPolicyBindingSpec.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingAdmissionPolicyBindingSpec.java
index c81f6154670..9dcb8a033fc 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingAdmissionPolicyBindingSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingAdmissionPolicyBindingSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ValidatingAdmissionPolicyBindingSpec is the specification of the ValidatingAdmissionPolicyBinding.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public ValidatingAdmissionPolicyBindingSpec(MatchResources matchResources, Param
         this.validationActions = validationActions;
     }
 
+    /**
+     * ValidatingAdmissionPolicyBindingSpec is the specification of the ValidatingAdmissionPolicyBinding.
+     */
     @JsonProperty("matchResources")
     public MatchResources getMatchResources() {
         return matchResources;
     }
 
+    /**
+     * ValidatingAdmissionPolicyBindingSpec is the specification of the ValidatingAdmissionPolicyBinding.
+     */
     @JsonProperty("matchResources")
     public void setMatchResources(MatchResources matchResources) {
         this.matchResources = matchResources;
     }
 
+    /**
+     * ValidatingAdmissionPolicyBindingSpec is the specification of the ValidatingAdmissionPolicyBinding.
+     */
     @JsonProperty("paramRef")
     public ParamRef getParamRef() {
         return paramRef;
     }
 
+    /**
+     * ValidatingAdmissionPolicyBindingSpec is the specification of the ValidatingAdmissionPolicyBinding.
+     */
     @JsonProperty("paramRef")
     public void setParamRef(ParamRef paramRef) {
         this.paramRef = paramRef;
     }
 
+    /**
+     * PolicyName references a ValidatingAdmissionPolicy name which the ValidatingAdmissionPolicyBinding binds to. If the referenced resource does not exist, this binding is considered invalid and will be ignored Required.
+     */
     @JsonProperty("policyName")
     public String getPolicyName() {
         return policyName;
     }
 
+    /**
+     * PolicyName references a ValidatingAdmissionPolicy name which the ValidatingAdmissionPolicyBinding binds to. If the referenced resource does not exist, this binding is considered invalid and will be ignored Required.
+     */
     @JsonProperty("policyName")
     public void setPolicyName(String policyName) {
         this.policyName = policyName;
     }
 
+    /**
+     * validationActions declares how Validations of the referenced ValidatingAdmissionPolicy are enforced. If a validation evaluates to false it is always enforced according to these actions.<br><p> <br><p> Failures defined by the ValidatingAdmissionPolicy's FailurePolicy are enforced according to these actions only if the FailurePolicy is set to Fail, otherwise the failures are ignored. This includes compilation errors, runtime errors and misconfigurations of the policy.<br><p> <br><p> validationActions is declared as a set of action values. Order does not matter. validationActions may not contain duplicates of the same action.<br><p> <br><p> The supported actions values are:<br><p> <br><p> "Deny" specifies that a validation failure results in a denied request.<br><p> <br><p> "Warn" specifies that a validation failure is reported to the request client in HTTP Warning headers, with a warning code of 299. Warnings can be sent both for allowed or denied admission responses.<br><p> <br><p> "Audit" specifies that a validation failure is included in the published audit event for the request. The audit event will contain a `validation.policy.admission.k8s.io/validation_failure` audit annotation with a value containing the details of the validation failures, formatted as a JSON list of objects, each with the following fields: - message: The validation failure message string - policy: The resource name of the ValidatingAdmissionPolicy - binding: The resource name of the ValidatingAdmissionPolicyBinding - expressionIndex: The index of the failed validations in the ValidatingAdmissionPolicy - validationActions: The enforcement actions enacted for the validation failure Example audit annotation: `"validation.policy.admission.k8s.io/validation_failure": "[{\"message\": \"Invalid value\", {\"policy\": \"policy.example.com\", {\"binding\": \"policybinding.example.com\", {\"expressionIndex\": \"1\", {\"validationActions\": [\"Audit\"]}]"`<br><p> <br><p> Clients should expect to handle additional values by ignoring any values not recognized.<br><p> <br><p> "Deny" and "Warn" may not be used together since this combination needlessly duplicates the validation failure both in the API response body and the HTTP warning headers.<br><p> <br><p> Required.
+     */
     @JsonProperty("validationActions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getValidationActions() {
         return validationActions;
     }
 
+    /**
+     * validationActions declares how Validations of the referenced ValidatingAdmissionPolicy are enforced. If a validation evaluates to false it is always enforced according to these actions.<br><p> <br><p> Failures defined by the ValidatingAdmissionPolicy's FailurePolicy are enforced according to these actions only if the FailurePolicy is set to Fail, otherwise the failures are ignored. This includes compilation errors, runtime errors and misconfigurations of the policy.<br><p> <br><p> validationActions is declared as a set of action values. Order does not matter. validationActions may not contain duplicates of the same action.<br><p> <br><p> The supported actions values are:<br><p> <br><p> "Deny" specifies that a validation failure results in a denied request.<br><p> <br><p> "Warn" specifies that a validation failure is reported to the request client in HTTP Warning headers, with a warning code of 299. Warnings can be sent both for allowed or denied admission responses.<br><p> <br><p> "Audit" specifies that a validation failure is included in the published audit event for the request. The audit event will contain a `validation.policy.admission.k8s.io/validation_failure` audit annotation with a value containing the details of the validation failures, formatted as a JSON list of objects, each with the following fields: - message: The validation failure message string - policy: The resource name of the ValidatingAdmissionPolicy - binding: The resource name of the ValidatingAdmissionPolicyBinding - expressionIndex: The index of the failed validations in the ValidatingAdmissionPolicy - validationActions: The enforcement actions enacted for the validation failure Example audit annotation: `"validation.policy.admission.k8s.io/validation_failure": "[{\"message\": \"Invalid value\", {\"policy\": \"policy.example.com\", {\"binding\": \"policybinding.example.com\", {\"expressionIndex\": \"1\", {\"validationActions\": [\"Audit\"]}]"`<br><p> <br><p> Clients should expect to handle additional values by ignoring any values not recognized.<br><p> <br><p> "Deny" and "Warn" may not be used together since this combination needlessly duplicates the validation failure both in the API response body and the HTTP warning headers.<br><p> <br><p> Required.
+     */
     @JsonProperty("validationActions")
     public void setValidationActions(List<String> validationActions) {
         this.validationActions = validationActions;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingAdmissionPolicyList.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingAdmissionPolicyList.java
index 7b39d030863..3a91c7cba5b 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingAdmissionPolicyList.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingAdmissionPolicyList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ValidatingAdmissionPolicyList is a list of ValidatingAdmissionPolicy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ValidatingAdmissionPolicyList implements Editable<ValidatingAdmissionPolicyListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.admissionregistration.v1beta1.ValidatingAdmissionPolicy>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "admissionregistration.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.admissionregistration.v1beta1.ValidatingAdmissionPolicy> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ValidatingAdmissionPolicyList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ValidatingAdmissionPolicyList(String apiVersion, List<io.fabric8.kubernet
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of ValidatingAdmissionPolicy.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.admissionregistration.v1beta1.ValidatingAdmissionPolicy> getItems() {
         return items;
     }
 
+    /**
+     * List of ValidatingAdmissionPolicy.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.admissionregistration.v1beta1.ValidatingAdmissionPolicy> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ValidatingAdmissionPolicyList is a list of ValidatingAdmissionPolicy.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ValidatingAdmissionPolicyList is a list of ValidatingAdmissionPolicy.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingAdmissionPolicySpec.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingAdmissionPolicySpec.java
index c793bd6cfb0..4e7f3702311 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingAdmissionPolicySpec.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingAdmissionPolicySpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ValidatingAdmissionPolicySpec is the specification of the desired behavior of the AdmissionPolicy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -108,75 +111,117 @@ public ValidatingAdmissionPolicySpec(List<AuditAnnotation> auditAnnotations, Str
         this.variables = variables;
     }
 
+    /**
+     * auditAnnotations contains CEL expressions which are used to produce audit annotations for the audit event of the API request. validations and auditAnnotations may not both be empty; a least one of validations or auditAnnotations is required.
+     */
     @JsonProperty("auditAnnotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AuditAnnotation> getAuditAnnotations() {
         return auditAnnotations;
     }
 
+    /**
+     * auditAnnotations contains CEL expressions which are used to produce audit annotations for the audit event of the API request. validations and auditAnnotations may not both be empty; a least one of validations or auditAnnotations is required.
+     */
     @JsonProperty("auditAnnotations")
     public void setAuditAnnotations(List<AuditAnnotation> auditAnnotations) {
         this.auditAnnotations = auditAnnotations;
     }
 
+    /**
+     * failurePolicy defines how to handle failures for the admission policy. Failures can occur from CEL expression parse errors, type check errors, runtime errors and invalid or mis-configured policy definitions or bindings.<br><p> <br><p> A policy is invalid if spec.paramKind refers to a non-existent Kind. A binding is invalid if spec.paramRef.name refers to a non-existent resource.<br><p> <br><p> failurePolicy does not define how validations that evaluate to false are handled.<br><p> <br><p> When failurePolicy is set to Fail, ValidatingAdmissionPolicyBinding validationActions define how failures are enforced.<br><p> <br><p> Allowed values are Ignore or Fail. Defaults to Fail.
+     */
     @JsonProperty("failurePolicy")
     public String getFailurePolicy() {
         return failurePolicy;
     }
 
+    /**
+     * failurePolicy defines how to handle failures for the admission policy. Failures can occur from CEL expression parse errors, type check errors, runtime errors and invalid or mis-configured policy definitions or bindings.<br><p> <br><p> A policy is invalid if spec.paramKind refers to a non-existent Kind. A binding is invalid if spec.paramRef.name refers to a non-existent resource.<br><p> <br><p> failurePolicy does not define how validations that evaluate to false are handled.<br><p> <br><p> When failurePolicy is set to Fail, ValidatingAdmissionPolicyBinding validationActions define how failures are enforced.<br><p> <br><p> Allowed values are Ignore or Fail. Defaults to Fail.
+     */
     @JsonProperty("failurePolicy")
     public void setFailurePolicy(String failurePolicy) {
         this.failurePolicy = failurePolicy;
     }
 
+    /**
+     * MatchConditions is a list of conditions that must be met for a request to be validated. Match conditions filter requests that have already been matched by the rules, namespaceSelector, and objectSelector. An empty list of matchConditions matches all requests. There are a maximum of 64 match conditions allowed.<br><p> <br><p> If a parameter object is provided, it can be accessed via the `params` handle in the same manner as validation expressions.<br><p> <br><p> The exact matching logic is (in order):<br><p>   1. If ANY matchCondition evaluates to FALSE, the policy is skipped.<br><p>   2. If ALL matchConditions evaluate to TRUE, the policy is evaluated.<br><p>   3. If any matchCondition evaluates to an error (but none are FALSE):<br><p>      - If failurePolicy=Fail, reject the request<br><p>      - If failurePolicy=Ignore, the policy is skipped
+     */
     @JsonProperty("matchConditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MatchCondition> getMatchConditions() {
         return matchConditions;
     }
 
+    /**
+     * MatchConditions is a list of conditions that must be met for a request to be validated. Match conditions filter requests that have already been matched by the rules, namespaceSelector, and objectSelector. An empty list of matchConditions matches all requests. There are a maximum of 64 match conditions allowed.<br><p> <br><p> If a parameter object is provided, it can be accessed via the `params` handle in the same manner as validation expressions.<br><p> <br><p> The exact matching logic is (in order):<br><p>   1. If ANY matchCondition evaluates to FALSE, the policy is skipped.<br><p>   2. If ALL matchConditions evaluate to TRUE, the policy is evaluated.<br><p>   3. If any matchCondition evaluates to an error (but none are FALSE):<br><p>      - If failurePolicy=Fail, reject the request<br><p>      - If failurePolicy=Ignore, the policy is skipped
+     */
     @JsonProperty("matchConditions")
     public void setMatchConditions(List<MatchCondition> matchConditions) {
         this.matchConditions = matchConditions;
     }
 
+    /**
+     * ValidatingAdmissionPolicySpec is the specification of the desired behavior of the AdmissionPolicy.
+     */
     @JsonProperty("matchConstraints")
     public MatchResources getMatchConstraints() {
         return matchConstraints;
     }
 
+    /**
+     * ValidatingAdmissionPolicySpec is the specification of the desired behavior of the AdmissionPolicy.
+     */
     @JsonProperty("matchConstraints")
     public void setMatchConstraints(MatchResources matchConstraints) {
         this.matchConstraints = matchConstraints;
     }
 
+    /**
+     * ValidatingAdmissionPolicySpec is the specification of the desired behavior of the AdmissionPolicy.
+     */
     @JsonProperty("paramKind")
     public ParamKind getParamKind() {
         return paramKind;
     }
 
+    /**
+     * ValidatingAdmissionPolicySpec is the specification of the desired behavior of the AdmissionPolicy.
+     */
     @JsonProperty("paramKind")
     public void setParamKind(ParamKind paramKind) {
         this.paramKind = paramKind;
     }
 
+    /**
+     * Validations contain CEL expressions which is used to apply the validation. Validations and AuditAnnotations may not both be empty; a minimum of one Validations or AuditAnnotations is required.
+     */
     @JsonProperty("validations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Validation> getValidations() {
         return validations;
     }
 
+    /**
+     * Validations contain CEL expressions which is used to apply the validation. Validations and AuditAnnotations may not both be empty; a minimum of one Validations or AuditAnnotations is required.
+     */
     @JsonProperty("validations")
     public void setValidations(List<Validation> validations) {
         this.validations = validations;
     }
 
+    /**
+     * Variables contain definitions of variables that can be used in composition of other expressions. Each variable is defined as a named CEL expression. The variables defined here will be available under `variables` in other expressions of the policy except MatchConditions because MatchConditions are evaluated before the rest of the policy.<br><p> <br><p> The expression of a variable can refer to other variables defined earlier in the list but not those after. Thus, Variables must be sorted by the order of first appearance and acyclic.
+     */
     @JsonProperty("variables")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Variable> getVariables() {
         return variables;
     }
 
+    /**
+     * Variables contain definitions of variables that can be used in composition of other expressions. Each variable is defined as a named CEL expression. The variables defined here will be available under `variables` in other expressions of the policy except MatchConditions because MatchConditions are evaluated before the rest of the policy.<br><p> <br><p> The expression of a variable can refer to other variables defined earlier in the list but not those after. Thus, Variables must be sorted by the order of first appearance and acyclic.
+     */
     @JsonProperty("variables")
     public void setVariables(List<Variable> variables) {
         this.variables = variables;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingAdmissionPolicyStatus.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingAdmissionPolicyStatus.java
index f80fbffa1ea..02b1409ca0f 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingAdmissionPolicyStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingAdmissionPolicyStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ValidatingAdmissionPolicyStatus represents the status of an admission validation policy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,32 +93,50 @@ public ValidatingAdmissionPolicyStatus(List<Condition> conditions, Long observed
         this.typeChecking = typeChecking;
     }
 
+    /**
+     * The conditions represent the latest available observations of a policy's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * The conditions represent the latest available observations of a policy's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * The generation observed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * The generation observed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * ValidatingAdmissionPolicyStatus represents the status of an admission validation policy.
+     */
     @JsonProperty("typeChecking")
     public TypeChecking getTypeChecking() {
         return typeChecking;
     }
 
+    /**
+     * ValidatingAdmissionPolicyStatus represents the status of an admission validation policy.
+     */
     @JsonProperty("typeChecking")
     public void setTypeChecking(TypeChecking typeChecking) {
         this.typeChecking = typeChecking;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingWebhook.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingWebhook.java
index d72f1cb6b90..a13bac05e86 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingWebhook.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingWebhook.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ValidatingWebhook describes an admission webhook and the resources and operations it applies to.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -118,103 +121,163 @@ public ValidatingWebhook(List<String> admissionReviewVersions, WebhookClientConf
         this.timeoutSeconds = timeoutSeconds;
     }
 
+    /**
+     * AdmissionReviewVersions is an ordered list of preferred `AdmissionReview` versions the Webhook expects. API server will try to use first version in the list which it supports. If none of the versions specified in this list supported by API server, validation will fail for this object. If a persisted webhook configuration specifies allowed versions and does not include any versions known to the API Server, calls to the webhook will fail and be subject to the failure policy. Default to `['v1beta1']`.
+     */
     @JsonProperty("admissionReviewVersions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAdmissionReviewVersions() {
         return admissionReviewVersions;
     }
 
+    /**
+     * AdmissionReviewVersions is an ordered list of preferred `AdmissionReview` versions the Webhook expects. API server will try to use first version in the list which it supports. If none of the versions specified in this list supported by API server, validation will fail for this object. If a persisted webhook configuration specifies allowed versions and does not include any versions known to the API Server, calls to the webhook will fail and be subject to the failure policy. Default to `['v1beta1']`.
+     */
     @JsonProperty("admissionReviewVersions")
     public void setAdmissionReviewVersions(List<String> admissionReviewVersions) {
         this.admissionReviewVersions = admissionReviewVersions;
     }
 
+    /**
+     * ValidatingWebhook describes an admission webhook and the resources and operations it applies to.
+     */
     @JsonProperty("clientConfig")
     public WebhookClientConfig getClientConfig() {
         return clientConfig;
     }
 
+    /**
+     * ValidatingWebhook describes an admission webhook and the resources and operations it applies to.
+     */
     @JsonProperty("clientConfig")
     public void setClientConfig(WebhookClientConfig clientConfig) {
         this.clientConfig = clientConfig;
     }
 
+    /**
+     * FailurePolicy defines how unrecognized errors from the admission endpoint are handled - allowed values are Ignore or Fail. Defaults to Ignore.
+     */
     @JsonProperty("failurePolicy")
     public String getFailurePolicy() {
         return failurePolicy;
     }
 
+    /**
+     * FailurePolicy defines how unrecognized errors from the admission endpoint are handled - allowed values are Ignore or Fail. Defaults to Ignore.
+     */
     @JsonProperty("failurePolicy")
     public void setFailurePolicy(String failurePolicy) {
         this.failurePolicy = failurePolicy;
     }
 
+    /**
+     * matchPolicy defines how the "rules" list is used to match incoming requests. Allowed values are "Exact" or "Equivalent".<br><p> <br><p> - Exact: match a request only if it exactly matches a specified rule. For example, if deployments can be modified via apps/v1, apps/v1beta1, and extensions/v1beta1, but "rules" only included `apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]`, a request to apps/v1beta1 or extensions/v1beta1 would not be sent to the webhook.<br><p> <br><p> - Equivalent: match a request if modifies a resource listed in rules, even via another API group or version. For example, if deployments can be modified via apps/v1, apps/v1beta1, and extensions/v1beta1, and "rules" only included `apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]`, a request to apps/v1beta1 or extensions/v1beta1 would be converted to apps/v1 and sent to the webhook.<br><p> <br><p> Defaults to "Exact"
+     */
     @JsonProperty("matchPolicy")
     public String getMatchPolicy() {
         return matchPolicy;
     }
 
+    /**
+     * matchPolicy defines how the "rules" list is used to match incoming requests. Allowed values are "Exact" or "Equivalent".<br><p> <br><p> - Exact: match a request only if it exactly matches a specified rule. For example, if deployments can be modified via apps/v1, apps/v1beta1, and extensions/v1beta1, but "rules" only included `apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]`, a request to apps/v1beta1 or extensions/v1beta1 would not be sent to the webhook.<br><p> <br><p> - Equivalent: match a request if modifies a resource listed in rules, even via another API group or version. For example, if deployments can be modified via apps/v1, apps/v1beta1, and extensions/v1beta1, and "rules" only included `apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]`, a request to apps/v1beta1 or extensions/v1beta1 would be converted to apps/v1 and sent to the webhook.<br><p> <br><p> Defaults to "Exact"
+     */
     @JsonProperty("matchPolicy")
     public void setMatchPolicy(String matchPolicy) {
         this.matchPolicy = matchPolicy;
     }
 
+    /**
+     * The name of the admission webhook. Name should be fully qualified, e.g., imagepolicy.kubernetes.io, where "imagepolicy" is the name of the webhook, and kubernetes.io is the name of the organization. Required.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The name of the admission webhook. Name should be fully qualified, e.g., imagepolicy.kubernetes.io, where "imagepolicy" is the name of the webhook, and kubernetes.io is the name of the organization. Required.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * ValidatingWebhook describes an admission webhook and the resources and operations it applies to.
+     */
     @JsonProperty("namespaceSelector")
     public LabelSelector getNamespaceSelector() {
         return namespaceSelector;
     }
 
+    /**
+     * ValidatingWebhook describes an admission webhook and the resources and operations it applies to.
+     */
     @JsonProperty("namespaceSelector")
     public void setNamespaceSelector(LabelSelector namespaceSelector) {
         this.namespaceSelector = namespaceSelector;
     }
 
+    /**
+     * ValidatingWebhook describes an admission webhook and the resources and operations it applies to.
+     */
     @JsonProperty("objectSelector")
     public LabelSelector getObjectSelector() {
         return objectSelector;
     }
 
+    /**
+     * ValidatingWebhook describes an admission webhook and the resources and operations it applies to.
+     */
     @JsonProperty("objectSelector")
     public void setObjectSelector(LabelSelector objectSelector) {
         this.objectSelector = objectSelector;
     }
 
+    /**
+     * Rules describes what operations on what resources/subresources the webhook cares about. The webhook cares about an operation if it matches _any_ Rule. However, in order to prevent ValidatingAdmissionWebhooks and MutatingAdmissionWebhooks from putting the cluster in a state which cannot be recovered from without completely disabling the plugin, ValidatingAdmissionWebhooks and MutatingAdmissionWebhooks are never called on admission requests for ValidatingWebhookConfiguration and MutatingWebhookConfiguration objects.
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RuleWithOperations> getRules() {
         return rules;
     }
 
+    /**
+     * Rules describes what operations on what resources/subresources the webhook cares about. The webhook cares about an operation if it matches _any_ Rule. However, in order to prevent ValidatingAdmissionWebhooks and MutatingAdmissionWebhooks from putting the cluster in a state which cannot be recovered from without completely disabling the plugin, ValidatingAdmissionWebhooks and MutatingAdmissionWebhooks are never called on admission requests for ValidatingWebhookConfiguration and MutatingWebhookConfiguration objects.
+     */
     @JsonProperty("rules")
     public void setRules(List<RuleWithOperations> rules) {
         this.rules = rules;
     }
 
+    /**
+     * SideEffects states whether this webhook has side effects. Acceptable values are: Unknown, None, Some, NoneOnDryRun Webhooks with side effects MUST implement a reconciliation system, since a request may be rejected by a future step in the admission chain and the side effects therefore need to be undone. Requests with the dryRun attribute will be auto-rejected if they match a webhook with sideEffects == Unknown or Some. Defaults to Unknown.
+     */
     @JsonProperty("sideEffects")
     public String getSideEffects() {
         return sideEffects;
     }
 
+    /**
+     * SideEffects states whether this webhook has side effects. Acceptable values are: Unknown, None, Some, NoneOnDryRun Webhooks with side effects MUST implement a reconciliation system, since a request may be rejected by a future step in the admission chain and the side effects therefore need to be undone. Requests with the dryRun attribute will be auto-rejected if they match a webhook with sideEffects == Unknown or Some. Defaults to Unknown.
+     */
     @JsonProperty("sideEffects")
     public void setSideEffects(String sideEffects) {
         this.sideEffects = sideEffects;
     }
 
+    /**
+     * TimeoutSeconds specifies the timeout for this webhook. After the timeout passes, the webhook call will be ignored or the API call will fail based on the failure policy. The timeout value must be between 1 and 30 seconds. Default to 30 seconds.
+     */
     @JsonProperty("timeoutSeconds")
     public Integer getTimeoutSeconds() {
         return timeoutSeconds;
     }
 
+    /**
+     * TimeoutSeconds specifies the timeout for this webhook. After the timeout passes, the webhook call will be ignored or the API call will fail based on the failure policy. The timeout value must be between 1 and 30 seconds. Default to 30 seconds.
+     */
     @JsonProperty("timeoutSeconds")
     public void setTimeoutSeconds(Integer timeoutSeconds) {
         this.timeoutSeconds = timeoutSeconds;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingWebhookConfiguration.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingWebhookConfiguration.java
index e30936459a0..fb32a74d827 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingWebhookConfiguration.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingWebhookConfiguration.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ValidatingWebhookConfiguration describes the configuration of and admission webhook that accept or reject and object without changing it. Deprecated in v1.16, planned for removal in v1.19. Use admissionregistration.k8s.io/v1 ValidatingWebhookConfiguration instead.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class ValidatingWebhookConfiguration implements Editable<ValidatingWebhookConfigurationBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "admissionregistration.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ValidatingWebhookConfiguration";
     @JsonProperty("metadata")
@@ -109,7 +106,7 @@ public ValidatingWebhookConfiguration(String apiVersion, String kind, ObjectMeta
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -117,7 +114,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -125,7 +122,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -133,29 +130,41 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ValidatingWebhookConfiguration describes the configuration of and admission webhook that accept or reject and object without changing it. Deprecated in v1.16, planned for removal in v1.19. Use admissionregistration.k8s.io/v1 ValidatingWebhookConfiguration instead.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ValidatingWebhookConfiguration describes the configuration of and admission webhook that accept or reject and object without changing it. Deprecated in v1.16, planned for removal in v1.19. Use admissionregistration.k8s.io/v1 ValidatingWebhookConfiguration instead.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Webhooks is a list of webhooks and the affected resources and operations.
+     */
     @JsonProperty("webhooks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ValidatingWebhook> getWebhooks() {
         return webhooks;
     }
 
+    /**
+     * Webhooks is a list of webhooks and the affected resources and operations.
+     */
     @JsonProperty("webhooks")
     public void setWebhooks(List<ValidatingWebhook> webhooks) {
         this.webhooks = webhooks;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingWebhookConfigurationList.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingWebhookConfigurationList.java
index fba0670cc85..3e47e7df85d 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingWebhookConfigurationList.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/ValidatingWebhookConfigurationList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ValidatingWebhookConfigurationList is a list of ValidatingWebhookConfiguration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ValidatingWebhookConfigurationList implements Editable<ValidatingWebhookConfigurationListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.admissionregistration.v1beta1.ValidatingWebhookConfiguration>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "admissionregistration.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.admissionregistration.v1beta1.ValidatingWebhookConfiguration> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ValidatingWebhookConfigurationList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ValidatingWebhookConfigurationList(String apiVersion, List<io.fabric8.kub
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of ValidatingWebhookConfiguration.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.admissionregistration.v1beta1.ValidatingWebhookConfiguration> getItems() {
         return items;
     }
 
+    /**
+     * List of ValidatingWebhookConfiguration.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.admissionregistration.v1beta1.ValidatingWebhookConfiguration> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ValidatingWebhookConfigurationList is a list of ValidatingWebhookConfiguration.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ValidatingWebhookConfigurationList is a list of ValidatingWebhookConfiguration.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/Validation.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/Validation.java
index 85aa65b4202..3fe6d35c71e 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/Validation.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/Validation.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Validation specifies the CEL expression which is used to apply the validation.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public Validation(String expression, String message, String messageExpression, S
         this.reason = reason;
     }
 
+    /**
+     * Expression represents the expression which will be evaluated by CEL. ref: https://github.com/google/cel-spec CEL expressions have access to the contents of the API request/response, organized into CEL variables as well as some other useful variables:<br><p> <br><p> - 'object' - The object from the incoming request. The value is null for DELETE requests. - 'oldObject' - The existing object. The value is null for CREATE requests. - 'request' - Attributes of the API request([ref](/pkg/apis/admission/types.go#AdmissionRequest)). - 'params' - Parameter resource referred to by the policy binding being evaluated. Only populated if the policy has a ParamKind. - 'namespaceObject' - The namespace object that the incoming object belongs to. The value is null for cluster-scoped resources. - 'variables' - Map of composited variables, from its name to its lazily evaluated value.<br><p>   For example, a variable named 'foo' can be accessed as 'variables.foo'.<br><p> - 'authorizer' - A CEL Authorizer. May be used to perform authorization checks for the principal (user or service account) of the request.<br><p>   See https://pkg.go.dev/k8s.io/apiserver/pkg/cel/library#Authz<br><p> - 'authorizer.requestResource' - A CEL ResourceCheck constructed from the 'authorizer' and configured with the<br><p>   request resource.<br><p> <br><p> The `apiVersion`, `kind`, `metadata.name` and `metadata.generateName` are always accessible from the root of the object. No other metadata properties are accessible.<br><p> <br><p> Only property names of the form `[a-zA-Z_.-/][a-zA-Z0-9_.-/]&#42;` are accessible. Accessible property names are escaped according to the following rules when accessed in the expression: - '__' escapes to '__underscores__' - '.' escapes to '__dot__' - '-' escapes to '__dash__' - '/' escapes to '__slash__' - Property names that exactly match a CEL RESERVED keyword escape to '__{keyword}__'. The keywords are:<br><p> 	  "true", "false", "null", "in", "as", "break", "const", "continue", "else", "for", "function", "if",<br><p> 	  "import", "let", "loop", "package", "namespace", "return".<br><p> Examples:<br><p>   - Expression accessing a property named "namespace": {"Expression": "object.__namespace__ &gt; 0"}<br><p>   - Expression accessing a property named "x-prop": {"Expression": "object.x__dash__prop &gt; 0"}<br><p>   - Expression accessing a property named "redact__d": {"Expression": "object.redact__underscores__d &gt; 0"}<br><p> <br><p> Equality on arrays with list type of 'set' or 'map' ignores element order, i.e. [1, 2] == [2, 1]. Concatenation on arrays with x-kubernetes-list-type use the semantics of the list type:<br><p>   - 'set': `X + Y` performs a union where the array positions of all elements in `X` are preserved and<br><p>     non-intersecting elements in `Y` are appended, retaining their partial order.<br><p>   - 'map': `X + Y` performs a merge where the array positions of all keys in `X` are preserved but the values<br><p>     are overwritten by values in `Y` when the key sets of `X` and `Y` intersect. Elements in `Y` with<br><p>     non-intersecting keys are appended, retaining their partial order.<br><p> Required.
+     */
     @JsonProperty("expression")
     public String getExpression() {
         return expression;
     }
 
+    /**
+     * Expression represents the expression which will be evaluated by CEL. ref: https://github.com/google/cel-spec CEL expressions have access to the contents of the API request/response, organized into CEL variables as well as some other useful variables:<br><p> <br><p> - 'object' - The object from the incoming request. The value is null for DELETE requests. - 'oldObject' - The existing object. The value is null for CREATE requests. - 'request' - Attributes of the API request([ref](/pkg/apis/admission/types.go#AdmissionRequest)). - 'params' - Parameter resource referred to by the policy binding being evaluated. Only populated if the policy has a ParamKind. - 'namespaceObject' - The namespace object that the incoming object belongs to. The value is null for cluster-scoped resources. - 'variables' - Map of composited variables, from its name to its lazily evaluated value.<br><p>   For example, a variable named 'foo' can be accessed as 'variables.foo'.<br><p> - 'authorizer' - A CEL Authorizer. May be used to perform authorization checks for the principal (user or service account) of the request.<br><p>   See https://pkg.go.dev/k8s.io/apiserver/pkg/cel/library#Authz<br><p> - 'authorizer.requestResource' - A CEL ResourceCheck constructed from the 'authorizer' and configured with the<br><p>   request resource.<br><p> <br><p> The `apiVersion`, `kind`, `metadata.name` and `metadata.generateName` are always accessible from the root of the object. No other metadata properties are accessible.<br><p> <br><p> Only property names of the form `[a-zA-Z_.-/][a-zA-Z0-9_.-/]&#42;` are accessible. Accessible property names are escaped according to the following rules when accessed in the expression: - '__' escapes to '__underscores__' - '.' escapes to '__dot__' - '-' escapes to '__dash__' - '/' escapes to '__slash__' - Property names that exactly match a CEL RESERVED keyword escape to '__{keyword}__'. The keywords are:<br><p> 	  "true", "false", "null", "in", "as", "break", "const", "continue", "else", "for", "function", "if",<br><p> 	  "import", "let", "loop", "package", "namespace", "return".<br><p> Examples:<br><p>   - Expression accessing a property named "namespace": {"Expression": "object.__namespace__ &gt; 0"}<br><p>   - Expression accessing a property named "x-prop": {"Expression": "object.x__dash__prop &gt; 0"}<br><p>   - Expression accessing a property named "redact__d": {"Expression": "object.redact__underscores__d &gt; 0"}<br><p> <br><p> Equality on arrays with list type of 'set' or 'map' ignores element order, i.e. [1, 2] == [2, 1]. Concatenation on arrays with x-kubernetes-list-type use the semantics of the list type:<br><p>   - 'set': `X + Y` performs a union where the array positions of all elements in `X` are preserved and<br><p>     non-intersecting elements in `Y` are appended, retaining their partial order.<br><p>   - 'map': `X + Y` performs a merge where the array positions of all keys in `X` are preserved but the values<br><p>     are overwritten by values in `Y` when the key sets of `X` and `Y` intersect. Elements in `Y` with<br><p>     non-intersecting keys are appended, retaining their partial order.<br><p> Required.
+     */
     @JsonProperty("expression")
     public void setExpression(String expression) {
         this.expression = expression;
     }
 
+    /**
+     * Message represents the message displayed when validation fails. The message is required if the Expression contains line breaks. The message must not contain line breaks. If unset, the message is "failed rule: {Rule}". e.g. "must be a URL with the host matching spec.host" If the Expression contains line breaks. Message is required. The message must not contain line breaks. If unset, the message is "failed Expression: {Expression}".
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message represents the message displayed when validation fails. The message is required if the Expression contains line breaks. The message must not contain line breaks. If unset, the message is "failed rule: {Rule}". e.g. "must be a URL with the host matching spec.host" If the Expression contains line breaks. Message is required. The message must not contain line breaks. If unset, the message is "failed Expression: {Expression}".
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * messageExpression declares a CEL expression that evaluates to the validation failure message that is returned when this rule fails. Since messageExpression is used as a failure message, it must evaluate to a string. If both message and messageExpression are present on a validation, then messageExpression will be used if validation fails. If messageExpression results in a runtime error, the runtime error is logged, and the validation failure message is produced as if the messageExpression field were unset. If messageExpression evaluates to an empty string, a string with only spaces, or a string that contains line breaks, then the validation failure message will also be produced as if the messageExpression field were unset, and the fact that messageExpression produced an empty string/string with only spaces/string with line breaks will be logged. messageExpression has access to all the same variables as the `expression` except for 'authorizer' and 'authorizer.requestResource'. Example: "object.x must be less than max ("+string(params.max)+")"
+     */
     @JsonProperty("messageExpression")
     public String getMessageExpression() {
         return messageExpression;
     }
 
+    /**
+     * messageExpression declares a CEL expression that evaluates to the validation failure message that is returned when this rule fails. Since messageExpression is used as a failure message, it must evaluate to a string. If both message and messageExpression are present on a validation, then messageExpression will be used if validation fails. If messageExpression results in a runtime error, the runtime error is logged, and the validation failure message is produced as if the messageExpression field were unset. If messageExpression evaluates to an empty string, a string with only spaces, or a string that contains line breaks, then the validation failure message will also be produced as if the messageExpression field were unset, and the fact that messageExpression produced an empty string/string with only spaces/string with line breaks will be logged. messageExpression has access to all the same variables as the `expression` except for 'authorizer' and 'authorizer.requestResource'. Example: "object.x must be less than max ("+string(params.max)+")"
+     */
     @JsonProperty("messageExpression")
     public void setMessageExpression(String messageExpression) {
         this.messageExpression = messageExpression;
     }
 
+    /**
+     * Reason represents a machine-readable description of why this validation failed. If this is the first validation in the list to fail, this reason, as well as the corresponding HTTP response code, are used in the HTTP response to the client. The currently supported reasons are: "Unauthorized", "Forbidden", "Invalid", "RequestEntityTooLarge". If not set, StatusReasonInvalid is used in the response to the client.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason represents a machine-readable description of why this validation failed. If this is the first validation in the list to fail, this reason, as well as the corresponding HTTP response code, are used in the HTTP response to the client. The currently supported reasons are: "Unauthorized", "Forbidden", "Invalid", "RequestEntityTooLarge". If not set, StatusReasonInvalid is used in the response to the client.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/Variable.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/Variable.java
index 1ee2ecb8ee7..33500ca64d7 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/Variable.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/Variable.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Variable is the definition of a variable that is used for composition. A variable is defined as a named expression.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Variable(String expression, String name) {
         this.name = name;
     }
 
+    /**
+     * Expression is the expression that will be evaluated as the value of the variable. The CEL expression has access to the same identifiers as the CEL expressions in Validation.
+     */
     @JsonProperty("expression")
     public String getExpression() {
         return expression;
     }
 
+    /**
+     * Expression is the expression that will be evaluated as the value of the variable. The CEL expression has access to the same identifiers as the CEL expressions in Validation.
+     */
     @JsonProperty("expression")
     public void setExpression(String expression) {
         this.expression = expression;
     }
 
+    /**
+     * Name is the name of the variable. The name must be a valid CEL identifier and unique among all variables. The variable can be accessed in other expressions through `variables` For example, if name is "foo", the variable will be available as `variables.foo`
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the variable. The name must be a valid CEL identifier and unique among all variables. The variable can be accessed in other expressions through `variables` For example, if name is "foo", the variable will be available as `variables.foo`
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/WebhookClientConfig.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/WebhookClientConfig.java
index d7ab3b9a094..6e4e6b0bd02 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/WebhookClientConfig.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/admissionregistration/v1beta1/WebhookClientConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WebhookClientConfig contains the information to make a TLS connection with the webhook
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public WebhookClientConfig(String caBundle, ServiceReference service, String url
         this.url = url;
     }
 
+    /**
+     * `caBundle` is a PEM encoded CA bundle which will be used to validate the webhook's server certificate. If unspecified, system trust roots on the apiserver are used.
+     */
     @JsonProperty("caBundle")
     public String getCaBundle() {
         return caBundle;
     }
 
+    /**
+     * `caBundle` is a PEM encoded CA bundle which will be used to validate the webhook's server certificate. If unspecified, system trust roots on the apiserver are used.
+     */
     @JsonProperty("caBundle")
     public void setCaBundle(String caBundle) {
         this.caBundle = caBundle;
     }
 
+    /**
+     * WebhookClientConfig contains the information to make a TLS connection with the webhook
+     */
     @JsonProperty("service")
     public ServiceReference getService() {
         return service;
     }
 
+    /**
+     * WebhookClientConfig contains the information to make a TLS connection with the webhook
+     */
     @JsonProperty("service")
     public void setService(ServiceReference service) {
         this.service = service;
     }
 
+    /**
+     * `url` gives the location of the webhook, in standard URL form (`scheme://host:port/path`). Exactly one of `url` or `service` must be specified.<br><p> <br><p> The `host` should not refer to a service running in the cluster; use the `service` field instead. The host might be resolved via external DNS in some apiservers (e.g., `kube-apiserver` cannot resolve in-cluster DNS as that would be a layering violation). `host` may also be an IP address.<br><p> <br><p> Please note that using `localhost` or `127.0.0.1` as a `host` is risky unless you take great care to run this webhook on all hosts which run an apiserver which might need to make calls to this webhook. Such installs are likely to be non-portable, i.e., not easy to turn up in a new cluster.<br><p> <br><p> The scheme must be "https"; the URL must begin with "https://".<br><p> <br><p> A path is optional, and if present may be any string permissible in a URL. You may use the path to pass an arbitrary string to the webhook, for example, a cluster identifier.<br><p> <br><p> Attempting to use a user or basic auth e.g. "user:password@" is not allowed. Fragments ("#...") and query parameters ("?...") are not allowed, either.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * `url` gives the location of the webhook, in standard URL form (`scheme://host:port/path`). Exactly one of `url` or `service` must be specified.<br><p> <br><p> The `host` should not refer to a service running in the cluster; use the `service` field instead. The host might be resolved via external DNS in some apiservers (e.g., `kube-apiserver` cannot resolve in-cluster DNS as that would be a layering violation). `host` may also be an IP address.<br><p> <br><p> Please note that using `localhost` or `127.0.0.1` as a `host` is risky unless you take great care to run this webhook on all hosts which run an apiserver which might need to make calls to this webhook. Such installs are likely to be non-portable, i.e., not easy to turn up in a new cluster.<br><p> <br><p> The scheme must be "https"; the URL must begin with "https://".<br><p> <br><p> A path is optional, and if present may be any string permissible in a URL. You may use the path to pass an arbitrary string to the webhook, for example, a cluster identifier.<br><p> <br><p> Attempting to use a user or basic auth e.g. "user:password@" is not allowed. Fragments ("#...") and query parameters ("?...") are not allowed, either.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/BoundObjectReference.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/BoundObjectReference.java
index 3fd60f6b589..dacdf29caa0 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/BoundObjectReference.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/BoundObjectReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BoundObjectReference is a reference to an object that a token is bound to.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public BoundObjectReference(String apiVersion, String kind, String name, String
         this.uid = uid;
     }
 
+    /**
+     * API version of the referent.
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * API version of the referent.
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Kind of the referent. Valid kinds are 'Pod' and 'Secret'.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind of the referent. Valid kinds are 'Pod' and 'Secret'.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name of the referent.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referent.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * UID of the referent.
+     */
     @JsonProperty("uid")
     public String getUid() {
         return uid;
     }
 
+    /**
+     * UID of the referent.
+     */
     @JsonProperty("uid")
     public void setUid(String uid) {
         this.uid = uid;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/SelfSubjectReview.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/SelfSubjectReview.java
index 44aa66a3412..522be438d7a 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/SelfSubjectReview.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/SelfSubjectReview.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SelfSubjectReview contains the user information that the kube-apiserver has about the user making this request. When using impersonation, users will receive the user info of the user being impersonated.  If impersonation or request header authentication is used, any extra keys will have their case ignored and returned as lowercase.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class SelfSubjectReview implements Editable<SelfSubjectReviewBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authentication.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SelfSubjectReview";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public SelfSubjectReview(String apiVersion, String kind, ObjectMeta metadata, Se
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SelfSubjectReview contains the user information that the kube-apiserver has about the user making this request. When using impersonation, users will receive the user info of the user being impersonated.  If impersonation or request header authentication is used, any extra keys will have their case ignored and returned as lowercase.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SelfSubjectReview contains the user information that the kube-apiserver has about the user making this request. When using impersonation, users will receive the user info of the user being impersonated.  If impersonation or request header authentication is used, any extra keys will have their case ignored and returned as lowercase.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * SelfSubjectReview contains the user information that the kube-apiserver has about the user making this request. When using impersonation, users will receive the user info of the user being impersonated.  If impersonation or request header authentication is used, any extra keys will have their case ignored and returned as lowercase.
+     */
     @JsonProperty("status")
     public SelfSubjectReviewStatus getStatus() {
         return status;
     }
 
+    /**
+     * SelfSubjectReview contains the user information that the kube-apiserver has about the user making this request. When using impersonation, users will receive the user info of the user being impersonated.  If impersonation or request header authentication is used, any extra keys will have their case ignored and returned as lowercase.
+     */
     @JsonProperty("status")
     public void setStatus(SelfSubjectReviewStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/SelfSubjectReviewStatus.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/SelfSubjectReviewStatus.java
index 3b7f4b00db0..dc56690fb46 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/SelfSubjectReviewStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/SelfSubjectReviewStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SelfSubjectReviewStatus is filled by the kube-apiserver and sent back to a user.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public SelfSubjectReviewStatus(UserInfo userInfo) {
         this.userInfo = userInfo;
     }
 
+    /**
+     * SelfSubjectReviewStatus is filled by the kube-apiserver and sent back to a user.
+     */
     @JsonProperty("userInfo")
     public UserInfo getUserInfo() {
         return userInfo;
     }
 
+    /**
+     * SelfSubjectReviewStatus is filled by the kube-apiserver and sent back to a user.
+     */
     @JsonProperty("userInfo")
     public void setUserInfo(UserInfo userInfo) {
         this.userInfo = userInfo;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/TokenRequest.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/TokenRequest.java
index a8f10848926..d2f22c47437 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/TokenRequest.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/TokenRequest.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TokenRequest requests a token for a given service account.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class TokenRequest implements Editable<TokenRequestBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authentication.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TokenRequest";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TokenRequest(String apiVersion, String kind, ObjectMeta metadata, TokenRe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TokenRequest requests a token for a given service account.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TokenRequest requests a token for a given service account.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * TokenRequest requests a token for a given service account.
+     */
     @JsonProperty("spec")
     public TokenRequestSpec getSpec() {
         return spec;
     }
 
+    /**
+     * TokenRequest requests a token for a given service account.
+     */
     @JsonProperty("spec")
     public void setSpec(TokenRequestSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * TokenRequest requests a token for a given service account.
+     */
     @JsonProperty("status")
     public TokenRequestStatus getStatus() {
         return status;
     }
 
+    /**
+     * TokenRequest requests a token for a given service account.
+     */
     @JsonProperty("status")
     public void setStatus(TokenRequestStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/TokenRequestSpec.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/TokenRequestSpec.java
index 087669e268c..b5c5ee7ecd4 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/TokenRequestSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/TokenRequestSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TokenRequestSpec contains client provided parameters of a token request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public TokenRequestSpec(List<String> audiences, BoundObjectReference boundObject
         this.expirationSeconds = expirationSeconds;
     }
 
+    /**
+     * Audiences are the intendend audiences of the token. A recipient of a token must identify themself with an identifier in the list of audiences of the token, and otherwise should reject the token. A token issued for multiple audiences may be used to authenticate against any of the audiences listed but implies a high degree of trust between the target audiences.
+     */
     @JsonProperty("audiences")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAudiences() {
         return audiences;
     }
 
+    /**
+     * Audiences are the intendend audiences of the token. A recipient of a token must identify themself with an identifier in the list of audiences of the token, and otherwise should reject the token. A token issued for multiple audiences may be used to authenticate against any of the audiences listed but implies a high degree of trust between the target audiences.
+     */
     @JsonProperty("audiences")
     public void setAudiences(List<String> audiences) {
         this.audiences = audiences;
     }
 
+    /**
+     * TokenRequestSpec contains client provided parameters of a token request.
+     */
     @JsonProperty("boundObjectRef")
     public BoundObjectReference getBoundObjectRef() {
         return boundObjectRef;
     }
 
+    /**
+     * TokenRequestSpec contains client provided parameters of a token request.
+     */
     @JsonProperty("boundObjectRef")
     public void setBoundObjectRef(BoundObjectReference boundObjectRef) {
         this.boundObjectRef = boundObjectRef;
     }
 
+    /**
+     * ExpirationSeconds is the requested duration of validity of the request. The token issuer may return a token with a different validity duration so a client needs to check the 'expiration' field in a response.
+     */
     @JsonProperty("expirationSeconds")
     public Long getExpirationSeconds() {
         return expirationSeconds;
     }
 
+    /**
+     * ExpirationSeconds is the requested duration of validity of the request. The token issuer may return a token with a different validity duration so a client needs to check the 'expiration' field in a response.
+     */
     @JsonProperty("expirationSeconds")
     public void setExpirationSeconds(Long expirationSeconds) {
         this.expirationSeconds = expirationSeconds;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/TokenRequestStatus.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/TokenRequestStatus.java
index c1e0d28f608..7aedf9c34bd 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/TokenRequestStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/TokenRequestStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TokenRequestStatus is the result of a token request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public TokenRequestStatus(String expirationTimestamp, String token) {
         this.token = token;
     }
 
+    /**
+     * TokenRequestStatus is the result of a token request.
+     */
     @JsonProperty("expirationTimestamp")
     public String getExpirationTimestamp() {
         return expirationTimestamp;
     }
 
+    /**
+     * TokenRequestStatus is the result of a token request.
+     */
     @JsonProperty("expirationTimestamp")
     public void setExpirationTimestamp(String expirationTimestamp) {
         this.expirationTimestamp = expirationTimestamp;
     }
 
+    /**
+     * Token is the opaque bearer token.
+     */
     @JsonProperty("token")
     public String getToken() {
         return token;
     }
 
+    /**
+     * Token is the opaque bearer token.
+     */
     @JsonProperty("token")
     public void setToken(String token) {
         this.token = token;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/TokenReview.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/TokenReview.java
index 6fd5e95eeb0..86c2c6ea560 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/TokenReview.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/TokenReview.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TokenReview attempts to authenticate a token to a known user. Note: TokenReview requests may be cached by the webhook token authenticator plugin in the kube-apiserver.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class TokenReview implements Editable<TokenReviewBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authentication.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TokenReview";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public TokenReview(String apiVersion, String kind, ObjectMeta metadata, TokenRev
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TokenReview attempts to authenticate a token to a known user. Note: TokenReview requests may be cached by the webhook token authenticator plugin in the kube-apiserver.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TokenReview attempts to authenticate a token to a known user. Note: TokenReview requests may be cached by the webhook token authenticator plugin in the kube-apiserver.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * TokenReview attempts to authenticate a token to a known user. Note: TokenReview requests may be cached by the webhook token authenticator plugin in the kube-apiserver.
+     */
     @JsonProperty("spec")
     public TokenReviewSpec getSpec() {
         return spec;
     }
 
+    /**
+     * TokenReview attempts to authenticate a token to a known user. Note: TokenReview requests may be cached by the webhook token authenticator plugin in the kube-apiserver.
+     */
     @JsonProperty("spec")
     public void setSpec(TokenReviewSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * TokenReview attempts to authenticate a token to a known user. Note: TokenReview requests may be cached by the webhook token authenticator plugin in the kube-apiserver.
+     */
     @JsonProperty("status")
     public TokenReviewStatus getStatus() {
         return status;
     }
 
+    /**
+     * TokenReview attempts to authenticate a token to a known user. Note: TokenReview requests may be cached by the webhook token authenticator plugin in the kube-apiserver.
+     */
     @JsonProperty("status")
     public void setStatus(TokenReviewStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/TokenReviewSpec.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/TokenReviewSpec.java
index 5e29dda0a39..5a4bc85ae3e 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/TokenReviewSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/TokenReviewSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TokenReviewSpec is a description of the token authentication request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public TokenReviewSpec(List<String> audiences, String token) {
         this.token = token;
     }
 
+    /**
+     * Audiences is a list of the identifiers that the resource server presented with the token identifies as. Audience-aware token authenticators will verify that the token was intended for at least one of the audiences in this list. If no audiences are provided, the audience will default to the audience of the Kubernetes apiserver.
+     */
     @JsonProperty("audiences")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAudiences() {
         return audiences;
     }
 
+    /**
+     * Audiences is a list of the identifiers that the resource server presented with the token identifies as. Audience-aware token authenticators will verify that the token was intended for at least one of the audiences in this list. If no audiences are provided, the audience will default to the audience of the Kubernetes apiserver.
+     */
     @JsonProperty("audiences")
     public void setAudiences(List<String> audiences) {
         this.audiences = audiences;
     }
 
+    /**
+     * Token is the opaque bearer token.
+     */
     @JsonProperty("token")
     public String getToken() {
         return token;
     }
 
+    /**
+     * Token is the opaque bearer token.
+     */
     @JsonProperty("token")
     public void setToken(String token) {
         this.token = token;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/TokenReviewStatus.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/TokenReviewStatus.java
index 791f78a450a..657af0b6a05 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/TokenReviewStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/TokenReviewStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TokenReviewStatus is the result of the token authentication request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public TokenReviewStatus(List<String> audiences, Boolean authenticated, String e
         this.user = user;
     }
 
+    /**
+     * Audiences are audience identifiers chosen by the authenticator that are compatible with both the TokenReview and token. An identifier is any identifier in the intersection of the TokenReviewSpec audiences and the token's audiences. A client of the TokenReview API that sets the spec.audiences field should validate that a compatible audience identifier is returned in the status.audiences field to ensure that the TokenReview server is audience aware. If a TokenReview returns an empty status.audience field where status.authenticated is "true", the token is valid against the audience of the Kubernetes API server.
+     */
     @JsonProperty("audiences")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAudiences() {
         return audiences;
     }
 
+    /**
+     * Audiences are audience identifiers chosen by the authenticator that are compatible with both the TokenReview and token. An identifier is any identifier in the intersection of the TokenReviewSpec audiences and the token's audiences. A client of the TokenReview API that sets the spec.audiences field should validate that a compatible audience identifier is returned in the status.audiences field to ensure that the TokenReview server is audience aware. If a TokenReview returns an empty status.audience field where status.authenticated is "true", the token is valid against the audience of the Kubernetes API server.
+     */
     @JsonProperty("audiences")
     public void setAudiences(List<String> audiences) {
         this.audiences = audiences;
     }
 
+    /**
+     * Authenticated indicates that the token was associated with a known user.
+     */
     @JsonProperty("authenticated")
     public Boolean getAuthenticated() {
         return authenticated;
     }
 
+    /**
+     * Authenticated indicates that the token was associated with a known user.
+     */
     @JsonProperty("authenticated")
     public void setAuthenticated(Boolean authenticated) {
         this.authenticated = authenticated;
     }
 
+    /**
+     * Error indicates that the token couldn't be checked
+     */
     @JsonProperty("error")
     public String getError() {
         return error;
     }
 
+    /**
+     * Error indicates that the token couldn't be checked
+     */
     @JsonProperty("error")
     public void setError(String error) {
         this.error = error;
     }
 
+    /**
+     * TokenReviewStatus is the result of the token authentication request.
+     */
     @JsonProperty("user")
     public UserInfo getUser() {
         return user;
     }
 
+    /**
+     * TokenReviewStatus is the result of the token authentication request.
+     */
     @JsonProperty("user")
     public void setUser(UserInfo user) {
         this.user = user;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/v1beta1/SelfSubjectReview.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/v1beta1/SelfSubjectReview.java
index 3c68ad7a783..dc359c43632 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/v1beta1/SelfSubjectReview.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/v1beta1/SelfSubjectReview.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SelfSubjectReview contains the user information that the kube-apiserver has about the user making this request. When using impersonation, users will receive the user info of the user being impersonated.  If impersonation or request header authentication is used, any extra keys will have their case ignored and returned as lowercase.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class SelfSubjectReview implements Editable<SelfSubjectReviewBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authentication.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SelfSubjectReview";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public SelfSubjectReview(String apiVersion, String kind, ObjectMeta metadata, Se
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SelfSubjectReview contains the user information that the kube-apiserver has about the user making this request. When using impersonation, users will receive the user info of the user being impersonated.  If impersonation or request header authentication is used, any extra keys will have their case ignored and returned as lowercase.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SelfSubjectReview contains the user information that the kube-apiserver has about the user making this request. When using impersonation, users will receive the user info of the user being impersonated.  If impersonation or request header authentication is used, any extra keys will have their case ignored and returned as lowercase.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * SelfSubjectReview contains the user information that the kube-apiserver has about the user making this request. When using impersonation, users will receive the user info of the user being impersonated.  If impersonation or request header authentication is used, any extra keys will have their case ignored and returned as lowercase.
+     */
     @JsonProperty("status")
     public SelfSubjectReviewStatus getStatus() {
         return status;
     }
 
+    /**
+     * SelfSubjectReview contains the user information that the kube-apiserver has about the user making this request. When using impersonation, users will receive the user info of the user being impersonated.  If impersonation or request header authentication is used, any extra keys will have their case ignored and returned as lowercase.
+     */
     @JsonProperty("status")
     public void setStatus(SelfSubjectReviewStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/v1beta1/SelfSubjectReviewStatus.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/v1beta1/SelfSubjectReviewStatus.java
index 842c0d99eed..cff5ced4734 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/v1beta1/SelfSubjectReviewStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/v1beta1/SelfSubjectReviewStatus.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SelfSubjectReviewStatus is filled by the kube-apiserver and sent back to a user.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,11 +82,17 @@ public SelfSubjectReviewStatus(UserInfo userInfo) {
         this.userInfo = userInfo;
     }
 
+    /**
+     * SelfSubjectReviewStatus is filled by the kube-apiserver and sent back to a user.
+     */
     @JsonProperty("userInfo")
     public UserInfo getUserInfo() {
         return userInfo;
     }
 
+    /**
+     * SelfSubjectReviewStatus is filled by the kube-apiserver and sent back to a user.
+     */
     @JsonProperty("userInfo")
     public void setUserInfo(UserInfo userInfo) {
         this.userInfo = userInfo;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/v1beta1/TokenReview.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/v1beta1/TokenReview.java
index 3257b2bbf8a..325cd238eda 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/v1beta1/TokenReview.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/v1beta1/TokenReview.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TokenReview attempts to authenticate a token to a known user. Note: TokenReview requests may be cached by the webhook token authenticator plugin in the kube-apiserver.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class TokenReview implements Editable<TokenReviewBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authentication.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TokenReview";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public TokenReview(String apiVersion, String kind, ObjectMeta metadata, TokenRev
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TokenReview attempts to authenticate a token to a known user. Note: TokenReview requests may be cached by the webhook token authenticator plugin in the kube-apiserver.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TokenReview attempts to authenticate a token to a known user. Note: TokenReview requests may be cached by the webhook token authenticator plugin in the kube-apiserver.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * TokenReview attempts to authenticate a token to a known user. Note: TokenReview requests may be cached by the webhook token authenticator plugin in the kube-apiserver.
+     */
     @JsonProperty("spec")
     public TokenReviewSpec getSpec() {
         return spec;
     }
 
+    /**
+     * TokenReview attempts to authenticate a token to a known user. Note: TokenReview requests may be cached by the webhook token authenticator plugin in the kube-apiserver.
+     */
     @JsonProperty("spec")
     public void setSpec(TokenReviewSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * TokenReview attempts to authenticate a token to a known user. Note: TokenReview requests may be cached by the webhook token authenticator plugin in the kube-apiserver.
+     */
     @JsonProperty("status")
     public TokenReviewStatus getStatus() {
         return status;
     }
 
+    /**
+     * TokenReview attempts to authenticate a token to a known user. Note: TokenReview requests may be cached by the webhook token authenticator plugin in the kube-apiserver.
+     */
     @JsonProperty("status")
     public void setStatus(TokenReviewStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/v1beta1/TokenReviewSpec.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/v1beta1/TokenReviewSpec.java
index 1d261db672e..1efcc99b1e1 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/v1beta1/TokenReviewSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/v1beta1/TokenReviewSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TokenReviewSpec is a description of the token authentication request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public TokenReviewSpec(List<String> audiences, String token) {
         this.token = token;
     }
 
+    /**
+     * Audiences is a list of the identifiers that the resource server presented with the token identifies as. Audience-aware token authenticators will verify that the token was intended for at least one of the audiences in this list. If no audiences are provided, the audience will default to the audience of the Kubernetes apiserver.
+     */
     @JsonProperty("audiences")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAudiences() {
         return audiences;
     }
 
+    /**
+     * Audiences is a list of the identifiers that the resource server presented with the token identifies as. Audience-aware token authenticators will verify that the token was intended for at least one of the audiences in this list. If no audiences are provided, the audience will default to the audience of the Kubernetes apiserver.
+     */
     @JsonProperty("audiences")
     public void setAudiences(List<String> audiences) {
         this.audiences = audiences;
     }
 
+    /**
+     * Token is the opaque bearer token.
+     */
     @JsonProperty("token")
     public String getToken() {
         return token;
     }
 
+    /**
+     * Token is the opaque bearer token.
+     */
     @JsonProperty("token")
     public void setToken(String token) {
         this.token = token;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/v1beta1/TokenReviewStatus.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/v1beta1/TokenReviewStatus.java
index a8d2f403725..287682ccb9e 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/v1beta1/TokenReviewStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/v1beta1/TokenReviewStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TokenReviewStatus is the result of the token authentication request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public TokenReviewStatus(List<String> audiences, Boolean authenticated, String e
         this.user = user;
     }
 
+    /**
+     * Audiences are audience identifiers chosen by the authenticator that are compatible with both the TokenReview and token. An identifier is any identifier in the intersection of the TokenReviewSpec audiences and the token's audiences. A client of the TokenReview API that sets the spec.audiences field should validate that a compatible audience identifier is returned in the status.audiences field to ensure that the TokenReview server is audience aware. If a TokenReview returns an empty status.audience field where status.authenticated is "true", the token is valid against the audience of the Kubernetes API server.
+     */
     @JsonProperty("audiences")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAudiences() {
         return audiences;
     }
 
+    /**
+     * Audiences are audience identifiers chosen by the authenticator that are compatible with both the TokenReview and token. An identifier is any identifier in the intersection of the TokenReviewSpec audiences and the token's audiences. A client of the TokenReview API that sets the spec.audiences field should validate that a compatible audience identifier is returned in the status.audiences field to ensure that the TokenReview server is audience aware. If a TokenReview returns an empty status.audience field where status.authenticated is "true", the token is valid against the audience of the Kubernetes API server.
+     */
     @JsonProperty("audiences")
     public void setAudiences(List<String> audiences) {
         this.audiences = audiences;
     }
 
+    /**
+     * Authenticated indicates that the token was associated with a known user.
+     */
     @JsonProperty("authenticated")
     public Boolean getAuthenticated() {
         return authenticated;
     }
 
+    /**
+     * Authenticated indicates that the token was associated with a known user.
+     */
     @JsonProperty("authenticated")
     public void setAuthenticated(Boolean authenticated) {
         this.authenticated = authenticated;
     }
 
+    /**
+     * Error indicates that the token couldn't be checked
+     */
     @JsonProperty("error")
     public String getError() {
         return error;
     }
 
+    /**
+     * Error indicates that the token couldn't be checked
+     */
     @JsonProperty("error")
     public void setError(String error) {
         this.error = error;
     }
 
+    /**
+     * TokenReviewStatus is the result of the token authentication request.
+     */
     @JsonProperty("user")
     public UserInfo getUser() {
         return user;
     }
 
+    /**
+     * TokenReviewStatus is the result of the token authentication request.
+     */
     @JsonProperty("user")
     public void setUser(UserInfo user) {
         this.user = user;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/v1beta1/UserInfo.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/v1beta1/UserInfo.java
index f27b4eaad26..e7850cf8e10 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/v1beta1/UserInfo.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authentication/v1beta1/UserInfo.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UserInfo holds the information about the user needed to implement the user.Info interface.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,43 +97,67 @@ public UserInfo(Map<String, List<String>> extra, List<String> groups, String uid
         this.username = username;
     }
 
+    /**
+     * Any additional information provided by the authenticator.
+     */
     @JsonProperty("extra")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<String>> getExtra() {
         return extra;
     }
 
+    /**
+     * Any additional information provided by the authenticator.
+     */
     @JsonProperty("extra")
     public void setExtra(Map<String, List<String>> extra) {
         this.extra = extra;
     }
 
+    /**
+     * The names of groups this user is a part of.
+     */
     @JsonProperty("groups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getGroups() {
         return groups;
     }
 
+    /**
+     * The names of groups this user is a part of.
+     */
     @JsonProperty("groups")
     public void setGroups(List<String> groups) {
         this.groups = groups;
     }
 
+    /**
+     * A unique value that identifies this user across time. If this user is deleted and another user by the same name is added, they will have different UIDs.
+     */
     @JsonProperty("uid")
     public String getUid() {
         return uid;
     }
 
+    /**
+     * A unique value that identifies this user across time. If this user is deleted and another user by the same name is added, they will have different UIDs.
+     */
     @JsonProperty("uid")
     public void setUid(String uid) {
         this.uid = uid;
     }
 
+    /**
+     * The name that uniquely identifies this user among all active users.
+     */
     @JsonProperty("username")
     public String getUsername() {
         return username;
     }
 
+    /**
+     * The name that uniquely identifies this user among all active users.
+     */
     @JsonProperty("username")
     public void setUsername(String username) {
         this.username = username;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/FieldSelectorAttributes.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/FieldSelectorAttributes.java
index 166d40c27c4..df9e0eb13a2 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/FieldSelectorAttributes.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/FieldSelectorAttributes.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FieldSelectorAttributes indicates a field limited access. Webhook authors are encouraged to &#42; ensure rawSelector and requirements are not both set &#42; consider the requirements field if set &#42; not try to parse or consider the rawSelector field if set. This is to avoid another CVE-2022-2880 (i.e. getting different systems to agree on how exactly to parse a query is not something we want), see https://www.oxeye.io/resources/golang-parameter-smuggling-attack for more details. For the &#42;SubjectAccessReview endpoints of the kube-apiserver: &#42; If rawSelector is empty and requirements are empty, the request is not limited. &#42; If rawSelector is present and requirements are empty, the rawSelector will be parsed and limited if the parsing succeeds. &#42; If rawSelector is empty and requirements are present, the requirements should be honored &#42; If rawSelector is present and requirements are present, the request is invalid.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,22 +89,34 @@ public FieldSelectorAttributes(String rawSelector, List<FieldSelectorRequirement
         this.requirements = requirements;
     }
 
+    /**
+     * rawSelector is the serialization of a field selector that would be included in a query parameter. Webhook implementations are encouraged to ignore rawSelector. The kube-apiserver's &#42;SubjectAccessReview will parse the rawSelector as long as the requirements are not present.
+     */
     @JsonProperty("rawSelector")
     public String getRawSelector() {
         return rawSelector;
     }
 
+    /**
+     * rawSelector is the serialization of a field selector that would be included in a query parameter. Webhook implementations are encouraged to ignore rawSelector. The kube-apiserver's &#42;SubjectAccessReview will parse the rawSelector as long as the requirements are not present.
+     */
     @JsonProperty("rawSelector")
     public void setRawSelector(String rawSelector) {
         this.rawSelector = rawSelector;
     }
 
+    /**
+     * requirements is the parsed interpretation of a field selector. All requirements must be met for a resource instance to match the selector. Webhook implementations should handle requirements, but how to handle them is up to the webhook. Since requirements can only limit the request, it is safe to authorize as unlimited request if the requirements are not understood.
+     */
     @JsonProperty("requirements")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<FieldSelectorRequirement> getRequirements() {
         return requirements;
     }
 
+    /**
+     * requirements is the parsed interpretation of a field selector. All requirements must be met for a resource instance to match the selector. Webhook implementations should handle requirements, but how to handle them is up to the webhook. Since requirements can only limit the request, it is safe to authorize as unlimited request if the requirements are not understood.
+     */
     @JsonProperty("requirements")
     public void setRequirements(List<FieldSelectorRequirement> requirements) {
         this.requirements = requirements;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/LabelSelectorAttributes.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/LabelSelectorAttributes.java
index 50600ba7e79..8da2a58476c 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/LabelSelectorAttributes.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/LabelSelectorAttributes.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LabelSelectorAttributes indicates a label limited access. Webhook authors are encouraged to &#42; ensure rawSelector and requirements are not both set &#42; consider the requirements field if set &#42; not try to parse or consider the rawSelector field if set. This is to avoid another CVE-2022-2880 (i.e. getting different systems to agree on how exactly to parse a query is not something we want), see https://www.oxeye.io/resources/golang-parameter-smuggling-attack for more details. For the &#42;SubjectAccessReview endpoints of the kube-apiserver: &#42; If rawSelector is empty and requirements are empty, the request is not limited. &#42; If rawSelector is present and requirements are empty, the rawSelector will be parsed and limited if the parsing succeeds. &#42; If rawSelector is empty and requirements are present, the requirements should be honored &#42; If rawSelector is present and requirements are present, the request is invalid.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,22 +89,34 @@ public LabelSelectorAttributes(String rawSelector, List<LabelSelectorRequirement
         this.requirements = requirements;
     }
 
+    /**
+     * rawSelector is the serialization of a field selector that would be included in a query parameter. Webhook implementations are encouraged to ignore rawSelector. The kube-apiserver's &#42;SubjectAccessReview will parse the rawSelector as long as the requirements are not present.
+     */
     @JsonProperty("rawSelector")
     public String getRawSelector() {
         return rawSelector;
     }
 
+    /**
+     * rawSelector is the serialization of a field selector that would be included in a query parameter. Webhook implementations are encouraged to ignore rawSelector. The kube-apiserver's &#42;SubjectAccessReview will parse the rawSelector as long as the requirements are not present.
+     */
     @JsonProperty("rawSelector")
     public void setRawSelector(String rawSelector) {
         this.rawSelector = rawSelector;
     }
 
+    /**
+     * requirements is the parsed interpretation of a label selector. All requirements must be met for a resource instance to match the selector. Webhook implementations should handle requirements, but how to handle them is up to the webhook. Since requirements can only limit the request, it is safe to authorize as unlimited request if the requirements are not understood.
+     */
     @JsonProperty("requirements")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LabelSelectorRequirement> getRequirements() {
         return requirements;
     }
 
+    /**
+     * requirements is the parsed interpretation of a label selector. All requirements must be met for a resource instance to match the selector. Webhook implementations should handle requirements, but how to handle them is up to the webhook. Since requirements can only limit the request, it is safe to authorize as unlimited request if the requirements are not understood.
+     */
     @JsonProperty("requirements")
     public void setRequirements(List<LabelSelectorRequirement> requirements) {
         this.requirements = requirements;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/LocalSubjectAccessReview.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/LocalSubjectAccessReview.java
index ef4be1170e6..e0935a24eba 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/LocalSubjectAccessReview.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/LocalSubjectAccessReview.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LocalSubjectAccessReview checks whether or not a user or group can perform an action in a given namespace. Having a namespace scoped resource makes it much easier to grant namespace scoped policy that includes permissions checking.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class LocalSubjectAccessReview implements Editable<LocalSubjectAccessReviewBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authorization.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "LocalSubjectAccessReview";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public LocalSubjectAccessReview(String apiVersion, String kind, ObjectMeta metad
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * LocalSubjectAccessReview checks whether or not a user or group can perform an action in a given namespace. Having a namespace scoped resource makes it much easier to grant namespace scoped policy that includes permissions checking.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * LocalSubjectAccessReview checks whether or not a user or group can perform an action in a given namespace. Having a namespace scoped resource makes it much easier to grant namespace scoped policy that includes permissions checking.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * LocalSubjectAccessReview checks whether or not a user or group can perform an action in a given namespace. Having a namespace scoped resource makes it much easier to grant namespace scoped policy that includes permissions checking.
+     */
     @JsonProperty("spec")
     public SubjectAccessReviewSpec getSpec() {
         return spec;
     }
 
+    /**
+     * LocalSubjectAccessReview checks whether or not a user or group can perform an action in a given namespace. Having a namespace scoped resource makes it much easier to grant namespace scoped policy that includes permissions checking.
+     */
     @JsonProperty("spec")
     public void setSpec(SubjectAccessReviewSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * LocalSubjectAccessReview checks whether or not a user or group can perform an action in a given namespace. Having a namespace scoped resource makes it much easier to grant namespace scoped policy that includes permissions checking.
+     */
     @JsonProperty("status")
     public SubjectAccessReviewStatus getStatus() {
         return status;
     }
 
+    /**
+     * LocalSubjectAccessReview checks whether or not a user or group can perform an action in a given namespace. Having a namespace scoped resource makes it much easier to grant namespace scoped policy that includes permissions checking.
+     */
     @JsonProperty("status")
     public void setStatus(SubjectAccessReviewStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/NonResourceAttributes.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/NonResourceAttributes.java
index 803ba622426..af2260d3fed 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/NonResourceAttributes.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/NonResourceAttributes.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NonResourceAttributes includes the authorization attributes available for non-resource requests to the Authorizer interface
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public NonResourceAttributes(String path, String verb) {
         this.verb = verb;
     }
 
+    /**
+     * Path is the URL path of the request
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Path is the URL path of the request
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * Verb is the standard HTTP verb
+     */
     @JsonProperty("verb")
     public String getVerb() {
         return verb;
     }
 
+    /**
+     * Verb is the standard HTTP verb
+     */
     @JsonProperty("verb")
     public void setVerb(String verb) {
         this.verb = verb;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/NonResourceRule.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/NonResourceRule.java
index bb277021773..8440679ac1c 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/NonResourceRule.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/NonResourceRule.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NonResourceRule holds information that describes a rule for the non-resource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public NonResourceRule(List<String> nonResourceURLs, List<String> verbs) {
         this.verbs = verbs;
     }
 
+    /**
+     * NonResourceURLs is a set of partial urls that a user should have access to.  &#42;s are allowed, but only as the full, final step in the path.  "&#42;" means all.
+     */
     @JsonProperty("nonResourceURLs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNonResourceURLs() {
         return nonResourceURLs;
     }
 
+    /**
+     * NonResourceURLs is a set of partial urls that a user should have access to.  &#42;s are allowed, but only as the full, final step in the path.  "&#42;" means all.
+     */
     @JsonProperty("nonResourceURLs")
     public void setNonResourceURLs(List<String> nonResourceURLs) {
         this.nonResourceURLs = nonResourceURLs;
     }
 
+    /**
+     * Verb is a list of kubernetes non-resource API verbs, like: get, post, put, delete, patch, head, options.  "&#42;" means all.
+     */
     @JsonProperty("verbs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getVerbs() {
         return verbs;
     }
 
+    /**
+     * Verb is a list of kubernetes non-resource API verbs, like: get, post, put, delete, patch, head, options.  "&#42;" means all.
+     */
     @JsonProperty("verbs")
     public void setVerbs(List<String> verbs) {
         this.verbs = verbs;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/ResourceAttributes.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/ResourceAttributes.java
index c6f4752d86b..77f2125f8d9 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/ResourceAttributes.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/ResourceAttributes.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceAttributes includes the authorization attributes available for resource requests to the Authorizer interface
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -110,91 +113,145 @@ public ResourceAttributes(FieldSelectorAttributes fieldSelector, String group, L
         this.version = version;
     }
 
+    /**
+     * ResourceAttributes includes the authorization attributes available for resource requests to the Authorizer interface
+     */
     @JsonProperty("fieldSelector")
     public FieldSelectorAttributes getFieldSelector() {
         return fieldSelector;
     }
 
+    /**
+     * ResourceAttributes includes the authorization attributes available for resource requests to the Authorizer interface
+     */
     @JsonProperty("fieldSelector")
     public void setFieldSelector(FieldSelectorAttributes fieldSelector) {
         this.fieldSelector = fieldSelector;
     }
 
+    /**
+     * Group is the API Group of the Resource.  "&#42;" means all.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * Group is the API Group of the Resource.  "&#42;" means all.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * ResourceAttributes includes the authorization attributes available for resource requests to the Authorizer interface
+     */
     @JsonProperty("labelSelector")
     public LabelSelectorAttributes getLabelSelector() {
         return labelSelector;
     }
 
+    /**
+     * ResourceAttributes includes the authorization attributes available for resource requests to the Authorizer interface
+     */
     @JsonProperty("labelSelector")
     public void setLabelSelector(LabelSelectorAttributes labelSelector) {
         this.labelSelector = labelSelector;
     }
 
+    /**
+     * Name is the name of the resource being requested for a "get" or deleted for a "delete". "" (empty) means all.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the resource being requested for a "get" or deleted for a "delete". "" (empty) means all.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace is the namespace of the action being requested.  Currently, there is no distinction between no namespace and all namespaces "" (empty) is defaulted for LocalSubjectAccessReviews "" (empty) is empty for cluster-scoped resources "" (empty) means "all" for namespace scoped resources from a SubjectAccessReview or SelfSubjectAccessReview
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace of the action being requested.  Currently, there is no distinction between no namespace and all namespaces "" (empty) is defaulted for LocalSubjectAccessReviews "" (empty) is empty for cluster-scoped resources "" (empty) means "all" for namespace scoped resources from a SubjectAccessReview or SelfSubjectAccessReview
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Resource is one of the existing resource types.  "&#42;" means all.
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * Resource is one of the existing resource types.  "&#42;" means all.
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
     }
 
+    /**
+     * Subresource is one of the existing resource types.  "" means none.
+     */
     @JsonProperty("subresource")
     public String getSubresource() {
         return subresource;
     }
 
+    /**
+     * Subresource is one of the existing resource types.  "" means none.
+     */
     @JsonProperty("subresource")
     public void setSubresource(String subresource) {
         this.subresource = subresource;
     }
 
+    /**
+     * Verb is a kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy.  "&#42;" means all.
+     */
     @JsonProperty("verb")
     public String getVerb() {
         return verb;
     }
 
+    /**
+     * Verb is a kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy.  "&#42;" means all.
+     */
     @JsonProperty("verb")
     public void setVerb(String verb) {
         this.verb = verb;
     }
 
+    /**
+     * Version is the API Version of the Resource.  "&#42;" means all.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * Version is the API Version of the Resource.  "&#42;" means all.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/ResourceRule.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/ResourceRule.java
index 121ea5d8aa3..78dc3549a4d 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/ResourceRule.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/ResourceRule.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceRule is the list of actions the subject is allowed to perform on resources. The list ordering isn't significant, may contain duplicates, and possibly be incomplete.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -96,45 +99,69 @@ public ResourceRule(List<String> apiGroups, List<String> resourceNames, List<Str
         this.verbs = verbs;
     }
 
+    /**
+     * APIGroups is the name of the APIGroup that contains the resources.  If multiple API groups are specified, any action requested against one of the enumerated resources in any API group will be allowed.  "&#42;" means all.
+     */
     @JsonProperty("apiGroups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiGroups() {
         return apiGroups;
     }
 
+    /**
+     * APIGroups is the name of the APIGroup that contains the resources.  If multiple API groups are specified, any action requested against one of the enumerated resources in any API group will be allowed.  "&#42;" means all.
+     */
     @JsonProperty("apiGroups")
     public void setApiGroups(List<String> apiGroups) {
         this.apiGroups = apiGroups;
     }
 
+    /**
+     * ResourceNames is an optional white list of names that the rule applies to.  An empty set means that everything is allowed.  "&#42;" means all.
+     */
     @JsonProperty("resourceNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getResourceNames() {
         return resourceNames;
     }
 
+    /**
+     * ResourceNames is an optional white list of names that the rule applies to.  An empty set means that everything is allowed.  "&#42;" means all.
+     */
     @JsonProperty("resourceNames")
     public void setResourceNames(List<String> resourceNames) {
         this.resourceNames = resourceNames;
     }
 
+    /**
+     * Resources is a list of resources this rule applies to.  "&#42;" means all in the specified apiGroups.<br><p>  "&#42;/foo" represents the subresource 'foo' for all resources in the specified apiGroups.
+     */
     @JsonProperty("resources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getResources() {
         return resources;
     }
 
+    /**
+     * Resources is a list of resources this rule applies to.  "&#42;" means all in the specified apiGroups.<br><p>  "&#42;/foo" represents the subresource 'foo' for all resources in the specified apiGroups.
+     */
     @JsonProperty("resources")
     public void setResources(List<String> resources) {
         this.resources = resources;
     }
 
+    /**
+     * Verb is a list of kubernetes resource API verbs, like: get, list, watch, create, update, delete, proxy.  "&#42;" means all.
+     */
     @JsonProperty("verbs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getVerbs() {
         return verbs;
     }
 
+    /**
+     * Verb is a list of kubernetes resource API verbs, like: get, list, watch, create, update, delete, proxy.  "&#42;" means all.
+     */
     @JsonProperty("verbs")
     public void setVerbs(List<String> verbs) {
         this.verbs = verbs;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SelfSubjectAccessReview.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SelfSubjectAccessReview.java
index d4b846a8abe..a990544e41e 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SelfSubjectAccessReview.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SelfSubjectAccessReview.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SelfSubjectAccessReview checks whether or the current user can perform an action.  Not filling in a spec.namespace means "in all namespaces".  Self is a special case, because users should always be able to check whether they can perform an action
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class SelfSubjectAccessReview implements Editable<SelfSubjectAccessReviewBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authorization.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SelfSubjectAccessReview";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public SelfSubjectAccessReview(String apiVersion, String kind, ObjectMeta metada
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SelfSubjectAccessReview checks whether or the current user can perform an action.  Not filling in a spec.namespace means "in all namespaces".  Self is a special case, because users should always be able to check whether they can perform an action
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SelfSubjectAccessReview checks whether or the current user can perform an action.  Not filling in a spec.namespace means "in all namespaces".  Self is a special case, because users should always be able to check whether they can perform an action
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * SelfSubjectAccessReview checks whether or the current user can perform an action.  Not filling in a spec.namespace means "in all namespaces".  Self is a special case, because users should always be able to check whether they can perform an action
+     */
     @JsonProperty("spec")
     public SelfSubjectAccessReviewSpec getSpec() {
         return spec;
     }
 
+    /**
+     * SelfSubjectAccessReview checks whether or the current user can perform an action.  Not filling in a spec.namespace means "in all namespaces".  Self is a special case, because users should always be able to check whether they can perform an action
+     */
     @JsonProperty("spec")
     public void setSpec(SelfSubjectAccessReviewSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * SelfSubjectAccessReview checks whether or the current user can perform an action.  Not filling in a spec.namespace means "in all namespaces".  Self is a special case, because users should always be able to check whether they can perform an action
+     */
     @JsonProperty("status")
     public SubjectAccessReviewStatus getStatus() {
         return status;
     }
 
+    /**
+     * SelfSubjectAccessReview checks whether or the current user can perform an action.  Not filling in a spec.namespace means "in all namespaces".  Self is a special case, because users should always be able to check whether they can perform an action
+     */
     @JsonProperty("status")
     public void setStatus(SubjectAccessReviewStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SelfSubjectAccessReviewSpec.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SelfSubjectAccessReviewSpec.java
index db950095f95..1f4ece6f66d 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SelfSubjectAccessReviewSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SelfSubjectAccessReviewSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SelfSubjectAccessReviewSpec is a description of the access request.  Exactly one of ResourceAuthorizationAttributes and NonResourceAuthorizationAttributes must be set
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public SelfSubjectAccessReviewSpec(NonResourceAttributes nonResourceAttributes,
         this.resourceAttributes = resourceAttributes;
     }
 
+    /**
+     * SelfSubjectAccessReviewSpec is a description of the access request.  Exactly one of ResourceAuthorizationAttributes and NonResourceAuthorizationAttributes must be set
+     */
     @JsonProperty("nonResourceAttributes")
     public NonResourceAttributes getNonResourceAttributes() {
         return nonResourceAttributes;
     }
 
+    /**
+     * SelfSubjectAccessReviewSpec is a description of the access request.  Exactly one of ResourceAuthorizationAttributes and NonResourceAuthorizationAttributes must be set
+     */
     @JsonProperty("nonResourceAttributes")
     public void setNonResourceAttributes(NonResourceAttributes nonResourceAttributes) {
         this.nonResourceAttributes = nonResourceAttributes;
     }
 
+    /**
+     * SelfSubjectAccessReviewSpec is a description of the access request.  Exactly one of ResourceAuthorizationAttributes and NonResourceAuthorizationAttributes must be set
+     */
     @JsonProperty("resourceAttributes")
     public ResourceAttributes getResourceAttributes() {
         return resourceAttributes;
     }
 
+    /**
+     * SelfSubjectAccessReviewSpec is a description of the access request.  Exactly one of ResourceAuthorizationAttributes and NonResourceAuthorizationAttributes must be set
+     */
     @JsonProperty("resourceAttributes")
     public void setResourceAttributes(ResourceAttributes resourceAttributes) {
         this.resourceAttributes = resourceAttributes;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SelfSubjectRulesReview.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SelfSubjectRulesReview.java
index 17eb5077b92..37082f3c496 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SelfSubjectRulesReview.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SelfSubjectRulesReview.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SelfSubjectRulesReview enumerates the set of actions the current user can perform within a namespace. The returned list of actions may be incomplete depending on the server's authorization mode, and any errors experienced during the evaluation. SelfSubjectRulesReview should be used by UIs to show/hide actions, or to quickly let an end user reason about their permissions. It should NOT Be used by external systems to drive authorization decisions as this raises confused deputy, cache lifetime/revocation, and correctness concerns. SubjectAccessReview, and LocalAccessReview are the correct way to defer authorization decisions to the API server.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class SelfSubjectRulesReview implements Editable<SelfSubjectRulesReviewBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authorization.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SelfSubjectRulesReview";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public SelfSubjectRulesReview(String apiVersion, String kind, ObjectMeta metadat
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SelfSubjectRulesReview enumerates the set of actions the current user can perform within a namespace. The returned list of actions may be incomplete depending on the server's authorization mode, and any errors experienced during the evaluation. SelfSubjectRulesReview should be used by UIs to show/hide actions, or to quickly let an end user reason about their permissions. It should NOT Be used by external systems to drive authorization decisions as this raises confused deputy, cache lifetime/revocation, and correctness concerns. SubjectAccessReview, and LocalAccessReview are the correct way to defer authorization decisions to the API server.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SelfSubjectRulesReview enumerates the set of actions the current user can perform within a namespace. The returned list of actions may be incomplete depending on the server's authorization mode, and any errors experienced during the evaluation. SelfSubjectRulesReview should be used by UIs to show/hide actions, or to quickly let an end user reason about their permissions. It should NOT Be used by external systems to drive authorization decisions as this raises confused deputy, cache lifetime/revocation, and correctness concerns. SubjectAccessReview, and LocalAccessReview are the correct way to defer authorization decisions to the API server.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * SelfSubjectRulesReview enumerates the set of actions the current user can perform within a namespace. The returned list of actions may be incomplete depending on the server's authorization mode, and any errors experienced during the evaluation. SelfSubjectRulesReview should be used by UIs to show/hide actions, or to quickly let an end user reason about their permissions. It should NOT Be used by external systems to drive authorization decisions as this raises confused deputy, cache lifetime/revocation, and correctness concerns. SubjectAccessReview, and LocalAccessReview are the correct way to defer authorization decisions to the API server.
+     */
     @JsonProperty("spec")
     public SelfSubjectRulesReviewSpec getSpec() {
         return spec;
     }
 
+    /**
+     * SelfSubjectRulesReview enumerates the set of actions the current user can perform within a namespace. The returned list of actions may be incomplete depending on the server's authorization mode, and any errors experienced during the evaluation. SelfSubjectRulesReview should be used by UIs to show/hide actions, or to quickly let an end user reason about their permissions. It should NOT Be used by external systems to drive authorization decisions as this raises confused deputy, cache lifetime/revocation, and correctness concerns. SubjectAccessReview, and LocalAccessReview are the correct way to defer authorization decisions to the API server.
+     */
     @JsonProperty("spec")
     public void setSpec(SelfSubjectRulesReviewSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * SelfSubjectRulesReview enumerates the set of actions the current user can perform within a namespace. The returned list of actions may be incomplete depending on the server's authorization mode, and any errors experienced during the evaluation. SelfSubjectRulesReview should be used by UIs to show/hide actions, or to quickly let an end user reason about their permissions. It should NOT Be used by external systems to drive authorization decisions as this raises confused deputy, cache lifetime/revocation, and correctness concerns. SubjectAccessReview, and LocalAccessReview are the correct way to defer authorization decisions to the API server.
+     */
     @JsonProperty("status")
     public SubjectRulesReviewStatus getStatus() {
         return status;
     }
 
+    /**
+     * SelfSubjectRulesReview enumerates the set of actions the current user can perform within a namespace. The returned list of actions may be incomplete depending on the server's authorization mode, and any errors experienced during the evaluation. SelfSubjectRulesReview should be used by UIs to show/hide actions, or to quickly let an end user reason about their permissions. It should NOT Be used by external systems to drive authorization decisions as this raises confused deputy, cache lifetime/revocation, and correctness concerns. SubjectAccessReview, and LocalAccessReview are the correct way to defer authorization decisions to the API server.
+     */
     @JsonProperty("status")
     public void setStatus(SubjectRulesReviewStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SelfSubjectRulesReviewSpec.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SelfSubjectRulesReviewSpec.java
index f65d3d9dd2a..fdf7a5c9aca 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SelfSubjectRulesReviewSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SelfSubjectRulesReviewSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SelfSubjectRulesReviewSpec defines the specification for SelfSubjectRulesReview.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public SelfSubjectRulesReviewSpec(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Namespace to evaluate rules for. Required.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace to evaluate rules for. Required.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SubjectAccessReview.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SubjectAccessReview.java
index 41105cefafd..7314508ded9 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SubjectAccessReview.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SubjectAccessReview.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubjectAccessReview checks whether or not a user or group can perform an action.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class SubjectAccessReview implements Editable<SubjectAccessReviewBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authorization.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SubjectAccessReview";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public SubjectAccessReview(String apiVersion, String kind, ObjectMeta metadata,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SubjectAccessReview checks whether or not a user or group can perform an action.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SubjectAccessReview checks whether or not a user or group can perform an action.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * SubjectAccessReview checks whether or not a user or group can perform an action.
+     */
     @JsonProperty("spec")
     public SubjectAccessReviewSpec getSpec() {
         return spec;
     }
 
+    /**
+     * SubjectAccessReview checks whether or not a user or group can perform an action.
+     */
     @JsonProperty("spec")
     public void setSpec(SubjectAccessReviewSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * SubjectAccessReview checks whether or not a user or group can perform an action.
+     */
     @JsonProperty("status")
     public SubjectAccessReviewStatus getStatus() {
         return status;
     }
 
+    /**
+     * SubjectAccessReview checks whether or not a user or group can perform an action.
+     */
     @JsonProperty("status")
     public void setStatus(SubjectAccessReviewStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SubjectAccessReviewSpec.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SubjectAccessReviewSpec.java
index fd4549ba1a8..2629cd1b26e 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SubjectAccessReviewSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SubjectAccessReviewSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubjectAccessReviewSpec is a description of the access request.  Exactly one of ResourceAuthorizationAttributes and NonResourceAuthorizationAttributes must be set
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,63 +105,99 @@ public SubjectAccessReviewSpec(Map<String, List<String>> extra, List<String> gro
         this.user = user;
     }
 
+    /**
+     * Extra corresponds to the user.Info.GetExtra() method from the authenticator.  Since that is input to the authorizer it needs a reflection here.
+     */
     @JsonProperty("extra")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<String>> getExtra() {
         return extra;
     }
 
+    /**
+     * Extra corresponds to the user.Info.GetExtra() method from the authenticator.  Since that is input to the authorizer it needs a reflection here.
+     */
     @JsonProperty("extra")
     public void setExtra(Map<String, List<String>> extra) {
         this.extra = extra;
     }
 
+    /**
+     * Groups is the groups you're testing for.
+     */
     @JsonProperty("groups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getGroups() {
         return groups;
     }
 
+    /**
+     * Groups is the groups you're testing for.
+     */
     @JsonProperty("groups")
     public void setGroups(List<String> groups) {
         this.groups = groups;
     }
 
+    /**
+     * SubjectAccessReviewSpec is a description of the access request.  Exactly one of ResourceAuthorizationAttributes and NonResourceAuthorizationAttributes must be set
+     */
     @JsonProperty("nonResourceAttributes")
     public NonResourceAttributes getNonResourceAttributes() {
         return nonResourceAttributes;
     }
 
+    /**
+     * SubjectAccessReviewSpec is a description of the access request.  Exactly one of ResourceAuthorizationAttributes and NonResourceAuthorizationAttributes must be set
+     */
     @JsonProperty("nonResourceAttributes")
     public void setNonResourceAttributes(NonResourceAttributes nonResourceAttributes) {
         this.nonResourceAttributes = nonResourceAttributes;
     }
 
+    /**
+     * SubjectAccessReviewSpec is a description of the access request.  Exactly one of ResourceAuthorizationAttributes and NonResourceAuthorizationAttributes must be set
+     */
     @JsonProperty("resourceAttributes")
     public ResourceAttributes getResourceAttributes() {
         return resourceAttributes;
     }
 
+    /**
+     * SubjectAccessReviewSpec is a description of the access request.  Exactly one of ResourceAuthorizationAttributes and NonResourceAuthorizationAttributes must be set
+     */
     @JsonProperty("resourceAttributes")
     public void setResourceAttributes(ResourceAttributes resourceAttributes) {
         this.resourceAttributes = resourceAttributes;
     }
 
+    /**
+     * UID information about the requesting user.
+     */
     @JsonProperty("uid")
     public String getUid() {
         return uid;
     }
 
+    /**
+     * UID information about the requesting user.
+     */
     @JsonProperty("uid")
     public void setUid(String uid) {
         this.uid = uid;
     }
 
+    /**
+     * User is the user you're testing for. If you specify "User" but not "Groups", then is it interpreted as "What if User were not a member of any groups
+     */
     @JsonProperty("user")
     public String getUser() {
         return user;
     }
 
+    /**
+     * User is the user you're testing for. If you specify "User" but not "Groups", then is it interpreted as "What if User were not a member of any groups
+     */
     @JsonProperty("user")
     public void setUser(String user) {
         this.user = user;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SubjectAccessReviewStatus.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SubjectAccessReviewStatus.java
index c905e2c81c5..8ef4474552e 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SubjectAccessReviewStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SubjectAccessReviewStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubjectAccessReviewStatus
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public SubjectAccessReviewStatus(Boolean allowed, Boolean denied, String evaluat
         this.reason = reason;
     }
 
+    /**
+     * Allowed is required. True if the action would be allowed, false otherwise.
+     */
     @JsonProperty("allowed")
     public Boolean getAllowed() {
         return allowed;
     }
 
+    /**
+     * Allowed is required. True if the action would be allowed, false otherwise.
+     */
     @JsonProperty("allowed")
     public void setAllowed(Boolean allowed) {
         this.allowed = allowed;
     }
 
+    /**
+     * Denied is optional. True if the action would be denied, otherwise false. If both allowed is false and denied is false, then the authorizer has no opinion on whether to authorize the action. Denied may not be true if Allowed is true.
+     */
     @JsonProperty("denied")
     public Boolean getDenied() {
         return denied;
     }
 
+    /**
+     * Denied is optional. True if the action would be denied, otherwise false. If both allowed is false and denied is false, then the authorizer has no opinion on whether to authorize the action. Denied may not be true if Allowed is true.
+     */
     @JsonProperty("denied")
     public void setDenied(Boolean denied) {
         this.denied = denied;
     }
 
+    /**
+     * EvaluationError is an indication that some error occurred during the authorization check. It is entirely possible to get an error and be able to continue determine authorization status in spite of it. For instance, RBAC can be missing a role, but enough roles are still present and bound to reason about the request.
+     */
     @JsonProperty("evaluationError")
     public String getEvaluationError() {
         return evaluationError;
     }
 
+    /**
+     * EvaluationError is an indication that some error occurred during the authorization check. It is entirely possible to get an error and be able to continue determine authorization status in spite of it. For instance, RBAC can be missing a role, but enough roles are still present and bound to reason about the request.
+     */
     @JsonProperty("evaluationError")
     public void setEvaluationError(String evaluationError) {
         this.evaluationError = evaluationError;
     }
 
+    /**
+     * Reason is optional.  It indicates why a request was allowed or denied.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason is optional.  It indicates why a request was allowed or denied.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SubjectRulesReviewStatus.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SubjectRulesReviewStatus.java
index b4dedb0b7c3..3ac0337b900 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SubjectRulesReviewStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1/SubjectRulesReviewStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubjectRulesReviewStatus contains the result of a rules check. This check can be incomplete depending on the set of authorizers the server is configured with and any errors experienced during evaluation. Because authorization rules are additive, if a rule appears in a list it's safe to assume the subject has that permission, even if that list is incomplete.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,43 +97,67 @@ public SubjectRulesReviewStatus(String evaluationError, Boolean incomplete, List
         this.resourceRules = resourceRules;
     }
 
+    /**
+     * EvaluationError can appear in combination with Rules. It indicates an error occurred during rule evaluation, such as an authorizer that doesn't support rule evaluation, and that ResourceRules and/or NonResourceRules may be incomplete.
+     */
     @JsonProperty("evaluationError")
     public String getEvaluationError() {
         return evaluationError;
     }
 
+    /**
+     * EvaluationError can appear in combination with Rules. It indicates an error occurred during rule evaluation, such as an authorizer that doesn't support rule evaluation, and that ResourceRules and/or NonResourceRules may be incomplete.
+     */
     @JsonProperty("evaluationError")
     public void setEvaluationError(String evaluationError) {
         this.evaluationError = evaluationError;
     }
 
+    /**
+     * Incomplete is true when the rules returned by this call are incomplete. This is most commonly encountered when an authorizer, such as an external authorizer, doesn't support rules evaluation.
+     */
     @JsonProperty("incomplete")
     public Boolean getIncomplete() {
         return incomplete;
     }
 
+    /**
+     * Incomplete is true when the rules returned by this call are incomplete. This is most commonly encountered when an authorizer, such as an external authorizer, doesn't support rules evaluation.
+     */
     @JsonProperty("incomplete")
     public void setIncomplete(Boolean incomplete) {
         this.incomplete = incomplete;
     }
 
+    /**
+     * NonResourceRules is the list of actions the subject is allowed to perform on non-resources. The list ordering isn't significant, may contain duplicates, and possibly be incomplete.
+     */
     @JsonProperty("nonResourceRules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NonResourceRule> getNonResourceRules() {
         return nonResourceRules;
     }
 
+    /**
+     * NonResourceRules is the list of actions the subject is allowed to perform on non-resources. The list ordering isn't significant, may contain duplicates, and possibly be incomplete.
+     */
     @JsonProperty("nonResourceRules")
     public void setNonResourceRules(List<NonResourceRule> nonResourceRules) {
         this.nonResourceRules = nonResourceRules;
     }
 
+    /**
+     * ResourceRules is the list of actions the subject is allowed to perform on resources. The list ordering isn't significant, may contain duplicates, and possibly be incomplete.
+     */
     @JsonProperty("resourceRules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ResourceRule> getResourceRules() {
         return resourceRules;
     }
 
+    /**
+     * ResourceRules is the list of actions the subject is allowed to perform on resources. The list ordering isn't significant, may contain duplicates, and possibly be incomplete.
+     */
     @JsonProperty("resourceRules")
     public void setResourceRules(List<ResourceRule> resourceRules) {
         this.resourceRules = resourceRules;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/LocalSubjectAccessReview.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/LocalSubjectAccessReview.java
index f7fb7fadca7..ac6b257f468 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/LocalSubjectAccessReview.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/LocalSubjectAccessReview.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LocalSubjectAccessReview checks whether or not a user or group can perform an action in a given namespace. Having a namespace scoped resource makes it much easier to grant namespace scoped policy that includes permissions checking.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class LocalSubjectAccessReview implements Editable<LocalSubjectAccessReviewBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authorization.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "LocalSubjectAccessReview";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public LocalSubjectAccessReview(String apiVersion, String kind, ObjectMeta metad
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * LocalSubjectAccessReview checks whether or not a user or group can perform an action in a given namespace. Having a namespace scoped resource makes it much easier to grant namespace scoped policy that includes permissions checking.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * LocalSubjectAccessReview checks whether or not a user or group can perform an action in a given namespace. Having a namespace scoped resource makes it much easier to grant namespace scoped policy that includes permissions checking.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * LocalSubjectAccessReview checks whether or not a user or group can perform an action in a given namespace. Having a namespace scoped resource makes it much easier to grant namespace scoped policy that includes permissions checking.
+     */
     @JsonProperty("spec")
     public SubjectAccessReviewSpec getSpec() {
         return spec;
     }
 
+    /**
+     * LocalSubjectAccessReview checks whether or not a user or group can perform an action in a given namespace. Having a namespace scoped resource makes it much easier to grant namespace scoped policy that includes permissions checking.
+     */
     @JsonProperty("spec")
     public void setSpec(SubjectAccessReviewSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * LocalSubjectAccessReview checks whether or not a user or group can perform an action in a given namespace. Having a namespace scoped resource makes it much easier to grant namespace scoped policy that includes permissions checking.
+     */
     @JsonProperty("status")
     public SubjectAccessReviewStatus getStatus() {
         return status;
     }
 
+    /**
+     * LocalSubjectAccessReview checks whether or not a user or group can perform an action in a given namespace. Having a namespace scoped resource makes it much easier to grant namespace scoped policy that includes permissions checking.
+     */
     @JsonProperty("status")
     public void setStatus(SubjectAccessReviewStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/NonResourceAttributes.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/NonResourceAttributes.java
index d1e4cc7b425..8572f098034 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/NonResourceAttributes.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/NonResourceAttributes.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NonResourceAttributes includes the authorization attributes available for non-resource requests to the Authorizer interface
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public NonResourceAttributes(String path, String verb) {
         this.verb = verb;
     }
 
+    /**
+     * Path is the URL path of the request
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Path is the URL path of the request
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * Verb is the standard HTTP verb
+     */
     @JsonProperty("verb")
     public String getVerb() {
         return verb;
     }
 
+    /**
+     * Verb is the standard HTTP verb
+     */
     @JsonProperty("verb")
     public void setVerb(String verb) {
         this.verb = verb;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/NonResourceRule.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/NonResourceRule.java
index a678afb344a..6714e64a12a 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/NonResourceRule.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/NonResourceRule.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NonResourceRule holds information that describes a rule for the non-resource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public NonResourceRule(List<String> nonResourceURLs, List<String> verbs) {
         this.verbs = verbs;
     }
 
+    /**
+     * NonResourceURLs is a set of partial urls that a user should have access to.  &#42;s are allowed, but only as the full, final step in the path.  "&#42;" means all.
+     */
     @JsonProperty("nonResourceURLs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNonResourceURLs() {
         return nonResourceURLs;
     }
 
+    /**
+     * NonResourceURLs is a set of partial urls that a user should have access to.  &#42;s are allowed, but only as the full, final step in the path.  "&#42;" means all.
+     */
     @JsonProperty("nonResourceURLs")
     public void setNonResourceURLs(List<String> nonResourceURLs) {
         this.nonResourceURLs = nonResourceURLs;
     }
 
+    /**
+     * Verb is a list of kubernetes non-resource API verbs, like: get, post, put, delete, patch, head, options.  "&#42;" means all.
+     */
     @JsonProperty("verbs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getVerbs() {
         return verbs;
     }
 
+    /**
+     * Verb is a list of kubernetes non-resource API verbs, like: get, post, put, delete, patch, head, options.  "&#42;" means all.
+     */
     @JsonProperty("verbs")
     public void setVerbs(List<String> verbs) {
         this.verbs = verbs;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/ResourceAttributes.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/ResourceAttributes.java
index 41e1e6746cc..07227bc0bbd 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/ResourceAttributes.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/ResourceAttributes.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceAttributes includes the authorization attributes available for resource requests to the Authorizer interface
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,71 +105,113 @@ public ResourceAttributes(String group, String name, String namespace, String re
         this.version = version;
     }
 
+    /**
+     * Group is the API Group of the Resource.  "&#42;" means all.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * Group is the API Group of the Resource.  "&#42;" means all.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * Name is the name of the resource being requested for a "get" or deleted for a "delete". "" (empty) means all.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the resource being requested for a "get" or deleted for a "delete". "" (empty) means all.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace is the namespace of the action being requested.  Currently, there is no distinction between no namespace and all namespaces "" (empty) is defaulted for LocalSubjectAccessReviews "" (empty) is empty for cluster-scoped resources "" (empty) means "all" for namespace scoped resources from a SubjectAccessReview or SelfSubjectAccessReview
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace of the action being requested.  Currently, there is no distinction between no namespace and all namespaces "" (empty) is defaulted for LocalSubjectAccessReviews "" (empty) is empty for cluster-scoped resources "" (empty) means "all" for namespace scoped resources from a SubjectAccessReview or SelfSubjectAccessReview
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Resource is one of the existing resource types.  "&#42;" means all.
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * Resource is one of the existing resource types.  "&#42;" means all.
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
     }
 
+    /**
+     * Subresource is one of the existing resource types.  "" means none.
+     */
     @JsonProperty("subresource")
     public String getSubresource() {
         return subresource;
     }
 
+    /**
+     * Subresource is one of the existing resource types.  "" means none.
+     */
     @JsonProperty("subresource")
     public void setSubresource(String subresource) {
         this.subresource = subresource;
     }
 
+    /**
+     * Verb is a kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy.  "&#42;" means all.
+     */
     @JsonProperty("verb")
     public String getVerb() {
         return verb;
     }
 
+    /**
+     * Verb is a kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy.  "&#42;" means all.
+     */
     @JsonProperty("verb")
     public void setVerb(String verb) {
         this.verb = verb;
     }
 
+    /**
+     * Version is the API Version of the Resource.  "&#42;" means all.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * Version is the API Version of the Resource.  "&#42;" means all.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/ResourceRule.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/ResourceRule.java
index 9ef63b5f32b..ea5dd56e9c2 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/ResourceRule.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/ResourceRule.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceRule is the list of actions the subject is allowed to perform on resources. The list ordering isn't significant, may contain duplicates, and possibly be incomplete.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -96,45 +99,69 @@ public ResourceRule(List<String> apiGroups, List<String> resourceNames, List<Str
         this.verbs = verbs;
     }
 
+    /**
+     * APIGroups is the name of the APIGroup that contains the resources.  If multiple API groups are specified, any action requested against one of the enumerated resources in any API group will be allowed.  "&#42;" means all.
+     */
     @JsonProperty("apiGroups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiGroups() {
         return apiGroups;
     }
 
+    /**
+     * APIGroups is the name of the APIGroup that contains the resources.  If multiple API groups are specified, any action requested against one of the enumerated resources in any API group will be allowed.  "&#42;" means all.
+     */
     @JsonProperty("apiGroups")
     public void setApiGroups(List<String> apiGroups) {
         this.apiGroups = apiGroups;
     }
 
+    /**
+     * ResourceNames is an optional white list of names that the rule applies to.  An empty set means that everything is allowed.  "&#42;" means all.
+     */
     @JsonProperty("resourceNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getResourceNames() {
         return resourceNames;
     }
 
+    /**
+     * ResourceNames is an optional white list of names that the rule applies to.  An empty set means that everything is allowed.  "&#42;" means all.
+     */
     @JsonProperty("resourceNames")
     public void setResourceNames(List<String> resourceNames) {
         this.resourceNames = resourceNames;
     }
 
+    /**
+     * Resources is a list of resources this rule applies to.  "&#42;" means all in the specified apiGroups.<br><p>  "&#42;/foo" represents the subresource 'foo' for all resources in the specified apiGroups.
+     */
     @JsonProperty("resources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getResources() {
         return resources;
     }
 
+    /**
+     * Resources is a list of resources this rule applies to.  "&#42;" means all in the specified apiGroups.<br><p>  "&#42;/foo" represents the subresource 'foo' for all resources in the specified apiGroups.
+     */
     @JsonProperty("resources")
     public void setResources(List<String> resources) {
         this.resources = resources;
     }
 
+    /**
+     * Verb is a list of kubernetes resource API verbs, like: get, list, watch, create, update, delete, proxy.  "&#42;" means all.
+     */
     @JsonProperty("verbs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getVerbs() {
         return verbs;
     }
 
+    /**
+     * Verb is a list of kubernetes resource API verbs, like: get, list, watch, create, update, delete, proxy.  "&#42;" means all.
+     */
     @JsonProperty("verbs")
     public void setVerbs(List<String> verbs) {
         this.verbs = verbs;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SelfSubjectAccessReview.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SelfSubjectAccessReview.java
index a3c6e6996be..2521a7ddbce 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SelfSubjectAccessReview.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SelfSubjectAccessReview.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SelfSubjectAccessReview checks whether or the current user can perform an action.  Not filling in a spec.namespace means "in all namespaces".  Self is a special case, because users should always be able to check whether they can perform an action
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class SelfSubjectAccessReview implements Editable<SelfSubjectAccessReviewBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authorization.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SelfSubjectAccessReview";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public SelfSubjectAccessReview(String apiVersion, String kind, ObjectMeta metada
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SelfSubjectAccessReview checks whether or the current user can perform an action.  Not filling in a spec.namespace means "in all namespaces".  Self is a special case, because users should always be able to check whether they can perform an action
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SelfSubjectAccessReview checks whether or the current user can perform an action.  Not filling in a spec.namespace means "in all namespaces".  Self is a special case, because users should always be able to check whether they can perform an action
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * SelfSubjectAccessReview checks whether or the current user can perform an action.  Not filling in a spec.namespace means "in all namespaces".  Self is a special case, because users should always be able to check whether they can perform an action
+     */
     @JsonProperty("spec")
     public SelfSubjectAccessReviewSpec getSpec() {
         return spec;
     }
 
+    /**
+     * SelfSubjectAccessReview checks whether or the current user can perform an action.  Not filling in a spec.namespace means "in all namespaces".  Self is a special case, because users should always be able to check whether they can perform an action
+     */
     @JsonProperty("spec")
     public void setSpec(SelfSubjectAccessReviewSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * SelfSubjectAccessReview checks whether or the current user can perform an action.  Not filling in a spec.namespace means "in all namespaces".  Self is a special case, because users should always be able to check whether they can perform an action
+     */
     @JsonProperty("status")
     public SubjectAccessReviewStatus getStatus() {
         return status;
     }
 
+    /**
+     * SelfSubjectAccessReview checks whether or the current user can perform an action.  Not filling in a spec.namespace means "in all namespaces".  Self is a special case, because users should always be able to check whether they can perform an action
+     */
     @JsonProperty("status")
     public void setStatus(SubjectAccessReviewStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SelfSubjectAccessReviewSpec.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SelfSubjectAccessReviewSpec.java
index c152429126a..a1749eb3b13 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SelfSubjectAccessReviewSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SelfSubjectAccessReviewSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SelfSubjectAccessReviewSpec is a description of the access request.  Exactly one of ResourceAuthorizationAttributes and NonResourceAuthorizationAttributes must be set
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public SelfSubjectAccessReviewSpec(NonResourceAttributes nonResourceAttributes,
         this.resourceAttributes = resourceAttributes;
     }
 
+    /**
+     * SelfSubjectAccessReviewSpec is a description of the access request.  Exactly one of ResourceAuthorizationAttributes and NonResourceAuthorizationAttributes must be set
+     */
     @JsonProperty("nonResourceAttributes")
     public NonResourceAttributes getNonResourceAttributes() {
         return nonResourceAttributes;
     }
 
+    /**
+     * SelfSubjectAccessReviewSpec is a description of the access request.  Exactly one of ResourceAuthorizationAttributes and NonResourceAuthorizationAttributes must be set
+     */
     @JsonProperty("nonResourceAttributes")
     public void setNonResourceAttributes(NonResourceAttributes nonResourceAttributes) {
         this.nonResourceAttributes = nonResourceAttributes;
     }
 
+    /**
+     * SelfSubjectAccessReviewSpec is a description of the access request.  Exactly one of ResourceAuthorizationAttributes and NonResourceAuthorizationAttributes must be set
+     */
     @JsonProperty("resourceAttributes")
     public ResourceAttributes getResourceAttributes() {
         return resourceAttributes;
     }
 
+    /**
+     * SelfSubjectAccessReviewSpec is a description of the access request.  Exactly one of ResourceAuthorizationAttributes and NonResourceAuthorizationAttributes must be set
+     */
     @JsonProperty("resourceAttributes")
     public void setResourceAttributes(ResourceAttributes resourceAttributes) {
         this.resourceAttributes = resourceAttributes;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SelfSubjectRulesReview.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SelfSubjectRulesReview.java
index 0e6eedfac93..05a6cdb1f9d 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SelfSubjectRulesReview.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SelfSubjectRulesReview.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SelfSubjectRulesReview enumerates the set of actions the current user can perform within a namespace. The returned list of actions may be incomplete depending on the server's authorization mode, and any errors experienced during the evaluation. SelfSubjectRulesReview should be used by UIs to show/hide actions, or to quickly let an end user reason about their permissions. It should NOT Be used by external systems to drive authorization decisions as this raises confused deputy, cache lifetime/revocation, and correctness concerns. SubjectAccessReview, and LocalAccessReview are the correct way to defer authorization decisions to the API server.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class SelfSubjectRulesReview implements Editable<SelfSubjectRulesReviewBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authorization.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SelfSubjectRulesReview";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public SelfSubjectRulesReview(String apiVersion, String kind, ObjectMeta metadat
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SelfSubjectRulesReview enumerates the set of actions the current user can perform within a namespace. The returned list of actions may be incomplete depending on the server's authorization mode, and any errors experienced during the evaluation. SelfSubjectRulesReview should be used by UIs to show/hide actions, or to quickly let an end user reason about their permissions. It should NOT Be used by external systems to drive authorization decisions as this raises confused deputy, cache lifetime/revocation, and correctness concerns. SubjectAccessReview, and LocalAccessReview are the correct way to defer authorization decisions to the API server.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SelfSubjectRulesReview enumerates the set of actions the current user can perform within a namespace. The returned list of actions may be incomplete depending on the server's authorization mode, and any errors experienced during the evaluation. SelfSubjectRulesReview should be used by UIs to show/hide actions, or to quickly let an end user reason about their permissions. It should NOT Be used by external systems to drive authorization decisions as this raises confused deputy, cache lifetime/revocation, and correctness concerns. SubjectAccessReview, and LocalAccessReview are the correct way to defer authorization decisions to the API server.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * SelfSubjectRulesReview enumerates the set of actions the current user can perform within a namespace. The returned list of actions may be incomplete depending on the server's authorization mode, and any errors experienced during the evaluation. SelfSubjectRulesReview should be used by UIs to show/hide actions, or to quickly let an end user reason about their permissions. It should NOT Be used by external systems to drive authorization decisions as this raises confused deputy, cache lifetime/revocation, and correctness concerns. SubjectAccessReview, and LocalAccessReview are the correct way to defer authorization decisions to the API server.
+     */
     @JsonProperty("spec")
     public SelfSubjectRulesReviewSpec getSpec() {
         return spec;
     }
 
+    /**
+     * SelfSubjectRulesReview enumerates the set of actions the current user can perform within a namespace. The returned list of actions may be incomplete depending on the server's authorization mode, and any errors experienced during the evaluation. SelfSubjectRulesReview should be used by UIs to show/hide actions, or to quickly let an end user reason about their permissions. It should NOT Be used by external systems to drive authorization decisions as this raises confused deputy, cache lifetime/revocation, and correctness concerns. SubjectAccessReview, and LocalAccessReview are the correct way to defer authorization decisions to the API server.
+     */
     @JsonProperty("spec")
     public void setSpec(SelfSubjectRulesReviewSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * SelfSubjectRulesReview enumerates the set of actions the current user can perform within a namespace. The returned list of actions may be incomplete depending on the server's authorization mode, and any errors experienced during the evaluation. SelfSubjectRulesReview should be used by UIs to show/hide actions, or to quickly let an end user reason about their permissions. It should NOT Be used by external systems to drive authorization decisions as this raises confused deputy, cache lifetime/revocation, and correctness concerns. SubjectAccessReview, and LocalAccessReview are the correct way to defer authorization decisions to the API server.
+     */
     @JsonProperty("status")
     public SubjectRulesReviewStatus getStatus() {
         return status;
     }
 
+    /**
+     * SelfSubjectRulesReview enumerates the set of actions the current user can perform within a namespace. The returned list of actions may be incomplete depending on the server's authorization mode, and any errors experienced during the evaluation. SelfSubjectRulesReview should be used by UIs to show/hide actions, or to quickly let an end user reason about their permissions. It should NOT Be used by external systems to drive authorization decisions as this raises confused deputy, cache lifetime/revocation, and correctness concerns. SubjectAccessReview, and LocalAccessReview are the correct way to defer authorization decisions to the API server.
+     */
     @JsonProperty("status")
     public void setStatus(SubjectRulesReviewStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SelfSubjectRulesReviewSpec.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SelfSubjectRulesReviewSpec.java
index eccc71a8431..88a2348a6eb 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SelfSubjectRulesReviewSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SelfSubjectRulesReviewSpec.java
@@ -78,11 +78,17 @@ public SelfSubjectRulesReviewSpec(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Namespace to evaluate rules for. Required.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace to evaluate rules for. Required.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SubjectAccessReview.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SubjectAccessReview.java
index 2fd4e4fb32e..19d8fac0da7 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SubjectAccessReview.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SubjectAccessReview.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubjectAccessReview checks whether or not a user or group can perform an action.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class SubjectAccessReview implements Editable<SubjectAccessReviewBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authorization.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SubjectAccessReview";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public SubjectAccessReview(String apiVersion, String kind, ObjectMeta metadata,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SubjectAccessReview checks whether or not a user or group can perform an action.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SubjectAccessReview checks whether or not a user or group can perform an action.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * SubjectAccessReview checks whether or not a user or group can perform an action.
+     */
     @JsonProperty("spec")
     public SubjectAccessReviewSpec getSpec() {
         return spec;
     }
 
+    /**
+     * SubjectAccessReview checks whether or not a user or group can perform an action.
+     */
     @JsonProperty("spec")
     public void setSpec(SubjectAccessReviewSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * SubjectAccessReview checks whether or not a user or group can perform an action.
+     */
     @JsonProperty("status")
     public SubjectAccessReviewStatus getStatus() {
         return status;
     }
 
+    /**
+     * SubjectAccessReview checks whether or not a user or group can perform an action.
+     */
     @JsonProperty("status")
     public void setStatus(SubjectAccessReviewStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SubjectAccessReviewSpec.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SubjectAccessReviewSpec.java
index e909f9779ac..20ce0c9c975 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SubjectAccessReviewSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SubjectAccessReviewSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubjectAccessReviewSpec is a description of the access request.  Exactly one of ResourceAuthorizationAttributes and NonResourceAuthorizationAttributes must be set
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,63 +105,99 @@ public SubjectAccessReviewSpec(Map<String, List<String>> extra, List<String> gro
         this.user = user;
     }
 
+    /**
+     * Extra corresponds to the user.Info.GetExtra() method from the authenticator.  Since that is input to the authorizer it needs a reflection here.
+     */
     @JsonProperty("extra")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<String>> getExtra() {
         return extra;
     }
 
+    /**
+     * Extra corresponds to the user.Info.GetExtra() method from the authenticator.  Since that is input to the authorizer it needs a reflection here.
+     */
     @JsonProperty("extra")
     public void setExtra(Map<String, List<String>> extra) {
         this.extra = extra;
     }
 
+    /**
+     * Groups is the groups you're testing for.
+     */
     @JsonProperty("group")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getGroup() {
         return group;
     }
 
+    /**
+     * Groups is the groups you're testing for.
+     */
     @JsonProperty("group")
     public void setGroup(List<String> group) {
         this.group = group;
     }
 
+    /**
+     * SubjectAccessReviewSpec is a description of the access request.  Exactly one of ResourceAuthorizationAttributes and NonResourceAuthorizationAttributes must be set
+     */
     @JsonProperty("nonResourceAttributes")
     public NonResourceAttributes getNonResourceAttributes() {
         return nonResourceAttributes;
     }
 
+    /**
+     * SubjectAccessReviewSpec is a description of the access request.  Exactly one of ResourceAuthorizationAttributes and NonResourceAuthorizationAttributes must be set
+     */
     @JsonProperty("nonResourceAttributes")
     public void setNonResourceAttributes(NonResourceAttributes nonResourceAttributes) {
         this.nonResourceAttributes = nonResourceAttributes;
     }
 
+    /**
+     * SubjectAccessReviewSpec is a description of the access request.  Exactly one of ResourceAuthorizationAttributes and NonResourceAuthorizationAttributes must be set
+     */
     @JsonProperty("resourceAttributes")
     public ResourceAttributes getResourceAttributes() {
         return resourceAttributes;
     }
 
+    /**
+     * SubjectAccessReviewSpec is a description of the access request.  Exactly one of ResourceAuthorizationAttributes and NonResourceAuthorizationAttributes must be set
+     */
     @JsonProperty("resourceAttributes")
     public void setResourceAttributes(ResourceAttributes resourceAttributes) {
         this.resourceAttributes = resourceAttributes;
     }
 
+    /**
+     * UID information about the requesting user.
+     */
     @JsonProperty("uid")
     public String getUid() {
         return uid;
     }
 
+    /**
+     * UID information about the requesting user.
+     */
     @JsonProperty("uid")
     public void setUid(String uid) {
         this.uid = uid;
     }
 
+    /**
+     * User is the user you're testing for. If you specify "User" but not "Group", then is it interpreted as "What if User were not a member of any groups
+     */
     @JsonProperty("user")
     public String getUser() {
         return user;
     }
 
+    /**
+     * User is the user you're testing for. If you specify "User" but not "Group", then is it interpreted as "What if User were not a member of any groups
+     */
     @JsonProperty("user")
     public void setUser(String user) {
         this.user = user;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SubjectAccessReviewStatus.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SubjectAccessReviewStatus.java
index 57e1a0de729..bd63cffa4b3 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SubjectAccessReviewStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SubjectAccessReviewStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubjectAccessReviewStatus
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public SubjectAccessReviewStatus(Boolean allowed, Boolean denied, String evaluat
         this.reason = reason;
     }
 
+    /**
+     * Allowed is required. True if the action would be allowed, false otherwise.
+     */
     @JsonProperty("allowed")
     public Boolean getAllowed() {
         return allowed;
     }
 
+    /**
+     * Allowed is required. True if the action would be allowed, false otherwise.
+     */
     @JsonProperty("allowed")
     public void setAllowed(Boolean allowed) {
         this.allowed = allowed;
     }
 
+    /**
+     * Denied is optional. True if the action would be denied, otherwise false. If both allowed is false and denied is false, then the authorizer has no opinion on whether to authorize the action. Denied may not be true if Allowed is true.
+     */
     @JsonProperty("denied")
     public Boolean getDenied() {
         return denied;
     }
 
+    /**
+     * Denied is optional. True if the action would be denied, otherwise false. If both allowed is false and denied is false, then the authorizer has no opinion on whether to authorize the action. Denied may not be true if Allowed is true.
+     */
     @JsonProperty("denied")
     public void setDenied(Boolean denied) {
         this.denied = denied;
     }
 
+    /**
+     * EvaluationError is an indication that some error occurred during the authorization check. It is entirely possible to get an error and be able to continue determine authorization status in spite of it. For instance, RBAC can be missing a role, but enough roles are still present and bound to reason about the request.
+     */
     @JsonProperty("evaluationError")
     public String getEvaluationError() {
         return evaluationError;
     }
 
+    /**
+     * EvaluationError is an indication that some error occurred during the authorization check. It is entirely possible to get an error and be able to continue determine authorization status in spite of it. For instance, RBAC can be missing a role, but enough roles are still present and bound to reason about the request.
+     */
     @JsonProperty("evaluationError")
     public void setEvaluationError(String evaluationError) {
         this.evaluationError = evaluationError;
     }
 
+    /**
+     * Reason is optional.  It indicates why a request was allowed or denied.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason is optional.  It indicates why a request was allowed or denied.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
diff --git a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SubjectRulesReviewStatus.java b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SubjectRulesReviewStatus.java
index 8b1b546c803..29d96881250 100644
--- a/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SubjectRulesReviewStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-admissionregistration/src/generated/java/io/fabric8/kubernetes/api/model/authorization/v1beta1/SubjectRulesReviewStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubjectRulesReviewStatus contains the result of a rules check. This check can be incomplete depending on the set of authorizers the server is configured with and any errors experienced during evaluation. Because authorization rules are additive, if a rule appears in a list it's safe to assume the subject has that permission, even if that list is incomplete.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,43 +97,67 @@ public SubjectRulesReviewStatus(String evaluationError, Boolean incomplete, List
         this.resourceRules = resourceRules;
     }
 
+    /**
+     * EvaluationError can appear in combination with Rules. It indicates an error occurred during rule evaluation, such as an authorizer that doesn't support rule evaluation, and that ResourceRules and/or NonResourceRules may be incomplete.
+     */
     @JsonProperty("evaluationError")
     public String getEvaluationError() {
         return evaluationError;
     }
 
+    /**
+     * EvaluationError can appear in combination with Rules. It indicates an error occurred during rule evaluation, such as an authorizer that doesn't support rule evaluation, and that ResourceRules and/or NonResourceRules may be incomplete.
+     */
     @JsonProperty("evaluationError")
     public void setEvaluationError(String evaluationError) {
         this.evaluationError = evaluationError;
     }
 
+    /**
+     * Incomplete is true when the rules returned by this call are incomplete. This is most commonly encountered when an authorizer, such as an external authorizer, doesn't support rules evaluation.
+     */
     @JsonProperty("incomplete")
     public Boolean getIncomplete() {
         return incomplete;
     }
 
+    /**
+     * Incomplete is true when the rules returned by this call are incomplete. This is most commonly encountered when an authorizer, such as an external authorizer, doesn't support rules evaluation.
+     */
     @JsonProperty("incomplete")
     public void setIncomplete(Boolean incomplete) {
         this.incomplete = incomplete;
     }
 
+    /**
+     * NonResourceRules is the list of actions the subject is allowed to perform on non-resources. The list ordering isn't significant, may contain duplicates, and possibly be incomplete.
+     */
     @JsonProperty("nonResourceRules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NonResourceRule> getNonResourceRules() {
         return nonResourceRules;
     }
 
+    /**
+     * NonResourceRules is the list of actions the subject is allowed to perform on non-resources. The list ordering isn't significant, may contain duplicates, and possibly be incomplete.
+     */
     @JsonProperty("nonResourceRules")
     public void setNonResourceRules(List<NonResourceRule> nonResourceRules) {
         this.nonResourceRules = nonResourceRules;
     }
 
+    /**
+     * ResourceRules is the list of actions the subject is allowed to perform on resources. The list ordering isn't significant, may contain duplicates, and possibly be incomplete.
+     */
     @JsonProperty("resourceRules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ResourceRule> getResourceRules() {
         return resourceRules;
     }
 
+    /**
+     * ResourceRules is the list of actions the subject is allowed to perform on resources. The list ordering isn't significant, may contain duplicates, and possibly be incomplete.
+     */
     @JsonProperty("resourceRules")
     public void setResourceRules(List<ResourceRule> resourceRules) {
         this.resourceRules = resourceRules;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/ConversionReview.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/ConversionReview.java
index c4b47f785f3..c3e665f82eb 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/ConversionReview.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/ConversionReview.java
@@ -74,14 +74,8 @@
 public class ConversionReview implements Editable<ConversionReviewBuilder>, KubernetesResource
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apiextensions.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ConversionReview";
     @JsonProperty("request")
@@ -105,33 +99,21 @@ public ConversionReview(String apiVersion, String kind, ConversionRequest reques
         this.response = response;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceColumnDefinition.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceColumnDefinition.java
index 67ad3715325..90b1ee20500 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceColumnDefinition.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceColumnDefinition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomResourceColumnDefinition specifies a column for server side printing.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public CustomResourceColumnDefinition(String description, String format, String
         this.type = type;
     }
 
+    /**
+     * description is a human readable description of this column.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * description is a human readable description of this column.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * format is an optional OpenAPI type definition for this column. The 'name' format is applied to the primary identifier column to assist in clients identifying column is the resource name. See https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#data-types for details.
+     */
     @JsonProperty("format")
     public String getFormat() {
         return format;
     }
 
+    /**
+     * format is an optional OpenAPI type definition for this column. The 'name' format is applied to the primary identifier column to assist in clients identifying column is the resource name. See https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#data-types for details.
+     */
     @JsonProperty("format")
     public void setFormat(String format) {
         this.format = format;
     }
 
+    /**
+     * jsonPath is a simple JSON path (i.e. with array notation) which is evaluated against each custom resource to produce the value for this column.
+     */
     @JsonProperty("jsonPath")
     public String getJsonPath() {
         return jsonPath;
     }
 
+    /**
+     * jsonPath is a simple JSON path (i.e. with array notation) which is evaluated against each custom resource to produce the value for this column.
+     */
     @JsonProperty("jsonPath")
     public void setJsonPath(String jsonPath) {
         this.jsonPath = jsonPath;
     }
 
+    /**
+     * name is a human readable name for the column.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is a human readable name for the column.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * priority is an integer defining the relative importance of this column compared to others. Lower numbers are considered higher priority. Columns that may be omitted in limited space scenarios should be given a priority greater than 0.
+     */
     @JsonProperty("priority")
     public Integer getPriority() {
         return priority;
     }
 
+    /**
+     * priority is an integer defining the relative importance of this column compared to others. Lower numbers are considered higher priority. Columns that may be omitted in limited space scenarios should be given a priority greater than 0.
+     */
     @JsonProperty("priority")
     public void setPriority(Integer priority) {
         this.priority = priority;
     }
 
+    /**
+     * type is an OpenAPI type definition for this column. See https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#data-types for details.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is an OpenAPI type definition for this column. See https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#data-types for details.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceConversion.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceConversion.java
index 0b56be454d8..da8913d05ee 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceConversion.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceConversion.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomResourceConversion describes how to convert different versions of a CR.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public CustomResourceConversion(String strategy, WebhookConversion webhook) {
         this.webhook = webhook;
     }
 
+    /**
+     * strategy specifies how custom resources are converted between versions. Allowed values are: - `"None"`: The converter only change the apiVersion and would not touch any other field in the custom resource. - `"Webhook"`: API Server will call to an external webhook to do the conversion. Additional information<br><p>   is needed for this option. This requires spec.preserveUnknownFields to be false, and spec.conversion.webhook to be set.
+     */
     @JsonProperty("strategy")
     public String getStrategy() {
         return strategy;
     }
 
+    /**
+     * strategy specifies how custom resources are converted between versions. Allowed values are: - `"None"`: The converter only change the apiVersion and would not touch any other field in the custom resource. - `"Webhook"`: API Server will call to an external webhook to do the conversion. Additional information<br><p>   is needed for this option. This requires spec.preserveUnknownFields to be false, and spec.conversion.webhook to be set.
+     */
     @JsonProperty("strategy")
     public void setStrategy(String strategy) {
         this.strategy = strategy;
     }
 
+    /**
+     * CustomResourceConversion describes how to convert different versions of a CR.
+     */
     @JsonProperty("webhook")
     public WebhookConversion getWebhook() {
         return webhook;
     }
 
+    /**
+     * CustomResourceConversion describes how to convert different versions of a CR.
+     */
     @JsonProperty("webhook")
     public void setWebhook(WebhookConversion webhook) {
         this.webhook = webhook;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceDefinition.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceDefinition.java
index 289c75973ec..3415f10b3a7 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceDefinition.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceDefinition.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomResourceDefinition represents a resource that should be exposed on the API server.  Its name MUST be in the format &lt;.spec.name&gt;.&lt;.spec.group&gt;.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class CustomResourceDefinition implements Editable<CustomResourceDefinitionBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apiextensions.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CustomResourceDefinition";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public CustomResourceDefinition(String apiVersion, String kind, ObjectMeta metad
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CustomResourceDefinition represents a resource that should be exposed on the API server.  Its name MUST be in the format &lt;.spec.name&gt;.&lt;.spec.group&gt;.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CustomResourceDefinition represents a resource that should be exposed on the API server.  Its name MUST be in the format &lt;.spec.name&gt;.&lt;.spec.group&gt;.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * CustomResourceDefinition represents a resource that should be exposed on the API server.  Its name MUST be in the format &lt;.spec.name&gt;.&lt;.spec.group&gt;.
+     */
     @JsonProperty("spec")
     public CustomResourceDefinitionSpec getSpec() {
         return spec;
     }
 
+    /**
+     * CustomResourceDefinition represents a resource that should be exposed on the API server.  Its name MUST be in the format &lt;.spec.name&gt;.&lt;.spec.group&gt;.
+     */
     @JsonProperty("spec")
     public void setSpec(CustomResourceDefinitionSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * CustomResourceDefinition represents a resource that should be exposed on the API server.  Its name MUST be in the format &lt;.spec.name&gt;.&lt;.spec.group&gt;.
+     */
     @JsonProperty("status")
     public CustomResourceDefinitionStatus getStatus() {
         return status;
     }
 
+    /**
+     * CustomResourceDefinition represents a resource that should be exposed on the API server.  Its name MUST be in the format &lt;.spec.name&gt;.&lt;.spec.group&gt;.
+     */
     @JsonProperty("status")
     public void setStatus(CustomResourceDefinitionStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceDefinitionCondition.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceDefinitionCondition.java
index ad70eb440be..d8e8e9477f6 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceDefinitionCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceDefinitionCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomResourceDefinitionCondition contains details for the current condition of this pod.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public CustomResourceDefinitionCondition(String lastTransitionTime, String messa
         this.type = type;
     }
 
+    /**
+     * CustomResourceDefinitionCondition contains details for the current condition of this pod.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * CustomResourceDefinitionCondition contains details for the current condition of this pod.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * message is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * reason is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * reason is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * status is the status of the condition. Can be True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * status is the status of the condition. Can be True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * type is the type of the condition. Types include Established, NamesAccepted and Terminating.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the type of the condition. Types include Established, NamesAccepted and Terminating.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceDefinitionList.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceDefinitionList.java
index fec4ecf3ce4..1b53009bfd2 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceDefinitionList.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceDefinitionList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomResourceDefinitionList is a list of CustomResourceDefinition objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class CustomResourceDefinitionList implements Editable<CustomResourceDefinitionListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.apiextensions.v1.CustomResourceDefinition>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apiextensions.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.apiextensions.v1.CustomResourceDefinition> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CustomResourceDefinitionList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CustomResourceDefinitionList(String apiVersion, List<io.fabric8.kubernete
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items list individual CustomResourceDefinition objects
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.apiextensions.v1.CustomResourceDefinition> getItems() {
         return items;
     }
 
+    /**
+     * items list individual CustomResourceDefinition objects
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.apiextensions.v1.CustomResourceDefinition> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CustomResourceDefinitionList is a list of CustomResourceDefinition objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CustomResourceDefinitionList is a list of CustomResourceDefinition objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceDefinitionNames.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceDefinitionNames.java
index ec5e130f2e4..cc11bac75a7 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceDefinitionNames.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceDefinitionNames.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomResourceDefinitionNames indicates the names to serve this CustomResourceDefinition
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,63 +105,99 @@ public CustomResourceDefinitionNames(List<String> categories, String kind, Strin
         this.singular = singular;
     }
 
+    /**
+     * categories is a list of grouped resources this custom resource belongs to (e.g. 'all'). This is published in API discovery documents, and used by clients to support invocations like `kubectl get all`.
+     */
     @JsonProperty("categories")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCategories() {
         return categories;
     }
 
+    /**
+     * categories is a list of grouped resources this custom resource belongs to (e.g. 'all'). This is published in API discovery documents, and used by clients to support invocations like `kubectl get all`.
+     */
     @JsonProperty("categories")
     public void setCategories(List<String> categories) {
         this.categories = categories;
     }
 
+    /**
+     * kind is the serialized kind of the resource. It is normally CamelCase and singular. Custom resource instances will use this value as the `kind` attribute in API calls.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * kind is the serialized kind of the resource. It is normally CamelCase and singular. Custom resource instances will use this value as the `kind` attribute in API calls.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * listKind is the serialized kind of the list for this resource. Defaults to "`kind`List".
+     */
     @JsonProperty("listKind")
     public String getListKind() {
         return listKind;
     }
 
+    /**
+     * listKind is the serialized kind of the list for this resource. Defaults to "`kind`List".
+     */
     @JsonProperty("listKind")
     public void setListKind(String listKind) {
         this.listKind = listKind;
     }
 
+    /**
+     * plural is the plural name of the resource to serve. The custom resources are served under `/apis/&lt;group&gt;/&lt;version&gt;/.../&lt;plural&gt;`. Must match the name of the CustomResourceDefinition (in the form `&lt;names.plural&gt;.&lt;group&gt;`). Must be all lowercase.
+     */
     @JsonProperty("plural")
     public String getPlural() {
         return plural;
     }
 
+    /**
+     * plural is the plural name of the resource to serve. The custom resources are served under `/apis/&lt;group&gt;/&lt;version&gt;/.../&lt;plural&gt;`. Must match the name of the CustomResourceDefinition (in the form `&lt;names.plural&gt;.&lt;group&gt;`). Must be all lowercase.
+     */
     @JsonProperty("plural")
     public void setPlural(String plural) {
         this.plural = plural;
     }
 
+    /**
+     * shortNames are short names for the resource, exposed in API discovery documents, and used by clients to support invocations like `kubectl get &lt;shortname&gt;`. It must be all lowercase.
+     */
     @JsonProperty("shortNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getShortNames() {
         return shortNames;
     }
 
+    /**
+     * shortNames are short names for the resource, exposed in API discovery documents, and used by clients to support invocations like `kubectl get &lt;shortname&gt;`. It must be all lowercase.
+     */
     @JsonProperty("shortNames")
     public void setShortNames(List<String> shortNames) {
         this.shortNames = shortNames;
     }
 
+    /**
+     * singular is the singular name of the resource. It must be all lowercase. Defaults to lowercased `kind`.
+     */
     @JsonProperty("singular")
     public String getSingular() {
         return singular;
     }
 
+    /**
+     * singular is the singular name of the resource. It must be all lowercase. Defaults to lowercased `kind`.
+     */
     @JsonProperty("singular")
     public void setSingular(String singular) {
         this.singular = singular;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceDefinitionSpec.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceDefinitionSpec.java
index d9d15ddcdcb..b1c70ed1031 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceDefinitionSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceDefinitionSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomResourceDefinitionSpec describes how a user wants their resource to appear
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,62 +104,98 @@ public CustomResourceDefinitionSpec(CustomResourceConversion conversion, String
         this.versions = versions;
     }
 
+    /**
+     * CustomResourceDefinitionSpec describes how a user wants their resource to appear
+     */
     @JsonProperty("conversion")
     public CustomResourceConversion getConversion() {
         return conversion;
     }
 
+    /**
+     * CustomResourceDefinitionSpec describes how a user wants their resource to appear
+     */
     @JsonProperty("conversion")
     public void setConversion(CustomResourceConversion conversion) {
         this.conversion = conversion;
     }
 
+    /**
+     * group is the API group of the defined custom resource. The custom resources are served under `/apis/&lt;group&gt;/...`. Must match the name of the CustomResourceDefinition (in the form `&lt;names.plural&gt;.&lt;group&gt;`).
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * group is the API group of the defined custom resource. The custom resources are served under `/apis/&lt;group&gt;/...`. Must match the name of the CustomResourceDefinition (in the form `&lt;names.plural&gt;.&lt;group&gt;`).
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * CustomResourceDefinitionSpec describes how a user wants their resource to appear
+     */
     @JsonProperty("names")
     public CustomResourceDefinitionNames getNames() {
         return names;
     }
 
+    /**
+     * CustomResourceDefinitionSpec describes how a user wants their resource to appear
+     */
     @JsonProperty("names")
     public void setNames(CustomResourceDefinitionNames names) {
         this.names = names;
     }
 
+    /**
+     * preserveUnknownFields indicates that object fields which are not specified in the OpenAPI schema should be preserved when persisting to storage. apiVersion, kind, metadata and known fields inside metadata are always preserved. This field is deprecated in favor of setting `x-preserve-unknown-fields` to true in `spec.versions[&#42;].schema.openAPIV3Schema`. See https://kubernetes.io/docs/tasks/extend-kubernetes/custom-resources/custom-resource-definitions/#field-pruning for details.
+     */
     @JsonProperty("preserveUnknownFields")
     public Boolean getPreserveUnknownFields() {
         return preserveUnknownFields;
     }
 
+    /**
+     * preserveUnknownFields indicates that object fields which are not specified in the OpenAPI schema should be preserved when persisting to storage. apiVersion, kind, metadata and known fields inside metadata are always preserved. This field is deprecated in favor of setting `x-preserve-unknown-fields` to true in `spec.versions[&#42;].schema.openAPIV3Schema`. See https://kubernetes.io/docs/tasks/extend-kubernetes/custom-resources/custom-resource-definitions/#field-pruning for details.
+     */
     @JsonProperty("preserveUnknownFields")
     public void setPreserveUnknownFields(Boolean preserveUnknownFields) {
         this.preserveUnknownFields = preserveUnknownFields;
     }
 
+    /**
+     * scope indicates whether the defined custom resource is cluster- or namespace-scoped. Allowed values are `Cluster` and `Namespaced`.
+     */
     @JsonProperty("scope")
     public String getScope() {
         return scope;
     }
 
+    /**
+     * scope indicates whether the defined custom resource is cluster- or namespace-scoped. Allowed values are `Cluster` and `Namespaced`.
+     */
     @JsonProperty("scope")
     public void setScope(String scope) {
         this.scope = scope;
     }
 
+    /**
+     * versions is the list of all API versions of the defined custom resource. Version names are used to compute the order in which served versions are listed in API discovery. If the version string is "kube-like", it will sort above non "kube-like" version strings, which are ordered lexicographically. "Kube-like" versions start with a "v", then are followed by a number (the major version), then optionally the string "alpha" or "beta" and another number (the minor version). These are sorted first by GA &gt; beta &gt; alpha (where GA is a version with no suffix such as beta or alpha), and then by comparing major version, then minor version. An example sorted list of versions: v10, v2, v1, v11beta2, v10beta3, v3beta1, v12alpha1, v11alpha2, foo1, foo10.
+     */
     @JsonProperty("versions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CustomResourceDefinitionVersion> getVersions() {
         return versions;
     }
 
+    /**
+     * versions is the list of all API versions of the defined custom resource. Version names are used to compute the order in which served versions are listed in API discovery. If the version string is "kube-like", it will sort above non "kube-like" version strings, which are ordered lexicographically. "Kube-like" versions start with a "v", then are followed by a number (the major version), then optionally the string "alpha" or "beta" and another number (the minor version). These are sorted first by GA &gt; beta &gt; alpha (where GA is a version with no suffix such as beta or alpha), and then by comparing major version, then minor version. An example sorted list of versions: v10, v2, v1, v11beta2, v10beta3, v3beta1, v12alpha1, v11alpha2, foo1, foo10.
+     */
     @JsonProperty("versions")
     public void setVersions(List<CustomResourceDefinitionVersion> versions) {
         this.versions = versions;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceDefinitionStatus.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceDefinitionStatus.java
index 4763123ff3b..d8f187a723e 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceDefinitionStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceDefinitionStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomResourceDefinitionStatus indicates the state of the CustomResourceDefinition
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public CustomResourceDefinitionStatus(CustomResourceDefinitionNames acceptedName
         this.storedVersions = storedVersions;
     }
 
+    /**
+     * CustomResourceDefinitionStatus indicates the state of the CustomResourceDefinition
+     */
     @JsonProperty("acceptedNames")
     public CustomResourceDefinitionNames getAcceptedNames() {
         return acceptedNames;
     }
 
+    /**
+     * CustomResourceDefinitionStatus indicates the state of the CustomResourceDefinition
+     */
     @JsonProperty("acceptedNames")
     public void setAcceptedNames(CustomResourceDefinitionNames acceptedNames) {
         this.acceptedNames = acceptedNames;
     }
 
+    /**
+     * conditions indicate state for particular aspects of a CustomResourceDefinition
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CustomResourceDefinitionCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions indicate state for particular aspects of a CustomResourceDefinition
+     */
     @JsonProperty("conditions")
     public void setConditions(List<CustomResourceDefinitionCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * storedVersions lists all versions of CustomResources that were ever persisted. Tracking these versions allows a migration path for stored versions in etcd. The field is mutable so a migration controller can finish a migration to another version (ensuring no old objects are left in storage), and then remove the rest of the versions from this list. Versions may not be removed from `spec.versions` while they exist in this list.
+     */
     @JsonProperty("storedVersions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getStoredVersions() {
         return storedVersions;
     }
 
+    /**
+     * storedVersions lists all versions of CustomResources that were ever persisted. Tracking these versions allows a migration path for stored versions in etcd. The field is mutable so a migration controller can finish a migration to another version (ensuring no old objects are left in storage), and then remove the rest of the versions from this list. Versions may not be removed from `spec.versions` while they exist in this list.
+     */
     @JsonProperty("storedVersions")
     public void setStoredVersions(List<String> storedVersions) {
         this.storedVersions = storedVersions;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceDefinitionVersion.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceDefinitionVersion.java
index 193e13e2361..136af463239 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceDefinitionVersion.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceDefinitionVersion.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomResourceDefinitionVersion describes a version for CRD.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -114,93 +117,147 @@ public CustomResourceDefinitionVersion(List<CustomResourceColumnDefinition> addi
         this.subresources = subresources;
     }
 
+    /**
+     * additionalPrinterColumns specifies additional columns returned in Table output. See https://kubernetes.io/docs/reference/using-api/api-concepts/#receiving-resources-as-tables for details. If no columns are specified, a single column displaying the age of the custom resource is used.
+     */
     @JsonProperty("additionalPrinterColumns")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CustomResourceColumnDefinition> getAdditionalPrinterColumns() {
         return additionalPrinterColumns;
     }
 
+    /**
+     * additionalPrinterColumns specifies additional columns returned in Table output. See https://kubernetes.io/docs/reference/using-api/api-concepts/#receiving-resources-as-tables for details. If no columns are specified, a single column displaying the age of the custom resource is used.
+     */
     @JsonProperty("additionalPrinterColumns")
     public void setAdditionalPrinterColumns(List<CustomResourceColumnDefinition> additionalPrinterColumns) {
         this.additionalPrinterColumns = additionalPrinterColumns;
     }
 
+    /**
+     * deprecated indicates this version of the custom resource API is deprecated. When set to true, API requests to this version receive a warning header in the server response. Defaults to false.
+     */
     @JsonProperty("deprecated")
     public Boolean getDeprecated() {
         return deprecated;
     }
 
+    /**
+     * deprecated indicates this version of the custom resource API is deprecated. When set to true, API requests to this version receive a warning header in the server response. Defaults to false.
+     */
     @JsonProperty("deprecated")
     public void setDeprecated(Boolean deprecated) {
         this.deprecated = deprecated;
     }
 
+    /**
+     * deprecationWarning overrides the default warning returned to API clients. May only be set when `deprecated` is true. The default warning indicates this version is deprecated and recommends use of the newest served version of equal or greater stability, if one exists.
+     */
     @JsonProperty("deprecationWarning")
     public String getDeprecationWarning() {
         return deprecationWarning;
     }
 
+    /**
+     * deprecationWarning overrides the default warning returned to API clients. May only be set when `deprecated` is true. The default warning indicates this version is deprecated and recommends use of the newest served version of equal or greater stability, if one exists.
+     */
     @JsonProperty("deprecationWarning")
     public void setDeprecationWarning(String deprecationWarning) {
         this.deprecationWarning = deprecationWarning;
     }
 
+    /**
+     * name is the version name, e.g. "v1", "v2beta1", etc. The custom resources are served under this version at `/apis/&lt;group&gt;/&lt;version&gt;/...` if `served` is true.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the version name, e.g. "v1", "v2beta1", etc. The custom resources are served under this version at `/apis/&lt;group&gt;/&lt;version&gt;/...` if `served` is true.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * CustomResourceDefinitionVersion describes a version for CRD.
+     */
     @JsonProperty("schema")
     public CustomResourceValidation getSchema() {
         return schema;
     }
 
+    /**
+     * CustomResourceDefinitionVersion describes a version for CRD.
+     */
     @JsonProperty("schema")
     public void setSchema(CustomResourceValidation schema) {
         this.schema = schema;
     }
 
+    /**
+     * selectableFields specifies paths to fields that may be used as field selectors. A maximum of 8 selectable fields are allowed. See https://kubernetes.io/docs/concepts/overview/working-with-objects/field-selectors
+     */
     @JsonProperty("selectableFields")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SelectableField> getSelectableFields() {
         return selectableFields;
     }
 
+    /**
+     * selectableFields specifies paths to fields that may be used as field selectors. A maximum of 8 selectable fields are allowed. See https://kubernetes.io/docs/concepts/overview/working-with-objects/field-selectors
+     */
     @JsonProperty("selectableFields")
     public void setSelectableFields(List<SelectableField> selectableFields) {
         this.selectableFields = selectableFields;
     }
 
+    /**
+     * served is a flag enabling/disabling this version from being served via REST APIs
+     */
     @JsonProperty("served")
     public Boolean getServed() {
         return served;
     }
 
+    /**
+     * served is a flag enabling/disabling this version from being served via REST APIs
+     */
     @JsonProperty("served")
     public void setServed(Boolean served) {
         this.served = served;
     }
 
+    /**
+     * storage indicates this version should be used when persisting custom resources to storage. There must be exactly one version with storage=true.
+     */
     @JsonProperty("storage")
     public Boolean getStorage() {
         return storage;
     }
 
+    /**
+     * storage indicates this version should be used when persisting custom resources to storage. There must be exactly one version with storage=true.
+     */
     @JsonProperty("storage")
     public void setStorage(Boolean storage) {
         this.storage = storage;
     }
 
+    /**
+     * CustomResourceDefinitionVersion describes a version for CRD.
+     */
     @JsonProperty("subresources")
     public CustomResourceSubresources getSubresources() {
         return subresources;
     }
 
+    /**
+     * CustomResourceDefinitionVersion describes a version for CRD.
+     */
     @JsonProperty("subresources")
     public void setSubresources(CustomResourceSubresources subresources) {
         this.subresources = subresources;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceSubresourceScale.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceSubresourceScale.java
index 5a8176600b8..9fa297c1088 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceSubresourceScale.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceSubresourceScale.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomResourceSubresourceScale defines how to serve the scale subresource for CustomResources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public CustomResourceSubresourceScale(String labelSelectorPath, String specRepli
         this.statusReplicasPath = statusReplicasPath;
     }
 
+    /**
+     * labelSelectorPath defines the JSON path inside of a custom resource that corresponds to Scale `status.selector`. Only JSON paths without the array notation are allowed. Must be a JSON Path under `.status` or `.spec`. Must be set to work with HorizontalPodAutoscaler. The field pointed by this JSON path must be a string field (not a complex selector struct) which contains a serialized label selector in string form. More info: https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions#scale-subresource If there is no value under the given path in the custom resource, the `status.selector` value in the `/scale` subresource will default to the empty string.
+     */
     @JsonProperty("labelSelectorPath")
     public String getLabelSelectorPath() {
         return labelSelectorPath;
     }
 
+    /**
+     * labelSelectorPath defines the JSON path inside of a custom resource that corresponds to Scale `status.selector`. Only JSON paths without the array notation are allowed. Must be a JSON Path under `.status` or `.spec`. Must be set to work with HorizontalPodAutoscaler. The field pointed by this JSON path must be a string field (not a complex selector struct) which contains a serialized label selector in string form. More info: https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions#scale-subresource If there is no value under the given path in the custom resource, the `status.selector` value in the `/scale` subresource will default to the empty string.
+     */
     @JsonProperty("labelSelectorPath")
     public void setLabelSelectorPath(String labelSelectorPath) {
         this.labelSelectorPath = labelSelectorPath;
     }
 
+    /**
+     * specReplicasPath defines the JSON path inside of a custom resource that corresponds to Scale `spec.replicas`. Only JSON paths without the array notation are allowed. Must be a JSON Path under `.spec`. If there is no value under the given path in the custom resource, the `/scale` subresource will return an error on GET.
+     */
     @JsonProperty("specReplicasPath")
     public String getSpecReplicasPath() {
         return specReplicasPath;
     }
 
+    /**
+     * specReplicasPath defines the JSON path inside of a custom resource that corresponds to Scale `spec.replicas`. Only JSON paths without the array notation are allowed. Must be a JSON Path under `.spec`. If there is no value under the given path in the custom resource, the `/scale` subresource will return an error on GET.
+     */
     @JsonProperty("specReplicasPath")
     public void setSpecReplicasPath(String specReplicasPath) {
         this.specReplicasPath = specReplicasPath;
     }
 
+    /**
+     * statusReplicasPath defines the JSON path inside of a custom resource that corresponds to Scale `status.replicas`. Only JSON paths without the array notation are allowed. Must be a JSON Path under `.status`. If there is no value under the given path in the custom resource, the `status.replicas` value in the `/scale` subresource will default to 0.
+     */
     @JsonProperty("statusReplicasPath")
     public String getStatusReplicasPath() {
         return statusReplicasPath;
     }
 
+    /**
+     * statusReplicasPath defines the JSON path inside of a custom resource that corresponds to Scale `status.replicas`. Only JSON paths without the array notation are allowed. Must be a JSON Path under `.status`. If there is no value under the given path in the custom resource, the `status.replicas` value in the `/scale` subresource will default to 0.
+     */
     @JsonProperty("statusReplicasPath")
     public void setStatusReplicasPath(String statusReplicasPath) {
         this.statusReplicasPath = statusReplicasPath;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceSubresourceStatus.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceSubresourceStatus.java
index dc77223d39e..7440e3b82f7 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceSubresourceStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceSubresourceStatus.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomResourceSubresourceStatus defines how to serve the status subresource for CustomResources. Status is represented by the `.status` JSON path inside of a CustomResource. When set, &#42; exposes a /status subresource for the custom resource &#42; PUT requests to the /status subresource take a custom resource object, and ignore changes to anything except the status stanza &#42; PUT/POST/PATCH requests to the custom resource ignore changes to the status stanza
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceSubresources.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceSubresources.java
index 073b99e2ecd..ff79a946dda 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceSubresources.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceSubresources.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomResourceSubresources defines the status and scale subresources for CustomResources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public CustomResourceSubresources(CustomResourceSubresourceScale scale, CustomRe
         this.status = status;
     }
 
+    /**
+     * CustomResourceSubresources defines the status and scale subresources for CustomResources.
+     */
     @JsonProperty("scale")
     public CustomResourceSubresourceScale getScale() {
         return scale;
     }
 
+    /**
+     * CustomResourceSubresources defines the status and scale subresources for CustomResources.
+     */
     @JsonProperty("scale")
     public void setScale(CustomResourceSubresourceScale scale) {
         this.scale = scale;
     }
 
+    /**
+     * CustomResourceSubresources defines the status and scale subresources for CustomResources.
+     */
     @JsonProperty("status")
     public CustomResourceSubresourceStatus getStatus() {
         return status;
     }
 
+    /**
+     * CustomResourceSubresources defines the status and scale subresources for CustomResources.
+     */
     @JsonProperty("status")
     public void setStatus(CustomResourceSubresourceStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceValidation.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceValidation.java
index 296c1e3ee0f..4333db44276 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceValidation.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/CustomResourceValidation.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomResourceValidation is a list of validation methods for CustomResources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public CustomResourceValidation(JSONSchemaProps openAPIV3Schema) {
         this.openAPIV3Schema = openAPIV3Schema;
     }
 
+    /**
+     * CustomResourceValidation is a list of validation methods for CustomResources.
+     */
     @JsonProperty("openAPIV3Schema")
     public JSONSchemaProps getOpenAPIV3Schema() {
         return openAPIV3Schema;
     }
 
+    /**
+     * CustomResourceValidation is a list of validation methods for CustomResources.
+     */
     @JsonProperty("openAPIV3Schema")
     public void setOpenAPIV3Schema(JSONSchemaProps openAPIV3Schema) {
         this.openAPIV3Schema = openAPIV3Schema;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/SelectableField.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/SelectableField.java
index 1564adb67da..6da547d97e6 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/SelectableField.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/SelectableField.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SelectableField specifies the JSON path of a field that may be used with field selectors.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public SelectableField(String jsonPath) {
         this.jsonPath = jsonPath;
     }
 
+    /**
+     * jsonPath is a simple JSON path which is evaluated against each custom resource to produce a field selector value. Only JSON paths without the array notation are allowed. Must point to a field of type string, boolean or integer. Types with enum values and strings with formats are allowed. If jsonPath refers to absent field in a resource, the jsonPath evaluates to an empty string. Must not point to metdata fields. Required.
+     */
     @JsonProperty("jsonPath")
     public String getJsonPath() {
         return jsonPath;
     }
 
+    /**
+     * jsonPath is a simple JSON path which is evaluated against each custom resource to produce a field selector value. Only JSON paths without the array notation are allowed. Must point to a field of type string, boolean or integer. Types with enum values and strings with formats are allowed. If jsonPath refers to absent field in a resource, the jsonPath evaluates to an empty string. Must not point to metdata fields. Required.
+     */
     @JsonProperty("jsonPath")
     public void setJsonPath(String jsonPath) {
         this.jsonPath = jsonPath;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/ServiceReference.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/ServiceReference.java
index d7cda647eea..b033f50b9ed 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/ServiceReference.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/ServiceReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceReference holds a reference to Service.legacy.k8s.io
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ServiceReference(String name, String namespace, String path, Integer port
         this.port = port;
     }
 
+    /**
+     * name is the name of the service. Required
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the service. Required
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * namespace is the namespace of the service. Required
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * namespace is the namespace of the service. Required
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * path is an optional URL path at which the webhook will be contacted.
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * path is an optional URL path at which the webhook will be contacted.
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * port is an optional service port at which the webhook will be contacted. `port` should be a valid port number (1-65535, inclusive). Defaults to 443 for backward compatibility.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * port is an optional service port at which the webhook will be contacted. `port` should be a valid port number (1-65535, inclusive). Defaults to 443 for backward compatibility.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/WebhookClientConfig.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/WebhookClientConfig.java
index c39f2118325..2b968cd4cd4 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/WebhookClientConfig.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/WebhookClientConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WebhookClientConfig contains the information to make a TLS connection with the webhook.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public WebhookClientConfig(String caBundle, ServiceReference service, String url
         this.url = url;
     }
 
+    /**
+     * caBundle is a PEM encoded CA bundle which will be used to validate the webhook's server certificate. If unspecified, system trust roots on the apiserver are used.
+     */
     @JsonProperty("caBundle")
     public String getCaBundle() {
         return caBundle;
     }
 
+    /**
+     * caBundle is a PEM encoded CA bundle which will be used to validate the webhook's server certificate. If unspecified, system trust roots on the apiserver are used.
+     */
     @JsonProperty("caBundle")
     public void setCaBundle(String caBundle) {
         this.caBundle = caBundle;
     }
 
+    /**
+     * WebhookClientConfig contains the information to make a TLS connection with the webhook.
+     */
     @JsonProperty("service")
     public ServiceReference getService() {
         return service;
     }
 
+    /**
+     * WebhookClientConfig contains the information to make a TLS connection with the webhook.
+     */
     @JsonProperty("service")
     public void setService(ServiceReference service) {
         this.service = service;
     }
 
+    /**
+     * url gives the location of the webhook, in standard URL form (`scheme://host:port/path`). Exactly one of `url` or `service` must be specified.<br><p> <br><p> The `host` should not refer to a service running in the cluster; use the `service` field instead. The host might be resolved via external DNS in some apiservers (e.g., `kube-apiserver` cannot resolve in-cluster DNS as that would be a layering violation). `host` may also be an IP address.<br><p> <br><p> Please note that using `localhost` or `127.0.0.1` as a `host` is risky unless you take great care to run this webhook on all hosts which run an apiserver which might need to make calls to this webhook. Such installs are likely to be non-portable, i.e., not easy to turn up in a new cluster.<br><p> <br><p> The scheme must be "https"; the URL must begin with "https://".<br><p> <br><p> A path is optional, and if present may be any string permissible in a URL. You may use the path to pass an arbitrary string to the webhook, for example, a cluster identifier.<br><p> <br><p> Attempting to use a user or basic auth e.g. "user:password@" is not allowed. Fragments ("#...") and query parameters ("?...") are not allowed, either.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * url gives the location of the webhook, in standard URL form (`scheme://host:port/path`). Exactly one of `url` or `service` must be specified.<br><p> <br><p> The `host` should not refer to a service running in the cluster; use the `service` field instead. The host might be resolved via external DNS in some apiservers (e.g., `kube-apiserver` cannot resolve in-cluster DNS as that would be a layering violation). `host` may also be an IP address.<br><p> <br><p> Please note that using `localhost` or `127.0.0.1` as a `host` is risky unless you take great care to run this webhook on all hosts which run an apiserver which might need to make calls to this webhook. Such installs are likely to be non-portable, i.e., not easy to turn up in a new cluster.<br><p> <br><p> The scheme must be "https"; the URL must begin with "https://".<br><p> <br><p> A path is optional, and if present may be any string permissible in a URL. You may use the path to pass an arbitrary string to the webhook, for example, a cluster identifier.<br><p> <br><p> Attempting to use a user or basic auth e.g. "user:password@" is not allowed. Fragments ("#...") and query parameters ("?...") are not allowed, either.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/WebhookConversion.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/WebhookConversion.java
index dc1a9622b8a..48bd2deb15d 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/WebhookConversion.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1/WebhookConversion.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WebhookConversion describes how to call a conversion webhook
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public WebhookConversion(WebhookClientConfig clientConfig, List<String> conversi
         this.conversionReviewVersions = conversionReviewVersions;
     }
 
+    /**
+     * WebhookConversion describes how to call a conversion webhook
+     */
     @JsonProperty("clientConfig")
     public WebhookClientConfig getClientConfig() {
         return clientConfig;
     }
 
+    /**
+     * WebhookConversion describes how to call a conversion webhook
+     */
     @JsonProperty("clientConfig")
     public void setClientConfig(WebhookClientConfig clientConfig) {
         this.clientConfig = clientConfig;
     }
 
+    /**
+     * conversionReviewVersions is an ordered list of preferred `ConversionReview` versions the Webhook expects. The API server will use the first version in the list which it supports. If none of the versions specified in this list are supported by API server, conversion will fail for the custom resource. If a persisted Webhook configuration specifies allowed versions and does not include any versions known to the API Server, calls to the webhook will fail.
+     */
     @JsonProperty("conversionReviewVersions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getConversionReviewVersions() {
         return conversionReviewVersions;
     }
 
+    /**
+     * conversionReviewVersions is an ordered list of preferred `ConversionReview` versions the Webhook expects. The API server will use the first version in the list which it supports. If none of the versions specified in this list are supported by API server, conversion will fail for the custom resource. If a persisted Webhook configuration specifies allowed versions and does not include any versions known to the API Server, calls to the webhook will fail.
+     */
     @JsonProperty("conversionReviewVersions")
     public void setConversionReviewVersions(List<String> conversionReviewVersions) {
         this.conversionReviewVersions = conversionReviewVersions;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceColumnDefinition.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceColumnDefinition.java
index edc7221e5e4..97f5cfea0f4 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceColumnDefinition.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceColumnDefinition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomResourceColumnDefinition specifies a column for server side printing.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public CustomResourceColumnDefinition(String jSONPath, String description, Strin
         this.type = type;
     }
 
+    /**
+     * JSONPath is a simple JSON path (i.e. with array notation) which is evaluated against each custom resource to produce the value for this column.
+     */
     @JsonProperty("JSONPath")
     public String getJSONPath() {
         return jSONPath;
     }
 
+    /**
+     * JSONPath is a simple JSON path (i.e. with array notation) which is evaluated against each custom resource to produce the value for this column.
+     */
     @JsonProperty("JSONPath")
     public void setJSONPath(String jSONPath) {
         this.jSONPath = jSONPath;
     }
 
+    /**
+     * description is a human readable description of this column.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * description is a human readable description of this column.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * format is an optional OpenAPI type definition for this column. The 'name' format is applied to the primary identifier column to assist in clients identifying column is the resource name. See https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#data-types for details.
+     */
     @JsonProperty("format")
     public String getFormat() {
         return format;
     }
 
+    /**
+     * format is an optional OpenAPI type definition for this column. The 'name' format is applied to the primary identifier column to assist in clients identifying column is the resource name. See https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#data-types for details.
+     */
     @JsonProperty("format")
     public void setFormat(String format) {
         this.format = format;
     }
 
+    /**
+     * name is a human readable name for the column.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is a human readable name for the column.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * priority is an integer defining the relative importance of this column compared to others. Lower numbers are considered higher priority. Columns that may be omitted in limited space scenarios should be given a priority greater than 0.
+     */
     @JsonProperty("priority")
     public Integer getPriority() {
         return priority;
     }
 
+    /**
+     * priority is an integer defining the relative importance of this column compared to others. Lower numbers are considered higher priority. Columns that may be omitted in limited space scenarios should be given a priority greater than 0.
+     */
     @JsonProperty("priority")
     public void setPriority(Integer priority) {
         this.priority = priority;
     }
 
+    /**
+     * type is an OpenAPI type definition for this column. See https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#data-types for details.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is an OpenAPI type definition for this column. See https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#data-types for details.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceConversion.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceConversion.java
index b6b5bbe80f6..14723609c47 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceConversion.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceConversion.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomResourceConversion describes how to convert different versions of a CR.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public CustomResourceConversion(List<String> conversionReviewVersions, String st
         this.webhookClientConfig = webhookClientConfig;
     }
 
+    /**
+     * conversionReviewVersions is an ordered list of preferred `ConversionReview` versions the Webhook expects. The API server will use the first version in the list which it supports. If none of the versions specified in this list are supported by API server, conversion will fail for the custom resource. If a persisted Webhook configuration specifies allowed versions and does not include any versions known to the API Server, calls to the webhook will fail. Defaults to `["v1beta1"]`.
+     */
     @JsonProperty("conversionReviewVersions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getConversionReviewVersions() {
         return conversionReviewVersions;
     }
 
+    /**
+     * conversionReviewVersions is an ordered list of preferred `ConversionReview` versions the Webhook expects. The API server will use the first version in the list which it supports. If none of the versions specified in this list are supported by API server, conversion will fail for the custom resource. If a persisted Webhook configuration specifies allowed versions and does not include any versions known to the API Server, calls to the webhook will fail. Defaults to `["v1beta1"]`.
+     */
     @JsonProperty("conversionReviewVersions")
     public void setConversionReviewVersions(List<String> conversionReviewVersions) {
         this.conversionReviewVersions = conversionReviewVersions;
     }
 
+    /**
+     * strategy specifies how custom resources are converted between versions. Allowed values are: - `None`: The converter only change the apiVersion and would not touch any other field in the custom resource. - `Webhook`: API Server will call to an external webhook to do the conversion. Additional information<br><p>   is needed for this option. This requires spec.preserveUnknownFields to be false, and spec.conversion.webhookClientConfig to be set.
+     */
     @JsonProperty("strategy")
     public String getStrategy() {
         return strategy;
     }
 
+    /**
+     * strategy specifies how custom resources are converted between versions. Allowed values are: - `None`: The converter only change the apiVersion and would not touch any other field in the custom resource. - `Webhook`: API Server will call to an external webhook to do the conversion. Additional information<br><p>   is needed for this option. This requires spec.preserveUnknownFields to be false, and spec.conversion.webhookClientConfig to be set.
+     */
     @JsonProperty("strategy")
     public void setStrategy(String strategy) {
         this.strategy = strategy;
     }
 
+    /**
+     * CustomResourceConversion describes how to convert different versions of a CR.
+     */
     @JsonProperty("webhookClientConfig")
     public WebhookClientConfig getWebhookClientConfig() {
         return webhookClientConfig;
     }
 
+    /**
+     * CustomResourceConversion describes how to convert different versions of a CR.
+     */
     @JsonProperty("webhookClientConfig")
     public void setWebhookClientConfig(WebhookClientConfig webhookClientConfig) {
         this.webhookClientConfig = webhookClientConfig;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceDefinition.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceDefinition.java
index e6b1aa4e7f8..47e1fbe28ac 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceDefinition.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceDefinition.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomResourceDefinition represents a resource that should be exposed on the API server.  Its name MUST be in the format &lt;.spec.name&gt;.&lt;.spec.group&gt;. Deprecated in v1.16, planned for removal in v1.22. Use apiextensions.k8s.io/v1 CustomResourceDefinition instead.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class CustomResourceDefinition implements Editable<CustomResourceDefinitionBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apiextensions.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CustomResourceDefinition";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public CustomResourceDefinition(String apiVersion, String kind, ObjectMeta metad
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CustomResourceDefinition represents a resource that should be exposed on the API server.  Its name MUST be in the format &lt;.spec.name&gt;.&lt;.spec.group&gt;. Deprecated in v1.16, planned for removal in v1.22. Use apiextensions.k8s.io/v1 CustomResourceDefinition instead.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CustomResourceDefinition represents a resource that should be exposed on the API server.  Its name MUST be in the format &lt;.spec.name&gt;.&lt;.spec.group&gt;. Deprecated in v1.16, planned for removal in v1.22. Use apiextensions.k8s.io/v1 CustomResourceDefinition instead.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * CustomResourceDefinition represents a resource that should be exposed on the API server.  Its name MUST be in the format &lt;.spec.name&gt;.&lt;.spec.group&gt;. Deprecated in v1.16, planned for removal in v1.22. Use apiextensions.k8s.io/v1 CustomResourceDefinition instead.
+     */
     @JsonProperty("spec")
     public CustomResourceDefinitionSpec getSpec() {
         return spec;
     }
 
+    /**
+     * CustomResourceDefinition represents a resource that should be exposed on the API server.  Its name MUST be in the format &lt;.spec.name&gt;.&lt;.spec.group&gt;. Deprecated in v1.16, planned for removal in v1.22. Use apiextensions.k8s.io/v1 CustomResourceDefinition instead.
+     */
     @JsonProperty("spec")
     public void setSpec(CustomResourceDefinitionSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * CustomResourceDefinition represents a resource that should be exposed on the API server.  Its name MUST be in the format &lt;.spec.name&gt;.&lt;.spec.group&gt;. Deprecated in v1.16, planned for removal in v1.22. Use apiextensions.k8s.io/v1 CustomResourceDefinition instead.
+     */
     @JsonProperty("status")
     public CustomResourceDefinitionStatus getStatus() {
         return status;
     }
 
+    /**
+     * CustomResourceDefinition represents a resource that should be exposed on the API server.  Its name MUST be in the format &lt;.spec.name&gt;.&lt;.spec.group&gt;. Deprecated in v1.16, planned for removal in v1.22. Use apiextensions.k8s.io/v1 CustomResourceDefinition instead.
+     */
     @JsonProperty("status")
     public void setStatus(CustomResourceDefinitionStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceDefinitionCondition.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceDefinitionCondition.java
index b7ea8c6e615..799ed32e145 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceDefinitionCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceDefinitionCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomResourceDefinitionCondition contains details for the current condition of this pod.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public CustomResourceDefinitionCondition(String lastTransitionTime, String messa
         this.type = type;
     }
 
+    /**
+     * CustomResourceDefinitionCondition contains details for the current condition of this pod.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * CustomResourceDefinitionCondition contains details for the current condition of this pod.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * message is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * reason is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * reason is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * status is the status of the condition. Can be True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * status is the status of the condition. Can be True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * type is the type of the condition. Types include Established, NamesAccepted and Terminating.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the type of the condition. Types include Established, NamesAccepted and Terminating.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceDefinitionList.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceDefinitionList.java
index 1e2cf79937d..1769ec406c2 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceDefinitionList.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceDefinitionList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomResourceDefinitionList is a list of CustomResourceDefinition objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class CustomResourceDefinitionList implements Editable<CustomResourceDefinitionListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.apiextensions.v1beta1.CustomResourceDefinition>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apiextensions.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.apiextensions.v1beta1.CustomResourceDefinition> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CustomResourceDefinitionList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CustomResourceDefinitionList(String apiVersion, List<io.fabric8.kubernete
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items list individual CustomResourceDefinition objects
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.apiextensions.v1beta1.CustomResourceDefinition> getItems() {
         return items;
     }
 
+    /**
+     * items list individual CustomResourceDefinition objects
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.apiextensions.v1beta1.CustomResourceDefinition> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CustomResourceDefinitionList is a list of CustomResourceDefinition objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CustomResourceDefinitionList is a list of CustomResourceDefinition objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceDefinitionNames.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceDefinitionNames.java
index 18a9c4805c3..9bad5687ad7 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceDefinitionNames.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceDefinitionNames.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomResourceDefinitionNames indicates the names to serve this CustomResourceDefinition
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,63 +105,99 @@ public CustomResourceDefinitionNames(List<String> categories, String kind, Strin
         this.singular = singular;
     }
 
+    /**
+     * categories is a list of grouped resources this custom resource belongs to (e.g. 'all'). This is published in API discovery documents, and used by clients to support invocations like `kubectl get all`.
+     */
     @JsonProperty("categories")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCategories() {
         return categories;
     }
 
+    /**
+     * categories is a list of grouped resources this custom resource belongs to (e.g. 'all'). This is published in API discovery documents, and used by clients to support invocations like `kubectl get all`.
+     */
     @JsonProperty("categories")
     public void setCategories(List<String> categories) {
         this.categories = categories;
     }
 
+    /**
+     * kind is the serialized kind of the resource. It is normally CamelCase and singular. Custom resource instances will use this value as the `kind` attribute in API calls.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * kind is the serialized kind of the resource. It is normally CamelCase and singular. Custom resource instances will use this value as the `kind` attribute in API calls.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * listKind is the serialized kind of the list for this resource. Defaults to "`kind`List".
+     */
     @JsonProperty("listKind")
     public String getListKind() {
         return listKind;
     }
 
+    /**
+     * listKind is the serialized kind of the list for this resource. Defaults to "`kind`List".
+     */
     @JsonProperty("listKind")
     public void setListKind(String listKind) {
         this.listKind = listKind;
     }
 
+    /**
+     * plural is the plural name of the resource to serve. The custom resources are served under `/apis/&lt;group&gt;/&lt;version&gt;/.../&lt;plural&gt;`. Must match the name of the CustomResourceDefinition (in the form `&lt;names.plural&gt;.&lt;group&gt;`). Must be all lowercase.
+     */
     @JsonProperty("plural")
     public String getPlural() {
         return plural;
     }
 
+    /**
+     * plural is the plural name of the resource to serve. The custom resources are served under `/apis/&lt;group&gt;/&lt;version&gt;/.../&lt;plural&gt;`. Must match the name of the CustomResourceDefinition (in the form `&lt;names.plural&gt;.&lt;group&gt;`). Must be all lowercase.
+     */
     @JsonProperty("plural")
     public void setPlural(String plural) {
         this.plural = plural;
     }
 
+    /**
+     * shortNames are short names for the resource, exposed in API discovery documents, and used by clients to support invocations like `kubectl get &lt;shortname&gt;`. It must be all lowercase.
+     */
     @JsonProperty("shortNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getShortNames() {
         return shortNames;
     }
 
+    /**
+     * shortNames are short names for the resource, exposed in API discovery documents, and used by clients to support invocations like `kubectl get &lt;shortname&gt;`. It must be all lowercase.
+     */
     @JsonProperty("shortNames")
     public void setShortNames(List<String> shortNames) {
         this.shortNames = shortNames;
     }
 
+    /**
+     * singular is the singular name of the resource. It must be all lowercase. Defaults to lowercased `kind`.
+     */
     @JsonProperty("singular")
     public String getSingular() {
         return singular;
     }
 
+    /**
+     * singular is the singular name of the resource. It must be all lowercase. Defaults to lowercased `kind`.
+     */
     @JsonProperty("singular")
     public void setSingular(String singular) {
         this.singular = singular;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceDefinitionSpec.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceDefinitionSpec.java
index 8dd6f4395b1..463c5df0d43 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceDefinitionSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceDefinitionSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomResourceDefinitionSpec describes how a user wants their resource to appear
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -118,103 +121,163 @@ public CustomResourceDefinitionSpec(List<CustomResourceColumnDefinition> additio
         this.versions = versions;
     }
 
+    /**
+     * additionalPrinterColumns specifies additional columns returned in Table output. See https://kubernetes.io/docs/reference/using-api/api-concepts/#receiving-resources-as-tables for details. If present, this field configures columns for all versions. Top-level and per-version columns are mutually exclusive. If no top-level or per-version columns are specified, a single column displaying the age of the custom resource is used.
+     */
     @JsonProperty("additionalPrinterColumns")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CustomResourceColumnDefinition> getAdditionalPrinterColumns() {
         return additionalPrinterColumns;
     }
 
+    /**
+     * additionalPrinterColumns specifies additional columns returned in Table output. See https://kubernetes.io/docs/reference/using-api/api-concepts/#receiving-resources-as-tables for details. If present, this field configures columns for all versions. Top-level and per-version columns are mutually exclusive. If no top-level or per-version columns are specified, a single column displaying the age of the custom resource is used.
+     */
     @JsonProperty("additionalPrinterColumns")
     public void setAdditionalPrinterColumns(List<CustomResourceColumnDefinition> additionalPrinterColumns) {
         this.additionalPrinterColumns = additionalPrinterColumns;
     }
 
+    /**
+     * CustomResourceDefinitionSpec describes how a user wants their resource to appear
+     */
     @JsonProperty("conversion")
     public CustomResourceConversion getConversion() {
         return conversion;
     }
 
+    /**
+     * CustomResourceDefinitionSpec describes how a user wants their resource to appear
+     */
     @JsonProperty("conversion")
     public void setConversion(CustomResourceConversion conversion) {
         this.conversion = conversion;
     }
 
+    /**
+     * group is the API group of the defined custom resource. The custom resources are served under `/apis/&lt;group&gt;/...`. Must match the name of the CustomResourceDefinition (in the form `&lt;names.plural&gt;.&lt;group&gt;`).
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * group is the API group of the defined custom resource. The custom resources are served under `/apis/&lt;group&gt;/...`. Must match the name of the CustomResourceDefinition (in the form `&lt;names.plural&gt;.&lt;group&gt;`).
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * CustomResourceDefinitionSpec describes how a user wants their resource to appear
+     */
     @JsonProperty("names")
     public CustomResourceDefinitionNames getNames() {
         return names;
     }
 
+    /**
+     * CustomResourceDefinitionSpec describes how a user wants their resource to appear
+     */
     @JsonProperty("names")
     public void setNames(CustomResourceDefinitionNames names) {
         this.names = names;
     }
 
+    /**
+     * preserveUnknownFields indicates that object fields which are not specified in the OpenAPI schema should be preserved when persisting to storage. apiVersion, kind, metadata and known fields inside metadata are always preserved. If false, schemas must be defined for all versions. Defaults to true in v1beta for backwards compatibility. Deprecated: will be required to be false in v1. Preservation of unknown fields can be specified in the validation schema using the `x-kubernetes-preserve-unknown-fields: true` extension. See https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/#pruning-versus-preserving-unknown-fields for details.
+     */
     @JsonProperty("preserveUnknownFields")
     public Boolean getPreserveUnknownFields() {
         return preserveUnknownFields;
     }
 
+    /**
+     * preserveUnknownFields indicates that object fields which are not specified in the OpenAPI schema should be preserved when persisting to storage. apiVersion, kind, metadata and known fields inside metadata are always preserved. If false, schemas must be defined for all versions. Defaults to true in v1beta for backwards compatibility. Deprecated: will be required to be false in v1. Preservation of unknown fields can be specified in the validation schema using the `x-kubernetes-preserve-unknown-fields: true` extension. See https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/#pruning-versus-preserving-unknown-fields for details.
+     */
     @JsonProperty("preserveUnknownFields")
     public void setPreserveUnknownFields(Boolean preserveUnknownFields) {
         this.preserveUnknownFields = preserveUnknownFields;
     }
 
+    /**
+     * scope indicates whether the defined custom resource is cluster- or namespace-scoped. Allowed values are `Cluster` and `Namespaced`. Default is `Namespaced`.
+     */
     @JsonProperty("scope")
     public String getScope() {
         return scope;
     }
 
+    /**
+     * scope indicates whether the defined custom resource is cluster- or namespace-scoped. Allowed values are `Cluster` and `Namespaced`. Default is `Namespaced`.
+     */
     @JsonProperty("scope")
     public void setScope(String scope) {
         this.scope = scope;
     }
 
+    /**
+     * CustomResourceDefinitionSpec describes how a user wants their resource to appear
+     */
     @JsonProperty("subresources")
     public CustomResourceSubresources getSubresources() {
         return subresources;
     }
 
+    /**
+     * CustomResourceDefinitionSpec describes how a user wants their resource to appear
+     */
     @JsonProperty("subresources")
     public void setSubresources(CustomResourceSubresources subresources) {
         this.subresources = subresources;
     }
 
+    /**
+     * CustomResourceDefinitionSpec describes how a user wants their resource to appear
+     */
     @JsonProperty("validation")
     public CustomResourceValidation getValidation() {
         return validation;
     }
 
+    /**
+     * CustomResourceDefinitionSpec describes how a user wants their resource to appear
+     */
     @JsonProperty("validation")
     public void setValidation(CustomResourceValidation validation) {
         this.validation = validation;
     }
 
+    /**
+     * version is the API version of the defined custom resource. The custom resources are served under `/apis/&lt;group&gt;/&lt;version&gt;/...`. Must match the name of the first item in the `versions` list if `version` and `versions` are both specified. Optional if `versions` is specified. Deprecated: use `versions` instead.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the API version of the defined custom resource. The custom resources are served under `/apis/&lt;group&gt;/&lt;version&gt;/...`. Must match the name of the first item in the `versions` list if `version` and `versions` are both specified. Optional if `versions` is specified. Deprecated: use `versions` instead.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
     }
 
+    /**
+     * versions is the list of all API versions of the defined custom resource. Optional if `version` is specified. The name of the first item in the `versions` list must match the `version` field if `version` and `versions` are both specified. Version names are used to compute the order in which served versions are listed in API discovery. If the version string is "kube-like", it will sort above non "kube-like" version strings, which are ordered lexicographically. "Kube-like" versions start with a "v", then are followed by a number (the major version), then optionally the string "alpha" or "beta" and another number (the minor version). These are sorted first by GA &gt; beta &gt; alpha (where GA is a version with no suffix such as beta or alpha), and then by comparing major version, then minor version. An example sorted list of versions: v10, v2, v1, v11beta2, v10beta3, v3beta1, v12alpha1, v11alpha2, foo1, foo10.
+     */
     @JsonProperty("versions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CustomResourceDefinitionVersion> getVersions() {
         return versions;
     }
 
+    /**
+     * versions is the list of all API versions of the defined custom resource. Optional if `version` is specified. The name of the first item in the `versions` list must match the `version` field if `version` and `versions` are both specified. Version names are used to compute the order in which served versions are listed in API discovery. If the version string is "kube-like", it will sort above non "kube-like" version strings, which are ordered lexicographically. "Kube-like" versions start with a "v", then are followed by a number (the major version), then optionally the string "alpha" or "beta" and another number (the minor version). These are sorted first by GA &gt; beta &gt; alpha (where GA is a version with no suffix such as beta or alpha), and then by comparing major version, then minor version. An example sorted list of versions: v10, v2, v1, v11beta2, v10beta3, v3beta1, v12alpha1, v11alpha2, foo1, foo10.
+     */
     @JsonProperty("versions")
     public void setVersions(List<CustomResourceDefinitionVersion> versions) {
         this.versions = versions;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceDefinitionStatus.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceDefinitionStatus.java
index b8cbdbd1adc..bb72bb22177 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceDefinitionStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceDefinitionStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomResourceDefinitionStatus indicates the state of the CustomResourceDefinition
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public CustomResourceDefinitionStatus(CustomResourceDefinitionNames acceptedName
         this.storedVersions = storedVersions;
     }
 
+    /**
+     * CustomResourceDefinitionStatus indicates the state of the CustomResourceDefinition
+     */
     @JsonProperty("acceptedNames")
     public CustomResourceDefinitionNames getAcceptedNames() {
         return acceptedNames;
     }
 
+    /**
+     * CustomResourceDefinitionStatus indicates the state of the CustomResourceDefinition
+     */
     @JsonProperty("acceptedNames")
     public void setAcceptedNames(CustomResourceDefinitionNames acceptedNames) {
         this.acceptedNames = acceptedNames;
     }
 
+    /**
+     * conditions indicate state for particular aspects of a CustomResourceDefinition
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CustomResourceDefinitionCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions indicate state for particular aspects of a CustomResourceDefinition
+     */
     @JsonProperty("conditions")
     public void setConditions(List<CustomResourceDefinitionCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * storedVersions lists all versions of CustomResources that were ever persisted. Tracking these versions allows a migration path for stored versions in etcd. The field is mutable so a migration controller can finish a migration to another version (ensuring no old objects are left in storage), and then remove the rest of the versions from this list. Versions may not be removed from `spec.versions` while they exist in this list.
+     */
     @JsonProperty("storedVersions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getStoredVersions() {
         return storedVersions;
     }
 
+    /**
+     * storedVersions lists all versions of CustomResources that were ever persisted. Tracking these versions allows a migration path for stored versions in etcd. The field is mutable so a migration controller can finish a migration to another version (ensuring no old objects are left in storage), and then remove the rest of the versions from this list. Versions may not be removed from `spec.versions` while they exist in this list.
+     */
     @JsonProperty("storedVersions")
     public void setStoredVersions(List<String> storedVersions) {
         this.storedVersions = storedVersions;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceDefinitionVersion.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceDefinitionVersion.java
index e36a309de1d..85276ead3e4 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceDefinitionVersion.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceDefinitionVersion.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomResourceDefinitionVersion describes a version for CRD.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -109,82 +112,130 @@ public CustomResourceDefinitionVersion(List<CustomResourceColumnDefinition> addi
         this.subresources = subresources;
     }
 
+    /**
+     * additionalPrinterColumns specifies additional columns returned in Table output. See https://kubernetes.io/docs/reference/using-api/api-concepts/#receiving-resources-as-tables for details. Top-level and per-version columns are mutually exclusive. Per-version columns must not all be set to identical values (top-level columns should be used instead). If no top-level or per-version columns are specified, a single column displaying the age of the custom resource is used.
+     */
     @JsonProperty("additionalPrinterColumns")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CustomResourceColumnDefinition> getAdditionalPrinterColumns() {
         return additionalPrinterColumns;
     }
 
+    /**
+     * additionalPrinterColumns specifies additional columns returned in Table output. See https://kubernetes.io/docs/reference/using-api/api-concepts/#receiving-resources-as-tables for details. Top-level and per-version columns are mutually exclusive. Per-version columns must not all be set to identical values (top-level columns should be used instead). If no top-level or per-version columns are specified, a single column displaying the age of the custom resource is used.
+     */
     @JsonProperty("additionalPrinterColumns")
     public void setAdditionalPrinterColumns(List<CustomResourceColumnDefinition> additionalPrinterColumns) {
         this.additionalPrinterColumns = additionalPrinterColumns;
     }
 
+    /**
+     * deprecated indicates this version of the custom resource API is deprecated. When set to true, API requests to this version receive a warning header in the server response. Defaults to false.
+     */
     @JsonProperty("deprecated")
     public Boolean getDeprecated() {
         return deprecated;
     }
 
+    /**
+     * deprecated indicates this version of the custom resource API is deprecated. When set to true, API requests to this version receive a warning header in the server response. Defaults to false.
+     */
     @JsonProperty("deprecated")
     public void setDeprecated(Boolean deprecated) {
         this.deprecated = deprecated;
     }
 
+    /**
+     * deprecationWarning overrides the default warning returned to API clients. May only be set when `deprecated` is true. The default warning indicates this version is deprecated and recommends use of the newest served version of equal or greater stability, if one exists.
+     */
     @JsonProperty("deprecationWarning")
     public String getDeprecationWarning() {
         return deprecationWarning;
     }
 
+    /**
+     * deprecationWarning overrides the default warning returned to API clients. May only be set when `deprecated` is true. The default warning indicates this version is deprecated and recommends use of the newest served version of equal or greater stability, if one exists.
+     */
     @JsonProperty("deprecationWarning")
     public void setDeprecationWarning(String deprecationWarning) {
         this.deprecationWarning = deprecationWarning;
     }
 
+    /**
+     * name is the version name, e.g. "v1", "v2beta1", etc. The custom resources are served under this version at `/apis/&lt;group&gt;/&lt;version&gt;/...` if `served` is true.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the version name, e.g. "v1", "v2beta1", etc. The custom resources are served under this version at `/apis/&lt;group&gt;/&lt;version&gt;/...` if `served` is true.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * CustomResourceDefinitionVersion describes a version for CRD.
+     */
     @JsonProperty("schema")
     public CustomResourceValidation getSchema() {
         return schema;
     }
 
+    /**
+     * CustomResourceDefinitionVersion describes a version for CRD.
+     */
     @JsonProperty("schema")
     public void setSchema(CustomResourceValidation schema) {
         this.schema = schema;
     }
 
+    /**
+     * served is a flag enabling/disabling this version from being served via REST APIs
+     */
     @JsonProperty("served")
     public Boolean getServed() {
         return served;
     }
 
+    /**
+     * served is a flag enabling/disabling this version from being served via REST APIs
+     */
     @JsonProperty("served")
     public void setServed(Boolean served) {
         this.served = served;
     }
 
+    /**
+     * storage indicates this version should be used when persisting custom resources to storage. There must be exactly one version with storage=true.
+     */
     @JsonProperty("storage")
     public Boolean getStorage() {
         return storage;
     }
 
+    /**
+     * storage indicates this version should be used when persisting custom resources to storage. There must be exactly one version with storage=true.
+     */
     @JsonProperty("storage")
     public void setStorage(Boolean storage) {
         this.storage = storage;
     }
 
+    /**
+     * CustomResourceDefinitionVersion describes a version for CRD.
+     */
     @JsonProperty("subresources")
     public CustomResourceSubresources getSubresources() {
         return subresources;
     }
 
+    /**
+     * CustomResourceDefinitionVersion describes a version for CRD.
+     */
     @JsonProperty("subresources")
     public void setSubresources(CustomResourceSubresources subresources) {
         this.subresources = subresources;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceSubresourceScale.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceSubresourceScale.java
index f4ea572f01b..caec7ad3f67 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceSubresourceScale.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceSubresourceScale.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomResourceSubresourceScale defines how to serve the scale subresource for CustomResources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public CustomResourceSubresourceScale(String labelSelectorPath, String specRepli
         this.statusReplicasPath = statusReplicasPath;
     }
 
+    /**
+     * labelSelectorPath defines the JSON path inside of a custom resource that corresponds to Scale `status.selector`. Only JSON paths without the array notation are allowed. Must be a JSON Path under `.status` or `.spec`. Must be set to work with HorizontalPodAutoscaler. The field pointed by this JSON path must be a string field (not a complex selector struct) which contains a serialized label selector in string form. More info: https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions#scale-subresource If there is no value under the given path in the custom resource, the `status.selector` value in the `/scale` subresource will default to the empty string.
+     */
     @JsonProperty("labelSelectorPath")
     public String getLabelSelectorPath() {
         return labelSelectorPath;
     }
 
+    /**
+     * labelSelectorPath defines the JSON path inside of a custom resource that corresponds to Scale `status.selector`. Only JSON paths without the array notation are allowed. Must be a JSON Path under `.status` or `.spec`. Must be set to work with HorizontalPodAutoscaler. The field pointed by this JSON path must be a string field (not a complex selector struct) which contains a serialized label selector in string form. More info: https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions#scale-subresource If there is no value under the given path in the custom resource, the `status.selector` value in the `/scale` subresource will default to the empty string.
+     */
     @JsonProperty("labelSelectorPath")
     public void setLabelSelectorPath(String labelSelectorPath) {
         this.labelSelectorPath = labelSelectorPath;
     }
 
+    /**
+     * specReplicasPath defines the JSON path inside of a custom resource that corresponds to Scale `spec.replicas`. Only JSON paths without the array notation are allowed. Must be a JSON Path under `.spec`. If there is no value under the given path in the custom resource, the `/scale` subresource will return an error on GET.
+     */
     @JsonProperty("specReplicasPath")
     public String getSpecReplicasPath() {
         return specReplicasPath;
     }
 
+    /**
+     * specReplicasPath defines the JSON path inside of a custom resource that corresponds to Scale `spec.replicas`. Only JSON paths without the array notation are allowed. Must be a JSON Path under `.spec`. If there is no value under the given path in the custom resource, the `/scale` subresource will return an error on GET.
+     */
     @JsonProperty("specReplicasPath")
     public void setSpecReplicasPath(String specReplicasPath) {
         this.specReplicasPath = specReplicasPath;
     }
 
+    /**
+     * statusReplicasPath defines the JSON path inside of a custom resource that corresponds to Scale `status.replicas`. Only JSON paths without the array notation are allowed. Must be a JSON Path under `.status`. If there is no value under the given path in the custom resource, the `status.replicas` value in the `/scale` subresource will default to 0.
+     */
     @JsonProperty("statusReplicasPath")
     public String getStatusReplicasPath() {
         return statusReplicasPath;
     }
 
+    /**
+     * statusReplicasPath defines the JSON path inside of a custom resource that corresponds to Scale `status.replicas`. Only JSON paths without the array notation are allowed. Must be a JSON Path under `.status`. If there is no value under the given path in the custom resource, the `status.replicas` value in the `/scale` subresource will default to 0.
+     */
     @JsonProperty("statusReplicasPath")
     public void setStatusReplicasPath(String statusReplicasPath) {
         this.statusReplicasPath = statusReplicasPath;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceSubresourceStatus.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceSubresourceStatus.java
index bb7e662ac3b..ecfd6e6ec72 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceSubresourceStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceSubresourceStatus.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomResourceSubresourceStatus defines how to serve the status subresource for CustomResources. Status is represented by the `.status` JSON path inside of a CustomResource. When set, &#42; exposes a /status subresource for the custom resource &#42; PUT requests to the /status subresource take a custom resource object, and ignore changes to anything except the status stanza &#42; PUT/POST/PATCH requests to the custom resource ignore changes to the status stanza
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceSubresources.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceSubresources.java
index 092c184075b..fef788f117d 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceSubresources.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceSubresources.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomResourceSubresources defines the status and scale subresources for CustomResources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public CustomResourceSubresources(CustomResourceSubresourceScale scale, CustomRe
         this.status = status;
     }
 
+    /**
+     * CustomResourceSubresources defines the status and scale subresources for CustomResources.
+     */
     @JsonProperty("scale")
     public CustomResourceSubresourceScale getScale() {
         return scale;
     }
 
+    /**
+     * CustomResourceSubresources defines the status and scale subresources for CustomResources.
+     */
     @JsonProperty("scale")
     public void setScale(CustomResourceSubresourceScale scale) {
         this.scale = scale;
     }
 
+    /**
+     * CustomResourceSubresources defines the status and scale subresources for CustomResources.
+     */
     @JsonProperty("status")
     public CustomResourceSubresourceStatus getStatus() {
         return status;
     }
 
+    /**
+     * CustomResourceSubresources defines the status and scale subresources for CustomResources.
+     */
     @JsonProperty("status")
     public void setStatus(CustomResourceSubresourceStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceValidation.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceValidation.java
index 63e687e910d..20b23a56d0d 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceValidation.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/CustomResourceValidation.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomResourceValidation is a list of validation methods for CustomResources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public CustomResourceValidation(JSONSchemaProps openAPIV3Schema) {
         this.openAPIV3Schema = openAPIV3Schema;
     }
 
+    /**
+     * CustomResourceValidation is a list of validation methods for CustomResources.
+     */
     @JsonProperty("openAPIV3Schema")
     public JSONSchemaProps getOpenAPIV3Schema() {
         return openAPIV3Schema;
     }
 
+    /**
+     * CustomResourceValidation is a list of validation methods for CustomResources.
+     */
     @JsonProperty("openAPIV3Schema")
     public void setOpenAPIV3Schema(JSONSchemaProps openAPIV3Schema) {
         this.openAPIV3Schema = openAPIV3Schema;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/ServiceReference.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/ServiceReference.java
index 15dd41bc35e..48a784b7fbe 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/ServiceReference.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/ServiceReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceReference holds a reference to Service.legacy.k8s.io
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ServiceReference(String name, String namespace, String path, Integer port
         this.port = port;
     }
 
+    /**
+     * name is the name of the service. Required
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the service. Required
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * namespace is the namespace of the service. Required
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * namespace is the namespace of the service. Required
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * path is an optional URL path at which the webhook will be contacted.
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * path is an optional URL path at which the webhook will be contacted.
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * port is an optional service port at which the webhook will be contacted. `port` should be a valid port number (1-65535, inclusive). Defaults to 443 for backward compatibility.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * port is an optional service port at which the webhook will be contacted. `port` should be a valid port number (1-65535, inclusive). Defaults to 443 for backward compatibility.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
diff --git a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/WebhookClientConfig.java b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/WebhookClientConfig.java
index a2a8fb44d96..de809a1eded 100644
--- a/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/WebhookClientConfig.java
+++ b/kubernetes-model-generator/kubernetes-model-apiextensions/src/generated/java/io/fabric8/kubernetes/api/model/apiextensions/v1beta1/WebhookClientConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WebhookClientConfig contains the information to make a TLS connection with the webhook.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public WebhookClientConfig(String caBundle, ServiceReference service, String url
         this.url = url;
     }
 
+    /**
+     * caBundle is a PEM encoded CA bundle which will be used to validate the webhook's server certificate. If unspecified, system trust roots on the apiserver are used.
+     */
     @JsonProperty("caBundle")
     public String getCaBundle() {
         return caBundle;
     }
 
+    /**
+     * caBundle is a PEM encoded CA bundle which will be used to validate the webhook's server certificate. If unspecified, system trust roots on the apiserver are used.
+     */
     @JsonProperty("caBundle")
     public void setCaBundle(String caBundle) {
         this.caBundle = caBundle;
     }
 
+    /**
+     * WebhookClientConfig contains the information to make a TLS connection with the webhook.
+     */
     @JsonProperty("service")
     public ServiceReference getService() {
         return service;
     }
 
+    /**
+     * WebhookClientConfig contains the information to make a TLS connection with the webhook.
+     */
     @JsonProperty("service")
     public void setService(ServiceReference service) {
         this.service = service;
     }
 
+    /**
+     * url gives the location of the webhook, in standard URL form (`scheme://host:port/path`). Exactly one of `url` or `service` must be specified.<br><p> <br><p> The `host` should not refer to a service running in the cluster; use the `service` field instead. The host might be resolved via external DNS in some apiservers (e.g., `kube-apiserver` cannot resolve in-cluster DNS as that would be a layering violation). `host` may also be an IP address.<br><p> <br><p> Please note that using `localhost` or `127.0.0.1` as a `host` is risky unless you take great care to run this webhook on all hosts which run an apiserver which might need to make calls to this webhook. Such installs are likely to be non-portable, i.e., not easy to turn up in a new cluster.<br><p> <br><p> The scheme must be "https"; the URL must begin with "https://".<br><p> <br><p> A path is optional, and if present may be any string permissible in a URL. You may use the path to pass an arbitrary string to the webhook, for example, a cluster identifier.<br><p> <br><p> Attempting to use a user or basic auth e.g. "user:password@" is not allowed. Fragments ("#...") and query parameters ("?...") are not allowed, either.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * url gives the location of the webhook, in standard URL form (`scheme://host:port/path`). Exactly one of `url` or `service` must be specified.<br><p> <br><p> The `host` should not refer to a service running in the cluster; use the `service` field instead. The host might be resolved via external DNS in some apiservers (e.g., `kube-apiserver` cannot resolve in-cluster DNS as that would be a layering violation). `host` may also be an IP address.<br><p> <br><p> Please note that using `localhost` or `127.0.0.1` as a `host` is risky unless you take great care to run this webhook on all hosts which run an apiserver which might need to make calls to this webhook. Such installs are likely to be non-portable, i.e., not easy to turn up in a new cluster.<br><p> <br><p> The scheme must be "https"; the URL must begin with "https://".<br><p> <br><p> A path is optional, and if present may be any string permissible in a URL. You may use the path to pass an arbitrary string to the webhook, for example, a cluster identifier.<br><p> <br><p> Attempting to use a user or basic auth e.g. "user:password@" is not allowed. Fragments ("#...") and query parameters ("?...") are not allowed, either.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/ControllerRevision.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/ControllerRevision.java
index fe0e7b884e6..2118645c048 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/ControllerRevision.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/ControllerRevision.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ControllerRevision implements an immutable snapshot of state data. Clients are responsible for serializing and deserializing the objects that contain their internal state. Once a ControllerRevision has been successfully created, it can not be updated. The API Server will fail validation of all requests that attempt to mutate the Data field. ControllerRevisions may, however, be deleted. Note that, due to its use by both the DaemonSet and StatefulSet controllers for update and rollback, this object is beta. However, it may be subject to name and representation changes in future releases, and clients should not depend on its stability. It is primarily for internal use by controllers.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,17 +79,11 @@
 public class ControllerRevision implements Editable<ControllerRevisionBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apps/v1";
     @JsonProperty("data")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     private Object data;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ControllerRevision";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public ControllerRevision(String apiVersion, Object data, String kind, ObjectMet
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,18 +117,24 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ControllerRevision implements an immutable snapshot of state data. Clients are responsible for serializing and deserializing the objects that contain their internal state. Once a ControllerRevision has been successfully created, it can not be updated. The API Server will fail validation of all requests that attempt to mutate the Data field. ControllerRevisions may, however, be deleted. Note that, due to its use by both the DaemonSet and StatefulSet controllers for update and rollback, this object is beta. However, it may be subject to name and representation changes in future releases, and clients should not depend on its stability. It is primarily for internal use by controllers.
+     */
     @JsonProperty("data")
     public Object getData() {
         return data;
     }
 
+    /**
+     * ControllerRevision implements an immutable snapshot of state data. Clients are responsible for serializing and deserializing the objects that contain their internal state. Once a ControllerRevision has been successfully created, it can not be updated. The API Server will fail validation of all requests that attempt to mutate the Data field. ControllerRevisions may, however, be deleted. Note that, due to its use by both the DaemonSet and StatefulSet controllers for update and rollback, this object is beta. However, it may be subject to name and representation changes in future releases, and clients should not depend on its stability. It is primarily for internal use by controllers.
+     */
     @JsonProperty("data")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setData(Object data) {
@@ -139,7 +142,7 @@ public void setData(Object data) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -147,28 +150,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ControllerRevision implements an immutable snapshot of state data. Clients are responsible for serializing and deserializing the objects that contain their internal state. Once a ControllerRevision has been successfully created, it can not be updated. The API Server will fail validation of all requests that attempt to mutate the Data field. ControllerRevisions may, however, be deleted. Note that, due to its use by both the DaemonSet and StatefulSet controllers for update and rollback, this object is beta. However, it may be subject to name and representation changes in future releases, and clients should not depend on its stability. It is primarily for internal use by controllers.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ControllerRevision implements an immutable snapshot of state data. Clients are responsible for serializing and deserializing the objects that contain their internal state. Once a ControllerRevision has been successfully created, it can not be updated. The API Server will fail validation of all requests that attempt to mutate the Data field. ControllerRevisions may, however, be deleted. Note that, due to its use by both the DaemonSet and StatefulSet controllers for update and rollback, this object is beta. However, it may be subject to name and representation changes in future releases, and clients should not depend on its stability. It is primarily for internal use by controllers.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Revision indicates the revision of the state represented by Data.
+     */
     @JsonProperty("revision")
     public Long getRevision() {
         return revision;
     }
 
+    /**
+     * Revision indicates the revision of the state represented by Data.
+     */
     @JsonProperty("revision")
     public void setRevision(Long revision) {
         this.revision = revision;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/ControllerRevisionList.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/ControllerRevisionList.java
index 83c878b73ce..e9a3d8bd377 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/ControllerRevisionList.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/ControllerRevisionList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ControllerRevisionList is a resource containing a list of ControllerRevision objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ControllerRevisionList implements Editable<ControllerRevisionListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.apps.ControllerRevision>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apps/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.apps.ControllerRevision> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ControllerRevisionList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ControllerRevisionList(String apiVersion, List<io.fabric8.kubernetes.api.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of ControllerRevisions
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.apps.ControllerRevision> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of ControllerRevisions
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.apps.ControllerRevision> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ControllerRevisionList is a resource containing a list of ControllerRevision objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ControllerRevisionList is a resource containing a list of ControllerRevision objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DaemonSet.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DaemonSet.java
index d7ce14c8313..a445f3e27e2 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DaemonSet.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DaemonSet.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DaemonSet represents the configuration of a daemon set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class DaemonSet implements Editable<DaemonSetBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apps/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DaemonSet";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DaemonSet(String apiVersion, String kind, ObjectMeta metadata, DaemonSetS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DaemonSet represents the configuration of a daemon set.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DaemonSet represents the configuration of a daemon set.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * DaemonSet represents the configuration of a daemon set.
+     */
     @JsonProperty("spec")
     public DaemonSetSpec getSpec() {
         return spec;
     }
 
+    /**
+     * DaemonSet represents the configuration of a daemon set.
+     */
     @JsonProperty("spec")
     public void setSpec(DaemonSetSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * DaemonSet represents the configuration of a daemon set.
+     */
     @JsonProperty("status")
     public DaemonSetStatus getStatus() {
         return status;
     }
 
+    /**
+     * DaemonSet represents the configuration of a daemon set.
+     */
     @JsonProperty("status")
     public void setStatus(DaemonSetStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DaemonSetCondition.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DaemonSetCondition.java
index e8a19b4c0d0..c961ca7ab81 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DaemonSetCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DaemonSetCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DaemonSetCondition describes the state of a DaemonSet at a certain point.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public DaemonSetCondition(String lastTransitionTime, String message, String reas
         this.type = type;
     }
 
+    /**
+     * DaemonSetCondition describes the state of a DaemonSet at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * DaemonSetCondition describes the state of a DaemonSet at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type of DaemonSet condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of DaemonSet condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DaemonSetList.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DaemonSetList.java
index e66247cf487..012b79de51a 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DaemonSetList.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DaemonSetList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DaemonSetList is a collection of daemon sets.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class DaemonSetList implements Editable<DaemonSetListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.apps.DaemonSet>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apps/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.apps.DaemonSet> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DaemonSetList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DaemonSetList(String apiVersion, List<io.fabric8.kubernetes.api.model.app
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * A list of daemon sets.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.apps.DaemonSet> getItems() {
         return items;
     }
 
+    /**
+     * A list of daemon sets.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.apps.DaemonSet> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DaemonSetList is a collection of daemon sets.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DaemonSetList is a collection of daemon sets.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DaemonSetSpec.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DaemonSetSpec.java
index e682371d5a9..0b8fedfc8c2 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DaemonSetSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DaemonSetSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DaemonSetSpec is the specification of a daemon set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public DaemonSetSpec(Integer minReadySeconds, Integer revisionHistoryLimit, Labe
         this.updateStrategy = updateStrategy;
     }
 
+    /**
+     * The minimum number of seconds for which a newly created DaemonSet pod should be ready without any of its container crashing, for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready).
+     */
     @JsonProperty("minReadySeconds")
     public Integer getMinReadySeconds() {
         return minReadySeconds;
     }
 
+    /**
+     * The minimum number of seconds for which a newly created DaemonSet pod should be ready without any of its container crashing, for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready).
+     */
     @JsonProperty("minReadySeconds")
     public void setMinReadySeconds(Integer minReadySeconds) {
         this.minReadySeconds = minReadySeconds;
     }
 
+    /**
+     * The number of old history to retain to allow rollback. This is a pointer to distinguish between explicit zero and not specified. Defaults to 10.
+     */
     @JsonProperty("revisionHistoryLimit")
     public Integer getRevisionHistoryLimit() {
         return revisionHistoryLimit;
     }
 
+    /**
+     * The number of old history to retain to allow rollback. This is a pointer to distinguish between explicit zero and not specified. Defaults to 10.
+     */
     @JsonProperty("revisionHistoryLimit")
     public void setRevisionHistoryLimit(Integer revisionHistoryLimit) {
         this.revisionHistoryLimit = revisionHistoryLimit;
     }
 
+    /**
+     * DaemonSetSpec is the specification of a daemon set.
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * DaemonSetSpec is the specification of a daemon set.
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * DaemonSetSpec is the specification of a daemon set.
+     */
     @JsonProperty("template")
     public PodTemplateSpec getTemplate() {
         return template;
     }
 
+    /**
+     * DaemonSetSpec is the specification of a daemon set.
+     */
     @JsonProperty("template")
     public void setTemplate(PodTemplateSpec template) {
         this.template = template;
     }
 
+    /**
+     * DaemonSetSpec is the specification of a daemon set.
+     */
     @JsonProperty("updateStrategy")
     public DaemonSetUpdateStrategy getUpdateStrategy() {
         return updateStrategy;
     }
 
+    /**
+     * DaemonSetSpec is the specification of a daemon set.
+     */
     @JsonProperty("updateStrategy")
     public void setUpdateStrategy(DaemonSetUpdateStrategy updateStrategy) {
         this.updateStrategy = updateStrategy;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DaemonSetStatus.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DaemonSetStatus.java
index 568da046400..5a9324af8db 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DaemonSetStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DaemonSetStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DaemonSetStatus represents the current status of a daemon set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -117,102 +120,162 @@ public DaemonSetStatus(Integer collisionCount, List<DaemonSetCondition> conditio
         this.updatedNumberScheduled = updatedNumberScheduled;
     }
 
+    /**
+     * Count of hash collisions for the DaemonSet. The DaemonSet controller uses this field as a collision avoidance mechanism when it needs to create the name for the newest ControllerRevision.
+     */
     @JsonProperty("collisionCount")
     public Integer getCollisionCount() {
         return collisionCount;
     }
 
+    /**
+     * Count of hash collisions for the DaemonSet. The DaemonSet controller uses this field as a collision avoidance mechanism when it needs to create the name for the newest ControllerRevision.
+     */
     @JsonProperty("collisionCount")
     public void setCollisionCount(Integer collisionCount) {
         this.collisionCount = collisionCount;
     }
 
+    /**
+     * Represents the latest available observations of a DaemonSet's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DaemonSetCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Represents the latest available observations of a DaemonSet's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<DaemonSetCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * The number of nodes that are running at least 1 daemon pod and are supposed to run the daemon pod. More info: https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/
+     */
     @JsonProperty("currentNumberScheduled")
     public Integer getCurrentNumberScheduled() {
         return currentNumberScheduled;
     }
 
+    /**
+     * The number of nodes that are running at least 1 daemon pod and are supposed to run the daemon pod. More info: https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/
+     */
     @JsonProperty("currentNumberScheduled")
     public void setCurrentNumberScheduled(Integer currentNumberScheduled) {
         this.currentNumberScheduled = currentNumberScheduled;
     }
 
+    /**
+     * The total number of nodes that should be running the daemon pod (including nodes correctly running the daemon pod). More info: https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/
+     */
     @JsonProperty("desiredNumberScheduled")
     public Integer getDesiredNumberScheduled() {
         return desiredNumberScheduled;
     }
 
+    /**
+     * The total number of nodes that should be running the daemon pod (including nodes correctly running the daemon pod). More info: https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/
+     */
     @JsonProperty("desiredNumberScheduled")
     public void setDesiredNumberScheduled(Integer desiredNumberScheduled) {
         this.desiredNumberScheduled = desiredNumberScheduled;
     }
 
+    /**
+     * The number of nodes that should be running the daemon pod and have one or more of the daemon pod running and available (ready for at least spec.minReadySeconds)
+     */
     @JsonProperty("numberAvailable")
     public Integer getNumberAvailable() {
         return numberAvailable;
     }
 
+    /**
+     * The number of nodes that should be running the daemon pod and have one or more of the daemon pod running and available (ready for at least spec.minReadySeconds)
+     */
     @JsonProperty("numberAvailable")
     public void setNumberAvailable(Integer numberAvailable) {
         this.numberAvailable = numberAvailable;
     }
 
+    /**
+     * The number of nodes that are running the daemon pod, but are not supposed to run the daemon pod. More info: https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/
+     */
     @JsonProperty("numberMisscheduled")
     public Integer getNumberMisscheduled() {
         return numberMisscheduled;
     }
 
+    /**
+     * The number of nodes that are running the daemon pod, but are not supposed to run the daemon pod. More info: https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/
+     */
     @JsonProperty("numberMisscheduled")
     public void setNumberMisscheduled(Integer numberMisscheduled) {
         this.numberMisscheduled = numberMisscheduled;
     }
 
+    /**
+     * numberReady is the number of nodes that should be running the daemon pod and have one or more of the daemon pod running with a Ready Condition.
+     */
     @JsonProperty("numberReady")
     public Integer getNumberReady() {
         return numberReady;
     }
 
+    /**
+     * numberReady is the number of nodes that should be running the daemon pod and have one or more of the daemon pod running with a Ready Condition.
+     */
     @JsonProperty("numberReady")
     public void setNumberReady(Integer numberReady) {
         this.numberReady = numberReady;
     }
 
+    /**
+     * The number of nodes that should be running the daemon pod and have none of the daemon pod running and available (ready for at least spec.minReadySeconds)
+     */
     @JsonProperty("numberUnavailable")
     public Integer getNumberUnavailable() {
         return numberUnavailable;
     }
 
+    /**
+     * The number of nodes that should be running the daemon pod and have none of the daemon pod running and available (ready for at least spec.minReadySeconds)
+     */
     @JsonProperty("numberUnavailable")
     public void setNumberUnavailable(Integer numberUnavailable) {
         this.numberUnavailable = numberUnavailable;
     }
 
+    /**
+     * The most recent generation observed by the daemon set controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * The most recent generation observed by the daemon set controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * The total number of nodes that are running updated daemon pod
+     */
     @JsonProperty("updatedNumberScheduled")
     public Integer getUpdatedNumberScheduled() {
         return updatedNumberScheduled;
     }
 
+    /**
+     * The total number of nodes that are running updated daemon pod
+     */
     @JsonProperty("updatedNumberScheduled")
     public void setUpdatedNumberScheduled(Integer updatedNumberScheduled) {
         this.updatedNumberScheduled = updatedNumberScheduled;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DaemonSetUpdateStrategy.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DaemonSetUpdateStrategy.java
index 0d55361cc24..44fa9cf92f9 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DaemonSetUpdateStrategy.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DaemonSetUpdateStrategy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DaemonSetUpdateStrategy is a struct used to control the update strategy for a DaemonSet.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public DaemonSetUpdateStrategy(RollingUpdateDaemonSet rollingUpdate, String type
         this.type = type;
     }
 
+    /**
+     * DaemonSetUpdateStrategy is a struct used to control the update strategy for a DaemonSet.
+     */
     @JsonProperty("rollingUpdate")
     public RollingUpdateDaemonSet getRollingUpdate() {
         return rollingUpdate;
     }
 
+    /**
+     * DaemonSetUpdateStrategy is a struct used to control the update strategy for a DaemonSet.
+     */
     @JsonProperty("rollingUpdate")
     public void setRollingUpdate(RollingUpdateDaemonSet rollingUpdate) {
         this.rollingUpdate = rollingUpdate;
     }
 
+    /**
+     * Type of daemon set update. Can be "RollingUpdate" or "OnDelete". Default is RollingUpdate.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of daemon set update. Can be "RollingUpdate" or "OnDelete". Default is RollingUpdate.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/Deployment.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/Deployment.java
index 57ef6a3c780..c1e3b1e3a17 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/Deployment.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/Deployment.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Deployment enables declarative updates for Pods and ReplicaSets.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Deployment implements Editable<DeploymentBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apps/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Deployment";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Deployment(String apiVersion, String kind, ObjectMeta metadata, Deploymen
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Deployment enables declarative updates for Pods and ReplicaSets.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Deployment enables declarative updates for Pods and ReplicaSets.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Deployment enables declarative updates for Pods and ReplicaSets.
+     */
     @JsonProperty("spec")
     public DeploymentSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Deployment enables declarative updates for Pods and ReplicaSets.
+     */
     @JsonProperty("spec")
     public void setSpec(DeploymentSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Deployment enables declarative updates for Pods and ReplicaSets.
+     */
     @JsonProperty("status")
     public DeploymentStatus getStatus() {
         return status;
     }
 
+    /**
+     * Deployment enables declarative updates for Pods and ReplicaSets.
+     */
     @JsonProperty("status")
     public void setStatus(DeploymentStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DeploymentCondition.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DeploymentCondition.java
index a77f0a3e341..c77b15da610 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DeploymentCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DeploymentCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeploymentCondition describes the state of a deployment at a certain point.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public DeploymentCondition(String lastTransitionTime, String lastUpdateTime, Str
         this.type = type;
     }
 
+    /**
+     * DeploymentCondition describes the state of a deployment at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * DeploymentCondition describes the state of a deployment at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * DeploymentCondition describes the state of a deployment at a certain point.
+     */
     @JsonProperty("lastUpdateTime")
     public String getLastUpdateTime() {
         return lastUpdateTime;
     }
 
+    /**
+     * DeploymentCondition describes the state of a deployment at a certain point.
+     */
     @JsonProperty("lastUpdateTime")
     public void setLastUpdateTime(String lastUpdateTime) {
         this.lastUpdateTime = lastUpdateTime;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type of deployment condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of deployment condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DeploymentList.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DeploymentList.java
index 6111886cbc8..c83cb004f51 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DeploymentList.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DeploymentList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeploymentList is a list of Deployments.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class DeploymentList implements Editable<DeploymentListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.apps.Deployment>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apps/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.apps.Deployment> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DeploymentList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DeploymentList(String apiVersion, List<io.fabric8.kubernetes.api.model.ap
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of Deployments.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.apps.Deployment> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of Deployments.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.apps.Deployment> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DeploymentList is a list of Deployments.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DeploymentList is a list of Deployments.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DeploymentSpec.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DeploymentSpec.java
index 4a983078c13..d60e15378f3 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DeploymentSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DeploymentSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeploymentSpec is the specification of the desired behavior of the Deployment.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -106,81 +109,129 @@ public DeploymentSpec(Integer minReadySeconds, Boolean paused, Integer progressD
         this.template = template;
     }
 
+    /**
+     * Minimum number of seconds for which a newly created pod should be ready without any of its container crashing, for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready)
+     */
     @JsonProperty("minReadySeconds")
     public Integer getMinReadySeconds() {
         return minReadySeconds;
     }
 
+    /**
+     * Minimum number of seconds for which a newly created pod should be ready without any of its container crashing, for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready)
+     */
     @JsonProperty("minReadySeconds")
     public void setMinReadySeconds(Integer minReadySeconds) {
         this.minReadySeconds = minReadySeconds;
     }
 
+    /**
+     * Indicates that the deployment is paused.
+     */
     @JsonProperty("paused")
     public Boolean getPaused() {
         return paused;
     }
 
+    /**
+     * Indicates that the deployment is paused.
+     */
     @JsonProperty("paused")
     public void setPaused(Boolean paused) {
         this.paused = paused;
     }
 
+    /**
+     * The maximum time in seconds for a deployment to make progress before it is considered to be failed. The deployment controller will continue to process failed deployments and a condition with a ProgressDeadlineExceeded reason will be surfaced in the deployment status. Note that progress will not be estimated during the time a deployment is paused. Defaults to 600s.
+     */
     @JsonProperty("progressDeadlineSeconds")
     public Integer getProgressDeadlineSeconds() {
         return progressDeadlineSeconds;
     }
 
+    /**
+     * The maximum time in seconds for a deployment to make progress before it is considered to be failed. The deployment controller will continue to process failed deployments and a condition with a ProgressDeadlineExceeded reason will be surfaced in the deployment status. Note that progress will not be estimated during the time a deployment is paused. Defaults to 600s.
+     */
     @JsonProperty("progressDeadlineSeconds")
     public void setProgressDeadlineSeconds(Integer progressDeadlineSeconds) {
         this.progressDeadlineSeconds = progressDeadlineSeconds;
     }
 
+    /**
+     * Number of desired pods. This is a pointer to distinguish between explicit zero and not specified. Defaults to 1.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Number of desired pods. This is a pointer to distinguish between explicit zero and not specified. Defaults to 1.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * The number of old ReplicaSets to retain to allow rollback. This is a pointer to distinguish between explicit zero and not specified. Defaults to 10.
+     */
     @JsonProperty("revisionHistoryLimit")
     public Integer getRevisionHistoryLimit() {
         return revisionHistoryLimit;
     }
 
+    /**
+     * The number of old ReplicaSets to retain to allow rollback. This is a pointer to distinguish between explicit zero and not specified. Defaults to 10.
+     */
     @JsonProperty("revisionHistoryLimit")
     public void setRevisionHistoryLimit(Integer revisionHistoryLimit) {
         this.revisionHistoryLimit = revisionHistoryLimit;
     }
 
+    /**
+     * DeploymentSpec is the specification of the desired behavior of the Deployment.
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * DeploymentSpec is the specification of the desired behavior of the Deployment.
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * DeploymentSpec is the specification of the desired behavior of the Deployment.
+     */
     @JsonProperty("strategy")
     public DeploymentStrategy getStrategy() {
         return strategy;
     }
 
+    /**
+     * DeploymentSpec is the specification of the desired behavior of the Deployment.
+     */
     @JsonProperty("strategy")
     public void setStrategy(DeploymentStrategy strategy) {
         this.strategy = strategy;
     }
 
+    /**
+     * DeploymentSpec is the specification of the desired behavior of the Deployment.
+     */
     @JsonProperty("template")
     public PodTemplateSpec getTemplate() {
         return template;
     }
 
+    /**
+     * DeploymentSpec is the specification of the desired behavior of the Deployment.
+     */
     @JsonProperty("template")
     public void setTemplate(PodTemplateSpec template) {
         this.template = template;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DeploymentStatus.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DeploymentStatus.java
index 2223e8e0868..58b7cb8cbfa 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DeploymentStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DeploymentStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeploymentStatus is the most recently observed status of the Deployment.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -109,82 +112,130 @@ public DeploymentStatus(Integer availableReplicas, Integer collisionCount, List<
         this.updatedReplicas = updatedReplicas;
     }
 
+    /**
+     * Total number of available pods (ready for at least minReadySeconds) targeted by this deployment.
+     */
     @JsonProperty("availableReplicas")
     public Integer getAvailableReplicas() {
         return availableReplicas;
     }
 
+    /**
+     * Total number of available pods (ready for at least minReadySeconds) targeted by this deployment.
+     */
     @JsonProperty("availableReplicas")
     public void setAvailableReplicas(Integer availableReplicas) {
         this.availableReplicas = availableReplicas;
     }
 
+    /**
+     * Count of hash collisions for the Deployment. The Deployment controller uses this field as a collision avoidance mechanism when it needs to create the name for the newest ReplicaSet.
+     */
     @JsonProperty("collisionCount")
     public Integer getCollisionCount() {
         return collisionCount;
     }
 
+    /**
+     * Count of hash collisions for the Deployment. The Deployment controller uses this field as a collision avoidance mechanism when it needs to create the name for the newest ReplicaSet.
+     */
     @JsonProperty("collisionCount")
     public void setCollisionCount(Integer collisionCount) {
         this.collisionCount = collisionCount;
     }
 
+    /**
+     * Represents the latest available observations of a deployment's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DeploymentCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Represents the latest available observations of a deployment's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<DeploymentCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * The generation observed by the deployment controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * The generation observed by the deployment controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * readyReplicas is the number of pods targeted by this Deployment with a Ready Condition.
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * readyReplicas is the number of pods targeted by this Deployment with a Ready Condition.
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * Total number of non-terminated pods targeted by this deployment (their labels match the selector).
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Total number of non-terminated pods targeted by this deployment (their labels match the selector).
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * Total number of unavailable pods targeted by this deployment. This is the total number of pods that are still required for the deployment to have 100% available capacity. They may either be pods that are running but not yet available or pods that still have not been created.
+     */
     @JsonProperty("unavailableReplicas")
     public Integer getUnavailableReplicas() {
         return unavailableReplicas;
     }
 
+    /**
+     * Total number of unavailable pods targeted by this deployment. This is the total number of pods that are still required for the deployment to have 100% available capacity. They may either be pods that are running but not yet available or pods that still have not been created.
+     */
     @JsonProperty("unavailableReplicas")
     public void setUnavailableReplicas(Integer unavailableReplicas) {
         this.unavailableReplicas = unavailableReplicas;
     }
 
+    /**
+     * Total number of non-terminated pods targeted by this deployment that have the desired template spec.
+     */
     @JsonProperty("updatedReplicas")
     public Integer getUpdatedReplicas() {
         return updatedReplicas;
     }
 
+    /**
+     * Total number of non-terminated pods targeted by this deployment that have the desired template spec.
+     */
     @JsonProperty("updatedReplicas")
     public void setUpdatedReplicas(Integer updatedReplicas) {
         this.updatedReplicas = updatedReplicas;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DeploymentStrategy.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DeploymentStrategy.java
index d14d70ab7dd..5d8ff3b6f9e 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DeploymentStrategy.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/DeploymentStrategy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeploymentStrategy describes how to replace existing pods with new ones.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public DeploymentStrategy(RollingUpdateDeployment rollingUpdate, String type) {
         this.type = type;
     }
 
+    /**
+     * DeploymentStrategy describes how to replace existing pods with new ones.
+     */
     @JsonProperty("rollingUpdate")
     public RollingUpdateDeployment getRollingUpdate() {
         return rollingUpdate;
     }
 
+    /**
+     * DeploymentStrategy describes how to replace existing pods with new ones.
+     */
     @JsonProperty("rollingUpdate")
     public void setRollingUpdate(RollingUpdateDeployment rollingUpdate) {
         this.rollingUpdate = rollingUpdate;
     }
 
+    /**
+     * Type of deployment. Can be "Recreate" or "RollingUpdate". Default is RollingUpdate.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of deployment. Can be "Recreate" or "RollingUpdate". Default is RollingUpdate.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/ReplicaSet.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/ReplicaSet.java
index 70c08d24024..dd0deababc3 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/ReplicaSet.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/ReplicaSet.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ReplicaSet ensures that a specified number of pod replicas are running at any given time.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class ReplicaSet implements Editable<ReplicaSetBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apps/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ReplicaSet";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ReplicaSet(String apiVersion, String kind, ObjectMeta metadata, ReplicaSe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ReplicaSet ensures that a specified number of pod replicas are running at any given time.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ReplicaSet ensures that a specified number of pod replicas are running at any given time.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ReplicaSet ensures that a specified number of pod replicas are running at any given time.
+     */
     @JsonProperty("spec")
     public ReplicaSetSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ReplicaSet ensures that a specified number of pod replicas are running at any given time.
+     */
     @JsonProperty("spec")
     public void setSpec(ReplicaSetSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ReplicaSet ensures that a specified number of pod replicas are running at any given time.
+     */
     @JsonProperty("status")
     public ReplicaSetStatus getStatus() {
         return status;
     }
 
+    /**
+     * ReplicaSet ensures that a specified number of pod replicas are running at any given time.
+     */
     @JsonProperty("status")
     public void setStatus(ReplicaSetStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/ReplicaSetCondition.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/ReplicaSetCondition.java
index 682e6ae9588..4b63bbb9c30 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/ReplicaSetCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/ReplicaSetCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ReplicaSetCondition describes the state of a replica set at a certain point.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public ReplicaSetCondition(String lastTransitionTime, String message, String rea
         this.type = type;
     }
 
+    /**
+     * ReplicaSetCondition describes the state of a replica set at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * ReplicaSetCondition describes the state of a replica set at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type of replica set condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of replica set condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/ReplicaSetList.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/ReplicaSetList.java
index c439ba89555..08ea3167841 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/ReplicaSetList.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/ReplicaSetList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ReplicaSetList is a collection of ReplicaSets.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ReplicaSetList implements Editable<ReplicaSetListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.apps.ReplicaSet>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apps/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.apps.ReplicaSet> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ReplicaSetList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ReplicaSetList(String apiVersion, List<io.fabric8.kubernetes.api.model.ap
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of ReplicaSets. More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.apps.ReplicaSet> getItems() {
         return items;
     }
 
+    /**
+     * List of ReplicaSets. More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.apps.ReplicaSet> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ReplicaSetList is a collection of ReplicaSets.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ReplicaSetList is a collection of ReplicaSets.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/ReplicaSetSpec.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/ReplicaSetSpec.java
index 8de05569158..3194fefba06 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/ReplicaSetSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/ReplicaSetSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ReplicaSetSpec is the specification of a ReplicaSet.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ReplicaSetSpec(Integer minReadySeconds, Integer replicas, LabelSelector s
         this.template = template;
     }
 
+    /**
+     * Minimum number of seconds for which a newly created pod should be ready without any of its container crashing, for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready)
+     */
     @JsonProperty("minReadySeconds")
     public Integer getMinReadySeconds() {
         return minReadySeconds;
     }
 
+    /**
+     * Minimum number of seconds for which a newly created pod should be ready without any of its container crashing, for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready)
+     */
     @JsonProperty("minReadySeconds")
     public void setMinReadySeconds(Integer minReadySeconds) {
         this.minReadySeconds = minReadySeconds;
     }
 
+    /**
+     * Replicas is the number of desired replicas. This is a pointer to distinguish between explicit zero and unspecified. Defaults to 1. More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller/#what-is-a-replicationcontroller
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Replicas is the number of desired replicas. This is a pointer to distinguish between explicit zero and unspecified. Defaults to 1. More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller/#what-is-a-replicationcontroller
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * ReplicaSetSpec is the specification of a ReplicaSet.
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * ReplicaSetSpec is the specification of a ReplicaSet.
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * ReplicaSetSpec is the specification of a ReplicaSet.
+     */
     @JsonProperty("template")
     public PodTemplateSpec getTemplate() {
         return template;
     }
 
+    /**
+     * ReplicaSetSpec is the specification of a ReplicaSet.
+     */
     @JsonProperty("template")
     public void setTemplate(PodTemplateSpec template) {
         this.template = template;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/ReplicaSetStatus.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/ReplicaSetStatus.java
index ff645cd0cc6..688cb9483c4 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/ReplicaSetStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/ReplicaSetStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ReplicaSetStatus represents the current status of a ReplicaSet.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,62 +104,98 @@ public ReplicaSetStatus(Integer availableReplicas, List<ReplicaSetCondition> con
         this.replicas = replicas;
     }
 
+    /**
+     * The number of available replicas (ready for at least minReadySeconds) for this replica set.
+     */
     @JsonProperty("availableReplicas")
     public Integer getAvailableReplicas() {
         return availableReplicas;
     }
 
+    /**
+     * The number of available replicas (ready for at least minReadySeconds) for this replica set.
+     */
     @JsonProperty("availableReplicas")
     public void setAvailableReplicas(Integer availableReplicas) {
         this.availableReplicas = availableReplicas;
     }
 
+    /**
+     * Represents the latest available observations of a replica set's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ReplicaSetCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Represents the latest available observations of a replica set's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ReplicaSetCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * The number of pods that have labels matching the labels of the pod template of the replicaset.
+     */
     @JsonProperty("fullyLabeledReplicas")
     public Integer getFullyLabeledReplicas() {
         return fullyLabeledReplicas;
     }
 
+    /**
+     * The number of pods that have labels matching the labels of the pod template of the replicaset.
+     */
     @JsonProperty("fullyLabeledReplicas")
     public void setFullyLabeledReplicas(Integer fullyLabeledReplicas) {
         this.fullyLabeledReplicas = fullyLabeledReplicas;
     }
 
+    /**
+     * ObservedGeneration reflects the generation of the most recently observed ReplicaSet.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration reflects the generation of the most recently observed ReplicaSet.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * readyReplicas is the number of pods targeted by this ReplicaSet with a Ready Condition.
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * readyReplicas is the number of pods targeted by this ReplicaSet with a Ready Condition.
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * Replicas is the most recently observed number of replicas. More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller/#what-is-a-replicationcontroller
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Replicas is the most recently observed number of replicas. More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller/#what-is-a-replicationcontroller
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/RollingUpdateDaemonSet.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/RollingUpdateDaemonSet.java
index f3c13ebc8e1..171020f7c06 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/RollingUpdateDaemonSet.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/RollingUpdateDaemonSet.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Spec to control the desired behavior of daemon set rolling update.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public RollingUpdateDaemonSet(IntOrString maxSurge, IntOrString maxUnavailable)
         this.maxUnavailable = maxUnavailable;
     }
 
+    /**
+     * Spec to control the desired behavior of daemon set rolling update.
+     */
     @JsonProperty("maxSurge")
     public IntOrString getMaxSurge() {
         return maxSurge;
     }
 
+    /**
+     * Spec to control the desired behavior of daemon set rolling update.
+     */
     @JsonProperty("maxSurge")
     public void setMaxSurge(IntOrString maxSurge) {
         this.maxSurge = maxSurge;
     }
 
+    /**
+     * Spec to control the desired behavior of daemon set rolling update.
+     */
     @JsonProperty("maxUnavailable")
     public IntOrString getMaxUnavailable() {
         return maxUnavailable;
     }
 
+    /**
+     * Spec to control the desired behavior of daemon set rolling update.
+     */
     @JsonProperty("maxUnavailable")
     public void setMaxUnavailable(IntOrString maxUnavailable) {
         this.maxUnavailable = maxUnavailable;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/RollingUpdateDeployment.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/RollingUpdateDeployment.java
index 01a53f96469..e5528cb5aa8 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/RollingUpdateDeployment.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/RollingUpdateDeployment.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Spec to control the desired behavior of rolling update.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public RollingUpdateDeployment(IntOrString maxSurge, IntOrString maxUnavailable)
         this.maxUnavailable = maxUnavailable;
     }
 
+    /**
+     * Spec to control the desired behavior of rolling update.
+     */
     @JsonProperty("maxSurge")
     public IntOrString getMaxSurge() {
         return maxSurge;
     }
 
+    /**
+     * Spec to control the desired behavior of rolling update.
+     */
     @JsonProperty("maxSurge")
     public void setMaxSurge(IntOrString maxSurge) {
         this.maxSurge = maxSurge;
     }
 
+    /**
+     * Spec to control the desired behavior of rolling update.
+     */
     @JsonProperty("maxUnavailable")
     public IntOrString getMaxUnavailable() {
         return maxUnavailable;
     }
 
+    /**
+     * Spec to control the desired behavior of rolling update.
+     */
     @JsonProperty("maxUnavailable")
     public void setMaxUnavailable(IntOrString maxUnavailable) {
         this.maxUnavailable = maxUnavailable;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/RollingUpdateStatefulSetStrategy.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/RollingUpdateStatefulSetStrategy.java
index c880f7a925d..a66b141e65d 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/RollingUpdateStatefulSetStrategy.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/RollingUpdateStatefulSetStrategy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RollingUpdateStatefulSetStrategy is used to communicate parameter for RollingUpdateStatefulSetStrategyType.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public RollingUpdateStatefulSetStrategy(IntOrString maxUnavailable, Integer part
         this.partition = partition;
     }
 
+    /**
+     * RollingUpdateStatefulSetStrategy is used to communicate parameter for RollingUpdateStatefulSetStrategyType.
+     */
     @JsonProperty("maxUnavailable")
     public IntOrString getMaxUnavailable() {
         return maxUnavailable;
     }
 
+    /**
+     * RollingUpdateStatefulSetStrategy is used to communicate parameter for RollingUpdateStatefulSetStrategyType.
+     */
     @JsonProperty("maxUnavailable")
     public void setMaxUnavailable(IntOrString maxUnavailable) {
         this.maxUnavailable = maxUnavailable;
     }
 
+    /**
+     * Partition indicates the ordinal at which the StatefulSet should be partitioned for updates. During a rolling update, all pods from ordinal Replicas-1 to Partition are updated. All pods from ordinal Partition-1 to 0 remain untouched. This is helpful in being able to do a canary based deployment. The default value is 0.
+     */
     @JsonProperty("partition")
     public Integer getPartition() {
         return partition;
     }
 
+    /**
+     * Partition indicates the ordinal at which the StatefulSet should be partitioned for updates. During a rolling update, all pods from ordinal Replicas-1 to Partition are updated. All pods from ordinal Partition-1 to 0 remain untouched. This is helpful in being able to do a canary based deployment. The default value is 0.
+     */
     @JsonProperty("partition")
     public void setPartition(Integer partition) {
         this.partition = partition;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSet.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSet.java
index 5d6636c1cc6..26a88fb0be1 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSet.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSet.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StatefulSet represents a set of pods with consistent identities. Identities are defined as:<br><p>   - Network: A single stable DNS and hostname.<br><p>   - Storage: As many VolumeClaims as requested.<br><p> <br><p> The StatefulSet guarantees that a given network identity will always map to the same storage identity.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class StatefulSet implements Editable<StatefulSetBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apps/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "StatefulSet";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public StatefulSet(String apiVersion, String kind, ObjectMeta metadata, Stateful
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * StatefulSet represents a set of pods with consistent identities. Identities are defined as:<br><p>   - Network: A single stable DNS and hostname.<br><p>   - Storage: As many VolumeClaims as requested.<br><p> <br><p> The StatefulSet guarantees that a given network identity will always map to the same storage identity.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * StatefulSet represents a set of pods with consistent identities. Identities are defined as:<br><p>   - Network: A single stable DNS and hostname.<br><p>   - Storage: As many VolumeClaims as requested.<br><p> <br><p> The StatefulSet guarantees that a given network identity will always map to the same storage identity.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * StatefulSet represents a set of pods with consistent identities. Identities are defined as:<br><p>   - Network: A single stable DNS and hostname.<br><p>   - Storage: As many VolumeClaims as requested.<br><p> <br><p> The StatefulSet guarantees that a given network identity will always map to the same storage identity.
+     */
     @JsonProperty("spec")
     public StatefulSetSpec getSpec() {
         return spec;
     }
 
+    /**
+     * StatefulSet represents a set of pods with consistent identities. Identities are defined as:<br><p>   - Network: A single stable DNS and hostname.<br><p>   - Storage: As many VolumeClaims as requested.<br><p> <br><p> The StatefulSet guarantees that a given network identity will always map to the same storage identity.
+     */
     @JsonProperty("spec")
     public void setSpec(StatefulSetSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * StatefulSet represents a set of pods with consistent identities. Identities are defined as:<br><p>   - Network: A single stable DNS and hostname.<br><p>   - Storage: As many VolumeClaims as requested.<br><p> <br><p> The StatefulSet guarantees that a given network identity will always map to the same storage identity.
+     */
     @JsonProperty("status")
     public StatefulSetStatus getStatus() {
         return status;
     }
 
+    /**
+     * StatefulSet represents a set of pods with consistent identities. Identities are defined as:<br><p>   - Network: A single stable DNS and hostname.<br><p>   - Storage: As many VolumeClaims as requested.<br><p> <br><p> The StatefulSet guarantees that a given network identity will always map to the same storage identity.
+     */
     @JsonProperty("status")
     public void setStatus(StatefulSetStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSetCondition.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSetCondition.java
index b3ecc220eda..26d8e91c467 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSetCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSetCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StatefulSetCondition describes the state of a statefulset at a certain point.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public StatefulSetCondition(String lastTransitionTime, String message, String re
         this.type = type;
     }
 
+    /**
+     * StatefulSetCondition describes the state of a statefulset at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * StatefulSetCondition describes the state of a statefulset at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type of statefulset condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of statefulset condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSetList.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSetList.java
index 6e5e924e6a2..51a102f5cb4 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSetList.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSetList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StatefulSetList is a collection of StatefulSets.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class StatefulSetList implements Editable<StatefulSetListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.apps.StatefulSet>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apps/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.apps.StatefulSet> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "StatefulSetList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public StatefulSetList(String apiVersion, List<io.fabric8.kubernetes.api.model.a
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of stateful sets.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.apps.StatefulSet> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of stateful sets.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.apps.StatefulSet> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * StatefulSetList is a collection of StatefulSets.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * StatefulSetList is a collection of StatefulSets.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSetOrdinals.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSetOrdinals.java
index 2adc1ba0e50..77659ceca99 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSetOrdinals.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSetOrdinals.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StatefulSetOrdinals describes the policy used for replica ordinal assignment in this StatefulSet.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public StatefulSetOrdinals(Integer start) {
         this.start = start;
     }
 
+    /**
+     * start is the number representing the first replica's index. It may be used to number replicas from an alternate index (eg: 1-indexed) over the default 0-indexed names, or to orchestrate progressive movement of replicas from one StatefulSet to another. If set, replica indices will be in the range:<br><p>   [.spec.ordinals.start, .spec.ordinals.start + .spec.replicas).<br><p> If unset, defaults to 0. Replica indices will be in the range:<br><p>   [0, .spec.replicas).
+     */
     @JsonProperty("start")
     public Integer getStart() {
         return start;
     }
 
+    /**
+     * start is the number representing the first replica's index. It may be used to number replicas from an alternate index (eg: 1-indexed) over the default 0-indexed names, or to orchestrate progressive movement of replicas from one StatefulSet to another. If set, replica indices will be in the range:<br><p>   [.spec.ordinals.start, .spec.ordinals.start + .spec.replicas).<br><p> If unset, defaults to 0. Replica indices will be in the range:<br><p>   [0, .spec.replicas).
+     */
     @JsonProperty("start")
     public void setStart(Integer start) {
         this.start = start;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSetPersistentVolumeClaimRetentionPolicy.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSetPersistentVolumeClaimRetentionPolicy.java
index b6902f8f8d9..d8081687abf 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSetPersistentVolumeClaimRetentionPolicy.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSetPersistentVolumeClaimRetentionPolicy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StatefulSetPersistentVolumeClaimRetentionPolicy describes the policy used for PVCs created from the StatefulSet VolumeClaimTemplates.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public StatefulSetPersistentVolumeClaimRetentionPolicy(String whenDeleted, Strin
         this.whenScaled = whenScaled;
     }
 
+    /**
+     * WhenDeleted specifies what happens to PVCs created from StatefulSet VolumeClaimTemplates when the StatefulSet is deleted. The default policy of `Retain` causes PVCs to not be affected by StatefulSet deletion. The `Delete` policy causes those PVCs to be deleted.
+     */
     @JsonProperty("whenDeleted")
     public String getWhenDeleted() {
         return whenDeleted;
     }
 
+    /**
+     * WhenDeleted specifies what happens to PVCs created from StatefulSet VolumeClaimTemplates when the StatefulSet is deleted. The default policy of `Retain` causes PVCs to not be affected by StatefulSet deletion. The `Delete` policy causes those PVCs to be deleted.
+     */
     @JsonProperty("whenDeleted")
     public void setWhenDeleted(String whenDeleted) {
         this.whenDeleted = whenDeleted;
     }
 
+    /**
+     * WhenScaled specifies what happens to PVCs created from StatefulSet VolumeClaimTemplates when the StatefulSet is scaled down. The default policy of `Retain` causes PVCs to not be affected by a scaledown. The `Delete` policy causes the associated PVCs for any excess pods above the replica count to be deleted.
+     */
     @JsonProperty("whenScaled")
     public String getWhenScaled() {
         return whenScaled;
     }
 
+    /**
+     * WhenScaled specifies what happens to PVCs created from StatefulSet VolumeClaimTemplates when the StatefulSet is scaled down. The default policy of `Retain` causes PVCs to not be affected by a scaledown. The `Delete` policy causes the associated PVCs for any excess pods above the replica count to be deleted.
+     */
     @JsonProperty("whenScaled")
     public void setWhenScaled(String whenScaled) {
         this.whenScaled = whenScaled;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSetSpec.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSetSpec.java
index ac8682dc2b3..ad728af0da3 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSetSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSetSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * A StatefulSetSpec is the specification of a StatefulSet.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -121,112 +124,178 @@ public StatefulSetSpec(Integer minReadySeconds, StatefulSetOrdinals ordinals, St
         this.volumeClaimTemplates = volumeClaimTemplates;
     }
 
+    /**
+     * Minimum number of seconds for which a newly created pod should be ready without any of its container crashing for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready)
+     */
     @JsonProperty("minReadySeconds")
     public Integer getMinReadySeconds() {
         return minReadySeconds;
     }
 
+    /**
+     * Minimum number of seconds for which a newly created pod should be ready without any of its container crashing for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready)
+     */
     @JsonProperty("minReadySeconds")
     public void setMinReadySeconds(Integer minReadySeconds) {
         this.minReadySeconds = minReadySeconds;
     }
 
+    /**
+     * A StatefulSetSpec is the specification of a StatefulSet.
+     */
     @JsonProperty("ordinals")
     public StatefulSetOrdinals getOrdinals() {
         return ordinals;
     }
 
+    /**
+     * A StatefulSetSpec is the specification of a StatefulSet.
+     */
     @JsonProperty("ordinals")
     public void setOrdinals(StatefulSetOrdinals ordinals) {
         this.ordinals = ordinals;
     }
 
+    /**
+     * A StatefulSetSpec is the specification of a StatefulSet.
+     */
     @JsonProperty("persistentVolumeClaimRetentionPolicy")
     public StatefulSetPersistentVolumeClaimRetentionPolicy getPersistentVolumeClaimRetentionPolicy() {
         return persistentVolumeClaimRetentionPolicy;
     }
 
+    /**
+     * A StatefulSetSpec is the specification of a StatefulSet.
+     */
     @JsonProperty("persistentVolumeClaimRetentionPolicy")
     public void setPersistentVolumeClaimRetentionPolicy(StatefulSetPersistentVolumeClaimRetentionPolicy persistentVolumeClaimRetentionPolicy) {
         this.persistentVolumeClaimRetentionPolicy = persistentVolumeClaimRetentionPolicy;
     }
 
+    /**
+     * podManagementPolicy controls how pods are created during initial scale up, when replacing pods on nodes, or when scaling down. The default policy is `OrderedReady`, where pods are created in increasing order (pod-0, then pod-1, etc) and the controller will wait until each pod is ready before continuing. When scaling down, the pods are removed in the opposite order. The alternative policy is `Parallel` which will create pods in parallel to match the desired scale without waiting, and on scale down will delete all pods at once.
+     */
     @JsonProperty("podManagementPolicy")
     public String getPodManagementPolicy() {
         return podManagementPolicy;
     }
 
+    /**
+     * podManagementPolicy controls how pods are created during initial scale up, when replacing pods on nodes, or when scaling down. The default policy is `OrderedReady`, where pods are created in increasing order (pod-0, then pod-1, etc) and the controller will wait until each pod is ready before continuing. When scaling down, the pods are removed in the opposite order. The alternative policy is `Parallel` which will create pods in parallel to match the desired scale without waiting, and on scale down will delete all pods at once.
+     */
     @JsonProperty("podManagementPolicy")
     public void setPodManagementPolicy(String podManagementPolicy) {
         this.podManagementPolicy = podManagementPolicy;
     }
 
+    /**
+     * replicas is the desired number of replicas of the given Template. These are replicas in the sense that they are instantiations of the same Template, but individual replicas also have a consistent identity. If unspecified, defaults to 1.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * replicas is the desired number of replicas of the given Template. These are replicas in the sense that they are instantiations of the same Template, but individual replicas also have a consistent identity. If unspecified, defaults to 1.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * revisionHistoryLimit is the maximum number of revisions that will be maintained in the StatefulSet's revision history. The revision history consists of all revisions not represented by a currently applied StatefulSetSpec version. The default value is 10.
+     */
     @JsonProperty("revisionHistoryLimit")
     public Integer getRevisionHistoryLimit() {
         return revisionHistoryLimit;
     }
 
+    /**
+     * revisionHistoryLimit is the maximum number of revisions that will be maintained in the StatefulSet's revision history. The revision history consists of all revisions not represented by a currently applied StatefulSetSpec version. The default value is 10.
+     */
     @JsonProperty("revisionHistoryLimit")
     public void setRevisionHistoryLimit(Integer revisionHistoryLimit) {
         this.revisionHistoryLimit = revisionHistoryLimit;
     }
 
+    /**
+     * A StatefulSetSpec is the specification of a StatefulSet.
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * A StatefulSetSpec is the specification of a StatefulSet.
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * serviceName is the name of the service that governs this StatefulSet. This service must exist before the StatefulSet, and is responsible for the network identity of the set. Pods get DNS/hostnames that follow the pattern: pod-specific-string.serviceName.default.svc.cluster.local where "pod-specific-string" is managed by the StatefulSet controller.
+     */
     @JsonProperty("serviceName")
     public String getServiceName() {
         return serviceName;
     }
 
+    /**
+     * serviceName is the name of the service that governs this StatefulSet. This service must exist before the StatefulSet, and is responsible for the network identity of the set. Pods get DNS/hostnames that follow the pattern: pod-specific-string.serviceName.default.svc.cluster.local where "pod-specific-string" is managed by the StatefulSet controller.
+     */
     @JsonProperty("serviceName")
     public void setServiceName(String serviceName) {
         this.serviceName = serviceName;
     }
 
+    /**
+     * A StatefulSetSpec is the specification of a StatefulSet.
+     */
     @JsonProperty("template")
     public PodTemplateSpec getTemplate() {
         return template;
     }
 
+    /**
+     * A StatefulSetSpec is the specification of a StatefulSet.
+     */
     @JsonProperty("template")
     public void setTemplate(PodTemplateSpec template) {
         this.template = template;
     }
 
+    /**
+     * A StatefulSetSpec is the specification of a StatefulSet.
+     */
     @JsonProperty("updateStrategy")
     public StatefulSetUpdateStrategy getUpdateStrategy() {
         return updateStrategy;
     }
 
+    /**
+     * A StatefulSetSpec is the specification of a StatefulSet.
+     */
     @JsonProperty("updateStrategy")
     public void setUpdateStrategy(StatefulSetUpdateStrategy updateStrategy) {
         this.updateStrategy = updateStrategy;
     }
 
+    /**
+     * volumeClaimTemplates is a list of claims that pods are allowed to reference. The StatefulSet controller is responsible for mapping network identities to claims in a way that maintains the identity of a pod. Every claim in this list must have at least one matching (by name) volumeMount in one container in the template. A claim in this list takes precedence over any volumes in the template, with the same name.
+     */
     @JsonProperty("volumeClaimTemplates")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PersistentVolumeClaim> getVolumeClaimTemplates() {
         return volumeClaimTemplates;
     }
 
+    /**
+     * volumeClaimTemplates is a list of claims that pods are allowed to reference. The StatefulSet controller is responsible for mapping network identities to claims in a way that maintains the identity of a pod. Every claim in this list must have at least one matching (by name) volumeMount in one container in the template. A claim in this list takes precedence over any volumes in the template, with the same name.
+     */
     @JsonProperty("volumeClaimTemplates")
     public void setVolumeClaimTemplates(List<PersistentVolumeClaim> volumeClaimTemplates) {
         this.volumeClaimTemplates = volumeClaimTemplates;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSetStatus.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSetStatus.java
index 33ca1a7a84a..7e9b046bc7e 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSetStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSetStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StatefulSetStatus represents the current state of a StatefulSet.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -117,102 +120,162 @@ public StatefulSetStatus(Integer availableReplicas, Integer collisionCount, List
         this.updatedReplicas = updatedReplicas;
     }
 
+    /**
+     * Total number of available pods (ready for at least minReadySeconds) targeted by this statefulset.
+     */
     @JsonProperty("availableReplicas")
     public Integer getAvailableReplicas() {
         return availableReplicas;
     }
 
+    /**
+     * Total number of available pods (ready for at least minReadySeconds) targeted by this statefulset.
+     */
     @JsonProperty("availableReplicas")
     public void setAvailableReplicas(Integer availableReplicas) {
         this.availableReplicas = availableReplicas;
     }
 
+    /**
+     * collisionCount is the count of hash collisions for the StatefulSet. The StatefulSet controller uses this field as a collision avoidance mechanism when it needs to create the name for the newest ControllerRevision.
+     */
     @JsonProperty("collisionCount")
     public Integer getCollisionCount() {
         return collisionCount;
     }
 
+    /**
+     * collisionCount is the count of hash collisions for the StatefulSet. The StatefulSet controller uses this field as a collision avoidance mechanism when it needs to create the name for the newest ControllerRevision.
+     */
     @JsonProperty("collisionCount")
     public void setCollisionCount(Integer collisionCount) {
         this.collisionCount = collisionCount;
     }
 
+    /**
+     * Represents the latest available observations of a statefulset's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<StatefulSetCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Represents the latest available observations of a statefulset's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<StatefulSetCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * currentReplicas is the number of Pods created by the StatefulSet controller from the StatefulSet version indicated by currentRevision.
+     */
     @JsonProperty("currentReplicas")
     public Integer getCurrentReplicas() {
         return currentReplicas;
     }
 
+    /**
+     * currentReplicas is the number of Pods created by the StatefulSet controller from the StatefulSet version indicated by currentRevision.
+     */
     @JsonProperty("currentReplicas")
     public void setCurrentReplicas(Integer currentReplicas) {
         this.currentReplicas = currentReplicas;
     }
 
+    /**
+     * currentRevision, if not empty, indicates the version of the StatefulSet used to generate Pods in the sequence [0,currentReplicas).
+     */
     @JsonProperty("currentRevision")
     public String getCurrentRevision() {
         return currentRevision;
     }
 
+    /**
+     * currentRevision, if not empty, indicates the version of the StatefulSet used to generate Pods in the sequence [0,currentReplicas).
+     */
     @JsonProperty("currentRevision")
     public void setCurrentRevision(String currentRevision) {
         this.currentRevision = currentRevision;
     }
 
+    /**
+     * observedGeneration is the most recent generation observed for this StatefulSet. It corresponds to the StatefulSet's generation, which is updated on mutation by the API Server.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the most recent generation observed for this StatefulSet. It corresponds to the StatefulSet's generation, which is updated on mutation by the API Server.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * readyReplicas is the number of pods created for this StatefulSet with a Ready Condition.
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * readyReplicas is the number of pods created for this StatefulSet with a Ready Condition.
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * replicas is the number of Pods created by the StatefulSet controller.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * replicas is the number of Pods created by the StatefulSet controller.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * updateRevision, if not empty, indicates the version of the StatefulSet used to generate Pods in the sequence [replicas-updatedReplicas,replicas)
+     */
     @JsonProperty("updateRevision")
     public String getUpdateRevision() {
         return updateRevision;
     }
 
+    /**
+     * updateRevision, if not empty, indicates the version of the StatefulSet used to generate Pods in the sequence [replicas-updatedReplicas,replicas)
+     */
     @JsonProperty("updateRevision")
     public void setUpdateRevision(String updateRevision) {
         this.updateRevision = updateRevision;
     }
 
+    /**
+     * updatedReplicas is the number of Pods created by the StatefulSet controller from the StatefulSet version indicated by updateRevision.
+     */
     @JsonProperty("updatedReplicas")
     public Integer getUpdatedReplicas() {
         return updatedReplicas;
     }
 
+    /**
+     * updatedReplicas is the number of Pods created by the StatefulSet controller from the StatefulSet version indicated by updateRevision.
+     */
     @JsonProperty("updatedReplicas")
     public void setUpdatedReplicas(Integer updatedReplicas) {
         this.updatedReplicas = updatedReplicas;
diff --git a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSetUpdateStrategy.java b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSetUpdateStrategy.java
index eab1de3bd44..32074c62e5e 100644
--- a/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSetUpdateStrategy.java
+++ b/kubernetes-model-generator/kubernetes-model-apps/src/generated/java/io/fabric8/kubernetes/api/model/apps/StatefulSetUpdateStrategy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StatefulSetUpdateStrategy indicates the strategy that the StatefulSet controller will use to perform updates. It includes any additional parameters necessary to perform the update for the indicated strategy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public StatefulSetUpdateStrategy(RollingUpdateStatefulSetStrategy rollingUpdate,
         this.type = type;
     }
 
+    /**
+     * StatefulSetUpdateStrategy indicates the strategy that the StatefulSet controller will use to perform updates. It includes any additional parameters necessary to perform the update for the indicated strategy.
+     */
     @JsonProperty("rollingUpdate")
     public RollingUpdateStatefulSetStrategy getRollingUpdate() {
         return rollingUpdate;
     }
 
+    /**
+     * StatefulSetUpdateStrategy indicates the strategy that the StatefulSet controller will use to perform updates. It includes any additional parameters necessary to perform the update for the indicated strategy.
+     */
     @JsonProperty("rollingUpdate")
     public void setRollingUpdate(RollingUpdateStatefulSetStrategy rollingUpdate) {
         this.rollingUpdate = rollingUpdate;
     }
 
+    /**
+     * Type indicates the type of the StatefulSetUpdateStrategy. Default is RollingUpdate.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type indicates the type of the StatefulSetUpdateStrategy. Default is RollingUpdate.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/CrossVersionObjectReference.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/CrossVersionObjectReference.java
index 4320c7cd33f..2fe6a494d17 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/CrossVersionObjectReference.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/CrossVersionObjectReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CrossVersionObjectReference contains enough information to let you identify the referred resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public CrossVersionObjectReference(String apiVersion, String kind, String name)
         this.name = name;
     }
 
+    /**
+     * apiVersion is the API version of the referent
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * apiVersion is the API version of the referent
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * kind is the kind of the referent; More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * kind is the kind of the referent; More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * name is the name of the referent; More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the referent; More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/HorizontalPodAutoscaler.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/HorizontalPodAutoscaler.java
index 4920fcdb3a2..3ed246e98d0 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/HorizontalPodAutoscaler.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/HorizontalPodAutoscaler.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * configuration of a horizontal pod autoscaler.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class HorizontalPodAutoscaler implements Editable<HorizontalPodAutoscalerBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "HorizontalPodAutoscaler";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public HorizontalPodAutoscaler(String apiVersion, String kind, ObjectMeta metada
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * configuration of a horizontal pod autoscaler.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * configuration of a horizontal pod autoscaler.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * configuration of a horizontal pod autoscaler.
+     */
     @JsonProperty("spec")
     public HorizontalPodAutoscalerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * configuration of a horizontal pod autoscaler.
+     */
     @JsonProperty("spec")
     public void setSpec(HorizontalPodAutoscalerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * configuration of a horizontal pod autoscaler.
+     */
     @JsonProperty("status")
     public HorizontalPodAutoscalerStatus getStatus() {
         return status;
     }
 
+    /**
+     * configuration of a horizontal pod autoscaler.
+     */
     @JsonProperty("status")
     public void setStatus(HorizontalPodAutoscalerStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/HorizontalPodAutoscalerList.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/HorizontalPodAutoscalerList.java
index 017be84e4a4..ce06abf2643 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/HorizontalPodAutoscalerList.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/HorizontalPodAutoscalerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * list of horizontal pod autoscaler objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class HorizontalPodAutoscalerList implements Editable<HorizontalPodAutoscalerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.autoscaling.v1.HorizontalPodAutoscaler>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.autoscaling.v1.HorizontalPodAutoscaler> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "HorizontalPodAutoscalerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public HorizontalPodAutoscalerList(String apiVersion, List<io.fabric8.kubernetes
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of horizontal pod autoscaler objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.autoscaling.v1.HorizontalPodAutoscaler> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of horizontal pod autoscaler objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.autoscaling.v1.HorizontalPodAutoscaler> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * list of horizontal pod autoscaler objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * list of horizontal pod autoscaler objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/HorizontalPodAutoscalerSpec.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/HorizontalPodAutoscalerSpec.java
index b9696eb28b5..4a84c72e720 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/HorizontalPodAutoscalerSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/HorizontalPodAutoscalerSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * specification of a horizontal pod autoscaler.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public HorizontalPodAutoscalerSpec(Integer maxReplicas, Integer minReplicas, Cro
         this.targetCPUUtilizationPercentage = targetCPUUtilizationPercentage;
     }
 
+    /**
+     * maxReplicas is the upper limit for the number of pods that can be set by the autoscaler; cannot be smaller than MinReplicas.
+     */
     @JsonProperty("maxReplicas")
     public Integer getMaxReplicas() {
         return maxReplicas;
     }
 
+    /**
+     * maxReplicas is the upper limit for the number of pods that can be set by the autoscaler; cannot be smaller than MinReplicas.
+     */
     @JsonProperty("maxReplicas")
     public void setMaxReplicas(Integer maxReplicas) {
         this.maxReplicas = maxReplicas;
     }
 
+    /**
+     * minReplicas is the lower limit for the number of replicas to which the autoscaler can scale down.  It defaults to 1 pod.  minReplicas is allowed to be 0 if the alpha feature gate HPAScaleToZero is enabled and at least one Object or External metric is configured.  Scaling is active as long as at least one metric value is available.
+     */
     @JsonProperty("minReplicas")
     public Integer getMinReplicas() {
         return minReplicas;
     }
 
+    /**
+     * minReplicas is the lower limit for the number of replicas to which the autoscaler can scale down.  It defaults to 1 pod.  minReplicas is allowed to be 0 if the alpha feature gate HPAScaleToZero is enabled and at least one Object or External metric is configured.  Scaling is active as long as at least one metric value is available.
+     */
     @JsonProperty("minReplicas")
     public void setMinReplicas(Integer minReplicas) {
         this.minReplicas = minReplicas;
     }
 
+    /**
+     * specification of a horizontal pod autoscaler.
+     */
     @JsonProperty("scaleTargetRef")
     public CrossVersionObjectReference getScaleTargetRef() {
         return scaleTargetRef;
     }
 
+    /**
+     * specification of a horizontal pod autoscaler.
+     */
     @JsonProperty("scaleTargetRef")
     public void setScaleTargetRef(CrossVersionObjectReference scaleTargetRef) {
         this.scaleTargetRef = scaleTargetRef;
     }
 
+    /**
+     * targetCPUUtilizationPercentage is the target average CPU utilization (represented as a percentage of requested CPU) over all the pods; if not specified the default autoscaling policy will be used.
+     */
     @JsonProperty("targetCPUUtilizationPercentage")
     public Integer getTargetCPUUtilizationPercentage() {
         return targetCPUUtilizationPercentage;
     }
 
+    /**
+     * targetCPUUtilizationPercentage is the target average CPU utilization (represented as a percentage of requested CPU) over all the pods; if not specified the default autoscaling policy will be used.
+     */
     @JsonProperty("targetCPUUtilizationPercentage")
     public void setTargetCPUUtilizationPercentage(Integer targetCPUUtilizationPercentage) {
         this.targetCPUUtilizationPercentage = targetCPUUtilizationPercentage;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/HorizontalPodAutoscalerStatus.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/HorizontalPodAutoscalerStatus.java
index 2ebbfef4c73..615513a7a60 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/HorizontalPodAutoscalerStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/HorizontalPodAutoscalerStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * current status of a horizontal pod autoscaler
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public HorizontalPodAutoscalerStatus(Integer currentCPUUtilizationPercentage, In
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * currentCPUUtilizationPercentage is the current average CPU utilization over all pods, represented as a percentage of requested CPU, e.g. 70 means that an average pod is using now 70% of its requested CPU.
+     */
     @JsonProperty("currentCPUUtilizationPercentage")
     public Integer getCurrentCPUUtilizationPercentage() {
         return currentCPUUtilizationPercentage;
     }
 
+    /**
+     * currentCPUUtilizationPercentage is the current average CPU utilization over all pods, represented as a percentage of requested CPU, e.g. 70 means that an average pod is using now 70% of its requested CPU.
+     */
     @JsonProperty("currentCPUUtilizationPercentage")
     public void setCurrentCPUUtilizationPercentage(Integer currentCPUUtilizationPercentage) {
         this.currentCPUUtilizationPercentage = currentCPUUtilizationPercentage;
     }
 
+    /**
+     * currentReplicas is the current number of replicas of pods managed by this autoscaler.
+     */
     @JsonProperty("currentReplicas")
     public Integer getCurrentReplicas() {
         return currentReplicas;
     }
 
+    /**
+     * currentReplicas is the current number of replicas of pods managed by this autoscaler.
+     */
     @JsonProperty("currentReplicas")
     public void setCurrentReplicas(Integer currentReplicas) {
         this.currentReplicas = currentReplicas;
     }
 
+    /**
+     * desiredReplicas is the  desired number of replicas of pods managed by this autoscaler.
+     */
     @JsonProperty("desiredReplicas")
     public Integer getDesiredReplicas() {
         return desiredReplicas;
     }
 
+    /**
+     * desiredReplicas is the  desired number of replicas of pods managed by this autoscaler.
+     */
     @JsonProperty("desiredReplicas")
     public void setDesiredReplicas(Integer desiredReplicas) {
         this.desiredReplicas = desiredReplicas;
     }
 
+    /**
+     * current status of a horizontal pod autoscaler
+     */
     @JsonProperty("lastScaleTime")
     public String getLastScaleTime() {
         return lastScaleTime;
     }
 
+    /**
+     * current status of a horizontal pod autoscaler
+     */
     @JsonProperty("lastScaleTime")
     public void setLastScaleTime(String lastScaleTime) {
         this.lastScaleTime = lastScaleTime;
     }
 
+    /**
+     * observedGeneration is the most recent generation observed by this autoscaler.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the most recent generation observed by this autoscaler.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/Scale.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/Scale.java
index 983bc1f9d68..492fb229f3d 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/Scale.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/Scale.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Scale represents a scaling request for a resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Scale implements Editable<ScaleBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Scale";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Scale(String apiVersion, String kind, ObjectMeta metadata, ScaleSpec spec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Scale represents a scaling request for a resource.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Scale represents a scaling request for a resource.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Scale represents a scaling request for a resource.
+     */
     @JsonProperty("spec")
     public ScaleSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Scale represents a scaling request for a resource.
+     */
     @JsonProperty("spec")
     public void setSpec(ScaleSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Scale represents a scaling request for a resource.
+     */
     @JsonProperty("status")
     public ScaleStatus getStatus() {
         return status;
     }
 
+    /**
+     * Scale represents a scaling request for a resource.
+     */
     @JsonProperty("status")
     public void setStatus(ScaleStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/ScaleSpec.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/ScaleSpec.java
index cc7fc770304..376acae8c2f 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/ScaleSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/ScaleSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ScaleSpec describes the attributes of a scale subresource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ScaleSpec(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * replicas is the desired number of instances for the scaled object.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * replicas is the desired number of instances for the scaled object.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/ScaleStatus.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/ScaleStatus.java
index 6af8388a076..7f5f8599f6b 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/ScaleStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v1/ScaleStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ScaleStatus represents the current status of a scale subresource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ScaleStatus(Integer replicas, String selector) {
         this.selector = selector;
     }
 
+    /**
+     * replicas is the actual number of observed instances of the scaled object.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * replicas is the actual number of observed instances of the scaled object.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * selector is the label query over pods that should match the replicas count. This is same as the label selector but in the string format to avoid introspection by clients. The string will be in the same format as the query-param syntax. More info about label selectors: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/
+     */
     @JsonProperty("selector")
     public String getSelector() {
         return selector;
     }
 
+    /**
+     * selector is the label query over pods that should match the replicas count. This is same as the label selector but in the string format to avoid introspection by clients. The string will be in the same format as the query-param syntax. More info about label selectors: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/
+     */
     @JsonProperty("selector")
     public void setSelector(String selector) {
         this.selector = selector;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ContainerResourceMetricSource.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ContainerResourceMetricSource.java
index d50b397f984..23e53252e6d 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ContainerResourceMetricSource.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ContainerResourceMetricSource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerResourceMetricSource indicates how to scale on a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory).  The values will be averaged together before being compared to the target.  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.  Only one "target" type should be set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ContainerResourceMetricSource(String container, String name, MetricTarget
         this.target = target;
     }
 
+    /**
+     * container is the name of the container in the pods of the scaling target
+     */
     @JsonProperty("container")
     public String getContainer() {
         return container;
     }
 
+    /**
+     * container is the name of the container in the pods of the scaling target
+     */
     @JsonProperty("container")
     public void setContainer(String container) {
         this.container = container;
     }
 
+    /**
+     * name is the name of the resource in question.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the resource in question.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * ContainerResourceMetricSource indicates how to scale on a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory).  The values will be averaged together before being compared to the target.  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.  Only one "target" type should be set.
+     */
     @JsonProperty("target")
     public MetricTarget getTarget() {
         return target;
     }
 
+    /**
+     * ContainerResourceMetricSource indicates how to scale on a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory).  The values will be averaged together before being compared to the target.  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.  Only one "target" type should be set.
+     */
     @JsonProperty("target")
     public void setTarget(MetricTarget target) {
         this.target = target;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ContainerResourceMetricStatus.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ContainerResourceMetricStatus.java
index 34f92833836..ef73ee1567a 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ContainerResourceMetricStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ContainerResourceMetricStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerResourceMetricStatus indicates the current value of a resource metric known to Kubernetes, as specified in requests and limits, describing a single container in each pod in the current scale target (e.g. CPU or memory).  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ContainerResourceMetricStatus(String container, MetricValueStatus current
         this.name = name;
     }
 
+    /**
+     * container is the name of the container in the pods of the scaling target
+     */
     @JsonProperty("container")
     public String getContainer() {
         return container;
     }
 
+    /**
+     * container is the name of the container in the pods of the scaling target
+     */
     @JsonProperty("container")
     public void setContainer(String container) {
         this.container = container;
     }
 
+    /**
+     * ContainerResourceMetricStatus indicates the current value of a resource metric known to Kubernetes, as specified in requests and limits, describing a single container in each pod in the current scale target (e.g. CPU or memory).  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.
+     */
     @JsonProperty("current")
     public MetricValueStatus getCurrent() {
         return current;
     }
 
+    /**
+     * ContainerResourceMetricStatus indicates the current value of a resource metric known to Kubernetes, as specified in requests and limits, describing a single container in each pod in the current scale target (e.g. CPU or memory).  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.
+     */
     @JsonProperty("current")
     public void setCurrent(MetricValueStatus current) {
         this.current = current;
     }
 
+    /**
+     * name is the name of the resource in question.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the resource in question.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/CrossVersionObjectReference.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/CrossVersionObjectReference.java
index bc610390ad2..05eddfb8892 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/CrossVersionObjectReference.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/CrossVersionObjectReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CrossVersionObjectReference contains enough information to let you identify the referred resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public CrossVersionObjectReference(String apiVersion, String kind, String name)
         this.name = name;
     }
 
+    /**
+     * apiVersion is the API version of the referent
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * apiVersion is the API version of the referent
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * kind is the kind of the referent; More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * kind is the kind of the referent; More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * name is the name of the referent; More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the referent; More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ExternalMetricSource.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ExternalMetricSource.java
index 7f6a14c58d0..75dff2293e9 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ExternalMetricSource.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ExternalMetricSource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ExternalMetricSource indicates how to scale on a metric not associated with any Kubernetes object (for example length of queue in cloud messaging service, or QPS from loadbalancer running outside of cluster).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ExternalMetricSource(MetricIdentifier metric, MetricTarget target) {
         this.target = target;
     }
 
+    /**
+     * ExternalMetricSource indicates how to scale on a metric not associated with any Kubernetes object (for example length of queue in cloud messaging service, or QPS from loadbalancer running outside of cluster).
+     */
     @JsonProperty("metric")
     public MetricIdentifier getMetric() {
         return metric;
     }
 
+    /**
+     * ExternalMetricSource indicates how to scale on a metric not associated with any Kubernetes object (for example length of queue in cloud messaging service, or QPS from loadbalancer running outside of cluster).
+     */
     @JsonProperty("metric")
     public void setMetric(MetricIdentifier metric) {
         this.metric = metric;
     }
 
+    /**
+     * ExternalMetricSource indicates how to scale on a metric not associated with any Kubernetes object (for example length of queue in cloud messaging service, or QPS from loadbalancer running outside of cluster).
+     */
     @JsonProperty("target")
     public MetricTarget getTarget() {
         return target;
     }
 
+    /**
+     * ExternalMetricSource indicates how to scale on a metric not associated with any Kubernetes object (for example length of queue in cloud messaging service, or QPS from loadbalancer running outside of cluster).
+     */
     @JsonProperty("target")
     public void setTarget(MetricTarget target) {
         this.target = target;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ExternalMetricStatus.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ExternalMetricStatus.java
index 4604dc6bd93..fc09ce2b909 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ExternalMetricStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ExternalMetricStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ExternalMetricStatus indicates the current value of a global metric not associated with any Kubernetes object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ExternalMetricStatus(MetricValueStatus current, MetricIdentifier metric)
         this.metric = metric;
     }
 
+    /**
+     * ExternalMetricStatus indicates the current value of a global metric not associated with any Kubernetes object.
+     */
     @JsonProperty("current")
     public MetricValueStatus getCurrent() {
         return current;
     }
 
+    /**
+     * ExternalMetricStatus indicates the current value of a global metric not associated with any Kubernetes object.
+     */
     @JsonProperty("current")
     public void setCurrent(MetricValueStatus current) {
         this.current = current;
     }
 
+    /**
+     * ExternalMetricStatus indicates the current value of a global metric not associated with any Kubernetes object.
+     */
     @JsonProperty("metric")
     public MetricIdentifier getMetric() {
         return metric;
     }
 
+    /**
+     * ExternalMetricStatus indicates the current value of a global metric not associated with any Kubernetes object.
+     */
     @JsonProperty("metric")
     public void setMetric(MetricIdentifier metric) {
         this.metric = metric;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HPAScalingPolicy.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HPAScalingPolicy.java
index fef04bbaef5..e554537ddfa 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HPAScalingPolicy.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HPAScalingPolicy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HPAScalingPolicy is a single policy which must hold true for a specified past interval.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public HPAScalingPolicy(Integer periodSeconds, String type, Integer value) {
         this.value = value;
     }
 
+    /**
+     * periodSeconds specifies the window of time for which the policy should hold true. PeriodSeconds must be greater than zero and less than or equal to 1800 (30 min).
+     */
     @JsonProperty("periodSeconds")
     public Integer getPeriodSeconds() {
         return periodSeconds;
     }
 
+    /**
+     * periodSeconds specifies the window of time for which the policy should hold true. PeriodSeconds must be greater than zero and less than or equal to 1800 (30 min).
+     */
     @JsonProperty("periodSeconds")
     public void setPeriodSeconds(Integer periodSeconds) {
         this.periodSeconds = periodSeconds;
     }
 
+    /**
+     * type is used to specify the scaling policy.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is used to specify the scaling policy.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * value contains the amount of change which is permitted by the policy. It must be greater than zero
+     */
     @JsonProperty("value")
     public Integer getValue() {
         return value;
     }
 
+    /**
+     * value contains the amount of change which is permitted by the policy. It must be greater than zero
+     */
     @JsonProperty("value")
     public void setValue(Integer value) {
         this.value = value;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HPAScalingRules.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HPAScalingRules.java
index 099bee786f6..499aba689d8 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HPAScalingRules.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HPAScalingRules.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HPAScalingRules configures the scaling behavior for one direction. These Rules are applied after calculating DesiredReplicas from metrics for the HPA. They can limit the scaling velocity by specifying scaling policies. They can prevent flapping by specifying the stabilization window, so that the number of replicas is not set instantly, instead, the safest value from the stabilization window is chosen.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public HPAScalingRules(List<HPAScalingPolicy> policies, String selectPolicy, Int
         this.stabilizationWindowSeconds = stabilizationWindowSeconds;
     }
 
+    /**
+     * policies is a list of potential scaling polices which can be used during scaling. At least one policy must be specified, otherwise the HPAScalingRules will be discarded as invalid
+     */
     @JsonProperty("policies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HPAScalingPolicy> getPolicies() {
         return policies;
     }
 
+    /**
+     * policies is a list of potential scaling polices which can be used during scaling. At least one policy must be specified, otherwise the HPAScalingRules will be discarded as invalid
+     */
     @JsonProperty("policies")
     public void setPolicies(List<HPAScalingPolicy> policies) {
         this.policies = policies;
     }
 
+    /**
+     * selectPolicy is used to specify which policy should be used. If not set, the default value Max is used.
+     */
     @JsonProperty("selectPolicy")
     public String getSelectPolicy() {
         return selectPolicy;
     }
 
+    /**
+     * selectPolicy is used to specify which policy should be used. If not set, the default value Max is used.
+     */
     @JsonProperty("selectPolicy")
     public void setSelectPolicy(String selectPolicy) {
         this.selectPolicy = selectPolicy;
     }
 
+    /**
+     * stabilizationWindowSeconds is the number of seconds for which past recommendations should be considered while scaling up or scaling down. StabilizationWindowSeconds must be greater than or equal to zero and less than or equal to 3600 (one hour). If not set, use the default values: - For scale up: 0 (i.e. no stabilization is done). - For scale down: 300 (i.e. the stabilization window is 300 seconds long).
+     */
     @JsonProperty("stabilizationWindowSeconds")
     public Integer getStabilizationWindowSeconds() {
         return stabilizationWindowSeconds;
     }
 
+    /**
+     * stabilizationWindowSeconds is the number of seconds for which past recommendations should be considered while scaling up or scaling down. StabilizationWindowSeconds must be greater than or equal to zero and less than or equal to 3600 (one hour). If not set, use the default values: - For scale up: 0 (i.e. no stabilization is done). - For scale down: 300 (i.e. the stabilization window is 300 seconds long).
+     */
     @JsonProperty("stabilizationWindowSeconds")
     public void setStabilizationWindowSeconds(Integer stabilizationWindowSeconds) {
         this.stabilizationWindowSeconds = stabilizationWindowSeconds;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HorizontalPodAutoscaler.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HorizontalPodAutoscaler.java
index c6df03515a0..d408fa3d53a 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HorizontalPodAutoscaler.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HorizontalPodAutoscaler.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HorizontalPodAutoscaler is the configuration for a horizontal pod autoscaler, which automatically manages the replica count of any resource implementing the scale subresource based on the metrics specified.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class HorizontalPodAutoscaler implements Editable<HorizontalPodAutoscalerBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling/v2";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "HorizontalPodAutoscaler";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public HorizontalPodAutoscaler(String apiVersion, String kind, ObjectMeta metada
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * HorizontalPodAutoscaler is the configuration for a horizontal pod autoscaler, which automatically manages the replica count of any resource implementing the scale subresource based on the metrics specified.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * HorizontalPodAutoscaler is the configuration for a horizontal pod autoscaler, which automatically manages the replica count of any resource implementing the scale subresource based on the metrics specified.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * HorizontalPodAutoscaler is the configuration for a horizontal pod autoscaler, which automatically manages the replica count of any resource implementing the scale subresource based on the metrics specified.
+     */
     @JsonProperty("spec")
     public HorizontalPodAutoscalerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * HorizontalPodAutoscaler is the configuration for a horizontal pod autoscaler, which automatically manages the replica count of any resource implementing the scale subresource based on the metrics specified.
+     */
     @JsonProperty("spec")
     public void setSpec(HorizontalPodAutoscalerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * HorizontalPodAutoscaler is the configuration for a horizontal pod autoscaler, which automatically manages the replica count of any resource implementing the scale subresource based on the metrics specified.
+     */
     @JsonProperty("status")
     public HorizontalPodAutoscalerStatus getStatus() {
         return status;
     }
 
+    /**
+     * HorizontalPodAutoscaler is the configuration for a horizontal pod autoscaler, which automatically manages the replica count of any resource implementing the scale subresource based on the metrics specified.
+     */
     @JsonProperty("status")
     public void setStatus(HorizontalPodAutoscalerStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HorizontalPodAutoscalerBehavior.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HorizontalPodAutoscalerBehavior.java
index 071676b0a65..4fb2423ea9c 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HorizontalPodAutoscalerBehavior.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HorizontalPodAutoscalerBehavior.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HorizontalPodAutoscalerBehavior configures the scaling behavior of the target in both Up and Down directions (scaleUp and scaleDown fields respectively).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public HorizontalPodAutoscalerBehavior(HPAScalingRules scaleDown, HPAScalingRule
         this.scaleUp = scaleUp;
     }
 
+    /**
+     * HorizontalPodAutoscalerBehavior configures the scaling behavior of the target in both Up and Down directions (scaleUp and scaleDown fields respectively).
+     */
     @JsonProperty("scaleDown")
     public HPAScalingRules getScaleDown() {
         return scaleDown;
     }
 
+    /**
+     * HorizontalPodAutoscalerBehavior configures the scaling behavior of the target in both Up and Down directions (scaleUp and scaleDown fields respectively).
+     */
     @JsonProperty("scaleDown")
     public void setScaleDown(HPAScalingRules scaleDown) {
         this.scaleDown = scaleDown;
     }
 
+    /**
+     * HorizontalPodAutoscalerBehavior configures the scaling behavior of the target in both Up and Down directions (scaleUp and scaleDown fields respectively).
+     */
     @JsonProperty("scaleUp")
     public HPAScalingRules getScaleUp() {
         return scaleUp;
     }
 
+    /**
+     * HorizontalPodAutoscalerBehavior configures the scaling behavior of the target in both Up and Down directions (scaleUp and scaleDown fields respectively).
+     */
     @JsonProperty("scaleUp")
     public void setScaleUp(HPAScalingRules scaleUp) {
         this.scaleUp = scaleUp;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HorizontalPodAutoscalerCondition.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HorizontalPodAutoscalerCondition.java
index 2f1e42d4a32..64a3942b6b8 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HorizontalPodAutoscalerCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HorizontalPodAutoscalerCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HorizontalPodAutoscalerCondition describes the state of a HorizontalPodAutoscaler at a certain point.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public HorizontalPodAutoscalerCondition(String lastTransitionTime, String messag
         this.type = type;
     }
 
+    /**
+     * HorizontalPodAutoscalerCondition describes the state of a HorizontalPodAutoscaler at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * HorizontalPodAutoscalerCondition describes the state of a HorizontalPodAutoscaler at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * message is a human-readable explanation containing details about the transition
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message is a human-readable explanation containing details about the transition
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * reason is the reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * reason is the reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * status is the status of the condition (True, False, Unknown)
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * status is the status of the condition (True, False, Unknown)
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * type describes the current condition
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type describes the current condition
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HorizontalPodAutoscalerList.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HorizontalPodAutoscalerList.java
index c910ec16620..68c7d14788c 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HorizontalPodAutoscalerList.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HorizontalPodAutoscalerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HorizontalPodAutoscalerList is a list of horizontal pod autoscaler objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class HorizontalPodAutoscalerList implements Editable<HorizontalPodAutoscalerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.autoscaling.v2.HorizontalPodAutoscaler>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling/v2";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.autoscaling.v2.HorizontalPodAutoscaler> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "HorizontalPodAutoscalerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public HorizontalPodAutoscalerList(String apiVersion, List<io.fabric8.kubernetes
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of horizontal pod autoscaler objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.autoscaling.v2.HorizontalPodAutoscaler> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of horizontal pod autoscaler objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.autoscaling.v2.HorizontalPodAutoscaler> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * HorizontalPodAutoscalerList is a list of horizontal pod autoscaler objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * HorizontalPodAutoscalerList is a list of horizontal pod autoscaler objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HorizontalPodAutoscalerSpec.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HorizontalPodAutoscalerSpec.java
index 634360fd2e8..fe9ef5513f7 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HorizontalPodAutoscalerSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HorizontalPodAutoscalerSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HorizontalPodAutoscalerSpec describes the desired functionality of the HorizontalPodAutoscaler.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -97,52 +100,82 @@ public HorizontalPodAutoscalerSpec(HorizontalPodAutoscalerBehavior behavior, Int
         this.scaleTargetRef = scaleTargetRef;
     }
 
+    /**
+     * HorizontalPodAutoscalerSpec describes the desired functionality of the HorizontalPodAutoscaler.
+     */
     @JsonProperty("behavior")
     public HorizontalPodAutoscalerBehavior getBehavior() {
         return behavior;
     }
 
+    /**
+     * HorizontalPodAutoscalerSpec describes the desired functionality of the HorizontalPodAutoscaler.
+     */
     @JsonProperty("behavior")
     public void setBehavior(HorizontalPodAutoscalerBehavior behavior) {
         this.behavior = behavior;
     }
 
+    /**
+     * maxReplicas is the upper limit for the number of replicas to which the autoscaler can scale up. It cannot be less that minReplicas.
+     */
     @JsonProperty("maxReplicas")
     public Integer getMaxReplicas() {
         return maxReplicas;
     }
 
+    /**
+     * maxReplicas is the upper limit for the number of replicas to which the autoscaler can scale up. It cannot be less that minReplicas.
+     */
     @JsonProperty("maxReplicas")
     public void setMaxReplicas(Integer maxReplicas) {
         this.maxReplicas = maxReplicas;
     }
 
+    /**
+     * metrics contains the specifications for which to use to calculate the desired replica count (the maximum replica count across all metrics will be used).  The desired replica count is calculated multiplying the ratio between the target value and the current value by the current number of pods.  Ergo, metrics used must decrease as the pod count is increased, and vice-versa.  See the individual metric source types for more information about how each type of metric must respond. If not set, the default metric will be set to 80% average CPU utilization.
+     */
     @JsonProperty("metrics")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MetricSpec> getMetrics() {
         return metrics;
     }
 
+    /**
+     * metrics contains the specifications for which to use to calculate the desired replica count (the maximum replica count across all metrics will be used).  The desired replica count is calculated multiplying the ratio between the target value and the current value by the current number of pods.  Ergo, metrics used must decrease as the pod count is increased, and vice-versa.  See the individual metric source types for more information about how each type of metric must respond. If not set, the default metric will be set to 80% average CPU utilization.
+     */
     @JsonProperty("metrics")
     public void setMetrics(List<MetricSpec> metrics) {
         this.metrics = metrics;
     }
 
+    /**
+     * minReplicas is the lower limit for the number of replicas to which the autoscaler can scale down.  It defaults to 1 pod.  minReplicas is allowed to be 0 if the alpha feature gate HPAScaleToZero is enabled and at least one Object or External metric is configured.  Scaling is active as long as at least one metric value is available.
+     */
     @JsonProperty("minReplicas")
     public Integer getMinReplicas() {
         return minReplicas;
     }
 
+    /**
+     * minReplicas is the lower limit for the number of replicas to which the autoscaler can scale down.  It defaults to 1 pod.  minReplicas is allowed to be 0 if the alpha feature gate HPAScaleToZero is enabled and at least one Object or External metric is configured.  Scaling is active as long as at least one metric value is available.
+     */
     @JsonProperty("minReplicas")
     public void setMinReplicas(Integer minReplicas) {
         this.minReplicas = minReplicas;
     }
 
+    /**
+     * HorizontalPodAutoscalerSpec describes the desired functionality of the HorizontalPodAutoscaler.
+     */
     @JsonProperty("scaleTargetRef")
     public CrossVersionObjectReference getScaleTargetRef() {
         return scaleTargetRef;
     }
 
+    /**
+     * HorizontalPodAutoscalerSpec describes the desired functionality of the HorizontalPodAutoscaler.
+     */
     @JsonProperty("scaleTargetRef")
     public void setScaleTargetRef(CrossVersionObjectReference scaleTargetRef) {
         this.scaleTargetRef = scaleTargetRef;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HorizontalPodAutoscalerStatus.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HorizontalPodAutoscalerStatus.java
index 2f6114efbb0..b9214046883 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HorizontalPodAutoscalerStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/HorizontalPodAutoscalerStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HorizontalPodAutoscalerStatus describes the current status of a horizontal pod autoscaler.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,63 +105,99 @@ public HorizontalPodAutoscalerStatus(List<HorizontalPodAutoscalerCondition> cond
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * conditions is the set of conditions required for this autoscaler to scale its target, and indicates whether or not those conditions are met.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HorizontalPodAutoscalerCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is the set of conditions required for this autoscaler to scale its target, and indicates whether or not those conditions are met.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<HorizontalPodAutoscalerCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * currentMetrics is the last read state of the metrics used by this autoscaler.
+     */
     @JsonProperty("currentMetrics")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MetricStatus> getCurrentMetrics() {
         return currentMetrics;
     }
 
+    /**
+     * currentMetrics is the last read state of the metrics used by this autoscaler.
+     */
     @JsonProperty("currentMetrics")
     public void setCurrentMetrics(List<MetricStatus> currentMetrics) {
         this.currentMetrics = currentMetrics;
     }
 
+    /**
+     * currentReplicas is current number of replicas of pods managed by this autoscaler, as last seen by the autoscaler.
+     */
     @JsonProperty("currentReplicas")
     public Integer getCurrentReplicas() {
         return currentReplicas;
     }
 
+    /**
+     * currentReplicas is current number of replicas of pods managed by this autoscaler, as last seen by the autoscaler.
+     */
     @JsonProperty("currentReplicas")
     public void setCurrentReplicas(Integer currentReplicas) {
         this.currentReplicas = currentReplicas;
     }
 
+    /**
+     * desiredReplicas is the desired number of replicas of pods managed by this autoscaler, as last calculated by the autoscaler.
+     */
     @JsonProperty("desiredReplicas")
     public Integer getDesiredReplicas() {
         return desiredReplicas;
     }
 
+    /**
+     * desiredReplicas is the desired number of replicas of pods managed by this autoscaler, as last calculated by the autoscaler.
+     */
     @JsonProperty("desiredReplicas")
     public void setDesiredReplicas(Integer desiredReplicas) {
         this.desiredReplicas = desiredReplicas;
     }
 
+    /**
+     * HorizontalPodAutoscalerStatus describes the current status of a horizontal pod autoscaler.
+     */
     @JsonProperty("lastScaleTime")
     public String getLastScaleTime() {
         return lastScaleTime;
     }
 
+    /**
+     * HorizontalPodAutoscalerStatus describes the current status of a horizontal pod autoscaler.
+     */
     @JsonProperty("lastScaleTime")
     public void setLastScaleTime(String lastScaleTime) {
         this.lastScaleTime = lastScaleTime;
     }
 
+    /**
+     * observedGeneration is the most recent generation observed by this autoscaler.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the most recent generation observed by this autoscaler.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/MetricIdentifier.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/MetricIdentifier.java
index 5d06425bf66..674931940b0 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/MetricIdentifier.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/MetricIdentifier.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MetricIdentifier defines the name and optionally selector for a metric
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public MetricIdentifier(String name, LabelSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * name is the name of the given metric
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the given metric
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * MetricIdentifier defines the name and optionally selector for a metric
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * MetricIdentifier defines the name and optionally selector for a metric
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/MetricSpec.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/MetricSpec.java
index fe90cafa341..a51d8de5c2b 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/MetricSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/MetricSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public MetricSpec(ContainerResourceMetricSource containerResource, ExternalMetri
         this.type = type;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("containerResource")
     public ContainerResourceMetricSource getContainerResource() {
         return containerResource;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("containerResource")
     public void setContainerResource(ContainerResourceMetricSource containerResource) {
         this.containerResource = containerResource;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("external")
     public ExternalMetricSource getExternal() {
         return external;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("external")
     public void setExternal(ExternalMetricSource external) {
         this.external = external;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("object")
     public ObjectMetricSource getObject() {
         return object;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("object")
     public void setObject(ObjectMetricSource object) {
         this.object = object;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("pods")
     public PodsMetricSource getPods() {
         return pods;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("pods")
     public void setPods(PodsMetricSource pods) {
         this.pods = pods;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("resource")
     public ResourceMetricSource getResource() {
         return resource;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("resource")
     public void setResource(ResourceMetricSource resource) {
         this.resource = resource;
     }
 
+    /**
+     * type is the type of metric source.  It should be one of "ContainerResource", "External", "Object", "Pods" or "Resource", each mapping to a matching field in the object.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the type of metric source.  It should be one of "ContainerResource", "External", "Object", "Pods" or "Resource", each mapping to a matching field in the object.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/MetricStatus.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/MetricStatus.java
index 63e73a33e05..1cd294746f1 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/MetricStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/MetricStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MetricStatus describes the last-read state of a single metric.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public MetricStatus(ContainerResourceMetricStatus containerResource, ExternalMet
         this.type = type;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("containerResource")
     public ContainerResourceMetricStatus getContainerResource() {
         return containerResource;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("containerResource")
     public void setContainerResource(ContainerResourceMetricStatus containerResource) {
         this.containerResource = containerResource;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("external")
     public ExternalMetricStatus getExternal() {
         return external;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("external")
     public void setExternal(ExternalMetricStatus external) {
         this.external = external;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("object")
     public ObjectMetricStatus getObject() {
         return object;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("object")
     public void setObject(ObjectMetricStatus object) {
         this.object = object;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("pods")
     public PodsMetricStatus getPods() {
         return pods;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("pods")
     public void setPods(PodsMetricStatus pods) {
         this.pods = pods;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("resource")
     public ResourceMetricStatus getResource() {
         return resource;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("resource")
     public void setResource(ResourceMetricStatus resource) {
         this.resource = resource;
     }
 
+    /**
+     * type is the type of metric source.  It will be one of "ContainerResource", "External", "Object", "Pods" or "Resource", each corresponds to a matching field in the object.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the type of metric source.  It will be one of "ContainerResource", "External", "Object", "Pods" or "Resource", each corresponds to a matching field in the object.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/MetricTarget.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/MetricTarget.java
index d755f0ef23e..011f3bc082b 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/MetricTarget.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/MetricTarget.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MetricTarget defines the target value, average value, or average utilization of a specific metric
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,41 +94,65 @@ public MetricTarget(Integer averageUtilization, Quantity averageValue, String ty
         this.value = value;
     }
 
+    /**
+     * averageUtilization is the target value of the average of the resource metric across all relevant pods, represented as a percentage of the requested value of the resource for the pods. Currently only valid for Resource metric source type
+     */
     @JsonProperty("averageUtilization")
     public Integer getAverageUtilization() {
         return averageUtilization;
     }
 
+    /**
+     * averageUtilization is the target value of the average of the resource metric across all relevant pods, represented as a percentage of the requested value of the resource for the pods. Currently only valid for Resource metric source type
+     */
     @JsonProperty("averageUtilization")
     public void setAverageUtilization(Integer averageUtilization) {
         this.averageUtilization = averageUtilization;
     }
 
+    /**
+     * MetricTarget defines the target value, average value, or average utilization of a specific metric
+     */
     @JsonProperty("averageValue")
     public Quantity getAverageValue() {
         return averageValue;
     }
 
+    /**
+     * MetricTarget defines the target value, average value, or average utilization of a specific metric
+     */
     @JsonProperty("averageValue")
     public void setAverageValue(Quantity averageValue) {
         this.averageValue = averageValue;
     }
 
+    /**
+     * type represents whether the metric type is Utilization, Value, or AverageValue
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type represents whether the metric type is Utilization, Value, or AverageValue
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * MetricTarget defines the target value, average value, or average utilization of a specific metric
+     */
     @JsonProperty("value")
     public Quantity getValue() {
         return value;
     }
 
+    /**
+     * MetricTarget defines the target value, average value, or average utilization of a specific metric
+     */
     @JsonProperty("value")
     public void setValue(Quantity value) {
         this.value = value;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/MetricValueStatus.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/MetricValueStatus.java
index c54732cee11..c04dd9fa197 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/MetricValueStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/MetricValueStatus.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MetricValueStatus holds the current value for a metric
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,31 +90,49 @@ public MetricValueStatus(Integer averageUtilization, Quantity averageValue, Quan
         this.value = value;
     }
 
+    /**
+     * currentAverageUtilization is the current value of the average of the resource metric across all relevant pods, represented as a percentage of the requested value of the resource for the pods.
+     */
     @JsonProperty("averageUtilization")
     public Integer getAverageUtilization() {
         return averageUtilization;
     }
 
+    /**
+     * currentAverageUtilization is the current value of the average of the resource metric across all relevant pods, represented as a percentage of the requested value of the resource for the pods.
+     */
     @JsonProperty("averageUtilization")
     public void setAverageUtilization(Integer averageUtilization) {
         this.averageUtilization = averageUtilization;
     }
 
+    /**
+     * MetricValueStatus holds the current value for a metric
+     */
     @JsonProperty("averageValue")
     public Quantity getAverageValue() {
         return averageValue;
     }
 
+    /**
+     * MetricValueStatus holds the current value for a metric
+     */
     @JsonProperty("averageValue")
     public void setAverageValue(Quantity averageValue) {
         this.averageValue = averageValue;
     }
 
+    /**
+     * MetricValueStatus holds the current value for a metric
+     */
     @JsonProperty("value")
     public Quantity getValue() {
         return value;
     }
 
+    /**
+     * MetricValueStatus holds the current value for a metric
+     */
     @JsonProperty("value")
     public void setValue(Quantity value) {
         this.value = value;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ObjectMetricSource.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ObjectMetricSource.java
index 921b6a82683..596c10a5776 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ObjectMetricSource.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ObjectMetricSource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ObjectMetricSource indicates how to scale on a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ObjectMetricSource(CrossVersionObjectReference describedObject, MetricIde
         this.target = target;
     }
 
+    /**
+     * ObjectMetricSource indicates how to scale on a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("describedObject")
     public CrossVersionObjectReference getDescribedObject() {
         return describedObject;
     }
 
+    /**
+     * ObjectMetricSource indicates how to scale on a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("describedObject")
     public void setDescribedObject(CrossVersionObjectReference describedObject) {
         this.describedObject = describedObject;
     }
 
+    /**
+     * ObjectMetricSource indicates how to scale on a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("metric")
     public MetricIdentifier getMetric() {
         return metric;
     }
 
+    /**
+     * ObjectMetricSource indicates how to scale on a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("metric")
     public void setMetric(MetricIdentifier metric) {
         this.metric = metric;
     }
 
+    /**
+     * ObjectMetricSource indicates how to scale on a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("target")
     public MetricTarget getTarget() {
         return target;
     }
 
+    /**
+     * ObjectMetricSource indicates how to scale on a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("target")
     public void setTarget(MetricTarget target) {
         this.target = target;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ObjectMetricStatus.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ObjectMetricStatus.java
index c3de44433a6..4ea0d61c917 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ObjectMetricStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ObjectMetricStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ObjectMetricStatus indicates the current value of a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ObjectMetricStatus(MetricValueStatus current, CrossVersionObjectReference
         this.metric = metric;
     }
 
+    /**
+     * ObjectMetricStatus indicates the current value of a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("current")
     public MetricValueStatus getCurrent() {
         return current;
     }
 
+    /**
+     * ObjectMetricStatus indicates the current value of a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("current")
     public void setCurrent(MetricValueStatus current) {
         this.current = current;
     }
 
+    /**
+     * ObjectMetricStatus indicates the current value of a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("describedObject")
     public CrossVersionObjectReference getDescribedObject() {
         return describedObject;
     }
 
+    /**
+     * ObjectMetricStatus indicates the current value of a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("describedObject")
     public void setDescribedObject(CrossVersionObjectReference describedObject) {
         this.describedObject = describedObject;
     }
 
+    /**
+     * ObjectMetricStatus indicates the current value of a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("metric")
     public MetricIdentifier getMetric() {
         return metric;
     }
 
+    /**
+     * ObjectMetricStatus indicates the current value of a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("metric")
     public void setMetric(MetricIdentifier metric) {
         this.metric = metric;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/PodsMetricSource.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/PodsMetricSource.java
index 945ac18ea3a..5529ed80562 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/PodsMetricSource.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/PodsMetricSource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodsMetricSource indicates how to scale on a metric describing each pod in the current scale target (for example, transactions-processed-per-second). The values will be averaged together before being compared to the target value.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PodsMetricSource(MetricIdentifier metric, MetricTarget target) {
         this.target = target;
     }
 
+    /**
+     * PodsMetricSource indicates how to scale on a metric describing each pod in the current scale target (for example, transactions-processed-per-second). The values will be averaged together before being compared to the target value.
+     */
     @JsonProperty("metric")
     public MetricIdentifier getMetric() {
         return metric;
     }
 
+    /**
+     * PodsMetricSource indicates how to scale on a metric describing each pod in the current scale target (for example, transactions-processed-per-second). The values will be averaged together before being compared to the target value.
+     */
     @JsonProperty("metric")
     public void setMetric(MetricIdentifier metric) {
         this.metric = metric;
     }
 
+    /**
+     * PodsMetricSource indicates how to scale on a metric describing each pod in the current scale target (for example, transactions-processed-per-second). The values will be averaged together before being compared to the target value.
+     */
     @JsonProperty("target")
     public MetricTarget getTarget() {
         return target;
     }
 
+    /**
+     * PodsMetricSource indicates how to scale on a metric describing each pod in the current scale target (for example, transactions-processed-per-second). The values will be averaged together before being compared to the target value.
+     */
     @JsonProperty("target")
     public void setTarget(MetricTarget target) {
         this.target = target;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/PodsMetricStatus.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/PodsMetricStatus.java
index d96c4abc388..0d08f956a9b 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/PodsMetricStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/PodsMetricStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodsMetricStatus indicates the current value of a metric describing each pod in the current scale target (for example, transactions-processed-per-second).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PodsMetricStatus(MetricValueStatus current, MetricIdentifier metric) {
         this.metric = metric;
     }
 
+    /**
+     * PodsMetricStatus indicates the current value of a metric describing each pod in the current scale target (for example, transactions-processed-per-second).
+     */
     @JsonProperty("current")
     public MetricValueStatus getCurrent() {
         return current;
     }
 
+    /**
+     * PodsMetricStatus indicates the current value of a metric describing each pod in the current scale target (for example, transactions-processed-per-second).
+     */
     @JsonProperty("current")
     public void setCurrent(MetricValueStatus current) {
         this.current = current;
     }
 
+    /**
+     * PodsMetricStatus indicates the current value of a metric describing each pod in the current scale target (for example, transactions-processed-per-second).
+     */
     @JsonProperty("metric")
     public MetricIdentifier getMetric() {
         return metric;
     }
 
+    /**
+     * PodsMetricStatus indicates the current value of a metric describing each pod in the current scale target (for example, transactions-processed-per-second).
+     */
     @JsonProperty("metric")
     public void setMetric(MetricIdentifier metric) {
         this.metric = metric;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ResourceMetricSource.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ResourceMetricSource.java
index 9e70933d57e..e95aae0eaa5 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ResourceMetricSource.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ResourceMetricSource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceMetricSource indicates how to scale on a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory).  The values will be averaged together before being compared to the target.  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.  Only one "target" type should be set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ResourceMetricSource(String name, MetricTarget target) {
         this.target = target;
     }
 
+    /**
+     * name is the name of the resource in question.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the resource in question.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * ResourceMetricSource indicates how to scale on a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory).  The values will be averaged together before being compared to the target.  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.  Only one "target" type should be set.
+     */
     @JsonProperty("target")
     public MetricTarget getTarget() {
         return target;
     }
 
+    /**
+     * ResourceMetricSource indicates how to scale on a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory).  The values will be averaged together before being compared to the target.  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.  Only one "target" type should be set.
+     */
     @JsonProperty("target")
     public void setTarget(MetricTarget target) {
         this.target = target;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ResourceMetricStatus.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ResourceMetricStatus.java
index 40e2a042e7d..9db741e4ab8 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ResourceMetricStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2/ResourceMetricStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceMetricStatus indicates the current value of a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory).  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ResourceMetricStatus(MetricValueStatus current, String name) {
         this.name = name;
     }
 
+    /**
+     * ResourceMetricStatus indicates the current value of a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory).  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.
+     */
     @JsonProperty("current")
     public MetricValueStatus getCurrent() {
         return current;
     }
 
+    /**
+     * ResourceMetricStatus indicates the current value of a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory).  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.
+     */
     @JsonProperty("current")
     public void setCurrent(MetricValueStatus current) {
         this.current = current;
     }
 
+    /**
+     * name is the name of the resource in question.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the resource in question.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ContainerResourceMetricSource.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ContainerResourceMetricSource.java
index 953192a258d..c753f4058d6 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ContainerResourceMetricSource.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ContainerResourceMetricSource.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerResourceMetricSource indicates how to scale on a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory).  The values will be averaged together before being compared to the target.  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.  Only one "target" type should be set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,41 +94,65 @@ public ContainerResourceMetricSource(String container, String name, Integer targ
         this.targetAverageValue = targetAverageValue;
     }
 
+    /**
+     * container is the name of the container in the pods of the scaling target
+     */
     @JsonProperty("container")
     public String getContainer() {
         return container;
     }
 
+    /**
+     * container is the name of the container in the pods of the scaling target
+     */
     @JsonProperty("container")
     public void setContainer(String container) {
         this.container = container;
     }
 
+    /**
+     * name is the name of the resource in question.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the resource in question.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * targetAverageUtilization is the target value of the average of the resource metric across all relevant pods, represented as a percentage of the requested value of the resource for the pods.
+     */
     @JsonProperty("targetAverageUtilization")
     public Integer getTargetAverageUtilization() {
         return targetAverageUtilization;
     }
 
+    /**
+     * targetAverageUtilization is the target value of the average of the resource metric across all relevant pods, represented as a percentage of the requested value of the resource for the pods.
+     */
     @JsonProperty("targetAverageUtilization")
     public void setTargetAverageUtilization(Integer targetAverageUtilization) {
         this.targetAverageUtilization = targetAverageUtilization;
     }
 
+    /**
+     * ContainerResourceMetricSource indicates how to scale on a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory).  The values will be averaged together before being compared to the target.  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.  Only one "target" type should be set.
+     */
     @JsonProperty("targetAverageValue")
     public Quantity getTargetAverageValue() {
         return targetAverageValue;
     }
 
+    /**
+     * ContainerResourceMetricSource indicates how to scale on a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory).  The values will be averaged together before being compared to the target.  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.  Only one "target" type should be set.
+     */
     @JsonProperty("targetAverageValue")
     public void setTargetAverageValue(Quantity targetAverageValue) {
         this.targetAverageValue = targetAverageValue;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ContainerResourceMetricStatus.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ContainerResourceMetricStatus.java
index 22cf038be43..04243539d6f 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ContainerResourceMetricStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ContainerResourceMetricStatus.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerResourceMetricStatus indicates the current value of a resource metric known to Kubernetes, as specified in requests and limits, describing a single container in each pod in the current scale target (e.g. CPU or memory).  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,41 +94,65 @@ public ContainerResourceMetricStatus(String container, Integer currentAverageUti
         this.name = name;
     }
 
+    /**
+     * container is the name of the container in the pods of the scaling target
+     */
     @JsonProperty("container")
     public String getContainer() {
         return container;
     }
 
+    /**
+     * container is the name of the container in the pods of the scaling target
+     */
     @JsonProperty("container")
     public void setContainer(String container) {
         this.container = container;
     }
 
+    /**
+     * currentAverageUtilization is the current value of the average of the resource metric across all relevant pods, represented as a percentage of the requested value of the resource for the pods.  It will only be present if `targetAverageValue` was set in the corresponding metric specification.
+     */
     @JsonProperty("currentAverageUtilization")
     public Integer getCurrentAverageUtilization() {
         return currentAverageUtilization;
     }
 
+    /**
+     * currentAverageUtilization is the current value of the average of the resource metric across all relevant pods, represented as a percentage of the requested value of the resource for the pods.  It will only be present if `targetAverageValue` was set in the corresponding metric specification.
+     */
     @JsonProperty("currentAverageUtilization")
     public void setCurrentAverageUtilization(Integer currentAverageUtilization) {
         this.currentAverageUtilization = currentAverageUtilization;
     }
 
+    /**
+     * ContainerResourceMetricStatus indicates the current value of a resource metric known to Kubernetes, as specified in requests and limits, describing a single container in each pod in the current scale target (e.g. CPU or memory).  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.
+     */
     @JsonProperty("currentAverageValue")
     public Quantity getCurrentAverageValue() {
         return currentAverageValue;
     }
 
+    /**
+     * ContainerResourceMetricStatus indicates the current value of a resource metric known to Kubernetes, as specified in requests and limits, describing a single container in each pod in the current scale target (e.g. CPU or memory).  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.
+     */
     @JsonProperty("currentAverageValue")
     public void setCurrentAverageValue(Quantity currentAverageValue) {
         this.currentAverageValue = currentAverageValue;
     }
 
+    /**
+     * name is the name of the resource in question.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the resource in question.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/CrossVersionObjectReference.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/CrossVersionObjectReference.java
index da6cb5eea42..d0393732983 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/CrossVersionObjectReference.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/CrossVersionObjectReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CrossVersionObjectReference contains enough information to let you identify the referred resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public CrossVersionObjectReference(String apiVersion, String kind, String name)
         this.name = name;
     }
 
+    /**
+     * API version of the referent
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * API version of the referent
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Kind of the referent; More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds"
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind of the referent; More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds"
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name of the referent; More info: http://kubernetes.io/docs/user-guide/identifiers#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referent; More info: http://kubernetes.io/docs/user-guide/identifiers#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ExternalMetricSource.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ExternalMetricSource.java
index 71f1947ba92..e900013dbc4 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ExternalMetricSource.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ExternalMetricSource.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ExternalMetricSource indicates how to scale on a metric not associated with any Kubernetes object (for example length of queue in cloud messaging service, or QPS from loadbalancer running outside of cluster). Exactly one "target" type should be set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,41 +94,65 @@ public ExternalMetricSource(String metricName, LabelSelector metricSelector, Qua
         this.targetValue = targetValue;
     }
 
+    /**
+     * metricName is the name of the metric in question.
+     */
     @JsonProperty("metricName")
     public String getMetricName() {
         return metricName;
     }
 
+    /**
+     * metricName is the name of the metric in question.
+     */
     @JsonProperty("metricName")
     public void setMetricName(String metricName) {
         this.metricName = metricName;
     }
 
+    /**
+     * ExternalMetricSource indicates how to scale on a metric not associated with any Kubernetes object (for example length of queue in cloud messaging service, or QPS from loadbalancer running outside of cluster). Exactly one "target" type should be set.
+     */
     @JsonProperty("metricSelector")
     public LabelSelector getMetricSelector() {
         return metricSelector;
     }
 
+    /**
+     * ExternalMetricSource indicates how to scale on a metric not associated with any Kubernetes object (for example length of queue in cloud messaging service, or QPS from loadbalancer running outside of cluster). Exactly one "target" type should be set.
+     */
     @JsonProperty("metricSelector")
     public void setMetricSelector(LabelSelector metricSelector) {
         this.metricSelector = metricSelector;
     }
 
+    /**
+     * ExternalMetricSource indicates how to scale on a metric not associated with any Kubernetes object (for example length of queue in cloud messaging service, or QPS from loadbalancer running outside of cluster). Exactly one "target" type should be set.
+     */
     @JsonProperty("targetAverageValue")
     public Quantity getTargetAverageValue() {
         return targetAverageValue;
     }
 
+    /**
+     * ExternalMetricSource indicates how to scale on a metric not associated with any Kubernetes object (for example length of queue in cloud messaging service, or QPS from loadbalancer running outside of cluster). Exactly one "target" type should be set.
+     */
     @JsonProperty("targetAverageValue")
     public void setTargetAverageValue(Quantity targetAverageValue) {
         this.targetAverageValue = targetAverageValue;
     }
 
+    /**
+     * ExternalMetricSource indicates how to scale on a metric not associated with any Kubernetes object (for example length of queue in cloud messaging service, or QPS from loadbalancer running outside of cluster). Exactly one "target" type should be set.
+     */
     @JsonProperty("targetValue")
     public Quantity getTargetValue() {
         return targetValue;
     }
 
+    /**
+     * ExternalMetricSource indicates how to scale on a metric not associated with any Kubernetes object (for example length of queue in cloud messaging service, or QPS from loadbalancer running outside of cluster). Exactly one "target" type should be set.
+     */
     @JsonProperty("targetValue")
     public void setTargetValue(Quantity targetValue) {
         this.targetValue = targetValue;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ExternalMetricStatus.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ExternalMetricStatus.java
index 13bd533ba6d..f565de180a9 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ExternalMetricStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ExternalMetricStatus.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ExternalMetricStatus indicates the current value of a global metric not associated with any Kubernetes object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,41 +94,65 @@ public ExternalMetricStatus(Quantity currentAverageValue, Quantity currentValue,
         this.metricSelector = metricSelector;
     }
 
+    /**
+     * ExternalMetricStatus indicates the current value of a global metric not associated with any Kubernetes object.
+     */
     @JsonProperty("currentAverageValue")
     public Quantity getCurrentAverageValue() {
         return currentAverageValue;
     }
 
+    /**
+     * ExternalMetricStatus indicates the current value of a global metric not associated with any Kubernetes object.
+     */
     @JsonProperty("currentAverageValue")
     public void setCurrentAverageValue(Quantity currentAverageValue) {
         this.currentAverageValue = currentAverageValue;
     }
 
+    /**
+     * ExternalMetricStatus indicates the current value of a global metric not associated with any Kubernetes object.
+     */
     @JsonProperty("currentValue")
     public Quantity getCurrentValue() {
         return currentValue;
     }
 
+    /**
+     * ExternalMetricStatus indicates the current value of a global metric not associated with any Kubernetes object.
+     */
     @JsonProperty("currentValue")
     public void setCurrentValue(Quantity currentValue) {
         this.currentValue = currentValue;
     }
 
+    /**
+     * metricName is the name of a metric used for autoscaling in metric system.
+     */
     @JsonProperty("metricName")
     public String getMetricName() {
         return metricName;
     }
 
+    /**
+     * metricName is the name of a metric used for autoscaling in metric system.
+     */
     @JsonProperty("metricName")
     public void setMetricName(String metricName) {
         this.metricName = metricName;
     }
 
+    /**
+     * ExternalMetricStatus indicates the current value of a global metric not associated with any Kubernetes object.
+     */
     @JsonProperty("metricSelector")
     public LabelSelector getMetricSelector() {
         return metricSelector;
     }
 
+    /**
+     * ExternalMetricStatus indicates the current value of a global metric not associated with any Kubernetes object.
+     */
     @JsonProperty("metricSelector")
     public void setMetricSelector(LabelSelector metricSelector) {
         this.metricSelector = metricSelector;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/HorizontalPodAutoscaler.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/HorizontalPodAutoscaler.java
index 8489677fa7a..9ea03893585 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/HorizontalPodAutoscaler.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/HorizontalPodAutoscaler.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HorizontalPodAutoscaler is the configuration for a horizontal pod autoscaler, which automatically manages the replica count of any resource implementing the scale subresource based on the metrics specified.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class HorizontalPodAutoscaler implements Editable<HorizontalPodAutoscalerBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling/v2beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "HorizontalPodAutoscaler";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public HorizontalPodAutoscaler(String apiVersion, String kind, ObjectMeta metada
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * HorizontalPodAutoscaler is the configuration for a horizontal pod autoscaler, which automatically manages the replica count of any resource implementing the scale subresource based on the metrics specified.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * HorizontalPodAutoscaler is the configuration for a horizontal pod autoscaler, which automatically manages the replica count of any resource implementing the scale subresource based on the metrics specified.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * HorizontalPodAutoscaler is the configuration for a horizontal pod autoscaler, which automatically manages the replica count of any resource implementing the scale subresource based on the metrics specified.
+     */
     @JsonProperty("spec")
     public HorizontalPodAutoscalerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * HorizontalPodAutoscaler is the configuration for a horizontal pod autoscaler, which automatically manages the replica count of any resource implementing the scale subresource based on the metrics specified.
+     */
     @JsonProperty("spec")
     public void setSpec(HorizontalPodAutoscalerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * HorizontalPodAutoscaler is the configuration for a horizontal pod autoscaler, which automatically manages the replica count of any resource implementing the scale subresource based on the metrics specified.
+     */
     @JsonProperty("status")
     public HorizontalPodAutoscalerStatus getStatus() {
         return status;
     }
 
+    /**
+     * HorizontalPodAutoscaler is the configuration for a horizontal pod autoscaler, which automatically manages the replica count of any resource implementing the scale subresource based on the metrics specified.
+     */
     @JsonProperty("status")
     public void setStatus(HorizontalPodAutoscalerStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/HorizontalPodAutoscalerCondition.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/HorizontalPodAutoscalerCondition.java
index bf7e2247c5d..7f62a1c155d 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/HorizontalPodAutoscalerCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/HorizontalPodAutoscalerCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HorizontalPodAutoscalerCondition describes the state of a HorizontalPodAutoscaler at a certain point.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public HorizontalPodAutoscalerCondition(String lastTransitionTime, String messag
         this.type = type;
     }
 
+    /**
+     * HorizontalPodAutoscalerCondition describes the state of a HorizontalPodAutoscaler at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * HorizontalPodAutoscalerCondition describes the state of a HorizontalPodAutoscaler at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * message is a human-readable explanation containing details about the transition
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message is a human-readable explanation containing details about the transition
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * reason is the reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * reason is the reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * status is the status of the condition (True, False, Unknown)
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * status is the status of the condition (True, False, Unknown)
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * type describes the current condition
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type describes the current condition
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/HorizontalPodAutoscalerList.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/HorizontalPodAutoscalerList.java
index 544415b7fb3..9e33d67de80 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/HorizontalPodAutoscalerList.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/HorizontalPodAutoscalerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HorizontalPodAutoscaler is a list of horizontal pod autoscaler objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class HorizontalPodAutoscalerList implements Editable<HorizontalPodAutoscalerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.autoscaling.v2beta1.HorizontalPodAutoscaler>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling/v2beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.autoscaling.v2beta1.HorizontalPodAutoscaler> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "HorizontalPodAutoscalerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public HorizontalPodAutoscalerList(String apiVersion, List<io.fabric8.kubernetes
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of horizontal pod autoscaler objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.autoscaling.v2beta1.HorizontalPodAutoscaler> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of horizontal pod autoscaler objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.autoscaling.v2beta1.HorizontalPodAutoscaler> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * HorizontalPodAutoscaler is a list of horizontal pod autoscaler objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * HorizontalPodAutoscaler is a list of horizontal pod autoscaler objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/HorizontalPodAutoscalerSpec.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/HorizontalPodAutoscalerSpec.java
index 9d00d6f38f1..be1fe6fd9cf 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/HorizontalPodAutoscalerSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/HorizontalPodAutoscalerSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HorizontalPodAutoscalerSpec describes the desired functionality of the HorizontalPodAutoscaler.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public HorizontalPodAutoscalerSpec(Integer maxReplicas, List<MetricSpec> metrics
         this.scaleTargetRef = scaleTargetRef;
     }
 
+    /**
+     * maxReplicas is the upper limit for the number of replicas to which the autoscaler can scale up. It cannot be less that minReplicas.
+     */
     @JsonProperty("maxReplicas")
     public Integer getMaxReplicas() {
         return maxReplicas;
     }
 
+    /**
+     * maxReplicas is the upper limit for the number of replicas to which the autoscaler can scale up. It cannot be less that minReplicas.
+     */
     @JsonProperty("maxReplicas")
     public void setMaxReplicas(Integer maxReplicas) {
         this.maxReplicas = maxReplicas;
     }
 
+    /**
+     * metrics contains the specifications for which to use to calculate the desired replica count (the maximum replica count across all metrics will be used).  The desired replica count is calculated multiplying the ratio between the target value and the current value by the current number of pods.  Ergo, metrics used must decrease as the pod count is increased, and vice-versa.  See the individual metric source types for more information about how each type of metric must respond.
+     */
     @JsonProperty("metrics")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MetricSpec> getMetrics() {
         return metrics;
     }
 
+    /**
+     * metrics contains the specifications for which to use to calculate the desired replica count (the maximum replica count across all metrics will be used).  The desired replica count is calculated multiplying the ratio between the target value and the current value by the current number of pods.  Ergo, metrics used must decrease as the pod count is increased, and vice-versa.  See the individual metric source types for more information about how each type of metric must respond.
+     */
     @JsonProperty("metrics")
     public void setMetrics(List<MetricSpec> metrics) {
         this.metrics = metrics;
     }
 
+    /**
+     * minReplicas is the lower limit for the number of replicas to which the autoscaler can scale down.  It defaults to 1 pod.  minReplicas is allowed to be 0 if the alpha feature gate HPAScaleToZero is enabled and at least one Object or External metric is configured.  Scaling is active as long as at least one metric value is available.
+     */
     @JsonProperty("minReplicas")
     public Integer getMinReplicas() {
         return minReplicas;
     }
 
+    /**
+     * minReplicas is the lower limit for the number of replicas to which the autoscaler can scale down.  It defaults to 1 pod.  minReplicas is allowed to be 0 if the alpha feature gate HPAScaleToZero is enabled and at least one Object or External metric is configured.  Scaling is active as long as at least one metric value is available.
+     */
     @JsonProperty("minReplicas")
     public void setMinReplicas(Integer minReplicas) {
         this.minReplicas = minReplicas;
     }
 
+    /**
+     * HorizontalPodAutoscalerSpec describes the desired functionality of the HorizontalPodAutoscaler.
+     */
     @JsonProperty("scaleTargetRef")
     public CrossVersionObjectReference getScaleTargetRef() {
         return scaleTargetRef;
     }
 
+    /**
+     * HorizontalPodAutoscalerSpec describes the desired functionality of the HorizontalPodAutoscaler.
+     */
     @JsonProperty("scaleTargetRef")
     public void setScaleTargetRef(CrossVersionObjectReference scaleTargetRef) {
         this.scaleTargetRef = scaleTargetRef;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/HorizontalPodAutoscalerStatus.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/HorizontalPodAutoscalerStatus.java
index 9f8477401cf..ea7de8ae14d 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/HorizontalPodAutoscalerStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/HorizontalPodAutoscalerStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HorizontalPodAutoscalerStatus describes the current status of a horizontal pod autoscaler.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,63 +105,99 @@ public HorizontalPodAutoscalerStatus(List<HorizontalPodAutoscalerCondition> cond
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * conditions is the set of conditions required for this autoscaler to scale its target, and indicates whether or not those conditions are met.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HorizontalPodAutoscalerCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is the set of conditions required for this autoscaler to scale its target, and indicates whether or not those conditions are met.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<HorizontalPodAutoscalerCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * currentMetrics is the last read state of the metrics used by this autoscaler.
+     */
     @JsonProperty("currentMetrics")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MetricStatus> getCurrentMetrics() {
         return currentMetrics;
     }
 
+    /**
+     * currentMetrics is the last read state of the metrics used by this autoscaler.
+     */
     @JsonProperty("currentMetrics")
     public void setCurrentMetrics(List<MetricStatus> currentMetrics) {
         this.currentMetrics = currentMetrics;
     }
 
+    /**
+     * currentReplicas is current number of replicas of pods managed by this autoscaler, as last seen by the autoscaler.
+     */
     @JsonProperty("currentReplicas")
     public Integer getCurrentReplicas() {
         return currentReplicas;
     }
 
+    /**
+     * currentReplicas is current number of replicas of pods managed by this autoscaler, as last seen by the autoscaler.
+     */
     @JsonProperty("currentReplicas")
     public void setCurrentReplicas(Integer currentReplicas) {
         this.currentReplicas = currentReplicas;
     }
 
+    /**
+     * desiredReplicas is the desired number of replicas of pods managed by this autoscaler, as last calculated by the autoscaler.
+     */
     @JsonProperty("desiredReplicas")
     public Integer getDesiredReplicas() {
         return desiredReplicas;
     }
 
+    /**
+     * desiredReplicas is the desired number of replicas of pods managed by this autoscaler, as last calculated by the autoscaler.
+     */
     @JsonProperty("desiredReplicas")
     public void setDesiredReplicas(Integer desiredReplicas) {
         this.desiredReplicas = desiredReplicas;
     }
 
+    /**
+     * HorizontalPodAutoscalerStatus describes the current status of a horizontal pod autoscaler.
+     */
     @JsonProperty("lastScaleTime")
     public String getLastScaleTime() {
         return lastScaleTime;
     }
 
+    /**
+     * HorizontalPodAutoscalerStatus describes the current status of a horizontal pod autoscaler.
+     */
     @JsonProperty("lastScaleTime")
     public void setLastScaleTime(String lastScaleTime) {
         this.lastScaleTime = lastScaleTime;
     }
 
+    /**
+     * observedGeneration is the most recent generation observed by this autoscaler.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the most recent generation observed by this autoscaler.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/MetricSpec.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/MetricSpec.java
index 5070cf38b48..ec16cedd74a 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/MetricSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/MetricSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public MetricSpec(ContainerResourceMetricSource containerResource, ExternalMetri
         this.type = type;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("containerResource")
     public ContainerResourceMetricSource getContainerResource() {
         return containerResource;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("containerResource")
     public void setContainerResource(ContainerResourceMetricSource containerResource) {
         this.containerResource = containerResource;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("external")
     public ExternalMetricSource getExternal() {
         return external;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("external")
     public void setExternal(ExternalMetricSource external) {
         this.external = external;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("object")
     public ObjectMetricSource getObject() {
         return object;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("object")
     public void setObject(ObjectMetricSource object) {
         this.object = object;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("pods")
     public PodsMetricSource getPods() {
         return pods;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("pods")
     public void setPods(PodsMetricSource pods) {
         this.pods = pods;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("resource")
     public ResourceMetricSource getResource() {
         return resource;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("resource")
     public void setResource(ResourceMetricSource resource) {
         this.resource = resource;
     }
 
+    /**
+     * type is the type of metric source.  It should be one of "ContainerResource", "External", "Object", "Pods" or "Resource", each mapping to a matching field in the object. Note: "ContainerResource" type is available on when the feature-gate HPAContainerMetrics is enabled
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the type of metric source.  It should be one of "ContainerResource", "External", "Object", "Pods" or "Resource", each mapping to a matching field in the object. Note: "ContainerResource" type is available on when the feature-gate HPAContainerMetrics is enabled
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/MetricStatus.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/MetricStatus.java
index c0d96ec7171..6d70f0b1853 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/MetricStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/MetricStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MetricStatus describes the last-read state of a single metric.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public MetricStatus(ContainerResourceMetricStatus containerResource, ExternalMet
         this.type = type;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("containerResource")
     public ContainerResourceMetricStatus getContainerResource() {
         return containerResource;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("containerResource")
     public void setContainerResource(ContainerResourceMetricStatus containerResource) {
         this.containerResource = containerResource;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("external")
     public ExternalMetricStatus getExternal() {
         return external;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("external")
     public void setExternal(ExternalMetricStatus external) {
         this.external = external;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("object")
     public ObjectMetricStatus getObject() {
         return object;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("object")
     public void setObject(ObjectMetricStatus object) {
         this.object = object;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("pods")
     public PodsMetricStatus getPods() {
         return pods;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("pods")
     public void setPods(PodsMetricStatus pods) {
         this.pods = pods;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("resource")
     public ResourceMetricStatus getResource() {
         return resource;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("resource")
     public void setResource(ResourceMetricStatus resource) {
         this.resource = resource;
     }
 
+    /**
+     * type is the type of metric source.  It will be one of "ContainerResource", "External", "Object", "Pods" or "Resource", each corresponds to a matching field in the object. Note: "ContainerResource" type is available on when the feature-gate HPAContainerMetrics is enabled
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the type of metric source.  It will be one of "ContainerResource", "External", "Object", "Pods" or "Resource", each corresponds to a matching field in the object. Note: "ContainerResource" type is available on when the feature-gate HPAContainerMetrics is enabled
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ObjectMetricSource.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ObjectMetricSource.java
index 9450ab2cad6..5fc85a203cd 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ObjectMetricSource.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ObjectMetricSource.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ObjectMetricSource indicates how to scale on a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,51 +98,81 @@ public ObjectMetricSource(Quantity averageValue, String metricName, LabelSelecto
         this.targetValue = targetValue;
     }
 
+    /**
+     * ObjectMetricSource indicates how to scale on a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("averageValue")
     public Quantity getAverageValue() {
         return averageValue;
     }
 
+    /**
+     * ObjectMetricSource indicates how to scale on a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("averageValue")
     public void setAverageValue(Quantity averageValue) {
         this.averageValue = averageValue;
     }
 
+    /**
+     * metricName is the name of the metric in question.
+     */
     @JsonProperty("metricName")
     public String getMetricName() {
         return metricName;
     }
 
+    /**
+     * metricName is the name of the metric in question.
+     */
     @JsonProperty("metricName")
     public void setMetricName(String metricName) {
         this.metricName = metricName;
     }
 
+    /**
+     * ObjectMetricSource indicates how to scale on a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * ObjectMetricSource indicates how to scale on a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * ObjectMetricSource indicates how to scale on a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("target")
     public CrossVersionObjectReference getTarget() {
         return target;
     }
 
+    /**
+     * ObjectMetricSource indicates how to scale on a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("target")
     public void setTarget(CrossVersionObjectReference target) {
         this.target = target;
     }
 
+    /**
+     * ObjectMetricSource indicates how to scale on a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("targetValue")
     public Quantity getTargetValue() {
         return targetValue;
     }
 
+    /**
+     * ObjectMetricSource indicates how to scale on a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("targetValue")
     public void setTargetValue(Quantity targetValue) {
         this.targetValue = targetValue;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ObjectMetricStatus.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ObjectMetricStatus.java
index d5dc20f3cc7..3ca994be7e4 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ObjectMetricStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ObjectMetricStatus.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ObjectMetricStatus indicates the current value of a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,51 +98,81 @@ public ObjectMetricStatus(Quantity averageValue, Quantity currentValue, String m
         this.target = target;
     }
 
+    /**
+     * ObjectMetricStatus indicates the current value of a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("averageValue")
     public Quantity getAverageValue() {
         return averageValue;
     }
 
+    /**
+     * ObjectMetricStatus indicates the current value of a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("averageValue")
     public void setAverageValue(Quantity averageValue) {
         this.averageValue = averageValue;
     }
 
+    /**
+     * ObjectMetricStatus indicates the current value of a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("currentValue")
     public Quantity getCurrentValue() {
         return currentValue;
     }
 
+    /**
+     * ObjectMetricStatus indicates the current value of a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("currentValue")
     public void setCurrentValue(Quantity currentValue) {
         this.currentValue = currentValue;
     }
 
+    /**
+     * metricName is the name of the metric in question.
+     */
     @JsonProperty("metricName")
     public String getMetricName() {
         return metricName;
     }
 
+    /**
+     * metricName is the name of the metric in question.
+     */
     @JsonProperty("metricName")
     public void setMetricName(String metricName) {
         this.metricName = metricName;
     }
 
+    /**
+     * ObjectMetricStatus indicates the current value of a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * ObjectMetricStatus indicates the current value of a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * ObjectMetricStatus indicates the current value of a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("target")
     public CrossVersionObjectReference getTarget() {
         return target;
     }
 
+    /**
+     * ObjectMetricStatus indicates the current value of a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("target")
     public void setTarget(CrossVersionObjectReference target) {
         this.target = target;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/PodsMetricSource.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/PodsMetricSource.java
index a189a92bf4c..48a71fda7a8 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/PodsMetricSource.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/PodsMetricSource.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodsMetricSource indicates how to scale on a metric describing each pod in the current scale target (for example, transactions-processed-per-second). The values will be averaged together before being compared to the target value.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,31 +90,49 @@ public PodsMetricSource(String metricName, LabelSelector selector, Quantity targ
         this.targetAverageValue = targetAverageValue;
     }
 
+    /**
+     * metricName is the name of the metric in question
+     */
     @JsonProperty("metricName")
     public String getMetricName() {
         return metricName;
     }
 
+    /**
+     * metricName is the name of the metric in question
+     */
     @JsonProperty("metricName")
     public void setMetricName(String metricName) {
         this.metricName = metricName;
     }
 
+    /**
+     * PodsMetricSource indicates how to scale on a metric describing each pod in the current scale target (for example, transactions-processed-per-second). The values will be averaged together before being compared to the target value.
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * PodsMetricSource indicates how to scale on a metric describing each pod in the current scale target (for example, transactions-processed-per-second). The values will be averaged together before being compared to the target value.
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * PodsMetricSource indicates how to scale on a metric describing each pod in the current scale target (for example, transactions-processed-per-second). The values will be averaged together before being compared to the target value.
+     */
     @JsonProperty("targetAverageValue")
     public Quantity getTargetAverageValue() {
         return targetAverageValue;
     }
 
+    /**
+     * PodsMetricSource indicates how to scale on a metric describing each pod in the current scale target (for example, transactions-processed-per-second). The values will be averaged together before being compared to the target value.
+     */
     @JsonProperty("targetAverageValue")
     public void setTargetAverageValue(Quantity targetAverageValue) {
         this.targetAverageValue = targetAverageValue;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/PodsMetricStatus.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/PodsMetricStatus.java
index 6c377d6a6c1..afa8eef7d91 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/PodsMetricStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/PodsMetricStatus.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodsMetricStatus indicates the current value of a metric describing each pod in the current scale target (for example, transactions-processed-per-second).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,31 +90,49 @@ public PodsMetricStatus(Quantity currentAverageValue, String metricName, LabelSe
         this.selector = selector;
     }
 
+    /**
+     * PodsMetricStatus indicates the current value of a metric describing each pod in the current scale target (for example, transactions-processed-per-second).
+     */
     @JsonProperty("currentAverageValue")
     public Quantity getCurrentAverageValue() {
         return currentAverageValue;
     }
 
+    /**
+     * PodsMetricStatus indicates the current value of a metric describing each pod in the current scale target (for example, transactions-processed-per-second).
+     */
     @JsonProperty("currentAverageValue")
     public void setCurrentAverageValue(Quantity currentAverageValue) {
         this.currentAverageValue = currentAverageValue;
     }
 
+    /**
+     * metricName is the name of the metric in question
+     */
     @JsonProperty("metricName")
     public String getMetricName() {
         return metricName;
     }
 
+    /**
+     * metricName is the name of the metric in question
+     */
     @JsonProperty("metricName")
     public void setMetricName(String metricName) {
         this.metricName = metricName;
     }
 
+    /**
+     * PodsMetricStatus indicates the current value of a metric describing each pod in the current scale target (for example, transactions-processed-per-second).
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * PodsMetricStatus indicates the current value of a metric describing each pod in the current scale target (for example, transactions-processed-per-second).
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ResourceMetricSource.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ResourceMetricSource.java
index efa1b7f20fe..9ae8a3e6f92 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ResourceMetricSource.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ResourceMetricSource.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceMetricSource indicates how to scale on a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory).  The values will be averaged together before being compared to the target.  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.  Only one "target" type should be set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,31 +90,49 @@ public ResourceMetricSource(String name, Integer targetAverageUtilization, Quant
         this.targetAverageValue = targetAverageValue;
     }
 
+    /**
+     * name is the name of the resource in question.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the resource in question.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * targetAverageUtilization is the target value of the average of the resource metric across all relevant pods, represented as a percentage of the requested value of the resource for the pods.
+     */
     @JsonProperty("targetAverageUtilization")
     public Integer getTargetAverageUtilization() {
         return targetAverageUtilization;
     }
 
+    /**
+     * targetAverageUtilization is the target value of the average of the resource metric across all relevant pods, represented as a percentage of the requested value of the resource for the pods.
+     */
     @JsonProperty("targetAverageUtilization")
     public void setTargetAverageUtilization(Integer targetAverageUtilization) {
         this.targetAverageUtilization = targetAverageUtilization;
     }
 
+    /**
+     * ResourceMetricSource indicates how to scale on a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory).  The values will be averaged together before being compared to the target.  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.  Only one "target" type should be set.
+     */
     @JsonProperty("targetAverageValue")
     public Quantity getTargetAverageValue() {
         return targetAverageValue;
     }
 
+    /**
+     * ResourceMetricSource indicates how to scale on a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory).  The values will be averaged together before being compared to the target.  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.  Only one "target" type should be set.
+     */
     @JsonProperty("targetAverageValue")
     public void setTargetAverageValue(Quantity targetAverageValue) {
         this.targetAverageValue = targetAverageValue;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ResourceMetricStatus.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ResourceMetricStatus.java
index 0b5fea8e299..03730ee4c52 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ResourceMetricStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta1/ResourceMetricStatus.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceMetricStatus indicates the current value of a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory).  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,31 +90,49 @@ public ResourceMetricStatus(Integer currentAverageUtilization, Quantity currentA
         this.name = name;
     }
 
+    /**
+     * currentAverageUtilization is the current value of the average of the resource metric across all relevant pods, represented as a percentage of the requested value of the resource for the pods.  It will only be present if `targetAverageValue` was set in the corresponding metric specification.
+     */
     @JsonProperty("currentAverageUtilization")
     public Integer getCurrentAverageUtilization() {
         return currentAverageUtilization;
     }
 
+    /**
+     * currentAverageUtilization is the current value of the average of the resource metric across all relevant pods, represented as a percentage of the requested value of the resource for the pods.  It will only be present if `targetAverageValue` was set in the corresponding metric specification.
+     */
     @JsonProperty("currentAverageUtilization")
     public void setCurrentAverageUtilization(Integer currentAverageUtilization) {
         this.currentAverageUtilization = currentAverageUtilization;
     }
 
+    /**
+     * ResourceMetricStatus indicates the current value of a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory).  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.
+     */
     @JsonProperty("currentAverageValue")
     public Quantity getCurrentAverageValue() {
         return currentAverageValue;
     }
 
+    /**
+     * ResourceMetricStatus indicates the current value of a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory).  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.
+     */
     @JsonProperty("currentAverageValue")
     public void setCurrentAverageValue(Quantity currentAverageValue) {
         this.currentAverageValue = currentAverageValue;
     }
 
+    /**
+     * name is the name of the resource in question.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the resource in question.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ContainerResourceMetricSource.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ContainerResourceMetricSource.java
index 25291a8aba0..f1fdb5f1734 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ContainerResourceMetricSource.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ContainerResourceMetricSource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerResourceMetricSource indicates how to scale on a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory).  The values will be averaged together before being compared to the target.  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.  Only one "target" type should be set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ContainerResourceMetricSource(String container, String name, MetricTarget
         this.target = target;
     }
 
+    /**
+     * container is the name of the container in the pods of the scaling target
+     */
     @JsonProperty("container")
     public String getContainer() {
         return container;
     }
 
+    /**
+     * container is the name of the container in the pods of the scaling target
+     */
     @JsonProperty("container")
     public void setContainer(String container) {
         this.container = container;
     }
 
+    /**
+     * name is the name of the resource in question.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the resource in question.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * ContainerResourceMetricSource indicates how to scale on a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory).  The values will be averaged together before being compared to the target.  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.  Only one "target" type should be set.
+     */
     @JsonProperty("target")
     public MetricTarget getTarget() {
         return target;
     }
 
+    /**
+     * ContainerResourceMetricSource indicates how to scale on a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory).  The values will be averaged together before being compared to the target.  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.  Only one "target" type should be set.
+     */
     @JsonProperty("target")
     public void setTarget(MetricTarget target) {
         this.target = target;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ContainerResourceMetricStatus.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ContainerResourceMetricStatus.java
index 1916b81b365..a5003dbe428 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ContainerResourceMetricStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ContainerResourceMetricStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerResourceMetricStatus indicates the current value of a resource metric known to Kubernetes, as specified in requests and limits, describing a single container in each pod in the current scale target (e.g. CPU or memory).  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ContainerResourceMetricStatus(String container, MetricValueStatus current
         this.name = name;
     }
 
+    /**
+     * Container is the name of the container in the pods of the scaling target
+     */
     @JsonProperty("container")
     public String getContainer() {
         return container;
     }
 
+    /**
+     * Container is the name of the container in the pods of the scaling target
+     */
     @JsonProperty("container")
     public void setContainer(String container) {
         this.container = container;
     }
 
+    /**
+     * ContainerResourceMetricStatus indicates the current value of a resource metric known to Kubernetes, as specified in requests and limits, describing a single container in each pod in the current scale target (e.g. CPU or memory).  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.
+     */
     @JsonProperty("current")
     public MetricValueStatus getCurrent() {
         return current;
     }
 
+    /**
+     * ContainerResourceMetricStatus indicates the current value of a resource metric known to Kubernetes, as specified in requests and limits, describing a single container in each pod in the current scale target (e.g. CPU or memory).  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.
+     */
     @JsonProperty("current")
     public void setCurrent(MetricValueStatus current) {
         this.current = current;
     }
 
+    /**
+     * Name is the name of the resource in question.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the resource in question.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/CrossVersionObjectReference.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/CrossVersionObjectReference.java
index 982300a6be5..da0cb941b09 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/CrossVersionObjectReference.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/CrossVersionObjectReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CrossVersionObjectReference contains enough information to let you identify the referred resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public CrossVersionObjectReference(String apiVersion, String kind, String name)
         this.name = name;
     }
 
+    /**
+     * API version of the referent
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * API version of the referent
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Kind of the referent; More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds"
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind of the referent; More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds"
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name of the referent; More info: http://kubernetes.io/docs/user-guide/identifiers#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referent; More info: http://kubernetes.io/docs/user-guide/identifiers#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ExternalMetricSource.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ExternalMetricSource.java
index 743474517d2..095294f566d 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ExternalMetricSource.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ExternalMetricSource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ExternalMetricSource indicates how to scale on a metric not associated with any Kubernetes object (for example length of queue in cloud messaging service, or QPS from loadbalancer running outside of cluster).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ExternalMetricSource(MetricIdentifier metric, MetricTarget target) {
         this.target = target;
     }
 
+    /**
+     * ExternalMetricSource indicates how to scale on a metric not associated with any Kubernetes object (for example length of queue in cloud messaging service, or QPS from loadbalancer running outside of cluster).
+     */
     @JsonProperty("metric")
     public MetricIdentifier getMetric() {
         return metric;
     }
 
+    /**
+     * ExternalMetricSource indicates how to scale on a metric not associated with any Kubernetes object (for example length of queue in cloud messaging service, or QPS from loadbalancer running outside of cluster).
+     */
     @JsonProperty("metric")
     public void setMetric(MetricIdentifier metric) {
         this.metric = metric;
     }
 
+    /**
+     * ExternalMetricSource indicates how to scale on a metric not associated with any Kubernetes object (for example length of queue in cloud messaging service, or QPS from loadbalancer running outside of cluster).
+     */
     @JsonProperty("target")
     public MetricTarget getTarget() {
         return target;
     }
 
+    /**
+     * ExternalMetricSource indicates how to scale on a metric not associated with any Kubernetes object (for example length of queue in cloud messaging service, or QPS from loadbalancer running outside of cluster).
+     */
     @JsonProperty("target")
     public void setTarget(MetricTarget target) {
         this.target = target;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ExternalMetricStatus.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ExternalMetricStatus.java
index cdb2f6daa8b..b9a7fe4616f 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ExternalMetricStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ExternalMetricStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ExternalMetricStatus indicates the current value of a global metric not associated with any Kubernetes object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ExternalMetricStatus(MetricValueStatus current, MetricIdentifier metric)
         this.metric = metric;
     }
 
+    /**
+     * ExternalMetricStatus indicates the current value of a global metric not associated with any Kubernetes object.
+     */
     @JsonProperty("current")
     public MetricValueStatus getCurrent() {
         return current;
     }
 
+    /**
+     * ExternalMetricStatus indicates the current value of a global metric not associated with any Kubernetes object.
+     */
     @JsonProperty("current")
     public void setCurrent(MetricValueStatus current) {
         this.current = current;
     }
 
+    /**
+     * ExternalMetricStatus indicates the current value of a global metric not associated with any Kubernetes object.
+     */
     @JsonProperty("metric")
     public MetricIdentifier getMetric() {
         return metric;
     }
 
+    /**
+     * ExternalMetricStatus indicates the current value of a global metric not associated with any Kubernetes object.
+     */
     @JsonProperty("metric")
     public void setMetric(MetricIdentifier metric) {
         this.metric = metric;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HPAScalingPolicy.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HPAScalingPolicy.java
index aa7c608e9b5..dcc4fa2f986 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HPAScalingPolicy.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HPAScalingPolicy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HPAScalingPolicy is a single policy which must hold true for a specified past interval.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public HPAScalingPolicy(Integer periodSeconds, String type, Integer value) {
         this.value = value;
     }
 
+    /**
+     * PeriodSeconds specifies the window of time for which the policy should hold true. PeriodSeconds must be greater than zero and less than or equal to 1800 (30 min).
+     */
     @JsonProperty("periodSeconds")
     public Integer getPeriodSeconds() {
         return periodSeconds;
     }
 
+    /**
+     * PeriodSeconds specifies the window of time for which the policy should hold true. PeriodSeconds must be greater than zero and less than or equal to 1800 (30 min).
+     */
     @JsonProperty("periodSeconds")
     public void setPeriodSeconds(Integer periodSeconds) {
         this.periodSeconds = periodSeconds;
     }
 
+    /**
+     * Type is used to specify the scaling policy.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is used to specify the scaling policy.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * Value contains the amount of change which is permitted by the policy. It must be greater than zero
+     */
     @JsonProperty("value")
     public Integer getValue() {
         return value;
     }
 
+    /**
+     * Value contains the amount of change which is permitted by the policy. It must be greater than zero
+     */
     @JsonProperty("value")
     public void setValue(Integer value) {
         this.value = value;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HPAScalingRules.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HPAScalingRules.java
index 2b6eb413576..0bdecb773b4 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HPAScalingRules.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HPAScalingRules.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HPAScalingRules configures the scaling behavior for one direction. These Rules are applied after calculating DesiredReplicas from metrics for the HPA. They can limit the scaling velocity by specifying scaling policies. They can prevent flapping by specifying the stabilization window, so that the number of replicas is not set instantly, instead, the safest value from the stabilization window is chosen.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public HPAScalingRules(List<HPAScalingPolicy> policies, String selectPolicy, Int
         this.stabilizationWindowSeconds = stabilizationWindowSeconds;
     }
 
+    /**
+     * policies is a list of potential scaling polices which can be used during scaling. At least one policy must be specified, otherwise the HPAScalingRules will be discarded as invalid
+     */
     @JsonProperty("policies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HPAScalingPolicy> getPolicies() {
         return policies;
     }
 
+    /**
+     * policies is a list of potential scaling polices which can be used during scaling. At least one policy must be specified, otherwise the HPAScalingRules will be discarded as invalid
+     */
     @JsonProperty("policies")
     public void setPolicies(List<HPAScalingPolicy> policies) {
         this.policies = policies;
     }
 
+    /**
+     * selectPolicy is used to specify which policy should be used. If not set, the default value MaxPolicySelect is used.
+     */
     @JsonProperty("selectPolicy")
     public String getSelectPolicy() {
         return selectPolicy;
     }
 
+    /**
+     * selectPolicy is used to specify which policy should be used. If not set, the default value MaxPolicySelect is used.
+     */
     @JsonProperty("selectPolicy")
     public void setSelectPolicy(String selectPolicy) {
         this.selectPolicy = selectPolicy;
     }
 
+    /**
+     * StabilizationWindowSeconds is the number of seconds for which past recommendations should be considered while scaling up or scaling down. StabilizationWindowSeconds must be greater than or equal to zero and less than or equal to 3600 (one hour). If not set, use the default values: - For scale up: 0 (i.e. no stabilization is done). - For scale down: 300 (i.e. the stabilization window is 300 seconds long).
+     */
     @JsonProperty("stabilizationWindowSeconds")
     public Integer getStabilizationWindowSeconds() {
         return stabilizationWindowSeconds;
     }
 
+    /**
+     * StabilizationWindowSeconds is the number of seconds for which past recommendations should be considered while scaling up or scaling down. StabilizationWindowSeconds must be greater than or equal to zero and less than or equal to 3600 (one hour). If not set, use the default values: - For scale up: 0 (i.e. no stabilization is done). - For scale down: 300 (i.e. the stabilization window is 300 seconds long).
+     */
     @JsonProperty("stabilizationWindowSeconds")
     public void setStabilizationWindowSeconds(Integer stabilizationWindowSeconds) {
         this.stabilizationWindowSeconds = stabilizationWindowSeconds;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HorizontalPodAutoscaler.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HorizontalPodAutoscaler.java
index 1e67b015190..a16f6997e35 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HorizontalPodAutoscaler.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HorizontalPodAutoscaler.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HorizontalPodAutoscaler is the configuration for a horizontal pod autoscaler, which automatically manages the replica count of any resource implementing the scale subresource based on the metrics specified.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class HorizontalPodAutoscaler implements Editable<HorizontalPodAutoscalerBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling/v2beta2";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "HorizontalPodAutoscaler";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public HorizontalPodAutoscaler(String apiVersion, String kind, ObjectMeta metada
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * HorizontalPodAutoscaler is the configuration for a horizontal pod autoscaler, which automatically manages the replica count of any resource implementing the scale subresource based on the metrics specified.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * HorizontalPodAutoscaler is the configuration for a horizontal pod autoscaler, which automatically manages the replica count of any resource implementing the scale subresource based on the metrics specified.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * HorizontalPodAutoscaler is the configuration for a horizontal pod autoscaler, which automatically manages the replica count of any resource implementing the scale subresource based on the metrics specified.
+     */
     @JsonProperty("spec")
     public HorizontalPodAutoscalerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * HorizontalPodAutoscaler is the configuration for a horizontal pod autoscaler, which automatically manages the replica count of any resource implementing the scale subresource based on the metrics specified.
+     */
     @JsonProperty("spec")
     public void setSpec(HorizontalPodAutoscalerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * HorizontalPodAutoscaler is the configuration for a horizontal pod autoscaler, which automatically manages the replica count of any resource implementing the scale subresource based on the metrics specified.
+     */
     @JsonProperty("status")
     public HorizontalPodAutoscalerStatus getStatus() {
         return status;
     }
 
+    /**
+     * HorizontalPodAutoscaler is the configuration for a horizontal pod autoscaler, which automatically manages the replica count of any resource implementing the scale subresource based on the metrics specified.
+     */
     @JsonProperty("status")
     public void setStatus(HorizontalPodAutoscalerStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HorizontalPodAutoscalerBehavior.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HorizontalPodAutoscalerBehavior.java
index 4fca77b1420..f592f132c6f 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HorizontalPodAutoscalerBehavior.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HorizontalPodAutoscalerBehavior.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HorizontalPodAutoscalerBehavior configures the scaling behavior of the target in both Up and Down directions (scaleUp and scaleDown fields respectively).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public HorizontalPodAutoscalerBehavior(HPAScalingRules scaleDown, HPAScalingRule
         this.scaleUp = scaleUp;
     }
 
+    /**
+     * HorizontalPodAutoscalerBehavior configures the scaling behavior of the target in both Up and Down directions (scaleUp and scaleDown fields respectively).
+     */
     @JsonProperty("scaleDown")
     public HPAScalingRules getScaleDown() {
         return scaleDown;
     }
 
+    /**
+     * HorizontalPodAutoscalerBehavior configures the scaling behavior of the target in both Up and Down directions (scaleUp and scaleDown fields respectively).
+     */
     @JsonProperty("scaleDown")
     public void setScaleDown(HPAScalingRules scaleDown) {
         this.scaleDown = scaleDown;
     }
 
+    /**
+     * HorizontalPodAutoscalerBehavior configures the scaling behavior of the target in both Up and Down directions (scaleUp and scaleDown fields respectively).
+     */
     @JsonProperty("scaleUp")
     public HPAScalingRules getScaleUp() {
         return scaleUp;
     }
 
+    /**
+     * HorizontalPodAutoscalerBehavior configures the scaling behavior of the target in both Up and Down directions (scaleUp and scaleDown fields respectively).
+     */
     @JsonProperty("scaleUp")
     public void setScaleUp(HPAScalingRules scaleUp) {
         this.scaleUp = scaleUp;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HorizontalPodAutoscalerCondition.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HorizontalPodAutoscalerCondition.java
index bd3a7c4b282..7012fb9d644 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HorizontalPodAutoscalerCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HorizontalPodAutoscalerCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HorizontalPodAutoscalerCondition describes the state of a HorizontalPodAutoscaler at a certain point.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public HorizontalPodAutoscalerCondition(String lastTransitionTime, String messag
         this.type = type;
     }
 
+    /**
+     * HorizontalPodAutoscalerCondition describes the state of a HorizontalPodAutoscaler at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * HorizontalPodAutoscalerCondition describes the state of a HorizontalPodAutoscaler at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * message is a human-readable explanation containing details about the transition
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message is a human-readable explanation containing details about the transition
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * reason is the reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * reason is the reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * status is the status of the condition (True, False, Unknown)
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * status is the status of the condition (True, False, Unknown)
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * type describes the current condition
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type describes the current condition
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HorizontalPodAutoscalerList.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HorizontalPodAutoscalerList.java
index 720e02bf523..155d2a3bf5f 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HorizontalPodAutoscalerList.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HorizontalPodAutoscalerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HorizontalPodAutoscalerList is a list of horizontal pod autoscaler objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class HorizontalPodAutoscalerList implements Editable<HorizontalPodAutoscalerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.autoscaling.v2beta2.HorizontalPodAutoscaler>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling/v2beta2";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.autoscaling.v2beta2.HorizontalPodAutoscaler> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "HorizontalPodAutoscalerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public HorizontalPodAutoscalerList(String apiVersion, List<io.fabric8.kubernetes
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of horizontal pod autoscaler objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.autoscaling.v2beta2.HorizontalPodAutoscaler> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of horizontal pod autoscaler objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.autoscaling.v2beta2.HorizontalPodAutoscaler> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * HorizontalPodAutoscalerList is a list of horizontal pod autoscaler objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * HorizontalPodAutoscalerList is a list of horizontal pod autoscaler objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HorizontalPodAutoscalerSpec.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HorizontalPodAutoscalerSpec.java
index eecafc8acfe..cebac6035a5 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HorizontalPodAutoscalerSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HorizontalPodAutoscalerSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HorizontalPodAutoscalerSpec describes the desired functionality of the HorizontalPodAutoscaler.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -97,52 +100,82 @@ public HorizontalPodAutoscalerSpec(HorizontalPodAutoscalerBehavior behavior, Int
         this.scaleTargetRef = scaleTargetRef;
     }
 
+    /**
+     * HorizontalPodAutoscalerSpec describes the desired functionality of the HorizontalPodAutoscaler.
+     */
     @JsonProperty("behavior")
     public HorizontalPodAutoscalerBehavior getBehavior() {
         return behavior;
     }
 
+    /**
+     * HorizontalPodAutoscalerSpec describes the desired functionality of the HorizontalPodAutoscaler.
+     */
     @JsonProperty("behavior")
     public void setBehavior(HorizontalPodAutoscalerBehavior behavior) {
         this.behavior = behavior;
     }
 
+    /**
+     * maxReplicas is the upper limit for the number of replicas to which the autoscaler can scale up. It cannot be less that minReplicas.
+     */
     @JsonProperty("maxReplicas")
     public Integer getMaxReplicas() {
         return maxReplicas;
     }
 
+    /**
+     * maxReplicas is the upper limit for the number of replicas to which the autoscaler can scale up. It cannot be less that minReplicas.
+     */
     @JsonProperty("maxReplicas")
     public void setMaxReplicas(Integer maxReplicas) {
         this.maxReplicas = maxReplicas;
     }
 
+    /**
+     * metrics contains the specifications for which to use to calculate the desired replica count (the maximum replica count across all metrics will be used).  The desired replica count is calculated multiplying the ratio between the target value and the current value by the current number of pods.  Ergo, metrics used must decrease as the pod count is increased, and vice-versa.  See the individual metric source types for more information about how each type of metric must respond. If not set, the default metric will be set to 80% average CPU utilization.
+     */
     @JsonProperty("metrics")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MetricSpec> getMetrics() {
         return metrics;
     }
 
+    /**
+     * metrics contains the specifications for which to use to calculate the desired replica count (the maximum replica count across all metrics will be used).  The desired replica count is calculated multiplying the ratio between the target value and the current value by the current number of pods.  Ergo, metrics used must decrease as the pod count is increased, and vice-versa.  See the individual metric source types for more information about how each type of metric must respond. If not set, the default metric will be set to 80% average CPU utilization.
+     */
     @JsonProperty("metrics")
     public void setMetrics(List<MetricSpec> metrics) {
         this.metrics = metrics;
     }
 
+    /**
+     * minReplicas is the lower limit for the number of replicas to which the autoscaler can scale down.  It defaults to 1 pod.  minReplicas is allowed to be 0 if the alpha feature gate HPAScaleToZero is enabled and at least one Object or External metric is configured.  Scaling is active as long as at least one metric value is available.
+     */
     @JsonProperty("minReplicas")
     public Integer getMinReplicas() {
         return minReplicas;
     }
 
+    /**
+     * minReplicas is the lower limit for the number of replicas to which the autoscaler can scale down.  It defaults to 1 pod.  minReplicas is allowed to be 0 if the alpha feature gate HPAScaleToZero is enabled and at least one Object or External metric is configured.  Scaling is active as long as at least one metric value is available.
+     */
     @JsonProperty("minReplicas")
     public void setMinReplicas(Integer minReplicas) {
         this.minReplicas = minReplicas;
     }
 
+    /**
+     * HorizontalPodAutoscalerSpec describes the desired functionality of the HorizontalPodAutoscaler.
+     */
     @JsonProperty("scaleTargetRef")
     public CrossVersionObjectReference getScaleTargetRef() {
         return scaleTargetRef;
     }
 
+    /**
+     * HorizontalPodAutoscalerSpec describes the desired functionality of the HorizontalPodAutoscaler.
+     */
     @JsonProperty("scaleTargetRef")
     public void setScaleTargetRef(CrossVersionObjectReference scaleTargetRef) {
         this.scaleTargetRef = scaleTargetRef;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HorizontalPodAutoscalerStatus.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HorizontalPodAutoscalerStatus.java
index 919100c09a0..7f64cdbcb39 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HorizontalPodAutoscalerStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/HorizontalPodAutoscalerStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HorizontalPodAutoscalerStatus describes the current status of a horizontal pod autoscaler.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,63 +105,99 @@ public HorizontalPodAutoscalerStatus(List<HorizontalPodAutoscalerCondition> cond
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * conditions is the set of conditions required for this autoscaler to scale its target, and indicates whether or not those conditions are met.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HorizontalPodAutoscalerCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is the set of conditions required for this autoscaler to scale its target, and indicates whether or not those conditions are met.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<HorizontalPodAutoscalerCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * currentMetrics is the last read state of the metrics used by this autoscaler.
+     */
     @JsonProperty("currentMetrics")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MetricStatus> getCurrentMetrics() {
         return currentMetrics;
     }
 
+    /**
+     * currentMetrics is the last read state of the metrics used by this autoscaler.
+     */
     @JsonProperty("currentMetrics")
     public void setCurrentMetrics(List<MetricStatus> currentMetrics) {
         this.currentMetrics = currentMetrics;
     }
 
+    /**
+     * currentReplicas is current number of replicas of pods managed by this autoscaler, as last seen by the autoscaler.
+     */
     @JsonProperty("currentReplicas")
     public Integer getCurrentReplicas() {
         return currentReplicas;
     }
 
+    /**
+     * currentReplicas is current number of replicas of pods managed by this autoscaler, as last seen by the autoscaler.
+     */
     @JsonProperty("currentReplicas")
     public void setCurrentReplicas(Integer currentReplicas) {
         this.currentReplicas = currentReplicas;
     }
 
+    /**
+     * desiredReplicas is the desired number of replicas of pods managed by this autoscaler, as last calculated by the autoscaler.
+     */
     @JsonProperty("desiredReplicas")
     public Integer getDesiredReplicas() {
         return desiredReplicas;
     }
 
+    /**
+     * desiredReplicas is the desired number of replicas of pods managed by this autoscaler, as last calculated by the autoscaler.
+     */
     @JsonProperty("desiredReplicas")
     public void setDesiredReplicas(Integer desiredReplicas) {
         this.desiredReplicas = desiredReplicas;
     }
 
+    /**
+     * HorizontalPodAutoscalerStatus describes the current status of a horizontal pod autoscaler.
+     */
     @JsonProperty("lastScaleTime")
     public String getLastScaleTime() {
         return lastScaleTime;
     }
 
+    /**
+     * HorizontalPodAutoscalerStatus describes the current status of a horizontal pod autoscaler.
+     */
     @JsonProperty("lastScaleTime")
     public void setLastScaleTime(String lastScaleTime) {
         this.lastScaleTime = lastScaleTime;
     }
 
+    /**
+     * observedGeneration is the most recent generation observed by this autoscaler.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the most recent generation observed by this autoscaler.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/MetricIdentifier.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/MetricIdentifier.java
index 92b5740594f..7ed028c8c6c 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/MetricIdentifier.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/MetricIdentifier.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MetricIdentifier defines the name and optionally selector for a metric
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public MetricIdentifier(String name, LabelSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * name is the name of the given metric
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the given metric
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * MetricIdentifier defines the name and optionally selector for a metric
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * MetricIdentifier defines the name and optionally selector for a metric
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/MetricSpec.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/MetricSpec.java
index 3a79e1dbb42..ebf28e8690f 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/MetricSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/MetricSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public MetricSpec(ContainerResourceMetricSource containerResource, ExternalMetri
         this.type = type;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("containerResource")
     public ContainerResourceMetricSource getContainerResource() {
         return containerResource;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("containerResource")
     public void setContainerResource(ContainerResourceMetricSource containerResource) {
         this.containerResource = containerResource;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("external")
     public ExternalMetricSource getExternal() {
         return external;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("external")
     public void setExternal(ExternalMetricSource external) {
         this.external = external;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("object")
     public ObjectMetricSource getObject() {
         return object;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("object")
     public void setObject(ObjectMetricSource object) {
         this.object = object;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("pods")
     public PodsMetricSource getPods() {
         return pods;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("pods")
     public void setPods(PodsMetricSource pods) {
         this.pods = pods;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("resource")
     public ResourceMetricSource getResource() {
         return resource;
     }
 
+    /**
+     * MetricSpec specifies how to scale based on a single metric (only `type` and one other matching field should be set at once).
+     */
     @JsonProperty("resource")
     public void setResource(ResourceMetricSource resource) {
         this.resource = resource;
     }
 
+    /**
+     * type is the type of metric source.  It should be one of "ContainerResource", "External", "Object", "Pods" or "Resource", each mapping to a matching field in the object. Note: "ContainerResource" type is available on when the feature-gate HPAContainerMetrics is enabled
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the type of metric source.  It should be one of "ContainerResource", "External", "Object", "Pods" or "Resource", each mapping to a matching field in the object. Note: "ContainerResource" type is available on when the feature-gate HPAContainerMetrics is enabled
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/MetricStatus.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/MetricStatus.java
index 1c3323c67ef..9c40869e2ea 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/MetricStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/MetricStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MetricStatus describes the last-read state of a single metric.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public MetricStatus(ContainerResourceMetricStatus containerResource, ExternalMet
         this.type = type;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("containerResource")
     public ContainerResourceMetricStatus getContainerResource() {
         return containerResource;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("containerResource")
     public void setContainerResource(ContainerResourceMetricStatus containerResource) {
         this.containerResource = containerResource;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("external")
     public ExternalMetricStatus getExternal() {
         return external;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("external")
     public void setExternal(ExternalMetricStatus external) {
         this.external = external;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("object")
     public ObjectMetricStatus getObject() {
         return object;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("object")
     public void setObject(ObjectMetricStatus object) {
         this.object = object;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("pods")
     public PodsMetricStatus getPods() {
         return pods;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("pods")
     public void setPods(PodsMetricStatus pods) {
         this.pods = pods;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("resource")
     public ResourceMetricStatus getResource() {
         return resource;
     }
 
+    /**
+     * MetricStatus describes the last-read state of a single metric.
+     */
     @JsonProperty("resource")
     public void setResource(ResourceMetricStatus resource) {
         this.resource = resource;
     }
 
+    /**
+     * type is the type of metric source.  It will be one of "ContainerResource", "External", "Object", "Pods" or "Resource", each corresponds to a matching field in the object. Note: "ContainerResource" type is available on when the feature-gate HPAContainerMetrics is enabled
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the type of metric source.  It will be one of "ContainerResource", "External", "Object", "Pods" or "Resource", each corresponds to a matching field in the object. Note: "ContainerResource" type is available on when the feature-gate HPAContainerMetrics is enabled
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/MetricTarget.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/MetricTarget.java
index 895e29aa8f3..dcb7cea99b9 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/MetricTarget.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/MetricTarget.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MetricTarget defines the target value, average value, or average utilization of a specific metric
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,41 +94,65 @@ public MetricTarget(Integer averageUtilization, Quantity averageValue, String ty
         this.value = value;
     }
 
+    /**
+     * averageUtilization is the target value of the average of the resource metric across all relevant pods, represented as a percentage of the requested value of the resource for the pods. Currently only valid for Resource metric source type
+     */
     @JsonProperty("averageUtilization")
     public Integer getAverageUtilization() {
         return averageUtilization;
     }
 
+    /**
+     * averageUtilization is the target value of the average of the resource metric across all relevant pods, represented as a percentage of the requested value of the resource for the pods. Currently only valid for Resource metric source type
+     */
     @JsonProperty("averageUtilization")
     public void setAverageUtilization(Integer averageUtilization) {
         this.averageUtilization = averageUtilization;
     }
 
+    /**
+     * MetricTarget defines the target value, average value, or average utilization of a specific metric
+     */
     @JsonProperty("averageValue")
     public Quantity getAverageValue() {
         return averageValue;
     }
 
+    /**
+     * MetricTarget defines the target value, average value, or average utilization of a specific metric
+     */
     @JsonProperty("averageValue")
     public void setAverageValue(Quantity averageValue) {
         this.averageValue = averageValue;
     }
 
+    /**
+     * type represents whether the metric type is Utilization, Value, or AverageValue
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type represents whether the metric type is Utilization, Value, or AverageValue
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * MetricTarget defines the target value, average value, or average utilization of a specific metric
+     */
     @JsonProperty("value")
     public Quantity getValue() {
         return value;
     }
 
+    /**
+     * MetricTarget defines the target value, average value, or average utilization of a specific metric
+     */
     @JsonProperty("value")
     public void setValue(Quantity value) {
         this.value = value;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/MetricValueStatus.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/MetricValueStatus.java
index 4fc49d41b66..4a4574047b3 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/MetricValueStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/MetricValueStatus.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MetricValueStatus holds the current value for a metric
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,31 +90,49 @@ public MetricValueStatus(Integer averageUtilization, Quantity averageValue, Quan
         this.value = value;
     }
 
+    /**
+     * currentAverageUtilization is the current value of the average of the resource metric across all relevant pods, represented as a percentage of the requested value of the resource for the pods.
+     */
     @JsonProperty("averageUtilization")
     public Integer getAverageUtilization() {
         return averageUtilization;
     }
 
+    /**
+     * currentAverageUtilization is the current value of the average of the resource metric across all relevant pods, represented as a percentage of the requested value of the resource for the pods.
+     */
     @JsonProperty("averageUtilization")
     public void setAverageUtilization(Integer averageUtilization) {
         this.averageUtilization = averageUtilization;
     }
 
+    /**
+     * MetricValueStatus holds the current value for a metric
+     */
     @JsonProperty("averageValue")
     public Quantity getAverageValue() {
         return averageValue;
     }
 
+    /**
+     * MetricValueStatus holds the current value for a metric
+     */
     @JsonProperty("averageValue")
     public void setAverageValue(Quantity averageValue) {
         this.averageValue = averageValue;
     }
 
+    /**
+     * MetricValueStatus holds the current value for a metric
+     */
     @JsonProperty("value")
     public Quantity getValue() {
         return value;
     }
 
+    /**
+     * MetricValueStatus holds the current value for a metric
+     */
     @JsonProperty("value")
     public void setValue(Quantity value) {
         this.value = value;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ObjectMetricSource.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ObjectMetricSource.java
index 9e2fd65b6e0..431f66052f0 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ObjectMetricSource.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ObjectMetricSource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ObjectMetricSource indicates how to scale on a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ObjectMetricSource(CrossVersionObjectReference describedObject, MetricIde
         this.target = target;
     }
 
+    /**
+     * ObjectMetricSource indicates how to scale on a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("describedObject")
     public CrossVersionObjectReference getDescribedObject() {
         return describedObject;
     }
 
+    /**
+     * ObjectMetricSource indicates how to scale on a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("describedObject")
     public void setDescribedObject(CrossVersionObjectReference describedObject) {
         this.describedObject = describedObject;
     }
 
+    /**
+     * ObjectMetricSource indicates how to scale on a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("metric")
     public MetricIdentifier getMetric() {
         return metric;
     }
 
+    /**
+     * ObjectMetricSource indicates how to scale on a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("metric")
     public void setMetric(MetricIdentifier metric) {
         this.metric = metric;
     }
 
+    /**
+     * ObjectMetricSource indicates how to scale on a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("target")
     public MetricTarget getTarget() {
         return target;
     }
 
+    /**
+     * ObjectMetricSource indicates how to scale on a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("target")
     public void setTarget(MetricTarget target) {
         this.target = target;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ObjectMetricStatus.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ObjectMetricStatus.java
index 07f6efce4ed..61c7014c095 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ObjectMetricStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ObjectMetricStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ObjectMetricStatus indicates the current value of a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ObjectMetricStatus(MetricValueStatus current, CrossVersionObjectReference
         this.metric = metric;
     }
 
+    /**
+     * ObjectMetricStatus indicates the current value of a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("current")
     public MetricValueStatus getCurrent() {
         return current;
     }
 
+    /**
+     * ObjectMetricStatus indicates the current value of a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("current")
     public void setCurrent(MetricValueStatus current) {
         this.current = current;
     }
 
+    /**
+     * ObjectMetricStatus indicates the current value of a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("describedObject")
     public CrossVersionObjectReference getDescribedObject() {
         return describedObject;
     }
 
+    /**
+     * ObjectMetricStatus indicates the current value of a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("describedObject")
     public void setDescribedObject(CrossVersionObjectReference describedObject) {
         this.describedObject = describedObject;
     }
 
+    /**
+     * ObjectMetricStatus indicates the current value of a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("metric")
     public MetricIdentifier getMetric() {
         return metric;
     }
 
+    /**
+     * ObjectMetricStatus indicates the current value of a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).
+     */
     @JsonProperty("metric")
     public void setMetric(MetricIdentifier metric) {
         this.metric = metric;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/PodsMetricSource.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/PodsMetricSource.java
index 83e6009cb04..e387b43b137 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/PodsMetricSource.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/PodsMetricSource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodsMetricSource indicates how to scale on a metric describing each pod in the current scale target (for example, transactions-processed-per-second). The values will be averaged together before being compared to the target value.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PodsMetricSource(MetricIdentifier metric, MetricTarget target) {
         this.target = target;
     }
 
+    /**
+     * PodsMetricSource indicates how to scale on a metric describing each pod in the current scale target (for example, transactions-processed-per-second). The values will be averaged together before being compared to the target value.
+     */
     @JsonProperty("metric")
     public MetricIdentifier getMetric() {
         return metric;
     }
 
+    /**
+     * PodsMetricSource indicates how to scale on a metric describing each pod in the current scale target (for example, transactions-processed-per-second). The values will be averaged together before being compared to the target value.
+     */
     @JsonProperty("metric")
     public void setMetric(MetricIdentifier metric) {
         this.metric = metric;
     }
 
+    /**
+     * PodsMetricSource indicates how to scale on a metric describing each pod in the current scale target (for example, transactions-processed-per-second). The values will be averaged together before being compared to the target value.
+     */
     @JsonProperty("target")
     public MetricTarget getTarget() {
         return target;
     }
 
+    /**
+     * PodsMetricSource indicates how to scale on a metric describing each pod in the current scale target (for example, transactions-processed-per-second). The values will be averaged together before being compared to the target value.
+     */
     @JsonProperty("target")
     public void setTarget(MetricTarget target) {
         this.target = target;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/PodsMetricStatus.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/PodsMetricStatus.java
index f0b132e2315..05831696c87 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/PodsMetricStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/PodsMetricStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodsMetricStatus indicates the current value of a metric describing each pod in the current scale target (for example, transactions-processed-per-second).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PodsMetricStatus(MetricValueStatus current, MetricIdentifier metric) {
         this.metric = metric;
     }
 
+    /**
+     * PodsMetricStatus indicates the current value of a metric describing each pod in the current scale target (for example, transactions-processed-per-second).
+     */
     @JsonProperty("current")
     public MetricValueStatus getCurrent() {
         return current;
     }
 
+    /**
+     * PodsMetricStatus indicates the current value of a metric describing each pod in the current scale target (for example, transactions-processed-per-second).
+     */
     @JsonProperty("current")
     public void setCurrent(MetricValueStatus current) {
         this.current = current;
     }
 
+    /**
+     * PodsMetricStatus indicates the current value of a metric describing each pod in the current scale target (for example, transactions-processed-per-second).
+     */
     @JsonProperty("metric")
     public MetricIdentifier getMetric() {
         return metric;
     }
 
+    /**
+     * PodsMetricStatus indicates the current value of a metric describing each pod in the current scale target (for example, transactions-processed-per-second).
+     */
     @JsonProperty("metric")
     public void setMetric(MetricIdentifier metric) {
         this.metric = metric;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ResourceMetricSource.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ResourceMetricSource.java
index d70c62d40d0..48845eabc9b 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ResourceMetricSource.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ResourceMetricSource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceMetricSource indicates how to scale on a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory).  The values will be averaged together before being compared to the target.  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.  Only one "target" type should be set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ResourceMetricSource(String name, MetricTarget target) {
         this.target = target;
     }
 
+    /**
+     * name is the name of the resource in question.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the resource in question.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * ResourceMetricSource indicates how to scale on a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory).  The values will be averaged together before being compared to the target.  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.  Only one "target" type should be set.
+     */
     @JsonProperty("target")
     public MetricTarget getTarget() {
         return target;
     }
 
+    /**
+     * ResourceMetricSource indicates how to scale on a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory).  The values will be averaged together before being compared to the target.  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.  Only one "target" type should be set.
+     */
     @JsonProperty("target")
     public void setTarget(MetricTarget target) {
         this.target = target;
diff --git a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ResourceMetricStatus.java b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ResourceMetricStatus.java
index fd0efc5b879..477f89d044e 100644
--- a/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ResourceMetricStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-autoscaling/src/generated/java/io/fabric8/kubernetes/api/model/autoscaling/v2beta2/ResourceMetricStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceMetricStatus indicates the current value of a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory).  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ResourceMetricStatus(MetricValueStatus current, String name) {
         this.name = name;
     }
 
+    /**
+     * ResourceMetricStatus indicates the current value of a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory).  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.
+     */
     @JsonProperty("current")
     public MetricValueStatus getCurrent() {
         return current;
     }
 
+    /**
+     * ResourceMetricStatus indicates the current value of a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory).  Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.
+     */
     @JsonProperty("current")
     public void setCurrent(MetricValueStatus current) {
         this.current = current;
     }
 
+    /**
+     * Name is the name of the resource in question.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the resource in question.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/CronJob.java b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/CronJob.java
index 5e81b637103..ad66dfaf521 100644
--- a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/CronJob.java
+++ b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/CronJob.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CronJob represents the configuration of a single cron job.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class CronJob implements Editable<CronJobBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "batch/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CronJob";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CronJob(String apiVersion, String kind, ObjectMeta metadata, CronJobSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CronJob represents the configuration of a single cron job.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CronJob represents the configuration of a single cron job.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * CronJob represents the configuration of a single cron job.
+     */
     @JsonProperty("spec")
     public CronJobSpec getSpec() {
         return spec;
     }
 
+    /**
+     * CronJob represents the configuration of a single cron job.
+     */
     @JsonProperty("spec")
     public void setSpec(CronJobSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * CronJob represents the configuration of a single cron job.
+     */
     @JsonProperty("status")
     public CronJobStatus getStatus() {
         return status;
     }
 
+    /**
+     * CronJob represents the configuration of a single cron job.
+     */
     @JsonProperty("status")
     public void setStatus(CronJobStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/CronJobList.java b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/CronJobList.java
index 85e62b3029c..ba8f7151a60 100644
--- a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/CronJobList.java
+++ b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/CronJobList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CronJobList is a collection of cron jobs.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class CronJobList implements Editable<CronJobListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.batch.v1.CronJob>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "batch/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.batch.v1.CronJob> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CronJobList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CronJobList(String apiVersion, List<io.fabric8.kubernetes.api.model.batch
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of CronJobs.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.batch.v1.CronJob> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of CronJobs.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.batch.v1.CronJob> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CronJobList is a collection of cron jobs.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CronJobList is a collection of cron jobs.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/CronJobSpec.java b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/CronJobSpec.java
index 44656f87ca1..7116ca7907e 100644
--- a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/CronJobSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/CronJobSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CronJobSpec describes how the job execution will look like and when it will actually run.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -106,81 +109,129 @@ public CronJobSpec(String concurrencyPolicy, Integer failedJobsHistoryLimit, Job
         this.timeZone = timeZone;
     }
 
+    /**
+     * Specifies how to treat concurrent executions of a Job. Valid values are:<br><p> <br><p> - "Allow" (default): allows CronJobs to run concurrently; - "Forbid": forbids concurrent runs, skipping next run if previous run hasn't finished yet; - "Replace": cancels currently running job and replaces it with a new one
+     */
     @JsonProperty("concurrencyPolicy")
     public String getConcurrencyPolicy() {
         return concurrencyPolicy;
     }
 
+    /**
+     * Specifies how to treat concurrent executions of a Job. Valid values are:<br><p> <br><p> - "Allow" (default): allows CronJobs to run concurrently; - "Forbid": forbids concurrent runs, skipping next run if previous run hasn't finished yet; - "Replace": cancels currently running job and replaces it with a new one
+     */
     @JsonProperty("concurrencyPolicy")
     public void setConcurrencyPolicy(String concurrencyPolicy) {
         this.concurrencyPolicy = concurrencyPolicy;
     }
 
+    /**
+     * The number of failed finished jobs to retain. Value must be non-negative integer. Defaults to 1.
+     */
     @JsonProperty("failedJobsHistoryLimit")
     public Integer getFailedJobsHistoryLimit() {
         return failedJobsHistoryLimit;
     }
 
+    /**
+     * The number of failed finished jobs to retain. Value must be non-negative integer. Defaults to 1.
+     */
     @JsonProperty("failedJobsHistoryLimit")
     public void setFailedJobsHistoryLimit(Integer failedJobsHistoryLimit) {
         this.failedJobsHistoryLimit = failedJobsHistoryLimit;
     }
 
+    /**
+     * CronJobSpec describes how the job execution will look like and when it will actually run.
+     */
     @JsonProperty("jobTemplate")
     public JobTemplateSpec getJobTemplate() {
         return jobTemplate;
     }
 
+    /**
+     * CronJobSpec describes how the job execution will look like and when it will actually run.
+     */
     @JsonProperty("jobTemplate")
     public void setJobTemplate(JobTemplateSpec jobTemplate) {
         this.jobTemplate = jobTemplate;
     }
 
+    /**
+     * The schedule in Cron format, see https://en.wikipedia.org/wiki/Cron.
+     */
     @JsonProperty("schedule")
     public String getSchedule() {
         return schedule;
     }
 
+    /**
+     * The schedule in Cron format, see https://en.wikipedia.org/wiki/Cron.
+     */
     @JsonProperty("schedule")
     public void setSchedule(String schedule) {
         this.schedule = schedule;
     }
 
+    /**
+     * Optional deadline in seconds for starting the job if it misses scheduled time for any reason.  Missed jobs executions will be counted as failed ones.
+     */
     @JsonProperty("startingDeadlineSeconds")
     public Long getStartingDeadlineSeconds() {
         return startingDeadlineSeconds;
     }
 
+    /**
+     * Optional deadline in seconds for starting the job if it misses scheduled time for any reason.  Missed jobs executions will be counted as failed ones.
+     */
     @JsonProperty("startingDeadlineSeconds")
     public void setStartingDeadlineSeconds(Long startingDeadlineSeconds) {
         this.startingDeadlineSeconds = startingDeadlineSeconds;
     }
 
+    /**
+     * The number of successful finished jobs to retain. Value must be non-negative integer. Defaults to 3.
+     */
     @JsonProperty("successfulJobsHistoryLimit")
     public Integer getSuccessfulJobsHistoryLimit() {
         return successfulJobsHistoryLimit;
     }
 
+    /**
+     * The number of successful finished jobs to retain. Value must be non-negative integer. Defaults to 3.
+     */
     @JsonProperty("successfulJobsHistoryLimit")
     public void setSuccessfulJobsHistoryLimit(Integer successfulJobsHistoryLimit) {
         this.successfulJobsHistoryLimit = successfulJobsHistoryLimit;
     }
 
+    /**
+     * This flag tells the controller to suspend subsequent executions, it does not apply to already started executions.  Defaults to false.
+     */
     @JsonProperty("suspend")
     public Boolean getSuspend() {
         return suspend;
     }
 
+    /**
+     * This flag tells the controller to suspend subsequent executions, it does not apply to already started executions.  Defaults to false.
+     */
     @JsonProperty("suspend")
     public void setSuspend(Boolean suspend) {
         this.suspend = suspend;
     }
 
+    /**
+     * The time zone name for the given schedule, see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones. If not specified, this will default to the time zone of the kube-controller-manager process. The set of valid time zone names and the time zone offset is loaded from the system-wide time zone database by the API server during CronJob validation and the controller manager during execution. If no system-wide time zone database can be found a bundled version of the database is used instead. If the time zone name becomes invalid during the lifetime of a CronJob or due to a change in host configuration, the controller will stop creating new new Jobs and will create a system event with the reason UnknownTimeZone. More information can be found in https://kubernetes.io/docs/concepts/workloads/controllers/cron-jobs/#time-zones
+     */
     @JsonProperty("timeZone")
     public String getTimeZone() {
         return timeZone;
     }
 
+    /**
+     * The time zone name for the given schedule, see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones. If not specified, this will default to the time zone of the kube-controller-manager process. The set of valid time zone names and the time zone offset is loaded from the system-wide time zone database by the API server during CronJob validation and the controller manager during execution. If no system-wide time zone database can be found a bundled version of the database is used instead. If the time zone name becomes invalid during the lifetime of a CronJob or due to a change in host configuration, the controller will stop creating new new Jobs and will create a system event with the reason UnknownTimeZone. More information can be found in https://kubernetes.io/docs/concepts/workloads/controllers/cron-jobs/#time-zones
+     */
     @JsonProperty("timeZone")
     public void setTimeZone(String timeZone) {
         this.timeZone = timeZone;
diff --git a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/CronJobStatus.java b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/CronJobStatus.java
index 41d39167d14..bbe4c09f27f 100644
--- a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/CronJobStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/CronJobStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CronJobStatus represents the current state of a cron job.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public CronJobStatus(List<ObjectReference> active, String lastScheduleTime, Stri
         this.lastSuccessfulTime = lastSuccessfulTime;
     }
 
+    /**
+     * A list of pointers to currently running jobs.
+     */
     @JsonProperty("active")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ObjectReference> getActive() {
         return active;
     }
 
+    /**
+     * A list of pointers to currently running jobs.
+     */
     @JsonProperty("active")
     public void setActive(List<ObjectReference> active) {
         this.active = active;
     }
 
+    /**
+     * CronJobStatus represents the current state of a cron job.
+     */
     @JsonProperty("lastScheduleTime")
     public String getLastScheduleTime() {
         return lastScheduleTime;
     }
 
+    /**
+     * CronJobStatus represents the current state of a cron job.
+     */
     @JsonProperty("lastScheduleTime")
     public void setLastScheduleTime(String lastScheduleTime) {
         this.lastScheduleTime = lastScheduleTime;
     }
 
+    /**
+     * CronJobStatus represents the current state of a cron job.
+     */
     @JsonProperty("lastSuccessfulTime")
     public String getLastSuccessfulTime() {
         return lastSuccessfulTime;
     }
 
+    /**
+     * CronJobStatus represents the current state of a cron job.
+     */
     @JsonProperty("lastSuccessfulTime")
     public void setLastSuccessfulTime(String lastSuccessfulTime) {
         this.lastSuccessfulTime = lastSuccessfulTime;
diff --git a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/Job.java b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/Job.java
index 7f6f2d6fb59..8c9f23759f8 100644
--- a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/Job.java
+++ b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/Job.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Job represents the configuration of a single job.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Job implements Editable<JobBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "batch/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Job";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Job(String apiVersion, String kind, ObjectMeta metadata, JobSpec spec, Jo
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Job represents the configuration of a single job.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Job represents the configuration of a single job.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Job represents the configuration of a single job.
+     */
     @JsonProperty("spec")
     public JobSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Job represents the configuration of a single job.
+     */
     @JsonProperty("spec")
     public void setSpec(JobSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Job represents the configuration of a single job.
+     */
     @JsonProperty("status")
     public JobStatus getStatus() {
         return status;
     }
 
+    /**
+     * Job represents the configuration of a single job.
+     */
     @JsonProperty("status")
     public void setStatus(JobStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/JobCondition.java b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/JobCondition.java
index 7d4612f9aa6..a64d901c834 100644
--- a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/JobCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/JobCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JobCondition describes current state of a job.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public JobCondition(String lastProbeTime, String lastTransitionTime, String mess
         this.type = type;
     }
 
+    /**
+     * JobCondition describes current state of a job.
+     */
     @JsonProperty("lastProbeTime")
     public String getLastProbeTime() {
         return lastProbeTime;
     }
 
+    /**
+     * JobCondition describes current state of a job.
+     */
     @JsonProperty("lastProbeTime")
     public void setLastProbeTime(String lastProbeTime) {
         this.lastProbeTime = lastProbeTime;
     }
 
+    /**
+     * JobCondition describes current state of a job.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * JobCondition describes current state of a job.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Human readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Human readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * (brief) reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * (brief) reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type of job condition, Complete or Failed.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of job condition, Complete or Failed.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/JobList.java b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/JobList.java
index b486072c843..23e5600c756 100644
--- a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/JobList.java
+++ b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/JobList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JobList is a collection of jobs.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class JobList implements Editable<JobListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.batch.v1.Job>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "batch/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.batch.v1.Job> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "JobList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public JobList(String apiVersion, List<io.fabric8.kubernetes.api.model.batch.v1.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of Jobs.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.batch.v1.Job> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of Jobs.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.batch.v1.Job> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * JobList is a collection of jobs.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * JobList is a collection of jobs.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/JobSpec.java b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/JobSpec.java
index c49eed3eb51..81fb43e1b66 100644
--- a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/JobSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/JobSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JobSpec describes how the job execution will look like.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -138,161 +141,257 @@ public JobSpec(Long activeDeadlineSeconds, Integer backoffLimit, Integer backoff
         this.ttlSecondsAfterFinished = ttlSecondsAfterFinished;
     }
 
+    /**
+     * Specifies the duration in seconds relative to the startTime that the job may be continuously active before the system tries to terminate it; value must be positive integer. If a Job is suspended (at creation or through an update), this timer will effectively be stopped and reset when the Job is resumed again.
+     */
     @JsonProperty("activeDeadlineSeconds")
     public Long getActiveDeadlineSeconds() {
         return activeDeadlineSeconds;
     }
 
+    /**
+     * Specifies the duration in seconds relative to the startTime that the job may be continuously active before the system tries to terminate it; value must be positive integer. If a Job is suspended (at creation or through an update), this timer will effectively be stopped and reset when the Job is resumed again.
+     */
     @JsonProperty("activeDeadlineSeconds")
     public void setActiveDeadlineSeconds(Long activeDeadlineSeconds) {
         this.activeDeadlineSeconds = activeDeadlineSeconds;
     }
 
+    /**
+     * Specifies the number of retries before marking this job failed. Defaults to 6
+     */
     @JsonProperty("backoffLimit")
     public Integer getBackoffLimit() {
         return backoffLimit;
     }
 
+    /**
+     * Specifies the number of retries before marking this job failed. Defaults to 6
+     */
     @JsonProperty("backoffLimit")
     public void setBackoffLimit(Integer backoffLimit) {
         this.backoffLimit = backoffLimit;
     }
 
+    /**
+     * Specifies the limit for the number of retries within an index before marking this index as failed. When enabled the number of failures per index is kept in the pod's batch.kubernetes.io/job-index-failure-count annotation. It can only be set when Job's completionMode=Indexed, and the Pod's restart policy is Never. The field is immutable. This field is beta-level. It can be used when the `JobBackoffLimitPerIndex` feature gate is enabled (enabled by default).
+     */
     @JsonProperty("backoffLimitPerIndex")
     public Integer getBackoffLimitPerIndex() {
         return backoffLimitPerIndex;
     }
 
+    /**
+     * Specifies the limit for the number of retries within an index before marking this index as failed. When enabled the number of failures per index is kept in the pod's batch.kubernetes.io/job-index-failure-count annotation. It can only be set when Job's completionMode=Indexed, and the Pod's restart policy is Never. The field is immutable. This field is beta-level. It can be used when the `JobBackoffLimitPerIndex` feature gate is enabled (enabled by default).
+     */
     @JsonProperty("backoffLimitPerIndex")
     public void setBackoffLimitPerIndex(Integer backoffLimitPerIndex) {
         this.backoffLimitPerIndex = backoffLimitPerIndex;
     }
 
+    /**
+     * completionMode specifies how Pod completions are tracked. It can be `NonIndexed` (default) or `Indexed`.<br><p> <br><p> `NonIndexed` means that the Job is considered complete when there have been .spec.completions successfully completed Pods. Each Pod completion is homologous to each other.<br><p> <br><p> `Indexed` means that the Pods of a Job get an associated completion index from 0 to (.spec.completions - 1), available in the annotation batch.kubernetes.io/job-completion-index. The Job is considered complete when there is one successfully completed Pod for each index. When value is `Indexed`, .spec.completions must be specified and `.spec.parallelism` must be less than or equal to 10^5. In addition, The Pod name takes the form `$(job-name)-$(index)-$(random-string)`, the Pod hostname takes the form `$(job-name)-$(index)`.<br><p> <br><p> More completion modes can be added in the future. If the Job controller observes a mode that it doesn't recognize, which is possible during upgrades due to version skew, the controller skips updates for the Job.
+     */
     @JsonProperty("completionMode")
     public String getCompletionMode() {
         return completionMode;
     }
 
+    /**
+     * completionMode specifies how Pod completions are tracked. It can be `NonIndexed` (default) or `Indexed`.<br><p> <br><p> `NonIndexed` means that the Job is considered complete when there have been .spec.completions successfully completed Pods. Each Pod completion is homologous to each other.<br><p> <br><p> `Indexed` means that the Pods of a Job get an associated completion index from 0 to (.spec.completions - 1), available in the annotation batch.kubernetes.io/job-completion-index. The Job is considered complete when there is one successfully completed Pod for each index. When value is `Indexed`, .spec.completions must be specified and `.spec.parallelism` must be less than or equal to 10^5. In addition, The Pod name takes the form `$(job-name)-$(index)-$(random-string)`, the Pod hostname takes the form `$(job-name)-$(index)`.<br><p> <br><p> More completion modes can be added in the future. If the Job controller observes a mode that it doesn't recognize, which is possible during upgrades due to version skew, the controller skips updates for the Job.
+     */
     @JsonProperty("completionMode")
     public void setCompletionMode(String completionMode) {
         this.completionMode = completionMode;
     }
 
+    /**
+     * Specifies the desired number of successfully finished pods the job should be run with.  Setting to null means that the success of any pod signals the success of all pods, and allows parallelism to have any positive value.  Setting to 1 means that parallelism is limited to 1 and the success of that pod signals the success of the job. More info: https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/
+     */
     @JsonProperty("completions")
     public Integer getCompletions() {
         return completions;
     }
 
+    /**
+     * Specifies the desired number of successfully finished pods the job should be run with.  Setting to null means that the success of any pod signals the success of all pods, and allows parallelism to have any positive value.  Setting to 1 means that parallelism is limited to 1 and the success of that pod signals the success of the job. More info: https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/
+     */
     @JsonProperty("completions")
     public void setCompletions(Integer completions) {
         this.completions = completions;
     }
 
+    /**
+     * ManagedBy field indicates the controller that manages a Job. The k8s Job controller reconciles jobs which don't have this field at all or the field value is the reserved string `kubernetes.io/job-controller`, but skips reconciling Jobs with a custom value for this field. The value must be a valid domain-prefixed path (e.g. acme.io/foo) - all characters before the first "/" must be a valid subdomain as defined by RFC 1123. All characters trailing the first "/" must be valid HTTP Path characters as defined by RFC 3986. The value cannot exceed 63 characters. This field is immutable.<br><p> <br><p> This field is beta-level. The job controller accepts setting the field when the feature gate JobManagedBy is enabled (enabled by default).
+     */
     @JsonProperty("managedBy")
     public String getManagedBy() {
         return managedBy;
     }
 
+    /**
+     * ManagedBy field indicates the controller that manages a Job. The k8s Job controller reconciles jobs which don't have this field at all or the field value is the reserved string `kubernetes.io/job-controller`, but skips reconciling Jobs with a custom value for this field. The value must be a valid domain-prefixed path (e.g. acme.io/foo) - all characters before the first "/" must be a valid subdomain as defined by RFC 1123. All characters trailing the first "/" must be valid HTTP Path characters as defined by RFC 3986. The value cannot exceed 63 characters. This field is immutable.<br><p> <br><p> This field is beta-level. The job controller accepts setting the field when the feature gate JobManagedBy is enabled (enabled by default).
+     */
     @JsonProperty("managedBy")
     public void setManagedBy(String managedBy) {
         this.managedBy = managedBy;
     }
 
+    /**
+     * manualSelector controls generation of pod labels and pod selectors. Leave `manualSelector` unset unless you are certain what you are doing. When false or unset, the system pick labels unique to this job and appends those labels to the pod template.  When true, the user is responsible for picking unique labels and specifying the selector.  Failure to pick a unique label may cause this and other jobs to not function correctly.  However, You may see `manualSelector=true` in jobs that were created with the old `extensions/v1beta1` API. More info: https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/#specifying-your-own-pod-selector
+     */
     @JsonProperty("manualSelector")
     public Boolean getManualSelector() {
         return manualSelector;
     }
 
+    /**
+     * manualSelector controls generation of pod labels and pod selectors. Leave `manualSelector` unset unless you are certain what you are doing. When false or unset, the system pick labels unique to this job and appends those labels to the pod template.  When true, the user is responsible for picking unique labels and specifying the selector.  Failure to pick a unique label may cause this and other jobs to not function correctly.  However, You may see `manualSelector=true` in jobs that were created with the old `extensions/v1beta1` API. More info: https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/#specifying-your-own-pod-selector
+     */
     @JsonProperty("manualSelector")
     public void setManualSelector(Boolean manualSelector) {
         this.manualSelector = manualSelector;
     }
 
+    /**
+     * Specifies the maximal number of failed indexes before marking the Job as failed, when backoffLimitPerIndex is set. Once the number of failed indexes exceeds this number the entire Job is marked as Failed and its execution is terminated. When left as null the job continues execution of all of its indexes and is marked with the `Complete` Job condition. It can only be specified when backoffLimitPerIndex is set. It can be null or up to completions. It is required and must be less than or equal to 10^4 when is completions greater than 10^5. This field is beta-level. It can be used when the `JobBackoffLimitPerIndex` feature gate is enabled (enabled by default).
+     */
     @JsonProperty("maxFailedIndexes")
     public Integer getMaxFailedIndexes() {
         return maxFailedIndexes;
     }
 
+    /**
+     * Specifies the maximal number of failed indexes before marking the Job as failed, when backoffLimitPerIndex is set. Once the number of failed indexes exceeds this number the entire Job is marked as Failed and its execution is terminated. When left as null the job continues execution of all of its indexes and is marked with the `Complete` Job condition. It can only be specified when backoffLimitPerIndex is set. It can be null or up to completions. It is required and must be less than or equal to 10^4 when is completions greater than 10^5. This field is beta-level. It can be used when the `JobBackoffLimitPerIndex` feature gate is enabled (enabled by default).
+     */
     @JsonProperty("maxFailedIndexes")
     public void setMaxFailedIndexes(Integer maxFailedIndexes) {
         this.maxFailedIndexes = maxFailedIndexes;
     }
 
+    /**
+     * Specifies the maximum desired number of pods the job should run at any given time. The actual number of pods running in steady state will be less than this number when ((.spec.completions - .status.successful) &lt; .spec.parallelism), i.e. when the work left to do is less than max parallelism. More info: https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/
+     */
     @JsonProperty("parallelism")
     public Integer getParallelism() {
         return parallelism;
     }
 
+    /**
+     * Specifies the maximum desired number of pods the job should run at any given time. The actual number of pods running in steady state will be less than this number when ((.spec.completions - .status.successful) &lt; .spec.parallelism), i.e. when the work left to do is less than max parallelism. More info: https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/
+     */
     @JsonProperty("parallelism")
     public void setParallelism(Integer parallelism) {
         this.parallelism = parallelism;
     }
 
+    /**
+     * JobSpec describes how the job execution will look like.
+     */
     @JsonProperty("podFailurePolicy")
     public PodFailurePolicy getPodFailurePolicy() {
         return podFailurePolicy;
     }
 
+    /**
+     * JobSpec describes how the job execution will look like.
+     */
     @JsonProperty("podFailurePolicy")
     public void setPodFailurePolicy(PodFailurePolicy podFailurePolicy) {
         this.podFailurePolicy = podFailurePolicy;
     }
 
+    /**
+     * podReplacementPolicy specifies when to create replacement Pods. Possible values are: - TerminatingOrFailed means that we recreate pods<br><p>   when they are terminating (has a metadata.deletionTimestamp) or failed.<br><p> - Failed means to wait until a previously created Pod is fully terminated (has phase<br><p>   Failed or Succeeded) before creating a replacement Pod.<br><p> <br><p> When using podFailurePolicy, Failed is the the only allowed value. TerminatingOrFailed and Failed are allowed values when podFailurePolicy is not in use. This is an beta field. To use this, enable the JobPodReplacementPolicy feature toggle. This is on by default.
+     */
     @JsonProperty("podReplacementPolicy")
     public String getPodReplacementPolicy() {
         return podReplacementPolicy;
     }
 
+    /**
+     * podReplacementPolicy specifies when to create replacement Pods. Possible values are: - TerminatingOrFailed means that we recreate pods<br><p>   when they are terminating (has a metadata.deletionTimestamp) or failed.<br><p> - Failed means to wait until a previously created Pod is fully terminated (has phase<br><p>   Failed or Succeeded) before creating a replacement Pod.<br><p> <br><p> When using podFailurePolicy, Failed is the the only allowed value. TerminatingOrFailed and Failed are allowed values when podFailurePolicy is not in use. This is an beta field. To use this, enable the JobPodReplacementPolicy feature toggle. This is on by default.
+     */
     @JsonProperty("podReplacementPolicy")
     public void setPodReplacementPolicy(String podReplacementPolicy) {
         this.podReplacementPolicy = podReplacementPolicy;
     }
 
+    /**
+     * JobSpec describes how the job execution will look like.
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * JobSpec describes how the job execution will look like.
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * JobSpec describes how the job execution will look like.
+     */
     @JsonProperty("successPolicy")
     public SuccessPolicy getSuccessPolicy() {
         return successPolicy;
     }
 
+    /**
+     * JobSpec describes how the job execution will look like.
+     */
     @JsonProperty("successPolicy")
     public void setSuccessPolicy(SuccessPolicy successPolicy) {
         this.successPolicy = successPolicy;
     }
 
+    /**
+     * suspend specifies whether the Job controller should create Pods or not. If a Job is created with suspend set to true, no Pods are created by the Job controller. If a Job is suspended after creation (i.e. the flag goes from false to true), the Job controller will delete all active Pods associated with this Job. Users must design their workload to gracefully handle this. Suspending a Job will reset the StartTime field of the Job, effectively resetting the ActiveDeadlineSeconds timer too. Defaults to false.
+     */
     @JsonProperty("suspend")
     public Boolean getSuspend() {
         return suspend;
     }
 
+    /**
+     * suspend specifies whether the Job controller should create Pods or not. If a Job is created with suspend set to true, no Pods are created by the Job controller. If a Job is suspended after creation (i.e. the flag goes from false to true), the Job controller will delete all active Pods associated with this Job. Users must design their workload to gracefully handle this. Suspending a Job will reset the StartTime field of the Job, effectively resetting the ActiveDeadlineSeconds timer too. Defaults to false.
+     */
     @JsonProperty("suspend")
     public void setSuspend(Boolean suspend) {
         this.suspend = suspend;
     }
 
+    /**
+     * JobSpec describes how the job execution will look like.
+     */
     @JsonProperty("template")
     public PodTemplateSpec getTemplate() {
         return template;
     }
 
+    /**
+     * JobSpec describes how the job execution will look like.
+     */
     @JsonProperty("template")
     public void setTemplate(PodTemplateSpec template) {
         this.template = template;
     }
 
+    /**
+     * ttlSecondsAfterFinished limits the lifetime of a Job that has finished execution (either Complete or Failed). If this field is set, ttlSecondsAfterFinished after the Job finishes, it is eligible to be automatically deleted. When the Job is being deleted, its lifecycle guarantees (e.g. finalizers) will be honored. If this field is unset, the Job won't be automatically deleted. If this field is set to zero, the Job becomes eligible to be deleted immediately after it finishes.
+     */
     @JsonProperty("ttlSecondsAfterFinished")
     public Integer getTtlSecondsAfterFinished() {
         return ttlSecondsAfterFinished;
     }
 
+    /**
+     * ttlSecondsAfterFinished limits the lifetime of a Job that has finished execution (either Complete or Failed). If this field is set, ttlSecondsAfterFinished after the Job finishes, it is eligible to be automatically deleted. When the Job is being deleted, its lifecycle guarantees (e.g. finalizers) will be honored. If this field is unset, the Job won't be automatically deleted. If this field is set to zero, the Job becomes eligible to be deleted immediately after it finishes.
+     */
     @JsonProperty("ttlSecondsAfterFinished")
     public void setTtlSecondsAfterFinished(Integer ttlSecondsAfterFinished) {
         this.ttlSecondsAfterFinished = ttlSecondsAfterFinished;
diff --git a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/JobStatus.java b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/JobStatus.java
index 24c04b092af..e0e08b0c5f9 100644
--- a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/JobStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/JobStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JobStatus represents the current state of a Job.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -121,112 +124,178 @@ public JobStatus(Integer active, String completedIndexes, String completionTime,
         this.uncountedTerminatedPods = uncountedTerminatedPods;
     }
 
+    /**
+     * The number of pending and running pods which are not terminating (without a deletionTimestamp). The value is zero for finished jobs.
+     */
     @JsonProperty("active")
     public Integer getActive() {
         return active;
     }
 
+    /**
+     * The number of pending and running pods which are not terminating (without a deletionTimestamp). The value is zero for finished jobs.
+     */
     @JsonProperty("active")
     public void setActive(Integer active) {
         this.active = active;
     }
 
+    /**
+     * completedIndexes holds the completed indexes when .spec.completionMode = "Indexed" in a text format. The indexes are represented as decimal integers separated by commas. The numbers are listed in increasing order. Three or more consecutive numbers are compressed and represented by the first and last element of the series, separated by a hyphen. For example, if the completed indexes are 1, 3, 4, 5 and 7, they are represented as "1,3-5,7".
+     */
     @JsonProperty("completedIndexes")
     public String getCompletedIndexes() {
         return completedIndexes;
     }
 
+    /**
+     * completedIndexes holds the completed indexes when .spec.completionMode = "Indexed" in a text format. The indexes are represented as decimal integers separated by commas. The numbers are listed in increasing order. Three or more consecutive numbers are compressed and represented by the first and last element of the series, separated by a hyphen. For example, if the completed indexes are 1, 3, 4, 5 and 7, they are represented as "1,3-5,7".
+     */
     @JsonProperty("completedIndexes")
     public void setCompletedIndexes(String completedIndexes) {
         this.completedIndexes = completedIndexes;
     }
 
+    /**
+     * JobStatus represents the current state of a Job.
+     */
     @JsonProperty("completionTime")
     public String getCompletionTime() {
         return completionTime;
     }
 
+    /**
+     * JobStatus represents the current state of a Job.
+     */
     @JsonProperty("completionTime")
     public void setCompletionTime(String completionTime) {
         this.completionTime = completionTime;
     }
 
+    /**
+     * The latest available observations of an object's current state. When a Job fails, one of the conditions will have type "Failed" and status true. When a Job is suspended, one of the conditions will have type "Suspended" and status true; when the Job is resumed, the status of this condition will become false. When a Job is completed, one of the conditions will have type "Complete" and status true.<br><p> <br><p> A job is considered finished when it is in a terminal condition, either "Complete" or "Failed". A Job cannot have both the "Complete" and "Failed" conditions. Additionally, it cannot be in the "Complete" and "FailureTarget" conditions. The "Complete", "Failed" and "FailureTarget" conditions cannot be disabled.<br><p> <br><p> More info: https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<JobCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * The latest available observations of an object's current state. When a Job fails, one of the conditions will have type "Failed" and status true. When a Job is suspended, one of the conditions will have type "Suspended" and status true; when the Job is resumed, the status of this condition will become false. When a Job is completed, one of the conditions will have type "Complete" and status true.<br><p> <br><p> A job is considered finished when it is in a terminal condition, either "Complete" or "Failed". A Job cannot have both the "Complete" and "Failed" conditions. Additionally, it cannot be in the "Complete" and "FailureTarget" conditions. The "Complete", "Failed" and "FailureTarget" conditions cannot be disabled.<br><p> <br><p> More info: https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/
+     */
     @JsonProperty("conditions")
     public void setConditions(List<JobCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * The number of pods which reached phase Failed. The value increases monotonically.
+     */
     @JsonProperty("failed")
     public Integer getFailed() {
         return failed;
     }
 
+    /**
+     * The number of pods which reached phase Failed. The value increases monotonically.
+     */
     @JsonProperty("failed")
     public void setFailed(Integer failed) {
         this.failed = failed;
     }
 
+    /**
+     * FailedIndexes holds the failed indexes when spec.backoffLimitPerIndex is set. The indexes are represented in the text format analogous as for the `completedIndexes` field, ie. they are kept as decimal integers separated by commas. The numbers are listed in increasing order. Three or more consecutive numbers are compressed and represented by the first and last element of the series, separated by a hyphen. For example, if the failed indexes are 1, 3, 4, 5 and 7, they are represented as "1,3-5,7". The set of failed indexes cannot overlap with the set of completed indexes.<br><p> <br><p> This field is beta-level. It can be used when the `JobBackoffLimitPerIndex` feature gate is enabled (enabled by default).
+     */
     @JsonProperty("failedIndexes")
     public String getFailedIndexes() {
         return failedIndexes;
     }
 
+    /**
+     * FailedIndexes holds the failed indexes when spec.backoffLimitPerIndex is set. The indexes are represented in the text format analogous as for the `completedIndexes` field, ie. they are kept as decimal integers separated by commas. The numbers are listed in increasing order. Three or more consecutive numbers are compressed and represented by the first and last element of the series, separated by a hyphen. For example, if the failed indexes are 1, 3, 4, 5 and 7, they are represented as "1,3-5,7". The set of failed indexes cannot overlap with the set of completed indexes.<br><p> <br><p> This field is beta-level. It can be used when the `JobBackoffLimitPerIndex` feature gate is enabled (enabled by default).
+     */
     @JsonProperty("failedIndexes")
     public void setFailedIndexes(String failedIndexes) {
         this.failedIndexes = failedIndexes;
     }
 
+    /**
+     * The number of active pods which have a Ready condition and are not terminating (without a deletionTimestamp).
+     */
     @JsonProperty("ready")
     public Integer getReady() {
         return ready;
     }
 
+    /**
+     * The number of active pods which have a Ready condition and are not terminating (without a deletionTimestamp).
+     */
     @JsonProperty("ready")
     public void setReady(Integer ready) {
         this.ready = ready;
     }
 
+    /**
+     * JobStatus represents the current state of a Job.
+     */
     @JsonProperty("startTime")
     public String getStartTime() {
         return startTime;
     }
 
+    /**
+     * JobStatus represents the current state of a Job.
+     */
     @JsonProperty("startTime")
     public void setStartTime(String startTime) {
         this.startTime = startTime;
     }
 
+    /**
+     * The number of pods which reached phase Succeeded. The value increases monotonically for a given spec. However, it may decrease in reaction to scale down of elastic indexed jobs.
+     */
     @JsonProperty("succeeded")
     public Integer getSucceeded() {
         return succeeded;
     }
 
+    /**
+     * The number of pods which reached phase Succeeded. The value increases monotonically for a given spec. However, it may decrease in reaction to scale down of elastic indexed jobs.
+     */
     @JsonProperty("succeeded")
     public void setSucceeded(Integer succeeded) {
         this.succeeded = succeeded;
     }
 
+    /**
+     * The number of pods which are terminating (in phase Pending or Running and have a deletionTimestamp).<br><p> <br><p> This field is beta-level. The job controller populates the field when the feature gate JobPodReplacementPolicy is enabled (enabled by default).
+     */
     @JsonProperty("terminating")
     public Integer getTerminating() {
         return terminating;
     }
 
+    /**
+     * The number of pods which are terminating (in phase Pending or Running and have a deletionTimestamp).<br><p> <br><p> This field is beta-level. The job controller populates the field when the feature gate JobPodReplacementPolicy is enabled (enabled by default).
+     */
     @JsonProperty("terminating")
     public void setTerminating(Integer terminating) {
         this.terminating = terminating;
     }
 
+    /**
+     * JobStatus represents the current state of a Job.
+     */
     @JsonProperty("uncountedTerminatedPods")
     public UncountedTerminatedPods getUncountedTerminatedPods() {
         return uncountedTerminatedPods;
     }
 
+    /**
+     * JobStatus represents the current state of a Job.
+     */
     @JsonProperty("uncountedTerminatedPods")
     public void setUncountedTerminatedPods(UncountedTerminatedPods uncountedTerminatedPods) {
         this.uncountedTerminatedPods = uncountedTerminatedPods;
diff --git a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/JobTemplateSpec.java b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/JobTemplateSpec.java
index 5ba4fe3aa03..b7351c9dd05 100644
--- a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/JobTemplateSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/JobTemplateSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JobTemplateSpec describes the data a Job should have when created from a template
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public JobTemplateSpec(ObjectMeta metadata, JobSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * JobTemplateSpec describes the data a Job should have when created from a template
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * JobTemplateSpec describes the data a Job should have when created from a template
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * JobTemplateSpec describes the data a Job should have when created from a template
+     */
     @JsonProperty("spec")
     public JobSpec getSpec() {
         return spec;
     }
 
+    /**
+     * JobTemplateSpec describes the data a Job should have when created from a template
+     */
     @JsonProperty("spec")
     public void setSpec(JobSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/PodFailurePolicy.java b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/PodFailurePolicy.java
index 065f223f750..36feafaf4c2 100644
--- a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/PodFailurePolicy.java
+++ b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/PodFailurePolicy.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodFailurePolicy describes how failed pods influence the backoffLimit.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public PodFailurePolicy(List<PodFailurePolicyRule> rules) {
         this.rules = rules;
     }
 
+    /**
+     * A list of pod failure policy rules. The rules are evaluated in order. Once a rule matches a Pod failure, the remaining of the rules are ignored. When no rule matches the Pod failure, the default handling applies - the counter of pod failures is incremented and it is checked against the backoffLimit. At most 20 elements are allowed.
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PodFailurePolicyRule> getRules() {
         return rules;
     }
 
+    /**
+     * A list of pod failure policy rules. The rules are evaluated in order. Once a rule matches a Pod failure, the remaining of the rules are ignored. When no rule matches the Pod failure, the default handling applies - the counter of pod failures is incremented and it is checked against the backoffLimit. At most 20 elements are allowed.
+     */
     @JsonProperty("rules")
     public void setRules(List<PodFailurePolicyRule> rules) {
         this.rules = rules;
diff --git a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/PodFailurePolicyOnExitCodesRequirement.java b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/PodFailurePolicyOnExitCodesRequirement.java
index dc29bbaecae..16fd05b5440 100644
--- a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/PodFailurePolicyOnExitCodesRequirement.java
+++ b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/PodFailurePolicyOnExitCodesRequirement.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodFailurePolicyOnExitCodesRequirement describes the requirement for handling a failed pod based on its container exit codes. In particular, it lookups the .state.terminated.exitCode for each app container and init container status, represented by the .status.containerStatuses and .status.initContainerStatuses fields in the Pod status, respectively. Containers completed with success (exit code 0) are excluded from the requirement check.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public PodFailurePolicyOnExitCodesRequirement(String containerName, String opera
         this.values = values;
     }
 
+    /**
+     * Restricts the check for exit codes to the container with the specified name. When null, the rule applies to all containers. When specified, it should match one the container or initContainer names in the pod template.
+     */
     @JsonProperty("containerName")
     public String getContainerName() {
         return containerName;
     }
 
+    /**
+     * Restricts the check for exit codes to the container with the specified name. When null, the rule applies to all containers. When specified, it should match one the container or initContainer names in the pod template.
+     */
     @JsonProperty("containerName")
     public void setContainerName(String containerName) {
         this.containerName = containerName;
     }
 
+    /**
+     * Represents the relationship between the container exit code(s) and the specified values. Containers completed with success (exit code 0) are excluded from the requirement check. Possible values are:<br><p> <br><p> - In: the requirement is satisfied if at least one container exit code<br><p>   (might be multiple if there are multiple containers not restricted<br><p>   by the 'containerName' field) is in the set of specified values.<br><p> - NotIn: the requirement is satisfied if at least one container exit code<br><p>   (might be multiple if there are multiple containers not restricted<br><p>   by the 'containerName' field) is not in the set of specified values.<br><p> Additional values are considered to be added in the future. Clients should react to an unknown operator by assuming the requirement is not satisfied.
+     */
     @JsonProperty("operator")
     public String getOperator() {
         return operator;
     }
 
+    /**
+     * Represents the relationship between the container exit code(s) and the specified values. Containers completed with success (exit code 0) are excluded from the requirement check. Possible values are:<br><p> <br><p> - In: the requirement is satisfied if at least one container exit code<br><p>   (might be multiple if there are multiple containers not restricted<br><p>   by the 'containerName' field) is in the set of specified values.<br><p> - NotIn: the requirement is satisfied if at least one container exit code<br><p>   (might be multiple if there are multiple containers not restricted<br><p>   by the 'containerName' field) is not in the set of specified values.<br><p> Additional values are considered to be added in the future. Clients should react to an unknown operator by assuming the requirement is not satisfied.
+     */
     @JsonProperty("operator")
     public void setOperator(String operator) {
         this.operator = operator;
     }
 
+    /**
+     * Specifies the set of values. Each returned container exit code (might be multiple in case of multiple containers) is checked against this set of values with respect to the operator. The list of values must be ordered and must not contain duplicates. Value '0' cannot be used for the In operator. At least one element is required. At most 255 elements are allowed.
+     */
     @JsonProperty("values")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Integer> getValues() {
         return values;
     }
 
+    /**
+     * Specifies the set of values. Each returned container exit code (might be multiple in case of multiple containers) is checked against this set of values with respect to the operator. The list of values must be ordered and must not contain duplicates. Value '0' cannot be used for the In operator. At least one element is required. At most 255 elements are allowed.
+     */
     @JsonProperty("values")
     public void setValues(List<Integer> values) {
         this.values = values;
diff --git a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/PodFailurePolicyOnPodConditionsPattern.java b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/PodFailurePolicyOnPodConditionsPattern.java
index b2db8446262..abc6f1ba2aa 100644
--- a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/PodFailurePolicyOnPodConditionsPattern.java
+++ b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/PodFailurePolicyOnPodConditionsPattern.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodFailurePolicyOnPodConditionsPattern describes a pattern for matching an actual pod condition type.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PodFailurePolicyOnPodConditionsPattern(String status, String type) {
         this.type = type;
     }
 
+    /**
+     * Specifies the required Pod condition status. To match a pod condition it is required that the specified status equals the pod condition status. Defaults to True.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Specifies the required Pod condition status. To match a pod condition it is required that the specified status equals the pod condition status. Defaults to True.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Specifies the required Pod condition type. To match a pod condition it is required that specified type equals the pod condition type.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Specifies the required Pod condition type. To match a pod condition it is required that specified type equals the pod condition type.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/PodFailurePolicyRule.java b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/PodFailurePolicyRule.java
index 4d838a198ce..4d1661c9c98 100644
--- a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/PodFailurePolicyRule.java
+++ b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/PodFailurePolicyRule.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodFailurePolicyRule describes how a pod failure is handled when the requirements are met. One of onExitCodes and onPodConditions, but not both, can be used in each rule.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public PodFailurePolicyRule(String action, PodFailurePolicyOnExitCodesRequiremen
         this.onPodConditions = onPodConditions;
     }
 
+    /**
+     * Specifies the action taken on a pod failure when the requirements are satisfied. Possible values are:<br><p> <br><p> - FailJob: indicates that the pod's job is marked as Failed and all<br><p>   running pods are terminated.<br><p> - FailIndex: indicates that the pod's index is marked as Failed and will<br><p>   not be restarted.<br><p>   This value is beta-level. It can be used when the<br><p>   `JobBackoffLimitPerIndex` feature gate is enabled (enabled by default).<br><p> - Ignore: indicates that the counter towards the .backoffLimit is not<br><p>   incremented and a replacement pod is created.<br><p> - Count: indicates that the pod is handled in the default way - the<br><p>   counter towards the .backoffLimit is incremented.<br><p> Additional values are considered to be added in the future. Clients should react to an unknown action by skipping the rule.
+     */
     @JsonProperty("action")
     public String getAction() {
         return action;
     }
 
+    /**
+     * Specifies the action taken on a pod failure when the requirements are satisfied. Possible values are:<br><p> <br><p> - FailJob: indicates that the pod's job is marked as Failed and all<br><p>   running pods are terminated.<br><p> - FailIndex: indicates that the pod's index is marked as Failed and will<br><p>   not be restarted.<br><p>   This value is beta-level. It can be used when the<br><p>   `JobBackoffLimitPerIndex` feature gate is enabled (enabled by default).<br><p> - Ignore: indicates that the counter towards the .backoffLimit is not<br><p>   incremented and a replacement pod is created.<br><p> - Count: indicates that the pod is handled in the default way - the<br><p>   counter towards the .backoffLimit is incremented.<br><p> Additional values are considered to be added in the future. Clients should react to an unknown action by skipping the rule.
+     */
     @JsonProperty("action")
     public void setAction(String action) {
         this.action = action;
     }
 
+    /**
+     * PodFailurePolicyRule describes how a pod failure is handled when the requirements are met. One of onExitCodes and onPodConditions, but not both, can be used in each rule.
+     */
     @JsonProperty("onExitCodes")
     public PodFailurePolicyOnExitCodesRequirement getOnExitCodes() {
         return onExitCodes;
     }
 
+    /**
+     * PodFailurePolicyRule describes how a pod failure is handled when the requirements are met. One of onExitCodes and onPodConditions, but not both, can be used in each rule.
+     */
     @JsonProperty("onExitCodes")
     public void setOnExitCodes(PodFailurePolicyOnExitCodesRequirement onExitCodes) {
         this.onExitCodes = onExitCodes;
     }
 
+    /**
+     * Represents the requirement on the pod conditions. The requirement is represented as a list of pod condition patterns. The requirement is satisfied if at least one pattern matches an actual pod condition. At most 20 elements are allowed.
+     */
     @JsonProperty("onPodConditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PodFailurePolicyOnPodConditionsPattern> getOnPodConditions() {
         return onPodConditions;
     }
 
+    /**
+     * Represents the requirement on the pod conditions. The requirement is represented as a list of pod condition patterns. The requirement is satisfied if at least one pattern matches an actual pod condition. At most 20 elements are allowed.
+     */
     @JsonProperty("onPodConditions")
     public void setOnPodConditions(List<PodFailurePolicyOnPodConditionsPattern> onPodConditions) {
         this.onPodConditions = onPodConditions;
diff --git a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/SuccessPolicy.java b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/SuccessPolicy.java
index 4abed761202..de1c5226b13 100644
--- a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/SuccessPolicy.java
+++ b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/SuccessPolicy.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SuccessPolicy describes when a Job can be declared as succeeded based on the success of some indexes.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public SuccessPolicy(List<SuccessPolicyRule> rules) {
         this.rules = rules;
     }
 
+    /**
+     * rules represents the list of alternative rules for the declaring the Jobs as successful before `.status.succeeded &gt;= .spec.completions`. Once any of the rules are met, the "SucceededCriteriaMet" condition is added, and the lingering pods are removed. The terminal state for such a Job has the "Complete" condition. Additionally, these rules are evaluated in order; Once the Job meets one of the rules, other rules are ignored. At most 20 elements are allowed.
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SuccessPolicyRule> getRules() {
         return rules;
     }
 
+    /**
+     * rules represents the list of alternative rules for the declaring the Jobs as successful before `.status.succeeded &gt;= .spec.completions`. Once any of the rules are met, the "SucceededCriteriaMet" condition is added, and the lingering pods are removed. The terminal state for such a Job has the "Complete" condition. Additionally, these rules are evaluated in order; Once the Job meets one of the rules, other rules are ignored. At most 20 elements are allowed.
+     */
     @JsonProperty("rules")
     public void setRules(List<SuccessPolicyRule> rules) {
         this.rules = rules;
diff --git a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/SuccessPolicyRule.java b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/SuccessPolicyRule.java
index 072678ac391..f8dfc73f745 100644
--- a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/SuccessPolicyRule.java
+++ b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/SuccessPolicyRule.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SuccessPolicyRule describes rule for declaring a Job as succeeded. Each rule must have at least one of the "succeededIndexes" or "succeededCount" specified.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public SuccessPolicyRule(Integer succeededCount, String succeededIndexes) {
         this.succeededIndexes = succeededIndexes;
     }
 
+    /**
+     * succeededCount specifies the minimal required size of the actual set of the succeeded indexes for the Job. When succeededCount is used along with succeededIndexes, the check is constrained only to the set of indexes specified by succeededIndexes. For example, given that succeededIndexes is "1-4", succeededCount is "3", and completed indexes are "1", "3", and "5", the Job isn't declared as succeeded because only "1" and "3" indexes are considered in that rules. When this field is null, this doesn't default to any value and is never evaluated at any time. When specified it needs to be a positive integer.
+     */
     @JsonProperty("succeededCount")
     public Integer getSucceededCount() {
         return succeededCount;
     }
 
+    /**
+     * succeededCount specifies the minimal required size of the actual set of the succeeded indexes for the Job. When succeededCount is used along with succeededIndexes, the check is constrained only to the set of indexes specified by succeededIndexes. For example, given that succeededIndexes is "1-4", succeededCount is "3", and completed indexes are "1", "3", and "5", the Job isn't declared as succeeded because only "1" and "3" indexes are considered in that rules. When this field is null, this doesn't default to any value and is never evaluated at any time. When specified it needs to be a positive integer.
+     */
     @JsonProperty("succeededCount")
     public void setSucceededCount(Integer succeededCount) {
         this.succeededCount = succeededCount;
     }
 
+    /**
+     * succeededIndexes specifies the set of indexes which need to be contained in the actual set of the succeeded indexes for the Job. The list of indexes must be within 0 to ".spec.completions-1" and must not contain duplicates. At least one element is required. The indexes are represented as intervals separated by commas. The intervals can be a decimal integer or a pair of decimal integers separated by a hyphen. The number are listed in represented by the first and last element of the series, separated by a hyphen. For example, if the completed indexes are 1, 3, 4, 5 and 7, they are represented as "1,3-5,7". When this field is null, this field doesn't default to any value and is never evaluated at any time.
+     */
     @JsonProperty("succeededIndexes")
     public String getSucceededIndexes() {
         return succeededIndexes;
     }
 
+    /**
+     * succeededIndexes specifies the set of indexes which need to be contained in the actual set of the succeeded indexes for the Job. The list of indexes must be within 0 to ".spec.completions-1" and must not contain duplicates. At least one element is required. The indexes are represented as intervals separated by commas. The intervals can be a decimal integer or a pair of decimal integers separated by a hyphen. The number are listed in represented by the first and last element of the series, separated by a hyphen. For example, if the completed indexes are 1, 3, 4, 5 and 7, they are represented as "1,3-5,7". When this field is null, this field doesn't default to any value and is never evaluated at any time.
+     */
     @JsonProperty("succeededIndexes")
     public void setSucceededIndexes(String succeededIndexes) {
         this.succeededIndexes = succeededIndexes;
diff --git a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/UncountedTerminatedPods.java b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/UncountedTerminatedPods.java
index ee79e06420d..3989441df4a 100644
--- a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/UncountedTerminatedPods.java
+++ b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1/UncountedTerminatedPods.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UncountedTerminatedPods holds UIDs of Pods that have terminated but haven't been accounted in Job status counters.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public UncountedTerminatedPods(List<String> failed, List<String> succeeded) {
         this.succeeded = succeeded;
     }
 
+    /**
+     * failed holds UIDs of failed Pods.
+     */
     @JsonProperty("failed")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getFailed() {
         return failed;
     }
 
+    /**
+     * failed holds UIDs of failed Pods.
+     */
     @JsonProperty("failed")
     public void setFailed(List<String> failed) {
         this.failed = failed;
     }
 
+    /**
+     * succeeded holds UIDs of succeeded Pods.
+     */
     @JsonProperty("succeeded")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSucceeded() {
         return succeeded;
     }
 
+    /**
+     * succeeded holds UIDs of succeeded Pods.
+     */
     @JsonProperty("succeeded")
     public void setSucceeded(List<String> succeeded) {
         this.succeeded = succeeded;
diff --git a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1beta1/CronJob.java b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1beta1/CronJob.java
index 35d6c9e40be..1e288541744 100644
--- a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1beta1/CronJob.java
+++ b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1beta1/CronJob.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CronJob represents the configuration of a single cron job.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class CronJob implements Editable<CronJobBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "batch/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CronJob";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CronJob(String apiVersion, String kind, ObjectMeta metadata, CronJobSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CronJob represents the configuration of a single cron job.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CronJob represents the configuration of a single cron job.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * CronJob represents the configuration of a single cron job.
+     */
     @JsonProperty("spec")
     public CronJobSpec getSpec() {
         return spec;
     }
 
+    /**
+     * CronJob represents the configuration of a single cron job.
+     */
     @JsonProperty("spec")
     public void setSpec(CronJobSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * CronJob represents the configuration of a single cron job.
+     */
     @JsonProperty("status")
     public CronJobStatus getStatus() {
         return status;
     }
 
+    /**
+     * CronJob represents the configuration of a single cron job.
+     */
     @JsonProperty("status")
     public void setStatus(CronJobStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1beta1/CronJobList.java b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1beta1/CronJobList.java
index daea5e7dfea..cb320958f14 100644
--- a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1beta1/CronJobList.java
+++ b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1beta1/CronJobList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CronJobList is a collection of cron jobs.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class CronJobList implements Editable<CronJobListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.batch.v1beta1.CronJob>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "batch/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.batch.v1beta1.CronJob> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CronJobList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CronJobList(String apiVersion, List<io.fabric8.kubernetes.api.model.batch
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of CronJobs.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.batch.v1beta1.CronJob> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of CronJobs.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.batch.v1beta1.CronJob> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CronJobList is a collection of cron jobs.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CronJobList is a collection of cron jobs.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1beta1/CronJobSpec.java b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1beta1/CronJobSpec.java
index 23398d5f853..a8f16de26fc 100644
--- a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1beta1/CronJobSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1beta1/CronJobSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CronJobSpec describes how the job execution will look like and when it will actually run.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,71 +105,113 @@ public CronJobSpec(String concurrencyPolicy, Integer failedJobsHistoryLimit, Job
         this.suspend = suspend;
     }
 
+    /**
+     * Specifies how to treat concurrent executions of a Job. Valid values are: - "Allow" (default): allows CronJobs to run concurrently; - "Forbid": forbids concurrent runs, skipping next run if previous run hasn't finished yet; - "Replace": cancels currently running job and replaces it with a new one
+     */
     @JsonProperty("concurrencyPolicy")
     public String getConcurrencyPolicy() {
         return concurrencyPolicy;
     }
 
+    /**
+     * Specifies how to treat concurrent executions of a Job. Valid values are: - "Allow" (default): allows CronJobs to run concurrently; - "Forbid": forbids concurrent runs, skipping next run if previous run hasn't finished yet; - "Replace": cancels currently running job and replaces it with a new one
+     */
     @JsonProperty("concurrencyPolicy")
     public void setConcurrencyPolicy(String concurrencyPolicy) {
         this.concurrencyPolicy = concurrencyPolicy;
     }
 
+    /**
+     * The number of failed finished jobs to retain. This is a pointer to distinguish between explicit zero and not specified. Defaults to 1.
+     */
     @JsonProperty("failedJobsHistoryLimit")
     public Integer getFailedJobsHistoryLimit() {
         return failedJobsHistoryLimit;
     }
 
+    /**
+     * The number of failed finished jobs to retain. This is a pointer to distinguish between explicit zero and not specified. Defaults to 1.
+     */
     @JsonProperty("failedJobsHistoryLimit")
     public void setFailedJobsHistoryLimit(Integer failedJobsHistoryLimit) {
         this.failedJobsHistoryLimit = failedJobsHistoryLimit;
     }
 
+    /**
+     * CronJobSpec describes how the job execution will look like and when it will actually run.
+     */
     @JsonProperty("jobTemplate")
     public JobTemplateSpec getJobTemplate() {
         return jobTemplate;
     }
 
+    /**
+     * CronJobSpec describes how the job execution will look like and when it will actually run.
+     */
     @JsonProperty("jobTemplate")
     public void setJobTemplate(JobTemplateSpec jobTemplate) {
         this.jobTemplate = jobTemplate;
     }
 
+    /**
+     * The schedule in Cron format, see https://en.wikipedia.org/wiki/Cron.
+     */
     @JsonProperty("schedule")
     public String getSchedule() {
         return schedule;
     }
 
+    /**
+     * The schedule in Cron format, see https://en.wikipedia.org/wiki/Cron.
+     */
     @JsonProperty("schedule")
     public void setSchedule(String schedule) {
         this.schedule = schedule;
     }
 
+    /**
+     * Optional deadline in seconds for starting the job if it misses scheduled time for any reason.  Missed jobs executions will be counted as failed ones.
+     */
     @JsonProperty("startingDeadlineSeconds")
     public Long getStartingDeadlineSeconds() {
         return startingDeadlineSeconds;
     }
 
+    /**
+     * Optional deadline in seconds for starting the job if it misses scheduled time for any reason.  Missed jobs executions will be counted as failed ones.
+     */
     @JsonProperty("startingDeadlineSeconds")
     public void setStartingDeadlineSeconds(Long startingDeadlineSeconds) {
         this.startingDeadlineSeconds = startingDeadlineSeconds;
     }
 
+    /**
+     * The number of successful finished jobs to retain. This is a pointer to distinguish between explicit zero and not specified. Defaults to 3.
+     */
     @JsonProperty("successfulJobsHistoryLimit")
     public Integer getSuccessfulJobsHistoryLimit() {
         return successfulJobsHistoryLimit;
     }
 
+    /**
+     * The number of successful finished jobs to retain. This is a pointer to distinguish between explicit zero and not specified. Defaults to 3.
+     */
     @JsonProperty("successfulJobsHistoryLimit")
     public void setSuccessfulJobsHistoryLimit(Integer successfulJobsHistoryLimit) {
         this.successfulJobsHistoryLimit = successfulJobsHistoryLimit;
     }
 
+    /**
+     * This flag tells the controller to suspend subsequent executions, it does not apply to already started executions.  Defaults to false.
+     */
     @JsonProperty("suspend")
     public Boolean getSuspend() {
         return suspend;
     }
 
+    /**
+     * This flag tells the controller to suspend subsequent executions, it does not apply to already started executions.  Defaults to false.
+     */
     @JsonProperty("suspend")
     public void setSuspend(Boolean suspend) {
         this.suspend = suspend;
diff --git a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1beta1/CronJobStatus.java b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1beta1/CronJobStatus.java
index 99bb13dc11d..9c295005041 100644
--- a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1beta1/CronJobStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1beta1/CronJobStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CronJobStatus represents the current state of a cron job.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public CronJobStatus(List<ObjectReference> active, String lastScheduleTime, Stri
         this.lastSuccessfulTime = lastSuccessfulTime;
     }
 
+    /**
+     * A list of pointers to currently running jobs.
+     */
     @JsonProperty("active")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ObjectReference> getActive() {
         return active;
     }
 
+    /**
+     * A list of pointers to currently running jobs.
+     */
     @JsonProperty("active")
     public void setActive(List<ObjectReference> active) {
         this.active = active;
     }
 
+    /**
+     * CronJobStatus represents the current state of a cron job.
+     */
     @JsonProperty("lastScheduleTime")
     public String getLastScheduleTime() {
         return lastScheduleTime;
     }
 
+    /**
+     * CronJobStatus represents the current state of a cron job.
+     */
     @JsonProperty("lastScheduleTime")
     public void setLastScheduleTime(String lastScheduleTime) {
         this.lastScheduleTime = lastScheduleTime;
     }
 
+    /**
+     * CronJobStatus represents the current state of a cron job.
+     */
     @JsonProperty("lastSuccessfulTime")
     public String getLastSuccessfulTime() {
         return lastSuccessfulTime;
     }
 
+    /**
+     * CronJobStatus represents the current state of a cron job.
+     */
     @JsonProperty("lastSuccessfulTime")
     public void setLastSuccessfulTime(String lastSuccessfulTime) {
         this.lastSuccessfulTime = lastSuccessfulTime;
diff --git a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1beta1/JobTemplateSpec.java b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1beta1/JobTemplateSpec.java
index ed944cd6f47..73d57bc1da6 100644
--- a/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1beta1/JobTemplateSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-batch/src/generated/java/io/fabric8/kubernetes/api/model/batch/v1beta1/JobTemplateSpec.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JobTemplateSpec describes the data a Job should have when created from a template
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public JobTemplateSpec(ObjectMeta metadata, JobSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * JobTemplateSpec describes the data a Job should have when created from a template
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * JobTemplateSpec describes the data a Job should have when created from a template
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * JobTemplateSpec describes the data a Job should have when created from a template
+     */
     @JsonProperty("spec")
     public JobSpec getSpec() {
         return spec;
     }
 
+    /**
+     * JobTemplateSpec describes the data a Job should have when created from a template
+     */
     @JsonProperty("spec")
     public void setSpec(JobSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1/CertificateSigningRequest.java b/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1/CertificateSigningRequest.java
index e9dc7a15697..ca400570992 100644
--- a/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1/CertificateSigningRequest.java
+++ b/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1/CertificateSigningRequest.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CertificateSigningRequest objects provide a mechanism to obtain x509 certificates by submitting a certificate signing request, and having it asynchronously approved and issued.<br><p> <br><p> Kubelets use this API to obtain:<br><p>  1. client certificates to authenticate to kube-apiserver (with the "kubernetes.io/kube-apiserver-client-kubelet" signerName).<br><p>  2. serving certificates for TLS endpoints kube-apiserver can connect to securely (with the "kubernetes.io/kubelet-serving" signerName).<br><p> <br><p> This API can be used to request client certificates to authenticate to kube-apiserver (with the "kubernetes.io/kube-apiserver-client" signerName), or to obtain certificates from custom non-Kubernetes signers.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class CertificateSigningRequest implements Editable<CertificateSigningRequestBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "certificates.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CertificateSigningRequest";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public CertificateSigningRequest(String apiVersion, String kind, ObjectMeta meta
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CertificateSigningRequest objects provide a mechanism to obtain x509 certificates by submitting a certificate signing request, and having it asynchronously approved and issued.<br><p> <br><p> Kubelets use this API to obtain:<br><p>  1. client certificates to authenticate to kube-apiserver (with the "kubernetes.io/kube-apiserver-client-kubelet" signerName).<br><p>  2. serving certificates for TLS endpoints kube-apiserver can connect to securely (with the "kubernetes.io/kubelet-serving" signerName).<br><p> <br><p> This API can be used to request client certificates to authenticate to kube-apiserver (with the "kubernetes.io/kube-apiserver-client" signerName), or to obtain certificates from custom non-Kubernetes signers.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CertificateSigningRequest objects provide a mechanism to obtain x509 certificates by submitting a certificate signing request, and having it asynchronously approved and issued.<br><p> <br><p> Kubelets use this API to obtain:<br><p>  1. client certificates to authenticate to kube-apiserver (with the "kubernetes.io/kube-apiserver-client-kubelet" signerName).<br><p>  2. serving certificates for TLS endpoints kube-apiserver can connect to securely (with the "kubernetes.io/kubelet-serving" signerName).<br><p> <br><p> This API can be used to request client certificates to authenticate to kube-apiserver (with the "kubernetes.io/kube-apiserver-client" signerName), or to obtain certificates from custom non-Kubernetes signers.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * CertificateSigningRequest objects provide a mechanism to obtain x509 certificates by submitting a certificate signing request, and having it asynchronously approved and issued.<br><p> <br><p> Kubelets use this API to obtain:<br><p>  1. client certificates to authenticate to kube-apiserver (with the "kubernetes.io/kube-apiserver-client-kubelet" signerName).<br><p>  2. serving certificates for TLS endpoints kube-apiserver can connect to securely (with the "kubernetes.io/kubelet-serving" signerName).<br><p> <br><p> This API can be used to request client certificates to authenticate to kube-apiserver (with the "kubernetes.io/kube-apiserver-client" signerName), or to obtain certificates from custom non-Kubernetes signers.
+     */
     @JsonProperty("spec")
     public CertificateSigningRequestSpec getSpec() {
         return spec;
     }
 
+    /**
+     * CertificateSigningRequest objects provide a mechanism to obtain x509 certificates by submitting a certificate signing request, and having it asynchronously approved and issued.<br><p> <br><p> Kubelets use this API to obtain:<br><p>  1. client certificates to authenticate to kube-apiserver (with the "kubernetes.io/kube-apiserver-client-kubelet" signerName).<br><p>  2. serving certificates for TLS endpoints kube-apiserver can connect to securely (with the "kubernetes.io/kubelet-serving" signerName).<br><p> <br><p> This API can be used to request client certificates to authenticate to kube-apiserver (with the "kubernetes.io/kube-apiserver-client" signerName), or to obtain certificates from custom non-Kubernetes signers.
+     */
     @JsonProperty("spec")
     public void setSpec(CertificateSigningRequestSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * CertificateSigningRequest objects provide a mechanism to obtain x509 certificates by submitting a certificate signing request, and having it asynchronously approved and issued.<br><p> <br><p> Kubelets use this API to obtain:<br><p>  1. client certificates to authenticate to kube-apiserver (with the "kubernetes.io/kube-apiserver-client-kubelet" signerName).<br><p>  2. serving certificates for TLS endpoints kube-apiserver can connect to securely (with the "kubernetes.io/kubelet-serving" signerName).<br><p> <br><p> This API can be used to request client certificates to authenticate to kube-apiserver (with the "kubernetes.io/kube-apiserver-client" signerName), or to obtain certificates from custom non-Kubernetes signers.
+     */
     @JsonProperty("status")
     public CertificateSigningRequestStatus getStatus() {
         return status;
     }
 
+    /**
+     * CertificateSigningRequest objects provide a mechanism to obtain x509 certificates by submitting a certificate signing request, and having it asynchronously approved and issued.<br><p> <br><p> Kubelets use this API to obtain:<br><p>  1. client certificates to authenticate to kube-apiserver (with the "kubernetes.io/kube-apiserver-client-kubelet" signerName).<br><p>  2. serving certificates for TLS endpoints kube-apiserver can connect to securely (with the "kubernetes.io/kubelet-serving" signerName).<br><p> <br><p> This API can be used to request client certificates to authenticate to kube-apiserver (with the "kubernetes.io/kube-apiserver-client" signerName), or to obtain certificates from custom non-Kubernetes signers.
+     */
     @JsonProperty("status")
     public void setStatus(CertificateSigningRequestStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1/CertificateSigningRequestCondition.java b/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1/CertificateSigningRequestCondition.java
index 9206658439b..e589ed13a6d 100644
--- a/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1/CertificateSigningRequestCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1/CertificateSigningRequestCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CertificateSigningRequestCondition describes a condition of a CertificateSigningRequest object
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public CertificateSigningRequestCondition(String lastTransitionTime, String last
         this.type = type;
     }
 
+    /**
+     * CertificateSigningRequestCondition describes a condition of a CertificateSigningRequest object
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * CertificateSigningRequestCondition describes a condition of a CertificateSigningRequest object
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * CertificateSigningRequestCondition describes a condition of a CertificateSigningRequest object
+     */
     @JsonProperty("lastUpdateTime")
     public String getLastUpdateTime() {
         return lastUpdateTime;
     }
 
+    /**
+     * CertificateSigningRequestCondition describes a condition of a CertificateSigningRequest object
+     */
     @JsonProperty("lastUpdateTime")
     public void setLastUpdateTime(String lastUpdateTime) {
         this.lastUpdateTime = lastUpdateTime;
     }
 
+    /**
+     * message contains a human readable message with details about the request state
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message contains a human readable message with details about the request state
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * reason indicates a brief reason for the request state
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * reason indicates a brief reason for the request state
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * status of the condition, one of True, False, Unknown. Approved, Denied, and Failed conditions may not be "False" or "Unknown".
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * status of the condition, one of True, False, Unknown. Approved, Denied, and Failed conditions may not be "False" or "Unknown".
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * type of the condition. Known conditions are "Approved", "Denied", and "Failed".<br><p> <br><p> An "Approved" condition is added via the /approval subresource, indicating the request was approved and should be issued by the signer.<br><p> <br><p> A "Denied" condition is added via the /approval subresource, indicating the request was denied and should not be issued by the signer.<br><p> <br><p> A "Failed" condition is added via the /status subresource, indicating the signer failed to issue the certificate.<br><p> <br><p> Approved and Denied conditions are mutually exclusive. Approved, Denied, and Failed conditions cannot be removed once added.<br><p> <br><p> Only one condition of a given type is allowed.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type of the condition. Known conditions are "Approved", "Denied", and "Failed".<br><p> <br><p> An "Approved" condition is added via the /approval subresource, indicating the request was approved and should be issued by the signer.<br><p> <br><p> A "Denied" condition is added via the /approval subresource, indicating the request was denied and should not be issued by the signer.<br><p> <br><p> A "Failed" condition is added via the /status subresource, indicating the signer failed to issue the certificate.<br><p> <br><p> Approved and Denied conditions are mutually exclusive. Approved, Denied, and Failed conditions cannot be removed once added.<br><p> <br><p> Only one condition of a given type is allowed.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1/CertificateSigningRequestList.java b/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1/CertificateSigningRequestList.java
index 6f2388d822a..9d244a81d88 100644
--- a/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1/CertificateSigningRequestList.java
+++ b/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1/CertificateSigningRequestList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CertificateSigningRequestList is a collection of CertificateSigningRequest objects
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class CertificateSigningRequestList implements Editable<CertificateSigningRequestListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.certificates.v1.CertificateSigningRequest>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "certificates.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.certificates.v1.CertificateSigningRequest> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CertificateSigningRequestList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CertificateSigningRequestList(String apiVersion, List<io.fabric8.kubernet
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is a collection of CertificateSigningRequest objects
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.certificates.v1.CertificateSigningRequest> getItems() {
         return items;
     }
 
+    /**
+     * items is a collection of CertificateSigningRequest objects
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.certificates.v1.CertificateSigningRequest> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CertificateSigningRequestList is a collection of CertificateSigningRequest objects
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CertificateSigningRequestList is a collection of CertificateSigningRequest objects
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1/CertificateSigningRequestSpec.java b/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1/CertificateSigningRequestSpec.java
index dce18ba1845..a9e4bf02235 100644
--- a/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1/CertificateSigningRequestSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1/CertificateSigningRequestSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CertificateSigningRequestSpec contains the certificate request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -111,84 +114,132 @@ public CertificateSigningRequestSpec(Integer expirationSeconds, Map<String, List
         this.username = username;
     }
 
+    /**
+     * expirationSeconds is the requested duration of validity of the issued certificate. The certificate signer may issue a certificate with a different validity duration so a client must check the delta between the notBefore and and notAfter fields in the issued certificate to determine the actual duration.<br><p> <br><p> The v1.22+ in-tree implementations of the well-known Kubernetes signers will honor this field as long as the requested duration is not greater than the maximum duration they will honor per the --cluster-signing-duration CLI flag to the Kubernetes controller manager.<br><p> <br><p> Certificate signers may not honor this field for various reasons:<br><p> <br><p>   1. Old signer that is unaware of the field (such as the in-tree<br><p>      implementations prior to v1.22)<br><p>   2. Signer whose configured maximum is shorter than the requested duration<br><p>   3. Signer whose configured minimum is longer than the requested duration<br><p> <br><p> The minimum valid value for expirationSeconds is 600, i.e. 10 minutes.
+     */
     @JsonProperty("expirationSeconds")
     public Integer getExpirationSeconds() {
         return expirationSeconds;
     }
 
+    /**
+     * expirationSeconds is the requested duration of validity of the issued certificate. The certificate signer may issue a certificate with a different validity duration so a client must check the delta between the notBefore and and notAfter fields in the issued certificate to determine the actual duration.<br><p> <br><p> The v1.22+ in-tree implementations of the well-known Kubernetes signers will honor this field as long as the requested duration is not greater than the maximum duration they will honor per the --cluster-signing-duration CLI flag to the Kubernetes controller manager.<br><p> <br><p> Certificate signers may not honor this field for various reasons:<br><p> <br><p>   1. Old signer that is unaware of the field (such as the in-tree<br><p>      implementations prior to v1.22)<br><p>   2. Signer whose configured maximum is shorter than the requested duration<br><p>   3. Signer whose configured minimum is longer than the requested duration<br><p> <br><p> The minimum valid value for expirationSeconds is 600, i.e. 10 minutes.
+     */
     @JsonProperty("expirationSeconds")
     public void setExpirationSeconds(Integer expirationSeconds) {
         this.expirationSeconds = expirationSeconds;
     }
 
+    /**
+     * extra contains extra attributes of the user that created the CertificateSigningRequest. Populated by the API server on creation and immutable.
+     */
     @JsonProperty("extra")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<String>> getExtra() {
         return extra;
     }
 
+    /**
+     * extra contains extra attributes of the user that created the CertificateSigningRequest. Populated by the API server on creation and immutable.
+     */
     @JsonProperty("extra")
     public void setExtra(Map<String, List<String>> extra) {
         this.extra = extra;
     }
 
+    /**
+     * groups contains group membership of the user that created the CertificateSigningRequest. Populated by the API server on creation and immutable.
+     */
     @JsonProperty("groups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getGroups() {
         return groups;
     }
 
+    /**
+     * groups contains group membership of the user that created the CertificateSigningRequest. Populated by the API server on creation and immutable.
+     */
     @JsonProperty("groups")
     public void setGroups(List<String> groups) {
         this.groups = groups;
     }
 
+    /**
+     * request contains an x509 certificate signing request encoded in a "CERTIFICATE REQUEST" PEM block. When serialized as JSON or YAML, the data is additionally base64-encoded.
+     */
     @JsonProperty("request")
     public String getRequest() {
         return request;
     }
 
+    /**
+     * request contains an x509 certificate signing request encoded in a "CERTIFICATE REQUEST" PEM block. When serialized as JSON or YAML, the data is additionally base64-encoded.
+     */
     @JsonProperty("request")
     public void setRequest(String request) {
         this.request = request;
     }
 
+    /**
+     * signerName indicates the requested signer, and is a qualified name.<br><p> <br><p> List/watch requests for CertificateSigningRequests can filter on this field using a "spec.signerName=NAME" fieldSelector.<br><p> <br><p> Well-known Kubernetes signers are:<br><p>  1. "kubernetes.io/kube-apiserver-client": issues client certificates that can be used to authenticate to kube-apiserver.<br><p>   Requests for this signer are never auto-approved by kube-controller-manager, can be issued by the "csrsigning" controller in kube-controller-manager.<br><p>  2. "kubernetes.io/kube-apiserver-client-kubelet": issues client certificates that kubelets use to authenticate to kube-apiserver.<br><p>   Requests for this signer can be auto-approved by the "csrapproving" controller in kube-controller-manager, and can be issued by the "csrsigning" controller in kube-controller-manager.<br><p>  3. "kubernetes.io/kubelet-serving" issues serving certificates that kubelets use to serve TLS endpoints, which kube-apiserver can connect to securely.<br><p>   Requests for this signer are never auto-approved by kube-controller-manager, and can be issued by the "csrsigning" controller in kube-controller-manager.<br><p> <br><p> More details are available at https://k8s.io/docs/reference/access-authn-authz/certificate-signing-requests/#kubernetes-signers<br><p> <br><p> Custom signerNames can also be specified. The signer defines:<br><p>  1. Trust distribution: how trust (CA bundles) are distributed.<br><p>  2. Permitted subjects: and behavior when a disallowed subject is requested.<br><p>  3. Required, permitted, or forbidden x509 extensions in the request (including whether subjectAltNames are allowed, which types, restrictions on allowed values) and behavior when a disallowed extension is requested.<br><p>  4. Required, permitted, or forbidden key usages / extended key usages.<br><p>  5. Expiration/certificate lifetime: whether it is fixed by the signer, configurable by the admin.<br><p>  6. Whether or not requests for CA certificates are allowed.
+     */
     @JsonProperty("signerName")
     public String getSignerName() {
         return signerName;
     }
 
+    /**
+     * signerName indicates the requested signer, and is a qualified name.<br><p> <br><p> List/watch requests for CertificateSigningRequests can filter on this field using a "spec.signerName=NAME" fieldSelector.<br><p> <br><p> Well-known Kubernetes signers are:<br><p>  1. "kubernetes.io/kube-apiserver-client": issues client certificates that can be used to authenticate to kube-apiserver.<br><p>   Requests for this signer are never auto-approved by kube-controller-manager, can be issued by the "csrsigning" controller in kube-controller-manager.<br><p>  2. "kubernetes.io/kube-apiserver-client-kubelet": issues client certificates that kubelets use to authenticate to kube-apiserver.<br><p>   Requests for this signer can be auto-approved by the "csrapproving" controller in kube-controller-manager, and can be issued by the "csrsigning" controller in kube-controller-manager.<br><p>  3. "kubernetes.io/kubelet-serving" issues serving certificates that kubelets use to serve TLS endpoints, which kube-apiserver can connect to securely.<br><p>   Requests for this signer are never auto-approved by kube-controller-manager, and can be issued by the "csrsigning" controller in kube-controller-manager.<br><p> <br><p> More details are available at https://k8s.io/docs/reference/access-authn-authz/certificate-signing-requests/#kubernetes-signers<br><p> <br><p> Custom signerNames can also be specified. The signer defines:<br><p>  1. Trust distribution: how trust (CA bundles) are distributed.<br><p>  2. Permitted subjects: and behavior when a disallowed subject is requested.<br><p>  3. Required, permitted, or forbidden x509 extensions in the request (including whether subjectAltNames are allowed, which types, restrictions on allowed values) and behavior when a disallowed extension is requested.<br><p>  4. Required, permitted, or forbidden key usages / extended key usages.<br><p>  5. Expiration/certificate lifetime: whether it is fixed by the signer, configurable by the admin.<br><p>  6. Whether or not requests for CA certificates are allowed.
+     */
     @JsonProperty("signerName")
     public void setSignerName(String signerName) {
         this.signerName = signerName;
     }
 
+    /**
+     * uid contains the uid of the user that created the CertificateSigningRequest. Populated by the API server on creation and immutable.
+     */
     @JsonProperty("uid")
     public String getUid() {
         return uid;
     }
 
+    /**
+     * uid contains the uid of the user that created the CertificateSigningRequest. Populated by the API server on creation and immutable.
+     */
     @JsonProperty("uid")
     public void setUid(String uid) {
         this.uid = uid;
     }
 
+    /**
+     * usages specifies a set of key usages requested in the issued certificate.<br><p> <br><p> Requests for TLS client certificates typically request: "digital signature", "key encipherment", "client auth".<br><p> <br><p> Requests for TLS serving certificates typically request: "key encipherment", "digital signature", "server auth".<br><p> <br><p> Valid values are:<br><p>  "signing", "digital signature", "content commitment",<br><p>  "key encipherment", "key agreement", "data encipherment",<br><p>  "cert sign", "crl sign", "encipher only", "decipher only", "any",<br><p>  "server auth", "client auth",<br><p>  "code signing", "email protection", "s/mime",<br><p>  "ipsec end system", "ipsec tunnel", "ipsec user",<br><p>  "timestamping", "ocsp signing", "microsoft sgc", "netscape sgc"
+     */
     @JsonProperty("usages")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getUsages() {
         return usages;
     }
 
+    /**
+     * usages specifies a set of key usages requested in the issued certificate.<br><p> <br><p> Requests for TLS client certificates typically request: "digital signature", "key encipherment", "client auth".<br><p> <br><p> Requests for TLS serving certificates typically request: "key encipherment", "digital signature", "server auth".<br><p> <br><p> Valid values are:<br><p>  "signing", "digital signature", "content commitment",<br><p>  "key encipherment", "key agreement", "data encipherment",<br><p>  "cert sign", "crl sign", "encipher only", "decipher only", "any",<br><p>  "server auth", "client auth",<br><p>  "code signing", "email protection", "s/mime",<br><p>  "ipsec end system", "ipsec tunnel", "ipsec user",<br><p>  "timestamping", "ocsp signing", "microsoft sgc", "netscape sgc"
+     */
     @JsonProperty("usages")
     public void setUsages(List<String> usages) {
         this.usages = usages;
     }
 
+    /**
+     * username contains the name of the user that created the CertificateSigningRequest. Populated by the API server on creation and immutable.
+     */
     @JsonProperty("username")
     public String getUsername() {
         return username;
     }
 
+    /**
+     * username contains the name of the user that created the CertificateSigningRequest. Populated by the API server on creation and immutable.
+     */
     @JsonProperty("username")
     public void setUsername(String username) {
         this.username = username;
diff --git a/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1/CertificateSigningRequestStatus.java b/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1/CertificateSigningRequestStatus.java
index 3d31628951d..3b38ae9ba52 100644
--- a/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1/CertificateSigningRequestStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1/CertificateSigningRequestStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CertificateSigningRequestStatus contains conditions used to indicate approved/denied/failed status of the request, and the issued certificate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public CertificateSigningRequestStatus(String certificate, List<CertificateSigni
         this.conditions = conditions;
     }
 
+    /**
+     * certificate is populated with an issued certificate by the signer after an Approved condition is present. This field is set via the /status subresource. Once populated, this field is immutable.<br><p> <br><p> If the certificate signing request is denied, a condition of type "Denied" is added and this field remains empty. If the signer cannot issue the certificate, a condition of type "Failed" is added and this field remains empty.<br><p> <br><p> Validation requirements:<br><p>  1. certificate must contain one or more PEM blocks.<br><p>  2. All PEM blocks must have the "CERTIFICATE" label, contain no headers, and the encoded data<br><p>   must be a BER-encoded ASN.1 Certificate structure as described in section 4 of RFC5280.<br><p>  3. Non-PEM content may appear before or after the "CERTIFICATE" PEM blocks and is unvalidated,<br><p>   to allow for explanatory text as described in section 5.2 of RFC7468.<br><p> <br><p> If more than one PEM block is present, and the definition of the requested spec.signerName does not indicate otherwise, the first block is the issued certificate, and subsequent blocks should be treated as intermediate certificates and presented in TLS handshakes.<br><p> <br><p> The certificate is encoded in PEM format.<br><p> <br><p> When serialized as JSON or YAML, the data is additionally base64-encoded, so it consists of:<br><p> <br><p>     base64(<br><p>     -----BEGIN CERTIFICATE-----<br><p>     ...<br><p>     -----END CERTIFICATE-----<br><p>     )
+     */
     @JsonProperty("certificate")
     public String getCertificate() {
         return certificate;
     }
 
+    /**
+     * certificate is populated with an issued certificate by the signer after an Approved condition is present. This field is set via the /status subresource. Once populated, this field is immutable.<br><p> <br><p> If the certificate signing request is denied, a condition of type "Denied" is added and this field remains empty. If the signer cannot issue the certificate, a condition of type "Failed" is added and this field remains empty.<br><p> <br><p> Validation requirements:<br><p>  1. certificate must contain one or more PEM blocks.<br><p>  2. All PEM blocks must have the "CERTIFICATE" label, contain no headers, and the encoded data<br><p>   must be a BER-encoded ASN.1 Certificate structure as described in section 4 of RFC5280.<br><p>  3. Non-PEM content may appear before or after the "CERTIFICATE" PEM blocks and is unvalidated,<br><p>   to allow for explanatory text as described in section 5.2 of RFC7468.<br><p> <br><p> If more than one PEM block is present, and the definition of the requested spec.signerName does not indicate otherwise, the first block is the issued certificate, and subsequent blocks should be treated as intermediate certificates and presented in TLS handshakes.<br><p> <br><p> The certificate is encoded in PEM format.<br><p> <br><p> When serialized as JSON or YAML, the data is additionally base64-encoded, so it consists of:<br><p> <br><p>     base64(<br><p>     -----BEGIN CERTIFICATE-----<br><p>     ...<br><p>     -----END CERTIFICATE-----<br><p>     )
+     */
     @JsonProperty("certificate")
     public void setCertificate(String certificate) {
         this.certificate = certificate;
     }
 
+    /**
+     * conditions applied to the request. Known conditions are "Approved", "Denied", and "Failed".
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CertificateSigningRequestCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions applied to the request. Known conditions are "Approved", "Denied", and "Failed".
+     */
     @JsonProperty("conditions")
     public void setConditions(List<CertificateSigningRequestCondition> conditions) {
         this.conditions = conditions;
diff --git a/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1alpha1/ClusterTrustBundle.java b/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1alpha1/ClusterTrustBundle.java
index 3690b3c1b38..6e1acb77e8a 100644
--- a/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1alpha1/ClusterTrustBundle.java
+++ b/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1alpha1/ClusterTrustBundle.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterTrustBundle is a cluster-scoped container for X.509 trust anchors (root certificates).<br><p> <br><p> ClusterTrustBundle objects are considered to be readable by any authenticated user in the cluster, because they can be mounted by pods using the `clusterTrustBundle` projection.  All service accounts have read access to ClusterTrustBundles by default.  Users who only have namespace-level access to a cluster can read ClusterTrustBundles by impersonating a serviceaccount that they have access to.<br><p> <br><p> It can be optionally associated with a particular assigner, in which case it contains one valid set of trust anchors for that signer. Signers may have multiple associated ClusterTrustBundles; each is an independent set of trust anchors for that signer. Admission control is used to enforce that only users with permissions on the signer can create or modify the corresponding bundle.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class ClusterTrustBundle implements Editable<ClusterTrustBundleBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "certificates.k8s.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterTrustBundle";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public ClusterTrustBundle(String apiVersion, String kind, ObjectMeta metadata, C
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterTrustBundle is a cluster-scoped container for X.509 trust anchors (root certificates).<br><p> <br><p> ClusterTrustBundle objects are considered to be readable by any authenticated user in the cluster, because they can be mounted by pods using the `clusterTrustBundle` projection.  All service accounts have read access to ClusterTrustBundles by default.  Users who only have namespace-level access to a cluster can read ClusterTrustBundles by impersonating a serviceaccount that they have access to.<br><p> <br><p> It can be optionally associated with a particular assigner, in which case it contains one valid set of trust anchors for that signer. Signers may have multiple associated ClusterTrustBundles; each is an independent set of trust anchors for that signer. Admission control is used to enforce that only users with permissions on the signer can create or modify the corresponding bundle.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterTrustBundle is a cluster-scoped container for X.509 trust anchors (root certificates).<br><p> <br><p> ClusterTrustBundle objects are considered to be readable by any authenticated user in the cluster, because they can be mounted by pods using the `clusterTrustBundle` projection.  All service accounts have read access to ClusterTrustBundles by default.  Users who only have namespace-level access to a cluster can read ClusterTrustBundles by impersonating a serviceaccount that they have access to.<br><p> <br><p> It can be optionally associated with a particular assigner, in which case it contains one valid set of trust anchors for that signer. Signers may have multiple associated ClusterTrustBundles; each is an independent set of trust anchors for that signer. Admission control is used to enforce that only users with permissions on the signer can create or modify the corresponding bundle.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ClusterTrustBundle is a cluster-scoped container for X.509 trust anchors (root certificates).<br><p> <br><p> ClusterTrustBundle objects are considered to be readable by any authenticated user in the cluster, because they can be mounted by pods using the `clusterTrustBundle` projection.  All service accounts have read access to ClusterTrustBundles by default.  Users who only have namespace-level access to a cluster can read ClusterTrustBundles by impersonating a serviceaccount that they have access to.<br><p> <br><p> It can be optionally associated with a particular assigner, in which case it contains one valid set of trust anchors for that signer. Signers may have multiple associated ClusterTrustBundles; each is an independent set of trust anchors for that signer. Admission control is used to enforce that only users with permissions on the signer can create or modify the corresponding bundle.
+     */
     @JsonProperty("spec")
     public ClusterTrustBundleSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ClusterTrustBundle is a cluster-scoped container for X.509 trust anchors (root certificates).<br><p> <br><p> ClusterTrustBundle objects are considered to be readable by any authenticated user in the cluster, because they can be mounted by pods using the `clusterTrustBundle` projection.  All service accounts have read access to ClusterTrustBundles by default.  Users who only have namespace-level access to a cluster can read ClusterTrustBundles by impersonating a serviceaccount that they have access to.<br><p> <br><p> It can be optionally associated with a particular assigner, in which case it contains one valid set of trust anchors for that signer. Signers may have multiple associated ClusterTrustBundles; each is an independent set of trust anchors for that signer. Admission control is used to enforce that only users with permissions on the signer can create or modify the corresponding bundle.
+     */
     @JsonProperty("spec")
     public void setSpec(ClusterTrustBundleSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1alpha1/ClusterTrustBundleList.java b/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1alpha1/ClusterTrustBundleList.java
index f66a25c6946..6ebfd04665f 100644
--- a/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1alpha1/ClusterTrustBundleList.java
+++ b/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1alpha1/ClusterTrustBundleList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterTrustBundleList is a collection of ClusterTrustBundle objects
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ClusterTrustBundleList implements Editable<ClusterTrustBundleListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.certificates.v1alpha1.ClusterTrustBundle>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "certificates.k8s.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.certificates.v1alpha1.ClusterTrustBundle> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterTrustBundleList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterTrustBundleList(String apiVersion, List<io.fabric8.kubernetes.api.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is a collection of ClusterTrustBundle objects
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.certificates.v1alpha1.ClusterTrustBundle> getItems() {
         return items;
     }
 
+    /**
+     * items is a collection of ClusterTrustBundle objects
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.certificates.v1alpha1.ClusterTrustBundle> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterTrustBundleList is a collection of ClusterTrustBundle objects
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterTrustBundleList is a collection of ClusterTrustBundle objects
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1alpha1/ClusterTrustBundleSpec.java b/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1alpha1/ClusterTrustBundleSpec.java
index 7e752865b63..dc14cc5028d 100644
--- a/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1alpha1/ClusterTrustBundleSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1alpha1/ClusterTrustBundleSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterTrustBundleSpec contains the signer and trust anchors.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ClusterTrustBundleSpec(String signerName, String trustBundle) {
         this.trustBundle = trustBundle;
     }
 
+    /**
+     * signerName indicates the associated signer, if any.<br><p> <br><p> In order to create or update a ClusterTrustBundle that sets signerName, you must have the following cluster-scoped permission: group=certificates.k8s.io resource=signers resourceName=&lt;the signer name&gt; verb=attest.<br><p> <br><p> If signerName is not empty, then the ClusterTrustBundle object must be named with the signer name as a prefix (translating slashes to colons). For example, for the signer name `example.com/foo`, valid ClusterTrustBundle object names include `example.com:foo:abc` and `example.com:foo:v1`.<br><p> <br><p> If signerName is empty, then the ClusterTrustBundle object's name must not have such a prefix.<br><p> <br><p> List/watch requests for ClusterTrustBundles can filter on this field using a `spec.signerName=NAME` field selector.
+     */
     @JsonProperty("signerName")
     public String getSignerName() {
         return signerName;
     }
 
+    /**
+     * signerName indicates the associated signer, if any.<br><p> <br><p> In order to create or update a ClusterTrustBundle that sets signerName, you must have the following cluster-scoped permission: group=certificates.k8s.io resource=signers resourceName=&lt;the signer name&gt; verb=attest.<br><p> <br><p> If signerName is not empty, then the ClusterTrustBundle object must be named with the signer name as a prefix (translating slashes to colons). For example, for the signer name `example.com/foo`, valid ClusterTrustBundle object names include `example.com:foo:abc` and `example.com:foo:v1`.<br><p> <br><p> If signerName is empty, then the ClusterTrustBundle object's name must not have such a prefix.<br><p> <br><p> List/watch requests for ClusterTrustBundles can filter on this field using a `spec.signerName=NAME` field selector.
+     */
     @JsonProperty("signerName")
     public void setSignerName(String signerName) {
         this.signerName = signerName;
     }
 
+    /**
+     * trustBundle contains the individual X.509 trust anchors for this bundle, as PEM bundle of PEM-wrapped, DER-formatted X.509 certificates.<br><p> <br><p> The data must consist only of PEM certificate blocks that parse as valid X.509 certificates.  Each certificate must include a basic constraints extension with the CA bit set.  The API server will reject objects that contain duplicate certificates, or that use PEM block headers.<br><p> <br><p> Users of ClusterTrustBundles, including Kubelet, are free to reorder and deduplicate certificate blocks in this file according to their own logic, as well as to drop PEM block headers and inter-block data.
+     */
     @JsonProperty("trustBundle")
     public String getTrustBundle() {
         return trustBundle;
     }
 
+    /**
+     * trustBundle contains the individual X.509 trust anchors for this bundle, as PEM bundle of PEM-wrapped, DER-formatted X.509 certificates.<br><p> <br><p> The data must consist only of PEM certificate blocks that parse as valid X.509 certificates.  Each certificate must include a basic constraints extension with the CA bit set.  The API server will reject objects that contain duplicate certificates, or that use PEM block headers.<br><p> <br><p> Users of ClusterTrustBundles, including Kubelet, are free to reorder and deduplicate certificate blocks in this file according to their own logic, as well as to drop PEM block headers and inter-block data.
+     */
     @JsonProperty("trustBundle")
     public void setTrustBundle(String trustBundle) {
         this.trustBundle = trustBundle;
diff --git a/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1beta1/CertificateSigningRequest.java b/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1beta1/CertificateSigningRequest.java
index 3008facc6d0..4182dc0e657 100644
--- a/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1beta1/CertificateSigningRequest.java
+++ b/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1beta1/CertificateSigningRequest.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Describes a certificate signing request
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class CertificateSigningRequest implements Editable<CertificateSigningRequestBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "certificates.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CertificateSigningRequest";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public CertificateSigningRequest(String apiVersion, String kind, ObjectMeta meta
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Describes a certificate signing request
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Describes a certificate signing request
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Describes a certificate signing request
+     */
     @JsonProperty("spec")
     public CertificateSigningRequestSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Describes a certificate signing request
+     */
     @JsonProperty("spec")
     public void setSpec(CertificateSigningRequestSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Describes a certificate signing request
+     */
     @JsonProperty("status")
     public CertificateSigningRequestStatus getStatus() {
         return status;
     }
 
+    /**
+     * Describes a certificate signing request
+     */
     @JsonProperty("status")
     public void setStatus(CertificateSigningRequestStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1beta1/CertificateSigningRequestCondition.java b/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1beta1/CertificateSigningRequestCondition.java
index 6af81286993..f93ac2a8b91 100644
--- a/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1beta1/CertificateSigningRequestCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1beta1/CertificateSigningRequestCondition.java
@@ -118,41 +118,65 @@ public void setLastUpdateTime(String lastUpdateTime) {
         this.lastUpdateTime = lastUpdateTime;
     }
 
+    /**
+     * human readable message with details about the request state
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * human readable message with details about the request state
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * brief reason for the request state
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * brief reason for the request state
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown. Approved, Denied, and Failed conditions may not be "False" or "Unknown". Defaults to "True". If unset, should be treated as "True".
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown. Approved, Denied, and Failed conditions may not be "False" or "Unknown". Defaults to "True". If unset, should be treated as "True".
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * type of the condition. Known conditions include "Approved", "Denied", and "Failed".
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type of the condition. Known conditions include "Approved", "Denied", and "Failed".
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1beta1/CertificateSigningRequestList.java b/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1beta1/CertificateSigningRequestList.java
index 3471bdca576..86bc78d7d52 100644
--- a/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1beta1/CertificateSigningRequestList.java
+++ b/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1beta1/CertificateSigningRequestList.java
@@ -78,17 +78,11 @@
 public class CertificateSigningRequestList implements Editable<CertificateSigningRequestListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.certificates.v1beta1.CertificateSigningRequest>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "certificates.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.certificates.v1beta1.CertificateSigningRequest> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CertificateSigningRequestList";
     @JsonProperty("metadata")
@@ -111,7 +105,7 @@ public CertificateSigningRequestList(String apiVersion, List<io.fabric8.kubernet
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +113,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -138,7 +132,7 @@ public void setItems(List<io.fabric8.kubernetes.api.model.certificates.v1beta1.C
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,7 +140,7 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
diff --git a/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1beta1/CertificateSigningRequestSpec.java b/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1beta1/CertificateSigningRequestSpec.java
index 8bf05a3a754..beb1fd425f4 100644
--- a/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1beta1/CertificateSigningRequestSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1beta1/CertificateSigningRequestSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * This information is immutable after the request is created. Only the Request and Usages fields can be set on creation, other fields are derived by Kubernetes and cannot be modified by users.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -107,74 +110,116 @@ public CertificateSigningRequestSpec(Map<String, List<String>> extra, List<Strin
         this.username = username;
     }
 
+    /**
+     * Extra information about the requesting user. See user.Info interface for details.
+     */
     @JsonProperty("extra")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<String>> getExtra() {
         return extra;
     }
 
+    /**
+     * Extra information about the requesting user. See user.Info interface for details.
+     */
     @JsonProperty("extra")
     public void setExtra(Map<String, List<String>> extra) {
         this.extra = extra;
     }
 
+    /**
+     * Group information about the requesting user. See user.Info interface for details.
+     */
     @JsonProperty("groups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getGroups() {
         return groups;
     }
 
+    /**
+     * Group information about the requesting user. See user.Info interface for details.
+     */
     @JsonProperty("groups")
     public void setGroups(List<String> groups) {
         this.groups = groups;
     }
 
+    /**
+     * Base64-encoded PKCS#10 CSR data
+     */
     @JsonProperty("request")
     public String getRequest() {
         return request;
     }
 
+    /**
+     * Base64-encoded PKCS#10 CSR data
+     */
     @JsonProperty("request")
     public void setRequest(String request) {
         this.request = request;
     }
 
+    /**
+     * Requested signer for the request. It is a qualified name in the form: `scope-hostname.io/name`. If empty, it will be defaulted:<br><p>  1. If it's a kubelet client certificate, it is assigned<br><p>     "kubernetes.io/kube-apiserver-client-kubelet".<br><p>  2. If it's a kubelet serving certificate, it is assigned<br><p>     "kubernetes.io/kubelet-serving".<br><p>  3. Otherwise, it is assigned "kubernetes.io/legacy-unknown".<br><p> Distribution of trust for signers happens out of band. You can select on this field using `spec.signerName`.
+     */
     @JsonProperty("signerName")
     public String getSignerName() {
         return signerName;
     }
 
+    /**
+     * Requested signer for the request. It is a qualified name in the form: `scope-hostname.io/name`. If empty, it will be defaulted:<br><p>  1. If it's a kubelet client certificate, it is assigned<br><p>     "kubernetes.io/kube-apiserver-client-kubelet".<br><p>  2. If it's a kubelet serving certificate, it is assigned<br><p>     "kubernetes.io/kubelet-serving".<br><p>  3. Otherwise, it is assigned "kubernetes.io/legacy-unknown".<br><p> Distribution of trust for signers happens out of band. You can select on this field using `spec.signerName`.
+     */
     @JsonProperty("signerName")
     public void setSignerName(String signerName) {
         this.signerName = signerName;
     }
 
+    /**
+     * UID information about the requesting user. See user.Info interface for details.
+     */
     @JsonProperty("uid")
     public String getUid() {
         return uid;
     }
 
+    /**
+     * UID information about the requesting user. See user.Info interface for details.
+     */
     @JsonProperty("uid")
     public void setUid(String uid) {
         this.uid = uid;
     }
 
+    /**
+     * allowedUsages specifies a set of usage contexts the key will be valid for. See: https://tools.ietf.org/html/rfc5280#section-4.2.1.3<br><p>      https://tools.ietf.org/html/rfc5280#section-4.2.1.12<br><p> Valid values are:<br><p>  "signing",<br><p>  "digital signature",<br><p>  "content commitment",<br><p>  "key encipherment",<br><p>  "key agreement",<br><p>  "data encipherment",<br><p>  "cert sign",<br><p>  "crl sign",<br><p>  "encipher only",<br><p>  "decipher only",<br><p>  "any",<br><p>  "server auth",<br><p>  "client auth",<br><p>  "code signing",<br><p>  "email protection",<br><p>  "s/mime",<br><p>  "ipsec end system",<br><p>  "ipsec tunnel",<br><p>  "ipsec user",<br><p>  "timestamping",<br><p>  "ocsp signing",<br><p>  "microsoft sgc",<br><p>  "netscape sgc"
+     */
     @JsonProperty("usages")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getUsages() {
         return usages;
     }
 
+    /**
+     * allowedUsages specifies a set of usage contexts the key will be valid for. See: https://tools.ietf.org/html/rfc5280#section-4.2.1.3<br><p>      https://tools.ietf.org/html/rfc5280#section-4.2.1.12<br><p> Valid values are:<br><p>  "signing",<br><p>  "digital signature",<br><p>  "content commitment",<br><p>  "key encipherment",<br><p>  "key agreement",<br><p>  "data encipherment",<br><p>  "cert sign",<br><p>  "crl sign",<br><p>  "encipher only",<br><p>  "decipher only",<br><p>  "any",<br><p>  "server auth",<br><p>  "client auth",<br><p>  "code signing",<br><p>  "email protection",<br><p>  "s/mime",<br><p>  "ipsec end system",<br><p>  "ipsec tunnel",<br><p>  "ipsec user",<br><p>  "timestamping",<br><p>  "ocsp signing",<br><p>  "microsoft sgc",<br><p>  "netscape sgc"
+     */
     @JsonProperty("usages")
     public void setUsages(List<String> usages) {
         this.usages = usages;
     }
 
+    /**
+     * Information about the requesting user. See user.Info interface for details.
+     */
     @JsonProperty("username")
     public String getUsername() {
         return username;
     }
 
+    /**
+     * Information about the requesting user. See user.Info interface for details.
+     */
     @JsonProperty("username")
     public void setUsername(String username) {
         this.username = username;
diff --git a/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1beta1/CertificateSigningRequestStatus.java b/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1beta1/CertificateSigningRequestStatus.java
index 9f6ed1f2102..ac2c46a8d45 100644
--- a/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1beta1/CertificateSigningRequestStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-certificates/src/generated/java/io/fabric8/kubernetes/api/model/certificates/v1beta1/CertificateSigningRequestStatus.java
@@ -85,22 +85,34 @@ public CertificateSigningRequestStatus(String certificate, List<CertificateSigni
         this.conditions = conditions;
     }
 
+    /**
+     * If request was approved, the controller will place the issued certificate here.
+     */
     @JsonProperty("certificate")
     public String getCertificate() {
         return certificate;
     }
 
+    /**
+     * If request was approved, the controller will place the issued certificate here.
+     */
     @JsonProperty("certificate")
     public void setCertificate(String certificate) {
         this.certificate = certificate;
     }
 
+    /**
+     * Conditions applied to the request, such as approval or denial.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CertificateSigningRequestCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions applied to the request, such as approval or denial.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<CertificateSigningRequestCondition> conditions) {
         this.conditions = conditions;
diff --git a/kubernetes-model-generator/kubernetes-model-coordination/src/generated/java/io/fabric8/kubernetes/api/model/coordination/v1/Lease.java b/kubernetes-model-generator/kubernetes-model-coordination/src/generated/java/io/fabric8/kubernetes/api/model/coordination/v1/Lease.java
index 4ce063ddd5f..3c92815c7d1 100644
--- a/kubernetes-model-generator/kubernetes-model-coordination/src/generated/java/io/fabric8/kubernetes/api/model/coordination/v1/Lease.java
+++ b/kubernetes-model-generator/kubernetes-model-coordination/src/generated/java/io/fabric8/kubernetes/api/model/coordination/v1/Lease.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Lease defines a lease concept.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Lease implements Editable<LeaseBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "coordination.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Lease";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public Lease(String apiVersion, String kind, ObjectMeta metadata, LeaseSpec spec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Lease defines a lease concept.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Lease defines a lease concept.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Lease defines a lease concept.
+     */
     @JsonProperty("spec")
     public LeaseSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Lease defines a lease concept.
+     */
     @JsonProperty("spec")
     public void setSpec(LeaseSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-coordination/src/generated/java/io/fabric8/kubernetes/api/model/coordination/v1/LeaseList.java b/kubernetes-model-generator/kubernetes-model-coordination/src/generated/java/io/fabric8/kubernetes/api/model/coordination/v1/LeaseList.java
index 5eb96b140e2..351632a284d 100644
--- a/kubernetes-model-generator/kubernetes-model-coordination/src/generated/java/io/fabric8/kubernetes/api/model/coordination/v1/LeaseList.java
+++ b/kubernetes-model-generator/kubernetes-model-coordination/src/generated/java/io/fabric8/kubernetes/api/model/coordination/v1/LeaseList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LeaseList is a list of Lease objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class LeaseList implements Editable<LeaseListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.coordination.v1.Lease>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "coordination.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.coordination.v1.Lease> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "LeaseList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public LeaseList(String apiVersion, List<io.fabric8.kubernetes.api.model.coordin
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is a list of schema objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.coordination.v1.Lease> getItems() {
         return items;
     }
 
+    /**
+     * items is a list of schema objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.coordination.v1.Lease> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * LeaseList is a list of Lease objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * LeaseList is a list of Lease objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-coordination/src/generated/java/io/fabric8/kubernetes/api/model/coordination/v1alpha2/LeaseCandidate.java b/kubernetes-model-generator/kubernetes-model-coordination/src/generated/java/io/fabric8/kubernetes/api/model/coordination/v1alpha2/LeaseCandidate.java
index 29395ee4b06..4537ebb0647 100644
--- a/kubernetes-model-generator/kubernetes-model-coordination/src/generated/java/io/fabric8/kubernetes/api/model/coordination/v1alpha2/LeaseCandidate.java
+++ b/kubernetes-model-generator/kubernetes-model-coordination/src/generated/java/io/fabric8/kubernetes/api/model/coordination/v1alpha2/LeaseCandidate.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LeaseCandidate defines a candidate for a Lease object. Candidates are created such that coordinated leader election will pick the best leader from the list of candidates.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class LeaseCandidate implements Editable<LeaseCandidateBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "coordination.k8s.io/v1alpha2";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "LeaseCandidate";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public LeaseCandidate(String apiVersion, String kind, ObjectMeta metadata, Lease
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * LeaseCandidate defines a candidate for a Lease object. Candidates are created such that coordinated leader election will pick the best leader from the list of candidates.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * LeaseCandidate defines a candidate for a Lease object. Candidates are created such that coordinated leader election will pick the best leader from the list of candidates.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * LeaseCandidate defines a candidate for a Lease object. Candidates are created such that coordinated leader election will pick the best leader from the list of candidates.
+     */
     @JsonProperty("spec")
     public LeaseCandidateSpec getSpec() {
         return spec;
     }
 
+    /**
+     * LeaseCandidate defines a candidate for a Lease object. Candidates are created such that coordinated leader election will pick the best leader from the list of candidates.
+     */
     @JsonProperty("spec")
     public void setSpec(LeaseCandidateSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-coordination/src/generated/java/io/fabric8/kubernetes/api/model/coordination/v1alpha2/LeaseCandidateList.java b/kubernetes-model-generator/kubernetes-model-coordination/src/generated/java/io/fabric8/kubernetes/api/model/coordination/v1alpha2/LeaseCandidateList.java
index 12bd72983b9..b6ee6e813c6 100644
--- a/kubernetes-model-generator/kubernetes-model-coordination/src/generated/java/io/fabric8/kubernetes/api/model/coordination/v1alpha2/LeaseCandidateList.java
+++ b/kubernetes-model-generator/kubernetes-model-coordination/src/generated/java/io/fabric8/kubernetes/api/model/coordination/v1alpha2/LeaseCandidateList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LeaseCandidateList is a list of Lease objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class LeaseCandidateList implements Editable<LeaseCandidateListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.coordination.v1alpha2.LeaseCandidate>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "coordination.k8s.io/v1alpha2";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.coordination.v1alpha2.LeaseCandidate> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "LeaseCandidateList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public LeaseCandidateList(String apiVersion, List<io.fabric8.kubernetes.api.mode
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is a list of schema objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.coordination.v1alpha2.LeaseCandidate> getItems() {
         return items;
     }
 
+    /**
+     * items is a list of schema objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.coordination.v1alpha2.LeaseCandidate> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * LeaseCandidateList is a list of Lease objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * LeaseCandidateList is a list of Lease objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-coordination/src/generated/java/io/fabric8/kubernetes/api/model/coordination/v1alpha2/LeaseCandidateSpec.java b/kubernetes-model-generator/kubernetes-model-coordination/src/generated/java/io/fabric8/kubernetes/api/model/coordination/v1alpha2/LeaseCandidateSpec.java
index 2e6252e5048..5ea452153bd 100644
--- a/kubernetes-model-generator/kubernetes-model-coordination/src/generated/java/io/fabric8/kubernetes/api/model/coordination/v1alpha2/LeaseCandidateSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-coordination/src/generated/java/io/fabric8/kubernetes/api/model/coordination/v1alpha2/LeaseCandidateSpec.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LeaseCandidateSpec is a specification of a Lease.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -99,61 +102,97 @@ public LeaseCandidateSpec(String binaryVersion, String emulationVersion, String
         this.strategy = strategy;
     }
 
+    /**
+     * BinaryVersion is the binary version. It must be in a semver format without leading `v`. This field is required.
+     */
     @JsonProperty("binaryVersion")
     public String getBinaryVersion() {
         return binaryVersion;
     }
 
+    /**
+     * BinaryVersion is the binary version. It must be in a semver format without leading `v`. This field is required.
+     */
     @JsonProperty("binaryVersion")
     public void setBinaryVersion(String binaryVersion) {
         this.binaryVersion = binaryVersion;
     }
 
+    /**
+     * EmulationVersion is the emulation version. It must be in a semver format without leading `v`. EmulationVersion must be less than or equal to BinaryVersion. This field is required when strategy is "OldestEmulationVersion"
+     */
     @JsonProperty("emulationVersion")
     public String getEmulationVersion() {
         return emulationVersion;
     }
 
+    /**
+     * EmulationVersion is the emulation version. It must be in a semver format without leading `v`. EmulationVersion must be less than or equal to BinaryVersion. This field is required when strategy is "OldestEmulationVersion"
+     */
     @JsonProperty("emulationVersion")
     public void setEmulationVersion(String emulationVersion) {
         this.emulationVersion = emulationVersion;
     }
 
+    /**
+     * LeaseName is the name of the lease for which this candidate is contending. This field is immutable.
+     */
     @JsonProperty("leaseName")
     public String getLeaseName() {
         return leaseName;
     }
 
+    /**
+     * LeaseName is the name of the lease for which this candidate is contending. This field is immutable.
+     */
     @JsonProperty("leaseName")
     public void setLeaseName(String leaseName) {
         this.leaseName = leaseName;
     }
 
+    /**
+     * LeaseCandidateSpec is a specification of a Lease.
+     */
     @JsonProperty("pingTime")
     public MicroTime getPingTime() {
         return pingTime;
     }
 
+    /**
+     * LeaseCandidateSpec is a specification of a Lease.
+     */
     @JsonProperty("pingTime")
     public void setPingTime(MicroTime pingTime) {
         this.pingTime = pingTime;
     }
 
+    /**
+     * LeaseCandidateSpec is a specification of a Lease.
+     */
     @JsonProperty("renewTime")
     public MicroTime getRenewTime() {
         return renewTime;
     }
 
+    /**
+     * LeaseCandidateSpec is a specification of a Lease.
+     */
     @JsonProperty("renewTime")
     public void setRenewTime(MicroTime renewTime) {
         this.renewTime = renewTime;
     }
 
+    /**
+     * Strategy is the strategy that coordinated leader election will use for picking the leader. If multiple candidates for the same Lease return different strategies, the strategy provided by the candidate with the latest BinaryVersion will be used. If there is still conflict, this is a user error and coordinated leader election will not operate the Lease until resolved. (Alpha) Using this field requires the CoordinatedLeaderElection feature gate to be enabled.
+     */
     @JsonProperty("strategy")
     public String getStrategy() {
         return strategy;
     }
 
+    /**
+     * Strategy is the strategy that coordinated leader election will use for picking the leader. If multiple candidates for the same Lease return different strategies, the strategy provided by the candidate with the latest BinaryVersion will be used. If there is still conflict, this is a user error and coordinated leader election will not operate the Lease until resolved. (Alpha) Using this field requires the CoordinatedLeaderElection feature gate to be enabled.
+     */
     @JsonProperty("strategy")
     public void setStrategy(String strategy) {
         this.strategy = strategy;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIGroup.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIGroup.java
index c23d6f53134..f76bcf2077d 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIGroup.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIGroup.java
@@ -23,6 +23,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * APIGroup contains the name, the supported versions, and the preferred version of a group.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -49,14 +52,8 @@
 public class APIGroup implements Editable<APIGroupBuilder>, KubernetesResource
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "APIGroup";
     @JsonProperty("name")
@@ -89,7 +86,7 @@ public APIGroup(String apiVersion, String kind, String name, GroupVersionForDisc
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -97,7 +94,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -105,7 +102,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -113,50 +110,74 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * name is the name of the group.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the group.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * APIGroup contains the name, the supported versions, and the preferred version of a group.
+     */
     @JsonProperty("preferredVersion")
     public GroupVersionForDiscovery getPreferredVersion() {
         return preferredVersion;
     }
 
+    /**
+     * APIGroup contains the name, the supported versions, and the preferred version of a group.
+     */
     @JsonProperty("preferredVersion")
     public void setPreferredVersion(GroupVersionForDiscovery preferredVersion) {
         this.preferredVersion = preferredVersion;
     }
 
+    /**
+     * a map of client CIDR to server address that is serving this group. This is to help clients reach servers in the most network-efficient way possible. Clients can use the appropriate server address as per the CIDR that they match. In case of multiple matches, clients should use the longest matching CIDR. The server returns only those CIDRs that it thinks that the client can match. For example: the master will return an internal IP CIDR only, if the client reaches the server using an internal IP. Server looks at X-Forwarded-For header or X-Real-Ip header or request.RemoteAddr (in that order) to get the client IP.
+     */
     @JsonProperty("serverAddressByClientCIDRs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ServerAddressByClientCIDR> getServerAddressByClientCIDRs() {
         return serverAddressByClientCIDRs;
     }
 
+    /**
+     * a map of client CIDR to server address that is serving this group. This is to help clients reach servers in the most network-efficient way possible. Clients can use the appropriate server address as per the CIDR that they match. In case of multiple matches, clients should use the longest matching CIDR. The server returns only those CIDRs that it thinks that the client can match. For example: the master will return an internal IP CIDR only, if the client reaches the server using an internal IP. Server looks at X-Forwarded-For header or X-Real-Ip header or request.RemoteAddr (in that order) to get the client IP.
+     */
     @JsonProperty("serverAddressByClientCIDRs")
     public void setServerAddressByClientCIDRs(List<ServerAddressByClientCIDR> serverAddressByClientCIDRs) {
         this.serverAddressByClientCIDRs = serverAddressByClientCIDRs;
     }
 
+    /**
+     * versions are the versions supported in this group.
+     */
     @JsonProperty("versions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GroupVersionForDiscovery> getVersions() {
         return versions;
     }
 
+    /**
+     * versions are the versions supported in this group.
+     */
     @JsonProperty("versions")
     public void setVersions(List<GroupVersionForDiscovery> versions) {
         this.versions = versions;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIGroupList.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIGroupList.java
index d64c07f6614..f4065cf62d8 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIGroupList.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIGroupList.java
@@ -23,6 +23,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * APIGroupList is a list of APIGroup, to allow clients to discover the API at /apis.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -46,17 +49,11 @@
 public class APIGroupList implements Editable<APIGroupListBuilder>, KubernetesResource
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("groups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<APIGroup> groups = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "APIGroupList";
     @JsonIgnore
@@ -76,7 +73,7 @@ public APIGroupList(String apiVersion, List<APIGroup> groups, String kind) {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -84,26 +81,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * groups is a list of APIGroup.
+     */
     @JsonProperty("groups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<APIGroup> getGroups() {
         return groups;
     }
 
+    /**
+     * groups is a list of APIGroup.
+     */
     @JsonProperty("groups")
     public void setGroups(List<APIGroup> groups) {
         this.groups = groups;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -111,7 +114,7 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIResource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIResource.java
index c9f7ad51917..bed0044d9f9 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIResource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIResource.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * APIResource specifies the name of a resource and whether it is namespaced.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,104 +93,164 @@ public APIResource(List<String> categories, String group, String kind, String na
         this.version = version;
     }
 
+    /**
+     * categories is a list of the grouped resources this resource belongs to (e.g. 'all')
+     */
     @JsonProperty("categories")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCategories() {
         return categories;
     }
 
+    /**
+     * categories is a list of the grouped resources this resource belongs to (e.g. 'all')
+     */
     @JsonProperty("categories")
     public void setCategories(List<String> categories) {
         this.categories = categories;
     }
 
+    /**
+     * group is the preferred group of the resource.  Empty implies the group of the containing resource list. For subresources, this may have a different value, for example: Scale".
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * group is the preferred group of the resource.  Empty implies the group of the containing resource list. For subresources, this may have a different value, for example: Scale".
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * kind is the kind for the resource (e.g. 'Foo' is the kind for a resource 'foo')
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * kind is the kind for the resource (e.g. 'Foo' is the kind for a resource 'foo')
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * name is the plural name of the resource.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the plural name of the resource.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * namespaced indicates if a resource is namespaced or not.
+     */
     @JsonProperty("namespaced")
     public Boolean getNamespaced() {
         return namespaced;
     }
 
+    /**
+     * namespaced indicates if a resource is namespaced or not.
+     */
     @JsonProperty("namespaced")
     public void setNamespaced(Boolean namespaced) {
         this.namespaced = namespaced;
     }
 
+    /**
+     * shortNames is a list of suggested short names of the resource.
+     */
     @JsonProperty("shortNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getShortNames() {
         return shortNames;
     }
 
+    /**
+     * shortNames is a list of suggested short names of the resource.
+     */
     @JsonProperty("shortNames")
     public void setShortNames(List<String> shortNames) {
         this.shortNames = shortNames;
     }
 
+    /**
+     * singularName is the singular name of the resource.  This allows clients to handle plural and singular opaquely. The singularName is more correct for reporting status on a single item and both singular and plural are allowed from the kubectl CLI interface.
+     */
     @JsonProperty("singularName")
     public String getSingularName() {
         return singularName;
     }
 
+    /**
+     * singularName is the singular name of the resource.  This allows clients to handle plural and singular opaquely. The singularName is more correct for reporting status on a single item and both singular and plural are allowed from the kubectl CLI interface.
+     */
     @JsonProperty("singularName")
     public void setSingularName(String singularName) {
         this.singularName = singularName;
     }
 
+    /**
+     * The hash value of the storage version, the version this resource is converted to when written to the data store. Value must be treated as opaque by clients. Only equality comparison on the value is valid. This is an alpha feature and may change or be removed in the future. The field is populated by the apiserver only if the StorageVersionHash feature gate is enabled. This field will remain optional even if it graduates.
+     */
     @JsonProperty("storageVersionHash")
     public String getStorageVersionHash() {
         return storageVersionHash;
     }
 
+    /**
+     * The hash value of the storage version, the version this resource is converted to when written to the data store. Value must be treated as opaque by clients. Only equality comparison on the value is valid. This is an alpha feature and may change or be removed in the future. The field is populated by the apiserver only if the StorageVersionHash feature gate is enabled. This field will remain optional even if it graduates.
+     */
     @JsonProperty("storageVersionHash")
     public void setStorageVersionHash(String storageVersionHash) {
         this.storageVersionHash = storageVersionHash;
     }
 
+    /**
+     * verbs is a list of supported kube verbs (this includes get, list, watch, create, update, patch, delete, deletecollection, and proxy)
+     */
     @JsonProperty("verbs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getVerbs() {
         return verbs;
     }
 
+    /**
+     * verbs is a list of supported kube verbs (this includes get, list, watch, create, update, patch, delete, deletecollection, and proxy)
+     */
     @JsonProperty("verbs")
     public void setVerbs(List<String> verbs) {
         this.verbs = verbs;
     }
 
+    /**
+     * version is the preferred version of the resource.  Empty implies the version of the containing resource list For subresources, this may have a different value, for example: v1 (while inside a v1beta1 version of the core resource's group)".
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the preferred version of the resource.  Empty implies the version of the containing resource list For subresources, this may have a different value, for example: v1 (while inside a v1beta1 version of the core resource's group)".
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIResourceList.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIResourceList.java
index d8a82292d49..755eeacc5ec 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIResourceList.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIResourceList.java
@@ -23,6 +23,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * APIResourceList is a list of APIResource, it is used to expose the name of the resources supported in a specific group and version, and if the resource is namespaced.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -47,16 +50,10 @@
 public class APIResourceList implements Editable<APIResourceListBuilder>, KubernetesResource
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("groupVersion")
     private String groupVersion;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "APIResourceList";
     @JsonProperty("resources")
@@ -80,7 +77,7 @@ public APIResourceList(String apiVersion, String groupVersion, String kind, List
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -88,25 +85,31 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * groupVersion is the group and version this APIResourceList is for.
+     */
     @JsonProperty("groupVersion")
     public String getGroupVersion() {
         return groupVersion;
     }
 
+    /**
+     * groupVersion is the group and version this APIResourceList is for.
+     */
     @JsonProperty("groupVersion")
     public void setGroupVersion(String groupVersion) {
         this.groupVersion = groupVersion;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -114,19 +117,25 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * resources contains the name of the resources and if they are namespaced.
+     */
     @JsonProperty("resources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<APIResource> getResources() {
         return resources;
     }
 
+    /**
+     * resources contains the name of the resources and if they are namespaced.
+     */
     @JsonProperty("resources")
     public void setResources(List<APIResource> resources) {
         this.resources = resources;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIService.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIService.java
index f3e857e5c8b..c90841f6598 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIService.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIService.java
@@ -21,6 +21,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * APIService represents a server for a particular GroupVersion. Name must be "version.group".
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -46,14 +49,8 @@
 public class APIService implements Editable<APIServiceBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apiregistration.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "APIService";
     @JsonProperty("metadata")
@@ -81,7 +78,7 @@ public APIService(String apiVersion, String kind, ObjectMeta metadata, APIServic
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -89,7 +86,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -97,7 +94,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -105,38 +102,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * APIService represents a server for a particular GroupVersion. Name must be "version.group".
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * APIService represents a server for a particular GroupVersion. Name must be "version.group".
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * APIService represents a server for a particular GroupVersion. Name must be "version.group".
+     */
     @JsonProperty("spec")
     public APIServiceSpec getSpec() {
         return spec;
     }
 
+    /**
+     * APIService represents a server for a particular GroupVersion. Name must be "version.group".
+     */
     @JsonProperty("spec")
     public void setSpec(APIServiceSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * APIService represents a server for a particular GroupVersion. Name must be "version.group".
+     */
     @JsonProperty("status")
     public APIServiceStatus getStatus() {
         return status;
     }
 
+    /**
+     * APIService represents a server for a particular GroupVersion. Name must be "version.group".
+     */
     @JsonProperty("status")
     public void setStatus(APIServiceStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIServiceCondition.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIServiceCondition.java
index 0e92e4d4b84..e2aec6c3c8e 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIServiceCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIServiceCondition.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * APIServiceCondition describes the state of an APIService at a particular point
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -65,51 +68,81 @@ public APIServiceCondition(String lastTransitionTime, String message, String rea
         this.type = type;
     }
 
+    /**
+     * APIServiceCondition describes the state of an APIService at a particular point
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * APIServiceCondition describes the state of an APIService at a particular point
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status is the status of the condition. Can be True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status is the status of the condition. Can be True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type is the type of the condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of the condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIServiceList.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIServiceList.java
index b779f3baa77..f0cce64fc74 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIServiceList.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIServiceList.java
@@ -23,6 +23,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * APIServiceList is a list of APIService objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -47,17 +50,11 @@
 public class APIServiceList implements Editable<APIServiceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.APIService>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apiregistration.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.APIService> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "APIServiceList";
     @JsonProperty("metadata")
@@ -80,7 +77,7 @@ public APIServiceList(String apiVersion, List<io.fabric8.kubernetes.api.model.AP
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -88,26 +85,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of APIService
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.APIService> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of APIService
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.APIService> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -115,18 +118,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * APIServiceList is a list of APIService objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * APIServiceList is a list of APIService objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIServiceSpec.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIServiceSpec.java
index 135140df011..58cdac5eadc 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIServiceSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIServiceSpec.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * APIServiceSpec contains information for locating and communicating with a server. Only https is supported, though you are able to disable certificate verification.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -73,71 +76,113 @@ public APIServiceSpec(String caBundle, String group, Integer groupPriorityMinimu
         this.versionPriority = versionPriority;
     }
 
+    /**
+     * CABundle is a PEM encoded CA bundle which will be used to validate an API server's serving certificate. If unspecified, system trust roots on the apiserver are used.
+     */
     @JsonProperty("caBundle")
     public String getCaBundle() {
         return caBundle;
     }
 
+    /**
+     * CABundle is a PEM encoded CA bundle which will be used to validate an API server's serving certificate. If unspecified, system trust roots on the apiserver are used.
+     */
     @JsonProperty("caBundle")
     public void setCaBundle(String caBundle) {
         this.caBundle = caBundle;
     }
 
+    /**
+     * Group is the API group name this server hosts
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * Group is the API group name this server hosts
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * GroupPriorityMinimum is the priority this group should have at least. Higher priority means that the group is preferred by clients over lower priority ones. Note that other versions of this group might specify even higher GroupPriorityMinimum values such that the whole group gets a higher priority. The primary sort is based on GroupPriorityMinimum, ordered highest number to lowest (20 before 10). The secondary sort is based on the alphabetical comparison of the name of the object.  (v1.bar before v1.foo) We'd recommend something like: &#42;.k8s.io (except extensions) at 18000 and PaaSes (OpenShift, Deis) are recommended to be in the 2000s
+     */
     @JsonProperty("groupPriorityMinimum")
     public Integer getGroupPriorityMinimum() {
         return groupPriorityMinimum;
     }
 
+    /**
+     * GroupPriorityMinimum is the priority this group should have at least. Higher priority means that the group is preferred by clients over lower priority ones. Note that other versions of this group might specify even higher GroupPriorityMinimum values such that the whole group gets a higher priority. The primary sort is based on GroupPriorityMinimum, ordered highest number to lowest (20 before 10). The secondary sort is based on the alphabetical comparison of the name of the object.  (v1.bar before v1.foo) We'd recommend something like: &#42;.k8s.io (except extensions) at 18000 and PaaSes (OpenShift, Deis) are recommended to be in the 2000s
+     */
     @JsonProperty("groupPriorityMinimum")
     public void setGroupPriorityMinimum(Integer groupPriorityMinimum) {
         this.groupPriorityMinimum = groupPriorityMinimum;
     }
 
+    /**
+     * InsecureSkipTLSVerify disables TLS certificate verification when communicating with this server. This is strongly discouraged.  You should use the CABundle instead.
+     */
     @JsonProperty("insecureSkipTLSVerify")
     public Boolean getInsecureSkipTLSVerify() {
         return insecureSkipTLSVerify;
     }
 
+    /**
+     * InsecureSkipTLSVerify disables TLS certificate verification when communicating with this server. This is strongly discouraged.  You should use the CABundle instead.
+     */
     @JsonProperty("insecureSkipTLSVerify")
     public void setInsecureSkipTLSVerify(Boolean insecureSkipTLSVerify) {
         this.insecureSkipTLSVerify = insecureSkipTLSVerify;
     }
 
+    /**
+     * APIServiceSpec contains information for locating and communicating with a server. Only https is supported, though you are able to disable certificate verification.
+     */
     @JsonProperty("service")
     public ServiceReference getService() {
         return service;
     }
 
+    /**
+     * APIServiceSpec contains information for locating and communicating with a server. Only https is supported, though you are able to disable certificate verification.
+     */
     @JsonProperty("service")
     public void setService(ServiceReference service) {
         this.service = service;
     }
 
+    /**
+     * Version is the API version this server hosts.  For example, "v1"
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * Version is the API version this server hosts.  For example, "v1"
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
     }
 
+    /**
+     * VersionPriority controls the ordering of this API version inside of its group.  Must be greater than zero. The primary sort is based on VersionPriority, ordered highest to lowest (20 before 10). Since it's inside of a group, the number can be small, probably in the 10s. In case of equal version priorities, the version string will be used to compute the order inside a group. If the version string is "kube-like", it will sort above non "kube-like" version strings, which are ordered lexicographically. "Kube-like" versions start with a "v", then are followed by a number (the major version), then optionally the string "alpha" or "beta" and another number (the minor version). These are sorted first by GA &gt; beta &gt; alpha (where GA is a version with no suffix such as beta or alpha), and then by comparing major version, then minor version. An example sorted list of versions: v10, v2, v1, v11beta2, v10beta3, v3beta1, v12alpha1, v11alpha2, foo1, foo10.
+     */
     @JsonProperty("versionPriority")
     public Integer getVersionPriority() {
         return versionPriority;
     }
 
+    /**
+     * VersionPriority controls the ordering of this API version inside of its group.  Must be greater than zero. The primary sort is based on VersionPriority, ordered highest to lowest (20 before 10). Since it's inside of a group, the number can be small, probably in the 10s. In case of equal version priorities, the version string will be used to compute the order inside a group. If the version string is "kube-like", it will sort above non "kube-like" version strings, which are ordered lexicographically. "Kube-like" versions start with a "v", then are followed by a number (the major version), then optionally the string "alpha" or "beta" and another number (the minor version). These are sorted first by GA &gt; beta &gt; alpha (where GA is a version with no suffix such as beta or alpha), and then by comparing major version, then minor version. An example sorted list of versions: v10, v2, v1, v11beta2, v10beta3, v3beta1, v12alpha1, v11alpha2, foo1, foo10.
+     */
     @JsonProperty("versionPriority")
     public void setVersionPriority(Integer versionPriority) {
         this.versionPriority = versionPriority;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIServiceStatus.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIServiceStatus.java
index 363b6ac479c..982d95a78fe 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIServiceStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIServiceStatus.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * APIServiceStatus contains derived information about an API server
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -52,12 +55,18 @@ public APIServiceStatus(List<APIServiceCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Current service state of apiService.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<APIServiceCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Current service state of apiService.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<APIServiceCondition> conditions) {
         this.conditions = conditions;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIVersions.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIVersions.java
index 74940ae6860..836d3bff1cf 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIVersions.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/APIVersions.java
@@ -23,6 +23,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * APIVersions lists the versions that are available, to allow clients to discover the API at /api, which is the root path of the legacy v1 API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -47,14 +50,8 @@
 public class APIVersions implements Editable<APIVersionsBuilder>, KubernetesResource
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "APIVersions";
     @JsonProperty("serverAddressByClientCIDRs")
@@ -81,7 +78,7 @@ public APIVersions(String apiVersion, String kind, List<ServerAddressByClientCID
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -89,7 +86,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -97,7 +94,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -105,30 +102,42 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * a map of client CIDR to server address that is serving this group. This is to help clients reach servers in the most network-efficient way possible. Clients can use the appropriate server address as per the CIDR that they match. In case of multiple matches, clients should use the longest matching CIDR. The server returns only those CIDRs that it thinks that the client can match. For example: the master will return an internal IP CIDR only, if the client reaches the server using an internal IP. Server looks at X-Forwarded-For header or X-Real-Ip header or request.RemoteAddr (in that order) to get the client IP.
+     */
     @JsonProperty("serverAddressByClientCIDRs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ServerAddressByClientCIDR> getServerAddressByClientCIDRs() {
         return serverAddressByClientCIDRs;
     }
 
+    /**
+     * a map of client CIDR to server address that is serving this group. This is to help clients reach servers in the most network-efficient way possible. Clients can use the appropriate server address as per the CIDR that they match. In case of multiple matches, clients should use the longest matching CIDR. The server returns only those CIDRs that it thinks that the client can match. For example: the master will return an internal IP CIDR only, if the client reaches the server using an internal IP. Server looks at X-Forwarded-For header or X-Real-Ip header or request.RemoteAddr (in that order) to get the client IP.
+     */
     @JsonProperty("serverAddressByClientCIDRs")
     public void setServerAddressByClientCIDRs(List<ServerAddressByClientCIDR> serverAddressByClientCIDRs) {
         this.serverAddressByClientCIDRs = serverAddressByClientCIDRs;
     }
 
+    /**
+     * versions are the api versions that are available.
+     */
     @JsonProperty("versions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getVersions() {
         return versions;
     }
 
+    /**
+     * versions are the api versions that are available.
+     */
     @JsonProperty("versions")
     public void setVersions(List<String> versions) {
         this.versions = versions;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/AWSElasticBlockStoreVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/AWSElasticBlockStoreVolumeSource.java
index f700e3ed908..65bdd6dd939 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/AWSElasticBlockStoreVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/AWSElasticBlockStoreVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Represents a Persistent Disk resource in AWS.<br><p> <br><p> An AWS EBS disk must exist before mounting to a container. The disk must also be in the same AWS zone as the kubelet. An AWS EBS disk can only be mounted as read/write once. AWS EBS volumes support ownership management and SELinux relabeling.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -61,41 +64,65 @@ public AWSElasticBlockStoreVolumeSource(String fsType, Integer partition, Boolea
         this.volumeID = volumeID;
     }
 
+    /**
+     * fsType is the filesystem type of the volume that you want to mount. Tip: Ensure that the filesystem type is supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified. More info: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore
+     */
     @JsonProperty("fsType")
     public String getFsType() {
         return fsType;
     }
 
+    /**
+     * fsType is the filesystem type of the volume that you want to mount. Tip: Ensure that the filesystem type is supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified. More info: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore
+     */
     @JsonProperty("fsType")
     public void setFsType(String fsType) {
         this.fsType = fsType;
     }
 
+    /**
+     * partition is the partition in the volume that you want to mount. If omitted, the default is to mount by volume name. Examples: For volume /dev/sda1, you specify the partition as "1". Similarly, the volume partition for /dev/sda is "0" (or you can leave the property empty).
+     */
     @JsonProperty("partition")
     public Integer getPartition() {
         return partition;
     }
 
+    /**
+     * partition is the partition in the volume that you want to mount. If omitted, the default is to mount by volume name. Examples: For volume /dev/sda1, you specify the partition as "1". Similarly, the volume partition for /dev/sda is "0" (or you can leave the property empty).
+     */
     @JsonProperty("partition")
     public void setPartition(Integer partition) {
         this.partition = partition;
     }
 
+    /**
+     * readOnly value true will force the readOnly setting in VolumeMounts. More info: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly value true will force the readOnly setting in VolumeMounts. More info: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * volumeID is unique ID of the persistent disk resource in AWS (Amazon EBS volume). More info: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore
+     */
     @JsonProperty("volumeID")
     public String getVolumeID() {
         return volumeID;
     }
 
+    /**
+     * volumeID is unique ID of the persistent disk resource in AWS (Amazon EBS volume). More info: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore
+     */
     @JsonProperty("volumeID")
     public void setVolumeID(String volumeID) {
         this.volumeID = volumeID;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Affinity.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Affinity.java
index fd0adc93486..606d537b178 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Affinity.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Affinity.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Affinity is a group of affinity scheduling rules.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -57,31 +60,49 @@ public Affinity(NodeAffinity nodeAffinity, PodAffinity podAffinity, PodAntiAffin
         this.podAntiAffinity = podAntiAffinity;
     }
 
+    /**
+     * Affinity is a group of affinity scheduling rules.
+     */
     @JsonProperty("nodeAffinity")
     public NodeAffinity getNodeAffinity() {
         return nodeAffinity;
     }
 
+    /**
+     * Affinity is a group of affinity scheduling rules.
+     */
     @JsonProperty("nodeAffinity")
     public void setNodeAffinity(NodeAffinity nodeAffinity) {
         this.nodeAffinity = nodeAffinity;
     }
 
+    /**
+     * Affinity is a group of affinity scheduling rules.
+     */
     @JsonProperty("podAffinity")
     public PodAffinity getPodAffinity() {
         return podAffinity;
     }
 
+    /**
+     * Affinity is a group of affinity scheduling rules.
+     */
     @JsonProperty("podAffinity")
     public void setPodAffinity(PodAffinity podAffinity) {
         this.podAffinity = podAffinity;
     }
 
+    /**
+     * Affinity is a group of affinity scheduling rules.
+     */
     @JsonProperty("podAntiAffinity")
     public PodAntiAffinity getPodAntiAffinity() {
         return podAntiAffinity;
     }
 
+    /**
+     * Affinity is a group of affinity scheduling rules.
+     */
     @JsonProperty("podAntiAffinity")
     public void setPodAntiAffinity(PodAntiAffinity podAntiAffinity) {
         this.podAntiAffinity = podAntiAffinity;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/AppArmorProfile.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/AppArmorProfile.java
index 3995262e999..e1e22e718dd 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/AppArmorProfile.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/AppArmorProfile.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AppArmorProfile defines a pod or container's AppArmor settings.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public AppArmorProfile(String localhostProfile, String type) {
         this.type = type;
     }
 
+    /**
+     * localhostProfile indicates a profile loaded on the node that should be used. The profile must be preconfigured on the node to work. Must match the loaded name of the profile. Must be set if and only if type is "Localhost".
+     */
     @JsonProperty("localhostProfile")
     public String getLocalhostProfile() {
         return localhostProfile;
     }
 
+    /**
+     * localhostProfile indicates a profile loaded on the node that should be used. The profile must be preconfigured on the node to work. Must match the loaded name of the profile. Must be set if and only if type is "Localhost".
+     */
     @JsonProperty("localhostProfile")
     public void setLocalhostProfile(String localhostProfile) {
         this.localhostProfile = localhostProfile;
     }
 
+    /**
+     * type indicates which kind of AppArmor profile will be applied. Valid options are:<br><p>   Localhost - a profile pre-loaded on the node.<br><p>   RuntimeDefault - the container runtime's default profile.<br><p>   Unconfined - no AppArmor enforcement.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type indicates which kind of AppArmor profile will be applied. Valid options are:<br><p>   Localhost - a profile pre-loaded on the node.<br><p>   RuntimeDefault - the container runtime's default profile.<br><p>   Unconfined - no AppArmor enforcement.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/AttachedVolume.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/AttachedVolume.java
index 1f5e099f479..b946af74d0c 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/AttachedVolume.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/AttachedVolume.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AttachedVolume describes a volume attached to a node
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public AttachedVolume(String devicePath, String name) {
         this.name = name;
     }
 
+    /**
+     * DevicePath represents the device path where the volume should be available
+     */
     @JsonProperty("devicePath")
     public String getDevicePath() {
         return devicePath;
     }
 
+    /**
+     * DevicePath represents the device path where the volume should be available
+     */
     @JsonProperty("devicePath")
     public void setDevicePath(String devicePath) {
         this.devicePath = devicePath;
     }
 
+    /**
+     * Name of the attached volume
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the attached volume
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/AzureDiskVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/AzureDiskVolumeSource.java
index a4ed608f26b..a30d675df92 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/AzureDiskVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/AzureDiskVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzureDisk represents an Azure Data Disk mount on the host and bind mount to the pod.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -69,61 +72,97 @@ public AzureDiskVolumeSource(String cachingMode, String diskName, String diskURI
         this.readOnly = readOnly;
     }
 
+    /**
+     * cachingMode is the Host Caching mode: None, Read Only, Read Write.
+     */
     @JsonProperty("cachingMode")
     public String getCachingMode() {
         return cachingMode;
     }
 
+    /**
+     * cachingMode is the Host Caching mode: None, Read Only, Read Write.
+     */
     @JsonProperty("cachingMode")
     public void setCachingMode(String cachingMode) {
         this.cachingMode = cachingMode;
     }
 
+    /**
+     * diskName is the Name of the data disk in the blob storage
+     */
     @JsonProperty("diskName")
     public String getDiskName() {
         return diskName;
     }
 
+    /**
+     * diskName is the Name of the data disk in the blob storage
+     */
     @JsonProperty("diskName")
     public void setDiskName(String diskName) {
         this.diskName = diskName;
     }
 
+    /**
+     * diskURI is the URI of data disk in the blob storage
+     */
     @JsonProperty("diskURI")
     public String getDiskURI() {
         return diskURI;
     }
 
+    /**
+     * diskURI is the URI of data disk in the blob storage
+     */
     @JsonProperty("diskURI")
     public void setDiskURI(String diskURI) {
         this.diskURI = diskURI;
     }
 
+    /**
+     * fsType is Filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.
+     */
     @JsonProperty("fsType")
     public String getFsType() {
         return fsType;
     }
 
+    /**
+     * fsType is Filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.
+     */
     @JsonProperty("fsType")
     public void setFsType(String fsType) {
         this.fsType = fsType;
     }
 
+    /**
+     * kind expected values are Shared: multiple blob disks per storage account  Dedicated: single blob disk per storage account  Managed: azure managed data disk (only in managed availability set). defaults to shared
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * kind expected values are Shared: multiple blob disks per storage account  Dedicated: single blob disk per storage account  Managed: azure managed data disk (only in managed availability set). defaults to shared
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * readOnly Defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly Defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/AzureFilePersistentVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/AzureFilePersistentVolumeSource.java
index 2b5cc523dbe..18d710700d6 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/AzureFilePersistentVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/AzureFilePersistentVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzureFile represents an Azure File Service mount on the host and bind mount to the pod.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -61,41 +64,65 @@ public AzureFilePersistentVolumeSource(Boolean readOnly, String secretName, Stri
         this.shareName = shareName;
     }
 
+    /**
+     * readOnly defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * secretName is the name of secret that contains Azure Storage Account Name and Key
+     */
     @JsonProperty("secretName")
     public String getSecretName() {
         return secretName;
     }
 
+    /**
+     * secretName is the name of secret that contains Azure Storage Account Name and Key
+     */
     @JsonProperty("secretName")
     public void setSecretName(String secretName) {
         this.secretName = secretName;
     }
 
+    /**
+     * secretNamespace is the namespace of the secret that contains Azure Storage Account Name and Key default is the same as the Pod
+     */
     @JsonProperty("secretNamespace")
     public String getSecretNamespace() {
         return secretNamespace;
     }
 
+    /**
+     * secretNamespace is the namespace of the secret that contains Azure Storage Account Name and Key default is the same as the Pod
+     */
     @JsonProperty("secretNamespace")
     public void setSecretNamespace(String secretNamespace) {
         this.secretNamespace = secretNamespace;
     }
 
+    /**
+     * shareName is the azure Share Name
+     */
     @JsonProperty("shareName")
     public String getShareName() {
         return shareName;
     }
 
+    /**
+     * shareName is the azure Share Name
+     */
     @JsonProperty("shareName")
     public void setShareName(String shareName) {
         this.shareName = shareName;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/AzureFileVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/AzureFileVolumeSource.java
index c4824896c86..ab881c81684 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/AzureFileVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/AzureFileVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzureFile represents an Azure File Service mount on the host and bind mount to the pod.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -57,31 +60,49 @@ public AzureFileVolumeSource(Boolean readOnly, String secretName, String shareNa
         this.shareName = shareName;
     }
 
+    /**
+     * readOnly defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * secretName is the  name of secret that contains Azure Storage Account Name and Key
+     */
     @JsonProperty("secretName")
     public String getSecretName() {
         return secretName;
     }
 
+    /**
+     * secretName is the  name of secret that contains Azure Storage Account Name and Key
+     */
     @JsonProperty("secretName")
     public void setSecretName(String secretName) {
         this.secretName = secretName;
     }
 
+    /**
+     * shareName is the azure share Name
+     */
     @JsonProperty("shareName")
     public String getShareName() {
         return shareName;
     }
 
+    /**
+     * shareName is the azure share Name
+     */
     @JsonProperty("shareName")
     public void setShareName(String shareName) {
         this.shareName = shareName;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Binding.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Binding.java
index 48e7d1fbb79..fabdb650ccb 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Binding.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Binding.java
@@ -21,6 +21,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Binding ties one object to another; for example, a pod is bound to a node by a scheduler.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -45,14 +48,8 @@
 public class Binding implements Editable<BindingBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Binding";
     @JsonProperty("metadata")
@@ -77,7 +74,7 @@ public Binding(String apiVersion, String kind, ObjectMeta metadata, ObjectRefere
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -85,7 +82,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -93,7 +90,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -101,28 +98,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Binding ties one object to another; for example, a pod is bound to a node by a scheduler.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Binding ties one object to another; for example, a pod is bound to a node by a scheduler.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Binding ties one object to another; for example, a pod is bound to a node by a scheduler.
+     */
     @JsonProperty("target")
     public ObjectReference getTarget() {
         return target;
     }
 
+    /**
+     * Binding ties one object to another; for example, a pod is bound to a node by a scheduler.
+     */
     @JsonProperty("target")
     public void setTarget(ObjectReference target) {
         this.target = target;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/CSIPersistentVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/CSIPersistentVolumeSource.java
index fed5f5bb7ad..155f9ceaccd 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/CSIPersistentVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/CSIPersistentVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Represents storage that is managed by an external CSI volume driver
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,102 +89,162 @@ public CSIPersistentVolumeSource(SecretReference controllerExpandSecretRef, Secr
         this.volumeHandle = volumeHandle;
     }
 
+    /**
+     * Represents storage that is managed by an external CSI volume driver
+     */
     @JsonProperty("controllerExpandSecretRef")
     public SecretReference getControllerExpandSecretRef() {
         return controllerExpandSecretRef;
     }
 
+    /**
+     * Represents storage that is managed by an external CSI volume driver
+     */
     @JsonProperty("controllerExpandSecretRef")
     public void setControllerExpandSecretRef(SecretReference controllerExpandSecretRef) {
         this.controllerExpandSecretRef = controllerExpandSecretRef;
     }
 
+    /**
+     * Represents storage that is managed by an external CSI volume driver
+     */
     @JsonProperty("controllerPublishSecretRef")
     public SecretReference getControllerPublishSecretRef() {
         return controllerPublishSecretRef;
     }
 
+    /**
+     * Represents storage that is managed by an external CSI volume driver
+     */
     @JsonProperty("controllerPublishSecretRef")
     public void setControllerPublishSecretRef(SecretReference controllerPublishSecretRef) {
         this.controllerPublishSecretRef = controllerPublishSecretRef;
     }
 
+    /**
+     * driver is the name of the driver to use for this volume. Required.
+     */
     @JsonProperty("driver")
     public String getDriver() {
         return driver;
     }
 
+    /**
+     * driver is the name of the driver to use for this volume. Required.
+     */
     @JsonProperty("driver")
     public void setDriver(String driver) {
         this.driver = driver;
     }
 
+    /**
+     * fsType to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs".
+     */
     @JsonProperty("fsType")
     public String getFsType() {
         return fsType;
     }
 
+    /**
+     * fsType to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs".
+     */
     @JsonProperty("fsType")
     public void setFsType(String fsType) {
         this.fsType = fsType;
     }
 
+    /**
+     * Represents storage that is managed by an external CSI volume driver
+     */
     @JsonProperty("nodeExpandSecretRef")
     public SecretReference getNodeExpandSecretRef() {
         return nodeExpandSecretRef;
     }
 
+    /**
+     * Represents storage that is managed by an external CSI volume driver
+     */
     @JsonProperty("nodeExpandSecretRef")
     public void setNodeExpandSecretRef(SecretReference nodeExpandSecretRef) {
         this.nodeExpandSecretRef = nodeExpandSecretRef;
     }
 
+    /**
+     * Represents storage that is managed by an external CSI volume driver
+     */
     @JsonProperty("nodePublishSecretRef")
     public SecretReference getNodePublishSecretRef() {
         return nodePublishSecretRef;
     }
 
+    /**
+     * Represents storage that is managed by an external CSI volume driver
+     */
     @JsonProperty("nodePublishSecretRef")
     public void setNodePublishSecretRef(SecretReference nodePublishSecretRef) {
         this.nodePublishSecretRef = nodePublishSecretRef;
     }
 
+    /**
+     * Represents storage that is managed by an external CSI volume driver
+     */
     @JsonProperty("nodeStageSecretRef")
     public SecretReference getNodeStageSecretRef() {
         return nodeStageSecretRef;
     }
 
+    /**
+     * Represents storage that is managed by an external CSI volume driver
+     */
     @JsonProperty("nodeStageSecretRef")
     public void setNodeStageSecretRef(SecretReference nodeStageSecretRef) {
         this.nodeStageSecretRef = nodeStageSecretRef;
     }
 
+    /**
+     * readOnly value to pass to ControllerPublishVolumeRequest. Defaults to false (read/write).
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly value to pass to ControllerPublishVolumeRequest. Defaults to false (read/write).
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * volumeAttributes of the volume to publish.
+     */
     @JsonProperty("volumeAttributes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getVolumeAttributes() {
         return volumeAttributes;
     }
 
+    /**
+     * volumeAttributes of the volume to publish.
+     */
     @JsonProperty("volumeAttributes")
     public void setVolumeAttributes(Map<String, String> volumeAttributes) {
         this.volumeAttributes = volumeAttributes;
     }
 
+    /**
+     * volumeHandle is the unique volume name returned by the CSI volume plugin’s CreateVolume to refer to the volume on all subsequent calls. Required.
+     */
     @JsonProperty("volumeHandle")
     public String getVolumeHandle() {
         return volumeHandle;
     }
 
+    /**
+     * volumeHandle is the unique volume name returned by the CSI volume plugin’s CreateVolume to refer to the volume on all subsequent calls. Required.
+     */
     @JsonProperty("volumeHandle")
     public void setVolumeHandle(String volumeHandle) {
         this.volumeHandle = volumeHandle;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/CSIVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/CSIVolumeSource.java
index 10333823068..24afce266df 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/CSIVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/CSIVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Represents a source location of a volume to mount, managed by an external CSI driver
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -66,52 +69,82 @@ public CSIVolumeSource(String driver, String fsType, LocalObjectReference nodePu
         this.volumeAttributes = volumeAttributes;
     }
 
+    /**
+     * driver is the name of the CSI driver that handles this volume. Consult with your admin for the correct name as registered in the cluster.
+     */
     @JsonProperty("driver")
     public String getDriver() {
         return driver;
     }
 
+    /**
+     * driver is the name of the CSI driver that handles this volume. Consult with your admin for the correct name as registered in the cluster.
+     */
     @JsonProperty("driver")
     public void setDriver(String driver) {
         this.driver = driver;
     }
 
+    /**
+     * fsType to mount. Ex. "ext4", "xfs", "ntfs". If not provided, the empty value is passed to the associated CSI driver which will determine the default filesystem to apply.
+     */
     @JsonProperty("fsType")
     public String getFsType() {
         return fsType;
     }
 
+    /**
+     * fsType to mount. Ex. "ext4", "xfs", "ntfs". If not provided, the empty value is passed to the associated CSI driver which will determine the default filesystem to apply.
+     */
     @JsonProperty("fsType")
     public void setFsType(String fsType) {
         this.fsType = fsType;
     }
 
+    /**
+     * Represents a source location of a volume to mount, managed by an external CSI driver
+     */
     @JsonProperty("nodePublishSecretRef")
     public LocalObjectReference getNodePublishSecretRef() {
         return nodePublishSecretRef;
     }
 
+    /**
+     * Represents a source location of a volume to mount, managed by an external CSI driver
+     */
     @JsonProperty("nodePublishSecretRef")
     public void setNodePublishSecretRef(LocalObjectReference nodePublishSecretRef) {
         this.nodePublishSecretRef = nodePublishSecretRef;
     }
 
+    /**
+     * readOnly specifies a read-only configuration for the volume. Defaults to false (read/write).
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly specifies a read-only configuration for the volume. Defaults to false (read/write).
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * volumeAttributes stores driver-specific properties that are passed to the CSI driver. Consult your driver's documentation for supported values.
+     */
     @JsonProperty("volumeAttributes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getVolumeAttributes() {
         return volumeAttributes;
     }
 
+    /**
+     * volumeAttributes stores driver-specific properties that are passed to the CSI driver. Consult your driver's documentation for supported values.
+     */
     @JsonProperty("volumeAttributes")
     public void setVolumeAttributes(Map<String, String> volumeAttributes) {
         this.volumeAttributes = volumeAttributes;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Capabilities.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Capabilities.java
index ea37637b924..feca5c8375c 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Capabilities.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Capabilities.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Adds and removes POSIX capabilities from running containers.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -57,23 +60,35 @@ public Capabilities(List<String> add, List<String> drop) {
         this.drop = drop;
     }
 
+    /**
+     * Added capabilities
+     */
     @JsonProperty("add")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAdd() {
         return add;
     }
 
+    /**
+     * Added capabilities
+     */
     @JsonProperty("add")
     public void setAdd(List<String> add) {
         this.add = add;
     }
 
+    /**
+     * Removed capabilities
+     */
     @JsonProperty("drop")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDrop() {
         return drop;
     }
 
+    /**
+     * Removed capabilities
+     */
     @JsonProperty("drop")
     public void setDrop(List<String> drop) {
         this.drop = drop;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/CephFSPersistentVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/CephFSPersistentVolumeSource.java
index b4e5e23274d..c522b18f04c 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/CephFSPersistentVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/CephFSPersistentVolumeSource.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Represents a Ceph Filesystem mount that lasts the lifetime of a pod Cephfs volumes do not support ownership management or SELinux relabeling.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -72,62 +75,98 @@ public CephFSPersistentVolumeSource(List<String> monitors, String path, Boolean
         this.user = user;
     }
 
+    /**
+     * monitors is Required: Monitors is a collection of Ceph monitors More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
+     */
     @JsonProperty("monitors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMonitors() {
         return monitors;
     }
 
+    /**
+     * monitors is Required: Monitors is a collection of Ceph monitors More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
+     */
     @JsonProperty("monitors")
     public void setMonitors(List<String> monitors) {
         this.monitors = monitors;
     }
 
+    /**
+     * path is Optional: Used as the mounted root, rather than the full Ceph tree, default is /
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * path is Optional: Used as the mounted root, rather than the full Ceph tree, default is /
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * readOnly is Optional: Defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts. More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly is Optional: Defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts. More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * secretFile is Optional: SecretFile is the path to key ring for User, default is /etc/ceph/user.secret More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
+     */
     @JsonProperty("secretFile")
     public String getSecretFile() {
         return secretFile;
     }
 
+    /**
+     * secretFile is Optional: SecretFile is the path to key ring for User, default is /etc/ceph/user.secret More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
+     */
     @JsonProperty("secretFile")
     public void setSecretFile(String secretFile) {
         this.secretFile = secretFile;
     }
 
+    /**
+     * Represents a Ceph Filesystem mount that lasts the lifetime of a pod Cephfs volumes do not support ownership management or SELinux relabeling.
+     */
     @JsonProperty("secretRef")
     public SecretReference getSecretRef() {
         return secretRef;
     }
 
+    /**
+     * Represents a Ceph Filesystem mount that lasts the lifetime of a pod Cephfs volumes do not support ownership management or SELinux relabeling.
+     */
     @JsonProperty("secretRef")
     public void setSecretRef(SecretReference secretRef) {
         this.secretRef = secretRef;
     }
 
+    /**
+     * user is Optional: User is the rados user name, default is admin More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
+     */
     @JsonProperty("user")
     public String getUser() {
         return user;
     }
 
+    /**
+     * user is Optional: User is the rados user name, default is admin More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
+     */
     @JsonProperty("user")
     public void setUser(String user) {
         this.user = user;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/CephFSVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/CephFSVolumeSource.java
index ca902bd45fe..d56887119bf 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/CephFSVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/CephFSVolumeSource.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Represents a Ceph Filesystem mount that lasts the lifetime of a pod Cephfs volumes do not support ownership management or SELinux relabeling.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -72,62 +75,98 @@ public CephFSVolumeSource(List<String> monitors, String path, Boolean readOnly,
         this.user = user;
     }
 
+    /**
+     * monitors is Required: Monitors is a collection of Ceph monitors More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
+     */
     @JsonProperty("monitors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMonitors() {
         return monitors;
     }
 
+    /**
+     * monitors is Required: Monitors is a collection of Ceph monitors More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
+     */
     @JsonProperty("monitors")
     public void setMonitors(List<String> monitors) {
         this.monitors = monitors;
     }
 
+    /**
+     * path is Optional: Used as the mounted root, rather than the full Ceph tree, default is /
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * path is Optional: Used as the mounted root, rather than the full Ceph tree, default is /
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * readOnly is Optional: Defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts. More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly is Optional: Defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts. More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * secretFile is Optional: SecretFile is the path to key ring for User, default is /etc/ceph/user.secret More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
+     */
     @JsonProperty("secretFile")
     public String getSecretFile() {
         return secretFile;
     }
 
+    /**
+     * secretFile is Optional: SecretFile is the path to key ring for User, default is /etc/ceph/user.secret More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
+     */
     @JsonProperty("secretFile")
     public void setSecretFile(String secretFile) {
         this.secretFile = secretFile;
     }
 
+    /**
+     * Represents a Ceph Filesystem mount that lasts the lifetime of a pod Cephfs volumes do not support ownership management or SELinux relabeling.
+     */
     @JsonProperty("secretRef")
     public LocalObjectReference getSecretRef() {
         return secretRef;
     }
 
+    /**
+     * Represents a Ceph Filesystem mount that lasts the lifetime of a pod Cephfs volumes do not support ownership management or SELinux relabeling.
+     */
     @JsonProperty("secretRef")
     public void setSecretRef(LocalObjectReference secretRef) {
         this.secretRef = secretRef;
     }
 
+    /**
+     * user is optional: User is the rados user name, default is admin More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
+     */
     @JsonProperty("user")
     public String getUser() {
         return user;
     }
 
+    /**
+     * user is optional: User is the rados user name, default is admin More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
+     */
     @JsonProperty("user")
     public void setUser(String user) {
         this.user = user;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/CinderPersistentVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/CinderPersistentVolumeSource.java
index f73f30c0194..740ad026223 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/CinderPersistentVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/CinderPersistentVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Represents a cinder volume resource in Openstack. A Cinder volume must exist before mounting to a container. The volume must also be in the same region as the kubelet. Cinder volumes support ownership management and SELinux relabeling.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -61,41 +64,65 @@ public CinderPersistentVolumeSource(String fsType, Boolean readOnly, SecretRefer
         this.volumeID = volumeID;
     }
 
+    /**
+     * fsType Filesystem type to mount. Must be a filesystem type supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified. More info: https://examples.k8s.io/mysql-cinder-pd/README.md
+     */
     @JsonProperty("fsType")
     public String getFsType() {
         return fsType;
     }
 
+    /**
+     * fsType Filesystem type to mount. Must be a filesystem type supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified. More info: https://examples.k8s.io/mysql-cinder-pd/README.md
+     */
     @JsonProperty("fsType")
     public void setFsType(String fsType) {
         this.fsType = fsType;
     }
 
+    /**
+     * readOnly is Optional: Defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts. More info: https://examples.k8s.io/mysql-cinder-pd/README.md
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly is Optional: Defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts. More info: https://examples.k8s.io/mysql-cinder-pd/README.md
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * Represents a cinder volume resource in Openstack. A Cinder volume must exist before mounting to a container. The volume must also be in the same region as the kubelet. Cinder volumes support ownership management and SELinux relabeling.
+     */
     @JsonProperty("secretRef")
     public SecretReference getSecretRef() {
         return secretRef;
     }
 
+    /**
+     * Represents a cinder volume resource in Openstack. A Cinder volume must exist before mounting to a container. The volume must also be in the same region as the kubelet. Cinder volumes support ownership management and SELinux relabeling.
+     */
     @JsonProperty("secretRef")
     public void setSecretRef(SecretReference secretRef) {
         this.secretRef = secretRef;
     }
 
+    /**
+     * volumeID used to identify the volume in cinder. More info: https://examples.k8s.io/mysql-cinder-pd/README.md
+     */
     @JsonProperty("volumeID")
     public String getVolumeID() {
         return volumeID;
     }
 
+    /**
+     * volumeID used to identify the volume in cinder. More info: https://examples.k8s.io/mysql-cinder-pd/README.md
+     */
     @JsonProperty("volumeID")
     public void setVolumeID(String volumeID) {
         this.volumeID = volumeID;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/CinderVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/CinderVolumeSource.java
index 68ebd3dddd6..1cad4a3f142 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/CinderVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/CinderVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Represents a cinder volume resource in Openstack. A Cinder volume must exist before mounting to a container. The volume must also be in the same region as the kubelet. Cinder volumes support ownership management and SELinux relabeling.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -61,41 +64,65 @@ public CinderVolumeSource(String fsType, Boolean readOnly, LocalObjectReference
         this.volumeID = volumeID;
     }
 
+    /**
+     * fsType is the filesystem type to mount. Must be a filesystem type supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified. More info: https://examples.k8s.io/mysql-cinder-pd/README.md
+     */
     @JsonProperty("fsType")
     public String getFsType() {
         return fsType;
     }
 
+    /**
+     * fsType is the filesystem type to mount. Must be a filesystem type supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified. More info: https://examples.k8s.io/mysql-cinder-pd/README.md
+     */
     @JsonProperty("fsType")
     public void setFsType(String fsType) {
         this.fsType = fsType;
     }
 
+    /**
+     * readOnly defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts. More info: https://examples.k8s.io/mysql-cinder-pd/README.md
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts. More info: https://examples.k8s.io/mysql-cinder-pd/README.md
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * Represents a cinder volume resource in Openstack. A Cinder volume must exist before mounting to a container. The volume must also be in the same region as the kubelet. Cinder volumes support ownership management and SELinux relabeling.
+     */
     @JsonProperty("secretRef")
     public LocalObjectReference getSecretRef() {
         return secretRef;
     }
 
+    /**
+     * Represents a cinder volume resource in Openstack. A Cinder volume must exist before mounting to a container. The volume must also be in the same region as the kubelet. Cinder volumes support ownership management and SELinux relabeling.
+     */
     @JsonProperty("secretRef")
     public void setSecretRef(LocalObjectReference secretRef) {
         this.secretRef = secretRef;
     }
 
+    /**
+     * volumeID used to identify the volume in cinder. More info: https://examples.k8s.io/mysql-cinder-pd/README.md
+     */
     @JsonProperty("volumeID")
     public String getVolumeID() {
         return volumeID;
     }
 
+    /**
+     * volumeID used to identify the volume in cinder. More info: https://examples.k8s.io/mysql-cinder-pd/README.md
+     */
     @JsonProperty("volumeID")
     public void setVolumeID(String volumeID) {
         this.volumeID = volumeID;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ClientIPConfig.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ClientIPConfig.java
index 0e28fe1087c..e3d20c45346 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ClientIPConfig.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ClientIPConfig.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClientIPConfig represents the configurations of Client IP based session affinity.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -49,11 +52,17 @@ public ClientIPConfig(Integer timeoutSeconds) {
         this.timeoutSeconds = timeoutSeconds;
     }
 
+    /**
+     * timeoutSeconds specifies the seconds of ClientIP type session sticky time. The value must be &gt;0 &amp;&amp; &lt;=86400(for 1 day) if ServiceAffinity == "ClientIP". Default value is 10800(for 3 hours).
+     */
     @JsonProperty("timeoutSeconds")
     public Integer getTimeoutSeconds() {
         return timeoutSeconds;
     }
 
+    /**
+     * timeoutSeconds specifies the seconds of ClientIP type session sticky time. The value must be &gt;0 &amp;&amp; &lt;=86400(for 1 day) if ServiceAffinity == "ClientIP". Default value is 10800(for 3 hours).
+     */
     @JsonProperty("timeoutSeconds")
     public void setTimeoutSeconds(Integer timeoutSeconds) {
         this.timeoutSeconds = timeoutSeconds;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ClusterTrustBundleProjection.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ClusterTrustBundleProjection.java
index 1e1e2240f49..4955db72b1e 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ClusterTrustBundleProjection.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ClusterTrustBundleProjection.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterTrustBundleProjection describes how to select a set of ClusterTrustBundle objects and project their contents into the pod filesystem.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -65,51 +68,81 @@ public ClusterTrustBundleProjection(LabelSelector labelSelector, String name, Bo
         this.signerName = signerName;
     }
 
+    /**
+     * ClusterTrustBundleProjection describes how to select a set of ClusterTrustBundle objects and project their contents into the pod filesystem.
+     */
     @JsonProperty("labelSelector")
     public LabelSelector getLabelSelector() {
         return labelSelector;
     }
 
+    /**
+     * ClusterTrustBundleProjection describes how to select a set of ClusterTrustBundle objects and project their contents into the pod filesystem.
+     */
     @JsonProperty("labelSelector")
     public void setLabelSelector(LabelSelector labelSelector) {
         this.labelSelector = labelSelector;
     }
 
+    /**
+     * Select a single ClusterTrustBundle by object name.  Mutually-exclusive with signerName and labelSelector.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Select a single ClusterTrustBundle by object name.  Mutually-exclusive with signerName and labelSelector.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * If true, don't block pod startup if the referenced ClusterTrustBundle(s) aren't available.  If using name, then the named ClusterTrustBundle is allowed not to exist.  If using signerName, then the combination of signerName and labelSelector is allowed to match zero ClusterTrustBundles.
+     */
     @JsonProperty("optional")
     public Boolean getOptional() {
         return optional;
     }
 
+    /**
+     * If true, don't block pod startup if the referenced ClusterTrustBundle(s) aren't available.  If using name, then the named ClusterTrustBundle is allowed not to exist.  If using signerName, then the combination of signerName and labelSelector is allowed to match zero ClusterTrustBundles.
+     */
     @JsonProperty("optional")
     public void setOptional(Boolean optional) {
         this.optional = optional;
     }
 
+    /**
+     * Relative path from the volume root to write the bundle.
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Relative path from the volume root to write the bundle.
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * Select all ClusterTrustBundles that match this signer name. Mutually-exclusive with name.  The contents of all selected ClusterTrustBundles will be unified and deduplicated.
+     */
     @JsonProperty("signerName")
     public String getSignerName() {
         return signerName;
     }
 
+    /**
+     * Select all ClusterTrustBundles that match this signer name. Mutually-exclusive with name.  The contents of all selected ClusterTrustBundles will be unified and deduplicated.
+     */
     @JsonProperty("signerName")
     public void setSignerName(String signerName) {
         this.signerName = signerName;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ComponentCondition.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ComponentCondition.java
index 9b303009128..019b9ac2de7 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ComponentCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ComponentCondition.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Information about the condition of a component.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -61,41 +64,65 @@ public ComponentCondition(String error, String message, String status, String ty
         this.type = type;
     }
 
+    /**
+     * Condition error code for a component. For example, a health check error code.
+     */
     @JsonProperty("error")
     public String getError() {
         return error;
     }
 
+    /**
+     * Condition error code for a component. For example, a health check error code.
+     */
     @JsonProperty("error")
     public void setError(String error) {
         this.error = error;
     }
 
+    /**
+     * Message about the condition for a component. For example, information about a health check.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message about the condition for a component. For example, information about a health check.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Status of the condition for a component. Valid values for "Healthy": "True", "False", or "Unknown".
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition for a component. Valid values for "Healthy": "True", "False", or "Unknown".
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type of condition for a component. Valid value: "Healthy"
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of condition for a component. Valid value: "Healthy"
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ComponentStatus.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ComponentStatus.java
index 0b8ca56e38c..b6b290876c7 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ComponentStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ComponentStatus.java
@@ -23,6 +23,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ComponentStatus (and ComponentStatusList) holds the cluster validation info. Deprecated: This API is deprecated in v1.19+
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -47,17 +50,11 @@
 public class ComponentStatus implements Editable<ComponentStatusBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<ComponentCondition> conditions = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ComponentStatus";
     @JsonProperty("metadata")
@@ -80,7 +77,7 @@ public ComponentStatus(String apiVersion, List<ComponentCondition> conditions, S
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -88,26 +85,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of component conditions observed
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ComponentCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * List of component conditions observed
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ComponentCondition> conditions) {
         this.conditions = conditions;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -115,18 +118,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ComponentStatus (and ComponentStatusList) holds the cluster validation info. Deprecated: This API is deprecated in v1.19+
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ComponentStatus (and ComponentStatusList) holds the cluster validation info. Deprecated: This API is deprecated in v1.19+
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ComponentStatusList.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ComponentStatusList.java
index f8bff1d939a..65508f39bdf 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ComponentStatusList.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ComponentStatusList.java
@@ -23,6 +23,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Status of all the conditions for the component as a list of ComponentStatus objects. Deprecated: This API is deprecated in v1.19+
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -47,17 +50,11 @@
 public class ComponentStatusList implements Editable<ComponentStatusListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.ComponentStatus>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.ComponentStatus> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ComponentStatusList";
     @JsonProperty("metadata")
@@ -80,7 +77,7 @@ public ComponentStatusList(String apiVersion, List<io.fabric8.kubernetes.api.mod
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -88,26 +85,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of ComponentStatus objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.ComponentStatus> getItems() {
         return items;
     }
 
+    /**
+     * List of ComponentStatus objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.ComponentStatus> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -115,18 +118,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Status of all the conditions for the component as a list of ComponentStatus objects. Deprecated: This API is deprecated in v1.19+
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Status of all the conditions for the component as a list of ComponentStatus objects. Deprecated: This API is deprecated in v1.19+
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Condition.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Condition.java
index 6711b4533d8..ecc4cd037b0 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Condition.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Condition.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Condition contains details for one aspect of the current state of this API Resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -69,61 +72,97 @@ public Condition(String lastTransitionTime, String message, Long observedGenerat
         this.type = type;
     }
 
+    /**
+     * Condition contains details for one aspect of the current state of this API Resource.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * Condition contains details for one aspect of the current state of this API Resource.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * message is a human readable message indicating details about the transition. This may be an empty string.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message is a human readable message indicating details about the transition. This may be an empty string.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * observedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date with respect to the current state of the instance.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date with respect to the current state of the instance.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * reason contains a programmatic identifier indicating the reason for the condition's last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * reason contains a programmatic identifier indicating the reason for the condition's last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * type of condition in CamelCase or in foo.example.com/CamelCase.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type of condition in CamelCase or in foo.example.com/CamelCase.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ConfigMap.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ConfigMap.java
index 8c1a55322b2..1ffd0fd9f04 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ConfigMap.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ConfigMap.java
@@ -21,6 +21,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConfigMap holds configuration data for pods to consume.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -47,9 +50,6 @@
 public class ConfigMap implements Editable<ConfigMapBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("binaryData")
@@ -60,9 +60,6 @@ public class ConfigMap implements Editable<ConfigMapBuilder>, HasMetadata, Names
     private Map<String, String> data = new LinkedHashMap<>();
     @JsonProperty("immutable")
     private Boolean immutable;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ConfigMap";
     @JsonProperty("metadata")
@@ -87,7 +84,7 @@ public ConfigMap(String apiVersion, Map<String, String> binaryData, Map<String,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -95,47 +92,65 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * BinaryData contains the binary data. Each key must consist of alphanumeric characters, '-', '_' or '.'. BinaryData can contain byte sequences that are not in the UTF-8 range. The keys stored in BinaryData must not overlap with the ones in the Data field, this is enforced during validation process. Using this field will require 1.10+ apiserver and kubelet.
+     */
     @JsonProperty("binaryData")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getBinaryData() {
         return binaryData;
     }
 
+    /**
+     * BinaryData contains the binary data. Each key must consist of alphanumeric characters, '-', '_' or '.'. BinaryData can contain byte sequences that are not in the UTF-8 range. The keys stored in BinaryData must not overlap with the ones in the Data field, this is enforced during validation process. Using this field will require 1.10+ apiserver and kubelet.
+     */
     @JsonProperty("binaryData")
     public void setBinaryData(Map<String, String> binaryData) {
         this.binaryData = binaryData;
     }
 
+    /**
+     * Data contains the configuration data. Each key must consist of alphanumeric characters, '-', '_' or '.'. Values with non-UTF-8 byte sequences must use the BinaryData field. The keys stored in Data must not overlap with the keys in the BinaryData field, this is enforced during validation process.
+     */
     @JsonProperty("data")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getData() {
         return data;
     }
 
+    /**
+     * Data contains the configuration data. Each key must consist of alphanumeric characters, '-', '_' or '.'. Values with non-UTF-8 byte sequences must use the BinaryData field. The keys stored in Data must not overlap with the keys in the BinaryData field, this is enforced during validation process.
+     */
     @JsonProperty("data")
     public void setData(Map<String, String> data) {
         this.data = data;
     }
 
+    /**
+     * Immutable, if set to true, ensures that data stored in the ConfigMap cannot be updated (only object metadata can be modified). If not set to true, the field can be modified at any time. Defaulted to nil.
+     */
     @JsonProperty("immutable")
     public Boolean getImmutable() {
         return immutable;
     }
 
+    /**
+     * Immutable, if set to true, ensures that data stored in the ConfigMap cannot be updated (only object metadata can be modified). If not set to true, the field can be modified at any time. Defaulted to nil.
+     */
     @JsonProperty("immutable")
     public void setImmutable(Boolean immutable) {
         this.immutable = immutable;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -143,18 +158,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ConfigMap holds configuration data for pods to consume.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ConfigMap holds configuration data for pods to consume.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ConfigMapEnvSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ConfigMapEnvSource.java
index c0dc1d7048f..cd271dbfa4f 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ConfigMapEnvSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ConfigMapEnvSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConfigMapEnvSource selects a ConfigMap to populate the environment variables with.<br><p> <br><p> The contents of the target ConfigMap's Data field will represent the key-value pairs as environment variables.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public ConfigMapEnvSource(String name, Boolean optional) {
         this.optional = optional;
     }
 
+    /**
+     * Name of the referent. This field is effectively required, but due to backwards compatibility is allowed to be empty. Instances of this type with an empty value here are almost certainly wrong. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referent. This field is effectively required, but due to backwards compatibility is allowed to be empty. Instances of this type with an empty value here are almost certainly wrong. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Specify whether the ConfigMap must be defined
+     */
     @JsonProperty("optional")
     public Boolean getOptional() {
         return optional;
     }
 
+    /**
+     * Specify whether the ConfigMap must be defined
+     */
     @JsonProperty("optional")
     public void setOptional(Boolean optional) {
         this.optional = optional;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ConfigMapKeySelector.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ConfigMapKeySelector.java
index 1be15763fcf..6e9c5af8b1b 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ConfigMapKeySelector.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ConfigMapKeySelector.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Selects a key from a ConfigMap.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -57,31 +60,49 @@ public ConfigMapKeySelector(String key, String name, Boolean optional) {
         this.optional = optional;
     }
 
+    /**
+     * The key to select.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * The key to select.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * Name of the referent. This field is effectively required, but due to backwards compatibility is allowed to be empty. Instances of this type with an empty value here are almost certainly wrong. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referent. This field is effectively required, but due to backwards compatibility is allowed to be empty. Instances of this type with an empty value here are almost certainly wrong. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Specify whether the ConfigMap or its key must be defined
+     */
     @JsonProperty("optional")
     public Boolean getOptional() {
         return optional;
     }
 
+    /**
+     * Specify whether the ConfigMap or its key must be defined
+     */
     @JsonProperty("optional")
     public void setOptional(Boolean optional) {
         this.optional = optional;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ConfigMapList.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ConfigMapList.java
index 9ebf69116fc..fe7d948f2ba 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ConfigMapList.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ConfigMapList.java
@@ -23,6 +23,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConfigMapList is a resource containing a list of ConfigMap objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -47,17 +50,11 @@
 public class ConfigMapList implements Editable<ConfigMapListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.ConfigMap>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.ConfigMap> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ConfigMapList";
     @JsonProperty("metadata")
@@ -80,7 +77,7 @@ public ConfigMapList(String apiVersion, List<io.fabric8.kubernetes.api.model.Con
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -88,26 +85,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of ConfigMaps.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.ConfigMap> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of ConfigMaps.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.ConfigMap> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -115,18 +118,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ConfigMapList is a resource containing a list of ConfigMap objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ConfigMapList is a resource containing a list of ConfigMap objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ConfigMapNodeConfigSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ConfigMapNodeConfigSource.java
index bb7e7882f62..1a93307c565 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ConfigMapNodeConfigSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ConfigMapNodeConfigSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConfigMapNodeConfigSource contains the information to reference a ConfigMap as a config source for the Node. This API is deprecated since 1.22: https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -65,51 +68,81 @@ public ConfigMapNodeConfigSource(String kubeletConfigKey, String name, String na
         this.uid = uid;
     }
 
+    /**
+     * KubeletConfigKey declares which key of the referenced ConfigMap corresponds to the KubeletConfiguration structure This field is required in all cases.
+     */
     @JsonProperty("kubeletConfigKey")
     public String getKubeletConfigKey() {
         return kubeletConfigKey;
     }
 
+    /**
+     * KubeletConfigKey declares which key of the referenced ConfigMap corresponds to the KubeletConfiguration structure This field is required in all cases.
+     */
     @JsonProperty("kubeletConfigKey")
     public void setKubeletConfigKey(String kubeletConfigKey) {
         this.kubeletConfigKey = kubeletConfigKey;
     }
 
+    /**
+     * Name is the metadata.name of the referenced ConfigMap. This field is required in all cases.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the metadata.name of the referenced ConfigMap. This field is required in all cases.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace is the metadata.namespace of the referenced ConfigMap. This field is required in all cases.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the metadata.namespace of the referenced ConfigMap. This field is required in all cases.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * ResourceVersion is the metadata.ResourceVersion of the referenced ConfigMap. This field is forbidden in Node.Spec, and required in Node.Status.
+     */
     @JsonProperty("resourceVersion")
     public String getResourceVersion() {
         return resourceVersion;
     }
 
+    /**
+     * ResourceVersion is the metadata.ResourceVersion of the referenced ConfigMap. This field is forbidden in Node.Spec, and required in Node.Status.
+     */
     @JsonProperty("resourceVersion")
     public void setResourceVersion(String resourceVersion) {
         this.resourceVersion = resourceVersion;
     }
 
+    /**
+     * UID is the metadata.UID of the referenced ConfigMap. This field is forbidden in Node.Spec, and required in Node.Status.
+     */
     @JsonProperty("uid")
     public String getUid() {
         return uid;
     }
 
+    /**
+     * UID is the metadata.UID of the referenced ConfigMap. This field is forbidden in Node.Spec, and required in Node.Status.
+     */
     @JsonProperty("uid")
     public void setUid(String uid) {
         this.uid = uid;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ConfigMapProjection.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ConfigMapProjection.java
index 6f138e5045d..e59bce55ff1 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ConfigMapProjection.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ConfigMapProjection.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Adapts a ConfigMap into a projected volume.<br><p> <br><p> The contents of the target ConfigMap's Data field will be presented in a projected volume as files using the keys in the Data field as the file names, unless the items element is populated with specific mappings of keys to paths. Note that this is identical to a configmap volume source without the default mode.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -60,32 +63,50 @@ public ConfigMapProjection(List<KeyToPath> items, String name, Boolean optional)
         this.optional = optional;
     }
 
+    /**
+     * items if unspecified, each key-value pair in the Data field of the referenced ConfigMap will be projected into the volume as a file whose name is the key and content is the value. If specified, the listed keys will be projected into the specified paths, and unlisted keys will not be present. If a key is specified which is not present in the ConfigMap, the volume setup will error unless it is marked optional. Paths must be relative and may not contain the '..' path or start with '..'.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<KeyToPath> getItems() {
         return items;
     }
 
+    /**
+     * items if unspecified, each key-value pair in the Data field of the referenced ConfigMap will be projected into the volume as a file whose name is the key and content is the value. If specified, the listed keys will be projected into the specified paths, and unlisted keys will not be present. If a key is specified which is not present in the ConfigMap, the volume setup will error unless it is marked optional. Paths must be relative and may not contain the '..' path or start with '..'.
+     */
     @JsonProperty("items")
     public void setItems(List<KeyToPath> items) {
         this.items = items;
     }
 
+    /**
+     * Name of the referent. This field is effectively required, but due to backwards compatibility is allowed to be empty. Instances of this type with an empty value here are almost certainly wrong. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referent. This field is effectively required, but due to backwards compatibility is allowed to be empty. Instances of this type with an empty value here are almost certainly wrong. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * optional specify whether the ConfigMap or its keys must be defined
+     */
     @JsonProperty("optional")
     public Boolean getOptional() {
         return optional;
     }
 
+    /**
+     * optional specify whether the ConfigMap or its keys must be defined
+     */
     @JsonProperty("optional")
     public void setOptional(Boolean optional) {
         this.optional = optional;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ConfigMapVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ConfigMapVolumeSource.java
index ed3ca4b1642..00ee0beed76 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ConfigMapVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ConfigMapVolumeSource.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Adapts a ConfigMap into a volume.<br><p> <br><p> The contents of the target ConfigMap's Data field will be presented in a volume as files using the keys in the Data field as the file names, unless the items element is populated with specific mappings of keys to paths. ConfigMap volumes support ownership management and SELinux relabeling.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -64,42 +67,66 @@ public ConfigMapVolumeSource(Integer defaultMode, List<KeyToPath> items, String
         this.optional = optional;
     }
 
+    /**
+     * defaultMode is optional: mode bits used to set permissions on created files by default. Must be an octal value between 0000 and 0777 or a decimal value between 0 and 511. YAML accepts both octal and decimal values, JSON requires decimal values for mode bits. Defaults to 0644. Directories within the path are not affected by this setting. This might be in conflict with other options that affect the file mode, like fsGroup, and the result can be other mode bits set.
+     */
     @JsonProperty("defaultMode")
     public Integer getDefaultMode() {
         return defaultMode;
     }
 
+    /**
+     * defaultMode is optional: mode bits used to set permissions on created files by default. Must be an octal value between 0000 and 0777 or a decimal value between 0 and 511. YAML accepts both octal and decimal values, JSON requires decimal values for mode bits. Defaults to 0644. Directories within the path are not affected by this setting. This might be in conflict with other options that affect the file mode, like fsGroup, and the result can be other mode bits set.
+     */
     @JsonProperty("defaultMode")
     public void setDefaultMode(Integer defaultMode) {
         this.defaultMode = defaultMode;
     }
 
+    /**
+     * items if unspecified, each key-value pair in the Data field of the referenced ConfigMap will be projected into the volume as a file whose name is the key and content is the value. If specified, the listed keys will be projected into the specified paths, and unlisted keys will not be present. If a key is specified which is not present in the ConfigMap, the volume setup will error unless it is marked optional. Paths must be relative and may not contain the '..' path or start with '..'.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<KeyToPath> getItems() {
         return items;
     }
 
+    /**
+     * items if unspecified, each key-value pair in the Data field of the referenced ConfigMap will be projected into the volume as a file whose name is the key and content is the value. If specified, the listed keys will be projected into the specified paths, and unlisted keys will not be present. If a key is specified which is not present in the ConfigMap, the volume setup will error unless it is marked optional. Paths must be relative and may not contain the '..' path or start with '..'.
+     */
     @JsonProperty("items")
     public void setItems(List<KeyToPath> items) {
         this.items = items;
     }
 
+    /**
+     * Name of the referent. This field is effectively required, but due to backwards compatibility is allowed to be empty. Instances of this type with an empty value here are almost certainly wrong. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referent. This field is effectively required, but due to backwards compatibility is allowed to be empty. Instances of this type with an empty value here are almost certainly wrong. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * optional specify whether the ConfigMap or its keys must be defined
+     */
     @JsonProperty("optional")
     public Boolean getOptional() {
         return optional;
     }
 
+    /**
+     * optional specify whether the ConfigMap or its keys must be defined
+     */
     @JsonProperty("optional")
     public void setOptional(Boolean optional) {
         this.optional = optional;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Container.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Container.java
index 643b91f865d..2a9dff26524 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Container.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Container.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * A single application container that you want to run within a pod.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -151,249 +154,393 @@ public Container(List<String> args, List<String> command, List<EnvVar> env, List
         this.workingDir = workingDir;
     }
 
+    /**
+     * Arguments to the entrypoint. The container image's CMD is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("args")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getArgs() {
         return args;
     }
 
+    /**
+     * Arguments to the entrypoint. The container image's CMD is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("args")
     public void setArgs(List<String> args) {
         this.args = args;
     }
 
+    /**
+     * Entrypoint array. Not executed within a shell. The container image's ENTRYPOINT is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("command")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCommand() {
         return command;
     }
 
+    /**
+     * Entrypoint array. Not executed within a shell. The container image's ENTRYPOINT is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("command")
     public void setCommand(List<String> command) {
         this.command = command;
     }
 
+    /**
+     * List of environment variables to set in the container. Cannot be updated.
+     */
     @JsonProperty("env")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvVar> getEnv() {
         return env;
     }
 
+    /**
+     * List of environment variables to set in the container. Cannot be updated.
+     */
     @JsonProperty("env")
     public void setEnv(List<EnvVar> env) {
         this.env = env;
     }
 
+    /**
+     * List of sources to populate environment variables in the container. The keys defined within a source must be a C_IDENTIFIER. All invalid keys will be reported as an event when the container is starting. When a key exists in multiple sources, the value associated with the last source will take precedence. Values defined by an Env with a duplicate key will take precedence. Cannot be updated.
+     */
     @JsonProperty("envFrom")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvFromSource> getEnvFrom() {
         return envFrom;
     }
 
+    /**
+     * List of sources to populate environment variables in the container. The keys defined within a source must be a C_IDENTIFIER. All invalid keys will be reported as an event when the container is starting. When a key exists in multiple sources, the value associated with the last source will take precedence. Values defined by an Env with a duplicate key will take precedence. Cannot be updated.
+     */
     @JsonProperty("envFrom")
     public void setEnvFrom(List<EnvFromSource> envFrom) {
         this.envFrom = envFrom;
     }
 
+    /**
+     * Container image name. More info: https://kubernetes.io/docs/concepts/containers/images This field is optional to allow higher level config management to default or override container images in workload controllers like Deployments and StatefulSets.
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * Container image name. More info: https://kubernetes.io/docs/concepts/containers/images This field is optional to allow higher level config management to default or override container images in workload controllers like Deployments and StatefulSets.
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
     }
 
+    /**
+     * Image pull policy. One of Always, Never, IfNotPresent. Defaults to Always if :latest tag is specified, or IfNotPresent otherwise. Cannot be updated. More info: https://kubernetes.io/docs/concepts/containers/images#updating-images
+     */
     @JsonProperty("imagePullPolicy")
     public String getImagePullPolicy() {
         return imagePullPolicy;
     }
 
+    /**
+     * Image pull policy. One of Always, Never, IfNotPresent. Defaults to Always if :latest tag is specified, or IfNotPresent otherwise. Cannot be updated. More info: https://kubernetes.io/docs/concepts/containers/images#updating-images
+     */
     @JsonProperty("imagePullPolicy")
     public void setImagePullPolicy(String imagePullPolicy) {
         this.imagePullPolicy = imagePullPolicy;
     }
 
+    /**
+     * A single application container that you want to run within a pod.
+     */
     @JsonProperty("lifecycle")
     public Lifecycle getLifecycle() {
         return lifecycle;
     }
 
+    /**
+     * A single application container that you want to run within a pod.
+     */
     @JsonProperty("lifecycle")
     public void setLifecycle(Lifecycle lifecycle) {
         this.lifecycle = lifecycle;
     }
 
+    /**
+     * A single application container that you want to run within a pod.
+     */
     @JsonProperty("livenessProbe")
     public Probe getLivenessProbe() {
         return livenessProbe;
     }
 
+    /**
+     * A single application container that you want to run within a pod.
+     */
     @JsonProperty("livenessProbe")
     public void setLivenessProbe(Probe livenessProbe) {
         this.livenessProbe = livenessProbe;
     }
 
+    /**
+     * Name of the container specified as a DNS_LABEL. Each container in a pod must have a unique name (DNS_LABEL). Cannot be updated.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the container specified as a DNS_LABEL. Each container in a pod must have a unique name (DNS_LABEL). Cannot be updated.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * List of ports to expose from the container. Not specifying a port here DOES NOT prevent that port from being exposed. Any port which is listening on the default "0.0.0.0" address inside a container will be accessible from the network. Modifying this array with strategic merge patch may corrupt the data. For more information See https://github.com/kubernetes/kubernetes/issues/108255. Cannot be updated.
+     */
     @JsonProperty("ports")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ContainerPort> getPorts() {
         return ports;
     }
 
+    /**
+     * List of ports to expose from the container. Not specifying a port here DOES NOT prevent that port from being exposed. Any port which is listening on the default "0.0.0.0" address inside a container will be accessible from the network. Modifying this array with strategic merge patch may corrupt the data. For more information See https://github.com/kubernetes/kubernetes/issues/108255. Cannot be updated.
+     */
     @JsonProperty("ports")
     public void setPorts(List<ContainerPort> ports) {
         this.ports = ports;
     }
 
+    /**
+     * A single application container that you want to run within a pod.
+     */
     @JsonProperty("readinessProbe")
     public Probe getReadinessProbe() {
         return readinessProbe;
     }
 
+    /**
+     * A single application container that you want to run within a pod.
+     */
     @JsonProperty("readinessProbe")
     public void setReadinessProbe(Probe readinessProbe) {
         this.readinessProbe = readinessProbe;
     }
 
+    /**
+     * Resources resize policy for the container.
+     */
     @JsonProperty("resizePolicy")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ContainerResizePolicy> getResizePolicy() {
         return resizePolicy;
     }
 
+    /**
+     * Resources resize policy for the container.
+     */
     @JsonProperty("resizePolicy")
     public void setResizePolicy(List<ContainerResizePolicy> resizePolicy) {
         this.resizePolicy = resizePolicy;
     }
 
+    /**
+     * A single application container that you want to run within a pod.
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * A single application container that you want to run within a pod.
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * RestartPolicy defines the restart behavior of individual containers in a pod. This field may only be set for init containers, and the only allowed value is "Always". For non-init containers or when this field is not specified, the restart behavior is defined by the Pod's restart policy and the container type. Setting the RestartPolicy as "Always" for the init container will have the following effect: this init container will be continually restarted on exit until all regular containers have terminated. Once all regular containers have completed, all init containers with restartPolicy "Always" will be shut down. This lifecycle differs from normal init containers and is often referred to as a "sidecar" container. Although this init container still starts in the init container sequence, it does not wait for the container to complete before proceeding to the next init container. Instead, the next init container starts immediately after this init container is started, or after any startupProbe has successfully completed.
+     */
     @JsonProperty("restartPolicy")
     public String getRestartPolicy() {
         return restartPolicy;
     }
 
+    /**
+     * RestartPolicy defines the restart behavior of individual containers in a pod. This field may only be set for init containers, and the only allowed value is "Always". For non-init containers or when this field is not specified, the restart behavior is defined by the Pod's restart policy and the container type. Setting the RestartPolicy as "Always" for the init container will have the following effect: this init container will be continually restarted on exit until all regular containers have terminated. Once all regular containers have completed, all init containers with restartPolicy "Always" will be shut down. This lifecycle differs from normal init containers and is often referred to as a "sidecar" container. Although this init container still starts in the init container sequence, it does not wait for the container to complete before proceeding to the next init container. Instead, the next init container starts immediately after this init container is started, or after any startupProbe has successfully completed.
+     */
     @JsonProperty("restartPolicy")
     public void setRestartPolicy(String restartPolicy) {
         this.restartPolicy = restartPolicy;
     }
 
+    /**
+     * A single application container that you want to run within a pod.
+     */
     @JsonProperty("securityContext")
     public SecurityContext getSecurityContext() {
         return securityContext;
     }
 
+    /**
+     * A single application container that you want to run within a pod.
+     */
     @JsonProperty("securityContext")
     public void setSecurityContext(SecurityContext securityContext) {
         this.securityContext = securityContext;
     }
 
+    /**
+     * A single application container that you want to run within a pod.
+     */
     @JsonProperty("startupProbe")
     public Probe getStartupProbe() {
         return startupProbe;
     }
 
+    /**
+     * A single application container that you want to run within a pod.
+     */
     @JsonProperty("startupProbe")
     public void setStartupProbe(Probe startupProbe) {
         this.startupProbe = startupProbe;
     }
 
+    /**
+     * Whether this container should allocate a buffer for stdin in the container runtime. If this is not set, reads from stdin in the container will always result in EOF. Default is false.
+     */
     @JsonProperty("stdin")
     public Boolean getStdin() {
         return stdin;
     }
 
+    /**
+     * Whether this container should allocate a buffer for stdin in the container runtime. If this is not set, reads from stdin in the container will always result in EOF. Default is false.
+     */
     @JsonProperty("stdin")
     public void setStdin(Boolean stdin) {
         this.stdin = stdin;
     }
 
+    /**
+     * Whether the container runtime should close the stdin channel after it has been opened by a single attach. When stdin is true the stdin stream will remain open across multiple attach sessions. If stdinOnce is set to true, stdin is opened on container start, is empty until the first client attaches to stdin, and then remains open and accepts data until the client disconnects, at which time stdin is closed and remains closed until the container is restarted. If this flag is false, a container processes that reads from stdin will never receive an EOF. Default is false
+     */
     @JsonProperty("stdinOnce")
     public Boolean getStdinOnce() {
         return stdinOnce;
     }
 
+    /**
+     * Whether the container runtime should close the stdin channel after it has been opened by a single attach. When stdin is true the stdin stream will remain open across multiple attach sessions. If stdinOnce is set to true, stdin is opened on container start, is empty until the first client attaches to stdin, and then remains open and accepts data until the client disconnects, at which time stdin is closed and remains closed until the container is restarted. If this flag is false, a container processes that reads from stdin will never receive an EOF. Default is false
+     */
     @JsonProperty("stdinOnce")
     public void setStdinOnce(Boolean stdinOnce) {
         this.stdinOnce = stdinOnce;
     }
 
+    /**
+     * Optional: Path at which the file to which the container's termination message will be written is mounted into the container's filesystem. Message written is intended to be brief final status, such as an assertion failure message. Will be truncated by the node if greater than 4096 bytes. The total message length across all containers will be limited to 12kb. Defaults to /dev/termination-log. Cannot be updated.
+     */
     @JsonProperty("terminationMessagePath")
     public String getTerminationMessagePath() {
         return terminationMessagePath;
     }
 
+    /**
+     * Optional: Path at which the file to which the container's termination message will be written is mounted into the container's filesystem. Message written is intended to be brief final status, such as an assertion failure message. Will be truncated by the node if greater than 4096 bytes. The total message length across all containers will be limited to 12kb. Defaults to /dev/termination-log. Cannot be updated.
+     */
     @JsonProperty("terminationMessagePath")
     public void setTerminationMessagePath(String terminationMessagePath) {
         this.terminationMessagePath = terminationMessagePath;
     }
 
+    /**
+     * Indicate how the termination message should be populated. File will use the contents of terminationMessagePath to populate the container status message on both success and failure. FallbackToLogsOnError will use the last chunk of container log output if the termination message file is empty and the container exited with an error. The log output is limited to 2048 bytes or 80 lines, whichever is smaller. Defaults to File. Cannot be updated.
+     */
     @JsonProperty("terminationMessagePolicy")
     public String getTerminationMessagePolicy() {
         return terminationMessagePolicy;
     }
 
+    /**
+     * Indicate how the termination message should be populated. File will use the contents of terminationMessagePath to populate the container status message on both success and failure. FallbackToLogsOnError will use the last chunk of container log output if the termination message file is empty and the container exited with an error. The log output is limited to 2048 bytes or 80 lines, whichever is smaller. Defaults to File. Cannot be updated.
+     */
     @JsonProperty("terminationMessagePolicy")
     public void setTerminationMessagePolicy(String terminationMessagePolicy) {
         this.terminationMessagePolicy = terminationMessagePolicy;
     }
 
+    /**
+     * Whether this container should allocate a TTY for itself, also requires 'stdin' to be true. Default is false.
+     */
     @JsonProperty("tty")
     public Boolean getTty() {
         return tty;
     }
 
+    /**
+     * Whether this container should allocate a TTY for itself, also requires 'stdin' to be true. Default is false.
+     */
     @JsonProperty("tty")
     public void setTty(Boolean tty) {
         this.tty = tty;
     }
 
+    /**
+     * volumeDevices is the list of block devices to be used by the container.
+     */
     @JsonProperty("volumeDevices")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VolumeDevice> getVolumeDevices() {
         return volumeDevices;
     }
 
+    /**
+     * volumeDevices is the list of block devices to be used by the container.
+     */
     @JsonProperty("volumeDevices")
     public void setVolumeDevices(List<VolumeDevice> volumeDevices) {
         this.volumeDevices = volumeDevices;
     }
 
+    /**
+     * Pod volumes to mount into the container's filesystem. Cannot be updated.
+     */
     @JsonProperty("volumeMounts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VolumeMount> getVolumeMounts() {
         return volumeMounts;
     }
 
+    /**
+     * Pod volumes to mount into the container's filesystem. Cannot be updated.
+     */
     @JsonProperty("volumeMounts")
     public void setVolumeMounts(List<VolumeMount> volumeMounts) {
         this.volumeMounts = volumeMounts;
     }
 
+    /**
+     * Container's working directory. If not specified, the container runtime's default will be used, which might be configured in the container image. Cannot be updated.
+     */
     @JsonProperty("workingDir")
     public String getWorkingDir() {
         return workingDir;
     }
 
+    /**
+     * Container's working directory. If not specified, the container runtime's default will be used, which might be configured in the container image. Cannot be updated.
+     */
     @JsonProperty("workingDir")
     public void setWorkingDir(String workingDir) {
         this.workingDir = workingDir;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerImage.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerImage.java
index 5971a451816..a7ac3962317 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerImage.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerImage.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Describe a container image
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -56,22 +59,34 @@ public ContainerImage(List<String> names, Long sizeBytes) {
         this.sizeBytes = sizeBytes;
     }
 
+    /**
+     * Names by which this image is known. e.g. ["kubernetes.example/hyperkube:v1.0.7", "cloud-vendor.registry.example/cloud-vendor/hyperkube:v1.0.7"]
+     */
     @JsonProperty("names")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNames() {
         return names;
     }
 
+    /**
+     * Names by which this image is known. e.g. ["kubernetes.example/hyperkube:v1.0.7", "cloud-vendor.registry.example/cloud-vendor/hyperkube:v1.0.7"]
+     */
     @JsonProperty("names")
     public void setNames(List<String> names) {
         this.names = names;
     }
 
+    /**
+     * The size of the image in bytes.
+     */
     @JsonProperty("sizeBytes")
     public Long getSizeBytes() {
         return sizeBytes;
     }
 
+    /**
+     * The size of the image in bytes.
+     */
     @JsonProperty("sizeBytes")
     public void setSizeBytes(Long sizeBytes) {
         this.sizeBytes = sizeBytes;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerPort.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerPort.java
index 0af077b07de..abc96d3d608 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerPort.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerPort.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerPort represents a network port in a single container.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -65,51 +68,81 @@ public ContainerPort(Integer containerPort, String hostIP, Integer hostPort, Str
         this.protocol = protocol;
     }
 
+    /**
+     * Number of port to expose on the pod's IP address. This must be a valid port number, 0 &lt; x &lt; 65536.
+     */
     @JsonProperty("containerPort")
     public Integer getContainerPort() {
         return containerPort;
     }
 
+    /**
+     * Number of port to expose on the pod's IP address. This must be a valid port number, 0 &lt; x &lt; 65536.
+     */
     @JsonProperty("containerPort")
     public void setContainerPort(Integer containerPort) {
         this.containerPort = containerPort;
     }
 
+    /**
+     * What host IP to bind the external port to.
+     */
     @JsonProperty("hostIP")
     public String getHostIP() {
         return hostIP;
     }
 
+    /**
+     * What host IP to bind the external port to.
+     */
     @JsonProperty("hostIP")
     public void setHostIP(String hostIP) {
         this.hostIP = hostIP;
     }
 
+    /**
+     * Number of port to expose on the host. If specified, this must be a valid port number, 0 &lt; x &lt; 65536. If HostNetwork is specified, this must match ContainerPort. Most containers do not need this.
+     */
     @JsonProperty("hostPort")
     public Integer getHostPort() {
         return hostPort;
     }
 
+    /**
+     * Number of port to expose on the host. If specified, this must be a valid port number, 0 &lt; x &lt; 65536. If HostNetwork is specified, this must match ContainerPort. Most containers do not need this.
+     */
     @JsonProperty("hostPort")
     public void setHostPort(Integer hostPort) {
         this.hostPort = hostPort;
     }
 
+    /**
+     * If specified, this must be an IANA_SVC_NAME and unique within the pod. Each named port in a pod must have a unique name. Name for the port that can be referred to by services.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * If specified, this must be an IANA_SVC_NAME and unique within the pod. Each named port in a pod must have a unique name. Name for the port that can be referred to by services.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Protocol for port. Must be UDP, TCP, or SCTP. Defaults to "TCP".
+     */
     @JsonProperty("protocol")
     public String getProtocol() {
         return protocol;
     }
 
+    /**
+     * Protocol for port. Must be UDP, TCP, or SCTP. Defaults to "TCP".
+     */
     @JsonProperty("protocol")
     public void setProtocol(String protocol) {
         this.protocol = protocol;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerResizePolicy.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerResizePolicy.java
index 8bf4e329696..403f1621836 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerResizePolicy.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerResizePolicy.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerResizePolicy represents resource resize policy for the container.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public ContainerResizePolicy(String resourceName, String restartPolicy) {
         this.restartPolicy = restartPolicy;
     }
 
+    /**
+     * Name of the resource to which this resource resize policy applies. Supported values: cpu, memory.
+     */
     @JsonProperty("resourceName")
     public String getResourceName() {
         return resourceName;
     }
 
+    /**
+     * Name of the resource to which this resource resize policy applies. Supported values: cpu, memory.
+     */
     @JsonProperty("resourceName")
     public void setResourceName(String resourceName) {
         this.resourceName = resourceName;
     }
 
+    /**
+     * Restart policy to apply when specified resource is resized. If not specified, it defaults to NotRequired.
+     */
     @JsonProperty("restartPolicy")
     public String getRestartPolicy() {
         return restartPolicy;
     }
 
+    /**
+     * Restart policy to apply when specified resource is resized. If not specified, it defaults to NotRequired.
+     */
     @JsonProperty("restartPolicy")
     public void setRestartPolicy(String restartPolicy) {
         this.restartPolicy = restartPolicy;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerState.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerState.java
index 58dacaccb7d..7d99dd7ed3f 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerState.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerState.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerState holds a possible state of container. Only one of its members may be specified. If none of them is specified, the default one is ContainerStateWaiting.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -57,31 +60,49 @@ public ContainerState(ContainerStateRunning running, ContainerStateTerminated te
         this.waiting = waiting;
     }
 
+    /**
+     * ContainerState holds a possible state of container. Only one of its members may be specified. If none of them is specified, the default one is ContainerStateWaiting.
+     */
     @JsonProperty("running")
     public ContainerStateRunning getRunning() {
         return running;
     }
 
+    /**
+     * ContainerState holds a possible state of container. Only one of its members may be specified. If none of them is specified, the default one is ContainerStateWaiting.
+     */
     @JsonProperty("running")
     public void setRunning(ContainerStateRunning running) {
         this.running = running;
     }
 
+    /**
+     * ContainerState holds a possible state of container. Only one of its members may be specified. If none of them is specified, the default one is ContainerStateWaiting.
+     */
     @JsonProperty("terminated")
     public ContainerStateTerminated getTerminated() {
         return terminated;
     }
 
+    /**
+     * ContainerState holds a possible state of container. Only one of its members may be specified. If none of them is specified, the default one is ContainerStateWaiting.
+     */
     @JsonProperty("terminated")
     public void setTerminated(ContainerStateTerminated terminated) {
         this.terminated = terminated;
     }
 
+    /**
+     * ContainerState holds a possible state of container. Only one of its members may be specified. If none of them is specified, the default one is ContainerStateWaiting.
+     */
     @JsonProperty("waiting")
     public ContainerStateWaiting getWaiting() {
         return waiting;
     }
 
+    /**
+     * ContainerState holds a possible state of container. Only one of its members may be specified. If none of them is specified, the default one is ContainerStateWaiting.
+     */
     @JsonProperty("waiting")
     public void setWaiting(ContainerStateWaiting waiting) {
         this.waiting = waiting;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerStateRunning.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerStateRunning.java
index 7e99ae2de42..0e6c77bcd72 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerStateRunning.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerStateRunning.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerStateRunning is a running state of a container.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -49,11 +52,17 @@ public ContainerStateRunning(String startedAt) {
         this.startedAt = startedAt;
     }
 
+    /**
+     * ContainerStateRunning is a running state of a container.
+     */
     @JsonProperty("startedAt")
     public String getStartedAt() {
         return startedAt;
     }
 
+    /**
+     * ContainerStateRunning is a running state of a container.
+     */
     @JsonProperty("startedAt")
     public void setStartedAt(String startedAt) {
         this.startedAt = startedAt;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerStateTerminated.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerStateTerminated.java
index ab8e88f3f20..94a0ef26654 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerStateTerminated.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerStateTerminated.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerStateTerminated is a terminated state of a container.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -73,71 +76,113 @@ public ContainerStateTerminated(String containerID, Integer exitCode, String fin
         this.startedAt = startedAt;
     }
 
+    /**
+     * Container's ID in the format '&lt;type&gt;://&lt;container_id&gt;'
+     */
     @JsonProperty("containerID")
     public String getContainerID() {
         return containerID;
     }
 
+    /**
+     * Container's ID in the format '&lt;type&gt;://&lt;container_id&gt;'
+     */
     @JsonProperty("containerID")
     public void setContainerID(String containerID) {
         this.containerID = containerID;
     }
 
+    /**
+     * Exit status from the last termination of the container
+     */
     @JsonProperty("exitCode")
     public Integer getExitCode() {
         return exitCode;
     }
 
+    /**
+     * Exit status from the last termination of the container
+     */
     @JsonProperty("exitCode")
     public void setExitCode(Integer exitCode) {
         this.exitCode = exitCode;
     }
 
+    /**
+     * ContainerStateTerminated is a terminated state of a container.
+     */
     @JsonProperty("finishedAt")
     public String getFinishedAt() {
         return finishedAt;
     }
 
+    /**
+     * ContainerStateTerminated is a terminated state of a container.
+     */
     @JsonProperty("finishedAt")
     public void setFinishedAt(String finishedAt) {
         this.finishedAt = finishedAt;
     }
 
+    /**
+     * Message regarding the last termination of the container
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message regarding the last termination of the container
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * (brief) reason from the last termination of the container
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * (brief) reason from the last termination of the container
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Signal from the last termination of the container
+     */
     @JsonProperty("signal")
     public Integer getSignal() {
         return signal;
     }
 
+    /**
+     * Signal from the last termination of the container
+     */
     @JsonProperty("signal")
     public void setSignal(Integer signal) {
         this.signal = signal;
     }
 
+    /**
+     * ContainerStateTerminated is a terminated state of a container.
+     */
     @JsonProperty("startedAt")
     public String getStartedAt() {
         return startedAt;
     }
 
+    /**
+     * ContainerStateTerminated is a terminated state of a container.
+     */
     @JsonProperty("startedAt")
     public void setStartedAt(String startedAt) {
         this.startedAt = startedAt;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerStateWaiting.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerStateWaiting.java
index c8b2976d6f0..7df463dc434 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerStateWaiting.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerStateWaiting.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerStateWaiting is a waiting state of a container.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public ContainerStateWaiting(String message, String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Message regarding why the container is not yet running.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message regarding why the container is not yet running.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * (brief) reason the container is not yet running.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * (brief) reason the container is not yet running.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerStatus.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerStatus.java
index b779f3d118f..5211a828d5c 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerStatus.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerStatus contains details for the current status of this container.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -106,144 +109,228 @@ public ContainerStatus(Map<String, Quantity> allocatedResources, List<ResourceSt
         this.volumeMounts = volumeMounts;
     }
 
+    /**
+     * AllocatedResources represents the compute resources allocated for this container by the node. Kubelet sets this value to Container.Resources.Requests upon successful pod admission and after successfully admitting desired pod resize.
+     */
     @JsonProperty("allocatedResources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getAllocatedResources() {
         return allocatedResources;
     }
 
+    /**
+     * AllocatedResources represents the compute resources allocated for this container by the node. Kubelet sets this value to Container.Resources.Requests upon successful pod admission and after successfully admitting desired pod resize.
+     */
     @JsonProperty("allocatedResources")
     public void setAllocatedResources(Map<String, Quantity> allocatedResources) {
         this.allocatedResources = allocatedResources;
     }
 
+    /**
+     * AllocatedResourcesStatus represents the status of various resources allocated for this Pod.
+     */
     @JsonProperty("allocatedResourcesStatus")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ResourceStatus> getAllocatedResourcesStatus() {
         return allocatedResourcesStatus;
     }
 
+    /**
+     * AllocatedResourcesStatus represents the status of various resources allocated for this Pod.
+     */
     @JsonProperty("allocatedResourcesStatus")
     public void setAllocatedResourcesStatus(List<ResourceStatus> allocatedResourcesStatus) {
         this.allocatedResourcesStatus = allocatedResourcesStatus;
     }
 
+    /**
+     * ContainerID is the ID of the container in the format '&lt;type&gt;://&lt;container_id&gt;'. Where type is a container runtime identifier, returned from Version call of CRI API (for example "containerd").
+     */
     @JsonProperty("containerID")
     public String getContainerID() {
         return containerID;
     }
 
+    /**
+     * ContainerID is the ID of the container in the format '&lt;type&gt;://&lt;container_id&gt;'. Where type is a container runtime identifier, returned from Version call of CRI API (for example "containerd").
+     */
     @JsonProperty("containerID")
     public void setContainerID(String containerID) {
         this.containerID = containerID;
     }
 
+    /**
+     * Image is the name of container image that the container is running. The container image may not match the image used in the PodSpec, as it may have been resolved by the runtime. More info: https://kubernetes.io/docs/concepts/containers/images.
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * Image is the name of container image that the container is running. The container image may not match the image used in the PodSpec, as it may have been resolved by the runtime. More info: https://kubernetes.io/docs/concepts/containers/images.
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
     }
 
+    /**
+     * ImageID is the image ID of the container's image. The image ID may not match the image ID of the image used in the PodSpec, as it may have been resolved by the runtime.
+     */
     @JsonProperty("imageID")
     public String getImageID() {
         return imageID;
     }
 
+    /**
+     * ImageID is the image ID of the container's image. The image ID may not match the image ID of the image used in the PodSpec, as it may have been resolved by the runtime.
+     */
     @JsonProperty("imageID")
     public void setImageID(String imageID) {
         this.imageID = imageID;
     }
 
+    /**
+     * ContainerStatus contains details for the current status of this container.
+     */
     @JsonProperty("lastState")
     public ContainerState getLastState() {
         return lastState;
     }
 
+    /**
+     * ContainerStatus contains details for the current status of this container.
+     */
     @JsonProperty("lastState")
     public void setLastState(ContainerState lastState) {
         this.lastState = lastState;
     }
 
+    /**
+     * Name is a DNS_LABEL representing the unique name of the container. Each container in a pod must have a unique name across all container types. Cannot be updated.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is a DNS_LABEL representing the unique name of the container. Each container in a pod must have a unique name across all container types. Cannot be updated.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Ready specifies whether the container is currently passing its readiness check. The value will change as readiness probes keep executing. If no readiness probes are specified, this field defaults to true once the container is fully started (see Started field).<br><p> <br><p> The value is typically used to determine whether a container is ready to accept traffic.
+     */
     @JsonProperty("ready")
     public Boolean getReady() {
         return ready;
     }
 
+    /**
+     * Ready specifies whether the container is currently passing its readiness check. The value will change as readiness probes keep executing. If no readiness probes are specified, this field defaults to true once the container is fully started (see Started field).<br><p> <br><p> The value is typically used to determine whether a container is ready to accept traffic.
+     */
     @JsonProperty("ready")
     public void setReady(Boolean ready) {
         this.ready = ready;
     }
 
+    /**
+     * ContainerStatus contains details for the current status of this container.
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * ContainerStatus contains details for the current status of this container.
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * RestartCount holds the number of times the container has been restarted. Kubelet makes an effort to always increment the value, but there are cases when the state may be lost due to node restarts and then the value may be reset to 0. The value is never negative.
+     */
     @JsonProperty("restartCount")
     public Integer getRestartCount() {
         return restartCount;
     }
 
+    /**
+     * RestartCount holds the number of times the container has been restarted. Kubelet makes an effort to always increment the value, but there are cases when the state may be lost due to node restarts and then the value may be reset to 0. The value is never negative.
+     */
     @JsonProperty("restartCount")
     public void setRestartCount(Integer restartCount) {
         this.restartCount = restartCount;
     }
 
+    /**
+     * Started indicates whether the container has finished its postStart lifecycle hook and passed its startup probe. Initialized as false, becomes true after startupProbe is considered successful. Resets to false when the container is restarted, or if kubelet loses state temporarily. In both cases, startup probes will run again. Is always true when no startupProbe is defined and container is running and has passed the postStart lifecycle hook. The null value must be treated the same as false.
+     */
     @JsonProperty("started")
     public Boolean getStarted() {
         return started;
     }
 
+    /**
+     * Started indicates whether the container has finished its postStart lifecycle hook and passed its startup probe. Initialized as false, becomes true after startupProbe is considered successful. Resets to false when the container is restarted, or if kubelet loses state temporarily. In both cases, startup probes will run again. Is always true when no startupProbe is defined and container is running and has passed the postStart lifecycle hook. The null value must be treated the same as false.
+     */
     @JsonProperty("started")
     public void setStarted(Boolean started) {
         this.started = started;
     }
 
+    /**
+     * ContainerStatus contains details for the current status of this container.
+     */
     @JsonProperty("state")
     public ContainerState getState() {
         return state;
     }
 
+    /**
+     * ContainerStatus contains details for the current status of this container.
+     */
     @JsonProperty("state")
     public void setState(ContainerState state) {
         this.state = state;
     }
 
+    /**
+     * ContainerStatus contains details for the current status of this container.
+     */
     @JsonProperty("user")
     public ContainerUser getUser() {
         return user;
     }
 
+    /**
+     * ContainerStatus contains details for the current status of this container.
+     */
     @JsonProperty("user")
     public void setUser(ContainerUser user) {
         this.user = user;
     }
 
+    /**
+     * Status of volume mounts.
+     */
     @JsonProperty("volumeMounts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VolumeMountStatus> getVolumeMounts() {
         return volumeMounts;
     }
 
+    /**
+     * Status of volume mounts.
+     */
     @JsonProperty("volumeMounts")
     public void setVolumeMounts(List<VolumeMountStatus> volumeMounts) {
         this.volumeMounts = volumeMounts;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerUser.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerUser.java
index 514d8fdcdcb..3f5c08732d0 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerUser.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ContainerUser.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerUser represents user identity information
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -49,11 +52,17 @@ public ContainerUser(LinuxContainerUser linux) {
         this.linux = linux;
     }
 
+    /**
+     * ContainerUser represents user identity information
+     */
     @JsonProperty("linux")
     public LinuxContainerUser getLinux() {
         return linux;
     }
 
+    /**
+     * ContainerUser represents user identity information
+     */
     @JsonProperty("linux")
     public void setLinux(LinuxContainerUser linux) {
         this.linux = linux;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/CreateOptions.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/CreateOptions.java
index 82d59fde2bd..2e9fd2e8bd8 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/CreateOptions.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/CreateOptions.java
@@ -48,9 +48,6 @@
 public class CreateOptions implements Editable<CreateOptionsBuilder>, KubernetesResource
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("dryRun")
@@ -60,9 +57,6 @@ public class CreateOptions implements Editable<CreateOptionsBuilder>, Kubernetes
     private String fieldManager;
     @JsonProperty("fieldValidation")
     private String fieldValidation;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CreateOptions";
     @JsonIgnore
@@ -83,17 +77,11 @@ public CreateOptions(String apiVersion, List<String> dryRun, String fieldManager
         this.kind = kind;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
@@ -130,17 +118,11 @@ public void setFieldValidation(String fieldValidation) {
         this.fieldValidation = fieldValidation;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/DaemonEndpoint.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/DaemonEndpoint.java
index 5b10ead174d..420c994b034 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/DaemonEndpoint.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/DaemonEndpoint.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DaemonEndpoint contains information about a single Daemon endpoint.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -49,11 +52,17 @@ public DaemonEndpoint(Integer port) {
         this.port = port;
     }
 
+    /**
+     * Port number of the given endpoint.
+     */
     @JsonProperty("Port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * Port number of the given endpoint.
+     */
     @JsonProperty("Port")
     public void setPort(Integer port) {
         this.port = port;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/DeleteOptions.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/DeleteOptions.java
index 4b59025869f..128ab26c877 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/DeleteOptions.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/DeleteOptions.java
@@ -51,9 +51,6 @@
 public class DeleteOptions implements Editable<DeleteOptionsBuilder>, KubernetesResource
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("dryRun")
@@ -63,9 +60,6 @@ public class DeleteOptions implements Editable<DeleteOptionsBuilder>, Kubernetes
     private Long gracePeriodSeconds;
     @JsonProperty("ignoreStoreReadErrorWithClusterBreakingPotential")
     private Boolean ignoreStoreReadErrorWithClusterBreakingPotential;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DeleteOptions";
     @JsonProperty("orphanDependents")
@@ -95,17 +89,11 @@ public DeleteOptions(String apiVersion, List<String> dryRun, Long gracePeriodSec
         this.propagationPolicy = propagationPolicy;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
@@ -142,17 +130,11 @@ public void setIgnoreStoreReadErrorWithClusterBreakingPotential(Boolean ignoreSt
         this.ignoreStoreReadErrorWithClusterBreakingPotential = ignoreStoreReadErrorWithClusterBreakingPotential;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/DownwardAPIProjection.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/DownwardAPIProjection.java
index 2310b5a9105..a5e5e736931 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/DownwardAPIProjection.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/DownwardAPIProjection.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Represents downward API info for projecting into a projected volume. Note that this is identical to a downwardAPI volume source without the default mode.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -52,12 +55,18 @@ public DownwardAPIProjection(List<DownwardAPIVolumeFile> items) {
         this.items = items;
     }
 
+    /**
+     * Items is a list of DownwardAPIVolume file
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DownwardAPIVolumeFile> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of DownwardAPIVolume file
+     */
     @JsonProperty("items")
     public void setItems(List<DownwardAPIVolumeFile> items) {
         this.items = items;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/DownwardAPIVolumeFile.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/DownwardAPIVolumeFile.java
index 73b99f69af1..a53266f9d1d 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/DownwardAPIVolumeFile.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/DownwardAPIVolumeFile.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DownwardAPIVolumeFile represents information to create the file containing the pod field
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -61,41 +64,65 @@ public DownwardAPIVolumeFile(ObjectFieldSelector fieldRef, Integer mode, String
         this.resourceFieldRef = resourceFieldRef;
     }
 
+    /**
+     * DownwardAPIVolumeFile represents information to create the file containing the pod field
+     */
     @JsonProperty("fieldRef")
     public ObjectFieldSelector getFieldRef() {
         return fieldRef;
     }
 
+    /**
+     * DownwardAPIVolumeFile represents information to create the file containing the pod field
+     */
     @JsonProperty("fieldRef")
     public void setFieldRef(ObjectFieldSelector fieldRef) {
         this.fieldRef = fieldRef;
     }
 
+    /**
+     * Optional: mode bits used to set permissions on this file, must be an octal value between 0000 and 0777 or a decimal value between 0 and 511. YAML accepts both octal and decimal values, JSON requires decimal values for mode bits. If not specified, the volume defaultMode will be used. This might be in conflict with other options that affect the file mode, like fsGroup, and the result can be other mode bits set.
+     */
     @JsonProperty("mode")
     public Integer getMode() {
         return mode;
     }
 
+    /**
+     * Optional: mode bits used to set permissions on this file, must be an octal value between 0000 and 0777 or a decimal value between 0 and 511. YAML accepts both octal and decimal values, JSON requires decimal values for mode bits. If not specified, the volume defaultMode will be used. This might be in conflict with other options that affect the file mode, like fsGroup, and the result can be other mode bits set.
+     */
     @JsonProperty("mode")
     public void setMode(Integer mode) {
         this.mode = mode;
     }
 
+    /**
+     * Required: Path is  the relative path name of the file to be created. Must not be absolute or contain the '..' path. Must be utf-8 encoded. The first item of the relative path must not start with '..'
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Required: Path is  the relative path name of the file to be created. Must not be absolute or contain the '..' path. Must be utf-8 encoded. The first item of the relative path must not start with '..'
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * DownwardAPIVolumeFile represents information to create the file containing the pod field
+     */
     @JsonProperty("resourceFieldRef")
     public ResourceFieldSelector getResourceFieldRef() {
         return resourceFieldRef;
     }
 
+    /**
+     * DownwardAPIVolumeFile represents information to create the file containing the pod field
+     */
     @JsonProperty("resourceFieldRef")
     public void setResourceFieldRef(ResourceFieldSelector resourceFieldRef) {
         this.resourceFieldRef = resourceFieldRef;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/DownwardAPIVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/DownwardAPIVolumeSource.java
index 1f871d8c410..58bc50c0f6b 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/DownwardAPIVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/DownwardAPIVolumeSource.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DownwardAPIVolumeSource represents a volume containing downward API info. Downward API volumes support ownership management and SELinux relabeling.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -56,22 +59,34 @@ public DownwardAPIVolumeSource(Integer defaultMode, List<DownwardAPIVolumeFile>
         this.items = items;
     }
 
+    /**
+     * Optional: mode bits to use on created files by default. Must be a Optional: mode bits used to set permissions on created files by default. Must be an octal value between 0000 and 0777 or a decimal value between 0 and 511. YAML accepts both octal and decimal values, JSON requires decimal values for mode bits. Defaults to 0644. Directories within the path are not affected by this setting. This might be in conflict with other options that affect the file mode, like fsGroup, and the result can be other mode bits set.
+     */
     @JsonProperty("defaultMode")
     public Integer getDefaultMode() {
         return defaultMode;
     }
 
+    /**
+     * Optional: mode bits to use on created files by default. Must be a Optional: mode bits used to set permissions on created files by default. Must be an octal value between 0000 and 0777 or a decimal value between 0 and 511. YAML accepts both octal and decimal values, JSON requires decimal values for mode bits. Defaults to 0644. Directories within the path are not affected by this setting. This might be in conflict with other options that affect the file mode, like fsGroup, and the result can be other mode bits set.
+     */
     @JsonProperty("defaultMode")
     public void setDefaultMode(Integer defaultMode) {
         this.defaultMode = defaultMode;
     }
 
+    /**
+     * Items is a list of downward API volume file
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DownwardAPIVolumeFile> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of downward API volume file
+     */
     @JsonProperty("items")
     public void setItems(List<DownwardAPIVolumeFile> items) {
         this.items = items;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EmptyDirVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EmptyDirVolumeSource.java
index 74731ef2aff..a2c65c398b4 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EmptyDirVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EmptyDirVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Represents an empty directory for a pod. Empty directory volumes support ownership management and SELinux relabeling.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public EmptyDirVolumeSource(String medium, Quantity sizeLimit) {
         this.sizeLimit = sizeLimit;
     }
 
+    /**
+     * medium represents what type of storage medium should back this directory. The default is "" which means to use the node's default medium. Must be an empty string (default) or Memory. More info: https://kubernetes.io/docs/concepts/storage/volumes#emptydir
+     */
     @JsonProperty("medium")
     public String getMedium() {
         return medium;
     }
 
+    /**
+     * medium represents what type of storage medium should back this directory. The default is "" which means to use the node's default medium. Must be an empty string (default) or Memory. More info: https://kubernetes.io/docs/concepts/storage/volumes#emptydir
+     */
     @JsonProperty("medium")
     public void setMedium(String medium) {
         this.medium = medium;
     }
 
+    /**
+     * Represents an empty directory for a pod. Empty directory volumes support ownership management and SELinux relabeling.
+     */
     @JsonProperty("sizeLimit")
     public Quantity getSizeLimit() {
         return sizeLimit;
     }
 
+    /**
+     * Represents an empty directory for a pod. Empty directory volumes support ownership management and SELinux relabeling.
+     */
     @JsonProperty("sizeLimit")
     public void setSizeLimit(Quantity sizeLimit) {
         this.sizeLimit = sizeLimit;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EndpointAddress.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EndpointAddress.java
index 1b5a62d726f..a87d3006981 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EndpointAddress.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EndpointAddress.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EndpointAddress is a tuple that describes single IP address.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -61,41 +64,65 @@ public EndpointAddress(String hostname, String ip, String nodeName, ObjectRefere
         this.targetRef = targetRef;
     }
 
+    /**
+     * The Hostname of this endpoint
+     */
     @JsonProperty("hostname")
     public String getHostname() {
         return hostname;
     }
 
+    /**
+     * The Hostname of this endpoint
+     */
     @JsonProperty("hostname")
     public void setHostname(String hostname) {
         this.hostname = hostname;
     }
 
+    /**
+     * The IP of this endpoint. May not be loopback (127.0.0.0/8 or ::1), link-local (169.254.0.0/16 or fe80::/10), or link-local multicast (224.0.0.0/24 or ff02::/16).
+     */
     @JsonProperty("ip")
     public String getIp() {
         return ip;
     }
 
+    /**
+     * The IP of this endpoint. May not be loopback (127.0.0.0/8 or ::1), link-local (169.254.0.0/16 or fe80::/10), or link-local multicast (224.0.0.0/24 or ff02::/16).
+     */
     @JsonProperty("ip")
     public void setIp(String ip) {
         this.ip = ip;
     }
 
+    /**
+     * Optional: Node hosting this endpoint. This can be used to determine endpoints local to a node.
+     */
     @JsonProperty("nodeName")
     public String getNodeName() {
         return nodeName;
     }
 
+    /**
+     * Optional: Node hosting this endpoint. This can be used to determine endpoints local to a node.
+     */
     @JsonProperty("nodeName")
     public void setNodeName(String nodeName) {
         this.nodeName = nodeName;
     }
 
+    /**
+     * EndpointAddress is a tuple that describes single IP address.
+     */
     @JsonProperty("targetRef")
     public ObjectReference getTargetRef() {
         return targetRef;
     }
 
+    /**
+     * EndpointAddress is a tuple that describes single IP address.
+     */
     @JsonProperty("targetRef")
     public void setTargetRef(ObjectReference targetRef) {
         this.targetRef = targetRef;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EndpointPort.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EndpointPort.java
index 1a8ee222fa7..f2b1e48b47a 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EndpointPort.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EndpointPort.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EndpointPort is a tuple that describes a single port.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -61,41 +64,65 @@ public EndpointPort(String appProtocol, String name, Integer port, String protoc
         this.protocol = protocol;
     }
 
+    /**
+     * The application protocol for this port. This is used as a hint for implementations to offer richer behavior for protocols that they understand. This field follows standard Kubernetes label syntax. Valid values are either:<br><p> <br><p> &#42; Un-prefixed protocol names - reserved for IANA standard service names (as per RFC-6335 and https://www.iana.org/assignments/service-names).<br><p> <br><p> &#42; Kubernetes-defined prefixed names:<br><p>   &#42; 'kubernetes.io/h2c' - HTTP/2 prior knowledge over cleartext as described in https://www.rfc-editor.org/rfc/rfc9113.html#name-starting-http-2-with-prior-<br><p>   &#42; 'kubernetes.io/ws'  - WebSocket over cleartext as described in https://www.rfc-editor.org/rfc/rfc6455<br><p>   &#42; 'kubernetes.io/wss' - WebSocket over TLS as described in https://www.rfc-editor.org/rfc/rfc6455<br><p> <br><p> &#42; Other protocols should use implementation-defined prefixed names such as mycompany.com/my-custom-protocol.
+     */
     @JsonProperty("appProtocol")
     public String getAppProtocol() {
         return appProtocol;
     }
 
+    /**
+     * The application protocol for this port. This is used as a hint for implementations to offer richer behavior for protocols that they understand. This field follows standard Kubernetes label syntax. Valid values are either:<br><p> <br><p> &#42; Un-prefixed protocol names - reserved for IANA standard service names (as per RFC-6335 and https://www.iana.org/assignments/service-names).<br><p> <br><p> &#42; Kubernetes-defined prefixed names:<br><p>   &#42; 'kubernetes.io/h2c' - HTTP/2 prior knowledge over cleartext as described in https://www.rfc-editor.org/rfc/rfc9113.html#name-starting-http-2-with-prior-<br><p>   &#42; 'kubernetes.io/ws'  - WebSocket over cleartext as described in https://www.rfc-editor.org/rfc/rfc6455<br><p>   &#42; 'kubernetes.io/wss' - WebSocket over TLS as described in https://www.rfc-editor.org/rfc/rfc6455<br><p> <br><p> &#42; Other protocols should use implementation-defined prefixed names such as mycompany.com/my-custom-protocol.
+     */
     @JsonProperty("appProtocol")
     public void setAppProtocol(String appProtocol) {
         this.appProtocol = appProtocol;
     }
 
+    /**
+     * The name of this port.  This must match the 'name' field in the corresponding ServicePort. Must be a DNS_LABEL. Optional only if one port is defined.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The name of this port.  This must match the 'name' field in the corresponding ServicePort. Must be a DNS_LABEL. Optional only if one port is defined.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * The port number of the endpoint.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * The port number of the endpoint.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * The IP protocol for this port. Must be UDP, TCP, or SCTP. Default is TCP.
+     */
     @JsonProperty("protocol")
     public String getProtocol() {
         return protocol;
     }
 
+    /**
+     * The IP protocol for this port. Must be UDP, TCP, or SCTP. Default is TCP.
+     */
     @JsonProperty("protocol")
     public void setProtocol(String protocol) {
         this.protocol = protocol;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EndpointSubset.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EndpointSubset.java
index ccc1b5e70d2..de9c10fdad1 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EndpointSubset.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EndpointSubset.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EndpointSubset is a group of addresses with a common set of ports. The expanded set of endpoints is the Cartesian product of Addresses x Ports. For example, given:<br><p> <br><p> 	{<br><p> 	  Addresses: [{"ip": "10.10.1.1"}, {"ip": "10.10.2.2"}],<br><p> 	  Ports:     [{"name": "a", "port": 8675}, {"name": "b", "port": 309}]<br><p> 	}<br><p> <br><p> The resulting set of endpoints can be viewed as:<br><p> <br><p> 	a: [ 10.10.1.1:8675, 10.10.2.2:8675 ],<br><p> 	b: [ 10.10.1.1:309, 10.10.2.2:309 ]
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -62,34 +65,52 @@ public EndpointSubset(List<EndpointAddress> addresses, List<EndpointAddress> not
         this.ports = ports;
     }
 
+    /**
+     * IP addresses which offer the related ports that are marked as ready. These endpoints should be considered safe for load balancers and clients to utilize.
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EndpointAddress> getAddresses() {
         return addresses;
     }
 
+    /**
+     * IP addresses which offer the related ports that are marked as ready. These endpoints should be considered safe for load balancers and clients to utilize.
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<EndpointAddress> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * IP addresses which offer the related ports but are not currently marked as ready because they have not yet finished starting, have recently failed a readiness check, or have recently failed a liveness check.
+     */
     @JsonProperty("notReadyAddresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EndpointAddress> getNotReadyAddresses() {
         return notReadyAddresses;
     }
 
+    /**
+     * IP addresses which offer the related ports but are not currently marked as ready because they have not yet finished starting, have recently failed a readiness check, or have recently failed a liveness check.
+     */
     @JsonProperty("notReadyAddresses")
     public void setNotReadyAddresses(List<EndpointAddress> notReadyAddresses) {
         this.notReadyAddresses = notReadyAddresses;
     }
 
+    /**
+     * Port numbers available on the related IP addresses.
+     */
     @JsonProperty("ports")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EndpointPort> getPorts() {
         return ports;
     }
 
+    /**
+     * Port numbers available on the related IP addresses.
+     */
     @JsonProperty("ports")
     public void setPorts(List<EndpointPort> ports) {
         this.ports = ports;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Endpoints.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Endpoints.java
index 3a10bbaeb3f..c26f893e6e2 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Endpoints.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Endpoints.java
@@ -23,6 +23,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Endpoints is a collection of endpoints that implement the actual service. Example:<br><p> <br><p> 	 Name: "mysvc",<br><p> 	 Subsets: [<br><p> 	   {<br><p> 	     Addresses: [{"ip": "10.10.1.1"}, {"ip": "10.10.2.2"}],<br><p> 	     Ports: [{"name": "a", "port": 8675}, {"name": "b", "port": 309}]<br><p> 	   },<br><p> 	   {<br><p> 	     Addresses: [{"ip": "10.10.3.3"}],<br><p> 	     Ports: [{"name": "a", "port": 93}, {"name": "b", "port": 76}]<br><p> 	   },<br><p> 	]
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -47,14 +50,8 @@
 public class Endpoints implements Editable<EndpointsBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Endpoints";
     @JsonProperty("metadata")
@@ -80,7 +77,7 @@ public Endpoints(String apiVersion, String kind, ObjectMeta metadata, List<Endpo
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -88,7 +85,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -96,7 +93,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -104,29 +101,41 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Endpoints is a collection of endpoints that implement the actual service. Example:<br><p> <br><p> 	 Name: "mysvc",<br><p> 	 Subsets: [<br><p> 	   {<br><p> 	     Addresses: [{"ip": "10.10.1.1"}, {"ip": "10.10.2.2"}],<br><p> 	     Ports: [{"name": "a", "port": 8675}, {"name": "b", "port": 309}]<br><p> 	   },<br><p> 	   {<br><p> 	     Addresses: [{"ip": "10.10.3.3"}],<br><p> 	     Ports: [{"name": "a", "port": 93}, {"name": "b", "port": 76}]<br><p> 	   },<br><p> 	]
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Endpoints is a collection of endpoints that implement the actual service. Example:<br><p> <br><p> 	 Name: "mysvc",<br><p> 	 Subsets: [<br><p> 	   {<br><p> 	     Addresses: [{"ip": "10.10.1.1"}, {"ip": "10.10.2.2"}],<br><p> 	     Ports: [{"name": "a", "port": 8675}, {"name": "b", "port": 309}]<br><p> 	   },<br><p> 	   {<br><p> 	     Addresses: [{"ip": "10.10.3.3"}],<br><p> 	     Ports: [{"name": "a", "port": 93}, {"name": "b", "port": 76}]<br><p> 	   },<br><p> 	]
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * The set of all endpoints is the union of all subsets. Addresses are placed into subsets according to the IPs they share. A single address with multiple ports, some of which are ready and some of which are not (because they come from different containers) will result in the address being displayed in different subsets for the different ports. No address will appear in both Addresses and NotReadyAddresses in the same subset. Sets of addresses and ports that comprise a service.
+     */
     @JsonProperty("subsets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EndpointSubset> getSubsets() {
         return subsets;
     }
 
+    /**
+     * The set of all endpoints is the union of all subsets. Addresses are placed into subsets according to the IPs they share. A single address with multiple ports, some of which are ready and some of which are not (because they come from different containers) will result in the address being displayed in different subsets for the different ports. No address will appear in both Addresses and NotReadyAddresses in the same subset. Sets of addresses and ports that comprise a service.
+     */
     @JsonProperty("subsets")
     public void setSubsets(List<EndpointSubset> subsets) {
         this.subsets = subsets;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EndpointsList.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EndpointsList.java
index faca1d46541..cb9a11f301b 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EndpointsList.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EndpointsList.java
@@ -23,6 +23,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EndpointsList is a list of endpoints.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -47,17 +50,11 @@
 public class EndpointsList implements Editable<EndpointsListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.Endpoints>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.Endpoints> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EndpointsList";
     @JsonProperty("metadata")
@@ -80,7 +77,7 @@ public EndpointsList(String apiVersion, List<io.fabric8.kubernetes.api.model.End
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -88,26 +85,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of endpoints.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.Endpoints> getItems() {
         return items;
     }
 
+    /**
+     * List of endpoints.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.Endpoints> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -115,18 +118,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EndpointsList is a list of endpoints.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EndpointsList is a list of endpoints.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EnvFromSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EnvFromSource.java
index f93d9b63d20..baa5955a6a7 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EnvFromSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EnvFromSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EnvFromSource represents the source of a set of ConfigMaps
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -57,31 +60,49 @@ public EnvFromSource(ConfigMapEnvSource configMapRef, String prefix, SecretEnvSo
         this.secretRef = secretRef;
     }
 
+    /**
+     * EnvFromSource represents the source of a set of ConfigMaps
+     */
     @JsonProperty("configMapRef")
     public ConfigMapEnvSource getConfigMapRef() {
         return configMapRef;
     }
 
+    /**
+     * EnvFromSource represents the source of a set of ConfigMaps
+     */
     @JsonProperty("configMapRef")
     public void setConfigMapRef(ConfigMapEnvSource configMapRef) {
         this.configMapRef = configMapRef;
     }
 
+    /**
+     * An optional identifier to prepend to each key in the ConfigMap. Must be a C_IDENTIFIER.
+     */
     @JsonProperty("prefix")
     public String getPrefix() {
         return prefix;
     }
 
+    /**
+     * An optional identifier to prepend to each key in the ConfigMap. Must be a C_IDENTIFIER.
+     */
     @JsonProperty("prefix")
     public void setPrefix(String prefix) {
         this.prefix = prefix;
     }
 
+    /**
+     * EnvFromSource represents the source of a set of ConfigMaps
+     */
     @JsonProperty("secretRef")
     public SecretEnvSource getSecretRef() {
         return secretRef;
     }
 
+    /**
+     * EnvFromSource represents the source of a set of ConfigMaps
+     */
     @JsonProperty("secretRef")
     public void setSecretRef(SecretEnvSource secretRef) {
         this.secretRef = secretRef;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EnvVar.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EnvVar.java
index eb611b50600..03e7a165e63 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EnvVar.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EnvVar.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EnvVar represents an environment variable present in a Container.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -57,31 +60,49 @@ public EnvVar(String name, String value, EnvVarSource valueFrom) {
         this.valueFrom = valueFrom;
     }
 
+    /**
+     * Name of the environment variable. Must be a C_IDENTIFIER.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the environment variable. Must be a C_IDENTIFIER.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Variable references $(VAR_NAME) are expanded using the previously defined environment variables in the container and any service environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Defaults to "".
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Variable references $(VAR_NAME) are expanded using the previously defined environment variables in the container and any service environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Defaults to "".
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
     }
 
+    /**
+     * EnvVar represents an environment variable present in a Container.
+     */
     @JsonProperty("valueFrom")
     public EnvVarSource getValueFrom() {
         return valueFrom;
     }
 
+    /**
+     * EnvVar represents an environment variable present in a Container.
+     */
     @JsonProperty("valueFrom")
     public void setValueFrom(EnvVarSource valueFrom) {
         this.valueFrom = valueFrom;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EnvVarSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EnvVarSource.java
index 7bc06583fa4..0ec047edb45 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EnvVarSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EnvVarSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EnvVarSource represents a source for the value of an EnvVar.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -61,41 +64,65 @@ public EnvVarSource(ConfigMapKeySelector configMapKeyRef, ObjectFieldSelector fi
         this.secretKeyRef = secretKeyRef;
     }
 
+    /**
+     * EnvVarSource represents a source for the value of an EnvVar.
+     */
     @JsonProperty("configMapKeyRef")
     public ConfigMapKeySelector getConfigMapKeyRef() {
         return configMapKeyRef;
     }
 
+    /**
+     * EnvVarSource represents a source for the value of an EnvVar.
+     */
     @JsonProperty("configMapKeyRef")
     public void setConfigMapKeyRef(ConfigMapKeySelector configMapKeyRef) {
         this.configMapKeyRef = configMapKeyRef;
     }
 
+    /**
+     * EnvVarSource represents a source for the value of an EnvVar.
+     */
     @JsonProperty("fieldRef")
     public ObjectFieldSelector getFieldRef() {
         return fieldRef;
     }
 
+    /**
+     * EnvVarSource represents a source for the value of an EnvVar.
+     */
     @JsonProperty("fieldRef")
     public void setFieldRef(ObjectFieldSelector fieldRef) {
         this.fieldRef = fieldRef;
     }
 
+    /**
+     * EnvVarSource represents a source for the value of an EnvVar.
+     */
     @JsonProperty("resourceFieldRef")
     public ResourceFieldSelector getResourceFieldRef() {
         return resourceFieldRef;
     }
 
+    /**
+     * EnvVarSource represents a source for the value of an EnvVar.
+     */
     @JsonProperty("resourceFieldRef")
     public void setResourceFieldRef(ResourceFieldSelector resourceFieldRef) {
         this.resourceFieldRef = resourceFieldRef;
     }
 
+    /**
+     * EnvVarSource represents a source for the value of an EnvVar.
+     */
     @JsonProperty("secretKeyRef")
     public SecretKeySelector getSecretKeyRef() {
         return secretKeyRef;
     }
 
+    /**
+     * EnvVarSource represents a source for the value of an EnvVar.
+     */
     @JsonProperty("secretKeyRef")
     public void setSecretKeyRef(SecretKeySelector secretKeyRef) {
         this.secretKeyRef = secretKeyRef;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EphemeralContainer.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EphemeralContainer.java
index bd6c98eac25..16b7e403f6f 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EphemeralContainer.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EphemeralContainer.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * An EphemeralContainer is a temporary container that you may add to an existing Pod for user-initiated activities such as debugging. Ephemeral containers have no resource or scheduling guarantees, and they will not be restarted when they exit or when a Pod is removed or restarted. The kubelet may evict a Pod if an ephemeral container causes the Pod to exceed its resource allocation.<br><p> <br><p> To add an ephemeral container, use the ephemeralcontainers subresource of an existing Pod. Ephemeral containers may not be removed or restarted.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -155,259 +158,409 @@ public EphemeralContainer(List<String> args, List<String> command, List<EnvVar>
         this.workingDir = workingDir;
     }
 
+    /**
+     * Arguments to the entrypoint. The image's CMD is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("args")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getArgs() {
         return args;
     }
 
+    /**
+     * Arguments to the entrypoint. The image's CMD is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("args")
     public void setArgs(List<String> args) {
         this.args = args;
     }
 
+    /**
+     * Entrypoint array. Not executed within a shell. The image's ENTRYPOINT is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("command")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCommand() {
         return command;
     }
 
+    /**
+     * Entrypoint array. Not executed within a shell. The image's ENTRYPOINT is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
+     */
     @JsonProperty("command")
     public void setCommand(List<String> command) {
         this.command = command;
     }
 
+    /**
+     * List of environment variables to set in the container. Cannot be updated.
+     */
     @JsonProperty("env")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvVar> getEnv() {
         return env;
     }
 
+    /**
+     * List of environment variables to set in the container. Cannot be updated.
+     */
     @JsonProperty("env")
     public void setEnv(List<EnvVar> env) {
         this.env = env;
     }
 
+    /**
+     * List of sources to populate environment variables in the container. The keys defined within a source must be a C_IDENTIFIER. All invalid keys will be reported as an event when the container is starting. When a key exists in multiple sources, the value associated with the last source will take precedence. Values defined by an Env with a duplicate key will take precedence. Cannot be updated.
+     */
     @JsonProperty("envFrom")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvFromSource> getEnvFrom() {
         return envFrom;
     }
 
+    /**
+     * List of sources to populate environment variables in the container. The keys defined within a source must be a C_IDENTIFIER. All invalid keys will be reported as an event when the container is starting. When a key exists in multiple sources, the value associated with the last source will take precedence. Values defined by an Env with a duplicate key will take precedence. Cannot be updated.
+     */
     @JsonProperty("envFrom")
     public void setEnvFrom(List<EnvFromSource> envFrom) {
         this.envFrom = envFrom;
     }
 
+    /**
+     * Container image name. More info: https://kubernetes.io/docs/concepts/containers/images
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * Container image name. More info: https://kubernetes.io/docs/concepts/containers/images
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
     }
 
+    /**
+     * Image pull policy. One of Always, Never, IfNotPresent. Defaults to Always if :latest tag is specified, or IfNotPresent otherwise. Cannot be updated. More info: https://kubernetes.io/docs/concepts/containers/images#updating-images
+     */
     @JsonProperty("imagePullPolicy")
     public String getImagePullPolicy() {
         return imagePullPolicy;
     }
 
+    /**
+     * Image pull policy. One of Always, Never, IfNotPresent. Defaults to Always if :latest tag is specified, or IfNotPresent otherwise. Cannot be updated. More info: https://kubernetes.io/docs/concepts/containers/images#updating-images
+     */
     @JsonProperty("imagePullPolicy")
     public void setImagePullPolicy(String imagePullPolicy) {
         this.imagePullPolicy = imagePullPolicy;
     }
 
+    /**
+     * An EphemeralContainer is a temporary container that you may add to an existing Pod for user-initiated activities such as debugging. Ephemeral containers have no resource or scheduling guarantees, and they will not be restarted when they exit or when a Pod is removed or restarted. The kubelet may evict a Pod if an ephemeral container causes the Pod to exceed its resource allocation.<br><p> <br><p> To add an ephemeral container, use the ephemeralcontainers subresource of an existing Pod. Ephemeral containers may not be removed or restarted.
+     */
     @JsonProperty("lifecycle")
     public Lifecycle getLifecycle() {
         return lifecycle;
     }
 
+    /**
+     * An EphemeralContainer is a temporary container that you may add to an existing Pod for user-initiated activities such as debugging. Ephemeral containers have no resource or scheduling guarantees, and they will not be restarted when they exit or when a Pod is removed or restarted. The kubelet may evict a Pod if an ephemeral container causes the Pod to exceed its resource allocation.<br><p> <br><p> To add an ephemeral container, use the ephemeralcontainers subresource of an existing Pod. Ephemeral containers may not be removed or restarted.
+     */
     @JsonProperty("lifecycle")
     public void setLifecycle(Lifecycle lifecycle) {
         this.lifecycle = lifecycle;
     }
 
+    /**
+     * An EphemeralContainer is a temporary container that you may add to an existing Pod for user-initiated activities such as debugging. Ephemeral containers have no resource or scheduling guarantees, and they will not be restarted when they exit or when a Pod is removed or restarted. The kubelet may evict a Pod if an ephemeral container causes the Pod to exceed its resource allocation.<br><p> <br><p> To add an ephemeral container, use the ephemeralcontainers subresource of an existing Pod. Ephemeral containers may not be removed or restarted.
+     */
     @JsonProperty("livenessProbe")
     public Probe getLivenessProbe() {
         return livenessProbe;
     }
 
+    /**
+     * An EphemeralContainer is a temporary container that you may add to an existing Pod for user-initiated activities such as debugging. Ephemeral containers have no resource or scheduling guarantees, and they will not be restarted when they exit or when a Pod is removed or restarted. The kubelet may evict a Pod if an ephemeral container causes the Pod to exceed its resource allocation.<br><p> <br><p> To add an ephemeral container, use the ephemeralcontainers subresource of an existing Pod. Ephemeral containers may not be removed or restarted.
+     */
     @JsonProperty("livenessProbe")
     public void setLivenessProbe(Probe livenessProbe) {
         this.livenessProbe = livenessProbe;
     }
 
+    /**
+     * Name of the ephemeral container specified as a DNS_LABEL. This name must be unique among all containers, init containers and ephemeral containers.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the ephemeral container specified as a DNS_LABEL. This name must be unique among all containers, init containers and ephemeral containers.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Ports are not allowed for ephemeral containers.
+     */
     @JsonProperty("ports")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ContainerPort> getPorts() {
         return ports;
     }
 
+    /**
+     * Ports are not allowed for ephemeral containers.
+     */
     @JsonProperty("ports")
     public void setPorts(List<ContainerPort> ports) {
         this.ports = ports;
     }
 
+    /**
+     * An EphemeralContainer is a temporary container that you may add to an existing Pod for user-initiated activities such as debugging. Ephemeral containers have no resource or scheduling guarantees, and they will not be restarted when they exit or when a Pod is removed or restarted. The kubelet may evict a Pod if an ephemeral container causes the Pod to exceed its resource allocation.<br><p> <br><p> To add an ephemeral container, use the ephemeralcontainers subresource of an existing Pod. Ephemeral containers may not be removed or restarted.
+     */
     @JsonProperty("readinessProbe")
     public Probe getReadinessProbe() {
         return readinessProbe;
     }
 
+    /**
+     * An EphemeralContainer is a temporary container that you may add to an existing Pod for user-initiated activities such as debugging. Ephemeral containers have no resource or scheduling guarantees, and they will not be restarted when they exit or when a Pod is removed or restarted. The kubelet may evict a Pod if an ephemeral container causes the Pod to exceed its resource allocation.<br><p> <br><p> To add an ephemeral container, use the ephemeralcontainers subresource of an existing Pod. Ephemeral containers may not be removed or restarted.
+     */
     @JsonProperty("readinessProbe")
     public void setReadinessProbe(Probe readinessProbe) {
         this.readinessProbe = readinessProbe;
     }
 
+    /**
+     * Resources resize policy for the container.
+     */
     @JsonProperty("resizePolicy")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ContainerResizePolicy> getResizePolicy() {
         return resizePolicy;
     }
 
+    /**
+     * Resources resize policy for the container.
+     */
     @JsonProperty("resizePolicy")
     public void setResizePolicy(List<ContainerResizePolicy> resizePolicy) {
         this.resizePolicy = resizePolicy;
     }
 
+    /**
+     * An EphemeralContainer is a temporary container that you may add to an existing Pod for user-initiated activities such as debugging. Ephemeral containers have no resource or scheduling guarantees, and they will not be restarted when they exit or when a Pod is removed or restarted. The kubelet may evict a Pod if an ephemeral container causes the Pod to exceed its resource allocation.<br><p> <br><p> To add an ephemeral container, use the ephemeralcontainers subresource of an existing Pod. Ephemeral containers may not be removed or restarted.
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * An EphemeralContainer is a temporary container that you may add to an existing Pod for user-initiated activities such as debugging. Ephemeral containers have no resource or scheduling guarantees, and they will not be restarted when they exit or when a Pod is removed or restarted. The kubelet may evict a Pod if an ephemeral container causes the Pod to exceed its resource allocation.<br><p> <br><p> To add an ephemeral container, use the ephemeralcontainers subresource of an existing Pod. Ephemeral containers may not be removed or restarted.
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * Restart policy for the container to manage the restart behavior of each container within a pod. This may only be set for init containers. You cannot set this field on ephemeral containers.
+     */
     @JsonProperty("restartPolicy")
     public String getRestartPolicy() {
         return restartPolicy;
     }
 
+    /**
+     * Restart policy for the container to manage the restart behavior of each container within a pod. This may only be set for init containers. You cannot set this field on ephemeral containers.
+     */
     @JsonProperty("restartPolicy")
     public void setRestartPolicy(String restartPolicy) {
         this.restartPolicy = restartPolicy;
     }
 
+    /**
+     * An EphemeralContainer is a temporary container that you may add to an existing Pod for user-initiated activities such as debugging. Ephemeral containers have no resource or scheduling guarantees, and they will not be restarted when they exit or when a Pod is removed or restarted. The kubelet may evict a Pod if an ephemeral container causes the Pod to exceed its resource allocation.<br><p> <br><p> To add an ephemeral container, use the ephemeralcontainers subresource of an existing Pod. Ephemeral containers may not be removed or restarted.
+     */
     @JsonProperty("securityContext")
     public SecurityContext getSecurityContext() {
         return securityContext;
     }
 
+    /**
+     * An EphemeralContainer is a temporary container that you may add to an existing Pod for user-initiated activities such as debugging. Ephemeral containers have no resource or scheduling guarantees, and they will not be restarted when they exit or when a Pod is removed or restarted. The kubelet may evict a Pod if an ephemeral container causes the Pod to exceed its resource allocation.<br><p> <br><p> To add an ephemeral container, use the ephemeralcontainers subresource of an existing Pod. Ephemeral containers may not be removed or restarted.
+     */
     @JsonProperty("securityContext")
     public void setSecurityContext(SecurityContext securityContext) {
         this.securityContext = securityContext;
     }
 
+    /**
+     * An EphemeralContainer is a temporary container that you may add to an existing Pod for user-initiated activities such as debugging. Ephemeral containers have no resource or scheduling guarantees, and they will not be restarted when they exit or when a Pod is removed or restarted. The kubelet may evict a Pod if an ephemeral container causes the Pod to exceed its resource allocation.<br><p> <br><p> To add an ephemeral container, use the ephemeralcontainers subresource of an existing Pod. Ephemeral containers may not be removed or restarted.
+     */
     @JsonProperty("startupProbe")
     public Probe getStartupProbe() {
         return startupProbe;
     }
 
+    /**
+     * An EphemeralContainer is a temporary container that you may add to an existing Pod for user-initiated activities such as debugging. Ephemeral containers have no resource or scheduling guarantees, and they will not be restarted when they exit or when a Pod is removed or restarted. The kubelet may evict a Pod if an ephemeral container causes the Pod to exceed its resource allocation.<br><p> <br><p> To add an ephemeral container, use the ephemeralcontainers subresource of an existing Pod. Ephemeral containers may not be removed or restarted.
+     */
     @JsonProperty("startupProbe")
     public void setStartupProbe(Probe startupProbe) {
         this.startupProbe = startupProbe;
     }
 
+    /**
+     * Whether this container should allocate a buffer for stdin in the container runtime. If this is not set, reads from stdin in the container will always result in EOF. Default is false.
+     */
     @JsonProperty("stdin")
     public Boolean getStdin() {
         return stdin;
     }
 
+    /**
+     * Whether this container should allocate a buffer for stdin in the container runtime. If this is not set, reads from stdin in the container will always result in EOF. Default is false.
+     */
     @JsonProperty("stdin")
     public void setStdin(Boolean stdin) {
         this.stdin = stdin;
     }
 
+    /**
+     * Whether the container runtime should close the stdin channel after it has been opened by a single attach. When stdin is true the stdin stream will remain open across multiple attach sessions. If stdinOnce is set to true, stdin is opened on container start, is empty until the first client attaches to stdin, and then remains open and accepts data until the client disconnects, at which time stdin is closed and remains closed until the container is restarted. If this flag is false, a container processes that reads from stdin will never receive an EOF. Default is false
+     */
     @JsonProperty("stdinOnce")
     public Boolean getStdinOnce() {
         return stdinOnce;
     }
 
+    /**
+     * Whether the container runtime should close the stdin channel after it has been opened by a single attach. When stdin is true the stdin stream will remain open across multiple attach sessions. If stdinOnce is set to true, stdin is opened on container start, is empty until the first client attaches to stdin, and then remains open and accepts data until the client disconnects, at which time stdin is closed and remains closed until the container is restarted. If this flag is false, a container processes that reads from stdin will never receive an EOF. Default is false
+     */
     @JsonProperty("stdinOnce")
     public void setStdinOnce(Boolean stdinOnce) {
         this.stdinOnce = stdinOnce;
     }
 
+    /**
+     * If set, the name of the container from PodSpec that this ephemeral container targets. The ephemeral container will be run in the namespaces (IPC, PID, etc) of this container. If not set then the ephemeral container uses the namespaces configured in the Pod spec.<br><p> <br><p> The container runtime must implement support for this feature. If the runtime does not support namespace targeting then the result of setting this field is undefined.
+     */
     @JsonProperty("targetContainerName")
     public String getTargetContainerName() {
         return targetContainerName;
     }
 
+    /**
+     * If set, the name of the container from PodSpec that this ephemeral container targets. The ephemeral container will be run in the namespaces (IPC, PID, etc) of this container. If not set then the ephemeral container uses the namespaces configured in the Pod spec.<br><p> <br><p> The container runtime must implement support for this feature. If the runtime does not support namespace targeting then the result of setting this field is undefined.
+     */
     @JsonProperty("targetContainerName")
     public void setTargetContainerName(String targetContainerName) {
         this.targetContainerName = targetContainerName;
     }
 
+    /**
+     * Optional: Path at which the file to which the container's termination message will be written is mounted into the container's filesystem. Message written is intended to be brief final status, such as an assertion failure message. Will be truncated by the node if greater than 4096 bytes. The total message length across all containers will be limited to 12kb. Defaults to /dev/termination-log. Cannot be updated.
+     */
     @JsonProperty("terminationMessagePath")
     public String getTerminationMessagePath() {
         return terminationMessagePath;
     }
 
+    /**
+     * Optional: Path at which the file to which the container's termination message will be written is mounted into the container's filesystem. Message written is intended to be brief final status, such as an assertion failure message. Will be truncated by the node if greater than 4096 bytes. The total message length across all containers will be limited to 12kb. Defaults to /dev/termination-log. Cannot be updated.
+     */
     @JsonProperty("terminationMessagePath")
     public void setTerminationMessagePath(String terminationMessagePath) {
         this.terminationMessagePath = terminationMessagePath;
     }
 
+    /**
+     * Indicate how the termination message should be populated. File will use the contents of terminationMessagePath to populate the container status message on both success and failure. FallbackToLogsOnError will use the last chunk of container log output if the termination message file is empty and the container exited with an error. The log output is limited to 2048 bytes or 80 lines, whichever is smaller. Defaults to File. Cannot be updated.
+     */
     @JsonProperty("terminationMessagePolicy")
     public String getTerminationMessagePolicy() {
         return terminationMessagePolicy;
     }
 
+    /**
+     * Indicate how the termination message should be populated. File will use the contents of terminationMessagePath to populate the container status message on both success and failure. FallbackToLogsOnError will use the last chunk of container log output if the termination message file is empty and the container exited with an error. The log output is limited to 2048 bytes or 80 lines, whichever is smaller. Defaults to File. Cannot be updated.
+     */
     @JsonProperty("terminationMessagePolicy")
     public void setTerminationMessagePolicy(String terminationMessagePolicy) {
         this.terminationMessagePolicy = terminationMessagePolicy;
     }
 
+    /**
+     * Whether this container should allocate a TTY for itself, also requires 'stdin' to be true. Default is false.
+     */
     @JsonProperty("tty")
     public Boolean getTty() {
         return tty;
     }
 
+    /**
+     * Whether this container should allocate a TTY for itself, also requires 'stdin' to be true. Default is false.
+     */
     @JsonProperty("tty")
     public void setTty(Boolean tty) {
         this.tty = tty;
     }
 
+    /**
+     * volumeDevices is the list of block devices to be used by the container.
+     */
     @JsonProperty("volumeDevices")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VolumeDevice> getVolumeDevices() {
         return volumeDevices;
     }
 
+    /**
+     * volumeDevices is the list of block devices to be used by the container.
+     */
     @JsonProperty("volumeDevices")
     public void setVolumeDevices(List<VolumeDevice> volumeDevices) {
         this.volumeDevices = volumeDevices;
     }
 
+    /**
+     * Pod volumes to mount into the container's filesystem. Subpath mounts are not allowed for ephemeral containers. Cannot be updated.
+     */
     @JsonProperty("volumeMounts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VolumeMount> getVolumeMounts() {
         return volumeMounts;
     }
 
+    /**
+     * Pod volumes to mount into the container's filesystem. Subpath mounts are not allowed for ephemeral containers. Cannot be updated.
+     */
     @JsonProperty("volumeMounts")
     public void setVolumeMounts(List<VolumeMount> volumeMounts) {
         this.volumeMounts = volumeMounts;
     }
 
+    /**
+     * Container's working directory. If not specified, the container runtime's default will be used, which might be configured in the container image. Cannot be updated.
+     */
     @JsonProperty("workingDir")
     public String getWorkingDir() {
         return workingDir;
     }
 
+    /**
+     * Container's working directory. If not specified, the container runtime's default will be used, which might be configured in the container image. Cannot be updated.
+     */
     @JsonProperty("workingDir")
     public void setWorkingDir(String workingDir) {
         this.workingDir = workingDir;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EphemeralVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EphemeralVolumeSource.java
index b7668d9469a..5df5f64c0d2 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EphemeralVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EphemeralVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Represents an ephemeral volume that is handled by a normal storage driver.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -49,11 +52,17 @@ public EphemeralVolumeSource(PersistentVolumeClaimTemplate volumeClaimTemplate)
         this.volumeClaimTemplate = volumeClaimTemplate;
     }
 
+    /**
+     * Represents an ephemeral volume that is handled by a normal storage driver.
+     */
     @JsonProperty("volumeClaimTemplate")
     public PersistentVolumeClaimTemplate getVolumeClaimTemplate() {
         return volumeClaimTemplate;
     }
 
+    /**
+     * Represents an ephemeral volume that is handled by a normal storage driver.
+     */
     @JsonProperty("volumeClaimTemplate")
     public void setVolumeClaimTemplate(PersistentVolumeClaimTemplate volumeClaimTemplate) {
         this.volumeClaimTemplate = volumeClaimTemplate;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Event.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Event.java
index a63979908ee..e3a6c05b09f 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Event.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Event.java
@@ -21,6 +21,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Event is a report of an event somewhere in the cluster.  Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -60,9 +63,6 @@ public class Event implements Editable<EventBuilder>, HasMetadata, Namespaced
 
     @JsonProperty("action")
     private String action;
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("count")
@@ -73,9 +73,6 @@ public class Event implements Editable<EventBuilder>, HasMetadata, Namespaced
     private String firstTimestamp;
     @JsonProperty("involvedObject")
     private ObjectReference involvedObject;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Event";
     @JsonProperty("lastTimestamp")
@@ -128,18 +125,24 @@ public Event(String action, String apiVersion, Integer count, MicroTime eventTim
         this.type = type;
     }
 
+    /**
+     * What action was taken/failed regarding to the Regarding object.
+     */
     @JsonProperty("action")
     public String getAction() {
         return action;
     }
 
+    /**
+     * What action was taken/failed regarding to the Regarding object.
+     */
     @JsonProperty("action")
     public void setAction(String action) {
         this.action = action;
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -147,55 +150,79 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * The number of times this event has occurred.
+     */
     @JsonProperty("count")
     public Integer getCount() {
         return count;
     }
 
+    /**
+     * The number of times this event has occurred.
+     */
     @JsonProperty("count")
     public void setCount(Integer count) {
         this.count = count;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster.  Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("eventTime")
     public MicroTime getEventTime() {
         return eventTime;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster.  Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("eventTime")
     public void setEventTime(MicroTime eventTime) {
         this.eventTime = eventTime;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster.  Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("firstTimestamp")
     public String getFirstTimestamp() {
         return firstTimestamp;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster.  Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("firstTimestamp")
     public void setFirstTimestamp(String firstTimestamp) {
         this.firstTimestamp = firstTimestamp;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster.  Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("involvedObject")
     public ObjectReference getInvolvedObject() {
         return involvedObject;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster.  Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("involvedObject")
     public void setInvolvedObject(ObjectReference involvedObject) {
         this.involvedObject = involvedObject;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -203,108 +230,168 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster.  Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("lastTimestamp")
     public String getLastTimestamp() {
         return lastTimestamp;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster.  Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("lastTimestamp")
     public void setLastTimestamp(String lastTimestamp) {
         this.lastTimestamp = lastTimestamp;
     }
 
+    /**
+     * A human-readable description of the status of this operation.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * A human-readable description of the status of this operation.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster.  Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster.  Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * This should be a short, machine understandable string that gives the reason for the transition into the object's current status.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * This should be a short, machine understandable string that gives the reason for the transition into the object's current status.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster.  Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("related")
     public ObjectReference getRelated() {
         return related;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster.  Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("related")
     public void setRelated(ObjectReference related) {
         this.related = related;
     }
 
+    /**
+     * Name of the controller that emitted this Event, e.g. `kubernetes.io/kubelet`.
+     */
     @JsonProperty("reportingComponent")
     public String getReportingComponent() {
         return reportingComponent;
     }
 
+    /**
+     * Name of the controller that emitted this Event, e.g. `kubernetes.io/kubelet`.
+     */
     @JsonProperty("reportingComponent")
     public void setReportingComponent(String reportingComponent) {
         this.reportingComponent = reportingComponent;
     }
 
+    /**
+     * ID of the controller instance, e.g. `kubelet-xyzf`.
+     */
     @JsonProperty("reportingInstance")
     public String getReportingInstance() {
         return reportingInstance;
     }
 
+    /**
+     * ID of the controller instance, e.g. `kubelet-xyzf`.
+     */
     @JsonProperty("reportingInstance")
     public void setReportingInstance(String reportingInstance) {
         this.reportingInstance = reportingInstance;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster.  Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("series")
     public EventSeries getSeries() {
         return series;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster.  Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("series")
     public void setSeries(EventSeries series) {
         this.series = series;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster.  Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("source")
     public EventSource getSource() {
         return source;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster.  Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("source")
     public void setSource(EventSource source) {
         this.source = source;
     }
 
+    /**
+     * Type of this event (Normal, Warning), new types could be added in the future
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of this event (Normal, Warning), new types could be added in the future
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EventList.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EventList.java
index 0ae74a59926..b8dd1d8900d 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EventList.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EventList.java
@@ -23,6 +23,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventList is a list of events.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -47,17 +50,11 @@
 public class EventList implements Editable<EventListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.Event>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.Event> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EventList";
     @JsonProperty("metadata")
@@ -80,7 +77,7 @@ public EventList(String apiVersion, List<io.fabric8.kubernetes.api.model.Event>
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -88,26 +85,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of events
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.Event> getItems() {
         return items;
     }
 
+    /**
+     * List of events
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.Event> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -115,18 +118,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EventList is a list of events.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EventList is a list of events.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EventSeries.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EventSeries.java
index ca7d0336216..f7df7479fce 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EventSeries.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EventSeries.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventSeries contain information on series of events, i.e. thing that was/is happening continuously for some time.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public EventSeries(Integer count, MicroTime lastObservedTime) {
         this.lastObservedTime = lastObservedTime;
     }
 
+    /**
+     * Number of occurrences in this series up to the last heartbeat time
+     */
     @JsonProperty("count")
     public Integer getCount() {
         return count;
     }
 
+    /**
+     * Number of occurrences in this series up to the last heartbeat time
+     */
     @JsonProperty("count")
     public void setCount(Integer count) {
         this.count = count;
     }
 
+    /**
+     * EventSeries contain information on series of events, i.e. thing that was/is happening continuously for some time.
+     */
     @JsonProperty("lastObservedTime")
     public MicroTime getLastObservedTime() {
         return lastObservedTime;
     }
 
+    /**
+     * EventSeries contain information on series of events, i.e. thing that was/is happening continuously for some time.
+     */
     @JsonProperty("lastObservedTime")
     public void setLastObservedTime(MicroTime lastObservedTime) {
         this.lastObservedTime = lastObservedTime;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EventSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EventSource.java
index c009d03b3af..eb00dbf9076 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EventSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/EventSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventSource contains information for an event.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public EventSource(String component, String host) {
         this.host = host;
     }
 
+    /**
+     * Component from which the event is generated.
+     */
     @JsonProperty("component")
     public String getComponent() {
         return component;
     }
 
+    /**
+     * Component from which the event is generated.
+     */
     @JsonProperty("component")
     public void setComponent(String component) {
         this.component = component;
     }
 
+    /**
+     * Node name on which the event is generated.
+     */
     @JsonProperty("host")
     public String getHost() {
         return host;
     }
 
+    /**
+     * Node name on which the event is generated.
+     */
     @JsonProperty("host")
     public void setHost(String host) {
         this.host = host;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ExecAction.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ExecAction.java
index e3800497256..3e00b8ed94c 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ExecAction.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ExecAction.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ExecAction describes a "run in container" action.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -52,12 +55,18 @@ public ExecAction(List<String> command) {
         this.command = command;
     }
 
+    /**
+     * Command is the command line to execute inside the container, the working directory for the command  is root ('/') in the container's filesystem. The command is simply exec'd, it is not run inside a shell, so traditional shell instructions ('|', etc) won't work. To use a shell, you need to explicitly call out to that shell. Exit status of 0 is treated as live/healthy and non-zero is unhealthy.
+     */
     @JsonProperty("command")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCommand() {
         return command;
     }
 
+    /**
+     * Command is the command line to execute inside the container, the working directory for the command  is root ('/') in the container's filesystem. The command is simply exec'd, it is not run inside a shell, so traditional shell instructions ('|', etc) won't work. To use a shell, you need to explicitly call out to that shell. Exit status of 0 is treated as live/healthy and non-zero is unhealthy.
+     */
     @JsonProperty("command")
     public void setCommand(List<String> command) {
         this.command = command;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/FCVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/FCVolumeSource.java
index 98e613f6668..dfa543b23fa 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/FCVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/FCVolumeSource.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Represents a Fibre Channel volume. Fibre Channel volumes can only be mounted as read/write once. Fibre Channel volumes support ownership management and SELinux relabeling.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -69,53 +72,83 @@ public FCVolumeSource(String fsType, Integer lun, Boolean readOnly, List<String>
         this.wwids = wwids;
     }
 
+    /**
+     * fsType is the filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.
+     */
     @JsonProperty("fsType")
     public String getFsType() {
         return fsType;
     }
 
+    /**
+     * fsType is the filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.
+     */
     @JsonProperty("fsType")
     public void setFsType(String fsType) {
         this.fsType = fsType;
     }
 
+    /**
+     * lun is Optional: FC target lun number
+     */
     @JsonProperty("lun")
     public Integer getLun() {
         return lun;
     }
 
+    /**
+     * lun is Optional: FC target lun number
+     */
     @JsonProperty("lun")
     public void setLun(Integer lun) {
         this.lun = lun;
     }
 
+    /**
+     * readOnly is Optional: Defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly is Optional: Defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * targetWWNs is Optional: FC target worldwide names (WWNs)
+     */
     @JsonProperty("targetWWNs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getTargetWWNs() {
         return targetWWNs;
     }
 
+    /**
+     * targetWWNs is Optional: FC target worldwide names (WWNs)
+     */
     @JsonProperty("targetWWNs")
     public void setTargetWWNs(List<String> targetWWNs) {
         this.targetWWNs = targetWWNs;
     }
 
+    /**
+     * wwids Optional: FC volume world wide identifiers (wwids) Either wwids or combination of targetWWNs and lun must be set, but not both simultaneously.
+     */
     @JsonProperty("wwids")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getWwids() {
         return wwids;
     }
 
+    /**
+     * wwids Optional: FC volume world wide identifiers (wwids) Either wwids or combination of targetWWNs and lun must be set, but not both simultaneously.
+     */
     @JsonProperty("wwids")
     public void setWwids(List<String> wwids) {
         this.wwids = wwids;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/FieldSelectorRequirement.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/FieldSelectorRequirement.java
index ad1a59e4624..0f86cae8130 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/FieldSelectorRequirement.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/FieldSelectorRequirement.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FieldSelectorRequirement is a selector that contains values, a key, and an operator that relates the key and values.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -60,32 +63,50 @@ public FieldSelectorRequirement(String key, String operator, List<String> values
         this.values = values;
     }
 
+    /**
+     * key is the field selector key that the requirement applies to.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * key is the field selector key that the requirement applies to.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * operator represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. The list of operators may grow in the future.
+     */
     @JsonProperty("operator")
     public String getOperator() {
         return operator;
     }
 
+    /**
+     * operator represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. The list of operators may grow in the future.
+     */
     @JsonProperty("operator")
     public void setOperator(String operator) {
         this.operator = operator;
     }
 
+    /**
+     * values is an array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty.
+     */
     @JsonProperty("values")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getValues() {
         return values;
     }
 
+    /**
+     * values is an array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty.
+     */
     @JsonProperty("values")
     public void setValues(List<String> values) {
         this.values = values;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/FieldsV1.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/FieldsV1.java
index 7272b416f4c..d799ec90d05 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/FieldsV1.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/FieldsV1.java
@@ -16,6 +16,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FieldsV1 stores a set of fields in a data structure like a Trie, in JSON format.<br><p> <br><p> Each key is either a '.' representing the field itself, and will always map to an empty set, or a string representing a sub-field or item. The string will follow one of these four formats: 'f:&lt;name&gt;', where &lt;name&gt; is the name of a field in a struct, or key in a map 'v:&lt;value&gt;', where &lt;value&gt; is the exact json formatted value of a list item 'i:&lt;index&gt;', where &lt;index&gt; is position of a item in a list 'k:&lt;keys&gt;', where &lt;keys&gt; is a map of  a list item's key fields to their unique values If a key maps to an empty Fields value, the field that key represents is part of the set.<br><p> <br><p> The exact format is defined in sigs.k8s.io/structured-merge-diff
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/FlexPersistentVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/FlexPersistentVolumeSource.java
index c595daa411f..93b8be7e846 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/FlexPersistentVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/FlexPersistentVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FlexPersistentVolumeSource represents a generic persistent volume resource that is provisioned/attached using an exec based plugin.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -66,52 +69,82 @@ public FlexPersistentVolumeSource(String driver, String fsType, Map<String, Stri
         this.secretRef = secretRef;
     }
 
+    /**
+     * driver is the name of the driver to use for this volume.
+     */
     @JsonProperty("driver")
     public String getDriver() {
         return driver;
     }
 
+    /**
+     * driver is the name of the driver to use for this volume.
+     */
     @JsonProperty("driver")
     public void setDriver(String driver) {
         this.driver = driver;
     }
 
+    /**
+     * fsType is the Filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". The default filesystem depends on FlexVolume script.
+     */
     @JsonProperty("fsType")
     public String getFsType() {
         return fsType;
     }
 
+    /**
+     * fsType is the Filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". The default filesystem depends on FlexVolume script.
+     */
     @JsonProperty("fsType")
     public void setFsType(String fsType) {
         this.fsType = fsType;
     }
 
+    /**
+     * options is Optional: this field holds extra command options if any.
+     */
     @JsonProperty("options")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getOptions() {
         return options;
     }
 
+    /**
+     * options is Optional: this field holds extra command options if any.
+     */
     @JsonProperty("options")
     public void setOptions(Map<String, String> options) {
         this.options = options;
     }
 
+    /**
+     * readOnly is Optional: defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly is Optional: defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * FlexPersistentVolumeSource represents a generic persistent volume resource that is provisioned/attached using an exec based plugin.
+     */
     @JsonProperty("secretRef")
     public SecretReference getSecretRef() {
         return secretRef;
     }
 
+    /**
+     * FlexPersistentVolumeSource represents a generic persistent volume resource that is provisioned/attached using an exec based plugin.
+     */
     @JsonProperty("secretRef")
     public void setSecretRef(SecretReference secretRef) {
         this.secretRef = secretRef;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/FlexVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/FlexVolumeSource.java
index 03772f95e11..b1169148a21 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/FlexVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/FlexVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FlexVolume represents a generic volume resource that is provisioned/attached using an exec based plugin.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -66,52 +69,82 @@ public FlexVolumeSource(String driver, String fsType, Map<String, String> option
         this.secretRef = secretRef;
     }
 
+    /**
+     * driver is the name of the driver to use for this volume.
+     */
     @JsonProperty("driver")
     public String getDriver() {
         return driver;
     }
 
+    /**
+     * driver is the name of the driver to use for this volume.
+     */
     @JsonProperty("driver")
     public void setDriver(String driver) {
         this.driver = driver;
     }
 
+    /**
+     * fsType is the filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". The default filesystem depends on FlexVolume script.
+     */
     @JsonProperty("fsType")
     public String getFsType() {
         return fsType;
     }
 
+    /**
+     * fsType is the filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". The default filesystem depends on FlexVolume script.
+     */
     @JsonProperty("fsType")
     public void setFsType(String fsType) {
         this.fsType = fsType;
     }
 
+    /**
+     * options is Optional: this field holds extra command options if any.
+     */
     @JsonProperty("options")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getOptions() {
         return options;
     }
 
+    /**
+     * options is Optional: this field holds extra command options if any.
+     */
     @JsonProperty("options")
     public void setOptions(Map<String, String> options) {
         this.options = options;
     }
 
+    /**
+     * readOnly is Optional: defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly is Optional: defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * FlexVolume represents a generic volume resource that is provisioned/attached using an exec based plugin.
+     */
     @JsonProperty("secretRef")
     public LocalObjectReference getSecretRef() {
         return secretRef;
     }
 
+    /**
+     * FlexVolume represents a generic volume resource that is provisioned/attached using an exec based plugin.
+     */
     @JsonProperty("secretRef")
     public void setSecretRef(LocalObjectReference secretRef) {
         this.secretRef = secretRef;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/FlockerVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/FlockerVolumeSource.java
index 7ce6ab700f2..b00128a04c0 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/FlockerVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/FlockerVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Represents a Flocker volume mounted by the Flocker agent. One and only one of datasetName and datasetUUID should be set. Flocker volumes do not support ownership management or SELinux relabeling.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public FlockerVolumeSource(String datasetName, String datasetUUID) {
         this.datasetUUID = datasetUUID;
     }
 
+    /**
+     * datasetName is Name of the dataset stored as metadata -&gt; name on the dataset for Flocker should be considered as deprecated
+     */
     @JsonProperty("datasetName")
     public String getDatasetName() {
         return datasetName;
     }
 
+    /**
+     * datasetName is Name of the dataset stored as metadata -&gt; name on the dataset for Flocker should be considered as deprecated
+     */
     @JsonProperty("datasetName")
     public void setDatasetName(String datasetName) {
         this.datasetName = datasetName;
     }
 
+    /**
+     * datasetUUID is the UUID of the dataset. This is unique identifier of a Flocker dataset
+     */
     @JsonProperty("datasetUUID")
     public String getDatasetUUID() {
         return datasetUUID;
     }
 
+    /**
+     * datasetUUID is the UUID of the dataset. This is unique identifier of a Flocker dataset
+     */
     @JsonProperty("datasetUUID")
     public void setDatasetUUID(String datasetUUID) {
         this.datasetUUID = datasetUUID;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/GCEPersistentDiskVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/GCEPersistentDiskVolumeSource.java
index 2cb8fd033fa..719750db990 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/GCEPersistentDiskVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/GCEPersistentDiskVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Represents a Persistent Disk resource in Google Compute Engine.<br><p> <br><p> A GCE PD must exist before mounting to a container. The disk must also be in the same GCE project and zone as the kubelet. A GCE PD can only be mounted as read/write once or read-only many times. GCE PDs support ownership management and SELinux relabeling.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -61,41 +64,65 @@ public GCEPersistentDiskVolumeSource(String fsType, Integer partition, String pd
         this.readOnly = readOnly;
     }
 
+    /**
+     * fsType is filesystem type of the volume that you want to mount. Tip: Ensure that the filesystem type is supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified. More info: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk
+     */
     @JsonProperty("fsType")
     public String getFsType() {
         return fsType;
     }
 
+    /**
+     * fsType is filesystem type of the volume that you want to mount. Tip: Ensure that the filesystem type is supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified. More info: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk
+     */
     @JsonProperty("fsType")
     public void setFsType(String fsType) {
         this.fsType = fsType;
     }
 
+    /**
+     * partition is the partition in the volume that you want to mount. If omitted, the default is to mount by volume name. Examples: For volume /dev/sda1, you specify the partition as "1". Similarly, the volume partition for /dev/sda is "0" (or you can leave the property empty). More info: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk
+     */
     @JsonProperty("partition")
     public Integer getPartition() {
         return partition;
     }
 
+    /**
+     * partition is the partition in the volume that you want to mount. If omitted, the default is to mount by volume name. Examples: For volume /dev/sda1, you specify the partition as "1". Similarly, the volume partition for /dev/sda is "0" (or you can leave the property empty). More info: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk
+     */
     @JsonProperty("partition")
     public void setPartition(Integer partition) {
         this.partition = partition;
     }
 
+    /**
+     * pdName is unique name of the PD resource in GCE. Used to identify the disk in GCE. More info: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk
+     */
     @JsonProperty("pdName")
     public String getPdName() {
         return pdName;
     }
 
+    /**
+     * pdName is unique name of the PD resource in GCE. Used to identify the disk in GCE. More info: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk
+     */
     @JsonProperty("pdName")
     public void setPdName(String pdName) {
         this.pdName = pdName;
     }
 
+    /**
+     * readOnly here will force the ReadOnly setting in VolumeMounts. Defaults to false. More info: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly here will force the ReadOnly setting in VolumeMounts. Defaults to false. More info: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/GRPCAction.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/GRPCAction.java
index ca1297e064e..4fb9949429e 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/GRPCAction.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/GRPCAction.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GRPCAction specifies an action involving a GRPC service.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public GRPCAction(Integer port, String service) {
         this.service = service;
     }
 
+    /**
+     * Port number of the gRPC service. Number must be in the range 1 to 65535.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * Port number of the gRPC service. Number must be in the range 1 to 65535.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * Service is the name of the service to place in the gRPC HealthCheckRequest (see https://github.com/grpc/grpc/blob/master/doc/health-checking.md).<br><p> <br><p> If this is not specified, the default behavior is defined by gRPC.
+     */
     @JsonProperty("service")
     public String getService() {
         return service;
     }
 
+    /**
+     * Service is the name of the service to place in the gRPC HealthCheckRequest (see https://github.com/grpc/grpc/blob/master/doc/health-checking.md).<br><p> <br><p> If this is not specified, the default behavior is defined by gRPC.
+     */
     @JsonProperty("service")
     public void setService(String service) {
         this.service = service;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/GetOptions.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/GetOptions.java
index 4aa793cb957..4cbb7a6d564 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/GetOptions.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/GetOptions.java
@@ -44,14 +44,8 @@
 public class GetOptions implements Editable<GetOptionsBuilder>, KubernetesResource
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GetOptions";
     @JsonProperty("resourceVersion")
@@ -72,33 +66,21 @@ public GetOptions(String apiVersion, String kind, String resourceVersion) {
         this.resourceVersion = resourceVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/GitRepoVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/GitRepoVolumeSource.java
index 84f9546463e..6a55cb0e84a 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/GitRepoVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/GitRepoVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Represents a volume that is populated with the contents of a git repository. Git repo volumes do not support ownership management. Git repo volumes support SELinux relabeling.<br><p> <br><p> DEPRECATED: GitRepo is deprecated. To provision a container with a git repo, mount an EmptyDir into an InitContainer that clones the repo using git, then mount the EmptyDir into the Pod's container.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -57,31 +60,49 @@ public GitRepoVolumeSource(String directory, String repository, String revision)
         this.revision = revision;
     }
 
+    /**
+     * directory is the target directory name. Must not contain or start with '..'.  If '.' is supplied, the volume directory will be the git repository.  Otherwise, if specified, the volume will contain the git repository in the subdirectory with the given name.
+     */
     @JsonProperty("directory")
     public String getDirectory() {
         return directory;
     }
 
+    /**
+     * directory is the target directory name. Must not contain or start with '..'.  If '.' is supplied, the volume directory will be the git repository.  Otherwise, if specified, the volume will contain the git repository in the subdirectory with the given name.
+     */
     @JsonProperty("directory")
     public void setDirectory(String directory) {
         this.directory = directory;
     }
 
+    /**
+     * repository is the URL
+     */
     @JsonProperty("repository")
     public String getRepository() {
         return repository;
     }
 
+    /**
+     * repository is the URL
+     */
     @JsonProperty("repository")
     public void setRepository(String repository) {
         this.repository = repository;
     }
 
+    /**
+     * revision is the commit hash for the specified revision.
+     */
     @JsonProperty("revision")
     public String getRevision() {
         return revision;
     }
 
+    /**
+     * revision is the commit hash for the specified revision.
+     */
     @JsonProperty("revision")
     public void setRevision(String revision) {
         this.revision = revision;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/GlusterfsPersistentVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/GlusterfsPersistentVolumeSource.java
index 72c5f27f68b..c051cd5238c 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/GlusterfsPersistentVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/GlusterfsPersistentVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Represents a Glusterfs mount that lasts the lifetime of a pod. Glusterfs volumes do not support ownership management or SELinux relabeling.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -61,41 +64,65 @@ public GlusterfsPersistentVolumeSource(String endpoints, String endpointsNamespa
         this.readOnly = readOnly;
     }
 
+    /**
+     * endpoints is the endpoint name that details Glusterfs topology. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
+     */
     @JsonProperty("endpoints")
     public String getEndpoints() {
         return endpoints;
     }
 
+    /**
+     * endpoints is the endpoint name that details Glusterfs topology. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
+     */
     @JsonProperty("endpoints")
     public void setEndpoints(String endpoints) {
         this.endpoints = endpoints;
     }
 
+    /**
+     * endpointsNamespace is the namespace that contains Glusterfs endpoint. If this field is empty, the EndpointNamespace defaults to the same namespace as the bound PVC. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
+     */
     @JsonProperty("endpointsNamespace")
     public String getEndpointsNamespace() {
         return endpointsNamespace;
     }
 
+    /**
+     * endpointsNamespace is the namespace that contains Glusterfs endpoint. If this field is empty, the EndpointNamespace defaults to the same namespace as the bound PVC. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
+     */
     @JsonProperty("endpointsNamespace")
     public void setEndpointsNamespace(String endpointsNamespace) {
         this.endpointsNamespace = endpointsNamespace;
     }
 
+    /**
+     * path is the Glusterfs volume path. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * path is the Glusterfs volume path. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * readOnly here will force the Glusterfs volume to be mounted with read-only permissions. Defaults to false. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly here will force the Glusterfs volume to be mounted with read-only permissions. Defaults to false. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/GlusterfsVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/GlusterfsVolumeSource.java
index 03e31c44479..6ebdbc32415 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/GlusterfsVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/GlusterfsVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Represents a Glusterfs mount that lasts the lifetime of a pod. Glusterfs volumes do not support ownership management or SELinux relabeling.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -57,31 +60,49 @@ public GlusterfsVolumeSource(String endpoints, String path, Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * endpoints is the endpoint name that details Glusterfs topology. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
+     */
     @JsonProperty("endpoints")
     public String getEndpoints() {
         return endpoints;
     }
 
+    /**
+     * endpoints is the endpoint name that details Glusterfs topology. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
+     */
     @JsonProperty("endpoints")
     public void setEndpoints(String endpoints) {
         this.endpoints = endpoints;
     }
 
+    /**
+     * path is the Glusterfs volume path. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * path is the Glusterfs volume path. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * readOnly here will force the Glusterfs volume to be mounted with read-only permissions. Defaults to false. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly here will force the Glusterfs volume to be mounted with read-only permissions. Defaults to false. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/GroupVersionForDiscovery.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/GroupVersionForDiscovery.java
index 9a0c3c203fa..89c09e00260 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/GroupVersionForDiscovery.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/GroupVersionForDiscovery.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GroupVersion contains the "group/version" and "version" string of a version. It is made a struct to keep extensibility.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public GroupVersionForDiscovery(String groupVersion, String version) {
         this.version = version;
     }
 
+    /**
+     * groupVersion specifies the API group and version in the form "group/version"
+     */
     @JsonProperty("groupVersion")
     public String getGroupVersion() {
         return groupVersion;
     }
 
+    /**
+     * groupVersion specifies the API group and version in the form "group/version"
+     */
     @JsonProperty("groupVersion")
     public void setGroupVersion(String groupVersion) {
         this.groupVersion = groupVersion;
     }
 
+    /**
+     * version specifies the version in the form of "version". This is to save the clients the trouble of splitting the GroupVersion.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version specifies the version in the form of "version". This is to save the clients the trouble of splitting the GroupVersion.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/HTTPGetAction.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/HTTPGetAction.java
index 5286f5068a2..41ac60d96b9 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/HTTPGetAction.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/HTTPGetAction.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPGetAction describes an action based on HTTP Get requests.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -68,52 +71,82 @@ public HTTPGetAction(String host, List<HTTPHeader> httpHeaders, String path, Int
         this.scheme = scheme;
     }
 
+    /**
+     * Host name to connect to, defaults to the pod IP. You probably want to set "Host" in httpHeaders instead.
+     */
     @JsonProperty("host")
     public String getHost() {
         return host;
     }
 
+    /**
+     * Host name to connect to, defaults to the pod IP. You probably want to set "Host" in httpHeaders instead.
+     */
     @JsonProperty("host")
     public void setHost(String host) {
         this.host = host;
     }
 
+    /**
+     * Custom headers to set in the request. HTTP allows repeated headers.
+     */
     @JsonProperty("httpHeaders")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HTTPHeader> getHttpHeaders() {
         return httpHeaders;
     }
 
+    /**
+     * Custom headers to set in the request. HTTP allows repeated headers.
+     */
     @JsonProperty("httpHeaders")
     public void setHttpHeaders(List<HTTPHeader> httpHeaders) {
         this.httpHeaders = httpHeaders;
     }
 
+    /**
+     * Path to access on the HTTP server.
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Path to access on the HTTP server.
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * HTTPGetAction describes an action based on HTTP Get requests.
+     */
     @JsonProperty("port")
     public IntOrString getPort() {
         return port;
     }
 
+    /**
+     * HTTPGetAction describes an action based on HTTP Get requests.
+     */
     @JsonProperty("port")
     public void setPort(IntOrString port) {
         this.port = port;
     }
 
+    /**
+     * Scheme to use for connecting to the host. Defaults to HTTP.
+     */
     @JsonProperty("scheme")
     public String getScheme() {
         return scheme;
     }
 
+    /**
+     * Scheme to use for connecting to the host. Defaults to HTTP.
+     */
     @JsonProperty("scheme")
     public void setScheme(String scheme) {
         this.scheme = scheme;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/HTTPHeader.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/HTTPHeader.java
index 7313063af33..80e1adb3d89 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/HTTPHeader.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/HTTPHeader.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPHeader describes a custom header to be used in HTTP probes
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public HTTPHeader(String name, String value) {
         this.value = value;
     }
 
+    /**
+     * The header field name. This will be canonicalized upon output, so case-variant names will be understood as the same header.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The header field name. This will be canonicalized upon output, so case-variant names will be understood as the same header.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * The header field value
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * The header field value
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/HostAlias.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/HostAlias.java
index b90de554be5..b46cf72e00c 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/HostAlias.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/HostAlias.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HostAlias holds the mapping between IP and hostnames that will be injected as an entry in the pod's hosts file.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -56,22 +59,34 @@ public HostAlias(List<String> hostnames, String ip) {
         this.ip = ip;
     }
 
+    /**
+     * Hostnames for the above IP address.
+     */
     @JsonProperty("hostnames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getHostnames() {
         return hostnames;
     }
 
+    /**
+     * Hostnames for the above IP address.
+     */
     @JsonProperty("hostnames")
     public void setHostnames(List<String> hostnames) {
         this.hostnames = hostnames;
     }
 
+    /**
+     * IP address of the host file entry.
+     */
     @JsonProperty("ip")
     public String getIp() {
         return ip;
     }
 
+    /**
+     * IP address of the host file entry.
+     */
     @JsonProperty("ip")
     public void setIp(String ip) {
         this.ip = ip;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/HostIP.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/HostIP.java
index d24a8a874ac..a0046966cb6 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/HostIP.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/HostIP.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HostIP represents a single IP address allocated to the host.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -49,11 +52,17 @@ public HostIP(String ip) {
         this.ip = ip;
     }
 
+    /**
+     * IP is the IP address assigned to the host
+     */
     @JsonProperty("ip")
     public String getIp() {
         return ip;
     }
 
+    /**
+     * IP is the IP address assigned to the host
+     */
     @JsonProperty("ip")
     public void setIp(String ip) {
         this.ip = ip;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/HostPathVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/HostPathVolumeSource.java
index 42d57a4d80d..989bd0f966a 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/HostPathVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/HostPathVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Represents a host path mapped into a pod. Host path volumes do not support ownership management or SELinux relabeling.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public HostPathVolumeSource(String path, String type) {
         this.type = type;
     }
 
+    /**
+     * path of the directory on the host. If the path is a symlink, it will follow the link to the real path. More info: https://kubernetes.io/docs/concepts/storage/volumes#hostpath
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * path of the directory on the host. If the path is a symlink, it will follow the link to the real path. More info: https://kubernetes.io/docs/concepts/storage/volumes#hostpath
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * type for HostPath Volume Defaults to "" More info: https://kubernetes.io/docs/concepts/storage/volumes#hostpath
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type for HostPath Volume Defaults to "" More info: https://kubernetes.io/docs/concepts/storage/volumes#hostpath
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ISCSIPersistentVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ISCSIPersistentVolumeSource.java
index 5adec1770e5..fd90846e3e0 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ISCSIPersistentVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ISCSIPersistentVolumeSource.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ISCSIPersistentVolumeSource represents an ISCSI disk. ISCSI volumes can only be mounted as read/write once. ISCSI volumes support ownership management and SELinux relabeling.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -92,112 +95,178 @@ public ISCSIPersistentVolumeSource(Boolean chapAuthDiscovery, Boolean chapAuthSe
         this.targetPortal = targetPortal;
     }
 
+    /**
+     * chapAuthDiscovery defines whether support iSCSI Discovery CHAP authentication
+     */
     @JsonProperty("chapAuthDiscovery")
     public Boolean getChapAuthDiscovery() {
         return chapAuthDiscovery;
     }
 
+    /**
+     * chapAuthDiscovery defines whether support iSCSI Discovery CHAP authentication
+     */
     @JsonProperty("chapAuthDiscovery")
     public void setChapAuthDiscovery(Boolean chapAuthDiscovery) {
         this.chapAuthDiscovery = chapAuthDiscovery;
     }
 
+    /**
+     * chapAuthSession defines whether support iSCSI Session CHAP authentication
+     */
     @JsonProperty("chapAuthSession")
     public Boolean getChapAuthSession() {
         return chapAuthSession;
     }
 
+    /**
+     * chapAuthSession defines whether support iSCSI Session CHAP authentication
+     */
     @JsonProperty("chapAuthSession")
     public void setChapAuthSession(Boolean chapAuthSession) {
         this.chapAuthSession = chapAuthSession;
     }
 
+    /**
+     * fsType is the filesystem type of the volume that you want to mount. Tip: Ensure that the filesystem type is supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified. More info: https://kubernetes.io/docs/concepts/storage/volumes#iscsi
+     */
     @JsonProperty("fsType")
     public String getFsType() {
         return fsType;
     }
 
+    /**
+     * fsType is the filesystem type of the volume that you want to mount. Tip: Ensure that the filesystem type is supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified. More info: https://kubernetes.io/docs/concepts/storage/volumes#iscsi
+     */
     @JsonProperty("fsType")
     public void setFsType(String fsType) {
         this.fsType = fsType;
     }
 
+    /**
+     * initiatorName is the custom iSCSI Initiator Name. If initiatorName is specified with iscsiInterface simultaneously, new iSCSI interface &lt;target portal&gt;:&lt;volume name&gt; will be created for the connection.
+     */
     @JsonProperty("initiatorName")
     public String getInitiatorName() {
         return initiatorName;
     }
 
+    /**
+     * initiatorName is the custom iSCSI Initiator Name. If initiatorName is specified with iscsiInterface simultaneously, new iSCSI interface &lt;target portal&gt;:&lt;volume name&gt; will be created for the connection.
+     */
     @JsonProperty("initiatorName")
     public void setInitiatorName(String initiatorName) {
         this.initiatorName = initiatorName;
     }
 
+    /**
+     * iqn is Target iSCSI Qualified Name.
+     */
     @JsonProperty("iqn")
     public String getIqn() {
         return iqn;
     }
 
+    /**
+     * iqn is Target iSCSI Qualified Name.
+     */
     @JsonProperty("iqn")
     public void setIqn(String iqn) {
         this.iqn = iqn;
     }
 
+    /**
+     * iscsiInterface is the interface Name that uses an iSCSI transport. Defaults to 'default' (tcp).
+     */
     @JsonProperty("iscsiInterface")
     public String getIscsiInterface() {
         return iscsiInterface;
     }
 
+    /**
+     * iscsiInterface is the interface Name that uses an iSCSI transport. Defaults to 'default' (tcp).
+     */
     @JsonProperty("iscsiInterface")
     public void setIscsiInterface(String iscsiInterface) {
         this.iscsiInterface = iscsiInterface;
     }
 
+    /**
+     * lun is iSCSI Target Lun number.
+     */
     @JsonProperty("lun")
     public Integer getLun() {
         return lun;
     }
 
+    /**
+     * lun is iSCSI Target Lun number.
+     */
     @JsonProperty("lun")
     public void setLun(Integer lun) {
         this.lun = lun;
     }
 
+    /**
+     * portals is the iSCSI Target Portal List. The Portal is either an IP or ip_addr:port if the port is other than default (typically TCP ports 860 and 3260).
+     */
     @JsonProperty("portals")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPortals() {
         return portals;
     }
 
+    /**
+     * portals is the iSCSI Target Portal List. The Portal is either an IP or ip_addr:port if the port is other than default (typically TCP ports 860 and 3260).
+     */
     @JsonProperty("portals")
     public void setPortals(List<String> portals) {
         this.portals = portals;
     }
 
+    /**
+     * readOnly here will force the ReadOnly setting in VolumeMounts. Defaults to false.
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly here will force the ReadOnly setting in VolumeMounts. Defaults to false.
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * ISCSIPersistentVolumeSource represents an ISCSI disk. ISCSI volumes can only be mounted as read/write once. ISCSI volumes support ownership management and SELinux relabeling.
+     */
     @JsonProperty("secretRef")
     public SecretReference getSecretRef() {
         return secretRef;
     }
 
+    /**
+     * ISCSIPersistentVolumeSource represents an ISCSI disk. ISCSI volumes can only be mounted as read/write once. ISCSI volumes support ownership management and SELinux relabeling.
+     */
     @JsonProperty("secretRef")
     public void setSecretRef(SecretReference secretRef) {
         this.secretRef = secretRef;
     }
 
+    /**
+     * targetPortal is iSCSI Target Portal. The Portal is either an IP or ip_addr:port if the port is other than default (typically TCP ports 860 and 3260).
+     */
     @JsonProperty("targetPortal")
     public String getTargetPortal() {
         return targetPortal;
     }
 
+    /**
+     * targetPortal is iSCSI Target Portal. The Portal is either an IP or ip_addr:port if the port is other than default (typically TCP ports 860 and 3260).
+     */
     @JsonProperty("targetPortal")
     public void setTargetPortal(String targetPortal) {
         this.targetPortal = targetPortal;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ISCSIVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ISCSIVolumeSource.java
index ba070a7864c..90604726621 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ISCSIVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ISCSIVolumeSource.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Represents an ISCSI disk. ISCSI volumes can only be mounted as read/write once. ISCSI volumes support ownership management and SELinux relabeling.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -92,112 +95,178 @@ public ISCSIVolumeSource(Boolean chapAuthDiscovery, Boolean chapAuthSession, Str
         this.targetPortal = targetPortal;
     }
 
+    /**
+     * chapAuthDiscovery defines whether support iSCSI Discovery CHAP authentication
+     */
     @JsonProperty("chapAuthDiscovery")
     public Boolean getChapAuthDiscovery() {
         return chapAuthDiscovery;
     }
 
+    /**
+     * chapAuthDiscovery defines whether support iSCSI Discovery CHAP authentication
+     */
     @JsonProperty("chapAuthDiscovery")
     public void setChapAuthDiscovery(Boolean chapAuthDiscovery) {
         this.chapAuthDiscovery = chapAuthDiscovery;
     }
 
+    /**
+     * chapAuthSession defines whether support iSCSI Session CHAP authentication
+     */
     @JsonProperty("chapAuthSession")
     public Boolean getChapAuthSession() {
         return chapAuthSession;
     }
 
+    /**
+     * chapAuthSession defines whether support iSCSI Session CHAP authentication
+     */
     @JsonProperty("chapAuthSession")
     public void setChapAuthSession(Boolean chapAuthSession) {
         this.chapAuthSession = chapAuthSession;
     }
 
+    /**
+     * fsType is the filesystem type of the volume that you want to mount. Tip: Ensure that the filesystem type is supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified. More info: https://kubernetes.io/docs/concepts/storage/volumes#iscsi
+     */
     @JsonProperty("fsType")
     public String getFsType() {
         return fsType;
     }
 
+    /**
+     * fsType is the filesystem type of the volume that you want to mount. Tip: Ensure that the filesystem type is supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified. More info: https://kubernetes.io/docs/concepts/storage/volumes#iscsi
+     */
     @JsonProperty("fsType")
     public void setFsType(String fsType) {
         this.fsType = fsType;
     }
 
+    /**
+     * initiatorName is the custom iSCSI Initiator Name. If initiatorName is specified with iscsiInterface simultaneously, new iSCSI interface &lt;target portal&gt;:&lt;volume name&gt; will be created for the connection.
+     */
     @JsonProperty("initiatorName")
     public String getInitiatorName() {
         return initiatorName;
     }
 
+    /**
+     * initiatorName is the custom iSCSI Initiator Name. If initiatorName is specified with iscsiInterface simultaneously, new iSCSI interface &lt;target portal&gt;:&lt;volume name&gt; will be created for the connection.
+     */
     @JsonProperty("initiatorName")
     public void setInitiatorName(String initiatorName) {
         this.initiatorName = initiatorName;
     }
 
+    /**
+     * iqn is the target iSCSI Qualified Name.
+     */
     @JsonProperty("iqn")
     public String getIqn() {
         return iqn;
     }
 
+    /**
+     * iqn is the target iSCSI Qualified Name.
+     */
     @JsonProperty("iqn")
     public void setIqn(String iqn) {
         this.iqn = iqn;
     }
 
+    /**
+     * iscsiInterface is the interface Name that uses an iSCSI transport. Defaults to 'default' (tcp).
+     */
     @JsonProperty("iscsiInterface")
     public String getIscsiInterface() {
         return iscsiInterface;
     }
 
+    /**
+     * iscsiInterface is the interface Name that uses an iSCSI transport. Defaults to 'default' (tcp).
+     */
     @JsonProperty("iscsiInterface")
     public void setIscsiInterface(String iscsiInterface) {
         this.iscsiInterface = iscsiInterface;
     }
 
+    /**
+     * lun represents iSCSI Target Lun number.
+     */
     @JsonProperty("lun")
     public Integer getLun() {
         return lun;
     }
 
+    /**
+     * lun represents iSCSI Target Lun number.
+     */
     @JsonProperty("lun")
     public void setLun(Integer lun) {
         this.lun = lun;
     }
 
+    /**
+     * portals is the iSCSI Target Portal List. The portal is either an IP or ip_addr:port if the port is other than default (typically TCP ports 860 and 3260).
+     */
     @JsonProperty("portals")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPortals() {
         return portals;
     }
 
+    /**
+     * portals is the iSCSI Target Portal List. The portal is either an IP or ip_addr:port if the port is other than default (typically TCP ports 860 and 3260).
+     */
     @JsonProperty("portals")
     public void setPortals(List<String> portals) {
         this.portals = portals;
     }
 
+    /**
+     * readOnly here will force the ReadOnly setting in VolumeMounts. Defaults to false.
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly here will force the ReadOnly setting in VolumeMounts. Defaults to false.
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * Represents an ISCSI disk. ISCSI volumes can only be mounted as read/write once. ISCSI volumes support ownership management and SELinux relabeling.
+     */
     @JsonProperty("secretRef")
     public LocalObjectReference getSecretRef() {
         return secretRef;
     }
 
+    /**
+     * Represents an ISCSI disk. ISCSI volumes can only be mounted as read/write once. ISCSI volumes support ownership management and SELinux relabeling.
+     */
     @JsonProperty("secretRef")
     public void setSecretRef(LocalObjectReference secretRef) {
         this.secretRef = secretRef;
     }
 
+    /**
+     * targetPortal is iSCSI Target Portal. The Portal is either an IP or ip_addr:port if the port is other than default (typically TCP ports 860 and 3260).
+     */
     @JsonProperty("targetPortal")
     public String getTargetPortal() {
         return targetPortal;
     }
 
+    /**
+     * targetPortal is iSCSI Target Portal. The Portal is either an IP or ip_addr:port if the port is other than default (typically TCP ports 860 and 3260).
+     */
     @JsonProperty("targetPortal")
     public void setTargetPortal(String targetPortal) {
         this.targetPortal = targetPortal;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ImageVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ImageVolumeSource.java
index 661cdf81ccb..5e5c5a94b95 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ImageVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ImageVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageVolumeSource represents a image volume resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public ImageVolumeSource(String pullPolicy, String reference) {
         this.reference = reference;
     }
 
+    /**
+     * Policy for pulling OCI objects. Possible values are: Always: the kubelet always attempts to pull the reference. Container creation will fail If the pull fails. Never: the kubelet never pulls the reference and only uses a local image or artifact. Container creation will fail if the reference isn't present. IfNotPresent: the kubelet pulls if the reference isn't already present on disk. Container creation will fail if the reference isn't present and the pull fails. Defaults to Always if :latest tag is specified, or IfNotPresent otherwise.
+     */
     @JsonProperty("pullPolicy")
     public String getPullPolicy() {
         return pullPolicy;
     }
 
+    /**
+     * Policy for pulling OCI objects. Possible values are: Always: the kubelet always attempts to pull the reference. Container creation will fail If the pull fails. Never: the kubelet never pulls the reference and only uses a local image or artifact. Container creation will fail if the reference isn't present. IfNotPresent: the kubelet pulls if the reference isn't already present on disk. Container creation will fail if the reference isn't present and the pull fails. Defaults to Always if :latest tag is specified, or IfNotPresent otherwise.
+     */
     @JsonProperty("pullPolicy")
     public void setPullPolicy(String pullPolicy) {
         this.pullPolicy = pullPolicy;
     }
 
+    /**
+     * Required: Image or artifact reference to be used. Behaves in the same way as pod.spec.containers[&#42;].image. Pull secrets will be assembled in the same way as for the container image by looking up node credentials, SA image pull secrets, and pod spec image pull secrets. More info: https://kubernetes.io/docs/concepts/containers/images This field is optional to allow higher level config management to default or override container images in workload controllers like Deployments and StatefulSets.
+     */
     @JsonProperty("reference")
     public String getReference() {
         return reference;
     }
 
+    /**
+     * Required: Image or artifact reference to be used. Behaves in the same way as pod.spec.containers[&#42;].image. Pull secrets will be assembled in the same way as for the container image by looking up node credentials, SA image pull secrets, and pod spec image pull secrets. More info: https://kubernetes.io/docs/concepts/containers/images This field is optional to allow higher level config management to default or override container images in workload controllers like Deployments and StatefulSets.
+     */
     @JsonProperty("reference")
     public void setReference(String reference) {
         this.reference = reference;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/KeyToPath.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/KeyToPath.java
index de06c48102c..4f9a5978231 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/KeyToPath.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/KeyToPath.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Maps a string key to a path within a volume.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -57,31 +60,49 @@ public KeyToPath(String key, Integer mode, String path) {
         this.path = path;
     }
 
+    /**
+     * key is the key to project.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * key is the key to project.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * mode is Optional: mode bits used to set permissions on this file. Must be an octal value between 0000 and 0777 or a decimal value between 0 and 511. YAML accepts both octal and decimal values, JSON requires decimal values for mode bits. If not specified, the volume defaultMode will be used. This might be in conflict with other options that affect the file mode, like fsGroup, and the result can be other mode bits set.
+     */
     @JsonProperty("mode")
     public Integer getMode() {
         return mode;
     }
 
+    /**
+     * mode is Optional: mode bits used to set permissions on this file. Must be an octal value between 0000 and 0777 or a decimal value between 0 and 511. YAML accepts both octal and decimal values, JSON requires decimal values for mode bits. If not specified, the volume defaultMode will be used. This might be in conflict with other options that affect the file mode, like fsGroup, and the result can be other mode bits set.
+     */
     @JsonProperty("mode")
     public void setMode(Integer mode) {
         this.mode = mode;
     }
 
+    /**
+     * path is the relative path of the file to map the key to. May not be an absolute path. May not contain the path element '..'. May not start with the string '..'.
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * path is the relative path of the file to map the key to. May not be an absolute path. May not contain the path element '..'. May not start with the string '..'.
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LabelSelector.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LabelSelector.java
index 2a7093e4ae6..a5a0ffffea2 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LabelSelector.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LabelSelector.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * A label selector is a label query over a set of resources. The result of matchLabels and matchExpressions are ANDed. An empty label selector matches all objects. A null label selector matches no objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -57,23 +60,35 @@ public LabelSelector(List<LabelSelectorRequirement> matchExpressions, Map<String
         this.matchLabels = matchLabels;
     }
 
+    /**
+     * matchExpressions is a list of label selector requirements. The requirements are ANDed.
+     */
     @JsonProperty("matchExpressions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LabelSelectorRequirement> getMatchExpressions() {
         return matchExpressions;
     }
 
+    /**
+     * matchExpressions is a list of label selector requirements. The requirements are ANDed.
+     */
     @JsonProperty("matchExpressions")
     public void setMatchExpressions(List<LabelSelectorRequirement> matchExpressions) {
         this.matchExpressions = matchExpressions;
     }
 
+    /**
+     * matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels map is equivalent to an element of matchExpressions, whose key field is "key", the operator is "In", and the values array contains only "value". The requirements are ANDed.
+     */
     @JsonProperty("matchLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getMatchLabels() {
         return matchLabels;
     }
 
+    /**
+     * matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels map is equivalent to an element of matchExpressions, whose key field is "key", the operator is "In", and the values array contains only "value". The requirements are ANDed.
+     */
     @JsonProperty("matchLabels")
     public void setMatchLabels(Map<String, String> matchLabels) {
         this.matchLabels = matchLabels;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LabelSelectorRequirement.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LabelSelectorRequirement.java
index cf2649036bb..3c7a3709970 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LabelSelectorRequirement.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LabelSelectorRequirement.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * A label selector requirement is a selector that contains values, a key, and an operator that relates the key and values.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -60,32 +63,50 @@ public LabelSelectorRequirement(String key, String operator, List<String> values
         this.values = values;
     }
 
+    /**
+     * key is the label key that the selector applies to.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * key is the label key that the selector applies to.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * operator represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists and DoesNotExist.
+     */
     @JsonProperty("operator")
     public String getOperator() {
         return operator;
     }
 
+    /**
+     * operator represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists and DoesNotExist.
+     */
     @JsonProperty("operator")
     public void setOperator(String operator) {
         this.operator = operator;
     }
 
+    /**
+     * values is an array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. This array is replaced during a strategic merge patch.
+     */
     @JsonProperty("values")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getValues() {
         return values;
     }
 
+    /**
+     * values is an array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. This array is replaced during a strategic merge patch.
+     */
     @JsonProperty("values")
     public void setValues(List<String> values) {
         this.values = values;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Lifecycle.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Lifecycle.java
index 87f3778e9d0..6f493098248 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Lifecycle.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Lifecycle.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Lifecycle describes actions that the management system should take in response to container lifecycle events. For the PostStart and PreStop lifecycle handlers, management of the container blocks until the action is complete, unless the container process fails, in which case the handler is aborted.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public Lifecycle(LifecycleHandler postStart, LifecycleHandler preStop) {
         this.preStop = preStop;
     }
 
+    /**
+     * Lifecycle describes actions that the management system should take in response to container lifecycle events. For the PostStart and PreStop lifecycle handlers, management of the container blocks until the action is complete, unless the container process fails, in which case the handler is aborted.
+     */
     @JsonProperty("postStart")
     public LifecycleHandler getPostStart() {
         return postStart;
     }
 
+    /**
+     * Lifecycle describes actions that the management system should take in response to container lifecycle events. For the PostStart and PreStop lifecycle handlers, management of the container blocks until the action is complete, unless the container process fails, in which case the handler is aborted.
+     */
     @JsonProperty("postStart")
     public void setPostStart(LifecycleHandler postStart) {
         this.postStart = postStart;
     }
 
+    /**
+     * Lifecycle describes actions that the management system should take in response to container lifecycle events. For the PostStart and PreStop lifecycle handlers, management of the container blocks until the action is complete, unless the container process fails, in which case the handler is aborted.
+     */
     @JsonProperty("preStop")
     public LifecycleHandler getPreStop() {
         return preStop;
     }
 
+    /**
+     * Lifecycle describes actions that the management system should take in response to container lifecycle events. For the PostStart and PreStop lifecycle handlers, management of the container blocks until the action is complete, unless the container process fails, in which case the handler is aborted.
+     */
     @JsonProperty("preStop")
     public void setPreStop(LifecycleHandler preStop) {
         this.preStop = preStop;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LifecycleHandler.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LifecycleHandler.java
index 499624dac70..7f674f75b2e 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LifecycleHandler.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LifecycleHandler.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LifecycleHandler defines a specific action that should be taken in a lifecycle hook. One and only one of the fields, except TCPSocket must be specified.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -61,41 +64,65 @@ public LifecycleHandler(ExecAction exec, HTTPGetAction httpGet, SleepAction slee
         this.tcpSocket = tcpSocket;
     }
 
+    /**
+     * LifecycleHandler defines a specific action that should be taken in a lifecycle hook. One and only one of the fields, except TCPSocket must be specified.
+     */
     @JsonProperty("exec")
     public ExecAction getExec() {
         return exec;
     }
 
+    /**
+     * LifecycleHandler defines a specific action that should be taken in a lifecycle hook. One and only one of the fields, except TCPSocket must be specified.
+     */
     @JsonProperty("exec")
     public void setExec(ExecAction exec) {
         this.exec = exec;
     }
 
+    /**
+     * LifecycleHandler defines a specific action that should be taken in a lifecycle hook. One and only one of the fields, except TCPSocket must be specified.
+     */
     @JsonProperty("httpGet")
     public HTTPGetAction getHttpGet() {
         return httpGet;
     }
 
+    /**
+     * LifecycleHandler defines a specific action that should be taken in a lifecycle hook. One and only one of the fields, except TCPSocket must be specified.
+     */
     @JsonProperty("httpGet")
     public void setHttpGet(HTTPGetAction httpGet) {
         this.httpGet = httpGet;
     }
 
+    /**
+     * LifecycleHandler defines a specific action that should be taken in a lifecycle hook. One and only one of the fields, except TCPSocket must be specified.
+     */
     @JsonProperty("sleep")
     public SleepAction getSleep() {
         return sleep;
     }
 
+    /**
+     * LifecycleHandler defines a specific action that should be taken in a lifecycle hook. One and only one of the fields, except TCPSocket must be specified.
+     */
     @JsonProperty("sleep")
     public void setSleep(SleepAction sleep) {
         this.sleep = sleep;
     }
 
+    /**
+     * LifecycleHandler defines a specific action that should be taken in a lifecycle hook. One and only one of the fields, except TCPSocket must be specified.
+     */
     @JsonProperty("tcpSocket")
     public TCPSocketAction getTcpSocket() {
         return tcpSocket;
     }
 
+    /**
+     * LifecycleHandler defines a specific action that should be taken in a lifecycle hook. One and only one of the fields, except TCPSocket must be specified.
+     */
     @JsonProperty("tcpSocket")
     public void setTcpSocket(TCPSocketAction tcpSocket) {
         this.tcpSocket = tcpSocket;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LimitRange.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LimitRange.java
index f5b06dcadde..67a155a323d 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LimitRange.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LimitRange.java
@@ -21,6 +21,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LimitRange sets resource usage limits for each kind of resource in a Namespace.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -45,14 +48,8 @@
 public class LimitRange implements Editable<LimitRangeBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "LimitRange";
     @JsonProperty("metadata")
@@ -77,7 +74,7 @@ public LimitRange(String apiVersion, String kind, ObjectMeta metadata, LimitRang
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -85,7 +82,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -93,7 +90,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -101,28 +98,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * LimitRange sets resource usage limits for each kind of resource in a Namespace.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * LimitRange sets resource usage limits for each kind of resource in a Namespace.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * LimitRange sets resource usage limits for each kind of resource in a Namespace.
+     */
     @JsonProperty("spec")
     public LimitRangeSpec getSpec() {
         return spec;
     }
 
+    /**
+     * LimitRange sets resource usage limits for each kind of resource in a Namespace.
+     */
     @JsonProperty("spec")
     public void setSpec(LimitRangeSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LimitRangeItem.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LimitRangeItem.java
index e14bb67ee48..42a31cf9023 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LimitRangeItem.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LimitRangeItem.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LimitRangeItem defines a min/max usage limit for any resource that matches on kind.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,66 +77,102 @@ public LimitRangeItem(Map<String, Quantity> _default, Map<String, Quantity> defa
         this.type = type;
     }
 
+    /**
+     * Default resource requirement limit value by resource name if resource limit is omitted.
+     */
     @JsonProperty("default")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getDefault() {
         return _default;
     }
 
+    /**
+     * Default resource requirement limit value by resource name if resource limit is omitted.
+     */
     @JsonProperty("default")
     public void setDefault(Map<String, Quantity> _default) {
         this._default = _default;
     }
 
+    /**
+     * DefaultRequest is the default resource requirement request value by resource name if resource request is omitted.
+     */
     @JsonProperty("defaultRequest")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getDefaultRequest() {
         return defaultRequest;
     }
 
+    /**
+     * DefaultRequest is the default resource requirement request value by resource name if resource request is omitted.
+     */
     @JsonProperty("defaultRequest")
     public void setDefaultRequest(Map<String, Quantity> defaultRequest) {
         this.defaultRequest = defaultRequest;
     }
 
+    /**
+     * Max usage constraints on this kind by resource name.
+     */
     @JsonProperty("max")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getMax() {
         return max;
     }
 
+    /**
+     * Max usage constraints on this kind by resource name.
+     */
     @JsonProperty("max")
     public void setMax(Map<String, Quantity> max) {
         this.max = max;
     }
 
+    /**
+     * MaxLimitRequestRatio if specified, the named resource must have a request and limit that are both non-zero where limit divided by request is less than or equal to the enumerated value; this represents the max burst for the named resource.
+     */
     @JsonProperty("maxLimitRequestRatio")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getMaxLimitRequestRatio() {
         return maxLimitRequestRatio;
     }
 
+    /**
+     * MaxLimitRequestRatio if specified, the named resource must have a request and limit that are both non-zero where limit divided by request is less than or equal to the enumerated value; this represents the max burst for the named resource.
+     */
     @JsonProperty("maxLimitRequestRatio")
     public void setMaxLimitRequestRatio(Map<String, Quantity> maxLimitRequestRatio) {
         this.maxLimitRequestRatio = maxLimitRequestRatio;
     }
 
+    /**
+     * Min usage constraints on this kind by resource name.
+     */
     @JsonProperty("min")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getMin() {
         return min;
     }
 
+    /**
+     * Min usage constraints on this kind by resource name.
+     */
     @JsonProperty("min")
     public void setMin(Map<String, Quantity> min) {
         this.min = min;
     }
 
+    /**
+     * Type of resource that this limit applies to.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of resource that this limit applies to.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LimitRangeList.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LimitRangeList.java
index 1f4af043036..d45a4ab37fd 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LimitRangeList.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LimitRangeList.java
@@ -23,6 +23,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LimitRangeList is a list of LimitRange items.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -47,17 +50,11 @@
 public class LimitRangeList implements Editable<LimitRangeListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.LimitRange>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.LimitRange> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "LimitRangeList";
     @JsonProperty("metadata")
@@ -80,7 +77,7 @@ public LimitRangeList(String apiVersion, List<io.fabric8.kubernetes.api.model.Li
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -88,26 +85,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of LimitRange objects. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.LimitRange> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of LimitRange objects. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.LimitRange> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -115,18 +118,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * LimitRangeList is a list of LimitRange items.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * LimitRangeList is a list of LimitRange items.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LimitRangeSpec.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LimitRangeSpec.java
index 4ba6ba6da42..f6b8ab6a981 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LimitRangeSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LimitRangeSpec.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LimitRangeSpec defines a min/max usage limit for resources that match on kind.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -52,12 +55,18 @@ public LimitRangeSpec(List<LimitRangeItem> limits) {
         this.limits = limits;
     }
 
+    /**
+     * Limits is the list of LimitRangeItem objects that are enforced.
+     */
     @JsonProperty("limits")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LimitRangeItem> getLimits() {
         return limits;
     }
 
+    /**
+     * Limits is the list of LimitRangeItem objects that are enforced.
+     */
     @JsonProperty("limits")
     public void setLimits(List<LimitRangeItem> limits) {
         this.limits = limits;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LinuxContainerUser.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LinuxContainerUser.java
index d1b2b2423e8..fbd59f6247f 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LinuxContainerUser.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LinuxContainerUser.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LinuxContainerUser represents user identity information in Linux containers
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -60,32 +63,50 @@ public LinuxContainerUser(Long gid, List<Long> supplementalGroups, Long uid) {
         this.uid = uid;
     }
 
+    /**
+     * GID is the primary gid initially attached to the first process in the container
+     */
     @JsonProperty("gid")
     public Long getGid() {
         return gid;
     }
 
+    /**
+     * GID is the primary gid initially attached to the first process in the container
+     */
     @JsonProperty("gid")
     public void setGid(Long gid) {
         this.gid = gid;
     }
 
+    /**
+     * SupplementalGroups are the supplemental groups initially attached to the first process in the container
+     */
     @JsonProperty("supplementalGroups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Long> getSupplementalGroups() {
         return supplementalGroups;
     }
 
+    /**
+     * SupplementalGroups are the supplemental groups initially attached to the first process in the container
+     */
     @JsonProperty("supplementalGroups")
     public void setSupplementalGroups(List<Long> supplementalGroups) {
         this.supplementalGroups = supplementalGroups;
     }
 
+    /**
+     * UID is the primary uid initially attached to the first process in the container
+     */
     @JsonProperty("uid")
     public Long getUid() {
         return uid;
     }
 
+    /**
+     * UID is the primary uid initially attached to the first process in the container
+     */
     @JsonProperty("uid")
     public void setUid(Long uid) {
         this.uid = uid;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ListOptions.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ListOptions.java
index a41105c0b79..61a5f1bcbef 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ListOptions.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ListOptions.java
@@ -55,18 +55,12 @@ public class ListOptions implements Editable<ListOptionsBuilder>, KubernetesReso
 
     @JsonProperty("allowWatchBookmarks")
     private Boolean allowWatchBookmarks;
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("continue")
     private String _continue;
     @JsonProperty("fieldSelector")
     private String fieldSelector;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ListOptions";
     @JsonProperty("labelSelector")
@@ -118,17 +112,11 @@ public void setAllowWatchBookmarks(Boolean allowWatchBookmarks) {
         this.allowWatchBookmarks = allowWatchBookmarks;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
@@ -154,17 +142,11 @@ public void setFieldSelector(String fieldSelector) {
         this.fieldSelector = fieldSelector;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LoadBalancerIngress.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LoadBalancerIngress.java
index c5962ffe5ed..30e4a90c8a6 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LoadBalancerIngress.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LoadBalancerIngress.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LoadBalancerIngress represents the status of a load-balancer ingress point: traffic intended for the service should be sent to an ingress point.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -64,42 +67,66 @@ public LoadBalancerIngress(String hostname, String ip, String ipMode, List<PortS
         this.ports = ports;
     }
 
+    /**
+     * Hostname is set for load-balancer ingress points that are DNS based (typically AWS load-balancers)
+     */
     @JsonProperty("hostname")
     public String getHostname() {
         return hostname;
     }
 
+    /**
+     * Hostname is set for load-balancer ingress points that are DNS based (typically AWS load-balancers)
+     */
     @JsonProperty("hostname")
     public void setHostname(String hostname) {
         this.hostname = hostname;
     }
 
+    /**
+     * IP is set for load-balancer ingress points that are IP based (typically GCE or OpenStack load-balancers)
+     */
     @JsonProperty("ip")
     public String getIp() {
         return ip;
     }
 
+    /**
+     * IP is set for load-balancer ingress points that are IP based (typically GCE or OpenStack load-balancers)
+     */
     @JsonProperty("ip")
     public void setIp(String ip) {
         this.ip = ip;
     }
 
+    /**
+     * IPMode specifies how the load-balancer IP behaves, and may only be specified when the ip field is specified. Setting this to "VIP" indicates that traffic is delivered to the node with the destination set to the load-balancer's IP and port. Setting this to "Proxy" indicates that traffic is delivered to the node or pod with the destination set to the node's IP and node port or the pod's IP and port. Service implementations may use this information to adjust traffic routing.
+     */
     @JsonProperty("ipMode")
     public String getIpMode() {
         return ipMode;
     }
 
+    /**
+     * IPMode specifies how the load-balancer IP behaves, and may only be specified when the ip field is specified. Setting this to "VIP" indicates that traffic is delivered to the node with the destination set to the load-balancer's IP and port. Setting this to "Proxy" indicates that traffic is delivered to the node or pod with the destination set to the node's IP and node port or the pod's IP and port. Service implementations may use this information to adjust traffic routing.
+     */
     @JsonProperty("ipMode")
     public void setIpMode(String ipMode) {
         this.ipMode = ipMode;
     }
 
+    /**
+     * Ports is a list of records of service ports If used, every port defined in the service should have an entry in it
+     */
     @JsonProperty("ports")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PortStatus> getPorts() {
         return ports;
     }
 
+    /**
+     * Ports is a list of records of service ports If used, every port defined in the service should have an entry in it
+     */
     @JsonProperty("ports")
     public void setPorts(List<PortStatus> ports) {
         this.ports = ports;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LoadBalancerStatus.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LoadBalancerStatus.java
index 8657635bcce..995b550cf50 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LoadBalancerStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LoadBalancerStatus.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LoadBalancerStatus represents the status of a load-balancer.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -52,12 +55,18 @@ public LoadBalancerStatus(List<LoadBalancerIngress> ingress) {
         this.ingress = ingress;
     }
 
+    /**
+     * Ingress is a list containing ingress points for the load-balancer. Traffic intended for the service should be sent to these ingress points.
+     */
     @JsonProperty("ingress")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LoadBalancerIngress> getIngress() {
         return ingress;
     }
 
+    /**
+     * Ingress is a list containing ingress points for the load-balancer. Traffic intended for the service should be sent to these ingress points.
+     */
     @JsonProperty("ingress")
     public void setIngress(List<LoadBalancerIngress> ingress) {
         this.ingress = ingress;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LocalObjectReference.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LocalObjectReference.java
index 93f60437f1b..d1cc5d9472c 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LocalObjectReference.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LocalObjectReference.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LocalObjectReference contains enough information to let you locate the referenced object inside the same namespace.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -49,11 +52,17 @@ public LocalObjectReference(String name) {
         this.name = name;
     }
 
+    /**
+     * Name of the referent. This field is effectively required, but due to backwards compatibility is allowed to be empty. Instances of this type with an empty value here are almost certainly wrong. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referent. This field is effectively required, but due to backwards compatibility is allowed to be empty. Instances of this type with an empty value here are almost certainly wrong. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LocalVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LocalVolumeSource.java
index 97e982bf526..7f663ff8e81 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LocalVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/LocalVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Local represents directly-attached storage with node affinity
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public LocalVolumeSource(String fsType, String path) {
         this.path = path;
     }
 
+    /**
+     * fsType is the filesystem type to mount. It applies only when the Path is a block device. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". The default value is to auto-select a filesystem if unspecified.
+     */
     @JsonProperty("fsType")
     public String getFsType() {
         return fsType;
     }
 
+    /**
+     * fsType is the filesystem type to mount. It applies only when the Path is a block device. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". The default value is to auto-select a filesystem if unspecified.
+     */
     @JsonProperty("fsType")
     public void setFsType(String fsType) {
         this.fsType = fsType;
     }
 
+    /**
+     * path of the full path to the volume on the node. It can be either a directory or block device (disk, partition, ...).
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * path of the full path to the volume on the node. It can be either a directory or block device (disk, partition, ...).
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ManagedFieldsEntry.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ManagedFieldsEntry.java
index 10e65d82ce0..6561cd66641 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ManagedFieldsEntry.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ManagedFieldsEntry.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -73,71 +76,113 @@ public ManagedFieldsEntry(String apiVersion, String fieldsType, FieldsV1 fieldsV
         this.time = time;
     }
 
+    /**
+     * APIVersion defines the version of this resource that this field set applies to. The format is "group/version" just like the top-level APIVersion field. It is necessary to track the version of a field set because it cannot be automatically converted.
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * APIVersion defines the version of this resource that this field set applies to. The format is "group/version" just like the top-level APIVersion field. It is necessary to track the version of a field set because it cannot be automatically converted.
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * FieldsType is the discriminator for the different fields format and version. There is currently only one possible value: "FieldsV1"
+     */
     @JsonProperty("fieldsType")
     public String getFieldsType() {
         return fieldsType;
     }
 
+    /**
+     * FieldsType is the discriminator for the different fields format and version. There is currently only one possible value: "FieldsV1"
+     */
     @JsonProperty("fieldsType")
     public void setFieldsType(String fieldsType) {
         this.fieldsType = fieldsType;
     }
 
+    /**
+     * ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.
+     */
     @JsonProperty("fieldsV1")
     public FieldsV1 getFieldsV1() {
         return fieldsV1;
     }
 
+    /**
+     * ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.
+     */
     @JsonProperty("fieldsV1")
     public void setFieldsV1(FieldsV1 fieldsV1) {
         this.fieldsV1 = fieldsV1;
     }
 
+    /**
+     * Manager is an identifier of the workflow managing these fields.
+     */
     @JsonProperty("manager")
     public String getManager() {
         return manager;
     }
 
+    /**
+     * Manager is an identifier of the workflow managing these fields.
+     */
     @JsonProperty("manager")
     public void setManager(String manager) {
         this.manager = manager;
     }
 
+    /**
+     * Operation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.
+     */
     @JsonProperty("operation")
     public String getOperation() {
         return operation;
     }
 
+    /**
+     * Operation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.
+     */
     @JsonProperty("operation")
     public void setOperation(String operation) {
         this.operation = operation;
     }
 
+    /**
+     * Subresource is the name of the subresource used to update that object, or empty string if the object was updated through the main resource. The value of this field is used to distinguish between managers, even if they share the same name. For example, a status update will be distinct from a regular update using the same manager name. Note that the APIVersion field is not related to the Subresource field and it always corresponds to the version of the main resource.
+     */
     @JsonProperty("subresource")
     public String getSubresource() {
         return subresource;
     }
 
+    /**
+     * Subresource is the name of the subresource used to update that object, or empty string if the object was updated through the main resource. The value of this field is used to distinguish between managers, even if they share the same name. For example, a status update will be distinct from a regular update using the same manager name. Note that the APIVersion field is not related to the Subresource field and it always corresponds to the version of the main resource.
+     */
     @JsonProperty("subresource")
     public void setSubresource(String subresource) {
         this.subresource = subresource;
     }
 
+    /**
+     * ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.
+     */
     @JsonProperty("time")
     public String getTime() {
         return time;
     }
 
+    /**
+     * ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.
+     */
     @JsonProperty("time")
     public void setTime(String time) {
         this.time = time;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ModifyVolumeStatus.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ModifyVolumeStatus.java
index aa653b07063..08c285c7015 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ModifyVolumeStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ModifyVolumeStatus.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ModifyVolumeStatus represents the status object of ControllerModifyVolume operation
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public ModifyVolumeStatus(String status, String targetVolumeAttributesClassName)
         this.targetVolumeAttributesClassName = targetVolumeAttributesClassName;
     }
 
+    /**
+     * status is the status of the ControllerModifyVolume operation. It can be in any of following states:<br><p>  - Pending<br><p>    Pending indicates that the PersistentVolumeClaim cannot be modified due to unmet requirements, such as<br><p>    the specified VolumeAttributesClass not existing.<br><p>  - InProgress<br><p>    InProgress indicates that the volume is being modified.<br><p>  - Infeasible<br><p>   Infeasible indicates that the request has been rejected as invalid by the CSI driver. To<br><p> 	  resolve the error, a valid VolumeAttributesClass needs to be specified.<br><p> Note: New statuses can be added in the future. Consumers should check for unknown statuses and fail appropriately.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * status is the status of the ControllerModifyVolume operation. It can be in any of following states:<br><p>  - Pending<br><p>    Pending indicates that the PersistentVolumeClaim cannot be modified due to unmet requirements, such as<br><p>    the specified VolumeAttributesClass not existing.<br><p>  - InProgress<br><p>    InProgress indicates that the volume is being modified.<br><p>  - Infeasible<br><p>   Infeasible indicates that the request has been rejected as invalid by the CSI driver. To<br><p> 	  resolve the error, a valid VolumeAttributesClass needs to be specified.<br><p> Note: New statuses can be added in the future. Consumers should check for unknown statuses and fail appropriately.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * targetVolumeAttributesClassName is the name of the VolumeAttributesClass the PVC currently being reconciled
+     */
     @JsonProperty("targetVolumeAttributesClassName")
     public String getTargetVolumeAttributesClassName() {
         return targetVolumeAttributesClassName;
     }
 
+    /**
+     * targetVolumeAttributesClassName is the name of the VolumeAttributesClass the PVC currently being reconciled
+     */
     @JsonProperty("targetVolumeAttributesClassName")
     public void setTargetVolumeAttributesClassName(String targetVolumeAttributesClassName) {
         this.targetVolumeAttributesClassName = targetVolumeAttributesClassName;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NFSVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NFSVolumeSource.java
index 0fb37f4ccba..6b08b596eb5 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NFSVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NFSVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Represents an NFS mount that lasts the lifetime of a pod. NFS volumes do not support ownership management or SELinux relabeling.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -57,31 +60,49 @@ public NFSVolumeSource(String path, Boolean readOnly, String server) {
         this.server = server;
     }
 
+    /**
+     * path that is exported by the NFS server. More info: https://kubernetes.io/docs/concepts/storage/volumes#nfs
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * path that is exported by the NFS server. More info: https://kubernetes.io/docs/concepts/storage/volumes#nfs
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * readOnly here will force the NFS export to be mounted with read-only permissions. Defaults to false. More info: https://kubernetes.io/docs/concepts/storage/volumes#nfs
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly here will force the NFS export to be mounted with read-only permissions. Defaults to false. More info: https://kubernetes.io/docs/concepts/storage/volumes#nfs
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * server is the hostname or IP address of the NFS server. More info: https://kubernetes.io/docs/concepts/storage/volumes#nfs
+     */
     @JsonProperty("server")
     public String getServer() {
         return server;
     }
 
+    /**
+     * server is the hostname or IP address of the NFS server. More info: https://kubernetes.io/docs/concepts/storage/volumes#nfs
+     */
     @JsonProperty("server")
     public void setServer(String server) {
         this.server = server;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Namespace.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Namespace.java
index 2e3ca3d0139..e88d24bf652 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Namespace.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Namespace.java
@@ -21,6 +21,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Namespace provides a scope for Names. Use of multiple namespaces is optional.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -46,14 +49,8 @@
 public class Namespace implements Editable<NamespaceBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Namespace";
     @JsonProperty("metadata")
@@ -81,7 +78,7 @@ public Namespace(String apiVersion, String kind, ObjectMeta metadata, NamespaceS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -89,7 +86,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -97,7 +94,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -105,38 +102,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Namespace provides a scope for Names. Use of multiple namespaces is optional.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Namespace provides a scope for Names. Use of multiple namespaces is optional.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Namespace provides a scope for Names. Use of multiple namespaces is optional.
+     */
     @JsonProperty("spec")
     public NamespaceSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Namespace provides a scope for Names. Use of multiple namespaces is optional.
+     */
     @JsonProperty("spec")
     public void setSpec(NamespaceSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Namespace provides a scope for Names. Use of multiple namespaces is optional.
+     */
     @JsonProperty("status")
     public NamespaceStatus getStatus() {
         return status;
     }
 
+    /**
+     * Namespace provides a scope for Names. Use of multiple namespaces is optional.
+     */
     @JsonProperty("status")
     public void setStatus(NamespaceStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NamespaceCondition.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NamespaceCondition.java
index f81da5ed295..23ebdd69d9e 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NamespaceCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NamespaceCondition.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NamespaceCondition contains details about state of namespace.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -65,51 +68,81 @@ public NamespaceCondition(String lastTransitionTime, String message, String reas
         this.type = type;
     }
 
+    /**
+     * NamespaceCondition contains details about state of namespace.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * NamespaceCondition contains details about state of namespace.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type of namespace controller condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of namespace controller condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NamespaceList.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NamespaceList.java
index 641d29c8a4f..2c9180ad5ba 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NamespaceList.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NamespaceList.java
@@ -23,6 +23,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NamespaceList is a list of Namespaces.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -47,17 +50,11 @@
 public class NamespaceList implements Editable<NamespaceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.Namespace>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.Namespace> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "NamespaceList";
     @JsonProperty("metadata")
@@ -80,7 +77,7 @@ public NamespaceList(String apiVersion, List<io.fabric8.kubernetes.api.model.Nam
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -88,26 +85,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of Namespace objects in the list. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.Namespace> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of Namespace objects in the list. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.Namespace> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -115,18 +118,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * NamespaceList is a list of Namespaces.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * NamespaceList is a list of Namespaces.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NamespaceSpec.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NamespaceSpec.java
index 0c3db2c06bd..bfd02473365 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NamespaceSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NamespaceSpec.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NamespaceSpec describes the attributes on a Namespace.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -52,12 +55,18 @@ public NamespaceSpec(List<String> finalizers) {
         this.finalizers = finalizers;
     }
 
+    /**
+     * Finalizers is an opaque list of values that must be empty to permanently remove object from storage. More info: https://kubernetes.io/docs/tasks/administer-cluster/namespaces/
+     */
     @JsonProperty("finalizers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getFinalizers() {
         return finalizers;
     }
 
+    /**
+     * Finalizers is an opaque list of values that must be empty to permanently remove object from storage. More info: https://kubernetes.io/docs/tasks/administer-cluster/namespaces/
+     */
     @JsonProperty("finalizers")
     public void setFinalizers(List<String> finalizers) {
         this.finalizers = finalizers;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NamespaceStatus.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NamespaceStatus.java
index a9b3e547080..032ea279bab 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NamespaceStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NamespaceStatus.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NamespaceStatus is information about the current status of a Namespace.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -56,22 +59,34 @@ public NamespaceStatus(List<NamespaceCondition> conditions, String phase) {
         this.phase = phase;
     }
 
+    /**
+     * Represents the latest available observations of a namespace's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NamespaceCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Represents the latest available observations of a namespace's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<NamespaceCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Phase is the current lifecycle phase of the namespace. More info: https://kubernetes.io/docs/tasks/administer-cluster/namespaces/
+     */
     @JsonProperty("phase")
     public String getPhase() {
         return phase;
     }
 
+    /**
+     * Phase is the current lifecycle phase of the namespace. More info: https://kubernetes.io/docs/tasks/administer-cluster/namespaces/
+     */
     @JsonProperty("phase")
     public void setPhase(String phase) {
         this.phase = phase;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Node.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Node.java
index f913cdf0a58..59b6b4b8476 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Node.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Node.java
@@ -21,6 +21,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Node is a worker node in Kubernetes. Each node will have a unique identifier in the cache (i.e. in etcd).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -46,14 +49,8 @@
 public class Node implements Editable<NodeBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Node";
     @JsonProperty("metadata")
@@ -81,7 +78,7 @@ public Node(String apiVersion, String kind, ObjectMeta metadata, NodeSpec spec,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -89,7 +86,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -97,7 +94,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -105,38 +102,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Node is a worker node in Kubernetes. Each node will have a unique identifier in the cache (i.e. in etcd).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Node is a worker node in Kubernetes. Each node will have a unique identifier in the cache (i.e. in etcd).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Node is a worker node in Kubernetes. Each node will have a unique identifier in the cache (i.e. in etcd).
+     */
     @JsonProperty("spec")
     public NodeSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Node is a worker node in Kubernetes. Each node will have a unique identifier in the cache (i.e. in etcd).
+     */
     @JsonProperty("spec")
     public void setSpec(NodeSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Node is a worker node in Kubernetes. Each node will have a unique identifier in the cache (i.e. in etcd).
+     */
     @JsonProperty("status")
     public NodeStatus getStatus() {
         return status;
     }
 
+    /**
+     * Node is a worker node in Kubernetes. Each node will have a unique identifier in the cache (i.e. in etcd).
+     */
     @JsonProperty("status")
     public void setStatus(NodeStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeAddress.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeAddress.java
index 9d766f619ad..12749e0fafb 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeAddress.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeAddress.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NodeAddress contains information for the node's address.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public NodeAddress(String address, String type) {
         this.type = type;
     }
 
+    /**
+     * The node address.
+     */
     @JsonProperty("address")
     public String getAddress() {
         return address;
     }
 
+    /**
+     * The node address.
+     */
     @JsonProperty("address")
     public void setAddress(String address) {
         this.address = address;
     }
 
+    /**
+     * Node address type, one of Hostname, ExternalIP or InternalIP.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Node address type, one of Hostname, ExternalIP or InternalIP.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeAffinity.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeAffinity.java
index 8e7b98a3f7f..2d5cf4aa1dc 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeAffinity.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeAffinity.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Node affinity is a group of node affinity scheduling rules.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -56,22 +59,34 @@ public NodeAffinity(List<PreferredSchedulingTerm> preferredDuringSchedulingIgnor
         this.requiredDuringSchedulingIgnoredDuringExecution = requiredDuringSchedulingIgnoredDuringExecution;
     }
 
+    /**
+     * The scheduler will prefer to schedule pods to nodes that satisfy the affinity expressions specified by this field, but it may choose a node that violates one or more of the expressions. The node that is most preferred is the one with the greatest sum of weights, i.e. for each node that meets all of the scheduling requirements (resource request, requiredDuringScheduling affinity expressions, etc.), compute a sum by iterating through the elements of this field and adding "weight" to the sum if the node matches the corresponding matchExpressions; the node(s) with the highest sum are the most preferred.
+     */
     @JsonProperty("preferredDuringSchedulingIgnoredDuringExecution")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PreferredSchedulingTerm> getPreferredDuringSchedulingIgnoredDuringExecution() {
         return preferredDuringSchedulingIgnoredDuringExecution;
     }
 
+    /**
+     * The scheduler will prefer to schedule pods to nodes that satisfy the affinity expressions specified by this field, but it may choose a node that violates one or more of the expressions. The node that is most preferred is the one with the greatest sum of weights, i.e. for each node that meets all of the scheduling requirements (resource request, requiredDuringScheduling affinity expressions, etc.), compute a sum by iterating through the elements of this field and adding "weight" to the sum if the node matches the corresponding matchExpressions; the node(s) with the highest sum are the most preferred.
+     */
     @JsonProperty("preferredDuringSchedulingIgnoredDuringExecution")
     public void setPreferredDuringSchedulingIgnoredDuringExecution(List<PreferredSchedulingTerm> preferredDuringSchedulingIgnoredDuringExecution) {
         this.preferredDuringSchedulingIgnoredDuringExecution = preferredDuringSchedulingIgnoredDuringExecution;
     }
 
+    /**
+     * Node affinity is a group of node affinity scheduling rules.
+     */
     @JsonProperty("requiredDuringSchedulingIgnoredDuringExecution")
     public NodeSelector getRequiredDuringSchedulingIgnoredDuringExecution() {
         return requiredDuringSchedulingIgnoredDuringExecution;
     }
 
+    /**
+     * Node affinity is a group of node affinity scheduling rules.
+     */
     @JsonProperty("requiredDuringSchedulingIgnoredDuringExecution")
     public void setRequiredDuringSchedulingIgnoredDuringExecution(NodeSelector requiredDuringSchedulingIgnoredDuringExecution) {
         this.requiredDuringSchedulingIgnoredDuringExecution = requiredDuringSchedulingIgnoredDuringExecution;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeCondition.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeCondition.java
index 72558babcb7..96a31ade834 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeCondition.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NodeCondition contains condition information for a node.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -69,61 +72,97 @@ public NodeCondition(String lastHeartbeatTime, String lastTransitionTime, String
         this.type = type;
     }
 
+    /**
+     * NodeCondition contains condition information for a node.
+     */
     @JsonProperty("lastHeartbeatTime")
     public String getLastHeartbeatTime() {
         return lastHeartbeatTime;
     }
 
+    /**
+     * NodeCondition contains condition information for a node.
+     */
     @JsonProperty("lastHeartbeatTime")
     public void setLastHeartbeatTime(String lastHeartbeatTime) {
         this.lastHeartbeatTime = lastHeartbeatTime;
     }
 
+    /**
+     * NodeCondition contains condition information for a node.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * NodeCondition contains condition information for a node.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Human readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Human readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * (brief) reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * (brief) reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type of node condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of node condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeConfigSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeConfigSource.java
index 43ac7985175..e7ae5c20554 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeConfigSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeConfigSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NodeConfigSource specifies a source of node configuration. Exactly one subfield (excluding metadata) must be non-nil. This API is deprecated since 1.22
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -49,11 +52,17 @@ public NodeConfigSource(ConfigMapNodeConfigSource configMap) {
         this.configMap = configMap;
     }
 
+    /**
+     * NodeConfigSource specifies a source of node configuration. Exactly one subfield (excluding metadata) must be non-nil. This API is deprecated since 1.22
+     */
     @JsonProperty("configMap")
     public ConfigMapNodeConfigSource getConfigMap() {
         return configMap;
     }
 
+    /**
+     * NodeConfigSource specifies a source of node configuration. Exactly one subfield (excluding metadata) must be non-nil. This API is deprecated since 1.22
+     */
     @JsonProperty("configMap")
     public void setConfigMap(ConfigMapNodeConfigSource configMap) {
         this.configMap = configMap;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeConfigStatus.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeConfigStatus.java
index 2253ccf3150..6ffea110407 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeConfigStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeConfigStatus.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NodeConfigStatus describes the status of the config assigned by Node.Spec.ConfigSource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -61,41 +64,65 @@ public NodeConfigStatus(NodeConfigSource active, NodeConfigSource assigned, Stri
         this.lastKnownGood = lastKnownGood;
     }
 
+    /**
+     * NodeConfigStatus describes the status of the config assigned by Node.Spec.ConfigSource.
+     */
     @JsonProperty("active")
     public NodeConfigSource getActive() {
         return active;
     }
 
+    /**
+     * NodeConfigStatus describes the status of the config assigned by Node.Spec.ConfigSource.
+     */
     @JsonProperty("active")
     public void setActive(NodeConfigSource active) {
         this.active = active;
     }
 
+    /**
+     * NodeConfigStatus describes the status of the config assigned by Node.Spec.ConfigSource.
+     */
     @JsonProperty("assigned")
     public NodeConfigSource getAssigned() {
         return assigned;
     }
 
+    /**
+     * NodeConfigStatus describes the status of the config assigned by Node.Spec.ConfigSource.
+     */
     @JsonProperty("assigned")
     public void setAssigned(NodeConfigSource assigned) {
         this.assigned = assigned;
     }
 
+    /**
+     * Error describes any problems reconciling the Spec.ConfigSource to the Active config. Errors may occur, for example, attempting to checkpoint Spec.ConfigSource to the local Assigned record, attempting to checkpoint the payload associated with Spec.ConfigSource, attempting to load or validate the Assigned config, etc. Errors may occur at different points while syncing config. Earlier errors (e.g. download or checkpointing errors) will not result in a rollback to LastKnownGood, and may resolve across Kubelet retries. Later errors (e.g. loading or validating a checkpointed config) will result in a rollback to LastKnownGood. In the latter case, it is usually possible to resolve the error by fixing the config assigned in Spec.ConfigSource. You can find additional information for debugging by searching the error message in the Kubelet log. Error is a human-readable description of the error state; machines can check whether or not Error is empty, but should not rely on the stability of the Error text across Kubelet versions.
+     */
     @JsonProperty("error")
     public String getError() {
         return error;
     }
 
+    /**
+     * Error describes any problems reconciling the Spec.ConfigSource to the Active config. Errors may occur, for example, attempting to checkpoint Spec.ConfigSource to the local Assigned record, attempting to checkpoint the payload associated with Spec.ConfigSource, attempting to load or validate the Assigned config, etc. Errors may occur at different points while syncing config. Earlier errors (e.g. download or checkpointing errors) will not result in a rollback to LastKnownGood, and may resolve across Kubelet retries. Later errors (e.g. loading or validating a checkpointed config) will result in a rollback to LastKnownGood. In the latter case, it is usually possible to resolve the error by fixing the config assigned in Spec.ConfigSource. You can find additional information for debugging by searching the error message in the Kubelet log. Error is a human-readable description of the error state; machines can check whether or not Error is empty, but should not rely on the stability of the Error text across Kubelet versions.
+     */
     @JsonProperty("error")
     public void setError(String error) {
         this.error = error;
     }
 
+    /**
+     * NodeConfigStatus describes the status of the config assigned by Node.Spec.ConfigSource.
+     */
     @JsonProperty("lastKnownGood")
     public NodeConfigSource getLastKnownGood() {
         return lastKnownGood;
     }
 
+    /**
+     * NodeConfigStatus describes the status of the config assigned by Node.Spec.ConfigSource.
+     */
     @JsonProperty("lastKnownGood")
     public void setLastKnownGood(NodeConfigSource lastKnownGood) {
         this.lastKnownGood = lastKnownGood;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeDaemonEndpoints.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeDaemonEndpoints.java
index 914f780fd9c..65bf02a169a 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeDaemonEndpoints.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeDaemonEndpoints.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NodeDaemonEndpoints lists ports opened by daemons running on the Node.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -49,11 +52,17 @@ public NodeDaemonEndpoints(DaemonEndpoint kubeletEndpoint) {
         this.kubeletEndpoint = kubeletEndpoint;
     }
 
+    /**
+     * NodeDaemonEndpoints lists ports opened by daemons running on the Node.
+     */
     @JsonProperty("kubeletEndpoint")
     public DaemonEndpoint getKubeletEndpoint() {
         return kubeletEndpoint;
     }
 
+    /**
+     * NodeDaemonEndpoints lists ports opened by daemons running on the Node.
+     */
     @JsonProperty("kubeletEndpoint")
     public void setKubeletEndpoint(DaemonEndpoint kubeletEndpoint) {
         this.kubeletEndpoint = kubeletEndpoint;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeFeatures.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeFeatures.java
index e0eb3a6d50d..5f1d2be46ae 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeFeatures.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeFeatures.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NodeFeatures describes the set of features implemented by the CRI implementation. The features contained in the NodeFeatures should depend only on the cri implementation independent of runtime handlers.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -49,11 +52,17 @@ public NodeFeatures(Boolean supplementalGroupsPolicy) {
         this.supplementalGroupsPolicy = supplementalGroupsPolicy;
     }
 
+    /**
+     * SupplementalGroupsPolicy is set to true if the runtime supports SupplementalGroupsPolicy and ContainerUser.
+     */
     @JsonProperty("supplementalGroupsPolicy")
     public Boolean getSupplementalGroupsPolicy() {
         return supplementalGroupsPolicy;
     }
 
+    /**
+     * SupplementalGroupsPolicy is set to true if the runtime supports SupplementalGroupsPolicy and ContainerUser.
+     */
     @JsonProperty("supplementalGroupsPolicy")
     public void setSupplementalGroupsPolicy(Boolean supplementalGroupsPolicy) {
         this.supplementalGroupsPolicy = supplementalGroupsPolicy;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeList.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeList.java
index b3172ecd6c0..a2f36acdbdf 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeList.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeList.java
@@ -23,6 +23,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NodeList is the whole list of all Nodes which have been registered with master.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -47,17 +50,11 @@
 public class NodeList implements Editable<NodeListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.Node>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.Node> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "NodeList";
     @JsonProperty("metadata")
@@ -80,7 +77,7 @@ public NodeList(String apiVersion, List<io.fabric8.kubernetes.api.model.Node> it
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -88,26 +85,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of nodes
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.Node> getItems() {
         return items;
     }
 
+    /**
+     * List of nodes
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.Node> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -115,18 +118,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * NodeList is the whole list of all Nodes which have been registered with master.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * NodeList is the whole list of all Nodes which have been registered with master.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeRuntimeHandler.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeRuntimeHandler.java
index c711562f12b..ed1d2baf9ed 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeRuntimeHandler.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeRuntimeHandler.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NodeRuntimeHandler is a set of runtime handler information.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public NodeRuntimeHandler(NodeRuntimeHandlerFeatures features, String name) {
         this.name = name;
     }
 
+    /**
+     * NodeRuntimeHandler is a set of runtime handler information.
+     */
     @JsonProperty("features")
     public NodeRuntimeHandlerFeatures getFeatures() {
         return features;
     }
 
+    /**
+     * NodeRuntimeHandler is a set of runtime handler information.
+     */
     @JsonProperty("features")
     public void setFeatures(NodeRuntimeHandlerFeatures features) {
         this.features = features;
     }
 
+    /**
+     * Runtime handler name. Empty for the default runtime handler.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Runtime handler name. Empty for the default runtime handler.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeRuntimeHandlerFeatures.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeRuntimeHandlerFeatures.java
index 22977d1e230..7f3f8edabd5 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeRuntimeHandlerFeatures.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeRuntimeHandlerFeatures.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NodeRuntimeHandlerFeatures is a set of features implemented by the runtime handler.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public NodeRuntimeHandlerFeatures(Boolean recursiveReadOnlyMounts, Boolean userN
         this.userNamespaces = userNamespaces;
     }
 
+    /**
+     * RecursiveReadOnlyMounts is set to true if the runtime handler supports RecursiveReadOnlyMounts.
+     */
     @JsonProperty("recursiveReadOnlyMounts")
     public Boolean getRecursiveReadOnlyMounts() {
         return recursiveReadOnlyMounts;
     }
 
+    /**
+     * RecursiveReadOnlyMounts is set to true if the runtime handler supports RecursiveReadOnlyMounts.
+     */
     @JsonProperty("recursiveReadOnlyMounts")
     public void setRecursiveReadOnlyMounts(Boolean recursiveReadOnlyMounts) {
         this.recursiveReadOnlyMounts = recursiveReadOnlyMounts;
     }
 
+    /**
+     * UserNamespaces is set to true if the runtime handler supports UserNamespaces, including for volumes.
+     */
     @JsonProperty("userNamespaces")
     public Boolean getUserNamespaces() {
         return userNamespaces;
     }
 
+    /**
+     * UserNamespaces is set to true if the runtime handler supports UserNamespaces, including for volumes.
+     */
     @JsonProperty("userNamespaces")
     public void setUserNamespaces(Boolean userNamespaces) {
         this.userNamespaces = userNamespaces;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeSelector.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeSelector.java
index c8bc41c73ca..4d7acdcbefa 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeSelector.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeSelector.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -52,12 +55,18 @@ public NodeSelector(List<NodeSelectorTerm> nodeSelectorTerms) {
         this.nodeSelectorTerms = nodeSelectorTerms;
     }
 
+    /**
+     * Required. A list of node selector terms. The terms are ORed.
+     */
     @JsonProperty("nodeSelectorTerms")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NodeSelectorTerm> getNodeSelectorTerms() {
         return nodeSelectorTerms;
     }
 
+    /**
+     * Required. A list of node selector terms. The terms are ORed.
+     */
     @JsonProperty("nodeSelectorTerms")
     public void setNodeSelectorTerms(List<NodeSelectorTerm> nodeSelectorTerms) {
         this.nodeSelectorTerms = nodeSelectorTerms;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeSelectorRequirement.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeSelectorRequirement.java
index 5db065c10cd..bc83ad5acf3 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeSelectorRequirement.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeSelectorRequirement.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -60,32 +63,50 @@ public NodeSelectorRequirement(String key, String operator, List<String> values)
         this.values = values;
     }
 
+    /**
+     * The label key that the selector applies to.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * The label key that the selector applies to.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.
+     */
     @JsonProperty("operator")
     public String getOperator() {
         return operator;
     }
 
+    /**
+     * Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.
+     */
     @JsonProperty("operator")
     public void setOperator(String operator) {
         this.operator = operator;
     }
 
+    /**
+     * An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.
+     */
     @JsonProperty("values")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getValues() {
         return values;
     }
 
+    /**
+     * An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.
+     */
     @JsonProperty("values")
     public void setValues(List<String> values) {
         this.values = values;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeSelectorTerm.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeSelectorTerm.java
index cbedb3e914a..a1f3e590a58 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeSelectorTerm.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeSelectorTerm.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -57,23 +60,35 @@ public NodeSelectorTerm(List<NodeSelectorRequirement> matchExpressions, List<Nod
         this.matchFields = matchFields;
     }
 
+    /**
+     * A list of node selector requirements by node's labels.
+     */
     @JsonProperty("matchExpressions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NodeSelectorRequirement> getMatchExpressions() {
         return matchExpressions;
     }
 
+    /**
+     * A list of node selector requirements by node's labels.
+     */
     @JsonProperty("matchExpressions")
     public void setMatchExpressions(List<NodeSelectorRequirement> matchExpressions) {
         this.matchExpressions = matchExpressions;
     }
 
+    /**
+     * A list of node selector requirements by node's fields.
+     */
     @JsonProperty("matchFields")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NodeSelectorRequirement> getMatchFields() {
         return matchFields;
     }
 
+    /**
+     * A list of node selector requirements by node's fields.
+     */
     @JsonProperty("matchFields")
     public void setMatchFields(List<NodeSelectorRequirement> matchFields) {
         this.matchFields = matchFields;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeSpec.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeSpec.java
index dbc9fff24a8..fe824618b79 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeSpec.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NodeSpec describes the attributes that a node is created with.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,73 +80,115 @@ public NodeSpec(NodeConfigSource configSource, String externalID, String podCIDR
         this.unschedulable = unschedulable;
     }
 
+    /**
+     * NodeSpec describes the attributes that a node is created with.
+     */
     @JsonProperty("configSource")
     public NodeConfigSource getConfigSource() {
         return configSource;
     }
 
+    /**
+     * NodeSpec describes the attributes that a node is created with.
+     */
     @JsonProperty("configSource")
     public void setConfigSource(NodeConfigSource configSource) {
         this.configSource = configSource;
     }
 
+    /**
+     * Deprecated. Not all kubelets will set this field. Remove field after 1.13. see: https://issues.k8s.io/61966
+     */
     @JsonProperty("externalID")
     public String getExternalID() {
         return externalID;
     }
 
+    /**
+     * Deprecated. Not all kubelets will set this field. Remove field after 1.13. see: https://issues.k8s.io/61966
+     */
     @JsonProperty("externalID")
     public void setExternalID(String externalID) {
         this.externalID = externalID;
     }
 
+    /**
+     * PodCIDR represents the pod IP range assigned to the node.
+     */
     @JsonProperty("podCIDR")
     public String getPodCIDR() {
         return podCIDR;
     }
 
+    /**
+     * PodCIDR represents the pod IP range assigned to the node.
+     */
     @JsonProperty("podCIDR")
     public void setPodCIDR(String podCIDR) {
         this.podCIDR = podCIDR;
     }
 
+    /**
+     * podCIDRs represents the IP ranges assigned to the node for usage by Pods on that node. If this field is specified, the 0th entry must match the podCIDR field. It may contain at most 1 value for each of IPv4 and IPv6.
+     */
     @JsonProperty("podCIDRs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPodCIDRs() {
         return podCIDRs;
     }
 
+    /**
+     * podCIDRs represents the IP ranges assigned to the node for usage by Pods on that node. If this field is specified, the 0th entry must match the podCIDR field. It may contain at most 1 value for each of IPv4 and IPv6.
+     */
     @JsonProperty("podCIDRs")
     public void setPodCIDRs(List<String> podCIDRs) {
         this.podCIDRs = podCIDRs;
     }
 
+    /**
+     * ID of the node assigned by the cloud provider in the format: &lt;ProviderName&gt;://&lt;ProviderSpecificNodeID&gt;
+     */
     @JsonProperty("providerID")
     public String getProviderID() {
         return providerID;
     }
 
+    /**
+     * ID of the node assigned by the cloud provider in the format: &lt;ProviderName&gt;://&lt;ProviderSpecificNodeID&gt;
+     */
     @JsonProperty("providerID")
     public void setProviderID(String providerID) {
         this.providerID = providerID;
     }
 
+    /**
+     * If specified, the node's taints.
+     */
     @JsonProperty("taints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Taint> getTaints() {
         return taints;
     }
 
+    /**
+     * If specified, the node's taints.
+     */
     @JsonProperty("taints")
     public void setTaints(List<Taint> taints) {
         this.taints = taints;
     }
 
+    /**
+     * Unschedulable controls node schedulability of new pods. By default, node is schedulable. More info: https://kubernetes.io/docs/concepts/nodes/node/#manual-node-administration
+     */
     @JsonProperty("unschedulable")
     public Boolean getUnschedulable() {
         return unschedulable;
     }
 
+    /**
+     * Unschedulable controls node schedulability of new pods. By default, node is schedulable. More info: https://kubernetes.io/docs/concepts/nodes/node/#manual-node-administration
+     */
     @JsonProperty("unschedulable")
     public void setUnschedulable(Boolean unschedulable) {
         this.unschedulable = unschedulable;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeStatus.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeStatus.java
index 67c0234528c..2e3e2ca8de9 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeStatus.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NodeStatus is information about the current status of a node.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -107,139 +110,217 @@ public NodeStatus(List<NodeAddress> addresses, Map<String, Quantity> allocatable
         this.volumesInUse = volumesInUse;
     }
 
+    /**
+     * List of addresses reachable to the node. Queried from cloud provider, if available. More info: https://kubernetes.io/docs/reference/node/node-status/#addresses Note: This field is declared as mergeable, but the merge key is not sufficiently unique, which can cause data corruption when it is merged. Callers should instead use a full-replacement patch. See https://pr.k8s.io/79391 for an example. Consumers should assume that addresses can change during the lifetime of a Node. However, there are some exceptions where this may not be possible, such as Pods that inherit a Node's address in its own status or consumers of the downward API (status.hostIP).
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NodeAddress> getAddresses() {
         return addresses;
     }
 
+    /**
+     * List of addresses reachable to the node. Queried from cloud provider, if available. More info: https://kubernetes.io/docs/reference/node/node-status/#addresses Note: This field is declared as mergeable, but the merge key is not sufficiently unique, which can cause data corruption when it is merged. Callers should instead use a full-replacement patch. See https://pr.k8s.io/79391 for an example. Consumers should assume that addresses can change during the lifetime of a Node. However, there are some exceptions where this may not be possible, such as Pods that inherit a Node's address in its own status or consumers of the downward API (status.hostIP).
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<NodeAddress> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * Allocatable represents the resources of a node that are available for scheduling. Defaults to Capacity.
+     */
     @JsonProperty("allocatable")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getAllocatable() {
         return allocatable;
     }
 
+    /**
+     * Allocatable represents the resources of a node that are available for scheduling. Defaults to Capacity.
+     */
     @JsonProperty("allocatable")
     public void setAllocatable(Map<String, Quantity> allocatable) {
         this.allocatable = allocatable;
     }
 
+    /**
+     * Capacity represents the total resources of a node. More info: https://kubernetes.io/docs/reference/node/node-status/#capacity
+     */
     @JsonProperty("capacity")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getCapacity() {
         return capacity;
     }
 
+    /**
+     * Capacity represents the total resources of a node. More info: https://kubernetes.io/docs/reference/node/node-status/#capacity
+     */
     @JsonProperty("capacity")
     public void setCapacity(Map<String, Quantity> capacity) {
         this.capacity = capacity;
     }
 
+    /**
+     * Conditions is an array of current observed node conditions. More info: https://kubernetes.io/docs/reference/node/node-status/#condition
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NodeCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions is an array of current observed node conditions. More info: https://kubernetes.io/docs/reference/node/node-status/#condition
+     */
     @JsonProperty("conditions")
     public void setConditions(List<NodeCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * NodeStatus is information about the current status of a node.
+     */
     @JsonProperty("config")
     public NodeConfigStatus getConfig() {
         return config;
     }
 
+    /**
+     * NodeStatus is information about the current status of a node.
+     */
     @JsonProperty("config")
     public void setConfig(NodeConfigStatus config) {
         this.config = config;
     }
 
+    /**
+     * NodeStatus is information about the current status of a node.
+     */
     @JsonProperty("daemonEndpoints")
     public NodeDaemonEndpoints getDaemonEndpoints() {
         return daemonEndpoints;
     }
 
+    /**
+     * NodeStatus is information about the current status of a node.
+     */
     @JsonProperty("daemonEndpoints")
     public void setDaemonEndpoints(NodeDaemonEndpoints daemonEndpoints) {
         this.daemonEndpoints = daemonEndpoints;
     }
 
+    /**
+     * NodeStatus is information about the current status of a node.
+     */
     @JsonProperty("features")
     public NodeFeatures getFeatures() {
         return features;
     }
 
+    /**
+     * NodeStatus is information about the current status of a node.
+     */
     @JsonProperty("features")
     public void setFeatures(NodeFeatures features) {
         this.features = features;
     }
 
+    /**
+     * List of container images on this node
+     */
     @JsonProperty("images")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ContainerImage> getImages() {
         return images;
     }
 
+    /**
+     * List of container images on this node
+     */
     @JsonProperty("images")
     public void setImages(List<ContainerImage> images) {
         this.images = images;
     }
 
+    /**
+     * NodeStatus is information about the current status of a node.
+     */
     @JsonProperty("nodeInfo")
     public NodeSystemInfo getNodeInfo() {
         return nodeInfo;
     }
 
+    /**
+     * NodeStatus is information about the current status of a node.
+     */
     @JsonProperty("nodeInfo")
     public void setNodeInfo(NodeSystemInfo nodeInfo) {
         this.nodeInfo = nodeInfo;
     }
 
+    /**
+     * NodePhase is the recently observed lifecycle phase of the node. More info: https://kubernetes.io/docs/concepts/nodes/node/#phase The field is never populated, and now is deprecated.
+     */
     @JsonProperty("phase")
     public String getPhase() {
         return phase;
     }
 
+    /**
+     * NodePhase is the recently observed lifecycle phase of the node. More info: https://kubernetes.io/docs/concepts/nodes/node/#phase The field is never populated, and now is deprecated.
+     */
     @JsonProperty("phase")
     public void setPhase(String phase) {
         this.phase = phase;
     }
 
+    /**
+     * The available runtime handlers.
+     */
     @JsonProperty("runtimeHandlers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NodeRuntimeHandler> getRuntimeHandlers() {
         return runtimeHandlers;
     }
 
+    /**
+     * The available runtime handlers.
+     */
     @JsonProperty("runtimeHandlers")
     public void setRuntimeHandlers(List<NodeRuntimeHandler> runtimeHandlers) {
         this.runtimeHandlers = runtimeHandlers;
     }
 
+    /**
+     * List of volumes that are attached to the node.
+     */
     @JsonProperty("volumesAttached")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AttachedVolume> getVolumesAttached() {
         return volumesAttached;
     }
 
+    /**
+     * List of volumes that are attached to the node.
+     */
     @JsonProperty("volumesAttached")
     public void setVolumesAttached(List<AttachedVolume> volumesAttached) {
         this.volumesAttached = volumesAttached;
     }
 
+    /**
+     * List of attachable volumes in use (mounted) by the node.
+     */
     @JsonProperty("volumesInUse")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getVolumesInUse() {
         return volumesInUse;
     }
 
+    /**
+     * List of attachable volumes in use (mounted) by the node.
+     */
     @JsonProperty("volumesInUse")
     public void setVolumesInUse(List<String> volumesInUse) {
         this.volumesInUse = volumesInUse;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeSystemInfo.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeSystemInfo.java
index cbf67faa538..74dabf9f869 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeSystemInfo.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/NodeSystemInfo.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NodeSystemInfo is a set of ids/uuids to uniquely identify the node.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,101 +88,161 @@ public NodeSystemInfo(String architecture, String bootID, String containerRuntim
         this.systemUUID = systemUUID;
     }
 
+    /**
+     * The Architecture reported by the node
+     */
     @JsonProperty("architecture")
     public String getArchitecture() {
         return architecture;
     }
 
+    /**
+     * The Architecture reported by the node
+     */
     @JsonProperty("architecture")
     public void setArchitecture(String architecture) {
         this.architecture = architecture;
     }
 
+    /**
+     * Boot ID reported by the node.
+     */
     @JsonProperty("bootID")
     public String getBootID() {
         return bootID;
     }
 
+    /**
+     * Boot ID reported by the node.
+     */
     @JsonProperty("bootID")
     public void setBootID(String bootID) {
         this.bootID = bootID;
     }
 
+    /**
+     * ContainerRuntime Version reported by the node through runtime remote API (e.g. containerd://1.4.2).
+     */
     @JsonProperty("containerRuntimeVersion")
     public String getContainerRuntimeVersion() {
         return containerRuntimeVersion;
     }
 
+    /**
+     * ContainerRuntime Version reported by the node through runtime remote API (e.g. containerd://1.4.2).
+     */
     @JsonProperty("containerRuntimeVersion")
     public void setContainerRuntimeVersion(String containerRuntimeVersion) {
         this.containerRuntimeVersion = containerRuntimeVersion;
     }
 
+    /**
+     * Kernel Version reported by the node from 'uname -r' (e.g. 3.16.0-0.bpo.4-amd64).
+     */
     @JsonProperty("kernelVersion")
     public String getKernelVersion() {
         return kernelVersion;
     }
 
+    /**
+     * Kernel Version reported by the node from 'uname -r' (e.g. 3.16.0-0.bpo.4-amd64).
+     */
     @JsonProperty("kernelVersion")
     public void setKernelVersion(String kernelVersion) {
         this.kernelVersion = kernelVersion;
     }
 
+    /**
+     * Deprecated: KubeProxy Version reported by the node.
+     */
     @JsonProperty("kubeProxyVersion")
     public String getKubeProxyVersion() {
         return kubeProxyVersion;
     }
 
+    /**
+     * Deprecated: KubeProxy Version reported by the node.
+     */
     @JsonProperty("kubeProxyVersion")
     public void setKubeProxyVersion(String kubeProxyVersion) {
         this.kubeProxyVersion = kubeProxyVersion;
     }
 
+    /**
+     * Kubelet Version reported by the node.
+     */
     @JsonProperty("kubeletVersion")
     public String getKubeletVersion() {
         return kubeletVersion;
     }
 
+    /**
+     * Kubelet Version reported by the node.
+     */
     @JsonProperty("kubeletVersion")
     public void setKubeletVersion(String kubeletVersion) {
         this.kubeletVersion = kubeletVersion;
     }
 
+    /**
+     * MachineID reported by the node. For unique machine identification in the cluster this field is preferred. Learn more from man(5) machine-id: http://man7.org/linux/man-pages/man5/machine-id.5.html
+     */
     @JsonProperty("machineID")
     public String getMachineID() {
         return machineID;
     }
 
+    /**
+     * MachineID reported by the node. For unique machine identification in the cluster this field is preferred. Learn more from man(5) machine-id: http://man7.org/linux/man-pages/man5/machine-id.5.html
+     */
     @JsonProperty("machineID")
     public void setMachineID(String machineID) {
         this.machineID = machineID;
     }
 
+    /**
+     * The Operating System reported by the node
+     */
     @JsonProperty("operatingSystem")
     public String getOperatingSystem() {
         return operatingSystem;
     }
 
+    /**
+     * The Operating System reported by the node
+     */
     @JsonProperty("operatingSystem")
     public void setOperatingSystem(String operatingSystem) {
         this.operatingSystem = operatingSystem;
     }
 
+    /**
+     * OS Image reported by the node from /etc/os-release (e.g. Debian GNU/Linux 7 (wheezy)).
+     */
     @JsonProperty("osImage")
     public String getOsImage() {
         return osImage;
     }
 
+    /**
+     * OS Image reported by the node from /etc/os-release (e.g. Debian GNU/Linux 7 (wheezy)).
+     */
     @JsonProperty("osImage")
     public void setOsImage(String osImage) {
         this.osImage = osImage;
     }
 
+    /**
+     * SystemUUID reported by the node. For unique machine identification MachineID is preferred. This field is specific to Red Hat hosts https://access.redhat.com/documentation/en-us/red_hat_subscription_management/1/html/rhsm/uuid
+     */
     @JsonProperty("systemUUID")
     public String getSystemUUID() {
         return systemUUID;
     }
 
+    /**
+     * SystemUUID reported by the node. For unique machine identification MachineID is preferred. This field is specific to Red Hat hosts https://access.redhat.com/documentation/en-us/red_hat_subscription_management/1/html/rhsm/uuid
+     */
     @JsonProperty("systemUUID")
     public void setSystemUUID(String systemUUID) {
         this.systemUUID = systemUUID;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ObjectFieldSelector.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ObjectFieldSelector.java
index bcdd8990aab..0d23d742998 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ObjectFieldSelector.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ObjectFieldSelector.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ObjectFieldSelector selects an APIVersioned field of an object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public ObjectFieldSelector(String apiVersion, String fieldPath) {
         this.fieldPath = fieldPath;
     }
 
+    /**
+     * Version of the schema the FieldPath is written in terms of, defaults to "v1".
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * Version of the schema the FieldPath is written in terms of, defaults to "v1".
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Path of the field to select in the specified API version.
+     */
     @JsonProperty("fieldPath")
     public String getFieldPath() {
         return fieldPath;
     }
 
+    /**
+     * Path of the field to select in the specified API version.
+     */
     @JsonProperty("fieldPath")
     public void setFieldPath(String fieldPath) {
         this.fieldPath = fieldPath;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ObjectMeta.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ObjectMeta.java
index b6d8ffdd502..709b85d5363 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ObjectMeta.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ObjectMeta.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -112,156 +115,246 @@ public ObjectMeta(Map<String, String> annotations, String creationTimestamp, Lon
         this.uid = uid;
     }
 
+    /**
+     * Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.
+     */
     @JsonProperty("creationTimestamp")
     public String getCreationTimestamp() {
         return creationTimestamp;
     }
 
+    /**
+     * ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.
+     */
     @JsonProperty("creationTimestamp")
     public void setCreationTimestamp(String creationTimestamp) {
         this.creationTimestamp = creationTimestamp;
     }
 
+    /**
+     * Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.
+     */
     @JsonProperty("deletionGracePeriodSeconds")
     public Long getDeletionGracePeriodSeconds() {
         return deletionGracePeriodSeconds;
     }
 
+    /**
+     * Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.
+     */
     @JsonProperty("deletionGracePeriodSeconds")
     public void setDeletionGracePeriodSeconds(Long deletionGracePeriodSeconds) {
         this.deletionGracePeriodSeconds = deletionGracePeriodSeconds;
     }
 
+    /**
+     * ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.
+     */
     @JsonProperty("deletionTimestamp")
     public String getDeletionTimestamp() {
         return deletionTimestamp;
     }
 
+    /**
+     * ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.
+     */
     @JsonProperty("deletionTimestamp")
     public void setDeletionTimestamp(String deletionTimestamp) {
         this.deletionTimestamp = deletionTimestamp;
     }
 
+    /**
+     * Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order.  Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list.
+     */
     @JsonProperty("finalizers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getFinalizers() {
         return finalizers;
     }
 
+    /**
+     * Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order.  Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list.
+     */
     @JsonProperty("finalizers")
     public void setFinalizers(List<String> finalizers) {
         this.finalizers = finalizers;
     }
 
+    /**
+     * GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.<br><p> <br><p> If this field is specified and the generated name exists, the server will return a 409.<br><p> <br><p> Applied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency
+     */
     @JsonProperty("generateName")
     public String getGenerateName() {
         return generateName;
     }
 
+    /**
+     * GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.<br><p> <br><p> If this field is specified and the generated name exists, the server will return a 409.<br><p> <br><p> Applied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency
+     */
     @JsonProperty("generateName")
     public void setGenerateName(String generateName) {
         this.generateName = generateName;
     }
 
+    /**
+     * A sequence number representing a specific generation of the desired state. Populated by the system. Read-only.
+     */
     @JsonProperty("generation")
     public Long getGeneration() {
         return generation;
     }
 
+    /**
+     * A sequence number representing a specific generation of the desired state. Populated by the system. Read-only.
+     */
     @JsonProperty("generation")
     public void setGeneration(Long generation) {
         this.generation = generation;
     }
 
+    /**
+     * Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabels() {
         return labels;
     }
 
+    /**
+     * Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels
+     */
     @JsonProperty("labels")
     public void setLabels(Map<String, String> labels) {
         this.labels = labels;
     }
 
+    /**
+     * ManagedFields maps workflow-id and version to the set of fields that are managed by that workflow. This is mostly for internal housekeeping, and users typically shouldn't need to set or understand this field. A workflow can be the user's name, a controller's name, or the name of a specific apply path like "ci-cd". The set of fields is always in the version that the workflow used when modifying the object.
+     */
     @JsonProperty("managedFields")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ManagedFieldsEntry> getManagedFields() {
         return managedFields;
     }
 
+    /**
+     * ManagedFields maps workflow-id and version to the set of fields that are managed by that workflow. This is mostly for internal housekeeping, and users typically shouldn't need to set or understand this field. A workflow can be the user's name, a controller's name, or the name of a specific apply path like "ci-cd". The set of fields is always in the version that the workflow used when modifying the object.
+     */
     @JsonProperty("managedFields")
     public void setManagedFields(List<ManagedFieldsEntry> managedFields) {
         this.managedFields = managedFields;
     }
 
+    /**
+     * Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the "default" namespace, but "default" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.<br><p> <br><p> Must be a DNS_LABEL. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the "default" namespace, but "default" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.<br><p> <br><p> Must be a DNS_LABEL. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.
+     */
     @JsonProperty("ownerReferences")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OwnerReference> getOwnerReferences() {
         return ownerReferences;
     }
 
+    /**
+     * List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.
+     */
     @JsonProperty("ownerReferences")
     public void setOwnerReferences(List<OwnerReference> ownerReferences) {
         this.ownerReferences = ownerReferences;
     }
 
+    /**
+     * An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.<br><p> <br><p> Populated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency
+     */
     @JsonProperty("resourceVersion")
     public String getResourceVersion() {
         return resourceVersion;
     }
 
+    /**
+     * An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.<br><p> <br><p> Populated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency
+     */
     @JsonProperty("resourceVersion")
     public void setResourceVersion(String resourceVersion) {
         this.resourceVersion = resourceVersion;
     }
 
+    /**
+     * Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.
+     */
     @JsonProperty("selfLink")
     public String getSelfLink() {
         return selfLink;
     }
 
+    /**
+     * Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.
+     */
     @JsonProperty("selfLink")
     public void setSelfLink(String selfLink) {
         this.selfLink = selfLink;
     }
 
+    /**
+     * UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.<br><p> <br><p> Populated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids
+     */
     @JsonProperty("uid")
     public String getUid() {
         return uid;
     }
 
+    /**
+     * UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.<br><p> <br><p> Populated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids
+     */
     @JsonProperty("uid")
     public void setUid(String uid) {
         this.uid = uid;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ObjectReference.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ObjectReference.java
index 4e9452eaa3d..c2d5ff10328 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ObjectReference.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ObjectReference.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ObjectReference contains enough information to let you inspect or modify the referred object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -73,71 +76,113 @@ public ObjectReference(String apiVersion, String fieldPath, String kind, String
         this.uid = uid;
     }
 
+    /**
+     * API version of the referent.
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * API version of the referent.
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * If referring to a piece of an object instead of an entire object, this string should contain a valid JSON/Go field access statement, such as desiredState.manifest.containers[2]. For example, if the object reference is to a container within a pod, this would take on a value like: "spec.containers{name}" (where "name" refers to the name of the container that triggered the event) or if no container name is specified "spec.containers[2]" (container with index 2 in this pod). This syntax is chosen only to have some well-defined way of referencing a part of an object.
+     */
     @JsonProperty("fieldPath")
     public String getFieldPath() {
         return fieldPath;
     }
 
+    /**
+     * If referring to a piece of an object instead of an entire object, this string should contain a valid JSON/Go field access statement, such as desiredState.manifest.containers[2]. For example, if the object reference is to a container within a pod, this would take on a value like: "spec.containers{name}" (where "name" refers to the name of the container that triggered the event) or if no container name is specified "spec.containers[2]" (container with index 2 in this pod). This syntax is chosen only to have some well-defined way of referencing a part of an object.
+     */
     @JsonProperty("fieldPath")
     public void setFieldPath(String fieldPath) {
         this.fieldPath = fieldPath;
     }
 
+    /**
+     * Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Specific resourceVersion to which this reference is made, if any. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency
+     */
     @JsonProperty("resourceVersion")
     public String getResourceVersion() {
         return resourceVersion;
     }
 
+    /**
+     * Specific resourceVersion to which this reference is made, if any. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency
+     */
     @JsonProperty("resourceVersion")
     public void setResourceVersion(String resourceVersion) {
         this.resourceVersion = resourceVersion;
     }
 
+    /**
+     * UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids
+     */
     @JsonProperty("uid")
     public String getUid() {
         return uid;
     }
 
+    /**
+     * UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids
+     */
     @JsonProperty("uid")
     public void setUid(String uid) {
         this.uid = uid;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/OwnerReference.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/OwnerReference.java
index 669d6723e48..630e88cd550 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/OwnerReference.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/OwnerReference.java
@@ -21,6 +21,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OwnerReference contains enough information to let you identify an owning object. An owning object must be in the same namespace as the dependent, or be cluster-scoped, so there is no namespace field.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -47,18 +50,12 @@
 public class OwnerReference implements Editable<OwnerReferenceBuilder>, KubernetesResource
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("blockOwnerDeletion")
     private Boolean blockOwnerDeletion;
     @JsonProperty("controller")
     private Boolean controller;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OwnerReference";
     @JsonProperty("name")
@@ -85,7 +82,7 @@ public OwnerReference(String apiVersion, Boolean blockOwnerDeletion, Boolean con
     }
 
     /**
-     * (Required)
+     * API version of the referent.
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -93,35 +90,47 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * API version of the referent.
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * If true, AND if the owner has the "foregroundDeletion" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. See https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion for how the garbage collector interacts with this field and enforces the foreground deletion. Defaults to false. To set this field, a user needs "delete" permission of the owner, otherwise 422 (Unprocessable Entity) will be returned.
+     */
     @JsonProperty("blockOwnerDeletion")
     public Boolean getBlockOwnerDeletion() {
         return blockOwnerDeletion;
     }
 
+    /**
+     * If true, AND if the owner has the "foregroundDeletion" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. See https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion for how the garbage collector interacts with this field and enforces the foreground deletion. Defaults to false. To set this field, a user needs "delete" permission of the owner, otherwise 422 (Unprocessable Entity) will be returned.
+     */
     @JsonProperty("blockOwnerDeletion")
     public void setBlockOwnerDeletion(Boolean blockOwnerDeletion) {
         this.blockOwnerDeletion = blockOwnerDeletion;
     }
 
+    /**
+     * If true, this reference points to the managing controller.
+     */
     @JsonProperty("controller")
     public Boolean getController() {
         return controller;
     }
 
+    /**
+     * If true, this reference points to the managing controller.
+     */
     @JsonProperty("controller")
     public void setController(Boolean controller) {
         this.controller = controller;
     }
 
     /**
-     * (Required)
+     * Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -129,28 +138,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids
+     */
     @JsonProperty("uid")
     public String getUid() {
         return uid;
     }
 
+    /**
+     * UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids
+     */
     @JsonProperty("uid")
     public void setUid(String uid) {
         this.uid = uid;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Patch.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Patch.java
index 199c161ccce..e4dc075f9c3 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Patch.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Patch.java
@@ -16,6 +16,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Patch is provided to give a concrete name and type to the Kubernetes PATCH request body.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PatchOptions.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PatchOptions.java
index af232adc8eb..abe3751ab01 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PatchOptions.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PatchOptions.java
@@ -49,9 +49,6 @@
 public class PatchOptions implements Editable<PatchOptionsBuilder>, KubernetesResource
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("dryRun")
@@ -63,9 +60,6 @@ public class PatchOptions implements Editable<PatchOptionsBuilder>, KubernetesRe
     private String fieldValidation;
     @JsonProperty("force")
     private Boolean force;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PatchOptions";
     @JsonIgnore
@@ -87,17 +81,11 @@ public PatchOptions(String apiVersion, List<String> dryRun, String fieldManager,
         this.kind = kind;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
@@ -144,17 +132,11 @@ public void setForce(Boolean force) {
         this.force = force;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolume.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolume.java
index 10740bea342..a7813222fd5 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolume.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolume.java
@@ -21,6 +21,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PersistentVolume (PV) is a storage resource provisioned by an administrator. It is analogous to a node. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -46,14 +49,8 @@
 public class PersistentVolume implements Editable<PersistentVolumeBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PersistentVolume";
     @JsonProperty("metadata")
@@ -81,7 +78,7 @@ public PersistentVolume(String apiVersion, String kind, ObjectMeta metadata, Per
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -89,7 +86,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -97,7 +94,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -105,38 +102,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PersistentVolume (PV) is a storage resource provisioned by an administrator. It is analogous to a node. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PersistentVolume (PV) is a storage resource provisioned by an administrator. It is analogous to a node. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PersistentVolume (PV) is a storage resource provisioned by an administrator. It is analogous to a node. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes
+     */
     @JsonProperty("spec")
     public PersistentVolumeSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PersistentVolume (PV) is a storage resource provisioned by an administrator. It is analogous to a node. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes
+     */
     @JsonProperty("spec")
     public void setSpec(PersistentVolumeSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PersistentVolume (PV) is a storage resource provisioned by an administrator. It is analogous to a node. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes
+     */
     @JsonProperty("status")
     public PersistentVolumeStatus getStatus() {
         return status;
     }
 
+    /**
+     * PersistentVolume (PV) is a storage resource provisioned by an administrator. It is analogous to a node. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes
+     */
     @JsonProperty("status")
     public void setStatus(PersistentVolumeStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeClaim.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeClaim.java
index 30b65ec2626..b4dc9818086 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeClaim.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeClaim.java
@@ -21,6 +21,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PersistentVolumeClaim is a user's request for and claim to a persistent volume
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -46,14 +49,8 @@
 public class PersistentVolumeClaim implements Editable<PersistentVolumeClaimBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PersistentVolumeClaim";
     @JsonProperty("metadata")
@@ -81,7 +78,7 @@ public PersistentVolumeClaim(String apiVersion, String kind, ObjectMeta metadata
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -89,7 +86,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -97,7 +94,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -105,38 +102,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PersistentVolumeClaim is a user's request for and claim to a persistent volume
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PersistentVolumeClaim is a user's request for and claim to a persistent volume
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PersistentVolumeClaim is a user's request for and claim to a persistent volume
+     */
     @JsonProperty("spec")
     public PersistentVolumeClaimSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PersistentVolumeClaim is a user's request for and claim to a persistent volume
+     */
     @JsonProperty("spec")
     public void setSpec(PersistentVolumeClaimSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PersistentVolumeClaim is a user's request for and claim to a persistent volume
+     */
     @JsonProperty("status")
     public PersistentVolumeClaimStatus getStatus() {
         return status;
     }
 
+    /**
+     * PersistentVolumeClaim is a user's request for and claim to a persistent volume
+     */
     @JsonProperty("status")
     public void setStatus(PersistentVolumeClaimStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeClaimCondition.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeClaimCondition.java
index 21b6f7c278d..afaf0fe7e51 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeClaimCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeClaimCondition.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PersistentVolumeClaimCondition contains details about state of pvc
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -69,61 +72,97 @@ public PersistentVolumeClaimCondition(String lastProbeTime, String lastTransitio
         this.type = type;
     }
 
+    /**
+     * PersistentVolumeClaimCondition contains details about state of pvc
+     */
     @JsonProperty("lastProbeTime")
     public String getLastProbeTime() {
         return lastProbeTime;
     }
 
+    /**
+     * PersistentVolumeClaimCondition contains details about state of pvc
+     */
     @JsonProperty("lastProbeTime")
     public void setLastProbeTime(String lastProbeTime) {
         this.lastProbeTime = lastProbeTime;
     }
 
+    /**
+     * PersistentVolumeClaimCondition contains details about state of pvc
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * PersistentVolumeClaimCondition contains details about state of pvc
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * message is the human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message is the human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * reason is a unique, this should be a short, machine understandable string that gives the reason for condition's last transition. If it reports "Resizing" that means the underlying persistent volume is being resized.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * reason is a unique, this should be a short, machine understandable string that gives the reason for condition's last transition. If it reports "Resizing" that means the underlying persistent volume is being resized.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status is the status of the condition. Can be True, False, Unknown. More info: https://kubernetes.io/docs/reference/kubernetes-api/config-and-storage-resources/persistent-volume-claim-v1/#:~:text=state%20of%20pvc-,conditions.status,-(string)%2C%20required
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status is the status of the condition. Can be True, False, Unknown. More info: https://kubernetes.io/docs/reference/kubernetes-api/config-and-storage-resources/persistent-volume-claim-v1/#:~:text=state%20of%20pvc-,conditions.status,-(string)%2C%20required
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type is the type of the condition. More info: https://kubernetes.io/docs/reference/kubernetes-api/config-and-storage-resources/persistent-volume-claim-v1/#:~:text=set%20to%20%27ResizeStarted%27.-,PersistentVolumeClaimCondition,-contains%20details%20about
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of the condition. More info: https://kubernetes.io/docs/reference/kubernetes-api/config-and-storage-resources/persistent-volume-claim-v1/#:~:text=set%20to%20%27ResizeStarted%27.-,PersistentVolumeClaimCondition,-contains%20details%20about
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeClaimList.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeClaimList.java
index f227c69372d..30fe4be3c5b 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeClaimList.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeClaimList.java
@@ -23,6 +23,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PersistentVolumeClaimList is a list of PersistentVolumeClaim items.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -47,17 +50,11 @@
 public class PersistentVolumeClaimList implements Editable<PersistentVolumeClaimListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.PersistentVolumeClaim>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.PersistentVolumeClaim> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PersistentVolumeClaimList";
     @JsonProperty("metadata")
@@ -80,7 +77,7 @@ public PersistentVolumeClaimList(String apiVersion, List<io.fabric8.kubernetes.a
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -88,26 +85,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is a list of persistent volume claims. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.PersistentVolumeClaim> getItems() {
         return items;
     }
 
+    /**
+     * items is a list of persistent volume claims. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.PersistentVolumeClaim> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -115,18 +118,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PersistentVolumeClaimList is a list of PersistentVolumeClaim items.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PersistentVolumeClaimList is a list of PersistentVolumeClaim items.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeClaimSpec.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeClaimSpec.java
index e2f4da24148..73fab422cb3 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeClaimSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeClaimSpec.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PersistentVolumeClaimSpec describes the common attributes of storage devices and allows a Source for provider-specific attributes
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -84,92 +87,146 @@ public PersistentVolumeClaimSpec(List<String> accessModes, TypedLocalObjectRefer
         this.volumeName = volumeName;
     }
 
+    /**
+     * accessModes contains the desired access modes the volume should have. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1
+     */
     @JsonProperty("accessModes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAccessModes() {
         return accessModes;
     }
 
+    /**
+     * accessModes contains the desired access modes the volume should have. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1
+     */
     @JsonProperty("accessModes")
     public void setAccessModes(List<String> accessModes) {
         this.accessModes = accessModes;
     }
 
+    /**
+     * PersistentVolumeClaimSpec describes the common attributes of storage devices and allows a Source for provider-specific attributes
+     */
     @JsonProperty("dataSource")
     public TypedLocalObjectReference getDataSource() {
         return dataSource;
     }
 
+    /**
+     * PersistentVolumeClaimSpec describes the common attributes of storage devices and allows a Source for provider-specific attributes
+     */
     @JsonProperty("dataSource")
     public void setDataSource(TypedLocalObjectReference dataSource) {
         this.dataSource = dataSource;
     }
 
+    /**
+     * PersistentVolumeClaimSpec describes the common attributes of storage devices and allows a Source for provider-specific attributes
+     */
     @JsonProperty("dataSourceRef")
     public TypedObjectReference getDataSourceRef() {
         return dataSourceRef;
     }
 
+    /**
+     * PersistentVolumeClaimSpec describes the common attributes of storage devices and allows a Source for provider-specific attributes
+     */
     @JsonProperty("dataSourceRef")
     public void setDataSourceRef(TypedObjectReference dataSourceRef) {
         this.dataSourceRef = dataSourceRef;
     }
 
+    /**
+     * PersistentVolumeClaimSpec describes the common attributes of storage devices and allows a Source for provider-specific attributes
+     */
     @JsonProperty("resources")
     public VolumeResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * PersistentVolumeClaimSpec describes the common attributes of storage devices and allows a Source for provider-specific attributes
+     */
     @JsonProperty("resources")
     public void setResources(VolumeResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * PersistentVolumeClaimSpec describes the common attributes of storage devices and allows a Source for provider-specific attributes
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * PersistentVolumeClaimSpec describes the common attributes of storage devices and allows a Source for provider-specific attributes
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * storageClassName is the name of the StorageClass required by the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1
+     */
     @JsonProperty("storageClassName")
     public String getStorageClassName() {
         return storageClassName;
     }
 
+    /**
+     * storageClassName is the name of the StorageClass required by the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1
+     */
     @JsonProperty("storageClassName")
     public void setStorageClassName(String storageClassName) {
         this.storageClassName = storageClassName;
     }
 
+    /**
+     * volumeAttributesClassName may be used to set the VolumeAttributesClass used by this claim. If specified, the CSI driver will create or update the volume with the attributes defined in the corresponding VolumeAttributesClass. This has a different purpose than storageClassName, it can be changed after the claim is created. An empty string value means that no VolumeAttributesClass will be applied to the claim but it's not allowed to reset this field to empty string once it is set. If unspecified and the PersistentVolumeClaim is unbound, the default VolumeAttributesClass will be set by the persistentvolume controller if it exists. If the resource referred to by volumeAttributesClass does not exist, this PersistentVolumeClaim will be set to a Pending state, as reflected by the modifyVolumeStatus field, until such as a resource exists. More info: https://kubernetes.io/docs/concepts/storage/volume-attributes-classes/ (Beta) Using this field requires the VolumeAttributesClass feature gate to be enabled (off by default).
+     */
     @JsonProperty("volumeAttributesClassName")
     public String getVolumeAttributesClassName() {
         return volumeAttributesClassName;
     }
 
+    /**
+     * volumeAttributesClassName may be used to set the VolumeAttributesClass used by this claim. If specified, the CSI driver will create or update the volume with the attributes defined in the corresponding VolumeAttributesClass. This has a different purpose than storageClassName, it can be changed after the claim is created. An empty string value means that no VolumeAttributesClass will be applied to the claim but it's not allowed to reset this field to empty string once it is set. If unspecified and the PersistentVolumeClaim is unbound, the default VolumeAttributesClass will be set by the persistentvolume controller if it exists. If the resource referred to by volumeAttributesClass does not exist, this PersistentVolumeClaim will be set to a Pending state, as reflected by the modifyVolumeStatus field, until such as a resource exists. More info: https://kubernetes.io/docs/concepts/storage/volume-attributes-classes/ (Beta) Using this field requires the VolumeAttributesClass feature gate to be enabled (off by default).
+     */
     @JsonProperty("volumeAttributesClassName")
     public void setVolumeAttributesClassName(String volumeAttributesClassName) {
         this.volumeAttributesClassName = volumeAttributesClassName;
     }
 
+    /**
+     * volumeMode defines what type of volume is required by the claim. Value of Filesystem is implied when not included in claim spec.
+     */
     @JsonProperty("volumeMode")
     public String getVolumeMode() {
         return volumeMode;
     }
 
+    /**
+     * volumeMode defines what type of volume is required by the claim. Value of Filesystem is implied when not included in claim spec.
+     */
     @JsonProperty("volumeMode")
     public void setVolumeMode(String volumeMode) {
         this.volumeMode = volumeMode;
     }
 
+    /**
+     * volumeName is the binding reference to the PersistentVolume backing this claim.
+     */
     @JsonProperty("volumeName")
     public String getVolumeName() {
         return volumeName;
     }
 
+    /**
+     * volumeName is the binding reference to the PersistentVolume backing this claim.
+     */
     @JsonProperty("volumeName")
     public void setVolumeName(String volumeName) {
         this.volumeName = volumeName;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeClaimStatus.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeClaimStatus.java
index 87ec99c24f0..82ac81a9199 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeClaimStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeClaimStatus.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PersistentVolumeClaimStatus is the current status of a persistent volume claim.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -84,86 +87,134 @@ public PersistentVolumeClaimStatus(List<String> accessModes, Map<String, String>
         this.phase = phase;
     }
 
+    /**
+     * accessModes contains the actual access modes the volume backing the PVC has. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1
+     */
     @JsonProperty("accessModes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAccessModes() {
         return accessModes;
     }
 
+    /**
+     * accessModes contains the actual access modes the volume backing the PVC has. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1
+     */
     @JsonProperty("accessModes")
     public void setAccessModes(List<String> accessModes) {
         this.accessModes = accessModes;
     }
 
+    /**
+     * allocatedResourceStatuses stores status of resource being resized for the given PVC. Key names follow standard Kubernetes label syntax. Valid values are either:<br><p> 	&#42; Un-prefixed keys:<br><p> 		- storage - the capacity of the volume.<br><p> 	&#42; Custom resources must use implementation-defined prefixed names such as "example.com/my-custom-resource"<br><p> Apart from above values - keys that are unprefixed or have kubernetes.io prefix are considered reserved and hence may not be used.<br><p> <br><p> ClaimResourceStatus can be in any of following states:<br><p> 	- ControllerResizeInProgress:<br><p> 		State set when resize controller starts resizing the volume in control-plane.<br><p> 	- ControllerResizeFailed:<br><p> 		State set when resize has failed in resize controller with a terminal error.<br><p> 	- NodeResizePending:<br><p> 		State set when resize controller has finished resizing the volume but further resizing of<br><p> 		volume is needed on the node.<br><p> 	- NodeResizeInProgress:<br><p> 		State set when kubelet starts resizing the volume.<br><p> 	- NodeResizeFailed:<br><p> 		State set when resizing has failed in kubelet with a terminal error. Transient errors don't set<br><p> 		NodeResizeFailed.<br><p> For example: if expanding a PVC for more capacity - this field can be one of the following states:<br><p> 	- pvc.status.allocatedResourceStatus['storage'] = "ControllerResizeInProgress"<br><p>      - pvc.status.allocatedResourceStatus['storage'] = "ControllerResizeFailed"<br><p>      - pvc.status.allocatedResourceStatus['storage'] = "NodeResizePending"<br><p>      - pvc.status.allocatedResourceStatus['storage'] = "NodeResizeInProgress"<br><p>      - pvc.status.allocatedResourceStatus['storage'] = "NodeResizeFailed"<br><p> When this field is not set, it means that no resize operation is in progress for the given PVC.<br><p> <br><p> A controller that receives PVC update with previously unknown resourceName or ClaimResourceStatus should ignore the update for the purpose it was designed. For example - a controller that only is responsible for resizing capacity of the volume, should ignore PVC updates that change other valid resources associated with PVC.<br><p> <br><p> This is an alpha field and requires enabling RecoverVolumeExpansionFailure feature.
+     */
     @JsonProperty("allocatedResourceStatuses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAllocatedResourceStatuses() {
         return allocatedResourceStatuses;
     }
 
+    /**
+     * allocatedResourceStatuses stores status of resource being resized for the given PVC. Key names follow standard Kubernetes label syntax. Valid values are either:<br><p> 	&#42; Un-prefixed keys:<br><p> 		- storage - the capacity of the volume.<br><p> 	&#42; Custom resources must use implementation-defined prefixed names such as "example.com/my-custom-resource"<br><p> Apart from above values - keys that are unprefixed or have kubernetes.io prefix are considered reserved and hence may not be used.<br><p> <br><p> ClaimResourceStatus can be in any of following states:<br><p> 	- ControllerResizeInProgress:<br><p> 		State set when resize controller starts resizing the volume in control-plane.<br><p> 	- ControllerResizeFailed:<br><p> 		State set when resize has failed in resize controller with a terminal error.<br><p> 	- NodeResizePending:<br><p> 		State set when resize controller has finished resizing the volume but further resizing of<br><p> 		volume is needed on the node.<br><p> 	- NodeResizeInProgress:<br><p> 		State set when kubelet starts resizing the volume.<br><p> 	- NodeResizeFailed:<br><p> 		State set when resizing has failed in kubelet with a terminal error. Transient errors don't set<br><p> 		NodeResizeFailed.<br><p> For example: if expanding a PVC for more capacity - this field can be one of the following states:<br><p> 	- pvc.status.allocatedResourceStatus['storage'] = "ControllerResizeInProgress"<br><p>      - pvc.status.allocatedResourceStatus['storage'] = "ControllerResizeFailed"<br><p>      - pvc.status.allocatedResourceStatus['storage'] = "NodeResizePending"<br><p>      - pvc.status.allocatedResourceStatus['storage'] = "NodeResizeInProgress"<br><p>      - pvc.status.allocatedResourceStatus['storage'] = "NodeResizeFailed"<br><p> When this field is not set, it means that no resize operation is in progress for the given PVC.<br><p> <br><p> A controller that receives PVC update with previously unknown resourceName or ClaimResourceStatus should ignore the update for the purpose it was designed. For example - a controller that only is responsible for resizing capacity of the volume, should ignore PVC updates that change other valid resources associated with PVC.<br><p> <br><p> This is an alpha field and requires enabling RecoverVolumeExpansionFailure feature.
+     */
     @JsonProperty("allocatedResourceStatuses")
     public void setAllocatedResourceStatuses(Map<String, String> allocatedResourceStatuses) {
         this.allocatedResourceStatuses = allocatedResourceStatuses;
     }
 
+    /**
+     * allocatedResources tracks the resources allocated to a PVC including its capacity. Key names follow standard Kubernetes label syntax. Valid values are either:<br><p> 	&#42; Un-prefixed keys:<br><p> 		- storage - the capacity of the volume.<br><p> 	&#42; Custom resources must use implementation-defined prefixed names such as "example.com/my-custom-resource"<br><p> Apart from above values - keys that are unprefixed or have kubernetes.io prefix are considered reserved and hence may not be used.<br><p> <br><p> Capacity reported here may be larger than the actual capacity when a volume expansion operation is requested. For storage quota, the larger value from allocatedResources and PVC.spec.resources is used. If allocatedResources is not set, PVC.spec.resources alone is used for quota calculation. If a volume expansion capacity request is lowered, allocatedResources is only lowered if there are no expansion operations in progress and if the actual volume capacity is equal or lower than the requested capacity.<br><p> <br><p> A controller that receives PVC update with previously unknown resourceName should ignore the update for the purpose it was designed. For example - a controller that only is responsible for resizing capacity of the volume, should ignore PVC updates that change other valid resources associated with PVC.<br><p> <br><p> This is an alpha field and requires enabling RecoverVolumeExpansionFailure feature.
+     */
     @JsonProperty("allocatedResources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getAllocatedResources() {
         return allocatedResources;
     }
 
+    /**
+     * allocatedResources tracks the resources allocated to a PVC including its capacity. Key names follow standard Kubernetes label syntax. Valid values are either:<br><p> 	&#42; Un-prefixed keys:<br><p> 		- storage - the capacity of the volume.<br><p> 	&#42; Custom resources must use implementation-defined prefixed names such as "example.com/my-custom-resource"<br><p> Apart from above values - keys that are unprefixed or have kubernetes.io prefix are considered reserved and hence may not be used.<br><p> <br><p> Capacity reported here may be larger than the actual capacity when a volume expansion operation is requested. For storage quota, the larger value from allocatedResources and PVC.spec.resources is used. If allocatedResources is not set, PVC.spec.resources alone is used for quota calculation. If a volume expansion capacity request is lowered, allocatedResources is only lowered if there are no expansion operations in progress and if the actual volume capacity is equal or lower than the requested capacity.<br><p> <br><p> A controller that receives PVC update with previously unknown resourceName should ignore the update for the purpose it was designed. For example - a controller that only is responsible for resizing capacity of the volume, should ignore PVC updates that change other valid resources associated with PVC.<br><p> <br><p> This is an alpha field and requires enabling RecoverVolumeExpansionFailure feature.
+     */
     @JsonProperty("allocatedResources")
     public void setAllocatedResources(Map<String, Quantity> allocatedResources) {
         this.allocatedResources = allocatedResources;
     }
 
+    /**
+     * capacity represents the actual resources of the underlying volume.
+     */
     @JsonProperty("capacity")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getCapacity() {
         return capacity;
     }
 
+    /**
+     * capacity represents the actual resources of the underlying volume.
+     */
     @JsonProperty("capacity")
     public void setCapacity(Map<String, Quantity> capacity) {
         this.capacity = capacity;
     }
 
+    /**
+     * conditions is the current Condition of persistent volume claim. If underlying persistent volume is being resized then the Condition will be set to 'Resizing'.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PersistentVolumeClaimCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is the current Condition of persistent volume claim. If underlying persistent volume is being resized then the Condition will be set to 'Resizing'.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<PersistentVolumeClaimCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * currentVolumeAttributesClassName is the current name of the VolumeAttributesClass the PVC is using. When unset, there is no VolumeAttributeClass applied to this PersistentVolumeClaim This is a beta field and requires enabling VolumeAttributesClass feature (off by default).
+     */
     @JsonProperty("currentVolumeAttributesClassName")
     public String getCurrentVolumeAttributesClassName() {
         return currentVolumeAttributesClassName;
     }
 
+    /**
+     * currentVolumeAttributesClassName is the current name of the VolumeAttributesClass the PVC is using. When unset, there is no VolumeAttributeClass applied to this PersistentVolumeClaim This is a beta field and requires enabling VolumeAttributesClass feature (off by default).
+     */
     @JsonProperty("currentVolumeAttributesClassName")
     public void setCurrentVolumeAttributesClassName(String currentVolumeAttributesClassName) {
         this.currentVolumeAttributesClassName = currentVolumeAttributesClassName;
     }
 
+    /**
+     * PersistentVolumeClaimStatus is the current status of a persistent volume claim.
+     */
     @JsonProperty("modifyVolumeStatus")
     public ModifyVolumeStatus getModifyVolumeStatus() {
         return modifyVolumeStatus;
     }
 
+    /**
+     * PersistentVolumeClaimStatus is the current status of a persistent volume claim.
+     */
     @JsonProperty("modifyVolumeStatus")
     public void setModifyVolumeStatus(ModifyVolumeStatus modifyVolumeStatus) {
         this.modifyVolumeStatus = modifyVolumeStatus;
     }
 
+    /**
+     * phase represents the current phase of PersistentVolumeClaim.
+     */
     @JsonProperty("phase")
     public String getPhase() {
         return phase;
     }
 
+    /**
+     * phase represents the current phase of PersistentVolumeClaim.
+     */
     @JsonProperty("phase")
     public void setPhase(String phase) {
         this.phase = phase;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeClaimTemplate.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeClaimTemplate.java
index 55a146b15f1..b0cf2af5841 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeClaimTemplate.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeClaimTemplate.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PersistentVolumeClaimTemplate is used to produce PersistentVolumeClaim objects as part of an EphemeralVolumeSource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public PersistentVolumeClaimTemplate(ObjectMeta metadata, PersistentVolumeClaimS
         this.spec = spec;
     }
 
+    /**
+     * PersistentVolumeClaimTemplate is used to produce PersistentVolumeClaim objects as part of an EphemeralVolumeSource.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PersistentVolumeClaimTemplate is used to produce PersistentVolumeClaim objects as part of an EphemeralVolumeSource.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PersistentVolumeClaimTemplate is used to produce PersistentVolumeClaim objects as part of an EphemeralVolumeSource.
+     */
     @JsonProperty("spec")
     public PersistentVolumeClaimSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PersistentVolumeClaimTemplate is used to produce PersistentVolumeClaim objects as part of an EphemeralVolumeSource.
+     */
     @JsonProperty("spec")
     public void setSpec(PersistentVolumeClaimSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeClaimVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeClaimVolumeSource.java
index 60a11d46114..e0aedfaa474 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeClaimVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeClaimVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PersistentVolumeClaimVolumeSource references the user's PVC in the same namespace. This volume finds the bound PV and mounts that volume for the pod. A PersistentVolumeClaimVolumeSource is, essentially, a wrapper around another type of volume that is owned by someone else (the system).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public PersistentVolumeClaimVolumeSource(String claimName, Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * claimName is the name of a PersistentVolumeClaim in the same namespace as the pod using this volume. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims
+     */
     @JsonProperty("claimName")
     public String getClaimName() {
         return claimName;
     }
 
+    /**
+     * claimName is the name of a PersistentVolumeClaim in the same namespace as the pod using this volume. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims
+     */
     @JsonProperty("claimName")
     public void setClaimName(String claimName) {
         this.claimName = claimName;
     }
 
+    /**
+     * readOnly Will force the ReadOnly setting in VolumeMounts. Default false.
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly Will force the ReadOnly setting in VolumeMounts. Default false.
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeList.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeList.java
index d7eb722631a..d4b2751268d 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeList.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeList.java
@@ -23,6 +23,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PersistentVolumeList is a list of PersistentVolume items.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -47,17 +50,11 @@
 public class PersistentVolumeList implements Editable<PersistentVolumeListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.PersistentVolume>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.PersistentVolume> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PersistentVolumeList";
     @JsonProperty("metadata")
@@ -80,7 +77,7 @@ public PersistentVolumeList(String apiVersion, List<io.fabric8.kubernetes.api.mo
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -88,26 +85,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is a list of persistent volumes. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.PersistentVolume> getItems() {
         return items;
     }
 
+    /**
+     * items is a list of persistent volumes. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.PersistentVolume> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -115,18 +118,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PersistentVolumeList is a list of PersistentVolume items.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PersistentVolumeList is a list of PersistentVolume items.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeSpec.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeSpec.java
index 16290b7e719..01395c4432c 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeSpec.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PersistentVolumeSpec is the specification of a persistent volume.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -174,314 +177,500 @@ public PersistentVolumeSpec(List<String> accessModes, AWSElasticBlockStoreVolume
         this.vsphereVolume = vsphereVolume;
     }
 
+    /**
+     * accessModes contains all ways the volume can be mounted. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes
+     */
     @JsonProperty("accessModes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAccessModes() {
         return accessModes;
     }
 
+    /**
+     * accessModes contains all ways the volume can be mounted. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes
+     */
     @JsonProperty("accessModes")
     public void setAccessModes(List<String> accessModes) {
         this.accessModes = accessModes;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("awsElasticBlockStore")
     public AWSElasticBlockStoreVolumeSource getAwsElasticBlockStore() {
         return awsElasticBlockStore;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("awsElasticBlockStore")
     public void setAwsElasticBlockStore(AWSElasticBlockStoreVolumeSource awsElasticBlockStore) {
         this.awsElasticBlockStore = awsElasticBlockStore;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("azureDisk")
     public AzureDiskVolumeSource getAzureDisk() {
         return azureDisk;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("azureDisk")
     public void setAzureDisk(AzureDiskVolumeSource azureDisk) {
         this.azureDisk = azureDisk;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("azureFile")
     public AzureFilePersistentVolumeSource getAzureFile() {
         return azureFile;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("azureFile")
     public void setAzureFile(AzureFilePersistentVolumeSource azureFile) {
         this.azureFile = azureFile;
     }
 
+    /**
+     * capacity is the description of the persistent volume's resources and capacity. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#capacity
+     */
     @JsonProperty("capacity")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getCapacity() {
         return capacity;
     }
 
+    /**
+     * capacity is the description of the persistent volume's resources and capacity. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#capacity
+     */
     @JsonProperty("capacity")
     public void setCapacity(Map<String, Quantity> capacity) {
         this.capacity = capacity;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("cephfs")
     public CephFSPersistentVolumeSource getCephfs() {
         return cephfs;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("cephfs")
     public void setCephfs(CephFSPersistentVolumeSource cephfs) {
         this.cephfs = cephfs;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("cinder")
     public CinderPersistentVolumeSource getCinder() {
         return cinder;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("cinder")
     public void setCinder(CinderPersistentVolumeSource cinder) {
         this.cinder = cinder;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("claimRef")
     public ObjectReference getClaimRef() {
         return claimRef;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("claimRef")
     public void setClaimRef(ObjectReference claimRef) {
         this.claimRef = claimRef;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("csi")
     public CSIPersistentVolumeSource getCsi() {
         return csi;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("csi")
     public void setCsi(CSIPersistentVolumeSource csi) {
         this.csi = csi;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("fc")
     public FCVolumeSource getFc() {
         return fc;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("fc")
     public void setFc(FCVolumeSource fc) {
         this.fc = fc;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("flexVolume")
     public FlexPersistentVolumeSource getFlexVolume() {
         return flexVolume;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("flexVolume")
     public void setFlexVolume(FlexPersistentVolumeSource flexVolume) {
         this.flexVolume = flexVolume;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("flocker")
     public FlockerVolumeSource getFlocker() {
         return flocker;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("flocker")
     public void setFlocker(FlockerVolumeSource flocker) {
         this.flocker = flocker;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("gcePersistentDisk")
     public GCEPersistentDiskVolumeSource getGcePersistentDisk() {
         return gcePersistentDisk;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("gcePersistentDisk")
     public void setGcePersistentDisk(GCEPersistentDiskVolumeSource gcePersistentDisk) {
         this.gcePersistentDisk = gcePersistentDisk;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("glusterfs")
     public GlusterfsPersistentVolumeSource getGlusterfs() {
         return glusterfs;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("glusterfs")
     public void setGlusterfs(GlusterfsPersistentVolumeSource glusterfs) {
         this.glusterfs = glusterfs;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("hostPath")
     public HostPathVolumeSource getHostPath() {
         return hostPath;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("hostPath")
     public void setHostPath(HostPathVolumeSource hostPath) {
         this.hostPath = hostPath;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("iscsi")
     public ISCSIPersistentVolumeSource getIscsi() {
         return iscsi;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("iscsi")
     public void setIscsi(ISCSIPersistentVolumeSource iscsi) {
         this.iscsi = iscsi;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("local")
     public LocalVolumeSource getLocal() {
         return local;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("local")
     public void setLocal(LocalVolumeSource local) {
         this.local = local;
     }
 
+    /**
+     * mountOptions is the list of mount options, e.g. ["ro", "soft"]. Not validated - mount will simply fail if one is invalid. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes/#mount-options
+     */
     @JsonProperty("mountOptions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMountOptions() {
         return mountOptions;
     }
 
+    /**
+     * mountOptions is the list of mount options, e.g. ["ro", "soft"]. Not validated - mount will simply fail if one is invalid. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes/#mount-options
+     */
     @JsonProperty("mountOptions")
     public void setMountOptions(List<String> mountOptions) {
         this.mountOptions = mountOptions;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("nfs")
     public NFSVolumeSource getNfs() {
         return nfs;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("nfs")
     public void setNfs(NFSVolumeSource nfs) {
         this.nfs = nfs;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("nodeAffinity")
     public VolumeNodeAffinity getNodeAffinity() {
         return nodeAffinity;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("nodeAffinity")
     public void setNodeAffinity(VolumeNodeAffinity nodeAffinity) {
         this.nodeAffinity = nodeAffinity;
     }
 
+    /**
+     * persistentVolumeReclaimPolicy defines what happens to a persistent volume when released from its claim. Valid options are Retain (default for manually created PersistentVolumes), Delete (default for dynamically provisioned PersistentVolumes), and Recycle (deprecated). Recycle must be supported by the volume plugin underlying this PersistentVolume. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#reclaiming
+     */
     @JsonProperty("persistentVolumeReclaimPolicy")
     public String getPersistentVolumeReclaimPolicy() {
         return persistentVolumeReclaimPolicy;
     }
 
+    /**
+     * persistentVolumeReclaimPolicy defines what happens to a persistent volume when released from its claim. Valid options are Retain (default for manually created PersistentVolumes), Delete (default for dynamically provisioned PersistentVolumes), and Recycle (deprecated). Recycle must be supported by the volume plugin underlying this PersistentVolume. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#reclaiming
+     */
     @JsonProperty("persistentVolumeReclaimPolicy")
     public void setPersistentVolumeReclaimPolicy(String persistentVolumeReclaimPolicy) {
         this.persistentVolumeReclaimPolicy = persistentVolumeReclaimPolicy;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("photonPersistentDisk")
     public PhotonPersistentDiskVolumeSource getPhotonPersistentDisk() {
         return photonPersistentDisk;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("photonPersistentDisk")
     public void setPhotonPersistentDisk(PhotonPersistentDiskVolumeSource photonPersistentDisk) {
         this.photonPersistentDisk = photonPersistentDisk;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("portworxVolume")
     public PortworxVolumeSource getPortworxVolume() {
         return portworxVolume;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("portworxVolume")
     public void setPortworxVolume(PortworxVolumeSource portworxVolume) {
         this.portworxVolume = portworxVolume;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("quobyte")
     public QuobyteVolumeSource getQuobyte() {
         return quobyte;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("quobyte")
     public void setQuobyte(QuobyteVolumeSource quobyte) {
         this.quobyte = quobyte;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("rbd")
     public RBDPersistentVolumeSource getRbd() {
         return rbd;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("rbd")
     public void setRbd(RBDPersistentVolumeSource rbd) {
         this.rbd = rbd;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("scaleIO")
     public ScaleIOPersistentVolumeSource getScaleIO() {
         return scaleIO;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("scaleIO")
     public void setScaleIO(ScaleIOPersistentVolumeSource scaleIO) {
         this.scaleIO = scaleIO;
     }
 
+    /**
+     * storageClassName is the name of StorageClass to which this persistent volume belongs. Empty value means that this volume does not belong to any StorageClass.
+     */
     @JsonProperty("storageClassName")
     public String getStorageClassName() {
         return storageClassName;
     }
 
+    /**
+     * storageClassName is the name of StorageClass to which this persistent volume belongs. Empty value means that this volume does not belong to any StorageClass.
+     */
     @JsonProperty("storageClassName")
     public void setStorageClassName(String storageClassName) {
         this.storageClassName = storageClassName;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("storageos")
     public StorageOSPersistentVolumeSource getStorageos() {
         return storageos;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("storageos")
     public void setStorageos(StorageOSPersistentVolumeSource storageos) {
         this.storageos = storageos;
     }
 
+    /**
+     * Name of VolumeAttributesClass to which this persistent volume belongs. Empty value is not allowed. When this field is not set, it indicates that this volume does not belong to any VolumeAttributesClass. This field is mutable and can be changed by the CSI driver after a volume has been updated successfully to a new class. For an unbound PersistentVolume, the volumeAttributesClassName will be matched with unbound PersistentVolumeClaims during the binding process. This is a beta field and requires enabling VolumeAttributesClass feature (off by default).
+     */
     @JsonProperty("volumeAttributesClassName")
     public String getVolumeAttributesClassName() {
         return volumeAttributesClassName;
     }
 
+    /**
+     * Name of VolumeAttributesClass to which this persistent volume belongs. Empty value is not allowed. When this field is not set, it indicates that this volume does not belong to any VolumeAttributesClass. This field is mutable and can be changed by the CSI driver after a volume has been updated successfully to a new class. For an unbound PersistentVolume, the volumeAttributesClassName will be matched with unbound PersistentVolumeClaims during the binding process. This is a beta field and requires enabling VolumeAttributesClass feature (off by default).
+     */
     @JsonProperty("volumeAttributesClassName")
     public void setVolumeAttributesClassName(String volumeAttributesClassName) {
         this.volumeAttributesClassName = volumeAttributesClassName;
     }
 
+    /**
+     * volumeMode defines if a volume is intended to be used with a formatted filesystem or to remain in raw block state. Value of Filesystem is implied when not included in spec.
+     */
     @JsonProperty("volumeMode")
     public String getVolumeMode() {
         return volumeMode;
     }
 
+    /**
+     * volumeMode defines if a volume is intended to be used with a formatted filesystem or to remain in raw block state. Value of Filesystem is implied when not included in spec.
+     */
     @JsonProperty("volumeMode")
     public void setVolumeMode(String volumeMode) {
         this.volumeMode = volumeMode;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("vsphereVolume")
     public VsphereVirtualDiskVolumeSource getVsphereVolume() {
         return vsphereVolume;
     }
 
+    /**
+     * PersistentVolumeSpec is the specification of a persistent volume.
+     */
     @JsonProperty("vsphereVolume")
     public void setVsphereVolume(VsphereVirtualDiskVolumeSource vsphereVolume) {
         this.vsphereVolume = vsphereVolume;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeStatus.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeStatus.java
index 19ad8513f7d..8ce1dd01372 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PersistentVolumeStatus.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PersistentVolumeStatus is the current status of a persistent volume.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -61,41 +64,65 @@ public PersistentVolumeStatus(String lastPhaseTransitionTime, String message, St
         this.reason = reason;
     }
 
+    /**
+     * PersistentVolumeStatus is the current status of a persistent volume.
+     */
     @JsonProperty("lastPhaseTransitionTime")
     public String getLastPhaseTransitionTime() {
         return lastPhaseTransitionTime;
     }
 
+    /**
+     * PersistentVolumeStatus is the current status of a persistent volume.
+     */
     @JsonProperty("lastPhaseTransitionTime")
     public void setLastPhaseTransitionTime(String lastPhaseTransitionTime) {
         this.lastPhaseTransitionTime = lastPhaseTransitionTime;
     }
 
+    /**
+     * message is a human-readable message indicating details about why the volume is in this state.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message is a human-readable message indicating details about why the volume is in this state.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * phase indicates if a volume is available, bound to a claim, or released by a claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#phase
+     */
     @JsonProperty("phase")
     public String getPhase() {
         return phase;
     }
 
+    /**
+     * phase indicates if a volume is available, bound to a claim, or released by a claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#phase
+     */
     @JsonProperty("phase")
     public void setPhase(String phase) {
         this.phase = phase;
     }
 
+    /**
+     * reason is a brief CamelCase string that describes any failure and is meant for machine parsing and tidy display in the CLI.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * reason is a brief CamelCase string that describes any failure and is meant for machine parsing and tidy display in the CLI.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PhotonPersistentDiskVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PhotonPersistentDiskVolumeSource.java
index 553e48606ad..7dc36f84e51 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PhotonPersistentDiskVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PhotonPersistentDiskVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Represents a Photon Controller persistent disk resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public PhotonPersistentDiskVolumeSource(String fsType, String pdID) {
         this.pdID = pdID;
     }
 
+    /**
+     * fsType is the filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.
+     */
     @JsonProperty("fsType")
     public String getFsType() {
         return fsType;
     }
 
+    /**
+     * fsType is the filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.
+     */
     @JsonProperty("fsType")
     public void setFsType(String fsType) {
         this.fsType = fsType;
     }
 
+    /**
+     * pdID is the ID that identifies Photon Controller persistent disk
+     */
     @JsonProperty("pdID")
     public String getPdID() {
         return pdID;
     }
 
+    /**
+     * pdID is the ID that identifies Photon Controller persistent disk
+     */
     @JsonProperty("pdID")
     public void setPdID(String pdID) {
         this.pdID = pdID;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Pod.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Pod.java
index e0eac66c95c..aad6deca3b9 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Pod.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Pod.java
@@ -21,6 +21,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Pod is a collection of containers that can run on a host. This resource is created by clients and scheduled onto hosts.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -46,14 +49,8 @@
 public class Pod implements Editable<PodBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Pod";
     @JsonProperty("metadata")
@@ -81,7 +78,7 @@ public Pod(String apiVersion, String kind, ObjectMeta metadata, PodSpec spec, Po
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -89,7 +86,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -97,7 +94,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -105,38 +102,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Pod is a collection of containers that can run on a host. This resource is created by clients and scheduled onto hosts.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Pod is a collection of containers that can run on a host. This resource is created by clients and scheduled onto hosts.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Pod is a collection of containers that can run on a host. This resource is created by clients and scheduled onto hosts.
+     */
     @JsonProperty("spec")
     public PodSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Pod is a collection of containers that can run on a host. This resource is created by clients and scheduled onto hosts.
+     */
     @JsonProperty("spec")
     public void setSpec(PodSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Pod is a collection of containers that can run on a host. This resource is created by clients and scheduled onto hosts.
+     */
     @JsonProperty("status")
     public PodStatus getStatus() {
         return status;
     }
 
+    /**
+     * Pod is a collection of containers that can run on a host. This resource is created by clients and scheduled onto hosts.
+     */
     @JsonProperty("status")
     public void setStatus(PodStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodAffinity.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodAffinity.java
index adaf5c6dd92..b489bdbbfa7 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodAffinity.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodAffinity.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Pod affinity is a group of inter pod affinity scheduling rules.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -57,23 +60,35 @@ public PodAffinity(List<WeightedPodAffinityTerm> preferredDuringSchedulingIgnore
         this.requiredDuringSchedulingIgnoredDuringExecution = requiredDuringSchedulingIgnoredDuringExecution;
     }
 
+    /**
+     * The scheduler will prefer to schedule pods to nodes that satisfy the affinity expressions specified by this field, but it may choose a node that violates one or more of the expressions. The node that is most preferred is the one with the greatest sum of weights, i.e. for each node that meets all of the scheduling requirements (resource request, requiredDuringScheduling affinity expressions, etc.), compute a sum by iterating through the elements of this field and adding "weight" to the sum if the node has pods which matches the corresponding podAffinityTerm; the node(s) with the highest sum are the most preferred.
+     */
     @JsonProperty("preferredDuringSchedulingIgnoredDuringExecution")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WeightedPodAffinityTerm> getPreferredDuringSchedulingIgnoredDuringExecution() {
         return preferredDuringSchedulingIgnoredDuringExecution;
     }
 
+    /**
+     * The scheduler will prefer to schedule pods to nodes that satisfy the affinity expressions specified by this field, but it may choose a node that violates one or more of the expressions. The node that is most preferred is the one with the greatest sum of weights, i.e. for each node that meets all of the scheduling requirements (resource request, requiredDuringScheduling affinity expressions, etc.), compute a sum by iterating through the elements of this field and adding "weight" to the sum if the node has pods which matches the corresponding podAffinityTerm; the node(s) with the highest sum are the most preferred.
+     */
     @JsonProperty("preferredDuringSchedulingIgnoredDuringExecution")
     public void setPreferredDuringSchedulingIgnoredDuringExecution(List<WeightedPodAffinityTerm> preferredDuringSchedulingIgnoredDuringExecution) {
         this.preferredDuringSchedulingIgnoredDuringExecution = preferredDuringSchedulingIgnoredDuringExecution;
     }
 
+    /**
+     * If the affinity requirements specified by this field are not met at scheduling time, the pod will not be scheduled onto the node. If the affinity requirements specified by this field cease to be met at some point during pod execution (e.g. due to a pod label update), the system may or may not try to eventually evict the pod from its node. When there are multiple elements, the lists of nodes corresponding to each podAffinityTerm are intersected, i.e. all terms must be satisfied.
+     */
     @JsonProperty("requiredDuringSchedulingIgnoredDuringExecution")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PodAffinityTerm> getRequiredDuringSchedulingIgnoredDuringExecution() {
         return requiredDuringSchedulingIgnoredDuringExecution;
     }
 
+    /**
+     * If the affinity requirements specified by this field are not met at scheduling time, the pod will not be scheduled onto the node. If the affinity requirements specified by this field cease to be met at some point during pod execution (e.g. due to a pod label update), the system may or may not try to eventually evict the pod from its node. When there are multiple elements, the lists of nodes corresponding to each podAffinityTerm are intersected, i.e. all terms must be satisfied.
+     */
     @JsonProperty("requiredDuringSchedulingIgnoredDuringExecution")
     public void setRequiredDuringSchedulingIgnoredDuringExecution(List<PodAffinityTerm> requiredDuringSchedulingIgnoredDuringExecution) {
         this.requiredDuringSchedulingIgnoredDuringExecution = requiredDuringSchedulingIgnoredDuringExecution;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodAffinityTerm.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodAffinityTerm.java
index bcac71e406a..2e310ba6a0e 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodAffinityTerm.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodAffinityTerm.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Defines a set of pods (namely those matching the labelSelector relative to the given namespace(s)) that this pod should be co-located (affinity) or not co-located (anti-affinity) with, where co-located is defined as running on a node whose value of the label with key &lt;topologyKey&gt; matches that of any node on which a pod of the set of pods is running
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,64 +77,100 @@ public PodAffinityTerm(LabelSelector labelSelector, List<String> matchLabelKeys,
         this.topologyKey = topologyKey;
     }
 
+    /**
+     * Defines a set of pods (namely those matching the labelSelector relative to the given namespace(s)) that this pod should be co-located (affinity) or not co-located (anti-affinity) with, where co-located is defined as running on a node whose value of the label with key &lt;topologyKey&gt; matches that of any node on which a pod of the set of pods is running
+     */
     @JsonProperty("labelSelector")
     public LabelSelector getLabelSelector() {
         return labelSelector;
     }
 
+    /**
+     * Defines a set of pods (namely those matching the labelSelector relative to the given namespace(s)) that this pod should be co-located (affinity) or not co-located (anti-affinity) with, where co-located is defined as running on a node whose value of the label with key &lt;topologyKey&gt; matches that of any node on which a pod of the set of pods is running
+     */
     @JsonProperty("labelSelector")
     public void setLabelSelector(LabelSelector labelSelector) {
         this.labelSelector = labelSelector;
     }
 
+    /**
+     * MatchLabelKeys is a set of pod label keys to select which pods will be taken into consideration. The keys are used to lookup values from the incoming pod labels, those key-value labels are merged with `labelSelector` as `key in (value)` to select the group of existing pods which pods will be taken into consideration for the incoming pod's pod (anti) affinity. Keys that don't exist in the incoming pod labels will be ignored. The default value is empty. The same key is forbidden to exist in both matchLabelKeys and labelSelector. Also, matchLabelKeys cannot be set when labelSelector isn't set. This is a beta field and requires enabling MatchLabelKeysInPodAffinity feature gate (enabled by default).
+     */
     @JsonProperty("matchLabelKeys")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMatchLabelKeys() {
         return matchLabelKeys;
     }
 
+    /**
+     * MatchLabelKeys is a set of pod label keys to select which pods will be taken into consideration. The keys are used to lookup values from the incoming pod labels, those key-value labels are merged with `labelSelector` as `key in (value)` to select the group of existing pods which pods will be taken into consideration for the incoming pod's pod (anti) affinity. Keys that don't exist in the incoming pod labels will be ignored. The default value is empty. The same key is forbidden to exist in both matchLabelKeys and labelSelector. Also, matchLabelKeys cannot be set when labelSelector isn't set. This is a beta field and requires enabling MatchLabelKeysInPodAffinity feature gate (enabled by default).
+     */
     @JsonProperty("matchLabelKeys")
     public void setMatchLabelKeys(List<String> matchLabelKeys) {
         this.matchLabelKeys = matchLabelKeys;
     }
 
+    /**
+     * MismatchLabelKeys is a set of pod label keys to select which pods will be taken into consideration. The keys are used to lookup values from the incoming pod labels, those key-value labels are merged with `labelSelector` as `key notin (value)` to select the group of existing pods which pods will be taken into consideration for the incoming pod's pod (anti) affinity. Keys that don't exist in the incoming pod labels will be ignored. The default value is empty. The same key is forbidden to exist in both mismatchLabelKeys and labelSelector. Also, mismatchLabelKeys cannot be set when labelSelector isn't set. This is a beta field and requires enabling MatchLabelKeysInPodAffinity feature gate (enabled by default).
+     */
     @JsonProperty("mismatchLabelKeys")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMismatchLabelKeys() {
         return mismatchLabelKeys;
     }
 
+    /**
+     * MismatchLabelKeys is a set of pod label keys to select which pods will be taken into consideration. The keys are used to lookup values from the incoming pod labels, those key-value labels are merged with `labelSelector` as `key notin (value)` to select the group of existing pods which pods will be taken into consideration for the incoming pod's pod (anti) affinity. Keys that don't exist in the incoming pod labels will be ignored. The default value is empty. The same key is forbidden to exist in both mismatchLabelKeys and labelSelector. Also, mismatchLabelKeys cannot be set when labelSelector isn't set. This is a beta field and requires enabling MatchLabelKeysInPodAffinity feature gate (enabled by default).
+     */
     @JsonProperty("mismatchLabelKeys")
     public void setMismatchLabelKeys(List<String> mismatchLabelKeys) {
         this.mismatchLabelKeys = mismatchLabelKeys;
     }
 
+    /**
+     * Defines a set of pods (namely those matching the labelSelector relative to the given namespace(s)) that this pod should be co-located (affinity) or not co-located (anti-affinity) with, where co-located is defined as running on a node whose value of the label with key &lt;topologyKey&gt; matches that of any node on which a pod of the set of pods is running
+     */
     @JsonProperty("namespaceSelector")
     public LabelSelector getNamespaceSelector() {
         return namespaceSelector;
     }
 
+    /**
+     * Defines a set of pods (namely those matching the labelSelector relative to the given namespace(s)) that this pod should be co-located (affinity) or not co-located (anti-affinity) with, where co-located is defined as running on a node whose value of the label with key &lt;topologyKey&gt; matches that of any node on which a pod of the set of pods is running
+     */
     @JsonProperty("namespaceSelector")
     public void setNamespaceSelector(LabelSelector namespaceSelector) {
         this.namespaceSelector = namespaceSelector;
     }
 
+    /**
+     * namespaces specifies a static list of namespace names that the term applies to. The term is applied to the union of the namespaces listed in this field and the ones selected by namespaceSelector. null or empty namespaces list and null namespaceSelector means "this pod's namespace".
+     */
     @JsonProperty("namespaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNamespaces() {
         return namespaces;
     }
 
+    /**
+     * namespaces specifies a static list of namespace names that the term applies to. The term is applied to the union of the namespaces listed in this field and the ones selected by namespaceSelector. null or empty namespaces list and null namespaceSelector means "this pod's namespace".
+     */
     @JsonProperty("namespaces")
     public void setNamespaces(List<String> namespaces) {
         this.namespaces = namespaces;
     }
 
+    /**
+     * This pod should be co-located (affinity) or not co-located (anti-affinity) with the pods matching the labelSelector in the specified namespaces, where co-located is defined as running on a node whose value of the label with key topologyKey matches that of any node on which any of the selected pods is running. Empty topologyKey is not allowed.
+     */
     @JsonProperty("topologyKey")
     public String getTopologyKey() {
         return topologyKey;
     }
 
+    /**
+     * This pod should be co-located (affinity) or not co-located (anti-affinity) with the pods matching the labelSelector in the specified namespaces, where co-located is defined as running on a node whose value of the label with key topologyKey matches that of any node on which any of the selected pods is running. Empty topologyKey is not allowed.
+     */
     @JsonProperty("topologyKey")
     public void setTopologyKey(String topologyKey) {
         this.topologyKey = topologyKey;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodAntiAffinity.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodAntiAffinity.java
index d8fe1bdff6d..61375792176 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodAntiAffinity.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodAntiAffinity.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Pod anti affinity is a group of inter pod anti affinity scheduling rules.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -57,23 +60,35 @@ public PodAntiAffinity(List<WeightedPodAffinityTerm> preferredDuringSchedulingIg
         this.requiredDuringSchedulingIgnoredDuringExecution = requiredDuringSchedulingIgnoredDuringExecution;
     }
 
+    /**
+     * The scheduler will prefer to schedule pods to nodes that satisfy the anti-affinity expressions specified by this field, but it may choose a node that violates one or more of the expressions. The node that is most preferred is the one with the greatest sum of weights, i.e. for each node that meets all of the scheduling requirements (resource request, requiredDuringScheduling anti-affinity expressions, etc.), compute a sum by iterating through the elements of this field and adding "weight" to the sum if the node has pods which matches the corresponding podAffinityTerm; the node(s) with the highest sum are the most preferred.
+     */
     @JsonProperty("preferredDuringSchedulingIgnoredDuringExecution")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WeightedPodAffinityTerm> getPreferredDuringSchedulingIgnoredDuringExecution() {
         return preferredDuringSchedulingIgnoredDuringExecution;
     }
 
+    /**
+     * The scheduler will prefer to schedule pods to nodes that satisfy the anti-affinity expressions specified by this field, but it may choose a node that violates one or more of the expressions. The node that is most preferred is the one with the greatest sum of weights, i.e. for each node that meets all of the scheduling requirements (resource request, requiredDuringScheduling anti-affinity expressions, etc.), compute a sum by iterating through the elements of this field and adding "weight" to the sum if the node has pods which matches the corresponding podAffinityTerm; the node(s) with the highest sum are the most preferred.
+     */
     @JsonProperty("preferredDuringSchedulingIgnoredDuringExecution")
     public void setPreferredDuringSchedulingIgnoredDuringExecution(List<WeightedPodAffinityTerm> preferredDuringSchedulingIgnoredDuringExecution) {
         this.preferredDuringSchedulingIgnoredDuringExecution = preferredDuringSchedulingIgnoredDuringExecution;
     }
 
+    /**
+     * If the anti-affinity requirements specified by this field are not met at scheduling time, the pod will not be scheduled onto the node. If the anti-affinity requirements specified by this field cease to be met at some point during pod execution (e.g. due to a pod label update), the system may or may not try to eventually evict the pod from its node. When there are multiple elements, the lists of nodes corresponding to each podAffinityTerm are intersected, i.e. all terms must be satisfied.
+     */
     @JsonProperty("requiredDuringSchedulingIgnoredDuringExecution")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PodAffinityTerm> getRequiredDuringSchedulingIgnoredDuringExecution() {
         return requiredDuringSchedulingIgnoredDuringExecution;
     }
 
+    /**
+     * If the anti-affinity requirements specified by this field are not met at scheduling time, the pod will not be scheduled onto the node. If the anti-affinity requirements specified by this field cease to be met at some point during pod execution (e.g. due to a pod label update), the system may or may not try to eventually evict the pod from its node. When there are multiple elements, the lists of nodes corresponding to each podAffinityTerm are intersected, i.e. all terms must be satisfied.
+     */
     @JsonProperty("requiredDuringSchedulingIgnoredDuringExecution")
     public void setRequiredDuringSchedulingIgnoredDuringExecution(List<PodAffinityTerm> requiredDuringSchedulingIgnoredDuringExecution) {
         this.requiredDuringSchedulingIgnoredDuringExecution = requiredDuringSchedulingIgnoredDuringExecution;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodCondition.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodCondition.java
index 78e1eba1a7a..c50c402d924 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodCondition.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodCondition contains details for the current condition of this pod.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -69,61 +72,97 @@ public PodCondition(String lastProbeTime, String lastTransitionTime, String mess
         this.type = type;
     }
 
+    /**
+     * PodCondition contains details for the current condition of this pod.
+     */
     @JsonProperty("lastProbeTime")
     public String getLastProbeTime() {
         return lastProbeTime;
     }
 
+    /**
+     * PodCondition contains details for the current condition of this pod.
+     */
     @JsonProperty("lastProbeTime")
     public void setLastProbeTime(String lastProbeTime) {
         this.lastProbeTime = lastProbeTime;
     }
 
+    /**
+     * PodCondition contains details for the current condition of this pod.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * PodCondition contains details for the current condition of this pod.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status is the status of the condition. Can be True, False, Unknown. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-conditions
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status is the status of the condition. Can be True, False, Unknown. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-conditions
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type is the type of the condition. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-conditions
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of the condition. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-conditions
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodDNSConfig.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodDNSConfig.java
index baddf4d8540..1b6f662e405 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodDNSConfig.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodDNSConfig.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodDNSConfig defines the DNS parameters of a pod in addition to those generated from DNSPolicy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -62,34 +65,52 @@ public PodDNSConfig(List<String> nameservers, List<PodDNSConfigOption> options,
         this.searches = searches;
     }
 
+    /**
+     * A list of DNS name server IP addresses. This will be appended to the base nameservers generated from DNSPolicy. Duplicated nameservers will be removed.
+     */
     @JsonProperty("nameservers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNameservers() {
         return nameservers;
     }
 
+    /**
+     * A list of DNS name server IP addresses. This will be appended to the base nameservers generated from DNSPolicy. Duplicated nameservers will be removed.
+     */
     @JsonProperty("nameservers")
     public void setNameservers(List<String> nameservers) {
         this.nameservers = nameservers;
     }
 
+    /**
+     * A list of DNS resolver options. This will be merged with the base options generated from DNSPolicy. Duplicated entries will be removed. Resolution options given in Options will override those that appear in the base DNSPolicy.
+     */
     @JsonProperty("options")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PodDNSConfigOption> getOptions() {
         return options;
     }
 
+    /**
+     * A list of DNS resolver options. This will be merged with the base options generated from DNSPolicy. Duplicated entries will be removed. Resolution options given in Options will override those that appear in the base DNSPolicy.
+     */
     @JsonProperty("options")
     public void setOptions(List<PodDNSConfigOption> options) {
         this.options = options;
     }
 
+    /**
+     * A list of DNS search domains for host-name lookup. This will be appended to the base search paths generated from DNSPolicy. Duplicated search paths will be removed.
+     */
     @JsonProperty("searches")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSearches() {
         return searches;
     }
 
+    /**
+     * A list of DNS search domains for host-name lookup. This will be appended to the base search paths generated from DNSPolicy. Duplicated search paths will be removed.
+     */
     @JsonProperty("searches")
     public void setSearches(List<String> searches) {
         this.searches = searches;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodDNSConfigOption.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodDNSConfigOption.java
index 8778e878e83..055c523bbad 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodDNSConfigOption.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodDNSConfigOption.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodDNSConfigOption defines DNS resolver options of a pod.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public PodDNSConfigOption(String name, String value) {
         this.value = value;
     }
 
+    /**
+     * Name is this DNS resolver option's name. Required.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is this DNS resolver option's name. Required.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Value is this DNS resolver option's value.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is this DNS resolver option's value.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodExecOptions.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodExecOptions.java
index 8ce487d4439..c278432daeb 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodExecOptions.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodExecOptions.java
@@ -51,9 +51,6 @@
 public class PodExecOptions implements Editable<PodExecOptionsBuilder>, KubernetesResource
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("command")
@@ -61,9 +58,6 @@ public class PodExecOptions implements Editable<PodExecOptionsBuilder>, Kubernet
     private List<String> command = new ArrayList<>();
     @JsonProperty("container")
     private String container;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodExecOptions";
     @JsonProperty("stderr")
@@ -95,17 +89,11 @@ public PodExecOptions(String apiVersion, List<String> command, String container,
         this.tty = tty;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
@@ -132,17 +120,11 @@ public void setContainer(String container) {
         this.container = container;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodIP.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodIP.java
index b02fcaf54bc..acfaf039749 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodIP.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodIP.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodIP represents a single IP address allocated to the pod.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -49,11 +52,17 @@ public PodIP(String ip) {
         this.ip = ip;
     }
 
+    /**
+     * IP is the IP address assigned to the pod
+     */
     @JsonProperty("ip")
     public String getIp() {
         return ip;
     }
 
+    /**
+     * IP is the IP address assigned to the pod
+     */
     @JsonProperty("ip")
     public void setIp(String ip) {
         this.ip = ip;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodList.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodList.java
index 5be3837bd60..edaf2f18c68 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodList.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodList.java
@@ -23,6 +23,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodList is a list of Pods.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -47,17 +50,11 @@
 public class PodList implements Editable<PodListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.Pod>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.Pod> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodList";
     @JsonProperty("metadata")
@@ -80,7 +77,7 @@ public PodList(String apiVersion, List<io.fabric8.kubernetes.api.model.Pod> item
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -88,26 +85,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of pods. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.Pod> getItems() {
         return items;
     }
 
+    /**
+     * List of pods. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.Pod> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -115,18 +118,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodList is a list of Pods.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodList is a list of Pods.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodOS.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodOS.java
index 49ffbb82931..69d02fa0952 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodOS.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodOS.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodOS defines the OS parameters of a pod.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -49,11 +52,17 @@ public PodOS(String name) {
         this.name = name;
     }
 
+    /**
+     * Name is the name of the operating system. The currently supported values are linux and windows. Additional value may be defined in future and can be one of: https://github.com/opencontainers/runtime-spec/blob/master/config.md#platform-specific-configuration Clients should expect to handle additional values and treat unrecognized values in this field as os: null
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the operating system. The currently supported values are linux and windows. Additional value may be defined in future and can be one of: https://github.com/opencontainers/runtime-spec/blob/master/config.md#platform-specific-configuration Clients should expect to handle additional values and treat unrecognized values in this field as os: null
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodReadinessGate.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodReadinessGate.java
index f9790bf5513..b753849d8ad 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodReadinessGate.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodReadinessGate.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodReadinessGate contains the reference to a pod condition
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -49,11 +52,17 @@ public PodReadinessGate(String conditionType) {
         this.conditionType = conditionType;
     }
 
+    /**
+     * ConditionType refers to a condition in the pod's condition list with matching type.
+     */
     @JsonProperty("conditionType")
     public String getConditionType() {
         return conditionType;
     }
 
+    /**
+     * ConditionType refers to a condition in the pod's condition list with matching type.
+     */
     @JsonProperty("conditionType")
     public void setConditionType(String conditionType) {
         this.conditionType = conditionType;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodResourceClaim.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodResourceClaim.java
index e47920004c9..409fdab3fcf 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodResourceClaim.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodResourceClaim.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodResourceClaim references exactly one ResourceClaim, either directly or by naming a ResourceClaimTemplate which is then turned into a ResourceClaim for the pod.<br><p> <br><p> It adds a name to it that uniquely identifies the ResourceClaim inside the Pod. Containers that need access to the ResourceClaim reference it with this name.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -57,31 +60,49 @@ public PodResourceClaim(String name, String resourceClaimName, String resourceCl
         this.resourceClaimTemplateName = resourceClaimTemplateName;
     }
 
+    /**
+     * Name uniquely identifies this resource claim inside the pod. This must be a DNS_LABEL.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name uniquely identifies this resource claim inside the pod. This must be a DNS_LABEL.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * ResourceClaimName is the name of a ResourceClaim object in the same namespace as this pod.<br><p> <br><p> Exactly one of ResourceClaimName and ResourceClaimTemplateName must be set.
+     */
     @JsonProperty("resourceClaimName")
     public String getResourceClaimName() {
         return resourceClaimName;
     }
 
+    /**
+     * ResourceClaimName is the name of a ResourceClaim object in the same namespace as this pod.<br><p> <br><p> Exactly one of ResourceClaimName and ResourceClaimTemplateName must be set.
+     */
     @JsonProperty("resourceClaimName")
     public void setResourceClaimName(String resourceClaimName) {
         this.resourceClaimName = resourceClaimName;
     }
 
+    /**
+     * ResourceClaimTemplateName is the name of a ResourceClaimTemplate object in the same namespace as this pod.<br><p> <br><p> The template will be used to create a new ResourceClaim, which will be bound to this pod. When this pod is deleted, the ResourceClaim will also be deleted. The pod name and resource name, along with a generated component, will be used to form a unique name for the ResourceClaim, which will be recorded in pod.status.resourceClaimStatuses.<br><p> <br><p> This field is immutable and no changes will be made to the corresponding ResourceClaim by the control plane after creating the ResourceClaim.<br><p> <br><p> Exactly one of ResourceClaimName and ResourceClaimTemplateName must be set.
+     */
     @JsonProperty("resourceClaimTemplateName")
     public String getResourceClaimTemplateName() {
         return resourceClaimTemplateName;
     }
 
+    /**
+     * ResourceClaimTemplateName is the name of a ResourceClaimTemplate object in the same namespace as this pod.<br><p> <br><p> The template will be used to create a new ResourceClaim, which will be bound to this pod. When this pod is deleted, the ResourceClaim will also be deleted. The pod name and resource name, along with a generated component, will be used to form a unique name for the ResourceClaim, which will be recorded in pod.status.resourceClaimStatuses.<br><p> <br><p> This field is immutable and no changes will be made to the corresponding ResourceClaim by the control plane after creating the ResourceClaim.<br><p> <br><p> Exactly one of ResourceClaimName and ResourceClaimTemplateName must be set.
+     */
     @JsonProperty("resourceClaimTemplateName")
     public void setResourceClaimTemplateName(String resourceClaimTemplateName) {
         this.resourceClaimTemplateName = resourceClaimTemplateName;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodResourceClaimStatus.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodResourceClaimStatus.java
index aaa9f7ad280..5bb29330278 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodResourceClaimStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodResourceClaimStatus.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodResourceClaimStatus is stored in the PodStatus for each PodResourceClaim which references a ResourceClaimTemplate. It stores the generated name for the corresponding ResourceClaim.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public PodResourceClaimStatus(String name, String resourceClaimName) {
         this.resourceClaimName = resourceClaimName;
     }
 
+    /**
+     * Name uniquely identifies this resource claim inside the pod. This must match the name of an entry in pod.spec.resourceClaims, which implies that the string must be a DNS_LABEL.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name uniquely identifies this resource claim inside the pod. This must match the name of an entry in pod.spec.resourceClaims, which implies that the string must be a DNS_LABEL.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * ResourceClaimName is the name of the ResourceClaim that was generated for the Pod in the namespace of the Pod. If this is unset, then generating a ResourceClaim was not necessary. The pod.spec.resourceClaims entry can be ignored in this case.
+     */
     @JsonProperty("resourceClaimName")
     public String getResourceClaimName() {
         return resourceClaimName;
     }
 
+    /**
+     * ResourceClaimName is the name of the ResourceClaim that was generated for the Pod in the namespace of the Pod. If this is unset, then generating a ResourceClaim was not necessary. The pod.spec.resourceClaims entry can be ignored in this case.
+     */
     @JsonProperty("resourceClaimName")
     public void setResourceClaimName(String resourceClaimName) {
         this.resourceClaimName = resourceClaimName;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodSchedulingGate.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodSchedulingGate.java
index f3757100eb2..ecb4fcba999 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodSchedulingGate.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodSchedulingGate.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodSchedulingGate is associated to a Pod to guard its scheduling.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -49,11 +52,17 @@ public PodSchedulingGate(String name) {
         this.name = name;
     }
 
+    /**
+     * Name of the scheduling gate. Each scheduling gate must have a unique name field.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the scheduling gate. Each scheduling gate must have a unique name field.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodSecurityContext.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodSecurityContext.java
index f979bda5d42..8ef897f3eea 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodSecurityContext.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodSecurityContext.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodSecurityContext holds pod-level security attributes and common container settings. Some fields are also present in container.securityContext.  Field values of container.securityContext take precedence over field values of PodSecurityContext.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,133 +104,211 @@ public PodSecurityContext(AppArmorProfile appArmorProfile, Long fsGroup, String
         this.windowsOptions = windowsOptions;
     }
 
+    /**
+     * PodSecurityContext holds pod-level security attributes and common container settings. Some fields are also present in container.securityContext.  Field values of container.securityContext take precedence over field values of PodSecurityContext.
+     */
     @JsonProperty("appArmorProfile")
     public AppArmorProfile getAppArmorProfile() {
         return appArmorProfile;
     }
 
+    /**
+     * PodSecurityContext holds pod-level security attributes and common container settings. Some fields are also present in container.securityContext.  Field values of container.securityContext take precedence over field values of PodSecurityContext.
+     */
     @JsonProperty("appArmorProfile")
     public void setAppArmorProfile(AppArmorProfile appArmorProfile) {
         this.appArmorProfile = appArmorProfile;
     }
 
+    /**
+     * A special supplemental group that applies to all containers in a pod. Some volume types allow the Kubelet to change the ownership of that volume to be owned by the pod:<br><p> <br><p> 1. The owning GID will be the FSGroup 2. The setgid bit is set (new files created in the volume will be owned by FSGroup) 3. The permission bits are OR'd with rw-rw----<br><p> <br><p> If unset, the Kubelet will not modify the ownership and permissions of any volume. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("fsGroup")
     public Long getFsGroup() {
         return fsGroup;
     }
 
+    /**
+     * A special supplemental group that applies to all containers in a pod. Some volume types allow the Kubelet to change the ownership of that volume to be owned by the pod:<br><p> <br><p> 1. The owning GID will be the FSGroup 2. The setgid bit is set (new files created in the volume will be owned by FSGroup) 3. The permission bits are OR'd with rw-rw----<br><p> <br><p> If unset, the Kubelet will not modify the ownership and permissions of any volume. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("fsGroup")
     public void setFsGroup(Long fsGroup) {
         this.fsGroup = fsGroup;
     }
 
+    /**
+     * fsGroupChangePolicy defines behavior of changing ownership and permission of the volume before being exposed inside Pod. This field will only apply to volume types which support fsGroup based ownership(and permissions). It will have no effect on ephemeral volume types such as: secret, configmaps and emptydir. Valid values are "OnRootMismatch" and "Always". If not specified, "Always" is used. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("fsGroupChangePolicy")
     public String getFsGroupChangePolicy() {
         return fsGroupChangePolicy;
     }
 
+    /**
+     * fsGroupChangePolicy defines behavior of changing ownership and permission of the volume before being exposed inside Pod. This field will only apply to volume types which support fsGroup based ownership(and permissions). It will have no effect on ephemeral volume types such as: secret, configmaps and emptydir. Valid values are "OnRootMismatch" and "Always". If not specified, "Always" is used. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("fsGroupChangePolicy")
     public void setFsGroupChangePolicy(String fsGroupChangePolicy) {
         this.fsGroupChangePolicy = fsGroupChangePolicy;
     }
 
+    /**
+     * The GID to run the entrypoint of the container process. Uses runtime default if unset. May also be set in SecurityContext.  If set in both SecurityContext and PodSecurityContext, the value specified in SecurityContext takes precedence for that container. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("runAsGroup")
     public Long getRunAsGroup() {
         return runAsGroup;
     }
 
+    /**
+     * The GID to run the entrypoint of the container process. Uses runtime default if unset. May also be set in SecurityContext.  If set in both SecurityContext and PodSecurityContext, the value specified in SecurityContext takes precedence for that container. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("runAsGroup")
     public void setRunAsGroup(Long runAsGroup) {
         this.runAsGroup = runAsGroup;
     }
 
+    /**
+     * Indicates that the container must run as a non-root user. If true, the Kubelet will validate the image at runtime to ensure that it does not run as UID 0 (root) and fail to start the container if it does. If unset or false, no such validation will be performed. May also be set in SecurityContext.  If set in both SecurityContext and PodSecurityContext, the value specified in SecurityContext takes precedence.
+     */
     @JsonProperty("runAsNonRoot")
     public Boolean getRunAsNonRoot() {
         return runAsNonRoot;
     }
 
+    /**
+     * Indicates that the container must run as a non-root user. If true, the Kubelet will validate the image at runtime to ensure that it does not run as UID 0 (root) and fail to start the container if it does. If unset or false, no such validation will be performed. May also be set in SecurityContext.  If set in both SecurityContext and PodSecurityContext, the value specified in SecurityContext takes precedence.
+     */
     @JsonProperty("runAsNonRoot")
     public void setRunAsNonRoot(Boolean runAsNonRoot) {
         this.runAsNonRoot = runAsNonRoot;
     }
 
+    /**
+     * The UID to run the entrypoint of the container process. Defaults to user specified in image metadata if unspecified. May also be set in SecurityContext.  If set in both SecurityContext and PodSecurityContext, the value specified in SecurityContext takes precedence for that container. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("runAsUser")
     public Long getRunAsUser() {
         return runAsUser;
     }
 
+    /**
+     * The UID to run the entrypoint of the container process. Defaults to user specified in image metadata if unspecified. May also be set in SecurityContext.  If set in both SecurityContext and PodSecurityContext, the value specified in SecurityContext takes precedence for that container. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("runAsUser")
     public void setRunAsUser(Long runAsUser) {
         this.runAsUser = runAsUser;
     }
 
+    /**
+     * seLinuxChangePolicy defines how the container's SELinux label is applied to all volumes used by the Pod. It has no effect on nodes that do not support SELinux or to volumes does not support SELinux. Valid values are "MountOption" and "Recursive".<br><p> <br><p> "Recursive" means relabeling of all files on all Pod volumes by the container runtime. This may be slow for large volumes, but allows mixing privileged and unprivileged Pods sharing the same volume on the same node.<br><p> <br><p> "MountOption" mounts all eligible Pod volumes with `-o context` mount option. This requires all Pods that share the same volume to use the same SELinux label. It is not possible to share the same volume among privileged and unprivileged Pods. Eligible volumes are in-tree FibreChannel and iSCSI volumes, and all CSI volumes whose CSI driver announces SELinux support by setting spec.seLinuxMount: true in their CSIDriver instance. Other volumes are always re-labelled recursively. "MountOption" value is allowed only when SELinuxMount feature gate is enabled.<br><p> <br><p> If not specified and SELinuxMount feature gate is enabled, "MountOption" is used. If not specified and SELinuxMount feature gate is disabled, "MountOption" is used for ReadWriteOncePod volumes and "Recursive" for all other volumes.<br><p> <br><p> This field affects only Pods that have SELinux label set, either in PodSecurityContext or in SecurityContext of all containers.<br><p> <br><p> All Pods that use the same volume should use the same seLinuxChangePolicy, otherwise some pods can get stuck in ContainerCreating state. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("seLinuxChangePolicy")
     public String getSeLinuxChangePolicy() {
         return seLinuxChangePolicy;
     }
 
+    /**
+     * seLinuxChangePolicy defines how the container's SELinux label is applied to all volumes used by the Pod. It has no effect on nodes that do not support SELinux or to volumes does not support SELinux. Valid values are "MountOption" and "Recursive".<br><p> <br><p> "Recursive" means relabeling of all files on all Pod volumes by the container runtime. This may be slow for large volumes, but allows mixing privileged and unprivileged Pods sharing the same volume on the same node.<br><p> <br><p> "MountOption" mounts all eligible Pod volumes with `-o context` mount option. This requires all Pods that share the same volume to use the same SELinux label. It is not possible to share the same volume among privileged and unprivileged Pods. Eligible volumes are in-tree FibreChannel and iSCSI volumes, and all CSI volumes whose CSI driver announces SELinux support by setting spec.seLinuxMount: true in their CSIDriver instance. Other volumes are always re-labelled recursively. "MountOption" value is allowed only when SELinuxMount feature gate is enabled.<br><p> <br><p> If not specified and SELinuxMount feature gate is enabled, "MountOption" is used. If not specified and SELinuxMount feature gate is disabled, "MountOption" is used for ReadWriteOncePod volumes and "Recursive" for all other volumes.<br><p> <br><p> This field affects only Pods that have SELinux label set, either in PodSecurityContext or in SecurityContext of all containers.<br><p> <br><p> All Pods that use the same volume should use the same seLinuxChangePolicy, otherwise some pods can get stuck in ContainerCreating state. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("seLinuxChangePolicy")
     public void setSeLinuxChangePolicy(String seLinuxChangePolicy) {
         this.seLinuxChangePolicy = seLinuxChangePolicy;
     }
 
+    /**
+     * PodSecurityContext holds pod-level security attributes and common container settings. Some fields are also present in container.securityContext.  Field values of container.securityContext take precedence over field values of PodSecurityContext.
+     */
     @JsonProperty("seLinuxOptions")
     public SELinuxOptions getSeLinuxOptions() {
         return seLinuxOptions;
     }
 
+    /**
+     * PodSecurityContext holds pod-level security attributes and common container settings. Some fields are also present in container.securityContext.  Field values of container.securityContext take precedence over field values of PodSecurityContext.
+     */
     @JsonProperty("seLinuxOptions")
     public void setSeLinuxOptions(SELinuxOptions seLinuxOptions) {
         this.seLinuxOptions = seLinuxOptions;
     }
 
+    /**
+     * PodSecurityContext holds pod-level security attributes and common container settings. Some fields are also present in container.securityContext.  Field values of container.securityContext take precedence over field values of PodSecurityContext.
+     */
     @JsonProperty("seccompProfile")
     public SeccompProfile getSeccompProfile() {
         return seccompProfile;
     }
 
+    /**
+     * PodSecurityContext holds pod-level security attributes and common container settings. Some fields are also present in container.securityContext.  Field values of container.securityContext take precedence over field values of PodSecurityContext.
+     */
     @JsonProperty("seccompProfile")
     public void setSeccompProfile(SeccompProfile seccompProfile) {
         this.seccompProfile = seccompProfile;
     }
 
+    /**
+     * A list of groups applied to the first process run in each container, in addition to the container's primary GID and fsGroup (if specified).  If the SupplementalGroupsPolicy feature is enabled, the supplementalGroupsPolicy field determines whether these are in addition to or instead of any group memberships defined in the container image. If unspecified, no additional groups are added, though group memberships defined in the container image may still be used, depending on the supplementalGroupsPolicy field. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("supplementalGroups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Long> getSupplementalGroups() {
         return supplementalGroups;
     }
 
+    /**
+     * A list of groups applied to the first process run in each container, in addition to the container's primary GID and fsGroup (if specified).  If the SupplementalGroupsPolicy feature is enabled, the supplementalGroupsPolicy field determines whether these are in addition to or instead of any group memberships defined in the container image. If unspecified, no additional groups are added, though group memberships defined in the container image may still be used, depending on the supplementalGroupsPolicy field. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("supplementalGroups")
     public void setSupplementalGroups(List<Long> supplementalGroups) {
         this.supplementalGroups = supplementalGroups;
     }
 
+    /**
+     * Defines how supplemental groups of the first container processes are calculated. Valid values are "Merge" and "Strict". If not specified, "Merge" is used. (Alpha) Using the field requires the SupplementalGroupsPolicy feature gate to be enabled and the container runtime must implement support for this feature. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("supplementalGroupsPolicy")
     public String getSupplementalGroupsPolicy() {
         return supplementalGroupsPolicy;
     }
 
+    /**
+     * Defines how supplemental groups of the first container processes are calculated. Valid values are "Merge" and "Strict". If not specified, "Merge" is used. (Alpha) Using the field requires the SupplementalGroupsPolicy feature gate to be enabled and the container runtime must implement support for this feature. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("supplementalGroupsPolicy")
     public void setSupplementalGroupsPolicy(String supplementalGroupsPolicy) {
         this.supplementalGroupsPolicy = supplementalGroupsPolicy;
     }
 
+    /**
+     * Sysctls hold a list of namespaced sysctls used for the pod. Pods with unsupported sysctls (by the container runtime) might fail to launch. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("sysctls")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Sysctl> getSysctls() {
         return sysctls;
     }
 
+    /**
+     * Sysctls hold a list of namespaced sysctls used for the pod. Pods with unsupported sysctls (by the container runtime) might fail to launch. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("sysctls")
     public void setSysctls(List<Sysctl> sysctls) {
         this.sysctls = sysctls;
     }
 
+    /**
+     * PodSecurityContext holds pod-level security attributes and common container settings. Some fields are also present in container.securityContext.  Field values of container.securityContext take precedence over field values of PodSecurityContext.
+     */
     @JsonProperty("windowsOptions")
     public WindowsSecurityContextOptions getWindowsOptions() {
         return windowsOptions;
     }
 
+    /**
+     * PodSecurityContext holds pod-level security attributes and common container settings. Some fields are also present in container.securityContext.  Field values of container.securityContext take precedence over field values of PodSecurityContext.
+     */
     @JsonProperty("windowsOptions")
     public void setWindowsOptions(WindowsSecurityContextOptions windowsOptions) {
         this.windowsOptions = windowsOptions;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodSpec.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodSpec.java
index b6e2591e567..f83593e1346 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodSpec.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodSpec is a description of a pod.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -220,414 +223,654 @@ public PodSpec(Long activeDeadlineSeconds, Affinity affinity, Boolean automountS
         this.volumes = volumes;
     }
 
+    /**
+     * Optional duration in seconds the pod may be active on the node relative to StartTime before the system will actively try to mark it failed and kill associated containers. Value must be a positive integer.
+     */
     @JsonProperty("activeDeadlineSeconds")
     public Long getActiveDeadlineSeconds() {
         return activeDeadlineSeconds;
     }
 
+    /**
+     * Optional duration in seconds the pod may be active on the node relative to StartTime before the system will actively try to mark it failed and kill associated containers. Value must be a positive integer.
+     */
     @JsonProperty("activeDeadlineSeconds")
     public void setActiveDeadlineSeconds(Long activeDeadlineSeconds) {
         this.activeDeadlineSeconds = activeDeadlineSeconds;
     }
 
+    /**
+     * PodSpec is a description of a pod.
+     */
     @JsonProperty("affinity")
     public Affinity getAffinity() {
         return affinity;
     }
 
+    /**
+     * PodSpec is a description of a pod.
+     */
     @JsonProperty("affinity")
     public void setAffinity(Affinity affinity) {
         this.affinity = affinity;
     }
 
+    /**
+     * AutomountServiceAccountToken indicates whether a service account token should be automatically mounted.
+     */
     @JsonProperty("automountServiceAccountToken")
     public Boolean getAutomountServiceAccountToken() {
         return automountServiceAccountToken;
     }
 
+    /**
+     * AutomountServiceAccountToken indicates whether a service account token should be automatically mounted.
+     */
     @JsonProperty("automountServiceAccountToken")
     public void setAutomountServiceAccountToken(Boolean automountServiceAccountToken) {
         this.automountServiceAccountToken = automountServiceAccountToken;
     }
 
+    /**
+     * List of containers belonging to the pod. Containers cannot currently be added or removed. There must be at least one container in a Pod. Cannot be updated.
+     */
     @JsonProperty("containers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Container> getContainers() {
         return containers;
     }
 
+    /**
+     * List of containers belonging to the pod. Containers cannot currently be added or removed. There must be at least one container in a Pod. Cannot be updated.
+     */
     @JsonProperty("containers")
     public void setContainers(List<Container> containers) {
         this.containers = containers;
     }
 
+    /**
+     * PodSpec is a description of a pod.
+     */
     @JsonProperty("dnsConfig")
     public PodDNSConfig getDnsConfig() {
         return dnsConfig;
     }
 
+    /**
+     * PodSpec is a description of a pod.
+     */
     @JsonProperty("dnsConfig")
     public void setDnsConfig(PodDNSConfig dnsConfig) {
         this.dnsConfig = dnsConfig;
     }
 
+    /**
+     * Set DNS policy for the pod. Defaults to "ClusterFirst". Valid values are 'ClusterFirstWithHostNet', 'ClusterFirst', 'Default' or 'None'. DNS parameters given in DNSConfig will be merged with the policy selected with DNSPolicy. To have DNS options set along with hostNetwork, you have to specify DNS policy explicitly to 'ClusterFirstWithHostNet'.
+     */
     @JsonProperty("dnsPolicy")
     public String getDnsPolicy() {
         return dnsPolicy;
     }
 
+    /**
+     * Set DNS policy for the pod. Defaults to "ClusterFirst". Valid values are 'ClusterFirstWithHostNet', 'ClusterFirst', 'Default' or 'None'. DNS parameters given in DNSConfig will be merged with the policy selected with DNSPolicy. To have DNS options set along with hostNetwork, you have to specify DNS policy explicitly to 'ClusterFirstWithHostNet'.
+     */
     @JsonProperty("dnsPolicy")
     public void setDnsPolicy(String dnsPolicy) {
         this.dnsPolicy = dnsPolicy;
     }
 
+    /**
+     * EnableServiceLinks indicates whether information about services should be injected into pod's environment variables, matching the syntax of Docker links. Optional: Defaults to true.
+     */
     @JsonProperty("enableServiceLinks")
     public Boolean getEnableServiceLinks() {
         return enableServiceLinks;
     }
 
+    /**
+     * EnableServiceLinks indicates whether information about services should be injected into pod's environment variables, matching the syntax of Docker links. Optional: Defaults to true.
+     */
     @JsonProperty("enableServiceLinks")
     public void setEnableServiceLinks(Boolean enableServiceLinks) {
         this.enableServiceLinks = enableServiceLinks;
     }
 
+    /**
+     * List of ephemeral containers run in this pod. Ephemeral containers may be run in an existing pod to perform user-initiated actions such as debugging. This list cannot be specified when creating a pod, and it cannot be modified by updating the pod spec. In order to add an ephemeral container to an existing pod, use the pod's ephemeralcontainers subresource.
+     */
     @JsonProperty("ephemeralContainers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EphemeralContainer> getEphemeralContainers() {
         return ephemeralContainers;
     }
 
+    /**
+     * List of ephemeral containers run in this pod. Ephemeral containers may be run in an existing pod to perform user-initiated actions such as debugging. This list cannot be specified when creating a pod, and it cannot be modified by updating the pod spec. In order to add an ephemeral container to an existing pod, use the pod's ephemeralcontainers subresource.
+     */
     @JsonProperty("ephemeralContainers")
     public void setEphemeralContainers(List<EphemeralContainer> ephemeralContainers) {
         this.ephemeralContainers = ephemeralContainers;
     }
 
+    /**
+     * HostAliases is an optional list of hosts and IPs that will be injected into the pod's hosts file if specified.
+     */
     @JsonProperty("hostAliases")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HostAlias> getHostAliases() {
         return hostAliases;
     }
 
+    /**
+     * HostAliases is an optional list of hosts and IPs that will be injected into the pod's hosts file if specified.
+     */
     @JsonProperty("hostAliases")
     public void setHostAliases(List<HostAlias> hostAliases) {
         this.hostAliases = hostAliases;
     }
 
+    /**
+     * Use the host's ipc namespace. Optional: Default to false.
+     */
     @JsonProperty("hostIPC")
     public Boolean getHostIPC() {
         return hostIPC;
     }
 
+    /**
+     * Use the host's ipc namespace. Optional: Default to false.
+     */
     @JsonProperty("hostIPC")
     public void setHostIPC(Boolean hostIPC) {
         this.hostIPC = hostIPC;
     }
 
+    /**
+     * Host networking requested for this pod. Use the host's network namespace. If this option is set, the ports that will be used must be specified. Default to false.
+     */
     @JsonProperty("hostNetwork")
     public Boolean getHostNetwork() {
         return hostNetwork;
     }
 
+    /**
+     * Host networking requested for this pod. Use the host's network namespace. If this option is set, the ports that will be used must be specified. Default to false.
+     */
     @JsonProperty("hostNetwork")
     public void setHostNetwork(Boolean hostNetwork) {
         this.hostNetwork = hostNetwork;
     }
 
+    /**
+     * Use the host's pid namespace. Optional: Default to false.
+     */
     @JsonProperty("hostPID")
     public Boolean getHostPID() {
         return hostPID;
     }
 
+    /**
+     * Use the host's pid namespace. Optional: Default to false.
+     */
     @JsonProperty("hostPID")
     public void setHostPID(Boolean hostPID) {
         this.hostPID = hostPID;
     }
 
+    /**
+     * Use the host's user namespace. Optional: Default to true. If set to true or not present, the pod will be run in the host user namespace, useful for when the pod needs a feature only available to the host user namespace, such as loading a kernel module with CAP_SYS_MODULE. When set to false, a new userns is created for the pod. Setting false is useful for mitigating container breakout vulnerabilities even allowing users to run their containers as root without actually having root privileges on the host. This field is alpha-level and is only honored by servers that enable the UserNamespacesSupport feature.
+     */
     @JsonProperty("hostUsers")
     public Boolean getHostUsers() {
         return hostUsers;
     }
 
+    /**
+     * Use the host's user namespace. Optional: Default to true. If set to true or not present, the pod will be run in the host user namespace, useful for when the pod needs a feature only available to the host user namespace, such as loading a kernel module with CAP_SYS_MODULE. When set to false, a new userns is created for the pod. Setting false is useful for mitigating container breakout vulnerabilities even allowing users to run their containers as root without actually having root privileges on the host. This field is alpha-level and is only honored by servers that enable the UserNamespacesSupport feature.
+     */
     @JsonProperty("hostUsers")
     public void setHostUsers(Boolean hostUsers) {
         this.hostUsers = hostUsers;
     }
 
+    /**
+     * Specifies the hostname of the Pod If not specified, the pod's hostname will be set to a system-defined value.
+     */
     @JsonProperty("hostname")
     public String getHostname() {
         return hostname;
     }
 
+    /**
+     * Specifies the hostname of the Pod If not specified, the pod's hostname will be set to a system-defined value.
+     */
     @JsonProperty("hostname")
     public void setHostname(String hostname) {
         this.hostname = hostname;
     }
 
+    /**
+     * ImagePullSecrets is an optional list of references to secrets in the same namespace to use for pulling any of the images used by this PodSpec. If specified, these secrets will be passed to individual puller implementations for them to use. More info: https://kubernetes.io/docs/concepts/containers/images#specifying-imagepullsecrets-on-a-pod
+     */
     @JsonProperty("imagePullSecrets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LocalObjectReference> getImagePullSecrets() {
         return imagePullSecrets;
     }
 
+    /**
+     * ImagePullSecrets is an optional list of references to secrets in the same namespace to use for pulling any of the images used by this PodSpec. If specified, these secrets will be passed to individual puller implementations for them to use. More info: https://kubernetes.io/docs/concepts/containers/images#specifying-imagepullsecrets-on-a-pod
+     */
     @JsonProperty("imagePullSecrets")
     public void setImagePullSecrets(List<LocalObjectReference> imagePullSecrets) {
         this.imagePullSecrets = imagePullSecrets;
     }
 
+    /**
+     * List of initialization containers belonging to the pod. Init containers are executed in order prior to containers being started. If any init container fails, the pod is considered to have failed and is handled according to its restartPolicy. The name for an init container or normal container must be unique among all containers. Init containers may not have Lifecycle actions, Readiness probes, Liveness probes, or Startup probes. The resourceRequirements of an init container are taken into account during scheduling by finding the highest request/limit for each resource type, and then using the max of of that value or the sum of the normal containers. Limits are applied to init containers in a similar fashion. Init containers cannot currently be added or removed. Cannot be updated. More info: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/
+     */
     @JsonProperty("initContainers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Container> getInitContainers() {
         return initContainers;
     }
 
+    /**
+     * List of initialization containers belonging to the pod. Init containers are executed in order prior to containers being started. If any init container fails, the pod is considered to have failed and is handled according to its restartPolicy. The name for an init container or normal container must be unique among all containers. Init containers may not have Lifecycle actions, Readiness probes, Liveness probes, or Startup probes. The resourceRequirements of an init container are taken into account during scheduling by finding the highest request/limit for each resource type, and then using the max of of that value or the sum of the normal containers. Limits are applied to init containers in a similar fashion. Init containers cannot currently be added or removed. Cannot be updated. More info: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/
+     */
     @JsonProperty("initContainers")
     public void setInitContainers(List<Container> initContainers) {
         this.initContainers = initContainers;
     }
 
+    /**
+     * NodeName indicates in which node this pod is scheduled. If empty, this pod is a candidate for scheduling by the scheduler defined in schedulerName. Once this field is set, the kubelet for this node becomes responsible for the lifecycle of this pod. This field should not be used to express a desire for the pod to be scheduled on a specific node. https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/#nodename
+     */
     @JsonProperty("nodeName")
     public String getNodeName() {
         return nodeName;
     }
 
+    /**
+     * NodeName indicates in which node this pod is scheduled. If empty, this pod is a candidate for scheduling by the scheduler defined in schedulerName. Once this field is set, the kubelet for this node becomes responsible for the lifecycle of this pod. This field should not be used to express a desire for the pod to be scheduled on a specific node. https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/#nodename
+     */
     @JsonProperty("nodeName")
     public void setNodeName(String nodeName) {
         this.nodeName = nodeName;
     }
 
+    /**
+     * NodeSelector is a selector which must be true for the pod to fit on a node. Selector which must match a node's labels for the pod to be scheduled on that node. More info: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * NodeSelector is a selector which must be true for the pod to fit on a node. Selector which must match a node's labels for the pod to be scheduled on that node. More info: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * PodSpec is a description of a pod.
+     */
     @JsonProperty("os")
     public PodOS getOs() {
         return os;
     }
 
+    /**
+     * PodSpec is a description of a pod.
+     */
     @JsonProperty("os")
     public void setOs(PodOS os) {
         this.os = os;
     }
 
+    /**
+     * Overhead represents the resource overhead associated with running a pod for a given RuntimeClass. This field will be autopopulated at admission time by the RuntimeClass admission controller. If the RuntimeClass admission controller is enabled, overhead must not be set in Pod create requests. The RuntimeClass admission controller will reject Pod create requests which have the overhead already set. If RuntimeClass is configured and selected in the PodSpec, Overhead will be set to the value defined in the corresponding RuntimeClass, otherwise it will remain unset and treated as zero. More info: https://git.k8s.io/enhancements/keps/sig-node/688-pod-overhead/README.md
+     */
     @JsonProperty("overhead")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getOverhead() {
         return overhead;
     }
 
+    /**
+     * Overhead represents the resource overhead associated with running a pod for a given RuntimeClass. This field will be autopopulated at admission time by the RuntimeClass admission controller. If the RuntimeClass admission controller is enabled, overhead must not be set in Pod create requests. The RuntimeClass admission controller will reject Pod create requests which have the overhead already set. If RuntimeClass is configured and selected in the PodSpec, Overhead will be set to the value defined in the corresponding RuntimeClass, otherwise it will remain unset and treated as zero. More info: https://git.k8s.io/enhancements/keps/sig-node/688-pod-overhead/README.md
+     */
     @JsonProperty("overhead")
     public void setOverhead(Map<String, Quantity> overhead) {
         this.overhead = overhead;
     }
 
+    /**
+     * PreemptionPolicy is the Policy for preempting pods with lower priority. One of Never, PreemptLowerPriority. Defaults to PreemptLowerPriority if unset.
+     */
     @JsonProperty("preemptionPolicy")
     public String getPreemptionPolicy() {
         return preemptionPolicy;
     }
 
+    /**
+     * PreemptionPolicy is the Policy for preempting pods with lower priority. One of Never, PreemptLowerPriority. Defaults to PreemptLowerPriority if unset.
+     */
     @JsonProperty("preemptionPolicy")
     public void setPreemptionPolicy(String preemptionPolicy) {
         this.preemptionPolicy = preemptionPolicy;
     }
 
+    /**
+     * The priority value. Various system components use this field to find the priority of the pod. When Priority Admission Controller is enabled, it prevents users from setting this field. The admission controller populates this field from PriorityClassName. The higher the value, the higher the priority.
+     */
     @JsonProperty("priority")
     public Integer getPriority() {
         return priority;
     }
 
+    /**
+     * The priority value. Various system components use this field to find the priority of the pod. When Priority Admission Controller is enabled, it prevents users from setting this field. The admission controller populates this field from PriorityClassName. The higher the value, the higher the priority.
+     */
     @JsonProperty("priority")
     public void setPriority(Integer priority) {
         this.priority = priority;
     }
 
+    /**
+     * If specified, indicates the pod's priority. "system-node-critical" and "system-cluster-critical" are two special keywords which indicate the highest priorities with the former being the highest priority. Any other name must be defined by creating a PriorityClass object with that name. If not specified, the pod priority will be default or zero if there is no default.
+     */
     @JsonProperty("priorityClassName")
     public String getPriorityClassName() {
         return priorityClassName;
     }
 
+    /**
+     * If specified, indicates the pod's priority. "system-node-critical" and "system-cluster-critical" are two special keywords which indicate the highest priorities with the former being the highest priority. Any other name must be defined by creating a PriorityClass object with that name. If not specified, the pod priority will be default or zero if there is no default.
+     */
     @JsonProperty("priorityClassName")
     public void setPriorityClassName(String priorityClassName) {
         this.priorityClassName = priorityClassName;
     }
 
+    /**
+     * If specified, all readiness gates will be evaluated for pod readiness. A pod is ready when all its containers are ready AND all conditions specified in the readiness gates have status equal to "True" More info: https://git.k8s.io/enhancements/keps/sig-network/580-pod-readiness-gates
+     */
     @JsonProperty("readinessGates")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PodReadinessGate> getReadinessGates() {
         return readinessGates;
     }
 
+    /**
+     * If specified, all readiness gates will be evaluated for pod readiness. A pod is ready when all its containers are ready AND all conditions specified in the readiness gates have status equal to "True" More info: https://git.k8s.io/enhancements/keps/sig-network/580-pod-readiness-gates
+     */
     @JsonProperty("readinessGates")
     public void setReadinessGates(List<PodReadinessGate> readinessGates) {
         this.readinessGates = readinessGates;
     }
 
+    /**
+     * ResourceClaims defines which ResourceClaims must be allocated and reserved before the Pod is allowed to start. The resources will be made available to those containers which consume them by name.<br><p> <br><p> This is an alpha field and requires enabling the DynamicResourceAllocation feature gate.<br><p> <br><p> This field is immutable.
+     */
     @JsonProperty("resourceClaims")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PodResourceClaim> getResourceClaims() {
         return resourceClaims;
     }
 
+    /**
+     * ResourceClaims defines which ResourceClaims must be allocated and reserved before the Pod is allowed to start. The resources will be made available to those containers which consume them by name.<br><p> <br><p> This is an alpha field and requires enabling the DynamicResourceAllocation feature gate.<br><p> <br><p> This field is immutable.
+     */
     @JsonProperty("resourceClaims")
     public void setResourceClaims(List<PodResourceClaim> resourceClaims) {
         this.resourceClaims = resourceClaims;
     }
 
+    /**
+     * PodSpec is a description of a pod.
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * PodSpec is a description of a pod.
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * Restart policy for all containers within the pod. One of Always, OnFailure, Never. In some contexts, only a subset of those values may be permitted. Default to Always. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#restart-policy
+     */
     @JsonProperty("restartPolicy")
     public String getRestartPolicy() {
         return restartPolicy;
     }
 
+    /**
+     * Restart policy for all containers within the pod. One of Always, OnFailure, Never. In some contexts, only a subset of those values may be permitted. Default to Always. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#restart-policy
+     */
     @JsonProperty("restartPolicy")
     public void setRestartPolicy(String restartPolicy) {
         this.restartPolicy = restartPolicy;
     }
 
+    /**
+     * RuntimeClassName refers to a RuntimeClass object in the node.k8s.io group, which should be used to run this pod.  If no RuntimeClass resource matches the named class, the pod will not be run. If unset or empty, the "legacy" RuntimeClass will be used, which is an implicit class with an empty definition that uses the default runtime handler. More info: https://git.k8s.io/enhancements/keps/sig-node/585-runtime-class
+     */
     @JsonProperty("runtimeClassName")
     public String getRuntimeClassName() {
         return runtimeClassName;
     }
 
+    /**
+     * RuntimeClassName refers to a RuntimeClass object in the node.k8s.io group, which should be used to run this pod.  If no RuntimeClass resource matches the named class, the pod will not be run. If unset or empty, the "legacy" RuntimeClass will be used, which is an implicit class with an empty definition that uses the default runtime handler. More info: https://git.k8s.io/enhancements/keps/sig-node/585-runtime-class
+     */
     @JsonProperty("runtimeClassName")
     public void setRuntimeClassName(String runtimeClassName) {
         this.runtimeClassName = runtimeClassName;
     }
 
+    /**
+     * If specified, the pod will be dispatched by specified scheduler. If not specified, the pod will be dispatched by default scheduler.
+     */
     @JsonProperty("schedulerName")
     public String getSchedulerName() {
         return schedulerName;
     }
 
+    /**
+     * If specified, the pod will be dispatched by specified scheduler. If not specified, the pod will be dispatched by default scheduler.
+     */
     @JsonProperty("schedulerName")
     public void setSchedulerName(String schedulerName) {
         this.schedulerName = schedulerName;
     }
 
+    /**
+     * SchedulingGates is an opaque list of values that if specified will block scheduling the pod. If schedulingGates is not empty, the pod will stay in the SchedulingGated state and the scheduler will not attempt to schedule the pod.<br><p> <br><p> SchedulingGates can only be set at pod creation time, and be removed only afterwards.
+     */
     @JsonProperty("schedulingGates")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PodSchedulingGate> getSchedulingGates() {
         return schedulingGates;
     }
 
+    /**
+     * SchedulingGates is an opaque list of values that if specified will block scheduling the pod. If schedulingGates is not empty, the pod will stay in the SchedulingGated state and the scheduler will not attempt to schedule the pod.<br><p> <br><p> SchedulingGates can only be set at pod creation time, and be removed only afterwards.
+     */
     @JsonProperty("schedulingGates")
     public void setSchedulingGates(List<PodSchedulingGate> schedulingGates) {
         this.schedulingGates = schedulingGates;
     }
 
+    /**
+     * PodSpec is a description of a pod.
+     */
     @JsonProperty("securityContext")
     public PodSecurityContext getSecurityContext() {
         return securityContext;
     }
 
+    /**
+     * PodSpec is a description of a pod.
+     */
     @JsonProperty("securityContext")
     public void setSecurityContext(PodSecurityContext securityContext) {
         this.securityContext = securityContext;
     }
 
+    /**
+     * DeprecatedServiceAccount is a deprecated alias for ServiceAccountName. Deprecated: Use serviceAccountName instead.
+     */
     @JsonProperty("serviceAccount")
     public String getServiceAccount() {
         return serviceAccount;
     }
 
+    /**
+     * DeprecatedServiceAccount is a deprecated alias for ServiceAccountName. Deprecated: Use serviceAccountName instead.
+     */
     @JsonProperty("serviceAccount")
     public void setServiceAccount(String serviceAccount) {
         this.serviceAccount = serviceAccount;
     }
 
+    /**
+     * ServiceAccountName is the name of the ServiceAccount to use to run this pod. More info: https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * ServiceAccountName is the name of the ServiceAccount to use to run this pod. More info: https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * If true the pod's hostname will be configured as the pod's FQDN, rather than the leaf name (the default). In Linux containers, this means setting the FQDN in the hostname field of the kernel (the nodename field of struct utsname). In Windows containers, this means setting the registry value of hostname for the registry key HKEY_LOCAL_MACHINE\\SYSTEM\\CurrentControlSet\\Services\\Tcpip\\Parameters to FQDN. If a pod does not have FQDN, this has no effect. Default to false.
+     */
     @JsonProperty("setHostnameAsFQDN")
     public Boolean getSetHostnameAsFQDN() {
         return setHostnameAsFQDN;
     }
 
+    /**
+     * If true the pod's hostname will be configured as the pod's FQDN, rather than the leaf name (the default). In Linux containers, this means setting the FQDN in the hostname field of the kernel (the nodename field of struct utsname). In Windows containers, this means setting the registry value of hostname for the registry key HKEY_LOCAL_MACHINE\\SYSTEM\\CurrentControlSet\\Services\\Tcpip\\Parameters to FQDN. If a pod does not have FQDN, this has no effect. Default to false.
+     */
     @JsonProperty("setHostnameAsFQDN")
     public void setSetHostnameAsFQDN(Boolean setHostnameAsFQDN) {
         this.setHostnameAsFQDN = setHostnameAsFQDN;
     }
 
+    /**
+     * Share a single process namespace between all of the containers in a pod. When this is set containers will be able to view and signal processes from other containers in the same pod, and the first process in each container will not be assigned PID 1. HostPID and ShareProcessNamespace cannot both be set. Optional: Default to false.
+     */
     @JsonProperty("shareProcessNamespace")
     public Boolean getShareProcessNamespace() {
         return shareProcessNamespace;
     }
 
+    /**
+     * Share a single process namespace between all of the containers in a pod. When this is set containers will be able to view and signal processes from other containers in the same pod, and the first process in each container will not be assigned PID 1. HostPID and ShareProcessNamespace cannot both be set. Optional: Default to false.
+     */
     @JsonProperty("shareProcessNamespace")
     public void setShareProcessNamespace(Boolean shareProcessNamespace) {
         this.shareProcessNamespace = shareProcessNamespace;
     }
 
+    /**
+     * If specified, the fully qualified Pod hostname will be "&lt;hostname&gt;.&lt;subdomain&gt;.&lt;pod namespace&gt;.svc.&lt;cluster domain&gt;". If not specified, the pod will not have a domainname at all.
+     */
     @JsonProperty("subdomain")
     public String getSubdomain() {
         return subdomain;
     }
 
+    /**
+     * If specified, the fully qualified Pod hostname will be "&lt;hostname&gt;.&lt;subdomain&gt;.&lt;pod namespace&gt;.svc.&lt;cluster domain&gt;". If not specified, the pod will not have a domainname at all.
+     */
     @JsonProperty("subdomain")
     public void setSubdomain(String subdomain) {
         this.subdomain = subdomain;
     }
 
+    /**
+     * Optional duration in seconds the pod needs to terminate gracefully. May be decreased in delete request. Value must be non-negative integer. The value zero indicates stop immediately via the kill signal (no opportunity to shut down). If this value is nil, the default grace period will be used instead. The grace period is the duration in seconds after the processes running in the pod are sent a termination signal and the time when the processes are forcibly halted with a kill signal. Set this value longer than the expected cleanup time for your process. Defaults to 30 seconds.
+     */
     @JsonProperty("terminationGracePeriodSeconds")
     public Long getTerminationGracePeriodSeconds() {
         return terminationGracePeriodSeconds;
     }
 
+    /**
+     * Optional duration in seconds the pod needs to terminate gracefully. May be decreased in delete request. Value must be non-negative integer. The value zero indicates stop immediately via the kill signal (no opportunity to shut down). If this value is nil, the default grace period will be used instead. The grace period is the duration in seconds after the processes running in the pod are sent a termination signal and the time when the processes are forcibly halted with a kill signal. Set this value longer than the expected cleanup time for your process. Defaults to 30 seconds.
+     */
     @JsonProperty("terminationGracePeriodSeconds")
     public void setTerminationGracePeriodSeconds(Long terminationGracePeriodSeconds) {
         this.terminationGracePeriodSeconds = terminationGracePeriodSeconds;
     }
 
+    /**
+     * If specified, the pod's tolerations.
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * If specified, the pod's tolerations.
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
     }
 
+    /**
+     * TopologySpreadConstraints describes how a group of pods ought to spread across topology domains. Scheduler will schedule pods in a way which abides by the constraints. All topologySpreadConstraints are ANDed.
+     */
     @JsonProperty("topologySpreadConstraints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TopologySpreadConstraint> getTopologySpreadConstraints() {
         return topologySpreadConstraints;
     }
 
+    /**
+     * TopologySpreadConstraints describes how a group of pods ought to spread across topology domains. Scheduler will schedule pods in a way which abides by the constraints. All topologySpreadConstraints are ANDed.
+     */
     @JsonProperty("topologySpreadConstraints")
     public void setTopologySpreadConstraints(List<TopologySpreadConstraint> topologySpreadConstraints) {
         this.topologySpreadConstraints = topologySpreadConstraints;
     }
 
+    /**
+     * List of volumes that can be mounted by containers belonging to the pod. More info: https://kubernetes.io/docs/concepts/storage/volumes
+     */
     @JsonProperty("volumes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Volume> getVolumes() {
         return volumes;
     }
 
+    /**
+     * List of volumes that can be mounted by containers belonging to the pod. More info: https://kubernetes.io/docs/concepts/storage/volumes
+     */
     @JsonProperty("volumes")
     public void setVolumes(List<Volume> volumes) {
         this.volumes = volumes;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodStatus.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodStatus.java
index 9cc5e3f1aae..f4df3a0f915 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodStatus.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodStatus represents information about the status of a pod. Status may trail the actual state of a system, especially if the node that hosts the pod cannot contact the control plane.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -118,168 +121,264 @@ public PodStatus(List<PodCondition> conditions, List<ContainerStatus> containerS
         this.startTime = startTime;
     }
 
+    /**
+     * Current service state of pod. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-conditions
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PodCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Current service state of pod. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-conditions
+     */
     @JsonProperty("conditions")
     public void setConditions(List<PodCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Statuses of containers in this pod. Each container in the pod should have at most one status in this list, and all statuses should be for containers in the pod. However this is not enforced. If a status for a non-existent container is present in the list, or the list has duplicate names, the behavior of various Kubernetes components is not defined and those statuses might be ignored. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-and-container-status
+     */
     @JsonProperty("containerStatuses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ContainerStatus> getContainerStatuses() {
         return containerStatuses;
     }
 
+    /**
+     * Statuses of containers in this pod. Each container in the pod should have at most one status in this list, and all statuses should be for containers in the pod. However this is not enforced. If a status for a non-existent container is present in the list, or the list has duplicate names, the behavior of various Kubernetes components is not defined and those statuses might be ignored. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-and-container-status
+     */
     @JsonProperty("containerStatuses")
     public void setContainerStatuses(List<ContainerStatus> containerStatuses) {
         this.containerStatuses = containerStatuses;
     }
 
+    /**
+     * Statuses for any ephemeral containers that have run in this pod. Each ephemeral container in the pod should have at most one status in this list, and all statuses should be for containers in the pod. However this is not enforced. If a status for a non-existent container is present in the list, or the list has duplicate names, the behavior of various Kubernetes components is not defined and those statuses might be ignored. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-and-container-status
+     */
     @JsonProperty("ephemeralContainerStatuses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ContainerStatus> getEphemeralContainerStatuses() {
         return ephemeralContainerStatuses;
     }
 
+    /**
+     * Statuses for any ephemeral containers that have run in this pod. Each ephemeral container in the pod should have at most one status in this list, and all statuses should be for containers in the pod. However this is not enforced. If a status for a non-existent container is present in the list, or the list has duplicate names, the behavior of various Kubernetes components is not defined and those statuses might be ignored. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-and-container-status
+     */
     @JsonProperty("ephemeralContainerStatuses")
     public void setEphemeralContainerStatuses(List<ContainerStatus> ephemeralContainerStatuses) {
         this.ephemeralContainerStatuses = ephemeralContainerStatuses;
     }
 
+    /**
+     * hostIP holds the IP address of the host to which the pod is assigned. Empty if the pod has not started yet. A pod can be assigned to a node that has a problem in kubelet which in turns mean that HostIP will not be updated even if there is a node is assigned to pod
+     */
     @JsonProperty("hostIP")
     public String getHostIP() {
         return hostIP;
     }
 
+    /**
+     * hostIP holds the IP address of the host to which the pod is assigned. Empty if the pod has not started yet. A pod can be assigned to a node that has a problem in kubelet which in turns mean that HostIP will not be updated even if there is a node is assigned to pod
+     */
     @JsonProperty("hostIP")
     public void setHostIP(String hostIP) {
         this.hostIP = hostIP;
     }
 
+    /**
+     * hostIPs holds the IP addresses allocated to the host. If this field is specified, the first entry must match the hostIP field. This list is empty if the pod has not started yet. A pod can be assigned to a node that has a problem in kubelet which in turns means that HostIPs will not be updated even if there is a node is assigned to this pod.
+     */
     @JsonProperty("hostIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HostIP> getHostIPs() {
         return hostIPs;
     }
 
+    /**
+     * hostIPs holds the IP addresses allocated to the host. If this field is specified, the first entry must match the hostIP field. This list is empty if the pod has not started yet. A pod can be assigned to a node that has a problem in kubelet which in turns means that HostIPs will not be updated even if there is a node is assigned to this pod.
+     */
     @JsonProperty("hostIPs")
     public void setHostIPs(List<HostIP> hostIPs) {
         this.hostIPs = hostIPs;
     }
 
+    /**
+     * Statuses of init containers in this pod. The most recent successful non-restartable init container will have ready = true, the most recently started container will have startTime set. Each init container in the pod should have at most one status in this list, and all statuses should be for containers in the pod. However this is not enforced. If a status for a non-existent container is present in the list, or the list has duplicate names, the behavior of various Kubernetes components is not defined and those statuses might be ignored. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#pod-and-container-status
+     */
     @JsonProperty("initContainerStatuses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ContainerStatus> getInitContainerStatuses() {
         return initContainerStatuses;
     }
 
+    /**
+     * Statuses of init containers in this pod. The most recent successful non-restartable init container will have ready = true, the most recently started container will have startTime set. Each init container in the pod should have at most one status in this list, and all statuses should be for containers in the pod. However this is not enforced. If a status for a non-existent container is present in the list, or the list has duplicate names, the behavior of various Kubernetes components is not defined and those statuses might be ignored. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#pod-and-container-status
+     */
     @JsonProperty("initContainerStatuses")
     public void setInitContainerStatuses(List<ContainerStatus> initContainerStatuses) {
         this.initContainerStatuses = initContainerStatuses;
     }
 
+    /**
+     * A human readable message indicating details about why the pod is in this condition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * A human readable message indicating details about why the pod is in this condition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * nominatedNodeName is set only when this pod preempts other pods on the node, but it cannot be scheduled right away as preemption victims receive their graceful termination periods. This field does not guarantee that the pod will be scheduled on this node. Scheduler may decide to place the pod elsewhere if other nodes become available sooner. Scheduler may also decide to give the resources on this node to a higher priority pod that is created after preemption. As a result, this field may be different than PodSpec.nodeName when the pod is scheduled.
+     */
     @JsonProperty("nominatedNodeName")
     public String getNominatedNodeName() {
         return nominatedNodeName;
     }
 
+    /**
+     * nominatedNodeName is set only when this pod preempts other pods on the node, but it cannot be scheduled right away as preemption victims receive their graceful termination periods. This field does not guarantee that the pod will be scheduled on this node. Scheduler may decide to place the pod elsewhere if other nodes become available sooner. Scheduler may also decide to give the resources on this node to a higher priority pod that is created after preemption. As a result, this field may be different than PodSpec.nodeName when the pod is scheduled.
+     */
     @JsonProperty("nominatedNodeName")
     public void setNominatedNodeName(String nominatedNodeName) {
         this.nominatedNodeName = nominatedNodeName;
     }
 
+    /**
+     * The phase of a Pod is a simple, high-level summary of where the Pod is in its lifecycle. The conditions array, the reason and message fields, and the individual container status arrays contain more detail about the pod's status. There are five possible phase values:<br><p> <br><p> Pending: The pod has been accepted by the Kubernetes system, but one or more of the container images has not been created. This includes time before being scheduled as well as time spent downloading images over the network, which could take a while. Running: The pod has been bound to a node, and all of the containers have been created. At least one container is still running, or is in the process of starting or restarting. Succeeded: All containers in the pod have terminated in success, and will not be restarted. Failed: All containers in the pod have terminated, and at least one container has terminated in failure. The container either exited with non-zero status or was terminated by the system. Unknown: For some reason the state of the pod could not be obtained, typically due to an error in communicating with the host of the pod.<br><p> <br><p> More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-phase
+     */
     @JsonProperty("phase")
     public String getPhase() {
         return phase;
     }
 
+    /**
+     * The phase of a Pod is a simple, high-level summary of where the Pod is in its lifecycle. The conditions array, the reason and message fields, and the individual container status arrays contain more detail about the pod's status. There are five possible phase values:<br><p> <br><p> Pending: The pod has been accepted by the Kubernetes system, but one or more of the container images has not been created. This includes time before being scheduled as well as time spent downloading images over the network, which could take a while. Running: The pod has been bound to a node, and all of the containers have been created. At least one container is still running, or is in the process of starting or restarting. Succeeded: All containers in the pod have terminated in success, and will not be restarted. Failed: All containers in the pod have terminated, and at least one container has terminated in failure. The container either exited with non-zero status or was terminated by the system. Unknown: For some reason the state of the pod could not be obtained, typically due to an error in communicating with the host of the pod.<br><p> <br><p> More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-phase
+     */
     @JsonProperty("phase")
     public void setPhase(String phase) {
         this.phase = phase;
     }
 
+    /**
+     * podIP address allocated to the pod. Routable at least within the cluster. Empty if not yet allocated.
+     */
     @JsonProperty("podIP")
     public String getPodIP() {
         return podIP;
     }
 
+    /**
+     * podIP address allocated to the pod. Routable at least within the cluster. Empty if not yet allocated.
+     */
     @JsonProperty("podIP")
     public void setPodIP(String podIP) {
         this.podIP = podIP;
     }
 
+    /**
+     * podIPs holds the IP addresses allocated to the pod. If this field is specified, the 0th entry must match the podIP field. Pods may be allocated at most 1 value for each of IPv4 and IPv6. This list is empty if no IPs have been allocated yet.
+     */
     @JsonProperty("podIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PodIP> getPodIPs() {
         return podIPs;
     }
 
+    /**
+     * podIPs holds the IP addresses allocated to the pod. If this field is specified, the 0th entry must match the podIP field. Pods may be allocated at most 1 value for each of IPv4 and IPv6. This list is empty if no IPs have been allocated yet.
+     */
     @JsonProperty("podIPs")
     public void setPodIPs(List<PodIP> podIPs) {
         this.podIPs = podIPs;
     }
 
+    /**
+     * The Quality of Service (QOS) classification assigned to the pod based on resource requirements See PodQOSClass type for available QOS classes More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-qos/#quality-of-service-classes
+     */
     @JsonProperty("qosClass")
     public String getQosClass() {
         return qosClass;
     }
 
+    /**
+     * The Quality of Service (QOS) classification assigned to the pod based on resource requirements See PodQOSClass type for available QOS classes More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-qos/#quality-of-service-classes
+     */
     @JsonProperty("qosClass")
     public void setQosClass(String qosClass) {
         this.qosClass = qosClass;
     }
 
+    /**
+     * A brief CamelCase message indicating details about why the pod is in this state. e.g. 'Evicted'
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * A brief CamelCase message indicating details about why the pod is in this state. e.g. 'Evicted'
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of resources resize desired for pod's containers. It is empty if no resources resize is pending. Any changes to container resources will automatically set this to "Proposed"
+     */
     @JsonProperty("resize")
     public String getResize() {
         return resize;
     }
 
+    /**
+     * Status of resources resize desired for pod's containers. It is empty if no resources resize is pending. Any changes to container resources will automatically set this to "Proposed"
+     */
     @JsonProperty("resize")
     public void setResize(String resize) {
         this.resize = resize;
     }
 
+    /**
+     * Status of resource claims.
+     */
     @JsonProperty("resourceClaimStatuses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PodResourceClaimStatus> getResourceClaimStatuses() {
         return resourceClaimStatuses;
     }
 
+    /**
+     * Status of resource claims.
+     */
     @JsonProperty("resourceClaimStatuses")
     public void setResourceClaimStatuses(List<PodResourceClaimStatus> resourceClaimStatuses) {
         this.resourceClaimStatuses = resourceClaimStatuses;
     }
 
+    /**
+     * PodStatus represents information about the status of a pod. Status may trail the actual state of a system, especially if the node that hosts the pod cannot contact the control plane.
+     */
     @JsonProperty("startTime")
     public String getStartTime() {
         return startTime;
     }
 
+    /**
+     * PodStatus represents information about the status of a pod. Status may trail the actual state of a system, especially if the node that hosts the pod cannot contact the control plane.
+     */
     @JsonProperty("startTime")
     public void setStartTime(String startTime) {
         this.startTime = startTime;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodTemplate.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodTemplate.java
index 9f1d25dae7b..e6f82812eb3 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodTemplate.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodTemplate.java
@@ -21,6 +21,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodTemplate describes a template for creating copies of a predefined pod.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -45,14 +48,8 @@
 public class PodTemplate implements Editable<PodTemplateBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodTemplate";
     @JsonProperty("metadata")
@@ -77,7 +74,7 @@ public PodTemplate(String apiVersion, String kind, ObjectMeta metadata, PodTempl
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -85,7 +82,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -93,7 +90,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -101,28 +98,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodTemplate describes a template for creating copies of a predefined pod.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodTemplate describes a template for creating copies of a predefined pod.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PodTemplate describes a template for creating copies of a predefined pod.
+     */
     @JsonProperty("template")
     public PodTemplateSpec getTemplate() {
         return template;
     }
 
+    /**
+     * PodTemplate describes a template for creating copies of a predefined pod.
+     */
     @JsonProperty("template")
     public void setTemplate(PodTemplateSpec template) {
         this.template = template;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodTemplateList.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodTemplateList.java
index b5ed88964cd..102202a4f41 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodTemplateList.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodTemplateList.java
@@ -23,6 +23,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodTemplateList is a list of PodTemplates.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -47,17 +50,11 @@
 public class PodTemplateList implements Editable<PodTemplateListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.PodTemplate>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.PodTemplate> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodTemplateList";
     @JsonProperty("metadata")
@@ -80,7 +77,7 @@ public PodTemplateList(String apiVersion, List<io.fabric8.kubernetes.api.model.P
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -88,26 +85,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of pod templates
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.PodTemplate> getItems() {
         return items;
     }
 
+    /**
+     * List of pod templates
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.PodTemplate> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -115,18 +118,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodTemplateList is a list of PodTemplates.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodTemplateList is a list of PodTemplates.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodTemplateSpec.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodTemplateSpec.java
index 865c7a5928b..08494a2a136 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodTemplateSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PodTemplateSpec.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodTemplateSpec describes the data a pod should have when created from a template
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public PodTemplateSpec(ObjectMeta metadata, PodSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PodTemplateSpec describes the data a pod should have when created from a template
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodTemplateSpec describes the data a pod should have when created from a template
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PodTemplateSpec describes the data a pod should have when created from a template
+     */
     @JsonProperty("spec")
     public PodSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PodTemplateSpec describes the data a pod should have when created from a template
+     */
     @JsonProperty("spec")
     public void setSpec(PodSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PortStatus.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PortStatus.java
index 3878bb53ecc..2577a035492 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PortStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PortStatus.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PortStatus represents the error condition of a service port
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -57,31 +60,49 @@ public PortStatus(String error, Integer port, String protocol) {
         this.protocol = protocol;
     }
 
+    /**
+     * Error is to record the problem with the service port The format of the error shall comply with the following rules: - built-in error values shall be specified in this file and those shall use<br><p>   CamelCase names<br><p> - cloud provider specific error values must have names that comply with the<br><p>   format foo.example.com/CamelCase.
+     */
     @JsonProperty("error")
     public String getError() {
         return error;
     }
 
+    /**
+     * Error is to record the problem with the service port The format of the error shall comply with the following rules: - built-in error values shall be specified in this file and those shall use<br><p>   CamelCase names<br><p> - cloud provider specific error values must have names that comply with the<br><p>   format foo.example.com/CamelCase.
+     */
     @JsonProperty("error")
     public void setError(String error) {
         this.error = error;
     }
 
+    /**
+     * Port is the port number of the service port of which status is recorded here
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * Port is the port number of the service port of which status is recorded here
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * Protocol is the protocol of the service port of which status is recorded here The supported values are: "TCP", "UDP", "SCTP"
+     */
     @JsonProperty("protocol")
     public String getProtocol() {
         return protocol;
     }
 
+    /**
+     * Protocol is the protocol of the service port of which status is recorded here The supported values are: "TCP", "UDP", "SCTP"
+     */
     @JsonProperty("protocol")
     public void setProtocol(String protocol) {
         this.protocol = protocol;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PortworxVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PortworxVolumeSource.java
index 04892041d85..bf7e0aac94d 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PortworxVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PortworxVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PortworxVolumeSource represents a Portworx volume resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -57,31 +60,49 @@ public PortworxVolumeSource(String fsType, Boolean readOnly, String volumeID) {
         this.volumeID = volumeID;
     }
 
+    /**
+     * fSType represents the filesystem type to mount Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs". Implicitly inferred to be "ext4" if unspecified.
+     */
     @JsonProperty("fsType")
     public String getFsType() {
         return fsType;
     }
 
+    /**
+     * fSType represents the filesystem type to mount Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs". Implicitly inferred to be "ext4" if unspecified.
+     */
     @JsonProperty("fsType")
     public void setFsType(String fsType) {
         this.fsType = fsType;
     }
 
+    /**
+     * readOnly defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * volumeID uniquely identifies a Portworx volume
+     */
     @JsonProperty("volumeID")
     public String getVolumeID() {
         return volumeID;
     }
 
+    /**
+     * volumeID uniquely identifies a Portworx volume
+     */
     @JsonProperty("volumeID")
     public void setVolumeID(String volumeID) {
         this.volumeID = volumeID;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PreferredSchedulingTerm.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PreferredSchedulingTerm.java
index add0a8ca35d..eb3087ebbd2 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PreferredSchedulingTerm.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/PreferredSchedulingTerm.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * An empty preferred scheduling term matches all objects with implicit weight 0 (i.e. it's a no-op). A null preferred scheduling term matches no objects (i.e. is also a no-op).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public PreferredSchedulingTerm(NodeSelectorTerm preference, Integer weight) {
         this.weight = weight;
     }
 
+    /**
+     * An empty preferred scheduling term matches all objects with implicit weight 0 (i.e. it's a no-op). A null preferred scheduling term matches no objects (i.e. is also a no-op).
+     */
     @JsonProperty("preference")
     public NodeSelectorTerm getPreference() {
         return preference;
     }
 
+    /**
+     * An empty preferred scheduling term matches all objects with implicit weight 0 (i.e. it's a no-op). A null preferred scheduling term matches no objects (i.e. is also a no-op).
+     */
     @JsonProperty("preference")
     public void setPreference(NodeSelectorTerm preference) {
         this.preference = preference;
     }
 
+    /**
+     * Weight associated with matching the corresponding nodeSelectorTerm, in the range 1-100.
+     */
     @JsonProperty("weight")
     public Integer getWeight() {
         return weight;
     }
 
+    /**
+     * Weight associated with matching the corresponding nodeSelectorTerm, in the range 1-100.
+     */
     @JsonProperty("weight")
     public void setWeight(Integer weight) {
         this.weight = weight;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Probe.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Probe.java
index d6ef959a917..5d03e223681 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Probe.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Probe.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Probe describes a health check to be performed against a container to determine whether it is alive or ready to receive traffic.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,101 +88,161 @@ public Probe(ExecAction exec, Integer failureThreshold, GRPCAction grpc, HTTPGet
         this.timeoutSeconds = timeoutSeconds;
     }
 
+    /**
+     * Probe describes a health check to be performed against a container to determine whether it is alive or ready to receive traffic.
+     */
     @JsonProperty("exec")
     public ExecAction getExec() {
         return exec;
     }
 
+    /**
+     * Probe describes a health check to be performed against a container to determine whether it is alive or ready to receive traffic.
+     */
     @JsonProperty("exec")
     public void setExec(ExecAction exec) {
         this.exec = exec;
     }
 
+    /**
+     * Minimum consecutive failures for the probe to be considered failed after having succeeded. Defaults to 3. Minimum value is 1.
+     */
     @JsonProperty("failureThreshold")
     public Integer getFailureThreshold() {
         return failureThreshold;
     }
 
+    /**
+     * Minimum consecutive failures for the probe to be considered failed after having succeeded. Defaults to 3. Minimum value is 1.
+     */
     @JsonProperty("failureThreshold")
     public void setFailureThreshold(Integer failureThreshold) {
         this.failureThreshold = failureThreshold;
     }
 
+    /**
+     * Probe describes a health check to be performed against a container to determine whether it is alive or ready to receive traffic.
+     */
     @JsonProperty("grpc")
     public GRPCAction getGrpc() {
         return grpc;
     }
 
+    /**
+     * Probe describes a health check to be performed against a container to determine whether it is alive or ready to receive traffic.
+     */
     @JsonProperty("grpc")
     public void setGrpc(GRPCAction grpc) {
         this.grpc = grpc;
     }
 
+    /**
+     * Probe describes a health check to be performed against a container to determine whether it is alive or ready to receive traffic.
+     */
     @JsonProperty("httpGet")
     public HTTPGetAction getHttpGet() {
         return httpGet;
     }
 
+    /**
+     * Probe describes a health check to be performed against a container to determine whether it is alive or ready to receive traffic.
+     */
     @JsonProperty("httpGet")
     public void setHttpGet(HTTPGetAction httpGet) {
         this.httpGet = httpGet;
     }
 
+    /**
+     * Number of seconds after the container has started before liveness probes are initiated. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
+     */
     @JsonProperty("initialDelaySeconds")
     public Integer getInitialDelaySeconds() {
         return initialDelaySeconds;
     }
 
+    /**
+     * Number of seconds after the container has started before liveness probes are initiated. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
+     */
     @JsonProperty("initialDelaySeconds")
     public void setInitialDelaySeconds(Integer initialDelaySeconds) {
         this.initialDelaySeconds = initialDelaySeconds;
     }
 
+    /**
+     * How often (in seconds) to perform the probe. Default to 10 seconds. Minimum value is 1.
+     */
     @JsonProperty("periodSeconds")
     public Integer getPeriodSeconds() {
         return periodSeconds;
     }
 
+    /**
+     * How often (in seconds) to perform the probe. Default to 10 seconds. Minimum value is 1.
+     */
     @JsonProperty("periodSeconds")
     public void setPeriodSeconds(Integer periodSeconds) {
         this.periodSeconds = periodSeconds;
     }
 
+    /**
+     * Minimum consecutive successes for the probe to be considered successful after having failed. Defaults to 1. Must be 1 for liveness and startup. Minimum value is 1.
+     */
     @JsonProperty("successThreshold")
     public Integer getSuccessThreshold() {
         return successThreshold;
     }
 
+    /**
+     * Minimum consecutive successes for the probe to be considered successful after having failed. Defaults to 1. Must be 1 for liveness and startup. Minimum value is 1.
+     */
     @JsonProperty("successThreshold")
     public void setSuccessThreshold(Integer successThreshold) {
         this.successThreshold = successThreshold;
     }
 
+    /**
+     * Probe describes a health check to be performed against a container to determine whether it is alive or ready to receive traffic.
+     */
     @JsonProperty("tcpSocket")
     public TCPSocketAction getTcpSocket() {
         return tcpSocket;
     }
 
+    /**
+     * Probe describes a health check to be performed against a container to determine whether it is alive or ready to receive traffic.
+     */
     @JsonProperty("tcpSocket")
     public void setTcpSocket(TCPSocketAction tcpSocket) {
         this.tcpSocket = tcpSocket;
     }
 
+    /**
+     * Optional duration in seconds the pod needs to terminate gracefully upon probe failure. The grace period is the duration in seconds after the processes running in the pod are sent a termination signal and the time when the processes are forcibly halted with a kill signal. Set this value longer than the expected cleanup time for your process. If this value is nil, the pod's terminationGracePeriodSeconds will be used. Otherwise, this value overrides the value provided by the pod spec. Value must be non-negative integer. The value zero indicates stop immediately via the kill signal (no opportunity to shut down). This is a beta field and requires enabling ProbeTerminationGracePeriod feature gate. Minimum value is 1. spec.terminationGracePeriodSeconds is used if unset.
+     */
     @JsonProperty("terminationGracePeriodSeconds")
     public Long getTerminationGracePeriodSeconds() {
         return terminationGracePeriodSeconds;
     }
 
+    /**
+     * Optional duration in seconds the pod needs to terminate gracefully upon probe failure. The grace period is the duration in seconds after the processes running in the pod are sent a termination signal and the time when the processes are forcibly halted with a kill signal. Set this value longer than the expected cleanup time for your process. If this value is nil, the pod's terminationGracePeriodSeconds will be used. Otherwise, this value overrides the value provided by the pod spec. Value must be non-negative integer. The value zero indicates stop immediately via the kill signal (no opportunity to shut down). This is a beta field and requires enabling ProbeTerminationGracePeriod feature gate. Minimum value is 1. spec.terminationGracePeriodSeconds is used if unset.
+     */
     @JsonProperty("terminationGracePeriodSeconds")
     public void setTerminationGracePeriodSeconds(Long terminationGracePeriodSeconds) {
         this.terminationGracePeriodSeconds = terminationGracePeriodSeconds;
     }
 
+    /**
+     * Number of seconds after which the probe times out. Defaults to 1 second. Minimum value is 1. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
+     */
     @JsonProperty("timeoutSeconds")
     public Integer getTimeoutSeconds() {
         return timeoutSeconds;
     }
 
+    /**
+     * Number of seconds after which the probe times out. Defaults to 1 second. Minimum value is 1. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
+     */
     @JsonProperty("timeoutSeconds")
     public void setTimeoutSeconds(Integer timeoutSeconds) {
         this.timeoutSeconds = timeoutSeconds;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ProjectedVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ProjectedVolumeSource.java
index f74fbf82da7..eabc3b78b91 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ProjectedVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ProjectedVolumeSource.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Represents a projected volume source
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -56,22 +59,34 @@ public ProjectedVolumeSource(Integer defaultMode, List<VolumeProjection> sources
         this.sources = sources;
     }
 
+    /**
+     * defaultMode are the mode bits used to set permissions on created files by default. Must be an octal value between 0000 and 0777 or a decimal value between 0 and 511. YAML accepts both octal and decimal values, JSON requires decimal values for mode bits. Directories within the path are not affected by this setting. This might be in conflict with other options that affect the file mode, like fsGroup, and the result can be other mode bits set.
+     */
     @JsonProperty("defaultMode")
     public Integer getDefaultMode() {
         return defaultMode;
     }
 
+    /**
+     * defaultMode are the mode bits used to set permissions on created files by default. Must be an octal value between 0000 and 0777 or a decimal value between 0 and 511. YAML accepts both octal and decimal values, JSON requires decimal values for mode bits. Directories within the path are not affected by this setting. This might be in conflict with other options that affect the file mode, like fsGroup, and the result can be other mode bits set.
+     */
     @JsonProperty("defaultMode")
     public void setDefaultMode(Integer defaultMode) {
         this.defaultMode = defaultMode;
     }
 
+    /**
+     * sources is the list of volume projections. Each entry in this list handles one source.
+     */
     @JsonProperty("sources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VolumeProjection> getSources() {
         return sources;
     }
 
+    /**
+     * sources is the list of volume projections. Each entry in this list handles one source.
+     */
     @JsonProperty("sources")
     public void setSources(List<VolumeProjection> sources) {
         this.sources = sources;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/QuobyteVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/QuobyteVolumeSource.java
index fab85a72036..95f928e4c79 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/QuobyteVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/QuobyteVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Represents a Quobyte mount that lasts the lifetime of a pod. Quobyte volumes do not support ownership management or SELinux relabeling.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -69,61 +72,97 @@ public QuobyteVolumeSource(String group, Boolean readOnly, String registry, Stri
         this.volume = volume;
     }
 
+    /**
+     * group to map volume access to Default is no group
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * group to map volume access to Default is no group
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * readOnly here will force the Quobyte volume to be mounted with read-only permissions. Defaults to false.
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly here will force the Quobyte volume to be mounted with read-only permissions. Defaults to false.
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * registry represents a single or multiple Quobyte Registry services specified as a string as host:port pair (multiple entries are separated with commas) which acts as the central registry for volumes
+     */
     @JsonProperty("registry")
     public String getRegistry() {
         return registry;
     }
 
+    /**
+     * registry represents a single or multiple Quobyte Registry services specified as a string as host:port pair (multiple entries are separated with commas) which acts as the central registry for volumes
+     */
     @JsonProperty("registry")
     public void setRegistry(String registry) {
         this.registry = registry;
     }
 
+    /**
+     * tenant owning the given Quobyte volume in the Backend Used with dynamically provisioned Quobyte volumes, value is set by the plugin
+     */
     @JsonProperty("tenant")
     public String getTenant() {
         return tenant;
     }
 
+    /**
+     * tenant owning the given Quobyte volume in the Backend Used with dynamically provisioned Quobyte volumes, value is set by the plugin
+     */
     @JsonProperty("tenant")
     public void setTenant(String tenant) {
         this.tenant = tenant;
     }
 
+    /**
+     * user to map volume access to Defaults to serivceaccount user
+     */
     @JsonProperty("user")
     public String getUser() {
         return user;
     }
 
+    /**
+     * user to map volume access to Defaults to serivceaccount user
+     */
     @JsonProperty("user")
     public void setUser(String user) {
         this.user = user;
     }
 
+    /**
+     * volume is a string that references an already created Quobyte volume by name.
+     */
     @JsonProperty("volume")
     public String getVolume() {
         return volume;
     }
 
+    /**
+     * volume is a string that references an already created Quobyte volume by name.
+     */
     @JsonProperty("volume")
     public void setVolume(String volume) {
         this.volume = volume;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/RBDPersistentVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/RBDPersistentVolumeSource.java
index 9abfd95fb1e..82f891d93bd 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/RBDPersistentVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/RBDPersistentVolumeSource.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Represents a Rados Block Device mount that lasts the lifetime of a pod. RBD volumes support ownership management and SELinux relabeling.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -80,82 +83,130 @@ public RBDPersistentVolumeSource(String fsType, String image, String keyring, Li
         this.user = user;
     }
 
+    /**
+     * fsType is the filesystem type of the volume that you want to mount. Tip: Ensure that the filesystem type is supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified. More info: https://kubernetes.io/docs/concepts/storage/volumes#rbd
+     */
     @JsonProperty("fsType")
     public String getFsType() {
         return fsType;
     }
 
+    /**
+     * fsType is the filesystem type of the volume that you want to mount. Tip: Ensure that the filesystem type is supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified. More info: https://kubernetes.io/docs/concepts/storage/volumes#rbd
+     */
     @JsonProperty("fsType")
     public void setFsType(String fsType) {
         this.fsType = fsType;
     }
 
+    /**
+     * image is the rados image name. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * image is the rados image name. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
     }
 
+    /**
+     * keyring is the path to key ring for RBDUser. Default is /etc/ceph/keyring. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
+     */
     @JsonProperty("keyring")
     public String getKeyring() {
         return keyring;
     }
 
+    /**
+     * keyring is the path to key ring for RBDUser. Default is /etc/ceph/keyring. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
+     */
     @JsonProperty("keyring")
     public void setKeyring(String keyring) {
         this.keyring = keyring;
     }
 
+    /**
+     * monitors is a collection of Ceph monitors. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
+     */
     @JsonProperty("monitors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMonitors() {
         return monitors;
     }
 
+    /**
+     * monitors is a collection of Ceph monitors. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
+     */
     @JsonProperty("monitors")
     public void setMonitors(List<String> monitors) {
         this.monitors = monitors;
     }
 
+    /**
+     * pool is the rados pool name. Default is rbd. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
+     */
     @JsonProperty("pool")
     public String getPool() {
         return pool;
     }
 
+    /**
+     * pool is the rados pool name. Default is rbd. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
+     */
     @JsonProperty("pool")
     public void setPool(String pool) {
         this.pool = pool;
     }
 
+    /**
+     * readOnly here will force the ReadOnly setting in VolumeMounts. Defaults to false. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly here will force the ReadOnly setting in VolumeMounts. Defaults to false. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * Represents a Rados Block Device mount that lasts the lifetime of a pod. RBD volumes support ownership management and SELinux relabeling.
+     */
     @JsonProperty("secretRef")
     public SecretReference getSecretRef() {
         return secretRef;
     }
 
+    /**
+     * Represents a Rados Block Device mount that lasts the lifetime of a pod. RBD volumes support ownership management and SELinux relabeling.
+     */
     @JsonProperty("secretRef")
     public void setSecretRef(SecretReference secretRef) {
         this.secretRef = secretRef;
     }
 
+    /**
+     * user is the rados user name. Default is admin. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
+     */
     @JsonProperty("user")
     public String getUser() {
         return user;
     }
 
+    /**
+     * user is the rados user name. Default is admin. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
+     */
     @JsonProperty("user")
     public void setUser(String user) {
         this.user = user;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/RBDVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/RBDVolumeSource.java
index 36dafc76303..14c8ae86c9d 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/RBDVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/RBDVolumeSource.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Represents a Rados Block Device mount that lasts the lifetime of a pod. RBD volumes support ownership management and SELinux relabeling.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -80,82 +83,130 @@ public RBDVolumeSource(String fsType, String image, String keyring, List<String>
         this.user = user;
     }
 
+    /**
+     * fsType is the filesystem type of the volume that you want to mount. Tip: Ensure that the filesystem type is supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified. More info: https://kubernetes.io/docs/concepts/storage/volumes#rbd
+     */
     @JsonProperty("fsType")
     public String getFsType() {
         return fsType;
     }
 
+    /**
+     * fsType is the filesystem type of the volume that you want to mount. Tip: Ensure that the filesystem type is supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified. More info: https://kubernetes.io/docs/concepts/storage/volumes#rbd
+     */
     @JsonProperty("fsType")
     public void setFsType(String fsType) {
         this.fsType = fsType;
     }
 
+    /**
+     * image is the rados image name. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * image is the rados image name. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
     }
 
+    /**
+     * keyring is the path to key ring for RBDUser. Default is /etc/ceph/keyring. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
+     */
     @JsonProperty("keyring")
     public String getKeyring() {
         return keyring;
     }
 
+    /**
+     * keyring is the path to key ring for RBDUser. Default is /etc/ceph/keyring. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
+     */
     @JsonProperty("keyring")
     public void setKeyring(String keyring) {
         this.keyring = keyring;
     }
 
+    /**
+     * monitors is a collection of Ceph monitors. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
+     */
     @JsonProperty("monitors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMonitors() {
         return monitors;
     }
 
+    /**
+     * monitors is a collection of Ceph monitors. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
+     */
     @JsonProperty("monitors")
     public void setMonitors(List<String> monitors) {
         this.monitors = monitors;
     }
 
+    /**
+     * pool is the rados pool name. Default is rbd. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
+     */
     @JsonProperty("pool")
     public String getPool() {
         return pool;
     }
 
+    /**
+     * pool is the rados pool name. Default is rbd. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
+     */
     @JsonProperty("pool")
     public void setPool(String pool) {
         this.pool = pool;
     }
 
+    /**
+     * readOnly here will force the ReadOnly setting in VolumeMounts. Defaults to false. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly here will force the ReadOnly setting in VolumeMounts. Defaults to false. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * Represents a Rados Block Device mount that lasts the lifetime of a pod. RBD volumes support ownership management and SELinux relabeling.
+     */
     @JsonProperty("secretRef")
     public LocalObjectReference getSecretRef() {
         return secretRef;
     }
 
+    /**
+     * Represents a Rados Block Device mount that lasts the lifetime of a pod. RBD volumes support ownership management and SELinux relabeling.
+     */
     @JsonProperty("secretRef")
     public void setSecretRef(LocalObjectReference secretRef) {
         this.secretRef = secretRef;
     }
 
+    /**
+     * user is the rados user name. Default is admin. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
+     */
     @JsonProperty("user")
     public String getUser() {
         return user;
     }
 
+    /**
+     * user is the rados user name. Default is admin. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
+     */
     @JsonProperty("user")
     public void setUser(String user) {
         this.user = user;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ReplicationController.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ReplicationController.java
index 560aaab9e78..510f9eea9ee 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ReplicationController.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ReplicationController.java
@@ -21,6 +21,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ReplicationController represents the configuration of a replication controller.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -46,14 +49,8 @@
 public class ReplicationController implements Editable<ReplicationControllerBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ReplicationController";
     @JsonProperty("metadata")
@@ -81,7 +78,7 @@ public ReplicationController(String apiVersion, String kind, ObjectMeta metadata
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -89,7 +86,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -97,7 +94,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -105,38 +102,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ReplicationController represents the configuration of a replication controller.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ReplicationController represents the configuration of a replication controller.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ReplicationController represents the configuration of a replication controller.
+     */
     @JsonProperty("spec")
     public ReplicationControllerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ReplicationController represents the configuration of a replication controller.
+     */
     @JsonProperty("spec")
     public void setSpec(ReplicationControllerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ReplicationController represents the configuration of a replication controller.
+     */
     @JsonProperty("status")
     public ReplicationControllerStatus getStatus() {
         return status;
     }
 
+    /**
+     * ReplicationController represents the configuration of a replication controller.
+     */
     @JsonProperty("status")
     public void setStatus(ReplicationControllerStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ReplicationControllerCondition.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ReplicationControllerCondition.java
index 0356120dc8c..fdee5eb110c 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ReplicationControllerCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ReplicationControllerCondition.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ReplicationControllerCondition describes the state of a replication controller at a certain point.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -65,51 +68,81 @@ public ReplicationControllerCondition(String lastTransitionTime, String message,
         this.type = type;
     }
 
+    /**
+     * ReplicationControllerCondition describes the state of a replication controller at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * ReplicationControllerCondition describes the state of a replication controller at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type of replication controller condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of replication controller condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ReplicationControllerList.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ReplicationControllerList.java
index 4f33091eb57..fcd8f5d06aa 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ReplicationControllerList.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ReplicationControllerList.java
@@ -23,6 +23,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ReplicationControllerList is a collection of replication controllers.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -47,17 +50,11 @@
 public class ReplicationControllerList implements Editable<ReplicationControllerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.ReplicationController>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.ReplicationController> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ReplicationControllerList";
     @JsonProperty("metadata")
@@ -80,7 +77,7 @@ public ReplicationControllerList(String apiVersion, List<io.fabric8.kubernetes.a
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -88,26 +85,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of replication controllers. More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.ReplicationController> getItems() {
         return items;
     }
 
+    /**
+     * List of replication controllers. More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.ReplicationController> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -115,18 +118,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ReplicationControllerList is a collection of replication controllers.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ReplicationControllerList is a collection of replication controllers.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ReplicationControllerSpec.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ReplicationControllerSpec.java
index 09b4ab8d7c5..0860f790627 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ReplicationControllerSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ReplicationControllerSpec.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ReplicationControllerSpec is the specification of a replication controller.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -62,42 +65,66 @@ public ReplicationControllerSpec(Integer minReadySeconds, Integer replicas, Map<
         this.template = template;
     }
 
+    /**
+     * Minimum number of seconds for which a newly created pod should be ready without any of its container crashing, for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready)
+     */
     @JsonProperty("minReadySeconds")
     public Integer getMinReadySeconds() {
         return minReadySeconds;
     }
 
+    /**
+     * Minimum number of seconds for which a newly created pod should be ready without any of its container crashing, for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready)
+     */
     @JsonProperty("minReadySeconds")
     public void setMinReadySeconds(Integer minReadySeconds) {
         this.minReadySeconds = minReadySeconds;
     }
 
+    /**
+     * Replicas is the number of desired replicas. This is a pointer to distinguish between explicit zero and unspecified. Defaults to 1. More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller#what-is-a-replicationcontroller
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Replicas is the number of desired replicas. This is a pointer to distinguish between explicit zero and unspecified. Defaults to 1. More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller#what-is-a-replicationcontroller
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * Selector is a label query over pods that should match the Replicas count. If Selector is empty, it is defaulted to the labels present on the Pod template. Label keys and values that must match in order to be controlled by this replication controller, if empty defaulted to labels on Pod template. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors
+     */
     @JsonProperty("selector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getSelector() {
         return selector;
     }
 
+    /**
+     * Selector is a label query over pods that should match the Replicas count. If Selector is empty, it is defaulted to the labels present on the Pod template. Label keys and values that must match in order to be controlled by this replication controller, if empty defaulted to labels on Pod template. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors
+     */
     @JsonProperty("selector")
     public void setSelector(Map<String, String> selector) {
         this.selector = selector;
     }
 
+    /**
+     * ReplicationControllerSpec is the specification of a replication controller.
+     */
     @JsonProperty("template")
     public PodTemplateSpec getTemplate() {
         return template;
     }
 
+    /**
+     * ReplicationControllerSpec is the specification of a replication controller.
+     */
     @JsonProperty("template")
     public void setTemplate(PodTemplateSpec template) {
         this.template = template;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ReplicationControllerStatus.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ReplicationControllerStatus.java
index fd3abfa214c..70d724cc7cc 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ReplicationControllerStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ReplicationControllerStatus.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ReplicationControllerStatus represents the current status of a replication controller.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -72,62 +75,98 @@ public ReplicationControllerStatus(Integer availableReplicas, List<ReplicationCo
         this.replicas = replicas;
     }
 
+    /**
+     * The number of available replicas (ready for at least minReadySeconds) for this replication controller.
+     */
     @JsonProperty("availableReplicas")
     public Integer getAvailableReplicas() {
         return availableReplicas;
     }
 
+    /**
+     * The number of available replicas (ready for at least minReadySeconds) for this replication controller.
+     */
     @JsonProperty("availableReplicas")
     public void setAvailableReplicas(Integer availableReplicas) {
         this.availableReplicas = availableReplicas;
     }
 
+    /**
+     * Represents the latest available observations of a replication controller's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ReplicationControllerCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Represents the latest available observations of a replication controller's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ReplicationControllerCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * The number of pods that have labels matching the labels of the pod template of the replication controller.
+     */
     @JsonProperty("fullyLabeledReplicas")
     public Integer getFullyLabeledReplicas() {
         return fullyLabeledReplicas;
     }
 
+    /**
+     * The number of pods that have labels matching the labels of the pod template of the replication controller.
+     */
     @JsonProperty("fullyLabeledReplicas")
     public void setFullyLabeledReplicas(Integer fullyLabeledReplicas) {
         this.fullyLabeledReplicas = fullyLabeledReplicas;
     }
 
+    /**
+     * ObservedGeneration reflects the generation of the most recently observed replication controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration reflects the generation of the most recently observed replication controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * The number of ready replicas for this replication controller.
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * The number of ready replicas for this replication controller.
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * Replicas is the most recently observed number of replicas. More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller#what-is-a-replicationcontroller
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Replicas is the most recently observed number of replicas. More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller#what-is-a-replicationcontroller
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceClaim.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceClaim.java
index c3b38e3d925..5e69a6afdf4 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceClaim.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceClaim.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaim references one entry in PodSpec.ResourceClaims.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public ResourceClaim(String name, String request) {
         this.request = request;
     }
 
+    /**
+     * Name must match the name of one entry in pod.spec.resourceClaims of the Pod where this field is used. It makes that resource available inside a container.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name must match the name of one entry in pod.spec.resourceClaims of the Pod where this field is used. It makes that resource available inside a container.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Request is the name chosen for a request in the referenced claim. If empty, everything from the claim is made available, otherwise only the result of this request.
+     */
     @JsonProperty("request")
     public String getRequest() {
         return request;
     }
 
+    /**
+     * Request is the name chosen for a request in the referenced claim. If empty, everything from the claim is made available, otherwise only the result of this request.
+     */
     @JsonProperty("request")
     public void setRequest(String request) {
         this.request = request;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceFieldSelector.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceFieldSelector.java
index 301c74bf016..4b2649d1b43 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceFieldSelector.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceFieldSelector.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceFieldSelector represents container resources (cpu, memory) and their output format
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -57,31 +60,49 @@ public ResourceFieldSelector(String containerName, Quantity divisor, String reso
         this.resource = resource;
     }
 
+    /**
+     * Container name: required for volumes, optional for env vars
+     */
     @JsonProperty("containerName")
     public String getContainerName() {
         return containerName;
     }
 
+    /**
+     * Container name: required for volumes, optional for env vars
+     */
     @JsonProperty("containerName")
     public void setContainerName(String containerName) {
         this.containerName = containerName;
     }
 
+    /**
+     * ResourceFieldSelector represents container resources (cpu, memory) and their output format
+     */
     @JsonProperty("divisor")
     public Quantity getDivisor() {
         return divisor;
     }
 
+    /**
+     * ResourceFieldSelector represents container resources (cpu, memory) and their output format
+     */
     @JsonProperty("divisor")
     public void setDivisor(Quantity divisor) {
         this.divisor = divisor;
     }
 
+    /**
+     * Required: resource to select
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * Required: resource to select
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceHealth.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceHealth.java
index a36689d9c11..d459a0988a5 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceHealth.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceHealth.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceHealth represents the health of a resource. It has the latest device health information. This is a part of KEP https://kep.k8s.io/4680.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public ResourceHealth(String health, String resourceID) {
         this.resourceID = resourceID;
     }
 
+    /**
+     * Health of the resource. can be one of:<br><p>  - Healthy: operates as normal<br><p>  - Unhealthy: reported unhealthy. We consider this a temporary health issue<br><p>               since we do not have a mechanism today to distinguish<br><p>               temporary and permanent issues.<br><p>  - Unknown: The status cannot be determined.<br><p>             For example, Device Plugin got unregistered and hasn't been re-registered since.<br><p> <br><p> In future we may want to introduce the PermanentlyUnhealthy Status.
+     */
     @JsonProperty("health")
     public String getHealth() {
         return health;
     }
 
+    /**
+     * Health of the resource. can be one of:<br><p>  - Healthy: operates as normal<br><p>  - Unhealthy: reported unhealthy. We consider this a temporary health issue<br><p>               since we do not have a mechanism today to distinguish<br><p>               temporary and permanent issues.<br><p>  - Unknown: The status cannot be determined.<br><p>             For example, Device Plugin got unregistered and hasn't been re-registered since.<br><p> <br><p> In future we may want to introduce the PermanentlyUnhealthy Status.
+     */
     @JsonProperty("health")
     public void setHealth(String health) {
         this.health = health;
     }
 
+    /**
+     * ResourceID is the unique identifier of the resource. See the ResourceID type for more information.
+     */
     @JsonProperty("resourceID")
     public String getResourceID() {
         return resourceID;
     }
 
+    /**
+     * ResourceID is the unique identifier of the resource. See the ResourceID type for more information.
+     */
     @JsonProperty("resourceID")
     public void setResourceID(String resourceID) {
         this.resourceID = resourceID;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceQuota.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceQuota.java
index f31bd558ea7..38eb5343422 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceQuota.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceQuota.java
@@ -21,6 +21,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceQuota sets aggregate quota restrictions enforced per namespace
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -46,14 +49,8 @@
 public class ResourceQuota implements Editable<ResourceQuotaBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResourceQuota";
     @JsonProperty("metadata")
@@ -81,7 +78,7 @@ public ResourceQuota(String apiVersion, String kind, ObjectMeta metadata, Resour
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -89,7 +86,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -97,7 +94,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -105,38 +102,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResourceQuota sets aggregate quota restrictions enforced per namespace
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceQuota sets aggregate quota restrictions enforced per namespace
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ResourceQuota sets aggregate quota restrictions enforced per namespace
+     */
     @JsonProperty("spec")
     public ResourceQuotaSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ResourceQuota sets aggregate quota restrictions enforced per namespace
+     */
     @JsonProperty("spec")
     public void setSpec(ResourceQuotaSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ResourceQuota sets aggregate quota restrictions enforced per namespace
+     */
     @JsonProperty("status")
     public ResourceQuotaStatus getStatus() {
         return status;
     }
 
+    /**
+     * ResourceQuota sets aggregate quota restrictions enforced per namespace
+     */
     @JsonProperty("status")
     public void setStatus(ResourceQuotaStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceQuotaList.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceQuotaList.java
index d817b76afa2..42ff7152eef 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceQuotaList.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceQuotaList.java
@@ -23,6 +23,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceQuotaList is a list of ResourceQuota items.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -47,17 +50,11 @@
 public class ResourceQuotaList implements Editable<ResourceQuotaListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.ResourceQuota>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.ResourceQuota> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResourceQuotaList";
     @JsonProperty("metadata")
@@ -80,7 +77,7 @@ public ResourceQuotaList(String apiVersion, List<io.fabric8.kubernetes.api.model
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -88,26 +85,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of ResourceQuota objects. More info: https://kubernetes.io/docs/concepts/policy/resource-quotas/
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.ResourceQuota> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of ResourceQuota objects. More info: https://kubernetes.io/docs/concepts/policy/resource-quotas/
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.ResourceQuota> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -115,18 +118,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResourceQuotaList is a list of ResourceQuota items.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceQuotaList is a list of ResourceQuota items.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceQuotaSpec.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceQuotaSpec.java
index 2a253a6c6ee..09b5b220186 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceQuotaSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceQuotaSpec.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceQuotaSpec defines the desired hard limits to enforce for Quota.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -61,33 +64,51 @@ public ResourceQuotaSpec(Map<String, Quantity> hard, ScopeSelector scopeSelector
         this.scopes = scopes;
     }
 
+    /**
+     * hard is the set of desired hard limits for each named resource. More info: https://kubernetes.io/docs/concepts/policy/resource-quotas/
+     */
     @JsonProperty("hard")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getHard() {
         return hard;
     }
 
+    /**
+     * hard is the set of desired hard limits for each named resource. More info: https://kubernetes.io/docs/concepts/policy/resource-quotas/
+     */
     @JsonProperty("hard")
     public void setHard(Map<String, Quantity> hard) {
         this.hard = hard;
     }
 
+    /**
+     * ResourceQuotaSpec defines the desired hard limits to enforce for Quota.
+     */
     @JsonProperty("scopeSelector")
     public ScopeSelector getScopeSelector() {
         return scopeSelector;
     }
 
+    /**
+     * ResourceQuotaSpec defines the desired hard limits to enforce for Quota.
+     */
     @JsonProperty("scopeSelector")
     public void setScopeSelector(ScopeSelector scopeSelector) {
         this.scopeSelector = scopeSelector;
     }
 
+    /**
+     * A collection of filters that must match each object tracked by a quota. If not specified, the quota matches all objects.
+     */
     @JsonProperty("scopes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getScopes() {
         return scopes;
     }
 
+    /**
+     * A collection of filters that must match each object tracked by a quota. If not specified, the quota matches all objects.
+     */
     @JsonProperty("scopes")
     public void setScopes(List<String> scopes) {
         this.scopes = scopes;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceQuotaStatus.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceQuotaStatus.java
index a39b7d61b0c..adc2838d225 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceQuotaStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceQuotaStatus.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceQuotaStatus defines the enforced hard limits and observed use.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -55,23 +58,35 @@ public ResourceQuotaStatus(Map<String, Quantity> hard, Map<String, Quantity> use
         this.used = used;
     }
 
+    /**
+     * Hard is the set of enforced hard limits for each named resource. More info: https://kubernetes.io/docs/concepts/policy/resource-quotas/
+     */
     @JsonProperty("hard")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getHard() {
         return hard;
     }
 
+    /**
+     * Hard is the set of enforced hard limits for each named resource. More info: https://kubernetes.io/docs/concepts/policy/resource-quotas/
+     */
     @JsonProperty("hard")
     public void setHard(Map<String, Quantity> hard) {
         this.hard = hard;
     }
 
+    /**
+     * Used is the current observed total usage of the resource in the namespace.
+     */
     @JsonProperty("used")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getUsed() {
         return used;
     }
 
+    /**
+     * Used is the current observed total usage of the resource in the namespace.
+     */
     @JsonProperty("used")
     public void setUsed(Map<String, Quantity> used) {
         this.used = used;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceRequirements.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceRequirements.java
index 42cbeec04f0..37ff165b4e9 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceRequirements.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceRequirements.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceRequirements describes the compute resource requirements.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -62,34 +65,52 @@ public ResourceRequirements(List<ResourceClaim> claims, Map<String, Quantity> li
         this.requests = requests;
     }
 
+    /**
+     * Claims lists the names of resources, defined in spec.resourceClaims, that are used by this container.<br><p> <br><p> This is an alpha field and requires enabling the DynamicResourceAllocation feature gate.<br><p> <br><p> This field is immutable. It can only be set for containers.
+     */
     @JsonProperty("claims")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ResourceClaim> getClaims() {
         return claims;
     }
 
+    /**
+     * Claims lists the names of resources, defined in spec.resourceClaims, that are used by this container.<br><p> <br><p> This is an alpha field and requires enabling the DynamicResourceAllocation feature gate.<br><p> <br><p> This field is immutable. It can only be set for containers.
+     */
     @JsonProperty("claims")
     public void setClaims(List<ResourceClaim> claims) {
         this.claims = claims;
     }
 
+    /**
+     * Limits describes the maximum amount of compute resources allowed. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
+     */
     @JsonProperty("limits")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getLimits() {
         return limits;
     }
 
+    /**
+     * Limits describes the maximum amount of compute resources allowed. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
+     */
     @JsonProperty("limits")
     public void setLimits(Map<String, Quantity> limits) {
         this.limits = limits;
     }
 
+    /**
+     * Requests describes the minimum amount of compute resources required. If Requests is omitted for a container, it defaults to Limits if that is explicitly specified, otherwise to an implementation-defined value. Requests cannot exceed Limits. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
+     */
     @JsonProperty("requests")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getRequests() {
         return requests;
     }
 
+    /**
+     * Requests describes the minimum amount of compute resources required. If Requests is omitted for a container, it defaults to Limits if that is explicitly specified, otherwise to an implementation-defined value. Requests cannot exceed Limits. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
+     */
     @JsonProperty("requests")
     public void setRequests(Map<String, Quantity> requests) {
         this.requests = requests;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceStatus.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceStatus.java
index 91d3003a643..c30d1d5e7fb 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ResourceStatus.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceStatus represents the status of a single resource allocated to a Pod.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -56,22 +59,34 @@ public ResourceStatus(String name, List<ResourceHealth> resources) {
         this.resources = resources;
     }
 
+    /**
+     * Name of the resource. Must be unique within the pod and in case of non-DRA resource, match one of the resources from the pod spec. For DRA resources, the value must be "claim:&lt;claim_name&gt;/&lt;request&gt;". When this status is reported about a container, the "claim_name" and "request" must match one of the claims of this container.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the resource. Must be unique within the pod and in case of non-DRA resource, match one of the resources from the pod spec. For DRA resources, the value must be "claim:&lt;claim_name&gt;/&lt;request&gt;". When this status is reported about a container, the "claim_name" and "request" must match one of the claims of this container.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * List of unique resources health. Each element in the list contains an unique resource ID and its health. At a minimum, for the lifetime of a Pod, resource ID must uniquely identify the resource allocated to the Pod on the Node. If other Pod on the same Node reports the status with the same resource ID, it must be the same resource they share. See ResourceID type definition for a specific format it has in various use cases.
+     */
     @JsonProperty("resources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ResourceHealth> getResources() {
         return resources;
     }
 
+    /**
+     * List of unique resources health. Each element in the list contains an unique resource ID and its health. At a minimum, for the lifetime of a Pod, resource ID must uniquely identify the resource allocated to the Pod on the Node. If other Pod on the same Node reports the status with the same resource ID, it must be the same resource they share. See ResourceID type definition for a specific format it has in various use cases.
+     */
     @JsonProperty("resources")
     public void setResources(List<ResourceHealth> resources) {
         this.resources = resources;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SELinuxOptions.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SELinuxOptions.java
index 4a09eb44f65..e857310e00f 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SELinuxOptions.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SELinuxOptions.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SELinuxOptions are the labels to be applied to the container
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -61,41 +64,65 @@ public SELinuxOptions(String level, String role, String type, String user) {
         this.user = user;
     }
 
+    /**
+     * Level is SELinux level label that applies to the container.
+     */
     @JsonProperty("level")
     public String getLevel() {
         return level;
     }
 
+    /**
+     * Level is SELinux level label that applies to the container.
+     */
     @JsonProperty("level")
     public void setLevel(String level) {
         this.level = level;
     }
 
+    /**
+     * Role is a SELinux role label that applies to the container.
+     */
     @JsonProperty("role")
     public String getRole() {
         return role;
     }
 
+    /**
+     * Role is a SELinux role label that applies to the container.
+     */
     @JsonProperty("role")
     public void setRole(String role) {
         this.role = role;
     }
 
+    /**
+     * Type is a SELinux type label that applies to the container.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is a SELinux type label that applies to the container.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * User is a SELinux user label that applies to the container.
+     */
     @JsonProperty("user")
     public String getUser() {
         return user;
     }
 
+    /**
+     * User is a SELinux user label that applies to the container.
+     */
     @JsonProperty("user")
     public void setUser(String user) {
         this.user = user;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ScaleIOPersistentVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ScaleIOPersistentVolumeSource.java
index 0c52b1eb9c8..e8dcabfa2ca 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ScaleIOPersistentVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ScaleIOPersistentVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ScaleIOPersistentVolumeSource represents a persistent ScaleIO volume
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,101 +88,161 @@ public ScaleIOPersistentVolumeSource(String fsType, String gateway, String prote
         this.volumeName = volumeName;
     }
 
+    /**
+     * fsType is the filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". Default is "xfs"
+     */
     @JsonProperty("fsType")
     public String getFsType() {
         return fsType;
     }
 
+    /**
+     * fsType is the filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". Default is "xfs"
+     */
     @JsonProperty("fsType")
     public void setFsType(String fsType) {
         this.fsType = fsType;
     }
 
+    /**
+     * gateway is the host address of the ScaleIO API Gateway.
+     */
     @JsonProperty("gateway")
     public String getGateway() {
         return gateway;
     }
 
+    /**
+     * gateway is the host address of the ScaleIO API Gateway.
+     */
     @JsonProperty("gateway")
     public void setGateway(String gateway) {
         this.gateway = gateway;
     }
 
+    /**
+     * protectionDomain is the name of the ScaleIO Protection Domain for the configured storage.
+     */
     @JsonProperty("protectionDomain")
     public String getProtectionDomain() {
         return protectionDomain;
     }
 
+    /**
+     * protectionDomain is the name of the ScaleIO Protection Domain for the configured storage.
+     */
     @JsonProperty("protectionDomain")
     public void setProtectionDomain(String protectionDomain) {
         this.protectionDomain = protectionDomain;
     }
 
+    /**
+     * readOnly defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * ScaleIOPersistentVolumeSource represents a persistent ScaleIO volume
+     */
     @JsonProperty("secretRef")
     public SecretReference getSecretRef() {
         return secretRef;
     }
 
+    /**
+     * ScaleIOPersistentVolumeSource represents a persistent ScaleIO volume
+     */
     @JsonProperty("secretRef")
     public void setSecretRef(SecretReference secretRef) {
         this.secretRef = secretRef;
     }
 
+    /**
+     * sslEnabled is the flag to enable/disable SSL communication with Gateway, default false
+     */
     @JsonProperty("sslEnabled")
     public Boolean getSslEnabled() {
         return sslEnabled;
     }
 
+    /**
+     * sslEnabled is the flag to enable/disable SSL communication with Gateway, default false
+     */
     @JsonProperty("sslEnabled")
     public void setSslEnabled(Boolean sslEnabled) {
         this.sslEnabled = sslEnabled;
     }
 
+    /**
+     * storageMode indicates whether the storage for a volume should be ThickProvisioned or ThinProvisioned. Default is ThinProvisioned.
+     */
     @JsonProperty("storageMode")
     public String getStorageMode() {
         return storageMode;
     }
 
+    /**
+     * storageMode indicates whether the storage for a volume should be ThickProvisioned or ThinProvisioned. Default is ThinProvisioned.
+     */
     @JsonProperty("storageMode")
     public void setStorageMode(String storageMode) {
         this.storageMode = storageMode;
     }
 
+    /**
+     * storagePool is the ScaleIO Storage Pool associated with the protection domain.
+     */
     @JsonProperty("storagePool")
     public String getStoragePool() {
         return storagePool;
     }
 
+    /**
+     * storagePool is the ScaleIO Storage Pool associated with the protection domain.
+     */
     @JsonProperty("storagePool")
     public void setStoragePool(String storagePool) {
         this.storagePool = storagePool;
     }
 
+    /**
+     * system is the name of the storage system as configured in ScaleIO.
+     */
     @JsonProperty("system")
     public String getSystem() {
         return system;
     }
 
+    /**
+     * system is the name of the storage system as configured in ScaleIO.
+     */
     @JsonProperty("system")
     public void setSystem(String system) {
         this.system = system;
     }
 
+    /**
+     * volumeName is the name of a volume already created in the ScaleIO system that is associated with this volume source.
+     */
     @JsonProperty("volumeName")
     public String getVolumeName() {
         return volumeName;
     }
 
+    /**
+     * volumeName is the name of a volume already created in the ScaleIO system that is associated with this volume source.
+     */
     @JsonProperty("volumeName")
     public void setVolumeName(String volumeName) {
         this.volumeName = volumeName;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ScaleIOVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ScaleIOVolumeSource.java
index 0a34f654a4b..b05e2f6103b 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ScaleIOVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ScaleIOVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ScaleIOVolumeSource represents a persistent ScaleIO volume
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,101 +88,161 @@ public ScaleIOVolumeSource(String fsType, String gateway, String protectionDomai
         this.volumeName = volumeName;
     }
 
+    /**
+     * fsType is the filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". Default is "xfs".
+     */
     @JsonProperty("fsType")
     public String getFsType() {
         return fsType;
     }
 
+    /**
+     * fsType is the filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". Default is "xfs".
+     */
     @JsonProperty("fsType")
     public void setFsType(String fsType) {
         this.fsType = fsType;
     }
 
+    /**
+     * gateway is the host address of the ScaleIO API Gateway.
+     */
     @JsonProperty("gateway")
     public String getGateway() {
         return gateway;
     }
 
+    /**
+     * gateway is the host address of the ScaleIO API Gateway.
+     */
     @JsonProperty("gateway")
     public void setGateway(String gateway) {
         this.gateway = gateway;
     }
 
+    /**
+     * protectionDomain is the name of the ScaleIO Protection Domain for the configured storage.
+     */
     @JsonProperty("protectionDomain")
     public String getProtectionDomain() {
         return protectionDomain;
     }
 
+    /**
+     * protectionDomain is the name of the ScaleIO Protection Domain for the configured storage.
+     */
     @JsonProperty("protectionDomain")
     public void setProtectionDomain(String protectionDomain) {
         this.protectionDomain = protectionDomain;
     }
 
+    /**
+     * readOnly Defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly Defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * ScaleIOVolumeSource represents a persistent ScaleIO volume
+     */
     @JsonProperty("secretRef")
     public LocalObjectReference getSecretRef() {
         return secretRef;
     }
 
+    /**
+     * ScaleIOVolumeSource represents a persistent ScaleIO volume
+     */
     @JsonProperty("secretRef")
     public void setSecretRef(LocalObjectReference secretRef) {
         this.secretRef = secretRef;
     }
 
+    /**
+     * sslEnabled Flag enable/disable SSL communication with Gateway, default false
+     */
     @JsonProperty("sslEnabled")
     public Boolean getSslEnabled() {
         return sslEnabled;
     }
 
+    /**
+     * sslEnabled Flag enable/disable SSL communication with Gateway, default false
+     */
     @JsonProperty("sslEnabled")
     public void setSslEnabled(Boolean sslEnabled) {
         this.sslEnabled = sslEnabled;
     }
 
+    /**
+     * storageMode indicates whether the storage for a volume should be ThickProvisioned or ThinProvisioned. Default is ThinProvisioned.
+     */
     @JsonProperty("storageMode")
     public String getStorageMode() {
         return storageMode;
     }
 
+    /**
+     * storageMode indicates whether the storage for a volume should be ThickProvisioned or ThinProvisioned. Default is ThinProvisioned.
+     */
     @JsonProperty("storageMode")
     public void setStorageMode(String storageMode) {
         this.storageMode = storageMode;
     }
 
+    /**
+     * storagePool is the ScaleIO Storage Pool associated with the protection domain.
+     */
     @JsonProperty("storagePool")
     public String getStoragePool() {
         return storagePool;
     }
 
+    /**
+     * storagePool is the ScaleIO Storage Pool associated with the protection domain.
+     */
     @JsonProperty("storagePool")
     public void setStoragePool(String storagePool) {
         this.storagePool = storagePool;
     }
 
+    /**
+     * system is the name of the storage system as configured in ScaleIO.
+     */
     @JsonProperty("system")
     public String getSystem() {
         return system;
     }
 
+    /**
+     * system is the name of the storage system as configured in ScaleIO.
+     */
     @JsonProperty("system")
     public void setSystem(String system) {
         this.system = system;
     }
 
+    /**
+     * volumeName is the name of a volume already created in the ScaleIO system that is associated with this volume source.
+     */
     @JsonProperty("volumeName")
     public String getVolumeName() {
         return volumeName;
     }
 
+    /**
+     * volumeName is the name of a volume already created in the ScaleIO system that is associated with this volume source.
+     */
     @JsonProperty("volumeName")
     public void setVolumeName(String volumeName) {
         this.volumeName = volumeName;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ScopeSelector.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ScopeSelector.java
index c7441b82a3e..2cf56b1a299 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ScopeSelector.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ScopeSelector.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * A scope selector represents the AND of the selectors represented by the scoped-resource selector requirements.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -52,12 +55,18 @@ public ScopeSelector(List<ScopedResourceSelectorRequirement> matchExpressions) {
         this.matchExpressions = matchExpressions;
     }
 
+    /**
+     * A list of scope selector requirements by scope of the resources.
+     */
     @JsonProperty("matchExpressions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ScopedResourceSelectorRequirement> getMatchExpressions() {
         return matchExpressions;
     }
 
+    /**
+     * A list of scope selector requirements by scope of the resources.
+     */
     @JsonProperty("matchExpressions")
     public void setMatchExpressions(List<ScopedResourceSelectorRequirement> matchExpressions) {
         this.matchExpressions = matchExpressions;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ScopedResourceSelectorRequirement.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ScopedResourceSelectorRequirement.java
index 2f470f52915..2ee652a564e 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ScopedResourceSelectorRequirement.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ScopedResourceSelectorRequirement.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * A scoped-resource selector requirement is a selector that contains values, a scope name, and an operator that relates the scope name and values.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -60,32 +63,50 @@ public ScopedResourceSelectorRequirement(String operator, String scopeName, List
         this.values = values;
     }
 
+    /**
+     * Represents a scope's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist.
+     */
     @JsonProperty("operator")
     public String getOperator() {
         return operator;
     }
 
+    /**
+     * Represents a scope's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist.
+     */
     @JsonProperty("operator")
     public void setOperator(String operator) {
         this.operator = operator;
     }
 
+    /**
+     * The name of the scope that the selector applies to.
+     */
     @JsonProperty("scopeName")
     public String getScopeName() {
         return scopeName;
     }
 
+    /**
+     * The name of the scope that the selector applies to.
+     */
     @JsonProperty("scopeName")
     public void setScopeName(String scopeName) {
         this.scopeName = scopeName;
     }
 
+    /**
+     * An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. This array is replaced during a strategic merge patch.
+     */
     @JsonProperty("values")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getValues() {
         return values;
     }
 
+    /**
+     * An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. This array is replaced during a strategic merge patch.
+     */
     @JsonProperty("values")
     public void setValues(List<String> values) {
         this.values = values;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SeccompProfile.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SeccompProfile.java
index 9474c90dbe2..3054deceaff 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SeccompProfile.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SeccompProfile.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SeccompProfile defines a pod/container's seccomp profile settings. Only one profile source may be set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public SeccompProfile(String localhostProfile, String type) {
         this.type = type;
     }
 
+    /**
+     * localhostProfile indicates a profile defined in a file on the node should be used. The profile must be preconfigured on the node to work. Must be a descending path, relative to the kubelet's configured seccomp profile location. Must be set if type is "Localhost". Must NOT be set for any other type.
+     */
     @JsonProperty("localhostProfile")
     public String getLocalhostProfile() {
         return localhostProfile;
     }
 
+    /**
+     * localhostProfile indicates a profile defined in a file on the node should be used. The profile must be preconfigured on the node to work. Must be a descending path, relative to the kubelet's configured seccomp profile location. Must be set if type is "Localhost". Must NOT be set for any other type.
+     */
     @JsonProperty("localhostProfile")
     public void setLocalhostProfile(String localhostProfile) {
         this.localhostProfile = localhostProfile;
     }
 
+    /**
+     * type indicates which kind of seccomp profile will be applied. Valid options are:<br><p> <br><p> Localhost - a profile defined in a file on the node should be used. RuntimeDefault - the container runtime default profile should be used. Unconfined - no profile should be applied.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type indicates which kind of seccomp profile will be applied. Valid options are:<br><p> <br><p> Localhost - a profile defined in a file on the node should be used. RuntimeDefault - the container runtime default profile should be used. Unconfined - no profile should be applied.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Secret.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Secret.java
index 02f26030db1..5c72a26497e 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Secret.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Secret.java
@@ -21,6 +21,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Secret holds secret data of a certain type. The total bytes of the values in the Data field must be less than MaxSecretSize bytes.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -48,9 +51,6 @@
 public class Secret implements Editable<SecretBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("data")
@@ -58,9 +58,6 @@ public class Secret implements Editable<SecretBuilder>, HasMetadata, Namespaced
     private Map<String, String> data = new LinkedHashMap<>();
     @JsonProperty("immutable")
     private Boolean immutable;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Secret";
     @JsonProperty("metadata")
@@ -91,7 +88,7 @@ public Secret(String apiVersion, Map<String, String> data, Boolean immutable, St
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -99,36 +96,48 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Data contains the secret data. Each key must consist of alphanumeric characters, '-', '_' or '.'. The serialized form of the secret data is a base64 encoded string, representing the arbitrary (possibly non-string) data value here. Described in https://tools.ietf.org/html/rfc4648#section-4
+     */
     @JsonProperty("data")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getData() {
         return data;
     }
 
+    /**
+     * Data contains the secret data. Each key must consist of alphanumeric characters, '-', '_' or '.'. The serialized form of the secret data is a base64 encoded string, representing the arbitrary (possibly non-string) data value here. Described in https://tools.ietf.org/html/rfc4648#section-4
+     */
     @JsonProperty("data")
     public void setData(Map<String, String> data) {
         this.data = data;
     }
 
+    /**
+     * Immutable, if set to true, ensures that data stored in the Secret cannot be updated (only object metadata can be modified). If not set to true, the field can be modified at any time. Defaulted to nil.
+     */
     @JsonProperty("immutable")
     public Boolean getImmutable() {
         return immutable;
     }
 
+    /**
+     * Immutable, if set to true, ensures that data stored in the Secret cannot be updated (only object metadata can be modified). If not set to true, the field can be modified at any time. Defaulted to nil.
+     */
     @JsonProperty("immutable")
     public void setImmutable(Boolean immutable) {
         this.immutable = immutable;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,39 +145,57 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Secret holds secret data of a certain type. The total bytes of the values in the Data field must be less than MaxSecretSize bytes.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Secret holds secret data of a certain type. The total bytes of the values in the Data field must be less than MaxSecretSize bytes.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * stringData allows specifying non-binary secret data in string form. It is provided as a write-only input field for convenience. All keys and values are merged into the data field on write, overwriting any existing values. The stringData field is never output when reading from the API.
+     */
     @JsonProperty("stringData")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getStringData() {
         return stringData;
     }
 
+    /**
+     * stringData allows specifying non-binary secret data in string form. It is provided as a write-only input field for convenience. All keys and values are merged into the data field on write, overwriting any existing values. The stringData field is never output when reading from the API.
+     */
     @JsonProperty("stringData")
     public void setStringData(Map<String, String> stringData) {
         this.stringData = stringData;
     }
 
+    /**
+     * Used to facilitate programmatic handling of secret data. More info: https://kubernetes.io/docs/concepts/configuration/secret/#secret-types
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Used to facilitate programmatic handling of secret data. More info: https://kubernetes.io/docs/concepts/configuration/secret/#secret-types
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SecretEnvSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SecretEnvSource.java
index f291f6465c0..e2ff4eb8b77 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SecretEnvSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SecretEnvSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SecretEnvSource selects a Secret to populate the environment variables with.<br><p> <br><p> The contents of the target Secret's Data field will represent the key-value pairs as environment variables.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public SecretEnvSource(String name, Boolean optional) {
         this.optional = optional;
     }
 
+    /**
+     * Name of the referent. This field is effectively required, but due to backwards compatibility is allowed to be empty. Instances of this type with an empty value here are almost certainly wrong. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referent. This field is effectively required, but due to backwards compatibility is allowed to be empty. Instances of this type with an empty value here are almost certainly wrong. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Specify whether the Secret must be defined
+     */
     @JsonProperty("optional")
     public Boolean getOptional() {
         return optional;
     }
 
+    /**
+     * Specify whether the Secret must be defined
+     */
     @JsonProperty("optional")
     public void setOptional(Boolean optional) {
         this.optional = optional;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SecretKeySelector.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SecretKeySelector.java
index c35579f2f4f..ef1101fa745 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SecretKeySelector.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SecretKeySelector.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SecretKeySelector selects a key of a Secret.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -57,31 +60,49 @@ public SecretKeySelector(String key, String name, Boolean optional) {
         this.optional = optional;
     }
 
+    /**
+     * The key of the secret to select from.  Must be a valid secret key.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * The key of the secret to select from.  Must be a valid secret key.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * Name of the referent. This field is effectively required, but due to backwards compatibility is allowed to be empty. Instances of this type with an empty value here are almost certainly wrong. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referent. This field is effectively required, but due to backwards compatibility is allowed to be empty. Instances of this type with an empty value here are almost certainly wrong. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Specify whether the Secret or its key must be defined
+     */
     @JsonProperty("optional")
     public Boolean getOptional() {
         return optional;
     }
 
+    /**
+     * Specify whether the Secret or its key must be defined
+     */
     @JsonProperty("optional")
     public void setOptional(Boolean optional) {
         this.optional = optional;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SecretList.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SecretList.java
index f2089a613c9..12af13f0161 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SecretList.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SecretList.java
@@ -23,6 +23,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SecretList is a list of Secret.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -47,17 +50,11 @@
 public class SecretList implements Editable<SecretListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.Secret>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.Secret> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SecretList";
     @JsonProperty("metadata")
@@ -80,7 +77,7 @@ public SecretList(String apiVersion, List<io.fabric8.kubernetes.api.model.Secret
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -88,26 +85,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of secret objects. More info: https://kubernetes.io/docs/concepts/configuration/secret
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.Secret> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of secret objects. More info: https://kubernetes.io/docs/concepts/configuration/secret
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.Secret> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -115,18 +118,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SecretList is a list of Secret.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SecretList is a list of Secret.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SecretProjection.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SecretProjection.java
index 785ca28a560..a09b3aa925e 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SecretProjection.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SecretProjection.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Adapts a secret into a projected volume.<br><p> <br><p> The contents of the target Secret's Data field will be presented in a projected volume as files using the keys in the Data field as the file names. Note that this is identical to a secret volume source without the default mode.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -60,32 +63,50 @@ public SecretProjection(List<KeyToPath> items, String name, Boolean optional) {
         this.optional = optional;
     }
 
+    /**
+     * items if unspecified, each key-value pair in the Data field of the referenced Secret will be projected into the volume as a file whose name is the key and content is the value. If specified, the listed keys will be projected into the specified paths, and unlisted keys will not be present. If a key is specified which is not present in the Secret, the volume setup will error unless it is marked optional. Paths must be relative and may not contain the '..' path or start with '..'.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<KeyToPath> getItems() {
         return items;
     }
 
+    /**
+     * items if unspecified, each key-value pair in the Data field of the referenced Secret will be projected into the volume as a file whose name is the key and content is the value. If specified, the listed keys will be projected into the specified paths, and unlisted keys will not be present. If a key is specified which is not present in the Secret, the volume setup will error unless it is marked optional. Paths must be relative and may not contain the '..' path or start with '..'.
+     */
     @JsonProperty("items")
     public void setItems(List<KeyToPath> items) {
         this.items = items;
     }
 
+    /**
+     * Name of the referent. This field is effectively required, but due to backwards compatibility is allowed to be empty. Instances of this type with an empty value here are almost certainly wrong. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referent. This field is effectively required, but due to backwards compatibility is allowed to be empty. Instances of this type with an empty value here are almost certainly wrong. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * optional field specify whether the Secret or its key must be defined
+     */
     @JsonProperty("optional")
     public Boolean getOptional() {
         return optional;
     }
 
+    /**
+     * optional field specify whether the Secret or its key must be defined
+     */
     @JsonProperty("optional")
     public void setOptional(Boolean optional) {
         this.optional = optional;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SecretReference.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SecretReference.java
index 63cdeb99103..42f6b7b1a71 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SecretReference.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SecretReference.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SecretReference represents a Secret Reference. It has enough information to retrieve secret in any namespace
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public SecretReference(String name, String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * name is unique within a namespace to reference a secret resource.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is unique within a namespace to reference a secret resource.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * namespace defines the space within which the secret name must be unique.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * namespace defines the space within which the secret name must be unique.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SecretVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SecretVolumeSource.java
index a325c411925..37b01bd2321 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SecretVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SecretVolumeSource.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Adapts a Secret into a volume.<br><p> <br><p> The contents of the target Secret's Data field will be presented in a volume as files using the keys in the Data field as the file names. Secret volumes support ownership management and SELinux relabeling.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -64,42 +67,66 @@ public SecretVolumeSource(Integer defaultMode, List<KeyToPath> items, Boolean op
         this.secretName = secretName;
     }
 
+    /**
+     * defaultMode is Optional: mode bits used to set permissions on created files by default. Must be an octal value between 0000 and 0777 or a decimal value between 0 and 511. YAML accepts both octal and decimal values, JSON requires decimal values for mode bits. Defaults to 0644. Directories within the path are not affected by this setting. This might be in conflict with other options that affect the file mode, like fsGroup, and the result can be other mode bits set.
+     */
     @JsonProperty("defaultMode")
     public Integer getDefaultMode() {
         return defaultMode;
     }
 
+    /**
+     * defaultMode is Optional: mode bits used to set permissions on created files by default. Must be an octal value between 0000 and 0777 or a decimal value between 0 and 511. YAML accepts both octal and decimal values, JSON requires decimal values for mode bits. Defaults to 0644. Directories within the path are not affected by this setting. This might be in conflict with other options that affect the file mode, like fsGroup, and the result can be other mode bits set.
+     */
     @JsonProperty("defaultMode")
     public void setDefaultMode(Integer defaultMode) {
         this.defaultMode = defaultMode;
     }
 
+    /**
+     * items If unspecified, each key-value pair in the Data field of the referenced Secret will be projected into the volume as a file whose name is the key and content is the value. If specified, the listed keys will be projected into the specified paths, and unlisted keys will not be present. If a key is specified which is not present in the Secret, the volume setup will error unless it is marked optional. Paths must be relative and may not contain the '..' path or start with '..'.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<KeyToPath> getItems() {
         return items;
     }
 
+    /**
+     * items If unspecified, each key-value pair in the Data field of the referenced Secret will be projected into the volume as a file whose name is the key and content is the value. If specified, the listed keys will be projected into the specified paths, and unlisted keys will not be present. If a key is specified which is not present in the Secret, the volume setup will error unless it is marked optional. Paths must be relative and may not contain the '..' path or start with '..'.
+     */
     @JsonProperty("items")
     public void setItems(List<KeyToPath> items) {
         this.items = items;
     }
 
+    /**
+     * optional field specify whether the Secret or its keys must be defined
+     */
     @JsonProperty("optional")
     public Boolean getOptional() {
         return optional;
     }
 
+    /**
+     * optional field specify whether the Secret or its keys must be defined
+     */
     @JsonProperty("optional")
     public void setOptional(Boolean optional) {
         this.optional = optional;
     }
 
+    /**
+     * secretName is the name of the secret in the pod's namespace to use. More info: https://kubernetes.io/docs/concepts/storage/volumes#secret
+     */
     @JsonProperty("secretName")
     public String getSecretName() {
         return secretName;
     }
 
+    /**
+     * secretName is the name of the secret in the pod's namespace to use. More info: https://kubernetes.io/docs/concepts/storage/volumes#secret
+     */
     @JsonProperty("secretName")
     public void setSecretName(String secretName) {
         this.secretName = secretName;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SecurityContext.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SecurityContext.java
index 97ad63a8681..1706038ff16 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SecurityContext.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SecurityContext.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SecurityContext holds security configuration that will be applied to a container. Some fields are present in both SecurityContext and PodSecurityContext.  When both are set, the values in SecurityContext take precedence.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,121 +96,193 @@ public SecurityContext(Boolean allowPrivilegeEscalation, AppArmorProfile appArmo
         this.windowsOptions = windowsOptions;
     }
 
+    /**
+     * AllowPrivilegeEscalation controls whether a process can gain more privileges than its parent process. This bool directly controls if the no_new_privs flag will be set on the container process. AllowPrivilegeEscalation is true always when the container is: 1) run as Privileged 2) has CAP_SYS_ADMIN Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("allowPrivilegeEscalation")
     public Boolean getAllowPrivilegeEscalation() {
         return allowPrivilegeEscalation;
     }
 
+    /**
+     * AllowPrivilegeEscalation controls whether a process can gain more privileges than its parent process. This bool directly controls if the no_new_privs flag will be set on the container process. AllowPrivilegeEscalation is true always when the container is: 1) run as Privileged 2) has CAP_SYS_ADMIN Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("allowPrivilegeEscalation")
     public void setAllowPrivilegeEscalation(Boolean allowPrivilegeEscalation) {
         this.allowPrivilegeEscalation = allowPrivilegeEscalation;
     }
 
+    /**
+     * SecurityContext holds security configuration that will be applied to a container. Some fields are present in both SecurityContext and PodSecurityContext.  When both are set, the values in SecurityContext take precedence.
+     */
     @JsonProperty("appArmorProfile")
     public AppArmorProfile getAppArmorProfile() {
         return appArmorProfile;
     }
 
+    /**
+     * SecurityContext holds security configuration that will be applied to a container. Some fields are present in both SecurityContext and PodSecurityContext.  When both are set, the values in SecurityContext take precedence.
+     */
     @JsonProperty("appArmorProfile")
     public void setAppArmorProfile(AppArmorProfile appArmorProfile) {
         this.appArmorProfile = appArmorProfile;
     }
 
+    /**
+     * SecurityContext holds security configuration that will be applied to a container. Some fields are present in both SecurityContext and PodSecurityContext.  When both are set, the values in SecurityContext take precedence.
+     */
     @JsonProperty("capabilities")
     public Capabilities getCapabilities() {
         return capabilities;
     }
 
+    /**
+     * SecurityContext holds security configuration that will be applied to a container. Some fields are present in both SecurityContext and PodSecurityContext.  When both are set, the values in SecurityContext take precedence.
+     */
     @JsonProperty("capabilities")
     public void setCapabilities(Capabilities capabilities) {
         this.capabilities = capabilities;
     }
 
+    /**
+     * Run container in privileged mode. Processes in privileged containers are essentially equivalent to root on the host. Defaults to false. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("privileged")
     public Boolean getPrivileged() {
         return privileged;
     }
 
+    /**
+     * Run container in privileged mode. Processes in privileged containers are essentially equivalent to root on the host. Defaults to false. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("privileged")
     public void setPrivileged(Boolean privileged) {
         this.privileged = privileged;
     }
 
+    /**
+     * procMount denotes the type of proc mount to use for the containers. The default value is Default which uses the container runtime defaults for readonly paths and masked paths. This requires the ProcMountType feature flag to be enabled. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("procMount")
     public String getProcMount() {
         return procMount;
     }
 
+    /**
+     * procMount denotes the type of proc mount to use for the containers. The default value is Default which uses the container runtime defaults for readonly paths and masked paths. This requires the ProcMountType feature flag to be enabled. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("procMount")
     public void setProcMount(String procMount) {
         this.procMount = procMount;
     }
 
+    /**
+     * Whether this container has a read-only root filesystem. Default is false. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("readOnlyRootFilesystem")
     public Boolean getReadOnlyRootFilesystem() {
         return readOnlyRootFilesystem;
     }
 
+    /**
+     * Whether this container has a read-only root filesystem. Default is false. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("readOnlyRootFilesystem")
     public void setReadOnlyRootFilesystem(Boolean readOnlyRootFilesystem) {
         this.readOnlyRootFilesystem = readOnlyRootFilesystem;
     }
 
+    /**
+     * The GID to run the entrypoint of the container process. Uses runtime default if unset. May also be set in PodSecurityContext.  If set in both SecurityContext and PodSecurityContext, the value specified in SecurityContext takes precedence. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("runAsGroup")
     public Long getRunAsGroup() {
         return runAsGroup;
     }
 
+    /**
+     * The GID to run the entrypoint of the container process. Uses runtime default if unset. May also be set in PodSecurityContext.  If set in both SecurityContext and PodSecurityContext, the value specified in SecurityContext takes precedence. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("runAsGroup")
     public void setRunAsGroup(Long runAsGroup) {
         this.runAsGroup = runAsGroup;
     }
 
+    /**
+     * Indicates that the container must run as a non-root user. If true, the Kubelet will validate the image at runtime to ensure that it does not run as UID 0 (root) and fail to start the container if it does. If unset or false, no such validation will be performed. May also be set in PodSecurityContext.  If set in both SecurityContext and PodSecurityContext, the value specified in SecurityContext takes precedence.
+     */
     @JsonProperty("runAsNonRoot")
     public Boolean getRunAsNonRoot() {
         return runAsNonRoot;
     }
 
+    /**
+     * Indicates that the container must run as a non-root user. If true, the Kubelet will validate the image at runtime to ensure that it does not run as UID 0 (root) and fail to start the container if it does. If unset or false, no such validation will be performed. May also be set in PodSecurityContext.  If set in both SecurityContext and PodSecurityContext, the value specified in SecurityContext takes precedence.
+     */
     @JsonProperty("runAsNonRoot")
     public void setRunAsNonRoot(Boolean runAsNonRoot) {
         this.runAsNonRoot = runAsNonRoot;
     }
 
+    /**
+     * The UID to run the entrypoint of the container process. Defaults to user specified in image metadata if unspecified. May also be set in PodSecurityContext.  If set in both SecurityContext and PodSecurityContext, the value specified in SecurityContext takes precedence. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("runAsUser")
     public Long getRunAsUser() {
         return runAsUser;
     }
 
+    /**
+     * The UID to run the entrypoint of the container process. Defaults to user specified in image metadata if unspecified. May also be set in PodSecurityContext.  If set in both SecurityContext and PodSecurityContext, the value specified in SecurityContext takes precedence. Note that this field cannot be set when spec.os.name is windows.
+     */
     @JsonProperty("runAsUser")
     public void setRunAsUser(Long runAsUser) {
         this.runAsUser = runAsUser;
     }
 
+    /**
+     * SecurityContext holds security configuration that will be applied to a container. Some fields are present in both SecurityContext and PodSecurityContext.  When both are set, the values in SecurityContext take precedence.
+     */
     @JsonProperty("seLinuxOptions")
     public SELinuxOptions getSeLinuxOptions() {
         return seLinuxOptions;
     }
 
+    /**
+     * SecurityContext holds security configuration that will be applied to a container. Some fields are present in both SecurityContext and PodSecurityContext.  When both are set, the values in SecurityContext take precedence.
+     */
     @JsonProperty("seLinuxOptions")
     public void setSeLinuxOptions(SELinuxOptions seLinuxOptions) {
         this.seLinuxOptions = seLinuxOptions;
     }
 
+    /**
+     * SecurityContext holds security configuration that will be applied to a container. Some fields are present in both SecurityContext and PodSecurityContext.  When both are set, the values in SecurityContext take precedence.
+     */
     @JsonProperty("seccompProfile")
     public SeccompProfile getSeccompProfile() {
         return seccompProfile;
     }
 
+    /**
+     * SecurityContext holds security configuration that will be applied to a container. Some fields are present in both SecurityContext and PodSecurityContext.  When both are set, the values in SecurityContext take precedence.
+     */
     @JsonProperty("seccompProfile")
     public void setSeccompProfile(SeccompProfile seccompProfile) {
         this.seccompProfile = seccompProfile;
     }
 
+    /**
+     * SecurityContext holds security configuration that will be applied to a container. Some fields are present in both SecurityContext and PodSecurityContext.  When both are set, the values in SecurityContext take precedence.
+     */
     @JsonProperty("windowsOptions")
     public WindowsSecurityContextOptions getWindowsOptions() {
         return windowsOptions;
     }
 
+    /**
+     * SecurityContext holds security configuration that will be applied to a container. Some fields are present in both SecurityContext and PodSecurityContext.  When both are set, the values in SecurityContext take precedence.
+     */
     @JsonProperty("windowsOptions")
     public void setWindowsOptions(WindowsSecurityContextOptions windowsOptions) {
         this.windowsOptions = windowsOptions;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServerAddressByClientCIDR.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServerAddressByClientCIDR.java
index 5572e976f58..692cfb0647c 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServerAddressByClientCIDR.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServerAddressByClientCIDR.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServerAddressByClientCIDR helps the client to determine the server address that they should use, depending on the clientCIDR that they match.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public ServerAddressByClientCIDR(String clientCIDR, String serverAddress) {
         this.serverAddress = serverAddress;
     }
 
+    /**
+     * The CIDR with which clients can match their IP to figure out the server address that they should use.
+     */
     @JsonProperty("clientCIDR")
     public String getClientCIDR() {
         return clientCIDR;
     }
 
+    /**
+     * The CIDR with which clients can match their IP to figure out the server address that they should use.
+     */
     @JsonProperty("clientCIDR")
     public void setClientCIDR(String clientCIDR) {
         this.clientCIDR = clientCIDR;
     }
 
+    /**
+     * Address of this server, suitable for a client that matches the above CIDR. This can be a hostname, hostname:port, IP or IP:port.
+     */
     @JsonProperty("serverAddress")
     public String getServerAddress() {
         return serverAddress;
     }
 
+    /**
+     * Address of this server, suitable for a client that matches the above CIDR. This can be a hostname, hostname:port, IP or IP:port.
+     */
     @JsonProperty("serverAddress")
     public void setServerAddress(String serverAddress) {
         this.serverAddress = serverAddress;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Service.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Service.java
index e65a469fb01..6743eabcd96 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Service.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Service.java
@@ -21,6 +21,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Service is a named abstraction of software service (for example, mysql) consisting of local port (for example 3306) that the proxy listens on, and the selector that determines which pods will answer requests sent through the proxy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -46,14 +49,8 @@
 public class Service implements Editable<ServiceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Service";
     @JsonProperty("metadata")
@@ -81,7 +78,7 @@ public Service(String apiVersion, String kind, ObjectMeta metadata, ServiceSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -89,7 +86,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -97,7 +94,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -105,38 +102,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Service is a named abstraction of software service (for example, mysql) consisting of local port (for example 3306) that the proxy listens on, and the selector that determines which pods will answer requests sent through the proxy.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Service is a named abstraction of software service (for example, mysql) consisting of local port (for example 3306) that the proxy listens on, and the selector that determines which pods will answer requests sent through the proxy.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Service is a named abstraction of software service (for example, mysql) consisting of local port (for example 3306) that the proxy listens on, and the selector that determines which pods will answer requests sent through the proxy.
+     */
     @JsonProperty("spec")
     public ServiceSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Service is a named abstraction of software service (for example, mysql) consisting of local port (for example 3306) that the proxy listens on, and the selector that determines which pods will answer requests sent through the proxy.
+     */
     @JsonProperty("spec")
     public void setSpec(ServiceSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Service is a named abstraction of software service (for example, mysql) consisting of local port (for example 3306) that the proxy listens on, and the selector that determines which pods will answer requests sent through the proxy.
+     */
     @JsonProperty("status")
     public ServiceStatus getStatus() {
         return status;
     }
 
+    /**
+     * Service is a named abstraction of software service (for example, mysql) consisting of local port (for example 3306) that the proxy listens on, and the selector that determines which pods will answer requests sent through the proxy.
+     */
     @JsonProperty("status")
     public void setStatus(ServiceStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServiceAccount.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServiceAccount.java
index 35fc179460b..c57f0b680e5 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServiceAccount.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServiceAccount.java
@@ -23,6 +23,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceAccount binds together: &#42; a name, understood by users, and perhaps by peripheral systems, for an identity &#42; a principal that can be authenticated and authorized &#42; a set of secrets
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -49,9 +52,6 @@
 public class ServiceAccount implements Editable<ServiceAccountBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("automountServiceAccountToken")
@@ -59,9 +59,6 @@ public class ServiceAccount implements Editable<ServiceAccountBuilder>, HasMetad
     @JsonProperty("imagePullSecrets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<LocalObjectReference> imagePullSecrets = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ServiceAccount";
     @JsonProperty("metadata")
@@ -89,7 +86,7 @@ public ServiceAccount(String apiVersion, Boolean automountServiceAccountToken, L
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -97,36 +94,48 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * AutomountServiceAccountToken indicates whether pods running as this service account should have an API token automatically mounted. Can be overridden at the pod level.
+     */
     @JsonProperty("automountServiceAccountToken")
     public Boolean getAutomountServiceAccountToken() {
         return automountServiceAccountToken;
     }
 
+    /**
+     * AutomountServiceAccountToken indicates whether pods running as this service account should have an API token automatically mounted. Can be overridden at the pod level.
+     */
     @JsonProperty("automountServiceAccountToken")
     public void setAutomountServiceAccountToken(Boolean automountServiceAccountToken) {
         this.automountServiceAccountToken = automountServiceAccountToken;
     }
 
+    /**
+     * ImagePullSecrets is a list of references to secrets in the same namespace to use for pulling any images in pods that reference this ServiceAccount. ImagePullSecrets are distinct from Secrets because Secrets can be mounted in the pod, but ImagePullSecrets are only accessed by the kubelet. More info: https://kubernetes.io/docs/concepts/containers/images/#specifying-imagepullsecrets-on-a-pod
+     */
     @JsonProperty("imagePullSecrets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LocalObjectReference> getImagePullSecrets() {
         return imagePullSecrets;
     }
 
+    /**
+     * ImagePullSecrets is a list of references to secrets in the same namespace to use for pulling any images in pods that reference this ServiceAccount. ImagePullSecrets are distinct from Secrets because Secrets can be mounted in the pod, but ImagePullSecrets are only accessed by the kubelet. More info: https://kubernetes.io/docs/concepts/containers/images/#specifying-imagepullsecrets-on-a-pod
+     */
     @JsonProperty("imagePullSecrets")
     public void setImagePullSecrets(List<LocalObjectReference> imagePullSecrets) {
         this.imagePullSecrets = imagePullSecrets;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,29 +143,41 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ServiceAccount binds together: &#42; a name, understood by users, and perhaps by peripheral systems, for an identity &#42; a principal that can be authenticated and authorized &#42; a set of secrets
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ServiceAccount binds together: &#42; a name, understood by users, and perhaps by peripheral systems, for an identity &#42; a principal that can be authenticated and authorized &#42; a set of secrets
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Secrets is a list of the secrets in the same namespace that pods running using this ServiceAccount are allowed to use. Pods are only limited to this list if this service account has a "kubernetes.io/enforce-mountable-secrets" annotation set to "true". The "kubernetes.io/enforce-mountable-secrets" annotation is deprecated since v1.32. Prefer separate namespaces to isolate access to mounted secrets. This field should not be used to find auto-generated service account token secrets for use outside of pods. Instead, tokens can be requested directly using the TokenRequest API, or service account token secrets can be manually created. More info: https://kubernetes.io/docs/concepts/configuration/secret
+     */
     @JsonProperty("secrets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ObjectReference> getSecrets() {
         return secrets;
     }
 
+    /**
+     * Secrets is a list of the secrets in the same namespace that pods running using this ServiceAccount are allowed to use. Pods are only limited to this list if this service account has a "kubernetes.io/enforce-mountable-secrets" annotation set to "true". The "kubernetes.io/enforce-mountable-secrets" annotation is deprecated since v1.32. Prefer separate namespaces to isolate access to mounted secrets. This field should not be used to find auto-generated service account token secrets for use outside of pods. Instead, tokens can be requested directly using the TokenRequest API, or service account token secrets can be manually created. More info: https://kubernetes.io/docs/concepts/configuration/secret
+     */
     @JsonProperty("secrets")
     public void setSecrets(List<ObjectReference> secrets) {
         this.secrets = secrets;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServiceAccountList.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServiceAccountList.java
index 1fe4c3cb40d..6687e28a6d4 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServiceAccountList.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServiceAccountList.java
@@ -23,6 +23,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceAccountList is a list of ServiceAccount objects
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -47,17 +50,11 @@
 public class ServiceAccountList implements Editable<ServiceAccountListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.ServiceAccount>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.ServiceAccount> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ServiceAccountList";
     @JsonProperty("metadata")
@@ -80,7 +77,7 @@ public ServiceAccountList(String apiVersion, List<io.fabric8.kubernetes.api.mode
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -88,26 +85,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of ServiceAccounts. More info: https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.ServiceAccount> getItems() {
         return items;
     }
 
+    /**
+     * List of ServiceAccounts. More info: https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.ServiceAccount> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -115,18 +118,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ServiceAccountList is a list of ServiceAccount objects
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ServiceAccountList is a list of ServiceAccount objects
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServiceAccountTokenProjection.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServiceAccountTokenProjection.java
index 16d3a664583..7e81592317d 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServiceAccountTokenProjection.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServiceAccountTokenProjection.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceAccountTokenProjection represents a projected service account token volume. This projection can be used to insert a service account token into the pods runtime filesystem for use against APIs (Kubernetes API Server or otherwise).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -57,31 +60,49 @@ public ServiceAccountTokenProjection(String audience, Long expirationSeconds, St
         this.path = path;
     }
 
+    /**
+     * audience is the intended audience of the token. A recipient of a token must identify itself with an identifier specified in the audience of the token, and otherwise should reject the token. The audience defaults to the identifier of the apiserver.
+     */
     @JsonProperty("audience")
     public String getAudience() {
         return audience;
     }
 
+    /**
+     * audience is the intended audience of the token. A recipient of a token must identify itself with an identifier specified in the audience of the token, and otherwise should reject the token. The audience defaults to the identifier of the apiserver.
+     */
     @JsonProperty("audience")
     public void setAudience(String audience) {
         this.audience = audience;
     }
 
+    /**
+     * expirationSeconds is the requested duration of validity of the service account token. As the token approaches expiration, the kubelet volume plugin will proactively rotate the service account token. The kubelet will start trying to rotate the token if the token is older than 80 percent of its time to live or if the token is older than 24 hours.Defaults to 1 hour and must be at least 10 minutes.
+     */
     @JsonProperty("expirationSeconds")
     public Long getExpirationSeconds() {
         return expirationSeconds;
     }
 
+    /**
+     * expirationSeconds is the requested duration of validity of the service account token. As the token approaches expiration, the kubelet volume plugin will proactively rotate the service account token. The kubelet will start trying to rotate the token if the token is older than 80 percent of its time to live or if the token is older than 24 hours.Defaults to 1 hour and must be at least 10 minutes.
+     */
     @JsonProperty("expirationSeconds")
     public void setExpirationSeconds(Long expirationSeconds) {
         this.expirationSeconds = expirationSeconds;
     }
 
+    /**
+     * path is the path relative to the mount point of the file to project the token into.
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * path is the path relative to the mount point of the file to project the token into.
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServiceList.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServiceList.java
index c76d1dd18c0..a4c9264541f 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServiceList.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServiceList.java
@@ -23,6 +23,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceList holds a list of services.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -47,17 +50,11 @@
 public class ServiceList implements Editable<ServiceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.Service>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.Service> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ServiceList";
     @JsonProperty("metadata")
@@ -80,7 +77,7 @@ public ServiceList(String apiVersion, List<io.fabric8.kubernetes.api.model.Servi
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -88,26 +85,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of services
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.Service> getItems() {
         return items;
     }
 
+    /**
+     * List of services
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.Service> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -115,18 +118,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ServiceList holds a list of services.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ServiceList holds a list of services.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServicePort.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServicePort.java
index d63b6b9582c..a22b11376d7 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServicePort.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServicePort.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServicePort contains information on service's port.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -69,61 +72,97 @@ public ServicePort(String appProtocol, String name, Integer nodePort, Integer po
         this.targetPort = targetPort;
     }
 
+    /**
+     * The application protocol for this port. This is used as a hint for implementations to offer richer behavior for protocols that they understand. This field follows standard Kubernetes label syntax. Valid values are either:<br><p> <br><p> &#42; Un-prefixed protocol names - reserved for IANA standard service names (as per RFC-6335 and https://www.iana.org/assignments/service-names).<br><p> <br><p> &#42; Kubernetes-defined prefixed names:<br><p>   &#42; 'kubernetes.io/h2c' - HTTP/2 prior knowledge over cleartext as described in https://www.rfc-editor.org/rfc/rfc9113.html#name-starting-http-2-with-prior-<br><p>   &#42; 'kubernetes.io/ws'  - WebSocket over cleartext as described in https://www.rfc-editor.org/rfc/rfc6455<br><p>   &#42; 'kubernetes.io/wss' - WebSocket over TLS as described in https://www.rfc-editor.org/rfc/rfc6455<br><p> <br><p> &#42; Other protocols should use implementation-defined prefixed names such as mycompany.com/my-custom-protocol.
+     */
     @JsonProperty("appProtocol")
     public String getAppProtocol() {
         return appProtocol;
     }
 
+    /**
+     * The application protocol for this port. This is used as a hint for implementations to offer richer behavior for protocols that they understand. This field follows standard Kubernetes label syntax. Valid values are either:<br><p> <br><p> &#42; Un-prefixed protocol names - reserved for IANA standard service names (as per RFC-6335 and https://www.iana.org/assignments/service-names).<br><p> <br><p> &#42; Kubernetes-defined prefixed names:<br><p>   &#42; 'kubernetes.io/h2c' - HTTP/2 prior knowledge over cleartext as described in https://www.rfc-editor.org/rfc/rfc9113.html#name-starting-http-2-with-prior-<br><p>   &#42; 'kubernetes.io/ws'  - WebSocket over cleartext as described in https://www.rfc-editor.org/rfc/rfc6455<br><p>   &#42; 'kubernetes.io/wss' - WebSocket over TLS as described in https://www.rfc-editor.org/rfc/rfc6455<br><p> <br><p> &#42; Other protocols should use implementation-defined prefixed names such as mycompany.com/my-custom-protocol.
+     */
     @JsonProperty("appProtocol")
     public void setAppProtocol(String appProtocol) {
         this.appProtocol = appProtocol;
     }
 
+    /**
+     * The name of this port within the service. This must be a DNS_LABEL. All ports within a ServiceSpec must have unique names. When considering the endpoints for a Service, this must match the 'name' field in the EndpointPort. Optional if only one ServicePort is defined on this service.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The name of this port within the service. This must be a DNS_LABEL. All ports within a ServiceSpec must have unique names. When considering the endpoints for a Service, this must match the 'name' field in the EndpointPort. Optional if only one ServicePort is defined on this service.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * The port on each node on which this service is exposed when type is NodePort or LoadBalancer.  Usually assigned by the system. If a value is specified, in-range, and not in use it will be used, otherwise the operation will fail.  If not specified, a port will be allocated if this Service requires one.  If this field is specified when creating a Service which does not need it, creation will fail. This field will be wiped when updating a Service to no longer need it (e.g. changing type from NodePort to ClusterIP). More info: https://kubernetes.io/docs/concepts/services-networking/service/#type-nodeport
+     */
     @JsonProperty("nodePort")
     public Integer getNodePort() {
         return nodePort;
     }
 
+    /**
+     * The port on each node on which this service is exposed when type is NodePort or LoadBalancer.  Usually assigned by the system. If a value is specified, in-range, and not in use it will be used, otherwise the operation will fail.  If not specified, a port will be allocated if this Service requires one.  If this field is specified when creating a Service which does not need it, creation will fail. This field will be wiped when updating a Service to no longer need it (e.g. changing type from NodePort to ClusterIP). More info: https://kubernetes.io/docs/concepts/services-networking/service/#type-nodeport
+     */
     @JsonProperty("nodePort")
     public void setNodePort(Integer nodePort) {
         this.nodePort = nodePort;
     }
 
+    /**
+     * The port that will be exposed by this service.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * The port that will be exposed by this service.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * The IP protocol for this port. Supports "TCP", "UDP", and "SCTP". Default is TCP.
+     */
     @JsonProperty("protocol")
     public String getProtocol() {
         return protocol;
     }
 
+    /**
+     * The IP protocol for this port. Supports "TCP", "UDP", and "SCTP". Default is TCP.
+     */
     @JsonProperty("protocol")
     public void setProtocol(String protocol) {
         this.protocol = protocol;
     }
 
+    /**
+     * ServicePort contains information on service's port.
+     */
     @JsonProperty("targetPort")
     public IntOrString getTargetPort() {
         return targetPort;
     }
 
+    /**
+     * ServicePort contains information on service's port.
+     */
     @JsonProperty("targetPort")
     public void setTargetPort(IntOrString targetPort) {
         this.targetPort = targetPort;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServiceReference.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServiceReference.java
index 4835ceb0d90..7a817dfc83a 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServiceReference.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServiceReference.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceReference holds a reference to Service.legacy.k8s.io
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -57,31 +60,49 @@ public ServiceReference(String name, String namespace, Integer port) {
         this.port = port;
     }
 
+    /**
+     * Name is the name of the service
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the service
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace is the namespace of the service
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace of the service
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * If specified, the port on the service that hosting webhook. Default to 443 for backward compatibility. `port` should be a valid port number (1-65535, inclusive).
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * If specified, the port on the service that hosting webhook. Default to 443 for backward compatibility. `port` should be a valid port number (1-65535, inclusive).
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServiceSpec.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServiceSpec.java
index 0950edb3bba..2445b25a5d7 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServiceSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServiceSpec.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceSpec describes the attributes that a user creates on a service.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -133,207 +136,327 @@ public ServiceSpec(Boolean allocateLoadBalancerNodePorts, String clusterIP, List
         this.type = type;
     }
 
+    /**
+     * allocateLoadBalancerNodePorts defines if NodePorts will be automatically allocated for services with type LoadBalancer.  Default is "true". It may be set to "false" if the cluster load-balancer does not rely on NodePorts.  If the caller requests specific NodePorts (by specifying a value), those requests will be respected, regardless of this field. This field may only be set for services with type LoadBalancer and will be cleared if the type is changed to any other type.
+     */
     @JsonProperty("allocateLoadBalancerNodePorts")
     public Boolean getAllocateLoadBalancerNodePorts() {
         return allocateLoadBalancerNodePorts;
     }
 
+    /**
+     * allocateLoadBalancerNodePorts defines if NodePorts will be automatically allocated for services with type LoadBalancer.  Default is "true". It may be set to "false" if the cluster load-balancer does not rely on NodePorts.  If the caller requests specific NodePorts (by specifying a value), those requests will be respected, regardless of this field. This field may only be set for services with type LoadBalancer and will be cleared if the type is changed to any other type.
+     */
     @JsonProperty("allocateLoadBalancerNodePorts")
     public void setAllocateLoadBalancerNodePorts(Boolean allocateLoadBalancerNodePorts) {
         this.allocateLoadBalancerNodePorts = allocateLoadBalancerNodePorts;
     }
 
+    /**
+     * clusterIP is the IP address of the service and is usually assigned randomly. If an address is specified manually, is in-range (as per system configuration), and is not in use, it will be allocated to the service; otherwise creation of the service will fail. This field may not be changed through updates unless the type field is also being changed to ExternalName (which requires this field to be blank) or the type field is being changed from ExternalName (in which case this field may optionally be specified, as describe above).  Valid values are "None", empty string (""), or a valid IP address. Setting this to "None" makes a "headless service" (no virtual IP), which is useful when direct endpoint connections are preferred and proxying is not required.  Only applies to types ClusterIP, NodePort, and LoadBalancer. If this field is specified when creating a Service of type ExternalName, creation will fail. This field will be wiped when updating a Service to type ExternalName. More info: https://kubernetes.io/docs/concepts/services-networking/service/#virtual-ips-and-service-proxies
+     */
     @JsonProperty("clusterIP")
     public String getClusterIP() {
         return clusterIP;
     }
 
+    /**
+     * clusterIP is the IP address of the service and is usually assigned randomly. If an address is specified manually, is in-range (as per system configuration), and is not in use, it will be allocated to the service; otherwise creation of the service will fail. This field may not be changed through updates unless the type field is also being changed to ExternalName (which requires this field to be blank) or the type field is being changed from ExternalName (in which case this field may optionally be specified, as describe above).  Valid values are "None", empty string (""), or a valid IP address. Setting this to "None" makes a "headless service" (no virtual IP), which is useful when direct endpoint connections are preferred and proxying is not required.  Only applies to types ClusterIP, NodePort, and LoadBalancer. If this field is specified when creating a Service of type ExternalName, creation will fail. This field will be wiped when updating a Service to type ExternalName. More info: https://kubernetes.io/docs/concepts/services-networking/service/#virtual-ips-and-service-proxies
+     */
     @JsonProperty("clusterIP")
     public void setClusterIP(String clusterIP) {
         this.clusterIP = clusterIP;
     }
 
+    /**
+     * ClusterIPs is a list of IP addresses assigned to this service, and are usually assigned randomly.  If an address is specified manually, is in-range (as per system configuration), and is not in use, it will be allocated to the service; otherwise creation of the service will fail. This field may not be changed through updates unless the type field is also being changed to ExternalName (which requires this field to be empty) or the type field is being changed from ExternalName (in which case this field may optionally be specified, as describe above).  Valid values are "None", empty string (""), or a valid IP address.  Setting this to "None" makes a "headless service" (no virtual IP), which is useful when direct endpoint connections are preferred and proxying is not required.  Only applies to types ClusterIP, NodePort, and LoadBalancer. If this field is specified when creating a Service of type ExternalName, creation will fail. This field will be wiped when updating a Service to type ExternalName.  If this field is not specified, it will be initialized from the clusterIP field.  If this field is specified, clients must ensure that clusterIPs[0] and clusterIP have the same value.<br><p> <br><p> This field may hold a maximum of two entries (dual-stack IPs, in either order). These IPs must correspond to the values of the ipFamilies field. Both clusterIPs and ipFamilies are governed by the ipFamilyPolicy field. More info: https://kubernetes.io/docs/concepts/services-networking/service/#virtual-ips-and-service-proxies
+     */
     @JsonProperty("clusterIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getClusterIPs() {
         return clusterIPs;
     }
 
+    /**
+     * ClusterIPs is a list of IP addresses assigned to this service, and are usually assigned randomly.  If an address is specified manually, is in-range (as per system configuration), and is not in use, it will be allocated to the service; otherwise creation of the service will fail. This field may not be changed through updates unless the type field is also being changed to ExternalName (which requires this field to be empty) or the type field is being changed from ExternalName (in which case this field may optionally be specified, as describe above).  Valid values are "None", empty string (""), or a valid IP address.  Setting this to "None" makes a "headless service" (no virtual IP), which is useful when direct endpoint connections are preferred and proxying is not required.  Only applies to types ClusterIP, NodePort, and LoadBalancer. If this field is specified when creating a Service of type ExternalName, creation will fail. This field will be wiped when updating a Service to type ExternalName.  If this field is not specified, it will be initialized from the clusterIP field.  If this field is specified, clients must ensure that clusterIPs[0] and clusterIP have the same value.<br><p> <br><p> This field may hold a maximum of two entries (dual-stack IPs, in either order). These IPs must correspond to the values of the ipFamilies field. Both clusterIPs and ipFamilies are governed by the ipFamilyPolicy field. More info: https://kubernetes.io/docs/concepts/services-networking/service/#virtual-ips-and-service-proxies
+     */
     @JsonProperty("clusterIPs")
     public void setClusterIPs(List<String> clusterIPs) {
         this.clusterIPs = clusterIPs;
     }
 
+    /**
+     * externalIPs is a list of IP addresses for which nodes in the cluster will also accept traffic for this service.  These IPs are not managed by Kubernetes.  The user is responsible for ensuring that traffic arrives at a node with this IP.  A common example is external load-balancers that are not part of the Kubernetes system.
+     */
     @JsonProperty("externalIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getExternalIPs() {
         return externalIPs;
     }
 
+    /**
+     * externalIPs is a list of IP addresses for which nodes in the cluster will also accept traffic for this service.  These IPs are not managed by Kubernetes.  The user is responsible for ensuring that traffic arrives at a node with this IP.  A common example is external load-balancers that are not part of the Kubernetes system.
+     */
     @JsonProperty("externalIPs")
     public void setExternalIPs(List<String> externalIPs) {
         this.externalIPs = externalIPs;
     }
 
+    /**
+     * externalName is the external reference that discovery mechanisms will return as an alias for this service (e.g. a DNS CNAME record). No proxying will be involved.  Must be a lowercase RFC-1123 hostname (https://tools.ietf.org/html/rfc1123) and requires `type` to be "ExternalName".
+     */
     @JsonProperty("externalName")
     public String getExternalName() {
         return externalName;
     }
 
+    /**
+     * externalName is the external reference that discovery mechanisms will return as an alias for this service (e.g. a DNS CNAME record). No proxying will be involved.  Must be a lowercase RFC-1123 hostname (https://tools.ietf.org/html/rfc1123) and requires `type` to be "ExternalName".
+     */
     @JsonProperty("externalName")
     public void setExternalName(String externalName) {
         this.externalName = externalName;
     }
 
+    /**
+     * externalTrafficPolicy describes how nodes distribute service traffic they receive on one of the Service's "externally-facing" addresses (NodePorts, ExternalIPs, and LoadBalancer IPs). If set to "Local", the proxy will configure the service in a way that assumes that external load balancers will take care of balancing the service traffic between nodes, and so each node will deliver traffic only to the node-local endpoints of the service, without masquerading the client source IP. (Traffic mistakenly sent to a node with no endpoints will be dropped.) The default value, "Cluster", uses the standard behavior of routing to all endpoints evenly (possibly modified by topology and other features). Note that traffic sent to an External IP or LoadBalancer IP from within the cluster will always get "Cluster" semantics, but clients sending to a NodePort from within the cluster may need to take traffic policy into account when picking a node.
+     */
     @JsonProperty("externalTrafficPolicy")
     public String getExternalTrafficPolicy() {
         return externalTrafficPolicy;
     }
 
+    /**
+     * externalTrafficPolicy describes how nodes distribute service traffic they receive on one of the Service's "externally-facing" addresses (NodePorts, ExternalIPs, and LoadBalancer IPs). If set to "Local", the proxy will configure the service in a way that assumes that external load balancers will take care of balancing the service traffic between nodes, and so each node will deliver traffic only to the node-local endpoints of the service, without masquerading the client source IP. (Traffic mistakenly sent to a node with no endpoints will be dropped.) The default value, "Cluster", uses the standard behavior of routing to all endpoints evenly (possibly modified by topology and other features). Note that traffic sent to an External IP or LoadBalancer IP from within the cluster will always get "Cluster" semantics, but clients sending to a NodePort from within the cluster may need to take traffic policy into account when picking a node.
+     */
     @JsonProperty("externalTrafficPolicy")
     public void setExternalTrafficPolicy(String externalTrafficPolicy) {
         this.externalTrafficPolicy = externalTrafficPolicy;
     }
 
+    /**
+     * healthCheckNodePort specifies the healthcheck nodePort for the service. This only applies when type is set to LoadBalancer and externalTrafficPolicy is set to Local. If a value is specified, is in-range, and is not in use, it will be used.  If not specified, a value will be automatically allocated.  External systems (e.g. load-balancers) can use this port to determine if a given node holds endpoints for this service or not.  If this field is specified when creating a Service which does not need it, creation will fail. This field will be wiped when updating a Service to no longer need it (e.g. changing type). This field cannot be updated once set.
+     */
     @JsonProperty("healthCheckNodePort")
     public Integer getHealthCheckNodePort() {
         return healthCheckNodePort;
     }
 
+    /**
+     * healthCheckNodePort specifies the healthcheck nodePort for the service. This only applies when type is set to LoadBalancer and externalTrafficPolicy is set to Local. If a value is specified, is in-range, and is not in use, it will be used.  If not specified, a value will be automatically allocated.  External systems (e.g. load-balancers) can use this port to determine if a given node holds endpoints for this service or not.  If this field is specified when creating a Service which does not need it, creation will fail. This field will be wiped when updating a Service to no longer need it (e.g. changing type). This field cannot be updated once set.
+     */
     @JsonProperty("healthCheckNodePort")
     public void setHealthCheckNodePort(Integer healthCheckNodePort) {
         this.healthCheckNodePort = healthCheckNodePort;
     }
 
+    /**
+     * InternalTrafficPolicy describes how nodes distribute service traffic they receive on the ClusterIP. If set to "Local", the proxy will assume that pods only want to talk to endpoints of the service on the same node as the pod, dropping the traffic if there are no local endpoints. The default value, "Cluster", uses the standard behavior of routing to all endpoints evenly (possibly modified by topology and other features).
+     */
     @JsonProperty("internalTrafficPolicy")
     public String getInternalTrafficPolicy() {
         return internalTrafficPolicy;
     }
 
+    /**
+     * InternalTrafficPolicy describes how nodes distribute service traffic they receive on the ClusterIP. If set to "Local", the proxy will assume that pods only want to talk to endpoints of the service on the same node as the pod, dropping the traffic if there are no local endpoints. The default value, "Cluster", uses the standard behavior of routing to all endpoints evenly (possibly modified by topology and other features).
+     */
     @JsonProperty("internalTrafficPolicy")
     public void setInternalTrafficPolicy(String internalTrafficPolicy) {
         this.internalTrafficPolicy = internalTrafficPolicy;
     }
 
+    /**
+     * IPFamilies is a list of IP families (e.g. IPv4, IPv6) assigned to this service. This field is usually assigned automatically based on cluster configuration and the ipFamilyPolicy field. If this field is specified manually, the requested family is available in the cluster, and ipFamilyPolicy allows it, it will be used; otherwise creation of the service will fail. This field is conditionally mutable: it allows for adding or removing a secondary IP family, but it does not allow changing the primary IP family of the Service. Valid values are "IPv4" and "IPv6".  This field only applies to Services of types ClusterIP, NodePort, and LoadBalancer, and does apply to "headless" services. This field will be wiped when updating a Service to type ExternalName.<br><p> <br><p> This field may hold a maximum of two entries (dual-stack families, in either order).  These families must correspond to the values of the clusterIPs field, if specified. Both clusterIPs and ipFamilies are governed by the ipFamilyPolicy field.
+     */
     @JsonProperty("ipFamilies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIpFamilies() {
         return ipFamilies;
     }
 
+    /**
+     * IPFamilies is a list of IP families (e.g. IPv4, IPv6) assigned to this service. This field is usually assigned automatically based on cluster configuration and the ipFamilyPolicy field. If this field is specified manually, the requested family is available in the cluster, and ipFamilyPolicy allows it, it will be used; otherwise creation of the service will fail. This field is conditionally mutable: it allows for adding or removing a secondary IP family, but it does not allow changing the primary IP family of the Service. Valid values are "IPv4" and "IPv6".  This field only applies to Services of types ClusterIP, NodePort, and LoadBalancer, and does apply to "headless" services. This field will be wiped when updating a Service to type ExternalName.<br><p> <br><p> This field may hold a maximum of two entries (dual-stack families, in either order).  These families must correspond to the values of the clusterIPs field, if specified. Both clusterIPs and ipFamilies are governed by the ipFamilyPolicy field.
+     */
     @JsonProperty("ipFamilies")
     public void setIpFamilies(List<String> ipFamilies) {
         this.ipFamilies = ipFamilies;
     }
 
+    /**
+     * IPFamilyPolicy represents the dual-stack-ness requested or required by this Service. If there is no value provided, then this field will be set to SingleStack. Services can be "SingleStack" (a single IP family), "PreferDualStack" (two IP families on dual-stack configured clusters or a single IP family on single-stack clusters), or "RequireDualStack" (two IP families on dual-stack configured clusters, otherwise fail). The ipFamilies and clusterIPs fields depend on the value of this field. This field will be wiped when updating a service to type ExternalName.
+     */
     @JsonProperty("ipFamilyPolicy")
     public String getIpFamilyPolicy() {
         return ipFamilyPolicy;
     }
 
+    /**
+     * IPFamilyPolicy represents the dual-stack-ness requested or required by this Service. If there is no value provided, then this field will be set to SingleStack. Services can be "SingleStack" (a single IP family), "PreferDualStack" (two IP families on dual-stack configured clusters or a single IP family on single-stack clusters), or "RequireDualStack" (two IP families on dual-stack configured clusters, otherwise fail). The ipFamilies and clusterIPs fields depend on the value of this field. This field will be wiped when updating a service to type ExternalName.
+     */
     @JsonProperty("ipFamilyPolicy")
     public void setIpFamilyPolicy(String ipFamilyPolicy) {
         this.ipFamilyPolicy = ipFamilyPolicy;
     }
 
+    /**
+     * loadBalancerClass is the class of the load balancer implementation this Service belongs to. If specified, the value of this field must be a label-style identifier, with an optional prefix, e.g. "internal-vip" or "example.com/internal-vip". Unprefixed names are reserved for end-users. This field can only be set when the Service type is 'LoadBalancer'. If not set, the default load balancer implementation is used, today this is typically done through the cloud provider integration, but should apply for any default implementation. If set, it is assumed that a load balancer implementation is watching for Services with a matching class. Any default load balancer implementation (e.g. cloud providers) should ignore Services that set this field. This field can only be set when creating or updating a Service to type 'LoadBalancer'. Once set, it can not be changed. This field will be wiped when a service is updated to a non 'LoadBalancer' type.
+     */
     @JsonProperty("loadBalancerClass")
     public String getLoadBalancerClass() {
         return loadBalancerClass;
     }
 
+    /**
+     * loadBalancerClass is the class of the load balancer implementation this Service belongs to. If specified, the value of this field must be a label-style identifier, with an optional prefix, e.g. "internal-vip" or "example.com/internal-vip". Unprefixed names are reserved for end-users. This field can only be set when the Service type is 'LoadBalancer'. If not set, the default load balancer implementation is used, today this is typically done through the cloud provider integration, but should apply for any default implementation. If set, it is assumed that a load balancer implementation is watching for Services with a matching class. Any default load balancer implementation (e.g. cloud providers) should ignore Services that set this field. This field can only be set when creating or updating a Service to type 'LoadBalancer'. Once set, it can not be changed. This field will be wiped when a service is updated to a non 'LoadBalancer' type.
+     */
     @JsonProperty("loadBalancerClass")
     public void setLoadBalancerClass(String loadBalancerClass) {
         this.loadBalancerClass = loadBalancerClass;
     }
 
+    /**
+     * Only applies to Service Type: LoadBalancer. This feature depends on whether the underlying cloud-provider supports specifying the loadBalancerIP when a load balancer is created. This field will be ignored if the cloud-provider does not support the feature. Deprecated: This field was under-specified and its meaning varies across implementations. Using it is non-portable and it may not support dual-stack. Users are encouraged to use implementation-specific annotations when available.
+     */
     @JsonProperty("loadBalancerIP")
     public String getLoadBalancerIP() {
         return loadBalancerIP;
     }
 
+    /**
+     * Only applies to Service Type: LoadBalancer. This feature depends on whether the underlying cloud-provider supports specifying the loadBalancerIP when a load balancer is created. This field will be ignored if the cloud-provider does not support the feature. Deprecated: This field was under-specified and its meaning varies across implementations. Using it is non-portable and it may not support dual-stack. Users are encouraged to use implementation-specific annotations when available.
+     */
     @JsonProperty("loadBalancerIP")
     public void setLoadBalancerIP(String loadBalancerIP) {
         this.loadBalancerIP = loadBalancerIP;
     }
 
+    /**
+     * If specified and supported by the platform, this will restrict traffic through the cloud-provider load-balancer will be restricted to the specified client IPs. This field will be ignored if the cloud-provider does not support the feature." More info: https://kubernetes.io/docs/tasks/access-application-cluster/create-external-load-balancer/
+     */
     @JsonProperty("loadBalancerSourceRanges")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getLoadBalancerSourceRanges() {
         return loadBalancerSourceRanges;
     }
 
+    /**
+     * If specified and supported by the platform, this will restrict traffic through the cloud-provider load-balancer will be restricted to the specified client IPs. This field will be ignored if the cloud-provider does not support the feature." More info: https://kubernetes.io/docs/tasks/access-application-cluster/create-external-load-balancer/
+     */
     @JsonProperty("loadBalancerSourceRanges")
     public void setLoadBalancerSourceRanges(List<String> loadBalancerSourceRanges) {
         this.loadBalancerSourceRanges = loadBalancerSourceRanges;
     }
 
+    /**
+     * The list of ports that are exposed by this service. More info: https://kubernetes.io/docs/concepts/services-networking/service/#virtual-ips-and-service-proxies
+     */
     @JsonProperty("ports")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ServicePort> getPorts() {
         return ports;
     }
 
+    /**
+     * The list of ports that are exposed by this service. More info: https://kubernetes.io/docs/concepts/services-networking/service/#virtual-ips-and-service-proxies
+     */
     @JsonProperty("ports")
     public void setPorts(List<ServicePort> ports) {
         this.ports = ports;
     }
 
+    /**
+     * publishNotReadyAddresses indicates that any agent which deals with endpoints for this Service should disregard any indications of ready/not-ready. The primary use case for setting this field is for a StatefulSet's Headless Service to propagate SRV DNS records for its Pods for the purpose of peer discovery. The Kubernetes controllers that generate Endpoints and EndpointSlice resources for Services interpret this to mean that all endpoints are considered "ready" even if the Pods themselves are not. Agents which consume only Kubernetes generated endpoints through the Endpoints or EndpointSlice resources can safely assume this behavior.
+     */
     @JsonProperty("publishNotReadyAddresses")
     public Boolean getPublishNotReadyAddresses() {
         return publishNotReadyAddresses;
     }
 
+    /**
+     * publishNotReadyAddresses indicates that any agent which deals with endpoints for this Service should disregard any indications of ready/not-ready. The primary use case for setting this field is for a StatefulSet's Headless Service to propagate SRV DNS records for its Pods for the purpose of peer discovery. The Kubernetes controllers that generate Endpoints and EndpointSlice resources for Services interpret this to mean that all endpoints are considered "ready" even if the Pods themselves are not. Agents which consume only Kubernetes generated endpoints through the Endpoints or EndpointSlice resources can safely assume this behavior.
+     */
     @JsonProperty("publishNotReadyAddresses")
     public void setPublishNotReadyAddresses(Boolean publishNotReadyAddresses) {
         this.publishNotReadyAddresses = publishNotReadyAddresses;
     }
 
+    /**
+     * Route service traffic to pods with label keys and values matching this selector. If empty or not present, the service is assumed to have an external process managing its endpoints, which Kubernetes will not modify. Only applies to types ClusterIP, NodePort, and LoadBalancer. Ignored if type is ExternalName. More info: https://kubernetes.io/docs/concepts/services-networking/service/
+     */
     @JsonProperty("selector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getSelector() {
         return selector;
     }
 
+    /**
+     * Route service traffic to pods with label keys and values matching this selector. If empty or not present, the service is assumed to have an external process managing its endpoints, which Kubernetes will not modify. Only applies to types ClusterIP, NodePort, and LoadBalancer. Ignored if type is ExternalName. More info: https://kubernetes.io/docs/concepts/services-networking/service/
+     */
     @JsonProperty("selector")
     public void setSelector(Map<String, String> selector) {
         this.selector = selector;
     }
 
+    /**
+     * Supports "ClientIP" and "None". Used to maintain session affinity. Enable client IP based session affinity. Must be ClientIP or None. Defaults to None. More info: https://kubernetes.io/docs/concepts/services-networking/service/#virtual-ips-and-service-proxies
+     */
     @JsonProperty("sessionAffinity")
     public String getSessionAffinity() {
         return sessionAffinity;
     }
 
+    /**
+     * Supports "ClientIP" and "None". Used to maintain session affinity. Enable client IP based session affinity. Must be ClientIP or None. Defaults to None. More info: https://kubernetes.io/docs/concepts/services-networking/service/#virtual-ips-and-service-proxies
+     */
     @JsonProperty("sessionAffinity")
     public void setSessionAffinity(String sessionAffinity) {
         this.sessionAffinity = sessionAffinity;
     }
 
+    /**
+     * ServiceSpec describes the attributes that a user creates on a service.
+     */
     @JsonProperty("sessionAffinityConfig")
     public SessionAffinityConfig getSessionAffinityConfig() {
         return sessionAffinityConfig;
     }
 
+    /**
+     * ServiceSpec describes the attributes that a user creates on a service.
+     */
     @JsonProperty("sessionAffinityConfig")
     public void setSessionAffinityConfig(SessionAffinityConfig sessionAffinityConfig) {
         this.sessionAffinityConfig = sessionAffinityConfig;
     }
 
+    /**
+     * TrafficDistribution offers a way to express preferences for how traffic is distributed to Service endpoints. Implementations can use this field as a hint, but are not required to guarantee strict adherence. If the field is not set, the implementation will apply its default routing strategy. If set to "PreferClose", implementations should prioritize endpoints that are topologically close (e.g., same zone). This is a beta field and requires enabling ServiceTrafficDistribution feature.
+     */
     @JsonProperty("trafficDistribution")
     public String getTrafficDistribution() {
         return trafficDistribution;
     }
 
+    /**
+     * TrafficDistribution offers a way to express preferences for how traffic is distributed to Service endpoints. Implementations can use this field as a hint, but are not required to guarantee strict adherence. If the field is not set, the implementation will apply its default routing strategy. If set to "PreferClose", implementations should prioritize endpoints that are topologically close (e.g., same zone). This is a beta field and requires enabling ServiceTrafficDistribution feature.
+     */
     @JsonProperty("trafficDistribution")
     public void setTrafficDistribution(String trafficDistribution) {
         this.trafficDistribution = trafficDistribution;
     }
 
+    /**
+     * type determines how the Service is exposed. Defaults to ClusterIP. Valid options are ExternalName, ClusterIP, NodePort, and LoadBalancer. "ClusterIP" allocates a cluster-internal IP address for load-balancing to endpoints. Endpoints are determined by the selector or if that is not specified, by manual construction of an Endpoints object or EndpointSlice objects. If clusterIP is "None", no virtual IP is allocated and the endpoints are published as a set of endpoints rather than a virtual IP. "NodePort" builds on ClusterIP and allocates a port on every node which routes to the same endpoints as the clusterIP. "LoadBalancer" builds on NodePort and creates an external load-balancer (if supported in the current cloud) which routes to the same endpoints as the clusterIP. "ExternalName" aliases this service to the specified externalName. Several other fields do not apply to ExternalName services. More info: https://kubernetes.io/docs/concepts/services-networking/service/#publishing-services-service-types
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type determines how the Service is exposed. Defaults to ClusterIP. Valid options are ExternalName, ClusterIP, NodePort, and LoadBalancer. "ClusterIP" allocates a cluster-internal IP address for load-balancing to endpoints. Endpoints are determined by the selector or if that is not specified, by manual construction of an Endpoints object or EndpointSlice objects. If clusterIP is "None", no virtual IP is allocated and the endpoints are published as a set of endpoints rather than a virtual IP. "NodePort" builds on ClusterIP and allocates a port on every node which routes to the same endpoints as the clusterIP. "LoadBalancer" builds on NodePort and creates an external load-balancer (if supported in the current cloud) which routes to the same endpoints as the clusterIP. "ExternalName" aliases this service to the specified externalName. Several other fields do not apply to ExternalName services. More info: https://kubernetes.io/docs/concepts/services-networking/service/#publishing-services-service-types
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServiceStatus.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServiceStatus.java
index e4203e15a04..7ef00c8a170 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServiceStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/ServiceStatus.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceStatus represents the current status of a service.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -56,22 +59,34 @@ public ServiceStatus(List<Condition> conditions, LoadBalancerStatus loadBalancer
         this.loadBalancer = loadBalancer;
     }
 
+    /**
+     * Current service state
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Current service state
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ServiceStatus represents the current status of a service.
+     */
     @JsonProperty("loadBalancer")
     public LoadBalancerStatus getLoadBalancer() {
         return loadBalancer;
     }
 
+    /**
+     * ServiceStatus represents the current status of a service.
+     */
     @JsonProperty("loadBalancer")
     public void setLoadBalancer(LoadBalancerStatus loadBalancer) {
         this.loadBalancer = loadBalancer;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SessionAffinityConfig.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SessionAffinityConfig.java
index 98ee2747618..dba99177cb5 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SessionAffinityConfig.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SessionAffinityConfig.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SessionAffinityConfig represents the configurations of session affinity.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -49,11 +52,17 @@ public SessionAffinityConfig(ClientIPConfig clientIP) {
         this.clientIP = clientIP;
     }
 
+    /**
+     * SessionAffinityConfig represents the configurations of session affinity.
+     */
     @JsonProperty("clientIP")
     public ClientIPConfig getClientIP() {
         return clientIP;
     }
 
+    /**
+     * SessionAffinityConfig represents the configurations of session affinity.
+     */
     @JsonProperty("clientIP")
     public void setClientIP(ClientIPConfig clientIP) {
         this.clientIP = clientIP;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SleepAction.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SleepAction.java
index d0362e88c25..a291a12204f 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SleepAction.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/SleepAction.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SleepAction describes a "sleep" action.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -49,11 +52,17 @@ public SleepAction(Long seconds) {
         this.seconds = seconds;
     }
 
+    /**
+     * Seconds is the number of seconds to sleep.
+     */
     @JsonProperty("seconds")
     public Long getSeconds() {
         return seconds;
     }
 
+    /**
+     * Seconds is the number of seconds to sleep.
+     */
     @JsonProperty("seconds")
     public void setSeconds(Long seconds) {
         this.seconds = seconds;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Status.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Status.java
index 7e87f6e4b7e..e771f97ca9b 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Status.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Status.java
@@ -49,18 +49,12 @@
 public class Status implements Editable<StatusBuilder>, KubernetesResource
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("code")
     private Integer code;
     @JsonProperty("details")
     private StatusDetails details;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Status";
     @JsonProperty("message")
@@ -92,17 +86,11 @@ public Status(String apiVersion, Integer code, StatusDetails details, String kin
         this.status = status;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
@@ -128,17 +116,11 @@ public void setDetails(StatusDetails details) {
         this.details = details;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/StorageOSPersistentVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/StorageOSPersistentVolumeSource.java
index 3e18ecdab44..d2e39b4c2d5 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/StorageOSPersistentVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/StorageOSPersistentVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Represents a StorageOS persistent volume resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -65,51 +68,81 @@ public StorageOSPersistentVolumeSource(String fsType, Boolean readOnly, ObjectRe
         this.volumeNamespace = volumeNamespace;
     }
 
+    /**
+     * fsType is the filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.
+     */
     @JsonProperty("fsType")
     public String getFsType() {
         return fsType;
     }
 
+    /**
+     * fsType is the filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.
+     */
     @JsonProperty("fsType")
     public void setFsType(String fsType) {
         this.fsType = fsType;
     }
 
+    /**
+     * readOnly defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * Represents a StorageOS persistent volume resource.
+     */
     @JsonProperty("secretRef")
     public ObjectReference getSecretRef() {
         return secretRef;
     }
 
+    /**
+     * Represents a StorageOS persistent volume resource.
+     */
     @JsonProperty("secretRef")
     public void setSecretRef(ObjectReference secretRef) {
         this.secretRef = secretRef;
     }
 
+    /**
+     * volumeName is the human-readable name of the StorageOS volume.  Volume names are only unique within a namespace.
+     */
     @JsonProperty("volumeName")
     public String getVolumeName() {
         return volumeName;
     }
 
+    /**
+     * volumeName is the human-readable name of the StorageOS volume.  Volume names are only unique within a namespace.
+     */
     @JsonProperty("volumeName")
     public void setVolumeName(String volumeName) {
         this.volumeName = volumeName;
     }
 
+    /**
+     * volumeNamespace specifies the scope of the volume within StorageOS.  If no namespace is specified then the Pod's namespace will be used.  This allows the Kubernetes name scoping to be mirrored within StorageOS for tighter integration. Set VolumeName to any name to override the default behaviour. Set to "default" if you are not using namespaces within StorageOS. Namespaces that do not pre-exist within StorageOS will be created.
+     */
     @JsonProperty("volumeNamespace")
     public String getVolumeNamespace() {
         return volumeNamespace;
     }
 
+    /**
+     * volumeNamespace specifies the scope of the volume within StorageOS.  If no namespace is specified then the Pod's namespace will be used.  This allows the Kubernetes name scoping to be mirrored within StorageOS for tighter integration. Set VolumeName to any name to override the default behaviour. Set to "default" if you are not using namespaces within StorageOS. Namespaces that do not pre-exist within StorageOS will be created.
+     */
     @JsonProperty("volumeNamespace")
     public void setVolumeNamespace(String volumeNamespace) {
         this.volumeNamespace = volumeNamespace;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/StorageOSVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/StorageOSVolumeSource.java
index de86ab3541a..0d73b7d68df 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/StorageOSVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/StorageOSVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Represents a StorageOS persistent volume resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -65,51 +68,81 @@ public StorageOSVolumeSource(String fsType, Boolean readOnly, LocalObjectReferen
         this.volumeNamespace = volumeNamespace;
     }
 
+    /**
+     * fsType is the filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.
+     */
     @JsonProperty("fsType")
     public String getFsType() {
         return fsType;
     }
 
+    /**
+     * fsType is the filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.
+     */
     @JsonProperty("fsType")
     public void setFsType(String fsType) {
         this.fsType = fsType;
     }
 
+    /**
+     * readOnly defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * Represents a StorageOS persistent volume resource.
+     */
     @JsonProperty("secretRef")
     public LocalObjectReference getSecretRef() {
         return secretRef;
     }
 
+    /**
+     * Represents a StorageOS persistent volume resource.
+     */
     @JsonProperty("secretRef")
     public void setSecretRef(LocalObjectReference secretRef) {
         this.secretRef = secretRef;
     }
 
+    /**
+     * volumeName is the human-readable name of the StorageOS volume.  Volume names are only unique within a namespace.
+     */
     @JsonProperty("volumeName")
     public String getVolumeName() {
         return volumeName;
     }
 
+    /**
+     * volumeName is the human-readable name of the StorageOS volume.  Volume names are only unique within a namespace.
+     */
     @JsonProperty("volumeName")
     public void setVolumeName(String volumeName) {
         this.volumeName = volumeName;
     }
 
+    /**
+     * volumeNamespace specifies the scope of the volume within StorageOS.  If no namespace is specified then the Pod's namespace will be used.  This allows the Kubernetes name scoping to be mirrored within StorageOS for tighter integration. Set VolumeName to any name to override the default behaviour. Set to "default" if you are not using namespaces within StorageOS. Namespaces that do not pre-exist within StorageOS will be created.
+     */
     @JsonProperty("volumeNamespace")
     public String getVolumeNamespace() {
         return volumeNamespace;
     }
 
+    /**
+     * volumeNamespace specifies the scope of the volume within StorageOS.  If no namespace is specified then the Pod's namespace will be used.  This allows the Kubernetes name scoping to be mirrored within StorageOS for tighter integration. Set VolumeName to any name to override the default behaviour. Set to "default" if you are not using namespaces within StorageOS. Namespaces that do not pre-exist within StorageOS will be created.
+     */
     @JsonProperty("volumeNamespace")
     public void setVolumeNamespace(String volumeNamespace) {
         this.volumeNamespace = volumeNamespace;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Sysctl.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Sysctl.java
index 5b85fd29cb2..45d2dcaab6f 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Sysctl.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Sysctl.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Sysctl defines a kernel parameter to be set
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public Sysctl(String name, String value) {
         this.value = value;
     }
 
+    /**
+     * Name of a property to set
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of a property to set
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Value of a property to set
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value of a property to set
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/TCPSocketAction.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/TCPSocketAction.java
index 712a7783e93..93249d1780e 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/TCPSocketAction.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/TCPSocketAction.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TCPSocketAction describes an action based on opening a socket
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public TCPSocketAction(String host, IntOrString port) {
         this.port = port;
     }
 
+    /**
+     * Optional: Host name to connect to, defaults to the pod IP.
+     */
     @JsonProperty("host")
     public String getHost() {
         return host;
     }
 
+    /**
+     * Optional: Host name to connect to, defaults to the pod IP.
+     */
     @JsonProperty("host")
     public void setHost(String host) {
         this.host = host;
     }
 
+    /**
+     * TCPSocketAction describes an action based on opening a socket
+     */
     @JsonProperty("port")
     public IntOrString getPort() {
         return port;
     }
 
+    /**
+     * TCPSocketAction describes an action based on opening a socket
+     */
     @JsonProperty("port")
     public void setPort(IntOrString port) {
         this.port = port;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Taint.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Taint.java
index 70a694e8fd3..06959346f59 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Taint.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Taint.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * The node this Taint is attached to has the "effect" on any pod that does not tolerate the Taint.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -61,41 +64,65 @@ public Taint(String effect, String key, String timeAdded, String value) {
         this.value = value;
     }
 
+    /**
+     * Required. The effect of the taint on pods that do not tolerate the taint. Valid effects are NoSchedule, PreferNoSchedule and NoExecute.
+     */
     @JsonProperty("effect")
     public String getEffect() {
         return effect;
     }
 
+    /**
+     * Required. The effect of the taint on pods that do not tolerate the taint. Valid effects are NoSchedule, PreferNoSchedule and NoExecute.
+     */
     @JsonProperty("effect")
     public void setEffect(String effect) {
         this.effect = effect;
     }
 
+    /**
+     * Required. The taint key to be applied to a node.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * Required. The taint key to be applied to a node.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * The node this Taint is attached to has the "effect" on any pod that does not tolerate the Taint.
+     */
     @JsonProperty("timeAdded")
     public String getTimeAdded() {
         return timeAdded;
     }
 
+    /**
+     * The node this Taint is attached to has the "effect" on any pod that does not tolerate the Taint.
+     */
     @JsonProperty("timeAdded")
     public void setTimeAdded(String timeAdded) {
         this.timeAdded = timeAdded;
     }
 
+    /**
+     * The taint value corresponding to the taint key.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * The taint value corresponding to the taint key.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Toleration.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Toleration.java
index d07b3d8de6a..68321014575 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Toleration.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Toleration.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * The pod this Toleration is attached to tolerates any taint that matches the triple &lt;key,value,effect&gt; using the matching operator &lt;operator&gt;.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -65,51 +68,81 @@ public Toleration(String effect, String key, String operator, Long tolerationSec
         this.value = value;
     }
 
+    /**
+     * Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule, PreferNoSchedule and NoExecute.
+     */
     @JsonProperty("effect")
     public String getEffect() {
         return effect;
     }
 
+    /**
+     * Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule, PreferNoSchedule and NoExecute.
+     */
     @JsonProperty("effect")
     public void setEffect(String effect) {
         this.effect = effect;
     }
 
+    /**
+     * Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a pod can tolerate all taints of a particular category.
+     */
     @JsonProperty("operator")
     public String getOperator() {
         return operator;
     }
 
+    /**
+     * Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a pod can tolerate all taints of a particular category.
+     */
     @JsonProperty("operator")
     public void setOperator(String operator) {
         this.operator = operator;
     }
 
+    /**
+     * TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system.
+     */
     @JsonProperty("tolerationSeconds")
     public Long getTolerationSeconds() {
         return tolerationSeconds;
     }
 
+    /**
+     * TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system.
+     */
     @JsonProperty("tolerationSeconds")
     public void setTolerationSeconds(Long tolerationSeconds) {
         this.tolerationSeconds = tolerationSeconds;
     }
 
+    /**
+     * Value is the taint value the toleration matches to. If the operator is Exists, the value should be empty, otherwise just a regular string.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is the taint value the toleration matches to. If the operator is Exists, the value should be empty, otherwise just a regular string.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/TopologySelectorLabelRequirement.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/TopologySelectorLabelRequirement.java
index 34082aeb16d..757550c6e42 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/TopologySelectorLabelRequirement.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/TopologySelectorLabelRequirement.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * A topology selector requirement is a selector that matches given label. This is an alpha feature and may change in the future.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -56,22 +59,34 @@ public TopologySelectorLabelRequirement(String key, List<String> values) {
         this.values = values;
     }
 
+    /**
+     * The label key that the selector applies to.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * The label key that the selector applies to.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * An array of string values. One value must match the label to be selected. Each entry in Values is ORed.
+     */
     @JsonProperty("values")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getValues() {
         return values;
     }
 
+    /**
+     * An array of string values. One value must match the label to be selected. Each entry in Values is ORed.
+     */
     @JsonProperty("values")
     public void setValues(List<String> values) {
         this.values = values;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/TopologySelectorTerm.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/TopologySelectorTerm.java
index 52fc31bbc2c..edf71a29b8d 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/TopologySelectorTerm.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/TopologySelectorTerm.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * A topology selector term represents the result of label queries. A null or empty topology selector term matches no objects. The requirements of them are ANDed. It provides a subset of functionality as NodeSelectorTerm. This is an alpha feature and may change in the future.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -52,12 +55,18 @@ public TopologySelectorTerm(List<TopologySelectorLabelRequirement> matchLabelExp
         this.matchLabelExpressions = matchLabelExpressions;
     }
 
+    /**
+     * A list of topology selector requirements by labels.
+     */
     @JsonProperty("matchLabelExpressions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TopologySelectorLabelRequirement> getMatchLabelExpressions() {
         return matchLabelExpressions;
     }
 
+    /**
+     * A list of topology selector requirements by labels.
+     */
     @JsonProperty("matchLabelExpressions")
     public void setMatchLabelExpressions(List<TopologySelectorLabelRequirement> matchLabelExpressions) {
         this.matchLabelExpressions = matchLabelExpressions;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/TopologySpreadConstraint.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/TopologySpreadConstraint.java
index a6de361f0f4..5e203fd32c5 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/TopologySpreadConstraint.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/TopologySpreadConstraint.java
@@ -19,6 +19,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TopologySpreadConstraint specifies how to spread matching pods among the given topology.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -80,82 +83,130 @@ public TopologySpreadConstraint(LabelSelector labelSelector, List<String> matchL
         this.whenUnsatisfiable = whenUnsatisfiable;
     }
 
+    /**
+     * TopologySpreadConstraint specifies how to spread matching pods among the given topology.
+     */
     @JsonProperty("labelSelector")
     public LabelSelector getLabelSelector() {
         return labelSelector;
     }
 
+    /**
+     * TopologySpreadConstraint specifies how to spread matching pods among the given topology.
+     */
     @JsonProperty("labelSelector")
     public void setLabelSelector(LabelSelector labelSelector) {
         this.labelSelector = labelSelector;
     }
 
+    /**
+     * MatchLabelKeys is a set of pod label keys to select the pods over which spreading will be calculated. The keys are used to lookup values from the incoming pod labels, those key-value labels are ANDed with labelSelector to select the group of existing pods over which spreading will be calculated for the incoming pod. The same key is forbidden to exist in both MatchLabelKeys and LabelSelector. MatchLabelKeys cannot be set when LabelSelector isn't set. Keys that don't exist in the incoming pod labels will be ignored. A null or empty list means only match against labelSelector.<br><p> <br><p> This is a beta field and requires the MatchLabelKeysInPodTopologySpread feature gate to be enabled (enabled by default).
+     */
     @JsonProperty("matchLabelKeys")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMatchLabelKeys() {
         return matchLabelKeys;
     }
 
+    /**
+     * MatchLabelKeys is a set of pod label keys to select the pods over which spreading will be calculated. The keys are used to lookup values from the incoming pod labels, those key-value labels are ANDed with labelSelector to select the group of existing pods over which spreading will be calculated for the incoming pod. The same key is forbidden to exist in both MatchLabelKeys and LabelSelector. MatchLabelKeys cannot be set when LabelSelector isn't set. Keys that don't exist in the incoming pod labels will be ignored. A null or empty list means only match against labelSelector.<br><p> <br><p> This is a beta field and requires the MatchLabelKeysInPodTopologySpread feature gate to be enabled (enabled by default).
+     */
     @JsonProperty("matchLabelKeys")
     public void setMatchLabelKeys(List<String> matchLabelKeys) {
         this.matchLabelKeys = matchLabelKeys;
     }
 
+    /**
+     * MaxSkew describes the degree to which pods may be unevenly distributed. When `whenUnsatisfiable=DoNotSchedule`, it is the maximum permitted difference between the number of matching pods in the target topology and the global minimum. The global minimum is the minimum number of matching pods in an eligible domain or zero if the number of eligible domains is less than MinDomains. For example, in a 3-zone cluster, MaxSkew is set to 1, and pods with the same labelSelector spread as 2/2/1: In this case, the global minimum is 1. | zone1 | zone2 | zone3 | |  P P  |  P P  |   P   | - if MaxSkew is 1, incoming pod can only be scheduled to zone3 to become 2/2/2; scheduling it onto zone1(zone2) would make the ActualSkew(3-1) on zone1(zone2) violate MaxSkew(1). - if MaxSkew is 2, incoming pod can be scheduled onto any zone. When `whenUnsatisfiable=ScheduleAnyway`, it is used to give higher precedence to topologies that satisfy it. It's a required field. Default value is 1 and 0 is not allowed.
+     */
     @JsonProperty("maxSkew")
     public Integer getMaxSkew() {
         return maxSkew;
     }
 
+    /**
+     * MaxSkew describes the degree to which pods may be unevenly distributed. When `whenUnsatisfiable=DoNotSchedule`, it is the maximum permitted difference between the number of matching pods in the target topology and the global minimum. The global minimum is the minimum number of matching pods in an eligible domain or zero if the number of eligible domains is less than MinDomains. For example, in a 3-zone cluster, MaxSkew is set to 1, and pods with the same labelSelector spread as 2/2/1: In this case, the global minimum is 1. | zone1 | zone2 | zone3 | |  P P  |  P P  |   P   | - if MaxSkew is 1, incoming pod can only be scheduled to zone3 to become 2/2/2; scheduling it onto zone1(zone2) would make the ActualSkew(3-1) on zone1(zone2) violate MaxSkew(1). - if MaxSkew is 2, incoming pod can be scheduled onto any zone. When `whenUnsatisfiable=ScheduleAnyway`, it is used to give higher precedence to topologies that satisfy it. It's a required field. Default value is 1 and 0 is not allowed.
+     */
     @JsonProperty("maxSkew")
     public void setMaxSkew(Integer maxSkew) {
         this.maxSkew = maxSkew;
     }
 
+    /**
+     * MinDomains indicates a minimum number of eligible domains. When the number of eligible domains with matching topology keys is less than minDomains, Pod Topology Spread treats "global minimum" as 0, and then the calculation of Skew is performed. And when the number of eligible domains with matching topology keys equals or greater than minDomains, this value has no effect on scheduling. As a result, when the number of eligible domains is less than minDomains, scheduler won't schedule more than maxSkew Pods to those domains. If value is nil, the constraint behaves as if MinDomains is equal to 1. Valid values are integers greater than 0. When value is not nil, WhenUnsatisfiable must be DoNotSchedule.<br><p> <br><p> For example, in a 3-zone cluster, MaxSkew is set to 2, MinDomains is set to 5 and pods with the same labelSelector spread as 2/2/2: | zone1 | zone2 | zone3 | |  P P  |  P P  |  P P  | The number of domains is less than 5(MinDomains), so "global minimum" is treated as 0. In this situation, new pod with the same labelSelector cannot be scheduled, because computed skew will be 3(3 - 0) if new Pod is scheduled to any of the three zones, it will violate MaxSkew.
+     */
     @JsonProperty("minDomains")
     public Integer getMinDomains() {
         return minDomains;
     }
 
+    /**
+     * MinDomains indicates a minimum number of eligible domains. When the number of eligible domains with matching topology keys is less than minDomains, Pod Topology Spread treats "global minimum" as 0, and then the calculation of Skew is performed. And when the number of eligible domains with matching topology keys equals or greater than minDomains, this value has no effect on scheduling. As a result, when the number of eligible domains is less than minDomains, scheduler won't schedule more than maxSkew Pods to those domains. If value is nil, the constraint behaves as if MinDomains is equal to 1. Valid values are integers greater than 0. When value is not nil, WhenUnsatisfiable must be DoNotSchedule.<br><p> <br><p> For example, in a 3-zone cluster, MaxSkew is set to 2, MinDomains is set to 5 and pods with the same labelSelector spread as 2/2/2: | zone1 | zone2 | zone3 | |  P P  |  P P  |  P P  | The number of domains is less than 5(MinDomains), so "global minimum" is treated as 0. In this situation, new pod with the same labelSelector cannot be scheduled, because computed skew will be 3(3 - 0) if new Pod is scheduled to any of the three zones, it will violate MaxSkew.
+     */
     @JsonProperty("minDomains")
     public void setMinDomains(Integer minDomains) {
         this.minDomains = minDomains;
     }
 
+    /**
+     * NodeAffinityPolicy indicates how we will treat Pod's nodeAffinity/nodeSelector when calculating pod topology spread skew. Options are: - Honor: only nodes matching nodeAffinity/nodeSelector are included in the calculations. - Ignore: nodeAffinity/nodeSelector are ignored. All nodes are included in the calculations.<br><p> <br><p> If this value is nil, the behavior is equivalent to the Honor policy. This is a beta-level feature default enabled by the NodeInclusionPolicyInPodTopologySpread feature flag.
+     */
     @JsonProperty("nodeAffinityPolicy")
     public String getNodeAffinityPolicy() {
         return nodeAffinityPolicy;
     }
 
+    /**
+     * NodeAffinityPolicy indicates how we will treat Pod's nodeAffinity/nodeSelector when calculating pod topology spread skew. Options are: - Honor: only nodes matching nodeAffinity/nodeSelector are included in the calculations. - Ignore: nodeAffinity/nodeSelector are ignored. All nodes are included in the calculations.<br><p> <br><p> If this value is nil, the behavior is equivalent to the Honor policy. This is a beta-level feature default enabled by the NodeInclusionPolicyInPodTopologySpread feature flag.
+     */
     @JsonProperty("nodeAffinityPolicy")
     public void setNodeAffinityPolicy(String nodeAffinityPolicy) {
         this.nodeAffinityPolicy = nodeAffinityPolicy;
     }
 
+    /**
+     * NodeTaintsPolicy indicates how we will treat node taints when calculating pod topology spread skew. Options are: - Honor: nodes without taints, along with tainted nodes for which the incoming pod has a toleration, are included. - Ignore: node taints are ignored. All nodes are included.<br><p> <br><p> If this value is nil, the behavior is equivalent to the Ignore policy. This is a beta-level feature default enabled by the NodeInclusionPolicyInPodTopologySpread feature flag.
+     */
     @JsonProperty("nodeTaintsPolicy")
     public String getNodeTaintsPolicy() {
         return nodeTaintsPolicy;
     }
 
+    /**
+     * NodeTaintsPolicy indicates how we will treat node taints when calculating pod topology spread skew. Options are: - Honor: nodes without taints, along with tainted nodes for which the incoming pod has a toleration, are included. - Ignore: node taints are ignored. All nodes are included.<br><p> <br><p> If this value is nil, the behavior is equivalent to the Ignore policy. This is a beta-level feature default enabled by the NodeInclusionPolicyInPodTopologySpread feature flag.
+     */
     @JsonProperty("nodeTaintsPolicy")
     public void setNodeTaintsPolicy(String nodeTaintsPolicy) {
         this.nodeTaintsPolicy = nodeTaintsPolicy;
     }
 
+    /**
+     * TopologyKey is the key of node labels. Nodes that have a label with this key and identical values are considered to be in the same topology. We consider each &lt;key, value&gt; as a "bucket", and try to put balanced number of pods into each bucket. We define a domain as a particular instance of a topology. Also, we define an eligible domain as a domain whose nodes meet the requirements of nodeAffinityPolicy and nodeTaintsPolicy. e.g. If TopologyKey is "kubernetes.io/hostname", each Node is a domain of that topology. And, if TopologyKey is "topology.kubernetes.io/zone", each zone is a domain of that topology. It's a required field.
+     */
     @JsonProperty("topologyKey")
     public String getTopologyKey() {
         return topologyKey;
     }
 
+    /**
+     * TopologyKey is the key of node labels. Nodes that have a label with this key and identical values are considered to be in the same topology. We consider each &lt;key, value&gt; as a "bucket", and try to put balanced number of pods into each bucket. We define a domain as a particular instance of a topology. Also, we define an eligible domain as a domain whose nodes meet the requirements of nodeAffinityPolicy and nodeTaintsPolicy. e.g. If TopologyKey is "kubernetes.io/hostname", each Node is a domain of that topology. And, if TopologyKey is "topology.kubernetes.io/zone", each zone is a domain of that topology. It's a required field.
+     */
     @JsonProperty("topologyKey")
     public void setTopologyKey(String topologyKey) {
         this.topologyKey = topologyKey;
     }
 
+    /**
+     * WhenUnsatisfiable indicates how to deal with a pod if it doesn't satisfy the spread constraint. - DoNotSchedule (default) tells the scheduler not to schedule it. - ScheduleAnyway tells the scheduler to schedule the pod in any location,<br><p>   but giving higher precedence to topologies that would help reduce the<br><p>   skew.<br><p> A constraint is considered "Unsatisfiable" for an incoming pod if and only if every possible node assignment for that pod would violate "MaxSkew" on some topology. For example, in a 3-zone cluster, MaxSkew is set to 1, and pods with the same labelSelector spread as 3/1/1: | zone1 | zone2 | zone3 | | P P P |   P   |   P   | If WhenUnsatisfiable is set to DoNotSchedule, incoming pod can only be scheduled to zone2(zone3) to become 3/2/1(3/1/2) as ActualSkew(2-1) on zone2(zone3) satisfies MaxSkew(1). In other words, the cluster can still be imbalanced, but scheduler won't make it &#42;more&#42; imbalanced. It's a required field.
+     */
     @JsonProperty("whenUnsatisfiable")
     public String getWhenUnsatisfiable() {
         return whenUnsatisfiable;
     }
 
+    /**
+     * WhenUnsatisfiable indicates how to deal with a pod if it doesn't satisfy the spread constraint. - DoNotSchedule (default) tells the scheduler not to schedule it. - ScheduleAnyway tells the scheduler to schedule the pod in any location,<br><p>   but giving higher precedence to topologies that would help reduce the<br><p>   skew.<br><p> A constraint is considered "Unsatisfiable" for an incoming pod if and only if every possible node assignment for that pod would violate "MaxSkew" on some topology. For example, in a 3-zone cluster, MaxSkew is set to 1, and pods with the same labelSelector spread as 3/1/1: | zone1 | zone2 | zone3 | | P P P |   P   |   P   | If WhenUnsatisfiable is set to DoNotSchedule, incoming pod can only be scheduled to zone2(zone3) to become 3/2/1(3/1/2) as ActualSkew(2-1) on zone2(zone3) satisfies MaxSkew(1). In other words, the cluster can still be imbalanced, but scheduler won't make it &#42;more&#42; imbalanced. It's a required field.
+     */
     @JsonProperty("whenUnsatisfiable")
     public void setWhenUnsatisfiable(String whenUnsatisfiable) {
         this.whenUnsatisfiable = whenUnsatisfiable;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/TypeMeta.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/TypeMeta.java
index 97ebc385f91..145772756ef 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/TypeMeta.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/TypeMeta.java
@@ -43,14 +43,8 @@
 public class TypeMeta implements Editable<TypeMetaBuilder>, KubernetesResource
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TypeMeta";
     @JsonIgnore
@@ -68,33 +62,21 @@ public TypeMeta(String apiVersion, String kind) {
         this.kind = kind;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/TypedLocalObjectReference.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/TypedLocalObjectReference.java
index 2e41f65d69e..f0e947632b7 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/TypedLocalObjectReference.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/TypedLocalObjectReference.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TypedLocalObjectReference contains enough information to let you locate the typed referenced object inside the same namespace.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -57,31 +60,49 @@ public TypedLocalObjectReference(String apiGroup, String kind, String name) {
         this.name = name;
     }
 
+    /**
+     * APIGroup is the group for the resource being referenced. If APIGroup is not specified, the specified Kind must be in the core API group. For any other third-party types, APIGroup is required.
+     */
     @JsonProperty("apiGroup")
     public String getApiGroup() {
         return apiGroup;
     }
 
+    /**
+     * APIGroup is the group for the resource being referenced. If APIGroup is not specified, the specified Kind must be in the core API group. For any other third-party types, APIGroup is required.
+     */
     @JsonProperty("apiGroup")
     public void setApiGroup(String apiGroup) {
         this.apiGroup = apiGroup;
     }
 
+    /**
+     * Kind is the type of resource being referenced
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is the type of resource being referenced
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of resource being referenced
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of resource being referenced
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/TypedObjectReference.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/TypedObjectReference.java
index ce89a703fa1..71fb1809247 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/TypedObjectReference.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/TypedObjectReference.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TypedObjectReference contains enough information to let you locate the typed referenced object
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -61,41 +64,65 @@ public TypedObjectReference(String apiGroup, String kind, String name, String na
         this.namespace = namespace;
     }
 
+    /**
+     * APIGroup is the group for the resource being referenced. If APIGroup is not specified, the specified Kind must be in the core API group. For any other third-party types, APIGroup is required.
+     */
     @JsonProperty("apiGroup")
     public String getApiGroup() {
         return apiGroup;
     }
 
+    /**
+     * APIGroup is the group for the resource being referenced. If APIGroup is not specified, the specified Kind must be in the core API group. For any other third-party types, APIGroup is required.
+     */
     @JsonProperty("apiGroup")
     public void setApiGroup(String apiGroup) {
         this.apiGroup = apiGroup;
     }
 
+    /**
+     * Kind is the type of resource being referenced
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is the type of resource being referenced
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of resource being referenced
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of resource being referenced
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace is the namespace of resource being referenced Note that when a namespace is specified, a gateway.networking.k8s.io/ReferenceGrant object is required in the referent namespace to allow that namespace's owner to accept the reference. See the ReferenceGrant documentation for details. (Alpha) This field requires the CrossNamespaceVolumeDataSource feature gate to be enabled.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace of resource being referenced Note that when a namespace is specified, a gateway.networking.k8s.io/ReferenceGrant object is required in the referent namespace to allow that namespace's owner to accept the reference. See the ReferenceGrant documentation for details. (Alpha) This field requires the CrossNamespaceVolumeDataSource feature gate to be enabled.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/UpdateOptions.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/UpdateOptions.java
index e75bcfdc453..e63cd089df8 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/UpdateOptions.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/UpdateOptions.java
@@ -48,9 +48,6 @@
 public class UpdateOptions implements Editable<UpdateOptionsBuilder>, KubernetesResource
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("dryRun")
@@ -60,9 +57,6 @@ public class UpdateOptions implements Editable<UpdateOptionsBuilder>, Kubernetes
     private String fieldManager;
     @JsonProperty("fieldValidation")
     private String fieldValidation;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "UpdateOptions";
     @JsonIgnore
@@ -83,17 +77,11 @@ public UpdateOptions(String apiVersion, List<String> dryRun, String fieldManager
         this.kind = kind;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
@@ -130,17 +118,11 @@ public void setFieldValidation(String fieldValidation) {
         this.fieldValidation = fieldValidation;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Volume.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Volume.java
index 1021629f6db..568283eda3a 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Volume.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/Volume.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -169,311 +172,497 @@ public Volume(AWSElasticBlockStoreVolumeSource awsElasticBlockStore, AzureDiskVo
         this.vsphereVolume = vsphereVolume;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("awsElasticBlockStore")
     public AWSElasticBlockStoreVolumeSource getAwsElasticBlockStore() {
         return awsElasticBlockStore;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("awsElasticBlockStore")
     public void setAwsElasticBlockStore(AWSElasticBlockStoreVolumeSource awsElasticBlockStore) {
         this.awsElasticBlockStore = awsElasticBlockStore;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("azureDisk")
     public AzureDiskVolumeSource getAzureDisk() {
         return azureDisk;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("azureDisk")
     public void setAzureDisk(AzureDiskVolumeSource azureDisk) {
         this.azureDisk = azureDisk;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("azureFile")
     public AzureFileVolumeSource getAzureFile() {
         return azureFile;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("azureFile")
     public void setAzureFile(AzureFileVolumeSource azureFile) {
         this.azureFile = azureFile;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("cephfs")
     public CephFSVolumeSource getCephfs() {
         return cephfs;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("cephfs")
     public void setCephfs(CephFSVolumeSource cephfs) {
         this.cephfs = cephfs;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("cinder")
     public CinderVolumeSource getCinder() {
         return cinder;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("cinder")
     public void setCinder(CinderVolumeSource cinder) {
         this.cinder = cinder;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("configMap")
     public ConfigMapVolumeSource getConfigMap() {
         return configMap;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("configMap")
     public void setConfigMap(ConfigMapVolumeSource configMap) {
         this.configMap = configMap;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("csi")
     public CSIVolumeSource getCsi() {
         return csi;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("csi")
     public void setCsi(CSIVolumeSource csi) {
         this.csi = csi;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("downwardAPI")
     public DownwardAPIVolumeSource getDownwardAPI() {
         return downwardAPI;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("downwardAPI")
     public void setDownwardAPI(DownwardAPIVolumeSource downwardAPI) {
         this.downwardAPI = downwardAPI;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("emptyDir")
     public EmptyDirVolumeSource getEmptyDir() {
         return emptyDir;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("emptyDir")
     public void setEmptyDir(EmptyDirVolumeSource emptyDir) {
         this.emptyDir = emptyDir;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("ephemeral")
     public EphemeralVolumeSource getEphemeral() {
         return ephemeral;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("ephemeral")
     public void setEphemeral(EphemeralVolumeSource ephemeral) {
         this.ephemeral = ephemeral;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("fc")
     public FCVolumeSource getFc() {
         return fc;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("fc")
     public void setFc(FCVolumeSource fc) {
         this.fc = fc;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("flexVolume")
     public FlexVolumeSource getFlexVolume() {
         return flexVolume;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("flexVolume")
     public void setFlexVolume(FlexVolumeSource flexVolume) {
         this.flexVolume = flexVolume;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("flocker")
     public FlockerVolumeSource getFlocker() {
         return flocker;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("flocker")
     public void setFlocker(FlockerVolumeSource flocker) {
         this.flocker = flocker;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("gcePersistentDisk")
     public GCEPersistentDiskVolumeSource getGcePersistentDisk() {
         return gcePersistentDisk;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("gcePersistentDisk")
     public void setGcePersistentDisk(GCEPersistentDiskVolumeSource gcePersistentDisk) {
         this.gcePersistentDisk = gcePersistentDisk;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("gitRepo")
     public GitRepoVolumeSource getGitRepo() {
         return gitRepo;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("gitRepo")
     public void setGitRepo(GitRepoVolumeSource gitRepo) {
         this.gitRepo = gitRepo;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("glusterfs")
     public GlusterfsVolumeSource getGlusterfs() {
         return glusterfs;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("glusterfs")
     public void setGlusterfs(GlusterfsVolumeSource glusterfs) {
         this.glusterfs = glusterfs;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("hostPath")
     public HostPathVolumeSource getHostPath() {
         return hostPath;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("hostPath")
     public void setHostPath(HostPathVolumeSource hostPath) {
         this.hostPath = hostPath;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("image")
     public ImageVolumeSource getImage() {
         return image;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("image")
     public void setImage(ImageVolumeSource image) {
         this.image = image;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("iscsi")
     public ISCSIVolumeSource getIscsi() {
         return iscsi;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("iscsi")
     public void setIscsi(ISCSIVolumeSource iscsi) {
         this.iscsi = iscsi;
     }
 
+    /**
+     * name of the volume. Must be a DNS_LABEL and unique within the pod. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name of the volume. Must be a DNS_LABEL and unique within the pod. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("nfs")
     public NFSVolumeSource getNfs() {
         return nfs;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("nfs")
     public void setNfs(NFSVolumeSource nfs) {
         this.nfs = nfs;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("persistentVolumeClaim")
     public PersistentVolumeClaimVolumeSource getPersistentVolumeClaim() {
         return persistentVolumeClaim;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("persistentVolumeClaim")
     public void setPersistentVolumeClaim(PersistentVolumeClaimVolumeSource persistentVolumeClaim) {
         this.persistentVolumeClaim = persistentVolumeClaim;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("photonPersistentDisk")
     public PhotonPersistentDiskVolumeSource getPhotonPersistentDisk() {
         return photonPersistentDisk;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("photonPersistentDisk")
     public void setPhotonPersistentDisk(PhotonPersistentDiskVolumeSource photonPersistentDisk) {
         this.photonPersistentDisk = photonPersistentDisk;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("portworxVolume")
     public PortworxVolumeSource getPortworxVolume() {
         return portworxVolume;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("portworxVolume")
     public void setPortworxVolume(PortworxVolumeSource portworxVolume) {
         this.portworxVolume = portworxVolume;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("projected")
     public ProjectedVolumeSource getProjected() {
         return projected;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("projected")
     public void setProjected(ProjectedVolumeSource projected) {
         this.projected = projected;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("quobyte")
     public QuobyteVolumeSource getQuobyte() {
         return quobyte;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("quobyte")
     public void setQuobyte(QuobyteVolumeSource quobyte) {
         this.quobyte = quobyte;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("rbd")
     public RBDVolumeSource getRbd() {
         return rbd;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("rbd")
     public void setRbd(RBDVolumeSource rbd) {
         this.rbd = rbd;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("scaleIO")
     public ScaleIOVolumeSource getScaleIO() {
         return scaleIO;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("scaleIO")
     public void setScaleIO(ScaleIOVolumeSource scaleIO) {
         this.scaleIO = scaleIO;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("secret")
     public SecretVolumeSource getSecret() {
         return secret;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("secret")
     public void setSecret(SecretVolumeSource secret) {
         this.secret = secret;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("storageos")
     public StorageOSVolumeSource getStorageos() {
         return storageos;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("storageos")
     public void setStorageos(StorageOSVolumeSource storageos) {
         this.storageos = storageos;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("vsphereVolume")
     public VsphereVirtualDiskVolumeSource getVsphereVolume() {
         return vsphereVolume;
     }
 
+    /**
+     * Volume represents a named volume in a pod that may be accessed by any container in the pod.
+     */
     @JsonProperty("vsphereVolume")
     public void setVsphereVolume(VsphereVirtualDiskVolumeSource vsphereVolume) {
         this.vsphereVolume = vsphereVolume;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/VolumeDevice.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/VolumeDevice.java
index 4acc6c4299c..572df83180f 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/VolumeDevice.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/VolumeDevice.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * volumeDevice describes a mapping of a raw block device within a container.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public VolumeDevice(String devicePath, String name) {
         this.name = name;
     }
 
+    /**
+     * devicePath is the path inside of the container that the device will be mapped to.
+     */
     @JsonProperty("devicePath")
     public String getDevicePath() {
         return devicePath;
     }
 
+    /**
+     * devicePath is the path inside of the container that the device will be mapped to.
+     */
     @JsonProperty("devicePath")
     public void setDevicePath(String devicePath) {
         this.devicePath = devicePath;
     }
 
+    /**
+     * name must match the name of a persistentVolumeClaim in the pod
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name must match the name of a persistentVolumeClaim in the pod
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/VolumeMount.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/VolumeMount.java
index 19f77e16744..eaf8c9ad8bb 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/VolumeMount.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/VolumeMount.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeMount describes a mounting of a Volume within a container.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -73,71 +76,113 @@ public VolumeMount(String mountPath, String mountPropagation, String name, Boole
         this.subPathExpr = subPathExpr;
     }
 
+    /**
+     * Path within the container at which the volume should be mounted.  Must not contain ':'.
+     */
     @JsonProperty("mountPath")
     public String getMountPath() {
         return mountPath;
     }
 
+    /**
+     * Path within the container at which the volume should be mounted.  Must not contain ':'.
+     */
     @JsonProperty("mountPath")
     public void setMountPath(String mountPath) {
         this.mountPath = mountPath;
     }
 
+    /**
+     * mountPropagation determines how mounts are propagated from the host to container and the other way around. When not set, MountPropagationNone is used. This field is beta in 1.10. When RecursiveReadOnly is set to IfPossible or to Enabled, MountPropagation must be None or unspecified (which defaults to None).
+     */
     @JsonProperty("mountPropagation")
     public String getMountPropagation() {
         return mountPropagation;
     }
 
+    /**
+     * mountPropagation determines how mounts are propagated from the host to container and the other way around. When not set, MountPropagationNone is used. This field is beta in 1.10. When RecursiveReadOnly is set to IfPossible or to Enabled, MountPropagation must be None or unspecified (which defaults to None).
+     */
     @JsonProperty("mountPropagation")
     public void setMountPropagation(String mountPropagation) {
         this.mountPropagation = mountPropagation;
     }
 
+    /**
+     * This must match the Name of a Volume.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * This must match the Name of a Volume.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Mounted read-only if true, read-write otherwise (false or unspecified). Defaults to false.
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * Mounted read-only if true, read-write otherwise (false or unspecified). Defaults to false.
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * RecursiveReadOnly specifies whether read-only mounts should be handled recursively.<br><p> <br><p> If ReadOnly is false, this field has no meaning and must be unspecified.<br><p> <br><p> If ReadOnly is true, and this field is set to Disabled, the mount is not made recursively read-only.  If this field is set to IfPossible, the mount is made recursively read-only, if it is supported by the container runtime.  If this field is set to Enabled, the mount is made recursively read-only if it is supported by the container runtime, otherwise the pod will not be started and an error will be generated to indicate the reason.<br><p> <br><p> If this field is set to IfPossible or Enabled, MountPropagation must be set to None (or be unspecified, which defaults to None).<br><p> <br><p> If this field is not specified, it is treated as an equivalent of Disabled.
+     */
     @JsonProperty("recursiveReadOnly")
     public String getRecursiveReadOnly() {
         return recursiveReadOnly;
     }
 
+    /**
+     * RecursiveReadOnly specifies whether read-only mounts should be handled recursively.<br><p> <br><p> If ReadOnly is false, this field has no meaning and must be unspecified.<br><p> <br><p> If ReadOnly is true, and this field is set to Disabled, the mount is not made recursively read-only.  If this field is set to IfPossible, the mount is made recursively read-only, if it is supported by the container runtime.  If this field is set to Enabled, the mount is made recursively read-only if it is supported by the container runtime, otherwise the pod will not be started and an error will be generated to indicate the reason.<br><p> <br><p> If this field is set to IfPossible or Enabled, MountPropagation must be set to None (or be unspecified, which defaults to None).<br><p> <br><p> If this field is not specified, it is treated as an equivalent of Disabled.
+     */
     @JsonProperty("recursiveReadOnly")
     public void setRecursiveReadOnly(String recursiveReadOnly) {
         this.recursiveReadOnly = recursiveReadOnly;
     }
 
+    /**
+     * Path within the volume from which the container's volume should be mounted. Defaults to "" (volume's root).
+     */
     @JsonProperty("subPath")
     public String getSubPath() {
         return subPath;
     }
 
+    /**
+     * Path within the volume from which the container's volume should be mounted. Defaults to "" (volume's root).
+     */
     @JsonProperty("subPath")
     public void setSubPath(String subPath) {
         this.subPath = subPath;
     }
 
+    /**
+     * Expanded path within the volume from which the container's volume should be mounted. Behaves similarly to SubPath but environment variable references $(VAR_NAME) are expanded using the container's environment. Defaults to "" (volume's root). SubPathExpr and SubPath are mutually exclusive.
+     */
     @JsonProperty("subPathExpr")
     public String getSubPathExpr() {
         return subPathExpr;
     }
 
+    /**
+     * Expanded path within the volume from which the container's volume should be mounted. Behaves similarly to SubPath but environment variable references $(VAR_NAME) are expanded using the container's environment. Defaults to "" (volume's root). SubPathExpr and SubPath are mutually exclusive.
+     */
     @JsonProperty("subPathExpr")
     public void setSubPathExpr(String subPathExpr) {
         this.subPathExpr = subPathExpr;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/VolumeMountStatus.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/VolumeMountStatus.java
index 8e609cea5b4..65638fd3386 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/VolumeMountStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/VolumeMountStatus.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeMountStatus shows status of volume mounts.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -61,41 +64,65 @@ public VolumeMountStatus(String mountPath, String name, Boolean readOnly, String
         this.recursiveReadOnly = recursiveReadOnly;
     }
 
+    /**
+     * MountPath corresponds to the original VolumeMount.
+     */
     @JsonProperty("mountPath")
     public String getMountPath() {
         return mountPath;
     }
 
+    /**
+     * MountPath corresponds to the original VolumeMount.
+     */
     @JsonProperty("mountPath")
     public void setMountPath(String mountPath) {
         this.mountPath = mountPath;
     }
 
+    /**
+     * Name corresponds to the name of the original VolumeMount.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name corresponds to the name of the original VolumeMount.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * ReadOnly corresponds to the original VolumeMount.
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * ReadOnly corresponds to the original VolumeMount.
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * RecursiveReadOnly must be set to Disabled, Enabled, or unspecified (for non-readonly mounts). An IfPossible value in the original VolumeMount must be translated to Disabled or Enabled, depending on the mount result.
+     */
     @JsonProperty("recursiveReadOnly")
     public String getRecursiveReadOnly() {
         return recursiveReadOnly;
     }
 
+    /**
+     * RecursiveReadOnly must be set to Disabled, Enabled, or unspecified (for non-readonly mounts). An IfPossible value in the original VolumeMount must be translated to Disabled or Enabled, depending on the mount result.
+     */
     @JsonProperty("recursiveReadOnly")
     public void setRecursiveReadOnly(String recursiveReadOnly) {
         this.recursiveReadOnly = recursiveReadOnly;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/VolumeNodeAffinity.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/VolumeNodeAffinity.java
index 75fc2349edc..5c4fae8220f 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/VolumeNodeAffinity.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/VolumeNodeAffinity.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeNodeAffinity defines constraints that limit what nodes this volume can be accessed from.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -49,11 +52,17 @@ public VolumeNodeAffinity(NodeSelector required) {
         this.required = required;
     }
 
+    /**
+     * VolumeNodeAffinity defines constraints that limit what nodes this volume can be accessed from.
+     */
     @JsonProperty("required")
     public NodeSelector getRequired() {
         return required;
     }
 
+    /**
+     * VolumeNodeAffinity defines constraints that limit what nodes this volume can be accessed from.
+     */
     @JsonProperty("required")
     public void setRequired(NodeSelector required) {
         this.required = required;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/VolumeProjection.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/VolumeProjection.java
index e78e322e83a..69199517d39 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/VolumeProjection.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/VolumeProjection.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Projection that may be projected along with other supported volume types. Exactly one of these fields must be set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -65,51 +68,81 @@ public VolumeProjection(ClusterTrustBundleProjection clusterTrustBundle, ConfigM
         this.serviceAccountToken = serviceAccountToken;
     }
 
+    /**
+     * Projection that may be projected along with other supported volume types. Exactly one of these fields must be set.
+     */
     @JsonProperty("clusterTrustBundle")
     public ClusterTrustBundleProjection getClusterTrustBundle() {
         return clusterTrustBundle;
     }
 
+    /**
+     * Projection that may be projected along with other supported volume types. Exactly one of these fields must be set.
+     */
     @JsonProperty("clusterTrustBundle")
     public void setClusterTrustBundle(ClusterTrustBundleProjection clusterTrustBundle) {
         this.clusterTrustBundle = clusterTrustBundle;
     }
 
+    /**
+     * Projection that may be projected along with other supported volume types. Exactly one of these fields must be set.
+     */
     @JsonProperty("configMap")
     public ConfigMapProjection getConfigMap() {
         return configMap;
     }
 
+    /**
+     * Projection that may be projected along with other supported volume types. Exactly one of these fields must be set.
+     */
     @JsonProperty("configMap")
     public void setConfigMap(ConfigMapProjection configMap) {
         this.configMap = configMap;
     }
 
+    /**
+     * Projection that may be projected along with other supported volume types. Exactly one of these fields must be set.
+     */
     @JsonProperty("downwardAPI")
     public DownwardAPIProjection getDownwardAPI() {
         return downwardAPI;
     }
 
+    /**
+     * Projection that may be projected along with other supported volume types. Exactly one of these fields must be set.
+     */
     @JsonProperty("downwardAPI")
     public void setDownwardAPI(DownwardAPIProjection downwardAPI) {
         this.downwardAPI = downwardAPI;
     }
 
+    /**
+     * Projection that may be projected along with other supported volume types. Exactly one of these fields must be set.
+     */
     @JsonProperty("secret")
     public SecretProjection getSecret() {
         return secret;
     }
 
+    /**
+     * Projection that may be projected along with other supported volume types. Exactly one of these fields must be set.
+     */
     @JsonProperty("secret")
     public void setSecret(SecretProjection secret) {
         this.secret = secret;
     }
 
+    /**
+     * Projection that may be projected along with other supported volume types. Exactly one of these fields must be set.
+     */
     @JsonProperty("serviceAccountToken")
     public ServiceAccountTokenProjection getServiceAccountToken() {
         return serviceAccountToken;
     }
 
+    /**
+     * Projection that may be projected along with other supported volume types. Exactly one of these fields must be set.
+     */
     @JsonProperty("serviceAccountToken")
     public void setServiceAccountToken(ServiceAccountTokenProjection serviceAccountToken) {
         this.serviceAccountToken = serviceAccountToken;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/VolumeResourceRequirements.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/VolumeResourceRequirements.java
index 8c750083c4e..4bd75c73bc5 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/VolumeResourceRequirements.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/VolumeResourceRequirements.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeResourceRequirements describes the storage resource requirements for a volume.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -55,23 +58,35 @@ public VolumeResourceRequirements(Map<String, Quantity> limits, Map<String, Quan
         this.requests = requests;
     }
 
+    /**
+     * Limits describes the maximum amount of compute resources allowed. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
+     */
     @JsonProperty("limits")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getLimits() {
         return limits;
     }
 
+    /**
+     * Limits describes the maximum amount of compute resources allowed. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
+     */
     @JsonProperty("limits")
     public void setLimits(Map<String, Quantity> limits) {
         this.limits = limits;
     }
 
+    /**
+     * Requests describes the minimum amount of compute resources required. If Requests is omitted for a container, it defaults to Limits if that is explicitly specified, otherwise to an implementation-defined value. Requests cannot exceed Limits. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
+     */
     @JsonProperty("requests")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getRequests() {
         return requests;
     }
 
+    /**
+     * Requests describes the minimum amount of compute resources required. If Requests is omitted for a container, it defaults to Limits if that is explicitly specified, otherwise to an implementation-defined value. Requests cannot exceed Limits. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
+     */
     @JsonProperty("requests")
     public void setRequests(Map<String, Quantity> requests) {
         this.requests = requests;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/VsphereVirtualDiskVolumeSource.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/VsphereVirtualDiskVolumeSource.java
index 7f009897845..d490f468674 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/VsphereVirtualDiskVolumeSource.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/VsphereVirtualDiskVolumeSource.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Represents a vSphere volume resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -61,41 +64,65 @@ public VsphereVirtualDiskVolumeSource(String fsType, String storagePolicyID, Str
         this.volumePath = volumePath;
     }
 
+    /**
+     * fsType is filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.
+     */
     @JsonProperty("fsType")
     public String getFsType() {
         return fsType;
     }
 
+    /**
+     * fsType is filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.
+     */
     @JsonProperty("fsType")
     public void setFsType(String fsType) {
         this.fsType = fsType;
     }
 
+    /**
+     * storagePolicyID is the storage Policy Based Management (SPBM) profile ID associated with the StoragePolicyName.
+     */
     @JsonProperty("storagePolicyID")
     public String getStoragePolicyID() {
         return storagePolicyID;
     }
 
+    /**
+     * storagePolicyID is the storage Policy Based Management (SPBM) profile ID associated with the StoragePolicyName.
+     */
     @JsonProperty("storagePolicyID")
     public void setStoragePolicyID(String storagePolicyID) {
         this.storagePolicyID = storagePolicyID;
     }
 
+    /**
+     * storagePolicyName is the storage Policy Based Management (SPBM) profile name.
+     */
     @JsonProperty("storagePolicyName")
     public String getStoragePolicyName() {
         return storagePolicyName;
     }
 
+    /**
+     * storagePolicyName is the storage Policy Based Management (SPBM) profile name.
+     */
     @JsonProperty("storagePolicyName")
     public void setStoragePolicyName(String storagePolicyName) {
         this.storagePolicyName = storagePolicyName;
     }
 
+    /**
+     * volumePath is the path that identifies vSphere volume vmdk
+     */
     @JsonProperty("volumePath")
     public String getVolumePath() {
         return volumePath;
     }
 
+    /**
+     * volumePath is the path that identifies vSphere volume vmdk
+     */
     @JsonProperty("volumePath")
     public void setVolumePath(String volumePath) {
         this.volumePath = volumePath;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/WatchEvent.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/WatchEvent.java
index bb8c562f6c8..899a7f1de05 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/WatchEvent.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/WatchEvent.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Event represents a single event to a watched resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -54,22 +57,34 @@ public WatchEvent(Object object, String type) {
         this.type = type;
     }
 
+    /**
+     * Event represents a single event to a watched resource.
+     */
     @JsonProperty("object")
     public Object getObject() {
         return object;
     }
 
+    /**
+     * Event represents a single event to a watched resource.
+     */
     @JsonProperty("object")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setObject(Object object) {
         this.object = object;
     }
 
+    /**
+     * Event represents a single event to a watched resource.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Event represents a single event to a watched resource.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/WeightedPodAffinityTerm.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/WeightedPodAffinityTerm.java
index a0d91791979..36f731fbe73 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/WeightedPodAffinityTerm.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/WeightedPodAffinityTerm.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * The weights of all of the matched WeightedPodAffinityTerm fields are added per-node to find the most preferred node(s)
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -53,21 +56,33 @@ public WeightedPodAffinityTerm(PodAffinityTerm podAffinityTerm, Integer weight)
         this.weight = weight;
     }
 
+    /**
+     * The weights of all of the matched WeightedPodAffinityTerm fields are added per-node to find the most preferred node(s)
+     */
     @JsonProperty("podAffinityTerm")
     public PodAffinityTerm getPodAffinityTerm() {
         return podAffinityTerm;
     }
 
+    /**
+     * The weights of all of the matched WeightedPodAffinityTerm fields are added per-node to find the most preferred node(s)
+     */
     @JsonProperty("podAffinityTerm")
     public void setPodAffinityTerm(PodAffinityTerm podAffinityTerm) {
         this.podAffinityTerm = podAffinityTerm;
     }
 
+    /**
+     * weight associated with matching the corresponding podAffinityTerm, in the range 1-100.
+     */
     @JsonProperty("weight")
     public Integer getWeight() {
         return weight;
     }
 
+    /**
+     * weight associated with matching the corresponding podAffinityTerm, in the range 1-100.
+     */
     @JsonProperty("weight")
     public void setWeight(Integer weight) {
         this.weight = weight;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/WindowsSecurityContextOptions.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/WindowsSecurityContextOptions.java
index 33ad4b522e2..f7e709aded4 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/WindowsSecurityContextOptions.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/WindowsSecurityContextOptions.java
@@ -17,6 +17,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WindowsSecurityContextOptions contain Windows-specific options and credentials.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -61,41 +64,65 @@ public WindowsSecurityContextOptions(String gmsaCredentialSpec, String gmsaCrede
         this.runAsUserName = runAsUserName;
     }
 
+    /**
+     * GMSACredentialSpec is where the GMSA admission webhook (https://github.com/kubernetes-sigs/windows-gmsa) inlines the contents of the GMSA credential spec named by the GMSACredentialSpecName field.
+     */
     @JsonProperty("gmsaCredentialSpec")
     public String getGmsaCredentialSpec() {
         return gmsaCredentialSpec;
     }
 
+    /**
+     * GMSACredentialSpec is where the GMSA admission webhook (https://github.com/kubernetes-sigs/windows-gmsa) inlines the contents of the GMSA credential spec named by the GMSACredentialSpecName field.
+     */
     @JsonProperty("gmsaCredentialSpec")
     public void setGmsaCredentialSpec(String gmsaCredentialSpec) {
         this.gmsaCredentialSpec = gmsaCredentialSpec;
     }
 
+    /**
+     * GMSACredentialSpecName is the name of the GMSA credential spec to use.
+     */
     @JsonProperty("gmsaCredentialSpecName")
     public String getGmsaCredentialSpecName() {
         return gmsaCredentialSpecName;
     }
 
+    /**
+     * GMSACredentialSpecName is the name of the GMSA credential spec to use.
+     */
     @JsonProperty("gmsaCredentialSpecName")
     public void setGmsaCredentialSpecName(String gmsaCredentialSpecName) {
         this.gmsaCredentialSpecName = gmsaCredentialSpecName;
     }
 
+    /**
+     * HostProcess determines if a container should be run as a 'Host Process' container. All of a Pod's containers must have the same effective HostProcess value (it is not allowed to have a mix of HostProcess containers and non-HostProcess containers). In addition, if HostProcess is true then HostNetwork must also be set to true.
+     */
     @JsonProperty("hostProcess")
     public Boolean getHostProcess() {
         return hostProcess;
     }
 
+    /**
+     * HostProcess determines if a container should be run as a 'Host Process' container. All of a Pod's containers must have the same effective HostProcess value (it is not allowed to have a mix of HostProcess containers and non-HostProcess containers). In addition, if HostProcess is true then HostNetwork must also be set to true.
+     */
     @JsonProperty("hostProcess")
     public void setHostProcess(Boolean hostProcess) {
         this.hostProcess = hostProcess;
     }
 
+    /**
+     * The UserName in Windows to run the entrypoint of the container process. Defaults to the user specified in image metadata if unspecified. May also be set in PodSecurityContext. If set in both SecurityContext and PodSecurityContext, the value specified in SecurityContext takes precedence.
+     */
     @JsonProperty("runAsUserName")
     public String getRunAsUserName() {
         return runAsUserName;
     }
 
+    /**
+     * The UserName in Windows to run the entrypoint of the container process. Defaults to the user specified in image metadata if unspecified. May also be set in PodSecurityContext. If set in both SecurityContext and PodSecurityContext, the value specified in SecurityContext takes precedence.
+     */
     @JsonProperty("runAsUserName")
     public void setRunAsUserName(String runAsUserName) {
         this.runAsUserName = runAsUserName;
diff --git a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/version/Info.java b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/version/Info.java
index 7c6088bce97..ea7e8d92aa2 100644
--- a/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/version/Info.java
+++ b/kubernetes-model-generator/kubernetes-model-core/src/generated/java/io/fabric8/kubernetes/api/model/version/Info.java
@@ -18,6 +18,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Info contains versioning information. how we'll want to distribute that information.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,91 +85,145 @@ public Info(String buildDate, String compiler, String gitCommit, String gitTreeS
         this.platform = platform;
     }
 
+    /**
+     * Info contains versioning information. how we'll want to distribute that information.
+     */
     @JsonProperty("buildDate")
     public String getBuildDate() {
         return buildDate;
     }
 
+    /**
+     * Info contains versioning information. how we'll want to distribute that information.
+     */
     @JsonProperty("buildDate")
     public void setBuildDate(String buildDate) {
         this.buildDate = buildDate;
     }
 
+    /**
+     * Info contains versioning information. how we'll want to distribute that information.
+     */
     @JsonProperty("compiler")
     public String getCompiler() {
         return compiler;
     }
 
+    /**
+     * Info contains versioning information. how we'll want to distribute that information.
+     */
     @JsonProperty("compiler")
     public void setCompiler(String compiler) {
         this.compiler = compiler;
     }
 
+    /**
+     * Info contains versioning information. how we'll want to distribute that information.
+     */
     @JsonProperty("gitCommit")
     public String getGitCommit() {
         return gitCommit;
     }
 
+    /**
+     * Info contains versioning information. how we'll want to distribute that information.
+     */
     @JsonProperty("gitCommit")
     public void setGitCommit(String gitCommit) {
         this.gitCommit = gitCommit;
     }
 
+    /**
+     * Info contains versioning information. how we'll want to distribute that information.
+     */
     @JsonProperty("gitTreeState")
     public String getGitTreeState() {
         return gitTreeState;
     }
 
+    /**
+     * Info contains versioning information. how we'll want to distribute that information.
+     */
     @JsonProperty("gitTreeState")
     public void setGitTreeState(String gitTreeState) {
         this.gitTreeState = gitTreeState;
     }
 
+    /**
+     * Info contains versioning information. how we'll want to distribute that information.
+     */
     @JsonProperty("gitVersion")
     public String getGitVersion() {
         return gitVersion;
     }
 
+    /**
+     * Info contains versioning information. how we'll want to distribute that information.
+     */
     @JsonProperty("gitVersion")
     public void setGitVersion(String gitVersion) {
         this.gitVersion = gitVersion;
     }
 
+    /**
+     * Info contains versioning information. how we'll want to distribute that information.
+     */
     @JsonProperty("goVersion")
     public String getGoVersion() {
         return goVersion;
     }
 
+    /**
+     * Info contains versioning information. how we'll want to distribute that information.
+     */
     @JsonProperty("goVersion")
     public void setGoVersion(String goVersion) {
         this.goVersion = goVersion;
     }
 
+    /**
+     * Info contains versioning information. how we'll want to distribute that information.
+     */
     @JsonProperty("major")
     public String getMajor() {
         return major;
     }
 
+    /**
+     * Info contains versioning information. how we'll want to distribute that information.
+     */
     @JsonProperty("major")
     public void setMajor(String major) {
         this.major = major;
     }
 
+    /**
+     * Info contains versioning information. how we'll want to distribute that information.
+     */
     @JsonProperty("minor")
     public String getMinor() {
         return minor;
     }
 
+    /**
+     * Info contains versioning information. how we'll want to distribute that information.
+     */
     @JsonProperty("minor")
     public void setMinor(String minor) {
         this.minor = minor;
     }
 
+    /**
+     * Info contains versioning information. how we'll want to distribute that information.
+     */
     @JsonProperty("platform")
     public String getPlatform() {
         return platform;
     }
 
+    /**
+     * Info contains versioning information. how we'll want to distribute that information.
+     */
     @JsonProperty("platform")
     public void setPlatform(String platform) {
         this.platform = platform;
diff --git a/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1/Endpoint.java b/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1/Endpoint.java
index 0fd35166659..45d254a6c27 100644
--- a/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1/Endpoint.java
+++ b/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1/Endpoint.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Endpoint represents a single logical "backend" implementing a service.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -110,83 +113,131 @@ public Endpoint(List<String> addresses, EndpointConditions conditions, Map<Strin
         this.zone = zone;
     }
 
+    /**
+     * addresses of this endpoint. The contents of this field are interpreted according to the corresponding EndpointSlice addressType field. Consumers must handle different types of addresses in the context of their own capabilities. This must contain at least one address but no more than 100. These are all assumed to be fungible and clients may choose to only use the first element. Refer to: https://issue.k8s.io/106267
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAddresses() {
         return addresses;
     }
 
+    /**
+     * addresses of this endpoint. The contents of this field are interpreted according to the corresponding EndpointSlice addressType field. Consumers must handle different types of addresses in the context of their own capabilities. This must contain at least one address but no more than 100. These are all assumed to be fungible and clients may choose to only use the first element. Refer to: https://issue.k8s.io/106267
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<String> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * Endpoint represents a single logical "backend" implementing a service.
+     */
     @JsonProperty("conditions")
     public EndpointConditions getConditions() {
         return conditions;
     }
 
+    /**
+     * Endpoint represents a single logical "backend" implementing a service.
+     */
     @JsonProperty("conditions")
     public void setConditions(EndpointConditions conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * deprecatedTopology contains topology information part of the v1beta1 API. This field is deprecated, and will be removed when the v1beta1 API is removed (no sooner than kubernetes v1.24).  While this field can hold values, it is not writable through the v1 API, and any attempts to write to it will be silently ignored. Topology information can be found in the zone and nodeName fields instead.
+     */
     @JsonProperty("deprecatedTopology")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getDeprecatedTopology() {
         return deprecatedTopology;
     }
 
+    /**
+     * deprecatedTopology contains topology information part of the v1beta1 API. This field is deprecated, and will be removed when the v1beta1 API is removed (no sooner than kubernetes v1.24).  While this field can hold values, it is not writable through the v1 API, and any attempts to write to it will be silently ignored. Topology information can be found in the zone and nodeName fields instead.
+     */
     @JsonProperty("deprecatedTopology")
     public void setDeprecatedTopology(Map<String, String> deprecatedTopology) {
         this.deprecatedTopology = deprecatedTopology;
     }
 
+    /**
+     * Endpoint represents a single logical "backend" implementing a service.
+     */
     @JsonProperty("hints")
     public EndpointHints getHints() {
         return hints;
     }
 
+    /**
+     * Endpoint represents a single logical "backend" implementing a service.
+     */
     @JsonProperty("hints")
     public void setHints(EndpointHints hints) {
         this.hints = hints;
     }
 
+    /**
+     * hostname of this endpoint. This field may be used by consumers of endpoints to distinguish endpoints from each other (e.g. in DNS names). Multiple endpoints which use the same hostname should be considered fungible (e.g. multiple A values in DNS). Must be lowercase and pass DNS Label (RFC 1123) validation.
+     */
     @JsonProperty("hostname")
     public String getHostname() {
         return hostname;
     }
 
+    /**
+     * hostname of this endpoint. This field may be used by consumers of endpoints to distinguish endpoints from each other (e.g. in DNS names). Multiple endpoints which use the same hostname should be considered fungible (e.g. multiple A values in DNS). Must be lowercase and pass DNS Label (RFC 1123) validation.
+     */
     @JsonProperty("hostname")
     public void setHostname(String hostname) {
         this.hostname = hostname;
     }
 
+    /**
+     * nodeName represents the name of the Node hosting this endpoint. This can be used to determine endpoints local to a Node.
+     */
     @JsonProperty("nodeName")
     public String getNodeName() {
         return nodeName;
     }
 
+    /**
+     * nodeName represents the name of the Node hosting this endpoint. This can be used to determine endpoints local to a Node.
+     */
     @JsonProperty("nodeName")
     public void setNodeName(String nodeName) {
         this.nodeName = nodeName;
     }
 
+    /**
+     * Endpoint represents a single logical "backend" implementing a service.
+     */
     @JsonProperty("targetRef")
     public ObjectReference getTargetRef() {
         return targetRef;
     }
 
+    /**
+     * Endpoint represents a single logical "backend" implementing a service.
+     */
     @JsonProperty("targetRef")
     public void setTargetRef(ObjectReference targetRef) {
         this.targetRef = targetRef;
     }
 
+    /**
+     * zone is the name of the Zone this endpoint exists in.
+     */
     @JsonProperty("zone")
     public String getZone() {
         return zone;
     }
 
+    /**
+     * zone is the name of the Zone this endpoint exists in.
+     */
     @JsonProperty("zone")
     public void setZone(String zone) {
         this.zone = zone;
diff --git a/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1/EndpointConditions.java b/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1/EndpointConditions.java
index 61484dc14ac..0745e832287 100644
--- a/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1/EndpointConditions.java
+++ b/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1/EndpointConditions.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EndpointConditions represents the current condition of an endpoint.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public EndpointConditions(Boolean ready, Boolean serving, Boolean terminating) {
         this.terminating = terminating;
     }
 
+    /**
+     * ready indicates that this endpoint is prepared to receive traffic, according to whatever system is managing the endpoint. A nil value indicates an unknown state. In most cases consumers should interpret this unknown state as ready. For compatibility reasons, ready should never be "true" for terminating endpoints, except when the normal readiness behavior is being explicitly overridden, for example when the associated Service has set the publishNotReadyAddresses flag.
+     */
     @JsonProperty("ready")
     public Boolean getReady() {
         return ready;
     }
 
+    /**
+     * ready indicates that this endpoint is prepared to receive traffic, according to whatever system is managing the endpoint. A nil value indicates an unknown state. In most cases consumers should interpret this unknown state as ready. For compatibility reasons, ready should never be "true" for terminating endpoints, except when the normal readiness behavior is being explicitly overridden, for example when the associated Service has set the publishNotReadyAddresses flag.
+     */
     @JsonProperty("ready")
     public void setReady(Boolean ready) {
         this.ready = ready;
     }
 
+    /**
+     * serving is identical to ready except that it is set regardless of the terminating state of endpoints. This condition should be set to true for a ready endpoint that is terminating. If nil, consumers should defer to the ready condition.
+     */
     @JsonProperty("serving")
     public Boolean getServing() {
         return serving;
     }
 
+    /**
+     * serving is identical to ready except that it is set regardless of the terminating state of endpoints. This condition should be set to true for a ready endpoint that is terminating. If nil, consumers should defer to the ready condition.
+     */
     @JsonProperty("serving")
     public void setServing(Boolean serving) {
         this.serving = serving;
     }
 
+    /**
+     * terminating indicates that this endpoint is terminating. A nil value indicates an unknown state. Consumers should interpret this unknown state to mean that the endpoint is not terminating.
+     */
     @JsonProperty("terminating")
     public Boolean getTerminating() {
         return terminating;
     }
 
+    /**
+     * terminating indicates that this endpoint is terminating. A nil value indicates an unknown state. Consumers should interpret this unknown state to mean that the endpoint is not terminating.
+     */
     @JsonProperty("terminating")
     public void setTerminating(Boolean terminating) {
         this.terminating = terminating;
diff --git a/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1/EndpointHints.java b/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1/EndpointHints.java
index 73c45771cd8..d892a673919 100644
--- a/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1/EndpointHints.java
+++ b/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1/EndpointHints.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EndpointHints provides hints describing how an endpoint should be consumed.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public EndpointHints(List<ForZone> forZones) {
         this.forZones = forZones;
     }
 
+    /**
+     * forZones indicates the zone(s) this endpoint should be consumed by to enable topology aware routing.
+     */
     @JsonProperty("forZones")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ForZone> getForZones() {
         return forZones;
     }
 
+    /**
+     * forZones indicates the zone(s) this endpoint should be consumed by to enable topology aware routing.
+     */
     @JsonProperty("forZones")
     public void setForZones(List<ForZone> forZones) {
         this.forZones = forZones;
diff --git a/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1/EndpointPort.java b/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1/EndpointPort.java
index 6ec3cfd3652..04f1bca3e87 100644
--- a/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1/EndpointPort.java
+++ b/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1/EndpointPort.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EndpointPort represents a Port used by an EndpointSlice
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public EndpointPort(String appProtocol, String name, Integer port, String protoc
         this.protocol = protocol;
     }
 
+    /**
+     * The application protocol for this port. This is used as a hint for implementations to offer richer behavior for protocols that they understand. This field follows standard Kubernetes label syntax. Valid values are either:<br><p> <br><p> &#42; Un-prefixed protocol names - reserved for IANA standard service names (as per RFC-6335 and https://www.iana.org/assignments/service-names).<br><p> <br><p> &#42; Kubernetes-defined prefixed names:<br><p>   &#42; 'kubernetes.io/h2c' - HTTP/2 prior knowledge over cleartext as described in https://www.rfc-editor.org/rfc/rfc9113.html#name-starting-http-2-with-prior-<br><p>   &#42; 'kubernetes.io/ws'  - WebSocket over cleartext as described in https://www.rfc-editor.org/rfc/rfc6455<br><p>   &#42; 'kubernetes.io/wss' - WebSocket over TLS as described in https://www.rfc-editor.org/rfc/rfc6455<br><p> <br><p> &#42; Other protocols should use implementation-defined prefixed names such as mycompany.com/my-custom-protocol.
+     */
     @JsonProperty("appProtocol")
     public String getAppProtocol() {
         return appProtocol;
     }
 
+    /**
+     * The application protocol for this port. This is used as a hint for implementations to offer richer behavior for protocols that they understand. This field follows standard Kubernetes label syntax. Valid values are either:<br><p> <br><p> &#42; Un-prefixed protocol names - reserved for IANA standard service names (as per RFC-6335 and https://www.iana.org/assignments/service-names).<br><p> <br><p> &#42; Kubernetes-defined prefixed names:<br><p>   &#42; 'kubernetes.io/h2c' - HTTP/2 prior knowledge over cleartext as described in https://www.rfc-editor.org/rfc/rfc9113.html#name-starting-http-2-with-prior-<br><p>   &#42; 'kubernetes.io/ws'  - WebSocket over cleartext as described in https://www.rfc-editor.org/rfc/rfc6455<br><p>   &#42; 'kubernetes.io/wss' - WebSocket over TLS as described in https://www.rfc-editor.org/rfc/rfc6455<br><p> <br><p> &#42; Other protocols should use implementation-defined prefixed names such as mycompany.com/my-custom-protocol.
+     */
     @JsonProperty("appProtocol")
     public void setAppProtocol(String appProtocol) {
         this.appProtocol = appProtocol;
     }
 
+    /**
+     * name represents the name of this port. All ports in an EndpointSlice must have a unique name. If the EndpointSlice is derived from a Kubernetes service, this corresponds to the Service.ports[].name. Name must either be an empty string or pass DNS_LABEL validation: &#42; must be no more than 63 characters long. &#42; must consist of lower case alphanumeric characters or '-'. &#42; must start and end with an alphanumeric character. Default is empty string.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name represents the name of this port. All ports in an EndpointSlice must have a unique name. If the EndpointSlice is derived from a Kubernetes service, this corresponds to the Service.ports[].name. Name must either be an empty string or pass DNS_LABEL validation: &#42; must be no more than 63 characters long. &#42; must consist of lower case alphanumeric characters or '-'. &#42; must start and end with an alphanumeric character. Default is empty string.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * port represents the port number of the endpoint. If this is not specified, ports are not restricted and must be interpreted in the context of the specific consumer.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * port represents the port number of the endpoint. If this is not specified, ports are not restricted and must be interpreted in the context of the specific consumer.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * protocol represents the IP protocol for this port. Must be UDP, TCP, or SCTP. Default is TCP.
+     */
     @JsonProperty("protocol")
     public String getProtocol() {
         return protocol;
     }
 
+    /**
+     * protocol represents the IP protocol for this port. Must be UDP, TCP, or SCTP. Default is TCP.
+     */
     @JsonProperty("protocol")
     public void setProtocol(String protocol) {
         this.protocol = protocol;
diff --git a/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1/EndpointSlice.java b/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1/EndpointSlice.java
index 3b2a802e37f..1bb61b6a8ec 100644
--- a/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1/EndpointSlice.java
+++ b/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1/EndpointSlice.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EndpointSlice represents a subset of the endpoints that implement a service. For a given service there may be multiple EndpointSlice objects, selected by labels, which must be joined to produce the full set of endpoints.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,17 +84,11 @@ public class EndpointSlice implements Editable<EndpointSliceBuilder>, HasMetadat
 
     @JsonProperty("addressType")
     private String addressType;
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "discovery.k8s.io/v1";
     @JsonProperty("endpoints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<Endpoint> endpoints = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EndpointSlice";
     @JsonProperty("metadata")
@@ -118,18 +115,24 @@ public EndpointSlice(String addressType, String apiVersion, List<Endpoint> endpo
         this.ports = ports;
     }
 
+    /**
+     * addressType specifies the type of address carried by this EndpointSlice. All addresses in this slice must be the same type. This field is immutable after creation. The following address types are currently supported: &#42; IPv4: Represents an IPv4 Address. &#42; IPv6: Represents an IPv6 Address. &#42; FQDN: Represents a Fully Qualified Domain Name.
+     */
     @JsonProperty("addressType")
     public String getAddressType() {
         return addressType;
     }
 
+    /**
+     * addressType specifies the type of address carried by this EndpointSlice. All addresses in this slice must be the same type. This field is immutable after creation. The following address types are currently supported: &#42; IPv4: Represents an IPv4 Address. &#42; IPv6: Represents an IPv6 Address. &#42; FQDN: Represents a Fully Qualified Domain Name.
+     */
     @JsonProperty("addressType")
     public void setAddressType(String addressType) {
         this.addressType = addressType;
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -137,26 +140,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * endpoints is a list of unique endpoints in this slice. Each slice may include a maximum of 1000 endpoints.
+     */
     @JsonProperty("endpoints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Endpoint> getEndpoints() {
         return endpoints;
     }
 
+    /**
+     * endpoints is a list of unique endpoints in this slice. Each slice may include a maximum of 1000 endpoints.
+     */
     @JsonProperty("endpoints")
     public void setEndpoints(List<Endpoint> endpoints) {
         this.endpoints = endpoints;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -164,29 +173,41 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EndpointSlice represents a subset of the endpoints that implement a service. For a given service there may be multiple EndpointSlice objects, selected by labels, which must be joined to produce the full set of endpoints.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EndpointSlice represents a subset of the endpoints that implement a service. For a given service there may be multiple EndpointSlice objects, selected by labels, which must be joined to produce the full set of endpoints.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ports specifies the list of network ports exposed by each endpoint in this slice. Each port must have a unique name. When ports is empty, it indicates that there are no defined ports. When a port is defined with a nil port value, it indicates "all ports". Each slice may include a maximum of 100 ports.
+     */
     @JsonProperty("ports")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EndpointPort> getPorts() {
         return ports;
     }
 
+    /**
+     * ports specifies the list of network ports exposed by each endpoint in this slice. Each port must have a unique name. When ports is empty, it indicates that there are no defined ports. When a port is defined with a nil port value, it indicates "all ports". Each slice may include a maximum of 100 ports.
+     */
     @JsonProperty("ports")
     public void setPorts(List<EndpointPort> ports) {
         this.ports = ports;
diff --git a/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1/EndpointSliceList.java b/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1/EndpointSliceList.java
index ab156261609..d6c17d50446 100644
--- a/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1/EndpointSliceList.java
+++ b/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1/EndpointSliceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EndpointSliceList represents a list of endpoint slices
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class EndpointSliceList implements Editable<EndpointSliceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.discovery.v1.EndpointSlice>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "discovery.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.discovery.v1.EndpointSlice> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EndpointSliceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EndpointSliceList(String apiVersion, List<io.fabric8.kubernetes.api.model
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of endpoint slices
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.discovery.v1.EndpointSlice> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of endpoint slices
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.discovery.v1.EndpointSlice> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EndpointSliceList represents a list of endpoint slices
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EndpointSliceList represents a list of endpoint slices
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1/ForZone.java b/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1/ForZone.java
index 994c56f4c08..59a696c9ca2 100644
--- a/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1/ForZone.java
+++ b/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1/ForZone.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ForZone provides information about which zones should consume this endpoint.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ForZone(String name) {
         this.name = name;
     }
 
+    /**
+     * name represents the name of the zone.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name represents the name of the zone.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1beta1/Endpoint.java b/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1beta1/Endpoint.java
index cb7c33045ab..c36dcc45ff8 100644
--- a/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1beta1/Endpoint.java
+++ b/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1beta1/Endpoint.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Endpoint represents a single logical "backend" implementing a service.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -106,73 +109,115 @@ public Endpoint(List<String> addresses, EndpointConditions conditions, EndpointH
         this.topology = topology;
     }
 
+    /**
+     * addresses of this endpoint. The contents of this field are interpreted according to the corresponding EndpointSlice addressType field. Consumers must handle different types of addresses in the context of their own capabilities. This must contain at least one address but no more than 100.
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAddresses() {
         return addresses;
     }
 
+    /**
+     * addresses of this endpoint. The contents of this field are interpreted according to the corresponding EndpointSlice addressType field. Consumers must handle different types of addresses in the context of their own capabilities. This must contain at least one address but no more than 100.
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<String> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * Endpoint represents a single logical "backend" implementing a service.
+     */
     @JsonProperty("conditions")
     public EndpointConditions getConditions() {
         return conditions;
     }
 
+    /**
+     * Endpoint represents a single logical "backend" implementing a service.
+     */
     @JsonProperty("conditions")
     public void setConditions(EndpointConditions conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Endpoint represents a single logical "backend" implementing a service.
+     */
     @JsonProperty("hints")
     public EndpointHints getHints() {
         return hints;
     }
 
+    /**
+     * Endpoint represents a single logical "backend" implementing a service.
+     */
     @JsonProperty("hints")
     public void setHints(EndpointHints hints) {
         this.hints = hints;
     }
 
+    /**
+     * hostname of this endpoint. This field may be used by consumers of endpoints to distinguish endpoints from each other (e.g. in DNS names). Multiple endpoints which use the same hostname should be considered fungible (e.g. multiple A values in DNS). Must be lowercase and pass DNS Label (RFC 1123) validation.
+     */
     @JsonProperty("hostname")
     public String getHostname() {
         return hostname;
     }
 
+    /**
+     * hostname of this endpoint. This field may be used by consumers of endpoints to distinguish endpoints from each other (e.g. in DNS names). Multiple endpoints which use the same hostname should be considered fungible (e.g. multiple A values in DNS). Must be lowercase and pass DNS Label (RFC 1123) validation.
+     */
     @JsonProperty("hostname")
     public void setHostname(String hostname) {
         this.hostname = hostname;
     }
 
+    /**
+     * nodeName represents the name of the Node hosting this endpoint. This can be used to determine endpoints local to a Node. This field can be enabled with the EndpointSliceNodeName feature gate.
+     */
     @JsonProperty("nodeName")
     public String getNodeName() {
         return nodeName;
     }
 
+    /**
+     * nodeName represents the name of the Node hosting this endpoint. This can be used to determine endpoints local to a Node. This field can be enabled with the EndpointSliceNodeName feature gate.
+     */
     @JsonProperty("nodeName")
     public void setNodeName(String nodeName) {
         this.nodeName = nodeName;
     }
 
+    /**
+     * Endpoint represents a single logical "backend" implementing a service.
+     */
     @JsonProperty("targetRef")
     public ObjectReference getTargetRef() {
         return targetRef;
     }
 
+    /**
+     * Endpoint represents a single logical "backend" implementing a service.
+     */
     @JsonProperty("targetRef")
     public void setTargetRef(ObjectReference targetRef) {
         this.targetRef = targetRef;
     }
 
+    /**
+     * topology contains arbitrary topology information associated with the endpoint. These key/value pairs must conform with the label format. https://kubernetes.io/docs/concepts/overview/working-with-objects/labels Topology may include a maximum of 16 key/value pairs. This includes, but is not limited to the following well known keys: &#42; kubernetes.io/hostname: the value indicates the hostname of the node<br><p>   where the endpoint is located. This should match the corresponding<br><p>   node label.<br><p> &#42; topology.kubernetes.io/zone: the value indicates the zone where the<br><p>   endpoint is located. This should match the corresponding node label.<br><p> &#42; topology.kubernetes.io/region: the value indicates the region where the<br><p>   endpoint is located. This should match the corresponding node label.<br><p> This field is deprecated and will be removed in future api versions.
+     */
     @JsonProperty("topology")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getTopology() {
         return topology;
     }
 
+    /**
+     * topology contains arbitrary topology information associated with the endpoint. These key/value pairs must conform with the label format. https://kubernetes.io/docs/concepts/overview/working-with-objects/labels Topology may include a maximum of 16 key/value pairs. This includes, but is not limited to the following well known keys: &#42; kubernetes.io/hostname: the value indicates the hostname of the node<br><p>   where the endpoint is located. This should match the corresponding<br><p>   node label.<br><p> &#42; topology.kubernetes.io/zone: the value indicates the zone where the<br><p>   endpoint is located. This should match the corresponding node label.<br><p> &#42; topology.kubernetes.io/region: the value indicates the region where the<br><p>   endpoint is located. This should match the corresponding node label.<br><p> This field is deprecated and will be removed in future api versions.
+     */
     @JsonProperty("topology")
     public void setTopology(Map<String, String> topology) {
         this.topology = topology;
diff --git a/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1beta1/EndpointConditions.java b/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1beta1/EndpointConditions.java
index 7d69f2e9c66..534266a2a88 100644
--- a/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1beta1/EndpointConditions.java
+++ b/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1beta1/EndpointConditions.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EndpointConditions represents the current condition of an endpoint.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public EndpointConditions(Boolean ready, Boolean serving, Boolean terminating) {
         this.terminating = terminating;
     }
 
+    /**
+     * ready indicates that this endpoint is prepared to receive traffic, according to whatever system is managing the endpoint. A nil value indicates an unknown state. In most cases consumers should interpret this unknown state as ready. For compatibility reasons, ready should never be "true" for terminating endpoints.
+     */
     @JsonProperty("ready")
     public Boolean getReady() {
         return ready;
     }
 
+    /**
+     * ready indicates that this endpoint is prepared to receive traffic, according to whatever system is managing the endpoint. A nil value indicates an unknown state. In most cases consumers should interpret this unknown state as ready. For compatibility reasons, ready should never be "true" for terminating endpoints.
+     */
     @JsonProperty("ready")
     public void setReady(Boolean ready) {
         this.ready = ready;
     }
 
+    /**
+     * serving is identical to ready except that it is set regardless of the terminating state of endpoints. This condition should be set to true for a ready endpoint that is terminating. If nil, consumers should defer to the ready condition. This field can be enabled with the EndpointSliceTerminatingCondition feature gate.
+     */
     @JsonProperty("serving")
     public Boolean getServing() {
         return serving;
     }
 
+    /**
+     * serving is identical to ready except that it is set regardless of the terminating state of endpoints. This condition should be set to true for a ready endpoint that is terminating. If nil, consumers should defer to the ready condition. This field can be enabled with the EndpointSliceTerminatingCondition feature gate.
+     */
     @JsonProperty("serving")
     public void setServing(Boolean serving) {
         this.serving = serving;
     }
 
+    /**
+     * terminating indicates that this endpoint is terminating. A nil value indicates an unknown state. Consumers should interpret this unknown state to mean that the endpoint is not terminating. This field can be enabled with the EndpointSliceTerminatingCondition feature gate.
+     */
     @JsonProperty("terminating")
     public Boolean getTerminating() {
         return terminating;
     }
 
+    /**
+     * terminating indicates that this endpoint is terminating. A nil value indicates an unknown state. Consumers should interpret this unknown state to mean that the endpoint is not terminating. This field can be enabled with the EndpointSliceTerminatingCondition feature gate.
+     */
     @JsonProperty("terminating")
     public void setTerminating(Boolean terminating) {
         this.terminating = terminating;
diff --git a/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1beta1/EndpointHints.java b/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1beta1/EndpointHints.java
index 905ec314bb5..d951a86cb05 100644
--- a/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1beta1/EndpointHints.java
+++ b/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1beta1/EndpointHints.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EndpointHints provides hints describing how an endpoint should be consumed.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public EndpointHints(List<ForZone> forZones) {
         this.forZones = forZones;
     }
 
+    /**
+     * forZones indicates the zone(s) this endpoint should be consumed by to enable topology aware routing. May contain a maximum of 8 entries.
+     */
     @JsonProperty("forZones")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ForZone> getForZones() {
         return forZones;
     }
 
+    /**
+     * forZones indicates the zone(s) this endpoint should be consumed by to enable topology aware routing. May contain a maximum of 8 entries.
+     */
     @JsonProperty("forZones")
     public void setForZones(List<ForZone> forZones) {
         this.forZones = forZones;
diff --git a/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1beta1/EndpointPort.java b/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1beta1/EndpointPort.java
index 1dfdc626914..0d6b08c21e5 100644
--- a/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1beta1/EndpointPort.java
+++ b/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1beta1/EndpointPort.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EndpointPort represents a Port used by an EndpointSlice
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public EndpointPort(String appProtocol, String name, Integer port, String protoc
         this.protocol = protocol;
     }
 
+    /**
+     * The application protocol for this port. This field follows standard Kubernetes label syntax. Un-prefixed names are reserved for IANA standard service names (as per RFC-6335 and http://www.iana.org/assignments/service-names). Non-standard protocols should use prefixed names such as mycompany.com/my-custom-protocol.
+     */
     @JsonProperty("appProtocol")
     public String getAppProtocol() {
         return appProtocol;
     }
 
+    /**
+     * The application protocol for this port. This field follows standard Kubernetes label syntax. Un-prefixed names are reserved for IANA standard service names (as per RFC-6335 and http://www.iana.org/assignments/service-names). Non-standard protocols should use prefixed names such as mycompany.com/my-custom-protocol.
+     */
     @JsonProperty("appProtocol")
     public void setAppProtocol(String appProtocol) {
         this.appProtocol = appProtocol;
     }
 
+    /**
+     * The name of this port. All ports in an EndpointSlice must have a unique name. If the EndpointSlice is dervied from a Kubernetes service, this corresponds to the Service.ports[].name. Name must either be an empty string or pass DNS_LABEL validation: &#42; must be no more than 63 characters long. &#42; must consist of lower case alphanumeric characters or '-'. &#42; must start and end with an alphanumeric character. Default is empty string.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The name of this port. All ports in an EndpointSlice must have a unique name. If the EndpointSlice is dervied from a Kubernetes service, this corresponds to the Service.ports[].name. Name must either be an empty string or pass DNS_LABEL validation: &#42; must be no more than 63 characters long. &#42; must consist of lower case alphanumeric characters or '-'. &#42; must start and end with an alphanumeric character. Default is empty string.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * The port number of the endpoint. If this is not specified, ports are not restricted and must be interpreted in the context of the specific consumer.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * The port number of the endpoint. If this is not specified, ports are not restricted and must be interpreted in the context of the specific consumer.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * The IP protocol for this port. Must be UDP, TCP, or SCTP. Default is TCP.
+     */
     @JsonProperty("protocol")
     public String getProtocol() {
         return protocol;
     }
 
+    /**
+     * The IP protocol for this port. Must be UDP, TCP, or SCTP. Default is TCP.
+     */
     @JsonProperty("protocol")
     public void setProtocol(String protocol) {
         this.protocol = protocol;
diff --git a/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1beta1/EndpointSlice.java b/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1beta1/EndpointSlice.java
index 8c5cedac25c..86c91ddb1fc 100644
--- a/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1beta1/EndpointSlice.java
+++ b/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1beta1/EndpointSlice.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EndpointSlice represents a subset of the endpoints that implement a service. For a given service there may be multiple EndpointSlice objects, selected by labels, which must be joined to produce the full set of endpoints.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,17 +84,11 @@ public class EndpointSlice implements Editable<EndpointSliceBuilder>, HasMetadat
 
     @JsonProperty("addressType")
     private String addressType;
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "discovery.k8s.io/v1beta1";
     @JsonProperty("endpoints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<Endpoint> endpoints = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EndpointSlice";
     @JsonProperty("metadata")
@@ -118,18 +115,24 @@ public EndpointSlice(String addressType, String apiVersion, List<Endpoint> endpo
         this.ports = ports;
     }
 
+    /**
+     * addressType specifies the type of address carried by this EndpointSlice. All addresses in this slice must be the same type. This field is immutable after creation. The following address types are currently supported: &#42; IPv4: Represents an IPv4 Address. &#42; IPv6: Represents an IPv6 Address. &#42; FQDN: Represents a Fully Qualified Domain Name.
+     */
     @JsonProperty("addressType")
     public String getAddressType() {
         return addressType;
     }
 
+    /**
+     * addressType specifies the type of address carried by this EndpointSlice. All addresses in this slice must be the same type. This field is immutable after creation. The following address types are currently supported: &#42; IPv4: Represents an IPv4 Address. &#42; IPv6: Represents an IPv6 Address. &#42; FQDN: Represents a Fully Qualified Domain Name.
+     */
     @JsonProperty("addressType")
     public void setAddressType(String addressType) {
         this.addressType = addressType;
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -137,26 +140,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * endpoints is a list of unique endpoints in this slice. Each slice may include a maximum of 1000 endpoints.
+     */
     @JsonProperty("endpoints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Endpoint> getEndpoints() {
         return endpoints;
     }
 
+    /**
+     * endpoints is a list of unique endpoints in this slice. Each slice may include a maximum of 1000 endpoints.
+     */
     @JsonProperty("endpoints")
     public void setEndpoints(List<Endpoint> endpoints) {
         this.endpoints = endpoints;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -164,29 +173,41 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EndpointSlice represents a subset of the endpoints that implement a service. For a given service there may be multiple EndpointSlice objects, selected by labels, which must be joined to produce the full set of endpoints.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EndpointSlice represents a subset of the endpoints that implement a service. For a given service there may be multiple EndpointSlice objects, selected by labels, which must be joined to produce the full set of endpoints.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ports specifies the list of network ports exposed by each endpoint in this slice. Each port must have a unique name. When ports is empty, it indicates that there are no defined ports. When a port is defined with a nil port value, it indicates "all ports". Each slice may include a maximum of 100 ports.
+     */
     @JsonProperty("ports")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EndpointPort> getPorts() {
         return ports;
     }
 
+    /**
+     * ports specifies the list of network ports exposed by each endpoint in this slice. Each port must have a unique name. When ports is empty, it indicates that there are no defined ports. When a port is defined with a nil port value, it indicates "all ports". Each slice may include a maximum of 100 ports.
+     */
     @JsonProperty("ports")
     public void setPorts(List<EndpointPort> ports) {
         this.ports = ports;
diff --git a/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1beta1/EndpointSliceList.java b/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1beta1/EndpointSliceList.java
index 3def9baa78f..de225db9e34 100644
--- a/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1beta1/EndpointSliceList.java
+++ b/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1beta1/EndpointSliceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EndpointSliceList represents a list of endpoint slices
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class EndpointSliceList implements Editable<EndpointSliceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.discovery.v1beta1.EndpointSlice>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "discovery.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.discovery.v1beta1.EndpointSlice> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EndpointSliceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EndpointSliceList(String apiVersion, List<io.fabric8.kubernetes.api.model
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of endpoint slices
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.discovery.v1beta1.EndpointSlice> getItems() {
         return items;
     }
 
+    /**
+     * List of endpoint slices
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.discovery.v1beta1.EndpointSlice> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EndpointSliceList represents a list of endpoint slices
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EndpointSliceList represents a list of endpoint slices
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1beta1/ForZone.java b/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1beta1/ForZone.java
index 89b0b94f81e..971ec0e39fc 100644
--- a/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1beta1/ForZone.java
+++ b/kubernetes-model-generator/kubernetes-model-discovery/src/generated/java/io/fabric8/kubernetes/api/model/discovery/v1beta1/ForZone.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ForZone provides information about which zones should consume this endpoint.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ForZone(String name) {
         this.name = name;
     }
 
+    /**
+     * name represents the name of the zone.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name represents the name of the zone.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-events/src/generated/java/io/fabric8/kubernetes/api/model/events/v1/Event.java b/kubernetes-model-generator/kubernetes-model-events/src/generated/java/io/fabric8/kubernetes/api/model/events/v1/Event.java
index 9c3cc6f2e5e..fad202c1461 100644
--- a/kubernetes-model-generator/kubernetes-model-events/src/generated/java/io/fabric8/kubernetes/api/model/events/v1/Event.java
+++ b/kubernetes-model-generator/kubernetes-model-events/src/generated/java/io/fabric8/kubernetes/api/model/events/v1/Event.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -92,9 +95,6 @@ public class Event implements Editable<EventBuilder>, HasMetadata, Namespaced
 
     @JsonProperty("action")
     private String action;
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "events.k8s.io/v1";
     @JsonProperty("deprecatedCount")
@@ -107,9 +107,6 @@ public class Event implements Editable<EventBuilder>, HasMetadata, Namespaced
     private EventSource deprecatedSource;
     @JsonProperty("eventTime")
     private MicroTime eventTime;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Event";
     @JsonProperty("metadata")
@@ -160,18 +157,24 @@ public Event(String action, String apiVersion, Integer deprecatedCount, String d
         this.type = type;
     }
 
+    /**
+     * action is what action was taken/failed regarding to the regarding object. It is machine-readable. This field cannot be empty for new Events and it can have at most 128 characters.
+     */
     @JsonProperty("action")
     public String getAction() {
         return action;
     }
 
+    /**
+     * action is what action was taken/failed regarding to the regarding object. It is machine-readable. This field cannot be empty for new Events and it can have at most 128 characters.
+     */
     @JsonProperty("action")
     public void setAction(String action) {
         this.action = action;
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -179,65 +182,95 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * deprecatedCount is the deprecated field assuring backward compatibility with core.v1 Event type.
+     */
     @JsonProperty("deprecatedCount")
     public Integer getDeprecatedCount() {
         return deprecatedCount;
     }
 
+    /**
+     * deprecatedCount is the deprecated field assuring backward compatibility with core.v1 Event type.
+     */
     @JsonProperty("deprecatedCount")
     public void setDeprecatedCount(Integer deprecatedCount) {
         this.deprecatedCount = deprecatedCount;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("deprecatedFirstTimestamp")
     public String getDeprecatedFirstTimestamp() {
         return deprecatedFirstTimestamp;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("deprecatedFirstTimestamp")
     public void setDeprecatedFirstTimestamp(String deprecatedFirstTimestamp) {
         this.deprecatedFirstTimestamp = deprecatedFirstTimestamp;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("deprecatedLastTimestamp")
     public String getDeprecatedLastTimestamp() {
         return deprecatedLastTimestamp;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("deprecatedLastTimestamp")
     public void setDeprecatedLastTimestamp(String deprecatedLastTimestamp) {
         this.deprecatedLastTimestamp = deprecatedLastTimestamp;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("deprecatedSource")
     public EventSource getDeprecatedSource() {
         return deprecatedSource;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("deprecatedSource")
     public void setDeprecatedSource(EventSource deprecatedSource) {
         this.deprecatedSource = deprecatedSource;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("eventTime")
     public MicroTime getEventTime() {
         return eventTime;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("eventTime")
     public void setEventTime(MicroTime eventTime) {
         this.eventTime = eventTime;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -245,98 +278,152 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * note is a human-readable description of the status of this operation. Maximal length of the note is 1kB, but libraries should be prepared to handle values up to 64kB.
+     */
     @JsonProperty("note")
     public String getNote() {
         return note;
     }
 
+    /**
+     * note is a human-readable description of the status of this operation. Maximal length of the note is 1kB, but libraries should be prepared to handle values up to 64kB.
+     */
     @JsonProperty("note")
     public void setNote(String note) {
         this.note = note;
     }
 
+    /**
+     * reason is why the action was taken. It is human-readable. This field cannot be empty for new Events and it can have at most 128 characters.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * reason is why the action was taken. It is human-readable. This field cannot be empty for new Events and it can have at most 128 characters.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("regarding")
     public ObjectReference getRegarding() {
         return regarding;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("regarding")
     public void setRegarding(ObjectReference regarding) {
         this.regarding = regarding;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("related")
     public ObjectReference getRelated() {
         return related;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("related")
     public void setRelated(ObjectReference related) {
         this.related = related;
     }
 
+    /**
+     * reportingController is the name of the controller that emitted this Event, e.g. `kubernetes.io/kubelet`. This field cannot be empty for new Events.
+     */
     @JsonProperty("reportingController")
     public String getReportingController() {
         return reportingController;
     }
 
+    /**
+     * reportingController is the name of the controller that emitted this Event, e.g. `kubernetes.io/kubelet`. This field cannot be empty for new Events.
+     */
     @JsonProperty("reportingController")
     public void setReportingController(String reportingController) {
         this.reportingController = reportingController;
     }
 
+    /**
+     * reportingInstance is the ID of the controller instance, e.g. `kubelet-xyzf`. This field cannot be empty for new Events and it can have at most 128 characters.
+     */
     @JsonProperty("reportingInstance")
     public String getReportingInstance() {
         return reportingInstance;
     }
 
+    /**
+     * reportingInstance is the ID of the controller instance, e.g. `kubelet-xyzf`. This field cannot be empty for new Events and it can have at most 128 characters.
+     */
     @JsonProperty("reportingInstance")
     public void setReportingInstance(String reportingInstance) {
         this.reportingInstance = reportingInstance;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("series")
     public EventSeries getSeries() {
         return series;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("series")
     public void setSeries(EventSeries series) {
         this.series = series;
     }
 
+    /**
+     * type is the type of this event (Normal, Warning), new types could be added in the future. It is machine-readable. This field cannot be empty for new Events.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the type of this event (Normal, Warning), new types could be added in the future. It is machine-readable. This field cannot be empty for new Events.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-events/src/generated/java/io/fabric8/kubernetes/api/model/events/v1/EventList.java b/kubernetes-model-generator/kubernetes-model-events/src/generated/java/io/fabric8/kubernetes/api/model/events/v1/EventList.java
index b62ab90617c..3c3e7267cc3 100644
--- a/kubernetes-model-generator/kubernetes-model-events/src/generated/java/io/fabric8/kubernetes/api/model/events/v1/EventList.java
+++ b/kubernetes-model-generator/kubernetes-model-events/src/generated/java/io/fabric8/kubernetes/api/model/events/v1/EventList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventList is a list of Event objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class EventList implements Editable<EventListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.events.v1.Event>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "events.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.events.v1.Event> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EventList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EventList(String apiVersion, List<io.fabric8.kubernetes.api.model.events.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is a list of schema objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.events.v1.Event> getItems() {
         return items;
     }
 
+    /**
+     * items is a list of schema objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.events.v1.Event> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EventList is a list of Event objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EventList is a list of Event objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-events/src/generated/java/io/fabric8/kubernetes/api/model/events/v1/EventSeries.java b/kubernetes-model-generator/kubernetes-model-events/src/generated/java/io/fabric8/kubernetes/api/model/events/v1/EventSeries.java
index dab2783a669..6d03414c41d 100644
--- a/kubernetes-model-generator/kubernetes-model-events/src/generated/java/io/fabric8/kubernetes/api/model/events/v1/EventSeries.java
+++ b/kubernetes-model-generator/kubernetes-model-events/src/generated/java/io/fabric8/kubernetes/api/model/events/v1/EventSeries.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventSeries contain information on series of events, i.e. thing that was/is happening continuously for some time. How often to update the EventSeries is up to the event reporters. The default event reporter in "k8s.io/client-go/tools/events/event_broadcaster.go" shows how this struct is updated on heartbeats and can guide customized reporter implementations.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public EventSeries(Integer count, MicroTime lastObservedTime) {
         this.lastObservedTime = lastObservedTime;
     }
 
+    /**
+     * count is the number of occurrences in this series up to the last heartbeat time.
+     */
     @JsonProperty("count")
     public Integer getCount() {
         return count;
     }
 
+    /**
+     * count is the number of occurrences in this series up to the last heartbeat time.
+     */
     @JsonProperty("count")
     public void setCount(Integer count) {
         this.count = count;
     }
 
+    /**
+     * EventSeries contain information on series of events, i.e. thing that was/is happening continuously for some time. How often to update the EventSeries is up to the event reporters. The default event reporter in "k8s.io/client-go/tools/events/event_broadcaster.go" shows how this struct is updated on heartbeats and can guide customized reporter implementations.
+     */
     @JsonProperty("lastObservedTime")
     public MicroTime getLastObservedTime() {
         return lastObservedTime;
     }
 
+    /**
+     * EventSeries contain information on series of events, i.e. thing that was/is happening continuously for some time. How often to update the EventSeries is up to the event reporters. The default event reporter in "k8s.io/client-go/tools/events/event_broadcaster.go" shows how this struct is updated on heartbeats and can guide customized reporter implementations.
+     */
     @JsonProperty("lastObservedTime")
     public void setLastObservedTime(MicroTime lastObservedTime) {
         this.lastObservedTime = lastObservedTime;
diff --git a/kubernetes-model-generator/kubernetes-model-events/src/generated/java/io/fabric8/kubernetes/api/model/events/v1beta1/Event.java b/kubernetes-model-generator/kubernetes-model-events/src/generated/java/io/fabric8/kubernetes/api/model/events/v1beta1/Event.java
index f22e9bdfb30..e47c7bffd10 100644
--- a/kubernetes-model-generator/kubernetes-model-events/src/generated/java/io/fabric8/kubernetes/api/model/events/v1beta1/Event.java
+++ b/kubernetes-model-generator/kubernetes-model-events/src/generated/java/io/fabric8/kubernetes/api/model/events/v1beta1/Event.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -92,9 +95,6 @@ public class Event implements Editable<EventBuilder>, HasMetadata, Namespaced
 
     @JsonProperty("action")
     private String action;
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "events.k8s.io/v1beta1";
     @JsonProperty("deprecatedCount")
@@ -107,9 +107,6 @@ public class Event implements Editable<EventBuilder>, HasMetadata, Namespaced
     private EventSource deprecatedSource;
     @JsonProperty("eventTime")
     private MicroTime eventTime;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Event";
     @JsonProperty("metadata")
@@ -160,18 +157,24 @@ public Event(String action, String apiVersion, Integer deprecatedCount, String d
         this.type = type;
     }
 
+    /**
+     * action is what action was taken/failed regarding to the regarding object. It is machine-readable. This field can have at most 128 characters.
+     */
     @JsonProperty("action")
     public String getAction() {
         return action;
     }
 
+    /**
+     * action is what action was taken/failed regarding to the regarding object. It is machine-readable. This field can have at most 128 characters.
+     */
     @JsonProperty("action")
     public void setAction(String action) {
         this.action = action;
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -179,65 +182,95 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * deprecatedCount is the deprecated field assuring backward compatibility with core.v1 Event type.
+     */
     @JsonProperty("deprecatedCount")
     public Integer getDeprecatedCount() {
         return deprecatedCount;
     }
 
+    /**
+     * deprecatedCount is the deprecated field assuring backward compatibility with core.v1 Event type.
+     */
     @JsonProperty("deprecatedCount")
     public void setDeprecatedCount(Integer deprecatedCount) {
         this.deprecatedCount = deprecatedCount;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("deprecatedFirstTimestamp")
     public String getDeprecatedFirstTimestamp() {
         return deprecatedFirstTimestamp;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("deprecatedFirstTimestamp")
     public void setDeprecatedFirstTimestamp(String deprecatedFirstTimestamp) {
         this.deprecatedFirstTimestamp = deprecatedFirstTimestamp;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("deprecatedLastTimestamp")
     public String getDeprecatedLastTimestamp() {
         return deprecatedLastTimestamp;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("deprecatedLastTimestamp")
     public void setDeprecatedLastTimestamp(String deprecatedLastTimestamp) {
         this.deprecatedLastTimestamp = deprecatedLastTimestamp;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("deprecatedSource")
     public EventSource getDeprecatedSource() {
         return deprecatedSource;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("deprecatedSource")
     public void setDeprecatedSource(EventSource deprecatedSource) {
         this.deprecatedSource = deprecatedSource;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("eventTime")
     public MicroTime getEventTime() {
         return eventTime;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("eventTime")
     public void setEventTime(MicroTime eventTime) {
         this.eventTime = eventTime;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -245,98 +278,152 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * note is a human-readable description of the status of this operation. Maximal length of the note is 1kB, but libraries should be prepared to handle values up to 64kB.
+     */
     @JsonProperty("note")
     public String getNote() {
         return note;
     }
 
+    /**
+     * note is a human-readable description of the status of this operation. Maximal length of the note is 1kB, but libraries should be prepared to handle values up to 64kB.
+     */
     @JsonProperty("note")
     public void setNote(String note) {
         this.note = note;
     }
 
+    /**
+     * reason is why the action was taken. It is human-readable. This field can have at most 128 characters.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * reason is why the action was taken. It is human-readable. This field can have at most 128 characters.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("regarding")
     public ObjectReference getRegarding() {
         return regarding;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("regarding")
     public void setRegarding(ObjectReference regarding) {
         this.regarding = regarding;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("related")
     public ObjectReference getRelated() {
         return related;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("related")
     public void setRelated(ObjectReference related) {
         this.related = related;
     }
 
+    /**
+     * reportingController is the name of the controller that emitted this Event, e.g. `kubernetes.io/kubelet`. This field cannot be empty for new Events.
+     */
     @JsonProperty("reportingController")
     public String getReportingController() {
         return reportingController;
     }
 
+    /**
+     * reportingController is the name of the controller that emitted this Event, e.g. `kubernetes.io/kubelet`. This field cannot be empty for new Events.
+     */
     @JsonProperty("reportingController")
     public void setReportingController(String reportingController) {
         this.reportingController = reportingController;
     }
 
+    /**
+     * reportingInstance is the ID of the controller instance, e.g. `kubelet-xyzf`. This field cannot be empty for new Events and it can have at most 128 characters.
+     */
     @JsonProperty("reportingInstance")
     public String getReportingInstance() {
         return reportingInstance;
     }
 
+    /**
+     * reportingInstance is the ID of the controller instance, e.g. `kubelet-xyzf`. This field cannot be empty for new Events and it can have at most 128 characters.
+     */
     @JsonProperty("reportingInstance")
     public void setReportingInstance(String reportingInstance) {
         this.reportingInstance = reportingInstance;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("series")
     public EventSeries getSeries() {
         return series;
     }
 
+    /**
+     * Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time.  Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason.  Events should be treated as informative, best-effort, supplemental data.
+     */
     @JsonProperty("series")
     public void setSeries(EventSeries series) {
         this.series = series;
     }
 
+    /**
+     * type is the type of this event (Normal, Warning), new types could be added in the future. It is machine-readable.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the type of this event (Normal, Warning), new types could be added in the future. It is machine-readable.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-events/src/generated/java/io/fabric8/kubernetes/api/model/events/v1beta1/EventList.java b/kubernetes-model-generator/kubernetes-model-events/src/generated/java/io/fabric8/kubernetes/api/model/events/v1beta1/EventList.java
index eabd2ac060f..388d4f63133 100644
--- a/kubernetes-model-generator/kubernetes-model-events/src/generated/java/io/fabric8/kubernetes/api/model/events/v1beta1/EventList.java
+++ b/kubernetes-model-generator/kubernetes-model-events/src/generated/java/io/fabric8/kubernetes/api/model/events/v1beta1/EventList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventList is a list of Event objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class EventList implements Editable<EventListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.events.v1beta1.Event>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "events.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.events.v1beta1.Event> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EventList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EventList(String apiVersion, List<io.fabric8.kubernetes.api.model.events.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is a list of schema objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.events.v1beta1.Event> getItems() {
         return items;
     }
 
+    /**
+     * items is a list of schema objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.events.v1beta1.Event> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EventList is a list of Event objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EventList is a list of Event objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-events/src/generated/java/io/fabric8/kubernetes/api/model/events/v1beta1/EventSeries.java b/kubernetes-model-generator/kubernetes-model-events/src/generated/java/io/fabric8/kubernetes/api/model/events/v1beta1/EventSeries.java
index d206be6e284..75eba731590 100644
--- a/kubernetes-model-generator/kubernetes-model-events/src/generated/java/io/fabric8/kubernetes/api/model/events/v1beta1/EventSeries.java
+++ b/kubernetes-model-generator/kubernetes-model-events/src/generated/java/io/fabric8/kubernetes/api/model/events/v1beta1/EventSeries.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EventSeries contain information on series of events, i.e. thing that was/is happening continuously for some time.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public EventSeries(Integer count, MicroTime lastObservedTime) {
         this.lastObservedTime = lastObservedTime;
     }
 
+    /**
+     * count is the number of occurrences in this series up to the last heartbeat time.
+     */
     @JsonProperty("count")
     public Integer getCount() {
         return count;
     }
 
+    /**
+     * count is the number of occurrences in this series up to the last heartbeat time.
+     */
     @JsonProperty("count")
     public void setCount(Integer count) {
         this.count = count;
     }
 
+    /**
+     * EventSeries contain information on series of events, i.e. thing that was/is happening continuously for some time.
+     */
     @JsonProperty("lastObservedTime")
     public MicroTime getLastObservedTime() {
         return lastObservedTime;
     }
 
+    /**
+     * EventSeries contain information on series of events, i.e. thing that was/is happening continuously for some time.
+     */
     @JsonProperty("lastObservedTime")
     public void setLastObservedTime(MicroTime lastObservedTime) {
         this.lastObservedTime = lastObservedTime;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/AllowedCSIDriver.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/AllowedCSIDriver.java
index 8a1a641d513..dff1df00642 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/AllowedCSIDriver.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/AllowedCSIDriver.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AllowedCSIDriver represents a single inline CSI Driver that is allowed to be used.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public AllowedCSIDriver(String name) {
         this.name = name;
     }
 
+    /**
+     * Name is the registered name of the CSI driver
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the registered name of the CSI driver
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/AllowedFlexVolume.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/AllowedFlexVolume.java
index ffde4c5e613..8a7c933fc6b 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/AllowedFlexVolume.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/AllowedFlexVolume.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AllowedFlexVolume represents a single Flexvolume that is allowed to be used. Deprecated: use AllowedFlexVolume from policy API Group instead.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public AllowedFlexVolume(String driver) {
         this.driver = driver;
     }
 
+    /**
+     * driver is the name of the Flexvolume driver.
+     */
     @JsonProperty("driver")
     public String getDriver() {
         return driver;
     }
 
+    /**
+     * driver is the name of the Flexvolume driver.
+     */
     @JsonProperty("driver")
     public void setDriver(String driver) {
         this.driver = driver;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/AllowedHostPath.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/AllowedHostPath.java
index 17e982413ed..ee69dac9768 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/AllowedHostPath.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/AllowedHostPath.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AllowedHostPath defines the host volume conditions that will be enabled by a policy for pods to use. It requires the path prefix to be defined. Deprecated: use AllowedHostPath from policy API Group instead.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public AllowedHostPath(String pathPrefix, Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * pathPrefix is the path prefix that the host volume must match. It does not support `&#42;`. Trailing slashes are trimmed when validating the path prefix with a host path.<br><p> <br><p> Examples: `/foo` would allow `/foo`, `/foo/` and `/foo/bar` `/foo` would not allow `/food` or `/etc/foo`
+     */
     @JsonProperty("pathPrefix")
     public String getPathPrefix() {
         return pathPrefix;
     }
 
+    /**
+     * pathPrefix is the path prefix that the host volume must match. It does not support `&#42;`. Trailing slashes are trimmed when validating the path prefix with a host path.<br><p> <br><p> Examples: `/foo` would allow `/foo`, `/foo/` and `/foo/bar` `/foo` would not allow `/food` or `/etc/foo`
+     */
     @JsonProperty("pathPrefix")
     public void setPathPrefix(String pathPrefix) {
         this.pathPrefix = pathPrefix;
     }
 
+    /**
+     * when set to true, will allow host volumes matching the pathPrefix only if all volume mounts are readOnly.
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * when set to true, will allow host volumes matching the pathPrefix only if all volume mounts are readOnly.
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DaemonSet.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DaemonSet.java
index b66b8c38e8d..56030de2773 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DaemonSet.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DaemonSet.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DEPRECATED - This group version of DaemonSet is deprecated by apps/v1beta2/DaemonSet. See the release notes for more information. DaemonSet represents the configuration of a daemon set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class DaemonSet implements Editable<DaemonSetBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "extensions/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DaemonSet";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DaemonSet(String apiVersion, String kind, ObjectMeta metadata, DaemonSetS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DEPRECATED - This group version of DaemonSet is deprecated by apps/v1beta2/DaemonSet. See the release notes for more information. DaemonSet represents the configuration of a daemon set.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DEPRECATED - This group version of DaemonSet is deprecated by apps/v1beta2/DaemonSet. See the release notes for more information. DaemonSet represents the configuration of a daemon set.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * DEPRECATED - This group version of DaemonSet is deprecated by apps/v1beta2/DaemonSet. See the release notes for more information. DaemonSet represents the configuration of a daemon set.
+     */
     @JsonProperty("spec")
     public DaemonSetSpec getSpec() {
         return spec;
     }
 
+    /**
+     * DEPRECATED - This group version of DaemonSet is deprecated by apps/v1beta2/DaemonSet. See the release notes for more information. DaemonSet represents the configuration of a daemon set.
+     */
     @JsonProperty("spec")
     public void setSpec(DaemonSetSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * DEPRECATED - This group version of DaemonSet is deprecated by apps/v1beta2/DaemonSet. See the release notes for more information. DaemonSet represents the configuration of a daemon set.
+     */
     @JsonProperty("status")
     public DaemonSetStatus getStatus() {
         return status;
     }
 
+    /**
+     * DEPRECATED - This group version of DaemonSet is deprecated by apps/v1beta2/DaemonSet. See the release notes for more information. DaemonSet represents the configuration of a daemon set.
+     */
     @JsonProperty("status")
     public void setStatus(DaemonSetStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DaemonSetCondition.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DaemonSetCondition.java
index 274eac28194..ca08e0289cd 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DaemonSetCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DaemonSetCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DaemonSetCondition describes the state of a DaemonSet at a certain point.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public DaemonSetCondition(String lastTransitionTime, String message, String reas
         this.type = type;
     }
 
+    /**
+     * DaemonSetCondition describes the state of a DaemonSet at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * DaemonSetCondition describes the state of a DaemonSet at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type of DaemonSet condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of DaemonSet condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DaemonSetList.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DaemonSetList.java
index 044a242ab9f..a29142f6499 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DaemonSetList.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DaemonSetList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DaemonSetList is a collection of daemon sets.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class DaemonSetList implements Editable<DaemonSetListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.extensions.DaemonSet>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "extensions/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.extensions.DaemonSet> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DaemonSetList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DaemonSetList(String apiVersion, List<io.fabric8.kubernetes.api.model.ext
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * A list of daemon sets.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.extensions.DaemonSet> getItems() {
         return items;
     }
 
+    /**
+     * A list of daemon sets.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.extensions.DaemonSet> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DaemonSetList is a collection of daemon sets.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DaemonSetList is a collection of daemon sets.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DaemonSetSpec.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DaemonSetSpec.java
index 7304ed511d7..6a0b73156e8 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DaemonSetSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DaemonSetSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DaemonSetSpec is the specification of a daemon set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public DaemonSetSpec(Integer minReadySeconds, Integer revisionHistoryLimit, Labe
         this.updateStrategy = updateStrategy;
     }
 
+    /**
+     * The minimum number of seconds for which a newly created DaemonSet pod should be ready without any of its container crashing, for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready).
+     */
     @JsonProperty("minReadySeconds")
     public Integer getMinReadySeconds() {
         return minReadySeconds;
     }
 
+    /**
+     * The minimum number of seconds for which a newly created DaemonSet pod should be ready without any of its container crashing, for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready).
+     */
     @JsonProperty("minReadySeconds")
     public void setMinReadySeconds(Integer minReadySeconds) {
         this.minReadySeconds = minReadySeconds;
     }
 
+    /**
+     * The number of old history to retain to allow rollback. This is a pointer to distinguish between explicit zero and not specified. Defaults to 10.
+     */
     @JsonProperty("revisionHistoryLimit")
     public Integer getRevisionHistoryLimit() {
         return revisionHistoryLimit;
     }
 
+    /**
+     * The number of old history to retain to allow rollback. This is a pointer to distinguish between explicit zero and not specified. Defaults to 10.
+     */
     @JsonProperty("revisionHistoryLimit")
     public void setRevisionHistoryLimit(Integer revisionHistoryLimit) {
         this.revisionHistoryLimit = revisionHistoryLimit;
     }
 
+    /**
+     * DaemonSetSpec is the specification of a daemon set.
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * DaemonSetSpec is the specification of a daemon set.
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * DaemonSetSpec is the specification of a daemon set.
+     */
     @JsonProperty("template")
     public PodTemplateSpec getTemplate() {
         return template;
     }
 
+    /**
+     * DaemonSetSpec is the specification of a daemon set.
+     */
     @JsonProperty("template")
     public void setTemplate(PodTemplateSpec template) {
         this.template = template;
     }
 
+    /**
+     * DEPRECATED. A sequence number representing a specific generation of the template. Populated by the system. It can be set only during the creation.
+     */
     @JsonProperty("templateGeneration")
     public Long getTemplateGeneration() {
         return templateGeneration;
     }
 
+    /**
+     * DEPRECATED. A sequence number representing a specific generation of the template. Populated by the system. It can be set only during the creation.
+     */
     @JsonProperty("templateGeneration")
     public void setTemplateGeneration(Long templateGeneration) {
         this.templateGeneration = templateGeneration;
     }
 
+    /**
+     * DaemonSetSpec is the specification of a daemon set.
+     */
     @JsonProperty("updateStrategy")
     public DaemonSetUpdateStrategy getUpdateStrategy() {
         return updateStrategy;
     }
 
+    /**
+     * DaemonSetSpec is the specification of a daemon set.
+     */
     @JsonProperty("updateStrategy")
     public void setUpdateStrategy(DaemonSetUpdateStrategy updateStrategy) {
         this.updateStrategy = updateStrategy;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DaemonSetStatus.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DaemonSetStatus.java
index ad1e06d6f2d..62517dab5b4 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DaemonSetStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DaemonSetStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DaemonSetStatus represents the current status of a daemon set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -117,102 +120,162 @@ public DaemonSetStatus(Integer collisionCount, List<DaemonSetCondition> conditio
         this.updatedNumberScheduled = updatedNumberScheduled;
     }
 
+    /**
+     * Count of hash collisions for the DaemonSet. The DaemonSet controller uses this field as a collision avoidance mechanism when it needs to create the name for the newest ControllerRevision.
+     */
     @JsonProperty("collisionCount")
     public Integer getCollisionCount() {
         return collisionCount;
     }
 
+    /**
+     * Count of hash collisions for the DaemonSet. The DaemonSet controller uses this field as a collision avoidance mechanism when it needs to create the name for the newest ControllerRevision.
+     */
     @JsonProperty("collisionCount")
     public void setCollisionCount(Integer collisionCount) {
         this.collisionCount = collisionCount;
     }
 
+    /**
+     * Represents the latest available observations of a DaemonSet's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DaemonSetCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Represents the latest available observations of a DaemonSet's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<DaemonSetCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * The number of nodes that are running at least 1 daemon pod and are supposed to run the daemon pod. More info: https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/
+     */
     @JsonProperty("currentNumberScheduled")
     public Integer getCurrentNumberScheduled() {
         return currentNumberScheduled;
     }
 
+    /**
+     * The number of nodes that are running at least 1 daemon pod and are supposed to run the daemon pod. More info: https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/
+     */
     @JsonProperty("currentNumberScheduled")
     public void setCurrentNumberScheduled(Integer currentNumberScheduled) {
         this.currentNumberScheduled = currentNumberScheduled;
     }
 
+    /**
+     * The total number of nodes that should be running the daemon pod (including nodes correctly running the daemon pod). More info: https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/
+     */
     @JsonProperty("desiredNumberScheduled")
     public Integer getDesiredNumberScheduled() {
         return desiredNumberScheduled;
     }
 
+    /**
+     * The total number of nodes that should be running the daemon pod (including nodes correctly running the daemon pod). More info: https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/
+     */
     @JsonProperty("desiredNumberScheduled")
     public void setDesiredNumberScheduled(Integer desiredNumberScheduled) {
         this.desiredNumberScheduled = desiredNumberScheduled;
     }
 
+    /**
+     * The number of nodes that should be running the daemon pod and have one or more of the daemon pod running and available (ready for at least spec.minReadySeconds)
+     */
     @JsonProperty("numberAvailable")
     public Integer getNumberAvailable() {
         return numberAvailable;
     }
 
+    /**
+     * The number of nodes that should be running the daemon pod and have one or more of the daemon pod running and available (ready for at least spec.minReadySeconds)
+     */
     @JsonProperty("numberAvailable")
     public void setNumberAvailable(Integer numberAvailable) {
         this.numberAvailable = numberAvailable;
     }
 
+    /**
+     * The number of nodes that are running the daemon pod, but are not supposed to run the daemon pod. More info: https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/
+     */
     @JsonProperty("numberMisscheduled")
     public Integer getNumberMisscheduled() {
         return numberMisscheduled;
     }
 
+    /**
+     * The number of nodes that are running the daemon pod, but are not supposed to run the daemon pod. More info: https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/
+     */
     @JsonProperty("numberMisscheduled")
     public void setNumberMisscheduled(Integer numberMisscheduled) {
         this.numberMisscheduled = numberMisscheduled;
     }
 
+    /**
+     * The number of nodes that should be running the daemon pod and have one or more of the daemon pod running and ready.
+     */
     @JsonProperty("numberReady")
     public Integer getNumberReady() {
         return numberReady;
     }
 
+    /**
+     * The number of nodes that should be running the daemon pod and have one or more of the daemon pod running and ready.
+     */
     @JsonProperty("numberReady")
     public void setNumberReady(Integer numberReady) {
         this.numberReady = numberReady;
     }
 
+    /**
+     * The number of nodes that should be running the daemon pod and have none of the daemon pod running and available (ready for at least spec.minReadySeconds)
+     */
     @JsonProperty("numberUnavailable")
     public Integer getNumberUnavailable() {
         return numberUnavailable;
     }
 
+    /**
+     * The number of nodes that should be running the daemon pod and have none of the daemon pod running and available (ready for at least spec.minReadySeconds)
+     */
     @JsonProperty("numberUnavailable")
     public void setNumberUnavailable(Integer numberUnavailable) {
         this.numberUnavailable = numberUnavailable;
     }
 
+    /**
+     * The most recent generation observed by the daemon set controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * The most recent generation observed by the daemon set controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * The total number of nodes that are running updated daemon pod
+     */
     @JsonProperty("updatedNumberScheduled")
     public Integer getUpdatedNumberScheduled() {
         return updatedNumberScheduled;
     }
 
+    /**
+     * The total number of nodes that are running updated daemon pod
+     */
     @JsonProperty("updatedNumberScheduled")
     public void setUpdatedNumberScheduled(Integer updatedNumberScheduled) {
         this.updatedNumberScheduled = updatedNumberScheduled;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DaemonSetUpdateStrategy.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DaemonSetUpdateStrategy.java
index 5480325f990..eab1ab5eb5a 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DaemonSetUpdateStrategy.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DaemonSetUpdateStrategy.java
@@ -92,11 +92,17 @@ public void setRollingUpdate(RollingUpdateDaemonSet rollingUpdate) {
         this.rollingUpdate = rollingUpdate;
     }
 
+    /**
+     * Type of daemon set update. Can be "RollingUpdate" or "OnDelete". Default is OnDelete.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of daemon set update. Can be "RollingUpdate" or "OnDelete". Default is OnDelete.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/Deployment.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/Deployment.java
index e9714583764..f4edf71e5dd 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/Deployment.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/Deployment.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DEPRECATED - This group version of Deployment is deprecated by apps/v1beta2/Deployment. See the release notes for more information. Deployment enables declarative updates for Pods and ReplicaSets.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Deployment implements Editable<DeploymentBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "extensions/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Deployment";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Deployment(String apiVersion, String kind, ObjectMeta metadata, Deploymen
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DEPRECATED - This group version of Deployment is deprecated by apps/v1beta2/Deployment. See the release notes for more information. Deployment enables declarative updates for Pods and ReplicaSets.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DEPRECATED - This group version of Deployment is deprecated by apps/v1beta2/Deployment. See the release notes for more information. Deployment enables declarative updates for Pods and ReplicaSets.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * DEPRECATED - This group version of Deployment is deprecated by apps/v1beta2/Deployment. See the release notes for more information. Deployment enables declarative updates for Pods and ReplicaSets.
+     */
     @JsonProperty("spec")
     public DeploymentSpec getSpec() {
         return spec;
     }
 
+    /**
+     * DEPRECATED - This group version of Deployment is deprecated by apps/v1beta2/Deployment. See the release notes for more information. Deployment enables declarative updates for Pods and ReplicaSets.
+     */
     @JsonProperty("spec")
     public void setSpec(DeploymentSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * DEPRECATED - This group version of Deployment is deprecated by apps/v1beta2/Deployment. See the release notes for more information. Deployment enables declarative updates for Pods and ReplicaSets.
+     */
     @JsonProperty("status")
     public DeploymentStatus getStatus() {
         return status;
     }
 
+    /**
+     * DEPRECATED - This group version of Deployment is deprecated by apps/v1beta2/Deployment. See the release notes for more information. Deployment enables declarative updates for Pods and ReplicaSets.
+     */
     @JsonProperty("status")
     public void setStatus(DeploymentStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DeploymentCondition.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DeploymentCondition.java
index 50fc4cdf325..9b41b9dc993 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DeploymentCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DeploymentCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeploymentCondition describes the state of a deployment at a certain point.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public DeploymentCondition(String lastTransitionTime, String lastUpdateTime, Str
         this.type = type;
     }
 
+    /**
+     * DeploymentCondition describes the state of a deployment at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * DeploymentCondition describes the state of a deployment at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * DeploymentCondition describes the state of a deployment at a certain point.
+     */
     @JsonProperty("lastUpdateTime")
     public String getLastUpdateTime() {
         return lastUpdateTime;
     }
 
+    /**
+     * DeploymentCondition describes the state of a deployment at a certain point.
+     */
     @JsonProperty("lastUpdateTime")
     public void setLastUpdateTime(String lastUpdateTime) {
         this.lastUpdateTime = lastUpdateTime;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type of deployment condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of deployment condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DeploymentList.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DeploymentList.java
index 8403d18c9a5..683a742553e 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DeploymentList.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DeploymentList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeploymentList is a list of Deployments.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class DeploymentList implements Editable<DeploymentListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.extensions.Deployment>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "extensions/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.extensions.Deployment> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DeploymentList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DeploymentList(String apiVersion, List<io.fabric8.kubernetes.api.model.ex
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of Deployments.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.extensions.Deployment> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of Deployments.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.extensions.Deployment> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DeploymentList is a list of Deployments.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DeploymentList is a list of Deployments.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DeploymentRollback.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DeploymentRollback.java
index 22bb9671425..dd871ce619f 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DeploymentRollback.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DeploymentRollback.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DEPRECATED. DeploymentRollback stores the information required to rollback a deployment.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,52 +98,82 @@ public DeploymentRollback(String apiVersion, String kind, String name, RollbackC
         this.updatedAnnotations = updatedAnnotations;
     }
 
+    /**
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Required: This must match the Name of a deployment.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Required: This must match the Name of a deployment.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * DEPRECATED. DeploymentRollback stores the information required to rollback a deployment.
+     */
     @JsonProperty("rollbackTo")
     public RollbackConfig getRollbackTo() {
         return rollbackTo;
     }
 
+    /**
+     * DEPRECATED. DeploymentRollback stores the information required to rollback a deployment.
+     */
     @JsonProperty("rollbackTo")
     public void setRollbackTo(RollbackConfig rollbackTo) {
         this.rollbackTo = rollbackTo;
     }
 
+    /**
+     * The annotations to be updated to a deployment
+     */
     @JsonProperty("updatedAnnotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getUpdatedAnnotations() {
         return updatedAnnotations;
     }
 
+    /**
+     * The annotations to be updated to a deployment
+     */
     @JsonProperty("updatedAnnotations")
     public void setUpdatedAnnotations(Map<String, String> updatedAnnotations) {
         this.updatedAnnotations = updatedAnnotations;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DeploymentSpec.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DeploymentSpec.java
index 6e4d5e5c502..672b367e6b1 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DeploymentSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DeploymentSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeploymentSpec is the specification of the desired behavior of the Deployment.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -110,91 +113,145 @@ public DeploymentSpec(Integer minReadySeconds, Boolean paused, Integer progressD
         this.template = template;
     }
 
+    /**
+     * Minimum number of seconds for which a newly created pod should be ready without any of its container crashing, for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready)
+     */
     @JsonProperty("minReadySeconds")
     public Integer getMinReadySeconds() {
         return minReadySeconds;
     }
 
+    /**
+     * Minimum number of seconds for which a newly created pod should be ready without any of its container crashing, for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready)
+     */
     @JsonProperty("minReadySeconds")
     public void setMinReadySeconds(Integer minReadySeconds) {
         this.minReadySeconds = minReadySeconds;
     }
 
+    /**
+     * Indicates that the deployment is paused and will not be processed by the deployment controller.
+     */
     @JsonProperty("paused")
     public Boolean getPaused() {
         return paused;
     }
 
+    /**
+     * Indicates that the deployment is paused and will not be processed by the deployment controller.
+     */
     @JsonProperty("paused")
     public void setPaused(Boolean paused) {
         this.paused = paused;
     }
 
+    /**
+     * The maximum time in seconds for a deployment to make progress before it is considered to be failed. The deployment controller will continue to process failed deployments and a condition with a ProgressDeadlineExceeded reason will be surfaced in the deployment status. Note that progress will not be estimated during the time a deployment is paused. This is set to the max value of int32 (i.e. 2147483647) by default, which means "no deadline".
+     */
     @JsonProperty("progressDeadlineSeconds")
     public Integer getProgressDeadlineSeconds() {
         return progressDeadlineSeconds;
     }
 
+    /**
+     * The maximum time in seconds for a deployment to make progress before it is considered to be failed. The deployment controller will continue to process failed deployments and a condition with a ProgressDeadlineExceeded reason will be surfaced in the deployment status. Note that progress will not be estimated during the time a deployment is paused. This is set to the max value of int32 (i.e. 2147483647) by default, which means "no deadline".
+     */
     @JsonProperty("progressDeadlineSeconds")
     public void setProgressDeadlineSeconds(Integer progressDeadlineSeconds) {
         this.progressDeadlineSeconds = progressDeadlineSeconds;
     }
 
+    /**
+     * Number of desired pods. This is a pointer to distinguish between explicit zero and not specified. Defaults to 1.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Number of desired pods. This is a pointer to distinguish between explicit zero and not specified. Defaults to 1.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * The number of old ReplicaSets to retain to allow rollback. This is a pointer to distinguish between explicit zero and not specified. This is set to the max value of int32 (i.e. 2147483647) by default, which means "retaining all old RelicaSets".
+     */
     @JsonProperty("revisionHistoryLimit")
     public Integer getRevisionHistoryLimit() {
         return revisionHistoryLimit;
     }
 
+    /**
+     * The number of old ReplicaSets to retain to allow rollback. This is a pointer to distinguish between explicit zero and not specified. This is set to the max value of int32 (i.e. 2147483647) by default, which means "retaining all old RelicaSets".
+     */
     @JsonProperty("revisionHistoryLimit")
     public void setRevisionHistoryLimit(Integer revisionHistoryLimit) {
         this.revisionHistoryLimit = revisionHistoryLimit;
     }
 
+    /**
+     * DeploymentSpec is the specification of the desired behavior of the Deployment.
+     */
     @JsonProperty("rollbackTo")
     public RollbackConfig getRollbackTo() {
         return rollbackTo;
     }
 
+    /**
+     * DeploymentSpec is the specification of the desired behavior of the Deployment.
+     */
     @JsonProperty("rollbackTo")
     public void setRollbackTo(RollbackConfig rollbackTo) {
         this.rollbackTo = rollbackTo;
     }
 
+    /**
+     * DeploymentSpec is the specification of the desired behavior of the Deployment.
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * DeploymentSpec is the specification of the desired behavior of the Deployment.
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * DeploymentSpec is the specification of the desired behavior of the Deployment.
+     */
     @JsonProperty("strategy")
     public DeploymentStrategy getStrategy() {
         return strategy;
     }
 
+    /**
+     * DeploymentSpec is the specification of the desired behavior of the Deployment.
+     */
     @JsonProperty("strategy")
     public void setStrategy(DeploymentStrategy strategy) {
         this.strategy = strategy;
     }
 
+    /**
+     * DeploymentSpec is the specification of the desired behavior of the Deployment.
+     */
     @JsonProperty("template")
     public PodTemplateSpec getTemplate() {
         return template;
     }
 
+    /**
+     * DeploymentSpec is the specification of the desired behavior of the Deployment.
+     */
     @JsonProperty("template")
     public void setTemplate(PodTemplateSpec template) {
         this.template = template;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DeploymentStatus.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DeploymentStatus.java
index 4f1f8a1ce97..11f62e923e5 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DeploymentStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DeploymentStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeploymentStatus is the most recently observed status of the Deployment.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -109,82 +112,130 @@ public DeploymentStatus(Integer availableReplicas, Integer collisionCount, List<
         this.updatedReplicas = updatedReplicas;
     }
 
+    /**
+     * Total number of available pods (ready for at least minReadySeconds) targeted by this deployment.
+     */
     @JsonProperty("availableReplicas")
     public Integer getAvailableReplicas() {
         return availableReplicas;
     }
 
+    /**
+     * Total number of available pods (ready for at least minReadySeconds) targeted by this deployment.
+     */
     @JsonProperty("availableReplicas")
     public void setAvailableReplicas(Integer availableReplicas) {
         this.availableReplicas = availableReplicas;
     }
 
+    /**
+     * Count of hash collisions for the Deployment. The Deployment controller uses this field as a collision avoidance mechanism when it needs to create the name for the newest ReplicaSet.
+     */
     @JsonProperty("collisionCount")
     public Integer getCollisionCount() {
         return collisionCount;
     }
 
+    /**
+     * Count of hash collisions for the Deployment. The Deployment controller uses this field as a collision avoidance mechanism when it needs to create the name for the newest ReplicaSet.
+     */
     @JsonProperty("collisionCount")
     public void setCollisionCount(Integer collisionCount) {
         this.collisionCount = collisionCount;
     }
 
+    /**
+     * Represents the latest available observations of a deployment's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DeploymentCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Represents the latest available observations of a deployment's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<DeploymentCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * The generation observed by the deployment controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * The generation observed by the deployment controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Total number of ready pods targeted by this deployment.
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * Total number of ready pods targeted by this deployment.
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * Total number of non-terminated pods targeted by this deployment (their labels match the selector).
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Total number of non-terminated pods targeted by this deployment (their labels match the selector).
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * Total number of unavailable pods targeted by this deployment. This is the total number of pods that are still required for the deployment to have 100% available capacity. They may either be pods that are running but not yet available or pods that still have not been created.
+     */
     @JsonProperty("unavailableReplicas")
     public Integer getUnavailableReplicas() {
         return unavailableReplicas;
     }
 
+    /**
+     * Total number of unavailable pods targeted by this deployment. This is the total number of pods that are still required for the deployment to have 100% available capacity. They may either be pods that are running but not yet available or pods that still have not been created.
+     */
     @JsonProperty("unavailableReplicas")
     public void setUnavailableReplicas(Integer unavailableReplicas) {
         this.unavailableReplicas = unavailableReplicas;
     }
 
+    /**
+     * Total number of non-terminated pods targeted by this deployment that have the desired template spec.
+     */
     @JsonProperty("updatedReplicas")
     public Integer getUpdatedReplicas() {
         return updatedReplicas;
     }
 
+    /**
+     * Total number of non-terminated pods targeted by this deployment that have the desired template spec.
+     */
     @JsonProperty("updatedReplicas")
     public void setUpdatedReplicas(Integer updatedReplicas) {
         this.updatedReplicas = updatedReplicas;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DeploymentStrategy.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DeploymentStrategy.java
index efd3e41d19d..7185e7518b4 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DeploymentStrategy.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/DeploymentStrategy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeploymentStrategy describes how to replace existing pods with new ones.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public DeploymentStrategy(RollingUpdateDeployment rollingUpdate, String type) {
         this.type = type;
     }
 
+    /**
+     * DeploymentStrategy describes how to replace existing pods with new ones.
+     */
     @JsonProperty("rollingUpdate")
     public RollingUpdateDeployment getRollingUpdate() {
         return rollingUpdate;
     }
 
+    /**
+     * DeploymentStrategy describes how to replace existing pods with new ones.
+     */
     @JsonProperty("rollingUpdate")
     public void setRollingUpdate(RollingUpdateDeployment rollingUpdate) {
         this.rollingUpdate = rollingUpdate;
     }
 
+    /**
+     * Type of deployment. Can be "Recreate" or "RollingUpdate". Default is RollingUpdate.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of deployment. Can be "Recreate" or "RollingUpdate". Default is RollingUpdate.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/FSGroupStrategyOptions.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/FSGroupStrategyOptions.java
index 1b8a02a66eb..50f1def540c 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/FSGroupStrategyOptions.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/FSGroupStrategyOptions.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FSGroupStrategyOptions defines the strategy type and options used to create the strategy. Deprecated: use FSGroupStrategyOptions from policy API Group instead.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public FSGroupStrategyOptions(List<IDRange> ranges, String rule) {
         this.rule = rule;
     }
 
+    /**
+     * ranges are the allowed ranges of fs groups.  If you would like to force a single fs group then supply a single range with the same start and end. Required for MustRunAs.
+     */
     @JsonProperty("ranges")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IDRange> getRanges() {
         return ranges;
     }
 
+    /**
+     * ranges are the allowed ranges of fs groups.  If you would like to force a single fs group then supply a single range with the same start and end. Required for MustRunAs.
+     */
     @JsonProperty("ranges")
     public void setRanges(List<IDRange> ranges) {
         this.ranges = ranges;
     }
 
+    /**
+     * rule is the strategy that will dictate what FSGroup is used in the SecurityContext.
+     */
     @JsonProperty("rule")
     public String getRule() {
         return rule;
     }
 
+    /**
+     * rule is the strategy that will dictate what FSGroup is used in the SecurityContext.
+     */
     @JsonProperty("rule")
     public void setRule(String rule) {
         this.rule = rule;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/HTTPIngressPath.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/HTTPIngressPath.java
index e6d62d910b2..001aba586ee 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/HTTPIngressPath.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/HTTPIngressPath.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPIngressPath associates a path regex with a backend. Incoming urls matching the path are forwarded to the backend.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public HTTPIngressPath(IngressBackend backend, String path) {
         this.path = path;
     }
 
+    /**
+     * HTTPIngressPath associates a path regex with a backend. Incoming urls matching the path are forwarded to the backend.
+     */
     @JsonProperty("backend")
     public IngressBackend getBackend() {
         return backend;
     }
 
+    /**
+     * HTTPIngressPath associates a path regex with a backend. Incoming urls matching the path are forwarded to the backend.
+     */
     @JsonProperty("backend")
     public void setBackend(IngressBackend backend) {
         this.backend = backend;
     }
 
+    /**
+     * Path is an extended POSIX regex as defined by IEEE Std 1003.1, (i.e this follows the egrep/unix syntax, not the perl syntax) matched against the path of an incoming request. Currently it can contain characters disallowed from the conventional "path" part of a URL as defined by RFC 3986. Paths must begin with a '/'. If unspecified, the path defaults to a catch all sending traffic to the backend.
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Path is an extended POSIX regex as defined by IEEE Std 1003.1, (i.e this follows the egrep/unix syntax, not the perl syntax) matched against the path of an incoming request. Currently it can contain characters disallowed from the conventional "path" part of a URL as defined by RFC 3986. Paths must begin with a '/'. If unspecified, the path defaults to a catch all sending traffic to the backend.
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/HTTPIngressRuleValue.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/HTTPIngressRuleValue.java
index c1d6597ed97..cb6c0507cb6 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/HTTPIngressRuleValue.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/HTTPIngressRuleValue.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPIngressRuleValue is a list of http selectors pointing to backends. In the example: http://&lt;host&gt;/&lt;path&gt;?&lt;searchpart&gt; -&gt; backend where where parts of the url correspond to RFC 3986, this resource will be used to match against everything after the last '/' and before the first '?' or '#'.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public HTTPIngressRuleValue(List<HTTPIngressPath> paths) {
         this.paths = paths;
     }
 
+    /**
+     * A collection of paths that map requests to backends.
+     */
     @JsonProperty("paths")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HTTPIngressPath> getPaths() {
         return paths;
     }
 
+    /**
+     * A collection of paths that map requests to backends.
+     */
     @JsonProperty("paths")
     public void setPaths(List<HTTPIngressPath> paths) {
         this.paths = paths;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/HostPortRange.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/HostPortRange.java
index 451716b23f1..b3d875f326c 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/HostPortRange.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/HostPortRange.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HostPortRange defines a range of host ports that will be enabled by a policy for pods to use.  It requires both the start and end to be defined. Deprecated: use HostPortRange from policy API Group instead.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public HostPortRange(Integer max, Integer min) {
         this.min = min;
     }
 
+    /**
+     * max is the end of the range, inclusive.
+     */
     @JsonProperty("max")
     public Integer getMax() {
         return max;
     }
 
+    /**
+     * max is the end of the range, inclusive.
+     */
     @JsonProperty("max")
     public void setMax(Integer max) {
         this.max = max;
     }
 
+    /**
+     * min is the start of the range, inclusive.
+     */
     @JsonProperty("min")
     public Integer getMin() {
         return min;
     }
 
+    /**
+     * min is the start of the range, inclusive.
+     */
     @JsonProperty("min")
     public void setMin(Integer min) {
         this.min = min;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IDRange.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IDRange.java
index a31d90d640f..a11857b2aed 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IDRange.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IDRange.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IDRange provides a min/max of an allowed range of IDs. Deprecated: use IDRange from policy API Group instead.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public IDRange(Long max, Long min) {
         this.min = min;
     }
 
+    /**
+     * max is the end of the range, inclusive.
+     */
     @JsonProperty("max")
     public Long getMax() {
         return max;
     }
 
+    /**
+     * max is the end of the range, inclusive.
+     */
     @JsonProperty("max")
     public void setMax(Long max) {
         this.max = max;
     }
 
+    /**
+     * min is the start of the range, inclusive.
+     */
     @JsonProperty("min")
     public Long getMin() {
         return min;
     }
 
+    /**
+     * min is the start of the range, inclusive.
+     */
     @JsonProperty("min")
     public void setMin(Long min) {
         this.min = min;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IPBlock.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IPBlock.java
index 2aff86b945f..92fe0c7baa8 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IPBlock.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IPBlock.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DEPRECATED 1.9 - This group version of IPBlock is deprecated by networking/v1/IPBlock. IPBlock describes a particular CIDR (Ex. "192.168.1.1/24") that is allowed to the pods matched by a NetworkPolicySpec's podSelector. The except entry describes CIDRs that should not be included within this rule.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public IPBlock(String cidr, List<String> except) {
         this.except = except;
     }
 
+    /**
+     * CIDR is a string representing the IP Block Valid examples are "192.168.1.1/24"
+     */
     @JsonProperty("cidr")
     public String getCidr() {
         return cidr;
     }
 
+    /**
+     * CIDR is a string representing the IP Block Valid examples are "192.168.1.1/24"
+     */
     @JsonProperty("cidr")
     public void setCidr(String cidr) {
         this.cidr = cidr;
     }
 
+    /**
+     * Except is a slice of CIDRs that should not be included within an IP Block Valid examples are "192.168.1.1/24" Except values will be rejected if they are outside the CIDR range
+     */
     @JsonProperty("except")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getExcept() {
         return except;
     }
 
+    /**
+     * Except is a slice of CIDRs that should not be included within an IP Block Valid examples are "192.168.1.1/24" Except values will be rejected if they are outside the CIDR range
+     */
     @JsonProperty("except")
     public void setExcept(List<String> except) {
         this.except = except;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/Ingress.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/Ingress.java
index a4f39d7164f..2b9e6977047 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/Ingress.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/Ingress.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable urls, load balance traffic, terminate SSL, offer name based virtual hosting etc. DEPRECATED - This group version of Ingress is deprecated by networking.k8s.io/v1beta1 Ingress. See the release notes for more information.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Ingress implements Editable<IngressBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "extensions/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Ingress";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Ingress(String apiVersion, String kind, ObjectMeta metadata, IngressSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable urls, load balance traffic, terminate SSL, offer name based virtual hosting etc. DEPRECATED - This group version of Ingress is deprecated by networking.k8s.io/v1beta1 Ingress. See the release notes for more information.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable urls, load balance traffic, terminate SSL, offer name based virtual hosting etc. DEPRECATED - This group version of Ingress is deprecated by networking.k8s.io/v1beta1 Ingress. See the release notes for more information.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable urls, load balance traffic, terminate SSL, offer name based virtual hosting etc. DEPRECATED - This group version of Ingress is deprecated by networking.k8s.io/v1beta1 Ingress. See the release notes for more information.
+     */
     @JsonProperty("spec")
     public IngressSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable urls, load balance traffic, terminate SSL, offer name based virtual hosting etc. DEPRECATED - This group version of Ingress is deprecated by networking.k8s.io/v1beta1 Ingress. See the release notes for more information.
+     */
     @JsonProperty("spec")
     public void setSpec(IngressSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable urls, load balance traffic, terminate SSL, offer name based virtual hosting etc. DEPRECATED - This group version of Ingress is deprecated by networking.k8s.io/v1beta1 Ingress. See the release notes for more information.
+     */
     @JsonProperty("status")
     public IngressStatus getStatus() {
         return status;
     }
 
+    /**
+     * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable urls, load balance traffic, terminate SSL, offer name based virtual hosting etc. DEPRECATED - This group version of Ingress is deprecated by networking.k8s.io/v1beta1 Ingress. See the release notes for more information.
+     */
     @JsonProperty("status")
     public void setStatus(IngressStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IngressBackend.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IngressBackend.java
index 760d4819415..181d19e0897 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IngressBackend.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IngressBackend.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressBackend describes all endpoints for a given service and port.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public IngressBackend(String serviceName, IntOrString servicePort) {
         this.servicePort = servicePort;
     }
 
+    /**
+     * Specifies the name of the referenced service.
+     */
     @JsonProperty("serviceName")
     public String getServiceName() {
         return serviceName;
     }
 
+    /**
+     * Specifies the name of the referenced service.
+     */
     @JsonProperty("serviceName")
     public void setServiceName(String serviceName) {
         this.serviceName = serviceName;
     }
 
+    /**
+     * IngressBackend describes all endpoints for a given service and port.
+     */
     @JsonProperty("servicePort")
     public IntOrString getServicePort() {
         return servicePort;
     }
 
+    /**
+     * IngressBackend describes all endpoints for a given service and port.
+     */
     @JsonProperty("servicePort")
     public void setServicePort(IntOrString servicePort) {
         this.servicePort = servicePort;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IngressList.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IngressList.java
index 84a7139dead..34e7049dca8 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IngressList.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IngressList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressList is a collection of Ingress.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class IngressList implements Editable<IngressListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.extensions.Ingress>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "extensions/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.extensions.Ingress> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "IngressList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public IngressList(String apiVersion, List<io.fabric8.kubernetes.api.model.exten
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of Ingress.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.extensions.Ingress> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of Ingress.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.extensions.Ingress> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * IngressList is a collection of Ingress.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * IngressList is a collection of Ingress.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IngressRule.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IngressRule.java
index d11521f8177..d0235e97b27 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IngressRule.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IngressRule.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressRule represents the rules mapping the paths under a specified host to the related backend services. Incoming requests are first evaluated for a host match, then routed to the backend associated with the matching IngressRuleValue.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public IngressRule(String host, HTTPIngressRuleValue http) {
         this.http = http;
     }
 
+    /**
+     * Host is the fully qualified domain name of a network host, as defined by RFC 3986. Note the following deviations from the "host" part of the URI as defined in the RFC: 1. IPs are not allowed. Currently an IngressRuleValue can only apply to the<br><p> 	  IP in the Spec of the parent Ingress.<br><p> 2. The `:` delimiter is not respected because ports are not allowed.<br><p> 	  Currently the port of an Ingress is implicitly :80 for http and<br><p> 	  :443 for https.<br><p> Both these may change in the future. Incoming requests are matched against the host before the IngressRuleValue. If the host is unspecified, the Ingress routes all traffic based on the specified IngressRuleValue.
+     */
     @JsonProperty("host")
     public String getHost() {
         return host;
     }
 
+    /**
+     * Host is the fully qualified domain name of a network host, as defined by RFC 3986. Note the following deviations from the "host" part of the URI as defined in the RFC: 1. IPs are not allowed. Currently an IngressRuleValue can only apply to the<br><p> 	  IP in the Spec of the parent Ingress.<br><p> 2. The `:` delimiter is not respected because ports are not allowed.<br><p> 	  Currently the port of an Ingress is implicitly :80 for http and<br><p> 	  :443 for https.<br><p> Both these may change in the future. Incoming requests are matched against the host before the IngressRuleValue. If the host is unspecified, the Ingress routes all traffic based on the specified IngressRuleValue.
+     */
     @JsonProperty("host")
     public void setHost(String host) {
         this.host = host;
     }
 
+    /**
+     * IngressRule represents the rules mapping the paths under a specified host to the related backend services. Incoming requests are first evaluated for a host match, then routed to the backend associated with the matching IngressRuleValue.
+     */
     @JsonProperty("http")
     public HTTPIngressRuleValue getHttp() {
         return http;
     }
 
+    /**
+     * IngressRule represents the rules mapping the paths under a specified host to the related backend services. Incoming requests are first evaluated for a host match, then routed to the backend associated with the matching IngressRuleValue.
+     */
     @JsonProperty("http")
     public void setHttp(HTTPIngressRuleValue http) {
         this.http = http;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IngressSpec.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IngressSpec.java
index 474def17e7f..df348001b74 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IngressSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IngressSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressSpec describes the Ingress the user wishes to exist.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public IngressSpec(IngressBackend backend, List<IngressRule> rules, List<Ingress
         this.tls = tls;
     }
 
+    /**
+     * IngressSpec describes the Ingress the user wishes to exist.
+     */
     @JsonProperty("backend")
     public IngressBackend getBackend() {
         return backend;
     }
 
+    /**
+     * IngressSpec describes the Ingress the user wishes to exist.
+     */
     @JsonProperty("backend")
     public void setBackend(IngressBackend backend) {
         this.backend = backend;
     }
 
+    /**
+     * A list of host rules used to configure the Ingress. If unspecified, or no rule matches, all traffic is sent to the default backend.
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IngressRule> getRules() {
         return rules;
     }
 
+    /**
+     * A list of host rules used to configure the Ingress. If unspecified, or no rule matches, all traffic is sent to the default backend.
+     */
     @JsonProperty("rules")
     public void setRules(List<IngressRule> rules) {
         this.rules = rules;
     }
 
+    /**
+     * TLS configuration. Currently the Ingress only supports a single TLS port, 443. If multiple members of this list specify different hosts, they will be multiplexed on the same port according to the hostname specified through the SNI TLS extension, if the ingress controller fulfilling the ingress supports SNI.
+     */
     @JsonProperty("tls")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IngressTLS> getTls() {
         return tls;
     }
 
+    /**
+     * TLS configuration. Currently the Ingress only supports a single TLS port, 443. If multiple members of this list specify different hosts, they will be multiplexed on the same port according to the hostname specified through the SNI TLS extension, if the ingress controller fulfilling the ingress supports SNI.
+     */
     @JsonProperty("tls")
     public void setTls(List<IngressTLS> tls) {
         this.tls = tls;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IngressStatus.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IngressStatus.java
index 249dfdc4a2c..b6095e5886c 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IngressStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IngressStatus.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressStatus describe the current state of the Ingress.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,11 +82,17 @@ public IngressStatus(LoadBalancerStatus loadBalancer) {
         this.loadBalancer = loadBalancer;
     }
 
+    /**
+     * IngressStatus describe the current state of the Ingress.
+     */
     @JsonProperty("loadBalancer")
     public LoadBalancerStatus getLoadBalancer() {
         return loadBalancer;
     }
 
+    /**
+     * IngressStatus describe the current state of the Ingress.
+     */
     @JsonProperty("loadBalancer")
     public void setLoadBalancer(LoadBalancerStatus loadBalancer) {
         this.loadBalancer = loadBalancer;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IngressTLS.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IngressTLS.java
index 3e9e96d776a..78c5bc95649 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IngressTLS.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/IngressTLS.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressTLS describes the transport layer security associated with an Ingress.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public IngressTLS(List<String> hosts, String secretName) {
         this.secretName = secretName;
     }
 
+    /**
+     * Hosts are a list of hosts included in the TLS certificate. The values in this list must match the name/s used in the tlsSecret. Defaults to the wildcard host setting for the loadbalancer controller fulfilling this Ingress, if left unspecified.
+     */
     @JsonProperty("hosts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getHosts() {
         return hosts;
     }
 
+    /**
+     * Hosts are a list of hosts included in the TLS certificate. The values in this list must match the name/s used in the tlsSecret. Defaults to the wildcard host setting for the loadbalancer controller fulfilling this Ingress, if left unspecified.
+     */
     @JsonProperty("hosts")
     public void setHosts(List<String> hosts) {
         this.hosts = hosts;
     }
 
+    /**
+     * SecretName is the name of the secret used to terminate SSL traffic on 443. Field is left optional to allow SSL routing based on SNI hostname alone. If the SNI host in a listener conflicts with the "Host" header field used by an IngressRule, the SNI host is used for termination and value of the Host header is used for routing.
+     */
     @JsonProperty("secretName")
     public String getSecretName() {
         return secretName;
     }
 
+    /**
+     * SecretName is the name of the secret used to terminate SSL traffic on 443. Field is left optional to allow SSL routing based on SNI hostname alone. If the SNI host in a listener conflicts with the "Host" header field used by an IngressRule, the SNI host is used for termination and value of the Host header is used for routing.
+     */
     @JsonProperty("secretName")
     public void setSecretName(String secretName) {
         this.secretName = secretName;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/NetworkPolicy.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/NetworkPolicy.java
index 0270282d060..c9404452152 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/NetworkPolicy.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/NetworkPolicy.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DEPRECATED 1.9 - This group version of NetworkPolicy is deprecated by networking/v1/NetworkPolicy. NetworkPolicy describes what network traffic is allowed for a set of Pods
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class NetworkPolicy implements Editable<NetworkPolicyBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "extensions/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "NetworkPolicy";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public NetworkPolicy(String apiVersion, String kind, ObjectMeta metadata, Networ
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DEPRECATED 1.9 - This group version of NetworkPolicy is deprecated by networking/v1/NetworkPolicy. NetworkPolicy describes what network traffic is allowed for a set of Pods
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DEPRECATED 1.9 - This group version of NetworkPolicy is deprecated by networking/v1/NetworkPolicy. NetworkPolicy describes what network traffic is allowed for a set of Pods
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * DEPRECATED 1.9 - This group version of NetworkPolicy is deprecated by networking/v1/NetworkPolicy. NetworkPolicy describes what network traffic is allowed for a set of Pods
+     */
     @JsonProperty("spec")
     public NetworkPolicySpec getSpec() {
         return spec;
     }
 
+    /**
+     * DEPRECATED 1.9 - This group version of NetworkPolicy is deprecated by networking/v1/NetworkPolicy. NetworkPolicy describes what network traffic is allowed for a set of Pods
+     */
     @JsonProperty("spec")
     public void setSpec(NetworkPolicySpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/NetworkPolicyEgressRule.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/NetworkPolicyEgressRule.java
index a8acfdbc064..835e8ebf170 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/NetworkPolicyEgressRule.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/NetworkPolicyEgressRule.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DEPRECATED 1.9 - This group version of NetworkPolicyEgressRule is deprecated by networking/v1/NetworkPolicyEgressRule. NetworkPolicyEgressRule describes a particular set of traffic that is allowed out of pods matched by a NetworkPolicySpec's podSelector. The traffic must match both ports and to. This type is beta-level in 1.8
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public NetworkPolicyEgressRule(List<NetworkPolicyPort> ports, List<NetworkPolicy
         this.to = to;
     }
 
+    /**
+     * List of destination ports for outgoing traffic. Each item in this list is combined using a logical OR. If this field is empty or missing, this rule matches all ports (traffic not restricted by port). If this field is present and contains at least one item, then this rule allows traffic only if the traffic matches at least one port in the list.
+     */
     @JsonProperty("ports")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NetworkPolicyPort> getPorts() {
         return ports;
     }
 
+    /**
+     * List of destination ports for outgoing traffic. Each item in this list is combined using a logical OR. If this field is empty or missing, this rule matches all ports (traffic not restricted by port). If this field is present and contains at least one item, then this rule allows traffic only if the traffic matches at least one port in the list.
+     */
     @JsonProperty("ports")
     public void setPorts(List<NetworkPolicyPort> ports) {
         this.ports = ports;
     }
 
+    /**
+     * List of destinations for outgoing traffic of pods selected for this rule. Items in this list are combined using a logical OR operation. If this field is empty or missing, this rule matches all destinations (traffic not restricted by destination). If this field is present and contains at least one item, this rule allows traffic only if the traffic matches at least one item in the to list.
+     */
     @JsonProperty("to")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NetworkPolicyPeer> getTo() {
         return to;
     }
 
+    /**
+     * List of destinations for outgoing traffic of pods selected for this rule. Items in this list are combined using a logical OR operation. If this field is empty or missing, this rule matches all destinations (traffic not restricted by destination). If this field is present and contains at least one item, this rule allows traffic only if the traffic matches at least one item in the to list.
+     */
     @JsonProperty("to")
     public void setTo(List<NetworkPolicyPeer> to) {
         this.to = to;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/NetworkPolicyIngressRule.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/NetworkPolicyIngressRule.java
index 2c33e073d67..6fadde76692 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/NetworkPolicyIngressRule.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/NetworkPolicyIngressRule.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DEPRECATED 1.9 - This group version of NetworkPolicyIngressRule is deprecated by networking/v1/NetworkPolicyIngressRule. This NetworkPolicyIngressRule matches traffic if and only if the traffic matches both ports AND from.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public NetworkPolicyIngressRule(List<NetworkPolicyPeer> from, List<NetworkPolicy
         this.ports = ports;
     }
 
+    /**
+     * List of sources which should be able to access the pods selected for this rule. Items in this list are combined using a logical OR operation. If this field is empty or missing, this rule matches all sources (traffic not restricted by source). If this field is present and contains at least one item, this rule allows traffic only if the traffic matches at least one item in the from list.
+     */
     @JsonProperty("from")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NetworkPolicyPeer> getFrom() {
         return from;
     }
 
+    /**
+     * List of sources which should be able to access the pods selected for this rule. Items in this list are combined using a logical OR operation. If this field is empty or missing, this rule matches all sources (traffic not restricted by source). If this field is present and contains at least one item, this rule allows traffic only if the traffic matches at least one item in the from list.
+     */
     @JsonProperty("from")
     public void setFrom(List<NetworkPolicyPeer> from) {
         this.from = from;
     }
 
+    /**
+     * List of ports which should be made accessible on the pods selected for this rule. Each item in this list is combined using a logical OR. If this field is empty or missing, this rule matches all ports (traffic not restricted by port). If this field is present and contains at least one item, then this rule allows traffic only if the traffic matches at least one port in the list.
+     */
     @JsonProperty("ports")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NetworkPolicyPort> getPorts() {
         return ports;
     }
 
+    /**
+     * List of ports which should be made accessible on the pods selected for this rule. Each item in this list is combined using a logical OR. If this field is empty or missing, this rule matches all ports (traffic not restricted by port). If this field is present and contains at least one item, then this rule allows traffic only if the traffic matches at least one port in the list.
+     */
     @JsonProperty("ports")
     public void setPorts(List<NetworkPolicyPort> ports) {
         this.ports = ports;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/NetworkPolicyList.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/NetworkPolicyList.java
index 9938fb77323..c0deef0eec8 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/NetworkPolicyList.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/NetworkPolicyList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DEPRECATED 1.9 - This group version of NetworkPolicyList is deprecated by networking/v1/NetworkPolicyList. Network Policy List is a list of NetworkPolicy objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class NetworkPolicyList implements Editable<NetworkPolicyListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.extensions.NetworkPolicy>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "extensions/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.extensions.NetworkPolicy> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "NetworkPolicyList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public NetworkPolicyList(String apiVersion, List<io.fabric8.kubernetes.api.model
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of schema objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.extensions.NetworkPolicy> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of schema objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.extensions.NetworkPolicy> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DEPRECATED 1.9 - This group version of NetworkPolicyList is deprecated by networking/v1/NetworkPolicyList. Network Policy List is a list of NetworkPolicy objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DEPRECATED 1.9 - This group version of NetworkPolicyList is deprecated by networking/v1/NetworkPolicyList. Network Policy List is a list of NetworkPolicy objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/NetworkPolicyPeer.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/NetworkPolicyPeer.java
index b4067db892c..e1c62555b3f 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/NetworkPolicyPeer.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/NetworkPolicyPeer.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DEPRECATED 1.9 - This group version of NetworkPolicyPeer is deprecated by networking/v1/NetworkPolicyPeer.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public NetworkPolicyPeer(IPBlock ipBlock, LabelSelector namespaceSelector, Label
         this.podSelector = podSelector;
     }
 
+    /**
+     * DEPRECATED 1.9 - This group version of NetworkPolicyPeer is deprecated by networking/v1/NetworkPolicyPeer.
+     */
     @JsonProperty("ipBlock")
     public IPBlock getIpBlock() {
         return ipBlock;
     }
 
+    /**
+     * DEPRECATED 1.9 - This group version of NetworkPolicyPeer is deprecated by networking/v1/NetworkPolicyPeer.
+     */
     @JsonProperty("ipBlock")
     public void setIpBlock(IPBlock ipBlock) {
         this.ipBlock = ipBlock;
     }
 
+    /**
+     * DEPRECATED 1.9 - This group version of NetworkPolicyPeer is deprecated by networking/v1/NetworkPolicyPeer.
+     */
     @JsonProperty("namespaceSelector")
     public LabelSelector getNamespaceSelector() {
         return namespaceSelector;
     }
 
+    /**
+     * DEPRECATED 1.9 - This group version of NetworkPolicyPeer is deprecated by networking/v1/NetworkPolicyPeer.
+     */
     @JsonProperty("namespaceSelector")
     public void setNamespaceSelector(LabelSelector namespaceSelector) {
         this.namespaceSelector = namespaceSelector;
     }
 
+    /**
+     * DEPRECATED 1.9 - This group version of NetworkPolicyPeer is deprecated by networking/v1/NetworkPolicyPeer.
+     */
     @JsonProperty("podSelector")
     public LabelSelector getPodSelector() {
         return podSelector;
     }
 
+    /**
+     * DEPRECATED 1.9 - This group version of NetworkPolicyPeer is deprecated by networking/v1/NetworkPolicyPeer.
+     */
     @JsonProperty("podSelector")
     public void setPodSelector(LabelSelector podSelector) {
         this.podSelector = podSelector;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/NetworkPolicyPort.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/NetworkPolicyPort.java
index e06645211ed..51143112ace 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/NetworkPolicyPort.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/NetworkPolicyPort.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DEPRECATED 1.9 - This group version of NetworkPolicyPort is deprecated by networking/v1/NetworkPolicyPort.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public NetworkPolicyPort(IntOrString port, String protocol) {
         this.protocol = protocol;
     }
 
+    /**
+     * DEPRECATED 1.9 - This group version of NetworkPolicyPort is deprecated by networking/v1/NetworkPolicyPort.
+     */
     @JsonProperty("port")
     public IntOrString getPort() {
         return port;
     }
 
+    /**
+     * DEPRECATED 1.9 - This group version of NetworkPolicyPort is deprecated by networking/v1/NetworkPolicyPort.
+     */
     @JsonProperty("port")
     public void setPort(IntOrString port) {
         this.port = port;
     }
 
+    /**
+     * Optional.  The protocol (TCP, UDP, or SCTP) which traffic must match. If not specified, this field defaults to TCP.
+     */
     @JsonProperty("protocol")
     public String getProtocol() {
         return protocol;
     }
 
+    /**
+     * Optional.  The protocol (TCP, UDP, or SCTP) which traffic must match. If not specified, this field defaults to TCP.
+     */
     @JsonProperty("protocol")
     public void setProtocol(String protocol) {
         this.protocol = protocol;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/NetworkPolicySpec.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/NetworkPolicySpec.java
index 0213d956d95..6171e4f1247 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/NetworkPolicySpec.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/NetworkPolicySpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DEPRECATED 1.9 - This group version of NetworkPolicySpec is deprecated by networking/v1/NetworkPolicySpec.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,44 +98,68 @@ public NetworkPolicySpec(List<NetworkPolicyEgressRule> egress, List<NetworkPolic
         this.policyTypes = policyTypes;
     }
 
+    /**
+     * List of egress rules to be applied to the selected pods. Outgoing traffic is allowed if there are no NetworkPolicies selecting the pod (and cluster policy otherwise allows the traffic), OR if the traffic matches at least one egress rule across all of the NetworkPolicy objects whose podSelector matches the pod. If this field is empty then this NetworkPolicy limits all outgoing traffic (and serves solely to ensure that the pods it selects are isolated by default). This field is beta-level in 1.8
+     */
     @JsonProperty("egress")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NetworkPolicyEgressRule> getEgress() {
         return egress;
     }
 
+    /**
+     * List of egress rules to be applied to the selected pods. Outgoing traffic is allowed if there are no NetworkPolicies selecting the pod (and cluster policy otherwise allows the traffic), OR if the traffic matches at least one egress rule across all of the NetworkPolicy objects whose podSelector matches the pod. If this field is empty then this NetworkPolicy limits all outgoing traffic (and serves solely to ensure that the pods it selects are isolated by default). This field is beta-level in 1.8
+     */
     @JsonProperty("egress")
     public void setEgress(List<NetworkPolicyEgressRule> egress) {
         this.egress = egress;
     }
 
+    /**
+     * List of ingress rules to be applied to the selected pods. Traffic is allowed to a pod if there are no NetworkPolicies selecting the pod OR if the traffic source is the pod's local node, OR if the traffic matches at least one ingress rule across all of the NetworkPolicy objects whose podSelector matches the pod. If this field is empty then this NetworkPolicy does not allow any traffic (and serves solely to ensure that the pods it selects are isolated by default).
+     */
     @JsonProperty("ingress")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NetworkPolicyIngressRule> getIngress() {
         return ingress;
     }
 
+    /**
+     * List of ingress rules to be applied to the selected pods. Traffic is allowed to a pod if there are no NetworkPolicies selecting the pod OR if the traffic source is the pod's local node, OR if the traffic matches at least one ingress rule across all of the NetworkPolicy objects whose podSelector matches the pod. If this field is empty then this NetworkPolicy does not allow any traffic (and serves solely to ensure that the pods it selects are isolated by default).
+     */
     @JsonProperty("ingress")
     public void setIngress(List<NetworkPolicyIngressRule> ingress) {
         this.ingress = ingress;
     }
 
+    /**
+     * DEPRECATED 1.9 - This group version of NetworkPolicySpec is deprecated by networking/v1/NetworkPolicySpec.
+     */
     @JsonProperty("podSelector")
     public LabelSelector getPodSelector() {
         return podSelector;
     }
 
+    /**
+     * DEPRECATED 1.9 - This group version of NetworkPolicySpec is deprecated by networking/v1/NetworkPolicySpec.
+     */
     @JsonProperty("podSelector")
     public void setPodSelector(LabelSelector podSelector) {
         this.podSelector = podSelector;
     }
 
+    /**
+     * List of rule types that the NetworkPolicy relates to. Valid options are "Ingress", "Egress", or "Ingress,Egress". If this field is not specified, it will default based on the existence of Ingress or Egress rules; policies that contain an Egress section are assumed to affect Egress, and all policies (whether or not they contain an Ingress section) are assumed to affect Ingress. If you want to write an egress-only policy, you must explicitly specify policyTypes [ "Egress" ]. Likewise, if you want to write a policy that specifies that no egress is allowed, you must specify a policyTypes value that include "Egress" (since such a policy would not include an Egress section and would otherwise default to just [ "Ingress" ]). This field is beta-level in 1.8
+     */
     @JsonProperty("policyTypes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPolicyTypes() {
         return policyTypes;
     }
 
+    /**
+     * List of rule types that the NetworkPolicy relates to. Valid options are "Ingress", "Egress", or "Ingress,Egress". If this field is not specified, it will default based on the existence of Ingress or Egress rules; policies that contain an Egress section are assumed to affect Egress, and all policies (whether or not they contain an Ingress section) are assumed to affect Ingress. If you want to write an egress-only policy, you must explicitly specify policyTypes [ "Egress" ]. Likewise, if you want to write a policy that specifies that no egress is allowed, you must specify a policyTypes value that include "Egress" (since such a policy would not include an Egress section and would otherwise default to just [ "Ingress" ]). This field is beta-level in 1.8
+     */
     @JsonProperty("policyTypes")
     public void setPolicyTypes(List<String> policyTypes) {
         this.policyTypes = policyTypes;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/PodSecurityPolicy.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/PodSecurityPolicy.java
index 86ef5ae0de3..477e01565c3 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/PodSecurityPolicy.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/PodSecurityPolicy.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodSecurityPolicy governs the ability to make requests that affect the Security Context that will be applied to a pod and container. Deprecated: use PodSecurityPolicy from policy API Group instead.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class PodSecurityPolicy implements Editable<PodSecurityPolicyBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "extensions/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodSecurityPolicy";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public PodSecurityPolicy(String apiVersion, String kind, ObjectMeta metadata, Po
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodSecurityPolicy governs the ability to make requests that affect the Security Context that will be applied to a pod and container. Deprecated: use PodSecurityPolicy from policy API Group instead.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodSecurityPolicy governs the ability to make requests that affect the Security Context that will be applied to a pod and container. Deprecated: use PodSecurityPolicy from policy API Group instead.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PodSecurityPolicy governs the ability to make requests that affect the Security Context that will be applied to a pod and container. Deprecated: use PodSecurityPolicy from policy API Group instead.
+     */
     @JsonProperty("spec")
     public PodSecurityPolicySpec getSpec() {
         return spec;
     }
 
+    /**
+     * PodSecurityPolicy governs the ability to make requests that affect the Security Context that will be applied to a pod and container. Deprecated: use PodSecurityPolicy from policy API Group instead.
+     */
     @JsonProperty("spec")
     public void setSpec(PodSecurityPolicySpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/PodSecurityPolicyList.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/PodSecurityPolicyList.java
index 9c1a9829cc0..02371917385 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/PodSecurityPolicyList.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/PodSecurityPolicyList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodSecurityPolicyList is a list of PodSecurityPolicy objects. Deprecated: use PodSecurityPolicyList from policy API Group instead.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PodSecurityPolicyList implements Editable<PodSecurityPolicyListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.extensions.PodSecurityPolicy>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "extensions/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.extensions.PodSecurityPolicy> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodSecurityPolicyList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PodSecurityPolicyList(String apiVersion, List<io.fabric8.kubernetes.api.m
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is a list of schema objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.extensions.PodSecurityPolicy> getItems() {
         return items;
     }
 
+    /**
+     * items is a list of schema objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.extensions.PodSecurityPolicy> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodSecurityPolicyList is a list of PodSecurityPolicy objects. Deprecated: use PodSecurityPolicyList from policy API Group instead.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodSecurityPolicyList is a list of PodSecurityPolicy objects. Deprecated: use PodSecurityPolicyList from policy API Group instead.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/PodSecurityPolicySpec.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/PodSecurityPolicySpec.java
index 9f40e5a50ee..8659a5ede37 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/PodSecurityPolicySpec.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/PodSecurityPolicySpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodSecurityPolicySpec defines the policy enforced. Deprecated: use PodSecurityPolicySpec from policy API Group instead.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -183,252 +186,396 @@ public PodSecurityPolicySpec(Boolean allowPrivilegeEscalation, List<AllowedCSIDr
         this.volumes = volumes;
     }
 
+    /**
+     * allowPrivilegeEscalation determines if a pod can request to allow privilege escalation. If unspecified, defaults to true.
+     */
     @JsonProperty("allowPrivilegeEscalation")
     public Boolean getAllowPrivilegeEscalation() {
         return allowPrivilegeEscalation;
     }
 
+    /**
+     * allowPrivilegeEscalation determines if a pod can request to allow privilege escalation. If unspecified, defaults to true.
+     */
     @JsonProperty("allowPrivilegeEscalation")
     public void setAllowPrivilegeEscalation(Boolean allowPrivilegeEscalation) {
         this.allowPrivilegeEscalation = allowPrivilegeEscalation;
     }
 
+    /**
+     * AllowedCSIDrivers is a whitelist of inline CSI drivers that must be explicitly set to be embedded within a pod spec. An empty value indicates that any CSI driver can be used for inline ephemeral volumes.
+     */
     @JsonProperty("allowedCSIDrivers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AllowedCSIDriver> getAllowedCSIDrivers() {
         return allowedCSIDrivers;
     }
 
+    /**
+     * AllowedCSIDrivers is a whitelist of inline CSI drivers that must be explicitly set to be embedded within a pod spec. An empty value indicates that any CSI driver can be used for inline ephemeral volumes.
+     */
     @JsonProperty("allowedCSIDrivers")
     public void setAllowedCSIDrivers(List<AllowedCSIDriver> allowedCSIDrivers) {
         this.allowedCSIDrivers = allowedCSIDrivers;
     }
 
+    /**
+     * allowedCapabilities is a list of capabilities that can be requested to add to the container. Capabilities in this field may be added at the pod author's discretion. You must not list a capability in both allowedCapabilities and requiredDropCapabilities.
+     */
     @JsonProperty("allowedCapabilities")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAllowedCapabilities() {
         return allowedCapabilities;
     }
 
+    /**
+     * allowedCapabilities is a list of capabilities that can be requested to add to the container. Capabilities in this field may be added at the pod author's discretion. You must not list a capability in both allowedCapabilities and requiredDropCapabilities.
+     */
     @JsonProperty("allowedCapabilities")
     public void setAllowedCapabilities(List<String> allowedCapabilities) {
         this.allowedCapabilities = allowedCapabilities;
     }
 
+    /**
+     * allowedFlexVolumes is a whitelist of allowed Flexvolumes.  Empty or nil indicates that all Flexvolumes may be used.  This parameter is effective only when the usage of the Flexvolumes is allowed in the "volumes" field.
+     */
     @JsonProperty("allowedFlexVolumes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AllowedFlexVolume> getAllowedFlexVolumes() {
         return allowedFlexVolumes;
     }
 
+    /**
+     * allowedFlexVolumes is a whitelist of allowed Flexvolumes.  Empty or nil indicates that all Flexvolumes may be used.  This parameter is effective only when the usage of the Flexvolumes is allowed in the "volumes" field.
+     */
     @JsonProperty("allowedFlexVolumes")
     public void setAllowedFlexVolumes(List<AllowedFlexVolume> allowedFlexVolumes) {
         this.allowedFlexVolumes = allowedFlexVolumes;
     }
 
+    /**
+     * allowedHostPaths is a white list of allowed host paths. Empty indicates that all host paths may be used.
+     */
     @JsonProperty("allowedHostPaths")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AllowedHostPath> getAllowedHostPaths() {
         return allowedHostPaths;
     }
 
+    /**
+     * allowedHostPaths is a white list of allowed host paths. Empty indicates that all host paths may be used.
+     */
     @JsonProperty("allowedHostPaths")
     public void setAllowedHostPaths(List<AllowedHostPath> allowedHostPaths) {
         this.allowedHostPaths = allowedHostPaths;
     }
 
+    /**
+     * AllowedProcMountTypes is a whitelist of allowed ProcMountTypes. Empty or nil indicates that only the DefaultProcMountType may be used. This requires the ProcMountType feature flag to be enabled.
+     */
     @JsonProperty("allowedProcMountTypes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAllowedProcMountTypes() {
         return allowedProcMountTypes;
     }
 
+    /**
+     * AllowedProcMountTypes is a whitelist of allowed ProcMountTypes. Empty or nil indicates that only the DefaultProcMountType may be used. This requires the ProcMountType feature flag to be enabled.
+     */
     @JsonProperty("allowedProcMountTypes")
     public void setAllowedProcMountTypes(List<String> allowedProcMountTypes) {
         this.allowedProcMountTypes = allowedProcMountTypes;
     }
 
+    /**
+     * allowedUnsafeSysctls is a list of explicitly allowed unsafe sysctls, defaults to none. Each entry is either a plain sysctl name or ends in "&#42;" in which case it is considered as a prefix of allowed sysctls. Single &#42; means all unsafe sysctls are allowed. Kubelet has to whitelist all allowed unsafe sysctls explicitly to avoid rejection.<br><p> <br><p> Examples: e.g. "foo/&#42;" allows "foo/bar", "foo/baz", etc. e.g. "foo.&#42;" allows "foo.bar", "foo.baz", etc.
+     */
     @JsonProperty("allowedUnsafeSysctls")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAllowedUnsafeSysctls() {
         return allowedUnsafeSysctls;
     }
 
+    /**
+     * allowedUnsafeSysctls is a list of explicitly allowed unsafe sysctls, defaults to none. Each entry is either a plain sysctl name or ends in "&#42;" in which case it is considered as a prefix of allowed sysctls. Single &#42; means all unsafe sysctls are allowed. Kubelet has to whitelist all allowed unsafe sysctls explicitly to avoid rejection.<br><p> <br><p> Examples: e.g. "foo/&#42;" allows "foo/bar", "foo/baz", etc. e.g. "foo.&#42;" allows "foo.bar", "foo.baz", etc.
+     */
     @JsonProperty("allowedUnsafeSysctls")
     public void setAllowedUnsafeSysctls(List<String> allowedUnsafeSysctls) {
         this.allowedUnsafeSysctls = allowedUnsafeSysctls;
     }
 
+    /**
+     * defaultAddCapabilities is the default set of capabilities that will be added to the container unless the pod spec specifically drops the capability.  You may not list a capability in both defaultAddCapabilities and requiredDropCapabilities. Capabilities added here are implicitly allowed, and need not be included in the allowedCapabilities list.
+     */
     @JsonProperty("defaultAddCapabilities")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDefaultAddCapabilities() {
         return defaultAddCapabilities;
     }
 
+    /**
+     * defaultAddCapabilities is the default set of capabilities that will be added to the container unless the pod spec specifically drops the capability.  You may not list a capability in both defaultAddCapabilities and requiredDropCapabilities. Capabilities added here are implicitly allowed, and need not be included in the allowedCapabilities list.
+     */
     @JsonProperty("defaultAddCapabilities")
     public void setDefaultAddCapabilities(List<String> defaultAddCapabilities) {
         this.defaultAddCapabilities = defaultAddCapabilities;
     }
 
+    /**
+     * defaultAllowPrivilegeEscalation controls the default setting for whether a process can gain more privileges than its parent process.
+     */
     @JsonProperty("defaultAllowPrivilegeEscalation")
     public Boolean getDefaultAllowPrivilegeEscalation() {
         return defaultAllowPrivilegeEscalation;
     }
 
+    /**
+     * defaultAllowPrivilegeEscalation controls the default setting for whether a process can gain more privileges than its parent process.
+     */
     @JsonProperty("defaultAllowPrivilegeEscalation")
     public void setDefaultAllowPrivilegeEscalation(Boolean defaultAllowPrivilegeEscalation) {
         this.defaultAllowPrivilegeEscalation = defaultAllowPrivilegeEscalation;
     }
 
+    /**
+     * forbiddenSysctls is a list of explicitly forbidden sysctls, defaults to none. Each entry is either a plain sysctl name or ends in "&#42;" in which case it is considered as a prefix of forbidden sysctls. Single &#42; means all sysctls are forbidden.<br><p> <br><p> Examples: e.g. "foo/&#42;" forbids "foo/bar", "foo/baz", etc. e.g. "foo.&#42;" forbids "foo.bar", "foo.baz", etc.
+     */
     @JsonProperty("forbiddenSysctls")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getForbiddenSysctls() {
         return forbiddenSysctls;
     }
 
+    /**
+     * forbiddenSysctls is a list of explicitly forbidden sysctls, defaults to none. Each entry is either a plain sysctl name or ends in "&#42;" in which case it is considered as a prefix of forbidden sysctls. Single &#42; means all sysctls are forbidden.<br><p> <br><p> Examples: e.g. "foo/&#42;" forbids "foo/bar", "foo/baz", etc. e.g. "foo.&#42;" forbids "foo.bar", "foo.baz", etc.
+     */
     @JsonProperty("forbiddenSysctls")
     public void setForbiddenSysctls(List<String> forbiddenSysctls) {
         this.forbiddenSysctls = forbiddenSysctls;
     }
 
+    /**
+     * PodSecurityPolicySpec defines the policy enforced. Deprecated: use PodSecurityPolicySpec from policy API Group instead.
+     */
     @JsonProperty("fsGroup")
     public FSGroupStrategyOptions getFsGroup() {
         return fsGroup;
     }
 
+    /**
+     * PodSecurityPolicySpec defines the policy enforced. Deprecated: use PodSecurityPolicySpec from policy API Group instead.
+     */
     @JsonProperty("fsGroup")
     public void setFsGroup(FSGroupStrategyOptions fsGroup) {
         this.fsGroup = fsGroup;
     }
 
+    /**
+     * hostIPC determines if the policy allows the use of HostIPC in the pod spec.
+     */
     @JsonProperty("hostIPC")
     public Boolean getHostIPC() {
         return hostIPC;
     }
 
+    /**
+     * hostIPC determines if the policy allows the use of HostIPC in the pod spec.
+     */
     @JsonProperty("hostIPC")
     public void setHostIPC(Boolean hostIPC) {
         this.hostIPC = hostIPC;
     }
 
+    /**
+     * hostNetwork determines if the policy allows the use of HostNetwork in the pod spec.
+     */
     @JsonProperty("hostNetwork")
     public Boolean getHostNetwork() {
         return hostNetwork;
     }
 
+    /**
+     * hostNetwork determines if the policy allows the use of HostNetwork in the pod spec.
+     */
     @JsonProperty("hostNetwork")
     public void setHostNetwork(Boolean hostNetwork) {
         this.hostNetwork = hostNetwork;
     }
 
+    /**
+     * hostPID determines if the policy allows the use of HostPID in the pod spec.
+     */
     @JsonProperty("hostPID")
     public Boolean getHostPID() {
         return hostPID;
     }
 
+    /**
+     * hostPID determines if the policy allows the use of HostPID in the pod spec.
+     */
     @JsonProperty("hostPID")
     public void setHostPID(Boolean hostPID) {
         this.hostPID = hostPID;
     }
 
+    /**
+     * hostPorts determines which host port ranges are allowed to be exposed.
+     */
     @JsonProperty("hostPorts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HostPortRange> getHostPorts() {
         return hostPorts;
     }
 
+    /**
+     * hostPorts determines which host port ranges are allowed to be exposed.
+     */
     @JsonProperty("hostPorts")
     public void setHostPorts(List<HostPortRange> hostPorts) {
         this.hostPorts = hostPorts;
     }
 
+    /**
+     * privileged determines if a pod can request to be run as privileged.
+     */
     @JsonProperty("privileged")
     public Boolean getPrivileged() {
         return privileged;
     }
 
+    /**
+     * privileged determines if a pod can request to be run as privileged.
+     */
     @JsonProperty("privileged")
     public void setPrivileged(Boolean privileged) {
         this.privileged = privileged;
     }
 
+    /**
+     * readOnlyRootFilesystem when set to true will force containers to run with a read only root file system.  If the container specifically requests to run with a non-read only root file system the PSP should deny the pod. If set to false the container may run with a read only root file system if it wishes but it will not be forced to.
+     */
     @JsonProperty("readOnlyRootFilesystem")
     public Boolean getReadOnlyRootFilesystem() {
         return readOnlyRootFilesystem;
     }
 
+    /**
+     * readOnlyRootFilesystem when set to true will force containers to run with a read only root file system.  If the container specifically requests to run with a non-read only root file system the PSP should deny the pod. If set to false the container may run with a read only root file system if it wishes but it will not be forced to.
+     */
     @JsonProperty("readOnlyRootFilesystem")
     public void setReadOnlyRootFilesystem(Boolean readOnlyRootFilesystem) {
         this.readOnlyRootFilesystem = readOnlyRootFilesystem;
     }
 
+    /**
+     * requiredDropCapabilities are the capabilities that will be dropped from the container.  These are required to be dropped and cannot be added.
+     */
     @JsonProperty("requiredDropCapabilities")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getRequiredDropCapabilities() {
         return requiredDropCapabilities;
     }
 
+    /**
+     * requiredDropCapabilities are the capabilities that will be dropped from the container.  These are required to be dropped and cannot be added.
+     */
     @JsonProperty("requiredDropCapabilities")
     public void setRequiredDropCapabilities(List<String> requiredDropCapabilities) {
         this.requiredDropCapabilities = requiredDropCapabilities;
     }
 
+    /**
+     * PodSecurityPolicySpec defines the policy enforced. Deprecated: use PodSecurityPolicySpec from policy API Group instead.
+     */
     @JsonProperty("runAsGroup")
     public RunAsGroupStrategyOptions getRunAsGroup() {
         return runAsGroup;
     }
 
+    /**
+     * PodSecurityPolicySpec defines the policy enforced. Deprecated: use PodSecurityPolicySpec from policy API Group instead.
+     */
     @JsonProperty("runAsGroup")
     public void setRunAsGroup(RunAsGroupStrategyOptions runAsGroup) {
         this.runAsGroup = runAsGroup;
     }
 
+    /**
+     * PodSecurityPolicySpec defines the policy enforced. Deprecated: use PodSecurityPolicySpec from policy API Group instead.
+     */
     @JsonProperty("runAsUser")
     public RunAsUserStrategyOptions getRunAsUser() {
         return runAsUser;
     }
 
+    /**
+     * PodSecurityPolicySpec defines the policy enforced. Deprecated: use PodSecurityPolicySpec from policy API Group instead.
+     */
     @JsonProperty("runAsUser")
     public void setRunAsUser(RunAsUserStrategyOptions runAsUser) {
         this.runAsUser = runAsUser;
     }
 
+    /**
+     * PodSecurityPolicySpec defines the policy enforced. Deprecated: use PodSecurityPolicySpec from policy API Group instead.
+     */
     @JsonProperty("runtimeClass")
     public RuntimeClassStrategyOptions getRuntimeClass() {
         return runtimeClass;
     }
 
+    /**
+     * PodSecurityPolicySpec defines the policy enforced. Deprecated: use PodSecurityPolicySpec from policy API Group instead.
+     */
     @JsonProperty("runtimeClass")
     public void setRuntimeClass(RuntimeClassStrategyOptions runtimeClass) {
         this.runtimeClass = runtimeClass;
     }
 
+    /**
+     * PodSecurityPolicySpec defines the policy enforced. Deprecated: use PodSecurityPolicySpec from policy API Group instead.
+     */
     @JsonProperty("seLinux")
     public SELinuxStrategyOptions getSeLinux() {
         return seLinux;
     }
 
+    /**
+     * PodSecurityPolicySpec defines the policy enforced. Deprecated: use PodSecurityPolicySpec from policy API Group instead.
+     */
     @JsonProperty("seLinux")
     public void setSeLinux(SELinuxStrategyOptions seLinux) {
         this.seLinux = seLinux;
     }
 
+    /**
+     * PodSecurityPolicySpec defines the policy enforced. Deprecated: use PodSecurityPolicySpec from policy API Group instead.
+     */
     @JsonProperty("supplementalGroups")
     public SupplementalGroupsStrategyOptions getSupplementalGroups() {
         return supplementalGroups;
     }
 
+    /**
+     * PodSecurityPolicySpec defines the policy enforced. Deprecated: use PodSecurityPolicySpec from policy API Group instead.
+     */
     @JsonProperty("supplementalGroups")
     public void setSupplementalGroups(SupplementalGroupsStrategyOptions supplementalGroups) {
         this.supplementalGroups = supplementalGroups;
     }
 
+    /**
+     * volumes is a white list of allowed volume plugins. Empty indicates that no volumes may be used. To allow all volumes you may use '&#42;'.
+     */
     @JsonProperty("volumes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getVolumes() {
         return volumes;
     }
 
+    /**
+     * volumes is a white list of allowed volume plugins. Empty indicates that no volumes may be used. To allow all volumes you may use '&#42;'.
+     */
     @JsonProperty("volumes")
     public void setVolumes(List<String> volumes) {
         this.volumes = volumes;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/ReplicaSet.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/ReplicaSet.java
index fa9d5af7db6..09d51491d28 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/ReplicaSet.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/ReplicaSet.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DEPRECATED - This group version of ReplicaSet is deprecated by apps/v1beta2/ReplicaSet. See the release notes for more information. ReplicaSet ensures that a specified number of pod replicas are running at any given time.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class ReplicaSet implements Editable<ReplicaSetBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "extensions/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ReplicaSet";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ReplicaSet(String apiVersion, String kind, ObjectMeta metadata, ReplicaSe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DEPRECATED - This group version of ReplicaSet is deprecated by apps/v1beta2/ReplicaSet. See the release notes for more information. ReplicaSet ensures that a specified number of pod replicas are running at any given time.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DEPRECATED - This group version of ReplicaSet is deprecated by apps/v1beta2/ReplicaSet. See the release notes for more information. ReplicaSet ensures that a specified number of pod replicas are running at any given time.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * DEPRECATED - This group version of ReplicaSet is deprecated by apps/v1beta2/ReplicaSet. See the release notes for more information. ReplicaSet ensures that a specified number of pod replicas are running at any given time.
+     */
     @JsonProperty("spec")
     public ReplicaSetSpec getSpec() {
         return spec;
     }
 
+    /**
+     * DEPRECATED - This group version of ReplicaSet is deprecated by apps/v1beta2/ReplicaSet. See the release notes for more information. ReplicaSet ensures that a specified number of pod replicas are running at any given time.
+     */
     @JsonProperty("spec")
     public void setSpec(ReplicaSetSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * DEPRECATED - This group version of ReplicaSet is deprecated by apps/v1beta2/ReplicaSet. See the release notes for more information. ReplicaSet ensures that a specified number of pod replicas are running at any given time.
+     */
     @JsonProperty("status")
     public ReplicaSetStatus getStatus() {
         return status;
     }
 
+    /**
+     * DEPRECATED - This group version of ReplicaSet is deprecated by apps/v1beta2/ReplicaSet. See the release notes for more information. ReplicaSet ensures that a specified number of pod replicas are running at any given time.
+     */
     @JsonProperty("status")
     public void setStatus(ReplicaSetStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/ReplicaSetCondition.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/ReplicaSetCondition.java
index 21230515475..5ac39cbef8e 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/ReplicaSetCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/ReplicaSetCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ReplicaSetCondition describes the state of a replica set at a certain point.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public ReplicaSetCondition(String lastTransitionTime, String message, String rea
         this.type = type;
     }
 
+    /**
+     * ReplicaSetCondition describes the state of a replica set at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * ReplicaSetCondition describes the state of a replica set at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type of replica set condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of replica set condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/ReplicaSetList.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/ReplicaSetList.java
index e8d98bd9852..e7b6ee6e9cc 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/ReplicaSetList.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/ReplicaSetList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ReplicaSetList is a collection of ReplicaSets.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ReplicaSetList implements Editable<ReplicaSetListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.extensions.ReplicaSet>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "extensions/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.extensions.ReplicaSet> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ReplicaSetList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ReplicaSetList(String apiVersion, List<io.fabric8.kubernetes.api.model.ex
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of ReplicaSets. More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.extensions.ReplicaSet> getItems() {
         return items;
     }
 
+    /**
+     * List of ReplicaSets. More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.extensions.ReplicaSet> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ReplicaSetList is a collection of ReplicaSets.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ReplicaSetList is a collection of ReplicaSets.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/ReplicaSetSpec.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/ReplicaSetSpec.java
index 00ff67498e0..24b6a42b512 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/ReplicaSetSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/ReplicaSetSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ReplicaSetSpec is the specification of a ReplicaSet.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ReplicaSetSpec(Integer minReadySeconds, Integer replicas, LabelSelector s
         this.template = template;
     }
 
+    /**
+     * Minimum number of seconds for which a newly created pod should be ready without any of its container crashing, for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready)
+     */
     @JsonProperty("minReadySeconds")
     public Integer getMinReadySeconds() {
         return minReadySeconds;
     }
 
+    /**
+     * Minimum number of seconds for which a newly created pod should be ready without any of its container crashing, for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready)
+     */
     @JsonProperty("minReadySeconds")
     public void setMinReadySeconds(Integer minReadySeconds) {
         this.minReadySeconds = minReadySeconds;
     }
 
+    /**
+     * Replicas is the number of desired replicas. This is a pointer to distinguish between explicit zero and unspecified. Defaults to 1. More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller/#what-is-a-replicationcontroller
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Replicas is the number of desired replicas. This is a pointer to distinguish between explicit zero and unspecified. Defaults to 1. More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller/#what-is-a-replicationcontroller
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * ReplicaSetSpec is the specification of a ReplicaSet.
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * ReplicaSetSpec is the specification of a ReplicaSet.
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * ReplicaSetSpec is the specification of a ReplicaSet.
+     */
     @JsonProperty("template")
     public PodTemplateSpec getTemplate() {
         return template;
     }
 
+    /**
+     * ReplicaSetSpec is the specification of a ReplicaSet.
+     */
     @JsonProperty("template")
     public void setTemplate(PodTemplateSpec template) {
         this.template = template;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/ReplicaSetStatus.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/ReplicaSetStatus.java
index 449ade913cc..9030fe377ca 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/ReplicaSetStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/ReplicaSetStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ReplicaSetStatus represents the current status of a ReplicaSet.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,62 +104,98 @@ public ReplicaSetStatus(Integer availableReplicas, List<ReplicaSetCondition> con
         this.replicas = replicas;
     }
 
+    /**
+     * The number of available replicas (ready for at least minReadySeconds) for this replica set.
+     */
     @JsonProperty("availableReplicas")
     public Integer getAvailableReplicas() {
         return availableReplicas;
     }
 
+    /**
+     * The number of available replicas (ready for at least minReadySeconds) for this replica set.
+     */
     @JsonProperty("availableReplicas")
     public void setAvailableReplicas(Integer availableReplicas) {
         this.availableReplicas = availableReplicas;
     }
 
+    /**
+     * Represents the latest available observations of a replica set's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ReplicaSetCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Represents the latest available observations of a replica set's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ReplicaSetCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * The number of pods that have labels matching the labels of the pod template of the replicaset.
+     */
     @JsonProperty("fullyLabeledReplicas")
     public Integer getFullyLabeledReplicas() {
         return fullyLabeledReplicas;
     }
 
+    /**
+     * The number of pods that have labels matching the labels of the pod template of the replicaset.
+     */
     @JsonProperty("fullyLabeledReplicas")
     public void setFullyLabeledReplicas(Integer fullyLabeledReplicas) {
         this.fullyLabeledReplicas = fullyLabeledReplicas;
     }
 
+    /**
+     * ObservedGeneration reflects the generation of the most recently observed ReplicaSet.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration reflects the generation of the most recently observed ReplicaSet.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * The number of ready replicas for this replica set.
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * The number of ready replicas for this replica set.
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * Replicas is the most recently oberved number of replicas. More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller/#what-is-a-replicationcontroller
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Replicas is the most recently oberved number of replicas. More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller/#what-is-a-replicationcontroller
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/RollbackConfig.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/RollbackConfig.java
index 0d4a1dee5b1..cd1ffc8f14d 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/RollbackConfig.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/RollbackConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DEPRECATED.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public RollbackConfig(Long revision) {
         this.revision = revision;
     }
 
+    /**
+     * The revision to rollback to. If set to 0, rollback to the last revision.
+     */
     @JsonProperty("revision")
     public Long getRevision() {
         return revision;
     }
 
+    /**
+     * The revision to rollback to. If set to 0, rollback to the last revision.
+     */
     @JsonProperty("revision")
     public void setRevision(Long revision) {
         this.revision = revision;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/RollingUpdateDaemonSet.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/RollingUpdateDaemonSet.java
index d6d9456cb1b..5e289d36647 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/RollingUpdateDaemonSet.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/RollingUpdateDaemonSet.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Spec to control the desired behavior of daemon set rolling update.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public RollingUpdateDaemonSet(IntOrString maxUnavailable) {
         this.maxUnavailable = maxUnavailable;
     }
 
+    /**
+     * Spec to control the desired behavior of daemon set rolling update.
+     */
     @JsonProperty("maxUnavailable")
     public IntOrString getMaxUnavailable() {
         return maxUnavailable;
     }
 
+    /**
+     * Spec to control the desired behavior of daemon set rolling update.
+     */
     @JsonProperty("maxUnavailable")
     public void setMaxUnavailable(IntOrString maxUnavailable) {
         this.maxUnavailable = maxUnavailable;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/RollingUpdateDeployment.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/RollingUpdateDeployment.java
index 1018d400b63..98956335c34 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/RollingUpdateDeployment.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/RollingUpdateDeployment.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Spec to control the desired behavior of rolling update.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public RollingUpdateDeployment(IntOrString maxSurge, IntOrString maxUnavailable)
         this.maxUnavailable = maxUnavailable;
     }
 
+    /**
+     * Spec to control the desired behavior of rolling update.
+     */
     @JsonProperty("maxSurge")
     public IntOrString getMaxSurge() {
         return maxSurge;
     }
 
+    /**
+     * Spec to control the desired behavior of rolling update.
+     */
     @JsonProperty("maxSurge")
     public void setMaxSurge(IntOrString maxSurge) {
         this.maxSurge = maxSurge;
     }
 
+    /**
+     * Spec to control the desired behavior of rolling update.
+     */
     @JsonProperty("maxUnavailable")
     public IntOrString getMaxUnavailable() {
         return maxUnavailable;
     }
 
+    /**
+     * Spec to control the desired behavior of rolling update.
+     */
     @JsonProperty("maxUnavailable")
     public void setMaxUnavailable(IntOrString maxUnavailable) {
         this.maxUnavailable = maxUnavailable;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/RunAsGroupStrategyOptions.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/RunAsGroupStrategyOptions.java
index d0df5977d64..d6c564ddda7 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/RunAsGroupStrategyOptions.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/RunAsGroupStrategyOptions.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RunAsGroupStrategyOptions defines the strategy type and any options used to create the strategy. Deprecated: use RunAsGroupStrategyOptions from policy API Group instead.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public RunAsGroupStrategyOptions(List<IDRange> ranges, String rule) {
         this.rule = rule;
     }
 
+    /**
+     * ranges are the allowed ranges of gids that may be used. If you would like to force a single gid then supply a single range with the same start and end. Required for MustRunAs.
+     */
     @JsonProperty("ranges")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IDRange> getRanges() {
         return ranges;
     }
 
+    /**
+     * ranges are the allowed ranges of gids that may be used. If you would like to force a single gid then supply a single range with the same start and end. Required for MustRunAs.
+     */
     @JsonProperty("ranges")
     public void setRanges(List<IDRange> ranges) {
         this.ranges = ranges;
     }
 
+    /**
+     * rule is the strategy that will dictate the allowable RunAsGroup values that may be set.
+     */
     @JsonProperty("rule")
     public String getRule() {
         return rule;
     }
 
+    /**
+     * rule is the strategy that will dictate the allowable RunAsGroup values that may be set.
+     */
     @JsonProperty("rule")
     public void setRule(String rule) {
         this.rule = rule;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/RunAsUserStrategyOptions.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/RunAsUserStrategyOptions.java
index 24b572b39d8..0c8802d084f 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/RunAsUserStrategyOptions.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/RunAsUserStrategyOptions.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RunAsUserStrategyOptions defines the strategy type and any options used to create the strategy. Deprecated: use RunAsUserStrategyOptions from policy API Group instead.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public RunAsUserStrategyOptions(List<IDRange> ranges, String rule) {
         this.rule = rule;
     }
 
+    /**
+     * ranges are the allowed ranges of uids that may be used. If you would like to force a single uid then supply a single range with the same start and end. Required for MustRunAs.
+     */
     @JsonProperty("ranges")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IDRange> getRanges() {
         return ranges;
     }
 
+    /**
+     * ranges are the allowed ranges of uids that may be used. If you would like to force a single uid then supply a single range with the same start and end. Required for MustRunAs.
+     */
     @JsonProperty("ranges")
     public void setRanges(List<IDRange> ranges) {
         this.ranges = ranges;
     }
 
+    /**
+     * rule is the strategy that will dictate the allowable RunAsUser values that may be set.
+     */
     @JsonProperty("rule")
     public String getRule() {
         return rule;
     }
 
+    /**
+     * rule is the strategy that will dictate the allowable RunAsUser values that may be set.
+     */
     @JsonProperty("rule")
     public void setRule(String rule) {
         this.rule = rule;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/RuntimeClassStrategyOptions.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/RuntimeClassStrategyOptions.java
index 4093535b6b7..74ac4c4ec6c 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/RuntimeClassStrategyOptions.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/RuntimeClassStrategyOptions.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RuntimeClassStrategyOptions define the strategy that will dictate the allowable RuntimeClasses for a pod.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public RuntimeClassStrategyOptions(List<String> allowedRuntimeClassNames, String
         this.defaultRuntimeClassName = defaultRuntimeClassName;
     }
 
+    /**
+     * allowedRuntimeClassNames is a whitelist of RuntimeClass names that may be specified on a pod. A value of "&#42;" means that any RuntimeClass name is allowed, and must be the only item in the list. An empty list requires the RuntimeClassName field to be unset.
+     */
     @JsonProperty("allowedRuntimeClassNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAllowedRuntimeClassNames() {
         return allowedRuntimeClassNames;
     }
 
+    /**
+     * allowedRuntimeClassNames is a whitelist of RuntimeClass names that may be specified on a pod. A value of "&#42;" means that any RuntimeClass name is allowed, and must be the only item in the list. An empty list requires the RuntimeClassName field to be unset.
+     */
     @JsonProperty("allowedRuntimeClassNames")
     public void setAllowedRuntimeClassNames(List<String> allowedRuntimeClassNames) {
         this.allowedRuntimeClassNames = allowedRuntimeClassNames;
     }
 
+    /**
+     * defaultRuntimeClassName is the default RuntimeClassName to set on the pod. The default MUST be allowed by the allowedRuntimeClassNames list. A value of nil does not mutate the Pod.
+     */
     @JsonProperty("defaultRuntimeClassName")
     public String getDefaultRuntimeClassName() {
         return defaultRuntimeClassName;
     }
 
+    /**
+     * defaultRuntimeClassName is the default RuntimeClassName to set on the pod. The default MUST be allowed by the allowedRuntimeClassNames list. A value of nil does not mutate the Pod.
+     */
     @JsonProperty("defaultRuntimeClassName")
     public void setDefaultRuntimeClassName(String defaultRuntimeClassName) {
         this.defaultRuntimeClassName = defaultRuntimeClassName;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/SELinuxStrategyOptions.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/SELinuxStrategyOptions.java
index e2c8e57c000..47552857920 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/SELinuxStrategyOptions.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/SELinuxStrategyOptions.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SELinuxStrategyOptions defines the strategy type and any options used to create the strategy. Deprecated: use SELinuxStrategyOptions from policy API Group instead.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public SELinuxStrategyOptions(String rule, SELinuxOptions seLinuxOptions) {
         this.seLinuxOptions = seLinuxOptions;
     }
 
+    /**
+     * rule is the strategy that will dictate the allowable labels that may be set.
+     */
     @JsonProperty("rule")
     public String getRule() {
         return rule;
     }
 
+    /**
+     * rule is the strategy that will dictate the allowable labels that may be set.
+     */
     @JsonProperty("rule")
     public void setRule(String rule) {
         this.rule = rule;
     }
 
+    /**
+     * SELinuxStrategyOptions defines the strategy type and any options used to create the strategy. Deprecated: use SELinuxStrategyOptions from policy API Group instead.
+     */
     @JsonProperty("seLinuxOptions")
     public SELinuxOptions getSeLinuxOptions() {
         return seLinuxOptions;
     }
 
+    /**
+     * SELinuxStrategyOptions defines the strategy type and any options used to create the strategy. Deprecated: use SELinuxStrategyOptions from policy API Group instead.
+     */
     @JsonProperty("seLinuxOptions")
     public void setSeLinuxOptions(SELinuxOptions seLinuxOptions) {
         this.seLinuxOptions = seLinuxOptions;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/Scale.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/Scale.java
index 33c192421b8..8f60f2566e8 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/Scale.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/Scale.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * represents a scaling request for a resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Scale implements Editable<ScaleBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "extensions/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Scale";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Scale(String apiVersion, String kind, ObjectMeta metadata, ScaleSpec spec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * represents a scaling request for a resource.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * represents a scaling request for a resource.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * represents a scaling request for a resource.
+     */
     @JsonProperty("spec")
     public ScaleSpec getSpec() {
         return spec;
     }
 
+    /**
+     * represents a scaling request for a resource.
+     */
     @JsonProperty("spec")
     public void setSpec(ScaleSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * represents a scaling request for a resource.
+     */
     @JsonProperty("status")
     public ScaleStatus getStatus() {
         return status;
     }
 
+    /**
+     * represents a scaling request for a resource.
+     */
     @JsonProperty("status")
     public void setStatus(ScaleStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/ScaleSpec.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/ScaleSpec.java
index c5d0ed04182..ec5e03f812a 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/ScaleSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/ScaleSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * describes the attributes of a scale subresource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ScaleSpec(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * desired number of instances for the scaled object.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * desired number of instances for the scaled object.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/ScaleStatus.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/ScaleStatus.java
index a975d00a193..d788b8f9fd5 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/ScaleStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/ScaleStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * represents the current status of a scale subresource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,32 +90,50 @@ public ScaleStatus(Integer replicas, Map<String, String> selector, String target
         this.targetSelector = targetSelector;
     }
 
+    /**
+     * actual number of observed instances of the scaled object.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * actual number of observed instances of the scaled object.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * label query over pods that should match the replicas count. More info: http://kubernetes.io/docs/user-guide/labels#label-selectors
+     */
     @JsonProperty("selector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getSelector() {
         return selector;
     }
 
+    /**
+     * label query over pods that should match the replicas count. More info: http://kubernetes.io/docs/user-guide/labels#label-selectors
+     */
     @JsonProperty("selector")
     public void setSelector(Map<String, String> selector) {
         this.selector = selector;
     }
 
+    /**
+     * label selector for pods that should match the replicas count. This is a serializated version of both map-based and more expressive set-based selectors. This is done to avoid introspection in the clients. The string will be in the same format as the query-param syntax. If the target type only supports map-based selectors, both this field and map-based selector field are populated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors
+     */
     @JsonProperty("targetSelector")
     public String getTargetSelector() {
         return targetSelector;
     }
 
+    /**
+     * label selector for pods that should match the replicas count. This is a serializated version of both map-based and more expressive set-based selectors. This is done to avoid introspection in the clients. The string will be in the same format as the query-param syntax. If the target type only supports map-based selectors, both this field and map-based selector field are populated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors
+     */
     @JsonProperty("targetSelector")
     public void setTargetSelector(String targetSelector) {
         this.targetSelector = targetSelector;
diff --git a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/SupplementalGroupsStrategyOptions.java b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/SupplementalGroupsStrategyOptions.java
index 471b0dfb9cc..c164c569277 100644
--- a/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/SupplementalGroupsStrategyOptions.java
+++ b/kubernetes-model-generator/kubernetes-model-extensions/src/generated/java/io/fabric8/kubernetes/api/model/extensions/SupplementalGroupsStrategyOptions.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SupplementalGroupsStrategyOptions defines the strategy type and options used to create the strategy. Deprecated: use SupplementalGroupsStrategyOptions from policy API Group instead.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public SupplementalGroupsStrategyOptions(List<IDRange> ranges, String rule) {
         this.rule = rule;
     }
 
+    /**
+     * ranges are the allowed ranges of supplemental groups.  If you would like to force a single supplemental group then supply a single range with the same start and end. Required for MustRunAs.
+     */
     @JsonProperty("ranges")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IDRange> getRanges() {
         return ranges;
     }
 
+    /**
+     * ranges are the allowed ranges of supplemental groups.  If you would like to force a single supplemental group then supply a single range with the same start and end. Required for MustRunAs.
+     */
     @JsonProperty("ranges")
     public void setRanges(List<IDRange> ranges) {
         this.ranges = ranges;
     }
 
+    /**
+     * rule is the strategy that will dictate what supplemental groups is used in the SecurityContext.
+     */
     @JsonProperty("rule")
     public String getRule() {
         return rule;
     }
 
+    /**
+     * rule is the strategy that will dictate what supplemental groups is used in the SecurityContext.
+     */
     @JsonProperty("rule")
     public void setRule(String rule) {
         this.rule = rule;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/ExemptPriorityLevelConfiguration.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/ExemptPriorityLevelConfiguration.java
index 517f641b466..4837eadc834 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/ExemptPriorityLevelConfiguration.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/ExemptPriorityLevelConfiguration.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ExemptPriorityLevelConfiguration describes the configurable aspects of the handling of exempt requests. In the mandatory exempt configuration object the values in the fields here can be modified by authorized users, unlike the rest of the `spec`.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ExemptPriorityLevelConfiguration(Integer lendablePercent, Integer nominal
         this.nominalConcurrencyShares = nominalConcurrencyShares;
     }
 
+    /**
+     * `lendablePercent` prescribes the fraction of the level's NominalCL that can be borrowed by other priority levels.  This value of this field must be between 0 and 100, inclusive, and it defaults to 0. The number of seats that other levels can borrow from this level, known as this level's LendableConcurrencyLimit (LendableCL), is defined as follows.<br><p> <br><p> LendableCL(i) = round( NominalCL(i) &#42; lendablePercent(i)/100.0 )
+     */
     @JsonProperty("lendablePercent")
     public Integer getLendablePercent() {
         return lendablePercent;
     }
 
+    /**
+     * `lendablePercent` prescribes the fraction of the level's NominalCL that can be borrowed by other priority levels.  This value of this field must be between 0 and 100, inclusive, and it defaults to 0. The number of seats that other levels can borrow from this level, known as this level's LendableConcurrencyLimit (LendableCL), is defined as follows.<br><p> <br><p> LendableCL(i) = round( NominalCL(i) &#42; lendablePercent(i)/100.0 )
+     */
     @JsonProperty("lendablePercent")
     public void setLendablePercent(Integer lendablePercent) {
         this.lendablePercent = lendablePercent;
     }
 
+    /**
+     * `nominalConcurrencyShares` (NCS) contributes to the computation of the NominalConcurrencyLimit (NominalCL) of this level. This is the number of execution seats nominally reserved for this priority level. This DOES NOT limit the dispatching from this priority level but affects the other priority levels through the borrowing mechanism. The server's concurrency limit (ServerCL) is divided among all the priority levels in proportion to their NCS values:<br><p> <br><p> NominalCL(i)  = ceil( ServerCL &#42; NCS(i) / sum_ncs ) sum_ncs = sum[priority level k] NCS(k)<br><p> <br><p> Bigger numbers mean a larger nominal concurrency limit, at the expense of every other priority level. This field has a default value of zero.
+     */
     @JsonProperty("nominalConcurrencyShares")
     public Integer getNominalConcurrencyShares() {
         return nominalConcurrencyShares;
     }
 
+    /**
+     * `nominalConcurrencyShares` (NCS) contributes to the computation of the NominalConcurrencyLimit (NominalCL) of this level. This is the number of execution seats nominally reserved for this priority level. This DOES NOT limit the dispatching from this priority level but affects the other priority levels through the borrowing mechanism. The server's concurrency limit (ServerCL) is divided among all the priority levels in proportion to their NCS values:<br><p> <br><p> NominalCL(i)  = ceil( ServerCL &#42; NCS(i) / sum_ncs ) sum_ncs = sum[priority level k] NCS(k)<br><p> <br><p> Bigger numbers mean a larger nominal concurrency limit, at the expense of every other priority level. This field has a default value of zero.
+     */
     @JsonProperty("nominalConcurrencyShares")
     public void setNominalConcurrencyShares(Integer nominalConcurrencyShares) {
         this.nominalConcurrencyShares = nominalConcurrencyShares;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/FlowDistinguisherMethod.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/FlowDistinguisherMethod.java
index b2015dfbc3f..4393806ca33 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/FlowDistinguisherMethod.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/FlowDistinguisherMethod.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FlowDistinguisherMethod specifies the method of a flow distinguisher.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public FlowDistinguisherMethod(String type) {
         this.type = type;
     }
 
+    /**
+     * `type` is the type of flow distinguisher method The supported types are "ByUser" and "ByNamespace". Required.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * `type` is the type of flow distinguisher method The supported types are "ByUser" and "ByNamespace". Required.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/FlowSchema.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/FlowSchema.java
index 72bbf818bab..ffd4dc41603 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/FlowSchema.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/FlowSchema.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class FlowSchema implements Editable<FlowSchemaBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "flowcontrol.apiserver.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "FlowSchema";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public FlowSchema(String apiVersion, String kind, ObjectMeta metadata, FlowSchem
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".
+     */
     @JsonProperty("spec")
     public FlowSchemaSpec getSpec() {
         return spec;
     }
 
+    /**
+     * FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".
+     */
     @JsonProperty("spec")
     public void setSpec(FlowSchemaSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".
+     */
     @JsonProperty("status")
     public FlowSchemaStatus getStatus() {
         return status;
     }
 
+    /**
+     * FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".
+     */
     @JsonProperty("status")
     public void setStatus(FlowSchemaStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/FlowSchemaCondition.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/FlowSchemaCondition.java
index 911ac7eafb0..d06485a28a3 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/FlowSchemaCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/FlowSchemaCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FlowSchemaCondition describes conditions for a FlowSchema.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public FlowSchemaCondition(String lastTransitionTime, String message, String rea
         this.type = type;
     }
 
+    /**
+     * FlowSchemaCondition describes conditions for a FlowSchema.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * FlowSchemaCondition describes conditions for a FlowSchema.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * `message` is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * `message` is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * `reason` is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * `reason` is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * `status` is the status of the condition. Can be True, False, Unknown. Required.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * `status` is the status of the condition. Can be True, False, Unknown. Required.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * `type` is the type of the condition. Required.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * `type` is the type of the condition. Required.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/FlowSchemaList.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/FlowSchemaList.java
index edcfe055149..e1bfd1c81ff 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/FlowSchemaList.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/FlowSchemaList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FlowSchemaList is a list of FlowSchema objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class FlowSchemaList implements Editable<FlowSchemaListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.flowcontrol.v1.FlowSchema>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "flowcontrol.apiserver.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.flowcontrol.v1.FlowSchema> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "FlowSchemaList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public FlowSchemaList(String apiVersion, List<io.fabric8.kubernetes.api.model.fl
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * `items` is a list of FlowSchemas.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.flowcontrol.v1.FlowSchema> getItems() {
         return items;
     }
 
+    /**
+     * `items` is a list of FlowSchemas.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.flowcontrol.v1.FlowSchema> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * FlowSchemaList is a list of FlowSchema objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * FlowSchemaList is a list of FlowSchema objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/FlowSchemaSpec.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/FlowSchemaSpec.java
index 43e6c9ca100..b68cb70956a 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/FlowSchemaSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/FlowSchemaSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FlowSchemaSpec describes how the FlowSchema's specification looks like.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public FlowSchemaSpec(FlowDistinguisherMethod distinguisherMethod, Integer match
         this.rules = rules;
     }
 
+    /**
+     * FlowSchemaSpec describes how the FlowSchema's specification looks like.
+     */
     @JsonProperty("distinguisherMethod")
     public FlowDistinguisherMethod getDistinguisherMethod() {
         return distinguisherMethod;
     }
 
+    /**
+     * FlowSchemaSpec describes how the FlowSchema's specification looks like.
+     */
     @JsonProperty("distinguisherMethod")
     public void setDistinguisherMethod(FlowDistinguisherMethod distinguisherMethod) {
         this.distinguisherMethod = distinguisherMethod;
     }
 
+    /**
+     * `matchingPrecedence` is used to choose among the FlowSchemas that match a given request. The chosen FlowSchema is among those with the numerically lowest (which we take to be logically highest) MatchingPrecedence.  Each MatchingPrecedence value must be ranged in [1,10000]. Note that if the precedence is not specified, it will be set to 1000 as default.
+     */
     @JsonProperty("matchingPrecedence")
     public Integer getMatchingPrecedence() {
         return matchingPrecedence;
     }
 
+    /**
+     * `matchingPrecedence` is used to choose among the FlowSchemas that match a given request. The chosen FlowSchema is among those with the numerically lowest (which we take to be logically highest) MatchingPrecedence.  Each MatchingPrecedence value must be ranged in [1,10000]. Note that if the precedence is not specified, it will be set to 1000 as default.
+     */
     @JsonProperty("matchingPrecedence")
     public void setMatchingPrecedence(Integer matchingPrecedence) {
         this.matchingPrecedence = matchingPrecedence;
     }
 
+    /**
+     * FlowSchemaSpec describes how the FlowSchema's specification looks like.
+     */
     @JsonProperty("priorityLevelConfiguration")
     public PriorityLevelConfigurationReference getPriorityLevelConfiguration() {
         return priorityLevelConfiguration;
     }
 
+    /**
+     * FlowSchemaSpec describes how the FlowSchema's specification looks like.
+     */
     @JsonProperty("priorityLevelConfiguration")
     public void setPriorityLevelConfiguration(PriorityLevelConfigurationReference priorityLevelConfiguration) {
         this.priorityLevelConfiguration = priorityLevelConfiguration;
     }
 
+    /**
+     * `rules` describes which requests will match this flow schema. This FlowSchema matches a request if and only if at least one member of rules matches the request. if it is an empty slice, there will be no requests matching the FlowSchema.
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PolicyRulesWithSubjects> getRules() {
         return rules;
     }
 
+    /**
+     * `rules` describes which requests will match this flow schema. This FlowSchema matches a request if and only if at least one member of rules matches the request. if it is an empty slice, there will be no requests matching the FlowSchema.
+     */
     @JsonProperty("rules")
     public void setRules(List<PolicyRulesWithSubjects> rules) {
         this.rules = rules;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/FlowSchemaStatus.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/FlowSchemaStatus.java
index a624534fb61..cae3653dd91 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/FlowSchemaStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/FlowSchemaStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FlowSchemaStatus represents the current state of a FlowSchema.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public FlowSchemaStatus(List<FlowSchemaCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * `conditions` is a list of the current states of FlowSchema.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<FlowSchemaCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * `conditions` is a list of the current states of FlowSchema.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<FlowSchemaCondition> conditions) {
         this.conditions = conditions;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/GroupSubject.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/GroupSubject.java
index 1e495b02eeb..57ecaa9578f 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/GroupSubject.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/GroupSubject.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GroupSubject holds detailed information for group-kind subject.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public GroupSubject(String name) {
         this.name = name;
     }
 
+    /**
+     * name is the user group that matches, or "&#42;" to match all user groups. See https://github.com/kubernetes/apiserver/blob/master/pkg/authentication/user/user.go for some well-known group names. Required.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the user group that matches, or "&#42;" to match all user groups. See https://github.com/kubernetes/apiserver/blob/master/pkg/authentication/user/user.go for some well-known group names. Required.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/LimitResponse.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/LimitResponse.java
index 5522ad852b0..40a8485d704 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/LimitResponse.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/LimitResponse.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LimitResponse defines how to handle requests that can not be executed right now.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public LimitResponse(QueuingConfiguration queuing, String type) {
         this.type = type;
     }
 
+    /**
+     * LimitResponse defines how to handle requests that can not be executed right now.
+     */
     @JsonProperty("queuing")
     public QueuingConfiguration getQueuing() {
         return queuing;
     }
 
+    /**
+     * LimitResponse defines how to handle requests that can not be executed right now.
+     */
     @JsonProperty("queuing")
     public void setQueuing(QueuingConfiguration queuing) {
         this.queuing = queuing;
     }
 
+    /**
+     * `type` is "Queue" or "Reject". "Queue" means that requests that can not be executed upon arrival are held in a queue until they can be executed or a queuing limit is reached. "Reject" means that requests that can not be executed upon arrival are rejected. Required.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * `type` is "Queue" or "Reject". "Queue" means that requests that can not be executed upon arrival are held in a queue until they can be executed or a queuing limit is reached. "Reject" means that requests that can not be executed upon arrival are rejected. Required.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/LimitedPriorityLevelConfiguration.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/LimitedPriorityLevelConfiguration.java
index 0e793c35f2e..a77638dae5b 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/LimitedPriorityLevelConfiguration.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/LimitedPriorityLevelConfiguration.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LimitedPriorityLevelConfiguration specifies how to handle requests that are subject to limits. It addresses two issues:<br><p>   - How are requests for this priority level limited?<br><p>   - What should be done with requests that exceed the limit?
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public LimitedPriorityLevelConfiguration(Integer borrowingLimitPercent, Integer
         this.nominalConcurrencyShares = nominalConcurrencyShares;
     }
 
+    /**
+     * `borrowingLimitPercent`, if present, configures a limit on how many seats this priority level can borrow from other priority levels. The limit is known as this level's BorrowingConcurrencyLimit (BorrowingCL) and is a limit on the total number of seats that this level may borrow at any one time. This field holds the ratio of that limit to the level's nominal concurrency limit. When this field is non-nil, it must hold a non-negative integer and the limit is calculated as follows.<br><p> <br><p> BorrowingCL(i) = round( NominalCL(i) &#42; borrowingLimitPercent(i)/100.0 )<br><p> <br><p> The value of this field can be more than 100, implying that this priority level can borrow a number of seats that is greater than its own nominal concurrency limit (NominalCL). When this field is left `nil`, the limit is effectively infinite.
+     */
     @JsonProperty("borrowingLimitPercent")
     public Integer getBorrowingLimitPercent() {
         return borrowingLimitPercent;
     }
 
+    /**
+     * `borrowingLimitPercent`, if present, configures a limit on how many seats this priority level can borrow from other priority levels. The limit is known as this level's BorrowingConcurrencyLimit (BorrowingCL) and is a limit on the total number of seats that this level may borrow at any one time. This field holds the ratio of that limit to the level's nominal concurrency limit. When this field is non-nil, it must hold a non-negative integer and the limit is calculated as follows.<br><p> <br><p> BorrowingCL(i) = round( NominalCL(i) &#42; borrowingLimitPercent(i)/100.0 )<br><p> <br><p> The value of this field can be more than 100, implying that this priority level can borrow a number of seats that is greater than its own nominal concurrency limit (NominalCL). When this field is left `nil`, the limit is effectively infinite.
+     */
     @JsonProperty("borrowingLimitPercent")
     public void setBorrowingLimitPercent(Integer borrowingLimitPercent) {
         this.borrowingLimitPercent = borrowingLimitPercent;
     }
 
+    /**
+     * `lendablePercent` prescribes the fraction of the level's NominalCL that can be borrowed by other priority levels. The value of this field must be between 0 and 100, inclusive, and it defaults to 0. The number of seats that other levels can borrow from this level, known as this level's LendableConcurrencyLimit (LendableCL), is defined as follows.<br><p> <br><p> LendableCL(i) = round( NominalCL(i) &#42; lendablePercent(i)/100.0 )
+     */
     @JsonProperty("lendablePercent")
     public Integer getLendablePercent() {
         return lendablePercent;
     }
 
+    /**
+     * `lendablePercent` prescribes the fraction of the level's NominalCL that can be borrowed by other priority levels. The value of this field must be between 0 and 100, inclusive, and it defaults to 0. The number of seats that other levels can borrow from this level, known as this level's LendableConcurrencyLimit (LendableCL), is defined as follows.<br><p> <br><p> LendableCL(i) = round( NominalCL(i) &#42; lendablePercent(i)/100.0 )
+     */
     @JsonProperty("lendablePercent")
     public void setLendablePercent(Integer lendablePercent) {
         this.lendablePercent = lendablePercent;
     }
 
+    /**
+     * LimitedPriorityLevelConfiguration specifies how to handle requests that are subject to limits. It addresses two issues:<br><p>   - How are requests for this priority level limited?<br><p>   - What should be done with requests that exceed the limit?
+     */
     @JsonProperty("limitResponse")
     public LimitResponse getLimitResponse() {
         return limitResponse;
     }
 
+    /**
+     * LimitedPriorityLevelConfiguration specifies how to handle requests that are subject to limits. It addresses two issues:<br><p>   - How are requests for this priority level limited?<br><p>   - What should be done with requests that exceed the limit?
+     */
     @JsonProperty("limitResponse")
     public void setLimitResponse(LimitResponse limitResponse) {
         this.limitResponse = limitResponse;
     }
 
+    /**
+     * `nominalConcurrencyShares` (NCS) contributes to the computation of the NominalConcurrencyLimit (NominalCL) of this level. This is the number of execution seats available at this priority level. This is used both for requests dispatched from this priority level as well as requests dispatched from other priority levels borrowing seats from this level. The server's concurrency limit (ServerCL) is divided among the Limited priority levels in proportion to their NCS values:<br><p> <br><p> NominalCL(i)  = ceil( ServerCL &#42; NCS(i) / sum_ncs ) sum_ncs = sum[priority level k] NCS(k)<br><p> <br><p> Bigger numbers mean a larger nominal concurrency limit, at the expense of every other priority level.<br><p> <br><p> If not specified, this field defaults to a value of 30.<br><p> <br><p> Setting this field to zero supports the construction of a "jail" for this priority level that is used to hold some request(s)
+     */
     @JsonProperty("nominalConcurrencyShares")
     public Integer getNominalConcurrencyShares() {
         return nominalConcurrencyShares;
     }
 
+    /**
+     * `nominalConcurrencyShares` (NCS) contributes to the computation of the NominalConcurrencyLimit (NominalCL) of this level. This is the number of execution seats available at this priority level. This is used both for requests dispatched from this priority level as well as requests dispatched from other priority levels borrowing seats from this level. The server's concurrency limit (ServerCL) is divided among the Limited priority levels in proportion to their NCS values:<br><p> <br><p> NominalCL(i)  = ceil( ServerCL &#42; NCS(i) / sum_ncs ) sum_ncs = sum[priority level k] NCS(k)<br><p> <br><p> Bigger numbers mean a larger nominal concurrency limit, at the expense of every other priority level.<br><p> <br><p> If not specified, this field defaults to a value of 30.<br><p> <br><p> Setting this field to zero supports the construction of a "jail" for this priority level that is used to hold some request(s)
+     */
     @JsonProperty("nominalConcurrencyShares")
     public void setNominalConcurrencyShares(Integer nominalConcurrencyShares) {
         this.nominalConcurrencyShares = nominalConcurrencyShares;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/NonResourcePolicyRule.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/NonResourcePolicyRule.java
index a617b623ab4..9288877557e 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/NonResourcePolicyRule.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/NonResourcePolicyRule.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NonResourcePolicyRule is a predicate that matches non-resource requests according to their verb and the target non-resource URL. A NonResourcePolicyRule matches a request if and only if both (a) at least one member of verbs matches the request and (b) at least one member of nonResourceURLs matches the request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public NonResourcePolicyRule(List<String> nonResourceURLs, List<String> verbs) {
         this.verbs = verbs;
     }
 
+    /**
+     * `nonResourceURLs` is a set of url prefixes that a user should have access to and may not be empty. For example:<br><p>   - "/healthz" is legal<br><p>   - "/hea&#42;" is illegal<br><p>   - "/hea" is legal but matches nothing<br><p>   - "/hea/&#42;" also matches nothing<br><p>   - "/healthz/&#42;" matches all per-component health checks.<br><p> "&#42;" matches all non-resource urls. if it is present, it must be the only entry. Required.
+     */
     @JsonProperty("nonResourceURLs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNonResourceURLs() {
         return nonResourceURLs;
     }
 
+    /**
+     * `nonResourceURLs` is a set of url prefixes that a user should have access to and may not be empty. For example:<br><p>   - "/healthz" is legal<br><p>   - "/hea&#42;" is illegal<br><p>   - "/hea" is legal but matches nothing<br><p>   - "/hea/&#42;" also matches nothing<br><p>   - "/healthz/&#42;" matches all per-component health checks.<br><p> "&#42;" matches all non-resource urls. if it is present, it must be the only entry. Required.
+     */
     @JsonProperty("nonResourceURLs")
     public void setNonResourceURLs(List<String> nonResourceURLs) {
         this.nonResourceURLs = nonResourceURLs;
     }
 
+    /**
+     * `verbs` is a list of matching verbs and may not be empty. "&#42;" matches all verbs. If it is present, it must be the only entry. Required.
+     */
     @JsonProperty("verbs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getVerbs() {
         return verbs;
     }
 
+    /**
+     * `verbs` is a list of matching verbs and may not be empty. "&#42;" matches all verbs. If it is present, it must be the only entry. Required.
+     */
     @JsonProperty("verbs")
     public void setVerbs(List<String> verbs) {
         this.verbs = verbs;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/PolicyRulesWithSubjects.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/PolicyRulesWithSubjects.java
index 686a122d216..da36cdebdfe 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/PolicyRulesWithSubjects.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/PolicyRulesWithSubjects.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PolicyRulesWithSubjects prescribes a test that applies to a request to an apiserver. The test considers the subject making the request, the verb being requested, and the resource to be acted upon. This PolicyRulesWithSubjects matches a request if and only if both (a) at least one member of subjects matches the request and (b) at least one member of resourceRules or nonResourceRules matches the request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,34 +94,52 @@ public PolicyRulesWithSubjects(List<NonResourcePolicyRule> nonResourceRules, Lis
         this.subjects = subjects;
     }
 
+    /**
+     * `nonResourceRules` is a list of NonResourcePolicyRules that identify matching requests according to their verb and the target non-resource URL.
+     */
     @JsonProperty("nonResourceRules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NonResourcePolicyRule> getNonResourceRules() {
         return nonResourceRules;
     }
 
+    /**
+     * `nonResourceRules` is a list of NonResourcePolicyRules that identify matching requests according to their verb and the target non-resource URL.
+     */
     @JsonProperty("nonResourceRules")
     public void setNonResourceRules(List<NonResourcePolicyRule> nonResourceRules) {
         this.nonResourceRules = nonResourceRules;
     }
 
+    /**
+     * `resourceRules` is a slice of ResourcePolicyRules that identify matching requests according to their verb and the target resource. At least one of `resourceRules` and `nonResourceRules` has to be non-empty.
+     */
     @JsonProperty("resourceRules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ResourcePolicyRule> getResourceRules() {
         return resourceRules;
     }
 
+    /**
+     * `resourceRules` is a slice of ResourcePolicyRules that identify matching requests according to their verb and the target resource. At least one of `resourceRules` and `nonResourceRules` has to be non-empty.
+     */
     @JsonProperty("resourceRules")
     public void setResourceRules(List<ResourcePolicyRule> resourceRules) {
         this.resourceRules = resourceRules;
     }
 
+    /**
+     * subjects is the list of normal user, serviceaccount, or group that this rule cares about. There must be at least one member in this slice. A slice that includes both the system:authenticated and system:unauthenticated user groups matches every request. Required.
+     */
     @JsonProperty("subjects")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Subject> getSubjects() {
         return subjects;
     }
 
+    /**
+     * subjects is the list of normal user, serviceaccount, or group that this rule cares about. There must be at least one member in this slice. A slice that includes both the system:authenticated and system:unauthenticated user groups matches every request. Required.
+     */
     @JsonProperty("subjects")
     public void setSubjects(List<Subject> subjects) {
         this.subjects = subjects;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/PriorityLevelConfiguration.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/PriorityLevelConfiguration.java
index 2062f632c92..6e242a9319c 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/PriorityLevelConfiguration.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/PriorityLevelConfiguration.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PriorityLevelConfiguration represents the configuration of a priority level.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class PriorityLevelConfiguration implements Editable<PriorityLevelConfigurationBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "flowcontrol.apiserver.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PriorityLevelConfiguration";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public PriorityLevelConfiguration(String apiVersion, String kind, ObjectMeta met
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PriorityLevelConfiguration represents the configuration of a priority level.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PriorityLevelConfiguration represents the configuration of a priority level.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PriorityLevelConfiguration represents the configuration of a priority level.
+     */
     @JsonProperty("spec")
     public PriorityLevelConfigurationSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PriorityLevelConfiguration represents the configuration of a priority level.
+     */
     @JsonProperty("spec")
     public void setSpec(PriorityLevelConfigurationSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PriorityLevelConfiguration represents the configuration of a priority level.
+     */
     @JsonProperty("status")
     public PriorityLevelConfigurationStatus getStatus() {
         return status;
     }
 
+    /**
+     * PriorityLevelConfiguration represents the configuration of a priority level.
+     */
     @JsonProperty("status")
     public void setStatus(PriorityLevelConfigurationStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/PriorityLevelConfigurationCondition.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/PriorityLevelConfigurationCondition.java
index a22c20c8a06..87c89c190e5 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/PriorityLevelConfigurationCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/PriorityLevelConfigurationCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PriorityLevelConfigurationCondition defines the condition of priority level.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public PriorityLevelConfigurationCondition(String lastTransitionTime, String mes
         this.type = type;
     }
 
+    /**
+     * PriorityLevelConfigurationCondition defines the condition of priority level.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * PriorityLevelConfigurationCondition defines the condition of priority level.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * `message` is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * `message` is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * `reason` is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * `reason` is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * `status` is the status of the condition. Can be True, False, Unknown. Required.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * `status` is the status of the condition. Can be True, False, Unknown. Required.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * `type` is the type of the condition. Required.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * `type` is the type of the condition. Required.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/PriorityLevelConfigurationList.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/PriorityLevelConfigurationList.java
index 22d5fbc40f5..62bdc244f70 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/PriorityLevelConfigurationList.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/PriorityLevelConfigurationList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PriorityLevelConfigurationList is a list of PriorityLevelConfiguration objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PriorityLevelConfigurationList implements Editable<PriorityLevelConfigurationListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.flowcontrol.v1.PriorityLevelConfiguration>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "flowcontrol.apiserver.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.flowcontrol.v1.PriorityLevelConfiguration> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PriorityLevelConfigurationList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PriorityLevelConfigurationList(String apiVersion, List<io.fabric8.kuberne
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * `items` is a list of request-priorities.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.flowcontrol.v1.PriorityLevelConfiguration> getItems() {
         return items;
     }
 
+    /**
+     * `items` is a list of request-priorities.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.flowcontrol.v1.PriorityLevelConfiguration> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PriorityLevelConfigurationList is a list of PriorityLevelConfiguration objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PriorityLevelConfigurationList is a list of PriorityLevelConfiguration objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/PriorityLevelConfigurationReference.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/PriorityLevelConfigurationReference.java
index a0391be2bf0..264637dff0d 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/PriorityLevelConfigurationReference.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/PriorityLevelConfigurationReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PriorityLevelConfigurationReference contains information that points to the "request-priority" being used.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public PriorityLevelConfigurationReference(String name) {
         this.name = name;
     }
 
+    /**
+     * `name` is the name of the priority level configuration being referenced Required.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * `name` is the name of the priority level configuration being referenced Required.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/PriorityLevelConfigurationSpec.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/PriorityLevelConfigurationSpec.java
index fbd21dd8b03..b561f5ba064 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/PriorityLevelConfigurationSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/PriorityLevelConfigurationSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PriorityLevelConfigurationSpec specifies the configuration of a priority level.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public PriorityLevelConfigurationSpec(ExemptPriorityLevelConfiguration exempt, L
         this.type = type;
     }
 
+    /**
+     * PriorityLevelConfigurationSpec specifies the configuration of a priority level.
+     */
     @JsonProperty("exempt")
     public ExemptPriorityLevelConfiguration getExempt() {
         return exempt;
     }
 
+    /**
+     * PriorityLevelConfigurationSpec specifies the configuration of a priority level.
+     */
     @JsonProperty("exempt")
     public void setExempt(ExemptPriorityLevelConfiguration exempt) {
         this.exempt = exempt;
     }
 
+    /**
+     * PriorityLevelConfigurationSpec specifies the configuration of a priority level.
+     */
     @JsonProperty("limited")
     public LimitedPriorityLevelConfiguration getLimited() {
         return limited;
     }
 
+    /**
+     * PriorityLevelConfigurationSpec specifies the configuration of a priority level.
+     */
     @JsonProperty("limited")
     public void setLimited(LimitedPriorityLevelConfiguration limited) {
         this.limited = limited;
     }
 
+    /**
+     * `type` indicates whether this priority level is subject to limitation on request execution.  A value of `"Exempt"` means that requests of this priority level are not subject to a limit (and thus are never queued) and do not detract from the capacity made available to other priority levels.  A value of `"Limited"` means that (a) requests of this priority level _are_ subject to limits and (b) some of the server's limited capacity is made available exclusively to this priority level. Required.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * `type` indicates whether this priority level is subject to limitation on request execution.  A value of `"Exempt"` means that requests of this priority level are not subject to a limit (and thus are never queued) and do not detract from the capacity made available to other priority levels.  A value of `"Limited"` means that (a) requests of this priority level _are_ subject to limits and (b) some of the server's limited capacity is made available exclusively to this priority level. Required.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/PriorityLevelConfigurationStatus.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/PriorityLevelConfigurationStatus.java
index 8113bc6182e..95fe569a319 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/PriorityLevelConfigurationStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/PriorityLevelConfigurationStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PriorityLevelConfigurationStatus represents the current state of a "request-priority".
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public PriorityLevelConfigurationStatus(List<PriorityLevelConfigurationCondition
         this.conditions = conditions;
     }
 
+    /**
+     * `conditions` is the current state of "request-priority".
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PriorityLevelConfigurationCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * `conditions` is the current state of "request-priority".
+     */
     @JsonProperty("conditions")
     public void setConditions(List<PriorityLevelConfigurationCondition> conditions) {
         this.conditions = conditions;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/QueuingConfiguration.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/QueuingConfiguration.java
index e44f93c655e..5d13991e4cd 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/QueuingConfiguration.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/QueuingConfiguration.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * QueuingConfiguration holds the configuration parameters for queuing
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public QueuingConfiguration(Integer handSize, Integer queueLengthLimit, Integer
         this.queues = queues;
     }
 
+    /**
+     * `handSize` is a small positive number that configures the shuffle sharding of requests into queues.  When enqueuing a request at this priority level the request's flow identifier (a string pair) is hashed and the hash value is used to shuffle the list of queues and deal a hand of the size specified here.  The request is put into one of the shortest queues in that hand. `handSize` must be no larger than `queues`, and should be significantly smaller (so that a few heavy flows do not saturate most of the queues).  See the user-facing documentation for more extensive guidance on setting this field.  This field has a default value of 8.
+     */
     @JsonProperty("handSize")
     public Integer getHandSize() {
         return handSize;
     }
 
+    /**
+     * `handSize` is a small positive number that configures the shuffle sharding of requests into queues.  When enqueuing a request at this priority level the request's flow identifier (a string pair) is hashed and the hash value is used to shuffle the list of queues and deal a hand of the size specified here.  The request is put into one of the shortest queues in that hand. `handSize` must be no larger than `queues`, and should be significantly smaller (so that a few heavy flows do not saturate most of the queues).  See the user-facing documentation for more extensive guidance on setting this field.  This field has a default value of 8.
+     */
     @JsonProperty("handSize")
     public void setHandSize(Integer handSize) {
         this.handSize = handSize;
     }
 
+    /**
+     * `queueLengthLimit` is the maximum number of requests allowed to be waiting in a given queue of this priority level at a time; excess requests are rejected.  This value must be positive.  If not specified, it will be defaulted to 50.
+     */
     @JsonProperty("queueLengthLimit")
     public Integer getQueueLengthLimit() {
         return queueLengthLimit;
     }
 
+    /**
+     * `queueLengthLimit` is the maximum number of requests allowed to be waiting in a given queue of this priority level at a time; excess requests are rejected.  This value must be positive.  If not specified, it will be defaulted to 50.
+     */
     @JsonProperty("queueLengthLimit")
     public void setQueueLengthLimit(Integer queueLengthLimit) {
         this.queueLengthLimit = queueLengthLimit;
     }
 
+    /**
+     * `queues` is the number of queues for this priority level. The queues exist independently at each apiserver. The value must be positive.  Setting it to 1 effectively precludes shufflesharding and thus makes the distinguisher method of associated flow schemas irrelevant.  This field has a default value of 64.
+     */
     @JsonProperty("queues")
     public Integer getQueues() {
         return queues;
     }
 
+    /**
+     * `queues` is the number of queues for this priority level. The queues exist independently at each apiserver. The value must be positive.  Setting it to 1 effectively precludes shufflesharding and thus makes the distinguisher method of associated flow schemas irrelevant.  This field has a default value of 64.
+     */
     @JsonProperty("queues")
     public void setQueues(Integer queues) {
         this.queues = queues;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/ResourcePolicyRule.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/ResourcePolicyRule.java
index 298bc08f58c..eed36c6b109 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/ResourcePolicyRule.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/ResourcePolicyRule.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourcePolicyRule is a predicate that matches some resource requests, testing the request's verb and the target resource. A ResourcePolicyRule matches a resource request if and only if: (a) at least one member of verbs matches the request, (b) at least one member of apiGroups matches the request, (c) at least one member of resources matches the request, and (d) either (d1) the request does not specify a namespace (i.e., `Namespace==""`) and clusterScope is true or (d2) the request specifies a namespace and least one member of namespaces matches the request's namespace.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -100,55 +103,85 @@ public ResourcePolicyRule(List<String> apiGroups, Boolean clusterScope, List<Str
         this.verbs = verbs;
     }
 
+    /**
+     * `apiGroups` is a list of matching API groups and may not be empty. "&#42;" matches all API groups and, if present, must be the only entry. Required.
+     */
     @JsonProperty("apiGroups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiGroups() {
         return apiGroups;
     }
 
+    /**
+     * `apiGroups` is a list of matching API groups and may not be empty. "&#42;" matches all API groups and, if present, must be the only entry. Required.
+     */
     @JsonProperty("apiGroups")
     public void setApiGroups(List<String> apiGroups) {
         this.apiGroups = apiGroups;
     }
 
+    /**
+     * `clusterScope` indicates whether to match requests that do not specify a namespace (which happens either because the resource is not namespaced or the request targets all namespaces). If this field is omitted or false then the `namespaces` field must contain a non-empty list.
+     */
     @JsonProperty("clusterScope")
     public Boolean getClusterScope() {
         return clusterScope;
     }
 
+    /**
+     * `clusterScope` indicates whether to match requests that do not specify a namespace (which happens either because the resource is not namespaced or the request targets all namespaces). If this field is omitted or false then the `namespaces` field must contain a non-empty list.
+     */
     @JsonProperty("clusterScope")
     public void setClusterScope(Boolean clusterScope) {
         this.clusterScope = clusterScope;
     }
 
+    /**
+     * `namespaces` is a list of target namespaces that restricts matches.  A request that specifies a target namespace matches only if either (a) this list contains that target namespace or (b) this list contains "&#42;".  Note that "&#42;" matches any specified namespace but does not match a request that _does not specify_ a namespace (see the `clusterScope` field for that). This list may be empty, but only if `clusterScope` is true.
+     */
     @JsonProperty("namespaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNamespaces() {
         return namespaces;
     }
 
+    /**
+     * `namespaces` is a list of target namespaces that restricts matches.  A request that specifies a target namespace matches only if either (a) this list contains that target namespace or (b) this list contains "&#42;".  Note that "&#42;" matches any specified namespace but does not match a request that _does not specify_ a namespace (see the `clusterScope` field for that). This list may be empty, but only if `clusterScope` is true.
+     */
     @JsonProperty("namespaces")
     public void setNamespaces(List<String> namespaces) {
         this.namespaces = namespaces;
     }
 
+    /**
+     * `resources` is a list of matching resources (i.e., lowercase and plural) with, if desired, subresource.  For example, [ "services", "nodes/status" ].  This list may not be empty. "&#42;" matches all resources and, if present, must be the only entry. Required.
+     */
     @JsonProperty("resources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getResources() {
         return resources;
     }
 
+    /**
+     * `resources` is a list of matching resources (i.e., lowercase and plural) with, if desired, subresource.  For example, [ "services", "nodes/status" ].  This list may not be empty. "&#42;" matches all resources and, if present, must be the only entry. Required.
+     */
     @JsonProperty("resources")
     public void setResources(List<String> resources) {
         this.resources = resources;
     }
 
+    /**
+     * `verbs` is a list of matching verbs and may not be empty. "&#42;" matches all verbs and, if present, must be the only entry. Required.
+     */
     @JsonProperty("verbs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getVerbs() {
         return verbs;
     }
 
+    /**
+     * `verbs` is a list of matching verbs and may not be empty. "&#42;" matches all verbs and, if present, must be the only entry. Required.
+     */
     @JsonProperty("verbs")
     public void setVerbs(List<String> verbs) {
         this.verbs = verbs;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/ServiceAccountSubject.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/ServiceAccountSubject.java
index 305eb1ffc92..016ee42b70a 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/ServiceAccountSubject.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/ServiceAccountSubject.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceAccountSubject holds detailed information for service-account-kind subject.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ServiceAccountSubject(String name, String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * `name` is the name of matching ServiceAccount objects, or "&#42;" to match regardless of name. Required.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * `name` is the name of matching ServiceAccount objects, or "&#42;" to match regardless of name. Required.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * `namespace` is the namespace of matching ServiceAccount objects. Required.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * `namespace` is the namespace of matching ServiceAccount objects. Required.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/Subject.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/Subject.java
index bd718e2deed..e67503c71e7 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/Subject.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/Subject.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public Subject(GroupSubject group, String kind, ServiceAccountSubject serviceAcc
         this.user = user;
     }
 
+    /**
+     * Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account.
+     */
     @JsonProperty("group")
     public GroupSubject getGroup() {
         return group;
     }
 
+    /**
+     * Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account.
+     */
     @JsonProperty("group")
     public void setGroup(GroupSubject group) {
         this.group = group;
     }
 
+    /**
+     * `kind` indicates which one of the other fields is non-empty. Required
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * `kind` indicates which one of the other fields is non-empty. Required
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account.
+     */
     @JsonProperty("serviceAccount")
     public ServiceAccountSubject getServiceAccount() {
         return serviceAccount;
     }
 
+    /**
+     * Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account.
+     */
     @JsonProperty("serviceAccount")
     public void setServiceAccount(ServiceAccountSubject serviceAccount) {
         this.serviceAccount = serviceAccount;
     }
 
+    /**
+     * Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account.
+     */
     @JsonProperty("user")
     public UserSubject getUser() {
         return user;
     }
 
+    /**
+     * Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account.
+     */
     @JsonProperty("user")
     public void setUser(UserSubject user) {
         this.user = user;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/UserSubject.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/UserSubject.java
index aaf39098e38..97851151d27 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/UserSubject.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1/UserSubject.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UserSubject holds detailed information for user-kind subject.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public UserSubject(String name) {
         this.name = name;
     }
 
+    /**
+     * `name` is the username that matches, or "&#42;" to match all usernames. Required.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * `name` is the username that matches, or "&#42;" to match all usernames. Required.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/FlowDistinguisherMethod.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/FlowDistinguisherMethod.java
index db0ca3ba34a..c9ceccaeb7f 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/FlowDistinguisherMethod.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/FlowDistinguisherMethod.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FlowDistinguisherMethod specifies the method of a flow distinguisher.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public FlowDistinguisherMethod(String type) {
         this.type = type;
     }
 
+    /**
+     * `type` is the type of flow distinguisher method The supported types are "ByUser" and "ByNamespace". Required.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * `type` is the type of flow distinguisher method The supported types are "ByUser" and "ByNamespace". Required.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/FlowSchema.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/FlowSchema.java
index 018630ce3d1..a417f67293e 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/FlowSchema.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/FlowSchema.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class FlowSchema implements Editable<FlowSchemaBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "flowcontrol.apiserver.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "FlowSchema";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public FlowSchema(String apiVersion, String kind, ObjectMeta metadata, FlowSchem
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".
+     */
     @JsonProperty("spec")
     public FlowSchemaSpec getSpec() {
         return spec;
     }
 
+    /**
+     * FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".
+     */
     @JsonProperty("spec")
     public void setSpec(FlowSchemaSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".
+     */
     @JsonProperty("status")
     public FlowSchemaStatus getStatus() {
         return status;
     }
 
+    /**
+     * FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".
+     */
     @JsonProperty("status")
     public void setStatus(FlowSchemaStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/FlowSchemaCondition.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/FlowSchemaCondition.java
index e32821b9b17..ca69c46dcbe 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/FlowSchemaCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/FlowSchemaCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FlowSchemaCondition describes conditions for a FlowSchema.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public FlowSchemaCondition(String lastTransitionTime, String message, String rea
         this.type = type;
     }
 
+    /**
+     * FlowSchemaCondition describes conditions for a FlowSchema.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * FlowSchemaCondition describes conditions for a FlowSchema.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * `message` is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * `message` is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * `reason` is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * `reason` is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * `status` is the status of the condition. Can be True, False, Unknown. Required.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * `status` is the status of the condition. Can be True, False, Unknown. Required.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * `type` is the type of the condition. Required.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * `type` is the type of the condition. Required.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/FlowSchemaList.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/FlowSchemaList.java
index 6381288e397..a97b7e13554 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/FlowSchemaList.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/FlowSchemaList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FlowSchemaList is a list of FlowSchema objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class FlowSchemaList implements Editable<FlowSchemaListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.flowcontrol.v1beta1.FlowSchema>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "flowcontrol.apiserver.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.flowcontrol.v1beta1.FlowSchema> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "FlowSchemaList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public FlowSchemaList(String apiVersion, List<io.fabric8.kubernetes.api.model.fl
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * `items` is a list of FlowSchemas.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.flowcontrol.v1beta1.FlowSchema> getItems() {
         return items;
     }
 
+    /**
+     * `items` is a list of FlowSchemas.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.flowcontrol.v1beta1.FlowSchema> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * FlowSchemaList is a list of FlowSchema objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * FlowSchemaList is a list of FlowSchema objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/FlowSchemaSpec.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/FlowSchemaSpec.java
index a0c4f63f7a5..b6704a2e2e6 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/FlowSchemaSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/FlowSchemaSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FlowSchemaSpec describes how the FlowSchema's specification looks like.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public FlowSchemaSpec(FlowDistinguisherMethod distinguisherMethod, Integer match
         this.rules = rules;
     }
 
+    /**
+     * FlowSchemaSpec describes how the FlowSchema's specification looks like.
+     */
     @JsonProperty("distinguisherMethod")
     public FlowDistinguisherMethod getDistinguisherMethod() {
         return distinguisherMethod;
     }
 
+    /**
+     * FlowSchemaSpec describes how the FlowSchema's specification looks like.
+     */
     @JsonProperty("distinguisherMethod")
     public void setDistinguisherMethod(FlowDistinguisherMethod distinguisherMethod) {
         this.distinguisherMethod = distinguisherMethod;
     }
 
+    /**
+     * `matchingPrecedence` is used to choose among the FlowSchemas that match a given request. The chosen FlowSchema is among those with the numerically lowest (which we take to be logically highest) MatchingPrecedence.  Each MatchingPrecedence value must be ranged in [1,10000]. Note that if the precedence is not specified, it will be set to 1000 as default.
+     */
     @JsonProperty("matchingPrecedence")
     public Integer getMatchingPrecedence() {
         return matchingPrecedence;
     }
 
+    /**
+     * `matchingPrecedence` is used to choose among the FlowSchemas that match a given request. The chosen FlowSchema is among those with the numerically lowest (which we take to be logically highest) MatchingPrecedence.  Each MatchingPrecedence value must be ranged in [1,10000]. Note that if the precedence is not specified, it will be set to 1000 as default.
+     */
     @JsonProperty("matchingPrecedence")
     public void setMatchingPrecedence(Integer matchingPrecedence) {
         this.matchingPrecedence = matchingPrecedence;
     }
 
+    /**
+     * FlowSchemaSpec describes how the FlowSchema's specification looks like.
+     */
     @JsonProperty("priorityLevelConfiguration")
     public PriorityLevelConfigurationReference getPriorityLevelConfiguration() {
         return priorityLevelConfiguration;
     }
 
+    /**
+     * FlowSchemaSpec describes how the FlowSchema's specification looks like.
+     */
     @JsonProperty("priorityLevelConfiguration")
     public void setPriorityLevelConfiguration(PriorityLevelConfigurationReference priorityLevelConfiguration) {
         this.priorityLevelConfiguration = priorityLevelConfiguration;
     }
 
+    /**
+     * `rules` describes which requests will match this flow schema. This FlowSchema matches a request if and only if at least one member of rules matches the request. if it is an empty slice, there will be no requests matching the FlowSchema.
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PolicyRulesWithSubjects> getRules() {
         return rules;
     }
 
+    /**
+     * `rules` describes which requests will match this flow schema. This FlowSchema matches a request if and only if at least one member of rules matches the request. if it is an empty slice, there will be no requests matching the FlowSchema.
+     */
     @JsonProperty("rules")
     public void setRules(List<PolicyRulesWithSubjects> rules) {
         this.rules = rules;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/FlowSchemaStatus.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/FlowSchemaStatus.java
index b37dcf71a6e..498796d9bd3 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/FlowSchemaStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/FlowSchemaStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FlowSchemaStatus represents the current state of a FlowSchema.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public FlowSchemaStatus(List<FlowSchemaCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * `conditions` is a list of the current states of FlowSchema.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<FlowSchemaCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * `conditions` is a list of the current states of FlowSchema.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<FlowSchemaCondition> conditions) {
         this.conditions = conditions;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/GroupSubject.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/GroupSubject.java
index 14aef21d66a..944b17e0272 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/GroupSubject.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/GroupSubject.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GroupSubject holds detailed information for group-kind subject.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public GroupSubject(String name) {
         this.name = name;
     }
 
+    /**
+     * name is the user group that matches, or "&#42;" to match all user groups. See https://github.com/kubernetes/apiserver/blob/master/pkg/authentication/user/user.go for some well-known group names. Required.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the user group that matches, or "&#42;" to match all user groups. See https://github.com/kubernetes/apiserver/blob/master/pkg/authentication/user/user.go for some well-known group names. Required.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/LimitResponse.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/LimitResponse.java
index 2fd866a5e44..781311f1a52 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/LimitResponse.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/LimitResponse.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LimitResponse defines how to handle requests that can not be executed right now.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public LimitResponse(QueuingConfiguration queuing, String type) {
         this.type = type;
     }
 
+    /**
+     * LimitResponse defines how to handle requests that can not be executed right now.
+     */
     @JsonProperty("queuing")
     public QueuingConfiguration getQueuing() {
         return queuing;
     }
 
+    /**
+     * LimitResponse defines how to handle requests that can not be executed right now.
+     */
     @JsonProperty("queuing")
     public void setQueuing(QueuingConfiguration queuing) {
         this.queuing = queuing;
     }
 
+    /**
+     * `type` is "Queue" or "Reject". "Queue" means that requests that can not be executed upon arrival are held in a queue until they can be executed or a queuing limit is reached. "Reject" means that requests that can not be executed upon arrival are rejected. Required.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * `type` is "Queue" or "Reject". "Queue" means that requests that can not be executed upon arrival are held in a queue until they can be executed or a queuing limit is reached. "Reject" means that requests that can not be executed upon arrival are rejected. Required.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/LimitedPriorityLevelConfiguration.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/LimitedPriorityLevelConfiguration.java
index 4bb18103f68..8b998f8fadc 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/LimitedPriorityLevelConfiguration.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/LimitedPriorityLevelConfiguration.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LimitedPriorityLevelConfiguration specifies how to handle requests that are subject to limits. It addresses two issues:<br><p>  &#42; How are requests for this priority level limited?<br><p>  &#42; What should be done with requests that exceed the limit?
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public LimitedPriorityLevelConfiguration(Integer assuredConcurrencyShares, Limit
         this.limitResponse = limitResponse;
     }
 
+    /**
+     * `assuredConcurrencyShares` (ACS) configures the execution limit, which is a limit on the number of requests of this priority level that may be exeucting at a given time.  ACS must be a positive number. The server's concurrency limit (SCL) is divided among the concurrency-controlled priority levels in proportion to their assured concurrency shares. This produces the assured concurrency value (ACV) --- the number of requests that may be executing at a time --- for each such priority level:<br><p> <br><p>             ACV(l) = ceil( SCL &#42; ACS(l) / ( sum[priority levels k] ACS(k) ) )<br><p> <br><p> bigger numbers of ACS mean more reserved concurrent requests (at the expense of every other PL). This field has a default value of 30.
+     */
     @JsonProperty("assuredConcurrencyShares")
     public Integer getAssuredConcurrencyShares() {
         return assuredConcurrencyShares;
     }
 
+    /**
+     * `assuredConcurrencyShares` (ACS) configures the execution limit, which is a limit on the number of requests of this priority level that may be exeucting at a given time.  ACS must be a positive number. The server's concurrency limit (SCL) is divided among the concurrency-controlled priority levels in proportion to their assured concurrency shares. This produces the assured concurrency value (ACV) --- the number of requests that may be executing at a time --- for each such priority level:<br><p> <br><p>             ACV(l) = ceil( SCL &#42; ACS(l) / ( sum[priority levels k] ACS(k) ) )<br><p> <br><p> bigger numbers of ACS mean more reserved concurrent requests (at the expense of every other PL). This field has a default value of 30.
+     */
     @JsonProperty("assuredConcurrencyShares")
     public void setAssuredConcurrencyShares(Integer assuredConcurrencyShares) {
         this.assuredConcurrencyShares = assuredConcurrencyShares;
     }
 
+    /**
+     * LimitedPriorityLevelConfiguration specifies how to handle requests that are subject to limits. It addresses two issues:<br><p>  &#42; How are requests for this priority level limited?<br><p>  &#42; What should be done with requests that exceed the limit?
+     */
     @JsonProperty("limitResponse")
     public LimitResponse getLimitResponse() {
         return limitResponse;
     }
 
+    /**
+     * LimitedPriorityLevelConfiguration specifies how to handle requests that are subject to limits. It addresses two issues:<br><p>  &#42; How are requests for this priority level limited?<br><p>  &#42; What should be done with requests that exceed the limit?
+     */
     @JsonProperty("limitResponse")
     public void setLimitResponse(LimitResponse limitResponse) {
         this.limitResponse = limitResponse;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/NonResourcePolicyRule.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/NonResourcePolicyRule.java
index f83abd88920..022ba6f3fe5 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/NonResourcePolicyRule.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/NonResourcePolicyRule.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NonResourcePolicyRule is a predicate that matches non-resource requests according to their verb and the target non-resource URL. A NonResourcePolicyRule matches a request if and only if both (a) at least one member of verbs matches the request and (b) at least one member of nonResourceURLs matches the request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public NonResourcePolicyRule(List<String> nonResourceURLs, List<String> verbs) {
         this.verbs = verbs;
     }
 
+    /**
+     * `nonResourceURLs` is a set of url prefixes that a user should have access to and may not be empty. For example:<br><p>   - "/healthz" is legal<br><p>   - "/hea&#42;" is illegal<br><p>   - "/hea" is legal but matches nothing<br><p>   - "/hea/&#42;" also matches nothing<br><p>   - "/healthz/&#42;" matches all per-component health checks.<br><p> "&#42;" matches all non-resource urls. if it is present, it must be the only entry. Required.
+     */
     @JsonProperty("nonResourceURLs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNonResourceURLs() {
         return nonResourceURLs;
     }
 
+    /**
+     * `nonResourceURLs` is a set of url prefixes that a user should have access to and may not be empty. For example:<br><p>   - "/healthz" is legal<br><p>   - "/hea&#42;" is illegal<br><p>   - "/hea" is legal but matches nothing<br><p>   - "/hea/&#42;" also matches nothing<br><p>   - "/healthz/&#42;" matches all per-component health checks.<br><p> "&#42;" matches all non-resource urls. if it is present, it must be the only entry. Required.
+     */
     @JsonProperty("nonResourceURLs")
     public void setNonResourceURLs(List<String> nonResourceURLs) {
         this.nonResourceURLs = nonResourceURLs;
     }
 
+    /**
+     * `verbs` is a list of matching verbs and may not be empty. "&#42;" matches all verbs. If it is present, it must be the only entry. Required.
+     */
     @JsonProperty("verbs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getVerbs() {
         return verbs;
     }
 
+    /**
+     * `verbs` is a list of matching verbs and may not be empty. "&#42;" matches all verbs. If it is present, it must be the only entry. Required.
+     */
     @JsonProperty("verbs")
     public void setVerbs(List<String> verbs) {
         this.verbs = verbs;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/PolicyRulesWithSubjects.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/PolicyRulesWithSubjects.java
index fed6835c9e9..bc2fd919297 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/PolicyRulesWithSubjects.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/PolicyRulesWithSubjects.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PolicyRulesWithSubjects prescribes a test that applies to a request to an apiserver. The test considers the subject making the request, the verb being requested, and the resource to be acted upon. This PolicyRulesWithSubjects matches a request if and only if both (a) at least one member of subjects matches the request and (b) at least one member of resourceRules or nonResourceRules matches the request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,34 +94,52 @@ public PolicyRulesWithSubjects(List<NonResourcePolicyRule> nonResourceRules, Lis
         this.subjects = subjects;
     }
 
+    /**
+     * `nonResourceRules` is a list of NonResourcePolicyRules that identify matching requests according to their verb and the target non-resource URL.
+     */
     @JsonProperty("nonResourceRules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NonResourcePolicyRule> getNonResourceRules() {
         return nonResourceRules;
     }
 
+    /**
+     * `nonResourceRules` is a list of NonResourcePolicyRules that identify matching requests according to their verb and the target non-resource URL.
+     */
     @JsonProperty("nonResourceRules")
     public void setNonResourceRules(List<NonResourcePolicyRule> nonResourceRules) {
         this.nonResourceRules = nonResourceRules;
     }
 
+    /**
+     * `resourceRules` is a slice of ResourcePolicyRules that identify matching requests according to their verb and the target resource. At least one of `resourceRules` and `nonResourceRules` has to be non-empty.
+     */
     @JsonProperty("resourceRules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ResourcePolicyRule> getResourceRules() {
         return resourceRules;
     }
 
+    /**
+     * `resourceRules` is a slice of ResourcePolicyRules that identify matching requests according to their verb and the target resource. At least one of `resourceRules` and `nonResourceRules` has to be non-empty.
+     */
     @JsonProperty("resourceRules")
     public void setResourceRules(List<ResourcePolicyRule> resourceRules) {
         this.resourceRules = resourceRules;
     }
 
+    /**
+     * subjects is the list of normal user, serviceaccount, or group that this rule cares about. There must be at least one member in this slice. A slice that includes both the system:authenticated and system:unauthenticated user groups matches every request. Required.
+     */
     @JsonProperty("subjects")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Subject> getSubjects() {
         return subjects;
     }
 
+    /**
+     * subjects is the list of normal user, serviceaccount, or group that this rule cares about. There must be at least one member in this slice. A slice that includes both the system:authenticated and system:unauthenticated user groups matches every request. Required.
+     */
     @JsonProperty("subjects")
     public void setSubjects(List<Subject> subjects) {
         this.subjects = subjects;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/PriorityLevelConfiguration.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/PriorityLevelConfiguration.java
index da9553e1fa4..ef8caefa265 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/PriorityLevelConfiguration.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/PriorityLevelConfiguration.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PriorityLevelConfiguration represents the configuration of a priority level.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class PriorityLevelConfiguration implements Editable<PriorityLevelConfigurationBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "flowcontrol.apiserver.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PriorityLevelConfiguration";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public PriorityLevelConfiguration(String apiVersion, String kind, ObjectMeta met
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PriorityLevelConfiguration represents the configuration of a priority level.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PriorityLevelConfiguration represents the configuration of a priority level.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PriorityLevelConfiguration represents the configuration of a priority level.
+     */
     @JsonProperty("spec")
     public PriorityLevelConfigurationSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PriorityLevelConfiguration represents the configuration of a priority level.
+     */
     @JsonProperty("spec")
     public void setSpec(PriorityLevelConfigurationSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PriorityLevelConfiguration represents the configuration of a priority level.
+     */
     @JsonProperty("status")
     public PriorityLevelConfigurationStatus getStatus() {
         return status;
     }
 
+    /**
+     * PriorityLevelConfiguration represents the configuration of a priority level.
+     */
     @JsonProperty("status")
     public void setStatus(PriorityLevelConfigurationStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/PriorityLevelConfigurationCondition.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/PriorityLevelConfigurationCondition.java
index 7d94515d64d..13bbb4d2e53 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/PriorityLevelConfigurationCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/PriorityLevelConfigurationCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PriorityLevelConfigurationCondition defines the condition of priority level.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public PriorityLevelConfigurationCondition(String lastTransitionTime, String mes
         this.type = type;
     }
 
+    /**
+     * PriorityLevelConfigurationCondition defines the condition of priority level.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * PriorityLevelConfigurationCondition defines the condition of priority level.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * `message` is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * `message` is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * `reason` is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * `reason` is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * `status` is the status of the condition. Can be True, False, Unknown. Required.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * `status` is the status of the condition. Can be True, False, Unknown. Required.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * `type` is the type of the condition. Required.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * `type` is the type of the condition. Required.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/PriorityLevelConfigurationList.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/PriorityLevelConfigurationList.java
index 8b42cd61bb8..2203088cad4 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/PriorityLevelConfigurationList.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/PriorityLevelConfigurationList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PriorityLevelConfigurationList is a list of PriorityLevelConfiguration objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PriorityLevelConfigurationList implements Editable<PriorityLevelConfigurationListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.flowcontrol.v1beta1.PriorityLevelConfiguration>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "flowcontrol.apiserver.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.flowcontrol.v1beta1.PriorityLevelConfiguration> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PriorityLevelConfigurationList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PriorityLevelConfigurationList(String apiVersion, List<io.fabric8.kuberne
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * `items` is a list of request-priorities.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.flowcontrol.v1beta1.PriorityLevelConfiguration> getItems() {
         return items;
     }
 
+    /**
+     * `items` is a list of request-priorities.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.flowcontrol.v1beta1.PriorityLevelConfiguration> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PriorityLevelConfigurationList is a list of PriorityLevelConfiguration objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PriorityLevelConfigurationList is a list of PriorityLevelConfiguration objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/PriorityLevelConfigurationReference.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/PriorityLevelConfigurationReference.java
index e2265a509c2..070d2bce785 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/PriorityLevelConfigurationReference.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/PriorityLevelConfigurationReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PriorityLevelConfigurationReference contains information that points to the "request-priority" being used.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public PriorityLevelConfigurationReference(String name) {
         this.name = name;
     }
 
+    /**
+     * `name` is the name of the priority level configuration being referenced Required.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * `name` is the name of the priority level configuration being referenced Required.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/PriorityLevelConfigurationSpec.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/PriorityLevelConfigurationSpec.java
index 65c48237562..722ac3ff7a8 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/PriorityLevelConfigurationSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/PriorityLevelConfigurationSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PriorityLevelConfigurationSpec specifies the configuration of a priority level.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PriorityLevelConfigurationSpec(LimitedPriorityLevelConfiguration limited,
         this.type = type;
     }
 
+    /**
+     * PriorityLevelConfigurationSpec specifies the configuration of a priority level.
+     */
     @JsonProperty("limited")
     public LimitedPriorityLevelConfiguration getLimited() {
         return limited;
     }
 
+    /**
+     * PriorityLevelConfigurationSpec specifies the configuration of a priority level.
+     */
     @JsonProperty("limited")
     public void setLimited(LimitedPriorityLevelConfiguration limited) {
         this.limited = limited;
     }
 
+    /**
+     * `type` indicates whether this priority level is subject to limitation on request execution.  A value of `"Exempt"` means that requests of this priority level are not subject to a limit (and thus are never queued) and do not detract from the capacity made available to other priority levels.  A value of `"Limited"` means that (a) requests of this priority level _are_ subject to limits and (b) some of the server's limited capacity is made available exclusively to this priority level. Required.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * `type` indicates whether this priority level is subject to limitation on request execution.  A value of `"Exempt"` means that requests of this priority level are not subject to a limit (and thus are never queued) and do not detract from the capacity made available to other priority levels.  A value of `"Limited"` means that (a) requests of this priority level _are_ subject to limits and (b) some of the server's limited capacity is made available exclusively to this priority level. Required.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/PriorityLevelConfigurationStatus.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/PriorityLevelConfigurationStatus.java
index 93cf7d6f8b6..35424507272 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/PriorityLevelConfigurationStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/PriorityLevelConfigurationStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PriorityLevelConfigurationStatus represents the current state of a "request-priority".
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public PriorityLevelConfigurationStatus(List<PriorityLevelConfigurationCondition
         this.conditions = conditions;
     }
 
+    /**
+     * `conditions` is the current state of "request-priority".
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PriorityLevelConfigurationCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * `conditions` is the current state of "request-priority".
+     */
     @JsonProperty("conditions")
     public void setConditions(List<PriorityLevelConfigurationCondition> conditions) {
         this.conditions = conditions;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/QueuingConfiguration.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/QueuingConfiguration.java
index bb9011d709c..8c89a37f20e 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/QueuingConfiguration.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/QueuingConfiguration.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * QueuingConfiguration holds the configuration parameters for queuing
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public QueuingConfiguration(Integer handSize, Integer queueLengthLimit, Integer
         this.queues = queues;
     }
 
+    /**
+     * `handSize` is a small positive number that configures the shuffle sharding of requests into queues.  When enqueuing a request at this priority level the request's flow identifier (a string pair) is hashed and the hash value is used to shuffle the list of queues and deal a hand of the size specified here.  The request is put into one of the shortest queues in that hand. `handSize` must be no larger than `queues`, and should be significantly smaller (so that a few heavy flows do not saturate most of the queues).  See the user-facing documentation for more extensive guidance on setting this field.  This field has a default value of 8.
+     */
     @JsonProperty("handSize")
     public Integer getHandSize() {
         return handSize;
     }
 
+    /**
+     * `handSize` is a small positive number that configures the shuffle sharding of requests into queues.  When enqueuing a request at this priority level the request's flow identifier (a string pair) is hashed and the hash value is used to shuffle the list of queues and deal a hand of the size specified here.  The request is put into one of the shortest queues in that hand. `handSize` must be no larger than `queues`, and should be significantly smaller (so that a few heavy flows do not saturate most of the queues).  See the user-facing documentation for more extensive guidance on setting this field.  This field has a default value of 8.
+     */
     @JsonProperty("handSize")
     public void setHandSize(Integer handSize) {
         this.handSize = handSize;
     }
 
+    /**
+     * `queueLengthLimit` is the maximum number of requests allowed to be waiting in a given queue of this priority level at a time; excess requests are rejected.  This value must be positive.  If not specified, it will be defaulted to 50.
+     */
     @JsonProperty("queueLengthLimit")
     public Integer getQueueLengthLimit() {
         return queueLengthLimit;
     }
 
+    /**
+     * `queueLengthLimit` is the maximum number of requests allowed to be waiting in a given queue of this priority level at a time; excess requests are rejected.  This value must be positive.  If not specified, it will be defaulted to 50.
+     */
     @JsonProperty("queueLengthLimit")
     public void setQueueLengthLimit(Integer queueLengthLimit) {
         this.queueLengthLimit = queueLengthLimit;
     }
 
+    /**
+     * `queues` is the number of queues for this priority level. The queues exist independently at each apiserver. The value must be positive.  Setting it to 1 effectively precludes shufflesharding and thus makes the distinguisher method of associated flow schemas irrelevant.  This field has a default value of 64.
+     */
     @JsonProperty("queues")
     public Integer getQueues() {
         return queues;
     }
 
+    /**
+     * `queues` is the number of queues for this priority level. The queues exist independently at each apiserver. The value must be positive.  Setting it to 1 effectively precludes shufflesharding and thus makes the distinguisher method of associated flow schemas irrelevant.  This field has a default value of 64.
+     */
     @JsonProperty("queues")
     public void setQueues(Integer queues) {
         this.queues = queues;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/ResourcePolicyRule.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/ResourcePolicyRule.java
index b7767a2dfdb..dcc32311740 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/ResourcePolicyRule.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/ResourcePolicyRule.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourcePolicyRule is a predicate that matches some resource requests, testing the request's verb and the target resource. A ResourcePolicyRule matches a resource request if and only if: (a) at least one member of verbs matches the request, (b) at least one member of apiGroups matches the request, (c) at least one member of resources matches the request, and (d) least one member of namespaces matches the request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -100,55 +103,85 @@ public ResourcePolicyRule(List<String> apiGroups, Boolean clusterScope, List<Str
         this.verbs = verbs;
     }
 
+    /**
+     * `apiGroups` is a list of matching API groups and may not be empty. "&#42;" matches all API groups and, if present, must be the only entry. Required.
+     */
     @JsonProperty("apiGroups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiGroups() {
         return apiGroups;
     }
 
+    /**
+     * `apiGroups` is a list of matching API groups and may not be empty. "&#42;" matches all API groups and, if present, must be the only entry. Required.
+     */
     @JsonProperty("apiGroups")
     public void setApiGroups(List<String> apiGroups) {
         this.apiGroups = apiGroups;
     }
 
+    /**
+     * `clusterScope` indicates whether to match requests that do not specify a namespace (which happens either because the resource is not namespaced or the request targets all namespaces). If this field is omitted or false then the `namespaces` field must contain a non-empty list.
+     */
     @JsonProperty("clusterScope")
     public Boolean getClusterScope() {
         return clusterScope;
     }
 
+    /**
+     * `clusterScope` indicates whether to match requests that do not specify a namespace (which happens either because the resource is not namespaced or the request targets all namespaces). If this field is omitted or false then the `namespaces` field must contain a non-empty list.
+     */
     @JsonProperty("clusterScope")
     public void setClusterScope(Boolean clusterScope) {
         this.clusterScope = clusterScope;
     }
 
+    /**
+     * `namespaces` is a list of target namespaces that restricts matches.  A request that specifies a target namespace matches only if either (a) this list contains that target namespace or (b) this list contains "&#42;".  Note that "&#42;" matches any specified namespace but does not match a request that _does not specify_ a namespace (see the `clusterScope` field for that). This list may be empty, but only if `clusterScope` is true.
+     */
     @JsonProperty("namespaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNamespaces() {
         return namespaces;
     }
 
+    /**
+     * `namespaces` is a list of target namespaces that restricts matches.  A request that specifies a target namespace matches only if either (a) this list contains that target namespace or (b) this list contains "&#42;".  Note that "&#42;" matches any specified namespace but does not match a request that _does not specify_ a namespace (see the `clusterScope` field for that). This list may be empty, but only if `clusterScope` is true.
+     */
     @JsonProperty("namespaces")
     public void setNamespaces(List<String> namespaces) {
         this.namespaces = namespaces;
     }
 
+    /**
+     * `resources` is a list of matching resources (i.e., lowercase and plural) with, if desired, subresource.  For example, [ "services", "nodes/status" ].  This list may not be empty. "&#42;" matches all resources and, if present, must be the only entry. Required.
+     */
     @JsonProperty("resources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getResources() {
         return resources;
     }
 
+    /**
+     * `resources` is a list of matching resources (i.e., lowercase and plural) with, if desired, subresource.  For example, [ "services", "nodes/status" ].  This list may not be empty. "&#42;" matches all resources and, if present, must be the only entry. Required.
+     */
     @JsonProperty("resources")
     public void setResources(List<String> resources) {
         this.resources = resources;
     }
 
+    /**
+     * `verbs` is a list of matching verbs and may not be empty. "&#42;" matches all verbs and, if present, must be the only entry. Required.
+     */
     @JsonProperty("verbs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getVerbs() {
         return verbs;
     }
 
+    /**
+     * `verbs` is a list of matching verbs and may not be empty. "&#42;" matches all verbs and, if present, must be the only entry. Required.
+     */
     @JsonProperty("verbs")
     public void setVerbs(List<String> verbs) {
         this.verbs = verbs;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/ServiceAccountSubject.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/ServiceAccountSubject.java
index 3b286458e54..b35e83301cd 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/ServiceAccountSubject.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/ServiceAccountSubject.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceAccountSubject holds detailed information for service-account-kind subject.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ServiceAccountSubject(String name, String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * `name` is the name of matching ServiceAccount objects, or "&#42;" to match regardless of name. Required.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * `name` is the name of matching ServiceAccount objects, or "&#42;" to match regardless of name. Required.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * `namespace` is the namespace of matching ServiceAccount objects. Required.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * `namespace` is the namespace of matching ServiceAccount objects. Required.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/Subject.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/Subject.java
index 4e0c3078232..93e2118a6e6 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/Subject.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/Subject.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public Subject(GroupSubject group, String kind, ServiceAccountSubject serviceAcc
         this.user = user;
     }
 
+    /**
+     * Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account.
+     */
     @JsonProperty("group")
     public GroupSubject getGroup() {
         return group;
     }
 
+    /**
+     * Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account.
+     */
     @JsonProperty("group")
     public void setGroup(GroupSubject group) {
         this.group = group;
     }
 
+    /**
+     * Required
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Required
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account.
+     */
     @JsonProperty("serviceAccount")
     public ServiceAccountSubject getServiceAccount() {
         return serviceAccount;
     }
 
+    /**
+     * Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account.
+     */
     @JsonProperty("serviceAccount")
     public void setServiceAccount(ServiceAccountSubject serviceAccount) {
         this.serviceAccount = serviceAccount;
     }
 
+    /**
+     * Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account.
+     */
     @JsonProperty("user")
     public UserSubject getUser() {
         return user;
     }
 
+    /**
+     * Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account.
+     */
     @JsonProperty("user")
     public void setUser(UserSubject user) {
         this.user = user;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/UserSubject.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/UserSubject.java
index 50840791b80..93230c4701a 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/UserSubject.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta1/UserSubject.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UserSubject holds detailed information for user-kind subject.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public UserSubject(String name) {
         this.name = name;
     }
 
+    /**
+     * `name` is the username that matches, or "&#42;" to match all usernames. Required.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * `name` is the username that matches, or "&#42;" to match all usernames. Required.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/FlowDistinguisherMethod.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/FlowDistinguisherMethod.java
index ca9fd01f26d..dac25f4c312 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/FlowDistinguisherMethod.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/FlowDistinguisherMethod.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FlowDistinguisherMethod specifies the method of a flow distinguisher.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public FlowDistinguisherMethod(String type) {
         this.type = type;
     }
 
+    /**
+     * `type` is the type of flow distinguisher method The supported types are "ByUser" and "ByNamespace". Required.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * `type` is the type of flow distinguisher method The supported types are "ByUser" and "ByNamespace". Required.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/FlowSchema.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/FlowSchema.java
index a146b06b13d..9657fc1f120 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/FlowSchema.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/FlowSchema.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class FlowSchema implements Editable<FlowSchemaBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "flowcontrol.apiserver.k8s.io/v1beta2";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "FlowSchema";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public FlowSchema(String apiVersion, String kind, ObjectMeta metadata, FlowSchem
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".
+     */
     @JsonProperty("spec")
     public FlowSchemaSpec getSpec() {
         return spec;
     }
 
+    /**
+     * FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".
+     */
     @JsonProperty("spec")
     public void setSpec(FlowSchemaSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".
+     */
     @JsonProperty("status")
     public FlowSchemaStatus getStatus() {
         return status;
     }
 
+    /**
+     * FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".
+     */
     @JsonProperty("status")
     public void setStatus(FlowSchemaStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/FlowSchemaCondition.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/FlowSchemaCondition.java
index 775e217aef7..3f6986caefe 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/FlowSchemaCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/FlowSchemaCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FlowSchemaCondition describes conditions for a FlowSchema.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public FlowSchemaCondition(String lastTransitionTime, String message, String rea
         this.type = type;
     }
 
+    /**
+     * FlowSchemaCondition describes conditions for a FlowSchema.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * FlowSchemaCondition describes conditions for a FlowSchema.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * `message` is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * `message` is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * `reason` is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * `reason` is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * `status` is the status of the condition. Can be True, False, Unknown. Required.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * `status` is the status of the condition. Can be True, False, Unknown. Required.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * `type` is the type of the condition. Required.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * `type` is the type of the condition. Required.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/FlowSchemaList.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/FlowSchemaList.java
index 92cbfe3c77d..222b093aea8 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/FlowSchemaList.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/FlowSchemaList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FlowSchemaList is a list of FlowSchema objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class FlowSchemaList implements Editable<FlowSchemaListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.flowcontrol.v1beta2.FlowSchema>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "flowcontrol.apiserver.k8s.io/v1beta2";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.flowcontrol.v1beta2.FlowSchema> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "FlowSchemaList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public FlowSchemaList(String apiVersion, List<io.fabric8.kubernetes.api.model.fl
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * `items` is a list of FlowSchemas.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.flowcontrol.v1beta2.FlowSchema> getItems() {
         return items;
     }
 
+    /**
+     * `items` is a list of FlowSchemas.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.flowcontrol.v1beta2.FlowSchema> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * FlowSchemaList is a list of FlowSchema objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * FlowSchemaList is a list of FlowSchema objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/FlowSchemaSpec.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/FlowSchemaSpec.java
index 673aa9b3bb4..6b6b31c815c 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/FlowSchemaSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/FlowSchemaSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FlowSchemaSpec describes how the FlowSchema's specification looks like.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public FlowSchemaSpec(FlowDistinguisherMethod distinguisherMethod, Integer match
         this.rules = rules;
     }
 
+    /**
+     * FlowSchemaSpec describes how the FlowSchema's specification looks like.
+     */
     @JsonProperty("distinguisherMethod")
     public FlowDistinguisherMethod getDistinguisherMethod() {
         return distinguisherMethod;
     }
 
+    /**
+     * FlowSchemaSpec describes how the FlowSchema's specification looks like.
+     */
     @JsonProperty("distinguisherMethod")
     public void setDistinguisherMethod(FlowDistinguisherMethod distinguisherMethod) {
         this.distinguisherMethod = distinguisherMethod;
     }
 
+    /**
+     * `matchingPrecedence` is used to choose among the FlowSchemas that match a given request. The chosen FlowSchema is among those with the numerically lowest (which we take to be logically highest) MatchingPrecedence.  Each MatchingPrecedence value must be ranged in [1,10000]. Note that if the precedence is not specified, it will be set to 1000 as default.
+     */
     @JsonProperty("matchingPrecedence")
     public Integer getMatchingPrecedence() {
         return matchingPrecedence;
     }
 
+    /**
+     * `matchingPrecedence` is used to choose among the FlowSchemas that match a given request. The chosen FlowSchema is among those with the numerically lowest (which we take to be logically highest) MatchingPrecedence.  Each MatchingPrecedence value must be ranged in [1,10000]. Note that if the precedence is not specified, it will be set to 1000 as default.
+     */
     @JsonProperty("matchingPrecedence")
     public void setMatchingPrecedence(Integer matchingPrecedence) {
         this.matchingPrecedence = matchingPrecedence;
     }
 
+    /**
+     * FlowSchemaSpec describes how the FlowSchema's specification looks like.
+     */
     @JsonProperty("priorityLevelConfiguration")
     public PriorityLevelConfigurationReference getPriorityLevelConfiguration() {
         return priorityLevelConfiguration;
     }
 
+    /**
+     * FlowSchemaSpec describes how the FlowSchema's specification looks like.
+     */
     @JsonProperty("priorityLevelConfiguration")
     public void setPriorityLevelConfiguration(PriorityLevelConfigurationReference priorityLevelConfiguration) {
         this.priorityLevelConfiguration = priorityLevelConfiguration;
     }
 
+    /**
+     * `rules` describes which requests will match this flow schema. This FlowSchema matches a request if and only if at least one member of rules matches the request. if it is an empty slice, there will be no requests matching the FlowSchema.
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PolicyRulesWithSubjects> getRules() {
         return rules;
     }
 
+    /**
+     * `rules` describes which requests will match this flow schema. This FlowSchema matches a request if and only if at least one member of rules matches the request. if it is an empty slice, there will be no requests matching the FlowSchema.
+     */
     @JsonProperty("rules")
     public void setRules(List<PolicyRulesWithSubjects> rules) {
         this.rules = rules;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/FlowSchemaStatus.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/FlowSchemaStatus.java
index 1a071f7cbff..11b721b7959 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/FlowSchemaStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/FlowSchemaStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FlowSchemaStatus represents the current state of a FlowSchema.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public FlowSchemaStatus(List<FlowSchemaCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * `conditions` is a list of the current states of FlowSchema.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<FlowSchemaCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * `conditions` is a list of the current states of FlowSchema.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<FlowSchemaCondition> conditions) {
         this.conditions = conditions;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/GroupSubject.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/GroupSubject.java
index 094ac8c3a1d..bb5678e15df 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/GroupSubject.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/GroupSubject.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GroupSubject holds detailed information for group-kind subject.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public GroupSubject(String name) {
         this.name = name;
     }
 
+    /**
+     * name is the user group that matches, or "&#42;" to match all user groups. See https://github.com/kubernetes/apiserver/blob/master/pkg/authentication/user/user.go for some well-known group names. Required.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the user group that matches, or "&#42;" to match all user groups. See https://github.com/kubernetes/apiserver/blob/master/pkg/authentication/user/user.go for some well-known group names. Required.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/LimitResponse.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/LimitResponse.java
index 06fe83e7f3f..01ad343013f 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/LimitResponse.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/LimitResponse.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LimitResponse defines how to handle requests that can not be executed right now.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public LimitResponse(QueuingConfiguration queuing, String type) {
         this.type = type;
     }
 
+    /**
+     * LimitResponse defines how to handle requests that can not be executed right now.
+     */
     @JsonProperty("queuing")
     public QueuingConfiguration getQueuing() {
         return queuing;
     }
 
+    /**
+     * LimitResponse defines how to handle requests that can not be executed right now.
+     */
     @JsonProperty("queuing")
     public void setQueuing(QueuingConfiguration queuing) {
         this.queuing = queuing;
     }
 
+    /**
+     * `type` is "Queue" or "Reject". "Queue" means that requests that can not be executed upon arrival are held in a queue until they can be executed or a queuing limit is reached. "Reject" means that requests that can not be executed upon arrival are rejected. Required.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * `type` is "Queue" or "Reject". "Queue" means that requests that can not be executed upon arrival are held in a queue until they can be executed or a queuing limit is reached. "Reject" means that requests that can not be executed upon arrival are rejected. Required.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/LimitedPriorityLevelConfiguration.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/LimitedPriorityLevelConfiguration.java
index fbf542935e7..92da092f5a9 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/LimitedPriorityLevelConfiguration.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/LimitedPriorityLevelConfiguration.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LimitedPriorityLevelConfiguration specifies how to handle requests that are subject to limits. It addresses two issues:<br><p>   - How are requests for this priority level limited?<br><p>   - What should be done with requests that exceed the limit?
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public LimitedPriorityLevelConfiguration(Integer assuredConcurrencyShares, Integ
         this.limitResponse = limitResponse;
     }
 
+    /**
+     * `assuredConcurrencyShares` (ACS) configures the execution limit, which is a limit on the number of requests of this priority level that may be exeucting at a given time.  ACS must be a positive number. The server's concurrency limit (SCL) is divided among the concurrency-controlled priority levels in proportion to their assured concurrency shares. This produces the assured concurrency value (ACV) --- the number of requests that may be executing at a time --- for each such priority level:<br><p> <br><p>             ACV(l) = ceil( SCL &#42; ACS(l) / ( sum[priority levels k] ACS(k) ) )<br><p> <br><p> bigger numbers of ACS mean more reserved concurrent requests (at the expense of every other PL). This field has a default value of 30.
+     */
     @JsonProperty("assuredConcurrencyShares")
     public Integer getAssuredConcurrencyShares() {
         return assuredConcurrencyShares;
     }
 
+    /**
+     * `assuredConcurrencyShares` (ACS) configures the execution limit, which is a limit on the number of requests of this priority level that may be exeucting at a given time.  ACS must be a positive number. The server's concurrency limit (SCL) is divided among the concurrency-controlled priority levels in proportion to their assured concurrency shares. This produces the assured concurrency value (ACV) --- the number of requests that may be executing at a time --- for each such priority level:<br><p> <br><p>             ACV(l) = ceil( SCL &#42; ACS(l) / ( sum[priority levels k] ACS(k) ) )<br><p> <br><p> bigger numbers of ACS mean more reserved concurrent requests (at the expense of every other PL). This field has a default value of 30.
+     */
     @JsonProperty("assuredConcurrencyShares")
     public void setAssuredConcurrencyShares(Integer assuredConcurrencyShares) {
         this.assuredConcurrencyShares = assuredConcurrencyShares;
     }
 
+    /**
+     * `borrowingLimitPercent`, if present, configures a limit on how many seats this priority level can borrow from other priority levels. The limit is known as this level's BorrowingConcurrencyLimit (BorrowingCL) and is a limit on the total number of seats that this level may borrow at any one time. This field holds the ratio of that limit to the level's nominal concurrency limit. When this field is non-nil, it must hold a non-negative integer and the limit is calculated as follows.<br><p> <br><p> BorrowingCL(i) = round( NominalCL(i) &#42; borrowingLimitPercent(i)/100.0 )<br><p> <br><p> The value of this field can be more than 100, implying that this priority level can borrow a number of seats that is greater than its own nominal concurrency limit (NominalCL). When this field is left `nil`, the limit is effectively infinite.
+     */
     @JsonProperty("borrowingLimitPercent")
     public Integer getBorrowingLimitPercent() {
         return borrowingLimitPercent;
     }
 
+    /**
+     * `borrowingLimitPercent`, if present, configures a limit on how many seats this priority level can borrow from other priority levels. The limit is known as this level's BorrowingConcurrencyLimit (BorrowingCL) and is a limit on the total number of seats that this level may borrow at any one time. This field holds the ratio of that limit to the level's nominal concurrency limit. When this field is non-nil, it must hold a non-negative integer and the limit is calculated as follows.<br><p> <br><p> BorrowingCL(i) = round( NominalCL(i) &#42; borrowingLimitPercent(i)/100.0 )<br><p> <br><p> The value of this field can be more than 100, implying that this priority level can borrow a number of seats that is greater than its own nominal concurrency limit (NominalCL). When this field is left `nil`, the limit is effectively infinite.
+     */
     @JsonProperty("borrowingLimitPercent")
     public void setBorrowingLimitPercent(Integer borrowingLimitPercent) {
         this.borrowingLimitPercent = borrowingLimitPercent;
     }
 
+    /**
+     * `lendablePercent` prescribes the fraction of the level's NominalCL that can be borrowed by other priority levels. The value of this field must be between 0 and 100, inclusive, and it defaults to 0. The number of seats that other levels can borrow from this level, known as this level's LendableConcurrencyLimit (LendableCL), is defined as follows.<br><p> <br><p> LendableCL(i) = round( NominalCL(i) &#42; lendablePercent(i)/100.0 )
+     */
     @JsonProperty("lendablePercent")
     public Integer getLendablePercent() {
         return lendablePercent;
     }
 
+    /**
+     * `lendablePercent` prescribes the fraction of the level's NominalCL that can be borrowed by other priority levels. The value of this field must be between 0 and 100, inclusive, and it defaults to 0. The number of seats that other levels can borrow from this level, known as this level's LendableConcurrencyLimit (LendableCL), is defined as follows.<br><p> <br><p> LendableCL(i) = round( NominalCL(i) &#42; lendablePercent(i)/100.0 )
+     */
     @JsonProperty("lendablePercent")
     public void setLendablePercent(Integer lendablePercent) {
         this.lendablePercent = lendablePercent;
     }
 
+    /**
+     * LimitedPriorityLevelConfiguration specifies how to handle requests that are subject to limits. It addresses two issues:<br><p>   - How are requests for this priority level limited?<br><p>   - What should be done with requests that exceed the limit?
+     */
     @JsonProperty("limitResponse")
     public LimitResponse getLimitResponse() {
         return limitResponse;
     }
 
+    /**
+     * LimitedPriorityLevelConfiguration specifies how to handle requests that are subject to limits. It addresses two issues:<br><p>   - How are requests for this priority level limited?<br><p>   - What should be done with requests that exceed the limit?
+     */
     @JsonProperty("limitResponse")
     public void setLimitResponse(LimitResponse limitResponse) {
         this.limitResponse = limitResponse;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/NonResourcePolicyRule.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/NonResourcePolicyRule.java
index 56013996da7..2da92ba5d3e 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/NonResourcePolicyRule.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/NonResourcePolicyRule.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NonResourcePolicyRule is a predicate that matches non-resource requests according to their verb and the target non-resource URL. A NonResourcePolicyRule matches a request if and only if both (a) at least one member of verbs matches the request and (b) at least one member of nonResourceURLs matches the request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public NonResourcePolicyRule(List<String> nonResourceURLs, List<String> verbs) {
         this.verbs = verbs;
     }
 
+    /**
+     * `nonResourceURLs` is a set of url prefixes that a user should have access to and may not be empty. For example:<br><p>   - "/healthz" is legal<br><p>   - "/hea&#42;" is illegal<br><p>   - "/hea" is legal but matches nothing<br><p>   - "/hea/&#42;" also matches nothing<br><p>   - "/healthz/&#42;" matches all per-component health checks.<br><p> "&#42;" matches all non-resource urls. if it is present, it must be the only entry. Required.
+     */
     @JsonProperty("nonResourceURLs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNonResourceURLs() {
         return nonResourceURLs;
     }
 
+    /**
+     * `nonResourceURLs` is a set of url prefixes that a user should have access to and may not be empty. For example:<br><p>   - "/healthz" is legal<br><p>   - "/hea&#42;" is illegal<br><p>   - "/hea" is legal but matches nothing<br><p>   - "/hea/&#42;" also matches nothing<br><p>   - "/healthz/&#42;" matches all per-component health checks.<br><p> "&#42;" matches all non-resource urls. if it is present, it must be the only entry. Required.
+     */
     @JsonProperty("nonResourceURLs")
     public void setNonResourceURLs(List<String> nonResourceURLs) {
         this.nonResourceURLs = nonResourceURLs;
     }
 
+    /**
+     * `verbs` is a list of matching verbs and may not be empty. "&#42;" matches all verbs. If it is present, it must be the only entry. Required.
+     */
     @JsonProperty("verbs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getVerbs() {
         return verbs;
     }
 
+    /**
+     * `verbs` is a list of matching verbs and may not be empty. "&#42;" matches all verbs. If it is present, it must be the only entry. Required.
+     */
     @JsonProperty("verbs")
     public void setVerbs(List<String> verbs) {
         this.verbs = verbs;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/PolicyRulesWithSubjects.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/PolicyRulesWithSubjects.java
index 6967ddfdd62..07bb3ffa4d1 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/PolicyRulesWithSubjects.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/PolicyRulesWithSubjects.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PolicyRulesWithSubjects prescribes a test that applies to a request to an apiserver. The test considers the subject making the request, the verb being requested, and the resource to be acted upon. This PolicyRulesWithSubjects matches a request if and only if both (a) at least one member of subjects matches the request and (b) at least one member of resourceRules or nonResourceRules matches the request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,34 +94,52 @@ public PolicyRulesWithSubjects(List<NonResourcePolicyRule> nonResourceRules, Lis
         this.subjects = subjects;
     }
 
+    /**
+     * `nonResourceRules` is a list of NonResourcePolicyRules that identify matching requests according to their verb and the target non-resource URL.
+     */
     @JsonProperty("nonResourceRules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NonResourcePolicyRule> getNonResourceRules() {
         return nonResourceRules;
     }
 
+    /**
+     * `nonResourceRules` is a list of NonResourcePolicyRules that identify matching requests according to their verb and the target non-resource URL.
+     */
     @JsonProperty("nonResourceRules")
     public void setNonResourceRules(List<NonResourcePolicyRule> nonResourceRules) {
         this.nonResourceRules = nonResourceRules;
     }
 
+    /**
+     * `resourceRules` is a slice of ResourcePolicyRules that identify matching requests according to their verb and the target resource. At least one of `resourceRules` and `nonResourceRules` has to be non-empty.
+     */
     @JsonProperty("resourceRules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ResourcePolicyRule> getResourceRules() {
         return resourceRules;
     }
 
+    /**
+     * `resourceRules` is a slice of ResourcePolicyRules that identify matching requests according to their verb and the target resource. At least one of `resourceRules` and `nonResourceRules` has to be non-empty.
+     */
     @JsonProperty("resourceRules")
     public void setResourceRules(List<ResourcePolicyRule> resourceRules) {
         this.resourceRules = resourceRules;
     }
 
+    /**
+     * subjects is the list of normal user, serviceaccount, or group that this rule cares about. There must be at least one member in this slice. A slice that includes both the system:authenticated and system:unauthenticated user groups matches every request. Required.
+     */
     @JsonProperty("subjects")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Subject> getSubjects() {
         return subjects;
     }
 
+    /**
+     * subjects is the list of normal user, serviceaccount, or group that this rule cares about. There must be at least one member in this slice. A slice that includes both the system:authenticated and system:unauthenticated user groups matches every request. Required.
+     */
     @JsonProperty("subjects")
     public void setSubjects(List<Subject> subjects) {
         this.subjects = subjects;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/PriorityLevelConfiguration.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/PriorityLevelConfiguration.java
index d5510c52108..8a54dcfbff3 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/PriorityLevelConfiguration.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/PriorityLevelConfiguration.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PriorityLevelConfiguration represents the configuration of a priority level.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class PriorityLevelConfiguration implements Editable<PriorityLevelConfigurationBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "flowcontrol.apiserver.k8s.io/v1beta2";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PriorityLevelConfiguration";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public PriorityLevelConfiguration(String apiVersion, String kind, ObjectMeta met
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PriorityLevelConfiguration represents the configuration of a priority level.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PriorityLevelConfiguration represents the configuration of a priority level.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PriorityLevelConfiguration represents the configuration of a priority level.
+     */
     @JsonProperty("spec")
     public PriorityLevelConfigurationSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PriorityLevelConfiguration represents the configuration of a priority level.
+     */
     @JsonProperty("spec")
     public void setSpec(PriorityLevelConfigurationSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PriorityLevelConfiguration represents the configuration of a priority level.
+     */
     @JsonProperty("status")
     public PriorityLevelConfigurationStatus getStatus() {
         return status;
     }
 
+    /**
+     * PriorityLevelConfiguration represents the configuration of a priority level.
+     */
     @JsonProperty("status")
     public void setStatus(PriorityLevelConfigurationStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/PriorityLevelConfigurationCondition.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/PriorityLevelConfigurationCondition.java
index 9a9c4a0adbf..cd9fd5d262d 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/PriorityLevelConfigurationCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/PriorityLevelConfigurationCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PriorityLevelConfigurationCondition defines the condition of priority level.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public PriorityLevelConfigurationCondition(String lastTransitionTime, String mes
         this.type = type;
     }
 
+    /**
+     * PriorityLevelConfigurationCondition defines the condition of priority level.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * PriorityLevelConfigurationCondition defines the condition of priority level.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * `message` is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * `message` is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * `reason` is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * `reason` is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * `status` is the status of the condition. Can be True, False, Unknown. Required.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * `status` is the status of the condition. Can be True, False, Unknown. Required.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * `type` is the type of the condition. Required.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * `type` is the type of the condition. Required.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/PriorityLevelConfigurationList.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/PriorityLevelConfigurationList.java
index 7974b269cf2..6c43c7bb929 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/PriorityLevelConfigurationList.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/PriorityLevelConfigurationList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PriorityLevelConfigurationList is a list of PriorityLevelConfiguration objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PriorityLevelConfigurationList implements Editable<PriorityLevelConfigurationListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.flowcontrol.v1beta2.PriorityLevelConfiguration>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "flowcontrol.apiserver.k8s.io/v1beta2";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.flowcontrol.v1beta2.PriorityLevelConfiguration> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PriorityLevelConfigurationList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PriorityLevelConfigurationList(String apiVersion, List<io.fabric8.kuberne
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * `items` is a list of request-priorities.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.flowcontrol.v1beta2.PriorityLevelConfiguration> getItems() {
         return items;
     }
 
+    /**
+     * `items` is a list of request-priorities.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.flowcontrol.v1beta2.PriorityLevelConfiguration> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PriorityLevelConfigurationList is a list of PriorityLevelConfiguration objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PriorityLevelConfigurationList is a list of PriorityLevelConfiguration objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/PriorityLevelConfigurationReference.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/PriorityLevelConfigurationReference.java
index 59e9ab6c135..f9b9829654b 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/PriorityLevelConfigurationReference.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/PriorityLevelConfigurationReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PriorityLevelConfigurationReference contains information that points to the "request-priority" being used.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public PriorityLevelConfigurationReference(String name) {
         this.name = name;
     }
 
+    /**
+     * `name` is the name of the priority level configuration being referenced Required.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * `name` is the name of the priority level configuration being referenced Required.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/PriorityLevelConfigurationSpec.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/PriorityLevelConfigurationSpec.java
index badbe1857b6..faa9c72b1dd 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/PriorityLevelConfigurationSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/PriorityLevelConfigurationSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PriorityLevelConfigurationSpec specifies the configuration of a priority level.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PriorityLevelConfigurationSpec(LimitedPriorityLevelConfiguration limited,
         this.type = type;
     }
 
+    /**
+     * PriorityLevelConfigurationSpec specifies the configuration of a priority level.
+     */
     @JsonProperty("limited")
     public LimitedPriorityLevelConfiguration getLimited() {
         return limited;
     }
 
+    /**
+     * PriorityLevelConfigurationSpec specifies the configuration of a priority level.
+     */
     @JsonProperty("limited")
     public void setLimited(LimitedPriorityLevelConfiguration limited) {
         this.limited = limited;
     }
 
+    /**
+     * `type` indicates whether this priority level is subject to limitation on request execution.  A value of `"Exempt"` means that requests of this priority level are not subject to a limit (and thus are never queued) and do not detract from the capacity made available to other priority levels.  A value of `"Limited"` means that (a) requests of this priority level _are_ subject to limits and (b) some of the server's limited capacity is made available exclusively to this priority level. Required.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * `type` indicates whether this priority level is subject to limitation on request execution.  A value of `"Exempt"` means that requests of this priority level are not subject to a limit (and thus are never queued) and do not detract from the capacity made available to other priority levels.  A value of `"Limited"` means that (a) requests of this priority level _are_ subject to limits and (b) some of the server's limited capacity is made available exclusively to this priority level. Required.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/PriorityLevelConfigurationStatus.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/PriorityLevelConfigurationStatus.java
index 410a8eabd21..3cf794701b6 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/PriorityLevelConfigurationStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/PriorityLevelConfigurationStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PriorityLevelConfigurationStatus represents the current state of a "request-priority".
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public PriorityLevelConfigurationStatus(List<PriorityLevelConfigurationCondition
         this.conditions = conditions;
     }
 
+    /**
+     * `conditions` is the current state of "request-priority".
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PriorityLevelConfigurationCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * `conditions` is the current state of "request-priority".
+     */
     @JsonProperty("conditions")
     public void setConditions(List<PriorityLevelConfigurationCondition> conditions) {
         this.conditions = conditions;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/QueuingConfiguration.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/QueuingConfiguration.java
index af60974584c..f00eaefd4f6 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/QueuingConfiguration.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/QueuingConfiguration.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * QueuingConfiguration holds the configuration parameters for queuing
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public QueuingConfiguration(Integer handSize, Integer queueLengthLimit, Integer
         this.queues = queues;
     }
 
+    /**
+     * `handSize` is a small positive number that configures the shuffle sharding of requests into queues.  When enqueuing a request at this priority level the request's flow identifier (a string pair) is hashed and the hash value is used to shuffle the list of queues and deal a hand of the size specified here.  The request is put into one of the shortest queues in that hand. `handSize` must be no larger than `queues`, and should be significantly smaller (so that a few heavy flows do not saturate most of the queues).  See the user-facing documentation for more extensive guidance on setting this field.  This field has a default value of 8.
+     */
     @JsonProperty("handSize")
     public Integer getHandSize() {
         return handSize;
     }
 
+    /**
+     * `handSize` is a small positive number that configures the shuffle sharding of requests into queues.  When enqueuing a request at this priority level the request's flow identifier (a string pair) is hashed and the hash value is used to shuffle the list of queues and deal a hand of the size specified here.  The request is put into one of the shortest queues in that hand. `handSize` must be no larger than `queues`, and should be significantly smaller (so that a few heavy flows do not saturate most of the queues).  See the user-facing documentation for more extensive guidance on setting this field.  This field has a default value of 8.
+     */
     @JsonProperty("handSize")
     public void setHandSize(Integer handSize) {
         this.handSize = handSize;
     }
 
+    /**
+     * `queueLengthLimit` is the maximum number of requests allowed to be waiting in a given queue of this priority level at a time; excess requests are rejected.  This value must be positive.  If not specified, it will be defaulted to 50.
+     */
     @JsonProperty("queueLengthLimit")
     public Integer getQueueLengthLimit() {
         return queueLengthLimit;
     }
 
+    /**
+     * `queueLengthLimit` is the maximum number of requests allowed to be waiting in a given queue of this priority level at a time; excess requests are rejected.  This value must be positive.  If not specified, it will be defaulted to 50.
+     */
     @JsonProperty("queueLengthLimit")
     public void setQueueLengthLimit(Integer queueLengthLimit) {
         this.queueLengthLimit = queueLengthLimit;
     }
 
+    /**
+     * `queues` is the number of queues for this priority level. The queues exist independently at each apiserver. The value must be positive.  Setting it to 1 effectively precludes shufflesharding and thus makes the distinguisher method of associated flow schemas irrelevant.  This field has a default value of 64.
+     */
     @JsonProperty("queues")
     public Integer getQueues() {
         return queues;
     }
 
+    /**
+     * `queues` is the number of queues for this priority level. The queues exist independently at each apiserver. The value must be positive.  Setting it to 1 effectively precludes shufflesharding and thus makes the distinguisher method of associated flow schemas irrelevant.  This field has a default value of 64.
+     */
     @JsonProperty("queues")
     public void setQueues(Integer queues) {
         this.queues = queues;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/ResourcePolicyRule.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/ResourcePolicyRule.java
index 5ee60302b8a..fb4e0d5000d 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/ResourcePolicyRule.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/ResourcePolicyRule.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourcePolicyRule is a predicate that matches some resource requests, testing the request's verb and the target resource. A ResourcePolicyRule matches a resource request if and only if: (a) at least one member of verbs matches the request, (b) at least one member of apiGroups matches the request, (c) at least one member of resources matches the request, and (d) either (d1) the request does not specify a namespace (i.e., `Namespace==""`) and clusterScope is true or (d2) the request specifies a namespace and least one member of namespaces matches the request's namespace.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -100,55 +103,85 @@ public ResourcePolicyRule(List<String> apiGroups, Boolean clusterScope, List<Str
         this.verbs = verbs;
     }
 
+    /**
+     * `apiGroups` is a list of matching API groups and may not be empty. "&#42;" matches all API groups and, if present, must be the only entry. Required.
+     */
     @JsonProperty("apiGroups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiGroups() {
         return apiGroups;
     }
 
+    /**
+     * `apiGroups` is a list of matching API groups and may not be empty. "&#42;" matches all API groups and, if present, must be the only entry. Required.
+     */
     @JsonProperty("apiGroups")
     public void setApiGroups(List<String> apiGroups) {
         this.apiGroups = apiGroups;
     }
 
+    /**
+     * `clusterScope` indicates whether to match requests that do not specify a namespace (which happens either because the resource is not namespaced or the request targets all namespaces). If this field is omitted or false then the `namespaces` field must contain a non-empty list.
+     */
     @JsonProperty("clusterScope")
     public Boolean getClusterScope() {
         return clusterScope;
     }
 
+    /**
+     * `clusterScope` indicates whether to match requests that do not specify a namespace (which happens either because the resource is not namespaced or the request targets all namespaces). If this field is omitted or false then the `namespaces` field must contain a non-empty list.
+     */
     @JsonProperty("clusterScope")
     public void setClusterScope(Boolean clusterScope) {
         this.clusterScope = clusterScope;
     }
 
+    /**
+     * `namespaces` is a list of target namespaces that restricts matches.  A request that specifies a target namespace matches only if either (a) this list contains that target namespace or (b) this list contains "&#42;".  Note that "&#42;" matches any specified namespace but does not match a request that _does not specify_ a namespace (see the `clusterScope` field for that). This list may be empty, but only if `clusterScope` is true.
+     */
     @JsonProperty("namespaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNamespaces() {
         return namespaces;
     }
 
+    /**
+     * `namespaces` is a list of target namespaces that restricts matches.  A request that specifies a target namespace matches only if either (a) this list contains that target namespace or (b) this list contains "&#42;".  Note that "&#42;" matches any specified namespace but does not match a request that _does not specify_ a namespace (see the `clusterScope` field for that). This list may be empty, but only if `clusterScope` is true.
+     */
     @JsonProperty("namespaces")
     public void setNamespaces(List<String> namespaces) {
         this.namespaces = namespaces;
     }
 
+    /**
+     * `resources` is a list of matching resources (i.e., lowercase and plural) with, if desired, subresource.  For example, [ "services", "nodes/status" ].  This list may not be empty. "&#42;" matches all resources and, if present, must be the only entry. Required.
+     */
     @JsonProperty("resources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getResources() {
         return resources;
     }
 
+    /**
+     * `resources` is a list of matching resources (i.e., lowercase and plural) with, if desired, subresource.  For example, [ "services", "nodes/status" ].  This list may not be empty. "&#42;" matches all resources and, if present, must be the only entry. Required.
+     */
     @JsonProperty("resources")
     public void setResources(List<String> resources) {
         this.resources = resources;
     }
 
+    /**
+     * `verbs` is a list of matching verbs and may not be empty. "&#42;" matches all verbs and, if present, must be the only entry. Required.
+     */
     @JsonProperty("verbs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getVerbs() {
         return verbs;
     }
 
+    /**
+     * `verbs` is a list of matching verbs and may not be empty. "&#42;" matches all verbs and, if present, must be the only entry. Required.
+     */
     @JsonProperty("verbs")
     public void setVerbs(List<String> verbs) {
         this.verbs = verbs;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/ServiceAccountSubject.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/ServiceAccountSubject.java
index fad075d4dcd..813e9861470 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/ServiceAccountSubject.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/ServiceAccountSubject.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceAccountSubject holds detailed information for service-account-kind subject.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ServiceAccountSubject(String name, String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * `name` is the name of matching ServiceAccount objects, or "&#42;" to match regardless of name. Required.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * `name` is the name of matching ServiceAccount objects, or "&#42;" to match regardless of name. Required.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * `namespace` is the namespace of matching ServiceAccount objects. Required.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * `namespace` is the namespace of matching ServiceAccount objects. Required.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/Subject.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/Subject.java
index 55db3794b23..cccbd604f3f 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/Subject.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/Subject.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public Subject(GroupSubject group, String kind, ServiceAccountSubject serviceAcc
         this.user = user;
     }
 
+    /**
+     * Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account.
+     */
     @JsonProperty("group")
     public GroupSubject getGroup() {
         return group;
     }
 
+    /**
+     * Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account.
+     */
     @JsonProperty("group")
     public void setGroup(GroupSubject group) {
         this.group = group;
     }
 
+    /**
+     * `kind` indicates which one of the other fields is non-empty. Required
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * `kind` indicates which one of the other fields is non-empty. Required
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account.
+     */
     @JsonProperty("serviceAccount")
     public ServiceAccountSubject getServiceAccount() {
         return serviceAccount;
     }
 
+    /**
+     * Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account.
+     */
     @JsonProperty("serviceAccount")
     public void setServiceAccount(ServiceAccountSubject serviceAccount) {
         this.serviceAccount = serviceAccount;
     }
 
+    /**
+     * Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account.
+     */
     @JsonProperty("user")
     public UserSubject getUser() {
         return user;
     }
 
+    /**
+     * Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account.
+     */
     @JsonProperty("user")
     public void setUser(UserSubject user) {
         this.user = user;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/UserSubject.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/UserSubject.java
index 2a25e028112..e0b85ef48e1 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/UserSubject.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta2/UserSubject.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UserSubject holds detailed information for user-kind subject.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public UserSubject(String name) {
         this.name = name;
     }
 
+    /**
+     * `name` is the username that matches, or "&#42;" to match all usernames. Required.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * `name` is the username that matches, or "&#42;" to match all usernames. Required.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/FlowDistinguisherMethod.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/FlowDistinguisherMethod.java
index d3b761950e9..7463ca72e03 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/FlowDistinguisherMethod.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/FlowDistinguisherMethod.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FlowDistinguisherMethod specifies the method of a flow distinguisher.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public FlowDistinguisherMethod(String type) {
         this.type = type;
     }
 
+    /**
+     * `type` is the type of flow distinguisher method The supported types are "ByUser" and "ByNamespace". Required.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * `type` is the type of flow distinguisher method The supported types are "ByUser" and "ByNamespace". Required.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/FlowSchema.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/FlowSchema.java
index 60572dff8a0..17219b63118 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/FlowSchema.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/FlowSchema.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class FlowSchema implements Editable<FlowSchemaBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "flowcontrol.apiserver.k8s.io/v1beta3";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "FlowSchema";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public FlowSchema(String apiVersion, String kind, ObjectMeta metadata, FlowSchem
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".
+     */
     @JsonProperty("spec")
     public FlowSchemaSpec getSpec() {
         return spec;
     }
 
+    /**
+     * FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".
+     */
     @JsonProperty("spec")
     public void setSpec(FlowSchemaSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".
+     */
     @JsonProperty("status")
     public FlowSchemaStatus getStatus() {
         return status;
     }
 
+    /**
+     * FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".
+     */
     @JsonProperty("status")
     public void setStatus(FlowSchemaStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/FlowSchemaCondition.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/FlowSchemaCondition.java
index 71f9409f5c7..d59838b4021 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/FlowSchemaCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/FlowSchemaCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FlowSchemaCondition describes conditions for a FlowSchema.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public FlowSchemaCondition(String lastTransitionTime, String message, String rea
         this.type = type;
     }
 
+    /**
+     * FlowSchemaCondition describes conditions for a FlowSchema.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * FlowSchemaCondition describes conditions for a FlowSchema.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * `message` is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * `message` is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * `reason` is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * `reason` is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * `status` is the status of the condition. Can be True, False, Unknown. Required.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * `status` is the status of the condition. Can be True, False, Unknown. Required.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * `type` is the type of the condition. Required.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * `type` is the type of the condition. Required.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/FlowSchemaList.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/FlowSchemaList.java
index 73dd55d21b5..d6e2aabb935 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/FlowSchemaList.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/FlowSchemaList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FlowSchemaList is a list of FlowSchema objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class FlowSchemaList implements Editable<FlowSchemaListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.flowcontrol.v1beta3.FlowSchema>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "flowcontrol.apiserver.k8s.io/v1beta3";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.flowcontrol.v1beta3.FlowSchema> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "FlowSchemaList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public FlowSchemaList(String apiVersion, List<io.fabric8.kubernetes.api.model.fl
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * `items` is a list of FlowSchemas.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.flowcontrol.v1beta3.FlowSchema> getItems() {
         return items;
     }
 
+    /**
+     * `items` is a list of FlowSchemas.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.flowcontrol.v1beta3.FlowSchema> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * FlowSchemaList is a list of FlowSchema objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * FlowSchemaList is a list of FlowSchema objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/FlowSchemaSpec.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/FlowSchemaSpec.java
index 336393b98d1..dfb285a32e6 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/FlowSchemaSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/FlowSchemaSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FlowSchemaSpec describes how the FlowSchema's specification looks like.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public FlowSchemaSpec(FlowDistinguisherMethod distinguisherMethod, Integer match
         this.rules = rules;
     }
 
+    /**
+     * FlowSchemaSpec describes how the FlowSchema's specification looks like.
+     */
     @JsonProperty("distinguisherMethod")
     public FlowDistinguisherMethod getDistinguisherMethod() {
         return distinguisherMethod;
     }
 
+    /**
+     * FlowSchemaSpec describes how the FlowSchema's specification looks like.
+     */
     @JsonProperty("distinguisherMethod")
     public void setDistinguisherMethod(FlowDistinguisherMethod distinguisherMethod) {
         this.distinguisherMethod = distinguisherMethod;
     }
 
+    /**
+     * `matchingPrecedence` is used to choose among the FlowSchemas that match a given request. The chosen FlowSchema is among those with the numerically lowest (which we take to be logically highest) MatchingPrecedence.  Each MatchingPrecedence value must be ranged in [1,10000]. Note that if the precedence is not specified, it will be set to 1000 as default.
+     */
     @JsonProperty("matchingPrecedence")
     public Integer getMatchingPrecedence() {
         return matchingPrecedence;
     }
 
+    /**
+     * `matchingPrecedence` is used to choose among the FlowSchemas that match a given request. The chosen FlowSchema is among those with the numerically lowest (which we take to be logically highest) MatchingPrecedence.  Each MatchingPrecedence value must be ranged in [1,10000]. Note that if the precedence is not specified, it will be set to 1000 as default.
+     */
     @JsonProperty("matchingPrecedence")
     public void setMatchingPrecedence(Integer matchingPrecedence) {
         this.matchingPrecedence = matchingPrecedence;
     }
 
+    /**
+     * FlowSchemaSpec describes how the FlowSchema's specification looks like.
+     */
     @JsonProperty("priorityLevelConfiguration")
     public PriorityLevelConfigurationReference getPriorityLevelConfiguration() {
         return priorityLevelConfiguration;
     }
 
+    /**
+     * FlowSchemaSpec describes how the FlowSchema's specification looks like.
+     */
     @JsonProperty("priorityLevelConfiguration")
     public void setPriorityLevelConfiguration(PriorityLevelConfigurationReference priorityLevelConfiguration) {
         this.priorityLevelConfiguration = priorityLevelConfiguration;
     }
 
+    /**
+     * `rules` describes which requests will match this flow schema. This FlowSchema matches a request if and only if at least one member of rules matches the request. if it is an empty slice, there will be no requests matching the FlowSchema.
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PolicyRulesWithSubjects> getRules() {
         return rules;
     }
 
+    /**
+     * `rules` describes which requests will match this flow schema. This FlowSchema matches a request if and only if at least one member of rules matches the request. if it is an empty slice, there will be no requests matching the FlowSchema.
+     */
     @JsonProperty("rules")
     public void setRules(List<PolicyRulesWithSubjects> rules) {
         this.rules = rules;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/FlowSchemaStatus.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/FlowSchemaStatus.java
index c41c8f69555..bc2536feafa 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/FlowSchemaStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/FlowSchemaStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FlowSchemaStatus represents the current state of a FlowSchema.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public FlowSchemaStatus(List<FlowSchemaCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * `conditions` is a list of the current states of FlowSchema.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<FlowSchemaCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * `conditions` is a list of the current states of FlowSchema.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<FlowSchemaCondition> conditions) {
         this.conditions = conditions;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/GroupSubject.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/GroupSubject.java
index b0c645b208b..67f051c9a95 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/GroupSubject.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/GroupSubject.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GroupSubject holds detailed information for group-kind subject.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public GroupSubject(String name) {
         this.name = name;
     }
 
+    /**
+     * name is the user group that matches, or "&#42;" to match all user groups. See https://github.com/kubernetes/apiserver/blob/master/pkg/authentication/user/user.go for some well-known group names. Required.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the user group that matches, or "&#42;" to match all user groups. See https://github.com/kubernetes/apiserver/blob/master/pkg/authentication/user/user.go for some well-known group names. Required.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/LimitResponse.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/LimitResponse.java
index 7311cc6cca9..f512a359668 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/LimitResponse.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/LimitResponse.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LimitResponse defines how to handle requests that can not be executed right now.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public LimitResponse(QueuingConfiguration queuing, String type) {
         this.type = type;
     }
 
+    /**
+     * LimitResponse defines how to handle requests that can not be executed right now.
+     */
     @JsonProperty("queuing")
     public QueuingConfiguration getQueuing() {
         return queuing;
     }
 
+    /**
+     * LimitResponse defines how to handle requests that can not be executed right now.
+     */
     @JsonProperty("queuing")
     public void setQueuing(QueuingConfiguration queuing) {
         this.queuing = queuing;
     }
 
+    /**
+     * `type` is "Queue" or "Reject". "Queue" means that requests that can not be executed upon arrival are held in a queue until they can be executed or a queuing limit is reached. "Reject" means that requests that can not be executed upon arrival are rejected. Required.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * `type` is "Queue" or "Reject". "Queue" means that requests that can not be executed upon arrival are held in a queue until they can be executed or a queuing limit is reached. "Reject" means that requests that can not be executed upon arrival are rejected. Required.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/LimitedPriorityLevelConfiguration.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/LimitedPriorityLevelConfiguration.java
index 4227e2d1215..196e572fa07 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/LimitedPriorityLevelConfiguration.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/LimitedPriorityLevelConfiguration.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LimitedPriorityLevelConfiguration specifies how to handle requests that are subject to limits. It addresses two issues:<br><p>   - How are requests for this priority level limited?<br><p>   - What should be done with requests that exceed the limit?
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public LimitedPriorityLevelConfiguration(Integer borrowingLimitPercent, Integer
         this.nominalConcurrencyShares = nominalConcurrencyShares;
     }
 
+    /**
+     * `borrowingLimitPercent`, if present, configures a limit on how many seats this priority level can borrow from other priority levels. The limit is known as this level's BorrowingConcurrencyLimit (BorrowingCL) and is a limit on the total number of seats that this level may borrow at any one time. This field holds the ratio of that limit to the level's nominal concurrency limit. When this field is non-nil, it must hold a non-negative integer and the limit is calculated as follows.<br><p> <br><p> BorrowingCL(i) = round( NominalCL(i) &#42; borrowingLimitPercent(i)/100.0 )<br><p> <br><p> The value of this field can be more than 100, implying that this priority level can borrow a number of seats that is greater than its own nominal concurrency limit (NominalCL). When this field is left `nil`, the limit is effectively infinite.
+     */
     @JsonProperty("borrowingLimitPercent")
     public Integer getBorrowingLimitPercent() {
         return borrowingLimitPercent;
     }
 
+    /**
+     * `borrowingLimitPercent`, if present, configures a limit on how many seats this priority level can borrow from other priority levels. The limit is known as this level's BorrowingConcurrencyLimit (BorrowingCL) and is a limit on the total number of seats that this level may borrow at any one time. This field holds the ratio of that limit to the level's nominal concurrency limit. When this field is non-nil, it must hold a non-negative integer and the limit is calculated as follows.<br><p> <br><p> BorrowingCL(i) = round( NominalCL(i) &#42; borrowingLimitPercent(i)/100.0 )<br><p> <br><p> The value of this field can be more than 100, implying that this priority level can borrow a number of seats that is greater than its own nominal concurrency limit (NominalCL). When this field is left `nil`, the limit is effectively infinite.
+     */
     @JsonProperty("borrowingLimitPercent")
     public void setBorrowingLimitPercent(Integer borrowingLimitPercent) {
         this.borrowingLimitPercent = borrowingLimitPercent;
     }
 
+    /**
+     * `lendablePercent` prescribes the fraction of the level's NominalCL that can be borrowed by other priority levels. The value of this field must be between 0 and 100, inclusive, and it defaults to 0. The number of seats that other levels can borrow from this level, known as this level's LendableConcurrencyLimit (LendableCL), is defined as follows.<br><p> <br><p> LendableCL(i) = round( NominalCL(i) &#42; lendablePercent(i)/100.0 )
+     */
     @JsonProperty("lendablePercent")
     public Integer getLendablePercent() {
         return lendablePercent;
     }
 
+    /**
+     * `lendablePercent` prescribes the fraction of the level's NominalCL that can be borrowed by other priority levels. The value of this field must be between 0 and 100, inclusive, and it defaults to 0. The number of seats that other levels can borrow from this level, known as this level's LendableConcurrencyLimit (LendableCL), is defined as follows.<br><p> <br><p> LendableCL(i) = round( NominalCL(i) &#42; lendablePercent(i)/100.0 )
+     */
     @JsonProperty("lendablePercent")
     public void setLendablePercent(Integer lendablePercent) {
         this.lendablePercent = lendablePercent;
     }
 
+    /**
+     * LimitedPriorityLevelConfiguration specifies how to handle requests that are subject to limits. It addresses two issues:<br><p>   - How are requests for this priority level limited?<br><p>   - What should be done with requests that exceed the limit?
+     */
     @JsonProperty("limitResponse")
     public LimitResponse getLimitResponse() {
         return limitResponse;
     }
 
+    /**
+     * LimitedPriorityLevelConfiguration specifies how to handle requests that are subject to limits. It addresses two issues:<br><p>   - How are requests for this priority level limited?<br><p>   - What should be done with requests that exceed the limit?
+     */
     @JsonProperty("limitResponse")
     public void setLimitResponse(LimitResponse limitResponse) {
         this.limitResponse = limitResponse;
     }
 
+    /**
+     * `nominalConcurrencyShares` (NCS) contributes to the computation of the NominalConcurrencyLimit (NominalCL) of this level. This is the number of execution seats available at this priority level. This is used both for requests dispatched from this priority level as well as requests dispatched from other priority levels borrowing seats from this level. The server's concurrency limit (ServerCL) is divided among the Limited priority levels in proportion to their NCS values:<br><p> <br><p> NominalCL(i)  = ceil( ServerCL &#42; NCS(i) / sum_ncs ) sum_ncs = sum[limited priority level k] NCS(k)<br><p> <br><p> Bigger numbers mean a larger nominal concurrency limit, at the expense of every other Limited priority level. This field has a default value of 30.
+     */
     @JsonProperty("nominalConcurrencyShares")
     public Integer getNominalConcurrencyShares() {
         return nominalConcurrencyShares;
     }
 
+    /**
+     * `nominalConcurrencyShares` (NCS) contributes to the computation of the NominalConcurrencyLimit (NominalCL) of this level. This is the number of execution seats available at this priority level. This is used both for requests dispatched from this priority level as well as requests dispatched from other priority levels borrowing seats from this level. The server's concurrency limit (ServerCL) is divided among the Limited priority levels in proportion to their NCS values:<br><p> <br><p> NominalCL(i)  = ceil( ServerCL &#42; NCS(i) / sum_ncs ) sum_ncs = sum[limited priority level k] NCS(k)<br><p> <br><p> Bigger numbers mean a larger nominal concurrency limit, at the expense of every other Limited priority level. This field has a default value of 30.
+     */
     @JsonProperty("nominalConcurrencyShares")
     public void setNominalConcurrencyShares(Integer nominalConcurrencyShares) {
         this.nominalConcurrencyShares = nominalConcurrencyShares;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/NonResourcePolicyRule.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/NonResourcePolicyRule.java
index f1b759276b8..0f79db4a76c 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/NonResourcePolicyRule.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/NonResourcePolicyRule.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NonResourcePolicyRule is a predicate that matches non-resource requests according to their verb and the target non-resource URL. A NonResourcePolicyRule matches a request if and only if both (a) at least one member of verbs matches the request and (b) at least one member of nonResourceURLs matches the request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public NonResourcePolicyRule(List<String> nonResourceURLs, List<String> verbs) {
         this.verbs = verbs;
     }
 
+    /**
+     * `nonResourceURLs` is a set of url prefixes that a user should have access to and may not be empty. For example:<br><p>   - "/healthz" is legal<br><p>   - "/hea&#42;" is illegal<br><p>   - "/hea" is legal but matches nothing<br><p>   - "/hea/&#42;" also matches nothing<br><p>   - "/healthz/&#42;" matches all per-component health checks.<br><p> "&#42;" matches all non-resource urls. if it is present, it must be the only entry. Required.
+     */
     @JsonProperty("nonResourceURLs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNonResourceURLs() {
         return nonResourceURLs;
     }
 
+    /**
+     * `nonResourceURLs` is a set of url prefixes that a user should have access to and may not be empty. For example:<br><p>   - "/healthz" is legal<br><p>   - "/hea&#42;" is illegal<br><p>   - "/hea" is legal but matches nothing<br><p>   - "/hea/&#42;" also matches nothing<br><p>   - "/healthz/&#42;" matches all per-component health checks.<br><p> "&#42;" matches all non-resource urls. if it is present, it must be the only entry. Required.
+     */
     @JsonProperty("nonResourceURLs")
     public void setNonResourceURLs(List<String> nonResourceURLs) {
         this.nonResourceURLs = nonResourceURLs;
     }
 
+    /**
+     * `verbs` is a list of matching verbs and may not be empty. "&#42;" matches all verbs. If it is present, it must be the only entry. Required.
+     */
     @JsonProperty("verbs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getVerbs() {
         return verbs;
     }
 
+    /**
+     * `verbs` is a list of matching verbs and may not be empty. "&#42;" matches all verbs. If it is present, it must be the only entry. Required.
+     */
     @JsonProperty("verbs")
     public void setVerbs(List<String> verbs) {
         this.verbs = verbs;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/PolicyRulesWithSubjects.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/PolicyRulesWithSubjects.java
index b57c5ef6bfb..c914a676427 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/PolicyRulesWithSubjects.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/PolicyRulesWithSubjects.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PolicyRulesWithSubjects prescribes a test that applies to a request to an apiserver. The test considers the subject making the request, the verb being requested, and the resource to be acted upon. This PolicyRulesWithSubjects matches a request if and only if both (a) at least one member of subjects matches the request and (b) at least one member of resourceRules or nonResourceRules matches the request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,34 +94,52 @@ public PolicyRulesWithSubjects(List<NonResourcePolicyRule> nonResourceRules, Lis
         this.subjects = subjects;
     }
 
+    /**
+     * `nonResourceRules` is a list of NonResourcePolicyRules that identify matching requests according to their verb and the target non-resource URL.
+     */
     @JsonProperty("nonResourceRules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NonResourcePolicyRule> getNonResourceRules() {
         return nonResourceRules;
     }
 
+    /**
+     * `nonResourceRules` is a list of NonResourcePolicyRules that identify matching requests according to their verb and the target non-resource URL.
+     */
     @JsonProperty("nonResourceRules")
     public void setNonResourceRules(List<NonResourcePolicyRule> nonResourceRules) {
         this.nonResourceRules = nonResourceRules;
     }
 
+    /**
+     * `resourceRules` is a slice of ResourcePolicyRules that identify matching requests according to their verb and the target resource. At least one of `resourceRules` and `nonResourceRules` has to be non-empty.
+     */
     @JsonProperty("resourceRules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ResourcePolicyRule> getResourceRules() {
         return resourceRules;
     }
 
+    /**
+     * `resourceRules` is a slice of ResourcePolicyRules that identify matching requests according to their verb and the target resource. At least one of `resourceRules` and `nonResourceRules` has to be non-empty.
+     */
     @JsonProperty("resourceRules")
     public void setResourceRules(List<ResourcePolicyRule> resourceRules) {
         this.resourceRules = resourceRules;
     }
 
+    /**
+     * subjects is the list of normal user, serviceaccount, or group that this rule cares about. There must be at least one member in this slice. A slice that includes both the system:authenticated and system:unauthenticated user groups matches every request. Required.
+     */
     @JsonProperty("subjects")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Subject> getSubjects() {
         return subjects;
     }
 
+    /**
+     * subjects is the list of normal user, serviceaccount, or group that this rule cares about. There must be at least one member in this slice. A slice that includes both the system:authenticated and system:unauthenticated user groups matches every request. Required.
+     */
     @JsonProperty("subjects")
     public void setSubjects(List<Subject> subjects) {
         this.subjects = subjects;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/PriorityLevelConfiguration.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/PriorityLevelConfiguration.java
index 30b08eb08b4..fc2d4178eaa 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/PriorityLevelConfiguration.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/PriorityLevelConfiguration.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PriorityLevelConfiguration represents the configuration of a priority level.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class PriorityLevelConfiguration implements Editable<PriorityLevelConfigurationBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "flowcontrol.apiserver.k8s.io/v1beta3";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PriorityLevelConfiguration";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public PriorityLevelConfiguration(String apiVersion, String kind, ObjectMeta met
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PriorityLevelConfiguration represents the configuration of a priority level.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PriorityLevelConfiguration represents the configuration of a priority level.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PriorityLevelConfiguration represents the configuration of a priority level.
+     */
     @JsonProperty("spec")
     public PriorityLevelConfigurationSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PriorityLevelConfiguration represents the configuration of a priority level.
+     */
     @JsonProperty("spec")
     public void setSpec(PriorityLevelConfigurationSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PriorityLevelConfiguration represents the configuration of a priority level.
+     */
     @JsonProperty("status")
     public PriorityLevelConfigurationStatus getStatus() {
         return status;
     }
 
+    /**
+     * PriorityLevelConfiguration represents the configuration of a priority level.
+     */
     @JsonProperty("status")
     public void setStatus(PriorityLevelConfigurationStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/PriorityLevelConfigurationCondition.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/PriorityLevelConfigurationCondition.java
index 566b716bd04..91447bdc9a2 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/PriorityLevelConfigurationCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/PriorityLevelConfigurationCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PriorityLevelConfigurationCondition defines the condition of priority level.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public PriorityLevelConfigurationCondition(String lastTransitionTime, String mes
         this.type = type;
     }
 
+    /**
+     * PriorityLevelConfigurationCondition defines the condition of priority level.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * PriorityLevelConfigurationCondition defines the condition of priority level.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * `message` is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * `message` is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * `reason` is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * `reason` is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * `status` is the status of the condition. Can be True, False, Unknown. Required.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * `status` is the status of the condition. Can be True, False, Unknown. Required.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * `type` is the type of the condition. Required.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * `type` is the type of the condition. Required.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/PriorityLevelConfigurationList.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/PriorityLevelConfigurationList.java
index 10aa83f2d93..93a77619d16 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/PriorityLevelConfigurationList.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/PriorityLevelConfigurationList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PriorityLevelConfigurationList is a list of PriorityLevelConfiguration objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PriorityLevelConfigurationList implements Editable<PriorityLevelConfigurationListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.flowcontrol.v1beta3.PriorityLevelConfiguration>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "flowcontrol.apiserver.k8s.io/v1beta3";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.flowcontrol.v1beta3.PriorityLevelConfiguration> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PriorityLevelConfigurationList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PriorityLevelConfigurationList(String apiVersion, List<io.fabric8.kuberne
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * `items` is a list of request-priorities.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.flowcontrol.v1beta3.PriorityLevelConfiguration> getItems() {
         return items;
     }
 
+    /**
+     * `items` is a list of request-priorities.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.flowcontrol.v1beta3.PriorityLevelConfiguration> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PriorityLevelConfigurationList is a list of PriorityLevelConfiguration objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PriorityLevelConfigurationList is a list of PriorityLevelConfiguration objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/PriorityLevelConfigurationReference.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/PriorityLevelConfigurationReference.java
index 395f8bd8b5a..1cca91e0e09 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/PriorityLevelConfigurationReference.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/PriorityLevelConfigurationReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PriorityLevelConfigurationReference contains information that points to the "request-priority" being used.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public PriorityLevelConfigurationReference(String name) {
         this.name = name;
     }
 
+    /**
+     * `name` is the name of the priority level configuration being referenced Required.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * `name` is the name of the priority level configuration being referenced Required.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/PriorityLevelConfigurationSpec.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/PriorityLevelConfigurationSpec.java
index 8ad1eb6d1db..2b06721442b 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/PriorityLevelConfigurationSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/PriorityLevelConfigurationSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PriorityLevelConfigurationSpec specifies the configuration of a priority level.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PriorityLevelConfigurationSpec(LimitedPriorityLevelConfiguration limited,
         this.type = type;
     }
 
+    /**
+     * PriorityLevelConfigurationSpec specifies the configuration of a priority level.
+     */
     @JsonProperty("limited")
     public LimitedPriorityLevelConfiguration getLimited() {
         return limited;
     }
 
+    /**
+     * PriorityLevelConfigurationSpec specifies the configuration of a priority level.
+     */
     @JsonProperty("limited")
     public void setLimited(LimitedPriorityLevelConfiguration limited) {
         this.limited = limited;
     }
 
+    /**
+     * `type` indicates whether this priority level is subject to limitation on request execution.  A value of `"Exempt"` means that requests of this priority level are not subject to a limit (and thus are never queued) and do not detract from the capacity made available to other priority levels.  A value of `"Limited"` means that (a) requests of this priority level _are_ subject to limits and (b) some of the server's limited capacity is made available exclusively to this priority level. Required.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * `type` indicates whether this priority level is subject to limitation on request execution.  A value of `"Exempt"` means that requests of this priority level are not subject to a limit (and thus are never queued) and do not detract from the capacity made available to other priority levels.  A value of `"Limited"` means that (a) requests of this priority level _are_ subject to limits and (b) some of the server's limited capacity is made available exclusively to this priority level. Required.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/PriorityLevelConfigurationStatus.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/PriorityLevelConfigurationStatus.java
index b1dd94c63b5..b0e4c2b60f3 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/PriorityLevelConfigurationStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/PriorityLevelConfigurationStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PriorityLevelConfigurationStatus represents the current state of a "request-priority".
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public PriorityLevelConfigurationStatus(List<PriorityLevelConfigurationCondition
         this.conditions = conditions;
     }
 
+    /**
+     * `conditions` is the current state of "request-priority".
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PriorityLevelConfigurationCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * `conditions` is the current state of "request-priority".
+     */
     @JsonProperty("conditions")
     public void setConditions(List<PriorityLevelConfigurationCondition> conditions) {
         this.conditions = conditions;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/QueuingConfiguration.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/QueuingConfiguration.java
index 298a9a685d7..e226ba97f9e 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/QueuingConfiguration.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/QueuingConfiguration.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * QueuingConfiguration holds the configuration parameters for queuing
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public QueuingConfiguration(Integer handSize, Integer queueLengthLimit, Integer
         this.queues = queues;
     }
 
+    /**
+     * `handSize` is a small positive number that configures the shuffle sharding of requests into queues.  When enqueuing a request at this priority level the request's flow identifier (a string pair) is hashed and the hash value is used to shuffle the list of queues and deal a hand of the size specified here.  The request is put into one of the shortest queues in that hand. `handSize` must be no larger than `queues`, and should be significantly smaller (so that a few heavy flows do not saturate most of the queues).  See the user-facing documentation for more extensive guidance on setting this field.  This field has a default value of 8.
+     */
     @JsonProperty("handSize")
     public Integer getHandSize() {
         return handSize;
     }
 
+    /**
+     * `handSize` is a small positive number that configures the shuffle sharding of requests into queues.  When enqueuing a request at this priority level the request's flow identifier (a string pair) is hashed and the hash value is used to shuffle the list of queues and deal a hand of the size specified here.  The request is put into one of the shortest queues in that hand. `handSize` must be no larger than `queues`, and should be significantly smaller (so that a few heavy flows do not saturate most of the queues).  See the user-facing documentation for more extensive guidance on setting this field.  This field has a default value of 8.
+     */
     @JsonProperty("handSize")
     public void setHandSize(Integer handSize) {
         this.handSize = handSize;
     }
 
+    /**
+     * `queueLengthLimit` is the maximum number of requests allowed to be waiting in a given queue of this priority level at a time; excess requests are rejected.  This value must be positive.  If not specified, it will be defaulted to 50.
+     */
     @JsonProperty("queueLengthLimit")
     public Integer getQueueLengthLimit() {
         return queueLengthLimit;
     }
 
+    /**
+     * `queueLengthLimit` is the maximum number of requests allowed to be waiting in a given queue of this priority level at a time; excess requests are rejected.  This value must be positive.  If not specified, it will be defaulted to 50.
+     */
     @JsonProperty("queueLengthLimit")
     public void setQueueLengthLimit(Integer queueLengthLimit) {
         this.queueLengthLimit = queueLengthLimit;
     }
 
+    /**
+     * `queues` is the number of queues for this priority level. The queues exist independently at each apiserver. The value must be positive.  Setting it to 1 effectively precludes shufflesharding and thus makes the distinguisher method of associated flow schemas irrelevant.  This field has a default value of 64.
+     */
     @JsonProperty("queues")
     public Integer getQueues() {
         return queues;
     }
 
+    /**
+     * `queues` is the number of queues for this priority level. The queues exist independently at each apiserver. The value must be positive.  Setting it to 1 effectively precludes shufflesharding and thus makes the distinguisher method of associated flow schemas irrelevant.  This field has a default value of 64.
+     */
     @JsonProperty("queues")
     public void setQueues(Integer queues) {
         this.queues = queues;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/ResourcePolicyRule.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/ResourcePolicyRule.java
index c76b03c52ed..197eaf87bf1 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/ResourcePolicyRule.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/ResourcePolicyRule.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourcePolicyRule is a predicate that matches some resource requests, testing the request's verb and the target resource. A ResourcePolicyRule matches a resource request if and only if: (a) at least one member of verbs matches the request, (b) at least one member of apiGroups matches the request, (c) at least one member of resources matches the request, and (d) either (d1) the request does not specify a namespace (i.e., `Namespace==""`) and clusterScope is true or (d2) the request specifies a namespace and least one member of namespaces matches the request's namespace.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -100,55 +103,85 @@ public ResourcePolicyRule(List<String> apiGroups, Boolean clusterScope, List<Str
         this.verbs = verbs;
     }
 
+    /**
+     * `apiGroups` is a list of matching API groups and may not be empty. "&#42;" matches all API groups and, if present, must be the only entry. Required.
+     */
     @JsonProperty("apiGroups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiGroups() {
         return apiGroups;
     }
 
+    /**
+     * `apiGroups` is a list of matching API groups and may not be empty. "&#42;" matches all API groups and, if present, must be the only entry. Required.
+     */
     @JsonProperty("apiGroups")
     public void setApiGroups(List<String> apiGroups) {
         this.apiGroups = apiGroups;
     }
 
+    /**
+     * `clusterScope` indicates whether to match requests that do not specify a namespace (which happens either because the resource is not namespaced or the request targets all namespaces). If this field is omitted or false then the `namespaces` field must contain a non-empty list.
+     */
     @JsonProperty("clusterScope")
     public Boolean getClusterScope() {
         return clusterScope;
     }
 
+    /**
+     * `clusterScope` indicates whether to match requests that do not specify a namespace (which happens either because the resource is not namespaced or the request targets all namespaces). If this field is omitted or false then the `namespaces` field must contain a non-empty list.
+     */
     @JsonProperty("clusterScope")
     public void setClusterScope(Boolean clusterScope) {
         this.clusterScope = clusterScope;
     }
 
+    /**
+     * `namespaces` is a list of target namespaces that restricts matches.  A request that specifies a target namespace matches only if either (a) this list contains that target namespace or (b) this list contains "&#42;".  Note that "&#42;" matches any specified namespace but does not match a request that _does not specify_ a namespace (see the `clusterScope` field for that). This list may be empty, but only if `clusterScope` is true.
+     */
     @JsonProperty("namespaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNamespaces() {
         return namespaces;
     }
 
+    /**
+     * `namespaces` is a list of target namespaces that restricts matches.  A request that specifies a target namespace matches only if either (a) this list contains that target namespace or (b) this list contains "&#42;".  Note that "&#42;" matches any specified namespace but does not match a request that _does not specify_ a namespace (see the `clusterScope` field for that). This list may be empty, but only if `clusterScope` is true.
+     */
     @JsonProperty("namespaces")
     public void setNamespaces(List<String> namespaces) {
         this.namespaces = namespaces;
     }
 
+    /**
+     * `resources` is a list of matching resources (i.e., lowercase and plural) with, if desired, subresource.  For example, [ "services", "nodes/status" ].  This list may not be empty. "&#42;" matches all resources and, if present, must be the only entry. Required.
+     */
     @JsonProperty("resources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getResources() {
         return resources;
     }
 
+    /**
+     * `resources` is a list of matching resources (i.e., lowercase and plural) with, if desired, subresource.  For example, [ "services", "nodes/status" ].  This list may not be empty. "&#42;" matches all resources and, if present, must be the only entry. Required.
+     */
     @JsonProperty("resources")
     public void setResources(List<String> resources) {
         this.resources = resources;
     }
 
+    /**
+     * `verbs` is a list of matching verbs and may not be empty. "&#42;" matches all verbs and, if present, must be the only entry. Required.
+     */
     @JsonProperty("verbs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getVerbs() {
         return verbs;
     }
 
+    /**
+     * `verbs` is a list of matching verbs and may not be empty. "&#42;" matches all verbs and, if present, must be the only entry. Required.
+     */
     @JsonProperty("verbs")
     public void setVerbs(List<String> verbs) {
         this.verbs = verbs;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/ServiceAccountSubject.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/ServiceAccountSubject.java
index a49a5a758e0..459c8e11244 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/ServiceAccountSubject.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/ServiceAccountSubject.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceAccountSubject holds detailed information for service-account-kind subject.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ServiceAccountSubject(String name, String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * `name` is the name of matching ServiceAccount objects, or "&#42;" to match regardless of name. Required.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * `name` is the name of matching ServiceAccount objects, or "&#42;" to match regardless of name. Required.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * `namespace` is the namespace of matching ServiceAccount objects. Required.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * `namespace` is the namespace of matching ServiceAccount objects. Required.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/Subject.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/Subject.java
index 8f5083e2905..071d9ec2481 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/Subject.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/Subject.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public Subject(GroupSubject group, String kind, ServiceAccountSubject serviceAcc
         this.user = user;
     }
 
+    /**
+     * Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account.
+     */
     @JsonProperty("group")
     public GroupSubject getGroup() {
         return group;
     }
 
+    /**
+     * Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account.
+     */
     @JsonProperty("group")
     public void setGroup(GroupSubject group) {
         this.group = group;
     }
 
+    /**
+     * `kind` indicates which one of the other fields is non-empty. Required
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * `kind` indicates which one of the other fields is non-empty. Required
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account.
+     */
     @JsonProperty("serviceAccount")
     public ServiceAccountSubject getServiceAccount() {
         return serviceAccount;
     }
 
+    /**
+     * Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account.
+     */
     @JsonProperty("serviceAccount")
     public void setServiceAccount(ServiceAccountSubject serviceAccount) {
         this.serviceAccount = serviceAccount;
     }
 
+    /**
+     * Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account.
+     */
     @JsonProperty("user")
     public UserSubject getUser() {
         return user;
     }
 
+    /**
+     * Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account.
+     */
     @JsonProperty("user")
     public void setUser(UserSubject user) {
         this.user = user;
diff --git a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/UserSubject.java b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/UserSubject.java
index b7665169338..fd0f6ec25e7 100644
--- a/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/UserSubject.java
+++ b/kubernetes-model-generator/kubernetes-model-flowcontrol/src/generated/java/io/fabric8/kubernetes/api/model/flowcontrol/v1beta3/UserSubject.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UserSubject holds detailed information for user-kind subject.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public UserSubject(String name) {
         this.name = name;
     }
 
+    /**
+     * `name` is the username that matches, or "&#42;" to match all usernames. Required.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * `name` is the username that matches, or "&#42;" to match all usernames. Required.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/AllowedRoutes.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/AllowedRoutes.java
index a8d95c99309..5324b2a3ff0 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/AllowedRoutes.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/AllowedRoutes.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AllowedRoutes defines which Routes may be attached to this Listener.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public AllowedRoutes(List<RouteGroupKind> kinds, RouteNamespaces namespaces) {
         this.namespaces = namespaces;
     }
 
+    /**
+     * Kinds specifies the groups and kinds of Routes that are allowed to bind to this Gateway Listener. When unspecified or empty, the kinds of Routes selected are determined using the Listener protocol.<br><p> <br><p> A RouteGroupKind MUST correspond to kinds of Routes that are compatible with the application protocol specified in the Listener's Protocol field. If an implementation does not support or recognize this resource type, it MUST set the "ResolvedRefs" condition to False for this Listener with the "InvalidRouteKinds" reason.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("kinds")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RouteGroupKind> getKinds() {
         return kinds;
     }
 
+    /**
+     * Kinds specifies the groups and kinds of Routes that are allowed to bind to this Gateway Listener. When unspecified or empty, the kinds of Routes selected are determined using the Listener protocol.<br><p> <br><p> A RouteGroupKind MUST correspond to kinds of Routes that are compatible with the application protocol specified in the Listener's Protocol field. If an implementation does not support or recognize this resource type, it MUST set the "ResolvedRefs" condition to False for this Listener with the "InvalidRouteKinds" reason.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("kinds")
     public void setKinds(List<RouteGroupKind> kinds) {
         this.kinds = kinds;
     }
 
+    /**
+     * AllowedRoutes defines which Routes may be attached to this Listener.
+     */
     @JsonProperty("namespaces")
     public RouteNamespaces getNamespaces() {
         return namespaces;
     }
 
+    /**
+     * AllowedRoutes defines which Routes may be attached to this Listener.
+     */
     @JsonProperty("namespaces")
     public void setNamespaces(RouteNamespaces namespaces) {
         this.namespaces = namespaces;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/BackendObjectReference.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/BackendObjectReference.java
index 957b2400061..2ed3f6f44af 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/BackendObjectReference.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/BackendObjectReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BackendObjectReference defines how an ObjectReference that is specific to BackendRef. It includes a few additional fields and features than a regular ObjectReference.<br><p> <br><p> Note that when a namespace different than the local namespace is specified, a ReferenceGrant object is required in the referent namespace to allow that namespace's owner to accept the reference. See the ReferenceGrant documentation for details.<br><p> <br><p> The API object must be valid in the cluster; the Group and Kind must be registered in the cluster for this reference to be valid.<br><p> <br><p> References to objects with invalid Group and Kind are not valid, and must be rejected by the implementation, with appropriate Conditions set on the containing object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public BackendObjectReference(String group, String kind, String name, String nam
         this.port = port;
     }
 
+    /**
+     * Group is the group of the referent. For example, "gateway.networking.k8s.io". When unspecified or empty string, core API group is inferred.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * Group is the group of the referent. For example, "gateway.networking.k8s.io". When unspecified or empty string, core API group is inferred.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * Kind is the Kubernetes resource kind of the referent. For example "Service".<br><p> <br><p> Defaults to "Service" when not specified.<br><p> <br><p> ExternalName services can refer to CNAME DNS records that may live outside of the cluster and as such are difficult to reason about in terms of conformance. They also may not be safe to forward to (see CVE-2021-25740 for more information). Implementations SHOULD NOT support ExternalName Services.<br><p> <br><p> Support: Core (Services with a type other than ExternalName)<br><p> <br><p> Support: Implementation-specific (Services with type ExternalName)
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is the Kubernetes resource kind of the referent. For example "Service".<br><p> <br><p> Defaults to "Service" when not specified.<br><p> <br><p> ExternalName services can refer to CNAME DNS records that may live outside of the cluster and as such are difficult to reason about in terms of conformance. They also may not be safe to forward to (see CVE-2021-25740 for more information). Implementations SHOULD NOT support ExternalName Services.<br><p> <br><p> Support: Core (Services with a type other than ExternalName)<br><p> <br><p> Support: Implementation-specific (Services with type ExternalName)
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of the referent.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the referent.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace is the namespace of the backend. When unspecified, the local namespace is inferred.<br><p> <br><p> Note that when a namespace different than the local namespace is specified, a ReferenceGrant object is required in the referent namespace to allow that namespace's owner to accept the reference. See the ReferenceGrant documentation for details.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace of the backend. When unspecified, the local namespace is inferred.<br><p> <br><p> Note that when a namespace different than the local namespace is specified, a ReferenceGrant object is required in the referent namespace to allow that namespace's owner to accept the reference. See the ReferenceGrant documentation for details.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Port specifies the destination port number to use for this resource. Port is required when the referent is a Kubernetes Service. In this case, the port number is the service port number, not the target port. For other resources, destination port might be derived from the referent resource or this field.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * Port specifies the destination port number to use for this resource. Port is required when the referent is a Kubernetes Service. In this case, the port number is the service port number, not the target port. For other resources, destination port might be derived from the referent resource or this field.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/BackendRef.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/BackendRef.java
index 3f8a002b50d..221d2bff602 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/BackendRef.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/BackendRef.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BackendRef defines how a Route should forward a request to a Kubernetes resource.<br><p> <br><p> Note that when a namespace different than the local namespace is specified, a ReferenceGrant object is required in the referent namespace to allow that namespace's owner to accept the reference. See the ReferenceGrant documentation for details.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public BackendRef(String group, String kind, String name, String namespace, Inte
         this.weight = weight;
     }
 
+    /**
+     * Group is the group of the referent. For example, "gateway.networking.k8s.io". When unspecified or empty string, core API group is inferred.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * Group is the group of the referent. For example, "gateway.networking.k8s.io". When unspecified or empty string, core API group is inferred.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * Kind is the Kubernetes resource kind of the referent. For example "Service".<br><p> <br><p> Defaults to "Service" when not specified.<br><p> <br><p> ExternalName services can refer to CNAME DNS records that may live outside of the cluster and as such are difficult to reason about in terms of conformance. They also may not be safe to forward to (see CVE-2021-25740 for more information). Implementations SHOULD NOT support ExternalName Services.<br><p> <br><p> Support: Core (Services with a type other than ExternalName)<br><p> <br><p> Support: Implementation-specific (Services with type ExternalName)
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is the Kubernetes resource kind of the referent. For example "Service".<br><p> <br><p> Defaults to "Service" when not specified.<br><p> <br><p> ExternalName services can refer to CNAME DNS records that may live outside of the cluster and as such are difficult to reason about in terms of conformance. They also may not be safe to forward to (see CVE-2021-25740 for more information). Implementations SHOULD NOT support ExternalName Services.<br><p> <br><p> Support: Core (Services with a type other than ExternalName)<br><p> <br><p> Support: Implementation-specific (Services with type ExternalName)
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of the referent.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the referent.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace is the namespace of the backend. When unspecified, the local namespace is inferred.<br><p> <br><p> Note that when a namespace different than the local namespace is specified, a ReferenceGrant object is required in the referent namespace to allow that namespace's owner to accept the reference. See the ReferenceGrant documentation for details.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace of the backend. When unspecified, the local namespace is inferred.<br><p> <br><p> Note that when a namespace different than the local namespace is specified, a ReferenceGrant object is required in the referent namespace to allow that namespace's owner to accept the reference. See the ReferenceGrant documentation for details.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Port specifies the destination port number to use for this resource. Port is required when the referent is a Kubernetes Service. In this case, the port number is the service port number, not the target port. For other resources, destination port might be derived from the referent resource or this field.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * Port specifies the destination port number to use for this resource. Port is required when the referent is a Kubernetes Service. In this case, the port number is the service port number, not the target port. For other resources, destination port might be derived from the referent resource or this field.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * Weight specifies the proportion of requests forwarded to the referenced backend. This is computed as weight/(sum of all weights in this BackendRefs list). For non-zero values, there may be some epsilon from the exact proportion defined here depending on the precision an implementation supports. Weight is not a percentage and the sum of weights does not need to equal 100.<br><p> <br><p> If only one backend is specified and it has a weight greater than 0, 100% of the traffic is forwarded to that backend. If weight is set to 0, no traffic should be forwarded for this entry. If unspecified, weight defaults to 1.<br><p> <br><p> Support for this field varies based on the context where used.
+     */
     @JsonProperty("weight")
     public Integer getWeight() {
         return weight;
     }
 
+    /**
+     * Weight specifies the proportion of requests forwarded to the referenced backend. This is computed as weight/(sum of all weights in this BackendRefs list). For non-zero values, there may be some epsilon from the exact proportion defined here depending on the precision an implementation supports. Weight is not a percentage and the sum of weights does not need to equal 100.<br><p> <br><p> If only one backend is specified and it has a weight greater than 0, 100% of the traffic is forwarded to that backend. If weight is set to 0, no traffic should be forwarded for this entry. If unspecified, weight defaults to 1.<br><p> <br><p> Support for this field varies based on the context where used.
+     */
     @JsonProperty("weight")
     public void setWeight(Integer weight) {
         this.weight = weight;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/CommonRouteSpec.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/CommonRouteSpec.java
index 35b400f09d7..4155dead36b 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/CommonRouteSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/CommonRouteSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CommonRouteSpec defines the common attributes that all Routes MUST include within their spec.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public CommonRouteSpec(List<ParentReference> parentRefs) {
         this.parentRefs = parentRefs;
     }
 
+    /**
+     * ParentRefs references the resources (usually Gateways) that a Route wants to be attached to. Note that the referenced parent resource needs to allow this for the attachment to be complete. For Gateways, that means the Gateway needs to allow attachment from Routes of this kind and namespace. For Services, that means the Service must either be in the same namespace for a "producer" route, or the mesh implementation must support and allow "consumer" routes for the referenced Service. ReferenceGrant is not applicable for governing ParentRefs to Services - it is not possible to create a "producer" route for a Service in a different namespace from the Route.<br><p> <br><p> There are two kinds of parent resources with "Core" support:<br><p> <br><p> &#42; Gateway (Gateway conformance profile) &#42; Service (Mesh conformance profile, ClusterIP Services only)<br><p> <br><p> This API may be extended in the future to support additional kinds of parent resources.<br><p> <br><p> ParentRefs must be _distinct_. This means either that:<br><p> <br><p> &#42; They select different objects.  If this is the case, then parentRef<br><p>   entries are distinct. In terms of fields, this means that the<br><p>   multi-part key defined by `group`, `kind`, `namespace`, and `name` must<br><p>   be unique across all parentRef entries in the Route.<br><p> &#42; They do not select different objects, but for each optional field used,<br><p>   each ParentRef that selects the same object must set the same set of<br><p>   optional fields to different values. If one ParentRef sets a<br><p>   combination of optional fields, all must set the same combination.<br><p> <br><p> Some examples:<br><p> <br><p> &#42; If one ParentRef sets `sectionName`, all ParentRefs referencing the<br><p>   same object must also set `sectionName`.<br><p> &#42; If one ParentRef sets `port`, all ParentRefs referencing the same<br><p>   object must also set `port`.<br><p> &#42; If one ParentRef sets `sectionName` and `port`, all ParentRefs<br><p>   referencing the same object must also set `sectionName` and `port`.<br><p> <br><p> It is possible to separately reference multiple distinct objects that may be collapsed by an implementation. For example, some implementations may choose to merge compatible Gateway Listeners together. If that is the case, the list of routes attached to those resources should also be merged.<br><p> <br><p> Note that for ParentRefs that cross namespace boundaries, there are specific rules. Cross-namespace references are only valid if they are explicitly allowed by something in the namespace they are referring to. For example, Gateway has the AllowedRoutes field, and ReferenceGrant provides a generic way to enable other kinds of cross-namespace reference.<br><p> <br><p> &lt;gateway:experimental:description&gt; ParentRefs from a Route to a Service in the same namespace are "producer" routes, which apply default routing rules to inbound connections from any namespace to the Service.<br><p> <br><p> ParentRefs from a Route to a Service in a different namespace are "consumer" routes, and these routing rules are only applied to outbound connections originating from the same namespace as the Route, for which the intended destination of the connections are a Service targeted as a ParentRef of the Route. &lt;/gateway:experimental:description&gt;<br><p> <br><p> &lt;gateway:standard:validation:XValidation:message="sectionName must be specified when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.all(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) ? ((!has(p1.sectionName) || p1.sectionName == '') == (!has(p2.sectionName) || p2.sectionName == '')) : true))"&gt; &lt;gateway:standard:validation:XValidation:message="sectionName must be unique when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.exists_one(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) &amp;&amp; (((!has(p1.sectionName) || p1.sectionName == '') &amp;&amp; (!has(p2.sectionName) || p2.sectionName == '')) || (has(p1.sectionName) &amp;&amp; has(p2.sectionName) &amp;&amp; p1.sectionName == p2.sectionName))))"&gt; &lt;gateway:experimental:validation:XValidation:message="sectionName or port must be specified when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.all(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__)) ? ((!has(p1.sectionName) || p1.sectionName == '') == (!has(p2.sectionName) || p2.sectionName == '') &amp;&amp; (!has(p1.port) || p1.port == 0) == (!has(p2.port) || p2.port == 0)): true))"&gt; &lt;gateway:experimental:validation:XValidation:message="sectionName or port must be unique when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.exists_one(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) &amp;&amp; (((!has(p1.sectionName) || p1.sectionName == '') &amp;&amp; (!has(p2.sectionName) || p2.sectionName == '')) || ( has(p1.sectionName) &amp;&amp; has(p2.sectionName) &amp;&amp; p1.sectionName == p2.sectionName)) &amp;&amp; (((!has(p1.port) || p1.port == 0) &amp;&amp; (!has(p2.port) || p2.port == 0)) || (has(p1.port) &amp;&amp; has(p2.port) &amp;&amp; p1.port == p2.port))))"&gt;
+     */
     @JsonProperty("parentRefs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ParentReference> getParentRefs() {
         return parentRefs;
     }
 
+    /**
+     * ParentRefs references the resources (usually Gateways) that a Route wants to be attached to. Note that the referenced parent resource needs to allow this for the attachment to be complete. For Gateways, that means the Gateway needs to allow attachment from Routes of this kind and namespace. For Services, that means the Service must either be in the same namespace for a "producer" route, or the mesh implementation must support and allow "consumer" routes for the referenced Service. ReferenceGrant is not applicable for governing ParentRefs to Services - it is not possible to create a "producer" route for a Service in a different namespace from the Route.<br><p> <br><p> There are two kinds of parent resources with "Core" support:<br><p> <br><p> &#42; Gateway (Gateway conformance profile) &#42; Service (Mesh conformance profile, ClusterIP Services only)<br><p> <br><p> This API may be extended in the future to support additional kinds of parent resources.<br><p> <br><p> ParentRefs must be _distinct_. This means either that:<br><p> <br><p> &#42; They select different objects.  If this is the case, then parentRef<br><p>   entries are distinct. In terms of fields, this means that the<br><p>   multi-part key defined by `group`, `kind`, `namespace`, and `name` must<br><p>   be unique across all parentRef entries in the Route.<br><p> &#42; They do not select different objects, but for each optional field used,<br><p>   each ParentRef that selects the same object must set the same set of<br><p>   optional fields to different values. If one ParentRef sets a<br><p>   combination of optional fields, all must set the same combination.<br><p> <br><p> Some examples:<br><p> <br><p> &#42; If one ParentRef sets `sectionName`, all ParentRefs referencing the<br><p>   same object must also set `sectionName`.<br><p> &#42; If one ParentRef sets `port`, all ParentRefs referencing the same<br><p>   object must also set `port`.<br><p> &#42; If one ParentRef sets `sectionName` and `port`, all ParentRefs<br><p>   referencing the same object must also set `sectionName` and `port`.<br><p> <br><p> It is possible to separately reference multiple distinct objects that may be collapsed by an implementation. For example, some implementations may choose to merge compatible Gateway Listeners together. If that is the case, the list of routes attached to those resources should also be merged.<br><p> <br><p> Note that for ParentRefs that cross namespace boundaries, there are specific rules. Cross-namespace references are only valid if they are explicitly allowed by something in the namespace they are referring to. For example, Gateway has the AllowedRoutes field, and ReferenceGrant provides a generic way to enable other kinds of cross-namespace reference.<br><p> <br><p> &lt;gateway:experimental:description&gt; ParentRefs from a Route to a Service in the same namespace are "producer" routes, which apply default routing rules to inbound connections from any namespace to the Service.<br><p> <br><p> ParentRefs from a Route to a Service in a different namespace are "consumer" routes, and these routing rules are only applied to outbound connections originating from the same namespace as the Route, for which the intended destination of the connections are a Service targeted as a ParentRef of the Route. &lt;/gateway:experimental:description&gt;<br><p> <br><p> &lt;gateway:standard:validation:XValidation:message="sectionName must be specified when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.all(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) ? ((!has(p1.sectionName) || p1.sectionName == '') == (!has(p2.sectionName) || p2.sectionName == '')) : true))"&gt; &lt;gateway:standard:validation:XValidation:message="sectionName must be unique when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.exists_one(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) &amp;&amp; (((!has(p1.sectionName) || p1.sectionName == '') &amp;&amp; (!has(p2.sectionName) || p2.sectionName == '')) || (has(p1.sectionName) &amp;&amp; has(p2.sectionName) &amp;&amp; p1.sectionName == p2.sectionName))))"&gt; &lt;gateway:experimental:validation:XValidation:message="sectionName or port must be specified when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.all(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__)) ? ((!has(p1.sectionName) || p1.sectionName == '') == (!has(p2.sectionName) || p2.sectionName == '') &amp;&amp; (!has(p1.port) || p1.port == 0) == (!has(p2.port) || p2.port == 0)): true))"&gt; &lt;gateway:experimental:validation:XValidation:message="sectionName or port must be unique when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.exists_one(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) &amp;&amp; (((!has(p1.sectionName) || p1.sectionName == '') &amp;&amp; (!has(p2.sectionName) || p2.sectionName == '')) || ( has(p1.sectionName) &amp;&amp; has(p2.sectionName) &amp;&amp; p1.sectionName == p2.sectionName)) &amp;&amp; (((!has(p1.port) || p1.port == 0) &amp;&amp; (!has(p2.port) || p2.port == 0)) || (has(p1.port) &amp;&amp; has(p2.port) &amp;&amp; p1.port == p2.port))))"&gt;
+     */
     @JsonProperty("parentRefs")
     public void setParentRefs(List<ParentReference> parentRefs) {
         this.parentRefs = parentRefs;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/CookieConfig.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/CookieConfig.java
index 50e99fd8564..1a41e94ff55 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/CookieConfig.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/CookieConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CookieConfig defines the configuration for cookie-based session persistence.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public CookieConfig(String lifetimeType) {
         this.lifetimeType = lifetimeType;
     }
 
+    /**
+     * LifetimeType specifies whether the cookie has a permanent or session-based lifetime. A permanent cookie persists until its specified expiry time, defined by the Expires or Max-Age cookie attributes, while a session cookie is deleted when the current session ends.<br><p> <br><p> When set to "Permanent", AbsoluteTimeout indicates the cookie's lifetime via the Expires or Max-Age cookie attributes and is required.<br><p> <br><p> When set to "Session", AbsoluteTimeout indicates the absolute lifetime of the cookie tracked by the gateway and is optional.<br><p> <br><p> Support: Core for "Session" type<br><p> <br><p> Support: Extended for "Permanent" type
+     */
     @JsonProperty("lifetimeType")
     public String getLifetimeType() {
         return lifetimeType;
     }
 
+    /**
+     * LifetimeType specifies whether the cookie has a permanent or session-based lifetime. A permanent cookie persists until its specified expiry time, defined by the Expires or Max-Age cookie attributes, while a session cookie is deleted when the current session ends.<br><p> <br><p> When set to "Permanent", AbsoluteTimeout indicates the cookie's lifetime via the Expires or Max-Age cookie attributes and is required.<br><p> <br><p> When set to "Session", AbsoluteTimeout indicates the absolute lifetime of the cookie tracked by the gateway and is optional.<br><p> <br><p> Support: Core for "Session" type<br><p> <br><p> Support: Extended for "Permanent" type
+     */
     @JsonProperty("lifetimeType")
     public void setLifetimeType(String lifetimeType) {
         this.lifetimeType = lifetimeType;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/FrontendTLSValidation.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/FrontendTLSValidation.java
index 392e4f891ab..856bed46361 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/FrontendTLSValidation.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/FrontendTLSValidation.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FrontendTLSValidation holds configuration information that can be used to validate the frontend initiating the TLS connection
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public FrontendTLSValidation(List<ObjectReference> caCertificateRefs) {
         this.caCertificateRefs = caCertificateRefs;
     }
 
+    /**
+     * CACertificateRefs contains one or more references to Kubernetes objects that contain TLS certificates of the Certificate Authorities that can be used as a trust anchor to validate the certificates presented by the client.<br><p> <br><p> A single CA certificate reference to a Kubernetes ConfigMap has "Core" support. Implementations MAY choose to support attaching multiple CA certificates to a Listener, but this behavior is implementation-specific.<br><p> <br><p> Support: Core - A single reference to a Kubernetes ConfigMap with the CA certificate in a key named `ca.crt`.<br><p> <br><p> Support: Implementation-specific (More than one reference, or other kinds of resources).<br><p> <br><p> References to a resource in a different namespace are invalid UNLESS there is a ReferenceGrant in the target namespace that allows the certificate to be attached. If a ReferenceGrant does not allow this reference, the "ResolvedRefs" condition MUST be set to False for this listener with the "RefNotPermitted" reason.
+     */
     @JsonProperty("caCertificateRefs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ObjectReference> getCaCertificateRefs() {
         return caCertificateRefs;
     }
 
+    /**
+     * CACertificateRefs contains one or more references to Kubernetes objects that contain TLS certificates of the Certificate Authorities that can be used as a trust anchor to validate the certificates presented by the client.<br><p> <br><p> A single CA certificate reference to a Kubernetes ConfigMap has "Core" support. Implementations MAY choose to support attaching multiple CA certificates to a Listener, but this behavior is implementation-specific.<br><p> <br><p> Support: Core - A single reference to a Kubernetes ConfigMap with the CA certificate in a key named `ca.crt`.<br><p> <br><p> Support: Implementation-specific (More than one reference, or other kinds of resources).<br><p> <br><p> References to a resource in a different namespace are invalid UNLESS there is a ReferenceGrant in the target namespace that allows the certificate to be attached. If a ReferenceGrant does not allow this reference, the "ResolvedRefs" condition MUST be set to False for this listener with the "RefNotPermitted" reason.
+     */
     @JsonProperty("caCertificateRefs")
     public void setCaCertificateRefs(List<ObjectReference> caCertificateRefs) {
         this.caCertificateRefs = caCertificateRefs;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCBackendRef.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCBackendRef.java
index 2dc5d4adad3..bba80378bb4 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCBackendRef.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCBackendRef.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GRPCBackendRef defines how a GRPCRoute forwards a gRPC request.<br><p> <br><p> Note that when a namespace different than the local namespace is specified, a ReferenceGrant object is required in the referent namespace to allow that namespace's owner to accept the reference. See the ReferenceGrant documentation for details.<br><p> <br><p> &lt;gateway:experimental:description&gt;<br><p> <br><p> When the BackendRef points to a Kubernetes Service, implementations SHOULD honor the appProtocol field if it is set for the target Service Port.<br><p> <br><p> Implementations supporting appProtocol SHOULD recognize the Kubernetes Standard Application Protocols defined in KEP-3726.<br><p> <br><p> If a Service appProtocol isn't specified, an implementation MAY infer the backend protocol through its own means. Implementations MAY infer the protocol from the Route type referring to the backend Service.<br><p> <br><p> If a Route is not able to send traffic to the backend using the specified protocol then the backend is considered invalid. Implementations MUST set the "ResolvedRefs" condition to "False" with the "UnsupportedProtocol" reason.<br><p> <br><p> &lt;/gateway:experimental:description&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -105,72 +108,114 @@ public GRPCBackendRef(List<GRPCRouteFilter> filters, String group, String kind,
         this.weight = weight;
     }
 
+    /**
+     * Filters defined at this level MUST be executed if and only if the request is being forwarded to the backend defined here.<br><p> <br><p> Support: Implementation-specific (For broader support of filters, use the Filters field in GRPCRouteRule.)
+     */
     @JsonProperty("filters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GRPCRouteFilter> getFilters() {
         return filters;
     }
 
+    /**
+     * Filters defined at this level MUST be executed if and only if the request is being forwarded to the backend defined here.<br><p> <br><p> Support: Implementation-specific (For broader support of filters, use the Filters field in GRPCRouteRule.)
+     */
     @JsonProperty("filters")
     public void setFilters(List<GRPCRouteFilter> filters) {
         this.filters = filters;
     }
 
+    /**
+     * Group is the group of the referent. For example, "gateway.networking.k8s.io". When unspecified or empty string, core API group is inferred.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * Group is the group of the referent. For example, "gateway.networking.k8s.io". When unspecified or empty string, core API group is inferred.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * Kind is the Kubernetes resource kind of the referent. For example "Service".<br><p> <br><p> Defaults to "Service" when not specified.<br><p> <br><p> ExternalName services can refer to CNAME DNS records that may live outside of the cluster and as such are difficult to reason about in terms of conformance. They also may not be safe to forward to (see CVE-2021-25740 for more information). Implementations SHOULD NOT support ExternalName Services.<br><p> <br><p> Support: Core (Services with a type other than ExternalName)<br><p> <br><p> Support: Implementation-specific (Services with type ExternalName)
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is the Kubernetes resource kind of the referent. For example "Service".<br><p> <br><p> Defaults to "Service" when not specified.<br><p> <br><p> ExternalName services can refer to CNAME DNS records that may live outside of the cluster and as such are difficult to reason about in terms of conformance. They also may not be safe to forward to (see CVE-2021-25740 for more information). Implementations SHOULD NOT support ExternalName Services.<br><p> <br><p> Support: Core (Services with a type other than ExternalName)<br><p> <br><p> Support: Implementation-specific (Services with type ExternalName)
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of the referent.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the referent.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace is the namespace of the backend. When unspecified, the local namespace is inferred.<br><p> <br><p> Note that when a namespace different than the local namespace is specified, a ReferenceGrant object is required in the referent namespace to allow that namespace's owner to accept the reference. See the ReferenceGrant documentation for details.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace of the backend. When unspecified, the local namespace is inferred.<br><p> <br><p> Note that when a namespace different than the local namespace is specified, a ReferenceGrant object is required in the referent namespace to allow that namespace's owner to accept the reference. See the ReferenceGrant documentation for details.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Port specifies the destination port number to use for this resource. Port is required when the referent is a Kubernetes Service. In this case, the port number is the service port number, not the target port. For other resources, destination port might be derived from the referent resource or this field.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * Port specifies the destination port number to use for this resource. Port is required when the referent is a Kubernetes Service. In this case, the port number is the service port number, not the target port. For other resources, destination port might be derived from the referent resource or this field.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * Weight specifies the proportion of requests forwarded to the referenced backend. This is computed as weight/(sum of all weights in this BackendRefs list). For non-zero values, there may be some epsilon from the exact proportion defined here depending on the precision an implementation supports. Weight is not a percentage and the sum of weights does not need to equal 100.<br><p> <br><p> If only one backend is specified and it has a weight greater than 0, 100% of the traffic is forwarded to that backend. If weight is set to 0, no traffic should be forwarded for this entry. If unspecified, weight defaults to 1.<br><p> <br><p> Support for this field varies based on the context where used.
+     */
     @JsonProperty("weight")
     public Integer getWeight() {
         return weight;
     }
 
+    /**
+     * Weight specifies the proportion of requests forwarded to the referenced backend. This is computed as weight/(sum of all weights in this BackendRefs list). For non-zero values, there may be some epsilon from the exact proportion defined here depending on the precision an implementation supports. Weight is not a percentage and the sum of weights does not need to equal 100.<br><p> <br><p> If only one backend is specified and it has a weight greater than 0, 100% of the traffic is forwarded to that backend. If weight is set to 0, no traffic should be forwarded for this entry. If unspecified, weight defaults to 1.<br><p> <br><p> Support for this field varies based on the context where used.
+     */
     @JsonProperty("weight")
     public void setWeight(Integer weight) {
         this.weight = weight;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCHeaderMatch.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCHeaderMatch.java
index 98d30924340..d3e803fe4ac 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCHeaderMatch.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCHeaderMatch.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GRPCHeaderMatch describes how to select a gRPC route by matching gRPC request headers.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public GRPCHeaderMatch(String name, String type, String value) {
         this.value = value;
     }
 
+    /**
+     * Name is the name of the gRPC Header to be matched.<br><p> <br><p> If multiple entries specify equivalent header names, only the first entry with an equivalent name MUST be considered for a match. Subsequent entries with an equivalent header name MUST be ignored. Due to the case-insensitivity of header names, "foo" and "Foo" are considered equivalent.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the gRPC Header to be matched.<br><p> <br><p> If multiple entries specify equivalent header names, only the first entry with an equivalent name MUST be considered for a match. Subsequent entries with an equivalent header name MUST be ignored. Due to the case-insensitivity of header names, "foo" and "Foo" are considered equivalent.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Type specifies how to match against the value of the header.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type specifies how to match against the value of the header.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * Value is the value of the gRPC Header to be matched.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is the value of the gRPC Header to be matched.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCMethodMatch.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCMethodMatch.java
index 6662ca64fb8..382caca73de 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCMethodMatch.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCMethodMatch.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GRPCMethodMatch describes how to select a gRPC route by matching the gRPC request service and/or method.<br><p> <br><p> At least one of Service and Method MUST be a non-empty string.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public GRPCMethodMatch(String method, String service, String type) {
         this.type = type;
     }
 
+    /**
+     * Value of the method to match against. If left empty or omitted, will match all services.<br><p> <br><p> At least one of Service and Method MUST be a non-empty string.
+     */
     @JsonProperty("method")
     public String getMethod() {
         return method;
     }
 
+    /**
+     * Value of the method to match against. If left empty or omitted, will match all services.<br><p> <br><p> At least one of Service and Method MUST be a non-empty string.
+     */
     @JsonProperty("method")
     public void setMethod(String method) {
         this.method = method;
     }
 
+    /**
+     * Value of the service to match against. If left empty or omitted, will match any service.<br><p> <br><p> At least one of Service and Method MUST be a non-empty string.
+     */
     @JsonProperty("service")
     public String getService() {
         return service;
     }
 
+    /**
+     * Value of the service to match against. If left empty or omitted, will match any service.<br><p> <br><p> At least one of Service and Method MUST be a non-empty string.
+     */
     @JsonProperty("service")
     public void setService(String service) {
         this.service = service;
     }
 
+    /**
+     * Type specifies how to match against the service and/or method. Support: Core (Exact with service and method specified)<br><p> <br><p> Support: Implementation-specific (Exact with method specified but no service specified)<br><p> <br><p> Support: Implementation-specific (RegularExpression)
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type specifies how to match against the service and/or method. Support: Core (Exact with service and method specified)<br><p> <br><p> Support: Implementation-specific (Exact with method specified but no service specified)<br><p> <br><p> Support: Implementation-specific (RegularExpression)
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCRoute.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCRoute.java
index 409ff2012c0..da59e43fdb1 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCRoute.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCRoute.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GRPCRoute provides a way to route gRPC requests. This includes the capability to match requests by hostname, gRPC service, gRPC method, or HTTP/2 header. Filters can be used to specify additional processing steps. Backends specify where matching requests will be routed.<br><p> <br><p> GRPCRoute falls under extended support within the Gateway API. Within the following specification, the word "MUST" indicates that an implementation supporting GRPCRoute must conform to the indicated requirement, but an implementation not supporting this route type need not follow the requirement unless explicitly indicated.<br><p> <br><p> Implementations supporting `GRPCRoute` with the `HTTPS` `ProtocolType` MUST accept HTTP/2 connections without an initial upgrade from HTTP/1.1, i.e. via ALPN. If the implementation does not support this, then it MUST set the "Accepted" condition to "False" for the affected listener with a reason of "UnsupportedProtocol".  Implementations MAY also accept HTTP/2 connections with an upgrade from HTTP/1.<br><p> <br><p> Implementations supporting `GRPCRoute` with the `HTTP` `ProtocolType` MUST support HTTP/2 over cleartext TCP (h2c, https://www.rfc-editor.org/rfc/rfc7540#section-3.1) without an initial upgrade from HTTP/1.1, i.e. with prior knowledge (https://www.rfc-editor.org/rfc/rfc7540#section-3.4). If the implementation does not support this, then it MUST set the "Accepted" condition to "False" for the affected listener with a reason of "UnsupportedProtocol". Implementations MAY also accept HTTP/2 connections with an upgrade from HTTP/1, i.e. without prior knowledge.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class GRPCRoute implements Editable<GRPCRouteBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GRPCRoute";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public GRPCRoute(String apiVersion, String kind, ObjectMeta metadata, GRPCRouteS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * GRPCRoute provides a way to route gRPC requests. This includes the capability to match requests by hostname, gRPC service, gRPC method, or HTTP/2 header. Filters can be used to specify additional processing steps. Backends specify where matching requests will be routed.<br><p> <br><p> GRPCRoute falls under extended support within the Gateway API. Within the following specification, the word "MUST" indicates that an implementation supporting GRPCRoute must conform to the indicated requirement, but an implementation not supporting this route type need not follow the requirement unless explicitly indicated.<br><p> <br><p> Implementations supporting `GRPCRoute` with the `HTTPS` `ProtocolType` MUST accept HTTP/2 connections without an initial upgrade from HTTP/1.1, i.e. via ALPN. If the implementation does not support this, then it MUST set the "Accepted" condition to "False" for the affected listener with a reason of "UnsupportedProtocol".  Implementations MAY also accept HTTP/2 connections with an upgrade from HTTP/1.<br><p> <br><p> Implementations supporting `GRPCRoute` with the `HTTP` `ProtocolType` MUST support HTTP/2 over cleartext TCP (h2c, https://www.rfc-editor.org/rfc/rfc7540#section-3.1) without an initial upgrade from HTTP/1.1, i.e. with prior knowledge (https://www.rfc-editor.org/rfc/rfc7540#section-3.4). If the implementation does not support this, then it MUST set the "Accepted" condition to "False" for the affected listener with a reason of "UnsupportedProtocol". Implementations MAY also accept HTTP/2 connections with an upgrade from HTTP/1, i.e. without prior knowledge.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * GRPCRoute provides a way to route gRPC requests. This includes the capability to match requests by hostname, gRPC service, gRPC method, or HTTP/2 header. Filters can be used to specify additional processing steps. Backends specify where matching requests will be routed.<br><p> <br><p> GRPCRoute falls under extended support within the Gateway API. Within the following specification, the word "MUST" indicates that an implementation supporting GRPCRoute must conform to the indicated requirement, but an implementation not supporting this route type need not follow the requirement unless explicitly indicated.<br><p> <br><p> Implementations supporting `GRPCRoute` with the `HTTPS` `ProtocolType` MUST accept HTTP/2 connections without an initial upgrade from HTTP/1.1, i.e. via ALPN. If the implementation does not support this, then it MUST set the "Accepted" condition to "False" for the affected listener with a reason of "UnsupportedProtocol".  Implementations MAY also accept HTTP/2 connections with an upgrade from HTTP/1.<br><p> <br><p> Implementations supporting `GRPCRoute` with the `HTTP` `ProtocolType` MUST support HTTP/2 over cleartext TCP (h2c, https://www.rfc-editor.org/rfc/rfc7540#section-3.1) without an initial upgrade from HTTP/1.1, i.e. with prior knowledge (https://www.rfc-editor.org/rfc/rfc7540#section-3.4). If the implementation does not support this, then it MUST set the "Accepted" condition to "False" for the affected listener with a reason of "UnsupportedProtocol". Implementations MAY also accept HTTP/2 connections with an upgrade from HTTP/1, i.e. without prior knowledge.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * GRPCRoute provides a way to route gRPC requests. This includes the capability to match requests by hostname, gRPC service, gRPC method, or HTTP/2 header. Filters can be used to specify additional processing steps. Backends specify where matching requests will be routed.<br><p> <br><p> GRPCRoute falls under extended support within the Gateway API. Within the following specification, the word "MUST" indicates that an implementation supporting GRPCRoute must conform to the indicated requirement, but an implementation not supporting this route type need not follow the requirement unless explicitly indicated.<br><p> <br><p> Implementations supporting `GRPCRoute` with the `HTTPS` `ProtocolType` MUST accept HTTP/2 connections without an initial upgrade from HTTP/1.1, i.e. via ALPN. If the implementation does not support this, then it MUST set the "Accepted" condition to "False" for the affected listener with a reason of "UnsupportedProtocol".  Implementations MAY also accept HTTP/2 connections with an upgrade from HTTP/1.<br><p> <br><p> Implementations supporting `GRPCRoute` with the `HTTP` `ProtocolType` MUST support HTTP/2 over cleartext TCP (h2c, https://www.rfc-editor.org/rfc/rfc7540#section-3.1) without an initial upgrade from HTTP/1.1, i.e. with prior knowledge (https://www.rfc-editor.org/rfc/rfc7540#section-3.4). If the implementation does not support this, then it MUST set the "Accepted" condition to "False" for the affected listener with a reason of "UnsupportedProtocol". Implementations MAY also accept HTTP/2 connections with an upgrade from HTTP/1, i.e. without prior knowledge.
+     */
     @JsonProperty("spec")
     public GRPCRouteSpec getSpec() {
         return spec;
     }
 
+    /**
+     * GRPCRoute provides a way to route gRPC requests. This includes the capability to match requests by hostname, gRPC service, gRPC method, or HTTP/2 header. Filters can be used to specify additional processing steps. Backends specify where matching requests will be routed.<br><p> <br><p> GRPCRoute falls under extended support within the Gateway API. Within the following specification, the word "MUST" indicates that an implementation supporting GRPCRoute must conform to the indicated requirement, but an implementation not supporting this route type need not follow the requirement unless explicitly indicated.<br><p> <br><p> Implementations supporting `GRPCRoute` with the `HTTPS` `ProtocolType` MUST accept HTTP/2 connections without an initial upgrade from HTTP/1.1, i.e. via ALPN. If the implementation does not support this, then it MUST set the "Accepted" condition to "False" for the affected listener with a reason of "UnsupportedProtocol".  Implementations MAY also accept HTTP/2 connections with an upgrade from HTTP/1.<br><p> <br><p> Implementations supporting `GRPCRoute` with the `HTTP` `ProtocolType` MUST support HTTP/2 over cleartext TCP (h2c, https://www.rfc-editor.org/rfc/rfc7540#section-3.1) without an initial upgrade from HTTP/1.1, i.e. with prior knowledge (https://www.rfc-editor.org/rfc/rfc7540#section-3.4). If the implementation does not support this, then it MUST set the "Accepted" condition to "False" for the affected listener with a reason of "UnsupportedProtocol". Implementations MAY also accept HTTP/2 connections with an upgrade from HTTP/1, i.e. without prior knowledge.
+     */
     @JsonProperty("spec")
     public void setSpec(GRPCRouteSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * GRPCRoute provides a way to route gRPC requests. This includes the capability to match requests by hostname, gRPC service, gRPC method, or HTTP/2 header. Filters can be used to specify additional processing steps. Backends specify where matching requests will be routed.<br><p> <br><p> GRPCRoute falls under extended support within the Gateway API. Within the following specification, the word "MUST" indicates that an implementation supporting GRPCRoute must conform to the indicated requirement, but an implementation not supporting this route type need not follow the requirement unless explicitly indicated.<br><p> <br><p> Implementations supporting `GRPCRoute` with the `HTTPS` `ProtocolType` MUST accept HTTP/2 connections without an initial upgrade from HTTP/1.1, i.e. via ALPN. If the implementation does not support this, then it MUST set the "Accepted" condition to "False" for the affected listener with a reason of "UnsupportedProtocol".  Implementations MAY also accept HTTP/2 connections with an upgrade from HTTP/1.<br><p> <br><p> Implementations supporting `GRPCRoute` with the `HTTP` `ProtocolType` MUST support HTTP/2 over cleartext TCP (h2c, https://www.rfc-editor.org/rfc/rfc7540#section-3.1) without an initial upgrade from HTTP/1.1, i.e. with prior knowledge (https://www.rfc-editor.org/rfc/rfc7540#section-3.4). If the implementation does not support this, then it MUST set the "Accepted" condition to "False" for the affected listener with a reason of "UnsupportedProtocol". Implementations MAY also accept HTTP/2 connections with an upgrade from HTTP/1, i.e. without prior knowledge.
+     */
     @JsonProperty("status")
     public GRPCRouteStatus getStatus() {
         return status;
     }
 
+    /**
+     * GRPCRoute provides a way to route gRPC requests. This includes the capability to match requests by hostname, gRPC service, gRPC method, or HTTP/2 header. Filters can be used to specify additional processing steps. Backends specify where matching requests will be routed.<br><p> <br><p> GRPCRoute falls under extended support within the Gateway API. Within the following specification, the word "MUST" indicates that an implementation supporting GRPCRoute must conform to the indicated requirement, but an implementation not supporting this route type need not follow the requirement unless explicitly indicated.<br><p> <br><p> Implementations supporting `GRPCRoute` with the `HTTPS` `ProtocolType` MUST accept HTTP/2 connections without an initial upgrade from HTTP/1.1, i.e. via ALPN. If the implementation does not support this, then it MUST set the "Accepted" condition to "False" for the affected listener with a reason of "UnsupportedProtocol".  Implementations MAY also accept HTTP/2 connections with an upgrade from HTTP/1.<br><p> <br><p> Implementations supporting `GRPCRoute` with the `HTTP` `ProtocolType` MUST support HTTP/2 over cleartext TCP (h2c, https://www.rfc-editor.org/rfc/rfc7540#section-3.1) without an initial upgrade from HTTP/1.1, i.e. with prior knowledge (https://www.rfc-editor.org/rfc/rfc7540#section-3.4). If the implementation does not support this, then it MUST set the "Accepted" condition to "False" for the affected listener with a reason of "UnsupportedProtocol". Implementations MAY also accept HTTP/2 connections with an upgrade from HTTP/1, i.e. without prior knowledge.
+     */
     @JsonProperty("status")
     public void setStatus(GRPCRouteStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCRouteFilter.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCRouteFilter.java
index 533075f2efd..fc54ac779e6 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCRouteFilter.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCRouteFilter.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GRPCRouteFilter defines processing steps that must be completed during the request or response lifecycle. GRPCRouteFilters are meant as an extension point to express processing that may be done in Gateway implementations. Some examples include request or response modification, implementing authentication strategies, rate-limiting, and traffic shaping. API guarantee/conformance is defined based on the type of the filter.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public GRPCRouteFilter(LocalObjectReference extensionRef, HTTPHeaderFilter reque
         this.type = type;
     }
 
+    /**
+     * GRPCRouteFilter defines processing steps that must be completed during the request or response lifecycle. GRPCRouteFilters are meant as an extension point to express processing that may be done in Gateway implementations. Some examples include request or response modification, implementing authentication strategies, rate-limiting, and traffic shaping. API guarantee/conformance is defined based on the type of the filter.
+     */
     @JsonProperty("extensionRef")
     public LocalObjectReference getExtensionRef() {
         return extensionRef;
     }
 
+    /**
+     * GRPCRouteFilter defines processing steps that must be completed during the request or response lifecycle. GRPCRouteFilters are meant as an extension point to express processing that may be done in Gateway implementations. Some examples include request or response modification, implementing authentication strategies, rate-limiting, and traffic shaping. API guarantee/conformance is defined based on the type of the filter.
+     */
     @JsonProperty("extensionRef")
     public void setExtensionRef(LocalObjectReference extensionRef) {
         this.extensionRef = extensionRef;
     }
 
+    /**
+     * GRPCRouteFilter defines processing steps that must be completed during the request or response lifecycle. GRPCRouteFilters are meant as an extension point to express processing that may be done in Gateway implementations. Some examples include request or response modification, implementing authentication strategies, rate-limiting, and traffic shaping. API guarantee/conformance is defined based on the type of the filter.
+     */
     @JsonProperty("requestHeaderModifier")
     public HTTPHeaderFilter getRequestHeaderModifier() {
         return requestHeaderModifier;
     }
 
+    /**
+     * GRPCRouteFilter defines processing steps that must be completed during the request or response lifecycle. GRPCRouteFilters are meant as an extension point to express processing that may be done in Gateway implementations. Some examples include request or response modification, implementing authentication strategies, rate-limiting, and traffic shaping. API guarantee/conformance is defined based on the type of the filter.
+     */
     @JsonProperty("requestHeaderModifier")
     public void setRequestHeaderModifier(HTTPHeaderFilter requestHeaderModifier) {
         this.requestHeaderModifier = requestHeaderModifier;
     }
 
+    /**
+     * GRPCRouteFilter defines processing steps that must be completed during the request or response lifecycle. GRPCRouteFilters are meant as an extension point to express processing that may be done in Gateway implementations. Some examples include request or response modification, implementing authentication strategies, rate-limiting, and traffic shaping. API guarantee/conformance is defined based on the type of the filter.
+     */
     @JsonProperty("requestMirror")
     public HTTPRequestMirrorFilter getRequestMirror() {
         return requestMirror;
     }
 
+    /**
+     * GRPCRouteFilter defines processing steps that must be completed during the request or response lifecycle. GRPCRouteFilters are meant as an extension point to express processing that may be done in Gateway implementations. Some examples include request or response modification, implementing authentication strategies, rate-limiting, and traffic shaping. API guarantee/conformance is defined based on the type of the filter.
+     */
     @JsonProperty("requestMirror")
     public void setRequestMirror(HTTPRequestMirrorFilter requestMirror) {
         this.requestMirror = requestMirror;
     }
 
+    /**
+     * GRPCRouteFilter defines processing steps that must be completed during the request or response lifecycle. GRPCRouteFilters are meant as an extension point to express processing that may be done in Gateway implementations. Some examples include request or response modification, implementing authentication strategies, rate-limiting, and traffic shaping. API guarantee/conformance is defined based on the type of the filter.
+     */
     @JsonProperty("responseHeaderModifier")
     public HTTPHeaderFilter getResponseHeaderModifier() {
         return responseHeaderModifier;
     }
 
+    /**
+     * GRPCRouteFilter defines processing steps that must be completed during the request or response lifecycle. GRPCRouteFilters are meant as an extension point to express processing that may be done in Gateway implementations. Some examples include request or response modification, implementing authentication strategies, rate-limiting, and traffic shaping. API guarantee/conformance is defined based on the type of the filter.
+     */
     @JsonProperty("responseHeaderModifier")
     public void setResponseHeaderModifier(HTTPHeaderFilter responseHeaderModifier) {
         this.responseHeaderModifier = responseHeaderModifier;
     }
 
+    /**
+     * Type identifies the type of filter to apply. As with other API fields, types are classified into three conformance levels:<br><p> <br><p> - Core: Filter types and their corresponding configuration defined by<br><p>   "Support: Core" in this package, e.g. "RequestHeaderModifier". All<br><p>   implementations supporting GRPCRoute MUST support core filters.<br><p> <br><p> - Extended: Filter types and their corresponding configuration defined by<br><p>   "Support: Extended" in this package, e.g. "RequestMirror". Implementers<br><p>   are encouraged to support extended filters.<br><p> <br><p> - Implementation-specific: Filters that are defined and supported by specific vendors.<br><p>   In the future, filters showing convergence in behavior across multiple<br><p>   implementations will be considered for inclusion in extended or core<br><p>   conformance levels. Filter-specific configuration for such filters<br><p>   is specified using the ExtensionRef field. `Type` MUST be set to<br><p>   "ExtensionRef" for custom filters.<br><p> <br><p> Implementers are encouraged to define custom implementation types to extend the core API with implementation-specific behavior.<br><p> <br><p> If a reference to a custom filter type cannot be resolved, the filter MUST NOT be skipped. Instead, requests that would have been processed by that filter MUST receive a HTTP error response.<br><p> <br><p> &lt;gateway:experimental:validation:Enum=ResponseHeaderModifier;RequestHeaderModifier;RequestMirror;ExtensionRef&gt;
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type identifies the type of filter to apply. As with other API fields, types are classified into three conformance levels:<br><p> <br><p> - Core: Filter types and their corresponding configuration defined by<br><p>   "Support: Core" in this package, e.g. "RequestHeaderModifier". All<br><p>   implementations supporting GRPCRoute MUST support core filters.<br><p> <br><p> - Extended: Filter types and their corresponding configuration defined by<br><p>   "Support: Extended" in this package, e.g. "RequestMirror". Implementers<br><p>   are encouraged to support extended filters.<br><p> <br><p> - Implementation-specific: Filters that are defined and supported by specific vendors.<br><p>   In the future, filters showing convergence in behavior across multiple<br><p>   implementations will be considered for inclusion in extended or core<br><p>   conformance levels. Filter-specific configuration for such filters<br><p>   is specified using the ExtensionRef field. `Type` MUST be set to<br><p>   "ExtensionRef" for custom filters.<br><p> <br><p> Implementers are encouraged to define custom implementation types to extend the core API with implementation-specific behavior.<br><p> <br><p> If a reference to a custom filter type cannot be resolved, the filter MUST NOT be skipped. Instead, requests that would have been processed by that filter MUST receive a HTTP error response.<br><p> <br><p> &lt;gateway:experimental:validation:Enum=ResponseHeaderModifier;RequestHeaderModifier;RequestMirror;ExtensionRef&gt;
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCRouteList.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCRouteList.java
index d5abc3dd4b6..1668e942e73 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCRouteList.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCRouteList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GRPCRouteList contains a list of GRPCRoute.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class GRPCRouteList implements Editable<GRPCRouteListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.gatewayapi.v1.GRPCRoute>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.gatewayapi.v1.GRPCRoute> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GRPCRouteList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public GRPCRouteList(String apiVersion, List<io.fabric8.kubernetes.api.model.gat
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * GRPCRouteList contains a list of GRPCRoute.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.gatewayapi.v1.GRPCRoute> getItems() {
         return items;
     }
 
+    /**
+     * GRPCRouteList contains a list of GRPCRoute.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.gatewayapi.v1.GRPCRoute> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * GRPCRouteList contains a list of GRPCRoute.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * GRPCRouteList contains a list of GRPCRoute.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCRouteMatch.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCRouteMatch.java
index 1f07e52125a..1065ad5e5af 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCRouteMatch.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCRouteMatch.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GRPCRouteMatch defines the predicate used to match requests to a given action. Multiple match types are ANDed together, i.e. the match will evaluate to true only if all conditions are satisfied.<br><p> <br><p> For example, the match below will match a gRPC request only if its service is `foo` AND it contains the `version: v1` header:<br><p> <br><p> ``` matches:<br><p>   - method:<br><p>     type: Exact<br><p>     service: "foo"<br><p>     headers:<br><p>   - name: "version"<br><p>     value "v1"<br><p> <br><p> ```
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public GRPCRouteMatch(List<GRPCHeaderMatch> headers, GRPCMethodMatch method) {
         this.method = method;
     }
 
+    /**
+     * Headers specifies gRPC request header matchers. Multiple match values are ANDed together, meaning, a request MUST match all the specified headers to select the route.
+     */
     @JsonProperty("headers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GRPCHeaderMatch> getHeaders() {
         return headers;
     }
 
+    /**
+     * Headers specifies gRPC request header matchers. Multiple match values are ANDed together, meaning, a request MUST match all the specified headers to select the route.
+     */
     @JsonProperty("headers")
     public void setHeaders(List<GRPCHeaderMatch> headers) {
         this.headers = headers;
     }
 
+    /**
+     * GRPCRouteMatch defines the predicate used to match requests to a given action. Multiple match types are ANDed together, i.e. the match will evaluate to true only if all conditions are satisfied.<br><p> <br><p> For example, the match below will match a gRPC request only if its service is `foo` AND it contains the `version: v1` header:<br><p> <br><p> ``` matches:<br><p>   - method:<br><p>     type: Exact<br><p>     service: "foo"<br><p>     headers:<br><p>   - name: "version"<br><p>     value "v1"<br><p> <br><p> ```
+     */
     @JsonProperty("method")
     public GRPCMethodMatch getMethod() {
         return method;
     }
 
+    /**
+     * GRPCRouteMatch defines the predicate used to match requests to a given action. Multiple match types are ANDed together, i.e. the match will evaluate to true only if all conditions are satisfied.<br><p> <br><p> For example, the match below will match a gRPC request only if its service is `foo` AND it contains the `version: v1` header:<br><p> <br><p> ``` matches:<br><p>   - method:<br><p>     type: Exact<br><p>     service: "foo"<br><p>     headers:<br><p>   - name: "version"<br><p>     value "v1"<br><p> <br><p> ```
+     */
     @JsonProperty("method")
     public void setMethod(GRPCMethodMatch method) {
         this.method = method;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCRouteRule.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCRouteRule.java
index a21c23c7fcc..406000c3762 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCRouteRule.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCRouteRule.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GRPCRouteRule defines the semantics for matching a gRPC request based on conditions (matches), processing it (filters), and forwarding the request to an API object (backendRefs).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -99,54 +102,84 @@ public GRPCRouteRule(List<GRPCBackendRef> backendRefs, List<GRPCRouteFilter> fil
         this.sessionPersistence = sessionPersistence;
     }
 
+    /**
+     * BackendRefs defines the backend(s) where matching requests should be sent.<br><p> <br><p> Failure behavior here depends on how many BackendRefs are specified and how many are invalid.<br><p> <br><p> If &#42;all&#42; entries in BackendRefs are invalid, and there are also no filters specified in this route rule, &#42;all&#42; traffic which matches this rule MUST receive an `UNAVAILABLE` status.<br><p> <br><p> See the GRPCBackendRef definition for the rules about what makes a single GRPCBackendRef invalid.<br><p> <br><p> When a GRPCBackendRef is invalid, `UNAVAILABLE` statuses MUST be returned for requests that would have otherwise been routed to an invalid backend. If multiple backends are specified, and some are invalid, the proportion of requests that would otherwise have been routed to an invalid backend MUST receive an `UNAVAILABLE` status.<br><p> <br><p> For example, if two backends are specified with equal weights, and one is invalid, 50 percent of traffic MUST receive an `UNAVAILABLE` status. Implementations may choose how that 50 percent is determined.<br><p> <br><p> Support: Core for Kubernetes Service<br><p> <br><p> Support: Implementation-specific for any other resource<br><p> <br><p> Support for weight: Core
+     */
     @JsonProperty("backendRefs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GRPCBackendRef> getBackendRefs() {
         return backendRefs;
     }
 
+    /**
+     * BackendRefs defines the backend(s) where matching requests should be sent.<br><p> <br><p> Failure behavior here depends on how many BackendRefs are specified and how many are invalid.<br><p> <br><p> If &#42;all&#42; entries in BackendRefs are invalid, and there are also no filters specified in this route rule, &#42;all&#42; traffic which matches this rule MUST receive an `UNAVAILABLE` status.<br><p> <br><p> See the GRPCBackendRef definition for the rules about what makes a single GRPCBackendRef invalid.<br><p> <br><p> When a GRPCBackendRef is invalid, `UNAVAILABLE` statuses MUST be returned for requests that would have otherwise been routed to an invalid backend. If multiple backends are specified, and some are invalid, the proportion of requests that would otherwise have been routed to an invalid backend MUST receive an `UNAVAILABLE` status.<br><p> <br><p> For example, if two backends are specified with equal weights, and one is invalid, 50 percent of traffic MUST receive an `UNAVAILABLE` status. Implementations may choose how that 50 percent is determined.<br><p> <br><p> Support: Core for Kubernetes Service<br><p> <br><p> Support: Implementation-specific for any other resource<br><p> <br><p> Support for weight: Core
+     */
     @JsonProperty("backendRefs")
     public void setBackendRefs(List<GRPCBackendRef> backendRefs) {
         this.backendRefs = backendRefs;
     }
 
+    /**
+     * Filters define the filters that are applied to requests that match this rule.<br><p> <br><p> The effects of ordering of multiple behaviors are currently unspecified. This can change in the future based on feedback during the alpha stage.<br><p> <br><p> Conformance-levels at this level are defined based on the type of filter:<br><p> <br><p> - ALL core filters MUST be supported by all implementations that support<br><p>   GRPCRoute.<br><p> - Implementers are encouraged to support extended filters. - Implementation-specific custom filters have no API guarantees across<br><p>   implementations.<br><p> <br><p> Specifying the same filter multiple times is not supported unless explicitly indicated in the filter.<br><p> <br><p> If an implementation can not support a combination of filters, it must clearly document that limitation. In cases where incompatible or unsupported filters are specified and cause the `Accepted` condition to be set to status `False`, implementations may use the `IncompatibleFilters` reason to specify this configuration error.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("filters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GRPCRouteFilter> getFilters() {
         return filters;
     }
 
+    /**
+     * Filters define the filters that are applied to requests that match this rule.<br><p> <br><p> The effects of ordering of multiple behaviors are currently unspecified. This can change in the future based on feedback during the alpha stage.<br><p> <br><p> Conformance-levels at this level are defined based on the type of filter:<br><p> <br><p> - ALL core filters MUST be supported by all implementations that support<br><p>   GRPCRoute.<br><p> - Implementers are encouraged to support extended filters. - Implementation-specific custom filters have no API guarantees across<br><p>   implementations.<br><p> <br><p> Specifying the same filter multiple times is not supported unless explicitly indicated in the filter.<br><p> <br><p> If an implementation can not support a combination of filters, it must clearly document that limitation. In cases where incompatible or unsupported filters are specified and cause the `Accepted` condition to be set to status `False`, implementations may use the `IncompatibleFilters` reason to specify this configuration error.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("filters")
     public void setFilters(List<GRPCRouteFilter> filters) {
         this.filters = filters;
     }
 
+    /**
+     * Matches define conditions used for matching the rule against incoming gRPC requests. Each match is independent, i.e. this rule will be matched if &#42;&#42;any&#42;&#42; one of the matches is satisfied.<br><p> <br><p> For example, take the following matches configuration:<br><p> <br><p> ``` matches: - method:<br><p>     service: foo.bar<br><p>   headers:<br><p>     values:<br><p>       version: 2<br><p> - method:<br><p>     service: foo.bar.v2<br><p> ```<br><p> <br><p> For a request to match against this rule, it MUST satisfy EITHER of the two conditions:<br><p> <br><p> - service of foo.bar AND contains the header `version: 2` - service of foo.bar.v2<br><p> <br><p> See the documentation for GRPCRouteMatch on how to specify multiple match conditions to be ANDed together.<br><p> <br><p> If no matches are specified, the implementation MUST match every gRPC request.<br><p> <br><p> Proxy or Load Balancer routing configuration generated from GRPCRoutes MUST prioritize rules based on the following criteria, continuing on ties. Merging MUST not be done between GRPCRoutes and HTTPRoutes. Precedence MUST be given to the rule with the largest number of:<br><p> <br><p> &#42; Characters in a matching non-wildcard hostname. &#42; Characters in a matching hostname. &#42; Characters in a matching service. &#42; Characters in a matching method. &#42; Header matches.<br><p> <br><p> If ties still exist across multiple Routes, matching precedence MUST be determined in order of the following criteria, continuing on ties:<br><p> <br><p> &#42; The oldest Route based on creation timestamp. &#42; The Route appearing first in alphabetical order by<br><p>   "{namespace}/{name}".<br><p> <br><p> If ties still exist within the Route that has been given precedence, matching precedence MUST be granted to the first matching rule meeting the above criteria.
+     */
     @JsonProperty("matches")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GRPCRouteMatch> getMatches() {
         return matches;
     }
 
+    /**
+     * Matches define conditions used for matching the rule against incoming gRPC requests. Each match is independent, i.e. this rule will be matched if &#42;&#42;any&#42;&#42; one of the matches is satisfied.<br><p> <br><p> For example, take the following matches configuration:<br><p> <br><p> ``` matches: - method:<br><p>     service: foo.bar<br><p>   headers:<br><p>     values:<br><p>       version: 2<br><p> - method:<br><p>     service: foo.bar.v2<br><p> ```<br><p> <br><p> For a request to match against this rule, it MUST satisfy EITHER of the two conditions:<br><p> <br><p> - service of foo.bar AND contains the header `version: 2` - service of foo.bar.v2<br><p> <br><p> See the documentation for GRPCRouteMatch on how to specify multiple match conditions to be ANDed together.<br><p> <br><p> If no matches are specified, the implementation MUST match every gRPC request.<br><p> <br><p> Proxy or Load Balancer routing configuration generated from GRPCRoutes MUST prioritize rules based on the following criteria, continuing on ties. Merging MUST not be done between GRPCRoutes and HTTPRoutes. Precedence MUST be given to the rule with the largest number of:<br><p> <br><p> &#42; Characters in a matching non-wildcard hostname. &#42; Characters in a matching hostname. &#42; Characters in a matching service. &#42; Characters in a matching method. &#42; Header matches.<br><p> <br><p> If ties still exist across multiple Routes, matching precedence MUST be determined in order of the following criteria, continuing on ties:<br><p> <br><p> &#42; The oldest Route based on creation timestamp. &#42; The Route appearing first in alphabetical order by<br><p>   "{namespace}/{name}".<br><p> <br><p> If ties still exist within the Route that has been given precedence, matching precedence MUST be granted to the first matching rule meeting the above criteria.
+     */
     @JsonProperty("matches")
     public void setMatches(List<GRPCRouteMatch> matches) {
         this.matches = matches;
     }
 
+    /**
+     * Name is the name of the route rule. This name MUST be unique within a Route if it is set.<br><p> <br><p> Support: Extended &lt;gateway:experimental&gt;
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the route rule. This name MUST be unique within a Route if it is set.<br><p> <br><p> Support: Extended &lt;gateway:experimental&gt;
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * GRPCRouteRule defines the semantics for matching a gRPC request based on conditions (matches), processing it (filters), and forwarding the request to an API object (backendRefs).
+     */
     @JsonProperty("sessionPersistence")
     public SessionPersistence getSessionPersistence() {
         return sessionPersistence;
     }
 
+    /**
+     * GRPCRouteRule defines the semantics for matching a gRPC request based on conditions (matches), processing it (filters), and forwarding the request to an API object (backendRefs).
+     */
     @JsonProperty("sessionPersistence")
     public void setSessionPersistence(SessionPersistence sessionPersistence) {
         this.sessionPersistence = sessionPersistence;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCRouteSpec.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCRouteSpec.java
index 924a7c145f2..d404868024a 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCRouteSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCRouteSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GRPCRouteSpec defines the desired state of GRPCRoute
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,34 +94,52 @@ public GRPCRouteSpec(List<String> hostnames, List<ParentReference> parentRefs, L
         this.rules = rules;
     }
 
+    /**
+     * Hostnames defines a set of hostnames to match against the GRPC Host header to select a GRPCRoute to process the request. This matches the RFC 1123 definition of a hostname with 2 notable exceptions:<br><p> <br><p> 1. IPs are not allowed. 2. A hostname may be prefixed with a wildcard label (`&#42;.`). The wildcard<br><p>    label MUST appear by itself as the first label.<br><p> <br><p> If a hostname is specified by both the Listener and GRPCRoute, there MUST be at least one intersecting hostname for the GRPCRoute to be attached to the Listener. For example:<br><p> <br><p> &#42; A Listener with `test.example.com` as the hostname matches GRPCRoutes<br><p>   that have either not specified any hostnames, or have specified at<br><p>   least one of `test.example.com` or `&#42;.example.com`.<br><p> &#42; A Listener with `&#42;.example.com` as the hostname matches GRPCRoutes<br><p>   that have either not specified any hostnames or have specified at least<br><p>   one hostname that matches the Listener hostname. For example,<br><p>   `test.example.com` and `&#42;.example.com` would both match. On the other<br><p>   hand, `example.com` and `test.example.net` would not match.<br><p> <br><p> Hostnames that are prefixed with a wildcard label (`&#42;.`) are interpreted as a suffix match. That means that a match for `&#42;.example.com` would match both `test.example.com`, and `foo.test.example.com`, but not `example.com`.<br><p> <br><p> If both the Listener and GRPCRoute have specified hostnames, any GRPCRoute hostnames that do not match the Listener hostname MUST be ignored. For example, if a Listener specified `&#42;.example.com`, and the GRPCRoute specified `test.example.com` and `test.example.net`, `test.example.net` MUST NOT be considered for a match.<br><p> <br><p> If both the Listener and GRPCRoute have specified hostnames, and none match with the criteria above, then the GRPCRoute MUST NOT be accepted by the implementation. The implementation MUST raise an 'Accepted' Condition with a status of `False` in the corresponding RouteParentStatus.<br><p> <br><p> If a Route (A) of type HTTPRoute or GRPCRoute is attached to a Listener and that listener already has another Route (B) of the other type attached and the intersection of the hostnames of A and B is non-empty, then the implementation MUST accept exactly one of these two routes, determined by the following criteria, in order:<br><p> <br><p> &#42; The oldest Route based on creation timestamp. &#42; The Route appearing first in alphabetical order by<br><p>   "{namespace}/{name}".<br><p> <br><p> The rejected Route MUST raise an 'Accepted' condition with a status of 'False' in the corresponding RouteParentStatus.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("hostnames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getHostnames() {
         return hostnames;
     }
 
+    /**
+     * Hostnames defines a set of hostnames to match against the GRPC Host header to select a GRPCRoute to process the request. This matches the RFC 1123 definition of a hostname with 2 notable exceptions:<br><p> <br><p> 1. IPs are not allowed. 2. A hostname may be prefixed with a wildcard label (`&#42;.`). The wildcard<br><p>    label MUST appear by itself as the first label.<br><p> <br><p> If a hostname is specified by both the Listener and GRPCRoute, there MUST be at least one intersecting hostname for the GRPCRoute to be attached to the Listener. For example:<br><p> <br><p> &#42; A Listener with `test.example.com` as the hostname matches GRPCRoutes<br><p>   that have either not specified any hostnames, or have specified at<br><p>   least one of `test.example.com` or `&#42;.example.com`.<br><p> &#42; A Listener with `&#42;.example.com` as the hostname matches GRPCRoutes<br><p>   that have either not specified any hostnames or have specified at least<br><p>   one hostname that matches the Listener hostname. For example,<br><p>   `test.example.com` and `&#42;.example.com` would both match. On the other<br><p>   hand, `example.com` and `test.example.net` would not match.<br><p> <br><p> Hostnames that are prefixed with a wildcard label (`&#42;.`) are interpreted as a suffix match. That means that a match for `&#42;.example.com` would match both `test.example.com`, and `foo.test.example.com`, but not `example.com`.<br><p> <br><p> If both the Listener and GRPCRoute have specified hostnames, any GRPCRoute hostnames that do not match the Listener hostname MUST be ignored. For example, if a Listener specified `&#42;.example.com`, and the GRPCRoute specified `test.example.com` and `test.example.net`, `test.example.net` MUST NOT be considered for a match.<br><p> <br><p> If both the Listener and GRPCRoute have specified hostnames, and none match with the criteria above, then the GRPCRoute MUST NOT be accepted by the implementation. The implementation MUST raise an 'Accepted' Condition with a status of `False` in the corresponding RouteParentStatus.<br><p> <br><p> If a Route (A) of type HTTPRoute or GRPCRoute is attached to a Listener and that listener already has another Route (B) of the other type attached and the intersection of the hostnames of A and B is non-empty, then the implementation MUST accept exactly one of these two routes, determined by the following criteria, in order:<br><p> <br><p> &#42; The oldest Route based on creation timestamp. &#42; The Route appearing first in alphabetical order by<br><p>   "{namespace}/{name}".<br><p> <br><p> The rejected Route MUST raise an 'Accepted' condition with a status of 'False' in the corresponding RouteParentStatus.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("hostnames")
     public void setHostnames(List<String> hostnames) {
         this.hostnames = hostnames;
     }
 
+    /**
+     * ParentRefs references the resources (usually Gateways) that a Route wants to be attached to. Note that the referenced parent resource needs to allow this for the attachment to be complete. For Gateways, that means the Gateway needs to allow attachment from Routes of this kind and namespace. For Services, that means the Service must either be in the same namespace for a "producer" route, or the mesh implementation must support and allow "consumer" routes for the referenced Service. ReferenceGrant is not applicable for governing ParentRefs to Services - it is not possible to create a "producer" route for a Service in a different namespace from the Route.<br><p> <br><p> There are two kinds of parent resources with "Core" support:<br><p> <br><p> &#42; Gateway (Gateway conformance profile) &#42; Service (Mesh conformance profile, ClusterIP Services only)<br><p> <br><p> This API may be extended in the future to support additional kinds of parent resources.<br><p> <br><p> ParentRefs must be _distinct_. This means either that:<br><p> <br><p> &#42; They select different objects.  If this is the case, then parentRef<br><p>   entries are distinct. In terms of fields, this means that the<br><p>   multi-part key defined by `group`, `kind`, `namespace`, and `name` must<br><p>   be unique across all parentRef entries in the Route.<br><p> &#42; They do not select different objects, but for each optional field used,<br><p>   each ParentRef that selects the same object must set the same set of<br><p>   optional fields to different values. If one ParentRef sets a<br><p>   combination of optional fields, all must set the same combination.<br><p> <br><p> Some examples:<br><p> <br><p> &#42; If one ParentRef sets `sectionName`, all ParentRefs referencing the<br><p>   same object must also set `sectionName`.<br><p> &#42; If one ParentRef sets `port`, all ParentRefs referencing the same<br><p>   object must also set `port`.<br><p> &#42; If one ParentRef sets `sectionName` and `port`, all ParentRefs<br><p>   referencing the same object must also set `sectionName` and `port`.<br><p> <br><p> It is possible to separately reference multiple distinct objects that may be collapsed by an implementation. For example, some implementations may choose to merge compatible Gateway Listeners together. If that is the case, the list of routes attached to those resources should also be merged.<br><p> <br><p> Note that for ParentRefs that cross namespace boundaries, there are specific rules. Cross-namespace references are only valid if they are explicitly allowed by something in the namespace they are referring to. For example, Gateway has the AllowedRoutes field, and ReferenceGrant provides a generic way to enable other kinds of cross-namespace reference.<br><p> <br><p> &lt;gateway:experimental:description&gt; ParentRefs from a Route to a Service in the same namespace are "producer" routes, which apply default routing rules to inbound connections from any namespace to the Service.<br><p> <br><p> ParentRefs from a Route to a Service in a different namespace are "consumer" routes, and these routing rules are only applied to outbound connections originating from the same namespace as the Route, for which the intended destination of the connections are a Service targeted as a ParentRef of the Route. &lt;/gateway:experimental:description&gt;<br><p> <br><p> &lt;gateway:standard:validation:XValidation:message="sectionName must be specified when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.all(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) ? ((!has(p1.sectionName) || p1.sectionName == '') == (!has(p2.sectionName) || p2.sectionName == '')) : true))"&gt; &lt;gateway:standard:validation:XValidation:message="sectionName must be unique when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.exists_one(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) &amp;&amp; (((!has(p1.sectionName) || p1.sectionName == '') &amp;&amp; (!has(p2.sectionName) || p2.sectionName == '')) || (has(p1.sectionName) &amp;&amp; has(p2.sectionName) &amp;&amp; p1.sectionName == p2.sectionName))))"&gt; &lt;gateway:experimental:validation:XValidation:message="sectionName or port must be specified when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.all(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__)) ? ((!has(p1.sectionName) || p1.sectionName == '') == (!has(p2.sectionName) || p2.sectionName == '') &amp;&amp; (!has(p1.port) || p1.port == 0) == (!has(p2.port) || p2.port == 0)): true))"&gt; &lt;gateway:experimental:validation:XValidation:message="sectionName or port must be unique when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.exists_one(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) &amp;&amp; (((!has(p1.sectionName) || p1.sectionName == '') &amp;&amp; (!has(p2.sectionName) || p2.sectionName == '')) || ( has(p1.sectionName) &amp;&amp; has(p2.sectionName) &amp;&amp; p1.sectionName == p2.sectionName)) &amp;&amp; (((!has(p1.port) || p1.port == 0) &amp;&amp; (!has(p2.port) || p2.port == 0)) || (has(p1.port) &amp;&amp; has(p2.port) &amp;&amp; p1.port == p2.port))))"&gt;
+     */
     @JsonProperty("parentRefs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ParentReference> getParentRefs() {
         return parentRefs;
     }
 
+    /**
+     * ParentRefs references the resources (usually Gateways) that a Route wants to be attached to. Note that the referenced parent resource needs to allow this for the attachment to be complete. For Gateways, that means the Gateway needs to allow attachment from Routes of this kind and namespace. For Services, that means the Service must either be in the same namespace for a "producer" route, or the mesh implementation must support and allow "consumer" routes for the referenced Service. ReferenceGrant is not applicable for governing ParentRefs to Services - it is not possible to create a "producer" route for a Service in a different namespace from the Route.<br><p> <br><p> There are two kinds of parent resources with "Core" support:<br><p> <br><p> &#42; Gateway (Gateway conformance profile) &#42; Service (Mesh conformance profile, ClusterIP Services only)<br><p> <br><p> This API may be extended in the future to support additional kinds of parent resources.<br><p> <br><p> ParentRefs must be _distinct_. This means either that:<br><p> <br><p> &#42; They select different objects.  If this is the case, then parentRef<br><p>   entries are distinct. In terms of fields, this means that the<br><p>   multi-part key defined by `group`, `kind`, `namespace`, and `name` must<br><p>   be unique across all parentRef entries in the Route.<br><p> &#42; They do not select different objects, but for each optional field used,<br><p>   each ParentRef that selects the same object must set the same set of<br><p>   optional fields to different values. If one ParentRef sets a<br><p>   combination of optional fields, all must set the same combination.<br><p> <br><p> Some examples:<br><p> <br><p> &#42; If one ParentRef sets `sectionName`, all ParentRefs referencing the<br><p>   same object must also set `sectionName`.<br><p> &#42; If one ParentRef sets `port`, all ParentRefs referencing the same<br><p>   object must also set `port`.<br><p> &#42; If one ParentRef sets `sectionName` and `port`, all ParentRefs<br><p>   referencing the same object must also set `sectionName` and `port`.<br><p> <br><p> It is possible to separately reference multiple distinct objects that may be collapsed by an implementation. For example, some implementations may choose to merge compatible Gateway Listeners together. If that is the case, the list of routes attached to those resources should also be merged.<br><p> <br><p> Note that for ParentRefs that cross namespace boundaries, there are specific rules. Cross-namespace references are only valid if they are explicitly allowed by something in the namespace they are referring to. For example, Gateway has the AllowedRoutes field, and ReferenceGrant provides a generic way to enable other kinds of cross-namespace reference.<br><p> <br><p> &lt;gateway:experimental:description&gt; ParentRefs from a Route to a Service in the same namespace are "producer" routes, which apply default routing rules to inbound connections from any namespace to the Service.<br><p> <br><p> ParentRefs from a Route to a Service in a different namespace are "consumer" routes, and these routing rules are only applied to outbound connections originating from the same namespace as the Route, for which the intended destination of the connections are a Service targeted as a ParentRef of the Route. &lt;/gateway:experimental:description&gt;<br><p> <br><p> &lt;gateway:standard:validation:XValidation:message="sectionName must be specified when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.all(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) ? ((!has(p1.sectionName) || p1.sectionName == '') == (!has(p2.sectionName) || p2.sectionName == '')) : true))"&gt; &lt;gateway:standard:validation:XValidation:message="sectionName must be unique when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.exists_one(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) &amp;&amp; (((!has(p1.sectionName) || p1.sectionName == '') &amp;&amp; (!has(p2.sectionName) || p2.sectionName == '')) || (has(p1.sectionName) &amp;&amp; has(p2.sectionName) &amp;&amp; p1.sectionName == p2.sectionName))))"&gt; &lt;gateway:experimental:validation:XValidation:message="sectionName or port must be specified when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.all(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__)) ? ((!has(p1.sectionName) || p1.sectionName == '') == (!has(p2.sectionName) || p2.sectionName == '') &amp;&amp; (!has(p1.port) || p1.port == 0) == (!has(p2.port) || p2.port == 0)): true))"&gt; &lt;gateway:experimental:validation:XValidation:message="sectionName or port must be unique when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.exists_one(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) &amp;&amp; (((!has(p1.sectionName) || p1.sectionName == '') &amp;&amp; (!has(p2.sectionName) || p2.sectionName == '')) || ( has(p1.sectionName) &amp;&amp; has(p2.sectionName) &amp;&amp; p1.sectionName == p2.sectionName)) &amp;&amp; (((!has(p1.port) || p1.port == 0) &amp;&amp; (!has(p2.port) || p2.port == 0)) || (has(p1.port) &amp;&amp; has(p2.port) &amp;&amp; p1.port == p2.port))))"&gt;
+     */
     @JsonProperty("parentRefs")
     public void setParentRefs(List<ParentReference> parentRefs) {
         this.parentRefs = parentRefs;
     }
 
+    /**
+     * Rules are a list of GRPC matchers, filters and actions.<br><p> <br><p> &lt;gateway:experimental:validation:XValidation:message="Rule name must be unique within the route",rule="self.all(l1, !has(l1.name) || self.exists_one(l2, has(l2.name) &amp;&amp; l1.name == l2.name))"&gt;
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GRPCRouteRule> getRules() {
         return rules;
     }
 
+    /**
+     * Rules are a list of GRPC matchers, filters and actions.<br><p> <br><p> &lt;gateway:experimental:validation:XValidation:message="Rule name must be unique within the route",rule="self.all(l1, !has(l1.name) || self.exists_one(l2, has(l2.name) &amp;&amp; l1.name == l2.name))"&gt;
+     */
     @JsonProperty("rules")
     public void setRules(List<GRPCRouteRule> rules) {
         this.rules = rules;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCRouteStatus.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCRouteStatus.java
index 729aa9d4c50..e9f83c22fb4 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCRouteStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GRPCRouteStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GRPCRouteStatus defines the observed state of GRPCRoute.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public GRPCRouteStatus(List<RouteParentStatus> parents) {
         this.parents = parents;
     }
 
+    /**
+     * Parents is a list of parent resources (usually Gateways) that are associated with the route, and the status of the route with respect to each parent. When this route attaches to a parent, the controller that manages the parent must add an entry to this list when the controller first sees the route and should update the entry as appropriate when the route or gateway is modified.<br><p> <br><p> Note that parent references that cannot be resolved by an implementation of this API will not be added to this list. Implementations of this API can only populate Route status for the Gateways/parent resources they are responsible for.<br><p> <br><p> A maximum of 32 Gateways will be represented in this list. An empty list means the route has not been attached to any Gateway.
+     */
     @JsonProperty("parents")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RouteParentStatus> getParents() {
         return parents;
     }
 
+    /**
+     * Parents is a list of parent resources (usually Gateways) that are associated with the route, and the status of the route with respect to each parent. When this route attaches to a parent, the controller that manages the parent must add an entry to this list when the controller first sees the route and should update the entry as appropriate when the route or gateway is modified.<br><p> <br><p> Note that parent references that cannot be resolved by an implementation of this API will not be added to this list. Implementations of this API can only populate Route status for the Gateways/parent resources they are responsible for.<br><p> <br><p> A maximum of 32 Gateways will be represented in this list. An empty list means the route has not been attached to any Gateway.
+     */
     @JsonProperty("parents")
     public void setParents(List<RouteParentStatus> parents) {
         this.parents = parents;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/Gateway.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/Gateway.java
index 62bbaa2f224..739c7dcfc94 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/Gateway.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/Gateway.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Gateway represents an instance of a service-traffic handling infrastructure by binding Listeners to a set of IP addresses.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Gateway implements Editable<GatewayBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Gateway";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Gateway(String apiVersion, String kind, ObjectMeta metadata, GatewaySpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Gateway represents an instance of a service-traffic handling infrastructure by binding Listeners to a set of IP addresses.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Gateway represents an instance of a service-traffic handling infrastructure by binding Listeners to a set of IP addresses.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Gateway represents an instance of a service-traffic handling infrastructure by binding Listeners to a set of IP addresses.
+     */
     @JsonProperty("spec")
     public GatewaySpec getSpec() {
         return spec;
     }
 
+    /**
+     * Gateway represents an instance of a service-traffic handling infrastructure by binding Listeners to a set of IP addresses.
+     */
     @JsonProperty("spec")
     public void setSpec(GatewaySpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Gateway represents an instance of a service-traffic handling infrastructure by binding Listeners to a set of IP addresses.
+     */
     @JsonProperty("status")
     public GatewayStatus getStatus() {
         return status;
     }
 
+    /**
+     * Gateway represents an instance of a service-traffic handling infrastructure by binding Listeners to a set of IP addresses.
+     */
     @JsonProperty("status")
     public void setStatus(GatewayStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayAddress.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayAddress.java
index 013447a2e7b..cfdc772b14a 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayAddress.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayAddress.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GatewayAddress describes an address that can be bound to a Gateway.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public GatewayAddress(String type, String value) {
         this.value = value;
     }
 
+    /**
+     * Type of the address.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of the address.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * Value of the address. The validity of the values will depend on the type and support by the controller.<br><p> <br><p> Examples: `1.2.3.4`, `128::1`, `my-ip-address`.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value of the address. The validity of the values will depend on the type and support by the controller.<br><p> <br><p> Examples: `1.2.3.4`, `128::1`, `my-ip-address`.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayBackendTLS.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayBackendTLS.java
index f1a69e9597d..d90fee41a36 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayBackendTLS.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayBackendTLS.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GatewayBackendTLS describes backend TLS configuration for gateway.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public GatewayBackendTLS(SecretObjectReference clientCertificateRef) {
         this.clientCertificateRef = clientCertificateRef;
     }
 
+    /**
+     * GatewayBackendTLS describes backend TLS configuration for gateway.
+     */
     @JsonProperty("clientCertificateRef")
     public SecretObjectReference getClientCertificateRef() {
         return clientCertificateRef;
     }
 
+    /**
+     * GatewayBackendTLS describes backend TLS configuration for gateway.
+     */
     @JsonProperty("clientCertificateRef")
     public void setClientCertificateRef(SecretObjectReference clientCertificateRef) {
         this.clientCertificateRef = clientCertificateRef;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayClass.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayClass.java
index d54a420d1a0..99ea53c5874 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayClass.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayClass.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GatewayClass describes a class of Gateways available to the user for creating Gateway resources.<br><p> <br><p> It is recommended that this resource be used as a template for Gateways. This means that a Gateway is based on the state of the GatewayClass at the time it was created and changes to the GatewayClass or associated parameters are not propagated down to existing Gateways. This recommendation is intended to limit the blast radius of changes to GatewayClass or associated parameters. If implementations choose to propagate GatewayClass changes to existing Gateways, that MUST be clearly documented by the implementation.<br><p> <br><p> Whenever one or more Gateways are using a GatewayClass, implementations SHOULD add the `gateway-exists-finalizer.gateway.networking.k8s.io` finalizer on the associated GatewayClass. This ensures that a GatewayClass associated with a Gateway is not deleted while in use.<br><p> <br><p> GatewayClass is a Cluster level resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class GatewayClass implements Editable<GatewayClassBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GatewayClass";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public GatewayClass(String apiVersion, String kind, ObjectMeta metadata, Gateway
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * GatewayClass describes a class of Gateways available to the user for creating Gateway resources.<br><p> <br><p> It is recommended that this resource be used as a template for Gateways. This means that a Gateway is based on the state of the GatewayClass at the time it was created and changes to the GatewayClass or associated parameters are not propagated down to existing Gateways. This recommendation is intended to limit the blast radius of changes to GatewayClass or associated parameters. If implementations choose to propagate GatewayClass changes to existing Gateways, that MUST be clearly documented by the implementation.<br><p> <br><p> Whenever one or more Gateways are using a GatewayClass, implementations SHOULD add the `gateway-exists-finalizer.gateway.networking.k8s.io` finalizer on the associated GatewayClass. This ensures that a GatewayClass associated with a Gateway is not deleted while in use.<br><p> <br><p> GatewayClass is a Cluster level resource.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * GatewayClass describes a class of Gateways available to the user for creating Gateway resources.<br><p> <br><p> It is recommended that this resource be used as a template for Gateways. This means that a Gateway is based on the state of the GatewayClass at the time it was created and changes to the GatewayClass or associated parameters are not propagated down to existing Gateways. This recommendation is intended to limit the blast radius of changes to GatewayClass or associated parameters. If implementations choose to propagate GatewayClass changes to existing Gateways, that MUST be clearly documented by the implementation.<br><p> <br><p> Whenever one or more Gateways are using a GatewayClass, implementations SHOULD add the `gateway-exists-finalizer.gateway.networking.k8s.io` finalizer on the associated GatewayClass. This ensures that a GatewayClass associated with a Gateway is not deleted while in use.<br><p> <br><p> GatewayClass is a Cluster level resource.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * GatewayClass describes a class of Gateways available to the user for creating Gateway resources.<br><p> <br><p> It is recommended that this resource be used as a template for Gateways. This means that a Gateway is based on the state of the GatewayClass at the time it was created and changes to the GatewayClass or associated parameters are not propagated down to existing Gateways. This recommendation is intended to limit the blast radius of changes to GatewayClass or associated parameters. If implementations choose to propagate GatewayClass changes to existing Gateways, that MUST be clearly documented by the implementation.<br><p> <br><p> Whenever one or more Gateways are using a GatewayClass, implementations SHOULD add the `gateway-exists-finalizer.gateway.networking.k8s.io` finalizer on the associated GatewayClass. This ensures that a GatewayClass associated with a Gateway is not deleted while in use.<br><p> <br><p> GatewayClass is a Cluster level resource.
+     */
     @JsonProperty("spec")
     public GatewayClassSpec getSpec() {
         return spec;
     }
 
+    /**
+     * GatewayClass describes a class of Gateways available to the user for creating Gateway resources.<br><p> <br><p> It is recommended that this resource be used as a template for Gateways. This means that a Gateway is based on the state of the GatewayClass at the time it was created and changes to the GatewayClass or associated parameters are not propagated down to existing Gateways. This recommendation is intended to limit the blast radius of changes to GatewayClass or associated parameters. If implementations choose to propagate GatewayClass changes to existing Gateways, that MUST be clearly documented by the implementation.<br><p> <br><p> Whenever one or more Gateways are using a GatewayClass, implementations SHOULD add the `gateway-exists-finalizer.gateway.networking.k8s.io` finalizer on the associated GatewayClass. This ensures that a GatewayClass associated with a Gateway is not deleted while in use.<br><p> <br><p> GatewayClass is a Cluster level resource.
+     */
     @JsonProperty("spec")
     public void setSpec(GatewayClassSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * GatewayClass describes a class of Gateways available to the user for creating Gateway resources.<br><p> <br><p> It is recommended that this resource be used as a template for Gateways. This means that a Gateway is based on the state of the GatewayClass at the time it was created and changes to the GatewayClass or associated parameters are not propagated down to existing Gateways. This recommendation is intended to limit the blast radius of changes to GatewayClass or associated parameters. If implementations choose to propagate GatewayClass changes to existing Gateways, that MUST be clearly documented by the implementation.<br><p> <br><p> Whenever one or more Gateways are using a GatewayClass, implementations SHOULD add the `gateway-exists-finalizer.gateway.networking.k8s.io` finalizer on the associated GatewayClass. This ensures that a GatewayClass associated with a Gateway is not deleted while in use.<br><p> <br><p> GatewayClass is a Cluster level resource.
+     */
     @JsonProperty("status")
     public GatewayClassStatus getStatus() {
         return status;
     }
 
+    /**
+     * GatewayClass describes a class of Gateways available to the user for creating Gateway resources.<br><p> <br><p> It is recommended that this resource be used as a template for Gateways. This means that a Gateway is based on the state of the GatewayClass at the time it was created and changes to the GatewayClass or associated parameters are not propagated down to existing Gateways. This recommendation is intended to limit the blast radius of changes to GatewayClass or associated parameters. If implementations choose to propagate GatewayClass changes to existing Gateways, that MUST be clearly documented by the implementation.<br><p> <br><p> Whenever one or more Gateways are using a GatewayClass, implementations SHOULD add the `gateway-exists-finalizer.gateway.networking.k8s.io` finalizer on the associated GatewayClass. This ensures that a GatewayClass associated with a Gateway is not deleted while in use.<br><p> <br><p> GatewayClass is a Cluster level resource.
+     */
     @JsonProperty("status")
     public void setStatus(GatewayClassStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayClassList.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayClassList.java
index 32d437d7b1a..21266b763d4 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayClassList.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayClassList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GatewayClassList contains a list of GatewayClass
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class GatewayClassList implements Editable<GatewayClassListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.gatewayapi.v1.GatewayClass>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.gatewayapi.v1.GatewayClass> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GatewayClassList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public GatewayClassList(String apiVersion, List<io.fabric8.kubernetes.api.model.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * GatewayClassList contains a list of GatewayClass
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.gatewayapi.v1.GatewayClass> getItems() {
         return items;
     }
 
+    /**
+     * GatewayClassList contains a list of GatewayClass
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.gatewayapi.v1.GatewayClass> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * GatewayClassList contains a list of GatewayClass
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * GatewayClassList contains a list of GatewayClass
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayClassSpec.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayClassSpec.java
index df91df3b49b..5be5be9f4eb 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayClassSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayClassSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GatewayClassSpec reflects the configuration of a class of Gateways.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public GatewayClassSpec(String controllerName, String description, ParametersRef
         this.parametersRef = parametersRef;
     }
 
+    /**
+     * ControllerName is the name of the controller that is managing Gateways of this class. The value of this field MUST be a domain prefixed path.<br><p> <br><p> Example: "example.net/gateway-controller".<br><p> <br><p> This field is not mutable and cannot be empty.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("controllerName")
     public String getControllerName() {
         return controllerName;
     }
 
+    /**
+     * ControllerName is the name of the controller that is managing Gateways of this class. The value of this field MUST be a domain prefixed path.<br><p> <br><p> Example: "example.net/gateway-controller".<br><p> <br><p> This field is not mutable and cannot be empty.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("controllerName")
     public void setControllerName(String controllerName) {
         this.controllerName = controllerName;
     }
 
+    /**
+     * Description helps describe a GatewayClass with more details.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description helps describe a GatewayClass with more details.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * GatewayClassSpec reflects the configuration of a class of Gateways.
+     */
     @JsonProperty("parametersRef")
     public ParametersReference getParametersRef() {
         return parametersRef;
     }
 
+    /**
+     * GatewayClassSpec reflects the configuration of a class of Gateways.
+     */
     @JsonProperty("parametersRef")
     public void setParametersRef(ParametersReference parametersRef) {
         this.parametersRef = parametersRef;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayClassStatus.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayClassStatus.java
index 6212d7e64ab..cc9bdeea4f8 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayClassStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayClassStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GatewayClassStatus is the current status for the GatewayClass.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,23 +90,35 @@ public GatewayClassStatus(List<Condition> conditions, List<SupportedFeature> sup
         this.supportedFeatures = supportedFeatures;
     }
 
+    /**
+     * Conditions is the current status from the controller for this GatewayClass.<br><p> <br><p> Controllers should prefer to publish conditions using values of GatewayClassConditionType for the type of each Condition.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions is the current status from the controller for this GatewayClass.<br><p> <br><p> Controllers should prefer to publish conditions using values of GatewayClassConditionType for the type of each Condition.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * SupportedFeatures is the set of features the GatewayClass support. It MUST be sorted in ascending alphabetical order by the Name key. &lt;gateway:experimental&gt;
+     */
     @JsonProperty("supportedFeatures")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SupportedFeature> getSupportedFeatures() {
         return supportedFeatures;
     }
 
+    /**
+     * SupportedFeatures is the set of features the GatewayClass support. It MUST be sorted in ascending alphabetical order by the Name key. &lt;gateway:experimental&gt;
+     */
     @JsonProperty("supportedFeatures")
     public void setSupportedFeatures(List<SupportedFeature> supportedFeatures) {
         this.supportedFeatures = supportedFeatures;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayInfrastructure.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayInfrastructure.java
index 516db669e4c..fb6adc5df57 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayInfrastructure.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayInfrastructure.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GatewayInfrastructure defines infrastructure level attributes about a Gateway instance.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -88,33 +91,51 @@ public GatewayInfrastructure(Map<String, String> annotations, Map<String, String
         this.parametersRef = parametersRef;
     }
 
+    /**
+     * Annotations that SHOULD be applied to any resources created in response to this Gateway.<br><p> <br><p> For implementations creating other Kubernetes objects, this should be the `metadata.annotations` field on resources. For other implementations, this refers to any relevant (implementation specific) "annotations" concepts.<br><p> <br><p> An implementation may chose to add additional implementation-specific annotations as they see fit.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations that SHOULD be applied to any resources created in response to this Gateway.<br><p> <br><p> For implementations creating other Kubernetes objects, this should be the `metadata.annotations` field on resources. For other implementations, this refers to any relevant (implementation specific) "annotations" concepts.<br><p> <br><p> An implementation may chose to add additional implementation-specific annotations as they see fit.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Labels that SHOULD be applied to any resources created in response to this Gateway.<br><p> <br><p> For implementations creating other Kubernetes objects, this should be the `metadata.labels` field on resources. For other implementations, this refers to any relevant (implementation specific) "labels" concepts.<br><p> <br><p> An implementation may chose to add additional implementation-specific labels as they see fit.<br><p> <br><p> If an implementation maps these labels to Pods, or any other resource that would need to be recreated when labels change, it SHOULD clearly warn about this behavior in documentation.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabels() {
         return labels;
     }
 
+    /**
+     * Labels that SHOULD be applied to any resources created in response to this Gateway.<br><p> <br><p> For implementations creating other Kubernetes objects, this should be the `metadata.labels` field on resources. For other implementations, this refers to any relevant (implementation specific) "labels" concepts.<br><p> <br><p> An implementation may chose to add additional implementation-specific labels as they see fit.<br><p> <br><p> If an implementation maps these labels to Pods, or any other resource that would need to be recreated when labels change, it SHOULD clearly warn about this behavior in documentation.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("labels")
     public void setLabels(Map<String, String> labels) {
         this.labels = labels;
     }
 
+    /**
+     * GatewayInfrastructure defines infrastructure level attributes about a Gateway instance.
+     */
     @JsonProperty("parametersRef")
     public LocalParametersReference getParametersRef() {
         return parametersRef;
     }
 
+    /**
+     * GatewayInfrastructure defines infrastructure level attributes about a Gateway instance.
+     */
     @JsonProperty("parametersRef")
     public void setParametersRef(LocalParametersReference parametersRef) {
         this.parametersRef = parametersRef;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayList.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayList.java
index 03061badb10..d4737af78d4 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayList.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GatewayList contains a list of Gateways.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class GatewayList implements Editable<GatewayListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.gatewayapi.v1.Gateway>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.gatewayapi.v1.Gateway> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GatewayList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public GatewayList(String apiVersion, List<io.fabric8.kubernetes.api.model.gatew
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * GatewayList contains a list of Gateways.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.gatewayapi.v1.Gateway> getItems() {
         return items;
     }
 
+    /**
+     * GatewayList contains a list of Gateways.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.gatewayapi.v1.Gateway> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * GatewayList contains a list of Gateways.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * GatewayList contains a list of Gateways.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewaySpec.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewaySpec.java
index fc4d67a1d78..6500607e9b6 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewaySpec.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewaySpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GatewaySpec defines the desired state of Gateway.<br><p> <br><p> Not all possible combinations of options specified in the Spec are valid. Some invalid configurations can be caught synchronously via CRD validation, but there are many cases that will require asynchronous signaling via the GatewayStatus block.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,53 +101,83 @@ public GatewaySpec(List<GatewayAddress> addresses, GatewayBackendTLS backendTLS,
         this.listeners = listeners;
     }
 
+    /**
+     * Addresses requested for this Gateway. This is optional and behavior can depend on the implementation. If a value is set in the spec and the requested address is invalid or unavailable, the implementation MUST indicate this in the associated entry in GatewayStatus.Addresses.<br><p> <br><p> The Addresses field represents a request for the address(es) on the "outside of the Gateway", that traffic bound for this Gateway will use. This could be the IP address or hostname of an external load balancer or other networking infrastructure, or some other address that traffic will be sent to.<br><p> <br><p> If no Addresses are specified, the implementation MAY schedule the Gateway in an implementation-specific manner, assigning an appropriate set of Addresses.<br><p> <br><p> The implementation MUST bind all Listeners to every GatewayAddress that it assigns to the Gateway and add a corresponding entry in GatewayStatus.Addresses.<br><p> <br><p> Support: Extended<br><p> <br><p> &lt;gateway:validateIPAddress&gt;
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GatewayAddress> getAddresses() {
         return addresses;
     }
 
+    /**
+     * Addresses requested for this Gateway. This is optional and behavior can depend on the implementation. If a value is set in the spec and the requested address is invalid or unavailable, the implementation MUST indicate this in the associated entry in GatewayStatus.Addresses.<br><p> <br><p> The Addresses field represents a request for the address(es) on the "outside of the Gateway", that traffic bound for this Gateway will use. This could be the IP address or hostname of an external load balancer or other networking infrastructure, or some other address that traffic will be sent to.<br><p> <br><p> If no Addresses are specified, the implementation MAY schedule the Gateway in an implementation-specific manner, assigning an appropriate set of Addresses.<br><p> <br><p> The implementation MUST bind all Listeners to every GatewayAddress that it assigns to the Gateway and add a corresponding entry in GatewayStatus.Addresses.<br><p> <br><p> Support: Extended<br><p> <br><p> &lt;gateway:validateIPAddress&gt;
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<GatewayAddress> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * GatewaySpec defines the desired state of Gateway.<br><p> <br><p> Not all possible combinations of options specified in the Spec are valid. Some invalid configurations can be caught synchronously via CRD validation, but there are many cases that will require asynchronous signaling via the GatewayStatus block.
+     */
     @JsonProperty("backendTLS")
     public GatewayBackendTLS getBackendTLS() {
         return backendTLS;
     }
 
+    /**
+     * GatewaySpec defines the desired state of Gateway.<br><p> <br><p> Not all possible combinations of options specified in the Spec are valid. Some invalid configurations can be caught synchronously via CRD validation, but there are many cases that will require asynchronous signaling via the GatewayStatus block.
+     */
     @JsonProperty("backendTLS")
     public void setBackendTLS(GatewayBackendTLS backendTLS) {
         this.backendTLS = backendTLS;
     }
 
+    /**
+     * GatewayClassName used for this Gateway. This is the name of a GatewayClass resource.
+     */
     @JsonProperty("gatewayClassName")
     public String getGatewayClassName() {
         return gatewayClassName;
     }
 
+    /**
+     * GatewayClassName used for this Gateway. This is the name of a GatewayClass resource.
+     */
     @JsonProperty("gatewayClassName")
     public void setGatewayClassName(String gatewayClassName) {
         this.gatewayClassName = gatewayClassName;
     }
 
+    /**
+     * GatewaySpec defines the desired state of Gateway.<br><p> <br><p> Not all possible combinations of options specified in the Spec are valid. Some invalid configurations can be caught synchronously via CRD validation, but there are many cases that will require asynchronous signaling via the GatewayStatus block.
+     */
     @JsonProperty("infrastructure")
     public GatewayInfrastructure getInfrastructure() {
         return infrastructure;
     }
 
+    /**
+     * GatewaySpec defines the desired state of Gateway.<br><p> <br><p> Not all possible combinations of options specified in the Spec are valid. Some invalid configurations can be caught synchronously via CRD validation, but there are many cases that will require asynchronous signaling via the GatewayStatus block.
+     */
     @JsonProperty("infrastructure")
     public void setInfrastructure(GatewayInfrastructure infrastructure) {
         this.infrastructure = infrastructure;
     }
 
+    /**
+     * Listeners associated with this Gateway. Listeners define logical endpoints that are bound on this Gateway's addresses. At least one Listener MUST be specified.<br><p> <br><p> Each Listener in a set of Listeners (for example, in a single Gateway) MUST be _distinct_, in that a traffic flow MUST be able to be assigned to exactly one listener. (This section uses "set of Listeners" rather than "Listeners in a single Gateway" because implementations MAY merge configuration from multiple Gateways onto a single data plane, and these rules _also_ apply in that case).<br><p> <br><p> Practically, this means that each listener in a set MUST have a unique combination of Port, Protocol, and, if supported by the protocol, Hostname.<br><p> <br><p> Some combinations of port, protocol, and TLS settings are considered Core support and MUST be supported by implementations based on their targeted conformance profile:<br><p> <br><p> HTTP Profile<br><p> <br><p> 1. HTTPRoute, Port: 80, Protocol: HTTP 2. HTTPRoute, Port: 443, Protocol: HTTPS, TLS Mode: Terminate, TLS keypair provided<br><p> <br><p> TLS Profile<br><p> <br><p> 1. TLSRoute, Port: 443, Protocol: TLS, TLS Mode: Passthrough<br><p> <br><p> "Distinct" Listeners have the following property:<br><p> <br><p> The implementation can match inbound requests to a single distinct Listener. When multiple Listeners share values for fields (for example, two Listeners with the same Port value), the implementation can match requests to only one of the Listeners using other Listener fields.<br><p> <br><p> For example, the following Listener scenarios are distinct:<br><p> <br><p> 1. Multiple Listeners with the same Port that all use the "HTTP"<br><p>    Protocol that all have unique Hostname values.<br><p> 2. Multiple Listeners with the same Port that use either the "HTTPS" or<br><p>    "TLS" Protocol that all have unique Hostname values.<br><p> 3. A mixture of "TCP" and "UDP" Protocol Listeners, where no Listener<br><p>    with the same Protocol has the same Port value.<br><p> <br><p> Some fields in the Listener struct have possible values that affect whether the Listener is distinct. Hostname is particularly relevant for HTTP or HTTPS protocols.<br><p> <br><p> When using the Hostname value to select between same-Port, same-Protocol Listeners, the Hostname value must be different on each Listener for the Listener to be distinct.<br><p> <br><p> When the Listeners are distinct based on Hostname, inbound request hostnames MUST match from the most specific to least specific Hostname values to choose the correct Listener and its associated set of Routes.<br><p> <br><p> Exact matches must be processed before wildcard matches, and wildcard matches must be processed before fallback (empty Hostname value) matches. For example, `"foo.example.com"` takes precedence over `"&#42;.example.com"`, and `"&#42;.example.com"` takes precedence over `""`.<br><p> <br><p> Additionally, if there are multiple wildcard entries, more specific wildcard entries must be processed before less specific wildcard entries. For example, `"&#42;.foo.example.com"` takes precedence over `"&#42;.example.com"`. The precise definition here is that the higher the number of dots in the hostname to the right of the wildcard character, the higher the precedence.<br><p> <br><p> The wildcard character will match any number of characters _and dots_ to the left, however, so `"&#42;.example.com"` will match both `"foo.bar.example.com"` _and_ `"bar.example.com"`.<br><p> <br><p> If a set of Listeners contains Listeners that are not distinct, then those Listeners are Conflicted, and the implementation MUST set the "Conflicted" condition in the Listener Status to "True".<br><p> <br><p> Implementations MAY choose to accept a Gateway with some Conflicted Listeners only if they only accept the partial Listener set that contains no Conflicted Listeners. To put this another way, implementations may accept a partial Listener set only if they throw out &#42;all&#42; the conflicting Listeners. No picking one of the conflicting listeners as the winner. This also means that the Gateway must have at least one non-conflicting Listener in this case, otherwise it violates the requirement that at least one Listener must be present.<br><p> <br><p> The implementation MUST set a "ListenersNotValid" condition on the Gateway Status when the Gateway contains Conflicted Listeners whether or not they accept the Gateway. That Condition SHOULD clearly indicate in the Message which Listeners are conflicted, and which are Accepted. Additionally, the Listener status for those listeners SHOULD indicate which Listeners are conflicted and not Accepted.<br><p> <br><p> A Gateway's Listeners are considered "compatible" if:<br><p> <br><p> 1. They are distinct. 2. The implementation can serve them in compliance with the Addresses<br><p>    requirement that all Listeners are available on all assigned<br><p>    addresses.<br><p> <br><p> Compatible combinations in Extended support are expected to vary across implementations. A combination that is compatible for one implementation may not be compatible for another.<br><p> <br><p> For example, an implementation that cannot serve both TCP and UDP listeners on the same address, or cannot mix HTTPS and generic TLS listens on the same port would not consider those cases compatible, even though they are distinct.<br><p> <br><p> Note that requests SHOULD match at most one Listener. For example, if Listeners are defined for "foo.example.com" and "&#42;.example.com", a request to "foo.example.com" SHOULD only be routed using routes attached to the "foo.example.com" Listener (and not the "&#42;.example.com" Listener). This concept is known as "Listener Isolation". Implementations that do not support Listener Isolation MUST clearly document this.<br><p> <br><p> Implementations MAY merge separate Gateways onto a single set of Addresses if all Listeners across all Gateways are compatible.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("listeners")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Listener> getListeners() {
         return listeners;
     }
 
+    /**
+     * Listeners associated with this Gateway. Listeners define logical endpoints that are bound on this Gateway's addresses. At least one Listener MUST be specified.<br><p> <br><p> Each Listener in a set of Listeners (for example, in a single Gateway) MUST be _distinct_, in that a traffic flow MUST be able to be assigned to exactly one listener. (This section uses "set of Listeners" rather than "Listeners in a single Gateway" because implementations MAY merge configuration from multiple Gateways onto a single data plane, and these rules _also_ apply in that case).<br><p> <br><p> Practically, this means that each listener in a set MUST have a unique combination of Port, Protocol, and, if supported by the protocol, Hostname.<br><p> <br><p> Some combinations of port, protocol, and TLS settings are considered Core support and MUST be supported by implementations based on their targeted conformance profile:<br><p> <br><p> HTTP Profile<br><p> <br><p> 1. HTTPRoute, Port: 80, Protocol: HTTP 2. HTTPRoute, Port: 443, Protocol: HTTPS, TLS Mode: Terminate, TLS keypair provided<br><p> <br><p> TLS Profile<br><p> <br><p> 1. TLSRoute, Port: 443, Protocol: TLS, TLS Mode: Passthrough<br><p> <br><p> "Distinct" Listeners have the following property:<br><p> <br><p> The implementation can match inbound requests to a single distinct Listener. When multiple Listeners share values for fields (for example, two Listeners with the same Port value), the implementation can match requests to only one of the Listeners using other Listener fields.<br><p> <br><p> For example, the following Listener scenarios are distinct:<br><p> <br><p> 1. Multiple Listeners with the same Port that all use the "HTTP"<br><p>    Protocol that all have unique Hostname values.<br><p> 2. Multiple Listeners with the same Port that use either the "HTTPS" or<br><p>    "TLS" Protocol that all have unique Hostname values.<br><p> 3. A mixture of "TCP" and "UDP" Protocol Listeners, where no Listener<br><p>    with the same Protocol has the same Port value.<br><p> <br><p> Some fields in the Listener struct have possible values that affect whether the Listener is distinct. Hostname is particularly relevant for HTTP or HTTPS protocols.<br><p> <br><p> When using the Hostname value to select between same-Port, same-Protocol Listeners, the Hostname value must be different on each Listener for the Listener to be distinct.<br><p> <br><p> When the Listeners are distinct based on Hostname, inbound request hostnames MUST match from the most specific to least specific Hostname values to choose the correct Listener and its associated set of Routes.<br><p> <br><p> Exact matches must be processed before wildcard matches, and wildcard matches must be processed before fallback (empty Hostname value) matches. For example, `"foo.example.com"` takes precedence over `"&#42;.example.com"`, and `"&#42;.example.com"` takes precedence over `""`.<br><p> <br><p> Additionally, if there are multiple wildcard entries, more specific wildcard entries must be processed before less specific wildcard entries. For example, `"&#42;.foo.example.com"` takes precedence over `"&#42;.example.com"`. The precise definition here is that the higher the number of dots in the hostname to the right of the wildcard character, the higher the precedence.<br><p> <br><p> The wildcard character will match any number of characters _and dots_ to the left, however, so `"&#42;.example.com"` will match both `"foo.bar.example.com"` _and_ `"bar.example.com"`.<br><p> <br><p> If a set of Listeners contains Listeners that are not distinct, then those Listeners are Conflicted, and the implementation MUST set the "Conflicted" condition in the Listener Status to "True".<br><p> <br><p> Implementations MAY choose to accept a Gateway with some Conflicted Listeners only if they only accept the partial Listener set that contains no Conflicted Listeners. To put this another way, implementations may accept a partial Listener set only if they throw out &#42;all&#42; the conflicting Listeners. No picking one of the conflicting listeners as the winner. This also means that the Gateway must have at least one non-conflicting Listener in this case, otherwise it violates the requirement that at least one Listener must be present.<br><p> <br><p> The implementation MUST set a "ListenersNotValid" condition on the Gateway Status when the Gateway contains Conflicted Listeners whether or not they accept the Gateway. That Condition SHOULD clearly indicate in the Message which Listeners are conflicted, and which are Accepted. Additionally, the Listener status for those listeners SHOULD indicate which Listeners are conflicted and not Accepted.<br><p> <br><p> A Gateway's Listeners are considered "compatible" if:<br><p> <br><p> 1. They are distinct. 2. The implementation can serve them in compliance with the Addresses<br><p>    requirement that all Listeners are available on all assigned<br><p>    addresses.<br><p> <br><p> Compatible combinations in Extended support are expected to vary across implementations. A combination that is compatible for one implementation may not be compatible for another.<br><p> <br><p> For example, an implementation that cannot serve both TCP and UDP listeners on the same address, or cannot mix HTTPS and generic TLS listens on the same port would not consider those cases compatible, even though they are distinct.<br><p> <br><p> Note that requests SHOULD match at most one Listener. For example, if Listeners are defined for "foo.example.com" and "&#42;.example.com", a request to "foo.example.com" SHOULD only be routed using routes attached to the "foo.example.com" Listener (and not the "&#42;.example.com" Listener). This concept is known as "Listener Isolation". Implementations that do not support Listener Isolation MUST clearly document this.<br><p> <br><p> Implementations MAY merge separate Gateways onto a single set of Addresses if all Listeners across all Gateways are compatible.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("listeners")
     public void setListeners(List<Listener> listeners) {
         this.listeners = listeners;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayStatus.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayStatus.java
index b31924bb1b1..059213c8405 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GatewayStatus defines the observed state of Gateway.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -92,34 +95,52 @@ public GatewayStatus(List<GatewayStatusAddress> addresses, List<Condition> condi
         this.listeners = listeners;
     }
 
+    /**
+     * Addresses lists the network addresses that have been bound to the Gateway.<br><p> <br><p> This list may differ from the addresses provided in the spec under some conditions:<br><p> <br><p>   &#42; no addresses are specified, all addresses are dynamically assigned<br><p>   &#42; a combination of specified and dynamic addresses are assigned<br><p>   &#42; a specified address was unusable (e.g. already in use)<br><p> <br><p> &lt;gateway:validateIPAddress&gt;
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GatewayStatusAddress> getAddresses() {
         return addresses;
     }
 
+    /**
+     * Addresses lists the network addresses that have been bound to the Gateway.<br><p> <br><p> This list may differ from the addresses provided in the spec under some conditions:<br><p> <br><p>   &#42; no addresses are specified, all addresses are dynamically assigned<br><p>   &#42; a combination of specified and dynamic addresses are assigned<br><p>   &#42; a specified address was unusable (e.g. already in use)<br><p> <br><p> &lt;gateway:validateIPAddress&gt;
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<GatewayStatusAddress> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * Conditions describe the current conditions of the Gateway.<br><p> <br><p> Implementations should prefer to express Gateway conditions using the `GatewayConditionType` and `GatewayConditionReason` constants so that operators and tools can converge on a common vocabulary to describe Gateway state.<br><p> <br><p> Known condition types are:<br><p> <br><p> &#42; "Accepted" &#42; "Programmed" &#42; "Ready"
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions describe the current conditions of the Gateway.<br><p> <br><p> Implementations should prefer to express Gateway conditions using the `GatewayConditionType` and `GatewayConditionReason` constants so that operators and tools can converge on a common vocabulary to describe Gateway state.<br><p> <br><p> Known condition types are:<br><p> <br><p> &#42; "Accepted" &#42; "Programmed" &#42; "Ready"
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Listeners provide status for each unique listener port defined in the Spec.
+     */
     @JsonProperty("listeners")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ListenerStatus> getListeners() {
         return listeners;
     }
 
+    /**
+     * Listeners provide status for each unique listener port defined in the Spec.
+     */
     @JsonProperty("listeners")
     public void setListeners(List<ListenerStatus> listeners) {
         this.listeners = listeners;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayStatusAddress.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayStatusAddress.java
index 64f52c002bc..9a32fa0613b 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayStatusAddress.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayStatusAddress.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GatewayStatusAddress describes a network address that is bound to a Gateway.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public GatewayStatusAddress(String type, String value) {
         this.value = value;
     }
 
+    /**
+     * Type of the address.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of the address.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * Value of the address. The validity of the values will depend on the type and support by the controller.<br><p> <br><p> Examples: `1.2.3.4`, `128::1`, `my-ip-address`.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value of the address. The validity of the values will depend on the type and support by the controller.<br><p> <br><p> Examples: `1.2.3.4`, `128::1`, `my-ip-address`.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayTLSConfig.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayTLSConfig.java
index 70949d0ea25..d6c169ae0fb 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayTLSConfig.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/GatewayTLSConfig.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GatewayTLSConfig describes a TLS configuration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,43 +97,67 @@ public GatewayTLSConfig(List<SecretObjectReference> certificateRefs, FrontendTLS
         this.options = options;
     }
 
+    /**
+     * CertificateRefs contains a series of references to Kubernetes objects that contains TLS certificates and private keys. These certificates are used to establish a TLS handshake for requests that match the hostname of the associated listener.<br><p> <br><p> A single CertificateRef to a Kubernetes Secret has "Core" support. Implementations MAY choose to support attaching multiple certificates to a Listener, but this behavior is implementation-specific.<br><p> <br><p> References to a resource in different namespace are invalid UNLESS there is a ReferenceGrant in the target namespace that allows the certificate to be attached. If a ReferenceGrant does not allow this reference, the "ResolvedRefs" condition MUST be set to False for this listener with the "RefNotPermitted" reason.<br><p> <br><p> This field is required to have at least one element when the mode is set to "Terminate" (default) and is optional otherwise.<br><p> <br><p> CertificateRefs can reference to standard Kubernetes resources, i.e. Secret, or implementation-specific custom resources.<br><p> <br><p> Support: Core - A single reference to a Kubernetes Secret of type kubernetes.io/tls<br><p> <br><p> Support: Implementation-specific (More than one reference or other resource types)
+     */
     @JsonProperty("certificateRefs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SecretObjectReference> getCertificateRefs() {
         return certificateRefs;
     }
 
+    /**
+     * CertificateRefs contains a series of references to Kubernetes objects that contains TLS certificates and private keys. These certificates are used to establish a TLS handshake for requests that match the hostname of the associated listener.<br><p> <br><p> A single CertificateRef to a Kubernetes Secret has "Core" support. Implementations MAY choose to support attaching multiple certificates to a Listener, but this behavior is implementation-specific.<br><p> <br><p> References to a resource in different namespace are invalid UNLESS there is a ReferenceGrant in the target namespace that allows the certificate to be attached. If a ReferenceGrant does not allow this reference, the "ResolvedRefs" condition MUST be set to False for this listener with the "RefNotPermitted" reason.<br><p> <br><p> This field is required to have at least one element when the mode is set to "Terminate" (default) and is optional otherwise.<br><p> <br><p> CertificateRefs can reference to standard Kubernetes resources, i.e. Secret, or implementation-specific custom resources.<br><p> <br><p> Support: Core - A single reference to a Kubernetes Secret of type kubernetes.io/tls<br><p> <br><p> Support: Implementation-specific (More than one reference or other resource types)
+     */
     @JsonProperty("certificateRefs")
     public void setCertificateRefs(List<SecretObjectReference> certificateRefs) {
         this.certificateRefs = certificateRefs;
     }
 
+    /**
+     * GatewayTLSConfig describes a TLS configuration.
+     */
     @JsonProperty("frontendValidation")
     public FrontendTLSValidation getFrontendValidation() {
         return frontendValidation;
     }
 
+    /**
+     * GatewayTLSConfig describes a TLS configuration.
+     */
     @JsonProperty("frontendValidation")
     public void setFrontendValidation(FrontendTLSValidation frontendValidation) {
         this.frontendValidation = frontendValidation;
     }
 
+    /**
+     * Mode defines the TLS behavior for the TLS session initiated by the client. There are two possible modes:<br><p> <br><p> - Terminate: The TLS session between the downstream client and the<br><p>   Gateway is terminated at the Gateway. This mode requires certificates<br><p>   to be specified in some way, such as populating the certificateRefs<br><p>   field.<br><p> - Passthrough: The TLS session is NOT terminated by the Gateway. This<br><p>   implies that the Gateway can't decipher the TLS stream except for<br><p>   the ClientHello message of the TLS protocol. The certificateRefs field<br><p>   is ignored in this mode.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Mode defines the TLS behavior for the TLS session initiated by the client. There are two possible modes:<br><p> <br><p> - Terminate: The TLS session between the downstream client and the<br><p>   Gateway is terminated at the Gateway. This mode requires certificates<br><p>   to be specified in some way, such as populating the certificateRefs<br><p>   field.<br><p> - Passthrough: The TLS session is NOT terminated by the Gateway. This<br><p>   implies that the Gateway can't decipher the TLS stream except for<br><p>   the ClientHello message of the TLS protocol. The certificateRefs field<br><p>   is ignored in this mode.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
     }
 
+    /**
+     * Options are a list of key/value pairs to enable extended TLS configuration for each implementation. For example, configuring the minimum TLS version or supported cipher suites.<br><p> <br><p> A set of common keys MAY be defined by the API in the future. To avoid any ambiguity, implementation-specific definitions MUST use domain-prefixed names, such as `example.com/my-custom-option`. Un-prefixed names are reserved for key names defined by Gateway API.<br><p> <br><p> Support: Implementation-specific
+     */
     @JsonProperty("options")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getOptions() {
         return options;
     }
 
+    /**
+     * Options are a list of key/value pairs to enable extended TLS configuration for each implementation. For example, configuring the minimum TLS version or supported cipher suites.<br><p> <br><p> A set of common keys MAY be defined by the API in the future. To avoid any ambiguity, implementation-specific definitions MUST use domain-prefixed names, such as `example.com/my-custom-option`. Un-prefixed names are reserved for key names defined by Gateway API.<br><p> <br><p> Support: Implementation-specific
+     */
     @JsonProperty("options")
     public void setOptions(Map<String, String> options) {
         this.options = options;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPBackendRef.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPBackendRef.java
index f1620156f02..69e36e651bc 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPBackendRef.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPBackendRef.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPBackendRef defines how a HTTPRoute should forward an HTTP request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -105,72 +108,114 @@ public HTTPBackendRef(List<HTTPRouteFilter> filters, String group, String kind,
         this.weight = weight;
     }
 
+    /**
+     * Filters defined at this level should be executed if and only if the request is being forwarded to the backend defined here.<br><p> <br><p> Support: Implementation-specific (For broader support of filters, use the Filters field in HTTPRouteRule.)
+     */
     @JsonProperty("filters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HTTPRouteFilter> getFilters() {
         return filters;
     }
 
+    /**
+     * Filters defined at this level should be executed if and only if the request is being forwarded to the backend defined here.<br><p> <br><p> Support: Implementation-specific (For broader support of filters, use the Filters field in HTTPRouteRule.)
+     */
     @JsonProperty("filters")
     public void setFilters(List<HTTPRouteFilter> filters) {
         this.filters = filters;
     }
 
+    /**
+     * Group is the group of the referent. For example, "gateway.networking.k8s.io". When unspecified or empty string, core API group is inferred.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * Group is the group of the referent. For example, "gateway.networking.k8s.io". When unspecified or empty string, core API group is inferred.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * Kind is the Kubernetes resource kind of the referent. For example "Service".<br><p> <br><p> Defaults to "Service" when not specified.<br><p> <br><p> ExternalName services can refer to CNAME DNS records that may live outside of the cluster and as such are difficult to reason about in terms of conformance. They also may not be safe to forward to (see CVE-2021-25740 for more information). Implementations SHOULD NOT support ExternalName Services.<br><p> <br><p> Support: Core (Services with a type other than ExternalName)<br><p> <br><p> Support: Implementation-specific (Services with type ExternalName)
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is the Kubernetes resource kind of the referent. For example "Service".<br><p> <br><p> Defaults to "Service" when not specified.<br><p> <br><p> ExternalName services can refer to CNAME DNS records that may live outside of the cluster and as such are difficult to reason about in terms of conformance. They also may not be safe to forward to (see CVE-2021-25740 for more information). Implementations SHOULD NOT support ExternalName Services.<br><p> <br><p> Support: Core (Services with a type other than ExternalName)<br><p> <br><p> Support: Implementation-specific (Services with type ExternalName)
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of the referent.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the referent.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace is the namespace of the backend. When unspecified, the local namespace is inferred.<br><p> <br><p> Note that when a namespace different than the local namespace is specified, a ReferenceGrant object is required in the referent namespace to allow that namespace's owner to accept the reference. See the ReferenceGrant documentation for details.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace of the backend. When unspecified, the local namespace is inferred.<br><p> <br><p> Note that when a namespace different than the local namespace is specified, a ReferenceGrant object is required in the referent namespace to allow that namespace's owner to accept the reference. See the ReferenceGrant documentation for details.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Port specifies the destination port number to use for this resource. Port is required when the referent is a Kubernetes Service. In this case, the port number is the service port number, not the target port. For other resources, destination port might be derived from the referent resource or this field.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * Port specifies the destination port number to use for this resource. Port is required when the referent is a Kubernetes Service. In this case, the port number is the service port number, not the target port. For other resources, destination port might be derived from the referent resource or this field.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * Weight specifies the proportion of requests forwarded to the referenced backend. This is computed as weight/(sum of all weights in this BackendRefs list). For non-zero values, there may be some epsilon from the exact proportion defined here depending on the precision an implementation supports. Weight is not a percentage and the sum of weights does not need to equal 100.<br><p> <br><p> If only one backend is specified and it has a weight greater than 0, 100% of the traffic is forwarded to that backend. If weight is set to 0, no traffic should be forwarded for this entry. If unspecified, weight defaults to 1.<br><p> <br><p> Support for this field varies based on the context where used.
+     */
     @JsonProperty("weight")
     public Integer getWeight() {
         return weight;
     }
 
+    /**
+     * Weight specifies the proportion of requests forwarded to the referenced backend. This is computed as weight/(sum of all weights in this BackendRefs list). For non-zero values, there may be some epsilon from the exact proportion defined here depending on the precision an implementation supports. Weight is not a percentage and the sum of weights does not need to equal 100.<br><p> <br><p> If only one backend is specified and it has a weight greater than 0, 100% of the traffic is forwarded to that backend. If weight is set to 0, no traffic should be forwarded for this entry. If unspecified, weight defaults to 1.<br><p> <br><p> Support for this field varies based on the context where used.
+     */
     @JsonProperty("weight")
     public void setWeight(Integer weight) {
         this.weight = weight;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPHeader.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPHeader.java
index a0ab412be48..6576712288e 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPHeader.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPHeader.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPHeader represents an HTTP Header name and value as defined by RFC 7230.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public HTTPHeader(String name, String value) {
         this.value = value;
     }
 
+    /**
+     * Name is the name of the HTTP Header to be matched. Name matching MUST be case insensitive. (See https://tools.ietf.org/html/rfc7230#section-3.2).<br><p> <br><p> If multiple entries specify equivalent header names, the first entry with an equivalent name MUST be considered for a match. Subsequent entries with an equivalent header name MUST be ignored. Due to the case-insensitivity of header names, "foo" and "Foo" are considered equivalent.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the HTTP Header to be matched. Name matching MUST be case insensitive. (See https://tools.ietf.org/html/rfc7230#section-3.2).<br><p> <br><p> If multiple entries specify equivalent header names, the first entry with an equivalent name MUST be considered for a match. Subsequent entries with an equivalent header name MUST be ignored. Due to the case-insensitivity of header names, "foo" and "Foo" are considered equivalent.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Value is the value of HTTP Header to be matched.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is the value of HTTP Header to be matched.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPHeaderFilter.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPHeaderFilter.java
index 3e275427ea4..bc5671aa66f 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPHeaderFilter.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPHeaderFilter.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPHeaderFilter defines a filter that modifies the headers of an HTTP request or response.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,34 +94,52 @@ public HTTPHeaderFilter(List<HTTPHeader> add, List<String> remove, List<HTTPHead
         this.set = set;
     }
 
+    /**
+     * Add adds the given header(s) (name, value) to the request before the action. It appends to any existing values associated with the header name.<br><p> <br><p> Input:<br><p>   GET /foo HTTP/1.1<br><p>   my-header: foo<br><p> <br><p> Config:<br><p>   add:<br><p>   - name: "my-header"<br><p>     value: "bar,baz"<br><p> <br><p> Output:<br><p>   GET /foo HTTP/1.1<br><p>   my-header: foo,bar,baz
+     */
     @JsonProperty("add")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HTTPHeader> getAdd() {
         return add;
     }
 
+    /**
+     * Add adds the given header(s) (name, value) to the request before the action. It appends to any existing values associated with the header name.<br><p> <br><p> Input:<br><p>   GET /foo HTTP/1.1<br><p>   my-header: foo<br><p> <br><p> Config:<br><p>   add:<br><p>   - name: "my-header"<br><p>     value: "bar,baz"<br><p> <br><p> Output:<br><p>   GET /foo HTTP/1.1<br><p>   my-header: foo,bar,baz
+     */
     @JsonProperty("add")
     public void setAdd(List<HTTPHeader> add) {
         this.add = add;
     }
 
+    /**
+     * Remove the given header(s) from the HTTP request before the action. The value of Remove is a list of HTTP header names. Note that the header names are case-insensitive (see https://datatracker.ietf.org/doc/html/rfc2616#section-4.2).<br><p> <br><p> Input:<br><p>   GET /foo HTTP/1.1<br><p>   my-header1: foo<br><p>   my-header2: bar<br><p>   my-header3: baz<br><p> <br><p> Config:<br><p>   remove: ["my-header1", "my-header3"]<br><p> <br><p> Output:<br><p>   GET /foo HTTP/1.1<br><p>   my-header2: bar
+     */
     @JsonProperty("remove")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getRemove() {
         return remove;
     }
 
+    /**
+     * Remove the given header(s) from the HTTP request before the action. The value of Remove is a list of HTTP header names. Note that the header names are case-insensitive (see https://datatracker.ietf.org/doc/html/rfc2616#section-4.2).<br><p> <br><p> Input:<br><p>   GET /foo HTTP/1.1<br><p>   my-header1: foo<br><p>   my-header2: bar<br><p>   my-header3: baz<br><p> <br><p> Config:<br><p>   remove: ["my-header1", "my-header3"]<br><p> <br><p> Output:<br><p>   GET /foo HTTP/1.1<br><p>   my-header2: bar
+     */
     @JsonProperty("remove")
     public void setRemove(List<String> remove) {
         this.remove = remove;
     }
 
+    /**
+     * Set overwrites the request with the given header (name, value) before the action.<br><p> <br><p> Input:<br><p>   GET /foo HTTP/1.1<br><p>   my-header: foo<br><p> <br><p> Config:<br><p>   set:<br><p>   - name: "my-header"<br><p>     value: "bar"<br><p> <br><p> Output:<br><p>   GET /foo HTTP/1.1<br><p>   my-header: bar
+     */
     @JsonProperty("set")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HTTPHeader> getSet() {
         return set;
     }
 
+    /**
+     * Set overwrites the request with the given header (name, value) before the action.<br><p> <br><p> Input:<br><p>   GET /foo HTTP/1.1<br><p>   my-header: foo<br><p> <br><p> Config:<br><p>   set:<br><p>   - name: "my-header"<br><p>     value: "bar"<br><p> <br><p> Output:<br><p>   GET /foo HTTP/1.1<br><p>   my-header: bar
+     */
     @JsonProperty("set")
     public void setSet(List<HTTPHeader> set) {
         this.set = set;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPHeaderMatch.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPHeaderMatch.java
index e9d0f542ead..ce2fd874969 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPHeaderMatch.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPHeaderMatch.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPHeaderMatch describes how to select a HTTP route by matching HTTP request headers.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public HTTPHeaderMatch(String name, String type, String value) {
         this.value = value;
     }
 
+    /**
+     * Name is the name of the HTTP Header to be matched. Name matching MUST be case insensitive. (See https://tools.ietf.org/html/rfc7230#section-3.2).<br><p> <br><p> If multiple entries specify equivalent header names, only the first entry with an equivalent name MUST be considered for a match. Subsequent entries with an equivalent header name MUST be ignored. Due to the case-insensitivity of header names, "foo" and "Foo" are considered equivalent.<br><p> <br><p> When a header is repeated in an HTTP request, it is implementation-specific behavior as to how this is represented. Generally, proxies should follow the guidance from the RFC: https://www.rfc-editor.org/rfc/rfc7230.html#section-3.2.2 regarding processing a repeated header, with special handling for "Set-Cookie".
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the HTTP Header to be matched. Name matching MUST be case insensitive. (See https://tools.ietf.org/html/rfc7230#section-3.2).<br><p> <br><p> If multiple entries specify equivalent header names, only the first entry with an equivalent name MUST be considered for a match. Subsequent entries with an equivalent header name MUST be ignored. Due to the case-insensitivity of header names, "foo" and "Foo" are considered equivalent.<br><p> <br><p> When a header is repeated in an HTTP request, it is implementation-specific behavior as to how this is represented. Generally, proxies should follow the guidance from the RFC: https://www.rfc-editor.org/rfc/rfc7230.html#section-3.2.2 regarding processing a repeated header, with special handling for "Set-Cookie".
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Type specifies how to match against the value of the header.<br><p> <br><p> Support: Core (Exact)<br><p> <br><p> Support: Implementation-specific (RegularExpression)<br><p> <br><p> Since RegularExpression HeaderMatchType has implementation-specific conformance, implementations can support POSIX, PCRE or any other dialects of regular expressions. Please read the implementation's documentation to determine the supported dialect.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type specifies how to match against the value of the header.<br><p> <br><p> Support: Core (Exact)<br><p> <br><p> Support: Implementation-specific (RegularExpression)<br><p> <br><p> Since RegularExpression HeaderMatchType has implementation-specific conformance, implementations can support POSIX, PCRE or any other dialects of regular expressions. Please read the implementation's documentation to determine the supported dialect.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * Value is the value of HTTP Header to be matched.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is the value of HTTP Header to be matched.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPPathMatch.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPPathMatch.java
index 1ece6b1b321..a853d72c723 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPPathMatch.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPPathMatch.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPPathMatch describes how to select a HTTP route by matching the HTTP request path.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public HTTPPathMatch(String type, String value) {
         this.value = value;
     }
 
+    /**
+     * Type specifies how to match against the path Value.<br><p> <br><p> Support: Core (Exact, PathPrefix)<br><p> <br><p> Support: Implementation-specific (RegularExpression)
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type specifies how to match against the path Value.<br><p> <br><p> Support: Core (Exact, PathPrefix)<br><p> <br><p> Support: Implementation-specific (RegularExpression)
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * Value of the HTTP path to match against.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value of the HTTP path to match against.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPPathModifier.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPPathModifier.java
index 6615b7a312e..d73f3302133 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPPathModifier.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPPathModifier.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPPathModifier defines configuration for path modifiers. &lt;gateway:experimental&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public HTTPPathModifier(String replaceFullPath, String replacePrefixMatch, Strin
         this.type = type;
     }
 
+    /**
+     * ReplaceFullPath specifies the value with which to replace the full path of a request during a rewrite or redirect.
+     */
     @JsonProperty("replaceFullPath")
     public String getReplaceFullPath() {
         return replaceFullPath;
     }
 
+    /**
+     * ReplaceFullPath specifies the value with which to replace the full path of a request during a rewrite or redirect.
+     */
     @JsonProperty("replaceFullPath")
     public void setReplaceFullPath(String replaceFullPath) {
         this.replaceFullPath = replaceFullPath;
     }
 
+    /**
+     * ReplacePrefixMatch specifies the value with which to replace the prefix match of a request during a rewrite or redirect. For example, a request to "/foo/bar" with a prefix match of "/foo" and a ReplacePrefixMatch of "/xyz" would be modified to "/xyz/bar".<br><p> <br><p> Note that this matches the behavior of the PathPrefix match type. This matches full path elements. A path element refers to the list of labels in the path split by the `/` separator. When specified, a trailing `/` is ignored. For example, the paths `/abc`, `/abc/`, and `/abc/def` would all match the prefix `/abc`, but the path `/abcd` would not.<br><p> <br><p> ReplacePrefixMatch is only compatible with a `PathPrefix` HTTPRouteMatch. Using any other HTTPRouteMatch type on the same HTTPRouteRule will result in the implementation setting the Accepted Condition for the Route to `status: False`.<br><p> <br><p> Request Path | Prefix Match | Replace Prefix | Modified Path -------------|--------------|----------------|---------- /foo/bar     | /foo         | /xyz           | /xyz/bar /foo/bar     | /foo         | /xyz/          | /xyz/bar /foo/bar     | /foo/        | /xyz           | /xyz/bar /foo/bar     | /foo/        | /xyz/          | /xyz/bar /foo         | /foo         | /xyz           | /xyz /foo/        | /foo         | /xyz           | /xyz/ /foo/bar     | /foo         | &lt;empty string&gt; | /bar /foo/        | /foo         | &lt;empty string&gt; | / /foo         | /foo         | &lt;empty string&gt; | / /foo/        | /foo         | /              | / /foo         | /foo         | /              | /
+     */
     @JsonProperty("replacePrefixMatch")
     public String getReplacePrefixMatch() {
         return replacePrefixMatch;
     }
 
+    /**
+     * ReplacePrefixMatch specifies the value with which to replace the prefix match of a request during a rewrite or redirect. For example, a request to "/foo/bar" with a prefix match of "/foo" and a ReplacePrefixMatch of "/xyz" would be modified to "/xyz/bar".<br><p> <br><p> Note that this matches the behavior of the PathPrefix match type. This matches full path elements. A path element refers to the list of labels in the path split by the `/` separator. When specified, a trailing `/` is ignored. For example, the paths `/abc`, `/abc/`, and `/abc/def` would all match the prefix `/abc`, but the path `/abcd` would not.<br><p> <br><p> ReplacePrefixMatch is only compatible with a `PathPrefix` HTTPRouteMatch. Using any other HTTPRouteMatch type on the same HTTPRouteRule will result in the implementation setting the Accepted Condition for the Route to `status: False`.<br><p> <br><p> Request Path | Prefix Match | Replace Prefix | Modified Path -------------|--------------|----------------|---------- /foo/bar     | /foo         | /xyz           | /xyz/bar /foo/bar     | /foo         | /xyz/          | /xyz/bar /foo/bar     | /foo/        | /xyz           | /xyz/bar /foo/bar     | /foo/        | /xyz/          | /xyz/bar /foo         | /foo         | /xyz           | /xyz /foo/        | /foo         | /xyz           | /xyz/ /foo/bar     | /foo         | &lt;empty string&gt; | /bar /foo/        | /foo         | &lt;empty string&gt; | / /foo         | /foo         | &lt;empty string&gt; | / /foo/        | /foo         | /              | / /foo         | /foo         | /              | /
+     */
     @JsonProperty("replacePrefixMatch")
     public void setReplacePrefixMatch(String replacePrefixMatch) {
         this.replacePrefixMatch = replacePrefixMatch;
     }
 
+    /**
+     * Type defines the type of path modifier. Additional types may be added in a future release of the API.<br><p> <br><p> Note that values may be added to this enum, implementations must ensure that unknown values will not cause a crash.<br><p> <br><p> Unknown values here must result in the implementation setting the Accepted Condition for the Route to `status: False`, with a Reason of `UnsupportedValue`.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type defines the type of path modifier. Additional types may be added in a future release of the API.<br><p> <br><p> Note that values may be added to this enum, implementations must ensure that unknown values will not cause a crash.<br><p> <br><p> Unknown values here must result in the implementation setting the Accepted Condition for the Route to `status: False`, with a Reason of `UnsupportedValue`.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPQueryParamMatch.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPQueryParamMatch.java
index 597f22b9f0c..ec46a839322 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPQueryParamMatch.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPQueryParamMatch.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPQueryParamMatch describes how to select a HTTP route by matching HTTP query parameters.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public HTTPQueryParamMatch(String name, String type, String value) {
         this.value = value;
     }
 
+    /**
+     * Name is the name of the HTTP query param to be matched. This must be an exact string match. (See https://tools.ietf.org/html/rfc7230#section-2.7.3).<br><p> <br><p> If multiple entries specify equivalent query param names, only the first entry with an equivalent name MUST be considered for a match. Subsequent entries with an equivalent query param name MUST be ignored.<br><p> <br><p> If a query param is repeated in an HTTP request, the behavior is purposely left undefined, since different data planes have different capabilities. However, it is &#42;recommended&#42; that implementations should match against the first value of the param if the data plane supports it, as this behavior is expected in other load balancing contexts outside of the Gateway API.<br><p> <br><p> Users SHOULD NOT route traffic based on repeated query params to guard themselves against potential differences in the implementations.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the HTTP query param to be matched. This must be an exact string match. (See https://tools.ietf.org/html/rfc7230#section-2.7.3).<br><p> <br><p> If multiple entries specify equivalent query param names, only the first entry with an equivalent name MUST be considered for a match. Subsequent entries with an equivalent query param name MUST be ignored.<br><p> <br><p> If a query param is repeated in an HTTP request, the behavior is purposely left undefined, since different data planes have different capabilities. However, it is &#42;recommended&#42; that implementations should match against the first value of the param if the data plane supports it, as this behavior is expected in other load balancing contexts outside of the Gateway API.<br><p> <br><p> Users SHOULD NOT route traffic based on repeated query params to guard themselves against potential differences in the implementations.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Type specifies how to match against the value of the query parameter.<br><p> <br><p> Support: Extended (Exact)<br><p> <br><p> Support: Implementation-specific (RegularExpression)<br><p> <br><p> Since RegularExpression QueryParamMatchType has Implementation-specific conformance, implementations can support POSIX, PCRE or any other dialects of regular expressions. Please read the implementation's documentation to determine the supported dialect.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type specifies how to match against the value of the query parameter.<br><p> <br><p> Support: Extended (Exact)<br><p> <br><p> Support: Implementation-specific (RegularExpression)<br><p> <br><p> Since RegularExpression QueryParamMatchType has Implementation-specific conformance, implementations can support POSIX, PCRE or any other dialects of regular expressions. Please read the implementation's documentation to determine the supported dialect.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * Value is the value of HTTP query param to be matched.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is the value of HTTP query param to be matched.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRequestMirrorFilter.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRequestMirrorFilter.java
index f34ba117b43..423d892c893 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRequestMirrorFilter.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRequestMirrorFilter.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPRequestMirrorFilter defines configuration for the RequestMirror filter.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public HTTPRequestMirrorFilter(BackendObjectReference backendRef, Fraction fract
         this.percent = percent;
     }
 
+    /**
+     * HTTPRequestMirrorFilter defines configuration for the RequestMirror filter.
+     */
     @JsonProperty("backendRef")
     public BackendObjectReference getBackendRef() {
         return backendRef;
     }
 
+    /**
+     * HTTPRequestMirrorFilter defines configuration for the RequestMirror filter.
+     */
     @JsonProperty("backendRef")
     public void setBackendRef(BackendObjectReference backendRef) {
         this.backendRef = backendRef;
     }
 
+    /**
+     * HTTPRequestMirrorFilter defines configuration for the RequestMirror filter.
+     */
     @JsonProperty("fraction")
     public Fraction getFraction() {
         return fraction;
     }
 
+    /**
+     * HTTPRequestMirrorFilter defines configuration for the RequestMirror filter.
+     */
     @JsonProperty("fraction")
     public void setFraction(Fraction fraction) {
         this.fraction = fraction;
     }
 
+    /**
+     * Percent represents the percentage of requests that should be mirrored to BackendRef. Its minimum value is 0 (indicating 0% of requests) and its maximum value is 100 (indicating 100% of requests).<br><p> <br><p> Only one of Fraction or Percent may be specified. If neither field is specified, 100% of requests will be mirrored.<br><p> <br><p> &lt;gateway:experimental&gt;
+     */
     @JsonProperty("percent")
     public Integer getPercent() {
         return percent;
     }
 
+    /**
+     * Percent represents the percentage of requests that should be mirrored to BackendRef. Its minimum value is 0 (indicating 0% of requests) and its maximum value is 100 (indicating 100% of requests).<br><p> <br><p> Only one of Fraction or Percent may be specified. If neither field is specified, 100% of requests will be mirrored.<br><p> <br><p> &lt;gateway:experimental&gt;
+     */
     @JsonProperty("percent")
     public void setPercent(Integer percent) {
         this.percent = percent;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRequestRedirectFilter.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRequestRedirectFilter.java
index 7cba2e2bd44..2d451dd3e17 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRequestRedirectFilter.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRequestRedirectFilter.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPRequestRedirect defines a filter that redirects a request. This filter MUST NOT be used on the same Route rule as a HTTPURLRewrite filter.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public HTTPRequestRedirectFilter(String hostname, HTTPPathModifier path, Integer
         this.statusCode = statusCode;
     }
 
+    /**
+     * Hostname is the hostname to be used in the value of the `Location` header in the response. When empty, the hostname in the `Host` header of the request is used.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("hostname")
     public String getHostname() {
         return hostname;
     }
 
+    /**
+     * Hostname is the hostname to be used in the value of the `Location` header in the response. When empty, the hostname in the `Host` header of the request is used.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("hostname")
     public void setHostname(String hostname) {
         this.hostname = hostname;
     }
 
+    /**
+     * HTTPRequestRedirect defines a filter that redirects a request. This filter MUST NOT be used on the same Route rule as a HTTPURLRewrite filter.
+     */
     @JsonProperty("path")
     public HTTPPathModifier getPath() {
         return path;
     }
 
+    /**
+     * HTTPRequestRedirect defines a filter that redirects a request. This filter MUST NOT be used on the same Route rule as a HTTPURLRewrite filter.
+     */
     @JsonProperty("path")
     public void setPath(HTTPPathModifier path) {
         this.path = path;
     }
 
+    /**
+     * Port is the port to be used in the value of the `Location` header in the response.<br><p> <br><p> If no port is specified, the redirect port MUST be derived using the following rules:<br><p> <br><p> &#42; If redirect scheme is not-empty, the redirect port MUST be the well-known<br><p>   port associated with the redirect scheme. Specifically "http" to port 80<br><p>   and "https" to port 443. If the redirect scheme does not have a<br><p>   well-known port, the listener port of the Gateway SHOULD be used.<br><p> &#42; If redirect scheme is empty, the redirect port MUST be the Gateway<br><p>   Listener port.<br><p> <br><p> Implementations SHOULD NOT add the port number in the 'Location' header in the following cases:<br><p> <br><p> &#42; A Location header that will use HTTP (whether that is determined via<br><p>   the Listener protocol or the Scheme field) _and_ use port 80.<br><p> &#42; A Location header that will use HTTPS (whether that is determined via<br><p>   the Listener protocol or the Scheme field) _and_ use port 443.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * Port is the port to be used in the value of the `Location` header in the response.<br><p> <br><p> If no port is specified, the redirect port MUST be derived using the following rules:<br><p> <br><p> &#42; If redirect scheme is not-empty, the redirect port MUST be the well-known<br><p>   port associated with the redirect scheme. Specifically "http" to port 80<br><p>   and "https" to port 443. If the redirect scheme does not have a<br><p>   well-known port, the listener port of the Gateway SHOULD be used.<br><p> &#42; If redirect scheme is empty, the redirect port MUST be the Gateway<br><p>   Listener port.<br><p> <br><p> Implementations SHOULD NOT add the port number in the 'Location' header in the following cases:<br><p> <br><p> &#42; A Location header that will use HTTP (whether that is determined via<br><p>   the Listener protocol or the Scheme field) _and_ use port 80.<br><p> &#42; A Location header that will use HTTPS (whether that is determined via<br><p>   the Listener protocol or the Scheme field) _and_ use port 443.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * Scheme is the scheme to be used in the value of the `Location` header in the response. When empty, the scheme of the request is used.<br><p> <br><p> Scheme redirects can affect the port of the redirect, for more information, refer to the documentation for the port field of this filter.<br><p> <br><p> Note that values may be added to this enum, implementations must ensure that unknown values will not cause a crash.<br><p> <br><p> Unknown values here must result in the implementation setting the Accepted Condition for the Route to `status: False`, with a Reason of `UnsupportedValue`.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("scheme")
     public String getScheme() {
         return scheme;
     }
 
+    /**
+     * Scheme is the scheme to be used in the value of the `Location` header in the response. When empty, the scheme of the request is used.<br><p> <br><p> Scheme redirects can affect the port of the redirect, for more information, refer to the documentation for the port field of this filter.<br><p> <br><p> Note that values may be added to this enum, implementations must ensure that unknown values will not cause a crash.<br><p> <br><p> Unknown values here must result in the implementation setting the Accepted Condition for the Route to `status: False`, with a Reason of `UnsupportedValue`.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("scheme")
     public void setScheme(String scheme) {
         this.scheme = scheme;
     }
 
+    /**
+     * StatusCode is the HTTP status code to be used in response.<br><p> <br><p> Note that values may be added to this enum, implementations must ensure that unknown values will not cause a crash.<br><p> <br><p> Unknown values here must result in the implementation setting the Accepted Condition for the Route to `status: False`, with a Reason of `UnsupportedValue`.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("statusCode")
     public Integer getStatusCode() {
         return statusCode;
     }
 
+    /**
+     * StatusCode is the HTTP status code to be used in response.<br><p> <br><p> Note that values may be added to this enum, implementations must ensure that unknown values will not cause a crash.<br><p> <br><p> Unknown values here must result in the implementation setting the Accepted Condition for the Route to `status: False`, with a Reason of `UnsupportedValue`.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("statusCode")
     public void setStatusCode(Integer statusCode) {
         this.statusCode = statusCode;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRoute.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRoute.java
index 325aec80514..dd5efc3eca8 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRoute.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRoute.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPRoute provides a way to route HTTP requests. This includes the capability to match requests by hostname, path, header, or query param. Filters can be used to specify additional processing steps. Backends specify where matching requests should be routed.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class HTTPRoute implements Editable<HTTPRouteBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "HTTPRoute";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public HTTPRoute(String apiVersion, String kind, ObjectMeta metadata, HTTPRouteS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * HTTPRoute provides a way to route HTTP requests. This includes the capability to match requests by hostname, path, header, or query param. Filters can be used to specify additional processing steps. Backends specify where matching requests should be routed.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * HTTPRoute provides a way to route HTTP requests. This includes the capability to match requests by hostname, path, header, or query param. Filters can be used to specify additional processing steps. Backends specify where matching requests should be routed.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * HTTPRoute provides a way to route HTTP requests. This includes the capability to match requests by hostname, path, header, or query param. Filters can be used to specify additional processing steps. Backends specify where matching requests should be routed.
+     */
     @JsonProperty("spec")
     public HTTPRouteSpec getSpec() {
         return spec;
     }
 
+    /**
+     * HTTPRoute provides a way to route HTTP requests. This includes the capability to match requests by hostname, path, header, or query param. Filters can be used to specify additional processing steps. Backends specify where matching requests should be routed.
+     */
     @JsonProperty("spec")
     public void setSpec(HTTPRouteSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * HTTPRoute provides a way to route HTTP requests. This includes the capability to match requests by hostname, path, header, or query param. Filters can be used to specify additional processing steps. Backends specify where matching requests should be routed.
+     */
     @JsonProperty("status")
     public HTTPRouteStatus getStatus() {
         return status;
     }
 
+    /**
+     * HTTPRoute provides a way to route HTTP requests. This includes the capability to match requests by hostname, path, header, or query param. Filters can be used to specify additional processing steps. Backends specify where matching requests should be routed.
+     */
     @JsonProperty("status")
     public void setStatus(HTTPRouteStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteFilter.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteFilter.java
index 92a028f5f4f..d1a779cf2d4 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteFilter.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteFilter.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPRouteFilter defines processing steps that must be completed during the request or response lifecycle. HTTPRouteFilters are meant as an extension point to express processing that may be done in Gateway implementations. Some examples include request or response modification, implementing authentication strategies, rate-limiting, and traffic shaping. API guarantee/conformance is defined based on the type of the filter.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,71 +105,113 @@ public HTTPRouteFilter(LocalObjectReference extensionRef, HTTPHeaderFilter reque
         this.urlRewrite = urlRewrite;
     }
 
+    /**
+     * HTTPRouteFilter defines processing steps that must be completed during the request or response lifecycle. HTTPRouteFilters are meant as an extension point to express processing that may be done in Gateway implementations. Some examples include request or response modification, implementing authentication strategies, rate-limiting, and traffic shaping. API guarantee/conformance is defined based on the type of the filter.
+     */
     @JsonProperty("extensionRef")
     public LocalObjectReference getExtensionRef() {
         return extensionRef;
     }
 
+    /**
+     * HTTPRouteFilter defines processing steps that must be completed during the request or response lifecycle. HTTPRouteFilters are meant as an extension point to express processing that may be done in Gateway implementations. Some examples include request or response modification, implementing authentication strategies, rate-limiting, and traffic shaping. API guarantee/conformance is defined based on the type of the filter.
+     */
     @JsonProperty("extensionRef")
     public void setExtensionRef(LocalObjectReference extensionRef) {
         this.extensionRef = extensionRef;
     }
 
+    /**
+     * HTTPRouteFilter defines processing steps that must be completed during the request or response lifecycle. HTTPRouteFilters are meant as an extension point to express processing that may be done in Gateway implementations. Some examples include request or response modification, implementing authentication strategies, rate-limiting, and traffic shaping. API guarantee/conformance is defined based on the type of the filter.
+     */
     @JsonProperty("requestHeaderModifier")
     public HTTPHeaderFilter getRequestHeaderModifier() {
         return requestHeaderModifier;
     }
 
+    /**
+     * HTTPRouteFilter defines processing steps that must be completed during the request or response lifecycle. HTTPRouteFilters are meant as an extension point to express processing that may be done in Gateway implementations. Some examples include request or response modification, implementing authentication strategies, rate-limiting, and traffic shaping. API guarantee/conformance is defined based on the type of the filter.
+     */
     @JsonProperty("requestHeaderModifier")
     public void setRequestHeaderModifier(HTTPHeaderFilter requestHeaderModifier) {
         this.requestHeaderModifier = requestHeaderModifier;
     }
 
+    /**
+     * HTTPRouteFilter defines processing steps that must be completed during the request or response lifecycle. HTTPRouteFilters are meant as an extension point to express processing that may be done in Gateway implementations. Some examples include request or response modification, implementing authentication strategies, rate-limiting, and traffic shaping. API guarantee/conformance is defined based on the type of the filter.
+     */
     @JsonProperty("requestMirror")
     public HTTPRequestMirrorFilter getRequestMirror() {
         return requestMirror;
     }
 
+    /**
+     * HTTPRouteFilter defines processing steps that must be completed during the request or response lifecycle. HTTPRouteFilters are meant as an extension point to express processing that may be done in Gateway implementations. Some examples include request or response modification, implementing authentication strategies, rate-limiting, and traffic shaping. API guarantee/conformance is defined based on the type of the filter.
+     */
     @JsonProperty("requestMirror")
     public void setRequestMirror(HTTPRequestMirrorFilter requestMirror) {
         this.requestMirror = requestMirror;
     }
 
+    /**
+     * HTTPRouteFilter defines processing steps that must be completed during the request or response lifecycle. HTTPRouteFilters are meant as an extension point to express processing that may be done in Gateway implementations. Some examples include request or response modification, implementing authentication strategies, rate-limiting, and traffic shaping. API guarantee/conformance is defined based on the type of the filter.
+     */
     @JsonProperty("requestRedirect")
     public HTTPRequestRedirectFilter getRequestRedirect() {
         return requestRedirect;
     }
 
+    /**
+     * HTTPRouteFilter defines processing steps that must be completed during the request or response lifecycle. HTTPRouteFilters are meant as an extension point to express processing that may be done in Gateway implementations. Some examples include request or response modification, implementing authentication strategies, rate-limiting, and traffic shaping. API guarantee/conformance is defined based on the type of the filter.
+     */
     @JsonProperty("requestRedirect")
     public void setRequestRedirect(HTTPRequestRedirectFilter requestRedirect) {
         this.requestRedirect = requestRedirect;
     }
 
+    /**
+     * HTTPRouteFilter defines processing steps that must be completed during the request or response lifecycle. HTTPRouteFilters are meant as an extension point to express processing that may be done in Gateway implementations. Some examples include request or response modification, implementing authentication strategies, rate-limiting, and traffic shaping. API guarantee/conformance is defined based on the type of the filter.
+     */
     @JsonProperty("responseHeaderModifier")
     public HTTPHeaderFilter getResponseHeaderModifier() {
         return responseHeaderModifier;
     }
 
+    /**
+     * HTTPRouteFilter defines processing steps that must be completed during the request or response lifecycle. HTTPRouteFilters are meant as an extension point to express processing that may be done in Gateway implementations. Some examples include request or response modification, implementing authentication strategies, rate-limiting, and traffic shaping. API guarantee/conformance is defined based on the type of the filter.
+     */
     @JsonProperty("responseHeaderModifier")
     public void setResponseHeaderModifier(HTTPHeaderFilter responseHeaderModifier) {
         this.responseHeaderModifier = responseHeaderModifier;
     }
 
+    /**
+     * Type identifies the type of filter to apply. As with other API fields, types are classified into three conformance levels:<br><p> <br><p> - Core: Filter types and their corresponding configuration defined by<br><p>   "Support: Core" in this package, e.g. "RequestHeaderModifier". All<br><p>   implementations must support core filters.<br><p> <br><p> - Extended: Filter types and their corresponding configuration defined by<br><p>   "Support: Extended" in this package, e.g. "RequestMirror". Implementers<br><p>   are encouraged to support extended filters.<br><p> <br><p> - Implementation-specific: Filters that are defined and supported by<br><p>   specific vendors.<br><p>   In the future, filters showing convergence in behavior across multiple<br><p>   implementations will be considered for inclusion in extended or core<br><p>   conformance levels. Filter-specific configuration for such filters<br><p>   is specified using the ExtensionRef field. `Type` should be set to<br><p>   "ExtensionRef" for custom filters.<br><p> <br><p> Implementers are encouraged to define custom implementation types to extend the core API with implementation-specific behavior.<br><p> <br><p> If a reference to a custom filter type cannot be resolved, the filter MUST NOT be skipped. Instead, requests that would have been processed by that filter MUST receive a HTTP error response.<br><p> <br><p> Note that values may be added to this enum, implementations must ensure that unknown values will not cause a crash.<br><p> <br><p> Unknown values here must result in the implementation setting the Accepted Condition for the Route to `status: False`, with a Reason of `UnsupportedValue`.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type identifies the type of filter to apply. As with other API fields, types are classified into three conformance levels:<br><p> <br><p> - Core: Filter types and their corresponding configuration defined by<br><p>   "Support: Core" in this package, e.g. "RequestHeaderModifier". All<br><p>   implementations must support core filters.<br><p> <br><p> - Extended: Filter types and their corresponding configuration defined by<br><p>   "Support: Extended" in this package, e.g. "RequestMirror". Implementers<br><p>   are encouraged to support extended filters.<br><p> <br><p> - Implementation-specific: Filters that are defined and supported by<br><p>   specific vendors.<br><p>   In the future, filters showing convergence in behavior across multiple<br><p>   implementations will be considered for inclusion in extended or core<br><p>   conformance levels. Filter-specific configuration for such filters<br><p>   is specified using the ExtensionRef field. `Type` should be set to<br><p>   "ExtensionRef" for custom filters.<br><p> <br><p> Implementers are encouraged to define custom implementation types to extend the core API with implementation-specific behavior.<br><p> <br><p> If a reference to a custom filter type cannot be resolved, the filter MUST NOT be skipped. Instead, requests that would have been processed by that filter MUST receive a HTTP error response.<br><p> <br><p> Note that values may be added to this enum, implementations must ensure that unknown values will not cause a crash.<br><p> <br><p> Unknown values here must result in the implementation setting the Accepted Condition for the Route to `status: False`, with a Reason of `UnsupportedValue`.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * HTTPRouteFilter defines processing steps that must be completed during the request or response lifecycle. HTTPRouteFilters are meant as an extension point to express processing that may be done in Gateway implementations. Some examples include request or response modification, implementing authentication strategies, rate-limiting, and traffic shaping. API guarantee/conformance is defined based on the type of the filter.
+     */
     @JsonProperty("urlRewrite")
     public HTTPURLRewriteFilter getUrlRewrite() {
         return urlRewrite;
     }
 
+    /**
+     * HTTPRouteFilter defines processing steps that must be completed during the request or response lifecycle. HTTPRouteFilters are meant as an extension point to express processing that may be done in Gateway implementations. Some examples include request or response modification, implementing authentication strategies, rate-limiting, and traffic shaping. API guarantee/conformance is defined based on the type of the filter.
+     */
     @JsonProperty("urlRewrite")
     public void setUrlRewrite(HTTPURLRewriteFilter urlRewrite) {
         this.urlRewrite = urlRewrite;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteList.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteList.java
index 6b151ebb9ba..75b1b243061 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteList.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPRouteList contains a list of HTTPRoute.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class HTTPRouteList implements Editable<HTTPRouteListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.gatewayapi.v1.HTTPRoute>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.gatewayapi.v1.HTTPRoute> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "HTTPRouteList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public HTTPRouteList(String apiVersion, List<io.fabric8.kubernetes.api.model.gat
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * HTTPRouteList contains a list of HTTPRoute.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.gatewayapi.v1.HTTPRoute> getItems() {
         return items;
     }
 
+    /**
+     * HTTPRouteList contains a list of HTTPRoute.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.gatewayapi.v1.HTTPRoute> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * HTTPRouteList contains a list of HTTPRoute.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * HTTPRouteList contains a list of HTTPRoute.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteMatch.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteMatch.java
index d842b4e071b..f94541ac343 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteMatch.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteMatch.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPRouteMatch defines the predicate used to match requests to a given action. Multiple match types are ANDed together, i.e. the match will evaluate to true only if all conditions are satisfied.<br><p> <br><p> For example, the match below will match a HTTP request only if its path starts with `/foo` AND it contains the `version: v1` header:<br><p> <br><p> ``` match:<br><p> <br><p> 	path:<br><p> 	  value: "/foo"<br><p> 	headers:<br><p> 	- name: "version"<br><p> 	  value "v1"<br><p> <br><p> ```
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,43 +97,67 @@ public HTTPRouteMatch(List<HTTPHeaderMatch> headers, String method, HTTPPathMatc
         this.queryParams = queryParams;
     }
 
+    /**
+     * Headers specifies HTTP request header matchers. Multiple match values are ANDed together, meaning, a request must match all the specified headers to select the route.
+     */
     @JsonProperty("headers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HTTPHeaderMatch> getHeaders() {
         return headers;
     }
 
+    /**
+     * Headers specifies HTTP request header matchers. Multiple match values are ANDed together, meaning, a request must match all the specified headers to select the route.
+     */
     @JsonProperty("headers")
     public void setHeaders(List<HTTPHeaderMatch> headers) {
         this.headers = headers;
     }
 
+    /**
+     * Method specifies HTTP method matcher. When specified, this route will be matched only if the request has the specified method.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("method")
     public String getMethod() {
         return method;
     }
 
+    /**
+     * Method specifies HTTP method matcher. When specified, this route will be matched only if the request has the specified method.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("method")
     public void setMethod(String method) {
         this.method = method;
     }
 
+    /**
+     * HTTPRouteMatch defines the predicate used to match requests to a given action. Multiple match types are ANDed together, i.e. the match will evaluate to true only if all conditions are satisfied.<br><p> <br><p> For example, the match below will match a HTTP request only if its path starts with `/foo` AND it contains the `version: v1` header:<br><p> <br><p> ``` match:<br><p> <br><p> 	path:<br><p> 	  value: "/foo"<br><p> 	headers:<br><p> 	- name: "version"<br><p> 	  value "v1"<br><p> <br><p> ```
+     */
     @JsonProperty("path")
     public HTTPPathMatch getPath() {
         return path;
     }
 
+    /**
+     * HTTPRouteMatch defines the predicate used to match requests to a given action. Multiple match types are ANDed together, i.e. the match will evaluate to true only if all conditions are satisfied.<br><p> <br><p> For example, the match below will match a HTTP request only if its path starts with `/foo` AND it contains the `version: v1` header:<br><p> <br><p> ``` match:<br><p> <br><p> 	path:<br><p> 	  value: "/foo"<br><p> 	headers:<br><p> 	- name: "version"<br><p> 	  value "v1"<br><p> <br><p> ```
+     */
     @JsonProperty("path")
     public void setPath(HTTPPathMatch path) {
         this.path = path;
     }
 
+    /**
+     * QueryParams specifies HTTP query parameter matchers. Multiple match values are ANDed together, meaning, a request must match all the specified query parameters to select the route.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("queryParams")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HTTPQueryParamMatch> getQueryParams() {
         return queryParams;
     }
 
+    /**
+     * QueryParams specifies HTTP query parameter matchers. Multiple match values are ANDed together, meaning, a request must match all the specified query parameters to select the route.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("queryParams")
     public void setQueryParams(List<HTTPQueryParamMatch> queryParams) {
         this.queryParams = queryParams;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteRetry.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteRetry.java
index feba677008d..ebd1e63f044 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteRetry.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteRetry.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPRouteRetry defines retry configuration for an HTTPRoute.<br><p> <br><p> Implementations SHOULD retry on connection errors (disconnect, reset, timeout, TCP failure) if a retry stanza is configured.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public HTTPRouteRetry(Integer attempts, String backoff, List<Integer> codes) {
         this.codes = codes;
     }
 
+    /**
+     * Attempts specifies the maxmimum number of times an individual request from the gateway to a backend should be retried.<br><p> <br><p> If the maximum number of retries has been attempted without a successful response from the backend, the Gateway MUST return an error.<br><p> <br><p> When this field is unspecified, the number of times to attempt to retry a backend request is implementation-specific.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("attempts")
     public Integer getAttempts() {
         return attempts;
     }
 
+    /**
+     * Attempts specifies the maxmimum number of times an individual request from the gateway to a backend should be retried.<br><p> <br><p> If the maximum number of retries has been attempted without a successful response from the backend, the Gateway MUST return an error.<br><p> <br><p> When this field is unspecified, the number of times to attempt to retry a backend request is implementation-specific.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("attempts")
     public void setAttempts(Integer attempts) {
         this.attempts = attempts;
     }
 
+    /**
+     * Backoff specifies the minimum duration a Gateway should wait between retry attempts and is represented in Gateway API Duration formatting.<br><p> <br><p> For example, setting the `rules[].retry.backoff` field to the value `100ms` will cause a backend request to first be retried approximately 100 milliseconds after timing out or receiving a response code configured to be retryable.<br><p> <br><p> An implementation MAY use an exponential or alternative backoff strategy for subsequent retry attempts, MAY cap the maximum backoff duration to some amount greater than the specified minimum, and MAY add arbitrary jitter to stagger requests, as long as unsuccessful backend requests are not retried before the configured minimum duration.<br><p> <br><p> If a Request timeout (`rules[].timeouts.request`) is configured on the route, the entire duration of the initial request and any retry attempts MUST not exceed the Request timeout duration. If any retry attempts are still in progress when the Request timeout duration has been reached, these SHOULD be canceled if possible and the Gateway MUST immediately return a timeout error.<br><p> <br><p> If a BackendRequest timeout (`rules[].timeouts.backendRequest`) is configured on the route, any retry attempts which reach the configured BackendRequest timeout duration without a response SHOULD be canceled if possible and the Gateway should wait for at least the specified backoff duration before attempting to retry the backend request again.<br><p> <br><p> If a BackendRequest timeout is _not_ configured on the route, retry attempts MAY time out after an implementation default duration, or MAY remain pending until a configured Request timeout or implementation default duration for total request time is reached.<br><p> <br><p> When this field is unspecified, the time to wait between retry attempts is implementation-specific.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("backoff")
     public String getBackoff() {
         return backoff;
     }
 
+    /**
+     * Backoff specifies the minimum duration a Gateway should wait between retry attempts and is represented in Gateway API Duration formatting.<br><p> <br><p> For example, setting the `rules[].retry.backoff` field to the value `100ms` will cause a backend request to first be retried approximately 100 milliseconds after timing out or receiving a response code configured to be retryable.<br><p> <br><p> An implementation MAY use an exponential or alternative backoff strategy for subsequent retry attempts, MAY cap the maximum backoff duration to some amount greater than the specified minimum, and MAY add arbitrary jitter to stagger requests, as long as unsuccessful backend requests are not retried before the configured minimum duration.<br><p> <br><p> If a Request timeout (`rules[].timeouts.request`) is configured on the route, the entire duration of the initial request and any retry attempts MUST not exceed the Request timeout duration. If any retry attempts are still in progress when the Request timeout duration has been reached, these SHOULD be canceled if possible and the Gateway MUST immediately return a timeout error.<br><p> <br><p> If a BackendRequest timeout (`rules[].timeouts.backendRequest`) is configured on the route, any retry attempts which reach the configured BackendRequest timeout duration without a response SHOULD be canceled if possible and the Gateway should wait for at least the specified backoff duration before attempting to retry the backend request again.<br><p> <br><p> If a BackendRequest timeout is _not_ configured on the route, retry attempts MAY time out after an implementation default duration, or MAY remain pending until a configured Request timeout or implementation default duration for total request time is reached.<br><p> <br><p> When this field is unspecified, the time to wait between retry attempts is implementation-specific.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("backoff")
     public void setBackoff(String backoff) {
         this.backoff = backoff;
     }
 
+    /**
+     * Codes defines the HTTP response status codes for which a backend request should be retried.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("codes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Integer> getCodes() {
         return codes;
     }
 
+    /**
+     * Codes defines the HTTP response status codes for which a backend request should be retried.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("codes")
     public void setCodes(List<Integer> codes) {
         this.codes = codes;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteRule.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteRule.java
index f7d8c1c06c5..c7121ea7d88 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteRule.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteRule.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPRouteRule defines semantics for matching an HTTP request based on conditions (matches), processing it (filters), and forwarding the request to an API object (backendRefs).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -107,74 +110,116 @@ public HTTPRouteRule(List<HTTPBackendRef> backendRefs, List<HTTPRouteFilter> fil
         this.timeouts = timeouts;
     }
 
+    /**
+     * BackendRefs defines the backend(s) where matching requests should be sent.<br><p> <br><p> Failure behavior here depends on how many BackendRefs are specified and how many are invalid.<br><p> <br><p> If &#42;all&#42; entries in BackendRefs are invalid, and there are also no filters specified in this route rule, &#42;all&#42; traffic which matches this rule MUST receive a 500 status code.<br><p> <br><p> See the HTTPBackendRef definition for the rules about what makes a single HTTPBackendRef invalid.<br><p> <br><p> When a HTTPBackendRef is invalid, 500 status codes MUST be returned for requests that would have otherwise been routed to an invalid backend. If multiple backends are specified, and some are invalid, the proportion of requests that would otherwise have been routed to an invalid backend MUST receive a 500 status code.<br><p> <br><p> For example, if two backends are specified with equal weights, and one is invalid, 50 percent of traffic must receive a 500. Implementations may choose how that 50 percent is determined.<br><p> <br><p> When a HTTPBackendRef refers to a Service that has no ready endpoints, implementations SHOULD return a 503 for requests to that backend instead. If an implementation chooses to do this, all of the above rules for 500 responses MUST also apply for responses that return a 503.<br><p> <br><p> Support: Core for Kubernetes Service<br><p> <br><p> Support: Extended for Kubernetes ServiceImport<br><p> <br><p> Support: Implementation-specific for any other resource<br><p> <br><p> Support for weight: Core
+     */
     @JsonProperty("backendRefs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HTTPBackendRef> getBackendRefs() {
         return backendRefs;
     }
 
+    /**
+     * BackendRefs defines the backend(s) where matching requests should be sent.<br><p> <br><p> Failure behavior here depends on how many BackendRefs are specified and how many are invalid.<br><p> <br><p> If &#42;all&#42; entries in BackendRefs are invalid, and there are also no filters specified in this route rule, &#42;all&#42; traffic which matches this rule MUST receive a 500 status code.<br><p> <br><p> See the HTTPBackendRef definition for the rules about what makes a single HTTPBackendRef invalid.<br><p> <br><p> When a HTTPBackendRef is invalid, 500 status codes MUST be returned for requests that would have otherwise been routed to an invalid backend. If multiple backends are specified, and some are invalid, the proportion of requests that would otherwise have been routed to an invalid backend MUST receive a 500 status code.<br><p> <br><p> For example, if two backends are specified with equal weights, and one is invalid, 50 percent of traffic must receive a 500. Implementations may choose how that 50 percent is determined.<br><p> <br><p> When a HTTPBackendRef refers to a Service that has no ready endpoints, implementations SHOULD return a 503 for requests to that backend instead. If an implementation chooses to do this, all of the above rules for 500 responses MUST also apply for responses that return a 503.<br><p> <br><p> Support: Core for Kubernetes Service<br><p> <br><p> Support: Extended for Kubernetes ServiceImport<br><p> <br><p> Support: Implementation-specific for any other resource<br><p> <br><p> Support for weight: Core
+     */
     @JsonProperty("backendRefs")
     public void setBackendRefs(List<HTTPBackendRef> backendRefs) {
         this.backendRefs = backendRefs;
     }
 
+    /**
+     * Filters define the filters that are applied to requests that match this rule.<br><p> <br><p> Wherever possible, implementations SHOULD implement filters in the order they are specified.<br><p> <br><p> Implementations MAY choose to implement this ordering strictly, rejecting any combination or order of filters that can not be supported. If implementations choose a strict interpretation of filter ordering, they MUST clearly document that behavior.<br><p> <br><p> To reject an invalid combination or order of filters, implementations SHOULD consider the Route Rules with this configuration invalid. If all Route Rules in a Route are invalid, the entire Route would be considered invalid. If only a portion of Route Rules are invalid, implementations MUST set the "PartiallyInvalid" condition for the Route.<br><p> <br><p> Conformance-levels at this level are defined based on the type of filter:<br><p> <br><p> - ALL core filters MUST be supported by all implementations. - Implementers are encouraged to support extended filters. - Implementation-specific custom filters have no API guarantees across<br><p>   implementations.<br><p> <br><p> Specifying the same filter multiple times is not supported unless explicitly indicated in the filter.<br><p> <br><p> All filters are expected to be compatible with each other except for the URLRewrite and RequestRedirect filters, which may not be combined. If an implementation can not support other combinations of filters, they must clearly document that limitation. In cases where incompatible or unsupported filters are specified and cause the `Accepted` condition to be set to status `False`, implementations may use the `IncompatibleFilters` reason to specify this configuration error.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("filters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HTTPRouteFilter> getFilters() {
         return filters;
     }
 
+    /**
+     * Filters define the filters that are applied to requests that match this rule.<br><p> <br><p> Wherever possible, implementations SHOULD implement filters in the order they are specified.<br><p> <br><p> Implementations MAY choose to implement this ordering strictly, rejecting any combination or order of filters that can not be supported. If implementations choose a strict interpretation of filter ordering, they MUST clearly document that behavior.<br><p> <br><p> To reject an invalid combination or order of filters, implementations SHOULD consider the Route Rules with this configuration invalid. If all Route Rules in a Route are invalid, the entire Route would be considered invalid. If only a portion of Route Rules are invalid, implementations MUST set the "PartiallyInvalid" condition for the Route.<br><p> <br><p> Conformance-levels at this level are defined based on the type of filter:<br><p> <br><p> - ALL core filters MUST be supported by all implementations. - Implementers are encouraged to support extended filters. - Implementation-specific custom filters have no API guarantees across<br><p>   implementations.<br><p> <br><p> Specifying the same filter multiple times is not supported unless explicitly indicated in the filter.<br><p> <br><p> All filters are expected to be compatible with each other except for the URLRewrite and RequestRedirect filters, which may not be combined. If an implementation can not support other combinations of filters, they must clearly document that limitation. In cases where incompatible or unsupported filters are specified and cause the `Accepted` condition to be set to status `False`, implementations may use the `IncompatibleFilters` reason to specify this configuration error.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("filters")
     public void setFilters(List<HTTPRouteFilter> filters) {
         this.filters = filters;
     }
 
+    /**
+     * Matches define conditions used for matching the rule against incoming HTTP requests. Each match is independent, i.e. this rule will be matched if &#42;&#42;any&#42;&#42; one of the matches is satisfied.<br><p> <br><p> For example, take the following matches configuration:<br><p> <br><p> ``` matches: - path:<br><p>     value: "/foo"<br><p>   headers:<br><p>   - name: "version"<br><p>     value: "v2"<br><p> - path:<br><p>     value: "/v2/foo"<br><p> ```<br><p> <br><p> For a request to match against this rule, a request must satisfy EITHER of the two conditions:<br><p> <br><p> - path prefixed with `/foo` AND contains the header `version: v2` - path prefix of `/v2/foo`<br><p> <br><p> See the documentation for HTTPRouteMatch on how to specify multiple match conditions that should be ANDed together.<br><p> <br><p> If no matches are specified, the default is a prefix path match on "/", which has the effect of matching every HTTP request.<br><p> <br><p> Proxy or Load Balancer routing configuration generated from HTTPRoutes MUST prioritize matches based on the following criteria, continuing on ties. Across all rules specified on applicable Routes, precedence must be given to the match having:<br><p> <br><p> &#42; "Exact" path match. &#42; "Prefix" path match with largest number of characters. &#42; Method match. &#42; Largest number of header matches. &#42; Largest number of query param matches.<br><p> <br><p> Note: The precedence of RegularExpression path matches are implementation-specific.<br><p> <br><p> If ties still exist across multiple Routes, matching precedence MUST be determined in order of the following criteria, continuing on ties:<br><p> <br><p> &#42; The oldest Route based on creation timestamp. &#42; The Route appearing first in alphabetical order by<br><p>   "{namespace}/{name}".<br><p> <br><p> If ties still exist within an HTTPRoute, matching precedence MUST be granted to the FIRST matching rule (in list order) with a match meeting the above criteria.<br><p> <br><p> When no rules matching a request have been successfully attached to the parent a request is coming from, a HTTP 404 status code MUST be returned.
+     */
     @JsonProperty("matches")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HTTPRouteMatch> getMatches() {
         return matches;
     }
 
+    /**
+     * Matches define conditions used for matching the rule against incoming HTTP requests. Each match is independent, i.e. this rule will be matched if &#42;&#42;any&#42;&#42; one of the matches is satisfied.<br><p> <br><p> For example, take the following matches configuration:<br><p> <br><p> ``` matches: - path:<br><p>     value: "/foo"<br><p>   headers:<br><p>   - name: "version"<br><p>     value: "v2"<br><p> - path:<br><p>     value: "/v2/foo"<br><p> ```<br><p> <br><p> For a request to match against this rule, a request must satisfy EITHER of the two conditions:<br><p> <br><p> - path prefixed with `/foo` AND contains the header `version: v2` - path prefix of `/v2/foo`<br><p> <br><p> See the documentation for HTTPRouteMatch on how to specify multiple match conditions that should be ANDed together.<br><p> <br><p> If no matches are specified, the default is a prefix path match on "/", which has the effect of matching every HTTP request.<br><p> <br><p> Proxy or Load Balancer routing configuration generated from HTTPRoutes MUST prioritize matches based on the following criteria, continuing on ties. Across all rules specified on applicable Routes, precedence must be given to the match having:<br><p> <br><p> &#42; "Exact" path match. &#42; "Prefix" path match with largest number of characters. &#42; Method match. &#42; Largest number of header matches. &#42; Largest number of query param matches.<br><p> <br><p> Note: The precedence of RegularExpression path matches are implementation-specific.<br><p> <br><p> If ties still exist across multiple Routes, matching precedence MUST be determined in order of the following criteria, continuing on ties:<br><p> <br><p> &#42; The oldest Route based on creation timestamp. &#42; The Route appearing first in alphabetical order by<br><p>   "{namespace}/{name}".<br><p> <br><p> If ties still exist within an HTTPRoute, matching precedence MUST be granted to the FIRST matching rule (in list order) with a match meeting the above criteria.<br><p> <br><p> When no rules matching a request have been successfully attached to the parent a request is coming from, a HTTP 404 status code MUST be returned.
+     */
     @JsonProperty("matches")
     public void setMatches(List<HTTPRouteMatch> matches) {
         this.matches = matches;
     }
 
+    /**
+     * Name is the name of the route rule. This name MUST be unique within a Route if it is set.<br><p> <br><p> Support: Extended &lt;gateway:experimental&gt;
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the route rule. This name MUST be unique within a Route if it is set.<br><p> <br><p> Support: Extended &lt;gateway:experimental&gt;
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * HTTPRouteRule defines semantics for matching an HTTP request based on conditions (matches), processing it (filters), and forwarding the request to an API object (backendRefs).
+     */
     @JsonProperty("retry")
     public HTTPRouteRetry getRetry() {
         return retry;
     }
 
+    /**
+     * HTTPRouteRule defines semantics for matching an HTTP request based on conditions (matches), processing it (filters), and forwarding the request to an API object (backendRefs).
+     */
     @JsonProperty("retry")
     public void setRetry(HTTPRouteRetry retry) {
         this.retry = retry;
     }
 
+    /**
+     * HTTPRouteRule defines semantics for matching an HTTP request based on conditions (matches), processing it (filters), and forwarding the request to an API object (backendRefs).
+     */
     @JsonProperty("sessionPersistence")
     public SessionPersistence getSessionPersistence() {
         return sessionPersistence;
     }
 
+    /**
+     * HTTPRouteRule defines semantics for matching an HTTP request based on conditions (matches), processing it (filters), and forwarding the request to an API object (backendRefs).
+     */
     @JsonProperty("sessionPersistence")
     public void setSessionPersistence(SessionPersistence sessionPersistence) {
         this.sessionPersistence = sessionPersistence;
     }
 
+    /**
+     * HTTPRouteRule defines semantics for matching an HTTP request based on conditions (matches), processing it (filters), and forwarding the request to an API object (backendRefs).
+     */
     @JsonProperty("timeouts")
     public HTTPRouteTimeouts getTimeouts() {
         return timeouts;
     }
 
+    /**
+     * HTTPRouteRule defines semantics for matching an HTTP request based on conditions (matches), processing it (filters), and forwarding the request to an API object (backendRefs).
+     */
     @JsonProperty("timeouts")
     public void setTimeouts(HTTPRouteTimeouts timeouts) {
         this.timeouts = timeouts;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteSpec.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteSpec.java
index 0785b9dfb06..814a1576e45 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPRouteSpec defines the desired state of HTTPRoute
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,34 +94,52 @@ public HTTPRouteSpec(List<String> hostnames, List<ParentReference> parentRefs, L
         this.rules = rules;
     }
 
+    /**
+     * Hostnames defines a set of hostnames that should match against the HTTP Host header to select a HTTPRoute used to process the request. Implementations MUST ignore any port value specified in the HTTP Host header while performing a match and (absent of any applicable header modification configuration) MUST forward this header unmodified to the backend.<br><p> <br><p> Valid values for Hostnames are determined by RFC 1123 definition of a hostname with 2 notable exceptions:<br><p> <br><p> 1. IPs are not allowed. 2. A hostname may be prefixed with a wildcard label (`&#42;.`). The wildcard<br><p>    label must appear by itself as the first label.<br><p> <br><p> If a hostname is specified by both the Listener and HTTPRoute, there must be at least one intersecting hostname for the HTTPRoute to be attached to the Listener. For example:<br><p> <br><p> &#42; A Listener with `test.example.com` as the hostname matches HTTPRoutes<br><p>   that have either not specified any hostnames, or have specified at<br><p>   least one of `test.example.com` or `&#42;.example.com`.<br><p> &#42; A Listener with `&#42;.example.com` as the hostname matches HTTPRoutes<br><p>   that have either not specified any hostnames or have specified at least<br><p>   one hostname that matches the Listener hostname. For example,<br><p>   `&#42;.example.com`, `test.example.com`, and `foo.test.example.com` would<br><p>   all match. On the other hand, `example.com` and `test.example.net` would<br><p>   not match.<br><p> <br><p> Hostnames that are prefixed with a wildcard label (`&#42;.`) are interpreted as a suffix match. That means that a match for `&#42;.example.com` would match both `test.example.com`, and `foo.test.example.com`, but not `example.com`.<br><p> <br><p> If both the Listener and HTTPRoute have specified hostnames, any HTTPRoute hostnames that do not match the Listener hostname MUST be ignored. For example, if a Listener specified `&#42;.example.com`, and the HTTPRoute specified `test.example.com` and `test.example.net`, `test.example.net` must not be considered for a match.<br><p> <br><p> If both the Listener and HTTPRoute have specified hostnames, and none match with the criteria above, then the HTTPRoute is not accepted. The implementation must raise an 'Accepted' Condition with a status of `False` in the corresponding RouteParentStatus.<br><p> <br><p> In the event that multiple HTTPRoutes specify intersecting hostnames (e.g. overlapping wildcard matching and exact matching hostnames), precedence must be given to rules from the HTTPRoute with the largest number of:<br><p> <br><p> &#42; Characters in a matching non-wildcard hostname. &#42; Characters in a matching hostname.<br><p> <br><p> If ties exist across multiple Routes, the matching precedence rules for HTTPRouteMatches takes over.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("hostnames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getHostnames() {
         return hostnames;
     }
 
+    /**
+     * Hostnames defines a set of hostnames that should match against the HTTP Host header to select a HTTPRoute used to process the request. Implementations MUST ignore any port value specified in the HTTP Host header while performing a match and (absent of any applicable header modification configuration) MUST forward this header unmodified to the backend.<br><p> <br><p> Valid values for Hostnames are determined by RFC 1123 definition of a hostname with 2 notable exceptions:<br><p> <br><p> 1. IPs are not allowed. 2. A hostname may be prefixed with a wildcard label (`&#42;.`). The wildcard<br><p>    label must appear by itself as the first label.<br><p> <br><p> If a hostname is specified by both the Listener and HTTPRoute, there must be at least one intersecting hostname for the HTTPRoute to be attached to the Listener. For example:<br><p> <br><p> &#42; A Listener with `test.example.com` as the hostname matches HTTPRoutes<br><p>   that have either not specified any hostnames, or have specified at<br><p>   least one of `test.example.com` or `&#42;.example.com`.<br><p> &#42; A Listener with `&#42;.example.com` as the hostname matches HTTPRoutes<br><p>   that have either not specified any hostnames or have specified at least<br><p>   one hostname that matches the Listener hostname. For example,<br><p>   `&#42;.example.com`, `test.example.com`, and `foo.test.example.com` would<br><p>   all match. On the other hand, `example.com` and `test.example.net` would<br><p>   not match.<br><p> <br><p> Hostnames that are prefixed with a wildcard label (`&#42;.`) are interpreted as a suffix match. That means that a match for `&#42;.example.com` would match both `test.example.com`, and `foo.test.example.com`, but not `example.com`.<br><p> <br><p> If both the Listener and HTTPRoute have specified hostnames, any HTTPRoute hostnames that do not match the Listener hostname MUST be ignored. For example, if a Listener specified `&#42;.example.com`, and the HTTPRoute specified `test.example.com` and `test.example.net`, `test.example.net` must not be considered for a match.<br><p> <br><p> If both the Listener and HTTPRoute have specified hostnames, and none match with the criteria above, then the HTTPRoute is not accepted. The implementation must raise an 'Accepted' Condition with a status of `False` in the corresponding RouteParentStatus.<br><p> <br><p> In the event that multiple HTTPRoutes specify intersecting hostnames (e.g. overlapping wildcard matching and exact matching hostnames), precedence must be given to rules from the HTTPRoute with the largest number of:<br><p> <br><p> &#42; Characters in a matching non-wildcard hostname. &#42; Characters in a matching hostname.<br><p> <br><p> If ties exist across multiple Routes, the matching precedence rules for HTTPRouteMatches takes over.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("hostnames")
     public void setHostnames(List<String> hostnames) {
         this.hostnames = hostnames;
     }
 
+    /**
+     * ParentRefs references the resources (usually Gateways) that a Route wants to be attached to. Note that the referenced parent resource needs to allow this for the attachment to be complete. For Gateways, that means the Gateway needs to allow attachment from Routes of this kind and namespace. For Services, that means the Service must either be in the same namespace for a "producer" route, or the mesh implementation must support and allow "consumer" routes for the referenced Service. ReferenceGrant is not applicable for governing ParentRefs to Services - it is not possible to create a "producer" route for a Service in a different namespace from the Route.<br><p> <br><p> There are two kinds of parent resources with "Core" support:<br><p> <br><p> &#42; Gateway (Gateway conformance profile) &#42; Service (Mesh conformance profile, ClusterIP Services only)<br><p> <br><p> This API may be extended in the future to support additional kinds of parent resources.<br><p> <br><p> ParentRefs must be _distinct_. This means either that:<br><p> <br><p> &#42; They select different objects.  If this is the case, then parentRef<br><p>   entries are distinct. In terms of fields, this means that the<br><p>   multi-part key defined by `group`, `kind`, `namespace`, and `name` must<br><p>   be unique across all parentRef entries in the Route.<br><p> &#42; They do not select different objects, but for each optional field used,<br><p>   each ParentRef that selects the same object must set the same set of<br><p>   optional fields to different values. If one ParentRef sets a<br><p>   combination of optional fields, all must set the same combination.<br><p> <br><p> Some examples:<br><p> <br><p> &#42; If one ParentRef sets `sectionName`, all ParentRefs referencing the<br><p>   same object must also set `sectionName`.<br><p> &#42; If one ParentRef sets `port`, all ParentRefs referencing the same<br><p>   object must also set `port`.<br><p> &#42; If one ParentRef sets `sectionName` and `port`, all ParentRefs<br><p>   referencing the same object must also set `sectionName` and `port`.<br><p> <br><p> It is possible to separately reference multiple distinct objects that may be collapsed by an implementation. For example, some implementations may choose to merge compatible Gateway Listeners together. If that is the case, the list of routes attached to those resources should also be merged.<br><p> <br><p> Note that for ParentRefs that cross namespace boundaries, there are specific rules. Cross-namespace references are only valid if they are explicitly allowed by something in the namespace they are referring to. For example, Gateway has the AllowedRoutes field, and ReferenceGrant provides a generic way to enable other kinds of cross-namespace reference.<br><p> <br><p> &lt;gateway:experimental:description&gt; ParentRefs from a Route to a Service in the same namespace are "producer" routes, which apply default routing rules to inbound connections from any namespace to the Service.<br><p> <br><p> ParentRefs from a Route to a Service in a different namespace are "consumer" routes, and these routing rules are only applied to outbound connections originating from the same namespace as the Route, for which the intended destination of the connections are a Service targeted as a ParentRef of the Route. &lt;/gateway:experimental:description&gt;<br><p> <br><p> &lt;gateway:standard:validation:XValidation:message="sectionName must be specified when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.all(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) ? ((!has(p1.sectionName) || p1.sectionName == '') == (!has(p2.sectionName) || p2.sectionName == '')) : true))"&gt; &lt;gateway:standard:validation:XValidation:message="sectionName must be unique when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.exists_one(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) &amp;&amp; (((!has(p1.sectionName) || p1.sectionName == '') &amp;&amp; (!has(p2.sectionName) || p2.sectionName == '')) || (has(p1.sectionName) &amp;&amp; has(p2.sectionName) &amp;&amp; p1.sectionName == p2.sectionName))))"&gt; &lt;gateway:experimental:validation:XValidation:message="sectionName or port must be specified when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.all(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__)) ? ((!has(p1.sectionName) || p1.sectionName == '') == (!has(p2.sectionName) || p2.sectionName == '') &amp;&amp; (!has(p1.port) || p1.port == 0) == (!has(p2.port) || p2.port == 0)): true))"&gt; &lt;gateway:experimental:validation:XValidation:message="sectionName or port must be unique when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.exists_one(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) &amp;&amp; (((!has(p1.sectionName) || p1.sectionName == '') &amp;&amp; (!has(p2.sectionName) || p2.sectionName == '')) || ( has(p1.sectionName) &amp;&amp; has(p2.sectionName) &amp;&amp; p1.sectionName == p2.sectionName)) &amp;&amp; (((!has(p1.port) || p1.port == 0) &amp;&amp; (!has(p2.port) || p2.port == 0)) || (has(p1.port) &amp;&amp; has(p2.port) &amp;&amp; p1.port == p2.port))))"&gt;
+     */
     @JsonProperty("parentRefs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ParentReference> getParentRefs() {
         return parentRefs;
     }
 
+    /**
+     * ParentRefs references the resources (usually Gateways) that a Route wants to be attached to. Note that the referenced parent resource needs to allow this for the attachment to be complete. For Gateways, that means the Gateway needs to allow attachment from Routes of this kind and namespace. For Services, that means the Service must either be in the same namespace for a "producer" route, or the mesh implementation must support and allow "consumer" routes for the referenced Service. ReferenceGrant is not applicable for governing ParentRefs to Services - it is not possible to create a "producer" route for a Service in a different namespace from the Route.<br><p> <br><p> There are two kinds of parent resources with "Core" support:<br><p> <br><p> &#42; Gateway (Gateway conformance profile) &#42; Service (Mesh conformance profile, ClusterIP Services only)<br><p> <br><p> This API may be extended in the future to support additional kinds of parent resources.<br><p> <br><p> ParentRefs must be _distinct_. This means either that:<br><p> <br><p> &#42; They select different objects.  If this is the case, then parentRef<br><p>   entries are distinct. In terms of fields, this means that the<br><p>   multi-part key defined by `group`, `kind`, `namespace`, and `name` must<br><p>   be unique across all parentRef entries in the Route.<br><p> &#42; They do not select different objects, but for each optional field used,<br><p>   each ParentRef that selects the same object must set the same set of<br><p>   optional fields to different values. If one ParentRef sets a<br><p>   combination of optional fields, all must set the same combination.<br><p> <br><p> Some examples:<br><p> <br><p> &#42; If one ParentRef sets `sectionName`, all ParentRefs referencing the<br><p>   same object must also set `sectionName`.<br><p> &#42; If one ParentRef sets `port`, all ParentRefs referencing the same<br><p>   object must also set `port`.<br><p> &#42; If one ParentRef sets `sectionName` and `port`, all ParentRefs<br><p>   referencing the same object must also set `sectionName` and `port`.<br><p> <br><p> It is possible to separately reference multiple distinct objects that may be collapsed by an implementation. For example, some implementations may choose to merge compatible Gateway Listeners together. If that is the case, the list of routes attached to those resources should also be merged.<br><p> <br><p> Note that for ParentRefs that cross namespace boundaries, there are specific rules. Cross-namespace references are only valid if they are explicitly allowed by something in the namespace they are referring to. For example, Gateway has the AllowedRoutes field, and ReferenceGrant provides a generic way to enable other kinds of cross-namespace reference.<br><p> <br><p> &lt;gateway:experimental:description&gt; ParentRefs from a Route to a Service in the same namespace are "producer" routes, which apply default routing rules to inbound connections from any namespace to the Service.<br><p> <br><p> ParentRefs from a Route to a Service in a different namespace are "consumer" routes, and these routing rules are only applied to outbound connections originating from the same namespace as the Route, for which the intended destination of the connections are a Service targeted as a ParentRef of the Route. &lt;/gateway:experimental:description&gt;<br><p> <br><p> &lt;gateway:standard:validation:XValidation:message="sectionName must be specified when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.all(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) ? ((!has(p1.sectionName) || p1.sectionName == '') == (!has(p2.sectionName) || p2.sectionName == '')) : true))"&gt; &lt;gateway:standard:validation:XValidation:message="sectionName must be unique when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.exists_one(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) &amp;&amp; (((!has(p1.sectionName) || p1.sectionName == '') &amp;&amp; (!has(p2.sectionName) || p2.sectionName == '')) || (has(p1.sectionName) &amp;&amp; has(p2.sectionName) &amp;&amp; p1.sectionName == p2.sectionName))))"&gt; &lt;gateway:experimental:validation:XValidation:message="sectionName or port must be specified when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.all(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__)) ? ((!has(p1.sectionName) || p1.sectionName == '') == (!has(p2.sectionName) || p2.sectionName == '') &amp;&amp; (!has(p1.port) || p1.port == 0) == (!has(p2.port) || p2.port == 0)): true))"&gt; &lt;gateway:experimental:validation:XValidation:message="sectionName or port must be unique when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.exists_one(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) &amp;&amp; (((!has(p1.sectionName) || p1.sectionName == '') &amp;&amp; (!has(p2.sectionName) || p2.sectionName == '')) || ( has(p1.sectionName) &amp;&amp; has(p2.sectionName) &amp;&amp; p1.sectionName == p2.sectionName)) &amp;&amp; (((!has(p1.port) || p1.port == 0) &amp;&amp; (!has(p2.port) || p2.port == 0)) || (has(p1.port) &amp;&amp; has(p2.port) &amp;&amp; p1.port == p2.port))))"&gt;
+     */
     @JsonProperty("parentRefs")
     public void setParentRefs(List<ParentReference> parentRefs) {
         this.parentRefs = parentRefs;
     }
 
+    /**
+     * Rules are a list of HTTP matchers, filters and actions.<br><p> <br><p> &lt;gateway:experimental:validation:XValidation:message="Rule name must be unique within the route",rule="self.all(l1, !has(l1.name) || self.exists_one(l2, has(l2.name) &amp;&amp; l1.name == l2.name))"&gt;
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HTTPRouteRule> getRules() {
         return rules;
     }
 
+    /**
+     * Rules are a list of HTTP matchers, filters and actions.<br><p> <br><p> &lt;gateway:experimental:validation:XValidation:message="Rule name must be unique within the route",rule="self.all(l1, !has(l1.name) || self.exists_one(l2, has(l2.name) &amp;&amp; l1.name == l2.name))"&gt;
+     */
     @JsonProperty("rules")
     public void setRules(List<HTTPRouteRule> rules) {
         this.rules = rules;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteStatus.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteStatus.java
index b77dc83821b..11a30a86954 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPRouteStatus defines the observed state of HTTPRoute.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public HTTPRouteStatus(List<RouteParentStatus> parents) {
         this.parents = parents;
     }
 
+    /**
+     * Parents is a list of parent resources (usually Gateways) that are associated with the route, and the status of the route with respect to each parent. When this route attaches to a parent, the controller that manages the parent must add an entry to this list when the controller first sees the route and should update the entry as appropriate when the route or gateway is modified.<br><p> <br><p> Note that parent references that cannot be resolved by an implementation of this API will not be added to this list. Implementations of this API can only populate Route status for the Gateways/parent resources they are responsible for.<br><p> <br><p> A maximum of 32 Gateways will be represented in this list. An empty list means the route has not been attached to any Gateway.
+     */
     @JsonProperty("parents")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RouteParentStatus> getParents() {
         return parents;
     }
 
+    /**
+     * Parents is a list of parent resources (usually Gateways) that are associated with the route, and the status of the route with respect to each parent. When this route attaches to a parent, the controller that manages the parent must add an entry to this list when the controller first sees the route and should update the entry as appropriate when the route or gateway is modified.<br><p> <br><p> Note that parent references that cannot be resolved by an implementation of this API will not be added to this list. Implementations of this API can only populate Route status for the Gateways/parent resources they are responsible for.<br><p> <br><p> A maximum of 32 Gateways will be represented in this list. An empty list means the route has not been attached to any Gateway.
+     */
     @JsonProperty("parents")
     public void setParents(List<RouteParentStatus> parents) {
         this.parents = parents;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteTimeouts.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteTimeouts.java
index 0e4cba8a552..29c2360d7c4 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteTimeouts.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPRouteTimeouts.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPRouteTimeouts defines timeouts that can be configured for an HTTPRoute.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public HTTPRouteTimeouts(String backendRequest, String request) {
         this.request = request;
     }
 
+    /**
+     * BackendRequest specifies a timeout for an individual request from the gateway to a backend. This covers the time from when the request first starts being sent from the gateway to when the full response has been received from the backend.<br><p> <br><p> Setting a timeout to the zero duration (e.g. "0s") SHOULD disable the timeout completely. Implementations that cannot completely disable the timeout MUST instead interpret the zero duration as the longest possible value to which the timeout can be set.<br><p> <br><p> An entire client HTTP transaction with a gateway, covered by the Request timeout, may result in more than one call from the gateway to the destination backend, for example, if automatic retries are supported.<br><p> <br><p> The value of BackendRequest must be a Gateway API Duration string as defined by GEP-2257.  When this field is unspecified, its behavior is implementation-specific; when specified, the value of BackendRequest must be no more than the value of the Request timeout (since the Request timeout encompasses the BackendRequest timeout).<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("backendRequest")
     public String getBackendRequest() {
         return backendRequest;
     }
 
+    /**
+     * BackendRequest specifies a timeout for an individual request from the gateway to a backend. This covers the time from when the request first starts being sent from the gateway to when the full response has been received from the backend.<br><p> <br><p> Setting a timeout to the zero duration (e.g. "0s") SHOULD disable the timeout completely. Implementations that cannot completely disable the timeout MUST instead interpret the zero duration as the longest possible value to which the timeout can be set.<br><p> <br><p> An entire client HTTP transaction with a gateway, covered by the Request timeout, may result in more than one call from the gateway to the destination backend, for example, if automatic retries are supported.<br><p> <br><p> The value of BackendRequest must be a Gateway API Duration string as defined by GEP-2257.  When this field is unspecified, its behavior is implementation-specific; when specified, the value of BackendRequest must be no more than the value of the Request timeout (since the Request timeout encompasses the BackendRequest timeout).<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("backendRequest")
     public void setBackendRequest(String backendRequest) {
         this.backendRequest = backendRequest;
     }
 
+    /**
+     * Request specifies the maximum duration for a gateway to respond to an HTTP request. If the gateway has not been able to respond before this deadline is met, the gateway MUST return a timeout error.<br><p> <br><p> For example, setting the `rules.timeouts.request` field to the value `10s` in an `HTTPRoute` will cause a timeout if a client request is taking longer than 10 seconds to complete.<br><p> <br><p> Setting a timeout to the zero duration (e.g. "0s") SHOULD disable the timeout completely. Implementations that cannot completely disable the timeout MUST instead interpret the zero duration as the longest possible value to which the timeout can be set.<br><p> <br><p> This timeout is intended to cover as close to the whole request-response transaction as possible although an implementation MAY choose to start the timeout after the entire request stream has been received instead of immediately after the transaction is initiated by the client.<br><p> <br><p> The value of Request is a Gateway API Duration string as defined by GEP-2257. When this field is unspecified, request timeout behavior is implementation-specific.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("request")
     public String getRequest() {
         return request;
     }
 
+    /**
+     * Request specifies the maximum duration for a gateway to respond to an HTTP request. If the gateway has not been able to respond before this deadline is met, the gateway MUST return a timeout error.<br><p> <br><p> For example, setting the `rules.timeouts.request` field to the value `10s` in an `HTTPRoute` will cause a timeout if a client request is taking longer than 10 seconds to complete.<br><p> <br><p> Setting a timeout to the zero duration (e.g. "0s") SHOULD disable the timeout completely. Implementations that cannot completely disable the timeout MUST instead interpret the zero duration as the longest possible value to which the timeout can be set.<br><p> <br><p> This timeout is intended to cover as close to the whole request-response transaction as possible although an implementation MAY choose to start the timeout after the entire request stream has been received instead of immediately after the transaction is initiated by the client.<br><p> <br><p> The value of Request is a Gateway API Duration string as defined by GEP-2257. When this field is unspecified, request timeout behavior is implementation-specific.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("request")
     public void setRequest(String request) {
         this.request = request;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPURLRewriteFilter.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPURLRewriteFilter.java
index 406769f07e1..a798f994c27 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPURLRewriteFilter.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/HTTPURLRewriteFilter.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPURLRewriteFilter defines a filter that modifies a request during forwarding. At most one of these filters may be used on a Route rule. This MUST NOT be used on the same Route rule as a HTTPRequestRedirect filter.<br><p> <br><p> Support: Extended<br><p> <br><p> &lt;gateway:experimental&gt;
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public HTTPURLRewriteFilter(String hostname, HTTPPathModifier path) {
         this.path = path;
     }
 
+    /**
+     * Hostname is the value to be used to replace the Host header value during forwarding.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("hostname")
     public String getHostname() {
         return hostname;
     }
 
+    /**
+     * Hostname is the value to be used to replace the Host header value during forwarding.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("hostname")
     public void setHostname(String hostname) {
         this.hostname = hostname;
     }
 
+    /**
+     * HTTPURLRewriteFilter defines a filter that modifies a request during forwarding. At most one of these filters may be used on a Route rule. This MUST NOT be used on the same Route rule as a HTTPRequestRedirect filter.<br><p> <br><p> Support: Extended<br><p> <br><p> &lt;gateway:experimental&gt;
+     */
     @JsonProperty("path")
     public HTTPPathModifier getPath() {
         return path;
     }
 
+    /**
+     * HTTPURLRewriteFilter defines a filter that modifies a request during forwarding. At most one of these filters may be used on a Route rule. This MUST NOT be used on the same Route rule as a HTTPRequestRedirect filter.<br><p> <br><p> Support: Extended<br><p> <br><p> &lt;gateway:experimental&gt;
+     */
     @JsonProperty("path")
     public void setPath(HTTPPathModifier path) {
         this.path = path;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/Listener.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/Listener.java
index 2434c9f552e..2ddc81d66a0 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/Listener.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/Listener.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Listener embodies the concept of a logical endpoint where a Gateway accepts network connections.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public Listener(AllowedRoutes allowedRoutes, String hostname, String name, Integ
         this.tls = tls;
     }
 
+    /**
+     * Listener embodies the concept of a logical endpoint where a Gateway accepts network connections.
+     */
     @JsonProperty("allowedRoutes")
     public AllowedRoutes getAllowedRoutes() {
         return allowedRoutes;
     }
 
+    /**
+     * Listener embodies the concept of a logical endpoint where a Gateway accepts network connections.
+     */
     @JsonProperty("allowedRoutes")
     public void setAllowedRoutes(AllowedRoutes allowedRoutes) {
         this.allowedRoutes = allowedRoutes;
     }
 
+    /**
+     * Hostname specifies the virtual hostname to match for protocol types that define this concept. When unspecified, all hostnames are matched. This field is ignored for protocols that don't require hostname based matching.<br><p> <br><p> Implementations MUST apply Hostname matching appropriately for each of the following protocols:<br><p> <br><p> &#42; TLS: The Listener Hostname MUST match the SNI. &#42; HTTP: The Listener Hostname MUST match the Host header of the request. &#42; HTTPS: The Listener Hostname SHOULD match at both the TLS and HTTP<br><p>   protocol layers as described above. If an implementation does not<br><p>   ensure that both the SNI and Host header match the Listener hostname,<br><p>   it MUST clearly document that.<br><p> <br><p> For HTTPRoute and TLSRoute resources, there is an interaction with the `spec.hostnames` array. When both listener and route specify hostnames, there MUST be an intersection between the values for a Route to be accepted. For more information, refer to the Route specific Hostnames documentation.<br><p> <br><p> Hostnames that are prefixed with a wildcard label (`&#42;.`) are interpreted as a suffix match. That means that a match for `&#42;.example.com` would match both `test.example.com`, and `foo.test.example.com`, but not `example.com`.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("hostname")
     public String getHostname() {
         return hostname;
     }
 
+    /**
+     * Hostname specifies the virtual hostname to match for protocol types that define this concept. When unspecified, all hostnames are matched. This field is ignored for protocols that don't require hostname based matching.<br><p> <br><p> Implementations MUST apply Hostname matching appropriately for each of the following protocols:<br><p> <br><p> &#42; TLS: The Listener Hostname MUST match the SNI. &#42; HTTP: The Listener Hostname MUST match the Host header of the request. &#42; HTTPS: The Listener Hostname SHOULD match at both the TLS and HTTP<br><p>   protocol layers as described above. If an implementation does not<br><p>   ensure that both the SNI and Host header match the Listener hostname,<br><p>   it MUST clearly document that.<br><p> <br><p> For HTTPRoute and TLSRoute resources, there is an interaction with the `spec.hostnames` array. When both listener and route specify hostnames, there MUST be an intersection between the values for a Route to be accepted. For more information, refer to the Route specific Hostnames documentation.<br><p> <br><p> Hostnames that are prefixed with a wildcard label (`&#42;.`) are interpreted as a suffix match. That means that a match for `&#42;.example.com` would match both `test.example.com`, and `foo.test.example.com`, but not `example.com`.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("hostname")
     public void setHostname(String hostname) {
         this.hostname = hostname;
     }
 
+    /**
+     * Name is the name of the Listener. This name MUST be unique within a Gateway.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the Listener. This name MUST be unique within a Gateway.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Port is the network port. Multiple listeners may use the same port, subject to the Listener compatibility rules.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * Port is the network port. Multiple listeners may use the same port, subject to the Listener compatibility rules.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * Protocol specifies the network protocol this listener expects to receive.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("protocol")
     public String getProtocol() {
         return protocol;
     }
 
+    /**
+     * Protocol specifies the network protocol this listener expects to receive.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("protocol")
     public void setProtocol(String protocol) {
         this.protocol = protocol;
     }
 
+    /**
+     * Listener embodies the concept of a logical endpoint where a Gateway accepts network connections.
+     */
     @JsonProperty("tls")
     public GatewayTLSConfig getTls() {
         return tls;
     }
 
+    /**
+     * Listener embodies the concept of a logical endpoint where a Gateway accepts network connections.
+     */
     @JsonProperty("tls")
     public void setTls(GatewayTLSConfig tls) {
         this.tls = tls;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/ListenerStatus.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/ListenerStatus.java
index 24be405aadd..73fbaad8def 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/ListenerStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/ListenerStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ListenerStatus is the status associated with a Listener.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,43 +98,67 @@ public ListenerStatus(Integer attachedRoutes, List<Condition> conditions, String
         this.supportedKinds = supportedKinds;
     }
 
+    /**
+     * AttachedRoutes represents the total number of Routes that have been successfully attached to this Listener.<br><p> <br><p> Successful attachment of a Route to a Listener is based solely on the combination of the AllowedRoutes field on the corresponding Listener and the Route's ParentRefs field. A Route is successfully attached to a Listener when it is selected by the Listener's AllowedRoutes field AND the Route has a valid ParentRef selecting the whole Gateway resource or a specific Listener as a parent resource (more detail on attachment semantics can be found in the documentation on the various Route kinds ParentRefs fields). Listener or Route status does not impact successful attachment, i.e. the AttachedRoutes field count MUST be set for Listeners with condition Accepted: false and MUST count successfully attached Routes that may themselves have Accepted: false conditions.<br><p> <br><p> Uses for this field include troubleshooting Route attachment and measuring blast radius/impact of changes to a Listener.
+     */
     @JsonProperty("attachedRoutes")
     public Integer getAttachedRoutes() {
         return attachedRoutes;
     }
 
+    /**
+     * AttachedRoutes represents the total number of Routes that have been successfully attached to this Listener.<br><p> <br><p> Successful attachment of a Route to a Listener is based solely on the combination of the AllowedRoutes field on the corresponding Listener and the Route's ParentRefs field. A Route is successfully attached to a Listener when it is selected by the Listener's AllowedRoutes field AND the Route has a valid ParentRef selecting the whole Gateway resource or a specific Listener as a parent resource (more detail on attachment semantics can be found in the documentation on the various Route kinds ParentRefs fields). Listener or Route status does not impact successful attachment, i.e. the AttachedRoutes field count MUST be set for Listeners with condition Accepted: false and MUST count successfully attached Routes that may themselves have Accepted: false conditions.<br><p> <br><p> Uses for this field include troubleshooting Route attachment and measuring blast radius/impact of changes to a Listener.
+     */
     @JsonProperty("attachedRoutes")
     public void setAttachedRoutes(Integer attachedRoutes) {
         this.attachedRoutes = attachedRoutes;
     }
 
+    /**
+     * Conditions describe the current condition of this listener.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions describe the current condition of this listener.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Name is the name of the Listener that this status corresponds to.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the Listener that this status corresponds to.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * SupportedKinds is the list indicating the Kinds supported by this listener. This MUST represent the kinds an implementation supports for that Listener configuration.<br><p> <br><p> If kinds are specified in Spec that are not supported, they MUST NOT appear in this list and an implementation MUST set the "ResolvedRefs" condition to "False" with the "InvalidRouteKinds" reason. If both valid and invalid Route kinds are specified, the implementation MUST reference the valid Route kinds that have been specified.
+     */
     @JsonProperty("supportedKinds")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RouteGroupKind> getSupportedKinds() {
         return supportedKinds;
     }
 
+    /**
+     * SupportedKinds is the list indicating the Kinds supported by this listener. This MUST represent the kinds an implementation supports for that Listener configuration.<br><p> <br><p> If kinds are specified in Spec that are not supported, they MUST NOT appear in this list and an implementation MUST set the "ResolvedRefs" condition to "False" with the "InvalidRouteKinds" reason. If both valid and invalid Route kinds are specified, the implementation MUST reference the valid Route kinds that have been specified.
+     */
     @JsonProperty("supportedKinds")
     public void setSupportedKinds(List<RouteGroupKind> supportedKinds) {
         this.supportedKinds = supportedKinds;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/LocalObjectReference.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/LocalObjectReference.java
index 51fd53b443b..37c25e49d9b 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/LocalObjectReference.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/LocalObjectReference.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LocalObjectReference identifies an API object within the namespace of the referrer. The API object must be valid in the cluster; the Group and Kind must be registered in the cluster for this reference to be valid.<br><p> <br><p> References to objects with invalid Group and Kind are not valid, and must be rejected by the implementation, with appropriate Conditions set on the containing object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,31 +88,49 @@ public LocalObjectReference(String group, String kind, String name) {
         this.name = name;
     }
 
+    /**
+     * Group is the group of the referent. For example, "gateway.networking.k8s.io". When unspecified or empty string, core API group is inferred.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * Group is the group of the referent. For example, "gateway.networking.k8s.io". When unspecified or empty string, core API group is inferred.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * Kind is kind of the referent. For example "HTTPRoute" or "Service".
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is kind of the referent. For example "HTTPRoute" or "Service".
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of the referent.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the referent.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/LocalParametersReference.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/LocalParametersReference.java
index 5854843e145..a8bfbfb099f 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/LocalParametersReference.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/LocalParametersReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LocalParametersReference identifies an API object containing controller-specific configuration resource within the namespace.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public LocalParametersReference(String group, String kind, String name) {
         this.name = name;
     }
 
+    /**
+     * Group is the group of the referent.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * Group is the group of the referent.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * Kind is kind of the referent.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is kind of the referent.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of the referent.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the referent.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/ObjectReference.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/ObjectReference.java
index a9fd6e609ee..c7876085d12 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/ObjectReference.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/ObjectReference.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ObjectReference identifies an API object including its namespace.<br><p> <br><p> The API object must be valid in the cluster; the Group and Kind must be registered in the cluster for this reference to be valid.<br><p> <br><p> References to objects with invalid Group and Kind are not valid, and must be rejected by the implementation, with appropriate Conditions set on the containing object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,41 +92,65 @@ public ObjectReference(String group, String kind, String name, String namespace)
         this.namespace = namespace;
     }
 
+    /**
+     * Group is the group of the referent. For example, "gateway.networking.k8s.io". When unspecified or empty string, core API group is inferred.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * Group is the group of the referent. For example, "gateway.networking.k8s.io". When unspecified or empty string, core API group is inferred.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * Kind is kind of the referent. For example "ConfigMap" or "Service".
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is kind of the referent. For example "ConfigMap" or "Service".
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of the referent.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the referent.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace is the namespace of the referenced object. When unspecified, the local namespace is inferred.<br><p> <br><p> Note that when a namespace different than the local namespace is specified, a ReferenceGrant object is required in the referent namespace to allow that namespace's owner to accept the reference. See the ReferenceGrant documentation for details.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace of the referenced object. When unspecified, the local namespace is inferred.<br><p> <br><p> Note that when a namespace different than the local namespace is specified, a ReferenceGrant object is required in the referent namespace to allow that namespace's owner to accept the reference. See the ReferenceGrant documentation for details.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/ParametersReference.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/ParametersReference.java
index a5b00427e84..968ba8ab762 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/ParametersReference.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/ParametersReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ParametersReference identifies an API object containing controller-specific configuration resource within the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ParametersReference(String group, String kind, String name, String namesp
         this.namespace = namespace;
     }
 
+    /**
+     * Group is the group of the referent.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * Group is the group of the referent.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * Kind is kind of the referent.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is kind of the referent.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of the referent.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the referent.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace is the namespace of the referent. This field is required when referring to a Namespace-scoped resource and MUST be unset when referring to a Cluster-scoped resource.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace of the referent. This field is required when referring to a Namespace-scoped resource and MUST be unset when referring to a Cluster-scoped resource.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/ParentReference.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/ParentReference.java
index 9c89fdcf3a9..3882cfed882 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/ParentReference.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/ParentReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ParentReference identifies an API object (usually a Gateway) that can be considered a parent of this resource (usually a route). The only kind of parent resource with "Core" support is Gateway. This API may be extended in the future to support additional kinds of parent resources, such as HTTPRoute.<br><p> <br><p> Note that there are specific rules for ParentRefs which cross namespace boundaries. Cross-namespace references are only valid if they are explicitly allowed by something in the namespace they are referring to. For example: Gateway has the AllowedRoutes field, and ReferenceGrant provides a generic way to enable any other kind of cross-namespace reference.<br><p> <br><p> The API object must be valid in the cluster; the Group and Kind must be registered in the cluster for this reference to be valid.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public ParentReference(String group, String kind, String name, String namespace,
         this.sectionName = sectionName;
     }
 
+    /**
+     * Group is the group of the referent. When unspecified, "gateway.networking.k8s.io" is inferred. To set the core API group (such as for a "Service" kind referent), Group must be explicitly set to "" (empty string).<br><p> <br><p> Support: Core
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * Group is the group of the referent. When unspecified, "gateway.networking.k8s.io" is inferred. To set the core API group (such as for a "Service" kind referent), Group must be explicitly set to "" (empty string).<br><p> <br><p> Support: Core
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * Kind is kind of the referent.<br><p> <br><p> There are two kinds of parent resources with "Core" support:<br><p> <br><p> &#42; Gateway (Gateway conformance profile) &#42; Service (Mesh conformance profile, ClusterIP Services only)<br><p> <br><p> Support for other resources is Implementation-Specific.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is kind of the referent.<br><p> <br><p> There are two kinds of parent resources with "Core" support:<br><p> <br><p> &#42; Gateway (Gateway conformance profile) &#42; Service (Mesh conformance profile, ClusterIP Services only)<br><p> <br><p> Support for other resources is Implementation-Specific.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of the referent.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the referent.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace is the namespace of the referent. When unspecified, this refers to the local namespace of the Route.<br><p> <br><p> Note that there are specific rules for ParentRefs which cross namespace boundaries. Cross-namespace references are only valid if they are explicitly allowed by something in the namespace they are referring to. For example: Gateway has the AllowedRoutes field, and ReferenceGrant provides a generic way to enable any other kind of cross-namespace reference.<br><p> <br><p> &lt;gateway:experimental:description&gt; ParentRefs from a Route to a Service in the same namespace are "producer" routes, which apply default routing rules to inbound connections from any namespace to the Service.<br><p> <br><p> ParentRefs from a Route to a Service in a different namespace are "consumer" routes, and these routing rules are only applied to outbound connections originating from the same namespace as the Route, for which the intended destination of the connections are a Service targeted as a ParentRef of the Route. &lt;/gateway:experimental:description&gt;<br><p> <br><p> Support: Core
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace of the referent. When unspecified, this refers to the local namespace of the Route.<br><p> <br><p> Note that there are specific rules for ParentRefs which cross namespace boundaries. Cross-namespace references are only valid if they are explicitly allowed by something in the namespace they are referring to. For example: Gateway has the AllowedRoutes field, and ReferenceGrant provides a generic way to enable any other kind of cross-namespace reference.<br><p> <br><p> &lt;gateway:experimental:description&gt; ParentRefs from a Route to a Service in the same namespace are "producer" routes, which apply default routing rules to inbound connections from any namespace to the Service.<br><p> <br><p> ParentRefs from a Route to a Service in a different namespace are "consumer" routes, and these routing rules are only applied to outbound connections originating from the same namespace as the Route, for which the intended destination of the connections are a Service targeted as a ParentRef of the Route. &lt;/gateway:experimental:description&gt;<br><p> <br><p> Support: Core
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Port is the network port this Route targets. It can be interpreted differently based on the type of parent resource.<br><p> <br><p> When the parent resource is a Gateway, this targets all listeners listening on the specified port that also support this kind of Route(and select this Route). It's not recommended to set `Port` unless the networking behaviors specified in a Route must apply to a specific port as opposed to a listener(s) whose port(s) may be changed. When both Port and SectionName are specified, the name and port of the selected listener must match both specified values.<br><p> <br><p> &lt;gateway:experimental:description&gt; When the parent resource is a Service, this targets a specific port in the Service spec. When both Port (experimental) and SectionName are specified, the name and port of the selected port must match both specified values. &lt;/gateway:experimental:description&gt;<br><p> <br><p> Implementations MAY choose to support other parent resources. Implementations supporting other types of parent resources MUST clearly document how/if Port is interpreted.<br><p> <br><p> For the purpose of status, an attachment is considered successful as long as the parent resource accepts it partially. For example, Gateway listeners can restrict which Routes can attach to them by Route kind, namespace, or hostname. If 1 of 2 Gateway listeners accept attachment from the referencing Route, the Route MUST be considered successfully attached. If no Gateway listeners accept attachment from this Route, the Route MUST be considered detached from the Gateway.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * Port is the network port this Route targets. It can be interpreted differently based on the type of parent resource.<br><p> <br><p> When the parent resource is a Gateway, this targets all listeners listening on the specified port that also support this kind of Route(and select this Route). It's not recommended to set `Port` unless the networking behaviors specified in a Route must apply to a specific port as opposed to a listener(s) whose port(s) may be changed. When both Port and SectionName are specified, the name and port of the selected listener must match both specified values.<br><p> <br><p> &lt;gateway:experimental:description&gt; When the parent resource is a Service, this targets a specific port in the Service spec. When both Port (experimental) and SectionName are specified, the name and port of the selected port must match both specified values. &lt;/gateway:experimental:description&gt;<br><p> <br><p> Implementations MAY choose to support other parent resources. Implementations supporting other types of parent resources MUST clearly document how/if Port is interpreted.<br><p> <br><p> For the purpose of status, an attachment is considered successful as long as the parent resource accepts it partially. For example, Gateway listeners can restrict which Routes can attach to them by Route kind, namespace, or hostname. If 1 of 2 Gateway listeners accept attachment from the referencing Route, the Route MUST be considered successfully attached. If no Gateway listeners accept attachment from this Route, the Route MUST be considered detached from the Gateway.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * SectionName is the name of a section within the target resource. In the following resources, SectionName is interpreted as the following:<br><p> <br><p> &#42; Gateway: Listener name. When both Port (experimental) and SectionName are specified, the name and port of the selected listener must match both specified values. &#42; Service: Port name. When both Port (experimental) and SectionName are specified, the name and port of the selected listener must match both specified values.<br><p> <br><p> Implementations MAY choose to support attaching Routes to other resources. If that is the case, they MUST clearly document how SectionName is interpreted.<br><p> <br><p> When unspecified (empty string), this will reference the entire resource. For the purpose of status, an attachment is considered successful if at least one section in the parent resource accepts it. For example, Gateway listeners can restrict which Routes can attach to them by Route kind, namespace, or hostname. If 1 of 2 Gateway listeners accept attachment from the referencing Route, the Route MUST be considered successfully attached. If no Gateway listeners accept attachment from this Route, the Route MUST be considered detached from the Gateway.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("sectionName")
     public String getSectionName() {
         return sectionName;
     }
 
+    /**
+     * SectionName is the name of a section within the target resource. In the following resources, SectionName is interpreted as the following:<br><p> <br><p> &#42; Gateway: Listener name. When both Port (experimental) and SectionName are specified, the name and port of the selected listener must match both specified values. &#42; Service: Port name. When both Port (experimental) and SectionName are specified, the name and port of the selected listener must match both specified values.<br><p> <br><p> Implementations MAY choose to support attaching Routes to other resources. If that is the case, they MUST clearly document how SectionName is interpreted.<br><p> <br><p> When unspecified (empty string), this will reference the entire resource. For the purpose of status, an attachment is considered successful if at least one section in the parent resource accepts it. For example, Gateway listeners can restrict which Routes can attach to them by Route kind, namespace, or hostname. If 1 of 2 Gateway listeners accept attachment from the referencing Route, the Route MUST be considered successfully attached. If no Gateway listeners accept attachment from this Route, the Route MUST be considered detached from the Gateway.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("sectionName")
     public void setSectionName(String sectionName) {
         this.sectionName = sectionName;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/RouteGroupKind.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/RouteGroupKind.java
index 51cd59262b6..51f4feadf37 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/RouteGroupKind.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/RouteGroupKind.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RouteGroupKind indicates the group and kind of a Route resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public RouteGroupKind(String group, String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Group is the group of the Route.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * Group is the group of the Route.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * Kind is the kind of the Route.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is the kind of the Route.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/RouteNamespaces.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/RouteNamespaces.java
index d6bc7030dac..3d2e1d627a5 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/RouteNamespaces.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/RouteNamespaces.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RouteNamespaces indicate which namespaces Routes should be selected from.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public RouteNamespaces(String from, LabelSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * From indicates where Routes will be selected for this Gateway. Possible values are:<br><p> <br><p> &#42; All: Routes in all namespaces may be used by this Gateway. &#42; Selector: Routes in namespaces selected by the selector may be used by<br><p>   this Gateway.<br><p> &#42; Same: Only Routes in the same namespace may be used by this Gateway.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("from")
     public String getFrom() {
         return from;
     }
 
+    /**
+     * From indicates where Routes will be selected for this Gateway. Possible values are:<br><p> <br><p> &#42; All: Routes in all namespaces may be used by this Gateway. &#42; Selector: Routes in namespaces selected by the selector may be used by<br><p>   this Gateway.<br><p> &#42; Same: Only Routes in the same namespace may be used by this Gateway.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("from")
     public void setFrom(String from) {
         this.from = from;
     }
 
+    /**
+     * RouteNamespaces indicate which namespaces Routes should be selected from.
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * RouteNamespaces indicate which namespaces Routes should be selected from.
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/RouteParentStatus.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/RouteParentStatus.java
index a2079601f99..396b275ce71 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/RouteParentStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/RouteParentStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RouteParentStatus describes the status of a route with respect to an associated Parent.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,32 +93,50 @@ public RouteParentStatus(List<Condition> conditions, String controllerName, Pare
         this.parentRef = parentRef;
     }
 
+    /**
+     * Conditions describes the status of the route with respect to the Gateway. Note that the route's availability is also subject to the Gateway's own status conditions and listener status.<br><p> <br><p> If the Route's ParentRef specifies an existing Gateway that supports Routes of this kind AND that Gateway's controller has sufficient access, then that Gateway's controller MUST set the "Accepted" condition on the Route, to indicate whether the route has been accepted or rejected by the Gateway, and why.<br><p> <br><p> A Route MUST be considered "Accepted" if at least one of the Route's rules is implemented by the Gateway.<br><p> <br><p> There are a number of cases where the "Accepted" condition may not be set due to lack of controller visibility, that includes when:<br><p> <br><p> &#42; The Route refers to a non-existent parent. &#42; The Route is of a type that the controller does not support. &#42; The Route is in a namespace the controller does not have access to.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions describes the status of the route with respect to the Gateway. Note that the route's availability is also subject to the Gateway's own status conditions and listener status.<br><p> <br><p> If the Route's ParentRef specifies an existing Gateway that supports Routes of this kind AND that Gateway's controller has sufficient access, then that Gateway's controller MUST set the "Accepted" condition on the Route, to indicate whether the route has been accepted or rejected by the Gateway, and why.<br><p> <br><p> A Route MUST be considered "Accepted" if at least one of the Route's rules is implemented by the Gateway.<br><p> <br><p> There are a number of cases where the "Accepted" condition may not be set due to lack of controller visibility, that includes when:<br><p> <br><p> &#42; The Route refers to a non-existent parent. &#42; The Route is of a type that the controller does not support. &#42; The Route is in a namespace the controller does not have access to.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ControllerName is a domain/path string that indicates the name of the controller that wrote this status. This corresponds with the controllerName field on GatewayClass.<br><p> <br><p> Example: "example.net/gateway-controller".<br><p> <br><p> The format of this field is DOMAIN "/" PATH, where DOMAIN and PATH are valid Kubernetes names (https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names).<br><p> <br><p> Controllers MUST populate this field when writing status. Controllers should ensure that entries to status populated with their ControllerName are cleaned up when they are no longer necessary.
+     */
     @JsonProperty("controllerName")
     public String getControllerName() {
         return controllerName;
     }
 
+    /**
+     * ControllerName is a domain/path string that indicates the name of the controller that wrote this status. This corresponds with the controllerName field on GatewayClass.<br><p> <br><p> Example: "example.net/gateway-controller".<br><p> <br><p> The format of this field is DOMAIN "/" PATH, where DOMAIN and PATH are valid Kubernetes names (https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names).<br><p> <br><p> Controllers MUST populate this field when writing status. Controllers should ensure that entries to status populated with their ControllerName are cleaned up when they are no longer necessary.
+     */
     @JsonProperty("controllerName")
     public void setControllerName(String controllerName) {
         this.controllerName = controllerName;
     }
 
+    /**
+     * RouteParentStatus describes the status of a route with respect to an associated Parent.
+     */
     @JsonProperty("parentRef")
     public ParentReference getParentRef() {
         return parentRef;
     }
 
+    /**
+     * RouteParentStatus describes the status of a route with respect to an associated Parent.
+     */
     @JsonProperty("parentRef")
     public void setParentRef(ParentReference parentRef) {
         this.parentRef = parentRef;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/RouteStatus.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/RouteStatus.java
index 5249a0e1185..6227d114c28 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/RouteStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/RouteStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RouteStatus defines the common attributes that all Routes MUST include within their status.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public RouteStatus(List<RouteParentStatus> parents) {
         this.parents = parents;
     }
 
+    /**
+     * Parents is a list of parent resources (usually Gateways) that are associated with the route, and the status of the route with respect to each parent. When this route attaches to a parent, the controller that manages the parent must add an entry to this list when the controller first sees the route and should update the entry as appropriate when the route or gateway is modified.<br><p> <br><p> Note that parent references that cannot be resolved by an implementation of this API will not be added to this list. Implementations of this API can only populate Route status for the Gateways/parent resources they are responsible for.<br><p> <br><p> A maximum of 32 Gateways will be represented in this list. An empty list means the route has not been attached to any Gateway.
+     */
     @JsonProperty("parents")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RouteParentStatus> getParents() {
         return parents;
     }
 
+    /**
+     * Parents is a list of parent resources (usually Gateways) that are associated with the route, and the status of the route with respect to each parent. When this route attaches to a parent, the controller that manages the parent must add an entry to this list when the controller first sees the route and should update the entry as appropriate when the route or gateway is modified.<br><p> <br><p> Note that parent references that cannot be resolved by an implementation of this API will not be added to this list. Implementations of this API can only populate Route status for the Gateways/parent resources they are responsible for.<br><p> <br><p> A maximum of 32 Gateways will be represented in this list. An empty list means the route has not been attached to any Gateway.
+     */
     @JsonProperty("parents")
     public void setParents(List<RouteParentStatus> parents) {
         this.parents = parents;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/SecretObjectReference.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/SecretObjectReference.java
index e88d4ff4ef1..1c9b0007e21 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/SecretObjectReference.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/SecretObjectReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SecretObjectReference identifies an API object including its namespace, defaulting to Secret.<br><p> <br><p> The API object must be valid in the cluster; the Group and Kind must be registered in the cluster for this reference to be valid.<br><p> <br><p> References to objects with invalid Group and Kind are not valid, and must be rejected by the implementation, with appropriate Conditions set on the containing object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public SecretObjectReference(String group, String kind, String name, String name
         this.namespace = namespace;
     }
 
+    /**
+     * Group is the group of the referent. For example, "gateway.networking.k8s.io". When unspecified or empty string, core API group is inferred.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * Group is the group of the referent. For example, "gateway.networking.k8s.io". When unspecified or empty string, core API group is inferred.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * Kind is kind of the referent. For example "Secret".
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is kind of the referent. For example "Secret".
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of the referent.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the referent.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace is the namespace of the referenced object. When unspecified, the local namespace is inferred.<br><p> <br><p> Note that when a namespace different than the local namespace is specified, a ReferenceGrant object is required in the referent namespace to allow that namespace's owner to accept the reference. See the ReferenceGrant documentation for details.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace of the referenced object. When unspecified, the local namespace is inferred.<br><p> <br><p> Note that when a namespace different than the local namespace is specified, a ReferenceGrant object is required in the referent namespace to allow that namespace's owner to accept the reference. See the ReferenceGrant documentation for details.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/SessionPersistence.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/SessionPersistence.java
index e84e2b7eb3a..2525dfef359 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/SessionPersistence.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1/SessionPersistence.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SessionPersistence defines the desired state of SessionPersistence.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public SessionPersistence(String absoluteTimeout, CookieConfig cookieConfig, Str
         this.type = type;
     }
 
+    /**
+     * AbsoluteTimeout defines the absolute timeout of the persistent session. Once the AbsoluteTimeout duration has elapsed, the session becomes invalid.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("absoluteTimeout")
     public String getAbsoluteTimeout() {
         return absoluteTimeout;
     }
 
+    /**
+     * AbsoluteTimeout defines the absolute timeout of the persistent session. Once the AbsoluteTimeout duration has elapsed, the session becomes invalid.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("absoluteTimeout")
     public void setAbsoluteTimeout(String absoluteTimeout) {
         this.absoluteTimeout = absoluteTimeout;
     }
 
+    /**
+     * SessionPersistence defines the desired state of SessionPersistence.
+     */
     @JsonProperty("cookieConfig")
     public CookieConfig getCookieConfig() {
         return cookieConfig;
     }
 
+    /**
+     * SessionPersistence defines the desired state of SessionPersistence.
+     */
     @JsonProperty("cookieConfig")
     public void setCookieConfig(CookieConfig cookieConfig) {
         this.cookieConfig = cookieConfig;
     }
 
+    /**
+     * IdleTimeout defines the idle timeout of the persistent session. Once the session has been idle for more than the specified IdleTimeout duration, the session becomes invalid.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("idleTimeout")
     public String getIdleTimeout() {
         return idleTimeout;
     }
 
+    /**
+     * IdleTimeout defines the idle timeout of the persistent session. Once the session has been idle for more than the specified IdleTimeout duration, the session becomes invalid.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("idleTimeout")
     public void setIdleTimeout(String idleTimeout) {
         this.idleTimeout = idleTimeout;
     }
 
+    /**
+     * SessionName defines the name of the persistent session token which may be reflected in the cookie or the header. Users should avoid reusing session names to prevent unintended consequences, such as rejection or unpredictable behavior.<br><p> <br><p> Support: Implementation-specific
+     */
     @JsonProperty("sessionName")
     public String getSessionName() {
         return sessionName;
     }
 
+    /**
+     * SessionName defines the name of the persistent session token which may be reflected in the cookie or the header. Users should avoid reusing session names to prevent unintended consequences, such as rejection or unpredictable behavior.<br><p> <br><p> Support: Implementation-specific
+     */
     @JsonProperty("sessionName")
     public void setSessionName(String sessionName) {
         this.sessionName = sessionName;
     }
 
+    /**
+     * Type defines the type of session persistence such as through the use a header or cookie. Defaults to cookie based session persistence.<br><p> <br><p> Support: Core for "Cookie" type<br><p> <br><p> Support: Extended for "Header" type
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type defines the type of session persistence such as through the use a header or cookie. Defaults to cookie based session persistence.<br><p> <br><p> Support: Core for "Cookie" type<br><p> <br><p> Support: Extended for "Header" type
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/BackendLBPolicy.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/BackendLBPolicy.java
index 4dc97e38e90..1ef16158270 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/BackendLBPolicy.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/BackendLBPolicy.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BackendLBPolicy provides a way to define load balancing rules for a backend.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class BackendLBPolicy implements Editable<BackendLBPolicyBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1alpha2";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "BackendLBPolicy";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public BackendLBPolicy(String apiVersion, String kind, ObjectMeta metadata, Back
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * BackendLBPolicy provides a way to define load balancing rules for a backend.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * BackendLBPolicy provides a way to define load balancing rules for a backend.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * BackendLBPolicy provides a way to define load balancing rules for a backend.
+     */
     @JsonProperty("spec")
     public BackendLBPolicySpec getSpec() {
         return spec;
     }
 
+    /**
+     * BackendLBPolicy provides a way to define load balancing rules for a backend.
+     */
     @JsonProperty("spec")
     public void setSpec(BackendLBPolicySpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * BackendLBPolicy provides a way to define load balancing rules for a backend.
+     */
     @JsonProperty("status")
     public PolicyStatus getStatus() {
         return status;
     }
 
+    /**
+     * BackendLBPolicy provides a way to define load balancing rules for a backend.
+     */
     @JsonProperty("status")
     public void setStatus(PolicyStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/BackendLBPolicyList.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/BackendLBPolicyList.java
index 69580f190c5..569840d1a8f 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/BackendLBPolicyList.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/BackendLBPolicyList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BackendLBPolicyList contains a list of BackendLBPolicies
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class BackendLBPolicyList implements Editable<BackendLBPolicyListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.gatewayapi.v1alpha2.BackendLBPolicy>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1alpha2";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.gatewayapi.v1alpha2.BackendLBPolicy> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "BackendLBPolicyList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public BackendLBPolicyList(String apiVersion, List<io.fabric8.kubernetes.api.mod
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * BackendLBPolicyList contains a list of BackendLBPolicies
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.gatewayapi.v1alpha2.BackendLBPolicy> getItems() {
         return items;
     }
 
+    /**
+     * BackendLBPolicyList contains a list of BackendLBPolicies
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.gatewayapi.v1alpha2.BackendLBPolicy> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * BackendLBPolicyList contains a list of BackendLBPolicies
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * BackendLBPolicyList contains a list of BackendLBPolicies
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/BackendLBPolicySpec.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/BackendLBPolicySpec.java
index 23175b70f8a..144840177ec 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/BackendLBPolicySpec.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/BackendLBPolicySpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BackendLBPolicySpec defines the desired state of BackendLBPolicy. Note: there is no Override or Default policy configuration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,22 +89,34 @@ public BackendLBPolicySpec(SessionPersistence sessionPersistence, List<LocalPoli
         this.targetRefs = targetRefs;
     }
 
+    /**
+     * BackendLBPolicySpec defines the desired state of BackendLBPolicy. Note: there is no Override or Default policy configuration.
+     */
     @JsonProperty("sessionPersistence")
     public SessionPersistence getSessionPersistence() {
         return sessionPersistence;
     }
 
+    /**
+     * BackendLBPolicySpec defines the desired state of BackendLBPolicy. Note: there is no Override or Default policy configuration.
+     */
     @JsonProperty("sessionPersistence")
     public void setSessionPersistence(SessionPersistence sessionPersistence) {
         this.sessionPersistence = sessionPersistence;
     }
 
+    /**
+     * TargetRef identifies an API object to apply policy to. Currently, Backends (i.e. Service, ServiceImport, or any implementation-specific backendRef) are the only valid API target references.
+     */
     @JsonProperty("targetRefs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LocalPolicyTargetReference> getTargetRefs() {
         return targetRefs;
     }
 
+    /**
+     * TargetRef identifies an API object to apply policy to. Currently, Backends (i.e. Service, ServiceImport, or any implementation-specific backendRef) are the only valid API target references.
+     */
     @JsonProperty("targetRefs")
     public void setTargetRefs(List<LocalPolicyTargetReference> targetRefs) {
         this.targetRefs = targetRefs;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/GRPCRoute.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/GRPCRoute.java
index 69c2538a3c4..4b7f99ac1e0 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/GRPCRoute.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/GRPCRoute.java
@@ -78,14 +78,8 @@
 public class GRPCRoute implements Editable<GRPCRouteBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1alpha2";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GRPCRoute";
     @JsonProperty("metadata")
@@ -113,7 +107,7 @@ public GRPCRoute(String apiVersion, String kind, ObjectMeta metadata, GRPCRouteS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -121,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -129,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -137,7 +131,7 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/GRPCRouteList.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/GRPCRouteList.java
index 72182c74b2c..170bbedc1f4 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/GRPCRouteList.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/GRPCRouteList.java
@@ -78,17 +78,11 @@
 public class GRPCRouteList implements Editable<GRPCRouteListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.gatewayapi.v1alpha2.GRPCRoute>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1alpha2";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.gatewayapi.v1alpha2.GRPCRoute> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GRPCRouteList";
     @JsonProperty("metadata")
@@ -111,7 +105,7 @@ public GRPCRouteList(String apiVersion, List<io.fabric8.kubernetes.api.model.gat
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +113,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -138,7 +132,7 @@ public void setItems(List<io.fabric8.kubernetes.api.model.gatewayapi.v1alpha2.GR
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,7 +140,7 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/LocalPolicyTargetReference.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/LocalPolicyTargetReference.java
index a2034f32ce4..55aec2dcb7f 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/LocalPolicyTargetReference.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/LocalPolicyTargetReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LocalPolicyTargetReference identifies an API object to apply a direct or inherited policy to. This should be used as part of Policy resources that can target Gateway API resources. For more information on how this policy attachment model works, and a sample Policy resource, refer to the policy attachment documentation for Gateway API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public LocalPolicyTargetReference(String group, String kind, String name) {
         this.name = name;
     }
 
+    /**
+     * Group is the group of the target resource.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * Group is the group of the target resource.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * Kind is kind of the target resource.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is kind of the target resource.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of the target resource.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the target resource.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/LocalPolicyTargetReferenceWithSectionName.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/LocalPolicyTargetReferenceWithSectionName.java
index 81b1c38f091..4579b7d9a8f 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/LocalPolicyTargetReferenceWithSectionName.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/LocalPolicyTargetReferenceWithSectionName.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LocalPolicyTargetReferenceWithSectionName identifies an API object to apply a direct policy to. This should be used as part of Policy resources that can target single resources. For more information on how this policy attachment mode works, and a sample Policy resource, refer to the policy attachment documentation for Gateway API.<br><p> <br><p> Note: This should only be used for direct policy attachment when references to SectionName are actually needed. In all other cases, LocalPolicyTargetReference should be used.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public LocalPolicyTargetReferenceWithSectionName(String group, String kind, Stri
         this.sectionName = sectionName;
     }
 
+    /**
+     * Group is the group of the target resource.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * Group is the group of the target resource.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * Kind is kind of the target resource.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is kind of the target resource.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of the target resource.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the target resource.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * SectionName is the name of a section within the target resource. When unspecified, this targetRef targets the entire resource. In the following resources, SectionName is interpreted as the following:<br><p> <br><p> &#42; Gateway: Listener name &#42; HTTPRoute: HTTPRouteRule name &#42; Service: Port name<br><p> <br><p> If a SectionName is specified, but does not exist on the targeted object, the Policy must fail to attach, and the policy implementation should record a `ResolvedRefs` or similar Condition in the Policy's status.
+     */
     @JsonProperty("sectionName")
     public String getSectionName() {
         return sectionName;
     }
 
+    /**
+     * SectionName is the name of a section within the target resource. When unspecified, this targetRef targets the entire resource. In the following resources, SectionName is interpreted as the following:<br><p> <br><p> &#42; Gateway: Listener name &#42; HTTPRoute: HTTPRouteRule name &#42; Service: Port name<br><p> <br><p> If a SectionName is specified, but does not exist on the targeted object, the Policy must fail to attach, and the policy implementation should record a `ResolvedRefs` or similar Condition in the Policy's status.
+     */
     @JsonProperty("sectionName")
     public void setSectionName(String sectionName) {
         this.sectionName = sectionName;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/NamespacedPolicyTargetReference.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/NamespacedPolicyTargetReference.java
index c3339b58579..c3938a214d0 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/NamespacedPolicyTargetReference.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/NamespacedPolicyTargetReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NamespacedPolicyTargetReference identifies an API object to apply a direct or inherited policy to, potentially in a different namespace. This should only be used as part of Policy resources that need to be able to target resources in different namespaces. For more information on how this policy attachment model works, and a sample Policy resource, refer to the policy attachment documentation for Gateway API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public NamespacedPolicyTargetReference(String group, String kind, String name, S
         this.namespace = namespace;
     }
 
+    /**
+     * Group is the group of the target resource.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * Group is the group of the target resource.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * Kind is kind of the target resource.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is kind of the target resource.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of the target resource.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the target resource.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace is the namespace of the referent. When unspecified, the local namespace is inferred. Even when policy targets a resource in a different namespace, it MUST only apply to traffic originating from the same namespace as the policy.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace of the referent. When unspecified, the local namespace is inferred. Even when policy targets a resource in a different namespace, it MUST only apply to traffic originating from the same namespace as the policy.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/PolicyAncestorStatus.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/PolicyAncestorStatus.java
index 637a414e39f..b985dec8491 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/PolicyAncestorStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/PolicyAncestorStatus.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PolicyAncestorStatus describes the status of a route with respect to an associated Ancestor.<br><p> <br><p> Ancestors refer to objects that are either the Target of a policy or above it in terms of object hierarchy. For example, if a policy targets a Service, the Policy's Ancestors are, in order, the Service, the HTTPRoute, the Gateway, and the GatewayClass. Almost always, in this hierarchy, the Gateway will be the most useful object to place Policy status on, so we recommend that implementations SHOULD use Gateway as the PolicyAncestorStatus object unless the designers have a _very_ good reason otherwise.<br><p> <br><p> In the context of policy attachment, the Ancestor is used to distinguish which resource results in a distinct application of this policy. For example, if a policy targets a Service, it may have a distinct result per attached Gateway.<br><p> <br><p> Policies targeting the same resource may have different effects depending on the ancestors of those resources. For example, different Gateways targeting the same Service may have different capabilities, especially if they have different underlying implementations.<br><p> <br><p> For example, in BackendTLSPolicy, the Policy attaches to a Service that is used as a backend in a HTTPRoute that is itself attached to a Gateway. In this case, the relevant object for status is the Gateway, and that is the ancestor object referred to in this status.<br><p> <br><p> Note that a parent is also an ancestor, so for objects where the parent is the relevant object for status, this struct SHOULD still be used.<br><p> <br><p> This struct is intended to be used in a slice that's effectively a map, with a composite key made up of the AncestorRef and the ControllerName.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,32 +94,50 @@ public PolicyAncestorStatus(ParentReference ancestorRef, List<Condition> conditi
         this.controllerName = controllerName;
     }
 
+    /**
+     * PolicyAncestorStatus describes the status of a route with respect to an associated Ancestor.<br><p> <br><p> Ancestors refer to objects that are either the Target of a policy or above it in terms of object hierarchy. For example, if a policy targets a Service, the Policy's Ancestors are, in order, the Service, the HTTPRoute, the Gateway, and the GatewayClass. Almost always, in this hierarchy, the Gateway will be the most useful object to place Policy status on, so we recommend that implementations SHOULD use Gateway as the PolicyAncestorStatus object unless the designers have a _very_ good reason otherwise.<br><p> <br><p> In the context of policy attachment, the Ancestor is used to distinguish which resource results in a distinct application of this policy. For example, if a policy targets a Service, it may have a distinct result per attached Gateway.<br><p> <br><p> Policies targeting the same resource may have different effects depending on the ancestors of those resources. For example, different Gateways targeting the same Service may have different capabilities, especially if they have different underlying implementations.<br><p> <br><p> For example, in BackendTLSPolicy, the Policy attaches to a Service that is used as a backend in a HTTPRoute that is itself attached to a Gateway. In this case, the relevant object for status is the Gateway, and that is the ancestor object referred to in this status.<br><p> <br><p> Note that a parent is also an ancestor, so for objects where the parent is the relevant object for status, this struct SHOULD still be used.<br><p> <br><p> This struct is intended to be used in a slice that's effectively a map, with a composite key made up of the AncestorRef and the ControllerName.
+     */
     @JsonProperty("ancestorRef")
     public ParentReference getAncestorRef() {
         return ancestorRef;
     }
 
+    /**
+     * PolicyAncestorStatus describes the status of a route with respect to an associated Ancestor.<br><p> <br><p> Ancestors refer to objects that are either the Target of a policy or above it in terms of object hierarchy. For example, if a policy targets a Service, the Policy's Ancestors are, in order, the Service, the HTTPRoute, the Gateway, and the GatewayClass. Almost always, in this hierarchy, the Gateway will be the most useful object to place Policy status on, so we recommend that implementations SHOULD use Gateway as the PolicyAncestorStatus object unless the designers have a _very_ good reason otherwise.<br><p> <br><p> In the context of policy attachment, the Ancestor is used to distinguish which resource results in a distinct application of this policy. For example, if a policy targets a Service, it may have a distinct result per attached Gateway.<br><p> <br><p> Policies targeting the same resource may have different effects depending on the ancestors of those resources. For example, different Gateways targeting the same Service may have different capabilities, especially if they have different underlying implementations.<br><p> <br><p> For example, in BackendTLSPolicy, the Policy attaches to a Service that is used as a backend in a HTTPRoute that is itself attached to a Gateway. In this case, the relevant object for status is the Gateway, and that is the ancestor object referred to in this status.<br><p> <br><p> Note that a parent is also an ancestor, so for objects where the parent is the relevant object for status, this struct SHOULD still be used.<br><p> <br><p> This struct is intended to be used in a slice that's effectively a map, with a composite key made up of the AncestorRef and the ControllerName.
+     */
     @JsonProperty("ancestorRef")
     public void setAncestorRef(ParentReference ancestorRef) {
         this.ancestorRef = ancestorRef;
     }
 
+    /**
+     * Conditions describes the status of the Policy with respect to the given Ancestor.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions describes the status of the Policy with respect to the given Ancestor.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ControllerName is a domain/path string that indicates the name of the controller that wrote this status. This corresponds with the controllerName field on GatewayClass.<br><p> <br><p> Example: "example.net/gateway-controller".<br><p> <br><p> The format of this field is DOMAIN "/" PATH, where DOMAIN and PATH are valid Kubernetes names (https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names).<br><p> <br><p> Controllers MUST populate this field when writing status. Controllers should ensure that entries to status populated with their ControllerName are cleaned up when they are no longer necessary.
+     */
     @JsonProperty("controllerName")
     public String getControllerName() {
         return controllerName;
     }
 
+    /**
+     * ControllerName is a domain/path string that indicates the name of the controller that wrote this status. This corresponds with the controllerName field on GatewayClass.<br><p> <br><p> Example: "example.net/gateway-controller".<br><p> <br><p> The format of this field is DOMAIN "/" PATH, where DOMAIN and PATH are valid Kubernetes names (https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names).<br><p> <br><p> Controllers MUST populate this field when writing status. Controllers should ensure that entries to status populated with their ControllerName are cleaned up when they are no longer necessary.
+     */
     @JsonProperty("controllerName")
     public void setControllerName(String controllerName) {
         this.controllerName = controllerName;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/PolicyStatus.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/PolicyStatus.java
index 5a6e30f2704..1bc87bdbae0 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/PolicyStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/PolicyStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PolicyStatus defines the common attributes that all Policies should include within their status.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public PolicyStatus(List<PolicyAncestorStatus> ancestors) {
         this.ancestors = ancestors;
     }
 
+    /**
+     * Ancestors is a list of ancestor resources (usually Gateways) that are associated with the policy, and the status of the policy with respect to each ancestor. When this policy attaches to a parent, the controller that manages the parent and the ancestors MUST add an entry to this list when the controller first sees the policy and SHOULD update the entry as appropriate when the relevant ancestor is modified.<br><p> <br><p> Note that choosing the relevant ancestor is left to the Policy designers; an important part of Policy design is designing the right object level at which to namespace this status.<br><p> <br><p> Note also that implementations MUST ONLY populate ancestor status for the Ancestor resources they are responsible for. Implementations MUST use the ControllerName field to uniquely identify the entries in this list that they are responsible for.<br><p> <br><p> Note that to achieve this, the list of PolicyAncestorStatus structs MUST be treated as a map with a composite key, made up of the AncestorRef and ControllerName fields combined.<br><p> <br><p> A maximum of 16 ancestors will be represented in this list. An empty list means the Policy is not relevant for any ancestors.<br><p> <br><p> If this slice is full, implementations MUST NOT add further entries. Instead they MUST consider the policy unimplementable and signal that on any related resources such as the ancestor that would be referenced here. For example, if this list was full on BackendTLSPolicy, no additional Gateways would be able to reference the Service targeted by the BackendTLSPolicy.
+     */
     @JsonProperty("ancestors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PolicyAncestorStatus> getAncestors() {
         return ancestors;
     }
 
+    /**
+     * Ancestors is a list of ancestor resources (usually Gateways) that are associated with the policy, and the status of the policy with respect to each ancestor. When this policy attaches to a parent, the controller that manages the parent and the ancestors MUST add an entry to this list when the controller first sees the policy and SHOULD update the entry as appropriate when the relevant ancestor is modified.<br><p> <br><p> Note that choosing the relevant ancestor is left to the Policy designers; an important part of Policy design is designing the right object level at which to namespace this status.<br><p> <br><p> Note also that implementations MUST ONLY populate ancestor status for the Ancestor resources they are responsible for. Implementations MUST use the ControllerName field to uniquely identify the entries in this list that they are responsible for.<br><p> <br><p> Note that to achieve this, the list of PolicyAncestorStatus structs MUST be treated as a map with a composite key, made up of the AncestorRef and ControllerName fields combined.<br><p> <br><p> A maximum of 16 ancestors will be represented in this list. An empty list means the Policy is not relevant for any ancestors.<br><p> <br><p> If this slice is full, implementations MUST NOT add further entries. Instead they MUST consider the policy unimplementable and signal that on any related resources such as the ancestor that would be referenced here. For example, if this list was full on BackendTLSPolicy, no additional Gateways would be able to reference the Service targeted by the BackendTLSPolicy.
+     */
     @JsonProperty("ancestors")
     public void setAncestors(List<PolicyAncestorStatus> ancestors) {
         this.ancestors = ancestors;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/ReferenceGrant.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/ReferenceGrant.java
index 2732d17939a..49de84466c0 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/ReferenceGrant.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/ReferenceGrant.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ReferenceGrant identifies kinds of resources in other namespaces that are trusted to reference the specified kinds of resources in the same namespace as the policy.<br><p> <br><p> Each ReferenceGrant can be used to represent a unique trust relationship. Additional Reference Grants can be used to add to the set of trusted sources of inbound references for the namespace they are defined within.<br><p> <br><p> A ReferenceGrant is required for all cross-namespace references in Gateway API (with the exception of cross-namespace Route-Gateway attachment, which is governed by the AllowedRoutes configuration on the Gateway, and cross-namespace Service ParentRefs on a "consumer" mesh Route, which defines routing rules applicable only to workloads in the Route namespace). ReferenceGrants allowing a reference from a Route to a Service are only applicable to BackendRefs.<br><p> <br><p> ReferenceGrant is a form of runtime verification allowing users to assert which cross-namespace object references are permitted. Implementations that support ReferenceGrant MUST NOT permit cross-namespace references which have no grant, and MUST respond to the removal of a grant by revoking the access that the grant allowed.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class ReferenceGrant implements Editable<ReferenceGrantBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1alpha2";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ReferenceGrant";
     @JsonProperty("metadata")
@@ -108,7 +105,7 @@ public ReferenceGrant(String apiVersion, String kind, ObjectMeta metadata, Refer
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -116,7 +113,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -124,7 +121,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -132,28 +129,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ReferenceGrant identifies kinds of resources in other namespaces that are trusted to reference the specified kinds of resources in the same namespace as the policy.<br><p> <br><p> Each ReferenceGrant can be used to represent a unique trust relationship. Additional Reference Grants can be used to add to the set of trusted sources of inbound references for the namespace they are defined within.<br><p> <br><p> A ReferenceGrant is required for all cross-namespace references in Gateway API (with the exception of cross-namespace Route-Gateway attachment, which is governed by the AllowedRoutes configuration on the Gateway, and cross-namespace Service ParentRefs on a "consumer" mesh Route, which defines routing rules applicable only to workloads in the Route namespace). ReferenceGrants allowing a reference from a Route to a Service are only applicable to BackendRefs.<br><p> <br><p> ReferenceGrant is a form of runtime verification allowing users to assert which cross-namespace object references are permitted. Implementations that support ReferenceGrant MUST NOT permit cross-namespace references which have no grant, and MUST respond to the removal of a grant by revoking the access that the grant allowed.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ReferenceGrant identifies kinds of resources in other namespaces that are trusted to reference the specified kinds of resources in the same namespace as the policy.<br><p> <br><p> Each ReferenceGrant can be used to represent a unique trust relationship. Additional Reference Grants can be used to add to the set of trusted sources of inbound references for the namespace they are defined within.<br><p> <br><p> A ReferenceGrant is required for all cross-namespace references in Gateway API (with the exception of cross-namespace Route-Gateway attachment, which is governed by the AllowedRoutes configuration on the Gateway, and cross-namespace Service ParentRefs on a "consumer" mesh Route, which defines routing rules applicable only to workloads in the Route namespace). ReferenceGrants allowing a reference from a Route to a Service are only applicable to BackendRefs.<br><p> <br><p> ReferenceGrant is a form of runtime verification allowing users to assert which cross-namespace object references are permitted. Implementations that support ReferenceGrant MUST NOT permit cross-namespace references which have no grant, and MUST respond to the removal of a grant by revoking the access that the grant allowed.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ReferenceGrant identifies kinds of resources in other namespaces that are trusted to reference the specified kinds of resources in the same namespace as the policy.<br><p> <br><p> Each ReferenceGrant can be used to represent a unique trust relationship. Additional Reference Grants can be used to add to the set of trusted sources of inbound references for the namespace they are defined within.<br><p> <br><p> A ReferenceGrant is required for all cross-namespace references in Gateway API (with the exception of cross-namespace Route-Gateway attachment, which is governed by the AllowedRoutes configuration on the Gateway, and cross-namespace Service ParentRefs on a "consumer" mesh Route, which defines routing rules applicable only to workloads in the Route namespace). ReferenceGrants allowing a reference from a Route to a Service are only applicable to BackendRefs.<br><p> <br><p> ReferenceGrant is a form of runtime verification allowing users to assert which cross-namespace object references are permitted. Implementations that support ReferenceGrant MUST NOT permit cross-namespace references which have no grant, and MUST respond to the removal of a grant by revoking the access that the grant allowed.
+     */
     @JsonProperty("spec")
     public ReferenceGrantSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ReferenceGrant identifies kinds of resources in other namespaces that are trusted to reference the specified kinds of resources in the same namespace as the policy.<br><p> <br><p> Each ReferenceGrant can be used to represent a unique trust relationship. Additional Reference Grants can be used to add to the set of trusted sources of inbound references for the namespace they are defined within.<br><p> <br><p> A ReferenceGrant is required for all cross-namespace references in Gateway API (with the exception of cross-namespace Route-Gateway attachment, which is governed by the AllowedRoutes configuration on the Gateway, and cross-namespace Service ParentRefs on a "consumer" mesh Route, which defines routing rules applicable only to workloads in the Route namespace). ReferenceGrants allowing a reference from a Route to a Service are only applicable to BackendRefs.<br><p> <br><p> ReferenceGrant is a form of runtime verification allowing users to assert which cross-namespace object references are permitted. Implementations that support ReferenceGrant MUST NOT permit cross-namespace references which have no grant, and MUST respond to the removal of a grant by revoking the access that the grant allowed.
+     */
     @JsonProperty("spec")
     public void setSpec(ReferenceGrantSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/ReferenceGrantList.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/ReferenceGrantList.java
index f4984c5cd8f..98e8cf003a9 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/ReferenceGrantList.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/ReferenceGrantList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ReferenceGrantList contains a list of ReferenceGrant.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ReferenceGrantList implements Editable<ReferenceGrantListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.gatewayapi.v1alpha2.ReferenceGrant>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1alpha2";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.gatewayapi.v1alpha2.ReferenceGrant> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ReferenceGrantList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ReferenceGrantList(String apiVersion, List<io.fabric8.kubernetes.api.mode
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ReferenceGrantList contains a list of ReferenceGrant.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.gatewayapi.v1alpha2.ReferenceGrant> getItems() {
         return items;
     }
 
+    /**
+     * ReferenceGrantList contains a list of ReferenceGrant.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.gatewayapi.v1alpha2.ReferenceGrant> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ReferenceGrantList contains a list of ReferenceGrant.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ReferenceGrantList contains a list of ReferenceGrant.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TCPRoute.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TCPRoute.java
index 33d0b442e3b..40ddba8a00a 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TCPRoute.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TCPRoute.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TCPRoute provides a way to route TCP requests. When combined with a Gateway listener, it can be used to forward connections on the port specified by the listener to a set of backends specified by the TCPRoute.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class TCPRoute implements Editable<TCPRouteBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1alpha2";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TCPRoute";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TCPRoute(String apiVersion, String kind, ObjectMeta metadata, TCPRouteSpe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TCPRoute provides a way to route TCP requests. When combined with a Gateway listener, it can be used to forward connections on the port specified by the listener to a set of backends specified by the TCPRoute.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TCPRoute provides a way to route TCP requests. When combined with a Gateway listener, it can be used to forward connections on the port specified by the listener to a set of backends specified by the TCPRoute.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * TCPRoute provides a way to route TCP requests. When combined with a Gateway listener, it can be used to forward connections on the port specified by the listener to a set of backends specified by the TCPRoute.
+     */
     @JsonProperty("spec")
     public TCPRouteSpec getSpec() {
         return spec;
     }
 
+    /**
+     * TCPRoute provides a way to route TCP requests. When combined with a Gateway listener, it can be used to forward connections on the port specified by the listener to a set of backends specified by the TCPRoute.
+     */
     @JsonProperty("spec")
     public void setSpec(TCPRouteSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * TCPRoute provides a way to route TCP requests. When combined with a Gateway listener, it can be used to forward connections on the port specified by the listener to a set of backends specified by the TCPRoute.
+     */
     @JsonProperty("status")
     public TCPRouteStatus getStatus() {
         return status;
     }
 
+    /**
+     * TCPRoute provides a way to route TCP requests. When combined with a Gateway listener, it can be used to forward connections on the port specified by the listener to a set of backends specified by the TCPRoute.
+     */
     @JsonProperty("status")
     public void setStatus(TCPRouteStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TCPRouteList.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TCPRouteList.java
index 0f3fb5041bb..260516e080a 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TCPRouteList.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TCPRouteList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TCPRouteList contains a list of TCPRoute
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class TCPRouteList implements Editable<TCPRouteListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.gatewayapi.v1alpha2.TCPRoute>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1alpha2";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.gatewayapi.v1alpha2.TCPRoute> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TCPRouteList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TCPRouteList(String apiVersion, List<io.fabric8.kubernetes.api.model.gate
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * TCPRouteList contains a list of TCPRoute
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.gatewayapi.v1alpha2.TCPRoute> getItems() {
         return items;
     }
 
+    /**
+     * TCPRouteList contains a list of TCPRoute
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.gatewayapi.v1alpha2.TCPRoute> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TCPRouteList contains a list of TCPRoute
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TCPRouteList contains a list of TCPRoute
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TCPRouteRule.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TCPRouteRule.java
index cd51954af35..7b32f65a04f 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TCPRouteRule.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TCPRouteRule.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TCPRouteRule is the configuration for a given rule.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,22 +89,34 @@ public TCPRouteRule(List<BackendRef> backendRefs, String name) {
         this.name = name;
     }
 
+    /**
+     * BackendRefs defines the backend(s) where matching requests should be sent. If unspecified or invalid (refers to a non-existent resource or a Service with no endpoints), the underlying implementation MUST actively reject connection attempts to this backend. Connection rejections must respect weight; if an invalid backend is requested to have 80% of connections, then 80% of connections must be rejected instead.<br><p> <br><p> Support: Core for Kubernetes Service<br><p> <br><p> Support: Extended for Kubernetes ServiceImport<br><p> <br><p> Support: Implementation-specific for any other resource<br><p> <br><p> Support for weight: Extended
+     */
     @JsonProperty("backendRefs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<BackendRef> getBackendRefs() {
         return backendRefs;
     }
 
+    /**
+     * BackendRefs defines the backend(s) where matching requests should be sent. If unspecified or invalid (refers to a non-existent resource or a Service with no endpoints), the underlying implementation MUST actively reject connection attempts to this backend. Connection rejections must respect weight; if an invalid backend is requested to have 80% of connections, then 80% of connections must be rejected instead.<br><p> <br><p> Support: Core for Kubernetes Service<br><p> <br><p> Support: Extended for Kubernetes ServiceImport<br><p> <br><p> Support: Implementation-specific for any other resource<br><p> <br><p> Support for weight: Extended
+     */
     @JsonProperty("backendRefs")
     public void setBackendRefs(List<BackendRef> backendRefs) {
         this.backendRefs = backendRefs;
     }
 
+    /**
+     * Name is the name of the route rule. This name MUST be unique within a Route if it is set.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the route rule. This name MUST be unique within a Route if it is set.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TCPRouteSpec.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TCPRouteSpec.java
index ba792e09278..487c9e9d8cc 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TCPRouteSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TCPRouteSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TCPRouteSpec defines the desired state of TCPRoute
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,23 +90,35 @@ public TCPRouteSpec(List<ParentReference> parentRefs, List<TCPRouteRule> rules)
         this.rules = rules;
     }
 
+    /**
+     * ParentRefs references the resources (usually Gateways) that a Route wants to be attached to. Note that the referenced parent resource needs to allow this for the attachment to be complete. For Gateways, that means the Gateway needs to allow attachment from Routes of this kind and namespace. For Services, that means the Service must either be in the same namespace for a "producer" route, or the mesh implementation must support and allow "consumer" routes for the referenced Service. ReferenceGrant is not applicable for governing ParentRefs to Services - it is not possible to create a "producer" route for a Service in a different namespace from the Route.<br><p> <br><p> There are two kinds of parent resources with "Core" support:<br><p> <br><p> &#42; Gateway (Gateway conformance profile) &#42; Service (Mesh conformance profile, ClusterIP Services only)<br><p> <br><p> This API may be extended in the future to support additional kinds of parent resources.<br><p> <br><p> ParentRefs must be _distinct_. This means either that:<br><p> <br><p> &#42; They select different objects.  If this is the case, then parentRef<br><p>   entries are distinct. In terms of fields, this means that the<br><p>   multi-part key defined by `group`, `kind`, `namespace`, and `name` must<br><p>   be unique across all parentRef entries in the Route.<br><p> &#42; They do not select different objects, but for each optional field used,<br><p>   each ParentRef that selects the same object must set the same set of<br><p>   optional fields to different values. If one ParentRef sets a<br><p>   combination of optional fields, all must set the same combination.<br><p> <br><p> Some examples:<br><p> <br><p> &#42; If one ParentRef sets `sectionName`, all ParentRefs referencing the<br><p>   same object must also set `sectionName`.<br><p> &#42; If one ParentRef sets `port`, all ParentRefs referencing the same<br><p>   object must also set `port`.<br><p> &#42; If one ParentRef sets `sectionName` and `port`, all ParentRefs<br><p>   referencing the same object must also set `sectionName` and `port`.<br><p> <br><p> It is possible to separately reference multiple distinct objects that may be collapsed by an implementation. For example, some implementations may choose to merge compatible Gateway Listeners together. If that is the case, the list of routes attached to those resources should also be merged.<br><p> <br><p> Note that for ParentRefs that cross namespace boundaries, there are specific rules. Cross-namespace references are only valid if they are explicitly allowed by something in the namespace they are referring to. For example, Gateway has the AllowedRoutes field, and ReferenceGrant provides a generic way to enable other kinds of cross-namespace reference.<br><p> <br><p> &lt;gateway:experimental:description&gt; ParentRefs from a Route to a Service in the same namespace are "producer" routes, which apply default routing rules to inbound connections from any namespace to the Service.<br><p> <br><p> ParentRefs from a Route to a Service in a different namespace are "consumer" routes, and these routing rules are only applied to outbound connections originating from the same namespace as the Route, for which the intended destination of the connections are a Service targeted as a ParentRef of the Route. &lt;/gateway:experimental:description&gt;<br><p> <br><p> &lt;gateway:standard:validation:XValidation:message="sectionName must be specified when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.all(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) ? ((!has(p1.sectionName) || p1.sectionName == '') == (!has(p2.sectionName) || p2.sectionName == '')) : true))"&gt; &lt;gateway:standard:validation:XValidation:message="sectionName must be unique when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.exists_one(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) &amp;&amp; (((!has(p1.sectionName) || p1.sectionName == '') &amp;&amp; (!has(p2.sectionName) || p2.sectionName == '')) || (has(p1.sectionName) &amp;&amp; has(p2.sectionName) &amp;&amp; p1.sectionName == p2.sectionName))))"&gt; &lt;gateway:experimental:validation:XValidation:message="sectionName or port must be specified when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.all(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__)) ? ((!has(p1.sectionName) || p1.sectionName == '') == (!has(p2.sectionName) || p2.sectionName == '') &amp;&amp; (!has(p1.port) || p1.port == 0) == (!has(p2.port) || p2.port == 0)): true))"&gt; &lt;gateway:experimental:validation:XValidation:message="sectionName or port must be unique when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.exists_one(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) &amp;&amp; (((!has(p1.sectionName) || p1.sectionName == '') &amp;&amp; (!has(p2.sectionName) || p2.sectionName == '')) || ( has(p1.sectionName) &amp;&amp; has(p2.sectionName) &amp;&amp; p1.sectionName == p2.sectionName)) &amp;&amp; (((!has(p1.port) || p1.port == 0) &amp;&amp; (!has(p2.port) || p2.port == 0)) || (has(p1.port) &amp;&amp; has(p2.port) &amp;&amp; p1.port == p2.port))))"&gt;
+     */
     @JsonProperty("parentRefs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ParentReference> getParentRefs() {
         return parentRefs;
     }
 
+    /**
+     * ParentRefs references the resources (usually Gateways) that a Route wants to be attached to. Note that the referenced parent resource needs to allow this for the attachment to be complete. For Gateways, that means the Gateway needs to allow attachment from Routes of this kind and namespace. For Services, that means the Service must either be in the same namespace for a "producer" route, or the mesh implementation must support and allow "consumer" routes for the referenced Service. ReferenceGrant is not applicable for governing ParentRefs to Services - it is not possible to create a "producer" route for a Service in a different namespace from the Route.<br><p> <br><p> There are two kinds of parent resources with "Core" support:<br><p> <br><p> &#42; Gateway (Gateway conformance profile) &#42; Service (Mesh conformance profile, ClusterIP Services only)<br><p> <br><p> This API may be extended in the future to support additional kinds of parent resources.<br><p> <br><p> ParentRefs must be _distinct_. This means either that:<br><p> <br><p> &#42; They select different objects.  If this is the case, then parentRef<br><p>   entries are distinct. In terms of fields, this means that the<br><p>   multi-part key defined by `group`, `kind`, `namespace`, and `name` must<br><p>   be unique across all parentRef entries in the Route.<br><p> &#42; They do not select different objects, but for each optional field used,<br><p>   each ParentRef that selects the same object must set the same set of<br><p>   optional fields to different values. If one ParentRef sets a<br><p>   combination of optional fields, all must set the same combination.<br><p> <br><p> Some examples:<br><p> <br><p> &#42; If one ParentRef sets `sectionName`, all ParentRefs referencing the<br><p>   same object must also set `sectionName`.<br><p> &#42; If one ParentRef sets `port`, all ParentRefs referencing the same<br><p>   object must also set `port`.<br><p> &#42; If one ParentRef sets `sectionName` and `port`, all ParentRefs<br><p>   referencing the same object must also set `sectionName` and `port`.<br><p> <br><p> It is possible to separately reference multiple distinct objects that may be collapsed by an implementation. For example, some implementations may choose to merge compatible Gateway Listeners together. If that is the case, the list of routes attached to those resources should also be merged.<br><p> <br><p> Note that for ParentRefs that cross namespace boundaries, there are specific rules. Cross-namespace references are only valid if they are explicitly allowed by something in the namespace they are referring to. For example, Gateway has the AllowedRoutes field, and ReferenceGrant provides a generic way to enable other kinds of cross-namespace reference.<br><p> <br><p> &lt;gateway:experimental:description&gt; ParentRefs from a Route to a Service in the same namespace are "producer" routes, which apply default routing rules to inbound connections from any namespace to the Service.<br><p> <br><p> ParentRefs from a Route to a Service in a different namespace are "consumer" routes, and these routing rules are only applied to outbound connections originating from the same namespace as the Route, for which the intended destination of the connections are a Service targeted as a ParentRef of the Route. &lt;/gateway:experimental:description&gt;<br><p> <br><p> &lt;gateway:standard:validation:XValidation:message="sectionName must be specified when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.all(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) ? ((!has(p1.sectionName) || p1.sectionName == '') == (!has(p2.sectionName) || p2.sectionName == '')) : true))"&gt; &lt;gateway:standard:validation:XValidation:message="sectionName must be unique when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.exists_one(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) &amp;&amp; (((!has(p1.sectionName) || p1.sectionName == '') &amp;&amp; (!has(p2.sectionName) || p2.sectionName == '')) || (has(p1.sectionName) &amp;&amp; has(p2.sectionName) &amp;&amp; p1.sectionName == p2.sectionName))))"&gt; &lt;gateway:experimental:validation:XValidation:message="sectionName or port must be specified when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.all(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__)) ? ((!has(p1.sectionName) || p1.sectionName == '') == (!has(p2.sectionName) || p2.sectionName == '') &amp;&amp; (!has(p1.port) || p1.port == 0) == (!has(p2.port) || p2.port == 0)): true))"&gt; &lt;gateway:experimental:validation:XValidation:message="sectionName or port must be unique when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.exists_one(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) &amp;&amp; (((!has(p1.sectionName) || p1.sectionName == '') &amp;&amp; (!has(p2.sectionName) || p2.sectionName == '')) || ( has(p1.sectionName) &amp;&amp; has(p2.sectionName) &amp;&amp; p1.sectionName == p2.sectionName)) &amp;&amp; (((!has(p1.port) || p1.port == 0) &amp;&amp; (!has(p2.port) || p2.port == 0)) || (has(p1.port) &amp;&amp; has(p2.port) &amp;&amp; p1.port == p2.port))))"&gt;
+     */
     @JsonProperty("parentRefs")
     public void setParentRefs(List<ParentReference> parentRefs) {
         this.parentRefs = parentRefs;
     }
 
+    /**
+     * Rules are a list of TCP matchers and actions.<br><p> <br><p> &lt;gateway:experimental:validation:XValidation:message="Rule name must be unique within the route",rule="self.all(l1, !has(l1.name) || self.exists_one(l2, has(l2.name) &amp;&amp; l1.name == l2.name))"&gt;
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TCPRouteRule> getRules() {
         return rules;
     }
 
+    /**
+     * Rules are a list of TCP matchers and actions.<br><p> <br><p> &lt;gateway:experimental:validation:XValidation:message="Rule name must be unique within the route",rule="self.all(l1, !has(l1.name) || self.exists_one(l2, has(l2.name) &amp;&amp; l1.name == l2.name))"&gt;
+     */
     @JsonProperty("rules")
     public void setRules(List<TCPRouteRule> rules) {
         this.rules = rules;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TCPRouteStatus.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TCPRouteStatus.java
index 6b58df19b15..2c2f81575b2 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TCPRouteStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TCPRouteStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TCPRouteStatus defines the observed state of TCPRoute
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,12 +85,18 @@ public TCPRouteStatus(List<RouteParentStatus> parents) {
         this.parents = parents;
     }
 
+    /**
+     * Parents is a list of parent resources (usually Gateways) that are associated with the route, and the status of the route with respect to each parent. When this route attaches to a parent, the controller that manages the parent must add an entry to this list when the controller first sees the route and should update the entry as appropriate when the route or gateway is modified.<br><p> <br><p> Note that parent references that cannot be resolved by an implementation of this API will not be added to this list. Implementations of this API can only populate Route status for the Gateways/parent resources they are responsible for.<br><p> <br><p> A maximum of 32 Gateways will be represented in this list. An empty list means the route has not been attached to any Gateway.
+     */
     @JsonProperty("parents")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RouteParentStatus> getParents() {
         return parents;
     }
 
+    /**
+     * Parents is a list of parent resources (usually Gateways) that are associated with the route, and the status of the route with respect to each parent. When this route attaches to a parent, the controller that manages the parent must add an entry to this list when the controller first sees the route and should update the entry as appropriate when the route or gateway is modified.<br><p> <br><p> Note that parent references that cannot be resolved by an implementation of this API will not be added to this list. Implementations of this API can only populate Route status for the Gateways/parent resources they are responsible for.<br><p> <br><p> A maximum of 32 Gateways will be represented in this list. An empty list means the route has not been attached to any Gateway.
+     */
     @JsonProperty("parents")
     public void setParents(List<RouteParentStatus> parents) {
         this.parents = parents;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TLSRoute.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TLSRoute.java
index 9ab558757f3..e589552e78b 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TLSRoute.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TLSRoute.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * The TLSRoute resource is similar to TCPRoute, but can be configured to match against TLS-specific metadata. This allows more flexibility in matching streams for a given TLS listener.<br><p> <br><p> If you need to forward traffic to a single target for a TLS listener, you could choose to use a TCPRoute with a TLS listener.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class TLSRoute implements Editable<TLSRouteBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1alpha2";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TLSRoute";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TLSRoute(String apiVersion, String kind, ObjectMeta metadata, TLSRouteSpe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * The TLSRoute resource is similar to TCPRoute, but can be configured to match against TLS-specific metadata. This allows more flexibility in matching streams for a given TLS listener.<br><p> <br><p> If you need to forward traffic to a single target for a TLS listener, you could choose to use a TCPRoute with a TLS listener.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * The TLSRoute resource is similar to TCPRoute, but can be configured to match against TLS-specific metadata. This allows more flexibility in matching streams for a given TLS listener.<br><p> <br><p> If you need to forward traffic to a single target for a TLS listener, you could choose to use a TCPRoute with a TLS listener.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * The TLSRoute resource is similar to TCPRoute, but can be configured to match against TLS-specific metadata. This allows more flexibility in matching streams for a given TLS listener.<br><p> <br><p> If you need to forward traffic to a single target for a TLS listener, you could choose to use a TCPRoute with a TLS listener.
+     */
     @JsonProperty("spec")
     public TLSRouteSpec getSpec() {
         return spec;
     }
 
+    /**
+     * The TLSRoute resource is similar to TCPRoute, but can be configured to match against TLS-specific metadata. This allows more flexibility in matching streams for a given TLS listener.<br><p> <br><p> If you need to forward traffic to a single target for a TLS listener, you could choose to use a TCPRoute with a TLS listener.
+     */
     @JsonProperty("spec")
     public void setSpec(TLSRouteSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * The TLSRoute resource is similar to TCPRoute, but can be configured to match against TLS-specific metadata. This allows more flexibility in matching streams for a given TLS listener.<br><p> <br><p> If you need to forward traffic to a single target for a TLS listener, you could choose to use a TCPRoute with a TLS listener.
+     */
     @JsonProperty("status")
     public TLSRouteStatus getStatus() {
         return status;
     }
 
+    /**
+     * The TLSRoute resource is similar to TCPRoute, but can be configured to match against TLS-specific metadata. This allows more flexibility in matching streams for a given TLS listener.<br><p> <br><p> If you need to forward traffic to a single target for a TLS listener, you could choose to use a TCPRoute with a TLS listener.
+     */
     @JsonProperty("status")
     public void setStatus(TLSRouteStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TLSRouteList.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TLSRouteList.java
index 0c438b6cad6..020cc07ffc3 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TLSRouteList.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TLSRouteList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TLSRouteList contains a list of TLSRoute
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class TLSRouteList implements Editable<TLSRouteListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.gatewayapi.v1alpha2.TLSRoute>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1alpha2";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.gatewayapi.v1alpha2.TLSRoute> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TLSRouteList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TLSRouteList(String apiVersion, List<io.fabric8.kubernetes.api.model.gate
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * TLSRouteList contains a list of TLSRoute
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.gatewayapi.v1alpha2.TLSRoute> getItems() {
         return items;
     }
 
+    /**
+     * TLSRouteList contains a list of TLSRoute
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.gatewayapi.v1alpha2.TLSRoute> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TLSRouteList contains a list of TLSRoute
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TLSRouteList contains a list of TLSRoute
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TLSRouteRule.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TLSRouteRule.java
index ef24a9d7f30..86d3ef112cd 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TLSRouteRule.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TLSRouteRule.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TLSRouteRule is the configuration for a given rule.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,22 +89,34 @@ public TLSRouteRule(List<BackendRef> backendRefs, String name) {
         this.name = name;
     }
 
+    /**
+     * BackendRefs defines the backend(s) where matching requests should be sent. If unspecified or invalid (refers to a non-existent resource or a Service with no endpoints), the rule performs no forwarding; if no filters are specified that would result in a response being sent, the underlying implementation must actively reject request attempts to this backend, by rejecting the connection or returning a 500 status code. Request rejections must respect weight; if an invalid backend is requested to have 80% of requests, then 80% of requests must be rejected instead.<br><p> <br><p> Support: Core for Kubernetes Service<br><p> <br><p> Support: Extended for Kubernetes ServiceImport<br><p> <br><p> Support: Implementation-specific for any other resource<br><p> <br><p> Support for weight: Extended
+     */
     @JsonProperty("backendRefs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<BackendRef> getBackendRefs() {
         return backendRefs;
     }
 
+    /**
+     * BackendRefs defines the backend(s) where matching requests should be sent. If unspecified or invalid (refers to a non-existent resource or a Service with no endpoints), the rule performs no forwarding; if no filters are specified that would result in a response being sent, the underlying implementation must actively reject request attempts to this backend, by rejecting the connection or returning a 500 status code. Request rejections must respect weight; if an invalid backend is requested to have 80% of requests, then 80% of requests must be rejected instead.<br><p> <br><p> Support: Core for Kubernetes Service<br><p> <br><p> Support: Extended for Kubernetes ServiceImport<br><p> <br><p> Support: Implementation-specific for any other resource<br><p> <br><p> Support for weight: Extended
+     */
     @JsonProperty("backendRefs")
     public void setBackendRefs(List<BackendRef> backendRefs) {
         this.backendRefs = backendRefs;
     }
 
+    /**
+     * Name is the name of the route rule. This name MUST be unique within a Route if it is set.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the route rule. This name MUST be unique within a Route if it is set.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TLSRouteSpec.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TLSRouteSpec.java
index 2a041b26291..64a147a6896 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TLSRouteSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TLSRouteSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TLSRouteSpec defines the desired state of a TLSRoute resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -92,34 +95,52 @@ public TLSRouteSpec(List<String> hostnames, List<ParentReference> parentRefs, Li
         this.rules = rules;
     }
 
+    /**
+     * Hostnames defines a set of SNI names that should match against the SNI attribute of TLS ClientHello message in TLS handshake. This matches the RFC 1123 definition of a hostname with 2 notable exceptions:<br><p> <br><p> 1. IPs are not allowed in SNI names per RFC 6066. 2. A hostname may be prefixed with a wildcard label (`&#42;.`). The wildcard<br><p>    label must appear by itself as the first label.<br><p> <br><p> If a hostname is specified by both the Listener and TLSRoute, there must be at least one intersecting hostname for the TLSRoute to be attached to the Listener. For example:<br><p> <br><p> &#42; A Listener with `test.example.com` as the hostname matches TLSRoutes<br><p>   that have either not specified any hostnames, or have specified at<br><p>   least one of `test.example.com` or `&#42;.example.com`.<br><p> &#42; A Listener with `&#42;.example.com` as the hostname matches TLSRoutes<br><p>   that have either not specified any hostnames or have specified at least<br><p>   one hostname that matches the Listener hostname. For example,<br><p>   `test.example.com` and `&#42;.example.com` would both match. On the other<br><p>   hand, `example.com` and `test.example.net` would not match.<br><p> <br><p> If both the Listener and TLSRoute have specified hostnames, any TLSRoute hostnames that do not match the Listener hostname MUST be ignored. For example, if a Listener specified `&#42;.example.com`, and the TLSRoute specified `test.example.com` and `test.example.net`, `test.example.net` must not be considered for a match.<br><p> <br><p> If both the Listener and TLSRoute have specified hostnames, and none match with the criteria above, then the TLSRoute is not accepted. The implementation must raise an 'Accepted' Condition with a status of `False` in the corresponding RouteParentStatus.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("hostnames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getHostnames() {
         return hostnames;
     }
 
+    /**
+     * Hostnames defines a set of SNI names that should match against the SNI attribute of TLS ClientHello message in TLS handshake. This matches the RFC 1123 definition of a hostname with 2 notable exceptions:<br><p> <br><p> 1. IPs are not allowed in SNI names per RFC 6066. 2. A hostname may be prefixed with a wildcard label (`&#42;.`). The wildcard<br><p>    label must appear by itself as the first label.<br><p> <br><p> If a hostname is specified by both the Listener and TLSRoute, there must be at least one intersecting hostname for the TLSRoute to be attached to the Listener. For example:<br><p> <br><p> &#42; A Listener with `test.example.com` as the hostname matches TLSRoutes<br><p>   that have either not specified any hostnames, or have specified at<br><p>   least one of `test.example.com` or `&#42;.example.com`.<br><p> &#42; A Listener with `&#42;.example.com` as the hostname matches TLSRoutes<br><p>   that have either not specified any hostnames or have specified at least<br><p>   one hostname that matches the Listener hostname. For example,<br><p>   `test.example.com` and `&#42;.example.com` would both match. On the other<br><p>   hand, `example.com` and `test.example.net` would not match.<br><p> <br><p> If both the Listener and TLSRoute have specified hostnames, any TLSRoute hostnames that do not match the Listener hostname MUST be ignored. For example, if a Listener specified `&#42;.example.com`, and the TLSRoute specified `test.example.com` and `test.example.net`, `test.example.net` must not be considered for a match.<br><p> <br><p> If both the Listener and TLSRoute have specified hostnames, and none match with the criteria above, then the TLSRoute is not accepted. The implementation must raise an 'Accepted' Condition with a status of `False` in the corresponding RouteParentStatus.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("hostnames")
     public void setHostnames(List<String> hostnames) {
         this.hostnames = hostnames;
     }
 
+    /**
+     * ParentRefs references the resources (usually Gateways) that a Route wants to be attached to. Note that the referenced parent resource needs to allow this for the attachment to be complete. For Gateways, that means the Gateway needs to allow attachment from Routes of this kind and namespace. For Services, that means the Service must either be in the same namespace for a "producer" route, or the mesh implementation must support and allow "consumer" routes for the referenced Service. ReferenceGrant is not applicable for governing ParentRefs to Services - it is not possible to create a "producer" route for a Service in a different namespace from the Route.<br><p> <br><p> There are two kinds of parent resources with "Core" support:<br><p> <br><p> &#42; Gateway (Gateway conformance profile) &#42; Service (Mesh conformance profile, ClusterIP Services only)<br><p> <br><p> This API may be extended in the future to support additional kinds of parent resources.<br><p> <br><p> ParentRefs must be _distinct_. This means either that:<br><p> <br><p> &#42; They select different objects.  If this is the case, then parentRef<br><p>   entries are distinct. In terms of fields, this means that the<br><p>   multi-part key defined by `group`, `kind`, `namespace`, and `name` must<br><p>   be unique across all parentRef entries in the Route.<br><p> &#42; They do not select different objects, but for each optional field used,<br><p>   each ParentRef that selects the same object must set the same set of<br><p>   optional fields to different values. If one ParentRef sets a<br><p>   combination of optional fields, all must set the same combination.<br><p> <br><p> Some examples:<br><p> <br><p> &#42; If one ParentRef sets `sectionName`, all ParentRefs referencing the<br><p>   same object must also set `sectionName`.<br><p> &#42; If one ParentRef sets `port`, all ParentRefs referencing the same<br><p>   object must also set `port`.<br><p> &#42; If one ParentRef sets `sectionName` and `port`, all ParentRefs<br><p>   referencing the same object must also set `sectionName` and `port`.<br><p> <br><p> It is possible to separately reference multiple distinct objects that may be collapsed by an implementation. For example, some implementations may choose to merge compatible Gateway Listeners together. If that is the case, the list of routes attached to those resources should also be merged.<br><p> <br><p> Note that for ParentRefs that cross namespace boundaries, there are specific rules. Cross-namespace references are only valid if they are explicitly allowed by something in the namespace they are referring to. For example, Gateway has the AllowedRoutes field, and ReferenceGrant provides a generic way to enable other kinds of cross-namespace reference.<br><p> <br><p> &lt;gateway:experimental:description&gt; ParentRefs from a Route to a Service in the same namespace are "producer" routes, which apply default routing rules to inbound connections from any namespace to the Service.<br><p> <br><p> ParentRefs from a Route to a Service in a different namespace are "consumer" routes, and these routing rules are only applied to outbound connections originating from the same namespace as the Route, for which the intended destination of the connections are a Service targeted as a ParentRef of the Route. &lt;/gateway:experimental:description&gt;<br><p> <br><p> &lt;gateway:standard:validation:XValidation:message="sectionName must be specified when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.all(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) ? ((!has(p1.sectionName) || p1.sectionName == '') == (!has(p2.sectionName) || p2.sectionName == '')) : true))"&gt; &lt;gateway:standard:validation:XValidation:message="sectionName must be unique when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.exists_one(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) &amp;&amp; (((!has(p1.sectionName) || p1.sectionName == '') &amp;&amp; (!has(p2.sectionName) || p2.sectionName == '')) || (has(p1.sectionName) &amp;&amp; has(p2.sectionName) &amp;&amp; p1.sectionName == p2.sectionName))))"&gt; &lt;gateway:experimental:validation:XValidation:message="sectionName or port must be specified when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.all(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__)) ? ((!has(p1.sectionName) || p1.sectionName == '') == (!has(p2.sectionName) || p2.sectionName == '') &amp;&amp; (!has(p1.port) || p1.port == 0) == (!has(p2.port) || p2.port == 0)): true))"&gt; &lt;gateway:experimental:validation:XValidation:message="sectionName or port must be unique when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.exists_one(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) &amp;&amp; (((!has(p1.sectionName) || p1.sectionName == '') &amp;&amp; (!has(p2.sectionName) || p2.sectionName == '')) || ( has(p1.sectionName) &amp;&amp; has(p2.sectionName) &amp;&amp; p1.sectionName == p2.sectionName)) &amp;&amp; (((!has(p1.port) || p1.port == 0) &amp;&amp; (!has(p2.port) || p2.port == 0)) || (has(p1.port) &amp;&amp; has(p2.port) &amp;&amp; p1.port == p2.port))))"&gt;
+     */
     @JsonProperty("parentRefs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ParentReference> getParentRefs() {
         return parentRefs;
     }
 
+    /**
+     * ParentRefs references the resources (usually Gateways) that a Route wants to be attached to. Note that the referenced parent resource needs to allow this for the attachment to be complete. For Gateways, that means the Gateway needs to allow attachment from Routes of this kind and namespace. For Services, that means the Service must either be in the same namespace for a "producer" route, or the mesh implementation must support and allow "consumer" routes for the referenced Service. ReferenceGrant is not applicable for governing ParentRefs to Services - it is not possible to create a "producer" route for a Service in a different namespace from the Route.<br><p> <br><p> There are two kinds of parent resources with "Core" support:<br><p> <br><p> &#42; Gateway (Gateway conformance profile) &#42; Service (Mesh conformance profile, ClusterIP Services only)<br><p> <br><p> This API may be extended in the future to support additional kinds of parent resources.<br><p> <br><p> ParentRefs must be _distinct_. This means either that:<br><p> <br><p> &#42; They select different objects.  If this is the case, then parentRef<br><p>   entries are distinct. In terms of fields, this means that the<br><p>   multi-part key defined by `group`, `kind`, `namespace`, and `name` must<br><p>   be unique across all parentRef entries in the Route.<br><p> &#42; They do not select different objects, but for each optional field used,<br><p>   each ParentRef that selects the same object must set the same set of<br><p>   optional fields to different values. If one ParentRef sets a<br><p>   combination of optional fields, all must set the same combination.<br><p> <br><p> Some examples:<br><p> <br><p> &#42; If one ParentRef sets `sectionName`, all ParentRefs referencing the<br><p>   same object must also set `sectionName`.<br><p> &#42; If one ParentRef sets `port`, all ParentRefs referencing the same<br><p>   object must also set `port`.<br><p> &#42; If one ParentRef sets `sectionName` and `port`, all ParentRefs<br><p>   referencing the same object must also set `sectionName` and `port`.<br><p> <br><p> It is possible to separately reference multiple distinct objects that may be collapsed by an implementation. For example, some implementations may choose to merge compatible Gateway Listeners together. If that is the case, the list of routes attached to those resources should also be merged.<br><p> <br><p> Note that for ParentRefs that cross namespace boundaries, there are specific rules. Cross-namespace references are only valid if they are explicitly allowed by something in the namespace they are referring to. For example, Gateway has the AllowedRoutes field, and ReferenceGrant provides a generic way to enable other kinds of cross-namespace reference.<br><p> <br><p> &lt;gateway:experimental:description&gt; ParentRefs from a Route to a Service in the same namespace are "producer" routes, which apply default routing rules to inbound connections from any namespace to the Service.<br><p> <br><p> ParentRefs from a Route to a Service in a different namespace are "consumer" routes, and these routing rules are only applied to outbound connections originating from the same namespace as the Route, for which the intended destination of the connections are a Service targeted as a ParentRef of the Route. &lt;/gateway:experimental:description&gt;<br><p> <br><p> &lt;gateway:standard:validation:XValidation:message="sectionName must be specified when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.all(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) ? ((!has(p1.sectionName) || p1.sectionName == '') == (!has(p2.sectionName) || p2.sectionName == '')) : true))"&gt; &lt;gateway:standard:validation:XValidation:message="sectionName must be unique when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.exists_one(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) &amp;&amp; (((!has(p1.sectionName) || p1.sectionName == '') &amp;&amp; (!has(p2.sectionName) || p2.sectionName == '')) || (has(p1.sectionName) &amp;&amp; has(p2.sectionName) &amp;&amp; p1.sectionName == p2.sectionName))))"&gt; &lt;gateway:experimental:validation:XValidation:message="sectionName or port must be specified when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.all(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__)) ? ((!has(p1.sectionName) || p1.sectionName == '') == (!has(p2.sectionName) || p2.sectionName == '') &amp;&amp; (!has(p1.port) || p1.port == 0) == (!has(p2.port) || p2.port == 0)): true))"&gt; &lt;gateway:experimental:validation:XValidation:message="sectionName or port must be unique when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.exists_one(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) &amp;&amp; (((!has(p1.sectionName) || p1.sectionName == '') &amp;&amp; (!has(p2.sectionName) || p2.sectionName == '')) || ( has(p1.sectionName) &amp;&amp; has(p2.sectionName) &amp;&amp; p1.sectionName == p2.sectionName)) &amp;&amp; (((!has(p1.port) || p1.port == 0) &amp;&amp; (!has(p2.port) || p2.port == 0)) || (has(p1.port) &amp;&amp; has(p2.port) &amp;&amp; p1.port == p2.port))))"&gt;
+     */
     @JsonProperty("parentRefs")
     public void setParentRefs(List<ParentReference> parentRefs) {
         this.parentRefs = parentRefs;
     }
 
+    /**
+     * Rules are a list of TLS matchers and actions.<br><p> <br><p> &lt;gateway:experimental:validation:XValidation:message="Rule name must be unique within the route",rule="self.all(l1, !has(l1.name) || self.exists_one(l2, has(l2.name) &amp;&amp; l1.name == l2.name))"&gt;
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TLSRouteRule> getRules() {
         return rules;
     }
 
+    /**
+     * Rules are a list of TLS matchers and actions.<br><p> <br><p> &lt;gateway:experimental:validation:XValidation:message="Rule name must be unique within the route",rule="self.all(l1, !has(l1.name) || self.exists_one(l2, has(l2.name) &amp;&amp; l1.name == l2.name))"&gt;
+     */
     @JsonProperty("rules")
     public void setRules(List<TLSRouteRule> rules) {
         this.rules = rules;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TLSRouteStatus.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TLSRouteStatus.java
index 13adc4f7596..b9c0791a42a 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TLSRouteStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/TLSRouteStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TLSRouteStatus defines the observed state of TLSRoute
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,12 +85,18 @@ public TLSRouteStatus(List<RouteParentStatus> parents) {
         this.parents = parents;
     }
 
+    /**
+     * Parents is a list of parent resources (usually Gateways) that are associated with the route, and the status of the route with respect to each parent. When this route attaches to a parent, the controller that manages the parent must add an entry to this list when the controller first sees the route and should update the entry as appropriate when the route or gateway is modified.<br><p> <br><p> Note that parent references that cannot be resolved by an implementation of this API will not be added to this list. Implementations of this API can only populate Route status for the Gateways/parent resources they are responsible for.<br><p> <br><p> A maximum of 32 Gateways will be represented in this list. An empty list means the route has not been attached to any Gateway.
+     */
     @JsonProperty("parents")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RouteParentStatus> getParents() {
         return parents;
     }
 
+    /**
+     * Parents is a list of parent resources (usually Gateways) that are associated with the route, and the status of the route with respect to each parent. When this route attaches to a parent, the controller that manages the parent must add an entry to this list when the controller first sees the route and should update the entry as appropriate when the route or gateway is modified.<br><p> <br><p> Note that parent references that cannot be resolved by an implementation of this API will not be added to this list. Implementations of this API can only populate Route status for the Gateways/parent resources they are responsible for.<br><p> <br><p> A maximum of 32 Gateways will be represented in this list. An empty list means the route has not been attached to any Gateway.
+     */
     @JsonProperty("parents")
     public void setParents(List<RouteParentStatus> parents) {
         this.parents = parents;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/UDPRoute.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/UDPRoute.java
index 659ea7331e8..48e491b6185 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/UDPRoute.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/UDPRoute.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UDPRoute provides a way to route UDP traffic. When combined with a Gateway listener, it can be used to forward traffic on the port specified by the listener to a set of backends specified by the UDPRoute.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class UDPRoute implements Editable<UDPRouteBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1alpha2";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "UDPRoute";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public UDPRoute(String apiVersion, String kind, ObjectMeta metadata, UDPRouteSpe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * UDPRoute provides a way to route UDP traffic. When combined with a Gateway listener, it can be used to forward traffic on the port specified by the listener to a set of backends specified by the UDPRoute.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * UDPRoute provides a way to route UDP traffic. When combined with a Gateway listener, it can be used to forward traffic on the port specified by the listener to a set of backends specified by the UDPRoute.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * UDPRoute provides a way to route UDP traffic. When combined with a Gateway listener, it can be used to forward traffic on the port specified by the listener to a set of backends specified by the UDPRoute.
+     */
     @JsonProperty("spec")
     public UDPRouteSpec getSpec() {
         return spec;
     }
 
+    /**
+     * UDPRoute provides a way to route UDP traffic. When combined with a Gateway listener, it can be used to forward traffic on the port specified by the listener to a set of backends specified by the UDPRoute.
+     */
     @JsonProperty("spec")
     public void setSpec(UDPRouteSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * UDPRoute provides a way to route UDP traffic. When combined with a Gateway listener, it can be used to forward traffic on the port specified by the listener to a set of backends specified by the UDPRoute.
+     */
     @JsonProperty("status")
     public UDPRouteStatus getStatus() {
         return status;
     }
 
+    /**
+     * UDPRoute provides a way to route UDP traffic. When combined with a Gateway listener, it can be used to forward traffic on the port specified by the listener to a set of backends specified by the UDPRoute.
+     */
     @JsonProperty("status")
     public void setStatus(UDPRouteStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/UDPRouteList.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/UDPRouteList.java
index 2c11af1569f..d275a5d6abc 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/UDPRouteList.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/UDPRouteList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UDPRouteList contains a list of UDPRoute
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class UDPRouteList implements Editable<UDPRouteListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.gatewayapi.v1alpha2.UDPRoute>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1alpha2";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.gatewayapi.v1alpha2.UDPRoute> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "UDPRouteList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public UDPRouteList(String apiVersion, List<io.fabric8.kubernetes.api.model.gate
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * UDPRouteList contains a list of UDPRoute
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.gatewayapi.v1alpha2.UDPRoute> getItems() {
         return items;
     }
 
+    /**
+     * UDPRouteList contains a list of UDPRoute
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.gatewayapi.v1alpha2.UDPRoute> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * UDPRouteList contains a list of UDPRoute
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * UDPRouteList contains a list of UDPRoute
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/UDPRouteRule.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/UDPRouteRule.java
index efb0becd4f2..d4ff67e0a4c 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/UDPRouteRule.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/UDPRouteRule.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UDPRouteRule is the configuration for a given rule.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,22 +89,34 @@ public UDPRouteRule(List<BackendRef> backendRefs, String name) {
         this.name = name;
     }
 
+    /**
+     * BackendRefs defines the backend(s) where matching requests should be sent. If unspecified or invalid (refers to a non-existent resource or a Service with no endpoints), the underlying implementation MUST actively reject connection attempts to this backend. Packet drops must respect weight; if an invalid backend is requested to have 80% of the packets, then 80% of packets must be dropped instead.<br><p> <br><p> Support: Core for Kubernetes Service<br><p> <br><p> Support: Extended for Kubernetes ServiceImport<br><p> <br><p> Support: Implementation-specific for any other resource<br><p> <br><p> Support for weight: Extended
+     */
     @JsonProperty("backendRefs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<BackendRef> getBackendRefs() {
         return backendRefs;
     }
 
+    /**
+     * BackendRefs defines the backend(s) where matching requests should be sent. If unspecified or invalid (refers to a non-existent resource or a Service with no endpoints), the underlying implementation MUST actively reject connection attempts to this backend. Packet drops must respect weight; if an invalid backend is requested to have 80% of the packets, then 80% of packets must be dropped instead.<br><p> <br><p> Support: Core for Kubernetes Service<br><p> <br><p> Support: Extended for Kubernetes ServiceImport<br><p> <br><p> Support: Implementation-specific for any other resource<br><p> <br><p> Support for weight: Extended
+     */
     @JsonProperty("backendRefs")
     public void setBackendRefs(List<BackendRef> backendRefs) {
         this.backendRefs = backendRefs;
     }
 
+    /**
+     * Name is the name of the route rule. This name MUST be unique within a Route if it is set.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the route rule. This name MUST be unique within a Route if it is set.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/UDPRouteSpec.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/UDPRouteSpec.java
index bd69a59e729..f8f86c6c6b0 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/UDPRouteSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/UDPRouteSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UDPRouteSpec defines the desired state of UDPRoute.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,23 +90,35 @@ public UDPRouteSpec(List<ParentReference> parentRefs, List<UDPRouteRule> rules)
         this.rules = rules;
     }
 
+    /**
+     * ParentRefs references the resources (usually Gateways) that a Route wants to be attached to. Note that the referenced parent resource needs to allow this for the attachment to be complete. For Gateways, that means the Gateway needs to allow attachment from Routes of this kind and namespace. For Services, that means the Service must either be in the same namespace for a "producer" route, or the mesh implementation must support and allow "consumer" routes for the referenced Service. ReferenceGrant is not applicable for governing ParentRefs to Services - it is not possible to create a "producer" route for a Service in a different namespace from the Route.<br><p> <br><p> There are two kinds of parent resources with "Core" support:<br><p> <br><p> &#42; Gateway (Gateway conformance profile) &#42; Service (Mesh conformance profile, ClusterIP Services only)<br><p> <br><p> This API may be extended in the future to support additional kinds of parent resources.<br><p> <br><p> ParentRefs must be _distinct_. This means either that:<br><p> <br><p> &#42; They select different objects.  If this is the case, then parentRef<br><p>   entries are distinct. In terms of fields, this means that the<br><p>   multi-part key defined by `group`, `kind`, `namespace`, and `name` must<br><p>   be unique across all parentRef entries in the Route.<br><p> &#42; They do not select different objects, but for each optional field used,<br><p>   each ParentRef that selects the same object must set the same set of<br><p>   optional fields to different values. If one ParentRef sets a<br><p>   combination of optional fields, all must set the same combination.<br><p> <br><p> Some examples:<br><p> <br><p> &#42; If one ParentRef sets `sectionName`, all ParentRefs referencing the<br><p>   same object must also set `sectionName`.<br><p> &#42; If one ParentRef sets `port`, all ParentRefs referencing the same<br><p>   object must also set `port`.<br><p> &#42; If one ParentRef sets `sectionName` and `port`, all ParentRefs<br><p>   referencing the same object must also set `sectionName` and `port`.<br><p> <br><p> It is possible to separately reference multiple distinct objects that may be collapsed by an implementation. For example, some implementations may choose to merge compatible Gateway Listeners together. If that is the case, the list of routes attached to those resources should also be merged.<br><p> <br><p> Note that for ParentRefs that cross namespace boundaries, there are specific rules. Cross-namespace references are only valid if they are explicitly allowed by something in the namespace they are referring to. For example, Gateway has the AllowedRoutes field, and ReferenceGrant provides a generic way to enable other kinds of cross-namespace reference.<br><p> <br><p> &lt;gateway:experimental:description&gt; ParentRefs from a Route to a Service in the same namespace are "producer" routes, which apply default routing rules to inbound connections from any namespace to the Service.<br><p> <br><p> ParentRefs from a Route to a Service in a different namespace are "consumer" routes, and these routing rules are only applied to outbound connections originating from the same namespace as the Route, for which the intended destination of the connections are a Service targeted as a ParentRef of the Route. &lt;/gateway:experimental:description&gt;<br><p> <br><p> &lt;gateway:standard:validation:XValidation:message="sectionName must be specified when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.all(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) ? ((!has(p1.sectionName) || p1.sectionName == '') == (!has(p2.sectionName) || p2.sectionName == '')) : true))"&gt; &lt;gateway:standard:validation:XValidation:message="sectionName must be unique when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.exists_one(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) &amp;&amp; (((!has(p1.sectionName) || p1.sectionName == '') &amp;&amp; (!has(p2.sectionName) || p2.sectionName == '')) || (has(p1.sectionName) &amp;&amp; has(p2.sectionName) &amp;&amp; p1.sectionName == p2.sectionName))))"&gt; &lt;gateway:experimental:validation:XValidation:message="sectionName or port must be specified when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.all(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__)) ? ((!has(p1.sectionName) || p1.sectionName == '') == (!has(p2.sectionName) || p2.sectionName == '') &amp;&amp; (!has(p1.port) || p1.port == 0) == (!has(p2.port) || p2.port == 0)): true))"&gt; &lt;gateway:experimental:validation:XValidation:message="sectionName or port must be unique when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.exists_one(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) &amp;&amp; (((!has(p1.sectionName) || p1.sectionName == '') &amp;&amp; (!has(p2.sectionName) || p2.sectionName == '')) || ( has(p1.sectionName) &amp;&amp; has(p2.sectionName) &amp;&amp; p1.sectionName == p2.sectionName)) &amp;&amp; (((!has(p1.port) || p1.port == 0) &amp;&amp; (!has(p2.port) || p2.port == 0)) || (has(p1.port) &amp;&amp; has(p2.port) &amp;&amp; p1.port == p2.port))))"&gt;
+     */
     @JsonProperty("parentRefs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ParentReference> getParentRefs() {
         return parentRefs;
     }
 
+    /**
+     * ParentRefs references the resources (usually Gateways) that a Route wants to be attached to. Note that the referenced parent resource needs to allow this for the attachment to be complete. For Gateways, that means the Gateway needs to allow attachment from Routes of this kind and namespace. For Services, that means the Service must either be in the same namespace for a "producer" route, or the mesh implementation must support and allow "consumer" routes for the referenced Service. ReferenceGrant is not applicable for governing ParentRefs to Services - it is not possible to create a "producer" route for a Service in a different namespace from the Route.<br><p> <br><p> There are two kinds of parent resources with "Core" support:<br><p> <br><p> &#42; Gateway (Gateway conformance profile) &#42; Service (Mesh conformance profile, ClusterIP Services only)<br><p> <br><p> This API may be extended in the future to support additional kinds of parent resources.<br><p> <br><p> ParentRefs must be _distinct_. This means either that:<br><p> <br><p> &#42; They select different objects.  If this is the case, then parentRef<br><p>   entries are distinct. In terms of fields, this means that the<br><p>   multi-part key defined by `group`, `kind`, `namespace`, and `name` must<br><p>   be unique across all parentRef entries in the Route.<br><p> &#42; They do not select different objects, but for each optional field used,<br><p>   each ParentRef that selects the same object must set the same set of<br><p>   optional fields to different values. If one ParentRef sets a<br><p>   combination of optional fields, all must set the same combination.<br><p> <br><p> Some examples:<br><p> <br><p> &#42; If one ParentRef sets `sectionName`, all ParentRefs referencing the<br><p>   same object must also set `sectionName`.<br><p> &#42; If one ParentRef sets `port`, all ParentRefs referencing the same<br><p>   object must also set `port`.<br><p> &#42; If one ParentRef sets `sectionName` and `port`, all ParentRefs<br><p>   referencing the same object must also set `sectionName` and `port`.<br><p> <br><p> It is possible to separately reference multiple distinct objects that may be collapsed by an implementation. For example, some implementations may choose to merge compatible Gateway Listeners together. If that is the case, the list of routes attached to those resources should also be merged.<br><p> <br><p> Note that for ParentRefs that cross namespace boundaries, there are specific rules. Cross-namespace references are only valid if they are explicitly allowed by something in the namespace they are referring to. For example, Gateway has the AllowedRoutes field, and ReferenceGrant provides a generic way to enable other kinds of cross-namespace reference.<br><p> <br><p> &lt;gateway:experimental:description&gt; ParentRefs from a Route to a Service in the same namespace are "producer" routes, which apply default routing rules to inbound connections from any namespace to the Service.<br><p> <br><p> ParentRefs from a Route to a Service in a different namespace are "consumer" routes, and these routing rules are only applied to outbound connections originating from the same namespace as the Route, for which the intended destination of the connections are a Service targeted as a ParentRef of the Route. &lt;/gateway:experimental:description&gt;<br><p> <br><p> &lt;gateway:standard:validation:XValidation:message="sectionName must be specified when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.all(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) ? ((!has(p1.sectionName) || p1.sectionName == '') == (!has(p2.sectionName) || p2.sectionName == '')) : true))"&gt; &lt;gateway:standard:validation:XValidation:message="sectionName must be unique when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.exists_one(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) &amp;&amp; (((!has(p1.sectionName) || p1.sectionName == '') &amp;&amp; (!has(p2.sectionName) || p2.sectionName == '')) || (has(p1.sectionName) &amp;&amp; has(p2.sectionName) &amp;&amp; p1.sectionName == p2.sectionName))))"&gt; &lt;gateway:experimental:validation:XValidation:message="sectionName or port must be specified when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.all(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__)) ? ((!has(p1.sectionName) || p1.sectionName == '') == (!has(p2.sectionName) || p2.sectionName == '') &amp;&amp; (!has(p1.port) || p1.port == 0) == (!has(p2.port) || p2.port == 0)): true))"&gt; &lt;gateway:experimental:validation:XValidation:message="sectionName or port must be unique when parentRefs includes 2 or more references to the same parent",rule="self.all(p1, self.exists_one(p2, p1.group == p2.group &amp;&amp; p1.kind == p2.kind &amp;&amp; p1.name == p2.name &amp;&amp; (((!has(p1.__namespace__) || p1.__namespace__ == '') &amp;&amp; (!has(p2.__namespace__) || p2.__namespace__ == '')) || (has(p1.__namespace__) &amp;&amp; has(p2.__namespace__) &amp;&amp; p1.__namespace__ == p2.__namespace__ )) &amp;&amp; (((!has(p1.sectionName) || p1.sectionName == '') &amp;&amp; (!has(p2.sectionName) || p2.sectionName == '')) || ( has(p1.sectionName) &amp;&amp; has(p2.sectionName) &amp;&amp; p1.sectionName == p2.sectionName)) &amp;&amp; (((!has(p1.port) || p1.port == 0) &amp;&amp; (!has(p2.port) || p2.port == 0)) || (has(p1.port) &amp;&amp; has(p2.port) &amp;&amp; p1.port == p2.port))))"&gt;
+     */
     @JsonProperty("parentRefs")
     public void setParentRefs(List<ParentReference> parentRefs) {
         this.parentRefs = parentRefs;
     }
 
+    /**
+     * Rules are a list of UDP matchers and actions.<br><p> <br><p> &lt;gateway:experimental:validation:XValidation:message="Rule name must be unique within the route",rule="self.all(l1, !has(l1.name) || self.exists_one(l2, has(l2.name) &amp;&amp; l1.name == l2.name))"&gt;
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<UDPRouteRule> getRules() {
         return rules;
     }
 
+    /**
+     * Rules are a list of UDP matchers and actions.<br><p> <br><p> &lt;gateway:experimental:validation:XValidation:message="Rule name must be unique within the route",rule="self.all(l1, !has(l1.name) || self.exists_one(l2, has(l2.name) &amp;&amp; l1.name == l2.name))"&gt;
+     */
     @JsonProperty("rules")
     public void setRules(List<UDPRouteRule> rules) {
         this.rules = rules;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/UDPRouteStatus.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/UDPRouteStatus.java
index c80eb12417f..e8818a7be26 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/UDPRouteStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha2/UDPRouteStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UDPRouteStatus defines the observed state of UDPRoute.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,12 +85,18 @@ public UDPRouteStatus(List<RouteParentStatus> parents) {
         this.parents = parents;
     }
 
+    /**
+     * Parents is a list of parent resources (usually Gateways) that are associated with the route, and the status of the route with respect to each parent. When this route attaches to a parent, the controller that manages the parent must add an entry to this list when the controller first sees the route and should update the entry as appropriate when the route or gateway is modified.<br><p> <br><p> Note that parent references that cannot be resolved by an implementation of this API will not be added to this list. Implementations of this API can only populate Route status for the Gateways/parent resources they are responsible for.<br><p> <br><p> A maximum of 32 Gateways will be represented in this list. An empty list means the route has not been attached to any Gateway.
+     */
     @JsonProperty("parents")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RouteParentStatus> getParents() {
         return parents;
     }
 
+    /**
+     * Parents is a list of parent resources (usually Gateways) that are associated with the route, and the status of the route with respect to each parent. When this route attaches to a parent, the controller that manages the parent must add an entry to this list when the controller first sees the route and should update the entry as appropriate when the route or gateway is modified.<br><p> <br><p> Note that parent references that cannot be resolved by an implementation of this API will not be added to this list. Implementations of this API can only populate Route status for the Gateways/parent resources they are responsible for.<br><p> <br><p> A maximum of 32 Gateways will be represented in this list. An empty list means the route has not been attached to any Gateway.
+     */
     @JsonProperty("parents")
     public void setParents(List<RouteParentStatus> parents) {
         this.parents = parents;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha3/BackendTLSPolicy.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha3/BackendTLSPolicy.java
index 2d74e16c713..cfe316f3f76 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha3/BackendTLSPolicy.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha3/BackendTLSPolicy.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BackendTLSPolicy provides a way to configure how a Gateway connects to a Backend via TLS.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class BackendTLSPolicy implements Editable<BackendTLSPolicyBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1alpha3";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "BackendTLSPolicy";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public BackendTLSPolicy(String apiVersion, String kind, ObjectMeta metadata, Bac
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * BackendTLSPolicy provides a way to configure how a Gateway connects to a Backend via TLS.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * BackendTLSPolicy provides a way to configure how a Gateway connects to a Backend via TLS.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * BackendTLSPolicy provides a way to configure how a Gateway connects to a Backend via TLS.
+     */
     @JsonProperty("spec")
     public BackendTLSPolicySpec getSpec() {
         return spec;
     }
 
+    /**
+     * BackendTLSPolicy provides a way to configure how a Gateway connects to a Backend via TLS.
+     */
     @JsonProperty("spec")
     public void setSpec(BackendTLSPolicySpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * BackendTLSPolicy provides a way to configure how a Gateway connects to a Backend via TLS.
+     */
     @JsonProperty("status")
     public PolicyStatus getStatus() {
         return status;
     }
 
+    /**
+     * BackendTLSPolicy provides a way to configure how a Gateway connects to a Backend via TLS.
+     */
     @JsonProperty("status")
     public void setStatus(PolicyStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha3/BackendTLSPolicyList.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha3/BackendTLSPolicyList.java
index 40d87712585..1646c0f51ea 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha3/BackendTLSPolicyList.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha3/BackendTLSPolicyList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BackendTLSPolicyList contains a list of BackendTLSPolicies
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class BackendTLSPolicyList implements Editable<BackendTLSPolicyListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.gatewayapi.v1alpha3.BackendTLSPolicy>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1alpha3";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.gatewayapi.v1alpha3.BackendTLSPolicy> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "BackendTLSPolicyList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public BackendTLSPolicyList(String apiVersion, List<io.fabric8.kubernetes.api.mo
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * BackendTLSPolicyList contains a list of BackendTLSPolicies
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.gatewayapi.v1alpha3.BackendTLSPolicy> getItems() {
         return items;
     }
 
+    /**
+     * BackendTLSPolicyList contains a list of BackendTLSPolicies
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.gatewayapi.v1alpha3.BackendTLSPolicy> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * BackendTLSPolicyList contains a list of BackendTLSPolicies
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * BackendTLSPolicyList contains a list of BackendTLSPolicies
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha3/BackendTLSPolicySpec.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha3/BackendTLSPolicySpec.java
index 3019a777787..2aedd6a121d 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha3/BackendTLSPolicySpec.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha3/BackendTLSPolicySpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BackendTLSPolicySpec defines the desired state of BackendTLSPolicy.<br><p> <br><p> Support: Extended
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,33 +94,51 @@ public BackendTLSPolicySpec(Map<String, String> options, List<LocalPolicyTargetR
         this.validation = validation;
     }
 
+    /**
+     * Options are a list of key/value pairs to enable extended TLS configuration for each implementation. For example, configuring the minimum TLS version or supported cipher suites.<br><p> <br><p> A set of common keys MAY be defined by the API in the future. To avoid any ambiguity, implementation-specific definitions MUST use domain-prefixed names, such as `example.com/my-custom-option`. Un-prefixed names are reserved for key names defined by Gateway API.<br><p> <br><p> Support: Implementation-specific
+     */
     @JsonProperty("options")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getOptions() {
         return options;
     }
 
+    /**
+     * Options are a list of key/value pairs to enable extended TLS configuration for each implementation. For example, configuring the minimum TLS version or supported cipher suites.<br><p> <br><p> A set of common keys MAY be defined by the API in the future. To avoid any ambiguity, implementation-specific definitions MUST use domain-prefixed names, such as `example.com/my-custom-option`. Un-prefixed names are reserved for key names defined by Gateway API.<br><p> <br><p> Support: Implementation-specific
+     */
     @JsonProperty("options")
     public void setOptions(Map<String, String> options) {
         this.options = options;
     }
 
+    /**
+     * TargetRefs identifies an API object to apply the policy to. Only Services have Extended support. Implementations MAY support additional objects, with Implementation Specific support. Note that this config applies to the entire referenced resource by default, but this default may change in the future to provide a more granular application of the policy.<br><p> <br><p> Support: Extended for Kubernetes Service<br><p> <br><p> Support: Implementation-specific for any other resource
+     */
     @JsonProperty("targetRefs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LocalPolicyTargetReferenceWithSectionName> getTargetRefs() {
         return targetRefs;
     }
 
+    /**
+     * TargetRefs identifies an API object to apply the policy to. Only Services have Extended support. Implementations MAY support additional objects, with Implementation Specific support. Note that this config applies to the entire referenced resource by default, but this default may change in the future to provide a more granular application of the policy.<br><p> <br><p> Support: Extended for Kubernetes Service<br><p> <br><p> Support: Implementation-specific for any other resource
+     */
     @JsonProperty("targetRefs")
     public void setTargetRefs(List<LocalPolicyTargetReferenceWithSectionName> targetRefs) {
         this.targetRefs = targetRefs;
     }
 
+    /**
+     * BackendTLSPolicySpec defines the desired state of BackendTLSPolicy.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("validation")
     public BackendTLSPolicyValidation getValidation() {
         return validation;
     }
 
+    /**
+     * BackendTLSPolicySpec defines the desired state of BackendTLSPolicy.<br><p> <br><p> Support: Extended
+     */
     @JsonProperty("validation")
     public void setValidation(BackendTLSPolicyValidation validation) {
         this.validation = validation;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha3/BackendTLSPolicyValidation.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha3/BackendTLSPolicyValidation.java
index 9586ab994ac..c49019b60de 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha3/BackendTLSPolicyValidation.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha3/BackendTLSPolicyValidation.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BackendTLSPolicyValidation contains backend TLS validation configuration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,43 +97,67 @@ public BackendTLSPolicyValidation(List<LocalObjectReference> caCertificateRefs,
         this.wellKnownCACertificates = wellKnownCACertificates;
     }
 
+    /**
+     * CACertificateRefs contains one or more references to Kubernetes objects that contain a PEM-encoded TLS CA certificate bundle, which is used to validate a TLS handshake between the Gateway and backend Pod.<br><p> <br><p> If CACertificateRefs is empty or unspecified, then WellKnownCACertificates must be specified. Only one of CACertificateRefs or WellKnownCACertificates may be specified, not both. If CACertifcateRefs is empty or unspecified, the configuration for WellKnownCACertificates MUST be honored instead if supported by the implementation.<br><p> <br><p> References to a resource in a different namespace are invalid for the moment, although we will revisit this in the future.<br><p> <br><p> A single CACertificateRef to a Kubernetes ConfigMap kind has "Core" support. Implementations MAY choose to support attaching multiple certificates to a backend, but this behavior is implementation-specific.<br><p> <br><p> Support: Core - An optional single reference to a Kubernetes ConfigMap, with the CA certificate in a key named `ca.crt`.<br><p> <br><p> Support: Implementation-specific (More than one reference, or other kinds of resources).
+     */
     @JsonProperty("caCertificateRefs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LocalObjectReference> getCaCertificateRefs() {
         return caCertificateRefs;
     }
 
+    /**
+     * CACertificateRefs contains one or more references to Kubernetes objects that contain a PEM-encoded TLS CA certificate bundle, which is used to validate a TLS handshake between the Gateway and backend Pod.<br><p> <br><p> If CACertificateRefs is empty or unspecified, then WellKnownCACertificates must be specified. Only one of CACertificateRefs or WellKnownCACertificates may be specified, not both. If CACertifcateRefs is empty or unspecified, the configuration for WellKnownCACertificates MUST be honored instead if supported by the implementation.<br><p> <br><p> References to a resource in a different namespace are invalid for the moment, although we will revisit this in the future.<br><p> <br><p> A single CACertificateRef to a Kubernetes ConfigMap kind has "Core" support. Implementations MAY choose to support attaching multiple certificates to a backend, but this behavior is implementation-specific.<br><p> <br><p> Support: Core - An optional single reference to a Kubernetes ConfigMap, with the CA certificate in a key named `ca.crt`.<br><p> <br><p> Support: Implementation-specific (More than one reference, or other kinds of resources).
+     */
     @JsonProperty("caCertificateRefs")
     public void setCaCertificateRefs(List<LocalObjectReference> caCertificateRefs) {
         this.caCertificateRefs = caCertificateRefs;
     }
 
+    /**
+     * Hostname is used for two purposes in the connection between Gateways and backends:<br><p> <br><p> 1. Hostname MUST be used as the SNI to connect to the backend (RFC 6066). 2. If SubjectAltNames is not specified, Hostname MUST be used for<br><p>    authentication and MUST match the certificate served by the matching<br><p>    backend.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("hostname")
     public String getHostname() {
         return hostname;
     }
 
+    /**
+     * Hostname is used for two purposes in the connection between Gateways and backends:<br><p> <br><p> 1. Hostname MUST be used as the SNI to connect to the backend (RFC 6066). 2. If SubjectAltNames is not specified, Hostname MUST be used for<br><p>    authentication and MUST match the certificate served by the matching<br><p>    backend.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("hostname")
     public void setHostname(String hostname) {
         this.hostname = hostname;
     }
 
+    /**
+     * SubjectAltNames contains one or more Subject Alternative Names. When specified, the certificate served from the backend MUST have at least one Subject Alternate Name matching one of the specified SubjectAltNames.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("subjectAltNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SubjectAltName> getSubjectAltNames() {
         return subjectAltNames;
     }
 
+    /**
+     * SubjectAltNames contains one or more Subject Alternative Names. When specified, the certificate served from the backend MUST have at least one Subject Alternate Name matching one of the specified SubjectAltNames.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("subjectAltNames")
     public void setSubjectAltNames(List<SubjectAltName> subjectAltNames) {
         this.subjectAltNames = subjectAltNames;
     }
 
+    /**
+     * WellKnownCACertificates specifies whether system CA certificates may be used in the TLS handshake between the gateway and backend pod.<br><p> <br><p> If WellKnownCACertificates is unspecified or empty (""), then CACertificateRefs must be specified with at least one entry for a valid configuration. Only one of CACertificateRefs or WellKnownCACertificates may be specified, not both. If an implementation does not support the WellKnownCACertificates field or the value supplied is not supported, the Status Conditions on the Policy MUST be updated to include an Accepted: False Condition with Reason: Invalid.<br><p> <br><p> Support: Implementation-specific
+     */
     @JsonProperty("wellKnownCACertificates")
     public String getWellKnownCACertificates() {
         return wellKnownCACertificates;
     }
 
+    /**
+     * WellKnownCACertificates specifies whether system CA certificates may be used in the TLS handshake between the gateway and backend pod.<br><p> <br><p> If WellKnownCACertificates is unspecified or empty (""), then CACertificateRefs must be specified with at least one entry for a valid configuration. Only one of CACertificateRefs or WellKnownCACertificates may be specified, not both. If an implementation does not support the WellKnownCACertificates field or the value supplied is not supported, the Status Conditions on the Policy MUST be updated to include an Accepted: False Condition with Reason: Invalid.<br><p> <br><p> Support: Implementation-specific
+     */
     @JsonProperty("wellKnownCACertificates")
     public void setWellKnownCACertificates(String wellKnownCACertificates) {
         this.wellKnownCACertificates = wellKnownCACertificates;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha3/SubjectAltName.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha3/SubjectAltName.java
index c1d09265c1a..9d04ddbac8c 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha3/SubjectAltName.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1alpha3/SubjectAltName.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubjectAltName represents Subject Alternative Name.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public SubjectAltName(String hostname, String type, String uri) {
         this.uri = uri;
     }
 
+    /**
+     * Hostname contains Subject Alternative Name specified in DNS name format. Required when Type is set to Hostname, ignored otherwise.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("hostname")
     public String getHostname() {
         return hostname;
     }
 
+    /**
+     * Hostname contains Subject Alternative Name specified in DNS name format. Required when Type is set to Hostname, ignored otherwise.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("hostname")
     public void setHostname(String hostname) {
         this.hostname = hostname;
     }
 
+    /**
+     * Type determines the format of the Subject Alternative Name. Always required.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type determines the format of the Subject Alternative Name. Always required.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * URI contains Subject Alternative Name specified in a full URI format. It MUST include both a scheme (e.g., "http" or "ftp") and a scheme-specific-part. Common values include SPIFFE IDs like "spiffe://mycluster.example.com/ns/myns/sa/svc1sa". Required when Type is set to URI, ignored otherwise.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("uri")
     public String getUri() {
         return uri;
     }
 
+    /**
+     * URI contains Subject Alternative Name specified in a full URI format. It MUST include both a scheme (e.g., "http" or "ftp") and a scheme-specific-part. Common values include SPIFFE IDs like "spiffe://mycluster.example.com/ns/myns/sa/svc1sa". Required when Type is set to URI, ignored otherwise.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("uri")
     public void setUri(String uri) {
         this.uri = uri;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/Gateway.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/Gateway.java
index ba55bded998..5b5c41f3ab9 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/Gateway.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/Gateway.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Gateway represents an instance of a service-traffic handling infrastructure by binding Listeners to a set of IP addresses.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,14 +81,8 @@
 public class Gateway implements Editable<GatewayBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Gateway";
     @JsonProperty("metadata")
@@ -113,7 +110,7 @@ public Gateway(String apiVersion, String kind, ObjectMeta metadata, GatewaySpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -121,7 +118,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -129,7 +126,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -137,38 +134,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Gateway represents an instance of a service-traffic handling infrastructure by binding Listeners to a set of IP addresses.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Gateway represents an instance of a service-traffic handling infrastructure by binding Listeners to a set of IP addresses.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Gateway represents an instance of a service-traffic handling infrastructure by binding Listeners to a set of IP addresses.
+     */
     @JsonProperty("spec")
     public GatewaySpec getSpec() {
         return spec;
     }
 
+    /**
+     * Gateway represents an instance of a service-traffic handling infrastructure by binding Listeners to a set of IP addresses.
+     */
     @JsonProperty("spec")
     public void setSpec(GatewaySpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Gateway represents an instance of a service-traffic handling infrastructure by binding Listeners to a set of IP addresses.
+     */
     @JsonProperty("status")
     public GatewayStatus getStatus() {
         return status;
     }
 
+    /**
+     * Gateway represents an instance of a service-traffic handling infrastructure by binding Listeners to a set of IP addresses.
+     */
     @JsonProperty("status")
     public void setStatus(GatewayStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/GatewayClass.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/GatewayClass.java
index e4acde64014..6feddb850c5 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/GatewayClass.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/GatewayClass.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GatewayClass describes a class of Gateways available to the user for creating Gateway resources.<br><p> <br><p> It is recommended that this resource be used as a template for Gateways. This means that a Gateway is based on the state of the GatewayClass at the time it was created and changes to the GatewayClass or associated parameters are not propagated down to existing Gateways. This recommendation is intended to limit the blast radius of changes to GatewayClass or associated parameters. If implementations choose to propagate GatewayClass changes to existing Gateways, that MUST be clearly documented by the implementation.<br><p> <br><p> Whenever one or more Gateways are using a GatewayClass, implementations SHOULD add the `gateway-exists-finalizer.gateway.networking.k8s.io` finalizer on the associated GatewayClass. This ensures that a GatewayClass associated with a Gateway is not deleted while in use.<br><p> <br><p> GatewayClass is a Cluster level resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class GatewayClass implements Editable<GatewayClassBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GatewayClass";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public GatewayClass(String apiVersion, String kind, ObjectMeta metadata, Gateway
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * GatewayClass describes a class of Gateways available to the user for creating Gateway resources.<br><p> <br><p> It is recommended that this resource be used as a template for Gateways. This means that a Gateway is based on the state of the GatewayClass at the time it was created and changes to the GatewayClass or associated parameters are not propagated down to existing Gateways. This recommendation is intended to limit the blast radius of changes to GatewayClass or associated parameters. If implementations choose to propagate GatewayClass changes to existing Gateways, that MUST be clearly documented by the implementation.<br><p> <br><p> Whenever one or more Gateways are using a GatewayClass, implementations SHOULD add the `gateway-exists-finalizer.gateway.networking.k8s.io` finalizer on the associated GatewayClass. This ensures that a GatewayClass associated with a Gateway is not deleted while in use.<br><p> <br><p> GatewayClass is a Cluster level resource.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * GatewayClass describes a class of Gateways available to the user for creating Gateway resources.<br><p> <br><p> It is recommended that this resource be used as a template for Gateways. This means that a Gateway is based on the state of the GatewayClass at the time it was created and changes to the GatewayClass or associated parameters are not propagated down to existing Gateways. This recommendation is intended to limit the blast radius of changes to GatewayClass or associated parameters. If implementations choose to propagate GatewayClass changes to existing Gateways, that MUST be clearly documented by the implementation.<br><p> <br><p> Whenever one or more Gateways are using a GatewayClass, implementations SHOULD add the `gateway-exists-finalizer.gateway.networking.k8s.io` finalizer on the associated GatewayClass. This ensures that a GatewayClass associated with a Gateway is not deleted while in use.<br><p> <br><p> GatewayClass is a Cluster level resource.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * GatewayClass describes a class of Gateways available to the user for creating Gateway resources.<br><p> <br><p> It is recommended that this resource be used as a template for Gateways. This means that a Gateway is based on the state of the GatewayClass at the time it was created and changes to the GatewayClass or associated parameters are not propagated down to existing Gateways. This recommendation is intended to limit the blast radius of changes to GatewayClass or associated parameters. If implementations choose to propagate GatewayClass changes to existing Gateways, that MUST be clearly documented by the implementation.<br><p> <br><p> Whenever one or more Gateways are using a GatewayClass, implementations SHOULD add the `gateway-exists-finalizer.gateway.networking.k8s.io` finalizer on the associated GatewayClass. This ensures that a GatewayClass associated with a Gateway is not deleted while in use.<br><p> <br><p> GatewayClass is a Cluster level resource.
+     */
     @JsonProperty("spec")
     public GatewayClassSpec getSpec() {
         return spec;
     }
 
+    /**
+     * GatewayClass describes a class of Gateways available to the user for creating Gateway resources.<br><p> <br><p> It is recommended that this resource be used as a template for Gateways. This means that a Gateway is based on the state of the GatewayClass at the time it was created and changes to the GatewayClass or associated parameters are not propagated down to existing Gateways. This recommendation is intended to limit the blast radius of changes to GatewayClass or associated parameters. If implementations choose to propagate GatewayClass changes to existing Gateways, that MUST be clearly documented by the implementation.<br><p> <br><p> Whenever one or more Gateways are using a GatewayClass, implementations SHOULD add the `gateway-exists-finalizer.gateway.networking.k8s.io` finalizer on the associated GatewayClass. This ensures that a GatewayClass associated with a Gateway is not deleted while in use.<br><p> <br><p> GatewayClass is a Cluster level resource.
+     */
     @JsonProperty("spec")
     public void setSpec(GatewayClassSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * GatewayClass describes a class of Gateways available to the user for creating Gateway resources.<br><p> <br><p> It is recommended that this resource be used as a template for Gateways. This means that a Gateway is based on the state of the GatewayClass at the time it was created and changes to the GatewayClass or associated parameters are not propagated down to existing Gateways. This recommendation is intended to limit the blast radius of changes to GatewayClass or associated parameters. If implementations choose to propagate GatewayClass changes to existing Gateways, that MUST be clearly documented by the implementation.<br><p> <br><p> Whenever one or more Gateways are using a GatewayClass, implementations SHOULD add the `gateway-exists-finalizer.gateway.networking.k8s.io` finalizer on the associated GatewayClass. This ensures that a GatewayClass associated with a Gateway is not deleted while in use.<br><p> <br><p> GatewayClass is a Cluster level resource.
+     */
     @JsonProperty("status")
     public GatewayClassStatus getStatus() {
         return status;
     }
 
+    /**
+     * GatewayClass describes a class of Gateways available to the user for creating Gateway resources.<br><p> <br><p> It is recommended that this resource be used as a template for Gateways. This means that a Gateway is based on the state of the GatewayClass at the time it was created and changes to the GatewayClass or associated parameters are not propagated down to existing Gateways. This recommendation is intended to limit the blast radius of changes to GatewayClass or associated parameters. If implementations choose to propagate GatewayClass changes to existing Gateways, that MUST be clearly documented by the implementation.<br><p> <br><p> Whenever one or more Gateways are using a GatewayClass, implementations SHOULD add the `gateway-exists-finalizer.gateway.networking.k8s.io` finalizer on the associated GatewayClass. This ensures that a GatewayClass associated with a Gateway is not deleted while in use.<br><p> <br><p> GatewayClass is a Cluster level resource.
+     */
     @JsonProperty("status")
     public void setStatus(GatewayClassStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/GatewayClassList.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/GatewayClassList.java
index 0d79297e487..e5c19ec18f5 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/GatewayClassList.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/GatewayClassList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GatewayClassList contains a list of GatewayClass
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class GatewayClassList implements Editable<GatewayClassListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.gatewayapi.v1beta1.GatewayClass>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.gatewayapi.v1beta1.GatewayClass> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GatewayClassList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public GatewayClassList(String apiVersion, List<io.fabric8.kubernetes.api.model.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * GatewayClassList contains a list of GatewayClass
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.gatewayapi.v1beta1.GatewayClass> getItems() {
         return items;
     }
 
+    /**
+     * GatewayClassList contains a list of GatewayClass
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.gatewayapi.v1beta1.GatewayClass> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * GatewayClassList contains a list of GatewayClass
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * GatewayClassList contains a list of GatewayClass
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/GatewayList.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/GatewayList.java
index d689abce236..a4479178224 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/GatewayList.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/GatewayList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GatewayList contains a list of Gateways.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class GatewayList implements Editable<GatewayListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.gatewayapi.v1beta1.Gateway>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.gatewayapi.v1beta1.Gateway> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GatewayList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public GatewayList(String apiVersion, List<io.fabric8.kubernetes.api.model.gatew
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * GatewayList contains a list of Gateways.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.gatewayapi.v1beta1.Gateway> getItems() {
         return items;
     }
 
+    /**
+     * GatewayList contains a list of Gateways.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.gatewayapi.v1beta1.Gateway> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * GatewayList contains a list of Gateways.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * GatewayList contains a list of Gateways.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/HTTPRoute.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/HTTPRoute.java
index f33e0611372..6d9d6bdd964 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/HTTPRoute.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/HTTPRoute.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPRoute provides a way to route HTTP requests. This includes the capability to match requests by hostname, path, header, or query param. Filters can be used to specify additional processing steps. Backends specify where matching requests should be routed.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,14 +81,8 @@
 public class HTTPRoute implements Editable<HTTPRouteBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "HTTPRoute";
     @JsonProperty("metadata")
@@ -113,7 +110,7 @@ public HTTPRoute(String apiVersion, String kind, ObjectMeta metadata, HTTPRouteS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -121,7 +118,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -129,7 +126,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -137,38 +134,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * HTTPRoute provides a way to route HTTP requests. This includes the capability to match requests by hostname, path, header, or query param. Filters can be used to specify additional processing steps. Backends specify where matching requests should be routed.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * HTTPRoute provides a way to route HTTP requests. This includes the capability to match requests by hostname, path, header, or query param. Filters can be used to specify additional processing steps. Backends specify where matching requests should be routed.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * HTTPRoute provides a way to route HTTP requests. This includes the capability to match requests by hostname, path, header, or query param. Filters can be used to specify additional processing steps. Backends specify where matching requests should be routed.
+     */
     @JsonProperty("spec")
     public HTTPRouteSpec getSpec() {
         return spec;
     }
 
+    /**
+     * HTTPRoute provides a way to route HTTP requests. This includes the capability to match requests by hostname, path, header, or query param. Filters can be used to specify additional processing steps. Backends specify where matching requests should be routed.
+     */
     @JsonProperty("spec")
     public void setSpec(HTTPRouteSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * HTTPRoute provides a way to route HTTP requests. This includes the capability to match requests by hostname, path, header, or query param. Filters can be used to specify additional processing steps. Backends specify where matching requests should be routed.
+     */
     @JsonProperty("status")
     public HTTPRouteStatus getStatus() {
         return status;
     }
 
+    /**
+     * HTTPRoute provides a way to route HTTP requests. This includes the capability to match requests by hostname, path, header, or query param. Filters can be used to specify additional processing steps. Backends specify where matching requests should be routed.
+     */
     @JsonProperty("status")
     public void setStatus(HTTPRouteStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/HTTPRouteList.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/HTTPRouteList.java
index ab23b8b6b7a..6f9ec90b267 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/HTTPRouteList.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/HTTPRouteList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPRouteList contains a list of HTTPRoute.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class HTTPRouteList implements Editable<HTTPRouteListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.gatewayapi.v1beta1.HTTPRoute>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.gatewayapi.v1beta1.HTTPRoute> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "HTTPRouteList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public HTTPRouteList(String apiVersion, List<io.fabric8.kubernetes.api.model.gat
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * HTTPRouteList contains a list of HTTPRoute.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.gatewayapi.v1beta1.HTTPRoute> getItems() {
         return items;
     }
 
+    /**
+     * HTTPRouteList contains a list of HTTPRoute.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.gatewayapi.v1beta1.HTTPRoute> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * HTTPRouteList contains a list of HTTPRoute.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * HTTPRouteList contains a list of HTTPRoute.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/ReferenceGrant.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/ReferenceGrant.java
index 8ed4b989033..f535da64c75 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/ReferenceGrant.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/ReferenceGrant.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ReferenceGrant identifies kinds of resources in other namespaces that are trusted to reference the specified kinds of resources in the same namespace as the policy.<br><p> <br><p> Each ReferenceGrant can be used to represent a unique trust relationship. Additional Reference Grants can be used to add to the set of trusted sources of inbound references for the namespace they are defined within.<br><p> <br><p> All cross-namespace references in Gateway API (with the exception of cross-namespace Gateway-route attachment) require a ReferenceGrant.<br><p> <br><p> ReferenceGrant is a form of runtime verification allowing users to assert which cross-namespace object references are permitted. Implementations that support ReferenceGrant MUST NOT permit cross-namespace references which have no grant, and MUST respond to the removal of a grant by revoking the access that the grant allowed.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ReferenceGrant implements Editable<ReferenceGrantBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ReferenceGrant";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public ReferenceGrant(String apiVersion, String kind, ObjectMeta metadata, Refer
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ReferenceGrant identifies kinds of resources in other namespaces that are trusted to reference the specified kinds of resources in the same namespace as the policy.<br><p> <br><p> Each ReferenceGrant can be used to represent a unique trust relationship. Additional Reference Grants can be used to add to the set of trusted sources of inbound references for the namespace they are defined within.<br><p> <br><p> All cross-namespace references in Gateway API (with the exception of cross-namespace Gateway-route attachment) require a ReferenceGrant.<br><p> <br><p> ReferenceGrant is a form of runtime verification allowing users to assert which cross-namespace object references are permitted. Implementations that support ReferenceGrant MUST NOT permit cross-namespace references which have no grant, and MUST respond to the removal of a grant by revoking the access that the grant allowed.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ReferenceGrant identifies kinds of resources in other namespaces that are trusted to reference the specified kinds of resources in the same namespace as the policy.<br><p> <br><p> Each ReferenceGrant can be used to represent a unique trust relationship. Additional Reference Grants can be used to add to the set of trusted sources of inbound references for the namespace they are defined within.<br><p> <br><p> All cross-namespace references in Gateway API (with the exception of cross-namespace Gateway-route attachment) require a ReferenceGrant.<br><p> <br><p> ReferenceGrant is a form of runtime verification allowing users to assert which cross-namespace object references are permitted. Implementations that support ReferenceGrant MUST NOT permit cross-namespace references which have no grant, and MUST respond to the removal of a grant by revoking the access that the grant allowed.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ReferenceGrant identifies kinds of resources in other namespaces that are trusted to reference the specified kinds of resources in the same namespace as the policy.<br><p> <br><p> Each ReferenceGrant can be used to represent a unique trust relationship. Additional Reference Grants can be used to add to the set of trusted sources of inbound references for the namespace they are defined within.<br><p> <br><p> All cross-namespace references in Gateway API (with the exception of cross-namespace Gateway-route attachment) require a ReferenceGrant.<br><p> <br><p> ReferenceGrant is a form of runtime verification allowing users to assert which cross-namespace object references are permitted. Implementations that support ReferenceGrant MUST NOT permit cross-namespace references which have no grant, and MUST respond to the removal of a grant by revoking the access that the grant allowed.
+     */
     @JsonProperty("spec")
     public ReferenceGrantSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ReferenceGrant identifies kinds of resources in other namespaces that are trusted to reference the specified kinds of resources in the same namespace as the policy.<br><p> <br><p> Each ReferenceGrant can be used to represent a unique trust relationship. Additional Reference Grants can be used to add to the set of trusted sources of inbound references for the namespace they are defined within.<br><p> <br><p> All cross-namespace references in Gateway API (with the exception of cross-namespace Gateway-route attachment) require a ReferenceGrant.<br><p> <br><p> ReferenceGrant is a form of runtime verification allowing users to assert which cross-namespace object references are permitted. Implementations that support ReferenceGrant MUST NOT permit cross-namespace references which have no grant, and MUST respond to the removal of a grant by revoking the access that the grant allowed.
+     */
     @JsonProperty("spec")
     public void setSpec(ReferenceGrantSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/ReferenceGrantFrom.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/ReferenceGrantFrom.java
index e70be4f7040..3193356a705 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/ReferenceGrantFrom.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/ReferenceGrantFrom.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ReferenceGrantFrom describes trusted namespaces and kinds.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ReferenceGrantFrom(String group, String kind, String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Group is the group of the referent. When empty, the Kubernetes core API group is inferred.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * Group is the group of the referent. When empty, the Kubernetes core API group is inferred.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * Kind is the kind of the referent. Although implementations may support additional resources, the following types are part of the "Core" support level for this field.<br><p> <br><p> When used to permit a SecretObjectReference:<br><p> <br><p> &#42; Gateway<br><p> <br><p> When used to permit a BackendObjectReference:<br><p> <br><p> &#42; GRPCRoute &#42; HTTPRoute &#42; TCPRoute &#42; TLSRoute &#42; UDPRoute
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is the kind of the referent. Although implementations may support additional resources, the following types are part of the "Core" support level for this field.<br><p> <br><p> When used to permit a SecretObjectReference:<br><p> <br><p> &#42; Gateway<br><p> <br><p> When used to permit a BackendObjectReference:<br><p> <br><p> &#42; GRPCRoute &#42; HTTPRoute &#42; TCPRoute &#42; TLSRoute &#42; UDPRoute
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Namespace is the namespace of the referent.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace of the referent.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/ReferenceGrantList.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/ReferenceGrantList.java
index bd4083215e6..34b44d5b4b4 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/ReferenceGrantList.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/ReferenceGrantList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ReferenceGrantList contains a list of ReferenceGrant.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ReferenceGrantList implements Editable<ReferenceGrantListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.gatewayapi.v1beta1.ReferenceGrant>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "gateway.networking.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.gatewayapi.v1beta1.ReferenceGrant> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ReferenceGrantList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ReferenceGrantList(String apiVersion, List<io.fabric8.kubernetes.api.mode
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ReferenceGrantList contains a list of ReferenceGrant.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.gatewayapi.v1beta1.ReferenceGrant> getItems() {
         return items;
     }
 
+    /**
+     * ReferenceGrantList contains a list of ReferenceGrant.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.gatewayapi.v1beta1.ReferenceGrant> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ReferenceGrantList contains a list of ReferenceGrant.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ReferenceGrantList contains a list of ReferenceGrant.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/ReferenceGrantSpec.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/ReferenceGrantSpec.java
index d05dfbb8c31..de0bac4f614 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/ReferenceGrantSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/ReferenceGrantSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ReferenceGrantSpec identifies a cross namespace relationship that is trusted for Gateway API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public ReferenceGrantSpec(List<ReferenceGrantFrom> from, List<ReferenceGrantTo>
         this.to = to;
     }
 
+    /**
+     * From describes the trusted namespaces and kinds that can reference the resources described in "To". Each entry in this list MUST be considered to be an additional place that references can be valid from, or to put this another way, entries MUST be combined using OR.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("from")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ReferenceGrantFrom> getFrom() {
         return from;
     }
 
+    /**
+     * From describes the trusted namespaces and kinds that can reference the resources described in "To". Each entry in this list MUST be considered to be an additional place that references can be valid from, or to put this another way, entries MUST be combined using OR.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("from")
     public void setFrom(List<ReferenceGrantFrom> from) {
         this.from = from;
     }
 
+    /**
+     * To describes the resources that may be referenced by the resources described in "From". Each entry in this list MUST be considered to be an additional place that references can be valid to, or to put this another way, entries MUST be combined using OR.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("to")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ReferenceGrantTo> getTo() {
         return to;
     }
 
+    /**
+     * To describes the resources that may be referenced by the resources described in "From". Each entry in this list MUST be considered to be an additional place that references can be valid to, or to put this another way, entries MUST be combined using OR.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("to")
     public void setTo(List<ReferenceGrantTo> to) {
         this.to = to;
diff --git a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/ReferenceGrantTo.java b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/ReferenceGrantTo.java
index 8897aa622b4..b0ce82869c0 100644
--- a/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/ReferenceGrantTo.java
+++ b/kubernetes-model-generator/kubernetes-model-gatewayapi/src/generated/java/io/fabric8/kubernetes/api/model/gatewayapi/v1beta1/ReferenceGrantTo.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ReferenceGrantTo describes what Kinds are allowed as targets of the references.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ReferenceGrantTo(String group, String kind, String name) {
         this.name = name;
     }
 
+    /**
+     * Group is the group of the referent. When empty, the Kubernetes core API group is inferred.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * Group is the group of the referent. When empty, the Kubernetes core API group is inferred.<br><p> <br><p> Support: Core
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * Kind is the kind of the referent. Although implementations may support additional resources, the following types are part of the "Core" support level for this field:<br><p> <br><p> &#42; Secret when used to permit a SecretObjectReference &#42; Service when used to permit a BackendObjectReference
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is the kind of the referent. Although implementations may support additional resources, the following types are part of the "Core" support level for this field:<br><p> <br><p> &#42; Secret when used to permit a SecretObjectReference &#42; Service when used to permit a BackendObjectReference
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of the referent. When unspecified, this policy refers to all resources of the specified Group and Kind in the local namespace.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the referent. When unspecified, this policy refers to all resources of the specified Group and Kind in the local namespace.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-metrics/src/generated/java/io/fabric8/kubernetes/api/model/metrics/v1beta1/NodeMetrics.java b/kubernetes-model-generator/kubernetes-model-metrics/src/generated/java/io/fabric8/kubernetes/api/model/metrics/v1beta1/NodeMetrics.java
index 9acce43fec5..17186d3f3e1 100644
--- a/kubernetes-model-generator/kubernetes-model-metrics/src/generated/java/io/fabric8/kubernetes/api/model/metrics/v1beta1/NodeMetrics.java
+++ b/kubernetes-model-generator/kubernetes-model-metrics/src/generated/java/io/fabric8/kubernetes/api/model/metrics/v1beta1/NodeMetrics.java
@@ -78,14 +78,8 @@
 public class NodeMetrics implements Editable<NodeMetricsBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "metrics.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "NodeMetrics";
     @JsonProperty("metadata")
@@ -116,33 +110,21 @@ public NodeMetrics(String apiVersion, String kind, ObjectMeta metadata, String t
         this.window = window;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/kubernetes-model-generator/kubernetes-model-metrics/src/generated/java/io/fabric8/kubernetes/api/model/metrics/v1beta1/NodeMetricsList.java b/kubernetes-model-generator/kubernetes-model-metrics/src/generated/java/io/fabric8/kubernetes/api/model/metrics/v1beta1/NodeMetricsList.java
index 51b32b5e786..e354e0ebc2a 100644
--- a/kubernetes-model-generator/kubernetes-model-metrics/src/generated/java/io/fabric8/kubernetes/api/model/metrics/v1beta1/NodeMetricsList.java
+++ b/kubernetes-model-generator/kubernetes-model-metrics/src/generated/java/io/fabric8/kubernetes/api/model/metrics/v1beta1/NodeMetricsList.java
@@ -78,17 +78,11 @@
 public class NodeMetricsList implements Editable<NodeMetricsListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.metrics.v1beta1.NodeMetrics>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "metrics.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.metrics.v1beta1.NodeMetrics> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "NodeMetricsList";
     @JsonProperty("metadata")
@@ -110,17 +104,11 @@ public NodeMetricsList(String apiVersion, List<io.fabric8.kubernetes.api.model.m
         this.metadata = metadata;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
@@ -137,17 +125,11 @@ public void setItems(List<io.fabric8.kubernetes.api.model.metrics.v1beta1.NodeMe
         this.items = items;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/kubernetes-model-generator/kubernetes-model-metrics/src/generated/java/io/fabric8/kubernetes/api/model/metrics/v1beta1/PodMetrics.java b/kubernetes-model-generator/kubernetes-model-metrics/src/generated/java/io/fabric8/kubernetes/api/model/metrics/v1beta1/PodMetrics.java
index fc4bc864abf..96352d00c28 100644
--- a/kubernetes-model-generator/kubernetes-model-metrics/src/generated/java/io/fabric8/kubernetes/api/model/metrics/v1beta1/PodMetrics.java
+++ b/kubernetes-model-generator/kubernetes-model-metrics/src/generated/java/io/fabric8/kubernetes/api/model/metrics/v1beta1/PodMetrics.java
@@ -80,17 +80,11 @@
 public class PodMetrics implements Editable<PodMetricsBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "metrics.k8s.io/v1beta1";
     @JsonProperty("containers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<ContainerMetrics> containers = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodMetrics";
     @JsonProperty("metadata")
@@ -118,17 +112,11 @@ public PodMetrics(String apiVersion, List<ContainerMetrics> containers, String k
         this.window = window;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
@@ -145,17 +133,11 @@ public void setContainers(List<ContainerMetrics> containers) {
         this.containers = containers;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/kubernetes-model-generator/kubernetes-model-metrics/src/generated/java/io/fabric8/kubernetes/api/model/metrics/v1beta1/PodMetricsList.java b/kubernetes-model-generator/kubernetes-model-metrics/src/generated/java/io/fabric8/kubernetes/api/model/metrics/v1beta1/PodMetricsList.java
index 0b1eee15e4f..ebfbaa6ce54 100644
--- a/kubernetes-model-generator/kubernetes-model-metrics/src/generated/java/io/fabric8/kubernetes/api/model/metrics/v1beta1/PodMetricsList.java
+++ b/kubernetes-model-generator/kubernetes-model-metrics/src/generated/java/io/fabric8/kubernetes/api/model/metrics/v1beta1/PodMetricsList.java
@@ -78,17 +78,11 @@
 public class PodMetricsList implements Editable<PodMetricsListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.metrics.v1beta1.PodMetrics>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "metrics.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.metrics.v1beta1.PodMetrics> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodMetricsList";
     @JsonProperty("metadata")
@@ -110,17 +104,11 @@ public PodMetricsList(String apiVersion, List<io.fabric8.kubernetes.api.model.me
         this.metadata = metadata;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
@@ -137,17 +125,11 @@ public void setItems(List<io.fabric8.kubernetes.api.model.metrics.v1beta1.PodMet
         this.items = items;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/HTTPIngressPath.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/HTTPIngressPath.java
index 72a693b3f00..2418817437a 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/HTTPIngressPath.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/HTTPIngressPath.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPIngressPath associates a path with a backend. Incoming urls matching the path are forwarded to the backend.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public HTTPIngressPath(IngressBackend backend, String path, String pathType) {
         this.pathType = pathType;
     }
 
+    /**
+     * HTTPIngressPath associates a path with a backend. Incoming urls matching the path are forwarded to the backend.
+     */
     @JsonProperty("backend")
     public IngressBackend getBackend() {
         return backend;
     }
 
+    /**
+     * HTTPIngressPath associates a path with a backend. Incoming urls matching the path are forwarded to the backend.
+     */
     @JsonProperty("backend")
     public void setBackend(IngressBackend backend) {
         this.backend = backend;
     }
 
+    /**
+     * path is matched against the path of an incoming request. Currently it can contain characters disallowed from the conventional "path" part of a URL as defined by RFC 3986. Paths must begin with a '/' and must be present when using PathType with value "Exact" or "Prefix".
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * path is matched against the path of an incoming request. Currently it can contain characters disallowed from the conventional "path" part of a URL as defined by RFC 3986. Paths must begin with a '/' and must be present when using PathType with value "Exact" or "Prefix".
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * pathType determines the interpretation of the path matching. PathType can be one of the following values: &#42; Exact: Matches the URL path exactly. &#42; Prefix: Matches based on a URL path prefix split by '/'. Matching is<br><p>   done on a path element by element basis. A path element refers is the<br><p>   list of labels in the path split by the '/' separator. A request is a<br><p>   match for path p if every p is an element-wise prefix of p of the<br><p>   request path. Note that if the last element of the path is a substring<br><p>   of the last element in request path, it is not a match (e.g. /foo/bar<br><p>   matches /foo/bar/baz, but does not match /foo/barbaz).<br><p> &#42; ImplementationSpecific: Interpretation of the Path matching is up to<br><p>   the IngressClass. Implementations can treat this as a separate PathType<br><p>   or treat it identically to Prefix or Exact path types.<br><p> Implementations are required to support all path types.
+     */
     @JsonProperty("pathType")
     public String getPathType() {
         return pathType;
     }
 
+    /**
+     * pathType determines the interpretation of the path matching. PathType can be one of the following values: &#42; Exact: Matches the URL path exactly. &#42; Prefix: Matches based on a URL path prefix split by '/'. Matching is<br><p>   done on a path element by element basis. A path element refers is the<br><p>   list of labels in the path split by the '/' separator. A request is a<br><p>   match for path p if every p is an element-wise prefix of p of the<br><p>   request path. Note that if the last element of the path is a substring<br><p>   of the last element in request path, it is not a match (e.g. /foo/bar<br><p>   matches /foo/bar/baz, but does not match /foo/barbaz).<br><p> &#42; ImplementationSpecific: Interpretation of the Path matching is up to<br><p>   the IngressClass. Implementations can treat this as a separate PathType<br><p>   or treat it identically to Prefix or Exact path types.<br><p> Implementations are required to support all path types.
+     */
     @JsonProperty("pathType")
     public void setPathType(String pathType) {
         this.pathType = pathType;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/HTTPIngressRuleValue.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/HTTPIngressRuleValue.java
index 6e0321e24a7..11ac71eb56c 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/HTTPIngressRuleValue.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/HTTPIngressRuleValue.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPIngressRuleValue is a list of http selectors pointing to backends. In the example: http://&lt;host&gt;/&lt;path&gt;?&lt;searchpart&gt; -&gt; backend where where parts of the url correspond to RFC 3986, this resource will be used to match against everything after the last '/' and before the first '?' or '#'.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public HTTPIngressRuleValue(List<HTTPIngressPath> paths) {
         this.paths = paths;
     }
 
+    /**
+     * paths is a collection of paths that map requests to backends.
+     */
     @JsonProperty("paths")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HTTPIngressPath> getPaths() {
         return paths;
     }
 
+    /**
+     * paths is a collection of paths that map requests to backends.
+     */
     @JsonProperty("paths")
     public void setPaths(List<HTTPIngressPath> paths) {
         this.paths = paths;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IPBlock.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IPBlock.java
index 9188eb0229d..c3eccbec133 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IPBlock.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IPBlock.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IPBlock describes a particular CIDR (Ex. "192.168.1.0/24","2001:db8::/64") that is allowed to the pods matched by a NetworkPolicySpec's podSelector. The except entry describes CIDRs that should not be included within this rule.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public IPBlock(String cidr, List<String> except) {
         this.except = except;
     }
 
+    /**
+     * cidr is a string representing the IPBlock Valid examples are "192.168.1.0/24" or "2001:db8::/64"
+     */
     @JsonProperty("cidr")
     public String getCidr() {
         return cidr;
     }
 
+    /**
+     * cidr is a string representing the IPBlock Valid examples are "192.168.1.0/24" or "2001:db8::/64"
+     */
     @JsonProperty("cidr")
     public void setCidr(String cidr) {
         this.cidr = cidr;
     }
 
+    /**
+     * except is a slice of CIDRs that should not be included within an IPBlock Valid examples are "192.168.1.0/24" or "2001:db8::/64" Except values will be rejected if they are outside the cidr range
+     */
     @JsonProperty("except")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getExcept() {
         return except;
     }
 
+    /**
+     * except is a slice of CIDRs that should not be included within an IPBlock Valid examples are "192.168.1.0/24" or "2001:db8::/64" Except values will be rejected if they are outside the cidr range
+     */
     @JsonProperty("except")
     public void setExcept(List<String> except) {
         this.except = except;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/Ingress.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/Ingress.java
index b0bc6ee5924..fb2df9cac5a 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/Ingress.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/Ingress.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable urls, load balance traffic, terminate SSL, offer name based virtual hosting etc.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Ingress implements Editable<IngressBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Ingress";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Ingress(String apiVersion, String kind, ObjectMeta metadata, IngressSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable urls, load balance traffic, terminate SSL, offer name based virtual hosting etc.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable urls, load balance traffic, terminate SSL, offer name based virtual hosting etc.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable urls, load balance traffic, terminate SSL, offer name based virtual hosting etc.
+     */
     @JsonProperty("spec")
     public IngressSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable urls, load balance traffic, terminate SSL, offer name based virtual hosting etc.
+     */
     @JsonProperty("spec")
     public void setSpec(IngressSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable urls, load balance traffic, terminate SSL, offer name based virtual hosting etc.
+     */
     @JsonProperty("status")
     public IngressStatus getStatus() {
         return status;
     }
 
+    /**
+     * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable urls, load balance traffic, terminate SSL, offer name based virtual hosting etc.
+     */
     @JsonProperty("status")
     public void setStatus(IngressStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressBackend.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressBackend.java
index a851ecd4566..1c9316da751 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressBackend.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressBackend.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressBackend describes all endpoints for a given service and port.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public IngressBackend(TypedLocalObjectReference resource, IngressServiceBackend
         this.service = service;
     }
 
+    /**
+     * IngressBackend describes all endpoints for a given service and port.
+     */
     @JsonProperty("resource")
     public TypedLocalObjectReference getResource() {
         return resource;
     }
 
+    /**
+     * IngressBackend describes all endpoints for a given service and port.
+     */
     @JsonProperty("resource")
     public void setResource(TypedLocalObjectReference resource) {
         this.resource = resource;
     }
 
+    /**
+     * IngressBackend describes all endpoints for a given service and port.
+     */
     @JsonProperty("service")
     public IngressServiceBackend getService() {
         return service;
     }
 
+    /**
+     * IngressBackend describes all endpoints for a given service and port.
+     */
     @JsonProperty("service")
     public void setService(IngressServiceBackend service) {
         this.service = service;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressClass.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressClass.java
index f493b44f2b3..87406c5136d 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressClass.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressClass.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressClass represents the class of the Ingress, referenced by the Ingress Spec. The `ingressclass.kubernetes.io/is-default-class` annotation can be used to indicate that an IngressClass should be considered default. When a single IngressClass resource has this annotation set to true, new Ingress resources without a class specified will be assigned this default class.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class IngressClass implements Editable<IngressClassBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "IngressClass";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public IngressClass(String apiVersion, String kind, ObjectMeta metadata, Ingress
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * IngressClass represents the class of the Ingress, referenced by the Ingress Spec. The `ingressclass.kubernetes.io/is-default-class` annotation can be used to indicate that an IngressClass should be considered default. When a single IngressClass resource has this annotation set to true, new Ingress resources without a class specified will be assigned this default class.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * IngressClass represents the class of the Ingress, referenced by the Ingress Spec. The `ingressclass.kubernetes.io/is-default-class` annotation can be used to indicate that an IngressClass should be considered default. When a single IngressClass resource has this annotation set to true, new Ingress resources without a class specified will be assigned this default class.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * IngressClass represents the class of the Ingress, referenced by the Ingress Spec. The `ingressclass.kubernetes.io/is-default-class` annotation can be used to indicate that an IngressClass should be considered default. When a single IngressClass resource has this annotation set to true, new Ingress resources without a class specified will be assigned this default class.
+     */
     @JsonProperty("spec")
     public IngressClassSpec getSpec() {
         return spec;
     }
 
+    /**
+     * IngressClass represents the class of the Ingress, referenced by the Ingress Spec. The `ingressclass.kubernetes.io/is-default-class` annotation can be used to indicate that an IngressClass should be considered default. When a single IngressClass resource has this annotation set to true, new Ingress resources without a class specified will be assigned this default class.
+     */
     @JsonProperty("spec")
     public void setSpec(IngressClassSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressClassList.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressClassList.java
index 5d93e18208c..c2d3c151c27 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressClassList.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressClassList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressClassList is a collection of IngressClasses.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class IngressClassList implements Editable<IngressClassListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.networking.v1.IngressClass>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.networking.v1.IngressClass> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "IngressClassList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public IngressClassList(String apiVersion, List<io.fabric8.kubernetes.api.model.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of IngressClasses.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.networking.v1.IngressClass> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of IngressClasses.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.networking.v1.IngressClass> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * IngressClassList is a collection of IngressClasses.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * IngressClassList is a collection of IngressClasses.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressClassParametersReference.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressClassParametersReference.java
index 51a5eda612b..2a8ec1a9261 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressClassParametersReference.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressClassParametersReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressClassParametersReference identifies an API object. This can be used to specify a cluster or namespace-scoped resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public IngressClassParametersReference(String apiGroup, String kind, String name
         this.scope = scope;
     }
 
+    /**
+     * apiGroup is the group for the resource being referenced. If APIGroup is not specified, the specified Kind must be in the core API group. For any other third-party types, APIGroup is required.
+     */
     @JsonProperty("apiGroup")
     public String getApiGroup() {
         return apiGroup;
     }
 
+    /**
+     * apiGroup is the group for the resource being referenced. If APIGroup is not specified, the specified Kind must be in the core API group. For any other third-party types, APIGroup is required.
+     */
     @JsonProperty("apiGroup")
     public void setApiGroup(String apiGroup) {
         this.apiGroup = apiGroup;
     }
 
+    /**
+     * kind is the type of resource being referenced.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * kind is the type of resource being referenced.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * name is the name of resource being referenced.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of resource being referenced.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * namespace is the namespace of the resource being referenced. This field is required when scope is set to "Namespace" and must be unset when scope is set to "Cluster".
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * namespace is the namespace of the resource being referenced. This field is required when scope is set to "Namespace" and must be unset when scope is set to "Cluster".
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * scope represents if this refers to a cluster or namespace scoped resource. This may be set to "Cluster" (default) or "Namespace".
+     */
     @JsonProperty("scope")
     public String getScope() {
         return scope;
     }
 
+    /**
+     * scope represents if this refers to a cluster or namespace scoped resource. This may be set to "Cluster" (default) or "Namespace".
+     */
     @JsonProperty("scope")
     public void setScope(String scope) {
         this.scope = scope;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressClassSpec.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressClassSpec.java
index d2040fa8caa..17b4bbc1abe 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressClassSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressClassSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressClassSpec provides information about the class of an Ingress.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public IngressClassSpec(String controller, IngressClassParametersReference param
         this.parameters = parameters;
     }
 
+    /**
+     * controller refers to the name of the controller that should handle this class. This allows for different "flavors" that are controlled by the same controller. For example, you may have different parameters for the same implementing controller. This should be specified as a domain-prefixed path no more than 250 characters in length, e.g. "acme.io/ingress-controller". This field is immutable.
+     */
     @JsonProperty("controller")
     public String getController() {
         return controller;
     }
 
+    /**
+     * controller refers to the name of the controller that should handle this class. This allows for different "flavors" that are controlled by the same controller. For example, you may have different parameters for the same implementing controller. This should be specified as a domain-prefixed path no more than 250 characters in length, e.g. "acme.io/ingress-controller". This field is immutable.
+     */
     @JsonProperty("controller")
     public void setController(String controller) {
         this.controller = controller;
     }
 
+    /**
+     * IngressClassSpec provides information about the class of an Ingress.
+     */
     @JsonProperty("parameters")
     public IngressClassParametersReference getParameters() {
         return parameters;
     }
 
+    /**
+     * IngressClassSpec provides information about the class of an Ingress.
+     */
     @JsonProperty("parameters")
     public void setParameters(IngressClassParametersReference parameters) {
         this.parameters = parameters;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressList.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressList.java
index 5b23bf4ed34..37a90a18427 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressList.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressList is a collection of Ingress.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class IngressList implements Editable<IngressListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.networking.v1.Ingress>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.networking.v1.Ingress> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "IngressList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public IngressList(String apiVersion, List<io.fabric8.kubernetes.api.model.netwo
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of Ingress.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.networking.v1.Ingress> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of Ingress.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.networking.v1.Ingress> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * IngressList is a collection of Ingress.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * IngressList is a collection of Ingress.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressLoadBalancerIngress.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressLoadBalancerIngress.java
index 049d435e1b7..d224d99e9dd 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressLoadBalancerIngress.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressLoadBalancerIngress.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressLoadBalancerIngress represents the status of a load-balancer ingress point.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public IngressLoadBalancerIngress(String hostname, String ip, List<IngressPortSt
         this.ports = ports;
     }
 
+    /**
+     * hostname is set for load-balancer ingress points that are DNS based.
+     */
     @JsonProperty("hostname")
     public String getHostname() {
         return hostname;
     }
 
+    /**
+     * hostname is set for load-balancer ingress points that are DNS based.
+     */
     @JsonProperty("hostname")
     public void setHostname(String hostname) {
         this.hostname = hostname;
     }
 
+    /**
+     * ip is set for load-balancer ingress points that are IP based.
+     */
     @JsonProperty("ip")
     public String getIp() {
         return ip;
     }
 
+    /**
+     * ip is set for load-balancer ingress points that are IP based.
+     */
     @JsonProperty("ip")
     public void setIp(String ip) {
         this.ip = ip;
     }
 
+    /**
+     * ports provides information about the ports exposed by this LoadBalancer.
+     */
     @JsonProperty("ports")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IngressPortStatus> getPorts() {
         return ports;
     }
 
+    /**
+     * ports provides information about the ports exposed by this LoadBalancer.
+     */
     @JsonProperty("ports")
     public void setPorts(List<IngressPortStatus> ports) {
         this.ports = ports;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressLoadBalancerStatus.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressLoadBalancerStatus.java
index 0374b937361..bd5024a1922 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressLoadBalancerStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressLoadBalancerStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressLoadBalancerStatus represents the status of a load-balancer.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public IngressLoadBalancerStatus(List<IngressLoadBalancerIngress> ingress) {
         this.ingress = ingress;
     }
 
+    /**
+     * ingress is a list containing ingress points for the load-balancer.
+     */
     @JsonProperty("ingress")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IngressLoadBalancerIngress> getIngress() {
         return ingress;
     }
 
+    /**
+     * ingress is a list containing ingress points for the load-balancer.
+     */
     @JsonProperty("ingress")
     public void setIngress(List<IngressLoadBalancerIngress> ingress) {
         this.ingress = ingress;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressPortStatus.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressPortStatus.java
index fce6b7110d2..82e01483f34 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressPortStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressPortStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressPortStatus represents the error condition of a service port
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public IngressPortStatus(String error, Integer port, String protocol) {
         this.protocol = protocol;
     }
 
+    /**
+     * error is to record the problem with the service port The format of the error shall comply with the following rules: - built-in error values shall be specified in this file and those shall use<br><p>   CamelCase names<br><p> - cloud provider specific error values must have names that comply with the<br><p>   format foo.example.com/CamelCase.
+     */
     @JsonProperty("error")
     public String getError() {
         return error;
     }
 
+    /**
+     * error is to record the problem with the service port The format of the error shall comply with the following rules: - built-in error values shall be specified in this file and those shall use<br><p>   CamelCase names<br><p> - cloud provider specific error values must have names that comply with the<br><p>   format foo.example.com/CamelCase.
+     */
     @JsonProperty("error")
     public void setError(String error) {
         this.error = error;
     }
 
+    /**
+     * port is the port number of the ingress port.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * port is the port number of the ingress port.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * protocol is the protocol of the ingress port. The supported values are: "TCP", "UDP", "SCTP"
+     */
     @JsonProperty("protocol")
     public String getProtocol() {
         return protocol;
     }
 
+    /**
+     * protocol is the protocol of the ingress port. The supported values are: "TCP", "UDP", "SCTP"
+     */
     @JsonProperty("protocol")
     public void setProtocol(String protocol) {
         this.protocol = protocol;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressRule.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressRule.java
index 6019d33350e..ada9671907d 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressRule.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressRule.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressRule represents the rules mapping the paths under a specified host to the related backend services. Incoming requests are first evaluated for a host match, then routed to the backend associated with the matching IngressRuleValue.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public IngressRule(String host, HTTPIngressRuleValue http) {
         this.http = http;
     }
 
+    /**
+     * host is the fully qualified domain name of a network host, as defined by RFC 3986. Note the following deviations from the "host" part of the URI as defined in RFC 3986: 1. IPs are not allowed. Currently an IngressRuleValue can only apply to<br><p>    the IP in the Spec of the parent Ingress.<br><p> 2. The `:` delimiter is not respected because ports are not allowed.<br><p> 	  Currently the port of an Ingress is implicitly :80 for http and<br><p> 	  :443 for https.<br><p> Both these may change in the future. Incoming requests are matched against the host before the IngressRuleValue. If the host is unspecified, the Ingress routes all traffic based on the specified IngressRuleValue.<br><p> <br><p> host can be "precise" which is a domain name without the terminating dot of a network host (e.g. "foo.bar.com") or "wildcard", which is a domain name prefixed with a single wildcard label (e.g. "&#42;.foo.com"). The wildcard character '&#42;' must appear by itself as the first DNS label and matches only a single label. You cannot have a wildcard label by itself (e.g. Host == "&#42;"). Requests will be matched against the Host field in the following way: 1. If host is precise, the request matches this rule if the http host header is equal to Host. 2. If host is a wildcard, then the request matches this rule if the http host header is to equal to the suffix (removing the first label) of the wildcard rule.
+     */
     @JsonProperty("host")
     public String getHost() {
         return host;
     }
 
+    /**
+     * host is the fully qualified domain name of a network host, as defined by RFC 3986. Note the following deviations from the "host" part of the URI as defined in RFC 3986: 1. IPs are not allowed. Currently an IngressRuleValue can only apply to<br><p>    the IP in the Spec of the parent Ingress.<br><p> 2. The `:` delimiter is not respected because ports are not allowed.<br><p> 	  Currently the port of an Ingress is implicitly :80 for http and<br><p> 	  :443 for https.<br><p> Both these may change in the future. Incoming requests are matched against the host before the IngressRuleValue. If the host is unspecified, the Ingress routes all traffic based on the specified IngressRuleValue.<br><p> <br><p> host can be "precise" which is a domain name without the terminating dot of a network host (e.g. "foo.bar.com") or "wildcard", which is a domain name prefixed with a single wildcard label (e.g. "&#42;.foo.com"). The wildcard character '&#42;' must appear by itself as the first DNS label and matches only a single label. You cannot have a wildcard label by itself (e.g. Host == "&#42;"). Requests will be matched against the Host field in the following way: 1. If host is precise, the request matches this rule if the http host header is equal to Host. 2. If host is a wildcard, then the request matches this rule if the http host header is to equal to the suffix (removing the first label) of the wildcard rule.
+     */
     @JsonProperty("host")
     public void setHost(String host) {
         this.host = host;
     }
 
+    /**
+     * IngressRule represents the rules mapping the paths under a specified host to the related backend services. Incoming requests are first evaluated for a host match, then routed to the backend associated with the matching IngressRuleValue.
+     */
     @JsonProperty("http")
     public HTTPIngressRuleValue getHttp() {
         return http;
     }
 
+    /**
+     * IngressRule represents the rules mapping the paths under a specified host to the related backend services. Incoming requests are first evaluated for a host match, then routed to the backend associated with the matching IngressRuleValue.
+     */
     @JsonProperty("http")
     public void setHttp(HTTPIngressRuleValue http) {
         this.http = http;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressServiceBackend.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressServiceBackend.java
index 122b4bd2bbf..7d19d869972 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressServiceBackend.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressServiceBackend.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressServiceBackend references a Kubernetes Service as a Backend.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public IngressServiceBackend(String name, ServiceBackendPort port) {
         this.port = port;
     }
 
+    /**
+     * name is the referenced service. The service must exist in the same namespace as the Ingress object.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the referenced service. The service must exist in the same namespace as the Ingress object.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * IngressServiceBackend references a Kubernetes Service as a Backend.
+     */
     @JsonProperty("port")
     public ServiceBackendPort getPort() {
         return port;
     }
 
+    /**
+     * IngressServiceBackend references a Kubernetes Service as a Backend.
+     */
     @JsonProperty("port")
     public void setPort(ServiceBackendPort port) {
         this.port = port;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressSpec.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressSpec.java
index 3c8bd0196bb..d74b885dd60 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressSpec describes the Ingress the user wishes to exist.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,43 +97,67 @@ public IngressSpec(IngressBackend defaultBackend, String ingressClassName, List<
         this.tls = tls;
     }
 
+    /**
+     * IngressSpec describes the Ingress the user wishes to exist.
+     */
     @JsonProperty("defaultBackend")
     public IngressBackend getDefaultBackend() {
         return defaultBackend;
     }
 
+    /**
+     * IngressSpec describes the Ingress the user wishes to exist.
+     */
     @JsonProperty("defaultBackend")
     public void setDefaultBackend(IngressBackend defaultBackend) {
         this.defaultBackend = defaultBackend;
     }
 
+    /**
+     * ingressClassName is the name of an IngressClass cluster resource. Ingress controller implementations use this field to know whether they should be serving this Ingress resource, by a transitive connection (controller -&gt; IngressClass -&gt; Ingress resource). Although the `kubernetes.io/ingress.class` annotation (simple constant name) was never formally defined, it was widely supported by Ingress controllers to create a direct binding between Ingress controller and Ingress resources. Newly created Ingress resources should prefer using the field. However, even though the annotation is officially deprecated, for backwards compatibility reasons, ingress controllers should still honor that annotation if present.
+     */
     @JsonProperty("ingressClassName")
     public String getIngressClassName() {
         return ingressClassName;
     }
 
+    /**
+     * ingressClassName is the name of an IngressClass cluster resource. Ingress controller implementations use this field to know whether they should be serving this Ingress resource, by a transitive connection (controller -&gt; IngressClass -&gt; Ingress resource). Although the `kubernetes.io/ingress.class` annotation (simple constant name) was never formally defined, it was widely supported by Ingress controllers to create a direct binding between Ingress controller and Ingress resources. Newly created Ingress resources should prefer using the field. However, even though the annotation is officially deprecated, for backwards compatibility reasons, ingress controllers should still honor that annotation if present.
+     */
     @JsonProperty("ingressClassName")
     public void setIngressClassName(String ingressClassName) {
         this.ingressClassName = ingressClassName;
     }
 
+    /**
+     * rules is a list of host rules used to configure the Ingress. If unspecified, or no rule matches, all traffic is sent to the default backend.
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IngressRule> getRules() {
         return rules;
     }
 
+    /**
+     * rules is a list of host rules used to configure the Ingress. If unspecified, or no rule matches, all traffic is sent to the default backend.
+     */
     @JsonProperty("rules")
     public void setRules(List<IngressRule> rules) {
         this.rules = rules;
     }
 
+    /**
+     * tls represents the TLS configuration. Currently the Ingress only supports a single TLS port, 443. If multiple members of this list specify different hosts, they will be multiplexed on the same port according to the hostname specified through the SNI TLS extension, if the ingress controller fulfilling the ingress supports SNI.
+     */
     @JsonProperty("tls")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IngressTLS> getTls() {
         return tls;
     }
 
+    /**
+     * tls represents the TLS configuration. Currently the Ingress only supports a single TLS port, 443. If multiple members of this list specify different hosts, they will be multiplexed on the same port according to the hostname specified through the SNI TLS extension, if the ingress controller fulfilling the ingress supports SNI.
+     */
     @JsonProperty("tls")
     public void setTls(List<IngressTLS> tls) {
         this.tls = tls;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressStatus.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressStatus.java
index 98c1a41c6b6..cc1c6339dd3 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressStatus describe the current state of the Ingress.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public IngressStatus(IngressLoadBalancerStatus loadBalancer) {
         this.loadBalancer = loadBalancer;
     }
 
+    /**
+     * IngressStatus describe the current state of the Ingress.
+     */
     @JsonProperty("loadBalancer")
     public IngressLoadBalancerStatus getLoadBalancer() {
         return loadBalancer;
     }
 
+    /**
+     * IngressStatus describe the current state of the Ingress.
+     */
     @JsonProperty("loadBalancer")
     public void setLoadBalancer(IngressLoadBalancerStatus loadBalancer) {
         this.loadBalancer = loadBalancer;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressTLS.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressTLS.java
index 9c53b88bbe6..971ab4bd4a5 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressTLS.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/IngressTLS.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressTLS describes the transport layer security associated with an ingress.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public IngressTLS(List<String> hosts, String secretName) {
         this.secretName = secretName;
     }
 
+    /**
+     * hosts is a list of hosts included in the TLS certificate. The values in this list must match the name/s used in the tlsSecret. Defaults to the wildcard host setting for the loadbalancer controller fulfilling this Ingress, if left unspecified.
+     */
     @JsonProperty("hosts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getHosts() {
         return hosts;
     }
 
+    /**
+     * hosts is a list of hosts included in the TLS certificate. The values in this list must match the name/s used in the tlsSecret. Defaults to the wildcard host setting for the loadbalancer controller fulfilling this Ingress, if left unspecified.
+     */
     @JsonProperty("hosts")
     public void setHosts(List<String> hosts) {
         this.hosts = hosts;
     }
 
+    /**
+     * secretName is the name of the secret used to terminate TLS traffic on port 443. Field is left optional to allow TLS routing based on SNI hostname alone. If the SNI host in a listener conflicts with the "Host" header field used by an IngressRule, the SNI host is used for termination and value of the "Host" header is used for routing.
+     */
     @JsonProperty("secretName")
     public String getSecretName() {
         return secretName;
     }
 
+    /**
+     * secretName is the name of the secret used to terminate TLS traffic on port 443. Field is left optional to allow TLS routing based on SNI hostname alone. If the SNI host in a listener conflicts with the "Host" header field used by an IngressRule, the SNI host is used for termination and value of the "Host" header is used for routing.
+     */
     @JsonProperty("secretName")
     public void setSecretName(String secretName) {
         this.secretName = secretName;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/NetworkPolicy.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/NetworkPolicy.java
index 017beb700fb..9515a6bbe42 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/NetworkPolicy.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/NetworkPolicy.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkPolicy describes what network traffic is allowed for a set of Pods
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class NetworkPolicy implements Editable<NetworkPolicyBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "NetworkPolicy";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public NetworkPolicy(String apiVersion, String kind, ObjectMeta metadata, Networ
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * NetworkPolicy describes what network traffic is allowed for a set of Pods
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * NetworkPolicy describes what network traffic is allowed for a set of Pods
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * NetworkPolicy describes what network traffic is allowed for a set of Pods
+     */
     @JsonProperty("spec")
     public NetworkPolicySpec getSpec() {
         return spec;
     }
 
+    /**
+     * NetworkPolicy describes what network traffic is allowed for a set of Pods
+     */
     @JsonProperty("spec")
     public void setSpec(NetworkPolicySpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/NetworkPolicyEgressRule.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/NetworkPolicyEgressRule.java
index b202d36ebc0..3af3055f348 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/NetworkPolicyEgressRule.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/NetworkPolicyEgressRule.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkPolicyEgressRule describes a particular set of traffic that is allowed out of pods matched by a NetworkPolicySpec's podSelector. The traffic must match both ports and to. This type is beta-level in 1.8
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public NetworkPolicyEgressRule(List<NetworkPolicyPort> ports, List<NetworkPolicy
         this.to = to;
     }
 
+    /**
+     * ports is a list of destination ports for outgoing traffic. Each item in this list is combined using a logical OR. If this field is empty or missing, this rule matches all ports (traffic not restricted by port). If this field is present and contains at least one item, then this rule allows traffic only if the traffic matches at least one port in the list.
+     */
     @JsonProperty("ports")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NetworkPolicyPort> getPorts() {
         return ports;
     }
 
+    /**
+     * ports is a list of destination ports for outgoing traffic. Each item in this list is combined using a logical OR. If this field is empty or missing, this rule matches all ports (traffic not restricted by port). If this field is present and contains at least one item, then this rule allows traffic only if the traffic matches at least one port in the list.
+     */
     @JsonProperty("ports")
     public void setPorts(List<NetworkPolicyPort> ports) {
         this.ports = ports;
     }
 
+    /**
+     * to is a list of destinations for outgoing traffic of pods selected for this rule. Items in this list are combined using a logical OR operation. If this field is empty or missing, this rule matches all destinations (traffic not restricted by destination). If this field is present and contains at least one item, this rule allows traffic only if the traffic matches at least one item in the to list.
+     */
     @JsonProperty("to")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NetworkPolicyPeer> getTo() {
         return to;
     }
 
+    /**
+     * to is a list of destinations for outgoing traffic of pods selected for this rule. Items in this list are combined using a logical OR operation. If this field is empty or missing, this rule matches all destinations (traffic not restricted by destination). If this field is present and contains at least one item, this rule allows traffic only if the traffic matches at least one item in the to list.
+     */
     @JsonProperty("to")
     public void setTo(List<NetworkPolicyPeer> to) {
         this.to = to;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/NetworkPolicyIngressRule.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/NetworkPolicyIngressRule.java
index 2984231071e..b8b82963924 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/NetworkPolicyIngressRule.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/NetworkPolicyIngressRule.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkPolicyIngressRule describes a particular set of traffic that is allowed to the pods matched by a NetworkPolicySpec's podSelector. The traffic must match both ports and from.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public NetworkPolicyIngressRule(List<NetworkPolicyPeer> from, List<NetworkPolicy
         this.ports = ports;
     }
 
+    /**
+     * from is a list of sources which should be able to access the pods selected for this rule. Items in this list are combined using a logical OR operation. If this field is empty or missing, this rule matches all sources (traffic not restricted by source). If this field is present and contains at least one item, this rule allows traffic only if the traffic matches at least one item in the from list.
+     */
     @JsonProperty("from")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NetworkPolicyPeer> getFrom() {
         return from;
     }
 
+    /**
+     * from is a list of sources which should be able to access the pods selected for this rule. Items in this list are combined using a logical OR operation. If this field is empty or missing, this rule matches all sources (traffic not restricted by source). If this field is present and contains at least one item, this rule allows traffic only if the traffic matches at least one item in the from list.
+     */
     @JsonProperty("from")
     public void setFrom(List<NetworkPolicyPeer> from) {
         this.from = from;
     }
 
+    /**
+     * ports is a list of ports which should be made accessible on the pods selected for this rule. Each item in this list is combined using a logical OR. If this field is empty or missing, this rule matches all ports (traffic not restricted by port). If this field is present and contains at least one item, then this rule allows traffic only if the traffic matches at least one port in the list.
+     */
     @JsonProperty("ports")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NetworkPolicyPort> getPorts() {
         return ports;
     }
 
+    /**
+     * ports is a list of ports which should be made accessible on the pods selected for this rule. Each item in this list is combined using a logical OR. If this field is empty or missing, this rule matches all ports (traffic not restricted by port). If this field is present and contains at least one item, then this rule allows traffic only if the traffic matches at least one port in the list.
+     */
     @JsonProperty("ports")
     public void setPorts(List<NetworkPolicyPort> ports) {
         this.ports = ports;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/NetworkPolicyList.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/NetworkPolicyList.java
index 4259a0336ed..43d6a7c0239 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/NetworkPolicyList.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/NetworkPolicyList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkPolicyList is a list of NetworkPolicy objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class NetworkPolicyList implements Editable<NetworkPolicyListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.networking.v1.NetworkPolicy>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.networking.v1.NetworkPolicy> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "NetworkPolicyList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public NetworkPolicyList(String apiVersion, List<io.fabric8.kubernetes.api.model
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is a list of schema objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.networking.v1.NetworkPolicy> getItems() {
         return items;
     }
 
+    /**
+     * items is a list of schema objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.networking.v1.NetworkPolicy> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * NetworkPolicyList is a list of NetworkPolicy objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * NetworkPolicyList is a list of NetworkPolicy objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/NetworkPolicyPeer.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/NetworkPolicyPeer.java
index 93919dc0004..ea8165b5da8 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/NetworkPolicyPeer.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/NetworkPolicyPeer.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkPolicyPeer describes a peer to allow traffic to/from. Only certain combinations of fields are allowed
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public NetworkPolicyPeer(IPBlock ipBlock, LabelSelector namespaceSelector, Label
         this.podSelector = podSelector;
     }
 
+    /**
+     * NetworkPolicyPeer describes a peer to allow traffic to/from. Only certain combinations of fields are allowed
+     */
     @JsonProperty("ipBlock")
     public IPBlock getIpBlock() {
         return ipBlock;
     }
 
+    /**
+     * NetworkPolicyPeer describes a peer to allow traffic to/from. Only certain combinations of fields are allowed
+     */
     @JsonProperty("ipBlock")
     public void setIpBlock(IPBlock ipBlock) {
         this.ipBlock = ipBlock;
     }
 
+    /**
+     * NetworkPolicyPeer describes a peer to allow traffic to/from. Only certain combinations of fields are allowed
+     */
     @JsonProperty("namespaceSelector")
     public LabelSelector getNamespaceSelector() {
         return namespaceSelector;
     }
 
+    /**
+     * NetworkPolicyPeer describes a peer to allow traffic to/from. Only certain combinations of fields are allowed
+     */
     @JsonProperty("namespaceSelector")
     public void setNamespaceSelector(LabelSelector namespaceSelector) {
         this.namespaceSelector = namespaceSelector;
     }
 
+    /**
+     * NetworkPolicyPeer describes a peer to allow traffic to/from. Only certain combinations of fields are allowed
+     */
     @JsonProperty("podSelector")
     public LabelSelector getPodSelector() {
         return podSelector;
     }
 
+    /**
+     * NetworkPolicyPeer describes a peer to allow traffic to/from. Only certain combinations of fields are allowed
+     */
     @JsonProperty("podSelector")
     public void setPodSelector(LabelSelector podSelector) {
         this.podSelector = podSelector;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/NetworkPolicyPort.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/NetworkPolicyPort.java
index 8a9f6682130..32e3706d023 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/NetworkPolicyPort.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/NetworkPolicyPort.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkPolicyPort describes a port to allow traffic on
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public NetworkPolicyPort(Integer endPort, IntOrString port, String protocol) {
         this.protocol = protocol;
     }
 
+    /**
+     * endPort indicates that the range of ports from port to endPort if set, inclusive, should be allowed by the policy. This field cannot be defined if the port field is not defined or if the port field is defined as a named (string) port. The endPort must be equal or greater than port.
+     */
     @JsonProperty("endPort")
     public Integer getEndPort() {
         return endPort;
     }
 
+    /**
+     * endPort indicates that the range of ports from port to endPort if set, inclusive, should be allowed by the policy. This field cannot be defined if the port field is not defined or if the port field is defined as a named (string) port. The endPort must be equal or greater than port.
+     */
     @JsonProperty("endPort")
     public void setEndPort(Integer endPort) {
         this.endPort = endPort;
     }
 
+    /**
+     * NetworkPolicyPort describes a port to allow traffic on
+     */
     @JsonProperty("port")
     public IntOrString getPort() {
         return port;
     }
 
+    /**
+     * NetworkPolicyPort describes a port to allow traffic on
+     */
     @JsonProperty("port")
     public void setPort(IntOrString port) {
         this.port = port;
     }
 
+    /**
+     * protocol represents the protocol (TCP, UDP, or SCTP) which traffic must match. If not specified, this field defaults to TCP.
+     */
     @JsonProperty("protocol")
     public String getProtocol() {
         return protocol;
     }
 
+    /**
+     * protocol represents the protocol (TCP, UDP, or SCTP) which traffic must match. If not specified, this field defaults to TCP.
+     */
     @JsonProperty("protocol")
     public void setProtocol(String protocol) {
         this.protocol = protocol;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/NetworkPolicySpec.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/NetworkPolicySpec.java
index 5379a3bfe5e..7b813c02a7a 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/NetworkPolicySpec.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/NetworkPolicySpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkPolicySpec provides the specification of a NetworkPolicy
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,44 +98,68 @@ public NetworkPolicySpec(List<NetworkPolicyEgressRule> egress, List<NetworkPolic
         this.policyTypes = policyTypes;
     }
 
+    /**
+     * egress is a list of egress rules to be applied to the selected pods. Outgoing traffic is allowed if there are no NetworkPolicies selecting the pod (and cluster policy otherwise allows the traffic), OR if the traffic matches at least one egress rule across all of the NetworkPolicy objects whose podSelector matches the pod. If this field is empty then this NetworkPolicy limits all outgoing traffic (and serves solely to ensure that the pods it selects are isolated by default). This field is beta-level in 1.8
+     */
     @JsonProperty("egress")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NetworkPolicyEgressRule> getEgress() {
         return egress;
     }
 
+    /**
+     * egress is a list of egress rules to be applied to the selected pods. Outgoing traffic is allowed if there are no NetworkPolicies selecting the pod (and cluster policy otherwise allows the traffic), OR if the traffic matches at least one egress rule across all of the NetworkPolicy objects whose podSelector matches the pod. If this field is empty then this NetworkPolicy limits all outgoing traffic (and serves solely to ensure that the pods it selects are isolated by default). This field is beta-level in 1.8
+     */
     @JsonProperty("egress")
     public void setEgress(List<NetworkPolicyEgressRule> egress) {
         this.egress = egress;
     }
 
+    /**
+     * ingress is a list of ingress rules to be applied to the selected pods. Traffic is allowed to a pod if there are no NetworkPolicies selecting the pod (and cluster policy otherwise allows the traffic), OR if the traffic source is the pod's local node, OR if the traffic matches at least one ingress rule across all of the NetworkPolicy objects whose podSelector matches the pod. If this field is empty then this NetworkPolicy does not allow any traffic (and serves solely to ensure that the pods it selects are isolated by default)
+     */
     @JsonProperty("ingress")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NetworkPolicyIngressRule> getIngress() {
         return ingress;
     }
 
+    /**
+     * ingress is a list of ingress rules to be applied to the selected pods. Traffic is allowed to a pod if there are no NetworkPolicies selecting the pod (and cluster policy otherwise allows the traffic), OR if the traffic source is the pod's local node, OR if the traffic matches at least one ingress rule across all of the NetworkPolicy objects whose podSelector matches the pod. If this field is empty then this NetworkPolicy does not allow any traffic (and serves solely to ensure that the pods it selects are isolated by default)
+     */
     @JsonProperty("ingress")
     public void setIngress(List<NetworkPolicyIngressRule> ingress) {
         this.ingress = ingress;
     }
 
+    /**
+     * NetworkPolicySpec provides the specification of a NetworkPolicy
+     */
     @JsonProperty("podSelector")
     public LabelSelector getPodSelector() {
         return podSelector;
     }
 
+    /**
+     * NetworkPolicySpec provides the specification of a NetworkPolicy
+     */
     @JsonProperty("podSelector")
     public void setPodSelector(LabelSelector podSelector) {
         this.podSelector = podSelector;
     }
 
+    /**
+     * policyTypes is a list of rule types that the NetworkPolicy relates to. Valid options are ["Ingress"], ["Egress"], or ["Ingress", "Egress"]. If this field is not specified, it will default based on the existence of ingress or egress rules; policies that contain an egress section are assumed to affect egress, and all policies (whether or not they contain an ingress section) are assumed to affect ingress. If you want to write an egress-only policy, you must explicitly specify policyTypes [ "Egress" ]. Likewise, if you want to write a policy that specifies that no egress is allowed, you must specify a policyTypes value that include "Egress" (since such a policy would not include an egress section and would otherwise default to just [ "Ingress" ]). This field is beta-level in 1.8
+     */
     @JsonProperty("policyTypes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPolicyTypes() {
         return policyTypes;
     }
 
+    /**
+     * policyTypes is a list of rule types that the NetworkPolicy relates to. Valid options are ["Ingress"], ["Egress"], or ["Ingress", "Egress"]. If this field is not specified, it will default based on the existence of ingress or egress rules; policies that contain an egress section are assumed to affect egress, and all policies (whether or not they contain an ingress section) are assumed to affect ingress. If you want to write an egress-only policy, you must explicitly specify policyTypes [ "Egress" ]. Likewise, if you want to write a policy that specifies that no egress is allowed, you must specify a policyTypes value that include "Egress" (since such a policy would not include an egress section and would otherwise default to just [ "Ingress" ]). This field is beta-level in 1.8
+     */
     @JsonProperty("policyTypes")
     public void setPolicyTypes(List<String> policyTypes) {
         this.policyTypes = policyTypes;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/ServiceBackendPort.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/ServiceBackendPort.java
index 1b7bd56c5d5..923b7ca6634 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/ServiceBackendPort.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1/ServiceBackendPort.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceBackendPort is the service port being referenced.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ServiceBackendPort(String name, Integer number) {
         this.number = number;
     }
 
+    /**
+     * name is the name of the port on the Service. This is a mutually exclusive setting with "Number".
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the port on the Service. This is a mutually exclusive setting with "Number".
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * number is the numerical port number (e.g. 80) on the Service. This is a mutually exclusive setting with "Name".
+     */
     @JsonProperty("number")
     public Integer getNumber() {
         return number;
     }
 
+    /**
+     * number is the numerical port number (e.g. 80) on the Service. This is a mutually exclusive setting with "Name".
+     */
     @JsonProperty("number")
     public void setNumber(Integer number) {
         this.number = number;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/HTTPIngressPath.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/HTTPIngressPath.java
index 1711eaacd62..fd318af60d3 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/HTTPIngressPath.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/HTTPIngressPath.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPIngressPath associates a path with a backend. Incoming urls matching the path are forwarded to the backend.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public HTTPIngressPath(IngressBackend backend, String path, String pathType) {
         this.pathType = pathType;
     }
 
+    /**
+     * HTTPIngressPath associates a path with a backend. Incoming urls matching the path are forwarded to the backend.
+     */
     @JsonProperty("backend")
     public IngressBackend getBackend() {
         return backend;
     }
 
+    /**
+     * HTTPIngressPath associates a path with a backend. Incoming urls matching the path are forwarded to the backend.
+     */
     @JsonProperty("backend")
     public void setBackend(IngressBackend backend) {
         this.backend = backend;
     }
 
+    /**
+     * Path is matched against the path of an incoming request. Currently it can contain characters disallowed from the conventional "path" part of a URL as defined by RFC 3986. Paths must begin with a '/'. When unspecified, all paths from incoming requests are matched.
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Path is matched against the path of an incoming request. Currently it can contain characters disallowed from the conventional "path" part of a URL as defined by RFC 3986. Paths must begin with a '/'. When unspecified, all paths from incoming requests are matched.
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * PathType determines the interpretation of the Path matching. PathType can be one of the following values: &#42; Exact: Matches the URL path exactly. &#42; Prefix: Matches based on a URL path prefix split by '/'. Matching is<br><p>   done on a path element by element basis. A path element refers is the<br><p>   list of labels in the path split by the '/' separator. A request is a<br><p>   match for path p if every p is an element-wise prefix of p of the<br><p>   request path. Note that if the last element of the path is a substring<br><p>   of the last element in request path, it is not a match (e.g. /foo/bar<br><p>   matches /foo/bar/baz, but does not match /foo/barbaz).<br><p> &#42; ImplementationSpecific: Interpretation of the Path matching is up to<br><p>   the IngressClass. Implementations can treat this as a separate PathType<br><p>   or treat it identically to Prefix or Exact path types.<br><p> Implementations are required to support all path types. Defaults to ImplementationSpecific.
+     */
     @JsonProperty("pathType")
     public String getPathType() {
         return pathType;
     }
 
+    /**
+     * PathType determines the interpretation of the Path matching. PathType can be one of the following values: &#42; Exact: Matches the URL path exactly. &#42; Prefix: Matches based on a URL path prefix split by '/'. Matching is<br><p>   done on a path element by element basis. A path element refers is the<br><p>   list of labels in the path split by the '/' separator. A request is a<br><p>   match for path p if every p is an element-wise prefix of p of the<br><p>   request path. Note that if the last element of the path is a substring<br><p>   of the last element in request path, it is not a match (e.g. /foo/bar<br><p>   matches /foo/bar/baz, but does not match /foo/barbaz).<br><p> &#42; ImplementationSpecific: Interpretation of the Path matching is up to<br><p>   the IngressClass. Implementations can treat this as a separate PathType<br><p>   or treat it identically to Prefix or Exact path types.<br><p> Implementations are required to support all path types. Defaults to ImplementationSpecific.
+     */
     @JsonProperty("pathType")
     public void setPathType(String pathType) {
         this.pathType = pathType;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/HTTPIngressRuleValue.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/HTTPIngressRuleValue.java
index 2b8902de252..ad48ac0b7f3 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/HTTPIngressRuleValue.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/HTTPIngressRuleValue.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPIngressRuleValue is a list of http selectors pointing to backends. In the example: http://&lt;host&gt;/&lt;path&gt;?&lt;searchpart&gt; -&gt; backend where where parts of the url correspond to RFC 3986, this resource will be used to match against everything after the last '/' and before the first '?' or '#'.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public HTTPIngressRuleValue(List<HTTPIngressPath> paths) {
         this.paths = paths;
     }
 
+    /**
+     * A collection of paths that map requests to backends.
+     */
     @JsonProperty("paths")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HTTPIngressPath> getPaths() {
         return paths;
     }
 
+    /**
+     * A collection of paths that map requests to backends.
+     */
     @JsonProperty("paths")
     public void setPaths(List<HTTPIngressPath> paths) {
         this.paths = paths;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IPAddress.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IPAddress.java
index 6114dd19356..dc1864b87cd 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IPAddress.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IPAddress.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IPAddress represents a single IP of a single IP Family. The object is designed to be used by APIs that operate on IP addresses. The object is used by the Service core API for allocation of IP addresses. An IP address can be represented in different formats, to guarantee the uniqueness of the IP, the name of the object is the IP address in canonical format, four decimal digits separated by dots suppressing leading zeros for IPv4 and the representation defined by RFC 5952 for IPv6. Valid: 192.168.1.5 or 2001:db8::1 or 2001:db8:aaaa:bbbb:cccc:dddd:eeee:1 Invalid: 10.01.2.3 or 2001:db8:0:0:0::1
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class IPAddress implements Editable<IPAddressBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "IPAddress";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public IPAddress(String apiVersion, String kind, ObjectMeta metadata, IPAddressS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * IPAddress represents a single IP of a single IP Family. The object is designed to be used by APIs that operate on IP addresses. The object is used by the Service core API for allocation of IP addresses. An IP address can be represented in different formats, to guarantee the uniqueness of the IP, the name of the object is the IP address in canonical format, four decimal digits separated by dots suppressing leading zeros for IPv4 and the representation defined by RFC 5952 for IPv6. Valid: 192.168.1.5 or 2001:db8::1 or 2001:db8:aaaa:bbbb:cccc:dddd:eeee:1 Invalid: 10.01.2.3 or 2001:db8:0:0:0::1
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * IPAddress represents a single IP of a single IP Family. The object is designed to be used by APIs that operate on IP addresses. The object is used by the Service core API for allocation of IP addresses. An IP address can be represented in different formats, to guarantee the uniqueness of the IP, the name of the object is the IP address in canonical format, four decimal digits separated by dots suppressing leading zeros for IPv4 and the representation defined by RFC 5952 for IPv6. Valid: 192.168.1.5 or 2001:db8::1 or 2001:db8:aaaa:bbbb:cccc:dddd:eeee:1 Invalid: 10.01.2.3 or 2001:db8:0:0:0::1
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * IPAddress represents a single IP of a single IP Family. The object is designed to be used by APIs that operate on IP addresses. The object is used by the Service core API for allocation of IP addresses. An IP address can be represented in different formats, to guarantee the uniqueness of the IP, the name of the object is the IP address in canonical format, four decimal digits separated by dots suppressing leading zeros for IPv4 and the representation defined by RFC 5952 for IPv6. Valid: 192.168.1.5 or 2001:db8::1 or 2001:db8:aaaa:bbbb:cccc:dddd:eeee:1 Invalid: 10.01.2.3 or 2001:db8:0:0:0::1
+     */
     @JsonProperty("spec")
     public IPAddressSpec getSpec() {
         return spec;
     }
 
+    /**
+     * IPAddress represents a single IP of a single IP Family. The object is designed to be used by APIs that operate on IP addresses. The object is used by the Service core API for allocation of IP addresses. An IP address can be represented in different formats, to guarantee the uniqueness of the IP, the name of the object is the IP address in canonical format, four decimal digits separated by dots suppressing leading zeros for IPv4 and the representation defined by RFC 5952 for IPv6. Valid: 192.168.1.5 or 2001:db8::1 or 2001:db8:aaaa:bbbb:cccc:dddd:eeee:1 Invalid: 10.01.2.3 or 2001:db8:0:0:0::1
+     */
     @JsonProperty("spec")
     public void setSpec(IPAddressSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IPAddressList.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IPAddressList.java
index b80dc907db0..6958a53b5ab 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IPAddressList.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IPAddressList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IPAddressList contains a list of IPAddress.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class IPAddressList implements Editable<IPAddressListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.networking.v1beta1.IPAddress>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.networking.v1beta1.IPAddress> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "IPAddressList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public IPAddressList(String apiVersion, List<io.fabric8.kubernetes.api.model.net
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of IPAddresses.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.networking.v1beta1.IPAddress> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of IPAddresses.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.networking.v1beta1.IPAddress> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * IPAddressList contains a list of IPAddress.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * IPAddressList contains a list of IPAddress.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IPAddressSpec.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IPAddressSpec.java
index bf302da7fb8..5124d6e681d 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IPAddressSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IPAddressSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IPAddressSpec describe the attributes in an IP Address.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public IPAddressSpec(ParentReference parentRef) {
         this.parentRef = parentRef;
     }
 
+    /**
+     * IPAddressSpec describe the attributes in an IP Address.
+     */
     @JsonProperty("parentRef")
     public ParentReference getParentRef() {
         return parentRef;
     }
 
+    /**
+     * IPAddressSpec describe the attributes in an IP Address.
+     */
     @JsonProperty("parentRef")
     public void setParentRef(ParentReference parentRef) {
         this.parentRef = parentRef;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/Ingress.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/Ingress.java
index 5c0a639585d..e0ccdc919a1 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/Ingress.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/Ingress.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable urls, load balance traffic, terminate SSL, offer name based virtual hosting etc.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Ingress implements Editable<IngressBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Ingress";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Ingress(String apiVersion, String kind, ObjectMeta metadata, IngressSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable urls, load balance traffic, terminate SSL, offer name based virtual hosting etc.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable urls, load balance traffic, terminate SSL, offer name based virtual hosting etc.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable urls, load balance traffic, terminate SSL, offer name based virtual hosting etc.
+     */
     @JsonProperty("spec")
     public IngressSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable urls, load balance traffic, terminate SSL, offer name based virtual hosting etc.
+     */
     @JsonProperty("spec")
     public void setSpec(IngressSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable urls, load balance traffic, terminate SSL, offer name based virtual hosting etc.
+     */
     @JsonProperty("status")
     public IngressStatus getStatus() {
         return status;
     }
 
+    /**
+     * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable urls, load balance traffic, terminate SSL, offer name based virtual hosting etc.
+     */
     @JsonProperty("status")
     public void setStatus(IngressStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressBackend.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressBackend.java
index 793163a7679..f6ec37476bb 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressBackend.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressBackend.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressBackend describes all endpoints for a given service and port.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,31 +90,49 @@ public IngressBackend(TypedLocalObjectReference resource, String serviceName, In
         this.servicePort = servicePort;
     }
 
+    /**
+     * IngressBackend describes all endpoints for a given service and port.
+     */
     @JsonProperty("resource")
     public TypedLocalObjectReference getResource() {
         return resource;
     }
 
+    /**
+     * IngressBackend describes all endpoints for a given service and port.
+     */
     @JsonProperty("resource")
     public void setResource(TypedLocalObjectReference resource) {
         this.resource = resource;
     }
 
+    /**
+     * Specifies the name of the referenced service.
+     */
     @JsonProperty("serviceName")
     public String getServiceName() {
         return serviceName;
     }
 
+    /**
+     * Specifies the name of the referenced service.
+     */
     @JsonProperty("serviceName")
     public void setServiceName(String serviceName) {
         this.serviceName = serviceName;
     }
 
+    /**
+     * IngressBackend describes all endpoints for a given service and port.
+     */
     @JsonProperty("servicePort")
     public IntOrString getServicePort() {
         return servicePort;
     }
 
+    /**
+     * IngressBackend describes all endpoints for a given service and port.
+     */
     @JsonProperty("servicePort")
     public void setServicePort(IntOrString servicePort) {
         this.servicePort = servicePort;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressClass.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressClass.java
index caf327abe41..68a900b6833 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressClass.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressClass.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressClass represents the class of the Ingress, referenced by the Ingress Spec. The `ingressclass.kubernetes.io/is-default-class` annotation can be used to indicate that an IngressClass should be considered default. When a single IngressClass resource has this annotation set to true, new Ingress resources without a class specified will be assigned this default class.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class IngressClass implements Editable<IngressClassBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "IngressClass";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public IngressClass(String apiVersion, String kind, ObjectMeta metadata, Ingress
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * IngressClass represents the class of the Ingress, referenced by the Ingress Spec. The `ingressclass.kubernetes.io/is-default-class` annotation can be used to indicate that an IngressClass should be considered default. When a single IngressClass resource has this annotation set to true, new Ingress resources without a class specified will be assigned this default class.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * IngressClass represents the class of the Ingress, referenced by the Ingress Spec. The `ingressclass.kubernetes.io/is-default-class` annotation can be used to indicate that an IngressClass should be considered default. When a single IngressClass resource has this annotation set to true, new Ingress resources without a class specified will be assigned this default class.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * IngressClass represents the class of the Ingress, referenced by the Ingress Spec. The `ingressclass.kubernetes.io/is-default-class` annotation can be used to indicate that an IngressClass should be considered default. When a single IngressClass resource has this annotation set to true, new Ingress resources without a class specified will be assigned this default class.
+     */
     @JsonProperty("spec")
     public IngressClassSpec getSpec() {
         return spec;
     }
 
+    /**
+     * IngressClass represents the class of the Ingress, referenced by the Ingress Spec. The `ingressclass.kubernetes.io/is-default-class` annotation can be used to indicate that an IngressClass should be considered default. When a single IngressClass resource has this annotation set to true, new Ingress resources without a class specified will be assigned this default class.
+     */
     @JsonProperty("spec")
     public void setSpec(IngressClassSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressClassList.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressClassList.java
index 4354e6df205..3455e854961 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressClassList.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressClassList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressClassList is a collection of IngressClasses.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class IngressClassList implements Editable<IngressClassListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.networking.v1beta1.IngressClass>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.networking.v1beta1.IngressClass> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "IngressClassList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public IngressClassList(String apiVersion, List<io.fabric8.kubernetes.api.model.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of IngressClasses.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.networking.v1beta1.IngressClass> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of IngressClasses.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.networking.v1beta1.IngressClass> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * IngressClassList is a collection of IngressClasses.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * IngressClassList is a collection of IngressClasses.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressClassParametersReference.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressClassParametersReference.java
index 3a7fe77769d..328fdfea189 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressClassParametersReference.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressClassParametersReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressClassParametersReference identifies an API object. This can be used to specify a cluster or namespace-scoped resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public IngressClassParametersReference(String apiGroup, String kind, String name
         this.scope = scope;
     }
 
+    /**
+     * APIGroup is the group for the resource being referenced. If APIGroup is not specified, the specified Kind must be in the core API group. For any other third-party types, APIGroup is required.
+     */
     @JsonProperty("apiGroup")
     public String getApiGroup() {
         return apiGroup;
     }
 
+    /**
+     * APIGroup is the group for the resource being referenced. If APIGroup is not specified, the specified Kind must be in the core API group. For any other third-party types, APIGroup is required.
+     */
     @JsonProperty("apiGroup")
     public void setApiGroup(String apiGroup) {
         this.apiGroup = apiGroup;
     }
 
+    /**
+     * Kind is the type of resource being referenced.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is the type of resource being referenced.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of resource being referenced.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of resource being referenced.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace is the namespace of the resource being referenced. This field is required when scope is set to "Namespace" and must be unset when scope is set to "Cluster".
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace of the resource being referenced. This field is required when scope is set to "Namespace" and must be unset when scope is set to "Cluster".
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Scope represents if this refers to a cluster or namespace scoped resource. This may be set to "Cluster" (default) or "Namespace". Field can be enabled with IngressClassNamespacedParams feature gate.
+     */
     @JsonProperty("scope")
     public String getScope() {
         return scope;
     }
 
+    /**
+     * Scope represents if this refers to a cluster or namespace scoped resource. This may be set to "Cluster" (default) or "Namespace". Field can be enabled with IngressClassNamespacedParams feature gate.
+     */
     @JsonProperty("scope")
     public void setScope(String scope) {
         this.scope = scope;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressClassSpec.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressClassSpec.java
index 6abe40a5e28..2e77234c45d 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressClassSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressClassSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressClassSpec provides information about the class of an Ingress.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public IngressClassSpec(String controller, IngressClassParametersReference param
         this.parameters = parameters;
     }
 
+    /**
+     * Controller refers to the name of the controller that should handle this class. This allows for different "flavors" that are controlled by the same controller. For example, you may have different Parameters for the same implementing controller. This should be specified as a domain-prefixed path no more than 250 characters in length, e.g. "acme.io/ingress-controller". This field is immutable.
+     */
     @JsonProperty("controller")
     public String getController() {
         return controller;
     }
 
+    /**
+     * Controller refers to the name of the controller that should handle this class. This allows for different "flavors" that are controlled by the same controller. For example, you may have different Parameters for the same implementing controller. This should be specified as a domain-prefixed path no more than 250 characters in length, e.g. "acme.io/ingress-controller". This field is immutable.
+     */
     @JsonProperty("controller")
     public void setController(String controller) {
         this.controller = controller;
     }
 
+    /**
+     * IngressClassSpec provides information about the class of an Ingress.
+     */
     @JsonProperty("parameters")
     public IngressClassParametersReference getParameters() {
         return parameters;
     }
 
+    /**
+     * IngressClassSpec provides information about the class of an Ingress.
+     */
     @JsonProperty("parameters")
     public void setParameters(IngressClassParametersReference parameters) {
         this.parameters = parameters;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressList.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressList.java
index b6a2d88e243..7b6b7fd306e 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressList.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressList is a collection of Ingress.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class IngressList implements Editable<IngressListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.networking.v1beta1.Ingress>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.networking.v1beta1.Ingress> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "IngressList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public IngressList(String apiVersion, List<io.fabric8.kubernetes.api.model.netwo
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of Ingress.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.networking.v1beta1.Ingress> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of Ingress.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.networking.v1beta1.Ingress> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * IngressList is a collection of Ingress.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * IngressList is a collection of Ingress.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressRule.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressRule.java
index 84aa4e33b85..99f2d2aac22 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressRule.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressRule.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressRule represents the rules mapping the paths under a specified host to the related backend services. Incoming requests are first evaluated for a host match, then routed to the backend associated with the matching IngressRuleValue.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public IngressRule(String host, HTTPIngressRuleValue http) {
         this.http = http;
     }
 
+    /**
+     * Host is the fully qualified domain name of a network host, as defined by RFC 3986. Note the following deviations from the "host" part of the URI as defined in RFC 3986: 1. IPs are not allowed. Currently an IngressRuleValue can only apply to<br><p>    the IP in the Spec of the parent Ingress.<br><p> 2. The `:` delimiter is not respected because ports are not allowed.<br><p> 	  Currently the port of an Ingress is implicitly :80 for http and<br><p> 	  :443 for https.<br><p> Both these may change in the future. Incoming requests are matched against the host before the IngressRuleValue. If the host is unspecified, the Ingress routes all traffic based on the specified IngressRuleValue.<br><p> <br><p> Host can be "precise" which is a domain name without the terminating dot of a network host (e.g. "foo.bar.com") or "wildcard", which is a domain name prefixed with a single wildcard label (e.g. "&#42;.foo.com"). The wildcard character '&#42;' must appear by itself as the first DNS label and matches only a single label. You cannot have a wildcard label by itself (e.g. Host == "&#42;"). Requests will be matched against the Host field in the following way: 1. If Host is precise, the request matches this rule if the http host header is equal to Host. 2. If Host is a wildcard, then the request matches this rule if the http host header is to equal to the suffix (removing the first label) of the wildcard rule.
+     */
     @JsonProperty("host")
     public String getHost() {
         return host;
     }
 
+    /**
+     * Host is the fully qualified domain name of a network host, as defined by RFC 3986. Note the following deviations from the "host" part of the URI as defined in RFC 3986: 1. IPs are not allowed. Currently an IngressRuleValue can only apply to<br><p>    the IP in the Spec of the parent Ingress.<br><p> 2. The `:` delimiter is not respected because ports are not allowed.<br><p> 	  Currently the port of an Ingress is implicitly :80 for http and<br><p> 	  :443 for https.<br><p> Both these may change in the future. Incoming requests are matched against the host before the IngressRuleValue. If the host is unspecified, the Ingress routes all traffic based on the specified IngressRuleValue.<br><p> <br><p> Host can be "precise" which is a domain name without the terminating dot of a network host (e.g. "foo.bar.com") or "wildcard", which is a domain name prefixed with a single wildcard label (e.g. "&#42;.foo.com"). The wildcard character '&#42;' must appear by itself as the first DNS label and matches only a single label. You cannot have a wildcard label by itself (e.g. Host == "&#42;"). Requests will be matched against the Host field in the following way: 1. If Host is precise, the request matches this rule if the http host header is equal to Host. 2. If Host is a wildcard, then the request matches this rule if the http host header is to equal to the suffix (removing the first label) of the wildcard rule.
+     */
     @JsonProperty("host")
     public void setHost(String host) {
         this.host = host;
     }
 
+    /**
+     * IngressRule represents the rules mapping the paths under a specified host to the related backend services. Incoming requests are first evaluated for a host match, then routed to the backend associated with the matching IngressRuleValue.
+     */
     @JsonProperty("http")
     public HTTPIngressRuleValue getHttp() {
         return http;
     }
 
+    /**
+     * IngressRule represents the rules mapping the paths under a specified host to the related backend services. Incoming requests are first evaluated for a host match, then routed to the backend associated with the matching IngressRuleValue.
+     */
     @JsonProperty("http")
     public void setHttp(HTTPIngressRuleValue http) {
         this.http = http;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressSpec.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressSpec.java
index c28593f4f79..a26b36bfb37 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressSpec describes the Ingress the user wishes to exist.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,43 +97,67 @@ public IngressSpec(IngressBackend backend, String ingressClassName, List<Ingress
         this.tls = tls;
     }
 
+    /**
+     * IngressSpec describes the Ingress the user wishes to exist.
+     */
     @JsonProperty("backend")
     public IngressBackend getBackend() {
         return backend;
     }
 
+    /**
+     * IngressSpec describes the Ingress the user wishes to exist.
+     */
     @JsonProperty("backend")
     public void setBackend(IngressBackend backend) {
         this.backend = backend;
     }
 
+    /**
+     * IngressClassName is the name of the IngressClass cluster resource. The associated IngressClass defines which controller will implement the resource. This replaces the deprecated `kubernetes.io/ingress.class` annotation. For backwards compatibility, when that annotation is set, it must be given precedence over this field. The controller may emit a warning if the field and annotation have different values. Implementations of this API should ignore Ingresses without a class specified. An IngressClass resource may be marked as default, which can be used to set a default value for this field. For more information, refer to the IngressClass documentation.
+     */
     @JsonProperty("ingressClassName")
     public String getIngressClassName() {
         return ingressClassName;
     }
 
+    /**
+     * IngressClassName is the name of the IngressClass cluster resource. The associated IngressClass defines which controller will implement the resource. This replaces the deprecated `kubernetes.io/ingress.class` annotation. For backwards compatibility, when that annotation is set, it must be given precedence over this field. The controller may emit a warning if the field and annotation have different values. Implementations of this API should ignore Ingresses without a class specified. An IngressClass resource may be marked as default, which can be used to set a default value for this field. For more information, refer to the IngressClass documentation.
+     */
     @JsonProperty("ingressClassName")
     public void setIngressClassName(String ingressClassName) {
         this.ingressClassName = ingressClassName;
     }
 
+    /**
+     * A list of host rules used to configure the Ingress. If unspecified, or no rule matches, all traffic is sent to the default backend.
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IngressRule> getRules() {
         return rules;
     }
 
+    /**
+     * A list of host rules used to configure the Ingress. If unspecified, or no rule matches, all traffic is sent to the default backend.
+     */
     @JsonProperty("rules")
     public void setRules(List<IngressRule> rules) {
         this.rules = rules;
     }
 
+    /**
+     * TLS configuration. Currently the Ingress only supports a single TLS port, 443. If multiple members of this list specify different hosts, they will be multiplexed on the same port according to the hostname specified through the SNI TLS extension, if the ingress controller fulfilling the ingress supports SNI.
+     */
     @JsonProperty("tls")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IngressTLS> getTls() {
         return tls;
     }
 
+    /**
+     * TLS configuration. Currently the Ingress only supports a single TLS port, 443. If multiple members of this list specify different hosts, they will be multiplexed on the same port according to the hostname specified through the SNI TLS extension, if the ingress controller fulfilling the ingress supports SNI.
+     */
     @JsonProperty("tls")
     public void setTls(List<IngressTLS> tls) {
         this.tls = tls;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressStatus.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressStatus.java
index 3c2b446b94f..a2fd88421f4 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressStatus.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressStatus describe the current state of the Ingress.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,11 +82,17 @@ public IngressStatus(LoadBalancerStatus loadBalancer) {
         this.loadBalancer = loadBalancer;
     }
 
+    /**
+     * IngressStatus describe the current state of the Ingress.
+     */
     @JsonProperty("loadBalancer")
     public LoadBalancerStatus getLoadBalancer() {
         return loadBalancer;
     }
 
+    /**
+     * IngressStatus describe the current state of the Ingress.
+     */
     @JsonProperty("loadBalancer")
     public void setLoadBalancer(LoadBalancerStatus loadBalancer) {
         this.loadBalancer = loadBalancer;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressTLS.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressTLS.java
index ae151e8caca..92424316915 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressTLS.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/IngressTLS.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressTLS describes the transport layer security associated with an Ingress.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public IngressTLS(List<String> hosts, String secretName) {
         this.secretName = secretName;
     }
 
+    /**
+     * Hosts are a list of hosts included in the TLS certificate. The values in this list must match the name/s used in the tlsSecret. Defaults to the wildcard host setting for the loadbalancer controller fulfilling this Ingress, if left unspecified.
+     */
     @JsonProperty("hosts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getHosts() {
         return hosts;
     }
 
+    /**
+     * Hosts are a list of hosts included in the TLS certificate. The values in this list must match the name/s used in the tlsSecret. Defaults to the wildcard host setting for the loadbalancer controller fulfilling this Ingress, if left unspecified.
+     */
     @JsonProperty("hosts")
     public void setHosts(List<String> hosts) {
         this.hosts = hosts;
     }
 
+    /**
+     * SecretName is the name of the secret used to terminate TLS traffic on port 443. Field is left optional to allow TLS routing based on SNI hostname alone. If the SNI host in a listener conflicts with the "Host" header field used by an IngressRule, the SNI host is used for termination and value of the Host header is used for routing.
+     */
     @JsonProperty("secretName")
     public String getSecretName() {
         return secretName;
     }
 
+    /**
+     * SecretName is the name of the secret used to terminate TLS traffic on port 443. Field is left optional to allow TLS routing based on SNI hostname alone. If the SNI host in a listener conflicts with the "Host" header field used by an IngressRule, the SNI host is used for termination and value of the Host header is used for routing.
+     */
     @JsonProperty("secretName")
     public void setSecretName(String secretName) {
         this.secretName = secretName;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/ParentReference.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/ParentReference.java
index 5d5aa65db2a..c6f985d6c27 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/ParentReference.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/ParentReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ParentReference describes a reference to a parent object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ParentReference(String group, String name, String namespace, String resou
         this.resource = resource;
     }
 
+    /**
+     * Group is the group of the object being referenced.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * Group is the group of the object being referenced.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * Name is the name of the object being referenced.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the object being referenced.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace is the namespace of the object being referenced.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace of the object being referenced.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Resource is the resource of the object being referenced.
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * Resource is the resource of the object being referenced.
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/ServiceCIDR.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/ServiceCIDR.java
index c935ca8ee0b..083e710e5a2 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/ServiceCIDR.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/ServiceCIDR.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceCIDR defines a range of IP addresses using CIDR format (e.g. 192.168.0.0/24 or 2001:db2::/64). This range is used to allocate ClusterIPs to Service objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ServiceCIDR implements Editable<ServiceCIDRBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ServiceCIDR";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public ServiceCIDR(String apiVersion, String kind, ObjectMeta metadata, ServiceC
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ServiceCIDR defines a range of IP addresses using CIDR format (e.g. 192.168.0.0/24 or 2001:db2::/64). This range is used to allocate ClusterIPs to Service objects.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ServiceCIDR defines a range of IP addresses using CIDR format (e.g. 192.168.0.0/24 or 2001:db2::/64). This range is used to allocate ClusterIPs to Service objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ServiceCIDR defines a range of IP addresses using CIDR format (e.g. 192.168.0.0/24 or 2001:db2::/64). This range is used to allocate ClusterIPs to Service objects.
+     */
     @JsonProperty("spec")
     public ServiceCIDRSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ServiceCIDR defines a range of IP addresses using CIDR format (e.g. 192.168.0.0/24 or 2001:db2::/64). This range is used to allocate ClusterIPs to Service objects.
+     */
     @JsonProperty("spec")
     public void setSpec(ServiceCIDRSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ServiceCIDR defines a range of IP addresses using CIDR format (e.g. 192.168.0.0/24 or 2001:db2::/64). This range is used to allocate ClusterIPs to Service objects.
+     */
     @JsonProperty("status")
     public ServiceCIDRStatus getStatus() {
         return status;
     }
 
+    /**
+     * ServiceCIDR defines a range of IP addresses using CIDR format (e.g. 192.168.0.0/24 or 2001:db2::/64). This range is used to allocate ClusterIPs to Service objects.
+     */
     @JsonProperty("status")
     public void setStatus(ServiceCIDRStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/ServiceCIDRList.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/ServiceCIDRList.java
index e50592399ed..0c7d46b0413 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/ServiceCIDRList.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/ServiceCIDRList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceCIDRList contains a list of ServiceCIDR objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ServiceCIDRList implements Editable<ServiceCIDRListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.networking.v1beta1.ServiceCIDR>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "networking.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.networking.v1beta1.ServiceCIDR> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ServiceCIDRList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ServiceCIDRList(String apiVersion, List<io.fabric8.kubernetes.api.model.n
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of ServiceCIDRs.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.networking.v1beta1.ServiceCIDR> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of ServiceCIDRs.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.networking.v1beta1.ServiceCIDR> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ServiceCIDRList contains a list of ServiceCIDR objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ServiceCIDRList contains a list of ServiceCIDR objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/ServiceCIDRSpec.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/ServiceCIDRSpec.java
index bf9e53d4f1d..03d8bc53154 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/ServiceCIDRSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/ServiceCIDRSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceCIDRSpec define the CIDRs the user wants to use for allocating ClusterIPs for Services.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public ServiceCIDRSpec(List<String> cidrs) {
         this.cidrs = cidrs;
     }
 
+    /**
+     * CIDRs defines the IP blocks in CIDR notation (e.g. "192.168.0.0/24" or "2001:db8::/64") from which to assign service cluster IPs. Max of two CIDRs is allowed, one of each IP family. This field is immutable.
+     */
     @JsonProperty("cidrs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCidrs() {
         return cidrs;
     }
 
+    /**
+     * CIDRs defines the IP blocks in CIDR notation (e.g. "192.168.0.0/24" or "2001:db8::/64") from which to assign service cluster IPs. Max of two CIDRs is allowed, one of each IP family. This field is immutable.
+     */
     @JsonProperty("cidrs")
     public void setCidrs(List<String> cidrs) {
         this.cidrs = cidrs;
diff --git a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/ServiceCIDRStatus.java b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/ServiceCIDRStatus.java
index 0a9773c5d0e..6f8853e9918 100644
--- a/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/ServiceCIDRStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-networking/src/generated/java/io/fabric8/kubernetes/api/model/networking/v1beta1/ServiceCIDRStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceCIDRStatus describes the current state of the ServiceCIDR.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,12 +85,18 @@ public ServiceCIDRStatus(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * conditions holds an array of metav1.Condition that describe the state of the ServiceCIDR. Current service state
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions holds an array of metav1.Condition that describe the state of the ServiceCIDR. Current service state
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
diff --git a/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1/Overhead.java b/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1/Overhead.java
index 324bdf3644a..8e3504acded 100644
--- a/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1/Overhead.java
+++ b/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1/Overhead.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Overhead structure represents the resource overhead associated with running a pod.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -80,12 +83,18 @@ public Overhead(Map<String, Quantity> podFixed) {
         this.podFixed = podFixed;
     }
 
+    /**
+     * podFixed represents the fixed resource overhead associated with running a pod.
+     */
     @JsonProperty("podFixed")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getPodFixed() {
         return podFixed;
     }
 
+    /**
+     * podFixed represents the fixed resource overhead associated with running a pod.
+     */
     @JsonProperty("podFixed")
     public void setPodFixed(Map<String, Quantity> podFixed) {
         this.podFixed = podFixed;
diff --git a/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1/RuntimeClass.java b/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1/RuntimeClass.java
index 8a2dd77e666..413bb76dfe6 100644
--- a/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1/RuntimeClass.java
+++ b/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1/RuntimeClass.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RuntimeClass defines a class of container runtime supported in the cluster. The RuntimeClass is used to determine which container runtime is used to run all containers in a pod. RuntimeClasses are manually defined by a user or cluster provisioner, and referenced in the PodSpec. The Kubelet is responsible for resolving the RuntimeClassName reference before running the pod.  For more details, see https://kubernetes.io/docs/concepts/containers/runtime-class/
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,16 +79,10 @@
 public class RuntimeClass implements Editable<RuntimeClassBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "node.k8s.io/v1";
     @JsonProperty("handler")
     private String handler;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "RuntimeClass";
     @JsonProperty("metadata")
@@ -114,7 +111,7 @@ public RuntimeClass(String apiVersion, String handler, String kind, ObjectMeta m
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -122,25 +119,31 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * handler specifies the underlying runtime and configuration that the CRI implementation will use to handle pods of this class. The possible values are specific to the node &amp; CRI configuration.  It is assumed that all handlers are available on every node, and handlers of the same name are equivalent on every node. For example, a handler called "runc" might specify that the runc OCI runtime (using native Linux containers) will be used to run the containers in a pod. The Handler must be lowercase, conform to the DNS Label (RFC 1123) requirements, and is immutable.
+     */
     @JsonProperty("handler")
     public String getHandler() {
         return handler;
     }
 
+    /**
+     * handler specifies the underlying runtime and configuration that the CRI implementation will use to handle pods of this class. The possible values are specific to the node &amp; CRI configuration.  It is assumed that all handlers are available on every node, and handlers of the same name are equivalent on every node. For example, a handler called "runc" might specify that the runc OCI runtime (using native Linux containers) will be used to run the containers in a pod. The Handler must be lowercase, conform to the DNS Label (RFC 1123) requirements, and is immutable.
+     */
     @JsonProperty("handler")
     public void setHandler(String handler) {
         this.handler = handler;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -148,38 +151,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RuntimeClass defines a class of container runtime supported in the cluster. The RuntimeClass is used to determine which container runtime is used to run all containers in a pod. RuntimeClasses are manually defined by a user or cluster provisioner, and referenced in the PodSpec. The Kubelet is responsible for resolving the RuntimeClassName reference before running the pod.  For more details, see https://kubernetes.io/docs/concepts/containers/runtime-class/
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RuntimeClass defines a class of container runtime supported in the cluster. The RuntimeClass is used to determine which container runtime is used to run all containers in a pod. RuntimeClasses are manually defined by a user or cluster provisioner, and referenced in the PodSpec. The Kubelet is responsible for resolving the RuntimeClassName reference before running the pod.  For more details, see https://kubernetes.io/docs/concepts/containers/runtime-class/
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * RuntimeClass defines a class of container runtime supported in the cluster. The RuntimeClass is used to determine which container runtime is used to run all containers in a pod. RuntimeClasses are manually defined by a user or cluster provisioner, and referenced in the PodSpec. The Kubelet is responsible for resolving the RuntimeClassName reference before running the pod.  For more details, see https://kubernetes.io/docs/concepts/containers/runtime-class/
+     */
     @JsonProperty("overhead")
     public Overhead getOverhead() {
         return overhead;
     }
 
+    /**
+     * RuntimeClass defines a class of container runtime supported in the cluster. The RuntimeClass is used to determine which container runtime is used to run all containers in a pod. RuntimeClasses are manually defined by a user or cluster provisioner, and referenced in the PodSpec. The Kubelet is responsible for resolving the RuntimeClassName reference before running the pod.  For more details, see https://kubernetes.io/docs/concepts/containers/runtime-class/
+     */
     @JsonProperty("overhead")
     public void setOverhead(Overhead overhead) {
         this.overhead = overhead;
     }
 
+    /**
+     * RuntimeClass defines a class of container runtime supported in the cluster. The RuntimeClass is used to determine which container runtime is used to run all containers in a pod. RuntimeClasses are manually defined by a user or cluster provisioner, and referenced in the PodSpec. The Kubelet is responsible for resolving the RuntimeClassName reference before running the pod.  For more details, see https://kubernetes.io/docs/concepts/containers/runtime-class/
+     */
     @JsonProperty("scheduling")
     public Scheduling getScheduling() {
         return scheduling;
     }
 
+    /**
+     * RuntimeClass defines a class of container runtime supported in the cluster. The RuntimeClass is used to determine which container runtime is used to run all containers in a pod. RuntimeClasses are manually defined by a user or cluster provisioner, and referenced in the PodSpec. The Kubelet is responsible for resolving the RuntimeClassName reference before running the pod.  For more details, see https://kubernetes.io/docs/concepts/containers/runtime-class/
+     */
     @JsonProperty("scheduling")
     public void setScheduling(Scheduling scheduling) {
         this.scheduling = scheduling;
diff --git a/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1/RuntimeClassList.java b/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1/RuntimeClassList.java
index 58c078a1372..b09703fb3a0 100644
--- a/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1/RuntimeClassList.java
+++ b/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1/RuntimeClassList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RuntimeClassList is a list of RuntimeClass objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class RuntimeClassList implements Editable<RuntimeClassListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.node.v1.RuntimeClass>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "node.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.node.v1.RuntimeClass> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "RuntimeClassList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public RuntimeClassList(String apiVersion, List<io.fabric8.kubernetes.api.model.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is a list of schema objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.node.v1.RuntimeClass> getItems() {
         return items;
     }
 
+    /**
+     * items is a list of schema objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.node.v1.RuntimeClass> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RuntimeClassList is a list of RuntimeClass objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RuntimeClassList is a list of RuntimeClass objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1/Scheduling.java b/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1/Scheduling.java
index e8182369585..539b18c5ca1 100644
--- a/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1/Scheduling.java
+++ b/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1/Scheduling.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Scheduling specifies the scheduling constraints for nodes supporting a RuntimeClass.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,23 +90,35 @@ public Scheduling(Map<String, String> nodeSelector, List<Toleration> tolerations
         this.tolerations = tolerations;
     }
 
+    /**
+     * nodeSelector lists labels that must be present on nodes that support this RuntimeClass. Pods using this RuntimeClass can only be scheduled to a node matched by this selector. The RuntimeClass nodeSelector is merged with a pod's existing nodeSelector. Any conflicts will cause the pod to be rejected in admission.
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * nodeSelector lists labels that must be present on nodes that support this RuntimeClass. Pods using this RuntimeClass can only be scheduled to a node matched by this selector. The RuntimeClass nodeSelector is merged with a pod's existing nodeSelector. Any conflicts will cause the pod to be rejected in admission.
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * tolerations are appended (excluding duplicates) to pods running with this RuntimeClass during admission, effectively unioning the set of nodes tolerated by the pod and the RuntimeClass.
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * tolerations are appended (excluding duplicates) to pods running with this RuntimeClass during admission, effectively unioning the set of nodes tolerated by the pod and the RuntimeClass.
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
diff --git a/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1alpha1/Overhead.java b/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1alpha1/Overhead.java
index 1f7b5dcc3ce..bf341cfeb2c 100644
--- a/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1alpha1/Overhead.java
+++ b/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1alpha1/Overhead.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Overhead structure represents the resource overhead associated with running a pod.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -80,12 +83,18 @@ public Overhead(Map<String, Quantity> podFixed) {
         this.podFixed = podFixed;
     }
 
+    /**
+     * PodFixed represents the fixed resource overhead associated with running a pod.
+     */
     @JsonProperty("podFixed")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getPodFixed() {
         return podFixed;
     }
 
+    /**
+     * PodFixed represents the fixed resource overhead associated with running a pod.
+     */
     @JsonProperty("podFixed")
     public void setPodFixed(Map<String, Quantity> podFixed) {
         this.podFixed = podFixed;
diff --git a/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1alpha1/RuntimeClass.java b/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1alpha1/RuntimeClass.java
index 8a70177eca8..042ee919d24 100644
--- a/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1alpha1/RuntimeClass.java
+++ b/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1alpha1/RuntimeClass.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RuntimeClass defines a class of container runtime supported in the cluster. The RuntimeClass is used to determine which container runtime is used to run all containers in a pod. RuntimeClasses are (currently) manually defined by a user or cluster provisioner, and referenced in the PodSpec. The Kubelet is responsible for resolving the RuntimeClassName reference before running the pod.  For more details, see https://git.k8s.io/enhancements/keps/sig-node/runtime-class.md
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class RuntimeClass implements Editable<RuntimeClassBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "node.k8s.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "RuntimeClass";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public RuntimeClass(String apiVersion, String kind, ObjectMeta metadata, Runtime
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RuntimeClass defines a class of container runtime supported in the cluster. The RuntimeClass is used to determine which container runtime is used to run all containers in a pod. RuntimeClasses are (currently) manually defined by a user or cluster provisioner, and referenced in the PodSpec. The Kubelet is responsible for resolving the RuntimeClassName reference before running the pod.  For more details, see https://git.k8s.io/enhancements/keps/sig-node/runtime-class.md
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RuntimeClass defines a class of container runtime supported in the cluster. The RuntimeClass is used to determine which container runtime is used to run all containers in a pod. RuntimeClasses are (currently) manually defined by a user or cluster provisioner, and referenced in the PodSpec. The Kubelet is responsible for resolving the RuntimeClassName reference before running the pod.  For more details, see https://git.k8s.io/enhancements/keps/sig-node/runtime-class.md
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * RuntimeClass defines a class of container runtime supported in the cluster. The RuntimeClass is used to determine which container runtime is used to run all containers in a pod. RuntimeClasses are (currently) manually defined by a user or cluster provisioner, and referenced in the PodSpec. The Kubelet is responsible for resolving the RuntimeClassName reference before running the pod.  For more details, see https://git.k8s.io/enhancements/keps/sig-node/runtime-class.md
+     */
     @JsonProperty("spec")
     public RuntimeClassSpec getSpec() {
         return spec;
     }
 
+    /**
+     * RuntimeClass defines a class of container runtime supported in the cluster. The RuntimeClass is used to determine which container runtime is used to run all containers in a pod. RuntimeClasses are (currently) manually defined by a user or cluster provisioner, and referenced in the PodSpec. The Kubelet is responsible for resolving the RuntimeClassName reference before running the pod.  For more details, see https://git.k8s.io/enhancements/keps/sig-node/runtime-class.md
+     */
     @JsonProperty("spec")
     public void setSpec(RuntimeClassSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1alpha1/RuntimeClassList.java b/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1alpha1/RuntimeClassList.java
index e7c563e6394..2c4e9296cdb 100644
--- a/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1alpha1/RuntimeClassList.java
+++ b/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1alpha1/RuntimeClassList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RuntimeClassList is a list of RuntimeClass objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class RuntimeClassList implements Editable<RuntimeClassListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.node.v1alpha1.RuntimeClass>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "node.k8s.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.node.v1alpha1.RuntimeClass> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "RuntimeClassList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public RuntimeClassList(String apiVersion, List<io.fabric8.kubernetes.api.model.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of schema objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.node.v1alpha1.RuntimeClass> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of schema objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.node.v1alpha1.RuntimeClass> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RuntimeClassList is a list of RuntimeClass objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RuntimeClassList is a list of RuntimeClass objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1alpha1/RuntimeClassSpec.java b/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1alpha1/RuntimeClassSpec.java
index 56c8ff16fc7..126f878c9bf 100644
--- a/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1alpha1/RuntimeClassSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1alpha1/RuntimeClassSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RuntimeClassSpec is a specification of a RuntimeClass. It contains parameters that are required to describe the RuntimeClass to the Container Runtime Interface (CRI) implementation, as well as any other components that need to understand how the pod will be run. The RuntimeClassSpec is immutable.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public RuntimeClassSpec(Overhead overhead, String runtimeHandler, Scheduling sch
         this.scheduling = scheduling;
     }
 
+    /**
+     * RuntimeClassSpec is a specification of a RuntimeClass. It contains parameters that are required to describe the RuntimeClass to the Container Runtime Interface (CRI) implementation, as well as any other components that need to understand how the pod will be run. The RuntimeClassSpec is immutable.
+     */
     @JsonProperty("overhead")
     public Overhead getOverhead() {
         return overhead;
     }
 
+    /**
+     * RuntimeClassSpec is a specification of a RuntimeClass. It contains parameters that are required to describe the RuntimeClass to the Container Runtime Interface (CRI) implementation, as well as any other components that need to understand how the pod will be run. The RuntimeClassSpec is immutable.
+     */
     @JsonProperty("overhead")
     public void setOverhead(Overhead overhead) {
         this.overhead = overhead;
     }
 
+    /**
+     * RuntimeHandler specifies the underlying runtime and configuration that the CRI implementation will use to handle pods of this class. The possible values are specific to the node &amp; CRI configuration.  It is assumed that all handlers are available on every node, and handlers of the same name are equivalent on every node. For example, a handler called "runc" might specify that the runc OCI runtime (using native Linux containers) will be used to run the containers in a pod. The RuntimeHandler must be lowercase, conform to the DNS Label (RFC 1123) requirements, and is immutable.
+     */
     @JsonProperty("runtimeHandler")
     public String getRuntimeHandler() {
         return runtimeHandler;
     }
 
+    /**
+     * RuntimeHandler specifies the underlying runtime and configuration that the CRI implementation will use to handle pods of this class. The possible values are specific to the node &amp; CRI configuration.  It is assumed that all handlers are available on every node, and handlers of the same name are equivalent on every node. For example, a handler called "runc" might specify that the runc OCI runtime (using native Linux containers) will be used to run the containers in a pod. The RuntimeHandler must be lowercase, conform to the DNS Label (RFC 1123) requirements, and is immutable.
+     */
     @JsonProperty("runtimeHandler")
     public void setRuntimeHandler(String runtimeHandler) {
         this.runtimeHandler = runtimeHandler;
     }
 
+    /**
+     * RuntimeClassSpec is a specification of a RuntimeClass. It contains parameters that are required to describe the RuntimeClass to the Container Runtime Interface (CRI) implementation, as well as any other components that need to understand how the pod will be run. The RuntimeClassSpec is immutable.
+     */
     @JsonProperty("scheduling")
     public Scheduling getScheduling() {
         return scheduling;
     }
 
+    /**
+     * RuntimeClassSpec is a specification of a RuntimeClass. It contains parameters that are required to describe the RuntimeClass to the Container Runtime Interface (CRI) implementation, as well as any other components that need to understand how the pod will be run. The RuntimeClassSpec is immutable.
+     */
     @JsonProperty("scheduling")
     public void setScheduling(Scheduling scheduling) {
         this.scheduling = scheduling;
diff --git a/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1alpha1/Scheduling.java b/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1alpha1/Scheduling.java
index d5f3ffbdeca..eeefebe2243 100644
--- a/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1alpha1/Scheduling.java
+++ b/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1alpha1/Scheduling.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Scheduling specifies the scheduling constraints for nodes supporting a RuntimeClass.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,23 +90,35 @@ public Scheduling(Map<String, String> nodeSelector, List<Toleration> tolerations
         this.tolerations = tolerations;
     }
 
+    /**
+     * nodeSelector lists labels that must be present on nodes that support this RuntimeClass. Pods using this RuntimeClass can only be scheduled to a node matched by this selector. The RuntimeClass nodeSelector is merged with a pod's existing nodeSelector. Any conflicts will cause the pod to be rejected in admission.
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * nodeSelector lists labels that must be present on nodes that support this RuntimeClass. Pods using this RuntimeClass can only be scheduled to a node matched by this selector. The RuntimeClass nodeSelector is merged with a pod's existing nodeSelector. Any conflicts will cause the pod to be rejected in admission.
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * tolerations are appended (excluding duplicates) to pods running with this RuntimeClass during admission, effectively unioning the set of nodes tolerated by the pod and the RuntimeClass.
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * tolerations are appended (excluding duplicates) to pods running with this RuntimeClass during admission, effectively unioning the set of nodes tolerated by the pod and the RuntimeClass.
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
diff --git a/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1beta1/Overhead.java b/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1beta1/Overhead.java
index eb2303a5efe..bc8f86af29f 100644
--- a/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1beta1/Overhead.java
+++ b/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1beta1/Overhead.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Overhead structure represents the resource overhead associated with running a pod.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -80,12 +83,18 @@ public Overhead(Map<String, Quantity> podFixed) {
         this.podFixed = podFixed;
     }
 
+    /**
+     * PodFixed represents the fixed resource overhead associated with running a pod.
+     */
     @JsonProperty("podFixed")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getPodFixed() {
         return podFixed;
     }
 
+    /**
+     * PodFixed represents the fixed resource overhead associated with running a pod.
+     */
     @JsonProperty("podFixed")
     public void setPodFixed(Map<String, Quantity> podFixed) {
         this.podFixed = podFixed;
diff --git a/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1beta1/RuntimeClass.java b/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1beta1/RuntimeClass.java
index 9f1e5de7ffc..767e7af914a 100644
--- a/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1beta1/RuntimeClass.java
+++ b/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1beta1/RuntimeClass.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RuntimeClass defines a class of container runtime supported in the cluster. The RuntimeClass is used to determine which container runtime is used to run all containers in a pod. RuntimeClasses are (currently) manually defined by a user or cluster provisioner, and referenced in the PodSpec. The Kubelet is responsible for resolving the RuntimeClassName reference before running the pod.  For more details, see https://git.k8s.io/enhancements/keps/sig-node/runtime-class.md
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,16 +79,10 @@
 public class RuntimeClass implements Editable<RuntimeClassBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "node.k8s.io/v1beta1";
     @JsonProperty("handler")
     private String handler;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "RuntimeClass";
     @JsonProperty("metadata")
@@ -114,7 +111,7 @@ public RuntimeClass(String apiVersion, String handler, String kind, ObjectMeta m
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -122,25 +119,31 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Handler specifies the underlying runtime and configuration that the CRI implementation will use to handle pods of this class. The possible values are specific to the node &amp; CRI configuration.  It is assumed that all handlers are available on every node, and handlers of the same name are equivalent on every node. For example, a handler called "runc" might specify that the runc OCI runtime (using native Linux containers) will be used to run the containers in a pod. The Handler must be lowercase, conform to the DNS Label (RFC 1123) requirements, and is immutable.
+     */
     @JsonProperty("handler")
     public String getHandler() {
         return handler;
     }
 
+    /**
+     * Handler specifies the underlying runtime and configuration that the CRI implementation will use to handle pods of this class. The possible values are specific to the node &amp; CRI configuration.  It is assumed that all handlers are available on every node, and handlers of the same name are equivalent on every node. For example, a handler called "runc" might specify that the runc OCI runtime (using native Linux containers) will be used to run the containers in a pod. The Handler must be lowercase, conform to the DNS Label (RFC 1123) requirements, and is immutable.
+     */
     @JsonProperty("handler")
     public void setHandler(String handler) {
         this.handler = handler;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -148,38 +151,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RuntimeClass defines a class of container runtime supported in the cluster. The RuntimeClass is used to determine which container runtime is used to run all containers in a pod. RuntimeClasses are (currently) manually defined by a user or cluster provisioner, and referenced in the PodSpec. The Kubelet is responsible for resolving the RuntimeClassName reference before running the pod.  For more details, see https://git.k8s.io/enhancements/keps/sig-node/runtime-class.md
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RuntimeClass defines a class of container runtime supported in the cluster. The RuntimeClass is used to determine which container runtime is used to run all containers in a pod. RuntimeClasses are (currently) manually defined by a user or cluster provisioner, and referenced in the PodSpec. The Kubelet is responsible for resolving the RuntimeClassName reference before running the pod.  For more details, see https://git.k8s.io/enhancements/keps/sig-node/runtime-class.md
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * RuntimeClass defines a class of container runtime supported in the cluster. The RuntimeClass is used to determine which container runtime is used to run all containers in a pod. RuntimeClasses are (currently) manually defined by a user or cluster provisioner, and referenced in the PodSpec. The Kubelet is responsible for resolving the RuntimeClassName reference before running the pod.  For more details, see https://git.k8s.io/enhancements/keps/sig-node/runtime-class.md
+     */
     @JsonProperty("overhead")
     public Overhead getOverhead() {
         return overhead;
     }
 
+    /**
+     * RuntimeClass defines a class of container runtime supported in the cluster. The RuntimeClass is used to determine which container runtime is used to run all containers in a pod. RuntimeClasses are (currently) manually defined by a user or cluster provisioner, and referenced in the PodSpec. The Kubelet is responsible for resolving the RuntimeClassName reference before running the pod.  For more details, see https://git.k8s.io/enhancements/keps/sig-node/runtime-class.md
+     */
     @JsonProperty("overhead")
     public void setOverhead(Overhead overhead) {
         this.overhead = overhead;
     }
 
+    /**
+     * RuntimeClass defines a class of container runtime supported in the cluster. The RuntimeClass is used to determine which container runtime is used to run all containers in a pod. RuntimeClasses are (currently) manually defined by a user or cluster provisioner, and referenced in the PodSpec. The Kubelet is responsible for resolving the RuntimeClassName reference before running the pod.  For more details, see https://git.k8s.io/enhancements/keps/sig-node/runtime-class.md
+     */
     @JsonProperty("scheduling")
     public Scheduling getScheduling() {
         return scheduling;
     }
 
+    /**
+     * RuntimeClass defines a class of container runtime supported in the cluster. The RuntimeClass is used to determine which container runtime is used to run all containers in a pod. RuntimeClasses are (currently) manually defined by a user or cluster provisioner, and referenced in the PodSpec. The Kubelet is responsible for resolving the RuntimeClassName reference before running the pod.  For more details, see https://git.k8s.io/enhancements/keps/sig-node/runtime-class.md
+     */
     @JsonProperty("scheduling")
     public void setScheduling(Scheduling scheduling) {
         this.scheduling = scheduling;
diff --git a/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1beta1/RuntimeClassList.java b/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1beta1/RuntimeClassList.java
index bb86b2d17cc..10dde134977 100644
--- a/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1beta1/RuntimeClassList.java
+++ b/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1beta1/RuntimeClassList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RuntimeClassList is a list of RuntimeClass objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class RuntimeClassList implements Editable<RuntimeClassListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.node.v1beta1.RuntimeClass>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "node.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.node.v1beta1.RuntimeClass> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "RuntimeClassList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public RuntimeClassList(String apiVersion, List<io.fabric8.kubernetes.api.model.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of schema objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.node.v1beta1.RuntimeClass> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of schema objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.node.v1beta1.RuntimeClass> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RuntimeClassList is a list of RuntimeClass objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RuntimeClassList is a list of RuntimeClass objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1beta1/Scheduling.java b/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1beta1/Scheduling.java
index 811d808a513..3983793d2c6 100644
--- a/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1beta1/Scheduling.java
+++ b/kubernetes-model-generator/kubernetes-model-node/src/generated/java/io/fabric8/kubernetes/api/model/node/v1beta1/Scheduling.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Scheduling specifies the scheduling constraints for nodes supporting a RuntimeClass.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,23 +90,35 @@ public Scheduling(Map<String, String> nodeSelector, List<Toleration> tolerations
         this.tolerations = tolerations;
     }
 
+    /**
+     * nodeSelector lists labels that must be present on nodes that support this RuntimeClass. Pods using this RuntimeClass can only be scheduled to a node matched by this selector. The RuntimeClass nodeSelector is merged with a pod's existing nodeSelector. Any conflicts will cause the pod to be rejected in admission.
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * nodeSelector lists labels that must be present on nodes that support this RuntimeClass. Pods using this RuntimeClass can only be scheduled to a node matched by this selector. The RuntimeClass nodeSelector is merged with a pod's existing nodeSelector. Any conflicts will cause the pod to be rejected in admission.
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * tolerations are appended (excluding duplicates) to pods running with this RuntimeClass during admission, effectively unioning the set of nodes tolerated by the pod and the RuntimeClass.
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * tolerations are appended (excluding duplicates) to pods running with this RuntimeClass during admission, effectively unioning the set of nodes tolerated by the pod and the RuntimeClass.
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
diff --git a/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1/Eviction.java b/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1/Eviction.java
index 4ec9d785578..1e0f8b0d72b 100644
--- a/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1/Eviction.java
+++ b/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1/Eviction.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Eviction evicts a pod from its node subject to certain policies and safety constraints. This is a subresource of Pod.  A request to cause such an eviction is created by POSTing to .../pods/&lt;pod name&gt;/evictions.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,16 +79,10 @@
 public class Eviction implements Editable<EvictionBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "policy/v1";
     @JsonProperty("deleteOptions")
     private DeleteOptions deleteOptions;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Eviction";
     @JsonProperty("metadata")
@@ -108,7 +105,7 @@ public Eviction(String apiVersion, DeleteOptions deleteOptions, String kind, Obj
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -116,25 +113,31 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Eviction evicts a pod from its node subject to certain policies and safety constraints. This is a subresource of Pod.  A request to cause such an eviction is created by POSTing to .../pods/&lt;pod name&gt;/evictions.
+     */
     @JsonProperty("deleteOptions")
     public DeleteOptions getDeleteOptions() {
         return deleteOptions;
     }
 
+    /**
+     * Eviction evicts a pod from its node subject to certain policies and safety constraints. This is a subresource of Pod.  A request to cause such an eviction is created by POSTing to .../pods/&lt;pod name&gt;/evictions.
+     */
     @JsonProperty("deleteOptions")
     public void setDeleteOptions(DeleteOptions deleteOptions) {
         this.deleteOptions = deleteOptions;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -142,18 +145,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Eviction evicts a pod from its node subject to certain policies and safety constraints. This is a subresource of Pod.  A request to cause such an eviction is created by POSTing to .../pods/&lt;pod name&gt;/evictions.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Eviction evicts a pod from its node subject to certain policies and safety constraints. This is a subresource of Pod.  A request to cause such an eviction is created by POSTing to .../pods/&lt;pod name&gt;/evictions.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1/PodDisruptionBudget.java b/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1/PodDisruptionBudget.java
index dcc9ade7bb3..c88985b0a32 100644
--- a/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1/PodDisruptionBudget.java
+++ b/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1/PodDisruptionBudget.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodDisruptionBudget is an object to define the max disruption that can be caused to a collection of pods
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class PodDisruptionBudget implements Editable<PodDisruptionBudgetBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "policy/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodDisruptionBudget";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PodDisruptionBudget(String apiVersion, String kind, ObjectMeta metadata,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodDisruptionBudget is an object to define the max disruption that can be caused to a collection of pods
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodDisruptionBudget is an object to define the max disruption that can be caused to a collection of pods
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PodDisruptionBudget is an object to define the max disruption that can be caused to a collection of pods
+     */
     @JsonProperty("spec")
     public PodDisruptionBudgetSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PodDisruptionBudget is an object to define the max disruption that can be caused to a collection of pods
+     */
     @JsonProperty("spec")
     public void setSpec(PodDisruptionBudgetSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PodDisruptionBudget is an object to define the max disruption that can be caused to a collection of pods
+     */
     @JsonProperty("status")
     public PodDisruptionBudgetStatus getStatus() {
         return status;
     }
 
+    /**
+     * PodDisruptionBudget is an object to define the max disruption that can be caused to a collection of pods
+     */
     @JsonProperty("status")
     public void setStatus(PodDisruptionBudgetStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1/PodDisruptionBudgetList.java b/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1/PodDisruptionBudgetList.java
index eb54e8bdfc2..8aebc376d17 100644
--- a/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1/PodDisruptionBudgetList.java
+++ b/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1/PodDisruptionBudgetList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodDisruptionBudgetList is a collection of PodDisruptionBudgets.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PodDisruptionBudgetList implements Editable<PodDisruptionBudgetListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.policy.v1.PodDisruptionBudget>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "policy/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.policy.v1.PodDisruptionBudget> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodDisruptionBudgetList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PodDisruptionBudgetList(String apiVersion, List<io.fabric8.kubernetes.api
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of PodDisruptionBudgets
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.policy.v1.PodDisruptionBudget> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of PodDisruptionBudgets
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.policy.v1.PodDisruptionBudget> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodDisruptionBudgetList is a collection of PodDisruptionBudgets.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodDisruptionBudgetList is a collection of PodDisruptionBudgets.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1/PodDisruptionBudgetSpec.java b/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1/PodDisruptionBudgetSpec.java
index 01b418ca5e0..3b4e0dcbe25 100644
--- a/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1/PodDisruptionBudgetSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1/PodDisruptionBudgetSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodDisruptionBudgetSpec is a description of a PodDisruptionBudget.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public PodDisruptionBudgetSpec(IntOrString maxUnavailable, IntOrString minAvaila
         this.unhealthyPodEvictionPolicy = unhealthyPodEvictionPolicy;
     }
 
+    /**
+     * PodDisruptionBudgetSpec is a description of a PodDisruptionBudget.
+     */
     @JsonProperty("maxUnavailable")
     public IntOrString getMaxUnavailable() {
         return maxUnavailable;
     }
 
+    /**
+     * PodDisruptionBudgetSpec is a description of a PodDisruptionBudget.
+     */
     @JsonProperty("maxUnavailable")
     public void setMaxUnavailable(IntOrString maxUnavailable) {
         this.maxUnavailable = maxUnavailable;
     }
 
+    /**
+     * PodDisruptionBudgetSpec is a description of a PodDisruptionBudget.
+     */
     @JsonProperty("minAvailable")
     public IntOrString getMinAvailable() {
         return minAvailable;
     }
 
+    /**
+     * PodDisruptionBudgetSpec is a description of a PodDisruptionBudget.
+     */
     @JsonProperty("minAvailable")
     public void setMinAvailable(IntOrString minAvailable) {
         this.minAvailable = minAvailable;
     }
 
+    /**
+     * PodDisruptionBudgetSpec is a description of a PodDisruptionBudget.
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * PodDisruptionBudgetSpec is a description of a PodDisruptionBudget.
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * UnhealthyPodEvictionPolicy defines the criteria for when unhealthy pods should be considered for eviction. Current implementation considers healthy pods, as pods that have status.conditions item with type="Ready",status="True".<br><p> <br><p> Valid policies are IfHealthyBudget and AlwaysAllow. If no policy is specified, the default behavior will be used, which corresponds to the IfHealthyBudget policy.<br><p> <br><p> IfHealthyBudget policy means that running pods (status.phase="Running"), but not yet healthy can be evicted only if the guarded application is not disrupted (status.currentHealthy is at least equal to status.desiredHealthy). Healthy pods will be subject to the PDB for eviction.<br><p> <br><p> AlwaysAllow policy means that all running pods (status.phase="Running"), but not yet healthy are considered disrupted and can be evicted regardless of whether the criteria in a PDB is met. This means perspective running pods of a disrupted application might not get a chance to become healthy. Healthy pods will be subject to the PDB for eviction.<br><p> <br><p> Additional policies may be added in the future. Clients making eviction decisions should disallow eviction of unhealthy pods if they encounter an unrecognized policy in this field.<br><p> <br><p> This field is beta-level. The eviction API uses this field when the feature gate PDBUnhealthyPodEvictionPolicy is enabled (enabled by default).
+     */
     @JsonProperty("unhealthyPodEvictionPolicy")
     public String getUnhealthyPodEvictionPolicy() {
         return unhealthyPodEvictionPolicy;
     }
 
+    /**
+     * UnhealthyPodEvictionPolicy defines the criteria for when unhealthy pods should be considered for eviction. Current implementation considers healthy pods, as pods that have status.conditions item with type="Ready",status="True".<br><p> <br><p> Valid policies are IfHealthyBudget and AlwaysAllow. If no policy is specified, the default behavior will be used, which corresponds to the IfHealthyBudget policy.<br><p> <br><p> IfHealthyBudget policy means that running pods (status.phase="Running"), but not yet healthy can be evicted only if the guarded application is not disrupted (status.currentHealthy is at least equal to status.desiredHealthy). Healthy pods will be subject to the PDB for eviction.<br><p> <br><p> AlwaysAllow policy means that all running pods (status.phase="Running"), but not yet healthy are considered disrupted and can be evicted regardless of whether the criteria in a PDB is met. This means perspective running pods of a disrupted application might not get a chance to become healthy. Healthy pods will be subject to the PDB for eviction.<br><p> <br><p> Additional policies may be added in the future. Clients making eviction decisions should disallow eviction of unhealthy pods if they encounter an unrecognized policy in this field.<br><p> <br><p> This field is beta-level. The eviction API uses this field when the feature gate PDBUnhealthyPodEvictionPolicy is enabled (enabled by default).
+     */
     @JsonProperty("unhealthyPodEvictionPolicy")
     public void setUnhealthyPodEvictionPolicy(String unhealthyPodEvictionPolicy) {
         this.unhealthyPodEvictionPolicy = unhealthyPodEvictionPolicy;
diff --git a/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1/PodDisruptionBudgetStatus.java b/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1/PodDisruptionBudgetStatus.java
index f9a49936b5b..9886d2b4a0e 100644
--- a/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1/PodDisruptionBudgetStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1/PodDisruptionBudgetStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodDisruptionBudgetStatus represents information about the status of a PodDisruptionBudget. Status may trail the actual state of a system.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -107,73 +110,115 @@ public PodDisruptionBudgetStatus(List<Condition> conditions, Integer currentHeal
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Conditions contain conditions for PDB. The disruption controller sets the DisruptionAllowed condition. The following are known values for the reason field (additional reasons could be added in the future): - SyncFailed: The controller encountered an error and wasn't able to compute<br><p>               the number of allowed disruptions. Therefore no disruptions are<br><p>               allowed and the status of the condition will be False.<br><p> - InsufficientPods: The number of pods are either at or below the number<br><p>                     required by the PodDisruptionBudget. No disruptions are<br><p>                     allowed and the status of the condition will be False.<br><p> - SufficientPods: There are more pods than required by the PodDisruptionBudget.<br><p>                   The condition will be True, and the number of allowed<br><p>                   disruptions are provided by the disruptionsAllowed property.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions contain conditions for PDB. The disruption controller sets the DisruptionAllowed condition. The following are known values for the reason field (additional reasons could be added in the future): - SyncFailed: The controller encountered an error and wasn't able to compute<br><p>               the number of allowed disruptions. Therefore no disruptions are<br><p>               allowed and the status of the condition will be False.<br><p> - InsufficientPods: The number of pods are either at or below the number<br><p>                     required by the PodDisruptionBudget. No disruptions are<br><p>                     allowed and the status of the condition will be False.<br><p> - SufficientPods: There are more pods than required by the PodDisruptionBudget.<br><p>                   The condition will be True, and the number of allowed<br><p>                   disruptions are provided by the disruptionsAllowed property.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * current number of healthy pods
+     */
     @JsonProperty("currentHealthy")
     public Integer getCurrentHealthy() {
         return currentHealthy;
     }
 
+    /**
+     * current number of healthy pods
+     */
     @JsonProperty("currentHealthy")
     public void setCurrentHealthy(Integer currentHealthy) {
         this.currentHealthy = currentHealthy;
     }
 
+    /**
+     * minimum desired number of healthy pods
+     */
     @JsonProperty("desiredHealthy")
     public Integer getDesiredHealthy() {
         return desiredHealthy;
     }
 
+    /**
+     * minimum desired number of healthy pods
+     */
     @JsonProperty("desiredHealthy")
     public void setDesiredHealthy(Integer desiredHealthy) {
         this.desiredHealthy = desiredHealthy;
     }
 
+    /**
+     * DisruptedPods contains information about pods whose eviction was processed by the API server eviction subresource handler but has not yet been observed by the PodDisruptionBudget controller. A pod will be in this map from the time when the API server processed the eviction request to the time when the pod is seen by PDB controller as having been marked for deletion (or after a timeout). The key in the map is the name of the pod and the value is the time when the API server processed the eviction request. If the deletion didn't occur and a pod is still there it will be removed from the list automatically by PodDisruptionBudget controller after some time. If everything goes smooth this map should be empty for the most of the time. Large number of entries in the map may indicate problems with pod deletions.
+     */
     @JsonProperty("disruptedPods")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getDisruptedPods() {
         return disruptedPods;
     }
 
+    /**
+     * DisruptedPods contains information about pods whose eviction was processed by the API server eviction subresource handler but has not yet been observed by the PodDisruptionBudget controller. A pod will be in this map from the time when the API server processed the eviction request to the time when the pod is seen by PDB controller as having been marked for deletion (or after a timeout). The key in the map is the name of the pod and the value is the time when the API server processed the eviction request. If the deletion didn't occur and a pod is still there it will be removed from the list automatically by PodDisruptionBudget controller after some time. If everything goes smooth this map should be empty for the most of the time. Large number of entries in the map may indicate problems with pod deletions.
+     */
     @JsonProperty("disruptedPods")
     public void setDisruptedPods(Map<String, String> disruptedPods) {
         this.disruptedPods = disruptedPods;
     }
 
+    /**
+     * Number of pod disruptions that are currently allowed.
+     */
     @JsonProperty("disruptionsAllowed")
     public Integer getDisruptionsAllowed() {
         return disruptionsAllowed;
     }
 
+    /**
+     * Number of pod disruptions that are currently allowed.
+     */
     @JsonProperty("disruptionsAllowed")
     public void setDisruptionsAllowed(Integer disruptionsAllowed) {
         this.disruptionsAllowed = disruptionsAllowed;
     }
 
+    /**
+     * total number of pods counted by this disruption budget
+     */
     @JsonProperty("expectedPods")
     public Integer getExpectedPods() {
         return expectedPods;
     }
 
+    /**
+     * total number of pods counted by this disruption budget
+     */
     @JsonProperty("expectedPods")
     public void setExpectedPods(Integer expectedPods) {
         this.expectedPods = expectedPods;
     }
 
+    /**
+     * Most recent generation observed when updating this PDB status. DisruptionsAllowed and other status information is valid only if observedGeneration equals to PDB's object generation.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * Most recent generation observed when updating this PDB status. DisruptionsAllowed and other status information is valid only if observedGeneration equals to PDB's object generation.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1beta1/Eviction.java b/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1beta1/Eviction.java
index e6b90aab37c..fb219f6d90e 100644
--- a/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1beta1/Eviction.java
+++ b/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1beta1/Eviction.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Eviction evicts a pod from its node subject to certain policies and safety constraints. This is a subresource of Pod.  A request to cause such an eviction is created by POSTing to .../pods/&lt;pod name&gt;/evictions.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,16 +79,10 @@
 public class Eviction implements Editable<EvictionBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "policy/v1beta1";
     @JsonProperty("deleteOptions")
     private DeleteOptions deleteOptions;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Eviction";
     @JsonProperty("metadata")
@@ -108,7 +105,7 @@ public Eviction(String apiVersion, DeleteOptions deleteOptions, String kind, Obj
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -116,25 +113,31 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Eviction evicts a pod from its node subject to certain policies and safety constraints. This is a subresource of Pod.  A request to cause such an eviction is created by POSTing to .../pods/&lt;pod name&gt;/evictions.
+     */
     @JsonProperty("deleteOptions")
     public DeleteOptions getDeleteOptions() {
         return deleteOptions;
     }
 
+    /**
+     * Eviction evicts a pod from its node subject to certain policies and safety constraints. This is a subresource of Pod.  A request to cause such an eviction is created by POSTing to .../pods/&lt;pod name&gt;/evictions.
+     */
     @JsonProperty("deleteOptions")
     public void setDeleteOptions(DeleteOptions deleteOptions) {
         this.deleteOptions = deleteOptions;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -142,18 +145,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Eviction evicts a pod from its node subject to certain policies and safety constraints. This is a subresource of Pod.  A request to cause such an eviction is created by POSTing to .../pods/&lt;pod name&gt;/evictions.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Eviction evicts a pod from its node subject to certain policies and safety constraints. This is a subresource of Pod.  A request to cause such an eviction is created by POSTing to .../pods/&lt;pod name&gt;/evictions.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1beta1/PodDisruptionBudget.java b/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1beta1/PodDisruptionBudget.java
index 1e98c9743b5..7c99f4378d6 100644
--- a/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1beta1/PodDisruptionBudget.java
+++ b/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1beta1/PodDisruptionBudget.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodDisruptionBudget is an object to define the max disruption that can be caused to a collection of pods
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class PodDisruptionBudget implements Editable<PodDisruptionBudgetBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "policy/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodDisruptionBudget";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PodDisruptionBudget(String apiVersion, String kind, ObjectMeta metadata,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodDisruptionBudget is an object to define the max disruption that can be caused to a collection of pods
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodDisruptionBudget is an object to define the max disruption that can be caused to a collection of pods
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PodDisruptionBudget is an object to define the max disruption that can be caused to a collection of pods
+     */
     @JsonProperty("spec")
     public PodDisruptionBudgetSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PodDisruptionBudget is an object to define the max disruption that can be caused to a collection of pods
+     */
     @JsonProperty("spec")
     public void setSpec(PodDisruptionBudgetSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PodDisruptionBudget is an object to define the max disruption that can be caused to a collection of pods
+     */
     @JsonProperty("status")
     public PodDisruptionBudgetStatus getStatus() {
         return status;
     }
 
+    /**
+     * PodDisruptionBudget is an object to define the max disruption that can be caused to a collection of pods
+     */
     @JsonProperty("status")
     public void setStatus(PodDisruptionBudgetStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1beta1/PodDisruptionBudgetList.java b/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1beta1/PodDisruptionBudgetList.java
index 93d82ad91da..412ef7062a6 100644
--- a/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1beta1/PodDisruptionBudgetList.java
+++ b/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1beta1/PodDisruptionBudgetList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodDisruptionBudgetList is a collection of PodDisruptionBudgets.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PodDisruptionBudgetList implements Editable<PodDisruptionBudgetListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.policy.v1beta1.PodDisruptionBudget>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "policy/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.policy.v1beta1.PodDisruptionBudget> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodDisruptionBudgetList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PodDisruptionBudgetList(String apiVersion, List<io.fabric8.kubernetes.api
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PodDisruptionBudgetList is a collection of PodDisruptionBudgets.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.policy.v1beta1.PodDisruptionBudget> getItems() {
         return items;
     }
 
+    /**
+     * PodDisruptionBudgetList is a collection of PodDisruptionBudgets.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.policy.v1beta1.PodDisruptionBudget> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodDisruptionBudgetList is a collection of PodDisruptionBudgets.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodDisruptionBudgetList is a collection of PodDisruptionBudgets.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1beta1/PodDisruptionBudgetSpec.java b/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1beta1/PodDisruptionBudgetSpec.java
index 1dd904304f7..5536e979f83 100644
--- a/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1beta1/PodDisruptionBudgetSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1beta1/PodDisruptionBudgetSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodDisruptionBudgetSpec is a description of a PodDisruptionBudget.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public PodDisruptionBudgetSpec(IntOrString maxUnavailable, IntOrString minAvaila
         this.selector = selector;
     }
 
+    /**
+     * PodDisruptionBudgetSpec is a description of a PodDisruptionBudget.
+     */
     @JsonProperty("maxUnavailable")
     public IntOrString getMaxUnavailable() {
         return maxUnavailable;
     }
 
+    /**
+     * PodDisruptionBudgetSpec is a description of a PodDisruptionBudget.
+     */
     @JsonProperty("maxUnavailable")
     public void setMaxUnavailable(IntOrString maxUnavailable) {
         this.maxUnavailable = maxUnavailable;
     }
 
+    /**
+     * PodDisruptionBudgetSpec is a description of a PodDisruptionBudget.
+     */
     @JsonProperty("minAvailable")
     public IntOrString getMinAvailable() {
         return minAvailable;
     }
 
+    /**
+     * PodDisruptionBudgetSpec is a description of a PodDisruptionBudget.
+     */
     @JsonProperty("minAvailable")
     public void setMinAvailable(IntOrString minAvailable) {
         this.minAvailable = minAvailable;
     }
 
+    /**
+     * PodDisruptionBudgetSpec is a description of a PodDisruptionBudget.
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * PodDisruptionBudgetSpec is a description of a PodDisruptionBudget.
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
diff --git a/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1beta1/PodDisruptionBudgetStatus.java b/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1beta1/PodDisruptionBudgetStatus.java
index 61bcb153d93..4d6c178ce01 100644
--- a/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1beta1/PodDisruptionBudgetStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-policy/src/generated/java/io/fabric8/kubernetes/api/model/policy/v1beta1/PodDisruptionBudgetStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodDisruptionBudgetStatus represents information about the status of a PodDisruptionBudget. Status may trail the actual state of a system.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -107,73 +110,115 @@ public PodDisruptionBudgetStatus(List<Condition> conditions, Integer currentHeal
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Conditions contain conditions for PDB. The disruption controller sets the DisruptionAllowed condition. The following are known values for the reason field (additional reasons could be added in the future): - SyncFailed: The controller encountered an error and wasn't able to compute<br><p>               the number of allowed disruptions. Therefore no disruptions are<br><p>               allowed and the status of the condition will be False.<br><p> - InsufficientPods: The number of pods are either at or below the number<br><p>                     required by the PodDisruptionBudget. No disruptions are<br><p>                     allowed and the status of the condition will be False.<br><p> - SufficientPods: There are more pods than required by the PodDisruptionBudget.<br><p>                   The condition will be True, and the number of allowed<br><p>                   disruptions are provided by the disruptionsAllowed property.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions contain conditions for PDB. The disruption controller sets the DisruptionAllowed condition. The following are known values for the reason field (additional reasons could be added in the future): - SyncFailed: The controller encountered an error and wasn't able to compute<br><p>               the number of allowed disruptions. Therefore no disruptions are<br><p>               allowed and the status of the condition will be False.<br><p> - InsufficientPods: The number of pods are either at or below the number<br><p>                     required by the PodDisruptionBudget. No disruptions are<br><p>                     allowed and the status of the condition will be False.<br><p> - SufficientPods: There are more pods than required by the PodDisruptionBudget.<br><p>                   The condition will be True, and the number of allowed<br><p>                   disruptions are provided by the disruptionsAllowed property.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * current number of healthy pods
+     */
     @JsonProperty("currentHealthy")
     public Integer getCurrentHealthy() {
         return currentHealthy;
     }
 
+    /**
+     * current number of healthy pods
+     */
     @JsonProperty("currentHealthy")
     public void setCurrentHealthy(Integer currentHealthy) {
         this.currentHealthy = currentHealthy;
     }
 
+    /**
+     * minimum desired number of healthy pods
+     */
     @JsonProperty("desiredHealthy")
     public Integer getDesiredHealthy() {
         return desiredHealthy;
     }
 
+    /**
+     * minimum desired number of healthy pods
+     */
     @JsonProperty("desiredHealthy")
     public void setDesiredHealthy(Integer desiredHealthy) {
         this.desiredHealthy = desiredHealthy;
     }
 
+    /**
+     * DisruptedPods contains information about pods whose eviction was processed by the API server eviction subresource handler but has not yet been observed by the PodDisruptionBudget controller. A pod will be in this map from the time when the API server processed the eviction request to the time when the pod is seen by PDB controller as having been marked for deletion (or after a timeout). The key in the map is the name of the pod and the value is the time when the API server processed the eviction request. If the deletion didn't occur and a pod is still there it will be removed from the list automatically by PodDisruptionBudget controller after some time. If everything goes smooth this map should be empty for the most of the time. Large number of entries in the map may indicate problems with pod deletions.
+     */
     @JsonProperty("disruptedPods")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getDisruptedPods() {
         return disruptedPods;
     }
 
+    /**
+     * DisruptedPods contains information about pods whose eviction was processed by the API server eviction subresource handler but has not yet been observed by the PodDisruptionBudget controller. A pod will be in this map from the time when the API server processed the eviction request to the time when the pod is seen by PDB controller as having been marked for deletion (or after a timeout). The key in the map is the name of the pod and the value is the time when the API server processed the eviction request. If the deletion didn't occur and a pod is still there it will be removed from the list automatically by PodDisruptionBudget controller after some time. If everything goes smooth this map should be empty for the most of the time. Large number of entries in the map may indicate problems with pod deletions.
+     */
     @JsonProperty("disruptedPods")
     public void setDisruptedPods(Map<String, String> disruptedPods) {
         this.disruptedPods = disruptedPods;
     }
 
+    /**
+     * Number of pod disruptions that are currently allowed.
+     */
     @JsonProperty("disruptionsAllowed")
     public Integer getDisruptionsAllowed() {
         return disruptionsAllowed;
     }
 
+    /**
+     * Number of pod disruptions that are currently allowed.
+     */
     @JsonProperty("disruptionsAllowed")
     public void setDisruptionsAllowed(Integer disruptionsAllowed) {
         this.disruptionsAllowed = disruptionsAllowed;
     }
 
+    /**
+     * total number of pods counted by this disruption budget
+     */
     @JsonProperty("expectedPods")
     public Integer getExpectedPods() {
         return expectedPods;
     }
 
+    /**
+     * total number of pods counted by this disruption budget
+     */
     @JsonProperty("expectedPods")
     public void setExpectedPods(Integer expectedPods) {
         this.expectedPods = expectedPods;
     }
 
+    /**
+     * Most recent generation observed when updating this PDB status. DisruptionsAllowed and other status information is valid only if observedGeneration equals to PDB's object generation.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * Most recent generation observed when updating this PDB status. DisruptionsAllowed and other status information is valid only if observedGeneration equals to PDB's object generation.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/AggregationRule.java b/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/AggregationRule.java
index a5c4b39b9b8..68ccfc4559e 100644
--- a/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/AggregationRule.java
+++ b/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/AggregationRule.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AggregationRule describes how to locate ClusterRoles to aggregate into the ClusterRole
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public AggregationRule(List<LabelSelector> clusterRoleSelectors) {
         this.clusterRoleSelectors = clusterRoleSelectors;
     }
 
+    /**
+     * ClusterRoleSelectors holds a list of selectors which will be used to find ClusterRoles and create the rules. If any of the selectors match, then the ClusterRole's permissions will be added
+     */
     @JsonProperty("clusterRoleSelectors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LabelSelector> getClusterRoleSelectors() {
         return clusterRoleSelectors;
     }
 
+    /**
+     * ClusterRoleSelectors holds a list of selectors which will be used to find ClusterRoles and create the rules. If any of the selectors match, then the ClusterRole's permissions will be added
+     */
     @JsonProperty("clusterRoleSelectors")
     public void setClusterRoleSelectors(List<LabelSelector> clusterRoleSelectors) {
         this.clusterRoleSelectors = clusterRoleSelectors;
diff --git a/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/ClusterRole.java b/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/ClusterRole.java
index 1a41634a844..aa198b57d9b 100644
--- a/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/ClusterRole.java
+++ b/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/ClusterRole.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterRole is a cluster level, logical grouping of PolicyRules that can be referenced as a unit by a RoleBinding or ClusterRoleBinding.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,14 +82,8 @@ public class ClusterRole implements Editable<ClusterRoleBuilder>, HasMetadata
 
     @JsonProperty("aggregationRule")
     private AggregationRule aggregationRule;
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "rbac.authorization.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterRole";
     @JsonProperty("metadata")
@@ -112,18 +109,24 @@ public ClusterRole(AggregationRule aggregationRule, String apiVersion, String ki
         this.rules = rules;
     }
 
+    /**
+     * ClusterRole is a cluster level, logical grouping of PolicyRules that can be referenced as a unit by a RoleBinding or ClusterRoleBinding.
+     */
     @JsonProperty("aggregationRule")
     public AggregationRule getAggregationRule() {
         return aggregationRule;
     }
 
+    /**
+     * ClusterRole is a cluster level, logical grouping of PolicyRules that can be referenced as a unit by a RoleBinding or ClusterRoleBinding.
+     */
     @JsonProperty("aggregationRule")
     public void setAggregationRule(AggregationRule aggregationRule) {
         this.aggregationRule = aggregationRule;
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -131,7 +134,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -139,7 +142,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -147,29 +150,41 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterRole is a cluster level, logical grouping of PolicyRules that can be referenced as a unit by a RoleBinding or ClusterRoleBinding.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterRole is a cluster level, logical grouping of PolicyRules that can be referenced as a unit by a RoleBinding or ClusterRoleBinding.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Rules holds all the PolicyRules for this ClusterRole
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PolicyRule> getRules() {
         return rules;
     }
 
+    /**
+     * Rules holds all the PolicyRules for this ClusterRole
+     */
     @JsonProperty("rules")
     public void setRules(List<PolicyRule> rules) {
         this.rules = rules;
diff --git a/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/ClusterRoleBinding.java b/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/ClusterRoleBinding.java
index 0998d43de85..3de3e8d8e5c 100644
--- a/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/ClusterRoleBinding.java
+++ b/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/ClusterRoleBinding.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterRoleBinding references a ClusterRole, but not contain it.  It can reference a ClusterRole in the global namespace, and adds who information via Subject.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class ClusterRoleBinding implements Editable<ClusterRoleBindingBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "rbac.authorization.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterRoleBinding";
     @JsonProperty("metadata")
@@ -113,7 +110,7 @@ public ClusterRoleBinding(String apiVersion, String kind, ObjectMeta metadata, R
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -121,7 +118,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -129,7 +126,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -137,39 +134,57 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterRoleBinding references a ClusterRole, but not contain it.  It can reference a ClusterRole in the global namespace, and adds who information via Subject.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterRoleBinding references a ClusterRole, but not contain it.  It can reference a ClusterRole in the global namespace, and adds who information via Subject.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ClusterRoleBinding references a ClusterRole, but not contain it.  It can reference a ClusterRole in the global namespace, and adds who information via Subject.
+     */
     @JsonProperty("roleRef")
     public RoleRef getRoleRef() {
         return roleRef;
     }
 
+    /**
+     * ClusterRoleBinding references a ClusterRole, but not contain it.  It can reference a ClusterRole in the global namespace, and adds who information via Subject.
+     */
     @JsonProperty("roleRef")
     public void setRoleRef(RoleRef roleRef) {
         this.roleRef = roleRef;
     }
 
+    /**
+     * Subjects holds references to the objects the role applies to.
+     */
     @JsonProperty("subjects")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Subject> getSubjects() {
         return subjects;
     }
 
+    /**
+     * Subjects holds references to the objects the role applies to.
+     */
     @JsonProperty("subjects")
     public void setSubjects(List<Subject> subjects) {
         this.subjects = subjects;
diff --git a/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/ClusterRoleBindingList.java b/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/ClusterRoleBindingList.java
index beee22b47c5..f7ae18591ec 100644
--- a/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/ClusterRoleBindingList.java
+++ b/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/ClusterRoleBindingList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterRoleBindingList is a collection of ClusterRoleBindings
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ClusterRoleBindingList implements Editable<ClusterRoleBindingListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.rbac.ClusterRoleBinding>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "rbac.authorization.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.rbac.ClusterRoleBinding> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterRoleBindingList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterRoleBindingList(String apiVersion, List<io.fabric8.kubernetes.api.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of ClusterRoleBindings
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.rbac.ClusterRoleBinding> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of ClusterRoleBindings
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.rbac.ClusterRoleBinding> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterRoleBindingList is a collection of ClusterRoleBindings
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterRoleBindingList is a collection of ClusterRoleBindings
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/ClusterRoleList.java b/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/ClusterRoleList.java
index 3ea830133f8..7e575f5d656 100644
--- a/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/ClusterRoleList.java
+++ b/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/ClusterRoleList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterRoleList is a collection of ClusterRoles
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ClusterRoleList implements Editable<ClusterRoleListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.rbac.ClusterRole>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "rbac.authorization.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.rbac.ClusterRole> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterRoleList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterRoleList(String apiVersion, List<io.fabric8.kubernetes.api.model.r
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of ClusterRoles
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.rbac.ClusterRole> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of ClusterRoles
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.rbac.ClusterRole> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterRoleList is a collection of ClusterRoles
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterRoleList is a collection of ClusterRoles
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/PolicyRule.java b/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/PolicyRule.java
index c7e225de3c9..c5eded0b8ac 100644
--- a/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/PolicyRule.java
+++ b/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/PolicyRule.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PolicyRule holds information that describes a policy rule, but does not contain information about who the rule applies to or which namespace the rule applies to.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,56 +104,86 @@ public PolicyRule(List<String> apiGroups, List<String> nonResourceURLs, List<Str
         this.verbs = verbs;
     }
 
+    /**
+     * APIGroups is the name of the APIGroup that contains the resources.  If multiple API groups are specified, any action requested against one of the enumerated resources in any API group will be allowed. "" represents the core API group and "&#42;" represents all API groups.
+     */
     @JsonProperty("apiGroups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiGroups() {
         return apiGroups;
     }
 
+    /**
+     * APIGroups is the name of the APIGroup that contains the resources.  If multiple API groups are specified, any action requested against one of the enumerated resources in any API group will be allowed. "" represents the core API group and "&#42;" represents all API groups.
+     */
     @JsonProperty("apiGroups")
     public void setApiGroups(List<String> apiGroups) {
         this.apiGroups = apiGroups;
     }
 
+    /**
+     * NonResourceURLs is a set of partial urls that a user should have access to.  &#42;s are allowed, but only as the full, final step in the path Since non-resource URLs are not namespaced, this field is only applicable for ClusterRoles referenced from a ClusterRoleBinding. Rules can either apply to API resources (such as "pods" or "secrets") or non-resource URL paths (such as "/api"),  but not both.
+     */
     @JsonProperty("nonResourceURLs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNonResourceURLs() {
         return nonResourceURLs;
     }
 
+    /**
+     * NonResourceURLs is a set of partial urls that a user should have access to.  &#42;s are allowed, but only as the full, final step in the path Since non-resource URLs are not namespaced, this field is only applicable for ClusterRoles referenced from a ClusterRoleBinding. Rules can either apply to API resources (such as "pods" or "secrets") or non-resource URL paths (such as "/api"),  but not both.
+     */
     @JsonProperty("nonResourceURLs")
     public void setNonResourceURLs(List<String> nonResourceURLs) {
         this.nonResourceURLs = nonResourceURLs;
     }
 
+    /**
+     * ResourceNames is an optional white list of names that the rule applies to.  An empty set means that everything is allowed.
+     */
     @JsonProperty("resourceNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getResourceNames() {
         return resourceNames;
     }
 
+    /**
+     * ResourceNames is an optional white list of names that the rule applies to.  An empty set means that everything is allowed.
+     */
     @JsonProperty("resourceNames")
     public void setResourceNames(List<String> resourceNames) {
         this.resourceNames = resourceNames;
     }
 
+    /**
+     * Resources is a list of resources this rule applies to. '&#42;' represents all resources.
+     */
     @JsonProperty("resources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getResources() {
         return resources;
     }
 
+    /**
+     * Resources is a list of resources this rule applies to. '&#42;' represents all resources.
+     */
     @JsonProperty("resources")
     public void setResources(List<String> resources) {
         this.resources = resources;
     }
 
+    /**
+     * Verbs is a list of Verbs that apply to ALL the ResourceKinds contained in this rule. '&#42;' represents all verbs.
+     */
     @JsonProperty("verbs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getVerbs() {
         return verbs;
     }
 
+    /**
+     * Verbs is a list of Verbs that apply to ALL the ResourceKinds contained in this rule. '&#42;' represents all verbs.
+     */
     @JsonProperty("verbs")
     public void setVerbs(List<String> verbs) {
         this.verbs = verbs;
diff --git a/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/Role.java b/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/Role.java
index 86726a5a517..36c04be6d49 100644
--- a/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/Role.java
+++ b/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/Role.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Role is a namespaced, logical grouping of PolicyRules that can be referenced as a unit by a RoleBinding.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class Role implements Editable<RoleBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "rbac.authorization.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Role";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public Role(String apiVersion, String kind, ObjectMeta metadata, List<PolicyRule
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,29 +131,41 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Role is a namespaced, logical grouping of PolicyRules that can be referenced as a unit by a RoleBinding.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Role is a namespaced, logical grouping of PolicyRules that can be referenced as a unit by a RoleBinding.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Rules holds all the PolicyRules for this Role
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PolicyRule> getRules() {
         return rules;
     }
 
+    /**
+     * Rules holds all the PolicyRules for this Role
+     */
     @JsonProperty("rules")
     public void setRules(List<PolicyRule> rules) {
         this.rules = rules;
diff --git a/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/RoleBinding.java b/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/RoleBinding.java
index 23da6cfb9ab..5e004199642 100644
--- a/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/RoleBinding.java
+++ b/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/RoleBinding.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RoleBinding references a role, but does not contain it.  It can reference a Role in the same namespace or a ClusterRole in the global namespace. It adds who information via Subjects and namespace information by which namespace it exists in.  RoleBindings in a given namespace only have effect in that namespace.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,14 +81,8 @@
 public class RoleBinding implements Editable<RoleBindingBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "rbac.authorization.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "RoleBinding";
     @JsonProperty("metadata")
@@ -114,7 +111,7 @@ public RoleBinding(String apiVersion, String kind, ObjectMeta metadata, RoleRef
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -122,7 +119,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -130,7 +127,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -138,39 +135,57 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RoleBinding references a role, but does not contain it.  It can reference a Role in the same namespace or a ClusterRole in the global namespace. It adds who information via Subjects and namespace information by which namespace it exists in.  RoleBindings in a given namespace only have effect in that namespace.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RoleBinding references a role, but does not contain it.  It can reference a Role in the same namespace or a ClusterRole in the global namespace. It adds who information via Subjects and namespace information by which namespace it exists in.  RoleBindings in a given namespace only have effect in that namespace.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * RoleBinding references a role, but does not contain it.  It can reference a Role in the same namespace or a ClusterRole in the global namespace. It adds who information via Subjects and namespace information by which namespace it exists in.  RoleBindings in a given namespace only have effect in that namespace.
+     */
     @JsonProperty("roleRef")
     public RoleRef getRoleRef() {
         return roleRef;
     }
 
+    /**
+     * RoleBinding references a role, but does not contain it.  It can reference a Role in the same namespace or a ClusterRole in the global namespace. It adds who information via Subjects and namespace information by which namespace it exists in.  RoleBindings in a given namespace only have effect in that namespace.
+     */
     @JsonProperty("roleRef")
     public void setRoleRef(RoleRef roleRef) {
         this.roleRef = roleRef;
     }
 
+    /**
+     * Subjects holds references to the objects the role applies to.
+     */
     @JsonProperty("subjects")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Subject> getSubjects() {
         return subjects;
     }
 
+    /**
+     * Subjects holds references to the objects the role applies to.
+     */
     @JsonProperty("subjects")
     public void setSubjects(List<Subject> subjects) {
         this.subjects = subjects;
diff --git a/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/RoleBindingList.java b/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/RoleBindingList.java
index 72b85a73ccd..1829e5c176f 100644
--- a/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/RoleBindingList.java
+++ b/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/RoleBindingList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RoleBindingList is a collection of RoleBindings
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class RoleBindingList implements Editable<RoleBindingListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.rbac.RoleBinding>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "rbac.authorization.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.rbac.RoleBinding> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "RoleBindingList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public RoleBindingList(String apiVersion, List<io.fabric8.kubernetes.api.model.r
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of RoleBindings
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.rbac.RoleBinding> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of RoleBindings
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.rbac.RoleBinding> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RoleBindingList is a collection of RoleBindings
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RoleBindingList is a collection of RoleBindings
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/RoleList.java b/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/RoleList.java
index c5cd4b5285a..d868ca63ae8 100644
--- a/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/RoleList.java
+++ b/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/RoleList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RoleList is a collection of Roles
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class RoleList implements Editable<RoleListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.rbac.Role>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "rbac.authorization.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.rbac.Role> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "RoleList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public RoleList(String apiVersion, List<io.fabric8.kubernetes.api.model.rbac.Rol
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of Roles
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.rbac.Role> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of Roles
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.rbac.Role> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RoleList is a collection of Roles
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RoleList is a collection of Roles
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/RoleRef.java b/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/RoleRef.java
index b48d5a28fd5..86e11d8c406 100644
--- a/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/RoleRef.java
+++ b/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/RoleRef.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RoleRef contains information that points to the role being used
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public RoleRef(String apiGroup, String kind, String name) {
         this.name = name;
     }
 
+    /**
+     * APIGroup is the group for the resource being referenced
+     */
     @JsonProperty("apiGroup")
     public String getApiGroup() {
         return apiGroup;
     }
 
+    /**
+     * APIGroup is the group for the resource being referenced
+     */
     @JsonProperty("apiGroup")
     public void setApiGroup(String apiGroup) {
         this.apiGroup = apiGroup;
     }
 
+    /**
+     * Kind is the type of resource being referenced
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is the type of resource being referenced
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of resource being referenced
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of resource being referenced
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/Subject.java b/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/Subject.java
index b0c67980744..75025643acb 100644
--- a/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/Subject.java
+++ b/kubernetes-model-generator/kubernetes-model-rbac/src/generated/java/io/fabric8/kubernetes/api/model/rbac/Subject.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Subject contains a reference to the object or user identities a role binding applies to.  This can either hold a direct API object reference, or a value for non-objects such as user and group names.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public Subject(String apiGroup, String kind, String name, String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * APIGroup holds the API group of the referenced subject. Defaults to "" for ServiceAccount subjects. Defaults to "rbac.authorization.k8s.io" for User and Group subjects.
+     */
     @JsonProperty("apiGroup")
     public String getApiGroup() {
         return apiGroup;
     }
 
+    /**
+     * APIGroup holds the API group of the referenced subject. Defaults to "" for ServiceAccount subjects. Defaults to "rbac.authorization.k8s.io" for User and Group subjects.
+     */
     @JsonProperty("apiGroup")
     public void setApiGroup(String apiGroup) {
         this.apiGroup = apiGroup;
     }
 
+    /**
+     * Kind of object being referenced. Values defined by this API group are "User", "Group", and "ServiceAccount". If the Authorizer does not recognized the kind value, the Authorizer should report an error.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind of object being referenced. Values defined by this API group are "User", "Group", and "ServiceAccount". If the Authorizer does not recognized the kind value, the Authorizer should report an error.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name of the object being referenced.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the object being referenced.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace of the referenced object.  If the object kind is non-namespace, such as "User" or "Group", and this value is not empty the Authorizer should report an error.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace of the referenced object.  If the object kind is non-namespace, such as "User" or "Group", and this value is not empty the Authorizer should report an error.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/AllocationResult.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/AllocationResult.java
index e5098513941..5d491b42cc9 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/AllocationResult.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/AllocationResult.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AllocationResult contains attributes of an allocated resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,32 +93,50 @@ public AllocationResult(NodeSelector availableOnNodes, List<ResourceHandle> reso
         this.shareable = shareable;
     }
 
+    /**
+     * AllocationResult contains attributes of an allocated resource.
+     */
     @JsonProperty("availableOnNodes")
     public NodeSelector getAvailableOnNodes() {
         return availableOnNodes;
     }
 
+    /**
+     * AllocationResult contains attributes of an allocated resource.
+     */
     @JsonProperty("availableOnNodes")
     public void setAvailableOnNodes(NodeSelector availableOnNodes) {
         this.availableOnNodes = availableOnNodes;
     }
 
+    /**
+     * ResourceHandles contain the state associated with an allocation that should be maintained throughout the lifetime of a claim. Each ResourceHandle contains data that should be passed to a specific kubelet plugin once it lands on a node. This data is returned by the driver after a successful allocation and is opaque to Kubernetes. Driver documentation may explain to users how to interpret this data if needed.<br><p> <br><p> Setting this field is optional. It has a maximum size of 32 entries. If null (or empty), it is assumed this allocation will be processed by a single kubelet plugin with no ResourceHandle data attached. The name of the kubelet plugin invoked will match the DriverName set in the ResourceClaimStatus this AllocationResult is embedded in.
+     */
     @JsonProperty("resourceHandles")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ResourceHandle> getResourceHandles() {
         return resourceHandles;
     }
 
+    /**
+     * ResourceHandles contain the state associated with an allocation that should be maintained throughout the lifetime of a claim. Each ResourceHandle contains data that should be passed to a specific kubelet plugin once it lands on a node. This data is returned by the driver after a successful allocation and is opaque to Kubernetes. Driver documentation may explain to users how to interpret this data if needed.<br><p> <br><p> Setting this field is optional. It has a maximum size of 32 entries. If null (or empty), it is assumed this allocation will be processed by a single kubelet plugin with no ResourceHandle data attached. The name of the kubelet plugin invoked will match the DriverName set in the ResourceClaimStatus this AllocationResult is embedded in.
+     */
     @JsonProperty("resourceHandles")
     public void setResourceHandles(List<ResourceHandle> resourceHandles) {
         this.resourceHandles = resourceHandles;
     }
 
+    /**
+     * Shareable determines whether the resource supports more than one consumer at a time.
+     */
     @JsonProperty("shareable")
     public Boolean getShareable() {
         return shareable;
     }
 
+    /**
+     * Shareable determines whether the resource supports more than one consumer at a time.
+     */
     @JsonProperty("shareable")
     public void setShareable(Boolean shareable) {
         this.shareable = shareable;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/DriverAllocationResult.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/DriverAllocationResult.java
index 162c243bb74..eefd02864cb 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/DriverAllocationResult.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/DriverAllocationResult.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DriverAllocationResult contains vendor parameters and the allocation result for one request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public DriverAllocationResult(NamedResourcesAllocationResult namedResources, Obj
         this.vendorRequestParameters = vendorRequestParameters;
     }
 
+    /**
+     * DriverAllocationResult contains vendor parameters and the allocation result for one request.
+     */
     @JsonProperty("namedResources")
     public NamedResourcesAllocationResult getNamedResources() {
         return namedResources;
     }
 
+    /**
+     * DriverAllocationResult contains vendor parameters and the allocation result for one request.
+     */
     @JsonProperty("namedResources")
     public void setNamedResources(NamedResourcesAllocationResult namedResources) {
         this.namedResources = namedResources;
     }
 
+    /**
+     * DriverAllocationResult contains vendor parameters and the allocation result for one request.
+     */
     @JsonProperty("vendorRequestParameters")
     public Object getVendorRequestParameters() {
         return vendorRequestParameters;
     }
 
+    /**
+     * DriverAllocationResult contains vendor parameters and the allocation result for one request.
+     */
     @JsonProperty("vendorRequestParameters")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setVendorRequestParameters(Object vendorRequestParameters) {
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/DriverRequests.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/DriverRequests.java
index dfefdd0de63..ae8b3c07f90 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/DriverRequests.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/DriverRequests.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DriverRequests describes all resources that are needed from one particular driver.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,32 +93,50 @@ public DriverRequests(String driverName, List<ResourceRequest> requests, Object
         this.vendorParameters = vendorParameters;
     }
 
+    /**
+     * DriverName is the name used by the DRA driver kubelet plugin.
+     */
     @JsonProperty("driverName")
     public String getDriverName() {
         return driverName;
     }
 
+    /**
+     * DriverName is the name used by the DRA driver kubelet plugin.
+     */
     @JsonProperty("driverName")
     public void setDriverName(String driverName) {
         this.driverName = driverName;
     }
 
+    /**
+     * Requests describes all resources that are needed from the driver.
+     */
     @JsonProperty("requests")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ResourceRequest> getRequests() {
         return requests;
     }
 
+    /**
+     * Requests describes all resources that are needed from the driver.
+     */
     @JsonProperty("requests")
     public void setRequests(List<ResourceRequest> requests) {
         this.requests = requests;
     }
 
+    /**
+     * DriverRequests describes all resources that are needed from one particular driver.
+     */
     @JsonProperty("vendorParameters")
     public Object getVendorParameters() {
         return vendorParameters;
     }
 
+    /**
+     * DriverRequests describes all resources that are needed from one particular driver.
+     */
     @JsonProperty("vendorParameters")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setVendorParameters(Object vendorParameters) {
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesAllocationResult.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesAllocationResult.java
index 05633ad2cc3..9606896c285 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesAllocationResult.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesAllocationResult.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NamedResourcesAllocationResult is used in AllocationResultModel.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public NamedResourcesAllocationResult(String name) {
         this.name = name;
     }
 
+    /**
+     * Name is the name of the selected resource instance.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the selected resource instance.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesAttribute.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesAttribute.java
index 1eb414afb78..6b39d506b15 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesAttribute.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesAttribute.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NamedResourcesAttribute is a combination of an attribute name and its value.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -107,81 +110,129 @@ public NamedResourcesAttribute(Boolean bool, Long _int, NamedResourcesIntSlice i
         this.version = version;
     }
 
+    /**
+     * BoolValue is a true/false value.
+     */
     @JsonProperty("bool")
     public Boolean getBool() {
         return bool;
     }
 
+    /**
+     * BoolValue is a true/false value.
+     */
     @JsonProperty("bool")
     public void setBool(Boolean bool) {
         this.bool = bool;
     }
 
+    /**
+     * IntValue is a 64-bit integer.
+     */
     @JsonProperty("int")
     public Long getInt() {
         return _int;
     }
 
+    /**
+     * IntValue is a 64-bit integer.
+     */
     @JsonProperty("int")
     public void setInt(Long _int) {
         this._int = _int;
     }
 
+    /**
+     * NamedResourcesAttribute is a combination of an attribute name and its value.
+     */
     @JsonProperty("intSlice")
     public NamedResourcesIntSlice getIntSlice() {
         return intSlice;
     }
 
+    /**
+     * NamedResourcesAttribute is a combination of an attribute name and its value.
+     */
     @JsonProperty("intSlice")
     public void setIntSlice(NamedResourcesIntSlice intSlice) {
         this.intSlice = intSlice;
     }
 
+    /**
+     * Name is unique identifier among all resource instances managed by the driver on the node. It must be a DNS subdomain.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is unique identifier among all resource instances managed by the driver on the node. It must be a DNS subdomain.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * NamedResourcesAttribute is a combination of an attribute name and its value.
+     */
     @JsonProperty("quantity")
     public Quantity getQuantity() {
         return quantity;
     }
 
+    /**
+     * NamedResourcesAttribute is a combination of an attribute name and its value.
+     */
     @JsonProperty("quantity")
     public void setQuantity(Quantity quantity) {
         this.quantity = quantity;
     }
 
+    /**
+     * StringValue is a string.
+     */
     @JsonProperty("string")
     public String getString() {
         return string;
     }
 
+    /**
+     * StringValue is a string.
+     */
     @JsonProperty("string")
     public void setString(String string) {
         this.string = string;
     }
 
+    /**
+     * NamedResourcesAttribute is a combination of an attribute name and its value.
+     */
     @JsonProperty("stringSlice")
     public NamedResourcesStringSlice getStringSlice() {
         return stringSlice;
     }
 
+    /**
+     * NamedResourcesAttribute is a combination of an attribute name and its value.
+     */
     @JsonProperty("stringSlice")
     public void setStringSlice(NamedResourcesStringSlice stringSlice) {
         this.stringSlice = stringSlice;
     }
 
+    /**
+     * VersionValue is a semantic version according to semver.org spec 2.0.0.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * VersionValue is a semantic version according to semver.org spec 2.0.0.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesFilter.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesFilter.java
index 7de0fefe741..02667baa920 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesFilter.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesFilter.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NamedResourcesFilter is used in ResourceFilterModel.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public NamedResourcesFilter(String selector) {
         this.selector = selector;
     }
 
+    /**
+     * Selector is a CEL expression which must evaluate to true if a resource instance is suitable. The language is as defined in https://kubernetes.io/docs/reference/using-api/cel/<br><p> <br><p> In addition, for each type NamedResourcesin AttributeValue there is a map that resolves to the corresponding value of the instance under evaluation. For example:<br><p> <br><p>    attributes.quantity["a"].isGreaterThan(quantity("0")) &amp;&amp;<br><p>    attributes.stringslice["b"].isSorted()
+     */
     @JsonProperty("selector")
     public String getSelector() {
         return selector;
     }
 
+    /**
+     * Selector is a CEL expression which must evaluate to true if a resource instance is suitable. The language is as defined in https://kubernetes.io/docs/reference/using-api/cel/<br><p> <br><p> In addition, for each type NamedResourcesin AttributeValue there is a map that resolves to the corresponding value of the instance under evaluation. For example:<br><p> <br><p>    attributes.quantity["a"].isGreaterThan(quantity("0")) &amp;&amp;<br><p>    attributes.stringslice["b"].isSorted()
+     */
     @JsonProperty("selector")
     public void setSelector(String selector) {
         this.selector = selector;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesInstance.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesInstance.java
index 40885783db6..763b669ad1f 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesInstance.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesInstance.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NamedResourcesInstance represents one individual hardware instance that can be selected based on its attributes.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public NamedResourcesInstance(List<NamedResourcesAttribute> attributes, String n
         this.name = name;
     }
 
+    /**
+     * Attributes defines the attributes of this resource instance. The name of each attribute must be unique.
+     */
     @JsonProperty("attributes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NamedResourcesAttribute> getAttributes() {
         return attributes;
     }
 
+    /**
+     * Attributes defines the attributes of this resource instance. The name of each attribute must be unique.
+     */
     @JsonProperty("attributes")
     public void setAttributes(List<NamedResourcesAttribute> attributes) {
         this.attributes = attributes;
     }
 
+    /**
+     * Name is unique identifier among all resource instances managed by the driver on the node. It must be a DNS subdomain.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is unique identifier among all resource instances managed by the driver on the node. It must be a DNS subdomain.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesIntSlice.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesIntSlice.java
index ff199b936a3..8490a488f42 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesIntSlice.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesIntSlice.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NamedResourcesIntSlice contains a slice of 64-bit integers.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public NamedResourcesIntSlice(List<Long> ints) {
         this.ints = ints;
     }
 
+    /**
+     * Ints is the slice of 64-bit integers.
+     */
     @JsonProperty("ints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Long> getInts() {
         return ints;
     }
 
+    /**
+     * Ints is the slice of 64-bit integers.
+     */
     @JsonProperty("ints")
     public void setInts(List<Long> ints) {
         this.ints = ints;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesRequest.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesRequest.java
index 0d7cd7afc6f..0a9741d5a8e 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesRequest.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesRequest.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NamedResourcesRequest is used in ResourceRequestModel.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public NamedResourcesRequest(String selector) {
         this.selector = selector;
     }
 
+    /**
+     * Selector is a CEL expression which must evaluate to true if a resource instance is suitable. The language is as defined in https://kubernetes.io/docs/reference/using-api/cel/<br><p> <br><p> In addition, for each type NamedResourcesin AttributeValue there is a map that resolves to the corresponding value of the instance under evaluation. For example:<br><p> <br><p>    attributes.quantity["a"].isGreaterThan(quantity("0")) &amp;&amp;<br><p>    attributes.stringslice["b"].isSorted()
+     */
     @JsonProperty("selector")
     public String getSelector() {
         return selector;
     }
 
+    /**
+     * Selector is a CEL expression which must evaluate to true if a resource instance is suitable. The language is as defined in https://kubernetes.io/docs/reference/using-api/cel/<br><p> <br><p> In addition, for each type NamedResourcesin AttributeValue there is a map that resolves to the corresponding value of the instance under evaluation. For example:<br><p> <br><p>    attributes.quantity["a"].isGreaterThan(quantity("0")) &amp;&amp;<br><p>    attributes.stringslice["b"].isSorted()
+     */
     @JsonProperty("selector")
     public void setSelector(String selector) {
         this.selector = selector;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesResources.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesResources.java
index 3fdaee9514f..954e4905dc3 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesResources.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesResources.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NamedResourcesResources is used in ResourceModel.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public NamedResourcesResources(List<NamedResourcesInstance> instances) {
         this.instances = instances;
     }
 
+    /**
+     * The list of all individual resources instances currently available.
+     */
     @JsonProperty("instances")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NamedResourcesInstance> getInstances() {
         return instances;
     }
 
+    /**
+     * The list of all individual resources instances currently available.
+     */
     @JsonProperty("instances")
     public void setInstances(List<NamedResourcesInstance> instances) {
         this.instances = instances;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesStringSlice.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesStringSlice.java
index 14fe35eab84..087699fadd4 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesStringSlice.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/NamedResourcesStringSlice.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NamedResourcesStringSlice contains a slice of strings.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public NamedResourcesStringSlice(List<String> strings) {
         this.strings = strings;
     }
 
+    /**
+     * Strings is the slice of strings.
+     */
     @JsonProperty("strings")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getStrings() {
         return strings;
     }
 
+    /**
+     * Strings is the slice of strings.
+     */
     @JsonProperty("strings")
     public void setStrings(List<String> strings) {
         this.strings = strings;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/PodSchedulingContext.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/PodSchedulingContext.java
index 9d7e3d1604d..7c1fa01d029 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/PodSchedulingContext.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/PodSchedulingContext.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodSchedulingContext objects hold information that is needed to schedule a Pod with ResourceClaims that use "WaitForFirstConsumer" allocation mode.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class PodSchedulingContext implements Editable<PodSchedulingContextBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1alpha2";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodSchedulingContext";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PodSchedulingContext(String apiVersion, String kind, ObjectMeta metadata,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodSchedulingContext objects hold information that is needed to schedule a Pod with ResourceClaims that use "WaitForFirstConsumer" allocation mode.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodSchedulingContext objects hold information that is needed to schedule a Pod with ResourceClaims that use "WaitForFirstConsumer" allocation mode.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PodSchedulingContext objects hold information that is needed to schedule a Pod with ResourceClaims that use "WaitForFirstConsumer" allocation mode.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("spec")
     public PodSchedulingContextSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PodSchedulingContext objects hold information that is needed to schedule a Pod with ResourceClaims that use "WaitForFirstConsumer" allocation mode.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("spec")
     public void setSpec(PodSchedulingContextSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PodSchedulingContext objects hold information that is needed to schedule a Pod with ResourceClaims that use "WaitForFirstConsumer" allocation mode.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("status")
     public PodSchedulingContextStatus getStatus() {
         return status;
     }
 
+    /**
+     * PodSchedulingContext objects hold information that is needed to schedule a Pod with ResourceClaims that use "WaitForFirstConsumer" allocation mode.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("status")
     public void setStatus(PodSchedulingContextStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/PodSchedulingContextList.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/PodSchedulingContextList.java
index 62c88a9d397..a7f57c80f65 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/PodSchedulingContextList.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/PodSchedulingContextList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodSchedulingContextList is a collection of Pod scheduling objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PodSchedulingContextList implements Editable<PodSchedulingContextListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.resource.v1alpha2.PodSchedulingContext>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1alpha2";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.resource.v1alpha2.PodSchedulingContext> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodSchedulingContextList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PodSchedulingContextList(String apiVersion, List<io.fabric8.kubernetes.ap
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of PodSchedulingContext objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.resource.v1alpha2.PodSchedulingContext> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of PodSchedulingContext objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.resource.v1alpha2.PodSchedulingContext> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodSchedulingContextList is a collection of Pod scheduling objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodSchedulingContextList is a collection of Pod scheduling objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/PodSchedulingContextSpec.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/PodSchedulingContextSpec.java
index b03cdaac766..00a157e6f79 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/PodSchedulingContextSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/PodSchedulingContextSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodSchedulingContextSpec describes where resources for the Pod are needed.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public PodSchedulingContextSpec(List<String> potentialNodes, String selectedNode
         this.selectedNode = selectedNode;
     }
 
+    /**
+     * PotentialNodes lists nodes where the Pod might be able to run.<br><p> <br><p> The size of this field is limited to 128. This is large enough for many clusters. Larger clusters may need more attempts to find a node that suits all pending resources. This may get increased in the future, but not reduced.
+     */
     @JsonProperty("potentialNodes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPotentialNodes() {
         return potentialNodes;
     }
 
+    /**
+     * PotentialNodes lists nodes where the Pod might be able to run.<br><p> <br><p> The size of this field is limited to 128. This is large enough for many clusters. Larger clusters may need more attempts to find a node that suits all pending resources. This may get increased in the future, but not reduced.
+     */
     @JsonProperty("potentialNodes")
     public void setPotentialNodes(List<String> potentialNodes) {
         this.potentialNodes = potentialNodes;
     }
 
+    /**
+     * SelectedNode is the node for which allocation of ResourceClaims that are referenced by the Pod and that use "WaitForFirstConsumer" allocation is to be attempted.
+     */
     @JsonProperty("selectedNode")
     public String getSelectedNode() {
         return selectedNode;
     }
 
+    /**
+     * SelectedNode is the node for which allocation of ResourceClaims that are referenced by the Pod and that use "WaitForFirstConsumer" allocation is to be attempted.
+     */
     @JsonProperty("selectedNode")
     public void setSelectedNode(String selectedNode) {
         this.selectedNode = selectedNode;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/PodSchedulingContextStatus.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/PodSchedulingContextStatus.java
index cc2b01a66d2..dabd1793485 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/PodSchedulingContextStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/PodSchedulingContextStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodSchedulingContextStatus describes where resources for the Pod can be allocated.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public PodSchedulingContextStatus(List<ResourceClaimSchedulingStatus> resourceCl
         this.resourceClaims = resourceClaims;
     }
 
+    /**
+     * ResourceClaims describes resource availability for each pod.spec.resourceClaim entry where the corresponding ResourceClaim uses "WaitForFirstConsumer" allocation mode.
+     */
     @JsonProperty("resourceClaims")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ResourceClaimSchedulingStatus> getResourceClaims() {
         return resourceClaims;
     }
 
+    /**
+     * ResourceClaims describes resource availability for each pod.spec.resourceClaim entry where the corresponding ResourceClaim uses "WaitForFirstConsumer" allocation mode.
+     */
     @JsonProperty("resourceClaims")
     public void setResourceClaims(List<ResourceClaimSchedulingStatus> resourceClaims) {
         this.resourceClaims = resourceClaims;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaim.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaim.java
index 3a1c70446ba..66f6b401399 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaim.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaim.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaim describes which resources are needed by a resource consumer. Its status tracks whether the resource has been allocated and what the resulting attributes are.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class ResourceClaim implements Editable<ResourceClaimBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1alpha2";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResourceClaim";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ResourceClaim(String apiVersion, String kind, ObjectMeta metadata, Resour
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResourceClaim describes which resources are needed by a resource consumer. Its status tracks whether the resource has been allocated and what the resulting attributes are.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceClaim describes which resources are needed by a resource consumer. Its status tracks whether the resource has been allocated and what the resulting attributes are.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ResourceClaim describes which resources are needed by a resource consumer. Its status tracks whether the resource has been allocated and what the resulting attributes are.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("spec")
     public ResourceClaimSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ResourceClaim describes which resources are needed by a resource consumer. Its status tracks whether the resource has been allocated and what the resulting attributes are.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("spec")
     public void setSpec(ResourceClaimSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ResourceClaim describes which resources are needed by a resource consumer. Its status tracks whether the resource has been allocated and what the resulting attributes are.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("status")
     public ResourceClaimStatus getStatus() {
         return status;
     }
 
+    /**
+     * ResourceClaim describes which resources are needed by a resource consumer. Its status tracks whether the resource has been allocated and what the resulting attributes are.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("status")
     public void setStatus(ResourceClaimStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimConsumerReference.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimConsumerReference.java
index cc5916f606e..c94bde85c98 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimConsumerReference.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimConsumerReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaimConsumerReference contains enough information to let you locate the consumer of a ResourceClaim. The user must be a resource in the same namespace as the ResourceClaim.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ResourceClaimConsumerReference(String apiGroup, String name, String resou
         this.uid = uid;
     }
 
+    /**
+     * APIGroup is the group for the resource being referenced. It is empty for the core API. This matches the group in the APIVersion that is used when creating the resources.
+     */
     @JsonProperty("apiGroup")
     public String getApiGroup() {
         return apiGroup;
     }
 
+    /**
+     * APIGroup is the group for the resource being referenced. It is empty for the core API. This matches the group in the APIVersion that is used when creating the resources.
+     */
     @JsonProperty("apiGroup")
     public void setApiGroup(String apiGroup) {
         this.apiGroup = apiGroup;
     }
 
+    /**
+     * Name is the name of resource being referenced.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of resource being referenced.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Resource is the type of resource being referenced, for example "pods".
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * Resource is the type of resource being referenced, for example "pods".
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
     }
 
+    /**
+     * UID identifies exactly one incarnation of the resource.
+     */
     @JsonProperty("uid")
     public String getUid() {
         return uid;
     }
 
+    /**
+     * UID identifies exactly one incarnation of the resource.
+     */
     @JsonProperty("uid")
     public void setUid(String uid) {
         this.uid = uid;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimList.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimList.java
index cfe1722aab3..6fac0e1494b 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimList.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaimList is a collection of claims.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ResourceClaimList implements Editable<ResourceClaimListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.resource.v1alpha2.ResourceClaim>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1alpha2";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.resource.v1alpha2.ResourceClaim> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResourceClaimList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ResourceClaimList(String apiVersion, List<io.fabric8.kubernetes.api.model
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of resource claims.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.resource.v1alpha2.ResourceClaim> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of resource claims.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.resource.v1alpha2.ResourceClaim> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResourceClaimList is a collection of claims.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceClaimList is a collection of claims.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimParameters.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimParameters.java
index 8c87db80d33..aafaa8b4f79 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimParameters.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimParameters.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaimParameters defines resource requests for a ResourceClaim in an in-tree format understood by Kubernetes.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,9 +82,6 @@
 public class ResourceClaimParameters implements Editable<ResourceClaimParametersBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1alpha2";
     @JsonProperty("driverRequests")
@@ -89,9 +89,6 @@ public class ResourceClaimParameters implements Editable<ResourceClaimParameters
     private List<DriverRequests> driverRequests = new ArrayList<>();
     @JsonProperty("generatedFrom")
     private ResourceClaimParametersReference generatedFrom;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResourceClaimParameters";
     @JsonProperty("metadata")
@@ -118,7 +115,7 @@ public ResourceClaimParameters(String apiVersion, List<DriverRequests> driverReq
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -126,36 +123,48 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * DriverRequests describes all resources that are needed for the allocated claim. A single claim may use resources coming from different drivers. For each driver, this array has at most one entry which then may have one or more per-driver requests.<br><p> <br><p> May be empty, in which case the claim can always be allocated.
+     */
     @JsonProperty("driverRequests")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DriverRequests> getDriverRequests() {
         return driverRequests;
     }
 
+    /**
+     * DriverRequests describes all resources that are needed for the allocated claim. A single claim may use resources coming from different drivers. For each driver, this array has at most one entry which then may have one or more per-driver requests.<br><p> <br><p> May be empty, in which case the claim can always be allocated.
+     */
     @JsonProperty("driverRequests")
     public void setDriverRequests(List<DriverRequests> driverRequests) {
         this.driverRequests = driverRequests;
     }
 
+    /**
+     * ResourceClaimParameters defines resource requests for a ResourceClaim in an in-tree format understood by Kubernetes.
+     */
     @JsonProperty("generatedFrom")
     public ResourceClaimParametersReference getGeneratedFrom() {
         return generatedFrom;
     }
 
+    /**
+     * ResourceClaimParameters defines resource requests for a ResourceClaim in an in-tree format understood by Kubernetes.
+     */
     @JsonProperty("generatedFrom")
     public void setGeneratedFrom(ResourceClaimParametersReference generatedFrom) {
         this.generatedFrom = generatedFrom;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -163,28 +172,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResourceClaimParameters defines resource requests for a ResourceClaim in an in-tree format understood by Kubernetes.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceClaimParameters defines resource requests for a ResourceClaim in an in-tree format understood by Kubernetes.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Shareable indicates whether the allocated claim is meant to be shareable by multiple consumers at the same time.
+     */
     @JsonProperty("shareable")
     public Boolean getShareable() {
         return shareable;
     }
 
+    /**
+     * Shareable indicates whether the allocated claim is meant to be shareable by multiple consumers at the same time.
+     */
     @JsonProperty("shareable")
     public void setShareable(Boolean shareable) {
         this.shareable = shareable;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimParametersList.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimParametersList.java
index 8d03482eeda..1da65ad713e 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimParametersList.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimParametersList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaimParametersList is a collection of ResourceClaimParameters.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ResourceClaimParametersList implements Editable<ResourceClaimParametersListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.resource.v1alpha2.ResourceClaimParameters>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1alpha2";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.resource.v1alpha2.ResourceClaimParameters> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResourceClaimParametersList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ResourceClaimParametersList(String apiVersion, List<io.fabric8.kubernetes
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of node resource capacity objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.resource.v1alpha2.ResourceClaimParameters> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of node resource capacity objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.resource.v1alpha2.ResourceClaimParameters> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResourceClaimParametersList is a collection of ResourceClaimParameters.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceClaimParametersList is a collection of ResourceClaimParameters.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimParametersReference.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimParametersReference.java
index f3e880ea30f..3b90def26aa 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimParametersReference.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimParametersReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaimParametersReference contains enough information to let you locate the parameters for a ResourceClaim. The object must be in the same namespace as the ResourceClaim.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ResourceClaimParametersReference(String apiGroup, String kind, String nam
         this.name = name;
     }
 
+    /**
+     * APIGroup is the group for the resource being referenced. It is empty for the core API. This matches the group in the APIVersion that is used when creating the resources.
+     */
     @JsonProperty("apiGroup")
     public String getApiGroup() {
         return apiGroup;
     }
 
+    /**
+     * APIGroup is the group for the resource being referenced. It is empty for the core API. This matches the group in the APIVersion that is used when creating the resources.
+     */
     @JsonProperty("apiGroup")
     public void setApiGroup(String apiGroup) {
         this.apiGroup = apiGroup;
     }
 
+    /**
+     * Kind is the type of resource being referenced. This is the same value as in the parameter object's metadata, for example "ConfigMap".
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is the type of resource being referenced. This is the same value as in the parameter object's metadata, for example "ConfigMap".
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of resource being referenced.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of resource being referenced.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimSchedulingStatus.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimSchedulingStatus.java
index 746e310e558..2c41b7ddfec 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimSchedulingStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimSchedulingStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaimSchedulingStatus contains information about one particular ResourceClaim with "WaitForFirstConsumer" allocation mode.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public ResourceClaimSchedulingStatus(String name, List<String> unsuitableNodes)
         this.unsuitableNodes = unsuitableNodes;
     }
 
+    /**
+     * Name matches the pod.spec.resourceClaims[&#42;].Name field.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name matches the pod.spec.resourceClaims[&#42;].Name field.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * UnsuitableNodes lists nodes that the ResourceClaim cannot be allocated for.<br><p> <br><p> The size of this field is limited to 128, the same as for PodSchedulingSpec.PotentialNodes. This may get increased in the future, but not reduced.
+     */
     @JsonProperty("unsuitableNodes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getUnsuitableNodes() {
         return unsuitableNodes;
     }
 
+    /**
+     * UnsuitableNodes lists nodes that the ResourceClaim cannot be allocated for.<br><p> <br><p> The size of this field is limited to 128, the same as for PodSchedulingSpec.PotentialNodes. This may get increased in the future, but not reduced.
+     */
     @JsonProperty("unsuitableNodes")
     public void setUnsuitableNodes(List<String> unsuitableNodes) {
         this.unsuitableNodes = unsuitableNodes;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimSpec.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimSpec.java
index 32b013c75e6..0580a3475b4 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaimSpec defines how a resource is to be allocated.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ResourceClaimSpec(String allocationMode, ResourceClaimParametersReference
         this.resourceClassName = resourceClassName;
     }
 
+    /**
+     * Allocation can start immediately or when a Pod wants to use the resource. "WaitForFirstConsumer" is the default.
+     */
     @JsonProperty("allocationMode")
     public String getAllocationMode() {
         return allocationMode;
     }
 
+    /**
+     * Allocation can start immediately or when a Pod wants to use the resource. "WaitForFirstConsumer" is the default.
+     */
     @JsonProperty("allocationMode")
     public void setAllocationMode(String allocationMode) {
         this.allocationMode = allocationMode;
     }
 
+    /**
+     * ResourceClaimSpec defines how a resource is to be allocated.
+     */
     @JsonProperty("parametersRef")
     public ResourceClaimParametersReference getParametersRef() {
         return parametersRef;
     }
 
+    /**
+     * ResourceClaimSpec defines how a resource is to be allocated.
+     */
     @JsonProperty("parametersRef")
     public void setParametersRef(ResourceClaimParametersReference parametersRef) {
         this.parametersRef = parametersRef;
     }
 
+    /**
+     * ResourceClassName references the driver and additional parameters via the name of a ResourceClass that was created as part of the driver deployment.
+     */
     @JsonProperty("resourceClassName")
     public String getResourceClassName() {
         return resourceClassName;
     }
 
+    /**
+     * ResourceClassName references the driver and additional parameters via the name of a ResourceClass that was created as part of the driver deployment.
+     */
     @JsonProperty("resourceClassName")
     public void setResourceClassName(String resourceClassName) {
         this.resourceClassName = resourceClassName;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimStatus.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimStatus.java
index c455307679c..637c1ae5e8e 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaimStatus tracks whether the resource has been allocated and what the resulting attributes are.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public ResourceClaimStatus(AllocationResult allocation, Boolean deallocationRequ
         this.reservedFor = reservedFor;
     }
 
+    /**
+     * ResourceClaimStatus tracks whether the resource has been allocated and what the resulting attributes are.
+     */
     @JsonProperty("allocation")
     public AllocationResult getAllocation() {
         return allocation;
     }
 
+    /**
+     * ResourceClaimStatus tracks whether the resource has been allocated and what the resulting attributes are.
+     */
     @JsonProperty("allocation")
     public void setAllocation(AllocationResult allocation) {
         this.allocation = allocation;
     }
 
+    /**
+     * DeallocationRequested indicates that a ResourceClaim is to be deallocated.<br><p> <br><p> The driver then must deallocate this claim and reset the field together with clearing the Allocation field.<br><p> <br><p> While DeallocationRequested is set, no new consumers may be added to ReservedFor.
+     */
     @JsonProperty("deallocationRequested")
     public Boolean getDeallocationRequested() {
         return deallocationRequested;
     }
 
+    /**
+     * DeallocationRequested indicates that a ResourceClaim is to be deallocated.<br><p> <br><p> The driver then must deallocate this claim and reset the field together with clearing the Allocation field.<br><p> <br><p> While DeallocationRequested is set, no new consumers may be added to ReservedFor.
+     */
     @JsonProperty("deallocationRequested")
     public void setDeallocationRequested(Boolean deallocationRequested) {
         this.deallocationRequested = deallocationRequested;
     }
 
+    /**
+     * DriverName is a copy of the driver name from the ResourceClass at the time when allocation started.
+     */
     @JsonProperty("driverName")
     public String getDriverName() {
         return driverName;
     }
 
+    /**
+     * DriverName is a copy of the driver name from the ResourceClass at the time when allocation started.
+     */
     @JsonProperty("driverName")
     public void setDriverName(String driverName) {
         this.driverName = driverName;
     }
 
+    /**
+     * ReservedFor indicates which entities are currently allowed to use the claim. A Pod which references a ResourceClaim which is not reserved for that Pod will not be started.<br><p> <br><p> There can be at most 32 such reservations. This may get increased in the future, but not reduced.
+     */
     @JsonProperty("reservedFor")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ResourceClaimConsumerReference> getReservedFor() {
         return reservedFor;
     }
 
+    /**
+     * ReservedFor indicates which entities are currently allowed to use the claim. A Pod which references a ResourceClaim which is not reserved for that Pod will not be started.<br><p> <br><p> There can be at most 32 such reservations. This may get increased in the future, but not reduced.
+     */
     @JsonProperty("reservedFor")
     public void setReservedFor(List<ResourceClaimConsumerReference> reservedFor) {
         this.reservedFor = reservedFor;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimTemplate.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimTemplate.java
index 6fbaf802348..0f04c730e85 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimTemplate.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimTemplate.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaimTemplate is used to produce ResourceClaim objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ResourceClaimTemplate implements Editable<ResourceClaimTemplateBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1alpha2";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResourceClaimTemplate";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public ResourceClaimTemplate(String apiVersion, String kind, ObjectMeta metadata
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResourceClaimTemplate is used to produce ResourceClaim objects.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceClaimTemplate is used to produce ResourceClaim objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ResourceClaimTemplate is used to produce ResourceClaim objects.
+     */
     @JsonProperty("spec")
     public ResourceClaimTemplateSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ResourceClaimTemplate is used to produce ResourceClaim objects.
+     */
     @JsonProperty("spec")
     public void setSpec(ResourceClaimTemplateSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimTemplateList.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimTemplateList.java
index d59fc69800a..71796d8f796 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimTemplateList.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimTemplateList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaimTemplateList is a collection of claim templates.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ResourceClaimTemplateList implements Editable<ResourceClaimTemplateListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.resource.v1alpha2.ResourceClaimTemplate>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1alpha2";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.resource.v1alpha2.ResourceClaimTemplate> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResourceClaimTemplateList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ResourceClaimTemplateList(String apiVersion, List<io.fabric8.kubernetes.a
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of resource claim templates.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.resource.v1alpha2.ResourceClaimTemplate> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of resource claim templates.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.resource.v1alpha2.ResourceClaimTemplate> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResourceClaimTemplateList is a collection of claim templates.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceClaimTemplateList is a collection of claim templates.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimTemplateSpec.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimTemplateSpec.java
index 302b7a1906c..825c21ae4c3 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimTemplateSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClaimTemplateSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ResourceClaimTemplateSpec(ObjectMeta metadata, ResourceClaimSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.
+     */
     @JsonProperty("spec")
     public ResourceClaimSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.
+     */
     @JsonProperty("spec")
     public void setSpec(ResourceClaimSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClass.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClass.java
index 6df2647587b..5f8b7903a6b 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClass.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClass.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClass is used by administrators to influence how resources are allocated.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,16 +81,10 @@
 public class ResourceClass implements Editable<ResourceClassBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1alpha2";
     @JsonProperty("driverName")
     private String driverName;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResourceClass";
     @JsonProperty("metadata")
@@ -119,7 +116,7 @@ public ResourceClass(String apiVersion, String driverName, String kind, ObjectMe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -127,25 +124,31 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * DriverName defines the name of the dynamic resource driver that is used for allocation of a ResourceClaim that uses this class.<br><p> <br><p> Resource drivers have a unique name in forward domain order (acme.example.com).
+     */
     @JsonProperty("driverName")
     public String getDriverName() {
         return driverName;
     }
 
+    /**
+     * DriverName defines the name of the dynamic resource driver that is used for allocation of a ResourceClaim that uses this class.<br><p> <br><p> Resource drivers have a unique name in forward domain order (acme.example.com).
+     */
     @JsonProperty("driverName")
     public void setDriverName(String driverName) {
         this.driverName = driverName;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -153,48 +156,72 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResourceClass is used by administrators to influence how resources are allocated.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceClass is used by administrators to influence how resources are allocated.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ResourceClass is used by administrators to influence how resources are allocated.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("parametersRef")
     public ResourceClassParametersReference getParametersRef() {
         return parametersRef;
     }
 
+    /**
+     * ResourceClass is used by administrators to influence how resources are allocated.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("parametersRef")
     public void setParametersRef(ResourceClassParametersReference parametersRef) {
         this.parametersRef = parametersRef;
     }
 
+    /**
+     * If and only if allocation of claims using this class is handled via structured parameters, then StructuredParameters must be set to true.
+     */
     @JsonProperty("structuredParameters")
     public Boolean getStructuredParameters() {
         return structuredParameters;
     }
 
+    /**
+     * If and only if allocation of claims using this class is handled via structured parameters, then StructuredParameters must be set to true.
+     */
     @JsonProperty("structuredParameters")
     public void setStructuredParameters(Boolean structuredParameters) {
         this.structuredParameters = structuredParameters;
     }
 
+    /**
+     * ResourceClass is used by administrators to influence how resources are allocated.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("suitableNodes")
     public NodeSelector getSuitableNodes() {
         return suitableNodes;
     }
 
+    /**
+     * ResourceClass is used by administrators to influence how resources are allocated.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("suitableNodes")
     public void setSuitableNodes(NodeSelector suitableNodes) {
         this.suitableNodes = suitableNodes;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClassList.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClassList.java
index e696b7dd8dc..ac976325309 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClassList.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClassList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClassList is a collection of classes.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ResourceClassList implements Editable<ResourceClassListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.resource.v1alpha2.ResourceClass>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1alpha2";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.resource.v1alpha2.ResourceClass> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResourceClassList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ResourceClassList(String apiVersion, List<io.fabric8.kubernetes.api.model
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of resource classes.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.resource.v1alpha2.ResourceClass> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of resource classes.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.resource.v1alpha2.ResourceClass> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResourceClassList is a collection of classes.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceClassList is a collection of classes.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClassParameters.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClassParameters.java
index 8b5c990af96..25e85df6c0d 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClassParameters.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClassParameters.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClassParameters defines resource requests for a ResourceClass in an in-tree format understood by Kubernetes.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,9 +82,6 @@
 public class ResourceClassParameters implements Editable<ResourceClassParametersBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1alpha2";
     @JsonProperty("filters")
@@ -89,9 +89,6 @@ public class ResourceClassParameters implements Editable<ResourceClassParameters
     private List<ResourceFilter> filters = new ArrayList<>();
     @JsonProperty("generatedFrom")
     private ResourceClassParametersReference generatedFrom;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResourceClassParameters";
     @JsonProperty("metadata")
@@ -119,7 +116,7 @@ public ResourceClassParameters(String apiVersion, List<ResourceFilter> filters,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -127,36 +124,48 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Filters describes additional contraints that must be met when using the class.
+     */
     @JsonProperty("filters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ResourceFilter> getFilters() {
         return filters;
     }
 
+    /**
+     * Filters describes additional contraints that must be met when using the class.
+     */
     @JsonProperty("filters")
     public void setFilters(List<ResourceFilter> filters) {
         this.filters = filters;
     }
 
+    /**
+     * ResourceClassParameters defines resource requests for a ResourceClass in an in-tree format understood by Kubernetes.
+     */
     @JsonProperty("generatedFrom")
     public ResourceClassParametersReference getGeneratedFrom() {
         return generatedFrom;
     }
 
+    /**
+     * ResourceClassParameters defines resource requests for a ResourceClass in an in-tree format understood by Kubernetes.
+     */
     @JsonProperty("generatedFrom")
     public void setGeneratedFrom(ResourceClassParametersReference generatedFrom) {
         this.generatedFrom = generatedFrom;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -164,29 +173,41 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResourceClassParameters defines resource requests for a ResourceClass in an in-tree format understood by Kubernetes.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceClassParameters defines resource requests for a ResourceClass in an in-tree format understood by Kubernetes.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * VendorParameters are arbitrary setup parameters for all claims using this class. They are ignored while allocating the claim. There must not be more than one entry per driver.
+     */
     @JsonProperty("vendorParameters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VendorParameters> getVendorParameters() {
         return vendorParameters;
     }
 
+    /**
+     * VendorParameters are arbitrary setup parameters for all claims using this class. They are ignored while allocating the claim. There must not be more than one entry per driver.
+     */
     @JsonProperty("vendorParameters")
     public void setVendorParameters(List<VendorParameters> vendorParameters) {
         this.vendorParameters = vendorParameters;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClassParametersList.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClassParametersList.java
index 8ce2d95953a..43f061e501a 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClassParametersList.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClassParametersList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClassParametersList is a collection of ResourceClassParameters.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ResourceClassParametersList implements Editable<ResourceClassParametersListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.resource.v1alpha2.ResourceClassParameters>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1alpha2";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.resource.v1alpha2.ResourceClassParameters> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResourceClassParametersList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ResourceClassParametersList(String apiVersion, List<io.fabric8.kubernetes
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of node resource capacity objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.resource.v1alpha2.ResourceClassParameters> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of node resource capacity objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.resource.v1alpha2.ResourceClassParameters> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResourceClassParametersList is a collection of ResourceClassParameters.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceClassParametersList is a collection of ResourceClassParameters.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClassParametersReference.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClassParametersReference.java
index d95bac138e8..8198b20a931 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClassParametersReference.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceClassParametersReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClassParametersReference contains enough information to let you locate the parameters for a ResourceClass.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ResourceClassParametersReference(String apiGroup, String kind, String nam
         this.namespace = namespace;
     }
 
+    /**
+     * APIGroup is the group for the resource being referenced. It is empty for the core API. This matches the group in the APIVersion that is used when creating the resources.
+     */
     @JsonProperty("apiGroup")
     public String getApiGroup() {
         return apiGroup;
     }
 
+    /**
+     * APIGroup is the group for the resource being referenced. It is empty for the core API. This matches the group in the APIVersion that is used when creating the resources.
+     */
     @JsonProperty("apiGroup")
     public void setApiGroup(String apiGroup) {
         this.apiGroup = apiGroup;
     }
 
+    /**
+     * Kind is the type of resource being referenced. This is the same value as in the parameter object's metadata.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is the type of resource being referenced. This is the same value as in the parameter object's metadata.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of resource being referenced.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of resource being referenced.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace that contains the referenced resource. Must be empty for cluster-scoped resources and non-empty for namespaced resources.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace that contains the referenced resource. Must be empty for cluster-scoped resources and non-empty for namespaced resources.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceFilter.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceFilter.java
index f2535708867..d338776312a 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceFilter.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceFilter.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceFilter is a filter for resources from one particular driver.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ResourceFilter(String driverName, NamedResourcesFilter namedResources) {
         this.namedResources = namedResources;
     }
 
+    /**
+     * DriverName is the name used by the DRA driver kubelet plugin.
+     */
     @JsonProperty("driverName")
     public String getDriverName() {
         return driverName;
     }
 
+    /**
+     * DriverName is the name used by the DRA driver kubelet plugin.
+     */
     @JsonProperty("driverName")
     public void setDriverName(String driverName) {
         this.driverName = driverName;
     }
 
+    /**
+     * ResourceFilter is a filter for resources from one particular driver.
+     */
     @JsonProperty("namedResources")
     public NamedResourcesFilter getNamedResources() {
         return namedResources;
     }
 
+    /**
+     * ResourceFilter is a filter for resources from one particular driver.
+     */
     @JsonProperty("namedResources")
     public void setNamedResources(NamedResourcesFilter namedResources) {
         this.namedResources = namedResources;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceHandle.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceHandle.java
index a25eec8008e..fdbb11dac55 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceHandle.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceHandle.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceHandle holds opaque resource data for processing by a specific kubelet plugin.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ResourceHandle(String data, String driverName, StructuredResourceHandle s
         this.structuredData = structuredData;
     }
 
+    /**
+     * Data contains the opaque data associated with this ResourceHandle. It is set by the controller component of the resource driver whose name matches the DriverName set in the ResourceClaimStatus this ResourceHandle is embedded in. It is set at allocation time and is intended for processing by the kubelet plugin whose name matches the DriverName set in this ResourceHandle.<br><p> <br><p> The maximum size of this field is 16KiB. This may get increased in the future, but not reduced.
+     */
     @JsonProperty("data")
     public String getData() {
         return data;
     }
 
+    /**
+     * Data contains the opaque data associated with this ResourceHandle. It is set by the controller component of the resource driver whose name matches the DriverName set in the ResourceClaimStatus this ResourceHandle is embedded in. It is set at allocation time and is intended for processing by the kubelet plugin whose name matches the DriverName set in this ResourceHandle.<br><p> <br><p> The maximum size of this field is 16KiB. This may get increased in the future, but not reduced.
+     */
     @JsonProperty("data")
     public void setData(String data) {
         this.data = data;
     }
 
+    /**
+     * DriverName specifies the name of the resource driver whose kubelet plugin should be invoked to process this ResourceHandle's data once it lands on a node. This may differ from the DriverName set in ResourceClaimStatus this ResourceHandle is embedded in.
+     */
     @JsonProperty("driverName")
     public String getDriverName() {
         return driverName;
     }
 
+    /**
+     * DriverName specifies the name of the resource driver whose kubelet plugin should be invoked to process this ResourceHandle's data once it lands on a node. This may differ from the DriverName set in ResourceClaimStatus this ResourceHandle is embedded in.
+     */
     @JsonProperty("driverName")
     public void setDriverName(String driverName) {
         this.driverName = driverName;
     }
 
+    /**
+     * ResourceHandle holds opaque resource data for processing by a specific kubelet plugin.
+     */
     @JsonProperty("structuredData")
     public StructuredResourceHandle getStructuredData() {
         return structuredData;
     }
 
+    /**
+     * ResourceHandle holds opaque resource data for processing by a specific kubelet plugin.
+     */
     @JsonProperty("structuredData")
     public void setStructuredData(StructuredResourceHandle structuredData) {
         this.structuredData = structuredData;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceRequest.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceRequest.java
index 07afa97d4a3..8883d93fd7a 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceRequest.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceRequest.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceRequest is a request for resources from one particular driver.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public ResourceRequest(NamedResourcesRequest namedResources, Object vendorParame
         this.vendorParameters = vendorParameters;
     }
 
+    /**
+     * ResourceRequest is a request for resources from one particular driver.
+     */
     @JsonProperty("namedResources")
     public NamedResourcesRequest getNamedResources() {
         return namedResources;
     }
 
+    /**
+     * ResourceRequest is a request for resources from one particular driver.
+     */
     @JsonProperty("namedResources")
     public void setNamedResources(NamedResourcesRequest namedResources) {
         this.namedResources = namedResources;
     }
 
+    /**
+     * ResourceRequest is a request for resources from one particular driver.
+     */
     @JsonProperty("vendorParameters")
     public Object getVendorParameters() {
         return vendorParameters;
     }
 
+    /**
+     * ResourceRequest is a request for resources from one particular driver.
+     */
     @JsonProperty("vendorParameters")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setVendorParameters(Object vendorParameters) {
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceSlice.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceSlice.java
index 5ba35c55815..9ae44a2451a 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceSlice.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceSlice.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceSlice provides information about available resources on individual nodes.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,16 +79,10 @@
 public class ResourceSlice implements Editable<ResourceSliceBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1alpha2";
     @JsonProperty("driverName")
     private String driverName;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResourceSlice";
     @JsonProperty("metadata")
@@ -114,7 +111,7 @@ public ResourceSlice(String apiVersion, String driverName, String kind, ObjectMe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -122,25 +119,31 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * DriverName identifies the DRA driver providing the capacity information. A field selector can be used to list only ResourceSlice objects with a certain driver name.
+     */
     @JsonProperty("driverName")
     public String getDriverName() {
         return driverName;
     }
 
+    /**
+     * DriverName identifies the DRA driver providing the capacity information. A field selector can be used to list only ResourceSlice objects with a certain driver name.
+     */
     @JsonProperty("driverName")
     public void setDriverName(String driverName) {
         this.driverName = driverName;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -148,38 +151,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResourceSlice provides information about available resources on individual nodes.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceSlice provides information about available resources on individual nodes.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ResourceSlice provides information about available resources on individual nodes.
+     */
     @JsonProperty("namedResources")
     public NamedResourcesResources getNamedResources() {
         return namedResources;
     }
 
+    /**
+     * ResourceSlice provides information about available resources on individual nodes.
+     */
     @JsonProperty("namedResources")
     public void setNamedResources(NamedResourcesResources namedResources) {
         this.namedResources = namedResources;
     }
 
+    /**
+     * NodeName identifies the node which provides the resources if they are local to a node.<br><p> <br><p> A field selector can be used to list only ResourceSlice objects with a certain node name.
+     */
     @JsonProperty("nodeName")
     public String getNodeName() {
         return nodeName;
     }
 
+    /**
+     * NodeName identifies the node which provides the resources if they are local to a node.<br><p> <br><p> A field selector can be used to list only ResourceSlice objects with a certain node name.
+     */
     @JsonProperty("nodeName")
     public void setNodeName(String nodeName) {
         this.nodeName = nodeName;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceSliceList.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceSliceList.java
index e8430cee16d..bc4bf0cb736 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceSliceList.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/ResourceSliceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceSliceList is a collection of ResourceSlices.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ResourceSliceList implements Editable<ResourceSliceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.resource.v1alpha2.ResourceSlice>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1alpha2";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.resource.v1alpha2.ResourceSlice> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResourceSliceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ResourceSliceList(String apiVersion, List<io.fabric8.kubernetes.api.model
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of node resource capacity objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.resource.v1alpha2.ResourceSlice> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of node resource capacity objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.resource.v1alpha2.ResourceSlice> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResourceSliceList is a collection of ResourceSlices.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceSliceList is a collection of ResourceSlices.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/StructuredResourceHandle.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/StructuredResourceHandle.java
index 7cccceb51c5..25cb0b28614 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/StructuredResourceHandle.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/StructuredResourceHandle.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StructuredResourceHandle is the in-tree representation of the allocation result.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,43 +98,67 @@ public StructuredResourceHandle(String nodeName, List<DriverAllocationResult> re
         this.vendorClassParameters = vendorClassParameters;
     }
 
+    /**
+     * NodeName is the name of the node providing the necessary resources if the resources are local to a node.
+     */
     @JsonProperty("nodeName")
     public String getNodeName() {
         return nodeName;
     }
 
+    /**
+     * NodeName is the name of the node providing the necessary resources if the resources are local to a node.
+     */
     @JsonProperty("nodeName")
     public void setNodeName(String nodeName) {
         this.nodeName = nodeName;
     }
 
+    /**
+     * Results lists all allocated driver resources.
+     */
     @JsonProperty("results")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DriverAllocationResult> getResults() {
         return results;
     }
 
+    /**
+     * Results lists all allocated driver resources.
+     */
     @JsonProperty("results")
     public void setResults(List<DriverAllocationResult> results) {
         this.results = results;
     }
 
+    /**
+     * StructuredResourceHandle is the in-tree representation of the allocation result.
+     */
     @JsonProperty("vendorClaimParameters")
     public Object getVendorClaimParameters() {
         return vendorClaimParameters;
     }
 
+    /**
+     * StructuredResourceHandle is the in-tree representation of the allocation result.
+     */
     @JsonProperty("vendorClaimParameters")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setVendorClaimParameters(Object vendorClaimParameters) {
         this.vendorClaimParameters = vendorClaimParameters;
     }
 
+    /**
+     * StructuredResourceHandle is the in-tree representation of the allocation result.
+     */
     @JsonProperty("vendorClassParameters")
     public Object getVendorClassParameters() {
         return vendorClassParameters;
     }
 
+    /**
+     * StructuredResourceHandle is the in-tree representation of the allocation result.
+     */
     @JsonProperty("vendorClassParameters")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setVendorClassParameters(Object vendorClassParameters) {
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/VendorParameters.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/VendorParameters.java
index 9ddd04db237..a18e8ccc1b3 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/VendorParameters.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha2/VendorParameters.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VendorParameters are opaque parameters for one particular driver.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public VendorParameters(String driverName, Object parameters) {
         this.parameters = parameters;
     }
 
+    /**
+     * DriverName is the name used by the DRA driver kubelet plugin.
+     */
     @JsonProperty("driverName")
     public String getDriverName() {
         return driverName;
     }
 
+    /**
+     * DriverName is the name used by the DRA driver kubelet plugin.
+     */
     @JsonProperty("driverName")
     public void setDriverName(String driverName) {
         this.driverName = driverName;
     }
 
+    /**
+     * VendorParameters are opaque parameters for one particular driver.
+     */
     @JsonProperty("parameters")
     public Object getParameters() {
         return parameters;
     }
 
+    /**
+     * VendorParameters are opaque parameters for one particular driver.
+     */
     @JsonProperty("parameters")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setParameters(Object parameters) {
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/AllocatedDeviceStatus.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/AllocatedDeviceStatus.java
index 7cc5797e170..e8c7f61bc53 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/AllocatedDeviceStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/AllocatedDeviceStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AllocatedDeviceStatus contains the status of an allocated device, if the driver chooses to report it. This may include driver-specific information.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -103,63 +106,99 @@ public AllocatedDeviceStatus(List<Condition> conditions, Object data, String dev
         this.pool = pool;
     }
 
+    /**
+     * Conditions contains the latest observation of the device's state. If the device has been configured according to the class and claim config references, the `Ready` condition should be True.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions contains the latest observation of the device's state. If the device has been configured according to the class and claim config references, the `Ready` condition should be True.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * AllocatedDeviceStatus contains the status of an allocated device, if the driver chooses to report it. This may include driver-specific information.
+     */
     @JsonProperty("data")
     public Object getData() {
         return data;
     }
 
+    /**
+     * AllocatedDeviceStatus contains the status of an allocated device, if the driver chooses to report it. This may include driver-specific information.
+     */
     @JsonProperty("data")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setData(Object data) {
         this.data = data;
     }
 
+    /**
+     * Device references one device instance via its name in the driver's resource pool. It must be a DNS label.
+     */
     @JsonProperty("device")
     public String getDevice() {
         return device;
     }
 
+    /**
+     * Device references one device instance via its name in the driver's resource pool. It must be a DNS label.
+     */
     @JsonProperty("device")
     public void setDevice(String device) {
         this.device = device;
     }
 
+    /**
+     * Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.<br><p> <br><p> Must be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.
+     */
     @JsonProperty("driver")
     public String getDriver() {
         return driver;
     }
 
+    /**
+     * Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.<br><p> <br><p> Must be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.
+     */
     @JsonProperty("driver")
     public void setDriver(String driver) {
         this.driver = driver;
     }
 
+    /**
+     * AllocatedDeviceStatus contains the status of an allocated device, if the driver chooses to report it. This may include driver-specific information.
+     */
     @JsonProperty("networkData")
     public NetworkDeviceData getNetworkData() {
         return networkData;
     }
 
+    /**
+     * AllocatedDeviceStatus contains the status of an allocated device, if the driver chooses to report it. This may include driver-specific information.
+     */
     @JsonProperty("networkData")
     public void setNetworkData(NetworkDeviceData networkData) {
         this.networkData = networkData;
     }
 
+    /**
+     * This name together with the driver name and the device name field identify which device was allocated (`&lt;driver name&gt;/&lt;pool name&gt;/&lt;device name&gt;`).<br><p> <br><p> Must not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.
+     */
     @JsonProperty("pool")
     public String getPool() {
         return pool;
     }
 
+    /**
+     * This name together with the driver name and the device name field identify which device was allocated (`&lt;driver name&gt;/&lt;pool name&gt;/&lt;device name&gt;`).<br><p> <br><p> Must not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.
+     */
     @JsonProperty("pool")
     public void setPool(String pool) {
         this.pool = pool;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/AllocationResult.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/AllocationResult.java
index 051ea8b42f1..d350bf2ee18 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/AllocationResult.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/AllocationResult.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AllocationResult contains attributes of an allocated resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public AllocationResult(DeviceAllocationResult devices, NodeSelector nodeSelecto
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * AllocationResult contains attributes of an allocated resource.
+     */
     @JsonProperty("devices")
     public DeviceAllocationResult getDevices() {
         return devices;
     }
 
+    /**
+     * AllocationResult contains attributes of an allocated resource.
+     */
     @JsonProperty("devices")
     public void setDevices(DeviceAllocationResult devices) {
         this.devices = devices;
     }
 
+    /**
+     * AllocationResult contains attributes of an allocated resource.
+     */
     @JsonProperty("nodeSelector")
     public NodeSelector getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * AllocationResult contains attributes of an allocated resource.
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(NodeSelector nodeSelector) {
         this.nodeSelector = nodeSelector;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/BasicDevice.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/BasicDevice.java
index ea1cd0eeacb..ff8ea1c1f69 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/BasicDevice.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/BasicDevice.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BasicDevice defines one device instance.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,23 +88,35 @@ public BasicDevice(Map<String, DeviceAttribute> attributes, Map<String, Quantity
         this.capacity = capacity;
     }
 
+    /**
+     * Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.<br><p> <br><p> The maximum number of attributes and capacities combined is 32.
+     */
     @JsonProperty("attributes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, DeviceAttribute> getAttributes() {
         return attributes;
     }
 
+    /**
+     * Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.<br><p> <br><p> The maximum number of attributes and capacities combined is 32.
+     */
     @JsonProperty("attributes")
     public void setAttributes(Map<String, DeviceAttribute> attributes) {
         this.attributes = attributes;
     }
 
+    /**
+     * Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.<br><p> <br><p> The maximum number of attributes and capacities combined is 32.
+     */
     @JsonProperty("capacity")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getCapacity() {
         return capacity;
     }
 
+    /**
+     * Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.<br><p> <br><p> The maximum number of attributes and capacities combined is 32.
+     */
     @JsonProperty("capacity")
     public void setCapacity(Map<String, Quantity> capacity) {
         this.capacity = capacity;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/CELDeviceSelector.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/CELDeviceSelector.java
index 425ed827bdd..6b73cb82e87 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/CELDeviceSelector.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/CELDeviceSelector.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CELDeviceSelector contains a CEL expression for selecting a device.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public CELDeviceSelector(String expression) {
         this.expression = expression;
     }
 
+    /**
+     * Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.<br><p> <br><p> The expression's input is an object named "device", which carries the following properties:<br><p>  - driver (string): the name of the driver which defines this device.<br><p>  - attributes (map[string]object): the device's attributes, grouped by prefix<br><p>    (e.g. device.attributes["dra.example.com"] evaluates to an object with all<br><p>    of the attributes which were prefixed by "dra.example.com".<br><p>  - capacity (map[string]object): the device's capacities, grouped by prefix.<br><p> <br><p> Example: Consider a device with driver="dra.example.com", which exposes two attributes named "model" and "ext.example.com/family" and which exposes one capacity named "modules". This input to this expression would have the following fields:<br><p> <br><p>     device.driver<br><p>     device.attributes["dra.example.com"].model<br><p>     device.attributes["ext.example.com"].family<br><p>     device.capacity["dra.example.com"].modules<br><p> <br><p> The device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.<br><p> <br><p> The value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.<br><p> <br><p> If an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.<br><p> <br><p> A robust expression should check for the existence of attributes before referencing them.<br><p> <br><p> For ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:<br><p> <br><p>     cel.bind(dra, device.attributes["dra.example.com"], dra.someBool &amp;&amp; dra.anotherBool)<br><p> <br><p> The length of the expression must be smaller or equal to 10 Ki. The cost of evaluating it is also limited based on the estimated number of logical steps.
+     */
     @JsonProperty("expression")
     public String getExpression() {
         return expression;
     }
 
+    /**
+     * Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.<br><p> <br><p> The expression's input is an object named "device", which carries the following properties:<br><p>  - driver (string): the name of the driver which defines this device.<br><p>  - attributes (map[string]object): the device's attributes, grouped by prefix<br><p>    (e.g. device.attributes["dra.example.com"] evaluates to an object with all<br><p>    of the attributes which were prefixed by "dra.example.com".<br><p>  - capacity (map[string]object): the device's capacities, grouped by prefix.<br><p> <br><p> Example: Consider a device with driver="dra.example.com", which exposes two attributes named "model" and "ext.example.com/family" and which exposes one capacity named "modules". This input to this expression would have the following fields:<br><p> <br><p>     device.driver<br><p>     device.attributes["dra.example.com"].model<br><p>     device.attributes["ext.example.com"].family<br><p>     device.capacity["dra.example.com"].modules<br><p> <br><p> The device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.<br><p> <br><p> The value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.<br><p> <br><p> If an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.<br><p> <br><p> A robust expression should check for the existence of attributes before referencing them.<br><p> <br><p> For ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:<br><p> <br><p>     cel.bind(dra, device.attributes["dra.example.com"], dra.someBool &amp;&amp; dra.anotherBool)<br><p> <br><p> The length of the expression must be smaller or equal to 10 Ki. The cost of evaluating it is also limited based on the estimated number of logical steps.
+     */
     @JsonProperty("expression")
     public void setExpression(String expression) {
         this.expression = expression;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/Device.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/Device.java
index eee0ba1c42c..e6e5a25b518 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/Device.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/Device.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Device(BasicDevice basic, String name) {
         this.name = name;
     }
 
+    /**
+     * Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.
+     */
     @JsonProperty("basic")
     public BasicDevice getBasic() {
         return basic;
     }
 
+    /**
+     * Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.
+     */
     @JsonProperty("basic")
     public void setBasic(BasicDevice basic) {
         this.basic = basic;
     }
 
+    /**
+     * Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceAllocationConfiguration.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceAllocationConfiguration.java
index 77d79a378e0..d57d5afefe8 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceAllocationConfiguration.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceAllocationConfiguration.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeviceAllocationConfiguration gets embedded in an AllocationResult.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public DeviceAllocationConfiguration(OpaqueDeviceConfiguration opaque, List<Stri
         this.source = source;
     }
 
+    /**
+     * DeviceAllocationConfiguration gets embedded in an AllocationResult.
+     */
     @JsonProperty("opaque")
     public OpaqueDeviceConfiguration getOpaque() {
         return opaque;
     }
 
+    /**
+     * DeviceAllocationConfiguration gets embedded in an AllocationResult.
+     */
     @JsonProperty("opaque")
     public void setOpaque(OpaqueDeviceConfiguration opaque) {
         this.opaque = opaque;
     }
 
+    /**
+     * Requests lists the names of requests where the configuration applies. If empty, its applies to all requests.
+     */
     @JsonProperty("requests")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getRequests() {
         return requests;
     }
 
+    /**
+     * Requests lists the names of requests where the configuration applies. If empty, its applies to all requests.
+     */
     @JsonProperty("requests")
     public void setRequests(List<String> requests) {
         this.requests = requests;
     }
 
+    /**
+     * Source records whether the configuration comes from a class and thus is not something that a normal user would have been able to set or from a claim.
+     */
     @JsonProperty("source")
     public String getSource() {
         return source;
     }
 
+    /**
+     * Source records whether the configuration comes from a class and thus is not something that a normal user would have been able to set or from a claim.
+     */
     @JsonProperty("source")
     public void setSource(String source) {
         this.source = source;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceAllocationResult.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceAllocationResult.java
index 8691ffcd865..98659f9c5d0 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceAllocationResult.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceAllocationResult.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeviceAllocationResult is the result of allocating devices.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public DeviceAllocationResult(List<DeviceAllocationConfiguration> config, List<D
         this.results = results;
     }
 
+    /**
+     * This field is a combination of all the claim and class configuration parameters. Drivers can distinguish between those based on a flag.<br><p> <br><p> This includes configuration parameters for drivers which have no allocated devices in the result because it is up to the drivers which configuration parameters they support. They can silently ignore unknown configuration parameters.
+     */
     @JsonProperty("config")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DeviceAllocationConfiguration> getConfig() {
         return config;
     }
 
+    /**
+     * This field is a combination of all the claim and class configuration parameters. Drivers can distinguish between those based on a flag.<br><p> <br><p> This includes configuration parameters for drivers which have no allocated devices in the result because it is up to the drivers which configuration parameters they support. They can silently ignore unknown configuration parameters.
+     */
     @JsonProperty("config")
     public void setConfig(List<DeviceAllocationConfiguration> config) {
         this.config = config;
     }
 
+    /**
+     * Results lists all allocated devices.
+     */
     @JsonProperty("results")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DeviceRequestAllocationResult> getResults() {
         return results;
     }
 
+    /**
+     * Results lists all allocated devices.
+     */
     @JsonProperty("results")
     public void setResults(List<DeviceRequestAllocationResult> results) {
         this.results = results;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceAttribute.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceAttribute.java
index e1ce0ef25a6..e53fabb6d67 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceAttribute.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceAttribute.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeviceAttribute must have exactly one field set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public DeviceAttribute(Boolean bool, Long _int, String string, String version) {
         this.version = version;
     }
 
+    /**
+     * BoolValue is a true/false value.
+     */
     @JsonProperty("bool")
     public Boolean getBool() {
         return bool;
     }
 
+    /**
+     * BoolValue is a true/false value.
+     */
     @JsonProperty("bool")
     public void setBool(Boolean bool) {
         this.bool = bool;
     }
 
+    /**
+     * IntValue is a number.
+     */
     @JsonProperty("int")
     public Long getInt() {
         return _int;
     }
 
+    /**
+     * IntValue is a number.
+     */
     @JsonProperty("int")
     public void setInt(Long _int) {
         this._int = _int;
     }
 
+    /**
+     * StringValue is a string. Must not be longer than 64 characters.
+     */
     @JsonProperty("string")
     public String getString() {
         return string;
     }
 
+    /**
+     * StringValue is a string. Must not be longer than 64 characters.
+     */
     @JsonProperty("string")
     public void setString(String string) {
         this.string = string;
     }
 
+    /**
+     * VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceClaim.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceClaim.java
index 1db07349484..fb41103ca27 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceClaim.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceClaim.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeviceClaim defines how to request devices with a ResourceClaim.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,34 +94,52 @@ public DeviceClaim(List<DeviceClaimConfiguration> config, List<DeviceConstraint>
         this.requests = requests;
     }
 
+    /**
+     * This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.
+     */
     @JsonProperty("config")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DeviceClaimConfiguration> getConfig() {
         return config;
     }
 
+    /**
+     * This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.
+     */
     @JsonProperty("config")
     public void setConfig(List<DeviceClaimConfiguration> config) {
         this.config = config;
     }
 
+    /**
+     * These constraints must be satisfied by the set of devices that get allocated for the claim.
+     */
     @JsonProperty("constraints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DeviceConstraint> getConstraints() {
         return constraints;
     }
 
+    /**
+     * These constraints must be satisfied by the set of devices that get allocated for the claim.
+     */
     @JsonProperty("constraints")
     public void setConstraints(List<DeviceConstraint> constraints) {
         this.constraints = constraints;
     }
 
+    /**
+     * Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.
+     */
     @JsonProperty("requests")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DeviceRequest> getRequests() {
         return requests;
     }
 
+    /**
+     * Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.
+     */
     @JsonProperty("requests")
     public void setRequests(List<DeviceRequest> requests) {
         this.requests = requests;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceClaimConfiguration.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceClaimConfiguration.java
index 507e88e9ea9..90b658d55ff 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceClaimConfiguration.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceClaimConfiguration.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public DeviceClaimConfiguration(OpaqueDeviceConfiguration opaque, List<String> r
         this.requests = requests;
     }
 
+    /**
+     * DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.
+     */
     @JsonProperty("opaque")
     public OpaqueDeviceConfiguration getOpaque() {
         return opaque;
     }
 
+    /**
+     * DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.
+     */
     @JsonProperty("opaque")
     public void setOpaque(OpaqueDeviceConfiguration opaque) {
         this.opaque = opaque;
     }
 
+    /**
+     * Requests lists the names of requests where the configuration applies. If empty, it applies to all requests.
+     */
     @JsonProperty("requests")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getRequests() {
         return requests;
     }
 
+    /**
+     * Requests lists the names of requests where the configuration applies. If empty, it applies to all requests.
+     */
     @JsonProperty("requests")
     public void setRequests(List<String> requests) {
         this.requests = requests;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceClass.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceClass.java
index 6b1aecc2d1d..cde4c207238 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceClass.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceClass.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeviceClass is a vendor- or admin-provided resource that contains device configuration and selectors. It can be referenced in the device requests of a claim to apply these presets. Cluster scoped.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class DeviceClass implements Editable<DeviceClassBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1alpha3";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DeviceClass";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public DeviceClass(String apiVersion, String kind, ObjectMeta metadata, DeviceCl
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DeviceClass is a vendor- or admin-provided resource that contains device configuration and selectors. It can be referenced in the device requests of a claim to apply these presets. Cluster scoped.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DeviceClass is a vendor- or admin-provided resource that contains device configuration and selectors. It can be referenced in the device requests of a claim to apply these presets. Cluster scoped.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * DeviceClass is a vendor- or admin-provided resource that contains device configuration and selectors. It can be referenced in the device requests of a claim to apply these presets. Cluster scoped.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("spec")
     public DeviceClassSpec getSpec() {
         return spec;
     }
 
+    /**
+     * DeviceClass is a vendor- or admin-provided resource that contains device configuration and selectors. It can be referenced in the device requests of a claim to apply these presets. Cluster scoped.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("spec")
     public void setSpec(DeviceClassSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceClassConfiguration.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceClassConfiguration.java
index 004cd72d15c..ad91f1d599f 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceClassConfiguration.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceClassConfiguration.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeviceClassConfiguration is used in DeviceClass.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public DeviceClassConfiguration(OpaqueDeviceConfiguration opaque) {
         this.opaque = opaque;
     }
 
+    /**
+     * DeviceClassConfiguration is used in DeviceClass.
+     */
     @JsonProperty("opaque")
     public OpaqueDeviceConfiguration getOpaque() {
         return opaque;
     }
 
+    /**
+     * DeviceClassConfiguration is used in DeviceClass.
+     */
     @JsonProperty("opaque")
     public void setOpaque(OpaqueDeviceConfiguration opaque) {
         this.opaque = opaque;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceClassList.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceClassList.java
index a1d8b030248..755b9e43f0a 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceClassList.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceClassList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeviceClassList is a collection of classes.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class DeviceClassList implements Editable<DeviceClassListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.resource.v1alpha3.DeviceClass>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1alpha3";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.resource.v1alpha3.DeviceClass> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DeviceClassList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DeviceClassList(String apiVersion, List<io.fabric8.kubernetes.api.model.r
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of resource classes.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.resource.v1alpha3.DeviceClass> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of resource classes.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.resource.v1alpha3.DeviceClass> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DeviceClassList is a collection of classes.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DeviceClassList is a collection of classes.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceClassSpec.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceClassSpec.java
index 4b672f2ee34..7c84fb9ffb1 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceClassSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceClassSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeviceClassSpec is used in a [DeviceClass] to define what can be allocated and how to configure it.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public DeviceClassSpec(List<DeviceClassConfiguration> config, List<DeviceSelecto
         this.selectors = selectors;
     }
 
+    /**
+     * Config defines configuration parameters that apply to each device that is claimed via this class. Some classses may potentially be satisfied by multiple drivers, so each instance of a vendor configuration applies to exactly one driver.<br><p> <br><p> They are passed to the driver, but are not considered while allocating the claim.
+     */
     @JsonProperty("config")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DeviceClassConfiguration> getConfig() {
         return config;
     }
 
+    /**
+     * Config defines configuration parameters that apply to each device that is claimed via this class. Some classses may potentially be satisfied by multiple drivers, so each instance of a vendor configuration applies to exactly one driver.<br><p> <br><p> They are passed to the driver, but are not considered while allocating the claim.
+     */
     @JsonProperty("config")
     public void setConfig(List<DeviceClassConfiguration> config) {
         this.config = config;
     }
 
+    /**
+     * Each selector must be satisfied by a device which is claimed via this class.
+     */
     @JsonProperty("selectors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DeviceSelector> getSelectors() {
         return selectors;
     }
 
+    /**
+     * Each selector must be satisfied by a device which is claimed via this class.
+     */
     @JsonProperty("selectors")
     public void setSelectors(List<DeviceSelector> selectors) {
         this.selectors = selectors;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceConstraint.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceConstraint.java
index 68bb6dc4a95..2d9633b7d57 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceConstraint.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceConstraint.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeviceConstraint must have exactly one field set besides Requests.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public DeviceConstraint(String matchAttribute, List<String> requests) {
         this.requests = requests;
     }
 
+    /**
+     * MatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices.<br><p> <br><p> For example, if you specified "dra.example.com/numa" (a hypothetical example!), then only devices in the same NUMA node will be chosen. A device which does not have that attribute will not be chosen. All devices should use a value of the same type for this attribute because that is part of its specification, but if one device doesn't, then it also will not be chosen.<br><p> <br><p> Must include the domain qualifier.
+     */
     @JsonProperty("matchAttribute")
     public String getMatchAttribute() {
         return matchAttribute;
     }
 
+    /**
+     * MatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices.<br><p> <br><p> For example, if you specified "dra.example.com/numa" (a hypothetical example!), then only devices in the same NUMA node will be chosen. A device which does not have that attribute will not be chosen. All devices should use a value of the same type for this attribute because that is part of its specification, but if one device doesn't, then it also will not be chosen.<br><p> <br><p> Must include the domain qualifier.
+     */
     @JsonProperty("matchAttribute")
     public void setMatchAttribute(String matchAttribute) {
         this.matchAttribute = matchAttribute;
     }
 
+    /**
+     * Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint. If this is not specified, this constraint applies to all requests in this claim.
+     */
     @JsonProperty("requests")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getRequests() {
         return requests;
     }
 
+    /**
+     * Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint. If this is not specified, this constraint applies to all requests in this claim.
+     */
     @JsonProperty("requests")
     public void setRequests(List<String> requests) {
         this.requests = requests;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceRequest.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceRequest.java
index 34cae8fef8e..a6db77e5f19 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceRequest.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceRequest.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeviceRequest is a request for devices required for a claim. This is typically a request for a single resource like a device, but can also ask for several identical devices.<br><p> <br><p> A DeviceClassName is currently required. Clients must check that it is indeed set. It's absence indicates that something changed in a way that is not supported by the client yet, in which case it must refuse to handle the request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,62 +104,98 @@ public DeviceRequest(Boolean adminAccess, String allocationMode, Long count, Str
         this.selectors = selectors;
     }
 
+    /**
+     * AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device.  They ignore all ordinary claims to the device with respect to access modes and any resource allocations.<br><p> <br><p> This is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.
+     */
     @JsonProperty("adminAccess")
     public Boolean getAdminAccess() {
         return adminAccess;
     }
 
+    /**
+     * AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device.  They ignore all ordinary claims to the device with respect to access modes and any resource allocations.<br><p> <br><p> This is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.
+     */
     @JsonProperty("adminAccess")
     public void setAdminAccess(Boolean adminAccess) {
         this.adminAccess = adminAccess;
     }
 
+    /**
+     * AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:<br><p> <br><p> - ExactCount: This request is for a specific number of devices.<br><p>   This is the default. The exact number is provided in the<br><p>   count field.<br><p> <br><p> - All: This request is for all of the matching devices in a pool.<br><p>   Allocation will fail if some devices are already allocated,<br><p>   unless adminAccess is requested.<br><p> <br><p> If AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.<br><p> <br><p> More modes may get added in the future. Clients must refuse to handle requests with unknown modes.
+     */
     @JsonProperty("allocationMode")
     public String getAllocationMode() {
         return allocationMode;
     }
 
+    /**
+     * AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:<br><p> <br><p> - ExactCount: This request is for a specific number of devices.<br><p>   This is the default. The exact number is provided in the<br><p>   count field.<br><p> <br><p> - All: This request is for all of the matching devices in a pool.<br><p>   Allocation will fail if some devices are already allocated,<br><p>   unless adminAccess is requested.<br><p> <br><p> If AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.<br><p> <br><p> More modes may get added in the future. Clients must refuse to handle requests with unknown modes.
+     */
     @JsonProperty("allocationMode")
     public void setAllocationMode(String allocationMode) {
         this.allocationMode = allocationMode;
     }
 
+    /**
+     * Count is used only when the count mode is "ExactCount". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.
+     */
     @JsonProperty("count")
     public Long getCount() {
         return count;
     }
 
+    /**
+     * Count is used only when the count mode is "ExactCount". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.
+     */
     @JsonProperty("count")
     public void setCount(Long count) {
         this.count = count;
     }
 
+    /**
+     * DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.<br><p> <br><p> A class is required. Which classes are available depends on the cluster.<br><p> <br><p> Administrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.
+     */
     @JsonProperty("deviceClassName")
     public String getDeviceClassName() {
         return deviceClassName;
     }
 
+    /**
+     * DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.<br><p> <br><p> A class is required. Which classes are available depends on the cluster.<br><p> <br><p> Administrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.
+     */
     @JsonProperty("deviceClassName")
     public void setDeviceClassName(String deviceClassName) {
         this.deviceClassName = deviceClassName;
     }
 
+    /**
+     * Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.<br><p> <br><p> Must be a DNS label.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.<br><p> <br><p> Must be a DNS label.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.
+     */
     @JsonProperty("selectors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DeviceSelector> getSelectors() {
         return selectors;
     }
 
+    /**
+     * Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.
+     */
     @JsonProperty("selectors")
     public void setSelectors(List<DeviceSelector> selectors) {
         this.selectors = selectors;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceRequestAllocationResult.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceRequestAllocationResult.java
index 63b679954cc..615d07c0886 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceRequestAllocationResult.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceRequestAllocationResult.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeviceRequestAllocationResult contains the allocation result for one request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public DeviceRequestAllocationResult(Boolean adminAccess, String device, String
         this.request = request;
     }
 
+    /**
+     * AdminAccess indicates that this device was allocated for administrative access. See the corresponding request field for a definition of mode.<br><p> <br><p> This is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.
+     */
     @JsonProperty("adminAccess")
     public Boolean getAdminAccess() {
         return adminAccess;
     }
 
+    /**
+     * AdminAccess indicates that this device was allocated for administrative access. See the corresponding request field for a definition of mode.<br><p> <br><p> This is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.
+     */
     @JsonProperty("adminAccess")
     public void setAdminAccess(Boolean adminAccess) {
         this.adminAccess = adminAccess;
     }
 
+    /**
+     * Device references one device instance via its name in the driver's resource pool. It must be a DNS label.
+     */
     @JsonProperty("device")
     public String getDevice() {
         return device;
     }
 
+    /**
+     * Device references one device instance via its name in the driver's resource pool. It must be a DNS label.
+     */
     @JsonProperty("device")
     public void setDevice(String device) {
         this.device = device;
     }
 
+    /**
+     * Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.<br><p> <br><p> Must be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.
+     */
     @JsonProperty("driver")
     public String getDriver() {
         return driver;
     }
 
+    /**
+     * Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.<br><p> <br><p> Must be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.
+     */
     @JsonProperty("driver")
     public void setDriver(String driver) {
         this.driver = driver;
     }
 
+    /**
+     * This name together with the driver name and the device name field identify which device was allocated (`&lt;driver name&gt;/&lt;pool name&gt;/&lt;device name&gt;`).<br><p> <br><p> Must not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.
+     */
     @JsonProperty("pool")
     public String getPool() {
         return pool;
     }
 
+    /**
+     * This name together with the driver name and the device name field identify which device was allocated (`&lt;driver name&gt;/&lt;pool name&gt;/&lt;device name&gt;`).<br><p> <br><p> Must not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.
+     */
     @JsonProperty("pool")
     public void setPool(String pool) {
         this.pool = pool;
     }
 
+    /**
+     * Request is the name of the request in the claim which caused this device to be allocated. Multiple devices may have been allocated per request.
+     */
     @JsonProperty("request")
     public String getRequest() {
         return request;
     }
 
+    /**
+     * Request is the name of the request in the claim which caused this device to be allocated. Multiple devices may have been allocated per request.
+     */
     @JsonProperty("request")
     public void setRequest(String request) {
         this.request = request;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceSelector.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceSelector.java
index 1b97835fad1..741501511e0 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceSelector.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/DeviceSelector.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeviceSelector must have exactly one field set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public DeviceSelector(CELDeviceSelector cel) {
         this.cel = cel;
     }
 
+    /**
+     * DeviceSelector must have exactly one field set.
+     */
     @JsonProperty("cel")
     public CELDeviceSelector getCel() {
         return cel;
     }
 
+    /**
+     * DeviceSelector must have exactly one field set.
+     */
     @JsonProperty("cel")
     public void setCel(CELDeviceSelector cel) {
         this.cel = cel;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/NetworkDeviceData.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/NetworkDeviceData.java
index d77ee655a82..a866938877a 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/NetworkDeviceData.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/NetworkDeviceData.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkDeviceData provides network-related details for the allocated device. This information may be filled by drivers or other components to configure or identify the device within a network context.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public NetworkDeviceData(String hardwareAddress, String interfaceName, List<Stri
         this.ips = ips;
     }
 
+    /**
+     * HardwareAddress represents the hardware address (e.g. MAC Address) of the device's network interface.<br><p> <br><p> Must not be longer than 128 characters.
+     */
     @JsonProperty("hardwareAddress")
     public String getHardwareAddress() {
         return hardwareAddress;
     }
 
+    /**
+     * HardwareAddress represents the hardware address (e.g. MAC Address) of the device's network interface.<br><p> <br><p> Must not be longer than 128 characters.
+     */
     @JsonProperty("hardwareAddress")
     public void setHardwareAddress(String hardwareAddress) {
         this.hardwareAddress = hardwareAddress;
     }
 
+    /**
+     * InterfaceName specifies the name of the network interface associated with the allocated device. This might be the name of a physical or virtual network interface being configured in the pod.<br><p> <br><p> Must not be longer than 256 characters.
+     */
     @JsonProperty("interfaceName")
     public String getInterfaceName() {
         return interfaceName;
     }
 
+    /**
+     * InterfaceName specifies the name of the network interface associated with the allocated device. This might be the name of a physical or virtual network interface being configured in the pod.<br><p> <br><p> Must not be longer than 256 characters.
+     */
     @JsonProperty("interfaceName")
     public void setInterfaceName(String interfaceName) {
         this.interfaceName = interfaceName;
     }
 
+    /**
+     * IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: "192.0.2.5/24" for IPv4 and "2001:db8::5/64" for IPv6.
+     */
     @JsonProperty("ips")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIps() {
         return ips;
     }
 
+    /**
+     * IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: "192.0.2.5/24" for IPv4 and "2001:db8::5/64" for IPv6.
+     */
     @JsonProperty("ips")
     public void setIps(List<String> ips) {
         this.ips = ips;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/OpaqueDeviceConfiguration.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/OpaqueDeviceConfiguration.java
index 1099bd8e830..9542155c2ac 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/OpaqueDeviceConfiguration.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/OpaqueDeviceConfiguration.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public OpaqueDeviceConfiguration(String driver, Object parameters) {
         this.parameters = parameters;
     }
 
+    /**
+     * Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.<br><p> <br><p> An admission policy provided by the driver developer could use this to decide whether it needs to validate them.<br><p> <br><p> Must be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.
+     */
     @JsonProperty("driver")
     public String getDriver() {
         return driver;
     }
 
+    /**
+     * Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.<br><p> <br><p> An admission policy provided by the driver developer could use this to decide whether it needs to validate them.<br><p> <br><p> Must be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.
+     */
     @JsonProperty("driver")
     public void setDriver(String driver) {
         this.driver = driver;
     }
 
+    /**
+     * OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.
+     */
     @JsonProperty("parameters")
     public Object getParameters() {
         return parameters;
     }
 
+    /**
+     * OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.
+     */
     @JsonProperty("parameters")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setParameters(Object parameters) {
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaim.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaim.java
index 6392b668d87..4a5e62aa7f8 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaim.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaim.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class ResourceClaim implements Editable<ResourceClaimBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1alpha3";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResourceClaim";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ResourceClaim(String apiVersion, String kind, ObjectMeta metadata, Resour
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("spec")
     public ResourceClaimSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("spec")
     public void setSpec(ResourceClaimSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("status")
     public ResourceClaimStatus getStatus() {
         return status;
     }
 
+    /**
+     * ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("status")
     public void setStatus(ResourceClaimStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaimConsumerReference.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaimConsumerReference.java
index 2b3069ad46a..c7972273409 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaimConsumerReference.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaimConsumerReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaimConsumerReference contains enough information to let you locate the consumer of a ResourceClaim. The user must be a resource in the same namespace as the ResourceClaim.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ResourceClaimConsumerReference(String apiGroup, String name, String resou
         this.uid = uid;
     }
 
+    /**
+     * APIGroup is the group for the resource being referenced. It is empty for the core API. This matches the group in the APIVersion that is used when creating the resources.
+     */
     @JsonProperty("apiGroup")
     public String getApiGroup() {
         return apiGroup;
     }
 
+    /**
+     * APIGroup is the group for the resource being referenced. It is empty for the core API. This matches the group in the APIVersion that is used when creating the resources.
+     */
     @JsonProperty("apiGroup")
     public void setApiGroup(String apiGroup) {
         this.apiGroup = apiGroup;
     }
 
+    /**
+     * Name is the name of resource being referenced.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of resource being referenced.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Resource is the type of resource being referenced, for example "pods".
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * Resource is the type of resource being referenced, for example "pods".
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
     }
 
+    /**
+     * UID identifies exactly one incarnation of the resource.
+     */
     @JsonProperty("uid")
     public String getUid() {
         return uid;
     }
 
+    /**
+     * UID identifies exactly one incarnation of the resource.
+     */
     @JsonProperty("uid")
     public void setUid(String uid) {
         this.uid = uid;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaimList.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaimList.java
index d982dae4184..39114c50507 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaimList.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaimList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaimList is a collection of claims.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ResourceClaimList implements Editable<ResourceClaimListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.resource.v1alpha3.ResourceClaim>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1alpha3";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.resource.v1alpha3.ResourceClaim> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResourceClaimList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ResourceClaimList(String apiVersion, List<io.fabric8.kubernetes.api.model
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of resource claims.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.resource.v1alpha3.ResourceClaim> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of resource claims.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.resource.v1alpha3.ResourceClaim> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResourceClaimList is a collection of claims.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceClaimList is a collection of claims.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaimSpec.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaimSpec.java
index 4ed0776adf8..ad293205ffc 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaimSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaimSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ResourceClaimSpec(DeviceClaim devices) {
         this.devices = devices;
     }
 
+    /**
+     * ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.
+     */
     @JsonProperty("devices")
     public DeviceClaim getDevices() {
         return devices;
     }
 
+    /**
+     * ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.
+     */
     @JsonProperty("devices")
     public void setDevices(DeviceClaim devices) {
         this.devices = devices;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaimStatus.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaimStatus.java
index f7625e2b6d3..fb06f2e27e3 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaimStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaimStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaimStatus tracks whether the resource has been allocated and what the result of that was.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public ResourceClaimStatus(AllocationResult allocation, List<AllocatedDeviceStat
         this.reservedFor = reservedFor;
     }
 
+    /**
+     * ResourceClaimStatus tracks whether the resource has been allocated and what the result of that was.
+     */
     @JsonProperty("allocation")
     public AllocationResult getAllocation() {
         return allocation;
     }
 
+    /**
+     * ResourceClaimStatus tracks whether the resource has been allocated and what the result of that was.
+     */
     @JsonProperty("allocation")
     public void setAllocation(AllocationResult allocation) {
         this.allocation = allocation;
     }
 
+    /**
+     * Devices contains the status of each device allocated for this claim, as reported by the driver. This can include driver-specific information. Entries are owned by their respective drivers.
+     */
     @JsonProperty("devices")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AllocatedDeviceStatus> getDevices() {
         return devices;
     }
 
+    /**
+     * Devices contains the status of each device allocated for this claim, as reported by the driver. This can include driver-specific information. Entries are owned by their respective drivers.
+     */
     @JsonProperty("devices")
     public void setDevices(List<AllocatedDeviceStatus> devices) {
         this.devices = devices;
     }
 
+    /**
+     * ReservedFor indicates which entities are currently allowed to use the claim. A Pod which references a ResourceClaim which is not reserved for that Pod will not be started. A claim that is in use or might be in use because it has been reserved must not get deallocated.<br><p> <br><p> In a cluster with multiple scheduler instances, two pods might get scheduled concurrently by different schedulers. When they reference the same ResourceClaim which already has reached its maximum number of consumers, only one pod can be scheduled.<br><p> <br><p> Both schedulers try to add their pod to the claim.status.reservedFor field, but only the update that reaches the API server first gets stored. The other one fails with an error and the scheduler which issued it knows that it must put the pod back into the queue, waiting for the ResourceClaim to become usable again.<br><p> <br><p> There can be at most 256 such reservations. This may get increased in the future, but not reduced.
+     */
     @JsonProperty("reservedFor")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ResourceClaimConsumerReference> getReservedFor() {
         return reservedFor;
     }
 
+    /**
+     * ReservedFor indicates which entities are currently allowed to use the claim. A Pod which references a ResourceClaim which is not reserved for that Pod will not be started. A claim that is in use or might be in use because it has been reserved must not get deallocated.<br><p> <br><p> In a cluster with multiple scheduler instances, two pods might get scheduled concurrently by different schedulers. When they reference the same ResourceClaim which already has reached its maximum number of consumers, only one pod can be scheduled.<br><p> <br><p> Both schedulers try to add their pod to the claim.status.reservedFor field, but only the update that reaches the API server first gets stored. The other one fails with an error and the scheduler which issued it knows that it must put the pod back into the queue, waiting for the ResourceClaim to become usable again.<br><p> <br><p> There can be at most 256 such reservations. This may get increased in the future, but not reduced.
+     */
     @JsonProperty("reservedFor")
     public void setReservedFor(List<ResourceClaimConsumerReference> reservedFor) {
         this.reservedFor = reservedFor;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaimTemplate.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaimTemplate.java
index 46b0bf6c347..bf66e8842d1 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaimTemplate.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaimTemplate.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaimTemplate is used to produce ResourceClaim objects.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ResourceClaimTemplate implements Editable<ResourceClaimTemplateBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1alpha3";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResourceClaimTemplate";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public ResourceClaimTemplate(String apiVersion, String kind, ObjectMeta metadata
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResourceClaimTemplate is used to produce ResourceClaim objects.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceClaimTemplate is used to produce ResourceClaim objects.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ResourceClaimTemplate is used to produce ResourceClaim objects.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("spec")
     public ResourceClaimTemplateSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ResourceClaimTemplate is used to produce ResourceClaim objects.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("spec")
     public void setSpec(ResourceClaimTemplateSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaimTemplateList.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaimTemplateList.java
index 25ef6a876c8..93c108133fe 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaimTemplateList.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaimTemplateList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaimTemplateList is a collection of claim templates.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ResourceClaimTemplateList implements Editable<ResourceClaimTemplateListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.resource.v1alpha3.ResourceClaimTemplate>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1alpha3";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.resource.v1alpha3.ResourceClaimTemplate> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResourceClaimTemplateList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ResourceClaimTemplateList(String apiVersion, List<io.fabric8.kubernetes.a
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of resource claim templates.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.resource.v1alpha3.ResourceClaimTemplate> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of resource claim templates.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.resource.v1alpha3.ResourceClaimTemplate> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResourceClaimTemplateList is a collection of claim templates.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceClaimTemplateList is a collection of claim templates.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaimTemplateSpec.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaimTemplateSpec.java
index 0db468ba5f4..b9914ea3bc1 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaimTemplateSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceClaimTemplateSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ResourceClaimTemplateSpec(ObjectMeta metadata, ResourceClaimSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.
+     */
     @JsonProperty("spec")
     public ResourceClaimSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.
+     */
     @JsonProperty("spec")
     public void setSpec(ResourceClaimSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourcePool.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourcePool.java
index fe547fe997b..dad010693c6 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourcePool.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourcePool.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourcePool describes the pool that ResourceSlices belong to.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ResourcePool(Long generation, String name, Long resourceSliceCount) {
         this.resourceSliceCount = resourceSliceCount;
     }
 
+    /**
+     * Generation tracks the change in a pool over time. Whenever a driver changes something about one or more of the resources in a pool, it must change the generation in all ResourceSlices which are part of that pool. Consumers of ResourceSlices should only consider resources from the pool with the highest generation number. The generation may be reset by drivers, which should be fine for consumers, assuming that all ResourceSlices in a pool are updated to match or deleted.<br><p> <br><p> Combined with ResourceSliceCount, this mechanism enables consumers to detect pools which are comprised of multiple ResourceSlices and are in an incomplete state.
+     */
     @JsonProperty("generation")
     public Long getGeneration() {
         return generation;
     }
 
+    /**
+     * Generation tracks the change in a pool over time. Whenever a driver changes something about one or more of the resources in a pool, it must change the generation in all ResourceSlices which are part of that pool. Consumers of ResourceSlices should only consider resources from the pool with the highest generation number. The generation may be reset by drivers, which should be fine for consumers, assuming that all ResourceSlices in a pool are updated to match or deleted.<br><p> <br><p> Combined with ResourceSliceCount, this mechanism enables consumers to detect pools which are comprised of multiple ResourceSlices and are in an incomplete state.
+     */
     @JsonProperty("generation")
     public void setGeneration(Long generation) {
         this.generation = generation;
     }
 
+    /**
+     * Name is used to identify the pool. For node-local devices, this is often the node name, but this is not required.<br><p> <br><p> It must not be longer than 253 characters and must consist of one or more DNS sub-domains separated by slashes. This field is immutable.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is used to identify the pool. For node-local devices, this is often the node name, but this is not required.<br><p> <br><p> It must not be longer than 253 characters and must consist of one or more DNS sub-domains separated by slashes. This field is immutable.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * ResourceSliceCount is the total number of ResourceSlices in the pool at this generation number. Must be greater than zero.<br><p> <br><p> Consumers can use this to check whether they have seen all ResourceSlices belonging to the same pool.
+     */
     @JsonProperty("resourceSliceCount")
     public Long getResourceSliceCount() {
         return resourceSliceCount;
     }
 
+    /**
+     * ResourceSliceCount is the total number of ResourceSlices in the pool at this generation number. Must be greater than zero.<br><p> <br><p> Consumers can use this to check whether they have seen all ResourceSlices belonging to the same pool.
+     */
     @JsonProperty("resourceSliceCount")
     public void setResourceSliceCount(Long resourceSliceCount) {
         this.resourceSliceCount = resourceSliceCount;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceSlice.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceSlice.java
index d28332d2e26..dca1847f615 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceSlice.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceSlice.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceSlice represents one or more resources in a pool of similar resources, managed by a common driver. A pool may span more than one ResourceSlice, and exactly how many ResourceSlices comprise a pool is determined by the driver.<br><p> <br><p> At the moment, the only supported resources are devices with attributes and capacities. Each device in a given pool, regardless of how many ResourceSlices, must have a unique name. The ResourceSlice in which a device gets published may change over time. The unique identifier for a device is the tuple &lt;driver name&gt;, &lt;pool name&gt;, &lt;device name&gt;.<br><p> <br><p> Whenever a driver needs to update a pool, it increments the pool.Spec.Pool.Generation number and updates all ResourceSlices with that new number and new resource definitions. A consumer must only use ResourceSlices with the highest generation number and ignore all others.<br><p> <br><p> When allocating all resources in a pool matching certain criteria or when looking for the best solution among several different alternatives, a consumer should check the number of ResourceSlices in a pool (included in each ResourceSlice) to determine whether its view of a pool is complete and if not, should wait until the driver has completed updating the pool.<br><p> <br><p> For resources that are not local to a node, the node name is not set. Instead, the driver may use a node selector to specify where the devices are available.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class ResourceSlice implements Editable<ResourceSliceBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1alpha3";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResourceSlice";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public ResourceSlice(String apiVersion, String kind, ObjectMeta metadata, Resour
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResourceSlice represents one or more resources in a pool of similar resources, managed by a common driver. A pool may span more than one ResourceSlice, and exactly how many ResourceSlices comprise a pool is determined by the driver.<br><p> <br><p> At the moment, the only supported resources are devices with attributes and capacities. Each device in a given pool, regardless of how many ResourceSlices, must have a unique name. The ResourceSlice in which a device gets published may change over time. The unique identifier for a device is the tuple &lt;driver name&gt;, &lt;pool name&gt;, &lt;device name&gt;.<br><p> <br><p> Whenever a driver needs to update a pool, it increments the pool.Spec.Pool.Generation number and updates all ResourceSlices with that new number and new resource definitions. A consumer must only use ResourceSlices with the highest generation number and ignore all others.<br><p> <br><p> When allocating all resources in a pool matching certain criteria or when looking for the best solution among several different alternatives, a consumer should check the number of ResourceSlices in a pool (included in each ResourceSlice) to determine whether its view of a pool is complete and if not, should wait until the driver has completed updating the pool.<br><p> <br><p> For resources that are not local to a node, the node name is not set. Instead, the driver may use a node selector to specify where the devices are available.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceSlice represents one or more resources in a pool of similar resources, managed by a common driver. A pool may span more than one ResourceSlice, and exactly how many ResourceSlices comprise a pool is determined by the driver.<br><p> <br><p> At the moment, the only supported resources are devices with attributes and capacities. Each device in a given pool, regardless of how many ResourceSlices, must have a unique name. The ResourceSlice in which a device gets published may change over time. The unique identifier for a device is the tuple &lt;driver name&gt;, &lt;pool name&gt;, &lt;device name&gt;.<br><p> <br><p> Whenever a driver needs to update a pool, it increments the pool.Spec.Pool.Generation number and updates all ResourceSlices with that new number and new resource definitions. A consumer must only use ResourceSlices with the highest generation number and ignore all others.<br><p> <br><p> When allocating all resources in a pool matching certain criteria or when looking for the best solution among several different alternatives, a consumer should check the number of ResourceSlices in a pool (included in each ResourceSlice) to determine whether its view of a pool is complete and if not, should wait until the driver has completed updating the pool.<br><p> <br><p> For resources that are not local to a node, the node name is not set. Instead, the driver may use a node selector to specify where the devices are available.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ResourceSlice represents one or more resources in a pool of similar resources, managed by a common driver. A pool may span more than one ResourceSlice, and exactly how many ResourceSlices comprise a pool is determined by the driver.<br><p> <br><p> At the moment, the only supported resources are devices with attributes and capacities. Each device in a given pool, regardless of how many ResourceSlices, must have a unique name. The ResourceSlice in which a device gets published may change over time. The unique identifier for a device is the tuple &lt;driver name&gt;, &lt;pool name&gt;, &lt;device name&gt;.<br><p> <br><p> Whenever a driver needs to update a pool, it increments the pool.Spec.Pool.Generation number and updates all ResourceSlices with that new number and new resource definitions. A consumer must only use ResourceSlices with the highest generation number and ignore all others.<br><p> <br><p> When allocating all resources in a pool matching certain criteria or when looking for the best solution among several different alternatives, a consumer should check the number of ResourceSlices in a pool (included in each ResourceSlice) to determine whether its view of a pool is complete and if not, should wait until the driver has completed updating the pool.<br><p> <br><p> For resources that are not local to a node, the node name is not set. Instead, the driver may use a node selector to specify where the devices are available.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("spec")
     public ResourceSliceSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ResourceSlice represents one or more resources in a pool of similar resources, managed by a common driver. A pool may span more than one ResourceSlice, and exactly how many ResourceSlices comprise a pool is determined by the driver.<br><p> <br><p> At the moment, the only supported resources are devices with attributes and capacities. Each device in a given pool, regardless of how many ResourceSlices, must have a unique name. The ResourceSlice in which a device gets published may change over time. The unique identifier for a device is the tuple &lt;driver name&gt;, &lt;pool name&gt;, &lt;device name&gt;.<br><p> <br><p> Whenever a driver needs to update a pool, it increments the pool.Spec.Pool.Generation number and updates all ResourceSlices with that new number and new resource definitions. A consumer must only use ResourceSlices with the highest generation number and ignore all others.<br><p> <br><p> When allocating all resources in a pool matching certain criteria or when looking for the best solution among several different alternatives, a consumer should check the number of ResourceSlices in a pool (included in each ResourceSlice) to determine whether its view of a pool is complete and if not, should wait until the driver has completed updating the pool.<br><p> <br><p> For resources that are not local to a node, the node name is not set. Instead, the driver may use a node selector to specify where the devices are available.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("spec")
     public void setSpec(ResourceSliceSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceSliceList.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceSliceList.java
index efe528ceca2..e7f21649f10 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceSliceList.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceSliceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceSliceList is a collection of ResourceSlices.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ResourceSliceList implements Editable<ResourceSliceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.resource.v1alpha3.ResourceSlice>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1alpha3";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.resource.v1alpha3.ResourceSlice> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResourceSliceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ResourceSliceList(String apiVersion, List<io.fabric8.kubernetes.api.model
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of resource ResourceSlices.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.resource.v1alpha3.ResourceSlice> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of resource ResourceSlices.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.resource.v1alpha3.ResourceSlice> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResourceSliceList is a collection of ResourceSlices.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceSliceList is a collection of ResourceSlices.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceSliceSpec.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceSliceSpec.java
index fc5e47360b7..151d879d940 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceSliceSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1alpha3/ResourceSliceSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceSliceSpec contains the information published by the driver in one ResourceSlice.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,62 +105,98 @@ public ResourceSliceSpec(Boolean allNodes, List<Device> devices, String driver,
         this.pool = pool;
     }
 
+    /**
+     * AllNodes indicates that all nodes have access to the resources in the pool.<br><p> <br><p> Exactly one of NodeName, NodeSelector and AllNodes must be set.
+     */
     @JsonProperty("allNodes")
     public Boolean getAllNodes() {
         return allNodes;
     }
 
+    /**
+     * AllNodes indicates that all nodes have access to the resources in the pool.<br><p> <br><p> Exactly one of NodeName, NodeSelector and AllNodes must be set.
+     */
     @JsonProperty("allNodes")
     public void setAllNodes(Boolean allNodes) {
         this.allNodes = allNodes;
     }
 
+    /**
+     * Devices lists some or all of the devices in this pool.<br><p> <br><p> Must not have more than 128 entries.
+     */
     @JsonProperty("devices")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Device> getDevices() {
         return devices;
     }
 
+    /**
+     * Devices lists some or all of the devices in this pool.<br><p> <br><p> Must not have more than 128 entries.
+     */
     @JsonProperty("devices")
     public void setDevices(List<Device> devices) {
         this.devices = devices;
     }
 
+    /**
+     * Driver identifies the DRA driver providing the capacity information. A field selector can be used to list only ResourceSlice objects with a certain driver name.<br><p> <br><p> Must be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver. This field is immutable.
+     */
     @JsonProperty("driver")
     public String getDriver() {
         return driver;
     }
 
+    /**
+     * Driver identifies the DRA driver providing the capacity information. A field selector can be used to list only ResourceSlice objects with a certain driver name.<br><p> <br><p> Must be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver. This field is immutable.
+     */
     @JsonProperty("driver")
     public void setDriver(String driver) {
         this.driver = driver;
     }
 
+    /**
+     * NodeName identifies the node which provides the resources in this pool. A field selector can be used to list only ResourceSlice objects belonging to a certain node.<br><p> <br><p> This field can be used to limit access from nodes to ResourceSlices with the same node name. It also indicates to autoscalers that adding new nodes of the same type as some old node might also make new resources available.<br><p> <br><p> Exactly one of NodeName, NodeSelector and AllNodes must be set. This field is immutable.
+     */
     @JsonProperty("nodeName")
     public String getNodeName() {
         return nodeName;
     }
 
+    /**
+     * NodeName identifies the node which provides the resources in this pool. A field selector can be used to list only ResourceSlice objects belonging to a certain node.<br><p> <br><p> This field can be used to limit access from nodes to ResourceSlices with the same node name. It also indicates to autoscalers that adding new nodes of the same type as some old node might also make new resources available.<br><p> <br><p> Exactly one of NodeName, NodeSelector and AllNodes must be set. This field is immutable.
+     */
     @JsonProperty("nodeName")
     public void setNodeName(String nodeName) {
         this.nodeName = nodeName;
     }
 
+    /**
+     * ResourceSliceSpec contains the information published by the driver in one ResourceSlice.
+     */
     @JsonProperty("nodeSelector")
     public NodeSelector getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * ResourceSliceSpec contains the information published by the driver in one ResourceSlice.
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(NodeSelector nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * ResourceSliceSpec contains the information published by the driver in one ResourceSlice.
+     */
     @JsonProperty("pool")
     public ResourcePool getPool() {
         return pool;
     }
 
+    /**
+     * ResourceSliceSpec contains the information published by the driver in one ResourceSlice.
+     */
     @JsonProperty("pool")
     public void setPool(ResourcePool pool) {
         this.pool = pool;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/AllocatedDeviceStatus.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/AllocatedDeviceStatus.java
index 547ecc9d916..f25dd5ccc23 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/AllocatedDeviceStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/AllocatedDeviceStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AllocatedDeviceStatus contains the status of an allocated device, if the driver chooses to report it. This may include driver-specific information.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -103,63 +106,99 @@ public AllocatedDeviceStatus(List<Condition> conditions, Object data, String dev
         this.pool = pool;
     }
 
+    /**
+     * Conditions contains the latest observation of the device's state. If the device has been configured according to the class and claim config references, the `Ready` condition should be True.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions contains the latest observation of the device's state. If the device has been configured according to the class and claim config references, the `Ready` condition should be True.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * AllocatedDeviceStatus contains the status of an allocated device, if the driver chooses to report it. This may include driver-specific information.
+     */
     @JsonProperty("data")
     public Object getData() {
         return data;
     }
 
+    /**
+     * AllocatedDeviceStatus contains the status of an allocated device, if the driver chooses to report it. This may include driver-specific information.
+     */
     @JsonProperty("data")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setData(Object data) {
         this.data = data;
     }
 
+    /**
+     * Device references one device instance via its name in the driver's resource pool. It must be a DNS label.
+     */
     @JsonProperty("device")
     public String getDevice() {
         return device;
     }
 
+    /**
+     * Device references one device instance via its name in the driver's resource pool. It must be a DNS label.
+     */
     @JsonProperty("device")
     public void setDevice(String device) {
         this.device = device;
     }
 
+    /**
+     * Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.<br><p> <br><p> Must be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.
+     */
     @JsonProperty("driver")
     public String getDriver() {
         return driver;
     }
 
+    /**
+     * Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.<br><p> <br><p> Must be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.
+     */
     @JsonProperty("driver")
     public void setDriver(String driver) {
         this.driver = driver;
     }
 
+    /**
+     * AllocatedDeviceStatus contains the status of an allocated device, if the driver chooses to report it. This may include driver-specific information.
+     */
     @JsonProperty("networkData")
     public NetworkDeviceData getNetworkData() {
         return networkData;
     }
 
+    /**
+     * AllocatedDeviceStatus contains the status of an allocated device, if the driver chooses to report it. This may include driver-specific information.
+     */
     @JsonProperty("networkData")
     public void setNetworkData(NetworkDeviceData networkData) {
         this.networkData = networkData;
     }
 
+    /**
+     * This name together with the driver name and the device name field identify which device was allocated (`&lt;driver name&gt;/&lt;pool name&gt;/&lt;device name&gt;`).<br><p> <br><p> Must not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.
+     */
     @JsonProperty("pool")
     public String getPool() {
         return pool;
     }
 
+    /**
+     * This name together with the driver name and the device name field identify which device was allocated (`&lt;driver name&gt;/&lt;pool name&gt;/&lt;device name&gt;`).<br><p> <br><p> Must not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.
+     */
     @JsonProperty("pool")
     public void setPool(String pool) {
         this.pool = pool;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/AllocationResult.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/AllocationResult.java
index 8dd58c56030..a2f35ade310 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/AllocationResult.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/AllocationResult.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AllocationResult contains attributes of an allocated resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public AllocationResult(DeviceAllocationResult devices, NodeSelector nodeSelecto
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * AllocationResult contains attributes of an allocated resource.
+     */
     @JsonProperty("devices")
     public DeviceAllocationResult getDevices() {
         return devices;
     }
 
+    /**
+     * AllocationResult contains attributes of an allocated resource.
+     */
     @JsonProperty("devices")
     public void setDevices(DeviceAllocationResult devices) {
         this.devices = devices;
     }
 
+    /**
+     * AllocationResult contains attributes of an allocated resource.
+     */
     @JsonProperty("nodeSelector")
     public NodeSelector getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * AllocationResult contains attributes of an allocated resource.
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(NodeSelector nodeSelector) {
         this.nodeSelector = nodeSelector;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/BasicDevice.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/BasicDevice.java
index 9fffa9fb0a1..1b2de89cfd6 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/BasicDevice.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/BasicDevice.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BasicDevice defines one device instance.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -84,23 +87,35 @@ public BasicDevice(Map<String, DeviceAttribute> attributes, Map<String, DeviceCa
         this.capacity = capacity;
     }
 
+    /**
+     * Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.<br><p> <br><p> The maximum number of attributes and capacities combined is 32.
+     */
     @JsonProperty("attributes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, DeviceAttribute> getAttributes() {
         return attributes;
     }
 
+    /**
+     * Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.<br><p> <br><p> The maximum number of attributes and capacities combined is 32.
+     */
     @JsonProperty("attributes")
     public void setAttributes(Map<String, DeviceAttribute> attributes) {
         this.attributes = attributes;
     }
 
+    /**
+     * Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.<br><p> <br><p> The maximum number of attributes and capacities combined is 32.
+     */
     @JsonProperty("capacity")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, DeviceCapacity> getCapacity() {
         return capacity;
     }
 
+    /**
+     * Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.<br><p> <br><p> The maximum number of attributes and capacities combined is 32.
+     */
     @JsonProperty("capacity")
     public void setCapacity(Map<String, DeviceCapacity> capacity) {
         this.capacity = capacity;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/CELDeviceSelector.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/CELDeviceSelector.java
index 8f3315af358..565f3989a1e 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/CELDeviceSelector.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/CELDeviceSelector.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CELDeviceSelector contains a CEL expression for selecting a device.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public CELDeviceSelector(String expression) {
         this.expression = expression;
     }
 
+    /**
+     * Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.<br><p> <br><p> The expression's input is an object named "device", which carries the following properties:<br><p>  - driver (string): the name of the driver which defines this device.<br><p>  - attributes (map[string]object): the device's attributes, grouped by prefix<br><p>    (e.g. device.attributes["dra.example.com"] evaluates to an object with all<br><p>    of the attributes which were prefixed by "dra.example.com".<br><p>  - capacity (map[string]object): the device's capacities, grouped by prefix.<br><p> <br><p> Example: Consider a device with driver="dra.example.com", which exposes two attributes named "model" and "ext.example.com/family" and which exposes one capacity named "modules". This input to this expression would have the following fields:<br><p> <br><p>     device.driver<br><p>     device.attributes["dra.example.com"].model<br><p>     device.attributes["ext.example.com"].family<br><p>     device.capacity["dra.example.com"].modules<br><p> <br><p> The device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.<br><p> <br><p> The value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.<br><p> <br><p> If an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.<br><p> <br><p> A robust expression should check for the existence of attributes before referencing them.<br><p> <br><p> For ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:<br><p> <br><p>     cel.bind(dra, device.attributes["dra.example.com"], dra.someBool &amp;&amp; dra.anotherBool)<br><p> <br><p> The length of the expression must be smaller or equal to 10 Ki. The cost of evaluating it is also limited based on the estimated number of logical steps.
+     */
     @JsonProperty("expression")
     public String getExpression() {
         return expression;
     }
 
+    /**
+     * Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.<br><p> <br><p> The expression's input is an object named "device", which carries the following properties:<br><p>  - driver (string): the name of the driver which defines this device.<br><p>  - attributes (map[string]object): the device's attributes, grouped by prefix<br><p>    (e.g. device.attributes["dra.example.com"] evaluates to an object with all<br><p>    of the attributes which were prefixed by "dra.example.com".<br><p>  - capacity (map[string]object): the device's capacities, grouped by prefix.<br><p> <br><p> Example: Consider a device with driver="dra.example.com", which exposes two attributes named "model" and "ext.example.com/family" and which exposes one capacity named "modules". This input to this expression would have the following fields:<br><p> <br><p>     device.driver<br><p>     device.attributes["dra.example.com"].model<br><p>     device.attributes["ext.example.com"].family<br><p>     device.capacity["dra.example.com"].modules<br><p> <br><p> The device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.<br><p> <br><p> The value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.<br><p> <br><p> If an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.<br><p> <br><p> A robust expression should check for the existence of attributes before referencing them.<br><p> <br><p> For ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:<br><p> <br><p>     cel.bind(dra, device.attributes["dra.example.com"], dra.someBool &amp;&amp; dra.anotherBool)<br><p> <br><p> The length of the expression must be smaller or equal to 10 Ki. The cost of evaluating it is also limited based on the estimated number of logical steps.
+     */
     @JsonProperty("expression")
     public void setExpression(String expression) {
         this.expression = expression;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/Device.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/Device.java
index ce3b9bebf5a..39284c6ece6 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/Device.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/Device.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Device(BasicDevice basic, String name) {
         this.name = name;
     }
 
+    /**
+     * Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.
+     */
     @JsonProperty("basic")
     public BasicDevice getBasic() {
         return basic;
     }
 
+    /**
+     * Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.
+     */
     @JsonProperty("basic")
     public void setBasic(BasicDevice basic) {
         this.basic = basic;
     }
 
+    /**
+     * Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceAllocationConfiguration.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceAllocationConfiguration.java
index 2122de26c2b..7775816234d 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceAllocationConfiguration.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceAllocationConfiguration.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeviceAllocationConfiguration gets embedded in an AllocationResult.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public DeviceAllocationConfiguration(OpaqueDeviceConfiguration opaque, List<Stri
         this.source = source;
     }
 
+    /**
+     * DeviceAllocationConfiguration gets embedded in an AllocationResult.
+     */
     @JsonProperty("opaque")
     public OpaqueDeviceConfiguration getOpaque() {
         return opaque;
     }
 
+    /**
+     * DeviceAllocationConfiguration gets embedded in an AllocationResult.
+     */
     @JsonProperty("opaque")
     public void setOpaque(OpaqueDeviceConfiguration opaque) {
         this.opaque = opaque;
     }
 
+    /**
+     * Requests lists the names of requests where the configuration applies. If empty, its applies to all requests.
+     */
     @JsonProperty("requests")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getRequests() {
         return requests;
     }
 
+    /**
+     * Requests lists the names of requests where the configuration applies. If empty, its applies to all requests.
+     */
     @JsonProperty("requests")
     public void setRequests(List<String> requests) {
         this.requests = requests;
     }
 
+    /**
+     * Source records whether the configuration comes from a class and thus is not something that a normal user would have been able to set or from a claim.
+     */
     @JsonProperty("source")
     public String getSource() {
         return source;
     }
 
+    /**
+     * Source records whether the configuration comes from a class and thus is not something that a normal user would have been able to set or from a claim.
+     */
     @JsonProperty("source")
     public void setSource(String source) {
         this.source = source;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceAllocationResult.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceAllocationResult.java
index 0d11742394e..060abdbe779 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceAllocationResult.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceAllocationResult.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeviceAllocationResult is the result of allocating devices.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public DeviceAllocationResult(List<DeviceAllocationConfiguration> config, List<D
         this.results = results;
     }
 
+    /**
+     * This field is a combination of all the claim and class configuration parameters. Drivers can distinguish between those based on a flag.<br><p> <br><p> This includes configuration parameters for drivers which have no allocated devices in the result because it is up to the drivers which configuration parameters they support. They can silently ignore unknown configuration parameters.
+     */
     @JsonProperty("config")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DeviceAllocationConfiguration> getConfig() {
         return config;
     }
 
+    /**
+     * This field is a combination of all the claim and class configuration parameters. Drivers can distinguish between those based on a flag.<br><p> <br><p> This includes configuration parameters for drivers which have no allocated devices in the result because it is up to the drivers which configuration parameters they support. They can silently ignore unknown configuration parameters.
+     */
     @JsonProperty("config")
     public void setConfig(List<DeviceAllocationConfiguration> config) {
         this.config = config;
     }
 
+    /**
+     * Results lists all allocated devices.
+     */
     @JsonProperty("results")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DeviceRequestAllocationResult> getResults() {
         return results;
     }
 
+    /**
+     * Results lists all allocated devices.
+     */
     @JsonProperty("results")
     public void setResults(List<DeviceRequestAllocationResult> results) {
         this.results = results;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceAttribute.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceAttribute.java
index 7932893a156..c18c34246fc 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceAttribute.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceAttribute.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeviceAttribute must have exactly one field set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public DeviceAttribute(Boolean bool, Long _int, String string, String version) {
         this.version = version;
     }
 
+    /**
+     * BoolValue is a true/false value.
+     */
     @JsonProperty("bool")
     public Boolean getBool() {
         return bool;
     }
 
+    /**
+     * BoolValue is a true/false value.
+     */
     @JsonProperty("bool")
     public void setBool(Boolean bool) {
         this.bool = bool;
     }
 
+    /**
+     * IntValue is a number.
+     */
     @JsonProperty("int")
     public Long getInt() {
         return _int;
     }
 
+    /**
+     * IntValue is a number.
+     */
     @JsonProperty("int")
     public void setInt(Long _int) {
         this._int = _int;
     }
 
+    /**
+     * StringValue is a string. Must not be longer than 64 characters.
+     */
     @JsonProperty("string")
     public String getString() {
         return string;
     }
 
+    /**
+     * StringValue is a string. Must not be longer than 64 characters.
+     */
     @JsonProperty("string")
     public void setString(String string) {
         this.string = string;
     }
 
+    /**
+     * VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceCapacity.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceCapacity.java
index acdf5019da9..c9061893d14 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceCapacity.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceCapacity.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeviceCapacity describes a quantity associated with a device.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,11 +82,17 @@ public DeviceCapacity(Quantity value) {
         this.value = value;
     }
 
+    /**
+     * DeviceCapacity describes a quantity associated with a device.
+     */
     @JsonProperty("value")
     public Quantity getValue() {
         return value;
     }
 
+    /**
+     * DeviceCapacity describes a quantity associated with a device.
+     */
     @JsonProperty("value")
     public void setValue(Quantity value) {
         this.value = value;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceClaim.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceClaim.java
index 7ee13a375cf..beb8e3cbedf 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceClaim.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceClaim.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeviceClaim defines how to request devices with a ResourceClaim.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,34 +94,52 @@ public DeviceClaim(List<DeviceClaimConfiguration> config, List<DeviceConstraint>
         this.requests = requests;
     }
 
+    /**
+     * This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.
+     */
     @JsonProperty("config")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DeviceClaimConfiguration> getConfig() {
         return config;
     }
 
+    /**
+     * This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.
+     */
     @JsonProperty("config")
     public void setConfig(List<DeviceClaimConfiguration> config) {
         this.config = config;
     }
 
+    /**
+     * These constraints must be satisfied by the set of devices that get allocated for the claim.
+     */
     @JsonProperty("constraints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DeviceConstraint> getConstraints() {
         return constraints;
     }
 
+    /**
+     * These constraints must be satisfied by the set of devices that get allocated for the claim.
+     */
     @JsonProperty("constraints")
     public void setConstraints(List<DeviceConstraint> constraints) {
         this.constraints = constraints;
     }
 
+    /**
+     * Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.
+     */
     @JsonProperty("requests")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DeviceRequest> getRequests() {
         return requests;
     }
 
+    /**
+     * Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.
+     */
     @JsonProperty("requests")
     public void setRequests(List<DeviceRequest> requests) {
         this.requests = requests;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceClaimConfiguration.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceClaimConfiguration.java
index 4e282331f52..114c9f60f75 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceClaimConfiguration.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceClaimConfiguration.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public DeviceClaimConfiguration(OpaqueDeviceConfiguration opaque, List<String> r
         this.requests = requests;
     }
 
+    /**
+     * DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.
+     */
     @JsonProperty("opaque")
     public OpaqueDeviceConfiguration getOpaque() {
         return opaque;
     }
 
+    /**
+     * DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.
+     */
     @JsonProperty("opaque")
     public void setOpaque(OpaqueDeviceConfiguration opaque) {
         this.opaque = opaque;
     }
 
+    /**
+     * Requests lists the names of requests where the configuration applies. If empty, it applies to all requests.
+     */
     @JsonProperty("requests")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getRequests() {
         return requests;
     }
 
+    /**
+     * Requests lists the names of requests where the configuration applies. If empty, it applies to all requests.
+     */
     @JsonProperty("requests")
     public void setRequests(List<String> requests) {
         this.requests = requests;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceClass.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceClass.java
index 4b426f16747..bb7897a7c89 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceClass.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceClass.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeviceClass is a vendor- or admin-provided resource that contains device configuration and selectors. It can be referenced in the device requests of a claim to apply these presets. Cluster scoped.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class DeviceClass implements Editable<DeviceClassBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DeviceClass";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public DeviceClass(String apiVersion, String kind, ObjectMeta metadata, DeviceCl
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DeviceClass is a vendor- or admin-provided resource that contains device configuration and selectors. It can be referenced in the device requests of a claim to apply these presets. Cluster scoped.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DeviceClass is a vendor- or admin-provided resource that contains device configuration and selectors. It can be referenced in the device requests of a claim to apply these presets. Cluster scoped.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * DeviceClass is a vendor- or admin-provided resource that contains device configuration and selectors. It can be referenced in the device requests of a claim to apply these presets. Cluster scoped.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("spec")
     public DeviceClassSpec getSpec() {
         return spec;
     }
 
+    /**
+     * DeviceClass is a vendor- or admin-provided resource that contains device configuration and selectors. It can be referenced in the device requests of a claim to apply these presets. Cluster scoped.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("spec")
     public void setSpec(DeviceClassSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceClassConfiguration.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceClassConfiguration.java
index 38aed165a8b..39741172e97 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceClassConfiguration.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceClassConfiguration.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeviceClassConfiguration is used in DeviceClass.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public DeviceClassConfiguration(OpaqueDeviceConfiguration opaque) {
         this.opaque = opaque;
     }
 
+    /**
+     * DeviceClassConfiguration is used in DeviceClass.
+     */
     @JsonProperty("opaque")
     public OpaqueDeviceConfiguration getOpaque() {
         return opaque;
     }
 
+    /**
+     * DeviceClassConfiguration is used in DeviceClass.
+     */
     @JsonProperty("opaque")
     public void setOpaque(OpaqueDeviceConfiguration opaque) {
         this.opaque = opaque;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceClassList.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceClassList.java
index 75af643031b..97fd09df4d0 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceClassList.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceClassList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeviceClassList is a collection of classes.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class DeviceClassList implements Editable<DeviceClassListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.resource.v1beta1.DeviceClass>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.resource.v1beta1.DeviceClass> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DeviceClassList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DeviceClassList(String apiVersion, List<io.fabric8.kubernetes.api.model.r
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of resource classes.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.resource.v1beta1.DeviceClass> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of resource classes.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.resource.v1beta1.DeviceClass> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DeviceClassList is a collection of classes.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DeviceClassList is a collection of classes.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceClassSpec.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceClassSpec.java
index c80afd6da2a..196a82dc939 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceClassSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceClassSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeviceClassSpec is used in a [DeviceClass] to define what can be allocated and how to configure it.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public DeviceClassSpec(List<DeviceClassConfiguration> config, List<DeviceSelecto
         this.selectors = selectors;
     }
 
+    /**
+     * Config defines configuration parameters that apply to each device that is claimed via this class. Some classses may potentially be satisfied by multiple drivers, so each instance of a vendor configuration applies to exactly one driver.<br><p> <br><p> They are passed to the driver, but are not considered while allocating the claim.
+     */
     @JsonProperty("config")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DeviceClassConfiguration> getConfig() {
         return config;
     }
 
+    /**
+     * Config defines configuration parameters that apply to each device that is claimed via this class. Some classses may potentially be satisfied by multiple drivers, so each instance of a vendor configuration applies to exactly one driver.<br><p> <br><p> They are passed to the driver, but are not considered while allocating the claim.
+     */
     @JsonProperty("config")
     public void setConfig(List<DeviceClassConfiguration> config) {
         this.config = config;
     }
 
+    /**
+     * Each selector must be satisfied by a device which is claimed via this class.
+     */
     @JsonProperty("selectors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DeviceSelector> getSelectors() {
         return selectors;
     }
 
+    /**
+     * Each selector must be satisfied by a device which is claimed via this class.
+     */
     @JsonProperty("selectors")
     public void setSelectors(List<DeviceSelector> selectors) {
         this.selectors = selectors;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceConstraint.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceConstraint.java
index 6cf4f12d66b..ada26420549 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceConstraint.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceConstraint.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeviceConstraint must have exactly one field set besides Requests.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public DeviceConstraint(String matchAttribute, List<String> requests) {
         this.requests = requests;
     }
 
+    /**
+     * MatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices.<br><p> <br><p> For example, if you specified "dra.example.com/numa" (a hypothetical example!), then only devices in the same NUMA node will be chosen. A device which does not have that attribute will not be chosen. All devices should use a value of the same type for this attribute because that is part of its specification, but if one device doesn't, then it also will not be chosen.<br><p> <br><p> Must include the domain qualifier.
+     */
     @JsonProperty("matchAttribute")
     public String getMatchAttribute() {
         return matchAttribute;
     }
 
+    /**
+     * MatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices.<br><p> <br><p> For example, if you specified "dra.example.com/numa" (a hypothetical example!), then only devices in the same NUMA node will be chosen. A device which does not have that attribute will not be chosen. All devices should use a value of the same type for this attribute because that is part of its specification, but if one device doesn't, then it also will not be chosen.<br><p> <br><p> Must include the domain qualifier.
+     */
     @JsonProperty("matchAttribute")
     public void setMatchAttribute(String matchAttribute) {
         this.matchAttribute = matchAttribute;
     }
 
+    /**
+     * Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint. If this is not specified, this constraint applies to all requests in this claim.
+     */
     @JsonProperty("requests")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getRequests() {
         return requests;
     }
 
+    /**
+     * Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint. If this is not specified, this constraint applies to all requests in this claim.
+     */
     @JsonProperty("requests")
     public void setRequests(List<String> requests) {
         this.requests = requests;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceRequest.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceRequest.java
index 9abe66cfd35..f112b6db2ed 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceRequest.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceRequest.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeviceRequest is a request for devices required for a claim. This is typically a request for a single resource like a device, but can also ask for several identical devices.<br><p> <br><p> A DeviceClassName is currently required. Clients must check that it is indeed set. It's absence indicates that something changed in a way that is not supported by the client yet, in which case it must refuse to handle the request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,62 +104,98 @@ public DeviceRequest(Boolean adminAccess, String allocationMode, Long count, Str
         this.selectors = selectors;
     }
 
+    /**
+     * AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device.  They ignore all ordinary claims to the device with respect to access modes and any resource allocations.<br><p> <br><p> This is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.
+     */
     @JsonProperty("adminAccess")
     public Boolean getAdminAccess() {
         return adminAccess;
     }
 
+    /**
+     * AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device.  They ignore all ordinary claims to the device with respect to access modes and any resource allocations.<br><p> <br><p> This is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.
+     */
     @JsonProperty("adminAccess")
     public void setAdminAccess(Boolean adminAccess) {
         this.adminAccess = adminAccess;
     }
 
+    /**
+     * AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:<br><p> <br><p> - ExactCount: This request is for a specific number of devices.<br><p>   This is the default. The exact number is provided in the<br><p>   count field.<br><p> <br><p> - All: This request is for all of the matching devices in a pool.<br><p>   Allocation will fail if some devices are already allocated,<br><p>   unless adminAccess is requested.<br><p> <br><p> If AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.<br><p> <br><p> More modes may get added in the future. Clients must refuse to handle requests with unknown modes.
+     */
     @JsonProperty("allocationMode")
     public String getAllocationMode() {
         return allocationMode;
     }
 
+    /**
+     * AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:<br><p> <br><p> - ExactCount: This request is for a specific number of devices.<br><p>   This is the default. The exact number is provided in the<br><p>   count field.<br><p> <br><p> - All: This request is for all of the matching devices in a pool.<br><p>   Allocation will fail if some devices are already allocated,<br><p>   unless adminAccess is requested.<br><p> <br><p> If AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.<br><p> <br><p> More modes may get added in the future. Clients must refuse to handle requests with unknown modes.
+     */
     @JsonProperty("allocationMode")
     public void setAllocationMode(String allocationMode) {
         this.allocationMode = allocationMode;
     }
 
+    /**
+     * Count is used only when the count mode is "ExactCount". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.
+     */
     @JsonProperty("count")
     public Long getCount() {
         return count;
     }
 
+    /**
+     * Count is used only when the count mode is "ExactCount". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.
+     */
     @JsonProperty("count")
     public void setCount(Long count) {
         this.count = count;
     }
 
+    /**
+     * DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.<br><p> <br><p> A class is required. Which classes are available depends on the cluster.<br><p> <br><p> Administrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.
+     */
     @JsonProperty("deviceClassName")
     public String getDeviceClassName() {
         return deviceClassName;
     }
 
+    /**
+     * DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.<br><p> <br><p> A class is required. Which classes are available depends on the cluster.<br><p> <br><p> Administrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.
+     */
     @JsonProperty("deviceClassName")
     public void setDeviceClassName(String deviceClassName) {
         this.deviceClassName = deviceClassName;
     }
 
+    /**
+     * Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.<br><p> <br><p> Must be a DNS label.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.<br><p> <br><p> Must be a DNS label.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.
+     */
     @JsonProperty("selectors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DeviceSelector> getSelectors() {
         return selectors;
     }
 
+    /**
+     * Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.
+     */
     @JsonProperty("selectors")
     public void setSelectors(List<DeviceSelector> selectors) {
         this.selectors = selectors;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceRequestAllocationResult.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceRequestAllocationResult.java
index 2deccd115ac..5e5bf8869bf 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceRequestAllocationResult.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceRequestAllocationResult.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeviceRequestAllocationResult contains the allocation result for one request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public DeviceRequestAllocationResult(Boolean adminAccess, String device, String
         this.request = request;
     }
 
+    /**
+     * AdminAccess indicates that this device was allocated for administrative access. See the corresponding request field for a definition of mode.<br><p> <br><p> This is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.
+     */
     @JsonProperty("adminAccess")
     public Boolean getAdminAccess() {
         return adminAccess;
     }
 
+    /**
+     * AdminAccess indicates that this device was allocated for administrative access. See the corresponding request field for a definition of mode.<br><p> <br><p> This is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.
+     */
     @JsonProperty("adminAccess")
     public void setAdminAccess(Boolean adminAccess) {
         this.adminAccess = adminAccess;
     }
 
+    /**
+     * Device references one device instance via its name in the driver's resource pool. It must be a DNS label.
+     */
     @JsonProperty("device")
     public String getDevice() {
         return device;
     }
 
+    /**
+     * Device references one device instance via its name in the driver's resource pool. It must be a DNS label.
+     */
     @JsonProperty("device")
     public void setDevice(String device) {
         this.device = device;
     }
 
+    /**
+     * Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.<br><p> <br><p> Must be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.
+     */
     @JsonProperty("driver")
     public String getDriver() {
         return driver;
     }
 
+    /**
+     * Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.<br><p> <br><p> Must be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.
+     */
     @JsonProperty("driver")
     public void setDriver(String driver) {
         this.driver = driver;
     }
 
+    /**
+     * This name together with the driver name and the device name field identify which device was allocated (`&lt;driver name&gt;/&lt;pool name&gt;/&lt;device name&gt;`).<br><p> <br><p> Must not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.
+     */
     @JsonProperty("pool")
     public String getPool() {
         return pool;
     }
 
+    /**
+     * This name together with the driver name and the device name field identify which device was allocated (`&lt;driver name&gt;/&lt;pool name&gt;/&lt;device name&gt;`).<br><p> <br><p> Must not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.
+     */
     @JsonProperty("pool")
     public void setPool(String pool) {
         this.pool = pool;
     }
 
+    /**
+     * Request is the name of the request in the claim which caused this device to be allocated. Multiple devices may have been allocated per request.
+     */
     @JsonProperty("request")
     public String getRequest() {
         return request;
     }
 
+    /**
+     * Request is the name of the request in the claim which caused this device to be allocated. Multiple devices may have been allocated per request.
+     */
     @JsonProperty("request")
     public void setRequest(String request) {
         this.request = request;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceSelector.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceSelector.java
index a5f0e80a603..4c4db1a308a 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceSelector.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/DeviceSelector.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeviceSelector must have exactly one field set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public DeviceSelector(CELDeviceSelector cel) {
         this.cel = cel;
     }
 
+    /**
+     * DeviceSelector must have exactly one field set.
+     */
     @JsonProperty("cel")
     public CELDeviceSelector getCel() {
         return cel;
     }
 
+    /**
+     * DeviceSelector must have exactly one field set.
+     */
     @JsonProperty("cel")
     public void setCel(CELDeviceSelector cel) {
         this.cel = cel;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/NetworkDeviceData.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/NetworkDeviceData.java
index 70c82a598ae..311efcd9c5b 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/NetworkDeviceData.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/NetworkDeviceData.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkDeviceData provides network-related details for the allocated device. This information may be filled by drivers or other components to configure or identify the device within a network context.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public NetworkDeviceData(String hardwareAddress, String interfaceName, List<Stri
         this.ips = ips;
     }
 
+    /**
+     * HardwareAddress represents the hardware address (e.g. MAC Address) of the device's network interface.<br><p> <br><p> Must not be longer than 128 characters.
+     */
     @JsonProperty("hardwareAddress")
     public String getHardwareAddress() {
         return hardwareAddress;
     }
 
+    /**
+     * HardwareAddress represents the hardware address (e.g. MAC Address) of the device's network interface.<br><p> <br><p> Must not be longer than 128 characters.
+     */
     @JsonProperty("hardwareAddress")
     public void setHardwareAddress(String hardwareAddress) {
         this.hardwareAddress = hardwareAddress;
     }
 
+    /**
+     * InterfaceName specifies the name of the network interface associated with the allocated device. This might be the name of a physical or virtual network interface being configured in the pod.<br><p> <br><p> Must not be longer than 256 characters.
+     */
     @JsonProperty("interfaceName")
     public String getInterfaceName() {
         return interfaceName;
     }
 
+    /**
+     * InterfaceName specifies the name of the network interface associated with the allocated device. This might be the name of a physical or virtual network interface being configured in the pod.<br><p> <br><p> Must not be longer than 256 characters.
+     */
     @JsonProperty("interfaceName")
     public void setInterfaceName(String interfaceName) {
         this.interfaceName = interfaceName;
     }
 
+    /**
+     * IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: "192.0.2.5/24" for IPv4 and "2001:db8::5/64" for IPv6.
+     */
     @JsonProperty("ips")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIps() {
         return ips;
     }
 
+    /**
+     * IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: "192.0.2.5/24" for IPv4 and "2001:db8::5/64" for IPv6.
+     */
     @JsonProperty("ips")
     public void setIps(List<String> ips) {
         this.ips = ips;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/OpaqueDeviceConfiguration.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/OpaqueDeviceConfiguration.java
index 02cd1e16377..e661232fdc8 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/OpaqueDeviceConfiguration.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/OpaqueDeviceConfiguration.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public OpaqueDeviceConfiguration(String driver, Object parameters) {
         this.parameters = parameters;
     }
 
+    /**
+     * Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.<br><p> <br><p> An admission policy provided by the driver developer could use this to decide whether it needs to validate them.<br><p> <br><p> Must be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.
+     */
     @JsonProperty("driver")
     public String getDriver() {
         return driver;
     }
 
+    /**
+     * Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.<br><p> <br><p> An admission policy provided by the driver developer could use this to decide whether it needs to validate them.<br><p> <br><p> Must be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.
+     */
     @JsonProperty("driver")
     public void setDriver(String driver) {
         this.driver = driver;
     }
 
+    /**
+     * OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.
+     */
     @JsonProperty("parameters")
     public Object getParameters() {
         return parameters;
     }
 
+    /**
+     * OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.
+     */
     @JsonProperty("parameters")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setParameters(Object parameters) {
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaim.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaim.java
index 0d3c2f6d166..396845eca81 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaim.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaim.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class ResourceClaim implements Editable<ResourceClaimBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResourceClaim";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ResourceClaim(String apiVersion, String kind, ObjectMeta metadata, Resour
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("spec")
     public ResourceClaimSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("spec")
     public void setSpec(ResourceClaimSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("status")
     public ResourceClaimStatus getStatus() {
         return status;
     }
 
+    /**
+     * ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("status")
     public void setStatus(ResourceClaimStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaimConsumerReference.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaimConsumerReference.java
index 231782ba8e3..a3e91fbe091 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaimConsumerReference.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaimConsumerReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaimConsumerReference contains enough information to let you locate the consumer of a ResourceClaim. The user must be a resource in the same namespace as the ResourceClaim.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ResourceClaimConsumerReference(String apiGroup, String name, String resou
         this.uid = uid;
     }
 
+    /**
+     * APIGroup is the group for the resource being referenced. It is empty for the core API. This matches the group in the APIVersion that is used when creating the resources.
+     */
     @JsonProperty("apiGroup")
     public String getApiGroup() {
         return apiGroup;
     }
 
+    /**
+     * APIGroup is the group for the resource being referenced. It is empty for the core API. This matches the group in the APIVersion that is used when creating the resources.
+     */
     @JsonProperty("apiGroup")
     public void setApiGroup(String apiGroup) {
         this.apiGroup = apiGroup;
     }
 
+    /**
+     * Name is the name of resource being referenced.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of resource being referenced.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Resource is the type of resource being referenced, for example "pods".
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * Resource is the type of resource being referenced, for example "pods".
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
     }
 
+    /**
+     * UID identifies exactly one incarnation of the resource.
+     */
     @JsonProperty("uid")
     public String getUid() {
         return uid;
     }
 
+    /**
+     * UID identifies exactly one incarnation of the resource.
+     */
     @JsonProperty("uid")
     public void setUid(String uid) {
         this.uid = uid;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaimList.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaimList.java
index 82158f8a60f..4d38c8f0385 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaimList.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaimList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaimList is a collection of claims.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ResourceClaimList implements Editable<ResourceClaimListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.resource.v1beta1.ResourceClaim>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.resource.v1beta1.ResourceClaim> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResourceClaimList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ResourceClaimList(String apiVersion, List<io.fabric8.kubernetes.api.model
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of resource claims.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.resource.v1beta1.ResourceClaim> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of resource claims.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.resource.v1beta1.ResourceClaim> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResourceClaimList is a collection of claims.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceClaimList is a collection of claims.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaimSpec.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaimSpec.java
index 6341e27cef6..2fa48a3b04c 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaimSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaimSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ResourceClaimSpec(DeviceClaim devices) {
         this.devices = devices;
     }
 
+    /**
+     * ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.
+     */
     @JsonProperty("devices")
     public DeviceClaim getDevices() {
         return devices;
     }
 
+    /**
+     * ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.
+     */
     @JsonProperty("devices")
     public void setDevices(DeviceClaim devices) {
         this.devices = devices;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaimStatus.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaimStatus.java
index 1fb1936f58c..2863b772712 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaimStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaimStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaimStatus tracks whether the resource has been allocated and what the result of that was.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public ResourceClaimStatus(AllocationResult allocation, List<AllocatedDeviceStat
         this.reservedFor = reservedFor;
     }
 
+    /**
+     * ResourceClaimStatus tracks whether the resource has been allocated and what the result of that was.
+     */
     @JsonProperty("allocation")
     public AllocationResult getAllocation() {
         return allocation;
     }
 
+    /**
+     * ResourceClaimStatus tracks whether the resource has been allocated and what the result of that was.
+     */
     @JsonProperty("allocation")
     public void setAllocation(AllocationResult allocation) {
         this.allocation = allocation;
     }
 
+    /**
+     * Devices contains the status of each device allocated for this claim, as reported by the driver. This can include driver-specific information. Entries are owned by their respective drivers.
+     */
     @JsonProperty("devices")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AllocatedDeviceStatus> getDevices() {
         return devices;
     }
 
+    /**
+     * Devices contains the status of each device allocated for this claim, as reported by the driver. This can include driver-specific information. Entries are owned by their respective drivers.
+     */
     @JsonProperty("devices")
     public void setDevices(List<AllocatedDeviceStatus> devices) {
         this.devices = devices;
     }
 
+    /**
+     * ReservedFor indicates which entities are currently allowed to use the claim. A Pod which references a ResourceClaim which is not reserved for that Pod will not be started. A claim that is in use or might be in use because it has been reserved must not get deallocated.<br><p> <br><p> In a cluster with multiple scheduler instances, two pods might get scheduled concurrently by different schedulers. When they reference the same ResourceClaim which already has reached its maximum number of consumers, only one pod can be scheduled.<br><p> <br><p> Both schedulers try to add their pod to the claim.status.reservedFor field, but only the update that reaches the API server first gets stored. The other one fails with an error and the scheduler which issued it knows that it must put the pod back into the queue, waiting for the ResourceClaim to become usable again.<br><p> <br><p> There can be at most 256 such reservations. This may get increased in the future, but not reduced.
+     */
     @JsonProperty("reservedFor")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ResourceClaimConsumerReference> getReservedFor() {
         return reservedFor;
     }
 
+    /**
+     * ReservedFor indicates which entities are currently allowed to use the claim. A Pod which references a ResourceClaim which is not reserved for that Pod will not be started. A claim that is in use or might be in use because it has been reserved must not get deallocated.<br><p> <br><p> In a cluster with multiple scheduler instances, two pods might get scheduled concurrently by different schedulers. When they reference the same ResourceClaim which already has reached its maximum number of consumers, only one pod can be scheduled.<br><p> <br><p> Both schedulers try to add their pod to the claim.status.reservedFor field, but only the update that reaches the API server first gets stored. The other one fails with an error and the scheduler which issued it knows that it must put the pod back into the queue, waiting for the ResourceClaim to become usable again.<br><p> <br><p> There can be at most 256 such reservations. This may get increased in the future, but not reduced.
+     */
     @JsonProperty("reservedFor")
     public void setReservedFor(List<ResourceClaimConsumerReference> reservedFor) {
         this.reservedFor = reservedFor;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaimTemplate.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaimTemplate.java
index 071295c3be7..4618561cdfe 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaimTemplate.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaimTemplate.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaimTemplate is used to produce ResourceClaim objects.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ResourceClaimTemplate implements Editable<ResourceClaimTemplateBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResourceClaimTemplate";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public ResourceClaimTemplate(String apiVersion, String kind, ObjectMeta metadata
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResourceClaimTemplate is used to produce ResourceClaim objects.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceClaimTemplate is used to produce ResourceClaim objects.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ResourceClaimTemplate is used to produce ResourceClaim objects.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("spec")
     public ResourceClaimTemplateSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ResourceClaimTemplate is used to produce ResourceClaim objects.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("spec")
     public void setSpec(ResourceClaimTemplateSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaimTemplateList.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaimTemplateList.java
index e7cb09255bd..011231ae0f0 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaimTemplateList.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaimTemplateList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaimTemplateList is a collection of claim templates.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ResourceClaimTemplateList implements Editable<ResourceClaimTemplateListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.resource.v1beta1.ResourceClaimTemplate>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.resource.v1beta1.ResourceClaimTemplate> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResourceClaimTemplateList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ResourceClaimTemplateList(String apiVersion, List<io.fabric8.kubernetes.a
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of resource claim templates.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.resource.v1beta1.ResourceClaimTemplate> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of resource claim templates.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.resource.v1beta1.ResourceClaimTemplate> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResourceClaimTemplateList is a collection of claim templates.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceClaimTemplateList is a collection of claim templates.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaimTemplateSpec.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaimTemplateSpec.java
index 0a30eed73f1..3d66cabb380 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaimTemplateSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceClaimTemplateSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ResourceClaimTemplateSpec(ObjectMeta metadata, ResourceClaimSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.
+     */
     @JsonProperty("spec")
     public ResourceClaimSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.
+     */
     @JsonProperty("spec")
     public void setSpec(ResourceClaimSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourcePool.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourcePool.java
index b742410f988..769402c83ba 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourcePool.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourcePool.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourcePool describes the pool that ResourceSlices belong to.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ResourcePool(Long generation, String name, Long resourceSliceCount) {
         this.resourceSliceCount = resourceSliceCount;
     }
 
+    /**
+     * Generation tracks the change in a pool over time. Whenever a driver changes something about one or more of the resources in a pool, it must change the generation in all ResourceSlices which are part of that pool. Consumers of ResourceSlices should only consider resources from the pool with the highest generation number. The generation may be reset by drivers, which should be fine for consumers, assuming that all ResourceSlices in a pool are updated to match or deleted.<br><p> <br><p> Combined with ResourceSliceCount, this mechanism enables consumers to detect pools which are comprised of multiple ResourceSlices and are in an incomplete state.
+     */
     @JsonProperty("generation")
     public Long getGeneration() {
         return generation;
     }
 
+    /**
+     * Generation tracks the change in a pool over time. Whenever a driver changes something about one or more of the resources in a pool, it must change the generation in all ResourceSlices which are part of that pool. Consumers of ResourceSlices should only consider resources from the pool with the highest generation number. The generation may be reset by drivers, which should be fine for consumers, assuming that all ResourceSlices in a pool are updated to match or deleted.<br><p> <br><p> Combined with ResourceSliceCount, this mechanism enables consumers to detect pools which are comprised of multiple ResourceSlices and are in an incomplete state.
+     */
     @JsonProperty("generation")
     public void setGeneration(Long generation) {
         this.generation = generation;
     }
 
+    /**
+     * Name is used to identify the pool. For node-local devices, this is often the node name, but this is not required.<br><p> <br><p> It must not be longer than 253 characters and must consist of one or more DNS sub-domains separated by slashes. This field is immutable.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is used to identify the pool. For node-local devices, this is often the node name, but this is not required.<br><p> <br><p> It must not be longer than 253 characters and must consist of one or more DNS sub-domains separated by slashes. This field is immutable.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * ResourceSliceCount is the total number of ResourceSlices in the pool at this generation number. Must be greater than zero.<br><p> <br><p> Consumers can use this to check whether they have seen all ResourceSlices belonging to the same pool.
+     */
     @JsonProperty("resourceSliceCount")
     public Long getResourceSliceCount() {
         return resourceSliceCount;
     }
 
+    /**
+     * ResourceSliceCount is the total number of ResourceSlices in the pool at this generation number. Must be greater than zero.<br><p> <br><p> Consumers can use this to check whether they have seen all ResourceSlices belonging to the same pool.
+     */
     @JsonProperty("resourceSliceCount")
     public void setResourceSliceCount(Long resourceSliceCount) {
         this.resourceSliceCount = resourceSliceCount;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceSlice.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceSlice.java
index ed0fd996929..2a567c20deb 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceSlice.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceSlice.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceSlice represents one or more resources in a pool of similar resources, managed by a common driver. A pool may span more than one ResourceSlice, and exactly how many ResourceSlices comprise a pool is determined by the driver.<br><p> <br><p> At the moment, the only supported resources are devices with attributes and capacities. Each device in a given pool, regardless of how many ResourceSlices, must have a unique name. The ResourceSlice in which a device gets published may change over time. The unique identifier for a device is the tuple &lt;driver name&gt;, &lt;pool name&gt;, &lt;device name&gt;.<br><p> <br><p> Whenever a driver needs to update a pool, it increments the pool.Spec.Pool.Generation number and updates all ResourceSlices with that new number and new resource definitions. A consumer must only use ResourceSlices with the highest generation number and ignore all others.<br><p> <br><p> When allocating all resources in a pool matching certain criteria or when looking for the best solution among several different alternatives, a consumer should check the number of ResourceSlices in a pool (included in each ResourceSlice) to determine whether its view of a pool is complete and if not, should wait until the driver has completed updating the pool.<br><p> <br><p> For resources that are not local to a node, the node name is not set. Instead, the driver may use a node selector to specify where the devices are available.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class ResourceSlice implements Editable<ResourceSliceBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResourceSlice";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public ResourceSlice(String apiVersion, String kind, ObjectMeta metadata, Resour
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResourceSlice represents one or more resources in a pool of similar resources, managed by a common driver. A pool may span more than one ResourceSlice, and exactly how many ResourceSlices comprise a pool is determined by the driver.<br><p> <br><p> At the moment, the only supported resources are devices with attributes and capacities. Each device in a given pool, regardless of how many ResourceSlices, must have a unique name. The ResourceSlice in which a device gets published may change over time. The unique identifier for a device is the tuple &lt;driver name&gt;, &lt;pool name&gt;, &lt;device name&gt;.<br><p> <br><p> Whenever a driver needs to update a pool, it increments the pool.Spec.Pool.Generation number and updates all ResourceSlices with that new number and new resource definitions. A consumer must only use ResourceSlices with the highest generation number and ignore all others.<br><p> <br><p> When allocating all resources in a pool matching certain criteria or when looking for the best solution among several different alternatives, a consumer should check the number of ResourceSlices in a pool (included in each ResourceSlice) to determine whether its view of a pool is complete and if not, should wait until the driver has completed updating the pool.<br><p> <br><p> For resources that are not local to a node, the node name is not set. Instead, the driver may use a node selector to specify where the devices are available.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceSlice represents one or more resources in a pool of similar resources, managed by a common driver. A pool may span more than one ResourceSlice, and exactly how many ResourceSlices comprise a pool is determined by the driver.<br><p> <br><p> At the moment, the only supported resources are devices with attributes and capacities. Each device in a given pool, regardless of how many ResourceSlices, must have a unique name. The ResourceSlice in which a device gets published may change over time. The unique identifier for a device is the tuple &lt;driver name&gt;, &lt;pool name&gt;, &lt;device name&gt;.<br><p> <br><p> Whenever a driver needs to update a pool, it increments the pool.Spec.Pool.Generation number and updates all ResourceSlices with that new number and new resource definitions. A consumer must only use ResourceSlices with the highest generation number and ignore all others.<br><p> <br><p> When allocating all resources in a pool matching certain criteria or when looking for the best solution among several different alternatives, a consumer should check the number of ResourceSlices in a pool (included in each ResourceSlice) to determine whether its view of a pool is complete and if not, should wait until the driver has completed updating the pool.<br><p> <br><p> For resources that are not local to a node, the node name is not set. Instead, the driver may use a node selector to specify where the devices are available.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ResourceSlice represents one or more resources in a pool of similar resources, managed by a common driver. A pool may span more than one ResourceSlice, and exactly how many ResourceSlices comprise a pool is determined by the driver.<br><p> <br><p> At the moment, the only supported resources are devices with attributes and capacities. Each device in a given pool, regardless of how many ResourceSlices, must have a unique name. The ResourceSlice in which a device gets published may change over time. The unique identifier for a device is the tuple &lt;driver name&gt;, &lt;pool name&gt;, &lt;device name&gt;.<br><p> <br><p> Whenever a driver needs to update a pool, it increments the pool.Spec.Pool.Generation number and updates all ResourceSlices with that new number and new resource definitions. A consumer must only use ResourceSlices with the highest generation number and ignore all others.<br><p> <br><p> When allocating all resources in a pool matching certain criteria or when looking for the best solution among several different alternatives, a consumer should check the number of ResourceSlices in a pool (included in each ResourceSlice) to determine whether its view of a pool is complete and if not, should wait until the driver has completed updating the pool.<br><p> <br><p> For resources that are not local to a node, the node name is not set. Instead, the driver may use a node selector to specify where the devices are available.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("spec")
     public ResourceSliceSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ResourceSlice represents one or more resources in a pool of similar resources, managed by a common driver. A pool may span more than one ResourceSlice, and exactly how many ResourceSlices comprise a pool is determined by the driver.<br><p> <br><p> At the moment, the only supported resources are devices with attributes and capacities. Each device in a given pool, regardless of how many ResourceSlices, must have a unique name. The ResourceSlice in which a device gets published may change over time. The unique identifier for a device is the tuple &lt;driver name&gt;, &lt;pool name&gt;, &lt;device name&gt;.<br><p> <br><p> Whenever a driver needs to update a pool, it increments the pool.Spec.Pool.Generation number and updates all ResourceSlices with that new number and new resource definitions. A consumer must only use ResourceSlices with the highest generation number and ignore all others.<br><p> <br><p> When allocating all resources in a pool matching certain criteria or when looking for the best solution among several different alternatives, a consumer should check the number of ResourceSlices in a pool (included in each ResourceSlice) to determine whether its view of a pool is complete and if not, should wait until the driver has completed updating the pool.<br><p> <br><p> For resources that are not local to a node, the node name is not set. Instead, the driver may use a node selector to specify where the devices are available.<br><p> <br><p> This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
+     */
     @JsonProperty("spec")
     public void setSpec(ResourceSliceSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceSliceList.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceSliceList.java
index 47dc038d411..3c8c2b181dd 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceSliceList.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceSliceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceSliceList is a collection of ResourceSlices.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ResourceSliceList implements Editable<ResourceSliceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.resource.v1beta1.ResourceSlice>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "resource.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.resource.v1beta1.ResourceSlice> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResourceSliceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ResourceSliceList(String apiVersion, List<io.fabric8.kubernetes.api.model
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of resource ResourceSlices.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.resource.v1beta1.ResourceSlice> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of resource ResourceSlices.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.resource.v1beta1.ResourceSlice> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResourceSliceList is a collection of ResourceSlices.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceSliceList is a collection of ResourceSlices.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceSliceSpec.java b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceSliceSpec.java
index 684f2528891..922209c5dee 100644
--- a/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceSliceSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-resource/src/generated/java/io/fabric8/kubernetes/api/model/resource/v1beta1/ResourceSliceSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceSliceSpec contains the information published by the driver in one ResourceSlice.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,62 +105,98 @@ public ResourceSliceSpec(Boolean allNodes, List<Device> devices, String driver,
         this.pool = pool;
     }
 
+    /**
+     * AllNodes indicates that all nodes have access to the resources in the pool.<br><p> <br><p> Exactly one of NodeName, NodeSelector and AllNodes must be set.
+     */
     @JsonProperty("allNodes")
     public Boolean getAllNodes() {
         return allNodes;
     }
 
+    /**
+     * AllNodes indicates that all nodes have access to the resources in the pool.<br><p> <br><p> Exactly one of NodeName, NodeSelector and AllNodes must be set.
+     */
     @JsonProperty("allNodes")
     public void setAllNodes(Boolean allNodes) {
         this.allNodes = allNodes;
     }
 
+    /**
+     * Devices lists some or all of the devices in this pool.<br><p> <br><p> Must not have more than 128 entries.
+     */
     @JsonProperty("devices")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Device> getDevices() {
         return devices;
     }
 
+    /**
+     * Devices lists some or all of the devices in this pool.<br><p> <br><p> Must not have more than 128 entries.
+     */
     @JsonProperty("devices")
     public void setDevices(List<Device> devices) {
         this.devices = devices;
     }
 
+    /**
+     * Driver identifies the DRA driver providing the capacity information. A field selector can be used to list only ResourceSlice objects with a certain driver name.<br><p> <br><p> Must be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver. This field is immutable.
+     */
     @JsonProperty("driver")
     public String getDriver() {
         return driver;
     }
 
+    /**
+     * Driver identifies the DRA driver providing the capacity information. A field selector can be used to list only ResourceSlice objects with a certain driver name.<br><p> <br><p> Must be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver. This field is immutable.
+     */
     @JsonProperty("driver")
     public void setDriver(String driver) {
         this.driver = driver;
     }
 
+    /**
+     * NodeName identifies the node which provides the resources in this pool. A field selector can be used to list only ResourceSlice objects belonging to a certain node.<br><p> <br><p> This field can be used to limit access from nodes to ResourceSlices with the same node name. It also indicates to autoscalers that adding new nodes of the same type as some old node might also make new resources available.<br><p> <br><p> Exactly one of NodeName, NodeSelector and AllNodes must be set. This field is immutable.
+     */
     @JsonProperty("nodeName")
     public String getNodeName() {
         return nodeName;
     }
 
+    /**
+     * NodeName identifies the node which provides the resources in this pool. A field selector can be used to list only ResourceSlice objects belonging to a certain node.<br><p> <br><p> This field can be used to limit access from nodes to ResourceSlices with the same node name. It also indicates to autoscalers that adding new nodes of the same type as some old node might also make new resources available.<br><p> <br><p> Exactly one of NodeName, NodeSelector and AllNodes must be set. This field is immutable.
+     */
     @JsonProperty("nodeName")
     public void setNodeName(String nodeName) {
         this.nodeName = nodeName;
     }
 
+    /**
+     * ResourceSliceSpec contains the information published by the driver in one ResourceSlice.
+     */
     @JsonProperty("nodeSelector")
     public NodeSelector getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * ResourceSliceSpec contains the information published by the driver in one ResourceSlice.
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(NodeSelector nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * ResourceSliceSpec contains the information published by the driver in one ResourceSlice.
+     */
     @JsonProperty("pool")
     public ResourcePool getPool() {
         return pool;
     }
 
+    /**
+     * ResourceSliceSpec contains the information published by the driver in one ResourceSlice.
+     */
     @JsonProperty("pool")
     public void setPool(ResourcePool pool) {
         this.pool = pool;
diff --git a/kubernetes-model-generator/kubernetes-model-scheduling/src/generated/java/io/fabric8/kubernetes/api/model/scheduling/v1/PriorityClass.java b/kubernetes-model-generator/kubernetes-model-scheduling/src/generated/java/io/fabric8/kubernetes/api/model/scheduling/v1/PriorityClass.java
index 8295b8e52e4..99e1b00259f 100644
--- a/kubernetes-model-generator/kubernetes-model-scheduling/src/generated/java/io/fabric8/kubernetes/api/model/scheduling/v1/PriorityClass.java
+++ b/kubernetes-model-generator/kubernetes-model-scheduling/src/generated/java/io/fabric8/kubernetes/api/model/scheduling/v1/PriorityClass.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PriorityClass defines mapping from a priority class name to the priority integer value. The value can be any valid integer.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,18 +80,12 @@
 public class PriorityClass implements Editable<PriorityClassBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "scheduling.k8s.io/v1";
     @JsonProperty("description")
     private String description;
     @JsonProperty("globalDefault")
     private Boolean globalDefault;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PriorityClass";
     @JsonProperty("metadata")
@@ -118,7 +115,7 @@ public PriorityClass(String apiVersion, String description, Boolean globalDefaul
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -126,35 +123,47 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * description is an arbitrary string that usually provides guidelines on when this priority class should be used.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * description is an arbitrary string that usually provides guidelines on when this priority class should be used.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * globalDefault specifies whether this PriorityClass should be considered as the default priority for pods that do not have any priority class. Only one PriorityClass can be marked as `globalDefault`. However, if more than one PriorityClasses exists with their `globalDefault` field set to true, the smallest value of such global default PriorityClasses will be used as the default priority.
+     */
     @JsonProperty("globalDefault")
     public Boolean getGlobalDefault() {
         return globalDefault;
     }
 
+    /**
+     * globalDefault specifies whether this PriorityClass should be considered as the default priority for pods that do not have any priority class. Only one PriorityClass can be marked as `globalDefault`. However, if more than one PriorityClasses exists with their `globalDefault` field set to true, the smallest value of such global default PriorityClasses will be used as the default priority.
+     */
     @JsonProperty("globalDefault")
     public void setGlobalDefault(Boolean globalDefault) {
         this.globalDefault = globalDefault;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -162,38 +171,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PriorityClass defines mapping from a priority class name to the priority integer value. The value can be any valid integer.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PriorityClass defines mapping from a priority class name to the priority integer value. The value can be any valid integer.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * preemptionPolicy is the Policy for preempting pods with lower priority. One of Never, PreemptLowerPriority. Defaults to PreemptLowerPriority if unset.
+     */
     @JsonProperty("preemptionPolicy")
     public String getPreemptionPolicy() {
         return preemptionPolicy;
     }
 
+    /**
+     * preemptionPolicy is the Policy for preempting pods with lower priority. One of Never, PreemptLowerPriority. Defaults to PreemptLowerPriority if unset.
+     */
     @JsonProperty("preemptionPolicy")
     public void setPreemptionPolicy(String preemptionPolicy) {
         this.preemptionPolicy = preemptionPolicy;
     }
 
+    /**
+     * value represents the integer value of this priority class. This is the actual priority that pods receive when they have the name of this class in their pod spec.
+     */
     @JsonProperty("value")
     public Integer getValue() {
         return value;
     }
 
+    /**
+     * value represents the integer value of this priority class. This is the actual priority that pods receive when they have the name of this class in their pod spec.
+     */
     @JsonProperty("value")
     public void setValue(Integer value) {
         this.value = value;
diff --git a/kubernetes-model-generator/kubernetes-model-scheduling/src/generated/java/io/fabric8/kubernetes/api/model/scheduling/v1/PriorityClassList.java b/kubernetes-model-generator/kubernetes-model-scheduling/src/generated/java/io/fabric8/kubernetes/api/model/scheduling/v1/PriorityClassList.java
index 4b318ff7b25..218fb10120b 100644
--- a/kubernetes-model-generator/kubernetes-model-scheduling/src/generated/java/io/fabric8/kubernetes/api/model/scheduling/v1/PriorityClassList.java
+++ b/kubernetes-model-generator/kubernetes-model-scheduling/src/generated/java/io/fabric8/kubernetes/api/model/scheduling/v1/PriorityClassList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PriorityClassList is a collection of priority classes.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PriorityClassList implements Editable<PriorityClassListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.scheduling.v1.PriorityClass>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "scheduling.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.scheduling.v1.PriorityClass> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PriorityClassList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PriorityClassList(String apiVersion, List<io.fabric8.kubernetes.api.model
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of PriorityClasses
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.scheduling.v1.PriorityClass> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of PriorityClasses
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.scheduling.v1.PriorityClass> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PriorityClassList is a collection of priority classes.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PriorityClassList is a collection of priority classes.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-scheduling/src/generated/java/io/fabric8/kubernetes/api/model/scheduling/v1alpha1/PriorityClass.java b/kubernetes-model-generator/kubernetes-model-scheduling/src/generated/java/io/fabric8/kubernetes/api/model/scheduling/v1alpha1/PriorityClass.java
index a88cd8f5b12..04a5f2991cf 100644
--- a/kubernetes-model-generator/kubernetes-model-scheduling/src/generated/java/io/fabric8/kubernetes/api/model/scheduling/v1alpha1/PriorityClass.java
+++ b/kubernetes-model-generator/kubernetes-model-scheduling/src/generated/java/io/fabric8/kubernetes/api/model/scheduling/v1alpha1/PriorityClass.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DEPRECATED - This group version of PriorityClass is deprecated by scheduling.k8s.io/v1/PriorityClass. PriorityClass defines mapping from a priority class name to the priority integer value. The value can be any valid integer.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,18 +80,12 @@
 public class PriorityClass implements Editable<PriorityClassBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "scheduling.k8s.io/v1alpha1";
     @JsonProperty("description")
     private String description;
     @JsonProperty("globalDefault")
     private Boolean globalDefault;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PriorityClass";
     @JsonProperty("metadata")
@@ -118,7 +115,7 @@ public PriorityClass(String apiVersion, String description, Boolean globalDefaul
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -126,35 +123,47 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * description is an arbitrary string that usually provides guidelines on when this priority class should be used.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * description is an arbitrary string that usually provides guidelines on when this priority class should be used.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * globalDefault specifies whether this PriorityClass should be considered as the default priority for pods that do not have any priority class. Only one PriorityClass can be marked as `globalDefault`. However, if more than one PriorityClasses exists with their `globalDefault` field set to true, the smallest value of such global default PriorityClasses will be used as the default priority.
+     */
     @JsonProperty("globalDefault")
     public Boolean getGlobalDefault() {
         return globalDefault;
     }
 
+    /**
+     * globalDefault specifies whether this PriorityClass should be considered as the default priority for pods that do not have any priority class. Only one PriorityClass can be marked as `globalDefault`. However, if more than one PriorityClasses exists with their `globalDefault` field set to true, the smallest value of such global default PriorityClasses will be used as the default priority.
+     */
     @JsonProperty("globalDefault")
     public void setGlobalDefault(Boolean globalDefault) {
         this.globalDefault = globalDefault;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -162,38 +171,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DEPRECATED - This group version of PriorityClass is deprecated by scheduling.k8s.io/v1/PriorityClass. PriorityClass defines mapping from a priority class name to the priority integer value. The value can be any valid integer.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DEPRECATED - This group version of PriorityClass is deprecated by scheduling.k8s.io/v1/PriorityClass. PriorityClass defines mapping from a priority class name to the priority integer value. The value can be any valid integer.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PreemptionPolicy is the Policy for preempting pods with lower priority. One of Never, PreemptLowerPriority. Defaults to PreemptLowerPriority if unset. This field is beta-level, gated by the NonPreemptingPriority feature-gate.
+     */
     @JsonProperty("preemptionPolicy")
     public String getPreemptionPolicy() {
         return preemptionPolicy;
     }
 
+    /**
+     * PreemptionPolicy is the Policy for preempting pods with lower priority. One of Never, PreemptLowerPriority. Defaults to PreemptLowerPriority if unset. This field is beta-level, gated by the NonPreemptingPriority feature-gate.
+     */
     @JsonProperty("preemptionPolicy")
     public void setPreemptionPolicy(String preemptionPolicy) {
         this.preemptionPolicy = preemptionPolicy;
     }
 
+    /**
+     * The value of this priority class. This is the actual priority that pods receive when they have the name of this class in their pod spec.
+     */
     @JsonProperty("value")
     public Integer getValue() {
         return value;
     }
 
+    /**
+     * The value of this priority class. This is the actual priority that pods receive when they have the name of this class in their pod spec.
+     */
     @JsonProperty("value")
     public void setValue(Integer value) {
         this.value = value;
diff --git a/kubernetes-model-generator/kubernetes-model-scheduling/src/generated/java/io/fabric8/kubernetes/api/model/scheduling/v1alpha1/PriorityClassList.java b/kubernetes-model-generator/kubernetes-model-scheduling/src/generated/java/io/fabric8/kubernetes/api/model/scheduling/v1alpha1/PriorityClassList.java
index f237a7f6fc8..88ca95e3ba7 100644
--- a/kubernetes-model-generator/kubernetes-model-scheduling/src/generated/java/io/fabric8/kubernetes/api/model/scheduling/v1alpha1/PriorityClassList.java
+++ b/kubernetes-model-generator/kubernetes-model-scheduling/src/generated/java/io/fabric8/kubernetes/api/model/scheduling/v1alpha1/PriorityClassList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PriorityClassList is a collection of priority classes.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PriorityClassList implements Editable<PriorityClassListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.scheduling.v1alpha1.PriorityClass>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "scheduling.k8s.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.scheduling.v1alpha1.PriorityClass> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PriorityClassList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PriorityClassList(String apiVersion, List<io.fabric8.kubernetes.api.model
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of PriorityClasses
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.scheduling.v1alpha1.PriorityClass> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of PriorityClasses
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.scheduling.v1alpha1.PriorityClass> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PriorityClassList is a collection of priority classes.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PriorityClassList is a collection of priority classes.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-scheduling/src/generated/java/io/fabric8/kubernetes/api/model/scheduling/v1beta1/PriorityClass.java b/kubernetes-model-generator/kubernetes-model-scheduling/src/generated/java/io/fabric8/kubernetes/api/model/scheduling/v1beta1/PriorityClass.java
index ab92fa7f12a..ae2a4914ae2 100644
--- a/kubernetes-model-generator/kubernetes-model-scheduling/src/generated/java/io/fabric8/kubernetes/api/model/scheduling/v1beta1/PriorityClass.java
+++ b/kubernetes-model-generator/kubernetes-model-scheduling/src/generated/java/io/fabric8/kubernetes/api/model/scheduling/v1beta1/PriorityClass.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DEPRECATED - This group version of PriorityClass is deprecated by scheduling.k8s.io/v1/PriorityClass. PriorityClass defines mapping from a priority class name to the priority integer value. The value can be any valid integer.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,18 +80,12 @@
 public class PriorityClass implements Editable<PriorityClassBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "scheduling.k8s.io/v1beta1";
     @JsonProperty("description")
     private String description;
     @JsonProperty("globalDefault")
     private Boolean globalDefault;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PriorityClass";
     @JsonProperty("metadata")
@@ -118,7 +115,7 @@ public PriorityClass(String apiVersion, String description, Boolean globalDefaul
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -126,35 +123,47 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * description is an arbitrary string that usually provides guidelines on when this priority class should be used.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * description is an arbitrary string that usually provides guidelines on when this priority class should be used.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * globalDefault specifies whether this PriorityClass should be considered as the default priority for pods that do not have any priority class. Only one PriorityClass can be marked as `globalDefault`. However, if more than one PriorityClasses exists with their `globalDefault` field set to true, the smallest value of such global default PriorityClasses will be used as the default priority.
+     */
     @JsonProperty("globalDefault")
     public Boolean getGlobalDefault() {
         return globalDefault;
     }
 
+    /**
+     * globalDefault specifies whether this PriorityClass should be considered as the default priority for pods that do not have any priority class. Only one PriorityClass can be marked as `globalDefault`. However, if more than one PriorityClasses exists with their `globalDefault` field set to true, the smallest value of such global default PriorityClasses will be used as the default priority.
+     */
     @JsonProperty("globalDefault")
     public void setGlobalDefault(Boolean globalDefault) {
         this.globalDefault = globalDefault;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -162,38 +171,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DEPRECATED - This group version of PriorityClass is deprecated by scheduling.k8s.io/v1/PriorityClass. PriorityClass defines mapping from a priority class name to the priority integer value. The value can be any valid integer.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DEPRECATED - This group version of PriorityClass is deprecated by scheduling.k8s.io/v1/PriorityClass. PriorityClass defines mapping from a priority class name to the priority integer value. The value can be any valid integer.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PreemptionPolicy is the Policy for preempting pods with lower priority. One of Never, PreemptLowerPriority. Defaults to PreemptLowerPriority if unset. This field is beta-level, gated by the NonPreemptingPriority feature-gate.
+     */
     @JsonProperty("preemptionPolicy")
     public String getPreemptionPolicy() {
         return preemptionPolicy;
     }
 
+    /**
+     * PreemptionPolicy is the Policy for preempting pods with lower priority. One of Never, PreemptLowerPriority. Defaults to PreemptLowerPriority if unset. This field is beta-level, gated by the NonPreemptingPriority feature-gate.
+     */
     @JsonProperty("preemptionPolicy")
     public void setPreemptionPolicy(String preemptionPolicy) {
         this.preemptionPolicy = preemptionPolicy;
     }
 
+    /**
+     * The value of this priority class. This is the actual priority that pods receive when they have the name of this class in their pod spec.
+     */
     @JsonProperty("value")
     public Integer getValue() {
         return value;
     }
 
+    /**
+     * The value of this priority class. This is the actual priority that pods receive when they have the name of this class in their pod spec.
+     */
     @JsonProperty("value")
     public void setValue(Integer value) {
         this.value = value;
diff --git a/kubernetes-model-generator/kubernetes-model-scheduling/src/generated/java/io/fabric8/kubernetes/api/model/scheduling/v1beta1/PriorityClassList.java b/kubernetes-model-generator/kubernetes-model-scheduling/src/generated/java/io/fabric8/kubernetes/api/model/scheduling/v1beta1/PriorityClassList.java
index f83b7e4e42d..e9e6d16a798 100644
--- a/kubernetes-model-generator/kubernetes-model-scheduling/src/generated/java/io/fabric8/kubernetes/api/model/scheduling/v1beta1/PriorityClassList.java
+++ b/kubernetes-model-generator/kubernetes-model-scheduling/src/generated/java/io/fabric8/kubernetes/api/model/scheduling/v1beta1/PriorityClassList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PriorityClassList is a collection of priority classes.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PriorityClassList implements Editable<PriorityClassListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.scheduling.v1beta1.PriorityClass>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "scheduling.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.scheduling.v1beta1.PriorityClass> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PriorityClassList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PriorityClassList(String apiVersion, List<io.fabric8.kubernetes.api.model
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of PriorityClasses
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.scheduling.v1beta1.PriorityClass> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of PriorityClasses
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.scheduling.v1beta1.PriorityClass> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PriorityClassList is a collection of priority classes.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PriorityClassList is a collection of priority classes.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSIDriver.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSIDriver.java
index bcce97386cc..d580de3841b 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSIDriver.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSIDriver.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CSIDriver captures information about a Container Storage Interface (CSI) volume driver deployed on the cluster. Kubernetes attach detach controller uses this object to determine whether attach is required. Kubelet uses this object to determine whether pod information needs to be passed on mount. CSIDriver objects are non-namespaced.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class CSIDriver implements Editable<CSIDriverBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storage.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CSIDriver";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public CSIDriver(String apiVersion, String kind, ObjectMeta metadata, CSIDriverS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CSIDriver captures information about a Container Storage Interface (CSI) volume driver deployed on the cluster. Kubernetes attach detach controller uses this object to determine whether attach is required. Kubelet uses this object to determine whether pod information needs to be passed on mount. CSIDriver objects are non-namespaced.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CSIDriver captures information about a Container Storage Interface (CSI) volume driver deployed on the cluster. Kubernetes attach detach controller uses this object to determine whether attach is required. Kubelet uses this object to determine whether pod information needs to be passed on mount. CSIDriver objects are non-namespaced.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * CSIDriver captures information about a Container Storage Interface (CSI) volume driver deployed on the cluster. Kubernetes attach detach controller uses this object to determine whether attach is required. Kubelet uses this object to determine whether pod information needs to be passed on mount. CSIDriver objects are non-namespaced.
+     */
     @JsonProperty("spec")
     public CSIDriverSpec getSpec() {
         return spec;
     }
 
+    /**
+     * CSIDriver captures information about a Container Storage Interface (CSI) volume driver deployed on the cluster. Kubernetes attach detach controller uses this object to determine whether attach is required. Kubelet uses this object to determine whether pod information needs to be passed on mount. CSIDriver objects are non-namespaced.
+     */
     @JsonProperty("spec")
     public void setSpec(CSIDriverSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSIDriverList.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSIDriverList.java
index 13ee643635f..603c66453c6 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSIDriverList.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSIDriverList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CSIDriverList is a collection of CSIDriver objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class CSIDriverList implements Editable<CSIDriverListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.storage.CSIDriver>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storage.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.storage.CSIDriver> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CSIDriverList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CSIDriverList(String apiVersion, List<io.fabric8.kubernetes.api.model.sto
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of CSIDriver
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.storage.CSIDriver> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of CSIDriver
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.storage.CSIDriver> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CSIDriverList is a collection of CSIDriver objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CSIDriverList is a collection of CSIDriver objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSIDriverSpec.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSIDriverSpec.java
index 85dbc64bfde..66a67d5d0e7 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSIDriverSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSIDriverSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CSIDriverSpec is the specification of a CSIDriver.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -110,83 +113,131 @@ public CSIDriverSpec(Boolean attachRequired, String fsGroupPolicy, Boolean podIn
         this.volumeLifecycleModes = volumeLifecycleModes;
     }
 
+    /**
+     * attachRequired indicates this CSI volume driver requires an attach operation (because it implements the CSI ControllerPublishVolume() method), and that the Kubernetes attach detach controller should call the attach volume interface which checks the volumeattachment status and waits until the volume is attached before proceeding to mounting. The CSI external-attacher coordinates with CSI volume driver and updates the volumeattachment status when the attach operation is complete. If the CSIDriverRegistry feature gate is enabled and the value is specified to false, the attach operation will be skipped. Otherwise the attach operation will be called.<br><p> <br><p> This field is immutable.
+     */
     @JsonProperty("attachRequired")
     public Boolean getAttachRequired() {
         return attachRequired;
     }
 
+    /**
+     * attachRequired indicates this CSI volume driver requires an attach operation (because it implements the CSI ControllerPublishVolume() method), and that the Kubernetes attach detach controller should call the attach volume interface which checks the volumeattachment status and waits until the volume is attached before proceeding to mounting. The CSI external-attacher coordinates with CSI volume driver and updates the volumeattachment status when the attach operation is complete. If the CSIDriverRegistry feature gate is enabled and the value is specified to false, the attach operation will be skipped. Otherwise the attach operation will be called.<br><p> <br><p> This field is immutable.
+     */
     @JsonProperty("attachRequired")
     public void setAttachRequired(Boolean attachRequired) {
         this.attachRequired = attachRequired;
     }
 
+    /**
+     * fsGroupPolicy defines if the underlying volume supports changing ownership and permission of the volume before being mounted. Refer to the specific FSGroupPolicy values for additional details.<br><p> <br><p> This field was immutable in Kubernetes &lt; 1.29 and now is mutable.<br><p> <br><p> Defaults to ReadWriteOnceWithFSType, which will examine each volume to determine if Kubernetes should modify ownership and permissions of the volume. With the default policy the defined fsGroup will only be applied if a fstype is defined and the volume's access mode contains ReadWriteOnce.
+     */
     @JsonProperty("fsGroupPolicy")
     public String getFsGroupPolicy() {
         return fsGroupPolicy;
     }
 
+    /**
+     * fsGroupPolicy defines if the underlying volume supports changing ownership and permission of the volume before being mounted. Refer to the specific FSGroupPolicy values for additional details.<br><p> <br><p> This field was immutable in Kubernetes &lt; 1.29 and now is mutable.<br><p> <br><p> Defaults to ReadWriteOnceWithFSType, which will examine each volume to determine if Kubernetes should modify ownership and permissions of the volume. With the default policy the defined fsGroup will only be applied if a fstype is defined and the volume's access mode contains ReadWriteOnce.
+     */
     @JsonProperty("fsGroupPolicy")
     public void setFsGroupPolicy(String fsGroupPolicy) {
         this.fsGroupPolicy = fsGroupPolicy;
     }
 
+    /**
+     * podInfoOnMount indicates this CSI volume driver requires additional pod information (like podName, podUID, etc.) during mount operations, if set to true. If set to false, pod information will not be passed on mount. Default is false.<br><p> <br><p> The CSI driver specifies podInfoOnMount as part of driver deployment. If true, Kubelet will pass pod information as VolumeContext in the CSI NodePublishVolume() calls. The CSI driver is responsible for parsing and validating the information passed in as VolumeContext.<br><p> <br><p> The following VolumeContext will be passed if podInfoOnMount is set to true. This list might grow, but the prefix will be used. "csi.storage.k8s.io/pod.name": pod.Name "csi.storage.k8s.io/pod.namespace": pod.Namespace "csi.storage.k8s.io/pod.uid": string(pod.UID) "csi.storage.k8s.io/ephemeral": "true" if the volume is an ephemeral inline volume<br><p>                                 defined by a CSIVolumeSource, otherwise "false"<br><p> <br><p> "csi.storage.k8s.io/ephemeral" is a new feature in Kubernetes 1.16. It is only required for drivers which support both the "Persistent" and "Ephemeral" VolumeLifecycleMode. Other drivers can leave pod info disabled and/or ignore this field. As Kubernetes 1.15 doesn't support this field, drivers can only support one mode when deployed on such a cluster and the deployment determines which mode that is, for example via a command line parameter of the driver.<br><p> <br><p> This field was immutable in Kubernetes &lt; 1.29 and now is mutable.
+     */
     @JsonProperty("podInfoOnMount")
     public Boolean getPodInfoOnMount() {
         return podInfoOnMount;
     }
 
+    /**
+     * podInfoOnMount indicates this CSI volume driver requires additional pod information (like podName, podUID, etc.) during mount operations, if set to true. If set to false, pod information will not be passed on mount. Default is false.<br><p> <br><p> The CSI driver specifies podInfoOnMount as part of driver deployment. If true, Kubelet will pass pod information as VolumeContext in the CSI NodePublishVolume() calls. The CSI driver is responsible for parsing and validating the information passed in as VolumeContext.<br><p> <br><p> The following VolumeContext will be passed if podInfoOnMount is set to true. This list might grow, but the prefix will be used. "csi.storage.k8s.io/pod.name": pod.Name "csi.storage.k8s.io/pod.namespace": pod.Namespace "csi.storage.k8s.io/pod.uid": string(pod.UID) "csi.storage.k8s.io/ephemeral": "true" if the volume is an ephemeral inline volume<br><p>                                 defined by a CSIVolumeSource, otherwise "false"<br><p> <br><p> "csi.storage.k8s.io/ephemeral" is a new feature in Kubernetes 1.16. It is only required for drivers which support both the "Persistent" and "Ephemeral" VolumeLifecycleMode. Other drivers can leave pod info disabled and/or ignore this field. As Kubernetes 1.15 doesn't support this field, drivers can only support one mode when deployed on such a cluster and the deployment determines which mode that is, for example via a command line parameter of the driver.<br><p> <br><p> This field was immutable in Kubernetes &lt; 1.29 and now is mutable.
+     */
     @JsonProperty("podInfoOnMount")
     public void setPodInfoOnMount(Boolean podInfoOnMount) {
         this.podInfoOnMount = podInfoOnMount;
     }
 
+    /**
+     * requiresRepublish indicates the CSI driver wants `NodePublishVolume` being periodically called to reflect any possible change in the mounted volume. This field defaults to false.<br><p> <br><p> Note: After a successful initial NodePublishVolume call, subsequent calls to NodePublishVolume should only update the contents of the volume. New mount points will not be seen by a running container.
+     */
     @JsonProperty("requiresRepublish")
     public Boolean getRequiresRepublish() {
         return requiresRepublish;
     }
 
+    /**
+     * requiresRepublish indicates the CSI driver wants `NodePublishVolume` being periodically called to reflect any possible change in the mounted volume. This field defaults to false.<br><p> <br><p> Note: After a successful initial NodePublishVolume call, subsequent calls to NodePublishVolume should only update the contents of the volume. New mount points will not be seen by a running container.
+     */
     @JsonProperty("requiresRepublish")
     public void setRequiresRepublish(Boolean requiresRepublish) {
         this.requiresRepublish = requiresRepublish;
     }
 
+    /**
+     * seLinuxMount specifies if the CSI driver supports "-o context" mount option.<br><p> <br><p> When "true", the CSI driver must ensure that all volumes provided by this CSI driver can be mounted separately with different `-o context` options. This is typical for storage backends that provide volumes as filesystems on block devices or as independent shared volumes. Kubernetes will call NodeStage / NodePublish with "-o context=xyz" mount option when mounting a ReadWriteOncePod volume used in Pod that has explicitly set SELinux context. In the future, it may be expanded to other volume AccessModes. In any case, Kubernetes will ensure that the volume is mounted only with a single SELinux context.<br><p> <br><p> When "false", Kubernetes won't pass any special SELinux mount options to the driver. This is typical for volumes that represent subdirectories of a bigger shared filesystem.<br><p> <br><p> Default is "false".
+     */
     @JsonProperty("seLinuxMount")
     public Boolean getSeLinuxMount() {
         return seLinuxMount;
     }
 
+    /**
+     * seLinuxMount specifies if the CSI driver supports "-o context" mount option.<br><p> <br><p> When "true", the CSI driver must ensure that all volumes provided by this CSI driver can be mounted separately with different `-o context` options. This is typical for storage backends that provide volumes as filesystems on block devices or as independent shared volumes. Kubernetes will call NodeStage / NodePublish with "-o context=xyz" mount option when mounting a ReadWriteOncePod volume used in Pod that has explicitly set SELinux context. In the future, it may be expanded to other volume AccessModes. In any case, Kubernetes will ensure that the volume is mounted only with a single SELinux context.<br><p> <br><p> When "false", Kubernetes won't pass any special SELinux mount options to the driver. This is typical for volumes that represent subdirectories of a bigger shared filesystem.<br><p> <br><p> Default is "false".
+     */
     @JsonProperty("seLinuxMount")
     public void setSeLinuxMount(Boolean seLinuxMount) {
         this.seLinuxMount = seLinuxMount;
     }
 
+    /**
+     * storageCapacity indicates that the CSI volume driver wants pod scheduling to consider the storage capacity that the driver deployment will report by creating CSIStorageCapacity objects with capacity information, if set to true.<br><p> <br><p> The check can be enabled immediately when deploying a driver. In that case, provisioning new volumes with late binding will pause until the driver deployment has published some suitable CSIStorageCapacity object.<br><p> <br><p> Alternatively, the driver can be deployed with the field unset or false and it can be flipped later when storage capacity information has been published.<br><p> <br><p> This field was immutable in Kubernetes &lt;= 1.22 and now is mutable.
+     */
     @JsonProperty("storageCapacity")
     public Boolean getStorageCapacity() {
         return storageCapacity;
     }
 
+    /**
+     * storageCapacity indicates that the CSI volume driver wants pod scheduling to consider the storage capacity that the driver deployment will report by creating CSIStorageCapacity objects with capacity information, if set to true.<br><p> <br><p> The check can be enabled immediately when deploying a driver. In that case, provisioning new volumes with late binding will pause until the driver deployment has published some suitable CSIStorageCapacity object.<br><p> <br><p> Alternatively, the driver can be deployed with the field unset or false and it can be flipped later when storage capacity information has been published.<br><p> <br><p> This field was immutable in Kubernetes &lt;= 1.22 and now is mutable.
+     */
     @JsonProperty("storageCapacity")
     public void setStorageCapacity(Boolean storageCapacity) {
         this.storageCapacity = storageCapacity;
     }
 
+    /**
+     * tokenRequests indicates the CSI driver needs pods' service account tokens it is mounting volume for to do necessary authentication. Kubelet will pass the tokens in VolumeContext in the CSI NodePublishVolume calls. The CSI driver should parse and validate the following VolumeContext: "csi.storage.k8s.io/serviceAccount.tokens": {<br><p>   "&lt;audience&gt;": {<br><p>     "token": &lt;token&gt;,<br><p>     "expirationTimestamp": &lt;expiration timestamp in RFC3339&gt;,<br><p>   },<br><p>   ...<br><p> }<br><p> <br><p> Note: Audience in each TokenRequest should be different and at most one token is empty string. To receive a new token after expiry, RequiresRepublish can be used to trigger NodePublishVolume periodically.
+     */
     @JsonProperty("tokenRequests")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TokenRequest> getTokenRequests() {
         return tokenRequests;
     }
 
+    /**
+     * tokenRequests indicates the CSI driver needs pods' service account tokens it is mounting volume for to do necessary authentication. Kubelet will pass the tokens in VolumeContext in the CSI NodePublishVolume calls. The CSI driver should parse and validate the following VolumeContext: "csi.storage.k8s.io/serviceAccount.tokens": {<br><p>   "&lt;audience&gt;": {<br><p>     "token": &lt;token&gt;,<br><p>     "expirationTimestamp": &lt;expiration timestamp in RFC3339&gt;,<br><p>   },<br><p>   ...<br><p> }<br><p> <br><p> Note: Audience in each TokenRequest should be different and at most one token is empty string. To receive a new token after expiry, RequiresRepublish can be used to trigger NodePublishVolume periodically.
+     */
     @JsonProperty("tokenRequests")
     public void setTokenRequests(List<TokenRequest> tokenRequests) {
         this.tokenRequests = tokenRequests;
     }
 
+    /**
+     * volumeLifecycleModes defines what kind of volumes this CSI volume driver supports. The default if the list is empty is "Persistent", which is the usage defined by the CSI specification and implemented in Kubernetes via the usual PV/PVC mechanism.<br><p> <br><p> The other mode is "Ephemeral". In this mode, volumes are defined inline inside the pod spec with CSIVolumeSource and their lifecycle is tied to the lifecycle of that pod. A driver has to be aware of this because it is only going to get a NodePublishVolume call for such a volume.<br><p> <br><p> For more information about implementing this mode, see https://kubernetes-csi.github.io/docs/ephemeral-local-volumes.html A driver can support one or more of these modes and more modes may be added in the future.<br><p> <br><p> This field is beta. This field is immutable.
+     */
     @JsonProperty("volumeLifecycleModes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getVolumeLifecycleModes() {
         return volumeLifecycleModes;
     }
 
+    /**
+     * volumeLifecycleModes defines what kind of volumes this CSI volume driver supports. The default if the list is empty is "Persistent", which is the usage defined by the CSI specification and implemented in Kubernetes via the usual PV/PVC mechanism.<br><p> <br><p> The other mode is "Ephemeral". In this mode, volumes are defined inline inside the pod spec with CSIVolumeSource and their lifecycle is tied to the lifecycle of that pod. A driver has to be aware of this because it is only going to get a NodePublishVolume call for such a volume.<br><p> <br><p> For more information about implementing this mode, see https://kubernetes-csi.github.io/docs/ephemeral-local-volumes.html A driver can support one or more of these modes and more modes may be added in the future.<br><p> <br><p> This field is beta. This field is immutable.
+     */
     @JsonProperty("volumeLifecycleModes")
     public void setVolumeLifecycleModes(List<String> volumeLifecycleModes) {
         this.volumeLifecycleModes = volumeLifecycleModes;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSINode.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSINode.java
index d3c756e73d4..6503ba2e1bc 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSINode.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSINode.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CSINode holds information about all CSI drivers installed on a node. CSI drivers do not need to create the CSINode object directly. As long as they use the node-driver-registrar sidecar container, the kubelet will automatically populate the CSINode object for the CSI driver as part of kubelet plugin registration. CSINode has the same name as a node. If the object is missing, it means either there are no CSI Drivers available on the node, or the Kubelet version is low enough that it doesn't create this object. CSINode has an OwnerReference that points to the corresponding node object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class CSINode implements Editable<CSINodeBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storage.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CSINode";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public CSINode(String apiVersion, String kind, ObjectMeta metadata, CSINodeSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CSINode holds information about all CSI drivers installed on a node. CSI drivers do not need to create the CSINode object directly. As long as they use the node-driver-registrar sidecar container, the kubelet will automatically populate the CSINode object for the CSI driver as part of kubelet plugin registration. CSINode has the same name as a node. If the object is missing, it means either there are no CSI Drivers available on the node, or the Kubelet version is low enough that it doesn't create this object. CSINode has an OwnerReference that points to the corresponding node object.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CSINode holds information about all CSI drivers installed on a node. CSI drivers do not need to create the CSINode object directly. As long as they use the node-driver-registrar sidecar container, the kubelet will automatically populate the CSINode object for the CSI driver as part of kubelet plugin registration. CSINode has the same name as a node. If the object is missing, it means either there are no CSI Drivers available on the node, or the Kubelet version is low enough that it doesn't create this object. CSINode has an OwnerReference that points to the corresponding node object.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * CSINode holds information about all CSI drivers installed on a node. CSI drivers do not need to create the CSINode object directly. As long as they use the node-driver-registrar sidecar container, the kubelet will automatically populate the CSINode object for the CSI driver as part of kubelet plugin registration. CSINode has the same name as a node. If the object is missing, it means either there are no CSI Drivers available on the node, or the Kubelet version is low enough that it doesn't create this object. CSINode has an OwnerReference that points to the corresponding node object.
+     */
     @JsonProperty("spec")
     public CSINodeSpec getSpec() {
         return spec;
     }
 
+    /**
+     * CSINode holds information about all CSI drivers installed on a node. CSI drivers do not need to create the CSINode object directly. As long as they use the node-driver-registrar sidecar container, the kubelet will automatically populate the CSINode object for the CSI driver as part of kubelet plugin registration. CSINode has the same name as a node. If the object is missing, it means either there are no CSI Drivers available on the node, or the Kubelet version is low enough that it doesn't create this object. CSINode has an OwnerReference that points to the corresponding node object.
+     */
     @JsonProperty("spec")
     public void setSpec(CSINodeSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSINodeDriver.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSINodeDriver.java
index 0e56b8d6700..9e3aa398bee 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSINodeDriver.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSINodeDriver.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CSINodeDriver holds information about the specification of one CSI driver installed on a node
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public CSINodeDriver(VolumeNodeResources allocatable, String name, String nodeID
         this.topologyKeys = topologyKeys;
     }
 
+    /**
+     * CSINodeDriver holds information about the specification of one CSI driver installed on a node
+     */
     @JsonProperty("allocatable")
     public VolumeNodeResources getAllocatable() {
         return allocatable;
     }
 
+    /**
+     * CSINodeDriver holds information about the specification of one CSI driver installed on a node
+     */
     @JsonProperty("allocatable")
     public void setAllocatable(VolumeNodeResources allocatable) {
         this.allocatable = allocatable;
     }
 
+    /**
+     * name represents the name of the CSI driver that this object refers to. This MUST be the same name returned by the CSI GetPluginName() call for that driver.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name represents the name of the CSI driver that this object refers to. This MUST be the same name returned by the CSI GetPluginName() call for that driver.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * nodeID of the node from the driver point of view. This field enables Kubernetes to communicate with storage systems that do not share the same nomenclature for nodes. For example, Kubernetes may refer to a given node as "node1", but the storage system may refer to the same node as "nodeA". When Kubernetes issues a command to the storage system to attach a volume to a specific node, it can use this field to refer to the node name using the ID that the storage system will understand, e.g. "nodeA" instead of "node1". This field is required.
+     */
     @JsonProperty("nodeID")
     public String getNodeID() {
         return nodeID;
     }
 
+    /**
+     * nodeID of the node from the driver point of view. This field enables Kubernetes to communicate with storage systems that do not share the same nomenclature for nodes. For example, Kubernetes may refer to a given node as "node1", but the storage system may refer to the same node as "nodeA". When Kubernetes issues a command to the storage system to attach a volume to a specific node, it can use this field to refer to the node name using the ID that the storage system will understand, e.g. "nodeA" instead of "node1". This field is required.
+     */
     @JsonProperty("nodeID")
     public void setNodeID(String nodeID) {
         this.nodeID = nodeID;
     }
 
+    /**
+     * topologyKeys is the list of keys supported by the driver. When a driver is initialized on a cluster, it provides a set of topology keys that it understands (e.g. "company.com/zone", "company.com/region"). When a driver is initialized on a node, it provides the same topology keys along with values. Kubelet will expose these topology keys as labels on its own node object. When Kubernetes does topology aware provisioning, it can use this list to determine which labels it should retrieve from the node object and pass back to the driver. It is possible for different nodes to use different topology keys. This can be empty if driver does not support topology.
+     */
     @JsonProperty("topologyKeys")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getTopologyKeys() {
         return topologyKeys;
     }
 
+    /**
+     * topologyKeys is the list of keys supported by the driver. When a driver is initialized on a cluster, it provides a set of topology keys that it understands (e.g. "company.com/zone", "company.com/region"). When a driver is initialized on a node, it provides the same topology keys along with values. Kubelet will expose these topology keys as labels on its own node object. When Kubernetes does topology aware provisioning, it can use this list to determine which labels it should retrieve from the node object and pass back to the driver. It is possible for different nodes to use different topology keys. This can be empty if driver does not support topology.
+     */
     @JsonProperty("topologyKeys")
     public void setTopologyKeys(List<String> topologyKeys) {
         this.topologyKeys = topologyKeys;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSINodeList.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSINodeList.java
index 0e5a9ecf895..da2efd856a6 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSINodeList.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSINodeList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CSINodeList is a collection of CSINode objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class CSINodeList implements Editable<CSINodeListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.storage.CSINode>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storage.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.storage.CSINode> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CSINodeList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CSINodeList(String apiVersion, List<io.fabric8.kubernetes.api.model.stora
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of CSINode
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.storage.CSINode> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of CSINode
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.storage.CSINode> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CSINodeList is a collection of CSINode objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CSINodeList is a collection of CSINode objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSINodeSpec.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSINodeSpec.java
index 96ad777a538..e56e5f7b67b 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSINodeSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSINodeSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CSINodeSpec holds information about the specification of all CSI drivers installed on a node
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public CSINodeSpec(List<CSINodeDriver> drivers) {
         this.drivers = drivers;
     }
 
+    /**
+     * drivers is a list of information of all CSI Drivers existing on a node. If all drivers in the list are uninstalled, this can become empty.
+     */
     @JsonProperty("drivers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CSINodeDriver> getDrivers() {
         return drivers;
     }
 
+    /**
+     * drivers is a list of information of all CSI Drivers existing on a node. If all drivers in the list are uninstalled, this can become empty.
+     */
     @JsonProperty("drivers")
     public void setDrivers(List<CSINodeDriver> drivers) {
         this.drivers = drivers;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSIStorageCapacity.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSIStorageCapacity.java
index 64cab2b4233..75fe8d2b207 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSIStorageCapacity.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSIStorageCapacity.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CSIStorageCapacity stores the result of one CSI GetCapacity call. For a given StorageClass, this describes the available capacity in a particular topology segment.  This can be used when considering where to instantiate new PersistentVolumes.<br><p> <br><p> For example this can express things like: - StorageClass "standard" has "1234 GiB" available in "topology.kubernetes.io/zone=us-east1" - StorageClass "localssd" has "10 GiB" available in "kubernetes.io/hostname=knode-abc123"<br><p> <br><p> The following three cases all imply that no capacity is available for a certain combination: - no object exists with suitable topology and storage class name - such an object exists, but the capacity is unset - such an object exists, but the capacity is zero<br><p> <br><p> The producer of these objects can decide which approach is more suitable.<br><p> <br><p> They are consumed by the kube-scheduler when a CSI driver opts into capacity-aware scheduling with CSIDriverSpec.StorageCapacity. The scheduler compares the MaximumVolumeSize against the requested size of pending volumes to filter out unsuitable nodes. If MaximumVolumeSize is unset, it falls back to a comparison against the less precise Capacity. If that is also unset, the scheduler assumes that capacity is insufficient and tries some other node.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,16 +82,10 @@
 public class CSIStorageCapacity implements Editable<CSIStorageCapacityBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storage.k8s.io/v1";
     @JsonProperty("capacity")
     private Quantity capacity;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CSIStorageCapacity";
     @JsonProperty("maximumVolumeSize")
@@ -120,7 +117,7 @@ public CSIStorageCapacity(String apiVersion, Quantity capacity, String kind, Qua
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -128,25 +125,31 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * CSIStorageCapacity stores the result of one CSI GetCapacity call. For a given StorageClass, this describes the available capacity in a particular topology segment.  This can be used when considering where to instantiate new PersistentVolumes.<br><p> <br><p> For example this can express things like: - StorageClass "standard" has "1234 GiB" available in "topology.kubernetes.io/zone=us-east1" - StorageClass "localssd" has "10 GiB" available in "kubernetes.io/hostname=knode-abc123"<br><p> <br><p> The following three cases all imply that no capacity is available for a certain combination: - no object exists with suitable topology and storage class name - such an object exists, but the capacity is unset - such an object exists, but the capacity is zero<br><p> <br><p> The producer of these objects can decide which approach is more suitable.<br><p> <br><p> They are consumed by the kube-scheduler when a CSI driver opts into capacity-aware scheduling with CSIDriverSpec.StorageCapacity. The scheduler compares the MaximumVolumeSize against the requested size of pending volumes to filter out unsuitable nodes. If MaximumVolumeSize is unset, it falls back to a comparison against the less precise Capacity. If that is also unset, the scheduler assumes that capacity is insufficient and tries some other node.
+     */
     @JsonProperty("capacity")
     public Quantity getCapacity() {
         return capacity;
     }
 
+    /**
+     * CSIStorageCapacity stores the result of one CSI GetCapacity call. For a given StorageClass, this describes the available capacity in a particular topology segment.  This can be used when considering where to instantiate new PersistentVolumes.<br><p> <br><p> For example this can express things like: - StorageClass "standard" has "1234 GiB" available in "topology.kubernetes.io/zone=us-east1" - StorageClass "localssd" has "10 GiB" available in "kubernetes.io/hostname=knode-abc123"<br><p> <br><p> The following three cases all imply that no capacity is available for a certain combination: - no object exists with suitable topology and storage class name - such an object exists, but the capacity is unset - such an object exists, but the capacity is zero<br><p> <br><p> The producer of these objects can decide which approach is more suitable.<br><p> <br><p> They are consumed by the kube-scheduler when a CSI driver opts into capacity-aware scheduling with CSIDriverSpec.StorageCapacity. The scheduler compares the MaximumVolumeSize against the requested size of pending volumes to filter out unsuitable nodes. If MaximumVolumeSize is unset, it falls back to a comparison against the less precise Capacity. If that is also unset, the scheduler assumes that capacity is insufficient and tries some other node.
+     */
     @JsonProperty("capacity")
     public void setCapacity(Quantity capacity) {
         this.capacity = capacity;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -154,48 +157,72 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CSIStorageCapacity stores the result of one CSI GetCapacity call. For a given StorageClass, this describes the available capacity in a particular topology segment.  This can be used when considering where to instantiate new PersistentVolumes.<br><p> <br><p> For example this can express things like: - StorageClass "standard" has "1234 GiB" available in "topology.kubernetes.io/zone=us-east1" - StorageClass "localssd" has "10 GiB" available in "kubernetes.io/hostname=knode-abc123"<br><p> <br><p> The following three cases all imply that no capacity is available for a certain combination: - no object exists with suitable topology and storage class name - such an object exists, but the capacity is unset - such an object exists, but the capacity is zero<br><p> <br><p> The producer of these objects can decide which approach is more suitable.<br><p> <br><p> They are consumed by the kube-scheduler when a CSI driver opts into capacity-aware scheduling with CSIDriverSpec.StorageCapacity. The scheduler compares the MaximumVolumeSize against the requested size of pending volumes to filter out unsuitable nodes. If MaximumVolumeSize is unset, it falls back to a comparison against the less precise Capacity. If that is also unset, the scheduler assumes that capacity is insufficient and tries some other node.
+     */
     @JsonProperty("maximumVolumeSize")
     public Quantity getMaximumVolumeSize() {
         return maximumVolumeSize;
     }
 
+    /**
+     * CSIStorageCapacity stores the result of one CSI GetCapacity call. For a given StorageClass, this describes the available capacity in a particular topology segment.  This can be used when considering where to instantiate new PersistentVolumes.<br><p> <br><p> For example this can express things like: - StorageClass "standard" has "1234 GiB" available in "topology.kubernetes.io/zone=us-east1" - StorageClass "localssd" has "10 GiB" available in "kubernetes.io/hostname=knode-abc123"<br><p> <br><p> The following three cases all imply that no capacity is available for a certain combination: - no object exists with suitable topology and storage class name - such an object exists, but the capacity is unset - such an object exists, but the capacity is zero<br><p> <br><p> The producer of these objects can decide which approach is more suitable.<br><p> <br><p> They are consumed by the kube-scheduler when a CSI driver opts into capacity-aware scheduling with CSIDriverSpec.StorageCapacity. The scheduler compares the MaximumVolumeSize against the requested size of pending volumes to filter out unsuitable nodes. If MaximumVolumeSize is unset, it falls back to a comparison against the less precise Capacity. If that is also unset, the scheduler assumes that capacity is insufficient and tries some other node.
+     */
     @JsonProperty("maximumVolumeSize")
     public void setMaximumVolumeSize(Quantity maximumVolumeSize) {
         this.maximumVolumeSize = maximumVolumeSize;
     }
 
+    /**
+     * CSIStorageCapacity stores the result of one CSI GetCapacity call. For a given StorageClass, this describes the available capacity in a particular topology segment.  This can be used when considering where to instantiate new PersistentVolumes.<br><p> <br><p> For example this can express things like: - StorageClass "standard" has "1234 GiB" available in "topology.kubernetes.io/zone=us-east1" - StorageClass "localssd" has "10 GiB" available in "kubernetes.io/hostname=knode-abc123"<br><p> <br><p> The following three cases all imply that no capacity is available for a certain combination: - no object exists with suitable topology and storage class name - such an object exists, but the capacity is unset - such an object exists, but the capacity is zero<br><p> <br><p> The producer of these objects can decide which approach is more suitable.<br><p> <br><p> They are consumed by the kube-scheduler when a CSI driver opts into capacity-aware scheduling with CSIDriverSpec.StorageCapacity. The scheduler compares the MaximumVolumeSize against the requested size of pending volumes to filter out unsuitable nodes. If MaximumVolumeSize is unset, it falls back to a comparison against the less precise Capacity. If that is also unset, the scheduler assumes that capacity is insufficient and tries some other node.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CSIStorageCapacity stores the result of one CSI GetCapacity call. For a given StorageClass, this describes the available capacity in a particular topology segment.  This can be used when considering where to instantiate new PersistentVolumes.<br><p> <br><p> For example this can express things like: - StorageClass "standard" has "1234 GiB" available in "topology.kubernetes.io/zone=us-east1" - StorageClass "localssd" has "10 GiB" available in "kubernetes.io/hostname=knode-abc123"<br><p> <br><p> The following three cases all imply that no capacity is available for a certain combination: - no object exists with suitable topology and storage class name - such an object exists, but the capacity is unset - such an object exists, but the capacity is zero<br><p> <br><p> The producer of these objects can decide which approach is more suitable.<br><p> <br><p> They are consumed by the kube-scheduler when a CSI driver opts into capacity-aware scheduling with CSIDriverSpec.StorageCapacity. The scheduler compares the MaximumVolumeSize against the requested size of pending volumes to filter out unsuitable nodes. If MaximumVolumeSize is unset, it falls back to a comparison against the less precise Capacity. If that is also unset, the scheduler assumes that capacity is insufficient and tries some other node.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * CSIStorageCapacity stores the result of one CSI GetCapacity call. For a given StorageClass, this describes the available capacity in a particular topology segment.  This can be used when considering where to instantiate new PersistentVolumes.<br><p> <br><p> For example this can express things like: - StorageClass "standard" has "1234 GiB" available in "topology.kubernetes.io/zone=us-east1" - StorageClass "localssd" has "10 GiB" available in "kubernetes.io/hostname=knode-abc123"<br><p> <br><p> The following three cases all imply that no capacity is available for a certain combination: - no object exists with suitable topology and storage class name - such an object exists, but the capacity is unset - such an object exists, but the capacity is zero<br><p> <br><p> The producer of these objects can decide which approach is more suitable.<br><p> <br><p> They are consumed by the kube-scheduler when a CSI driver opts into capacity-aware scheduling with CSIDriverSpec.StorageCapacity. The scheduler compares the MaximumVolumeSize against the requested size of pending volumes to filter out unsuitable nodes. If MaximumVolumeSize is unset, it falls back to a comparison against the less precise Capacity. If that is also unset, the scheduler assumes that capacity is insufficient and tries some other node.
+     */
     @JsonProperty("nodeTopology")
     public LabelSelector getNodeTopology() {
         return nodeTopology;
     }
 
+    /**
+     * CSIStorageCapacity stores the result of one CSI GetCapacity call. For a given StorageClass, this describes the available capacity in a particular topology segment.  This can be used when considering where to instantiate new PersistentVolumes.<br><p> <br><p> For example this can express things like: - StorageClass "standard" has "1234 GiB" available in "topology.kubernetes.io/zone=us-east1" - StorageClass "localssd" has "10 GiB" available in "kubernetes.io/hostname=knode-abc123"<br><p> <br><p> The following three cases all imply that no capacity is available for a certain combination: - no object exists with suitable topology and storage class name - such an object exists, but the capacity is unset - such an object exists, but the capacity is zero<br><p> <br><p> The producer of these objects can decide which approach is more suitable.<br><p> <br><p> They are consumed by the kube-scheduler when a CSI driver opts into capacity-aware scheduling with CSIDriverSpec.StorageCapacity. The scheduler compares the MaximumVolumeSize against the requested size of pending volumes to filter out unsuitable nodes. If MaximumVolumeSize is unset, it falls back to a comparison against the less precise Capacity. If that is also unset, the scheduler assumes that capacity is insufficient and tries some other node.
+     */
     @JsonProperty("nodeTopology")
     public void setNodeTopology(LabelSelector nodeTopology) {
         this.nodeTopology = nodeTopology;
     }
 
+    /**
+     * storageClassName represents the name of the StorageClass that the reported capacity applies to. It must meet the same requirements as the name of a StorageClass object (non-empty, DNS subdomain). If that object no longer exists, the CSIStorageCapacity object is obsolete and should be removed by its creator. This field is immutable.
+     */
     @JsonProperty("storageClassName")
     public String getStorageClassName() {
         return storageClassName;
     }
 
+    /**
+     * storageClassName represents the name of the StorageClass that the reported capacity applies to. It must meet the same requirements as the name of a StorageClass object (non-empty, DNS subdomain). If that object no longer exists, the CSIStorageCapacity object is obsolete and should be removed by its creator. This field is immutable.
+     */
     @JsonProperty("storageClassName")
     public void setStorageClassName(String storageClassName) {
         this.storageClassName = storageClassName;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSIStorageCapacityList.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSIStorageCapacityList.java
index 32a8c504f7f..9df112036dc 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSIStorageCapacityList.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/CSIStorageCapacityList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CSIStorageCapacityList is a collection of CSIStorageCapacity objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class CSIStorageCapacityList implements Editable<CSIStorageCapacityListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.storage.CSIStorageCapacity>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storage.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.storage.CSIStorageCapacity> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CSIStorageCapacityList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CSIStorageCapacityList(String apiVersion, List<io.fabric8.kubernetes.api.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of CSIStorageCapacity objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.storage.CSIStorageCapacity> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of CSIStorageCapacity objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.storage.CSIStorageCapacity> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CSIStorageCapacityList is a collection of CSIStorageCapacity objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CSIStorageCapacityList is a collection of CSIStorageCapacity objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/StorageClass.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/StorageClass.java
index a9affc3288e..0fdb465ca2f 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/StorageClass.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/StorageClass.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StorageClass describes the parameters for a class of storage for which PersistentVolumes can be dynamically provisioned.<br><p> <br><p> StorageClasses are non-namespaced; the name of the storage class according to etcd is in ObjectMeta.Name.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -88,14 +91,8 @@ public class StorageClass implements Editable<StorageClassBuilder>, HasMetadata
     @JsonProperty("allowedTopologies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<TopologySelectorTerm> allowedTopologies = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storage.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "StorageClass";
     @JsonProperty("metadata")
@@ -135,29 +132,41 @@ public StorageClass(Boolean allowVolumeExpansion, List<TopologySelectorTerm> all
         this.volumeBindingMode = volumeBindingMode;
     }
 
+    /**
+     * allowVolumeExpansion shows whether the storage class allow volume expand.
+     */
     @JsonProperty("allowVolumeExpansion")
     public Boolean getAllowVolumeExpansion() {
         return allowVolumeExpansion;
     }
 
+    /**
+     * allowVolumeExpansion shows whether the storage class allow volume expand.
+     */
     @JsonProperty("allowVolumeExpansion")
     public void setAllowVolumeExpansion(Boolean allowVolumeExpansion) {
         this.allowVolumeExpansion = allowVolumeExpansion;
     }
 
+    /**
+     * allowedTopologies restrict the node topologies where volumes can be dynamically provisioned. Each volume plugin defines its own supported topology specifications. An empty TopologySelectorTerm list means there is no topology restriction. This field is only honored by servers that enable the VolumeScheduling feature.
+     */
     @JsonProperty("allowedTopologies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TopologySelectorTerm> getAllowedTopologies() {
         return allowedTopologies;
     }
 
+    /**
+     * allowedTopologies restrict the node topologies where volumes can be dynamically provisioned. Each volume plugin defines its own supported topology specifications. An empty TopologySelectorTerm list means there is no topology restriction. This field is only honored by servers that enable the VolumeScheduling feature.
+     */
     @JsonProperty("allowedTopologies")
     public void setAllowedTopologies(List<TopologySelectorTerm> allowedTopologies) {
         this.allowedTopologies = allowedTopologies;
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -165,7 +174,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -173,7 +182,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -181,70 +190,106 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * StorageClass describes the parameters for a class of storage for which PersistentVolumes can be dynamically provisioned.<br><p> <br><p> StorageClasses are non-namespaced; the name of the storage class according to etcd is in ObjectMeta.Name.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * StorageClass describes the parameters for a class of storage for which PersistentVolumes can be dynamically provisioned.<br><p> <br><p> StorageClasses are non-namespaced; the name of the storage class according to etcd is in ObjectMeta.Name.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * mountOptions controls the mountOptions for dynamically provisioned PersistentVolumes of this storage class. e.g. ["ro", "soft"]. Not validated - mount of the PVs will simply fail if one is invalid.
+     */
     @JsonProperty("mountOptions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMountOptions() {
         return mountOptions;
     }
 
+    /**
+     * mountOptions controls the mountOptions for dynamically provisioned PersistentVolumes of this storage class. e.g. ["ro", "soft"]. Not validated - mount of the PVs will simply fail if one is invalid.
+     */
     @JsonProperty("mountOptions")
     public void setMountOptions(List<String> mountOptions) {
         this.mountOptions = mountOptions;
     }
 
+    /**
+     * parameters holds the parameters for the provisioner that should create volumes of this storage class.
+     */
     @JsonProperty("parameters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getParameters() {
         return parameters;
     }
 
+    /**
+     * parameters holds the parameters for the provisioner that should create volumes of this storage class.
+     */
     @JsonProperty("parameters")
     public void setParameters(Map<String, String> parameters) {
         this.parameters = parameters;
     }
 
+    /**
+     * provisioner indicates the type of the provisioner.
+     */
     @JsonProperty("provisioner")
     public String getProvisioner() {
         return provisioner;
     }
 
+    /**
+     * provisioner indicates the type of the provisioner.
+     */
     @JsonProperty("provisioner")
     public void setProvisioner(String provisioner) {
         this.provisioner = provisioner;
     }
 
+    /**
+     * reclaimPolicy controls the reclaimPolicy for dynamically provisioned PersistentVolumes of this storage class. Defaults to Delete.
+     */
     @JsonProperty("reclaimPolicy")
     public String getReclaimPolicy() {
         return reclaimPolicy;
     }
 
+    /**
+     * reclaimPolicy controls the reclaimPolicy for dynamically provisioned PersistentVolumes of this storage class. Defaults to Delete.
+     */
     @JsonProperty("reclaimPolicy")
     public void setReclaimPolicy(String reclaimPolicy) {
         this.reclaimPolicy = reclaimPolicy;
     }
 
+    /**
+     * volumeBindingMode indicates how PersistentVolumeClaims should be provisioned and bound.  When unset, VolumeBindingImmediate is used. This field is only honored by servers that enable the VolumeScheduling feature.
+     */
     @JsonProperty("volumeBindingMode")
     public String getVolumeBindingMode() {
         return volumeBindingMode;
     }
 
+    /**
+     * volumeBindingMode indicates how PersistentVolumeClaims should be provisioned and bound.  When unset, VolumeBindingImmediate is used. This field is only honored by servers that enable the VolumeScheduling feature.
+     */
     @JsonProperty("volumeBindingMode")
     public void setVolumeBindingMode(String volumeBindingMode) {
         this.volumeBindingMode = volumeBindingMode;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/StorageClassList.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/StorageClassList.java
index a1553d7a4df..910530512dd 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/StorageClassList.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/StorageClassList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StorageClassList is a collection of storage classes.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class StorageClassList implements Editable<StorageClassListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.storage.StorageClass>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storage.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.storage.StorageClass> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "StorageClassList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public StorageClassList(String apiVersion, List<io.fabric8.kubernetes.api.model.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of StorageClasses
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.storage.StorageClass> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of StorageClasses
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.storage.StorageClass> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * StorageClassList is a collection of storage classes.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * StorageClassList is a collection of storage classes.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/TokenRequest.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/TokenRequest.java
index abd70ce2ad6..a219a6096f6 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/TokenRequest.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/TokenRequest.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TokenRequest contains parameters of a service account token.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public TokenRequest(String audience, Long expirationSeconds) {
         this.expirationSeconds = expirationSeconds;
     }
 
+    /**
+     * audience is the intended audience of the token in "TokenRequestSpec". It will default to the audiences of kube apiserver.
+     */
     @JsonProperty("audience")
     public String getAudience() {
         return audience;
     }
 
+    /**
+     * audience is the intended audience of the token in "TokenRequestSpec". It will default to the audiences of kube apiserver.
+     */
     @JsonProperty("audience")
     public void setAudience(String audience) {
         this.audience = audience;
     }
 
+    /**
+     * expirationSeconds is the duration of validity of the token in "TokenRequestSpec". It has the same default value of "ExpirationSeconds" in "TokenRequestSpec".
+     */
     @JsonProperty("expirationSeconds")
     public Long getExpirationSeconds() {
         return expirationSeconds;
     }
 
+    /**
+     * expirationSeconds is the duration of validity of the token in "TokenRequestSpec". It has the same default value of "ExpirationSeconds" in "TokenRequestSpec".
+     */
     @JsonProperty("expirationSeconds")
     public void setExpirationSeconds(Long expirationSeconds) {
         this.expirationSeconds = expirationSeconds;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/VolumeAttachment.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/VolumeAttachment.java
index e8f3e68fcd8..fc24588f751 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/VolumeAttachment.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/VolumeAttachment.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeAttachment captures the intent to attach or detach the specified volume to/from the specified node.<br><p> <br><p> VolumeAttachment objects are non-namespaced.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class VolumeAttachment implements Editable<VolumeAttachmentBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storage.k8s.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VolumeAttachment";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public VolumeAttachment(String apiVersion, String kind, ObjectMeta metadata, Vol
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VolumeAttachment captures the intent to attach or detach the specified volume to/from the specified node.<br><p> <br><p> VolumeAttachment objects are non-namespaced.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VolumeAttachment captures the intent to attach or detach the specified volume to/from the specified node.<br><p> <br><p> VolumeAttachment objects are non-namespaced.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * VolumeAttachment captures the intent to attach or detach the specified volume to/from the specified node.<br><p> <br><p> VolumeAttachment objects are non-namespaced.
+     */
     @JsonProperty("spec")
     public VolumeAttachmentSpec getSpec() {
         return spec;
     }
 
+    /**
+     * VolumeAttachment captures the intent to attach or detach the specified volume to/from the specified node.<br><p> <br><p> VolumeAttachment objects are non-namespaced.
+     */
     @JsonProperty("spec")
     public void setSpec(VolumeAttachmentSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * VolumeAttachment captures the intent to attach or detach the specified volume to/from the specified node.<br><p> <br><p> VolumeAttachment objects are non-namespaced.
+     */
     @JsonProperty("status")
     public VolumeAttachmentStatus getStatus() {
         return status;
     }
 
+    /**
+     * VolumeAttachment captures the intent to attach or detach the specified volume to/from the specified node.<br><p> <br><p> VolumeAttachment objects are non-namespaced.
+     */
     @JsonProperty("status")
     public void setStatus(VolumeAttachmentStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/VolumeAttachmentList.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/VolumeAttachmentList.java
index c51a44e1e83..f7dc49cdb74 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/VolumeAttachmentList.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/VolumeAttachmentList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeAttachmentList is a collection of VolumeAttachment objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class VolumeAttachmentList implements Editable<VolumeAttachmentListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.storage.VolumeAttachment>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storage.k8s.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.storage.VolumeAttachment> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VolumeAttachmentList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public VolumeAttachmentList(String apiVersion, List<io.fabric8.kubernetes.api.mo
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of VolumeAttachments
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.storage.VolumeAttachment> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of VolumeAttachments
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.storage.VolumeAttachment> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VolumeAttachmentList is a collection of VolumeAttachment objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VolumeAttachmentList is a collection of VolumeAttachment objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/VolumeAttachmentSource.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/VolumeAttachmentSource.java
index f25e7e35b80..4cb623d8ca8 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/VolumeAttachmentSource.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/VolumeAttachmentSource.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeAttachmentSource represents a volume that should be attached. Right now only PersistentVolumes can be attached via external attacher, in the future we may allow also inline volumes in pods. Exactly one member can be set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public VolumeAttachmentSource(PersistentVolumeSpec inlineVolumeSpec, String pers
         this.persistentVolumeName = persistentVolumeName;
     }
 
+    /**
+     * VolumeAttachmentSource represents a volume that should be attached. Right now only PersistentVolumes can be attached via external attacher, in the future we may allow also inline volumes in pods. Exactly one member can be set.
+     */
     @JsonProperty("inlineVolumeSpec")
     public PersistentVolumeSpec getInlineVolumeSpec() {
         return inlineVolumeSpec;
     }
 
+    /**
+     * VolumeAttachmentSource represents a volume that should be attached. Right now only PersistentVolumes can be attached via external attacher, in the future we may allow also inline volumes in pods. Exactly one member can be set.
+     */
     @JsonProperty("inlineVolumeSpec")
     public void setInlineVolumeSpec(PersistentVolumeSpec inlineVolumeSpec) {
         this.inlineVolumeSpec = inlineVolumeSpec;
     }
 
+    /**
+     * persistentVolumeName represents the name of the persistent volume to attach.
+     */
     @JsonProperty("persistentVolumeName")
     public String getPersistentVolumeName() {
         return persistentVolumeName;
     }
 
+    /**
+     * persistentVolumeName represents the name of the persistent volume to attach.
+     */
     @JsonProperty("persistentVolumeName")
     public void setPersistentVolumeName(String persistentVolumeName) {
         this.persistentVolumeName = persistentVolumeName;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/VolumeAttachmentSpec.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/VolumeAttachmentSpec.java
index ad6257365c8..eede51a9c54 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/VolumeAttachmentSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/VolumeAttachmentSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeAttachmentSpec is the specification of a VolumeAttachment request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public VolumeAttachmentSpec(String attacher, String nodeName, VolumeAttachmentSo
         this.source = source;
     }
 
+    /**
+     * attacher indicates the name of the volume driver that MUST handle this request. This is the name returned by GetPluginName().
+     */
     @JsonProperty("attacher")
     public String getAttacher() {
         return attacher;
     }
 
+    /**
+     * attacher indicates the name of the volume driver that MUST handle this request. This is the name returned by GetPluginName().
+     */
     @JsonProperty("attacher")
     public void setAttacher(String attacher) {
         this.attacher = attacher;
     }
 
+    /**
+     * nodeName represents the node that the volume should be attached to.
+     */
     @JsonProperty("nodeName")
     public String getNodeName() {
         return nodeName;
     }
 
+    /**
+     * nodeName represents the node that the volume should be attached to.
+     */
     @JsonProperty("nodeName")
     public void setNodeName(String nodeName) {
         this.nodeName = nodeName;
     }
 
+    /**
+     * VolumeAttachmentSpec is the specification of a VolumeAttachment request.
+     */
     @JsonProperty("source")
     public VolumeAttachmentSource getSource() {
         return source;
     }
 
+    /**
+     * VolumeAttachmentSpec is the specification of a VolumeAttachment request.
+     */
     @JsonProperty("source")
     public void setSource(VolumeAttachmentSource source) {
         this.source = source;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/VolumeAttachmentStatus.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/VolumeAttachmentStatus.java
index d74dbd99f20..898e7b0ccb8 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/VolumeAttachmentStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/VolumeAttachmentStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeAttachmentStatus is the status of a VolumeAttachment request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,42 +94,66 @@ public VolumeAttachmentStatus(VolumeError attachError, Boolean attached, Map<Str
         this.detachError = detachError;
     }
 
+    /**
+     * VolumeAttachmentStatus is the status of a VolumeAttachment request.
+     */
     @JsonProperty("attachError")
     public VolumeError getAttachError() {
         return attachError;
     }
 
+    /**
+     * VolumeAttachmentStatus is the status of a VolumeAttachment request.
+     */
     @JsonProperty("attachError")
     public void setAttachError(VolumeError attachError) {
         this.attachError = attachError;
     }
 
+    /**
+     * attached indicates the volume is successfully attached. This field must only be set by the entity completing the attach operation, i.e. the external-attacher.
+     */
     @JsonProperty("attached")
     public Boolean getAttached() {
         return attached;
     }
 
+    /**
+     * attached indicates the volume is successfully attached. This field must only be set by the entity completing the attach operation, i.e. the external-attacher.
+     */
     @JsonProperty("attached")
     public void setAttached(Boolean attached) {
         this.attached = attached;
     }
 
+    /**
+     * attachmentMetadata is populated with any information returned by the attach operation, upon successful attach, that must be passed into subsequent WaitForAttach or Mount calls. This field must only be set by the entity completing the attach operation, i.e. the external-attacher.
+     */
     @JsonProperty("attachmentMetadata")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAttachmentMetadata() {
         return attachmentMetadata;
     }
 
+    /**
+     * attachmentMetadata is populated with any information returned by the attach operation, upon successful attach, that must be passed into subsequent WaitForAttach or Mount calls. This field must only be set by the entity completing the attach operation, i.e. the external-attacher.
+     */
     @JsonProperty("attachmentMetadata")
     public void setAttachmentMetadata(Map<String, String> attachmentMetadata) {
         this.attachmentMetadata = attachmentMetadata;
     }
 
+    /**
+     * VolumeAttachmentStatus is the status of a VolumeAttachment request.
+     */
     @JsonProperty("detachError")
     public VolumeError getDetachError() {
         return detachError;
     }
 
+    /**
+     * VolumeAttachmentStatus is the status of a VolumeAttachment request.
+     */
     @JsonProperty("detachError")
     public void setDetachError(VolumeError detachError) {
         this.detachError = detachError;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/VolumeError.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/VolumeError.java
index f5602c9b41b..e4afa54fc53 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/VolumeError.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/VolumeError.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeError captures an error encountered during a volume operation.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public VolumeError(String message, String time) {
         this.time = time;
     }
 
+    /**
+     * message represents the error encountered during Attach or Detach operation. This string may be logged, so it should not contain sensitive information.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message represents the error encountered during Attach or Detach operation. This string may be logged, so it should not contain sensitive information.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * VolumeError captures an error encountered during a volume operation.
+     */
     @JsonProperty("time")
     public String getTime() {
         return time;
     }
 
+    /**
+     * VolumeError captures an error encountered during a volume operation.
+     */
     @JsonProperty("time")
     public void setTime(String time) {
         this.time = time;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/VolumeNodeResources.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/VolumeNodeResources.java
index dafbba268c5..6d92df6961b 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/VolumeNodeResources.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/VolumeNodeResources.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeNodeResources is a set of resource limits for scheduling of volumes.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public VolumeNodeResources(Integer count) {
         this.count = count;
     }
 
+    /**
+     * count indicates the maximum number of unique volumes managed by the CSI driver that can be used on a node. A volume that is both attached and mounted on a node is considered to be used once, not twice. The same rule applies for a unique volume that is shared among multiple pods on the same node. If this field is not specified, then the supported number of volumes on this node is unbounded.
+     */
     @JsonProperty("count")
     public Integer getCount() {
         return count;
     }
 
+    /**
+     * count indicates the maximum number of unique volumes managed by the CSI driver that can be used on a node. A volume that is both attached and mounted on a node is considered to be used once, not twice. The same rule applies for a unique volume that is shared among multiple pods on the same node. If this field is not specified, then the supported number of volumes on this node is unbounded.
+     */
     @JsonProperty("count")
     public void setCount(Integer count) {
         this.count = count;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/CSIStorageCapacity.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/CSIStorageCapacity.java
index eda9d49b98f..f3ec8361e99 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/CSIStorageCapacity.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/CSIStorageCapacity.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CSIStorageCapacity stores the result of one CSI GetCapacity call. For a given StorageClass, this describes the available capacity in a particular topology segment.  This can be used when considering where to instantiate new PersistentVolumes.<br><p> <br><p> For example this can express things like: - StorageClass "standard" has "1234 GiB" available in "topology.kubernetes.io/zone=us-east1" - StorageClass "localssd" has "10 GiB" available in "kubernetes.io/hostname=knode-abc123"<br><p> <br><p> The following three cases all imply that no capacity is available for a certain combination: - no object exists with suitable topology and storage class name - such an object exists, but the capacity is unset - such an object exists, but the capacity is zero<br><p> <br><p> The producer of these objects can decide which approach is more suitable.<br><p> <br><p> They are consumed by the kube-scheduler if the CSIStorageCapacity beta feature gate is enabled there and a CSI driver opts into capacity-aware scheduling with CSIDriver.StorageCapacity.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,16 +82,10 @@
 public class CSIStorageCapacity implements Editable<CSIStorageCapacityBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storage.k8s.io/v1alpha1";
     @JsonProperty("capacity")
     private Quantity capacity;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CSIStorageCapacity";
     @JsonProperty("maximumVolumeSize")
@@ -120,7 +117,7 @@ public CSIStorageCapacity(String apiVersion, Quantity capacity, String kind, Qua
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -128,25 +125,31 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * CSIStorageCapacity stores the result of one CSI GetCapacity call. For a given StorageClass, this describes the available capacity in a particular topology segment.  This can be used when considering where to instantiate new PersistentVolumes.<br><p> <br><p> For example this can express things like: - StorageClass "standard" has "1234 GiB" available in "topology.kubernetes.io/zone=us-east1" - StorageClass "localssd" has "10 GiB" available in "kubernetes.io/hostname=knode-abc123"<br><p> <br><p> The following three cases all imply that no capacity is available for a certain combination: - no object exists with suitable topology and storage class name - such an object exists, but the capacity is unset - such an object exists, but the capacity is zero<br><p> <br><p> The producer of these objects can decide which approach is more suitable.<br><p> <br><p> They are consumed by the kube-scheduler if the CSIStorageCapacity beta feature gate is enabled there and a CSI driver opts into capacity-aware scheduling with CSIDriver.StorageCapacity.
+     */
     @JsonProperty("capacity")
     public Quantity getCapacity() {
         return capacity;
     }
 
+    /**
+     * CSIStorageCapacity stores the result of one CSI GetCapacity call. For a given StorageClass, this describes the available capacity in a particular topology segment.  This can be used when considering where to instantiate new PersistentVolumes.<br><p> <br><p> For example this can express things like: - StorageClass "standard" has "1234 GiB" available in "topology.kubernetes.io/zone=us-east1" - StorageClass "localssd" has "10 GiB" available in "kubernetes.io/hostname=knode-abc123"<br><p> <br><p> The following three cases all imply that no capacity is available for a certain combination: - no object exists with suitable topology and storage class name - such an object exists, but the capacity is unset - such an object exists, but the capacity is zero<br><p> <br><p> The producer of these objects can decide which approach is more suitable.<br><p> <br><p> They are consumed by the kube-scheduler if the CSIStorageCapacity beta feature gate is enabled there and a CSI driver opts into capacity-aware scheduling with CSIDriver.StorageCapacity.
+     */
     @JsonProperty("capacity")
     public void setCapacity(Quantity capacity) {
         this.capacity = capacity;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -154,48 +157,72 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CSIStorageCapacity stores the result of one CSI GetCapacity call. For a given StorageClass, this describes the available capacity in a particular topology segment.  This can be used when considering where to instantiate new PersistentVolumes.<br><p> <br><p> For example this can express things like: - StorageClass "standard" has "1234 GiB" available in "topology.kubernetes.io/zone=us-east1" - StorageClass "localssd" has "10 GiB" available in "kubernetes.io/hostname=knode-abc123"<br><p> <br><p> The following three cases all imply that no capacity is available for a certain combination: - no object exists with suitable topology and storage class name - such an object exists, but the capacity is unset - such an object exists, but the capacity is zero<br><p> <br><p> The producer of these objects can decide which approach is more suitable.<br><p> <br><p> They are consumed by the kube-scheduler if the CSIStorageCapacity beta feature gate is enabled there and a CSI driver opts into capacity-aware scheduling with CSIDriver.StorageCapacity.
+     */
     @JsonProperty("maximumVolumeSize")
     public Quantity getMaximumVolumeSize() {
         return maximumVolumeSize;
     }
 
+    /**
+     * CSIStorageCapacity stores the result of one CSI GetCapacity call. For a given StorageClass, this describes the available capacity in a particular topology segment.  This can be used when considering where to instantiate new PersistentVolumes.<br><p> <br><p> For example this can express things like: - StorageClass "standard" has "1234 GiB" available in "topology.kubernetes.io/zone=us-east1" - StorageClass "localssd" has "10 GiB" available in "kubernetes.io/hostname=knode-abc123"<br><p> <br><p> The following three cases all imply that no capacity is available for a certain combination: - no object exists with suitable topology and storage class name - such an object exists, but the capacity is unset - such an object exists, but the capacity is zero<br><p> <br><p> The producer of these objects can decide which approach is more suitable.<br><p> <br><p> They are consumed by the kube-scheduler if the CSIStorageCapacity beta feature gate is enabled there and a CSI driver opts into capacity-aware scheduling with CSIDriver.StorageCapacity.
+     */
     @JsonProperty("maximumVolumeSize")
     public void setMaximumVolumeSize(Quantity maximumVolumeSize) {
         this.maximumVolumeSize = maximumVolumeSize;
     }
 
+    /**
+     * CSIStorageCapacity stores the result of one CSI GetCapacity call. For a given StorageClass, this describes the available capacity in a particular topology segment.  This can be used when considering where to instantiate new PersistentVolumes.<br><p> <br><p> For example this can express things like: - StorageClass "standard" has "1234 GiB" available in "topology.kubernetes.io/zone=us-east1" - StorageClass "localssd" has "10 GiB" available in "kubernetes.io/hostname=knode-abc123"<br><p> <br><p> The following three cases all imply that no capacity is available for a certain combination: - no object exists with suitable topology and storage class name - such an object exists, but the capacity is unset - such an object exists, but the capacity is zero<br><p> <br><p> The producer of these objects can decide which approach is more suitable.<br><p> <br><p> They are consumed by the kube-scheduler if the CSIStorageCapacity beta feature gate is enabled there and a CSI driver opts into capacity-aware scheduling with CSIDriver.StorageCapacity.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CSIStorageCapacity stores the result of one CSI GetCapacity call. For a given StorageClass, this describes the available capacity in a particular topology segment.  This can be used when considering where to instantiate new PersistentVolumes.<br><p> <br><p> For example this can express things like: - StorageClass "standard" has "1234 GiB" available in "topology.kubernetes.io/zone=us-east1" - StorageClass "localssd" has "10 GiB" available in "kubernetes.io/hostname=knode-abc123"<br><p> <br><p> The following three cases all imply that no capacity is available for a certain combination: - no object exists with suitable topology and storage class name - such an object exists, but the capacity is unset - such an object exists, but the capacity is zero<br><p> <br><p> The producer of these objects can decide which approach is more suitable.<br><p> <br><p> They are consumed by the kube-scheduler if the CSIStorageCapacity beta feature gate is enabled there and a CSI driver opts into capacity-aware scheduling with CSIDriver.StorageCapacity.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * CSIStorageCapacity stores the result of one CSI GetCapacity call. For a given StorageClass, this describes the available capacity in a particular topology segment.  This can be used when considering where to instantiate new PersistentVolumes.<br><p> <br><p> For example this can express things like: - StorageClass "standard" has "1234 GiB" available in "topology.kubernetes.io/zone=us-east1" - StorageClass "localssd" has "10 GiB" available in "kubernetes.io/hostname=knode-abc123"<br><p> <br><p> The following three cases all imply that no capacity is available for a certain combination: - no object exists with suitable topology and storage class name - such an object exists, but the capacity is unset - such an object exists, but the capacity is zero<br><p> <br><p> The producer of these objects can decide which approach is more suitable.<br><p> <br><p> They are consumed by the kube-scheduler if the CSIStorageCapacity beta feature gate is enabled there and a CSI driver opts into capacity-aware scheduling with CSIDriver.StorageCapacity.
+     */
     @JsonProperty("nodeTopology")
     public LabelSelector getNodeTopology() {
         return nodeTopology;
     }
 
+    /**
+     * CSIStorageCapacity stores the result of one CSI GetCapacity call. For a given StorageClass, this describes the available capacity in a particular topology segment.  This can be used when considering where to instantiate new PersistentVolumes.<br><p> <br><p> For example this can express things like: - StorageClass "standard" has "1234 GiB" available in "topology.kubernetes.io/zone=us-east1" - StorageClass "localssd" has "10 GiB" available in "kubernetes.io/hostname=knode-abc123"<br><p> <br><p> The following three cases all imply that no capacity is available for a certain combination: - no object exists with suitable topology and storage class name - such an object exists, but the capacity is unset - such an object exists, but the capacity is zero<br><p> <br><p> The producer of these objects can decide which approach is more suitable.<br><p> <br><p> They are consumed by the kube-scheduler if the CSIStorageCapacity beta feature gate is enabled there and a CSI driver opts into capacity-aware scheduling with CSIDriver.StorageCapacity.
+     */
     @JsonProperty("nodeTopology")
     public void setNodeTopology(LabelSelector nodeTopology) {
         this.nodeTopology = nodeTopology;
     }
 
+    /**
+     * The name of the StorageClass that the reported capacity applies to. It must meet the same requirements as the name of a StorageClass object (non-empty, DNS subdomain). If that object no longer exists, the CSIStorageCapacity object is obsolete and should be removed by its creator. This field is immutable.
+     */
     @JsonProperty("storageClassName")
     public String getStorageClassName() {
         return storageClassName;
     }
 
+    /**
+     * The name of the StorageClass that the reported capacity applies to. It must meet the same requirements as the name of a StorageClass object (non-empty, DNS subdomain). If that object no longer exists, the CSIStorageCapacity object is obsolete and should be removed by its creator. This field is immutable.
+     */
     @JsonProperty("storageClassName")
     public void setStorageClassName(String storageClassName) {
         this.storageClassName = storageClassName;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/CSIStorageCapacityList.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/CSIStorageCapacityList.java
index cbe5cc5a2b3..5f16fa2e8cf 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/CSIStorageCapacityList.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/CSIStorageCapacityList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CSIStorageCapacityList is a collection of CSIStorageCapacity objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class CSIStorageCapacityList implements Editable<CSIStorageCapacityListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.storage.v1alpha1.CSIStorageCapacity>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storage.k8s.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.storage.v1alpha1.CSIStorageCapacity> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CSIStorageCapacityList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CSIStorageCapacityList(String apiVersion, List<io.fabric8.kubernetes.api.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of CSIStorageCapacity objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.storage.v1alpha1.CSIStorageCapacity> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of CSIStorageCapacity objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.storage.v1alpha1.CSIStorageCapacity> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CSIStorageCapacityList is a collection of CSIStorageCapacity objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CSIStorageCapacityList is a collection of CSIStorageCapacity objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeAttachment.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeAttachment.java
index 12e7479b2c1..15b53e0521a 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeAttachment.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeAttachment.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeAttachment captures the intent to attach or detach the specified volume to/from the specified node.<br><p> <br><p> VolumeAttachment objects are non-namespaced.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class VolumeAttachment implements Editable<VolumeAttachmentBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storage.k8s.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VolumeAttachment";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public VolumeAttachment(String apiVersion, String kind, ObjectMeta metadata, Vol
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VolumeAttachment captures the intent to attach or detach the specified volume to/from the specified node.<br><p> <br><p> VolumeAttachment objects are non-namespaced.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VolumeAttachment captures the intent to attach or detach the specified volume to/from the specified node.<br><p> <br><p> VolumeAttachment objects are non-namespaced.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * VolumeAttachment captures the intent to attach or detach the specified volume to/from the specified node.<br><p> <br><p> VolumeAttachment objects are non-namespaced.
+     */
     @JsonProperty("spec")
     public VolumeAttachmentSpec getSpec() {
         return spec;
     }
 
+    /**
+     * VolumeAttachment captures the intent to attach or detach the specified volume to/from the specified node.<br><p> <br><p> VolumeAttachment objects are non-namespaced.
+     */
     @JsonProperty("spec")
     public void setSpec(VolumeAttachmentSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * VolumeAttachment captures the intent to attach or detach the specified volume to/from the specified node.<br><p> <br><p> VolumeAttachment objects are non-namespaced.
+     */
     @JsonProperty("status")
     public VolumeAttachmentStatus getStatus() {
         return status;
     }
 
+    /**
+     * VolumeAttachment captures the intent to attach or detach the specified volume to/from the specified node.<br><p> <br><p> VolumeAttachment objects are non-namespaced.
+     */
     @JsonProperty("status")
     public void setStatus(VolumeAttachmentStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeAttachmentList.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeAttachmentList.java
index 1e9824dd063..eac7e26b196 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeAttachmentList.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeAttachmentList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeAttachmentList is a collection of VolumeAttachment objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class VolumeAttachmentList implements Editable<VolumeAttachmentListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.storage.v1alpha1.VolumeAttachment>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storage.k8s.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.storage.v1alpha1.VolumeAttachment> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VolumeAttachmentList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public VolumeAttachmentList(String apiVersion, List<io.fabric8.kubernetes.api.mo
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of VolumeAttachments
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.storage.v1alpha1.VolumeAttachment> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of VolumeAttachments
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.storage.v1alpha1.VolumeAttachment> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VolumeAttachmentList is a collection of VolumeAttachment objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VolumeAttachmentList is a collection of VolumeAttachment objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeAttachmentSource.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeAttachmentSource.java
index 5514eaa7b9d..d4a7ed13c2f 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeAttachmentSource.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeAttachmentSource.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeAttachmentSource represents a volume that should be attached. Right now only PersistenVolumes can be attached via external attacher, in future we may allow also inline volumes in pods. Exactly one member can be set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public VolumeAttachmentSource(PersistentVolumeSpec inlineVolumeSpec, String pers
         this.persistentVolumeName = persistentVolumeName;
     }
 
+    /**
+     * VolumeAttachmentSource represents a volume that should be attached. Right now only PersistenVolumes can be attached via external attacher, in future we may allow also inline volumes in pods. Exactly one member can be set.
+     */
     @JsonProperty("inlineVolumeSpec")
     public PersistentVolumeSpec getInlineVolumeSpec() {
         return inlineVolumeSpec;
     }
 
+    /**
+     * VolumeAttachmentSource represents a volume that should be attached. Right now only PersistenVolumes can be attached via external attacher, in future we may allow also inline volumes in pods. Exactly one member can be set.
+     */
     @JsonProperty("inlineVolumeSpec")
     public void setInlineVolumeSpec(PersistentVolumeSpec inlineVolumeSpec) {
         this.inlineVolumeSpec = inlineVolumeSpec;
     }
 
+    /**
+     * Name of the persistent volume to attach.
+     */
     @JsonProperty("persistentVolumeName")
     public String getPersistentVolumeName() {
         return persistentVolumeName;
     }
 
+    /**
+     * Name of the persistent volume to attach.
+     */
     @JsonProperty("persistentVolumeName")
     public void setPersistentVolumeName(String persistentVolumeName) {
         this.persistentVolumeName = persistentVolumeName;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeAttachmentSpec.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeAttachmentSpec.java
index 94343f4461e..7e0ccf167bc 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeAttachmentSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeAttachmentSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeAttachmentSpec is the specification of a VolumeAttachment request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public VolumeAttachmentSpec(String attacher, String nodeName, VolumeAttachmentSo
         this.source = source;
     }
 
+    /**
+     * Attacher indicates the name of the volume driver that MUST handle this request. This is the name returned by GetPluginName().
+     */
     @JsonProperty("attacher")
     public String getAttacher() {
         return attacher;
     }
 
+    /**
+     * Attacher indicates the name of the volume driver that MUST handle this request. This is the name returned by GetPluginName().
+     */
     @JsonProperty("attacher")
     public void setAttacher(String attacher) {
         this.attacher = attacher;
     }
 
+    /**
+     * The node that the volume should be attached to.
+     */
     @JsonProperty("nodeName")
     public String getNodeName() {
         return nodeName;
     }
 
+    /**
+     * The node that the volume should be attached to.
+     */
     @JsonProperty("nodeName")
     public void setNodeName(String nodeName) {
         this.nodeName = nodeName;
     }
 
+    /**
+     * VolumeAttachmentSpec is the specification of a VolumeAttachment request.
+     */
     @JsonProperty("source")
     public VolumeAttachmentSource getSource() {
         return source;
     }
 
+    /**
+     * VolumeAttachmentSpec is the specification of a VolumeAttachment request.
+     */
     @JsonProperty("source")
     public void setSource(VolumeAttachmentSource source) {
         this.source = source;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeAttachmentStatus.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeAttachmentStatus.java
index a335af86209..a6681b6ec2c 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeAttachmentStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeAttachmentStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeAttachmentStatus is the status of a VolumeAttachment request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,42 +94,66 @@ public VolumeAttachmentStatus(VolumeError attachError, Boolean attached, Map<Str
         this.detachError = detachError;
     }
 
+    /**
+     * VolumeAttachmentStatus is the status of a VolumeAttachment request.
+     */
     @JsonProperty("attachError")
     public VolumeError getAttachError() {
         return attachError;
     }
 
+    /**
+     * VolumeAttachmentStatus is the status of a VolumeAttachment request.
+     */
     @JsonProperty("attachError")
     public void setAttachError(VolumeError attachError) {
         this.attachError = attachError;
     }
 
+    /**
+     * Indicates the volume is successfully attached. This field must only be set by the entity completing the attach operation, i.e. the external-attacher.
+     */
     @JsonProperty("attached")
     public Boolean getAttached() {
         return attached;
     }
 
+    /**
+     * Indicates the volume is successfully attached. This field must only be set by the entity completing the attach operation, i.e. the external-attacher.
+     */
     @JsonProperty("attached")
     public void setAttached(Boolean attached) {
         this.attached = attached;
     }
 
+    /**
+     * Upon successful attach, this field is populated with any information returned by the attach operation that must be passed into subsequent WaitForAttach or Mount calls. This field must only be set by the entity completing the attach operation, i.e. the external-attacher.
+     */
     @JsonProperty("attachmentMetadata")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAttachmentMetadata() {
         return attachmentMetadata;
     }
 
+    /**
+     * Upon successful attach, this field is populated with any information returned by the attach operation that must be passed into subsequent WaitForAttach or Mount calls. This field must only be set by the entity completing the attach operation, i.e. the external-attacher.
+     */
     @JsonProperty("attachmentMetadata")
     public void setAttachmentMetadata(Map<String, String> attachmentMetadata) {
         this.attachmentMetadata = attachmentMetadata;
     }
 
+    /**
+     * VolumeAttachmentStatus is the status of a VolumeAttachment request.
+     */
     @JsonProperty("detachError")
     public VolumeError getDetachError() {
         return detachError;
     }
 
+    /**
+     * VolumeAttachmentStatus is the status of a VolumeAttachment request.
+     */
     @JsonProperty("detachError")
     public void setDetachError(VolumeError detachError) {
         this.detachError = detachError;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeAttributesClass.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeAttributesClass.java
index d51882600a9..8958294ba9d 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeAttributesClass.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeAttributesClass.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeAttributesClass represents a specification of mutable volume attributes defined by the CSI driver. The class can be specified during dynamic provisioning of PersistentVolumeClaims, and changed in the PersistentVolumeClaim spec after provisioning.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,16 +78,10 @@
 public class VolumeAttributesClass implements Editable<VolumeAttributesClassBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storage.k8s.io/v1alpha1";
     @JsonProperty("driverName")
     private String driverName;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VolumeAttributesClass";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public VolumeAttributesClass(String apiVersion, String driverName, String kind,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,25 +116,31 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Name of the CSI driver This field is immutable.
+     */
     @JsonProperty("driverName")
     public String getDriverName() {
         return driverName;
     }
 
+    /**
+     * Name of the CSI driver This field is immutable.
+     */
     @JsonProperty("driverName")
     public void setDriverName(String driverName) {
         this.driverName = driverName;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -145,29 +148,41 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VolumeAttributesClass represents a specification of mutable volume attributes defined by the CSI driver. The class can be specified during dynamic provisioning of PersistentVolumeClaims, and changed in the PersistentVolumeClaim spec after provisioning.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VolumeAttributesClass represents a specification of mutable volume attributes defined by the CSI driver. The class can be specified during dynamic provisioning of PersistentVolumeClaims, and changed in the PersistentVolumeClaim spec after provisioning.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * parameters hold volume attributes defined by the CSI driver. These values are opaque to the Kubernetes and are passed directly to the CSI driver. The underlying storage provider supports changing these attributes on an existing volume, however the parameters field itself is immutable. To invoke a volume update, a new VolumeAttributesClass should be created with new parameters, and the PersistentVolumeClaim should be updated to reference the new VolumeAttributesClass.<br><p> <br><p> This field is required and must contain at least one key/value pair. The keys cannot be empty, and the maximum number of parameters is 512, with a cumulative max size of 256K. If the CSI driver rejects invalid parameters, the target PersistentVolumeClaim will be set to an "Infeasible" state in the modifyVolumeStatus field.
+     */
     @JsonProperty("parameters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getParameters() {
         return parameters;
     }
 
+    /**
+     * parameters hold volume attributes defined by the CSI driver. These values are opaque to the Kubernetes and are passed directly to the CSI driver. The underlying storage provider supports changing these attributes on an existing volume, however the parameters field itself is immutable. To invoke a volume update, a new VolumeAttributesClass should be created with new parameters, and the PersistentVolumeClaim should be updated to reference the new VolumeAttributesClass.<br><p> <br><p> This field is required and must contain at least one key/value pair. The keys cannot be empty, and the maximum number of parameters is 512, with a cumulative max size of 256K. If the CSI driver rejects invalid parameters, the target PersistentVolumeClaim will be set to an "Infeasible" state in the modifyVolumeStatus field.
+     */
     @JsonProperty("parameters")
     public void setParameters(Map<String, String> parameters) {
         this.parameters = parameters;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeAttributesClassList.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeAttributesClassList.java
index dda7853dc3c..3093e200446 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeAttributesClassList.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeAttributesClassList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeAttributesClassList is a collection of VolumeAttributesClass objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class VolumeAttributesClassList implements Editable<VolumeAttributesClassListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.storage.v1alpha1.VolumeAttributesClass>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storage.k8s.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.storage.v1alpha1.VolumeAttributesClass> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VolumeAttributesClassList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public VolumeAttributesClassList(String apiVersion, List<io.fabric8.kubernetes.a
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of VolumeAttributesClass objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.storage.v1alpha1.VolumeAttributesClass> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of VolumeAttributesClass objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.storage.v1alpha1.VolumeAttributesClass> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VolumeAttributesClassList is a collection of VolumeAttributesClass objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VolumeAttributesClassList is a collection of VolumeAttributesClass objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeError.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeError.java
index 420600a5b96..5ba59018f18 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeError.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1alpha1/VolumeError.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeError captures an error encountered during a volume operation.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public VolumeError(String message, String time) {
         this.time = time;
     }
 
+    /**
+     * String detailing the error encountered during Attach or Detach operation. This string maybe logged, so it should not contain sensitive information.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * String detailing the error encountered during Attach or Detach operation. This string maybe logged, so it should not contain sensitive information.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * VolumeError captures an error encountered during a volume operation.
+     */
     @JsonProperty("time")
     public String getTime() {
         return time;
     }
 
+    /**
+     * VolumeError captures an error encountered during a volume operation.
+     */
     @JsonProperty("time")
     public void setTime(String time) {
         this.time = time;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSIDriver.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSIDriver.java
index 68cc27ff314..36b0e3edbc7 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSIDriver.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSIDriver.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CSIDriver captures information about a Container Storage Interface (CSI) volume driver deployed on the cluster. CSI drivers do not need to create the CSIDriver object directly. Instead they may use the cluster-driver-registrar sidecar container. When deployed with a CSI driver it automatically creates a CSIDriver object representing the driver. Kubernetes attach detach controller uses this object to determine whether attach is required. Kubelet uses this object to determine whether pod information needs to be passed on mount. CSIDriver objects are non-namespaced.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class CSIDriver implements Editable<CSIDriverBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storage.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CSIDriver";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public CSIDriver(String apiVersion, String kind, ObjectMeta metadata, CSIDriverS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CSIDriver captures information about a Container Storage Interface (CSI) volume driver deployed on the cluster. CSI drivers do not need to create the CSIDriver object directly. Instead they may use the cluster-driver-registrar sidecar container. When deployed with a CSI driver it automatically creates a CSIDriver object representing the driver. Kubernetes attach detach controller uses this object to determine whether attach is required. Kubelet uses this object to determine whether pod information needs to be passed on mount. CSIDriver objects are non-namespaced.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CSIDriver captures information about a Container Storage Interface (CSI) volume driver deployed on the cluster. CSI drivers do not need to create the CSIDriver object directly. Instead they may use the cluster-driver-registrar sidecar container. When deployed with a CSI driver it automatically creates a CSIDriver object representing the driver. Kubernetes attach detach controller uses this object to determine whether attach is required. Kubelet uses this object to determine whether pod information needs to be passed on mount. CSIDriver objects are non-namespaced.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * CSIDriver captures information about a Container Storage Interface (CSI) volume driver deployed on the cluster. CSI drivers do not need to create the CSIDriver object directly. Instead they may use the cluster-driver-registrar sidecar container. When deployed with a CSI driver it automatically creates a CSIDriver object representing the driver. Kubernetes attach detach controller uses this object to determine whether attach is required. Kubelet uses this object to determine whether pod information needs to be passed on mount. CSIDriver objects are non-namespaced.
+     */
     @JsonProperty("spec")
     public CSIDriverSpec getSpec() {
         return spec;
     }
 
+    /**
+     * CSIDriver captures information about a Container Storage Interface (CSI) volume driver deployed on the cluster. CSI drivers do not need to create the CSIDriver object directly. Instead they may use the cluster-driver-registrar sidecar container. When deployed with a CSI driver it automatically creates a CSIDriver object representing the driver. Kubernetes attach detach controller uses this object to determine whether attach is required. Kubelet uses this object to determine whether pod information needs to be passed on mount. CSIDriver objects are non-namespaced.
+     */
     @JsonProperty("spec")
     public void setSpec(CSIDriverSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSIDriverList.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSIDriverList.java
index 1926607d224..e03012c9ca6 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSIDriverList.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSIDriverList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CSIDriverList is a collection of CSIDriver objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class CSIDriverList implements Editable<CSIDriverListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.storage.v1beta1.CSIDriver>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storage.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.storage.v1beta1.CSIDriver> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CSIDriverList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CSIDriverList(String apiVersion, List<io.fabric8.kubernetes.api.model.sto
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of CSIDriver
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.storage.v1beta1.CSIDriver> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of CSIDriver
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.storage.v1beta1.CSIDriver> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CSIDriverList is a collection of CSIDriver objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CSIDriverList is a collection of CSIDriver objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSIDriverSpec.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSIDriverSpec.java
index 69ac8e81513..3abce8ca8b2 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSIDriverSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSIDriverSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CSIDriverSpec is the specification of a CSIDriver.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -106,73 +109,115 @@ public CSIDriverSpec(Boolean attachRequired, String fsGroupPolicy, Boolean podIn
         this.volumeLifecycleModes = volumeLifecycleModes;
     }
 
+    /**
+     * attachRequired indicates this CSI volume driver requires an attach operation (because it implements the CSI ControllerPublishVolume() method), and that the Kubernetes attach detach controller should call the attach volume interface which checks the volumeattachment status and waits until the volume is attached before proceeding to mounting. The CSI external-attacher coordinates with CSI volume driver and updates the volumeattachment status when the attach operation is complete. If the CSIDriverRegistry feature gate is enabled and the value is specified to false, the attach operation will be skipped. Otherwise the attach operation will be called.<br><p> <br><p> This field is immutable.
+     */
     @JsonProperty("attachRequired")
     public Boolean getAttachRequired() {
         return attachRequired;
     }
 
+    /**
+     * attachRequired indicates this CSI volume driver requires an attach operation (because it implements the CSI ControllerPublishVolume() method), and that the Kubernetes attach detach controller should call the attach volume interface which checks the volumeattachment status and waits until the volume is attached before proceeding to mounting. The CSI external-attacher coordinates with CSI volume driver and updates the volumeattachment status when the attach operation is complete. If the CSIDriverRegistry feature gate is enabled and the value is specified to false, the attach operation will be skipped. Otherwise the attach operation will be called.<br><p> <br><p> This field is immutable.
+     */
     @JsonProperty("attachRequired")
     public void setAttachRequired(Boolean attachRequired) {
         this.attachRequired = attachRequired;
     }
 
+    /**
+     * Defines if the underlying volume supports changing ownership and permission of the volume before being mounted. Refer to the specific FSGroupPolicy values for additional details. This field is alpha-level, and is only honored by servers that enable the CSIVolumeFSGroupPolicy feature gate.<br><p> <br><p> This field is immutable.
+     */
     @JsonProperty("fsGroupPolicy")
     public String getFsGroupPolicy() {
         return fsGroupPolicy;
     }
 
+    /**
+     * Defines if the underlying volume supports changing ownership and permission of the volume before being mounted. Refer to the specific FSGroupPolicy values for additional details. This field is alpha-level, and is only honored by servers that enable the CSIVolumeFSGroupPolicy feature gate.<br><p> <br><p> This field is immutable.
+     */
     @JsonProperty("fsGroupPolicy")
     public void setFsGroupPolicy(String fsGroupPolicy) {
         this.fsGroupPolicy = fsGroupPolicy;
     }
 
+    /**
+     * If set to true, podInfoOnMount indicates this CSI volume driver requires additional pod information (like podName, podUID, etc.) during mount operations. If set to false, pod information will not be passed on mount. Default is false. The CSI driver specifies podInfoOnMount as part of driver deployment. If true, Kubelet will pass pod information as VolumeContext in the CSI NodePublishVolume() calls. The CSI driver is responsible for parsing and validating the information passed in as VolumeContext. The following VolumeConext will be passed if podInfoOnMount is set to true. This list might grow, but the prefix will be used. "csi.storage.k8s.io/pod.name": pod.Name "csi.storage.k8s.io/pod.namespace": pod.Namespace "csi.storage.k8s.io/pod.uid": string(pod.UID) "csi.storage.k8s.io/ephemeral": "true" if the volume is an ephemeral inline volume<br><p>                                 defined by a CSIVolumeSource, otherwise "false"<br><p> <br><p> "csi.storage.k8s.io/ephemeral" is a new feature in Kubernetes 1.16. It is only required for drivers which support both the "Persistent" and "Ephemeral" VolumeLifecycleMode. Other drivers can leave pod info disabled and/or ignore this field. As Kubernetes 1.15 doesn't support this field, drivers can only support one mode when deployed on such a cluster and the deployment determines which mode that is, for example via a command line parameter of the driver.<br><p> <br><p> This field is immutable.
+     */
     @JsonProperty("podInfoOnMount")
     public Boolean getPodInfoOnMount() {
         return podInfoOnMount;
     }
 
+    /**
+     * If set to true, podInfoOnMount indicates this CSI volume driver requires additional pod information (like podName, podUID, etc.) during mount operations. If set to false, pod information will not be passed on mount. Default is false. The CSI driver specifies podInfoOnMount as part of driver deployment. If true, Kubelet will pass pod information as VolumeContext in the CSI NodePublishVolume() calls. The CSI driver is responsible for parsing and validating the information passed in as VolumeContext. The following VolumeConext will be passed if podInfoOnMount is set to true. This list might grow, but the prefix will be used. "csi.storage.k8s.io/pod.name": pod.Name "csi.storage.k8s.io/pod.namespace": pod.Namespace "csi.storage.k8s.io/pod.uid": string(pod.UID) "csi.storage.k8s.io/ephemeral": "true" if the volume is an ephemeral inline volume<br><p>                                 defined by a CSIVolumeSource, otherwise "false"<br><p> <br><p> "csi.storage.k8s.io/ephemeral" is a new feature in Kubernetes 1.16. It is only required for drivers which support both the "Persistent" and "Ephemeral" VolumeLifecycleMode. Other drivers can leave pod info disabled and/or ignore this field. As Kubernetes 1.15 doesn't support this field, drivers can only support one mode when deployed on such a cluster and the deployment determines which mode that is, for example via a command line parameter of the driver.<br><p> <br><p> This field is immutable.
+     */
     @JsonProperty("podInfoOnMount")
     public void setPodInfoOnMount(Boolean podInfoOnMount) {
         this.podInfoOnMount = podInfoOnMount;
     }
 
+    /**
+     * RequiresRepublish indicates the CSI driver wants `NodePublishVolume` being periodically called to reflect any possible change in the mounted volume. This field defaults to false.<br><p> <br><p> Note: After a successful initial NodePublishVolume call, subsequent calls to NodePublishVolume should only update the contents of the volume. New mount points will not be seen by a running container.<br><p> <br><p> This is a beta feature and only available when the CSIServiceAccountToken feature is enabled.
+     */
     @JsonProperty("requiresRepublish")
     public Boolean getRequiresRepublish() {
         return requiresRepublish;
     }
 
+    /**
+     * RequiresRepublish indicates the CSI driver wants `NodePublishVolume` being periodically called to reflect any possible change in the mounted volume. This field defaults to false.<br><p> <br><p> Note: After a successful initial NodePublishVolume call, subsequent calls to NodePublishVolume should only update the contents of the volume. New mount points will not be seen by a running container.<br><p> <br><p> This is a beta feature and only available when the CSIServiceAccountToken feature is enabled.
+     */
     @JsonProperty("requiresRepublish")
     public void setRequiresRepublish(Boolean requiresRepublish) {
         this.requiresRepublish = requiresRepublish;
     }
 
+    /**
+     * If set to true, storageCapacity indicates that the CSI volume driver wants pod scheduling to consider the storage capacity that the driver deployment will report by creating CSIStorageCapacity objects with capacity information.<br><p> <br><p> The check can be enabled immediately when deploying a driver. In that case, provisioning new volumes with late binding will pause until the driver deployment has published some suitable CSIStorageCapacity object.<br><p> <br><p> Alternatively, the driver can be deployed with the field unset or false and it can be flipped later when storage capacity information has been published.<br><p> <br><p> This field is immutable.<br><p> <br><p> This is a beta field and only available when the CSIStorageCapacity feature is enabled. The default is false.
+     */
     @JsonProperty("storageCapacity")
     public Boolean getStorageCapacity() {
         return storageCapacity;
     }
 
+    /**
+     * If set to true, storageCapacity indicates that the CSI volume driver wants pod scheduling to consider the storage capacity that the driver deployment will report by creating CSIStorageCapacity objects with capacity information.<br><p> <br><p> The check can be enabled immediately when deploying a driver. In that case, provisioning new volumes with late binding will pause until the driver deployment has published some suitable CSIStorageCapacity object.<br><p> <br><p> Alternatively, the driver can be deployed with the field unset or false and it can be flipped later when storage capacity information has been published.<br><p> <br><p> This field is immutable.<br><p> <br><p> This is a beta field and only available when the CSIStorageCapacity feature is enabled. The default is false.
+     */
     @JsonProperty("storageCapacity")
     public void setStorageCapacity(Boolean storageCapacity) {
         this.storageCapacity = storageCapacity;
     }
 
+    /**
+     * TokenRequests indicates the CSI driver needs pods' service account tokens it is mounting volume for to do necessary authentication. Kubelet will pass the tokens in VolumeContext in the CSI NodePublishVolume calls. The CSI driver should parse and validate the following VolumeContext: "csi.storage.k8s.io/serviceAccount.tokens": {<br><p>   "&lt;audience&gt;": {<br><p>     "token": &lt;token&gt;,<br><p>     "expirationTimestamp": &lt;expiration timestamp in RFC3339&gt;,<br><p>   },<br><p>   ...<br><p> }<br><p> <br><p> Note: Audience in each TokenRequest should be different and at most one token is empty string. To receive a new token after expiry, RequiresRepublish can be used to trigger NodePublishVolume periodically.<br><p> <br><p> This is a beta feature and only available when the CSIServiceAccountToken feature is enabled.
+     */
     @JsonProperty("tokenRequests")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TokenRequest> getTokenRequests() {
         return tokenRequests;
     }
 
+    /**
+     * TokenRequests indicates the CSI driver needs pods' service account tokens it is mounting volume for to do necessary authentication. Kubelet will pass the tokens in VolumeContext in the CSI NodePublishVolume calls. The CSI driver should parse and validate the following VolumeContext: "csi.storage.k8s.io/serviceAccount.tokens": {<br><p>   "&lt;audience&gt;": {<br><p>     "token": &lt;token&gt;,<br><p>     "expirationTimestamp": &lt;expiration timestamp in RFC3339&gt;,<br><p>   },<br><p>   ...<br><p> }<br><p> <br><p> Note: Audience in each TokenRequest should be different and at most one token is empty string. To receive a new token after expiry, RequiresRepublish can be used to trigger NodePublishVolume periodically.<br><p> <br><p> This is a beta feature and only available when the CSIServiceAccountToken feature is enabled.
+     */
     @JsonProperty("tokenRequests")
     public void setTokenRequests(List<TokenRequest> tokenRequests) {
         this.tokenRequests = tokenRequests;
     }
 
+    /**
+     * VolumeLifecycleModes defines what kind of volumes this CSI volume driver supports. The default if the list is empty is "Persistent", which is the usage defined by the CSI specification and implemented in Kubernetes via the usual PV/PVC mechanism. The other mode is "Ephemeral". In this mode, volumes are defined inline inside the pod spec with CSIVolumeSource and their lifecycle is tied to the lifecycle of that pod. A driver has to be aware of this because it is only going to get a NodePublishVolume call for such a volume. For more information about implementing this mode, see https://kubernetes-csi.github.io/docs/ephemeral-local-volumes.html A driver can support one or more of these modes and more modes may be added in the future.<br><p> <br><p> This field is immutable.
+     */
     @JsonProperty("volumeLifecycleModes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getVolumeLifecycleModes() {
         return volumeLifecycleModes;
     }
 
+    /**
+     * VolumeLifecycleModes defines what kind of volumes this CSI volume driver supports. The default if the list is empty is "Persistent", which is the usage defined by the CSI specification and implemented in Kubernetes via the usual PV/PVC mechanism. The other mode is "Ephemeral". In this mode, volumes are defined inline inside the pod spec with CSIVolumeSource and their lifecycle is tied to the lifecycle of that pod. A driver has to be aware of this because it is only going to get a NodePublishVolume call for such a volume. For more information about implementing this mode, see https://kubernetes-csi.github.io/docs/ephemeral-local-volumes.html A driver can support one or more of these modes and more modes may be added in the future.<br><p> <br><p> This field is immutable.
+     */
     @JsonProperty("volumeLifecycleModes")
     public void setVolumeLifecycleModes(List<String> volumeLifecycleModes) {
         this.volumeLifecycleModes = volumeLifecycleModes;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSINode.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSINode.java
index c915dfac12f..2529468439b 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSINode.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSINode.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DEPRECATED - This group version of CSINode is deprecated by storage/v1/CSINode. See the release notes for more information. CSINode holds information about all CSI drivers installed on a node. CSI drivers do not need to create the CSINode object directly. As long as they use the node-driver-registrar sidecar container, the kubelet will automatically populate the CSINode object for the CSI driver as part of kubelet plugin registration. CSINode has the same name as a node. If the object is missing, it means either there are no CSI Drivers available on the node, or the Kubelet version is low enough that it doesn't create this object. CSINode has an OwnerReference that points to the corresponding node object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class CSINode implements Editable<CSINodeBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storage.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CSINode";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public CSINode(String apiVersion, String kind, ObjectMeta metadata, CSINodeSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DEPRECATED - This group version of CSINode is deprecated by storage/v1/CSINode. See the release notes for more information. CSINode holds information about all CSI drivers installed on a node. CSI drivers do not need to create the CSINode object directly. As long as they use the node-driver-registrar sidecar container, the kubelet will automatically populate the CSINode object for the CSI driver as part of kubelet plugin registration. CSINode has the same name as a node. If the object is missing, it means either there are no CSI Drivers available on the node, or the Kubelet version is low enough that it doesn't create this object. CSINode has an OwnerReference that points to the corresponding node object.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DEPRECATED - This group version of CSINode is deprecated by storage/v1/CSINode. See the release notes for more information. CSINode holds information about all CSI drivers installed on a node. CSI drivers do not need to create the CSINode object directly. As long as they use the node-driver-registrar sidecar container, the kubelet will automatically populate the CSINode object for the CSI driver as part of kubelet plugin registration. CSINode has the same name as a node. If the object is missing, it means either there are no CSI Drivers available on the node, or the Kubelet version is low enough that it doesn't create this object. CSINode has an OwnerReference that points to the corresponding node object.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * DEPRECATED - This group version of CSINode is deprecated by storage/v1/CSINode. See the release notes for more information. CSINode holds information about all CSI drivers installed on a node. CSI drivers do not need to create the CSINode object directly. As long as they use the node-driver-registrar sidecar container, the kubelet will automatically populate the CSINode object for the CSI driver as part of kubelet plugin registration. CSINode has the same name as a node. If the object is missing, it means either there are no CSI Drivers available on the node, or the Kubelet version is low enough that it doesn't create this object. CSINode has an OwnerReference that points to the corresponding node object.
+     */
     @JsonProperty("spec")
     public CSINodeSpec getSpec() {
         return spec;
     }
 
+    /**
+     * DEPRECATED - This group version of CSINode is deprecated by storage/v1/CSINode. See the release notes for more information. CSINode holds information about all CSI drivers installed on a node. CSI drivers do not need to create the CSINode object directly. As long as they use the node-driver-registrar sidecar container, the kubelet will automatically populate the CSINode object for the CSI driver as part of kubelet plugin registration. CSINode has the same name as a node. If the object is missing, it means either there are no CSI Drivers available on the node, or the Kubelet version is low enough that it doesn't create this object. CSINode has an OwnerReference that points to the corresponding node object.
+     */
     @JsonProperty("spec")
     public void setSpec(CSINodeSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSINodeDriver.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSINodeDriver.java
index eb177443fe1..ad54311b6e9 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSINodeDriver.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSINodeDriver.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CSINodeDriver holds information about the specification of one CSI driver installed on a node
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public CSINodeDriver(VolumeNodeResources allocatable, String name, String nodeID
         this.topologyKeys = topologyKeys;
     }
 
+    /**
+     * CSINodeDriver holds information about the specification of one CSI driver installed on a node
+     */
     @JsonProperty("allocatable")
     public VolumeNodeResources getAllocatable() {
         return allocatable;
     }
 
+    /**
+     * CSINodeDriver holds information about the specification of one CSI driver installed on a node
+     */
     @JsonProperty("allocatable")
     public void setAllocatable(VolumeNodeResources allocatable) {
         this.allocatable = allocatable;
     }
 
+    /**
+     * This is the name of the CSI driver that this object refers to. This MUST be the same name returned by the CSI GetPluginName() call for that driver.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * This is the name of the CSI driver that this object refers to. This MUST be the same name returned by the CSI GetPluginName() call for that driver.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * nodeID of the node from the driver point of view. This field enables Kubernetes to communicate with storage systems that do not share the same nomenclature for nodes. For example, Kubernetes may refer to a given node as "node1", but the storage system may refer to the same node as "nodeA". When Kubernetes issues a command to the storage system to attach a volume to a specific node, it can use this field to refer to the node name using the ID that the storage system will understand, e.g. "nodeA" instead of "node1". This field is required.
+     */
     @JsonProperty("nodeID")
     public String getNodeID() {
         return nodeID;
     }
 
+    /**
+     * nodeID of the node from the driver point of view. This field enables Kubernetes to communicate with storage systems that do not share the same nomenclature for nodes. For example, Kubernetes may refer to a given node as "node1", but the storage system may refer to the same node as "nodeA". When Kubernetes issues a command to the storage system to attach a volume to a specific node, it can use this field to refer to the node name using the ID that the storage system will understand, e.g. "nodeA" instead of "node1". This field is required.
+     */
     @JsonProperty("nodeID")
     public void setNodeID(String nodeID) {
         this.nodeID = nodeID;
     }
 
+    /**
+     * topologyKeys is the list of keys supported by the driver. When a driver is initialized on a cluster, it provides a set of topology keys that it understands (e.g. "company.com/zone", "company.com/region"). When a driver is initialized on a node, it provides the same topology keys along with values. Kubelet will expose these topology keys as labels on its own node object. When Kubernetes does topology aware provisioning, it can use this list to determine which labels it should retrieve from the node object and pass back to the driver. It is possible for different nodes to use different topology keys. This can be empty if driver does not support topology.
+     */
     @JsonProperty("topologyKeys")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getTopologyKeys() {
         return topologyKeys;
     }
 
+    /**
+     * topologyKeys is the list of keys supported by the driver. When a driver is initialized on a cluster, it provides a set of topology keys that it understands (e.g. "company.com/zone", "company.com/region"). When a driver is initialized on a node, it provides the same topology keys along with values. Kubelet will expose these topology keys as labels on its own node object. When Kubernetes does topology aware provisioning, it can use this list to determine which labels it should retrieve from the node object and pass back to the driver. It is possible for different nodes to use different topology keys. This can be empty if driver does not support topology.
+     */
     @JsonProperty("topologyKeys")
     public void setTopologyKeys(List<String> topologyKeys) {
         this.topologyKeys = topologyKeys;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSINodeList.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSINodeList.java
index 2aa7652151c..65efa575c5c 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSINodeList.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSINodeList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CSINodeList is a collection of CSINode objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class CSINodeList implements Editable<CSINodeListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.storage.v1beta1.CSINode>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storage.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.storage.v1beta1.CSINode> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CSINodeList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CSINodeList(String apiVersion, List<io.fabric8.kubernetes.api.model.stora
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of CSINode
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.storage.v1beta1.CSINode> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of CSINode
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.storage.v1beta1.CSINode> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CSINodeList is a collection of CSINode objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CSINodeList is a collection of CSINode objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSINodeSpec.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSINodeSpec.java
index 8bee38a5f82..9e36a0756f8 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSINodeSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSINodeSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CSINodeSpec holds information about the specification of all CSI drivers installed on a node
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public CSINodeSpec(List<CSINodeDriver> drivers) {
         this.drivers = drivers;
     }
 
+    /**
+     * drivers is a list of information of all CSI Drivers existing on a node. If all drivers in the list are uninstalled, this can become empty.
+     */
     @JsonProperty("drivers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CSINodeDriver> getDrivers() {
         return drivers;
     }
 
+    /**
+     * drivers is a list of information of all CSI Drivers existing on a node. If all drivers in the list are uninstalled, this can become empty.
+     */
     @JsonProperty("drivers")
     public void setDrivers(List<CSINodeDriver> drivers) {
         this.drivers = drivers;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSIStorageCapacity.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSIStorageCapacity.java
index 25d59340d7a..6ed14def9d3 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSIStorageCapacity.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSIStorageCapacity.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CSIStorageCapacity stores the result of one CSI GetCapacity call. For a given StorageClass, this describes the available capacity in a particular topology segment.  This can be used when considering where to instantiate new PersistentVolumes.<br><p> <br><p> For example this can express things like: - StorageClass "standard" has "1234 GiB" available in "topology.kubernetes.io/zone=us-east1" - StorageClass "localssd" has "10 GiB" available in "kubernetes.io/hostname=knode-abc123"<br><p> <br><p> The following three cases all imply that no capacity is available for a certain combination: - no object exists with suitable topology and storage class name - such an object exists, but the capacity is unset - such an object exists, but the capacity is zero<br><p> <br><p> The producer of these objects can decide which approach is more suitable.<br><p> <br><p> They are consumed by the kube-scheduler if the CSIStorageCapacity beta feature gate is enabled there and a CSI driver opts into capacity-aware scheduling with CSIDriver.StorageCapacity.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,16 +82,10 @@
 public class CSIStorageCapacity implements Editable<CSIStorageCapacityBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storage.k8s.io/v1beta1";
     @JsonProperty("capacity")
     private Quantity capacity;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CSIStorageCapacity";
     @JsonProperty("maximumVolumeSize")
@@ -120,7 +117,7 @@ public CSIStorageCapacity(String apiVersion, Quantity capacity, String kind, Qua
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -128,25 +125,31 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * CSIStorageCapacity stores the result of one CSI GetCapacity call. For a given StorageClass, this describes the available capacity in a particular topology segment.  This can be used when considering where to instantiate new PersistentVolumes.<br><p> <br><p> For example this can express things like: - StorageClass "standard" has "1234 GiB" available in "topology.kubernetes.io/zone=us-east1" - StorageClass "localssd" has "10 GiB" available in "kubernetes.io/hostname=knode-abc123"<br><p> <br><p> The following three cases all imply that no capacity is available for a certain combination: - no object exists with suitable topology and storage class name - such an object exists, but the capacity is unset - such an object exists, but the capacity is zero<br><p> <br><p> The producer of these objects can decide which approach is more suitable.<br><p> <br><p> They are consumed by the kube-scheduler if the CSIStorageCapacity beta feature gate is enabled there and a CSI driver opts into capacity-aware scheduling with CSIDriver.StorageCapacity.
+     */
     @JsonProperty("capacity")
     public Quantity getCapacity() {
         return capacity;
     }
 
+    /**
+     * CSIStorageCapacity stores the result of one CSI GetCapacity call. For a given StorageClass, this describes the available capacity in a particular topology segment.  This can be used when considering where to instantiate new PersistentVolumes.<br><p> <br><p> For example this can express things like: - StorageClass "standard" has "1234 GiB" available in "topology.kubernetes.io/zone=us-east1" - StorageClass "localssd" has "10 GiB" available in "kubernetes.io/hostname=knode-abc123"<br><p> <br><p> The following three cases all imply that no capacity is available for a certain combination: - no object exists with suitable topology and storage class name - such an object exists, but the capacity is unset - such an object exists, but the capacity is zero<br><p> <br><p> The producer of these objects can decide which approach is more suitable.<br><p> <br><p> They are consumed by the kube-scheduler if the CSIStorageCapacity beta feature gate is enabled there and a CSI driver opts into capacity-aware scheduling with CSIDriver.StorageCapacity.
+     */
     @JsonProperty("capacity")
     public void setCapacity(Quantity capacity) {
         this.capacity = capacity;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -154,48 +157,72 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CSIStorageCapacity stores the result of one CSI GetCapacity call. For a given StorageClass, this describes the available capacity in a particular topology segment.  This can be used when considering where to instantiate new PersistentVolumes.<br><p> <br><p> For example this can express things like: - StorageClass "standard" has "1234 GiB" available in "topology.kubernetes.io/zone=us-east1" - StorageClass "localssd" has "10 GiB" available in "kubernetes.io/hostname=knode-abc123"<br><p> <br><p> The following three cases all imply that no capacity is available for a certain combination: - no object exists with suitable topology and storage class name - such an object exists, but the capacity is unset - such an object exists, but the capacity is zero<br><p> <br><p> The producer of these objects can decide which approach is more suitable.<br><p> <br><p> They are consumed by the kube-scheduler if the CSIStorageCapacity beta feature gate is enabled there and a CSI driver opts into capacity-aware scheduling with CSIDriver.StorageCapacity.
+     */
     @JsonProperty("maximumVolumeSize")
     public Quantity getMaximumVolumeSize() {
         return maximumVolumeSize;
     }
 
+    /**
+     * CSIStorageCapacity stores the result of one CSI GetCapacity call. For a given StorageClass, this describes the available capacity in a particular topology segment.  This can be used when considering where to instantiate new PersistentVolumes.<br><p> <br><p> For example this can express things like: - StorageClass "standard" has "1234 GiB" available in "topology.kubernetes.io/zone=us-east1" - StorageClass "localssd" has "10 GiB" available in "kubernetes.io/hostname=knode-abc123"<br><p> <br><p> The following three cases all imply that no capacity is available for a certain combination: - no object exists with suitable topology and storage class name - such an object exists, but the capacity is unset - such an object exists, but the capacity is zero<br><p> <br><p> The producer of these objects can decide which approach is more suitable.<br><p> <br><p> They are consumed by the kube-scheduler if the CSIStorageCapacity beta feature gate is enabled there and a CSI driver opts into capacity-aware scheduling with CSIDriver.StorageCapacity.
+     */
     @JsonProperty("maximumVolumeSize")
     public void setMaximumVolumeSize(Quantity maximumVolumeSize) {
         this.maximumVolumeSize = maximumVolumeSize;
     }
 
+    /**
+     * CSIStorageCapacity stores the result of one CSI GetCapacity call. For a given StorageClass, this describes the available capacity in a particular topology segment.  This can be used when considering where to instantiate new PersistentVolumes.<br><p> <br><p> For example this can express things like: - StorageClass "standard" has "1234 GiB" available in "topology.kubernetes.io/zone=us-east1" - StorageClass "localssd" has "10 GiB" available in "kubernetes.io/hostname=knode-abc123"<br><p> <br><p> The following three cases all imply that no capacity is available for a certain combination: - no object exists with suitable topology and storage class name - such an object exists, but the capacity is unset - such an object exists, but the capacity is zero<br><p> <br><p> The producer of these objects can decide which approach is more suitable.<br><p> <br><p> They are consumed by the kube-scheduler if the CSIStorageCapacity beta feature gate is enabled there and a CSI driver opts into capacity-aware scheduling with CSIDriver.StorageCapacity.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CSIStorageCapacity stores the result of one CSI GetCapacity call. For a given StorageClass, this describes the available capacity in a particular topology segment.  This can be used when considering where to instantiate new PersistentVolumes.<br><p> <br><p> For example this can express things like: - StorageClass "standard" has "1234 GiB" available in "topology.kubernetes.io/zone=us-east1" - StorageClass "localssd" has "10 GiB" available in "kubernetes.io/hostname=knode-abc123"<br><p> <br><p> The following three cases all imply that no capacity is available for a certain combination: - no object exists with suitable topology and storage class name - such an object exists, but the capacity is unset - such an object exists, but the capacity is zero<br><p> <br><p> The producer of these objects can decide which approach is more suitable.<br><p> <br><p> They are consumed by the kube-scheduler if the CSIStorageCapacity beta feature gate is enabled there and a CSI driver opts into capacity-aware scheduling with CSIDriver.StorageCapacity.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * CSIStorageCapacity stores the result of one CSI GetCapacity call. For a given StorageClass, this describes the available capacity in a particular topology segment.  This can be used when considering where to instantiate new PersistentVolumes.<br><p> <br><p> For example this can express things like: - StorageClass "standard" has "1234 GiB" available in "topology.kubernetes.io/zone=us-east1" - StorageClass "localssd" has "10 GiB" available in "kubernetes.io/hostname=knode-abc123"<br><p> <br><p> The following three cases all imply that no capacity is available for a certain combination: - no object exists with suitable topology and storage class name - such an object exists, but the capacity is unset - such an object exists, but the capacity is zero<br><p> <br><p> The producer of these objects can decide which approach is more suitable.<br><p> <br><p> They are consumed by the kube-scheduler if the CSIStorageCapacity beta feature gate is enabled there and a CSI driver opts into capacity-aware scheduling with CSIDriver.StorageCapacity.
+     */
     @JsonProperty("nodeTopology")
     public LabelSelector getNodeTopology() {
         return nodeTopology;
     }
 
+    /**
+     * CSIStorageCapacity stores the result of one CSI GetCapacity call. For a given StorageClass, this describes the available capacity in a particular topology segment.  This can be used when considering where to instantiate new PersistentVolumes.<br><p> <br><p> For example this can express things like: - StorageClass "standard" has "1234 GiB" available in "topology.kubernetes.io/zone=us-east1" - StorageClass "localssd" has "10 GiB" available in "kubernetes.io/hostname=knode-abc123"<br><p> <br><p> The following three cases all imply that no capacity is available for a certain combination: - no object exists with suitable topology and storage class name - such an object exists, but the capacity is unset - such an object exists, but the capacity is zero<br><p> <br><p> The producer of these objects can decide which approach is more suitable.<br><p> <br><p> They are consumed by the kube-scheduler if the CSIStorageCapacity beta feature gate is enabled there and a CSI driver opts into capacity-aware scheduling with CSIDriver.StorageCapacity.
+     */
     @JsonProperty("nodeTopology")
     public void setNodeTopology(LabelSelector nodeTopology) {
         this.nodeTopology = nodeTopology;
     }
 
+    /**
+     * The name of the StorageClass that the reported capacity applies to. It must meet the same requirements as the name of a StorageClass object (non-empty, DNS subdomain). If that object no longer exists, the CSIStorageCapacity object is obsolete and should be removed by its creator. This field is immutable.
+     */
     @JsonProperty("storageClassName")
     public String getStorageClassName() {
         return storageClassName;
     }
 
+    /**
+     * The name of the StorageClass that the reported capacity applies to. It must meet the same requirements as the name of a StorageClass object (non-empty, DNS subdomain). If that object no longer exists, the CSIStorageCapacity object is obsolete and should be removed by its creator. This field is immutable.
+     */
     @JsonProperty("storageClassName")
     public void setStorageClassName(String storageClassName) {
         this.storageClassName = storageClassName;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSIStorageCapacityList.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSIStorageCapacityList.java
index 357b359ec08..b1f46c52597 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSIStorageCapacityList.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/CSIStorageCapacityList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CSIStorageCapacityList is a collection of CSIStorageCapacity objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class CSIStorageCapacityList implements Editable<CSIStorageCapacityListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.storage.v1beta1.CSIStorageCapacity>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storage.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.storage.v1beta1.CSIStorageCapacity> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CSIStorageCapacityList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CSIStorageCapacityList(String apiVersion, List<io.fabric8.kubernetes.api.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of CSIStorageCapacity objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.storage.v1beta1.CSIStorageCapacity> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of CSIStorageCapacity objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.storage.v1beta1.CSIStorageCapacity> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CSIStorageCapacityList is a collection of CSIStorageCapacity objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CSIStorageCapacityList is a collection of CSIStorageCapacity objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/StorageClass.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/StorageClass.java
index 05612c73915..c7a8be1f0bb 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/StorageClass.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/StorageClass.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StorageClass describes the parameters for a class of storage for which PersistentVolumes can be dynamically provisioned.<br><p> <br><p> StorageClasses are non-namespaced; the name of the storage class according to etcd is in ObjectMeta.Name.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -88,14 +91,8 @@ public class StorageClass implements Editable<StorageClassBuilder>, HasMetadata
     @JsonProperty("allowedTopologies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<TopologySelectorTerm> allowedTopologies = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storage.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "StorageClass";
     @JsonProperty("metadata")
@@ -135,29 +132,41 @@ public StorageClass(Boolean allowVolumeExpansion, List<TopologySelectorTerm> all
         this.volumeBindingMode = volumeBindingMode;
     }
 
+    /**
+     * AllowVolumeExpansion shows whether the storage class allow volume expand
+     */
     @JsonProperty("allowVolumeExpansion")
     public Boolean getAllowVolumeExpansion() {
         return allowVolumeExpansion;
     }
 
+    /**
+     * AllowVolumeExpansion shows whether the storage class allow volume expand
+     */
     @JsonProperty("allowVolumeExpansion")
     public void setAllowVolumeExpansion(Boolean allowVolumeExpansion) {
         this.allowVolumeExpansion = allowVolumeExpansion;
     }
 
+    /**
+     * Restrict the node topologies where volumes can be dynamically provisioned. Each volume plugin defines its own supported topology specifications. An empty TopologySelectorTerm list means there is no topology restriction. This field is only honored by servers that enable the VolumeScheduling feature.
+     */
     @JsonProperty("allowedTopologies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TopologySelectorTerm> getAllowedTopologies() {
         return allowedTopologies;
     }
 
+    /**
+     * Restrict the node topologies where volumes can be dynamically provisioned. Each volume plugin defines its own supported topology specifications. An empty TopologySelectorTerm list means there is no topology restriction. This field is only honored by servers that enable the VolumeScheduling feature.
+     */
     @JsonProperty("allowedTopologies")
     public void setAllowedTopologies(List<TopologySelectorTerm> allowedTopologies) {
         this.allowedTopologies = allowedTopologies;
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -165,7 +174,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -173,7 +182,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -181,70 +190,106 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * StorageClass describes the parameters for a class of storage for which PersistentVolumes can be dynamically provisioned.<br><p> <br><p> StorageClasses are non-namespaced; the name of the storage class according to etcd is in ObjectMeta.Name.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * StorageClass describes the parameters for a class of storage for which PersistentVolumes can be dynamically provisioned.<br><p> <br><p> StorageClasses are non-namespaced; the name of the storage class according to etcd is in ObjectMeta.Name.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Dynamically provisioned PersistentVolumes of this storage class are created with these mountOptions, e.g. ["ro", "soft"]. Not validated - mount of the PVs will simply fail if one is invalid.
+     */
     @JsonProperty("mountOptions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMountOptions() {
         return mountOptions;
     }
 
+    /**
+     * Dynamically provisioned PersistentVolumes of this storage class are created with these mountOptions, e.g. ["ro", "soft"]. Not validated - mount of the PVs will simply fail if one is invalid.
+     */
     @JsonProperty("mountOptions")
     public void setMountOptions(List<String> mountOptions) {
         this.mountOptions = mountOptions;
     }
 
+    /**
+     * Parameters holds the parameters for the provisioner that should create volumes of this storage class.
+     */
     @JsonProperty("parameters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getParameters() {
         return parameters;
     }
 
+    /**
+     * Parameters holds the parameters for the provisioner that should create volumes of this storage class.
+     */
     @JsonProperty("parameters")
     public void setParameters(Map<String, String> parameters) {
         this.parameters = parameters;
     }
 
+    /**
+     * Provisioner indicates the type of the provisioner.
+     */
     @JsonProperty("provisioner")
     public String getProvisioner() {
         return provisioner;
     }
 
+    /**
+     * Provisioner indicates the type of the provisioner.
+     */
     @JsonProperty("provisioner")
     public void setProvisioner(String provisioner) {
         this.provisioner = provisioner;
     }
 
+    /**
+     * Dynamically provisioned PersistentVolumes of this storage class are created with this reclaimPolicy. Defaults to Delete.
+     */
     @JsonProperty("reclaimPolicy")
     public String getReclaimPolicy() {
         return reclaimPolicy;
     }
 
+    /**
+     * Dynamically provisioned PersistentVolumes of this storage class are created with this reclaimPolicy. Defaults to Delete.
+     */
     @JsonProperty("reclaimPolicy")
     public void setReclaimPolicy(String reclaimPolicy) {
         this.reclaimPolicy = reclaimPolicy;
     }
 
+    /**
+     * VolumeBindingMode indicates how PersistentVolumeClaims should be provisioned and bound.  When unset, VolumeBindingImmediate is used. This field is only honored by servers that enable the VolumeScheduling feature.
+     */
     @JsonProperty("volumeBindingMode")
     public String getVolumeBindingMode() {
         return volumeBindingMode;
     }
 
+    /**
+     * VolumeBindingMode indicates how PersistentVolumeClaims should be provisioned and bound.  When unset, VolumeBindingImmediate is used. This field is only honored by servers that enable the VolumeScheduling feature.
+     */
     @JsonProperty("volumeBindingMode")
     public void setVolumeBindingMode(String volumeBindingMode) {
         this.volumeBindingMode = volumeBindingMode;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/StorageClassList.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/StorageClassList.java
index a59aac4038b..ba14b09225e 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/StorageClassList.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/StorageClassList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StorageClassList is a collection of storage classes.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class StorageClassList implements Editable<StorageClassListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.storage.v1beta1.StorageClass>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storage.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.storage.v1beta1.StorageClass> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "StorageClassList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public StorageClassList(String apiVersion, List<io.fabric8.kubernetes.api.model.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of StorageClasses
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.storage.v1beta1.StorageClass> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of StorageClasses
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.storage.v1beta1.StorageClass> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * StorageClassList is a collection of storage classes.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * StorageClassList is a collection of storage classes.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/TokenRequest.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/TokenRequest.java
index cfbf02e3d74..a768bea817a 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/TokenRequest.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/TokenRequest.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TokenRequest contains parameters of a service account token.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public TokenRequest(String audience, Long expirationSeconds) {
         this.expirationSeconds = expirationSeconds;
     }
 
+    /**
+     * Audience is the intended audience of the token in "TokenRequestSpec". It will default to the audiences of kube apiserver.
+     */
     @JsonProperty("audience")
     public String getAudience() {
         return audience;
     }
 
+    /**
+     * Audience is the intended audience of the token in "TokenRequestSpec". It will default to the audiences of kube apiserver.
+     */
     @JsonProperty("audience")
     public void setAudience(String audience) {
         this.audience = audience;
     }
 
+    /**
+     * ExpirationSeconds is the duration of validity of the token in "TokenRequestSpec". It has the same default value of "ExpirationSeconds" in "TokenRequestSpec"
+     */
     @JsonProperty("expirationSeconds")
     public Long getExpirationSeconds() {
         return expirationSeconds;
     }
 
+    /**
+     * ExpirationSeconds is the duration of validity of the token in "TokenRequestSpec". It has the same default value of "ExpirationSeconds" in "TokenRequestSpec"
+     */
     @JsonProperty("expirationSeconds")
     public void setExpirationSeconds(Long expirationSeconds) {
         this.expirationSeconds = expirationSeconds;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeAttachment.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeAttachment.java
index 3271e63445c..f68b67291ce 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeAttachment.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeAttachment.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeAttachment captures the intent to attach or detach the specified volume to/from the specified node.<br><p> <br><p> VolumeAttachment objects are non-namespaced.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class VolumeAttachment implements Editable<VolumeAttachmentBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storage.k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VolumeAttachment";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public VolumeAttachment(String apiVersion, String kind, ObjectMeta metadata, Vol
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VolumeAttachment captures the intent to attach or detach the specified volume to/from the specified node.<br><p> <br><p> VolumeAttachment objects are non-namespaced.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VolumeAttachment captures the intent to attach or detach the specified volume to/from the specified node.<br><p> <br><p> VolumeAttachment objects are non-namespaced.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * VolumeAttachment captures the intent to attach or detach the specified volume to/from the specified node.<br><p> <br><p> VolumeAttachment objects are non-namespaced.
+     */
     @JsonProperty("spec")
     public VolumeAttachmentSpec getSpec() {
         return spec;
     }
 
+    /**
+     * VolumeAttachment captures the intent to attach or detach the specified volume to/from the specified node.<br><p> <br><p> VolumeAttachment objects are non-namespaced.
+     */
     @JsonProperty("spec")
     public void setSpec(VolumeAttachmentSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * VolumeAttachment captures the intent to attach or detach the specified volume to/from the specified node.<br><p> <br><p> VolumeAttachment objects are non-namespaced.
+     */
     @JsonProperty("status")
     public VolumeAttachmentStatus getStatus() {
         return status;
     }
 
+    /**
+     * VolumeAttachment captures the intent to attach or detach the specified volume to/from the specified node.<br><p> <br><p> VolumeAttachment objects are non-namespaced.
+     */
     @JsonProperty("status")
     public void setStatus(VolumeAttachmentStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeAttachmentList.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeAttachmentList.java
index 471174d6ab1..1bbe6ebd8f5 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeAttachmentList.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeAttachmentList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeAttachmentList is a collection of VolumeAttachment objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class VolumeAttachmentList implements Editable<VolumeAttachmentListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.storage.v1beta1.VolumeAttachment>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storage.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.storage.v1beta1.VolumeAttachment> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VolumeAttachmentList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public VolumeAttachmentList(String apiVersion, List<io.fabric8.kubernetes.api.mo
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of VolumeAttachments
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.storage.v1beta1.VolumeAttachment> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of VolumeAttachments
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.storage.v1beta1.VolumeAttachment> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VolumeAttachmentList is a collection of VolumeAttachment objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VolumeAttachmentList is a collection of VolumeAttachment objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeAttachmentSource.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeAttachmentSource.java
index fb4fbecf241..f4126308dd7 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeAttachmentSource.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeAttachmentSource.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeAttachmentSource represents a volume that should be attached. Right now only PersistenVolumes can be attached via external attacher, in future we may allow also inline volumes in pods. Exactly one member can be set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public VolumeAttachmentSource(PersistentVolumeSpec inlineVolumeSpec, String pers
         this.persistentVolumeName = persistentVolumeName;
     }
 
+    /**
+     * VolumeAttachmentSource represents a volume that should be attached. Right now only PersistenVolumes can be attached via external attacher, in future we may allow also inline volumes in pods. Exactly one member can be set.
+     */
     @JsonProperty("inlineVolumeSpec")
     public PersistentVolumeSpec getInlineVolumeSpec() {
         return inlineVolumeSpec;
     }
 
+    /**
+     * VolumeAttachmentSource represents a volume that should be attached. Right now only PersistenVolumes can be attached via external attacher, in future we may allow also inline volumes in pods. Exactly one member can be set.
+     */
     @JsonProperty("inlineVolumeSpec")
     public void setInlineVolumeSpec(PersistentVolumeSpec inlineVolumeSpec) {
         this.inlineVolumeSpec = inlineVolumeSpec;
     }
 
+    /**
+     * Name of the persistent volume to attach.
+     */
     @JsonProperty("persistentVolumeName")
     public String getPersistentVolumeName() {
         return persistentVolumeName;
     }
 
+    /**
+     * Name of the persistent volume to attach.
+     */
     @JsonProperty("persistentVolumeName")
     public void setPersistentVolumeName(String persistentVolumeName) {
         this.persistentVolumeName = persistentVolumeName;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeAttachmentSpec.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeAttachmentSpec.java
index c4ffdb33546..dfd07185c3a 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeAttachmentSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeAttachmentSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeAttachmentSpec is the specification of a VolumeAttachment request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public VolumeAttachmentSpec(String attacher, String nodeName, VolumeAttachmentSo
         this.source = source;
     }
 
+    /**
+     * Attacher indicates the name of the volume driver that MUST handle this request. This is the name returned by GetPluginName().
+     */
     @JsonProperty("attacher")
     public String getAttacher() {
         return attacher;
     }
 
+    /**
+     * Attacher indicates the name of the volume driver that MUST handle this request. This is the name returned by GetPluginName().
+     */
     @JsonProperty("attacher")
     public void setAttacher(String attacher) {
         this.attacher = attacher;
     }
 
+    /**
+     * The node that the volume should be attached to.
+     */
     @JsonProperty("nodeName")
     public String getNodeName() {
         return nodeName;
     }
 
+    /**
+     * The node that the volume should be attached to.
+     */
     @JsonProperty("nodeName")
     public void setNodeName(String nodeName) {
         this.nodeName = nodeName;
     }
 
+    /**
+     * VolumeAttachmentSpec is the specification of a VolumeAttachment request.
+     */
     @JsonProperty("source")
     public VolumeAttachmentSource getSource() {
         return source;
     }
 
+    /**
+     * VolumeAttachmentSpec is the specification of a VolumeAttachment request.
+     */
     @JsonProperty("source")
     public void setSource(VolumeAttachmentSource source) {
         this.source = source;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeAttachmentStatus.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeAttachmentStatus.java
index 922aa2e544d..fde3cbb0c58 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeAttachmentStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeAttachmentStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeAttachmentStatus is the status of a VolumeAttachment request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,42 +94,66 @@ public VolumeAttachmentStatus(VolumeError attachError, Boolean attached, Map<Str
         this.detachError = detachError;
     }
 
+    /**
+     * VolumeAttachmentStatus is the status of a VolumeAttachment request.
+     */
     @JsonProperty("attachError")
     public VolumeError getAttachError() {
         return attachError;
     }
 
+    /**
+     * VolumeAttachmentStatus is the status of a VolumeAttachment request.
+     */
     @JsonProperty("attachError")
     public void setAttachError(VolumeError attachError) {
         this.attachError = attachError;
     }
 
+    /**
+     * Indicates the volume is successfully attached. This field must only be set by the entity completing the attach operation, i.e. the external-attacher.
+     */
     @JsonProperty("attached")
     public Boolean getAttached() {
         return attached;
     }
 
+    /**
+     * Indicates the volume is successfully attached. This field must only be set by the entity completing the attach operation, i.e. the external-attacher.
+     */
     @JsonProperty("attached")
     public void setAttached(Boolean attached) {
         this.attached = attached;
     }
 
+    /**
+     * Upon successful attach, this field is populated with any information returned by the attach operation that must be passed into subsequent WaitForAttach or Mount calls. This field must only be set by the entity completing the attach operation, i.e. the external-attacher.
+     */
     @JsonProperty("attachmentMetadata")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAttachmentMetadata() {
         return attachmentMetadata;
     }
 
+    /**
+     * Upon successful attach, this field is populated with any information returned by the attach operation that must be passed into subsequent WaitForAttach or Mount calls. This field must only be set by the entity completing the attach operation, i.e. the external-attacher.
+     */
     @JsonProperty("attachmentMetadata")
     public void setAttachmentMetadata(Map<String, String> attachmentMetadata) {
         this.attachmentMetadata = attachmentMetadata;
     }
 
+    /**
+     * VolumeAttachmentStatus is the status of a VolumeAttachment request.
+     */
     @JsonProperty("detachError")
     public VolumeError getDetachError() {
         return detachError;
     }
 
+    /**
+     * VolumeAttachmentStatus is the status of a VolumeAttachment request.
+     */
     @JsonProperty("detachError")
     public void setDetachError(VolumeError detachError) {
         this.detachError = detachError;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeAttributesClass.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeAttributesClass.java
index e2587450ffa..f9354bdcc1e 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeAttributesClass.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeAttributesClass.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeAttributesClass represents a specification of mutable volume attributes defined by the CSI driver. The class can be specified during dynamic provisioning of PersistentVolumeClaims, and changed in the PersistentVolumeClaim spec after provisioning.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,16 +78,10 @@
 public class VolumeAttributesClass implements Editable<VolumeAttributesClassBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storage.k8s.io/v1beta1";
     @JsonProperty("driverName")
     private String driverName;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VolumeAttributesClass";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public VolumeAttributesClass(String apiVersion, String driverName, String kind,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,25 +116,31 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Name of the CSI driver This field is immutable.
+     */
     @JsonProperty("driverName")
     public String getDriverName() {
         return driverName;
     }
 
+    /**
+     * Name of the CSI driver This field is immutable.
+     */
     @JsonProperty("driverName")
     public void setDriverName(String driverName) {
         this.driverName = driverName;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -145,29 +148,41 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VolumeAttributesClass represents a specification of mutable volume attributes defined by the CSI driver. The class can be specified during dynamic provisioning of PersistentVolumeClaims, and changed in the PersistentVolumeClaim spec after provisioning.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VolumeAttributesClass represents a specification of mutable volume attributes defined by the CSI driver. The class can be specified during dynamic provisioning of PersistentVolumeClaims, and changed in the PersistentVolumeClaim spec after provisioning.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * parameters hold volume attributes defined by the CSI driver. These values are opaque to the Kubernetes and are passed directly to the CSI driver. The underlying storage provider supports changing these attributes on an existing volume, however the parameters field itself is immutable. To invoke a volume update, a new VolumeAttributesClass should be created with new parameters, and the PersistentVolumeClaim should be updated to reference the new VolumeAttributesClass.<br><p> <br><p> This field is required and must contain at least one key/value pair. The keys cannot be empty, and the maximum number of parameters is 512, with a cumulative max size of 256K. If the CSI driver rejects invalid parameters, the target PersistentVolumeClaim will be set to an "Infeasible" state in the modifyVolumeStatus field.
+     */
     @JsonProperty("parameters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getParameters() {
         return parameters;
     }
 
+    /**
+     * parameters hold volume attributes defined by the CSI driver. These values are opaque to the Kubernetes and are passed directly to the CSI driver. The underlying storage provider supports changing these attributes on an existing volume, however the parameters field itself is immutable. To invoke a volume update, a new VolumeAttributesClass should be created with new parameters, and the PersistentVolumeClaim should be updated to reference the new VolumeAttributesClass.<br><p> <br><p> This field is required and must contain at least one key/value pair. The keys cannot be empty, and the maximum number of parameters is 512, with a cumulative max size of 256K. If the CSI driver rejects invalid parameters, the target PersistentVolumeClaim will be set to an "Infeasible" state in the modifyVolumeStatus field.
+     */
     @JsonProperty("parameters")
     public void setParameters(Map<String, String> parameters) {
         this.parameters = parameters;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeAttributesClassList.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeAttributesClassList.java
index 1c57f367156..fdb5a12d14d 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeAttributesClassList.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeAttributesClassList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeAttributesClassList is a collection of VolumeAttributesClass objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class VolumeAttributesClassList implements Editable<VolumeAttributesClassListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.storage.v1beta1.VolumeAttributesClass>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storage.k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.storage.v1beta1.VolumeAttributesClass> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VolumeAttributesClassList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public VolumeAttributesClassList(String apiVersion, List<io.fabric8.kubernetes.a
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of VolumeAttributesClass objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.storage.v1beta1.VolumeAttributesClass> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of VolumeAttributesClass objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.storage.v1beta1.VolumeAttributesClass> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * VolumeAttributesClassList is a collection of VolumeAttributesClass objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VolumeAttributesClassList is a collection of VolumeAttributesClass objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeError.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeError.java
index f5fcb93cec6..175cfdff0ca 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeError.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeError.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeError captures an error encountered during a volume operation.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public VolumeError(String message, String time) {
         this.time = time;
     }
 
+    /**
+     * String detailing the error encountered during Attach or Detach operation. This string may be logged, so it should not contain sensitive information.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * String detailing the error encountered during Attach or Detach operation. This string may be logged, so it should not contain sensitive information.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * VolumeError captures an error encountered during a volume operation.
+     */
     @JsonProperty("time")
     public String getTime() {
         return time;
     }
 
+    /**
+     * VolumeError captures an error encountered during a volume operation.
+     */
     @JsonProperty("time")
     public void setTime(String time) {
         this.time = time;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeNodeResources.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeNodeResources.java
index d7cd6b0a749..77163489625 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeNodeResources.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storage/v1beta1/VolumeNodeResources.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VolumeNodeResources is a set of resource limits for scheduling of volumes.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public VolumeNodeResources(Integer count) {
         this.count = count;
     }
 
+    /**
+     * Maximum number of unique volumes managed by the CSI driver that can be used on a node. A volume that is both attached and mounted on a node is considered to be used once, not twice. The same rule applies for a unique volume that is shared among multiple pods on the same node. If this field is nil, then the supported number of volumes on this node is unbounded.
+     */
     @JsonProperty("count")
     public Integer getCount() {
         return count;
     }
 
+    /**
+     * Maximum number of unique volumes managed by the CSI driver that can be used on a node. A volume that is both attached and mounted on a node is considered to be used once, not twice. The same rule applies for a unique volume that is shared among multiple pods on the same node. If this field is nil, then the supported number of volumes on this node is unbounded.
+     */
     @JsonProperty("count")
     public void setCount(Integer count) {
         this.count = count;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storagemigration/v1alpha1/GroupVersionResource.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storagemigration/v1alpha1/GroupVersionResource.java
index 79efed03b88..9082bbdfa6e 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storagemigration/v1alpha1/GroupVersionResource.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storagemigration/v1alpha1/GroupVersionResource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * The names of the group, the version, and the resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public GroupVersionResource(String group, String resource, String version) {
         this.version = version;
     }
 
+    /**
+     * The name of the group.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * The name of the group.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * The name of the resource.
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * The name of the resource.
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
     }
 
+    /**
+     * The name of the version.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * The name of the version.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storagemigration/v1alpha1/MigrationCondition.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storagemigration/v1alpha1/MigrationCondition.java
index 6ff608a33b6..c7c0963a074 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storagemigration/v1alpha1/MigrationCondition.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storagemigration/v1alpha1/MigrationCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Describes the state of a migration at a certain point.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public MigrationCondition(String lastUpdateTime, String message, String reason,
         this.type = type;
     }
 
+    /**
+     * Describes the state of a migration at a certain point.
+     */
     @JsonProperty("lastUpdateTime")
     public String getLastUpdateTime() {
         return lastUpdateTime;
     }
 
+    /**
+     * Describes the state of a migration at a certain point.
+     */
     @JsonProperty("lastUpdateTime")
     public void setLastUpdateTime(String lastUpdateTime) {
         this.lastUpdateTime = lastUpdateTime;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type of the condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of the condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storagemigration/v1alpha1/StorageVersionMigration.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storagemigration/v1alpha1/StorageVersionMigration.java
index 9ff64623001..df67849f864 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storagemigration/v1alpha1/StorageVersionMigration.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storagemigration/v1alpha1/StorageVersionMigration.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StorageVersionMigration represents a migration of stored data to the latest storage version.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class StorageVersionMigration implements Editable<StorageVersionMigrationBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storagemigration.k8s.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "StorageVersionMigration";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public StorageVersionMigration(String apiVersion, String kind, ObjectMeta metada
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * StorageVersionMigration represents a migration of stored data to the latest storage version.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * StorageVersionMigration represents a migration of stored data to the latest storage version.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * StorageVersionMigration represents a migration of stored data to the latest storage version.
+     */
     @JsonProperty("spec")
     public StorageVersionMigrationSpec getSpec() {
         return spec;
     }
 
+    /**
+     * StorageVersionMigration represents a migration of stored data to the latest storage version.
+     */
     @JsonProperty("spec")
     public void setSpec(StorageVersionMigrationSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * StorageVersionMigration represents a migration of stored data to the latest storage version.
+     */
     @JsonProperty("status")
     public StorageVersionMigrationStatus getStatus() {
         return status;
     }
 
+    /**
+     * StorageVersionMigration represents a migration of stored data to the latest storage version.
+     */
     @JsonProperty("status")
     public void setStatus(StorageVersionMigrationStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storagemigration/v1alpha1/StorageVersionMigrationList.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storagemigration/v1alpha1/StorageVersionMigrationList.java
index 54e1d49f5c8..0b64caa8363 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storagemigration/v1alpha1/StorageVersionMigrationList.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storagemigration/v1alpha1/StorageVersionMigrationList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StorageVersionMigrationList is a collection of storage version migrations.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class StorageVersionMigrationList implements Editable<StorageVersionMigrationListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.storagemigration.v1alpha1.StorageVersionMigration>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "storagemigration.k8s.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.storagemigration.v1alpha1.StorageVersionMigration> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "StorageVersionMigrationList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public StorageVersionMigrationList(String apiVersion, List<io.fabric8.kubernetes
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of StorageVersionMigration
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.storagemigration.v1alpha1.StorageVersionMigration> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of StorageVersionMigration
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.storagemigration.v1alpha1.StorageVersionMigration> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * StorageVersionMigrationList is a collection of storage version migrations.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * StorageVersionMigrationList is a collection of storage version migrations.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storagemigration/v1alpha1/StorageVersionMigrationSpec.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storagemigration/v1alpha1/StorageVersionMigrationSpec.java
index 7669b07fc0e..ca734627abf 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storagemigration/v1alpha1/StorageVersionMigrationSpec.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storagemigration/v1alpha1/StorageVersionMigrationSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Spec of the storage version migration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public StorageVersionMigrationSpec(String continueToken, GroupVersionResource re
         this.resource = resource;
     }
 
+    /**
+     * The token used in the list options to get the next chunk of objects to migrate. When the .status.conditions indicates the migration is "Running", users can use this token to check the progress of the migration.
+     */
     @JsonProperty("continueToken")
     public String getContinueToken() {
         return continueToken;
     }
 
+    /**
+     * The token used in the list options to get the next chunk of objects to migrate. When the .status.conditions indicates the migration is "Running", users can use this token to check the progress of the migration.
+     */
     @JsonProperty("continueToken")
     public void setContinueToken(String continueToken) {
         this.continueToken = continueToken;
     }
 
+    /**
+     * Spec of the storage version migration.
+     */
     @JsonProperty("resource")
     public GroupVersionResource getResource() {
         return resource;
     }
 
+    /**
+     * Spec of the storage version migration.
+     */
     @JsonProperty("resource")
     public void setResource(GroupVersionResource resource) {
         this.resource = resource;
diff --git a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storagemigration/v1alpha1/StorageVersionMigrationStatus.java b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storagemigration/v1alpha1/StorageVersionMigrationStatus.java
index c951ebcf5c5..a731895484f 100644
--- a/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storagemigration/v1alpha1/StorageVersionMigrationStatus.java
+++ b/kubernetes-model-generator/kubernetes-model-storageclass/src/generated/java/io/fabric8/kubernetes/api/model/storagemigration/v1alpha1/StorageVersionMigrationStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Status of the storage version migration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public StorageVersionMigrationStatus(List<MigrationCondition> conditions, String
         this.resourceVersion = resourceVersion;
     }
 
+    /**
+     * The latest available observations of the migration's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MigrationCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * The latest available observations of the migration's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<MigrationCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ResourceVersion to compare with the GC cache for performing the migration. This is the current resource version of given group, version and resource when kube-controller-manager first observes this StorageVersionMigration resource.
+     */
     @JsonProperty("resourceVersion")
     public String getResourceVersion() {
         return resourceVersion;
     }
 
+    /**
+     * ResourceVersion to compare with the GC cache for performing the migration. This is the current resource version of given group, version and resource when kube-controller-manager first observes this StorageVersionMigration resource.
+     */
     @JsonProperty("resourceVersion")
     public void setResourceVersion(String resourceVersion) {
         this.resourceVersion = resourceVersion;
diff --git a/kubernetes-model-generator/openapi/maven-plugin/src/it/kubernetes-model-core/expected/Pod.expected b/kubernetes-model-generator/openapi/maven-plugin/src/it/kubernetes-model-core/expected/Pod.expected
index e0eac66c95c..aad6deca3b9 100644
--- a/kubernetes-model-generator/openapi/maven-plugin/src/it/kubernetes-model-core/expected/Pod.expected
+++ b/kubernetes-model-generator/openapi/maven-plugin/src/it/kubernetes-model-core/expected/Pod.expected
@@ -21,6 +21,9 @@ import lombok.EqualsAndHashCode;
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Pod is a collection of containers that can run on a host. This resource is created by clients and scheduled onto hosts.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -46,14 +49,8 @@ import lombok.experimental.Accessors;
 public class Pod implements Editable<PodBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Pod";
     @JsonProperty("metadata")
@@ -81,7 +78,7 @@ public class Pod implements Editable<PodBuilder>, HasMetadata, Namespaced
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -89,7 +86,7 @@ public class Pod implements Editable<PodBuilder>, HasMetadata, Namespaced
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -97,7 +94,7 @@ public class Pod implements Editable<PodBuilder>, HasMetadata, Namespaced
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -105,38 +102,56 @@ public class Pod implements Editable<PodBuilder>, HasMetadata, Namespaced
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Pod is a collection of containers that can run on a host. This resource is created by clients and scheduled onto hosts.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Pod is a collection of containers that can run on a host. This resource is created by clients and scheduled onto hosts.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Pod is a collection of containers that can run on a host. This resource is created by clients and scheduled onto hosts.
+     */
     @JsonProperty("spec")
     public PodSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Pod is a collection of containers that can run on a host. This resource is created by clients and scheduled onto hosts.
+     */
     @JsonProperty("spec")
     public void setSpec(PodSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Pod is a collection of containers that can run on a host. This resource is created by clients and scheduled onto hosts.
+     */
     @JsonProperty("status")
     public PodStatus getStatus() {
         return status;
     }
 
+    /**
+     * Pod is a collection of containers that can run on a host. This resource is created by clients and scheduled onto hosts.
+     */
     @JsonProperty("status")
     public void setStatus(PodStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openapi/maven-plugin/src/it/kubernetes-model-core/expected/PodList.expected b/kubernetes-model-generator/openapi/maven-plugin/src/it/kubernetes-model-core/expected/PodList.expected
index 5be3837bd60..edaf2f18c68 100644
--- a/kubernetes-model-generator/openapi/maven-plugin/src/it/kubernetes-model-core/expected/PodList.expected
+++ b/kubernetes-model-generator/openapi/maven-plugin/src/it/kubernetes-model-core/expected/PodList.expected
@@ -23,6 +23,9 @@ import lombok.EqualsAndHashCode;
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodList is a list of Pods.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -47,17 +50,11 @@ import lombok.experimental.Accessors;
 public class PodList implements Editable<PodListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.kubernetes.api.model.Pod>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.kubernetes.api.model.Pod> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodList";
     @JsonProperty("metadata")
@@ -80,7 +77,7 @@ public class PodList implements Editable<PodListBuilder>, KubernetesResource, Ku
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -88,26 +85,32 @@ public class PodList implements Editable<PodListBuilder>, KubernetesResource, Ku
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of pods. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.kubernetes.api.model.Pod> getItems() {
         return items;
     }
 
+    /**
+     * List of pods. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.kubernetes.api.model.Pod> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -115,18 +118,24 @@ public class PodList implements Editable<PodListBuilder>, KubernetesResource, Ku
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodList is a list of Pods.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodList is a list of Pods.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openapi/maven-plugin/src/it/kubernetes-model-core/expected/PodSpec.expected b/kubernetes-model-generator/openapi/maven-plugin/src/it/kubernetes-model-core/expected/PodSpec.expected
index b6e2591e567..f83593e1346 100644
--- a/kubernetes-model-generator/openapi/maven-plugin/src/it/kubernetes-model-core/expected/PodSpec.expected
+++ b/kubernetes-model-generator/openapi/maven-plugin/src/it/kubernetes-model-core/expected/PodSpec.expected
@@ -19,6 +19,9 @@ import lombok.EqualsAndHashCode;
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodSpec is a description of a pod.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -220,414 +223,654 @@ public class PodSpec implements Editable<PodSpecBuilder>, KubernetesResource
         this.volumes = volumes;
     }
 
+    /**
+     * Optional duration in seconds the pod may be active on the node relative to StartTime before the system will actively try to mark it failed and kill associated containers. Value must be a positive integer.
+     */
     @JsonProperty("activeDeadlineSeconds")
     public Long getActiveDeadlineSeconds() {
         return activeDeadlineSeconds;
     }
 
+    /**
+     * Optional duration in seconds the pod may be active on the node relative to StartTime before the system will actively try to mark it failed and kill associated containers. Value must be a positive integer.
+     */
     @JsonProperty("activeDeadlineSeconds")
     public void setActiveDeadlineSeconds(Long activeDeadlineSeconds) {
         this.activeDeadlineSeconds = activeDeadlineSeconds;
     }
 
+    /**
+     * PodSpec is a description of a pod.
+     */
     @JsonProperty("affinity")
     public Affinity getAffinity() {
         return affinity;
     }
 
+    /**
+     * PodSpec is a description of a pod.
+     */
     @JsonProperty("affinity")
     public void setAffinity(Affinity affinity) {
         this.affinity = affinity;
     }
 
+    /**
+     * AutomountServiceAccountToken indicates whether a service account token should be automatically mounted.
+     */
     @JsonProperty("automountServiceAccountToken")
     public Boolean getAutomountServiceAccountToken() {
         return automountServiceAccountToken;
     }
 
+    /**
+     * AutomountServiceAccountToken indicates whether a service account token should be automatically mounted.
+     */
     @JsonProperty("automountServiceAccountToken")
     public void setAutomountServiceAccountToken(Boolean automountServiceAccountToken) {
         this.automountServiceAccountToken = automountServiceAccountToken;
     }
 
+    /**
+     * List of containers belonging to the pod. Containers cannot currently be added or removed. There must be at least one container in a Pod. Cannot be updated.
+     */
     @JsonProperty("containers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Container> getContainers() {
         return containers;
     }
 
+    /**
+     * List of containers belonging to the pod. Containers cannot currently be added or removed. There must be at least one container in a Pod. Cannot be updated.
+     */
     @JsonProperty("containers")
     public void setContainers(List<Container> containers) {
         this.containers = containers;
     }
 
+    /**
+     * PodSpec is a description of a pod.
+     */
     @JsonProperty("dnsConfig")
     public PodDNSConfig getDnsConfig() {
         return dnsConfig;
     }
 
+    /**
+     * PodSpec is a description of a pod.
+     */
     @JsonProperty("dnsConfig")
     public void setDnsConfig(PodDNSConfig dnsConfig) {
         this.dnsConfig = dnsConfig;
     }
 
+    /**
+     * Set DNS policy for the pod. Defaults to "ClusterFirst". Valid values are 'ClusterFirstWithHostNet', 'ClusterFirst', 'Default' or 'None'. DNS parameters given in DNSConfig will be merged with the policy selected with DNSPolicy. To have DNS options set along with hostNetwork, you have to specify DNS policy explicitly to 'ClusterFirstWithHostNet'.
+     */
     @JsonProperty("dnsPolicy")
     public String getDnsPolicy() {
         return dnsPolicy;
     }
 
+    /**
+     * Set DNS policy for the pod. Defaults to "ClusterFirst". Valid values are 'ClusterFirstWithHostNet', 'ClusterFirst', 'Default' or 'None'. DNS parameters given in DNSConfig will be merged with the policy selected with DNSPolicy. To have DNS options set along with hostNetwork, you have to specify DNS policy explicitly to 'ClusterFirstWithHostNet'.
+     */
     @JsonProperty("dnsPolicy")
     public void setDnsPolicy(String dnsPolicy) {
         this.dnsPolicy = dnsPolicy;
     }
 
+    /**
+     * EnableServiceLinks indicates whether information about services should be injected into pod's environment variables, matching the syntax of Docker links. Optional: Defaults to true.
+     */
     @JsonProperty("enableServiceLinks")
     public Boolean getEnableServiceLinks() {
         return enableServiceLinks;
     }
 
+    /**
+     * EnableServiceLinks indicates whether information about services should be injected into pod's environment variables, matching the syntax of Docker links. Optional: Defaults to true.
+     */
     @JsonProperty("enableServiceLinks")
     public void setEnableServiceLinks(Boolean enableServiceLinks) {
         this.enableServiceLinks = enableServiceLinks;
     }
 
+    /**
+     * List of ephemeral containers run in this pod. Ephemeral containers may be run in an existing pod to perform user-initiated actions such as debugging. This list cannot be specified when creating a pod, and it cannot be modified by updating the pod spec. In order to add an ephemeral container to an existing pod, use the pod's ephemeralcontainers subresource.
+     */
     @JsonProperty("ephemeralContainers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EphemeralContainer> getEphemeralContainers() {
         return ephemeralContainers;
     }
 
+    /**
+     * List of ephemeral containers run in this pod. Ephemeral containers may be run in an existing pod to perform user-initiated actions such as debugging. This list cannot be specified when creating a pod, and it cannot be modified by updating the pod spec. In order to add an ephemeral container to an existing pod, use the pod's ephemeralcontainers subresource.
+     */
     @JsonProperty("ephemeralContainers")
     public void setEphemeralContainers(List<EphemeralContainer> ephemeralContainers) {
         this.ephemeralContainers = ephemeralContainers;
     }
 
+    /**
+     * HostAliases is an optional list of hosts and IPs that will be injected into the pod's hosts file if specified.
+     */
     @JsonProperty("hostAliases")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HostAlias> getHostAliases() {
         return hostAliases;
     }
 
+    /**
+     * HostAliases is an optional list of hosts and IPs that will be injected into the pod's hosts file if specified.
+     */
     @JsonProperty("hostAliases")
     public void setHostAliases(List<HostAlias> hostAliases) {
         this.hostAliases = hostAliases;
     }
 
+    /**
+     * Use the host's ipc namespace. Optional: Default to false.
+     */
     @JsonProperty("hostIPC")
     public Boolean getHostIPC() {
         return hostIPC;
     }
 
+    /**
+     * Use the host's ipc namespace. Optional: Default to false.
+     */
     @JsonProperty("hostIPC")
     public void setHostIPC(Boolean hostIPC) {
         this.hostIPC = hostIPC;
     }
 
+    /**
+     * Host networking requested for this pod. Use the host's network namespace. If this option is set, the ports that will be used must be specified. Default to false.
+     */
     @JsonProperty("hostNetwork")
     public Boolean getHostNetwork() {
         return hostNetwork;
     }
 
+    /**
+     * Host networking requested for this pod. Use the host's network namespace. If this option is set, the ports that will be used must be specified. Default to false.
+     */
     @JsonProperty("hostNetwork")
     public void setHostNetwork(Boolean hostNetwork) {
         this.hostNetwork = hostNetwork;
     }
 
+    /**
+     * Use the host's pid namespace. Optional: Default to false.
+     */
     @JsonProperty("hostPID")
     public Boolean getHostPID() {
         return hostPID;
     }
 
+    /**
+     * Use the host's pid namespace. Optional: Default to false.
+     */
     @JsonProperty("hostPID")
     public void setHostPID(Boolean hostPID) {
         this.hostPID = hostPID;
     }
 
+    /**
+     * Use the host's user namespace. Optional: Default to true. If set to true or not present, the pod will be run in the host user namespace, useful for when the pod needs a feature only available to the host user namespace, such as loading a kernel module with CAP_SYS_MODULE. When set to false, a new userns is created for the pod. Setting false is useful for mitigating container breakout vulnerabilities even allowing users to run their containers as root without actually having root privileges on the host. This field is alpha-level and is only honored by servers that enable the UserNamespacesSupport feature.
+     */
     @JsonProperty("hostUsers")
     public Boolean getHostUsers() {
         return hostUsers;
     }
 
+    /**
+     * Use the host's user namespace. Optional: Default to true. If set to true or not present, the pod will be run in the host user namespace, useful for when the pod needs a feature only available to the host user namespace, such as loading a kernel module with CAP_SYS_MODULE. When set to false, a new userns is created for the pod. Setting false is useful for mitigating container breakout vulnerabilities even allowing users to run their containers as root without actually having root privileges on the host. This field is alpha-level and is only honored by servers that enable the UserNamespacesSupport feature.
+     */
     @JsonProperty("hostUsers")
     public void setHostUsers(Boolean hostUsers) {
         this.hostUsers = hostUsers;
     }
 
+    /**
+     * Specifies the hostname of the Pod If not specified, the pod's hostname will be set to a system-defined value.
+     */
     @JsonProperty("hostname")
     public String getHostname() {
         return hostname;
     }
 
+    /**
+     * Specifies the hostname of the Pod If not specified, the pod's hostname will be set to a system-defined value.
+     */
     @JsonProperty("hostname")
     public void setHostname(String hostname) {
         this.hostname = hostname;
     }
 
+    /**
+     * ImagePullSecrets is an optional list of references to secrets in the same namespace to use for pulling any of the images used by this PodSpec. If specified, these secrets will be passed to individual puller implementations for them to use. More info: https://kubernetes.io/docs/concepts/containers/images#specifying-imagepullsecrets-on-a-pod
+     */
     @JsonProperty("imagePullSecrets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LocalObjectReference> getImagePullSecrets() {
         return imagePullSecrets;
     }
 
+    /**
+     * ImagePullSecrets is an optional list of references to secrets in the same namespace to use for pulling any of the images used by this PodSpec. If specified, these secrets will be passed to individual puller implementations for them to use. More info: https://kubernetes.io/docs/concepts/containers/images#specifying-imagepullsecrets-on-a-pod
+     */
     @JsonProperty("imagePullSecrets")
     public void setImagePullSecrets(List<LocalObjectReference> imagePullSecrets) {
         this.imagePullSecrets = imagePullSecrets;
     }
 
+    /**
+     * List of initialization containers belonging to the pod. Init containers are executed in order prior to containers being started. If any init container fails, the pod is considered to have failed and is handled according to its restartPolicy. The name for an init container or normal container must be unique among all containers. Init containers may not have Lifecycle actions, Readiness probes, Liveness probes, or Startup probes. The resourceRequirements of an init container are taken into account during scheduling by finding the highest request/limit for each resource type, and then using the max of of that value or the sum of the normal containers. Limits are applied to init containers in a similar fashion. Init containers cannot currently be added or removed. Cannot be updated. More info: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/
+     */
     @JsonProperty("initContainers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Container> getInitContainers() {
         return initContainers;
     }
 
+    /**
+     * List of initialization containers belonging to the pod. Init containers are executed in order prior to containers being started. If any init container fails, the pod is considered to have failed and is handled according to its restartPolicy. The name for an init container or normal container must be unique among all containers. Init containers may not have Lifecycle actions, Readiness probes, Liveness probes, or Startup probes. The resourceRequirements of an init container are taken into account during scheduling by finding the highest request/limit for each resource type, and then using the max of of that value or the sum of the normal containers. Limits are applied to init containers in a similar fashion. Init containers cannot currently be added or removed. Cannot be updated. More info: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/
+     */
     @JsonProperty("initContainers")
     public void setInitContainers(List<Container> initContainers) {
         this.initContainers = initContainers;
     }
 
+    /**
+     * NodeName indicates in which node this pod is scheduled. If empty, this pod is a candidate for scheduling by the scheduler defined in schedulerName. Once this field is set, the kubelet for this node becomes responsible for the lifecycle of this pod. This field should not be used to express a desire for the pod to be scheduled on a specific node. https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/#nodename
+     */
     @JsonProperty("nodeName")
     public String getNodeName() {
         return nodeName;
     }
 
+    /**
+     * NodeName indicates in which node this pod is scheduled. If empty, this pod is a candidate for scheduling by the scheduler defined in schedulerName. Once this field is set, the kubelet for this node becomes responsible for the lifecycle of this pod. This field should not be used to express a desire for the pod to be scheduled on a specific node. https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/#nodename
+     */
     @JsonProperty("nodeName")
     public void setNodeName(String nodeName) {
         this.nodeName = nodeName;
     }
 
+    /**
+     * NodeSelector is a selector which must be true for the pod to fit on a node. Selector which must match a node's labels for the pod to be scheduled on that node. More info: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * NodeSelector is a selector which must be true for the pod to fit on a node. Selector which must match a node's labels for the pod to be scheduled on that node. More info: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * PodSpec is a description of a pod.
+     */
     @JsonProperty("os")
     public PodOS getOs() {
         return os;
     }
 
+    /**
+     * PodSpec is a description of a pod.
+     */
     @JsonProperty("os")
     public void setOs(PodOS os) {
         this.os = os;
     }
 
+    /**
+     * Overhead represents the resource overhead associated with running a pod for a given RuntimeClass. This field will be autopopulated at admission time by the RuntimeClass admission controller. If the RuntimeClass admission controller is enabled, overhead must not be set in Pod create requests. The RuntimeClass admission controller will reject Pod create requests which have the overhead already set. If RuntimeClass is configured and selected in the PodSpec, Overhead will be set to the value defined in the corresponding RuntimeClass, otherwise it will remain unset and treated as zero. More info: https://git.k8s.io/enhancements/keps/sig-node/688-pod-overhead/README.md
+     */
     @JsonProperty("overhead")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Quantity> getOverhead() {
         return overhead;
     }
 
+    /**
+     * Overhead represents the resource overhead associated with running a pod for a given RuntimeClass. This field will be autopopulated at admission time by the RuntimeClass admission controller. If the RuntimeClass admission controller is enabled, overhead must not be set in Pod create requests. The RuntimeClass admission controller will reject Pod create requests which have the overhead already set. If RuntimeClass is configured and selected in the PodSpec, Overhead will be set to the value defined in the corresponding RuntimeClass, otherwise it will remain unset and treated as zero. More info: https://git.k8s.io/enhancements/keps/sig-node/688-pod-overhead/README.md
+     */
     @JsonProperty("overhead")
     public void setOverhead(Map<String, Quantity> overhead) {
         this.overhead = overhead;
     }
 
+    /**
+     * PreemptionPolicy is the Policy for preempting pods with lower priority. One of Never, PreemptLowerPriority. Defaults to PreemptLowerPriority if unset.
+     */
     @JsonProperty("preemptionPolicy")
     public String getPreemptionPolicy() {
         return preemptionPolicy;
     }
 
+    /**
+     * PreemptionPolicy is the Policy for preempting pods with lower priority. One of Never, PreemptLowerPriority. Defaults to PreemptLowerPriority if unset.
+     */
     @JsonProperty("preemptionPolicy")
     public void setPreemptionPolicy(String preemptionPolicy) {
         this.preemptionPolicy = preemptionPolicy;
     }
 
+    /**
+     * The priority value. Various system components use this field to find the priority of the pod. When Priority Admission Controller is enabled, it prevents users from setting this field. The admission controller populates this field from PriorityClassName. The higher the value, the higher the priority.
+     */
     @JsonProperty("priority")
     public Integer getPriority() {
         return priority;
     }
 
+    /**
+     * The priority value. Various system components use this field to find the priority of the pod. When Priority Admission Controller is enabled, it prevents users from setting this field. The admission controller populates this field from PriorityClassName. The higher the value, the higher the priority.
+     */
     @JsonProperty("priority")
     public void setPriority(Integer priority) {
         this.priority = priority;
     }
 
+    /**
+     * If specified, indicates the pod's priority. "system-node-critical" and "system-cluster-critical" are two special keywords which indicate the highest priorities with the former being the highest priority. Any other name must be defined by creating a PriorityClass object with that name. If not specified, the pod priority will be default or zero if there is no default.
+     */
     @JsonProperty("priorityClassName")
     public String getPriorityClassName() {
         return priorityClassName;
     }
 
+    /**
+     * If specified, indicates the pod's priority. "system-node-critical" and "system-cluster-critical" are two special keywords which indicate the highest priorities with the former being the highest priority. Any other name must be defined by creating a PriorityClass object with that name. If not specified, the pod priority will be default or zero if there is no default.
+     */
     @JsonProperty("priorityClassName")
     public void setPriorityClassName(String priorityClassName) {
         this.priorityClassName = priorityClassName;
     }
 
+    /**
+     * If specified, all readiness gates will be evaluated for pod readiness. A pod is ready when all its containers are ready AND all conditions specified in the readiness gates have status equal to "True" More info: https://git.k8s.io/enhancements/keps/sig-network/580-pod-readiness-gates
+     */
     @JsonProperty("readinessGates")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PodReadinessGate> getReadinessGates() {
         return readinessGates;
     }
 
+    /**
+     * If specified, all readiness gates will be evaluated for pod readiness. A pod is ready when all its containers are ready AND all conditions specified in the readiness gates have status equal to "True" More info: https://git.k8s.io/enhancements/keps/sig-network/580-pod-readiness-gates
+     */
     @JsonProperty("readinessGates")
     public void setReadinessGates(List<PodReadinessGate> readinessGates) {
         this.readinessGates = readinessGates;
     }
 
+    /**
+     * ResourceClaims defines which ResourceClaims must be allocated and reserved before the Pod is allowed to start. The resources will be made available to those containers which consume them by name.<br><p> <br><p> This is an alpha field and requires enabling the DynamicResourceAllocation feature gate.<br><p> <br><p> This field is immutable.
+     */
     @JsonProperty("resourceClaims")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PodResourceClaim> getResourceClaims() {
         return resourceClaims;
     }
 
+    /**
+     * ResourceClaims defines which ResourceClaims must be allocated and reserved before the Pod is allowed to start. The resources will be made available to those containers which consume them by name.<br><p> <br><p> This is an alpha field and requires enabling the DynamicResourceAllocation feature gate.<br><p> <br><p> This field is immutable.
+     */
     @JsonProperty("resourceClaims")
     public void setResourceClaims(List<PodResourceClaim> resourceClaims) {
         this.resourceClaims = resourceClaims;
     }
 
+    /**
+     * PodSpec is a description of a pod.
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * PodSpec is a description of a pod.
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * Restart policy for all containers within the pod. One of Always, OnFailure, Never. In some contexts, only a subset of those values may be permitted. Default to Always. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#restart-policy
+     */
     @JsonProperty("restartPolicy")
     public String getRestartPolicy() {
         return restartPolicy;
     }
 
+    /**
+     * Restart policy for all containers within the pod. One of Always, OnFailure, Never. In some contexts, only a subset of those values may be permitted. Default to Always. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#restart-policy
+     */
     @JsonProperty("restartPolicy")
     public void setRestartPolicy(String restartPolicy) {
         this.restartPolicy = restartPolicy;
     }
 
+    /**
+     * RuntimeClassName refers to a RuntimeClass object in the node.k8s.io group, which should be used to run this pod.  If no RuntimeClass resource matches the named class, the pod will not be run. If unset or empty, the "legacy" RuntimeClass will be used, which is an implicit class with an empty definition that uses the default runtime handler. More info: https://git.k8s.io/enhancements/keps/sig-node/585-runtime-class
+     */
     @JsonProperty("runtimeClassName")
     public String getRuntimeClassName() {
         return runtimeClassName;
     }
 
+    /**
+     * RuntimeClassName refers to a RuntimeClass object in the node.k8s.io group, which should be used to run this pod.  If no RuntimeClass resource matches the named class, the pod will not be run. If unset or empty, the "legacy" RuntimeClass will be used, which is an implicit class with an empty definition that uses the default runtime handler. More info: https://git.k8s.io/enhancements/keps/sig-node/585-runtime-class
+     */
     @JsonProperty("runtimeClassName")
     public void setRuntimeClassName(String runtimeClassName) {
         this.runtimeClassName = runtimeClassName;
     }
 
+    /**
+     * If specified, the pod will be dispatched by specified scheduler. If not specified, the pod will be dispatched by default scheduler.
+     */
     @JsonProperty("schedulerName")
     public String getSchedulerName() {
         return schedulerName;
     }
 
+    /**
+     * If specified, the pod will be dispatched by specified scheduler. If not specified, the pod will be dispatched by default scheduler.
+     */
     @JsonProperty("schedulerName")
     public void setSchedulerName(String schedulerName) {
         this.schedulerName = schedulerName;
     }
 
+    /**
+     * SchedulingGates is an opaque list of values that if specified will block scheduling the pod. If schedulingGates is not empty, the pod will stay in the SchedulingGated state and the scheduler will not attempt to schedule the pod.<br><p> <br><p> SchedulingGates can only be set at pod creation time, and be removed only afterwards.
+     */
     @JsonProperty("schedulingGates")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PodSchedulingGate> getSchedulingGates() {
         return schedulingGates;
     }
 
+    /**
+     * SchedulingGates is an opaque list of values that if specified will block scheduling the pod. If schedulingGates is not empty, the pod will stay in the SchedulingGated state and the scheduler will not attempt to schedule the pod.<br><p> <br><p> SchedulingGates can only be set at pod creation time, and be removed only afterwards.
+     */
     @JsonProperty("schedulingGates")
     public void setSchedulingGates(List<PodSchedulingGate> schedulingGates) {
         this.schedulingGates = schedulingGates;
     }
 
+    /**
+     * PodSpec is a description of a pod.
+     */
     @JsonProperty("securityContext")
     public PodSecurityContext getSecurityContext() {
         return securityContext;
     }
 
+    /**
+     * PodSpec is a description of a pod.
+     */
     @JsonProperty("securityContext")
     public void setSecurityContext(PodSecurityContext securityContext) {
         this.securityContext = securityContext;
     }
 
+    /**
+     * DeprecatedServiceAccount is a deprecated alias for ServiceAccountName. Deprecated: Use serviceAccountName instead.
+     */
     @JsonProperty("serviceAccount")
     public String getServiceAccount() {
         return serviceAccount;
     }
 
+    /**
+     * DeprecatedServiceAccount is a deprecated alias for ServiceAccountName. Deprecated: Use serviceAccountName instead.
+     */
     @JsonProperty("serviceAccount")
     public void setServiceAccount(String serviceAccount) {
         this.serviceAccount = serviceAccount;
     }
 
+    /**
+     * ServiceAccountName is the name of the ServiceAccount to use to run this pod. More info: https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * ServiceAccountName is the name of the ServiceAccount to use to run this pod. More info: https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * If true the pod's hostname will be configured as the pod's FQDN, rather than the leaf name (the default). In Linux containers, this means setting the FQDN in the hostname field of the kernel (the nodename field of struct utsname). In Windows containers, this means setting the registry value of hostname for the registry key HKEY_LOCAL_MACHINE\\SYSTEM\\CurrentControlSet\\Services\\Tcpip\\Parameters to FQDN. If a pod does not have FQDN, this has no effect. Default to false.
+     */
     @JsonProperty("setHostnameAsFQDN")
     public Boolean getSetHostnameAsFQDN() {
         return setHostnameAsFQDN;
     }
 
+    /**
+     * If true the pod's hostname will be configured as the pod's FQDN, rather than the leaf name (the default). In Linux containers, this means setting the FQDN in the hostname field of the kernel (the nodename field of struct utsname). In Windows containers, this means setting the registry value of hostname for the registry key HKEY_LOCAL_MACHINE\\SYSTEM\\CurrentControlSet\\Services\\Tcpip\\Parameters to FQDN. If a pod does not have FQDN, this has no effect. Default to false.
+     */
     @JsonProperty("setHostnameAsFQDN")
     public void setSetHostnameAsFQDN(Boolean setHostnameAsFQDN) {
         this.setHostnameAsFQDN = setHostnameAsFQDN;
     }
 
+    /**
+     * Share a single process namespace between all of the containers in a pod. When this is set containers will be able to view and signal processes from other containers in the same pod, and the first process in each container will not be assigned PID 1. HostPID and ShareProcessNamespace cannot both be set. Optional: Default to false.
+     */
     @JsonProperty("shareProcessNamespace")
     public Boolean getShareProcessNamespace() {
         return shareProcessNamespace;
     }
 
+    /**
+     * Share a single process namespace between all of the containers in a pod. When this is set containers will be able to view and signal processes from other containers in the same pod, and the first process in each container will not be assigned PID 1. HostPID and ShareProcessNamespace cannot both be set. Optional: Default to false.
+     */
     @JsonProperty("shareProcessNamespace")
     public void setShareProcessNamespace(Boolean shareProcessNamespace) {
         this.shareProcessNamespace = shareProcessNamespace;
     }
 
+    /**
+     * If specified, the fully qualified Pod hostname will be "&lt;hostname&gt;.&lt;subdomain&gt;.&lt;pod namespace&gt;.svc.&lt;cluster domain&gt;". If not specified, the pod will not have a domainname at all.
+     */
     @JsonProperty("subdomain")
     public String getSubdomain() {
         return subdomain;
     }
 
+    /**
+     * If specified, the fully qualified Pod hostname will be "&lt;hostname&gt;.&lt;subdomain&gt;.&lt;pod namespace&gt;.svc.&lt;cluster domain&gt;". If not specified, the pod will not have a domainname at all.
+     */
     @JsonProperty("subdomain")
     public void setSubdomain(String subdomain) {
         this.subdomain = subdomain;
     }
 
+    /**
+     * Optional duration in seconds the pod needs to terminate gracefully. May be decreased in delete request. Value must be non-negative integer. The value zero indicates stop immediately via the kill signal (no opportunity to shut down). If this value is nil, the default grace period will be used instead. The grace period is the duration in seconds after the processes running in the pod are sent a termination signal and the time when the processes are forcibly halted with a kill signal. Set this value longer than the expected cleanup time for your process. Defaults to 30 seconds.
+     */
     @JsonProperty("terminationGracePeriodSeconds")
     public Long getTerminationGracePeriodSeconds() {
         return terminationGracePeriodSeconds;
     }
 
+    /**
+     * Optional duration in seconds the pod needs to terminate gracefully. May be decreased in delete request. Value must be non-negative integer. The value zero indicates stop immediately via the kill signal (no opportunity to shut down). If this value is nil, the default grace period will be used instead. The grace period is the duration in seconds after the processes running in the pod are sent a termination signal and the time when the processes are forcibly halted with a kill signal. Set this value longer than the expected cleanup time for your process. Defaults to 30 seconds.
+     */
     @JsonProperty("terminationGracePeriodSeconds")
     public void setTerminationGracePeriodSeconds(Long terminationGracePeriodSeconds) {
         this.terminationGracePeriodSeconds = terminationGracePeriodSeconds;
     }
 
+    /**
+     * If specified, the pod's tolerations.
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * If specified, the pod's tolerations.
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
     }
 
+    /**
+     * TopologySpreadConstraints describes how a group of pods ought to spread across topology domains. Scheduler will schedule pods in a way which abides by the constraints. All topologySpreadConstraints are ANDed.
+     */
     @JsonProperty("topologySpreadConstraints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TopologySpreadConstraint> getTopologySpreadConstraints() {
         return topologySpreadConstraints;
     }
 
+    /**
+     * TopologySpreadConstraints describes how a group of pods ought to spread across topology domains. Scheduler will schedule pods in a way which abides by the constraints. All topologySpreadConstraints are ANDed.
+     */
     @JsonProperty("topologySpreadConstraints")
     public void setTopologySpreadConstraints(List<TopologySpreadConstraint> topologySpreadConstraints) {
         this.topologySpreadConstraints = topologySpreadConstraints;
     }
 
+    /**
+     * List of volumes that can be mounted by containers belonging to the pod. More info: https://kubernetes.io/docs/concepts/storage/volumes
+     */
     @JsonProperty("volumes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Volume> getVolumes() {
         return volumes;
     }
 
+    /**
+     * List of volumes that can be mounted by containers belonging to the pod. More info: https://kubernetes.io/docs/concepts/storage/volumes
+     */
     @JsonProperty("volumes")
     public void setVolumes(List<Volume> volumes) {
         this.volumes = volumes;
diff --git a/kubernetes-model-generator/openapi/maven-plugin/src/it/kubernetes-model-core/expected/PodStatus.expected b/kubernetes-model-generator/openapi/maven-plugin/src/it/kubernetes-model-core/expected/PodStatus.expected
index 9cc5e3f1aae..f4df3a0f915 100644
--- a/kubernetes-model-generator/openapi/maven-plugin/src/it/kubernetes-model-core/expected/PodStatus.expected
+++ b/kubernetes-model-generator/openapi/maven-plugin/src/it/kubernetes-model-core/expected/PodStatus.expected
@@ -19,6 +19,9 @@ import lombok.EqualsAndHashCode;
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodStatus represents information about the status of a pod. Status may trail the actual state of a system, especially if the node that hosts the pod cannot contact the control plane.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -118,168 +121,264 @@ public class PodStatus implements Editable<PodStatusBuilder>, KubernetesResource
         this.startTime = startTime;
     }
 
+    /**
+     * Current service state of pod. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-conditions
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PodCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Current service state of pod. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-conditions
+     */
     @JsonProperty("conditions")
     public void setConditions(List<PodCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Statuses of containers in this pod. Each container in the pod should have at most one status in this list, and all statuses should be for containers in the pod. However this is not enforced. If a status for a non-existent container is present in the list, or the list has duplicate names, the behavior of various Kubernetes components is not defined and those statuses might be ignored. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-and-container-status
+     */
     @JsonProperty("containerStatuses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ContainerStatus> getContainerStatuses() {
         return containerStatuses;
     }
 
+    /**
+     * Statuses of containers in this pod. Each container in the pod should have at most one status in this list, and all statuses should be for containers in the pod. However this is not enforced. If a status for a non-existent container is present in the list, or the list has duplicate names, the behavior of various Kubernetes components is not defined and those statuses might be ignored. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-and-container-status
+     */
     @JsonProperty("containerStatuses")
     public void setContainerStatuses(List<ContainerStatus> containerStatuses) {
         this.containerStatuses = containerStatuses;
     }
 
+    /**
+     * Statuses for any ephemeral containers that have run in this pod. Each ephemeral container in the pod should have at most one status in this list, and all statuses should be for containers in the pod. However this is not enforced. If a status for a non-existent container is present in the list, or the list has duplicate names, the behavior of various Kubernetes components is not defined and those statuses might be ignored. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-and-container-status
+     */
     @JsonProperty("ephemeralContainerStatuses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ContainerStatus> getEphemeralContainerStatuses() {
         return ephemeralContainerStatuses;
     }
 
+    /**
+     * Statuses for any ephemeral containers that have run in this pod. Each ephemeral container in the pod should have at most one status in this list, and all statuses should be for containers in the pod. However this is not enforced. If a status for a non-existent container is present in the list, or the list has duplicate names, the behavior of various Kubernetes components is not defined and those statuses might be ignored. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-and-container-status
+     */
     @JsonProperty("ephemeralContainerStatuses")
     public void setEphemeralContainerStatuses(List<ContainerStatus> ephemeralContainerStatuses) {
         this.ephemeralContainerStatuses = ephemeralContainerStatuses;
     }
 
+    /**
+     * hostIP holds the IP address of the host to which the pod is assigned. Empty if the pod has not started yet. A pod can be assigned to a node that has a problem in kubelet which in turns mean that HostIP will not be updated even if there is a node is assigned to pod
+     */
     @JsonProperty("hostIP")
     public String getHostIP() {
         return hostIP;
     }
 
+    /**
+     * hostIP holds the IP address of the host to which the pod is assigned. Empty if the pod has not started yet. A pod can be assigned to a node that has a problem in kubelet which in turns mean that HostIP will not be updated even if there is a node is assigned to pod
+     */
     @JsonProperty("hostIP")
     public void setHostIP(String hostIP) {
         this.hostIP = hostIP;
     }
 
+    /**
+     * hostIPs holds the IP addresses allocated to the host. If this field is specified, the first entry must match the hostIP field. This list is empty if the pod has not started yet. A pod can be assigned to a node that has a problem in kubelet which in turns means that HostIPs will not be updated even if there is a node is assigned to this pod.
+     */
     @JsonProperty("hostIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HostIP> getHostIPs() {
         return hostIPs;
     }
 
+    /**
+     * hostIPs holds the IP addresses allocated to the host. If this field is specified, the first entry must match the hostIP field. This list is empty if the pod has not started yet. A pod can be assigned to a node that has a problem in kubelet which in turns means that HostIPs will not be updated even if there is a node is assigned to this pod.
+     */
     @JsonProperty("hostIPs")
     public void setHostIPs(List<HostIP> hostIPs) {
         this.hostIPs = hostIPs;
     }
 
+    /**
+     * Statuses of init containers in this pod. The most recent successful non-restartable init container will have ready = true, the most recently started container will have startTime set. Each init container in the pod should have at most one status in this list, and all statuses should be for containers in the pod. However this is not enforced. If a status for a non-existent container is present in the list, or the list has duplicate names, the behavior of various Kubernetes components is not defined and those statuses might be ignored. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#pod-and-container-status
+     */
     @JsonProperty("initContainerStatuses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ContainerStatus> getInitContainerStatuses() {
         return initContainerStatuses;
     }
 
+    /**
+     * Statuses of init containers in this pod. The most recent successful non-restartable init container will have ready = true, the most recently started container will have startTime set. Each init container in the pod should have at most one status in this list, and all statuses should be for containers in the pod. However this is not enforced. If a status for a non-existent container is present in the list, or the list has duplicate names, the behavior of various Kubernetes components is not defined and those statuses might be ignored. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#pod-and-container-status
+     */
     @JsonProperty("initContainerStatuses")
     public void setInitContainerStatuses(List<ContainerStatus> initContainerStatuses) {
         this.initContainerStatuses = initContainerStatuses;
     }
 
+    /**
+     * A human readable message indicating details about why the pod is in this condition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * A human readable message indicating details about why the pod is in this condition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * nominatedNodeName is set only when this pod preempts other pods on the node, but it cannot be scheduled right away as preemption victims receive their graceful termination periods. This field does not guarantee that the pod will be scheduled on this node. Scheduler may decide to place the pod elsewhere if other nodes become available sooner. Scheduler may also decide to give the resources on this node to a higher priority pod that is created after preemption. As a result, this field may be different than PodSpec.nodeName when the pod is scheduled.
+     */
     @JsonProperty("nominatedNodeName")
     public String getNominatedNodeName() {
         return nominatedNodeName;
     }
 
+    /**
+     * nominatedNodeName is set only when this pod preempts other pods on the node, but it cannot be scheduled right away as preemption victims receive their graceful termination periods. This field does not guarantee that the pod will be scheduled on this node. Scheduler may decide to place the pod elsewhere if other nodes become available sooner. Scheduler may also decide to give the resources on this node to a higher priority pod that is created after preemption. As a result, this field may be different than PodSpec.nodeName when the pod is scheduled.
+     */
     @JsonProperty("nominatedNodeName")
     public void setNominatedNodeName(String nominatedNodeName) {
         this.nominatedNodeName = nominatedNodeName;
     }
 
+    /**
+     * The phase of a Pod is a simple, high-level summary of where the Pod is in its lifecycle. The conditions array, the reason and message fields, and the individual container status arrays contain more detail about the pod's status. There are five possible phase values:<br><p> <br><p> Pending: The pod has been accepted by the Kubernetes system, but one or more of the container images has not been created. This includes time before being scheduled as well as time spent downloading images over the network, which could take a while. Running: The pod has been bound to a node, and all of the containers have been created. At least one container is still running, or is in the process of starting or restarting. Succeeded: All containers in the pod have terminated in success, and will not be restarted. Failed: All containers in the pod have terminated, and at least one container has terminated in failure. The container either exited with non-zero status or was terminated by the system. Unknown: For some reason the state of the pod could not be obtained, typically due to an error in communicating with the host of the pod.<br><p> <br><p> More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-phase
+     */
     @JsonProperty("phase")
     public String getPhase() {
         return phase;
     }
 
+    /**
+     * The phase of a Pod is a simple, high-level summary of where the Pod is in its lifecycle. The conditions array, the reason and message fields, and the individual container status arrays contain more detail about the pod's status. There are five possible phase values:<br><p> <br><p> Pending: The pod has been accepted by the Kubernetes system, but one or more of the container images has not been created. This includes time before being scheduled as well as time spent downloading images over the network, which could take a while. Running: The pod has been bound to a node, and all of the containers have been created. At least one container is still running, or is in the process of starting or restarting. Succeeded: All containers in the pod have terminated in success, and will not be restarted. Failed: All containers in the pod have terminated, and at least one container has terminated in failure. The container either exited with non-zero status or was terminated by the system. Unknown: For some reason the state of the pod could not be obtained, typically due to an error in communicating with the host of the pod.<br><p> <br><p> More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-phase
+     */
     @JsonProperty("phase")
     public void setPhase(String phase) {
         this.phase = phase;
     }
 
+    /**
+     * podIP address allocated to the pod. Routable at least within the cluster. Empty if not yet allocated.
+     */
     @JsonProperty("podIP")
     public String getPodIP() {
         return podIP;
     }
 
+    /**
+     * podIP address allocated to the pod. Routable at least within the cluster. Empty if not yet allocated.
+     */
     @JsonProperty("podIP")
     public void setPodIP(String podIP) {
         this.podIP = podIP;
     }
 
+    /**
+     * podIPs holds the IP addresses allocated to the pod. If this field is specified, the 0th entry must match the podIP field. Pods may be allocated at most 1 value for each of IPv4 and IPv6. This list is empty if no IPs have been allocated yet.
+     */
     @JsonProperty("podIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PodIP> getPodIPs() {
         return podIPs;
     }
 
+    /**
+     * podIPs holds the IP addresses allocated to the pod. If this field is specified, the 0th entry must match the podIP field. Pods may be allocated at most 1 value for each of IPv4 and IPv6. This list is empty if no IPs have been allocated yet.
+     */
     @JsonProperty("podIPs")
     public void setPodIPs(List<PodIP> podIPs) {
         this.podIPs = podIPs;
     }
 
+    /**
+     * The Quality of Service (QOS) classification assigned to the pod based on resource requirements See PodQOSClass type for available QOS classes More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-qos/#quality-of-service-classes
+     */
     @JsonProperty("qosClass")
     public String getQosClass() {
         return qosClass;
     }
 
+    /**
+     * The Quality of Service (QOS) classification assigned to the pod based on resource requirements See PodQOSClass type for available QOS classes More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-qos/#quality-of-service-classes
+     */
     @JsonProperty("qosClass")
     public void setQosClass(String qosClass) {
         this.qosClass = qosClass;
     }
 
+    /**
+     * A brief CamelCase message indicating details about why the pod is in this state. e.g. 'Evicted'
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * A brief CamelCase message indicating details about why the pod is in this state. e.g. 'Evicted'
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of resources resize desired for pod's containers. It is empty if no resources resize is pending. Any changes to container resources will automatically set this to "Proposed"
+     */
     @JsonProperty("resize")
     public String getResize() {
         return resize;
     }
 
+    /**
+     * Status of resources resize desired for pod's containers. It is empty if no resources resize is pending. Any changes to container resources will automatically set this to "Proposed"
+     */
     @JsonProperty("resize")
     public void setResize(String resize) {
         this.resize = resize;
     }
 
+    /**
+     * Status of resource claims.
+     */
     @JsonProperty("resourceClaimStatuses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PodResourceClaimStatus> getResourceClaimStatuses() {
         return resourceClaimStatuses;
     }
 
+    /**
+     * Status of resource claims.
+     */
     @JsonProperty("resourceClaimStatuses")
     public void setResourceClaimStatuses(List<PodResourceClaimStatus> resourceClaimStatuses) {
         this.resourceClaimStatuses = resourceClaimStatuses;
     }
 
+    /**
+     * PodStatus represents information about the status of a pod. Status may trail the actual state of a system, especially if the node that hosts the pod cannot contact the control plane.
+     */
     @JsonProperty("startTime")
     public String getStartTime() {
         return startTime;
     }
 
+    /**
+     * PodStatus represents information about the status of a pod. Status may trail the actual state of a system, especially if the node that hosts the pod cannot contact the control plane.
+     */
     @JsonProperty("startTime")
     public void setStartTime(String startTime) {
         this.startTime = startTime;
diff --git a/kubernetes-model-generator/openapi/maven-plugin/src/it/kubernetes-model-core/expected/PodTemplate.expected b/kubernetes-model-generator/openapi/maven-plugin/src/it/kubernetes-model-core/expected/PodTemplate.expected
index 9f1d25dae7b..e6f82812eb3 100644
--- a/kubernetes-model-generator/openapi/maven-plugin/src/it/kubernetes-model-core/expected/PodTemplate.expected
+++ b/kubernetes-model-generator/openapi/maven-plugin/src/it/kubernetes-model-core/expected/PodTemplate.expected
@@ -21,6 +21,9 @@ import lombok.EqualsAndHashCode;
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodTemplate describes a template for creating copies of a predefined pod.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -45,14 +48,8 @@ import lombok.experimental.Accessors;
 public class PodTemplate implements Editable<PodTemplateBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodTemplate";
     @JsonProperty("metadata")
@@ -77,7 +74,7 @@ public class PodTemplate implements Editable<PodTemplateBuilder>, HasMetadata, N
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -85,7 +82,7 @@ public class PodTemplate implements Editable<PodTemplateBuilder>, HasMetadata, N
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -93,7 +90,7 @@ public class PodTemplate implements Editable<PodTemplateBuilder>, HasMetadata, N
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -101,28 +98,40 @@ public class PodTemplate implements Editable<PodTemplateBuilder>, HasMetadata, N
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodTemplate describes a template for creating copies of a predefined pod.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodTemplate describes a template for creating copies of a predefined pod.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PodTemplate describes a template for creating copies of a predefined pod.
+     */
     @JsonProperty("template")
     public PodTemplateSpec getTemplate() {
         return template;
     }
 
+    /**
+     * PodTemplate describes a template for creating copies of a predefined pod.
+     */
     @JsonProperty("template")
     public void setTemplate(PodTemplateSpec template) {
         this.template = template;
diff --git a/kubernetes-model-generator/openapi/maven-plugin/src/it/kubernetes-model-core/expected/WatchEvent.expected b/kubernetes-model-generator/openapi/maven-plugin/src/it/kubernetes-model-core/expected/WatchEvent.expected
index bb8c562f6c8..899a7f1de05 100644
--- a/kubernetes-model-generator/openapi/maven-plugin/src/it/kubernetes-model-core/expected/WatchEvent.expected
+++ b/kubernetes-model-generator/openapi/maven-plugin/src/it/kubernetes-model-core/expected/WatchEvent.expected
@@ -17,6 +17,9 @@ import lombok.EqualsAndHashCode;
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Event represents a single event to a watched resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -54,22 +57,34 @@ public class WatchEvent implements Editable<WatchEventBuilder>, KubernetesResour
         this.type = type;
     }
 
+    /**
+     * Event represents a single event to a watched resource.
+     */
     @JsonProperty("object")
     public Object getObject() {
         return object;
     }
 
+    /**
+     * Event represents a single event to a watched resource.
+     */
     @JsonProperty("object")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setObject(Object object) {
         this.object = object;
     }
 
+    /**
+     * Event represents a single event to a watched resource.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Event represents a single event to a watched resource.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openapi/maven-plugin/src/it/kubernetes-model-core/pom.xml b/kubernetes-model-generator/openapi/maven-plugin/src/it/kubernetes-model-core/pom.xml
index b81307d8601..8dc9487626b 100644
--- a/kubernetes-model-generator/openapi/maven-plugin/src/it/kubernetes-model-core/pom.xml
+++ b/kubernetes-model-generator/openapi/maven-plugin/src/it/kubernetes-model-core/pom.xml
@@ -55,7 +55,7 @@
             <packageName>io.fabric8.kubernetes.api.model</packageName>
             <builderPackage>io.fabric8.kubernetes.api.builder</builderPackage>
             <addBuildableReferences>false</addBuildableReferences>
-            <generateJavadoc>false</generateJavadoc>
+            <generateJavadoc>true</generateJavadoc>
             <packageMappings>
               <io.k8s.api.core.v1>io.fabric8.kubernetes.api.model</io.k8s.api.core.v1>
               <io.k8s.apimachinery.pkg>io.fabric8.kubernetes.api.model</io.k8s.apimachinery.pkg>
diff --git a/kubernetes-model-generator/openapi/maven-plugin/src/main/java/io/fabric8/kubernetes/schema/generator/model/ModelGenerator.java b/kubernetes-model-generator/openapi/maven-plugin/src/main/java/io/fabric8/kubernetes/schema/generator/model/ModelGenerator.java
index b0f4d4f64c8..febc7439643 100644
--- a/kubernetes-model-generator/openapi/maven-plugin/src/main/java/io/fabric8/kubernetes/schema/generator/model/ModelGenerator.java
+++ b/kubernetes-model-generator/openapi/maven-plugin/src/main/java/io/fabric8/kubernetes/schema/generator/model/ModelGenerator.java
@@ -149,8 +149,7 @@ private void processTemplate(TemplateContext ret) {
       ret.put("lombokAccessors", true);
     }
     ret.put("package", ret.getPackageName());
-    if (settings.isGenerateJavadoc()) {
-      ret.put("hasDescription", !sanitizeDescription(ret.getClassSchema().getDescription()).trim().isEmpty());
+    if (settings.isGenerateJavadoc() && !sanitizeDescription(ret.getClassSchema().getDescription()).trim().isEmpty()) {
       ret.put("description", sanitizeDescription(ret.getClassSchema().getDescription()));
     }
     final List<Map<String, Object>> templateFields = templateFields(ret);
@@ -195,10 +194,9 @@ private List<Map<String, Object>> templateFields(TemplateContext templateContext
       templateProp.put("setterName", setterName(property.getKey()));
       if (Optional.ofNullable(templateContext.getClassSchema().getRequired()).orElse(Collections.emptyList())
           .contains(property.getKey())) {
-        templateProp.put("required", true);
+        // templateProp.put("required", true); // TODO: enable when we can use a standard @Required annotation
       }
-      if (settings.isGenerateJavadoc()) {
-        templateProp.put("hasDescription", !sanitizeDescription(propertySchema.getDescription()).trim().isEmpty());
+      if (settings.isGenerateJavadoc() && !sanitizeDescription(propertySchema.getDescription()).trim().isEmpty()) {
         templateProp.put("description", sanitizeDescription(propertySchema.getDescription()));
       }
       final String serializeUsing = serializerForSchema(propertySchema);
@@ -228,12 +226,10 @@ private List<Map<String, Object>> templateFields(TemplateContext templateContext
       } else if (Objects.equals(property.getKey(), "kind")
           && Objects.equals(type, "String")
           && templateContext.getApiVersion() != null) {
-        templateProp.put("legacyRequired", true); // TODO: remove after generator migration
         templateProp.put("defaultValue", String.format("\"%s\"", templateContext.getClassInformation().getClassSimpleName()));
       } else if (Objects.equals(property.getKey(), "apiVersion")
           && Objects.equals(type, "String")
           && templateContext.getApiVersion() != null) {
-        templateProp.put("legacyRequired", true); // TODO: remove after generator migration
         templateProp.put("defaultValue", String.format("\"%s\"", templateContext.getApiVersion()));
       }
       // TODO: remove after generator migration, match jsonschema2pojo generation for items
diff --git a/kubernetes-model-generator/openapi/maven-plugin/src/main/resources/templates/model.mustache b/kubernetes-model-generator/openapi/maven-plugin/src/main/resources/templates/model.mustache
index 18d761773b4..b052701c211 100644
--- a/kubernetes-model-generator/openapi/maven-plugin/src/main/resources/templates/model.mustache
+++ b/kubernetes-model-generator/openapi/maven-plugin/src/main/resources/templates/model.mustache
@@ -20,10 +20,11 @@ package {{package}};
 {{#imports}}
 import {{.}};
 {{/imports}}
-{{#hasDescription}}
+{{#description}}
+
 /**
- * {{description}}
- */{{/hasDescription}}
+ * {{.}}
+ */{{/description}}
 {{> model_class_annotations}}public {{classInformation.classType}} {{classInformation.classSimpleName}} {{classInformation.implementsExtends}}
 {
 {{>model_enum_body}}
diff --git a/kubernetes-model-generator/openapi/maven-plugin/src/main/resources/templates/model_fields.mustache b/kubernetes-model-generator/openapi/maven-plugin/src/main/resources/templates/model_fields.mustache
index fcf91ca9e3e..6bb295818f3 100644
--- a/kubernetes-model-generator/openapi/maven-plugin/src/main/resources/templates/model_fields.mustache
+++ b/kubernetes-model-generator/openapi/maven-plugin/src/main/resources/templates/model_fields.mustache
@@ -14,17 +14,7 @@
     limitations under the License.
 }}
 {{#fields}}
-{{#hasDescription}}
-    /**
-     * {{description}}
-     */
-{{/hasDescription}}
 {{#required}}{{/required}}
-{{#legacyRequired}}
-    /**
-     * (Required)
-     */
-{{/legacyRequired}}
     @JsonProperty("{{propertyName}}")
 {{#serializeUsing}}
     @JsonSerialize(using = {{.}})
diff --git a/kubernetes-model-generator/openapi/maven-plugin/src/main/resources/templates/model_methods.mustache b/kubernetes-model-generator/openapi/maven-plugin/src/main/resources/templates/model_methods.mustache
index 97bed3b7d1a..192af29864e 100644
--- a/kubernetes-model-generator/openapi/maven-plugin/src/main/resources/templates/model_methods.mustache
+++ b/kubernetes-model-generator/openapi/maven-plugin/src/main/resources/templates/model_methods.mustache
@@ -14,11 +14,11 @@
     limitations under the License.
 }}
 {{#fields}}
-{{#legacyRequired}}
+{{#description}}
     /**
-     * (Required)
+     * {{.}}
      */
-{{/legacyRequired}}
+{{/description}}
     @JsonProperty("{{propertyName}}")
 {{#jsonInclude}}
     @JsonInclude(JsonInclude.Include.{{.}})
@@ -30,11 +30,11 @@
         return {{name}};
     }
 
-{{#legacyRequired}}
+{{#description}}
     /**
-     * (Required)
+     * {{.}}
      */
-{{/legacyRequired}}
+{{/description}}
     @JsonProperty("{{propertyName}}")
 {{#deserializeUsing}}
     @JsonDeserialize(using = {{.}})
diff --git a/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscaler.java b/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscaler.java
index 3027978b8d5..16694bf5ac2 100644
--- a/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscaler.java
+++ b/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscaler.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterAutoscaler is the Schema for the clusterautoscalers API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ClusterAutoscaler implements Editable<ClusterAutoscalerBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterAutoscaler";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterAutoscaler(String apiVersion, String kind, ObjectMeta metadata, Cl
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterAutoscaler is the Schema for the clusterautoscalers API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterAutoscaler is the Schema for the clusterautoscalers API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ClusterAutoscaler is the Schema for the clusterautoscalers API
+     */
     @JsonProperty("spec")
     public ClusterAutoscalerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ClusterAutoscaler is the Schema for the clusterautoscalers API
+     */
     @JsonProperty("spec")
     public void setSpec(ClusterAutoscalerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Most recently observed status of ClusterAutoscaler resource
+     */
     @JsonProperty("status")
     public Object getStatus() {
         return status;
     }
 
+    /**
+     * Most recently observed status of ClusterAutoscaler resource
+     */
     @JsonProperty("status")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setStatus(Object status) {
diff --git a/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscalerList.java b/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscalerList.java
index 05b0621afc8..7578a20ce77 100644
--- a/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscalerList.java
+++ b/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscalerList.java
@@ -78,17 +78,11 @@
 public class ClusterAutoscalerList implements Editable<ClusterAutoscalerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.autoscaling.v1.ClusterAutoscaler>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.autoscaling.v1.ClusterAutoscaler> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterAutoscalerList";
     @JsonProperty("metadata")
@@ -110,17 +104,11 @@ public ClusterAutoscalerList(String apiVersion, List<io.fabric8.openshift.api.mo
         this.metadata = metadata;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
@@ -137,17 +125,11 @@ public void setItems(List<io.fabric8.openshift.api.model.autoscaling.v1.ClusterA
         this.items = items;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscalerSpec.java b/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscalerSpec.java
index d440aa0aad7..48b932cd705 100644
--- a/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscalerSpec.java
+++ b/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscalerSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Desired state of ClusterAutoscaler resource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -122,113 +125,179 @@ public ClusterAutoscalerSpec(Boolean balanceSimilarNodeGroups, List<String> bala
         this.skipNodesWithLocalStorage = skipNodesWithLocalStorage;
     }
 
+    /**
+     * BalanceSimilarNodeGroups enables/disables the `--balance-similar-node-groups` cluster-autoscaler feature. This feature will automatically identify node groups with the same instance type and the same set of labels and try to keep the respective sizes of those node groups balanced.
+     */
     @JsonProperty("balanceSimilarNodeGroups")
     public Boolean getBalanceSimilarNodeGroups() {
         return balanceSimilarNodeGroups;
     }
 
+    /**
+     * BalanceSimilarNodeGroups enables/disables the `--balance-similar-node-groups` cluster-autoscaler feature. This feature will automatically identify node groups with the same instance type and the same set of labels and try to keep the respective sizes of those node groups balanced.
+     */
     @JsonProperty("balanceSimilarNodeGroups")
     public void setBalanceSimilarNodeGroups(Boolean balanceSimilarNodeGroups) {
         this.balanceSimilarNodeGroups = balanceSimilarNodeGroups;
     }
 
+    /**
+     * BalancingIgnoredLabels sets "--balancing-ignore-label &lt;label name&gt;" flag on cluster-autoscaler for each listed label. This option specifies labels that cluster autoscaler should ignore when considering node group similarity. For example, if you have nodes with "topology.ebs.csi.aws.com/zone" label, you can add name of this label here to prevent cluster autoscaler from spliting nodes into different node groups based on its value.
+     */
     @JsonProperty("balancingIgnoredLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getBalancingIgnoredLabels() {
         return balancingIgnoredLabels;
     }
 
+    /**
+     * BalancingIgnoredLabels sets "--balancing-ignore-label &lt;label name&gt;" flag on cluster-autoscaler for each listed label. This option specifies labels that cluster autoscaler should ignore when considering node group similarity. For example, if you have nodes with "topology.ebs.csi.aws.com/zone" label, you can add name of this label here to prevent cluster autoscaler from spliting nodes into different node groups based on its value.
+     */
     @JsonProperty("balancingIgnoredLabels")
     public void setBalancingIgnoredLabels(List<String> balancingIgnoredLabels) {
         this.balancingIgnoredLabels = balancingIgnoredLabels;
     }
 
+    /**
+     * Sets the type and order of expanders to be used during scale out operations. This option specifies an ordered list, highest priority first, of expanders that will be used by the cluster autoscaler to select node groups for expansion when scaling out. Expanders instruct the autoscaler on how to choose node groups when scaling out the cluster. They can be specified in order so that the result from the first expander is used as the input to the second, and so forth. For example, if set to `[LeastWaste, Random]` the autoscaler will first evaluate node groups to determine which will have the least resource waste, if multiple groups are selected the autoscaler will then randomly choose between those groups to determine the group for scaling. The following expanders are available: &#42; LeastWaste - selects the node group that will have the least idle CPU (if tied, unused memory) after scale-up. &#42; Priority - selects the node group that has the highest priority assigned by the user. For details, please see https://github.com/openshift/kubernetes-autoscaler/blob/master/cluster-autoscaler/expander/priority/readme.md &#42; Random - selects the node group randomly. If not specified, the default value is `Random`, available options are: `LeastWaste`, `Priority`, `Random`.
+     */
     @JsonProperty("expanders")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getExpanders() {
         return expanders;
     }
 
+    /**
+     * Sets the type and order of expanders to be used during scale out operations. This option specifies an ordered list, highest priority first, of expanders that will be used by the cluster autoscaler to select node groups for expansion when scaling out. Expanders instruct the autoscaler on how to choose node groups when scaling out the cluster. They can be specified in order so that the result from the first expander is used as the input to the second, and so forth. For example, if set to `[LeastWaste, Random]` the autoscaler will first evaluate node groups to determine which will have the least resource waste, if multiple groups are selected the autoscaler will then randomly choose between those groups to determine the group for scaling. The following expanders are available: &#42; LeastWaste - selects the node group that will have the least idle CPU (if tied, unused memory) after scale-up. &#42; Priority - selects the node group that has the highest priority assigned by the user. For details, please see https://github.com/openshift/kubernetes-autoscaler/blob/master/cluster-autoscaler/expander/priority/readme.md &#42; Random - selects the node group randomly. If not specified, the default value is `Random`, available options are: `LeastWaste`, `Priority`, `Random`.
+     */
     @JsonProperty("expanders")
     public void setExpanders(List<String> expanders) {
         this.expanders = expanders;
     }
 
+    /**
+     * Enables/Disables `--ignore-daemonsets-utilization` CA feature flag. Should CA ignore DaemonSet pods when calculating resource utilization for scaling down. false by default
+     */
     @JsonProperty("ignoreDaemonsetsUtilization")
     public Boolean getIgnoreDaemonsetsUtilization() {
         return ignoreDaemonsetsUtilization;
     }
 
+    /**
+     * Enables/Disables `--ignore-daemonsets-utilization` CA feature flag. Should CA ignore DaemonSet pods when calculating resource utilization for scaling down. false by default
+     */
     @JsonProperty("ignoreDaemonsetsUtilization")
     public void setIgnoreDaemonsetsUtilization(Boolean ignoreDaemonsetsUtilization) {
         this.ignoreDaemonsetsUtilization = ignoreDaemonsetsUtilization;
     }
 
+    /**
+     * Sets the autoscaler log level. Default value is 1, level 4 is recommended for DEBUGGING and level 6 will enable almost everything. <br><p>  This option has priority over log level set by the `CLUSTER_AUTOSCALER_VERBOSITY` environment variable.
+     */
     @JsonProperty("logVerbosity")
     public Integer getLogVerbosity() {
         return logVerbosity;
     }
 
+    /**
+     * Sets the autoscaler log level. Default value is 1, level 4 is recommended for DEBUGGING and level 6 will enable almost everything. <br><p>  This option has priority over log level set by the `CLUSTER_AUTOSCALER_VERBOSITY` environment variable.
+     */
     @JsonProperty("logVerbosity")
     public void setLogVerbosity(Integer logVerbosity) {
         this.logVerbosity = logVerbosity;
     }
 
+    /**
+     * Maximum time CA waits for node to be provisioned
+     */
     @JsonProperty("maxNodeProvisionTime")
     public String getMaxNodeProvisionTime() {
         return maxNodeProvisionTime;
     }
 
+    /**
+     * Maximum time CA waits for node to be provisioned
+     */
     @JsonProperty("maxNodeProvisionTime")
     public void setMaxNodeProvisionTime(String maxNodeProvisionTime) {
         this.maxNodeProvisionTime = maxNodeProvisionTime;
     }
 
+    /**
+     * Gives pods graceful termination time before scaling down
+     */
     @JsonProperty("maxPodGracePeriod")
     public Integer getMaxPodGracePeriod() {
         return maxPodGracePeriod;
     }
 
+    /**
+     * Gives pods graceful termination time before scaling down
+     */
     @JsonProperty("maxPodGracePeriod")
     public void setMaxPodGracePeriod(Integer maxPodGracePeriod) {
         this.maxPodGracePeriod = maxPodGracePeriod;
     }
 
+    /**
+     * To allow users to schedule "best-effort" pods, which shouldn't trigger Cluster Autoscaler actions, but only run when there are spare resources available, More info: https://github.com/kubernetes/autoscaler/blob/master/cluster-autoscaler/FAQ.md#how-does-cluster-autoscaler-work-with-pod-priority-and-preemption
+     */
     @JsonProperty("podPriorityThreshold")
     public Integer getPodPriorityThreshold() {
         return podPriorityThreshold;
     }
 
+    /**
+     * To allow users to schedule "best-effort" pods, which shouldn't trigger Cluster Autoscaler actions, but only run when there are spare resources available, More info: https://github.com/kubernetes/autoscaler/blob/master/cluster-autoscaler/FAQ.md#how-does-cluster-autoscaler-work-with-pod-priority-and-preemption
+     */
     @JsonProperty("podPriorityThreshold")
     public void setPodPriorityThreshold(Integer podPriorityThreshold) {
         this.podPriorityThreshold = podPriorityThreshold;
     }
 
+    /**
+     * Desired state of ClusterAutoscaler resource
+     */
     @JsonProperty("resourceLimits")
     public ClusterAutoscalerSpecResourceLimits getResourceLimits() {
         return resourceLimits;
     }
 
+    /**
+     * Desired state of ClusterAutoscaler resource
+     */
     @JsonProperty("resourceLimits")
     public void setResourceLimits(ClusterAutoscalerSpecResourceLimits resourceLimits) {
         this.resourceLimits = resourceLimits;
     }
 
+    /**
+     * Desired state of ClusterAutoscaler resource
+     */
     @JsonProperty("scaleDown")
     public ClusterAutoscalerSpecScaleDown getScaleDown() {
         return scaleDown;
     }
 
+    /**
+     * Desired state of ClusterAutoscaler resource
+     */
     @JsonProperty("scaleDown")
     public void setScaleDown(ClusterAutoscalerSpecScaleDown scaleDown) {
         this.scaleDown = scaleDown;
     }
 
+    /**
+     * Enables/Disables `--skip-nodes-with-local-storage` CA feature flag. If true cluster autoscaler will never delete nodes with pods with local storage, e.g. EmptyDir or HostPath. true by default at autoscaler
+     */
     @JsonProperty("skipNodesWithLocalStorage")
     public Boolean getSkipNodesWithLocalStorage() {
         return skipNodesWithLocalStorage;
     }
 
+    /**
+     * Enables/Disables `--skip-nodes-with-local-storage` CA feature flag. If true cluster autoscaler will never delete nodes with pods with local storage, e.g. EmptyDir or HostPath. true by default at autoscaler
+     */
     @JsonProperty("skipNodesWithLocalStorage")
     public void setSkipNodesWithLocalStorage(Boolean skipNodesWithLocalStorage) {
         this.skipNodesWithLocalStorage = skipNodesWithLocalStorage;
diff --git a/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscalerSpecRLCores.java b/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscalerSpecRLCores.java
index cc19ec24fb9..9e7cf48dda1 100644
--- a/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscalerSpecRLCores.java
+++ b/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscalerSpecRLCores.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Minimum and maximum number of cores in cluster, in the format &lt;min&gt;:&lt;max&gt;. Cluster autoscaler will not scale the cluster beyond these numbers.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ClusterAutoscalerSpecRLCores(Integer max, Integer min) {
         this.min = min;
     }
 
+    /**
+     * Minimum and maximum number of cores in cluster, in the format &lt;min&gt;:&lt;max&gt;. Cluster autoscaler will not scale the cluster beyond these numbers.
+     */
     @JsonProperty("max")
     public Integer getMax() {
         return max;
     }
 
+    /**
+     * Minimum and maximum number of cores in cluster, in the format &lt;min&gt;:&lt;max&gt;. Cluster autoscaler will not scale the cluster beyond these numbers.
+     */
     @JsonProperty("max")
     public void setMax(Integer max) {
         this.max = max;
     }
 
+    /**
+     * Minimum and maximum number of cores in cluster, in the format &lt;min&gt;:&lt;max&gt;. Cluster autoscaler will not scale the cluster beyond these numbers.
+     */
     @JsonProperty("min")
     public Integer getMin() {
         return min;
     }
 
+    /**
+     * Minimum and maximum number of cores in cluster, in the format &lt;min&gt;:&lt;max&gt;. Cluster autoscaler will not scale the cluster beyond these numbers.
+     */
     @JsonProperty("min")
     public void setMin(Integer min) {
         this.min = min;
diff --git a/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscalerSpecRLGpus.java b/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscalerSpecRLGpus.java
index f3201ed5e73..f12966479a1 100644
--- a/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscalerSpecRLGpus.java
+++ b/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscalerSpecRLGpus.java
@@ -106,11 +106,17 @@ public void setMin(Integer min) {
         this.min = min;
     }
 
+    /**
+     * The type of GPU to associate with the minimum and maximum limits. This value is used by the Cluster Autoscaler to identify Nodes that will have GPU capacity by searching for it as a label value on the Node objects. For example, Nodes that carry the label key `cluster-api/accelerator` with the label value being the same as the Type field will be counted towards the resource limits by the Cluster Autoscaler.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * The type of GPU to associate with the minimum and maximum limits. This value is used by the Cluster Autoscaler to identify Nodes that will have GPU capacity by searching for it as a label value on the Node objects. For example, Nodes that carry the label key `cluster-api/accelerator` with the label value being the same as the Type field will be counted towards the resource limits by the Cluster Autoscaler.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscalerSpecRLMemory.java b/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscalerSpecRLMemory.java
index 883ce41e7c1..1725fb16ce2 100644
--- a/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscalerSpecRLMemory.java
+++ b/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscalerSpecRLMemory.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Minimum and maximum number of GiB of memory in cluster, in the format &lt;min&gt;:&lt;max&gt;. Cluster autoscaler will not scale the cluster beyond these numbers.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ClusterAutoscalerSpecRLMemory(Integer max, Integer min) {
         this.min = min;
     }
 
+    /**
+     * Minimum and maximum number of GiB of memory in cluster, in the format &lt;min&gt;:&lt;max&gt;. Cluster autoscaler will not scale the cluster beyond these numbers.
+     */
     @JsonProperty("max")
     public Integer getMax() {
         return max;
     }
 
+    /**
+     * Minimum and maximum number of GiB of memory in cluster, in the format &lt;min&gt;:&lt;max&gt;. Cluster autoscaler will not scale the cluster beyond these numbers.
+     */
     @JsonProperty("max")
     public void setMax(Integer max) {
         this.max = max;
     }
 
+    /**
+     * Minimum and maximum number of GiB of memory in cluster, in the format &lt;min&gt;:&lt;max&gt;. Cluster autoscaler will not scale the cluster beyond these numbers.
+     */
     @JsonProperty("min")
     public Integer getMin() {
         return min;
     }
 
+    /**
+     * Minimum and maximum number of GiB of memory in cluster, in the format &lt;min&gt;:&lt;max&gt;. Cluster autoscaler will not scale the cluster beyond these numbers.
+     */
     @JsonProperty("min")
     public void setMin(Integer min) {
         this.min = min;
diff --git a/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscalerSpecResourceLimits.java b/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscalerSpecResourceLimits.java
index 86cd78227f8..17b55b6df7c 100644
--- a/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscalerSpecResourceLimits.java
+++ b/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscalerSpecResourceLimits.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Constraints of autoscaling resources
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public ClusterAutoscalerSpecResourceLimits(ClusterAutoscalerSpecRLCores cores, L
         this.memory = memory;
     }
 
+    /**
+     * Constraints of autoscaling resources
+     */
     @JsonProperty("cores")
     public ClusterAutoscalerSpecRLCores getCores() {
         return cores;
     }
 
+    /**
+     * Constraints of autoscaling resources
+     */
     @JsonProperty("cores")
     public void setCores(ClusterAutoscalerSpecRLCores cores) {
         this.cores = cores;
     }
 
+    /**
+     * Minimum and maximum number of different GPUs in cluster, in the format &lt;gpu_type&gt;:&lt;min&gt;:&lt;max&gt;. Cluster autoscaler will not scale the cluster beyond these numbers. Can be passed multiple times.
+     */
     @JsonProperty("gpus")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ClusterAutoscalerSpecRLGpus> getGpus() {
         return gpus;
     }
 
+    /**
+     * Minimum and maximum number of different GPUs in cluster, in the format &lt;gpu_type&gt;:&lt;min&gt;:&lt;max&gt;. Cluster autoscaler will not scale the cluster beyond these numbers. Can be passed multiple times.
+     */
     @JsonProperty("gpus")
     public void setGpus(List<ClusterAutoscalerSpecRLGpus> gpus) {
         this.gpus = gpus;
     }
 
+    /**
+     * Maximum number of nodes in all node groups. Cluster autoscaler will not grow the cluster beyond this number.
+     */
     @JsonProperty("maxNodesTotal")
     public Integer getMaxNodesTotal() {
         return maxNodesTotal;
     }
 
+    /**
+     * Maximum number of nodes in all node groups. Cluster autoscaler will not grow the cluster beyond this number.
+     */
     @JsonProperty("maxNodesTotal")
     public void setMaxNodesTotal(Integer maxNodesTotal) {
         this.maxNodesTotal = maxNodesTotal;
     }
 
+    /**
+     * Constraints of autoscaling resources
+     */
     @JsonProperty("memory")
     public ClusterAutoscalerSpecRLMemory getMemory() {
         return memory;
     }
 
+    /**
+     * Constraints of autoscaling resources
+     */
     @JsonProperty("memory")
     public void setMemory(ClusterAutoscalerSpecRLMemory memory) {
         this.memory = memory;
diff --git a/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscalerSpecScaleDown.java b/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscalerSpecScaleDown.java
index e16096ae97e..72fad67c068 100644
--- a/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscalerSpecScaleDown.java
+++ b/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1/ClusterAutoscalerSpecScaleDown.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Configuration of scale down operation
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public ClusterAutoscalerSpecScaleDown(String delayAfterAdd, String delayAfterDel
         this.utilizationThreshold = utilizationThreshold;
     }
 
+    /**
+     * How long after scale up that scale down evaluation resumes
+     */
     @JsonProperty("delayAfterAdd")
     public String getDelayAfterAdd() {
         return delayAfterAdd;
     }
 
+    /**
+     * How long after scale up that scale down evaluation resumes
+     */
     @JsonProperty("delayAfterAdd")
     public void setDelayAfterAdd(String delayAfterAdd) {
         this.delayAfterAdd = delayAfterAdd;
     }
 
+    /**
+     * How long after node deletion that scale down evaluation resumes, defaults to scan-interval
+     */
     @JsonProperty("delayAfterDelete")
     public String getDelayAfterDelete() {
         return delayAfterDelete;
     }
 
+    /**
+     * How long after node deletion that scale down evaluation resumes, defaults to scan-interval
+     */
     @JsonProperty("delayAfterDelete")
     public void setDelayAfterDelete(String delayAfterDelete) {
         this.delayAfterDelete = delayAfterDelete;
     }
 
+    /**
+     * How long after scale down failure that scale down evaluation resumes
+     */
     @JsonProperty("delayAfterFailure")
     public String getDelayAfterFailure() {
         return delayAfterFailure;
     }
 
+    /**
+     * How long after scale down failure that scale down evaluation resumes
+     */
     @JsonProperty("delayAfterFailure")
     public void setDelayAfterFailure(String delayAfterFailure) {
         this.delayAfterFailure = delayAfterFailure;
     }
 
+    /**
+     * Should CA scale down the cluster
+     */
     @JsonProperty("enabled")
     public Boolean getEnabled() {
         return enabled;
     }
 
+    /**
+     * Should CA scale down the cluster
+     */
     @JsonProperty("enabled")
     public void setEnabled(Boolean enabled) {
         this.enabled = enabled;
     }
 
+    /**
+     * How long a node should be unneeded before it is eligible for scale down
+     */
     @JsonProperty("unneededTime")
     public String getUnneededTime() {
         return unneededTime;
     }
 
+    /**
+     * How long a node should be unneeded before it is eligible for scale down
+     */
     @JsonProperty("unneededTime")
     public void setUnneededTime(String unneededTime) {
         this.unneededTime = unneededTime;
     }
 
+    /**
+     * Node utilization level, defined as sum of requested resources divided by capacity, below which a node can be considered for scale down
+     */
     @JsonProperty("utilizationThreshold")
     public String getUtilizationThreshold() {
         return utilizationThreshold;
     }
 
+    /**
+     * Node utilization level, defined as sum of requested resources divided by capacity, below which a node can be considered for scale down
+     */
     @JsonProperty("utilizationThreshold")
     public void setUtilizationThreshold(String utilizationThreshold) {
         this.utilizationThreshold = utilizationThreshold;
diff --git a/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1beta1/MachineAutoscaler.java b/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1beta1/MachineAutoscaler.java
index 8182f9718b7..8c5e3964c1f 100644
--- a/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1beta1/MachineAutoscaler.java
+++ b/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1beta1/MachineAutoscaler.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineAutoscaler is the Schema for the machineautoscalers API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class MachineAutoscaler implements Editable<MachineAutoscalerBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling.openshift.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MachineAutoscaler";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public MachineAutoscaler(String apiVersion, String kind, ObjectMeta metadata, Ma
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MachineAutoscaler is the Schema for the machineautoscalers API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MachineAutoscaler is the Schema for the machineautoscalers API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * MachineAutoscaler is the Schema for the machineautoscalers API
+     */
     @JsonProperty("spec")
     public MachineAutoscalerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * MachineAutoscaler is the Schema for the machineautoscalers API
+     */
     @JsonProperty("spec")
     public void setSpec(MachineAutoscalerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * MachineAutoscaler is the Schema for the machineautoscalers API
+     */
     @JsonProperty("status")
     public MachineAutoscalerStatus getStatus() {
         return status;
     }
 
+    /**
+     * MachineAutoscaler is the Schema for the machineautoscalers API
+     */
     @JsonProperty("status")
     public void setStatus(MachineAutoscalerStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1beta1/MachineAutoscalerList.java b/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1beta1/MachineAutoscalerList.java
index 450b29f55e8..4a7c858e591 100644
--- a/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1beta1/MachineAutoscalerList.java
+++ b/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1beta1/MachineAutoscalerList.java
@@ -78,17 +78,11 @@
 public class MachineAutoscalerList implements Editable<MachineAutoscalerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.autoscaling.v1beta1.MachineAutoscaler>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "autoscaling.openshift.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.autoscaling.v1beta1.MachineAutoscaler> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MachineAutoscalerList";
     @JsonProperty("metadata")
@@ -110,17 +104,11 @@ public MachineAutoscalerList(String apiVersion, List<io.fabric8.openshift.api.mo
         this.metadata = metadata;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
@@ -137,17 +125,11 @@ public void setItems(List<io.fabric8.openshift.api.model.autoscaling.v1beta1.Mac
         this.items = items;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1beta1/MachineAutoscalerSpec.java b/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1beta1/MachineAutoscalerSpec.java
index 370e435737d..f7780a4a0d2 100644
--- a/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1beta1/MachineAutoscalerSpec.java
+++ b/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1beta1/MachineAutoscalerSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Specification of constraints of a scalable resource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public MachineAutoscalerSpec(Integer maxReplicas, Integer minReplicas, MachineAu
         this.scaleTargetRef = scaleTargetRef;
     }
 
+    /**
+     * MaxReplicas constrains the maximal number of replicas of a scalable resource
+     */
     @JsonProperty("maxReplicas")
     public Integer getMaxReplicas() {
         return maxReplicas;
     }
 
+    /**
+     * MaxReplicas constrains the maximal number of replicas of a scalable resource
+     */
     @JsonProperty("maxReplicas")
     public void setMaxReplicas(Integer maxReplicas) {
         this.maxReplicas = maxReplicas;
     }
 
+    /**
+     * MinReplicas constrains the minimal number of replicas of a scalable resource
+     */
     @JsonProperty("minReplicas")
     public Integer getMinReplicas() {
         return minReplicas;
     }
 
+    /**
+     * MinReplicas constrains the minimal number of replicas of a scalable resource
+     */
     @JsonProperty("minReplicas")
     public void setMinReplicas(Integer minReplicas) {
         this.minReplicas = minReplicas;
     }
 
+    /**
+     * Specification of constraints of a scalable resource
+     */
     @JsonProperty("scaleTargetRef")
     public MachineAutoscalerSpecScaleTargetRef getScaleTargetRef() {
         return scaleTargetRef;
     }
 
+    /**
+     * Specification of constraints of a scalable resource
+     */
     @JsonProperty("scaleTargetRef")
     public void setScaleTargetRef(MachineAutoscalerSpecScaleTargetRef scaleTargetRef) {
         this.scaleTargetRef = scaleTargetRef;
diff --git a/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1beta1/MachineAutoscalerSpecScaleTargetRef.java b/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1beta1/MachineAutoscalerSpecScaleTargetRef.java
index 9e805921e51..10ed57140ae 100644
--- a/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1beta1/MachineAutoscalerSpecScaleTargetRef.java
+++ b/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1beta1/MachineAutoscalerSpecScaleTargetRef.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ScaleTargetRef holds reference to a scalable resource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public MachineAutoscalerSpecScaleTargetRef(String apiVersion, String kind, Strin
         this.name = name;
     }
 
+    /**
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name specifies a name of an object, e.g. worker-us-east-1a. Scalable resources are expected to exist under a single namespace.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name specifies a name of an object, e.g. worker-us-east-1a. Scalable resources are expected to exist under a single namespace.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1beta1/MachineAutoscalerStatus.java b/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1beta1/MachineAutoscalerStatus.java
index 53be92041b1..fa592f763db 100644
--- a/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1beta1/MachineAutoscalerStatus.java
+++ b/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1beta1/MachineAutoscalerStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Most recently observed status of a scalable resource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public MachineAutoscalerStatus(MachineAutoscalerStatusLastTargetRef lastTargetRe
         this.lastTargetRef = lastTargetRef;
     }
 
+    /**
+     * Most recently observed status of a scalable resource
+     */
     @JsonProperty("lastTargetRef")
     public MachineAutoscalerStatusLastTargetRef getLastTargetRef() {
         return lastTargetRef;
     }
 
+    /**
+     * Most recently observed status of a scalable resource
+     */
     @JsonProperty("lastTargetRef")
     public void setLastTargetRef(MachineAutoscalerStatusLastTargetRef lastTargetRef) {
         this.lastTargetRef = lastTargetRef;
diff --git a/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1beta1/MachineAutoscalerStatusLastTargetRef.java b/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1beta1/MachineAutoscalerStatusLastTargetRef.java
index 99b4bd45c4a..0f814c9da2c 100644
--- a/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1beta1/MachineAutoscalerStatusLastTargetRef.java
+++ b/kubernetes-model-generator/openshift-model-autoscaling/src/generated/java/io/fabric8/openshift/api/model/autoscaling/v1beta1/MachineAutoscalerStatusLastTargetRef.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LastTargetRef holds reference to the recently observed scalable resource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public MachineAutoscalerStatusLastTargetRef(String apiVersion, String kind, Stri
         this.name = name;
     }
 
+    /**
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name specifies a name of an object, e.g. worker-us-east-1a. Scalable resources are expected to exist under a single namespace.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name specifies a name of an object, e.g. worker-us-east-1a. Scalable resources are expected to exist under a single namespace.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/APIServer.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/APIServer.java
index f890f706074..6f35a096ece 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/APIServer.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/APIServer.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * APIServer holds configuration (like serving certificates, client CA and CORS domains) shared by all API servers in the system, among them especially kube-apiserver and openshift-apiserver. The canonical name of an instance is 'cluster'.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class APIServer implements Editable<APIServerBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "APIServer";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public APIServer(String apiVersion, String kind, ObjectMeta metadata, APIServerS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * APIServer holds configuration (like serving certificates, client CA and CORS domains) shared by all API servers in the system, among them especially kube-apiserver and openshift-apiserver. The canonical name of an instance is 'cluster'.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * APIServer holds configuration (like serving certificates, client CA and CORS domains) shared by all API servers in the system, among them especially kube-apiserver and openshift-apiserver. The canonical name of an instance is 'cluster'.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * APIServer holds configuration (like serving certificates, client CA and CORS domains) shared by all API servers in the system, among them especially kube-apiserver and openshift-apiserver. The canonical name of an instance is 'cluster'.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public APIServerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * APIServer holds configuration (like serving certificates, client CA and CORS domains) shared by all API servers in the system, among them especially kube-apiserver and openshift-apiserver. The canonical name of an instance is 'cluster'.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(APIServerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * APIServer holds configuration (like serving certificates, client CA and CORS domains) shared by all API servers in the system, among them especially kube-apiserver and openshift-apiserver. The canonical name of an instance is 'cluster'.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public APIServerStatus getStatus() {
         return status;
     }
 
+    /**
+     * APIServer holds configuration (like serving certificates, client CA and CORS domains) shared by all API servers in the system, among them especially kube-apiserver and openshift-apiserver. The canonical name of an instance is 'cluster'.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(APIServerStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/APIServerEncryption.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/APIServerEncryption.java
index 8a64d4c8def..9654a7c63a1 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/APIServerEncryption.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/APIServerEncryption.java
@@ -78,11 +78,17 @@ public APIServerEncryption(String type) {
         this.type = type;
     }
 
+    /**
+     * type defines what encryption type should be used to encrypt resources at the datastore layer. When this field is unset (i.e. when it is set to the empty string), identity is implied. The behavior of unset can and will change over time.  Even if encryption is enabled by default, the meaning of unset may change to a different encryption type based on changes in best practices.<br><p> <br><p> When encryption is enabled, all sensitive resources shipped with the platform are encrypted. This list of sensitive resources can and will change over time.  The current authoritative list is:<br><p> <br><p>   1. secrets<br><p>   2. configmaps<br><p>   3. routes.route.openshift.io<br><p>   4. oauthaccesstokens.oauth.openshift.io<br><p>   5. oauthauthorizetokens.oauth.openshift.io
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type defines what encryption type should be used to encrypt resources at the datastore layer. When this field is unset (i.e. when it is set to the empty string), identity is implied. The behavior of unset can and will change over time.  Even if encryption is enabled by default, the meaning of unset may change to a different encryption type based on changes in best practices.<br><p> <br><p> When encryption is enabled, all sensitive resources shipped with the platform are encrypted. This list of sensitive resources can and will change over time.  The current authoritative list is:<br><p> <br><p>   1. secrets<br><p>   2. configmaps<br><p>   3. routes.route.openshift.io<br><p>   4. oauthaccesstokens.oauth.openshift.io<br><p>   5. oauthauthorizetokens.oauth.openshift.io
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/APIServerList.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/APIServerList.java
index b29336872a0..c2c136059bd 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/APIServerList.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/APIServerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class APIServerList implements Editable<APIServerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.config.v1.APIServer>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.config.v1.APIServer> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "APIServerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public APIServerList(String apiVersion, List<io.fabric8.openshift.api.model.conf
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.config.v1.APIServer> getItems() {
         return items;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.config.v1.APIServer> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/APIServerNamedServingCert.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/APIServerNamedServingCert.java
index d93ee55b57a..bacd3d3ec3d 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/APIServerNamedServingCert.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/APIServerNamedServingCert.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * APIServerNamedServingCert maps a server DNS name, as understood by a client, to a certificate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public APIServerNamedServingCert(List<String> names, SecretNameReference serving
         this.servingCertificate = servingCertificate;
     }
 
+    /**
+     * names is a optional list of explicit DNS names (leading wildcards allowed) that should use this certificate to serve secure traffic. If no names are provided, the implicit names will be extracted from the certificates. Exact names trump over wildcard names. Explicit names defined here trump over extracted implicit names.
+     */
     @JsonProperty("names")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNames() {
         return names;
     }
 
+    /**
+     * names is a optional list of explicit DNS names (leading wildcards allowed) that should use this certificate to serve secure traffic. If no names are provided, the implicit names will be extracted from the certificates. Exact names trump over wildcard names. Explicit names defined here trump over extracted implicit names.
+     */
     @JsonProperty("names")
     public void setNames(List<String> names) {
         this.names = names;
     }
 
+    /**
+     * APIServerNamedServingCert maps a server DNS name, as understood by a client, to a certificate.
+     */
     @JsonProperty("servingCertificate")
     public SecretNameReference getServingCertificate() {
         return servingCertificate;
     }
 
+    /**
+     * APIServerNamedServingCert maps a server DNS name, as understood by a client, to a certificate.
+     */
     @JsonProperty("servingCertificate")
     public void setServingCertificate(SecretNameReference servingCertificate) {
         this.servingCertificate = servingCertificate;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/APIServerServingCerts.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/APIServerServingCerts.java
index a0b9d815f32..dd6716448bb 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/APIServerServingCerts.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/APIServerServingCerts.java
@@ -81,12 +81,18 @@ public APIServerServingCerts(List<APIServerNamedServingCert> namedCertificates)
         this.namedCertificates = namedCertificates;
     }
 
+    /**
+     * namedCertificates references secrets containing the TLS cert info for serving secure traffic to specific hostnames. If no named certificates are provided, or no named certificates match the server name as understood by a client, the defaultServingCertificate will be used.
+     */
     @JsonProperty("namedCertificates")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<APIServerNamedServingCert> getNamedCertificates() {
         return namedCertificates;
     }
 
+    /**
+     * namedCertificates references secrets containing the TLS cert info for serving secure traffic to specific hostnames. If no named certificates are provided, or no named certificates match the server name as understood by a client, the defaultServingCertificate will be used.
+     */
     @JsonProperty("namedCertificates")
     public void setNamedCertificates(List<APIServerNamedServingCert> namedCertificates) {
         this.namedCertificates = namedCertificates;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/APIServerSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/APIServerSpec.java
index be8d440378b..12bf55eb09d 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/APIServerSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/APIServerSpec.java
@@ -101,12 +101,18 @@ public APIServerSpec(List<String> additionalCORSAllowedOrigins, Audit audit, Con
         this.tlsSecurityProfile = tlsSecurityProfile;
     }
 
+    /**
+     * additionalCORSAllowedOrigins lists additional, user-defined regular expressions describing hosts for which the API server allows access using the CORS headers. This may be needed to access the API and the integrated OAuth server from JavaScript applications. The values are regular expressions that correspond to the Golang regular expression language.
+     */
     @JsonProperty("additionalCORSAllowedOrigins")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAdditionalCORSAllowedOrigins() {
         return additionalCORSAllowedOrigins;
     }
 
+    /**
+     * additionalCORSAllowedOrigins lists additional, user-defined regular expressions describing hosts for which the API server allows access using the CORS headers. This may be needed to access the API and the integrated OAuth server from JavaScript applications. The values are regular expressions that correspond to the Golang regular expression language.
+     */
     @JsonProperty("additionalCORSAllowedOrigins")
     public void setAdditionalCORSAllowedOrigins(List<String> additionalCORSAllowedOrigins) {
         this.additionalCORSAllowedOrigins = additionalCORSAllowedOrigins;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AWSDNSSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AWSDNSSpec.java
index c80ca1d746c..166a6f1ea2f 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AWSDNSSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AWSDNSSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSDNSSpec contains DNS configuration specific to the Amazon Web Services cloud provider.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public AWSDNSSpec(String privateZoneIAMRole) {
         this.privateZoneIAMRole = privateZoneIAMRole;
     }
 
+    /**
+     * privateZoneIAMRole contains the ARN of an IAM role that should be assumed when performing operations on the cluster's private hosted zone specified in the cluster DNS config. When left empty, no role should be assumed.
+     */
     @JsonProperty("privateZoneIAMRole")
     public String getPrivateZoneIAMRole() {
         return privateZoneIAMRole;
     }
 
+    /**
+     * privateZoneIAMRole contains the ARN of an IAM role that should be assumed when performing operations on the cluster's private hosted zone specified in the cluster DNS config. When left empty, no role should be assumed.
+     */
     @JsonProperty("privateZoneIAMRole")
     public void setPrivateZoneIAMRole(String privateZoneIAMRole) {
         this.privateZoneIAMRole = privateZoneIAMRole;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AWSIngressSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AWSIngressSpec.java
index ef77653334c..cf3c3ce1e5d 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AWSIngressSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AWSIngressSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSIngressSpec holds the desired state of the Ingress for Amazon Web Services infrastructure provider. This only includes fields that can be modified in the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public AWSIngressSpec(String type) {
         this.type = type;
     }
 
+    /**
+     * type allows user to set a load balancer type. When this field is set the default ingresscontroller will get created using the specified LBType. If this field is not set then the default ingress controller of LBType Classic will be created. Valid values are:<br><p> <br><p> &#42; "Classic": A Classic Load Balancer that makes routing decisions at either<br><p>   the transport layer (TCP/SSL) or the application layer (HTTP/HTTPS). See<br><p>   the following for additional details:<br><p> <br><p>     https://docs.aws.amazon.com/AmazonECS/latest/developerguide/load-balancer-types.html#clb<br><p> <br><p> &#42; "NLB": A Network Load Balancer that makes routing decisions at the<br><p>   transport layer (TCP/SSL). See the following for additional details:<br><p> <br><p>     https://docs.aws.amazon.com/AmazonECS/latest/developerguide/load-balancer-types.html#nlb
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type allows user to set a load balancer type. When this field is set the default ingresscontroller will get created using the specified LBType. If this field is not set then the default ingress controller of LBType Classic will be created. Valid values are:<br><p> <br><p> &#42; "Classic": A Classic Load Balancer that makes routing decisions at either<br><p>   the transport layer (TCP/SSL) or the application layer (HTTP/HTTPS). See<br><p>   the following for additional details:<br><p> <br><p>     https://docs.aws.amazon.com/AmazonECS/latest/developerguide/load-balancer-types.html#clb<br><p> <br><p> &#42; "NLB": A Network Load Balancer that makes routing decisions at the<br><p>   transport layer (TCP/SSL). See the following for additional details:<br><p> <br><p>     https://docs.aws.amazon.com/AmazonECS/latest/developerguide/load-balancer-types.html#nlb
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AWSPlatformSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AWSPlatformSpec.java
index cd557bb1f29..7a2c2e86530 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AWSPlatformSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AWSPlatformSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSPlatformSpec holds the desired state of the Amazon Web Services infrastructure provider. This only includes fields that can be modified in the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public AWSPlatformSpec(List<AWSServiceEndpoint> serviceEndpoints) {
         this.serviceEndpoints = serviceEndpoints;
     }
 
+    /**
+     * serviceEndpoints list contains custom endpoints which will override default service endpoint of AWS Services. There must be only one ServiceEndpoint for a service.
+     */
     @JsonProperty("serviceEndpoints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AWSServiceEndpoint> getServiceEndpoints() {
         return serviceEndpoints;
     }
 
+    /**
+     * serviceEndpoints list contains custom endpoints which will override default service endpoint of AWS Services. There must be only one ServiceEndpoint for a service.
+     */
     @JsonProperty("serviceEndpoints")
     public void setServiceEndpoints(List<AWSServiceEndpoint> serviceEndpoints) {
         this.serviceEndpoints = serviceEndpoints;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AWSPlatformStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AWSPlatformStatus.java
index 42f084c02b4..49f51fbd562 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AWSPlatformStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AWSPlatformStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSPlatformStatus holds the current status of the Amazon Web Services infrastructure provider.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public AWSPlatformStatus(String region, List<AWSResourceTag> resourceTags, List<
         this.serviceEndpoints = serviceEndpoints;
     }
 
+    /**
+     * region holds the default AWS region for new AWS resources created by the cluster.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * region holds the default AWS region for new AWS resources created by the cluster.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * resourceTags is a list of additional tags to apply to AWS resources created for the cluster. See https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html for information on tagging AWS resources. AWS supports a maximum of 50 tags per resource. OpenShift reserves 25 tags for its use, leaving 25 tags available for the user.
+     */
     @JsonProperty("resourceTags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AWSResourceTag> getResourceTags() {
         return resourceTags;
     }
 
+    /**
+     * resourceTags is a list of additional tags to apply to AWS resources created for the cluster. See https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html for information on tagging AWS resources. AWS supports a maximum of 50 tags per resource. OpenShift reserves 25 tags for its use, leaving 25 tags available for the user.
+     */
     @JsonProperty("resourceTags")
     public void setResourceTags(List<AWSResourceTag> resourceTags) {
         this.resourceTags = resourceTags;
     }
 
+    /**
+     * ServiceEndpoints list contains custom endpoints which will override default service endpoint of AWS Services. There must be only one ServiceEndpoint for a service.
+     */
     @JsonProperty("serviceEndpoints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AWSServiceEndpoint> getServiceEndpoints() {
         return serviceEndpoints;
     }
 
+    /**
+     * ServiceEndpoints list contains custom endpoints which will override default service endpoint of AWS Services. There must be only one ServiceEndpoint for a service.
+     */
     @JsonProperty("serviceEndpoints")
     public void setServiceEndpoints(List<AWSServiceEndpoint> serviceEndpoints) {
         this.serviceEndpoints = serviceEndpoints;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AWSResourceTag.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AWSResourceTag.java
index c0a1b98b9ed..9c3fbf0ee5b 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AWSResourceTag.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AWSResourceTag.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSResourceTag is a tag to apply to AWS resources created for the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public AWSResourceTag(String key, String value) {
         this.value = value;
     }
 
+    /**
+     * key is the key of the tag
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * key is the key of the tag
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * value is the value of the tag. Some AWS service do not support empty values. Since tags are added to resources in many services, the length of the tag value must meet the requirements of all services.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * value is the value of the tag. Some AWS service do not support empty values. Since tags are added to resources in many services, the length of the tag value must meet the requirements of all services.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AWSServiceEndpoint.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AWSServiceEndpoint.java
index f8501a4aa69..4836d66b47b 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AWSServiceEndpoint.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AWSServiceEndpoint.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSServiceEndpoint store the configuration of a custom url to override existing defaults of AWS Services.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public AWSServiceEndpoint(String name, String url) {
         this.url = url;
     }
 
+    /**
+     * name is the name of the AWS service. The list of all the service names can be found at https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html This must be provided and cannot be empty.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the AWS service. The list of all the service names can be found at https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html This must be provided and cannot be empty.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * url is fully qualified URI with scheme https, that overrides the default generated endpoint for a client. This must be provided and cannot be empty.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * url is fully qualified URI with scheme https, that overrides the default generated endpoint for a client. This must be provided and cannot be empty.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AdmissionConfig.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AdmissionConfig.java
index 14aea0b214e..8081c6e30ea 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AdmissionConfig.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AdmissionConfig.java
@@ -91,23 +91,35 @@ public AdmissionConfig(List<String> disabledPlugins, List<String> enabledPlugins
         this.pluginConfig = pluginConfig;
     }
 
+    /**
+     * disabledPlugins is a list of admission plugins that must be off.  Putting something in this list is almost always a mistake and likely to result in cluster instability.
+     */
     @JsonProperty("disabledPlugins")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDisabledPlugins() {
         return disabledPlugins;
     }
 
+    /**
+     * disabledPlugins is a list of admission plugins that must be off.  Putting something in this list is almost always a mistake and likely to result in cluster instability.
+     */
     @JsonProperty("disabledPlugins")
     public void setDisabledPlugins(List<String> disabledPlugins) {
         this.disabledPlugins = disabledPlugins;
     }
 
+    /**
+     * enabledPlugins is a list of admission plugins that must be on in addition to the default list. Some admission plugins are disabled by default, but certain configurations require them.  This is fairly uncommon and can result in performance penalties and unexpected behavior.
+     */
     @JsonProperty("enabledPlugins")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEnabledPlugins() {
         return enabledPlugins;
     }
 
+    /**
+     * enabledPlugins is a list of admission plugins that must be on in addition to the default list. Some admission plugins are disabled by default, but certain configurations require them.  This is fairly uncommon and can result in performance penalties and unexpected behavior.
+     */
     @JsonProperty("enabledPlugins")
     public void setEnabledPlugins(List<String> enabledPlugins) {
         this.enabledPlugins = enabledPlugins;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AdmissionPluginConfig.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AdmissionPluginConfig.java
index 70d72184b43..c9011fc5e95 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AdmissionPluginConfig.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AdmissionPluginConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AdmissionPluginConfig holds the necessary configuration options for admission plugins
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,22 +86,34 @@ public AdmissionPluginConfig(Object configuration, String location) {
         this.location = location;
     }
 
+    /**
+     * AdmissionPluginConfig holds the necessary configuration options for admission plugins
+     */
     @JsonProperty("configuration")
     public Object getConfiguration() {
         return configuration;
     }
 
+    /**
+     * AdmissionPluginConfig holds the necessary configuration options for admission plugins
+     */
     @JsonProperty("configuration")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setConfiguration(Object configuration) {
         this.configuration = configuration;
     }
 
+    /**
+     * Location is the path to a configuration file that contains the plugin's configuration
+     */
     @JsonProperty("location")
     public String getLocation() {
         return location;
     }
 
+    /**
+     * Location is the path to a configuration file that contains the plugin's configuration
+     */
     @JsonProperty("location")
     public void setLocation(String location) {
         this.location = location;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AlibabaCloudPlatformSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AlibabaCloudPlatformSpec.java
index b909136c43d..95b275aad12 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AlibabaCloudPlatformSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AlibabaCloudPlatformSpec.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AlibabaCloudPlatformSpec holds the desired state of the Alibaba Cloud infrastructure provider. This only includes fields that can be modified in the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AlibabaCloudPlatformStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AlibabaCloudPlatformStatus.java
index 25f46f70f8b..3d2b3054e98 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AlibabaCloudPlatformStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AlibabaCloudPlatformStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AlibabaCloudPlatformStatus holds the current status of the Alibaba Cloud infrastructure provider.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public AlibabaCloudPlatformStatus(String region, String resourceGroupID, List<Al
         this.resourceTags = resourceTags;
     }
 
+    /**
+     * region specifies the region for Alibaba Cloud resources created for the cluster.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * region specifies the region for Alibaba Cloud resources created for the cluster.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * resourceGroupID is the ID of the resource group for the cluster.
+     */
     @JsonProperty("resourceGroupID")
     public String getResourceGroupID() {
         return resourceGroupID;
     }
 
+    /**
+     * resourceGroupID is the ID of the resource group for the cluster.
+     */
     @JsonProperty("resourceGroupID")
     public void setResourceGroupID(String resourceGroupID) {
         this.resourceGroupID = resourceGroupID;
     }
 
+    /**
+     * resourceTags is a list of additional tags to apply to Alibaba Cloud resources created for the cluster.
+     */
     @JsonProperty("resourceTags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AlibabaCloudResourceTag> getResourceTags() {
         return resourceTags;
     }
 
+    /**
+     * resourceTags is a list of additional tags to apply to Alibaba Cloud resources created for the cluster.
+     */
     @JsonProperty("resourceTags")
     public void setResourceTags(List<AlibabaCloudResourceTag> resourceTags) {
         this.resourceTags = resourceTags;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AlibabaCloudResourceTag.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AlibabaCloudResourceTag.java
index bf785cc7a06..649ff4114ef 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AlibabaCloudResourceTag.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AlibabaCloudResourceTag.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AlibabaCloudResourceTag is the set of tags to add to apply to resources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public AlibabaCloudResourceTag(String key, String value) {
         this.value = value;
     }
 
+    /**
+     * key is the key of the tag.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * key is the key of the tag.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * value is the value of the tag.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * value is the value of the tag.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Audit.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Audit.java
index 9cbbc696f85..6b543b796a2 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Audit.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Audit.java
@@ -85,22 +85,34 @@ public Audit(List<AuditCustomRule> customRules, String profile) {
         this.profile = profile;
     }
 
+    /**
+     * customRules specify profiles per group. These profile take precedence over the top-level profile field if they apply. They are evaluation from top to bottom and the first one that matches, applies.
+     */
     @JsonProperty("customRules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AuditCustomRule> getCustomRules() {
         return customRules;
     }
 
+    /**
+     * customRules specify profiles per group. These profile take precedence over the top-level profile field if they apply. They are evaluation from top to bottom and the first one that matches, applies.
+     */
     @JsonProperty("customRules")
     public void setCustomRules(List<AuditCustomRule> customRules) {
         this.customRules = customRules;
     }
 
+    /**
+     * profile specifies the name of the desired top-level audit profile to be applied to all requests sent to any of the OpenShift-provided API servers in the cluster (kube-apiserver, openshift-apiserver and oauth-apiserver), with the exception of those requests that match one or more of the customRules.<br><p> <br><p> The following profiles are provided: - Default: default policy which means MetaData level logging with the exception of events<br><p>   (not logged at all), oauthaccesstokens and oauthauthorizetokens (both logged at RequestBody<br><p>   level).<br><p> - WriteRequestBodies: like 'Default', but logs request and response HTTP payloads for write requests (create, update, patch). - AllRequestBodies: like 'WriteRequestBodies', but also logs request and response HTTP payloads for read requests (get, list). - None: no requests are logged at all, not even oauthaccesstokens and oauthauthorizetokens.<br><p> <br><p> Warning: It is not recommended to disable audit logging by using the `None` profile unless you are fully aware of the risks of not logging data that can be beneficial when troubleshooting issues. If you disable audit logging and a support situation arises, you might need to enable audit logging and reproduce the issue in order to troubleshoot properly.<br><p> <br><p> If unset, the 'Default' profile is used as the default.
+     */
     @JsonProperty("profile")
     public String getProfile() {
         return profile;
     }
 
+    /**
+     * profile specifies the name of the desired top-level audit profile to be applied to all requests sent to any of the OpenShift-provided API servers in the cluster (kube-apiserver, openshift-apiserver and oauth-apiserver), with the exception of those requests that match one or more of the customRules.<br><p> <br><p> The following profiles are provided: - Default: default policy which means MetaData level logging with the exception of events<br><p>   (not logged at all), oauthaccesstokens and oauthauthorizetokens (both logged at RequestBody<br><p>   level).<br><p> - WriteRequestBodies: like 'Default', but logs request and response HTTP payloads for write requests (create, update, patch). - AllRequestBodies: like 'WriteRequestBodies', but also logs request and response HTTP payloads for read requests (get, list). - None: no requests are logged at all, not even oauthaccesstokens and oauthauthorizetokens.<br><p> <br><p> Warning: It is not recommended to disable audit logging by using the `None` profile unless you are fully aware of the risks of not logging data that can be beneficial when troubleshooting issues. If you disable audit logging and a support situation arises, you might need to enable audit logging and reproduce the issue in order to troubleshoot properly.<br><p> <br><p> If unset, the 'Default' profile is used as the default.
+     */
     @JsonProperty("profile")
     public void setProfile(String profile) {
         this.profile = profile;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AuditConfig.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AuditConfig.java
index 5508a3d173c..3f1b9725069 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AuditConfig.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AuditConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AuditConfig holds configuration for the audit capabilities
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -115,102 +118,162 @@ public AuditConfig(String auditFilePath, Boolean enabled, String logFormat, Inte
         this.webHookMode = webHookMode;
     }
 
+    /**
+     * All requests coming to the apiserver will be logged to this file.
+     */
     @JsonProperty("auditFilePath")
     public String getAuditFilePath() {
         return auditFilePath;
     }
 
+    /**
+     * All requests coming to the apiserver will be logged to this file.
+     */
     @JsonProperty("auditFilePath")
     public void setAuditFilePath(String auditFilePath) {
         this.auditFilePath = auditFilePath;
     }
 
+    /**
+     * If this flag is set, audit log will be printed in the logs. The logs contains, method, user and a requested URL.
+     */
     @JsonProperty("enabled")
     public Boolean getEnabled() {
         return enabled;
     }
 
+    /**
+     * If this flag is set, audit log will be printed in the logs. The logs contains, method, user and a requested URL.
+     */
     @JsonProperty("enabled")
     public void setEnabled(Boolean enabled) {
         this.enabled = enabled;
     }
 
+    /**
+     * Format of saved audits (legacy or json).
+     */
     @JsonProperty("logFormat")
     public String getLogFormat() {
         return logFormat;
     }
 
+    /**
+     * Format of saved audits (legacy or json).
+     */
     @JsonProperty("logFormat")
     public void setLogFormat(String logFormat) {
         this.logFormat = logFormat;
     }
 
+    /**
+     * Maximum number of days to retain old log files based on the timestamp encoded in their filename.
+     */
     @JsonProperty("maximumFileRetentionDays")
     public Integer getMaximumFileRetentionDays() {
         return maximumFileRetentionDays;
     }
 
+    /**
+     * Maximum number of days to retain old log files based on the timestamp encoded in their filename.
+     */
     @JsonProperty("maximumFileRetentionDays")
     public void setMaximumFileRetentionDays(Integer maximumFileRetentionDays) {
         this.maximumFileRetentionDays = maximumFileRetentionDays;
     }
 
+    /**
+     * Maximum size in megabytes of the log file before it gets rotated. Defaults to 100MB.
+     */
     @JsonProperty("maximumFileSizeMegabytes")
     public Integer getMaximumFileSizeMegabytes() {
         return maximumFileSizeMegabytes;
     }
 
+    /**
+     * Maximum size in megabytes of the log file before it gets rotated. Defaults to 100MB.
+     */
     @JsonProperty("maximumFileSizeMegabytes")
     public void setMaximumFileSizeMegabytes(Integer maximumFileSizeMegabytes) {
         this.maximumFileSizeMegabytes = maximumFileSizeMegabytes;
     }
 
+    /**
+     * Maximum number of old log files to retain.
+     */
     @JsonProperty("maximumRetainedFiles")
     public Integer getMaximumRetainedFiles() {
         return maximumRetainedFiles;
     }
 
+    /**
+     * Maximum number of old log files to retain.
+     */
     @JsonProperty("maximumRetainedFiles")
     public void setMaximumRetainedFiles(Integer maximumRetainedFiles) {
         this.maximumRetainedFiles = maximumRetainedFiles;
     }
 
+    /**
+     * AuditConfig holds configuration for the audit capabilities
+     */
     @JsonProperty("policyConfiguration")
     public Object getPolicyConfiguration() {
         return policyConfiguration;
     }
 
+    /**
+     * AuditConfig holds configuration for the audit capabilities
+     */
     @JsonProperty("policyConfiguration")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setPolicyConfiguration(Object policyConfiguration) {
         this.policyConfiguration = policyConfiguration;
     }
 
+    /**
+     * PolicyFile is a path to the file that defines the audit policy configuration.
+     */
     @JsonProperty("policyFile")
     public String getPolicyFile() {
         return policyFile;
     }
 
+    /**
+     * PolicyFile is a path to the file that defines the audit policy configuration.
+     */
     @JsonProperty("policyFile")
     public void setPolicyFile(String policyFile) {
         this.policyFile = policyFile;
     }
 
+    /**
+     * Path to a .kubeconfig formatted file that defines the audit webhook configuration.
+     */
     @JsonProperty("webHookKubeConfig")
     public String getWebHookKubeConfig() {
         return webHookKubeConfig;
     }
 
+    /**
+     * Path to a .kubeconfig formatted file that defines the audit webhook configuration.
+     */
     @JsonProperty("webHookKubeConfig")
     public void setWebHookKubeConfig(String webHookKubeConfig) {
         this.webHookKubeConfig = webHookKubeConfig;
     }
 
+    /**
+     * Strategy for sending audit events (block or batch).
+     */
     @JsonProperty("webHookMode")
     public String getWebHookMode() {
         return webHookMode;
     }
 
+    /**
+     * Strategy for sending audit events (block or batch).
+     */
     @JsonProperty("webHookMode")
     public void setWebHookMode(String webHookMode) {
         this.webHookMode = webHookMode;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AuditCustomRule.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AuditCustomRule.java
index 6b2c8e904df..27d5f0d4372 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AuditCustomRule.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AuditCustomRule.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AuditCustomRule describes a custom rule for an audit profile that takes precedence over the top-level profile.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public AuditCustomRule(String group, String profile) {
         this.profile = profile;
     }
 
+    /**
+     * group is a name of group a request user must be member of in order to this profile to apply.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * group is a name of group a request user must be member of in order to this profile to apply.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * profile specifies the name of the desired audit policy configuration to be deployed to all OpenShift-provided API servers in the cluster.<br><p> <br><p> The following profiles are provided: - Default: the existing default policy. - WriteRequestBodies: like 'Default', but logs request and response HTTP payloads for write requests (create, update, patch). - AllRequestBodies: like 'WriteRequestBodies', but also logs request and response HTTP payloads for read requests (get, list). - None: no requests are logged at all, not even oauthaccesstokens and oauthauthorizetokens.<br><p> <br><p> If unset, the 'Default' profile is used as the default.
+     */
     @JsonProperty("profile")
     public String getProfile() {
         return profile;
     }
 
+    /**
+     * profile specifies the name of the desired audit policy configuration to be deployed to all OpenShift-provided API servers in the cluster.<br><p> <br><p> The following profiles are provided: - Default: the existing default policy. - WriteRequestBodies: like 'Default', but logs request and response HTTP payloads for write requests (create, update, patch). - AllRequestBodies: like 'WriteRequestBodies', but also logs request and response HTTP payloads for read requests (get, list). - None: no requests are logged at all, not even oauthaccesstokens and oauthauthorizetokens.<br><p> <br><p> If unset, the 'Default' profile is used as the default.
+     */
     @JsonProperty("profile")
     public void setProfile(String profile) {
         this.profile = profile;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Authentication.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Authentication.java
index 70abe3e188a..e5e54cb9388 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Authentication.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Authentication.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Authentication specifies cluster-wide settings for authentication (like OAuth and webhook token authenticators). The canonical name of an instance is `cluster`.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Authentication implements Editable<AuthenticationBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Authentication";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public Authentication(String apiVersion, String kind, ObjectMeta metadata, Authe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Authentication specifies cluster-wide settings for authentication (like OAuth and webhook token authenticators). The canonical name of an instance is `cluster`.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Authentication specifies cluster-wide settings for authentication (like OAuth and webhook token authenticators). The canonical name of an instance is `cluster`.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Authentication specifies cluster-wide settings for authentication (like OAuth and webhook token authenticators). The canonical name of an instance is `cluster`.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public AuthenticationSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Authentication specifies cluster-wide settings for authentication (like OAuth and webhook token authenticators). The canonical name of an instance is `cluster`.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(AuthenticationSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Authentication specifies cluster-wide settings for authentication (like OAuth and webhook token authenticators). The canonical name of an instance is `cluster`.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public AuthenticationStatus getStatus() {
         return status;
     }
 
+    /**
+     * Authentication specifies cluster-wide settings for authentication (like OAuth and webhook token authenticators). The canonical name of an instance is `cluster`.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(AuthenticationStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AuthenticationList.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AuthenticationList.java
index 869aa913c4d..7755eb40966 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AuthenticationList.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AuthenticationList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class AuthenticationList implements Editable<AuthenticationListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.config.v1.Authentication>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.config.v1.Authentication> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AuthenticationList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public AuthenticationList(String apiVersion, List<io.fabric8.openshift.api.model
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.config.v1.Authentication> getItems() {
         return items;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.config.v1.Authentication> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AuthenticationSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AuthenticationSpec.java
index 4658020760f..267048974f5 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AuthenticationSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AuthenticationSpec.java
@@ -112,32 +112,50 @@ public void setOauthMetadata(ConfigMapNameReference oauthMetadata) {
         this.oauthMetadata = oauthMetadata;
     }
 
+    /**
+     * OIDCProviders are OIDC identity providers that can issue tokens for this cluster Can only be set if "Type" is set to "OIDC".<br><p> <br><p> At most one provider can be configured.
+     */
     @JsonProperty("oidcProviders")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OIDCProvider> getOidcProviders() {
         return oidcProviders;
     }
 
+    /**
+     * OIDCProviders are OIDC identity providers that can issue tokens for this cluster Can only be set if "Type" is set to "OIDC".<br><p> <br><p> At most one provider can be configured.
+     */
     @JsonProperty("oidcProviders")
     public void setOidcProviders(List<OIDCProvider> oidcProviders) {
         this.oidcProviders = oidcProviders;
     }
 
+    /**
+     * serviceAccountIssuer is the identifier of the bound service account token issuer. The default is https://kubernetes.default.svc WARNING: Updating this field will not result in immediate invalidation of all bound tokens with the previous issuer value. Instead, the tokens issued by previous service account issuer will continue to be trusted for a time period chosen by the platform (currently set to 24h). This time period is subject to change over time. This allows internal components to transition to use new service account issuer without service distruption.
+     */
     @JsonProperty("serviceAccountIssuer")
     public String getServiceAccountIssuer() {
         return serviceAccountIssuer;
     }
 
+    /**
+     * serviceAccountIssuer is the identifier of the bound service account token issuer. The default is https://kubernetes.default.svc WARNING: Updating this field will not result in immediate invalidation of all bound tokens with the previous issuer value. Instead, the tokens issued by previous service account issuer will continue to be trusted for a time period chosen by the platform (currently set to 24h). This time period is subject to change over time. This allows internal components to transition to use new service account issuer without service distruption.
+     */
     @JsonProperty("serviceAccountIssuer")
     public void setServiceAccountIssuer(String serviceAccountIssuer) {
         this.serviceAccountIssuer = serviceAccountIssuer;
     }
 
+    /**
+     * type identifies the cluster managed, user facing authentication mode in use. Specifically, it manages the component that responds to login attempts. The default is IntegratedOAuth.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type identifies the cluster managed, user facing authentication mode in use. Specifically, it manages the component that responds to login attempts. The default is IntegratedOAuth.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
@@ -153,12 +171,18 @@ public void setWebhookTokenAuthenticator(WebhookTokenAuthenticator webhookTokenA
         this.webhookTokenAuthenticator = webhookTokenAuthenticator;
     }
 
+    /**
+     * webhookTokenAuthenticators is DEPRECATED, setting it has no effect.
+     */
     @JsonProperty("webhookTokenAuthenticators")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DeprecatedWebhookTokenAuthenticator> getWebhookTokenAuthenticators() {
         return webhookTokenAuthenticators;
     }
 
+    /**
+     * webhookTokenAuthenticators is DEPRECATED, setting it has no effect.
+     */
     @JsonProperty("webhookTokenAuthenticators")
     public void setWebhookTokenAuthenticators(List<DeprecatedWebhookTokenAuthenticator> webhookTokenAuthenticators) {
         this.webhookTokenAuthenticators = webhookTokenAuthenticators;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AuthenticationStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AuthenticationStatus.java
index c4f45c35e8e..bb3037d53cc 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AuthenticationStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AuthenticationStatus.java
@@ -95,12 +95,18 @@ public void setIntegratedOAuthMetadata(ConfigMapNameReference integratedOAuthMet
         this.integratedOAuthMetadata = integratedOAuthMetadata;
     }
 
+    /**
+     * OIDCClients is where participating operators place the current OIDC client status for OIDC clients that can be customized by the cluster-admin.
+     */
     @JsonProperty("oidcClients")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OIDCClientStatus> getOidcClients() {
         return oidcClients;
     }
 
+    /**
+     * OIDCClients is where participating operators place the current OIDC client status for OIDC clients that can be customized by the cluster-admin.
+     */
     @JsonProperty("oidcClients")
     public void setOidcClients(List<OIDCClientStatus> oidcClients) {
         this.oidcClients = oidcClients;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AzurePlatformSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AzurePlatformSpec.java
index 4c47d802a7c..d7565c0eb62 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AzurePlatformSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AzurePlatformSpec.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzurePlatformSpec holds the desired state of the Azure infrastructure provider. This only includes fields that can be modified in the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AzurePlatformStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AzurePlatformStatus.java
index 35695030781..0f1428cf6ea 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AzurePlatformStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AzurePlatformStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzurePlatformStatus holds the current status of the Azure infrastructure provider.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -97,52 +100,82 @@ public AzurePlatformStatus(String armEndpoint, String cloudName, String networkR
         this.resourceTags = resourceTags;
     }
 
+    /**
+     * armEndpoint specifies a URL to use for resource management in non-soverign clouds such as Azure Stack.
+     */
     @JsonProperty("armEndpoint")
     public String getArmEndpoint() {
         return armEndpoint;
     }
 
+    /**
+     * armEndpoint specifies a URL to use for resource management in non-soverign clouds such as Azure Stack.
+     */
     @JsonProperty("armEndpoint")
     public void setArmEndpoint(String armEndpoint) {
         this.armEndpoint = armEndpoint;
     }
 
+    /**
+     * cloudName is the name of the Azure cloud environment which can be used to configure the Azure SDK with the appropriate Azure API endpoints. If empty, the value is equal to `AzurePublicCloud`.
+     */
     @JsonProperty("cloudName")
     public String getCloudName() {
         return cloudName;
     }
 
+    /**
+     * cloudName is the name of the Azure cloud environment which can be used to configure the Azure SDK with the appropriate Azure API endpoints. If empty, the value is equal to `AzurePublicCloud`.
+     */
     @JsonProperty("cloudName")
     public void setCloudName(String cloudName) {
         this.cloudName = cloudName;
     }
 
+    /**
+     * networkResourceGroupName is the Resource Group for network resources like the Virtual Network and Subnets used by the cluster. If empty, the value is same as ResourceGroupName.
+     */
     @JsonProperty("networkResourceGroupName")
     public String getNetworkResourceGroupName() {
         return networkResourceGroupName;
     }
 
+    /**
+     * networkResourceGroupName is the Resource Group for network resources like the Virtual Network and Subnets used by the cluster. If empty, the value is same as ResourceGroupName.
+     */
     @JsonProperty("networkResourceGroupName")
     public void setNetworkResourceGroupName(String networkResourceGroupName) {
         this.networkResourceGroupName = networkResourceGroupName;
     }
 
+    /**
+     * resourceGroupName is the Resource Group for new Azure resources created for the cluster.
+     */
     @JsonProperty("resourceGroupName")
     public String getResourceGroupName() {
         return resourceGroupName;
     }
 
+    /**
+     * resourceGroupName is the Resource Group for new Azure resources created for the cluster.
+     */
     @JsonProperty("resourceGroupName")
     public void setResourceGroupName(String resourceGroupName) {
         this.resourceGroupName = resourceGroupName;
     }
 
+    /**
+     * resourceTags is a list of additional tags to apply to Azure resources created for the cluster. See https://docs.microsoft.com/en-us/rest/api/resources/tags for information on tagging Azure resources. Due to limitations on Automation, Content Delivery Network, DNS Azure resources, a maximum of 15 tags may be applied. OpenShift reserves 5 tags for internal use, allowing 10 tags for user configuration.
+     */
     @JsonProperty("resourceTags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AzureResourceTag> getResourceTags() {
         return resourceTags;
     }
 
+    /**
+     * resourceTags is a list of additional tags to apply to Azure resources created for the cluster. See https://docs.microsoft.com/en-us/rest/api/resources/tags for information on tagging Azure resources. Due to limitations on Automation, Content Delivery Network, DNS Azure resources, a maximum of 15 tags may be applied. OpenShift reserves 5 tags for internal use, allowing 10 tags for user configuration.
+     */
     @JsonProperty("resourceTags")
     public void setResourceTags(List<AzureResourceTag> resourceTags) {
         this.resourceTags = resourceTags;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AzureResourceTag.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AzureResourceTag.java
index 2e32655f17e..2d895e0961f 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AzureResourceTag.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/AzureResourceTag.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzureResourceTag is a tag to apply to Azure resources created for the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public AzureResourceTag(String key, String value) {
         this.value = value;
     }
 
+    /**
+     * key is the key part of the tag. A tag key can have a maximum of 128 characters and cannot be empty. Key must begin with a letter, end with a letter, number or underscore, and must contain only alphanumeric characters and the following special characters `_ . -`.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * key is the key part of the tag. A tag key can have a maximum of 128 characters and cannot be empty. Key must begin with a letter, end with a letter, number or underscore, and must contain only alphanumeric characters and the following special characters `_ . -`.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * value is the value part of the tag. A tag value can have a maximum of 256 characters and cannot be empty. Value must contain only alphanumeric characters and the following special characters `_ + , - . / : ; &lt; = &gt; ? @`.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * value is the value part of the tag. A tag value can have a maximum of 256 characters and cannot be empty. Value must contain only alphanumeric characters and the following special characters `_ + , - . / : ; &lt; = &gt; ? @`.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/BareMetalPlatformLoadBalancer.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/BareMetalPlatformLoadBalancer.java
index 1a729837e7d..d439daf70bb 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/BareMetalPlatformLoadBalancer.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/BareMetalPlatformLoadBalancer.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BareMetalPlatformLoadBalancer defines the load balancer used by the cluster on BareMetal platform.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public BareMetalPlatformLoadBalancer(String type) {
         this.type = type;
     }
 
+    /**
+     * type defines the type of load balancer used by the cluster on BareMetal platform which can be a user-managed or openshift-managed load balancer that is to be used for the OpenShift API and Ingress endpoints. When set to OpenShiftManagedDefault the static pods in charge of API and Ingress traffic load-balancing defined in the machine config operator will be deployed. When set to UserManaged these static pods will not be deployed and it is expected that the load balancer is configured out of band by the deployer. When omitted, this means no opinion and the platform is left to choose a reasonable default. The default value is OpenShiftManagedDefault.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type defines the type of load balancer used by the cluster on BareMetal platform which can be a user-managed or openshift-managed load balancer that is to be used for the OpenShift API and Ingress endpoints. When set to OpenShiftManagedDefault the static pods in charge of API and Ingress traffic load-balancing defined in the machine config operator will be deployed. When set to UserManaged these static pods will not be deployed and it is expected that the load balancer is configured out of band by the deployer. When omitted, this means no opinion and the platform is left to choose a reasonable default. The default value is OpenShiftManagedDefault.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/BareMetalPlatformSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/BareMetalPlatformSpec.java
index 098cc4174d3..89d038bdb36 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/BareMetalPlatformSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/BareMetalPlatformSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BareMetalPlatformSpec holds the desired state of the BareMetal infrastructure provider. This only includes fields that can be modified in the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,34 +94,52 @@ public BareMetalPlatformSpec(List<String> apiServerInternalIPs, List<String> ing
         this.machineNetworks = machineNetworks;
     }
 
+    /**
+     * apiServerInternalIPs are the IP addresses to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. These are the IPs for a self-hosted load balancer in front of the API servers. In dual stack clusters this list contains two IP addresses, one from IPv4 family and one from IPv6. In single stack clusters a single IP address is expected. When omitted, values from the status.apiServerInternalIPs will be used. Once set, the list cannot be completely removed (but its second entry can).
+     */
     @JsonProperty("apiServerInternalIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiServerInternalIPs() {
         return apiServerInternalIPs;
     }
 
+    /**
+     * apiServerInternalIPs are the IP addresses to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. These are the IPs for a self-hosted load balancer in front of the API servers. In dual stack clusters this list contains two IP addresses, one from IPv4 family and one from IPv6. In single stack clusters a single IP address is expected. When omitted, values from the status.apiServerInternalIPs will be used. Once set, the list cannot be completely removed (but its second entry can).
+     */
     @JsonProperty("apiServerInternalIPs")
     public void setApiServerInternalIPs(List<String> apiServerInternalIPs) {
         this.apiServerInternalIPs = apiServerInternalIPs;
     }
 
+    /**
+     * ingressIPs are the external IPs which route to the default ingress controller. The IPs are suitable targets of a wildcard DNS record used to resolve default route host names. In dual stack clusters this list contains two IP addresses, one from IPv4 family and one from IPv6. In single stack clusters a single IP address is expected. When omitted, values from the status.ingressIPs will be used. Once set, the list cannot be completely removed (but its second entry can).
+     */
     @JsonProperty("ingressIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIngressIPs() {
         return ingressIPs;
     }
 
+    /**
+     * ingressIPs are the external IPs which route to the default ingress controller. The IPs are suitable targets of a wildcard DNS record used to resolve default route host names. In dual stack clusters this list contains two IP addresses, one from IPv4 family and one from IPv6. In single stack clusters a single IP address is expected. When omitted, values from the status.ingressIPs will be used. Once set, the list cannot be completely removed (but its second entry can).
+     */
     @JsonProperty("ingressIPs")
     public void setIngressIPs(List<String> ingressIPs) {
         this.ingressIPs = ingressIPs;
     }
 
+    /**
+     * machineNetworks are IP networks used to connect all the OpenShift cluster nodes. Each network is provided in the CIDR format and should be IPv4 or IPv6, for example "10.0.0.0/8" or "fd00::/8".
+     */
     @JsonProperty("machineNetworks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMachineNetworks() {
         return machineNetworks;
     }
 
+    /**
+     * machineNetworks are IP networks used to connect all the OpenShift cluster nodes. Each network is provided in the CIDR format and should be IPv4 or IPv6, for example "10.0.0.0/8" or "fd00::/8".
+     */
     @JsonProperty("machineNetworks")
     public void setMachineNetworks(List<String> machineNetworks) {
         this.machineNetworks = machineNetworks;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/BareMetalPlatformStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/BareMetalPlatformStatus.java
index a6b58f185fa..a7cc249bd1f 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/BareMetalPlatformStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/BareMetalPlatformStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BareMetalPlatformStatus holds the current status of the BareMetal infrastructure provider. For more information about the network architecture used with the BareMetal platform type, see: https://github.com/openshift/installer/blob/master/docs/design/baremetal/networking-infrastructure.md
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -107,74 +110,116 @@ public BareMetalPlatformStatus(String apiServerInternalIP, List<String> apiServe
         this.nodeDNSIP = nodeDNSIP;
     }
 
+    /**
+     * apiServerInternalIP is an IP address to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. It is the IP that the Infrastructure.status.apiServerInternalURI points to. It is the IP for a self-hosted load balancer in front of the API servers.<br><p> <br><p> Deprecated: Use APIServerInternalIPs instead.
+     */
     @JsonProperty("apiServerInternalIP")
     public String getApiServerInternalIP() {
         return apiServerInternalIP;
     }
 
+    /**
+     * apiServerInternalIP is an IP address to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. It is the IP that the Infrastructure.status.apiServerInternalURI points to. It is the IP for a self-hosted load balancer in front of the API servers.<br><p> <br><p> Deprecated: Use APIServerInternalIPs instead.
+     */
     @JsonProperty("apiServerInternalIP")
     public void setApiServerInternalIP(String apiServerInternalIP) {
         this.apiServerInternalIP = apiServerInternalIP;
     }
 
+    /**
+     * apiServerInternalIPs are the IP addresses to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. These are the IPs for a self-hosted load balancer in front of the API servers. In dual stack clusters this list contains two IPs otherwise only one.
+     */
     @JsonProperty("apiServerInternalIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiServerInternalIPs() {
         return apiServerInternalIPs;
     }
 
+    /**
+     * apiServerInternalIPs are the IP addresses to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. These are the IPs for a self-hosted load balancer in front of the API servers. In dual stack clusters this list contains two IPs otherwise only one.
+     */
     @JsonProperty("apiServerInternalIPs")
     public void setApiServerInternalIPs(List<String> apiServerInternalIPs) {
         this.apiServerInternalIPs = apiServerInternalIPs;
     }
 
+    /**
+     * ingressIP is an external IP which routes to the default ingress controller. The IP is a suitable target of a wildcard DNS record used to resolve default route host names.<br><p> <br><p> Deprecated: Use IngressIPs instead.
+     */
     @JsonProperty("ingressIP")
     public String getIngressIP() {
         return ingressIP;
     }
 
+    /**
+     * ingressIP is an external IP which routes to the default ingress controller. The IP is a suitable target of a wildcard DNS record used to resolve default route host names.<br><p> <br><p> Deprecated: Use IngressIPs instead.
+     */
     @JsonProperty("ingressIP")
     public void setIngressIP(String ingressIP) {
         this.ingressIP = ingressIP;
     }
 
+    /**
+     * ingressIPs are the external IPs which route to the default ingress controller. The IPs are suitable targets of a wildcard DNS record used to resolve default route host names. In dual stack clusters this list contains two IPs otherwise only one.
+     */
     @JsonProperty("ingressIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIngressIPs() {
         return ingressIPs;
     }
 
+    /**
+     * ingressIPs are the external IPs which route to the default ingress controller. The IPs are suitable targets of a wildcard DNS record used to resolve default route host names. In dual stack clusters this list contains two IPs otherwise only one.
+     */
     @JsonProperty("ingressIPs")
     public void setIngressIPs(List<String> ingressIPs) {
         this.ingressIPs = ingressIPs;
     }
 
+    /**
+     * BareMetalPlatformStatus holds the current status of the BareMetal infrastructure provider. For more information about the network architecture used with the BareMetal platform type, see: https://github.com/openshift/installer/blob/master/docs/design/baremetal/networking-infrastructure.md
+     */
     @JsonProperty("loadBalancer")
     public BareMetalPlatformLoadBalancer getLoadBalancer() {
         return loadBalancer;
     }
 
+    /**
+     * BareMetalPlatformStatus holds the current status of the BareMetal infrastructure provider. For more information about the network architecture used with the BareMetal platform type, see: https://github.com/openshift/installer/blob/master/docs/design/baremetal/networking-infrastructure.md
+     */
     @JsonProperty("loadBalancer")
     public void setLoadBalancer(BareMetalPlatformLoadBalancer loadBalancer) {
         this.loadBalancer = loadBalancer;
     }
 
+    /**
+     * machineNetworks are IP networks used to connect all the OpenShift cluster nodes.
+     */
     @JsonProperty("machineNetworks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMachineNetworks() {
         return machineNetworks;
     }
 
+    /**
+     * machineNetworks are IP networks used to connect all the OpenShift cluster nodes.
+     */
     @JsonProperty("machineNetworks")
     public void setMachineNetworks(List<String> machineNetworks) {
         this.machineNetworks = machineNetworks;
     }
 
+    /**
+     * nodeDNSIP is the IP address for the internal DNS used by the nodes. Unlike the one managed by the DNS operator, `NodeDNSIP` provides name resolution for the nodes themselves. There is no DNS-as-a-service for BareMetal deployments. In order to minimize necessary changes to the datacenter DNS, a DNS service is hosted as a static pod to serve those hostnames to the nodes in the cluster.
+     */
     @JsonProperty("nodeDNSIP")
     public String getNodeDNSIP() {
         return nodeDNSIP;
     }
 
+    /**
+     * nodeDNSIP is the IP address for the internal DNS used by the nodes. Unlike the one managed by the DNS operator, `NodeDNSIP` provides name resolution for the nodes themselves. There is no DNS-as-a-service for BareMetal deployments. In order to minimize necessary changes to the datacenter DNS, a DNS service is hosted as a static pod to serve those hostnames to the nodes in the cluster.
+     */
     @JsonProperty("nodeDNSIP")
     public void setNodeDNSIP(String nodeDNSIP) {
         this.nodeDNSIP = nodeDNSIP;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/BasicAuthIdentityProvider.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/BasicAuthIdentityProvider.java
index 822e1e23cd0..7a237713a71 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/BasicAuthIdentityProvider.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/BasicAuthIdentityProvider.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BasicAuthPasswordIdentityProvider provides identities for users authenticating using HTTP basic auth credentials
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public BasicAuthIdentityProvider(ConfigMapNameReference ca, SecretNameReference
         this.url = url;
     }
 
+    /**
+     * BasicAuthPasswordIdentityProvider provides identities for users authenticating using HTTP basic auth credentials
+     */
     @JsonProperty("ca")
     public ConfigMapNameReference getCa() {
         return ca;
     }
 
+    /**
+     * BasicAuthPasswordIdentityProvider provides identities for users authenticating using HTTP basic auth credentials
+     */
     @JsonProperty("ca")
     public void setCa(ConfigMapNameReference ca) {
         this.ca = ca;
     }
 
+    /**
+     * BasicAuthPasswordIdentityProvider provides identities for users authenticating using HTTP basic auth credentials
+     */
     @JsonProperty("tlsClientCert")
     public SecretNameReference getTlsClientCert() {
         return tlsClientCert;
     }
 
+    /**
+     * BasicAuthPasswordIdentityProvider provides identities for users authenticating using HTTP basic auth credentials
+     */
     @JsonProperty("tlsClientCert")
     public void setTlsClientCert(SecretNameReference tlsClientCert) {
         this.tlsClientCert = tlsClientCert;
     }
 
+    /**
+     * BasicAuthPasswordIdentityProvider provides identities for users authenticating using HTTP basic auth credentials
+     */
     @JsonProperty("tlsClientKey")
     public SecretNameReference getTlsClientKey() {
         return tlsClientKey;
     }
 
+    /**
+     * BasicAuthPasswordIdentityProvider provides identities for users authenticating using HTTP basic auth credentials
+     */
     @JsonProperty("tlsClientKey")
     public void setTlsClientKey(SecretNameReference tlsClientKey) {
         this.tlsClientKey = tlsClientKey;
     }
 
+    /**
+     * url is the remote URL to connect to
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * url is the remote URL to connect to
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Build.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Build.java
index 12c85d16866..11178d14266 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Build.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Build.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Build configures the behavior of OpenShift builds for the entire cluster. This includes default settings that can be overridden in BuildConfig objects, and overrides which are applied to all builds.<br><p> <br><p> The canonical name is "cluster"<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class Build implements Editable<BuildBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Build";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public Build(String apiVersion, String kind, ObjectMeta metadata, BuildSpec spec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Build configures the behavior of OpenShift builds for the entire cluster. This includes default settings that can be overridden in BuildConfig objects, and overrides which are applied to all builds.<br><p> <br><p> The canonical name is "cluster"<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Build configures the behavior of OpenShift builds for the entire cluster. This includes default settings that can be overridden in BuildConfig objects, and overrides which are applied to all builds.<br><p> <br><p> The canonical name is "cluster"<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Build configures the behavior of OpenShift builds for the entire cluster. This includes default settings that can be overridden in BuildConfig objects, and overrides which are applied to all builds.<br><p> <br><p> The canonical name is "cluster"<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public BuildSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Build configures the behavior of OpenShift builds for the entire cluster. This includes default settings that can be overridden in BuildConfig objects, and overrides which are applied to all builds.<br><p> <br><p> The canonical name is "cluster"<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(BuildSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/BuildDefaults.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/BuildDefaults.java
index 73a61b61d57..e9410c1ea6f 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/BuildDefaults.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/BuildDefaults.java
@@ -108,12 +108,18 @@ public void setDefaultProxy(ProxySpec defaultProxy) {
         this.defaultProxy = defaultProxy;
     }
 
+    /**
+     * Env is a set of default environment variables that will be applied to the build if the specified variables do not exist on the build
+     */
     @JsonProperty("env")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvVar> getEnv() {
         return env;
     }
 
+    /**
+     * Env is a set of default environment variables that will be applied to the build if the specified variables do not exist on the build
+     */
     @JsonProperty("env")
     public void setEnv(List<EnvVar> env) {
         this.env = env;
@@ -129,12 +135,18 @@ public void setGitProxy(ProxySpec gitProxy) {
         this.gitProxy = gitProxy;
     }
 
+    /**
+     * ImageLabels is a list of docker labels that are applied to the resulting image. User can override a default label by providing a label with the same name in their Build/BuildConfig.
+     */
     @JsonProperty("imageLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ImageLabel> getImageLabels() {
         return imageLabels;
     }
 
+    /**
+     * ImageLabels is a list of docker labels that are applied to the resulting image. User can override a default label by providing a label with the same name in their Build/BuildConfig.
+     */
     @JsonProperty("imageLabels")
     public void setImageLabels(List<ImageLabel> imageLabels) {
         this.imageLabels = imageLabels;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/BuildList.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/BuildList.java
index 60d3d082707..a4a3d0b0a2d 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/BuildList.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/BuildList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class BuildList implements Editable<BuildListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.config.v1.Build>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.config.v1.Build> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "BuildList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public BuildList(String apiVersion, List<io.fabric8.openshift.api.model.config.v
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.config.v1.Build> getItems() {
         return items;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.config.v1.Build> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/BuildOverrides.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/BuildOverrides.java
index 6e3d6b18f6a..a7d5d8a34bd 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/BuildOverrides.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/BuildOverrides.java
@@ -96,44 +96,68 @@ public BuildOverrides(Boolean forcePull, List<ImageLabel> imageLabels, Map<Strin
         this.tolerations = tolerations;
     }
 
+    /**
+     * ForcePull overrides, if set, the equivalent value in the builds, i.e. false disables force pull for all builds, true enables force pull for all builds, independently of what each build specifies itself
+     */
     @JsonProperty("forcePull")
     public Boolean getForcePull() {
         return forcePull;
     }
 
+    /**
+     * ForcePull overrides, if set, the equivalent value in the builds, i.e. false disables force pull for all builds, true enables force pull for all builds, independently of what each build specifies itself
+     */
     @JsonProperty("forcePull")
     public void setForcePull(Boolean forcePull) {
         this.forcePull = forcePull;
     }
 
+    /**
+     * ImageLabels is a list of docker labels that are applied to the resulting image. If user provided a label in their Build/BuildConfig with the same name as one in this list, the user's label will be overwritten.
+     */
     @JsonProperty("imageLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ImageLabel> getImageLabels() {
         return imageLabels;
     }
 
+    /**
+     * ImageLabels is a list of docker labels that are applied to the resulting image. If user provided a label in their Build/BuildConfig with the same name as one in this list, the user's label will be overwritten.
+     */
     @JsonProperty("imageLabels")
     public void setImageLabels(List<ImageLabel> imageLabels) {
         this.imageLabels = imageLabels;
     }
 
+    /**
+     * NodeSelector is a selector which must be true for the build pod to fit on a node
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * NodeSelector is a selector which must be true for the build pod to fit on a node
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * Tolerations is a list of Tolerations that will override any existing tolerations set on a build pod.
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * Tolerations is a list of Tolerations that will override any existing tolerations set on a build pod.
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/CertInfo.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/CertInfo.java
index 83cfef4772b..f0b761c202d 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/CertInfo.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/CertInfo.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CertInfo relates a certificate with a private key
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public CertInfo(String certFile, String keyFile) {
         this.keyFile = keyFile;
     }
 
+    /**
+     * CertFile is a file containing a PEM-encoded certificate
+     */
     @JsonProperty("certFile")
     public String getCertFile() {
         return certFile;
     }
 
+    /**
+     * CertFile is a file containing a PEM-encoded certificate
+     */
     @JsonProperty("certFile")
     public void setCertFile(String certFile) {
         this.certFile = certFile;
     }
 
+    /**
+     * KeyFile is a file containing a PEM-encoded private key for the certificate specified by CertFile
+     */
     @JsonProperty("keyFile")
     public String getKeyFile() {
         return keyFile;
     }
 
+    /**
+     * KeyFile is a file containing a PEM-encoded private key for the certificate specified by CertFile
+     */
     @JsonProperty("keyFile")
     public void setKeyFile(String keyFile) {
         this.keyFile = keyFile;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClientConnectionOverrides.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClientConnectionOverrides.java
index 62c9fe73761..422e2ddec34 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClientConnectionOverrides.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClientConnectionOverrides.java
@@ -90,41 +90,65 @@ public ClientConnectionOverrides(String acceptContentTypes, Integer burst, Strin
         this.qps = qps;
     }
 
+    /**
+     * acceptContentTypes defines the Accept header sent by clients when connecting to a server, overriding the default value of 'application/json'. This field will control all connections to the server used by a particular client.
+     */
     @JsonProperty("acceptContentTypes")
     public String getAcceptContentTypes() {
         return acceptContentTypes;
     }
 
+    /**
+     * acceptContentTypes defines the Accept header sent by clients when connecting to a server, overriding the default value of 'application/json'. This field will control all connections to the server used by a particular client.
+     */
     @JsonProperty("acceptContentTypes")
     public void setAcceptContentTypes(String acceptContentTypes) {
         this.acceptContentTypes = acceptContentTypes;
     }
 
+    /**
+     * burst allows extra queries to accumulate when a client is exceeding its rate.
+     */
     @JsonProperty("burst")
     public Integer getBurst() {
         return burst;
     }
 
+    /**
+     * burst allows extra queries to accumulate when a client is exceeding its rate.
+     */
     @JsonProperty("burst")
     public void setBurst(Integer burst) {
         this.burst = burst;
     }
 
+    /**
+     * contentType is the content type used when sending data to the server from this client.
+     */
     @JsonProperty("contentType")
     public String getContentType() {
         return contentType;
     }
 
+    /**
+     * contentType is the content type used when sending data to the server from this client.
+     */
     @JsonProperty("contentType")
     public void setContentType(String contentType) {
         this.contentType = contentType;
     }
 
+    /**
+     * qps controls the number of queries per second allowed for this connection.
+     */
     @JsonProperty("qps")
     public Float getQps() {
         return qps;
     }
 
+    /**
+     * qps controls the number of queries per second allowed for this connection.
+     */
     @JsonProperty("qps")
     public void setQps(Float qps) {
         this.qps = qps;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/CloudControllerManagerStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/CloudControllerManagerStatus.java
index 105f1addc29..1fb6b325cf3 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/CloudControllerManagerStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/CloudControllerManagerStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CloudControllerManagerStatus holds the state of Cloud Controller Manager (a.k.a. CCM or CPI) related settings
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public CloudControllerManagerStatus(String state) {
         this.state = state;
     }
 
+    /**
+     * state determines whether or not an external Cloud Controller Manager is expected to be installed within the cluster. https://kubernetes.io/docs/tasks/administer-cluster/running-cloud-controller/#running-cloud-controller-manager<br><p> <br><p> Valid values are "External", "None" and omitted. When set to "External", new nodes will be tainted as uninitialized when created, preventing them from running workloads until they are initialized by the cloud controller manager. When omitted or set to "None", new nodes will be not tainted and no extra initialization from the cloud controller manager is expected.
+     */
     @JsonProperty("state")
     public String getState() {
         return state;
     }
 
+    /**
+     * state determines whether or not an external Cloud Controller Manager is expected to be installed within the cluster. https://kubernetes.io/docs/tasks/administer-cluster/running-cloud-controller/#running-cloud-controller-manager<br><p> <br><p> Valid values are "External", "None" and omitted. When set to "External", new nodes will be tainted as uninitialized when created, preventing them from running workloads until they are initialized by the cloud controller manager. When omitted or set to "None", new nodes will be not tainted and no extra initialization from the cloud controller manager is expected.
+     */
     @JsonProperty("state")
     public void setState(String state) {
         this.state = state;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/CloudLoadBalancerConfig.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/CloudLoadBalancerConfig.java
index da3b74cf739..2108160a1a4 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/CloudLoadBalancerConfig.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/CloudLoadBalancerConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CloudLoadBalancerConfig contains an union discriminator indicating the type of DNS solution in use within the cluster. When the DNSType is `ClusterHosted`, the cloud's Load Balancer configuration needs to be provided so that the DNS solution hosted within the cluster can be configured with those values.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public CloudLoadBalancerConfig(CloudLoadBalancerIPs clusterHosted, String dnsTyp
         this.dnsType = dnsType;
     }
 
+    /**
+     * CloudLoadBalancerConfig contains an union discriminator indicating the type of DNS solution in use within the cluster. When the DNSType is `ClusterHosted`, the cloud's Load Balancer configuration needs to be provided so that the DNS solution hosted within the cluster can be configured with those values.
+     */
     @JsonProperty("clusterHosted")
     public CloudLoadBalancerIPs getClusterHosted() {
         return clusterHosted;
     }
 
+    /**
+     * CloudLoadBalancerConfig contains an union discriminator indicating the type of DNS solution in use within the cluster. When the DNSType is `ClusterHosted`, the cloud's Load Balancer configuration needs to be provided so that the DNS solution hosted within the cluster can be configured with those values.
+     */
     @JsonProperty("clusterHosted")
     public void setClusterHosted(CloudLoadBalancerIPs clusterHosted) {
         this.clusterHosted = clusterHosted;
     }
 
+    /**
+     * dnsType indicates the type of DNS solution in use within the cluster. Its default value of `PlatformDefault` indicates that the cluster's DNS is the default provided by the cloud platform. It can be set to `ClusterHosted` to bypass the configuration of the cloud default DNS. In this mode, the cluster needs to provide a self-hosted DNS solution for the cluster's installation to succeed. The cluster's use of the cloud's Load Balancers is unaffected by this setting. The value is immutable after it has been set at install time. Currently, there is no way for the customer to add additional DNS entries into the cluster hosted DNS. Enabling this functionality allows the user to start their own DNS solution outside the cluster after installation is complete. The customer would be responsible for configuring this custom DNS solution, and it can be run in addition to the in-cluster DNS solution.
+     */
     @JsonProperty("dnsType")
     public String getDnsType() {
         return dnsType;
     }
 
+    /**
+     * dnsType indicates the type of DNS solution in use within the cluster. Its default value of `PlatformDefault` indicates that the cluster's DNS is the default provided by the cloud platform. It can be set to `ClusterHosted` to bypass the configuration of the cloud default DNS. In this mode, the cluster needs to provide a self-hosted DNS solution for the cluster's installation to succeed. The cluster's use of the cloud's Load Balancers is unaffected by this setting. The value is immutable after it has been set at install time. Currently, there is no way for the customer to add additional DNS entries into the cluster hosted DNS. Enabling this functionality allows the user to start their own DNS solution outside the cluster after installation is complete. The customer would be responsible for configuring this custom DNS solution, and it can be run in addition to the in-cluster DNS solution.
+     */
     @JsonProperty("dnsType")
     public void setDnsType(String dnsType) {
         this.dnsType = dnsType;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/CloudLoadBalancerIPs.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/CloudLoadBalancerIPs.java
index fa96d6cba7d..9defe5b43b4 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/CloudLoadBalancerIPs.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/CloudLoadBalancerIPs.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CloudLoadBalancerIPs contains the Load Balancer IPs for the cloud's API, API-Int and Ingress Load balancers. They will be populated as soon as the respective Load Balancers have been configured. These values are utilized to configure the DNS solution hosted within the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,34 +94,52 @@ public CloudLoadBalancerIPs(List<String> apiIntLoadBalancerIPs, List<String> api
         this.ingressLoadBalancerIPs = ingressLoadBalancerIPs;
     }
 
+    /**
+     * apiIntLoadBalancerIPs holds Load Balancer IPs for the internal API service. These Load Balancer IP addresses can be IPv4 and/or IPv6 addresses. Entries in the apiIntLoadBalancerIPs must be unique. A maximum of 16 IP addresses are permitted.
+     */
     @JsonProperty("apiIntLoadBalancerIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiIntLoadBalancerIPs() {
         return apiIntLoadBalancerIPs;
     }
 
+    /**
+     * apiIntLoadBalancerIPs holds Load Balancer IPs for the internal API service. These Load Balancer IP addresses can be IPv4 and/or IPv6 addresses. Entries in the apiIntLoadBalancerIPs must be unique. A maximum of 16 IP addresses are permitted.
+     */
     @JsonProperty("apiIntLoadBalancerIPs")
     public void setApiIntLoadBalancerIPs(List<String> apiIntLoadBalancerIPs) {
         this.apiIntLoadBalancerIPs = apiIntLoadBalancerIPs;
     }
 
+    /**
+     * apiLoadBalancerIPs holds Load Balancer IPs for the API service. These Load Balancer IP addresses can be IPv4 and/or IPv6 addresses. Could be empty for private clusters. Entries in the apiLoadBalancerIPs must be unique. A maximum of 16 IP addresses are permitted.
+     */
     @JsonProperty("apiLoadBalancerIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiLoadBalancerIPs() {
         return apiLoadBalancerIPs;
     }
 
+    /**
+     * apiLoadBalancerIPs holds Load Balancer IPs for the API service. These Load Balancer IP addresses can be IPv4 and/or IPv6 addresses. Could be empty for private clusters. Entries in the apiLoadBalancerIPs must be unique. A maximum of 16 IP addresses are permitted.
+     */
     @JsonProperty("apiLoadBalancerIPs")
     public void setApiLoadBalancerIPs(List<String> apiLoadBalancerIPs) {
         this.apiLoadBalancerIPs = apiLoadBalancerIPs;
     }
 
+    /**
+     * ingressLoadBalancerIPs holds IPs for Ingress Load Balancers. These Load Balancer IP addresses can be IPv4 and/or IPv6 addresses. Entries in the ingressLoadBalancerIPs must be unique. A maximum of 16 IP addresses are permitted.
+     */
     @JsonProperty("ingressLoadBalancerIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIngressLoadBalancerIPs() {
         return ingressLoadBalancerIPs;
     }
 
+    /**
+     * ingressLoadBalancerIPs holds IPs for Ingress Load Balancers. These Load Balancer IP addresses can be IPv4 and/or IPv6 addresses. Entries in the ingressLoadBalancerIPs must be unique. A maximum of 16 IP addresses are permitted.
+     */
     @JsonProperty("ingressLoadBalancerIPs")
     public void setIngressLoadBalancerIPs(List<String> ingressLoadBalancerIPs) {
         this.ingressLoadBalancerIPs = ingressLoadBalancerIPs;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterCondition.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterCondition.java
index c3b6ea9087e..5b7f483541e 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterCondition.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterCondition is a union of typed cluster conditions.  The 'type' property determines which of the type-specific properties are relevant. When evaluated on a cluster, the condition may match, not match, or fail to evaluate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ClusterCondition(PromQLClusterCondition promql, String type) {
         this.type = type;
     }
 
+    /**
+     * ClusterCondition is a union of typed cluster conditions.  The 'type' property determines which of the type-specific properties are relevant. When evaluated on a cluster, the condition may match, not match, or fail to evaluate.
+     */
     @JsonProperty("promql")
     public PromQLClusterCondition getPromql() {
         return promql;
     }
 
+    /**
+     * ClusterCondition is a union of typed cluster conditions.  The 'type' property determines which of the type-specific properties are relevant. When evaluated on a cluster, the condition may match, not match, or fail to evaluate.
+     */
     @JsonProperty("promql")
     public void setPromql(PromQLClusterCondition promql) {
         this.promql = promql;
     }
 
+    /**
+     * type represents the cluster-condition type. This defines the members and semantics of any additional properties.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type represents the cluster-condition type. This defines the members and semantics of any additional properties.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterNetworkEntry.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterNetworkEntry.java
index cef84c41f95..6a7e0d1ab0f 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterNetworkEntry.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterNetworkEntry.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterNetworkEntry is a contiguous block of IP addresses from which pod IPs are allocated.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ClusterNetworkEntry(String cidr, Long hostPrefix) {
         this.hostPrefix = hostPrefix;
     }
 
+    /**
+     * The complete block for pod IPs.
+     */
     @JsonProperty("cidr")
     public String getCidr() {
         return cidr;
     }
 
+    /**
+     * The complete block for pod IPs.
+     */
     @JsonProperty("cidr")
     public void setCidr(String cidr) {
         this.cidr = cidr;
     }
 
+    /**
+     * The size (prefix) of block to allocate to each node. If this field is not used by the plugin, it can be left unset.
+     */
     @JsonProperty("hostPrefix")
     public Long getHostPrefix() {
         return hostPrefix;
     }
 
+    /**
+     * The size (prefix) of block to allocate to each node. If this field is not used by the plugin, it can be left unset.
+     */
     @JsonProperty("hostPrefix")
     public void setHostPrefix(Long hostPrefix) {
         this.hostPrefix = hostPrefix;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterOperator.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterOperator.java
index 6e49566ed98..9a0338d777f 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterOperator.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterOperator.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterOperator is the Custom Resource object which holds the current state of an operator. This object is used by operators to convey their state to the rest of the cluster.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ClusterOperator implements Editable<ClusterOperatorBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterOperator";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public ClusterOperator(String apiVersion, String kind, ObjectMeta metadata, Clus
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterOperator is the Custom Resource object which holds the current state of an operator. This object is used by operators to convey their state to the rest of the cluster.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterOperator is the Custom Resource object which holds the current state of an operator. This object is used by operators to convey their state to the rest of the cluster.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ClusterOperator is the Custom Resource object which holds the current state of an operator. This object is used by operators to convey their state to the rest of the cluster.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ClusterOperatorSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ClusterOperator is the Custom Resource object which holds the current state of an operator. This object is used by operators to convey their state to the rest of the cluster.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ClusterOperatorSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ClusterOperator is the Custom Resource object which holds the current state of an operator. This object is used by operators to convey their state to the rest of the cluster.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public ClusterOperatorStatus getStatus() {
         return status;
     }
 
+    /**
+     * ClusterOperator is the Custom Resource object which holds the current state of an operator. This object is used by operators to convey their state to the rest of the cluster.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(ClusterOperatorStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterOperatorList.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterOperatorList.java
index d994bce1d42..0073c0fef75 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterOperatorList.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterOperatorList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterOperatorList is a list of OperatorStatus resources.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ClusterOperatorList implements Editable<ClusterOperatorListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.config.v1.ClusterOperator>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.config.v1.ClusterOperator> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterOperatorList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterOperatorList(String apiVersion, List<io.fabric8.openshift.api.mode
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ClusterOperatorList is a list of OperatorStatus resources.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.config.v1.ClusterOperator> getItems() {
         return items;
     }
 
+    /**
+     * ClusterOperatorList is a list of OperatorStatus resources.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.config.v1.ClusterOperator> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterOperatorList is a list of OperatorStatus resources.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterOperatorList is a list of OperatorStatus resources.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterOperatorSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterOperatorSpec.java
index 6fb55c323b1..c2af2d496e9 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterOperatorSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterOperatorSpec.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterOperatorSpec is empty for now, but you could imagine holding information like "pause".
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterOperatorStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterOperatorStatus.java
index 3e68b241ff5..dcae221364b 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterOperatorStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterOperatorStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterOperatorStatus provides information about the status of the operator.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -96,45 +99,69 @@ public ClusterOperatorStatus(List<ClusterOperatorStatusCondition> conditions, Ob
         this.versions = versions;
     }
 
+    /**
+     * conditions describes the state of the operator's managed and monitored components.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ClusterOperatorStatusCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions describes the state of the operator's managed and monitored components.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ClusterOperatorStatusCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ClusterOperatorStatus provides information about the status of the operator.
+     */
     @JsonProperty("extension")
     public Object getExtension() {
         return extension;
     }
 
+    /**
+     * ClusterOperatorStatus provides information about the status of the operator.
+     */
     @JsonProperty("extension")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setExtension(Object extension) {
         this.extension = extension;
     }
 
+    /**
+     * relatedObjects is a list of objects that are "interesting" or related to this operator.  Common uses are: 1. the detailed resource driving the operator 2. operator namespaces 3. operand namespaces
+     */
     @JsonProperty("relatedObjects")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ObjectReference> getRelatedObjects() {
         return relatedObjects;
     }
 
+    /**
+     * relatedObjects is a list of objects that are "interesting" or related to this operator.  Common uses are: 1. the detailed resource driving the operator 2. operator namespaces 3. operand namespaces
+     */
     @JsonProperty("relatedObjects")
     public void setRelatedObjects(List<ObjectReference> relatedObjects) {
         this.relatedObjects = relatedObjects;
     }
 
+    /**
+     * versions is a slice of operator and operand version tuples.  Operators which manage multiple operands will have multiple operand entries in the array.  Available operators must report the version of the operator itself with the name "operator". An operator reports a new "operator" version when it has rolled out the new version to all of its operands.
+     */
     @JsonProperty("versions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperandVersion> getVersions() {
         return versions;
     }
 
+    /**
+     * versions is a slice of operator and operand version tuples.  Operators which manage multiple operands will have multiple operand entries in the array.  Available operators must report the version of the operator itself with the name "operator". An operator reports a new "operator" version when it has rolled out the new version to all of its operands.
+     */
     @JsonProperty("versions")
     public void setVersions(List<OperandVersion> versions) {
         this.versions = versions;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterOperatorStatusCondition.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterOperatorStatusCondition.java
index b76a3c00017..4073aa542c8 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterOperatorStatusCondition.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterOperatorStatusCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterOperatorStatusCondition represents the state of the operator's managed and monitored components.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public ClusterOperatorStatusCondition(String lastTransitionTime, String message,
         this.type = type;
     }
 
+    /**
+     * ClusterOperatorStatusCondition represents the state of the operator's managed and monitored components.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * ClusterOperatorStatusCondition represents the state of the operator's managed and monitored components.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * message provides additional information about the current condition. This is only to be consumed by humans.  It may contain Line Feed characters (U+000A), which should be rendered as new lines.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message provides additional information about the current condition. This is only to be consumed by humans.  It may contain Line Feed characters (U+000A), which should be rendered as new lines.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * reason is the CamelCase reason for the condition's current status.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * reason is the CamelCase reason for the condition's current status.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * type specifies the aspect reported by this condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type specifies the aspect reported by this condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterVersion.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterVersion.java
index 24522e7883b..a9071160001 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterVersion.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterVersion.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterVersion is the configuration for the ClusterVersionOperator. This is where parameters related to automatic updates can be set.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ClusterVersion implements Editable<ClusterVersionBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterVersion";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public ClusterVersion(String apiVersion, String kind, ObjectMeta metadata, Clust
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterVersion is the configuration for the ClusterVersionOperator. This is where parameters related to automatic updates can be set.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterVersion is the configuration for the ClusterVersionOperator. This is where parameters related to automatic updates can be set.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ClusterVersion is the configuration for the ClusterVersionOperator. This is where parameters related to automatic updates can be set.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ClusterVersionSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ClusterVersion is the configuration for the ClusterVersionOperator. This is where parameters related to automatic updates can be set.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ClusterVersionSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ClusterVersion is the configuration for the ClusterVersionOperator. This is where parameters related to automatic updates can be set.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public ClusterVersionStatus getStatus() {
         return status;
     }
 
+    /**
+     * ClusterVersion is the configuration for the ClusterVersionOperator. This is where parameters related to automatic updates can be set.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(ClusterVersionStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterVersionCapabilitiesSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterVersionCapabilitiesSpec.java
index b3c40131a9b..53d77e80173 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterVersionCapabilitiesSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterVersionCapabilitiesSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterVersionCapabilitiesSpec selects the managed set of optional, core cluster components.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public ClusterVersionCapabilitiesSpec(List<String> additionalEnabledCapabilities
         this.baselineCapabilitySet = baselineCapabilitySet;
     }
 
+    /**
+     * additionalEnabledCapabilities extends the set of managed capabilities beyond the baseline defined in baselineCapabilitySet.  The default is an empty set.
+     */
     @JsonProperty("additionalEnabledCapabilities")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAdditionalEnabledCapabilities() {
         return additionalEnabledCapabilities;
     }
 
+    /**
+     * additionalEnabledCapabilities extends the set of managed capabilities beyond the baseline defined in baselineCapabilitySet.  The default is an empty set.
+     */
     @JsonProperty("additionalEnabledCapabilities")
     public void setAdditionalEnabledCapabilities(List<String> additionalEnabledCapabilities) {
         this.additionalEnabledCapabilities = additionalEnabledCapabilities;
     }
 
+    /**
+     * baselineCapabilitySet selects an initial set of optional capabilities to enable, which can be extended via additionalEnabledCapabilities.  If unset, the cluster will choose a default, and the default may change over time. The current default is vCurrent.
+     */
     @JsonProperty("baselineCapabilitySet")
     public String getBaselineCapabilitySet() {
         return baselineCapabilitySet;
     }
 
+    /**
+     * baselineCapabilitySet selects an initial set of optional capabilities to enable, which can be extended via additionalEnabledCapabilities.  If unset, the cluster will choose a default, and the default may change over time. The current default is vCurrent.
+     */
     @JsonProperty("baselineCapabilitySet")
     public void setBaselineCapabilitySet(String baselineCapabilitySet) {
         this.baselineCapabilitySet = baselineCapabilitySet;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterVersionCapabilitiesStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterVersionCapabilitiesStatus.java
index 4e62de57e6f..df23f727e31 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterVersionCapabilitiesStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterVersionCapabilitiesStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterVersionCapabilitiesStatus describes the state of optional, core cluster components.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public ClusterVersionCapabilitiesStatus(List<String> enabledCapabilities, List<S
         this.knownCapabilities = knownCapabilities;
     }
 
+    /**
+     * enabledCapabilities lists all the capabilities that are currently managed.
+     */
     @JsonProperty("enabledCapabilities")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEnabledCapabilities() {
         return enabledCapabilities;
     }
 
+    /**
+     * enabledCapabilities lists all the capabilities that are currently managed.
+     */
     @JsonProperty("enabledCapabilities")
     public void setEnabledCapabilities(List<String> enabledCapabilities) {
         this.enabledCapabilities = enabledCapabilities;
     }
 
+    /**
+     * knownCapabilities lists all the capabilities known to the current cluster.
+     */
     @JsonProperty("knownCapabilities")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getKnownCapabilities() {
         return knownCapabilities;
     }
 
+    /**
+     * knownCapabilities lists all the capabilities known to the current cluster.
+     */
     @JsonProperty("knownCapabilities")
     public void setKnownCapabilities(List<String> knownCapabilities) {
         this.knownCapabilities = knownCapabilities;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterVersionList.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterVersionList.java
index a2158dcf39b..801f7d42d29 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterVersionList.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterVersionList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterVersionList is a list of ClusterVersion resources.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ClusterVersionList implements Editable<ClusterVersionListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.config.v1.ClusterVersion>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.config.v1.ClusterVersion> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterVersionList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterVersionList(String apiVersion, List<io.fabric8.openshift.api.model
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ClusterVersionList is a list of ClusterVersion resources.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.config.v1.ClusterVersion> getItems() {
         return items;
     }
 
+    /**
+     * ClusterVersionList is a list of ClusterVersion resources.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.config.v1.ClusterVersion> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterVersionList is a list of ClusterVersion resources.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterVersionList is a list of ClusterVersion resources.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterVersionSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterVersionSpec.java
index 9fa3972eed5..a024c8b6bd1 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterVersionSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterVersionSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterVersionSpec is the desired version state of the cluster. It includes the version the cluster should be at, how the cluster is identified, and where the cluster should look for version updates.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -106,73 +109,115 @@ public ClusterVersionSpec(ClusterVersionCapabilitiesSpec capabilities, String ch
         this.upstream = upstream;
     }
 
+    /**
+     * ClusterVersionSpec is the desired version state of the cluster. It includes the version the cluster should be at, how the cluster is identified, and where the cluster should look for version updates.
+     */
     @JsonProperty("capabilities")
     public ClusterVersionCapabilitiesSpec getCapabilities() {
         return capabilities;
     }
 
+    /**
+     * ClusterVersionSpec is the desired version state of the cluster. It includes the version the cluster should be at, how the cluster is identified, and where the cluster should look for version updates.
+     */
     @JsonProperty("capabilities")
     public void setCapabilities(ClusterVersionCapabilitiesSpec capabilities) {
         this.capabilities = capabilities;
     }
 
+    /**
+     * channel is an identifier for explicitly requesting that a non-default set of updates be applied to this cluster. The default channel will be contain stable updates that are appropriate for production clusters.
+     */
     @JsonProperty("channel")
     public String getChannel() {
         return channel;
     }
 
+    /**
+     * channel is an identifier for explicitly requesting that a non-default set of updates be applied to this cluster. The default channel will be contain stable updates that are appropriate for production clusters.
+     */
     @JsonProperty("channel")
     public void setChannel(String channel) {
         this.channel = channel;
     }
 
+    /**
+     * clusterID uniquely identifies this cluster. This is expected to be an RFC4122 UUID value (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx in hexadecimal values). This is a required field.
+     */
     @JsonProperty("clusterID")
     public String getClusterID() {
         return clusterID;
     }
 
+    /**
+     * clusterID uniquely identifies this cluster. This is expected to be an RFC4122 UUID value (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx in hexadecimal values). This is a required field.
+     */
     @JsonProperty("clusterID")
     public void setClusterID(String clusterID) {
         this.clusterID = clusterID;
     }
 
+    /**
+     * ClusterVersionSpec is the desired version state of the cluster. It includes the version the cluster should be at, how the cluster is identified, and where the cluster should look for version updates.
+     */
     @JsonProperty("desiredUpdate")
     public Update getDesiredUpdate() {
         return desiredUpdate;
     }
 
+    /**
+     * ClusterVersionSpec is the desired version state of the cluster. It includes the version the cluster should be at, how the cluster is identified, and where the cluster should look for version updates.
+     */
     @JsonProperty("desiredUpdate")
     public void setDesiredUpdate(Update desiredUpdate) {
         this.desiredUpdate = desiredUpdate;
     }
 
+    /**
+     * overrides is list of overides for components that are managed by cluster version operator. Marking a component unmanaged will prevent the operator from creating or updating the object.
+     */
     @JsonProperty("overrides")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ComponentOverride> getOverrides() {
         return overrides;
     }
 
+    /**
+     * overrides is list of overides for components that are managed by cluster version operator. Marking a component unmanaged will prevent the operator from creating or updating the object.
+     */
     @JsonProperty("overrides")
     public void setOverrides(List<ComponentOverride> overrides) {
         this.overrides = overrides;
     }
 
+    /**
+     * signatureStores contains the upstream URIs to verify release signatures and optional reference to a config map by name containing the PEM-encoded CA bundle.<br><p> <br><p> By default, CVO will use existing signature stores if this property is empty. The CVO will check the release signatures in the local ConfigMaps first. It will search for a valid signature in these stores in parallel only when local ConfigMaps did not include a valid signature. Validation will fail if none of the signature stores reply with valid signature before timeout. Setting signatureStores will replace the default signature stores with custom signature stores. Default stores can be used with custom signature stores by adding them manually.<br><p> <br><p> A maximum of 32 signature stores may be configured.
+     */
     @JsonProperty("signatureStores")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SignatureStore> getSignatureStores() {
         return signatureStores;
     }
 
+    /**
+     * signatureStores contains the upstream URIs to verify release signatures and optional reference to a config map by name containing the PEM-encoded CA bundle.<br><p> <br><p> By default, CVO will use existing signature stores if this property is empty. The CVO will check the release signatures in the local ConfigMaps first. It will search for a valid signature in these stores in parallel only when local ConfigMaps did not include a valid signature. Validation will fail if none of the signature stores reply with valid signature before timeout. Setting signatureStores will replace the default signature stores with custom signature stores. Default stores can be used with custom signature stores by adding them manually.<br><p> <br><p> A maximum of 32 signature stores may be configured.
+     */
     @JsonProperty("signatureStores")
     public void setSignatureStores(List<SignatureStore> signatureStores) {
         this.signatureStores = signatureStores;
     }
 
+    /**
+     * upstream may be used to specify the preferred update server. By default it will use the appropriate update server for the cluster and region.
+     */
     @JsonProperty("upstream")
     public String getUpstream() {
         return upstream;
     }
 
+    /**
+     * upstream may be used to specify the preferred update server. By default it will use the appropriate update server for the cluster and region.
+     */
     @JsonProperty("upstream")
     public void setUpstream(String upstream) {
         this.upstream = upstream;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterVersionStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterVersionStatus.java
index 0dde608cd9c..3db5f7707c3 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterVersionStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ClusterVersionStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterVersionStatus reports the status of the cluster versioning, including any upgrades that are in progress. The current field will be set to whichever version the cluster is reconciling to, and the conditions array will report whether the update succeeded, is in progress, or is failing.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -112,85 +115,133 @@ public ClusterVersionStatus(List<Release> availableUpdates, ClusterVersionCapabi
         this.versionHash = versionHash;
     }
 
+    /**
+     * availableUpdates contains updates recommended for this cluster. Updates which appear in conditionalUpdates but not in availableUpdates may expose this cluster to known issues. This list may be empty if no updates are recommended, if the update service is unavailable, or if an invalid channel has been specified.
+     */
     @JsonProperty("availableUpdates")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Release> getAvailableUpdates() {
         return availableUpdates;
     }
 
+    /**
+     * availableUpdates contains updates recommended for this cluster. Updates which appear in conditionalUpdates but not in availableUpdates may expose this cluster to known issues. This list may be empty if no updates are recommended, if the update service is unavailable, or if an invalid channel has been specified.
+     */
     @JsonProperty("availableUpdates")
     public void setAvailableUpdates(List<Release> availableUpdates) {
         this.availableUpdates = availableUpdates;
     }
 
+    /**
+     * ClusterVersionStatus reports the status of the cluster versioning, including any upgrades that are in progress. The current field will be set to whichever version the cluster is reconciling to, and the conditions array will report whether the update succeeded, is in progress, or is failing.
+     */
     @JsonProperty("capabilities")
     public ClusterVersionCapabilitiesStatus getCapabilities() {
         return capabilities;
     }
 
+    /**
+     * ClusterVersionStatus reports the status of the cluster versioning, including any upgrades that are in progress. The current field will be set to whichever version the cluster is reconciling to, and the conditions array will report whether the update succeeded, is in progress, or is failing.
+     */
     @JsonProperty("capabilities")
     public void setCapabilities(ClusterVersionCapabilitiesStatus capabilities) {
         this.capabilities = capabilities;
     }
 
+    /**
+     * conditionalUpdates contains the list of updates that may be recommended for this cluster if it meets specific required conditions. Consumers interested in the set of updates that are actually recommended for this cluster should use availableUpdates. This list may be empty if no updates are recommended, if the update service is unavailable, or if an empty or invalid channel has been specified.
+     */
     @JsonProperty("conditionalUpdates")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ConditionalUpdate> getConditionalUpdates() {
         return conditionalUpdates;
     }
 
+    /**
+     * conditionalUpdates contains the list of updates that may be recommended for this cluster if it meets specific required conditions. Consumers interested in the set of updates that are actually recommended for this cluster should use availableUpdates. This list may be empty if no updates are recommended, if the update service is unavailable, or if an empty or invalid channel has been specified.
+     */
     @JsonProperty("conditionalUpdates")
     public void setConditionalUpdates(List<ConditionalUpdate> conditionalUpdates) {
         this.conditionalUpdates = conditionalUpdates;
     }
 
+    /**
+     * conditions provides information about the cluster version. The condition "Available" is set to true if the desiredUpdate has been reached. The condition "Progressing" is set to true if an update is being applied. The condition "Degraded" is set to true if an update is currently blocked by a temporary or permanent error. Conditions are only valid for the current desiredUpdate when metadata.generation is equal to status.generation.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ClusterOperatorStatusCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions provides information about the cluster version. The condition "Available" is set to true if the desiredUpdate has been reached. The condition "Progressing" is set to true if an update is being applied. The condition "Degraded" is set to true if an update is currently blocked by a temporary or permanent error. Conditions are only valid for the current desiredUpdate when metadata.generation is equal to status.generation.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ClusterOperatorStatusCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ClusterVersionStatus reports the status of the cluster versioning, including any upgrades that are in progress. The current field will be set to whichever version the cluster is reconciling to, and the conditions array will report whether the update succeeded, is in progress, or is failing.
+     */
     @JsonProperty("desired")
     public Release getDesired() {
         return desired;
     }
 
+    /**
+     * ClusterVersionStatus reports the status of the cluster versioning, including any upgrades that are in progress. The current field will be set to whichever version the cluster is reconciling to, and the conditions array will report whether the update succeeded, is in progress, or is failing.
+     */
     @JsonProperty("desired")
     public void setDesired(Release desired) {
         this.desired = desired;
     }
 
+    /**
+     * history contains a list of the most recent versions applied to the cluster. This value may be empty during cluster startup, and then will be updated when a new update is being applied. The newest update is first in the list and it is ordered by recency. Updates in the history have state Completed if the rollout completed - if an update was failing or halfway applied the state will be Partial. Only a limited amount of update history is preserved.
+     */
     @JsonProperty("history")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<UpdateHistory> getHistory() {
         return history;
     }
 
+    /**
+     * history contains a list of the most recent versions applied to the cluster. This value may be empty during cluster startup, and then will be updated when a new update is being applied. The newest update is first in the list and it is ordered by recency. Updates in the history have state Completed if the rollout completed - if an update was failing or halfway applied the state will be Partial. Only a limited amount of update history is preserved.
+     */
     @JsonProperty("history")
     public void setHistory(List<UpdateHistory> history) {
         this.history = history;
     }
 
+    /**
+     * observedGeneration reports which version of the spec is being synced. If this value is not equal to metadata.generation, then the desired and conditions fields may represent a previous version.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration reports which version of the spec is being synced. If this value is not equal to metadata.generation, then the desired and conditions fields may represent a previous version.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * versionHash is a fingerprint of the content that the cluster will be updated with. It is used by the operator to avoid unnecessary work and is for internal use only.
+     */
     @JsonProperty("versionHash")
     public String getVersionHash() {
         return versionHash;
     }
 
+    /**
+     * versionHash is a fingerprint of the content that the cluster will be updated with. It is used by the operator to avoid unnecessary work and is for internal use only.
+     */
     @JsonProperty("versionHash")
     public void setVersionHash(String versionHash) {
         this.versionHash = versionHash;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ComponentOverride.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ComponentOverride.java
index 72b6be5cf36..01576dc63ae 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ComponentOverride.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ComponentOverride.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ComponentOverride allows overriding cluster version operator's behavior for a component.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public ComponentOverride(String group, String kind, String name, String namespac
         this.unmanaged = unmanaged;
     }
 
+    /**
+     * group identifies the API group that the kind is in.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * group identifies the API group that the kind is in.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * kind indentifies which object to override.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * kind indentifies which object to override.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * name is the component's name.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the component's name.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * namespace is the component's namespace. If the resource is cluster scoped, the namespace should be empty.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * namespace is the component's namespace. If the resource is cluster scoped, the namespace should be empty.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * unmanaged controls if cluster version operator should stop managing the resources in this cluster. Default: false
+     */
     @JsonProperty("unmanaged")
     public Boolean getUnmanaged() {
         return unmanaged;
     }
 
+    /**
+     * unmanaged controls if cluster version operator should stop managing the resources in this cluster. Default: false
+     */
     @JsonProperty("unmanaged")
     public void setUnmanaged(Boolean unmanaged) {
         this.unmanaged = unmanaged;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ComponentRouteSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ComponentRouteSpec.java
index 4ee62cce7ad..6f533d74123 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ComponentRouteSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ComponentRouteSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ComponentRouteSpec allows for configuration of a route's hostname and serving certificate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ComponentRouteSpec(String hostname, String name, String namespace, Secret
         this.servingCertKeyPairSecret = servingCertKeyPairSecret;
     }
 
+    /**
+     * hostname is the hostname that should be used by the route.
+     */
     @JsonProperty("hostname")
     public String getHostname() {
         return hostname;
     }
 
+    /**
+     * hostname is the hostname that should be used by the route.
+     */
     @JsonProperty("hostname")
     public void setHostname(String hostname) {
         this.hostname = hostname;
     }
 
+    /**
+     * name is the logical name of the route to customize.<br><p> <br><p> The namespace and name of this componentRoute must match a corresponding entry in the list of status.componentRoutes if the route is to be customized.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the logical name of the route to customize.<br><p> <br><p> The namespace and name of this componentRoute must match a corresponding entry in the list of status.componentRoutes if the route is to be customized.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * namespace is the namespace of the route to customize.<br><p> <br><p> The namespace and name of this componentRoute must match a corresponding entry in the list of status.componentRoutes if the route is to be customized.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * namespace is the namespace of the route to customize.<br><p> <br><p> The namespace and name of this componentRoute must match a corresponding entry in the list of status.componentRoutes if the route is to be customized.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * ComponentRouteSpec allows for configuration of a route's hostname and serving certificate.
+     */
     @JsonProperty("servingCertKeyPairSecret")
     public SecretNameReference getServingCertKeyPairSecret() {
         return servingCertKeyPairSecret;
     }
 
+    /**
+     * ComponentRouteSpec allows for configuration of a route's hostname and serving certificate.
+     */
     @JsonProperty("servingCertKeyPairSecret")
     public void setServingCertKeyPairSecret(SecretNameReference servingCertKeyPairSecret) {
         this.servingCertKeyPairSecret = servingCertKeyPairSecret;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ComponentRouteStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ComponentRouteStatus.java
index 66e27f05537..8815fd486ea 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ComponentRouteStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ComponentRouteStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ComponentRouteStatus contains information allowing configuration of a route's hostname and serving certificate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -109,75 +112,117 @@ public ComponentRouteStatus(List<Condition> conditions, List<String> consumingUs
         this.relatedObjects = relatedObjects;
     }
 
+    /**
+     * conditions are used to communicate the state of the componentRoutes entry.<br><p> <br><p> Supported conditions include Available, Degraded and Progressing.<br><p> <br><p> If available is true, the content served by the route can be accessed by users. This includes cases where a default may continue to serve content while the customized route specified by the cluster-admin is being configured.<br><p> <br><p> If Degraded is true, that means something has gone wrong trying to handle the componentRoutes entry. The currentHostnames field may or may not be in effect.<br><p> <br><p> If Progressing is true, that means the component is taking some action related to the componentRoutes entry.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions are used to communicate the state of the componentRoutes entry.<br><p> <br><p> Supported conditions include Available, Degraded and Progressing.<br><p> <br><p> If available is true, the content served by the route can be accessed by users. This includes cases where a default may continue to serve content while the customized route specified by the cluster-admin is being configured.<br><p> <br><p> If Degraded is true, that means something has gone wrong trying to handle the componentRoutes entry. The currentHostnames field may or may not be in effect.<br><p> <br><p> If Progressing is true, that means the component is taking some action related to the componentRoutes entry.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * consumingUsers is a slice of ServiceAccounts that need to have read permission on the servingCertKeyPairSecret secret.
+     */
     @JsonProperty("consumingUsers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getConsumingUsers() {
         return consumingUsers;
     }
 
+    /**
+     * consumingUsers is a slice of ServiceAccounts that need to have read permission on the servingCertKeyPairSecret secret.
+     */
     @JsonProperty("consumingUsers")
     public void setConsumingUsers(List<String> consumingUsers) {
         this.consumingUsers = consumingUsers;
     }
 
+    /**
+     * currentHostnames is the list of current names used by the route. Typically, this list should consist of a single hostname, but if multiple hostnames are supported by the route the operator may write multiple entries to this list.
+     */
     @JsonProperty("currentHostnames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCurrentHostnames() {
         return currentHostnames;
     }
 
+    /**
+     * currentHostnames is the list of current names used by the route. Typically, this list should consist of a single hostname, but if multiple hostnames are supported by the route the operator may write multiple entries to this list.
+     */
     @JsonProperty("currentHostnames")
     public void setCurrentHostnames(List<String> currentHostnames) {
         this.currentHostnames = currentHostnames;
     }
 
+    /**
+     * defaultHostname is the hostname of this route prior to customization.
+     */
     @JsonProperty("defaultHostname")
     public String getDefaultHostname() {
         return defaultHostname;
     }
 
+    /**
+     * defaultHostname is the hostname of this route prior to customization.
+     */
     @JsonProperty("defaultHostname")
     public void setDefaultHostname(String defaultHostname) {
         this.defaultHostname = defaultHostname;
     }
 
+    /**
+     * name is the logical name of the route to customize. It does not have to be the actual name of a route resource but it cannot be renamed.<br><p> <br><p> The namespace and name of this componentRoute must match a corresponding entry in the list of spec.componentRoutes if the route is to be customized.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the logical name of the route to customize. It does not have to be the actual name of a route resource but it cannot be renamed.<br><p> <br><p> The namespace and name of this componentRoute must match a corresponding entry in the list of spec.componentRoutes if the route is to be customized.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * namespace is the namespace of the route to customize. It must be a real namespace. Using an actual namespace ensures that no two components will conflict and the same component can be installed multiple times.<br><p> <br><p> The namespace and name of this componentRoute must match a corresponding entry in the list of spec.componentRoutes if the route is to be customized.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * namespace is the namespace of the route to customize. It must be a real namespace. Using an actual namespace ensures that no two components will conflict and the same component can be installed multiple times.<br><p> <br><p> The namespace and name of this componentRoute must match a corresponding entry in the list of spec.componentRoutes if the route is to be customized.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * relatedObjects is a list of resources which are useful when debugging or inspecting how spec.componentRoutes is applied.
+     */
     @JsonProperty("relatedObjects")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ObjectReference> getRelatedObjects() {
         return relatedObjects;
     }
 
+    /**
+     * relatedObjects is a list of resources which are useful when debugging or inspecting how spec.componentRoutes is applied.
+     */
     @JsonProperty("relatedObjects")
     public void setRelatedObjects(List<ObjectReference> relatedObjects) {
         this.relatedObjects = relatedObjects;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConditionalUpdate.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConditionalUpdate.java
index 906582556cc..b1be3a1d527 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConditionalUpdate.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConditionalUpdate.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConditionalUpdate represents an update which is recommended to some clusters on the version the current cluster is reconciling, but which may not be recommended for the current cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,33 +94,51 @@ public ConditionalUpdate(List<Condition> conditions, Release release, List<Condi
         this.risks = risks;
     }
 
+    /**
+     * conditions represents the observations of the conditional update's current status. Known types are: &#42; Recommended, for whether the update is recommended for the current cluster.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions represents the observations of the conditional update's current status. Known types are: &#42; Recommended, for whether the update is recommended for the current cluster.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ConditionalUpdate represents an update which is recommended to some clusters on the version the current cluster is reconciling, but which may not be recommended for the current cluster.
+     */
     @JsonProperty("release")
     public Release getRelease() {
         return release;
     }
 
+    /**
+     * ConditionalUpdate represents an update which is recommended to some clusters on the version the current cluster is reconciling, but which may not be recommended for the current cluster.
+     */
     @JsonProperty("release")
     public void setRelease(Release release) {
         this.release = release;
     }
 
+    /**
+     * risks represents the range of issues associated with updating to the target release. The cluster-version operator will evaluate all entries, and only recommend the update if there is at least one entry and all entries recommend the update.
+     */
     @JsonProperty("risks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ConditionalUpdateRisk> getRisks() {
         return risks;
     }
 
+    /**
+     * risks represents the range of issues associated with updating to the target release. The cluster-version operator will evaluate all entries, and only recommend the update if there is at least one entry and all entries recommend the update.
+     */
     @JsonProperty("risks")
     public void setRisks(List<ConditionalUpdateRisk> risks) {
         this.risks = risks;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConditionalUpdateRisk.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConditionalUpdateRisk.java
index 36d7012a5b0..c6c83fce36a 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConditionalUpdateRisk.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConditionalUpdateRisk.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConditionalUpdateRisk represents a reason and cluster-state for not recommending a conditional update.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public ConditionalUpdateRisk(List<ClusterCondition> matchingRules, String messag
         this.url = url;
     }
 
+    /**
+     * matchingRules is a slice of conditions for deciding which clusters match the risk and which do not. The slice is ordered by decreasing precedence. The cluster-version operator will walk the slice in order, and stop after the first it can successfully evaluate. If no condition can be successfully evaluated, the update will not be recommended.
+     */
     @JsonProperty("matchingRules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ClusterCondition> getMatchingRules() {
         return matchingRules;
     }
 
+    /**
+     * matchingRules is a slice of conditions for deciding which clusters match the risk and which do not. The slice is ordered by decreasing precedence. The cluster-version operator will walk the slice in order, and stop after the first it can successfully evaluate. If no condition can be successfully evaluated, the update will not be recommended.
+     */
     @JsonProperty("matchingRules")
     public void setMatchingRules(List<ClusterCondition> matchingRules) {
         this.matchingRules = matchingRules;
     }
 
+    /**
+     * message provides additional information about the risk of updating, in the event that matchingRules match the cluster state. This is only to be consumed by humans. It may contain Line Feed characters (U+000A), which should be rendered as new lines.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message provides additional information about the risk of updating, in the event that matchingRules match the cluster state. This is only to be consumed by humans. It may contain Line Feed characters (U+000A), which should be rendered as new lines.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * name is the CamelCase reason for not recommending a conditional update, in the event that matchingRules match the cluster state.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the CamelCase reason for not recommending a conditional update, in the event that matchingRules match the cluster state.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * url contains information about this risk.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * url contains information about this risk.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConfigMapFileReference.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConfigMapFileReference.java
index a3d0e4ff883..06c1308df3b 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConfigMapFileReference.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConfigMapFileReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConfigMapFileReference references a config map in a specific namespace. The namespace must be specified at the point of use.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ConfigMapFileReference(String key, String name) {
         this.name = name;
     }
 
+    /**
+     * Key allows pointing to a specific key/value inside of the configmap.  This is useful for logical file references.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * Key allows pointing to a specific key/value inside of the configmap.  This is useful for logical file references.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * ConfigMapFileReference references a config map in a specific namespace. The namespace must be specified at the point of use.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * ConfigMapFileReference references a config map in a specific namespace. The namespace must be specified at the point of use.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConfigMapNameReference.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConfigMapNameReference.java
index e967df2fb39..8909a51c863 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConfigMapNameReference.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConfigMapNameReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConfigMapNameReference references a config map in a specific namespace. The namespace must be specified at the point of use.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ConfigMapNameReference(String name) {
         this.name = name;
     }
 
+    /**
+     * name is the metadata.name of the referenced config map
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the metadata.name of the referenced config map
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Console.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Console.java
index a4a49a75ea4..ffabd75a29c 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Console.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Console.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Console holds cluster-wide configuration for the web console, including the logout URL, and reports the public URL of the console. The canonical name is `cluster`.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Console implements Editable<ConsoleBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Console";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public Console(String apiVersion, String kind, ObjectMeta metadata, ConsoleSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Console holds cluster-wide configuration for the web console, including the logout URL, and reports the public URL of the console. The canonical name is `cluster`.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Console holds cluster-wide configuration for the web console, including the logout URL, and reports the public URL of the console. The canonical name is `cluster`.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Console holds cluster-wide configuration for the web console, including the logout URL, and reports the public URL of the console. The canonical name is `cluster`.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ConsoleSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Console holds cluster-wide configuration for the web console, including the logout URL, and reports the public URL of the console. The canonical name is `cluster`.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ConsoleSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Console holds cluster-wide configuration for the web console, including the logout URL, and reports the public URL of the console. The canonical name is `cluster`.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public ConsoleStatus getStatus() {
         return status;
     }
 
+    /**
+     * Console holds cluster-wide configuration for the web console, including the logout URL, and reports the public URL of the console. The canonical name is `cluster`.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(ConsoleStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConsoleAuthentication.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConsoleAuthentication.java
index 540783d0e3f..9859153817d 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConsoleAuthentication.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConsoleAuthentication.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleAuthentication defines a list of optional configuration for console authentication.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ConsoleAuthentication(String logoutRedirect) {
         this.logoutRedirect = logoutRedirect;
     }
 
+    /**
+     * An optional, absolute URL to redirect web browsers to after logging out of the console. If not specified, it will redirect to the default login page. This is required when using an identity provider that supports single sign-on (SSO) such as: - OpenID (Keycloak, Azure) - RequestHeader (GSSAPI, SSPI, SAML) - OAuth (GitHub, GitLab, Google) Logging out of the console will destroy the user's token. The logoutRedirect provides the user the option to perform single logout (SLO) through the identity provider to destroy their single sign-on session.
+     */
     @JsonProperty("logoutRedirect")
     public String getLogoutRedirect() {
         return logoutRedirect;
     }
 
+    /**
+     * An optional, absolute URL to redirect web browsers to after logging out of the console. If not specified, it will redirect to the default login page. This is required when using an identity provider that supports single sign-on (SSO) such as: - OpenID (Keycloak, Azure) - RequestHeader (GSSAPI, SSPI, SAML) - OAuth (GitHub, GitLab, Google) Logging out of the console will destroy the user's token. The logoutRedirect provides the user the option to perform single logout (SLO) through the identity provider to destroy their single sign-on session.
+     */
     @JsonProperty("logoutRedirect")
     public void setLogoutRedirect(String logoutRedirect) {
         this.logoutRedirect = logoutRedirect;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConsoleList.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConsoleList.java
index 0fe56912b73..8f5649d48a3 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConsoleList.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConsoleList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ConsoleList implements Editable<ConsoleListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.config.v1.Console>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.config.v1.Console> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ConsoleList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ConsoleList(String apiVersion, List<io.fabric8.openshift.api.model.config
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.config.v1.Console> getItems() {
         return items;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.config.v1.Console> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConsoleSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConsoleSpec.java
index b623f1944d8..9bb925b3315 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConsoleSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConsoleSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleSpec is the specification of the desired behavior of the Console.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ConsoleSpec(ConsoleAuthentication authentication) {
         this.authentication = authentication;
     }
 
+    /**
+     * ConsoleSpec is the specification of the desired behavior of the Console.
+     */
     @JsonProperty("authentication")
     public ConsoleAuthentication getAuthentication() {
         return authentication;
     }
 
+    /**
+     * ConsoleSpec is the specification of the desired behavior of the Console.
+     */
     @JsonProperty("authentication")
     public void setAuthentication(ConsoleAuthentication authentication) {
         this.authentication = authentication;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConsoleStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConsoleStatus.java
index 5d7517c0cdf..9b3b8b9cd70 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConsoleStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ConsoleStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleStatus defines the observed status of the Console.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ConsoleStatus(String consoleURL) {
         this.consoleURL = consoleURL;
     }
 
+    /**
+     * The URL for the console. This will be derived from the host for the route that is created for the console.
+     */
     @JsonProperty("consoleURL")
     public String getConsoleURL() {
         return consoleURL;
     }
 
+    /**
+     * The URL for the console. This will be derived from the host for the route that is created for the console.
+     */
     @JsonProperty("consoleURL")
     public void setConsoleURL(String consoleURL) {
         this.consoleURL = consoleURL;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/CustomFeatureGates.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/CustomFeatureGates.java
index 6efd9da4d5c..66307cd104a 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/CustomFeatureGates.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/CustomFeatureGates.java
@@ -86,23 +86,35 @@ public CustomFeatureGates(List<String> disabled, List<String> enabled) {
         this.enabled = enabled;
     }
 
+    /**
+     * disabled is a list of all feature gates that you want to force off
+     */
     @JsonProperty("disabled")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDisabled() {
         return disabled;
     }
 
+    /**
+     * disabled is a list of all feature gates that you want to force off
+     */
     @JsonProperty("disabled")
     public void setDisabled(List<String> disabled) {
         this.disabled = disabled;
     }
 
+    /**
+     * enabled is a list of all feature gates that you want to force on
+     */
     @JsonProperty("enabled")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEnabled() {
         return enabled;
     }
 
+    /**
+     * enabled is a list of all feature gates that you want to force on
+     */
     @JsonProperty("enabled")
     public void setEnabled(List<String> enabled) {
         this.enabled = enabled;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/CustomTLSProfile.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/CustomTLSProfile.java
index 736037db63a..7a62cd4a572 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/CustomTLSProfile.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/CustomTLSProfile.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomTLSProfile is a user-defined TLS security profile. Be extremely careful using a custom TLS profile as invalid configurations can be catastrophic.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public CustomTLSProfile(List<String> ciphers, String minTLSVersion) {
         this.minTLSVersion = minTLSVersion;
     }
 
+    /**
+     * ciphers is used to specify the cipher algorithms that are negotiated during the TLS handshake.  Operators may remove entries their operands do not support.  For example, to use DES-CBC3-SHA  (yaml):<br><p> <br><p>   ciphers:<br><p>     - DES-CBC3-SHA
+     */
     @JsonProperty("ciphers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCiphers() {
         return ciphers;
     }
 
+    /**
+     * ciphers is used to specify the cipher algorithms that are negotiated during the TLS handshake.  Operators may remove entries their operands do not support.  For example, to use DES-CBC3-SHA  (yaml):<br><p> <br><p>   ciphers:<br><p>     - DES-CBC3-SHA
+     */
     @JsonProperty("ciphers")
     public void setCiphers(List<String> ciphers) {
         this.ciphers = ciphers;
     }
 
+    /**
+     * minTLSVersion is used to specify the minimal version of the TLS protocol that is negotiated during the TLS handshake. For example, to use TLS versions 1.1, 1.2 and 1.3 (yaml):<br><p> <br><p>   minTLSVersion: VersionTLS11<br><p> <br><p> NOTE: currently the highest minTLSVersion allowed is VersionTLS12
+     */
     @JsonProperty("minTLSVersion")
     public String getMinTLSVersion() {
         return minTLSVersion;
     }
 
+    /**
+     * minTLSVersion is used to specify the minimal version of the TLS protocol that is negotiated during the TLS handshake. For example, to use TLS versions 1.1, 1.2 and 1.3 (yaml):<br><p> <br><p>   minTLSVersion: VersionTLS11<br><p> <br><p> NOTE: currently the highest minTLSVersion allowed is VersionTLS12
+     */
     @JsonProperty("minTLSVersion")
     public void setMinTLSVersion(String minTLSVersion) {
         this.minTLSVersion = minTLSVersion;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DNS.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DNS.java
index 815c073855b..818c006ae7a 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DNS.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DNS.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNS holds cluster-wide information about DNS. The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class DNS implements Editable<DNSBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DNS";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public DNS(String apiVersion, String kind, ObjectMeta metadata, DNSSpec spec, DN
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DNS holds cluster-wide information about DNS. The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DNS holds cluster-wide information about DNS. The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * DNS holds cluster-wide information about DNS. The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public DNSSpec getSpec() {
         return spec;
     }
 
+    /**
+     * DNS holds cluster-wide information about DNS. The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(DNSSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * DNS holds cluster-wide information about DNS. The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public DNSStatus getStatus() {
         return status;
     }
 
+    /**
+     * DNS holds cluster-wide information about DNS. The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(DNSStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DNSList.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DNSList.java
index 7c4f5fd8af9..ce1e4c710e5 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DNSList.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DNSList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class DNSList implements Editable<DNSListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.config.v1.DNS>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.config.v1.DNS> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DNSList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DNSList(String apiVersion, List<io.fabric8.openshift.api.model.config.v1.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.config.v1.DNS> getItems() {
         return items;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.config.v1.DNS> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DNSPlatformSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DNSPlatformSpec.java
index cac8ce82a0a..2e8523a8f45 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DNSPlatformSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DNSPlatformSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSPlatformSpec holds cloud-provider-specific configuration for DNS administration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public DNSPlatformSpec(AWSDNSSpec aws, String type) {
         this.type = type;
     }
 
+    /**
+     * DNSPlatformSpec holds cloud-provider-specific configuration for DNS administration.
+     */
     @JsonProperty("aws")
     public AWSDNSSpec getAws() {
         return aws;
     }
 
+    /**
+     * DNSPlatformSpec holds cloud-provider-specific configuration for DNS administration.
+     */
     @JsonProperty("aws")
     public void setAws(AWSDNSSpec aws) {
         this.aws = aws;
     }
 
+    /**
+     * type is the underlying infrastructure provider for the cluster. Allowed values: "", "AWS".<br><p> <br><p> Individual components may not support all platforms, and must handle unrecognized platforms with best-effort defaults.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the underlying infrastructure provider for the cluster. Allowed values: "", "AWS".<br><p> <br><p> Individual components may not support all platforms, and must handle unrecognized platforms with best-effort defaults.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DNSSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DNSSpec.java
index 3b53d5279c2..e504a9a5509 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DNSSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DNSSpec.java
@@ -90,11 +90,17 @@ public DNSSpec(String baseDomain, DNSPlatformSpec platform, DNSZone privateZone,
         this.publicZone = publicZone;
     }
 
+    /**
+     * baseDomain is the base domain of the cluster. All managed DNS records will be sub-domains of this base.<br><p> <br><p> For example, given the base domain `openshift.example.com`, an API server DNS record may be created for `cluster-api.openshift.example.com`.<br><p> <br><p> Once set, this field cannot be changed.
+     */
     @JsonProperty("baseDomain")
     public String getBaseDomain() {
         return baseDomain;
     }
 
+    /**
+     * baseDomain is the base domain of the cluster. All managed DNS records will be sub-domains of this base.<br><p> <br><p> For example, given the base domain `openshift.example.com`, an API server DNS record may be created for `cluster-api.openshift.example.com`.<br><p> <br><p> Once set, this field cannot be changed.
+     */
     @JsonProperty("baseDomain")
     public void setBaseDomain(String baseDomain) {
         this.baseDomain = baseDomain;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DNSZone.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DNSZone.java
index 8f25f18675f..a0757baeb39 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DNSZone.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DNSZone.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSZone is used to define a DNS hosted zone. A zone can be identified by an ID or tags.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,22 +86,34 @@ public DNSZone(String id, Map<String, String> tags) {
         this.tags = tags;
     }
 
+    /**
+     * id is the identifier that can be used to find the DNS hosted zone.<br><p> <br><p> on AWS zone can be fetched using `ID` as id in [1] on Azure zone can be fetched using `ID` as a pre-determined name in [2], on GCP zone can be fetched using `ID` as a pre-determined name in [3].<br><p> <br><p> [1]: https://docs.aws.amazon.com/cli/latest/reference/route53/get-hosted-zone.html#options [2]: https://docs.microsoft.com/en-us/cli/azure/network/dns/zone?view=azure-cli-latest#az-network-dns-zone-show [3]: https://cloud.google.com/dns/docs/reference/v1/managedZones/get
+     */
     @JsonProperty("id")
     public String getId() {
         return id;
     }
 
+    /**
+     * id is the identifier that can be used to find the DNS hosted zone.<br><p> <br><p> on AWS zone can be fetched using `ID` as id in [1] on Azure zone can be fetched using `ID` as a pre-determined name in [2], on GCP zone can be fetched using `ID` as a pre-determined name in [3].<br><p> <br><p> [1]: https://docs.aws.amazon.com/cli/latest/reference/route53/get-hosted-zone.html#options [2]: https://docs.microsoft.com/en-us/cli/azure/network/dns/zone?view=azure-cli-latest#az-network-dns-zone-show [3]: https://cloud.google.com/dns/docs/reference/v1/managedZones/get
+     */
     @JsonProperty("id")
     public void setId(String id) {
         this.id = id;
     }
 
+    /**
+     * tags can be used to query the DNS hosted zone.<br><p> <br><p> on AWS, resourcegroupstaggingapi [1] can be used to fetch a zone using `Tags` as tag-filters,<br><p> <br><p> [1]: https://docs.aws.amazon.com/cli/latest/reference/resourcegroupstaggingapi/get-resources.html#options
+     */
     @JsonProperty("tags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getTags() {
         return tags;
     }
 
+    /**
+     * tags can be used to query the DNS hosted zone.<br><p> <br><p> on AWS, resourcegroupstaggingapi [1] can be used to fetch a zone using `Tags` as tag-filters,<br><p> <br><p> [1]: https://docs.aws.amazon.com/cli/latest/reference/resourcegroupstaggingapi/get-resources.html#options
+     */
     @JsonProperty("tags")
     public void setTags(Map<String, String> tags) {
         this.tags = tags;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DelegatedAuthentication.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DelegatedAuthentication.java
index 80e71076591..3db38c272c2 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DelegatedAuthentication.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DelegatedAuthentication.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DelegatedAuthentication allows authentication to be disabled.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public DelegatedAuthentication(Boolean disabled) {
         this.disabled = disabled;
     }
 
+    /**
+     * disabled indicates that authentication should be disabled.  By default it will use delegated authentication.
+     */
     @JsonProperty("disabled")
     public Boolean getDisabled() {
         return disabled;
     }
 
+    /**
+     * disabled indicates that authentication should be disabled.  By default it will use delegated authentication.
+     */
     @JsonProperty("disabled")
     public void setDisabled(Boolean disabled) {
         this.disabled = disabled;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DelegatedAuthorization.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DelegatedAuthorization.java
index e2d3b686f76..a30c1c83dc7 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DelegatedAuthorization.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DelegatedAuthorization.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DelegatedAuthorization allows authorization to be disabled.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public DelegatedAuthorization(Boolean disabled) {
         this.disabled = disabled;
     }
 
+    /**
+     * disabled indicates that authorization should be disabled.  By default it will use delegated authorization.
+     */
     @JsonProperty("disabled")
     public Boolean getDisabled() {
         return disabled;
     }
 
+    /**
+     * disabled indicates that authorization should be disabled.  By default it will use delegated authorization.
+     */
     @JsonProperty("disabled")
     public void setDisabled(Boolean disabled) {
         this.disabled = disabled;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DeprecatedWebhookTokenAuthenticator.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DeprecatedWebhookTokenAuthenticator.java
index d2f5533b092..c3bf191a98a 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DeprecatedWebhookTokenAuthenticator.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/DeprecatedWebhookTokenAuthenticator.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * deprecatedWebhookTokenAuthenticator holds the necessary configuration options for a remote token authenticator. It's the same as WebhookTokenAuthenticator but it's missing the 'required' validation on KubeConfig field.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public DeprecatedWebhookTokenAuthenticator(SecretNameReference kubeConfig) {
         this.kubeConfig = kubeConfig;
     }
 
+    /**
+     * deprecatedWebhookTokenAuthenticator holds the necessary configuration options for a remote token authenticator. It's the same as WebhookTokenAuthenticator but it's missing the 'required' validation on KubeConfig field.
+     */
     @JsonProperty("kubeConfig")
     public SecretNameReference getKubeConfig() {
         return kubeConfig;
     }
 
+    /**
+     * deprecatedWebhookTokenAuthenticator holds the necessary configuration options for a remote token authenticator. It's the same as WebhookTokenAuthenticator but it's missing the 'required' validation on KubeConfig field.
+     */
     @JsonProperty("kubeConfig")
     public void setKubeConfig(SecretNameReference kubeConfig) {
         this.kubeConfig = kubeConfig;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/EquinixMetalPlatformSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/EquinixMetalPlatformSpec.java
index 29490c23123..d24773c2f9b 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/EquinixMetalPlatformSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/EquinixMetalPlatformSpec.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EquinixMetalPlatformSpec holds the desired state of the Equinix Metal infrastructure provider. This only includes fields that can be modified in the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/EquinixMetalPlatformStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/EquinixMetalPlatformStatus.java
index f0eb35510dc..1d74542bde0 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/EquinixMetalPlatformStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/EquinixMetalPlatformStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EquinixMetalPlatformStatus holds the current status of the Equinix Metal infrastructure provider.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public EquinixMetalPlatformStatus(String apiServerInternalIP, String ingressIP)
         this.ingressIP = ingressIP;
     }
 
+    /**
+     * apiServerInternalIP is an IP address to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. It is the IP that the Infrastructure.status.apiServerInternalURI points to. It is the IP for a self-hosted load balancer in front of the API servers.
+     */
     @JsonProperty("apiServerInternalIP")
     public String getApiServerInternalIP() {
         return apiServerInternalIP;
     }
 
+    /**
+     * apiServerInternalIP is an IP address to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. It is the IP that the Infrastructure.status.apiServerInternalURI points to. It is the IP for a self-hosted load balancer in front of the API servers.
+     */
     @JsonProperty("apiServerInternalIP")
     public void setApiServerInternalIP(String apiServerInternalIP) {
         this.apiServerInternalIP = apiServerInternalIP;
     }
 
+    /**
+     * ingressIP is an external IP which routes to the default ingress controller. The IP is a suitable target of a wildcard DNS record used to resolve default route host names.
+     */
     @JsonProperty("ingressIP")
     public String getIngressIP() {
         return ingressIP;
     }
 
+    /**
+     * ingressIP is an external IP which routes to the default ingress controller. The IP is a suitable target of a wildcard DNS record used to resolve default route host names.
+     */
     @JsonProperty("ingressIP")
     public void setIngressIP(String ingressIP) {
         this.ingressIP = ingressIP;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/EtcdConnectionInfo.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/EtcdConnectionInfo.java
index 2aab23e454d..48fadf4493e 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/EtcdConnectionInfo.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/EtcdConnectionInfo.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EtcdConnectionInfo holds information necessary for connecting to an etcd server
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public EtcdConnectionInfo(String ca, String certFile, String keyFile, List<Strin
         this.urls = urls;
     }
 
+    /**
+     * CA is a file containing trusted roots for the etcd server certificates
+     */
     @JsonProperty("ca")
     public String getCa() {
         return ca;
     }
 
+    /**
+     * CA is a file containing trusted roots for the etcd server certificates
+     */
     @JsonProperty("ca")
     public void setCa(String ca) {
         this.ca = ca;
     }
 
+    /**
+     * CertFile is a file containing a PEM-encoded certificate
+     */
     @JsonProperty("certFile")
     public String getCertFile() {
         return certFile;
     }
 
+    /**
+     * CertFile is a file containing a PEM-encoded certificate
+     */
     @JsonProperty("certFile")
     public void setCertFile(String certFile) {
         this.certFile = certFile;
     }
 
+    /**
+     * KeyFile is a file containing a PEM-encoded private key for the certificate specified by CertFile
+     */
     @JsonProperty("keyFile")
     public String getKeyFile() {
         return keyFile;
     }
 
+    /**
+     * KeyFile is a file containing a PEM-encoded private key for the certificate specified by CertFile
+     */
     @JsonProperty("keyFile")
     public void setKeyFile(String keyFile) {
         this.keyFile = keyFile;
     }
 
+    /**
+     * URLs are the URLs for etcd
+     */
     @JsonProperty("urls")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getUrls() {
         return urls;
     }
 
+    /**
+     * URLs are the URLs for etcd
+     */
     @JsonProperty("urls")
     public void setUrls(List<String> urls) {
         this.urls = urls;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/EtcdStorageConfig.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/EtcdStorageConfig.java
index 5eac9c48cea..e8517f09920 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/EtcdStorageConfig.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/EtcdStorageConfig.java
@@ -97,52 +97,82 @@ public EtcdStorageConfig(String ca, String certFile, String keyFile, String stor
         this.urls = urls;
     }
 
+    /**
+     * CA is a file containing trusted roots for the etcd server certificates
+     */
     @JsonProperty("ca")
     public String getCa() {
         return ca;
     }
 
+    /**
+     * CA is a file containing trusted roots for the etcd server certificates
+     */
     @JsonProperty("ca")
     public void setCa(String ca) {
         this.ca = ca;
     }
 
+    /**
+     * CertFile is a file containing a PEM-encoded certificate
+     */
     @JsonProperty("certFile")
     public String getCertFile() {
         return certFile;
     }
 
+    /**
+     * CertFile is a file containing a PEM-encoded certificate
+     */
     @JsonProperty("certFile")
     public void setCertFile(String certFile) {
         this.certFile = certFile;
     }
 
+    /**
+     * KeyFile is a file containing a PEM-encoded private key for the certificate specified by CertFile
+     */
     @JsonProperty("keyFile")
     public String getKeyFile() {
         return keyFile;
     }
 
+    /**
+     * KeyFile is a file containing a PEM-encoded private key for the certificate specified by CertFile
+     */
     @JsonProperty("keyFile")
     public void setKeyFile(String keyFile) {
         this.keyFile = keyFile;
     }
 
+    /**
+     * StoragePrefix is the path within etcd that the OpenShift resources will be rooted under. This value, if changed, will mean existing objects in etcd will no longer be located.
+     */
     @JsonProperty("storagePrefix")
     public String getStoragePrefix() {
         return storagePrefix;
     }
 
+    /**
+     * StoragePrefix is the path within etcd that the OpenShift resources will be rooted under. This value, if changed, will mean existing objects in etcd will no longer be located.
+     */
     @JsonProperty("storagePrefix")
     public void setStoragePrefix(String storagePrefix) {
         this.storagePrefix = storagePrefix;
     }
 
+    /**
+     * URLs are the URLs for etcd
+     */
     @JsonProperty("urls")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getUrls() {
         return urls;
     }
 
+    /**
+     * URLs are the URLs for etcd
+     */
     @JsonProperty("urls")
     public void setUrls(List<String> urls) {
         this.urls = urls;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ExternalIPConfig.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ExternalIPConfig.java
index 139bf0098ea..342d7f5545e 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ExternalIPConfig.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ExternalIPConfig.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ExternalIPConfig specifies some IP blocks relevant for the ExternalIP field of a Service resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public ExternalIPConfig(List<String> autoAssignCIDRs, ExternalIPPolicy policy) {
         this.policy = policy;
     }
 
+    /**
+     * autoAssignCIDRs is a list of CIDRs from which to automatically assign Service.ExternalIP. These are assigned when the service is of type LoadBalancer. In general, this is only useful for bare-metal clusters. In Openshift 3.x, this was misleadingly called "IngressIPs". Automatically assigned External IPs are not affected by any ExternalIPPolicy rules. Currently, only one entry may be provided.
+     */
     @JsonProperty("autoAssignCIDRs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAutoAssignCIDRs() {
         return autoAssignCIDRs;
     }
 
+    /**
+     * autoAssignCIDRs is a list of CIDRs from which to automatically assign Service.ExternalIP. These are assigned when the service is of type LoadBalancer. In general, this is only useful for bare-metal clusters. In Openshift 3.x, this was misleadingly called "IngressIPs". Automatically assigned External IPs are not affected by any ExternalIPPolicy rules. Currently, only one entry may be provided.
+     */
     @JsonProperty("autoAssignCIDRs")
     public void setAutoAssignCIDRs(List<String> autoAssignCIDRs) {
         this.autoAssignCIDRs = autoAssignCIDRs;
     }
 
+    /**
+     * ExternalIPConfig specifies some IP blocks relevant for the ExternalIP field of a Service resource.
+     */
     @JsonProperty("policy")
     public ExternalIPPolicy getPolicy() {
         return policy;
     }
 
+    /**
+     * ExternalIPConfig specifies some IP blocks relevant for the ExternalIP field of a Service resource.
+     */
     @JsonProperty("policy")
     public void setPolicy(ExternalIPPolicy policy) {
         this.policy = policy;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ExternalIPPolicy.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ExternalIPPolicy.java
index 32a9b9e8575..57f22a6c36e 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ExternalIPPolicy.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ExternalIPPolicy.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ExternalIPPolicy configures exactly which IPs are allowed for the ExternalIP field in a Service. If the zero struct is supplied, then none are permitted. The policy controller always allows automatically assigned external IPs.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public ExternalIPPolicy(List<String> allowedCIDRs, List<String> rejectedCIDRs) {
         this.rejectedCIDRs = rejectedCIDRs;
     }
 
+    /**
+     * allowedCIDRs is the list of allowed CIDRs.
+     */
     @JsonProperty("allowedCIDRs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAllowedCIDRs() {
         return allowedCIDRs;
     }
 
+    /**
+     * allowedCIDRs is the list of allowed CIDRs.
+     */
     @JsonProperty("allowedCIDRs")
     public void setAllowedCIDRs(List<String> allowedCIDRs) {
         this.allowedCIDRs = allowedCIDRs;
     }
 
+    /**
+     * rejectedCIDRs is the list of disallowed CIDRs. These take precedence over allowedCIDRs.
+     */
     @JsonProperty("rejectedCIDRs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getRejectedCIDRs() {
         return rejectedCIDRs;
     }
 
+    /**
+     * rejectedCIDRs is the list of disallowed CIDRs. These take precedence over allowedCIDRs.
+     */
     @JsonProperty("rejectedCIDRs")
     public void setRejectedCIDRs(List<String> rejectedCIDRs) {
         this.rejectedCIDRs = rejectedCIDRs;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ExternalPlatformSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ExternalPlatformSpec.java
index 96743504dc0..54c1ee380bd 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ExternalPlatformSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ExternalPlatformSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ExternalPlatformSpec holds the desired state for the generic External infrastructure provider.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ExternalPlatformSpec(String platformName) {
         this.platformName = platformName;
     }
 
+    /**
+     * PlatformName holds the arbitrary string representing the infrastructure provider name, expected to be set at the installation time. This field is solely for informational and reporting purposes and is not expected to be used for decision-making.
+     */
     @JsonProperty("platformName")
     public String getPlatformName() {
         return platformName;
     }
 
+    /**
+     * PlatformName holds the arbitrary string representing the infrastructure provider name, expected to be set at the installation time. This field is solely for informational and reporting purposes and is not expected to be used for decision-making.
+     */
     @JsonProperty("platformName")
     public void setPlatformName(String platformName) {
         this.platformName = platformName;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ExternalPlatformStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ExternalPlatformStatus.java
index 1b5ba7a861d..c69b8928bb8 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ExternalPlatformStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ExternalPlatformStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ExternalPlatformStatus holds the current status of the generic External infrastructure provider.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ExternalPlatformStatus(CloudControllerManagerStatus cloudControllerManage
         this.cloudControllerManager = cloudControllerManager;
     }
 
+    /**
+     * ExternalPlatformStatus holds the current status of the generic External infrastructure provider.
+     */
     @JsonProperty("cloudControllerManager")
     public CloudControllerManagerStatus getCloudControllerManager() {
         return cloudControllerManager;
     }
 
+    /**
+     * ExternalPlatformStatus holds the current status of the generic External infrastructure provider.
+     */
     @JsonProperty("cloudControllerManager")
     public void setCloudControllerManager(CloudControllerManagerStatus cloudControllerManager) {
         this.cloudControllerManager = cloudControllerManager;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGate.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGate.java
index 9610654174c..1b27ddb41d1 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGate.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGate.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Feature holds cluster-wide information about feature gates.  The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class FeatureGate implements Editable<FeatureGateBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "FeatureGate";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public FeatureGate(String apiVersion, String kind, ObjectMeta metadata, FeatureG
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Feature holds cluster-wide information about feature gates.  The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Feature holds cluster-wide information about feature gates.  The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Feature holds cluster-wide information about feature gates.  The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public FeatureGateSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Feature holds cluster-wide information about feature gates.  The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(FeatureGateSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Feature holds cluster-wide information about feature gates.  The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public FeatureGateStatus getStatus() {
         return status;
     }
 
+    /**
+     * Feature holds cluster-wide information about feature gates.  The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(FeatureGateStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGateAttributes.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGateAttributes.java
index a76186af871..571c9bb8c59 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGateAttributes.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGateAttributes.java
@@ -78,11 +78,17 @@ public FeatureGateAttributes(String name) {
         this.name = name;
     }
 
+    /**
+     * name is the name of the FeatureGate.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the FeatureGate.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGateDetails.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGateDetails.java
index a67115887a9..3f66f386f8f 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGateDetails.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGateDetails.java
@@ -90,33 +90,51 @@ public FeatureGateDetails(List<FeatureGateAttributes> disabled, List<FeatureGate
         this.version = version;
     }
 
+    /**
+     * disabled is a list of all feature gates that are disabled in the cluster for the named version.
+     */
     @JsonProperty("disabled")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<FeatureGateAttributes> getDisabled() {
         return disabled;
     }
 
+    /**
+     * disabled is a list of all feature gates that are disabled in the cluster for the named version.
+     */
     @JsonProperty("disabled")
     public void setDisabled(List<FeatureGateAttributes> disabled) {
         this.disabled = disabled;
     }
 
+    /**
+     * enabled is a list of all feature gates that are enabled in the cluster for the named version.
+     */
     @JsonProperty("enabled")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<FeatureGateAttributes> getEnabled() {
         return enabled;
     }
 
+    /**
+     * enabled is a list of all feature gates that are enabled in the cluster for the named version.
+     */
     @JsonProperty("enabled")
     public void setEnabled(List<FeatureGateAttributes> enabled) {
         this.enabled = enabled;
     }
 
+    /**
+     * version matches the version provided by the ClusterVersion and in the ClusterOperator.Status.Versions field.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version matches the version provided by the ClusterVersion and in the ClusterOperator.Status.Versions field.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGateList.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGateList.java
index 9047c9debed..80dfffea628 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGateList.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGateList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class FeatureGateList implements Editable<FeatureGateListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.config.v1.FeatureGate>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.config.v1.FeatureGate> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "FeatureGateList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public FeatureGateList(String apiVersion, List<io.fabric8.openshift.api.model.co
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.config.v1.FeatureGate> getItems() {
         return items;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.config.v1.FeatureGate> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGateSelection.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGateSelection.java
index 64b734e0023..720da8bfb7a 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGateSelection.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGateSelection.java
@@ -92,11 +92,17 @@ public void setCustomNoUpgrade(CustomFeatureGates customNoUpgrade) {
         this.customNoUpgrade = customNoUpgrade;
     }
 
+    /**
+     * featureSet changes the list of features in the cluster.  The default is empty.  Be very careful adjusting this setting. Turning on or off features may cause irreversible changes in your cluster which cannot be undone.
+     */
     @JsonProperty("featureSet")
     public String getFeatureSet() {
         return featureSet;
     }
 
+    /**
+     * featureSet changes the list of features in the cluster.  The default is empty.  Be very careful adjusting this setting. Turning on or off features may cause irreversible changes in your cluster which cannot be undone.
+     */
     @JsonProperty("featureSet")
     public void setFeatureSet(String featureSet) {
         this.featureSet = featureSet;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGateSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGateSpec.java
index 9d3d4d4476e..1ec1083864a 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGateSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGateSpec.java
@@ -92,11 +92,17 @@ public void setCustomNoUpgrade(CustomFeatureGates customNoUpgrade) {
         this.customNoUpgrade = customNoUpgrade;
     }
 
+    /**
+     * featureSet changes the list of features in the cluster.  The default is empty.  Be very careful adjusting this setting. Turning on or off features may cause irreversible changes in your cluster which cannot be undone.
+     */
     @JsonProperty("featureSet")
     public String getFeatureSet() {
         return featureSet;
     }
 
+    /**
+     * featureSet changes the list of features in the cluster.  The default is empty.  Be very careful adjusting this setting. Turning on or off features may cause irreversible changes in your cluster which cannot be undone.
+     */
     @JsonProperty("featureSet")
     public void setFeatureSet(String featureSet) {
         this.featureSet = featureSet;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGateStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGateStatus.java
index 89acb7da8f9..2de070e50f1 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGateStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGateStatus.java
@@ -87,23 +87,35 @@ public FeatureGateStatus(List<Condition> conditions, List<FeatureGateDetails> fe
         this.featureGates = featureGates;
     }
 
+    /**
+     * conditions represent the observations of the current state. Known .status.conditions.type are: "DeterminationDegraded"
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions represent the observations of the current state. Known .status.conditions.type are: "DeterminationDegraded"
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * featureGates contains a list of enabled and disabled featureGates that are keyed by payloadVersion. Operators other than the CVO and cluster-config-operator, must read the .status.featureGates, locate the version they are managing, find the enabled/disabled featuregates and make the operand and operator match. The enabled/disabled values for a particular version may change during the life of the cluster as various .spec.featureSet values are selected. Operators may choose to restart their processes to pick up these changes, but remembering past enable/disable lists is beyond the scope of this API and is the responsibility of individual operators. Only featureGates with .version in the ClusterVersion.status will be present in this list.
+     */
     @JsonProperty("featureGates")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<FeatureGateDetails> getFeatureGates() {
         return featureGates;
     }
 
+    /**
+     * featureGates contains a list of enabled and disabled featureGates that are keyed by payloadVersion. Operators other than the CVO and cluster-config-operator, must read the .status.featureGates, locate the version they are managing, find the enabled/disabled featuregates and make the operand and operator match. The enabled/disabled values for a particular version may change during the life of the cluster as various .spec.featureSet values are selected. Operators may choose to restart their processes to pick up these changes, but remembering past enable/disable lists is beyond the scope of this API and is the responsibility of individual operators. Only featureGates with .version in the ClusterVersion.status will be present in this list.
+     */
     @JsonProperty("featureGates")
     public void setFeatureGates(List<FeatureGateDetails> featureGates) {
         this.featureGates = featureGates;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGateTests.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGateTests.java
index 7c0031a4ceb..27d908c1f8c 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGateTests.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/FeatureGateTests.java
@@ -85,22 +85,34 @@ public FeatureGateTests(String featureGate, List<TestDetails> tests) {
         this.tests = tests;
     }
 
+    /**
+     * FeatureGate is the name of the FeatureGate as it appears in The FeatureGate CR instance.
+     */
     @JsonProperty("featureGate")
     public String getFeatureGate() {
         return featureGate;
     }
 
+    /**
+     * FeatureGate is the name of the FeatureGate as it appears in The FeatureGate CR instance.
+     */
     @JsonProperty("featureGate")
     public void setFeatureGate(String featureGate) {
         this.featureGate = featureGate;
     }
 
+    /**
+     * Tests contains an item for every TestName
+     */
     @JsonProperty("tests")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TestDetails> getTests() {
         return tests;
     }
 
+    /**
+     * Tests contains an item for every TestName
+     */
     @JsonProperty("tests")
     public void setTests(List<TestDetails> tests) {
         this.tests = tests;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GCPPlatformSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GCPPlatformSpec.java
index c9d60b2c3a4..9229d0a21ae 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GCPPlatformSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GCPPlatformSpec.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPPlatformSpec holds the desired state of the Google Cloud Platform infrastructure provider. This only includes fields that can be modified in the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GCPPlatformStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GCPPlatformStatus.java
index fc608775fb3..6f99d9c7d51 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GCPPlatformStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GCPPlatformStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPPlatformStatus holds the current status of the Google Cloud Platform infrastructure provider.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,53 +101,83 @@ public GCPPlatformStatus(CloudLoadBalancerConfig cloudLoadBalancerConfig, String
         this.resourceTags = resourceTags;
     }
 
+    /**
+     * GCPPlatformStatus holds the current status of the Google Cloud Platform infrastructure provider.
+     */
     @JsonProperty("cloudLoadBalancerConfig")
     public CloudLoadBalancerConfig getCloudLoadBalancerConfig() {
         return cloudLoadBalancerConfig;
     }
 
+    /**
+     * GCPPlatformStatus holds the current status of the Google Cloud Platform infrastructure provider.
+     */
     @JsonProperty("cloudLoadBalancerConfig")
     public void setCloudLoadBalancerConfig(CloudLoadBalancerConfig cloudLoadBalancerConfig) {
         this.cloudLoadBalancerConfig = cloudLoadBalancerConfig;
     }
 
+    /**
+     * resourceGroupName is the Project ID for new GCP resources created for the cluster.
+     */
     @JsonProperty("projectID")
     public String getProjectID() {
         return projectID;
     }
 
+    /**
+     * resourceGroupName is the Project ID for new GCP resources created for the cluster.
+     */
     @JsonProperty("projectID")
     public void setProjectID(String projectID) {
         this.projectID = projectID;
     }
 
+    /**
+     * region holds the region for new GCP resources created for the cluster.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * region holds the region for new GCP resources created for the cluster.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * resourceLabels is a list of additional labels to apply to GCP resources created for the cluster. See https://cloud.google.com/compute/docs/labeling-resources for information on labeling GCP resources. GCP supports a maximum of 64 labels per resource. OpenShift reserves 32 labels for internal use, allowing 32 labels for user configuration.
+     */
     @JsonProperty("resourceLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GCPResourceLabel> getResourceLabels() {
         return resourceLabels;
     }
 
+    /**
+     * resourceLabels is a list of additional labels to apply to GCP resources created for the cluster. See https://cloud.google.com/compute/docs/labeling-resources for information on labeling GCP resources. GCP supports a maximum of 64 labels per resource. OpenShift reserves 32 labels for internal use, allowing 32 labels for user configuration.
+     */
     @JsonProperty("resourceLabels")
     public void setResourceLabels(List<GCPResourceLabel> resourceLabels) {
         this.resourceLabels = resourceLabels;
     }
 
+    /**
+     * resourceTags is a list of additional tags to apply to GCP resources created for the cluster. See https://cloud.google.com/resource-manager/docs/tags/tags-overview for information on tagging GCP resources. GCP supports a maximum of 50 tags per resource.
+     */
     @JsonProperty("resourceTags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GCPResourceTag> getResourceTags() {
         return resourceTags;
     }
 
+    /**
+     * resourceTags is a list of additional tags to apply to GCP resources created for the cluster. See https://cloud.google.com/resource-manager/docs/tags/tags-overview for information on tagging GCP resources. GCP supports a maximum of 50 tags per resource.
+     */
     @JsonProperty("resourceTags")
     public void setResourceTags(List<GCPResourceTag> resourceTags) {
         this.resourceTags = resourceTags;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GCPResourceLabel.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GCPResourceLabel.java
index 6a32c2e7d04..3fcedd55b49 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GCPResourceLabel.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GCPResourceLabel.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPResourceLabel is a label to apply to GCP resources created for the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public GCPResourceLabel(String key, String value) {
         this.value = value;
     }
 
+    /**
+     * key is the key part of the label. A label key can have a maximum of 63 characters and cannot be empty. Label key must begin with a lowercase letter, and must contain only lowercase letters, numeric characters, and the following special characters `_-`. Label key must not have the reserved prefixes `kubernetes-io` and `openshift-io`.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * key is the key part of the label. A label key can have a maximum of 63 characters and cannot be empty. Label key must begin with a lowercase letter, and must contain only lowercase letters, numeric characters, and the following special characters `_-`. Label key must not have the reserved prefixes `kubernetes-io` and `openshift-io`.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * value is the value part of the label. A label value can have a maximum of 63 characters and cannot be empty. Value must contain only lowercase letters, numeric characters, and the following special characters `_-`.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * value is the value part of the label. A label value can have a maximum of 63 characters and cannot be empty. Value must contain only lowercase letters, numeric characters, and the following special characters `_-`.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GCPResourceTag.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GCPResourceTag.java
index cc877d3df6d..38c707311fc 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GCPResourceTag.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GCPResourceTag.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPResourceTag is a tag to apply to GCP resources created for the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public GCPResourceTag(String key, String parentID, String value) {
         this.value = value;
     }
 
+    /**
+     * key is the key part of the tag. A tag key can have a maximum of 63 characters and cannot be empty. Tag key must begin and end with an alphanumeric character, and must contain only uppercase, lowercase alphanumeric characters, and the following special characters `._-`.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * key is the key part of the tag. A tag key can have a maximum of 63 characters and cannot be empty. Tag key must begin and end with an alphanumeric character, and must contain only uppercase, lowercase alphanumeric characters, and the following special characters `._-`.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * parentID is the ID of the hierarchical resource where the tags are defined, e.g. at the Organization or the Project level. To find the Organization or Project ID refer to the following pages: https://cloud.google.com/resource-manager/docs/creating-managing-organization#retrieving_your_organization_id, https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects. An OrganizationID must consist of decimal numbers, and cannot have leading zeroes. A ProjectID must be 6 to 30 characters in length, can only contain lowercase letters, numbers, and hyphens, and must start with a letter, and cannot end with a hyphen.
+     */
     @JsonProperty("parentID")
     public String getParentID() {
         return parentID;
     }
 
+    /**
+     * parentID is the ID of the hierarchical resource where the tags are defined, e.g. at the Organization or the Project level. To find the Organization or Project ID refer to the following pages: https://cloud.google.com/resource-manager/docs/creating-managing-organization#retrieving_your_organization_id, https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects. An OrganizationID must consist of decimal numbers, and cannot have leading zeroes. A ProjectID must be 6 to 30 characters in length, can only contain lowercase letters, numbers, and hyphens, and must start with a letter, and cannot end with a hyphen.
+     */
     @JsonProperty("parentID")
     public void setParentID(String parentID) {
         this.parentID = parentID;
     }
 
+    /**
+     * value is the value part of the tag. A tag value can have a maximum of 63 characters and cannot be empty. Tag value must begin and end with an alphanumeric character, and must contain only uppercase, lowercase alphanumeric characters, and the following special characters `_-.@%=+:,&#42;#&amp;(){}[]` and spaces.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * value is the value part of the tag. A tag value can have a maximum of 63 characters and cannot be empty. Tag value must begin and end with an alphanumeric character, and must contain only uppercase, lowercase alphanumeric characters, and the following special characters `_-.@%=+:,&#42;#&amp;(){}[]` and spaces.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GenericAPIServerConfig.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GenericAPIServerConfig.java
index 18f03c97451..1636935d6a3 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GenericAPIServerConfig.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GenericAPIServerConfig.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GenericAPIServerConfig is an inline-able struct for aggregated apiservers that need to store data in etcd
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,62 +104,98 @@ public GenericAPIServerConfig(AdmissionConfig admission, AuditConfig auditConfig
         this.storageConfig = storageConfig;
     }
 
+    /**
+     * GenericAPIServerConfig is an inline-able struct for aggregated apiservers that need to store data in etcd
+     */
     @JsonProperty("admission")
     public AdmissionConfig getAdmission() {
         return admission;
     }
 
+    /**
+     * GenericAPIServerConfig is an inline-able struct for aggregated apiservers that need to store data in etcd
+     */
     @JsonProperty("admission")
     public void setAdmission(AdmissionConfig admission) {
         this.admission = admission;
     }
 
+    /**
+     * GenericAPIServerConfig is an inline-able struct for aggregated apiservers that need to store data in etcd
+     */
     @JsonProperty("auditConfig")
     public AuditConfig getAuditConfig() {
         return auditConfig;
     }
 
+    /**
+     * GenericAPIServerConfig is an inline-able struct for aggregated apiservers that need to store data in etcd
+     */
     @JsonProperty("auditConfig")
     public void setAuditConfig(AuditConfig auditConfig) {
         this.auditConfig = auditConfig;
     }
 
+    /**
+     * corsAllowedOrigins
+     */
     @JsonProperty("corsAllowedOrigins")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCorsAllowedOrigins() {
         return corsAllowedOrigins;
     }
 
+    /**
+     * corsAllowedOrigins
+     */
     @JsonProperty("corsAllowedOrigins")
     public void setCorsAllowedOrigins(List<String> corsAllowedOrigins) {
         this.corsAllowedOrigins = corsAllowedOrigins;
     }
 
+    /**
+     * GenericAPIServerConfig is an inline-able struct for aggregated apiservers that need to store data in etcd
+     */
     @JsonProperty("kubeClientConfig")
     public KubeClientConfig getKubeClientConfig() {
         return kubeClientConfig;
     }
 
+    /**
+     * GenericAPIServerConfig is an inline-able struct for aggregated apiservers that need to store data in etcd
+     */
     @JsonProperty("kubeClientConfig")
     public void setKubeClientConfig(KubeClientConfig kubeClientConfig) {
         this.kubeClientConfig = kubeClientConfig;
     }
 
+    /**
+     * GenericAPIServerConfig is an inline-able struct for aggregated apiservers that need to store data in etcd
+     */
     @JsonProperty("servingInfo")
     public HTTPServingInfo getServingInfo() {
         return servingInfo;
     }
 
+    /**
+     * GenericAPIServerConfig is an inline-able struct for aggregated apiservers that need to store data in etcd
+     */
     @JsonProperty("servingInfo")
     public void setServingInfo(HTTPServingInfo servingInfo) {
         this.servingInfo = servingInfo;
     }
 
+    /**
+     * GenericAPIServerConfig is an inline-able struct for aggregated apiservers that need to store data in etcd
+     */
     @JsonProperty("storageConfig")
     public EtcdStorageConfig getStorageConfig() {
         return storageConfig;
     }
 
+    /**
+     * GenericAPIServerConfig is an inline-able struct for aggregated apiservers that need to store data in etcd
+     */
     @JsonProperty("storageConfig")
     public void setStorageConfig(EtcdStorageConfig storageConfig) {
         this.storageConfig = storageConfig;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GenericControllerConfig.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GenericControllerConfig.java
index 98776ac4eaf..5bb8d3f0ae3 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GenericControllerConfig.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GenericControllerConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GenericControllerConfig provides information to configure a controller
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public GenericControllerConfig(DelegatedAuthentication authentication, Delegated
         this.servingInfo = servingInfo;
     }
 
+    /**
+     * GenericControllerConfig provides information to configure a controller
+     */
     @JsonProperty("authentication")
     public DelegatedAuthentication getAuthentication() {
         return authentication;
     }
 
+    /**
+     * GenericControllerConfig provides information to configure a controller
+     */
     @JsonProperty("authentication")
     public void setAuthentication(DelegatedAuthentication authentication) {
         this.authentication = authentication;
     }
 
+    /**
+     * GenericControllerConfig provides information to configure a controller
+     */
     @JsonProperty("authorization")
     public DelegatedAuthorization getAuthorization() {
         return authorization;
     }
 
+    /**
+     * GenericControllerConfig provides information to configure a controller
+     */
     @JsonProperty("authorization")
     public void setAuthorization(DelegatedAuthorization authorization) {
         this.authorization = authorization;
     }
 
+    /**
+     * GenericControllerConfig provides information to configure a controller
+     */
     @JsonProperty("leaderElection")
     public LeaderElection getLeaderElection() {
         return leaderElection;
     }
 
+    /**
+     * GenericControllerConfig provides information to configure a controller
+     */
     @JsonProperty("leaderElection")
     public void setLeaderElection(LeaderElection leaderElection) {
         this.leaderElection = leaderElection;
     }
 
+    /**
+     * GenericControllerConfig provides information to configure a controller
+     */
     @JsonProperty("servingInfo")
     public HTTPServingInfo getServingInfo() {
         return servingInfo;
     }
 
+    /**
+     * GenericControllerConfig provides information to configure a controller
+     */
     @JsonProperty("servingInfo")
     public void setServingInfo(HTTPServingInfo servingInfo) {
         this.servingInfo = servingInfo;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GitHubIdentityProvider.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GitHubIdentityProvider.java
index 1f7954aefea..2fa7eb92a0b 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GitHubIdentityProvider.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GitHubIdentityProvider.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GitHubIdentityProvider provides identities for users authenticating using GitHub credentials
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,63 +105,99 @@ public GitHubIdentityProvider(ConfigMapNameReference ca, String clientID, Secret
         this.teams = teams;
     }
 
+    /**
+     * GitHubIdentityProvider provides identities for users authenticating using GitHub credentials
+     */
     @JsonProperty("ca")
     public ConfigMapNameReference getCa() {
         return ca;
     }
 
+    /**
+     * GitHubIdentityProvider provides identities for users authenticating using GitHub credentials
+     */
     @JsonProperty("ca")
     public void setCa(ConfigMapNameReference ca) {
         this.ca = ca;
     }
 
+    /**
+     * clientID is the oauth client ID
+     */
     @JsonProperty("clientID")
     public String getClientID() {
         return clientID;
     }
 
+    /**
+     * clientID is the oauth client ID
+     */
     @JsonProperty("clientID")
     public void setClientID(String clientID) {
         this.clientID = clientID;
     }
 
+    /**
+     * GitHubIdentityProvider provides identities for users authenticating using GitHub credentials
+     */
     @JsonProperty("clientSecret")
     public SecretNameReference getClientSecret() {
         return clientSecret;
     }
 
+    /**
+     * GitHubIdentityProvider provides identities for users authenticating using GitHub credentials
+     */
     @JsonProperty("clientSecret")
     public void setClientSecret(SecretNameReference clientSecret) {
         this.clientSecret = clientSecret;
     }
 
+    /**
+     * hostname is the optional domain (e.g. "mycompany.com") for use with a hosted instance of GitHub Enterprise. It must match the GitHub Enterprise settings value configured at /setup/settings#hostname.
+     */
     @JsonProperty("hostname")
     public String getHostname() {
         return hostname;
     }
 
+    /**
+     * hostname is the optional domain (e.g. "mycompany.com") for use with a hosted instance of GitHub Enterprise. It must match the GitHub Enterprise settings value configured at /setup/settings#hostname.
+     */
     @JsonProperty("hostname")
     public void setHostname(String hostname) {
         this.hostname = hostname;
     }
 
+    /**
+     * organizations optionally restricts which organizations are allowed to log in
+     */
     @JsonProperty("organizations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getOrganizations() {
         return organizations;
     }
 
+    /**
+     * organizations optionally restricts which organizations are allowed to log in
+     */
     @JsonProperty("organizations")
     public void setOrganizations(List<String> organizations) {
         this.organizations = organizations;
     }
 
+    /**
+     * teams optionally restricts which teams are allowed to log in. Format is &lt;org&gt;/&lt;team&gt;.
+     */
     @JsonProperty("teams")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getTeams() {
         return teams;
     }
 
+    /**
+     * teams optionally restricts which teams are allowed to log in. Format is &lt;org&gt;/&lt;team&gt;.
+     */
     @JsonProperty("teams")
     public void setTeams(List<String> teams) {
         this.teams = teams;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GitLabIdentityProvider.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GitLabIdentityProvider.java
index 38bc3e8e010..6cd2f2888dd 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GitLabIdentityProvider.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GitLabIdentityProvider.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GitLabIdentityProvider provides identities for users authenticating using GitLab credentials
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public GitLabIdentityProvider(ConfigMapNameReference ca, String clientID, Secret
         this.url = url;
     }
 
+    /**
+     * GitLabIdentityProvider provides identities for users authenticating using GitLab credentials
+     */
     @JsonProperty("ca")
     public ConfigMapNameReference getCa() {
         return ca;
     }
 
+    /**
+     * GitLabIdentityProvider provides identities for users authenticating using GitLab credentials
+     */
     @JsonProperty("ca")
     public void setCa(ConfigMapNameReference ca) {
         this.ca = ca;
     }
 
+    /**
+     * clientID is the oauth client ID
+     */
     @JsonProperty("clientID")
     public String getClientID() {
         return clientID;
     }
 
+    /**
+     * clientID is the oauth client ID
+     */
     @JsonProperty("clientID")
     public void setClientID(String clientID) {
         this.clientID = clientID;
     }
 
+    /**
+     * GitLabIdentityProvider provides identities for users authenticating using GitLab credentials
+     */
     @JsonProperty("clientSecret")
     public SecretNameReference getClientSecret() {
         return clientSecret;
     }
 
+    /**
+     * GitLabIdentityProvider provides identities for users authenticating using GitLab credentials
+     */
     @JsonProperty("clientSecret")
     public void setClientSecret(SecretNameReference clientSecret) {
         this.clientSecret = clientSecret;
     }
 
+    /**
+     * url is the oauth server base URL
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * url is the oauth server base URL
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GoogleIdentityProvider.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GoogleIdentityProvider.java
index a63147daeaa..57d5dc37c93 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GoogleIdentityProvider.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/GoogleIdentityProvider.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GoogleIdentityProvider provides identities for users authenticating using Google credentials
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public GoogleIdentityProvider(String clientID, SecretNameReference clientSecret,
         this.hostedDomain = hostedDomain;
     }
 
+    /**
+     * clientID is the oauth client ID
+     */
     @JsonProperty("clientID")
     public String getClientID() {
         return clientID;
     }
 
+    /**
+     * clientID is the oauth client ID
+     */
     @JsonProperty("clientID")
     public void setClientID(String clientID) {
         this.clientID = clientID;
     }
 
+    /**
+     * GoogleIdentityProvider provides identities for users authenticating using Google credentials
+     */
     @JsonProperty("clientSecret")
     public SecretNameReference getClientSecret() {
         return clientSecret;
     }
 
+    /**
+     * GoogleIdentityProvider provides identities for users authenticating using Google credentials
+     */
     @JsonProperty("clientSecret")
     public void setClientSecret(SecretNameReference clientSecret) {
         this.clientSecret = clientSecret;
     }
 
+    /**
+     * hostedDomain is the optional Google App domain (e.g. "mycompany.com") to restrict logins to
+     */
     @JsonProperty("hostedDomain")
     public String getHostedDomain() {
         return hostedDomain;
     }
 
+    /**
+     * hostedDomain is the optional Google App domain (e.g. "mycompany.com") to restrict logins to
+     */
     @JsonProperty("hostedDomain")
     public void setHostedDomain(String hostedDomain) {
         this.hostedDomain = hostedDomain;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/HTPasswdIdentityProvider.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/HTPasswdIdentityProvider.java
index 151d74317ad..f2713da652c 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/HTPasswdIdentityProvider.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/HTPasswdIdentityProvider.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTPasswdPasswordIdentityProvider provides identities for users authenticating using htpasswd credentials
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public HTPasswdIdentityProvider(SecretNameReference fileData) {
         this.fileData = fileData;
     }
 
+    /**
+     * HTPasswdPasswordIdentityProvider provides identities for users authenticating using htpasswd credentials
+     */
     @JsonProperty("fileData")
     public SecretNameReference getFileData() {
         return fileData;
     }
 
+    /**
+     * HTPasswdPasswordIdentityProvider provides identities for users authenticating using htpasswd credentials
+     */
     @JsonProperty("fileData")
     public void setFileData(SecretNameReference fileData) {
         this.fileData = fileData;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/HTTPServingInfo.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/HTTPServingInfo.java
index ae1c78d436f..01a49ef1b0f 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/HTTPServingInfo.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/HTTPServingInfo.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPServingInfo holds configuration for serving HTTP
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -118,103 +121,163 @@ public HTTPServingInfo(String bindAddress, String bindNetwork, String certFile,
         this.requestTimeoutSeconds = requestTimeoutSeconds;
     }
 
+    /**
+     * BindAddress is the ip:port to serve on
+     */
     @JsonProperty("bindAddress")
     public String getBindAddress() {
         return bindAddress;
     }
 
+    /**
+     * BindAddress is the ip:port to serve on
+     */
     @JsonProperty("bindAddress")
     public void setBindAddress(String bindAddress) {
         this.bindAddress = bindAddress;
     }
 
+    /**
+     * BindNetwork is the type of network to bind to - defaults to "tcp4", accepts "tcp", "tcp4", and "tcp6"
+     */
     @JsonProperty("bindNetwork")
     public String getBindNetwork() {
         return bindNetwork;
     }
 
+    /**
+     * BindNetwork is the type of network to bind to - defaults to "tcp4", accepts "tcp", "tcp4", and "tcp6"
+     */
     @JsonProperty("bindNetwork")
     public void setBindNetwork(String bindNetwork) {
         this.bindNetwork = bindNetwork;
     }
 
+    /**
+     * CertFile is a file containing a PEM-encoded certificate
+     */
     @JsonProperty("certFile")
     public String getCertFile() {
         return certFile;
     }
 
+    /**
+     * CertFile is a file containing a PEM-encoded certificate
+     */
     @JsonProperty("certFile")
     public void setCertFile(String certFile) {
         this.certFile = certFile;
     }
 
+    /**
+     * CipherSuites contains an overridden list of ciphers for the server to support. Values must match cipher suite IDs from https://golang.org/pkg/crypto/tls/#pkg-constants
+     */
     @JsonProperty("cipherSuites")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCipherSuites() {
         return cipherSuites;
     }
 
+    /**
+     * CipherSuites contains an overridden list of ciphers for the server to support. Values must match cipher suite IDs from https://golang.org/pkg/crypto/tls/#pkg-constants
+     */
     @JsonProperty("cipherSuites")
     public void setCipherSuites(List<String> cipherSuites) {
         this.cipherSuites = cipherSuites;
     }
 
+    /**
+     * ClientCA is the certificate bundle for all the signers that you'll recognize for incoming client certificates
+     */
     @JsonProperty("clientCA")
     public String getClientCA() {
         return clientCA;
     }
 
+    /**
+     * ClientCA is the certificate bundle for all the signers that you'll recognize for incoming client certificates
+     */
     @JsonProperty("clientCA")
     public void setClientCA(String clientCA) {
         this.clientCA = clientCA;
     }
 
+    /**
+     * KeyFile is a file containing a PEM-encoded private key for the certificate specified by CertFile
+     */
     @JsonProperty("keyFile")
     public String getKeyFile() {
         return keyFile;
     }
 
+    /**
+     * KeyFile is a file containing a PEM-encoded private key for the certificate specified by CertFile
+     */
     @JsonProperty("keyFile")
     public void setKeyFile(String keyFile) {
         this.keyFile = keyFile;
     }
 
+    /**
+     * MaxRequestsInFlight is the number of concurrent requests allowed to the server. If zero, no limit.
+     */
     @JsonProperty("maxRequestsInFlight")
     public Long getMaxRequestsInFlight() {
         return maxRequestsInFlight;
     }
 
+    /**
+     * MaxRequestsInFlight is the number of concurrent requests allowed to the server. If zero, no limit.
+     */
     @JsonProperty("maxRequestsInFlight")
     public void setMaxRequestsInFlight(Long maxRequestsInFlight) {
         this.maxRequestsInFlight = maxRequestsInFlight;
     }
 
+    /**
+     * MinTLSVersion is the minimum TLS version supported. Values must match version names from https://golang.org/pkg/crypto/tls/#pkg-constants
+     */
     @JsonProperty("minTLSVersion")
     public String getMinTLSVersion() {
         return minTLSVersion;
     }
 
+    /**
+     * MinTLSVersion is the minimum TLS version supported. Values must match version names from https://golang.org/pkg/crypto/tls/#pkg-constants
+     */
     @JsonProperty("minTLSVersion")
     public void setMinTLSVersion(String minTLSVersion) {
         this.minTLSVersion = minTLSVersion;
     }
 
+    /**
+     * NamedCertificates is a list of certificates to use to secure requests to specific hostnames
+     */
     @JsonProperty("namedCertificates")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NamedCertificate> getNamedCertificates() {
         return namedCertificates;
     }
 
+    /**
+     * NamedCertificates is a list of certificates to use to secure requests to specific hostnames
+     */
     @JsonProperty("namedCertificates")
     public void setNamedCertificates(List<NamedCertificate> namedCertificates) {
         this.namedCertificates = namedCertificates;
     }
 
+    /**
+     * RequestTimeoutSeconds is the number of seconds before requests are timed out. The default is 60 minutes, if -1 there is no limit on requests.
+     */
     @JsonProperty("requestTimeoutSeconds")
     public Long getRequestTimeoutSeconds() {
         return requestTimeoutSeconds;
     }
 
+    /**
+     * RequestTimeoutSeconds is the number of seconds before requests are timed out. The default is 60 minutes, if -1 there is no limit on requests.
+     */
     @JsonProperty("requestTimeoutSeconds")
     public void setRequestTimeoutSeconds(Long requestTimeoutSeconds) {
         this.requestTimeoutSeconds = requestTimeoutSeconds;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/HubSource.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/HubSource.java
index 0b3d4bf3bcc..52ba4770057 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/HubSource.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/HubSource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HubSource is used to specify the hub source and its configuration
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public HubSource(Boolean disabled, String name) {
         this.name = name;
     }
 
+    /**
+     * disabled is used to disable a default hub source on cluster
+     */
     @JsonProperty("disabled")
     public Boolean getDisabled() {
         return disabled;
     }
 
+    /**
+     * disabled is used to disable a default hub source on cluster
+     */
     @JsonProperty("disabled")
     public void setDisabled(Boolean disabled) {
         this.disabled = disabled;
     }
 
+    /**
+     * name is the name of one of the default hub sources
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of one of the default hub sources
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/HubSourceStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/HubSourceStatus.java
index ea134f067b5..adaed45660b 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/HubSourceStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/HubSourceStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HubSourceStatus is used to reflect the current state of applying the configuration to a default source
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public HubSourceStatus(String message, String status) {
         this.status = status;
     }
 
+    /**
+     * message provides more information regarding failures
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message provides more information regarding failures
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * status indicates success or failure in applying the configuration
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * status indicates success or failure in applying the configuration
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IBMCloudPlatformSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IBMCloudPlatformSpec.java
index f4a48554974..b14a4625d89 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IBMCloudPlatformSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IBMCloudPlatformSpec.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IBMCloudPlatformSpec holds the desired state of the IBMCloud infrastructure provider. This only includes fields that can be modified in the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IBMCloudPlatformStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IBMCloudPlatformStatus.java
index d9e3511bb3a..5bd35884859 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IBMCloudPlatformStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IBMCloudPlatformStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IBMCloudPlatformStatus holds the current status of the IBMCloud infrastructure provider.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,62 +104,98 @@ public IBMCloudPlatformStatus(String cisInstanceCRN, String dnsInstanceCRN, Stri
         this.serviceEndpoints = serviceEndpoints;
     }
 
+    /**
+     * CISInstanceCRN is the CRN of the Cloud Internet Services instance managing the DNS zone for the cluster's base domain
+     */
     @JsonProperty("cisInstanceCRN")
     public String getCisInstanceCRN() {
         return cisInstanceCRN;
     }
 
+    /**
+     * CISInstanceCRN is the CRN of the Cloud Internet Services instance managing the DNS zone for the cluster's base domain
+     */
     @JsonProperty("cisInstanceCRN")
     public void setCisInstanceCRN(String cisInstanceCRN) {
         this.cisInstanceCRN = cisInstanceCRN;
     }
 
+    /**
+     * DNSInstanceCRN is the CRN of the DNS Services instance managing the DNS zone for the cluster's base domain
+     */
     @JsonProperty("dnsInstanceCRN")
     public String getDnsInstanceCRN() {
         return dnsInstanceCRN;
     }
 
+    /**
+     * DNSInstanceCRN is the CRN of the DNS Services instance managing the DNS zone for the cluster's base domain
+     */
     @JsonProperty("dnsInstanceCRN")
     public void setDnsInstanceCRN(String dnsInstanceCRN) {
         this.dnsInstanceCRN = dnsInstanceCRN;
     }
 
+    /**
+     * Location is where the cluster has been deployed
+     */
     @JsonProperty("location")
     public String getLocation() {
         return location;
     }
 
+    /**
+     * Location is where the cluster has been deployed
+     */
     @JsonProperty("location")
     public void setLocation(String location) {
         this.location = location;
     }
 
+    /**
+     * ProviderType indicates the type of cluster that was created
+     */
     @JsonProperty("providerType")
     public String getProviderType() {
         return providerType;
     }
 
+    /**
+     * ProviderType indicates the type of cluster that was created
+     */
     @JsonProperty("providerType")
     public void setProviderType(String providerType) {
         this.providerType = providerType;
     }
 
+    /**
+     * ResourceGroupName is the Resource Group for new IBMCloud resources created for the cluster.
+     */
     @JsonProperty("resourceGroupName")
     public String getResourceGroupName() {
         return resourceGroupName;
     }
 
+    /**
+     * ResourceGroupName is the Resource Group for new IBMCloud resources created for the cluster.
+     */
     @JsonProperty("resourceGroupName")
     public void setResourceGroupName(String resourceGroupName) {
         this.resourceGroupName = resourceGroupName;
     }
 
+    /**
+     * serviceEndpoints is a list of custom endpoints which will override the default service endpoints of an IBM Cloud service. These endpoints are consumed by components within the cluster to reach the respective IBM Cloud Services.
+     */
     @JsonProperty("serviceEndpoints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IBMCloudServiceEndpoint> getServiceEndpoints() {
         return serviceEndpoints;
     }
 
+    /**
+     * serviceEndpoints is a list of custom endpoints which will override the default service endpoints of an IBM Cloud service. These endpoints are consumed by components within the cluster to reach the respective IBM Cloud Services.
+     */
     @JsonProperty("serviceEndpoints")
     public void setServiceEndpoints(List<IBMCloudServiceEndpoint> serviceEndpoints) {
         this.serviceEndpoints = serviceEndpoints;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IBMCloudServiceEndpoint.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IBMCloudServiceEndpoint.java
index fdd0ac7aa76..f99e25e0d17 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IBMCloudServiceEndpoint.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IBMCloudServiceEndpoint.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IBMCloudServiceEndpoint stores the configuration of a custom url to override existing defaults of IBM Cloud Services.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public IBMCloudServiceEndpoint(String name, String url) {
         this.url = url;
     }
 
+    /**
+     * name is the name of the IBM Cloud service. Possible values are: CIS, COS, COSConfig, DNSServices, GlobalCatalog, GlobalSearch, GlobalTagging, HyperProtect, IAM, KeyProtect, ResourceController, ResourceManager, or VPC. For example, the IBM Cloud Private IAM service could be configured with the service `name` of `IAM` and `url` of `https://private.iam.cloud.ibm.com` Whereas the IBM Cloud Private VPC service for US South (Dallas) could be configured with the service `name` of `VPC` and `url` of `https://us.south.private.iaas.cloud.ibm.com`
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the IBM Cloud service. Possible values are: CIS, COS, COSConfig, DNSServices, GlobalCatalog, GlobalSearch, GlobalTagging, HyperProtect, IAM, KeyProtect, ResourceController, ResourceManager, or VPC. For example, the IBM Cloud Private IAM service could be configured with the service `name` of `IAM` and `url` of `https://private.iam.cloud.ibm.com` Whereas the IBM Cloud Private VPC service for US South (Dallas) could be configured with the service `name` of `VPC` and `url` of `https://us.south.private.iaas.cloud.ibm.com`
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * url is fully qualified URI with scheme https, that overrides the default generated endpoint for a client. This must be provided and cannot be empty.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * url is fully qualified URI with scheme https, that overrides the default generated endpoint for a client. This must be provided and cannot be empty.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IdentityProvider.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IdentityProvider.java
index ce537e4a0a6..6bb273822f9 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IdentityProvider.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IdentityProvider.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IdentityProvider provides identities for users authenticating using credentials
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -122,121 +125,193 @@ public IdentityProvider(BasicAuthIdentityProvider basicAuth, GitHubIdentityProvi
         this.type = type;
     }
 
+    /**
+     * IdentityProvider provides identities for users authenticating using credentials
+     */
     @JsonProperty("basicAuth")
     public BasicAuthIdentityProvider getBasicAuth() {
         return basicAuth;
     }
 
+    /**
+     * IdentityProvider provides identities for users authenticating using credentials
+     */
     @JsonProperty("basicAuth")
     public void setBasicAuth(BasicAuthIdentityProvider basicAuth) {
         this.basicAuth = basicAuth;
     }
 
+    /**
+     * IdentityProvider provides identities for users authenticating using credentials
+     */
     @JsonProperty("github")
     public GitHubIdentityProvider getGithub() {
         return github;
     }
 
+    /**
+     * IdentityProvider provides identities for users authenticating using credentials
+     */
     @JsonProperty("github")
     public void setGithub(GitHubIdentityProvider github) {
         this.github = github;
     }
 
+    /**
+     * IdentityProvider provides identities for users authenticating using credentials
+     */
     @JsonProperty("gitlab")
     public GitLabIdentityProvider getGitlab() {
         return gitlab;
     }
 
+    /**
+     * IdentityProvider provides identities for users authenticating using credentials
+     */
     @JsonProperty("gitlab")
     public void setGitlab(GitLabIdentityProvider gitlab) {
         this.gitlab = gitlab;
     }
 
+    /**
+     * IdentityProvider provides identities for users authenticating using credentials
+     */
     @JsonProperty("google")
     public GoogleIdentityProvider getGoogle() {
         return google;
     }
 
+    /**
+     * IdentityProvider provides identities for users authenticating using credentials
+     */
     @JsonProperty("google")
     public void setGoogle(GoogleIdentityProvider google) {
         this.google = google;
     }
 
+    /**
+     * IdentityProvider provides identities for users authenticating using credentials
+     */
     @JsonProperty("htpasswd")
     public HTPasswdIdentityProvider getHtpasswd() {
         return htpasswd;
     }
 
+    /**
+     * IdentityProvider provides identities for users authenticating using credentials
+     */
     @JsonProperty("htpasswd")
     public void setHtpasswd(HTPasswdIdentityProvider htpasswd) {
         this.htpasswd = htpasswd;
     }
 
+    /**
+     * IdentityProvider provides identities for users authenticating using credentials
+     */
     @JsonProperty("keystone")
     public KeystoneIdentityProvider getKeystone() {
         return keystone;
     }
 
+    /**
+     * IdentityProvider provides identities for users authenticating using credentials
+     */
     @JsonProperty("keystone")
     public void setKeystone(KeystoneIdentityProvider keystone) {
         this.keystone = keystone;
     }
 
+    /**
+     * IdentityProvider provides identities for users authenticating using credentials
+     */
     @JsonProperty("ldap")
     public LDAPIdentityProvider getLdap() {
         return ldap;
     }
 
+    /**
+     * IdentityProvider provides identities for users authenticating using credentials
+     */
     @JsonProperty("ldap")
     public void setLdap(LDAPIdentityProvider ldap) {
         this.ldap = ldap;
     }
 
+    /**
+     * mappingMethod determines how identities from this provider are mapped to users Defaults to "claim"
+     */
     @JsonProperty("mappingMethod")
     public String getMappingMethod() {
         return mappingMethod;
     }
 
+    /**
+     * mappingMethod determines how identities from this provider are mapped to users Defaults to "claim"
+     */
     @JsonProperty("mappingMethod")
     public void setMappingMethod(String mappingMethod) {
         this.mappingMethod = mappingMethod;
     }
 
+    /**
+     * name is used to qualify the identities returned by this provider. - It MUST be unique and not shared by any other identity provider used - It MUST be a valid path segment: name cannot equal "." or ".." or contain "/" or "%" or ":"<br><p>   Ref: https://godoc.org/github.com/openshift/origin/pkg/user/apis/user/validation#ValidateIdentityProviderName
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is used to qualify the identities returned by this provider. - It MUST be unique and not shared by any other identity provider used - It MUST be a valid path segment: name cannot equal "." or ".." or contain "/" or "%" or ":"<br><p>   Ref: https://godoc.org/github.com/openshift/origin/pkg/user/apis/user/validation#ValidateIdentityProviderName
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * IdentityProvider provides identities for users authenticating using credentials
+     */
     @JsonProperty("openID")
     public OpenIDIdentityProvider getOpenID() {
         return openID;
     }
 
+    /**
+     * IdentityProvider provides identities for users authenticating using credentials
+     */
     @JsonProperty("openID")
     public void setOpenID(OpenIDIdentityProvider openID) {
         this.openID = openID;
     }
 
+    /**
+     * IdentityProvider provides identities for users authenticating using credentials
+     */
     @JsonProperty("requestHeader")
     public RequestHeaderIdentityProvider getRequestHeader() {
         return requestHeader;
     }
 
+    /**
+     * IdentityProvider provides identities for users authenticating using credentials
+     */
     @JsonProperty("requestHeader")
     public void setRequestHeader(RequestHeaderIdentityProvider requestHeader) {
         this.requestHeader = requestHeader;
     }
 
+    /**
+     * type identifies the identity provider type for this entry.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type identifies the identity provider type for this entry.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IdentityProviderConfig.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IdentityProviderConfig.java
index 4524012f316..5af6058762d 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IdentityProviderConfig.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IdentityProviderConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IdentityProviderConfig contains configuration for using a specific identity provider
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -114,101 +117,161 @@ public IdentityProviderConfig(BasicAuthIdentityProvider basicAuth, GitHubIdentit
         this.type = type;
     }
 
+    /**
+     * IdentityProviderConfig contains configuration for using a specific identity provider
+     */
     @JsonProperty("basicAuth")
     public BasicAuthIdentityProvider getBasicAuth() {
         return basicAuth;
     }
 
+    /**
+     * IdentityProviderConfig contains configuration for using a specific identity provider
+     */
     @JsonProperty("basicAuth")
     public void setBasicAuth(BasicAuthIdentityProvider basicAuth) {
         this.basicAuth = basicAuth;
     }
 
+    /**
+     * IdentityProviderConfig contains configuration for using a specific identity provider
+     */
     @JsonProperty("github")
     public GitHubIdentityProvider getGithub() {
         return github;
     }
 
+    /**
+     * IdentityProviderConfig contains configuration for using a specific identity provider
+     */
     @JsonProperty("github")
     public void setGithub(GitHubIdentityProvider github) {
         this.github = github;
     }
 
+    /**
+     * IdentityProviderConfig contains configuration for using a specific identity provider
+     */
     @JsonProperty("gitlab")
     public GitLabIdentityProvider getGitlab() {
         return gitlab;
     }
 
+    /**
+     * IdentityProviderConfig contains configuration for using a specific identity provider
+     */
     @JsonProperty("gitlab")
     public void setGitlab(GitLabIdentityProvider gitlab) {
         this.gitlab = gitlab;
     }
 
+    /**
+     * IdentityProviderConfig contains configuration for using a specific identity provider
+     */
     @JsonProperty("google")
     public GoogleIdentityProvider getGoogle() {
         return google;
     }
 
+    /**
+     * IdentityProviderConfig contains configuration for using a specific identity provider
+     */
     @JsonProperty("google")
     public void setGoogle(GoogleIdentityProvider google) {
         this.google = google;
     }
 
+    /**
+     * IdentityProviderConfig contains configuration for using a specific identity provider
+     */
     @JsonProperty("htpasswd")
     public HTPasswdIdentityProvider getHtpasswd() {
         return htpasswd;
     }
 
+    /**
+     * IdentityProviderConfig contains configuration for using a specific identity provider
+     */
     @JsonProperty("htpasswd")
     public void setHtpasswd(HTPasswdIdentityProvider htpasswd) {
         this.htpasswd = htpasswd;
     }
 
+    /**
+     * IdentityProviderConfig contains configuration for using a specific identity provider
+     */
     @JsonProperty("keystone")
     public KeystoneIdentityProvider getKeystone() {
         return keystone;
     }
 
+    /**
+     * IdentityProviderConfig contains configuration for using a specific identity provider
+     */
     @JsonProperty("keystone")
     public void setKeystone(KeystoneIdentityProvider keystone) {
         this.keystone = keystone;
     }
 
+    /**
+     * IdentityProviderConfig contains configuration for using a specific identity provider
+     */
     @JsonProperty("ldap")
     public LDAPIdentityProvider getLdap() {
         return ldap;
     }
 
+    /**
+     * IdentityProviderConfig contains configuration for using a specific identity provider
+     */
     @JsonProperty("ldap")
     public void setLdap(LDAPIdentityProvider ldap) {
         this.ldap = ldap;
     }
 
+    /**
+     * IdentityProviderConfig contains configuration for using a specific identity provider
+     */
     @JsonProperty("openID")
     public OpenIDIdentityProvider getOpenID() {
         return openID;
     }
 
+    /**
+     * IdentityProviderConfig contains configuration for using a specific identity provider
+     */
     @JsonProperty("openID")
     public void setOpenID(OpenIDIdentityProvider openID) {
         this.openID = openID;
     }
 
+    /**
+     * IdentityProviderConfig contains configuration for using a specific identity provider
+     */
     @JsonProperty("requestHeader")
     public RequestHeaderIdentityProvider getRequestHeader() {
         return requestHeader;
     }
 
+    /**
+     * IdentityProviderConfig contains configuration for using a specific identity provider
+     */
     @JsonProperty("requestHeader")
     public void setRequestHeader(RequestHeaderIdentityProvider requestHeader) {
         this.requestHeader = requestHeader;
     }
 
+    /**
+     * type identifies the identity provider type for this entry.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type identifies the identity provider type for this entry.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Image.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Image.java
index 9273dc3ae9f..912aeea5182 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Image.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Image.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Image governs policies related to imagestream imports and runtime configuration for external registries. It allows cluster admins to configure which registries OpenShift is allowed to import images from, extra CA trust bundles for external registries, and policies to block or allow registry hostnames. When exposing OpenShift's image registry to the public, this also lets cluster admins specify the external hostname.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Image implements Editable<ImageBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Image";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public Image(String apiVersion, String kind, ObjectMeta metadata, ImageSpec spec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Image governs policies related to imagestream imports and runtime configuration for external registries. It allows cluster admins to configure which registries OpenShift is allowed to import images from, extra CA trust bundles for external registries, and policies to block or allow registry hostnames. When exposing OpenShift's image registry to the public, this also lets cluster admins specify the external hostname.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Image governs policies related to imagestream imports and runtime configuration for external registries. It allows cluster admins to configure which registries OpenShift is allowed to import images from, extra CA trust bundles for external registries, and policies to block or allow registry hostnames. When exposing OpenShift's image registry to the public, this also lets cluster admins specify the external hostname.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Image governs policies related to imagestream imports and runtime configuration for external registries. It allows cluster admins to configure which registries OpenShift is allowed to import images from, extra CA trust bundles for external registries, and policies to block or allow registry hostnames. When exposing OpenShift's image registry to the public, this also lets cluster admins specify the external hostname.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ImageSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Image governs policies related to imagestream imports and runtime configuration for external registries. It allows cluster admins to configure which registries OpenShift is allowed to import images from, extra CA trust bundles for external registries, and policies to block or allow registry hostnames. When exposing OpenShift's image registry to the public, this also lets cluster admins specify the external hostname.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ImageSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Image governs policies related to imagestream imports and runtime configuration for external registries. It allows cluster admins to configure which registries OpenShift is allowed to import images from, extra CA trust bundles for external registries, and policies to block or allow registry hostnames. When exposing OpenShift's image registry to the public, this also lets cluster admins specify the external hostname.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public ImageStatus getStatus() {
         return status;
     }
 
+    /**
+     * Image governs policies related to imagestream imports and runtime configuration for external registries. It allows cluster admins to configure which registries OpenShift is allowed to import images from, extra CA trust bundles for external registries, and policies to block or allow registry hostnames. When exposing OpenShift's image registry to the public, this also lets cluster admins specify the external hostname.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(ImageStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageContentPolicy.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageContentPolicy.java
index 533948ea708..a76dfbd02b4 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageContentPolicy.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageContentPolicy.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageContentPolicy holds cluster-wide information about how to handle registry mirror rules. When multiple policies are defined, the outcome of the behavior is defined on each field.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class ImageContentPolicy implements Editable<ImageContentPolicyBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ImageContentPolicy";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public ImageContentPolicy(String apiVersion, String kind, ObjectMeta metadata, I
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ImageContentPolicy holds cluster-wide information about how to handle registry mirror rules. When multiple policies are defined, the outcome of the behavior is defined on each field.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ImageContentPolicy holds cluster-wide information about how to handle registry mirror rules. When multiple policies are defined, the outcome of the behavior is defined on each field.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ImageContentPolicy holds cluster-wide information about how to handle registry mirror rules. When multiple policies are defined, the outcome of the behavior is defined on each field.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ImageContentPolicySpec getSpec() {
         return spec;
     }
 
+    /**
+     * ImageContentPolicy holds cluster-wide information about how to handle registry mirror rules. When multiple policies are defined, the outcome of the behavior is defined on each field.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ImageContentPolicySpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageContentPolicyList.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageContentPolicyList.java
index f7df16a7d37..6dc797e52db 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageContentPolicyList.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageContentPolicyList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageContentPolicyList lists the items in the ImageContentPolicy CRD.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ImageContentPolicyList implements Editable<ImageContentPolicyListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.config.v1.ImageContentPolicy>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.config.v1.ImageContentPolicy> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ImageContentPolicyList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ImageContentPolicyList(String apiVersion, List<io.fabric8.openshift.api.m
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ImageContentPolicyList lists the items in the ImageContentPolicy CRD.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.config.v1.ImageContentPolicy> getItems() {
         return items;
     }
 
+    /**
+     * ImageContentPolicyList lists the items in the ImageContentPolicy CRD.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.config.v1.ImageContentPolicy> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ImageContentPolicyList lists the items in the ImageContentPolicy CRD.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ImageContentPolicyList lists the items in the ImageContentPolicy CRD.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageContentPolicySpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageContentPolicySpec.java
index 9d708a120c9..b38d5a329b3 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageContentPolicySpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageContentPolicySpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageContentPolicySpec is the specification of the ImageContentPolicy CRD.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public ImageContentPolicySpec(List<RepositoryDigestMirrors> repositoryDigestMirr
         this.repositoryDigestMirrors = repositoryDigestMirrors;
     }
 
+    /**
+     * repositoryDigestMirrors allows images referenced by image digests in pods to be pulled from alternative mirrored repository locations. The image pull specification provided to the pod will be compared to the source locations described in RepositoryDigestMirrors and the image may be pulled down from any of the mirrors in the list instead of the specified repository allowing administrators to choose a potentially faster mirror. To pull image from mirrors by tags, should set the "allowMirrorByTags".<br><p> <br><p> Each "source" repository is treated independently; configurations for different "source" repositories don’t interact.<br><p> <br><p> If the "mirrors" is not specified, the image will continue to be pulled from the specified repository in the pull spec.<br><p> <br><p> When multiple policies are defined for the same "source" repository, the sets of defined mirrors will be merged together, preserving the relative order of the mirrors, if possible. For example, if policy A has mirrors `a, b, c` and policy B has mirrors `c, d, e`, the mirrors will be used in the order `a, b, c, d, e`.  If the orders of mirror entries conflict (e.g. `a, b` vs. `b, a`) the configuration is not rejected but the resulting order is unspecified.
+     */
     @JsonProperty("repositoryDigestMirrors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RepositoryDigestMirrors> getRepositoryDigestMirrors() {
         return repositoryDigestMirrors;
     }
 
+    /**
+     * repositoryDigestMirrors allows images referenced by image digests in pods to be pulled from alternative mirrored repository locations. The image pull specification provided to the pod will be compared to the source locations described in RepositoryDigestMirrors and the image may be pulled down from any of the mirrors in the list instead of the specified repository allowing administrators to choose a potentially faster mirror. To pull image from mirrors by tags, should set the "allowMirrorByTags".<br><p> <br><p> Each "source" repository is treated independently; configurations for different "source" repositories don’t interact.<br><p> <br><p> If the "mirrors" is not specified, the image will continue to be pulled from the specified repository in the pull spec.<br><p> <br><p> When multiple policies are defined for the same "source" repository, the sets of defined mirrors will be merged together, preserving the relative order of the mirrors, if possible. For example, if policy A has mirrors `a, b, c` and policy B has mirrors `c, d, e`, the mirrors will be used in the order `a, b, c, d, e`.  If the orders of mirror entries conflict (e.g. `a, b` vs. `b, a`) the configuration is not rejected but the resulting order is unspecified.
+     */
     @JsonProperty("repositoryDigestMirrors")
     public void setRepositoryDigestMirrors(List<RepositoryDigestMirrors> repositoryDigestMirrors) {
         this.repositoryDigestMirrors = repositoryDigestMirrors;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageDigestMirrorSet.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageDigestMirrorSet.java
index 8d85f5a5c0a..b61afda7065 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageDigestMirrorSet.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageDigestMirrorSet.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageDigestMirrorSet holds cluster-wide information about how to handle registry mirror rules on using digest pull specification. When multiple policies are defined, the outcome of the behavior is defined on each field.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ImageDigestMirrorSet implements Editable<ImageDigestMirrorSetBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ImageDigestMirrorSet";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public ImageDigestMirrorSet(String apiVersion, String kind, ObjectMeta metadata,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ImageDigestMirrorSet holds cluster-wide information about how to handle registry mirror rules on using digest pull specification. When multiple policies are defined, the outcome of the behavior is defined on each field.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ImageDigestMirrorSet holds cluster-wide information about how to handle registry mirror rules on using digest pull specification. When multiple policies are defined, the outcome of the behavior is defined on each field.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ImageDigestMirrorSet holds cluster-wide information about how to handle registry mirror rules on using digest pull specification. When multiple policies are defined, the outcome of the behavior is defined on each field.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ImageDigestMirrorSetSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ImageDigestMirrorSet holds cluster-wide information about how to handle registry mirror rules on using digest pull specification. When multiple policies are defined, the outcome of the behavior is defined on each field.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ImageDigestMirrorSetSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ImageDigestMirrorSet holds cluster-wide information about how to handle registry mirror rules on using digest pull specification. When multiple policies are defined, the outcome of the behavior is defined on each field.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public ImageDigestMirrorSetStatus getStatus() {
         return status;
     }
 
+    /**
+     * ImageDigestMirrorSet holds cluster-wide information about how to handle registry mirror rules on using digest pull specification. When multiple policies are defined, the outcome of the behavior is defined on each field.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(ImageDigestMirrorSetStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageDigestMirrorSetList.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageDigestMirrorSetList.java
index 83289e46bff..7710713555a 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageDigestMirrorSetList.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageDigestMirrorSetList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageDigestMirrorSetList lists the items in the ImageDigestMirrorSet CRD.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ImageDigestMirrorSetList implements Editable<ImageDigestMirrorSetListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.config.v1.ImageDigestMirrorSet>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.config.v1.ImageDigestMirrorSet> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ImageDigestMirrorSetList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ImageDigestMirrorSetList(String apiVersion, List<io.fabric8.openshift.api
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ImageDigestMirrorSetList lists the items in the ImageDigestMirrorSet CRD.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.config.v1.ImageDigestMirrorSet> getItems() {
         return items;
     }
 
+    /**
+     * ImageDigestMirrorSetList lists the items in the ImageDigestMirrorSet CRD.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.config.v1.ImageDigestMirrorSet> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ImageDigestMirrorSetList lists the items in the ImageDigestMirrorSet CRD.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ImageDigestMirrorSetList lists the items in the ImageDigestMirrorSet CRD.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageDigestMirrorSetSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageDigestMirrorSetSpec.java
index a9ec8e8de7a..b921da7a332 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageDigestMirrorSetSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageDigestMirrorSetSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageDigestMirrorSetSpec is the specification of the ImageDigestMirrorSet CRD.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public ImageDigestMirrorSetSpec(List<ImageDigestMirrors> imageDigestMirrors) {
         this.imageDigestMirrors = imageDigestMirrors;
     }
 
+    /**
+     * imageDigestMirrors allows images referenced by image digests in pods to be pulled from alternative mirrored repository locations. The image pull specification provided to the pod will be compared to the source locations described in imageDigestMirrors and the image may be pulled down from any of the mirrors in the list instead of the specified repository allowing administrators to choose a potentially faster mirror. To use mirrors to pull images using tag specification, users should configure a list of mirrors using "ImageTagMirrorSet" CRD.<br><p> <br><p> If the image pull specification matches the repository of "source" in multiple imagedigestmirrorset objects, only the objects which define the most specific namespace match will be used. For example, if there are objects using quay.io/libpod and quay.io/libpod/busybox as the "source", only the objects using quay.io/libpod/busybox are going to apply for pull specification quay.io/libpod/busybox. Each "source" repository is treated independently; configurations for different "source" repositories don’t interact.<br><p> <br><p> If the "mirrors" is not specified, the image will continue to be pulled from the specified repository in the pull spec.<br><p> <br><p> When multiple policies are defined for the same "source" repository, the sets of defined mirrors will be merged together, preserving the relative order of the mirrors, if possible. For example, if policy A has mirrors `a, b, c` and policy B has mirrors `c, d, e`, the mirrors will be used in the order `a, b, c, d, e`.  If the orders of mirror entries conflict (e.g. `a, b` vs. `b, a`) the configuration is not rejected but the resulting order is unspecified. Users who want to use a specific order of mirrors, should configure them into one list of mirrors using the expected order.
+     */
     @JsonProperty("imageDigestMirrors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ImageDigestMirrors> getImageDigestMirrors() {
         return imageDigestMirrors;
     }
 
+    /**
+     * imageDigestMirrors allows images referenced by image digests in pods to be pulled from alternative mirrored repository locations. The image pull specification provided to the pod will be compared to the source locations described in imageDigestMirrors and the image may be pulled down from any of the mirrors in the list instead of the specified repository allowing administrators to choose a potentially faster mirror. To use mirrors to pull images using tag specification, users should configure a list of mirrors using "ImageTagMirrorSet" CRD.<br><p> <br><p> If the image pull specification matches the repository of "source" in multiple imagedigestmirrorset objects, only the objects which define the most specific namespace match will be used. For example, if there are objects using quay.io/libpod and quay.io/libpod/busybox as the "source", only the objects using quay.io/libpod/busybox are going to apply for pull specification quay.io/libpod/busybox. Each "source" repository is treated independently; configurations for different "source" repositories don’t interact.<br><p> <br><p> If the "mirrors" is not specified, the image will continue to be pulled from the specified repository in the pull spec.<br><p> <br><p> When multiple policies are defined for the same "source" repository, the sets of defined mirrors will be merged together, preserving the relative order of the mirrors, if possible. For example, if policy A has mirrors `a, b, c` and policy B has mirrors `c, d, e`, the mirrors will be used in the order `a, b, c, d, e`.  If the orders of mirror entries conflict (e.g. `a, b` vs. `b, a`) the configuration is not rejected but the resulting order is unspecified. Users who want to use a specific order of mirrors, should configure them into one list of mirrors using the expected order.
+     */
     @JsonProperty("imageDigestMirrors")
     public void setImageDigestMirrors(List<ImageDigestMirrors> imageDigestMirrors) {
         this.imageDigestMirrors = imageDigestMirrors;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageDigestMirrors.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageDigestMirrors.java
index 5b822ee3fc3..16fb430f1d7 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageDigestMirrors.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageDigestMirrors.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageDigestMirrors holds cluster-wide information about how to handle mirrors in the registries config.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public ImageDigestMirrors(String mirrorSourcePolicy, List<String> mirrors, Strin
         this.source = source;
     }
 
+    /**
+     * mirrorSourcePolicy defines the fallback policy if fails to pull image from the mirrors. If unset, the image will continue to be pulled from the the repository in the pull spec. sourcePolicy is valid configuration only when one or more mirrors are in the mirror list.
+     */
     @JsonProperty("mirrorSourcePolicy")
     public String getMirrorSourcePolicy() {
         return mirrorSourcePolicy;
     }
 
+    /**
+     * mirrorSourcePolicy defines the fallback policy if fails to pull image from the mirrors. If unset, the image will continue to be pulled from the the repository in the pull spec. sourcePolicy is valid configuration only when one or more mirrors are in the mirror list.
+     */
     @JsonProperty("mirrorSourcePolicy")
     public void setMirrorSourcePolicy(String mirrorSourcePolicy) {
         this.mirrorSourcePolicy = mirrorSourcePolicy;
     }
 
+    /**
+     * mirrors is zero or more locations that may also contain the same images. No mirror will be configured if not specified. Images can be pulled from these mirrors only if they are referenced by their digests. The mirrored location is obtained by replacing the part of the input reference that matches source by the mirrors entry, e.g. for registry.redhat.io/product/repo reference, a (source, mirror) pair &#42;.redhat.io, mirror.local/redhat causes a mirror.local/redhat/product/repo repository to be used. The order of mirrors in this list is treated as the user's desired priority, while source is by default considered lower priority than all mirrors. If no mirror is specified or all image pulls from the mirror list fail, the image will continue to be pulled from the repository in the pull spec unless explicitly prohibited by "mirrorSourcePolicy" Other cluster configuration, including (but not limited to) other imageDigestMirrors objects, may impact the exact order mirrors are contacted in, or some mirrors may be contacted in parallel, so this should be considered a preference rather than a guarantee of ordering. "mirrors" uses one of the following formats: host[:port] host[:port]/namespace[/namespace…] host[:port]/namespace[/namespace…]/repo for more information about the format, see the document about the location field: https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md#choosing-a-registry-toml-table
+     */
     @JsonProperty("mirrors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMirrors() {
         return mirrors;
     }
 
+    /**
+     * mirrors is zero or more locations that may also contain the same images. No mirror will be configured if not specified. Images can be pulled from these mirrors only if they are referenced by their digests. The mirrored location is obtained by replacing the part of the input reference that matches source by the mirrors entry, e.g. for registry.redhat.io/product/repo reference, a (source, mirror) pair &#42;.redhat.io, mirror.local/redhat causes a mirror.local/redhat/product/repo repository to be used. The order of mirrors in this list is treated as the user's desired priority, while source is by default considered lower priority than all mirrors. If no mirror is specified or all image pulls from the mirror list fail, the image will continue to be pulled from the repository in the pull spec unless explicitly prohibited by "mirrorSourcePolicy" Other cluster configuration, including (but not limited to) other imageDigestMirrors objects, may impact the exact order mirrors are contacted in, or some mirrors may be contacted in parallel, so this should be considered a preference rather than a guarantee of ordering. "mirrors" uses one of the following formats: host[:port] host[:port]/namespace[/namespace…] host[:port]/namespace[/namespace…]/repo for more information about the format, see the document about the location field: https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md#choosing-a-registry-toml-table
+     */
     @JsonProperty("mirrors")
     public void setMirrors(List<String> mirrors) {
         this.mirrors = mirrors;
     }
 
+    /**
+     * source matches the repository that users refer to, e.g. in image pull specifications. Setting source to a registry hostname e.g. docker.io. quay.io, or registry.redhat.io, will match the image pull specification of corressponding registry. "source" uses one of the following formats: host[:port] host[:port]/namespace[/namespace…] host[:port]/namespace[/namespace…]/repo [&#42;.]host for more information about the format, see the document about the location field: https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md#choosing-a-registry-toml-table
+     */
     @JsonProperty("source")
     public String getSource() {
         return source;
     }
 
+    /**
+     * source matches the repository that users refer to, e.g. in image pull specifications. Setting source to a registry hostname e.g. docker.io. quay.io, or registry.redhat.io, will match the image pull specification of corressponding registry. "source" uses one of the following formats: host[:port] host[:port]/namespace[/namespace…] host[:port]/namespace[/namespace…]/repo [&#42;.]host for more information about the format, see the document about the location field: https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md#choosing-a-registry-toml-table
+     */
     @JsonProperty("source")
     public void setSource(String source) {
         this.source = source;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageLabel.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageLabel.java
index 17f32ddfad2..e7073df2fc2 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageLabel.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageLabel.java
@@ -82,21 +82,33 @@ public ImageLabel(String name, String value) {
         this.value = value;
     }
 
+    /**
+     * Name defines the name of the label. It must have non-zero length.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name defines the name of the label. It must have non-zero length.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Value defines the literal value of the label.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value defines the literal value of the label.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageList.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageList.java
index 1951025df72..9e7270821b6 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageList.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ImageList implements Editable<ImageListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.config.v1.Image>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.config.v1.Image> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ImageList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ImageList(String apiVersion, List<io.fabric8.openshift.api.model.config.v
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.config.v1.Image> getItems() {
         return items;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.config.v1.Image> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageSpec.java
index 3bd850a5070..9477dbc7a69 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageSpec.java
@@ -108,33 +108,51 @@ public void setAdditionalTrustedCA(ConfigMapNameReference additionalTrustedCA) {
         this.additionalTrustedCA = additionalTrustedCA;
     }
 
+    /**
+     * allowedRegistriesForImport limits the container image registries that normal users may import images from. Set this list to the registries that you trust to contain valid Docker images and that you want applications to be able to import from. Users with permission to create Images or ImageStreamMappings via the API are not affected by this policy - typically only administrators or system integrations will have those permissions.
+     */
     @JsonProperty("allowedRegistriesForImport")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RegistryLocation> getAllowedRegistriesForImport() {
         return allowedRegistriesForImport;
     }
 
+    /**
+     * allowedRegistriesForImport limits the container image registries that normal users may import images from. Set this list to the registries that you trust to contain valid Docker images and that you want applications to be able to import from. Users with permission to create Images or ImageStreamMappings via the API are not affected by this policy - typically only administrators or system integrations will have those permissions.
+     */
     @JsonProperty("allowedRegistriesForImport")
     public void setAllowedRegistriesForImport(List<RegistryLocation> allowedRegistriesForImport) {
         this.allowedRegistriesForImport = allowedRegistriesForImport;
     }
 
+    /**
+     * externalRegistryHostnames provides the hostnames for the default external image registry. The external hostname should be set only when the image registry is exposed externally. The first value is used in 'publicDockerImageRepository' field in ImageStreams. The value must be in "hostname[:port]" format.
+     */
     @JsonProperty("externalRegistryHostnames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getExternalRegistryHostnames() {
         return externalRegistryHostnames;
     }
 
+    /**
+     * externalRegistryHostnames provides the hostnames for the default external image registry. The external hostname should be set only when the image registry is exposed externally. The first value is used in 'publicDockerImageRepository' field in ImageStreams. The value must be in "hostname[:port]" format.
+     */
     @JsonProperty("externalRegistryHostnames")
     public void setExternalRegistryHostnames(List<String> externalRegistryHostnames) {
         this.externalRegistryHostnames = externalRegistryHostnames;
     }
 
+    /**
+     * imageStreamImportMode controls the import mode behaviour of imagestreams. It can be set to `Legacy` or `PreserveOriginal` or the empty string. If this value is specified, this setting is applied to all newly created imagestreams which do not have the value set. `Legacy` indicates that the legacy behaviour should be used. For manifest lists, the legacy behaviour will discard the manifest list and import a single sub-manifest. In this case, the platform is chosen in the following order of priority: 1. tag annotations; 2. control plane arch/os; 3. linux/amd64; 4. the first manifest in the list. `PreserveOriginal` indicates that the original manifest will be preserved. For manifest lists, the manifest list and all its sub-manifests will be imported. When empty, the behaviour will be decided based on the payload type advertised by the ClusterVersion status, i.e single arch payload implies the import mode is Legacy and multi payload implies PreserveOriginal.<br><p> <br><p> Possible enum values:<br><p>  - `"Legacy"` indicates that the legacy behaviour should be used. For manifest lists, the legacy behaviour will discard the manifest list and import a single sub-manifest. In this case, the platform is chosen in the following order of priority: 1. tag annotations; 2. control plane arch/os; 3. linux/amd64; 4. the first manifest in the list. This mode is the default.<br><p>  - `"PreserveOriginal"` indicates that the original manifest will be preserved. For manifest lists, the manifest list and all its sub-manifests will be imported.
+     */
     @JsonProperty("imageStreamImportMode")
     public String getImageStreamImportMode() {
         return imageStreamImportMode;
     }
 
+    /**
+     * imageStreamImportMode controls the import mode behaviour of imagestreams. It can be set to `Legacy` or `PreserveOriginal` or the empty string. If this value is specified, this setting is applied to all newly created imagestreams which do not have the value set. `Legacy` indicates that the legacy behaviour should be used. For manifest lists, the legacy behaviour will discard the manifest list and import a single sub-manifest. In this case, the platform is chosen in the following order of priority: 1. tag annotations; 2. control plane arch/os; 3. linux/amd64; 4. the first manifest in the list. `PreserveOriginal` indicates that the original manifest will be preserved. For manifest lists, the manifest list and all its sub-manifests will be imported. When empty, the behaviour will be decided based on the payload type advertised by the ClusterVersion status, i.e single arch payload implies the import mode is Legacy and multi payload implies PreserveOriginal.<br><p> <br><p> Possible enum values:<br><p>  - `"Legacy"` indicates that the legacy behaviour should be used. For manifest lists, the legacy behaviour will discard the manifest list and import a single sub-manifest. In this case, the platform is chosen in the following order of priority: 1. tag annotations; 2. control plane arch/os; 3. linux/amd64; 4. the first manifest in the list. This mode is the default.<br><p>  - `"PreserveOriginal"` indicates that the original manifest will be preserved. For manifest lists, the manifest list and all its sub-manifests will be imported.
+     */
     @JsonProperty("imageStreamImportMode")
     public void setImageStreamImportMode(String imageStreamImportMode) {
         this.imageStreamImportMode = imageStreamImportMode;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageStatus.java
index 8a423576c7d..4e8f26b5dd9 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageStatus.java
@@ -89,32 +89,50 @@ public ImageStatus(List<String> externalRegistryHostnames, String imageStreamImp
         this.internalRegistryHostname = internalRegistryHostname;
     }
 
+    /**
+     * externalRegistryHostnames provides the hostnames for the default external image registry. The external hostname should be set only when the image registry is exposed externally. The first value is used in 'publicDockerImageRepository' field in ImageStreams. The value must be in "hostname[:port]" format.
+     */
     @JsonProperty("externalRegistryHostnames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getExternalRegistryHostnames() {
         return externalRegistryHostnames;
     }
 
+    /**
+     * externalRegistryHostnames provides the hostnames for the default external image registry. The external hostname should be set only when the image registry is exposed externally. The first value is used in 'publicDockerImageRepository' field in ImageStreams. The value must be in "hostname[:port]" format.
+     */
     @JsonProperty("externalRegistryHostnames")
     public void setExternalRegistryHostnames(List<String> externalRegistryHostnames) {
         this.externalRegistryHostnames = externalRegistryHostnames;
     }
 
+    /**
+     * imageStreamImportMode controls the import mode behaviour of imagestreams. It can be `Legacy` or `PreserveOriginal`. `Legacy` indicates that the legacy behaviour should be used. For manifest lists, the legacy behaviour will discard the manifest list and import a single sub-manifest. In this case, the platform is chosen in the following order of priority: 1. tag annotations; 2. control plane arch/os; 3. linux/amd64; 4. the first manifest in the list. `PreserveOriginal` indicates that the original manifest will be preserved. For manifest lists, the manifest list and all its sub-manifests will be imported. This value will be reconciled based on either the spec value or if no spec value is specified, the image registry operator would look at the ClusterVersion status to determine the payload type and set the import mode accordingly, i.e single arch payload implies the import mode is Legacy and multi payload implies PreserveOriginal.<br><p> <br><p> Possible enum values:<br><p>  - `"Legacy"` indicates that the legacy behaviour should be used. For manifest lists, the legacy behaviour will discard the manifest list and import a single sub-manifest. In this case, the platform is chosen in the following order of priority: 1. tag annotations; 2. control plane arch/os; 3. linux/amd64; 4. the first manifest in the list. This mode is the default.<br><p>  - `"PreserveOriginal"` indicates that the original manifest will be preserved. For manifest lists, the manifest list and all its sub-manifests will be imported.
+     */
     @JsonProperty("imageStreamImportMode")
     public String getImageStreamImportMode() {
         return imageStreamImportMode;
     }
 
+    /**
+     * imageStreamImportMode controls the import mode behaviour of imagestreams. It can be `Legacy` or `PreserveOriginal`. `Legacy` indicates that the legacy behaviour should be used. For manifest lists, the legacy behaviour will discard the manifest list and import a single sub-manifest. In this case, the platform is chosen in the following order of priority: 1. tag annotations; 2. control plane arch/os; 3. linux/amd64; 4. the first manifest in the list. `PreserveOriginal` indicates that the original manifest will be preserved. For manifest lists, the manifest list and all its sub-manifests will be imported. This value will be reconciled based on either the spec value or if no spec value is specified, the image registry operator would look at the ClusterVersion status to determine the payload type and set the import mode accordingly, i.e single arch payload implies the import mode is Legacy and multi payload implies PreserveOriginal.<br><p> <br><p> Possible enum values:<br><p>  - `"Legacy"` indicates that the legacy behaviour should be used. For manifest lists, the legacy behaviour will discard the manifest list and import a single sub-manifest. In this case, the platform is chosen in the following order of priority: 1. tag annotations; 2. control plane arch/os; 3. linux/amd64; 4. the first manifest in the list. This mode is the default.<br><p>  - `"PreserveOriginal"` indicates that the original manifest will be preserved. For manifest lists, the manifest list and all its sub-manifests will be imported.
+     */
     @JsonProperty("imageStreamImportMode")
     public void setImageStreamImportMode(String imageStreamImportMode) {
         this.imageStreamImportMode = imageStreamImportMode;
     }
 
+    /**
+     * internalRegistryHostname sets the hostname for the default internal image registry. The value must be in "hostname[:port]" format. This value is set by the image registry operator which controls the internal registry hostname.
+     */
     @JsonProperty("internalRegistryHostname")
     public String getInternalRegistryHostname() {
         return internalRegistryHostname;
     }
 
+    /**
+     * internalRegistryHostname sets the hostname for the default internal image registry. The value must be in "hostname[:port]" format. This value is set by the image registry operator which controls the internal registry hostname.
+     */
     @JsonProperty("internalRegistryHostname")
     public void setInternalRegistryHostname(String internalRegistryHostname) {
         this.internalRegistryHostname = internalRegistryHostname;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageTagMirrorSet.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageTagMirrorSet.java
index 376087805e4..dc0d370b334 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageTagMirrorSet.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageTagMirrorSet.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageTagMirrorSet holds cluster-wide information about how to handle registry mirror rules on using tag pull specification. When multiple policies are defined, the outcome of the behavior is defined on each field.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ImageTagMirrorSet implements Editable<ImageTagMirrorSetBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ImageTagMirrorSet";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public ImageTagMirrorSet(String apiVersion, String kind, ObjectMeta metadata, Im
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ImageTagMirrorSet holds cluster-wide information about how to handle registry mirror rules on using tag pull specification. When multiple policies are defined, the outcome of the behavior is defined on each field.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ImageTagMirrorSet holds cluster-wide information about how to handle registry mirror rules on using tag pull specification. When multiple policies are defined, the outcome of the behavior is defined on each field.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ImageTagMirrorSet holds cluster-wide information about how to handle registry mirror rules on using tag pull specification. When multiple policies are defined, the outcome of the behavior is defined on each field.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ImageTagMirrorSetSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ImageTagMirrorSet holds cluster-wide information about how to handle registry mirror rules on using tag pull specification. When multiple policies are defined, the outcome of the behavior is defined on each field.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ImageTagMirrorSetSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ImageTagMirrorSet holds cluster-wide information about how to handle registry mirror rules on using tag pull specification. When multiple policies are defined, the outcome of the behavior is defined on each field.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public ImageTagMirrorSetStatus getStatus() {
         return status;
     }
 
+    /**
+     * ImageTagMirrorSet holds cluster-wide information about how to handle registry mirror rules on using tag pull specification. When multiple policies are defined, the outcome of the behavior is defined on each field.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(ImageTagMirrorSetStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageTagMirrorSetList.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageTagMirrorSetList.java
index 86f6a1c0ff4..5771c568d8b 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageTagMirrorSetList.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageTagMirrorSetList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageTagMirrorSetList lists the items in the ImageTagMirrorSet CRD.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ImageTagMirrorSetList implements Editable<ImageTagMirrorSetListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.config.v1.ImageTagMirrorSet>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.config.v1.ImageTagMirrorSet> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ImageTagMirrorSetList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ImageTagMirrorSetList(String apiVersion, List<io.fabric8.openshift.api.mo
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ImageTagMirrorSetList lists the items in the ImageTagMirrorSet CRD.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.config.v1.ImageTagMirrorSet> getItems() {
         return items;
     }
 
+    /**
+     * ImageTagMirrorSetList lists the items in the ImageTagMirrorSet CRD.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.config.v1.ImageTagMirrorSet> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ImageTagMirrorSetList lists the items in the ImageTagMirrorSet CRD.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ImageTagMirrorSetList lists the items in the ImageTagMirrorSet CRD.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageTagMirrorSetSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageTagMirrorSetSpec.java
index f7ac325465c..f11923bccb2 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageTagMirrorSetSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageTagMirrorSetSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageTagMirrorSetSpec is the specification of the ImageTagMirrorSet CRD.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public ImageTagMirrorSetSpec(List<ImageTagMirrors> imageTagMirrors) {
         this.imageTagMirrors = imageTagMirrors;
     }
 
+    /**
+     * imageTagMirrors allows images referenced by image tags in pods to be pulled from alternative mirrored repository locations. The image pull specification provided to the pod will be compared to the source locations described in imageTagMirrors and the image may be pulled down from any of the mirrors in the list instead of the specified repository allowing administrators to choose a potentially faster mirror. To use mirrors to pull images using digest specification only, users should configure a list of mirrors using "ImageDigestMirrorSet" CRD.<br><p> <br><p> If the image pull specification matches the repository of "source" in multiple imagetagmirrorset objects, only the objects which define the most specific namespace match will be used. For example, if there are objects using quay.io/libpod and quay.io/libpod/busybox as the "source", only the objects using quay.io/libpod/busybox are going to apply for pull specification quay.io/libpod/busybox. Each "source" repository is treated independently; configurations for different "source" repositories don’t interact.<br><p> <br><p> If the "mirrors" is not specified, the image will continue to be pulled from the specified repository in the pull spec.<br><p> <br><p> When multiple policies are defined for the same "source" repository, the sets of defined mirrors will be merged together, preserving the relative order of the mirrors, if possible. For example, if policy A has mirrors `a, b, c` and policy B has mirrors `c, d, e`, the mirrors will be used in the order `a, b, c, d, e`.  If the orders of mirror entries conflict (e.g. `a, b` vs. `b, a`) the configuration is not rejected but the resulting order is unspecified. Users who want to use a deterministic order of mirrors, should configure them into one list of mirrors using the expected order.
+     */
     @JsonProperty("imageTagMirrors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ImageTagMirrors> getImageTagMirrors() {
         return imageTagMirrors;
     }
 
+    /**
+     * imageTagMirrors allows images referenced by image tags in pods to be pulled from alternative mirrored repository locations. The image pull specification provided to the pod will be compared to the source locations described in imageTagMirrors and the image may be pulled down from any of the mirrors in the list instead of the specified repository allowing administrators to choose a potentially faster mirror. To use mirrors to pull images using digest specification only, users should configure a list of mirrors using "ImageDigestMirrorSet" CRD.<br><p> <br><p> If the image pull specification matches the repository of "source" in multiple imagetagmirrorset objects, only the objects which define the most specific namespace match will be used. For example, if there are objects using quay.io/libpod and quay.io/libpod/busybox as the "source", only the objects using quay.io/libpod/busybox are going to apply for pull specification quay.io/libpod/busybox. Each "source" repository is treated independently; configurations for different "source" repositories don’t interact.<br><p> <br><p> If the "mirrors" is not specified, the image will continue to be pulled from the specified repository in the pull spec.<br><p> <br><p> When multiple policies are defined for the same "source" repository, the sets of defined mirrors will be merged together, preserving the relative order of the mirrors, if possible. For example, if policy A has mirrors `a, b, c` and policy B has mirrors `c, d, e`, the mirrors will be used in the order `a, b, c, d, e`.  If the orders of mirror entries conflict (e.g. `a, b` vs. `b, a`) the configuration is not rejected but the resulting order is unspecified. Users who want to use a deterministic order of mirrors, should configure them into one list of mirrors using the expected order.
+     */
     @JsonProperty("imageTagMirrors")
     public void setImageTagMirrors(List<ImageTagMirrors> imageTagMirrors) {
         this.imageTagMirrors = imageTagMirrors;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageTagMirrors.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageTagMirrors.java
index 1b57eeef854..d16e8f5765f 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageTagMirrors.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ImageTagMirrors.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageTagMirrors holds cluster-wide information about how to handle mirrors in the registries config.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public ImageTagMirrors(String mirrorSourcePolicy, List<String> mirrors, String s
         this.source = source;
     }
 
+    /**
+     * mirrorSourcePolicy defines the fallback policy if fails to pull image from the mirrors. If unset, the image will continue to be pulled from the repository in the pull spec. sourcePolicy is valid configuration only when one or more mirrors are in the mirror list.
+     */
     @JsonProperty("mirrorSourcePolicy")
     public String getMirrorSourcePolicy() {
         return mirrorSourcePolicy;
     }
 
+    /**
+     * mirrorSourcePolicy defines the fallback policy if fails to pull image from the mirrors. If unset, the image will continue to be pulled from the repository in the pull spec. sourcePolicy is valid configuration only when one or more mirrors are in the mirror list.
+     */
     @JsonProperty("mirrorSourcePolicy")
     public void setMirrorSourcePolicy(String mirrorSourcePolicy) {
         this.mirrorSourcePolicy = mirrorSourcePolicy;
     }
 
+    /**
+     * mirrors is zero or more locations that may also contain the same images. No mirror will be configured if not specified. Images can be pulled from these mirrors only if they are referenced by their tags. The mirrored location is obtained by replacing the part of the input reference that matches source by the mirrors entry, e.g. for registry.redhat.io/product/repo reference, a (source, mirror) pair &#42;.redhat.io, mirror.local/redhat causes a mirror.local/redhat/product/repo repository to be used. Pulling images by tag can potentially yield different images, depending on which endpoint we pull from. Configuring a list of mirrors using "ImageDigestMirrorSet" CRD and forcing digest-pulls for mirrors avoids that issue. The order of mirrors in this list is treated as the user's desired priority, while source is by default considered lower priority than all mirrors. If no mirror is specified or all image pulls from the mirror list fail, the image will continue to be pulled from the repository in the pull spec unless explicitly prohibited by "mirrorSourcePolicy". Other cluster configuration, including (but not limited to) other imageTagMirrors objects, may impact the exact order mirrors are contacted in, or some mirrors may be contacted in parallel, so this should be considered a preference rather than a guarantee of ordering. "mirrors" uses one of the following formats: host[:port] host[:port]/namespace[/namespace…] host[:port]/namespace[/namespace…]/repo for more information about the format, see the document about the location field: https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md#choosing-a-registry-toml-table
+     */
     @JsonProperty("mirrors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMirrors() {
         return mirrors;
     }
 
+    /**
+     * mirrors is zero or more locations that may also contain the same images. No mirror will be configured if not specified. Images can be pulled from these mirrors only if they are referenced by their tags. The mirrored location is obtained by replacing the part of the input reference that matches source by the mirrors entry, e.g. for registry.redhat.io/product/repo reference, a (source, mirror) pair &#42;.redhat.io, mirror.local/redhat causes a mirror.local/redhat/product/repo repository to be used. Pulling images by tag can potentially yield different images, depending on which endpoint we pull from. Configuring a list of mirrors using "ImageDigestMirrorSet" CRD and forcing digest-pulls for mirrors avoids that issue. The order of mirrors in this list is treated as the user's desired priority, while source is by default considered lower priority than all mirrors. If no mirror is specified or all image pulls from the mirror list fail, the image will continue to be pulled from the repository in the pull spec unless explicitly prohibited by "mirrorSourcePolicy". Other cluster configuration, including (but not limited to) other imageTagMirrors objects, may impact the exact order mirrors are contacted in, or some mirrors may be contacted in parallel, so this should be considered a preference rather than a guarantee of ordering. "mirrors" uses one of the following formats: host[:port] host[:port]/namespace[/namespace…] host[:port]/namespace[/namespace…]/repo for more information about the format, see the document about the location field: https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md#choosing-a-registry-toml-table
+     */
     @JsonProperty("mirrors")
     public void setMirrors(List<String> mirrors) {
         this.mirrors = mirrors;
     }
 
+    /**
+     * source matches the repository that users refer to, e.g. in image pull specifications. Setting source to a registry hostname e.g. docker.io. quay.io, or registry.redhat.io, will match the image pull specification of corressponding registry. "source" uses one of the following formats: host[:port] host[:port]/namespace[/namespace…] host[:port]/namespace[/namespace…]/repo [&#42;.]host for more information about the format, see the document about the location field: https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md#choosing-a-registry-toml-table
+     */
     @JsonProperty("source")
     public String getSource() {
         return source;
     }
 
+    /**
+     * source matches the repository that users refer to, e.g. in image pull specifications. Setting source to a registry hostname e.g. docker.io. quay.io, or registry.redhat.io, will match the image pull specification of corressponding registry. "source" uses one of the following formats: host[:port] host[:port]/namespace[/namespace…] host[:port]/namespace[/namespace…]/repo [&#42;.]host for more information about the format, see the document about the location field: https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md#choosing-a-registry-toml-table
+     */
     @JsonProperty("source")
     public void setSource(String source) {
         this.source = source;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Infrastructure.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Infrastructure.java
index ff9fa19c8bc..ca9193f14d1 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Infrastructure.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Infrastructure.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Infrastructure holds cluster-wide information about Infrastructure.  The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Infrastructure implements Editable<InfrastructureBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Infrastructure";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public Infrastructure(String apiVersion, String kind, ObjectMeta metadata, Infra
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Infrastructure holds cluster-wide information about Infrastructure.  The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Infrastructure holds cluster-wide information about Infrastructure.  The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Infrastructure holds cluster-wide information about Infrastructure.  The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public InfrastructureSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Infrastructure holds cluster-wide information about Infrastructure.  The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(InfrastructureSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Infrastructure holds cluster-wide information about Infrastructure.  The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public InfrastructureStatus getStatus() {
         return status;
     }
 
+    /**
+     * Infrastructure holds cluster-wide information about Infrastructure.  The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(InfrastructureStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/InfrastructureList.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/InfrastructureList.java
index 155d010f1c9..65ffa25a1e6 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/InfrastructureList.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/InfrastructureList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * InfrastructureList is<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class InfrastructureList implements Editable<InfrastructureListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.config.v1.Infrastructure>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.config.v1.Infrastructure> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "InfrastructureList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public InfrastructureList(String apiVersion, List<io.fabric8.openshift.api.model
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * InfrastructureList is<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.config.v1.Infrastructure> getItems() {
         return items;
     }
 
+    /**
+     * InfrastructureList is<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.config.v1.Infrastructure> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * InfrastructureList is<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * InfrastructureList is<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/InfrastructureSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/InfrastructureSpec.java
index 2dce9644a23..76010586dc8 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/InfrastructureSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/InfrastructureSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * InfrastructureSpec contains settings that apply to the cluster infrastructure.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public InfrastructureSpec(ConfigMapFileReference cloudConfig, PlatformSpec platf
         this.platformSpec = platformSpec;
     }
 
+    /**
+     * InfrastructureSpec contains settings that apply to the cluster infrastructure.
+     */
     @JsonProperty("cloudConfig")
     public ConfigMapFileReference getCloudConfig() {
         return cloudConfig;
     }
 
+    /**
+     * InfrastructureSpec contains settings that apply to the cluster infrastructure.
+     */
     @JsonProperty("cloudConfig")
     public void setCloudConfig(ConfigMapFileReference cloudConfig) {
         this.cloudConfig = cloudConfig;
     }
 
+    /**
+     * InfrastructureSpec contains settings that apply to the cluster infrastructure.
+     */
     @JsonProperty("platformSpec")
     public PlatformSpec getPlatformSpec() {
         return platformSpec;
     }
 
+    /**
+     * InfrastructureSpec contains settings that apply to the cluster infrastructure.
+     */
     @JsonProperty("platformSpec")
     public void setPlatformSpec(PlatformSpec platformSpec) {
         this.platformSpec = platformSpec;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/InfrastructureStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/InfrastructureStatus.java
index dfecaf71d04..3ed0a5d87d3 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/InfrastructureStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/InfrastructureStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * InfrastructureStatus describes the infrastructure the cluster is leveraging.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -110,91 +113,145 @@ public InfrastructureStatus(String apiServerInternalURI, String apiServerURL, St
         this.platformStatus = platformStatus;
     }
 
+    /**
+     * apiServerInternalURL is a valid URI with scheme 'https', address and optionally a port (defaulting to 443).  apiServerInternalURL can be used by components like kubelets, to contact the Kubernetes API server using the infrastructure provider rather than Kubernetes networking.
+     */
     @JsonProperty("apiServerInternalURI")
     public String getApiServerInternalURI() {
         return apiServerInternalURI;
     }
 
+    /**
+     * apiServerInternalURL is a valid URI with scheme 'https', address and optionally a port (defaulting to 443).  apiServerInternalURL can be used by components like kubelets, to contact the Kubernetes API server using the infrastructure provider rather than Kubernetes networking.
+     */
     @JsonProperty("apiServerInternalURI")
     public void setApiServerInternalURI(String apiServerInternalURI) {
         this.apiServerInternalURI = apiServerInternalURI;
     }
 
+    /**
+     * apiServerURL is a valid URI with scheme 'https', address and optionally a port (defaulting to 443).  apiServerURL can be used by components like the web console to tell users where to find the Kubernetes API.
+     */
     @JsonProperty("apiServerURL")
     public String getApiServerURL() {
         return apiServerURL;
     }
 
+    /**
+     * apiServerURL is a valid URI with scheme 'https', address and optionally a port (defaulting to 443).  apiServerURL can be used by components like the web console to tell users where to find the Kubernetes API.
+     */
     @JsonProperty("apiServerURL")
     public void setApiServerURL(String apiServerURL) {
         this.apiServerURL = apiServerURL;
     }
 
+    /**
+     * controlPlaneTopology expresses the expectations for operands that normally run on control nodes. The default is 'HighlyAvailable', which represents the behavior operators have in a "normal" cluster. The 'SingleReplica' mode will be used in single-node deployments and the operators should not configure the operand for highly-available operation The 'External' mode indicates that the control plane is hosted externally to the cluster and that its components are not visible within the cluster.
+     */
     @JsonProperty("controlPlaneTopology")
     public String getControlPlaneTopology() {
         return controlPlaneTopology;
     }
 
+    /**
+     * controlPlaneTopology expresses the expectations for operands that normally run on control nodes. The default is 'HighlyAvailable', which represents the behavior operators have in a "normal" cluster. The 'SingleReplica' mode will be used in single-node deployments and the operators should not configure the operand for highly-available operation The 'External' mode indicates that the control plane is hosted externally to the cluster and that its components are not visible within the cluster.
+     */
     @JsonProperty("controlPlaneTopology")
     public void setControlPlaneTopology(String controlPlaneTopology) {
         this.controlPlaneTopology = controlPlaneTopology;
     }
 
+    /**
+     * cpuPartitioning expresses if CPU partitioning is a currently enabled feature in the cluster. CPU Partitioning means that this cluster can support partitioning workloads to specific CPU Sets. Valid values are "None" and "AllNodes". When omitted, the default value is "None". The default value of "None" indicates that no nodes will be setup with CPU partitioning. The "AllNodes" value indicates that all nodes have been setup with CPU partitioning, and can then be further configured via the PerformanceProfile API.
+     */
     @JsonProperty("cpuPartitioning")
     public String getCpuPartitioning() {
         return cpuPartitioning;
     }
 
+    /**
+     * cpuPartitioning expresses if CPU partitioning is a currently enabled feature in the cluster. CPU Partitioning means that this cluster can support partitioning workloads to specific CPU Sets. Valid values are "None" and "AllNodes". When omitted, the default value is "None". The default value of "None" indicates that no nodes will be setup with CPU partitioning. The "AllNodes" value indicates that all nodes have been setup with CPU partitioning, and can then be further configured via the PerformanceProfile API.
+     */
     @JsonProperty("cpuPartitioning")
     public void setCpuPartitioning(String cpuPartitioning) {
         this.cpuPartitioning = cpuPartitioning;
     }
 
+    /**
+     * etcdDiscoveryDomain is the domain used to fetch the SRV records for discovering etcd servers and clients. For more info: https://github.com/etcd-io/etcd/blob/329be66e8b3f9e2e6af83c123ff89297e49ebd15/Documentation/op-guide/clustering.md#dns-discovery deprecated: as of 4.7, this field is no longer set or honored.  It will be removed in a future release.
+     */
     @JsonProperty("etcdDiscoveryDomain")
     public String getEtcdDiscoveryDomain() {
         return etcdDiscoveryDomain;
     }
 
+    /**
+     * etcdDiscoveryDomain is the domain used to fetch the SRV records for discovering etcd servers and clients. For more info: https://github.com/etcd-io/etcd/blob/329be66e8b3f9e2e6af83c123ff89297e49ebd15/Documentation/op-guide/clustering.md#dns-discovery deprecated: as of 4.7, this field is no longer set or honored.  It will be removed in a future release.
+     */
     @JsonProperty("etcdDiscoveryDomain")
     public void setEtcdDiscoveryDomain(String etcdDiscoveryDomain) {
         this.etcdDiscoveryDomain = etcdDiscoveryDomain;
     }
 
+    /**
+     * infrastructureName uniquely identifies a cluster with a human friendly name. Once set it should not be changed. Must be of max length 27 and must have only alphanumeric or hyphen characters.
+     */
     @JsonProperty("infrastructureName")
     public String getInfrastructureName() {
         return infrastructureName;
     }
 
+    /**
+     * infrastructureName uniquely identifies a cluster with a human friendly name. Once set it should not be changed. Must be of max length 27 and must have only alphanumeric or hyphen characters.
+     */
     @JsonProperty("infrastructureName")
     public void setInfrastructureName(String infrastructureName) {
         this.infrastructureName = infrastructureName;
     }
 
+    /**
+     * infrastructureTopology expresses the expectations for infrastructure services that do not run on control plane nodes, usually indicated by a node selector for a `role` value other than `master`. The default is 'HighlyAvailable', which represents the behavior operators have in a "normal" cluster. The 'SingleReplica' mode will be used in single-node deployments and the operators should not configure the operand for highly-available operation NOTE: External topology mode is not applicable for this field.
+     */
     @JsonProperty("infrastructureTopology")
     public String getInfrastructureTopology() {
         return infrastructureTopology;
     }
 
+    /**
+     * infrastructureTopology expresses the expectations for infrastructure services that do not run on control plane nodes, usually indicated by a node selector for a `role` value other than `master`. The default is 'HighlyAvailable', which represents the behavior operators have in a "normal" cluster. The 'SingleReplica' mode will be used in single-node deployments and the operators should not configure the operand for highly-available operation NOTE: External topology mode is not applicable for this field.
+     */
     @JsonProperty("infrastructureTopology")
     public void setInfrastructureTopology(String infrastructureTopology) {
         this.infrastructureTopology = infrastructureTopology;
     }
 
+    /**
+     * platform is the underlying infrastructure provider for the cluster.<br><p> <br><p> Deprecated: Use platformStatus.type instead.
+     */
     @JsonProperty("platform")
     public String getPlatform() {
         return platform;
     }
 
+    /**
+     * platform is the underlying infrastructure provider for the cluster.<br><p> <br><p> Deprecated: Use platformStatus.type instead.
+     */
     @JsonProperty("platform")
     public void setPlatform(String platform) {
         this.platform = platform;
     }
 
+    /**
+     * InfrastructureStatus describes the infrastructure the cluster is leveraging.
+     */
     @JsonProperty("platformStatus")
     public PlatformStatus getPlatformStatus() {
         return platformStatus;
     }
 
+    /**
+     * InfrastructureStatus describes the infrastructure the cluster is leveraging.
+     */
     @JsonProperty("platformStatus")
     public void setPlatformStatus(PlatformStatus platformStatus) {
         this.platformStatus = platformStatus;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Ingress.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Ingress.java
index b1b675a7865..2cabe39bc52 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Ingress.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Ingress.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Ingress holds cluster-wide information about ingress, including the default ingress domain used for routes. The canonical name is `cluster`.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Ingress implements Editable<IngressBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Ingress";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public Ingress(String apiVersion, String kind, ObjectMeta metadata, IngressSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Ingress holds cluster-wide information about ingress, including the default ingress domain used for routes. The canonical name is `cluster`.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Ingress holds cluster-wide information about ingress, including the default ingress domain used for routes. The canonical name is `cluster`.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Ingress holds cluster-wide information about ingress, including the default ingress domain used for routes. The canonical name is `cluster`.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public IngressSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Ingress holds cluster-wide information about ingress, including the default ingress domain used for routes. The canonical name is `cluster`.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(IngressSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Ingress holds cluster-wide information about ingress, including the default ingress domain used for routes. The canonical name is `cluster`.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public IngressStatus getStatus() {
         return status;
     }
 
+    /**
+     * Ingress holds cluster-wide information about ingress, including the default ingress domain used for routes. The canonical name is `cluster`.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(IngressStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IngressList.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IngressList.java
index 68255ffcf8b..0461df8e40e 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IngressList.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IngressList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class IngressList implements Editable<IngressListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.config.v1.Ingress>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.config.v1.Ingress> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "IngressList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public IngressList(String apiVersion, List<io.fabric8.openshift.api.model.config
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.config.v1.Ingress> getItems() {
         return items;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.config.v1.Ingress> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IngressPlatformSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IngressPlatformSpec.java
index e83b2bb7bde..560b5da1212 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IngressPlatformSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IngressPlatformSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressPlatformSpec holds the desired state of Ingress specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public IngressPlatformSpec(AWSIngressSpec aws, String type) {
         this.type = type;
     }
 
+    /**
+     * IngressPlatformSpec holds the desired state of Ingress specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("aws")
     public AWSIngressSpec getAws() {
         return aws;
     }
 
+    /**
+     * IngressPlatformSpec holds the desired state of Ingress specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("aws")
     public void setAws(AWSIngressSpec aws) {
         this.aws = aws;
     }
 
+    /**
+     * type is the underlying infrastructure provider for the cluster. Allowed values are "AWS", "Azure", "BareMetal", "GCP", "Libvirt", "OpenStack", "VSphere", "oVirt", "KubeVirt", "EquinixMetal", "PowerVS", "AlibabaCloud", "Nutanix" and "None". Individual components may not support all platforms, and must handle unrecognized platforms as None if they do not support that platform.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the underlying infrastructure provider for the cluster. Allowed values are "AWS", "Azure", "BareMetal", "GCP", "Libvirt", "OpenStack", "VSphere", "oVirt", "KubeVirt", "EquinixMetal", "PowerVS", "AlibabaCloud", "Nutanix" and "None". Individual components may not support all platforms, and must handle unrecognized platforms as None if they do not support that platform.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IngressSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IngressSpec.java
index 9c88d963da3..84a023cf0bb 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IngressSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IngressSpec.java
@@ -98,32 +98,50 @@ public IngressSpec(String appsDomain, List<ComponentRouteSpec> componentRoutes,
         this.requiredHSTSPolicies = requiredHSTSPolicies;
     }
 
+    /**
+     * appsDomain is an optional domain to use instead of the one specified in the domain field when a Route is created without specifying an explicit host. If appsDomain is nonempty, this value is used to generate default host values for Route. Unlike domain, appsDomain may be modified after installation. This assumes a new ingresscontroller has been setup with a wildcard certificate.
+     */
     @JsonProperty("appsDomain")
     public String getAppsDomain() {
         return appsDomain;
     }
 
+    /**
+     * appsDomain is an optional domain to use instead of the one specified in the domain field when a Route is created without specifying an explicit host. If appsDomain is nonempty, this value is used to generate default host values for Route. Unlike domain, appsDomain may be modified after installation. This assumes a new ingresscontroller has been setup with a wildcard certificate.
+     */
     @JsonProperty("appsDomain")
     public void setAppsDomain(String appsDomain) {
         this.appsDomain = appsDomain;
     }
 
+    /**
+     * componentRoutes is an optional list of routes that are managed by OpenShift components that a cluster-admin is able to configure the hostname and serving certificate for. The namespace and name of each route in this list should match an existing entry in the status.componentRoutes list.<br><p> <br><p> To determine the set of configurable Routes, look at namespace and name of entries in the .status.componentRoutes list, where participating operators write the status of configurable routes.
+     */
     @JsonProperty("componentRoutes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ComponentRouteSpec> getComponentRoutes() {
         return componentRoutes;
     }
 
+    /**
+     * componentRoutes is an optional list of routes that are managed by OpenShift components that a cluster-admin is able to configure the hostname and serving certificate for. The namespace and name of each route in this list should match an existing entry in the status.componentRoutes list.<br><p> <br><p> To determine the set of configurable Routes, look at namespace and name of entries in the .status.componentRoutes list, where participating operators write the status of configurable routes.
+     */
     @JsonProperty("componentRoutes")
     public void setComponentRoutes(List<ComponentRouteSpec> componentRoutes) {
         this.componentRoutes = componentRoutes;
     }
 
+    /**
+     * domain is used to generate a default host name for a route when the route's host name is empty. The generated host name will follow this pattern: "&lt;route-name&gt;.&lt;route-namespace&gt;.&lt;domain&gt;".<br><p> <br><p> It is also used as the default wildcard domain suffix for ingress. The default ingresscontroller domain will follow this pattern: "&#42;.&lt;domain&gt;".<br><p> <br><p> Once set, changing domain is not currently supported.
+     */
     @JsonProperty("domain")
     public String getDomain() {
         return domain;
     }
 
+    /**
+     * domain is used to generate a default host name for a route when the route's host name is empty. The generated host name will follow this pattern: "&lt;route-name&gt;.&lt;route-namespace&gt;.&lt;domain&gt;".<br><p> <br><p> It is also used as the default wildcard domain suffix for ingress. The default ingresscontroller domain will follow this pattern: "&#42;.&lt;domain&gt;".<br><p> <br><p> Once set, changing domain is not currently supported.
+     */
     @JsonProperty("domain")
     public void setDomain(String domain) {
         this.domain = domain;
@@ -139,12 +157,18 @@ public void setLoadBalancer(LoadBalancer loadBalancer) {
         this.loadBalancer = loadBalancer;
     }
 
+    /**
+     * requiredHSTSPolicies specifies HSTS policies that are required to be set on newly created  or updated routes matching the domainPattern/s and namespaceSelector/s that are specified in the policy. Each requiredHSTSPolicy must have at least a domainPattern and a maxAge to validate a route HSTS Policy route annotation, and affect route admission.<br><p> <br><p> A candidate route is checked for HSTS Policies if it has the HSTS Policy route annotation: "haproxy.router.openshift.io/hsts_header" E.g. haproxy.router.openshift.io/hsts_header: max-age=31536000;preload;includeSubDomains<br><p> <br><p> - For each candidate route, if it matches a requiredHSTSPolicy domainPattern and optional namespaceSelector, then the maxAge, preloadPolicy, and includeSubdomainsPolicy must be valid to be admitted.  Otherwise, the route is rejected. - The first match, by domainPattern and optional namespaceSelector, in the ordering of the RequiredHSTSPolicies determines the route's admission status. - If the candidate route doesn't match any requiredHSTSPolicy domainPattern and optional namespaceSelector, then it may use any HSTS Policy annotation.<br><p> <br><p> The HSTS policy configuration may be changed after routes have already been created. An update to a previously admitted route may then fail if the updated route does not conform to the updated HSTS policy configuration. However, changing the HSTS policy configuration will not cause a route that is already admitted to stop working.<br><p> <br><p> Note that if there are no RequiredHSTSPolicies, any HSTS Policy annotation on the route is valid.
+     */
     @JsonProperty("requiredHSTSPolicies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RequiredHSTSPolicy> getRequiredHSTSPolicies() {
         return requiredHSTSPolicies;
     }
 
+    /**
+     * requiredHSTSPolicies specifies HSTS policies that are required to be set on newly created  or updated routes matching the domainPattern/s and namespaceSelector/s that are specified in the policy. Each requiredHSTSPolicy must have at least a domainPattern and a maxAge to validate a route HSTS Policy route annotation, and affect route admission.<br><p> <br><p> A candidate route is checked for HSTS Policies if it has the HSTS Policy route annotation: "haproxy.router.openshift.io/hsts_header" E.g. haproxy.router.openshift.io/hsts_header: max-age=31536000;preload;includeSubDomains<br><p> <br><p> - For each candidate route, if it matches a requiredHSTSPolicy domainPattern and optional namespaceSelector, then the maxAge, preloadPolicy, and includeSubdomainsPolicy must be valid to be admitted.  Otherwise, the route is rejected. - The first match, by domainPattern and optional namespaceSelector, in the ordering of the RequiredHSTSPolicies determines the route's admission status. - If the candidate route doesn't match any requiredHSTSPolicy domainPattern and optional namespaceSelector, then it may use any HSTS Policy annotation.<br><p> <br><p> The HSTS policy configuration may be changed after routes have already been created. An update to a previously admitted route may then fail if the updated route does not conform to the updated HSTS policy configuration. However, changing the HSTS policy configuration will not cause a route that is already admitted to stop working.<br><p> <br><p> Note that if there are no RequiredHSTSPolicies, any HSTS Policy annotation on the route is valid.
+     */
     @JsonProperty("requiredHSTSPolicies")
     public void setRequiredHSTSPolicies(List<RequiredHSTSPolicy> requiredHSTSPolicies) {
         this.requiredHSTSPolicies = requiredHSTSPolicies;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IngressStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IngressStatus.java
index d8b550be7de..249871404bd 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IngressStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IngressStatus.java
@@ -85,22 +85,34 @@ public IngressStatus(List<ComponentRouteStatus> componentRoutes, String defaultP
         this.defaultPlacement = defaultPlacement;
     }
 
+    /**
+     * componentRoutes is where participating operators place the current route status for routes whose hostnames and serving certificates can be customized by the cluster-admin.
+     */
     @JsonProperty("componentRoutes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ComponentRouteStatus> getComponentRoutes() {
         return componentRoutes;
     }
 
+    /**
+     * componentRoutes is where participating operators place the current route status for routes whose hostnames and serving certificates can be customized by the cluster-admin.
+     */
     @JsonProperty("componentRoutes")
     public void setComponentRoutes(List<ComponentRouteStatus> componentRoutes) {
         this.componentRoutes = componentRoutes;
     }
 
+    /**
+     * defaultPlacement is set at installation time to control which nodes will host the ingress router pods by default. The options are control-plane nodes or worker nodes.<br><p> <br><p> This field works by dictating how the Cluster Ingress Operator will consider unset replicas and nodePlacement fields in IngressController resources when creating the corresponding Deployments.<br><p> <br><p> See the documentation for the IngressController replicas and nodePlacement fields for more information.<br><p> <br><p> When omitted, the default value is Workers
+     */
     @JsonProperty("defaultPlacement")
     public String getDefaultPlacement() {
         return defaultPlacement;
     }
 
+    /**
+     * defaultPlacement is set at installation time to control which nodes will host the ingress router pods by default. The options are control-plane nodes or worker nodes.<br><p> <br><p> This field works by dictating how the Cluster Ingress Operator will consider unset replicas and nodePlacement fields in IngressController resources when creating the corresponding Deployments.<br><p> <br><p> See the documentation for the IngressController replicas and nodePlacement fields for more information.<br><p> <br><p> When omitted, the default value is Workers
+     */
     @JsonProperty("defaultPlacement")
     public void setDefaultPlacement(String defaultPlacement) {
         this.defaultPlacement = defaultPlacement;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IntermediateTLSProfile.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IntermediateTLSProfile.java
index 5b48fe64328..c5fb107f00f 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IntermediateTLSProfile.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/IntermediateTLSProfile.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IntermediateTLSProfile is a TLS security profile based on: https://wiki.mozilla.org/Security/Server_Side_TLS#Intermediate_compatibility_.28default.29
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/KeystoneIdentityProvider.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/KeystoneIdentityProvider.java
index 5288de32dda..9720e1a399f 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/KeystoneIdentityProvider.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/KeystoneIdentityProvider.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KeystonePasswordIdentityProvider provides identities for users authenticating using keystone password credentials
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public KeystoneIdentityProvider(ConfigMapNameReference ca, String domainName, Se
         this.url = url;
     }
 
+    /**
+     * KeystonePasswordIdentityProvider provides identities for users authenticating using keystone password credentials
+     */
     @JsonProperty("ca")
     public ConfigMapNameReference getCa() {
         return ca;
     }
 
+    /**
+     * KeystonePasswordIdentityProvider provides identities for users authenticating using keystone password credentials
+     */
     @JsonProperty("ca")
     public void setCa(ConfigMapNameReference ca) {
         this.ca = ca;
     }
 
+    /**
+     * domainName is required for keystone v3
+     */
     @JsonProperty("domainName")
     public String getDomainName() {
         return domainName;
     }
 
+    /**
+     * domainName is required for keystone v3
+     */
     @JsonProperty("domainName")
     public void setDomainName(String domainName) {
         this.domainName = domainName;
     }
 
+    /**
+     * KeystonePasswordIdentityProvider provides identities for users authenticating using keystone password credentials
+     */
     @JsonProperty("tlsClientCert")
     public SecretNameReference getTlsClientCert() {
         return tlsClientCert;
     }
 
+    /**
+     * KeystonePasswordIdentityProvider provides identities for users authenticating using keystone password credentials
+     */
     @JsonProperty("tlsClientCert")
     public void setTlsClientCert(SecretNameReference tlsClientCert) {
         this.tlsClientCert = tlsClientCert;
     }
 
+    /**
+     * KeystonePasswordIdentityProvider provides identities for users authenticating using keystone password credentials
+     */
     @JsonProperty("tlsClientKey")
     public SecretNameReference getTlsClientKey() {
         return tlsClientKey;
     }
 
+    /**
+     * KeystonePasswordIdentityProvider provides identities for users authenticating using keystone password credentials
+     */
     @JsonProperty("tlsClientKey")
     public void setTlsClientKey(SecretNameReference tlsClientKey) {
         this.tlsClientKey = tlsClientKey;
     }
 
+    /**
+     * url is the remote URL to connect to
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * url is the remote URL to connect to
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/KubeClientConfig.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/KubeClientConfig.java
index a128a6c3844..81b2c7a4132 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/KubeClientConfig.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/KubeClientConfig.java
@@ -92,11 +92,17 @@ public void setConnectionOverrides(ClientConnectionOverrides connectionOverrides
         this.connectionOverrides = connectionOverrides;
     }
 
+    /**
+     * kubeConfig is a .kubeconfig filename for going to the owning kube-apiserver.  Empty uses an in-cluster-config
+     */
     @JsonProperty("kubeConfig")
     public String getKubeConfig() {
         return kubeConfig;
     }
 
+    /**
+     * kubeConfig is a .kubeconfig filename for going to the owning kube-apiserver.  Empty uses an in-cluster-config
+     */
     @JsonProperty("kubeConfig")
     public void setKubeConfig(String kubeConfig) {
         this.kubeConfig = kubeConfig;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/KubevirtPlatformSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/KubevirtPlatformSpec.java
index 584bc1c1ed5..2b5311b11b3 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/KubevirtPlatformSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/KubevirtPlatformSpec.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KubevirtPlatformSpec holds the desired state of the kubevirt infrastructure provider. This only includes fields that can be modified in the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/KubevirtPlatformStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/KubevirtPlatformStatus.java
index 65a30268057..9120f855a50 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/KubevirtPlatformStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/KubevirtPlatformStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KubevirtPlatformStatus holds the current status of the kubevirt infrastructure provider.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public KubevirtPlatformStatus(String apiServerInternalIP, String ingressIP) {
         this.ingressIP = ingressIP;
     }
 
+    /**
+     * apiServerInternalIP is an IP address to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. It is the IP that the Infrastructure.status.apiServerInternalURI points to. It is the IP for a self-hosted load balancer in front of the API servers.
+     */
     @JsonProperty("apiServerInternalIP")
     public String getApiServerInternalIP() {
         return apiServerInternalIP;
     }
 
+    /**
+     * apiServerInternalIP is an IP address to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. It is the IP that the Infrastructure.status.apiServerInternalURI points to. It is the IP for a self-hosted load balancer in front of the API servers.
+     */
     @JsonProperty("apiServerInternalIP")
     public void setApiServerInternalIP(String apiServerInternalIP) {
         this.apiServerInternalIP = apiServerInternalIP;
     }
 
+    /**
+     * ingressIP is an external IP which routes to the default ingress controller. The IP is a suitable target of a wildcard DNS record used to resolve default route host names.
+     */
     @JsonProperty("ingressIP")
     public String getIngressIP() {
         return ingressIP;
     }
 
+    /**
+     * ingressIP is an external IP which routes to the default ingress controller. The IP is a suitable target of a wildcard DNS record used to resolve default route host names.
+     */
     @JsonProperty("ingressIP")
     public void setIngressIP(String ingressIP) {
         this.ingressIP = ingressIP;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/LDAPAttributeMapping.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/LDAPAttributeMapping.java
index 19ec285bd93..0ba32817b17 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/LDAPAttributeMapping.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/LDAPAttributeMapping.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LDAPAttributeMapping maps LDAP attributes to OpenShift identity fields
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -96,45 +99,69 @@ public LDAPAttributeMapping(List<String> email, List<String> id, List<String> na
         this.preferredUsername = preferredUsername;
     }
 
+    /**
+     * email is the list of attributes whose values should be used as the email address. Optional. If unspecified, no email is set for the identity
+     */
     @JsonProperty("email")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEmail() {
         return email;
     }
 
+    /**
+     * email is the list of attributes whose values should be used as the email address. Optional. If unspecified, no email is set for the identity
+     */
     @JsonProperty("email")
     public void setEmail(List<String> email) {
         this.email = email;
     }
 
+    /**
+     * id is the list of attributes whose values should be used as the user ID. Required. First non-empty attribute is used. At least one attribute is required. If none of the listed attribute have a value, authentication fails. LDAP standard identity attribute is "dn"
+     */
     @JsonProperty("id")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getId() {
         return id;
     }
 
+    /**
+     * id is the list of attributes whose values should be used as the user ID. Required. First non-empty attribute is used. At least one attribute is required. If none of the listed attribute have a value, authentication fails. LDAP standard identity attribute is "dn"
+     */
     @JsonProperty("id")
     public void setId(List<String> id) {
         this.id = id;
     }
 
+    /**
+     * name is the list of attributes whose values should be used as the display name. Optional. If unspecified, no display name is set for the identity LDAP standard display name attribute is "cn"
+     */
     @JsonProperty("name")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getName() {
         return name;
     }
 
+    /**
+     * name is the list of attributes whose values should be used as the display name. Optional. If unspecified, no display name is set for the identity LDAP standard display name attribute is "cn"
+     */
     @JsonProperty("name")
     public void setName(List<String> name) {
         this.name = name;
     }
 
+    /**
+     * preferredUsername is the list of attributes whose values should be used as the preferred username. LDAP standard login attribute is "uid"
+     */
     @JsonProperty("preferredUsername")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPreferredUsername() {
         return preferredUsername;
     }
 
+    /**
+     * preferredUsername is the list of attributes whose values should be used as the preferred username. LDAP standard login attribute is "uid"
+     */
     @JsonProperty("preferredUsername")
     public void setPreferredUsername(List<String> preferredUsername) {
         this.preferredUsername = preferredUsername;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/LDAPIdentityProvider.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/LDAPIdentityProvider.java
index 9f3139df4a6..eb321659b6a 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/LDAPIdentityProvider.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/LDAPIdentityProvider.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LDAPPasswordIdentityProvider provides identities for users authenticating using LDAP credentials
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public LDAPIdentityProvider(LDAPAttributeMapping attributes, String bindDN, Secr
         this.url = url;
     }
 
+    /**
+     * LDAPPasswordIdentityProvider provides identities for users authenticating using LDAP credentials
+     */
     @JsonProperty("attributes")
     public LDAPAttributeMapping getAttributes() {
         return attributes;
     }
 
+    /**
+     * LDAPPasswordIdentityProvider provides identities for users authenticating using LDAP credentials
+     */
     @JsonProperty("attributes")
     public void setAttributes(LDAPAttributeMapping attributes) {
         this.attributes = attributes;
     }
 
+    /**
+     * bindDN is an optional DN to bind with during the search phase.
+     */
     @JsonProperty("bindDN")
     public String getBindDN() {
         return bindDN;
     }
 
+    /**
+     * bindDN is an optional DN to bind with during the search phase.
+     */
     @JsonProperty("bindDN")
     public void setBindDN(String bindDN) {
         this.bindDN = bindDN;
     }
 
+    /**
+     * LDAPPasswordIdentityProvider provides identities for users authenticating using LDAP credentials
+     */
     @JsonProperty("bindPassword")
     public SecretNameReference getBindPassword() {
         return bindPassword;
     }
 
+    /**
+     * LDAPPasswordIdentityProvider provides identities for users authenticating using LDAP credentials
+     */
     @JsonProperty("bindPassword")
     public void setBindPassword(SecretNameReference bindPassword) {
         this.bindPassword = bindPassword;
     }
 
+    /**
+     * LDAPPasswordIdentityProvider provides identities for users authenticating using LDAP credentials
+     */
     @JsonProperty("ca")
     public ConfigMapNameReference getCa() {
         return ca;
     }
 
+    /**
+     * LDAPPasswordIdentityProvider provides identities for users authenticating using LDAP credentials
+     */
     @JsonProperty("ca")
     public void setCa(ConfigMapNameReference ca) {
         this.ca = ca;
     }
 
+    /**
+     * insecure, if true, indicates the connection should not use TLS WARNING: Should not be set to `true` with the URL scheme "ldaps://" as "ldaps://" URLs always<br><p>          attempt to connect using TLS, even when `insecure` is set to `true`<br><p> When `true`, "ldap://" URLS connect insecurely. When `false`, "ldap://" URLs are upgraded to a TLS connection using StartTLS as specified in https://tools.ietf.org/html/rfc2830.
+     */
     @JsonProperty("insecure")
     public Boolean getInsecure() {
         return insecure;
     }
 
+    /**
+     * insecure, if true, indicates the connection should not use TLS WARNING: Should not be set to `true` with the URL scheme "ldaps://" as "ldaps://" URLs always<br><p>          attempt to connect using TLS, even when `insecure` is set to `true`<br><p> When `true`, "ldap://" URLS connect insecurely. When `false`, "ldap://" URLs are upgraded to a TLS connection using StartTLS as specified in https://tools.ietf.org/html/rfc2830.
+     */
     @JsonProperty("insecure")
     public void setInsecure(Boolean insecure) {
         this.insecure = insecure;
     }
 
+    /**
+     * url is an RFC 2255 URL which specifies the LDAP search parameters to use. The syntax of the URL is: ldap://host:port/basedn?attribute?scope?filter
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * url is an RFC 2255 URL which specifies the LDAP search parameters to use. The syntax of the URL is: ldap://host:port/basedn?attribute?scope?filter
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/LeaderElection.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/LeaderElection.java
index 2b55b6eb10c..bb3a4d7d078 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/LeaderElection.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/LeaderElection.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LeaderElection provides information to elect a leader
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public LeaderElection(Boolean disable, String leaseDuration, String name, String
         this.retryPeriod = retryPeriod;
     }
 
+    /**
+     * disable allows leader election to be suspended while allowing a fully defaulted "normal" startup case.
+     */
     @JsonProperty("disable")
     public Boolean getDisable() {
         return disable;
     }
 
+    /**
+     * disable allows leader election to be suspended while allowing a fully defaulted "normal" startup case.
+     */
     @JsonProperty("disable")
     public void setDisable(Boolean disable) {
         this.disable = disable;
     }
 
+    /**
+     * LeaderElection provides information to elect a leader
+     */
     @JsonProperty("leaseDuration")
     public String getLeaseDuration() {
         return leaseDuration;
     }
 
+    /**
+     * LeaderElection provides information to elect a leader
+     */
     @JsonProperty("leaseDuration")
     public void setLeaseDuration(String leaseDuration) {
         this.leaseDuration = leaseDuration;
     }
 
+    /**
+     * name indicates what name to use for the resource
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name indicates what name to use for the resource
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * namespace indicates which namespace the resource is in
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * namespace indicates which namespace the resource is in
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * LeaderElection provides information to elect a leader
+     */
     @JsonProperty("renewDeadline")
     public String getRenewDeadline() {
         return renewDeadline;
     }
 
+    /**
+     * LeaderElection provides information to elect a leader
+     */
     @JsonProperty("renewDeadline")
     public void setRenewDeadline(String renewDeadline) {
         this.renewDeadline = renewDeadline;
     }
 
+    /**
+     * LeaderElection provides information to elect a leader
+     */
     @JsonProperty("retryPeriod")
     public String getRetryPeriod() {
         return retryPeriod;
     }
 
+    /**
+     * LeaderElection provides information to elect a leader
+     */
     @JsonProperty("retryPeriod")
     public void setRetryPeriod(String retryPeriod) {
         this.retryPeriod = retryPeriod;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/MTUMigration.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/MTUMigration.java
index c49cf8f48f1..fb99ae8eb53 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/MTUMigration.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/MTUMigration.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MTUMigration contains infomation about MTU migration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public MTUMigration(MTUMigrationValues machine, MTUMigrationValues network) {
         this.network = network;
     }
 
+    /**
+     * MTUMigration contains infomation about MTU migration.
+     */
     @JsonProperty("machine")
     public MTUMigrationValues getMachine() {
         return machine;
     }
 
+    /**
+     * MTUMigration contains infomation about MTU migration.
+     */
     @JsonProperty("machine")
     public void setMachine(MTUMigrationValues machine) {
         this.machine = machine;
     }
 
+    /**
+     * MTUMigration contains infomation about MTU migration.
+     */
     @JsonProperty("network")
     public MTUMigrationValues getNetwork() {
         return network;
     }
 
+    /**
+     * MTUMigration contains infomation about MTU migration.
+     */
     @JsonProperty("network")
     public void setNetwork(MTUMigrationValues network) {
         this.network = network;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/MTUMigrationValues.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/MTUMigrationValues.java
index 3956f205041..cd50c56b326 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/MTUMigrationValues.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/MTUMigrationValues.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MTUMigrationValues contains the values for a MTU migration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public MTUMigrationValues(Long from, Long to) {
         this.to = to;
     }
 
+    /**
+     * From is the MTU to migrate from.
+     */
     @JsonProperty("from")
     public Long getFrom() {
         return from;
     }
 
+    /**
+     * From is the MTU to migrate from.
+     */
     @JsonProperty("from")
     public void setFrom(Long from) {
         this.from = from;
     }
 
+    /**
+     * To is the MTU to migrate to.
+     */
     @JsonProperty("to")
     public Long getTo() {
         return to;
     }
 
+    /**
+     * To is the MTU to migrate to.
+     */
     @JsonProperty("to")
     public void setTo(Long to) {
         this.to = to;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/MaxAgePolicy.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/MaxAgePolicy.java
index d025c1f52e4..c6badb78e07 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/MaxAgePolicy.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/MaxAgePolicy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MaxAgePolicy contains a numeric range for specifying a compliant HSTS max-age for the enclosing RequiredHSTSPolicy
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public MaxAgePolicy(Integer largestMaxAge, Integer smallestMaxAge) {
         this.smallestMaxAge = smallestMaxAge;
     }
 
+    /**
+     * The largest allowed value (in seconds) of the RequiredHSTSPolicy max-age This value can be left unspecified, in which case no upper limit is enforced.
+     */
     @JsonProperty("largestMaxAge")
     public Integer getLargestMaxAge() {
         return largestMaxAge;
     }
 
+    /**
+     * The largest allowed value (in seconds) of the RequiredHSTSPolicy max-age This value can be left unspecified, in which case no upper limit is enforced.
+     */
     @JsonProperty("largestMaxAge")
     public void setLargestMaxAge(Integer largestMaxAge) {
         this.largestMaxAge = largestMaxAge;
     }
 
+    /**
+     * The smallest allowed value (in seconds) of the RequiredHSTSPolicy max-age Setting max-age=0 allows the deletion of an existing HSTS header from a host.  This is a necessary tool for administrators to quickly correct mistakes. This value can be left unspecified, in which case no lower limit is enforced.
+     */
     @JsonProperty("smallestMaxAge")
     public Integer getSmallestMaxAge() {
         return smallestMaxAge;
     }
 
+    /**
+     * The smallest allowed value (in seconds) of the RequiredHSTSPolicy max-age Setting max-age=0 allows the deletion of an existing HSTS header from a host.  This is a necessary tool for administrators to quickly correct mistakes. This value can be left unspecified, in which case no lower limit is enforced.
+     */
     @JsonProperty("smallestMaxAge")
     public void setSmallestMaxAge(Integer smallestMaxAge) {
         this.smallestMaxAge = smallestMaxAge;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ModernTLSProfile.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ModernTLSProfile.java
index c99667bf3f2..b409bccf6f2 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ModernTLSProfile.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ModernTLSProfile.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ModernTLSProfile is a TLS security profile based on: https://wiki.mozilla.org/Security/Server_Side_TLS#Modern_compatibility
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NamedCertificate.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NamedCertificate.java
index 0b1ccc35fee..fb9fe32c3eb 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NamedCertificate.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NamedCertificate.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NamedCertificate specifies a certificate/key, and the names it should be served for
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public NamedCertificate(String certFile, String keyFile, List<String> names) {
         this.names = names;
     }
 
+    /**
+     * CertFile is a file containing a PEM-encoded certificate
+     */
     @JsonProperty("certFile")
     public String getCertFile() {
         return certFile;
     }
 
+    /**
+     * CertFile is a file containing a PEM-encoded certificate
+     */
     @JsonProperty("certFile")
     public void setCertFile(String certFile) {
         this.certFile = certFile;
     }
 
+    /**
+     * KeyFile is a file containing a PEM-encoded private key for the certificate specified by CertFile
+     */
     @JsonProperty("keyFile")
     public String getKeyFile() {
         return keyFile;
     }
 
+    /**
+     * KeyFile is a file containing a PEM-encoded private key for the certificate specified by CertFile
+     */
     @JsonProperty("keyFile")
     public void setKeyFile(String keyFile) {
         this.keyFile = keyFile;
     }
 
+    /**
+     * Names is a list of DNS names this certificate should be used to secure A name can be a normal DNS name, or can contain leading wildcard segments.
+     */
     @JsonProperty("names")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNames() {
         return names;
     }
 
+    /**
+     * Names is a list of DNS names this certificate should be used to secure A name can be a normal DNS name, or can contain leading wildcard segments.
+     */
     @JsonProperty("names")
     public void setNames(List<String> names) {
         this.names = names;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Network.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Network.java
index 32d742a6c2e..e6a04d49fff 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Network.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Network.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Network holds cluster-wide information about Network. The canonical name is `cluster`. It is used to configure the desired network configuration, such as: IP address pools for services/pod IPs, network plugin, etc. Please view network.spec for an explanation on what applies when configuring this resource.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Network implements Editable<NetworkBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Network";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public Network(String apiVersion, String kind, ObjectMeta metadata, NetworkSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Network holds cluster-wide information about Network. The canonical name is `cluster`. It is used to configure the desired network configuration, such as: IP address pools for services/pod IPs, network plugin, etc. Please view network.spec for an explanation on what applies when configuring this resource.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Network holds cluster-wide information about Network. The canonical name is `cluster`. It is used to configure the desired network configuration, such as: IP address pools for services/pod IPs, network plugin, etc. Please view network.spec for an explanation on what applies when configuring this resource.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Network holds cluster-wide information about Network. The canonical name is `cluster`. It is used to configure the desired network configuration, such as: IP address pools for services/pod IPs, network plugin, etc. Please view network.spec for an explanation on what applies when configuring this resource.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public NetworkSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Network holds cluster-wide information about Network. The canonical name is `cluster`. It is used to configure the desired network configuration, such as: IP address pools for services/pod IPs, network plugin, etc. Please view network.spec for an explanation on what applies when configuring this resource.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(NetworkSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Network holds cluster-wide information about Network. The canonical name is `cluster`. It is used to configure the desired network configuration, such as: IP address pools for services/pod IPs, network plugin, etc. Please view network.spec for an explanation on what applies when configuring this resource.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public NetworkStatus getStatus() {
         return status;
     }
 
+    /**
+     * Network holds cluster-wide information about Network. The canonical name is `cluster`. It is used to configure the desired network configuration, such as: IP address pools for services/pod IPs, network plugin, etc. Please view network.spec for an explanation on what applies when configuring this resource.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(NetworkStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NetworkDiagnostics.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NetworkDiagnostics.java
index 35c7e8ccef5..7eeb7cf8d2a 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NetworkDiagnostics.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NetworkDiagnostics.java
@@ -86,11 +86,17 @@ public NetworkDiagnostics(String mode, NetworkDiagnosticsSourcePlacement sourceP
         this.targetPlacement = targetPlacement;
     }
 
+    /**
+     * mode controls the network diagnostics mode<br><p> <br><p> When omitted, this means the user has no opinion and the platform is left to choose reasonable defaults. These defaults are subject to change over time. The current default is All.
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * mode controls the network diagnostics mode<br><p> <br><p> When omitted, this means the user has no opinion and the platform is left to choose reasonable defaults. These defaults are subject to change over time. The current default is All.
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NetworkDiagnosticsSourcePlacement.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NetworkDiagnosticsSourcePlacement.java
index d9e06e5c5f7..84ecbc0f57b 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NetworkDiagnosticsSourcePlacement.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NetworkDiagnosticsSourcePlacement.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkDiagnosticsSourcePlacement defines node scheduling configuration network diagnostics source components
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,23 +90,35 @@ public NetworkDiagnosticsSourcePlacement(Map<String, String> nodeSelector, List<
         this.tolerations = tolerations;
     }
 
+    /**
+     * nodeSelector is the node selector applied to network diagnostics components<br><p> <br><p> When omitted, this means the user has no opinion and the platform is left to choose reasonable defaults. These defaults are subject to change over time. The current default is `kubernetes.io/os: linux`.
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * nodeSelector is the node selector applied to network diagnostics components<br><p> <br><p> When omitted, this means the user has no opinion and the platform is left to choose reasonable defaults. These defaults are subject to change over time. The current default is `kubernetes.io/os: linux`.
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * tolerations is a list of tolerations applied to network diagnostics components<br><p> <br><p> When omitted, this means the user has no opinion and the platform is left to choose reasonable defaults. These defaults are subject to change over time. The current default is an empty list.
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * tolerations is a list of tolerations applied to network diagnostics components<br><p> <br><p> When omitted, this means the user has no opinion and the platform is left to choose reasonable defaults. These defaults are subject to change over time. The current default is an empty list.
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NetworkDiagnosticsTargetPlacement.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NetworkDiagnosticsTargetPlacement.java
index f3db909fde0..51b8ed64faf 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NetworkDiagnosticsTargetPlacement.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NetworkDiagnosticsTargetPlacement.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkDiagnosticsTargetPlacement defines node scheduling configuration network diagnostics target components
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,23 +90,35 @@ public NetworkDiagnosticsTargetPlacement(Map<String, String> nodeSelector, List<
         this.tolerations = tolerations;
     }
 
+    /**
+     * nodeSelector is the node selector applied to network diagnostics components<br><p> <br><p> When omitted, this means the user has no opinion and the platform is left to choose reasonable defaults. These defaults are subject to change over time. The current default is `kubernetes.io/os: linux`.
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * nodeSelector is the node selector applied to network diagnostics components<br><p> <br><p> When omitted, this means the user has no opinion and the platform is left to choose reasonable defaults. These defaults are subject to change over time. The current default is `kubernetes.io/os: linux`.
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * tolerations is a list of tolerations applied to network diagnostics components<br><p> <br><p> When omitted, this means the user has no opinion and the platform is left to choose reasonable defaults. These defaults are subject to change over time. The current default is `- operator: "Exists"` which means that all taints are tolerated.
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * tolerations is a list of tolerations applied to network diagnostics components<br><p> <br><p> When omitted, this means the user has no opinion and the platform is left to choose reasonable defaults. These defaults are subject to change over time. The current default is `- operator: "Exists"` which means that all taints are tolerated.
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NetworkList.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NetworkList.java
index 2ff02782d39..019d0ac682f 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NetworkList.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NetworkList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class NetworkList implements Editable<NetworkListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.config.v1.Network>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.config.v1.Network> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "NetworkList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public NetworkList(String apiVersion, List<io.fabric8.openshift.api.model.config
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.config.v1.Network> getItems() {
         return items;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.config.v1.Network> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NetworkMigration.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NetworkMigration.java
index ba1a6e16fa5..37e377fadbe 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NetworkMigration.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NetworkMigration.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkMigration represents the network migration status.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public NetworkMigration(MTUMigration mtu, String networkType) {
         this.networkType = networkType;
     }
 
+    /**
+     * NetworkMigration represents the network migration status.
+     */
     @JsonProperty("mtu")
     public MTUMigration getMtu() {
         return mtu;
     }
 
+    /**
+     * NetworkMigration represents the network migration status.
+     */
     @JsonProperty("mtu")
     public void setMtu(MTUMigration mtu) {
         this.mtu = mtu;
     }
 
+    /**
+     * NetworkType is the target plugin that is being deployed. DEPRECATED: network type migration is no longer supported, so this should always be unset.
+     */
     @JsonProperty("networkType")
     public String getNetworkType() {
         return networkType;
     }
 
+    /**
+     * NetworkType is the target plugin that is being deployed. DEPRECATED: network type migration is no longer supported, so this should always be unset.
+     */
     @JsonProperty("networkType")
     public void setNetworkType(String networkType) {
         this.networkType = networkType;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NetworkSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NetworkSpec.java
index 41db20e4cba..33f75265cc0 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NetworkSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NetworkSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkSpec is the desired network configuration. As a general rule, this SHOULD NOT be read directly. Instead, you should consume the NetworkStatus, as it indicates the currently deployed configuration. Currently, most spec fields are immutable after installation. Please view the individual ones for further details on each.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,63 +105,99 @@ public NetworkSpec(List<ClusterNetworkEntry> clusterNetwork, ExternalIPConfig ex
         this.serviceNodePortRange = serviceNodePortRange;
     }
 
+    /**
+     * IP address pool to use for pod IPs. This field is immutable after installation.
+     */
     @JsonProperty("clusterNetwork")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ClusterNetworkEntry> getClusterNetwork() {
         return clusterNetwork;
     }
 
+    /**
+     * IP address pool to use for pod IPs. This field is immutable after installation.
+     */
     @JsonProperty("clusterNetwork")
     public void setClusterNetwork(List<ClusterNetworkEntry> clusterNetwork) {
         this.clusterNetwork = clusterNetwork;
     }
 
+    /**
+     * NetworkSpec is the desired network configuration. As a general rule, this SHOULD NOT be read directly. Instead, you should consume the NetworkStatus, as it indicates the currently deployed configuration. Currently, most spec fields are immutable after installation. Please view the individual ones for further details on each.
+     */
     @JsonProperty("externalIP")
     public ExternalIPConfig getExternalIP() {
         return externalIP;
     }
 
+    /**
+     * NetworkSpec is the desired network configuration. As a general rule, this SHOULD NOT be read directly. Instead, you should consume the NetworkStatus, as it indicates the currently deployed configuration. Currently, most spec fields are immutable after installation. Please view the individual ones for further details on each.
+     */
     @JsonProperty("externalIP")
     public void setExternalIP(ExternalIPConfig externalIP) {
         this.externalIP = externalIP;
     }
 
+    /**
+     * NetworkSpec is the desired network configuration. As a general rule, this SHOULD NOT be read directly. Instead, you should consume the NetworkStatus, as it indicates the currently deployed configuration. Currently, most spec fields are immutable after installation. Please view the individual ones for further details on each.
+     */
     @JsonProperty("networkDiagnostics")
     public NetworkDiagnostics getNetworkDiagnostics() {
         return networkDiagnostics;
     }
 
+    /**
+     * NetworkSpec is the desired network configuration. As a general rule, this SHOULD NOT be read directly. Instead, you should consume the NetworkStatus, as it indicates the currently deployed configuration. Currently, most spec fields are immutable after installation. Please view the individual ones for further details on each.
+     */
     @JsonProperty("networkDiagnostics")
     public void setNetworkDiagnostics(NetworkDiagnostics networkDiagnostics) {
         this.networkDiagnostics = networkDiagnostics;
     }
 
+    /**
+     * NetworkType is the plugin that is to be deployed (e.g. OVNKubernetes). This should match a value that the cluster-network-operator understands, or else no networking will be installed. Currently supported values are: - OVNKubernetes This field is immutable after installation.
+     */
     @JsonProperty("networkType")
     public String getNetworkType() {
         return networkType;
     }
 
+    /**
+     * NetworkType is the plugin that is to be deployed (e.g. OVNKubernetes). This should match a value that the cluster-network-operator understands, or else no networking will be installed. Currently supported values are: - OVNKubernetes This field is immutable after installation.
+     */
     @JsonProperty("networkType")
     public void setNetworkType(String networkType) {
         this.networkType = networkType;
     }
 
+    /**
+     * IP address pool for services. Currently, we only support a single entry here. This field is immutable after installation.
+     */
     @JsonProperty("serviceNetwork")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getServiceNetwork() {
         return serviceNetwork;
     }
 
+    /**
+     * IP address pool for services. Currently, we only support a single entry here. This field is immutable after installation.
+     */
     @JsonProperty("serviceNetwork")
     public void setServiceNetwork(List<String> serviceNetwork) {
         this.serviceNetwork = serviceNetwork;
     }
 
+    /**
+     * The port range allowed for Services of type NodePort. If not specified, the default of 30000-32767 will be used. Such Services without a NodePort specified will have one automatically allocated from this range. This parameter can be updated after the cluster is installed.
+     */
     @JsonProperty("serviceNodePortRange")
     public String getServiceNodePortRange() {
         return serviceNodePortRange;
     }
 
+    /**
+     * The port range allowed for Services of type NodePort. If not specified, the default of 30000-32767 will be used. Such Services without a NodePort specified will have one automatically allocated from this range. This parameter can be updated after the cluster is installed.
+     */
     @JsonProperty("serviceNodePortRange")
     public void setServiceNodePortRange(String serviceNodePortRange) {
         this.serviceNodePortRange = serviceNodePortRange;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NetworkStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NetworkStatus.java
index d01a0c43c96..e0214ee95ca 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NetworkStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NetworkStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkStatus is the current network configuration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -104,64 +107,100 @@ public NetworkStatus(List<ClusterNetworkEntry> clusterNetwork, Integer clusterNe
         this.serviceNetwork = serviceNetwork;
     }
 
+    /**
+     * IP address pool to use for pod IPs.
+     */
     @JsonProperty("clusterNetwork")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ClusterNetworkEntry> getClusterNetwork() {
         return clusterNetwork;
     }
 
+    /**
+     * IP address pool to use for pod IPs.
+     */
     @JsonProperty("clusterNetwork")
     public void setClusterNetwork(List<ClusterNetworkEntry> clusterNetwork) {
         this.clusterNetwork = clusterNetwork;
     }
 
+    /**
+     * ClusterNetworkMTU is the MTU for inter-pod networking.
+     */
     @JsonProperty("clusterNetworkMTU")
     public Integer getClusterNetworkMTU() {
         return clusterNetworkMTU;
     }
 
+    /**
+     * ClusterNetworkMTU is the MTU for inter-pod networking.
+     */
     @JsonProperty("clusterNetworkMTU")
     public void setClusterNetworkMTU(Integer clusterNetworkMTU) {
         this.clusterNetworkMTU = clusterNetworkMTU;
     }
 
+    /**
+     * conditions represents the observations of a network.config current state. Known .status.conditions.type are: "NetworkDiagnosticsAvailable"
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions represents the observations of a network.config current state. Known .status.conditions.type are: "NetworkDiagnosticsAvailable"
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * NetworkStatus is the current network configuration.
+     */
     @JsonProperty("migration")
     public NetworkMigration getMigration() {
         return migration;
     }
 
+    /**
+     * NetworkStatus is the current network configuration.
+     */
     @JsonProperty("migration")
     public void setMigration(NetworkMigration migration) {
         this.migration = migration;
     }
 
+    /**
+     * NetworkType is the plugin that is deployed (e.g. OVNKubernetes).
+     */
     @JsonProperty("networkType")
     public String getNetworkType() {
         return networkType;
     }
 
+    /**
+     * NetworkType is the plugin that is deployed (e.g. OVNKubernetes).
+     */
     @JsonProperty("networkType")
     public void setNetworkType(String networkType) {
         this.networkType = networkType;
     }
 
+    /**
+     * IP address pool for services. Currently, we only support a single entry here.
+     */
     @JsonProperty("serviceNetwork")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getServiceNetwork() {
         return serviceNetwork;
     }
 
+    /**
+     * IP address pool for services. Currently, we only support a single entry here.
+     */
     @JsonProperty("serviceNetwork")
     public void setServiceNetwork(List<String> serviceNetwork) {
         this.serviceNetwork = serviceNetwork;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Node.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Node.java
index 326277d7446..7ad4529a65d 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Node.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Node.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Node holds cluster-wide information about node specific features.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Node implements Editable<NodeBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Node";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public Node(String apiVersion, String kind, ObjectMeta metadata, NodeSpec spec,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Node holds cluster-wide information about node specific features.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Node holds cluster-wide information about node specific features.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Node holds cluster-wide information about node specific features.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public NodeSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Node holds cluster-wide information about node specific features.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(NodeSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Node holds cluster-wide information about node specific features.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public NodeStatus getStatus() {
         return status;
     }
 
+    /**
+     * Node holds cluster-wide information about node specific features.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(NodeStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NodeList.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NodeList.java
index 947a0062442..14f0ba0ff16 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NodeList.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NodeList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class NodeList implements Editable<NodeListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.config.v1.Node>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.config.v1.Node> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "NodeList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public NodeList(String apiVersion, List<io.fabric8.openshift.api.model.config.v1
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.config.v1.Node> getItems() {
         return items;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.config.v1.Node> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NodeSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NodeSpec.java
index 6b12a3e52a7..e4419f39e55 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NodeSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NodeSpec.java
@@ -82,21 +82,33 @@ public NodeSpec(String cgroupMode, String workerLatencyProfile) {
         this.workerLatencyProfile = workerLatencyProfile;
     }
 
+    /**
+     * CgroupMode determines the cgroups version on the node
+     */
     @JsonProperty("cgroupMode")
     public String getCgroupMode() {
         return cgroupMode;
     }
 
+    /**
+     * CgroupMode determines the cgroups version on the node
+     */
     @JsonProperty("cgroupMode")
     public void setCgroupMode(String cgroupMode) {
         this.cgroupMode = cgroupMode;
     }
 
+    /**
+     * WorkerLatencyProfile determins the how fast the kubelet is updating the status and corresponding reaction of the cluster
+     */
     @JsonProperty("workerLatencyProfile")
     public String getWorkerLatencyProfile() {
         return workerLatencyProfile;
     }
 
+    /**
+     * WorkerLatencyProfile determins the how fast the kubelet is updating the status and corresponding reaction of the cluster
+     */
     @JsonProperty("workerLatencyProfile")
     public void setWorkerLatencyProfile(String workerLatencyProfile) {
         this.workerLatencyProfile = workerLatencyProfile;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NodeStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NodeStatus.java
index 78fbdd4034b..9cf28c3c1b7 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NodeStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NodeStatus.java
@@ -82,12 +82,18 @@ public NodeStatus(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * conditions contain the details and the current state of the nodes.config object
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions contain the details and the current state of the nodes.config object
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NutanixFailureDomain.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NutanixFailureDomain.java
index 413c9704809..04b2c99d16d 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NutanixFailureDomain.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NutanixFailureDomain.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NutanixFailureDomain configures failure domain information for the Nutanix platform.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public NutanixFailureDomain(NutanixResourceIdentifier cluster, String name, List
         this.subnets = subnets;
     }
 
+    /**
+     * NutanixFailureDomain configures failure domain information for the Nutanix platform.
+     */
     @JsonProperty("cluster")
     public NutanixResourceIdentifier getCluster() {
         return cluster;
     }
 
+    /**
+     * NutanixFailureDomain configures failure domain information for the Nutanix platform.
+     */
     @JsonProperty("cluster")
     public void setCluster(NutanixResourceIdentifier cluster) {
         this.cluster = cluster;
     }
 
+    /**
+     * name defines the unique name of a failure domain. Name is required and must be at most 64 characters in length. It must consist of only lower case alphanumeric characters and hyphens (-). It must start and end with an alphanumeric character. This value is arbitrary and is used to identify the failure domain within the platform.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name defines the unique name of a failure domain. Name is required and must be at most 64 characters in length. It must consist of only lower case alphanumeric characters and hyphens (-). It must start and end with an alphanumeric character. This value is arbitrary and is used to identify the failure domain within the platform.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * subnets holds a list of identifiers (one or more) of the cluster's network subnets for the Machine's VM to connect to. The subnet identifiers (uuid or name) can be obtained from the Prism Central console or using the prism_central API.
+     */
     @JsonProperty("subnets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NutanixResourceIdentifier> getSubnets() {
         return subnets;
     }
 
+    /**
+     * subnets holds a list of identifiers (one or more) of the cluster's network subnets for the Machine's VM to connect to. The subnet identifiers (uuid or name) can be obtained from the Prism Central console or using the prism_central API.
+     */
     @JsonProperty("subnets")
     public void setSubnets(List<NutanixResourceIdentifier> subnets) {
         this.subnets = subnets;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NutanixPlatformLoadBalancer.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NutanixPlatformLoadBalancer.java
index 535d767d5d9..72177236b40 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NutanixPlatformLoadBalancer.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NutanixPlatformLoadBalancer.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NutanixPlatformLoadBalancer defines the load balancer used by the cluster on Nutanix platform.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public NutanixPlatformLoadBalancer(String type) {
         this.type = type;
     }
 
+    /**
+     * type defines the type of load balancer used by the cluster on Nutanix platform which can be a user-managed or openshift-managed load balancer that is to be used for the OpenShift API and Ingress endpoints. When set to OpenShiftManagedDefault the static pods in charge of API and Ingress traffic load-balancing defined in the machine config operator will be deployed. When set to UserManaged these static pods will not be deployed and it is expected that the load balancer is configured out of band by the deployer. When omitted, this means no opinion and the platform is left to choose a reasonable default. The default value is OpenShiftManagedDefault.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type defines the type of load balancer used by the cluster on Nutanix platform which can be a user-managed or openshift-managed load balancer that is to be used for the OpenShift API and Ingress endpoints. When set to OpenShiftManagedDefault the static pods in charge of API and Ingress traffic load-balancing defined in the machine config operator will be deployed. When set to UserManaged these static pods will not be deployed and it is expected that the load balancer is configured out of band by the deployer. When omitted, this means no opinion and the platform is left to choose a reasonable default. The default value is OpenShiftManagedDefault.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NutanixPlatformSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NutanixPlatformSpec.java
index 30c1970870e..001443bc505 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NutanixPlatformSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NutanixPlatformSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NutanixPlatformSpec holds the desired state of the Nutanix infrastructure provider. This only includes fields that can be modified in the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public NutanixPlatformSpec(List<NutanixFailureDomain> failureDomains, NutanixPri
         this.prismElements = prismElements;
     }
 
+    /**
+     * failureDomains configures failure domains information for the Nutanix platform. When set, the failure domains defined here may be used to spread Machines across prism element clusters to improve fault tolerance of the cluster.
+     */
     @JsonProperty("failureDomains")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NutanixFailureDomain> getFailureDomains() {
         return failureDomains;
     }
 
+    /**
+     * failureDomains configures failure domains information for the Nutanix platform. When set, the failure domains defined here may be used to spread Machines across prism element clusters to improve fault tolerance of the cluster.
+     */
     @JsonProperty("failureDomains")
     public void setFailureDomains(List<NutanixFailureDomain> failureDomains) {
         this.failureDomains = failureDomains;
     }
 
+    /**
+     * NutanixPlatformSpec holds the desired state of the Nutanix infrastructure provider. This only includes fields that can be modified in the cluster.
+     */
     @JsonProperty("prismCentral")
     public NutanixPrismEndpoint getPrismCentral() {
         return prismCentral;
     }
 
+    /**
+     * NutanixPlatformSpec holds the desired state of the Nutanix infrastructure provider. This only includes fields that can be modified in the cluster.
+     */
     @JsonProperty("prismCentral")
     public void setPrismCentral(NutanixPrismEndpoint prismCentral) {
         this.prismCentral = prismCentral;
     }
 
+    /**
+     * prismElements holds one or more endpoint address and port data to access the Nutanix Prism Elements (clusters) of the Nutanix Prism Central. Currently we only support one Prism Element (cluster) for an OpenShift cluster, where all the Nutanix resources (VMs, subnets, volumes, etc.) used in the OpenShift cluster are located. In the future, we may support Nutanix resources (VMs, etc.) spread over multiple Prism Elements (clusters) of the Prism Central.
+     */
     @JsonProperty("prismElements")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NutanixPrismElementEndpoint> getPrismElements() {
         return prismElements;
     }
 
+    /**
+     * prismElements holds one or more endpoint address and port data to access the Nutanix Prism Elements (clusters) of the Nutanix Prism Central. Currently we only support one Prism Element (cluster) for an OpenShift cluster, where all the Nutanix resources (VMs, subnets, volumes, etc.) used in the OpenShift cluster are located. In the future, we may support Nutanix resources (VMs, etc.) spread over multiple Prism Elements (clusters) of the Prism Central.
+     */
     @JsonProperty("prismElements")
     public void setPrismElements(List<NutanixPrismElementEndpoint> prismElements) {
         this.prismElements = prismElements;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NutanixPlatformStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NutanixPlatformStatus.java
index 9ca9ebc980f..961bfcb896d 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NutanixPlatformStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NutanixPlatformStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NutanixPlatformStatus holds the current status of the Nutanix infrastructure provider.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,53 +101,83 @@ public NutanixPlatformStatus(String apiServerInternalIP, List<String> apiServerI
         this.loadBalancer = loadBalancer;
     }
 
+    /**
+     * apiServerInternalIP is an IP address to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. It is the IP that the Infrastructure.status.apiServerInternalURI points to. It is the IP for a self-hosted load balancer in front of the API servers.<br><p> <br><p> Deprecated: Use APIServerInternalIPs instead.
+     */
     @JsonProperty("apiServerInternalIP")
     public String getApiServerInternalIP() {
         return apiServerInternalIP;
     }
 
+    /**
+     * apiServerInternalIP is an IP address to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. It is the IP that the Infrastructure.status.apiServerInternalURI points to. It is the IP for a self-hosted load balancer in front of the API servers.<br><p> <br><p> Deprecated: Use APIServerInternalIPs instead.
+     */
     @JsonProperty("apiServerInternalIP")
     public void setApiServerInternalIP(String apiServerInternalIP) {
         this.apiServerInternalIP = apiServerInternalIP;
     }
 
+    /**
+     * apiServerInternalIPs are the IP addresses to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. These are the IPs for a self-hosted load balancer in front of the API servers. In dual stack clusters this list contains two IPs otherwise only one.
+     */
     @JsonProperty("apiServerInternalIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiServerInternalIPs() {
         return apiServerInternalIPs;
     }
 
+    /**
+     * apiServerInternalIPs are the IP addresses to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. These are the IPs for a self-hosted load balancer in front of the API servers. In dual stack clusters this list contains two IPs otherwise only one.
+     */
     @JsonProperty("apiServerInternalIPs")
     public void setApiServerInternalIPs(List<String> apiServerInternalIPs) {
         this.apiServerInternalIPs = apiServerInternalIPs;
     }
 
+    /**
+     * ingressIP is an external IP which routes to the default ingress controller. The IP is a suitable target of a wildcard DNS record used to resolve default route host names.<br><p> <br><p> Deprecated: Use IngressIPs instead.
+     */
     @JsonProperty("ingressIP")
     public String getIngressIP() {
         return ingressIP;
     }
 
+    /**
+     * ingressIP is an external IP which routes to the default ingress controller. The IP is a suitable target of a wildcard DNS record used to resolve default route host names.<br><p> <br><p> Deprecated: Use IngressIPs instead.
+     */
     @JsonProperty("ingressIP")
     public void setIngressIP(String ingressIP) {
         this.ingressIP = ingressIP;
     }
 
+    /**
+     * ingressIPs are the external IPs which route to the default ingress controller. The IPs are suitable targets of a wildcard DNS record used to resolve default route host names. In dual stack clusters this list contains two IPs otherwise only one.
+     */
     @JsonProperty("ingressIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIngressIPs() {
         return ingressIPs;
     }
 
+    /**
+     * ingressIPs are the external IPs which route to the default ingress controller. The IPs are suitable targets of a wildcard DNS record used to resolve default route host names. In dual stack clusters this list contains two IPs otherwise only one.
+     */
     @JsonProperty("ingressIPs")
     public void setIngressIPs(List<String> ingressIPs) {
         this.ingressIPs = ingressIPs;
     }
 
+    /**
+     * NutanixPlatformStatus holds the current status of the Nutanix infrastructure provider.
+     */
     @JsonProperty("loadBalancer")
     public NutanixPlatformLoadBalancer getLoadBalancer() {
         return loadBalancer;
     }
 
+    /**
+     * NutanixPlatformStatus holds the current status of the Nutanix infrastructure provider.
+     */
     @JsonProperty("loadBalancer")
     public void setLoadBalancer(NutanixPlatformLoadBalancer loadBalancer) {
         this.loadBalancer = loadBalancer;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NutanixPrismElementEndpoint.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NutanixPrismElementEndpoint.java
index 97aeb1da523..61ff746ebe1 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NutanixPrismElementEndpoint.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NutanixPrismElementEndpoint.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NutanixPrismElementEndpoint holds the name and endpoint data for a Prism Element (cluster)
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public NutanixPrismElementEndpoint(NutanixPrismEndpoint endpoint, String name) {
         this.name = name;
     }
 
+    /**
+     * NutanixPrismElementEndpoint holds the name and endpoint data for a Prism Element (cluster)
+     */
     @JsonProperty("endpoint")
     public NutanixPrismEndpoint getEndpoint() {
         return endpoint;
     }
 
+    /**
+     * NutanixPrismElementEndpoint holds the name and endpoint data for a Prism Element (cluster)
+     */
     @JsonProperty("endpoint")
     public void setEndpoint(NutanixPrismEndpoint endpoint) {
         this.endpoint = endpoint;
     }
 
+    /**
+     * name is the name of the Prism Element (cluster). This value will correspond with the cluster field configured on other resources (eg Machines, PVCs, etc).
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the Prism Element (cluster). This value will correspond with the cluster field configured on other resources (eg Machines, PVCs, etc).
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NutanixPrismEndpoint.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NutanixPrismEndpoint.java
index 60b5c05b554..cb083c8c10b 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NutanixPrismEndpoint.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NutanixPrismEndpoint.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NutanixPrismEndpoint holds the endpoint address and port to access the Nutanix Prism Central or Element (cluster)
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public NutanixPrismEndpoint(String address, Integer port) {
         this.port = port;
     }
 
+    /**
+     * address is the endpoint address (DNS name or IP address) of the Nutanix Prism Central or Element (cluster)
+     */
     @JsonProperty("address")
     public String getAddress() {
         return address;
     }
 
+    /**
+     * address is the endpoint address (DNS name or IP address) of the Nutanix Prism Central or Element (cluster)
+     */
     @JsonProperty("address")
     public void setAddress(String address) {
         this.address = address;
     }
 
+    /**
+     * port is the port number to access the Nutanix Prism Central or Element (cluster)
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * port is the port number to access the Nutanix Prism Central or Element (cluster)
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NutanixResourceIdentifier.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NutanixResourceIdentifier.java
index 004a1a580a4..e3ec36239f0 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NutanixResourceIdentifier.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/NutanixResourceIdentifier.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NutanixResourceIdentifier holds the identity of a Nutanix PC resource (cluster, image, subnet, etc.)
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public NutanixResourceIdentifier(String name, String type, String uuid) {
         this.uuid = uuid;
     }
 
+    /**
+     * name is the resource name in the PC. It cannot be empty if the type is Name.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the resource name in the PC. It cannot be empty if the type is Name.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * type is the identifier type to use for this resource.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the identifier type to use for this resource.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * uuid is the UUID of the resource in the PC. It cannot be empty if the type is UUID.
+     */
     @JsonProperty("uuid")
     public String getUuid() {
         return uuid;
     }
 
+    /**
+     * uuid is the UUID of the resource in the PC. It cannot be empty if the type is UUID.
+     */
     @JsonProperty("uuid")
     public void setUuid(String uuid) {
         this.uuid = uuid;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OAuth.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OAuth.java
index d410c7f623f..7b39023048f 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OAuth.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OAuth.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OAuth holds cluster-wide information about OAuth.  The canonical name is `cluster`. It is used to configure the integrated OAuth server. This configuration is only honored when the top level Authentication config has type set to IntegratedOAuth.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class OAuth implements Editable<OAuthBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OAuth";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public OAuth(String apiVersion, String kind, ObjectMeta metadata, OAuthSpec spec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OAuth holds cluster-wide information about OAuth.  The canonical name is `cluster`. It is used to configure the integrated OAuth server. This configuration is only honored when the top level Authentication config has type set to IntegratedOAuth.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OAuth holds cluster-wide information about OAuth.  The canonical name is `cluster`. It is used to configure the integrated OAuth server. This configuration is only honored when the top level Authentication config has type set to IntegratedOAuth.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * OAuth holds cluster-wide information about OAuth.  The canonical name is `cluster`. It is used to configure the integrated OAuth server. This configuration is only honored when the top level Authentication config has type set to IntegratedOAuth.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public OAuthSpec getSpec() {
         return spec;
     }
 
+    /**
+     * OAuth holds cluster-wide information about OAuth.  The canonical name is `cluster`. It is used to configure the integrated OAuth server. This configuration is only honored when the top level Authentication config has type set to IntegratedOAuth.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(OAuthSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * OAuth holds cluster-wide information about OAuth.  The canonical name is `cluster`. It is used to configure the integrated OAuth server. This configuration is only honored when the top level Authentication config has type set to IntegratedOAuth.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public OAuthStatus getStatus() {
         return status;
     }
 
+    /**
+     * OAuth holds cluster-wide information about OAuth.  The canonical name is `cluster`. It is used to configure the integrated OAuth server. This configuration is only honored when the top level Authentication config has type set to IntegratedOAuth.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(OAuthStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OAuthList.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OAuthList.java
index edd8e41e2e5..a1a181d5e9e 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OAuthList.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OAuthList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class OAuthList implements Editable<OAuthListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.config.v1.OAuth>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.config.v1.OAuth> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OAuthList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public OAuthList(String apiVersion, List<io.fabric8.openshift.api.model.config.v
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.config.v1.OAuth> getItems() {
         return items;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.config.v1.OAuth> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OAuthRemoteConnectionInfo.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OAuthRemoteConnectionInfo.java
index 9e940089a46..7f318391a5e 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OAuthRemoteConnectionInfo.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OAuthRemoteConnectionInfo.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OAuthRemoteConnectionInfo holds information necessary for establishing a remote connection
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public OAuthRemoteConnectionInfo(ConfigMapNameReference ca, SecretNameReference
         this.url = url;
     }
 
+    /**
+     * OAuthRemoteConnectionInfo holds information necessary for establishing a remote connection
+     */
     @JsonProperty("ca")
     public ConfigMapNameReference getCa() {
         return ca;
     }
 
+    /**
+     * OAuthRemoteConnectionInfo holds information necessary for establishing a remote connection
+     */
     @JsonProperty("ca")
     public void setCa(ConfigMapNameReference ca) {
         this.ca = ca;
     }
 
+    /**
+     * OAuthRemoteConnectionInfo holds information necessary for establishing a remote connection
+     */
     @JsonProperty("tlsClientCert")
     public SecretNameReference getTlsClientCert() {
         return tlsClientCert;
     }
 
+    /**
+     * OAuthRemoteConnectionInfo holds information necessary for establishing a remote connection
+     */
     @JsonProperty("tlsClientCert")
     public void setTlsClientCert(SecretNameReference tlsClientCert) {
         this.tlsClientCert = tlsClientCert;
     }
 
+    /**
+     * OAuthRemoteConnectionInfo holds information necessary for establishing a remote connection
+     */
     @JsonProperty("tlsClientKey")
     public SecretNameReference getTlsClientKey() {
         return tlsClientKey;
     }
 
+    /**
+     * OAuthRemoteConnectionInfo holds information necessary for establishing a remote connection
+     */
     @JsonProperty("tlsClientKey")
     public void setTlsClientKey(SecretNameReference tlsClientKey) {
         this.tlsClientKey = tlsClientKey;
     }
 
+    /**
+     * url is the remote URL to connect to
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * url is the remote URL to connect to
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OAuthSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OAuthSpec.java
index ac5db0ed802..b4911893c48 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OAuthSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OAuthSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OAuthSpec contains desired cluster auth configuration
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public OAuthSpec(List<IdentityProvider> identityProviders, OAuthTemplates templa
         this.tokenConfig = tokenConfig;
     }
 
+    /**
+     * identityProviders is an ordered list of ways for a user to identify themselves. When this list is empty, no identities are provisioned for users.
+     */
     @JsonProperty("identityProviders")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IdentityProvider> getIdentityProviders() {
         return identityProviders;
     }
 
+    /**
+     * identityProviders is an ordered list of ways for a user to identify themselves. When this list is empty, no identities are provisioned for users.
+     */
     @JsonProperty("identityProviders")
     public void setIdentityProviders(List<IdentityProvider> identityProviders) {
         this.identityProviders = identityProviders;
     }
 
+    /**
+     * OAuthSpec contains desired cluster auth configuration
+     */
     @JsonProperty("templates")
     public OAuthTemplates getTemplates() {
         return templates;
     }
 
+    /**
+     * OAuthSpec contains desired cluster auth configuration
+     */
     @JsonProperty("templates")
     public void setTemplates(OAuthTemplates templates) {
         this.templates = templates;
     }
 
+    /**
+     * OAuthSpec contains desired cluster auth configuration
+     */
     @JsonProperty("tokenConfig")
     public TokenConfig getTokenConfig() {
         return tokenConfig;
     }
 
+    /**
+     * OAuthSpec contains desired cluster auth configuration
+     */
     @JsonProperty("tokenConfig")
     public void setTokenConfig(TokenConfig tokenConfig) {
         this.tokenConfig = tokenConfig;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OAuthStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OAuthStatus.java
index 5ed8de9b506..ed1963e1cb0 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OAuthStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OAuthStatus.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OAuthStatus shows current known state of OAuth server in the cluster
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OAuthTemplates.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OAuthTemplates.java
index 2ce61db60fa..d4cdecf69df 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OAuthTemplates.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OAuthTemplates.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OAuthTemplates allow for customization of pages like the login page
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public OAuthTemplates(SecretNameReference error, SecretNameReference login, Secr
         this.providerSelection = providerSelection;
     }
 
+    /**
+     * OAuthTemplates allow for customization of pages like the login page
+     */
     @JsonProperty("error")
     public SecretNameReference getError() {
         return error;
     }
 
+    /**
+     * OAuthTemplates allow for customization of pages like the login page
+     */
     @JsonProperty("error")
     public void setError(SecretNameReference error) {
         this.error = error;
     }
 
+    /**
+     * OAuthTemplates allow for customization of pages like the login page
+     */
     @JsonProperty("login")
     public SecretNameReference getLogin() {
         return login;
     }
 
+    /**
+     * OAuthTemplates allow for customization of pages like the login page
+     */
     @JsonProperty("login")
     public void setLogin(SecretNameReference login) {
         this.login = login;
     }
 
+    /**
+     * OAuthTemplates allow for customization of pages like the login page
+     */
     @JsonProperty("providerSelection")
     public SecretNameReference getProviderSelection() {
         return providerSelection;
     }
 
+    /**
+     * OAuthTemplates allow for customization of pages like the login page
+     */
     @JsonProperty("providerSelection")
     public void setProviderSelection(SecretNameReference providerSelection) {
         this.providerSelection = providerSelection;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OIDCClientConfig.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OIDCClientConfig.java
index 38e7d338efb..e6032e3cf0f 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OIDCClientConfig.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OIDCClientConfig.java
@@ -97,11 +97,17 @@ public OIDCClientConfig(String clientID, SecretNameReference clientSecret, Strin
         this.extraScopes = extraScopes;
     }
 
+    /**
+     * ClientID is the identifier of the OIDC client from the OIDC provider
+     */
     @JsonProperty("clientID")
     public String getClientID() {
         return clientID;
     }
 
+    /**
+     * ClientID is the identifier of the OIDC client from the OIDC provider
+     */
     @JsonProperty("clientID")
     public void setClientID(String clientID) {
         this.clientID = clientID;
@@ -117,32 +123,50 @@ public void setClientSecret(SecretNameReference clientSecret) {
         this.clientSecret = clientSecret;
     }
 
+    /**
+     * ComponentName is the name of the component that is supposed to consume this client configuration
+     */
     @JsonProperty("componentName")
     public String getComponentName() {
         return componentName;
     }
 
+    /**
+     * ComponentName is the name of the component that is supposed to consume this client configuration
+     */
     @JsonProperty("componentName")
     public void setComponentName(String componentName) {
         this.componentName = componentName;
     }
 
+    /**
+     * ComponentNamespace is the namespace of the component that is supposed to consume this client configuration
+     */
     @JsonProperty("componentNamespace")
     public String getComponentNamespace() {
         return componentNamespace;
     }
 
+    /**
+     * ComponentNamespace is the namespace of the component that is supposed to consume this client configuration
+     */
     @JsonProperty("componentNamespace")
     public void setComponentNamespace(String componentNamespace) {
         this.componentNamespace = componentNamespace;
     }
 
+    /**
+     * ExtraScopes is an optional set of scopes to request tokens with.
+     */
     @JsonProperty("extraScopes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getExtraScopes() {
         return extraScopes;
     }
 
+    /**
+     * ExtraScopes is an optional set of scopes to request tokens with.
+     */
     @JsonProperty("extraScopes")
     public void setExtraScopes(List<String> extraScopes) {
         this.extraScopes = extraScopes;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OIDCClientReference.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OIDCClientReference.java
index cf9645b4eab..7c8cdaa6735 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OIDCClientReference.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OIDCClientReference.java
@@ -86,31 +86,49 @@ public OIDCClientReference(String clientID, String issuerURL, String oidcProvide
         this.oidcProviderName = oidcProviderName;
     }
 
+    /**
+     * ClientID is the identifier of the OIDC client from the OIDC provider
+     */
     @JsonProperty("clientID")
     public String getClientID() {
         return clientID;
     }
 
+    /**
+     * ClientID is the identifier of the OIDC client from the OIDC provider
+     */
     @JsonProperty("clientID")
     public void setClientID(String clientID) {
         this.clientID = clientID;
     }
 
+    /**
+     * URL is the serving URL of the token issuer. Must use the https:// scheme.
+     */
     @JsonProperty("issuerURL")
     public String getIssuerURL() {
         return issuerURL;
     }
 
+    /**
+     * URL is the serving URL of the token issuer. Must use the https:// scheme.
+     */
     @JsonProperty("issuerURL")
     public void setIssuerURL(String issuerURL) {
         this.issuerURL = issuerURL;
     }
 
+    /**
+     * OIDCName refers to the `name` of the provider from `oidcProviders`
+     */
     @JsonProperty("oidcProviderName")
     public String getOidcProviderName() {
         return oidcProviderName;
     }
 
+    /**
+     * OIDCName refers to the `name` of the provider from `oidcProviders`
+     */
     @JsonProperty("oidcProviderName")
     public void setOidcProviderName(String oidcProviderName) {
         this.oidcProviderName = oidcProviderName;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OIDCClientStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OIDCClientStatus.java
index 410c048d3a6..5697e521b80 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OIDCClientStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OIDCClientStatus.java
@@ -100,54 +100,84 @@ public OIDCClientStatus(String componentName, String componentNamespace, List<Co
         this.currentOIDCClients = currentOIDCClients;
     }
 
+    /**
+     * ComponentName is the name of the component that will consume a client configuration.
+     */
     @JsonProperty("componentName")
     public String getComponentName() {
         return componentName;
     }
 
+    /**
+     * ComponentName is the name of the component that will consume a client configuration.
+     */
     @JsonProperty("componentName")
     public void setComponentName(String componentName) {
         this.componentName = componentName;
     }
 
+    /**
+     * ComponentNamespace is the namespace of the component that will consume a client configuration.
+     */
     @JsonProperty("componentNamespace")
     public String getComponentNamespace() {
         return componentNamespace;
     }
 
+    /**
+     * ComponentNamespace is the namespace of the component that will consume a client configuration.
+     */
     @JsonProperty("componentNamespace")
     public void setComponentNamespace(String componentNamespace) {
         this.componentNamespace = componentNamespace;
     }
 
+    /**
+     * Conditions are used to communicate the state of the `oidcClients` entry.<br><p> <br><p> Supported conditions include Available, Degraded and Progressing.<br><p> <br><p> If Available is true, the component is successfully using the configured client. If Degraded is true, that means something has gone wrong trying to handle the client configuration. If Progressing is true, that means the component is taking some action related to the `oidcClients` entry.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions are used to communicate the state of the `oidcClients` entry.<br><p> <br><p> Supported conditions include Available, Degraded and Progressing.<br><p> <br><p> If Available is true, the component is successfully using the configured client. If Degraded is true, that means something has gone wrong trying to handle the client configuration. If Progressing is true, that means the component is taking some action related to the `oidcClients` entry.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ConsumingUsers is a slice of ServiceAccounts that need to have read permission on the `clientSecret` secret.
+     */
     @JsonProperty("consumingUsers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getConsumingUsers() {
         return consumingUsers;
     }
 
+    /**
+     * ConsumingUsers is a slice of ServiceAccounts that need to have read permission on the `clientSecret` secret.
+     */
     @JsonProperty("consumingUsers")
     public void setConsumingUsers(List<String> consumingUsers) {
         this.consumingUsers = consumingUsers;
     }
 
+    /**
+     * CurrentOIDCClients is a list of clients that the component is currently using.
+     */
     @JsonProperty("currentOIDCClients")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OIDCClientReference> getCurrentOIDCClients() {
         return currentOIDCClients;
     }
 
+    /**
+     * CurrentOIDCClients is a list of clients that the component is currently using.
+     */
     @JsonProperty("currentOIDCClients")
     public void setCurrentOIDCClients(List<OIDCClientReference> currentOIDCClients) {
         this.currentOIDCClients = currentOIDCClients;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OIDCProvider.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OIDCProvider.java
index 8bf155c8eb9..f7d0896377d 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OIDCProvider.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OIDCProvider.java
@@ -108,12 +108,18 @@ public void setClaimMappings(TokenClaimMappings claimMappings) {
         this.claimMappings = claimMappings;
     }
 
+    /**
+     * ClaimValidationRules are rules that are applied to validate token claims to authenticate users.
+     */
     @JsonProperty("claimValidationRules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TokenClaimValidationRule> getClaimValidationRules() {
         return claimValidationRules;
     }
 
+    /**
+     * ClaimValidationRules are rules that are applied to validate token claims to authenticate users.
+     */
     @JsonProperty("claimValidationRules")
     public void setClaimValidationRules(List<TokenClaimValidationRule> claimValidationRules) {
         this.claimValidationRules = claimValidationRules;
@@ -129,22 +135,34 @@ public void setIssuer(TokenIssuer issuer) {
         this.issuer = issuer;
     }
 
+    /**
+     * Name of the OIDC provider
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the OIDC provider
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * OIDCClients contains configuration for the platform's clients that need to request tokens from the issuer
+     */
     @JsonProperty("oidcClients")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OIDCClientConfig> getOidcClients() {
         return oidcClients;
     }
 
+    /**
+     * OIDCClients contains configuration for the platform's clients that need to request tokens from the issuer
+     */
     @JsonProperty("oidcClients")
     public void setOidcClients(List<OIDCClientConfig> oidcClients) {
         this.oidcClients = oidcClients;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ObjectReference.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ObjectReference.java
index 80f48bdbd7a..34025f0d9a8 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ObjectReference.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ObjectReference.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ObjectReference contains enough information to let you inspect or modify the referred object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,41 +92,65 @@ public ObjectReference(String group, String name, String namespace, String resou
         this.resource = resource;
     }
 
+    /**
+     * group of the referent.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * group of the referent.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * name of the referent.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name of the referent.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * namespace of the referent.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * namespace of the referent.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * resource of the referent.
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * resource of the referent.
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OldTLSProfile.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OldTLSProfile.java
index fa5123e7bb0..e50f74bfd3e 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OldTLSProfile.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OldTLSProfile.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OldTLSProfile is a TLS security profile based on: https://wiki.mozilla.org/Security/Server_Side_TLS#Old_backward_compatibility
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OpenIDClaims.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OpenIDClaims.java
index 5bab1c45c84..dc2b4fef7fc 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OpenIDClaims.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OpenIDClaims.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OpenIDClaims contains a list of OpenID claims to use when authenticating with an OpenID identity provider
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -96,45 +99,69 @@ public OpenIDClaims(List<String> email, List<String> groups, List<String> name,
         this.preferredUsername = preferredUsername;
     }
 
+    /**
+     * email is the list of claims whose values should be used as the email address. Optional. If unspecified, no email is set for the identity
+     */
     @JsonProperty("email")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEmail() {
         return email;
     }
 
+    /**
+     * email is the list of claims whose values should be used as the email address. Optional. If unspecified, no email is set for the identity
+     */
     @JsonProperty("email")
     public void setEmail(List<String> email) {
         this.email = email;
     }
 
+    /**
+     * groups is the list of claims value of which should be used to synchronize groups from the OIDC provider to OpenShift for the user. If multiple claims are specified, the first one with a non-empty value is used.
+     */
     @JsonProperty("groups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getGroups() {
         return groups;
     }
 
+    /**
+     * groups is the list of claims value of which should be used to synchronize groups from the OIDC provider to OpenShift for the user. If multiple claims are specified, the first one with a non-empty value is used.
+     */
     @JsonProperty("groups")
     public void setGroups(List<String> groups) {
         this.groups = groups;
     }
 
+    /**
+     * name is the list of claims whose values should be used as the display name. Optional. If unspecified, no display name is set for the identity
+     */
     @JsonProperty("name")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getName() {
         return name;
     }
 
+    /**
+     * name is the list of claims whose values should be used as the display name. Optional. If unspecified, no display name is set for the identity
+     */
     @JsonProperty("name")
     public void setName(List<String> name) {
         this.name = name;
     }
 
+    /**
+     * preferredUsername is the list of claims whose values should be used as the preferred username. If unspecified, the preferred username is determined from the value of the sub claim
+     */
     @JsonProperty("preferredUsername")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPreferredUsername() {
         return preferredUsername;
     }
 
+    /**
+     * preferredUsername is the list of claims whose values should be used as the preferred username. If unspecified, the preferred username is determined from the value of the sub claim
+     */
     @JsonProperty("preferredUsername")
     public void setPreferredUsername(List<String> preferredUsername) {
         this.preferredUsername = preferredUsername;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OpenIDIdentityProvider.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OpenIDIdentityProvider.java
index 05a8525e7be..8b4e7df4e0d 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OpenIDIdentityProvider.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OpenIDIdentityProvider.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OpenIDIdentityProvider provides identities for users authenticating using OpenID credentials
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -106,73 +109,115 @@ public OpenIDIdentityProvider(ConfigMapNameReference ca, OpenIDClaims claims, St
         this.issuer = issuer;
     }
 
+    /**
+     * OpenIDIdentityProvider provides identities for users authenticating using OpenID credentials
+     */
     @JsonProperty("ca")
     public ConfigMapNameReference getCa() {
         return ca;
     }
 
+    /**
+     * OpenIDIdentityProvider provides identities for users authenticating using OpenID credentials
+     */
     @JsonProperty("ca")
     public void setCa(ConfigMapNameReference ca) {
         this.ca = ca;
     }
 
+    /**
+     * OpenIDIdentityProvider provides identities for users authenticating using OpenID credentials
+     */
     @JsonProperty("claims")
     public OpenIDClaims getClaims() {
         return claims;
     }
 
+    /**
+     * OpenIDIdentityProvider provides identities for users authenticating using OpenID credentials
+     */
     @JsonProperty("claims")
     public void setClaims(OpenIDClaims claims) {
         this.claims = claims;
     }
 
+    /**
+     * clientID is the oauth client ID
+     */
     @JsonProperty("clientID")
     public String getClientID() {
         return clientID;
     }
 
+    /**
+     * clientID is the oauth client ID
+     */
     @JsonProperty("clientID")
     public void setClientID(String clientID) {
         this.clientID = clientID;
     }
 
+    /**
+     * OpenIDIdentityProvider provides identities for users authenticating using OpenID credentials
+     */
     @JsonProperty("clientSecret")
     public SecretNameReference getClientSecret() {
         return clientSecret;
     }
 
+    /**
+     * OpenIDIdentityProvider provides identities for users authenticating using OpenID credentials
+     */
     @JsonProperty("clientSecret")
     public void setClientSecret(SecretNameReference clientSecret) {
         this.clientSecret = clientSecret;
     }
 
+    /**
+     * extraAuthorizeParameters are any custom parameters to add to the authorize request.
+     */
     @JsonProperty("extraAuthorizeParameters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getExtraAuthorizeParameters() {
         return extraAuthorizeParameters;
     }
 
+    /**
+     * extraAuthorizeParameters are any custom parameters to add to the authorize request.
+     */
     @JsonProperty("extraAuthorizeParameters")
     public void setExtraAuthorizeParameters(Map<String, String> extraAuthorizeParameters) {
         this.extraAuthorizeParameters = extraAuthorizeParameters;
     }
 
+    /**
+     * extraScopes are any scopes to request in addition to the standard "openid" scope.
+     */
     @JsonProperty("extraScopes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getExtraScopes() {
         return extraScopes;
     }
 
+    /**
+     * extraScopes are any scopes to request in addition to the standard "openid" scope.
+     */
     @JsonProperty("extraScopes")
     public void setExtraScopes(List<String> extraScopes) {
         this.extraScopes = extraScopes;
     }
 
+    /**
+     * issuer is the URL that the OpenID Provider asserts as its Issuer Identifier. It must use the https scheme with no query or fragment component.
+     */
     @JsonProperty("issuer")
     public String getIssuer() {
         return issuer;
     }
 
+    /**
+     * issuer is the URL that the OpenID Provider asserts as its Issuer Identifier. It must use the https scheme with no query or fragment component.
+     */
     @JsonProperty("issuer")
     public void setIssuer(String issuer) {
         this.issuer = issuer;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OpenStackPlatformLoadBalancer.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OpenStackPlatformLoadBalancer.java
index 2334d529bcd..b197d6e372b 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OpenStackPlatformLoadBalancer.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OpenStackPlatformLoadBalancer.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OpenStackPlatformLoadBalancer defines the load balancer used by the cluster on OpenStack platform.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public OpenStackPlatformLoadBalancer(String type) {
         this.type = type;
     }
 
+    /**
+     * type defines the type of load balancer used by the cluster on OpenStack platform which can be a user-managed or openshift-managed load balancer that is to be used for the OpenShift API and Ingress endpoints. When set to OpenShiftManagedDefault the static pods in charge of API and Ingress traffic load-balancing defined in the machine config operator will be deployed. When set to UserManaged these static pods will not be deployed and it is expected that the load balancer is configured out of band by the deployer. When omitted, this means no opinion and the platform is left to choose a reasonable default. The default value is OpenShiftManagedDefault.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type defines the type of load balancer used by the cluster on OpenStack platform which can be a user-managed or openshift-managed load balancer that is to be used for the OpenShift API and Ingress endpoints. When set to OpenShiftManagedDefault the static pods in charge of API and Ingress traffic load-balancing defined in the machine config operator will be deployed. When set to UserManaged these static pods will not be deployed and it is expected that the load balancer is configured out of band by the deployer. When omitted, this means no opinion and the platform is left to choose a reasonable default. The default value is OpenShiftManagedDefault.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OpenStackPlatformSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OpenStackPlatformSpec.java
index cd91d34a8a7..9a5c4210363 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OpenStackPlatformSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OpenStackPlatformSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OpenStackPlatformSpec holds the desired state of the OpenStack infrastructure provider. This only includes fields that can be modified in the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,34 +94,52 @@ public OpenStackPlatformSpec(List<String> apiServerInternalIPs, List<String> ing
         this.machineNetworks = machineNetworks;
     }
 
+    /**
+     * apiServerInternalIPs are the IP addresses to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. These are the IPs for a self-hosted load balancer in front of the API servers. In dual stack clusters this list contains two IP addresses, one from IPv4 family and one from IPv6. In single stack clusters a single IP address is expected. When omitted, values from the status.apiServerInternalIPs will be used. Once set, the list cannot be completely removed (but its second entry can).
+     */
     @JsonProperty("apiServerInternalIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiServerInternalIPs() {
         return apiServerInternalIPs;
     }
 
+    /**
+     * apiServerInternalIPs are the IP addresses to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. These are the IPs for a self-hosted load balancer in front of the API servers. In dual stack clusters this list contains two IP addresses, one from IPv4 family and one from IPv6. In single stack clusters a single IP address is expected. When omitted, values from the status.apiServerInternalIPs will be used. Once set, the list cannot be completely removed (but its second entry can).
+     */
     @JsonProperty("apiServerInternalIPs")
     public void setApiServerInternalIPs(List<String> apiServerInternalIPs) {
         this.apiServerInternalIPs = apiServerInternalIPs;
     }
 
+    /**
+     * ingressIPs are the external IPs which route to the default ingress controller. The IPs are suitable targets of a wildcard DNS record used to resolve default route host names. In dual stack clusters this list contains two IP addresses, one from IPv4 family and one from IPv6. In single stack clusters a single IP address is expected. When omitted, values from the status.ingressIPs will be used. Once set, the list cannot be completely removed (but its second entry can).
+     */
     @JsonProperty("ingressIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIngressIPs() {
         return ingressIPs;
     }
 
+    /**
+     * ingressIPs are the external IPs which route to the default ingress controller. The IPs are suitable targets of a wildcard DNS record used to resolve default route host names. In dual stack clusters this list contains two IP addresses, one from IPv4 family and one from IPv6. In single stack clusters a single IP address is expected. When omitted, values from the status.ingressIPs will be used. Once set, the list cannot be completely removed (but its second entry can).
+     */
     @JsonProperty("ingressIPs")
     public void setIngressIPs(List<String> ingressIPs) {
         this.ingressIPs = ingressIPs;
     }
 
+    /**
+     * machineNetworks are IP networks used to connect all the OpenShift cluster nodes. Each network is provided in the CIDR format and should be IPv4 or IPv6, for example "10.0.0.0/8" or "fd00::/8".
+     */
     @JsonProperty("machineNetworks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMachineNetworks() {
         return machineNetworks;
     }
 
+    /**
+     * machineNetworks are IP networks used to connect all the OpenShift cluster nodes. Each network is provided in the CIDR format and should be IPv4 or IPv6, for example "10.0.0.0/8" or "fd00::/8".
+     */
     @JsonProperty("machineNetworks")
     public void setMachineNetworks(List<String> machineNetworks) {
         this.machineNetworks = machineNetworks;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OpenStackPlatformStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OpenStackPlatformStatus.java
index d3cf4dc2a33..b2ab3f7d6d4 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OpenStackPlatformStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OpenStackPlatformStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OpenStackPlatformStatus holds the current status of the OpenStack infrastructure provider.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -111,84 +114,132 @@ public OpenStackPlatformStatus(String apiServerInternalIP, List<String> apiServe
         this.nodeDNSIP = nodeDNSIP;
     }
 
+    /**
+     * apiServerInternalIP is an IP address to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. It is the IP that the Infrastructure.status.apiServerInternalURI points to. It is the IP for a self-hosted load balancer in front of the API servers.<br><p> <br><p> Deprecated: Use APIServerInternalIPs instead.
+     */
     @JsonProperty("apiServerInternalIP")
     public String getApiServerInternalIP() {
         return apiServerInternalIP;
     }
 
+    /**
+     * apiServerInternalIP is an IP address to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. It is the IP that the Infrastructure.status.apiServerInternalURI points to. It is the IP for a self-hosted load balancer in front of the API servers.<br><p> <br><p> Deprecated: Use APIServerInternalIPs instead.
+     */
     @JsonProperty("apiServerInternalIP")
     public void setApiServerInternalIP(String apiServerInternalIP) {
         this.apiServerInternalIP = apiServerInternalIP;
     }
 
+    /**
+     * apiServerInternalIPs are the IP addresses to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. These are the IPs for a self-hosted load balancer in front of the API servers. In dual stack clusters this list contains two IPs otherwise only one.
+     */
     @JsonProperty("apiServerInternalIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiServerInternalIPs() {
         return apiServerInternalIPs;
     }
 
+    /**
+     * apiServerInternalIPs are the IP addresses to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. These are the IPs for a self-hosted load balancer in front of the API servers. In dual stack clusters this list contains two IPs otherwise only one.
+     */
     @JsonProperty("apiServerInternalIPs")
     public void setApiServerInternalIPs(List<String> apiServerInternalIPs) {
         this.apiServerInternalIPs = apiServerInternalIPs;
     }
 
+    /**
+     * cloudName is the name of the desired OpenStack cloud in the client configuration file (`clouds.yaml`).
+     */
     @JsonProperty("cloudName")
     public String getCloudName() {
         return cloudName;
     }
 
+    /**
+     * cloudName is the name of the desired OpenStack cloud in the client configuration file (`clouds.yaml`).
+     */
     @JsonProperty("cloudName")
     public void setCloudName(String cloudName) {
         this.cloudName = cloudName;
     }
 
+    /**
+     * ingressIP is an external IP which routes to the default ingress controller. The IP is a suitable target of a wildcard DNS record used to resolve default route host names.<br><p> <br><p> Deprecated: Use IngressIPs instead.
+     */
     @JsonProperty("ingressIP")
     public String getIngressIP() {
         return ingressIP;
     }
 
+    /**
+     * ingressIP is an external IP which routes to the default ingress controller. The IP is a suitable target of a wildcard DNS record used to resolve default route host names.<br><p> <br><p> Deprecated: Use IngressIPs instead.
+     */
     @JsonProperty("ingressIP")
     public void setIngressIP(String ingressIP) {
         this.ingressIP = ingressIP;
     }
 
+    /**
+     * ingressIPs are the external IPs which route to the default ingress controller. The IPs are suitable targets of a wildcard DNS record used to resolve default route host names. In dual stack clusters this list contains two IPs otherwise only one.
+     */
     @JsonProperty("ingressIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIngressIPs() {
         return ingressIPs;
     }
 
+    /**
+     * ingressIPs are the external IPs which route to the default ingress controller. The IPs are suitable targets of a wildcard DNS record used to resolve default route host names. In dual stack clusters this list contains two IPs otherwise only one.
+     */
     @JsonProperty("ingressIPs")
     public void setIngressIPs(List<String> ingressIPs) {
         this.ingressIPs = ingressIPs;
     }
 
+    /**
+     * OpenStackPlatformStatus holds the current status of the OpenStack infrastructure provider.
+     */
     @JsonProperty("loadBalancer")
     public OpenStackPlatformLoadBalancer getLoadBalancer() {
         return loadBalancer;
     }
 
+    /**
+     * OpenStackPlatformStatus holds the current status of the OpenStack infrastructure provider.
+     */
     @JsonProperty("loadBalancer")
     public void setLoadBalancer(OpenStackPlatformLoadBalancer loadBalancer) {
         this.loadBalancer = loadBalancer;
     }
 
+    /**
+     * machineNetworks are IP networks used to connect all the OpenShift cluster nodes.
+     */
     @JsonProperty("machineNetworks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMachineNetworks() {
         return machineNetworks;
     }
 
+    /**
+     * machineNetworks are IP networks used to connect all the OpenShift cluster nodes.
+     */
     @JsonProperty("machineNetworks")
     public void setMachineNetworks(List<String> machineNetworks) {
         this.machineNetworks = machineNetworks;
     }
 
+    /**
+     * nodeDNSIP is the IP address for the internal DNS used by the nodes. Unlike the one managed by the DNS operator, `NodeDNSIP` provides name resolution for the nodes themselves. There is no DNS-as-a-service for OpenStack deployments. In order to minimize necessary changes to the datacenter DNS, a DNS service is hosted as a static pod to serve those hostnames to the nodes in the cluster.
+     */
     @JsonProperty("nodeDNSIP")
     public String getNodeDNSIP() {
         return nodeDNSIP;
     }
 
+    /**
+     * nodeDNSIP is the IP address for the internal DNS used by the nodes. Unlike the one managed by the DNS operator, `NodeDNSIP` provides name resolution for the nodes themselves. There is no DNS-as-a-service for OpenStack deployments. In order to minimize necessary changes to the datacenter DNS, a DNS service is hosted as a static pod to serve those hostnames to the nodes in the cluster.
+     */
     @JsonProperty("nodeDNSIP")
     public void setNodeDNSIP(String nodeDNSIP) {
         this.nodeDNSIP = nodeDNSIP;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OperandVersion.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OperandVersion.java
index 93ac3131490..8b43c0463b1 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OperandVersion.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OperandVersion.java
@@ -82,21 +82,33 @@ public OperandVersion(String name, String version) {
         this.version = version;
     }
 
+    /**
+     * name is the name of the particular operand this version is for.  It usually matches container images, not operators.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the particular operand this version is for.  It usually matches container images, not operators.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * version indicates which version of a particular operand is currently being managed.  It must always match the Available operand.  If 1.0.0 is Available, then this must indicate 1.0.0 even if the operator is trying to rollout 1.1.0
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version indicates which version of a particular operand is currently being managed.  It must always match the Available operand.  If 1.0.0 is Available, then this must indicate 1.0.0 even if the operator is trying to rollout 1.1.0
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OperatorHub.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OperatorHub.java
index ada71c3177a..a10660bcc76 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OperatorHub.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OperatorHub.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorHub is the Schema for the operatorhubs API. It can be used to change the state of the default hub sources for OperatorHub on the cluster from enabled to disabled and vice versa.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class OperatorHub implements Editable<OperatorHubBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OperatorHub";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public OperatorHub(String apiVersion, String kind, ObjectMeta metadata, Operator
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OperatorHub is the Schema for the operatorhubs API. It can be used to change the state of the default hub sources for OperatorHub on the cluster from enabled to disabled and vice versa.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OperatorHub is the Schema for the operatorhubs API. It can be used to change the state of the default hub sources for OperatorHub on the cluster from enabled to disabled and vice versa.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * OperatorHub is the Schema for the operatorhubs API. It can be used to change the state of the default hub sources for OperatorHub on the cluster from enabled to disabled and vice versa.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public OperatorHubSpec getSpec() {
         return spec;
     }
 
+    /**
+     * OperatorHub is the Schema for the operatorhubs API. It can be used to change the state of the default hub sources for OperatorHub on the cluster from enabled to disabled and vice versa.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(OperatorHubSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * OperatorHub is the Schema for the operatorhubs API. It can be used to change the state of the default hub sources for OperatorHub on the cluster from enabled to disabled and vice versa.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public OperatorHubStatus getStatus() {
         return status;
     }
 
+    /**
+     * OperatorHub is the Schema for the operatorhubs API. It can be used to change the state of the default hub sources for OperatorHub on the cluster from enabled to disabled and vice versa.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(OperatorHubStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OperatorHubList.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OperatorHubList.java
index 60a193f3306..604033de7cc 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OperatorHubList.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OperatorHubList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorHubList contains a list of OperatorHub<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class OperatorHubList implements Editable<OperatorHubListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.config.v1.OperatorHub>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.config.v1.OperatorHub> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OperatorHubList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public OperatorHubList(String apiVersion, List<io.fabric8.openshift.api.model.co
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * OperatorHubList contains a list of OperatorHub<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.config.v1.OperatorHub> getItems() {
         return items;
     }
 
+    /**
+     * OperatorHubList contains a list of OperatorHub<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.config.v1.OperatorHub> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OperatorHubList contains a list of OperatorHub<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OperatorHubList contains a list of OperatorHub<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OperatorHubSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OperatorHubSpec.java
index 0852556e7a9..557b5a23673 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OperatorHubSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OperatorHubSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorHubSpec defines the desired state of OperatorHub
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public OperatorHubSpec(Boolean disableAllDefaultSources, List<HubSource> sources
         this.sources = sources;
     }
 
+    /**
+     * disableAllDefaultSources allows you to disable all the default hub sources. If this is true, a specific entry in sources can be used to enable a default source. If this is false, a specific entry in sources can be used to disable or enable a default source.
+     */
     @JsonProperty("disableAllDefaultSources")
     public Boolean getDisableAllDefaultSources() {
         return disableAllDefaultSources;
     }
 
+    /**
+     * disableAllDefaultSources allows you to disable all the default hub sources. If this is true, a specific entry in sources can be used to enable a default source. If this is false, a specific entry in sources can be used to disable or enable a default source.
+     */
     @JsonProperty("disableAllDefaultSources")
     public void setDisableAllDefaultSources(Boolean disableAllDefaultSources) {
         this.disableAllDefaultSources = disableAllDefaultSources;
     }
 
+    /**
+     * sources is the list of default hub sources and their configuration. If the list is empty, it implies that the default hub sources are enabled on the cluster unless disableAllDefaultSources is true. If disableAllDefaultSources is true and sources is not empty, the configuration present in sources will take precedence. The list of default hub sources and their current state will always be reflected in the status block.
+     */
     @JsonProperty("sources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HubSource> getSources() {
         return sources;
     }
 
+    /**
+     * sources is the list of default hub sources and their configuration. If the list is empty, it implies that the default hub sources are enabled on the cluster unless disableAllDefaultSources is true. If disableAllDefaultSources is true and sources is not empty, the configuration present in sources will take precedence. The list of default hub sources and their current state will always be reflected in the status block.
+     */
     @JsonProperty("sources")
     public void setSources(List<HubSource> sources) {
         this.sources = sources;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OperatorHubStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OperatorHubStatus.java
index 2cd3e6ef267..588f3cf56e1 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OperatorHubStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OperatorHubStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorHubStatus defines the observed state of OperatorHub. The current state of the default hub sources will always be reflected here.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public OperatorHubStatus(List<HubSourceStatus> sources) {
         this.sources = sources;
     }
 
+    /**
+     * sources encapsulates the result of applying the configuration for each hub source
+     */
     @JsonProperty("sources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HubSourceStatus> getSources() {
         return sources;
     }
 
+    /**
+     * sources encapsulates the result of applying the configuration for each hub source
+     */
     @JsonProperty("sources")
     public void setSources(List<HubSourceStatus> sources) {
         this.sources = sources;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OvirtPlatformLoadBalancer.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OvirtPlatformLoadBalancer.java
index 5c7eec41c41..81ca89c4a9a 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OvirtPlatformLoadBalancer.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OvirtPlatformLoadBalancer.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OvirtPlatformLoadBalancer defines the load balancer used by the cluster on Ovirt platform.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public OvirtPlatformLoadBalancer(String type) {
         this.type = type;
     }
 
+    /**
+     * type defines the type of load balancer used by the cluster on Ovirt platform which can be a user-managed or openshift-managed load balancer that is to be used for the OpenShift API and Ingress endpoints. When set to OpenShiftManagedDefault the static pods in charge of API and Ingress traffic load-balancing defined in the machine config operator will be deployed. When set to UserManaged these static pods will not be deployed and it is expected that the load balancer is configured out of band by the deployer. When omitted, this means no opinion and the platform is left to choose a reasonable default. The default value is OpenShiftManagedDefault.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type defines the type of load balancer used by the cluster on Ovirt platform which can be a user-managed or openshift-managed load balancer that is to be used for the OpenShift API and Ingress endpoints. When set to OpenShiftManagedDefault the static pods in charge of API and Ingress traffic load-balancing defined in the machine config operator will be deployed. When set to UserManaged these static pods will not be deployed and it is expected that the load balancer is configured out of band by the deployer. When omitted, this means no opinion and the platform is left to choose a reasonable default. The default value is OpenShiftManagedDefault.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OvirtPlatformSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OvirtPlatformSpec.java
index a31f1a4d889..ec2e5d0e108 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OvirtPlatformSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OvirtPlatformSpec.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OvirtPlatformSpec holds the desired state of the oVirt infrastructure provider. This only includes fields that can be modified in the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OvirtPlatformStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OvirtPlatformStatus.java
index a48b7c956b2..66c198b13a3 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OvirtPlatformStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/OvirtPlatformStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OvirtPlatformStatus holds the current status of the  oVirt infrastructure provider.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,63 +105,99 @@ public OvirtPlatformStatus(String apiServerInternalIP, List<String> apiServerInt
         this.nodeDNSIP = nodeDNSIP;
     }
 
+    /**
+     * apiServerInternalIP is an IP address to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. It is the IP that the Infrastructure.status.apiServerInternalURI points to. It is the IP for a self-hosted load balancer in front of the API servers.<br><p> <br><p> Deprecated: Use APIServerInternalIPs instead.
+     */
     @JsonProperty("apiServerInternalIP")
     public String getApiServerInternalIP() {
         return apiServerInternalIP;
     }
 
+    /**
+     * apiServerInternalIP is an IP address to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. It is the IP that the Infrastructure.status.apiServerInternalURI points to. It is the IP for a self-hosted load balancer in front of the API servers.<br><p> <br><p> Deprecated: Use APIServerInternalIPs instead.
+     */
     @JsonProperty("apiServerInternalIP")
     public void setApiServerInternalIP(String apiServerInternalIP) {
         this.apiServerInternalIP = apiServerInternalIP;
     }
 
+    /**
+     * apiServerInternalIPs are the IP addresses to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. These are the IPs for a self-hosted load balancer in front of the API servers. In dual stack clusters this list contains two IPs otherwise only one.
+     */
     @JsonProperty("apiServerInternalIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiServerInternalIPs() {
         return apiServerInternalIPs;
     }
 
+    /**
+     * apiServerInternalIPs are the IP addresses to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. These are the IPs for a self-hosted load balancer in front of the API servers. In dual stack clusters this list contains two IPs otherwise only one.
+     */
     @JsonProperty("apiServerInternalIPs")
     public void setApiServerInternalIPs(List<String> apiServerInternalIPs) {
         this.apiServerInternalIPs = apiServerInternalIPs;
     }
 
+    /**
+     * ingressIP is an external IP which routes to the default ingress controller. The IP is a suitable target of a wildcard DNS record used to resolve default route host names.<br><p> <br><p> Deprecated: Use IngressIPs instead.
+     */
     @JsonProperty("ingressIP")
     public String getIngressIP() {
         return ingressIP;
     }
 
+    /**
+     * ingressIP is an external IP which routes to the default ingress controller. The IP is a suitable target of a wildcard DNS record used to resolve default route host names.<br><p> <br><p> Deprecated: Use IngressIPs instead.
+     */
     @JsonProperty("ingressIP")
     public void setIngressIP(String ingressIP) {
         this.ingressIP = ingressIP;
     }
 
+    /**
+     * ingressIPs are the external IPs which route to the default ingress controller. The IPs are suitable targets of a wildcard DNS record used to resolve default route host names. In dual stack clusters this list contains two IPs otherwise only one.
+     */
     @JsonProperty("ingressIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIngressIPs() {
         return ingressIPs;
     }
 
+    /**
+     * ingressIPs are the external IPs which route to the default ingress controller. The IPs are suitable targets of a wildcard DNS record used to resolve default route host names. In dual stack clusters this list contains two IPs otherwise only one.
+     */
     @JsonProperty("ingressIPs")
     public void setIngressIPs(List<String> ingressIPs) {
         this.ingressIPs = ingressIPs;
     }
 
+    /**
+     * OvirtPlatformStatus holds the current status of the  oVirt infrastructure provider.
+     */
     @JsonProperty("loadBalancer")
     public OvirtPlatformLoadBalancer getLoadBalancer() {
         return loadBalancer;
     }
 
+    /**
+     * OvirtPlatformStatus holds the current status of the  oVirt infrastructure provider.
+     */
     @JsonProperty("loadBalancer")
     public void setLoadBalancer(OvirtPlatformLoadBalancer loadBalancer) {
         this.loadBalancer = loadBalancer;
     }
 
+    /**
+     * deprecated: as of 4.6, this field is no longer set or honored.  It will be removed in a future release.
+     */
     @JsonProperty("nodeDNSIP")
     public String getNodeDNSIP() {
         return nodeDNSIP;
     }
 
+    /**
+     * deprecated: as of 4.6, this field is no longer set or honored.  It will be removed in a future release.
+     */
     @JsonProperty("nodeDNSIP")
     public void setNodeDNSIP(String nodeDNSIP) {
         this.nodeDNSIP = nodeDNSIP;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/PlatformSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/PlatformSpec.java
index 80e12c20f57..85f1ce45c28 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/PlatformSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/PlatformSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -134,151 +137,241 @@ public PlatformSpec(AlibabaCloudPlatformSpec alibabaCloud, AWSPlatformSpec aws,
         this.vsphere = vsphere;
     }
 
+    /**
+     * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("alibabaCloud")
     public AlibabaCloudPlatformSpec getAlibabaCloud() {
         return alibabaCloud;
     }
 
+    /**
+     * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("alibabaCloud")
     public void setAlibabaCloud(AlibabaCloudPlatformSpec alibabaCloud) {
         this.alibabaCloud = alibabaCloud;
     }
 
+    /**
+     * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("aws")
     public AWSPlatformSpec getAws() {
         return aws;
     }
 
+    /**
+     * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("aws")
     public void setAws(AWSPlatformSpec aws) {
         this.aws = aws;
     }
 
+    /**
+     * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("azure")
     public AzurePlatformSpec getAzure() {
         return azure;
     }
 
+    /**
+     * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("azure")
     public void setAzure(AzurePlatformSpec azure) {
         this.azure = azure;
     }
 
+    /**
+     * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("baremetal")
     public BareMetalPlatformSpec getBaremetal() {
         return baremetal;
     }
 
+    /**
+     * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("baremetal")
     public void setBaremetal(BareMetalPlatformSpec baremetal) {
         this.baremetal = baremetal;
     }
 
+    /**
+     * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("equinixMetal")
     public EquinixMetalPlatformSpec getEquinixMetal() {
         return equinixMetal;
     }
 
+    /**
+     * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("equinixMetal")
     public void setEquinixMetal(EquinixMetalPlatformSpec equinixMetal) {
         this.equinixMetal = equinixMetal;
     }
 
+    /**
+     * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("external")
     public ExternalPlatformSpec getExternal() {
         return external;
     }
 
+    /**
+     * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("external")
     public void setExternal(ExternalPlatformSpec external) {
         this.external = external;
     }
 
+    /**
+     * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("gcp")
     public GCPPlatformSpec getGcp() {
         return gcp;
     }
 
+    /**
+     * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("gcp")
     public void setGcp(GCPPlatformSpec gcp) {
         this.gcp = gcp;
     }
 
+    /**
+     * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("ibmcloud")
     public IBMCloudPlatformSpec getIbmcloud() {
         return ibmcloud;
     }
 
+    /**
+     * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("ibmcloud")
     public void setIbmcloud(IBMCloudPlatformSpec ibmcloud) {
         this.ibmcloud = ibmcloud;
     }
 
+    /**
+     * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("kubevirt")
     public KubevirtPlatformSpec getKubevirt() {
         return kubevirt;
     }
 
+    /**
+     * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("kubevirt")
     public void setKubevirt(KubevirtPlatformSpec kubevirt) {
         this.kubevirt = kubevirt;
     }
 
+    /**
+     * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("nutanix")
     public NutanixPlatformSpec getNutanix() {
         return nutanix;
     }
 
+    /**
+     * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("nutanix")
     public void setNutanix(NutanixPlatformSpec nutanix) {
         this.nutanix = nutanix;
     }
 
+    /**
+     * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("openstack")
     public OpenStackPlatformSpec getOpenstack() {
         return openstack;
     }
 
+    /**
+     * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("openstack")
     public void setOpenstack(OpenStackPlatformSpec openstack) {
         this.openstack = openstack;
     }
 
+    /**
+     * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("ovirt")
     public OvirtPlatformSpec getOvirt() {
         return ovirt;
     }
 
+    /**
+     * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("ovirt")
     public void setOvirt(OvirtPlatformSpec ovirt) {
         this.ovirt = ovirt;
     }
 
+    /**
+     * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("powervs")
     public PowerVSPlatformSpec getPowervs() {
         return powervs;
     }
 
+    /**
+     * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("powervs")
     public void setPowervs(PowerVSPlatformSpec powervs) {
         this.powervs = powervs;
     }
 
+    /**
+     * type is the underlying infrastructure provider for the cluster. This value controls whether infrastructure automation such as service load balancers, dynamic volume provisioning, machine creation and deletion, and other integrations are enabled. If None, no infrastructure automation is enabled. Allowed values are "AWS", "Azure", "BareMetal", "GCP", "Libvirt", "OpenStack", "VSphere", "oVirt", "KubeVirt", "EquinixMetal", "PowerVS", "AlibabaCloud", "Nutanix" and "None". Individual components may not support all platforms, and must handle unrecognized platforms as None if they do not support that platform.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the underlying infrastructure provider for the cluster. This value controls whether infrastructure automation such as service load balancers, dynamic volume provisioning, machine creation and deletion, and other integrations are enabled. If None, no infrastructure automation is enabled. Allowed values are "AWS", "Azure", "BareMetal", "GCP", "Libvirt", "OpenStack", "VSphere", "oVirt", "KubeVirt", "EquinixMetal", "PowerVS", "AlibabaCloud", "Nutanix" and "None". Individual components may not support all platforms, and must handle unrecognized platforms as None if they do not support that platform.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("vsphere")
     public VSpherePlatformSpec getVsphere() {
         return vsphere;
     }
 
+    /**
+     * PlatformSpec holds the desired state specific to the underlying infrastructure provider of the current cluster. Since these are used at spec-level for the underlying cluster, it is supposed that only one of the spec structs is set.
+     */
     @JsonProperty("vsphere")
     public void setVsphere(VSpherePlatformSpec vsphere) {
         this.vsphere = vsphere;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/PlatformStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/PlatformStatus.java
index 00c747773b6..610ac9449b4 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/PlatformStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/PlatformStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -134,151 +137,241 @@ public PlatformStatus(AlibabaCloudPlatformStatus alibabaCloud, AWSPlatformStatus
         this.vsphere = vsphere;
     }
 
+    /**
+     * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+     */
     @JsonProperty("alibabaCloud")
     public AlibabaCloudPlatformStatus getAlibabaCloud() {
         return alibabaCloud;
     }
 
+    /**
+     * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+     */
     @JsonProperty("alibabaCloud")
     public void setAlibabaCloud(AlibabaCloudPlatformStatus alibabaCloud) {
         this.alibabaCloud = alibabaCloud;
     }
 
+    /**
+     * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+     */
     @JsonProperty("aws")
     public AWSPlatformStatus getAws() {
         return aws;
     }
 
+    /**
+     * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+     */
     @JsonProperty("aws")
     public void setAws(AWSPlatformStatus aws) {
         this.aws = aws;
     }
 
+    /**
+     * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+     */
     @JsonProperty("azure")
     public AzurePlatformStatus getAzure() {
         return azure;
     }
 
+    /**
+     * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+     */
     @JsonProperty("azure")
     public void setAzure(AzurePlatformStatus azure) {
         this.azure = azure;
     }
 
+    /**
+     * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+     */
     @JsonProperty("baremetal")
     public BareMetalPlatformStatus getBaremetal() {
         return baremetal;
     }
 
+    /**
+     * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+     */
     @JsonProperty("baremetal")
     public void setBaremetal(BareMetalPlatformStatus baremetal) {
         this.baremetal = baremetal;
     }
 
+    /**
+     * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+     */
     @JsonProperty("equinixMetal")
     public EquinixMetalPlatformStatus getEquinixMetal() {
         return equinixMetal;
     }
 
+    /**
+     * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+     */
     @JsonProperty("equinixMetal")
     public void setEquinixMetal(EquinixMetalPlatformStatus equinixMetal) {
         this.equinixMetal = equinixMetal;
     }
 
+    /**
+     * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+     */
     @JsonProperty("external")
     public ExternalPlatformStatus getExternal() {
         return external;
     }
 
+    /**
+     * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+     */
     @JsonProperty("external")
     public void setExternal(ExternalPlatformStatus external) {
         this.external = external;
     }
 
+    /**
+     * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+     */
     @JsonProperty("gcp")
     public GCPPlatformStatus getGcp() {
         return gcp;
     }
 
+    /**
+     * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+     */
     @JsonProperty("gcp")
     public void setGcp(GCPPlatformStatus gcp) {
         this.gcp = gcp;
     }
 
+    /**
+     * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+     */
     @JsonProperty("ibmcloud")
     public IBMCloudPlatformStatus getIbmcloud() {
         return ibmcloud;
     }
 
+    /**
+     * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+     */
     @JsonProperty("ibmcloud")
     public void setIbmcloud(IBMCloudPlatformStatus ibmcloud) {
         this.ibmcloud = ibmcloud;
     }
 
+    /**
+     * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+     */
     @JsonProperty("kubevirt")
     public KubevirtPlatformStatus getKubevirt() {
         return kubevirt;
     }
 
+    /**
+     * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+     */
     @JsonProperty("kubevirt")
     public void setKubevirt(KubevirtPlatformStatus kubevirt) {
         this.kubevirt = kubevirt;
     }
 
+    /**
+     * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+     */
     @JsonProperty("nutanix")
     public NutanixPlatformStatus getNutanix() {
         return nutanix;
     }
 
+    /**
+     * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+     */
     @JsonProperty("nutanix")
     public void setNutanix(NutanixPlatformStatus nutanix) {
         this.nutanix = nutanix;
     }
 
+    /**
+     * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+     */
     @JsonProperty("openstack")
     public OpenStackPlatformStatus getOpenstack() {
         return openstack;
     }
 
+    /**
+     * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+     */
     @JsonProperty("openstack")
     public void setOpenstack(OpenStackPlatformStatus openstack) {
         this.openstack = openstack;
     }
 
+    /**
+     * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+     */
     @JsonProperty("ovirt")
     public OvirtPlatformStatus getOvirt() {
         return ovirt;
     }
 
+    /**
+     * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+     */
     @JsonProperty("ovirt")
     public void setOvirt(OvirtPlatformStatus ovirt) {
         this.ovirt = ovirt;
     }
 
+    /**
+     * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+     */
     @JsonProperty("powervs")
     public PowerVSPlatformStatus getPowervs() {
         return powervs;
     }
 
+    /**
+     * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+     */
     @JsonProperty("powervs")
     public void setPowervs(PowerVSPlatformStatus powervs) {
         this.powervs = powervs;
     }
 
+    /**
+     * type is the underlying infrastructure provider for the cluster. This value controls whether infrastructure automation such as service load balancers, dynamic volume provisioning, machine creation and deletion, and other integrations are enabled. If None, no infrastructure automation is enabled. Allowed values are "AWS", "Azure", "BareMetal", "GCP", "Libvirt", "OpenStack", "VSphere", "oVirt", "EquinixMetal", "PowerVS", "AlibabaCloud", "Nutanix" and "None". Individual components may not support all platforms, and must handle unrecognized platforms as None if they do not support that platform.<br><p> <br><p> This value will be synced with to the `status.platform` and `status.platformStatus.type`. Currently this value cannot be changed once set.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the underlying infrastructure provider for the cluster. This value controls whether infrastructure automation such as service load balancers, dynamic volume provisioning, machine creation and deletion, and other integrations are enabled. If None, no infrastructure automation is enabled. Allowed values are "AWS", "Azure", "BareMetal", "GCP", "Libvirt", "OpenStack", "VSphere", "oVirt", "EquinixMetal", "PowerVS", "AlibabaCloud", "Nutanix" and "None". Individual components may not support all platforms, and must handle unrecognized platforms as None if they do not support that platform.<br><p> <br><p> This value will be synced with to the `status.platform` and `status.platformStatus.type`. Currently this value cannot be changed once set.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+     */
     @JsonProperty("vsphere")
     public VSpherePlatformStatus getVsphere() {
         return vsphere;
     }
 
+    /**
+     * PlatformStatus holds the current status specific to the underlying infrastructure provider of the current cluster. Since these are used at status-level for the underlying cluster, it is supposed that only one of the status structs is set.
+     */
     @JsonProperty("vsphere")
     public void setVsphere(VSpherePlatformStatus vsphere) {
         this.vsphere = vsphere;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/PowerVSPlatformSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/PowerVSPlatformSpec.java
index 7f34a5fdd17..df4b33f6981 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/PowerVSPlatformSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/PowerVSPlatformSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PowerVSPlatformSpec holds the desired state of the IBM Power Systems Virtual Servers infrastructure provider. This only includes fields that can be modified in the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public PowerVSPlatformSpec(List<PowerVSServiceEndpoint> serviceEndpoints) {
         this.serviceEndpoints = serviceEndpoints;
     }
 
+    /**
+     * serviceEndpoints is a list of custom endpoints which will override the default service endpoints of a Power VS service.
+     */
     @JsonProperty("serviceEndpoints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PowerVSServiceEndpoint> getServiceEndpoints() {
         return serviceEndpoints;
     }
 
+    /**
+     * serviceEndpoints is a list of custom endpoints which will override the default service endpoints of a Power VS service.
+     */
     @JsonProperty("serviceEndpoints")
     public void setServiceEndpoints(List<PowerVSServiceEndpoint> serviceEndpoints) {
         this.serviceEndpoints = serviceEndpoints;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/PowerVSPlatformStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/PowerVSPlatformStatus.java
index c3f1b9a29ed..39339131257 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/PowerVSPlatformStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/PowerVSPlatformStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PowerVSPlatformStatus holds the current status of the IBM Power Systems Virtual Servers infrastrucutre provider.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,62 +104,98 @@ public PowerVSPlatformStatus(String cisInstanceCRN, String dnsInstanceCRN, Strin
         this.zone = zone;
     }
 
+    /**
+     * CISInstanceCRN is the CRN of the Cloud Internet Services instance managing the DNS zone for the cluster's base domain
+     */
     @JsonProperty("cisInstanceCRN")
     public String getCisInstanceCRN() {
         return cisInstanceCRN;
     }
 
+    /**
+     * CISInstanceCRN is the CRN of the Cloud Internet Services instance managing the DNS zone for the cluster's base domain
+     */
     @JsonProperty("cisInstanceCRN")
     public void setCisInstanceCRN(String cisInstanceCRN) {
         this.cisInstanceCRN = cisInstanceCRN;
     }
 
+    /**
+     * DNSInstanceCRN is the CRN of the DNS Services instance managing the DNS zone for the cluster's base domain
+     */
     @JsonProperty("dnsInstanceCRN")
     public String getDnsInstanceCRN() {
         return dnsInstanceCRN;
     }
 
+    /**
+     * DNSInstanceCRN is the CRN of the DNS Services instance managing the DNS zone for the cluster's base domain
+     */
     @JsonProperty("dnsInstanceCRN")
     public void setDnsInstanceCRN(String dnsInstanceCRN) {
         this.dnsInstanceCRN = dnsInstanceCRN;
     }
 
+    /**
+     * region holds the default Power VS region for new Power VS resources created by the cluster.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * region holds the default Power VS region for new Power VS resources created by the cluster.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * resourceGroup is the resource group name for new IBMCloud resources created for a cluster. The resource group specified here will be used by cluster-image-registry-operator to set up a COS Instance in IBMCloud for the cluster registry. More about resource groups can be found here: https://cloud.ibm.com/docs/account?topic=account-rgs. When omitted, the image registry operator won't be able to configure storage, which results in the image registry cluster operator not being in an available state.
+     */
     @JsonProperty("resourceGroup")
     public String getResourceGroup() {
         return resourceGroup;
     }
 
+    /**
+     * resourceGroup is the resource group name for new IBMCloud resources created for a cluster. The resource group specified here will be used by cluster-image-registry-operator to set up a COS Instance in IBMCloud for the cluster registry. More about resource groups can be found here: https://cloud.ibm.com/docs/account?topic=account-rgs. When omitted, the image registry operator won't be able to configure storage, which results in the image registry cluster operator not being in an available state.
+     */
     @JsonProperty("resourceGroup")
     public void setResourceGroup(String resourceGroup) {
         this.resourceGroup = resourceGroup;
     }
 
+    /**
+     * serviceEndpoints is a list of custom endpoints which will override the default service endpoints of a Power VS service.
+     */
     @JsonProperty("serviceEndpoints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PowerVSServiceEndpoint> getServiceEndpoints() {
         return serviceEndpoints;
     }
 
+    /**
+     * serviceEndpoints is a list of custom endpoints which will override the default service endpoints of a Power VS service.
+     */
     @JsonProperty("serviceEndpoints")
     public void setServiceEndpoints(List<PowerVSServiceEndpoint> serviceEndpoints) {
         this.serviceEndpoints = serviceEndpoints;
     }
 
+    /**
+     * zone holds the default zone for the new Power VS resources created by the cluster. Note: Currently only single-zone OCP clusters are supported
+     */
     @JsonProperty("zone")
     public String getZone() {
         return zone;
     }
 
+    /**
+     * zone holds the default zone for the new Power VS resources created by the cluster. Note: Currently only single-zone OCP clusters are supported
+     */
     @JsonProperty("zone")
     public void setZone(String zone) {
         this.zone = zone;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/PowerVSServiceEndpoint.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/PowerVSServiceEndpoint.java
index dde2a030037..ffcd8f0829b 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/PowerVSServiceEndpoint.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/PowerVSServiceEndpoint.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PowervsServiceEndpoint stores the configuration of a custom url to override existing defaults of PowerVS Services.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PowerVSServiceEndpoint(String name, String url) {
         this.url = url;
     }
 
+    /**
+     * name is the name of the Power VS service. Few of the services are IAM - https://cloud.ibm.com/apidocs/iam-identity-token-api ResourceController - https://cloud.ibm.com/apidocs/resource-controller/resource-controller Power Cloud - https://cloud.ibm.com/apidocs/power-cloud
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the Power VS service. Few of the services are IAM - https://cloud.ibm.com/apidocs/iam-identity-token-api ResourceController - https://cloud.ibm.com/apidocs/resource-controller/resource-controller Power Cloud - https://cloud.ibm.com/apidocs/power-cloud
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * url is fully qualified URI with scheme https, that overrides the default generated endpoint for a client. This must be provided and cannot be empty.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * url is fully qualified URI with scheme https, that overrides the default generated endpoint for a client. This must be provided and cannot be empty.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/PrefixedClaimMapping.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/PrefixedClaimMapping.java
index 215d0bd0cde..4769c542f04 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/PrefixedClaimMapping.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/PrefixedClaimMapping.java
@@ -82,21 +82,33 @@ public PrefixedClaimMapping(String claim, String prefix) {
         this.prefix = prefix;
     }
 
+    /**
+     * Claim is a JWT token claim to be used in the mapping
+     */
     @JsonProperty("claim")
     public String getClaim() {
         return claim;
     }
 
+    /**
+     * Claim is a JWT token claim to be used in the mapping
+     */
     @JsonProperty("claim")
     public void setClaim(String claim) {
         this.claim = claim;
     }
 
+    /**
+     * Prefix is a string to prefix the value from the token in the result of the claim mapping.<br><p> <br><p> By default, no prefixing occurs.<br><p> <br><p> Example: if `prefix` is set to "myoidc:"" and the `claim` in JWT contains an array of strings "a", "b" and  "c", the mapping will result in an array of string "myoidc:a", "myoidc:b" and "myoidc:c".
+     */
     @JsonProperty("prefix")
     public String getPrefix() {
         return prefix;
     }
 
+    /**
+     * Prefix is a string to prefix the value from the token in the result of the claim mapping.<br><p> <br><p> By default, no prefixing occurs.<br><p> <br><p> Example: if `prefix` is set to "myoidc:"" and the `claim` in JWT contains an array of strings "a", "b" and  "c", the mapping will result in an array of string "myoidc:a", "myoidc:b" and "myoidc:c".
+     */
     @JsonProperty("prefix")
     public void setPrefix(String prefix) {
         this.prefix = prefix;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ProfileCustomizations.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ProfileCustomizations.java
index 0da87ccf4c5..a4ed2622255 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ProfileCustomizations.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ProfileCustomizations.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ProfileCustomizations contains various parameters for modifying the default behavior of certain profiles
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ProfileCustomizations(String dynamicResourceAllocation) {
         this.dynamicResourceAllocation = dynamicResourceAllocation;
     }
 
+    /**
+     * dynamicResourceAllocation allows to enable or disable dynamic resource allocation within the scheduler. Dynamic resource allocation is an API for requesting and sharing resources between pods and containers inside a pod. Third-party resource drivers are responsible for tracking and allocating resources. Different kinds of resources support arbitrary parameters for defining requirements and initialization. Valid values are Enabled, Disabled and omitted. When omitted, this means no opinion and the platform is left to choose a reasonable default, which is subject to change over time. The current default is Disabled.
+     */
     @JsonProperty("dynamicResourceAllocation")
     public String getDynamicResourceAllocation() {
         return dynamicResourceAllocation;
     }
 
+    /**
+     * dynamicResourceAllocation allows to enable or disable dynamic resource allocation within the scheduler. Dynamic resource allocation is an API for requesting and sharing resources between pods and containers inside a pod. Third-party resource drivers are responsible for tracking and allocating resources. Different kinds of resources support arbitrary parameters for defining requirements and initialization. Valid values are Enabled, Disabled and omitted. When omitted, this means no opinion and the platform is left to choose a reasonable default, which is subject to change over time. The current default is Disabled.
+     */
     @JsonProperty("dynamicResourceAllocation")
     public void setDynamicResourceAllocation(String dynamicResourceAllocation) {
         this.dynamicResourceAllocation = dynamicResourceAllocation;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Project.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Project.java
index 465280a0638..68bfa938ac3 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Project.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Project.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Project holds cluster-wide information about Project.  The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Project implements Editable<ProjectBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Project";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public Project(String apiVersion, String kind, ObjectMeta metadata, ProjectSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Project holds cluster-wide information about Project.  The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Project holds cluster-wide information about Project.  The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Project holds cluster-wide information about Project.  The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ProjectSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Project holds cluster-wide information about Project.  The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ProjectSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Project holds cluster-wide information about Project.  The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public ProjectStatus getStatus() {
         return status;
     }
 
+    /**
+     * Project holds cluster-wide information about Project.  The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(ProjectStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ProjectList.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ProjectList.java
index cea3ec1d195..3bdbefb69ce 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ProjectList.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ProjectList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ProjectList implements Editable<ProjectListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.config.v1.Project>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.config.v1.Project> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ProjectList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ProjectList(String apiVersion, List<io.fabric8.openshift.api.model.config
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.config.v1.Project> getItems() {
         return items;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.config.v1.Project> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ProjectSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ProjectSpec.java
index 6cfef4f24a0..4ceabfac394 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ProjectSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ProjectSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ProjectSpec holds the project creation configuration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ProjectSpec(String projectRequestMessage, TemplateReference projectReques
         this.projectRequestTemplate = projectRequestTemplate;
     }
 
+    /**
+     * projectRequestMessage is the string presented to a user if they are unable to request a project via the projectrequest api endpoint
+     */
     @JsonProperty("projectRequestMessage")
     public String getProjectRequestMessage() {
         return projectRequestMessage;
     }
 
+    /**
+     * projectRequestMessage is the string presented to a user if they are unable to request a project via the projectrequest api endpoint
+     */
     @JsonProperty("projectRequestMessage")
     public void setProjectRequestMessage(String projectRequestMessage) {
         this.projectRequestMessage = projectRequestMessage;
     }
 
+    /**
+     * ProjectSpec holds the project creation configuration.
+     */
     @JsonProperty("projectRequestTemplate")
     public TemplateReference getProjectRequestTemplate() {
         return projectRequestTemplate;
     }
 
+    /**
+     * ProjectSpec holds the project creation configuration.
+     */
     @JsonProperty("projectRequestTemplate")
     public void setProjectRequestTemplate(TemplateReference projectRequestTemplate) {
         this.projectRequestTemplate = projectRequestTemplate;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/PromQLClusterCondition.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/PromQLClusterCondition.java
index 0afd6f907fe..74c5f8ae617 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/PromQLClusterCondition.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/PromQLClusterCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PromQLClusterCondition represents a cluster condition based on PromQL.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public PromQLClusterCondition(String promql) {
         this.promql = promql;
     }
 
+    /**
+     * PromQL is a PromQL query classifying clusters. This query query should return a 1 in the match case and a 0 in the does-not-match case. Queries which return no time series, or which return values besides 0 or 1, are evaluation failures.
+     */
     @JsonProperty("promql")
     public String getPromql() {
         return promql;
     }
 
+    /**
+     * PromQL is a PromQL query classifying clusters. This query query should return a 1 in the match case and a 0 in the does-not-match case. Queries which return no time series, or which return values besides 0 or 1, are evaluation failures.
+     */
     @JsonProperty("promql")
     public void setPromql(String promql) {
         this.promql = promql;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Proxy.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Proxy.java
index b8a5da10f33..abc6c48703f 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Proxy.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Proxy.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Proxy holds cluster-wide information on how to configure default proxies for the cluster. The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Proxy implements Editable<ProxyBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Proxy";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public Proxy(String apiVersion, String kind, ObjectMeta metadata, ProxySpec spec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Proxy holds cluster-wide information on how to configure default proxies for the cluster. The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Proxy holds cluster-wide information on how to configure default proxies for the cluster. The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Proxy holds cluster-wide information on how to configure default proxies for the cluster. The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ProxySpec getSpec() {
         return spec;
     }
 
+    /**
+     * Proxy holds cluster-wide information on how to configure default proxies for the cluster. The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ProxySpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Proxy holds cluster-wide information on how to configure default proxies for the cluster. The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public ProxyStatus getStatus() {
         return status;
     }
 
+    /**
+     * Proxy holds cluster-wide information on how to configure default proxies for the cluster. The canonical name is `cluster`<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(ProxyStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ProxyList.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ProxyList.java
index f3b7c7e3925..92980ded2b5 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ProxyList.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ProxyList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ProxyList implements Editable<ProxyListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.config.v1.Proxy>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.config.v1.Proxy> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ProxyList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ProxyList(String apiVersion, List<io.fabric8.openshift.api.model.config.v
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.config.v1.Proxy> getItems() {
         return items;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.config.v1.Proxy> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ProxySpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ProxySpec.java
index e94127a2a1a..ac8430a1589 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ProxySpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ProxySpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ProxySpec contains cluster proxy creation configuration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -97,52 +100,82 @@ public ProxySpec(String httpProxy, String httpsProxy, String noProxy, List<Strin
         this.trustedCA = trustedCA;
     }
 
+    /**
+     * httpProxy is the URL of the proxy for HTTP requests.  Empty means unset and will not result in an env var.
+     */
     @JsonProperty("httpProxy")
     public String getHttpProxy() {
         return httpProxy;
     }
 
+    /**
+     * httpProxy is the URL of the proxy for HTTP requests.  Empty means unset and will not result in an env var.
+     */
     @JsonProperty("httpProxy")
     public void setHttpProxy(String httpProxy) {
         this.httpProxy = httpProxy;
     }
 
+    /**
+     * httpsProxy is the URL of the proxy for HTTPS requests.  Empty means unset and will not result in an env var.
+     */
     @JsonProperty("httpsProxy")
     public String getHttpsProxy() {
         return httpsProxy;
     }
 
+    /**
+     * httpsProxy is the URL of the proxy for HTTPS requests.  Empty means unset and will not result in an env var.
+     */
     @JsonProperty("httpsProxy")
     public void setHttpsProxy(String httpsProxy) {
         this.httpsProxy = httpsProxy;
     }
 
+    /**
+     * noProxy is a comma-separated list of hostnames and/or CIDRs and/or IPs for which the proxy should not be used. Empty means unset and will not result in an env var.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * noProxy is a comma-separated list of hostnames and/or CIDRs and/or IPs for which the proxy should not be used. Empty means unset and will not result in an env var.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * readinessEndpoints is a list of endpoints used to verify readiness of the proxy.
+     */
     @JsonProperty("readinessEndpoints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getReadinessEndpoints() {
         return readinessEndpoints;
     }
 
+    /**
+     * readinessEndpoints is a list of endpoints used to verify readiness of the proxy.
+     */
     @JsonProperty("readinessEndpoints")
     public void setReadinessEndpoints(List<String> readinessEndpoints) {
         this.readinessEndpoints = readinessEndpoints;
     }
 
+    /**
+     * ProxySpec contains cluster proxy creation configuration.
+     */
     @JsonProperty("trustedCA")
     public ConfigMapNameReference getTrustedCA() {
         return trustedCA;
     }
 
+    /**
+     * ProxySpec contains cluster proxy creation configuration.
+     */
     @JsonProperty("trustedCA")
     public void setTrustedCA(ConfigMapNameReference trustedCA) {
         this.trustedCA = trustedCA;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ProxyStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ProxyStatus.java
index a712cb12c0b..d81dc284003 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ProxyStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ProxyStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ProxyStatus shows current known state of the cluster proxy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ProxyStatus(String httpProxy, String httpsProxy, String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * httpProxy is the URL of the proxy for HTTP requests.
+     */
     @JsonProperty("httpProxy")
     public String getHttpProxy() {
         return httpProxy;
     }
 
+    /**
+     * httpProxy is the URL of the proxy for HTTP requests.
+     */
     @JsonProperty("httpProxy")
     public void setHttpProxy(String httpProxy) {
         this.httpProxy = httpProxy;
     }
 
+    /**
+     * httpsProxy is the URL of the proxy for HTTPS requests.
+     */
     @JsonProperty("httpsProxy")
     public String getHttpsProxy() {
         return httpsProxy;
     }
 
+    /**
+     * httpsProxy is the URL of the proxy for HTTPS requests.
+     */
     @JsonProperty("httpsProxy")
     public void setHttpsProxy(String httpsProxy) {
         this.httpsProxy = httpsProxy;
     }
 
+    /**
+     * noProxy is a comma-separated list of hostnames and/or CIDRs for which the proxy should not be used.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * noProxy is a comma-separated list of hostnames and/or CIDRs for which the proxy should not be used.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/RegistryLocation.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/RegistryLocation.java
index d6900aa6648..d0fa55d2d04 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/RegistryLocation.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/RegistryLocation.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RegistryLocation contains a location of the registry specified by the registry domain name. The domain name might include wildcards, like '&#42;' or '??'.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public RegistryLocation(String domainName, Boolean insecure) {
         this.insecure = insecure;
     }
 
+    /**
+     * domainName specifies a domain name for the registry In case the registry use non-standard (80 or 443) port, the port should be included in the domain name as well.
+     */
     @JsonProperty("domainName")
     public String getDomainName() {
         return domainName;
     }
 
+    /**
+     * domainName specifies a domain name for the registry In case the registry use non-standard (80 or 443) port, the port should be included in the domain name as well.
+     */
     @JsonProperty("domainName")
     public void setDomainName(String domainName) {
         this.domainName = domainName;
     }
 
+    /**
+     * insecure indicates whether the registry is secure (https) or insecure (http) By default (if not specified) the registry is assumed as secure.
+     */
     @JsonProperty("insecure")
     public Boolean getInsecure() {
         return insecure;
     }
 
+    /**
+     * insecure indicates whether the registry is secure (https) or insecure (http) By default (if not specified) the registry is assumed as secure.
+     */
     @JsonProperty("insecure")
     public void setInsecure(Boolean insecure) {
         this.insecure = insecure;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/RegistrySources.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/RegistrySources.java
index e1a9df90557..1e4684cfebb 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/RegistrySources.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/RegistrySources.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RegistrySources holds cluster-wide information about how to handle the registries config.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -96,45 +99,69 @@ public RegistrySources(List<String> allowedRegistries, List<String> blockedRegis
         this.insecureRegistries = insecureRegistries;
     }
 
+    /**
+     * allowedRegistries are the only registries permitted for image pull and push actions. All other registries are denied.<br><p> <br><p> Only one of BlockedRegistries or AllowedRegistries may be set.
+     */
     @JsonProperty("allowedRegistries")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAllowedRegistries() {
         return allowedRegistries;
     }
 
+    /**
+     * allowedRegistries are the only registries permitted for image pull and push actions. All other registries are denied.<br><p> <br><p> Only one of BlockedRegistries or AllowedRegistries may be set.
+     */
     @JsonProperty("allowedRegistries")
     public void setAllowedRegistries(List<String> allowedRegistries) {
         this.allowedRegistries = allowedRegistries;
     }
 
+    /**
+     * blockedRegistries cannot be used for image pull and push actions. All other registries are permitted.<br><p> <br><p> Only one of BlockedRegistries or AllowedRegistries may be set.
+     */
     @JsonProperty("blockedRegistries")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getBlockedRegistries() {
         return blockedRegistries;
     }
 
+    /**
+     * blockedRegistries cannot be used for image pull and push actions. All other registries are permitted.<br><p> <br><p> Only one of BlockedRegistries or AllowedRegistries may be set.
+     */
     @JsonProperty("blockedRegistries")
     public void setBlockedRegistries(List<String> blockedRegistries) {
         this.blockedRegistries = blockedRegistries;
     }
 
+    /**
+     * containerRuntimeSearchRegistries are registries that will be searched when pulling images that do not have fully qualified domains in their pull specs. Registries will be searched in the order provided in the list. Note: this search list only works with the container runtime, i.e CRI-O. Will NOT work with builds or imagestream imports.
+     */
     @JsonProperty("containerRuntimeSearchRegistries")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getContainerRuntimeSearchRegistries() {
         return containerRuntimeSearchRegistries;
     }
 
+    /**
+     * containerRuntimeSearchRegistries are registries that will be searched when pulling images that do not have fully qualified domains in their pull specs. Registries will be searched in the order provided in the list. Note: this search list only works with the container runtime, i.e CRI-O. Will NOT work with builds or imagestream imports.
+     */
     @JsonProperty("containerRuntimeSearchRegistries")
     public void setContainerRuntimeSearchRegistries(List<String> containerRuntimeSearchRegistries) {
         this.containerRuntimeSearchRegistries = containerRuntimeSearchRegistries;
     }
 
+    /**
+     * insecureRegistries are registries which do not have a valid TLS certificates or only support HTTP connections.
+     */
     @JsonProperty("insecureRegistries")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getInsecureRegistries() {
         return insecureRegistries;
     }
 
+    /**
+     * insecureRegistries are registries which do not have a valid TLS certificates or only support HTTP connections.
+     */
     @JsonProperty("insecureRegistries")
     public void setInsecureRegistries(List<String> insecureRegistries) {
         this.insecureRegistries = insecureRegistries;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Release.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Release.java
index 92ac7711657..aa8db0d5d87 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Release.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Release.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Release represents an OpenShift release image and associated metadata.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public Release(List<String> channels, String image, String url, String version)
         this.version = version;
     }
 
+    /**
+     * channels is the set of Cincinnati channels to which the release currently belongs.
+     */
     @JsonProperty("channels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getChannels() {
         return channels;
     }
 
+    /**
+     * channels is the set of Cincinnati channels to which the release currently belongs.
+     */
     @JsonProperty("channels")
     public void setChannels(List<String> channels) {
         this.channels = channels;
     }
 
+    /**
+     * image is a container image location that contains the update. When this field is part of spec, image is optional if version is specified and the availableUpdates field contains a matching version.
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * image is a container image location that contains the update. When this field is part of spec, image is optional if version is specified and the availableUpdates field contains a matching version.
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
     }
 
+    /**
+     * url contains information about this release. This URL is set by the 'url' metadata property on a release or the metadata returned by the update API and should be displayed as a link in user interfaces. The URL field may not be set for test or nightly releases.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * url contains information about this release. This URL is set by the 'url' metadata property on a release or the metadata returned by the update API and should be displayed as a link in user interfaces. The URL field may not be set for test or nightly releases.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
     }
 
+    /**
+     * version is a semantic version identifying the update version. When this field is part of spec, version is optional if image is specified.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is a semantic version identifying the update version. When this field is part of spec, version is optional if image is specified.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/RemoteConnectionInfo.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/RemoteConnectionInfo.java
index 29882fb513f..3afbaf2f105 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/RemoteConnectionInfo.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/RemoteConnectionInfo.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RemoteConnectionInfo holds information necessary for establishing a remote connection
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public RemoteConnectionInfo(String ca, String certFile, String keyFile, String u
         this.url = url;
     }
 
+    /**
+     * CA is the CA for verifying TLS connections
+     */
     @JsonProperty("ca")
     public String getCa() {
         return ca;
     }
 
+    /**
+     * CA is the CA for verifying TLS connections
+     */
     @JsonProperty("ca")
     public void setCa(String ca) {
         this.ca = ca;
     }
 
+    /**
+     * CertFile is a file containing a PEM-encoded certificate
+     */
     @JsonProperty("certFile")
     public String getCertFile() {
         return certFile;
     }
 
+    /**
+     * CertFile is a file containing a PEM-encoded certificate
+     */
     @JsonProperty("certFile")
     public void setCertFile(String certFile) {
         this.certFile = certFile;
     }
 
+    /**
+     * KeyFile is a file containing a PEM-encoded private key for the certificate specified by CertFile
+     */
     @JsonProperty("keyFile")
     public String getKeyFile() {
         return keyFile;
     }
 
+    /**
+     * KeyFile is a file containing a PEM-encoded private key for the certificate specified by CertFile
+     */
     @JsonProperty("keyFile")
     public void setKeyFile(String keyFile) {
         this.keyFile = keyFile;
     }
 
+    /**
+     * URL is the remote URL to connect to
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * URL is the remote URL to connect to
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/RepositoryDigestMirrors.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/RepositoryDigestMirrors.java
index c58dcd5d317..f7830e99c2d 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/RepositoryDigestMirrors.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/RepositoryDigestMirrors.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RepositoryDigestMirrors holds cluster-wide information about how to handle mirrors in the registries config.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public RepositoryDigestMirrors(Boolean allowMirrorByTags, List<String> mirrors,
         this.source = source;
     }
 
+    /**
+     * allowMirrorByTags if true, the mirrors can be used to pull the images that are referenced by their tags. Default is false, the mirrors only work when pulling the images that are referenced by their digests. Pulling images by tag can potentially yield different images, depending on which endpoint we pull from. Forcing digest-pulls for mirrors avoids that issue.
+     */
     @JsonProperty("allowMirrorByTags")
     public Boolean getAllowMirrorByTags() {
         return allowMirrorByTags;
     }
 
+    /**
+     * allowMirrorByTags if true, the mirrors can be used to pull the images that are referenced by their tags. Default is false, the mirrors only work when pulling the images that are referenced by their digests. Pulling images by tag can potentially yield different images, depending on which endpoint we pull from. Forcing digest-pulls for mirrors avoids that issue.
+     */
     @JsonProperty("allowMirrorByTags")
     public void setAllowMirrorByTags(Boolean allowMirrorByTags) {
         this.allowMirrorByTags = allowMirrorByTags;
     }
 
+    /**
+     * mirrors is zero or more repositories that may also contain the same images. If the "mirrors" is not specified, the image will continue to be pulled from the specified repository in the pull spec. No mirror will be configured. The order of mirrors in this list is treated as the user's desired priority, while source is by default considered lower priority than all mirrors. Other cluster configuration, including (but not limited to) other repositoryDigestMirrors objects, may impact the exact order mirrors are contacted in, or some mirrors may be contacted in parallel, so this should be considered a preference rather than a guarantee of ordering.
+     */
     @JsonProperty("mirrors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMirrors() {
         return mirrors;
     }
 
+    /**
+     * mirrors is zero or more repositories that may also contain the same images. If the "mirrors" is not specified, the image will continue to be pulled from the specified repository in the pull spec. No mirror will be configured. The order of mirrors in this list is treated as the user's desired priority, while source is by default considered lower priority than all mirrors. Other cluster configuration, including (but not limited to) other repositoryDigestMirrors objects, may impact the exact order mirrors are contacted in, or some mirrors may be contacted in parallel, so this should be considered a preference rather than a guarantee of ordering.
+     */
     @JsonProperty("mirrors")
     public void setMirrors(List<String> mirrors) {
         this.mirrors = mirrors;
     }
 
+    /**
+     * source is the repository that users refer to, e.g. in image pull specifications.
+     */
     @JsonProperty("source")
     public String getSource() {
         return source;
     }
 
+    /**
+     * source is the repository that users refer to, e.g. in image pull specifications.
+     */
     @JsonProperty("source")
     public void setSource(String source) {
         this.source = source;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/RequestHeaderIdentityProvider.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/RequestHeaderIdentityProvider.java
index 17fc59134f0..9df4f6b5256 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/RequestHeaderIdentityProvider.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/RequestHeaderIdentityProvider.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RequestHeaderIdentityProvider provides identities for users authenticating using request header credentials
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -113,86 +116,134 @@ public RequestHeaderIdentityProvider(ConfigMapNameReference ca, String challenge
         this.preferredUsernameHeaders = preferredUsernameHeaders;
     }
 
+    /**
+     * RequestHeaderIdentityProvider provides identities for users authenticating using request header credentials
+     */
     @JsonProperty("ca")
     public ConfigMapNameReference getCa() {
         return ca;
     }
 
+    /**
+     * RequestHeaderIdentityProvider provides identities for users authenticating using request header credentials
+     */
     @JsonProperty("ca")
     public void setCa(ConfigMapNameReference ca) {
         this.ca = ca;
     }
 
+    /**
+     * challengeURL is a URL to redirect unauthenticated /authorize requests to Unauthenticated requests from OAuth clients which expect WWW-Authenticate challenges will be redirected here. ${url} is replaced with the current URL, escaped to be safe in a query parameter<br><p>   https://www.example.com/sso-login?then=${url}<br><p> ${query} is replaced with the current query string<br><p>   https://www.example.com/auth-proxy/oauth/authorize?${query}<br><p> Required when challenge is set to true.
+     */
     @JsonProperty("challengeURL")
     public String getChallengeURL() {
         return challengeURL;
     }
 
+    /**
+     * challengeURL is a URL to redirect unauthenticated /authorize requests to Unauthenticated requests from OAuth clients which expect WWW-Authenticate challenges will be redirected here. ${url} is replaced with the current URL, escaped to be safe in a query parameter<br><p>   https://www.example.com/sso-login?then=${url}<br><p> ${query} is replaced with the current query string<br><p>   https://www.example.com/auth-proxy/oauth/authorize?${query}<br><p> Required when challenge is set to true.
+     */
     @JsonProperty("challengeURL")
     public void setChallengeURL(String challengeURL) {
         this.challengeURL = challengeURL;
     }
 
+    /**
+     * clientCommonNames is an optional list of common names to require a match from. If empty, any client certificate validated against the clientCA bundle is considered authoritative.
+     */
     @JsonProperty("clientCommonNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getClientCommonNames() {
         return clientCommonNames;
     }
 
+    /**
+     * clientCommonNames is an optional list of common names to require a match from. If empty, any client certificate validated against the clientCA bundle is considered authoritative.
+     */
     @JsonProperty("clientCommonNames")
     public void setClientCommonNames(List<String> clientCommonNames) {
         this.clientCommonNames = clientCommonNames;
     }
 
+    /**
+     * emailHeaders is the set of headers to check for the email address
+     */
     @JsonProperty("emailHeaders")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEmailHeaders() {
         return emailHeaders;
     }
 
+    /**
+     * emailHeaders is the set of headers to check for the email address
+     */
     @JsonProperty("emailHeaders")
     public void setEmailHeaders(List<String> emailHeaders) {
         this.emailHeaders = emailHeaders;
     }
 
+    /**
+     * headers is the set of headers to check for identity information
+     */
     @JsonProperty("headers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getHeaders() {
         return headers;
     }
 
+    /**
+     * headers is the set of headers to check for identity information
+     */
     @JsonProperty("headers")
     public void setHeaders(List<String> headers) {
         this.headers = headers;
     }
 
+    /**
+     * loginURL is a URL to redirect unauthenticated /authorize requests to Unauthenticated requests from OAuth clients which expect interactive logins will be redirected here ${url} is replaced with the current URL, escaped to be safe in a query parameter<br><p>   https://www.example.com/sso-login?then=${url}<br><p> ${query} is replaced with the current query string<br><p>   https://www.example.com/auth-proxy/oauth/authorize?${query}<br><p> Required when login is set to true.
+     */
     @JsonProperty("loginURL")
     public String getLoginURL() {
         return loginURL;
     }
 
+    /**
+     * loginURL is a URL to redirect unauthenticated /authorize requests to Unauthenticated requests from OAuth clients which expect interactive logins will be redirected here ${url} is replaced with the current URL, escaped to be safe in a query parameter<br><p>   https://www.example.com/sso-login?then=${url}<br><p> ${query} is replaced with the current query string<br><p>   https://www.example.com/auth-proxy/oauth/authorize?${query}<br><p> Required when login is set to true.
+     */
     @JsonProperty("loginURL")
     public void setLoginURL(String loginURL) {
         this.loginURL = loginURL;
     }
 
+    /**
+     * nameHeaders is the set of headers to check for the display name
+     */
     @JsonProperty("nameHeaders")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNameHeaders() {
         return nameHeaders;
     }
 
+    /**
+     * nameHeaders is the set of headers to check for the display name
+     */
     @JsonProperty("nameHeaders")
     public void setNameHeaders(List<String> nameHeaders) {
         this.nameHeaders = nameHeaders;
     }
 
+    /**
+     * preferredUsernameHeaders is the set of headers to check for the preferred username
+     */
     @JsonProperty("preferredUsernameHeaders")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPreferredUsernameHeaders() {
         return preferredUsernameHeaders;
     }
 
+    /**
+     * preferredUsernameHeaders is the set of headers to check for the preferred username
+     */
     @JsonProperty("preferredUsernameHeaders")
     public void setPreferredUsernameHeaders(List<String> preferredUsernameHeaders) {
         this.preferredUsernameHeaders = preferredUsernameHeaders;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/RequiredHSTSPolicy.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/RequiredHSTSPolicy.java
index e5b53768cfd..e12ffdbb5fd 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/RequiredHSTSPolicy.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/RequiredHSTSPolicy.java
@@ -97,22 +97,34 @@ public RequiredHSTSPolicy(List<String> domainPatterns, String includeSubDomainsP
         this.preloadPolicy = preloadPolicy;
     }
 
+    /**
+     * domainPatterns is a list of domains for which the desired HSTS annotations are required. If domainPatterns is specified and a route is created with a spec.host matching one of the domains, the route must specify the HSTS Policy components described in the matching RequiredHSTSPolicy.<br><p> <br><p> The use of wildcards is allowed like this: &#42;.foo.com matches everything under foo.com. foo.com only matches foo.com, so to cover foo.com and everything under it, you must specify &#42;both&#42;.
+     */
     @JsonProperty("domainPatterns")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDomainPatterns() {
         return domainPatterns;
     }
 
+    /**
+     * domainPatterns is a list of domains for which the desired HSTS annotations are required. If domainPatterns is specified and a route is created with a spec.host matching one of the domains, the route must specify the HSTS Policy components described in the matching RequiredHSTSPolicy.<br><p> <br><p> The use of wildcards is allowed like this: &#42;.foo.com matches everything under foo.com. foo.com only matches foo.com, so to cover foo.com and everything under it, you must specify &#42;both&#42;.
+     */
     @JsonProperty("domainPatterns")
     public void setDomainPatterns(List<String> domainPatterns) {
         this.domainPatterns = domainPatterns;
     }
 
+    /**
+     * includeSubDomainsPolicy means the HSTS Policy should apply to any subdomains of the host's domain name.  Thus, for the host bar.foo.com, if includeSubDomainsPolicy was set to RequireIncludeSubDomains: - the host app.bar.foo.com would inherit the HSTS Policy of bar.foo.com - the host bar.foo.com would inherit the HSTS Policy of bar.foo.com - the host foo.com would NOT inherit the HSTS Policy of bar.foo.com - the host def.foo.com would NOT inherit the HSTS Policy of bar.foo.com
+     */
     @JsonProperty("includeSubDomainsPolicy")
     public String getIncludeSubDomainsPolicy() {
         return includeSubDomainsPolicy;
     }
 
+    /**
+     * includeSubDomainsPolicy means the HSTS Policy should apply to any subdomains of the host's domain name.  Thus, for the host bar.foo.com, if includeSubDomainsPolicy was set to RequireIncludeSubDomains: - the host app.bar.foo.com would inherit the HSTS Policy of bar.foo.com - the host bar.foo.com would inherit the HSTS Policy of bar.foo.com - the host foo.com would NOT inherit the HSTS Policy of bar.foo.com - the host def.foo.com would NOT inherit the HSTS Policy of bar.foo.com
+     */
     @JsonProperty("includeSubDomainsPolicy")
     public void setIncludeSubDomainsPolicy(String includeSubDomainsPolicy) {
         this.includeSubDomainsPolicy = includeSubDomainsPolicy;
@@ -138,11 +150,17 @@ public void setNamespaceSelector(LabelSelector namespaceSelector) {
         this.namespaceSelector = namespaceSelector;
     }
 
+    /**
+     * preloadPolicy directs the client to include hosts in its host preload list so that it never needs to do an initial load to get the HSTS header (note that this is not defined in RFC 6797 and is therefore client implementation-dependent).
+     */
     @JsonProperty("preloadPolicy")
     public String getPreloadPolicy() {
         return preloadPolicy;
     }
 
+    /**
+     * preloadPolicy directs the client to include hosts in its host preload list so that it never needs to do an initial load to get the HSTS header (note that this is not defined in RFC 6797 and is therefore client implementation-dependent).
+     */
     @JsonProperty("preloadPolicy")
     public void setPreloadPolicy(String preloadPolicy) {
         this.preloadPolicy = preloadPolicy;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Scheduler.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Scheduler.java
index 37518e3c79b..a24e4d6b167 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Scheduler.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Scheduler.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Scheduler holds cluster-wide config information to run the Kubernetes Scheduler and influence its placement decisions. The canonical name for this config is `cluster`.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Scheduler implements Editable<SchedulerBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Scheduler";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public Scheduler(String apiVersion, String kind, ObjectMeta metadata, SchedulerS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Scheduler holds cluster-wide config information to run the Kubernetes Scheduler and influence its placement decisions. The canonical name for this config is `cluster`.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Scheduler holds cluster-wide config information to run the Kubernetes Scheduler and influence its placement decisions. The canonical name for this config is `cluster`.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Scheduler holds cluster-wide config information to run the Kubernetes Scheduler and influence its placement decisions. The canonical name for this config is `cluster`.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public SchedulerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Scheduler holds cluster-wide config information to run the Kubernetes Scheduler and influence its placement decisions. The canonical name for this config is `cluster`.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(SchedulerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Scheduler holds cluster-wide config information to run the Kubernetes Scheduler and influence its placement decisions. The canonical name for this config is `cluster`.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public SchedulerStatus getStatus() {
         return status;
     }
 
+    /**
+     * Scheduler holds cluster-wide config information to run the Kubernetes Scheduler and influence its placement decisions. The canonical name for this config is `cluster`.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(SchedulerStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/SchedulerList.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/SchedulerList.java
index 449f7d08b80..3508dcb4764 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/SchedulerList.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/SchedulerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class SchedulerList implements Editable<SchedulerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.config.v1.Scheduler>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.config.v1.Scheduler> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SchedulerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public SchedulerList(String apiVersion, List<io.fabric8.openshift.api.model.conf
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.config.v1.Scheduler> getItems() {
         return items;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.config.v1.Scheduler> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/SchedulerSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/SchedulerSpec.java
index 390d5044b13..cb2ce225bde 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/SchedulerSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/SchedulerSpec.java
@@ -94,21 +94,33 @@ public SchedulerSpec(String defaultNodeSelector, Boolean mastersSchedulable, Con
         this.profileCustomizations = profileCustomizations;
     }
 
+    /**
+     * defaultNodeSelector helps set the cluster-wide default node selector to restrict pod placement to specific nodes. This is applied to the pods created in all namespaces and creates an intersection with any existing nodeSelectors already set on a pod, additionally constraining that pod's selector. For example, defaultNodeSelector: "type=user-node,region=east" would set nodeSelector field in pod spec to "type=user-node,region=east" to all pods created in all namespaces. Namespaces having project-wide node selectors won't be impacted even if this field is set. This adds an annotation section to the namespace. For example, if a new namespace is created with node-selector='type=user-node,region=east', the annotation openshift.io/node-selector: type=user-node,region=east gets added to the project. When the openshift.io/node-selector annotation is set on the project the value is used in preference to the value we are setting for defaultNodeSelector field. For instance, openshift.io/node-selector: "type=user-node,region=west" means that the default of "type=user-node,region=east" set in defaultNodeSelector would not be applied.
+     */
     @JsonProperty("defaultNodeSelector")
     public String getDefaultNodeSelector() {
         return defaultNodeSelector;
     }
 
+    /**
+     * defaultNodeSelector helps set the cluster-wide default node selector to restrict pod placement to specific nodes. This is applied to the pods created in all namespaces and creates an intersection with any existing nodeSelectors already set on a pod, additionally constraining that pod's selector. For example, defaultNodeSelector: "type=user-node,region=east" would set nodeSelector field in pod spec to "type=user-node,region=east" to all pods created in all namespaces. Namespaces having project-wide node selectors won't be impacted even if this field is set. This adds an annotation section to the namespace. For example, if a new namespace is created with node-selector='type=user-node,region=east', the annotation openshift.io/node-selector: type=user-node,region=east gets added to the project. When the openshift.io/node-selector annotation is set on the project the value is used in preference to the value we are setting for defaultNodeSelector field. For instance, openshift.io/node-selector: "type=user-node,region=west" means that the default of "type=user-node,region=east" set in defaultNodeSelector would not be applied.
+     */
     @JsonProperty("defaultNodeSelector")
     public void setDefaultNodeSelector(String defaultNodeSelector) {
         this.defaultNodeSelector = defaultNodeSelector;
     }
 
+    /**
+     * MastersSchedulable allows masters nodes to be schedulable. When this flag is turned on, all the master nodes in the cluster will be made schedulable, so that workload pods can run on them. The default value for this field is false, meaning none of the master nodes are schedulable. Important Note: Once the workload pods start running on the master nodes, extreme care must be taken to ensure that cluster-critical control plane components are not impacted. Please turn on this field after doing due diligence.
+     */
     @JsonProperty("mastersSchedulable")
     public Boolean getMastersSchedulable() {
         return mastersSchedulable;
     }
 
+    /**
+     * MastersSchedulable allows masters nodes to be schedulable. When this flag is turned on, all the master nodes in the cluster will be made schedulable, so that workload pods can run on them. The default value for this field is false, meaning none of the master nodes are schedulable. Important Note: Once the workload pods start running on the master nodes, extreme care must be taken to ensure that cluster-critical control plane components are not impacted. Please turn on this field after doing due diligence.
+     */
     @JsonProperty("mastersSchedulable")
     public void setMastersSchedulable(Boolean mastersSchedulable) {
         this.mastersSchedulable = mastersSchedulable;
@@ -124,11 +136,17 @@ public void setPolicy(ConfigMapNameReference policy) {
         this.policy = policy;
     }
 
+    /**
+     * profile sets which scheduling profile should be set in order to configure scheduling decisions for new pods.<br><p> <br><p> Valid values are "LowNodeUtilization", "HighNodeUtilization", "NoScoring" Defaults to "LowNodeUtilization"
+     */
     @JsonProperty("profile")
     public String getProfile() {
         return profile;
     }
 
+    /**
+     * profile sets which scheduling profile should be set in order to configure scheduling decisions for new pods.<br><p> <br><p> Valid values are "LowNodeUtilization", "HighNodeUtilization", "NoScoring" Defaults to "LowNodeUtilization"
+     */
     @JsonProperty("profile")
     public void setProfile(String profile) {
         this.profile = profile;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/SecretNameReference.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/SecretNameReference.java
index b8beb27d996..ecf3ce58fc9 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/SecretNameReference.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/SecretNameReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SecretNameReference references a secret in a specific namespace. The namespace must be specified at the point of use.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public SecretNameReference(String name) {
         this.name = name;
     }
 
+    /**
+     * name is the metadata.name of the referenced secret
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the metadata.name of the referenced secret
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ServingInfo.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ServingInfo.java
index 1a228bb6f07..de472ec4b39 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ServingInfo.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/ServingInfo.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServingInfo holds information about serving web pages
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -110,83 +113,131 @@ public ServingInfo(String bindAddress, String bindNetwork, String certFile, List
         this.namedCertificates = namedCertificates;
     }
 
+    /**
+     * BindAddress is the ip:port to serve on
+     */
     @JsonProperty("bindAddress")
     public String getBindAddress() {
         return bindAddress;
     }
 
+    /**
+     * BindAddress is the ip:port to serve on
+     */
     @JsonProperty("bindAddress")
     public void setBindAddress(String bindAddress) {
         this.bindAddress = bindAddress;
     }
 
+    /**
+     * BindNetwork is the type of network to bind to - defaults to "tcp4", accepts "tcp", "tcp4", and "tcp6"
+     */
     @JsonProperty("bindNetwork")
     public String getBindNetwork() {
         return bindNetwork;
     }
 
+    /**
+     * BindNetwork is the type of network to bind to - defaults to "tcp4", accepts "tcp", "tcp4", and "tcp6"
+     */
     @JsonProperty("bindNetwork")
     public void setBindNetwork(String bindNetwork) {
         this.bindNetwork = bindNetwork;
     }
 
+    /**
+     * CertFile is a file containing a PEM-encoded certificate
+     */
     @JsonProperty("certFile")
     public String getCertFile() {
         return certFile;
     }
 
+    /**
+     * CertFile is a file containing a PEM-encoded certificate
+     */
     @JsonProperty("certFile")
     public void setCertFile(String certFile) {
         this.certFile = certFile;
     }
 
+    /**
+     * CipherSuites contains an overridden list of ciphers for the server to support. Values must match cipher suite IDs from https://golang.org/pkg/crypto/tls/#pkg-constants
+     */
     @JsonProperty("cipherSuites")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCipherSuites() {
         return cipherSuites;
     }
 
+    /**
+     * CipherSuites contains an overridden list of ciphers for the server to support. Values must match cipher suite IDs from https://golang.org/pkg/crypto/tls/#pkg-constants
+     */
     @JsonProperty("cipherSuites")
     public void setCipherSuites(List<String> cipherSuites) {
         this.cipherSuites = cipherSuites;
     }
 
+    /**
+     * ClientCA is the certificate bundle for all the signers that you'll recognize for incoming client certificates
+     */
     @JsonProperty("clientCA")
     public String getClientCA() {
         return clientCA;
     }
 
+    /**
+     * ClientCA is the certificate bundle for all the signers that you'll recognize for incoming client certificates
+     */
     @JsonProperty("clientCA")
     public void setClientCA(String clientCA) {
         this.clientCA = clientCA;
     }
 
+    /**
+     * KeyFile is a file containing a PEM-encoded private key for the certificate specified by CertFile
+     */
     @JsonProperty("keyFile")
     public String getKeyFile() {
         return keyFile;
     }
 
+    /**
+     * KeyFile is a file containing a PEM-encoded private key for the certificate specified by CertFile
+     */
     @JsonProperty("keyFile")
     public void setKeyFile(String keyFile) {
         this.keyFile = keyFile;
     }
 
+    /**
+     * MinTLSVersion is the minimum TLS version supported. Values must match version names from https://golang.org/pkg/crypto/tls/#pkg-constants
+     */
     @JsonProperty("minTLSVersion")
     public String getMinTLSVersion() {
         return minTLSVersion;
     }
 
+    /**
+     * MinTLSVersion is the minimum TLS version supported. Values must match version names from https://golang.org/pkg/crypto/tls/#pkg-constants
+     */
     @JsonProperty("minTLSVersion")
     public void setMinTLSVersion(String minTLSVersion) {
         this.minTLSVersion = minTLSVersion;
     }
 
+    /**
+     * NamedCertificates is a list of certificates to use to secure requests to specific hostnames
+     */
     @JsonProperty("namedCertificates")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NamedCertificate> getNamedCertificates() {
         return namedCertificates;
     }
 
+    /**
+     * NamedCertificates is a list of certificates to use to secure requests to specific hostnames
+     */
     @JsonProperty("namedCertificates")
     public void setNamedCertificates(List<NamedCertificate> namedCertificates) {
         this.namedCertificates = namedCertificates;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/SignatureStore.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/SignatureStore.java
index 59cd5300eec..98a2afa3461 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/SignatureStore.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/SignatureStore.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SignatureStore represents the URL of custom Signature Store
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public SignatureStore(ConfigMapNameReference ca, String url) {
         this.url = url;
     }
 
+    /**
+     * SignatureStore represents the URL of custom Signature Store
+     */
     @JsonProperty("ca")
     public ConfigMapNameReference getCa() {
         return ca;
     }
 
+    /**
+     * SignatureStore represents the URL of custom Signature Store
+     */
     @JsonProperty("ca")
     public void setCa(ConfigMapNameReference ca) {
         this.ca = ca;
     }
 
+    /**
+     * url contains the upstream custom signature store URL. url should be a valid absolute http/https URI of an upstream signature store as per rfc1738. This must be provided and cannot be empty.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * url contains the upstream custom signature store URL. url should be a valid absolute http/https URI of an upstream signature store as per rfc1738. This must be provided and cannot be empty.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/StringSource.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/StringSource.java
index d4d97fd3e39..a58b29a3393 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/StringSource.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/StringSource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StringSource allows specifying a string inline, or externally via env var or file. When it contains only a string value, it marshals to a simple JSON string.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public StringSource(String env, String file, String keyFile, String value) {
         this.value = value;
     }
 
+    /**
+     * Env specifies an envvar containing the cleartext value, or an encrypted value if the keyFile is specified.
+     */
     @JsonProperty("env")
     public String getEnv() {
         return env;
     }
 
+    /**
+     * Env specifies an envvar containing the cleartext value, or an encrypted value if the keyFile is specified.
+     */
     @JsonProperty("env")
     public void setEnv(String env) {
         this.env = env;
     }
 
+    /**
+     * File references a file containing the cleartext value, or an encrypted value if a keyFile is specified.
+     */
     @JsonProperty("file")
     public String getFile() {
         return file;
     }
 
+    /**
+     * File references a file containing the cleartext value, or an encrypted value if a keyFile is specified.
+     */
     @JsonProperty("file")
     public void setFile(String file) {
         this.file = file;
     }
 
+    /**
+     * KeyFile references a file containing the key to use to decrypt the value.
+     */
     @JsonProperty("keyFile")
     public String getKeyFile() {
         return keyFile;
     }
 
+    /**
+     * KeyFile references a file containing the key to use to decrypt the value.
+     */
     @JsonProperty("keyFile")
     public void setKeyFile(String keyFile) {
         this.keyFile = keyFile;
     }
 
+    /**
+     * Value specifies the cleartext value, or an encrypted value if keyFile is specified.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value specifies the cleartext value, or an encrypted value if keyFile is specified.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/StringSourceSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/StringSourceSpec.java
index efcfb5f14ca..46423663fc9 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/StringSourceSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/StringSourceSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StringSourceSpec specifies a string value, or external location
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public StringSourceSpec(String env, String file, String keyFile, String value) {
         this.value = value;
     }
 
+    /**
+     * Env specifies an envvar containing the cleartext value, or an encrypted value if the keyFile is specified.
+     */
     @JsonProperty("env")
     public String getEnv() {
         return env;
     }
 
+    /**
+     * Env specifies an envvar containing the cleartext value, or an encrypted value if the keyFile is specified.
+     */
     @JsonProperty("env")
     public void setEnv(String env) {
         this.env = env;
     }
 
+    /**
+     * File references a file containing the cleartext value, or an encrypted value if a keyFile is specified.
+     */
     @JsonProperty("file")
     public String getFile() {
         return file;
     }
 
+    /**
+     * File references a file containing the cleartext value, or an encrypted value if a keyFile is specified.
+     */
     @JsonProperty("file")
     public void setFile(String file) {
         this.file = file;
     }
 
+    /**
+     * KeyFile references a file containing the key to use to decrypt the value.
+     */
     @JsonProperty("keyFile")
     public String getKeyFile() {
         return keyFile;
     }
 
+    /**
+     * KeyFile references a file containing the key to use to decrypt the value.
+     */
     @JsonProperty("keyFile")
     public void setKeyFile(String keyFile) {
         this.keyFile = keyFile;
     }
 
+    /**
+     * Value specifies the cleartext value, or an encrypted value if keyFile is specified.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value specifies the cleartext value, or an encrypted value if keyFile is specified.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TLSProfileSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TLSProfileSpec.java
index bd7274726c5..48d29a7a19d 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TLSProfileSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TLSProfileSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TLSProfileSpec is the desired behavior of a TLSSecurityProfile.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public TLSProfileSpec(List<String> ciphers, String minTLSVersion) {
         this.minTLSVersion = minTLSVersion;
     }
 
+    /**
+     * ciphers is used to specify the cipher algorithms that are negotiated during the TLS handshake.  Operators may remove entries their operands do not support.  For example, to use DES-CBC3-SHA  (yaml):<br><p> <br><p>   ciphers:<br><p>     - DES-CBC3-SHA
+     */
     @JsonProperty("ciphers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCiphers() {
         return ciphers;
     }
 
+    /**
+     * ciphers is used to specify the cipher algorithms that are negotiated during the TLS handshake.  Operators may remove entries their operands do not support.  For example, to use DES-CBC3-SHA  (yaml):<br><p> <br><p>   ciphers:<br><p>     - DES-CBC3-SHA
+     */
     @JsonProperty("ciphers")
     public void setCiphers(List<String> ciphers) {
         this.ciphers = ciphers;
     }
 
+    /**
+     * minTLSVersion is used to specify the minimal version of the TLS protocol that is negotiated during the TLS handshake. For example, to use TLS versions 1.1, 1.2 and 1.3 (yaml):<br><p> <br><p>   minTLSVersion: VersionTLS11<br><p> <br><p> NOTE: currently the highest minTLSVersion allowed is VersionTLS12
+     */
     @JsonProperty("minTLSVersion")
     public String getMinTLSVersion() {
         return minTLSVersion;
     }
 
+    /**
+     * minTLSVersion is used to specify the minimal version of the TLS protocol that is negotiated during the TLS handshake. For example, to use TLS versions 1.1, 1.2 and 1.3 (yaml):<br><p> <br><p>   minTLSVersion: VersionTLS11<br><p> <br><p> NOTE: currently the highest minTLSVersion allowed is VersionTLS12
+     */
     @JsonProperty("minTLSVersion")
     public void setMinTLSVersion(String minTLSVersion) {
         this.minTLSVersion = minTLSVersion;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TLSSecurityProfile.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TLSSecurityProfile.java
index 0dfadbc48dc..aebec89727a 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TLSSecurityProfile.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TLSSecurityProfile.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TLSSecurityProfile defines the schema for a TLS security profile. This object is used by operators to apply TLS security settings to operands.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public TLSSecurityProfile(CustomTLSProfile custom, IntermediateTLSProfile interm
         this.type = type;
     }
 
+    /**
+     * TLSSecurityProfile defines the schema for a TLS security profile. This object is used by operators to apply TLS security settings to operands.
+     */
     @JsonProperty("custom")
     public CustomTLSProfile getCustom() {
         return custom;
     }
 
+    /**
+     * TLSSecurityProfile defines the schema for a TLS security profile. This object is used by operators to apply TLS security settings to operands.
+     */
     @JsonProperty("custom")
     public void setCustom(CustomTLSProfile custom) {
         this.custom = custom;
     }
 
+    /**
+     * TLSSecurityProfile defines the schema for a TLS security profile. This object is used by operators to apply TLS security settings to operands.
+     */
     @JsonProperty("intermediate")
     public IntermediateTLSProfile getIntermediate() {
         return intermediate;
     }
 
+    /**
+     * TLSSecurityProfile defines the schema for a TLS security profile. This object is used by operators to apply TLS security settings to operands.
+     */
     @JsonProperty("intermediate")
     public void setIntermediate(IntermediateTLSProfile intermediate) {
         this.intermediate = intermediate;
     }
 
+    /**
+     * TLSSecurityProfile defines the schema for a TLS security profile. This object is used by operators to apply TLS security settings to operands.
+     */
     @JsonProperty("modern")
     public ModernTLSProfile getModern() {
         return modern;
     }
 
+    /**
+     * TLSSecurityProfile defines the schema for a TLS security profile. This object is used by operators to apply TLS security settings to operands.
+     */
     @JsonProperty("modern")
     public void setModern(ModernTLSProfile modern) {
         this.modern = modern;
     }
 
+    /**
+     * TLSSecurityProfile defines the schema for a TLS security profile. This object is used by operators to apply TLS security settings to operands.
+     */
     @JsonProperty("old")
     public OldTLSProfile getOld() {
         return old;
     }
 
+    /**
+     * TLSSecurityProfile defines the schema for a TLS security profile. This object is used by operators to apply TLS security settings to operands.
+     */
     @JsonProperty("old")
     public void setOld(OldTLSProfile old) {
         this.old = old;
     }
 
+    /**
+     * type is one of Old, Intermediate, Modern or Custom. Custom provides the ability to specify individual TLS security profile parameters. Old, Intermediate and Modern are TLS security profiles based on:<br><p> <br><p> https://wiki.mozilla.org/Security/Server_Side_TLS#Recommended_configurations<br><p> <br><p> The profiles are intent based, so they may change over time as new ciphers are developed and existing ciphers are found to be insecure.  Depending on precisely which ciphers are available to a process, the list may be reduced.<br><p> <br><p> Note that the Modern profile is currently not supported because it is not yet well adopted by common software libraries.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is one of Old, Intermediate, Modern or Custom. Custom provides the ability to specify individual TLS security profile parameters. Old, Intermediate and Modern are TLS security profiles based on:<br><p> <br><p> https://wiki.mozilla.org/Security/Server_Side_TLS#Recommended_configurations<br><p> <br><p> The profiles are intent based, so they may change over time as new ciphers are developed and existing ciphers are found to be insecure.  Depending on precisely which ciphers are available to a process, the list may be reduced.<br><p> <br><p> Note that the Modern profile is currently not supported because it is not yet well adopted by common software libraries.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TemplateReference.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TemplateReference.java
index 348e7963cbd..f3c6db8d7ed 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TemplateReference.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TemplateReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TemplateReference references a template in a specific namespace. The namespace must be specified at the point of use.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public TemplateReference(String name) {
         this.name = name;
     }
 
+    /**
+     * name is the metadata.name of the referenced project request template
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the metadata.name of the referenced project request template
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TestDetails.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TestDetails.java
index 23029a033cf..ab814419e2e 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TestDetails.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TestDetails.java
@@ -78,11 +78,17 @@ public TestDetails(String testName) {
         this.testName = testName;
     }
 
+    /**
+     * TestName is the name of the test as it appears in junit XMLs. It does not include the suite name since the same test can be executed in many suites.
+     */
     @JsonProperty("testName")
     public String getTestName() {
         return testName;
     }
 
+    /**
+     * TestName is the name of the test as it appears in junit XMLs. It does not include the suite name since the same test can be executed in many suites.
+     */
     @JsonProperty("testName")
     public void setTestName(String testName) {
         this.testName = testName;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TestReporting.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TestReporting.java
index ad43fdcb5a6..9e6dece5c47 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TestReporting.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TestReporting.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TestReporting is used for origin (and potentially others) to report the test names for a given FeatureGate into the payload for later analysis on a per-payload basis. This doesn't need any CRD because it's never stored in the cluster.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class TestReporting implements Editable<TestReportingBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "config.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TestReporting";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TestReporting(String apiVersion, String kind, ObjectMeta metadata, TestRe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TestReporting is used for origin (and potentially others) to report the test names for a given FeatureGate into the payload for later analysis on a per-payload basis. This doesn't need any CRD because it's never stored in the cluster.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TestReporting is used for origin (and potentially others) to report the test names for a given FeatureGate into the payload for later analysis on a per-payload basis. This doesn't need any CRD because it's never stored in the cluster.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * TestReporting is used for origin (and potentially others) to report the test names for a given FeatureGate into the payload for later analysis on a per-payload basis. This doesn't need any CRD because it's never stored in the cluster.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("spec")
     public TestReportingSpec getSpec() {
         return spec;
     }
 
+    /**
+     * TestReporting is used for origin (and potentially others) to report the test names for a given FeatureGate into the payload for later analysis on a per-payload basis. This doesn't need any CRD because it's never stored in the cluster.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("spec")
     public void setSpec(TestReportingSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * TestReporting is used for origin (and potentially others) to report the test names for a given FeatureGate into the payload for later analysis on a per-payload basis. This doesn't need any CRD because it's never stored in the cluster.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("status")
     public TestReportingStatus getStatus() {
         return status;
     }
 
+    /**
+     * TestReporting is used for origin (and potentially others) to report the test names for a given FeatureGate into the payload for later analysis on a per-payload basis. This doesn't need any CRD because it's never stored in the cluster.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("status")
     public void setStatus(TestReportingStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TestReportingSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TestReportingSpec.java
index 6b41829595e..3bbb47aeff1 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TestReportingSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TestReportingSpec.java
@@ -81,12 +81,18 @@ public TestReportingSpec(List<FeatureGateTests> testsForFeatureGates) {
         this.testsForFeatureGates = testsForFeatureGates;
     }
 
+    /**
+     * TestsForFeatureGates is a list, indexed by FeatureGate and includes information about testing.
+     */
     @JsonProperty("testsForFeatureGates")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<FeatureGateTests> getTestsForFeatureGates() {
         return testsForFeatureGates;
     }
 
+    /**
+     * TestsForFeatureGates is a list, indexed by FeatureGate and includes information about testing.
+     */
     @JsonProperty("testsForFeatureGates")
     public void setTestsForFeatureGates(List<FeatureGateTests> testsForFeatureGates) {
         this.testsForFeatureGates = testsForFeatureGates;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TokenClaimMapping.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TokenClaimMapping.java
index 1be409b0140..e1a34dd1eef 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TokenClaimMapping.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TokenClaimMapping.java
@@ -78,11 +78,17 @@ public TokenClaimMapping(String claim) {
         this.claim = claim;
     }
 
+    /**
+     * Claim is a JWT token claim to be used in the mapping
+     */
     @JsonProperty("claim")
     public String getClaim() {
         return claim;
     }
 
+    /**
+     * Claim is a JWT token claim to be used in the mapping
+     */
     @JsonProperty("claim")
     public void setClaim(String claim) {
         this.claim = claim;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TokenClaimValidationRule.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TokenClaimValidationRule.java
index f70e0b16e39..e57f65c3613 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TokenClaimValidationRule.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TokenClaimValidationRule.java
@@ -92,11 +92,17 @@ public void setRequiredClaim(TokenRequiredClaim requiredClaim) {
         this.requiredClaim = requiredClaim;
     }
 
+    /**
+     * Type sets the type of the validation rule
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type sets the type of the validation rule
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TokenConfig.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TokenConfig.java
index caae646be42..f66d96f21f7 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TokenConfig.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TokenConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TokenConfig holds the necessary configuration options for authorization and access tokens
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public TokenConfig(String accessTokenInactivityTimeout, Integer accessTokenInact
         this.accessTokenMaxAgeSeconds = accessTokenMaxAgeSeconds;
     }
 
+    /**
+     * TokenConfig holds the necessary configuration options for authorization and access tokens
+     */
     @JsonProperty("accessTokenInactivityTimeout")
     public String getAccessTokenInactivityTimeout() {
         return accessTokenInactivityTimeout;
     }
 
+    /**
+     * TokenConfig holds the necessary configuration options for authorization and access tokens
+     */
     @JsonProperty("accessTokenInactivityTimeout")
     public void setAccessTokenInactivityTimeout(String accessTokenInactivityTimeout) {
         this.accessTokenInactivityTimeout = accessTokenInactivityTimeout;
     }
 
+    /**
+     * accessTokenInactivityTimeoutSeconds - DEPRECATED: setting this field has no effect.
+     */
     @JsonProperty("accessTokenInactivityTimeoutSeconds")
     public Integer getAccessTokenInactivityTimeoutSeconds() {
         return accessTokenInactivityTimeoutSeconds;
     }
 
+    /**
+     * accessTokenInactivityTimeoutSeconds - DEPRECATED: setting this field has no effect.
+     */
     @JsonProperty("accessTokenInactivityTimeoutSeconds")
     public void setAccessTokenInactivityTimeoutSeconds(Integer accessTokenInactivityTimeoutSeconds) {
         this.accessTokenInactivityTimeoutSeconds = accessTokenInactivityTimeoutSeconds;
     }
 
+    /**
+     * accessTokenMaxAgeSeconds defines the maximum age of access tokens
+     */
     @JsonProperty("accessTokenMaxAgeSeconds")
     public Integer getAccessTokenMaxAgeSeconds() {
         return accessTokenMaxAgeSeconds;
     }
 
+    /**
+     * accessTokenMaxAgeSeconds defines the maximum age of access tokens
+     */
     @JsonProperty("accessTokenMaxAgeSeconds")
     public void setAccessTokenMaxAgeSeconds(Integer accessTokenMaxAgeSeconds) {
         this.accessTokenMaxAgeSeconds = accessTokenMaxAgeSeconds;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TokenIssuer.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TokenIssuer.java
index 39571e6b9d0..727053dd268 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TokenIssuer.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TokenIssuer.java
@@ -89,12 +89,18 @@ public TokenIssuer(List<String> audiences, ConfigMapNameReference issuerCertific
         this.issuerURL = issuerURL;
     }
 
+    /**
+     * Audiences is an array of audiences that the token was issued for. Valid tokens must include at least one of these values in their "aud" claim. Must be set to exactly one value.
+     */
     @JsonProperty("audiences")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAudiences() {
         return audiences;
     }
 
+    /**
+     * Audiences is an array of audiences that the token was issued for. Valid tokens must include at least one of these values in their "aud" claim. Must be set to exactly one value.
+     */
     @JsonProperty("audiences")
     public void setAudiences(List<String> audiences) {
         this.audiences = audiences;
@@ -110,11 +116,17 @@ public void setIssuerCertificateAuthority(ConfigMapNameReference issuerCertifica
         this.issuerCertificateAuthority = issuerCertificateAuthority;
     }
 
+    /**
+     * URL is the serving URL of the token issuer. Must use the https:// scheme.
+     */
     @JsonProperty("issuerURL")
     public String getIssuerURL() {
         return issuerURL;
     }
 
+    /**
+     * URL is the serving URL of the token issuer. Must use the https:// scheme.
+     */
     @JsonProperty("issuerURL")
     public void setIssuerURL(String issuerURL) {
         this.issuerURL = issuerURL;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TokenRequiredClaim.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TokenRequiredClaim.java
index d3c66739d87..202224c111b 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TokenRequiredClaim.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/TokenRequiredClaim.java
@@ -82,21 +82,33 @@ public TokenRequiredClaim(String claim, String requiredValue) {
         this.requiredValue = requiredValue;
     }
 
+    /**
+     * Claim is a name of a required claim. Only claims with string values are supported.
+     */
     @JsonProperty("claim")
     public String getClaim() {
         return claim;
     }
 
+    /**
+     * Claim is a name of a required claim. Only claims with string values are supported.
+     */
     @JsonProperty("claim")
     public void setClaim(String claim) {
         this.claim = claim;
     }
 
+    /**
+     * RequiredValue is the required value for the claim.
+     */
     @JsonProperty("requiredValue")
     public String getRequiredValue() {
         return requiredValue;
     }
 
+    /**
+     * RequiredValue is the required value for the claim.
+     */
     @JsonProperty("requiredValue")
     public void setRequiredValue(String requiredValue) {
         this.requiredValue = requiredValue;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Update.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Update.java
index 7b8c2a8dfba..b68267ac92a 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Update.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/Update.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Update represents an administrator update request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public Update(String architecture, Boolean force, String image, String version)
         this.version = version;
     }
 
+    /**
+     * architecture is an optional field that indicates the desired value of the cluster architecture. In this context cluster architecture means either a single architecture or a multi architecture. architecture can only be set to Multi thereby only allowing updates from single to multi architecture. If architecture is set, image cannot be set and version must be set. Valid values are 'Multi' and empty.
+     */
     @JsonProperty("architecture")
     public String getArchitecture() {
         return architecture;
     }
 
+    /**
+     * architecture is an optional field that indicates the desired value of the cluster architecture. In this context cluster architecture means either a single architecture or a multi architecture. architecture can only be set to Multi thereby only allowing updates from single to multi architecture. If architecture is set, image cannot be set and version must be set. Valid values are 'Multi' and empty.
+     */
     @JsonProperty("architecture")
     public void setArchitecture(String architecture) {
         this.architecture = architecture;
     }
 
+    /**
+     * force allows an administrator to update to an image that has failed verification or upgradeable checks. This option should only be used when the authenticity of the provided image has been verified out of band because the provided image will run with full administrative access to the cluster. Do not use this flag with images that comes from unknown or potentially malicious sources.
+     */
     @JsonProperty("force")
     public Boolean getForce() {
         return force;
     }
 
+    /**
+     * force allows an administrator to update to an image that has failed verification or upgradeable checks. This option should only be used when the authenticity of the provided image has been verified out of band because the provided image will run with full administrative access to the cluster. Do not use this flag with images that comes from unknown or potentially malicious sources.
+     */
     @JsonProperty("force")
     public void setForce(Boolean force) {
         this.force = force;
     }
 
+    /**
+     * image is a container image location that contains the update. image should be used when the desired version does not exist in availableUpdates or history. When image is set, version is ignored. When image is set, version should be empty. When image is set, architecture cannot be specified.
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * image is a container image location that contains the update. image should be used when the desired version does not exist in availableUpdates or history. When image is set, version is ignored. When image is set, version should be empty. When image is set, architecture cannot be specified.
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
     }
 
+    /**
+     * version is a semantic version identifying the update version. version is ignored if image is specified and required if architecture is specified.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is a semantic version identifying the update version. version is ignored if image is specified and required if architecture is specified.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/UpdateHistory.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/UpdateHistory.java
index 07459d00a6e..f9467df396c 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/UpdateHistory.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/UpdateHistory.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UpdateHistory is a single attempted update to the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,71 +105,113 @@ public UpdateHistory(String acceptedRisks, String completionTime, String image,
         this.version = version;
     }
 
+    /**
+     * acceptedRisks records risks which were accepted to initiate the update. For example, it may menition an Upgradeable=False or missing signature that was overriden via desiredUpdate.force, or an update that was initiated despite not being in the availableUpdates set of recommended update targets.
+     */
     @JsonProperty("acceptedRisks")
     public String getAcceptedRisks() {
         return acceptedRisks;
     }
 
+    /**
+     * acceptedRisks records risks which were accepted to initiate the update. For example, it may menition an Upgradeable=False or missing signature that was overriden via desiredUpdate.force, or an update that was initiated despite not being in the availableUpdates set of recommended update targets.
+     */
     @JsonProperty("acceptedRisks")
     public void setAcceptedRisks(String acceptedRisks) {
         this.acceptedRisks = acceptedRisks;
     }
 
+    /**
+     * UpdateHistory is a single attempted update to the cluster.
+     */
     @JsonProperty("completionTime")
     public String getCompletionTime() {
         return completionTime;
     }
 
+    /**
+     * UpdateHistory is a single attempted update to the cluster.
+     */
     @JsonProperty("completionTime")
     public void setCompletionTime(String completionTime) {
         this.completionTime = completionTime;
     }
 
+    /**
+     * image is a container image location that contains the update. This value is always populated.
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * image is a container image location that contains the update. This value is always populated.
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
     }
 
+    /**
+     * UpdateHistory is a single attempted update to the cluster.
+     */
     @JsonProperty("startedTime")
     public String getStartedTime() {
         return startedTime;
     }
 
+    /**
+     * UpdateHistory is a single attempted update to the cluster.
+     */
     @JsonProperty("startedTime")
     public void setStartedTime(String startedTime) {
         this.startedTime = startedTime;
     }
 
+    /**
+     * state reflects whether the update was fully applied. The Partial state indicates the update is not fully applied, while the Completed state indicates the update was successfully rolled out at least once (all parts of the update successfully applied).
+     */
     @JsonProperty("state")
     public String getState() {
         return state;
     }
 
+    /**
+     * state reflects whether the update was fully applied. The Partial state indicates the update is not fully applied, while the Completed state indicates the update was successfully rolled out at least once (all parts of the update successfully applied).
+     */
     @JsonProperty("state")
     public void setState(String state) {
         this.state = state;
     }
 
+    /**
+     * verified indicates whether the provided update was properly verified before it was installed. If this is false the cluster may not be trusted. Verified does not cover upgradeable checks that depend on the cluster state at the time when the update target was accepted.
+     */
     @JsonProperty("verified")
     public Boolean getVerified() {
         return verified;
     }
 
+    /**
+     * verified indicates whether the provided update was properly verified before it was installed. If this is false the cluster may not be trusted. Verified does not cover upgradeable checks that depend on the cluster state at the time when the update target was accepted.
+     */
     @JsonProperty("verified")
     public void setVerified(Boolean verified) {
         this.verified = verified;
     }
 
+    /**
+     * version is a semantic version identifying the update version. If the requested image does not define a version, or if a failure occurs retrieving the image, this value may be empty.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is a semantic version identifying the update version. If the requested image does not define a version, or if a failure occurs retrieving the image, this value may be empty.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/UsernameClaimMapping.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/UsernameClaimMapping.java
index 607a344f17c..25764d5e17c 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/UsernameClaimMapping.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/UsernameClaimMapping.java
@@ -86,11 +86,17 @@ public UsernameClaimMapping(String claim, UsernamePrefix prefix, String prefixPo
         this.prefixPolicy = prefixPolicy;
     }
 
+    /**
+     * Claim is a JWT token claim to be used in the mapping
+     */
     @JsonProperty("claim")
     public String getClaim() {
         return claim;
     }
 
+    /**
+     * Claim is a JWT token claim to be used in the mapping
+     */
     @JsonProperty("claim")
     public void setClaim(String claim) {
         this.claim = claim;
@@ -106,11 +112,17 @@ public void setPrefix(UsernamePrefix prefix) {
         this.prefix = prefix;
     }
 
+    /**
+     * PrefixPolicy specifies how a prefix should apply.<br><p> <br><p> By default, claims other than `email` will be prefixed with the issuer URL to prevent naming clashes with other plugins.<br><p> <br><p> Set to "NoPrefix" to disable prefixing.<br><p> <br><p> Example:<br><p>     (1) `prefix` is set to "myoidc:" and `claim` is set to "username".<br><p>         If the JWT claim `username` contains value `userA`, the resulting<br><p>         mapped value will be "myoidc:userA".<br><p>     (2) `prefix` is set to "myoidc:" and `claim` is set to "email". If the<br><p>         JWT `email` claim contains value "userA@myoidc.tld", the resulting<br><p>         mapped value will be "myoidc:userA@myoidc.tld".<br><p>     (3) `prefix` is unset, `issuerURL` is set to `https://myoidc.tld`,<br><p>         the JWT claims include "username":"userA" and "email":"userA@myoidc.tld",<br><p>         and `claim` is set to:<br><p>         (a) "username": the mapped value will be "https://myoidc.tld#userA"<br><p>         (b) "email": the mapped value will be "userA@myoidc.tld"
+     */
     @JsonProperty("prefixPolicy")
     public String getPrefixPolicy() {
         return prefixPolicy;
     }
 
+    /**
+     * PrefixPolicy specifies how a prefix should apply.<br><p> <br><p> By default, claims other than `email` will be prefixed with the issuer URL to prevent naming clashes with other plugins.<br><p> <br><p> Set to "NoPrefix" to disable prefixing.<br><p> <br><p> Example:<br><p>     (1) `prefix` is set to "myoidc:" and `claim` is set to "username".<br><p>         If the JWT claim `username` contains value `userA`, the resulting<br><p>         mapped value will be "myoidc:userA".<br><p>     (2) `prefix` is set to "myoidc:" and `claim` is set to "email". If the<br><p>         JWT `email` claim contains value "userA@myoidc.tld", the resulting<br><p>         mapped value will be "myoidc:userA@myoidc.tld".<br><p>     (3) `prefix` is unset, `issuerURL` is set to `https://myoidc.tld`,<br><p>         the JWT claims include "username":"userA" and "email":"userA@myoidc.tld",<br><p>         and `claim` is set to:<br><p>         (a) "username": the mapped value will be "https://myoidc.tld#userA"<br><p>         (b) "email": the mapped value will be "userA@myoidc.tld"
+     */
     @JsonProperty("prefixPolicy")
     public void setPrefixPolicy(String prefixPolicy) {
         this.prefixPolicy = prefixPolicy;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformFailureDomainSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformFailureDomainSpec.java
index 75bf18ea319..1d41f1857f4 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformFailureDomainSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformFailureDomainSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VSpherePlatformFailureDomainSpec holds the region and zone failure domain and the vCenter topology of that failure domain.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public VSpherePlatformFailureDomainSpec(String name, String region, String serve
         this.zone = zone;
     }
 
+    /**
+     * name defines the arbitrary but unique name of a failure domain.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name defines the arbitrary but unique name of a failure domain.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * region defines the name of a region tag that will be attached to a vCenter datacenter. The tag category in vCenter must be named openshift-region.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * region defines the name of a region tag that will be attached to a vCenter datacenter. The tag category in vCenter must be named openshift-region.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * server is the fully-qualified domain name or the IP address of the vCenter server.
+     */
     @JsonProperty("server")
     public String getServer() {
         return server;
     }
 
+    /**
+     * server is the fully-qualified domain name or the IP address of the vCenter server.
+     */
     @JsonProperty("server")
     public void setServer(String server) {
         this.server = server;
     }
 
+    /**
+     * VSpherePlatformFailureDomainSpec holds the region and zone failure domain and the vCenter topology of that failure domain.
+     */
     @JsonProperty("topology")
     public VSpherePlatformTopology getTopology() {
         return topology;
     }
 
+    /**
+     * VSpherePlatformFailureDomainSpec holds the region and zone failure domain and the vCenter topology of that failure domain.
+     */
     @JsonProperty("topology")
     public void setTopology(VSpherePlatformTopology topology) {
         this.topology = topology;
     }
 
+    /**
+     * zone defines the name of a zone tag that will be attached to a vCenter cluster. The tag category in vCenter must be named openshift-zone.
+     */
     @JsonProperty("zone")
     public String getZone() {
         return zone;
     }
 
+    /**
+     * zone defines the name of a zone tag that will be attached to a vCenter cluster. The tag category in vCenter must be named openshift-zone.
+     */
     @JsonProperty("zone")
     public void setZone(String zone) {
         this.zone = zone;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformLoadBalancer.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformLoadBalancer.java
index b3b19ee5928..aeadd271d93 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformLoadBalancer.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformLoadBalancer.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VSpherePlatformLoadBalancer defines the load balancer used by the cluster on VSphere platform.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public VSpherePlatformLoadBalancer(String type) {
         this.type = type;
     }
 
+    /**
+     * type defines the type of load balancer used by the cluster on VSphere platform which can be a user-managed or openshift-managed load balancer that is to be used for the OpenShift API and Ingress endpoints. When set to OpenShiftManagedDefault the static pods in charge of API and Ingress traffic load-balancing defined in the machine config operator will be deployed. When set to UserManaged these static pods will not be deployed and it is expected that the load balancer is configured out of band by the deployer. When omitted, this means no opinion and the platform is left to choose a reasonable default. The default value is OpenShiftManagedDefault.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type defines the type of load balancer used by the cluster on VSphere platform which can be a user-managed or openshift-managed load balancer that is to be used for the OpenShift API and Ingress endpoints. When set to OpenShiftManagedDefault the static pods in charge of API and Ingress traffic load-balancing defined in the machine config operator will be deployed. When set to UserManaged these static pods will not be deployed and it is expected that the load balancer is configured out of band by the deployer. When omitted, this means no opinion and the platform is left to choose a reasonable default. The default value is OpenShiftManagedDefault.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformNodeNetworking.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformNodeNetworking.java
index 75ca6811a2b..82a258c4b61 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformNodeNetworking.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformNodeNetworking.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VSpherePlatformNodeNetworking holds the external and internal node networking spec.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public VSpherePlatformNodeNetworking(VSpherePlatformNodeNetworkingSpec external,
         this.internal = internal;
     }
 
+    /**
+     * VSpherePlatformNodeNetworking holds the external and internal node networking spec.
+     */
     @JsonProperty("external")
     public VSpherePlatformNodeNetworkingSpec getExternal() {
         return external;
     }
 
+    /**
+     * VSpherePlatformNodeNetworking holds the external and internal node networking spec.
+     */
     @JsonProperty("external")
     public void setExternal(VSpherePlatformNodeNetworkingSpec external) {
         this.external = external;
     }
 
+    /**
+     * VSpherePlatformNodeNetworking holds the external and internal node networking spec.
+     */
     @JsonProperty("internal")
     public VSpherePlatformNodeNetworkingSpec getInternal() {
         return internal;
     }
 
+    /**
+     * VSpherePlatformNodeNetworking holds the external and internal node networking spec.
+     */
     @JsonProperty("internal")
     public void setInternal(VSpherePlatformNodeNetworkingSpec internal) {
         this.internal = internal;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformNodeNetworkingSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformNodeNetworkingSpec.java
index 0aab25e025b..afbf7bef0a0 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformNodeNetworkingSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformNodeNetworkingSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VSpherePlatformNodeNetworkingSpec holds the network CIDR(s) and port group name for including and excluding IP ranges in the cloud provider. This would be used for example when multiple network adapters are attached to a guest to help determine which IP address the cloud config manager should use for the external and internal node networking.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public VSpherePlatformNodeNetworkingSpec(List<String> excludeNetworkSubnetCidr,
         this.networkSubnetCidr = networkSubnetCidr;
     }
 
+    /**
+     * excludeNetworkSubnetCidr IP addresses in subnet ranges will be excluded when selecting the IP address from the VirtualMachine's VM for use in the status.addresses fields.
+     */
     @JsonProperty("excludeNetworkSubnetCidr")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getExcludeNetworkSubnetCidr() {
         return excludeNetworkSubnetCidr;
     }
 
+    /**
+     * excludeNetworkSubnetCidr IP addresses in subnet ranges will be excluded when selecting the IP address from the VirtualMachine's VM for use in the status.addresses fields.
+     */
     @JsonProperty("excludeNetworkSubnetCidr")
     public void setExcludeNetworkSubnetCidr(List<String> excludeNetworkSubnetCidr) {
         this.excludeNetworkSubnetCidr = excludeNetworkSubnetCidr;
     }
 
+    /**
+     * network VirtualMachine's VM Network names that will be used to when searching for status.addresses fields. Note that if internal.networkSubnetCIDR and external.networkSubnetCIDR are not set, then the vNIC associated to this network must only have a single IP address assigned to it. The available networks (port groups) can be listed using `govc ls 'network/&#42;'`
+     */
     @JsonProperty("network")
     public String getNetwork() {
         return network;
     }
 
+    /**
+     * network VirtualMachine's VM Network names that will be used to when searching for status.addresses fields. Note that if internal.networkSubnetCIDR and external.networkSubnetCIDR are not set, then the vNIC associated to this network must only have a single IP address assigned to it. The available networks (port groups) can be listed using `govc ls 'network/&#42;'`
+     */
     @JsonProperty("network")
     public void setNetwork(String network) {
         this.network = network;
     }
 
+    /**
+     * networkSubnetCidr IP address on VirtualMachine's network interfaces included in the fields' CIDRs that will be used in respective status.addresses fields.
+     */
     @JsonProperty("networkSubnetCidr")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNetworkSubnetCidr() {
         return networkSubnetCidr;
     }
 
+    /**
+     * networkSubnetCidr IP address on VirtualMachine's network interfaces included in the fields' CIDRs that will be used in respective status.addresses fields.
+     */
     @JsonProperty("networkSubnetCidr")
     public void setNetworkSubnetCidr(List<String> networkSubnetCidr) {
         this.networkSubnetCidr = networkSubnetCidr;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformSpec.java
index 3f14b75385e..3226f60959f 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VSpherePlatformSpec holds the desired state of the vSphere infrastructure provider. In the future the cloud provider operator, storage operator and machine operator will use these fields for configuration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -105,66 +108,102 @@ public VSpherePlatformSpec(List<String> apiServerInternalIPs, List<VSpherePlatfo
         this.vcenters = vcenters;
     }
 
+    /**
+     * apiServerInternalIPs are the IP addresses to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. These are the IPs for a self-hosted load balancer in front of the API servers. In dual stack clusters this list contains two IP addresses, one from IPv4 family and one from IPv6. In single stack clusters a single IP address is expected. When omitted, values from the status.apiServerInternalIPs will be used. Once set, the list cannot be completely removed (but its second entry can).
+     */
     @JsonProperty("apiServerInternalIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiServerInternalIPs() {
         return apiServerInternalIPs;
     }
 
+    /**
+     * apiServerInternalIPs are the IP addresses to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. These are the IPs for a self-hosted load balancer in front of the API servers. In dual stack clusters this list contains two IP addresses, one from IPv4 family and one from IPv6. In single stack clusters a single IP address is expected. When omitted, values from the status.apiServerInternalIPs will be used. Once set, the list cannot be completely removed (but its second entry can).
+     */
     @JsonProperty("apiServerInternalIPs")
     public void setApiServerInternalIPs(List<String> apiServerInternalIPs) {
         this.apiServerInternalIPs = apiServerInternalIPs;
     }
 
+    /**
+     * failureDomains contains the definition of region, zone and the vCenter topology. If this is omitted failure domains (regions and zones) will not be used.
+     */
     @JsonProperty("failureDomains")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VSpherePlatformFailureDomainSpec> getFailureDomains() {
         return failureDomains;
     }
 
+    /**
+     * failureDomains contains the definition of region, zone and the vCenter topology. If this is omitted failure domains (regions and zones) will not be used.
+     */
     @JsonProperty("failureDomains")
     public void setFailureDomains(List<VSpherePlatformFailureDomainSpec> failureDomains) {
         this.failureDomains = failureDomains;
     }
 
+    /**
+     * ingressIPs are the external IPs which route to the default ingress controller. The IPs are suitable targets of a wildcard DNS record used to resolve default route host names. In dual stack clusters this list contains two IP addresses, one from IPv4 family and one from IPv6. In single stack clusters a single IP address is expected. When omitted, values from the status.ingressIPs will be used. Once set, the list cannot be completely removed (but its second entry can).
+     */
     @JsonProperty("ingressIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIngressIPs() {
         return ingressIPs;
     }
 
+    /**
+     * ingressIPs are the external IPs which route to the default ingress controller. The IPs are suitable targets of a wildcard DNS record used to resolve default route host names. In dual stack clusters this list contains two IP addresses, one from IPv4 family and one from IPv6. In single stack clusters a single IP address is expected. When omitted, values from the status.ingressIPs will be used. Once set, the list cannot be completely removed (but its second entry can).
+     */
     @JsonProperty("ingressIPs")
     public void setIngressIPs(List<String> ingressIPs) {
         this.ingressIPs = ingressIPs;
     }
 
+    /**
+     * machineNetworks are IP networks used to connect all the OpenShift cluster nodes. Each network is provided in the CIDR format and should be IPv4 or IPv6, for example "10.0.0.0/8" or "fd00::/8".
+     */
     @JsonProperty("machineNetworks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMachineNetworks() {
         return machineNetworks;
     }
 
+    /**
+     * machineNetworks are IP networks used to connect all the OpenShift cluster nodes. Each network is provided in the CIDR format and should be IPv4 or IPv6, for example "10.0.0.0/8" or "fd00::/8".
+     */
     @JsonProperty("machineNetworks")
     public void setMachineNetworks(List<String> machineNetworks) {
         this.machineNetworks = machineNetworks;
     }
 
+    /**
+     * VSpherePlatformSpec holds the desired state of the vSphere infrastructure provider. In the future the cloud provider operator, storage operator and machine operator will use these fields for configuration.
+     */
     @JsonProperty("nodeNetworking")
     public VSpherePlatformNodeNetworking getNodeNetworking() {
         return nodeNetworking;
     }
 
+    /**
+     * VSpherePlatformSpec holds the desired state of the vSphere infrastructure provider. In the future the cloud provider operator, storage operator and machine operator will use these fields for configuration.
+     */
     @JsonProperty("nodeNetworking")
     public void setNodeNetworking(VSpherePlatformNodeNetworking nodeNetworking) {
         this.nodeNetworking = nodeNetworking;
     }
 
+    /**
+     * vcenters holds the connection details for services to communicate with vCenter. Currently, only a single vCenter is supported, but in tech preview 3 vCenters are supported. Once the cluster has been installed, you are unable to change the current number of defined vCenters except in the case where the cluster has been upgraded from a version of OpenShift where the vsphere platform spec was not present.  You may make modifications to the existing vCenters that are defined in the vcenters list in order to match with any added or modified failure domains.
+     */
     @JsonProperty("vcenters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VSpherePlatformVCenterSpec> getVcenters() {
         return vcenters;
     }
 
+    /**
+     * vcenters holds the connection details for services to communicate with vCenter. Currently, only a single vCenter is supported, but in tech preview 3 vCenters are supported. Once the cluster has been installed, you are unable to change the current number of defined vCenters except in the case where the cluster has been upgraded from a version of OpenShift where the vsphere platform spec was not present.  You may make modifications to the existing vCenters that are defined in the vcenters list in order to match with any added or modified failure domains.
+     */
     @JsonProperty("vcenters")
     public void setVcenters(List<VSpherePlatformVCenterSpec> vcenters) {
         this.vcenters = vcenters;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformStatus.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformStatus.java
index f4e72950a1c..1e3b40c43d5 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformStatus.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VSpherePlatformStatus holds the current status of the vSphere infrastructure provider.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -107,74 +110,116 @@ public VSpherePlatformStatus(String apiServerInternalIP, List<String> apiServerI
         this.nodeDNSIP = nodeDNSIP;
     }
 
+    /**
+     * apiServerInternalIP is an IP address to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. It is the IP that the Infrastructure.status.apiServerInternalURI points to. It is the IP for a self-hosted load balancer in front of the API servers.<br><p> <br><p> Deprecated: Use APIServerInternalIPs instead.
+     */
     @JsonProperty("apiServerInternalIP")
     public String getApiServerInternalIP() {
         return apiServerInternalIP;
     }
 
+    /**
+     * apiServerInternalIP is an IP address to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. It is the IP that the Infrastructure.status.apiServerInternalURI points to. It is the IP for a self-hosted load balancer in front of the API servers.<br><p> <br><p> Deprecated: Use APIServerInternalIPs instead.
+     */
     @JsonProperty("apiServerInternalIP")
     public void setApiServerInternalIP(String apiServerInternalIP) {
         this.apiServerInternalIP = apiServerInternalIP;
     }
 
+    /**
+     * apiServerInternalIPs are the IP addresses to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. These are the IPs for a self-hosted load balancer in front of the API servers. In dual stack clusters this list contains two IPs otherwise only one.
+     */
     @JsonProperty("apiServerInternalIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiServerInternalIPs() {
         return apiServerInternalIPs;
     }
 
+    /**
+     * apiServerInternalIPs are the IP addresses to contact the Kubernetes API server that can be used by components inside the cluster, like kubelets using the infrastructure rather than Kubernetes networking. These are the IPs for a self-hosted load balancer in front of the API servers. In dual stack clusters this list contains two IPs otherwise only one.
+     */
     @JsonProperty("apiServerInternalIPs")
     public void setApiServerInternalIPs(List<String> apiServerInternalIPs) {
         this.apiServerInternalIPs = apiServerInternalIPs;
     }
 
+    /**
+     * ingressIP is an external IP which routes to the default ingress controller. The IP is a suitable target of a wildcard DNS record used to resolve default route host names.<br><p> <br><p> Deprecated: Use IngressIPs instead.
+     */
     @JsonProperty("ingressIP")
     public String getIngressIP() {
         return ingressIP;
     }
 
+    /**
+     * ingressIP is an external IP which routes to the default ingress controller. The IP is a suitable target of a wildcard DNS record used to resolve default route host names.<br><p> <br><p> Deprecated: Use IngressIPs instead.
+     */
     @JsonProperty("ingressIP")
     public void setIngressIP(String ingressIP) {
         this.ingressIP = ingressIP;
     }
 
+    /**
+     * ingressIPs are the external IPs which route to the default ingress controller. The IPs are suitable targets of a wildcard DNS record used to resolve default route host names. In dual stack clusters this list contains two IPs otherwise only one.
+     */
     @JsonProperty("ingressIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIngressIPs() {
         return ingressIPs;
     }
 
+    /**
+     * ingressIPs are the external IPs which route to the default ingress controller. The IPs are suitable targets of a wildcard DNS record used to resolve default route host names. In dual stack clusters this list contains two IPs otherwise only one.
+     */
     @JsonProperty("ingressIPs")
     public void setIngressIPs(List<String> ingressIPs) {
         this.ingressIPs = ingressIPs;
     }
 
+    /**
+     * VSpherePlatformStatus holds the current status of the vSphere infrastructure provider.
+     */
     @JsonProperty("loadBalancer")
     public VSpherePlatformLoadBalancer getLoadBalancer() {
         return loadBalancer;
     }
 
+    /**
+     * VSpherePlatformStatus holds the current status of the vSphere infrastructure provider.
+     */
     @JsonProperty("loadBalancer")
     public void setLoadBalancer(VSpherePlatformLoadBalancer loadBalancer) {
         this.loadBalancer = loadBalancer;
     }
 
+    /**
+     * machineNetworks are IP networks used to connect all the OpenShift cluster nodes.
+     */
     @JsonProperty("machineNetworks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMachineNetworks() {
         return machineNetworks;
     }
 
+    /**
+     * machineNetworks are IP networks used to connect all the OpenShift cluster nodes.
+     */
     @JsonProperty("machineNetworks")
     public void setMachineNetworks(List<String> machineNetworks) {
         this.machineNetworks = machineNetworks;
     }
 
+    /**
+     * nodeDNSIP is the IP address for the internal DNS used by the nodes. Unlike the one managed by the DNS operator, `NodeDNSIP` provides name resolution for the nodes themselves. There is no DNS-as-a-service for vSphere deployments. In order to minimize necessary changes to the datacenter DNS, a DNS service is hosted as a static pod to serve those hostnames to the nodes in the cluster.
+     */
     @JsonProperty("nodeDNSIP")
     public String getNodeDNSIP() {
         return nodeDNSIP;
     }
 
+    /**
+     * nodeDNSIP is the IP address for the internal DNS used by the nodes. Unlike the one managed by the DNS operator, `NodeDNSIP` provides name resolution for the nodes themselves. There is no DNS-as-a-service for vSphere deployments. In order to minimize necessary changes to the datacenter DNS, a DNS service is hosted as a static pod to serve those hostnames to the nodes in the cluster.
+     */
     @JsonProperty("nodeDNSIP")
     public void setNodeDNSIP(String nodeDNSIP) {
         this.nodeDNSIP = nodeDNSIP;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformTopology.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformTopology.java
index 5d0e3b3e03f..3c80e4be62b 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformTopology.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformTopology.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VSpherePlatformTopology holds the required and optional vCenter objects - datacenter, computeCluster, networks, datastore and resourcePool - to provision virtual machines.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -105,72 +108,114 @@ public VSpherePlatformTopology(String computeCluster, String datacenter, String
         this.template = template;
     }
 
+    /**
+     * computeCluster the absolute path of the vCenter cluster in which virtual machine will be located. The absolute path is of the form /&lt;datacenter&gt;/host/&lt;cluster&gt;. The maximum length of the path is 2048 characters.
+     */
     @JsonProperty("computeCluster")
     public String getComputeCluster() {
         return computeCluster;
     }
 
+    /**
+     * computeCluster the absolute path of the vCenter cluster in which virtual machine will be located. The absolute path is of the form /&lt;datacenter&gt;/host/&lt;cluster&gt;. The maximum length of the path is 2048 characters.
+     */
     @JsonProperty("computeCluster")
     public void setComputeCluster(String computeCluster) {
         this.computeCluster = computeCluster;
     }
 
+    /**
+     * datacenter is the name of vCenter datacenter in which virtual machines will be located. The maximum length of the datacenter name is 80 characters.
+     */
     @JsonProperty("datacenter")
     public String getDatacenter() {
         return datacenter;
     }
 
+    /**
+     * datacenter is the name of vCenter datacenter in which virtual machines will be located. The maximum length of the datacenter name is 80 characters.
+     */
     @JsonProperty("datacenter")
     public void setDatacenter(String datacenter) {
         this.datacenter = datacenter;
     }
 
+    /**
+     * datastore is the absolute path of the datastore in which the virtual machine is located. The absolute path is of the form /&lt;datacenter&gt;/datastore/&lt;datastore&gt; The maximum length of the path is 2048 characters.
+     */
     @JsonProperty("datastore")
     public String getDatastore() {
         return datastore;
     }
 
+    /**
+     * datastore is the absolute path of the datastore in which the virtual machine is located. The absolute path is of the form /&lt;datacenter&gt;/datastore/&lt;datastore&gt; The maximum length of the path is 2048 characters.
+     */
     @JsonProperty("datastore")
     public void setDatastore(String datastore) {
         this.datastore = datastore;
     }
 
+    /**
+     * folder is the absolute path of the folder where virtual machines are located. The absolute path is of the form /&lt;datacenter&gt;/vm/&lt;folder&gt;. The maximum length of the path is 2048 characters.
+     */
     @JsonProperty("folder")
     public String getFolder() {
         return folder;
     }
 
+    /**
+     * folder is the absolute path of the folder where virtual machines are located. The absolute path is of the form /&lt;datacenter&gt;/vm/&lt;folder&gt;. The maximum length of the path is 2048 characters.
+     */
     @JsonProperty("folder")
     public void setFolder(String folder) {
         this.folder = folder;
     }
 
+    /**
+     * networks is the list of port group network names within this failure domain. If feature gate VSphereMultiNetworks is enabled, up to 10 network adapters may be defined. 10 is the maximum number of virtual network devices which may be attached to a VM as defined by: https://configmax.esp.vmware.com/guest?vmwareproduct=vSphere&amp;release=vSphere%208.0&amp;categories=1-0 The available networks (port groups) can be listed using `govc ls 'network/&#42;'` Networks should be in the form of an absolute path: /&lt;datacenter&gt;/network/&lt;portgroup&gt;.
+     */
     @JsonProperty("networks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNetworks() {
         return networks;
     }
 
+    /**
+     * networks is the list of port group network names within this failure domain. If feature gate VSphereMultiNetworks is enabled, up to 10 network adapters may be defined. 10 is the maximum number of virtual network devices which may be attached to a VM as defined by: https://configmax.esp.vmware.com/guest?vmwareproduct=vSphere&amp;release=vSphere%208.0&amp;categories=1-0 The available networks (port groups) can be listed using `govc ls 'network/&#42;'` Networks should be in the form of an absolute path: /&lt;datacenter&gt;/network/&lt;portgroup&gt;.
+     */
     @JsonProperty("networks")
     public void setNetworks(List<String> networks) {
         this.networks = networks;
     }
 
+    /**
+     * resourcePool is the absolute path of the resource pool where virtual machines will be created. The absolute path is of the form /&lt;datacenter&gt;/host/&lt;cluster&gt;/Resources/&lt;resourcepool&gt;. The maximum length of the path is 2048 characters.
+     */
     @JsonProperty("resourcePool")
     public String getResourcePool() {
         return resourcePool;
     }
 
+    /**
+     * resourcePool is the absolute path of the resource pool where virtual machines will be created. The absolute path is of the form /&lt;datacenter&gt;/host/&lt;cluster&gt;/Resources/&lt;resourcepool&gt;. The maximum length of the path is 2048 characters.
+     */
     @JsonProperty("resourcePool")
     public void setResourcePool(String resourcePool) {
         this.resourcePool = resourcePool;
     }
 
+    /**
+     * template is the full inventory path of the virtual machine or template that will be cloned when creating new machines in this failure domain. The maximum length of the path is 2048 characters.<br><p> <br><p> When omitted, the template will be calculated by the control plane machineset operator based on the region and zone defined in VSpherePlatformFailureDomainSpec. For example, for zone=zonea, region=region1, and infrastructure name=test, the template path would be calculated as /&lt;datacenter&gt;/vm/test-rhcos-region1-zonea.
+     */
     @JsonProperty("template")
     public String getTemplate() {
         return template;
     }
 
+    /**
+     * template is the full inventory path of the virtual machine or template that will be cloned when creating new machines in this failure domain. The maximum length of the path is 2048 characters.<br><p> <br><p> When omitted, the template will be calculated by the control plane machineset operator based on the region and zone defined in VSpherePlatformFailureDomainSpec. For example, for zone=zonea, region=region1, and infrastructure name=test, the template path would be calculated as /&lt;datacenter&gt;/vm/test-rhcos-region1-zonea.
+     */
     @JsonProperty("template")
     public void setTemplate(String template) {
         this.template = template;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformVCenterSpec.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformVCenterSpec.java
index 09cd5d3c25d..1a7f0296f8e 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformVCenterSpec.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/VSpherePlatformVCenterSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VSpherePlatformVCenterSpec stores the vCenter connection fields. This is used by the vSphere CCM.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public VSpherePlatformVCenterSpec(List<String> datacenters, Integer port, String
         this.server = server;
     }
 
+    /**
+     * The vCenter Datacenters in which the RHCOS vm guests are located. This field will be used by the Cloud Controller Manager. Each datacenter listed here should be used within a topology.
+     */
     @JsonProperty("datacenters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDatacenters() {
         return datacenters;
     }
 
+    /**
+     * The vCenter Datacenters in which the RHCOS vm guests are located. This field will be used by the Cloud Controller Manager. Each datacenter listed here should be used within a topology.
+     */
     @JsonProperty("datacenters")
     public void setDatacenters(List<String> datacenters) {
         this.datacenters = datacenters;
     }
 
+    /**
+     * port is the TCP port that will be used to communicate to the vCenter endpoint. When omitted, this means the user has no opinion and it is up to the platform to choose a sensible default, which is subject to change over time.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * port is the TCP port that will be used to communicate to the vCenter endpoint. When omitted, this means the user has no opinion and it is up to the platform to choose a sensible default, which is subject to change over time.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * server is the fully-qualified domain name or the IP address of the vCenter server.
+     */
     @JsonProperty("server")
     public String getServer() {
         return server;
     }
 
+    /**
+     * server is the fully-qualified domain name or the IP address of the vCenter server.
+     */
     @JsonProperty("server")
     public void setServer(String server) {
         this.server = server;
diff --git a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/WebhookTokenAuthenticator.java b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/WebhookTokenAuthenticator.java
index d5c51f7aa35..53471dfa020 100644
--- a/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/WebhookTokenAuthenticator.java
+++ b/kubernetes-model-generator/openshift-model-config/src/generated/java/io/fabric8/openshift/api/model/config/v1/WebhookTokenAuthenticator.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * webhookTokenAuthenticator holds the necessary configuration options for a remote token authenticator
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public WebhookTokenAuthenticator(SecretNameReference kubeConfig) {
         this.kubeConfig = kubeConfig;
     }
 
+    /**
+     * webhookTokenAuthenticator holds the necessary configuration options for a remote token authenticator
+     */
     @JsonProperty("kubeConfig")
     public SecretNameReference getKubeConfig() {
         return kubeConfig;
     }
 
+    /**
+     * webhookTokenAuthenticator holds the necessary configuration options for a remote token authenticator
+     */
     @JsonProperty("kubeConfig")
     public void setKubeConfig(SecretNameReference kubeConfig) {
         this.kubeConfig = kubeConfig;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ApplicationMenuSpec.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ApplicationMenuSpec.java
index d57b11e3454..ed0518b6ffb 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ApplicationMenuSpec.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ApplicationMenuSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ApplicationMenuSpec is the specification of the desired section and icon used for the link in the application menu.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ApplicationMenuSpec(String imageURL, String section) {
         this.section = section;
     }
 
+    /**
+     * imageUrl is the URL for the icon used in front of the link in the application menu. The URL must be an HTTPS URL or a Data URI. The image should be square and will be shown at 24x24 pixels.
+     */
     @JsonProperty("imageURL")
     public String getImageURL() {
         return imageURL;
     }
 
+    /**
+     * imageUrl is the URL for the icon used in front of the link in the application menu. The URL must be an HTTPS URL or a Data URI. The image should be square and will be shown at 24x24 pixels.
+     */
     @JsonProperty("imageURL")
     public void setImageURL(String imageURL) {
         this.imageURL = imageURL;
     }
 
+    /**
+     * section is the section of the application menu in which the link should appear. This can be any text that will appear as a subheading in the application menu dropdown. A new section will be created if the text does not match text of an existing section.
+     */
     @JsonProperty("section")
     public String getSection() {
         return section;
     }
 
+    /**
+     * section is the section of the application menu in which the link should appear. This can be any text that will appear as a subheading in the application menu dropdown. A new section will be created if the text does not match text of an existing section.
+     */
     @JsonProperty("section")
     public void setSection(String section) {
         this.section = section;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/CLIDownloadLink.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/CLIDownloadLink.java
index b446b8eb069..3fbc64c5114 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/CLIDownloadLink.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/CLIDownloadLink.java
@@ -82,21 +82,33 @@ public CLIDownloadLink(String href, String text) {
         this.text = text;
     }
 
+    /**
+     * href is the absolute secure URL for the link (must use https)
+     */
     @JsonProperty("href")
     public String getHref() {
         return href;
     }
 
+    /**
+     * href is the absolute secure URL for the link (must use https)
+     */
     @JsonProperty("href")
     public void setHref(String href) {
         this.href = href;
     }
 
+    /**
+     * text is the display text for the link
+     */
     @JsonProperty("text")
     public String getText() {
         return text;
     }
 
+    /**
+     * text is the display text for the link
+     */
     @JsonProperty("text")
     public void setText(String text) {
         this.text = text;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleCLIDownload.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleCLIDownload.java
index 0ed7db2ca32..d227bc70667 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleCLIDownload.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleCLIDownload.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleCLIDownload is an extension for configuring openshift web console command line interface (CLI) downloads.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class ConsoleCLIDownload implements Editable<ConsoleCLIDownloadBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "console.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ConsoleCLIDownload";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public ConsoleCLIDownload(String apiVersion, String kind, ObjectMeta metadata, C
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ConsoleCLIDownload is an extension for configuring openshift web console command line interface (CLI) downloads.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ConsoleCLIDownload is an extension for configuring openshift web console command line interface (CLI) downloads.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ConsoleCLIDownload is an extension for configuring openshift web console command line interface (CLI) downloads.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ConsoleCLIDownloadSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ConsoleCLIDownload is an extension for configuring openshift web console command line interface (CLI) downloads.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ConsoleCLIDownloadSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleCLIDownloadList.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleCLIDownloadList.java
index 58906a955a0..1718c13e995 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleCLIDownloadList.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleCLIDownloadList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ConsoleCLIDownloadList implements Editable<ConsoleCLIDownloadListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.console.v1.ConsoleCLIDownload>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "console.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.console.v1.ConsoleCLIDownload> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ConsoleCLIDownloadList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ConsoleCLIDownloadList(String apiVersion, List<io.fabric8.openshift.api.m
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.console.v1.ConsoleCLIDownload> getItems() {
         return items;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.console.v1.ConsoleCLIDownload> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleCLIDownloadSpec.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleCLIDownloadSpec.java
index ddfcb481df0..1e804bb174e 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleCLIDownloadSpec.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleCLIDownloadSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleCLIDownloadSpec is the desired cli download configuration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public ConsoleCLIDownloadSpec(String description, String displayName, List<CLIDo
         this.links = links;
     }
 
+    /**
+     * description is the description of the CLI download (can include markdown).
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * description is the description of the CLI download (can include markdown).
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * displayName is the display name of the CLI download.
+     */
     @JsonProperty("displayName")
     public String getDisplayName() {
         return displayName;
     }
 
+    /**
+     * displayName is the display name of the CLI download.
+     */
     @JsonProperty("displayName")
     public void setDisplayName(String displayName) {
         this.displayName = displayName;
     }
 
+    /**
+     * links is a list of objects that provide CLI download link details.
+     */
     @JsonProperty("links")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CLIDownloadLink> getLinks() {
         return links;
     }
 
+    /**
+     * links is a list of objects that provide CLI download link details.
+     */
     @JsonProperty("links")
     public void setLinks(List<CLIDownloadLink> links) {
         this.links = links;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleExternalLogLink.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleExternalLogLink.java
index 7e181bc2739..11a25ed80d7 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleExternalLogLink.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleExternalLogLink.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleExternalLogLink is an extension for customizing OpenShift web console log links.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class ConsoleExternalLogLink implements Editable<ConsoleExternalLogLinkBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "console.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ConsoleExternalLogLink";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public ConsoleExternalLogLink(String apiVersion, String kind, ObjectMeta metadat
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ConsoleExternalLogLink is an extension for customizing OpenShift web console log links.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ConsoleExternalLogLink is an extension for customizing OpenShift web console log links.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ConsoleExternalLogLink is an extension for customizing OpenShift web console log links.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ConsoleExternalLogLinkSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ConsoleExternalLogLink is an extension for customizing OpenShift web console log links.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ConsoleExternalLogLinkSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleExternalLogLinkList.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleExternalLogLinkList.java
index e38d396fe0c..e881eebfa58 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleExternalLogLinkList.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleExternalLogLinkList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ConsoleExternalLogLinkList implements Editable<ConsoleExternalLogLinkListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.console.v1.ConsoleExternalLogLink>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "console.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.console.v1.ConsoleExternalLogLink> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ConsoleExternalLogLinkList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ConsoleExternalLogLinkList(String apiVersion, List<io.fabric8.openshift.a
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.console.v1.ConsoleExternalLogLink> getItems() {
         return items;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.console.v1.ConsoleExternalLogLink> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleExternalLogLinkSpec.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleExternalLogLinkSpec.java
index 212da833911..6206f24de59 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleExternalLogLinkSpec.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleExternalLogLinkSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleExternalLogLinkSpec is the desired log link configuration. The log link will appear on the logs tab of the pod details page.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ConsoleExternalLogLinkSpec(String hrefTemplate, String namespaceFilter, S
         this.text = text;
     }
 
+    /**
+     * hrefTemplate is an absolute secure URL (must use https) for the log link including variables to be replaced. Variables are specified in the URL with the format ${variableName}, for instance, ${containerName} and will be replaced with the corresponding values from the resource. Resource is a pod. Supported variables are: - ${resourceName} - name of the resource which containes the logs - ${resourceUID} - UID of the resource which contains the logs<br><p>               - e.g. `11111111-2222-3333-4444-555555555555`<br><p> - ${containerName} - name of the resource's container that contains the logs - ${resourceNamespace} - namespace of the resource that contains the logs - ${resourceNamespaceUID} - namespace UID of the resource that contains the logs - ${podLabels} - JSON representation of labels matching the pod with the logs<br><p>             - e.g. `{"key1":"value1","key2":"value2"}`<br><p> <br><p> e.g., https://example.com/logs?resourceName=${resourceName}&amp;containerName=${containerName}&amp;resourceNamespace=${resourceNamespace}&amp;podLabels=${podLabels}
+     */
     @JsonProperty("hrefTemplate")
     public String getHrefTemplate() {
         return hrefTemplate;
     }
 
+    /**
+     * hrefTemplate is an absolute secure URL (must use https) for the log link including variables to be replaced. Variables are specified in the URL with the format ${variableName}, for instance, ${containerName} and will be replaced with the corresponding values from the resource. Resource is a pod. Supported variables are: - ${resourceName} - name of the resource which containes the logs - ${resourceUID} - UID of the resource which contains the logs<br><p>               - e.g. `11111111-2222-3333-4444-555555555555`<br><p> - ${containerName} - name of the resource's container that contains the logs - ${resourceNamespace} - namespace of the resource that contains the logs - ${resourceNamespaceUID} - namespace UID of the resource that contains the logs - ${podLabels} - JSON representation of labels matching the pod with the logs<br><p>             - e.g. `{"key1":"value1","key2":"value2"}`<br><p> <br><p> e.g., https://example.com/logs?resourceName=${resourceName}&amp;containerName=${containerName}&amp;resourceNamespace=${resourceNamespace}&amp;podLabels=${podLabels}
+     */
     @JsonProperty("hrefTemplate")
     public void setHrefTemplate(String hrefTemplate) {
         this.hrefTemplate = hrefTemplate;
     }
 
+    /**
+     * namespaceFilter is a regular expression used to restrict a log link to a matching set of namespaces (e.g., `^openshift-`). The string is converted into a regular expression using the JavaScript RegExp constructor. If not specified, links will be displayed for all the namespaces.
+     */
     @JsonProperty("namespaceFilter")
     public String getNamespaceFilter() {
         return namespaceFilter;
     }
 
+    /**
+     * namespaceFilter is a regular expression used to restrict a log link to a matching set of namespaces (e.g., `^openshift-`). The string is converted into a regular expression using the JavaScript RegExp constructor. If not specified, links will be displayed for all the namespaces.
+     */
     @JsonProperty("namespaceFilter")
     public void setNamespaceFilter(String namespaceFilter) {
         this.namespaceFilter = namespaceFilter;
     }
 
+    /**
+     * text is the display text for the link
+     */
     @JsonProperty("text")
     public String getText() {
         return text;
     }
 
+    /**
+     * text is the display text for the link
+     */
     @JsonProperty("text")
     public void setText(String text) {
         this.text = text;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleLink.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleLink.java
index 5859bc9623f..a428f06a6b0 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleLink.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleLink.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleLink is an extension for customizing OpenShift web console links.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class ConsoleLink implements Editable<ConsoleLinkBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "console.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ConsoleLink";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public ConsoleLink(String apiVersion, String kind, ObjectMeta metadata, ConsoleL
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ConsoleLink is an extension for customizing OpenShift web console links.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ConsoleLink is an extension for customizing OpenShift web console links.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ConsoleLink is an extension for customizing OpenShift web console links.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ConsoleLinkSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ConsoleLink is an extension for customizing OpenShift web console links.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ConsoleLinkSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleLinkList.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleLinkList.java
index 53fe0eab7ba..9d00c525fe2 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleLinkList.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleLinkList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ConsoleLinkList implements Editable<ConsoleLinkListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.console.v1.ConsoleLink>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "console.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.console.v1.ConsoleLink> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ConsoleLinkList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ConsoleLinkList(String apiVersion, List<io.fabric8.openshift.api.model.co
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.console.v1.ConsoleLink> getItems() {
         return items;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.console.v1.ConsoleLink> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleLinkSpec.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleLinkSpec.java
index aedf78265e6..f0128bbec16 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleLinkSpec.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleLinkSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleLinkSpec is the desired console link configuration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public ConsoleLinkSpec(ApplicationMenuSpec applicationMenu, String href, String
         this.text = text;
     }
 
+    /**
+     * ConsoleLinkSpec is the desired console link configuration.
+     */
     @JsonProperty("applicationMenu")
     public ApplicationMenuSpec getApplicationMenu() {
         return applicationMenu;
     }
 
+    /**
+     * ConsoleLinkSpec is the desired console link configuration.
+     */
     @JsonProperty("applicationMenu")
     public void setApplicationMenu(ApplicationMenuSpec applicationMenu) {
         this.applicationMenu = applicationMenu;
     }
 
+    /**
+     * href is the absolute secure URL for the link (must use https)
+     */
     @JsonProperty("href")
     public String getHref() {
         return href;
     }
 
+    /**
+     * href is the absolute secure URL for the link (must use https)
+     */
     @JsonProperty("href")
     public void setHref(String href) {
         this.href = href;
     }
 
+    /**
+     * location determines which location in the console the link will be appended to (ApplicationMenu, HelpMenu, UserMenu, NamespaceDashboard).
+     */
     @JsonProperty("location")
     public String getLocation() {
         return location;
     }
 
+    /**
+     * location determines which location in the console the link will be appended to (ApplicationMenu, HelpMenu, UserMenu, NamespaceDashboard).
+     */
     @JsonProperty("location")
     public void setLocation(String location) {
         this.location = location;
     }
 
+    /**
+     * ConsoleLinkSpec is the desired console link configuration.
+     */
     @JsonProperty("namespaceDashboard")
     public NamespaceDashboardSpec getNamespaceDashboard() {
         return namespaceDashboard;
     }
 
+    /**
+     * ConsoleLinkSpec is the desired console link configuration.
+     */
     @JsonProperty("namespaceDashboard")
     public void setNamespaceDashboard(NamespaceDashboardSpec namespaceDashboard) {
         this.namespaceDashboard = namespaceDashboard;
     }
 
+    /**
+     * text is the display text for the link
+     */
     @JsonProperty("text")
     public String getText() {
         return text;
     }
 
+    /**
+     * text is the display text for the link
+     */
     @JsonProperty("text")
     public void setText(String text) {
         this.text = text;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleNotification.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleNotification.java
index a4a1dbd4f98..978024f7907 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleNotification.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleNotification.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleNotification is the extension for configuring openshift web console notifications.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class ConsoleNotification implements Editable<ConsoleNotificationBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "console.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ConsoleNotification";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public ConsoleNotification(String apiVersion, String kind, ObjectMeta metadata,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ConsoleNotification is the extension for configuring openshift web console notifications.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ConsoleNotification is the extension for configuring openshift web console notifications.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ConsoleNotification is the extension for configuring openshift web console notifications.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ConsoleNotificationSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ConsoleNotification is the extension for configuring openshift web console notifications.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ConsoleNotificationSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleNotificationList.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleNotificationList.java
index a4ea93eb367..b5e50468474 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleNotificationList.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleNotificationList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ConsoleNotificationList implements Editable<ConsoleNotificationListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.console.v1.ConsoleNotification>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "console.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.console.v1.ConsoleNotification> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ConsoleNotificationList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ConsoleNotificationList(String apiVersion, List<io.fabric8.openshift.api.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.console.v1.ConsoleNotification> getItems() {
         return items;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.console.v1.ConsoleNotification> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleNotificationSpec.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleNotificationSpec.java
index 97caef783f4..6299ebed1ff 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleNotificationSpec.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleNotificationSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleNotificationSpec is the desired console notification configuration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public ConsoleNotificationSpec(String backgroundColor, String color, Link link,
         this.text = text;
     }
 
+    /**
+     * backgroundColor is the color of the background for the notification as CSS data type color.
+     */
     @JsonProperty("backgroundColor")
     public String getBackgroundColor() {
         return backgroundColor;
     }
 
+    /**
+     * backgroundColor is the color of the background for the notification as CSS data type color.
+     */
     @JsonProperty("backgroundColor")
     public void setBackgroundColor(String backgroundColor) {
         this.backgroundColor = backgroundColor;
     }
 
+    /**
+     * color is the color of the text for the notification as CSS data type color.
+     */
     @JsonProperty("color")
     public String getColor() {
         return color;
     }
 
+    /**
+     * color is the color of the text for the notification as CSS data type color.
+     */
     @JsonProperty("color")
     public void setColor(String color) {
         this.color = color;
     }
 
+    /**
+     * ConsoleNotificationSpec is the desired console notification configuration.
+     */
     @JsonProperty("link")
     public Link getLink() {
         return link;
     }
 
+    /**
+     * ConsoleNotificationSpec is the desired console notification configuration.
+     */
     @JsonProperty("link")
     public void setLink(Link link) {
         this.link = link;
     }
 
+    /**
+     * location is the location of the notification in the console. Valid values are: "BannerTop", "BannerBottom", "BannerTopBottom".
+     */
     @JsonProperty("location")
     public String getLocation() {
         return location;
     }
 
+    /**
+     * location is the location of the notification in the console. Valid values are: "BannerTop", "BannerBottom", "BannerTopBottom".
+     */
     @JsonProperty("location")
     public void setLocation(String location) {
         this.location = location;
     }
 
+    /**
+     * text is the visible text of the notification.
+     */
     @JsonProperty("text")
     public String getText() {
         return text;
     }
 
+    /**
+     * text is the visible text of the notification.
+     */
     @JsonProperty("text")
     public void setText(String text) {
         this.text = text;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePlugin.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePlugin.java
index 349d9b2dcf1..3d0d6c49b2a 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePlugin.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePlugin.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsolePlugin is an extension for customizing OpenShift web console by dynamically loading code from another service running on the cluster.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class ConsolePlugin implements Editable<ConsolePluginBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "console.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ConsolePlugin";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public ConsolePlugin(String apiVersion, String kind, ObjectMeta metadata, Consol
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ConsolePlugin is an extension for customizing OpenShift web console by dynamically loading code from another service running on the cluster.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ConsolePlugin is an extension for customizing OpenShift web console by dynamically loading code from another service running on the cluster.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ConsolePlugin is an extension for customizing OpenShift web console by dynamically loading code from another service running on the cluster.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ConsolePluginSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ConsolePlugin is an extension for customizing OpenShift web console by dynamically loading code from another service running on the cluster.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ConsolePluginSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginBackend.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginBackend.java
index 154e2fcc82c..6902b5b672c 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginBackend.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginBackend.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsolePluginBackend holds information about the endpoint which serves the console's plugin
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ConsolePluginBackend(ConsolePluginService service, String type) {
         this.type = type;
     }
 
+    /**
+     * ConsolePluginBackend holds information about the endpoint which serves the console's plugin
+     */
     @JsonProperty("service")
     public ConsolePluginService getService() {
         return service;
     }
 
+    /**
+     * ConsolePluginBackend holds information about the endpoint which serves the console's plugin
+     */
     @JsonProperty("service")
     public void setService(ConsolePluginService service) {
         this.service = service;
     }
 
+    /**
+     * type is the backend type which servers the console's plugin. Currently only "Service" is supported.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the backend type which servers the console's plugin. Currently only "Service" is supported.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginI18n.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginI18n.java
index 92e0606648e..23fe992b5b1 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginI18n.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginI18n.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsolePluginI18n holds information on localization resources that are served by the dynamic plugin.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ConsolePluginI18n(String loadType) {
         this.loadType = loadType;
     }
 
+    /**
+     * loadType indicates how the plugin's localization resource should be loaded. Valid values are Preload, Lazy and the empty string. When set to Preload, all localization resources are fetched when the plugin is loaded. When set to Lazy, localization resources are lazily loaded as and when they are required by the console. When omitted or set to the empty string, the behaviour is equivalent to Lazy type.
+     */
     @JsonProperty("loadType")
     public String getLoadType() {
         return loadType;
     }
 
+    /**
+     * loadType indicates how the plugin's localization resource should be loaded. Valid values are Preload, Lazy and the empty string. When set to Preload, all localization resources are fetched when the plugin is loaded. When set to Lazy, localization resources are lazily loaded as and when they are required by the console. When omitted or set to the empty string, the behaviour is equivalent to Lazy type.
+     */
     @JsonProperty("loadType")
     public void setLoadType(String loadType) {
         this.loadType = loadType;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginList.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginList.java
index fa4e897d149..e9a68fd6c63 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginList.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ConsolePluginList implements Editable<ConsolePluginListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.console.v1.ConsolePlugin>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "console.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.console.v1.ConsolePlugin> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ConsolePluginList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ConsolePluginList(String apiVersion, List<io.fabric8.openshift.api.model.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.console.v1.ConsolePlugin> getItems() {
         return items;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.console.v1.ConsolePlugin> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginProxy.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginProxy.java
index 9ad6ef305dd..5022339b5a4 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginProxy.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginProxy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsolePluginProxy holds information on various service types to which console's backend will proxy the plugin's requests.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ConsolePluginProxy(String alias, String authorization, String caCertifica
         this.endpoint = endpoint;
     }
 
+    /**
+     * alias is a proxy name that identifies the plugin's proxy. An alias name should be unique per plugin. The console backend exposes following proxy endpoint:<br><p> <br><p> /api/proxy/plugin/&lt;plugin-name&gt;/&lt;proxy-alias&gt;/&lt;request-path&gt;?&lt;optional-query-parameters&gt;<br><p> <br><p> Request example path:<br><p> <br><p> /api/proxy/plugin/acm/search/pods?namespace=openshift-apiserver
+     */
     @JsonProperty("alias")
     public String getAlias() {
         return alias;
     }
 
+    /**
+     * alias is a proxy name that identifies the plugin's proxy. An alias name should be unique per plugin. The console backend exposes following proxy endpoint:<br><p> <br><p> /api/proxy/plugin/&lt;plugin-name&gt;/&lt;proxy-alias&gt;/&lt;request-path&gt;?&lt;optional-query-parameters&gt;<br><p> <br><p> Request example path:<br><p> <br><p> /api/proxy/plugin/acm/search/pods?namespace=openshift-apiserver
+     */
     @JsonProperty("alias")
     public void setAlias(String alias) {
         this.alias = alias;
     }
 
+    /**
+     * authorization provides information about authorization type, which the proxied request should contain
+     */
     @JsonProperty("authorization")
     public String getAuthorization() {
         return authorization;
     }
 
+    /**
+     * authorization provides information about authorization type, which the proxied request should contain
+     */
     @JsonProperty("authorization")
     public void setAuthorization(String authorization) {
         this.authorization = authorization;
     }
 
+    /**
+     * caCertificate provides the cert authority certificate contents, in case the proxied Service is using custom service CA. By default, the service CA bundle provided by the service-ca operator is used.
+     */
     @JsonProperty("caCertificate")
     public String getCaCertificate() {
         return caCertificate;
     }
 
+    /**
+     * caCertificate provides the cert authority certificate contents, in case the proxied Service is using custom service CA. By default, the service CA bundle provided by the service-ca operator is used.
+     */
     @JsonProperty("caCertificate")
     public void setCaCertificate(String caCertificate) {
         this.caCertificate = caCertificate;
     }
 
+    /**
+     * ConsolePluginProxy holds information on various service types to which console's backend will proxy the plugin's requests.
+     */
     @JsonProperty("endpoint")
     public ConsolePluginProxyEndpoint getEndpoint() {
         return endpoint;
     }
 
+    /**
+     * ConsolePluginProxy holds information on various service types to which console's backend will proxy the plugin's requests.
+     */
     @JsonProperty("endpoint")
     public void setEndpoint(ConsolePluginProxyEndpoint endpoint) {
         this.endpoint = endpoint;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginProxyEndpoint.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginProxyEndpoint.java
index b1a9166710c..ad889a95b94 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginProxyEndpoint.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginProxyEndpoint.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsolePluginProxyEndpoint holds information about the endpoint to which request will be proxied to.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ConsolePluginProxyEndpoint(ConsolePluginProxyServiceConfig service, Strin
         this.type = type;
     }
 
+    /**
+     * ConsolePluginProxyEndpoint holds information about the endpoint to which request will be proxied to.
+     */
     @JsonProperty("service")
     public ConsolePluginProxyServiceConfig getService() {
         return service;
     }
 
+    /**
+     * ConsolePluginProxyEndpoint holds information about the endpoint to which request will be proxied to.
+     */
     @JsonProperty("service")
     public void setService(ConsolePluginProxyServiceConfig service) {
         this.service = service;
     }
 
+    /**
+     * type is the type of the console plugin's proxy. Currently only "Service" is supported.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the type of the console plugin's proxy. Currently only "Service" is supported.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginProxyServiceConfig.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginProxyServiceConfig.java
index 1bed2ffb71a..043b5842d51 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginProxyServiceConfig.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginProxyServiceConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ProxyTypeServiceConfig holds information on Service to which console's backend will proxy the plugin's requests.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ConsolePluginProxyServiceConfig(String name, String namespace, Integer po
         this.port = port;
     }
 
+    /**
+     * name of Service that the plugin needs to connect to.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name of Service that the plugin needs to connect to.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * namespace of Service that the plugin needs to connect to
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * namespace of Service that the plugin needs to connect to
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * port on which the Service that the plugin needs to connect to is listening on.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * port on which the Service that the plugin needs to connect to is listening on.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginService.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginService.java
index aef72774f23..acb35b5b292 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginService.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginService.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsolePluginService holds information on Service that is serving console dynamic plugin assets.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ConsolePluginService(String basePath, String name, String namespace, Inte
         this.port = port;
     }
 
+    /**
+     * basePath is the path to the plugin's assets. The primary asset it the manifest file called `plugin-manifest.json`, which is a JSON document that contains metadata about the plugin and the extensions.
+     */
     @JsonProperty("basePath")
     public String getBasePath() {
         return basePath;
     }
 
+    /**
+     * basePath is the path to the plugin's assets. The primary asset it the manifest file called `plugin-manifest.json`, which is a JSON document that contains metadata about the plugin and the extensions.
+     */
     @JsonProperty("basePath")
     public void setBasePath(String basePath) {
         this.basePath = basePath;
     }
 
+    /**
+     * name of Service that is serving the plugin assets.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name of Service that is serving the plugin assets.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * namespace of Service that is serving the plugin assets.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * namespace of Service that is serving the plugin assets.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * port on which the Service that is serving the plugin is listening to.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * port on which the Service that is serving the plugin is listening to.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginSpec.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginSpec.java
index a8a427c8aec..47879daa010 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginSpec.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsolePluginSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsolePluginSpec is the desired plugin configuration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public ConsolePluginSpec(ConsolePluginBackend backend, String displayName, Conso
         this.proxy = proxy;
     }
 
+    /**
+     * ConsolePluginSpec is the desired plugin configuration.
+     */
     @JsonProperty("backend")
     public ConsolePluginBackend getBackend() {
         return backend;
     }
 
+    /**
+     * ConsolePluginSpec is the desired plugin configuration.
+     */
     @JsonProperty("backend")
     public void setBackend(ConsolePluginBackend backend) {
         this.backend = backend;
     }
 
+    /**
+     * displayName is the display name of the plugin. The dispalyName should be between 1 and 128 characters.
+     */
     @JsonProperty("displayName")
     public String getDisplayName() {
         return displayName;
     }
 
+    /**
+     * displayName is the display name of the plugin. The dispalyName should be between 1 and 128 characters.
+     */
     @JsonProperty("displayName")
     public void setDisplayName(String displayName) {
         this.displayName = displayName;
     }
 
+    /**
+     * ConsolePluginSpec is the desired plugin configuration.
+     */
     @JsonProperty("i18n")
     public ConsolePluginI18n getI18n() {
         return i18n;
     }
 
+    /**
+     * ConsolePluginSpec is the desired plugin configuration.
+     */
     @JsonProperty("i18n")
     public void setI18n(ConsolePluginI18n i18n) {
         this.i18n = i18n;
     }
 
+    /**
+     * proxy is a list of proxies that describe various service type to which the plugin needs to connect to.
+     */
     @JsonProperty("proxy")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ConsolePluginProxy> getProxy() {
         return proxy;
     }
 
+    /**
+     * proxy is a list of proxies that describe various service type to which the plugin needs to connect to.
+     */
     @JsonProperty("proxy")
     public void setProxy(List<ConsolePluginProxy> proxy) {
         this.proxy = proxy;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleQuickStart.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleQuickStart.java
index 588c3e142ee..48ecf30fcda 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleQuickStart.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleQuickStart.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleQuickStart is an extension for guiding user through various workflows in the OpenShift web console.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class ConsoleQuickStart implements Editable<ConsoleQuickStartBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "console.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ConsoleQuickStart";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public ConsoleQuickStart(String apiVersion, String kind, ObjectMeta metadata, Co
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ConsoleQuickStart is an extension for guiding user through various workflows in the OpenShift web console.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ConsoleQuickStart is an extension for guiding user through various workflows in the OpenShift web console.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ConsoleQuickStart is an extension for guiding user through various workflows in the OpenShift web console.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ConsoleQuickStartSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ConsoleQuickStart is an extension for guiding user through various workflows in the OpenShift web console.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ConsoleQuickStartSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleQuickStartList.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleQuickStartList.java
index 608da1de52e..1b8e2834226 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleQuickStartList.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleQuickStartList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ConsoleQuickStartList implements Editable<ConsoleQuickStartListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.console.v1.ConsoleQuickStart>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "console.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.console.v1.ConsoleQuickStart> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ConsoleQuickStartList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ConsoleQuickStartList(String apiVersion, List<io.fabric8.openshift.api.mo
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.console.v1.ConsoleQuickStart> getItems() {
         return items;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.console.v1.ConsoleQuickStart> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleQuickStartSpec.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleQuickStartSpec.java
index 6ffe2c2a3aa..e56a2a0bd2f 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleQuickStartSpec.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleQuickStartSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleQuickStartSpec is the desired quick start configuration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -126,116 +129,182 @@ public ConsoleQuickStartSpec(List<ResourceAttributes> accessReviewResources, Str
         this.tasks = tasks;
     }
 
+    /**
+     * accessReviewResources contains a list of resources that the user's access will be reviewed against in order for the user to complete the Quick Start. The Quick Start will be hidden if any of the access reviews fail.
+     */
     @JsonProperty("accessReviewResources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ResourceAttributes> getAccessReviewResources() {
         return accessReviewResources;
     }
 
+    /**
+     * accessReviewResources contains a list of resources that the user's access will be reviewed against in order for the user to complete the Quick Start. The Quick Start will be hidden if any of the access reviews fail.
+     */
     @JsonProperty("accessReviewResources")
     public void setAccessReviewResources(List<ResourceAttributes> accessReviewResources) {
         this.accessReviewResources = accessReviewResources;
     }
 
+    /**
+     * conclusion sums up the Quick Start and suggests the possible next steps. (includes markdown)
+     */
     @JsonProperty("conclusion")
     public String getConclusion() {
         return conclusion;
     }
 
+    /**
+     * conclusion sums up the Quick Start and suggests the possible next steps. (includes markdown)
+     */
     @JsonProperty("conclusion")
     public void setConclusion(String conclusion) {
         this.conclusion = conclusion;
     }
 
+    /**
+     * description is the description of the Quick Start. (includes markdown)
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * description is the description of the Quick Start. (includes markdown)
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * displayName is the display name of the Quick Start.
+     */
     @JsonProperty("displayName")
     public String getDisplayName() {
         return displayName;
     }
 
+    /**
+     * displayName is the display name of the Quick Start.
+     */
     @JsonProperty("displayName")
     public void setDisplayName(String displayName) {
         this.displayName = displayName;
     }
 
+    /**
+     * durationMinutes describes approximately how many minutes it will take to complete the Quick Start.
+     */
     @JsonProperty("durationMinutes")
     public Integer getDurationMinutes() {
         return durationMinutes;
     }
 
+    /**
+     * durationMinutes describes approximately how many minutes it will take to complete the Quick Start.
+     */
     @JsonProperty("durationMinutes")
     public void setDurationMinutes(Integer durationMinutes) {
         this.durationMinutes = durationMinutes;
     }
 
+    /**
+     * icon is a base64 encoded image that will be displayed beside the Quick Start display name. The icon should be an vector image for easy scaling. The size of the icon should be 40x40.
+     */
     @JsonProperty("icon")
     public String getIcon() {
         return icon;
     }
 
+    /**
+     * icon is a base64 encoded image that will be displayed beside the Quick Start display name. The icon should be an vector image for easy scaling. The size of the icon should be 40x40.
+     */
     @JsonProperty("icon")
     public void setIcon(String icon) {
         this.icon = icon;
     }
 
+    /**
+     * introduction describes the purpose of the Quick Start. (includes markdown)
+     */
     @JsonProperty("introduction")
     public String getIntroduction() {
         return introduction;
     }
 
+    /**
+     * introduction describes the purpose of the Quick Start. (includes markdown)
+     */
     @JsonProperty("introduction")
     public void setIntroduction(String introduction) {
         this.introduction = introduction;
     }
 
+    /**
+     * nextQuickStart is a list of the following Quick Starts, suggested for the user to try.
+     */
     @JsonProperty("nextQuickStart")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNextQuickStart() {
         return nextQuickStart;
     }
 
+    /**
+     * nextQuickStart is a list of the following Quick Starts, suggested for the user to try.
+     */
     @JsonProperty("nextQuickStart")
     public void setNextQuickStart(List<String> nextQuickStart) {
         this.nextQuickStart = nextQuickStart;
     }
 
+    /**
+     * prerequisites contains all prerequisites that need to be met before taking a Quick Start. (includes markdown)
+     */
     @JsonProperty("prerequisites")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPrerequisites() {
         return prerequisites;
     }
 
+    /**
+     * prerequisites contains all prerequisites that need to be met before taking a Quick Start. (includes markdown)
+     */
     @JsonProperty("prerequisites")
     public void setPrerequisites(List<String> prerequisites) {
         this.prerequisites = prerequisites;
     }
 
+    /**
+     * tags is a list of strings that describe the Quick Start.
+     */
     @JsonProperty("tags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getTags() {
         return tags;
     }
 
+    /**
+     * tags is a list of strings that describe the Quick Start.
+     */
     @JsonProperty("tags")
     public void setTags(List<String> tags) {
         this.tags = tags;
     }
 
+    /**
+     * tasks is the list of steps the user has to perform to complete the Quick Start.
+     */
     @JsonProperty("tasks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ConsoleQuickStartTask> getTasks() {
         return tasks;
     }
 
+    /**
+     * tasks is the list of steps the user has to perform to complete the Quick Start.
+     */
     @JsonProperty("tasks")
     public void setTasks(List<ConsoleQuickStartTask> tasks) {
         this.tasks = tasks;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleQuickStartTask.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleQuickStartTask.java
index 645c7b7cd03..ea97377f33c 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleQuickStartTask.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleQuickStartTask.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleQuickStartTask is a single step in a Quick Start.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ConsoleQuickStartTask(String description, ConsoleQuickStartTaskReview rev
         this.title = title;
     }
 
+    /**
+     * description describes the steps needed to complete the task. (includes markdown)
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * description describes the steps needed to complete the task. (includes markdown)
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * ConsoleQuickStartTask is a single step in a Quick Start.
+     */
     @JsonProperty("review")
     public ConsoleQuickStartTaskReview getReview() {
         return review;
     }
 
+    /**
+     * ConsoleQuickStartTask is a single step in a Quick Start.
+     */
     @JsonProperty("review")
     public void setReview(ConsoleQuickStartTaskReview review) {
         this.review = review;
     }
 
+    /**
+     * ConsoleQuickStartTask is a single step in a Quick Start.
+     */
     @JsonProperty("summary")
     public ConsoleQuickStartTaskSummary getSummary() {
         return summary;
     }
 
+    /**
+     * ConsoleQuickStartTask is a single step in a Quick Start.
+     */
     @JsonProperty("summary")
     public void setSummary(ConsoleQuickStartTaskSummary summary) {
         this.summary = summary;
     }
 
+    /**
+     * title describes the task and is displayed as a step heading.
+     */
     @JsonProperty("title")
     public String getTitle() {
         return title;
     }
 
+    /**
+     * title describes the task and is displayed as a step heading.
+     */
     @JsonProperty("title")
     public void setTitle(String title) {
         this.title = title;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleQuickStartTaskReview.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleQuickStartTaskReview.java
index 8dfd512d780..1d5cf40af9d 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleQuickStartTaskReview.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleQuickStartTaskReview.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleQuickStartTaskReview contains instructions that validate a task was completed successfully.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ConsoleQuickStartTaskReview(String failedTaskHelp, String instructions) {
         this.instructions = instructions;
     }
 
+    /**
+     * failedTaskHelp contains suggestions for a failed task review and is shown at the end of task. (includes markdown)
+     */
     @JsonProperty("failedTaskHelp")
     public String getFailedTaskHelp() {
         return failedTaskHelp;
     }
 
+    /**
+     * failedTaskHelp contains suggestions for a failed task review and is shown at the end of task. (includes markdown)
+     */
     @JsonProperty("failedTaskHelp")
     public void setFailedTaskHelp(String failedTaskHelp) {
         this.failedTaskHelp = failedTaskHelp;
     }
 
+    /**
+     * instructions contains steps that user needs to take in order to validate his work after going through a task. (includes markdown)
+     */
     @JsonProperty("instructions")
     public String getInstructions() {
         return instructions;
     }
 
+    /**
+     * instructions contains steps that user needs to take in order to validate his work after going through a task. (includes markdown)
+     */
     @JsonProperty("instructions")
     public void setInstructions(String instructions) {
         this.instructions = instructions;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleQuickStartTaskSummary.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleQuickStartTaskSummary.java
index 2acd93fe81b..93db3d0ce91 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleQuickStartTaskSummary.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleQuickStartTaskSummary.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleQuickStartTaskSummary contains information about a passed step.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ConsoleQuickStartTaskSummary(String failed, String success) {
         this.success = success;
     }
 
+    /**
+     * failed briefly describes the unsuccessfully passed task. (includes markdown)
+     */
     @JsonProperty("failed")
     public String getFailed() {
         return failed;
     }
 
+    /**
+     * failed briefly describes the unsuccessfully passed task. (includes markdown)
+     */
     @JsonProperty("failed")
     public void setFailed(String failed) {
         this.failed = failed;
     }
 
+    /**
+     * success describes the succesfully passed task.
+     */
     @JsonProperty("success")
     public String getSuccess() {
         return success;
     }
 
+    /**
+     * success describes the succesfully passed task.
+     */
     @JsonProperty("success")
     public void setSuccess(String success) {
         this.success = success;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSample.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSample.java
index db9bbe38102..cd3f828fbc9 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSample.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSample.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleSample is an extension to customizing OpenShift web console by adding samples.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class ConsoleSample implements Editable<ConsoleSampleBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "console.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ConsoleSample";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public ConsoleSample(String apiVersion, String kind, ObjectMeta metadata, Consol
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ConsoleSample is an extension to customizing OpenShift web console by adding samples.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ConsoleSample is an extension to customizing OpenShift web console by adding samples.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ConsoleSample is an extension to customizing OpenShift web console by adding samples.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ConsoleSampleSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ConsoleSample is an extension to customizing OpenShift web console by adding samples.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ConsoleSampleSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleContainerImportSource.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleContainerImportSource.java
index 9a9e9089cec..70ac619594d 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleContainerImportSource.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleContainerImportSource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleSampleContainerImportSource let the user import a container image.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ConsoleSampleContainerImportSource(String image, ConsoleSampleContainerIm
         this.service = service;
     }
 
+    /**
+     * reference to a container image that provides a HTTP service. The service must be exposed on the default port (8080) unless otherwise configured with the port field.<br><p> <br><p> Supported formats:<br><p>   - &lt;repository-name&gt;/&lt;image-name&gt;<br><p>   - docker.io/&lt;repository-name&gt;/&lt;image-name&gt;<br><p>   - quay.io/&lt;repository-name&gt;/&lt;image-name&gt;<br><p>   - quay.io/&lt;repository-name&gt;/&lt;image-name&gt;@sha256:&lt;image hash&gt;<br><p>   - quay.io/&lt;repository-name&gt;/&lt;image-name&gt;:&lt;tag&gt;
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * reference to a container image that provides a HTTP service. The service must be exposed on the default port (8080) unless otherwise configured with the port field.<br><p> <br><p> Supported formats:<br><p>   - &lt;repository-name&gt;/&lt;image-name&gt;<br><p>   - docker.io/&lt;repository-name&gt;/&lt;image-name&gt;<br><p>   - quay.io/&lt;repository-name&gt;/&lt;image-name&gt;<br><p>   - quay.io/&lt;repository-name&gt;/&lt;image-name&gt;@sha256:&lt;image hash&gt;<br><p>   - quay.io/&lt;repository-name&gt;/&lt;image-name&gt;:&lt;tag&gt;
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
     }
 
+    /**
+     * ConsoleSampleContainerImportSource let the user import a container image.
+     */
     @JsonProperty("service")
     public ConsoleSampleContainerImportSourceService getService() {
         return service;
     }
 
+    /**
+     * ConsoleSampleContainerImportSource let the user import a container image.
+     */
     @JsonProperty("service")
     public void setService(ConsoleSampleContainerImportSourceService service) {
         this.service = service;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleContainerImportSourceService.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleContainerImportSourceService.java
index f86f8b029ea..90bd1fcc7bd 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleContainerImportSourceService.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleContainerImportSourceService.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleSampleContainerImportSourceService let the samples author define defaults for the Service created for this sample.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ConsoleSampleContainerImportSourceService(Integer targetPort) {
         this.targetPort = targetPort;
     }
 
+    /**
+     * targetPort is the port that the service listens on for HTTP requests. This port will be used for Service and Route created for this sample. Port must be in the range 1 to 65535. Default port is 8080.
+     */
     @JsonProperty("targetPort")
     public Integer getTargetPort() {
         return targetPort;
     }
 
+    /**
+     * targetPort is the port that the service listens on for HTTP requests. This port will be used for Service and Route created for this sample. Port must be in the range 1 to 65535. Default port is 8080.
+     */
     @JsonProperty("targetPort")
     public void setTargetPort(Integer targetPort) {
         this.targetPort = targetPort;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleGitImportSource.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleGitImportSource.java
index c518b1bc193..5a0c1922d88 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleGitImportSource.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleGitImportSource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleSampleGitImportSource let the user import code from a public Git repository.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ConsoleSampleGitImportSource(ConsoleSampleGitImportSourceRepository repos
         this.service = service;
     }
 
+    /**
+     * ConsoleSampleGitImportSource let the user import code from a public Git repository.
+     */
     @JsonProperty("repository")
     public ConsoleSampleGitImportSourceRepository getRepository() {
         return repository;
     }
 
+    /**
+     * ConsoleSampleGitImportSource let the user import code from a public Git repository.
+     */
     @JsonProperty("repository")
     public void setRepository(ConsoleSampleGitImportSourceRepository repository) {
         this.repository = repository;
     }
 
+    /**
+     * ConsoleSampleGitImportSource let the user import code from a public Git repository.
+     */
     @JsonProperty("service")
     public ConsoleSampleGitImportSourceService getService() {
         return service;
     }
 
+    /**
+     * ConsoleSampleGitImportSource let the user import code from a public Git repository.
+     */
     @JsonProperty("service")
     public void setService(ConsoleSampleGitImportSourceService service) {
         this.service = service;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleGitImportSourceRepository.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleGitImportSourceRepository.java
index beaeeaa65b3..ebd79c3c22a 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleGitImportSourceRepository.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleGitImportSourceRepository.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleSampleGitImportSourceRepository let the user import code from a public git repository.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ConsoleSampleGitImportSourceRepository(String contextDir, String revision
         this.url = url;
     }
 
+    /**
+     * contextDir is used to specify a directory within the repository to build the component. Must start with `/` and have a maximum length of 256 characters. When omitted, the default value is to build from the root of the repository.
+     */
     @JsonProperty("contextDir")
     public String getContextDir() {
         return contextDir;
     }
 
+    /**
+     * contextDir is used to specify a directory within the repository to build the component. Must start with `/` and have a maximum length of 256 characters. When omitted, the default value is to build from the root of the repository.
+     */
     @JsonProperty("contextDir")
     public void setContextDir(String contextDir) {
         this.contextDir = contextDir;
     }
 
+    /**
+     * revision is the git revision at which to clone the git repository Can be used to clone a specific branch, tag or commit SHA. Must be at most 256 characters in length. When omitted the repository's default branch is used.
+     */
     @JsonProperty("revision")
     public String getRevision() {
         return revision;
     }
 
+    /**
+     * revision is the git revision at which to clone the git repository Can be used to clone a specific branch, tag or commit SHA. Must be at most 256 characters in length. When omitted the repository's default branch is used.
+     */
     @JsonProperty("revision")
     public void setRevision(String revision) {
         this.revision = revision;
     }
 
+    /**
+     * url of the Git repository that contains a HTTP service. The HTTP service must be exposed on the default port (8080) unless otherwise configured with the port field.<br><p> <br><p> Only public repositories on GitHub, GitLab and Bitbucket are currently supported:<br><p> <br><p>   - https://github.com/&lt;org&gt;/&lt;repository&gt;<br><p>   - https://gitlab.com/&lt;org&gt;/&lt;repository&gt;<br><p>   - https://bitbucket.org/&lt;org&gt;/&lt;repository&gt;<br><p> <br><p> The url must have a maximum length of 256 characters.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * url of the Git repository that contains a HTTP service. The HTTP service must be exposed on the default port (8080) unless otherwise configured with the port field.<br><p> <br><p> Only public repositories on GitHub, GitLab and Bitbucket are currently supported:<br><p> <br><p>   - https://github.com/&lt;org&gt;/&lt;repository&gt;<br><p>   - https://gitlab.com/&lt;org&gt;/&lt;repository&gt;<br><p>   - https://bitbucket.org/&lt;org&gt;/&lt;repository&gt;<br><p> <br><p> The url must have a maximum length of 256 characters.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleGitImportSourceService.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleGitImportSourceService.java
index 45b2e3e4161..e4de92ab4ec 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleGitImportSourceService.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleGitImportSourceService.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleSampleGitImportSourceService let the samples author define defaults for the Service created for this sample.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ConsoleSampleGitImportSourceService(Integer targetPort) {
         this.targetPort = targetPort;
     }
 
+    /**
+     * targetPort is the port that the service listens on for HTTP requests. This port will be used for Service created for this sample. Port must be in the range 1 to 65535. Default port is 8080.
+     */
     @JsonProperty("targetPort")
     public Integer getTargetPort() {
         return targetPort;
     }
 
+    /**
+     * targetPort is the port that the service listens on for HTTP requests. This port will be used for Service created for this sample. Port must be in the range 1 to 65535. Default port is 8080.
+     */
     @JsonProperty("targetPort")
     public void setTargetPort(Integer targetPort) {
         this.targetPort = targetPort;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleList.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleList.java
index 3ecb180fd35..6f368303b66 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleList.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ConsoleSampleList implements Editable<ConsoleSampleListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.console.v1.ConsoleSample>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "console.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.console.v1.ConsoleSample> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ConsoleSampleList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ConsoleSampleList(String apiVersion, List<io.fabric8.openshift.api.model.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.console.v1.ConsoleSample> getItems() {
         return items;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.console.v1.ConsoleSample> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleSource.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleSource.java
index 41e3ad5358d..d60f33af1a7 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleSource.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleSource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleSampleSource is the actual sample definition and can hold different sample types. Unsupported sample types will be ignored in the web console.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ConsoleSampleSource(ConsoleSampleContainerImportSource containerImport, C
         this.type = type;
     }
 
+    /**
+     * ConsoleSampleSource is the actual sample definition and can hold different sample types. Unsupported sample types will be ignored in the web console.
+     */
     @JsonProperty("containerImport")
     public ConsoleSampleContainerImportSource getContainerImport() {
         return containerImport;
     }
 
+    /**
+     * ConsoleSampleSource is the actual sample definition and can hold different sample types. Unsupported sample types will be ignored in the web console.
+     */
     @JsonProperty("containerImport")
     public void setContainerImport(ConsoleSampleContainerImportSource containerImport) {
         this.containerImport = containerImport;
     }
 
+    /**
+     * ConsoleSampleSource is the actual sample definition and can hold different sample types. Unsupported sample types will be ignored in the web console.
+     */
     @JsonProperty("gitImport")
     public ConsoleSampleGitImportSource getGitImport() {
         return gitImport;
     }
 
+    /**
+     * ConsoleSampleSource is the actual sample definition and can hold different sample types. Unsupported sample types will be ignored in the web console.
+     */
     @JsonProperty("gitImport")
     public void setGitImport(ConsoleSampleGitImportSource gitImport) {
         this.gitImport = gitImport;
     }
 
+    /**
+     * type of the sample, currently supported: "GitImport";"ContainerImport"
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type of the sample, currently supported: "GitImport";"ContainerImport"
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleSpec.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleSpec.java
index 19cff0b62e7..bdd6fed0546 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleSpec.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleSampleSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleSampleSpec is the desired sample for the web console. Samples will appear with their title, descriptions and a badge in a samples catalog.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -109,82 +112,130 @@ public ConsoleSampleSpec(String _abstract, String description, String icon, Stri
         this.type = type;
     }
 
+    /**
+     * abstract is a short introduction to the sample.<br><p> <br><p> It is required and must be no more than 100 characters in length.<br><p> <br><p> The abstract is shown on the sample card tile below the title and provider and is limited to three lines of content.
+     */
     @JsonProperty("abstract")
     public String getAbstract() {
         return _abstract;
     }
 
+    /**
+     * abstract is a short introduction to the sample.<br><p> <br><p> It is required and must be no more than 100 characters in length.<br><p> <br><p> The abstract is shown on the sample card tile below the title and provider and is limited to three lines of content.
+     */
     @JsonProperty("abstract")
     public void setAbstract(String _abstract) {
         this._abstract = _abstract;
     }
 
+    /**
+     * description is a long form explanation of the sample.<br><p> <br><p> It is required and can have a maximum length of &#42;&#42;4096&#42;&#42; characters.<br><p> <br><p> It is a README.md-like content for additional information, links, pre-conditions, and other instructions. It will be rendered as Markdown so that it can contain line breaks, links, and other simple formatting.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * description is a long form explanation of the sample.<br><p> <br><p> It is required and can have a maximum length of &#42;&#42;4096&#42;&#42; characters.<br><p> <br><p> It is a README.md-like content for additional information, links, pre-conditions, and other instructions. It will be rendered as Markdown so that it can contain line breaks, links, and other simple formatting.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * icon is an optional base64 encoded image and shown beside the sample title.<br><p> <br><p> The format must follow the data: URL format and can have a maximum size of &#42;&#42;10 KB&#42;&#42;.<br><p> <br><p>   data:[&lt;mediatype&gt;][;base64],&lt;base64 encoded image&gt;<br><p> <br><p> For example:<br><p> <br><p>   data:image;base64,             plus the base64 encoded image.<br><p> <br><p> Vector images can also be used. SVG icons must start with:<br><p> <br><p>   data:image/svg+xml;base64,     plus the base64 encoded SVG image.<br><p> <br><p> All sample catalog icons will be shown on a white background (also when the dark theme is used). The web console ensures that different aspect ratios work correctly. Currently, the surface of the icon is at most 40x100px.<br><p> <br><p> For more information on the data URL format, please visit https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs.
+     */
     @JsonProperty("icon")
     public String getIcon() {
         return icon;
     }
 
+    /**
+     * icon is an optional base64 encoded image and shown beside the sample title.<br><p> <br><p> The format must follow the data: URL format and can have a maximum size of &#42;&#42;10 KB&#42;&#42;.<br><p> <br><p>   data:[&lt;mediatype&gt;][;base64],&lt;base64 encoded image&gt;<br><p> <br><p> For example:<br><p> <br><p>   data:image;base64,             plus the base64 encoded image.<br><p> <br><p> Vector images can also be used. SVG icons must start with:<br><p> <br><p>   data:image/svg+xml;base64,     plus the base64 encoded SVG image.<br><p> <br><p> All sample catalog icons will be shown on a white background (also when the dark theme is used). The web console ensures that different aspect ratios work correctly. Currently, the surface of the icon is at most 40x100px.<br><p> <br><p> For more information on the data URL format, please visit https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs.
+     */
     @JsonProperty("icon")
     public void setIcon(String icon) {
         this.icon = icon;
     }
 
+    /**
+     * provider is an optional label to honor who provides the sample.<br><p> <br><p> It is optional and must be no more than 50 characters in length.<br><p> <br><p> A provider can be a company like "Red Hat" or an organization like "CNCF" or "Knative".<br><p> <br><p> Currently, the provider is only shown on the sample card tile below the title with the prefix "Provided by "
+     */
     @JsonProperty("provider")
     public String getProvider() {
         return provider;
     }
 
+    /**
+     * provider is an optional label to honor who provides the sample.<br><p> <br><p> It is optional and must be no more than 50 characters in length.<br><p> <br><p> A provider can be a company like "Red Hat" or an organization like "CNCF" or "Knative".<br><p> <br><p> Currently, the provider is only shown on the sample card tile below the title with the prefix "Provided by "
+     */
     @JsonProperty("provider")
     public void setProvider(String provider) {
         this.provider = provider;
     }
 
+    /**
+     * ConsoleSampleSpec is the desired sample for the web console. Samples will appear with their title, descriptions and a badge in a samples catalog.
+     */
     @JsonProperty("source")
     public ConsoleSampleSource getSource() {
         return source;
     }
 
+    /**
+     * ConsoleSampleSpec is the desired sample for the web console. Samples will appear with their title, descriptions and a badge in a samples catalog.
+     */
     @JsonProperty("source")
     public void setSource(ConsoleSampleSource source) {
         this.source = source;
     }
 
+    /**
+     * tags are optional string values that can be used to find samples in the samples catalog.<br><p> <br><p> Examples of common tags may be "Java", "Quarkus", etc.<br><p> <br><p> They will be displayed on the samples details page.
+     */
     @JsonProperty("tags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getTags() {
         return tags;
     }
 
+    /**
+     * tags are optional string values that can be used to find samples in the samples catalog.<br><p> <br><p> Examples of common tags may be "Java", "Quarkus", etc.<br><p> <br><p> They will be displayed on the samples details page.
+     */
     @JsonProperty("tags")
     public void setTags(List<String> tags) {
         this.tags = tags;
     }
 
+    /**
+     * title is the display name of the sample.<br><p> <br><p> It is required and must be no more than 50 characters in length.
+     */
     @JsonProperty("title")
     public String getTitle() {
         return title;
     }
 
+    /**
+     * title is the display name of the sample.<br><p> <br><p> It is required and must be no more than 50 characters in length.
+     */
     @JsonProperty("title")
     public void setTitle(String title) {
         this.title = title;
     }
 
+    /**
+     * type is an optional label to group multiple samples.<br><p> <br><p> It is optional and must be no more than 20 characters in length.<br><p> <br><p> Recommendation is a singular term like "Builder Image", "Devfile" or "Serverless Function".<br><p> <br><p> Currently, the type is shown a badge on the sample card tile in the top right corner.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is an optional label to group multiple samples.<br><p> <br><p> It is optional and must be no more than 20 characters in length.<br><p> <br><p> Recommendation is a singular term like "Builder Image", "Devfile" or "Serverless Function".<br><p> <br><p> Currently, the type is shown a badge on the sample card tile in the top right corner.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleYAMLSample.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleYAMLSample.java
index 60133c89c90..1f730ab5f10 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleYAMLSample.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleYAMLSample.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleYAMLSample is an extension for customizing OpenShift web console YAML samples.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class ConsoleYAMLSample implements Editable<ConsoleYAMLSampleBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "console.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ConsoleYAMLSample";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public ConsoleYAMLSample(String apiVersion, String kind, ObjectMeta metadata, Co
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ConsoleYAMLSample is an extension for customizing OpenShift web console YAML samples.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ConsoleYAMLSample is an extension for customizing OpenShift web console YAML samples.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ConsoleYAMLSample is an extension for customizing OpenShift web console YAML samples.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ConsoleYAMLSampleSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ConsoleYAMLSample is an extension for customizing OpenShift web console YAML samples.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ConsoleYAMLSampleSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleYAMLSampleList.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleYAMLSampleList.java
index 0ca104e76f2..dc26296cbad 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleYAMLSampleList.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleYAMLSampleList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ConsoleYAMLSampleList implements Editable<ConsoleYAMLSampleListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.console.v1.ConsoleYAMLSample>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "console.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.console.v1.ConsoleYAMLSample> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ConsoleYAMLSampleList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ConsoleYAMLSampleList(String apiVersion, List<io.fabric8.openshift.api.mo
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.console.v1.ConsoleYAMLSample> getItems() {
         return items;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.console.v1.ConsoleYAMLSample> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleYAMLSampleSpec.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleYAMLSampleSpec.java
index 92a99112a3d..9c481b255d9 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleYAMLSampleSpec.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/ConsoleYAMLSampleSpec.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleYAMLSampleSpec is the desired YAML sample configuration. Samples will appear with their descriptions in a samples sidebar when creating a resources in the web console.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,51 +98,81 @@ public ConsoleYAMLSampleSpec(String description, Boolean snippet, TypeMeta targe
         this.yaml = yaml;
     }
 
+    /**
+     * description of the YAML sample.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * description of the YAML sample.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * snippet indicates that the YAML sample is not the full YAML resource definition, but a fragment that can be inserted into the existing YAML document at the user's cursor.
+     */
     @JsonProperty("snippet")
     public Boolean getSnippet() {
         return snippet;
     }
 
+    /**
+     * snippet indicates that the YAML sample is not the full YAML resource definition, but a fragment that can be inserted into the existing YAML document at the user's cursor.
+     */
     @JsonProperty("snippet")
     public void setSnippet(Boolean snippet) {
         this.snippet = snippet;
     }
 
+    /**
+     * ConsoleYAMLSampleSpec is the desired YAML sample configuration. Samples will appear with their descriptions in a samples sidebar when creating a resources in the web console.
+     */
     @JsonProperty("targetResource")
     public TypeMeta getTargetResource() {
         return targetResource;
     }
 
+    /**
+     * ConsoleYAMLSampleSpec is the desired YAML sample configuration. Samples will appear with their descriptions in a samples sidebar when creating a resources in the web console.
+     */
     @JsonProperty("targetResource")
     public void setTargetResource(TypeMeta targetResource) {
         this.targetResource = targetResource;
     }
 
+    /**
+     * title of the YAML sample.
+     */
     @JsonProperty("title")
     public String getTitle() {
         return title;
     }
 
+    /**
+     * title of the YAML sample.
+     */
     @JsonProperty("title")
     public void setTitle(String title) {
         this.title = title;
     }
 
+    /**
+     * yaml is the YAML sample to display.
+     */
     @JsonProperty("yaml")
     public String getYaml() {
         return yaml;
     }
 
+    /**
+     * yaml is the YAML sample to display.
+     */
     @JsonProperty("yaml")
     public void setYaml(String yaml) {
         this.yaml = yaml;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/Link.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/Link.java
index 3e82c22c5c9..61d3ad1fd7c 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/Link.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/Link.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Represents a standard link that could be generated in HTML
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Link(String href, String text) {
         this.text = text;
     }
 
+    /**
+     * href is the absolute secure URL for the link (must use https)
+     */
     @JsonProperty("href")
     public String getHref() {
         return href;
     }
 
+    /**
+     * href is the absolute secure URL for the link (must use https)
+     */
     @JsonProperty("href")
     public void setHref(String href) {
         this.href = href;
     }
 
+    /**
+     * text is the display text for the link
+     */
     @JsonProperty("text")
     public String getText() {
         return text;
     }
 
+    /**
+     * text is the display text for the link
+     */
     @JsonProperty("text")
     public void setText(String text) {
         this.text = text;
diff --git a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/NamespaceDashboardSpec.java b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/NamespaceDashboardSpec.java
index 29b2dc92bce..91098b1cce2 100644
--- a/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/NamespaceDashboardSpec.java
+++ b/kubernetes-model-generator/openshift-model-console/src/generated/java/io/fabric8/openshift/api/model/console/v1/NamespaceDashboardSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NamespaceDashboardSpec is a specification of namespaces in which the dashboard link should appear. If both namespaces and namespaceSelector are specified, the link will appear in namespaces that match either
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public NamespaceDashboardSpec(LabelSelector namespaceSelector, List<String> name
         this.namespaces = namespaces;
     }
 
+    /**
+     * NamespaceDashboardSpec is a specification of namespaces in which the dashboard link should appear. If both namespaces and namespaceSelector are specified, the link will appear in namespaces that match either
+     */
     @JsonProperty("namespaceSelector")
     public LabelSelector getNamespaceSelector() {
         return namespaceSelector;
     }
 
+    /**
+     * NamespaceDashboardSpec is a specification of namespaces in which the dashboard link should appear. If both namespaces and namespaceSelector are specified, the link will appear in namespaces that match either
+     */
     @JsonProperty("namespaceSelector")
     public void setNamespaceSelector(LabelSelector namespaceSelector) {
         this.namespaceSelector = namespaceSelector;
     }
 
+    /**
+     * namespaces is an array of namespace names in which the dashboard link should appear.
+     */
     @JsonProperty("namespaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNamespaces() {
         return namespaces;
     }
 
+    /**
+     * namespaces is an array of namespace names in which the dashboard link should appear.
+     */
     @JsonProperty("namespaces")
     public void setNamespaces(List<String> namespaces) {
         this.namespaces = namespaces;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/agent/v1/BareMetalPlatform.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/agent/v1/BareMetalPlatform.java
index 264ad414bde..3bcbe6cca71 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/agent/v1/BareMetalPlatform.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/agent/v1/BareMetalPlatform.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BareMetalPlatform defines agent based install configuration specific to bare metal clusters. Can only be used with spec.installStrategy.agent.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public BareMetalPlatform(LabelSelector agentSelector) {
         this.agentSelector = agentSelector;
     }
 
+    /**
+     * BareMetalPlatform defines agent based install configuration specific to bare metal clusters. Can only be used with spec.installStrategy.agent.
+     */
     @JsonProperty("agentSelector")
     public LabelSelector getAgentSelector() {
         return agentSelector;
     }
 
+    /**
+     * BareMetalPlatform defines agent based install configuration specific to bare metal clusters. Can only be used with spec.installStrategy.agent.
+     */
     @JsonProperty("agentSelector")
     public void setAgentSelector(LabelSelector agentSelector) {
         this.agentSelector = agentSelector;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/AssumeRole.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/AssumeRole.java
index 3ac14f28916..9e6a37c7570 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/AssumeRole.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/AssumeRole.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AssumeRole stores information for the IAM role that needs to be assumed using an existing AWS session.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public AssumeRole(String externalID, String roleARN) {
         this.roleARN = roleARN;
     }
 
+    /**
+     * ExternalID is random string generated by platform so that assume role is protected from confused deputy problem. more info: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user_externalid.html
+     */
     @JsonProperty("externalID")
     public String getExternalID() {
         return externalID;
     }
 
+    /**
+     * ExternalID is random string generated by platform so that assume role is protected from confused deputy problem. more info: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user_externalid.html
+     */
     @JsonProperty("externalID")
     public void setExternalID(String externalID) {
         this.externalID = externalID;
     }
 
+    /**
+     * AssumeRole stores information for the IAM role that needs to be assumed using an existing AWS session.
+     */
     @JsonProperty("roleARN")
     public String getRoleARN() {
         return roleARN;
     }
 
+    /**
+     * AssumeRole stores information for the IAM role that needs to be assumed using an existing AWS session.
+     */
     @JsonProperty("roleARN")
     public void setRoleARN(String roleARN) {
         this.roleARN = roleARN;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/EC2Metadata.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/EC2Metadata.java
index 7863d0d0467..c33da41e1c4 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/EC2Metadata.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/EC2Metadata.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EC2Metadata defines the metadata service interaction options for an ec2 instance. https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-service.html
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public EC2Metadata(String authentication) {
         this.authentication = authentication;
     }
 
+    /**
+     * Authentication determines whether or not the host requires the use of authentication when interacting with the metadata service. When using authentication, this enforces v2 interaction method (IMDSv2) with the metadata service. When omitted, this means the user has no opinion and the value is left to the platform to choose a good default, which is subject to change over time. The current default is optional. At this point this field represents `HttpTokens` parameter from `InstanceMetadataOptionsRequest` structure in AWS EC2 API https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_InstanceMetadataOptionsRequest.html
+     */
     @JsonProperty("authentication")
     public String getAuthentication() {
         return authentication;
     }
 
+    /**
+     * Authentication determines whether or not the host requires the use of authentication when interacting with the metadata service. When using authentication, this enforces v2 interaction method (IMDSv2) with the metadata service. When omitted, this means the user has no opinion and the value is left to the platform to choose a good default, which is subject to change over time. The current default is optional. At this point this field represents `HttpTokens` parameter from `InstanceMetadataOptionsRequest` structure in AWS EC2 API https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_InstanceMetadataOptionsRequest.html
+     */
     @JsonProperty("authentication")
     public void setAuthentication(String authentication) {
         this.authentication = authentication;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/EC2RootVolume.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/EC2RootVolume.java
index a9ca02493e3..d367ad49518 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/EC2RootVolume.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/EC2RootVolume.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EC2RootVolume defines the storage for an ec2 instance.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public EC2RootVolume(Integer iops, String kmsKeyARN, Integer size, String type)
         this.type = type;
     }
 
+    /**
+     * IOPS defines the iops for the storage.
+     */
     @JsonProperty("iops")
     public Integer getIops() {
         return iops;
     }
 
+    /**
+     * IOPS defines the iops for the storage.
+     */
     @JsonProperty("iops")
     public void setIops(Integer iops) {
         this.iops = iops;
     }
 
+    /**
+     * The KMS key that will be used to encrypt the EBS volume. If no key is provided the default KMS key for the account will be used. https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_GetEbsDefaultKmsKeyId.html
+     */
     @JsonProperty("kmsKeyARN")
     public String getKmsKeyARN() {
         return kmsKeyARN;
     }
 
+    /**
+     * The KMS key that will be used to encrypt the EBS volume. If no key is provided the default KMS key for the account will be used. https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_GetEbsDefaultKmsKeyId.html
+     */
     @JsonProperty("kmsKeyARN")
     public void setKmsKeyARN(String kmsKeyARN) {
         this.kmsKeyARN = kmsKeyARN;
     }
 
+    /**
+     * Size defines the size of the storage.
+     */
     @JsonProperty("size")
     public Integer getSize() {
         return size;
     }
 
+    /**
+     * Size defines the size of the storage.
+     */
     @JsonProperty("size")
     public void setSize(Integer size) {
         this.size = size;
     }
 
+    /**
+     * Type defines the type of the storage.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type defines the type of the storage.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/MachinePoolPlatform.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/MachinePoolPlatform.java
index e95a5a94bb5..fe9e8f86cd3 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/MachinePoolPlatform.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/MachinePoolPlatform.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePoolPlatform stores the configuration for a machine pool installed on AWS.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -112,85 +115,133 @@ public MachinePoolPlatform(List<String> additionalSecurityGroupIDs, EC2Metadata
         this.zones = zones;
     }
 
+    /**
+     * AdditionalSecurityGroupIDs contains IDs of additional security groups for machines, where each ID is presented in the format sg-xxxx.
+     */
     @JsonProperty("additionalSecurityGroupIDs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAdditionalSecurityGroupIDs() {
         return additionalSecurityGroupIDs;
     }
 
+    /**
+     * AdditionalSecurityGroupIDs contains IDs of additional security groups for machines, where each ID is presented in the format sg-xxxx.
+     */
     @JsonProperty("additionalSecurityGroupIDs")
     public void setAdditionalSecurityGroupIDs(List<String> additionalSecurityGroupIDs) {
         this.additionalSecurityGroupIDs = additionalSecurityGroupIDs;
     }
 
+    /**
+     * MachinePoolPlatform stores the configuration for a machine pool installed on AWS.
+     */
     @JsonProperty("metadataService")
     public EC2Metadata getMetadataService() {
         return metadataService;
     }
 
+    /**
+     * MachinePoolPlatform stores the configuration for a machine pool installed on AWS.
+     */
     @JsonProperty("metadataService")
     public void setMetadataService(EC2Metadata metadataService) {
         this.metadataService = metadataService;
     }
 
+    /**
+     * MachinePoolPlatform stores the configuration for a machine pool installed on AWS.
+     */
     @JsonProperty("rootVolume")
     public EC2RootVolume getRootVolume() {
         return rootVolume;
     }
 
+    /**
+     * MachinePoolPlatform stores the configuration for a machine pool installed on AWS.
+     */
     @JsonProperty("rootVolume")
     public void setRootVolume(EC2RootVolume rootVolume) {
         this.rootVolume = rootVolume;
     }
 
+    /**
+     * MachinePoolPlatform stores the configuration for a machine pool installed on AWS.
+     */
     @JsonProperty("spotMarketOptions")
     public SpotMarketOptions getSpotMarketOptions() {
         return spotMarketOptions;
     }
 
+    /**
+     * MachinePoolPlatform stores the configuration for a machine pool installed on AWS.
+     */
     @JsonProperty("spotMarketOptions")
     public void setSpotMarketOptions(SpotMarketOptions spotMarketOptions) {
         this.spotMarketOptions = spotMarketOptions;
     }
 
+    /**
+     * Subnets is the list of IDs of subnets to which to attach the machines. There must be exactly one subnet for each availability zone used. These subnets may be public or private. As a special case, for consistency with install-config, you may specify exactly one private and one public subnet for each availability zone. In this case, the public subnets will be filtered out and only the private subnets will be used. If empty/omitted, we will look for subnets in each availability zone tagged with Name=&lt;clusterID&gt;-private-&lt;az&gt; (legacy terraform) or &lt;clusterID&gt;-subnet-private-&lt;az&gt; (CAPA).
+     */
     @JsonProperty("subnets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSubnets() {
         return subnets;
     }
 
+    /**
+     * Subnets is the list of IDs of subnets to which to attach the machines. There must be exactly one subnet for each availability zone used. These subnets may be public or private. As a special case, for consistency with install-config, you may specify exactly one private and one public subnet for each availability zone. In this case, the public subnets will be filtered out and only the private subnets will be used. If empty/omitted, we will look for subnets in each availability zone tagged with Name=&lt;clusterID&gt;-private-&lt;az&gt; (legacy terraform) or &lt;clusterID&gt;-subnet-private-&lt;az&gt; (CAPA).
+     */
     @JsonProperty("subnets")
     public void setSubnets(List<String> subnets) {
         this.subnets = subnets;
     }
 
+    /**
+     * InstanceType defines the ec2 instance type. eg. m4-large
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * InstanceType defines the ec2 instance type. eg. m4-large
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * UserTags contains the user defined tags to be supplied for the ec2 instance. Note that these will be merged with ClusterDeployment.Spec.Platform.AWS.UserTags, with this field taking precedence when keys collide.
+     */
     @JsonProperty("userTags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getUserTags() {
         return userTags;
     }
 
+    /**
+     * UserTags contains the user defined tags to be supplied for the ec2 instance. Note that these will be merged with ClusterDeployment.Spec.Platform.AWS.UserTags, with this field taking precedence when keys collide.
+     */
     @JsonProperty("userTags")
     public void setUserTags(Map<String, String> userTags) {
         this.userTags = userTags;
     }
 
+    /**
+     * Zones is list of availability zones that can be used.
+     */
     @JsonProperty("zones")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getZones() {
         return zones;
     }
 
+    /**
+     * Zones is list of availability zones that can be used.
+     */
     @JsonProperty("zones")
     public void setZones(List<String> zones) {
         this.zones = zones;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/Metadata.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/Metadata.java
index c35619221a3..2c4a57d2282 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/Metadata.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/Metadata.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metadata contains AWS metadata (e.g. for uninstalling the cluster).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public Metadata(String hostedZoneRole) {
         this.hostedZoneRole = hostedZoneRole;
     }
 
+    /**
+     * HostedZoneRole is the role to assume when performing operations on a hosted zone owned by another account.
+     */
     @JsonProperty("hostedZoneRole")
     public String getHostedZoneRole() {
         return hostedZoneRole;
     }
 
+    /**
+     * HostedZoneRole is the role to assume when performing operations on a hosted zone owned by another account.
+     */
     @JsonProperty("hostedZoneRole")
     public void setHostedZoneRole(String hostedZoneRole) {
         this.hostedZoneRole = hostedZoneRole;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/Platform.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/Platform.java
index 28744db8d35..88454d9762e 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/Platform.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/Platform.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Platform stores all the global configuration that all machinesets use.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,52 +98,82 @@ public Platform(AssumeRole credentialsAssumeRole, LocalObjectReference credentia
         this.userTags = userTags;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("credentialsAssumeRole")
     public AssumeRole getCredentialsAssumeRole() {
         return credentialsAssumeRole;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("credentialsAssumeRole")
     public void setCredentialsAssumeRole(AssumeRole credentialsAssumeRole) {
         this.credentialsAssumeRole = credentialsAssumeRole;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("credentialsSecretRef")
     public LocalObjectReference getCredentialsSecretRef() {
         return credentialsSecretRef;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("credentialsSecretRef")
     public void setCredentialsSecretRef(LocalObjectReference credentialsSecretRef) {
         this.credentialsSecretRef = credentialsSecretRef;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("privateLink")
     public PrivateLinkAccess getPrivateLink() {
         return privateLink;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("privateLink")
     public void setPrivateLink(PrivateLinkAccess privateLink) {
         this.privateLink = privateLink;
     }
 
+    /**
+     * Region specifies the AWS region where the cluster will be created.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Region specifies the AWS region where the cluster will be created.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * UserTags specifies additional tags for AWS resources created for the cluster.
+     */
     @JsonProperty("userTags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getUserTags() {
         return userTags;
     }
 
+    /**
+     * UserTags specifies additional tags for AWS resources created for the cluster.
+     */
     @JsonProperty("userTags")
     public void setUserTags(Map<String, String> userTags) {
         this.userTags = userTags;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/PlatformStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/PlatformStatus.java
index 3519db46781..150444e98a4 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/PlatformStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/PlatformStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PlatformStatus contains the observed state on AWS platform.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public PlatformStatus(PrivateLinkAccessStatus privateLink) {
         this.privateLink = privateLink;
     }
 
+    /**
+     * PlatformStatus contains the observed state on AWS platform.
+     */
     @JsonProperty("privateLink")
     public PrivateLinkAccessStatus getPrivateLink() {
         return privateLink;
     }
 
+    /**
+     * PlatformStatus contains the observed state on AWS platform.
+     */
     @JsonProperty("privateLink")
     public void setPrivateLink(PrivateLinkAccessStatus privateLink) {
         this.privateLink = privateLink;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/PrivateLinkAccess.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/PrivateLinkAccess.java
index 7068a4072fd..04655a973e2 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/PrivateLinkAccess.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/PrivateLinkAccess.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PrivateLinkAccess configures access to the cluster API using AWS PrivateLink
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public PrivateLinkAccess(List<String> additionalAllowedPrincipals, Boolean enabl
         this.enabled = enabled;
     }
 
+    /**
+     * AdditionalAllowedPrincipals is a list of additional allowed principal ARNs to be configured for the Private Link cluster's VPC Endpoint Service. ARNs provided as AdditionalAllowedPrincipals will be configured for the cluster's VPC Endpoint Service in addition to the IAM entity used by Hive.
+     */
     @JsonProperty("additionalAllowedPrincipals")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAdditionalAllowedPrincipals() {
         return additionalAllowedPrincipals;
     }
 
+    /**
+     * AdditionalAllowedPrincipals is a list of additional allowed principal ARNs to be configured for the Private Link cluster's VPC Endpoint Service. ARNs provided as AdditionalAllowedPrincipals will be configured for the cluster's VPC Endpoint Service in addition to the IAM entity used by Hive.
+     */
     @JsonProperty("additionalAllowedPrincipals")
     public void setAdditionalAllowedPrincipals(List<String> additionalAllowedPrincipals) {
         this.additionalAllowedPrincipals = additionalAllowedPrincipals;
     }
 
+    /**
+     * PrivateLinkAccess configures access to the cluster API using AWS PrivateLink
+     */
     @JsonProperty("enabled")
     public Boolean getEnabled() {
         return enabled;
     }
 
+    /**
+     * PrivateLinkAccess configures access to the cluster API using AWS PrivateLink
+     */
     @JsonProperty("enabled")
     public void setEnabled(Boolean enabled) {
         this.enabled = enabled;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/PrivateLinkAccessStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/PrivateLinkAccessStatus.java
index 9d196e84e55..0359aa7c316 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/PrivateLinkAccessStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/PrivateLinkAccessStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PrivateLinkAccessStatus contains the observed state for PrivateLinkAccess resources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public PrivateLinkAccessStatus(String hostedZoneID, String vpcEndpointID, VPCEnd
         this.vpcEndpointService = vpcEndpointService;
     }
 
+    /**
+     * PrivateLinkAccessStatus contains the observed state for PrivateLinkAccess resources.
+     */
     @JsonProperty("hostedZoneID")
     public String getHostedZoneID() {
         return hostedZoneID;
     }
 
+    /**
+     * PrivateLinkAccessStatus contains the observed state for PrivateLinkAccess resources.
+     */
     @JsonProperty("hostedZoneID")
     public void setHostedZoneID(String hostedZoneID) {
         this.hostedZoneID = hostedZoneID;
     }
 
+    /**
+     * PrivateLinkAccessStatus contains the observed state for PrivateLinkAccess resources.
+     */
     @JsonProperty("vpcEndpointID")
     public String getVpcEndpointID() {
         return vpcEndpointID;
     }
 
+    /**
+     * PrivateLinkAccessStatus contains the observed state for PrivateLinkAccess resources.
+     */
     @JsonProperty("vpcEndpointID")
     public void setVpcEndpointID(String vpcEndpointID) {
         this.vpcEndpointID = vpcEndpointID;
     }
 
+    /**
+     * PrivateLinkAccessStatus contains the observed state for PrivateLinkAccess resources.
+     */
     @JsonProperty("vpcEndpointService")
     public VPCEndpointService getVpcEndpointService() {
         return vpcEndpointService;
     }
 
+    /**
+     * PrivateLinkAccessStatus contains the observed state for PrivateLinkAccess resources.
+     */
     @JsonProperty("vpcEndpointService")
     public void setVpcEndpointService(VPCEndpointService vpcEndpointService) {
         this.vpcEndpointService = vpcEndpointService;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/SpotMarketOptions.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/SpotMarketOptions.java
index 27fdaa89432..cfede076aa4 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/SpotMarketOptions.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/SpotMarketOptions.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SpotMarketOptions defines the options available to a user when configuring Machines to run on Spot instances. Most users should provide an empty struct.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public SpotMarketOptions(String maxPrice) {
         this.maxPrice = maxPrice;
     }
 
+    /**
+     * The maximum price the user is willing to pay for their instances Default: On-Demand price
+     */
     @JsonProperty("maxPrice")
     public String getMaxPrice() {
         return maxPrice;
     }
 
+    /**
+     * The maximum price the user is willing to pay for their instances Default: On-Demand price
+     */
     @JsonProperty("maxPrice")
     public void setMaxPrice(String maxPrice) {
         this.maxPrice = maxPrice;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/VPCEndpointService.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/VPCEndpointService.java
index 3343992480f..778b8a0e0c2 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/VPCEndpointService.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/aws/v1/VPCEndpointService.java
@@ -93,22 +93,34 @@ public VPCEndpointService(List<String> additionalAllowedPrincipals, String defau
         this.name = name;
     }
 
+    /**
+     * AdditionalAllowedPrincipals is a list of additional allowed principal ARNs that have been configured for the Private Link cluster's VPC Endpoint Service. This list in Status is used to determine if a sync of Allowed Principals is needed outside of the regular reconcile period of 2hrs.
+     */
     @JsonProperty("additionalAllowedPrincipals")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAdditionalAllowedPrincipals() {
         return additionalAllowedPrincipals;
     }
 
+    /**
+     * AdditionalAllowedPrincipals is a list of additional allowed principal ARNs that have been configured for the Private Link cluster's VPC Endpoint Service. This list in Status is used to determine if a sync of Allowed Principals is needed outside of the regular reconcile period of 2hrs.
+     */
     @JsonProperty("additionalAllowedPrincipals")
     public void setAdditionalAllowedPrincipals(List<String> additionalAllowedPrincipals) {
         this.additionalAllowedPrincipals = additionalAllowedPrincipals;
     }
 
+    /**
+     * DefaultAllowedPrincipal is the ARN of the IAM entity used by Hive as configured for the Private Link cluster's VPC Endpoint Service.
+     */
     @JsonProperty("defaultAllowedPrincipal")
     public String getDefaultAllowedPrincipal() {
         return defaultAllowedPrincipal;
     }
 
+    /**
+     * DefaultAllowedPrincipal is the ARN of the IAM entity used by Hive as configured for the Private Link cluster's VPC Endpoint Service.
+     */
     @JsonProperty("defaultAllowedPrincipal")
     public void setDefaultAllowedPrincipal(String defaultAllowedPrincipal) {
         this.defaultAllowedPrincipal = defaultAllowedPrincipal;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/azure/v1/DiskEncryptionSet.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/azure/v1/DiskEncryptionSet.java
index 036789dbfe2..4ab30eac7c9 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/azure/v1/DiskEncryptionSet.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/azure/v1/DiskEncryptionSet.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DiskEncryptionSet defines the configuration for a disk encryption set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public DiskEncryptionSet(String name, String resourceGroup, String subscriptionI
         this.subscriptionId = subscriptionId;
     }
 
+    /**
+     * Name is the name of the disk encryption set.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the disk encryption set.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * ResourceGroup defines the Azure resource group used by the disk encryption set.
+     */
     @JsonProperty("resourceGroup")
     public String getResourceGroup() {
         return resourceGroup;
     }
 
+    /**
+     * ResourceGroup defines the Azure resource group used by the disk encryption set.
+     */
     @JsonProperty("resourceGroup")
     public void setResourceGroup(String resourceGroup) {
         this.resourceGroup = resourceGroup;
     }
 
+    /**
+     * SubscriptionID defines the Azure subscription the disk encryption set is in.
+     */
     @JsonProperty("subscriptionId")
     public String getSubscriptionId() {
         return subscriptionId;
     }
 
+    /**
+     * SubscriptionID defines the Azure subscription the disk encryption set is in.
+     */
     @JsonProperty("subscriptionId")
     public void setSubscriptionId(String subscriptionId) {
         this.subscriptionId = subscriptionId;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/azure/v1/MachinePool.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/azure/v1/MachinePool.java
index 9dafe9b3c55..fa63587be37 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/azure/v1/MachinePool.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/azure/v1/MachinePool.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePool stores the configuration for a machine pool installed on Azure.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -109,82 +112,130 @@ public MachinePool(String computeSubnet, String networkResourceGroupName, OSDisk
         this.zones = zones;
     }
 
+    /**
+     * ComputeSubnet specifies an existing subnet for use by compute nodes. If omitted, the default (${infraID}-worker-subnet) will be used.
+     */
     @JsonProperty("computeSubnet")
     public String getComputeSubnet() {
         return computeSubnet;
     }
 
+    /**
+     * ComputeSubnet specifies an existing subnet for use by compute nodes. If omitted, the default (${infraID}-worker-subnet) will be used.
+     */
     @JsonProperty("computeSubnet")
     public void setComputeSubnet(String computeSubnet) {
         this.computeSubnet = computeSubnet;
     }
 
+    /**
+     * NetworkResourceGroupName specifies the network resource group that contains an existing VNet. Ignored unless VirtualNetwork is also specified.
+     */
     @JsonProperty("networkResourceGroupName")
     public String getNetworkResourceGroupName() {
         return networkResourceGroupName;
     }
 
+    /**
+     * NetworkResourceGroupName specifies the network resource group that contains an existing VNet. Ignored unless VirtualNetwork is also specified.
+     */
     @JsonProperty("networkResourceGroupName")
     public void setNetworkResourceGroupName(String networkResourceGroupName) {
         this.networkResourceGroupName = networkResourceGroupName;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on Azure.
+     */
     @JsonProperty("osDisk")
     public OSDisk getOsDisk() {
         return osDisk;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on Azure.
+     */
     @JsonProperty("osDisk")
     public void setOsDisk(OSDisk osDisk) {
         this.osDisk = osDisk;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on Azure.
+     */
     @JsonProperty("osImage")
     public OSImage getOsImage() {
         return osImage;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on Azure.
+     */
     @JsonProperty("osImage")
     public void setOsImage(OSImage osImage) {
         this.osImage = osImage;
     }
 
+    /**
+     * InstanceType defines the azure instance type. eg. Standard_DS_V2
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * InstanceType defines the azure instance type. eg. Standard_DS_V2
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * VirtualNetwork specifies the name of an existing VNet for the Machines to use If omitted, the default (${infraID}-vnet) will be used.
+     */
     @JsonProperty("virtualNetwork")
     public String getVirtualNetwork() {
         return virtualNetwork;
     }
 
+    /**
+     * VirtualNetwork specifies the name of an existing VNet for the Machines to use If omitted, the default (${infraID}-vnet) will be used.
+     */
     @JsonProperty("virtualNetwork")
     public void setVirtualNetwork(String virtualNetwork) {
         this.virtualNetwork = virtualNetwork;
     }
 
+    /**
+     * VMNetworkingType specifies whether to enable accelerated networking. Accelerated networking enables single root I/O virtualization (SR-IOV) to a VM, greatly improving its networking performance. eg. values: "Accelerated", "Basic"
+     */
     @JsonProperty("vmNetworkingType")
     public String getVmNetworkingType() {
         return vmNetworkingType;
     }
 
+    /**
+     * VMNetworkingType specifies whether to enable accelerated networking. Accelerated networking enables single root I/O virtualization (SR-IOV) to a VM, greatly improving its networking performance. eg. values: "Accelerated", "Basic"
+     */
     @JsonProperty("vmNetworkingType")
     public void setVmNetworkingType(String vmNetworkingType) {
         this.vmNetworkingType = vmNetworkingType;
     }
 
+    /**
+     * Zones is list of availability zones that can be used. eg. ["1", "2", "3"]
+     */
     @JsonProperty("zones")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getZones() {
         return zones;
     }
 
+    /**
+     * Zones is list of availability zones that can be used. eg. ["1", "2", "3"]
+     */
     @JsonProperty("zones")
     public void setZones(List<String> zones) {
         this.zones = zones;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/azure/v1/Metadata.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/azure/v1/Metadata.java
index b7e317f9269..39fa56ff7e4 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/azure/v1/Metadata.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/azure/v1/Metadata.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metadata contains Azure metadata (e.g. for uninstalling the cluster).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public Metadata(String resourceGroupName) {
         this.resourceGroupName = resourceGroupName;
     }
 
+    /**
+     * ResourceGroupName is the name of the resource group in which the cluster resources were created.
+     */
     @JsonProperty("resourceGroupName")
     public String getResourceGroupName() {
         return resourceGroupName;
     }
 
+    /**
+     * ResourceGroupName is the name of the resource group in which the cluster resources were created.
+     */
     @JsonProperty("resourceGroupName")
     public void setResourceGroupName(String resourceGroupName) {
         this.resourceGroupName = resourceGroupName;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/azure/v1/OSDisk.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/azure/v1/OSDisk.java
index 461a2e6ba96..3ef7b4a812d 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/azure/v1/OSDisk.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/azure/v1/OSDisk.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OSDisk defines the disk for machines on Azure.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public OSDisk(DiskEncryptionSet diskEncryptionSet, Integer diskSizeGB, String di
         this.diskType = diskType;
     }
 
+    /**
+     * OSDisk defines the disk for machines on Azure.
+     */
     @JsonProperty("diskEncryptionSet")
     public DiskEncryptionSet getDiskEncryptionSet() {
         return diskEncryptionSet;
     }
 
+    /**
+     * OSDisk defines the disk for machines on Azure.
+     */
     @JsonProperty("diskEncryptionSet")
     public void setDiskEncryptionSet(DiskEncryptionSet diskEncryptionSet) {
         this.diskEncryptionSet = diskEncryptionSet;
     }
 
+    /**
+     * DiskSizeGB defines the size of disk in GB.
+     */
     @JsonProperty("diskSizeGB")
     public Integer getDiskSizeGB() {
         return diskSizeGB;
     }
 
+    /**
+     * DiskSizeGB defines the size of disk in GB.
+     */
     @JsonProperty("diskSizeGB")
     public void setDiskSizeGB(Integer diskSizeGB) {
         this.diskSizeGB = diskSizeGB;
     }
 
+    /**
+     * DiskType defines the type of disk. For control plane nodes, the valid values are Premium_LRS and StandardSSD_LRS. Default is Premium_LRS.
+     */
     @JsonProperty("diskType")
     public String getDiskType() {
         return diskType;
     }
 
+    /**
+     * DiskType defines the type of disk. For control plane nodes, the valid values are Premium_LRS and StandardSSD_LRS. Default is Premium_LRS.
+     */
     @JsonProperty("diskType")
     public void setDiskType(String diskType) {
         this.diskType = diskType;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/azure/v1/OSImage.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/azure/v1/OSImage.java
index 33a1fb08872..7b32042f055 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/azure/v1/OSImage.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/azure/v1/OSImage.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OSImage is the image to use for the OS of a machine.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public OSImage(String offer, String publisher, String sku, String version) {
         this.version = version;
     }
 
+    /**
+     * Offer is the offer of the image.
+     */
     @JsonProperty("offer")
     public String getOffer() {
         return offer;
     }
 
+    /**
+     * Offer is the offer of the image.
+     */
     @JsonProperty("offer")
     public void setOffer(String offer) {
         this.offer = offer;
     }
 
+    /**
+     * Publisher is the publisher of the image.
+     */
     @JsonProperty("publisher")
     public String getPublisher() {
         return publisher;
     }
 
+    /**
+     * Publisher is the publisher of the image.
+     */
     @JsonProperty("publisher")
     public void setPublisher(String publisher) {
         this.publisher = publisher;
     }
 
+    /**
+     * SKU is the SKU of the image.
+     */
     @JsonProperty("sku")
     public String getSku() {
         return sku;
     }
 
+    /**
+     * SKU is the SKU of the image.
+     */
     @JsonProperty("sku")
     public void setSku(String sku) {
         this.sku = sku;
     }
 
+    /**
+     * Version is the version of the image.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * Version is the version of the image.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/azure/v1/Platform.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/azure/v1/Platform.java
index 87b680bc534..3f754a8b1d0 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/azure/v1/Platform.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/azure/v1/Platform.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Platform stores all the global configuration that all machinesets use.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public Platform(String baseDomainResourceGroupName, String cloudName, LocalObjec
         this.region = region;
     }
 
+    /**
+     * BaseDomainResourceGroupName specifies the resource group where the azure DNS zone for the base domain is found
+     */
     @JsonProperty("baseDomainResourceGroupName")
     public String getBaseDomainResourceGroupName() {
         return baseDomainResourceGroupName;
     }
 
+    /**
+     * BaseDomainResourceGroupName specifies the resource group where the azure DNS zone for the base domain is found
+     */
     @JsonProperty("baseDomainResourceGroupName")
     public void setBaseDomainResourceGroupName(String baseDomainResourceGroupName) {
         this.baseDomainResourceGroupName = baseDomainResourceGroupName;
     }
 
+    /**
+     * cloudName is the name of the Azure cloud environment which can be used to configure the Azure SDK with the appropriate Azure API endpoints. If empty, the value is equal to "AzurePublicCloud".
+     */
     @JsonProperty("cloudName")
     public String getCloudName() {
         return cloudName;
     }
 
+    /**
+     * cloudName is the name of the Azure cloud environment which can be used to configure the Azure SDK with the appropriate Azure API endpoints. If empty, the value is equal to "AzurePublicCloud".
+     */
     @JsonProperty("cloudName")
     public void setCloudName(String cloudName) {
         this.cloudName = cloudName;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("credentialsSecretRef")
     public LocalObjectReference getCredentialsSecretRef() {
         return credentialsSecretRef;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("credentialsSecretRef")
     public void setCredentialsSecretRef(LocalObjectReference credentialsSecretRef) {
         this.credentialsSecretRef = credentialsSecretRef;
     }
 
+    /**
+     * Region specifies the Azure region where the cluster will be created.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Region specifies the Azure region where the cluster will be created.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/baremetal/v1/Platform.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/baremetal/v1/Platform.java
index bbd6b4aaa6d..d5c40a1299f 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/baremetal/v1/Platform.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/baremetal/v1/Platform.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Platform stores the global configuration for the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public Platform(LocalObjectReference libvirtSSHPrivateKeySecretRef) {
         this.libvirtSSHPrivateKeySecretRef = libvirtSSHPrivateKeySecretRef;
     }
 
+    /**
+     * Platform stores the global configuration for the cluster.
+     */
     @JsonProperty("libvirtSSHPrivateKeySecretRef")
     public LocalObjectReference getLibvirtSSHPrivateKeySecretRef() {
         return libvirtSSHPrivateKeySecretRef;
     }
 
+    /**
+     * Platform stores the global configuration for the cluster.
+     */
     @JsonProperty("libvirtSSHPrivateKeySecretRef")
     public void setLibvirtSSHPrivateKeySecretRef(LocalObjectReference libvirtSSHPrivateKeySecretRef) {
         this.libvirtSSHPrivateKeySecretRef = libvirtSSHPrivateKeySecretRef;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/EncryptionKeyReference.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/EncryptionKeyReference.java
index ecdf0e84cc2..ada6a0a0094 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/EncryptionKeyReference.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/EncryptionKeyReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EncryptionKeyReference describes the encryptionKey to use for a disk's encryption.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public EncryptionKeyReference(KMSKeyReference kmsKey, String kmsKeyServiceAccoun
         this.kmsKeyServiceAccount = kmsKeyServiceAccount;
     }
 
+    /**
+     * EncryptionKeyReference describes the encryptionKey to use for a disk's encryption.
+     */
     @JsonProperty("kmsKey")
     public KMSKeyReference getKmsKey() {
         return kmsKey;
     }
 
+    /**
+     * EncryptionKeyReference describes the encryptionKey to use for a disk's encryption.
+     */
     @JsonProperty("kmsKey")
     public void setKmsKey(KMSKeyReference kmsKey) {
         this.kmsKey = kmsKey;
     }
 
+    /**
+     * KMSKeyServiceAccount is the service account being used for the encryption request for the given KMS key. If absent, the Compute Engine default service account is used. See https://cloud.google.com/compute/docs/access/service-accounts#compute_engine_service_account for details on the default service account.
+     */
     @JsonProperty("kmsKeyServiceAccount")
     public String getKmsKeyServiceAccount() {
         return kmsKeyServiceAccount;
     }
 
+    /**
+     * KMSKeyServiceAccount is the service account being used for the encryption request for the given KMS key. If absent, the Compute Engine default service account is used. See https://cloud.google.com/compute/docs/access/service-accounts#compute_engine_service_account for details on the default service account.
+     */
     @JsonProperty("kmsKeyServiceAccount")
     public void setKmsKeyServiceAccount(String kmsKeyServiceAccount) {
         this.kmsKeyServiceAccount = kmsKeyServiceAccount;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/KMSKeyReference.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/KMSKeyReference.java
index 67d420c3d92..deebaf15957 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/KMSKeyReference.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/KMSKeyReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KMSKeyReference gathers required fields for looking up a GCP KMS Key
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public KMSKeyReference(String keyRing, String location, String name, String proj
         this.projectID = projectID;
     }
 
+    /**
+     * KeyRing is the name of the KMS Key Ring which the KMS Key belongs to.
+     */
     @JsonProperty("keyRing")
     public String getKeyRing() {
         return keyRing;
     }
 
+    /**
+     * KeyRing is the name of the KMS Key Ring which the KMS Key belongs to.
+     */
     @JsonProperty("keyRing")
     public void setKeyRing(String keyRing) {
         this.keyRing = keyRing;
     }
 
+    /**
+     * Location is the GCP location in which the Key Ring exists.
+     */
     @JsonProperty("location")
     public String getLocation() {
         return location;
     }
 
+    /**
+     * Location is the GCP location in which the Key Ring exists.
+     */
     @JsonProperty("location")
     public void setLocation(String location) {
         this.location = location;
     }
 
+    /**
+     * Name is the name of the customer managed encryption key to be used for the disk encryption.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the customer managed encryption key to be used for the disk encryption.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * ProjectID is the ID of the Project in which the KMS Key Ring exists. Defaults to the VM ProjectID if not set.
+     */
     @JsonProperty("projectID")
     public String getProjectID() {
         return projectID;
     }
 
+    /**
+     * ProjectID is the ID of the Project in which the KMS Key Ring exists. Defaults to the VM ProjectID if not set.
+     */
     @JsonProperty("projectID")
     public void setProjectID(String projectID) {
         this.projectID = projectID;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/MachinePool.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/MachinePool.java
index cd3bb1d813e..f49c1b44396 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/MachinePool.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/MachinePool.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePool stores the configuration for a machine pool installed on GCP.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -110,83 +113,131 @@ public MachinePool(String networkProjectID, String onHostMaintenance, OSDisk osD
         this.zones = zones;
     }
 
+    /**
+     * NetworkProjectID specifies which project the network and subnets exist in when they are not in the main ProjectID.
+     */
     @JsonProperty("networkProjectID")
     public String getNetworkProjectID() {
         return networkProjectID;
     }
 
+    /**
+     * NetworkProjectID specifies which project the network and subnets exist in when they are not in the main ProjectID.
+     */
     @JsonProperty("networkProjectID")
     public void setNetworkProjectID(String networkProjectID) {
         this.networkProjectID = networkProjectID;
     }
 
+    /**
+     * OnHostMaintenance determines the behavior when a maintenance event occurs that might cause the instance to reboot. This is required to be set to "Terminate" if you want to provision machine with attached GPUs. Otherwise, allowed values are "Migrate" and "Terminate". If omitted, the platform chooses a default, which is subject to change over time, currently that default is "Migrate".
+     */
     @JsonProperty("onHostMaintenance")
     public String getOnHostMaintenance() {
         return onHostMaintenance;
     }
 
+    /**
+     * OnHostMaintenance determines the behavior when a maintenance event occurs that might cause the instance to reboot. This is required to be set to "Terminate" if you want to provision machine with attached GPUs. Otherwise, allowed values are "Migrate" and "Terminate". If omitted, the platform chooses a default, which is subject to change over time, currently that default is "Migrate".
+     */
     @JsonProperty("onHostMaintenance")
     public void setOnHostMaintenance(String onHostMaintenance) {
         this.onHostMaintenance = onHostMaintenance;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on GCP.
+     */
     @JsonProperty("osDisk")
     public OSDisk getOsDisk() {
         return osDisk;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on GCP.
+     */
     @JsonProperty("osDisk")
     public void setOsDisk(OSDisk osDisk) {
         this.osDisk = osDisk;
     }
 
+    /**
+     * SecureBoot Defines whether the instance should have secure boot enabled. Verifies the digital signature of all boot components, and halts the boot process if signature verification fails. If omitted, the platform chooses a default, which is subject to change over time. Currently that default is "Disabled".
+     */
     @JsonProperty("secureBoot")
     public String getSecureBoot() {
         return secureBoot;
     }
 
+    /**
+     * SecureBoot Defines whether the instance should have secure boot enabled. Verifies the digital signature of all boot components, and halts the boot process if signature verification fails. If omitted, the platform chooses a default, which is subject to change over time. Currently that default is "Disabled".
+     */
     @JsonProperty("secureBoot")
     public void setSecureBoot(String secureBoot) {
         this.secureBoot = secureBoot;
     }
 
+    /**
+     * ServiceAccount is the email of a gcp service account to be attached to worker nodes in order to provide the permissions required by the cloud provider. For the default worker MachinePool, it is the user's responsibility to match this to the value provided in the install-config.
+     */
     @JsonProperty("serviceAccount")
     public String getServiceAccount() {
         return serviceAccount;
     }
 
+    /**
+     * ServiceAccount is the email of a gcp service account to be attached to worker nodes in order to provide the permissions required by the cloud provider. For the default worker MachinePool, it is the user's responsibility to match this to the value provided in the install-config.
+     */
     @JsonProperty("serviceAccount")
     public void setServiceAccount(String serviceAccount) {
         this.serviceAccount = serviceAccount;
     }
 
+    /**
+     * InstanceType defines the GCP instance type. eg. n1-standard-4
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * InstanceType defines the GCP instance type. eg. n1-standard-4
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * userTags has additional keys and values that we will add as tags to the providerSpec of MachineSets that we creates on GCP. Tag key and tag value should be the shortnames of the tag key and tag value resource. Consumer is responsible for using this only for spokes where custom tags are supported.
+     */
     @JsonProperty("userTags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<UserTag> getUserTags() {
         return userTags;
     }
 
+    /**
+     * userTags has additional keys and values that we will add as tags to the providerSpec of MachineSets that we creates on GCP. Tag key and tag value should be the shortnames of the tag key and tag value resource. Consumer is responsible for using this only for spokes where custom tags are supported.
+     */
     @JsonProperty("userTags")
     public void setUserTags(List<UserTag> userTags) {
         this.userTags = userTags;
     }
 
+    /**
+     * Zones is list of availability zones that can be used.
+     */
     @JsonProperty("zones")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getZones() {
         return zones;
     }
 
+    /**
+     * Zones is list of availability zones that can be used.
+     */
     @JsonProperty("zones")
     public void setZones(List<String> zones) {
         this.zones = zones;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/Metadata.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/Metadata.java
index 132fcc2bb15..686f69056a4 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/Metadata.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/Metadata.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metadata contains GCP metadata (e.g. for uninstalling the cluster).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public Metadata(String networkProjectID) {
         this.networkProjectID = networkProjectID;
     }
 
+    /**
+     * NetworkProjectID is used for shared VPC setups
+     */
     @JsonProperty("networkProjectID")
     public String getNetworkProjectID() {
         return networkProjectID;
     }
 
+    /**
+     * NetworkProjectID is used for shared VPC setups
+     */
     @JsonProperty("networkProjectID")
     public void setNetworkProjectID(String networkProjectID) {
         this.networkProjectID = networkProjectID;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/OSDisk.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/OSDisk.java
index 966bf47d381..17c8ac2df8b 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/OSDisk.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/OSDisk.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OSDisk defines the disk for machines on GCP.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public OSDisk(Long diskSizeGB, String diskType, EncryptionKeyReference encryptio
         this.encryptionKey = encryptionKey;
     }
 
+    /**
+     * DiskSizeGB defines the size of disk in GB. Defaulted internally to 128.
+     */
     @JsonProperty("diskSizeGB")
     public Long getDiskSizeGB() {
         return diskSizeGB;
     }
 
+    /**
+     * DiskSizeGB defines the size of disk in GB. Defaulted internally to 128.
+     */
     @JsonProperty("diskSizeGB")
     public void setDiskSizeGB(Long diskSizeGB) {
         this.diskSizeGB = diskSizeGB;
     }
 
+    /**
+     * DiskType defines the type of disk. The valid values are pd-standard and pd-ssd. Defaulted internally to pd-ssd.
+     */
     @JsonProperty("diskType")
     public String getDiskType() {
         return diskType;
     }
 
+    /**
+     * DiskType defines the type of disk. The valid values are pd-standard and pd-ssd. Defaulted internally to pd-ssd.
+     */
     @JsonProperty("diskType")
     public void setDiskType(String diskType) {
         this.diskType = diskType;
     }
 
+    /**
+     * OSDisk defines the disk for machines on GCP.
+     */
     @JsonProperty("encryptionKey")
     public EncryptionKeyReference getEncryptionKey() {
         return encryptionKey;
     }
 
+    /**
+     * OSDisk defines the disk for machines on GCP.
+     */
     @JsonProperty("encryptionKey")
     public void setEncryptionKey(EncryptionKeyReference encryptionKey) {
         this.encryptionKey = encryptionKey;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/Platform.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/Platform.java
index d11bae72a21..08506b72429 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/Platform.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/Platform.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Platform stores all the global configuration that all machinesets use.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public Platform(LocalObjectReference credentialsSecretRef, PrivateServiceConnect
         this.region = region;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("credentialsSecretRef")
     public LocalObjectReference getCredentialsSecretRef() {
         return credentialsSecretRef;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("credentialsSecretRef")
     public void setCredentialsSecretRef(LocalObjectReference credentialsSecretRef) {
         this.credentialsSecretRef = credentialsSecretRef;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("privateServiceConnect")
     public PrivateServiceConnect getPrivateServiceConnect() {
         return privateServiceConnect;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("privateServiceConnect")
     public void setPrivateServiceConnect(PrivateServiceConnect privateServiceConnect) {
         this.privateServiceConnect = privateServiceConnect;
     }
 
+    /**
+     * Region specifies the GCP region where the cluster will be created.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Region specifies the GCP region where the cluster will be created.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/PlatformStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/PlatformStatus.java
index 919c5e50f33..49c915e044f 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/PlatformStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/PlatformStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PlatformStatus contains the observed state on GCP platform.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public PlatformStatus(PrivateServiceConnectStatus privateServiceConnect) {
         this.privateServiceConnect = privateServiceConnect;
     }
 
+    /**
+     * PlatformStatus contains the observed state on GCP platform.
+     */
     @JsonProperty("privateServiceConnect")
     public PrivateServiceConnectStatus getPrivateServiceConnect() {
         return privateServiceConnect;
     }
 
+    /**
+     * PlatformStatus contains the observed state on GCP platform.
+     */
     @JsonProperty("privateServiceConnect")
     public void setPrivateServiceConnect(PrivateServiceConnectStatus privateServiceConnect) {
         this.privateServiceConnect = privateServiceConnect;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/PrivateServiceConnect.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/PrivateServiceConnect.java
index b46118be90d..3f662198aea 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/PrivateServiceConnect.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/PrivateServiceConnect.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PrivateServiceConnectAccess configures access to the cluster API using GCP Private Service Connect
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PrivateServiceConnect(Boolean enabled, ServiceAttachment serviceAttachmen
         this.serviceAttachment = serviceAttachment;
     }
 
+    /**
+     * Enabled specifies if Private Service Connect is to be enabled on the cluster.
+     */
     @JsonProperty("enabled")
     public Boolean getEnabled() {
         return enabled;
     }
 
+    /**
+     * Enabled specifies if Private Service Connect is to be enabled on the cluster.
+     */
     @JsonProperty("enabled")
     public void setEnabled(Boolean enabled) {
         this.enabled = enabled;
     }
 
+    /**
+     * PrivateServiceConnectAccess configures access to the cluster API using GCP Private Service Connect
+     */
     @JsonProperty("serviceAttachment")
     public ServiceAttachment getServiceAttachment() {
         return serviceAttachment;
     }
 
+    /**
+     * PrivateServiceConnectAccess configures access to the cluster API using GCP Private Service Connect
+     */
     @JsonProperty("serviceAttachment")
     public void setServiceAttachment(ServiceAttachment serviceAttachment) {
         this.serviceAttachment = serviceAttachment;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/PrivateServiceConnectStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/PrivateServiceConnectStatus.java
index aef0d536c77..c987d3999c4 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/PrivateServiceConnectStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/PrivateServiceConnectStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PrivateServiceConnectStatus contains the observed state for PrivateServiceConnect resources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public PrivateServiceConnectStatus(String endpoint, String endpointAddress, Stri
         this.serviceAttachmentSubnet = serviceAttachmentSubnet;
     }
 
+    /**
+     * Endpoint is the selfLink of the endpoint created for the cluster.
+     */
     @JsonProperty("endpoint")
     public String getEndpoint() {
         return endpoint;
     }
 
+    /**
+     * Endpoint is the selfLink of the endpoint created for the cluster.
+     */
     @JsonProperty("endpoint")
     public void setEndpoint(String endpoint) {
         this.endpoint = endpoint;
     }
 
+    /**
+     * EndpointAddress is the selfLink of the address created for the cluster endpoint.
+     */
     @JsonProperty("endpointAddress")
     public String getEndpointAddress() {
         return endpointAddress;
     }
 
+    /**
+     * EndpointAddress is the selfLink of the address created for the cluster endpoint.
+     */
     @JsonProperty("endpointAddress")
     public void setEndpointAddress(String endpointAddress) {
         this.endpointAddress = endpointAddress;
     }
 
+    /**
+     * ServiceAttachment is the selfLink of the service attachment created for the clsuter.
+     */
     @JsonProperty("serviceAttachment")
     public String getServiceAttachment() {
         return serviceAttachment;
     }
 
+    /**
+     * ServiceAttachment is the selfLink of the service attachment created for the clsuter.
+     */
     @JsonProperty("serviceAttachment")
     public void setServiceAttachment(String serviceAttachment) {
         this.serviceAttachment = serviceAttachment;
     }
 
+    /**
+     * ServiceAttachmentFirewall is the selfLink of the firewall that allows traffic between the service attachment and the cluster's internal api load balancer.
+     */
     @JsonProperty("serviceAttachmentFirewall")
     public String getServiceAttachmentFirewall() {
         return serviceAttachmentFirewall;
     }
 
+    /**
+     * ServiceAttachmentFirewall is the selfLink of the firewall that allows traffic between the service attachment and the cluster's internal api load balancer.
+     */
     @JsonProperty("serviceAttachmentFirewall")
     public void setServiceAttachmentFirewall(String serviceAttachmentFirewall) {
         this.serviceAttachmentFirewall = serviceAttachmentFirewall;
     }
 
+    /**
+     * ServiceAttachmentSubnet is the selfLink of the subnet that will contain the service attachment.
+     */
     @JsonProperty("serviceAttachmentSubnet")
     public String getServiceAttachmentSubnet() {
         return serviceAttachmentSubnet;
     }
 
+    /**
+     * ServiceAttachmentSubnet is the selfLink of the subnet that will contain the service attachment.
+     */
     @JsonProperty("serviceAttachmentSubnet")
     public void setServiceAttachmentSubnet(String serviceAttachmentSubnet) {
         this.serviceAttachmentSubnet = serviceAttachmentSubnet;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/ServiceAttachment.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/ServiceAttachment.java
index 08fb3705f0b..ca94972b58d 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/ServiceAttachment.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/ServiceAttachment.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceAttachment configures the service attachment to be used by the cluster
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ServiceAttachment(ServiceAttachmentSubnet subnet) {
         this.subnet = subnet;
     }
 
+    /**
+     * ServiceAttachment configures the service attachment to be used by the cluster
+     */
     @JsonProperty("subnet")
     public ServiceAttachmentSubnet getSubnet() {
         return subnet;
     }
 
+    /**
+     * ServiceAttachment configures the service attachment to be used by the cluster
+     */
     @JsonProperty("subnet")
     public void setSubnet(ServiceAttachmentSubnet subnet) {
         this.subnet = subnet;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/ServiceAttachmentSubnet.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/ServiceAttachmentSubnet.java
index 1d1f8b42dd3..c95c23c5ff2 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/ServiceAttachmentSubnet.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/ServiceAttachmentSubnet.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceAttachmentSubnet configures the subnetwork used by the service attachment
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ServiceAttachmentSubnet(String cidr, ServiceAttachmentSubnetExisting exis
         this.existing = existing;
     }
 
+    /**
+     * Cidr specifies the cidr to use when creating a service attachment subnet.
+     */
     @JsonProperty("cidr")
     public String getCidr() {
         return cidr;
     }
 
+    /**
+     * Cidr specifies the cidr to use when creating a service attachment subnet.
+     */
     @JsonProperty("cidr")
     public void setCidr(String cidr) {
         this.cidr = cidr;
     }
 
+    /**
+     * ServiceAttachmentSubnet configures the subnetwork used by the service attachment
+     */
     @JsonProperty("existing")
     public ServiceAttachmentSubnetExisting getExisting() {
         return existing;
     }
 
+    /**
+     * ServiceAttachmentSubnet configures the subnetwork used by the service attachment
+     */
     @JsonProperty("existing")
     public void setExisting(ServiceAttachmentSubnetExisting existing) {
         this.existing = existing;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/ServiceAttachmentSubnetExisting.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/ServiceAttachmentSubnetExisting.java
index 4984a7b4c8e..b6a06f199b8 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/ServiceAttachmentSubnetExisting.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/ServiceAttachmentSubnetExisting.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceAttachmentSubnetExisting describes the existing subnet.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ServiceAttachmentSubnetExisting(String name, String project) {
         this.project = project;
     }
 
+    /**
+     * Name specifies the name of the existing subnet.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name specifies the name of the existing subnet.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Project specifies the project the subnet exists in. This is required for Shared VPC.
+     */
     @JsonProperty("project")
     public String getProject() {
         return project;
     }
 
+    /**
+     * Project specifies the project the subnet exists in. This is required for Shared VPC.
+     */
     @JsonProperty("project")
     public void setProject(String project) {
         this.project = project;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/UserTag.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/UserTag.java
index 72c153b3087..c81c73b1f51 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/UserTag.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/gcp/v1/UserTag.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UserTag is a tag to apply to GCP resources created for the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public UserTag(String key, String parentID, String value) {
         this.value = value;
     }
 
+    /**
+     * key is the key part of the tag. A tag key can have a maximum of 63 characters and cannot be empty. Tag key must begin and end with an alphanumeric character, and must contain only uppercase, lowercase alphanumeric characters, and the following special characters `._-`.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * key is the key part of the tag. A tag key can have a maximum of 63 characters and cannot be empty. Tag key must begin and end with an alphanumeric character, and must contain only uppercase, lowercase alphanumeric characters, and the following special characters `._-`.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * parentID is the ID of the hierarchical resource where the tags are defined, e.g. at the Organization or the Project level. To find the Organization ID or Project ID refer to the following pages: https://cloud.google.com/resource-manager/docs/creating-managing-organization#retrieving_your_organization_id, https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects. An OrganizationID must consist of decimal numbers, and cannot have leading zeroes. A ProjectID must be 6 to 30 characters in length, can only contain lowercase letters, numbers, and hyphens, and must start with a letter, and cannot end with a hyphen.
+     */
     @JsonProperty("parentID")
     public String getParentID() {
         return parentID;
     }
 
+    /**
+     * parentID is the ID of the hierarchical resource where the tags are defined, e.g. at the Organization or the Project level. To find the Organization ID or Project ID refer to the following pages: https://cloud.google.com/resource-manager/docs/creating-managing-organization#retrieving_your_organization_id, https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects. An OrganizationID must consist of decimal numbers, and cannot have leading zeroes. A ProjectID must be 6 to 30 characters in length, can only contain lowercase letters, numbers, and hyphens, and must start with a letter, and cannot end with a hyphen.
+     */
     @JsonProperty("parentID")
     public void setParentID(String parentID) {
         this.parentID = parentID;
     }
 
+    /**
+     * value is the value part of the tag. A tag value can have a maximum of 63 characters and cannot be empty. Tag value must begin and end with an alphanumeric character, and must contain only uppercase, lowercase alphanumeric characters, and the following special characters `_-.@%=+:,&#42;#&amp;(){}[]` and spaces.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * value is the value part of the tag. A tag value can have a maximum of 63 characters and cannot be empty. Tag value must begin and end with an alphanumeric character, and must contain only uppercase, lowercase alphanumeric characters, and the following special characters `_-.@%=+:,&#42;#&amp;(){}[]` and spaces.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ibmcloud/v1/BootVolume.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ibmcloud/v1/BootVolume.java
index 72a09f9b6fb..2229840217e 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ibmcloud/v1/BootVolume.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ibmcloud/v1/BootVolume.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BootVolume stores the configuration for an individual machine's boot volume.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public BootVolume(String encryptionKey) {
         this.encryptionKey = encryptionKey;
     }
 
+    /**
+     * EncryptionKey is the CRN referencing a Key Protect or Hyper Protect Crypto Services key to use for volume encryption. If not specified, a provider managed encryption key will be used.
+     */
     @JsonProperty("encryptionKey")
     public String getEncryptionKey() {
         return encryptionKey;
     }
 
+    /**
+     * EncryptionKey is the CRN referencing a Key Protect or Hyper Protect Crypto Services key to use for volume encryption. If not specified, a provider managed encryption key will be used.
+     */
     @JsonProperty("encryptionKey")
     public void setEncryptionKey(String encryptionKey) {
         this.encryptionKey = encryptionKey;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ibmcloud/v1/DedicatedHost.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ibmcloud/v1/DedicatedHost.java
index 010f2a2a8a3..659806ec7e4 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ibmcloud/v1/DedicatedHost.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ibmcloud/v1/DedicatedHost.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DedicatedHost stores the configuration for the machine's dedicated host platform.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public DedicatedHost(String name, String profile) {
         this.profile = profile;
     }
 
+    /**
+     * Name is the name of the dedicated host to provision the machine on. If specified, machines will be created on pre-existing dedicated host.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the dedicated host to provision the machine on. If specified, machines will be created on pre-existing dedicated host.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Profile is the profile ID for the dedicated host. If specified, new dedicated host will be created for machines.
+     */
     @JsonProperty("profile")
     public String getProfile() {
         return profile;
     }
 
+    /**
+     * Profile is the profile ID for the dedicated host. If specified, new dedicated host will be created for machines.
+     */
     @JsonProperty("profile")
     public void setProfile(String profile) {
         this.profile = profile;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ibmcloud/v1/MachinePool.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ibmcloud/v1/MachinePool.java
index ac043bc5385..f2f2b3ef29e 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ibmcloud/v1/MachinePool.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ibmcloud/v1/MachinePool.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePool stores the configuration for a machine pool installed on IBM Cloud.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,43 +97,67 @@ public MachinePool(BootVolume bootVolume, List<DedicatedHost> dedicatedHosts, St
         this.zones = zones;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on IBM Cloud.
+     */
     @JsonProperty("bootVolume")
     public BootVolume getBootVolume() {
         return bootVolume;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on IBM Cloud.
+     */
     @JsonProperty("bootVolume")
     public void setBootVolume(BootVolume bootVolume) {
         this.bootVolume = bootVolume;
     }
 
+    /**
+     * DedicatedHosts is the configuration for the machine's dedicated host and profile.
+     */
     @JsonProperty("dedicatedHosts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DedicatedHost> getDedicatedHosts() {
         return dedicatedHosts;
     }
 
+    /**
+     * DedicatedHosts is the configuration for the machine's dedicated host and profile.
+     */
     @JsonProperty("dedicatedHosts")
     public void setDedicatedHosts(List<DedicatedHost> dedicatedHosts) {
         this.dedicatedHosts = dedicatedHosts;
     }
 
+    /**
+     * InstanceType is the VSI machine profile.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * InstanceType is the VSI machine profile.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * Zones is the list of availability zones used for machines in the pool.
+     */
     @JsonProperty("zones")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getZones() {
         return zones;
     }
 
+    /**
+     * Zones is the list of availability zones used for machines in the pool.
+     */
     @JsonProperty("zones")
     public void setZones(List<String> zones) {
         this.zones = zones;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ibmcloud/v1/Platform.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ibmcloud/v1/Platform.java
index 7f580307a36..19233c3c1b6 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ibmcloud/v1/Platform.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ibmcloud/v1/Platform.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Platform stores all the global configuration that all machinesets use.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public Platform(String accountID, String cisInstanceCRN, LocalObjectReference cr
         this.region = region;
     }
 
+    /**
+     * AccountID is the IBM Cloud Account ID. AccountID is DEPRECATED and is gathered via the IBM Cloud API for the provided credentials. This field will be ignored.
+     */
     @JsonProperty("accountID")
     public String getAccountID() {
         return accountID;
     }
 
+    /**
+     * AccountID is the IBM Cloud Account ID. AccountID is DEPRECATED and is gathered via the IBM Cloud API for the provided credentials. This field will be ignored.
+     */
     @JsonProperty("accountID")
     public void setAccountID(String accountID) {
         this.accountID = accountID;
     }
 
+    /**
+     * CISInstanceCRN is the IBM Cloud Internet Services Instance CRN CISInstanceCRN is DEPRECATED and gathered via the IBM Cloud API for the provided credentials and cluster deployment base domain. This field will be ignored.
+     */
     @JsonProperty("cisInstanceCRN")
     public String getCisInstanceCRN() {
         return cisInstanceCRN;
     }
 
+    /**
+     * CISInstanceCRN is the IBM Cloud Internet Services Instance CRN CISInstanceCRN is DEPRECATED and gathered via the IBM Cloud API for the provided credentials and cluster deployment base domain. This field will be ignored.
+     */
     @JsonProperty("cisInstanceCRN")
     public void setCisInstanceCRN(String cisInstanceCRN) {
         this.cisInstanceCRN = cisInstanceCRN;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("credentialsSecretRef")
     public LocalObjectReference getCredentialsSecretRef() {
         return credentialsSecretRef;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("credentialsSecretRef")
     public void setCredentialsSecretRef(LocalObjectReference credentialsSecretRef) {
         this.credentialsSecretRef = credentialsSecretRef;
     }
 
+    /**
+     * Region specifies the IBM Cloud region where the cluster will be created.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Region specifies the IBM Cloud region where the cluster will be created.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/metricsconfig/v1/MetricsConfig.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/metricsconfig/v1/MetricsConfig.java
index 78bc67914cf..797853e208a 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/metricsconfig/v1/MetricsConfig.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/metricsconfig/v1/MetricsConfig.java
@@ -86,23 +86,35 @@ public MetricsConfig(Map<String, String> additionalClusterDeploymentLabels, List
         this.metricsWithDuration = metricsWithDuration;
     }
 
+    /**
+     * AdditionalClusterDeploymentLabels allows configuration of additional labels to be applied to certain metrics. The keys can be any string value suitable for a metric label (see https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels). The values can be any ClusterDeployment label key (from metadata.labels). When observing an affected metric, hive will label it with the specified metric key, and copy the value from the specified ClusterDeployment label. For example, including {"ocp_major_version": "hive.openshift.io/version-major"} will cause affected metrics to include a label key ocp_major_version with the value from the hive.openshift.io/version-major ClusterDeployment label -- e.g. "4". NOTE: Avoid ClusterDeployment labels whose values are unbounded, such as those representing cluster names or IDs, as these will cause your prometheus database to grow indefinitely. Affected metrics are those whose type implements the metricsWithDynamicLabels interface found in pkg/controller/metrics/metrics_with_dynamic_labels.go
+     */
     @JsonProperty("additionalClusterDeploymentLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAdditionalClusterDeploymentLabels() {
         return additionalClusterDeploymentLabels;
     }
 
+    /**
+     * AdditionalClusterDeploymentLabels allows configuration of additional labels to be applied to certain metrics. The keys can be any string value suitable for a metric label (see https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels). The values can be any ClusterDeployment label key (from metadata.labels). When observing an affected metric, hive will label it with the specified metric key, and copy the value from the specified ClusterDeployment label. For example, including {"ocp_major_version": "hive.openshift.io/version-major"} will cause affected metrics to include a label key ocp_major_version with the value from the hive.openshift.io/version-major ClusterDeployment label -- e.g. "4". NOTE: Avoid ClusterDeployment labels whose values are unbounded, such as those representing cluster names or IDs, as these will cause your prometheus database to grow indefinitely. Affected metrics are those whose type implements the metricsWithDynamicLabels interface found in pkg/controller/metrics/metrics_with_dynamic_labels.go
+     */
     @JsonProperty("additionalClusterDeploymentLabels")
     public void setAdditionalClusterDeploymentLabels(Map<String, String> additionalClusterDeploymentLabels) {
         this.additionalClusterDeploymentLabels = additionalClusterDeploymentLabels;
     }
 
+    /**
+     * Optional metrics and their configurations
+     */
     @JsonProperty("metricsWithDuration")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MetricsWithDuration> getMetricsWithDuration() {
         return metricsWithDuration;
     }
 
+    /**
+     * Optional metrics and their configurations
+     */
     @JsonProperty("metricsWithDuration")
     public void setMetricsWithDuration(List<MetricsWithDuration> metricsWithDuration) {
         this.metricsWithDuration = metricsWithDuration;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/metricsconfig/v1/MetricsWithDuration.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/metricsconfig/v1/MetricsWithDuration.java
index 64e327f140c..1881c3a37e0 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/metricsconfig/v1/MetricsWithDuration.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/metricsconfig/v1/MetricsWithDuration.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MetricsWithDuration represents metrics that report time as values,like transition seconds. The purpose of these metrics should be to track outliers - ensure their duration is not set too low.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public MetricsWithDuration(String duration, String name) {
         this.name = name;
     }
 
+    /**
+     * MetricsWithDuration represents metrics that report time as values,like transition seconds. The purpose of these metrics should be to track outliers - ensure their duration is not set too low.
+     */
     @JsonProperty("duration")
     public String getDuration() {
         return duration;
     }
 
+    /**
+     * MetricsWithDuration represents metrics that report time as values,like transition seconds. The purpose of these metrics should be to track outliers - ensure their duration is not set too low.
+     */
     @JsonProperty("duration")
     public void setDuration(String duration) {
         this.duration = duration;
     }
 
+    /**
+     * Name of the metric. It will correspond to an optional relevant metric in hive
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the metric. It will correspond to an optional relevant metric in hive
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/none/v1/Platform.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/none/v1/Platform.java
index 36f69e8d5db..cb51460ca71 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/none/v1/Platform.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/none/v1/Platform.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Platform defines agent based install configuration for platform-agnostic clusters. Can only be used with spec.installStrategy.agent.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/openstack/v1/MachinePool.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/openstack/v1/MachinePool.java
index 9130ae55816..06cb1853f16 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/openstack/v1/MachinePool.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/openstack/v1/MachinePool.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePool stores the configuration for a machine pool installed on OpenStack.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public MachinePool(String flavor, RootVolume rootVolume) {
         this.rootVolume = rootVolume;
     }
 
+    /**
+     * Flavor defines the OpenStack Nova flavor. eg. m1.large The json key here differs from the installer which uses both "computeFlavor" and type "type" depending on which type you're looking at, and the resulting field on the MachineSet is "flavor". We are opting to stay consistent with the end result.
+     */
     @JsonProperty("flavor")
     public String getFlavor() {
         return flavor;
     }
 
+    /**
+     * Flavor defines the OpenStack Nova flavor. eg. m1.large The json key here differs from the installer which uses both "computeFlavor" and type "type" depending on which type you're looking at, and the resulting field on the MachineSet is "flavor". We are opting to stay consistent with the end result.
+     */
     @JsonProperty("flavor")
     public void setFlavor(String flavor) {
         this.flavor = flavor;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on OpenStack.
+     */
     @JsonProperty("rootVolume")
     public RootVolume getRootVolume() {
         return rootVolume;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on OpenStack.
+     */
     @JsonProperty("rootVolume")
     public void setRootVolume(RootVolume rootVolume) {
         this.rootVolume = rootVolume;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/openstack/v1/Platform.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/openstack/v1/Platform.java
index 9395b033562..de517928a71 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/openstack/v1/Platform.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/openstack/v1/Platform.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Platform stores all the global OpenStack configuration
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public Platform(LocalObjectReference certificatesSecretRef, String cloud, LocalO
         this.trunkSupport = trunkSupport;
     }
 
+    /**
+     * Platform stores all the global OpenStack configuration
+     */
     @JsonProperty("certificatesSecretRef")
     public LocalObjectReference getCertificatesSecretRef() {
         return certificatesSecretRef;
     }
 
+    /**
+     * Platform stores all the global OpenStack configuration
+     */
     @JsonProperty("certificatesSecretRef")
     public void setCertificatesSecretRef(LocalObjectReference certificatesSecretRef) {
         this.certificatesSecretRef = certificatesSecretRef;
     }
 
+    /**
+     * Cloud will be used to indicate the OS_CLOUD value to use the right section from the clouds.yaml in the CredentialsSecretRef.
+     */
     @JsonProperty("cloud")
     public String getCloud() {
         return cloud;
     }
 
+    /**
+     * Cloud will be used to indicate the OS_CLOUD value to use the right section from the clouds.yaml in the CredentialsSecretRef.
+     */
     @JsonProperty("cloud")
     public void setCloud(String cloud) {
         this.cloud = cloud;
     }
 
+    /**
+     * Platform stores all the global OpenStack configuration
+     */
     @JsonProperty("credentialsSecretRef")
     public LocalObjectReference getCredentialsSecretRef() {
         return credentialsSecretRef;
     }
 
+    /**
+     * Platform stores all the global OpenStack configuration
+     */
     @JsonProperty("credentialsSecretRef")
     public void setCredentialsSecretRef(LocalObjectReference credentialsSecretRef) {
         this.credentialsSecretRef = credentialsSecretRef;
     }
 
+    /**
+     * TrunkSupport indicates whether or not to use trunk ports in your OpenShift cluster.
+     */
     @JsonProperty("trunkSupport")
     public Boolean getTrunkSupport() {
         return trunkSupport;
     }
 
+    /**
+     * TrunkSupport indicates whether or not to use trunk ports in your OpenShift cluster.
+     */
     @JsonProperty("trunkSupport")
     public void setTrunkSupport(Boolean trunkSupport) {
         this.trunkSupport = trunkSupport;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/openstack/v1/RootVolume.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/openstack/v1/RootVolume.java
index debb80a67d4..ff69d846614 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/openstack/v1/RootVolume.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/openstack/v1/RootVolume.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RootVolume defines the storage for an instance.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public RootVolume(Integer size, String type) {
         this.type = type;
     }
 
+    /**
+     * Size defines the size of the volume in gibibytes (GiB). Required
+     */
     @JsonProperty("size")
     public Integer getSize() {
         return size;
     }
 
+    /**
+     * Size defines the size of the volume in gibibytes (GiB). Required
+     */
     @JsonProperty("size")
     public void setSize(Integer size) {
         this.size = size;
     }
 
+    /**
+     * Type defines the type of the volume. Required
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type defines the type of the volume. Required
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ovirt/v1/CPU.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ovirt/v1/CPU.java
index f69299da18a..ad5405ba9b7 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ovirt/v1/CPU.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ovirt/v1/CPU.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CPU defines the VM cpu, made of (Sockets &#42; Cores).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public CPU(Integer cores, Integer sockets) {
         this.sockets = sockets;
     }
 
+    /**
+     * Cores is the number of cores per socket. Total CPUs is (Sockets &#42; Cores)
+     */
     @JsonProperty("cores")
     public Integer getCores() {
         return cores;
     }
 
+    /**
+     * Cores is the number of cores per socket. Total CPUs is (Sockets &#42; Cores)
+     */
     @JsonProperty("cores")
     public void setCores(Integer cores) {
         this.cores = cores;
     }
 
+    /**
+     * Sockets is the number of sockets for a VM. Total CPUs is (Sockets &#42; Cores)
+     */
     @JsonProperty("sockets")
     public Integer getSockets() {
         return sockets;
     }
 
+    /**
+     * Sockets is the number of sockets for a VM. Total CPUs is (Sockets &#42; Cores)
+     */
     @JsonProperty("sockets")
     public void setSockets(Integer sockets) {
         this.sockets = sockets;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ovirt/v1/Disk.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ovirt/v1/Disk.java
index dc6f4f79610..56f276fd6a0 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ovirt/v1/Disk.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ovirt/v1/Disk.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Disk defines a VM disk
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public Disk(Long sizeGB) {
         this.sizeGB = sizeGB;
     }
 
+    /**
+     * SizeGB size of the bootable disk in GiB.
+     */
     @JsonProperty("sizeGB")
     public Long getSizeGB() {
         return sizeGB;
     }
 
+    /**
+     * SizeGB size of the bootable disk in GiB.
+     */
     @JsonProperty("sizeGB")
     public void setSizeGB(Long sizeGB) {
         this.sizeGB = sizeGB;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ovirt/v1/MachinePool.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ovirt/v1/MachinePool.java
index 27c672437c6..3def8a2630b 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ovirt/v1/MachinePool.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ovirt/v1/MachinePool.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePool stores the configuration for a machine pool installed on ovirt.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public MachinePool(CPU cpu, Integer memoryMB, Disk osDisk, String vmType) {
         this.vmType = vmType;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on ovirt.
+     */
     @JsonProperty("cpu")
     public CPU getCpu() {
         return cpu;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on ovirt.
+     */
     @JsonProperty("cpu")
     public void setCpu(CPU cpu) {
         this.cpu = cpu;
     }
 
+    /**
+     * MemoryMB is the size of a VM's memory in MiBs.
+     */
     @JsonProperty("memoryMB")
     public Integer getMemoryMB() {
         return memoryMB;
     }
 
+    /**
+     * MemoryMB is the size of a VM's memory in MiBs.
+     */
     @JsonProperty("memoryMB")
     public void setMemoryMB(Integer memoryMB) {
         this.memoryMB = memoryMB;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on ovirt.
+     */
     @JsonProperty("osDisk")
     public Disk getOsDisk() {
         return osDisk;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on ovirt.
+     */
     @JsonProperty("osDisk")
     public void setOsDisk(Disk osDisk) {
         this.osDisk = osDisk;
     }
 
+    /**
+     * VMType defines the workload type of the VM.
+     */
     @JsonProperty("vmType")
     public String getVmType() {
         return vmType;
     }
 
+    /**
+     * VMType defines the workload type of the VM.
+     */
     @JsonProperty("vmType")
     public void setVmType(String vmType) {
         this.vmType = vmType;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ovirt/v1/Platform.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ovirt/v1/Platform.java
index 349c7d11fe0..63fb1105901 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ovirt/v1/Platform.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/ovirt/v1/Platform.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Platform stores all the global oVirt configuration
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public Platform(LocalObjectReference certificatesSecretRef, LocalObjectReference
         this.storageDomainId = storageDomainId;
     }
 
+    /**
+     * Platform stores all the global oVirt configuration
+     */
     @JsonProperty("certificatesSecretRef")
     public LocalObjectReference getCertificatesSecretRef() {
         return certificatesSecretRef;
     }
 
+    /**
+     * Platform stores all the global oVirt configuration
+     */
     @JsonProperty("certificatesSecretRef")
     public void setCertificatesSecretRef(LocalObjectReference certificatesSecretRef) {
         this.certificatesSecretRef = certificatesSecretRef;
     }
 
+    /**
+     * Platform stores all the global oVirt configuration
+     */
     @JsonProperty("credentialsSecretRef")
     public LocalObjectReference getCredentialsSecretRef() {
         return credentialsSecretRef;
     }
 
+    /**
+     * Platform stores all the global oVirt configuration
+     */
     @JsonProperty("credentialsSecretRef")
     public void setCredentialsSecretRef(LocalObjectReference credentialsSecretRef) {
         this.credentialsSecretRef = credentialsSecretRef;
     }
 
+    /**
+     * The target cluster under which all VMs will run
+     */
     @JsonProperty("ovirt_cluster_id")
     public String getOvirtClusterId() {
         return ovirtClusterId;
     }
 
+    /**
+     * The target cluster under which all VMs will run
+     */
     @JsonProperty("ovirt_cluster_id")
     public void setOvirtClusterId(String ovirtClusterId) {
         this.ovirtClusterId = ovirtClusterId;
     }
 
+    /**
+     * The target network of all the network interfaces of the nodes. Omitting defaults to ovirtmgmt network which is a default network for evert ovirt cluster.
+     */
     @JsonProperty("ovirt_network_name")
     public String getOvirtNetworkName() {
         return ovirtNetworkName;
     }
 
+    /**
+     * The target network of all the network interfaces of the nodes. Omitting defaults to ovirtmgmt network which is a default network for evert ovirt cluster.
+     */
     @JsonProperty("ovirt_network_name")
     public void setOvirtNetworkName(String ovirtNetworkName) {
         this.ovirtNetworkName = ovirtNetworkName;
     }
 
+    /**
+     * The target storage domain under which all VM disk would be created.
+     */
     @JsonProperty("storage_domain_id")
     public String getStorageDomainId() {
         return storageDomainId;
     }
 
+    /**
+     * The target storage domain under which all VM disk would be created.
+     */
     @JsonProperty("storage_domain_id")
     public void setStorageDomainId(String storageDomainId) {
         this.storageDomainId = storageDomainId;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSAssociatedVPC.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSAssociatedVPC.java
index c0034eb13c5..1fd00d6a599 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSAssociatedVPC.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSAssociatedVPC.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSAssociatedVPC defines a VPC that should be able to resolve the DNS addresses setup for Private Link.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public AWSAssociatedVPC(LocalObjectReference credentialsSecretRef, String region
         this.vpcID = vpcID;
     }
 
+    /**
+     * AWSAssociatedVPC defines a VPC that should be able to resolve the DNS addresses setup for Private Link.
+     */
     @JsonProperty("credentialsSecretRef")
     public LocalObjectReference getCredentialsSecretRef() {
         return credentialsSecretRef;
     }
 
+    /**
+     * AWSAssociatedVPC defines a VPC that should be able to resolve the DNS addresses setup for Private Link.
+     */
     @JsonProperty("credentialsSecretRef")
     public void setCredentialsSecretRef(LocalObjectReference credentialsSecretRef) {
         this.credentialsSecretRef = credentialsSecretRef;
     }
 
+    /**
+     * AWSAssociatedVPC defines a VPC that should be able to resolve the DNS addresses setup for Private Link.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * AWSAssociatedVPC defines a VPC that should be able to resolve the DNS addresses setup for Private Link.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * AWSAssociatedVPC defines a VPC that should be able to resolve the DNS addresses setup for Private Link.
+     */
     @JsonProperty("vpcID")
     public String getVpcID() {
         return vpcID;
     }
 
+    /**
+     * AWSAssociatedVPC defines a VPC that should be able to resolve the DNS addresses setup for Private Link.
+     */
     @JsonProperty("vpcID")
     public void setVpcID(String vpcID) {
         this.vpcID = vpcID;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSClusterDeprovision.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSClusterDeprovision.java
index f826bf60bcd..4ad7e8779bf 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSClusterDeprovision.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSClusterDeprovision.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSClusterDeprovision contains AWS-specific configuration for a ClusterDeprovision
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,41 +94,65 @@ public AWSClusterDeprovision(AssumeRole credentialsAssumeRole, LocalObjectRefere
         this.region = region;
     }
 
+    /**
+     * AWSClusterDeprovision contains AWS-specific configuration for a ClusterDeprovision
+     */
     @JsonProperty("credentialsAssumeRole")
     public AssumeRole getCredentialsAssumeRole() {
         return credentialsAssumeRole;
     }
 
+    /**
+     * AWSClusterDeprovision contains AWS-specific configuration for a ClusterDeprovision
+     */
     @JsonProperty("credentialsAssumeRole")
     public void setCredentialsAssumeRole(AssumeRole credentialsAssumeRole) {
         this.credentialsAssumeRole = credentialsAssumeRole;
     }
 
+    /**
+     * AWSClusterDeprovision contains AWS-specific configuration for a ClusterDeprovision
+     */
     @JsonProperty("credentialsSecretRef")
     public LocalObjectReference getCredentialsSecretRef() {
         return credentialsSecretRef;
     }
 
+    /**
+     * AWSClusterDeprovision contains AWS-specific configuration for a ClusterDeprovision
+     */
     @JsonProperty("credentialsSecretRef")
     public void setCredentialsSecretRef(LocalObjectReference credentialsSecretRef) {
         this.credentialsSecretRef = credentialsSecretRef;
     }
 
+    /**
+     * HostedZoneRole is the role to assume when performing operations on a hosted zone owned by another account.
+     */
     @JsonProperty("hostedZoneRole")
     public String getHostedZoneRole() {
         return hostedZoneRole;
     }
 
+    /**
+     * HostedZoneRole is the role to assume when performing operations on a hosted zone owned by another account.
+     */
     @JsonProperty("hostedZoneRole")
     public void setHostedZoneRole(String hostedZoneRole) {
         this.hostedZoneRole = hostedZoneRole;
     }
 
+    /**
+     * Region is the AWS region for this deprovisioning
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Region is the AWS region for this deprovisioning
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSDNSZoneSpec.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSDNSZoneSpec.java
index 25e3bc0cb55..a2959af2c7b 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSDNSZoneSpec.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSDNSZoneSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSDNSZoneSpec contains AWS-specific DNSZone specifications
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,42 +97,66 @@ public AWSDNSZoneSpec(List<AWSResourceTag> additionalTags, AssumeRole credential
         this.region = region;
     }
 
+    /**
+     * AdditionalTags is a set of additional tags to set on the DNS hosted zone. In addition to these tags,the DNS Zone controller will set a hive.openhsift.io/hostedzone tag identifying the HostedZone record that it belongs to.
+     */
     @JsonProperty("additionalTags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AWSResourceTag> getAdditionalTags() {
         return additionalTags;
     }
 
+    /**
+     * AdditionalTags is a set of additional tags to set on the DNS hosted zone. In addition to these tags,the DNS Zone controller will set a hive.openhsift.io/hostedzone tag identifying the HostedZone record that it belongs to.
+     */
     @JsonProperty("additionalTags")
     public void setAdditionalTags(List<AWSResourceTag> additionalTags) {
         this.additionalTags = additionalTags;
     }
 
+    /**
+     * AWSDNSZoneSpec contains AWS-specific DNSZone specifications
+     */
     @JsonProperty("credentialsAssumeRole")
     public AssumeRole getCredentialsAssumeRole() {
         return credentialsAssumeRole;
     }
 
+    /**
+     * AWSDNSZoneSpec contains AWS-specific DNSZone specifications
+     */
     @JsonProperty("credentialsAssumeRole")
     public void setCredentialsAssumeRole(AssumeRole credentialsAssumeRole) {
         this.credentialsAssumeRole = credentialsAssumeRole;
     }
 
+    /**
+     * AWSDNSZoneSpec contains AWS-specific DNSZone specifications
+     */
     @JsonProperty("credentialsSecretRef")
     public LocalObjectReference getCredentialsSecretRef() {
         return credentialsSecretRef;
     }
 
+    /**
+     * AWSDNSZoneSpec contains AWS-specific DNSZone specifications
+     */
     @JsonProperty("credentialsSecretRef")
     public void setCredentialsSecretRef(LocalObjectReference credentialsSecretRef) {
         this.credentialsSecretRef = credentialsSecretRef;
     }
 
+    /**
+     * Region is the AWS region to use for route53 operations. This defaults to us-east-1. For AWS China, use cn-northwest-1.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Region is the AWS region to use for route53 operations. This defaults to us-east-1. For AWS China, use cn-northwest-1.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSDNSZoneStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSDNSZoneStatus.java
index 2b01c305d8c..a5e79a61789 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSDNSZoneStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSDNSZoneStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSDNSZoneStatus contains status information specific to AWS DNS zones
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public AWSDNSZoneStatus(String zoneID) {
         this.zoneID = zoneID;
     }
 
+    /**
+     * ZoneID is the ID of the zone in AWS
+     */
     @JsonProperty("zoneID")
     public String getZoneID() {
         return zoneID;
     }
 
+    /**
+     * ZoneID is the ID of the zone in AWS
+     */
     @JsonProperty("zoneID")
     public void setZoneID(String zoneID) {
         this.zoneID = zoneID;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSPrivateLinkConfig.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSPrivateLinkConfig.java
index 83ac82c5793..4d3275d7018 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSPrivateLinkConfig.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSPrivateLinkConfig.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSPrivateLinkConfig defines the configuration for the aws-private-link controller.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,43 +97,67 @@ public AWSPrivateLinkConfig(List<AWSAssociatedVPC> associatedVPCs, LocalObjectRe
         this.endpointVPCInventory = endpointVPCInventory;
     }
 
+    /**
+     * AssociatedVPCs is the list of VPCs that should be able to resolve the DNS addresses setup for Private Link. This allows clients in VPC to resolve the AWS PrivateLink address using AWS's default DNS resolver for Private Route53 Hosted Zones.<br><p> <br><p> This list should at minimum include the VPC where the current Hive controller is running.
+     */
     @JsonProperty("associatedVPCs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AWSAssociatedVPC> getAssociatedVPCs() {
         return associatedVPCs;
     }
 
+    /**
+     * AssociatedVPCs is the list of VPCs that should be able to resolve the DNS addresses setup for Private Link. This allows clients in VPC to resolve the AWS PrivateLink address using AWS's default DNS resolver for Private Route53 Hosted Zones.<br><p> <br><p> This list should at minimum include the VPC where the current Hive controller is running.
+     */
     @JsonProperty("associatedVPCs")
     public void setAssociatedVPCs(List<AWSAssociatedVPC> associatedVPCs) {
         this.associatedVPCs = associatedVPCs;
     }
 
+    /**
+     * AWSPrivateLinkConfig defines the configuration for the aws-private-link controller.
+     */
     @JsonProperty("credentialsSecretRef")
     public LocalObjectReference getCredentialsSecretRef() {
         return credentialsSecretRef;
     }
 
+    /**
+     * AWSPrivateLinkConfig defines the configuration for the aws-private-link controller.
+     */
     @JsonProperty("credentialsSecretRef")
     public void setCredentialsSecretRef(LocalObjectReference credentialsSecretRef) {
         this.credentialsSecretRef = credentialsSecretRef;
     }
 
+    /**
+     * DNSRecordType defines what type of DNS record should be created in Private Hosted Zone for the customer cluster's API endpoint (which is the VPC Endpoint's regional DNS name).
+     */
     @JsonProperty("dnsRecordType")
     public String getDnsRecordType() {
         return dnsRecordType;
     }
 
+    /**
+     * DNSRecordType defines what type of DNS record should be created in Private Hosted Zone for the customer cluster's API endpoint (which is the VPC Endpoint's regional DNS name).
+     */
     @JsonProperty("dnsRecordType")
     public void setDnsRecordType(String dnsRecordType) {
         this.dnsRecordType = dnsRecordType;
     }
 
+    /**
+     * EndpointVPCInventory is a list of VPCs and the corresponding subnets in various AWS regions. The controller uses this list to choose a VPC for creating AWS VPC Endpoints. Since the VPC Endpoints must be in the same region as the ClusterDeployment, we must have VPCs in that region to be able to setup Private Link.
+     */
     @JsonProperty("endpointVPCInventory")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AWSPrivateLinkInventory> getEndpointVPCInventory() {
         return endpointVPCInventory;
     }
 
+    /**
+     * EndpointVPCInventory is a list of VPCs and the corresponding subnets in various AWS regions. The controller uses this list to choose a VPC for creating AWS VPC Endpoints. Since the VPC Endpoints must be in the same region as the ClusterDeployment, we must have VPCs in that region to be able to setup Private Link.
+     */
     @JsonProperty("endpointVPCInventory")
     public void setEndpointVPCInventory(List<AWSPrivateLinkInventory> endpointVPCInventory) {
         this.endpointVPCInventory = endpointVPCInventory;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSPrivateLinkInventory.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSPrivateLinkInventory.java
index 540d5b120c1..6b99103ad20 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSPrivateLinkInventory.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSPrivateLinkInventory.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSPrivateLinkInventory is a VPC and its corresponding subnets in an AWS region. This VPC will be used to create an AWS VPC Endpoint whenever there is a VPC Endpoint Service created for a ClusterDeployment.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public AWSPrivateLinkInventory(String region, List<AWSPrivateLinkSubnet> subnets
         this.vpcID = vpcID;
     }
 
+    /**
+     * AWSPrivateLinkInventory is a VPC and its corresponding subnets in an AWS region. This VPC will be used to create an AWS VPC Endpoint whenever there is a VPC Endpoint Service created for a ClusterDeployment.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * AWSPrivateLinkInventory is a VPC and its corresponding subnets in an AWS region. This VPC will be used to create an AWS VPC Endpoint whenever there is a VPC Endpoint Service created for a ClusterDeployment.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * AWSPrivateLinkInventory is a VPC and its corresponding subnets in an AWS region. This VPC will be used to create an AWS VPC Endpoint whenever there is a VPC Endpoint Service created for a ClusterDeployment.
+     */
     @JsonProperty("subnets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AWSPrivateLinkSubnet> getSubnets() {
         return subnets;
     }
 
+    /**
+     * AWSPrivateLinkInventory is a VPC and its corresponding subnets in an AWS region. This VPC will be used to create an AWS VPC Endpoint whenever there is a VPC Endpoint Service created for a ClusterDeployment.
+     */
     @JsonProperty("subnets")
     public void setSubnets(List<AWSPrivateLinkSubnet> subnets) {
         this.subnets = subnets;
     }
 
+    /**
+     * AWSPrivateLinkInventory is a VPC and its corresponding subnets in an AWS region. This VPC will be used to create an AWS VPC Endpoint whenever there is a VPC Endpoint Service created for a ClusterDeployment.
+     */
     @JsonProperty("vpcID")
     public String getVpcID() {
         return vpcID;
     }
 
+    /**
+     * AWSPrivateLinkInventory is a VPC and its corresponding subnets in an AWS region. This VPC will be used to create an AWS VPC Endpoint whenever there is a VPC Endpoint Service created for a ClusterDeployment.
+     */
     @JsonProperty("vpcID")
     public void setVpcID(String vpcID) {
         this.vpcID = vpcID;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSPrivateLinkSubnet.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSPrivateLinkSubnet.java
index f32fb503735..c59219647c0 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSPrivateLinkSubnet.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSPrivateLinkSubnet.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSPrivateLinkSubnet defines a subnet in the an AWS VPC.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public AWSPrivateLinkSubnet(String availabilityZone, String subnetID) {
         this.subnetID = subnetID;
     }
 
+    /**
+     * AWSPrivateLinkSubnet defines a subnet in the an AWS VPC.
+     */
     @JsonProperty("availabilityZone")
     public String getAvailabilityZone() {
         return availabilityZone;
     }
 
+    /**
+     * AWSPrivateLinkSubnet defines a subnet in the an AWS VPC.
+     */
     @JsonProperty("availabilityZone")
     public void setAvailabilityZone(String availabilityZone) {
         this.availabilityZone = availabilityZone;
     }
 
+    /**
+     * AWSPrivateLinkSubnet defines a subnet in the an AWS VPC.
+     */
     @JsonProperty("subnetID")
     public String getSubnetID() {
         return subnetID;
     }
 
+    /**
+     * AWSPrivateLinkSubnet defines a subnet in the an AWS VPC.
+     */
     @JsonProperty("subnetID")
     public void setSubnetID(String subnetID) {
         this.subnetID = subnetID;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSPrivateLinkVPC.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSPrivateLinkVPC.java
index ddbbe37fe19..a7e5ef4e24b 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSPrivateLinkVPC.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSPrivateLinkVPC.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSPrivateLinkVPC defines an AWS VPC in a region.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public AWSPrivateLinkVPC(String region, String vpcID) {
         this.vpcID = vpcID;
     }
 
+    /**
+     * AWSPrivateLinkVPC defines an AWS VPC in a region.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * AWSPrivateLinkVPC defines an AWS VPC in a region.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * AWSPrivateLinkVPC defines an AWS VPC in a region.
+     */
     @JsonProperty("vpcID")
     public String getVpcID() {
         return vpcID;
     }
 
+    /**
+     * AWSPrivateLinkVPC defines an AWS VPC in a region.
+     */
     @JsonProperty("vpcID")
     public void setVpcID(String vpcID) {
         this.vpcID = vpcID;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSResourceTag.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSResourceTag.java
index 924c01198d9..87ff0530d9e 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSResourceTag.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSResourceTag.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSResourceTag represents a tag that is applied to an AWS cloud resource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public AWSResourceTag(String key, String value) {
         this.value = value;
     }
 
+    /**
+     * Key is the key for the tag
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * Key is the key for the tag
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * Value is the value for the tag
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is the value for the tag
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSServiceProviderCredentials.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSServiceProviderCredentials.java
index b5175e4ca2b..427982c95bb 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSServiceProviderCredentials.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AWSServiceProviderCredentials.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSServiceProviderCredentials is used to configure credentials related to being a service provider on AWS.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public AWSServiceProviderCredentials(LocalObjectReference credentialsSecretRef)
         this.credentialsSecretRef = credentialsSecretRef;
     }
 
+    /**
+     * AWSServiceProviderCredentials is used to configure credentials related to being a service provider on AWS.
+     */
     @JsonProperty("credentialsSecretRef")
     public LocalObjectReference getCredentialsSecretRef() {
         return credentialsSecretRef;
     }
 
+    /**
+     * AWSServiceProviderCredentials is used to configure credentials related to being a service provider on AWS.
+     */
     @JsonProperty("credentialsSecretRef")
     public void setCredentialsSecretRef(LocalObjectReference credentialsSecretRef) {
         this.credentialsSecretRef = credentialsSecretRef;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ArgoCDConfig.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ArgoCDConfig.java
index b936e8eee83..4b87c3b3211 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ArgoCDConfig.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ArgoCDConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ArgoCDConfig contains settings for integration with ArgoCD.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ArgoCDConfig(Boolean enabled, String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Enabled dictates if ArgoCD gitops integration is enabled. If not specified, the default is disabled.
+     */
     @JsonProperty("enabled")
     public Boolean getEnabled() {
         return enabled;
     }
 
+    /**
+     * Enabled dictates if ArgoCD gitops integration is enabled. If not specified, the default is disabled.
+     */
     @JsonProperty("enabled")
     public void setEnabled(Boolean enabled) {
         this.enabled = enabled;
     }
 
+    /**
+     * Namespace specifies the namespace where ArgoCD is installed. Used for the location of cluster secrets. Defaults to "argocd"
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace specifies the namespace where ArgoCD is installed. Used for the location of cluster secrets. Defaults to "argocd"
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AzureClusterDeprovision.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AzureClusterDeprovision.java
index a2595476745..d3c8119806d 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AzureClusterDeprovision.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AzureClusterDeprovision.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzureClusterDeprovision contains Azure-specific configuration for a ClusterDeprovision
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public AzureClusterDeprovision(String cloudName, LocalObjectReference credential
         this.resourceGroupName = resourceGroupName;
     }
 
+    /**
+     * cloudName is the name of the Azure cloud environment which can be used to configure the Azure SDK with the appropriate Azure API endpoints. If empty, the value is equal to "AzurePublicCloud".
+     */
     @JsonProperty("cloudName")
     public String getCloudName() {
         return cloudName;
     }
 
+    /**
+     * cloudName is the name of the Azure cloud environment which can be used to configure the Azure SDK with the appropriate Azure API endpoints. If empty, the value is equal to "AzurePublicCloud".
+     */
     @JsonProperty("cloudName")
     public void setCloudName(String cloudName) {
         this.cloudName = cloudName;
     }
 
+    /**
+     * AzureClusterDeprovision contains Azure-specific configuration for a ClusterDeprovision
+     */
     @JsonProperty("credentialsSecretRef")
     public LocalObjectReference getCredentialsSecretRef() {
         return credentialsSecretRef;
     }
 
+    /**
+     * AzureClusterDeprovision contains Azure-specific configuration for a ClusterDeprovision
+     */
     @JsonProperty("credentialsSecretRef")
     public void setCredentialsSecretRef(LocalObjectReference credentialsSecretRef) {
         this.credentialsSecretRef = credentialsSecretRef;
     }
 
+    /**
+     * ResourceGroupName is the name of the resource group where the cluster was installed. Required for new deprovisions (schema notwithstanding).
+     */
     @JsonProperty("resourceGroupName")
     public String getResourceGroupName() {
         return resourceGroupName;
     }
 
+    /**
+     * ResourceGroupName is the name of the resource group where the cluster was installed. Required for new deprovisions (schema notwithstanding).
+     */
     @JsonProperty("resourceGroupName")
     public void setResourceGroupName(String resourceGroupName) {
         this.resourceGroupName = resourceGroupName;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AzureDNSZoneSpec.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AzureDNSZoneSpec.java
index c5243685519..689fb1a1c59 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AzureDNSZoneSpec.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AzureDNSZoneSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzureDNSZoneSpec contains Azure-specific DNSZone specifications
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public AzureDNSZoneSpec(String cloudName, LocalObjectReference credentialsSecret
         this.resourceGroupName = resourceGroupName;
     }
 
+    /**
+     * CloudName is the name of the Azure cloud environment which can be used to configure the Azure SDK with the appropriate Azure API endpoints. If empty, the value is equal to "AzurePublicCloud".
+     */
     @JsonProperty("cloudName")
     public String getCloudName() {
         return cloudName;
     }
 
+    /**
+     * CloudName is the name of the Azure cloud environment which can be used to configure the Azure SDK with the appropriate Azure API endpoints. If empty, the value is equal to "AzurePublicCloud".
+     */
     @JsonProperty("cloudName")
     public void setCloudName(String cloudName) {
         this.cloudName = cloudName;
     }
 
+    /**
+     * AzureDNSZoneSpec contains Azure-specific DNSZone specifications
+     */
     @JsonProperty("credentialsSecretRef")
     public LocalObjectReference getCredentialsSecretRef() {
         return credentialsSecretRef;
     }
 
+    /**
+     * AzureDNSZoneSpec contains Azure-specific DNSZone specifications
+     */
     @JsonProperty("credentialsSecretRef")
     public void setCredentialsSecretRef(LocalObjectReference credentialsSecretRef) {
         this.credentialsSecretRef = credentialsSecretRef;
     }
 
+    /**
+     * ResourceGroupName specifies the Azure resource group in which the Hosted Zone should be created.
+     */
     @JsonProperty("resourceGroupName")
     public String getResourceGroupName() {
         return resourceGroupName;
     }
 
+    /**
+     * ResourceGroupName specifies the Azure resource group in which the Hosted Zone should be created.
+     */
     @JsonProperty("resourceGroupName")
     public void setResourceGroupName(String resourceGroupName) {
         this.resourceGroupName = resourceGroupName;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AzureDNSZoneStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AzureDNSZoneStatus.java
index 98fca902977..af7fde5e7af 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AzureDNSZoneStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/AzureDNSZoneStatus.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzureDNSZoneStatus contains status information specific to Azure DNS zones
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/BackupConfig.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/BackupConfig.java
index 7598b13b568..f89254b2142 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/BackupConfig.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/BackupConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BackupConfig contains settings for the Velero backup integration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public BackupConfig(Integer minBackupPeriodSeconds, VeleroBackupConfig velero) {
         this.velero = velero;
     }
 
+    /**
+     * MinBackupPeriodSeconds specifies that a minimum of MinBackupPeriodSeconds will occur in between each backup. This is used to rate limit backups. This potentially batches together multiple changes into 1 backup. No backups will be lost as changes that happen during this interval are queued up and will result in a backup happening once the interval has been completed.
+     */
     @JsonProperty("minBackupPeriodSeconds")
     public Integer getMinBackupPeriodSeconds() {
         return minBackupPeriodSeconds;
     }
 
+    /**
+     * MinBackupPeriodSeconds specifies that a minimum of MinBackupPeriodSeconds will occur in between each backup. This is used to rate limit backups. This potentially batches together multiple changes into 1 backup. No backups will be lost as changes that happen during this interval are queued up and will result in a backup happening once the interval has been completed.
+     */
     @JsonProperty("minBackupPeriodSeconds")
     public void setMinBackupPeriodSeconds(Integer minBackupPeriodSeconds) {
         this.minBackupPeriodSeconds = minBackupPeriodSeconds;
     }
 
+    /**
+     * BackupConfig contains settings for the Velero backup integration.
+     */
     @JsonProperty("velero")
     public VeleroBackupConfig getVelero() {
         return velero;
     }
 
+    /**
+     * BackupConfig contains settings for the Velero backup integration.
+     */
     @JsonProperty("velero")
     public void setVelero(VeleroBackupConfig velero) {
         this.velero = velero;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/BackupReference.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/BackupReference.java
index 4e3dff02dbb..ca6a0efaf62 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/BackupReference.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/BackupReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BackupReference is a reference to a backup resource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public BackupReference(String name, String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * BackupReference is a reference to a backup resource
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * BackupReference is a reference to a backup resource
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * BackupReference is a reference to a backup resource
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * BackupReference is a reference to a backup resource
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/CertificateBundleSpec.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/CertificateBundleSpec.java
index 5ee6d24042f..a90da0b75f2 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/CertificateBundleSpec.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/CertificateBundleSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CertificateBundleSpec specifies a certificate bundle associated with a cluster deployment
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public CertificateBundleSpec(LocalObjectReference certificateSecretRef, Boolean
         this.name = name;
     }
 
+    /**
+     * CertificateBundleSpec specifies a certificate bundle associated with a cluster deployment
+     */
     @JsonProperty("certificateSecretRef")
     public LocalObjectReference getCertificateSecretRef() {
         return certificateSecretRef;
     }
 
+    /**
+     * CertificateBundleSpec specifies a certificate bundle associated with a cluster deployment
+     */
     @JsonProperty("certificateSecretRef")
     public void setCertificateSecretRef(LocalObjectReference certificateSecretRef) {
         this.certificateSecretRef = certificateSecretRef;
     }
 
+    /**
+     * Generate indicates whether this bundle should have real certificates generated for it.
+     */
     @JsonProperty("generate")
     public Boolean getGenerate() {
         return generate;
     }
 
+    /**
+     * Generate indicates whether this bundle should have real certificates generated for it.
+     */
     @JsonProperty("generate")
     public void setGenerate(Boolean generate) {
         this.generate = generate;
     }
 
+    /**
+     * Name is an identifier that must be unique within the bundle and must be referenced by an ingress or by the control plane serving certs
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is an identifier that must be unique within the bundle and must be referenced by an ingress or by the control plane serving certs
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/CertificateBundleStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/CertificateBundleStatus.java
index 9b671fd90de..3b0fb790685 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/CertificateBundleStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/CertificateBundleStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CertificateBundleStatus specifies whether a certificate bundle was generated for this cluster deployment.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public CertificateBundleStatus(Boolean generated, String name) {
         this.name = name;
     }
 
+    /**
+     * Generated indicates whether the certificate bundle was generated
+     */
     @JsonProperty("generated")
     public Boolean getGenerated() {
         return generated;
     }
 
+    /**
+     * Generated indicates whether the certificate bundle was generated
+     */
     @JsonProperty("generated")
     public void setGenerated(Boolean generated) {
         this.generated = generated;
     }
 
+    /**
+     * Name of the certificate bundle
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the certificate bundle
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/Checkpoint.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/Checkpoint.java
index 8939f129947..948f6796e66 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/Checkpoint.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/Checkpoint.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Checkpoint is the Schema for the backup of Hive objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Checkpoint implements Editable<CheckpointBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Checkpoint";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Checkpoint(String apiVersion, String kind, ObjectMeta metadata, Checkpoin
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Checkpoint is the Schema for the backup of Hive objects.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Checkpoint is the Schema for the backup of Hive objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Checkpoint is the Schema for the backup of Hive objects.
+     */
     @JsonProperty("spec")
     public CheckpointSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Checkpoint is the Schema for the backup of Hive objects.
+     */
     @JsonProperty("spec")
     public void setSpec(CheckpointSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Checkpoint is the Schema for the backup of Hive objects.
+     */
     @JsonProperty("status")
     public CheckpointStatus getStatus() {
         return status;
     }
 
+    /**
+     * Checkpoint is the Schema for the backup of Hive objects.
+     */
     @JsonProperty("status")
     public void setStatus(CheckpointStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/CheckpointList.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/CheckpointList.java
index 212c3e0bf4d..9fe084d4445 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/CheckpointList.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/CheckpointList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CheckpointList contains a list of Checkpoint
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class CheckpointList implements Editable<CheckpointListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.hive.v1.Checkpoint>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.hive.v1.Checkpoint> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CheckpointList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CheckpointList(String apiVersion, List<io.fabric8.openshift.api.model.hiv
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * CheckpointList contains a list of Checkpoint
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.hive.v1.Checkpoint> getItems() {
         return items;
     }
 
+    /**
+     * CheckpointList contains a list of Checkpoint
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.hive.v1.Checkpoint> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CheckpointList contains a list of Checkpoint
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CheckpointList contains a list of Checkpoint
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/CheckpointSpec.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/CheckpointSpec.java
index ab6e1156e2b..c5edee4f935 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/CheckpointSpec.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/CheckpointSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CheckpointSpec defines the metadata around the Hive objects state in the namespace at the time of the last backup.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public CheckpointSpec(String lastBackupChecksum, BackupReference lastBackupRef,
         this.lastBackupTime = lastBackupTime;
     }
 
+    /**
+     * LastBackupChecksum is the checksum of all Hive objects in the namespace at the time of the last backup.
+     */
     @JsonProperty("lastBackupChecksum")
     public String getLastBackupChecksum() {
         return lastBackupChecksum;
     }
 
+    /**
+     * LastBackupChecksum is the checksum of all Hive objects in the namespace at the time of the last backup.
+     */
     @JsonProperty("lastBackupChecksum")
     public void setLastBackupChecksum(String lastBackupChecksum) {
         this.lastBackupChecksum = lastBackupChecksum;
     }
 
+    /**
+     * CheckpointSpec defines the metadata around the Hive objects state in the namespace at the time of the last backup.
+     */
     @JsonProperty("lastBackupRef")
     public BackupReference getLastBackupRef() {
         return lastBackupRef;
     }
 
+    /**
+     * CheckpointSpec defines the metadata around the Hive objects state in the namespace at the time of the last backup.
+     */
     @JsonProperty("lastBackupRef")
     public void setLastBackupRef(BackupReference lastBackupRef) {
         this.lastBackupRef = lastBackupRef;
     }
 
+    /**
+     * CheckpointSpec defines the metadata around the Hive objects state in the namespace at the time of the last backup.
+     */
     @JsonProperty("lastBackupTime")
     public String getLastBackupTime() {
         return lastBackupTime;
     }
 
+    /**
+     * CheckpointSpec defines the metadata around the Hive objects state in the namespace at the time of the last backup.
+     */
     @JsonProperty("lastBackupTime")
     public void setLastBackupTime(String lastBackupTime) {
         this.lastBackupTime = lastBackupTime;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/CheckpointStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/CheckpointStatus.java
index 5fac409138f..e1fa47509fb 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/CheckpointStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/CheckpointStatus.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CheckpointStatus defines the observed state of Checkpoint
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterClaim.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterClaim.java
index 863904b7a4f..6f72055b364 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterClaim.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterClaim.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterClaim represents a claim to a cluster from a cluster pool.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class ClusterClaim implements Editable<ClusterClaimBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterClaim";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterClaim(String apiVersion, String kind, ObjectMeta metadata, Cluster
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterClaim represents a claim to a cluster from a cluster pool.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterClaim represents a claim to a cluster from a cluster pool.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ClusterClaim represents a claim to a cluster from a cluster pool.
+     */
     @JsonProperty("spec")
     public ClusterClaimSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ClusterClaim represents a claim to a cluster from a cluster pool.
+     */
     @JsonProperty("spec")
     public void setSpec(ClusterClaimSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ClusterClaim represents a claim to a cluster from a cluster pool.
+     */
     @JsonProperty("status")
     public ClusterClaimStatus getStatus() {
         return status;
     }
 
+    /**
+     * ClusterClaim represents a claim to a cluster from a cluster pool.
+     */
     @JsonProperty("status")
     public void setStatus(ClusterClaimStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterClaimCondition.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterClaimCondition.java
index 217dc947404..fddc9cb39a2 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterClaimCondition.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterClaimCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterClaimCondition contains details for the current condition of a cluster claim.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public ClusterClaimCondition(String lastProbeTime, String lastTransitionTime, St
         this.type = type;
     }
 
+    /**
+     * ClusterClaimCondition contains details for the current condition of a cluster claim.
+     */
     @JsonProperty("lastProbeTime")
     public String getLastProbeTime() {
         return lastProbeTime;
     }
 
+    /**
+     * ClusterClaimCondition contains details for the current condition of a cluster claim.
+     */
     @JsonProperty("lastProbeTime")
     public void setLastProbeTime(String lastProbeTime) {
         this.lastProbeTime = lastProbeTime;
     }
 
+    /**
+     * ClusterClaimCondition contains details for the current condition of a cluster claim.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * ClusterClaimCondition contains details for the current condition of a cluster claim.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Message is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Reason is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status is the status of the condition.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status is the status of the condition.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type is the type of the condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of the condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterClaimList.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterClaimList.java
index ad2ee4aa9e2..fdaae793833 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterClaimList.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterClaimList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterClaimList contains a list of ClusterClaims.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ClusterClaimList implements Editable<ClusterClaimListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.hive.v1.ClusterClaim>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.hive.v1.ClusterClaim> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterClaimList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterClaimList(String apiVersion, List<io.fabric8.openshift.api.model.h
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ClusterClaimList contains a list of ClusterClaims.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.hive.v1.ClusterClaim> getItems() {
         return items;
     }
 
+    /**
+     * ClusterClaimList contains a list of ClusterClaims.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.hive.v1.ClusterClaim> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterClaimList contains a list of ClusterClaims.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterClaimList contains a list of ClusterClaims.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterClaimSpec.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterClaimSpec.java
index 932988611bd..9dd5eea4e48 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterClaimSpec.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterClaimSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterClaimSpec defines the desired state of the ClusterClaim.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,42 +97,66 @@ public ClusterClaimSpec(String clusterPoolName, String lifetime, String namespac
         this.subjects = subjects;
     }
 
+    /**
+     * ClusterPoolName is the name of the cluster pool from which to claim a cluster.
+     */
     @JsonProperty("clusterPoolName")
     public String getClusterPoolName() {
         return clusterPoolName;
     }
 
+    /**
+     * ClusterPoolName is the name of the cluster pool from which to claim a cluster.
+     */
     @JsonProperty("clusterPoolName")
     public void setClusterPoolName(String clusterPoolName) {
         this.clusterPoolName = clusterPoolName;
     }
 
+    /**
+     * ClusterClaimSpec defines the desired state of the ClusterClaim.
+     */
     @JsonProperty("lifetime")
     public String getLifetime() {
         return lifetime;
     }
 
+    /**
+     * ClusterClaimSpec defines the desired state of the ClusterClaim.
+     */
     @JsonProperty("lifetime")
     public void setLifetime(String lifetime) {
         this.lifetime = lifetime;
     }
 
+    /**
+     * Namespace is the namespace containing the ClusterDeployment (name will match the namespace) of the claimed cluster. This field will be set as soon as a suitable cluster can be found, however that cluster may still be resuming and not yet ready for use. Wait for the ClusterRunning condition to be true to avoid this issue.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace containing the ClusterDeployment (name will match the namespace) of the claimed cluster. This field will be set as soon as a suitable cluster can be found, however that cluster may still be resuming and not yet ready for use. Wait for the ClusterRunning condition to be true to avoid this issue.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Subjects hold references to which to authorize access to the claimed cluster.
+     */
     @JsonProperty("subjects")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Subject> getSubjects() {
         return subjects;
     }
 
+    /**
+     * Subjects hold references to which to authorize access to the claimed cluster.
+     */
     @JsonProperty("subjects")
     public void setSubjects(List<Subject> subjects) {
         this.subjects = subjects;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterClaimStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterClaimStatus.java
index 06501c70667..e5509b84e2a 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterClaimStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterClaimStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterClaimStatus defines the observed state of ClusterClaim.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public ClusterClaimStatus(List<ClusterClaimCondition> conditions, String lifetim
         this.lifetime = lifetime;
     }
 
+    /**
+     * Conditions includes more detailed status for the cluster pool.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ClusterClaimCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions includes more detailed status for the cluster pool.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ClusterClaimCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ClusterClaimStatus defines the observed state of ClusterClaim.
+     */
     @JsonProperty("lifetime")
     public String getLifetime() {
         return lifetime;
     }
 
+    /**
+     * ClusterClaimStatus defines the observed state of ClusterClaim.
+     */
     @JsonProperty("lifetime")
     public void setLifetime(String lifetime) {
         this.lifetime = lifetime;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeployment.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeployment.java
index 79be66b1ddb..c85d24cd9c0 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeployment.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeployment.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterDeployment is the Schema for the clusterdeployments API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class ClusterDeployment implements Editable<ClusterDeploymentBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterDeployment";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterDeployment(String apiVersion, String kind, ObjectMeta metadata, Cl
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterDeployment is the Schema for the clusterdeployments API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterDeployment is the Schema for the clusterdeployments API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ClusterDeployment is the Schema for the clusterdeployments API
+     */
     @JsonProperty("spec")
     public ClusterDeploymentSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ClusterDeployment is the Schema for the clusterdeployments API
+     */
     @JsonProperty("spec")
     public void setSpec(ClusterDeploymentSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ClusterDeployment is the Schema for the clusterdeployments API
+     */
     @JsonProperty("status")
     public ClusterDeploymentStatus getStatus() {
         return status;
     }
 
+    /**
+     * ClusterDeployment is the Schema for the clusterdeployments API
+     */
     @JsonProperty("status")
     public void setStatus(ClusterDeploymentStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentCondition.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentCondition.java
index 69cbef4f639..6fb73afb1c1 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentCondition.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterDeploymentCondition contains details for the current condition of a cluster deployment
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public ClusterDeploymentCondition(String lastProbeTime, String lastTransitionTim
         this.type = type;
     }
 
+    /**
+     * ClusterDeploymentCondition contains details for the current condition of a cluster deployment
+     */
     @JsonProperty("lastProbeTime")
     public String getLastProbeTime() {
         return lastProbeTime;
     }
 
+    /**
+     * ClusterDeploymentCondition contains details for the current condition of a cluster deployment
+     */
     @JsonProperty("lastProbeTime")
     public void setLastProbeTime(String lastProbeTime) {
         this.lastProbeTime = lastProbeTime;
     }
 
+    /**
+     * ClusterDeploymentCondition contains details for the current condition of a cluster deployment
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * ClusterDeploymentCondition contains details for the current condition of a cluster deployment
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Message is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Reason is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status is the status of the condition.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status is the status of the condition.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type is the type of the condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of the condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentCustomization.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentCustomization.java
index bf758ed4d61..18365482b52 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentCustomization.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentCustomization.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterDeploymentCustomization is the Schema for clusterdeploymentcustomizations API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class ClusterDeploymentCustomization implements Editable<ClusterDeploymentCustomizationBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterDeploymentCustomization";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterDeploymentCustomization(String apiVersion, String kind, ObjectMeta
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterDeploymentCustomization is the Schema for clusterdeploymentcustomizations API.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterDeploymentCustomization is the Schema for clusterdeploymentcustomizations API.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ClusterDeploymentCustomization is the Schema for clusterdeploymentcustomizations API.
+     */
     @JsonProperty("spec")
     public ClusterDeploymentCustomizationSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ClusterDeploymentCustomization is the Schema for clusterdeploymentcustomizations API.
+     */
     @JsonProperty("spec")
     public void setSpec(ClusterDeploymentCustomizationSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ClusterDeploymentCustomization is the Schema for clusterdeploymentcustomizations API.
+     */
     @JsonProperty("status")
     public ClusterDeploymentCustomizationStatus getStatus() {
         return status;
     }
 
+    /**
+     * ClusterDeploymentCustomization is the Schema for clusterdeploymentcustomizations API.
+     */
     @JsonProperty("status")
     public void setStatus(ClusterDeploymentCustomizationStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentCustomizationList.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentCustomizationList.java
index 0e2210f8e64..31511dc59a8 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentCustomizationList.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentCustomizationList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterDeploymentCustomizationList contains a list of ClusterDeploymentCustomizations.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ClusterDeploymentCustomizationList implements Editable<ClusterDeploymentCustomizationListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.hive.v1.ClusterDeploymentCustomization>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.hive.v1.ClusterDeploymentCustomization> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterDeploymentCustomizationList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterDeploymentCustomizationList(String apiVersion, List<io.fabric8.ope
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ClusterDeploymentCustomizationList contains a list of ClusterDeploymentCustomizations.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.hive.v1.ClusterDeploymentCustomization> getItems() {
         return items;
     }
 
+    /**
+     * ClusterDeploymentCustomizationList contains a list of ClusterDeploymentCustomizations.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.hive.v1.ClusterDeploymentCustomization> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterDeploymentCustomizationList contains a list of ClusterDeploymentCustomizations.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterDeploymentCustomizationList contains a list of ClusterDeploymentCustomizations.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentCustomizationSpec.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentCustomizationSpec.java
index cf3305a589d..f508b98ce9c 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentCustomizationSpec.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentCustomizationSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterDeploymentCustomizationSpec defines the desired state of ClusterDeploymentCustomization.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public ClusterDeploymentCustomizationSpec(List<PatchEntity> installConfigPatches
         this.installConfigPatches = installConfigPatches;
     }
 
+    /**
+     * InstallConfigPatches is a list of patches to be applied to the install-config.
+     */
     @JsonProperty("installConfigPatches")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PatchEntity> getInstallConfigPatches() {
         return installConfigPatches;
     }
 
+    /**
+     * InstallConfigPatches is a list of patches to be applied to the install-config.
+     */
     @JsonProperty("installConfigPatches")
     public void setInstallConfigPatches(List<PatchEntity> installConfigPatches) {
         this.installConfigPatches = installConfigPatches;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentCustomizationStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentCustomizationStatus.java
index d6377d342e1..60ec567828e 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentCustomizationStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentCustomizationStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterDeploymentCustomizationStatus defines the observed state of ClusterDeploymentCustomization.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,42 +97,66 @@ public ClusterDeploymentCustomizationStatus(LocalObjectReference clusterDeployme
         this.lastAppliedConfiguration = lastAppliedConfiguration;
     }
 
+    /**
+     * ClusterDeploymentCustomizationStatus defines the observed state of ClusterDeploymentCustomization.
+     */
     @JsonProperty("clusterDeploymentRef")
     public LocalObjectReference getClusterDeploymentRef() {
         return clusterDeploymentRef;
     }
 
+    /**
+     * ClusterDeploymentCustomizationStatus defines the observed state of ClusterDeploymentCustomization.
+     */
     @JsonProperty("clusterDeploymentRef")
     public void setClusterDeploymentRef(LocalObjectReference clusterDeploymentRef) {
         this.clusterDeploymentRef = clusterDeploymentRef;
     }
 
+    /**
+     * ClusterDeploymentCustomizationStatus defines the observed state of ClusterDeploymentCustomization.
+     */
     @JsonProperty("clusterPoolRef")
     public LocalObjectReference getClusterPoolRef() {
         return clusterPoolRef;
     }
 
+    /**
+     * ClusterDeploymentCustomizationStatus defines the observed state of ClusterDeploymentCustomization.
+     */
     @JsonProperty("clusterPoolRef")
     public void setClusterPoolRef(LocalObjectReference clusterPoolRef) {
         this.clusterPoolRef = clusterPoolRef;
     }
 
+    /**
+     * Conditions describes the state of the operator's reconciliation functionality.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions describes the state of the operator's reconciliation functionality.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * LastAppliedConfiguration contains the last applied patches to the install-config. The information will retain for reference in case the customization is updated.
+     */
     @JsonProperty("lastAppliedConfiguration")
     public String getLastAppliedConfiguration() {
         return lastAppliedConfiguration;
     }
 
+    /**
+     * LastAppliedConfiguration contains the last applied patches to the install-config. The information will retain for reference in case the customization is updated.
+     */
     @JsonProperty("lastAppliedConfiguration")
     public void setLastAppliedConfiguration(String lastAppliedConfiguration) {
         this.lastAppliedConfiguration = lastAppliedConfiguration;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentList.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentList.java
index 46f4f124c2b..19baedd2d70 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentList.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterDeploymentList contains a list of ClusterDeployment
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ClusterDeploymentList implements Editable<ClusterDeploymentListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.hive.v1.ClusterDeployment>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.hive.v1.ClusterDeployment> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterDeploymentList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterDeploymentList(String apiVersion, List<io.fabric8.openshift.api.mo
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ClusterDeploymentList contains a list of ClusterDeployment
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.hive.v1.ClusterDeployment> getItems() {
         return items;
     }
 
+    /**
+     * ClusterDeploymentList contains a list of ClusterDeployment
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.hive.v1.ClusterDeployment> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterDeploymentList contains a list of ClusterDeployment
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterDeploymentList contains a list of ClusterDeployment
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentSpec.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentSpec.java
index 77bc538a62c..787c2db1209 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentSpec.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterDeploymentSpec defines the desired state of ClusterDeployment
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -150,183 +153,291 @@ public ClusterDeploymentSpec(String baseDomain, LocalObjectReference boundServic
         this.pullSecretRef = pullSecretRef;
     }
 
+    /**
+     * BaseDomain is the base domain to which the cluster should belong.
+     */
     @JsonProperty("baseDomain")
     public String getBaseDomain() {
         return baseDomain;
     }
 
+    /**
+     * BaseDomain is the base domain to which the cluster should belong.
+     */
     @JsonProperty("baseDomain")
     public void setBaseDomain(String baseDomain) {
         this.baseDomain = baseDomain;
     }
 
+    /**
+     * ClusterDeploymentSpec defines the desired state of ClusterDeployment
+     */
     @JsonProperty("boundServiceAccountSigningKeySecretRef")
     public LocalObjectReference getBoundServiceAccountSigningKeySecretRef() {
         return boundServiceAccountSigningKeySecretRef;
     }
 
+    /**
+     * ClusterDeploymentSpec defines the desired state of ClusterDeployment
+     */
     @JsonProperty("boundServiceAccountSigningKeySecretRef")
     public void setBoundServiceAccountSigningKeySecretRef(LocalObjectReference boundServiceAccountSigningKeySecretRef) {
         this.boundServiceAccountSigningKeySecretRef = boundServiceAccountSigningKeySecretRef;
     }
 
+    /**
+     * CertificateBundles is a list of certificate bundles associated with this cluster
+     */
     @JsonProperty("certificateBundles")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CertificateBundleSpec> getCertificateBundles() {
         return certificateBundles;
     }
 
+    /**
+     * CertificateBundles is a list of certificate bundles associated with this cluster
+     */
     @JsonProperty("certificateBundles")
     public void setCertificateBundles(List<CertificateBundleSpec> certificateBundles) {
         this.certificateBundles = certificateBundles;
     }
 
+    /**
+     * ClusterDeploymentSpec defines the desired state of ClusterDeployment
+     */
     @JsonProperty("clusterInstallRef")
     public ClusterInstallLocalReference getClusterInstallRef() {
         return clusterInstallRef;
     }
 
+    /**
+     * ClusterDeploymentSpec defines the desired state of ClusterDeployment
+     */
     @JsonProperty("clusterInstallRef")
     public void setClusterInstallRef(ClusterInstallLocalReference clusterInstallRef) {
         this.clusterInstallRef = clusterInstallRef;
     }
 
+    /**
+     * ClusterDeploymentSpec defines the desired state of ClusterDeployment
+     */
     @JsonProperty("clusterMetadata")
     public ClusterMetadata getClusterMetadata() {
         return clusterMetadata;
     }
 
+    /**
+     * ClusterDeploymentSpec defines the desired state of ClusterDeployment
+     */
     @JsonProperty("clusterMetadata")
     public void setClusterMetadata(ClusterMetadata clusterMetadata) {
         this.clusterMetadata = clusterMetadata;
     }
 
+    /**
+     * ClusterName is the friendly name of the cluster. It is used for subdomains, some resource tagging, and other instances where a friendly name for the cluster is useful.
+     */
     @JsonProperty("clusterName")
     public String getClusterName() {
         return clusterName;
     }
 
+    /**
+     * ClusterName is the friendly name of the cluster. It is used for subdomains, some resource tagging, and other instances where a friendly name for the cluster is useful.
+     */
     @JsonProperty("clusterName")
     public void setClusterName(String clusterName) {
         this.clusterName = clusterName;
     }
 
+    /**
+     * ClusterDeploymentSpec defines the desired state of ClusterDeployment
+     */
     @JsonProperty("clusterPoolRef")
     public ClusterPoolReference getClusterPoolRef() {
         return clusterPoolRef;
     }
 
+    /**
+     * ClusterDeploymentSpec defines the desired state of ClusterDeployment
+     */
     @JsonProperty("clusterPoolRef")
     public void setClusterPoolRef(ClusterPoolReference clusterPoolRef) {
         this.clusterPoolRef = clusterPoolRef;
     }
 
+    /**
+     * ClusterDeploymentSpec defines the desired state of ClusterDeployment
+     */
     @JsonProperty("controlPlaneConfig")
     public ControlPlaneConfigSpec getControlPlaneConfig() {
         return controlPlaneConfig;
     }
 
+    /**
+     * ClusterDeploymentSpec defines the desired state of ClusterDeployment
+     */
     @JsonProperty("controlPlaneConfig")
     public void setControlPlaneConfig(ControlPlaneConfigSpec controlPlaneConfig) {
         this.controlPlaneConfig = controlPlaneConfig;
     }
 
+    /**
+     * ClusterDeploymentSpec defines the desired state of ClusterDeployment
+     */
     @JsonProperty("hibernateAfter")
     public String getHibernateAfter() {
         return hibernateAfter;
     }
 
+    /**
+     * ClusterDeploymentSpec defines the desired state of ClusterDeployment
+     */
     @JsonProperty("hibernateAfter")
     public void setHibernateAfter(String hibernateAfter) {
         this.hibernateAfter = hibernateAfter;
     }
 
+    /**
+     * Ingress allows defining desired clusteringress/shards to be configured on the cluster.
+     */
     @JsonProperty("ingress")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ClusterIngress> getIngress() {
         return ingress;
     }
 
+    /**
+     * Ingress allows defining desired clusteringress/shards to be configured on the cluster.
+     */
     @JsonProperty("ingress")
     public void setIngress(List<ClusterIngress> ingress) {
         this.ingress = ingress;
     }
 
+    /**
+     * InstallAttemptsLimit is the maximum number of times Hive will attempt to install the cluster.
+     */
     @JsonProperty("installAttemptsLimit")
     public Integer getInstallAttemptsLimit() {
         return installAttemptsLimit;
     }
 
+    /**
+     * InstallAttemptsLimit is the maximum number of times Hive will attempt to install the cluster.
+     */
     @JsonProperty("installAttemptsLimit")
     public void setInstallAttemptsLimit(Integer installAttemptsLimit) {
         this.installAttemptsLimit = installAttemptsLimit;
     }
 
+    /**
+     * Installed is true if the cluster has been installed
+     */
     @JsonProperty("installed")
     public Boolean getInstalled() {
         return installed;
     }
 
+    /**
+     * Installed is true if the cluster has been installed
+     */
     @JsonProperty("installed")
     public void setInstalled(Boolean installed) {
         this.installed = installed;
     }
 
+    /**
+     * ManageDNS specifies whether a DNSZone should be created and managed automatically for this ClusterDeployment
+     */
     @JsonProperty("manageDNS")
     public Boolean getManageDNS() {
         return manageDNS;
     }
 
+    /**
+     * ManageDNS specifies whether a DNSZone should be created and managed automatically for this ClusterDeployment
+     */
     @JsonProperty("manageDNS")
     public void setManageDNS(Boolean manageDNS) {
         this.manageDNS = manageDNS;
     }
 
+    /**
+     * ClusterDeploymentSpec defines the desired state of ClusterDeployment
+     */
     @JsonProperty("platform")
     public Platform getPlatform() {
         return platform;
     }
 
+    /**
+     * ClusterDeploymentSpec defines the desired state of ClusterDeployment
+     */
     @JsonProperty("platform")
     public void setPlatform(Platform platform) {
         this.platform = platform;
     }
 
+    /**
+     * PowerState indicates whether a cluster should be running or hibernating. When omitted, PowerState defaults to the Running state.
+     */
     @JsonProperty("powerState")
     public String getPowerState() {
         return powerState;
     }
 
+    /**
+     * PowerState indicates whether a cluster should be running or hibernating. When omitted, PowerState defaults to the Running state.
+     */
     @JsonProperty("powerState")
     public void setPowerState(String powerState) {
         this.powerState = powerState;
     }
 
+    /**
+     * PreserveOnDelete allows the user to disconnect a cluster from Hive without deprovisioning it. This can also be used to abandon ongoing cluster deprovision.
+     */
     @JsonProperty("preserveOnDelete")
     public Boolean getPreserveOnDelete() {
         return preserveOnDelete;
     }
 
+    /**
+     * PreserveOnDelete allows the user to disconnect a cluster from Hive without deprovisioning it. This can also be used to abandon ongoing cluster deprovision.
+     */
     @JsonProperty("preserveOnDelete")
     public void setPreserveOnDelete(Boolean preserveOnDelete) {
         this.preserveOnDelete = preserveOnDelete;
     }
 
+    /**
+     * ClusterDeploymentSpec defines the desired state of ClusterDeployment
+     */
     @JsonProperty("provisioning")
     public Provisioning getProvisioning() {
         return provisioning;
     }
 
+    /**
+     * ClusterDeploymentSpec defines the desired state of ClusterDeployment
+     */
     @JsonProperty("provisioning")
     public void setProvisioning(Provisioning provisioning) {
         this.provisioning = provisioning;
     }
 
+    /**
+     * ClusterDeploymentSpec defines the desired state of ClusterDeployment
+     */
     @JsonProperty("pullSecretRef")
     public LocalObjectReference getPullSecretRef() {
         return pullSecretRef;
     }
 
+    /**
+     * ClusterDeploymentSpec defines the desired state of ClusterDeployment
+     */
     @JsonProperty("pullSecretRef")
     public void setPullSecretRef(LocalObjectReference pullSecretRef) {
         this.pullSecretRef = pullSecretRef;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentStatus.java
index 4087c083612..d027584b004 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeploymentStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterDeploymentStatus defines the observed state of ClusterDeployment
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -130,133 +133,211 @@ public ClusterDeploymentStatus(String apiURL, List<CertificateBundleStatus> cert
         this.webConsoleURL = webConsoleURL;
     }
 
+    /**
+     * APIURL is the URL where the cluster's API can be accessed.
+     */
     @JsonProperty("apiURL")
     public String getApiURL() {
         return apiURL;
     }
 
+    /**
+     * APIURL is the URL where the cluster's API can be accessed.
+     */
     @JsonProperty("apiURL")
     public void setApiURL(String apiURL) {
         this.apiURL = apiURL;
     }
 
+    /**
+     * CertificateBundles contains of the status of the certificate bundles associated with this cluster deployment.
+     */
     @JsonProperty("certificateBundles")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CertificateBundleStatus> getCertificateBundles() {
         return certificateBundles;
     }
 
+    /**
+     * CertificateBundles contains of the status of the certificate bundles associated with this cluster deployment.
+     */
     @JsonProperty("certificateBundles")
     public void setCertificateBundles(List<CertificateBundleStatus> certificateBundles) {
         this.certificateBundles = certificateBundles;
     }
 
+    /**
+     * CLIImage is the name of the oc cli image to use when installing the target cluster
+     */
     @JsonProperty("cliImage")
     public String getCliImage() {
         return cliImage;
     }
 
+    /**
+     * CLIImage is the name of the oc cli image to use when installing the target cluster
+     */
     @JsonProperty("cliImage")
     public void setCliImage(String cliImage) {
         this.cliImage = cliImage;
     }
 
+    /**
+     * Conditions includes more detailed status for the cluster deployment
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ClusterDeploymentCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions includes more detailed status for the cluster deployment
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ClusterDeploymentCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * InstallRestarts is the total count of container restarts on the clusters install job.
+     */
     @JsonProperty("installRestarts")
     public Integer getInstallRestarts() {
         return installRestarts;
     }
 
+    /**
+     * InstallRestarts is the total count of container restarts on the clusters install job.
+     */
     @JsonProperty("installRestarts")
     public void setInstallRestarts(Integer installRestarts) {
         this.installRestarts = installRestarts;
     }
 
+    /**
+     * ClusterDeploymentStatus defines the observed state of ClusterDeployment
+     */
     @JsonProperty("installStartedTimestamp")
     public String getInstallStartedTimestamp() {
         return installStartedTimestamp;
     }
 
+    /**
+     * ClusterDeploymentStatus defines the observed state of ClusterDeployment
+     */
     @JsonProperty("installStartedTimestamp")
     public void setInstallStartedTimestamp(String installStartedTimestamp) {
         this.installStartedTimestamp = installStartedTimestamp;
     }
 
+    /**
+     * InstallVersion is the version of OpenShift as reported by the release image resolved for the installation.
+     */
     @JsonProperty("installVersion")
     public String getInstallVersion() {
         return installVersion;
     }
 
+    /**
+     * InstallVersion is the version of OpenShift as reported by the release image resolved for the installation.
+     */
     @JsonProperty("installVersion")
     public void setInstallVersion(String installVersion) {
         this.installVersion = installVersion;
     }
 
+    /**
+     * ClusterDeploymentStatus defines the observed state of ClusterDeployment
+     */
     @JsonProperty("installedTimestamp")
     public String getInstalledTimestamp() {
         return installedTimestamp;
     }
 
+    /**
+     * ClusterDeploymentStatus defines the observed state of ClusterDeployment
+     */
     @JsonProperty("installedTimestamp")
     public void setInstalledTimestamp(String installedTimestamp) {
         this.installedTimestamp = installedTimestamp;
     }
 
+    /**
+     * InstallerImage is the name of the installer image to use when installing the target cluster
+     */
     @JsonProperty("installerImage")
     public String getInstallerImage() {
         return installerImage;
     }
 
+    /**
+     * InstallerImage is the name of the installer image to use when installing the target cluster
+     */
     @JsonProperty("installerImage")
     public void setInstallerImage(String installerImage) {
         this.installerImage = installerImage;
     }
 
+    /**
+     * ClusterDeploymentStatus defines the observed state of ClusterDeployment
+     */
     @JsonProperty("platformStatus")
     public PlatformStatus getPlatformStatus() {
         return platformStatus;
     }
 
+    /**
+     * ClusterDeploymentStatus defines the observed state of ClusterDeployment
+     */
     @JsonProperty("platformStatus")
     public void setPlatformStatus(PlatformStatus platformStatus) {
         this.platformStatus = platformStatus;
     }
 
+    /**
+     * PowerState indicates the powerstate of cluster
+     */
     @JsonProperty("powerState")
     public String getPowerState() {
         return powerState;
     }
 
+    /**
+     * PowerState indicates the powerstate of cluster
+     */
     @JsonProperty("powerState")
     public void setPowerState(String powerState) {
         this.powerState = powerState;
     }
 
+    /**
+     * ClusterDeploymentStatus defines the observed state of ClusterDeployment
+     */
     @JsonProperty("provisionRef")
     public LocalObjectReference getProvisionRef() {
         return provisionRef;
     }
 
+    /**
+     * ClusterDeploymentStatus defines the observed state of ClusterDeployment
+     */
     @JsonProperty("provisionRef")
     public void setProvisionRef(LocalObjectReference provisionRef) {
         this.provisionRef = provisionRef;
     }
 
+    /**
+     * WebConsoleURL is the URL for the cluster's web console UI.
+     */
     @JsonProperty("webConsoleURL")
     public String getWebConsoleURL() {
         return webConsoleURL;
     }
 
+    /**
+     * WebConsoleURL is the URL for the cluster's web console UI.
+     */
     @JsonProperty("webConsoleURL")
     public void setWebConsoleURL(String webConsoleURL) {
         this.webConsoleURL = webConsoleURL;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeprovision.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeprovision.java
index 1598aeec250..bec17c38062 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeprovision.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeprovision.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterDeprovision is the Schema for the clusterdeprovisions API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class ClusterDeprovision implements Editable<ClusterDeprovisionBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterDeprovision";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterDeprovision(String apiVersion, String kind, ObjectMeta metadata, C
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterDeprovision is the Schema for the clusterdeprovisions API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterDeprovision is the Schema for the clusterdeprovisions API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ClusterDeprovision is the Schema for the clusterdeprovisions API
+     */
     @JsonProperty("spec")
     public ClusterDeprovisionSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ClusterDeprovision is the Schema for the clusterdeprovisions API
+     */
     @JsonProperty("spec")
     public void setSpec(ClusterDeprovisionSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ClusterDeprovision is the Schema for the clusterdeprovisions API
+     */
     @JsonProperty("status")
     public ClusterDeprovisionStatus getStatus() {
         return status;
     }
 
+    /**
+     * ClusterDeprovision is the Schema for the clusterdeprovisions API
+     */
     @JsonProperty("status")
     public void setStatus(ClusterDeprovisionStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeprovisionCondition.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeprovisionCondition.java
index 02669ea399c..7d70587c8c5 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeprovisionCondition.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeprovisionCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterDeprovisionCondition contains details for the current condition of a ClusterDeprovision
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public ClusterDeprovisionCondition(String lastProbeTime, String lastTransitionTi
         this.type = type;
     }
 
+    /**
+     * ClusterDeprovisionCondition contains details for the current condition of a ClusterDeprovision
+     */
     @JsonProperty("lastProbeTime")
     public String getLastProbeTime() {
         return lastProbeTime;
     }
 
+    /**
+     * ClusterDeprovisionCondition contains details for the current condition of a ClusterDeprovision
+     */
     @JsonProperty("lastProbeTime")
     public void setLastProbeTime(String lastProbeTime) {
         this.lastProbeTime = lastProbeTime;
     }
 
+    /**
+     * ClusterDeprovisionCondition contains details for the current condition of a ClusterDeprovision
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * ClusterDeprovisionCondition contains details for the current condition of a ClusterDeprovision
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Message is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Reason is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status is the status of the condition.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status is the status of the condition.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type is the type of the condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of the condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeprovisionList.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeprovisionList.java
index 2d2156f6b8b..529781ebb08 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeprovisionList.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeprovisionList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterDeprovisionList contains a list of ClusterDeprovision
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ClusterDeprovisionList implements Editable<ClusterDeprovisionListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.hive.v1.ClusterDeprovision>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.hive.v1.ClusterDeprovision> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterDeprovisionList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterDeprovisionList(String apiVersion, List<io.fabric8.openshift.api.m
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ClusterDeprovisionList contains a list of ClusterDeprovision
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.hive.v1.ClusterDeprovision> getItems() {
         return items;
     }
 
+    /**
+     * ClusterDeprovisionList contains a list of ClusterDeprovision
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.hive.v1.ClusterDeprovision> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterDeprovisionList contains a list of ClusterDeprovision
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterDeprovisionList contains a list of ClusterDeprovision
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeprovisionPlatform.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeprovisionPlatform.java
index 7f77c0a12c6..b36008be0c6 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeprovisionPlatform.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeprovisionPlatform.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterDeprovisionPlatform contains platform-specific configuration for the deprovision
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,71 +105,113 @@ public ClusterDeprovisionPlatform(AWSClusterDeprovision aws, AzureClusterDeprovi
         this.vsphere = vsphere;
     }
 
+    /**
+     * ClusterDeprovisionPlatform contains platform-specific configuration for the deprovision
+     */
     @JsonProperty("aws")
     public AWSClusterDeprovision getAws() {
         return aws;
     }
 
+    /**
+     * ClusterDeprovisionPlatform contains platform-specific configuration for the deprovision
+     */
     @JsonProperty("aws")
     public void setAws(AWSClusterDeprovision aws) {
         this.aws = aws;
     }
 
+    /**
+     * ClusterDeprovisionPlatform contains platform-specific configuration for the deprovision
+     */
     @JsonProperty("azure")
     public AzureClusterDeprovision getAzure() {
         return azure;
     }
 
+    /**
+     * ClusterDeprovisionPlatform contains platform-specific configuration for the deprovision
+     */
     @JsonProperty("azure")
     public void setAzure(AzureClusterDeprovision azure) {
         this.azure = azure;
     }
 
+    /**
+     * ClusterDeprovisionPlatform contains platform-specific configuration for the deprovision
+     */
     @JsonProperty("gcp")
     public GCPClusterDeprovision getGcp() {
         return gcp;
     }
 
+    /**
+     * ClusterDeprovisionPlatform contains platform-specific configuration for the deprovision
+     */
     @JsonProperty("gcp")
     public void setGcp(GCPClusterDeprovision gcp) {
         this.gcp = gcp;
     }
 
+    /**
+     * ClusterDeprovisionPlatform contains platform-specific configuration for the deprovision
+     */
     @JsonProperty("ibmcloud")
     public IBMClusterDeprovision getIbmcloud() {
         return ibmcloud;
     }
 
+    /**
+     * ClusterDeprovisionPlatform contains platform-specific configuration for the deprovision
+     */
     @JsonProperty("ibmcloud")
     public void setIbmcloud(IBMClusterDeprovision ibmcloud) {
         this.ibmcloud = ibmcloud;
     }
 
+    /**
+     * ClusterDeprovisionPlatform contains platform-specific configuration for the deprovision
+     */
     @JsonProperty("openstack")
     public OpenStackClusterDeprovision getOpenstack() {
         return openstack;
     }
 
+    /**
+     * ClusterDeprovisionPlatform contains platform-specific configuration for the deprovision
+     */
     @JsonProperty("openstack")
     public void setOpenstack(OpenStackClusterDeprovision openstack) {
         this.openstack = openstack;
     }
 
+    /**
+     * ClusterDeprovisionPlatform contains platform-specific configuration for the deprovision
+     */
     @JsonProperty("ovirt")
     public OvirtClusterDeprovision getOvirt() {
         return ovirt;
     }
 
+    /**
+     * ClusterDeprovisionPlatform contains platform-specific configuration for the deprovision
+     */
     @JsonProperty("ovirt")
     public void setOvirt(OvirtClusterDeprovision ovirt) {
         this.ovirt = ovirt;
     }
 
+    /**
+     * ClusterDeprovisionPlatform contains platform-specific configuration for the deprovision
+     */
     @JsonProperty("vsphere")
     public VSphereClusterDeprovision getVsphere() {
         return vsphere;
     }
 
+    /**
+     * ClusterDeprovisionPlatform contains platform-specific configuration for the deprovision
+     */
     @JsonProperty("vsphere")
     public void setVsphere(VSphereClusterDeprovision vsphere) {
         this.vsphere = vsphere;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeprovisionSpec.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeprovisionSpec.java
index a4f8740803b..78f57182ef2 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeprovisionSpec.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeprovisionSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterDeprovisionSpec defines the desired state of ClusterDeprovision
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public ClusterDeprovisionSpec(String baseDomain, String clusterID, String cluste
         this.platform = platform;
     }
 
+    /**
+     * BaseDomain is the DNS base domain.
+     */
     @JsonProperty("baseDomain")
     public String getBaseDomain() {
         return baseDomain;
     }
 
+    /**
+     * BaseDomain is the DNS base domain.
+     */
     @JsonProperty("baseDomain")
     public void setBaseDomain(String baseDomain) {
         this.baseDomain = baseDomain;
     }
 
+    /**
+     * ClusterID is a globally unique identifier for the cluster to deprovision. It will be used if specified.
+     */
     @JsonProperty("clusterID")
     public String getClusterID() {
         return clusterID;
     }
 
+    /**
+     * ClusterID is a globally unique identifier for the cluster to deprovision. It will be used if specified.
+     */
     @JsonProperty("clusterID")
     public void setClusterID(String clusterID) {
         this.clusterID = clusterID;
     }
 
+    /**
+     * ClusterName is the friendly name of the cluster. It is used for subdomains, some resource tagging, and other instances where a friendly name for the cluster is useful.
+     */
     @JsonProperty("clusterName")
     public String getClusterName() {
         return clusterName;
     }
 
+    /**
+     * ClusterName is the friendly name of the cluster. It is used for subdomains, some resource tagging, and other instances where a friendly name for the cluster is useful.
+     */
     @JsonProperty("clusterName")
     public void setClusterName(String clusterName) {
         this.clusterName = clusterName;
     }
 
+    /**
+     * InfraID is the identifier generated during installation for a cluster. It is used for tagging/naming resources in cloud providers.
+     */
     @JsonProperty("infraID")
     public String getInfraID() {
         return infraID;
     }
 
+    /**
+     * InfraID is the identifier generated during installation for a cluster. It is used for tagging/naming resources in cloud providers.
+     */
     @JsonProperty("infraID")
     public void setInfraID(String infraID) {
         this.infraID = infraID;
     }
 
+    /**
+     * ClusterDeprovisionSpec defines the desired state of ClusterDeprovision
+     */
     @JsonProperty("platform")
     public ClusterDeprovisionPlatform getPlatform() {
         return platform;
     }
 
+    /**
+     * ClusterDeprovisionSpec defines the desired state of ClusterDeprovision
+     */
     @JsonProperty("platform")
     public void setPlatform(ClusterDeprovisionPlatform platform) {
         this.platform = platform;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeprovisionStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeprovisionStatus.java
index f988a5fa144..12f71c2479a 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeprovisionStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterDeprovisionStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterDeprovisionStatus defines the observed state of ClusterDeprovision
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public ClusterDeprovisionStatus(Boolean completed, List<ClusterDeprovisionCondit
         this.conditions = conditions;
     }
 
+    /**
+     * Completed is true when the uninstall has completed successfully
+     */
     @JsonProperty("completed")
     public Boolean getCompleted() {
         return completed;
     }
 
+    /**
+     * Completed is true when the uninstall has completed successfully
+     */
     @JsonProperty("completed")
     public void setCompleted(Boolean completed) {
         this.completed = completed;
     }
 
+    /**
+     * Conditions includes more detailed status for the cluster deprovision
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ClusterDeprovisionCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions includes more detailed status for the cluster deprovision
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ClusterDeprovisionCondition> conditions) {
         this.conditions = conditions;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterImageSet.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterImageSet.java
index 49b1e56adea..b6e23acbbd0 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterImageSet.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterImageSet.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterImageSet is the Schema for the clusterimagesets API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ClusterImageSet implements Editable<ClusterImageSetBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterImageSet";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public ClusterImageSet(String apiVersion, String kind, ObjectMeta metadata, Clus
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterImageSet is the Schema for the clusterimagesets API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterImageSet is the Schema for the clusterimagesets API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ClusterImageSet is the Schema for the clusterimagesets API
+     */
     @JsonProperty("spec")
     public ClusterImageSetSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ClusterImageSet is the Schema for the clusterimagesets API
+     */
     @JsonProperty("spec")
     public void setSpec(ClusterImageSetSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ClusterImageSet is the Schema for the clusterimagesets API
+     */
     @JsonProperty("status")
     public ClusterImageSetStatus getStatus() {
         return status;
     }
 
+    /**
+     * ClusterImageSet is the Schema for the clusterimagesets API
+     */
     @JsonProperty("status")
     public void setStatus(ClusterImageSetStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterImageSetList.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterImageSetList.java
index 1b6ad69a999..5f4599ab7d0 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterImageSetList.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterImageSetList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterImageSetList contains a list of ClusterImageSet
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ClusterImageSetList implements Editable<ClusterImageSetListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.hive.v1.ClusterImageSet>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.hive.v1.ClusterImageSet> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterImageSetList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterImageSetList(String apiVersion, List<io.fabric8.openshift.api.mode
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ClusterImageSetList contains a list of ClusterImageSet
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.hive.v1.ClusterImageSet> getItems() {
         return items;
     }
 
+    /**
+     * ClusterImageSetList contains a list of ClusterImageSet
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.hive.v1.ClusterImageSet> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterImageSetList contains a list of ClusterImageSet
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterImageSetList contains a list of ClusterImageSet
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterImageSetReference.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterImageSetReference.java
index df5ba524af9..d9b839971dc 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterImageSetReference.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterImageSetReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterImageSetReference is a reference to a ClusterImageSet
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ClusterImageSetReference(String name) {
         this.name = name;
     }
 
+    /**
+     * Name is the name of the ClusterImageSet that this refers to
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the ClusterImageSet that this refers to
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterImageSetSpec.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterImageSetSpec.java
index 43008558e75..2ea5389ec16 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterImageSetSpec.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterImageSetSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterImageSetSpec defines the desired state of ClusterImageSet
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ClusterImageSetSpec(String releaseImage) {
         this.releaseImage = releaseImage;
     }
 
+    /**
+     * ReleaseImage is the image that contains the payload to use when installing a cluster.
+     */
     @JsonProperty("releaseImage")
     public String getReleaseImage() {
         return releaseImage;
     }
 
+    /**
+     * ReleaseImage is the image that contains the payload to use when installing a cluster.
+     */
     @JsonProperty("releaseImage")
     public void setReleaseImage(String releaseImage) {
         this.releaseImage = releaseImage;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterImageSetStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterImageSetStatus.java
index 23241b746db..1c4934b3556 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterImageSetStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterImageSetStatus.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterImageSetStatus defines the observed state of ClusterImageSet
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterIngress.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterIngress.java
index 3ea946324a8..5d3473dfa66 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterIngress.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterIngress.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterIngress contains the configurable pieces for any ClusterIngress objects that should exist on the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -99,61 +102,97 @@ public ClusterIngress(String domain, ConfigMapNameReference httpErrorCodePages,
         this.servingCertificate = servingCertificate;
     }
 
+    /**
+     * Domain (sometimes referred to as shard) is the full DNS suffix that the resulting IngressController object will service (eg abcd.mycluster.mydomain.com).
+     */
     @JsonProperty("domain")
     public String getDomain() {
         return domain;
     }
 
+    /**
+     * Domain (sometimes referred to as shard) is the full DNS suffix that the resulting IngressController object will service (eg abcd.mycluster.mydomain.com).
+     */
     @JsonProperty("domain")
     public void setDomain(String domain) {
         this.domain = domain;
     }
 
+    /**
+     * ClusterIngress contains the configurable pieces for any ClusterIngress objects that should exist on the cluster.
+     */
     @JsonProperty("httpErrorCodePages")
     public ConfigMapNameReference getHttpErrorCodePages() {
         return httpErrorCodePages;
     }
 
+    /**
+     * ClusterIngress contains the configurable pieces for any ClusterIngress objects that should exist on the cluster.
+     */
     @JsonProperty("httpErrorCodePages")
     public void setHttpErrorCodePages(ConfigMapNameReference httpErrorCodePages) {
         this.httpErrorCodePages = httpErrorCodePages;
     }
 
+    /**
+     * Name of the ClusterIngress object to create.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the ClusterIngress object to create.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * ClusterIngress contains the configurable pieces for any ClusterIngress objects that should exist on the cluster.
+     */
     @JsonProperty("namespaceSelector")
     public LabelSelector getNamespaceSelector() {
         return namespaceSelector;
     }
 
+    /**
+     * ClusterIngress contains the configurable pieces for any ClusterIngress objects that should exist on the cluster.
+     */
     @JsonProperty("namespaceSelector")
     public void setNamespaceSelector(LabelSelector namespaceSelector) {
         this.namespaceSelector = namespaceSelector;
     }
 
+    /**
+     * ClusterIngress contains the configurable pieces for any ClusterIngress objects that should exist on the cluster.
+     */
     @JsonProperty("routeSelector")
     public LabelSelector getRouteSelector() {
         return routeSelector;
     }
 
+    /**
+     * ClusterIngress contains the configurable pieces for any ClusterIngress objects that should exist on the cluster.
+     */
     @JsonProperty("routeSelector")
     public void setRouteSelector(LabelSelector routeSelector) {
         this.routeSelector = routeSelector;
     }
 
+    /**
+     * ServingCertificate references a CertificateBundle in the ClusterDeployment.Spec that should be used for this Ingress
+     */
     @JsonProperty("servingCertificate")
     public String getServingCertificate() {
         return servingCertificate;
     }
 
+    /**
+     * ServingCertificate references a CertificateBundle in the ClusterDeployment.Spec that should be used for this Ingress
+     */
     @JsonProperty("servingCertificate")
     public void setServingCertificate(String servingCertificate) {
         this.servingCertificate = servingCertificate;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterInstallCondition.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterInstallCondition.java
index af2c4432c9c..d9073ccfcf4 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterInstallCondition.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterInstallCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterInstallCondition contains details for the current condition of a cluster install.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public ClusterInstallCondition(String lastProbeTime, String lastTransitionTime,
         this.type = type;
     }
 
+    /**
+     * ClusterInstallCondition contains details for the current condition of a cluster install.
+     */
     @JsonProperty("lastProbeTime")
     public String getLastProbeTime() {
         return lastProbeTime;
     }
 
+    /**
+     * ClusterInstallCondition contains details for the current condition of a cluster install.
+     */
     @JsonProperty("lastProbeTime")
     public void setLastProbeTime(String lastProbeTime) {
         this.lastProbeTime = lastProbeTime;
     }
 
+    /**
+     * ClusterInstallCondition contains details for the current condition of a cluster install.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * ClusterInstallCondition contains details for the current condition of a cluster install.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Message is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Reason is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status is the status of the condition.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status is the status of the condition.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type is the type of the condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of the condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterInstallLocalReference.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterInstallLocalReference.java
index 157076c3bd4..86c47fca2d2 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterInstallLocalReference.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterInstallLocalReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterInstallLocalReference provides reference to an object that implements the hivecontract ClusterInstall. The namespace of the object is same as the ClusterDeployment.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ClusterInstallLocalReference(String group, String kind, String name, Stri
         this.version = version;
     }
 
+    /**
+     * ClusterInstallLocalReference provides reference to an object that implements the hivecontract ClusterInstall. The namespace of the object is same as the ClusterDeployment.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * ClusterInstallLocalReference provides reference to an object that implements the hivecontract ClusterInstall. The namespace of the object is same as the ClusterDeployment.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * ClusterInstallLocalReference provides reference to an object that implements the hivecontract ClusterInstall. The namespace of the object is same as the ClusterDeployment.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * ClusterInstallLocalReference provides reference to an object that implements the hivecontract ClusterInstall. The namespace of the object is same as the ClusterDeployment.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterInstallLocalReference provides reference to an object that implements the hivecontract ClusterInstall. The namespace of the object is same as the ClusterDeployment.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * ClusterInstallLocalReference provides reference to an object that implements the hivecontract ClusterInstall. The namespace of the object is same as the ClusterDeployment.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * ClusterInstallLocalReference provides reference to an object that implements the hivecontract ClusterInstall. The namespace of the object is same as the ClusterDeployment.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * ClusterInstallLocalReference provides reference to an object that implements the hivecontract ClusterInstall. The namespace of the object is same as the ClusterDeployment.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterMetadata.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterMetadata.java
index 3953893b581..a6386222474 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterMetadata.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterMetadata.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterMetadata contains metadata information about the installed cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public ClusterMetadata(LocalObjectReference adminKubeconfigSecretRef, LocalObjec
         this.platform = platform;
     }
 
+    /**
+     * ClusterMetadata contains metadata information about the installed cluster.
+     */
     @JsonProperty("adminKubeconfigSecretRef")
     public LocalObjectReference getAdminKubeconfigSecretRef() {
         return adminKubeconfigSecretRef;
     }
 
+    /**
+     * ClusterMetadata contains metadata information about the installed cluster.
+     */
     @JsonProperty("adminKubeconfigSecretRef")
     public void setAdminKubeconfigSecretRef(LocalObjectReference adminKubeconfigSecretRef) {
         this.adminKubeconfigSecretRef = adminKubeconfigSecretRef;
     }
 
+    /**
+     * ClusterMetadata contains metadata information about the installed cluster.
+     */
     @JsonProperty("adminPasswordSecretRef")
     public LocalObjectReference getAdminPasswordSecretRef() {
         return adminPasswordSecretRef;
     }
 
+    /**
+     * ClusterMetadata contains metadata information about the installed cluster.
+     */
     @JsonProperty("adminPasswordSecretRef")
     public void setAdminPasswordSecretRef(LocalObjectReference adminPasswordSecretRef) {
         this.adminPasswordSecretRef = adminPasswordSecretRef;
     }
 
+    /**
+     * ClusterID is a globally unique identifier for this cluster generated during installation. Used for reporting metrics among other places.
+     */
     @JsonProperty("clusterID")
     public String getClusterID() {
         return clusterID;
     }
 
+    /**
+     * ClusterID is a globally unique identifier for this cluster generated during installation. Used for reporting metrics among other places.
+     */
     @JsonProperty("clusterID")
     public void setClusterID(String clusterID) {
         this.clusterID = clusterID;
     }
 
+    /**
+     * InfraID is an identifier for this cluster generated during installation and used for tagging/naming resources in cloud providers.
+     */
     @JsonProperty("infraID")
     public String getInfraID() {
         return infraID;
     }
 
+    /**
+     * InfraID is an identifier for this cluster generated during installation and used for tagging/naming resources in cloud providers.
+     */
     @JsonProperty("infraID")
     public void setInfraID(String infraID) {
         this.infraID = infraID;
     }
 
+    /**
+     * ClusterMetadata contains metadata information about the installed cluster.
+     */
     @JsonProperty("platform")
     public ClusterPlatformMetadata getPlatform() {
         return platform;
     }
 
+    /**
+     * ClusterMetadata contains metadata information about the installed cluster.
+     */
     @JsonProperty("platform")
     public void setPlatform(ClusterPlatformMetadata platform) {
         this.platform = platform;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterOperatorState.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterOperatorState.java
index 63f6efc6756..06b41afece6 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterOperatorState.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterOperatorState.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterOperatorState summarizes the status of a single cluster operator
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,22 +89,34 @@ public ClusterOperatorState(List<ClusterOperatorStatusCondition> conditions, Str
         this.name = name;
     }
 
+    /**
+     * Conditions is the set of conditions in the status of the cluster operator on the target cluster
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ClusterOperatorStatusCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions is the set of conditions in the status of the cluster operator on the target cluster
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ClusterOperatorStatusCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Name is the name of the cluster operator
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the cluster operator
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterPool.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterPool.java
index 5faf17fcfc0..7bf53facedc 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterPool.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterPool.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterPool represents a pool of clusters that should be kept ready to be given out to users. Clusters are removed from the pool once claimed and then automatically replaced with a new one.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class ClusterPool implements Editable<ClusterPoolBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterPool";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterPool(String apiVersion, String kind, ObjectMeta metadata, ClusterP
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterPool represents a pool of clusters that should be kept ready to be given out to users. Clusters are removed from the pool once claimed and then automatically replaced with a new one.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterPool represents a pool of clusters that should be kept ready to be given out to users. Clusters are removed from the pool once claimed and then automatically replaced with a new one.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ClusterPool represents a pool of clusters that should be kept ready to be given out to users. Clusters are removed from the pool once claimed and then automatically replaced with a new one.
+     */
     @JsonProperty("spec")
     public ClusterPoolSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ClusterPool represents a pool of clusters that should be kept ready to be given out to users. Clusters are removed from the pool once claimed and then automatically replaced with a new one.
+     */
     @JsonProperty("spec")
     public void setSpec(ClusterPoolSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ClusterPool represents a pool of clusters that should be kept ready to be given out to users. Clusters are removed from the pool once claimed and then automatically replaced with a new one.
+     */
     @JsonProperty("status")
     public ClusterPoolStatus getStatus() {
         return status;
     }
 
+    /**
+     * ClusterPool represents a pool of clusters that should be kept ready to be given out to users. Clusters are removed from the pool once claimed and then automatically replaced with a new one.
+     */
     @JsonProperty("status")
     public void setStatus(ClusterPoolStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterPoolClaimLifetime.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterPoolClaimLifetime.java
index 9f8ad4d8776..0da0b1e0104 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterPoolClaimLifetime.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterPoolClaimLifetime.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterPoolClaimLifetime defines the lifetimes for claims for the cluster pool.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ClusterPoolClaimLifetime(String _default, String maximum) {
         this.maximum = maximum;
     }
 
+    /**
+     * ClusterPoolClaimLifetime defines the lifetimes for claims for the cluster pool.
+     */
     @JsonProperty("default")
     public String getDefault() {
         return _default;
     }
 
+    /**
+     * ClusterPoolClaimLifetime defines the lifetimes for claims for the cluster pool.
+     */
     @JsonProperty("default")
     public void setDefault(String _default) {
         this._default = _default;
     }
 
+    /**
+     * ClusterPoolClaimLifetime defines the lifetimes for claims for the cluster pool.
+     */
     @JsonProperty("maximum")
     public String getMaximum() {
         return maximum;
     }
 
+    /**
+     * ClusterPoolClaimLifetime defines the lifetimes for claims for the cluster pool.
+     */
     @JsonProperty("maximum")
     public void setMaximum(String maximum) {
         this.maximum = maximum;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterPoolCondition.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterPoolCondition.java
index ab228904f85..1b3aac359bc 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterPoolCondition.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterPoolCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterPoolCondition contains details for the current condition of a cluster pool
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public ClusterPoolCondition(String lastProbeTime, String lastTransitionTime, Str
         this.type = type;
     }
 
+    /**
+     * ClusterPoolCondition contains details for the current condition of a cluster pool
+     */
     @JsonProperty("lastProbeTime")
     public String getLastProbeTime() {
         return lastProbeTime;
     }
 
+    /**
+     * ClusterPoolCondition contains details for the current condition of a cluster pool
+     */
     @JsonProperty("lastProbeTime")
     public void setLastProbeTime(String lastProbeTime) {
         this.lastProbeTime = lastProbeTime;
     }
 
+    /**
+     * ClusterPoolCondition contains details for the current condition of a cluster pool
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * ClusterPoolCondition contains details for the current condition of a cluster pool
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Message is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Reason is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status is the status of the condition.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status is the status of the condition.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type is the type of the condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of the condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterPoolList.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterPoolList.java
index 1e35918a7d8..cfb7cec58d0 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterPoolList.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterPoolList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterPoolList contains a list of ClusterPools
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ClusterPoolList implements Editable<ClusterPoolListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.hive.v1.ClusterPool>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.hive.v1.ClusterPool> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterPoolList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterPoolList(String apiVersion, List<io.fabric8.openshift.api.model.hi
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ClusterPoolList contains a list of ClusterPools
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.hive.v1.ClusterPool> getItems() {
         return items;
     }
 
+    /**
+     * ClusterPoolList contains a list of ClusterPools
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.hive.v1.ClusterPool> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterPoolList contains a list of ClusterPools
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterPoolList contains a list of ClusterPools
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterPoolReference.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterPoolReference.java
index 90580fcd7f5..af27ab365ac 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterPoolReference.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterPoolReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterPoolReference is a reference to a ClusterPool
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public ClusterPoolReference(String claimName, String claimedTimestamp, LocalObje
         this.poolName = poolName;
     }
 
+    /**
+     * ClaimName is the name of the ClusterClaim that claimed the cluster from the pool.
+     */
     @JsonProperty("claimName")
     public String getClaimName() {
         return claimName;
     }
 
+    /**
+     * ClaimName is the name of the ClusterClaim that claimed the cluster from the pool.
+     */
     @JsonProperty("claimName")
     public void setClaimName(String claimName) {
         this.claimName = claimName;
     }
 
+    /**
+     * ClusterPoolReference is a reference to a ClusterPool
+     */
     @JsonProperty("claimedTimestamp")
     public String getClaimedTimestamp() {
         return claimedTimestamp;
     }
 
+    /**
+     * ClusterPoolReference is a reference to a ClusterPool
+     */
     @JsonProperty("claimedTimestamp")
     public void setClaimedTimestamp(String claimedTimestamp) {
         this.claimedTimestamp = claimedTimestamp;
     }
 
+    /**
+     * ClusterPoolReference is a reference to a ClusterPool
+     */
     @JsonProperty("clusterDeploymentCustomization")
     public LocalObjectReference getClusterDeploymentCustomization() {
         return clusterDeploymentCustomization;
     }
 
+    /**
+     * ClusterPoolReference is a reference to a ClusterPool
+     */
     @JsonProperty("clusterDeploymentCustomization")
     public void setClusterDeploymentCustomization(LocalObjectReference clusterDeploymentCustomization) {
         this.clusterDeploymentCustomization = clusterDeploymentCustomization;
     }
 
+    /**
+     * Namespace is the namespace where the ClusterPool resides.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace where the ClusterPool resides.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * PoolName is the name of the ClusterPool for which the cluster was created.
+     */
     @JsonProperty("poolName")
     public String getPoolName() {
         return poolName;
     }
 
+    /**
+     * PoolName is the name of the ClusterPool for which the cluster was created.
+     */
     @JsonProperty("poolName")
     public void setPoolName(String poolName) {
         this.poolName = poolName;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterPoolSpec.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterPoolSpec.java
index e676c7f4f8e..427393ff052 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterPoolSpec.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterPoolSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterPoolSpec defines the desired state of the ClusterPool.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -152,185 +155,293 @@ public ClusterPoolSpec(Map<String, String> annotations, String baseDomain, Clust
         this.skipMachinePools = skipMachinePools;
     }
 
+    /**
+     * Annotations to be applied to new ClusterDeployments created for the pool. ClusterDeployments that have already been claimed will not be affected when this value is modified.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations to be applied to new ClusterDeployments created for the pool. ClusterDeployments that have already been claimed will not be affected when this value is modified.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * BaseDomain is the base domain to use for all clusters created in this pool.
+     */
     @JsonProperty("baseDomain")
     public String getBaseDomain() {
         return baseDomain;
     }
 
+    /**
+     * BaseDomain is the base domain to use for all clusters created in this pool.
+     */
     @JsonProperty("baseDomain")
     public void setBaseDomain(String baseDomain) {
         this.baseDomain = baseDomain;
     }
 
+    /**
+     * ClusterPoolSpec defines the desired state of the ClusterPool.
+     */
     @JsonProperty("claimLifetime")
     public ClusterPoolClaimLifetime getClaimLifetime() {
         return claimLifetime;
     }
 
+    /**
+     * ClusterPoolSpec defines the desired state of the ClusterPool.
+     */
     @JsonProperty("claimLifetime")
     public void setClaimLifetime(ClusterPoolClaimLifetime claimLifetime) {
         this.claimLifetime = claimLifetime;
     }
 
+    /**
+     * ClusterPoolSpec defines the desired state of the ClusterPool.
+     */
     @JsonProperty("hibernateAfter")
     public String getHibernateAfter() {
         return hibernateAfter;
     }
 
+    /**
+     * ClusterPoolSpec defines the desired state of the ClusterPool.
+     */
     @JsonProperty("hibernateAfter")
     public void setHibernateAfter(String hibernateAfter) {
         this.hibernateAfter = hibernateAfter;
     }
 
+    /**
+     * ClusterPoolSpec defines the desired state of the ClusterPool.
+     */
     @JsonProperty("hibernationConfig")
     public HibernationConfig getHibernationConfig() {
         return hibernationConfig;
     }
 
+    /**
+     * ClusterPoolSpec defines the desired state of the ClusterPool.
+     */
     @JsonProperty("hibernationConfig")
     public void setHibernationConfig(HibernationConfig hibernationConfig) {
         this.hibernationConfig = hibernationConfig;
     }
 
+    /**
+     * ClusterPoolSpec defines the desired state of the ClusterPool.
+     */
     @JsonProperty("imageSetRef")
     public ClusterImageSetReference getImageSetRef() {
         return imageSetRef;
     }
 
+    /**
+     * ClusterPoolSpec defines the desired state of the ClusterPool.
+     */
     @JsonProperty("imageSetRef")
     public void setImageSetRef(ClusterImageSetReference imageSetRef) {
         this.imageSetRef = imageSetRef;
     }
 
+    /**
+     * InstallAttemptsLimit is the maximum number of times Hive will attempt to install the cluster.
+     */
     @JsonProperty("installAttemptsLimit")
     public Integer getInstallAttemptsLimit() {
         return installAttemptsLimit;
     }
 
+    /**
+     * InstallAttemptsLimit is the maximum number of times Hive will attempt to install the cluster.
+     */
     @JsonProperty("installAttemptsLimit")
     public void setInstallAttemptsLimit(Integer installAttemptsLimit) {
         this.installAttemptsLimit = installAttemptsLimit;
     }
 
+    /**
+     * ClusterPoolSpec defines the desired state of the ClusterPool.
+     */
     @JsonProperty("installConfigSecretTemplateRef")
     public LocalObjectReference getInstallConfigSecretTemplateRef() {
         return installConfigSecretTemplateRef;
     }
 
+    /**
+     * ClusterPoolSpec defines the desired state of the ClusterPool.
+     */
     @JsonProperty("installConfigSecretTemplateRef")
     public void setInstallConfigSecretTemplateRef(LocalObjectReference installConfigSecretTemplateRef) {
         this.installConfigSecretTemplateRef = installConfigSecretTemplateRef;
     }
 
+    /**
+     * InstallerEnv are extra environment variables to pass through to the installer. This may be used to enable additional features of the installer.
+     */
     @JsonProperty("installerEnv")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvVar> getInstallerEnv() {
         return installerEnv;
     }
 
+    /**
+     * InstallerEnv are extra environment variables to pass through to the installer. This may be used to enable additional features of the installer.
+     */
     @JsonProperty("installerEnv")
     public void setInstallerEnv(List<EnvVar> installerEnv) {
         this.installerEnv = installerEnv;
     }
 
+    /**
+     * Inventory maintains a list of entries consumed by the ClusterPool to customize the default ClusterDeployment.
+     */
     @JsonProperty("inventory")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<InventoryEntry> getInventory() {
         return inventory;
     }
 
+    /**
+     * Inventory maintains a list of entries consumed by the ClusterPool to customize the default ClusterDeployment.
+     */
     @JsonProperty("inventory")
     public void setInventory(List<InventoryEntry> inventory) {
         this.inventory = inventory;
     }
 
+    /**
+     * Labels to be applied to new ClusterDeployments created for the pool. ClusterDeployments that have already been claimed will not be affected when this value is modified.
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabels() {
         return labels;
     }
 
+    /**
+     * Labels to be applied to new ClusterDeployments created for the pool. ClusterDeployments that have already been claimed will not be affected when this value is modified.
+     */
     @JsonProperty("labels")
     public void setLabels(Map<String, String> labels) {
         this.labels = labels;
     }
 
+    /**
+     * MaxConcurrent is the maximum number of clusters that will be provisioned or deprovisioned at an time. This includes the claimed clusters being deprovisioned. By default there is no limit.
+     */
     @JsonProperty("maxConcurrent")
     public Integer getMaxConcurrent() {
         return maxConcurrent;
     }
 
+    /**
+     * MaxConcurrent is the maximum number of clusters that will be provisioned or deprovisioned at an time. This includes the claimed clusters being deprovisioned. By default there is no limit.
+     */
     @JsonProperty("maxConcurrent")
     public void setMaxConcurrent(Integer maxConcurrent) {
         this.maxConcurrent = maxConcurrent;
     }
 
+    /**
+     * MaxSize is the maximum number of clusters that will be provisioned including clusters that have been claimed and ones waiting to be used. By default there is no limit.
+     */
     @JsonProperty("maxSize")
     public Integer getMaxSize() {
         return maxSize;
     }
 
+    /**
+     * MaxSize is the maximum number of clusters that will be provisioned including clusters that have been claimed and ones waiting to be used. By default there is no limit.
+     */
     @JsonProperty("maxSize")
     public void setMaxSize(Integer maxSize) {
         this.maxSize = maxSize;
     }
 
+    /**
+     * ClusterPoolSpec defines the desired state of the ClusterPool.
+     */
     @JsonProperty("platform")
     public Platform getPlatform() {
         return platform;
     }
 
+    /**
+     * ClusterPoolSpec defines the desired state of the ClusterPool.
+     */
     @JsonProperty("platform")
     public void setPlatform(Platform platform) {
         this.platform = platform;
     }
 
+    /**
+     * ClusterPoolSpec defines the desired state of the ClusterPool.
+     */
     @JsonProperty("pullSecretRef")
     public LocalObjectReference getPullSecretRef() {
         return pullSecretRef;
     }
 
+    /**
+     * ClusterPoolSpec defines the desired state of the ClusterPool.
+     */
     @JsonProperty("pullSecretRef")
     public void setPullSecretRef(LocalObjectReference pullSecretRef) {
         this.pullSecretRef = pullSecretRef;
     }
 
+    /**
+     * RunningCount is the number of clusters we should keep running. The remainder will be kept hibernated until claimed. By default no clusters will be kept running (all will be hibernated).
+     */
     @JsonProperty("runningCount")
     public Integer getRunningCount() {
         return runningCount;
     }
 
+    /**
+     * RunningCount is the number of clusters we should keep running. The remainder will be kept hibernated until claimed. By default no clusters will be kept running (all will be hibernated).
+     */
     @JsonProperty("runningCount")
     public void setRunningCount(Integer runningCount) {
         this.runningCount = runningCount;
     }
 
+    /**
+     * Size is the default number of clusters that we should keep provisioned and waiting for use.
+     */
     @JsonProperty("size")
     public Integer getSize() {
         return size;
     }
 
+    /**
+     * Size is the default number of clusters that we should keep provisioned and waiting for use.
+     */
     @JsonProperty("size")
     public void setSize(Integer size) {
         this.size = size;
     }
 
+    /**
+     * SkipMachinePools allows creating clusterpools where the machinepools are not managed by hive after cluster creation
+     */
     @JsonProperty("skipMachinePools")
     public Boolean getSkipMachinePools() {
         return skipMachinePools;
     }
 
+    /**
+     * SkipMachinePools allows creating clusterpools where the machinepools are not managed by hive after cluster creation
+     */
     @JsonProperty("skipMachinePools")
     public void setSkipMachinePools(Boolean skipMachinePools) {
         this.skipMachinePools = skipMachinePools;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterPoolStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterPoolStatus.java
index 7878aca897f..e0f52579362 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterPoolStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterPoolStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterPoolStatus defines the observed state of ClusterPool
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public ClusterPoolStatus(List<ClusterPoolCondition> conditions, Integer ready, I
         this.standby = standby;
     }
 
+    /**
+     * Conditions includes more detailed status for the cluster pool
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ClusterPoolCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions includes more detailed status for the cluster pool
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ClusterPoolCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Ready is the number of unclaimed clusters that are installed and are running and ready to be claimed.
+     */
     @JsonProperty("ready")
     public Integer getReady() {
         return ready;
     }
 
+    /**
+     * Ready is the number of unclaimed clusters that are installed and are running and ready to be claimed.
+     */
     @JsonProperty("ready")
     public void setReady(Integer ready) {
         this.ready = ready;
     }
 
+    /**
+     * Size is the number of unclaimed clusters that have been created for the pool.
+     */
     @JsonProperty("size")
     public Integer getSize() {
         return size;
     }
 
+    /**
+     * Size is the number of unclaimed clusters that have been created for the pool.
+     */
     @JsonProperty("size")
     public void setSize(Integer size) {
         this.size = size;
     }
 
+    /**
+     * Standby is the number of unclaimed clusters that are installed, but not running.
+     */
     @JsonProperty("standby")
     public Integer getStandby() {
         return standby;
     }
 
+    /**
+     * Standby is the number of unclaimed clusters that are installed, but not running.
+     */
     @JsonProperty("standby")
     public void setStandby(Integer standby) {
         this.standby = standby;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterProvision.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterProvision.java
index e360352a71b..1777aa63e15 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterProvision.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterProvision.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterProvision is the Schema for the clusterprovisions API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class ClusterProvision implements Editable<ClusterProvisionBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterProvision";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterProvision(String apiVersion, String kind, ObjectMeta metadata, Clu
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterProvision is the Schema for the clusterprovisions API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterProvision is the Schema for the clusterprovisions API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ClusterProvision is the Schema for the clusterprovisions API
+     */
     @JsonProperty("spec")
     public ClusterProvisionSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ClusterProvision is the Schema for the clusterprovisions API
+     */
     @JsonProperty("spec")
     public void setSpec(ClusterProvisionSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ClusterProvision is the Schema for the clusterprovisions API
+     */
     @JsonProperty("status")
     public ClusterProvisionStatus getStatus() {
         return status;
     }
 
+    /**
+     * ClusterProvision is the Schema for the clusterprovisions API
+     */
     @JsonProperty("status")
     public void setStatus(ClusterProvisionStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterProvisionCondition.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterProvisionCondition.java
index cea07cdc9f8..774c4bdc1c9 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterProvisionCondition.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterProvisionCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterProvisionCondition contains details for the current condition of a cluster provision
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public ClusterProvisionCondition(String lastProbeTime, String lastTransitionTime
         this.type = type;
     }
 
+    /**
+     * ClusterProvisionCondition contains details for the current condition of a cluster provision
+     */
     @JsonProperty("lastProbeTime")
     public String getLastProbeTime() {
         return lastProbeTime;
     }
 
+    /**
+     * ClusterProvisionCondition contains details for the current condition of a cluster provision
+     */
     @JsonProperty("lastProbeTime")
     public void setLastProbeTime(String lastProbeTime) {
         this.lastProbeTime = lastProbeTime;
     }
 
+    /**
+     * ClusterProvisionCondition contains details for the current condition of a cluster provision
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * ClusterProvisionCondition contains details for the current condition of a cluster provision
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Message is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Reason is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status is the status of the condition.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status is the status of the condition.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type is the type of the condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of the condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterProvisionList.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterProvisionList.java
index 8829f2e2e0a..3c1be0d9fe7 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterProvisionList.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterProvisionList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterProvisionList contains a list of ClusterProvision
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ClusterProvisionList implements Editable<ClusterProvisionListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.hive.v1.ClusterProvision>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.hive.v1.ClusterProvision> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterProvisionList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterProvisionList(String apiVersion, List<io.fabric8.openshift.api.mod
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ClusterProvisionList contains a list of ClusterProvision
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.hive.v1.ClusterProvision> getItems() {
         return items;
     }
 
+    /**
+     * ClusterProvisionList contains a list of ClusterProvision
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.hive.v1.ClusterProvision> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterProvisionList contains a list of ClusterProvision
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterProvisionList contains a list of ClusterProvision
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterProvisionSpec.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterProvisionSpec.java
index 6c2438dccfc..7d3f445a0e5 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterProvisionSpec.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterProvisionSpec.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterProvisionSpec defines the results of provisioning a cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -132,142 +135,226 @@ public ClusterProvisionSpec(LocalObjectReference adminKubeconfigSecretRef, Local
         this.stage = stage;
     }
 
+    /**
+     * ClusterProvisionSpec defines the results of provisioning a cluster.
+     */
     @JsonProperty("adminKubeconfigSecretRef")
     public LocalObjectReference getAdminKubeconfigSecretRef() {
         return adminKubeconfigSecretRef;
     }
 
+    /**
+     * ClusterProvisionSpec defines the results of provisioning a cluster.
+     */
     @JsonProperty("adminKubeconfigSecretRef")
     public void setAdminKubeconfigSecretRef(LocalObjectReference adminKubeconfigSecretRef) {
         this.adminKubeconfigSecretRef = adminKubeconfigSecretRef;
     }
 
+    /**
+     * ClusterProvisionSpec defines the results of provisioning a cluster.
+     */
     @JsonProperty("adminPasswordSecretRef")
     public LocalObjectReference getAdminPasswordSecretRef() {
         return adminPasswordSecretRef;
     }
 
+    /**
+     * ClusterProvisionSpec defines the results of provisioning a cluster.
+     */
     @JsonProperty("adminPasswordSecretRef")
     public void setAdminPasswordSecretRef(LocalObjectReference adminPasswordSecretRef) {
         this.adminPasswordSecretRef = adminPasswordSecretRef;
     }
 
+    /**
+     * Attempt is which attempt number of the cluster deployment that this ClusterProvision is
+     */
     @JsonProperty("attempt")
     public Integer getAttempt() {
         return attempt;
     }
 
+    /**
+     * Attempt is which attempt number of the cluster deployment that this ClusterProvision is
+     */
     @JsonProperty("attempt")
     public void setAttempt(Integer attempt) {
         this.attempt = attempt;
     }
 
+    /**
+     * ClusterProvisionSpec defines the results of provisioning a cluster.
+     */
     @JsonProperty("clusterDeploymentRef")
     public LocalObjectReference getClusterDeploymentRef() {
         return clusterDeploymentRef;
     }
 
+    /**
+     * ClusterProvisionSpec defines the results of provisioning a cluster.
+     */
     @JsonProperty("clusterDeploymentRef")
     public void setClusterDeploymentRef(LocalObjectReference clusterDeploymentRef) {
         this.clusterDeploymentRef = clusterDeploymentRef;
     }
 
+    /**
+     * ClusterID is a globally unique identifier for this cluster generated during installation. Used for reporting metrics among other places.
+     */
     @JsonProperty("clusterID")
     public String getClusterID() {
         return clusterID;
     }
 
+    /**
+     * ClusterID is a globally unique identifier for this cluster generated during installation. Used for reporting metrics among other places.
+     */
     @JsonProperty("clusterID")
     public void setClusterID(String clusterID) {
         this.clusterID = clusterID;
     }
 
+    /**
+     * InfraID is an identifier for this cluster generated during installation and used for tagging/naming resources in cloud providers.
+     */
     @JsonProperty("infraID")
     public String getInfraID() {
         return infraID;
     }
 
+    /**
+     * InfraID is an identifier for this cluster generated during installation and used for tagging/naming resources in cloud providers.
+     */
     @JsonProperty("infraID")
     public void setInfraID(String infraID) {
         this.infraID = infraID;
     }
 
+    /**
+     * InstallLog is the log from the installer.
+     */
     @JsonProperty("installLog")
     public String getInstallLog() {
         return installLog;
     }
 
+    /**
+     * InstallLog is the log from the installer.
+     */
     @JsonProperty("installLog")
     public void setInstallLog(String installLog) {
         this.installLog = installLog;
     }
 
+    /**
+     * ClusterProvisionSpec defines the results of provisioning a cluster.
+     */
     @JsonProperty("metadata")
     public Object getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterProvisionSpec defines the results of provisioning a cluster.
+     */
     @JsonProperty("metadata")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setMetadata(Object metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * MetadataJSON is a JSON representation of the ClusterMetadata produced by the installer. We don't use a runtime.RawExtension because ClusterMetadata isn't a runtime.Object. We don't use ClusterMetadata itself because we don't want our API consumers to need to pull in the installer code and its dependencies.
+     */
     @JsonProperty("metadataJSON")
     public String getMetadataJSON() {
         return metadataJSON;
     }
 
+    /**
+     * MetadataJSON is a JSON representation of the ClusterMetadata produced by the installer. We don't use a runtime.RawExtension because ClusterMetadata isn't a runtime.Object. We don't use ClusterMetadata itself because we don't want our API consumers to need to pull in the installer code and its dependencies.
+     */
     @JsonProperty("metadataJSON")
     public void setMetadataJSON(String metadataJSON) {
         this.metadataJSON = metadataJSON;
     }
 
+    /**
+     * ClusterProvisionSpec defines the results of provisioning a cluster.
+     */
     @JsonProperty("podSpec")
     public PodSpec getPodSpec() {
         return podSpec;
     }
 
+    /**
+     * ClusterProvisionSpec defines the results of provisioning a cluster.
+     */
     @JsonProperty("podSpec")
     public void setPodSpec(PodSpec podSpec) {
         this.podSpec = podSpec;
     }
 
+    /**
+     * PrevClusterID is the cluster ID of the previous failed provision attempt.
+     */
     @JsonProperty("prevClusterID")
     public String getPrevClusterID() {
         return prevClusterID;
     }
 
+    /**
+     * PrevClusterID is the cluster ID of the previous failed provision attempt.
+     */
     @JsonProperty("prevClusterID")
     public void setPrevClusterID(String prevClusterID) {
         this.prevClusterID = prevClusterID;
     }
 
+    /**
+     * PrevInfraID is the infra ID of the previous failed provision attempt.
+     */
     @JsonProperty("prevInfraID")
     public String getPrevInfraID() {
         return prevInfraID;
     }
 
+    /**
+     * PrevInfraID is the infra ID of the previous failed provision attempt.
+     */
     @JsonProperty("prevInfraID")
     public void setPrevInfraID(String prevInfraID) {
         this.prevInfraID = prevInfraID;
     }
 
+    /**
+     * PrevProvisionName is the name of the previous failed provision attempt.
+     */
     @JsonProperty("prevProvisionName")
     public String getPrevProvisionName() {
         return prevProvisionName;
     }
 
+    /**
+     * PrevProvisionName is the name of the previous failed provision attempt.
+     */
     @JsonProperty("prevProvisionName")
     public void setPrevProvisionName(String prevProvisionName) {
         this.prevProvisionName = prevProvisionName;
     }
 
+    /**
+     * Stage is the stage of provisioning that the cluster deployment has reached.
+     */
     @JsonProperty("stage")
     public String getStage() {
         return stage;
     }
 
+    /**
+     * Stage is the stage of provisioning that the cluster deployment has reached.
+     */
     @JsonProperty("stage")
     public void setStage(String stage) {
         this.stage = stage;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterProvisionStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterProvisionStatus.java
index 7706463e360..c1805430673 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterProvisionStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterProvisionStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterProvisionStatus defines the observed state of ClusterProvision.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public ClusterProvisionStatus(List<ClusterProvisionCondition> conditions, LocalO
         this.jobRef = jobRef;
     }
 
+    /**
+     * Conditions includes more detailed status for the cluster provision
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ClusterProvisionCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions includes more detailed status for the cluster provision
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ClusterProvisionCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ClusterProvisionStatus defines the observed state of ClusterProvision.
+     */
     @JsonProperty("jobRef")
     public LocalObjectReference getJobRef() {
         return jobRef;
     }
 
+    /**
+     * ClusterProvisionStatus defines the observed state of ClusterProvision.
+     */
     @JsonProperty("jobRef")
     public void setJobRef(LocalObjectReference jobRef) {
         this.jobRef = jobRef;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterRelocate.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterRelocate.java
index c9df4a30f55..05d4c08b335 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterRelocate.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterRelocate.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterRelocate is the Schema for the ClusterRelocates API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ClusterRelocate implements Editable<ClusterRelocateBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterRelocate";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public ClusterRelocate(String apiVersion, String kind, ObjectMeta metadata, Clus
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterRelocate is the Schema for the ClusterRelocates API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterRelocate is the Schema for the ClusterRelocates API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ClusterRelocate is the Schema for the ClusterRelocates API
+     */
     @JsonProperty("spec")
     public ClusterRelocateSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ClusterRelocate is the Schema for the ClusterRelocates API
+     */
     @JsonProperty("spec")
     public void setSpec(ClusterRelocateSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ClusterRelocate is the Schema for the ClusterRelocates API
+     */
     @JsonProperty("status")
     public ClusterRelocateStatus getStatus() {
         return status;
     }
 
+    /**
+     * ClusterRelocate is the Schema for the ClusterRelocates API
+     */
     @JsonProperty("status")
     public void setStatus(ClusterRelocateStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterRelocateList.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterRelocateList.java
index b8a118d5226..c57ecf85cca 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterRelocateList.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterRelocateList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterRelocateList contains a list of ClusterRelocate
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ClusterRelocateList implements Editable<ClusterRelocateListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.hive.v1.ClusterRelocate>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.hive.v1.ClusterRelocate> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterRelocateList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterRelocateList(String apiVersion, List<io.fabric8.openshift.api.mode
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ClusterRelocateList contains a list of ClusterRelocate
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.hive.v1.ClusterRelocate> getItems() {
         return items;
     }
 
+    /**
+     * ClusterRelocateList contains a list of ClusterRelocate
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.hive.v1.ClusterRelocate> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterRelocateList contains a list of ClusterRelocate
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterRelocateList contains a list of ClusterRelocate
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterRelocateSpec.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterRelocateSpec.java
index fba7a7120ab..9a1ec53da28 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterRelocateSpec.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterRelocateSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterRelocateSpec defines the relocation of clusters from one Hive instance to another.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ClusterRelocateSpec(LabelSelector clusterDeploymentSelector, KubeconfigSe
         this.kubeconfigSecretRef = kubeconfigSecretRef;
     }
 
+    /**
+     * ClusterRelocateSpec defines the relocation of clusters from one Hive instance to another.
+     */
     @JsonProperty("clusterDeploymentSelector")
     public LabelSelector getClusterDeploymentSelector() {
         return clusterDeploymentSelector;
     }
 
+    /**
+     * ClusterRelocateSpec defines the relocation of clusters from one Hive instance to another.
+     */
     @JsonProperty("clusterDeploymentSelector")
     public void setClusterDeploymentSelector(LabelSelector clusterDeploymentSelector) {
         this.clusterDeploymentSelector = clusterDeploymentSelector;
     }
 
+    /**
+     * ClusterRelocateSpec defines the relocation of clusters from one Hive instance to another.
+     */
     @JsonProperty("kubeconfigSecretRef")
     public KubeconfigSecretReference getKubeconfigSecretRef() {
         return kubeconfigSecretRef;
     }
 
+    /**
+     * ClusterRelocateSpec defines the relocation of clusters from one Hive instance to another.
+     */
     @JsonProperty("kubeconfigSecretRef")
     public void setKubeconfigSecretRef(KubeconfigSecretReference kubeconfigSecretRef) {
         this.kubeconfigSecretRef = kubeconfigSecretRef;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterRelocateStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterRelocateStatus.java
index 00e2462ad12..6cf7532b252 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterRelocateStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterRelocateStatus.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterRelocateStatus defines the observed state of ClusterRelocate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterState.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterState.java
index 00e42fae0ac..f7a9ef20496 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterState.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterState.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterState is the Schema for the clusterstates API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class ClusterState implements Editable<ClusterStateBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterState";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterState(String apiVersion, String kind, ObjectMeta metadata, Cluster
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterState is the Schema for the clusterstates API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterState is the Schema for the clusterstates API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ClusterState is the Schema for the clusterstates API
+     */
     @JsonProperty("spec")
     public ClusterStateSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ClusterState is the Schema for the clusterstates API
+     */
     @JsonProperty("spec")
     public void setSpec(ClusterStateSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ClusterState is the Schema for the clusterstates API
+     */
     @JsonProperty("status")
     public ClusterStateStatus getStatus() {
         return status;
     }
 
+    /**
+     * ClusterState is the Schema for the clusterstates API
+     */
     @JsonProperty("status")
     public void setStatus(ClusterStateStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterStateList.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterStateList.java
index 9b1328ad4da..ec4c51361fa 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterStateList.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterStateList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterStateList contains a list of ClusterState
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ClusterStateList implements Editable<ClusterStateListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.hive.v1.ClusterState>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.hive.v1.ClusterState> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterStateList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterStateList(String apiVersion, List<io.fabric8.openshift.api.model.h
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ClusterStateList contains a list of ClusterState
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.hive.v1.ClusterState> getItems() {
         return items;
     }
 
+    /**
+     * ClusterStateList contains a list of ClusterState
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.hive.v1.ClusterState> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterStateList contains a list of ClusterState
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterStateList contains a list of ClusterState
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterStateSpec.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterStateSpec.java
index 012856ae6df..e9ab21e27c6 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterStateSpec.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterStateSpec.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterStateSpec defines the desired state of ClusterState
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterStateStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterStateStatus.java
index 6cb6571b830..b1fd738c1fd 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterStateStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ClusterStateStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterStateStatus defines the observed state of ClusterState
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public ClusterStateStatus(List<ClusterOperatorState> clusterOperators, String la
         this.lastUpdated = lastUpdated;
     }
 
+    /**
+     * ClusterOperators contains the state for every cluster operator in the target cluster
+     */
     @JsonProperty("clusterOperators")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ClusterOperatorState> getClusterOperators() {
         return clusterOperators;
     }
 
+    /**
+     * ClusterOperators contains the state for every cluster operator in the target cluster
+     */
     @JsonProperty("clusterOperators")
     public void setClusterOperators(List<ClusterOperatorState> clusterOperators) {
         this.clusterOperators = clusterOperators;
     }
 
+    /**
+     * ClusterStateStatus defines the observed state of ClusterState
+     */
     @JsonProperty("lastUpdated")
     public String getLastUpdated() {
         return lastUpdated;
     }
 
+    /**
+     * ClusterStateStatus defines the observed state of ClusterState
+     */
     @JsonProperty("lastUpdated")
     public void setLastUpdated(String lastUpdated) {
         this.lastUpdated = lastUpdated;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ControlPlaneAdditionalCertificate.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ControlPlaneAdditionalCertificate.java
index bbb21e96746..4063d7927c7 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ControlPlaneAdditionalCertificate.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ControlPlaneAdditionalCertificate.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ControlPlaneAdditionalCertificate defines an additional serving certificate for a control plane
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ControlPlaneAdditionalCertificate(String domain, String name) {
         this.name = name;
     }
 
+    /**
+     * Domain is the domain of the additional control plane certificate
+     */
     @JsonProperty("domain")
     public String getDomain() {
         return domain;
     }
 
+    /**
+     * Domain is the domain of the additional control plane certificate
+     */
     @JsonProperty("domain")
     public void setDomain(String domain) {
         this.domain = domain;
     }
 
+    /**
+     * Name references a CertificateBundle in the ClusterDeployment.Spec that should be used for this additional certificate.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name references a CertificateBundle in the ClusterDeployment.Spec that should be used for this additional certificate.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ControlPlaneConfigSpec.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ControlPlaneConfigSpec.java
index 2a15285fcc2..c03d7d97439 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ControlPlaneConfigSpec.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ControlPlaneConfigSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ControlPlaneConfigSpec contains additional configuration settings for a target cluster's control plane.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ControlPlaneConfigSpec(String apiServerIPOverride, String apiURLOverride,
         this.servingCertificates = servingCertificates;
     }
 
+    /**
+     * APIServerIPOverride is the optional override of the API server IP address. Hive will use this IP address for creating TCP connections. Port from the original API server URL will be used. This field can be used when repointing the APIServer's DNS is not viable option.
+     */
     @JsonProperty("apiServerIPOverride")
     public String getApiServerIPOverride() {
         return apiServerIPOverride;
     }
 
+    /**
+     * APIServerIPOverride is the optional override of the API server IP address. Hive will use this IP address for creating TCP connections. Port from the original API server URL will be used. This field can be used when repointing the APIServer's DNS is not viable option.
+     */
     @JsonProperty("apiServerIPOverride")
     public void setApiServerIPOverride(String apiServerIPOverride) {
         this.apiServerIPOverride = apiServerIPOverride;
     }
 
+    /**
+     * APIURLOverride is the optional URL override to which Hive will transition for communication with the API server of the remote cluster. When a remote cluster is created, Hive will initially communicate using the API URL established during installation. If an API URL Override is specified, Hive will periodically attempt to connect to the remote cluster using the override URL. Once Hive has determined that the override URL is active, Hive will use the override URL for further communications with the API server of the remote cluster.
+     */
     @JsonProperty("apiURLOverride")
     public String getApiURLOverride() {
         return apiURLOverride;
     }
 
+    /**
+     * APIURLOverride is the optional URL override to which Hive will transition for communication with the API server of the remote cluster. When a remote cluster is created, Hive will initially communicate using the API URL established during installation. If an API URL Override is specified, Hive will periodically attempt to connect to the remote cluster using the override URL. Once Hive has determined that the override URL is active, Hive will use the override URL for further communications with the API server of the remote cluster.
+     */
     @JsonProperty("apiURLOverride")
     public void setApiURLOverride(String apiURLOverride) {
         this.apiURLOverride = apiURLOverride;
     }
 
+    /**
+     * ControlPlaneConfigSpec contains additional configuration settings for a target cluster's control plane.
+     */
     @JsonProperty("servingCertificates")
     public ControlPlaneServingCertificateSpec getServingCertificates() {
         return servingCertificates;
     }
 
+    /**
+     * ControlPlaneConfigSpec contains additional configuration settings for a target cluster's control plane.
+     */
     @JsonProperty("servingCertificates")
     public void setServingCertificates(ControlPlaneServingCertificateSpec servingCertificates) {
         this.servingCertificates = servingCertificates;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ControlPlaneServingCertificateSpec.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ControlPlaneServingCertificateSpec.java
index cb1193eaaa4..33251a8cf9a 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ControlPlaneServingCertificateSpec.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ControlPlaneServingCertificateSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ControlPlaneServingCertificateSpec specifies serving certificate settings for the control plane of the target cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public ControlPlaneServingCertificateSpec(List<ControlPlaneAdditionalCertificate
         this._default = _default;
     }
 
+    /**
+     * Additional is a list of additional domains and certificates that are also associated with the control plane's api endpoint.
+     */
     @JsonProperty("additional")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ControlPlaneAdditionalCertificate> getAdditional() {
         return additional;
     }
 
+    /**
+     * Additional is a list of additional domains and certificates that are also associated with the control plane's api endpoint.
+     */
     @JsonProperty("additional")
     public void setAdditional(List<ControlPlaneAdditionalCertificate> additional) {
         this.additional = additional;
     }
 
+    /**
+     * Default references the name of a CertificateBundle in the ClusterDeployment that should be used for the control plane's default endpoint.
+     */
     @JsonProperty("default")
     public String getDefault() {
         return _default;
     }
 
+    /**
+     * Default references the name of a CertificateBundle in the ClusterDeployment that should be used for the control plane's default endpoint.
+     */
     @JsonProperty("default")
     public void setDefault(String _default) {
         this._default = _default;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ControllerConfig.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ControllerConfig.java
index 40e3c99f450..dcdd7b4785e 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ControllerConfig.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ControllerConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ControllerConfig contains the configuration for a controller
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,71 +105,113 @@ public ControllerConfig(Integer clientBurst, Integer clientQPS, Integer concurre
         this.resources = resources;
     }
 
+    /**
+     * ClientBurst specifies client rate limiter burst for a controller
+     */
     @JsonProperty("clientBurst")
     public Integer getClientBurst() {
         return clientBurst;
     }
 
+    /**
+     * ClientBurst specifies client rate limiter burst for a controller
+     */
     @JsonProperty("clientBurst")
     public void setClientBurst(Integer clientBurst) {
         this.clientBurst = clientBurst;
     }
 
+    /**
+     * ClientQPS specifies client rate limiter QPS for a controller
+     */
     @JsonProperty("clientQPS")
     public Integer getClientQPS() {
         return clientQPS;
     }
 
+    /**
+     * ClientQPS specifies client rate limiter QPS for a controller
+     */
     @JsonProperty("clientQPS")
     public void setClientQPS(Integer clientQPS) {
         this.clientQPS = clientQPS;
     }
 
+    /**
+     * ConcurrentReconciles specifies number of concurrent reconciles for a controller
+     */
     @JsonProperty("concurrentReconciles")
     public Integer getConcurrentReconciles() {
         return concurrentReconciles;
     }
 
+    /**
+     * ConcurrentReconciles specifies number of concurrent reconciles for a controller
+     */
     @JsonProperty("concurrentReconciles")
     public void setConcurrentReconciles(Integer concurrentReconciles) {
         this.concurrentReconciles = concurrentReconciles;
     }
 
+    /**
+     * QueueBurst specifies workqueue rate limiter burst for a controller
+     */
     @JsonProperty("queueBurst")
     public Integer getQueueBurst() {
         return queueBurst;
     }
 
+    /**
+     * QueueBurst specifies workqueue rate limiter burst for a controller
+     */
     @JsonProperty("queueBurst")
     public void setQueueBurst(Integer queueBurst) {
         this.queueBurst = queueBurst;
     }
 
+    /**
+     * QueueQPS specifies workqueue rate limiter QPS for a controller
+     */
     @JsonProperty("queueQPS")
     public Integer getQueueQPS() {
         return queueQPS;
     }
 
+    /**
+     * QueueQPS specifies workqueue rate limiter QPS for a controller
+     */
     @JsonProperty("queueQPS")
     public void setQueueQPS(Integer queueQPS) {
         this.queueQPS = queueQPS;
     }
 
+    /**
+     * Replicas specifies the number of replicas the specific controller pod should use. This is ONLY for controllers that have been split out into their own pods. This is ignored for all others.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Replicas specifies the number of replicas the specific controller pod should use. This is ONLY for controllers that have been split out into their own pods. This is ignored for all others.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * ControllerConfig contains the configuration for a controller
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * ControllerConfig contains the configuration for a controller
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ControllersConfig.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ControllersConfig.java
index ed899de61c4..85e2ca1c6b2 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ControllersConfig.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ControllersConfig.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ControllersConfig contains default as well as controller specific configurations
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public ControllersConfig(List<SpecificControllerConfig> controllers, ControllerC
         this._default = _default;
     }
 
+    /**
+     * Controllers contains a list of configurations for different controllers
+     */
     @JsonProperty("controllers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SpecificControllerConfig> getControllers() {
         return controllers;
     }
 
+    /**
+     * Controllers contains a list of configurations for different controllers
+     */
     @JsonProperty("controllers")
     public void setControllers(List<SpecificControllerConfig> controllers) {
         this.controllers = controllers;
     }
 
+    /**
+     * ControllersConfig contains default as well as controller specific configurations
+     */
     @JsonProperty("default")
     public ControllerConfig getDefault() {
         return _default;
     }
 
+    /**
+     * ControllersConfig contains default as well as controller specific configurations
+     */
     @JsonProperty("default")
     public void setDefault(ControllerConfig _default) {
         this._default = _default;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/DNSZone.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/DNSZone.java
index a67687cd760..44aa5e74fb5 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/DNSZone.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/DNSZone.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSZone is the Schema for the dnszones API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class DNSZone implements Editable<DNSZoneBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DNSZone";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DNSZone(String apiVersion, String kind, ObjectMeta metadata, DNSZoneSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DNSZone is the Schema for the dnszones API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DNSZone is the Schema for the dnszones API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * DNSZone is the Schema for the dnszones API
+     */
     @JsonProperty("spec")
     public DNSZoneSpec getSpec() {
         return spec;
     }
 
+    /**
+     * DNSZone is the Schema for the dnszones API
+     */
     @JsonProperty("spec")
     public void setSpec(DNSZoneSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * DNSZone is the Schema for the dnszones API
+     */
     @JsonProperty("status")
     public DNSZoneStatus getStatus() {
         return status;
     }
 
+    /**
+     * DNSZone is the Schema for the dnszones API
+     */
     @JsonProperty("status")
     public void setStatus(DNSZoneStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/DNSZoneCondition.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/DNSZoneCondition.java
index 57947728c4d..e12c5363383 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/DNSZoneCondition.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/DNSZoneCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSZoneCondition contains details for the current condition of a DNSZone
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public DNSZoneCondition(String lastProbeTime, String lastTransitionTime, String
         this.type = type;
     }
 
+    /**
+     * DNSZoneCondition contains details for the current condition of a DNSZone
+     */
     @JsonProperty("lastProbeTime")
     public String getLastProbeTime() {
         return lastProbeTime;
     }
 
+    /**
+     * DNSZoneCondition contains details for the current condition of a DNSZone
+     */
     @JsonProperty("lastProbeTime")
     public void setLastProbeTime(String lastProbeTime) {
         this.lastProbeTime = lastProbeTime;
     }
 
+    /**
+     * DNSZoneCondition contains details for the current condition of a DNSZone
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * DNSZoneCondition contains details for the current condition of a DNSZone
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Message is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Reason is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status is the status of the condition.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status is the status of the condition.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type is the type of the condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of the condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/DNSZoneList.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/DNSZoneList.java
index a7b3fe4751e..4715a56d4cb 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/DNSZoneList.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/DNSZoneList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSZoneList contains a list of DNSZone
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class DNSZoneList implements Editable<DNSZoneListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.hive.v1.DNSZone>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.hive.v1.DNSZone> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DNSZoneList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DNSZoneList(String apiVersion, List<io.fabric8.openshift.api.model.hive.v
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * DNSZoneList contains a list of DNSZone
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.hive.v1.DNSZone> getItems() {
         return items;
     }
 
+    /**
+     * DNSZoneList contains a list of DNSZone
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.hive.v1.DNSZone> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DNSZoneList contains a list of DNSZone
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DNSZoneList contains a list of DNSZone
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/DNSZoneSpec.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/DNSZoneSpec.java
index b71202dc51f..4d0e7182725 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/DNSZoneSpec.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/DNSZoneSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSZoneSpec defines the desired state of DNSZone
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public DNSZoneSpec(AWSDNSZoneSpec aws, AzureDNSZoneSpec azure, GCPDNSZoneSpec gc
         this.zone = zone;
     }
 
+    /**
+     * DNSZoneSpec defines the desired state of DNSZone
+     */
     @JsonProperty("aws")
     public AWSDNSZoneSpec getAws() {
         return aws;
     }
 
+    /**
+     * DNSZoneSpec defines the desired state of DNSZone
+     */
     @JsonProperty("aws")
     public void setAws(AWSDNSZoneSpec aws) {
         this.aws = aws;
     }
 
+    /**
+     * DNSZoneSpec defines the desired state of DNSZone
+     */
     @JsonProperty("azure")
     public AzureDNSZoneSpec getAzure() {
         return azure;
     }
 
+    /**
+     * DNSZoneSpec defines the desired state of DNSZone
+     */
     @JsonProperty("azure")
     public void setAzure(AzureDNSZoneSpec azure) {
         this.azure = azure;
     }
 
+    /**
+     * DNSZoneSpec defines the desired state of DNSZone
+     */
     @JsonProperty("gcp")
     public GCPDNSZoneSpec getGcp() {
         return gcp;
     }
 
+    /**
+     * DNSZoneSpec defines the desired state of DNSZone
+     */
     @JsonProperty("gcp")
     public void setGcp(GCPDNSZoneSpec gcp) {
         this.gcp = gcp;
     }
 
+    /**
+     * LinkToParentDomain specifies whether DNS records should be automatically created to link this DNSZone with a parent domain.
+     */
     @JsonProperty("linkToParentDomain")
     public Boolean getLinkToParentDomain() {
         return linkToParentDomain;
     }
 
+    /**
+     * LinkToParentDomain specifies whether DNS records should be automatically created to link this DNSZone with a parent domain.
+     */
     @JsonProperty("linkToParentDomain")
     public void setLinkToParentDomain(Boolean linkToParentDomain) {
         this.linkToParentDomain = linkToParentDomain;
     }
 
+    /**
+     * PreserveOnDelete allows the user to disconnect a DNSZone from Hive without deprovisioning it. This can also be used to abandon ongoing DNSZone deprovision. Typically set automatically due to PreserveOnDelete being set on a ClusterDeployment.
+     */
     @JsonProperty("preserveOnDelete")
     public Boolean getPreserveOnDelete() {
         return preserveOnDelete;
     }
 
+    /**
+     * PreserveOnDelete allows the user to disconnect a DNSZone from Hive without deprovisioning it. This can also be used to abandon ongoing DNSZone deprovision. Typically set automatically due to PreserveOnDelete being set on a ClusterDeployment.
+     */
     @JsonProperty("preserveOnDelete")
     public void setPreserveOnDelete(Boolean preserveOnDelete) {
         this.preserveOnDelete = preserveOnDelete;
     }
 
+    /**
+     * Zone is the DNS zone to host
+     */
     @JsonProperty("zone")
     public String getZone() {
         return zone;
     }
 
+    /**
+     * Zone is the DNS zone to host
+     */
     @JsonProperty("zone")
     public void setZone(String zone) {
         this.zone = zone;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/DNSZoneStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/DNSZoneStatus.java
index d261a2f9ed6..7a7165baa1e 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/DNSZoneStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/DNSZoneStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSZoneStatus defines the observed state of DNSZone
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -106,73 +109,115 @@ public DNSZoneStatus(AWSDNSZoneStatus aws, AzureDNSZoneStatus azure, List<DNSZon
         this.nameServers = nameServers;
     }
 
+    /**
+     * DNSZoneStatus defines the observed state of DNSZone
+     */
     @JsonProperty("aws")
     public AWSDNSZoneStatus getAws() {
         return aws;
     }
 
+    /**
+     * DNSZoneStatus defines the observed state of DNSZone
+     */
     @JsonProperty("aws")
     public void setAws(AWSDNSZoneStatus aws) {
         this.aws = aws;
     }
 
+    /**
+     * DNSZoneStatus defines the observed state of DNSZone
+     */
     @JsonProperty("azure")
     public AzureDNSZoneStatus getAzure() {
         return azure;
     }
 
+    /**
+     * DNSZoneStatus defines the observed state of DNSZone
+     */
     @JsonProperty("azure")
     public void setAzure(AzureDNSZoneStatus azure) {
         this.azure = azure;
     }
 
+    /**
+     * Conditions includes more detailed status for the DNSZone
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DNSZoneCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions includes more detailed status for the DNSZone
+     */
     @JsonProperty("conditions")
     public void setConditions(List<DNSZoneCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * DNSZoneStatus defines the observed state of DNSZone
+     */
     @JsonProperty("gcp")
     public GCPDNSZoneStatus getGcp() {
         return gcp;
     }
 
+    /**
+     * DNSZoneStatus defines the observed state of DNSZone
+     */
     @JsonProperty("gcp")
     public void setGcp(GCPDNSZoneStatus gcp) {
         this.gcp = gcp;
     }
 
+    /**
+     * LastSyncGeneration is the generation of the zone resource that was last sync'd. This is used to know if the Object has changed and we should sync immediately.
+     */
     @JsonProperty("lastSyncGeneration")
     public Long getLastSyncGeneration() {
         return lastSyncGeneration;
     }
 
+    /**
+     * LastSyncGeneration is the generation of the zone resource that was last sync'd. This is used to know if the Object has changed and we should sync immediately.
+     */
     @JsonProperty("lastSyncGeneration")
     public void setLastSyncGeneration(Long lastSyncGeneration) {
         this.lastSyncGeneration = lastSyncGeneration;
     }
 
+    /**
+     * DNSZoneStatus defines the observed state of DNSZone
+     */
     @JsonProperty("lastSyncTimestamp")
     public String getLastSyncTimestamp() {
         return lastSyncTimestamp;
     }
 
+    /**
+     * DNSZoneStatus defines the observed state of DNSZone
+     */
     @JsonProperty("lastSyncTimestamp")
     public void setLastSyncTimestamp(String lastSyncTimestamp) {
         this.lastSyncTimestamp = lastSyncTimestamp;
     }
 
+    /**
+     * NameServers is a list of nameservers for this DNS zone
+     */
     @JsonProperty("nameServers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNameServers() {
         return nameServers;
     }
 
+    /**
+     * NameServers is a list of nameservers for this DNS zone
+     */
     @JsonProperty("nameServers")
     public void setNameServers(List<String> nameServers) {
         this.nameServers = nameServers;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/DeploymentConfig.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/DeploymentConfig.java
index 6e1c5d404fc..ad7aeb4ffff 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/DeploymentConfig.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/DeploymentConfig.java
@@ -82,11 +82,17 @@ public DeploymentConfig(String deploymentName, ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * DeploymentName is the name of one of the Deployments/StatefulSets managed by hive-operator. NOTE: At this time each deployment has only one container. In the future, we may provide a way to specify which container this DeploymentConfig will be applied to.
+     */
     @JsonProperty("deploymentName")
     public String getDeploymentName() {
         return deploymentName;
     }
 
+    /**
+     * DeploymentName is the name of one of the Deployments/StatefulSets managed by hive-operator. NOTE: At this time each deployment has only one container. In the future, we may provide a way to specify which container this DeploymentConfig will be applied to.
+     */
     @JsonProperty("deploymentName")
     public void setDeploymentName(String deploymentName) {
         this.deploymentName = deploymentName;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/FailedProvisionAWSConfig.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/FailedProvisionAWSConfig.java
index 39072641387..23bd89837c1 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/FailedProvisionAWSConfig.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/FailedProvisionAWSConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FailedProvisionAWSConfig contains AWS-specific info to upload log files.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public FailedProvisionAWSConfig(String bucket, LocalObjectReference credentialsS
         this.serviceEndpoint = serviceEndpoint;
     }
 
+    /**
+     * Bucket is the S3 bucket to store the logs in.
+     */
     @JsonProperty("bucket")
     public String getBucket() {
         return bucket;
     }
 
+    /**
+     * Bucket is the S3 bucket to store the logs in.
+     */
     @JsonProperty("bucket")
     public void setBucket(String bucket) {
         this.bucket = bucket;
     }
 
+    /**
+     * FailedProvisionAWSConfig contains AWS-specific info to upload log files.
+     */
     @JsonProperty("credentialsSecretRef")
     public LocalObjectReference getCredentialsSecretRef() {
         return credentialsSecretRef;
     }
 
+    /**
+     * FailedProvisionAWSConfig contains AWS-specific info to upload log files.
+     */
     @JsonProperty("credentialsSecretRef")
     public void setCredentialsSecretRef(LocalObjectReference credentialsSecretRef) {
         this.credentialsSecretRef = credentialsSecretRef;
     }
 
+    /**
+     * Region is the AWS region to use for S3 operations. This defaults to us-east-1. For AWS China, use cn-northwest-1.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Region is the AWS region to use for S3 operations. This defaults to us-east-1. For AWS China, use cn-northwest-1.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * ServiceEndpoint is the url to connect to an S3 compatible provider.
+     */
     @JsonProperty("serviceEndpoint")
     public String getServiceEndpoint() {
         return serviceEndpoint;
     }
 
+    /**
+     * ServiceEndpoint is the url to connect to an S3 compatible provider.
+     */
     @JsonProperty("serviceEndpoint")
     public void setServiceEndpoint(String serviceEndpoint) {
         this.serviceEndpoint = serviceEndpoint;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/FailedProvisionConfig.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/FailedProvisionConfig.java
index f0f7c7a9ebd..80d120834e9 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/FailedProvisionConfig.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/FailedProvisionConfig.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FailedProvisionConfig contains settings to control behavior undertaken by Hive when an installation attempt fails.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public FailedProvisionConfig(FailedProvisionAWSConfig aws, List<String> retryRea
         this.skipGatherLogs = skipGatherLogs;
     }
 
+    /**
+     * FailedProvisionConfig contains settings to control behavior undertaken by Hive when an installation attempt fails.
+     */
     @JsonProperty("aws")
     public FailedProvisionAWSConfig getAws() {
         return aws;
     }
 
+    /**
+     * FailedProvisionConfig contains settings to control behavior undertaken by Hive when an installation attempt fails.
+     */
     @JsonProperty("aws")
     public void setAws(FailedProvisionAWSConfig aws) {
         this.aws = aws;
     }
 
+    /**
+     * RetryReasons is a list of installFailingReason strings from the [additional-]install-log-regexes ConfigMaps. If specified, Hive will only retry a failed installation if it results in one of the listed reasons. If omitted (not the same thing as empty!), Hive will retry regardless of the failure reason. (The total number of install attempts is still constrained by ClusterDeployment.Spec.InstallAttemptsLimit.)
+     */
     @JsonProperty("retryReasons")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getRetryReasons() {
         return retryReasons;
     }
 
+    /**
+     * RetryReasons is a list of installFailingReason strings from the [additional-]install-log-regexes ConfigMaps. If specified, Hive will only retry a failed installation if it results in one of the listed reasons. If omitted (not the same thing as empty!), Hive will retry regardless of the failure reason. (The total number of install attempts is still constrained by ClusterDeployment.Spec.InstallAttemptsLimit.)
+     */
     @JsonProperty("retryReasons")
     public void setRetryReasons(List<String> retryReasons) {
         this.retryReasons = retryReasons;
     }
 
+    /**
+     * DEPRECATED: This flag is no longer respected and will be removed in the future.
+     */
     @JsonProperty("skipGatherLogs")
     public Boolean getSkipGatherLogs() {
         return skipGatherLogs;
     }
 
+    /**
+     * DEPRECATED: This flag is no longer respected and will be removed in the future.
+     */
     @JsonProperty("skipGatherLogs")
     public void setSkipGatherLogs(Boolean skipGatherLogs) {
         this.skipGatherLogs = skipGatherLogs;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/FeatureGateSelection.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/FeatureGateSelection.java
index 9ee5130f091..018f43aa9fe 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/FeatureGateSelection.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/FeatureGateSelection.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FeatureGateSelection allows selecting feature gates for the controller.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public FeatureGateSelection(FeatureGatesEnabled custom, String featureSet) {
         this.featureSet = featureSet;
     }
 
+    /**
+     * FeatureGateSelection allows selecting feature gates for the controller.
+     */
     @JsonProperty("custom")
     public FeatureGatesEnabled getCustom() {
         return custom;
     }
 
+    /**
+     * FeatureGateSelection allows selecting feature gates for the controller.
+     */
     @JsonProperty("custom")
     public void setCustom(FeatureGatesEnabled custom) {
         this.custom = custom;
     }
 
+    /**
+     * featureSet changes the list of features in the cluster.  The default is empty.  Be very careful adjusting this setting.
+     */
     @JsonProperty("featureSet")
     public String getFeatureSet() {
         return featureSet;
     }
 
+    /**
+     * featureSet changes the list of features in the cluster.  The default is empty.  Be very careful adjusting this setting.
+     */
     @JsonProperty("featureSet")
     public void setFeatureSet(String featureSet) {
         this.featureSet = featureSet;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/FeatureGatesEnabled.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/FeatureGatesEnabled.java
index f475d532f36..5bae3258753 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/FeatureGatesEnabled.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/FeatureGatesEnabled.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FeatureGatesEnabled is list of feature gates that must be enabled.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public FeatureGatesEnabled(List<String> enabled) {
         this.enabled = enabled;
     }
 
+    /**
+     * enabled is a list of all feature gates that you want to force on
+     */
     @JsonProperty("enabled")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEnabled() {
         return enabled;
     }
 
+    /**
+     * enabled is a list of all feature gates that you want to force on
+     */
     @JsonProperty("enabled")
     public void setEnabled(List<String> enabled) {
         this.enabled = enabled;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/GCPClusterDeprovision.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/GCPClusterDeprovision.java
index 7ea86c6c4db..3c212da03a5 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/GCPClusterDeprovision.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/GCPClusterDeprovision.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPClusterDeprovision contains GCP-specific configuration for a ClusterDeprovision
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public GCPClusterDeprovision(LocalObjectReference credentialsSecretRef, String n
         this.region = region;
     }
 
+    /**
+     * GCPClusterDeprovision contains GCP-specific configuration for a ClusterDeprovision
+     */
     @JsonProperty("credentialsSecretRef")
     public LocalObjectReference getCredentialsSecretRef() {
         return credentialsSecretRef;
     }
 
+    /**
+     * GCPClusterDeprovision contains GCP-specific configuration for a ClusterDeprovision
+     */
     @JsonProperty("credentialsSecretRef")
     public void setCredentialsSecretRef(LocalObjectReference credentialsSecretRef) {
         this.credentialsSecretRef = credentialsSecretRef;
     }
 
+    /**
+     * NetworkProjectID is used for shared VPC setups
+     */
     @JsonProperty("networkProjectID")
     public String getNetworkProjectID() {
         return networkProjectID;
     }
 
+    /**
+     * NetworkProjectID is used for shared VPC setups
+     */
     @JsonProperty("networkProjectID")
     public void setNetworkProjectID(String networkProjectID) {
         this.networkProjectID = networkProjectID;
     }
 
+    /**
+     * Region is the GCP region for this deprovision
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Region is the GCP region for this deprovision
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/GCPDNSZoneSpec.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/GCPDNSZoneSpec.java
index 07332cc6ead..7b7c3e55a88 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/GCPDNSZoneSpec.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/GCPDNSZoneSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPDNSZoneSpec contains GCP-specific DNSZone specifications
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public GCPDNSZoneSpec(LocalObjectReference credentialsSecretRef) {
         this.credentialsSecretRef = credentialsSecretRef;
     }
 
+    /**
+     * GCPDNSZoneSpec contains GCP-specific DNSZone specifications
+     */
     @JsonProperty("credentialsSecretRef")
     public LocalObjectReference getCredentialsSecretRef() {
         return credentialsSecretRef;
     }
 
+    /**
+     * GCPDNSZoneSpec contains GCP-specific DNSZone specifications
+     */
     @JsonProperty("credentialsSecretRef")
     public void setCredentialsSecretRef(LocalObjectReference credentialsSecretRef) {
         this.credentialsSecretRef = credentialsSecretRef;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/GCPDNSZoneStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/GCPDNSZoneStatus.java
index 212b93c9e28..12ee6be460f 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/GCPDNSZoneStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/GCPDNSZoneStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPDNSZoneStatus contains status information specific to GCP Cloud DNS zones
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public GCPDNSZoneStatus(String zoneName) {
         this.zoneName = zoneName;
     }
 
+    /**
+     * ZoneName is the name of the zone in GCP Cloud DNS
+     */
     @JsonProperty("zoneName")
     public String getZoneName() {
         return zoneName;
     }
 
+    /**
+     * ZoneName is the name of the zone in GCP Cloud DNS
+     */
     @JsonProperty("zoneName")
     public void setZoneName(String zoneName) {
         this.zoneName = zoneName;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/GCPPrivateServiceConnectConfig.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/GCPPrivateServiceConnectConfig.java
index 3c718704cc9..f0bd358e992 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/GCPPrivateServiceConnectConfig.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/GCPPrivateServiceConnectConfig.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPPrivateServiceConnectConfig defines the gcp private service connect config for the private-link controller.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public GCPPrivateServiceConnectConfig(LocalObjectReference credentialsSecretRef,
         this.endpointVPCInventory = endpointVPCInventory;
     }
 
+    /**
+     * GCPPrivateServiceConnectConfig defines the gcp private service connect config for the private-link controller.
+     */
     @JsonProperty("credentialsSecretRef")
     public LocalObjectReference getCredentialsSecretRef() {
         return credentialsSecretRef;
     }
 
+    /**
+     * GCPPrivateServiceConnectConfig defines the gcp private service connect config for the private-link controller.
+     */
     @JsonProperty("credentialsSecretRef")
     public void setCredentialsSecretRef(LocalObjectReference credentialsSecretRef) {
         this.credentialsSecretRef = credentialsSecretRef;
     }
 
+    /**
+     * EndpointVPCInventory is a list of VPCs and the corresponding subnets in various GCP regions. The controller uses this list to choose a VPC for creating GCP Endpoints. Since the VPC Endpoints must be in the same region as the ClusterDeployment, we must have VPCs in that region to be able to setup Private Service Connect.
+     */
     @JsonProperty("endpointVPCInventory")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GCPPrivateServiceConnectInventory> getEndpointVPCInventory() {
         return endpointVPCInventory;
     }
 
+    /**
+     * EndpointVPCInventory is a list of VPCs and the corresponding subnets in various GCP regions. The controller uses this list to choose a VPC for creating GCP Endpoints. Since the VPC Endpoints must be in the same region as the ClusterDeployment, we must have VPCs in that region to be able to setup Private Service Connect.
+     */
     @JsonProperty("endpointVPCInventory")
     public void setEndpointVPCInventory(List<GCPPrivateServiceConnectInventory> endpointVPCInventory) {
         this.endpointVPCInventory = endpointVPCInventory;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/GCPPrivateServiceConnectInventory.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/GCPPrivateServiceConnectInventory.java
index 2a821b4187e..59f096e7255 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/GCPPrivateServiceConnectInventory.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/GCPPrivateServiceConnectInventory.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPPrivateServiceConnectInventory is a VPC and its corresponding subnets. This VPC will be used to create a GCP Endpoint whenever there is a Private Service Connect service created for a ClusterDeployment.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public GCPPrivateServiceConnectInventory(String network, List<GCPPrivateServiceC
         this.subnets = subnets;
     }
 
+    /**
+     * GCPPrivateServiceConnectInventory is a VPC and its corresponding subnets. This VPC will be used to create a GCP Endpoint whenever there is a Private Service Connect service created for a ClusterDeployment.
+     */
     @JsonProperty("network")
     public String getNetwork() {
         return network;
     }
 
+    /**
+     * GCPPrivateServiceConnectInventory is a VPC and its corresponding subnets. This VPC will be used to create a GCP Endpoint whenever there is a Private Service Connect service created for a ClusterDeployment.
+     */
     @JsonProperty("network")
     public void setNetwork(String network) {
         this.network = network;
     }
 
+    /**
+     * GCPPrivateServiceConnectInventory is a VPC and its corresponding subnets. This VPC will be used to create a GCP Endpoint whenever there is a Private Service Connect service created for a ClusterDeployment.
+     */
     @JsonProperty("subnets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GCPPrivateServiceConnectSubnet> getSubnets() {
         return subnets;
     }
 
+    /**
+     * GCPPrivateServiceConnectInventory is a VPC and its corresponding subnets. This VPC will be used to create a GCP Endpoint whenever there is a Private Service Connect service created for a ClusterDeployment.
+     */
     @JsonProperty("subnets")
     public void setSubnets(List<GCPPrivateServiceConnectSubnet> subnets) {
         this.subnets = subnets;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/GCPPrivateServiceConnectSubnet.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/GCPPrivateServiceConnectSubnet.java
index e42d8b897b6..ef48e6157fb 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/GCPPrivateServiceConnectSubnet.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/GCPPrivateServiceConnectSubnet.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPPrivateServiceConnectSubnet defines subnet and the corresponding GCP region.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public GCPPrivateServiceConnectSubnet(String region, String subnet) {
         this.subnet = subnet;
     }
 
+    /**
+     * GCPPrivateServiceConnectSubnet defines subnet and the corresponding GCP region.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * GCPPrivateServiceConnectSubnet defines subnet and the corresponding GCP region.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * GCPPrivateServiceConnectSubnet defines subnet and the corresponding GCP region.
+     */
     @JsonProperty("subnet")
     public String getSubnet() {
         return subnet;
     }
 
+    /**
+     * GCPPrivateServiceConnectSubnet defines subnet and the corresponding GCP region.
+     */
     @JsonProperty("subnet")
     public void setSubnet(String subnet) {
         this.subnet = subnet;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/HiveConfig.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/HiveConfig.java
index 713b5108bab..36077befebb 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/HiveConfig.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/HiveConfig.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HiveConfig is the Schema for the hives API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class HiveConfig implements Editable<HiveConfigBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "HiveConfig";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public HiveConfig(String apiVersion, String kind, ObjectMeta metadata, HiveConfi
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * HiveConfig is the Schema for the hives API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * HiveConfig is the Schema for the hives API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * HiveConfig is the Schema for the hives API
+     */
     @JsonProperty("spec")
     public HiveConfigSpec getSpec() {
         return spec;
     }
 
+    /**
+     * HiveConfig is the Schema for the hives API
+     */
     @JsonProperty("spec")
     public void setSpec(HiveConfigSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * HiveConfig is the Schema for the hives API
+     */
     @JsonProperty("status")
     public HiveConfigStatus getStatus() {
         return status;
     }
 
+    /**
+     * HiveConfig is the Schema for the hives API
+     */
     @JsonProperty("status")
     public void setStatus(HiveConfigStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/HiveConfigCondition.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/HiveConfigCondition.java
index 8d2382300fb..928d625d9a8 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/HiveConfigCondition.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/HiveConfigCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HiveConfigCondition contains details for the current condition of a HiveConfig
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public HiveConfigCondition(String lastProbeTime, String lastTransitionTime, Stri
         this.type = type;
     }
 
+    /**
+     * HiveConfigCondition contains details for the current condition of a HiveConfig
+     */
     @JsonProperty("lastProbeTime")
     public String getLastProbeTime() {
         return lastProbeTime;
     }
 
+    /**
+     * HiveConfigCondition contains details for the current condition of a HiveConfig
+     */
     @JsonProperty("lastProbeTime")
     public void setLastProbeTime(String lastProbeTime) {
         this.lastProbeTime = lastProbeTime;
     }
 
+    /**
+     * HiveConfigCondition contains details for the current condition of a HiveConfig
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * HiveConfigCondition contains details for the current condition of a HiveConfig
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Message is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Reason is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status is the status of the condition.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status is the status of the condition.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type is the type of the condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of the condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/HiveConfigList.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/HiveConfigList.java
index 71f797750f3..c11e70f26d7 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/HiveConfigList.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/HiveConfigList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HiveConfigList contains a list of Hive
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class HiveConfigList implements Editable<HiveConfigListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.hive.v1.HiveConfig>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.hive.v1.HiveConfig> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "HiveConfigList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public HiveConfigList(String apiVersion, List<io.fabric8.openshift.api.model.hiv
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * HiveConfigList contains a list of Hive
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.hive.v1.HiveConfig> getItems() {
         return items;
     }
 
+    /**
+     * HiveConfigList contains a list of Hive
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.hive.v1.HiveConfig> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * HiveConfigList contains a list of Hive
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * HiveConfigList contains a list of Hive
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/HiveConfigSpec.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/HiveConfigSpec.java
index 421cf05da16..f03b02802b0 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/HiveConfigSpec.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/HiveConfigSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HiveConfigSpec defines the desired state of Hive
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -177,245 +180,389 @@ public HiveConfigSpec(List<LocalObjectReference> additionalCertificateAuthoritie
         this.targetNamespace = targetNamespace;
     }
 
+    /**
+     * AdditionalCertificateAuthoritiesSecretRef is a list of references to secrets in the TargetNamespace that contain an additional Certificate Authority to use when communicating with target clusters. These certificate authorities will be used in addition to any self-signed CA generated by each cluster on installation. The cert data should be stored in the Secret key named 'ca.crt'.
+     */
     @JsonProperty("additionalCertificateAuthoritiesSecretRef")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LocalObjectReference> getAdditionalCertificateAuthoritiesSecretRef() {
         return additionalCertificateAuthoritiesSecretRef;
     }
 
+    /**
+     * AdditionalCertificateAuthoritiesSecretRef is a list of references to secrets in the TargetNamespace that contain an additional Certificate Authority to use when communicating with target clusters. These certificate authorities will be used in addition to any self-signed CA generated by each cluster on installation. The cert data should be stored in the Secret key named 'ca.crt'.
+     */
     @JsonProperty("additionalCertificateAuthoritiesSecretRef")
     public void setAdditionalCertificateAuthoritiesSecretRef(List<LocalObjectReference> additionalCertificateAuthoritiesSecretRef) {
         this.additionalCertificateAuthoritiesSecretRef = additionalCertificateAuthoritiesSecretRef;
     }
 
+    /**
+     * HiveConfigSpec defines the desired state of Hive
+     */
     @JsonProperty("argoCDConfig")
     public ArgoCDConfig getArgoCDConfig() {
         return argoCDConfig;
     }
 
+    /**
+     * HiveConfigSpec defines the desired state of Hive
+     */
     @JsonProperty("argoCDConfig")
     public void setArgoCDConfig(ArgoCDConfig argoCDConfig) {
         this.argoCDConfig = argoCDConfig;
     }
 
+    /**
+     * HiveConfigSpec defines the desired state of Hive
+     */
     @JsonProperty("awsPrivateLink")
     public AWSPrivateLinkConfig getAwsPrivateLink() {
         return awsPrivateLink;
     }
 
+    /**
+     * HiveConfigSpec defines the desired state of Hive
+     */
     @JsonProperty("awsPrivateLink")
     public void setAwsPrivateLink(AWSPrivateLinkConfig awsPrivateLink) {
         this.awsPrivateLink = awsPrivateLink;
     }
 
+    /**
+     * HiveConfigSpec defines the desired state of Hive
+     */
     @JsonProperty("backup")
     public BackupConfig getBackup() {
         return backup;
     }
 
+    /**
+     * HiveConfigSpec defines the desired state of Hive
+     */
     @JsonProperty("backup")
     public void setBackup(BackupConfig backup) {
         this.backup = backup;
     }
 
+    /**
+     * ClusterVersionPollInterval is a string duration indicating how much time must pass before checking whether we need to update the hive.openshift.io/version&#42; labels on ClusterDeployment. If zero or unset, we'll only reconcile when the ClusterDeployment changes.
+     */
     @JsonProperty("clusterVersionPollInterval")
     public String getClusterVersionPollInterval() {
         return clusterVersionPollInterval;
     }
 
+    /**
+     * ClusterVersionPollInterval is a string duration indicating how much time must pass before checking whether we need to update the hive.openshift.io/version&#42; labels on ClusterDeployment. If zero or unset, we'll only reconcile when the ClusterDeployment changes.
+     */
     @JsonProperty("clusterVersionPollInterval")
     public void setClusterVersionPollInterval(String clusterVersionPollInterval) {
         this.clusterVersionPollInterval = clusterVersionPollInterval;
     }
 
+    /**
+     * HiveConfigSpec defines the desired state of Hive
+     */
     @JsonProperty("controllersConfig")
     public ControllersConfig getControllersConfig() {
         return controllersConfig;
     }
 
+    /**
+     * HiveConfigSpec defines the desired state of Hive
+     */
     @JsonProperty("controllersConfig")
     public void setControllersConfig(ControllersConfig controllersConfig) {
         this.controllersConfig = controllersConfig;
     }
 
+    /**
+     * DeleteProtection can be set to "enabled" to turn on automatic delete protection for ClusterDeployments. When enabled, Hive will add the "hive.openshift.io/protected-delete" annotation to new ClusterDeployments. Once a ClusterDeployment has been installed, a user must remove the annotation from a ClusterDeployment prior to deleting it.
+     */
     @JsonProperty("deleteProtection")
     public String getDeleteProtection() {
         return deleteProtection;
     }
 
+    /**
+     * DeleteProtection can be set to "enabled" to turn on automatic delete protection for ClusterDeployments. When enabled, Hive will add the "hive.openshift.io/protected-delete" annotation to new ClusterDeployments. Once a ClusterDeployment has been installed, a user must remove the annotation from a ClusterDeployment prior to deleting it.
+     */
     @JsonProperty("deleteProtection")
     public void setDeleteProtection(String deleteProtection) {
         this.deleteProtection = deleteProtection;
     }
 
+    /**
+     * DeploymentConfig is used to configure (pods/containers of) the Deployments generated by hive-operator.
+     */
     @JsonProperty("deploymentConfig")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DeploymentConfig> getDeploymentConfig() {
         return deploymentConfig;
     }
 
+    /**
+     * DeploymentConfig is used to configure (pods/containers of) the Deployments generated by hive-operator.
+     */
     @JsonProperty("deploymentConfig")
     public void setDeploymentConfig(List<DeploymentConfig> deploymentConfig) {
         this.deploymentConfig = deploymentConfig;
     }
 
+    /**
+     * DeprovisionsDisabled can be set to true to block deprovision jobs from running.
+     */
     @JsonProperty("deprovisionsDisabled")
     public Boolean getDeprovisionsDisabled() {
         return deprovisionsDisabled;
     }
 
+    /**
+     * DeprovisionsDisabled can be set to true to block deprovision jobs from running.
+     */
     @JsonProperty("deprovisionsDisabled")
     public void setDeprovisionsDisabled(Boolean deprovisionsDisabled) {
         this.deprovisionsDisabled = deprovisionsDisabled;
     }
 
+    /**
+     * DisabledControllers allows selectively disabling Hive controllers by name. The name of an individual controller matches the name of the controller as seen in the Hive logging output.
+     */
     @JsonProperty("disabledControllers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDisabledControllers() {
         return disabledControllers;
     }
 
+    /**
+     * DisabledControllers allows selectively disabling Hive controllers by name. The name of an individual controller matches the name of the controller as seen in the Hive logging output.
+     */
     @JsonProperty("disabledControllers")
     public void setDisabledControllers(List<String> disabledControllers) {
         this.disabledControllers = disabledControllers;
     }
 
+    /**
+     * ExportMetrics has been disabled and has no effect. If upgrading from a version where it was active, please be aware of the following in your HiveConfig.Spec.TargetNamespace (default `hive` if unset): 1) ServiceMonitors named hive-controllers and hive-clustersync; 2) Role and RoleBinding named prometheus-k8s; 3) The `openshift.io/cluster-monitoring` metadata.label on the Namespace itself. You may wish to delete these resources. Or you may wish to continue using them to enable monitoring in your environment; but be aware that hive will no longer reconcile them.
+     */
     @JsonProperty("exportMetrics")
     public Boolean getExportMetrics() {
         return exportMetrics;
     }
 
+    /**
+     * ExportMetrics has been disabled and has no effect. If upgrading from a version where it was active, please be aware of the following in your HiveConfig.Spec.TargetNamespace (default `hive` if unset): 1) ServiceMonitors named hive-controllers and hive-clustersync; 2) Role and RoleBinding named prometheus-k8s; 3) The `openshift.io/cluster-monitoring` metadata.label on the Namespace itself. You may wish to delete these resources. Or you may wish to continue using them to enable monitoring in your environment; but be aware that hive will no longer reconcile them.
+     */
     @JsonProperty("exportMetrics")
     public void setExportMetrics(Boolean exportMetrics) {
         this.exportMetrics = exportMetrics;
     }
 
+    /**
+     * HiveConfigSpec defines the desired state of Hive
+     */
     @JsonProperty("failedProvisionConfig")
     public FailedProvisionConfig getFailedProvisionConfig() {
         return failedProvisionConfig;
     }
 
+    /**
+     * HiveConfigSpec defines the desired state of Hive
+     */
     @JsonProperty("failedProvisionConfig")
     public void setFailedProvisionConfig(FailedProvisionConfig failedProvisionConfig) {
         this.failedProvisionConfig = failedProvisionConfig;
     }
 
+    /**
+     * HiveConfigSpec defines the desired state of Hive
+     */
     @JsonProperty("featureGates")
     public FeatureGateSelection getFeatureGates() {
         return featureGates;
     }
 
+    /**
+     * HiveConfigSpec defines the desired state of Hive
+     */
     @JsonProperty("featureGates")
     public void setFeatureGates(FeatureGateSelection featureGates) {
         this.featureGates = featureGates;
     }
 
+    /**
+     * HiveConfigSpec defines the desired state of Hive
+     */
     @JsonProperty("globalPullSecretRef")
     public LocalObjectReference getGlobalPullSecretRef() {
         return globalPullSecretRef;
     }
 
+    /**
+     * HiveConfigSpec defines the desired state of Hive
+     */
     @JsonProperty("globalPullSecretRef")
     public void setGlobalPullSecretRef(LocalObjectReference globalPullSecretRef) {
         this.globalPullSecretRef = globalPullSecretRef;
     }
 
+    /**
+     * LogLevel is the level of logging to use for the Hive controllers. Acceptable levels, from coarsest to finest, are panic, fatal, error, warn, info, debug, and trace. The default level is info.
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * LogLevel is the level of logging to use for the Hive controllers. Acceptable levels, from coarsest to finest, are panic, fatal, error, warn, info, debug, and trace. The default level is info.
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * MachinePoolPollInterval is a string duration indicating how much time must pass before checking whether remote resources related to MachinePools need to be reapplied. Set to zero to disable polling -- we'll only reconcile when hub objects change. The default interval is 30m.
+     */
     @JsonProperty("machinePoolPollInterval")
     public String getMachinePoolPollInterval() {
         return machinePoolPollInterval;
     }
 
+    /**
+     * MachinePoolPollInterval is a string duration indicating how much time must pass before checking whether remote resources related to MachinePools need to be reapplied. Set to zero to disable polling -- we'll only reconcile when hub objects change. The default interval is 30m.
+     */
     @JsonProperty("machinePoolPollInterval")
     public void setMachinePoolPollInterval(String machinePoolPollInterval) {
         this.machinePoolPollInterval = machinePoolPollInterval;
     }
 
+    /**
+     * MaintenanceMode can be set to true to disable the hive controllers in situations where we need to ensure nothing is running that will add or act upon finalizers on Hive types. This should rarely be needed. Sets replicas to 0 for the hive-controllers deployment to accomplish this.
+     */
     @JsonProperty("maintenanceMode")
     public Boolean getMaintenanceMode() {
         return maintenanceMode;
     }
 
+    /**
+     * MaintenanceMode can be set to true to disable the hive controllers in situations where we need to ensure nothing is running that will add or act upon finalizers on Hive types. This should rarely be needed. Sets replicas to 0 for the hive-controllers deployment to accomplish this.
+     */
     @JsonProperty("maintenanceMode")
     public void setMaintenanceMode(Boolean maintenanceMode) {
         this.maintenanceMode = maintenanceMode;
     }
 
+    /**
+     * ManagedDomains is the list of DNS domains that are managed by the Hive cluster When specifying 'manageDNS: true' in a ClusterDeployment, the ClusterDeployment's baseDomain should be a direct child of one of these domains, otherwise the ClusterDeployment creation will result in a validation error.
+     */
     @JsonProperty("managedDomains")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ManageDNSConfig> getManagedDomains() {
         return managedDomains;
     }
 
+    /**
+     * ManagedDomains is the list of DNS domains that are managed by the Hive cluster When specifying 'manageDNS: true' in a ClusterDeployment, the ClusterDeployment's baseDomain should be a direct child of one of these domains, otherwise the ClusterDeployment creation will result in a validation error.
+     */
     @JsonProperty("managedDomains")
     public void setManagedDomains(List<ManageDNSConfig> managedDomains) {
         this.managedDomains = managedDomains;
     }
 
+    /**
+     * HiveConfigSpec defines the desired state of Hive
+     */
     @JsonProperty("metricsConfig")
     public MetricsConfig getMetricsConfig() {
         return metricsConfig;
     }
 
+    /**
+     * HiveConfigSpec defines the desired state of Hive
+     */
     @JsonProperty("metricsConfig")
     public void setMetricsConfig(MetricsConfig metricsConfig) {
         this.metricsConfig = metricsConfig;
     }
 
+    /**
+     * HiveConfigSpec defines the desired state of Hive
+     */
     @JsonProperty("privateLink")
     public PrivateLinkConfig getPrivateLink() {
         return privateLink;
     }
 
+    /**
+     * HiveConfigSpec defines the desired state of Hive
+     */
     @JsonProperty("privateLink")
     public void setPrivateLink(PrivateLinkConfig privateLink) {
         this.privateLink = privateLink;
     }
 
+    /**
+     * HiveConfigSpec defines the desired state of Hive
+     */
     @JsonProperty("releaseImageVerificationConfigMapRef")
     public ReleaseImageVerificationConfigMapReference getReleaseImageVerificationConfigMapRef() {
         return releaseImageVerificationConfigMapRef;
     }
 
+    /**
+     * HiveConfigSpec defines the desired state of Hive
+     */
     @JsonProperty("releaseImageVerificationConfigMapRef")
     public void setReleaseImageVerificationConfigMapRef(ReleaseImageVerificationConfigMapReference releaseImageVerificationConfigMapRef) {
         this.releaseImageVerificationConfigMapRef = releaseImageVerificationConfigMapRef;
     }
 
+    /**
+     * HiveConfigSpec defines the desired state of Hive
+     */
     @JsonProperty("serviceProviderCredentialsConfig")
     public ServiceProviderCredentials getServiceProviderCredentialsConfig() {
         return serviceProviderCredentialsConfig;
     }
 
+    /**
+     * HiveConfigSpec defines the desired state of Hive
+     */
     @JsonProperty("serviceProviderCredentialsConfig")
     public void setServiceProviderCredentialsConfig(ServiceProviderCredentials serviceProviderCredentialsConfig) {
         this.serviceProviderCredentialsConfig = serviceProviderCredentialsConfig;
     }
 
+    /**
+     * SyncSetReapplyInterval is a string duration indicating how much time must pass before SyncSet resources will be reapplied. The default reapply interval is two hours.
+     */
     @JsonProperty("syncSetReapplyInterval")
     public String getSyncSetReapplyInterval() {
         return syncSetReapplyInterval;
     }
 
+    /**
+     * SyncSetReapplyInterval is a string duration indicating how much time must pass before SyncSet resources will be reapplied. The default reapply interval is two hours.
+     */
     @JsonProperty("syncSetReapplyInterval")
     public void setSyncSetReapplyInterval(String syncSetReapplyInterval) {
         this.syncSetReapplyInterval = syncSetReapplyInterval;
     }
 
+    /**
+     * TargetNamespace is the namespace where the core Hive components should be run. Defaults to "hive". Will be created if it does not already exist. All resource references in HiveConfig can be assumed to be in the TargetNamespace. NOTE: Whereas it is possible to edit this value, causing hive to "move" its core components to the new namespace, the old namespace is not deleted, as it will still contain resources created by kubernetes and/or other OpenShift controllers.
+     */
     @JsonProperty("targetNamespace")
     public String getTargetNamespace() {
         return targetNamespace;
     }
 
+    /**
+     * TargetNamespace is the namespace where the core Hive components should be run. Defaults to "hive". Will be created if it does not already exist. All resource references in HiveConfig can be assumed to be in the TargetNamespace. NOTE: Whereas it is possible to edit this value, causing hive to "move" its core components to the new namespace, the old namespace is not deleted, as it will still contain resources created by kubernetes and/or other OpenShift controllers.
+     */
     @JsonProperty("targetNamespace")
     public void setTargetNamespace(String targetNamespace) {
         this.targetNamespace = targetNamespace;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/HiveConfigStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/HiveConfigStatus.java
index 0b3a782a4bb..4bad905666e 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/HiveConfigStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/HiveConfigStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HiveConfigStatus defines the observed state of Hive
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public HiveConfigStatus(String aggregatorClientCAHash, List<HiveConfigCondition>
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * AggregatorClientCAHash keeps an md5 hash of the aggregator client CA configmap data from the openshift-config-managed namespace. When the configmap changes, admission is redeployed.
+     */
     @JsonProperty("aggregatorClientCAHash")
     public String getAggregatorClientCAHash() {
         return aggregatorClientCAHash;
     }
 
+    /**
+     * AggregatorClientCAHash keeps an md5 hash of the aggregator client CA configmap data from the openshift-config-managed namespace. When the configmap changes, admission is redeployed.
+     */
     @JsonProperty("aggregatorClientCAHash")
     public void setAggregatorClientCAHash(String aggregatorClientCAHash) {
         this.aggregatorClientCAHash = aggregatorClientCAHash;
     }
 
+    /**
+     * Conditions includes more detailed status for the HiveConfig
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HiveConfigCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions includes more detailed status for the HiveConfig
+     */
     @JsonProperty("conditions")
     public void setConditions(List<HiveConfigCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ConfigApplied will be set by the hive operator to indicate whether or not the LastGenerationObserved was successfully reconciled.
+     */
     @JsonProperty("configApplied")
     public Boolean getConfigApplied() {
         return configApplied;
     }
 
+    /**
+     * ConfigApplied will be set by the hive operator to indicate whether or not the LastGenerationObserved was successfully reconciled.
+     */
     @JsonProperty("configApplied")
     public void setConfigApplied(Boolean configApplied) {
         this.configApplied = configApplied;
     }
 
+    /**
+     * ObservedGeneration will record the most recently processed HiveConfig object's generation.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration will record the most recently processed HiveConfig object's generation.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/IBMClusterDeprovision.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/IBMClusterDeprovision.java
index fc5153b50fa..104676b7832 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/IBMClusterDeprovision.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/IBMClusterDeprovision.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IBMClusterDeprovision contains IBM Cloud specific configuration for a ClusterDeprovision
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public IBMClusterDeprovision(String baseDomain, LocalObjectReference credentials
         this.region = region;
     }
 
+    /**
+     * BaseDomain is the DNS base domain.
+     */
     @JsonProperty("baseDomain")
     public String getBaseDomain() {
         return baseDomain;
     }
 
+    /**
+     * BaseDomain is the DNS base domain.
+     */
     @JsonProperty("baseDomain")
     public void setBaseDomain(String baseDomain) {
         this.baseDomain = baseDomain;
     }
 
+    /**
+     * IBMClusterDeprovision contains IBM Cloud specific configuration for a ClusterDeprovision
+     */
     @JsonProperty("credentialsSecretRef")
     public LocalObjectReference getCredentialsSecretRef() {
         return credentialsSecretRef;
     }
 
+    /**
+     * IBMClusterDeprovision contains IBM Cloud specific configuration for a ClusterDeprovision
+     */
     @JsonProperty("credentialsSecretRef")
     public void setCredentialsSecretRef(LocalObjectReference credentialsSecretRef) {
         this.credentialsSecretRef = credentialsSecretRef;
     }
 
+    /**
+     * Region specifies the IBM Cloud region
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Region specifies the IBM Cloud region
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/IdentityProviderStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/IdentityProviderStatus.java
index d81f9a9994a..90760f59a86 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/IdentityProviderStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/IdentityProviderStatus.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IdentityProviderStatus defines the observed state of SyncSet
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/InventoryEntry.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/InventoryEntry.java
index e7ac5a96ec3..d76bb6ecf69 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/InventoryEntry.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/InventoryEntry.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * InventoryEntry maintains a reference to a custom resource consumed by a clusterpool to customize the cluster deployment.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public InventoryEntry(String kind, String name) {
         this.name = name;
     }
 
+    /**
+     * Kind denotes the kind of the referenced resource. The default is ClusterDeploymentCustomization, which is also currently the only supported value.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind denotes the kind of the referenced resource. The default is ClusterDeploymentCustomization, which is also currently the only supported value.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of the referenced resource.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the referenced resource.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/KubeconfigSecretReference.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/KubeconfigSecretReference.java
index d0e511356a1..b8c80a490ea 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/KubeconfigSecretReference.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/KubeconfigSecretReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KubeconfigSecretReference is a reference to a secret containing the kubeconfig for a remote cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public KubeconfigSecretReference(String name, String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Name is the name of the secret.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the secret.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace is the namespace where the secret lives.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace where the secret lives.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePool.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePool.java
index 7d4273e473e..7b2b92b94c9 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePool.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePool.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePool is the Schema for the machinepools API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class MachinePool implements Editable<MachinePoolBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MachinePool";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public MachinePool(String apiVersion, String kind, ObjectMeta metadata, MachineP
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MachinePool is the Schema for the machinepools API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MachinePool is the Schema for the machinepools API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * MachinePool is the Schema for the machinepools API
+     */
     @JsonProperty("spec")
     public MachinePoolSpec getSpec() {
         return spec;
     }
 
+    /**
+     * MachinePool is the Schema for the machinepools API
+     */
     @JsonProperty("spec")
     public void setSpec(MachinePoolSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * MachinePool is the Schema for the machinepools API
+     */
     @JsonProperty("status")
     public MachinePoolStatus getStatus() {
         return status;
     }
 
+    /**
+     * MachinePool is the Schema for the machinepools API
+     */
     @JsonProperty("status")
     public void setStatus(MachinePoolStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolAutoscaling.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolAutoscaling.java
index 52985c7765b..d7ef29aaf8d 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolAutoscaling.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolAutoscaling.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePoolAutoscaling details how the machine pool is to be auto-scaled.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public MachinePoolAutoscaling(Integer maxReplicas, Integer minReplicas) {
         this.minReplicas = minReplicas;
     }
 
+    /**
+     * MaxReplicas is the maximum number of replicas for the machine pool.
+     */
     @JsonProperty("maxReplicas")
     public Integer getMaxReplicas() {
         return maxReplicas;
     }
 
+    /**
+     * MaxReplicas is the maximum number of replicas for the machine pool.
+     */
     @JsonProperty("maxReplicas")
     public void setMaxReplicas(Integer maxReplicas) {
         this.maxReplicas = maxReplicas;
     }
 
+    /**
+     * MinReplicas is the minimum number of replicas for the machine pool.
+     */
     @JsonProperty("minReplicas")
     public Integer getMinReplicas() {
         return minReplicas;
     }
 
+    /**
+     * MinReplicas is the minimum number of replicas for the machine pool.
+     */
     @JsonProperty("minReplicas")
     public void setMinReplicas(Integer minReplicas) {
         this.minReplicas = minReplicas;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolCondition.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolCondition.java
index f5f88a0c227..b3d1795b0e5 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolCondition.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePoolCondition contains details for the current condition of a machine pool
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public MachinePoolCondition(String lastProbeTime, String lastTransitionTime, Str
         this.type = type;
     }
 
+    /**
+     * MachinePoolCondition contains details for the current condition of a machine pool
+     */
     @JsonProperty("lastProbeTime")
     public String getLastProbeTime() {
         return lastProbeTime;
     }
 
+    /**
+     * MachinePoolCondition contains details for the current condition of a machine pool
+     */
     @JsonProperty("lastProbeTime")
     public void setLastProbeTime(String lastProbeTime) {
         this.lastProbeTime = lastProbeTime;
     }
 
+    /**
+     * MachinePoolCondition contains details for the current condition of a machine pool
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * MachinePoolCondition contains details for the current condition of a machine pool
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Message is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Reason is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status is the status of the condition.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status is the status of the condition.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type is the type of the condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of the condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolList.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolList.java
index 88cb1e421e4..3b3f3227036 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolList.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePoolList contains a list of MachinePool
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class MachinePoolList implements Editable<MachinePoolListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.hive.v1.MachinePool>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.hive.v1.MachinePool> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MachinePoolList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public MachinePoolList(String apiVersion, List<io.fabric8.openshift.api.model.hi
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * MachinePoolList contains a list of MachinePool
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.hive.v1.MachinePool> getItems() {
         return items;
     }
 
+    /**
+     * MachinePoolList contains a list of MachinePool
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.hive.v1.MachinePool> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MachinePoolList contains a list of MachinePool
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MachinePoolList contains a list of MachinePool
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolNameLease.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolNameLease.java
index 6c580c0b97f..608505e092c 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolNameLease.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolNameLease.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePoolNameLease is the Schema for the MachinePoolNameLeases API. This resource is mostly empty as we're primarily relying on the name to determine if a lease is available. Note that not all cloud providers require the use of a lease for naming, at present this is only required for GCP where we're extremely restricted on name lengths.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class MachinePoolNameLease implements Editable<MachinePoolNameLeaseBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MachinePoolNameLease";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public MachinePoolNameLease(String apiVersion, String kind, ObjectMeta metadata,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MachinePoolNameLease is the Schema for the MachinePoolNameLeases API. This resource is mostly empty as we're primarily relying on the name to determine if a lease is available. Note that not all cloud providers require the use of a lease for naming, at present this is only required for GCP where we're extremely restricted on name lengths.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MachinePoolNameLease is the Schema for the MachinePoolNameLeases API. This resource is mostly empty as we're primarily relying on the name to determine if a lease is available. Note that not all cloud providers require the use of a lease for naming, at present this is only required for GCP where we're extremely restricted on name lengths.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * MachinePoolNameLease is the Schema for the MachinePoolNameLeases API. This resource is mostly empty as we're primarily relying on the name to determine if a lease is available. Note that not all cloud providers require the use of a lease for naming, at present this is only required for GCP where we're extremely restricted on name lengths.
+     */
     @JsonProperty("spec")
     public MachinePoolNameLeaseSpec getSpec() {
         return spec;
     }
 
+    /**
+     * MachinePoolNameLease is the Schema for the MachinePoolNameLeases API. This resource is mostly empty as we're primarily relying on the name to determine if a lease is available. Note that not all cloud providers require the use of a lease for naming, at present this is only required for GCP where we're extremely restricted on name lengths.
+     */
     @JsonProperty("spec")
     public void setSpec(MachinePoolNameLeaseSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * MachinePoolNameLease is the Schema for the MachinePoolNameLeases API. This resource is mostly empty as we're primarily relying on the name to determine if a lease is available. Note that not all cloud providers require the use of a lease for naming, at present this is only required for GCP where we're extremely restricted on name lengths.
+     */
     @JsonProperty("status")
     public MachinePoolNameLeaseStatus getStatus() {
         return status;
     }
 
+    /**
+     * MachinePoolNameLease is the Schema for the MachinePoolNameLeases API. This resource is mostly empty as we're primarily relying on the name to determine if a lease is available. Note that not all cloud providers require the use of a lease for naming, at present this is only required for GCP where we're extremely restricted on name lengths.
+     */
     @JsonProperty("status")
     public void setStatus(MachinePoolNameLeaseStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolNameLeaseList.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolNameLeaseList.java
index bfc7523483d..b83bc4e0b8b 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolNameLeaseList.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolNameLeaseList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePoolNameLeaseList contains a list of MachinePoolNameLeases.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class MachinePoolNameLeaseList implements Editable<MachinePoolNameLeaseListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.hive.v1.MachinePoolNameLease>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.hive.v1.MachinePoolNameLease> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MachinePoolNameLeaseList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public MachinePoolNameLeaseList(String apiVersion, List<io.fabric8.openshift.api
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * MachinePoolNameLeaseList contains a list of MachinePoolNameLeases.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.hive.v1.MachinePoolNameLease> getItems() {
         return items;
     }
 
+    /**
+     * MachinePoolNameLeaseList contains a list of MachinePoolNameLeases.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.hive.v1.MachinePoolNameLease> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MachinePoolNameLeaseList contains a list of MachinePoolNameLeases.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MachinePoolNameLeaseList contains a list of MachinePoolNameLeases.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolNameLeaseSpec.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolNameLeaseSpec.java
index d31bcb0e3c7..d81cf7c06e5 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolNameLeaseSpec.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolNameLeaseSpec.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePoolNameLeaseSpec is a minimal resource for obtaining unique machine pool names of a limited length.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolNameLeaseStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolNameLeaseStatus.java
index 755f2826615..3ae134f118c 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolNameLeaseStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolNameLeaseStatus.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePoolNameLeaseStatus defines the observed state of MachinePoolNameLease.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolPlatform.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolPlatform.java
index a5ed65f582b..c8382361a16 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolPlatform.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolPlatform.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -103,71 +106,113 @@ public MachinePoolPlatform(io.fabric8.openshift.api.model.hive.aws.v1.MachinePoo
         this.vsphere = vsphere;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("aws")
     public io.fabric8.openshift.api.model.hive.aws.v1.MachinePoolPlatform getAws() {
         return aws;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("aws")
     public void setAws(io.fabric8.openshift.api.model.hive.aws.v1.MachinePoolPlatform aws) {
         this.aws = aws;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("azure")
     public MachinePool getAzure() {
         return azure;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("azure")
     public void setAzure(MachinePool azure) {
         this.azure = azure;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("gcp")
     public io.fabric8.openshift.api.model.hive.gcp.v1.MachinePool getGcp() {
         return gcp;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("gcp")
     public void setGcp(io.fabric8.openshift.api.model.hive.gcp.v1.MachinePool gcp) {
         this.gcp = gcp;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("ibmcloud")
     public io.fabric8.openshift.api.model.hive.ibmcloud.v1.MachinePool getIbmcloud() {
         return ibmcloud;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("ibmcloud")
     public void setIbmcloud(io.fabric8.openshift.api.model.hive.ibmcloud.v1.MachinePool ibmcloud) {
         this.ibmcloud = ibmcloud;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("openstack")
     public io.fabric8.openshift.api.model.hive.openstack.v1.MachinePool getOpenstack() {
         return openstack;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("openstack")
     public void setOpenstack(io.fabric8.openshift.api.model.hive.openstack.v1.MachinePool openstack) {
         this.openstack = openstack;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("ovirt")
     public io.fabric8.openshift.api.model.hive.ovirt.v1.MachinePool getOvirt() {
         return ovirt;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("ovirt")
     public void setOvirt(io.fabric8.openshift.api.model.hive.ovirt.v1.MachinePool ovirt) {
         this.ovirt = ovirt;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("vsphere")
     public io.fabric8.openshift.api.model.hive.vsphere.v1.MachinePool getVsphere() {
         return vsphere;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("vsphere")
     public void setVsphere(io.fabric8.openshift.api.model.hive.vsphere.v1.MachinePool vsphere) {
         this.vsphere = vsphere;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolSpec.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolSpec.java
index 65abad9fad5..443b91e76f2 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolSpec.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePoolSpec defines the desired state of MachinePool
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -112,84 +115,132 @@ public MachinePoolSpec(MachinePoolAutoscaling autoscaling, LocalObjectReference
         this.taints = taints;
     }
 
+    /**
+     * MachinePoolSpec defines the desired state of MachinePool
+     */
     @JsonProperty("autoscaling")
     public MachinePoolAutoscaling getAutoscaling() {
         return autoscaling;
     }
 
+    /**
+     * MachinePoolSpec defines the desired state of MachinePool
+     */
     @JsonProperty("autoscaling")
     public void setAutoscaling(MachinePoolAutoscaling autoscaling) {
         this.autoscaling = autoscaling;
     }
 
+    /**
+     * MachinePoolSpec defines the desired state of MachinePool
+     */
     @JsonProperty("clusterDeploymentRef")
     public LocalObjectReference getClusterDeploymentRef() {
         return clusterDeploymentRef;
     }
 
+    /**
+     * MachinePoolSpec defines the desired state of MachinePool
+     */
     @JsonProperty("clusterDeploymentRef")
     public void setClusterDeploymentRef(LocalObjectReference clusterDeploymentRef) {
         this.clusterDeploymentRef = clusterDeploymentRef;
     }
 
+    /**
+     * Map of label string keys and values that will be applied to the created MachineSet's MachineSpec. This affects the labels that will end up on the &#42;Nodes&#42; (in contrast with the MachineLabels field). This list will overwrite any modifications made to Node labels on an ongoing basis.
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabels() {
         return labels;
     }
 
+    /**
+     * Map of label string keys and values that will be applied to the created MachineSet's MachineSpec. This affects the labels that will end up on the &#42;Nodes&#42; (in contrast with the MachineLabels field). This list will overwrite any modifications made to Node labels on an ongoing basis.
+     */
     @JsonProperty("labels")
     public void setLabels(Map<String, String> labels) {
         this.labels = labels;
     }
 
+    /**
+     * Map of label string keys and values that will be applied to the created MachineSet's MachineTemplateSpec. This affects the labels that will end up on the &#42;Machines&#42; (in contrast with the Labels field). This list will overwrite any modifications made to Machine labels on an ongoing basis. Note: We ignore entries that conflict with generated labels.
+     */
     @JsonProperty("machineLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getMachineLabels() {
         return machineLabels;
     }
 
+    /**
+     * Map of label string keys and values that will be applied to the created MachineSet's MachineTemplateSpec. This affects the labels that will end up on the &#42;Machines&#42; (in contrast with the Labels field). This list will overwrite any modifications made to Machine labels on an ongoing basis. Note: We ignore entries that conflict with generated labels.
+     */
     @JsonProperty("machineLabels")
     public void setMachineLabels(Map<String, String> machineLabels) {
         this.machineLabels = machineLabels;
     }
 
+    /**
+     * Name is the name of the machine pool.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the machine pool.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * MachinePoolSpec defines the desired state of MachinePool
+     */
     @JsonProperty("platform")
     public MachinePoolPlatform getPlatform() {
         return platform;
     }
 
+    /**
+     * MachinePoolSpec defines the desired state of MachinePool
+     */
     @JsonProperty("platform")
     public void setPlatform(MachinePoolPlatform platform) {
         this.platform = platform;
     }
 
+    /**
+     * Replicas is the count of machines for this machine pool. Replicas and autoscaling cannot be used together. Default is 1, if autoscaling is not used.
+     */
     @JsonProperty("replicas")
     public Long getReplicas() {
         return replicas;
     }
 
+    /**
+     * Replicas is the count of machines for this machine pool. Replicas and autoscaling cannot be used together. Default is 1, if autoscaling is not used.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Long replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * List of taints that will be applied to the created MachineSet's MachineSpec. This list will overwrite any modifications made to Node taints on an ongoing basis. In case of duplicate entries, first encountered taint Value will be preserved, and the rest collapsed on the corresponding MachineSets. Note that taints are uniquely identified based on key+effect, not just key.
+     */
     @JsonProperty("taints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Taint> getTaints() {
         return taints;
     }
 
+    /**
+     * List of taints that will be applied to the created MachineSet's MachineSpec. This list will overwrite any modifications made to Node taints on an ongoing basis. In case of duplicate entries, first encountered taint Value will be preserved, and the rest collapsed on the corresponding MachineSets. Note that taints are uniquely identified based on key+effect, not just key.
+     */
     @JsonProperty("taints")
     public void setTaints(List<Taint> taints) {
         this.taints = taints;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolStatus.java
index 6dc4a944294..73926d09212 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachinePoolStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePoolStatus defines the observed state of MachinePool
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -109,76 +112,118 @@ public MachinePoolStatus(List<MachinePoolCondition> conditions, Long controlledB
         this.replicas = replicas;
     }
 
+    /**
+     * Conditions includes more detailed status for the cluster deployment
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MachinePoolCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions includes more detailed status for the cluster deployment
+     */
     @JsonProperty("conditions")
     public void setConditions(List<MachinePoolCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ControlledByReplica indicates which replica of the hive-machinepool StatefulSet is responsible for this MachinePool. Note that this value indicates the replica that most recently handled the MachinePool. If the hive-machinepool statefulset is scaled up or down, the controlling replica can change, potentially causing logs to be spread across multiple pods.
+     */
     @JsonProperty("controlledByReplica")
     public Long getControlledByReplica() {
         return controlledByReplica;
     }
 
+    /**
+     * ControlledByReplica indicates which replica of the hive-machinepool StatefulSet is responsible for this MachinePool. Note that this value indicates the replica that most recently handled the MachinePool. If the hive-machinepool statefulset is scaled up or down, the controlling replica can change, potentially causing logs to be spread across multiple pods.
+     */
     @JsonProperty("controlledByReplica")
     public void setControlledByReplica(Long controlledByReplica) {
         this.controlledByReplica = controlledByReplica;
     }
 
+    /**
+     * MachineSets is the status of the machine sets for the machine pool on the remote cluster.
+     */
     @JsonProperty("machineSets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MachineSetStatus> getMachineSets() {
         return machineSets;
     }
 
+    /**
+     * MachineSets is the status of the machine sets for the machine pool on the remote cluster.
+     */
     @JsonProperty("machineSets")
     public void setMachineSets(List<MachineSetStatus> machineSets) {
         this.machineSets = machineSets;
     }
 
+    /**
+     * OwnedLabels lists the keys of labels this MachinePool created on the remote MachineSet's MachineSpec. (In contrast with OwnedMachineLabels.) Used to identify labels to remove from the remote MachineSet when they are absent from the MachinePool's spec.labels.
+     */
     @JsonProperty("ownedLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getOwnedLabels() {
         return ownedLabels;
     }
 
+    /**
+     * OwnedLabels lists the keys of labels this MachinePool created on the remote MachineSet's MachineSpec. (In contrast with OwnedMachineLabels.) Used to identify labels to remove from the remote MachineSet when they are absent from the MachinePool's spec.labels.
+     */
     @JsonProperty("ownedLabels")
     public void setOwnedLabels(List<String> ownedLabels) {
         this.ownedLabels = ownedLabels;
     }
 
+    /**
+     * OwnedMachineLabels lists the keys of labels this MachinePool created on the remote MachineSet's MachineTemplateSpec. (In contrast with OwnedLabels.) Used to identify labels to remove from the remote MachineSet when they are absent from the MachinePool's spec.machineLabels.
+     */
     @JsonProperty("ownedMachineLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getOwnedMachineLabels() {
         return ownedMachineLabels;
     }
 
+    /**
+     * OwnedMachineLabels lists the keys of labels this MachinePool created on the remote MachineSet's MachineTemplateSpec. (In contrast with OwnedLabels.) Used to identify labels to remove from the remote MachineSet when they are absent from the MachinePool's spec.machineLabels.
+     */
     @JsonProperty("ownedMachineLabels")
     public void setOwnedMachineLabels(List<String> ownedMachineLabels) {
         this.ownedMachineLabels = ownedMachineLabels;
     }
 
+    /**
+     * OwnedTaints lists identifiers of taints this MachinePool created on the remote MachineSet. Used to identify taints to remove from the remote MachineSet when they are absent from the MachinePool's spec.taints.
+     */
     @JsonProperty("ownedTaints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TaintIdentifier> getOwnedTaints() {
         return ownedTaints;
     }
 
+    /**
+     * OwnedTaints lists identifiers of taints this MachinePool created on the remote MachineSet. Used to identify taints to remove from the remote MachineSet when they are absent from the MachinePool's spec.taints.
+     */
     @JsonProperty("ownedTaints")
     public void setOwnedTaints(List<TaintIdentifier> ownedTaints) {
         this.ownedTaints = ownedTaints;
     }
 
+    /**
+     * Replicas is the current number of replicas for the machine pool.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Replicas is the current number of replicas for the machine pool.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachineSetStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachineSetStatus.java
index 9600b8309ae..adfd4bb4dea 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachineSetStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/MachineSetStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineSetStatus is the status of a machineset in the remote cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,71 +105,113 @@ public MachineSetStatus(String errorMessage, String errorReason, Integer maxRepl
         this.replicas = replicas;
     }
 
+    /**
+     * MachineSetStatus is the status of a machineset in the remote cluster.
+     */
     @JsonProperty("errorMessage")
     public String getErrorMessage() {
         return errorMessage;
     }
 
+    /**
+     * MachineSetStatus is the status of a machineset in the remote cluster.
+     */
     @JsonProperty("errorMessage")
     public void setErrorMessage(String errorMessage) {
         this.errorMessage = errorMessage;
     }
 
+    /**
+     * In the event that there is a terminal problem reconciling the replicas, both ErrorReason and ErrorMessage will be set. ErrorReason will be populated with a succinct value suitable for machine interpretation, while ErrorMessage will contain a more verbose string suitable for logging and human consumption.
+     */
     @JsonProperty("errorReason")
     public String getErrorReason() {
         return errorReason;
     }
 
+    /**
+     * In the event that there is a terminal problem reconciling the replicas, both ErrorReason and ErrorMessage will be set. ErrorReason will be populated with a succinct value suitable for machine interpretation, while ErrorMessage will contain a more verbose string suitable for logging and human consumption.
+     */
     @JsonProperty("errorReason")
     public void setErrorReason(String errorReason) {
         this.errorReason = errorReason;
     }
 
+    /**
+     * MaxReplicas is the maximum number of replicas for the machine set.
+     */
     @JsonProperty("maxReplicas")
     public Integer getMaxReplicas() {
         return maxReplicas;
     }
 
+    /**
+     * MaxReplicas is the maximum number of replicas for the machine set.
+     */
     @JsonProperty("maxReplicas")
     public void setMaxReplicas(Integer maxReplicas) {
         this.maxReplicas = maxReplicas;
     }
 
+    /**
+     * MinReplicas is the minimum number of replicas for the machine set.
+     */
     @JsonProperty("minReplicas")
     public Integer getMinReplicas() {
         return minReplicas;
     }
 
+    /**
+     * MinReplicas is the minimum number of replicas for the machine set.
+     */
     @JsonProperty("minReplicas")
     public void setMinReplicas(Integer minReplicas) {
         this.minReplicas = minReplicas;
     }
 
+    /**
+     * Name is the name of the machine set.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the machine set.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * The number of ready replicas for this MachineSet. A machine is considered ready when the node has been created and is "Ready". It is transferred as-is from the MachineSet from remote cluster.
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * The number of ready replicas for this MachineSet. A machine is considered ready when the node has been created and is "Ready". It is transferred as-is from the MachineSet from remote cluster.
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * Replicas is the current number of replicas for the machine set.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Replicas is the current number of replicas for the machine set.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ManageDNSAWSConfig.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ManageDNSAWSConfig.java
index 5ae80d2c62b..aad5f1c60e3 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ManageDNSAWSConfig.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ManageDNSAWSConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ManageDNSAWSConfig contains AWS-specific info to manage a given domain.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ManageDNSAWSConfig(LocalObjectReference credentialsSecretRef, String regi
         this.region = region;
     }
 
+    /**
+     * ManageDNSAWSConfig contains AWS-specific info to manage a given domain.
+     */
     @JsonProperty("credentialsSecretRef")
     public LocalObjectReference getCredentialsSecretRef() {
         return credentialsSecretRef;
     }
 
+    /**
+     * ManageDNSAWSConfig contains AWS-specific info to manage a given domain.
+     */
     @JsonProperty("credentialsSecretRef")
     public void setCredentialsSecretRef(LocalObjectReference credentialsSecretRef) {
         this.credentialsSecretRef = credentialsSecretRef;
     }
 
+    /**
+     * Region is the AWS region to use for route53 operations. This defaults to us-east-1. For AWS China, use cn-northwest-1.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Region is the AWS region to use for route53 operations. This defaults to us-east-1. For AWS China, use cn-northwest-1.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ManageDNSAzureConfig.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ManageDNSAzureConfig.java
index fee502599ed..e502c43e230 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ManageDNSAzureConfig.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ManageDNSAzureConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ManageDNSAzureConfig contains Azure-specific info to manage a given domain
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ManageDNSAzureConfig(String cloudName, LocalObjectReference credentialsSe
         this.resourceGroupName = resourceGroupName;
     }
 
+    /**
+     * CloudName is the name of the Azure cloud environment which can be used to configure the Azure SDK with the appropriate Azure API endpoints. If empty, the value is equal to "AzurePublicCloud".
+     */
     @JsonProperty("cloudName")
     public String getCloudName() {
         return cloudName;
     }
 
+    /**
+     * CloudName is the name of the Azure cloud environment which can be used to configure the Azure SDK with the appropriate Azure API endpoints. If empty, the value is equal to "AzurePublicCloud".
+     */
     @JsonProperty("cloudName")
     public void setCloudName(String cloudName) {
         this.cloudName = cloudName;
     }
 
+    /**
+     * ManageDNSAzureConfig contains Azure-specific info to manage a given domain
+     */
     @JsonProperty("credentialsSecretRef")
     public LocalObjectReference getCredentialsSecretRef() {
         return credentialsSecretRef;
     }
 
+    /**
+     * ManageDNSAzureConfig contains Azure-specific info to manage a given domain
+     */
     @JsonProperty("credentialsSecretRef")
     public void setCredentialsSecretRef(LocalObjectReference credentialsSecretRef) {
         this.credentialsSecretRef = credentialsSecretRef;
     }
 
+    /**
+     * ResourceGroupName specifies the Azure resource group containing the DNS zones for the domains being managed.
+     */
     @JsonProperty("resourceGroupName")
     public String getResourceGroupName() {
         return resourceGroupName;
     }
 
+    /**
+     * ResourceGroupName specifies the Azure resource group containing the DNS zones for the domains being managed.
+     */
     @JsonProperty("resourceGroupName")
     public void setResourceGroupName(String resourceGroupName) {
         this.resourceGroupName = resourceGroupName;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ManageDNSConfig.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ManageDNSConfig.java
index ef8f05fc54e..e0246bb7b89 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ManageDNSConfig.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ManageDNSConfig.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ManageDNSConfig contains the domain being managed, and the cloud-specific details for accessing/managing the domain.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public ManageDNSConfig(ManageDNSAWSConfig aws, ManageDNSAzureConfig azure, List<
         this.gcp = gcp;
     }
 
+    /**
+     * ManageDNSConfig contains the domain being managed, and the cloud-specific details for accessing/managing the domain.
+     */
     @JsonProperty("aws")
     public ManageDNSAWSConfig getAws() {
         return aws;
     }
 
+    /**
+     * ManageDNSConfig contains the domain being managed, and the cloud-specific details for accessing/managing the domain.
+     */
     @JsonProperty("aws")
     public void setAws(ManageDNSAWSConfig aws) {
         this.aws = aws;
     }
 
+    /**
+     * ManageDNSConfig contains the domain being managed, and the cloud-specific details for accessing/managing the domain.
+     */
     @JsonProperty("azure")
     public ManageDNSAzureConfig getAzure() {
         return azure;
     }
 
+    /**
+     * ManageDNSConfig contains the domain being managed, and the cloud-specific details for accessing/managing the domain.
+     */
     @JsonProperty("azure")
     public void setAzure(ManageDNSAzureConfig azure) {
         this.azure = azure;
     }
 
+    /**
+     * Domains is the list of domains that hive will be managing entries for with the provided credentials.
+     */
     @JsonProperty("domains")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDomains() {
         return domains;
     }
 
+    /**
+     * Domains is the list of domains that hive will be managing entries for with the provided credentials.
+     */
     @JsonProperty("domains")
     public void setDomains(List<String> domains) {
         this.domains = domains;
     }
 
+    /**
+     * ManageDNSConfig contains the domain being managed, and the cloud-specific details for accessing/managing the domain.
+     */
     @JsonProperty("gcp")
     public ManageDNSGCPConfig getGcp() {
         return gcp;
     }
 
+    /**
+     * ManageDNSConfig contains the domain being managed, and the cloud-specific details for accessing/managing the domain.
+     */
     @JsonProperty("gcp")
     public void setGcp(ManageDNSGCPConfig gcp) {
         this.gcp = gcp;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ManageDNSGCPConfig.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ManageDNSGCPConfig.java
index 99864030eba..37f95dcdb32 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ManageDNSGCPConfig.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ManageDNSGCPConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ManageDNSGCPConfig contains GCP-specific info to manage a given domain.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ManageDNSGCPConfig(LocalObjectReference credentialsSecretRef) {
         this.credentialsSecretRef = credentialsSecretRef;
     }
 
+    /**
+     * ManageDNSGCPConfig contains GCP-specific info to manage a given domain.
+     */
     @JsonProperty("credentialsSecretRef")
     public LocalObjectReference getCredentialsSecretRef() {
         return credentialsSecretRef;
     }
 
+    /**
+     * ManageDNSGCPConfig contains GCP-specific info to manage a given domain.
+     */
     @JsonProperty("credentialsSecretRef")
     public void setCredentialsSecretRef(LocalObjectReference credentialsSecretRef) {
         this.credentialsSecretRef = credentialsSecretRef;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/OpenStackClusterDeprovision.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/OpenStackClusterDeprovision.java
index de09e429b15..f84f4ff06b6 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/OpenStackClusterDeprovision.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/OpenStackClusterDeprovision.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OpenStackClusterDeprovision contains OpenStack-specific configuration for a ClusterDeprovision
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public OpenStackClusterDeprovision(LocalObjectReference certificatesSecretRef, S
         this.credentialsSecretRef = credentialsSecretRef;
     }
 
+    /**
+     * OpenStackClusterDeprovision contains OpenStack-specific configuration for a ClusterDeprovision
+     */
     @JsonProperty("certificatesSecretRef")
     public LocalObjectReference getCertificatesSecretRef() {
         return certificatesSecretRef;
     }
 
+    /**
+     * OpenStackClusterDeprovision contains OpenStack-specific configuration for a ClusterDeprovision
+     */
     @JsonProperty("certificatesSecretRef")
     public void setCertificatesSecretRef(LocalObjectReference certificatesSecretRef) {
         this.certificatesSecretRef = certificatesSecretRef;
     }
 
+    /**
+     * Cloud is the secion in the clouds.yaml secret below to use for auth/connectivity.
+     */
     @JsonProperty("cloud")
     public String getCloud() {
         return cloud;
     }
 
+    /**
+     * Cloud is the secion in the clouds.yaml secret below to use for auth/connectivity.
+     */
     @JsonProperty("cloud")
     public void setCloud(String cloud) {
         this.cloud = cloud;
     }
 
+    /**
+     * OpenStackClusterDeprovision contains OpenStack-specific configuration for a ClusterDeprovision
+     */
     @JsonProperty("credentialsSecretRef")
     public LocalObjectReference getCredentialsSecretRef() {
         return credentialsSecretRef;
     }
 
+    /**
+     * OpenStackClusterDeprovision contains OpenStack-specific configuration for a ClusterDeprovision
+     */
     @JsonProperty("credentialsSecretRef")
     public void setCredentialsSecretRef(LocalObjectReference credentialsSecretRef) {
         this.credentialsSecretRef = credentialsSecretRef;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/OvirtClusterDeprovision.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/OvirtClusterDeprovision.java
index 9b1aa51f1fd..6c24269e3b6 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/OvirtClusterDeprovision.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/OvirtClusterDeprovision.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OvirtClusterDeprovision contains oVirt-specific configuration for a ClusterDeprovision
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public OvirtClusterDeprovision(LocalObjectReference certificatesSecretRef, Strin
         this.credentialsSecretRef = credentialsSecretRef;
     }
 
+    /**
+     * OvirtClusterDeprovision contains oVirt-specific configuration for a ClusterDeprovision
+     */
     @JsonProperty("certificatesSecretRef")
     public LocalObjectReference getCertificatesSecretRef() {
         return certificatesSecretRef;
     }
 
+    /**
+     * OvirtClusterDeprovision contains oVirt-specific configuration for a ClusterDeprovision
+     */
     @JsonProperty("certificatesSecretRef")
     public void setCertificatesSecretRef(LocalObjectReference certificatesSecretRef) {
         this.certificatesSecretRef = certificatesSecretRef;
     }
 
+    /**
+     * The oVirt cluster ID
+     */
     @JsonProperty("clusterID")
     public String getClusterID() {
         return clusterID;
     }
 
+    /**
+     * The oVirt cluster ID
+     */
     @JsonProperty("clusterID")
     public void setClusterID(String clusterID) {
         this.clusterID = clusterID;
     }
 
+    /**
+     * OvirtClusterDeprovision contains oVirt-specific configuration for a ClusterDeprovision
+     */
     @JsonProperty("credentialsSecretRef")
     public LocalObjectReference getCredentialsSecretRef() {
         return credentialsSecretRef;
     }
 
+    /**
+     * OvirtClusterDeprovision contains oVirt-specific configuration for a ClusterDeprovision
+     */
     @JsonProperty("credentialsSecretRef")
     public void setCredentialsSecretRef(LocalObjectReference credentialsSecretRef) {
         this.credentialsSecretRef = credentialsSecretRef;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/PatchEntity.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/PatchEntity.java
index 70c5fb453e3..39c6591513a 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/PatchEntity.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/PatchEntity.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PatchEntity represent a json patch (RFC 6902) to be applied to the install-config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public PatchEntity(String from, String op, String path, String value) {
         this.value = value;
     }
 
+    /**
+     * From is the json path to copy or move the value from
+     */
     @JsonProperty("from")
     public String getFrom() {
         return from;
     }
 
+    /**
+     * From is the json path to copy or move the value from
+     */
     @JsonProperty("from")
     public void setFrom(String from) {
         this.from = from;
     }
 
+    /**
+     * Op is the operation to perform: add, remove, replace, move, copy, test
+     */
     @JsonProperty("op")
     public String getOp() {
         return op;
     }
 
+    /**
+     * Op is the operation to perform: add, remove, replace, move, copy, test
+     */
     @JsonProperty("op")
     public void setOp(String op) {
         this.op = op;
     }
 
+    /**
+     * Path is the json path to the value to be modified
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Path is the json path to the value to be modified
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * Value is the value to be used in the operation
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is the value to be used in the operation
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/Platform.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/Platform.java
index fb796fbd71b..e047fad4c9c 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/Platform.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/Platform.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -115,101 +118,161 @@ public Platform(BareMetalPlatform agentBareMetal, io.fabric8.openshift.api.model
         this.vsphere = vsphere;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("agentBareMetal")
     public BareMetalPlatform getAgentBareMetal() {
         return agentBareMetal;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("agentBareMetal")
     public void setAgentBareMetal(BareMetalPlatform agentBareMetal) {
         this.agentBareMetal = agentBareMetal;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("aws")
     public io.fabric8.openshift.api.model.hive.aws.v1.Platform getAws() {
         return aws;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("aws")
     public void setAws(io.fabric8.openshift.api.model.hive.aws.v1.Platform aws) {
         this.aws = aws;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("azure")
     public io.fabric8.openshift.api.model.hive.azure.v1.Platform getAzure() {
         return azure;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("azure")
     public void setAzure(io.fabric8.openshift.api.model.hive.azure.v1.Platform azure) {
         this.azure = azure;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("baremetal")
     public io.fabric8.openshift.api.model.hive.baremetal.v1.Platform getBaremetal() {
         return baremetal;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("baremetal")
     public void setBaremetal(io.fabric8.openshift.api.model.hive.baremetal.v1.Platform baremetal) {
         this.baremetal = baremetal;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("gcp")
     public io.fabric8.openshift.api.model.hive.gcp.v1.Platform getGcp() {
         return gcp;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("gcp")
     public void setGcp(io.fabric8.openshift.api.model.hive.gcp.v1.Platform gcp) {
         this.gcp = gcp;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("ibmcloud")
     public io.fabric8.openshift.api.model.hive.ibmcloud.v1.Platform getIbmcloud() {
         return ibmcloud;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("ibmcloud")
     public void setIbmcloud(io.fabric8.openshift.api.model.hive.ibmcloud.v1.Platform ibmcloud) {
         this.ibmcloud = ibmcloud;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("none")
     public io.fabric8.openshift.api.model.hive.none.v1.Platform getNone() {
         return none;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("none")
     public void setNone(io.fabric8.openshift.api.model.hive.none.v1.Platform none) {
         this.none = none;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("openstack")
     public io.fabric8.openshift.api.model.hive.openstack.v1.Platform getOpenstack() {
         return openstack;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("openstack")
     public void setOpenstack(io.fabric8.openshift.api.model.hive.openstack.v1.Platform openstack) {
         this.openstack = openstack;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("ovirt")
     public io.fabric8.openshift.api.model.hive.ovirt.v1.Platform getOvirt() {
         return ovirt;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("ovirt")
     public void setOvirt(io.fabric8.openshift.api.model.hive.ovirt.v1.Platform ovirt) {
         this.ovirt = ovirt;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("vsphere")
     public io.fabric8.openshift.api.model.hive.vsphere.v1.Platform getVsphere() {
         return vsphere;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("vsphere")
     public void setVsphere(io.fabric8.openshift.api.model.hive.vsphere.v1.Platform vsphere) {
         this.vsphere = vsphere;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/PlatformStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/PlatformStatus.java
index 398fcdcc0b3..08318cbacbb 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/PlatformStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/PlatformStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PlatformStatus contains the observed state for the specific platform upon which to perform the installation
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PlatformStatus(io.fabric8.openshift.api.model.hive.aws.v1.PlatformStatus
         this.gcp = gcp;
     }
 
+    /**
+     * PlatformStatus contains the observed state for the specific platform upon which to perform the installation
+     */
     @JsonProperty("aws")
     public io.fabric8.openshift.api.model.hive.aws.v1.PlatformStatus getAws() {
         return aws;
     }
 
+    /**
+     * PlatformStatus contains the observed state for the specific platform upon which to perform the installation
+     */
     @JsonProperty("aws")
     public void setAws(io.fabric8.openshift.api.model.hive.aws.v1.PlatformStatus aws) {
         this.aws = aws;
     }
 
+    /**
+     * PlatformStatus contains the observed state for the specific platform upon which to perform the installation
+     */
     @JsonProperty("gcp")
     public io.fabric8.openshift.api.model.hive.gcp.v1.PlatformStatus getGcp() {
         return gcp;
     }
 
+    /**
+     * PlatformStatus contains the observed state for the specific platform upon which to perform the installation
+     */
     @JsonProperty("gcp")
     public void setGcp(io.fabric8.openshift.api.model.hive.gcp.v1.PlatformStatus gcp) {
         this.gcp = gcp;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/PrivateLinkConfig.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/PrivateLinkConfig.java
index 79402f6d3dd..c313d8298e0 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/PrivateLinkConfig.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/PrivateLinkConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PrivateLinkConfig defines the configuration for the privatelink controller.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public PrivateLinkConfig(GCPPrivateServiceConnectConfig gcp) {
         this.gcp = gcp;
     }
 
+    /**
+     * PrivateLinkConfig defines the configuration for the privatelink controller.
+     */
     @JsonProperty("gcp")
     public GCPPrivateServiceConnectConfig getGcp() {
         return gcp;
     }
 
+    /**
+     * PrivateLinkConfig defines the configuration for the privatelink controller.
+     */
     @JsonProperty("gcp")
     public void setGcp(GCPPrivateServiceConnectConfig gcp) {
         this.gcp = gcp;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/Provisioning.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/Provisioning.java
index 751a9f45fd7..0bdba508288 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/Provisioning.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/Provisioning.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Provisioning contains settings used only for initial cluster provisioning.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -114,93 +117,147 @@ public Provisioning(ClusterImageSetReference imageSetRef, LocalObjectReference i
         this.sshPrivateKeySecretRef = sshPrivateKeySecretRef;
     }
 
+    /**
+     * Provisioning contains settings used only for initial cluster provisioning.
+     */
     @JsonProperty("imageSetRef")
     public ClusterImageSetReference getImageSetRef() {
         return imageSetRef;
     }
 
+    /**
+     * Provisioning contains settings used only for initial cluster provisioning.
+     */
     @JsonProperty("imageSetRef")
     public void setImageSetRef(ClusterImageSetReference imageSetRef) {
         this.imageSetRef = imageSetRef;
     }
 
+    /**
+     * Provisioning contains settings used only for initial cluster provisioning.
+     */
     @JsonProperty("installConfigSecretRef")
     public LocalObjectReference getInstallConfigSecretRef() {
         return installConfigSecretRef;
     }
 
+    /**
+     * Provisioning contains settings used only for initial cluster provisioning.
+     */
     @JsonProperty("installConfigSecretRef")
     public void setInstallConfigSecretRef(LocalObjectReference installConfigSecretRef) {
         this.installConfigSecretRef = installConfigSecretRef;
     }
 
+    /**
+     * InstallerEnv are extra environment variables to pass through to the installer. This may be used to enable additional features of the installer.
+     */
     @JsonProperty("installerEnv")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvVar> getInstallerEnv() {
         return installerEnv;
     }
 
+    /**
+     * InstallerEnv are extra environment variables to pass through to the installer. This may be used to enable additional features of the installer.
+     */
     @JsonProperty("installerEnv")
     public void setInstallerEnv(List<EnvVar> installerEnv) {
         this.installerEnv = installerEnv;
     }
 
+    /**
+     * InstallerImageOverride allows specifying a URI for the installer image, normally gleaned from the metadata within the ReleaseImage.
+     */
     @JsonProperty("installerImageOverride")
     public String getInstallerImageOverride() {
         return installerImageOverride;
     }
 
+    /**
+     * InstallerImageOverride allows specifying a URI for the installer image, normally gleaned from the metadata within the ReleaseImage.
+     */
     @JsonProperty("installerImageOverride")
     public void setInstallerImageOverride(String installerImageOverride) {
         this.installerImageOverride = installerImageOverride;
     }
 
+    /**
+     * Provisioning contains settings used only for initial cluster provisioning.
+     */
     @JsonProperty("manifestsConfigMapRef")
     public LocalObjectReference getManifestsConfigMapRef() {
         return manifestsConfigMapRef;
     }
 
+    /**
+     * Provisioning contains settings used only for initial cluster provisioning.
+     */
     @JsonProperty("manifestsConfigMapRef")
     public void setManifestsConfigMapRef(LocalObjectReference manifestsConfigMapRef) {
         this.manifestsConfigMapRef = manifestsConfigMapRef;
     }
 
+    /**
+     * Provisioning contains settings used only for initial cluster provisioning.
+     */
     @JsonProperty("manifestsSecretRef")
     public LocalObjectReference getManifestsSecretRef() {
         return manifestsSecretRef;
     }
 
+    /**
+     * Provisioning contains settings used only for initial cluster provisioning.
+     */
     @JsonProperty("manifestsSecretRef")
     public void setManifestsSecretRef(LocalObjectReference manifestsSecretRef) {
         this.manifestsSecretRef = manifestsSecretRef;
     }
 
+    /**
+     * ReleaseImage is the image containing metadata for all components that run in the cluster, and is the primary and best way to specify what specific version of OpenShift you wish to install.
+     */
     @JsonProperty("releaseImage")
     public String getReleaseImage() {
         return releaseImage;
     }
 
+    /**
+     * ReleaseImage is the image containing metadata for all components that run in the cluster, and is the primary and best way to specify what specific version of OpenShift you wish to install.
+     */
     @JsonProperty("releaseImage")
     public void setReleaseImage(String releaseImage) {
         this.releaseImage = releaseImage;
     }
 
+    /**
+     * SSHKnownHosts are known hosts to be configured in the hive install manager pod to avoid ssh prompts. Use of ssh in the install pod is somewhat limited today (failure log gathering from cluster, some bare metal provisioning scenarios), so this setting is often not needed.
+     */
     @JsonProperty("sshKnownHosts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSshKnownHosts() {
         return sshKnownHosts;
     }
 
+    /**
+     * SSHKnownHosts are known hosts to be configured in the hive install manager pod to avoid ssh prompts. Use of ssh in the install pod is somewhat limited today (failure log gathering from cluster, some bare metal provisioning scenarios), so this setting is often not needed.
+     */
     @JsonProperty("sshKnownHosts")
     public void setSshKnownHosts(List<String> sshKnownHosts) {
         this.sshKnownHosts = sshKnownHosts;
     }
 
+    /**
+     * Provisioning contains settings used only for initial cluster provisioning.
+     */
     @JsonProperty("sshPrivateKeySecretRef")
     public LocalObjectReference getSshPrivateKeySecretRef() {
         return sshPrivateKeySecretRef;
     }
 
+    /**
+     * Provisioning contains settings used only for initial cluster provisioning.
+     */
     @JsonProperty("sshPrivateKeySecretRef")
     public void setSshPrivateKeySecretRef(LocalObjectReference sshPrivateKeySecretRef) {
         this.sshPrivateKeySecretRef = sshPrivateKeySecretRef;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ReleaseImageVerificationConfigMapReference.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ReleaseImageVerificationConfigMapReference.java
index fc570b9a9b7..d20e5224147 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ReleaseImageVerificationConfigMapReference.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ReleaseImageVerificationConfigMapReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ReleaseImageVerificationConfigMapReference is a reference to the ConfigMap that will be used to verify release images.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ReleaseImageVerificationConfigMapReference(String name, String namespace)
         this.namespace = namespace;
     }
 
+    /**
+     * Name of the ConfigMap
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the ConfigMap
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace of the ConfigMap
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace of the ConfigMap
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SecretMapping.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SecretMapping.java
index 2002640e49b..185e69193bf 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SecretMapping.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SecretMapping.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SecretMapping defines a source and destination for a secret to be synced by a SyncSet
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public SecretMapping(SecretReference sourceRef, SecretReference targetRef) {
         this.targetRef = targetRef;
     }
 
+    /**
+     * SecretMapping defines a source and destination for a secret to be synced by a SyncSet
+     */
     @JsonProperty("sourceRef")
     public SecretReference getSourceRef() {
         return sourceRef;
     }
 
+    /**
+     * SecretMapping defines a source and destination for a secret to be synced by a SyncSet
+     */
     @JsonProperty("sourceRef")
     public void setSourceRef(SecretReference sourceRef) {
         this.sourceRef = sourceRef;
     }
 
+    /**
+     * SecretMapping defines a source and destination for a secret to be synced by a SyncSet
+     */
     @JsonProperty("targetRef")
     public SecretReference getTargetRef() {
         return targetRef;
     }
 
+    /**
+     * SecretMapping defines a source and destination for a secret to be synced by a SyncSet
+     */
     @JsonProperty("targetRef")
     public void setTargetRef(SecretReference targetRef) {
         this.targetRef = targetRef;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SecretReference.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SecretReference.java
index d78e9f8b8c7..d0956a088c3 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SecretReference.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SecretReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SecretReference is a reference to a secret by name and namespace
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public SecretReference(String name, String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Name is the name of the secret
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the secret
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace is the namespace where the secret lives. If not present for the source secret reference, it is assumed to be the same namespace as the syncset with the reference.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace where the secret lives. If not present for the source secret reference, it is assumed to be the same namespace as the syncset with the reference.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SelectorSyncIdentityProvider.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SelectorSyncIdentityProvider.java
index 68ce29c3ea0..6ab575caaf8 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SelectorSyncIdentityProvider.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SelectorSyncIdentityProvider.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SelectorSyncIdentityProvider is the Schema for the SelectorSyncSet API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class SelectorSyncIdentityProvider implements Editable<SelectorSyncIdentityProviderBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SelectorSyncIdentityProvider";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public SelectorSyncIdentityProvider(String apiVersion, String kind, ObjectMeta m
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SelectorSyncIdentityProvider is the Schema for the SelectorSyncSet API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SelectorSyncIdentityProvider is the Schema for the SelectorSyncSet API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * SelectorSyncIdentityProvider is the Schema for the SelectorSyncSet API
+     */
     @JsonProperty("spec")
     public SelectorSyncIdentityProviderSpec getSpec() {
         return spec;
     }
 
+    /**
+     * SelectorSyncIdentityProvider is the Schema for the SelectorSyncSet API
+     */
     @JsonProperty("spec")
     public void setSpec(SelectorSyncIdentityProviderSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * SelectorSyncIdentityProvider is the Schema for the SelectorSyncSet API
+     */
     @JsonProperty("status")
     public IdentityProviderStatus getStatus() {
         return status;
     }
 
+    /**
+     * SelectorSyncIdentityProvider is the Schema for the SelectorSyncSet API
+     */
     @JsonProperty("status")
     public void setStatus(IdentityProviderStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SelectorSyncIdentityProviderList.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SelectorSyncIdentityProviderList.java
index 108aeb54c74..1a5a5defd4d 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SelectorSyncIdentityProviderList.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SelectorSyncIdentityProviderList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SelectorSyncIdentityProviderList contains a list of SelectorSyncIdentityProviders
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class SelectorSyncIdentityProviderList implements Editable<SelectorSyncIdentityProviderListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.hive.v1.SelectorSyncIdentityProvider>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.hive.v1.SelectorSyncIdentityProvider> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SelectorSyncIdentityProviderList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public SelectorSyncIdentityProviderList(String apiVersion, List<io.fabric8.opens
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * SelectorSyncIdentityProviderList contains a list of SelectorSyncIdentityProviders
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.hive.v1.SelectorSyncIdentityProvider> getItems() {
         return items;
     }
 
+    /**
+     * SelectorSyncIdentityProviderList contains a list of SelectorSyncIdentityProviders
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.hive.v1.SelectorSyncIdentityProvider> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SelectorSyncIdentityProviderList contains a list of SelectorSyncIdentityProviders
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SelectorSyncIdentityProviderList contains a list of SelectorSyncIdentityProviders
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SelectorSyncIdentityProviderSpec.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SelectorSyncIdentityProviderSpec.java
index c7e7dff9ea9..f83554fc611 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SelectorSyncIdentityProviderSpec.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SelectorSyncIdentityProviderSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SelectorSyncIdentityProviderSpec defines the SyncIdentityProviderCommonSpec to sync to ClusterDeploymentSelector indicating which clusters the SelectorSyncIdentityProvider applies to in any namespace.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,22 +89,34 @@ public SelectorSyncIdentityProviderSpec(LabelSelector clusterDeploymentSelector,
         this.identityProviders = identityProviders;
     }
 
+    /**
+     * SelectorSyncIdentityProviderSpec defines the SyncIdentityProviderCommonSpec to sync to ClusterDeploymentSelector indicating which clusters the SelectorSyncIdentityProvider applies to in any namespace.
+     */
     @JsonProperty("clusterDeploymentSelector")
     public LabelSelector getClusterDeploymentSelector() {
         return clusterDeploymentSelector;
     }
 
+    /**
+     * SelectorSyncIdentityProviderSpec defines the SyncIdentityProviderCommonSpec to sync to ClusterDeploymentSelector indicating which clusters the SelectorSyncIdentityProvider applies to in any namespace.
+     */
     @JsonProperty("clusterDeploymentSelector")
     public void setClusterDeploymentSelector(LabelSelector clusterDeploymentSelector) {
         this.clusterDeploymentSelector = clusterDeploymentSelector;
     }
 
+    /**
+     * IdentityProviders is an ordered list of ways for a user to identify themselves
+     */
     @JsonProperty("identityProviders")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IdentityProvider> getIdentityProviders() {
         return identityProviders;
     }
 
+    /**
+     * IdentityProviders is an ordered list of ways for a user to identify themselves
+     */
     @JsonProperty("identityProviders")
     public void setIdentityProviders(List<IdentityProvider> identityProviders) {
         this.identityProviders = identityProviders;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SelectorSyncSet.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SelectorSyncSet.java
index 7bb57f72326..b092f4e2866 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SelectorSyncSet.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SelectorSyncSet.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SelectorSyncSet is the Schema for the SelectorSyncSet API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class SelectorSyncSet implements Editable<SelectorSyncSetBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SelectorSyncSet";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public SelectorSyncSet(String apiVersion, String kind, ObjectMeta metadata, Sele
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SelectorSyncSet is the Schema for the SelectorSyncSet API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SelectorSyncSet is the Schema for the SelectorSyncSet API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * SelectorSyncSet is the Schema for the SelectorSyncSet API
+     */
     @JsonProperty("spec")
     public SelectorSyncSetSpec getSpec() {
         return spec;
     }
 
+    /**
+     * SelectorSyncSet is the Schema for the SelectorSyncSet API
+     */
     @JsonProperty("spec")
     public void setSpec(SelectorSyncSetSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * SelectorSyncSet is the Schema for the SelectorSyncSet API
+     */
     @JsonProperty("status")
     public SelectorSyncSetStatus getStatus() {
         return status;
     }
 
+    /**
+     * SelectorSyncSet is the Schema for the SelectorSyncSet API
+     */
     @JsonProperty("status")
     public void setStatus(SelectorSyncSetStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SelectorSyncSetList.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SelectorSyncSetList.java
index 2f4912246b8..18abd3dd8e9 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SelectorSyncSetList.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SelectorSyncSetList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SelectorSyncSetList contains a list of SyncSets
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class SelectorSyncSetList implements Editable<SelectorSyncSetListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.hive.v1.SelectorSyncSet>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.hive.v1.SelectorSyncSet> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SelectorSyncSetList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public SelectorSyncSetList(String apiVersion, List<io.fabric8.openshift.api.mode
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * SelectorSyncSetList contains a list of SyncSets
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.hive.v1.SelectorSyncSet> getItems() {
         return items;
     }
 
+    /**
+     * SelectorSyncSetList contains a list of SyncSets
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.hive.v1.SelectorSyncSet> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SelectorSyncSetList contains a list of SyncSets
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SelectorSyncSetList contains a list of SyncSets
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SelectorSyncSetSpec.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SelectorSyncSetSpec.java
index 0e92c41ba65..af762b120c6 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SelectorSyncSetSpec.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SelectorSyncSetSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SelectorSyncSetSpec defines the SyncSetCommonSpec resources and patches to sync along with a ClusterDeploymentSelector indicating which clusters the SelectorSyncSet applies to in any namespace.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -108,75 +111,117 @@ public SelectorSyncSetSpec(String applyBehavior, LabelSelector clusterDeployment
         this.secretMappings = secretMappings;
     }
 
+    /**
+     * ApplyBehavior indicates how resources in this syncset will be applied to the target cluster. The default value of "Apply" indicates that resources should be applied using the 'oc apply' command. If no value is set, "Apply" is assumed. A value of "CreateOnly" indicates that the resource will only be created if it does not already exist in the target cluster. Otherwise, it will be left alone. A value of "CreateOrUpdate" indicates that the resource will be created/updated without the use of the 'oc apply' command, allowing larger resources to be synced, but losing some functionality of the 'oc apply' command such as the ability to remove annotations, labels, and other map entries in general.
+     */
     @JsonProperty("applyBehavior")
     public String getApplyBehavior() {
         return applyBehavior;
     }
 
+    /**
+     * ApplyBehavior indicates how resources in this syncset will be applied to the target cluster. The default value of "Apply" indicates that resources should be applied using the 'oc apply' command. If no value is set, "Apply" is assumed. A value of "CreateOnly" indicates that the resource will only be created if it does not already exist in the target cluster. Otherwise, it will be left alone. A value of "CreateOrUpdate" indicates that the resource will be created/updated without the use of the 'oc apply' command, allowing larger resources to be synced, but losing some functionality of the 'oc apply' command such as the ability to remove annotations, labels, and other map entries in general.
+     */
     @JsonProperty("applyBehavior")
     public void setApplyBehavior(String applyBehavior) {
         this.applyBehavior = applyBehavior;
     }
 
+    /**
+     * SelectorSyncSetSpec defines the SyncSetCommonSpec resources and patches to sync along with a ClusterDeploymentSelector indicating which clusters the SelectorSyncSet applies to in any namespace.
+     */
     @JsonProperty("clusterDeploymentSelector")
     public LabelSelector getClusterDeploymentSelector() {
         return clusterDeploymentSelector;
     }
 
+    /**
+     * SelectorSyncSetSpec defines the SyncSetCommonSpec resources and patches to sync along with a ClusterDeploymentSelector indicating which clusters the SelectorSyncSet applies to in any namespace.
+     */
     @JsonProperty("clusterDeploymentSelector")
     public void setClusterDeploymentSelector(LabelSelector clusterDeploymentSelector) {
         this.clusterDeploymentSelector = clusterDeploymentSelector;
     }
 
+    /**
+     * EnableResourceTemplates, if True, causes hive to honor golang text/templates in Resources. While the standard syntax is supported, it won't do you a whole lot of good as the parser does not pass a data object (i.e. there is no "dot" for you to use). This currently exists to expose a single function: {{ fromCDLabel "some.label/key" }} will be substituted with the string value of ClusterDeployment.Labels["some.label/key"]. The empty string is interpolated if there are no labels, or if the indicated key does not exist. Note that this only works in values (not e.g. map keys) that are of type string.
+     */
     @JsonProperty("enableResourceTemplates")
     public Boolean getEnableResourceTemplates() {
         return enableResourceTemplates;
     }
 
+    /**
+     * EnableResourceTemplates, if True, causes hive to honor golang text/templates in Resources. While the standard syntax is supported, it won't do you a whole lot of good as the parser does not pass a data object (i.e. there is no "dot" for you to use). This currently exists to expose a single function: {{ fromCDLabel "some.label/key" }} will be substituted with the string value of ClusterDeployment.Labels["some.label/key"]. The empty string is interpolated if there are no labels, or if the indicated key does not exist. Note that this only works in values (not e.g. map keys) that are of type string.
+     */
     @JsonProperty("enableResourceTemplates")
     public void setEnableResourceTemplates(Boolean enableResourceTemplates) {
         this.enableResourceTemplates = enableResourceTemplates;
     }
 
+    /**
+     * Patches is the list of patches to apply.
+     */
     @JsonProperty("patches")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SyncObjectPatch> getPatches() {
         return patches;
     }
 
+    /**
+     * Patches is the list of patches to apply.
+     */
     @JsonProperty("patches")
     public void setPatches(List<SyncObjectPatch> patches) {
         this.patches = patches;
     }
 
+    /**
+     * ResourceApplyMode indicates if the Resource apply mode is "Upsert" (default) or "Sync". ApplyMode "Upsert" indicates create and update. ApplyMode "Sync" indicates create, update and delete.
+     */
     @JsonProperty("resourceApplyMode")
     public String getResourceApplyMode() {
         return resourceApplyMode;
     }
 
+    /**
+     * ResourceApplyMode indicates if the Resource apply mode is "Upsert" (default) or "Sync". ApplyMode "Upsert" indicates create and update. ApplyMode "Sync" indicates create, update and delete.
+     */
     @JsonProperty("resourceApplyMode")
     public void setResourceApplyMode(String resourceApplyMode) {
         this.resourceApplyMode = resourceApplyMode;
     }
 
+    /**
+     * Resources is the list of objects to sync from RawExtension definitions.
+     */
     @JsonProperty("resources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Object> getResources() {
         return resources;
     }
 
+    /**
+     * Resources is the list of objects to sync from RawExtension definitions.
+     */
     @JsonProperty("resources")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializerForList.class)
     public void setResources(List<Object> resources) {
         this.resources = resources;
     }
 
+    /**
+     * Secrets is the list of secrets to sync along with their respective destinations.
+     */
     @JsonProperty("secretMappings")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SecretMapping> getSecretMappings() {
         return secretMappings;
     }
 
+    /**
+     * Secrets is the list of secrets to sync along with their respective destinations.
+     */
     @JsonProperty("secretMappings")
     public void setSecretMappings(List<SecretMapping> secretMappings) {
         this.secretMappings = secretMappings;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SelectorSyncSetStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SelectorSyncSetStatus.java
index 1a51b8a3cb8..0d169021b58 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SelectorSyncSetStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SelectorSyncSetStatus.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SelectorSyncSetStatus defines the observed state of a SelectorSyncSet
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ServiceProviderCredentials.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ServiceProviderCredentials.java
index bb2c92847bb..a5fc9ddab9b 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ServiceProviderCredentials.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/ServiceProviderCredentials.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceProviderCredentials is used to configure credentials related to being a service provider on various cloud platforms.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ServiceProviderCredentials(AWSServiceProviderCredentials aws) {
         this.aws = aws;
     }
 
+    /**
+     * ServiceProviderCredentials is used to configure credentials related to being a service provider on various cloud platforms.
+     */
     @JsonProperty("aws")
     public AWSServiceProviderCredentials getAws() {
         return aws;
     }
 
+    /**
+     * ServiceProviderCredentials is used to configure credentials related to being a service provider on various cloud platforms.
+     */
     @JsonProperty("aws")
     public void setAws(AWSServiceProviderCredentials aws) {
         this.aws = aws;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SpecificControllerConfig.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SpecificControllerConfig.java
index 6f2bc9a8c64..d5ef7478e42 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SpecificControllerConfig.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SpecificControllerConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SpecificControllerConfig contains the configuration for a specific controller
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public SpecificControllerConfig(ControllerConfig config, String name) {
         this.name = name;
     }
 
+    /**
+     * SpecificControllerConfig contains the configuration for a specific controller
+     */
     @JsonProperty("config")
     public ControllerConfig getConfig() {
         return config;
     }
 
+    /**
+     * SpecificControllerConfig contains the configuration for a specific controller
+     */
     @JsonProperty("config")
     public void setConfig(ControllerConfig config) {
         this.config = config;
     }
 
+    /**
+     * Name specifies the name of the controller
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name specifies the name of the controller
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncCondition.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncCondition.java
index e840d2533e4..4c6bcfb3c17 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncCondition.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SyncCondition is a condition in a SyncStatus
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public SyncCondition(String lastProbeTime, String lastTransitionTime, String mes
         this.type = type;
     }
 
+    /**
+     * SyncCondition is a condition in a SyncStatus
+     */
     @JsonProperty("lastProbeTime")
     public String getLastProbeTime() {
         return lastProbeTime;
     }
 
+    /**
+     * SyncCondition is a condition in a SyncStatus
+     */
     @JsonProperty("lastProbeTime")
     public void setLastProbeTime(String lastProbeTime) {
         this.lastProbeTime = lastProbeTime;
     }
 
+    /**
+     * SyncCondition is a condition in a SyncStatus
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * SyncCondition is a condition in a SyncStatus
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Message is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Reason is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason is a unique, one-word, CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status is the status of the condition.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status is the status of the condition.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type is the type of the condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of the condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncIdentityProvider.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncIdentityProvider.java
index 1c98fcfad24..1c4b36170e7 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncIdentityProvider.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncIdentityProvider.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SyncIdentityProvider is the Schema for the SyncIdentityProvider API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class SyncIdentityProvider implements Editable<SyncIdentityProviderBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SyncIdentityProvider";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public SyncIdentityProvider(String apiVersion, String kind, ObjectMeta metadata,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SyncIdentityProvider is the Schema for the SyncIdentityProvider API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SyncIdentityProvider is the Schema for the SyncIdentityProvider API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * SyncIdentityProvider is the Schema for the SyncIdentityProvider API
+     */
     @JsonProperty("spec")
     public SyncIdentityProviderSpec getSpec() {
         return spec;
     }
 
+    /**
+     * SyncIdentityProvider is the Schema for the SyncIdentityProvider API
+     */
     @JsonProperty("spec")
     public void setSpec(SyncIdentityProviderSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * SyncIdentityProvider is the Schema for the SyncIdentityProvider API
+     */
     @JsonProperty("status")
     public IdentityProviderStatus getStatus() {
         return status;
     }
 
+    /**
+     * SyncIdentityProvider is the Schema for the SyncIdentityProvider API
+     */
     @JsonProperty("status")
     public void setStatus(IdentityProviderStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncIdentityProviderCommonSpec.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncIdentityProviderCommonSpec.java
index 0bf153bf482..c04eb56cdbf 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncIdentityProviderCommonSpec.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncIdentityProviderCommonSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SyncIdentityProviderCommonSpec defines the identity providers to sync
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,12 +85,18 @@ public SyncIdentityProviderCommonSpec(List<IdentityProvider> identityProviders)
         this.identityProviders = identityProviders;
     }
 
+    /**
+     * IdentityProviders is an ordered list of ways for a user to identify themselves
+     */
     @JsonProperty("identityProviders")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IdentityProvider> getIdentityProviders() {
         return identityProviders;
     }
 
+    /**
+     * IdentityProviders is an ordered list of ways for a user to identify themselves
+     */
     @JsonProperty("identityProviders")
     public void setIdentityProviders(List<IdentityProvider> identityProviders) {
         this.identityProviders = identityProviders;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncIdentityProviderList.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncIdentityProviderList.java
index 8517fabe04a..76fbe2cb095 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncIdentityProviderList.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncIdentityProviderList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SyncIdentityProviderList contains a list of SyncIdentityProviders
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class SyncIdentityProviderList implements Editable<SyncIdentityProviderListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.hive.v1.SyncIdentityProvider>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.hive.v1.SyncIdentityProvider> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SyncIdentityProviderList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public SyncIdentityProviderList(String apiVersion, List<io.fabric8.openshift.api
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * SyncIdentityProviderList contains a list of SyncIdentityProviders
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.hive.v1.SyncIdentityProvider> getItems() {
         return items;
     }
 
+    /**
+     * SyncIdentityProviderList contains a list of SyncIdentityProviders
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.hive.v1.SyncIdentityProvider> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SyncIdentityProviderList contains a list of SyncIdentityProviders
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SyncIdentityProviderList contains a list of SyncIdentityProviders
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncIdentityProviderSpec.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncIdentityProviderSpec.java
index 170f4bfe597..a473eeaf664 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncIdentityProviderSpec.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncIdentityProviderSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SyncIdentityProviderSpec defines the SyncIdentityProviderCommonSpec identity providers to sync along with ClusterDeploymentRefs indicating which clusters the SyncIdentityProvider applies to in the SyncIdentityProvider's namespace.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,23 +90,35 @@ public SyncIdentityProviderSpec(List<LocalObjectReference> clusterDeploymentRefs
         this.identityProviders = identityProviders;
     }
 
+    /**
+     * ClusterDeploymentRefs is the list of LocalObjectReference indicating which clusters the SyncSet applies to in the SyncSet's namespace.
+     */
     @JsonProperty("clusterDeploymentRefs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LocalObjectReference> getClusterDeploymentRefs() {
         return clusterDeploymentRefs;
     }
 
+    /**
+     * ClusterDeploymentRefs is the list of LocalObjectReference indicating which clusters the SyncSet applies to in the SyncSet's namespace.
+     */
     @JsonProperty("clusterDeploymentRefs")
     public void setClusterDeploymentRefs(List<LocalObjectReference> clusterDeploymentRefs) {
         this.clusterDeploymentRefs = clusterDeploymentRefs;
     }
 
+    /**
+     * IdentityProviders is an ordered list of ways for a user to identify themselves
+     */
     @JsonProperty("identityProviders")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IdentityProvider> getIdentityProviders() {
         return identityProviders;
     }
 
+    /**
+     * IdentityProviders is an ordered list of ways for a user to identify themselves
+     */
     @JsonProperty("identityProviders")
     public void setIdentityProviders(List<IdentityProvider> identityProviders) {
         this.identityProviders = identityProviders;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncObjectPatch.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncObjectPatch.java
index 4c05a4bf784..8d8c0019994 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncObjectPatch.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncObjectPatch.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SyncObjectPatch represents a patch to be applied to a specific object
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public SyncObjectPatch(String apiVersion, String kind, String name, String names
         this.patchType = patchType;
     }
 
+    /**
+     * APIVersion is the Group and Version of the object to be patched.
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * APIVersion is the Group and Version of the object to be patched.
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Kind is the Kind of the object to be patched.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is the Kind of the object to be patched.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of the object to be patched.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the object to be patched.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace is the Namespace in which the object to patch exists. Defaults to the SyncSet's Namespace.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the Namespace in which the object to patch exists. Defaults to the SyncSet's Namespace.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Patch is the patch to apply.
+     */
     @JsonProperty("patch")
     public String getPatch() {
         return patch;
     }
 
+    /**
+     * Patch is the patch to apply.
+     */
     @JsonProperty("patch")
     public void setPatch(String patch) {
         this.patch = patch;
     }
 
+    /**
+     * PatchType indicates the PatchType as "strategic" (default), "json", or "merge".
+     */
     @JsonProperty("patchType")
     public String getPatchType() {
         return patchType;
     }
 
+    /**
+     * PatchType indicates the PatchType as "strategic" (default), "json", or "merge".
+     */
     @JsonProperty("patchType")
     public void setPatchType(String patchType) {
         this.patchType = patchType;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncSet.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncSet.java
index 98d090d181a..fc26e0a41e9 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncSet.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncSet.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SyncSet is the Schema for the SyncSet API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class SyncSet implements Editable<SyncSetBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SyncSet";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public SyncSet(String apiVersion, String kind, ObjectMeta metadata, SyncSetSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SyncSet is the Schema for the SyncSet API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SyncSet is the Schema for the SyncSet API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * SyncSet is the Schema for the SyncSet API
+     */
     @JsonProperty("spec")
     public SyncSetSpec getSpec() {
         return spec;
     }
 
+    /**
+     * SyncSet is the Schema for the SyncSet API
+     */
     @JsonProperty("spec")
     public void setSpec(SyncSetSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * SyncSet is the Schema for the SyncSet API
+     */
     @JsonProperty("status")
     public SyncSetStatus getStatus() {
         return status;
     }
 
+    /**
+     * SyncSet is the Schema for the SyncSet API
+     */
     @JsonProperty("status")
     public void setStatus(SyncSetStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncSetCommonSpec.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncSetCommonSpec.java
index 5250f5c6cb7..4bb7eae5394 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncSetCommonSpec.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncSetCommonSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SyncSetCommonSpec defines the resources and patches to sync
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -104,65 +107,101 @@ public SyncSetCommonSpec(String applyBehavior, Boolean enableResourceTemplates,
         this.secretMappings = secretMappings;
     }
 
+    /**
+     * ApplyBehavior indicates how resources in this syncset will be applied to the target cluster. The default value of "Apply" indicates that resources should be applied using the 'oc apply' command. If no value is set, "Apply" is assumed. A value of "CreateOnly" indicates that the resource will only be created if it does not already exist in the target cluster. Otherwise, it will be left alone. A value of "CreateOrUpdate" indicates that the resource will be created/updated without the use of the 'oc apply' command, allowing larger resources to be synced, but losing some functionality of the 'oc apply' command such as the ability to remove annotations, labels, and other map entries in general.
+     */
     @JsonProperty("applyBehavior")
     public String getApplyBehavior() {
         return applyBehavior;
     }
 
+    /**
+     * ApplyBehavior indicates how resources in this syncset will be applied to the target cluster. The default value of "Apply" indicates that resources should be applied using the 'oc apply' command. If no value is set, "Apply" is assumed. A value of "CreateOnly" indicates that the resource will only be created if it does not already exist in the target cluster. Otherwise, it will be left alone. A value of "CreateOrUpdate" indicates that the resource will be created/updated without the use of the 'oc apply' command, allowing larger resources to be synced, but losing some functionality of the 'oc apply' command such as the ability to remove annotations, labels, and other map entries in general.
+     */
     @JsonProperty("applyBehavior")
     public void setApplyBehavior(String applyBehavior) {
         this.applyBehavior = applyBehavior;
     }
 
+    /**
+     * EnableResourceTemplates, if True, causes hive to honor golang text/templates in Resources. While the standard syntax is supported, it won't do you a whole lot of good as the parser does not pass a data object (i.e. there is no "dot" for you to use). This currently exists to expose a single function: {{ fromCDLabel "some.label/key" }} will be substituted with the string value of ClusterDeployment.Labels["some.label/key"]. The empty string is interpolated if there are no labels, or if the indicated key does not exist. Note that this only works in values (not e.g. map keys) that are of type string.
+     */
     @JsonProperty("enableResourceTemplates")
     public Boolean getEnableResourceTemplates() {
         return enableResourceTemplates;
     }
 
+    /**
+     * EnableResourceTemplates, if True, causes hive to honor golang text/templates in Resources. While the standard syntax is supported, it won't do you a whole lot of good as the parser does not pass a data object (i.e. there is no "dot" for you to use). This currently exists to expose a single function: {{ fromCDLabel "some.label/key" }} will be substituted with the string value of ClusterDeployment.Labels["some.label/key"]. The empty string is interpolated if there are no labels, or if the indicated key does not exist. Note that this only works in values (not e.g. map keys) that are of type string.
+     */
     @JsonProperty("enableResourceTemplates")
     public void setEnableResourceTemplates(Boolean enableResourceTemplates) {
         this.enableResourceTemplates = enableResourceTemplates;
     }
 
+    /**
+     * Patches is the list of patches to apply.
+     */
     @JsonProperty("patches")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SyncObjectPatch> getPatches() {
         return patches;
     }
 
+    /**
+     * Patches is the list of patches to apply.
+     */
     @JsonProperty("patches")
     public void setPatches(List<SyncObjectPatch> patches) {
         this.patches = patches;
     }
 
+    /**
+     * ResourceApplyMode indicates if the Resource apply mode is "Upsert" (default) or "Sync". ApplyMode "Upsert" indicates create and update. ApplyMode "Sync" indicates create, update and delete.
+     */
     @JsonProperty("resourceApplyMode")
     public String getResourceApplyMode() {
         return resourceApplyMode;
     }
 
+    /**
+     * ResourceApplyMode indicates if the Resource apply mode is "Upsert" (default) or "Sync". ApplyMode "Upsert" indicates create and update. ApplyMode "Sync" indicates create, update and delete.
+     */
     @JsonProperty("resourceApplyMode")
     public void setResourceApplyMode(String resourceApplyMode) {
         this.resourceApplyMode = resourceApplyMode;
     }
 
+    /**
+     * Resources is the list of objects to sync from RawExtension definitions.
+     */
     @JsonProperty("resources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Object> getResources() {
         return resources;
     }
 
+    /**
+     * Resources is the list of objects to sync from RawExtension definitions.
+     */
     @JsonProperty("resources")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializerForList.class)
     public void setResources(List<Object> resources) {
         this.resources = resources;
     }
 
+    /**
+     * Secrets is the list of secrets to sync along with their respective destinations.
+     */
     @JsonProperty("secretMappings")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SecretMapping> getSecretMappings() {
         return secretMappings;
     }
 
+    /**
+     * Secrets is the list of secrets to sync along with their respective destinations.
+     */
     @JsonProperty("secretMappings")
     public void setSecretMappings(List<SecretMapping> secretMappings) {
         this.secretMappings = secretMappings;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncSetList.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncSetList.java
index c0e199a2cb3..3c503acc954 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncSetList.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncSetList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SyncSetList contains a list of SyncSets
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class SyncSetList implements Editable<SyncSetListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.hive.v1.SyncSet>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "hive.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.hive.v1.SyncSet> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SyncSetList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public SyncSetList(String apiVersion, List<io.fabric8.openshift.api.model.hive.v
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * SyncSetList contains a list of SyncSets
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.hive.v1.SyncSet> getItems() {
         return items;
     }
 
+    /**
+     * SyncSetList contains a list of SyncSets
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.hive.v1.SyncSet> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SyncSetList contains a list of SyncSets
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SyncSetList contains a list of SyncSets
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncSetObjectStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncSetObjectStatus.java
index 43654cb14e7..12e277f882d 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncSetObjectStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncSetObjectStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SyncSetObjectStatus describes the status of resources created or patches that have been applied from a SyncSet or SelectorSyncSet.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -104,65 +107,101 @@ public SyncSetObjectStatus(List<SyncCondition> conditions, String name, List<Syn
         this.secrets = secrets;
     }
 
+    /**
+     * Conditions is the list of SyncConditions used to indicate UnknownObject when a resource type cannot be determined from a SyncSet resource.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SyncCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions is the list of SyncConditions used to indicate UnknownObject when a resource type cannot be determined from a SyncSet resource.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<SyncCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Name is the name of the SyncSet.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the SyncSet.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Patches is the list of SyncStatus for patches that have been applied.
+     */
     @JsonProperty("patches")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SyncStatus> getPatches() {
         return patches;
     }
 
+    /**
+     * Patches is the list of SyncStatus for patches that have been applied.
+     */
     @JsonProperty("patches")
     public void setPatches(List<SyncStatus> patches) {
         this.patches = patches;
     }
 
+    /**
+     * ResourceApplyMode indicates if the Resource apply mode is "Upsert" (default) or "Sync". ApplyMode "Upsert" indicates create and update. ApplyMode "Sync" indicates create, update and delete.
+     */
     @JsonProperty("resourceApplyMode")
     public String getResourceApplyMode() {
         return resourceApplyMode;
     }
 
+    /**
+     * ResourceApplyMode indicates if the Resource apply mode is "Upsert" (default) or "Sync". ApplyMode "Upsert" indicates create and update. ApplyMode "Sync" indicates create, update and delete.
+     */
     @JsonProperty("resourceApplyMode")
     public void setResourceApplyMode(String resourceApplyMode) {
         this.resourceApplyMode = resourceApplyMode;
     }
 
+    /**
+     * Resources is the list of SyncStatus for objects that have been synced.
+     */
     @JsonProperty("resources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SyncStatus> getResources() {
         return resources;
     }
 
+    /**
+     * Resources is the list of SyncStatus for objects that have been synced.
+     */
     @JsonProperty("resources")
     public void setResources(List<SyncStatus> resources) {
         this.resources = resources;
     }
 
+    /**
+     * Secrets is the list of SyncStatus for secrets that have been synced.
+     */
     @JsonProperty("secrets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SyncStatus> getSecrets() {
         return secrets;
     }
 
+    /**
+     * Secrets is the list of SyncStatus for secrets that have been synced.
+     */
     @JsonProperty("secrets")
     public void setSecrets(List<SyncStatus> secrets) {
         this.secrets = secrets;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncSetSpec.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncSetSpec.java
index 6066ea3777e..da42841e226 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncSetSpec.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncSetSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SyncSetSpec defines the SyncSetCommonSpec resources and patches to sync along with ClusterDeploymentRefs indicating which clusters the SyncSet applies to in the SyncSet's namespace.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -109,76 +112,118 @@ public SyncSetSpec(String applyBehavior, List<LocalObjectReference> clusterDeplo
         this.secretMappings = secretMappings;
     }
 
+    /**
+     * ApplyBehavior indicates how resources in this syncset will be applied to the target cluster. The default value of "Apply" indicates that resources should be applied using the 'oc apply' command. If no value is set, "Apply" is assumed. A value of "CreateOnly" indicates that the resource will only be created if it does not already exist in the target cluster. Otherwise, it will be left alone. A value of "CreateOrUpdate" indicates that the resource will be created/updated without the use of the 'oc apply' command, allowing larger resources to be synced, but losing some functionality of the 'oc apply' command such as the ability to remove annotations, labels, and other map entries in general.
+     */
     @JsonProperty("applyBehavior")
     public String getApplyBehavior() {
         return applyBehavior;
     }
 
+    /**
+     * ApplyBehavior indicates how resources in this syncset will be applied to the target cluster. The default value of "Apply" indicates that resources should be applied using the 'oc apply' command. If no value is set, "Apply" is assumed. A value of "CreateOnly" indicates that the resource will only be created if it does not already exist in the target cluster. Otherwise, it will be left alone. A value of "CreateOrUpdate" indicates that the resource will be created/updated without the use of the 'oc apply' command, allowing larger resources to be synced, but losing some functionality of the 'oc apply' command such as the ability to remove annotations, labels, and other map entries in general.
+     */
     @JsonProperty("applyBehavior")
     public void setApplyBehavior(String applyBehavior) {
         this.applyBehavior = applyBehavior;
     }
 
+    /**
+     * ClusterDeploymentRefs is the list of LocalObjectReference indicating which clusters the SyncSet applies to in the SyncSet's namespace.
+     */
     @JsonProperty("clusterDeploymentRefs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LocalObjectReference> getClusterDeploymentRefs() {
         return clusterDeploymentRefs;
     }
 
+    /**
+     * ClusterDeploymentRefs is the list of LocalObjectReference indicating which clusters the SyncSet applies to in the SyncSet's namespace.
+     */
     @JsonProperty("clusterDeploymentRefs")
     public void setClusterDeploymentRefs(List<LocalObjectReference> clusterDeploymentRefs) {
         this.clusterDeploymentRefs = clusterDeploymentRefs;
     }
 
+    /**
+     * EnableResourceTemplates, if True, causes hive to honor golang text/templates in Resources. While the standard syntax is supported, it won't do you a whole lot of good as the parser does not pass a data object (i.e. there is no "dot" for you to use). This currently exists to expose a single function: {{ fromCDLabel "some.label/key" }} will be substituted with the string value of ClusterDeployment.Labels["some.label/key"]. The empty string is interpolated if there are no labels, or if the indicated key does not exist. Note that this only works in values (not e.g. map keys) that are of type string.
+     */
     @JsonProperty("enableResourceTemplates")
     public Boolean getEnableResourceTemplates() {
         return enableResourceTemplates;
     }
 
+    /**
+     * EnableResourceTemplates, if True, causes hive to honor golang text/templates in Resources. While the standard syntax is supported, it won't do you a whole lot of good as the parser does not pass a data object (i.e. there is no "dot" for you to use). This currently exists to expose a single function: {{ fromCDLabel "some.label/key" }} will be substituted with the string value of ClusterDeployment.Labels["some.label/key"]. The empty string is interpolated if there are no labels, or if the indicated key does not exist. Note that this only works in values (not e.g. map keys) that are of type string.
+     */
     @JsonProperty("enableResourceTemplates")
     public void setEnableResourceTemplates(Boolean enableResourceTemplates) {
         this.enableResourceTemplates = enableResourceTemplates;
     }
 
+    /**
+     * Patches is the list of patches to apply.
+     */
     @JsonProperty("patches")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SyncObjectPatch> getPatches() {
         return patches;
     }
 
+    /**
+     * Patches is the list of patches to apply.
+     */
     @JsonProperty("patches")
     public void setPatches(List<SyncObjectPatch> patches) {
         this.patches = patches;
     }
 
+    /**
+     * ResourceApplyMode indicates if the Resource apply mode is "Upsert" (default) or "Sync". ApplyMode "Upsert" indicates create and update. ApplyMode "Sync" indicates create, update and delete.
+     */
     @JsonProperty("resourceApplyMode")
     public String getResourceApplyMode() {
         return resourceApplyMode;
     }
 
+    /**
+     * ResourceApplyMode indicates if the Resource apply mode is "Upsert" (default) or "Sync". ApplyMode "Upsert" indicates create and update. ApplyMode "Sync" indicates create, update and delete.
+     */
     @JsonProperty("resourceApplyMode")
     public void setResourceApplyMode(String resourceApplyMode) {
         this.resourceApplyMode = resourceApplyMode;
     }
 
+    /**
+     * Resources is the list of objects to sync from RawExtension definitions.
+     */
     @JsonProperty("resources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Object> getResources() {
         return resources;
     }
 
+    /**
+     * Resources is the list of objects to sync from RawExtension definitions.
+     */
     @JsonProperty("resources")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializerForList.class)
     public void setResources(List<Object> resources) {
         this.resources = resources;
     }
 
+    /**
+     * Secrets is the list of secrets to sync along with their respective destinations.
+     */
     @JsonProperty("secretMappings")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SecretMapping> getSecretMappings() {
         return secretMappings;
     }
 
+    /**
+     * Secrets is the list of secrets to sync along with their respective destinations.
+     */
     @JsonProperty("secretMappings")
     public void setSecretMappings(List<SecretMapping> secretMappings) {
         this.secretMappings = secretMappings;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncSetStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncSetStatus.java
index 2bbc9603d2e..0e54bf8886e 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncSetStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncSetStatus.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SyncSetStatus defines the observed state of a SyncSet
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncStatus.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncStatus.java
index a994a96705f..75be7cb9229 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncStatus.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/SyncStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SyncStatus describes objects that have been created or patches that have been applied using the unique md5 sum of the object or patch.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -105,72 +108,114 @@ public SyncStatus(String apiVersion, List<SyncCondition> conditions, String hash
         this.resource = resource;
     }
 
+    /**
+     * APIVersion is the Group and Version of the object that was synced or patched.
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * APIVersion is the Group and Version of the object that was synced or patched.
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Conditions is the list of conditions indicating success or failure of object create, update and delete as well as patch application.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SyncCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions is the list of conditions indicating success or failure of object create, update and delete as well as patch application.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<SyncCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Hash is the unique md5 hash of the resource or patch.
+     */
     @JsonProperty("hash")
     public String getHash() {
         return hash;
     }
 
+    /**
+     * Hash is the unique md5 hash of the resource or patch.
+     */
     @JsonProperty("hash")
     public void setHash(String hash) {
         this.hash = hash;
     }
 
+    /**
+     * Kind is the Kind of the object that was synced or patched.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is the Kind of the object that was synced or patched.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of the object that was synced or patched.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the object that was synced or patched.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace is the Namespace of the object that was synced or patched.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the Namespace of the object that was synced or patched.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Resource is the resource name for the object that was synced. This will be populated for resources, but not patches
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * Resource is the resource name for the object that was synced. This will be populated for resources, but not patches
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/TaintIdentifier.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/TaintIdentifier.java
index 3460b033236..7d7758ce465 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/TaintIdentifier.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/TaintIdentifier.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TaintIdentifier uniquely identifies a Taint. (It turns out taints are mutually exclusive by key+effect, not simply by key.)
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public TaintIdentifier(String effect, String key) {
         this.key = key;
     }
 
+    /**
+     * Effect matches corev1.Taint.Effect.<br><p> <br><p> Possible enum values:<br><p>  - `"NoExecute"` Evict any already-running pods that do not tolerate the taint. Currently enforced by NodeController.<br><p>  - `"NoSchedule"` Do not allow new pods to schedule onto the node unless they tolerate the taint, but allow all pods submitted to Kubelet without going through the scheduler to start, and allow all already-running pods to continue running. Enforced by the scheduler.<br><p>  - `"PreferNoSchedule"` Like TaintEffectNoSchedule, but the scheduler tries not to schedule new pods onto the node, rather than prohibiting new pods from scheduling onto the node entirely. Enforced by the scheduler.
+     */
     @JsonProperty("effect")
     public String getEffect() {
         return effect;
     }
 
+    /**
+     * Effect matches corev1.Taint.Effect.<br><p> <br><p> Possible enum values:<br><p>  - `"NoExecute"` Evict any already-running pods that do not tolerate the taint. Currently enforced by NodeController.<br><p>  - `"NoSchedule"` Do not allow new pods to schedule onto the node unless they tolerate the taint, but allow all pods submitted to Kubelet without going through the scheduler to start, and allow all already-running pods to continue running. Enforced by the scheduler.<br><p>  - `"PreferNoSchedule"` Like TaintEffectNoSchedule, but the scheduler tries not to schedule new pods onto the node, rather than prohibiting new pods from scheduling onto the node entirely. Enforced by the scheduler.
+     */
     @JsonProperty("effect")
     public void setEffect(String effect) {
         this.effect = effect;
     }
 
+    /**
+     * Key matches corev1.Taint.Key.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * Key matches corev1.Taint.Key.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/VSphereClusterDeprovision.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/VSphereClusterDeprovision.java
index 40fc2b1a6f4..a8ce8dabfe9 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/VSphereClusterDeprovision.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/VSphereClusterDeprovision.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VSphereClusterDeprovision contains VMware vSphere-specific configuration for a ClusterDeprovision
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public VSphereClusterDeprovision(LocalObjectReference certificatesSecretRef, Loc
         this.vCenter = vCenter;
     }
 
+    /**
+     * VSphereClusterDeprovision contains VMware vSphere-specific configuration for a ClusterDeprovision
+     */
     @JsonProperty("certificatesSecretRef")
     public LocalObjectReference getCertificatesSecretRef() {
         return certificatesSecretRef;
     }
 
+    /**
+     * VSphereClusterDeprovision contains VMware vSphere-specific configuration for a ClusterDeprovision
+     */
     @JsonProperty("certificatesSecretRef")
     public void setCertificatesSecretRef(LocalObjectReference certificatesSecretRef) {
         this.certificatesSecretRef = certificatesSecretRef;
     }
 
+    /**
+     * VSphereClusterDeprovision contains VMware vSphere-specific configuration for a ClusterDeprovision
+     */
     @JsonProperty("credentialsSecretRef")
     public LocalObjectReference getCredentialsSecretRef() {
         return credentialsSecretRef;
     }
 
+    /**
+     * VSphereClusterDeprovision contains VMware vSphere-specific configuration for a ClusterDeprovision
+     */
     @JsonProperty("credentialsSecretRef")
     public void setCredentialsSecretRef(LocalObjectReference credentialsSecretRef) {
         this.credentialsSecretRef = credentialsSecretRef;
     }
 
+    /**
+     * VCenter is the vSphere vCenter hostname.
+     */
     @JsonProperty("vCenter")
     public String getVCenter() {
         return vCenter;
     }
 
+    /**
+     * VCenter is the vSphere vCenter hostname.
+     */
     @JsonProperty("vCenter")
     public void setVCenter(String vCenter) {
         this.vCenter = vCenter;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/VeleroBackupConfig.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/VeleroBackupConfig.java
index e8c55a12bbd..3f117fcdd7f 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/VeleroBackupConfig.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/v1/VeleroBackupConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VeleroBackupConfig contains settings for the Velero backup integration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public VeleroBackupConfig(Boolean enabled, String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Enabled dictates if Velero backup integration is enabled. If not specified, the default is disabled.
+     */
     @JsonProperty("enabled")
     public Boolean getEnabled() {
         return enabled;
     }
 
+    /**
+     * Enabled dictates if Velero backup integration is enabled. If not specified, the default is disabled.
+     */
     @JsonProperty("enabled")
     public void setEnabled(Boolean enabled) {
         this.enabled = enabled;
     }
 
+    /**
+     * Namespace specifies in which namespace velero backup objects should be created. If not specified, the default is a namespace named "velero".
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace specifies in which namespace velero backup objects should be created. If not specified, the default is a namespace named "velero".
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/vsphere/v1/MachinePool.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/vsphere/v1/MachinePool.java
index a16008dfa30..108b1da0d9d 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/vsphere/v1/MachinePool.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/vsphere/v1/MachinePool.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePool stores the configuration for a machine pool installed on vSphere.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public MachinePool(Integer coresPerSocket, Integer cpus, Long memoryMB, OSDisk o
         this.resourcePool = resourcePool;
     }
 
+    /**
+     * NumCoresPerSocket is the number of cores per socket in a vm. The number of vCPUs on the vm will be NumCPUs/NumCoresPerSocket.
+     */
     @JsonProperty("coresPerSocket")
     public Integer getCoresPerSocket() {
         return coresPerSocket;
     }
 
+    /**
+     * NumCoresPerSocket is the number of cores per socket in a vm. The number of vCPUs on the vm will be NumCPUs/NumCoresPerSocket.
+     */
     @JsonProperty("coresPerSocket")
     public void setCoresPerSocket(Integer coresPerSocket) {
         this.coresPerSocket = coresPerSocket;
     }
 
+    /**
+     * NumCPUs is the total number of virtual processor cores to assign a vm.
+     */
     @JsonProperty("cpus")
     public Integer getCpus() {
         return cpus;
     }
 
+    /**
+     * NumCPUs is the total number of virtual processor cores to assign a vm.
+     */
     @JsonProperty("cpus")
     public void setCpus(Integer cpus) {
         this.cpus = cpus;
     }
 
+    /**
+     * Memory is the size of a VM's memory in MB.
+     */
     @JsonProperty("memoryMB")
     public Long getMemoryMB() {
         return memoryMB;
     }
 
+    /**
+     * Memory is the size of a VM's memory in MB.
+     */
     @JsonProperty("memoryMB")
     public void setMemoryMB(Long memoryMB) {
         this.memoryMB = memoryMB;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on vSphere.
+     */
     @JsonProperty("osDisk")
     public OSDisk getOsDisk() {
         return osDisk;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on vSphere.
+     */
     @JsonProperty("osDisk")
     public void setOsDisk(OSDisk osDisk) {
         this.osDisk = osDisk;
     }
 
+    /**
+     * ResourcePool is the name of the resource pool that will be used for virtual machines. If it is not present, a default value will be used.
+     */
     @JsonProperty("resourcePool")
     public String getResourcePool() {
         return resourcePool;
     }
 
+    /**
+     * ResourcePool is the name of the resource pool that will be used for virtual machines. If it is not present, a default value will be used.
+     */
     @JsonProperty("resourcePool")
     public void setResourcePool(String resourcePool) {
         this.resourcePool = resourcePool;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/vsphere/v1/OSDisk.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/vsphere/v1/OSDisk.java
index d95f459c4c3..f4eb5e5cdfa 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/vsphere/v1/OSDisk.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/vsphere/v1/OSDisk.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OSDisk defines the disk for a virtual machine.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public OSDisk(Integer diskSizeGB) {
         this.diskSizeGB = diskSizeGB;
     }
 
+    /**
+     * DiskSizeGB defines the size of disk in GB.
+     */
     @JsonProperty("diskSizeGB")
     public Integer getDiskSizeGB() {
         return diskSizeGB;
     }
 
+    /**
+     * DiskSizeGB defines the size of disk in GB.
+     */
     @JsonProperty("diskSizeGB")
     public void setDiskSizeGB(Integer diskSizeGB) {
         this.diskSizeGB = diskSizeGB;
diff --git a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/vsphere/v1/Platform.java b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/vsphere/v1/Platform.java
index e5d29dc7ab0..2bf1d46358c 100644
--- a/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/vsphere/v1/Platform.java
+++ b/kubernetes-model-generator/openshift-model-hive/src/generated/java/io/fabric8/openshift/api/model/hive/vsphere/v1/Platform.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Platform stores any global configuration used for vSphere platforms.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -106,81 +109,129 @@ public Platform(LocalObjectReference certificatesSecretRef, String cluster, Loca
         this.vCenter = vCenter;
     }
 
+    /**
+     * Platform stores any global configuration used for vSphere platforms.
+     */
     @JsonProperty("certificatesSecretRef")
     public LocalObjectReference getCertificatesSecretRef() {
         return certificatesSecretRef;
     }
 
+    /**
+     * Platform stores any global configuration used for vSphere platforms.
+     */
     @JsonProperty("certificatesSecretRef")
     public void setCertificatesSecretRef(LocalObjectReference certificatesSecretRef) {
         this.certificatesSecretRef = certificatesSecretRef;
     }
 
+    /**
+     * Cluster is the name of the cluster virtual machines will be cloned into.
+     */
     @JsonProperty("cluster")
     public String getCluster() {
         return cluster;
     }
 
+    /**
+     * Cluster is the name of the cluster virtual machines will be cloned into.
+     */
     @JsonProperty("cluster")
     public void setCluster(String cluster) {
         this.cluster = cluster;
     }
 
+    /**
+     * Platform stores any global configuration used for vSphere platforms.
+     */
     @JsonProperty("credentialsSecretRef")
     public LocalObjectReference getCredentialsSecretRef() {
         return credentialsSecretRef;
     }
 
+    /**
+     * Platform stores any global configuration used for vSphere platforms.
+     */
     @JsonProperty("credentialsSecretRef")
     public void setCredentialsSecretRef(LocalObjectReference credentialsSecretRef) {
         this.credentialsSecretRef = credentialsSecretRef;
     }
 
+    /**
+     * Datacenter is the name of the datacenter to use in the vCenter.
+     */
     @JsonProperty("datacenter")
     public String getDatacenter() {
         return datacenter;
     }
 
+    /**
+     * Datacenter is the name of the datacenter to use in the vCenter.
+     */
     @JsonProperty("datacenter")
     public void setDatacenter(String datacenter) {
         this.datacenter = datacenter;
     }
 
+    /**
+     * DefaultDatastore is the default datastore to use for provisioning volumes.
+     */
     @JsonProperty("defaultDatastore")
     public String getDefaultDatastore() {
         return defaultDatastore;
     }
 
+    /**
+     * DefaultDatastore is the default datastore to use for provisioning volumes.
+     */
     @JsonProperty("defaultDatastore")
     public void setDefaultDatastore(String defaultDatastore) {
         this.defaultDatastore = defaultDatastore;
     }
 
+    /**
+     * Folder is the name of the folder that will be used and/or created for virtual machines.
+     */
     @JsonProperty("folder")
     public String getFolder() {
         return folder;
     }
 
+    /**
+     * Folder is the name of the folder that will be used and/or created for virtual machines.
+     */
     @JsonProperty("folder")
     public void setFolder(String folder) {
         this.folder = folder;
     }
 
+    /**
+     * Network specifies the name of the network to be used by the cluster.
+     */
     @JsonProperty("network")
     public String getNetwork() {
         return network;
     }
 
+    /**
+     * Network specifies the name of the network to be used by the cluster.
+     */
     @JsonProperty("network")
     public void setNetwork(String network) {
         this.network = network;
     }
 
+    /**
+     * VCenter is the domain name or IP address of the vCenter.
+     */
     @JsonProperty("vCenter")
     public String getVCenter() {
         return vCenter;
     }
 
+    /**
+     * VCenter is the domain name or IP address of the vCenter.
+     */
     @JsonProperty("vCenter")
     public void setVCenter(String vCenter) {
         this.vCenter = vCenter;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/aws/v1/EC2Metadata.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/aws/v1/EC2Metadata.java
index cb44abae7c5..9085c88d569 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/aws/v1/EC2Metadata.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/aws/v1/EC2Metadata.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EC2Metadata defines the metadata service interaction options for an ec2 instance. https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-service.html
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public EC2Metadata(String authentication) {
         this.authentication = authentication;
     }
 
+    /**
+     * Authentication determines whether or not the host requires the use of authentication when interacting with the metadata service. When using authentication, this enforces v2 interaction method (IMDSv2) with the metadata service. When omitted, this means the user has no opinion and the value is left to the platform to choose a good default, which is subject to change over time. The current default is optional. At this point this field represents `HttpTokens` parameter from `InstanceMetadataOptionsRequest` structure in AWS EC2 API https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_InstanceMetadataOptionsRequest.html
+     */
     @JsonProperty("authentication")
     public String getAuthentication() {
         return authentication;
     }
 
+    /**
+     * Authentication determines whether or not the host requires the use of authentication when interacting with the metadata service. When using authentication, this enforces v2 interaction method (IMDSv2) with the metadata service. When omitted, this means the user has no opinion and the value is left to the platform to choose a good default, which is subject to change over time. The current default is optional. At this point this field represents `HttpTokens` parameter from `InstanceMetadataOptionsRequest` structure in AWS EC2 API https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_InstanceMetadataOptionsRequest.html
+     */
     @JsonProperty("authentication")
     public void setAuthentication(String authentication) {
         this.authentication = authentication;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/aws/v1/EC2RootVolume.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/aws/v1/EC2RootVolume.java
index 789f7d55ed7..e06f4198ef8 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/aws/v1/EC2RootVolume.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/aws/v1/EC2RootVolume.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EC2RootVolume defines the storage for an ec2 instance.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public EC2RootVolume(Integer iops, String kmsKeyARN, Integer size, String type)
         this.type = type;
     }
 
+    /**
+     * IOPS defines the amount of provisioned IOPS. (KiB/s). IOPS may only be set for io1, io2, &amp; gp3 volume types.
+     */
     @JsonProperty("iops")
     public Integer getIops() {
         return iops;
     }
 
+    /**
+     * IOPS defines the amount of provisioned IOPS. (KiB/s). IOPS may only be set for io1, io2, &amp; gp3 volume types.
+     */
     @JsonProperty("iops")
     public void setIops(Integer iops) {
         this.iops = iops;
     }
 
+    /**
+     * The KMS key that will be used to encrypt the EBS volume. If no key is provided the default KMS key for the account will be used. https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_GetEbsDefaultKmsKeyId.html
+     */
     @JsonProperty("kmsKeyARN")
     public String getKmsKeyARN() {
         return kmsKeyARN;
     }
 
+    /**
+     * The KMS key that will be used to encrypt the EBS volume. If no key is provided the default KMS key for the account will be used. https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_GetEbsDefaultKmsKeyId.html
+     */
     @JsonProperty("kmsKeyARN")
     public void setKmsKeyARN(String kmsKeyARN) {
         this.kmsKeyARN = kmsKeyARN;
     }
 
+    /**
+     * Size defines the size of the volume in gibibytes (GiB).
+     */
     @JsonProperty("size")
     public Integer getSize() {
         return size;
     }
 
+    /**
+     * Size defines the size of the volume in gibibytes (GiB).
+     */
     @JsonProperty("size")
     public void setSize(Integer size) {
         this.size = size;
     }
 
+    /**
+     * Type defines the type of the volume.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type defines the type of the volume.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/aws/v1/MachinePool.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/aws/v1/MachinePool.java
index 00e09128132..c8a09f1ad66 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/aws/v1/MachinePool.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/aws/v1/MachinePool.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePool stores the configuration for a machine pool installed on AWS.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -110,83 +113,131 @@ public MachinePool(List<String> additionalSecurityGroupIDs, String amiID, String
         this.zones = zones;
     }
 
+    /**
+     * AdditionalSecurityGroupIDs contains IDs of additional security groups for machines, where each ID is presented in the format sg-xxxx.
+     */
     @JsonProperty("additionalSecurityGroupIDs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAdditionalSecurityGroupIDs() {
         return additionalSecurityGroupIDs;
     }
 
+    /**
+     * AdditionalSecurityGroupIDs contains IDs of additional security groups for machines, where each ID is presented in the format sg-xxxx.
+     */
     @JsonProperty("additionalSecurityGroupIDs")
     public void setAdditionalSecurityGroupIDs(List<String> additionalSecurityGroupIDs) {
         this.additionalSecurityGroupIDs = additionalSecurityGroupIDs;
     }
 
+    /**
+     * AMIID is the AMI that should be used to boot the ec2 instance. If set, the AMI should belong to the same region as the cluster.
+     */
     @JsonProperty("amiID")
     public String getAmiID() {
         return amiID;
     }
 
+    /**
+     * AMIID is the AMI that should be used to boot the ec2 instance. If set, the AMI should belong to the same region as the cluster.
+     */
     @JsonProperty("amiID")
     public void setAmiID(String amiID) {
         this.amiID = amiID;
     }
 
+    /**
+     * IAMProfile is the name of the IAM instance profile to use for the machine. Leave unset to have the installer create the IAM Profile on your behalf. Cannot be specified together with iamRole.
+     */
     @JsonProperty("iamProfile")
     public String getIamProfile() {
         return iamProfile;
     }
 
+    /**
+     * IAMProfile is the name of the IAM instance profile to use for the machine. Leave unset to have the installer create the IAM Profile on your behalf. Cannot be specified together with iamRole.
+     */
     @JsonProperty("iamProfile")
     public void setIamProfile(String iamProfile) {
         this.iamProfile = iamProfile;
     }
 
+    /**
+     * IAMRole is the name of the IAM Role to use for the instance profile of the machine. Leave unset to have the installer create the IAM Role on your behalf. Cannot be specified together with iamProfile.
+     */
     @JsonProperty("iamRole")
     public String getIamRole() {
         return iamRole;
     }
 
+    /**
+     * IAMRole is the name of the IAM Role to use for the instance profile of the machine. Leave unset to have the installer create the IAM Role on your behalf. Cannot be specified together with iamProfile.
+     */
     @JsonProperty("iamRole")
     public void setIamRole(String iamRole) {
         this.iamRole = iamRole;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on AWS.
+     */
     @JsonProperty("metadataService")
     public EC2Metadata getMetadataService() {
         return metadataService;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on AWS.
+     */
     @JsonProperty("metadataService")
     public void setMetadataService(EC2Metadata metadataService) {
         this.metadataService = metadataService;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on AWS.
+     */
     @JsonProperty("rootVolume")
     public EC2RootVolume getRootVolume() {
         return rootVolume;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on AWS.
+     */
     @JsonProperty("rootVolume")
     public void setRootVolume(EC2RootVolume rootVolume) {
         this.rootVolume = rootVolume;
     }
 
+    /**
+     * InstanceType defines the ec2 instance type. eg. m4-large
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * InstanceType defines the ec2 instance type. eg. m4-large
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * Zones is list of availability zones that can be used.
+     */
     @JsonProperty("zones")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getZones() {
         return zones;
     }
 
+    /**
+     * Zones is list of availability zones that can be used.
+     */
     @JsonProperty("zones")
     public void setZones(List<String> zones) {
         this.zones = zones;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/aws/v1/Metadata.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/aws/v1/Metadata.java
index ea80df39e1d..d5f5b039d0b 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/aws/v1/Metadata.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/aws/v1/Metadata.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metadata contains AWS metadata (e.g. for uninstalling the cluster).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,53 +101,83 @@ public Metadata(String clusterDomain, String hostedZoneRole, List<Map<String, St
         this.serviceEndpoints = serviceEndpoints;
     }
 
+    /**
+     * ClusterDomain is the domain for the cluster.
+     */
     @JsonProperty("clusterDomain")
     public String getClusterDomain() {
         return clusterDomain;
     }
 
+    /**
+     * ClusterDomain is the domain for the cluster.
+     */
     @JsonProperty("clusterDomain")
     public void setClusterDomain(String clusterDomain) {
         this.clusterDomain = clusterDomain;
     }
 
+    /**
+     * HostedZoneRole is the role to assume when performing operations on a hosted zone owned by another account.
+     */
     @JsonProperty("hostedZoneRole")
     public String getHostedZoneRole() {
         return hostedZoneRole;
     }
 
+    /**
+     * HostedZoneRole is the role to assume when performing operations on a hosted zone owned by another account.
+     */
     @JsonProperty("hostedZoneRole")
     public void setHostedZoneRole(String hostedZoneRole) {
         this.hostedZoneRole = hostedZoneRole;
     }
 
+    /**
+     * Identifier holds a slice of filter maps.  The maps hold the key/value pairs for the tags we will be matching against.  A resource matches the map if all of the key/value pairs are in its tags.  A resource matches Identifier if it matches any of the maps.
+     */
     @JsonProperty("identifier")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Map<String, String>> getIdentifier() {
         return identifier;
     }
 
+    /**
+     * Identifier holds a slice of filter maps.  The maps hold the key/value pairs for the tags we will be matching against.  A resource matches the map if all of the key/value pairs are in its tags.  A resource matches Identifier if it matches any of the maps.
+     */
     @JsonProperty("identifier")
     public void setIdentifier(List<Map<String, String>> identifier) {
         this.identifier = identifier;
     }
 
+    /**
+     * Metadata contains AWS metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Metadata contains AWS metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * ServiceEndpoints list contains custom endpoints which will override default service endpoint of AWS Services. There must be only one ServiceEndpoint for a service.
+     */
     @JsonProperty("serviceEndpoints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ServiceEndpoint> getServiceEndpoints() {
         return serviceEndpoints;
     }
 
+    /**
+     * ServiceEndpoints list contains custom endpoints which will override default service endpoint of AWS Services. There must be only one ServiceEndpoint for a service.
+     */
     @JsonProperty("serviceEndpoints")
     public void setServiceEndpoints(List<ServiceEndpoint> serviceEndpoints) {
         this.serviceEndpoints = serviceEndpoints;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/aws/v1/Platform.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/aws/v1/Platform.java
index e128dc1b80a..178f4eac236 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/aws/v1/Platform.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/aws/v1/Platform.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Platform stores all the global configuration that all machinesets use.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -135,144 +138,228 @@ public Platform(String amiID, Boolean bestEffortDeleteIgnition, MachinePool defa
         this.userTags = userTags;
     }
 
+    /**
+     * The field is deprecated. AMIID is the AMI that should be used to boot machines for the cluster. If set, the AMI should belong to the same region as the cluster.
+     */
     @JsonProperty("amiID")
     public String getAmiID() {
         return amiID;
     }
 
+    /**
+     * The field is deprecated. AMIID is the AMI that should be used to boot machines for the cluster. If set, the AMI should belong to the same region as the cluster.
+     */
     @JsonProperty("amiID")
     public void setAmiID(String amiID) {
         this.amiID = amiID;
     }
 
+    /**
+     * BestEffortDeleteIgnition is an optional field that can be used to ignore errors from S3 deletion of ignition objects during cluster bootstrap. The default behavior is to fail the installation if ignition objects cannot be deleted. Enable this functionality when there are known reasons disallowing their deletion.
+     */
     @JsonProperty("bestEffortDeleteIgnition")
     public Boolean getBestEffortDeleteIgnition() {
         return bestEffortDeleteIgnition;
     }
 
+    /**
+     * BestEffortDeleteIgnition is an optional field that can be used to ignore errors from S3 deletion of ignition objects during cluster bootstrap. The default behavior is to fail the installation if ignition objects cannot be deleted. Enable this functionality when there are known reasons disallowing their deletion.
+     */
     @JsonProperty("bestEffortDeleteIgnition")
     public void setBestEffortDeleteIgnition(Boolean bestEffortDeleteIgnition) {
         this.bestEffortDeleteIgnition = bestEffortDeleteIgnition;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("defaultMachinePlatform")
     public MachinePool getDefaultMachinePlatform() {
         return defaultMachinePlatform;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("defaultMachinePlatform")
     public void setDefaultMachinePlatform(MachinePool defaultMachinePlatform) {
         this.defaultMachinePlatform = defaultMachinePlatform;
     }
 
+    /**
+     * The field is deprecated. ExperimentalPropagateUserTags is an experimental flag that directs in-cluster operators to include the specified user tags in the tags of the AWS resources that the operators create.
+     */
     @JsonProperty("experimentalPropagateUserTags")
     public Boolean getExperimentalPropagateUserTags() {
         return experimentalPropagateUserTags;
     }
 
+    /**
+     * The field is deprecated. ExperimentalPropagateUserTags is an experimental flag that directs in-cluster operators to include the specified user tags in the tags of the AWS resources that the operators create.
+     */
     @JsonProperty("experimentalPropagateUserTags")
     public void setExperimentalPropagateUserTags(Boolean experimentalPropagateUserTags) {
         this.experimentalPropagateUserTags = experimentalPropagateUserTags;
     }
 
+    /**
+     * HostedZone is the ID of an existing hosted zone into which to add DNS records for the cluster's internal API. An existing hosted zone can only be used when also using existing subnets. The hosted zone must be associated with the VPC containing the subnets. Leave the hosted zone unset to have the installer create the hosted zone on your behalf.
+     */
     @JsonProperty("hostedZone")
     public String getHostedZone() {
         return hostedZone;
     }
 
+    /**
+     * HostedZone is the ID of an existing hosted zone into which to add DNS records for the cluster's internal API. An existing hosted zone can only be used when also using existing subnets. The hosted zone must be associated with the VPC containing the subnets. Leave the hosted zone unset to have the installer create the hosted zone on your behalf.
+     */
     @JsonProperty("hostedZone")
     public void setHostedZone(String hostedZone) {
         this.hostedZone = hostedZone;
     }
 
+    /**
+     * HostedZoneRole is the ARN of an IAM role to be assumed when performing operations on the provided HostedZone. HostedZoneRole can be used in a shared VPC scenario when the private hosted zone belongs to a different account than the rest of the cluster resources. If HostedZoneRole is set, HostedZone must also be set.
+     */
     @JsonProperty("hostedZoneRole")
     public String getHostedZoneRole() {
         return hostedZoneRole;
     }
 
+    /**
+     * HostedZoneRole is the ARN of an IAM role to be assumed when performing operations on the provided HostedZone. HostedZoneRole can be used in a shared VPC scenario when the private hosted zone belongs to a different account than the rest of the cluster resources. If HostedZoneRole is set, HostedZone must also be set.
+     */
     @JsonProperty("hostedZoneRole")
     public void setHostedZoneRole(String hostedZoneRole) {
         this.hostedZoneRole = hostedZoneRole;
     }
 
+    /**
+     * LBType is an optional field to specify a load balancer type. When this field is specified, all ingresscontrollers (including the default ingresscontroller) will be created using the specified load-balancer type by default.<br><p> <br><p> Following are the accepted values:<br><p> <br><p> &#42; "Classic": A Classic Load Balancer that makes routing decisions at either the transport layer (TCP/SSL) or the application layer (HTTP/HTTPS). See the following for additional details: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/load-balancer-types.html#clb<br><p> <br><p> &#42; "NLB": A Network Load Balancer that makes routing decisions at the transport layer (TCP/SSL). See the following for additional details: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/load-balancer-types.html#nlb<br><p> <br><p> If this field is not set explicitly, it defaults to "Classic".  This default is subject to change over time.
+     */
     @JsonProperty("lbType")
     public String getLbType() {
         return lbType;
     }
 
+    /**
+     * LBType is an optional field to specify a load balancer type. When this field is specified, all ingresscontrollers (including the default ingresscontroller) will be created using the specified load-balancer type by default.<br><p> <br><p> Following are the accepted values:<br><p> <br><p> &#42; "Classic": A Classic Load Balancer that makes routing decisions at either the transport layer (TCP/SSL) or the application layer (HTTP/HTTPS). See the following for additional details: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/load-balancer-types.html#clb<br><p> <br><p> &#42; "NLB": A Network Load Balancer that makes routing decisions at the transport layer (TCP/SSL). See the following for additional details: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/load-balancer-types.html#nlb<br><p> <br><p> If this field is not set explicitly, it defaults to "Classic".  This default is subject to change over time.
+     */
     @JsonProperty("lbType")
     public void setLbType(String lbType) {
         this.lbType = lbType;
     }
 
+    /**
+     * PreserveBootstrapIgnition is deprecated. Use bestEffortDeleteIgnition instead.
+     */
     @JsonProperty("preserveBootstrapIgnition")
     public Boolean getPreserveBootstrapIgnition() {
         return preserveBootstrapIgnition;
     }
 
+    /**
+     * PreserveBootstrapIgnition is deprecated. Use bestEffortDeleteIgnition instead.
+     */
     @JsonProperty("preserveBootstrapIgnition")
     public void setPreserveBootstrapIgnition(Boolean preserveBootstrapIgnition) {
         this.preserveBootstrapIgnition = preserveBootstrapIgnition;
     }
 
+    /**
+     * PropagateUserTags is a flag that directs in-cluster operators to include the specified user tags in the tags of the AWS resources that the operators create.
+     */
     @JsonProperty("propagateUserTags")
     public Boolean getPropagateUserTags() {
         return propagateUserTags;
     }
 
+    /**
+     * PropagateUserTags is a flag that directs in-cluster operators to include the specified user tags in the tags of the AWS resources that the operators create.
+     */
     @JsonProperty("propagateUserTags")
     public void setPropagateUserTags(Boolean propagateUserTags) {
         this.propagateUserTags = propagateUserTags;
     }
 
+    /**
+     * PublicIpv4Pool is an optional field that can be used to tell the installation process to use Public IPv4 address that you bring to your AWS account with BYOIP.
+     */
     @JsonProperty("publicIpv4Pool")
     public String getPublicIpv4Pool() {
         return publicIpv4Pool;
     }
 
+    /**
+     * PublicIpv4Pool is an optional field that can be used to tell the installation process to use Public IPv4 address that you bring to your AWS account with BYOIP.
+     */
     @JsonProperty("publicIpv4Pool")
     public void setPublicIpv4Pool(String publicIpv4Pool) {
         this.publicIpv4Pool = publicIpv4Pool;
     }
 
+    /**
+     * Region specifies the AWS region where the cluster will be created.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Region specifies the AWS region where the cluster will be created.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * ServiceEndpoints list contains custom endpoints which will override default service endpoint of AWS Services. There must be only one ServiceEndpoint for a service.
+     */
     @JsonProperty("serviceEndpoints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ServiceEndpoint> getServiceEndpoints() {
         return serviceEndpoints;
     }
 
+    /**
+     * ServiceEndpoints list contains custom endpoints which will override default service endpoint of AWS Services. There must be only one ServiceEndpoint for a service.
+     */
     @JsonProperty("serviceEndpoints")
     public void setServiceEndpoints(List<ServiceEndpoint> serviceEndpoints) {
         this.serviceEndpoints = serviceEndpoints;
     }
 
+    /**
+     * Subnets specifies existing subnets (by ID) where cluster resources will be created.  Leave unset to have the installer create subnets in a new VPC on your behalf.
+     */
     @JsonProperty("subnets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSubnets() {
         return subnets;
     }
 
+    /**
+     * Subnets specifies existing subnets (by ID) where cluster resources will be created.  Leave unset to have the installer create subnets in a new VPC on your behalf.
+     */
     @JsonProperty("subnets")
     public void setSubnets(List<String> subnets) {
         this.subnets = subnets;
     }
 
+    /**
+     * UserTags additional keys and values that the installer will add as tags to all resources that it creates. Resources created by the cluster itself may not include these tags.
+     */
     @JsonProperty("userTags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getUserTags() {
         return userTags;
     }
 
+    /**
+     * UserTags additional keys and values that the installer will add as tags to all resources that it creates. Resources created by the cluster itself may not include these tags.
+     */
     @JsonProperty("userTags")
     public void setUserTags(Map<String, String> userTags) {
         this.userTags = userTags;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/aws/v1/ServiceEndpoint.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/aws/v1/ServiceEndpoint.java
index 961047941ce..62ffc32bb32 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/aws/v1/ServiceEndpoint.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/aws/v1/ServiceEndpoint.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceEndpoint store the configuration for services to override existing defaults of AWS Services.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ServiceEndpoint(String name, String url) {
         this.url = url;
     }
 
+    /**
+     * Name is the name of the AWS service. This must be provided and cannot be empty.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the AWS service. This must be provided and cannot be empty.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * URL is fully qualified URI with scheme https, that overrides the default generated endpoint for a client. This must be provided and cannot be empty.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * URL is fully qualified URI with scheme https, that overrides the default generated endpoint for a client. This must be provided and cannot be empty.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/ConfidentialVM.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/ConfidentialVM.java
index 3ef1b7d3f72..f46beccdb76 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/ConfidentialVM.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/ConfidentialVM.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConfidentialVM defines the UEFI settings for the virtual machine.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ConfidentialVM(UEFISettings uefiSettings) {
         this.uefiSettings = uefiSettings;
     }
 
+    /**
+     * ConfidentialVM defines the UEFI settings for the virtual machine.
+     */
     @JsonProperty("uefiSettings")
     public UEFISettings getUefiSettings() {
         return uefiSettings;
     }
 
+    /**
+     * ConfidentialVM defines the UEFI settings for the virtual machine.
+     */
     @JsonProperty("uefiSettings")
     public void setUefiSettings(UEFISettings uefiSettings) {
         this.uefiSettings = uefiSettings;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/CustomerManagedKey.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/CustomerManagedKey.java
index 3f4c03acd8a..1965d291528 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/CustomerManagedKey.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/CustomerManagedKey.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomerManagedKey defines the customer managed key settings for encryption of the Azure storage account.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public CustomerManagedKey(KeyVault keyVault, String userAssignedIdentityKey) {
         this.userAssignedIdentityKey = userAssignedIdentityKey;
     }
 
+    /**
+     * CustomerManagedKey defines the customer managed key settings for encryption of the Azure storage account.
+     */
     @JsonProperty("keyVault")
     public KeyVault getKeyVault() {
         return keyVault;
     }
 
+    /**
+     * CustomerManagedKey defines the customer managed key settings for encryption of the Azure storage account.
+     */
     @JsonProperty("keyVault")
     public void setKeyVault(KeyVault keyVault) {
         this.keyVault = keyVault;
     }
 
+    /**
+     * UserAssignedIdentityKey is the name of the user identity that has access to the managed key.
+     */
     @JsonProperty("userAssignedIdentityKey")
     public String getUserAssignedIdentityKey() {
         return userAssignedIdentityKey;
     }
 
+    /**
+     * UserAssignedIdentityKey is the name of the user identity that has access to the managed key.
+     */
     @JsonProperty("userAssignedIdentityKey")
     public void setUserAssignedIdentityKey(String userAssignedIdentityKey) {
         this.userAssignedIdentityKey = userAssignedIdentityKey;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/DiskEncryptionSet.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/DiskEncryptionSet.java
index 58e85f24176..9b150845d59 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/DiskEncryptionSet.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/DiskEncryptionSet.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DiskEncryptionSet defines the configuration for a disk encryption set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public DiskEncryptionSet(String name, String resourceGroup, String subscriptionI
         this.subscriptionId = subscriptionId;
     }
 
+    /**
+     * Name is the name of the disk encryption set.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the disk encryption set.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * ResourceGroup defines the Azure resource group used by the disk encryption set.
+     */
     @JsonProperty("resourceGroup")
     public String getResourceGroup() {
         return resourceGroup;
     }
 
+    /**
+     * ResourceGroup defines the Azure resource group used by the disk encryption set.
+     */
     @JsonProperty("resourceGroup")
     public void setResourceGroup(String resourceGroup) {
         this.resourceGroup = resourceGroup;
     }
 
+    /**
+     * SubscriptionID defines the Azure subscription the disk encryption set is in.
+     */
     @JsonProperty("subscriptionId")
     public String getSubscriptionId() {
         return subscriptionId;
     }
 
+    /**
+     * SubscriptionID defines the Azure subscription the disk encryption set is in.
+     */
     @JsonProperty("subscriptionId")
     public void setSubscriptionId(String subscriptionId) {
         this.subscriptionId = subscriptionId;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/KeyVault.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/KeyVault.java
index 5a88e4c99ca..bb794fb1215 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/KeyVault.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/KeyVault.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KeyVault defines an Azure Key Vault.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public KeyVault(String keyName, String name, String resourceGroup) {
         this.resourceGroup = resourceGroup;
     }
 
+    /**
+     * KeyName is the name of the key vault key.
+     */
     @JsonProperty("keyName")
     public String getKeyName() {
         return keyName;
     }
 
+    /**
+     * KeyName is the name of the key vault key.
+     */
     @JsonProperty("keyName")
     public void setKeyName(String keyName) {
         this.keyName = keyName;
     }
 
+    /**
+     * Name is the name of the key vault.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the key vault.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * ResourceGroup defines the Azure resource group used by the key vault.
+     */
     @JsonProperty("resourceGroup")
     public String getResourceGroup() {
         return resourceGroup;
     }
 
+    /**
+     * ResourceGroup defines the Azure resource group used by the key vault.
+     */
     @JsonProperty("resourceGroup")
     public void setResourceGroup(String resourceGroup) {
         this.resourceGroup = resourceGroup;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/MachinePool.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/MachinePool.java
index f15b34b2ec0..c1227ce20b4 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/MachinePool.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/MachinePool.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePool stores the configuration for a machine pool installed on Azure.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -109,82 +112,130 @@ public MachinePool(Boolean encryptionAtHost, OSDisk osDisk, OSImage osImage, Sec
         this.zones = zones;
     }
 
+    /**
+     * EncryptionAtHost enables encryption at the VM host.
+     */
     @JsonProperty("encryptionAtHost")
     public Boolean getEncryptionAtHost() {
         return encryptionAtHost;
     }
 
+    /**
+     * EncryptionAtHost enables encryption at the VM host.
+     */
     @JsonProperty("encryptionAtHost")
     public void setEncryptionAtHost(Boolean encryptionAtHost) {
         this.encryptionAtHost = encryptionAtHost;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on Azure.
+     */
     @JsonProperty("osDisk")
     public OSDisk getOsDisk() {
         return osDisk;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on Azure.
+     */
     @JsonProperty("osDisk")
     public void setOsDisk(OSDisk osDisk) {
         this.osDisk = osDisk;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on Azure.
+     */
     @JsonProperty("osImage")
     public OSImage getOsImage() {
         return osImage;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on Azure.
+     */
     @JsonProperty("osImage")
     public void setOsImage(OSImage osImage) {
         this.osImage = osImage;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on Azure.
+     */
     @JsonProperty("settings")
     public SecuritySettings getSettings() {
         return settings;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on Azure.
+     */
     @JsonProperty("settings")
     public void setSettings(SecuritySettings settings) {
         this.settings = settings;
     }
 
+    /**
+     * InstanceType defines the azure instance type. eg. Standard_DS_V2
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * InstanceType defines the azure instance type. eg. Standard_DS_V2
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * ultraSSDCapability defines if the instance should use Ultra SSD disks.
+     */
     @JsonProperty("ultraSSDCapability")
     public String getUltraSSDCapability() {
         return ultraSSDCapability;
     }
 
+    /**
+     * ultraSSDCapability defines if the instance should use Ultra SSD disks.
+     */
     @JsonProperty("ultraSSDCapability")
     public void setUltraSSDCapability(String ultraSSDCapability) {
         this.ultraSSDCapability = ultraSSDCapability;
     }
 
+    /**
+     * VMNetworkingType specifies whether to enable accelerated networking. Accelerated networking enables single root I/O virtualization (SR-IOV) to a VM, greatly improving its networking performance. eg. values: "Accelerated", "Basic"
+     */
     @JsonProperty("vmNetworkingType")
     public String getVmNetworkingType() {
         return vmNetworkingType;
     }
 
+    /**
+     * VMNetworkingType specifies whether to enable accelerated networking. Accelerated networking enables single root I/O virtualization (SR-IOV) to a VM, greatly improving its networking performance. eg. values: "Accelerated", "Basic"
+     */
     @JsonProperty("vmNetworkingType")
     public void setVmNetworkingType(String vmNetworkingType) {
         this.vmNetworkingType = vmNetworkingType;
     }
 
+    /**
+     * Zones is list of availability zones that can be used. eg. ["1", "2", "3"]
+     */
     @JsonProperty("zones")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getZones() {
         return zones;
     }
 
+    /**
+     * Zones is list of availability zones that can be used. eg. ["1", "2", "3"]
+     */
     @JsonProperty("zones")
     public void setZones(List<String> zones) {
         this.zones = zones;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/Metadata.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/Metadata.java
index e7a268698b5..5900672500c 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/Metadata.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/Metadata.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metadata contains Azure metadata (e.g. for uninstalling the cluster).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public Metadata(String armEndpoint, String baseDomainResourceGroupName, String c
         this.resourceGroupName = resourceGroupName;
     }
 
+    /**
+     * Metadata contains Azure metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("armEndpoint")
     public String getArmEndpoint() {
         return armEndpoint;
     }
 
+    /**
+     * Metadata contains Azure metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("armEndpoint")
     public void setArmEndpoint(String armEndpoint) {
         this.armEndpoint = armEndpoint;
     }
 
+    /**
+     * Metadata contains Azure metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("baseDomainResourceGroupName")
     public String getBaseDomainResourceGroupName() {
         return baseDomainResourceGroupName;
     }
 
+    /**
+     * Metadata contains Azure metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("baseDomainResourceGroupName")
     public void setBaseDomainResourceGroupName(String baseDomainResourceGroupName) {
         this.baseDomainResourceGroupName = baseDomainResourceGroupName;
     }
 
+    /**
+     * Metadata contains Azure metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("cloudName")
     public String getCloudName() {
         return cloudName;
     }
 
+    /**
+     * Metadata contains Azure metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("cloudName")
     public void setCloudName(String cloudName) {
         this.cloudName = cloudName;
     }
 
+    /**
+     * Metadata contains Azure metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Metadata contains Azure metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * Metadata contains Azure metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("resourceGroupName")
     public String getResourceGroupName() {
         return resourceGroupName;
     }
 
+    /**
+     * Metadata contains Azure metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("resourceGroupName")
     public void setResourceGroupName(String resourceGroupName) {
         this.resourceGroupName = resourceGroupName;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/OSDisk.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/OSDisk.java
index 4ac3e1ab8b7..eb54498c6d8 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/OSDisk.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/OSDisk.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OSDisk defines the disk for machines on Azure.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public OSDisk(DiskEncryptionSet diskEncryptionSet, Integer diskSizeGB, String di
         this.securityProfile = securityProfile;
     }
 
+    /**
+     * OSDisk defines the disk for machines on Azure.
+     */
     @JsonProperty("diskEncryptionSet")
     public DiskEncryptionSet getDiskEncryptionSet() {
         return diskEncryptionSet;
     }
 
+    /**
+     * OSDisk defines the disk for machines on Azure.
+     */
     @JsonProperty("diskEncryptionSet")
     public void setDiskEncryptionSet(DiskEncryptionSet diskEncryptionSet) {
         this.diskEncryptionSet = diskEncryptionSet;
     }
 
+    /**
+     * DiskSizeGB defines the size of disk in GB.
+     */
     @JsonProperty("diskSizeGB")
     public Integer getDiskSizeGB() {
         return diskSizeGB;
     }
 
+    /**
+     * DiskSizeGB defines the size of disk in GB.
+     */
     @JsonProperty("diskSizeGB")
     public void setDiskSizeGB(Integer diskSizeGB) {
         this.diskSizeGB = diskSizeGB;
     }
 
+    /**
+     * DiskType defines the type of disk. For control plane nodes, the valid values are Premium_LRS and StandardSSD_LRS. Default is Premium_LRS.
+     */
     @JsonProperty("diskType")
     public String getDiskType() {
         return diskType;
     }
 
+    /**
+     * DiskType defines the type of disk. For control plane nodes, the valid values are Premium_LRS and StandardSSD_LRS. Default is Premium_LRS.
+     */
     @JsonProperty("diskType")
     public void setDiskType(String diskType) {
         this.diskType = diskType;
     }
 
+    /**
+     * OSDisk defines the disk for machines on Azure.
+     */
     @JsonProperty("securityProfile")
     public VMDiskSecurityProfile getSecurityProfile() {
         return securityProfile;
     }
 
+    /**
+     * OSDisk defines the disk for machines on Azure.
+     */
     @JsonProperty("securityProfile")
     public void setSecurityProfile(VMDiskSecurityProfile securityProfile) {
         this.securityProfile = securityProfile;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/OSImage.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/OSImage.java
index 8d66cdc5c0b..bed758c36c1 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/OSImage.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/OSImage.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OSImage is the image to use for the OS of a machine.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public OSImage(String offer, String plan, String publisher, String sku, String v
         this.version = version;
     }
 
+    /**
+     * Offer is the offer of the image.
+     */
     @JsonProperty("offer")
     public String getOffer() {
         return offer;
     }
 
+    /**
+     * Offer is the offer of the image.
+     */
     @JsonProperty("offer")
     public void setOffer(String offer) {
         this.offer = offer;
     }
 
+    /**
+     * Plan is the purchase plan of the image. If omitted, it defaults to "WithPurchasePlan".
+     */
     @JsonProperty("plan")
     public String getPlan() {
         return plan;
     }
 
+    /**
+     * Plan is the purchase plan of the image. If omitted, it defaults to "WithPurchasePlan".
+     */
     @JsonProperty("plan")
     public void setPlan(String plan) {
         this.plan = plan;
     }
 
+    /**
+     * Publisher is the publisher of the image.
+     */
     @JsonProperty("publisher")
     public String getPublisher() {
         return publisher;
     }
 
+    /**
+     * Publisher is the publisher of the image.
+     */
     @JsonProperty("publisher")
     public void setPublisher(String publisher) {
         this.publisher = publisher;
     }
 
+    /**
+     * SKU is the SKU of the image.
+     */
     @JsonProperty("sku")
     public String getSku() {
         return sku;
     }
 
+    /**
+     * SKU is the SKU of the image.
+     */
     @JsonProperty("sku")
     public void setSku(String sku) {
         this.sku = sku;
     }
 
+    /**
+     * Version is the version of the image.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * Version is the version of the image.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/Platform.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/Platform.java
index e64cc4a56f0..4e8506071d7 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/Platform.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/Platform.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Platform stores all the global configuration that all machinesets use.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -131,142 +134,226 @@ public Platform(String armEndpoint, String baseDomainResourceGroupName, String c
         this.virtualNetwork = virtualNetwork;
     }
 
+    /**
+     * ARMEndpoint is the endpoint for the Azure API when installing on Azure Stack.
+     */
     @JsonProperty("armEndpoint")
     public String getArmEndpoint() {
         return armEndpoint;
     }
 
+    /**
+     * ARMEndpoint is the endpoint for the Azure API when installing on Azure Stack.
+     */
     @JsonProperty("armEndpoint")
     public void setArmEndpoint(String armEndpoint) {
         this.armEndpoint = armEndpoint;
     }
 
+    /**
+     * BaseDomainResourceGroupName specifies the resource group where the Azure DNS zone for the base domain is found. This field is optional when creating a private cluster, otherwise required.
+     */
     @JsonProperty("baseDomainResourceGroupName")
     public String getBaseDomainResourceGroupName() {
         return baseDomainResourceGroupName;
     }
 
+    /**
+     * BaseDomainResourceGroupName specifies the resource group where the Azure DNS zone for the base domain is found. This field is optional when creating a private cluster, otherwise required.
+     */
     @JsonProperty("baseDomainResourceGroupName")
     public void setBaseDomainResourceGroupName(String baseDomainResourceGroupName) {
         this.baseDomainResourceGroupName = baseDomainResourceGroupName;
     }
 
+    /**
+     * cloudName is the name of the Azure cloud environment which can be used to configure the Azure SDK with the appropriate Azure API endpoints. If empty, the value is equal to "AzurePublicCloud".
+     */
     @JsonProperty("cloudName")
     public String getCloudName() {
         return cloudName;
     }
 
+    /**
+     * cloudName is the name of the Azure cloud environment which can be used to configure the Azure SDK with the appropriate Azure API endpoints. If empty, the value is equal to "AzurePublicCloud".
+     */
     @JsonProperty("cloudName")
     public void setCloudName(String cloudName) {
         this.cloudName = cloudName;
     }
 
+    /**
+     * ClusterOSImage is the url of a storage blob in the Azure Stack environment containing an RHCOS VHD. This field is required for Azure Stack and not applicable to Azure.
+     */
     @JsonProperty("clusterOSImage")
     public String getClusterOSImage() {
         return clusterOSImage;
     }
 
+    /**
+     * ClusterOSImage is the url of a storage blob in the Azure Stack environment containing an RHCOS VHD. This field is required for Azure Stack and not applicable to Azure.
+     */
     @JsonProperty("clusterOSImage")
     public void setClusterOSImage(String clusterOSImage) {
         this.clusterOSImage = clusterOSImage;
     }
 
+    /**
+     * ComputeSubnet specifies an existing subnet for use by compute nodes
+     */
     @JsonProperty("computeSubnet")
     public String getComputeSubnet() {
         return computeSubnet;
     }
 
+    /**
+     * ComputeSubnet specifies an existing subnet for use by compute nodes
+     */
     @JsonProperty("computeSubnet")
     public void setComputeSubnet(String computeSubnet) {
         this.computeSubnet = computeSubnet;
     }
 
+    /**
+     * ControlPlaneSubnet specifies an existing subnet for use by the control plane nodes
+     */
     @JsonProperty("controlPlaneSubnet")
     public String getControlPlaneSubnet() {
         return controlPlaneSubnet;
     }
 
+    /**
+     * ControlPlaneSubnet specifies an existing subnet for use by the control plane nodes
+     */
     @JsonProperty("controlPlaneSubnet")
     public void setControlPlaneSubnet(String controlPlaneSubnet) {
         this.controlPlaneSubnet = controlPlaneSubnet;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("customerManagedKey")
     public CustomerManagedKey getCustomerManagedKey() {
         return customerManagedKey;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("customerManagedKey")
     public void setCustomerManagedKey(CustomerManagedKey customerManagedKey) {
         this.customerManagedKey = customerManagedKey;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("defaultMachinePlatform")
     public MachinePool getDefaultMachinePlatform() {
         return defaultMachinePlatform;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("defaultMachinePlatform")
     public void setDefaultMachinePlatform(MachinePool defaultMachinePlatform) {
         this.defaultMachinePlatform = defaultMachinePlatform;
     }
 
+    /**
+     * NetworkResourceGroupName specifies the network resource group that contains an existing VNet
+     */
     @JsonProperty("networkResourceGroupName")
     public String getNetworkResourceGroupName() {
         return networkResourceGroupName;
     }
 
+    /**
+     * NetworkResourceGroupName specifies the network resource group that contains an existing VNet
+     */
     @JsonProperty("networkResourceGroupName")
     public void setNetworkResourceGroupName(String networkResourceGroupName) {
         this.networkResourceGroupName = networkResourceGroupName;
     }
 
+    /**
+     * OutboundType is a strategy for how egress from cluster is achieved. When not specified default is "Loadbalancer". "NatGateway" is only available in TechPreview.
+     */
     @JsonProperty("outboundType")
     public String getOutboundType() {
         return outboundType;
     }
 
+    /**
+     * OutboundType is a strategy for how egress from cluster is achieved. When not specified default is "Loadbalancer". "NatGateway" is only available in TechPreview.
+     */
     @JsonProperty("outboundType")
     public void setOutboundType(String outboundType) {
         this.outboundType = outboundType;
     }
 
+    /**
+     * Region specifies the Azure region where the cluster will be created.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Region specifies the Azure region where the cluster will be created.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * ResourceGroupName is the name of an already existing resource group where the cluster should be installed. This resource group should only be used for this specific cluster and the cluster components will assume ownership of all resources in the resource group. Destroying the cluster using installer will delete this resource group. This resource group must be empty with no other resources when trying to use it for creating a cluster. If empty, a new resource group will created for the cluster.
+     */
     @JsonProperty("resourceGroupName")
     public String getResourceGroupName() {
         return resourceGroupName;
     }
 
+    /**
+     * ResourceGroupName is the name of an already existing resource group where the cluster should be installed. This resource group should only be used for this specific cluster and the cluster components will assume ownership of all resources in the resource group. Destroying the cluster using installer will delete this resource group. This resource group must be empty with no other resources when trying to use it for creating a cluster. If empty, a new resource group will created for the cluster.
+     */
     @JsonProperty("resourceGroupName")
     public void setResourceGroupName(String resourceGroupName) {
         this.resourceGroupName = resourceGroupName;
     }
 
+    /**
+     * UserTags has additional keys and values that the installer will add as tags to all resources that it creates on AzurePublicCloud alone. Resources created by the cluster itself may not include these tags.
+     */
     @JsonProperty("userTags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getUserTags() {
         return userTags;
     }
 
+    /**
+     * UserTags has additional keys and values that the installer will add as tags to all resources that it creates on AzurePublicCloud alone. Resources created by the cluster itself may not include these tags.
+     */
     @JsonProperty("userTags")
     public void setUserTags(Map<String, String> userTags) {
         this.userTags = userTags;
     }
 
+    /**
+     * VirtualNetwork specifies the name of an existing VNet for the installer to use
+     */
     @JsonProperty("virtualNetwork")
     public String getVirtualNetwork() {
         return virtualNetwork;
     }
 
+    /**
+     * VirtualNetwork specifies the name of an existing VNet for the installer to use
+     */
     @JsonProperty("virtualNetwork")
     public void setVirtualNetwork(String virtualNetwork) {
         this.virtualNetwork = virtualNetwork;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/SecuritySettings.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/SecuritySettings.java
index 4e3fcefabcb..6b9107b89bb 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/SecuritySettings.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/SecuritySettings.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SecuritySettings define the security type and the UEFI settings of the virtual machine.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public SecuritySettings(ConfidentialVM confidentialVM, String securityType, Trus
         this.trustedLaunch = trustedLaunch;
     }
 
+    /**
+     * SecuritySettings define the security type and the UEFI settings of the virtual machine.
+     */
     @JsonProperty("confidentialVM")
     public ConfidentialVM getConfidentialVM() {
         return confidentialVM;
     }
 
+    /**
+     * SecuritySettings define the security type and the UEFI settings of the virtual machine.
+     */
     @JsonProperty("confidentialVM")
     public void setConfidentialVM(ConfidentialVM confidentialVM) {
         this.confidentialVM = confidentialVM;
     }
 
+    /**
+     * SecurityType specifies the SecurityType of the virtual machine. It has to be set to any specified value to enable secure boot and vTPM. The default behavior is: secure boot and vTPM will not be enabled unless this property is set.
+     */
     @JsonProperty("securityType")
     public String getSecurityType() {
         return securityType;
     }
 
+    /**
+     * SecurityType specifies the SecurityType of the virtual machine. It has to be set to any specified value to enable secure boot and vTPM. The default behavior is: secure boot and vTPM will not be enabled unless this property is set.
+     */
     @JsonProperty("securityType")
     public void setSecurityType(String securityType) {
         this.securityType = securityType;
     }
 
+    /**
+     * SecuritySettings define the security type and the UEFI settings of the virtual machine.
+     */
     @JsonProperty("trustedLaunch")
     public TrustedLaunch getTrustedLaunch() {
         return trustedLaunch;
     }
 
+    /**
+     * SecuritySettings define the security type and the UEFI settings of the virtual machine.
+     */
     @JsonProperty("trustedLaunch")
     public void setTrustedLaunch(TrustedLaunch trustedLaunch) {
         this.trustedLaunch = trustedLaunch;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/TrustedLaunch.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/TrustedLaunch.java
index 3384fd96156..bdac1ac7462 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/TrustedLaunch.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/TrustedLaunch.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TrustedLaunch defines the UEFI settings for the virtual machine.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public TrustedLaunch(UEFISettings uefiSettings) {
         this.uefiSettings = uefiSettings;
     }
 
+    /**
+     * TrustedLaunch defines the UEFI settings for the virtual machine.
+     */
     @JsonProperty("uefiSettings")
     public UEFISettings getUefiSettings() {
         return uefiSettings;
     }
 
+    /**
+     * TrustedLaunch defines the UEFI settings for the virtual machine.
+     */
     @JsonProperty("uefiSettings")
     public void setUefiSettings(UEFISettings uefiSettings) {
         this.uefiSettings = uefiSettings;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/UEFISettings.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/UEFISettings.java
index 6254e791817..606e56126d9 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/UEFISettings.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/UEFISettings.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UEFISettings specifies the security settings like secure boot and vTPM used while creating the virtual machine.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public UEFISettings(String secureBoot, String virtualizedTrustedPlatformModule)
         this.virtualizedTrustedPlatformModule = virtualizedTrustedPlatformModule;
     }
 
+    /**
+     * SecureBoot specifies whether secure boot should be enabled on the virtual machine. Secure Boot verifies the digital signature of all boot components and halts the boot process if signature verification fails. If omitted, the platform chooses a default, which is subject to change over time, currently that default is disabled.
+     */
     @JsonProperty("secureBoot")
     public String getSecureBoot() {
         return secureBoot;
     }
 
+    /**
+     * SecureBoot specifies whether secure boot should be enabled on the virtual machine. Secure Boot verifies the digital signature of all boot components and halts the boot process if signature verification fails. If omitted, the platform chooses a default, which is subject to change over time, currently that default is disabled.
+     */
     @JsonProperty("secureBoot")
     public void setSecureBoot(String secureBoot) {
         this.secureBoot = secureBoot;
     }
 
+    /**
+     * VirtualizedTrustedPlatformModule specifies whether vTPM should be enabled on the virtual machine. When enabled the virtualized trusted platform module measurements are used to create a known good boot integrity policy baseline. The integrity policy baseline is used for comparison with measurements from subsequent VM boots to determine if anything has changed. This is required to be set to enabled if the SecurityEncryptionType is defined. If omitted, the platform chooses a default, which is subject to change over time, currently that default is disabled.
+     */
     @JsonProperty("virtualizedTrustedPlatformModule")
     public String getVirtualizedTrustedPlatformModule() {
         return virtualizedTrustedPlatformModule;
     }
 
+    /**
+     * VirtualizedTrustedPlatformModule specifies whether vTPM should be enabled on the virtual machine. When enabled the virtualized trusted platform module measurements are used to create a known good boot integrity policy baseline. The integrity policy baseline is used for comparison with measurements from subsequent VM boots to determine if anything has changed. This is required to be set to enabled if the SecurityEncryptionType is defined. If omitted, the platform chooses a default, which is subject to change over time, currently that default is disabled.
+     */
     @JsonProperty("virtualizedTrustedPlatformModule")
     public void setVirtualizedTrustedPlatformModule(String virtualizedTrustedPlatformModule) {
         this.virtualizedTrustedPlatformModule = virtualizedTrustedPlatformModule;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/VMDiskSecurityProfile.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/VMDiskSecurityProfile.java
index 4e637ce68ab..c557f206a49 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/VMDiskSecurityProfile.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/azure/v1/VMDiskSecurityProfile.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VMDiskSecurityProfile specifies the security profile settings for the managed disk. It can be set only for Confidential VMs.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public VMDiskSecurityProfile(DiskEncryptionSet diskEncryptionSet, String securit
         this.securityEncryptionType = securityEncryptionType;
     }
 
+    /**
+     * VMDiskSecurityProfile specifies the security profile settings for the managed disk. It can be set only for Confidential VMs.
+     */
     @JsonProperty("diskEncryptionSet")
     public DiskEncryptionSet getDiskEncryptionSet() {
         return diskEncryptionSet;
     }
 
+    /**
+     * VMDiskSecurityProfile specifies the security profile settings for the managed disk. It can be set only for Confidential VMs.
+     */
     @JsonProperty("diskEncryptionSet")
     public void setDiskEncryptionSet(DiskEncryptionSet diskEncryptionSet) {
         this.diskEncryptionSet = diskEncryptionSet;
     }
 
+    /**
+     * SecurityEncryptionType specifies the encryption type of the managed disk. It is set to DiskWithVMGuestState to encrypt the managed disk along with the VMGuestState blob, and to VMGuestStateOnly to encrypt the VMGuestState blob only. When set to VMGuestStateOnly, the VTpmEnabled should be set to true. When set to DiskWithVMGuestState, both SecureBootEnabled and VTpmEnabled should be set to true. It can be set only for Confidential VMs.
+     */
     @JsonProperty("securityEncryptionType")
     public String getSecurityEncryptionType() {
         return securityEncryptionType;
     }
 
+    /**
+     * SecurityEncryptionType specifies the encryption type of the managed disk. It is set to DiskWithVMGuestState to encrypt the managed disk along with the VMGuestState blob, and to VMGuestStateOnly to encrypt the VMGuestState blob only. When set to VMGuestStateOnly, the VTpmEnabled should be set to true. When set to DiskWithVMGuestState, both SecureBootEnabled and VTpmEnabled should be set to true. It can be set only for Confidential VMs.
+     */
     @JsonProperty("securityEncryptionType")
     public void setSecurityEncryptionType(String securityEncryptionType) {
         this.securityEncryptionType = securityEncryptionType;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/baremetal/v1/BMC.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/baremetal/v1/BMC.java
index 54ae341bc0d..f2685a6510d 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/baremetal/v1/BMC.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/baremetal/v1/BMC.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BMC stores the information about a baremetal host's management controller.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public BMC(String address, Boolean disableCertificateVerification, String passwo
         this.username = username;
     }
 
+    /**
+     * BMC stores the information about a baremetal host's management controller.
+     */
     @JsonProperty("address")
     public String getAddress() {
         return address;
     }
 
+    /**
+     * BMC stores the information about a baremetal host's management controller.
+     */
     @JsonProperty("address")
     public void setAddress(String address) {
         this.address = address;
     }
 
+    /**
+     * BMC stores the information about a baremetal host's management controller.
+     */
     @JsonProperty("disableCertificateVerification")
     public Boolean getDisableCertificateVerification() {
         return disableCertificateVerification;
     }
 
+    /**
+     * BMC stores the information about a baremetal host's management controller.
+     */
     @JsonProperty("disableCertificateVerification")
     public void setDisableCertificateVerification(Boolean disableCertificateVerification) {
         this.disableCertificateVerification = disableCertificateVerification;
     }
 
+    /**
+     * BMC stores the information about a baremetal host's management controller.
+     */
     @JsonProperty("password")
     public String getPassword() {
         return password;
     }
 
+    /**
+     * BMC stores the information about a baremetal host's management controller.
+     */
     @JsonProperty("password")
     public void setPassword(String password) {
         this.password = password;
     }
 
+    /**
+     * BMC stores the information about a baremetal host's management controller.
+     */
     @JsonProperty("username")
     public String getUsername() {
         return username;
     }
 
+    /**
+     * BMC stores the information about a baremetal host's management controller.
+     */
     @JsonProperty("username")
     public void setUsername(String username) {
         this.username = username;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/baremetal/v1/Host.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/baremetal/v1/Host.java
index 9aaca1039c4..316c9109dfe 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/baremetal/v1/Host.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/baremetal/v1/Host.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Host stores all the configuration data for a baremetal host.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -107,81 +110,129 @@ public Host(BMC bmc, String bootMACAddress, String bootMode, String hardwareProf
         this.rootDeviceHints = rootDeviceHints;
     }
 
+    /**
+     * Host stores all the configuration data for a baremetal host.
+     */
     @JsonProperty("bmc")
     public BMC getBmc() {
         return bmc;
     }
 
+    /**
+     * Host stores all the configuration data for a baremetal host.
+     */
     @JsonProperty("bmc")
     public void setBmc(BMC bmc) {
         this.bmc = bmc;
     }
 
+    /**
+     * Host stores all the configuration data for a baremetal host.
+     */
     @JsonProperty("bootMACAddress")
     public String getBootMACAddress() {
         return bootMACAddress;
     }
 
+    /**
+     * Host stores all the configuration data for a baremetal host.
+     */
     @JsonProperty("bootMACAddress")
     public void setBootMACAddress(String bootMACAddress) {
         this.bootMACAddress = bootMACAddress;
     }
 
+    /**
+     * Host stores all the configuration data for a baremetal host.
+     */
     @JsonProperty("bootMode")
     public String getBootMode() {
         return bootMode;
     }
 
+    /**
+     * Host stores all the configuration data for a baremetal host.
+     */
     @JsonProperty("bootMode")
     public void setBootMode(String bootMode) {
         this.bootMode = bootMode;
     }
 
+    /**
+     * Host stores all the configuration data for a baremetal host.
+     */
     @JsonProperty("hardwareProfile")
     public String getHardwareProfile() {
         return hardwareProfile;
     }
 
+    /**
+     * Host stores all the configuration data for a baremetal host.
+     */
     @JsonProperty("hardwareProfile")
     public void setHardwareProfile(String hardwareProfile) {
         this.hardwareProfile = hardwareProfile;
     }
 
+    /**
+     * Host stores all the configuration data for a baremetal host.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Host stores all the configuration data for a baremetal host.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Host stores all the configuration data for a baremetal host.
+     */
     @JsonProperty("networkConfig")
     public JsonNode getNetworkConfig() {
         return networkConfig;
     }
 
+    /**
+     * Host stores all the configuration data for a baremetal host.
+     */
     @JsonProperty("networkConfig")
     public void setNetworkConfig(JsonNode networkConfig) {
         this.networkConfig = networkConfig;
     }
 
+    /**
+     * Host stores all the configuration data for a baremetal host.
+     */
     @JsonProperty("role")
     public String getRole() {
         return role;
     }
 
+    /**
+     * Host stores all the configuration data for a baremetal host.
+     */
     @JsonProperty("role")
     public void setRole(String role) {
         this.role = role;
     }
 
+    /**
+     * Host stores all the configuration data for a baremetal host.
+     */
     @JsonProperty("rootDeviceHints")
     public RootDeviceHints getRootDeviceHints() {
         return rootDeviceHints;
     }
 
+    /**
+     * Host stores all the configuration data for a baremetal host.
+     */
     @JsonProperty("rootDeviceHints")
     public void setRootDeviceHints(RootDeviceHints rootDeviceHints) {
         this.rootDeviceHints = rootDeviceHints;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/baremetal/v1/MachinePool.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/baremetal/v1/MachinePool.java
index d701a901929..10ebeb81902 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/baremetal/v1/MachinePool.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/baremetal/v1/MachinePool.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePool stores the configuration for a machine pool installed on bare metal.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/baremetal/v1/Metadata.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/baremetal/v1/Metadata.java
index ced65c58e7a..e177be0fe78 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/baremetal/v1/Metadata.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/baremetal/v1/Metadata.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metadata contains baremetal metadata (e.g. for uninstalling the cluster).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public Metadata(String bootstrapProvisioningIP, String libvirtURI, String provis
         this.provisioningHostIP = provisioningHostIP;
     }
 
+    /**
+     * Metadata contains baremetal metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("bootstrapProvisioningIP")
     public String getBootstrapProvisioningIP() {
         return bootstrapProvisioningIP;
     }
 
+    /**
+     * Metadata contains baremetal metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("bootstrapProvisioningIP")
     public void setBootstrapProvisioningIP(String bootstrapProvisioningIP) {
         this.bootstrapProvisioningIP = bootstrapProvisioningIP;
     }
 
+    /**
+     * Metadata contains baremetal metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("libvirtURI")
     public String getLibvirtURI() {
         return libvirtURI;
     }
 
+    /**
+     * Metadata contains baremetal metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("libvirtURI")
     public void setLibvirtURI(String libvirtURI) {
         this.libvirtURI = libvirtURI;
     }
 
+    /**
+     * Metadata contains baremetal metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("provisioningHostIP")
     public String getProvisioningHostIP() {
         return provisioningHostIP;
     }
 
+    /**
+     * Metadata contains baremetal metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("provisioningHostIP")
     public void setProvisioningHostIP(String provisioningHostIP) {
         this.provisioningHostIP = provisioningHostIP;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/baremetal/v1/Platform.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/baremetal/v1/Platform.java
index 2508fbf2667..2af9bba4813 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/baremetal/v1/Platform.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/baremetal/v1/Platform.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Platform stores all the global configuration that all machinesets use.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -180,254 +183,404 @@ public Platform(String apiVIP, List<String> apiVIPs, String bootstrapExternalSta
         this.provisioningNetworkInterface = provisioningNetworkInterface;
     }
 
+    /**
+     * DeprecatedAPIVIP is the VIP to use for internal API communication Deprecated: Use APIVIPs
+     */
     @JsonProperty("apiVIP")
     public String getApiVIP() {
         return apiVIP;
     }
 
+    /**
+     * DeprecatedAPIVIP is the VIP to use for internal API communication Deprecated: Use APIVIPs
+     */
     @JsonProperty("apiVIP")
     public void setApiVIP(String apiVIP) {
         this.apiVIP = apiVIP;
     }
 
+    /**
+     * APIVIPs contains the VIP(s) to use for internal API communication. In dual stack clusters it contains an IPv4 and IPv6 address, otherwise only one VIP
+     */
     @JsonProperty("apiVIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiVIPs() {
         return apiVIPs;
     }
 
+    /**
+     * APIVIPs contains the VIP(s) to use for internal API communication. In dual stack clusters it contains an IPv4 and IPv6 address, otherwise only one VIP
+     */
     @JsonProperty("apiVIPs")
     public void setApiVIPs(List<String> apiVIPs) {
         this.apiVIPs = apiVIPs;
     }
 
+    /**
+     * BootstrapExternalStaticDNS is the static network DNS of the bootstrap node. This can be useful in environments without a DHCP server.
+     */
     @JsonProperty("bootstrapExternalStaticDNS")
     public String getBootstrapExternalStaticDNS() {
         return bootstrapExternalStaticDNS;
     }
 
+    /**
+     * BootstrapExternalStaticDNS is the static network DNS of the bootstrap node. This can be useful in environments without a DHCP server.
+     */
     @JsonProperty("bootstrapExternalStaticDNS")
     public void setBootstrapExternalStaticDNS(String bootstrapExternalStaticDNS) {
         this.bootstrapExternalStaticDNS = bootstrapExternalStaticDNS;
     }
 
+    /**
+     * BootstrapExternalStaticGateway is the static network gateway of the bootstrap node. This can be useful in environments without a DHCP server.
+     */
     @JsonProperty("bootstrapExternalStaticGateway")
     public String getBootstrapExternalStaticGateway() {
         return bootstrapExternalStaticGateway;
     }
 
+    /**
+     * BootstrapExternalStaticGateway is the static network gateway of the bootstrap node. This can be useful in environments without a DHCP server.
+     */
     @JsonProperty("bootstrapExternalStaticGateway")
     public void setBootstrapExternalStaticGateway(String bootstrapExternalStaticGateway) {
         this.bootstrapExternalStaticGateway = bootstrapExternalStaticGateway;
     }
 
+    /**
+     * BootstrapExternalStaticIP is the static IP address of the bootstrap node. This can be useful in environments without a DHCP server.
+     */
     @JsonProperty("bootstrapExternalStaticIP")
     public String getBootstrapExternalStaticIP() {
         return bootstrapExternalStaticIP;
     }
 
+    /**
+     * BootstrapExternalStaticIP is the static IP address of the bootstrap node. This can be useful in environments without a DHCP server.
+     */
     @JsonProperty("bootstrapExternalStaticIP")
     public void setBootstrapExternalStaticIP(String bootstrapExternalStaticIP) {
         this.bootstrapExternalStaticIP = bootstrapExternalStaticIP;
     }
 
+    /**
+     * BootstrapOSImage is a URL to override the default OS image for the bootstrap node. The URL must contain a sha256 hash of the image e.g https://mirror.example.com/images/qemu.qcow2.gz?sha256=a07bd...
+     */
     @JsonProperty("bootstrapOSImage")
     public String getBootstrapOSImage() {
         return bootstrapOSImage;
     }
 
+    /**
+     * BootstrapOSImage is a URL to override the default OS image for the bootstrap node. The URL must contain a sha256 hash of the image e.g https://mirror.example.com/images/qemu.qcow2.gz?sha256=a07bd...
+     */
     @JsonProperty("bootstrapOSImage")
     public void setBootstrapOSImage(String bootstrapOSImage) {
         this.bootstrapOSImage = bootstrapOSImage;
     }
 
+    /**
+     * BootstrapProvisioningIP is the IP used on the bootstrap VM to bring up provisioning services that are used to create the control-plane machines
+     */
     @JsonProperty("bootstrapProvisioningIP")
     public String getBootstrapProvisioningIP() {
         return bootstrapProvisioningIP;
     }
 
+    /**
+     * BootstrapProvisioningIP is the IP used on the bootstrap VM to bring up provisioning services that are used to create the control-plane machines
+     */
     @JsonProperty("bootstrapProvisioningIP")
     public void setBootstrapProvisioningIP(String bootstrapProvisioningIP) {
         this.bootstrapProvisioningIP = bootstrapProvisioningIP;
     }
 
+    /**
+     * ClusterOSImage is a URL to override the default OS image for cluster nodes. The URL must contain a sha256 hash of the image e.g https://mirror.example.com/images/metal.qcow2.gz?sha256=3b5a8...
+     */
     @JsonProperty("clusterOSImage")
     public String getClusterOSImage() {
         return clusterOSImage;
     }
 
+    /**
+     * ClusterOSImage is a URL to override the default OS image for cluster nodes. The URL must contain a sha256 hash of the image e.g https://mirror.example.com/images/metal.qcow2.gz?sha256=3b5a8...
+     */
     @JsonProperty("clusterOSImage")
     public void setClusterOSImage(String clusterOSImage) {
         this.clusterOSImage = clusterOSImage;
     }
 
+    /**
+     * ClusterProvisioningIP is the IP on the dedicated provisioning network where the baremetal-operator pod runs provisioning services, and an http server to cache some downloaded content e.g RHCOS/IPA images
+     */
     @JsonProperty("clusterProvisioningIP")
     public String getClusterProvisioningIP() {
         return clusterProvisioningIP;
     }
 
+    /**
+     * ClusterProvisioningIP is the IP on the dedicated provisioning network where the baremetal-operator pod runs provisioning services, and an http server to cache some downloaded content e.g RHCOS/IPA images
+     */
     @JsonProperty("clusterProvisioningIP")
     public void setClusterProvisioningIP(String clusterProvisioningIP) {
         this.clusterProvisioningIP = clusterProvisioningIP;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("defaultMachinePlatform")
     public MachinePool getDefaultMachinePlatform() {
         return defaultMachinePlatform;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("defaultMachinePlatform")
     public void setDefaultMachinePlatform(MachinePool defaultMachinePlatform) {
         this.defaultMachinePlatform = defaultMachinePlatform;
     }
 
+    /**
+     * External bridge is used for external communication.
+     */
     @JsonProperty("externalBridge")
     public String getExternalBridge() {
         return externalBridge;
     }
 
+    /**
+     * External bridge is used for external communication.
+     */
     @JsonProperty("externalBridge")
     public void setExternalBridge(String externalBridge) {
         this.externalBridge = externalBridge;
     }
 
+    /**
+     * ExternalMACAddress is used to allow setting a static unicast MAC address for the bootstrap host on the external network. Consider using the QEMU vendor prefix `52:54:00`. If left blank, libvirt will generate one for you.
+     */
     @JsonProperty("externalMACAddress")
     public String getExternalMACAddress() {
         return externalMACAddress;
     }
 
+    /**
+     * ExternalMACAddress is used to allow setting a static unicast MAC address for the bootstrap host on the external network. Consider using the QEMU vendor prefix `52:54:00`. If left blank, libvirt will generate one for you.
+     */
     @JsonProperty("externalMACAddress")
     public void setExternalMACAddress(String externalMACAddress) {
         this.externalMACAddress = externalMACAddress;
     }
 
+    /**
+     * Hosts is the information needed to create the objects in Ironic.
+     */
     @JsonProperty("hosts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Host> getHosts() {
         return hosts;
     }
 
+    /**
+     * Hosts is the information needed to create the objects in Ironic.
+     */
     @JsonProperty("hosts")
     public void setHosts(List<Host> hosts) {
         this.hosts = hosts;
     }
 
+    /**
+     * DeprecatedIngressVIP is the VIP to use for ingress traffic Deprecated: Use IngressVIPs
+     */
     @JsonProperty("ingressVIP")
     public String getIngressVIP() {
         return ingressVIP;
     }
 
+    /**
+     * DeprecatedIngressVIP is the VIP to use for ingress traffic Deprecated: Use IngressVIPs
+     */
     @JsonProperty("ingressVIP")
     public void setIngressVIP(String ingressVIP) {
         this.ingressVIP = ingressVIP;
     }
 
+    /**
+     * IngressVIPs contains the VIP(s) to use for ingress traffic. In dual stack clusters it contains an IPv4 and IPv6 address, otherwise only one VIP
+     */
     @JsonProperty("ingressVIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIngressVIPs() {
         return ingressVIPs;
     }
 
+    /**
+     * IngressVIPs contains the VIP(s) to use for ingress traffic. In dual stack clusters it contains an IPv4 and IPv6 address, otherwise only one VIP
+     */
     @JsonProperty("ingressVIPs")
     public void setIngressVIPs(List<String> ingressVIPs) {
         this.ingressVIPs = ingressVIPs;
     }
 
+    /**
+     * LibvirtURI is the identifier for the libvirtd connection.  It must be reachable from the host where the installer is run. Default is qemu:///system
+     */
     @JsonProperty("libvirtURI")
     public String getLibvirtURI() {
         return libvirtURI;
     }
 
+    /**
+     * LibvirtURI is the identifier for the libvirtd connection.  It must be reachable from the host where the installer is run. Default is qemu:///system
+     */
     @JsonProperty("libvirtURI")
     public void setLibvirtURI(String libvirtURI) {
         this.libvirtURI = libvirtURI;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("loadBalancer")
     public BareMetalPlatformLoadBalancer getLoadBalancer() {
         return loadBalancer;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("loadBalancer")
     public void setLoadBalancer(BareMetalPlatformLoadBalancer loadBalancer) {
         this.loadBalancer = loadBalancer;
     }
 
+    /**
+     * Provisioning bridge is used for provisioning nodes, on the host that will run the bootstrap VM.
+     */
     @JsonProperty("provisioningBridge")
     public String getProvisioningBridge() {
         return provisioningBridge;
     }
 
+    /**
+     * Provisioning bridge is used for provisioning nodes, on the host that will run the bootstrap VM.
+     */
     @JsonProperty("provisioningBridge")
     public void setProvisioningBridge(String provisioningBridge) {
         this.provisioningBridge = provisioningBridge;
     }
 
+    /**
+     * DeprecatedProvisioningDHCPExternal indicates that DHCP is provided by an external service. This parameter is replaced by ProvisioningNetwork being set to "Unmanaged".
+     */
     @JsonProperty("provisioningDHCPExternal")
     public Boolean getProvisioningDHCPExternal() {
         return provisioningDHCPExternal;
     }
 
+    /**
+     * DeprecatedProvisioningDHCPExternal indicates that DHCP is provided by an external service. This parameter is replaced by ProvisioningNetwork being set to "Unmanaged".
+     */
     @JsonProperty("provisioningDHCPExternal")
     public void setProvisioningDHCPExternal(Boolean provisioningDHCPExternal) {
         this.provisioningDHCPExternal = provisioningDHCPExternal;
     }
 
+    /**
+     * ProvisioningDHCPRange is used to provide DHCP services to hosts for provisioning.
+     */
     @JsonProperty("provisioningDHCPRange")
     public String getProvisioningDHCPRange() {
         return provisioningDHCPRange;
     }
 
+    /**
+     * ProvisioningDHCPRange is used to provide DHCP services to hosts for provisioning.
+     */
     @JsonProperty("provisioningDHCPRange")
     public void setProvisioningDHCPRange(String provisioningDHCPRange) {
         this.provisioningDHCPRange = provisioningDHCPRange;
     }
 
+    /**
+     * DeprecatedProvisioningHostIP is the deprecated version of clusterProvisioningIP. When the baremetal platform was initially added to the installer, the JSON field for ClusterProvisioningIP was incorrectly set to "provisioningHostIP."  This field is here to allow backwards-compatibility.
+     */
     @JsonProperty("provisioningHostIP")
     public String getProvisioningHostIP() {
         return provisioningHostIP;
     }
 
+    /**
+     * DeprecatedProvisioningHostIP is the deprecated version of clusterProvisioningIP. When the baremetal platform was initially added to the installer, the JSON field for ClusterProvisioningIP was incorrectly set to "provisioningHostIP."  This field is here to allow backwards-compatibility.
+     */
     @JsonProperty("provisioningHostIP")
     public void setProvisioningHostIP(String provisioningHostIP) {
         this.provisioningHostIP = provisioningHostIP;
     }
 
+    /**
+     * ProvisioningMACAddress is used to allow setting a static unicast MAC address for the bootstrap host on the provisioning network. Consider using the QEMU vendor prefix `52:54:00`. If left blank, libvirt will generate one for you.
+     */
     @JsonProperty("provisioningMACAddress")
     public String getProvisioningMACAddress() {
         return provisioningMACAddress;
     }
 
+    /**
+     * ProvisioningMACAddress is used to allow setting a static unicast MAC address for the bootstrap host on the provisioning network. Consider using the QEMU vendor prefix `52:54:00`. If left blank, libvirt will generate one for you.
+     */
     @JsonProperty("provisioningMACAddress")
     public void setProvisioningMACAddress(String provisioningMACAddress) {
         this.provisioningMACAddress = provisioningMACAddress;
     }
 
+    /**
+     * ProvisioningNetwork is used to indicate if we will have a provisioning network, and how it will be managed.
+     */
     @JsonProperty("provisioningNetwork")
     public String getProvisioningNetwork() {
         return provisioningNetwork;
     }
 
+    /**
+     * ProvisioningNetwork is used to indicate if we will have a provisioning network, and how it will be managed.
+     */
     @JsonProperty("provisioningNetwork")
     public void setProvisioningNetwork(String provisioningNetwork) {
         this.provisioningNetwork = provisioningNetwork;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("provisioningNetworkCIDR")
     public String getProvisioningNetworkCIDR() {
         return provisioningNetworkCIDR;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("provisioningNetworkCIDR")
     public void setProvisioningNetworkCIDR(String provisioningNetworkCIDR) {
         this.provisioningNetworkCIDR = provisioningNetworkCIDR;
     }
 
+    /**
+     * ProvisioningNetworkInterface is the name of the network interface on a control plane baremetal host that is connected to the provisioning network.
+     */
     @JsonProperty("provisioningNetworkInterface")
     public String getProvisioningNetworkInterface() {
         return provisioningNetworkInterface;
     }
 
+    /**
+     * ProvisioningNetworkInterface is the name of the network interface on a control plane baremetal host that is connected to the provisioning network.
+     */
     @JsonProperty("provisioningNetworkInterface")
     public void setProvisioningNetworkInterface(String provisioningNetworkInterface) {
         this.provisioningNetworkInterface = provisioningNetworkInterface;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/baremetal/v1/RootDeviceHints.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/baremetal/v1/RootDeviceHints.java
index f78ce8615e3..a2f7cbc66f8 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/baremetal/v1/RootDeviceHints.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/baremetal/v1/RootDeviceHints.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RootDeviceHints holds the hints for specifying the storage location for the root filesystem for the image.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -114,101 +117,161 @@ public RootDeviceHints(String deviceName, String hctl, Integer minSizeGigabytes,
         this.wwnWithExtension = wwnWithExtension;
     }
 
+    /**
+     * A Linux device name like "/dev/vda". The hint must match the actual value exactly.
+     */
     @JsonProperty("deviceName")
     public String getDeviceName() {
         return deviceName;
     }
 
+    /**
+     * A Linux device name like "/dev/vda". The hint must match the actual value exactly.
+     */
     @JsonProperty("deviceName")
     public void setDeviceName(String deviceName) {
         this.deviceName = deviceName;
     }
 
+    /**
+     * A SCSI bus address like 0:0:0:0. The hint must match the actual value exactly.
+     */
     @JsonProperty("hctl")
     public String getHctl() {
         return hctl;
     }
 
+    /**
+     * A SCSI bus address like 0:0:0:0. The hint must match the actual value exactly.
+     */
     @JsonProperty("hctl")
     public void setHctl(String hctl) {
         this.hctl = hctl;
     }
 
+    /**
+     * The minimum size of the device in Gigabytes.
+     */
     @JsonProperty("minSizeGigabytes")
     public Integer getMinSizeGigabytes() {
         return minSizeGigabytes;
     }
 
+    /**
+     * The minimum size of the device in Gigabytes.
+     */
     @JsonProperty("minSizeGigabytes")
     public void setMinSizeGigabytes(Integer minSizeGigabytes) {
         this.minSizeGigabytes = minSizeGigabytes;
     }
 
+    /**
+     * A vendor-specific device identifier. The hint can be a substring of the actual value.
+     */
     @JsonProperty("model")
     public String getModel() {
         return model;
     }
 
+    /**
+     * A vendor-specific device identifier. The hint can be a substring of the actual value.
+     */
     @JsonProperty("model")
     public void setModel(String model) {
         this.model = model;
     }
 
+    /**
+     * True if the device should use spinning media, false otherwise.
+     */
     @JsonProperty("rotational")
     public Boolean getRotational() {
         return rotational;
     }
 
+    /**
+     * True if the device should use spinning media, false otherwise.
+     */
     @JsonProperty("rotational")
     public void setRotational(Boolean rotational) {
         this.rotational = rotational;
     }
 
+    /**
+     * Device serial number. The hint must match the actual value exactly.
+     */
     @JsonProperty("serialNumber")
     public String getSerialNumber() {
         return serialNumber;
     }
 
+    /**
+     * Device serial number. The hint must match the actual value exactly.
+     */
     @JsonProperty("serialNumber")
     public void setSerialNumber(String serialNumber) {
         this.serialNumber = serialNumber;
     }
 
+    /**
+     * The name of the vendor or manufacturer of the device. The hint can be a substring of the actual value.
+     */
     @JsonProperty("vendor")
     public String getVendor() {
         return vendor;
     }
 
+    /**
+     * The name of the vendor or manufacturer of the device. The hint can be a substring of the actual value.
+     */
     @JsonProperty("vendor")
     public void setVendor(String vendor) {
         this.vendor = vendor;
     }
 
+    /**
+     * Unique storage identifier. The hint must match the actual value exactly.
+     */
     @JsonProperty("wwn")
     public String getWwn() {
         return wwn;
     }
 
+    /**
+     * Unique storage identifier. The hint must match the actual value exactly.
+     */
     @JsonProperty("wwn")
     public void setWwn(String wwn) {
         this.wwn = wwn;
     }
 
+    /**
+     * Unique vendor storage identifier. The hint must match the actual value exactly.
+     */
     @JsonProperty("wwnVendorExtension")
     public String getWwnVendorExtension() {
         return wwnVendorExtension;
     }
 
+    /**
+     * Unique vendor storage identifier. The hint must match the actual value exactly.
+     */
     @JsonProperty("wwnVendorExtension")
     public void setWwnVendorExtension(String wwnVendorExtension) {
         this.wwnVendorExtension = wwnVendorExtension;
     }
 
+    /**
+     * Unique storage identifier with the vendor extension appended. The hint must match the actual value exactly.
+     */
     @JsonProperty("wwnWithExtension")
     public String getWwnWithExtension() {
         return wwnWithExtension;
     }
 
+    /**
+     * Unique storage identifier with the vendor extension appended. The hint must match the actual value exactly.
+     */
     @JsonProperty("wwnWithExtension")
     public void setWwnWithExtension(String wwnWithExtension) {
         this.wwnWithExtension = wwnWithExtension;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/external/v1/Platform.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/external/v1/Platform.java
index 4691940cc7d..f8b13c8fda4 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/external/v1/Platform.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/external/v1/Platform.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Platform stores configuration related to external cloud providers.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Platform(String cloudControllerManager, String platformName) {
         this.platformName = platformName;
     }
 
+    /**
+     * CloudControllerManager when set to external, this property will enable an external cloud provider.
+     */
     @JsonProperty("cloudControllerManager")
     public String getCloudControllerManager() {
         return cloudControllerManager;
     }
 
+    /**
+     * CloudControllerManager when set to external, this property will enable an external cloud provider.
+     */
     @JsonProperty("cloudControllerManager")
     public void setCloudControllerManager(String cloudControllerManager) {
         this.cloudControllerManager = cloudControllerManager;
     }
 
+    /**
+     * PlatformName holds the arbitrary string representing the infrastructure provider name, expected to be set at the installation time. This field is solely for informational and reporting purposes and is not expected to be used for decision-making.
+     */
     @JsonProperty("platformName")
     public String getPlatformName() {
         return platformName;
     }
 
+    /**
+     * PlatformName holds the arbitrary string representing the infrastructure provider name, expected to be set at the installation time. This field is solely for informational and reporting purposes and is not expected to be used for decision-making.
+     */
     @JsonProperty("platformName")
     public void setPlatformName(String platformName) {
         this.platformName = platformName;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/EncryptionKeyReference.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/EncryptionKeyReference.java
index ad563a19d58..2b0d15472cc 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/EncryptionKeyReference.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/EncryptionKeyReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EncryptionKeyReference describes the encryptionKey to use for a disk's encryption.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public EncryptionKeyReference(KMSKeyReference kmsKey, String kmsKeyServiceAccoun
         this.kmsKeyServiceAccount = kmsKeyServiceAccount;
     }
 
+    /**
+     * EncryptionKeyReference describes the encryptionKey to use for a disk's encryption.
+     */
     @JsonProperty("kmsKey")
     public KMSKeyReference getKmsKey() {
         return kmsKey;
     }
 
+    /**
+     * EncryptionKeyReference describes the encryptionKey to use for a disk's encryption.
+     */
     @JsonProperty("kmsKey")
     public void setKmsKey(KMSKeyReference kmsKey) {
         this.kmsKey = kmsKey;
     }
 
+    /**
+     * KMSKeyServiceAccount is the service account being used for the encryption request for the given KMS key. If absent, the Compute Engine default service account is used. See https://cloud.google.com/compute/docs/access/service-accounts#compute_engine_service_account for details on the default service account.
+     */
     @JsonProperty("kmsKeyServiceAccount")
     public String getKmsKeyServiceAccount() {
         return kmsKeyServiceAccount;
     }
 
+    /**
+     * KMSKeyServiceAccount is the service account being used for the encryption request for the given KMS key. If absent, the Compute Engine default service account is used. See https://cloud.google.com/compute/docs/access/service-accounts#compute_engine_service_account for details on the default service account.
+     */
     @JsonProperty("kmsKeyServiceAccount")
     public void setKmsKeyServiceAccount(String kmsKeyServiceAccount) {
         this.kmsKeyServiceAccount = kmsKeyServiceAccount;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/KMSKeyReference.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/KMSKeyReference.java
index b68c1169939..e32c2f5574d 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/KMSKeyReference.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/KMSKeyReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KMSKeyReference gathers required fields for looking up a GCP KMS Key
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public KMSKeyReference(String keyRing, String location, String name, String proj
         this.projectID = projectID;
     }
 
+    /**
+     * KeyRing is the name of the KMS Key Ring which the KMS Key belongs to.
+     */
     @JsonProperty("keyRing")
     public String getKeyRing() {
         return keyRing;
     }
 
+    /**
+     * KeyRing is the name of the KMS Key Ring which the KMS Key belongs to.
+     */
     @JsonProperty("keyRing")
     public void setKeyRing(String keyRing) {
         this.keyRing = keyRing;
     }
 
+    /**
+     * Location is the GCP location in which the Key Ring exists.
+     */
     @JsonProperty("location")
     public String getLocation() {
         return location;
     }
 
+    /**
+     * Location is the GCP location in which the Key Ring exists.
+     */
     @JsonProperty("location")
     public void setLocation(String location) {
         this.location = location;
     }
 
+    /**
+     * Name is the name of the customer managed encryption key to be used for the disk encryption.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the customer managed encryption key to be used for the disk encryption.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * ProjectID is the ID of the Project in which the KMS Key Ring exists. Defaults to the VM ProjectID if not set.
+     */
     @JsonProperty("projectID")
     public String getProjectID() {
         return projectID;
     }
 
+    /**
+     * ProjectID is the ID of the Project in which the KMS Key Ring exists. Defaults to the VM ProjectID if not set.
+     */
     @JsonProperty("projectID")
     public void setProjectID(String projectID) {
         this.projectID = projectID;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/MachinePool.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/MachinePool.java
index 332dee5e9c1..88d8f238f40 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/MachinePool.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/MachinePool.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePool stores the configuration for a machine pool installed on GCP.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -114,93 +117,147 @@ public MachinePool(String confidentialCompute, String onHostMaintenance, OSDisk
         this.zones = zones;
     }
 
+    /**
+     * ConfidentialCompute Defines whether the instance should have confidential compute enabled. If enabled OnHostMaintenance is required to be set to "Terminate". If omitted, the platform chooses a default, which is subject to change over time, currently that default is false.
+     */
     @JsonProperty("confidentialCompute")
     public String getConfidentialCompute() {
         return confidentialCompute;
     }
 
+    /**
+     * ConfidentialCompute Defines whether the instance should have confidential compute enabled. If enabled OnHostMaintenance is required to be set to "Terminate". If omitted, the platform chooses a default, which is subject to change over time, currently that default is false.
+     */
     @JsonProperty("confidentialCompute")
     public void setConfidentialCompute(String confidentialCompute) {
         this.confidentialCompute = confidentialCompute;
     }
 
+    /**
+     * OnHostMaintenance determines the behavior when a maintenance event occurs that might cause the instance to reboot. Allowed values are "Migrate" and "Terminate". If omitted, the platform chooses a default, which is subject to change over time, currently that default is "Migrate".
+     */
     @JsonProperty("onHostMaintenance")
     public String getOnHostMaintenance() {
         return onHostMaintenance;
     }
 
+    /**
+     * OnHostMaintenance determines the behavior when a maintenance event occurs that might cause the instance to reboot. Allowed values are "Migrate" and "Terminate". If omitted, the platform chooses a default, which is subject to change over time, currently that default is "Migrate".
+     */
     @JsonProperty("onHostMaintenance")
     public void setOnHostMaintenance(String onHostMaintenance) {
         this.onHostMaintenance = onHostMaintenance;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on GCP.
+     */
     @JsonProperty("osDisk")
     public OSDisk getOsDisk() {
         return osDisk;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on GCP.
+     */
     @JsonProperty("osDisk")
     public void setOsDisk(OSDisk osDisk) {
         this.osDisk = osDisk;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on GCP.
+     */
     @JsonProperty("osImage")
     public OSImage getOsImage() {
         return osImage;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on GCP.
+     */
     @JsonProperty("osImage")
     public void setOsImage(OSImage osImage) {
         this.osImage = osImage;
     }
 
+    /**
+     * SecureBoot Defines whether the instance should have secure boot enabled. secure boot Verify the digital signature of all boot components, and halt the boot process if signature verification fails. If omitted, the platform chooses a default, which is subject to change over time, currently that default is false.
+     */
     @JsonProperty("secureBoot")
     public String getSecureBoot() {
         return secureBoot;
     }
 
+    /**
+     * SecureBoot Defines whether the instance should have secure boot enabled. secure boot Verify the digital signature of all boot components, and halt the boot process if signature verification fails. If omitted, the platform chooses a default, which is subject to change over time, currently that default is false.
+     */
     @JsonProperty("secureBoot")
     public void setSecureBoot(String secureBoot) {
         this.secureBoot = secureBoot;
     }
 
+    /**
+     * ServiceAccount is the email of a gcp service account to be used during installations. The provided service account can be attached to both control-plane nodes and worker nodes in order to provide the permissions required by the cloud provider.
+     */
     @JsonProperty("serviceAccount")
     public String getServiceAccount() {
         return serviceAccount;
     }
 
+    /**
+     * ServiceAccount is the email of a gcp service account to be used during installations. The provided service account can be attached to both control-plane nodes and worker nodes in order to provide the permissions required by the cloud provider.
+     */
     @JsonProperty("serviceAccount")
     public void setServiceAccount(String serviceAccount) {
         this.serviceAccount = serviceAccount;
     }
 
+    /**
+     * Tags defines a set of network tags which will be added to instances in the machineset
+     */
     @JsonProperty("tags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getTags() {
         return tags;
     }
 
+    /**
+     * Tags defines a set of network tags which will be added to instances in the machineset
+     */
     @JsonProperty("tags")
     public void setTags(List<String> tags) {
         this.tags = tags;
     }
 
+    /**
+     * InstanceType defines the GCP instance type. eg. n1-standard-4
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * InstanceType defines the GCP instance type. eg. n1-standard-4
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * Zones is list of availability zones that can be used.
+     */
     @JsonProperty("zones")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getZones() {
         return zones;
     }
 
+    /**
+     * Zones is list of availability zones that can be used.
+     */
     @JsonProperty("zones")
     public void setZones(List<String> zones) {
         this.zones = zones;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/Metadata.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/Metadata.java
index d43ae0f2e86..f5d7395dfca 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/Metadata.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/Metadata.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metadata contains GCP metadata (e.g. for uninstalling the cluster).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public Metadata(String networkProjectID, String privateZoneDomain, String projec
         this.region = region;
     }
 
+    /**
+     * Metadata contains GCP metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("networkProjectID")
     public String getNetworkProjectID() {
         return networkProjectID;
     }
 
+    /**
+     * Metadata contains GCP metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("networkProjectID")
     public void setNetworkProjectID(String networkProjectID) {
         this.networkProjectID = networkProjectID;
     }
 
+    /**
+     * Metadata contains GCP metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("privateZoneDomain")
     public String getPrivateZoneDomain() {
         return privateZoneDomain;
     }
 
+    /**
+     * Metadata contains GCP metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("privateZoneDomain")
     public void setPrivateZoneDomain(String privateZoneDomain) {
         this.privateZoneDomain = privateZoneDomain;
     }
 
+    /**
+     * Metadata contains GCP metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("projectID")
     public String getProjectID() {
         return projectID;
     }
 
+    /**
+     * Metadata contains GCP metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("projectID")
     public void setProjectID(String projectID) {
         this.projectID = projectID;
     }
 
+    /**
+     * Metadata contains GCP metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Metadata contains GCP metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/Metric.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/Metric.java
index ab5ed06f0fd..e3598e7669c 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/Metric.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/Metric.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metric identify a quota. Service/Label matches the Google Quota API names for quota metrics
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,32 +90,50 @@ public Metric(Map<String, String> dimensions, String limit, String service) {
         this.service = service;
     }
 
+    /**
+     * Dimensions are unique axes on which this Limit is applied (e.g. region: us-central-1)
+     */
     @JsonProperty("dimensions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getDimensions() {
         return dimensions;
     }
 
+    /**
+     * Dimensions are unique axes on which this Limit is applied (e.g. region: us-central-1)
+     */
     @JsonProperty("dimensions")
     public void setDimensions(Map<String, String> dimensions) {
         this.dimensions = dimensions;
     }
 
+    /**
+     * Limit is the name of the item that's limited (e.g. cpus)
+     */
     @JsonProperty("limit")
     public String getLimit() {
         return limit;
     }
 
+    /**
+     * Limit is the name of the item that's limited (e.g. cpus)
+     */
     @JsonProperty("limit")
     public void setLimit(String limit) {
         this.limit = limit;
     }
 
+    /**
+     * Service is the Google Cloud Service to which this quota belongs (e.g. compute.googleapis.com)
+     */
     @JsonProperty("service")
     public String getService() {
         return service;
     }
 
+    /**
+     * Service is the Google Cloud Service to which this quota belongs (e.g. compute.googleapis.com)
+     */
     @JsonProperty("service")
     public void setService(String service) {
         this.service = service;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/OSDisk.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/OSDisk.java
index d9c90f809a8..68472c6a02f 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/OSDisk.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/OSDisk.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OSDisk defines the disk for machines on GCP.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public OSDisk(Long diskSizeGB, String diskType, EncryptionKeyReference encryptio
         this.encryptionKey = encryptionKey;
     }
 
+    /**
+     * DiskSizeGB defines the size of disk in GB.
+     */
     @JsonProperty("DiskSizeGB")
     public Long getDiskSizeGB() {
         return diskSizeGB;
     }
 
+    /**
+     * DiskSizeGB defines the size of disk in GB.
+     */
     @JsonProperty("DiskSizeGB")
     public void setDiskSizeGB(Long diskSizeGB) {
         this.diskSizeGB = diskSizeGB;
     }
 
+    /**
+     * DiskType defines the type of disk. For control plane nodes, the valid values are pd-balanced, pd-ssd, and hyperdisk-balanced.
+     */
     @JsonProperty("diskType")
     public String getDiskType() {
         return diskType;
     }
 
+    /**
+     * DiskType defines the type of disk. For control plane nodes, the valid values are pd-balanced, pd-ssd, and hyperdisk-balanced.
+     */
     @JsonProperty("diskType")
     public void setDiskType(String diskType) {
         this.diskType = diskType;
     }
 
+    /**
+     * OSDisk defines the disk for machines on GCP.
+     */
     @JsonProperty("encryptionKey")
     public EncryptionKeyReference getEncryptionKey() {
         return encryptionKey;
     }
 
+    /**
+     * OSDisk defines the disk for machines on GCP.
+     */
     @JsonProperty("encryptionKey")
     public void setEncryptionKey(EncryptionKeyReference encryptionKey) {
         this.encryptionKey = encryptionKey;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/OSImage.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/OSImage.java
index df2224f338d..91e5cac781f 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/OSImage.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/OSImage.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OSImage defines the image to use for the OS.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public OSImage(String name, String project) {
         this.project = project;
     }
 
+    /**
+     * Name defines the name of the image.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name defines the name of the image.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Project defines the name of the project containing the image.
+     */
     @JsonProperty("project")
     public String getProject() {
         return project;
     }
 
+    /**
+     * Project defines the name of the project containing the image.
+     */
     @JsonProperty("project")
     public void setProject(String project) {
         this.project = project;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/Platform.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/Platform.java
index a90122974c6..8f69276371b 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/Platform.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/Platform.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Platform stores all the global configuration that all machinesets use.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -118,103 +121,163 @@ public Platform(String computeSubnet, String controlPlaneSubnet, MachinePool def
         this.userTags = userTags;
     }
 
+    /**
+     * ComputeSubnet is an existing subnet where the compute nodes will be deployed. The value should be the name of the subnet.
+     */
     @JsonProperty("computeSubnet")
     public String getComputeSubnet() {
         return computeSubnet;
     }
 
+    /**
+     * ComputeSubnet is an existing subnet where the compute nodes will be deployed. The value should be the name of the subnet.
+     */
     @JsonProperty("computeSubnet")
     public void setComputeSubnet(String computeSubnet) {
         this.computeSubnet = computeSubnet;
     }
 
+    /**
+     * ControlPlaneSubnet is an existing subnet where the control plane will be deployed. The value should be the name of the subnet.
+     */
     @JsonProperty("controlPlaneSubnet")
     public String getControlPlaneSubnet() {
         return controlPlaneSubnet;
     }
 
+    /**
+     * ControlPlaneSubnet is an existing subnet where the control plane will be deployed. The value should be the name of the subnet.
+     */
     @JsonProperty("controlPlaneSubnet")
     public void setControlPlaneSubnet(String controlPlaneSubnet) {
         this.controlPlaneSubnet = controlPlaneSubnet;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("defaultMachinePlatform")
     public MachinePool getDefaultMachinePlatform() {
         return defaultMachinePlatform;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("defaultMachinePlatform")
     public void setDefaultMachinePlatform(MachinePool defaultMachinePlatform) {
         this.defaultMachinePlatform = defaultMachinePlatform;
     }
 
+    /**
+     * Network specifies an existing VPC where the cluster should be created rather than provisioning a new one.
+     */
     @JsonProperty("network")
     public String getNetwork() {
         return network;
     }
 
+    /**
+     * Network specifies an existing VPC where the cluster should be created rather than provisioning a new one.
+     */
     @JsonProperty("network")
     public void setNetwork(String network) {
         this.network = network;
     }
 
+    /**
+     * NetworkProjectID specifies which project the network and subnets exist in when they are not in the main ProjectID.
+     */
     @JsonProperty("networkProjectID")
     public String getNetworkProjectID() {
         return networkProjectID;
     }
 
+    /**
+     * NetworkProjectID specifies which project the network and subnets exist in when they are not in the main ProjectID.
+     */
     @JsonProperty("networkProjectID")
     public void setNetworkProjectID(String networkProjectID) {
         this.networkProjectID = networkProjectID;
     }
 
+    /**
+     * ProjectID is the the project that will be used for the cluster.
+     */
     @JsonProperty("projectID")
     public String getProjectID() {
         return projectID;
     }
 
+    /**
+     * ProjectID is the the project that will be used for the cluster.
+     */
     @JsonProperty("projectID")
     public void setProjectID(String projectID) {
         this.projectID = projectID;
     }
 
+    /**
+     * Region specifies the GCP region where the cluster will be created.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Region specifies the GCP region where the cluster will be created.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * userLabels has additional keys and values that the installer will add as labels to all resources that it creates on GCP. Resources created by the cluster itself may not include these labels.
+     */
     @JsonProperty("userLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<UserLabel> getUserLabels() {
         return userLabels;
     }
 
+    /**
+     * userLabels has additional keys and values that the installer will add as labels to all resources that it creates on GCP. Resources created by the cluster itself may not include these labels.
+     */
     @JsonProperty("userLabels")
     public void setUserLabels(List<UserLabel> userLabels) {
         this.userLabels = userLabels;
     }
 
+    /**
+     * UserProvisionedDNS indicates if the customer is providing their own DNS solution in place of the default provisioned by the Installer.
+     */
     @JsonProperty("userProvisionedDNS")
     public String getUserProvisionedDNS() {
         return userProvisionedDNS;
     }
 
+    /**
+     * UserProvisionedDNS indicates if the customer is providing their own DNS solution in place of the default provisioned by the Installer.
+     */
     @JsonProperty("userProvisionedDNS")
     public void setUserProvisionedDNS(String userProvisionedDNS) {
         this.userProvisionedDNS = userProvisionedDNS;
     }
 
+    /**
+     * userTags has additional keys and values that the installer will add as tags to all resources that it creates on GCP. Resources created by the cluster itself may not include these tags. Tag key and tag value should be the shortnames of the tag key and tag value resource.
+     */
     @JsonProperty("userTags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<UserTag> getUserTags() {
         return userTags;
     }
 
+    /**
+     * userTags has additional keys and values that the installer will add as tags to all resources that it creates on GCP. Resources created by the cluster itself may not include these tags. Tag key and tag value should be the shortnames of the tag key and tag value resource.
+     */
     @JsonProperty("userTags")
     public void setUserTags(List<UserTag> userTags) {
         this.userTags = userTags;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/QuotaUsage.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/QuotaUsage.java
index 809bc205299..73d40eb9adc 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/QuotaUsage.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/QuotaUsage.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * QuotaUsage identifies a quota metric and records the usage
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,42 +94,66 @@ public QuotaUsage(Long amount, Map<String, String> dimensions, String limit, Str
         this.service = service;
     }
 
+    /**
+     * Amount is the amount of the quota being used
+     */
     @JsonProperty("amount")
     public Long getAmount() {
         return amount;
     }
 
+    /**
+     * Amount is the amount of the quota being used
+     */
     @JsonProperty("amount")
     public void setAmount(Long amount) {
         this.amount = amount;
     }
 
+    /**
+     * Dimensions are unique axes on which this Limit is applied (e.g. region: us-central-1)
+     */
     @JsonProperty("dimensions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getDimensions() {
         return dimensions;
     }
 
+    /**
+     * Dimensions are unique axes on which this Limit is applied (e.g. region: us-central-1)
+     */
     @JsonProperty("dimensions")
     public void setDimensions(Map<String, String> dimensions) {
         this.dimensions = dimensions;
     }
 
+    /**
+     * Limit is the name of the item that's limited (e.g. cpus)
+     */
     @JsonProperty("limit")
     public String getLimit() {
         return limit;
     }
 
+    /**
+     * Limit is the name of the item that's limited (e.g. cpus)
+     */
     @JsonProperty("limit")
     public void setLimit(String limit) {
         this.limit = limit;
     }
 
+    /**
+     * Service is the Google Cloud Service to which this quota belongs (e.g. compute.googleapis.com)
+     */
     @JsonProperty("service")
     public String getService() {
         return service;
     }
 
+    /**
+     * Service is the Google Cloud Service to which this quota belongs (e.g. compute.googleapis.com)
+     */
     @JsonProperty("service")
     public void setService(String service) {
         this.service = service;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/UserLabel.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/UserLabel.java
index 94a27e7070b..fe167a11d49 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/UserLabel.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/UserLabel.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UserLabel is a label to apply to GCP resources created for the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public UserLabel(String key, String value) {
         this.value = value;
     }
 
+    /**
+     * key is the key part of the label. A label key can have a maximum of 63 characters and cannot be empty. Label must begin with a lowercase letter, and must contain only lowercase letters, numeric characters, and the following special characters `_-`.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * key is the key part of the label. A label key can have a maximum of 63 characters and cannot be empty. Label must begin with a lowercase letter, and must contain only lowercase letters, numeric characters, and the following special characters `_-`.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * value is the value part of the label. A label value can have a maximum of 63 characters and cannot be empty. Value must contain only lowercase letters, numeric characters, and the following special characters `_-`.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * value is the value part of the label. A label value can have a maximum of 63 characters and cannot be empty. Value must contain only lowercase letters, numeric characters, and the following special characters `_-`.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/UserTag.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/UserTag.java
index bee8475f315..f1803afc04e 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/UserTag.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/gcp/v1/UserTag.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UserTag is a tag to apply to GCP resources created for the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public UserTag(String key, String parentID, String value) {
         this.value = value;
     }
 
+    /**
+     * key is the key part of the tag. A tag key can have a maximum of 63 characters and cannot be empty. Tag key must begin and end with an alphanumeric character, and must contain only uppercase, lowercase alphanumeric characters, and the following special characters `._-`.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * key is the key part of the tag. A tag key can have a maximum of 63 characters and cannot be empty. Tag key must begin and end with an alphanumeric character, and must contain only uppercase, lowercase alphanumeric characters, and the following special characters `._-`.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * parentID is the ID of the hierarchical resource where the tags are defined, e.g. at the Organization or the Project level. To find the Organization ID or Project ID refer to the following pages: https://cloud.google.com/resource-manager/docs/creating-managing-organization#retrieving_your_organization_id, https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects. An OrganizationID must consist of decimal numbers, and cannot have leading zeroes. A ProjectID must be 6 to 30 characters in length, can only contain lowercase letters, numbers, and hyphens, and must start with a letter, and cannot end with a hyphen.
+     */
     @JsonProperty("parentID")
     public String getParentID() {
         return parentID;
     }
 
+    /**
+     * parentID is the ID of the hierarchical resource where the tags are defined, e.g. at the Organization or the Project level. To find the Organization ID or Project ID refer to the following pages: https://cloud.google.com/resource-manager/docs/creating-managing-organization#retrieving_your_organization_id, https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects. An OrganizationID must consist of decimal numbers, and cannot have leading zeroes. A ProjectID must be 6 to 30 characters in length, can only contain lowercase letters, numbers, and hyphens, and must start with a letter, and cannot end with a hyphen.
+     */
     @JsonProperty("parentID")
     public void setParentID(String parentID) {
         this.parentID = parentID;
     }
 
+    /**
+     * value is the value part of the tag. A tag value can have a maximum of 63 characters and cannot be empty. Tag value must begin and end with an alphanumeric character, and must contain only uppercase, lowercase alphanumeric characters, and the following special characters `_-.@%=+:,&#42;#&amp;(){}[]` and spaces.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * value is the value part of the tag. A tag value can have a maximum of 63 characters and cannot be empty. Tag value must begin and end with an alphanumeric character, and must contain only uppercase, lowercase alphanumeric characters, and the following special characters `_-.@%=+:,&#42;#&amp;(){}[]` and spaces.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ibmcloud/v1/BootVolume.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ibmcloud/v1/BootVolume.java
index a90f513f04c..7a90521350f 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ibmcloud/v1/BootVolume.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ibmcloud/v1/BootVolume.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BootVolume stores the configuration for an individual machine's boot volume.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public BootVolume(String encryptionKey) {
         this.encryptionKey = encryptionKey;
     }
 
+    /**
+     * EncryptionKey is the CRN referencing a Key Protect or Hyper Protect Crypto Services key to use for volume encryption. If not specified, a provider managed encryption key will be used.
+     */
     @JsonProperty("encryptionKey")
     public String getEncryptionKey() {
         return encryptionKey;
     }
 
+    /**
+     * EncryptionKey is the CRN referencing a Key Protect or Hyper Protect Crypto Services key to use for volume encryption. If not specified, a provider managed encryption key will be used.
+     */
     @JsonProperty("encryptionKey")
     public void setEncryptionKey(String encryptionKey) {
         this.encryptionKey = encryptionKey;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ibmcloud/v1/DedicatedHost.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ibmcloud/v1/DedicatedHost.java
index 8067e33fff6..67dea64017b 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ibmcloud/v1/DedicatedHost.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ibmcloud/v1/DedicatedHost.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DedicatedHost stores the configuration for the machine's dedicated host platform.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public DedicatedHost(String name, String profile) {
         this.profile = profile;
     }
 
+    /**
+     * Name is the name of the dedicated host to provision the machine on. If specified, machines will be created on pre-existing dedicated host.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the dedicated host to provision the machine on. If specified, machines will be created on pre-existing dedicated host.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Profile is the profile ID for the dedicated host. If specified, new dedicated host will be created for machines.
+     */
     @JsonProperty("profile")
     public String getProfile() {
         return profile;
     }
 
+    /**
+     * Profile is the profile ID for the dedicated host. If specified, new dedicated host will be created for machines.
+     */
     @JsonProperty("profile")
     public void setProfile(String profile) {
         this.profile = profile;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ibmcloud/v1/EndpointsJSON.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ibmcloud/v1/EndpointsJSON.java
index 6083c495c55..1f8cf6b1ab4 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ibmcloud/v1/EndpointsJSON.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ibmcloud/v1/EndpointsJSON.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EndpointsJSON represents the JSON format to override IBM Cloud Terraform provider utilized service endpoints. https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/guides/custom-service-endpoints#file-structure-for-endpoints-file
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -118,111 +121,177 @@ public EndpointsJSON(EndpointsVisibility iBMCLOUDCISAPIENDPOINT, EndpointsVisibi
         this.iBMCLOUDRESOURCEMANAGEMENTAPIENDPOINT = iBMCLOUDRESOURCEMANAGEMENTAPIENDPOINT;
     }
 
+    /**
+     * EndpointsJSON represents the JSON format to override IBM Cloud Terraform provider utilized service endpoints. https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/guides/custom-service-endpoints#file-structure-for-endpoints-file
+     */
     @JsonProperty("IBMCLOUD_CIS_API_ENDPOINT")
     public EndpointsVisibility getIBMCLOUDCISAPIENDPOINT() {
         return iBMCLOUDCISAPIENDPOINT;
     }
 
+    /**
+     * EndpointsJSON represents the JSON format to override IBM Cloud Terraform provider utilized service endpoints. https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/guides/custom-service-endpoints#file-structure-for-endpoints-file
+     */
     @JsonProperty("IBMCLOUD_CIS_API_ENDPOINT")
     public void setIBMCLOUDCISAPIENDPOINT(EndpointsVisibility iBMCLOUDCISAPIENDPOINT) {
         this.iBMCLOUDCISAPIENDPOINT = iBMCLOUDCISAPIENDPOINT;
     }
 
+    /**
+     * EndpointsJSON represents the JSON format to override IBM Cloud Terraform provider utilized service endpoints. https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/guides/custom-service-endpoints#file-structure-for-endpoints-file
+     */
     @JsonProperty("IBMCLOUD_COS_CONFIG_ENDPOINT")
     public EndpointsVisibility getIBMCLOUDCOSCONFIGENDPOINT() {
         return iBMCLOUDCOSCONFIGENDPOINT;
     }
 
+    /**
+     * EndpointsJSON represents the JSON format to override IBM Cloud Terraform provider utilized service endpoints. https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/guides/custom-service-endpoints#file-structure-for-endpoints-file
+     */
     @JsonProperty("IBMCLOUD_COS_CONFIG_ENDPOINT")
     public void setIBMCLOUDCOSCONFIGENDPOINT(EndpointsVisibility iBMCLOUDCOSCONFIGENDPOINT) {
         this.iBMCLOUDCOSCONFIGENDPOINT = iBMCLOUDCOSCONFIGENDPOINT;
     }
 
+    /**
+     * EndpointsJSON represents the JSON format to override IBM Cloud Terraform provider utilized service endpoints. https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/guides/custom-service-endpoints#file-structure-for-endpoints-file
+     */
     @JsonProperty("IBMCLOUD_GS_API_ENDPOINT")
     public EndpointsVisibility getIBMCLOUDGSAPIENDPOINT() {
         return iBMCLOUDGSAPIENDPOINT;
     }
 
+    /**
+     * EndpointsJSON represents the JSON format to override IBM Cloud Terraform provider utilized service endpoints. https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/guides/custom-service-endpoints#file-structure-for-endpoints-file
+     */
     @JsonProperty("IBMCLOUD_GS_API_ENDPOINT")
     public void setIBMCLOUDGSAPIENDPOINT(EndpointsVisibility iBMCLOUDGSAPIENDPOINT) {
         this.iBMCLOUDGSAPIENDPOINT = iBMCLOUDGSAPIENDPOINT;
     }
 
+    /**
+     * EndpointsJSON represents the JSON format to override IBM Cloud Terraform provider utilized service endpoints. https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/guides/custom-service-endpoints#file-structure-for-endpoints-file
+     */
     @JsonProperty("IBMCLOUD_GT_API_ENDPOINT")
     public EndpointsVisibility getIBMCLOUDGTAPIENDPOINT() {
         return iBMCLOUDGTAPIENDPOINT;
     }
 
+    /**
+     * EndpointsJSON represents the JSON format to override IBM Cloud Terraform provider utilized service endpoints. https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/guides/custom-service-endpoints#file-structure-for-endpoints-file
+     */
     @JsonProperty("IBMCLOUD_GT_API_ENDPOINT")
     public void setIBMCLOUDGTAPIENDPOINT(EndpointsVisibility iBMCLOUDGTAPIENDPOINT) {
         this.iBMCLOUDGTAPIENDPOINT = iBMCLOUDGTAPIENDPOINT;
     }
 
+    /**
+     * EndpointsJSON represents the JSON format to override IBM Cloud Terraform provider utilized service endpoints. https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/guides/custom-service-endpoints#file-structure-for-endpoints-file
+     */
     @JsonProperty("IBMCLOUD_HPCS_API_ENDPOINT")
     public EndpointsVisibility getIBMCLOUDHPCSAPIENDPOINT() {
         return iBMCLOUDHPCSAPIENDPOINT;
     }
 
+    /**
+     * EndpointsJSON represents the JSON format to override IBM Cloud Terraform provider utilized service endpoints. https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/guides/custom-service-endpoints#file-structure-for-endpoints-file
+     */
     @JsonProperty("IBMCLOUD_HPCS_API_ENDPOINT")
     public void setIBMCLOUDHPCSAPIENDPOINT(EndpointsVisibility iBMCLOUDHPCSAPIENDPOINT) {
         this.iBMCLOUDHPCSAPIENDPOINT = iBMCLOUDHPCSAPIENDPOINT;
     }
 
+    /**
+     * EndpointsJSON represents the JSON format to override IBM Cloud Terraform provider utilized service endpoints. https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/guides/custom-service-endpoints#file-structure-for-endpoints-file
+     */
     @JsonProperty("IBMCLOUD_IAM_API_ENDPOINT")
     public EndpointsVisibility getIBMCLOUDIAMAPIENDPOINT() {
         return iBMCLOUDIAMAPIENDPOINT;
     }
 
+    /**
+     * EndpointsJSON represents the JSON format to override IBM Cloud Terraform provider utilized service endpoints. https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/guides/custom-service-endpoints#file-structure-for-endpoints-file
+     */
     @JsonProperty("IBMCLOUD_IAM_API_ENDPOINT")
     public void setIBMCLOUDIAMAPIENDPOINT(EndpointsVisibility iBMCLOUDIAMAPIENDPOINT) {
         this.iBMCLOUDIAMAPIENDPOINT = iBMCLOUDIAMAPIENDPOINT;
     }
 
+    /**
+     * EndpointsJSON represents the JSON format to override IBM Cloud Terraform provider utilized service endpoints. https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/guides/custom-service-endpoints#file-structure-for-endpoints-file
+     */
     @JsonProperty("IBMCLOUD_IS_NG_API_ENDPOINT")
     public EndpointsVisibility getIBMCLOUDISNGAPIENDPOINT() {
         return iBMCLOUDISNGAPIENDPOINT;
     }
 
+    /**
+     * EndpointsJSON represents the JSON format to override IBM Cloud Terraform provider utilized service endpoints. https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/guides/custom-service-endpoints#file-structure-for-endpoints-file
+     */
     @JsonProperty("IBMCLOUD_IS_NG_API_ENDPOINT")
     public void setIBMCLOUDISNGAPIENDPOINT(EndpointsVisibility iBMCLOUDISNGAPIENDPOINT) {
         this.iBMCLOUDISNGAPIENDPOINT = iBMCLOUDISNGAPIENDPOINT;
     }
 
+    /**
+     * EndpointsJSON represents the JSON format to override IBM Cloud Terraform provider utilized service endpoints. https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/guides/custom-service-endpoints#file-structure-for-endpoints-file
+     */
     @JsonProperty("IBMCLOUD_KP_API_ENDPOINT")
     public EndpointsVisibility getIBMCLOUDKPAPIENDPOINT() {
         return iBMCLOUDKPAPIENDPOINT;
     }
 
+    /**
+     * EndpointsJSON represents the JSON format to override IBM Cloud Terraform provider utilized service endpoints. https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/guides/custom-service-endpoints#file-structure-for-endpoints-file
+     */
     @JsonProperty("IBMCLOUD_KP_API_ENDPOINT")
     public void setIBMCLOUDKPAPIENDPOINT(EndpointsVisibility iBMCLOUDKPAPIENDPOINT) {
         this.iBMCLOUDKPAPIENDPOINT = iBMCLOUDKPAPIENDPOINT;
     }
 
+    /**
+     * EndpointsJSON represents the JSON format to override IBM Cloud Terraform provider utilized service endpoints. https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/guides/custom-service-endpoints#file-structure-for-endpoints-file
+     */
     @JsonProperty("IBMCLOUD_PRIVATE_DNS_API_ENDPOINT")
     public EndpointsVisibility getIBMCLOUDPRIVATEDNSAPIENDPOINT() {
         return iBMCLOUDPRIVATEDNSAPIENDPOINT;
     }
 
+    /**
+     * EndpointsJSON represents the JSON format to override IBM Cloud Terraform provider utilized service endpoints. https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/guides/custom-service-endpoints#file-structure-for-endpoints-file
+     */
     @JsonProperty("IBMCLOUD_PRIVATE_DNS_API_ENDPOINT")
     public void setIBMCLOUDPRIVATEDNSAPIENDPOINT(EndpointsVisibility iBMCLOUDPRIVATEDNSAPIENDPOINT) {
         this.iBMCLOUDPRIVATEDNSAPIENDPOINT = iBMCLOUDPRIVATEDNSAPIENDPOINT;
     }
 
+    /**
+     * EndpointsJSON represents the JSON format to override IBM Cloud Terraform provider utilized service endpoints. https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/guides/custom-service-endpoints#file-structure-for-endpoints-file
+     */
     @JsonProperty("IBMCLOUD_RESOURCE_CONTROLLER_API_ENDPOINT")
     public EndpointsVisibility getIBMCLOUDRESOURCECONTROLLERAPIENDPOINT() {
         return iBMCLOUDRESOURCECONTROLLERAPIENDPOINT;
     }
 
+    /**
+     * EndpointsJSON represents the JSON format to override IBM Cloud Terraform provider utilized service endpoints. https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/guides/custom-service-endpoints#file-structure-for-endpoints-file
+     */
     @JsonProperty("IBMCLOUD_RESOURCE_CONTROLLER_API_ENDPOINT")
     public void setIBMCLOUDRESOURCECONTROLLERAPIENDPOINT(EndpointsVisibility iBMCLOUDRESOURCECONTROLLERAPIENDPOINT) {
         this.iBMCLOUDRESOURCECONTROLLERAPIENDPOINT = iBMCLOUDRESOURCECONTROLLERAPIENDPOINT;
     }
 
+    /**
+     * EndpointsJSON represents the JSON format to override IBM Cloud Terraform provider utilized service endpoints. https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/guides/custom-service-endpoints#file-structure-for-endpoints-file
+     */
     @JsonProperty("IBMCLOUD_RESOURCE_MANAGEMENT_API_ENDPOINT")
     public EndpointsVisibility getIBMCLOUDRESOURCEMANAGEMENTAPIENDPOINT() {
         return iBMCLOUDRESOURCEMANAGEMENTAPIENDPOINT;
     }
 
+    /**
+     * EndpointsJSON represents the JSON format to override IBM Cloud Terraform provider utilized service endpoints. https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/guides/custom-service-endpoints#file-structure-for-endpoints-file
+     */
     @JsonProperty("IBMCLOUD_RESOURCE_MANAGEMENT_API_ENDPOINT")
     public void setIBMCLOUDRESOURCEMANAGEMENTAPIENDPOINT(EndpointsVisibility iBMCLOUDRESOURCEMANAGEMENTAPIENDPOINT) {
         this.iBMCLOUDRESOURCEMANAGEMENTAPIENDPOINT = iBMCLOUDRESOURCEMANAGEMENTAPIENDPOINT;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ibmcloud/v1/EndpointsVisibility.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ibmcloud/v1/EndpointsVisibility.java
index 0202e8db8f6..249c58517aa 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ibmcloud/v1/EndpointsVisibility.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ibmcloud/v1/EndpointsVisibility.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EndpointsVisibility contains region mapped endpoint for a service.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -84,23 +87,35 @@ public EndpointsVisibility(Map<String, String> _private, Map<String, String> _pu
         this._public = _public;
     }
 
+    /**
+     * Private is a string-string map of a region name to endpoint URL To prevent maintaining a list of supported regions here, we simply use a map instead of a struct
+     */
     @JsonProperty("private")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getPrivate() {
         return _private;
     }
 
+    /**
+     * Private is a string-string map of a region name to endpoint URL To prevent maintaining a list of supported regions here, we simply use a map instead of a struct
+     */
     @JsonProperty("private")
     public void setPrivate(Map<String, String> _private) {
         this._private = _private;
     }
 
+    /**
+     * Public is a string-string map of a region name to endpoint URL To prevent maintaining a list of supported regions here, we simply use a map instead of a struct
+     */
     @JsonProperty("public")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getPublic() {
         return _public;
     }
 
+    /**
+     * Public is a string-string map of a region name to endpoint URL To prevent maintaining a list of supported regions here, we simply use a map instead of a struct
+     */
     @JsonProperty("public")
     public void setPublic(Map<String, String> _public) {
         this._public = _public;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ibmcloud/v1/MachinePool.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ibmcloud/v1/MachinePool.java
index 8fbacf76fe6..30312a58563 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ibmcloud/v1/MachinePool.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ibmcloud/v1/MachinePool.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePool stores the configuration for a machine pool installed on IBM Cloud.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,43 +97,67 @@ public MachinePool(BootVolume bootVolume, List<DedicatedHost> dedicatedHosts, St
         this.zones = zones;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on IBM Cloud.
+     */
     @JsonProperty("bootVolume")
     public BootVolume getBootVolume() {
         return bootVolume;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on IBM Cloud.
+     */
     @JsonProperty("bootVolume")
     public void setBootVolume(BootVolume bootVolume) {
         this.bootVolume = bootVolume;
     }
 
+    /**
+     * DedicatedHosts is the configuration for the machine's dedicated host and profile.
+     */
     @JsonProperty("dedicatedHosts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DedicatedHost> getDedicatedHosts() {
         return dedicatedHosts;
     }
 
+    /**
+     * DedicatedHosts is the configuration for the machine's dedicated host and profile.
+     */
     @JsonProperty("dedicatedHosts")
     public void setDedicatedHosts(List<DedicatedHost> dedicatedHosts) {
         this.dedicatedHosts = dedicatedHosts;
     }
 
+    /**
+     * InstanceType is the VSI machine profile.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * InstanceType is the VSI machine profile.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * Zones is the list of availability zones used for machines in the pool.
+     */
     @JsonProperty("zones")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getZones() {
         return zones;
     }
 
+    /**
+     * Zones is the list of availability zones used for machines in the pool.
+     */
     @JsonProperty("zones")
     public void setZones(List<String> zones) {
         this.zones = zones;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ibmcloud/v1/Metadata.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ibmcloud/v1/Metadata.java
index cc1d386affb..0b02fc298bc 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ibmcloud/v1/Metadata.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ibmcloud/v1/Metadata.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metadata contains IBM Cloud metadata (e.g. for uninstalling the cluster).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -115,93 +118,147 @@ public Metadata(String accountID, String baseDomain, String cisInstanceCRN, Stri
         this.vpc = vpc;
     }
 
+    /**
+     * Metadata contains IBM Cloud metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("accountID")
     public String getAccountID() {
         return accountID;
     }
 
+    /**
+     * Metadata contains IBM Cloud metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("accountID")
     public void setAccountID(String accountID) {
         this.accountID = accountID;
     }
 
+    /**
+     * Metadata contains IBM Cloud metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("baseDomain")
     public String getBaseDomain() {
         return baseDomain;
     }
 
+    /**
+     * Metadata contains IBM Cloud metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("baseDomain")
     public void setBaseDomain(String baseDomain) {
         this.baseDomain = baseDomain;
     }
 
+    /**
+     * Metadata contains IBM Cloud metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("cisInstanceCRN")
     public String getCisInstanceCRN() {
         return cisInstanceCRN;
     }
 
+    /**
+     * Metadata contains IBM Cloud metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("cisInstanceCRN")
     public void setCisInstanceCRN(String cisInstanceCRN) {
         this.cisInstanceCRN = cisInstanceCRN;
     }
 
+    /**
+     * Metadata contains IBM Cloud metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("dnsInstanceID")
     public String getDnsInstanceID() {
         return dnsInstanceID;
     }
 
+    /**
+     * Metadata contains IBM Cloud metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("dnsInstanceID")
     public void setDnsInstanceID(String dnsInstanceID) {
         this.dnsInstanceID = dnsInstanceID;
     }
 
+    /**
+     * Metadata contains IBM Cloud metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Metadata contains IBM Cloud metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * Metadata contains IBM Cloud metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("resourceGroupName")
     public String getResourceGroupName() {
         return resourceGroupName;
     }
 
+    /**
+     * Metadata contains IBM Cloud metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("resourceGroupName")
     public void setResourceGroupName(String resourceGroupName) {
         this.resourceGroupName = resourceGroupName;
     }
 
+    /**
+     * Metadata contains IBM Cloud metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("serviceEndpoints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IBMCloudServiceEndpoint> getServiceEndpoints() {
         return serviceEndpoints;
     }
 
+    /**
+     * Metadata contains IBM Cloud metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("serviceEndpoints")
     public void setServiceEndpoints(List<IBMCloudServiceEndpoint> serviceEndpoints) {
         this.serviceEndpoints = serviceEndpoints;
     }
 
+    /**
+     * Metadata contains IBM Cloud metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("subnets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSubnets() {
         return subnets;
     }
 
+    /**
+     * Metadata contains IBM Cloud metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("subnets")
     public void setSubnets(List<String> subnets) {
         this.subnets = subnets;
     }
 
+    /**
+     * Metadata contains IBM Cloud metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("vpc")
     public String getVpc() {
         return vpc;
     }
 
+    /**
+     * Metadata contains IBM Cloud metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("vpc")
     public void setVpc(String vpc) {
         this.vpc = vpc;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ibmcloud/v1/Platform.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ibmcloud/v1/Platform.java
index 6e5cd0007eb..7121ef254f2 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ibmcloud/v1/Platform.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ibmcloud/v1/Platform.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Platform stores all the global configuration that all machinesets use.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -112,84 +115,132 @@ public Platform(List<String> computeSubnets, List<String> controlPlaneSubnets, M
         this.vpcName = vpcName;
     }
 
+    /**
+     * ComputeSubnets are the names of already existing subnets where the cluster compute nodes should be created.
+     */
     @JsonProperty("computeSubnets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getComputeSubnets() {
         return computeSubnets;
     }
 
+    /**
+     * ComputeSubnets are the names of already existing subnets where the cluster compute nodes should be created.
+     */
     @JsonProperty("computeSubnets")
     public void setComputeSubnets(List<String> computeSubnets) {
         this.computeSubnets = computeSubnets;
     }
 
+    /**
+     * ControlPlaneSubnets are the names of already existing subnets where the cluster control plane nodes should be created.
+     */
     @JsonProperty("controlPlaneSubnets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getControlPlaneSubnets() {
         return controlPlaneSubnets;
     }
 
+    /**
+     * ControlPlaneSubnets are the names of already existing subnets where the cluster control plane nodes should be created.
+     */
     @JsonProperty("controlPlaneSubnets")
     public void setControlPlaneSubnets(List<String> controlPlaneSubnets) {
         this.controlPlaneSubnets = controlPlaneSubnets;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("defaultMachinePlatform")
     public MachinePool getDefaultMachinePlatform() {
         return defaultMachinePlatform;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("defaultMachinePlatform")
     public void setDefaultMachinePlatform(MachinePool defaultMachinePlatform) {
         this.defaultMachinePlatform = defaultMachinePlatform;
     }
 
+    /**
+     * NetworkResourceGroupName is the name of an already existing resource group where an existing VPC and set of Subnets exist, to be used during cluster creation.
+     */
     @JsonProperty("networkResourceGroupName")
     public String getNetworkResourceGroupName() {
         return networkResourceGroupName;
     }
 
+    /**
+     * NetworkResourceGroupName is the name of an already existing resource group where an existing VPC and set of Subnets exist, to be used during cluster creation.
+     */
     @JsonProperty("networkResourceGroupName")
     public void setNetworkResourceGroupName(String networkResourceGroupName) {
         this.networkResourceGroupName = networkResourceGroupName;
     }
 
+    /**
+     * Region specifies the IBM Cloud region where the cluster will be created.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Region specifies the IBM Cloud region where the cluster will be created.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * ResourceGroupName is the name of an already existing resource group where the cluster should be installed. If empty, a new resource group will be created for the cluster.
+     */
     @JsonProperty("resourceGroupName")
     public String getResourceGroupName() {
         return resourceGroupName;
     }
 
+    /**
+     * ResourceGroupName is the name of an already existing resource group where the cluster should be installed. If empty, a new resource group will be created for the cluster.
+     */
     @JsonProperty("resourceGroupName")
     public void setResourceGroupName(String resourceGroupName) {
         this.resourceGroupName = resourceGroupName;
     }
 
+    /**
+     * ServiceEndpoints is a list which contains custom endpoints to override default service endpoints of IBM Cloud Services. There must only be one ServiceEndpoint for a service (no duplicates).
+     */
     @JsonProperty("serviceEndpoints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IBMCloudServiceEndpoint> getServiceEndpoints() {
         return serviceEndpoints;
     }
 
+    /**
+     * ServiceEndpoints is a list which contains custom endpoints to override default service endpoints of IBM Cloud Services. There must only be one ServiceEndpoint for a service (no duplicates).
+     */
     @JsonProperty("serviceEndpoints")
     public void setServiceEndpoints(List<IBMCloudServiceEndpoint> serviceEndpoints) {
         this.serviceEndpoints = serviceEndpoints;
     }
 
+    /**
+     * VPCName is the name of an already existing VPC to be used during cluster creation.
+     */
     @JsonProperty("vpcName")
     public String getVpcName() {
         return vpcName;
     }
 
+    /**
+     * VPCName is the name of an already existing VPC to be used during cluster creation.
+     */
     @JsonProperty("vpcName")
     public void setVpcName(String vpcName) {
         this.vpcName = vpcName;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/none/v1/Platform.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/none/v1/Platform.java
index 42e593db8c1..a3e464feeba 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/none/v1/Platform.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/none/v1/Platform.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Platform stores any global configuration used for generic platforms.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/DataDisk.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/DataDisk.java
index a32031cfbca..c9f5c6f844a 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/DataDisk.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/DataDisk.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DataDisk defines a data disk for a Machine VM.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -92,41 +95,65 @@ public DataDisk(StorageResourceReference dataSourceImage, NutanixVMDiskDevicePro
         this.storageConfig = storageConfig;
     }
 
+    /**
+     * DataDisk defines a data disk for a Machine VM.
+     */
     @JsonProperty("dataSourceImage")
     public StorageResourceReference getDataSourceImage() {
         return dataSourceImage;
     }
 
+    /**
+     * DataDisk defines a data disk for a Machine VM.
+     */
     @JsonProperty("dataSourceImage")
     public void setDataSourceImage(StorageResourceReference dataSourceImage) {
         this.dataSourceImage = dataSourceImage;
     }
 
+    /**
+     * DataDisk defines a data disk for a Machine VM.
+     */
     @JsonProperty("deviceProperties")
     public NutanixVMDiskDeviceProperties getDeviceProperties() {
         return deviceProperties;
     }
 
+    /**
+     * DataDisk defines a data disk for a Machine VM.
+     */
     @JsonProperty("deviceProperties")
     public void setDeviceProperties(NutanixVMDiskDeviceProperties deviceProperties) {
         this.deviceProperties = deviceProperties;
     }
 
+    /**
+     * DataDisk defines a data disk for a Machine VM.
+     */
     @JsonProperty("diskSize")
     public Quantity getDiskSize() {
         return diskSize;
     }
 
+    /**
+     * DataDisk defines a data disk for a Machine VM.
+     */
     @JsonProperty("diskSize")
     public void setDiskSize(Quantity diskSize) {
         this.diskSize = diskSize;
     }
 
+    /**
+     * DataDisk defines a data disk for a Machine VM.
+     */
     @JsonProperty("storageConfig")
     public StorageConfig getStorageConfig() {
         return storageConfig;
     }
 
+    /**
+     * DataDisk defines a data disk for a Machine VM.
+     */
     @JsonProperty("storageConfig")
     public void setStorageConfig(StorageConfig storageConfig) {
         this.storageConfig = storageConfig;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/FailureDomain.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/FailureDomain.java
index 8c029a885c5..1fa4d418038 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/FailureDomain.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/FailureDomain.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FailureDomain configures failure domain information for the Nutanix platform.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -99,54 +102,84 @@ public FailureDomain(List<StorageResourceReference> dataSourceImages, String nam
         this.subnetUUIDs = subnetUUIDs;
     }
 
+    /**
+     * DataSourceImages identifies the datasource images in the Prism Element.
+     */
     @JsonProperty("dataSourceImages")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<StorageResourceReference> getDataSourceImages() {
         return dataSourceImages;
     }
 
+    /**
+     * DataSourceImages identifies the datasource images in the Prism Element.
+     */
     @JsonProperty("dataSourceImages")
     public void setDataSourceImages(List<StorageResourceReference> dataSourceImages) {
         this.dataSourceImages = dataSourceImages;
     }
 
+    /**
+     * Name defines the unique name of a failure domain.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name defines the unique name of a failure domain.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * FailureDomain configures failure domain information for the Nutanix platform.
+     */
     @JsonProperty("prismElement")
     public PrismElement getPrismElement() {
         return prismElement;
     }
 
+    /**
+     * FailureDomain configures failure domain information for the Nutanix platform.
+     */
     @JsonProperty("prismElement")
     public void setPrismElement(PrismElement prismElement) {
         this.prismElement = prismElement;
     }
 
+    /**
+     * StorageContainers identifies the storage containers in the Prism Element.
+     */
     @JsonProperty("storageContainers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<StorageResourceReference> getStorageContainers() {
         return storageContainers;
     }
 
+    /**
+     * StorageContainers identifies the storage containers in the Prism Element.
+     */
     @JsonProperty("storageContainers")
     public void setStorageContainers(List<StorageResourceReference> storageContainers) {
         this.storageContainers = storageContainers;
     }
 
+    /**
+     * SubnetUUIDs identifies the network subnets of the Prism Element. Currently we only support one subnet for a failure domain.
+     */
     @JsonProperty("subnetUUIDs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSubnetUUIDs() {
         return subnetUUIDs;
     }
 
+    /**
+     * SubnetUUIDs identifies the network subnets of the Prism Element. Currently we only support one subnet for a failure domain.
+     */
     @JsonProperty("subnetUUIDs")
     public void setSubnetUUIDs(List<String> subnetUUIDs) {
         this.subnetUUIDs = subnetUUIDs;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/MachinePool.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/MachinePool.java
index 48a285e063a..9a1d50f7fa2 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/MachinePool.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/MachinePool.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePool stores the configuration for a machine pool installed on Nutanix.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -123,105 +126,165 @@ public MachinePool(String bootType, List<NutanixCategory> categories, Long cores
         this.project = project;
     }
 
+    /**
+     * BootType indicates the boot type (Legacy, UEFI or SecureBoot) the Machine's VM uses to boot. If this field is empty or omitted, the VM will use the default boot type "Legacy" to boot. "SecureBoot" depends on "UEFI" boot, i.e., enabling "SecureBoot" means that "UEFI" boot is also enabled.
+     */
     @JsonProperty("bootType")
     public String getBootType() {
         return bootType;
     }
 
+    /**
+     * BootType indicates the boot type (Legacy, UEFI or SecureBoot) the Machine's VM uses to boot. If this field is empty or omitted, the VM will use the default boot type "Legacy" to boot. "SecureBoot" depends on "UEFI" boot, i.e., enabling "SecureBoot" means that "UEFI" boot is also enabled.
+     */
     @JsonProperty("bootType")
     public void setBootType(String bootType) {
         this.bootType = bootType;
     }
 
+    /**
+     * Categories optionally adds one or more prism categories (each with key and value) for the Machine's VM to associate with. All the category key and value pairs specified must already exist in the prism central.
+     */
     @JsonProperty("categories")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NutanixCategory> getCategories() {
         return categories;
     }
 
+    /**
+     * Categories optionally adds one or more prism categories (each with key and value) for the Machine's VM to associate with. All the category key and value pairs specified must already exist in the prism central.
+     */
     @JsonProperty("categories")
     public void setCategories(List<NutanixCategory> categories) {
         this.categories = categories;
     }
 
+    /**
+     * NumCoresPerSocket is the number of cores per socket in a vm. The number of vCPUs on the vm will be NumCPUs times NumCoresPerSocket. For example: 4 CPUs and 4 Cores per socket will result in 16 VPUs. The AHV scheduler treats socket and core allocation exactly the same so there is no benefit to configuring cores over CPUs.
+     */
     @JsonProperty("coresPerSocket")
     public Long getCoresPerSocket() {
         return coresPerSocket;
     }
 
+    /**
+     * NumCoresPerSocket is the number of cores per socket in a vm. The number of vCPUs on the vm will be NumCPUs times NumCoresPerSocket. For example: 4 CPUs and 4 Cores per socket will result in 16 VPUs. The AHV scheduler treats socket and core allocation exactly the same so there is no benefit to configuring cores over CPUs.
+     */
     @JsonProperty("coresPerSocket")
     public void setCoresPerSocket(Long coresPerSocket) {
         this.coresPerSocket = coresPerSocket;
     }
 
+    /**
+     * NumCPUs is the total number of virtual processor cores to assign a vm.
+     */
     @JsonProperty("cpus")
     public Long getCpus() {
         return cpus;
     }
 
+    /**
+     * NumCPUs is the total number of virtual processor cores to assign a vm.
+     */
     @JsonProperty("cpus")
     public void setCpus(Long cpus) {
         this.cpus = cpus;
     }
 
+    /**
+     * DataDisks holds information of the data disks to attach to the Machine's VM
+     */
     @JsonProperty("dataDisks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DataDisk> getDataDisks() {
         return dataDisks;
     }
 
+    /**
+     * DataDisks holds information of the data disks to attach to the Machine's VM
+     */
     @JsonProperty("dataDisks")
     public void setDataDisks(List<DataDisk> dataDisks) {
         this.dataDisks = dataDisks;
     }
 
+    /**
+     * FailureDomains optionally configures a list of failure domain names that will be applied to the MachinePool
+     */
     @JsonProperty("failureDomains")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getFailureDomains() {
         return failureDomains;
     }
 
+    /**
+     * FailureDomains optionally configures a list of failure domain names that will be applied to the MachinePool
+     */
     @JsonProperty("failureDomains")
     public void setFailureDomains(List<String> failureDomains) {
         this.failureDomains = failureDomains;
     }
 
+    /**
+     * GPUs is a list of GPU devices to attach to the machine's VM.
+     */
     @JsonProperty("gpus")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NutanixGPU> getGpus() {
         return gpus;
     }
 
+    /**
+     * GPUs is a list of GPU devices to attach to the machine's VM.
+     */
     @JsonProperty("gpus")
     public void setGpus(List<NutanixGPU> gpus) {
         this.gpus = gpus;
     }
 
+    /**
+     * Memory is the size of a VM's memory in MiB.
+     */
     @JsonProperty("memoryMiB")
     public Long getMemoryMiB() {
         return memoryMiB;
     }
 
+    /**
+     * Memory is the size of a VM's memory in MiB.
+     */
     @JsonProperty("memoryMiB")
     public void setMemoryMiB(Long memoryMiB) {
         this.memoryMiB = memoryMiB;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on Nutanix.
+     */
     @JsonProperty("osDisk")
     public OSDisk getOsDisk() {
         return osDisk;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on Nutanix.
+     */
     @JsonProperty("osDisk")
     public void setOsDisk(OSDisk osDisk) {
         this.osDisk = osDisk;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on Nutanix.
+     */
     @JsonProperty("project")
     public NutanixResourceIdentifier getProject() {
         return project;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on Nutanix.
+     */
     @JsonProperty("project")
     public void setProject(NutanixResourceIdentifier project) {
         this.project = project;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/Metadata.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/Metadata.java
index 6ad94d6e07f..bac9a213334 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/Metadata.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/Metadata.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metadata contains Nutanix metadata (e.g. for uninstalling the cluster).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public Metadata(String password, String port, String prismCentral, String userna
         this.username = username;
     }
 
+    /**
+     * Password is the password for the user to use to connect to the Prism Central.
+     */
     @JsonProperty("password")
     public String getPassword() {
         return password;
     }
 
+    /**
+     * Password is the password for the user to use to connect to the Prism Central.
+     */
     @JsonProperty("password")
     public void setPassword(String password) {
         this.password = password;
     }
 
+    /**
+     * Port is the port used to connect to the Prism Central.
+     */
     @JsonProperty("port")
     public String getPort() {
         return port;
     }
 
+    /**
+     * Port is the port used to connect to the Prism Central.
+     */
     @JsonProperty("port")
     public void setPort(String port) {
         this.port = port;
     }
 
+    /**
+     * PrismCentral is the domain name or IP address of the Prism Central.
+     */
     @JsonProperty("prismCentral")
     public String getPrismCentral() {
         return prismCentral;
     }
 
+    /**
+     * PrismCentral is the domain name or IP address of the Prism Central.
+     */
     @JsonProperty("prismCentral")
     public void setPrismCentral(String prismCentral) {
         this.prismCentral = prismCentral;
     }
 
+    /**
+     * Username is the name of the user to use to connect to the Prism Central.
+     */
     @JsonProperty("username")
     public String getUsername() {
         return username;
     }
 
+    /**
+     * Username is the name of the user to use to connect to the Prism Central.
+     */
     @JsonProperty("username")
     public void setUsername(String username) {
         this.username = username;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/OSDisk.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/OSDisk.java
index 2cefcf09616..312dccecaa3 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/OSDisk.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/OSDisk.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OSDisk defines the system disk for a Machine VM.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public OSDisk(Long diskSizeGiB) {
         this.diskSizeGiB = diskSizeGiB;
     }
 
+    /**
+     * DiskSizeGiB defines the size of disk in GiB.
+     */
     @JsonProperty("diskSizeGiB")
     public Long getDiskSizeGiB() {
         return diskSizeGiB;
     }
 
+    /**
+     * DiskSizeGiB defines the size of disk in GiB.
+     */
     @JsonProperty("diskSizeGiB")
     public void setDiskSizeGiB(Long diskSizeGiB) {
         this.diskSizeGiB = diskSizeGiB;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/Platform.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/Platform.java
index 8507b33f67c..159ffc21e49 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/Platform.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/Platform.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Platform stores any global configuration used for Nutanix platforms.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -126,116 +129,182 @@ public Platform(String apiVIP, List<String> apiVIPs, String clusterOSImage, Mach
         this.subnetUUIDs = subnetUUIDs;
     }
 
+    /**
+     * DeprecatedAPIVIP is the virtual IP address for the api endpoint Deprecated: use APIVIPs
+     */
     @JsonProperty("apiVIP")
     public String getApiVIP() {
         return apiVIP;
     }
 
+    /**
+     * DeprecatedAPIVIP is the virtual IP address for the api endpoint Deprecated: use APIVIPs
+     */
     @JsonProperty("apiVIP")
     public void setApiVIP(String apiVIP) {
         this.apiVIP = apiVIP;
     }
 
+    /**
+     * APIVIPs contains the VIP(s) for the api endpoint. In dual stack clusters it contains an IPv4 and IPv6 address, otherwise only one VIP
+     */
     @JsonProperty("apiVIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiVIPs() {
         return apiVIPs;
     }
 
+    /**
+     * APIVIPs contains the VIP(s) for the api endpoint. In dual stack clusters it contains an IPv4 and IPv6 address, otherwise only one VIP
+     */
     @JsonProperty("apiVIPs")
     public void setApiVIPs(List<String> apiVIPs) {
         this.apiVIPs = apiVIPs;
     }
 
+    /**
+     * ClusterOSImage overrides the url provided in rhcos.json to download the RHCOS Image.
+     */
     @JsonProperty("clusterOSImage")
     public String getClusterOSImage() {
         return clusterOSImage;
     }
 
+    /**
+     * ClusterOSImage overrides the url provided in rhcos.json to download the RHCOS Image.
+     */
     @JsonProperty("clusterOSImage")
     public void setClusterOSImage(String clusterOSImage) {
         this.clusterOSImage = clusterOSImage;
     }
 
+    /**
+     * Platform stores any global configuration used for Nutanix platforms.
+     */
     @JsonProperty("defaultMachinePlatform")
     public MachinePool getDefaultMachinePlatform() {
         return defaultMachinePlatform;
     }
 
+    /**
+     * Platform stores any global configuration used for Nutanix platforms.
+     */
     @JsonProperty("defaultMachinePlatform")
     public void setDefaultMachinePlatform(MachinePool defaultMachinePlatform) {
         this.defaultMachinePlatform = defaultMachinePlatform;
     }
 
+    /**
+     * FailureDomains configures failure domains for the Nutanix platform.
+     */
     @JsonProperty("failureDomains")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<FailureDomain> getFailureDomains() {
         return failureDomains;
     }
 
+    /**
+     * FailureDomains configures failure domains for the Nutanix platform.
+     */
     @JsonProperty("failureDomains")
     public void setFailureDomains(List<FailureDomain> failureDomains) {
         this.failureDomains = failureDomains;
     }
 
+    /**
+     * DeprecatedIngressVIP is the virtual IP address for ingress Deprecated: use IngressVIPs
+     */
     @JsonProperty("ingressVIP")
     public String getIngressVIP() {
         return ingressVIP;
     }
 
+    /**
+     * DeprecatedIngressVIP is the virtual IP address for ingress Deprecated: use IngressVIPs
+     */
     @JsonProperty("ingressVIP")
     public void setIngressVIP(String ingressVIP) {
         this.ingressVIP = ingressVIP;
     }
 
+    /**
+     * IngressVIPs contains the VIP(s) for ingress. In dual stack clusters it contains an IPv4 and IPv6 address, otherwise only one VIP
+     */
     @JsonProperty("ingressVIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIngressVIPs() {
         return ingressVIPs;
     }
 
+    /**
+     * IngressVIPs contains the VIP(s) for ingress. In dual stack clusters it contains an IPv4 and IPv6 address, otherwise only one VIP
+     */
     @JsonProperty("ingressVIPs")
     public void setIngressVIPs(List<String> ingressVIPs) {
         this.ingressVIPs = ingressVIPs;
     }
 
+    /**
+     * Platform stores any global configuration used for Nutanix platforms.
+     */
     @JsonProperty("loadBalancer")
     public NutanixPlatformLoadBalancer getLoadBalancer() {
         return loadBalancer;
     }
 
+    /**
+     * Platform stores any global configuration used for Nutanix platforms.
+     */
     @JsonProperty("loadBalancer")
     public void setLoadBalancer(NutanixPlatformLoadBalancer loadBalancer) {
         this.loadBalancer = loadBalancer;
     }
 
+    /**
+     * Platform stores any global configuration used for Nutanix platforms.
+     */
     @JsonProperty("prismCentral")
     public PrismCentral getPrismCentral() {
         return prismCentral;
     }
 
+    /**
+     * Platform stores any global configuration used for Nutanix platforms.
+     */
     @JsonProperty("prismCentral")
     public void setPrismCentral(PrismCentral prismCentral) {
         this.prismCentral = prismCentral;
     }
 
+    /**
+     * PrismElements holds a list of Prism Elements (clusters). A Prism Element encompasses all Nutanix resources (VMs, subnets, etc.) used to host the OpenShift cluster. Currently only a single Prism Element may be defined. This serves as the default Prism-Element.
+     */
     @JsonProperty("prismElements")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PrismElement> getPrismElements() {
         return prismElements;
     }
 
+    /**
+     * PrismElements holds a list of Prism Elements (clusters). A Prism Element encompasses all Nutanix resources (VMs, subnets, etc.) used to host the OpenShift cluster. Currently only a single Prism Element may be defined. This serves as the default Prism-Element.
+     */
     @JsonProperty("prismElements")
     public void setPrismElements(List<PrismElement> prismElements) {
         this.prismElements = prismElements;
     }
 
+    /**
+     * SubnetUUIDs identifies the network subnets to be used by the cluster. Currently we only support one subnet for an OpenShift cluster.
+     */
     @JsonProperty("subnetUUIDs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSubnetUUIDs() {
         return subnetUUIDs;
     }
 
+    /**
+     * SubnetUUIDs identifies the network subnets to be used by the cluster. Currently we only support one subnet for an OpenShift cluster.
+     */
     @JsonProperty("subnetUUIDs")
     public void setSubnetUUIDs(List<String> subnetUUIDs) {
         this.subnetUUIDs = subnetUUIDs;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/PrismCentral.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/PrismCentral.java
index 2d3a8713be4..0c446e97065 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/PrismCentral.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/PrismCentral.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PrismCentral holds the endpoint and credentials data used to connect to the Prism Central
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public PrismCentral(PrismEndpoint endpoint, String password, String username) {
         this.username = username;
     }
 
+    /**
+     * PrismCentral holds the endpoint and credentials data used to connect to the Prism Central
+     */
     @JsonProperty("endpoint")
     public PrismEndpoint getEndpoint() {
         return endpoint;
     }
 
+    /**
+     * PrismCentral holds the endpoint and credentials data used to connect to the Prism Central
+     */
     @JsonProperty("endpoint")
     public void setEndpoint(PrismEndpoint endpoint) {
         this.endpoint = endpoint;
     }
 
+    /**
+     * Password is the password for the user to connect to the Prism Central
+     */
     @JsonProperty("password")
     public String getPassword() {
         return password;
     }
 
+    /**
+     * Password is the password for the user to connect to the Prism Central
+     */
     @JsonProperty("password")
     public void setPassword(String password) {
         this.password = password;
     }
 
+    /**
+     * Username is the name of the user to connect to the Prism Central
+     */
     @JsonProperty("username")
     public String getUsername() {
         return username;
     }
 
+    /**
+     * Username is the name of the user to connect to the Prism Central
+     */
     @JsonProperty("username")
     public void setUsername(String username) {
         this.username = username;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/PrismElement.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/PrismElement.java
index 97da646f571..19601fa9972 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/PrismElement.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/PrismElement.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PrismElement holds the uuid, endpoint of the Prism Element (cluster)
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public PrismElement(PrismEndpoint endpoint, String name, String uuid) {
         this.uuid = uuid;
     }
 
+    /**
+     * PrismElement holds the uuid, endpoint of the Prism Element (cluster)
+     */
     @JsonProperty("endpoint")
     public PrismEndpoint getEndpoint() {
         return endpoint;
     }
 
+    /**
+     * PrismElement holds the uuid, endpoint of the Prism Element (cluster)
+     */
     @JsonProperty("endpoint")
     public void setEndpoint(PrismEndpoint endpoint) {
         this.endpoint = endpoint;
     }
 
+    /**
+     * Name is prism endpoint Name
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is prism endpoint Name
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * UUID is the UUID of the Prism Element (cluster)
+     */
     @JsonProperty("uuid")
     public String getUuid() {
         return uuid;
     }
 
+    /**
+     * UUID is the UUID of the Prism Element (cluster)
+     */
     @JsonProperty("uuid")
     public void setUuid(String uuid) {
         this.uuid = uuid;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/PrismEndpoint.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/PrismEndpoint.java
index ef902b69fff..efd0c7fcc68 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/PrismEndpoint.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/PrismEndpoint.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PrismEndpoint holds the endpoint address and port to access the Nutanix Prism Central or Element (cluster)
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PrismEndpoint(String address, Integer port) {
         this.port = port;
     }
 
+    /**
+     * address is the endpoint address (DNS name or IP address) of the Nutanix Prism Central or Element (cluster)
+     */
     @JsonProperty("address")
     public String getAddress() {
         return address;
     }
 
+    /**
+     * address is the endpoint address (DNS name or IP address) of the Nutanix Prism Central or Element (cluster)
+     */
     @JsonProperty("address")
     public void setAddress(String address) {
         this.address = address;
     }
 
+    /**
+     * port is the port number to access the Nutanix Prism Central or Element (cluster)
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * port is the port number to access the Nutanix Prism Central or Element (cluster)
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/StorageConfig.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/StorageConfig.java
index 9790b1e8bb5..7d7a909bc89 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/StorageConfig.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/StorageConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StorageConfig specifies the storage configuration parameters for VM disks.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public StorageConfig(String diskMode, StorageResourceReference storageContainer)
         this.storageContainer = storageContainer;
     }
 
+    /**
+     * diskMode specifies the disk mode. The valid values are Standard and Flash, and the default is Standard.
+     */
     @JsonProperty("diskMode")
     public String getDiskMode() {
         return diskMode;
     }
 
+    /**
+     * diskMode specifies the disk mode. The valid values are Standard and Flash, and the default is Standard.
+     */
     @JsonProperty("diskMode")
     public void setDiskMode(String diskMode) {
         this.diskMode = diskMode;
     }
 
+    /**
+     * StorageConfig specifies the storage configuration parameters for VM disks.
+     */
     @JsonProperty("storageContainer")
     public StorageResourceReference getStorageContainer() {
         return storageContainer;
     }
 
+    /**
+     * StorageConfig specifies the storage configuration parameters for VM disks.
+     */
     @JsonProperty("storageContainer")
     public void setStorageContainer(StorageResourceReference storageContainer) {
         this.storageContainer = storageContainer;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/StorageResourceReference.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/StorageResourceReference.java
index 3e7079c2de6..c138941247f 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/StorageResourceReference.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/nutanix/v1/StorageResourceReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StorageResourceReference holds reference information of a storage resource (storage container, data source image, etc.)
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public StorageResourceReference(String name, String referenceName, String uuid)
         this.uuid = uuid;
     }
 
+    /**
+     * Name is the name of the storage container resource in the Prism Element.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the storage container resource in the Prism Element.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * ReferenceName is the identifier of the storage resource configured in the FailureDomain.
+     */
     @JsonProperty("referenceName")
     public String getReferenceName() {
         return referenceName;
     }
 
+    /**
+     * ReferenceName is the identifier of the storage resource configured in the FailureDomain.
+     */
     @JsonProperty("referenceName")
     public void setReferenceName(String referenceName) {
         this.referenceName = referenceName;
     }
 
+    /**
+     * UUID is the UUID of the storage container resource in the Prism Element.
+     */
     @JsonProperty("uuid")
     public String getUuid() {
         return uuid;
     }
 
+    /**
+     * UUID is the UUID of the storage container resource in the Prism Element.
+     */
     @JsonProperty("uuid")
     public void setUuid(String uuid) {
         this.uuid = uuid;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/FixedIP.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/FixedIP.java
index 94f3441cd79..7f9b8966040 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/FixedIP.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/FixedIP.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FixedIP identifies a subnet defined by a subnet filter.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public FixedIP(SubnetFilter subnet) {
         this.subnet = subnet;
     }
 
+    /**
+     * FixedIP identifies a subnet defined by a subnet filter.
+     */
     @JsonProperty("subnet")
     public SubnetFilter getSubnet() {
         return subnet;
     }
 
+    /**
+     * FixedIP identifies a subnet defined by a subnet filter.
+     */
     @JsonProperty("subnet")
     public void setSubnet(SubnetFilter subnet) {
         this.subnet = subnet;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/MachinePool.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/MachinePool.java
index f9f7127e563..e409c40649d 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/MachinePool.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/MachinePool.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePool stores the configuration for a machine pool installed on OpenStack.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -103,64 +106,100 @@ public MachinePool(List<String> additionalNetworkIDs, List<String> additionalSec
         this.zones = zones;
     }
 
+    /**
+     * AdditionalNetworkIDs contains IDs of additional networks for machines, where each ID is presented in UUID v4 format. Allowed address pairs won't be created for the additional networks.
+     */
     @JsonProperty("additionalNetworkIDs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAdditionalNetworkIDs() {
         return additionalNetworkIDs;
     }
 
+    /**
+     * AdditionalNetworkIDs contains IDs of additional networks for machines, where each ID is presented in UUID v4 format. Allowed address pairs won't be created for the additional networks.
+     */
     @JsonProperty("additionalNetworkIDs")
     public void setAdditionalNetworkIDs(List<String> additionalNetworkIDs) {
         this.additionalNetworkIDs = additionalNetworkIDs;
     }
 
+    /**
+     * AdditionalSecurityGroupIDs contains IDs of additional security groups for machines, where each ID is presented in UUID v4 format.
+     */
     @JsonProperty("additionalSecurityGroupIDs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAdditionalSecurityGroupIDs() {
         return additionalSecurityGroupIDs;
     }
 
+    /**
+     * AdditionalSecurityGroupIDs contains IDs of additional security groups for machines, where each ID is presented in UUID v4 format.
+     */
     @JsonProperty("additionalSecurityGroupIDs")
     public void setAdditionalSecurityGroupIDs(List<String> additionalSecurityGroupIDs) {
         this.additionalSecurityGroupIDs = additionalSecurityGroupIDs;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on OpenStack.
+     */
     @JsonProperty("rootVolume")
     public RootVolume getRootVolume() {
         return rootVolume;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on OpenStack.
+     */
     @JsonProperty("rootVolume")
     public void setRootVolume(RootVolume rootVolume) {
         this.rootVolume = rootVolume;
     }
 
+    /**
+     * ServerGroupPolicy will be used to create the Server Group that will contain all the machines of this MachinePool. Defaults to "soft-anti-affinity".
+     */
     @JsonProperty("serverGroupPolicy")
     public String getServerGroupPolicy() {
         return serverGroupPolicy;
     }
 
+    /**
+     * ServerGroupPolicy will be used to create the Server Group that will contain all the machines of this MachinePool. Defaults to "soft-anti-affinity".
+     */
     @JsonProperty("serverGroupPolicy")
     public void setServerGroupPolicy(String serverGroupPolicy) {
         this.serverGroupPolicy = serverGroupPolicy;
     }
 
+    /**
+     * FlavorName defines the OpenStack Nova flavor. eg. m1.large
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * FlavorName defines the OpenStack Nova flavor. eg. m1.large
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * Zones is the list of availability zones where the instances should be deployed. If no zones are provided, all instances will be deployed on OpenStack Nova default availability zone
+     */
     @JsonProperty("zones")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getZones() {
         return zones;
     }
 
+    /**
+     * Zones is the list of availability zones where the instances should be deployed. If no zones are provided, all instances will be deployed on OpenStack Nova default availability zone
+     */
     @JsonProperty("zones")
     public void setZones(List<String> zones) {
         this.zones = zones;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/Metadata.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/Metadata.java
index d7fa63f8336..0b5543fa694 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/Metadata.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/Metadata.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metadata contains OpenStack metadata (e.g. for uninstalling the cluster).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,22 +86,34 @@ public Metadata(String cloud, Map<String, String> identifier) {
         this.identifier = identifier;
     }
 
+    /**
+     * Metadata contains OpenStack metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("cloud")
     public String getCloud() {
         return cloud;
     }
 
+    /**
+     * Metadata contains OpenStack metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("cloud")
     public void setCloud(String cloud) {
         this.cloud = cloud;
     }
 
+    /**
+     * Most OpenStack resources are tagged with these tags as identifier.
+     */
     @JsonProperty("identifier")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getIdentifier() {
         return identifier;
     }
 
+    /**
+     * Most OpenStack resources are tagged with these tags as identifier.
+     */
     @JsonProperty("identifier")
     public void setIdentifier(Map<String, String> identifier) {
         this.identifier = identifier;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/NetworkFilter.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/NetworkFilter.java
index 9b5ff649693..7c42a29fa7d 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/NetworkFilter.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/NetworkFilter.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkFilter defines a network by name and/or ID.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public NetworkFilter(String id, String name) {
         this.name = name;
     }
 
+    /**
+     * NetworkFilter defines a network by name and/or ID.
+     */
     @JsonProperty("id")
     public String getId() {
         return id;
     }
 
+    /**
+     * NetworkFilter defines a network by name and/or ID.
+     */
     @JsonProperty("id")
     public void setId(String id) {
         this.id = id;
     }
 
+    /**
+     * NetworkFilter defines a network by name and/or ID.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * NetworkFilter defines a network by name and/or ID.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/Platform.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/Platform.java
index f96944426b7..6f9c417d947 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/Platform.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/Platform.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Platform stores all the global configuration that all machinesets use.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -161,205 +164,325 @@ public Platform(String apiFloatingIP, String apiVIP, List<String> apiVIPs, Strin
         this.trunkSupport = trunkSupport;
     }
 
+    /**
+     * APIFloatingIP is the IP address of an available floating IP in your OpenStack cluster to associate with the OpenShift API load balancer.
+     */
     @JsonProperty("apiFloatingIP")
     public String getApiFloatingIP() {
         return apiFloatingIP;
     }
 
+    /**
+     * APIFloatingIP is the IP address of an available floating IP in your OpenStack cluster to associate with the OpenShift API load balancer.
+     */
     @JsonProperty("apiFloatingIP")
     public void setApiFloatingIP(String apiFloatingIP) {
         this.apiFloatingIP = apiFloatingIP;
     }
 
+    /**
+     * DeprecatedAPIVIP is the static IP on the nodes subnet that the api port for openshift will be assigned Default: will be set to the 5 on the first entry in the machineNetwork CIDR Deprecated: Use APIVIPs
+     */
     @JsonProperty("apiVIP")
     public String getApiVIP() {
         return apiVIP;
     }
 
+    /**
+     * DeprecatedAPIVIP is the static IP on the nodes subnet that the api port for openshift will be assigned Default: will be set to the 5 on the first entry in the machineNetwork CIDR Deprecated: Use APIVIPs
+     */
     @JsonProperty("apiVIP")
     public void setApiVIP(String apiVIP) {
         this.apiVIP = apiVIP;
     }
 
+    /**
+     * APIVIPs contains the VIP(s) on the nodes subnet that the api port for openshift will be assigned. In dual stack clusters it contains an IPv4 and IPv6 address, otherwise only one VIP Default: will be set to the 5 on the first entry in the machineNetwork CIDR
+     */
     @JsonProperty("apiVIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiVIPs() {
         return apiVIPs;
     }
 
+    /**
+     * APIVIPs contains the VIP(s) on the nodes subnet that the api port for openshift will be assigned. In dual stack clusters it contains an IPv4 and IPv6 address, otherwise only one VIP Default: will be set to the 5 on the first entry in the machineNetwork CIDR
+     */
     @JsonProperty("apiVIPs")
     public void setApiVIPs(List<String> apiVIPs) {
         this.apiVIPs = apiVIPs;
     }
 
+    /**
+     * Cloud is the name of OpenStack cloud to use from clouds.yaml.
+     */
     @JsonProperty("cloud")
     public String getCloud() {
         return cloud;
     }
 
+    /**
+     * Cloud is the name of OpenStack cloud to use from clouds.yaml.
+     */
     @JsonProperty("cloud")
     public void setCloud(String cloud) {
         this.cloud = cloud;
     }
 
+    /**
+     * ClusterOSImage is either a URL with `http(s)` or `file` scheme to override the default OS image for cluster nodes, or an existing Glance image name.
+     */
     @JsonProperty("clusterOSImage")
     public String getClusterOSImage() {
         return clusterOSImage;
     }
 
+    /**
+     * ClusterOSImage is either a URL with `http(s)` or `file` scheme to override the default OS image for cluster nodes, or an existing Glance image name.
+     */
     @JsonProperty("clusterOSImage")
     public void setClusterOSImage(String clusterOSImage) {
         this.clusterOSImage = clusterOSImage;
     }
 
+    /**
+     * ClusterOSImageProperties is a list of properties to be added to the metadata of the uploaded Glance ClusterOSImage. Default: the default is to not set any properties.
+     */
     @JsonProperty("clusterOSImageProperties")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getClusterOSImageProperties() {
         return clusterOSImageProperties;
     }
 
+    /**
+     * ClusterOSImageProperties is a list of properties to be added to the metadata of the uploaded Glance ClusterOSImage. Default: the default is to not set any properties.
+     */
     @JsonProperty("clusterOSImageProperties")
     public void setClusterOSImageProperties(Map<String, String> clusterOSImageProperties) {
         this.clusterOSImageProperties = clusterOSImageProperties;
     }
 
+    /**
+     * DeprecatedFlavorName is the name of the flavor to use for instances in this cluster. Deprecated: use FlavorName in DefaultMachinePlatform to define default flavor.
+     */
     @JsonProperty("computeFlavor")
     public String getComputeFlavor() {
         return computeFlavor;
     }
 
+    /**
+     * DeprecatedFlavorName is the name of the flavor to use for instances in this cluster. Deprecated: use FlavorName in DefaultMachinePlatform to define default flavor.
+     */
     @JsonProperty("computeFlavor")
     public void setComputeFlavor(String computeFlavor) {
         this.computeFlavor = computeFlavor;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("controlPlanePort")
     public PortTarget getControlPlanePort() {
         return controlPlanePort;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("controlPlanePort")
     public void setControlPlanePort(PortTarget controlPlanePort) {
         this.controlPlanePort = controlPlanePort;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("defaultMachinePlatform")
     public MachinePool getDefaultMachinePlatform() {
         return defaultMachinePlatform;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("defaultMachinePlatform")
     public void setDefaultMachinePlatform(MachinePool defaultMachinePlatform) {
         this.defaultMachinePlatform = defaultMachinePlatform;
     }
 
+    /**
+     * ExternalDNS holds the IP addresses of dns servers that will be added to the dns resolution of all instances in the cluster.
+     */
     @JsonProperty("externalDNS")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getExternalDNS() {
         return externalDNS;
     }
 
+    /**
+     * ExternalDNS holds the IP addresses of dns servers that will be added to the dns resolution of all instances in the cluster.
+     */
     @JsonProperty("externalDNS")
     public void setExternalDNS(List<String> externalDNS) {
         this.externalDNS = externalDNS;
     }
 
+    /**
+     * ExternalNetwork is name of the external network in your OpenStack cluster.
+     */
     @JsonProperty("externalNetwork")
     public String getExternalNetwork() {
         return externalNetwork;
     }
 
+    /**
+     * ExternalNetwork is name of the external network in your OpenStack cluster.
+     */
     @JsonProperty("externalNetwork")
     public void setExternalNetwork(String externalNetwork) {
         this.externalNetwork = externalNetwork;
     }
 
+    /**
+     * IngressFloatingIP is the ID of an available floating IP in your OpenStack cluster that will be associated with the OpenShift ingress port
+     */
     @JsonProperty("ingressFloatingIP")
     public String getIngressFloatingIP() {
         return ingressFloatingIP;
     }
 
+    /**
+     * IngressFloatingIP is the ID of an available floating IP in your OpenStack cluster that will be associated with the OpenShift ingress port
+     */
     @JsonProperty("ingressFloatingIP")
     public void setIngressFloatingIP(String ingressFloatingIP) {
         this.ingressFloatingIP = ingressFloatingIP;
     }
 
+    /**
+     * DeprecatedIngressVIP is the static IP on the nodes subnet that the apps port for openshift will be assigned Default: will be set to the 7 on the first entry in the machineNetwork CIDR Deprecated: Use IngressVIPs
+     */
     @JsonProperty("ingressVIP")
     public String getIngressVIP() {
         return ingressVIP;
     }
 
+    /**
+     * DeprecatedIngressVIP is the static IP on the nodes subnet that the apps port for openshift will be assigned Default: will be set to the 7 on the first entry in the machineNetwork CIDR Deprecated: Use IngressVIPs
+     */
     @JsonProperty("ingressVIP")
     public void setIngressVIP(String ingressVIP) {
         this.ingressVIP = ingressVIP;
     }
 
+    /**
+     * IngressVIPs contains the VIP(s) on the nodes subnet that the apps port for openshift will be assigned. In dual stack clusters it contains an IPv4 and IPv6 address, otherwise only one VIP Default: will be set to the 7 on the first entry in the machineNetwork CIDR
+     */
     @JsonProperty("ingressVIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIngressVIPs() {
         return ingressVIPs;
     }
 
+    /**
+     * IngressVIPs contains the VIP(s) on the nodes subnet that the apps port for openshift will be assigned. In dual stack clusters it contains an IPv4 and IPv6 address, otherwise only one VIP Default: will be set to the 7 on the first entry in the machineNetwork CIDR
+     */
     @JsonProperty("ingressVIPs")
     public void setIngressVIPs(List<String> ingressVIPs) {
         this.ingressVIPs = ingressVIPs;
     }
 
+    /**
+     * LbFloatingIP is the IP address of an available floating IP in your OpenStack cluster to associate with the OpenShift load balancer. Deprecated: this value has been renamed to apiFloatingIP.
+     */
     @JsonProperty("lbFloatingIP")
     public String getLbFloatingIP() {
         return lbFloatingIP;
     }
 
+    /**
+     * LbFloatingIP is the IP address of an available floating IP in your OpenStack cluster to associate with the OpenShift load balancer. Deprecated: this value has been renamed to apiFloatingIP.
+     */
     @JsonProperty("lbFloatingIP")
     public void setLbFloatingIP(String lbFloatingIP) {
         this.lbFloatingIP = lbFloatingIP;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("loadBalancer")
     public OpenStackPlatformLoadBalancer getLoadBalancer() {
         return loadBalancer;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("loadBalancer")
     public void setLoadBalancer(OpenStackPlatformLoadBalancer loadBalancer) {
         this.loadBalancer = loadBalancer;
     }
 
+    /**
+     * DeprecatedMachinesSubnet is a string of the UUIDv4 of an openstack subnet. This subnet will be used by all nodes created by the installer. By setting this, the installer will no longer create a network and subnet. The subnet and network specified in MachinesSubnet will not be deleted or modified by the installer. Deprecated: Use ControlPlanePort
+     */
     @JsonProperty("machinesSubnet")
     public String getMachinesSubnet() {
         return machinesSubnet;
     }
 
+    /**
+     * DeprecatedMachinesSubnet is a string of the UUIDv4 of an openstack subnet. This subnet will be used by all nodes created by the installer. By setting this, the installer will no longer create a network and subnet. The subnet and network specified in MachinesSubnet will not be deleted or modified by the installer. Deprecated: Use ControlPlanePort
+     */
     @JsonProperty("machinesSubnet")
     public void setMachinesSubnet(String machinesSubnet) {
         this.machinesSubnet = machinesSubnet;
     }
 
+    /**
+     * OctaviaSupport holds a `0` or `1` value that indicates whether your OpenStack cluster supports Octavia Loadbalancing. Deprecated: this value is set by the installer automatically.
+     */
     @JsonProperty("octaviaSupport")
     public String getOctaviaSupport() {
         return octaviaSupport;
     }
 
+    /**
+     * OctaviaSupport holds a `0` or `1` value that indicates whether your OpenStack cluster supports Octavia Loadbalancing. Deprecated: this value is set by the installer automatically.
+     */
     @JsonProperty("octaviaSupport")
     public void setOctaviaSupport(String octaviaSupport) {
         this.octaviaSupport = octaviaSupport;
     }
 
+    /**
+     * Region specifies the OpenStack region where the cluster will be created. Deprecated: this value is not used by the installer.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Region specifies the OpenStack region where the cluster will be created. Deprecated: this value is not used by the installer.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * TrunkSupport holds a `0` or `1` value that indicates whether or not to use trunk ports in your OpenShift cluster. Deprecated: the machine manifest should be used to specify that trunk should be used.
+     */
     @JsonProperty("trunkSupport")
     public String getTrunkSupport() {
         return trunkSupport;
     }
 
+    /**
+     * TrunkSupport holds a `0` or `1` value that indicates whether or not to use trunk ports in your OpenShift cluster. Deprecated: the machine manifest should be used to specify that trunk should be used.
+     */
     @JsonProperty("trunkSupport")
     public void setTrunkSupport(String trunkSupport) {
         this.trunkSupport = trunkSupport;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/PortTarget.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/PortTarget.java
index f3d3dfb7ce3..85473b658df 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/PortTarget.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/PortTarget.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PortTarget defines, directly or indirectly, one or more subnets where to attach a port.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public PortTarget(List<FixedIP> fixedIPs, NetworkFilter network) {
         this.network = network;
     }
 
+    /**
+     * Specify subnets of the network where control plane port will be discovered.
+     */
     @JsonProperty("fixedIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<FixedIP> getFixedIPs() {
         return fixedIPs;
     }
 
+    /**
+     * Specify subnets of the network where control plane port will be discovered.
+     */
     @JsonProperty("fixedIPs")
     public void setFixedIPs(List<FixedIP> fixedIPs) {
         this.fixedIPs = fixedIPs;
     }
 
+    /**
+     * PortTarget defines, directly or indirectly, one or more subnets where to attach a port.
+     */
     @JsonProperty("network")
     public NetworkFilter getNetwork() {
         return network;
     }
 
+    /**
+     * PortTarget defines, directly or indirectly, one or more subnets where to attach a port.
+     */
     @JsonProperty("network")
     public void setNetwork(NetworkFilter network) {
         this.network = network;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/RootVolume.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/RootVolume.java
index 1b60d7c0ab3..8a7e39e5d29 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/RootVolume.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/RootVolume.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RootVolume defines the storage for an instance.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,43 +97,67 @@ public RootVolume(Integer size, String type, List<String> types, List<String> zo
         this.zones = zones;
     }
 
+    /**
+     * Size defines the size of the volume in gibibytes (GiB). Required
+     */
     @JsonProperty("size")
     public Integer getSize() {
         return size;
     }
 
+    /**
+     * Size defines the size of the volume in gibibytes (GiB). Required
+     */
     @JsonProperty("size")
     public void setSize(Integer size) {
         this.size = size;
     }
 
+    /**
+     * Type defines the type of the volume. Deprecated: Use Types instead.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type defines the type of the volume. Deprecated: Use Types instead.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * Types is the list of the volume types of the root volumes. This is mutually exclusive with Type.
+     */
     @JsonProperty("types")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getTypes() {
         return types;
     }
 
+    /**
+     * Types is the list of the volume types of the root volumes. This is mutually exclusive with Type.
+     */
     @JsonProperty("types")
     public void setTypes(List<String> types) {
         this.types = types;
     }
 
+    /**
+     * Zones is the list of availability zones where the root volumes should be deployed. If no zones are provided, all instances will be deployed on OpenStack Cinder default availability zone
+     */
     @JsonProperty("zones")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getZones() {
         return zones;
     }
 
+    /**
+     * Zones is the list of availability zones where the root volumes should be deployed. If no zones are provided, all instances will be deployed on OpenStack Cinder default availability zone
+     */
     @JsonProperty("zones")
     public void setZones(List<String> zones) {
         this.zones = zones;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/SubnetFilter.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/SubnetFilter.java
index 33decaa7a3a..c6a67522704 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/SubnetFilter.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/openstack/v1/SubnetFilter.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubnetFilter defines a subnet by ID and/or name.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public SubnetFilter(String id, String name) {
         this.name = name;
     }
 
+    /**
+     * SubnetFilter defines a subnet by ID and/or name.
+     */
     @JsonProperty("id")
     public String getId() {
         return id;
     }
 
+    /**
+     * SubnetFilter defines a subnet by ID and/or name.
+     */
     @JsonProperty("id")
     public void setId(String id) {
         this.id = id;
     }
 
+    /**
+     * SubnetFilter defines a subnet by ID and/or name.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * SubnetFilter defines a subnet by ID and/or name.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ovirt/v1/AffinityGroup.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ovirt/v1/AffinityGroup.java
index bc6e1e40321..73a1841e55a 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ovirt/v1/AffinityGroup.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ovirt/v1/AffinityGroup.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AffinityGroup defines the affinity group that the installer will create
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public AffinityGroup(String description, Boolean enforcing, String name, Integer
         this.priority = priority;
     }
 
+    /**
+     * Description of the affinity group
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description of the affinity group
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * Enforcing whether to create a hard affinity rule, default is false
+     */
     @JsonProperty("enforcing")
     public Boolean getEnforcing() {
         return enforcing;
     }
 
+    /**
+     * Enforcing whether to create a hard affinity rule, default is false
+     */
     @JsonProperty("enforcing")
     public void setEnforcing(Boolean enforcing) {
         this.enforcing = enforcing;
     }
 
+    /**
+     * Name name of the affinity group
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name name of the affinity group
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Priority of the affinity group, needs to be between 1 (lowest) - 5 (highest)
+     */
     @JsonProperty("priority")
     public Integer getPriority() {
         return priority;
     }
 
+    /**
+     * Priority of the affinity group, needs to be between 1 (lowest) - 5 (highest)
+     */
     @JsonProperty("priority")
     public void setPriority(Integer priority) {
         this.priority = priority;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ovirt/v1/CPU.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ovirt/v1/CPU.java
index 975ea47819c..bca032fcc6c 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ovirt/v1/CPU.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ovirt/v1/CPU.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CPU defines the VM cpu, made of (Sockets &#42; Cores).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public CPU(Integer cores, Integer sockets, Integer threads) {
         this.threads = threads;
     }
 
+    /**
+     * Cores is the number of cores per socket. Total CPUs is (Sockets &#42; Cores)
+     */
     @JsonProperty("cores")
     public Integer getCores() {
         return cores;
     }
 
+    /**
+     * Cores is the number of cores per socket. Total CPUs is (Sockets &#42; Cores)
+     */
     @JsonProperty("cores")
     public void setCores(Integer cores) {
         this.cores = cores;
     }
 
+    /**
+     * Sockets is the number of sockets for a VM. Total CPUs is (Sockets &#42; Cores)
+     */
     @JsonProperty("sockets")
     public Integer getSockets() {
         return sockets;
     }
 
+    /**
+     * Sockets is the number of sockets for a VM. Total CPUs is (Sockets &#42; Cores)
+     */
     @JsonProperty("sockets")
     public void setSockets(Integer sockets) {
         this.sockets = sockets;
     }
 
+    /**
+     * Threads is the number of CPU threads.
+     */
     @JsonProperty("threads")
     public Integer getThreads() {
         return threads;
     }
 
+    /**
+     * Threads is the number of CPU threads.
+     */
     @JsonProperty("threads")
     public void setThreads(Integer threads) {
         this.threads = threads;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ovirt/v1/Disk.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ovirt/v1/Disk.java
index f21cb32405d..d92cbd5e53d 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ovirt/v1/Disk.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ovirt/v1/Disk.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Disk defines a VM disk
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public Disk(Long sizeGB) {
         this.sizeGB = sizeGB;
     }
 
+    /**
+     * SizeGB size of the bootable disk in GiB.
+     */
     @JsonProperty("sizeGB")
     public Long getSizeGB() {
         return sizeGB;
     }
 
+    /**
+     * SizeGB size of the bootable disk in GiB.
+     */
     @JsonProperty("sizeGB")
     public void setSizeGB(Long sizeGB) {
         this.sizeGB = sizeGB;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ovirt/v1/MachinePool.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ovirt/v1/MachinePool.java
index a75cf700cc7..aa579398f8d 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ovirt/v1/MachinePool.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ovirt/v1/MachinePool.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePool stores the configuration for a machine pool installed on ovirt.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -121,112 +124,178 @@ public MachinePool(List<String> affinityGroupsNames, String autoPinningPolicy, B
         this.vmType = vmType;
     }
 
+    /**
+     * AffinityGroupsNames contains a list of oVirt affinity group names that the newly created machines will join. The affinity groups should exist on the oVirt cluster or created by the OpenShift installer.
+     */
     @JsonProperty("affinityGroupsNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAffinityGroupsNames() {
         return affinityGroupsNames;
     }
 
+    /**
+     * AffinityGroupsNames contains a list of oVirt affinity group names that the newly created machines will join. The affinity groups should exist on the oVirt cluster or created by the OpenShift installer.
+     */
     @JsonProperty("affinityGroupsNames")
     public void setAffinityGroupsNames(List<String> affinityGroupsNames) {
         this.affinityGroupsNames = affinityGroupsNames;
     }
 
+    /**
+     * AutoPinningPolicy defines the policy to automatically set the CPU and NUMA including pinning to the host for the instance. When the field is omitted the default will be "none".
+     */
     @JsonProperty("autoPinningPolicy")
     public String getAutoPinningPolicy() {
         return autoPinningPolicy;
     }
 
+    /**
+     * AutoPinningPolicy defines the policy to automatically set the CPU and NUMA including pinning to the host for the instance. When the field is omitted the default will be "none".
+     */
     @JsonProperty("autoPinningPolicy")
     public void setAutoPinningPolicy(String autoPinningPolicy) {
         this.autoPinningPolicy = autoPinningPolicy;
     }
 
+    /**
+     * Clone makes sure that the disks are cloned from the template and are not linked. Defaults to true for high performance and server VM types, false for desktop types.<br><p> <br><p> Note: this option is not documented in the OpenShift documentation. This is intentional as it has sane defaults that shouldn't be changed unless needed for debugging or resolving issues in cooperation with Red Hat support.
+     */
     @JsonProperty("clone")
     public Boolean getClone() {
         return clone;
     }
 
+    /**
+     * Clone makes sure that the disks are cloned from the template and are not linked. Defaults to true for high performance and server VM types, false for desktop types.<br><p> <br><p> Note: this option is not documented in the OpenShift documentation. This is intentional as it has sane defaults that shouldn't be changed unless needed for debugging or resolving issues in cooperation with Red Hat support.
+     */
     @JsonProperty("clone")
     public void setClone(Boolean clone) {
         this.clone = clone;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on ovirt.
+     */
     @JsonProperty("cpu")
     public CPU getCpu() {
         return cpu;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on ovirt.
+     */
     @JsonProperty("cpu")
     public void setCpu(CPU cpu) {
         this.cpu = cpu;
     }
 
+    /**
+     * Format is the disk format that the disks are in. Can be "cow" or "raw". "raw" disables several features that may be needed, such as incremental backups.
+     */
     @JsonProperty("format")
     public String getFormat() {
         return format;
     }
 
+    /**
+     * Format is the disk format that the disks are in. Can be "cow" or "raw". "raw" disables several features that may be needed, such as incremental backups.
+     */
     @JsonProperty("format")
     public void setFormat(String format) {
         this.format = format;
     }
 
+    /**
+     * Hugepages is the size of a VM's hugepages to use in KiBs.
+     */
     @JsonProperty("hugepages")
     public Integer getHugepages() {
         return hugepages;
     }
 
+    /**
+     * Hugepages is the size of a VM's hugepages to use in KiBs.
+     */
     @JsonProperty("hugepages")
     public void setHugepages(Integer hugepages) {
         this.hugepages = hugepages;
     }
 
+    /**
+     * InstanceTypeID defines the VM instance type and overrides the hardware parameters of the created VM, including cpu and memory. If InstanceTypeID is passed, all memory and cpu variables will be ignored.
+     */
     @JsonProperty("instanceTypeID")
     public String getInstanceTypeID() {
         return instanceTypeID;
     }
 
+    /**
+     * InstanceTypeID defines the VM instance type and overrides the hardware parameters of the created VM, including cpu and memory. If InstanceTypeID is passed, all memory and cpu variables will be ignored.
+     */
     @JsonProperty("instanceTypeID")
     public void setInstanceTypeID(String instanceTypeID) {
         this.instanceTypeID = instanceTypeID;
     }
 
+    /**
+     * MemoryMB is the size of a VM's memory in MiBs.
+     */
     @JsonProperty("memoryMB")
     public Integer getMemoryMB() {
         return memoryMB;
     }
 
+    /**
+     * MemoryMB is the size of a VM's memory in MiBs.
+     */
     @JsonProperty("memoryMB")
     public void setMemoryMB(Integer memoryMB) {
         this.memoryMB = memoryMB;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on ovirt.
+     */
     @JsonProperty("osDisk")
     public Disk getOsDisk() {
         return osDisk;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on ovirt.
+     */
     @JsonProperty("osDisk")
     public void setOsDisk(Disk osDisk) {
         this.osDisk = osDisk;
     }
 
+    /**
+     * Sparse indicates that sparse provisioning should be used and disks should be not preallocated.
+     */
     @JsonProperty("sparse")
     public Boolean getSparse() {
         return sparse;
     }
 
+    /**
+     * Sparse indicates that sparse provisioning should be used and disks should be not preallocated.
+     */
     @JsonProperty("sparse")
     public void setSparse(Boolean sparse) {
         this.sparse = sparse;
     }
 
+    /**
+     * VMType defines the workload type of the VM.
+     */
     @JsonProperty("vmType")
     public String getVmType() {
         return vmType;
     }
 
+    /**
+     * VMType defines the workload type of the VM.
+     */
     @JsonProperty("vmType")
     public void setVmType(String vmType) {
         this.vmType = vmType;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ovirt/v1/Metadata.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ovirt/v1/Metadata.java
index 1f0e913918e..d910fd3b347 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ovirt/v1/Metadata.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ovirt/v1/Metadata.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metadata contains ovirt metadata (e.g. for uninstalling the cluster).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Metadata(String clusterId, Boolean removeTemplate) {
         this.removeTemplate = removeTemplate;
     }
 
+    /**
+     * Metadata contains ovirt metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("cluster_id")
     public String getClusterId() {
         return clusterId;
     }
 
+    /**
+     * Metadata contains ovirt metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("cluster_id")
     public void setClusterId(String clusterId) {
         this.clusterId = clusterId;
     }
 
+    /**
+     * Metadata contains ovirt metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("remove_template")
     public Boolean getRemoveTemplate() {
         return removeTemplate;
     }
 
+    /**
+     * Metadata contains ovirt metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("remove_template")
     public void setRemoveTemplate(Boolean removeTemplate) {
         this.removeTemplate = removeTemplate;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ovirt/v1/Platform.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ovirt/v1/Platform.java
index af67b8fca9e..c41df76434d 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ovirt/v1/Platform.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/ovirt/v1/Platform.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Platform stores all the global configuration that all machinesets use.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -124,114 +127,180 @@ public Platform(List<AffinityGroup> affinityGroups, String apiVip, List<String>
         this.vnicProfileID = vnicProfileID;
     }
 
+    /**
+     * AffinityGroups contains the RHV affinity groups that the installer will create.
+     */
     @JsonProperty("affinityGroups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AffinityGroup> getAffinityGroups() {
         return affinityGroups;
     }
 
+    /**
+     * AffinityGroups contains the RHV affinity groups that the installer will create.
+     */
     @JsonProperty("affinityGroups")
     public void setAffinityGroups(List<AffinityGroup> affinityGroups) {
         this.affinityGroups = affinityGroups;
     }
 
+    /**
+     * DeprecatedAPIVIP is an IP which will be served by bootstrap and then pivoted masters, using keepalived Deprecated: Use APIVIPs
+     */
     @JsonProperty("api_vip")
     public String getApiVip() {
         return apiVip;
     }
 
+    /**
+     * DeprecatedAPIVIP is an IP which will be served by bootstrap and then pivoted masters, using keepalived Deprecated: Use APIVIPs
+     */
     @JsonProperty("api_vip")
     public void setApiVip(String apiVip) {
         this.apiVip = apiVip;
     }
 
+    /**
+     * APIVIPs contains the VIP(s) which will be served by bootstrap and then pivoted masters, using keepalived. In dual stack clusters it contains an IPv4 and IPv6 address, otherwise only one VIP
+     */
     @JsonProperty("api_vips")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiVips() {
         return apiVips;
     }
 
+    /**
+     * APIVIPs contains the VIP(s) which will be served by bootstrap and then pivoted masters, using keepalived. In dual stack clusters it contains an IPv4 and IPv6 address, otherwise only one VIP
+     */
     @JsonProperty("api_vips")
     public void setApiVips(List<String> apiVips) {
         this.apiVips = apiVips;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("defaultMachinePlatform")
     public MachinePool getDefaultMachinePlatform() {
         return defaultMachinePlatform;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("defaultMachinePlatform")
     public void setDefaultMachinePlatform(MachinePool defaultMachinePlatform) {
         this.defaultMachinePlatform = defaultMachinePlatform;
     }
 
+    /**
+     * IngressIP is an external IP which routes to the default ingress controller. The IP is a suitable target of a wildcard DNS record used to resolve default route host names. Deprecated: Use IngressVIPs
+     */
     @JsonProperty("ingress_vip")
     public String getIngressVip() {
         return ingressVip;
     }
 
+    /**
+     * IngressIP is an external IP which routes to the default ingress controller. The IP is a suitable target of a wildcard DNS record used to resolve default route host names. Deprecated: Use IngressVIPs
+     */
     @JsonProperty("ingress_vip")
     public void setIngressVip(String ingressVip) {
         this.ingressVip = ingressVip;
     }
 
+    /**
+     * IngressVIPs are external IP(s) which route to the default ingress controller. The VIPs are suitable targets of wildcard DNS records used to resolve default route host names. In dual stack clusters it contains an IPv4 and IPv6 address, otherwise only one VIP
+     */
     @JsonProperty("ingress_vips")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIngressVips() {
         return ingressVips;
     }
 
+    /**
+     * IngressVIPs are external IP(s) which route to the default ingress controller. The VIPs are suitable targets of wildcard DNS records used to resolve default route host names. In dual stack clusters it contains an IPv4 and IPv6 address, otherwise only one VIP
+     */
     @JsonProperty("ingress_vips")
     public void setIngressVips(List<String> ingressVips) {
         this.ingressVips = ingressVips;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("loadBalancer")
     public OvirtPlatformLoadBalancer getLoadBalancer() {
         return loadBalancer;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("loadBalancer")
     public void setLoadBalancer(OvirtPlatformLoadBalancer loadBalancer) {
         this.loadBalancer = loadBalancer;
     }
 
+    /**
+     * The target cluster under which all VMs will run
+     */
     @JsonProperty("ovirt_cluster_id")
     public String getOvirtClusterId() {
         return ovirtClusterId;
     }
 
+    /**
+     * The target cluster under which all VMs will run
+     */
     @JsonProperty("ovirt_cluster_id")
     public void setOvirtClusterId(String ovirtClusterId) {
         this.ovirtClusterId = ovirtClusterId;
     }
 
+    /**
+     * NetworkName is the target network of all the network interfaces of the nodes. When no ovirt_network_name is provided it defaults to `ovirtmgmt` network, which is a default network for every ovirt cluster.
+     */
     @JsonProperty("ovirt_network_name")
     public String getOvirtNetworkName() {
         return ovirtNetworkName;
     }
 
+    /**
+     * NetworkName is the target network of all the network interfaces of the nodes. When no ovirt_network_name is provided it defaults to `ovirtmgmt` network, which is a default network for every ovirt cluster.
+     */
     @JsonProperty("ovirt_network_name")
     public void setOvirtNetworkName(String ovirtNetworkName) {
         this.ovirtNetworkName = ovirtNetworkName;
     }
 
+    /**
+     * The target storage domain under which all VM disk would be created.
+     */
     @JsonProperty("ovirt_storage_domain_id")
     public String getOvirtStorageDomainId() {
         return ovirtStorageDomainId;
     }
 
+    /**
+     * The target storage domain under which all VM disk would be created.
+     */
     @JsonProperty("ovirt_storage_domain_id")
     public void setOvirtStorageDomainId(String ovirtStorageDomainId) {
         this.ovirtStorageDomainId = ovirtStorageDomainId;
     }
 
+    /**
+     * VNICProfileID defines the VNIC profile ID to use the the VM network interfaces. When no vnicProfileID is provided it will be set to the profile of the network. If there are multiple profiles for the network, the installer requires you to explicitly set the vnicProfileID.
+     */
     @JsonProperty("vnicProfileID")
     public String getVnicProfileID() {
         return vnicProfileID;
     }
 
+    /**
+     * VNICProfileID defines the VNIC profile ID to use the the VM network interfaces. When no vnicProfileID is provided it will be set to the profile of the network. If there are multiple profiles for the network, the installer requires you to explicitly set the vnicProfileID.
+     */
     @JsonProperty("vnicProfileID")
     public void setVnicProfileID(String vnicProfileID) {
         this.vnicProfileID = vnicProfileID;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/powervs/v1/MachinePool.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/powervs/v1/MachinePool.java
index 57fc58fb05c..9d847051be1 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/powervs/v1/MachinePool.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/powervs/v1/MachinePool.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePool stores the configuration for a machine pool installed on IBM Power VS.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,62 +104,98 @@ public MachinePool(Integer memoryGiB, String procType, IntOrString processors, S
         this.volumeIDs = volumeIDs;
     }
 
+    /**
+     * memoryGiB is the size of a virtual machine's memory, in GiB.
+     */
     @JsonProperty("memoryGiB")
     public Integer getMemoryGiB() {
         return memoryGiB;
     }
 
+    /**
+     * memoryGiB is the size of a virtual machine's memory, in GiB.
+     */
     @JsonProperty("memoryGiB")
     public void setMemoryGiB(Integer memoryGiB) {
         this.memoryGiB = memoryGiB;
     }
 
+    /**
+     * ProcType defines the processor sharing model for the instance. Must be one of {Capped, Dedicated, Shared}.
+     */
     @JsonProperty("procType")
     public String getProcType() {
         return procType;
     }
 
+    /**
+     * ProcType defines the processor sharing model for the instance. Must be one of {Capped, Dedicated, Shared}.
+     */
     @JsonProperty("procType")
     public void setProcType(String procType) {
         this.procType = procType;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on IBM Power VS.
+     */
     @JsonProperty("processors")
     public IntOrString getProcessors() {
         return processors;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on IBM Power VS.
+     */
     @JsonProperty("processors")
     public void setProcessors(IntOrString processors) {
         this.processors = processors;
     }
 
+    /**
+     * SMTLevel specifies the level of SMT to set the control plane and worker nodes to.
+     */
     @JsonProperty("smtLevel")
     public String getSmtLevel() {
         return smtLevel;
     }
 
+    /**
+     * SMTLevel specifies the level of SMT to set the control plane and worker nodes to.
+     */
     @JsonProperty("smtLevel")
     public void setSmtLevel(String smtLevel) {
         this.smtLevel = smtLevel;
     }
 
+    /**
+     * SysType defines the system type for instance.
+     */
     @JsonProperty("sysType")
     public String getSysType() {
         return sysType;
     }
 
+    /**
+     * SysType defines the system type for instance.
+     */
     @JsonProperty("sysType")
     public void setSysType(String sysType) {
         this.sysType = sysType;
     }
 
+    /**
+     * VolumeIDs is the list of volumes attached to the instance.
+     */
     @JsonProperty("volumeIDs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getVolumeIDs() {
         return volumeIDs;
     }
 
+    /**
+     * VolumeIDs is the list of volumes attached to the instance.
+     */
     @JsonProperty("volumeIDs")
     public void setVolumeIDs(List<String> volumeIDs) {
         this.volumeIDs = volumeIDs;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/powervs/v1/Metadata.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/powervs/v1/Metadata.java
index 8018ba8df87..96fdddd845b 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/powervs/v1/Metadata.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/powervs/v1/Metadata.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metadata contains Power VS metadata (e.g. for uninstalling the cluster).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -118,102 +121,162 @@ public Metadata(String baseDomain, String cisInstanceCRN, String dnsInstanceCRN,
         this.zone = zone;
     }
 
+    /**
+     * Metadata contains Power VS metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("BaseDomain")
     public String getBaseDomain() {
         return baseDomain;
     }
 
+    /**
+     * Metadata contains Power VS metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("BaseDomain")
     public void setBaseDomain(String baseDomain) {
         this.baseDomain = baseDomain;
     }
 
+    /**
+     * Metadata contains Power VS metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("cisInstanceCRN")
     public String getCisInstanceCRN() {
         return cisInstanceCRN;
     }
 
+    /**
+     * Metadata contains Power VS metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("cisInstanceCRN")
     public void setCisInstanceCRN(String cisInstanceCRN) {
         this.cisInstanceCRN = cisInstanceCRN;
     }
 
+    /**
+     * Metadata contains Power VS metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("dnsInstanceCRN")
     public String getDnsInstanceCRN() {
         return dnsInstanceCRN;
     }
 
+    /**
+     * Metadata contains Power VS metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("dnsInstanceCRN")
     public void setDnsInstanceCRN(String dnsInstanceCRN) {
         this.dnsInstanceCRN = dnsInstanceCRN;
     }
 
+    /**
+     * Metadata contains Power VS metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("powerVSResourceGroup")
     public String getPowerVSResourceGroup() {
         return powerVSResourceGroup;
     }
 
+    /**
+     * Metadata contains Power VS metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("powerVSResourceGroup")
     public void setPowerVSResourceGroup(String powerVSResourceGroup) {
         this.powerVSResourceGroup = powerVSResourceGroup;
     }
 
+    /**
+     * Metadata contains Power VS metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Metadata contains Power VS metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * Metadata contains Power VS metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("serviceEndpoints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PowerVSServiceEndpoint> getServiceEndpoints() {
         return serviceEndpoints;
     }
 
+    /**
+     * Metadata contains Power VS metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("serviceEndpoints")
     public void setServiceEndpoints(List<PowerVSServiceEndpoint> serviceEndpoints) {
         this.serviceEndpoints = serviceEndpoints;
     }
 
+    /**
+     * Metadata contains Power VS metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("serviceInstanceGUID")
     public String getServiceInstanceGUID() {
         return serviceInstanceGUID;
     }
 
+    /**
+     * Metadata contains Power VS metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("serviceInstanceGUID")
     public void setServiceInstanceGUID(String serviceInstanceGUID) {
         this.serviceInstanceGUID = serviceInstanceGUID;
     }
 
+    /**
+     * Metadata contains Power VS metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("transitGatewayName")
     public String getTransitGatewayName() {
         return transitGatewayName;
     }
 
+    /**
+     * Metadata contains Power VS metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("transitGatewayName")
     public void setTransitGatewayName(String transitGatewayName) {
         this.transitGatewayName = transitGatewayName;
     }
 
+    /**
+     * Metadata contains Power VS metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("vpcRegion")
     public String getVpcRegion() {
         return vpcRegion;
     }
 
+    /**
+     * Metadata contains Power VS metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("vpcRegion")
     public void setVpcRegion(String vpcRegion) {
         this.vpcRegion = vpcRegion;
     }
 
+    /**
+     * Metadata contains Power VS metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("zone")
     public String getZone() {
         return zone;
     }
 
+    /**
+     * Metadata contains Power VS metadata (e.g. for uninstalling the cluster).
+     */
     @JsonProperty("zone")
     public void setZone(String zone) {
         this.zone = zone;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/powervs/v1/Platform.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/powervs/v1/Platform.java
index 3477f623705..61b8d6ffecb 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/powervs/v1/Platform.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/powervs/v1/Platform.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Platform stores all the global configuration that all machinesets use.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -127,123 +130,195 @@ public Platform(String clusterOSImage, MachinePool defaultMachinePlatform, Strin
         this.zone = zone;
     }
 
+    /**
+     * ClusterOSImage is a pre-created Power VS boot image that overrides the default image for cluster nodes.
+     */
     @JsonProperty("clusterOSImage")
     public String getClusterOSImage() {
         return clusterOSImage;
     }
 
+    /**
+     * ClusterOSImage is a pre-created Power VS boot image that overrides the default image for cluster nodes.
+     */
     @JsonProperty("clusterOSImage")
     public void setClusterOSImage(String clusterOSImage) {
         this.clusterOSImage = clusterOSImage;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("defaultMachinePlatform")
     public MachinePool getDefaultMachinePlatform() {
         return defaultMachinePlatform;
     }
 
+    /**
+     * Platform stores all the global configuration that all machinesets use.
+     */
     @JsonProperty("defaultMachinePlatform")
     public void setDefaultMachinePlatform(MachinePool defaultMachinePlatform) {
         this.defaultMachinePlatform = defaultMachinePlatform;
     }
 
+    /**
+     * PowerVSResourceGroup is the resource group in which Power VS resources will be created.
+     */
     @JsonProperty("powervsResourceGroup")
     public String getPowervsResourceGroup() {
         return powervsResourceGroup;
     }
 
+    /**
+     * PowerVSResourceGroup is the resource group in which Power VS resources will be created.
+     */
     @JsonProperty("powervsResourceGroup")
     public void setPowervsResourceGroup(String powervsResourceGroup) {
         this.powervsResourceGroup = powervsResourceGroup;
     }
 
+    /**
+     * Region specifies the IBM Cloud colo region where the cluster will be created.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Region specifies the IBM Cloud colo region where the cluster will be created.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * ServiceEndpoints is a list which contains custom endpoints to override default service endpoints of IBM Cloud Services. There must only be one ServiceEndpoint for a service (no duplicates).
+     */
     @JsonProperty("serviceEndpoints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PowerVSServiceEndpoint> getServiceEndpoints() {
         return serviceEndpoints;
     }
 
+    /**
+     * ServiceEndpoints is a list which contains custom endpoints to override default service endpoints of IBM Cloud Services. There must only be one ServiceEndpoint for a service (no duplicates).
+     */
     @JsonProperty("serviceEndpoints")
     public void setServiceEndpoints(List<PowerVSServiceEndpoint> serviceEndpoints) {
         this.serviceEndpoints = serviceEndpoints;
     }
 
+    /**
+     * ServiceInstanceGUID is the GUID of the Power IAAS instance created from the IBM Cloud Catalog before the cluster is completed.  Leave unset to allow the installer to create a service instance during cluster creation.
+     */
     @JsonProperty("serviceInstanceGUID")
     public String getServiceInstanceGUID() {
         return serviceInstanceGUID;
     }
 
+    /**
+     * ServiceInstanceGUID is the GUID of the Power IAAS instance created from the IBM Cloud Catalog before the cluster is completed.  Leave unset to allow the installer to create a service instance during cluster creation.
+     */
     @JsonProperty("serviceInstanceGUID")
     public void setServiceInstanceGUID(String serviceInstanceGUID) {
         this.serviceInstanceGUID = serviceInstanceGUID;
     }
 
+    /**
+     * TGName is the name of a pre-created TransitGateway inside IBM Cloud.
+     */
     @JsonProperty("tgName")
     public String getTgName() {
         return tgName;
     }
 
+    /**
+     * TGName is the name of a pre-created TransitGateway inside IBM Cloud.
+     */
     @JsonProperty("tgName")
     public void setTgName(String tgName) {
         this.tgName = tgName;
     }
 
+    /**
+     * UserID is the login for the user's IBM Cloud account.
+     */
     @JsonProperty("userID")
     public String getUserID() {
         return userID;
     }
 
+    /**
+     * UserID is the login for the user's IBM Cloud account.
+     */
     @JsonProperty("userID")
     public void setUserID(String userID) {
         this.userID = userID;
     }
 
+    /**
+     * VPCName is the name of a pre-created VPC inside IBM Cloud.
+     */
     @JsonProperty("vpcName")
     public String getVpcName() {
         return vpcName;
     }
 
+    /**
+     * VPCName is the name of a pre-created VPC inside IBM Cloud.
+     */
     @JsonProperty("vpcName")
     public void setVpcName(String vpcName) {
         this.vpcName = vpcName;
     }
 
+    /**
+     * VPCRegion specifies the IBM Cloud region in which to create VPC resources. Leave unset to allow installer to select the closest VPC region.
+     */
     @JsonProperty("vpcRegion")
     public String getVpcRegion() {
         return vpcRegion;
     }
 
+    /**
+     * VPCRegion specifies the IBM Cloud region in which to create VPC resources. Leave unset to allow installer to select the closest VPC region.
+     */
     @JsonProperty("vpcRegion")
     public void setVpcRegion(String vpcRegion) {
         this.vpcRegion = vpcRegion;
     }
 
+    /**
+     * VPCSubnets specifies existing subnets (by ID) where cluster resources will be created.  Leave unset to have the installer create subnets in a new VPC on your behalf.
+     */
     @JsonProperty("vpcSubnets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getVpcSubnets() {
         return vpcSubnets;
     }
 
+    /**
+     * VPCSubnets specifies existing subnets (by ID) where cluster resources will be created.  Leave unset to have the installer create subnets in a new VPC on your behalf.
+     */
     @JsonProperty("vpcSubnets")
     public void setVpcSubnets(List<String> vpcSubnets) {
         this.vpcSubnets = vpcSubnets;
     }
 
+    /**
+     * Zone specifies the IBM Cloud colo region where the cluster will be created. At this time, only single-zone clusters are supported.
+     */
     @JsonProperty("zone")
     public String getZone() {
         return zone;
     }
 
+    /**
+     * Zone specifies the IBM Cloud colo region where the cluster will be created. At this time, only single-zone clusters are supported.
+     */
     @JsonProperty("zone")
     public void setZone(String zone) {
         this.zone = zone;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/powervs/v1/Region.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/powervs/v1/Region.java
index a011763eb26..0e29c7026bd 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/powervs/v1/Region.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/powervs/v1/Region.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Region describes resources associated with a region in Power VS. We're using a few items from the IBM Cloud VPC offering. The region names for VPC are different so another function of this is to correlate those.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -103,64 +106,100 @@ public Region(String cOSRegion, String description, List<String> sysTypes, Strin
         this.zones = zones;
     }
 
+    /**
+     * Region describes resources associated with a region in Power VS. We're using a few items from the IBM Cloud VPC offering. The region names for VPC are different so another function of this is to correlate those.
+     */
     @JsonProperty("COSRegion")
     public String getCOSRegion() {
         return cOSRegion;
     }
 
+    /**
+     * Region describes resources associated with a region in Power VS. We're using a few items from the IBM Cloud VPC offering. The region names for VPC are different so another function of this is to correlate those.
+     */
     @JsonProperty("COSRegion")
     public void setCOSRegion(String cOSRegion) {
         this.cOSRegion = cOSRegion;
     }
 
+    /**
+     * Region describes resources associated with a region in Power VS. We're using a few items from the IBM Cloud VPC offering. The region names for VPC are different so another function of this is to correlate those.
+     */
     @JsonProperty("Description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Region describes resources associated with a region in Power VS. We're using a few items from the IBM Cloud VPC offering. The region names for VPC are different so another function of this is to correlate those.
+     */
     @JsonProperty("Description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * Region describes resources associated with a region in Power VS. We're using a few items from the IBM Cloud VPC offering. The region names for VPC are different so another function of this is to correlate those.
+     */
     @JsonProperty("SysTypes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSysTypes() {
         return sysTypes;
     }
 
+    /**
+     * Region describes resources associated with a region in Power VS. We're using a few items from the IBM Cloud VPC offering. The region names for VPC are different so another function of this is to correlate those.
+     */
     @JsonProperty("SysTypes")
     public void setSysTypes(List<String> sysTypes) {
         this.sysTypes = sysTypes;
     }
 
+    /**
+     * Region describes resources associated with a region in Power VS. We're using a few items from the IBM Cloud VPC offering. The region names for VPC are different so another function of this is to correlate those.
+     */
     @JsonProperty("VPCRegion")
     public String getVPCRegion() {
         return vPCRegion;
     }
 
+    /**
+     * Region describes resources associated with a region in Power VS. We're using a few items from the IBM Cloud VPC offering. The region names for VPC are different so another function of this is to correlate those.
+     */
     @JsonProperty("VPCRegion")
     public void setVPCRegion(String vPCRegion) {
         this.vPCRegion = vPCRegion;
     }
 
+    /**
+     * Region describes resources associated with a region in Power VS. We're using a few items from the IBM Cloud VPC offering. The region names for VPC are different so another function of this is to correlate those.
+     */
     @JsonProperty("VPCZones")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getVPCZones() {
         return vPCZones;
     }
 
+    /**
+     * Region describes resources associated with a region in Power VS. We're using a few items from the IBM Cloud VPC offering. The region names for VPC are different so another function of this is to correlate those.
+     */
     @JsonProperty("VPCZones")
     public void setVPCZones(List<String> vPCZones) {
         this.vPCZones = vPCZones;
     }
 
+    /**
+     * Region describes resources associated with a region in Power VS. We're using a few items from the IBM Cloud VPC offering. The region names for VPC are different so another function of this is to correlate those.
+     */
     @JsonProperty("Zones")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getZones() {
         return zones;
     }
 
+    /**
+     * Region describes resources associated with a region in Power VS. We're using a few items from the IBM Cloud VPC offering. The region names for VPC are different so another function of this is to correlate those.
+     */
     @JsonProperty("Zones")
     public void setZones(List<String> zones) {
         this.zones = zones;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/BootstrapInPlace.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/BootstrapInPlace.java
index c82a46555f2..486d5387613 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/BootstrapInPlace.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/BootstrapInPlace.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BootstrapInPlace defines the configuration for bootstrap-in-place installation
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public BootstrapInPlace(String installationDisk) {
         this.installationDisk = installationDisk;
     }
 
+    /**
+     * InstallationDisk is the target disk drive for coreos-installer
+     */
     @JsonProperty("installationDisk")
     public String getInstallationDisk() {
         return installationDisk;
     }
 
+    /**
+     * InstallationDisk is the target disk drive for coreos-installer
+     */
     @JsonProperty("installationDisk")
     public void setInstallationDisk(String installationDisk) {
         this.installationDisk = installationDisk;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/Capabilities.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/Capabilities.java
index f5229298d71..69a2a2a1cfc 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/Capabilities.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/Capabilities.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Capabilities selects the managed set of optional, core cluster components.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public Capabilities(List<String> additionalEnabledCapabilities, String baselineC
         this.baselineCapabilitySet = baselineCapabilitySet;
     }
 
+    /**
+     * additionalEnabledCapabilities extends the set of managed capabilities beyond the baseline defined in baselineCapabilitySet. The default is an empty set.
+     */
     @JsonProperty("additionalEnabledCapabilities")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAdditionalEnabledCapabilities() {
         return additionalEnabledCapabilities;
     }
 
+    /**
+     * additionalEnabledCapabilities extends the set of managed capabilities beyond the baseline defined in baselineCapabilitySet. The default is an empty set.
+     */
     @JsonProperty("additionalEnabledCapabilities")
     public void setAdditionalEnabledCapabilities(List<String> additionalEnabledCapabilities) {
         this.additionalEnabledCapabilities = additionalEnabledCapabilities;
     }
 
+    /**
+     * baselineCapabilitySet selects an initial set of optional capabilities to enable, which can be extended via additionalEnabledCapabilities. The default is vCurrent.
+     */
     @JsonProperty("baselineCapabilitySet")
     public String getBaselineCapabilitySet() {
         return baselineCapabilitySet;
     }
 
+    /**
+     * baselineCapabilitySet selects an initial set of optional capabilities to enable, which can be extended via additionalEnabledCapabilities. The default is vCurrent.
+     */
     @JsonProperty("baselineCapabilitySet")
     public void setBaselineCapabilitySet(String baselineCapabilitySet) {
         this.baselineCapabilitySet = baselineCapabilitySet;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/ClusterMetadata.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/ClusterMetadata.java
index fab386b7a8c..5f65b98b286 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/ClusterMetadata.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/ClusterMetadata.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterMetadata contains information regarding the cluster that was created by installer.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -136,151 +139,241 @@ public ClusterMetadata(Metadata aws, io.fabric8.openshift.api.model.installer.az
         this.vsphere = vsphere;
     }
 
+    /**
+     * ClusterMetadata contains information regarding the cluster that was created by installer.
+     */
     @JsonProperty("aws")
     public Metadata getAws() {
         return aws;
     }
 
+    /**
+     * ClusterMetadata contains information regarding the cluster that was created by installer.
+     */
     @JsonProperty("aws")
     public void setAws(Metadata aws) {
         this.aws = aws;
     }
 
+    /**
+     * ClusterMetadata contains information regarding the cluster that was created by installer.
+     */
     @JsonProperty("azure")
     public io.fabric8.openshift.api.model.installer.azure.v1.Metadata getAzure() {
         return azure;
     }
 
+    /**
+     * ClusterMetadata contains information regarding the cluster that was created by installer.
+     */
     @JsonProperty("azure")
     public void setAzure(io.fabric8.openshift.api.model.installer.azure.v1.Metadata azure) {
         this.azure = azure;
     }
 
+    /**
+     * ClusterMetadata contains information regarding the cluster that was created by installer.
+     */
     @JsonProperty("baremetal")
     public io.fabric8.openshift.api.model.installer.baremetal.v1.Metadata getBaremetal() {
         return baremetal;
     }
 
+    /**
+     * ClusterMetadata contains information regarding the cluster that was created by installer.
+     */
     @JsonProperty("baremetal")
     public void setBaremetal(io.fabric8.openshift.api.model.installer.baremetal.v1.Metadata baremetal) {
         this.baremetal = baremetal;
     }
 
+    /**
+     * ClusterID is a globally unique ID that is used to identify an Openshift cluster.
+     */
     @JsonProperty("clusterID")
     public String getClusterID() {
         return clusterID;
     }
 
+    /**
+     * ClusterID is a globally unique ID that is used to identify an Openshift cluster.
+     */
     @JsonProperty("clusterID")
     public void setClusterID(String clusterID) {
         this.clusterID = clusterID;
     }
 
+    /**
+     * ClusterName is the name for the cluster.
+     */
     @JsonProperty("clusterName")
     public String getClusterName() {
         return clusterName;
     }
 
+    /**
+     * ClusterName is the name for the cluster.
+     */
     @JsonProperty("clusterName")
     public void setClusterName(String clusterName) {
         this.clusterName = clusterName;
     }
 
+    /**
+     * ClusterMetadata contains information regarding the cluster that was created by installer.
+     */
     @JsonProperty("customFeatureSet")
     public CustomFeatureGates getCustomFeatureSet() {
         return customFeatureSet;
     }
 
+    /**
+     * ClusterMetadata contains information regarding the cluster that was created by installer.
+     */
     @JsonProperty("customFeatureSet")
     public void setCustomFeatureSet(CustomFeatureGates customFeatureSet) {
         this.customFeatureSet = customFeatureSet;
     }
 
+    /**
+     * ClusterMetadata contains information regarding the cluster that was created by installer.
+     */
     @JsonProperty("featureSet")
     public String getFeatureSet() {
         return featureSet;
     }
 
+    /**
+     * ClusterMetadata contains information regarding the cluster that was created by installer.
+     */
     @JsonProperty("featureSet")
     public void setFeatureSet(String featureSet) {
         this.featureSet = featureSet;
     }
 
+    /**
+     * ClusterMetadata contains information regarding the cluster that was created by installer.
+     */
     @JsonProperty("gcp")
     public io.fabric8.openshift.api.model.installer.gcp.v1.Metadata getGcp() {
         return gcp;
     }
 
+    /**
+     * ClusterMetadata contains information regarding the cluster that was created by installer.
+     */
     @JsonProperty("gcp")
     public void setGcp(io.fabric8.openshift.api.model.installer.gcp.v1.Metadata gcp) {
         this.gcp = gcp;
     }
 
+    /**
+     * ClusterMetadata contains information regarding the cluster that was created by installer.
+     */
     @JsonProperty("ibmcloud")
     public io.fabric8.openshift.api.model.installer.ibmcloud.v1.Metadata getIbmcloud() {
         return ibmcloud;
     }
 
+    /**
+     * ClusterMetadata contains information regarding the cluster that was created by installer.
+     */
     @JsonProperty("ibmcloud")
     public void setIbmcloud(io.fabric8.openshift.api.model.installer.ibmcloud.v1.Metadata ibmcloud) {
         this.ibmcloud = ibmcloud;
     }
 
+    /**
+     * InfraID is an ID that is used to identify cloud resources created by the installer.
+     */
     @JsonProperty("infraID")
     public String getInfraID() {
         return infraID;
     }
 
+    /**
+     * InfraID is an ID that is used to identify cloud resources created by the installer.
+     */
     @JsonProperty("infraID")
     public void setInfraID(String infraID) {
         this.infraID = infraID;
     }
 
+    /**
+     * ClusterMetadata contains information regarding the cluster that was created by installer.
+     */
     @JsonProperty("nutanix")
     public io.fabric8.openshift.api.model.installer.nutanix.v1.Metadata getNutanix() {
         return nutanix;
     }
 
+    /**
+     * ClusterMetadata contains information regarding the cluster that was created by installer.
+     */
     @JsonProperty("nutanix")
     public void setNutanix(io.fabric8.openshift.api.model.installer.nutanix.v1.Metadata nutanix) {
         this.nutanix = nutanix;
     }
 
+    /**
+     * ClusterMetadata contains information regarding the cluster that was created by installer.
+     */
     @JsonProperty("openstack")
     public io.fabric8.openshift.api.model.installer.openstack.v1.Metadata getOpenstack() {
         return openstack;
     }
 
+    /**
+     * ClusterMetadata contains information regarding the cluster that was created by installer.
+     */
     @JsonProperty("openstack")
     public void setOpenstack(io.fabric8.openshift.api.model.installer.openstack.v1.Metadata openstack) {
         this.openstack = openstack;
     }
 
+    /**
+     * ClusterMetadata contains information regarding the cluster that was created by installer.
+     */
     @JsonProperty("ovirt")
     public io.fabric8.openshift.api.model.installer.ovirt.v1.Metadata getOvirt() {
         return ovirt;
     }
 
+    /**
+     * ClusterMetadata contains information regarding the cluster that was created by installer.
+     */
     @JsonProperty("ovirt")
     public void setOvirt(io.fabric8.openshift.api.model.installer.ovirt.v1.Metadata ovirt) {
         this.ovirt = ovirt;
     }
 
+    /**
+     * ClusterMetadata contains information regarding the cluster that was created by installer.
+     */
     @JsonProperty("powervs")
     public io.fabric8.openshift.api.model.installer.powervs.v1.Metadata getPowervs() {
         return powervs;
     }
 
+    /**
+     * ClusterMetadata contains information regarding the cluster that was created by installer.
+     */
     @JsonProperty("powervs")
     public void setPowervs(io.fabric8.openshift.api.model.installer.powervs.v1.Metadata powervs) {
         this.powervs = powervs;
     }
 
+    /**
+     * ClusterMetadata contains information regarding the cluster that was created by installer.
+     */
     @JsonProperty("vsphere")
     public io.fabric8.openshift.api.model.installer.vsphere.v1.Metadata getVsphere() {
         return vsphere;
     }
 
+    /**
+     * ClusterMetadata contains information regarding the cluster that was created by installer.
+     */
     @JsonProperty("vsphere")
     public void setVsphere(io.fabric8.openshift.api.model.installer.vsphere.v1.Metadata vsphere) {
         this.vsphere = vsphere;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/ClusterNetworkEntry.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/ClusterNetworkEntry.java
index 927d5f41f00..c0751161995 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/ClusterNetworkEntry.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/ClusterNetworkEntry.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterNetworkEntry is a single IP address block for pod IP blocks. IP blocks are allocated with size 2^HostSubnetLength.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ClusterNetworkEntry(String cidr, Integer hostPrefix, Integer hostSubnetLe
         this.hostSubnetLength = hostSubnetLength;
     }
 
+    /**
+     * ClusterNetworkEntry is a single IP address block for pod IP blocks. IP blocks are allocated with size 2^HostSubnetLength.
+     */
     @JsonProperty("cidr")
     public String getCidr() {
         return cidr;
     }
 
+    /**
+     * ClusterNetworkEntry is a single IP address block for pod IP blocks. IP blocks are allocated with size 2^HostSubnetLength.
+     */
     @JsonProperty("cidr")
     public void setCidr(String cidr) {
         this.cidr = cidr;
     }
 
+    /**
+     * HostPrefix is the prefix size to allocate to each node from the CIDR. For example, 24 would allocate 2^8=256 adresses to each node. If this field is not used by the plugin, it can be left unset.
+     */
     @JsonProperty("hostPrefix")
     public Integer getHostPrefix() {
         return hostPrefix;
     }
 
+    /**
+     * HostPrefix is the prefix size to allocate to each node from the CIDR. For example, 24 would allocate 2^8=256 adresses to each node. If this field is not used by the plugin, it can be left unset.
+     */
     @JsonProperty("hostPrefix")
     public void setHostPrefix(Integer hostPrefix) {
         this.hostPrefix = hostPrefix;
     }
 
+    /**
+     * The size of blocks to allocate from the larger pool. This is the length in bits - so a 9 here will allocate a /23.
+     */
     @JsonProperty("hostSubnetLength")
     public Integer getHostSubnetLength() {
         return hostSubnetLength;
     }
 
+    /**
+     * The size of blocks to allocate from the larger pool. This is the length in bits - so a 9 here will allocate a /23.
+     */
     @JsonProperty("hostSubnetLength")
     public void setHostSubnetLength(Integer hostSubnetLength) {
         this.hostSubnetLength = hostSubnetLength;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/ClusterPlatformMetadata.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/ClusterPlatformMetadata.java
index 26c0e66139a..2b019bc3b12 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/ClusterPlatformMetadata.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/ClusterPlatformMetadata.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterPlatformMetadata contains metadata for platfrom.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -115,101 +118,161 @@ public ClusterPlatformMetadata(Metadata aws, io.fabric8.openshift.api.model.inst
         this.vsphere = vsphere;
     }
 
+    /**
+     * ClusterPlatformMetadata contains metadata for platfrom.
+     */
     @JsonProperty("aws")
     public Metadata getAws() {
         return aws;
     }
 
+    /**
+     * ClusterPlatformMetadata contains metadata for platfrom.
+     */
     @JsonProperty("aws")
     public void setAws(Metadata aws) {
         this.aws = aws;
     }
 
+    /**
+     * ClusterPlatformMetadata contains metadata for platfrom.
+     */
     @JsonProperty("azure")
     public io.fabric8.openshift.api.model.installer.azure.v1.Metadata getAzure() {
         return azure;
     }
 
+    /**
+     * ClusterPlatformMetadata contains metadata for platfrom.
+     */
     @JsonProperty("azure")
     public void setAzure(io.fabric8.openshift.api.model.installer.azure.v1.Metadata azure) {
         this.azure = azure;
     }
 
+    /**
+     * ClusterPlatformMetadata contains metadata for platfrom.
+     */
     @JsonProperty("baremetal")
     public io.fabric8.openshift.api.model.installer.baremetal.v1.Metadata getBaremetal() {
         return baremetal;
     }
 
+    /**
+     * ClusterPlatformMetadata contains metadata for platfrom.
+     */
     @JsonProperty("baremetal")
     public void setBaremetal(io.fabric8.openshift.api.model.installer.baremetal.v1.Metadata baremetal) {
         this.baremetal = baremetal;
     }
 
+    /**
+     * ClusterPlatformMetadata contains metadata for platfrom.
+     */
     @JsonProperty("gcp")
     public io.fabric8.openshift.api.model.installer.gcp.v1.Metadata getGcp() {
         return gcp;
     }
 
+    /**
+     * ClusterPlatformMetadata contains metadata for platfrom.
+     */
     @JsonProperty("gcp")
     public void setGcp(io.fabric8.openshift.api.model.installer.gcp.v1.Metadata gcp) {
         this.gcp = gcp;
     }
 
+    /**
+     * ClusterPlatformMetadata contains metadata for platfrom.
+     */
     @JsonProperty("ibmcloud")
     public io.fabric8.openshift.api.model.installer.ibmcloud.v1.Metadata getIbmcloud() {
         return ibmcloud;
     }
 
+    /**
+     * ClusterPlatformMetadata contains metadata for platfrom.
+     */
     @JsonProperty("ibmcloud")
     public void setIbmcloud(io.fabric8.openshift.api.model.installer.ibmcloud.v1.Metadata ibmcloud) {
         this.ibmcloud = ibmcloud;
     }
 
+    /**
+     * ClusterPlatformMetadata contains metadata for platfrom.
+     */
     @JsonProperty("nutanix")
     public io.fabric8.openshift.api.model.installer.nutanix.v1.Metadata getNutanix() {
         return nutanix;
     }
 
+    /**
+     * ClusterPlatformMetadata contains metadata for platfrom.
+     */
     @JsonProperty("nutanix")
     public void setNutanix(io.fabric8.openshift.api.model.installer.nutanix.v1.Metadata nutanix) {
         this.nutanix = nutanix;
     }
 
+    /**
+     * ClusterPlatformMetadata contains metadata for platfrom.
+     */
     @JsonProperty("openstack")
     public io.fabric8.openshift.api.model.installer.openstack.v1.Metadata getOpenstack() {
         return openstack;
     }
 
+    /**
+     * ClusterPlatformMetadata contains metadata for platfrom.
+     */
     @JsonProperty("openstack")
     public void setOpenstack(io.fabric8.openshift.api.model.installer.openstack.v1.Metadata openstack) {
         this.openstack = openstack;
     }
 
+    /**
+     * ClusterPlatformMetadata contains metadata for platfrom.
+     */
     @JsonProperty("ovirt")
     public io.fabric8.openshift.api.model.installer.ovirt.v1.Metadata getOvirt() {
         return ovirt;
     }
 
+    /**
+     * ClusterPlatformMetadata contains metadata for platfrom.
+     */
     @JsonProperty("ovirt")
     public void setOvirt(io.fabric8.openshift.api.model.installer.ovirt.v1.Metadata ovirt) {
         this.ovirt = ovirt;
     }
 
+    /**
+     * ClusterPlatformMetadata contains metadata for platfrom.
+     */
     @JsonProperty("powervs")
     public io.fabric8.openshift.api.model.installer.powervs.v1.Metadata getPowervs() {
         return powervs;
     }
 
+    /**
+     * ClusterPlatformMetadata contains metadata for platfrom.
+     */
     @JsonProperty("powervs")
     public void setPowervs(io.fabric8.openshift.api.model.installer.powervs.v1.Metadata powervs) {
         this.powervs = powervs;
     }
 
+    /**
+     * ClusterPlatformMetadata contains metadata for platfrom.
+     */
     @JsonProperty("vsphere")
     public io.fabric8.openshift.api.model.installer.vsphere.v1.Metadata getVsphere() {
         return vsphere;
     }
 
+    /**
+     * ClusterPlatformMetadata contains metadata for platfrom.
+     */
     @JsonProperty("vsphere")
     public void setVsphere(io.fabric8.openshift.api.model.installer.vsphere.v1.Metadata vsphere) {
         this.vsphere = vsphere;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/ClusterQuota.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/ClusterQuota.java
index 6d11ab56de1..91e21d54e36 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/ClusterQuota.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/ClusterQuota.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterQuota contains the size, in cloud quota, of the cluster that was created by installer.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,12 +85,18 @@ public ClusterQuota(List<QuotaUsage> gcp) {
         this.gcp = gcp;
     }
 
+    /**
+     * ClusterQuota contains the size, in cloud quota, of the cluster that was created by installer.
+     */
     @JsonProperty("gcp")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<QuotaUsage> getGcp() {
         return gcp;
     }
 
+    /**
+     * ClusterQuota contains the size, in cloud quota, of the cluster that was created by installer.
+     */
     @JsonProperty("gcp")
     public void setGcp(List<QuotaUsage> gcp) {
         this.gcp = gcp;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/ImageContentSource.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/ImageContentSource.java
index 16dcc6fef74..5ba61432f3d 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/ImageContentSource.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/ImageContentSource.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageContentSource defines a list of sources/repositories that can be used to pull content. The field is deprecated. Please use imageDigestSources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public ImageContentSource(List<String> mirrors, String source) {
         this.source = source;
     }
 
+    /**
+     * Mirrors is one or more repositories that may also contain the same images.
+     */
     @JsonProperty("mirrors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMirrors() {
         return mirrors;
     }
 
+    /**
+     * Mirrors is one or more repositories that may also contain the same images.
+     */
     @JsonProperty("mirrors")
     public void setMirrors(List<String> mirrors) {
         this.mirrors = mirrors;
     }
 
+    /**
+     * Source is the repository that users refer to, e.g. in image pull specifications.
+     */
     @JsonProperty("source")
     public String getSource() {
         return source;
     }
 
+    /**
+     * Source is the repository that users refer to, e.g. in image pull specifications.
+     */
     @JsonProperty("source")
     public void setSource(String source) {
         this.source = source;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/ImageDigestSource.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/ImageDigestSource.java
index 48ca3f2fc69..d0b6e07b4fd 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/ImageDigestSource.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/ImageDigestSource.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageDigestSource defines a list of sources/repositories that can be used to pull content.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public ImageDigestSource(List<String> mirrors, String source) {
         this.source = source;
     }
 
+    /**
+     * Mirrors is one or more repositories that may also contain the same images.
+     */
     @JsonProperty("mirrors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMirrors() {
         return mirrors;
     }
 
+    /**
+     * Mirrors is one or more repositories that may also contain the same images.
+     */
     @JsonProperty("mirrors")
     public void setMirrors(List<String> mirrors) {
         this.mirrors = mirrors;
     }
 
+    /**
+     * Source is the repository that users refer to, e.g. in image pull specifications.
+     */
     @JsonProperty("source")
     public String getSource() {
         return source;
     }
 
+    /**
+     * Source is the repository that users refer to, e.g. in image pull specifications.
+     */
     @JsonProperty("source")
     public void setSource(String source) {
         this.source = source;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/InstallConfig.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/InstallConfig.java
index 9d5c16e35e9..c99e9ca399c 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/InstallConfig.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/InstallConfig.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * InstallConfig is the configuration for an OpenShift install.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,9 +104,6 @@ public class InstallConfig implements Editable<InstallConfigBuilder>, HasMetadat
     private String additionalTrustBundle;
     @JsonProperty("additionalTrustBundlePolicy")
     private String additionalTrustBundlePolicy;
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "install.openshift.io/v1";
     @JsonProperty("baseDomain")
@@ -134,9 +134,6 @@ public class InstallConfig implements Editable<InstallConfigBuilder>, HasMetadat
     @JsonProperty("imageDigestSources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<ImageDigestSource> imageDigestSources = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "InstallConfig";
     @JsonProperty("metadata")
@@ -192,28 +189,40 @@ public InstallConfig(String additionalTrustBundle, String additionalTrustBundleP
         this.sshKey = sshKey;
     }
 
+    /**
+     * AdditionalTrustBundle is a PEM-encoded X.509 certificate bundle that will be added to the nodes' trusted certificate store.
+     */
     @JsonProperty("additionalTrustBundle")
     public String getAdditionalTrustBundle() {
         return additionalTrustBundle;
     }
 
+    /**
+     * AdditionalTrustBundle is a PEM-encoded X.509 certificate bundle that will be added to the nodes' trusted certificate store.
+     */
     @JsonProperty("additionalTrustBundle")
     public void setAdditionalTrustBundle(String additionalTrustBundle) {
         this.additionalTrustBundle = additionalTrustBundle;
     }
 
+    /**
+     * AdditionalTrustBundlePolicy determines when to add the AdditionalTrustBundle to the nodes' trusted certificate store. "Proxyonly" is the default. The field can be set to following specified values. "Proxyonly" : adds the AdditionalTrustBundle to nodes when http/https proxy is configured. "Always" : always adds AdditionalTrustBundle.
+     */
     @JsonProperty("additionalTrustBundlePolicy")
     public String getAdditionalTrustBundlePolicy() {
         return additionalTrustBundlePolicy;
     }
 
+    /**
+     * AdditionalTrustBundlePolicy determines when to add the AdditionalTrustBundle to the nodes' trusted certificate store. "Proxyonly" is the default. The field can be set to following specified values. "Proxyonly" : adds the AdditionalTrustBundle to nodes when http/https proxy is configured. "Always" : always adds AdditionalTrustBundle.
+     */
     @JsonProperty("additionalTrustBundlePolicy")
     public void setAdditionalTrustBundlePolicy(String additionalTrustBundlePolicy) {
         this.additionalTrustBundlePolicy = additionalTrustBundlePolicy;
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -221,139 +230,211 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * BaseDomain is the base domain to which the cluster should belong.
+     */
     @JsonProperty("baseDomain")
     public String getBaseDomain() {
         return baseDomain;
     }
 
+    /**
+     * BaseDomain is the base domain to which the cluster should belong.
+     */
     @JsonProperty("baseDomain")
     public void setBaseDomain(String baseDomain) {
         this.baseDomain = baseDomain;
     }
 
+    /**
+     * InstallConfig is the configuration for an OpenShift install.
+     */
     @JsonProperty("bootstrapInPlace")
     public BootstrapInPlace getBootstrapInPlace() {
         return bootstrapInPlace;
     }
 
+    /**
+     * InstallConfig is the configuration for an OpenShift install.
+     */
     @JsonProperty("bootstrapInPlace")
     public void setBootstrapInPlace(BootstrapInPlace bootstrapInPlace) {
         this.bootstrapInPlace = bootstrapInPlace;
     }
 
+    /**
+     * InstallConfig is the configuration for an OpenShift install.
+     */
     @JsonProperty("capabilities")
     public Capabilities getCapabilities() {
         return capabilities;
     }
 
+    /**
+     * InstallConfig is the configuration for an OpenShift install.
+     */
     @JsonProperty("capabilities")
     public void setCapabilities(Capabilities capabilities) {
         this.capabilities = capabilities;
     }
 
+    /**
+     * Compute is the configuration for the machines that comprise the compute nodes.
+     */
     @JsonProperty("compute")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MachinePool> getCompute() {
         return compute;
     }
 
+    /**
+     * Compute is the configuration for the machines that comprise the compute nodes.
+     */
     @JsonProperty("compute")
     public void setCompute(List<MachinePool> compute) {
         this.compute = compute;
     }
 
+    /**
+     * InstallConfig is the configuration for an OpenShift install.
+     */
     @JsonProperty("controlPlane")
     public MachinePool getControlPlane() {
         return controlPlane;
     }
 
+    /**
+     * InstallConfig is the configuration for an OpenShift install.
+     */
     @JsonProperty("controlPlane")
     public void setControlPlane(MachinePool controlPlane) {
         this.controlPlane = controlPlane;
     }
 
+    /**
+     * CPUPartitioning determines if a cluster should be setup for CPU workload partitioning at install time. When this field is set the cluster will be flagged for CPU Partitioning allowing users to segregate workloads to specific CPU Sets. This does not make any decisions on workloads it only configures the nodes to allow CPU Partitioning. The "AllNodes" value will setup all nodes for CPU Partitioning, the default is "None".
+     */
     @JsonProperty("cpuPartitioningMode")
     public String getCpuPartitioningMode() {
         return cpuPartitioningMode;
     }
 
+    /**
+     * CPUPartitioning determines if a cluster should be setup for CPU workload partitioning at install time. When this field is set the cluster will be flagged for CPU Partitioning allowing users to segregate workloads to specific CPU Sets. This does not make any decisions on workloads it only configures the nodes to allow CPU Partitioning. The "AllNodes" value will setup all nodes for CPU Partitioning, the default is "None".
+     */
     @JsonProperty("cpuPartitioningMode")
     public void setCpuPartitioningMode(String cpuPartitioningMode) {
         this.cpuPartitioningMode = cpuPartitioningMode;
     }
 
+    /**
+     * CredentialsMode is used to explicitly set the mode with which CredentialRequests are satisfied.<br><p> <br><p> If this field is set, then the installer will not attempt to query the cloud permissions before attempting installation. If the field is not set or empty, then the installer will perform its normal verification that the credentials provided are sufficient to perform an installation.<br><p> <br><p> There are three possible values for this field, but the valid values are dependent upon the platform being used. "Mint": create new credentials with a subset of the overall permissions for each CredentialsRequest "Passthrough": copy the credentials with all of the overall permissions for each CredentialsRequest "Manual": CredentialsRequests must be handled manually by the user<br><p> <br><p> For each of the following platforms, the field can set to the specified values. For all other platforms, the field must not be set. AWS: "Mint", "Passthrough", "Manual" Azure: "Passthrough", "Manual" AzureStack: "Manual" GCP: "Mint", "Passthrough", "Manual" IBMCloud: "Manual" PowerVS: "Manual" Nutanix: "Manual"
+     */
     @JsonProperty("credentialsMode")
     public String getCredentialsMode() {
         return credentialsMode;
     }
 
+    /**
+     * CredentialsMode is used to explicitly set the mode with which CredentialRequests are satisfied.<br><p> <br><p> If this field is set, then the installer will not attempt to query the cloud permissions before attempting installation. If the field is not set or empty, then the installer will perform its normal verification that the credentials provided are sufficient to perform an installation.<br><p> <br><p> There are three possible values for this field, but the valid values are dependent upon the platform being used. "Mint": create new credentials with a subset of the overall permissions for each CredentialsRequest "Passthrough": copy the credentials with all of the overall permissions for each CredentialsRequest "Manual": CredentialsRequests must be handled manually by the user<br><p> <br><p> For each of the following platforms, the field can set to the specified values. For all other platforms, the field must not be set. AWS: "Mint", "Passthrough", "Manual" Azure: "Passthrough", "Manual" AzureStack: "Manual" GCP: "Mint", "Passthrough", "Manual" IBMCloud: "Manual" PowerVS: "Manual" Nutanix: "Manual"
+     */
     @JsonProperty("credentialsMode")
     public void setCredentialsMode(String credentialsMode) {
         this.credentialsMode = credentialsMode;
     }
 
+    /**
+     * FeatureGates enables a set of custom feature gates. May only be used in conjunction with FeatureSet "CustomNoUpgrade". Features may be enabled or disabled by providing a true or false value for the feature gate. E.g. "featureGates": ["FeatureGate1=true", "FeatureGate2=false"].
+     */
     @JsonProperty("featureGates")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getFeatureGates() {
         return featureGates;
     }
 
+    /**
+     * FeatureGates enables a set of custom feature gates. May only be used in conjunction with FeatureSet "CustomNoUpgrade". Features may be enabled or disabled by providing a true or false value for the feature gate. E.g. "featureGates": ["FeatureGate1=true", "FeatureGate2=false"].
+     */
     @JsonProperty("featureGates")
     public void setFeatureGates(List<String> featureGates) {
         this.featureGates = featureGates;
     }
 
+    /**
+     * FeatureSet enables features that are not part of the default feature set. Valid values are "Default", "TechPreviewNoUpgrade" and "CustomNoUpgrade". When omitted, the "Default" feature set is used.
+     */
     @JsonProperty("featureSet")
     public String getFeatureSet() {
         return featureSet;
     }
 
+    /**
+     * FeatureSet enables features that are not part of the default feature set. Valid values are "Default", "TechPreviewNoUpgrade" and "CustomNoUpgrade". When omitted, the "Default" feature set is used.
+     */
     @JsonProperty("featureSet")
     public void setFeatureSet(String featureSet) {
         this.featureSet = featureSet;
     }
 
+    /**
+     * FIPS configures https://www.nist.gov/itl/fips-general-information
+     */
     @JsonProperty("fips")
     public Boolean getFips() {
         return fips;
     }
 
+    /**
+     * FIPS configures https://www.nist.gov/itl/fips-general-information
+     */
     @JsonProperty("fips")
     public void setFips(Boolean fips) {
         this.fips = fips;
     }
 
+    /**
+     * ImageContentSources lists sources/repositories for the release-image content. The field is deprecated. Please use imageDigestSources.
+     */
     @JsonProperty("imageContentSources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ImageContentSource> getImageContentSources() {
         return imageContentSources;
     }
 
+    /**
+     * ImageContentSources lists sources/repositories for the release-image content. The field is deprecated. Please use imageDigestSources.
+     */
     @JsonProperty("imageContentSources")
     public void setImageContentSources(List<ImageContentSource> imageContentSources) {
         this.imageContentSources = imageContentSources;
     }
 
+    /**
+     * ImageDigestSources lists sources/repositories for the release-image content.
+     */
     @JsonProperty("imageDigestSources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ImageDigestSource> getImageDigestSources() {
         return imageDigestSources;
     }
 
+    /**
+     * ImageDigestSources lists sources/repositories for the release-image content.
+     */
     @JsonProperty("imageDigestSources")
     public void setImageDigestSources(List<ImageDigestSource> imageDigestSources) {
         this.imageDigestSources = imageDigestSources;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -361,88 +442,136 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * InstallConfig is the configuration for an OpenShift install.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * InstallConfig is the configuration for an OpenShift install.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * InstallConfig is the configuration for an OpenShift install.
+     */
     @JsonProperty("networking")
     public Networking getNetworking() {
         return networking;
     }
 
+    /**
+     * InstallConfig is the configuration for an OpenShift install.
+     */
     @JsonProperty("networking")
     public void setNetworking(Networking networking) {
         this.networking = networking;
     }
 
+    /**
+     * InstallConfig is the configuration for an OpenShift install.
+     */
     @JsonProperty("operatorPublishingStrategy")
     public OperatorPublishingStrategy getOperatorPublishingStrategy() {
         return operatorPublishingStrategy;
     }
 
+    /**
+     * InstallConfig is the configuration for an OpenShift install.
+     */
     @JsonProperty("operatorPublishingStrategy")
     public void setOperatorPublishingStrategy(OperatorPublishingStrategy operatorPublishingStrategy) {
         this.operatorPublishingStrategy = operatorPublishingStrategy;
     }
 
+    /**
+     * InstallConfig is the configuration for an OpenShift install.
+     */
     @JsonProperty("platform")
     public Platform getPlatform() {
         return platform;
     }
 
+    /**
+     * InstallConfig is the configuration for an OpenShift install.
+     */
     @JsonProperty("platform")
     public void setPlatform(Platform platform) {
         this.platform = platform;
     }
 
+    /**
+     * InstallConfig is the configuration for an OpenShift install.
+     */
     @JsonProperty("proxy")
     public Proxy getProxy() {
         return proxy;
     }
 
+    /**
+     * InstallConfig is the configuration for an OpenShift install.
+     */
     @JsonProperty("proxy")
     public void setProxy(Proxy proxy) {
         this.proxy = proxy;
     }
 
+    /**
+     * Publish controls how the user facing endpoints of the cluster like the Kubernetes API, OpenShift routes etc. are exposed. When no strategy is specified, the strategy is "External".
+     */
     @JsonProperty("publish")
     public String getPublish() {
         return publish;
     }
 
+    /**
+     * Publish controls how the user facing endpoints of the cluster like the Kubernetes API, OpenShift routes etc. are exposed. When no strategy is specified, the strategy is "External".
+     */
     @JsonProperty("publish")
     public void setPublish(String publish) {
         this.publish = publish;
     }
 
+    /**
+     * PullSecret is the secret to use when pulling images.
+     */
     @JsonProperty("pullSecret")
     public String getPullSecret() {
         return pullSecret;
     }
 
+    /**
+     * PullSecret is the secret to use when pulling images.
+     */
     @JsonProperty("pullSecret")
     public void setPullSecret(String pullSecret) {
         this.pullSecret = pullSecret;
     }
 
+    /**
+     * SSHKey is the public Secure Shell (SSH) key to provide access to instances.
+     */
     @JsonProperty("sshKey")
     public String getSshKey() {
         return sshKey;
     }
 
+    /**
+     * SSHKey is the public Secure Shell (SSH) key to provide access to instances.
+     */
     @JsonProperty("sshKey")
     public void setSshKey(String sshKey) {
         this.sshKey = sshKey;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/MachineNetworkEntry.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/MachineNetworkEntry.java
index 0c90950333b..ea661abfdd5 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/MachineNetworkEntry.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/MachineNetworkEntry.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineNetworkEntry is a single IP address block for node IP blocks.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public MachineNetworkEntry(String cidr) {
         this.cidr = cidr;
     }
 
+    /**
+     * MachineNetworkEntry is a single IP address block for node IP blocks.
+     */
     @JsonProperty("cidr")
     public String getCidr() {
         return cidr;
     }
 
+    /**
+     * MachineNetworkEntry is a single IP address block for node IP blocks.
+     */
     @JsonProperty("cidr")
     public void setCidr(String cidr) {
         this.cidr = cidr;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/MachinePool.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/MachinePool.java
index 8bcd47cb16b..818a3df90f0 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/MachinePool.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/MachinePool.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePool is a pool of machines to be installed.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public MachinePool(String architecture, String hyperthreading, String name, Mach
         this.replicas = replicas;
     }
 
+    /**
+     * Architecture is the instruction set architecture of the machine pool. Defaults to amd64.
+     */
     @JsonProperty("architecture")
     public String getArchitecture() {
         return architecture;
     }
 
+    /**
+     * Architecture is the instruction set architecture of the machine pool. Defaults to amd64.
+     */
     @JsonProperty("architecture")
     public void setArchitecture(String architecture) {
         this.architecture = architecture;
     }
 
+    /**
+     * Hyperthreading determines the mode of hyperthreading that machines in the pool will utilize. Default is for hyperthreading to be enabled.
+     */
     @JsonProperty("hyperthreading")
     public String getHyperthreading() {
         return hyperthreading;
     }
 
+    /**
+     * Hyperthreading determines the mode of hyperthreading that machines in the pool will utilize. Default is for hyperthreading to be enabled.
+     */
     @JsonProperty("hyperthreading")
     public void setHyperthreading(String hyperthreading) {
         this.hyperthreading = hyperthreading;
     }
 
+    /**
+     * Name is the name of the machine pool. For the control plane machine pool, the name will always be "master". For the compute machine pools, the only valid name is "worker".
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the machine pool. For the control plane machine pool, the name will always be "master". For the compute machine pools, the only valid name is "worker".
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * MachinePool is a pool of machines to be installed.
+     */
     @JsonProperty("platform")
     public MachinePoolPlatform getPlatform() {
         return platform;
     }
 
+    /**
+     * MachinePool is a pool of machines to be installed.
+     */
     @JsonProperty("platform")
     public void setPlatform(MachinePoolPlatform platform) {
         this.platform = platform;
     }
 
+    /**
+     * Replicas is the machine count for the machine pool.
+     */
     @JsonProperty("replicas")
     public Long getReplicas() {
         return replicas;
     }
 
+    /**
+     * Replicas is the machine count for the machine pool.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Long replicas) {
         this.replicas = replicas;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/MachinePoolPlatform.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/MachinePoolPlatform.java
index 933618cfd9f..f23544be7ee 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/MachinePoolPlatform.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/MachinePoolPlatform.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -115,101 +118,161 @@ public MachinePoolPlatform(MachinePool aws, io.fabric8.openshift.api.model.insta
         this.vsphere = vsphere;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("aws")
     public MachinePool getAws() {
         return aws;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("aws")
     public void setAws(MachinePool aws) {
         this.aws = aws;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("azure")
     public io.fabric8.openshift.api.model.installer.azure.v1.MachinePool getAzure() {
         return azure;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("azure")
     public void setAzure(io.fabric8.openshift.api.model.installer.azure.v1.MachinePool azure) {
         this.azure = azure;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("baremetal")
     public io.fabric8.openshift.api.model.installer.baremetal.v1.MachinePool getBaremetal() {
         return baremetal;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("baremetal")
     public void setBaremetal(io.fabric8.openshift.api.model.installer.baremetal.v1.MachinePool baremetal) {
         this.baremetal = baremetal;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("gcp")
     public io.fabric8.openshift.api.model.installer.gcp.v1.MachinePool getGcp() {
         return gcp;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("gcp")
     public void setGcp(io.fabric8.openshift.api.model.installer.gcp.v1.MachinePool gcp) {
         this.gcp = gcp;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("ibmcloud")
     public io.fabric8.openshift.api.model.installer.ibmcloud.v1.MachinePool getIbmcloud() {
         return ibmcloud;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("ibmcloud")
     public void setIbmcloud(io.fabric8.openshift.api.model.installer.ibmcloud.v1.MachinePool ibmcloud) {
         this.ibmcloud = ibmcloud;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("nutanix")
     public io.fabric8.openshift.api.model.installer.nutanix.v1.MachinePool getNutanix() {
         return nutanix;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("nutanix")
     public void setNutanix(io.fabric8.openshift.api.model.installer.nutanix.v1.MachinePool nutanix) {
         this.nutanix = nutanix;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("openstack")
     public io.fabric8.openshift.api.model.installer.openstack.v1.MachinePool getOpenstack() {
         return openstack;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("openstack")
     public void setOpenstack(io.fabric8.openshift.api.model.installer.openstack.v1.MachinePool openstack) {
         this.openstack = openstack;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("ovirt")
     public io.fabric8.openshift.api.model.installer.ovirt.v1.MachinePool getOvirt() {
         return ovirt;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("ovirt")
     public void setOvirt(io.fabric8.openshift.api.model.installer.ovirt.v1.MachinePool ovirt) {
         this.ovirt = ovirt;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("powervs")
     public io.fabric8.openshift.api.model.installer.powervs.v1.MachinePool getPowervs() {
         return powervs;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("powervs")
     public void setPowervs(io.fabric8.openshift.api.model.installer.powervs.v1.MachinePool powervs) {
         this.powervs = powervs;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("vsphere")
     public io.fabric8.openshift.api.model.installer.vsphere.v1.MachinePool getVsphere() {
         return vsphere;
     }
 
+    /**
+     * MachinePoolPlatform is the platform-specific configuration for a machine pool. Only one of the platforms should be set.
+     */
     @JsonProperty("vsphere")
     public void setVsphere(io.fabric8.openshift.api.model.installer.vsphere.v1.MachinePool vsphere) {
         this.vsphere = vsphere;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/Networking.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/Networking.java
index d1191ecc2af..823127aee24 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/Networking.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/Networking.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Networking defines the pod network provider in the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -116,95 +119,149 @@ public Networking(List<ClusterNetworkEntry> clusterNetwork, Long clusterNetworkM
         this.type = type;
     }
 
+    /**
+     * ClusterNetwork is the list of IP address pools for pods. Default is 10.128.0.0/14 and a host prefix of /23.
+     */
     @JsonProperty("clusterNetwork")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ClusterNetworkEntry> getClusterNetwork() {
         return clusterNetwork;
     }
 
+    /**
+     * ClusterNetwork is the list of IP address pools for pods. Default is 10.128.0.0/14 and a host prefix of /23.
+     */
     @JsonProperty("clusterNetwork")
     public void setClusterNetwork(List<ClusterNetworkEntry> clusterNetwork) {
         this.clusterNetwork = clusterNetwork;
     }
 
+    /**
+     * ClusterNetworkMTU is the Maximum Transmit (MTU) Unit size in bytes to allocate to the cluster network. For example, 1200 would set the MTU of the entire overlay network. If the deployment does not require changes in the network plugin, leave it unset and the MTU will be calculated automatically based on the host network MTU.
+     */
     @JsonProperty("clusterNetworkMTU")
     public Long getClusterNetworkMTU() {
         return clusterNetworkMTU;
     }
 
+    /**
+     * ClusterNetworkMTU is the Maximum Transmit (MTU) Unit size in bytes to allocate to the cluster network. For example, 1200 would set the MTU of the entire overlay network. If the deployment does not require changes in the network plugin, leave it unset and the MTU will be calculated automatically based on the host network MTU.
+     */
     @JsonProperty("clusterNetworkMTU")
     public void setClusterNetworkMTU(Long clusterNetworkMTU) {
         this.clusterNetworkMTU = clusterNetworkMTU;
     }
 
+    /**
+     * Deprecated name for ClusterNetwork
+     */
     @JsonProperty("clusterNetworks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ClusterNetworkEntry> getClusterNetworks() {
         return clusterNetworkList;
     }
 
+    /**
+     * Deprecated name for ClusterNetwork
+     */
     @JsonProperty("clusterNetworks")
     public void setClusterNetworks(List<ClusterNetworkEntry> clusterNetworkList) {
         this.clusterNetworkList = clusterNetworkList;
     }
 
+    /**
+     * Networking defines the pod network provider in the cluster.
+     */
     @JsonProperty("machineCIDR")
     public String getMachineCIDR() {
         return machineCIDR;
     }
 
+    /**
+     * Networking defines the pod network provider in the cluster.
+     */
     @JsonProperty("machineCIDR")
     public void setMachineCIDR(String machineCIDR) {
         this.machineCIDR = machineCIDR;
     }
 
+    /**
+     * MachineNetwork is the list of IP address pools for machines. This field replaces MachineCIDR, and if set MachineCIDR must be empty or match the first entry in the list. Default is 10.0.0.0/16 for all platforms other than Power VS. For Power VS, the default is 192.168.0.0/24.
+     */
     @JsonProperty("machineNetwork")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MachineNetworkEntry> getMachineNetwork() {
         return machineNetwork;
     }
 
+    /**
+     * MachineNetwork is the list of IP address pools for machines. This field replaces MachineCIDR, and if set MachineCIDR must be empty or match the first entry in the list. Default is 10.0.0.0/16 for all platforms other than Power VS. For Power VS, the default is 192.168.0.0/24.
+     */
     @JsonProperty("machineNetwork")
     public void setMachineNetwork(List<MachineNetworkEntry> machineNetwork) {
         this.machineNetwork = machineNetwork;
     }
 
+    /**
+     * NetworkType is the type of network to install. The default value is OVNKubernetes.
+     */
     @JsonProperty("networkType")
     public String getNetworkType() {
         return networkType;
     }
 
+    /**
+     * NetworkType is the type of network to install. The default value is OVNKubernetes.
+     */
     @JsonProperty("networkType")
     public void setNetworkType(String networkType) {
         this.networkType = networkType;
     }
 
+    /**
+     * Networking defines the pod network provider in the cluster.
+     */
     @JsonProperty("serviceCIDR")
     public String getServiceCIDR() {
         return serviceCIDR;
     }
 
+    /**
+     * Networking defines the pod network provider in the cluster.
+     */
     @JsonProperty("serviceCIDR")
     public void setServiceCIDR(String serviceCIDR) {
         this.serviceCIDR = serviceCIDR;
     }
 
+    /**
+     * ServiceNetwork is the list of IP address pools for services. Default is 172.30.0.0/16. NOTE: currently only one entry is supported.
+     */
     @JsonProperty("serviceNetwork")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getServiceNetwork() {
         return serviceNetwork;
     }
 
+    /**
+     * ServiceNetwork is the list of IP address pools for services. Default is 172.30.0.0/16. NOTE: currently only one entry is supported.
+     */
     @JsonProperty("serviceNetwork")
     public void setServiceNetwork(List<String> serviceNetwork) {
         this.serviceNetwork = serviceNetwork;
     }
 
+    /**
+     * Deprecated name for NetworkType
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Deprecated name for NetworkType
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/OperatorPublishingStrategy.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/OperatorPublishingStrategy.java
index 878610e2f7c..53c2a2dc350 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/OperatorPublishingStrategy.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/OperatorPublishingStrategy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorPublishingStrategy is used to control the visibility of the components which can be used to have a mix of public and private resources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public OperatorPublishingStrategy(String apiserver, String ingress) {
         this.ingress = ingress;
     }
 
+    /**
+     * APIServer sets the visibility of the load balancers servicing the APIserver.
+     */
     @JsonProperty("apiserver")
     public String getApiserver() {
         return apiserver;
     }
 
+    /**
+     * APIServer sets the visibility of the load balancers servicing the APIserver.
+     */
     @JsonProperty("apiserver")
     public void setApiserver(String apiserver) {
         this.apiserver = apiserver;
     }
 
+    /**
+     * Ingress sets the visibility of the created dns resources.
+     */
     @JsonProperty("ingress")
     public String getIngress() {
         return ingress;
     }
 
+    /**
+     * Ingress sets the visibility of the created dns resources.
+     */
     @JsonProperty("ingress")
     public void setIngress(String ingress) {
         this.ingress = ingress;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/Platform.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/Platform.java
index 8a67fec50fe..ab3089273d1 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/Platform.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/Platform.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -122,121 +125,193 @@ public Platform(io.fabric8.openshift.api.model.installer.aws.v1.Platform aws, io
         this.vsphere = vsphere;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("aws")
     public io.fabric8.openshift.api.model.installer.aws.v1.Platform getAws() {
         return aws;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("aws")
     public void setAws(io.fabric8.openshift.api.model.installer.aws.v1.Platform aws) {
         this.aws = aws;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("azure")
     public io.fabric8.openshift.api.model.installer.azure.v1.Platform getAzure() {
         return azure;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("azure")
     public void setAzure(io.fabric8.openshift.api.model.installer.azure.v1.Platform azure) {
         this.azure = azure;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("baremetal")
     public io.fabric8.openshift.api.model.installer.baremetal.v1.Platform getBaremetal() {
         return baremetal;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("baremetal")
     public void setBaremetal(io.fabric8.openshift.api.model.installer.baremetal.v1.Platform baremetal) {
         this.baremetal = baremetal;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("external")
     public io.fabric8.openshift.api.model.installer.external.v1.Platform getExternal() {
         return external;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("external")
     public void setExternal(io.fabric8.openshift.api.model.installer.external.v1.Platform external) {
         this.external = external;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("gcp")
     public io.fabric8.openshift.api.model.installer.gcp.v1.Platform getGcp() {
         return gcp;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("gcp")
     public void setGcp(io.fabric8.openshift.api.model.installer.gcp.v1.Platform gcp) {
         this.gcp = gcp;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("ibmcloud")
     public io.fabric8.openshift.api.model.installer.ibmcloud.v1.Platform getIbmcloud() {
         return ibmcloud;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("ibmcloud")
     public void setIbmcloud(io.fabric8.openshift.api.model.installer.ibmcloud.v1.Platform ibmcloud) {
         this.ibmcloud = ibmcloud;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("none")
     public io.fabric8.openshift.api.model.installer.none.v1.Platform getNone() {
         return none;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("none")
     public void setNone(io.fabric8.openshift.api.model.installer.none.v1.Platform none) {
         this.none = none;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("nutanix")
     public io.fabric8.openshift.api.model.installer.nutanix.v1.Platform getNutanix() {
         return nutanix;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("nutanix")
     public void setNutanix(io.fabric8.openshift.api.model.installer.nutanix.v1.Platform nutanix) {
         this.nutanix = nutanix;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("openstack")
     public io.fabric8.openshift.api.model.installer.openstack.v1.Platform getOpenstack() {
         return openstack;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("openstack")
     public void setOpenstack(io.fabric8.openshift.api.model.installer.openstack.v1.Platform openstack) {
         this.openstack = openstack;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("ovirt")
     public io.fabric8.openshift.api.model.installer.ovirt.v1.Platform getOvirt() {
         return ovirt;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("ovirt")
     public void setOvirt(io.fabric8.openshift.api.model.installer.ovirt.v1.Platform ovirt) {
         this.ovirt = ovirt;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("powervs")
     public io.fabric8.openshift.api.model.installer.powervs.v1.Platform getPowervs() {
         return powervs;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("powervs")
     public void setPowervs(io.fabric8.openshift.api.model.installer.powervs.v1.Platform powervs) {
         this.powervs = powervs;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("vsphere")
     public io.fabric8.openshift.api.model.installer.vsphere.v1.Platform getVsphere() {
         return vsphere;
     }
 
+    /**
+     * Platform is the configuration for the specific platform upon which to perform the installation. Only one of the platform configuration should be set.
+     */
     @JsonProperty("vsphere")
     public void setVsphere(io.fabric8.openshift.api.model.installer.vsphere.v1.Platform vsphere) {
         this.vsphere = vsphere;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/Proxy.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/Proxy.java
index be37c89beba..69851be8d83 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/Proxy.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/v1/Proxy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Proxy defines the proxy settings for the cluster. At least one of HTTPProxy or HTTPSProxy is required.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public Proxy(String httpProxy, String httpsProxy, String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * HTTPProxy is the URL of the proxy for HTTP requests.
+     */
     @JsonProperty("httpProxy")
     public String getHttpProxy() {
         return httpProxy;
     }
 
+    /**
+     * HTTPProxy is the URL of the proxy for HTTP requests.
+     */
     @JsonProperty("httpProxy")
     public void setHttpProxy(String httpProxy) {
         this.httpProxy = httpProxy;
     }
 
+    /**
+     * HTTPSProxy is the URL of the proxy for HTTPS requests.
+     */
     @JsonProperty("httpsProxy")
     public String getHttpsProxy() {
         return httpsProxy;
     }
 
+    /**
+     * HTTPSProxy is the URL of the proxy for HTTPS requests.
+     */
     @JsonProperty("httpsProxy")
     public void setHttpsProxy(String httpsProxy) {
         this.httpsProxy = httpsProxy;
     }
 
+    /**
+     * NoProxy is a comma-separated list of domains and CIDRs for which the proxy should not be used.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * NoProxy is a comma-separated list of domains and CIDRs for which the proxy should not be used.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/FailureDomain.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/FailureDomain.java
index 1a0c31ed031..bf994623561 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/FailureDomain.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/FailureDomain.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FailureDomain holds the region and zone failure domain and the vCenter topology of that failure domain.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public FailureDomain(String name, String region, String server, Topology topolog
         this.zone = zone;
     }
 
+    /**
+     * name defines the name of the FailureDomain This name is arbitrary but will be used in VSpherePlatformDeploymentZone for association.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name defines the name of the FailureDomain This name is arbitrary but will be used in VSpherePlatformDeploymentZone for association.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * region defines a FailureDomainCoordinate which includes the name of the vCenter tag, the failure domain type and the name of the vCenter tag category.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * region defines a FailureDomainCoordinate which includes the name of the vCenter tag, the failure domain type and the name of the vCenter tag category.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * server is the fully-qualified domain name or the IP address of the vCenter server.
+     */
     @JsonProperty("server")
     public String getServer() {
         return server;
     }
 
+    /**
+     * server is the fully-qualified domain name or the IP address of the vCenter server.
+     */
     @JsonProperty("server")
     public void setServer(String server) {
         this.server = server;
     }
 
+    /**
+     * FailureDomain holds the region and zone failure domain and the vCenter topology of that failure domain.
+     */
     @JsonProperty("topology")
     public Topology getTopology() {
         return topology;
     }
 
+    /**
+     * FailureDomain holds the region and zone failure domain and the vCenter topology of that failure domain.
+     */
     @JsonProperty("topology")
     public void setTopology(Topology topology) {
         this.topology = topology;
     }
 
+    /**
+     * zone defines a VSpherePlatformFailureDomain which includes the name of the vCenter tag, the failure domain type and the name of the vCenter tag category.
+     */
     @JsonProperty("zone")
     public String getZone() {
         return zone;
     }
 
+    /**
+     * zone defines a VSpherePlatformFailureDomain which includes the name of the vCenter tag, the failure domain type and the name of the vCenter tag category.
+     */
     @JsonProperty("zone")
     public void setZone(String zone) {
         this.zone = zone;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/Host.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/Host.java
index efa8830225b..402f9f07886 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/Host.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/Host.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Host defines host VMs to generate as part of the installation.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public Host(String failureDomain, NetworkDeviceSpec networkDevice, String role)
         this.role = role;
     }
 
+    /**
+     * FailureDomain refers to the name of a FailureDomain as described in https://github.com/openshift/enhancements/blob/master/enhancements/installer/vsphere-ipi-zonal.md
+     */
     @JsonProperty("failureDomain")
     public String getFailureDomain() {
         return failureDomain;
     }
 
+    /**
+     * FailureDomain refers to the name of a FailureDomain as described in https://github.com/openshift/enhancements/blob/master/enhancements/installer/vsphere-ipi-zonal.md
+     */
     @JsonProperty("failureDomain")
     public void setFailureDomain(String failureDomain) {
         this.failureDomain = failureDomain;
     }
 
+    /**
+     * Host defines host VMs to generate as part of the installation.
+     */
     @JsonProperty("networkDevice")
     public NetworkDeviceSpec getNetworkDevice() {
         return networkDevice;
     }
 
+    /**
+     * Host defines host VMs to generate as part of the installation.
+     */
     @JsonProperty("networkDevice")
     public void setNetworkDevice(NetworkDeviceSpec networkDevice) {
         this.networkDevice = networkDevice;
     }
 
+    /**
+     * Role defines the role of the node
+     */
     @JsonProperty("role")
     public String getRole() {
         return role;
     }
 
+    /**
+     * Role defines the role of the node
+     */
     @JsonProperty("role")
     public void setRole(String role) {
         this.role = role;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/MachinePool.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/MachinePool.java
index c3e22892bfa..754e8244406 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/MachinePool.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/MachinePool.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachinePool stores the configuration for a machine pool installed on vSphere.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -97,52 +100,82 @@ public MachinePool(Integer coresPerSocket, Integer cpus, Long memoryMB, OSDisk o
         this.zones = zones;
     }
 
+    /**
+     * NumCoresPerSocket is the number of cores per socket in a vm. The number of vCPUs on the vm will be NumCPUs/NumCoresPerSocket.
+     */
     @JsonProperty("coresPerSocket")
     public Integer getCoresPerSocket() {
         return coresPerSocket;
     }
 
+    /**
+     * NumCoresPerSocket is the number of cores per socket in a vm. The number of vCPUs on the vm will be NumCPUs/NumCoresPerSocket.
+     */
     @JsonProperty("coresPerSocket")
     public void setCoresPerSocket(Integer coresPerSocket) {
         this.coresPerSocket = coresPerSocket;
     }
 
+    /**
+     * NumCPUs is the total number of virtual processor cores to assign a vm.
+     */
     @JsonProperty("cpus")
     public Integer getCpus() {
         return cpus;
     }
 
+    /**
+     * NumCPUs is the total number of virtual processor cores to assign a vm.
+     */
     @JsonProperty("cpus")
     public void setCpus(Integer cpus) {
         this.cpus = cpus;
     }
 
+    /**
+     * Memory is the size of a VM's memory in MB.
+     */
     @JsonProperty("memoryMB")
     public Long getMemoryMB() {
         return memoryMB;
     }
 
+    /**
+     * Memory is the size of a VM's memory in MB.
+     */
     @JsonProperty("memoryMB")
     public void setMemoryMB(Long memoryMB) {
         this.memoryMB = memoryMB;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on vSphere.
+     */
     @JsonProperty("osDisk")
     public OSDisk getOsDisk() {
         return osDisk;
     }
 
+    /**
+     * MachinePool stores the configuration for a machine pool installed on vSphere.
+     */
     @JsonProperty("osDisk")
     public void setOsDisk(OSDisk osDisk) {
         this.osDisk = osDisk;
     }
 
+    /**
+     * Zones defines available zones Zones is available in TechPreview.
+     */
     @JsonProperty("zones")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getZones() {
         return zones;
     }
 
+    /**
+     * Zones defines available zones Zones is available in TechPreview.
+     */
     @JsonProperty("zones")
     public void setZones(List<String> zones) {
         this.zones = zones;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/Metadata.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/Metadata.java
index 8710b5d61b7..f9c7ca6bfd0 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/Metadata.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/Metadata.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metadata contains vSphere metadata (e.g. for uninstalling the cluster).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -97,52 +100,82 @@ public Metadata(List<VCenters> vCenters, String password, String terraformPlatfo
         this.vCenter = vCenter;
     }
 
+    /**
+     * VCenters collection of vcenters when multi vcenter support is enabled
+     */
     @JsonProperty("VCenters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VCenters> getVCenters() {
         return vCenters;
     }
 
+    /**
+     * VCenters collection of vcenters when multi vcenter support is enabled
+     */
     @JsonProperty("VCenters")
     public void setVCenters(List<VCenters> vCenters) {
         this.vCenters = vCenters;
     }
 
+    /**
+     * Password is the password for the user to use to connect to the vCenter.
+     */
     @JsonProperty("password")
     public String getPassword() {
         return password;
     }
 
+    /**
+     * Password is the password for the user to use to connect to the vCenter.
+     */
     @JsonProperty("password")
     public void setPassword(String password) {
         this.password = password;
     }
 
+    /**
+     * TerraformPlatform is the type...
+     */
     @JsonProperty("terraform_platform")
     public String getTerraformPlatform() {
         return terraformPlatform;
     }
 
+    /**
+     * TerraformPlatform is the type...
+     */
     @JsonProperty("terraform_platform")
     public void setTerraformPlatform(String terraformPlatform) {
         this.terraformPlatform = terraformPlatform;
     }
 
+    /**
+     * Username is the name of the user to use to connect to the vCenter.
+     */
     @JsonProperty("username")
     public String getUsername() {
         return username;
     }
 
+    /**
+     * Username is the name of the user to use to connect to the vCenter.
+     */
     @JsonProperty("username")
     public void setUsername(String username) {
         this.username = username;
     }
 
+    /**
+     * VCenter is the domain name or IP address of the vCenter.
+     */
     @JsonProperty("vCenter")
     public String getVCenter() {
         return vCenter;
     }
 
+    /**
+     * VCenter is the domain name or IP address of the vCenter.
+     */
     @JsonProperty("vCenter")
     public void setVCenter(String vCenter) {
         this.vCenter = vCenter;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/NetworkDeviceSpec.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/NetworkDeviceSpec.java
index aed4c23c03d..0aea4c08c3c 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/NetworkDeviceSpec.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/NetworkDeviceSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkDeviceSpec defines network config for static IP assignment.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public NetworkDeviceSpec(String gateway, List<String> ipAddrs, List<String> name
         this.nameservers = nameservers;
     }
 
+    /**
+     * gateway is an IPv4 or IPv6 address which represents the subnet gateway, for example, 192.168.1.1.
+     */
     @JsonProperty("gateway")
     public String getGateway() {
         return gateway;
     }
 
+    /**
+     * gateway is an IPv4 or IPv6 address which represents the subnet gateway, for example, 192.168.1.1.
+     */
     @JsonProperty("gateway")
     public void setGateway(String gateway) {
         this.gateway = gateway;
     }
 
+    /**
+     * ipAddrs is a list of one or more IPv4 and/or IPv6 addresses and CIDR to assign to this device, for example, 192.168.1.100/24. IP addresses provided via ipAddrs are intended to allow explicit assignment of a machine's IP address.
+     */
     @JsonProperty("ipAddrs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIpAddrs() {
         return ipAddrs;
     }
 
+    /**
+     * ipAddrs is a list of one or more IPv4 and/or IPv6 addresses and CIDR to assign to this device, for example, 192.168.1.100/24. IP addresses provided via ipAddrs are intended to allow explicit assignment of a machine's IP address.
+     */
     @JsonProperty("ipAddrs")
     public void setIpAddrs(List<String> ipAddrs) {
         this.ipAddrs = ipAddrs;
     }
 
+    /**
+     * nameservers is a list of IPv4 and/or IPv6 addresses used as DNS nameservers, for example, 8.8.8.8. a nameserver is not provided by a fulfilled IPAddressClaim. If DHCP is not the source of IP addresses for this network device, nameservers should include a valid nameserver.
+     */
     @JsonProperty("nameservers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNameservers() {
         return nameservers;
     }
 
+    /**
+     * nameservers is a list of IPv4 and/or IPv6 addresses used as DNS nameservers, for example, 8.8.8.8. a nameserver is not provided by a fulfilled IPAddressClaim. If DHCP is not the source of IP addresses for this network device, nameservers should include a valid nameserver.
+     */
     @JsonProperty("nameservers")
     public void setNameservers(List<String> nameservers) {
         this.nameservers = nameservers;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/OSDisk.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/OSDisk.java
index a44c931a394..2249c6138f5 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/OSDisk.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/OSDisk.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OSDisk defines the disk for a virtual machine.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public OSDisk(Integer diskSizeGB) {
         this.diskSizeGB = diskSizeGB;
     }
 
+    /**
+     * DiskSizeGB defines the size of disk in GB.
+     */
     @JsonProperty("diskSizeGB")
     public Integer getDiskSizeGB() {
         return diskSizeGB;
     }
 
+    /**
+     * DiskSizeGB defines the size of disk in GB.
+     */
     @JsonProperty("diskSizeGB")
     public void setDiskSizeGB(Integer diskSizeGB) {
         this.diskSizeGB = diskSizeGB;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/Platform.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/Platform.java
index d051972f61c..abdcac0da2f 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/Platform.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/Platform.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Platform stores any global configuration used for vsphere platforms.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -167,216 +170,342 @@ public Platform(String apiVIP, List<String> apiVIPs, String cluster, String clus
         this.vcenters = vcenters;
     }
 
+    /**
+     * DeprecatedAPIVIP is the virtual IP address for the api endpoint Deprecated: Use APIVIPs
+     */
     @JsonProperty("apiVIP")
     public String getApiVIP() {
         return apiVIP;
     }
 
+    /**
+     * DeprecatedAPIVIP is the virtual IP address for the api endpoint Deprecated: Use APIVIPs
+     */
     @JsonProperty("apiVIP")
     public void setApiVIP(String apiVIP) {
         this.apiVIP = apiVIP;
     }
 
+    /**
+     * APIVIPs contains the VIP(s) for the api endpoint. In dual stack clusters it contains an IPv4 and IPv6 address, otherwise only one VIP
+     */
     @JsonProperty("apiVIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiVIPs() {
         return apiVIPs;
     }
 
+    /**
+     * APIVIPs contains the VIP(s) for the api endpoint. In dual stack clusters it contains an IPv4 and IPv6 address, otherwise only one VIP
+     */
     @JsonProperty("apiVIPs")
     public void setApiVIPs(List<String> apiVIPs) {
         this.apiVIPs = apiVIPs;
     }
 
+    /**
+     * Cluster is the name of the cluster virtual machines will be cloned into. Deprecated: Use FailureDomains.Topology.Cluster
+     */
     @JsonProperty("cluster")
     public String getCluster() {
         return cluster;
     }
 
+    /**
+     * Cluster is the name of the cluster virtual machines will be cloned into. Deprecated: Use FailureDomains.Topology.Cluster
+     */
     @JsonProperty("cluster")
     public void setCluster(String cluster) {
         this.cluster = cluster;
     }
 
+    /**
+     * ClusterOSImage overrides the url provided in rhcos.json to download the RHCOS OVA
+     */
     @JsonProperty("clusterOSImage")
     public String getClusterOSImage() {
         return clusterOSImage;
     }
 
+    /**
+     * ClusterOSImage overrides the url provided in rhcos.json to download the RHCOS OVA
+     */
     @JsonProperty("clusterOSImage")
     public void setClusterOSImage(String clusterOSImage) {
         this.clusterOSImage = clusterOSImage;
     }
 
+    /**
+     * Datacenter is the name of the datacenter to use in the vCenter. Deprecated: Use FailureDomains.Topology.Datacenter
+     */
     @JsonProperty("datacenter")
     public String getDatacenter() {
         return datacenter;
     }
 
+    /**
+     * Datacenter is the name of the datacenter to use in the vCenter. Deprecated: Use FailureDomains.Topology.Datacenter
+     */
     @JsonProperty("datacenter")
     public void setDatacenter(String datacenter) {
         this.datacenter = datacenter;
     }
 
+    /**
+     * DefaultDatastore is the default datastore to use for provisioning volumes. Deprecated: Use FailureDomains.Topology.Datastore
+     */
     @JsonProperty("defaultDatastore")
     public String getDefaultDatastore() {
         return defaultDatastore;
     }
 
+    /**
+     * DefaultDatastore is the default datastore to use for provisioning volumes. Deprecated: Use FailureDomains.Topology.Datastore
+     */
     @JsonProperty("defaultDatastore")
     public void setDefaultDatastore(String defaultDatastore) {
         this.defaultDatastore = defaultDatastore;
     }
 
+    /**
+     * Platform stores any global configuration used for vsphere platforms.
+     */
     @JsonProperty("defaultMachinePlatform")
     public MachinePool getDefaultMachinePlatform() {
         return defaultMachinePlatform;
     }
 
+    /**
+     * Platform stores any global configuration used for vsphere platforms.
+     */
     @JsonProperty("defaultMachinePlatform")
     public void setDefaultMachinePlatform(MachinePool defaultMachinePlatform) {
         this.defaultMachinePlatform = defaultMachinePlatform;
     }
 
+    /**
+     * DiskType is the name of the disk provisioning type, valid values are thin, thick, and eagerZeroedThick. When not specified, it will be set according to the default storage policy of vsphere.
+     */
     @JsonProperty("diskType")
     public String getDiskType() {
         return diskType;
     }
 
+    /**
+     * DiskType is the name of the disk provisioning type, valid values are thin, thick, and eagerZeroedThick. When not specified, it will be set according to the default storage policy of vsphere.
+     */
     @JsonProperty("diskType")
     public void setDiskType(String diskType) {
         this.diskType = diskType;
     }
 
+    /**
+     * FailureDomains holds the VSpherePlatformFailureDomainSpec which contains the definition of region, zone and the vCenter topology. If this is omitted failure domains (regions and zones) will not be used.
+     */
     @JsonProperty("failureDomains")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<FailureDomain> getFailureDomains() {
         return failureDomains;
     }
 
+    /**
+     * FailureDomains holds the VSpherePlatformFailureDomainSpec which contains the definition of region, zone and the vCenter topology. If this is omitted failure domains (regions and zones) will not be used.
+     */
     @JsonProperty("failureDomains")
     public void setFailureDomains(List<FailureDomain> failureDomains) {
         this.failureDomains = failureDomains;
     }
 
+    /**
+     * Folder is the absolute path of the folder that will be used and/or created for virtual machines. The absolute path is of the form /&lt;datacenter&gt;/vm/&lt;folder&gt;/&lt;subfolder&gt;. Deprecated: Use FailureDomains.Topology.Folder
+     */
     @JsonProperty("folder")
     public String getFolder() {
         return folder;
     }
 
+    /**
+     * Folder is the absolute path of the folder that will be used and/or created for virtual machines. The absolute path is of the form /&lt;datacenter&gt;/vm/&lt;folder&gt;/&lt;subfolder&gt;. Deprecated: Use FailureDomains.Topology.Folder
+     */
     @JsonProperty("folder")
     public void setFolder(String folder) {
         this.folder = folder;
     }
 
+    /**
+     * Hosts defines network configurations to be applied by the installer. Hosts is available in TechPreview.
+     */
     @JsonProperty("hosts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Host> getHosts() {
         return hosts;
     }
 
+    /**
+     * Hosts defines network configurations to be applied by the installer. Hosts is available in TechPreview.
+     */
     @JsonProperty("hosts")
     public void setHosts(List<Host> hosts) {
         this.hosts = hosts;
     }
 
+    /**
+     * DeprecatedIngressVIP is the virtual IP address for ingress Deprecated: Use IngressVIPs
+     */
     @JsonProperty("ingressVIP")
     public String getIngressVIP() {
         return ingressVIP;
     }
 
+    /**
+     * DeprecatedIngressVIP is the virtual IP address for ingress Deprecated: Use IngressVIPs
+     */
     @JsonProperty("ingressVIP")
     public void setIngressVIP(String ingressVIP) {
         this.ingressVIP = ingressVIP;
     }
 
+    /**
+     * IngressVIPs contains the VIP(s) for ingress. In dual stack clusters it contains an IPv4 and IPv6 address, otherwise only one VIP
+     */
     @JsonProperty("ingressVIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIngressVIPs() {
         return ingressVIPs;
     }
 
+    /**
+     * IngressVIPs contains the VIP(s) for ingress. In dual stack clusters it contains an IPv4 and IPv6 address, otherwise only one VIP
+     */
     @JsonProperty("ingressVIPs")
     public void setIngressVIPs(List<String> ingressVIPs) {
         this.ingressVIPs = ingressVIPs;
     }
 
+    /**
+     * Platform stores any global configuration used for vsphere platforms.
+     */
     @JsonProperty("loadBalancer")
     public VSpherePlatformLoadBalancer getLoadBalancer() {
         return loadBalancer;
     }
 
+    /**
+     * Platform stores any global configuration used for vsphere platforms.
+     */
     @JsonProperty("loadBalancer")
     public void setLoadBalancer(VSpherePlatformLoadBalancer loadBalancer) {
         this.loadBalancer = loadBalancer;
     }
 
+    /**
+     * Network specifies the name of the network to be used by the cluster. Deprecated: Use FailureDomains.Topology.Network
+     */
     @JsonProperty("network")
     public String getNetwork() {
         return network;
     }
 
+    /**
+     * Network specifies the name of the network to be used by the cluster. Deprecated: Use FailureDomains.Topology.Network
+     */
     @JsonProperty("network")
     public void setNetwork(String network) {
         this.network = network;
     }
 
+    /**
+     * Platform stores any global configuration used for vsphere platforms.
+     */
     @JsonProperty("nodeNetworking")
     public VSpherePlatformNodeNetworking getNodeNetworking() {
         return nodeNetworking;
     }
 
+    /**
+     * Platform stores any global configuration used for vsphere platforms.
+     */
     @JsonProperty("nodeNetworking")
     public void setNodeNetworking(VSpherePlatformNodeNetworking nodeNetworking) {
         this.nodeNetworking = nodeNetworking;
     }
 
+    /**
+     * Password is the password for the user to use to connect to the vCenter. Deprecated: Use VCenters.Password
+     */
     @JsonProperty("password")
     public String getPassword() {
         return password;
     }
 
+    /**
+     * Password is the password for the user to use to connect to the vCenter. Deprecated: Use VCenters.Password
+     */
     @JsonProperty("password")
     public void setPassword(String password) {
         this.password = password;
     }
 
+    /**
+     * ResourcePool is the absolute path of the resource pool where virtual machines will be created. The absolute path is of the form /&lt;datacenter&gt;/host/&lt;cluster&gt;/Resources/&lt;resourcepool&gt;. Deprecated: Use FailureDomains.Topology.ResourcePool
+     */
     @JsonProperty("resourcePool")
     public String getResourcePool() {
         return resourcePool;
     }
 
+    /**
+     * ResourcePool is the absolute path of the resource pool where virtual machines will be created. The absolute path is of the form /&lt;datacenter&gt;/host/&lt;cluster&gt;/Resources/&lt;resourcepool&gt;. Deprecated: Use FailureDomains.Topology.ResourcePool
+     */
     @JsonProperty("resourcePool")
     public void setResourcePool(String resourcePool) {
         this.resourcePool = resourcePool;
     }
 
+    /**
+     * Username is the name of the user to use to connect to the vCenter. Deprecated: Use VCenters.Username
+     */
     @JsonProperty("username")
     public String getUsername() {
         return username;
     }
 
+    /**
+     * Username is the name of the user to use to connect to the vCenter. Deprecated: Use VCenters.Username
+     */
     @JsonProperty("username")
     public void setUsername(String username) {
         this.username = username;
     }
 
+    /**
+     * VCenter is the domain name or IP address of the vCenter. Deprecated: Use VCenters.Server
+     */
     @JsonProperty("vCenter")
     public String getVCenter() {
         return vCenter;
     }
 
+    /**
+     * VCenter is the domain name or IP address of the vCenter. Deprecated: Use VCenters.Server
+     */
     @JsonProperty("vCenter")
     public void setVCenter(String vCenter) {
         this.vCenter = vCenter;
     }
 
+    /**
+     * VCenters holds the connection details for services to communicate with vCenter. Currently only a single vCenter is supported.
+     */
     @JsonProperty("vcenters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VCenter> getVcenters() {
         return vcenters;
     }
 
+    /**
+     * VCenters holds the connection details for services to communicate with vCenter. Currently only a single vCenter is supported.
+     */
     @JsonProperty("vcenters")
     public void setVcenters(List<VCenter> vcenters) {
         this.vcenters = vcenters;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/Topology.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/Topology.java
index ed25850835a..7327f7494f9 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/Topology.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/Topology.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Topology holds the required and optional vCenter objects - datacenter, computeCluster, networks, datastore and resourcePool - to provision virtual machines.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -110,83 +113,131 @@ public Topology(String computeCluster, String datacenter, String datastore, Stri
         this.template = template;
     }
 
+    /**
+     * computeCluster as the failure domain This is required to be a path
+     */
     @JsonProperty("computeCluster")
     public String getComputeCluster() {
         return computeCluster;
     }
 
+    /**
+     * computeCluster as the failure domain This is required to be a path
+     */
     @JsonProperty("computeCluster")
     public void setComputeCluster(String computeCluster) {
         this.computeCluster = computeCluster;
     }
 
+    /**
+     * datacenter is the vCenter datacenter in which virtual machines will be located and defined as the failure domain.
+     */
     @JsonProperty("datacenter")
     public String getDatacenter() {
         return datacenter;
     }
 
+    /**
+     * datacenter is the vCenter datacenter in which virtual machines will be located and defined as the failure domain.
+     */
     @JsonProperty("datacenter")
     public void setDatacenter(String datacenter) {
         this.datacenter = datacenter;
     }
 
+    /**
+     * datastore is the name or inventory path of the datastore in which the virtual machine is created/located.
+     */
     @JsonProperty("datastore")
     public String getDatastore() {
         return datastore;
     }
 
+    /**
+     * datastore is the name or inventory path of the datastore in which the virtual machine is created/located.
+     */
     @JsonProperty("datastore")
     public void setDatastore(String datastore) {
         this.datastore = datastore;
     }
 
+    /**
+     * folder is the inventory path of the folder in which the virtual machine is created/located.
+     */
     @JsonProperty("folder")
     public String getFolder() {
         return folder;
     }
 
+    /**
+     * folder is the inventory path of the folder in which the virtual machine is created/located.
+     */
     @JsonProperty("folder")
     public void setFolder(String folder) {
         this.folder = folder;
     }
 
+    /**
+     * networks is the list of networks within this failure domain
+     */
     @JsonProperty("networks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNetworks() {
         return networks;
     }
 
+    /**
+     * networks is the list of networks within this failure domain
+     */
     @JsonProperty("networks")
     public void setNetworks(List<String> networks) {
         this.networks = networks;
     }
 
+    /**
+     * resourcePool is the absolute path of the resource pool where virtual machines will be created. The absolute path is of the form /&lt;datacenter&gt;/host/&lt;cluster&gt;/Resources/&lt;resourcepool&gt;.
+     */
     @JsonProperty("resourcePool")
     public String getResourcePool() {
         return resourcePool;
     }
 
+    /**
+     * resourcePool is the absolute path of the resource pool where virtual machines will be created. The absolute path is of the form /&lt;datacenter&gt;/host/&lt;cluster&gt;/Resources/&lt;resourcepool&gt;.
+     */
     @JsonProperty("resourcePool")
     public void setResourcePool(String resourcePool) {
         this.resourcePool = resourcePool;
     }
 
+    /**
+     * tagIDs is an optional set of tags to add to an instance. Specified tagIDs must use URN-notation instead of display names. A maximum of 10 tag IDs may be specified.
+     */
     @JsonProperty("tagIDs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getTagIDs() {
         return tagIDs;
     }
 
+    /**
+     * tagIDs is an optional set of tags to add to an instance. Specified tagIDs must use URN-notation instead of display names. A maximum of 10 tag IDs may be specified.
+     */
     @JsonProperty("tagIDs")
     public void setTagIDs(List<String> tagIDs) {
         this.tagIDs = tagIDs;
     }
 
+    /**
+     * template is the inventory path of the virtual machine or template that will be used for cloning.
+     */
     @JsonProperty("template")
     public String getTemplate() {
         return template;
     }
 
+    /**
+     * template is the inventory path of the virtual machine or template that will be used for cloning.
+     */
     @JsonProperty("template")
     public void setTemplate(String template) {
         this.template = template;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/VCenter.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/VCenter.java
index 0de79448dfb..26757aeea90 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/VCenter.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/VCenter.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VCenter stores the vCenter connection fields https://github.com/kubernetes/cloud-provider-vsphere/blob/master/pkg/common/config/types_yaml.go
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -97,52 +100,82 @@ public VCenter(List<String> datacenters, String password, Integer port, String s
         this.user = user;
     }
 
+    /**
+     * Datacenter in which VMs are located.
+     */
     @JsonProperty("datacenters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDatacenters() {
         return datacenters;
     }
 
+    /**
+     * Datacenter in which VMs are located.
+     */
     @JsonProperty("datacenters")
     public void setDatacenters(List<String> datacenters) {
         this.datacenters = datacenters;
     }
 
+    /**
+     * Password is the password for the user to use to connect to the vCenter.
+     */
     @JsonProperty("password")
     public String getPassword() {
         return password;
     }
 
+    /**
+     * Password is the password for the user to use to connect to the vCenter.
+     */
     @JsonProperty("password")
     public void setPassword(String password) {
         this.password = password;
     }
 
+    /**
+     * port is the TCP port that will be used to communicate to the vCenter endpoint. This is typically unchanged from the default of HTTPS TCP/443.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * port is the TCP port that will be used to communicate to the vCenter endpoint. This is typically unchanged from the default of HTTPS TCP/443.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * server is the fully-qualified domain name or the IP address of the vCenter server.
+     */
     @JsonProperty("server")
     public String getServer() {
         return server;
     }
 
+    /**
+     * server is the fully-qualified domain name or the IP address of the vCenter server.
+     */
     @JsonProperty("server")
     public void setServer(String server) {
         this.server = server;
     }
 
+    /**
+     * Username is the username that will be used to connect to vCenter
+     */
     @JsonProperty("user")
     public String getUser() {
         return user;
     }
 
+    /**
+     * Username is the username that will be used to connect to vCenter
+     */
     @JsonProperty("user")
     public void setUser(String user) {
         this.user = user;
diff --git a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/VCenters.java b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/VCenters.java
index 29897f277fd..69f14c0a606 100644
--- a/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/VCenters.java
+++ b/kubernetes-model-generator/openshift-model-installer/src/generated/java/io/fabric8/openshift/api/model/installer/vsphere/v1/VCenters.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VCenters contains information on individual vcenter.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public VCenters(String password, String username, String vCenter) {
         this.vCenter = vCenter;
     }
 
+    /**
+     * Password is the password for the user to use to connect to the vCenter.
+     */
     @JsonProperty("password")
     public String getPassword() {
         return password;
     }
 
+    /**
+     * Password is the password for the user to use to connect to the vCenter.
+     */
     @JsonProperty("password")
     public void setPassword(String password) {
         this.password = password;
     }
 
+    /**
+     * Username is the name of the user to use to connect to the vCenter.
+     */
     @JsonProperty("username")
     public String getUsername() {
         return username;
     }
 
+    /**
+     * Username is the name of the user to use to connect to the vCenter.
+     */
     @JsonProperty("username")
     public void setUsername(String username) {
         this.username = username;
     }
 
+    /**
+     * VCenter is the domain name or IP address of the vCenter.
+     */
     @JsonProperty("vCenter")
     public String getVCenter() {
         return vCenter;
     }
 
+    /**
+     * VCenter is the domain name or IP address of the vCenter.
+     */
     @JsonProperty("vCenter")
     public void setVCenter(String vCenter) {
         this.vCenter = vCenter;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AWSFailureDomain.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AWSFailureDomain.java
index 2611f0b6676..4190893d325 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AWSFailureDomain.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AWSFailureDomain.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSFailureDomain configures failure domain information for the AWS platform.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public AWSFailureDomain(AWSFailureDomainPlacement placement, AWSResourceReferenc
         this.subnet = subnet;
     }
 
+    /**
+     * AWSFailureDomain configures failure domain information for the AWS platform.
+     */
     @JsonProperty("placement")
     public AWSFailureDomainPlacement getPlacement() {
         return placement;
     }
 
+    /**
+     * AWSFailureDomain configures failure domain information for the AWS platform.
+     */
     @JsonProperty("placement")
     public void setPlacement(AWSFailureDomainPlacement placement) {
         this.placement = placement;
     }
 
+    /**
+     * AWSFailureDomain configures failure domain information for the AWS platform.
+     */
     @JsonProperty("subnet")
     public AWSResourceReference getSubnet() {
         return subnet;
     }
 
+    /**
+     * AWSFailureDomain configures failure domain information for the AWS platform.
+     */
     @JsonProperty("subnet")
     public void setSubnet(AWSResourceReference subnet) {
         this.subnet = subnet;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AWSFailureDomainPlacement.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AWSFailureDomainPlacement.java
index a4b6678061e..e3dc068aeed 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AWSFailureDomainPlacement.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AWSFailureDomainPlacement.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSFailureDomainPlacement configures the placement information for the AWSFailureDomain.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public AWSFailureDomainPlacement(String availabilityZone) {
         this.availabilityZone = availabilityZone;
     }
 
+    /**
+     * AvailabilityZone is the availability zone of the instance.
+     */
     @JsonProperty("availabilityZone")
     public String getAvailabilityZone() {
         return availabilityZone;
     }
 
+    /**
+     * AvailabilityZone is the availability zone of the instance.
+     */
     @JsonProperty("availabilityZone")
     public void setAvailabilityZone(String availabilityZone) {
         this.availabilityZone = availabilityZone;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AWSResourceFilter.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AWSResourceFilter.java
index 4981f6a9164..f5268eb4e10 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AWSResourceFilter.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AWSResourceFilter.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSResourceFilter is a filter used to identify an AWS resource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public AWSResourceFilter(String name, List<String> values) {
         this.values = values;
     }
 
+    /**
+     * Name of the filter. Filter names are case-sensitive.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the filter. Filter names are case-sensitive.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Values includes one or more filter values. Filter values are case-sensitive.
+     */
     @JsonProperty("values")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getValues() {
         return values;
     }
 
+    /**
+     * Values includes one or more filter values. Filter values are case-sensitive.
+     */
     @JsonProperty("values")
     public void setValues(List<String> values) {
         this.values = values;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AWSResourceReference.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AWSResourceReference.java
index c326e42570c..3523e82dd4e 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AWSResourceReference.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AWSResourceReference.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSResourceReference is a reference to a specific AWS resource by ID, ARN, or filters. Only one of ID, ARN or Filters may be specified. Specifying more than one will result in a validation error.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public AWSResourceReference(String arn, List<AWSResourceFilter> filters, String
         this.type = type;
     }
 
+    /**
+     * ARN of resource.
+     */
     @JsonProperty("arn")
     public String getArn() {
         return arn;
     }
 
+    /**
+     * ARN of resource.
+     */
     @JsonProperty("arn")
     public void setArn(String arn) {
         this.arn = arn;
     }
 
+    /**
+     * Filters is a set of filters used to identify a resource.
+     */
     @JsonProperty("filters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AWSResourceFilter> getFilters() {
         return filters;
     }
 
+    /**
+     * Filters is a set of filters used to identify a resource.
+     */
     @JsonProperty("filters")
     public void setFilters(List<AWSResourceFilter> filters) {
         this.filters = filters;
     }
 
+    /**
+     * ID of resource.
+     */
     @JsonProperty("id")
     public String getId() {
         return id;
     }
 
+    /**
+     * ID of resource.
+     */
     @JsonProperty("id")
     public void setId(String id) {
         this.id = id;
     }
 
+    /**
+     * Type determines how the reference will fetch the AWS resource.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type determines how the reference will fetch the AWS resource.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AlibabaCloudMachineProviderConfig.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AlibabaCloudMachineProviderConfig.java
index 8679f78a881..05c3c7a3687 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AlibabaCloudMachineProviderConfig.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AlibabaCloudMachineProviderConfig.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AlibabaCloudMachineProviderConfig is the Schema for the alibabacloudmachineproviderconfig API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -92,9 +95,6 @@
 public class AlibabaCloudMachineProviderConfig implements Editable<AlibabaCloudMachineProviderConfigBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machine.openshift.io/v1";
     @JsonProperty("bandwidth")
@@ -108,9 +108,6 @@ public class AlibabaCloudMachineProviderConfig implements Editable<AlibabaCloudM
     private String imageId;
     @JsonProperty("instanceType")
     private String instanceType;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AlibabaCloudMachineProviderConfig";
     @JsonProperty("metadata")
@@ -172,7 +169,7 @@ public AlibabaCloudMachineProviderConfig(String apiVersion, BandwidthProperties
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -180,66 +177,96 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * AlibabaCloudMachineProviderConfig is the Schema for the alibabacloudmachineproviderconfig API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("bandwidth")
     public BandwidthProperties getBandwidth() {
         return bandwidth;
     }
 
+    /**
+     * AlibabaCloudMachineProviderConfig is the Schema for the alibabacloudmachineproviderconfig API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("bandwidth")
     public void setBandwidth(BandwidthProperties bandwidth) {
         this.bandwidth = bandwidth;
     }
 
+    /**
+     * AlibabaCloudMachineProviderConfig is the Schema for the alibabacloudmachineproviderconfig API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("credentialsSecret")
     public LocalObjectReference getCredentialsSecret() {
         return credentialsSecret;
     }
 
+    /**
+     * AlibabaCloudMachineProviderConfig is the Schema for the alibabacloudmachineproviderconfig API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("credentialsSecret")
     public void setCredentialsSecret(LocalObjectReference credentialsSecret) {
         this.credentialsSecret = credentialsSecret;
     }
 
+    /**
+     * DataDisks holds information regarding the extra disks attached to the instance
+     */
     @JsonProperty("dataDisk")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DataDiskProperties> getDataDisk() {
         return dataDisk;
     }
 
+    /**
+     * DataDisks holds information regarding the extra disks attached to the instance
+     */
     @JsonProperty("dataDisk")
     public void setDataDisk(List<DataDiskProperties> dataDisk) {
         this.dataDisk = dataDisk;
     }
 
+    /**
+     * The ID of the image used to create the instance.
+     */
     @JsonProperty("imageId")
     public String getImageId() {
         return imageId;
     }
 
+    /**
+     * The ID of the image used to create the instance.
+     */
     @JsonProperty("imageId")
     public void setImageId(String imageId) {
         this.imageId = imageId;
     }
 
+    /**
+     * The instance type of the instance.
+     */
     @JsonProperty("instanceType")
     public String getInstanceType() {
         return instanceType;
     }
 
+    /**
+     * The instance type of the instance.
+     */
     @JsonProperty("instanceType")
     public void setInstanceType(String instanceType) {
         this.instanceType = instanceType;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -247,130 +274,202 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AlibabaCloudMachineProviderConfig is the Schema for the alibabacloudmachineproviderconfig API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AlibabaCloudMachineProviderConfig is the Schema for the alibabacloudmachineproviderconfig API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * RAMRoleName is the name of the instance Resource Access Management (RAM) role. This allows the instance to perform API calls as this specified RAM role.
+     */
     @JsonProperty("ramRoleName")
     public String getRamRoleName() {
         return ramRoleName;
     }
 
+    /**
+     * RAMRoleName is the name of the instance Resource Access Management (RAM) role. This allows the instance to perform API calls as this specified RAM role.
+     */
     @JsonProperty("ramRoleName")
     public void setRamRoleName(String ramRoleName) {
         this.ramRoleName = ramRoleName;
     }
 
+    /**
+     * The ID of the region in which to create the instance. You can call the DescribeRegions operation to query the most recent region list.
+     */
     @JsonProperty("regionId")
     public String getRegionId() {
         return regionId;
     }
 
+    /**
+     * The ID of the region in which to create the instance. You can call the DescribeRegions operation to query the most recent region list.
+     */
     @JsonProperty("regionId")
     public void setRegionId(String regionId) {
         this.regionId = regionId;
     }
 
+    /**
+     * AlibabaCloudMachineProviderConfig is the Schema for the alibabacloudmachineproviderconfig API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("resourceGroup")
     public AlibabaResourceReference getResourceGroup() {
         return resourceGroup;
     }
 
+    /**
+     * AlibabaCloudMachineProviderConfig is the Schema for the alibabacloudmachineproviderconfig API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("resourceGroup")
     public void setResourceGroup(AlibabaResourceReference resourceGroup) {
         this.resourceGroup = resourceGroup;
     }
 
+    /**
+     * SecurityGroups is a list of security group references to assign to the instance. A reference holds either the security group ID, the resource name, or the required tags to search. When more than one security group is returned for a tag search, all the groups are associated with the instance up to the maximum number of security groups to which an instance can belong. For more information, see the "Security group limits" section in Limits. https://www.alibabacloud.com/help/en/doc-detail/25412.htm
+     */
     @JsonProperty("securityGroups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AlibabaResourceReference> getSecurityGroups() {
         return securityGroups;
     }
 
+    /**
+     * SecurityGroups is a list of security group references to assign to the instance. A reference holds either the security group ID, the resource name, or the required tags to search. When more than one security group is returned for a tag search, all the groups are associated with the instance up to the maximum number of security groups to which an instance can belong. For more information, see the "Security group limits" section in Limits. https://www.alibabacloud.com/help/en/doc-detail/25412.htm
+     */
     @JsonProperty("securityGroups")
     public void setSecurityGroups(List<AlibabaResourceReference> securityGroups) {
         this.securityGroups = securityGroups;
     }
 
+    /**
+     * AlibabaCloudMachineProviderConfig is the Schema for the alibabacloudmachineproviderconfig API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("systemDisk")
     public SystemDiskProperties getSystemDisk() {
         return systemDisk;
     }
 
+    /**
+     * AlibabaCloudMachineProviderConfig is the Schema for the alibabacloudmachineproviderconfig API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("systemDisk")
     public void setSystemDisk(SystemDiskProperties systemDisk) {
         this.systemDisk = systemDisk;
     }
 
+    /**
+     * Tags are the set of metadata to add to an instance.
+     */
     @JsonProperty("tag")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Tag> getTag() {
         return tag;
     }
 
+    /**
+     * Tags are the set of metadata to add to an instance.
+     */
     @JsonProperty("tag")
     public void setTag(List<Tag> tag) {
         this.tag = tag;
     }
 
+    /**
+     * Tenancy specifies whether to create the instance on a dedicated host. Valid values:<br><p> <br><p> default: creates the instance on a non-dedicated host. host: creates the instance on a dedicated host. If you do not specify the DedicatedHostID parameter, Alibaba Cloud automatically selects a dedicated host for the instance. Empty value means no opinion and the platform chooses the a default, which is subject to change over time. Currently the default is `default`.
+     */
     @JsonProperty("tenancy")
     public String getTenancy() {
         return tenancy;
     }
 
+    /**
+     * Tenancy specifies whether to create the instance on a dedicated host. Valid values:<br><p> <br><p> default: creates the instance on a non-dedicated host. host: creates the instance on a dedicated host. If you do not specify the DedicatedHostID parameter, Alibaba Cloud automatically selects a dedicated host for the instance. Empty value means no opinion and the platform chooses the a default, which is subject to change over time. Currently the default is `default`.
+     */
     @JsonProperty("tenancy")
     public void setTenancy(String tenancy) {
         this.tenancy = tenancy;
     }
 
+    /**
+     * AlibabaCloudMachineProviderConfig is the Schema for the alibabacloudmachineproviderconfig API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("userDataSecret")
     public LocalObjectReference getUserDataSecret() {
         return userDataSecret;
     }
 
+    /**
+     * AlibabaCloudMachineProviderConfig is the Schema for the alibabacloudmachineproviderconfig API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("userDataSecret")
     public void setUserDataSecret(LocalObjectReference userDataSecret) {
         this.userDataSecret = userDataSecret;
     }
 
+    /**
+     * AlibabaCloudMachineProviderConfig is the Schema for the alibabacloudmachineproviderconfig API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("vSwitch")
     public AlibabaResourceReference getVSwitch() {
         return vSwitch;
     }
 
+    /**
+     * AlibabaCloudMachineProviderConfig is the Schema for the alibabacloudmachineproviderconfig API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("vSwitch")
     public void setVSwitch(AlibabaResourceReference vSwitch) {
         this.vSwitch = vSwitch;
     }
 
+    /**
+     * The ID of the vpc
+     */
     @JsonProperty("vpcId")
     public String getVpcId() {
         return vpcId;
     }
 
+    /**
+     * The ID of the vpc
+     */
     @JsonProperty("vpcId")
     public void setVpcId(String vpcId) {
         this.vpcId = vpcId;
     }
 
+    /**
+     * The ID of the zone in which to create the instance. You can call the DescribeZones operation to query the most recent region list.
+     */
     @JsonProperty("zoneId")
     public String getZoneId() {
         return zoneId;
     }
 
+    /**
+     * The ID of the zone in which to create the instance. You can call the DescribeZones operation to query the most recent region list.
+     */
     @JsonProperty("zoneId")
     public void setZoneId(String zoneId) {
         this.zoneId = zoneId;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AlibabaCloudMachineProviderConfigList.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AlibabaCloudMachineProviderConfigList.java
index 59d3bc4f470..4ef2a347ed9 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AlibabaCloudMachineProviderConfigList.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AlibabaCloudMachineProviderConfigList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AlibabaCloudMachineProviderConfigList contains a list of AlibabaCloudMachineProviderConfig Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class AlibabaCloudMachineProviderConfigList implements Editable<AlibabaCloudMachineProviderConfigListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.machine.v1.AlibabaCloudMachineProviderConfig>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machine.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.machine.v1.AlibabaCloudMachineProviderConfig> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AlibabaCloudMachineProviderConfigList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public AlibabaCloudMachineProviderConfigList(String apiVersion, List<io.fabric8.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * AlibabaCloudMachineProviderConfigList contains a list of AlibabaCloudMachineProviderConfig Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.machine.v1.AlibabaCloudMachineProviderConfig> getItems() {
         return items;
     }
 
+    /**
+     * AlibabaCloudMachineProviderConfigList contains a list of AlibabaCloudMachineProviderConfig Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.machine.v1.AlibabaCloudMachineProviderConfig> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AlibabaCloudMachineProviderConfigList contains a list of AlibabaCloudMachineProviderConfig Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AlibabaCloudMachineProviderConfigList contains a list of AlibabaCloudMachineProviderConfig Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AlibabaCloudMachineProviderStatus.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AlibabaCloudMachineProviderStatus.java
index d03b5a89d1d..dfcce4ad605 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AlibabaCloudMachineProviderStatus.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AlibabaCloudMachineProviderStatus.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AlibabaCloudMachineProviderStatus is the Schema for the alibabacloudmachineproviderconfig API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -80,9 +83,6 @@
 public class AlibabaCloudMachineProviderStatus implements Editable<AlibabaCloudMachineProviderStatusBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machine.openshift.io/v1";
     @JsonProperty("conditions")
@@ -92,9 +92,6 @@ public class AlibabaCloudMachineProviderStatus implements Editable<AlibabaCloudM
     private String instanceId;
     @JsonProperty("instanceState")
     private String instanceState;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AlibabaCloudMachineProviderStatus";
     @JsonProperty("metadata")
@@ -119,7 +116,7 @@ public AlibabaCloudMachineProviderStatus(String apiVersion, List<Condition> cond
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -127,46 +124,64 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Conditions is a set of conditions associated with the Machine to indicate errors or other status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions is a set of conditions associated with the Machine to indicate errors or other status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * InstanceID is the instance ID of the machine created in alibabacloud
+     */
     @JsonProperty("instanceId")
     public String getInstanceId() {
         return instanceId;
     }
 
+    /**
+     * InstanceID is the instance ID of the machine created in alibabacloud
+     */
     @JsonProperty("instanceId")
     public void setInstanceId(String instanceId) {
         this.instanceId = instanceId;
     }
 
+    /**
+     * InstanceState is the state of the alibabacloud instance for this machine
+     */
     @JsonProperty("instanceState")
     public String getInstanceState() {
         return instanceState;
     }
 
+    /**
+     * InstanceState is the state of the alibabacloud instance for this machine
+     */
     @JsonProperty("instanceState")
     public void setInstanceState(String instanceState) {
         this.instanceState = instanceState;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -174,18 +189,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AlibabaCloudMachineProviderStatus is the Schema for the alibabacloudmachineproviderconfig API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AlibabaCloudMachineProviderStatus is the Schema for the alibabacloudmachineproviderconfig API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AlibabaResourceReference.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AlibabaResourceReference.java
index 9734bf02cac..11d9eea02c0 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AlibabaResourceReference.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AlibabaResourceReference.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceTagReference is a reference to a specific AlibabaCloud resource by ID, or tags. Only one of ID or Tags may be specified. Specifying more than one will result in a validation error.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public AlibabaResourceReference(String id, String name, List<Tag> tags, String t
         this.type = type;
     }
 
+    /**
+     * ID of resource
+     */
     @JsonProperty("id")
     public String getId() {
         return id;
     }
 
+    /**
+     * ID of resource
+     */
     @JsonProperty("id")
     public void setId(String id) {
         this.id = id;
     }
 
+    /**
+     * Name of the resource
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the resource
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Tags is a set of metadata based upon ECS object tags used to identify a resource. For details about usage when multiple resources are found, please see the owning parent field documentation.
+     */
     @JsonProperty("tags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Tag> getTags() {
         return tags;
     }
 
+    /**
+     * Tags is a set of metadata based upon ECS object tags used to identify a resource. For details about usage when multiple resources are found, please see the owning parent field documentation.
+     */
     @JsonProperty("tags")
     public void setTags(List<Tag> tags) {
         this.tags = tags;
     }
 
+    /**
+     * type identifies the resource reference type for this entry.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type identifies the resource reference type for this entry.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AzureFailureDomain.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AzureFailureDomain.java
index 76b84dfee51..214850a5ce3 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AzureFailureDomain.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/AzureFailureDomain.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzureFailureDomain configures failure domain information for the Azure platform.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public AzureFailureDomain(String subnet, String zone) {
         this.zone = zone;
     }
 
+    /**
+     * subnet is the name of the network subnet in which the VM will be created. When omitted, the subnet value from the machine providerSpec template will be used.
+     */
     @JsonProperty("subnet")
     public String getSubnet() {
         return subnet;
     }
 
+    /**
+     * subnet is the name of the network subnet in which the VM will be created. When omitted, the subnet value from the machine providerSpec template will be used.
+     */
     @JsonProperty("subnet")
     public void setSubnet(String subnet) {
         this.subnet = subnet;
     }
 
+    /**
+     * Availability Zone for the virtual machine. If nil, the virtual machine should be deployed to no zone.
+     */
     @JsonProperty("zone")
     public String getZone() {
         return zone;
     }
 
+    /**
+     * Availability Zone for the virtual machine. If nil, the virtual machine should be deployed to no zone.
+     */
     @JsonProperty("zone")
     public void setZone(String zone) {
         this.zone = zone;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/BandwidthProperties.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/BandwidthProperties.java
index 00691a34217..411c08c9127 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/BandwidthProperties.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/BandwidthProperties.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Bandwidth describes the bandwidth strategy for the network of the instance
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public BandwidthProperties(Long internetMaxBandwidthIn, Long internetMaxBandwidt
         this.internetMaxBandwidthOut = internetMaxBandwidthOut;
     }
 
+    /**
+     * InternetMaxBandwidthIn is the maximum inbound public bandwidth. Unit: Mbit/s. Valid values: When the purchased outbound public bandwidth is less than or equal to 10 Mbit/s, the valid values of this parameter are 1 to 10. Currently the default is `10` when outbound bandwidth is less than or equal to 10 Mbit/s. When the purchased outbound public bandwidth is greater than 10, the valid values are 1 to the InternetMaxBandwidthOut value. Currently the default is the value used for `InternetMaxBandwidthOut` when outbound public bandwidth is greater than 10.
+     */
     @JsonProperty("internetMaxBandwidthIn")
     public Long getInternetMaxBandwidthIn() {
         return internetMaxBandwidthIn;
     }
 
+    /**
+     * InternetMaxBandwidthIn is the maximum inbound public bandwidth. Unit: Mbit/s. Valid values: When the purchased outbound public bandwidth is less than or equal to 10 Mbit/s, the valid values of this parameter are 1 to 10. Currently the default is `10` when outbound bandwidth is less than or equal to 10 Mbit/s. When the purchased outbound public bandwidth is greater than 10, the valid values are 1 to the InternetMaxBandwidthOut value. Currently the default is the value used for `InternetMaxBandwidthOut` when outbound public bandwidth is greater than 10.
+     */
     @JsonProperty("internetMaxBandwidthIn")
     public void setInternetMaxBandwidthIn(Long internetMaxBandwidthIn) {
         this.internetMaxBandwidthIn = internetMaxBandwidthIn;
     }
 
+    /**
+     * InternetMaxBandwidthOut is the maximum outbound public bandwidth. Unit: Mbit/s. Valid values: 0 to 100. When a value greater than 0 is used then a public IP address is assigned to the instance. Empty value means no opinion and the platform chooses the a default, which is subject to change over time. Currently the default is `0`
+     */
     @JsonProperty("internetMaxBandwidthOut")
     public Long getInternetMaxBandwidthOut() {
         return internetMaxBandwidthOut;
     }
 
+    /**
+     * InternetMaxBandwidthOut is the maximum outbound public bandwidth. Unit: Mbit/s. Valid values: 0 to 100. When a value greater than 0 is used then a public IP address is assigned to the instance. Empty value means no opinion and the platform chooses the a default, which is subject to change over time. Currently the default is `0`
+     */
     @JsonProperty("internetMaxBandwidthOut")
     public void setInternetMaxBandwidthOut(Long internetMaxBandwidthOut) {
         this.internetMaxBandwidthOut = internetMaxBandwidthOut;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/ControlPlaneMachineSet.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/ControlPlaneMachineSet.java
index 6db92acf3fe..e31aa20c669 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/ControlPlaneMachineSet.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/ControlPlaneMachineSet.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ControlPlaneMachineSet ensures that a specified number of control plane machine replicas are running at any given time. Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class ControlPlaneMachineSet implements Editable<ControlPlaneMachineSetBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machine.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ControlPlaneMachineSet";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ControlPlaneMachineSet(String apiVersion, String kind, ObjectMeta metadat
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ControlPlaneMachineSet ensures that a specified number of control plane machine replicas are running at any given time. Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ControlPlaneMachineSet ensures that a specified number of control plane machine replicas are running at any given time. Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ControlPlaneMachineSet ensures that a specified number of control plane machine replicas are running at any given time. Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ControlPlaneMachineSetSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ControlPlaneMachineSet ensures that a specified number of control plane machine replicas are running at any given time. Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ControlPlaneMachineSetSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ControlPlaneMachineSet ensures that a specified number of control plane machine replicas are running at any given time. Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public ControlPlaneMachineSetStatus getStatus() {
         return status;
     }
 
+    /**
+     * ControlPlaneMachineSet ensures that a specified number of control plane machine replicas are running at any given time. Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(ControlPlaneMachineSetStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/ControlPlaneMachineSetList.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/ControlPlaneMachineSetList.java
index 02dab523b43..1f969fce2ce 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/ControlPlaneMachineSetList.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/ControlPlaneMachineSetList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ControlPlaneMachineSetList contains a list of ControlPlaneMachineSet Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ControlPlaneMachineSetList implements Editable<ControlPlaneMachineSetListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.machine.v1.ControlPlaneMachineSet>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machine.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.machine.v1.ControlPlaneMachineSet> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ControlPlaneMachineSetList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ControlPlaneMachineSetList(String apiVersion, List<io.fabric8.openshift.a
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ControlPlaneMachineSetList contains a list of ControlPlaneMachineSet Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.machine.v1.ControlPlaneMachineSet> getItems() {
         return items;
     }
 
+    /**
+     * ControlPlaneMachineSetList contains a list of ControlPlaneMachineSet Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.machine.v1.ControlPlaneMachineSet> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ControlPlaneMachineSetList contains a list of ControlPlaneMachineSet Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ControlPlaneMachineSetList contains a list of ControlPlaneMachineSet Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/ControlPlaneMachineSetSpec.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/ControlPlaneMachineSetSpec.java
index b13ba3ab818..26b9133b259 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/ControlPlaneMachineSetSpec.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/ControlPlaneMachineSetSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ControlPlaneMachineSet represents the configuration of the ControlPlaneMachineSet.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public ControlPlaneMachineSetSpec(Integer replicas, LabelSelector selector, Stri
         this.template = template;
     }
 
+    /**
+     * Replicas defines how many Control Plane Machines should be created by this ControlPlaneMachineSet. This field is immutable and cannot be changed after cluster installation. The ControlPlaneMachineSet only operates with 3 or 5 node control planes, 3 and 5 are the only valid values for this field.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Replicas defines how many Control Plane Machines should be created by this ControlPlaneMachineSet. This field is immutable and cannot be changed after cluster installation. The ControlPlaneMachineSet only operates with 3 or 5 node control planes, 3 and 5 are the only valid values for this field.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * ControlPlaneMachineSet represents the configuration of the ControlPlaneMachineSet.
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * ControlPlaneMachineSet represents the configuration of the ControlPlaneMachineSet.
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * State defines whether the ControlPlaneMachineSet is Active or Inactive. When Inactive, the ControlPlaneMachineSet will not take any action on the state of the Machines within the cluster. When Active, the ControlPlaneMachineSet will reconcile the Machines and will update the Machines as necessary. Once Active, a ControlPlaneMachineSet cannot be made Inactive. To prevent further action please remove the ControlPlaneMachineSet.
+     */
     @JsonProperty("state")
     public String getState() {
         return state;
     }
 
+    /**
+     * State defines whether the ControlPlaneMachineSet is Active or Inactive. When Inactive, the ControlPlaneMachineSet will not take any action on the state of the Machines within the cluster. When Active, the ControlPlaneMachineSet will reconcile the Machines and will update the Machines as necessary. Once Active, a ControlPlaneMachineSet cannot be made Inactive. To prevent further action please remove the ControlPlaneMachineSet.
+     */
     @JsonProperty("state")
     public void setState(String state) {
         this.state = state;
     }
 
+    /**
+     * ControlPlaneMachineSet represents the configuration of the ControlPlaneMachineSet.
+     */
     @JsonProperty("strategy")
     public ControlPlaneMachineSetStrategy getStrategy() {
         return strategy;
     }
 
+    /**
+     * ControlPlaneMachineSet represents the configuration of the ControlPlaneMachineSet.
+     */
     @JsonProperty("strategy")
     public void setStrategy(ControlPlaneMachineSetStrategy strategy) {
         this.strategy = strategy;
     }
 
+    /**
+     * ControlPlaneMachineSet represents the configuration of the ControlPlaneMachineSet.
+     */
     @JsonProperty("template")
     public ControlPlaneMachineSetTemplate getTemplate() {
         return template;
     }
 
+    /**
+     * ControlPlaneMachineSet represents the configuration of the ControlPlaneMachineSet.
+     */
     @JsonProperty("template")
     public void setTemplate(ControlPlaneMachineSetTemplate template) {
         this.template = template;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/ControlPlaneMachineSetStatus.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/ControlPlaneMachineSetStatus.java
index 135e863cc3c..0ef872f8c49 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/ControlPlaneMachineSetStatus.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/ControlPlaneMachineSetStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ControlPlaneMachineSetStatus represents the status of the ControlPlaneMachineSet CRD.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,62 +105,98 @@ public ControlPlaneMachineSetStatus(List<Condition> conditions, Long observedGen
         this.updatedReplicas = updatedReplicas;
     }
 
+    /**
+     * Conditions represents the observations of the ControlPlaneMachineSet's current state. Known .status.conditions.type are: Available, Degraded and Progressing.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions represents the observations of the ControlPlaneMachineSet's current state. Known .status.conditions.type are: Available, Degraded and Progressing.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ObservedGeneration is the most recent generation observed for this ControlPlaneMachineSet. It corresponds to the ControlPlaneMachineSets's generation, which is updated on mutation by the API Server.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the most recent generation observed for this ControlPlaneMachineSet. It corresponds to the ControlPlaneMachineSets's generation, which is updated on mutation by the API Server.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * ReadyReplicas is the number of Control Plane Machines created by the ControlPlaneMachineSet controller which are ready. Note that this value may be higher than the desired number of replicas while rolling updates are in-progress.
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * ReadyReplicas is the number of Control Plane Machines created by the ControlPlaneMachineSet controller which are ready. Note that this value may be higher than the desired number of replicas while rolling updates are in-progress.
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * Replicas is the number of Control Plane Machines created by the ControlPlaneMachineSet controller. Note that during update operations this value may differ from the desired replica count.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Replicas is the number of Control Plane Machines created by the ControlPlaneMachineSet controller. Note that during update operations this value may differ from the desired replica count.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * UnavailableReplicas is the number of Control Plane Machines that are still required before the ControlPlaneMachineSet reaches the desired available capacity. When this value is non-zero, the number of ReadyReplicas is less than the desired Replicas.
+     */
     @JsonProperty("unavailableReplicas")
     public Integer getUnavailableReplicas() {
         return unavailableReplicas;
     }
 
+    /**
+     * UnavailableReplicas is the number of Control Plane Machines that are still required before the ControlPlaneMachineSet reaches the desired available capacity. When this value is non-zero, the number of ReadyReplicas is less than the desired Replicas.
+     */
     @JsonProperty("unavailableReplicas")
     public void setUnavailableReplicas(Integer unavailableReplicas) {
         this.unavailableReplicas = unavailableReplicas;
     }
 
+    /**
+     * UpdatedReplicas is the number of non-terminated Control Plane Machines created by the ControlPlaneMachineSet controller that have the desired provider spec and are ready. This value is set to 0 when a change is detected to the desired spec. When the update strategy is RollingUpdate, this will also coincide with starting the process of updating the Machines. When the update strategy is OnDelete, this value will remain at 0 until a user deletes an existing replica and its replacement has become ready.
+     */
     @JsonProperty("updatedReplicas")
     public Integer getUpdatedReplicas() {
         return updatedReplicas;
     }
 
+    /**
+     * UpdatedReplicas is the number of non-terminated Control Plane Machines created by the ControlPlaneMachineSet controller that have the desired provider spec and are ready. This value is set to 0 when a change is detected to the desired spec. When the update strategy is RollingUpdate, this will also coincide with starting the process of updating the Machines. When the update strategy is OnDelete, this value will remain at 0 until a user deletes an existing replica and its replacement has become ready.
+     */
     @JsonProperty("updatedReplicas")
     public void setUpdatedReplicas(Integer updatedReplicas) {
         this.updatedReplicas = updatedReplicas;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/ControlPlaneMachineSetStrategy.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/ControlPlaneMachineSetStrategy.java
index 04d3ac3fef9..1382bd1145a 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/ControlPlaneMachineSetStrategy.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/ControlPlaneMachineSetStrategy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ControlPlaneMachineSetStrategy defines the strategy for applying updates to the Control Plane Machines managed by the ControlPlaneMachineSet.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ControlPlaneMachineSetStrategy(String type) {
         this.type = type;
     }
 
+    /**
+     * Type defines the type of update strategy that should be used when updating Machines owned by the ControlPlaneMachineSet. Valid values are "RollingUpdate" and "OnDelete". The current default value is "RollingUpdate".
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type defines the type of update strategy that should be used when updating Machines owned by the ControlPlaneMachineSet. Valid values are "RollingUpdate" and "OnDelete". The current default value is "RollingUpdate".
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/ControlPlaneMachineSetTemplate.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/ControlPlaneMachineSetTemplate.java
index 697a0718e7e..0cc0048d961 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/ControlPlaneMachineSetTemplate.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/ControlPlaneMachineSetTemplate.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ControlPlaneMachineSetTemplate is a template used by the ControlPlaneMachineSet to create the Machines that it will manage in the future.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ControlPlaneMachineSetTemplate(String machineType, OpenShiftMachineV1Beta
         this.machinesV1beta1MachineOpenshiftIo = machinesV1beta1MachineOpenshiftIo;
     }
 
+    /**
+     * MachineType determines the type of Machines that should be managed by the ControlPlaneMachineSet. Currently, the only valid value is machines_v1beta1_machine_openshift_io.
+     */
     @JsonProperty("machineType")
     public String getMachineType() {
         return machineType;
     }
 
+    /**
+     * MachineType determines the type of Machines that should be managed by the ControlPlaneMachineSet. Currently, the only valid value is machines_v1beta1_machine_openshift_io.
+     */
     @JsonProperty("machineType")
     public void setMachineType(String machineType) {
         this.machineType = machineType;
     }
 
+    /**
+     * ControlPlaneMachineSetTemplate is a template used by the ControlPlaneMachineSet to create the Machines that it will manage in the future.
+     */
     @JsonProperty("machines_v1beta1_machine_openshift_io")
     public OpenShiftMachineV1Beta1MachineTemplate getMachinesV1beta1MachineOpenshiftIo() {
         return machinesV1beta1MachineOpenshiftIo;
     }
 
+    /**
+     * ControlPlaneMachineSetTemplate is a template used by the ControlPlaneMachineSet to create the Machines that it will manage in the future.
+     */
     @JsonProperty("machines_v1beta1_machine_openshift_io")
     public void setMachinesV1beta1MachineOpenshiftIo(OpenShiftMachineV1Beta1MachineTemplate machinesV1beta1MachineOpenshiftIo) {
         this.machinesV1beta1MachineOpenshiftIo = machinesV1beta1MachineOpenshiftIo;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/ControlPlaneMachineSetTemplateObjectMeta.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/ControlPlaneMachineSetTemplateObjectMeta.java
index 438a956224b..aafdd6d3c80 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/ControlPlaneMachineSetTemplateObjectMeta.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/ControlPlaneMachineSetTemplateObjectMeta.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ControlPlaneMachineSetTemplateObjectMeta is a subset of the metav1.ObjectMeta struct. It allows users to specify labels and annotations that will be copied onto Machines created from this template.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -84,23 +87,35 @@ public ControlPlaneMachineSetTemplateObjectMeta(Map<String, String> annotations,
         this.labels = labels;
     }
 
+    /**
+     * Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: http://kubernetes.io/docs/user-guide/annotations
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: http://kubernetes.io/docs/user-guide/annotations
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: http://kubernetes.io/docs/user-guide/labels. This field must contain both the 'machine.openshift.io/cluster-api-machine-role' and 'machine.openshift.io/cluster-api-machine-type' labels, both with a value of 'master'. It must also contain a label with the key 'machine.openshift.io/cluster-api-cluster'.
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabels() {
         return labels;
     }
 
+    /**
+     * Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: http://kubernetes.io/docs/user-guide/labels. This field must contain both the 'machine.openshift.io/cluster-api-machine-role' and 'machine.openshift.io/cluster-api-machine-type' labels, both with a value of 'master'. It must also contain a label with the key 'machine.openshift.io/cluster-api-cluster'.
+     */
     @JsonProperty("labels")
     public void setLabels(Map<String, String> labels) {
         this.labels = labels;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/DataDiskProperties.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/DataDiskProperties.java
index b50f51d9995..2f2ac954794 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/DataDiskProperties.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/DataDiskProperties.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DataDisk contains the information regarding the datadisk attached to an instance
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -106,81 +109,129 @@ public DataDiskProperties(String category, String diskEncryption, String diskPre
         this.snapshotID = snapshotID;
     }
 
+    /**
+     * Category describes the type of data disk N. Valid values: cloud_efficiency: ultra disk cloud_ssd: standard SSD cloud_essd: ESSD cloud: basic disk Empty value means no opinion and the platform chooses the a default, which is subject to change over time. Currently for non-I/O optimized instances of retired instance types, the default is `cloud`. Currently for other instances, the default is `cloud_efficiency`.
+     */
     @JsonProperty("Category")
     public String getCategory() {
         return category;
     }
 
+    /**
+     * Category describes the type of data disk N. Valid values: cloud_efficiency: ultra disk cloud_ssd: standard SSD cloud_essd: ESSD cloud: basic disk Empty value means no opinion and the platform chooses the a default, which is subject to change over time. Currently for non-I/O optimized instances of retired instance types, the default is `cloud`. Currently for other instances, the default is `cloud_efficiency`.
+     */
     @JsonProperty("Category")
     public void setCategory(String category) {
         this.category = category;
     }
 
+    /**
+     * DiskEncryption specifies whether to encrypt data disk N.<br><p> <br><p> Empty value means the platform chooses a default, which is subject to change over time. Currently the default is `disabled`.
+     */
     @JsonProperty("DiskEncryption")
     public String getDiskEncryption() {
         return diskEncryption;
     }
 
+    /**
+     * DiskEncryption specifies whether to encrypt data disk N.<br><p> <br><p> Empty value means the platform chooses a default, which is subject to change over time. Currently the default is `disabled`.
+     */
     @JsonProperty("DiskEncryption")
     public void setDiskEncryption(String diskEncryption) {
         this.diskEncryption = diskEncryption;
     }
 
+    /**
+     * DiskPreservation specifies whether to release data disk N along with the instance. Empty value means no opinion and the platform chooses the a default, which is subject to change over time. Currently the default is `DeleteWithInstance`
+     */
     @JsonProperty("DiskPreservation")
     public String getDiskPreservation() {
         return diskPreservation;
     }
 
+    /**
+     * DiskPreservation specifies whether to release data disk N along with the instance. Empty value means no opinion and the platform chooses the a default, which is subject to change over time. Currently the default is `DeleteWithInstance`
+     */
     @JsonProperty("DiskPreservation")
     public void setDiskPreservation(String diskPreservation) {
         this.diskPreservation = diskPreservation;
     }
 
+    /**
+     * KMSKeyID is the ID of the Key Management Service (KMS) key to be used by data disk N. Empty value means no opinion and the platform chooses the a default, which is subject to change over time. Currently the default is `""` which is interpreted as do not use KMSKey encryption.
+     */
     @JsonProperty("KMSKeyID")
     public String getKMSKeyID() {
         return kMSKeyID;
     }
 
+    /**
+     * KMSKeyID is the ID of the Key Management Service (KMS) key to be used by data disk N. Empty value means no opinion and the platform chooses the a default, which is subject to change over time. Currently the default is `""` which is interpreted as do not use KMSKey encryption.
+     */
     @JsonProperty("KMSKeyID")
     public void setKMSKeyID(String kMSKeyID) {
         this.kMSKeyID = kMSKeyID;
     }
 
+    /**
+     * Name is the name of data disk N. If the name is specified the name must be 2 to 128 characters in length. It must start with a letter and cannot start with http:// or https://. It can contain letters, digits, colons (:), underscores (_), and hyphens (-).<br><p> <br><p> Empty value means the platform chooses a default, which is subject to change over time. Currently the default is `""`.
+     */
     @JsonProperty("Name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of data disk N. If the name is specified the name must be 2 to 128 characters in length. It must start with a letter and cannot start with http:// or https://. It can contain letters, digits, colons (:), underscores (_), and hyphens (-).<br><p> <br><p> Empty value means the platform chooses a default, which is subject to change over time. Currently the default is `""`.
+     */
     @JsonProperty("Name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * PerformanceLevel is the performance level of the ESSD used as as data disk N.  The N value must be the same as that in DataDisk.N.Category when DataDisk.N.Category is set to cloud_essd. Empty value means no opinion and the platform chooses a default, which is subject to change over time. Currently the default is `PL1`. Valid values:<br><p> <br><p> PL0: A single ESSD can deliver up to 10,000 random read/write IOPS. PL1: A single ESSD can deliver up to 50,000 random read/write IOPS. PL2: A single ESSD can deliver up to 100,000 random read/write IOPS. PL3: A single ESSD can deliver up to 1,000,000 random read/write IOPS. For more information about ESSD performance levels, see ESSDs.
+     */
     @JsonProperty("PerformanceLevel")
     public String getPerformanceLevel() {
         return performanceLevel;
     }
 
+    /**
+     * PerformanceLevel is the performance level of the ESSD used as as data disk N.  The N value must be the same as that in DataDisk.N.Category when DataDisk.N.Category is set to cloud_essd. Empty value means no opinion and the platform chooses a default, which is subject to change over time. Currently the default is `PL1`. Valid values:<br><p> <br><p> PL0: A single ESSD can deliver up to 10,000 random read/write IOPS. PL1: A single ESSD can deliver up to 50,000 random read/write IOPS. PL2: A single ESSD can deliver up to 100,000 random read/write IOPS. PL3: A single ESSD can deliver up to 1,000,000 random read/write IOPS. For more information about ESSD performance levels, see ESSDs.
+     */
     @JsonProperty("PerformanceLevel")
     public void setPerformanceLevel(String performanceLevel) {
         this.performanceLevel = performanceLevel;
     }
 
+    /**
+     * Size of the data disk N. Valid values of N: 1 to 16. Unit: GiB. Valid values:<br><p> <br><p> Valid values when DataDisk.N.Category is set to cloud_efficiency: 20 to 32768 Valid values when DataDisk.N.Category is set to cloud_ssd: 20 to 32768 Valid values when DataDisk.N.Category is set to cloud_essd: 20 to 32768 Valid values when DataDisk.N.Category is set to cloud: 5 to 2000 The value of this parameter must be greater than or equal to the size of the snapshot specified by the SnapshotID parameter.
+     */
     @JsonProperty("Size")
     public Long getSize() {
         return size;
     }
 
+    /**
+     * Size of the data disk N. Valid values of N: 1 to 16. Unit: GiB. Valid values:<br><p> <br><p> Valid values when DataDisk.N.Category is set to cloud_efficiency: 20 to 32768 Valid values when DataDisk.N.Category is set to cloud_ssd: 20 to 32768 Valid values when DataDisk.N.Category is set to cloud_essd: 20 to 32768 Valid values when DataDisk.N.Category is set to cloud: 5 to 2000 The value of this parameter must be greater than or equal to the size of the snapshot specified by the SnapshotID parameter.
+     */
     @JsonProperty("Size")
     public void setSize(Long size) {
         this.size = size;
     }
 
+    /**
+     * SnapshotID is the ID of the snapshot used to create data disk N. Valid values of N: 1 to 16.<br><p> <br><p> When the DataDisk.N.SnapshotID parameter is specified, the DataDisk.N.Size parameter is ignored. The data disk is created based on the size of the specified snapshot. Use snapshots created after July 15, 2013. Otherwise, an error is returned and your request is rejected.
+     */
     @JsonProperty("SnapshotID")
     public String getSnapshotID() {
         return snapshotID;
     }
 
+    /**
+     * SnapshotID is the ID of the snapshot used to create data disk N. Valid values of N: 1 to 16.<br><p> <br><p> When the DataDisk.N.SnapshotID parameter is specified, the DataDisk.N.Size parameter is ignored. The data disk is created based on the size of the specified snapshot. Use snapshots created after July 15, 2013. Otherwise, an error is returned and your request is rejected.
+     */
     @JsonProperty("SnapshotID")
     public void setSnapshotID(String snapshotID) {
         this.snapshotID = snapshotID;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/FailureDomains.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/FailureDomains.java
index 8bff27b81f7..8937ccf727a 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/FailureDomains.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/FailureDomains.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FailureDomain represents the different configurations required to spread Machines across failure domains on different platforms.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -110,77 +113,119 @@ public FailureDomains(List<AWSFailureDomain> aws, List<AzureFailureDomain> azure
         this.vsphere = vsphere;
     }
 
+    /**
+     * AWS configures failure domain information for the AWS platform.
+     */
     @JsonProperty("aws")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AWSFailureDomain> getAws() {
         return aws;
     }
 
+    /**
+     * AWS configures failure domain information for the AWS platform.
+     */
     @JsonProperty("aws")
     public void setAws(List<AWSFailureDomain> aws) {
         this.aws = aws;
     }
 
+    /**
+     * Azure configures failure domain information for the Azure platform.
+     */
     @JsonProperty("azure")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AzureFailureDomain> getAzure() {
         return azure;
     }
 
+    /**
+     * Azure configures failure domain information for the Azure platform.
+     */
     @JsonProperty("azure")
     public void setAzure(List<AzureFailureDomain> azure) {
         this.azure = azure;
     }
 
+    /**
+     * GCP configures failure domain information for the GCP platform.
+     */
     @JsonProperty("gcp")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GCPFailureDomain> getGcp() {
         return gcp;
     }
 
+    /**
+     * GCP configures failure domain information for the GCP platform.
+     */
     @JsonProperty("gcp")
     public void setGcp(List<GCPFailureDomain> gcp) {
         this.gcp = gcp;
     }
 
+    /**
+     * nutanix configures failure domain information for the Nutanix platform.
+     */
     @JsonProperty("nutanix")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NutanixFailureDomainReference> getNutanix() {
         return nutanix;
     }
 
+    /**
+     * nutanix configures failure domain information for the Nutanix platform.
+     */
     @JsonProperty("nutanix")
     public void setNutanix(List<NutanixFailureDomainReference> nutanix) {
         this.nutanix = nutanix;
     }
 
+    /**
+     * OpenStack configures failure domain information for the OpenStack platform.
+     */
     @JsonProperty("openstack")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OpenStackFailureDomain> getOpenstack() {
         return openstack;
     }
 
+    /**
+     * OpenStack configures failure domain information for the OpenStack platform.
+     */
     @JsonProperty("openstack")
     public void setOpenstack(List<OpenStackFailureDomain> openstack) {
         this.openstack = openstack;
     }
 
+    /**
+     * Platform identifies the platform for which the FailureDomain represents. Currently supported values are AWS, Azure, GCP, OpenStack, VSphere and Nutanix.
+     */
     @JsonProperty("platform")
     public String getPlatform() {
         return platform;
     }
 
+    /**
+     * Platform identifies the platform for which the FailureDomain represents. Currently supported values are AWS, Azure, GCP, OpenStack, VSphere and Nutanix.
+     */
     @JsonProperty("platform")
     public void setPlatform(String platform) {
         this.platform = platform;
     }
 
+    /**
+     * vsphere configures failure domain information for the VSphere platform.
+     */
     @JsonProperty("vsphere")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VSphereFailureDomain> getVsphere() {
         return vsphere;
     }
 
+    /**
+     * vsphere configures failure domain information for the VSphere platform.
+     */
     @JsonProperty("vsphere")
     public void setVsphere(List<VSphereFailureDomain> vsphere) {
         this.vsphere = vsphere;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/GCPFailureDomain.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/GCPFailureDomain.java
index 853f7c51e94..f0f28f7a8f7 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/GCPFailureDomain.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/GCPFailureDomain.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPFailureDomain configures failure domain information for the GCP platform
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public GCPFailureDomain(String zone) {
         this.zone = zone;
     }
 
+    /**
+     * Zone is the zone in which the GCP machine provider will create the VM.
+     */
     @JsonProperty("zone")
     public String getZone() {
         return zone;
     }
 
+    /**
+     * Zone is the zone in which the GCP machine provider will create the VM.
+     */
     @JsonProperty("zone")
     public void setZone(String zone) {
         this.zone = zone;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/LoadBalancerReference.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/LoadBalancerReference.java
index 8a203eb25da..4972bf7c892 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/LoadBalancerReference.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/LoadBalancerReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LoadBalancerReference is a reference to a load balancer on IBM Cloud virtual private cloud(VPC).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public LoadBalancerReference(String name, String type) {
         this.type = type;
     }
 
+    /**
+     * name of the LoadBalancer in IBM Cloud VPC. The name should be between 1 and 63 characters long and may consist of lowercase alphanumeric characters and hyphens only. The value must not end with a hyphen. It is a reference to existing LoadBalancer created by openshift installer component.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name of the LoadBalancer in IBM Cloud VPC. The name should be between 1 and 63 characters long and may consist of lowercase alphanumeric characters and hyphens only. The value must not end with a hyphen. It is a reference to existing LoadBalancer created by openshift installer component.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * type of the LoadBalancer service supported by IBM Cloud VPC. Currently, only Application LoadBalancer is supported. More details about Application LoadBalancer https://cloud.ibm.com/docs/vpc?topic=vpc-load-balancers-about&amp;interface=ui Supported values are Application.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type of the LoadBalancer service supported by IBM Cloud VPC. Currently, only Application LoadBalancer is supported. More details about Application LoadBalancer https://cloud.ibm.com/docs/vpc?topic=vpc-load-balancers-about&amp;interface=ui Supported values are Application.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixCategory.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixCategory.java
index 6b8c6249088..8133b959dc0 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixCategory.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixCategory.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NutanixCategory identifies a pair of prism category key and value
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public NutanixCategory(String key, String value) {
         this.value = value;
     }
 
+    /**
+     * key is the prism category key name
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * key is the prism category key name
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * value is the prism category value associated with the key
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * value is the prism category value associated with the key
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixFailureDomainReference.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixFailureDomainReference.java
index cd250f1ac51..5b732319405 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixFailureDomainReference.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixFailureDomainReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NutanixFailureDomainReference refers to the failure domain of the Nutanix platform.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public NutanixFailureDomainReference(String name) {
         this.name = name;
     }
 
+    /**
+     * name of the failure domain in which the nutanix machine provider will create the VM. Failure domains are defined in a cluster's config.openshift.io/Infrastructure resource.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name of the failure domain in which the nutanix machine provider will create the VM. Failure domains are defined in a cluster's config.openshift.io/Infrastructure resource.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixGPU.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixGPU.java
index eca77aecd62..5f84273b5a2 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixGPU.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixGPU.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NutanixGPU holds the identity of a Nutanix GPU resource in the Prism Central
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public NutanixGPU(Integer deviceID, String name, String type) {
         this.type = type;
     }
 
+    /**
+     * deviceID is the GPU device ID with the integer value.
+     */
     @JsonProperty("deviceID")
     public Integer getDeviceID() {
         return deviceID;
     }
 
+    /**
+     * deviceID is the GPU device ID with the integer value.
+     */
     @JsonProperty("deviceID")
     public void setDeviceID(Integer deviceID) {
         this.deviceID = deviceID;
     }
 
+    /**
+     * name is the GPU device name
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the GPU device name
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * type is the identifier type of the GPU device. Valid values are Name and DeviceID.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the identifier type of the GPU device. Valid values are Name and DeviceID.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixMachineProviderConfig.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixMachineProviderConfig.java
index 9de05964fe9..5dc7cdccfec 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixMachineProviderConfig.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixMachineProviderConfig.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NutanixMachineProviderConfig is the Schema for the nutanixmachineproviderconfigs API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -92,9 +95,6 @@
 public class NutanixMachineProviderConfig implements Editable<NutanixMachineProviderConfigBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machine.openshift.io/v1";
     @JsonProperty("bootType")
@@ -116,9 +116,6 @@ public class NutanixMachineProviderConfig implements Editable<NutanixMachineProv
     private List<NutanixGPU> gpus = new ArrayList<>();
     @JsonProperty("image")
     private NutanixResourceIdentifier image;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "NutanixMachineProviderConfig";
     @JsonProperty("memorySize")
@@ -170,7 +167,7 @@ public NutanixMachineProviderConfig(String apiVersion, String bootType, List<Nut
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -178,98 +175,146 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * bootType indicates the boot type (Legacy, UEFI or SecureBoot) the Machine's VM uses to boot. If this field is empty or omitted, the VM will use the default boot type "Legacy" to boot. "SecureBoot" depends on "UEFI" boot, i.e., enabling "SecureBoot" means that "UEFI" boot is also enabled.
+     */
     @JsonProperty("bootType")
     public String getBootType() {
         return bootType;
     }
 
+    /**
+     * bootType indicates the boot type (Legacy, UEFI or SecureBoot) the Machine's VM uses to boot. If this field is empty or omitted, the VM will use the default boot type "Legacy" to boot. "SecureBoot" depends on "UEFI" boot, i.e., enabling "SecureBoot" means that "UEFI" boot is also enabled.
+     */
     @JsonProperty("bootType")
     public void setBootType(String bootType) {
         this.bootType = bootType;
     }
 
+    /**
+     * categories optionally adds one or more prism categories (each with key and value) for the Machine's VM to associate with. All the category key and value pairs specified must already exist in the prism central.
+     */
     @JsonProperty("categories")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NutanixCategory> getCategories() {
         return categories;
     }
 
+    /**
+     * categories optionally adds one or more prism categories (each with key and value) for the Machine's VM to associate with. All the category key and value pairs specified must already exist in the prism central.
+     */
     @JsonProperty("categories")
     public void setCategories(List<NutanixCategory> categories) {
         this.categories = categories;
     }
 
+    /**
+     * NutanixMachineProviderConfig is the Schema for the nutanixmachineproviderconfigs API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("cluster")
     public NutanixResourceIdentifier getCluster() {
         return cluster;
     }
 
+    /**
+     * NutanixMachineProviderConfig is the Schema for the nutanixmachineproviderconfigs API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("cluster")
     public void setCluster(NutanixResourceIdentifier cluster) {
         this.cluster = cluster;
     }
 
+    /**
+     * NutanixMachineProviderConfig is the Schema for the nutanixmachineproviderconfigs API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("credentialsSecret")
     public LocalObjectReference getCredentialsSecret() {
         return credentialsSecret;
     }
 
+    /**
+     * NutanixMachineProviderConfig is the Schema for the nutanixmachineproviderconfigs API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("credentialsSecret")
     public void setCredentialsSecret(LocalObjectReference credentialsSecret) {
         this.credentialsSecret = credentialsSecret;
     }
 
+    /**
+     * dataDisks holds information of the data disks to attach to the Machine's VM
+     */
     @JsonProperty("dataDisks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NutanixVMDisk> getDataDisks() {
         return dataDisks;
     }
 
+    /**
+     * dataDisks holds information of the data disks to attach to the Machine's VM
+     */
     @JsonProperty("dataDisks")
     public void setDataDisks(List<NutanixVMDisk> dataDisks) {
         this.dataDisks = dataDisks;
     }
 
+    /**
+     * NutanixMachineProviderConfig is the Schema for the nutanixmachineproviderconfigs API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("failureDomain")
     public NutanixFailureDomainReference getFailureDomain() {
         return failureDomain;
     }
 
+    /**
+     * NutanixMachineProviderConfig is the Schema for the nutanixmachineproviderconfigs API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("failureDomain")
     public void setFailureDomain(NutanixFailureDomainReference failureDomain) {
         this.failureDomain = failureDomain;
     }
 
+    /**
+     * gpus is a list of GPU devices to attach to the machine's VM. The GPU devices should already exist in Prism Central and associated with one of the Prism Element's hosts and available for the VM to attach (in "UNUSED" status).
+     */
     @JsonProperty("gpus")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NutanixGPU> getGpus() {
         return gpus;
     }
 
+    /**
+     * gpus is a list of GPU devices to attach to the machine's VM. The GPU devices should already exist in Prism Central and associated with one of the Prism Element's hosts and available for the VM to attach (in "UNUSED" status).
+     */
     @JsonProperty("gpus")
     public void setGpus(List<NutanixGPU> gpus) {
         this.gpus = gpus;
     }
 
+    /**
+     * NutanixMachineProviderConfig is the Schema for the nutanixmachineproviderconfigs API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("image")
     public NutanixResourceIdentifier getImage() {
         return image;
     }
 
+    /**
+     * NutanixMachineProviderConfig is the Schema for the nutanixmachineproviderconfigs API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("image")
     public void setImage(NutanixResourceIdentifier image) {
         this.image = image;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -277,89 +322,137 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * NutanixMachineProviderConfig is the Schema for the nutanixmachineproviderconfigs API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("memorySize")
     public Quantity getMemorySize() {
         return memorySize;
     }
 
+    /**
+     * NutanixMachineProviderConfig is the Schema for the nutanixmachineproviderconfigs API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("memorySize")
     public void setMemorySize(Quantity memorySize) {
         this.memorySize = memorySize;
     }
 
+    /**
+     * NutanixMachineProviderConfig is the Schema for the nutanixmachineproviderconfigs API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * NutanixMachineProviderConfig is the Schema for the nutanixmachineproviderconfigs API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * NutanixMachineProviderConfig is the Schema for the nutanixmachineproviderconfigs API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("project")
     public NutanixResourceIdentifier getProject() {
         return project;
     }
 
+    /**
+     * NutanixMachineProviderConfig is the Schema for the nutanixmachineproviderconfigs API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("project")
     public void setProject(NutanixResourceIdentifier project) {
         this.project = project;
     }
 
+    /**
+     * subnets holds a list of identifiers (one or more) of the cluster's network subnets for the Machine's VM to connect to. The subnet identifiers (uuid or name) can be obtained from the Prism Central console or using the prism_central API.
+     */
     @JsonProperty("subnets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NutanixResourceIdentifier> getSubnets() {
         return subnets;
     }
 
+    /**
+     * subnets holds a list of identifiers (one or more) of the cluster's network subnets for the Machine's VM to connect to. The subnet identifiers (uuid or name) can be obtained from the Prism Central console or using the prism_central API.
+     */
     @JsonProperty("subnets")
     public void setSubnets(List<NutanixResourceIdentifier> subnets) {
         this.subnets = subnets;
     }
 
+    /**
+     * NutanixMachineProviderConfig is the Schema for the nutanixmachineproviderconfigs API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("systemDiskSize")
     public Quantity getSystemDiskSize() {
         return systemDiskSize;
     }
 
+    /**
+     * NutanixMachineProviderConfig is the Schema for the nutanixmachineproviderconfigs API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("systemDiskSize")
     public void setSystemDiskSize(Quantity systemDiskSize) {
         this.systemDiskSize = systemDiskSize;
     }
 
+    /**
+     * NutanixMachineProviderConfig is the Schema for the nutanixmachineproviderconfigs API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("userDataSecret")
     public LocalObjectReference getUserDataSecret() {
         return userDataSecret;
     }
 
+    /**
+     * NutanixMachineProviderConfig is the Schema for the nutanixmachineproviderconfigs API Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("userDataSecret")
     public void setUserDataSecret(LocalObjectReference userDataSecret) {
         this.userDataSecret = userDataSecret;
     }
 
+    /**
+     * vcpuSockets is the number of vCPU sockets of the VM
+     */
     @JsonProperty("vcpuSockets")
     public Integer getVcpuSockets() {
         return vcpuSockets;
     }
 
+    /**
+     * vcpuSockets is the number of vCPU sockets of the VM
+     */
     @JsonProperty("vcpuSockets")
     public void setVcpuSockets(Integer vcpuSockets) {
         this.vcpuSockets = vcpuSockets;
     }
 
+    /**
+     * vcpusPerSocket is the number of vCPUs per socket of the VM
+     */
     @JsonProperty("vcpusPerSocket")
     public Integer getVcpusPerSocket() {
         return vcpusPerSocket;
     }
 
+    /**
+     * vcpusPerSocket is the number of vCPUs per socket of the VM
+     */
     @JsonProperty("vcpusPerSocket")
     public void setVcpusPerSocket(Integer vcpusPerSocket) {
         this.vcpusPerSocket = vcpusPerSocket;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixMachineProviderStatus.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixMachineProviderStatus.java
index 42d81ebd439..fafdd80c2fc 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixMachineProviderStatus.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixMachineProviderStatus.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NutanixMachineProviderStatus is the type that will be embedded in a Machine.Status.ProviderStatus field. It contains nutanix-specific status information. Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class NutanixMachineProviderStatus implements Editable<NutanixMachineProviderStatusBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machine.openshift.io/v1";
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<Condition> conditions = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "NutanixMachineProviderStatus";
     @JsonProperty("vmUUID")
@@ -111,7 +108,7 @@ public NutanixMachineProviderStatus(String apiVersion, List<Condition> condition
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * conditions is a set of conditions associated with the Machine to indicate errors or other status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a set of conditions associated with the Machine to indicate errors or other status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * vmUUID is the Machine associated VM's UUID The field is missing before the VM is created. Once the VM is created, the field is filled with the VM's UUID and it will not change. The vmUUID is used to find the VM when updating the Machine status, and to delete the VM when the Machine is deleted.
+     */
     @JsonProperty("vmUUID")
     public String getVmUUID() {
         return vmUUID;
     }
 
+    /**
+     * vmUUID is the Machine associated VM's UUID The field is missing before the VM is created. Once the VM is created, the field is filled with the VM's UUID and it will not change. The vmUUID is used to find the VM when updating the Machine status, and to delete the VM when the Machine is deleted.
+     */
     @JsonProperty("vmUUID")
     public void setVmUUID(String vmUUID) {
         this.vmUUID = vmUUID;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixResourceIdentifier.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixResourceIdentifier.java
index 1e0a22dd2db..58a657cad4a 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixResourceIdentifier.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixResourceIdentifier.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NutanixResourceIdentifier holds the identity of a Nutanix PC resource (cluster, image, subnet, etc.)
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public NutanixResourceIdentifier(String name, String type, String uuid) {
         this.uuid = uuid;
     }
 
+    /**
+     * name is the resource name in the PC
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the resource name in the PC
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Type is the identifier type to use for this resource.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the identifier type to use for this resource.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * uuid is the UUID of the resource in the PC.
+     */
     @JsonProperty("uuid")
     public String getUuid() {
         return uuid;
     }
 
+    /**
+     * uuid is the UUID of the resource in the PC.
+     */
     @JsonProperty("uuid")
     public void setUuid(String uuid) {
         this.uuid = uuid;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixStorageResourceIdentifier.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixStorageResourceIdentifier.java
index cb5ad33d614..794b10daa95 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixStorageResourceIdentifier.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixStorageResourceIdentifier.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NutanixStorageResourceIdentifier holds the identity of a Nutanix storage resource (storage_container, etc.)
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public NutanixStorageResourceIdentifier(String type, String uuid) {
         this.uuid = uuid;
     }
 
+    /**
+     * type is the identifier type to use for this resource. The valid value is "uuid".
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the identifier type to use for this resource. The valid value is "uuid".
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * uuid is the UUID of the storage resource in the PC.
+     */
     @JsonProperty("uuid")
     public String getUuid() {
         return uuid;
     }
 
+    /**
+     * uuid is the UUID of the storage resource in the PC.
+     */
     @JsonProperty("uuid")
     public void setUuid(String uuid) {
         this.uuid = uuid;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixVMDisk.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixVMDisk.java
index be26a3bce9e..c4c7a7d7181 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixVMDisk.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixVMDisk.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NutanixDataDisk specifies the VM data disk configuration parameters.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,41 +94,65 @@ public NutanixVMDisk(NutanixResourceIdentifier dataSource, NutanixVMDiskDevicePr
         this.storageConfig = storageConfig;
     }
 
+    /**
+     * NutanixDataDisk specifies the VM data disk configuration parameters.
+     */
     @JsonProperty("dataSource")
     public NutanixResourceIdentifier getDataSource() {
         return dataSource;
     }
 
+    /**
+     * NutanixDataDisk specifies the VM data disk configuration parameters.
+     */
     @JsonProperty("dataSource")
     public void setDataSource(NutanixResourceIdentifier dataSource) {
         this.dataSource = dataSource;
     }
 
+    /**
+     * NutanixDataDisk specifies the VM data disk configuration parameters.
+     */
     @JsonProperty("deviceProperties")
     public NutanixVMDiskDeviceProperties getDeviceProperties() {
         return deviceProperties;
     }
 
+    /**
+     * NutanixDataDisk specifies the VM data disk configuration parameters.
+     */
     @JsonProperty("deviceProperties")
     public void setDeviceProperties(NutanixVMDiskDeviceProperties deviceProperties) {
         this.deviceProperties = deviceProperties;
     }
 
+    /**
+     * NutanixDataDisk specifies the VM data disk configuration parameters.
+     */
     @JsonProperty("diskSize")
     public Quantity getDiskSize() {
         return diskSize;
     }
 
+    /**
+     * NutanixDataDisk specifies the VM data disk configuration parameters.
+     */
     @JsonProperty("diskSize")
     public void setDiskSize(Quantity diskSize) {
         this.diskSize = diskSize;
     }
 
+    /**
+     * NutanixDataDisk specifies the VM data disk configuration parameters.
+     */
     @JsonProperty("storageConfig")
     public NutanixVMStorageConfig getStorageConfig() {
         return storageConfig;
     }
 
+    /**
+     * NutanixDataDisk specifies the VM data disk configuration parameters.
+     */
     @JsonProperty("storageConfig")
     public void setStorageConfig(NutanixVMStorageConfig storageConfig) {
         this.storageConfig = storageConfig;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixVMDiskDeviceProperties.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixVMDiskDeviceProperties.java
index de570ba948b..64f4ccefa3c 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixVMDiskDeviceProperties.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixVMDiskDeviceProperties.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NutanixVMDiskDeviceProperties specifies the disk device properties.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public NutanixVMDiskDeviceProperties(String adapterType, Integer deviceIndex, St
         this.deviceType = deviceType;
     }
 
+    /**
+     * adapterType is the adapter type of the disk address. If the deviceType is "Disk", the valid adapterType can be "SCSI", "IDE", "PCI", "SATA" or "SPAPR". If the deviceType is "CDRom", the valid adapterType can be "IDE" or "SATA".
+     */
     @JsonProperty("adapterType")
     public String getAdapterType() {
         return adapterType;
     }
 
+    /**
+     * adapterType is the adapter type of the disk address. If the deviceType is "Disk", the valid adapterType can be "SCSI", "IDE", "PCI", "SATA" or "SPAPR". If the deviceType is "CDRom", the valid adapterType can be "IDE" or "SATA".
+     */
     @JsonProperty("adapterType")
     public void setAdapterType(String adapterType) {
         this.adapterType = adapterType;
     }
 
+    /**
+     * deviceIndex is the index of the disk address. The valid values are non-negative integers, with the default value 0. For a Machine VM, the deviceIndex for the disks with the same deviceType.adapterType combination should start from 0 and increase consecutively afterwards. Note that for each Machine VM, the Disk.SCSI.0 and CDRom.IDE.0 are reserved to be used by the VM's system. So for dataDisks of Disk.SCSI and CDRom.IDE, the deviceIndex should start from 1.
+     */
     @JsonProperty("deviceIndex")
     public Integer getDeviceIndex() {
         return deviceIndex;
     }
 
+    /**
+     * deviceIndex is the index of the disk address. The valid values are non-negative integers, with the default value 0. For a Machine VM, the deviceIndex for the disks with the same deviceType.adapterType combination should start from 0 and increase consecutively afterwards. Note that for each Machine VM, the Disk.SCSI.0 and CDRom.IDE.0 are reserved to be used by the VM's system. So for dataDisks of Disk.SCSI and CDRom.IDE, the deviceIndex should start from 1.
+     */
     @JsonProperty("deviceIndex")
     public void setDeviceIndex(Integer deviceIndex) {
         this.deviceIndex = deviceIndex;
     }
 
+    /**
+     * deviceType specifies the disk device type. The valid values are "Disk" and "CDRom", and the default is "Disk".
+     */
     @JsonProperty("deviceType")
     public String getDeviceType() {
         return deviceType;
     }
 
+    /**
+     * deviceType specifies the disk device type. The valid values are "Disk" and "CDRom", and the default is "Disk".
+     */
     @JsonProperty("deviceType")
     public void setDeviceType(String deviceType) {
         this.deviceType = deviceType;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixVMStorageConfig.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixVMStorageConfig.java
index 01223745489..98f7e2d6624 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixVMStorageConfig.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/NutanixVMStorageConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NutanixVMStorageConfig specifies the storage configuration parameters for VM disks.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public NutanixVMStorageConfig(String diskMode, NutanixStorageResourceIdentifier
         this.storageContainer = storageContainer;
     }
 
+    /**
+     * diskMode specifies the disk mode. The valid values are Standard and Flash, and the default is Standard.
+     */
     @JsonProperty("diskMode")
     public String getDiskMode() {
         return diskMode;
     }
 
+    /**
+     * diskMode specifies the disk mode. The valid values are Standard and Flash, and the default is Standard.
+     */
     @JsonProperty("diskMode")
     public void setDiskMode(String diskMode) {
         this.diskMode = diskMode;
     }
 
+    /**
+     * NutanixVMStorageConfig specifies the storage configuration parameters for VM disks.
+     */
     @JsonProperty("storageContainer")
     public NutanixStorageResourceIdentifier getStorageContainer() {
         return storageContainer;
     }
 
+    /**
+     * NutanixVMStorageConfig specifies the storage configuration parameters for VM disks.
+     */
     @JsonProperty("storageContainer")
     public void setStorageContainer(NutanixStorageResourceIdentifier storageContainer) {
         this.storageContainer = storageContainer;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/OpenShiftMachineV1Beta1MachineTemplate.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/OpenShiftMachineV1Beta1MachineTemplate.java
index f9b3cead609..be052b92091 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/OpenShiftMachineV1Beta1MachineTemplate.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/OpenShiftMachineV1Beta1MachineTemplate.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OpenShiftMachineV1Beta1MachineTemplate is a template for the ControlPlaneMachineSet to create Machines from the v1beta1.machine.openshift.io API group.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,31 +90,49 @@ public OpenShiftMachineV1Beta1MachineTemplate(FailureDomains failureDomains, Con
         this.spec = spec;
     }
 
+    /**
+     * OpenShiftMachineV1Beta1MachineTemplate is a template for the ControlPlaneMachineSet to create Machines from the v1beta1.machine.openshift.io API group.
+     */
     @JsonProperty("failureDomains")
     public FailureDomains getFailureDomains() {
         return failureDomains;
     }
 
+    /**
+     * OpenShiftMachineV1Beta1MachineTemplate is a template for the ControlPlaneMachineSet to create Machines from the v1beta1.machine.openshift.io API group.
+     */
     @JsonProperty("failureDomains")
     public void setFailureDomains(FailureDomains failureDomains) {
         this.failureDomains = failureDomains;
     }
 
+    /**
+     * OpenShiftMachineV1Beta1MachineTemplate is a template for the ControlPlaneMachineSet to create Machines from the v1beta1.machine.openshift.io API group.
+     */
     @JsonProperty("metadata")
     public ControlPlaneMachineSetTemplateObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OpenShiftMachineV1Beta1MachineTemplate is a template for the ControlPlaneMachineSet to create Machines from the v1beta1.machine.openshift.io API group.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ControlPlaneMachineSetTemplateObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * OpenShiftMachineV1Beta1MachineTemplate is a template for the ControlPlaneMachineSet to create Machines from the v1beta1.machine.openshift.io API group.
+     */
     @JsonProperty("spec")
     public MachineSpec getSpec() {
         return spec;
     }
 
+    /**
+     * OpenShiftMachineV1Beta1MachineTemplate is a template for the ControlPlaneMachineSet to create Machines from the v1beta1.machine.openshift.io API group.
+     */
     @JsonProperty("spec")
     public void setSpec(MachineSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/OpenStackFailureDomain.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/OpenStackFailureDomain.java
index ac8f7e0247f..93d67954738 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/OpenStackFailureDomain.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/OpenStackFailureDomain.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OpenStackFailureDomain configures failure domain information for the OpenStack platform.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public OpenStackFailureDomain(String availabilityZone, RootVolume rootVolume) {
         this.rootVolume = rootVolume;
     }
 
+    /**
+     * availabilityZone is the nova availability zone in which the OpenStack machine provider will create the VM. If not specified, the VM will be created in the default availability zone specified in the nova configuration. Availability zone names must NOT contain : since it is used by admin users to specify hosts where instances are launched in server creation. Also, it must not contain spaces otherwise it will lead to node that belongs to this availability zone register failure, see kubernetes/cloud-provider-openstack#1379 for further information. The maximum length of availability zone name is 63 as per labels limits.
+     */
     @JsonProperty("availabilityZone")
     public String getAvailabilityZone() {
         return availabilityZone;
     }
 
+    /**
+     * availabilityZone is the nova availability zone in which the OpenStack machine provider will create the VM. If not specified, the VM will be created in the default availability zone specified in the nova configuration. Availability zone names must NOT contain : since it is used by admin users to specify hosts where instances are launched in server creation. Also, it must not contain spaces otherwise it will lead to node that belongs to this availability zone register failure, see kubernetes/cloud-provider-openstack#1379 for further information. The maximum length of availability zone name is 63 as per labels limits.
+     */
     @JsonProperty("availabilityZone")
     public void setAvailabilityZone(String availabilityZone) {
         this.availabilityZone = availabilityZone;
     }
 
+    /**
+     * OpenStackFailureDomain configures failure domain information for the OpenStack platform.
+     */
     @JsonProperty("rootVolume")
     public RootVolume getRootVolume() {
         return rootVolume;
     }
 
+    /**
+     * OpenStackFailureDomain configures failure domain information for the OpenStack platform.
+     */
     @JsonProperty("rootVolume")
     public void setRootVolume(RootVolume rootVolume) {
         this.rootVolume = rootVolume;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/PowerVSMachineProviderConfig.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/PowerVSMachineProviderConfig.java
index f09549100a9..c3a611318b1 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/PowerVSMachineProviderConfig.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/PowerVSMachineProviderConfig.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PowerVSMachineProviderConfig is the type that will be embedded in a Machine.Spec.ProviderSpec field for a PowerVS virtual machine. It is used by the PowerVS machine actuator to create a single Machine.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,9 +90,6 @@
 public class PowerVSMachineProviderConfig implements Editable<PowerVSMachineProviderConfigBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machine.openshift.io/v1";
     @JsonProperty("credentialsSecret")
@@ -98,9 +98,6 @@ public class PowerVSMachineProviderConfig implements Editable<PowerVSMachineProv
     private PowerVSResource image;
     @JsonProperty("keyPairName")
     private String keyPairName;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PowerVSMachineProviderConfig";
     @JsonProperty("loadBalancers")
@@ -150,7 +147,7 @@ public PowerVSMachineProviderConfig(String apiVersion, PowerVSSecretReference cr
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -158,45 +155,63 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PowerVSMachineProviderConfig is the type that will be embedded in a Machine.Spec.ProviderSpec field for a PowerVS virtual machine. It is used by the PowerVS machine actuator to create a single Machine.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("credentialsSecret")
     public PowerVSSecretReference getCredentialsSecret() {
         return credentialsSecret;
     }
 
+    /**
+     * PowerVSMachineProviderConfig is the type that will be embedded in a Machine.Spec.ProviderSpec field for a PowerVS virtual machine. It is used by the PowerVS machine actuator to create a single Machine.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("credentialsSecret")
     public void setCredentialsSecret(PowerVSSecretReference credentialsSecret) {
         this.credentialsSecret = credentialsSecret;
     }
 
+    /**
+     * PowerVSMachineProviderConfig is the type that will be embedded in a Machine.Spec.ProviderSpec field for a PowerVS virtual machine. It is used by the PowerVS machine actuator to create a single Machine.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("image")
     public PowerVSResource getImage() {
         return image;
     }
 
+    /**
+     * PowerVSMachineProviderConfig is the type that will be embedded in a Machine.Spec.ProviderSpec field for a PowerVS virtual machine. It is used by the PowerVS machine actuator to create a single Machine.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("image")
     public void setImage(PowerVSResource image) {
         this.image = image;
     }
 
+    /**
+     * keyPairName is the name of the KeyPair to use for SSH. The key pair will be exposed to the instance via the instance metadata service. On boot, the OS will copy the public keypair into the authorized keys for the core user.
+     */
     @JsonProperty("keyPairName")
     public String getKeyPairName() {
         return keyPairName;
     }
 
+    /**
+     * keyPairName is the name of the KeyPair to use for SSH. The key pair will be exposed to the instance via the instance metadata service. On boot, the OS will copy the public keypair into the authorized keys for the core user.
+     */
     @JsonProperty("keyPairName")
     public void setKeyPairName(String keyPairName) {
         this.keyPairName = keyPairName;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -204,99 +219,153 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * loadBalancers is the set of load balancers to which the new control plane instance should be added once it is created.
+     */
     @JsonProperty("loadBalancers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LoadBalancerReference> getLoadBalancers() {
         return loadBalancers;
     }
 
+    /**
+     * loadBalancers is the set of load balancers to which the new control plane instance should be added once it is created.
+     */
     @JsonProperty("loadBalancers")
     public void setLoadBalancers(List<LoadBalancerReference> loadBalancers) {
         this.loadBalancers = loadBalancers;
     }
 
+    /**
+     * memoryGiB is the size of a virtual machine's memory, in GiB. maximum value for the MemoryGiB depends on the selected SystemType. when SystemType is set to e880 maximum MemoryGiB value is 7463 GiB. when SystemType is set to e980 maximum MemoryGiB value is 15307 GiB. when SystemType is set to s922 maximum MemoryGiB value is 942 GiB. The minimum memory is 32 GiB. When omitted, this means the user has no opinion and the platform is left to choose a reasonable default, which is subject to change over time. The current default is 32.
+     */
     @JsonProperty("memoryGiB")
     public Integer getMemoryGiB() {
         return memoryGiB;
     }
 
+    /**
+     * memoryGiB is the size of a virtual machine's memory, in GiB. maximum value for the MemoryGiB depends on the selected SystemType. when SystemType is set to e880 maximum MemoryGiB value is 7463 GiB. when SystemType is set to e980 maximum MemoryGiB value is 15307 GiB. when SystemType is set to s922 maximum MemoryGiB value is 942 GiB. The minimum memory is 32 GiB. When omitted, this means the user has no opinion and the platform is left to choose a reasonable default, which is subject to change over time. The current default is 32.
+     */
     @JsonProperty("memoryGiB")
     public void setMemoryGiB(Integer memoryGiB) {
         this.memoryGiB = memoryGiB;
     }
 
+    /**
+     * PowerVSMachineProviderConfig is the type that will be embedded in a Machine.Spec.ProviderSpec field for a PowerVS virtual machine. It is used by the PowerVS machine actuator to create a single Machine.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PowerVSMachineProviderConfig is the type that will be embedded in a Machine.Spec.ProviderSpec field for a PowerVS virtual machine. It is used by the PowerVS machine actuator to create a single Machine.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PowerVSMachineProviderConfig is the type that will be embedded in a Machine.Spec.ProviderSpec field for a PowerVS virtual machine. It is used by the PowerVS machine actuator to create a single Machine.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("network")
     public PowerVSResource getNetwork() {
         return network;
     }
 
+    /**
+     * PowerVSMachineProviderConfig is the type that will be embedded in a Machine.Spec.ProviderSpec field for a PowerVS virtual machine. It is used by the PowerVS machine actuator to create a single Machine.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("network")
     public void setNetwork(PowerVSResource network) {
         this.network = network;
     }
 
+    /**
+     * processorType is the VM instance processor type. It must be set to one of the following values: Dedicated, Capped or Shared. Dedicated: resources are allocated for a specific client, The hypervisor makes a 1:1 binding of a partition’s processor to a physical processor core. Shared: Shared among other clients. Capped: Shared, but resources do not expand beyond those that are requested, the amount of CPU time is Capped to the value specified for the entitlement. if the processorType is selected as Dedicated, then processors value cannot be fractional. When omitted, this means that the user has no opinion and the platform is left to choose a reasonable default, which is subject to change over time. The current default is Shared.
+     */
     @JsonProperty("processorType")
     public String getProcessorType() {
         return processorType;
     }
 
+    /**
+     * processorType is the VM instance processor type. It must be set to one of the following values: Dedicated, Capped or Shared. Dedicated: resources are allocated for a specific client, The hypervisor makes a 1:1 binding of a partition’s processor to a physical processor core. Shared: Shared among other clients. Capped: Shared, but resources do not expand beyond those that are requested, the amount of CPU time is Capped to the value specified for the entitlement. if the processorType is selected as Dedicated, then processors value cannot be fractional. When omitted, this means that the user has no opinion and the platform is left to choose a reasonable default, which is subject to change over time. The current default is Shared.
+     */
     @JsonProperty("processorType")
     public void setProcessorType(String processorType) {
         this.processorType = processorType;
     }
 
+    /**
+     * PowerVSMachineProviderConfig is the type that will be embedded in a Machine.Spec.ProviderSpec field for a PowerVS virtual machine. It is used by the PowerVS machine actuator to create a single Machine.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("processors")
     public IntOrString getProcessors() {
         return processors;
     }
 
+    /**
+     * PowerVSMachineProviderConfig is the type that will be embedded in a Machine.Spec.ProviderSpec field for a PowerVS virtual machine. It is used by the PowerVS machine actuator to create a single Machine.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("processors")
     public void setProcessors(IntOrString processors) {
         this.processors = processors;
     }
 
+    /**
+     * PowerVSMachineProviderConfig is the type that will be embedded in a Machine.Spec.ProviderSpec field for a PowerVS virtual machine. It is used by the PowerVS machine actuator to create a single Machine.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("serviceInstance")
     public PowerVSResource getServiceInstance() {
         return serviceInstance;
     }
 
+    /**
+     * PowerVSMachineProviderConfig is the type that will be embedded in a Machine.Spec.ProviderSpec field for a PowerVS virtual machine. It is used by the PowerVS machine actuator to create a single Machine.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("serviceInstance")
     public void setServiceInstance(PowerVSResource serviceInstance) {
         this.serviceInstance = serviceInstance;
     }
 
+    /**
+     * systemType is the System type used to host the instance. systemType determines the number of cores and memory that is available. Few of the supported SystemTypes are s922,e880,e980. e880 systemType available only in Dallas Datacenters. e980 systemType available in Datacenters except Dallas and Washington. When omitted, this means that the user has no opinion and the platform is left to choose a reasonable default, which is subject to change over time. The current default is s922 which is generally available.
+     */
     @JsonProperty("systemType")
     public String getSystemType() {
         return systemType;
     }
 
+    /**
+     * systemType is the System type used to host the instance. systemType determines the number of cores and memory that is available. Few of the supported SystemTypes are s922,e880,e980. e880 systemType available only in Dallas Datacenters. e980 systemType available in Datacenters except Dallas and Washington. When omitted, this means that the user has no opinion and the platform is left to choose a reasonable default, which is subject to change over time. The current default is s922 which is generally available.
+     */
     @JsonProperty("systemType")
     public void setSystemType(String systemType) {
         this.systemType = systemType;
     }
 
+    /**
+     * PowerVSMachineProviderConfig is the type that will be embedded in a Machine.Spec.ProviderSpec field for a PowerVS virtual machine. It is used by the PowerVS machine actuator to create a single Machine.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("userDataSecret")
     public PowerVSSecretReference getUserDataSecret() {
         return userDataSecret;
     }
 
+    /**
+     * PowerVSMachineProviderConfig is the type that will be embedded in a Machine.Spec.ProviderSpec field for a PowerVS virtual machine. It is used by the PowerVS machine actuator to create a single Machine.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("userDataSecret")
     public void setUserDataSecret(PowerVSSecretReference userDataSecret) {
         this.userDataSecret = userDataSecret;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/PowerVSMachineProviderStatus.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/PowerVSMachineProviderStatus.java
index fd34167b0c9..75f0f1f2161 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/PowerVSMachineProviderStatus.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/PowerVSMachineProviderStatus.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PowerVSMachineProviderStatus is the type that will be embedded in a Machine.Status.ProviderStatus field. It contains PowerVS-specific status information.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -80,9 +83,6 @@
 public class PowerVSMachineProviderStatus implements Editable<PowerVSMachineProviderStatusBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machine.openshift.io/v1";
     @JsonProperty("conditions")
@@ -92,9 +92,6 @@ public class PowerVSMachineProviderStatus implements Editable<PowerVSMachineProv
     private String instanceId;
     @JsonProperty("instanceState")
     private String instanceState;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PowerVSMachineProviderStatus";
     @JsonProperty("serviceInstanceID")
@@ -119,7 +116,7 @@ public PowerVSMachineProviderStatus(String apiVersion, List<Condition> condition
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -127,46 +124,64 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * conditions is a set of conditions associated with the Machine to indicate errors or other status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a set of conditions associated with the Machine to indicate errors or other status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * instanceId is the instance ID of the machine created in PowerVS instanceId uniquely identifies a Power VS server instance(VM) under a Power VS service. This will help in updating or deleting a VM in Power VS Cloud
+     */
     @JsonProperty("instanceId")
     public String getInstanceId() {
         return instanceId;
     }
 
+    /**
+     * instanceId is the instance ID of the machine created in PowerVS instanceId uniquely identifies a Power VS server instance(VM) under a Power VS service. This will help in updating or deleting a VM in Power VS Cloud
+     */
     @JsonProperty("instanceId")
     public void setInstanceId(String instanceId) {
         this.instanceId = instanceId;
     }
 
+    /**
+     * instanceState is the state of the PowerVS instance for this machine Possible instance states are Active, Build, ShutOff, Reboot This is used to display additional information to user regarding instance current state
+     */
     @JsonProperty("instanceState")
     public String getInstanceState() {
         return instanceState;
     }
 
+    /**
+     * instanceState is the state of the PowerVS instance for this machine Possible instance states are Active, Build, ShutOff, Reboot This is used to display additional information to user regarding instance current state
+     */
     @JsonProperty("instanceState")
     public void setInstanceState(String instanceState) {
         this.instanceState = instanceState;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -174,18 +189,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * serviceInstanceID is the reference to the Power VS ServiceInstance on which the machine instance will be created. serviceInstanceID uniquely identifies the Power VS service By setting serviceInstanceID it will become easy and efficient to fetch a server instance(VM) within Power VS Cloud.
+     */
     @JsonProperty("serviceInstanceID")
     public String getServiceInstanceID() {
         return serviceInstanceID;
     }
 
+    /**
+     * serviceInstanceID is the reference to the Power VS ServiceInstance on which the machine instance will be created. serviceInstanceID uniquely identifies the Power VS service By setting serviceInstanceID it will become easy and efficient to fetch a server instance(VM) within Power VS Cloud.
+     */
     @JsonProperty("serviceInstanceID")
     public void setServiceInstanceID(String serviceInstanceID) {
         this.serviceInstanceID = serviceInstanceID;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/PowerVSResource.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/PowerVSResource.java
index 7aaf0122d09..edffce47f90 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/PowerVSResource.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/PowerVSResource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PowerVSResource is a reference to a specific PowerVS resource by ID, Name or RegEx Only one of ID, Name or RegEx may be specified. Specifying more than one will result in a validation error.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public PowerVSResource(String id, String name, String regex, String type) {
         this.type = type;
     }
 
+    /**
+     * ID of resource
+     */
     @JsonProperty("id")
     public String getId() {
         return id;
     }
 
+    /**
+     * ID of resource
+     */
     @JsonProperty("id")
     public void setId(String id) {
         this.id = id;
     }
 
+    /**
+     * Name of resource
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of resource
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Regex to find resource Regex contains the pattern to match to find a resource
+     */
     @JsonProperty("regex")
     public String getRegex() {
         return regex;
     }
 
+    /**
+     * Regex to find resource Regex contains the pattern to match to find a resource
+     */
     @JsonProperty("regex")
     public void setRegex(String regex) {
         this.regex = regex;
     }
 
+    /**
+     * Type identifies the resource type for this entry. Valid values are ID, Name and RegEx
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type identifies the resource type for this entry. Valid values are ID, Name and RegEx
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/PowerVSSecretReference.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/PowerVSSecretReference.java
index ad68143f68a..92c9889a9c1 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/PowerVSSecretReference.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/PowerVSSecretReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PowerVSSecretReference contains enough information to locate the referenced secret inside the same namespace.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public PowerVSSecretReference(String name) {
         this.name = name;
     }
 
+    /**
+     * Name of the secret.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the secret.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/RootVolume.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/RootVolume.java
index 1cb09a15189..4b691c4b1f2 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/RootVolume.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/RootVolume.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RootVolume represents the volume metadata to boot from. The original RootVolume struct is defined in the v1alpha1 but it's not best practice to use it directly here so we define a new one that should stay in sync with the original one.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public RootVolume(String availabilityZone, String volumeType) {
         this.volumeType = volumeType;
     }
 
+    /**
+     * availabilityZone specifies the Cinder availability zone where the root volume will be created. If not specifified, the root volume will be created in the availability zone specified by the volume type in the cinder configuration. If the volume type (configured in the OpenStack cluster) does not specify an availability zone, the root volume will be created in the default availability zone specified in the cinder configuration. See https://docs.openstack.org/cinder/latest/admin/availability-zone-type.html for more details. If the OpenStack cluster is deployed with the cross_az_attach configuration option set to false, the root volume will have to be in the same availability zone as the VM (defined by OpenStackFailureDomain.AvailabilityZone). Availability zone names must NOT contain spaces otherwise it will lead to volume that belongs to this availability zone register failure, see kubernetes/cloud-provider-openstack#1379 for further information. The maximum length of availability zone name is 63 as per labels limits.
+     */
     @JsonProperty("availabilityZone")
     public String getAvailabilityZone() {
         return availabilityZone;
     }
 
+    /**
+     * availabilityZone specifies the Cinder availability zone where the root volume will be created. If not specifified, the root volume will be created in the availability zone specified by the volume type in the cinder configuration. If the volume type (configured in the OpenStack cluster) does not specify an availability zone, the root volume will be created in the default availability zone specified in the cinder configuration. See https://docs.openstack.org/cinder/latest/admin/availability-zone-type.html for more details. If the OpenStack cluster is deployed with the cross_az_attach configuration option set to false, the root volume will have to be in the same availability zone as the VM (defined by OpenStackFailureDomain.AvailabilityZone). Availability zone names must NOT contain spaces otherwise it will lead to volume that belongs to this availability zone register failure, see kubernetes/cloud-provider-openstack#1379 for further information. The maximum length of availability zone name is 63 as per labels limits.
+     */
     @JsonProperty("availabilityZone")
     public void setAvailabilityZone(String availabilityZone) {
         this.availabilityZone = availabilityZone;
     }
 
+    /**
+     * volumeType specifies the type of the root volume that will be provisioned. The maximum length of a volume type name is 255 characters, as per the OpenStack limit.
+     */
     @JsonProperty("volumeType")
     public String getVolumeType() {
         return volumeType;
     }
 
+    /**
+     * volumeType specifies the type of the root volume that will be provisioned. The maximum length of a volume type name is 255 characters, as per the OpenStack limit.
+     */
     @JsonProperty("volumeType")
     public void setVolumeType(String volumeType) {
         this.volumeType = volumeType;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/SystemDiskProperties.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/SystemDiskProperties.java
index aca99b6c808..3c281346270 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/SystemDiskProperties.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/SystemDiskProperties.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SystemDiskProperties contains the information regarding the system disk including performance, size, name, and category
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public SystemDiskProperties(String category, String name, String performanceLeve
         this.size = size;
     }
 
+    /**
+     * Category is the category of the system disk. Valid values: cloud_essd: ESSD. When the parameter is set to this value, you can use the SystemDisk.PerformanceLevel parameter to specify the performance level of the disk. cloud_efficiency: ultra disk. cloud_ssd: standard SSD. cloud: basic disk. Empty value means no opinion and the platform chooses the a default, which is subject to change over time. Currently for non-I/O optimized instances of retired instance types, the default is `cloud`. Currently for other instances, the default is `cloud_efficiency`.
+     */
     @JsonProperty("category")
     public String getCategory() {
         return category;
     }
 
+    /**
+     * Category is the category of the system disk. Valid values: cloud_essd: ESSD. When the parameter is set to this value, you can use the SystemDisk.PerformanceLevel parameter to specify the performance level of the disk. cloud_efficiency: ultra disk. cloud_ssd: standard SSD. cloud: basic disk. Empty value means no opinion and the platform chooses the a default, which is subject to change over time. Currently for non-I/O optimized instances of retired instance types, the default is `cloud`. Currently for other instances, the default is `cloud_efficiency`.
+     */
     @JsonProperty("category")
     public void setCategory(String category) {
         this.category = category;
     }
 
+    /**
+     * Name is the name of the system disk. If the name is specified the name must be 2 to 128 characters in length. It must start with a letter and cannot start with http:// or https://. It can contain letters, digits, colons (:), underscores (_), and hyphens (-). Empty value means the platform chooses a default, which is subject to change over time. Currently the default is `""`.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the system disk. If the name is specified the name must be 2 to 128 characters in length. It must start with a letter and cannot start with http:// or https://. It can contain letters, digits, colons (:), underscores (_), and hyphens (-). Empty value means the platform chooses a default, which is subject to change over time. Currently the default is `""`.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * PerformanceLevel is the performance level of the ESSD used as the system disk. Valid values:<br><p> <br><p> PL0: A single ESSD can deliver up to 10,000 random read/write IOPS. PL1: A single ESSD can deliver up to 50,000 random read/write IOPS. PL2: A single ESSD can deliver up to 100,000 random read/write IOPS. PL3: A single ESSD can deliver up to 1,000,000 random read/write IOPS. Empty value means no opinion and the platform chooses a default, which is subject to change over time. Currently the default is `PL1`. For more information about ESSD performance levels, see ESSDs.
+     */
     @JsonProperty("performanceLevel")
     public String getPerformanceLevel() {
         return performanceLevel;
     }
 
+    /**
+     * PerformanceLevel is the performance level of the ESSD used as the system disk. Valid values:<br><p> <br><p> PL0: A single ESSD can deliver up to 10,000 random read/write IOPS. PL1: A single ESSD can deliver up to 50,000 random read/write IOPS. PL2: A single ESSD can deliver up to 100,000 random read/write IOPS. PL3: A single ESSD can deliver up to 1,000,000 random read/write IOPS. Empty value means no opinion and the platform chooses a default, which is subject to change over time. Currently the default is `PL1`. For more information about ESSD performance levels, see ESSDs.
+     */
     @JsonProperty("performanceLevel")
     public void setPerformanceLevel(String performanceLevel) {
         this.performanceLevel = performanceLevel;
     }
 
+    /**
+     * Size is the size of the system disk. Unit: GiB. Valid values: 20 to 500. The value must be at least 20 and greater than or equal to the size of the image. Empty value means the platform chooses a default, which is subject to change over time. Currently the default is `40` or the size of the image depending on whichever is greater.
+     */
     @JsonProperty("size")
     public Long getSize() {
         return size;
     }
 
+    /**
+     * Size is the size of the system disk. Unit: GiB. Valid values: 20 to 500. The value must be at least 20 and greater than or equal to the size of the image. Empty value means the platform chooses a default, which is subject to change over time. Currently the default is `40` or the size of the image depending on whichever is greater.
+     */
     @JsonProperty("size")
     public void setSize(Long size) {
         this.size = size;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/Tag.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/Tag.java
index 5839f92fe6e..3565c8209e5 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/Tag.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/Tag.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Tag  The tags of ECS Instance
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Tag(String key, String value) {
         this.value = value;
     }
 
+    /**
+     * Key is the name of the key pair
+     */
     @JsonProperty("Key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * Key is the name of the key pair
+     */
     @JsonProperty("Key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * Value is the value or data of the key pair
+     */
     @JsonProperty("Value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is the value or data of the key pair
+     */
     @JsonProperty("Value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/VSphereFailureDomain.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/VSphereFailureDomain.java
index 7d79364bd0b..7419d96a149 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/VSphereFailureDomain.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1/VSphereFailureDomain.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VSphereFailureDomain configures failure domain information for the vSphere platform
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public VSphereFailureDomain(String name) {
         this.name = name;
     }
 
+    /**
+     * name of the failure domain in which the vSphere machine provider will create the VM. Failure domains are defined in a cluster's config.openshift.io/Infrastructure resource. When balancing machines across failure domains, the control plane machine set will inject configuration from the Infrastructure resource into the machine providerSpec to allocate the machine to a failure domain.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name of the failure domain in which the vSphere machine provider will create the VM. Failure domains are defined in a cluster's config.openshift.io/Infrastructure resource. When balancing machines across failure domains, the control plane machine set will inject configuration from the Infrastructure resource into the machine providerSpec to allocate the machine to a failure domain.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/AdditionalBlockDevice.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/AdditionalBlockDevice.java
index b4c98d13405..783ac2c9b88 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/AdditionalBlockDevice.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/AdditionalBlockDevice.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * additionalBlockDevice is a block device to attach to the server.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public AdditionalBlockDevice(String name, Integer sizeGiB, BlockDeviceStorage st
         this.storage = storage;
     }
 
+    /**
+     * name of the block device in the context of a machine. If the block device is a volume, the Cinder volume will be named as a combination of the machine name and this name. Also, this name will be used for tagging the block device. Information about the block device tag can be obtained from the OpenStack metadata API or the config drive.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name of the block device in the context of a machine. If the block device is a volume, the Cinder volume will be named as a combination of the machine name and this name. Also, this name will be used for tagging the block device. Information about the block device tag can be obtained from the OpenStack metadata API or the config drive.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * sizeGiB is the size of the block device in gibibytes (GiB).
+     */
     @JsonProperty("sizeGiB")
     public Integer getSizeGiB() {
         return sizeGiB;
     }
 
+    /**
+     * sizeGiB is the size of the block device in gibibytes (GiB).
+     */
     @JsonProperty("sizeGiB")
     public void setSizeGiB(Integer sizeGiB) {
         this.sizeGiB = sizeGiB;
     }
 
+    /**
+     * additionalBlockDevice is a block device to attach to the server.
+     */
     @JsonProperty("storage")
     public BlockDeviceStorage getStorage() {
         return storage;
     }
 
+    /**
+     * additionalBlockDevice is a block device to attach to the server.
+     */
     @JsonProperty("storage")
     public void setStorage(BlockDeviceStorage storage) {
         this.storage = storage;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/BlockDeviceStorage.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/BlockDeviceStorage.java
index 24048ab80e2..64ba6dc9da9 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/BlockDeviceStorage.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/BlockDeviceStorage.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * blockDeviceStorage is the storage type of a block device to create and contains additional storage options.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public BlockDeviceStorage(String type, BlockDeviceVolume volume) {
         this.volume = volume;
     }
 
+    /**
+     * type is the type of block device to create. This can be either "Volume" or "Local".
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the type of block device to create. This can be either "Volume" or "Local".
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * blockDeviceStorage is the storage type of a block device to create and contains additional storage options.
+     */
     @JsonProperty("volume")
     public BlockDeviceVolume getVolume() {
         return volume;
     }
 
+    /**
+     * blockDeviceStorage is the storage type of a block device to create and contains additional storage options.
+     */
     @JsonProperty("volume")
     public void setVolume(BlockDeviceVolume volume) {
         this.volume = volume;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/BlockDeviceVolume.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/BlockDeviceVolume.java
index 7fffce13061..27f464b2cbc 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/BlockDeviceVolume.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/BlockDeviceVolume.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * blockDeviceVolume contains additional storage options for a volume block device.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public BlockDeviceVolume(String availabilityZone, String type) {
         this.type = type;
     }
 
+    /**
+     * availabilityZone is the volume availability zone to create the volume in. If omitted, the availability zone of the server will be used. The availability zone must NOT contain spaces otherwise it will lead to volume that belongs to this availability zone register failure, see kubernetes/cloud-provider-openstack#1379 for further information.
+     */
     @JsonProperty("availabilityZone")
     public String getAvailabilityZone() {
         return availabilityZone;
     }
 
+    /**
+     * availabilityZone is the volume availability zone to create the volume in. If omitted, the availability zone of the server will be used. The availability zone must NOT contain spaces otherwise it will lead to volume that belongs to this availability zone register failure, see kubernetes/cloud-provider-openstack#1379 for further information.
+     */
     @JsonProperty("availabilityZone")
     public void setAvailabilityZone(String availabilityZone) {
         this.availabilityZone = availabilityZone;
     }
 
+    /**
+     * type is the Cinder volume type of the volume. If omitted, the default Cinder volume type that is configured in the OpenStack cloud will be used.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the Cinder volume type of the volume. If omitted, the default Cinder volume type that is configured in the OpenStack cloud will be used.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/Filter.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/Filter.java
index a2e9aaa6f55..9dd0cf410fd 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/Filter.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/Filter.java
@@ -138,161 +138,257 @@ public Filter(Boolean adminStateUp, String description, String id, Integer limit
         this.tenantId = tenantId;
     }
 
+    /**
+     * Deprecated: adminStateUp is silently ignored. It has no replacement.
+     */
     @JsonProperty("adminStateUp")
     public Boolean getAdminStateUp() {
         return adminStateUp;
     }
 
+    /**
+     * Deprecated: adminStateUp is silently ignored. It has no replacement.
+     */
     @JsonProperty("adminStateUp")
     public void setAdminStateUp(Boolean adminStateUp) {
         this.adminStateUp = adminStateUp;
     }
 
+    /**
+     * description filters networks by description.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * description filters networks by description.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * Deprecated: use NetworkParam.uuid instead. Ignored if NetworkParam.uuid is set.
+     */
     @JsonProperty("id")
     public String getId() {
         return id;
     }
 
+    /**
+     * Deprecated: use NetworkParam.uuid instead. Ignored if NetworkParam.uuid is set.
+     */
     @JsonProperty("id")
     public void setId(String id) {
         this.id = id;
     }
 
+    /**
+     * Deprecated: limit is silently ignored. It has no replacement.
+     */
     @JsonProperty("limit")
     public Integer getLimit() {
         return limit;
     }
 
+    /**
+     * Deprecated: limit is silently ignored. It has no replacement.
+     */
     @JsonProperty("limit")
     public void setLimit(Integer limit) {
         this.limit = limit;
     }
 
+    /**
+     * Deprecated: marker is silently ignored. It has no replacement.
+     */
     @JsonProperty("marker")
     public String getMarker() {
         return marker;
     }
 
+    /**
+     * Deprecated: marker is silently ignored. It has no replacement.
+     */
     @JsonProperty("marker")
     public void setMarker(String marker) {
         this.marker = marker;
     }
 
+    /**
+     * name filters networks by name.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name filters networks by name.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * notTags filters by networks which don't match all specified tags. NOT (t1 AND t2...) Multiple tags are comma separated.
+     */
     @JsonProperty("notTags")
     public String getNotTags() {
         return notTags;
     }
 
+    /**
+     * notTags filters by networks which don't match all specified tags. NOT (t1 AND t2...) Multiple tags are comma separated.
+     */
     @JsonProperty("notTags")
     public void setNotTags(String notTags) {
         this.notTags = notTags;
     }
 
+    /**
+     * notTagsAny filters by networks which don't match any specified tags. NOT (t1 OR t2...) Multiple tags are comma separated.
+     */
     @JsonProperty("notTagsAny")
     public String getNotTagsAny() {
         return notTagsAny;
     }
 
+    /**
+     * notTagsAny filters by networks which don't match any specified tags. NOT (t1 OR t2...) Multiple tags are comma separated.
+     */
     @JsonProperty("notTagsAny")
     public void setNotTagsAny(String notTagsAny) {
         this.notTagsAny = notTagsAny;
     }
 
+    /**
+     * projectId filters networks by project ID.
+     */
     @JsonProperty("projectId")
     public String getProjectId() {
         return projectId;
     }
 
+    /**
+     * projectId filters networks by project ID.
+     */
     @JsonProperty("projectId")
     public void setProjectId(String projectId) {
         this.projectId = projectId;
     }
 
+    /**
+     * Deprecated: shared is silently ignored. It has no replacement.
+     */
     @JsonProperty("shared")
     public Boolean getShared() {
         return shared;
     }
 
+    /**
+     * Deprecated: shared is silently ignored. It has no replacement.
+     */
     @JsonProperty("shared")
     public void setShared(Boolean shared) {
         this.shared = shared;
     }
 
+    /**
+     * Deprecated: sortDir is silently ignored. It has no replacement.
+     */
     @JsonProperty("sortDir")
     public String getSortDir() {
         return sortDir;
     }
 
+    /**
+     * Deprecated: sortDir is silently ignored. It has no replacement.
+     */
     @JsonProperty("sortDir")
     public void setSortDir(String sortDir) {
         this.sortDir = sortDir;
     }
 
+    /**
+     * Deprecated: sortKey is silently ignored. It has no replacement.
+     */
     @JsonProperty("sortKey")
     public String getSortKey() {
         return sortKey;
     }
 
+    /**
+     * Deprecated: sortKey is silently ignored. It has no replacement.
+     */
     @JsonProperty("sortKey")
     public void setSortKey(String sortKey) {
         this.sortKey = sortKey;
     }
 
+    /**
+     * Deprecated: status is silently ignored. It has no replacement.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Deprecated: status is silently ignored. It has no replacement.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * tags filters by networks containing all specified tags. Multiple tags are comma separated.
+     */
     @JsonProperty("tags")
     public String getTags() {
         return tags;
     }
 
+    /**
+     * tags filters by networks containing all specified tags. Multiple tags are comma separated.
+     */
     @JsonProperty("tags")
     public void setTags(String tags) {
         this.tags = tags;
     }
 
+    /**
+     * tagsAny filters by networks containing any specified tags. Multiple tags are comma separated.
+     */
     @JsonProperty("tagsAny")
     public String getTagsAny() {
         return tagsAny;
     }
 
+    /**
+     * tagsAny filters by networks containing any specified tags. Multiple tags are comma separated.
+     */
     @JsonProperty("tagsAny")
     public void setTagsAny(String tagsAny) {
         this.tagsAny = tagsAny;
     }
 
+    /**
+     * tenantId filters networks by tenant ID. Deprecated: use projectId instead. tenantId will be ignored if projectId is set.
+     */
     @JsonProperty("tenantId")
     public String getTenantId() {
         return tenantId;
     }
 
+    /**
+     * tenantId filters networks by tenant ID. Deprecated: use projectId instead. tenantId will be ignored if projectId is set.
+     */
     @JsonProperty("tenantId")
     public void setTenantId(String tenantId) {
         this.tenantId = tenantId;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/FixedIPs.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/FixedIPs.java
index 7d194a72c3b..fec1e584b0d 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/FixedIPs.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/FixedIPs.java
@@ -82,21 +82,33 @@ public FixedIPs(String ipAddress, String subnetID) {
         this.subnetID = subnetID;
     }
 
+    /**
+     * ipAddress is a specific IP address to use in the given subnet. Port creation will fail if the address is not available. If not specified, an available IP from the given subnet will be selected automatically.
+     */
     @JsonProperty("ipAddress")
     public String getIpAddress() {
         return ipAddress;
     }
 
+    /**
+     * ipAddress is a specific IP address to use in the given subnet. Port creation will fail if the address is not available. If not specified, an available IP from the given subnet will be selected automatically.
+     */
     @JsonProperty("ipAddress")
     public void setIpAddress(String ipAddress) {
         this.ipAddress = ipAddress;
     }
 
+    /**
+     * subnetID specifies the ID of the subnet where the fixed IP will be allocated.
+     */
     @JsonProperty("subnetID")
     public String getSubnetID() {
         return subnetID;
     }
 
+    /**
+     * subnetID specifies the ID of the subnet where the fixed IP will be allocated.
+     */
     @JsonProperty("subnetID")
     public void setSubnetID(String subnetID) {
         this.subnetID = subnetID;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/NetworkParam.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/NetworkParam.java
index 9c711cff455..3b3eb65c513 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/NetworkParam.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/NetworkParam.java
@@ -125,84 +125,132 @@ public void setFilter(Filter filter) {
         this.filter = filter;
     }
 
+    /**
+     * A fixed IPv4 address for the NIC.
+     */
     @JsonProperty("fixedIp")
     public String getFixedIp() {
         return fixedIp;
     }
 
+    /**
+     * A fixed IPv4 address for the NIC.
+     */
     @JsonProperty("fixedIp")
     public void setFixedIp(String fixedIp) {
         this.fixedIp = fixedIp;
     }
 
+    /**
+     * NoAllowedAddressPairs disables creation of allowed address pairs for the network ports
+     */
     @JsonProperty("noAllowedAddressPairs")
     public Boolean getNoAllowedAddressPairs() {
         return noAllowedAddressPairs;
     }
 
+    /**
+     * NoAllowedAddressPairs disables creation of allowed address pairs for the network ports
+     */
     @JsonProperty("noAllowedAddressPairs")
     public void setNoAllowedAddressPairs(Boolean noAllowedAddressPairs) {
         this.noAllowedAddressPairs = noAllowedAddressPairs;
     }
 
+    /**
+     * PortSecurity optionally enables or disables security on ports managed by OpenStack
+     */
     @JsonProperty("portSecurity")
     public Boolean getPortSecurity() {
         return portSecurity;
     }
 
+    /**
+     * PortSecurity optionally enables or disables security on ports managed by OpenStack
+     */
     @JsonProperty("portSecurity")
     public void setPortSecurity(Boolean portSecurity) {
         this.portSecurity = portSecurity;
     }
 
+    /**
+     * PortTags allows users to specify a list of tags to add to ports created in a given network
+     */
     @JsonProperty("portTags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPortTags() {
         return portTags;
     }
 
+    /**
+     * PortTags allows users to specify a list of tags to add to ports created in a given network
+     */
     @JsonProperty("portTags")
     public void setPortTags(List<String> portTags) {
         this.portTags = portTags;
     }
 
+    /**
+     * A dictionary that enables the application running on the specified host to pass and receive virtual network interface (VIF) port-specific information to the plug-in.
+     */
     @JsonProperty("profile")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getProfile() {
         return profile;
     }
 
+    /**
+     * A dictionary that enables the application running on the specified host to pass and receive virtual network interface (VIF) port-specific information to the plug-in.
+     */
     @JsonProperty("profile")
     public void setProfile(Map<String, String> profile) {
         this.profile = profile;
     }
 
+    /**
+     * Subnet within a network to use
+     */
     @JsonProperty("subnets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SubnetParam> getSubnets() {
         return subnets;
     }
 
+    /**
+     * Subnet within a network to use
+     */
     @JsonProperty("subnets")
     public void setSubnets(List<SubnetParam> subnets) {
         this.subnets = subnets;
     }
 
+    /**
+     * The UUID of the network. Required if you omit the port attribute.
+     */
     @JsonProperty("uuid")
     public String getUuid() {
         return uuid;
     }
 
+    /**
+     * The UUID of the network. Required if you omit the port attribute.
+     */
     @JsonProperty("uuid")
     public void setUuid(String uuid) {
         this.uuid = uuid;
     }
 
+    /**
+     * The virtual network interface card (vNIC) type that is bound to the neutron port.
+     */
     @JsonProperty("vnicType")
     public String getVnicType() {
         return vnicType;
     }
 
+    /**
+     * The virtual network interface card (vNIC) type that is bound to the neutron port.
+     */
     @JsonProperty("vnicType")
     public void setVnicType(String vnicType) {
         this.vnicType = vnicType;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/OpenstackProviderSpec.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/OpenstackProviderSpec.java
index b9c7221582c..69f4ae6d577 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/OpenstackProviderSpec.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/OpenstackProviderSpec.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OpenstackProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an OpenStack Instance. It is used by the Openstack machine actuator to create a single machine instance. Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,9 +104,6 @@ public class OpenstackProviderSpec implements Editable<OpenstackProviderSpecBuil
     @JsonProperty("additionalBlockDevices")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<AdditionalBlockDevice> additionalBlockDevices = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machine.openshift.io/v1alpha1";
     @JsonProperty("availabilityZone")
@@ -122,9 +122,6 @@ public class OpenstackProviderSpec implements Editable<OpenstackProviderSpecBuil
     private String image;
     @JsonProperty("keyName")
     private String keyName;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OpenstackProviderSpec";
     @JsonProperty("metadata")
@@ -195,19 +192,25 @@ public OpenstackProviderSpec(List<AdditionalBlockDevice> additionalBlockDevices,
         this.userDataSecret = userDataSecret;
     }
 
+    /**
+     * additionalBlockDevices is a list of specifications for additional block devices to attach to the server instance
+     */
     @JsonProperty("additionalBlockDevices")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AdditionalBlockDevice> getAdditionalBlockDevices() {
         return additionalBlockDevices;
     }
 
+    /**
+     * additionalBlockDevices is a list of specifications for additional block devices to attach to the server instance
+     */
     @JsonProperty("additionalBlockDevices")
     public void setAdditionalBlockDevices(List<AdditionalBlockDevice> additionalBlockDevices) {
         this.additionalBlockDevices = additionalBlockDevices;
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -215,95 +218,143 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * The availability zone from which to launch the server.
+     */
     @JsonProperty("availabilityZone")
     public String getAvailabilityZone() {
         return availabilityZone;
     }
 
+    /**
+     * The availability zone from which to launch the server.
+     */
     @JsonProperty("availabilityZone")
     public void setAvailabilityZone(String availabilityZone) {
         this.availabilityZone = availabilityZone;
     }
 
+    /**
+     * The name of the cloud to use from the clouds secret
+     */
     @JsonProperty("cloudName")
     public String getCloudName() {
         return cloudName;
     }
 
+    /**
+     * The name of the cloud to use from the clouds secret
+     */
     @JsonProperty("cloudName")
     public void setCloudName(String cloudName) {
         this.cloudName = cloudName;
     }
 
+    /**
+     * OpenstackProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an OpenStack Instance. It is used by the Openstack machine actuator to create a single machine instance. Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("cloudsSecret")
     public SecretReference getCloudsSecret() {
         return cloudsSecret;
     }
 
+    /**
+     * OpenstackProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an OpenStack Instance. It is used by the Openstack machine actuator to create a single machine instance. Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("cloudsSecret")
     public void setCloudsSecret(SecretReference cloudsSecret) {
         this.cloudsSecret = cloudsSecret;
     }
 
+    /**
+     * Config Drive support
+     */
     @JsonProperty("configDrive")
     public Boolean getConfigDrive() {
         return configDrive;
     }
 
+    /**
+     * Config Drive support
+     */
     @JsonProperty("configDrive")
     public void setConfigDrive(Boolean configDrive) {
         this.configDrive = configDrive;
     }
 
+    /**
+     * The flavor reference for the flavor for your server instance.
+     */
     @JsonProperty("flavor")
     public String getFlavor() {
         return flavor;
     }
 
+    /**
+     * The flavor reference for the flavor for your server instance.
+     */
     @JsonProperty("flavor")
     public void setFlavor(String flavor) {
         this.flavor = flavor;
     }
 
+    /**
+     * floatingIP specifies a floating IP to be associated with the machine. Note that it is not safe to use this parameter in a MachineSet, as only one Machine may be assigned the same floating IP.<br><p> <br><p> Deprecated: floatingIP will be removed in a future release as it cannot be implemented correctly.
+     */
     @JsonProperty("floatingIP")
     public String getFloatingIP() {
         return floatingIP;
     }
 
+    /**
+     * floatingIP specifies a floating IP to be associated with the machine. Note that it is not safe to use this parameter in a MachineSet, as only one Machine may be assigned the same floating IP.<br><p> <br><p> Deprecated: floatingIP will be removed in a future release as it cannot be implemented correctly.
+     */
     @JsonProperty("floatingIP")
     public void setFloatingIP(String floatingIP) {
         this.floatingIP = floatingIP;
     }
 
+    /**
+     * The name of the image to use for your server instance. If the RootVolume is specified, this will be ignored and use rootVolume directly.
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * The name of the image to use for your server instance. If the RootVolume is specified, this will be ignored and use rootVolume directly.
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
     }
 
+    /**
+     * The ssh key to inject in the instance
+     */
     @JsonProperty("keyName")
     public String getKeyName() {
         return keyName;
     }
 
+    /**
+     * The ssh key to inject in the instance
+     */
     @JsonProperty("keyName")
     public void setKeyName(String keyName) {
         this.keyName = keyName;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -311,143 +362,221 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OpenstackProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an OpenStack Instance. It is used by the Openstack machine actuator to create a single machine instance. Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OpenstackProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an OpenStack Instance. It is used by the Openstack machine actuator to create a single machine instance. Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * A networks object. Required parameter when there are multiple networks defined for the tenant. When you do not specify the networks parameter, the server attaches to the only network created for the current tenant.
+     */
     @JsonProperty("networks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NetworkParam> getNetworks() {
         return networks;
     }
 
+    /**
+     * A networks object. Required parameter when there are multiple networks defined for the tenant. When you do not specify the networks parameter, the server attaches to the only network created for the current tenant.
+     */
     @JsonProperty("networks")
     public void setNetworks(List<NetworkParam> networks) {
         this.networks = networks;
     }
 
+    /**
+     * Create and assign additional ports to instances
+     */
     @JsonProperty("ports")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PortOpts> getPorts() {
         return ports;
     }
 
+    /**
+     * Create and assign additional ports to instances
+     */
     @JsonProperty("ports")
     public void setPorts(List<PortOpts> ports) {
         this.ports = ports;
     }
 
+    /**
+     * The subnet that a set of machines will get ingress/egress traffic from
+     */
     @JsonProperty("primarySubnet")
     public String getPrimarySubnet() {
         return primarySubnet;
     }
 
+    /**
+     * The subnet that a set of machines will get ingress/egress traffic from
+     */
     @JsonProperty("primarySubnet")
     public void setPrimarySubnet(String primarySubnet) {
         this.primarySubnet = primarySubnet;
     }
 
+    /**
+     * OpenstackProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an OpenStack Instance. It is used by the Openstack machine actuator to create a single machine instance. Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("rootVolume")
     public RootVolume getRootVolume() {
         return rootVolume;
     }
 
+    /**
+     * OpenstackProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an OpenStack Instance. It is used by the Openstack machine actuator to create a single machine instance. Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("rootVolume")
     public void setRootVolume(RootVolume rootVolume) {
         this.rootVolume = rootVolume;
     }
 
+    /**
+     * The names of the security groups to assign to the instance
+     */
     @JsonProperty("securityGroups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SecurityGroupParam> getSecurityGroups() {
         return securityGroups;
     }
 
+    /**
+     * The names of the security groups to assign to the instance
+     */
     @JsonProperty("securityGroups")
     public void setSecurityGroups(List<SecurityGroupParam> securityGroups) {
         this.securityGroups = securityGroups;
     }
 
+    /**
+     * The server group to assign the machine to.
+     */
     @JsonProperty("serverGroupID")
     public String getServerGroupID() {
         return serverGroupID;
     }
 
+    /**
+     * The server group to assign the machine to.
+     */
     @JsonProperty("serverGroupID")
     public void setServerGroupID(String serverGroupID) {
         this.serverGroupID = serverGroupID;
     }
 
+    /**
+     * The server group to assign the machine to. A server group with that name will be created if it does not exist. If both ServerGroupID and ServerGroupName are non-empty, they must refer to the same OpenStack resource.
+     */
     @JsonProperty("serverGroupName")
     public String getServerGroupName() {
         return serverGroupName;
     }
 
+    /**
+     * The server group to assign the machine to. A server group with that name will be created if it does not exist. If both ServerGroupID and ServerGroupName are non-empty, they must refer to the same OpenStack resource.
+     */
     @JsonProperty("serverGroupName")
     public void setServerGroupName(String serverGroupName) {
         this.serverGroupName = serverGroupName;
     }
 
+    /**
+     * Metadata mapping. Allows you to create a map of key value pairs to add to the server instance.
+     */
     @JsonProperty("serverMetadata")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getServerMetadata() {
         return serverMetadata;
     }
 
+    /**
+     * Metadata mapping. Allows you to create a map of key value pairs to add to the server instance.
+     */
     @JsonProperty("serverMetadata")
     public void setServerMetadata(Map<String, String> serverMetadata) {
         this.serverMetadata = serverMetadata;
     }
 
+    /**
+     * The machine ssh username
+     */
     @JsonProperty("sshUserName")
     public String getSshUserName() {
         return sshUserName;
     }
 
+    /**
+     * The machine ssh username
+     */
     @JsonProperty("sshUserName")
     public void setSshUserName(String sshUserName) {
         this.sshUserName = sshUserName;
     }
 
+    /**
+     * Machine tags Requires Nova api 2.52 minimum!
+     */
     @JsonProperty("tags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getTags() {
         return tags;
     }
 
+    /**
+     * Machine tags Requires Nova api 2.52 minimum!
+     */
     @JsonProperty("tags")
     public void setTags(List<String> tags) {
         this.tags = tags;
     }
 
+    /**
+     * Whether the server instance is created on a trunk port or not.
+     */
     @JsonProperty("trunk")
     public Boolean getTrunk() {
         return trunk;
     }
 
+    /**
+     * Whether the server instance is created on a trunk port or not.
+     */
     @JsonProperty("trunk")
     public void setTrunk(Boolean trunk) {
         this.trunk = trunk;
     }
 
+    /**
+     * OpenstackProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an OpenStack Instance. It is used by the Openstack machine actuator to create a single machine instance. Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("userDataSecret")
     public SecretReference getUserDataSecret() {
         return userDataSecret;
     }
 
+    /**
+     * OpenstackProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an OpenStack Instance. It is used by the Openstack machine actuator to create a single machine instance. Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("userDataSecret")
     public void setUserDataSecret(SecretReference userDataSecret) {
         this.userDataSecret = userDataSecret;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/PortOpts.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/PortOpts.java
index 94ea463de62..65a43801fd4 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/PortOpts.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/PortOpts.java
@@ -145,166 +145,262 @@ public PortOpts(Boolean adminStateUp, List<AddressPair> allowedAddressPairs, Str
         this.vnicType = vnicType;
     }
 
+    /**
+     * adminStateUp sets the administrative state of the created port to up (true), or down (false).
+     */
     @JsonProperty("adminStateUp")
     public Boolean getAdminStateUp() {
         return adminStateUp;
     }
 
+    /**
+     * adminStateUp sets the administrative state of the created port to up (true), or down (false).
+     */
     @JsonProperty("adminStateUp")
     public void setAdminStateUp(Boolean adminStateUp) {
         this.adminStateUp = adminStateUp;
     }
 
+    /**
+     * allowedAddressPairs specifies a set of allowed address pairs to add to the port.
+     */
     @JsonProperty("allowedAddressPairs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AddressPair> getAllowedAddressPairs() {
         return allowedAddressPairs;
     }
 
+    /**
+     * allowedAddressPairs specifies a set of allowed address pairs to add to the port.
+     */
     @JsonProperty("allowedAddressPairs")
     public void setAllowedAddressPairs(List<AddressPair> allowedAddressPairs) {
         this.allowedAddressPairs = allowedAddressPairs;
     }
 
+    /**
+     * description specifies the description of the created port.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * description specifies the description of the created port.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * fixedIPs specifies a set of fixed IPs to assign to the port. They must all be valid for the port's network.
+     */
     @JsonProperty("fixedIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<FixedIPs> getFixedIPs() {
         return fixedIPs;
     }
 
+    /**
+     * fixedIPs specifies a set of fixed IPs to assign to the port. They must all be valid for the port's network.
+     */
     @JsonProperty("fixedIPs")
     public void setFixedIPs(List<FixedIPs> fixedIPs) {
         this.fixedIPs = fixedIPs;
     }
 
+    /**
+     * The ID of the host where the port is allocated. Do not use this field: it cannot be used correctly. Deprecated: hostID is silently ignored. It will be removed with no replacement.
+     */
     @JsonProperty("hostID")
     public String getHostID() {
         return hostID;
     }
 
+    /**
+     * The ID of the host where the port is allocated. Do not use this field: it cannot be used correctly. Deprecated: hostID is silently ignored. It will be removed with no replacement.
+     */
     @JsonProperty("hostID")
     public void setHostID(String hostID) {
         this.hostID = hostID;
     }
 
+    /**
+     * macAddress specifies the MAC address of the created port.
+     */
     @JsonProperty("macAddress")
     public String getMacAddress() {
         return macAddress;
     }
 
+    /**
+     * macAddress specifies the MAC address of the created port.
+     */
     @JsonProperty("macAddress")
     public void setMacAddress(String macAddress) {
         this.macAddress = macAddress;
     }
 
+    /**
+     * If nameSuffix is specified the created port will be named &lt;machine name&gt;-&lt;nameSuffix&gt;. If not specified the port will be named &lt;machine-name&gt;-&lt;index of this port&gt;.
+     */
     @JsonProperty("nameSuffix")
     public String getNameSuffix() {
         return nameSuffix;
     }
 
+    /**
+     * If nameSuffix is specified the created port will be named &lt;machine name&gt;-&lt;nameSuffix&gt;. If not specified the port will be named &lt;machine-name&gt;-&lt;index of this port&gt;.
+     */
     @JsonProperty("nameSuffix")
     public void setNameSuffix(String nameSuffix) {
         this.nameSuffix = nameSuffix;
     }
 
+    /**
+     * networkID is the ID of the network the port will be created in. It is required.
+     */
     @JsonProperty("networkID")
     public String getNetworkID() {
         return networkID;
     }
 
+    /**
+     * networkID is the ID of the network the port will be created in. It is required.
+     */
     @JsonProperty("networkID")
     public void setNetworkID(String networkID) {
         this.networkID = networkID;
     }
 
+    /**
+     * enable or disable security on a given port incompatible with securityGroups and allowedAddressPairs
+     */
     @JsonProperty("portSecurity")
     public Boolean getPortSecurity() {
         return portSecurity;
     }
 
+    /**
+     * enable or disable security on a given port incompatible with securityGroups and allowedAddressPairs
+     */
     @JsonProperty("portSecurity")
     public void setPortSecurity(Boolean portSecurity) {
         this.portSecurity = portSecurity;
     }
 
+    /**
+     * A dictionary that enables the application running on the specified host to pass and receive virtual network interface (VIF) port-specific information to the plug-in.
+     */
     @JsonProperty("profile")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getProfile() {
         return profile;
     }
 
+    /**
+     * A dictionary that enables the application running on the specified host to pass and receive virtual network interface (VIF) port-specific information to the plug-in.
+     */
     @JsonProperty("profile")
     public void setProfile(Map<String, String> profile) {
         this.profile = profile;
     }
 
+    /**
+     * projectID specifies the project ID of the created port. Note that this requires OpenShift to have administrative permissions, which is typically not the case. Use of this field is not recommended.
+     */
     @JsonProperty("projectID")
     public String getProjectID() {
         return projectID;
     }
 
+    /**
+     * projectID specifies the project ID of the created port. Note that this requires OpenShift to have administrative permissions, which is typically not the case. Use of this field is not recommended.
+     */
     @JsonProperty("projectID")
     public void setProjectID(String projectID) {
         this.projectID = projectID;
     }
 
+    /**
+     * securityGroups specifies a set of security group UUIDs to use instead of the machine's default security groups. The default security groups will be used if this is left empty or not specified.
+     */
     @JsonProperty("securityGroups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSecurityGroups() {
         return securityGroups;
     }
 
+    /**
+     * securityGroups specifies a set of security group UUIDs to use instead of the machine's default security groups. The default security groups will be used if this is left empty or not specified.
+     */
     @JsonProperty("securityGroups")
     public void setSecurityGroups(List<String> securityGroups) {
         this.securityGroups = securityGroups;
     }
 
+    /**
+     * tags species a set of tags to add to the port.
+     */
     @JsonProperty("tags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getTags() {
         return tags;
     }
 
+    /**
+     * tags species a set of tags to add to the port.
+     */
     @JsonProperty("tags")
     public void setTags(List<String> tags) {
         this.tags = tags;
     }
 
+    /**
+     * tenantID specifies the tenant ID of the created port. Note that this requires OpenShift to have administrative permissions, which is typically not the case. Use of this field is not recommended. Deprecated: use projectID instead. It will be ignored if projectID is set.
+     */
     @JsonProperty("tenantID")
     public String getTenantID() {
         return tenantID;
     }
 
+    /**
+     * tenantID specifies the tenant ID of the created port. Note that this requires OpenShift to have administrative permissions, which is typically not the case. Use of this field is not recommended. Deprecated: use projectID instead. It will be ignored if projectID is set.
+     */
     @JsonProperty("tenantID")
     public void setTenantID(String tenantID) {
         this.tenantID = tenantID;
     }
 
+    /**
+     * Enables and disables trunk at port level. If not provided, openStackMachine.Spec.Trunk is inherited.
+     */
     @JsonProperty("trunk")
     public Boolean getTrunk() {
         return trunk;
     }
 
+    /**
+     * Enables and disables trunk at port level. If not provided, openStackMachine.Spec.Trunk is inherited.
+     */
     @JsonProperty("trunk")
     public void setTrunk(Boolean trunk) {
         this.trunk = trunk;
     }
 
+    /**
+     * The virtual network interface card (vNIC) type that is bound to the neutron port.
+     */
     @JsonProperty("vnicType")
     public String getVnicType() {
         return vnicType;
     }
 
+    /**
+     * The virtual network interface card (vNIC) type that is bound to the neutron port.
+     */
     @JsonProperty("vnicType")
     public void setVnicType(String vnicType) {
         this.vnicType = vnicType;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/RootVolume.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/RootVolume.java
index 7812f852d48..ee218d571ab 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/RootVolume.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/RootVolume.java
@@ -98,61 +98,97 @@ public RootVolume(String availabilityZone, String deviceType, Integer diskSize,
         this.volumeType = volumeType;
     }
 
+    /**
+     * availabilityZone specifies the Cinder availability where the root volume will be created.
+     */
     @JsonProperty("availabilityZone")
     public String getAvailabilityZone() {
         return availabilityZone;
     }
 
+    /**
+     * availabilityZone specifies the Cinder availability where the root volume will be created.
+     */
     @JsonProperty("availabilityZone")
     public void setAvailabilityZone(String availabilityZone) {
         this.availabilityZone = availabilityZone;
     }
 
+    /**
+     * Deprecated: deviceType will be silently ignored. There is no replacement.
+     */
     @JsonProperty("deviceType")
     public String getDeviceType() {
         return deviceType;
     }
 
+    /**
+     * Deprecated: deviceType will be silently ignored. There is no replacement.
+     */
     @JsonProperty("deviceType")
     public void setDeviceType(String deviceType) {
         this.deviceType = deviceType;
     }
 
+    /**
+     * diskSize specifies the size, in GB, of the created root volume.
+     */
     @JsonProperty("diskSize")
     public Integer getDiskSize() {
         return diskSize;
     }
 
+    /**
+     * diskSize specifies the size, in GB, of the created root volume.
+     */
     @JsonProperty("diskSize")
     public void setDiskSize(Integer diskSize) {
         this.diskSize = diskSize;
     }
 
+    /**
+     * Deprecated: sourceType will be silently ignored. There is no replacement.
+     */
     @JsonProperty("sourceType")
     public String getSourceType() {
         return sourceType;
     }
 
+    /**
+     * Deprecated: sourceType will be silently ignored. There is no replacement.
+     */
     @JsonProperty("sourceType")
     public void setSourceType(String sourceType) {
         this.sourceType = sourceType;
     }
 
+    /**
+     * sourceUUID specifies the UUID of a glance image used to populate the root volume. Deprecated: set image in the platform spec instead. This will be ignored if image is set in the platform spec.
+     */
     @JsonProperty("sourceUUID")
     public String getSourceUUID() {
         return sourceUUID;
     }
 
+    /**
+     * sourceUUID specifies the UUID of a glance image used to populate the root volume. Deprecated: set image in the platform spec instead. This will be ignored if image is set in the platform spec.
+     */
     @JsonProperty("sourceUUID")
     public void setSourceUUID(String sourceUUID) {
         this.sourceUUID = sourceUUID;
     }
 
+    /**
+     * volumeType specifies a volume type to use when creating the root volume. If not specified the default volume type will be used.
+     */
     @JsonProperty("volumeType")
     public String getVolumeType() {
         return volumeType;
     }
 
+    /**
+     * volumeType specifies a volume type to use when creating the root volume. If not specified the default volume type will be used.
+     */
     @JsonProperty("volumeType")
     public void setVolumeType(String volumeType) {
         this.volumeType = volumeType;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/SecurityGroupFilter.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/SecurityGroupFilter.java
index c65563f8e23..7342c2a241f 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/SecurityGroupFilter.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/SecurityGroupFilter.java
@@ -126,131 +126,209 @@ public SecurityGroupFilter(String description, String id, Integer limit, String
         this.tenantId = tenantId;
     }
 
+    /**
+     * description filters security groups by description.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * description filters security groups by description.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * id specifies the ID of a security group to use. If set, id will not be validated before use. An invalid id will result in failure to create a server with an appropriate error message.
+     */
     @JsonProperty("id")
     public String getId() {
         return id;
     }
 
+    /**
+     * id specifies the ID of a security group to use. If set, id will not be validated before use. An invalid id will result in failure to create a server with an appropriate error message.
+     */
     @JsonProperty("id")
     public void setId(String id) {
         this.id = id;
     }
 
+    /**
+     * Deprecated: limit is silently ignored. It has no replacement.
+     */
     @JsonProperty("limit")
     public Integer getLimit() {
         return limit;
     }
 
+    /**
+     * Deprecated: limit is silently ignored. It has no replacement.
+     */
     @JsonProperty("limit")
     public void setLimit(Integer limit) {
         this.limit = limit;
     }
 
+    /**
+     * Deprecated: marker is silently ignored. It has no replacement.
+     */
     @JsonProperty("marker")
     public String getMarker() {
         return marker;
     }
 
+    /**
+     * Deprecated: marker is silently ignored. It has no replacement.
+     */
     @JsonProperty("marker")
     public void setMarker(String marker) {
         this.marker = marker;
     }
 
+    /**
+     * name filters security groups by name.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name filters security groups by name.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * notTags filters by security groups which don't match all specified tags. NOT (t1 AND t2...) Multiple tags are comma separated.
+     */
     @JsonProperty("notTags")
     public String getNotTags() {
         return notTags;
     }
 
+    /**
+     * notTags filters by security groups which don't match all specified tags. NOT (t1 AND t2...) Multiple tags are comma separated.
+     */
     @JsonProperty("notTags")
     public void setNotTags(String notTags) {
         this.notTags = notTags;
     }
 
+    /**
+     * notTagsAny filters by security groups which don't match any specified tags. NOT (t1 OR t2...) Multiple tags are comma separated.
+     */
     @JsonProperty("notTagsAny")
     public String getNotTagsAny() {
         return notTagsAny;
     }
 
+    /**
+     * notTagsAny filters by security groups which don't match any specified tags. NOT (t1 OR t2...) Multiple tags are comma separated.
+     */
     @JsonProperty("notTagsAny")
     public void setNotTagsAny(String notTagsAny) {
         this.notTagsAny = notTagsAny;
     }
 
+    /**
+     * projectId filters security groups by project ID.
+     */
     @JsonProperty("projectId")
     public String getProjectId() {
         return projectId;
     }
 
+    /**
+     * projectId filters security groups by project ID.
+     */
     @JsonProperty("projectId")
     public void setProjectId(String projectId) {
         this.projectId = projectId;
     }
 
+    /**
+     * Deprecated: sortDir is silently ignored. It has no replacement.
+     */
     @JsonProperty("sortDir")
     public String getSortDir() {
         return sortDir;
     }
 
+    /**
+     * Deprecated: sortDir is silently ignored. It has no replacement.
+     */
     @JsonProperty("sortDir")
     public void setSortDir(String sortDir) {
         this.sortDir = sortDir;
     }
 
+    /**
+     * Deprecated: sortKey is silently ignored. It has no replacement.
+     */
     @JsonProperty("sortKey")
     public String getSortKey() {
         return sortKey;
     }
 
+    /**
+     * Deprecated: sortKey is silently ignored. It has no replacement.
+     */
     @JsonProperty("sortKey")
     public void setSortKey(String sortKey) {
         this.sortKey = sortKey;
     }
 
+    /**
+     * tags filters by security groups containing all specified tags. Multiple tags are comma separated.
+     */
     @JsonProperty("tags")
     public String getTags() {
         return tags;
     }
 
+    /**
+     * tags filters by security groups containing all specified tags. Multiple tags are comma separated.
+     */
     @JsonProperty("tags")
     public void setTags(String tags) {
         this.tags = tags;
     }
 
+    /**
+     * tagsAny filters by security groups containing any specified tags. Multiple tags are comma separated.
+     */
     @JsonProperty("tagsAny")
     public String getTagsAny() {
         return tagsAny;
     }
 
+    /**
+     * tagsAny filters by security groups containing any specified tags. Multiple tags are comma separated.
+     */
     @JsonProperty("tagsAny")
     public void setTagsAny(String tagsAny) {
         this.tagsAny = tagsAny;
     }
 
+    /**
+     * tenantId filters security groups by tenant ID. Deprecated: use projectId instead. tenantId will be ignored if projectId is set.
+     */
     @JsonProperty("tenantId")
     public String getTenantId() {
         return tenantId;
     }
 
+    /**
+     * tenantId filters security groups by tenant ID. Deprecated: use projectId instead. tenantId will be ignored if projectId is set.
+     */
     @JsonProperty("tenantId")
     public void setTenantId(String tenantId) {
         this.tenantId = tenantId;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/SecurityGroupParam.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/SecurityGroupParam.java
index d2194781a76..1daba88c1d2 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/SecurityGroupParam.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/SecurityGroupParam.java
@@ -96,21 +96,33 @@ public void setFilter(SecurityGroupFilter filter) {
         this.filter = filter;
     }
 
+    /**
+     * Security Group name
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Security Group name
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Security Group UUID
+     */
     @JsonProperty("uuid")
     public String getUuid() {
         return uuid;
     }
 
+    /**
+     * Security Group UUID
+     */
     @JsonProperty("uuid")
     public void setUuid(String uuid) {
         this.uuid = uuid;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/SubnetFilter.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/SubnetFilter.java
index ae595197828..ee9d81b2012 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/SubnetFilter.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/SubnetFilter.java
@@ -158,211 +158,337 @@ public SubnetFilter(String cidr, String description, Boolean enableDhcp, String
         this.tenantId = tenantId;
     }
 
+    /**
+     * cidr filters subnets by CIDR.
+     */
     @JsonProperty("cidr")
     public String getCidr() {
         return cidr;
     }
 
+    /**
+     * cidr filters subnets by CIDR.
+     */
     @JsonProperty("cidr")
     public void setCidr(String cidr) {
         this.cidr = cidr;
     }
 
+    /**
+     * description filters subnets by description.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * description filters subnets by description.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * Deprecated: enableDhcp is silently ignored. It has no replacement.
+     */
     @JsonProperty("enableDhcp")
     public Boolean getEnableDhcp() {
         return enableDhcp;
     }
 
+    /**
+     * Deprecated: enableDhcp is silently ignored. It has no replacement.
+     */
     @JsonProperty("enableDhcp")
     public void setEnableDhcp(Boolean enableDhcp) {
         this.enableDhcp = enableDhcp;
     }
 
+    /**
+     * gateway_ip filters subnets by gateway IP.
+     */
     @JsonProperty("gateway_ip")
     public String getGatewayIp() {
         return gatewayIp;
     }
 
+    /**
+     * gateway_ip filters subnets by gateway IP.
+     */
     @JsonProperty("gateway_ip")
     public void setGatewayIp(String gatewayIp) {
         this.gatewayIp = gatewayIp;
     }
 
+    /**
+     * id is the uuid of a specific subnet to use. If specified, id will not be validated. Instead server creation will fail with an appropriate error.
+     */
     @JsonProperty("id")
     public String getId() {
         return id;
     }
 
+    /**
+     * id is the uuid of a specific subnet to use. If specified, id will not be validated. Instead server creation will fail with an appropriate error.
+     */
     @JsonProperty("id")
     public void setId(String id) {
         this.id = id;
     }
 
+    /**
+     * ipVersion filters subnets by IP version.
+     */
     @JsonProperty("ipVersion")
     public Integer getIpVersion() {
         return ipVersion;
     }
 
+    /**
+     * ipVersion filters subnets by IP version.
+     */
     @JsonProperty("ipVersion")
     public void setIpVersion(Integer ipVersion) {
         this.ipVersion = ipVersion;
     }
 
+    /**
+     * ipv6AddressMode filters subnets by IPv6 address mode.
+     */
     @JsonProperty("ipv6AddressMode")
     public String getIpv6AddressMode() {
         return ipv6AddressMode;
     }
 
+    /**
+     * ipv6AddressMode filters subnets by IPv6 address mode.
+     */
     @JsonProperty("ipv6AddressMode")
     public void setIpv6AddressMode(String ipv6AddressMode) {
         this.ipv6AddressMode = ipv6AddressMode;
     }
 
+    /**
+     * ipv6RaMode filters subnets by IPv6 router adversiement mode.
+     */
     @JsonProperty("ipv6RaMode")
     public String getIpv6RaMode() {
         return ipv6RaMode;
     }
 
+    /**
+     * ipv6RaMode filters subnets by IPv6 router adversiement mode.
+     */
     @JsonProperty("ipv6RaMode")
     public void setIpv6RaMode(String ipv6RaMode) {
         this.ipv6RaMode = ipv6RaMode;
     }
 
+    /**
+     * Deprecated: limit is silently ignored. It has no replacement.
+     */
     @JsonProperty("limit")
     public Integer getLimit() {
         return limit;
     }
 
+    /**
+     * Deprecated: limit is silently ignored. It has no replacement.
+     */
     @JsonProperty("limit")
     public void setLimit(Integer limit) {
         this.limit = limit;
     }
 
+    /**
+     * Deprecated: marker is silently ignored. It has no replacement.
+     */
     @JsonProperty("marker")
     public String getMarker() {
         return marker;
     }
 
+    /**
+     * Deprecated: marker is silently ignored. It has no replacement.
+     */
     @JsonProperty("marker")
     public void setMarker(String marker) {
         this.marker = marker;
     }
 
+    /**
+     * name filters subnets by name.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name filters subnets by name.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Deprecated: networkId is silently ignored. Set uuid on the containing network definition instead.
+     */
     @JsonProperty("networkId")
     public String getNetworkId() {
         return networkId;
     }
 
+    /**
+     * Deprecated: networkId is silently ignored. Set uuid on the containing network definition instead.
+     */
     @JsonProperty("networkId")
     public void setNetworkId(String networkId) {
         this.networkId = networkId;
     }
 
+    /**
+     * notTags filters by subnets which don't match all specified tags. NOT (t1 AND t2...) Multiple tags are comma separated.
+     */
     @JsonProperty("notTags")
     public String getNotTags() {
         return notTags;
     }
 
+    /**
+     * notTags filters by subnets which don't match all specified tags. NOT (t1 AND t2...) Multiple tags are comma separated.
+     */
     @JsonProperty("notTags")
     public void setNotTags(String notTags) {
         this.notTags = notTags;
     }
 
+    /**
+     * notTagsAny filters by subnets which don't match any specified tags. NOT (t1 OR t2...) Multiple tags are comma separated.
+     */
     @JsonProperty("notTagsAny")
     public String getNotTagsAny() {
         return notTagsAny;
     }
 
+    /**
+     * notTagsAny filters by subnets which don't match any specified tags. NOT (t1 OR t2...) Multiple tags are comma separated.
+     */
     @JsonProperty("notTagsAny")
     public void setNotTagsAny(String notTagsAny) {
         this.notTagsAny = notTagsAny;
     }
 
+    /**
+     * projectId filters subnets by project ID.
+     */
     @JsonProperty("projectId")
     public String getProjectId() {
         return projectId;
     }
 
+    /**
+     * projectId filters subnets by project ID.
+     */
     @JsonProperty("projectId")
     public void setProjectId(String projectId) {
         this.projectId = projectId;
     }
 
+    /**
+     * Deprecated: sortDir is silently ignored. It has no replacement.
+     */
     @JsonProperty("sortDir")
     public String getSortDir() {
         return sortDir;
     }
 
+    /**
+     * Deprecated: sortDir is silently ignored. It has no replacement.
+     */
     @JsonProperty("sortDir")
     public void setSortDir(String sortDir) {
         this.sortDir = sortDir;
     }
 
+    /**
+     * Deprecated: sortKey is silently ignored. It has no replacement.
+     */
     @JsonProperty("sortKey")
     public String getSortKey() {
         return sortKey;
     }
 
+    /**
+     * Deprecated: sortKey is silently ignored. It has no replacement.
+     */
     @JsonProperty("sortKey")
     public void setSortKey(String sortKey) {
         this.sortKey = sortKey;
     }
 
+    /**
+     * subnetpoolId filters subnets by subnet pool ID.
+     */
     @JsonProperty("subnetpoolId")
     public String getSubnetpoolId() {
         return subnetpoolId;
     }
 
+    /**
+     * subnetpoolId filters subnets by subnet pool ID.
+     */
     @JsonProperty("subnetpoolId")
     public void setSubnetpoolId(String subnetpoolId) {
         this.subnetpoolId = subnetpoolId;
     }
 
+    /**
+     * tags filters by subnets containing all specified tags. Multiple tags are comma separated.
+     */
     @JsonProperty("tags")
     public String getTags() {
         return tags;
     }
 
+    /**
+     * tags filters by subnets containing all specified tags. Multiple tags are comma separated.
+     */
     @JsonProperty("tags")
     public void setTags(String tags) {
         this.tags = tags;
     }
 
+    /**
+     * tagsAny filters by subnets containing any specified tags. Multiple tags are comma separated.
+     */
     @JsonProperty("tagsAny")
     public String getTagsAny() {
         return tagsAny;
     }
 
+    /**
+     * tagsAny filters by subnets containing any specified tags. Multiple tags are comma separated.
+     */
     @JsonProperty("tagsAny")
     public void setTagsAny(String tagsAny) {
         this.tagsAny = tagsAny;
     }
 
+    /**
+     * tenantId filters subnets by tenant ID. Deprecated: use projectId instead. tenantId will be ignored if projectId is set.
+     */
     @JsonProperty("tenantId")
     public String getTenantId() {
         return tenantId;
     }
 
+    /**
+     * tenantId filters subnets by tenant ID. Deprecated: use projectId instead. tenantId will be ignored if projectId is set.
+     */
     @JsonProperty("tenantId")
     public void setTenantId(String tenantId) {
         this.tenantId = tenantId;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/SubnetParam.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/SubnetParam.java
index dcf5e63ecb2..b7dec77efb0 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/SubnetParam.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1alpha1/SubnetParam.java
@@ -103,32 +103,50 @@ public void setFilter(SubnetFilter filter) {
         this.filter = filter;
     }
 
+    /**
+     * PortSecurity optionally enables or disables security on ports managed by OpenStack
+     */
     @JsonProperty("portSecurity")
     public Boolean getPortSecurity() {
         return portSecurity;
     }
 
+    /**
+     * PortSecurity optionally enables or disables security on ports managed by OpenStack
+     */
     @JsonProperty("portSecurity")
     public void setPortSecurity(Boolean portSecurity) {
         this.portSecurity = portSecurity;
     }
 
+    /**
+     * PortTags are tags that are added to ports created on this subnet
+     */
     @JsonProperty("portTags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPortTags() {
         return portTags;
     }
 
+    /**
+     * PortTags are tags that are added to ports created on this subnet
+     */
     @JsonProperty("portTags")
     public void setPortTags(List<String> portTags) {
         this.portTags = portTags;
     }
 
+    /**
+     * The UUID of the network. Required if you omit the port attribute.
+     */
     @JsonProperty("uuid")
     public String getUuid() {
         return uuid;
     }
 
+    /**
+     * The UUID of the network. Required if you omit the port attribute.
+     */
     @JsonProperty("uuid")
     public void setUuid(String uuid) {
         this.uuid = uuid;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AWSMachineProviderConfig.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AWSMachineProviderConfig.java
index cfc67a43aaa..5552a6807cd 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AWSMachineProviderConfig.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AWSMachineProviderConfig.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSMachineProviderConfig is the Schema for the awsmachineproviderconfigs API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,9 +101,6 @@ public class AWSMachineProviderConfig implements Editable<AWSMachineProviderConf
 
     @JsonProperty("ami")
     private AWSResourceReference ami;
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machine.openshift.io/v1beta1";
     @JsonProperty("blockDevices")
@@ -118,9 +118,6 @@ public class AWSMachineProviderConfig implements Editable<AWSMachineProviderConf
     private String instanceType;
     @JsonProperty("keyName")
     private String keyName;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AWSMachineProviderConfig";
     @JsonProperty("loadBalancers")
@@ -188,18 +185,24 @@ public AWSMachineProviderConfig(AWSResourceReference ami, String apiVersion, Lis
         this.userDataSecret = userDataSecret;
     }
 
+    /**
+     * AWSMachineProviderConfig is the Schema for the awsmachineproviderconfigs API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("ami")
     public AWSResourceReference getAmi() {
         return ami;
     }
 
+    /**
+     * AWSMachineProviderConfig is the Schema for the awsmachineproviderconfigs API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("ami")
     public void setAmi(AWSResourceReference ami) {
         this.ami = ami;
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -207,86 +210,128 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * BlockDevices is the set of block device mapping associated to this instance, block device without a name will be used as a root device and only one device without a name is allowed https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/block-device-mapping-concepts.html
+     */
     @JsonProperty("blockDevices")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<BlockDeviceMappingSpec> getBlockDevices() {
         return blockDevices;
     }
 
+    /**
+     * BlockDevices is the set of block device mapping associated to this instance, block device without a name will be used as a root device and only one device without a name is allowed https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/block-device-mapping-concepts.html
+     */
     @JsonProperty("blockDevices")
     public void setBlockDevices(List<BlockDeviceMappingSpec> blockDevices) {
         this.blockDevices = blockDevices;
     }
 
+    /**
+     * capacityReservationId specifies the target Capacity Reservation into which the instance should be launched. The field size should be greater than 0 and the field input must start with cr-&#42;&#42;&#42;
+     */
     @JsonProperty("capacityReservationId")
     public String getCapacityReservationId() {
         return capacityReservationId;
     }
 
+    /**
+     * capacityReservationId specifies the target Capacity Reservation into which the instance should be launched. The field size should be greater than 0 and the field input must start with cr-&#42;&#42;&#42;
+     */
     @JsonProperty("capacityReservationId")
     public void setCapacityReservationId(String capacityReservationId) {
         this.capacityReservationId = capacityReservationId;
     }
 
+    /**
+     * AWSMachineProviderConfig is the Schema for the awsmachineproviderconfigs API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("credentialsSecret")
     public LocalObjectReference getCredentialsSecret() {
         return credentialsSecret;
     }
 
+    /**
+     * AWSMachineProviderConfig is the Schema for the awsmachineproviderconfigs API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("credentialsSecret")
     public void setCredentialsSecret(LocalObjectReference credentialsSecret) {
         this.credentialsSecret = credentialsSecret;
     }
 
+    /**
+     * DeviceIndex is the index of the device on the instance for the network interface attachment. Defaults to 0.
+     */
     @JsonProperty("deviceIndex")
     public Long getDeviceIndex() {
         return deviceIndex;
     }
 
+    /**
+     * DeviceIndex is the index of the device on the instance for the network interface attachment. Defaults to 0.
+     */
     @JsonProperty("deviceIndex")
     public void setDeviceIndex(Long deviceIndex) {
         this.deviceIndex = deviceIndex;
     }
 
+    /**
+     * AWSMachineProviderConfig is the Schema for the awsmachineproviderconfigs API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("iamInstanceProfile")
     public AWSResourceReference getIamInstanceProfile() {
         return iamInstanceProfile;
     }
 
+    /**
+     * AWSMachineProviderConfig is the Schema for the awsmachineproviderconfigs API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("iamInstanceProfile")
     public void setIamInstanceProfile(AWSResourceReference iamInstanceProfile) {
         this.iamInstanceProfile = iamInstanceProfile;
     }
 
+    /**
+     * InstanceType is the type of instance to create. Example: m4.xlarge
+     */
     @JsonProperty("instanceType")
     public String getInstanceType() {
         return instanceType;
     }
 
+    /**
+     * InstanceType is the type of instance to create. Example: m4.xlarge
+     */
     @JsonProperty("instanceType")
     public void setInstanceType(String instanceType) {
         this.instanceType = instanceType;
     }
 
+    /**
+     * KeyName is the name of the KeyPair to use for SSH
+     */
     @JsonProperty("keyName")
     public String getKeyName() {
         return keyName;
     }
 
+    /**
+     * KeyName is the name of the KeyPair to use for SSH
+     */
     @JsonProperty("keyName")
     public void setKeyName(String keyName) {
         this.keyName = keyName;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -294,141 +339,219 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * LoadBalancers is the set of load balancers to which the new instance should be added once it is created.
+     */
     @JsonProperty("loadBalancers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LoadBalancerReference> getLoadBalancers() {
         return loadBalancers;
     }
 
+    /**
+     * LoadBalancers is the set of load balancers to which the new instance should be added once it is created.
+     */
     @JsonProperty("loadBalancers")
     public void setLoadBalancers(List<LoadBalancerReference> loadBalancers) {
         this.loadBalancers = loadBalancers;
     }
 
+    /**
+     * AWSMachineProviderConfig is the Schema for the awsmachineproviderconfigs API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AWSMachineProviderConfig is the Schema for the awsmachineproviderconfigs API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * AWSMachineProviderConfig is the Schema for the awsmachineproviderconfigs API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadataServiceOptions")
     public MetadataServiceOptions getMetadataServiceOptions() {
         return metadataServiceOptions;
     }
 
+    /**
+     * AWSMachineProviderConfig is the Schema for the awsmachineproviderconfigs API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadataServiceOptions")
     public void setMetadataServiceOptions(MetadataServiceOptions metadataServiceOptions) {
         this.metadataServiceOptions = metadataServiceOptions;
     }
 
+    /**
+     * NetworkInterfaceType specifies the type of network interface to be used for the primary network interface. Valid values are "ENA", "EFA", and omitted, which means no opinion and the platform chooses a good default which may change over time. The current default value is "ENA". Please visit https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/efa.html to learn more about the AWS Elastic Fabric Adapter interface option.
+     */
     @JsonProperty("networkInterfaceType")
     public String getNetworkInterfaceType() {
         return networkInterfaceType;
     }
 
+    /**
+     * NetworkInterfaceType specifies the type of network interface to be used for the primary network interface. Valid values are "ENA", "EFA", and omitted, which means no opinion and the platform chooses a good default which may change over time. The current default value is "ENA". Please visit https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/efa.html to learn more about the AWS Elastic Fabric Adapter interface option.
+     */
     @JsonProperty("networkInterfaceType")
     public void setNetworkInterfaceType(String networkInterfaceType) {
         this.networkInterfaceType = networkInterfaceType;
     }
 
+    /**
+     * AWSMachineProviderConfig is the Schema for the awsmachineproviderconfigs API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("placement")
     public Placement getPlacement() {
         return placement;
     }
 
+    /**
+     * AWSMachineProviderConfig is the Schema for the awsmachineproviderconfigs API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("placement")
     public void setPlacement(Placement placement) {
         this.placement = placement;
     }
 
+    /**
+     * PlacementGroupName specifies the name of the placement group in which to launch the instance. The placement group must already be created and may use any placement strategy. When omitted, no placement group is used when creating the EC2 instance.
+     */
     @JsonProperty("placementGroupName")
     public String getPlacementGroupName() {
         return placementGroupName;
     }
 
+    /**
+     * PlacementGroupName specifies the name of the placement group in which to launch the instance. The placement group must already be created and may use any placement strategy. When omitted, no placement group is used when creating the EC2 instance.
+     */
     @JsonProperty("placementGroupName")
     public void setPlacementGroupName(String placementGroupName) {
         this.placementGroupName = placementGroupName;
     }
 
+    /**
+     * placementGroupPartition is the partition number within the placement group in which to launch the instance. This must be an integer value between 1 and 7. It is only valid if the placement group, referred in `PlacementGroupName` was created with strategy set to partition.
+     */
     @JsonProperty("placementGroupPartition")
     public Integer getPlacementGroupPartition() {
         return placementGroupPartition;
     }
 
+    /**
+     * placementGroupPartition is the partition number within the placement group in which to launch the instance. This must be an integer value between 1 and 7. It is only valid if the placement group, referred in `PlacementGroupName` was created with strategy set to partition.
+     */
     @JsonProperty("placementGroupPartition")
     public void setPlacementGroupPartition(Integer placementGroupPartition) {
         this.placementGroupPartition = placementGroupPartition;
     }
 
+    /**
+     * PublicIP specifies whether the instance should get a public IP. If not present, it should use the default of its subnet.
+     */
     @JsonProperty("publicIp")
     public Boolean getPublicIp() {
         return publicIp;
     }
 
+    /**
+     * PublicIP specifies whether the instance should get a public IP. If not present, it should use the default of its subnet.
+     */
     @JsonProperty("publicIp")
     public void setPublicIp(Boolean publicIp) {
         this.publicIp = publicIp;
     }
 
+    /**
+     * SecurityGroups is an array of references to security groups that should be applied to the instance.
+     */
     @JsonProperty("securityGroups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AWSResourceReference> getSecurityGroups() {
         return securityGroups;
     }
 
+    /**
+     * SecurityGroups is an array of references to security groups that should be applied to the instance.
+     */
     @JsonProperty("securityGroups")
     public void setSecurityGroups(List<AWSResourceReference> securityGroups) {
         this.securityGroups = securityGroups;
     }
 
+    /**
+     * AWSMachineProviderConfig is the Schema for the awsmachineproviderconfigs API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spotMarketOptions")
     public SpotMarketOptions getSpotMarketOptions() {
         return spotMarketOptions;
     }
 
+    /**
+     * AWSMachineProviderConfig is the Schema for the awsmachineproviderconfigs API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spotMarketOptions")
     public void setSpotMarketOptions(SpotMarketOptions spotMarketOptions) {
         this.spotMarketOptions = spotMarketOptions;
     }
 
+    /**
+     * AWSMachineProviderConfig is the Schema for the awsmachineproviderconfigs API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("subnet")
     public AWSResourceReference getSubnet() {
         return subnet;
     }
 
+    /**
+     * AWSMachineProviderConfig is the Schema for the awsmachineproviderconfigs API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("subnet")
     public void setSubnet(AWSResourceReference subnet) {
         this.subnet = subnet;
     }
 
+    /**
+     * Tags is the set of tags to add to apply to an instance, in addition to the ones added by default by the actuator. These tags are additive. The actuator will ensure these tags are present, but will not remove any other tags that may exist on the instance.
+     */
     @JsonProperty("tags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TagSpecification> getTags() {
         return tags;
     }
 
+    /**
+     * Tags is the set of tags to add to apply to an instance, in addition to the ones added by default by the actuator. These tags are additive. The actuator will ensure these tags are present, but will not remove any other tags that may exist on the instance.
+     */
     @JsonProperty("tags")
     public void setTags(List<TagSpecification> tags) {
         this.tags = tags;
     }
 
+    /**
+     * AWSMachineProviderConfig is the Schema for the awsmachineproviderconfigs API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("userDataSecret")
     public LocalObjectReference getUserDataSecret() {
         return userDataSecret;
     }
 
+    /**
+     * AWSMachineProviderConfig is the Schema for the awsmachineproviderconfigs API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("userDataSecret")
     public void setUserDataSecret(LocalObjectReference userDataSecret) {
         this.userDataSecret = userDataSecret;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AWSMachineProviderConfigList.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AWSMachineProviderConfigList.java
index 573133af395..7ba69854589 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AWSMachineProviderConfigList.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AWSMachineProviderConfigList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSMachineProviderConfigList contains a list of AWSMachineProviderConfig Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class AWSMachineProviderConfigList implements Editable<AWSMachineProviderConfigListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.machine.v1beta1.AWSMachineProviderConfig>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machine.openshift.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.machine.v1beta1.AWSMachineProviderConfig> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AWSMachineProviderConfigList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public AWSMachineProviderConfigList(String apiVersion, List<io.fabric8.openshift
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * AWSMachineProviderConfigList contains a list of AWSMachineProviderConfig Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.machine.v1beta1.AWSMachineProviderConfig> getItems() {
         return items;
     }
 
+    /**
+     * AWSMachineProviderConfigList contains a list of AWSMachineProviderConfig Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.machine.v1beta1.AWSMachineProviderConfig> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AWSMachineProviderConfigList contains a list of AWSMachineProviderConfig Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AWSMachineProviderConfigList contains a list of AWSMachineProviderConfig Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AWSMachineProviderStatus.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AWSMachineProviderStatus.java
index 1ab1287741c..12ca7e540c3 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AWSMachineProviderStatus.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AWSMachineProviderStatus.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSMachineProviderStatus is the type that will be embedded in a Machine.Status.ProviderStatus field. It contains AWS-specific status information. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,9 +82,6 @@
 public class AWSMachineProviderStatus implements Editable<AWSMachineProviderStatusBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machine.openshift.io/v1beta1";
     @JsonProperty("conditions")
@@ -91,9 +91,6 @@ public class AWSMachineProviderStatus implements Editable<AWSMachineProviderStat
     private String instanceId;
     @JsonProperty("instanceState")
     private String instanceState;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AWSMachineProviderStatus";
     @JsonIgnore
@@ -115,7 +112,7 @@ public AWSMachineProviderStatus(String apiVersion, List<Condition> conditions, S
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -123,46 +120,64 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Conditions is a set of conditions associated with the Machine to indicate errors or other status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions is a set of conditions associated with the Machine to indicate errors or other status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * InstanceID is the instance ID of the machine created in AWS
+     */
     @JsonProperty("instanceId")
     public String getInstanceId() {
         return instanceId;
     }
 
+    /**
+     * InstanceID is the instance ID of the machine created in AWS
+     */
     @JsonProperty("instanceId")
     public void setInstanceId(String instanceId) {
         this.instanceId = instanceId;
     }
 
+    /**
+     * InstanceState is the state of the AWS instance for this machine
+     */
     @JsonProperty("instanceState")
     public String getInstanceState() {
         return instanceState;
     }
 
+    /**
+     * InstanceState is the state of the AWS instance for this machine
+     */
     @JsonProperty("instanceState")
     public void setInstanceState(String instanceState) {
         this.instanceState = instanceState;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -170,7 +185,7 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AWSResourceReference.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AWSResourceReference.java
index f7425e784da..acce95dccc7 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AWSResourceReference.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AWSResourceReference.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSResourceReference is a reference to a specific AWS resource by ID, ARN, or filters. Only one of ID, ARN or Filters may be specified. Specifying more than one will result in a validation error.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public AWSResourceReference(String arn, List<Filter> filters, String id) {
         this.id = id;
     }
 
+    /**
+     * ARN of resource
+     */
     @JsonProperty("arn")
     public String getArn() {
         return arn;
     }
 
+    /**
+     * ARN of resource
+     */
     @JsonProperty("arn")
     public void setArn(String arn) {
         this.arn = arn;
     }
 
+    /**
+     * Filters is a set of filters used to identify a resource
+     */
     @JsonProperty("filters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Filter> getFilters() {
         return filters;
     }
 
+    /**
+     * Filters is a set of filters used to identify a resource
+     */
     @JsonProperty("filters")
     public void setFilters(List<Filter> filters) {
         this.filters = filters;
     }
 
+    /**
+     * ID of resource
+     */
     @JsonProperty("id")
     public String getId() {
         return id;
     }
 
+    /**
+     * ID of resource
+     */
     @JsonProperty("id")
     public void setId(String id) {
         this.id = id;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AddressesFromPool.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AddressesFromPool.java
index 53ca9e79e07..bb14f4084cd 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AddressesFromPool.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AddressesFromPool.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AddressesFromPool is an IPAddressPool that will be used to create IPAddressClaims for fulfillment by an external controller.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public AddressesFromPool(String group, String name, String resource) {
         this.resource = resource;
     }
 
+    /**
+     * group of the IP address pool type known to an external IPAM controller. This should be a fully qualified domain name, for example, externalipam.controller.io.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * group of the IP address pool type known to an external IPAM controller. This should be a fully qualified domain name, for example, externalipam.controller.io.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * name of an IP address pool, for example, pool-config-1.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name of an IP address pool, for example, pool-config-1.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * resource of the IP address pool type known to an external IPAM controller. It is normally the plural form of the resource kind in lowercase, for example, ippools.
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * resource of the IP address pool type known to an external IPAM controller. It is normally the plural form of the resource kind in lowercase, for example, ippools.
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AzureBootDiagnostics.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AzureBootDiagnostics.java
index 4f3040cc4c6..1ac8f899e0c 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AzureBootDiagnostics.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AzureBootDiagnostics.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzureBootDiagnostics configures the boot diagnostics settings for the virtual machine. This allows you to configure capturing serial output from the virtual machine on boot. This is useful for debugging software based launch issues.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public AzureBootDiagnostics(AzureCustomerManagedBootDiagnostics customerManaged,
         this.storageAccountType = storageAccountType;
     }
 
+    /**
+     * AzureBootDiagnostics configures the boot diagnostics settings for the virtual machine. This allows you to configure capturing serial output from the virtual machine on boot. This is useful for debugging software based launch issues.
+     */
     @JsonProperty("customerManaged")
     public AzureCustomerManagedBootDiagnostics getCustomerManaged() {
         return customerManaged;
     }
 
+    /**
+     * AzureBootDiagnostics configures the boot diagnostics settings for the virtual machine. This allows you to configure capturing serial output from the virtual machine on boot. This is useful for debugging software based launch issues.
+     */
     @JsonProperty("customerManaged")
     public void setCustomerManaged(AzureCustomerManagedBootDiagnostics customerManaged) {
         this.customerManaged = customerManaged;
     }
 
+    /**
+     * StorageAccountType determines if the storage account for storing the diagnostics data should be provisioned by Azure (AzureManaged) or by the customer (CustomerManaged).
+     */
     @JsonProperty("storageAccountType")
     public String getStorageAccountType() {
         return storageAccountType;
     }
 
+    /**
+     * StorageAccountType determines if the storage account for storing the diagnostics data should be provisioned by Azure (AzureManaged) or by the customer (CustomerManaged).
+     */
     @JsonProperty("storageAccountType")
     public void setStorageAccountType(String storageAccountType) {
         this.storageAccountType = storageAccountType;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AzureCustomerManagedBootDiagnostics.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AzureCustomerManagedBootDiagnostics.java
index bff0c2b9b54..3f3fd38bf92 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AzureCustomerManagedBootDiagnostics.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AzureCustomerManagedBootDiagnostics.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzureCustomerManagedBootDiagnostics provides reference to a customer managed storage account.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public AzureCustomerManagedBootDiagnostics(String storageAccountURI) {
         this.storageAccountURI = storageAccountURI;
     }
 
+    /**
+     * StorageAccountURI is the URI of the customer managed storage account. The URI typically will be `https://&lt;mystorageaccountname&gt;.blob.core.windows.net/` but may differ if you are using Azure DNS zone endpoints. You can find the correct endpoint by looking for the Blob Primary Endpoint in the endpoints tab in the Azure console.
+     */
     @JsonProperty("storageAccountURI")
     public String getStorageAccountURI() {
         return storageAccountURI;
     }
 
+    /**
+     * StorageAccountURI is the URI of the customer managed storage account. The URI typically will be `https://&lt;mystorageaccountname&gt;.blob.core.windows.net/` but may differ if you are using Azure DNS zone endpoints. You can find the correct endpoint by looking for the Blob Primary Endpoint in the endpoints tab in the Azure console.
+     */
     @JsonProperty("storageAccountURI")
     public void setStorageAccountURI(String storageAccountURI) {
         this.storageAccountURI = storageAccountURI;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AzureDiagnostics.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AzureDiagnostics.java
index 0026803a80c..f8dff87e62e 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AzureDiagnostics.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AzureDiagnostics.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzureDiagnostics is used to configure the diagnostic settings of the virtual machine.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public AzureDiagnostics(AzureBootDiagnostics boot) {
         this.boot = boot;
     }
 
+    /**
+     * AzureDiagnostics is used to configure the diagnostic settings of the virtual machine.
+     */
     @JsonProperty("boot")
     public AzureBootDiagnostics getBoot() {
         return boot;
     }
 
+    /**
+     * AzureDiagnostics is used to configure the diagnostic settings of the virtual machine.
+     */
     @JsonProperty("boot")
     public void setBoot(AzureBootDiagnostics boot) {
         this.boot = boot;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AzureMachineProviderSpec.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AzureMachineProviderSpec.java
index de9d027cdce..2158d63587d 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AzureMachineProviderSpec.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AzureMachineProviderSpec.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzureMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an Azure virtual machine. It is used by the Azure machine actuator to create a single Machine. Required parameters such as location that are not specified by this configuration, will be defaulted by the actuator. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -107,9 +110,6 @@ public class AzureMachineProviderSpec implements Editable<AzureMachineProviderSp
 
     @JsonProperty("acceleratedNetworking")
     private Boolean acceleratedNetworking;
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machine.openshift.io/v1beta1";
     @JsonProperty("applicationSecurityGroups")
@@ -130,9 +130,6 @@ public class AzureMachineProviderSpec implements Editable<AzureMachineProviderSp
     private Image image;
     @JsonProperty("internalLoadBalancer")
     private String internalLoadBalancer;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AzureMachineProviderSpec";
     @JsonProperty("location")
@@ -220,18 +217,24 @@ public AzureMachineProviderSpec(Boolean acceleratedNetworking, String apiVersion
         this.zone = zone;
     }
 
+    /**
+     * AcceleratedNetworking enables or disables Azure accelerated networking feature. Set to false by default. If true, then this will depend on whether the requested VMSize is supported. If set to true with an unsupported VMSize, Azure will return an error.
+     */
     @JsonProperty("acceleratedNetworking")
     public Boolean getAcceleratedNetworking() {
         return acceleratedNetworking;
     }
 
+    /**
+     * AcceleratedNetworking enables or disables Azure accelerated networking feature. Set to false by default. If true, then this will depend on whether the requested VMSize is supported. If set to true with an unsupported VMSize, Azure will return an error.
+     */
     @JsonProperty("acceleratedNetworking")
     public void setAcceleratedNetworking(Boolean acceleratedNetworking) {
         this.acceleratedNetworking = acceleratedNetworking;
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -239,97 +242,145 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Application Security Groups that need to be attached to the machine's interface. No application security groups will be attached if zero-length.
+     */
     @JsonProperty("applicationSecurityGroups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApplicationSecurityGroups() {
         return applicationSecurityGroups;
     }
 
+    /**
+     * Application Security Groups that need to be attached to the machine's interface. No application security groups will be attached if zero-length.
+     */
     @JsonProperty("applicationSecurityGroups")
     public void setApplicationSecurityGroups(List<String> applicationSecurityGroups) {
         this.applicationSecurityGroups = applicationSecurityGroups;
     }
 
+    /**
+     * AvailabilitySet specifies the availability set to use for this instance. Availability set should be precreated, before using this field.
+     */
     @JsonProperty("availabilitySet")
     public String getAvailabilitySet() {
         return availabilitySet;
     }
 
+    /**
+     * AvailabilitySet specifies the availability set to use for this instance. Availability set should be precreated, before using this field.
+     */
     @JsonProperty("availabilitySet")
     public void setAvailabilitySet(String availabilitySet) {
         this.availabilitySet = availabilitySet;
     }
 
+    /**
+     * capacityReservationGroupID specifies the capacity reservation group resource id that should be used for allocating the virtual machine. The field size should be greater than 0 and the field input must start with '/'. The input for capacityReservationGroupID must be similar to '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{capacityReservationGroupName}'. The keys which are used should be among 'subscriptions', 'providers' and 'resourcegroups' followed by valid ID or names respectively.
+     */
     @JsonProperty("capacityReservationGroupID")
     public String getCapacityReservationGroupID() {
         return capacityReservationGroupID;
     }
 
+    /**
+     * capacityReservationGroupID specifies the capacity reservation group resource id that should be used for allocating the virtual machine. The field size should be greater than 0 and the field input must start with '/'. The input for capacityReservationGroupID must be similar to '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{capacityReservationGroupName}'. The keys which are used should be among 'subscriptions', 'providers' and 'resourcegroups' followed by valid ID or names respectively.
+     */
     @JsonProperty("capacityReservationGroupID")
     public void setCapacityReservationGroupID(String capacityReservationGroupID) {
         this.capacityReservationGroupID = capacityReservationGroupID;
     }
 
+    /**
+     * AzureMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an Azure virtual machine. It is used by the Azure machine actuator to create a single Machine. Required parameters such as location that are not specified by this configuration, will be defaulted by the actuator. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("credentialsSecret")
     public SecretReference getCredentialsSecret() {
         return credentialsSecret;
     }
 
+    /**
+     * AzureMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an Azure virtual machine. It is used by the Azure machine actuator to create a single Machine. Required parameters such as location that are not specified by this configuration, will be defaulted by the actuator. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("credentialsSecret")
     public void setCredentialsSecret(SecretReference credentialsSecret) {
         this.credentialsSecret = credentialsSecret;
     }
 
+    /**
+     * DataDisk specifies the parameters that are used to add one or more data disks to the machine.
+     */
     @JsonProperty("dataDisks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DataDisk> getDataDisks() {
         return dataDisks;
     }
 
+    /**
+     * DataDisk specifies the parameters that are used to add one or more data disks to the machine.
+     */
     @JsonProperty("dataDisks")
     public void setDataDisks(List<DataDisk> dataDisks) {
         this.dataDisks = dataDisks;
     }
 
+    /**
+     * AzureMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an Azure virtual machine. It is used by the Azure machine actuator to create a single Machine. Required parameters such as location that are not specified by this configuration, will be defaulted by the actuator. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("diagnostics")
     public AzureDiagnostics getDiagnostics() {
         return diagnostics;
     }
 
+    /**
+     * AzureMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an Azure virtual machine. It is used by the Azure machine actuator to create a single Machine. Required parameters such as location that are not specified by this configuration, will be defaulted by the actuator. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("diagnostics")
     public void setDiagnostics(AzureDiagnostics diagnostics) {
         this.diagnostics = diagnostics;
     }
 
+    /**
+     * AzureMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an Azure virtual machine. It is used by the Azure machine actuator to create a single Machine. Required parameters such as location that are not specified by this configuration, will be defaulted by the actuator. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("image")
     public Image getImage() {
         return image;
     }
 
+    /**
+     * AzureMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an Azure virtual machine. It is used by the Azure machine actuator to create a single Machine. Required parameters such as location that are not specified by this configuration, will be defaulted by the actuator. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("image")
     public void setImage(Image image) {
         this.image = image;
     }
 
+    /**
+     * InternalLoadBalancerName to use for this instance
+     */
     @JsonProperty("internalLoadBalancer")
     public String getInternalLoadBalancer() {
         return internalLoadBalancer;
     }
 
+    /**
+     * InternalLoadBalancerName to use for this instance
+     */
     @JsonProperty("internalLoadBalancer")
     public void setInternalLoadBalancer(String internalLoadBalancer) {
         this.internalLoadBalancer = internalLoadBalancer;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -337,209 +388,329 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Location is the region to use to create the instance
+     */
     @JsonProperty("location")
     public String getLocation() {
         return location;
     }
 
+    /**
+     * Location is the region to use to create the instance
+     */
     @JsonProperty("location")
     public void setLocation(String location) {
         this.location = location;
     }
 
+    /**
+     * ManagedIdentity to set managed identity name
+     */
     @JsonProperty("managedIdentity")
     public String getManagedIdentity() {
         return managedIdentity;
     }
 
+    /**
+     * ManagedIdentity to set managed identity name
+     */
     @JsonProperty("managedIdentity")
     public void setManagedIdentity(String managedIdentity) {
         this.managedIdentity = managedIdentity;
     }
 
+    /**
+     * AzureMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an Azure virtual machine. It is used by the Azure machine actuator to create a single Machine. Required parameters such as location that are not specified by this configuration, will be defaulted by the actuator. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AzureMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an Azure virtual machine. It is used by the Azure machine actuator to create a single Machine. Required parameters such as location that are not specified by this configuration, will be defaulted by the actuator. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * NatRule to set inbound NAT rule of the load balancer
+     */
     @JsonProperty("natRule")
     public Long getNatRule() {
         return natRule;
     }
 
+    /**
+     * NatRule to set inbound NAT rule of the load balancer
+     */
     @JsonProperty("natRule")
     public void setNatRule(Long natRule) {
         this.natRule = natRule;
     }
 
+    /**
+     * NetworkResourceGroup is the resource group for the virtual machine's network
+     */
     @JsonProperty("networkResourceGroup")
     public String getNetworkResourceGroup() {
         return networkResourceGroup;
     }
 
+    /**
+     * NetworkResourceGroup is the resource group for the virtual machine's network
+     */
     @JsonProperty("networkResourceGroup")
     public void setNetworkResourceGroup(String networkResourceGroup) {
         this.networkResourceGroup = networkResourceGroup;
     }
 
+    /**
+     * AzureMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an Azure virtual machine. It is used by the Azure machine actuator to create a single Machine. Required parameters such as location that are not specified by this configuration, will be defaulted by the actuator. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("osDisk")
     public OSDisk getOsDisk() {
         return osDisk;
     }
 
+    /**
+     * AzureMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an Azure virtual machine. It is used by the Azure machine actuator to create a single Machine. Required parameters such as location that are not specified by this configuration, will be defaulted by the actuator. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("osDisk")
     public void setOsDisk(OSDisk osDisk) {
         this.osDisk = osDisk;
     }
 
+    /**
+     * PublicIP if true a public IP will be used
+     */
     @JsonProperty("publicIP")
     public Boolean getPublicIP() {
         return publicIP;
     }
 
+    /**
+     * PublicIP if true a public IP will be used
+     */
     @JsonProperty("publicIP")
     public void setPublicIP(Boolean publicIP) {
         this.publicIP = publicIP;
     }
 
+    /**
+     * PublicLoadBalancer to use for this instance
+     */
     @JsonProperty("publicLoadBalancer")
     public String getPublicLoadBalancer() {
         return publicLoadBalancer;
     }
 
+    /**
+     * PublicLoadBalancer to use for this instance
+     */
     @JsonProperty("publicLoadBalancer")
     public void setPublicLoadBalancer(String publicLoadBalancer) {
         this.publicLoadBalancer = publicLoadBalancer;
     }
 
+    /**
+     * ResourceGroup is the resource group for the virtual machine
+     */
     @JsonProperty("resourceGroup")
     public String getResourceGroup() {
         return resourceGroup;
     }
 
+    /**
+     * ResourceGroup is the resource group for the virtual machine
+     */
     @JsonProperty("resourceGroup")
     public void setResourceGroup(String resourceGroup) {
         this.resourceGroup = resourceGroup;
     }
 
+    /**
+     * Network Security Group that needs to be attached to the machine's interface. No security group will be attached if empty.
+     */
     @JsonProperty("securityGroup")
     public String getSecurityGroup() {
         return securityGroup;
     }
 
+    /**
+     * Network Security Group that needs to be attached to the machine's interface. No security group will be attached if empty.
+     */
     @JsonProperty("securityGroup")
     public void setSecurityGroup(String securityGroup) {
         this.securityGroup = securityGroup;
     }
 
+    /**
+     * AzureMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an Azure virtual machine. It is used by the Azure machine actuator to create a single Machine. Required parameters such as location that are not specified by this configuration, will be defaulted by the actuator. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("securityProfile")
     public SecurityProfile getSecurityProfile() {
         return securityProfile;
     }
 
+    /**
+     * AzureMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an Azure virtual machine. It is used by the Azure machine actuator to create a single Machine. Required parameters such as location that are not specified by this configuration, will be defaulted by the actuator. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("securityProfile")
     public void setSecurityProfile(SecurityProfile securityProfile) {
         this.securityProfile = securityProfile;
     }
 
+    /**
+     * AzureMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an Azure virtual machine. It is used by the Azure machine actuator to create a single Machine. Required parameters such as location that are not specified by this configuration, will be defaulted by the actuator. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spotVMOptions")
     public SpotVMOptions getSpotVMOptions() {
         return spotVMOptions;
     }
 
+    /**
+     * AzureMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an Azure virtual machine. It is used by the Azure machine actuator to create a single Machine. Required parameters such as location that are not specified by this configuration, will be defaulted by the actuator. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spotVMOptions")
     public void setSpotVMOptions(SpotVMOptions spotVMOptions) {
         this.spotVMOptions = spotVMOptions;
     }
 
+    /**
+     * SSHPublicKey is the public key to use to SSH to the virtual machine.
+     */
     @JsonProperty("sshPublicKey")
     public String getSshPublicKey() {
         return sshPublicKey;
     }
 
+    /**
+     * SSHPublicKey is the public key to use to SSH to the virtual machine.
+     */
     @JsonProperty("sshPublicKey")
     public void setSshPublicKey(String sshPublicKey) {
         this.sshPublicKey = sshPublicKey;
     }
 
+    /**
+     * Subnet to use for this instance
+     */
     @JsonProperty("subnet")
     public String getSubnet() {
         return subnet;
     }
 
+    /**
+     * Subnet to use for this instance
+     */
     @JsonProperty("subnet")
     public void setSubnet(String subnet) {
         this.subnet = subnet;
     }
 
+    /**
+     * Tags is a list of tags to apply to the machine.
+     */
     @JsonProperty("tags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getTags() {
         return tags;
     }
 
+    /**
+     * Tags is a list of tags to apply to the machine.
+     */
     @JsonProperty("tags")
     public void setTags(Map<String, String> tags) {
         this.tags = tags;
     }
 
+    /**
+     * UltraSSDCapability enables or disables Azure UltraSSD capability for a virtual machine. This can be used to allow/disallow binding of Azure UltraSSD to the Machine both as Data Disks or via Persistent Volumes. This Azure feature is subject to a specific scope and certain limitations. More informations on this can be found in the official Azure documentation for Ultra Disks: (https://docs.microsoft.com/en-us/azure/virtual-machines/disks-enable-ultra-ssd?tabs=azure-portal#ga-scope-and-limitations).<br><p> <br><p> When omitted, if at least one Data Disk of type UltraSSD is specified, the platform will automatically enable the capability. If a Perisistent Volume backed by an UltraSSD is bound to a Pod on the Machine, when this field is ommitted, the platform will &#42;not&#42; automatically enable the capability (unless already enabled by the presence of an UltraSSD as Data Disk). This may manifest in the Pod being stuck in `ContainerCreating` phase. This defaulting behaviour may be subject to change in future.<br><p> <br><p> When set to "Enabled", if the capability is available for the Machine based on the scope and limitations described above, the capability will be set on the Machine. This will thus allow UltraSSD both as Data Disks and Persistent Volumes. If set to "Enabled" when the capability can't be available due to scope and limitations, the Machine will go into "Failed" state.<br><p> <br><p> When set to "Disabled", UltraSSDs will not be allowed either as Data Disks nor as Persistent Volumes. In this case if any UltraSSDs are specified as Data Disks on a Machine, the Machine will go into a "Failed" state. If instead any UltraSSDs are backing the volumes (via Persistent Volumes) of any Pods scheduled on a Node which is backed by the Machine, the Pod may get stuck in `ContainerCreating` phase.
+     */
     @JsonProperty("ultraSSDCapability")
     public String getUltraSSDCapability() {
         return ultraSSDCapability;
     }
 
+    /**
+     * UltraSSDCapability enables or disables Azure UltraSSD capability for a virtual machine. This can be used to allow/disallow binding of Azure UltraSSD to the Machine both as Data Disks or via Persistent Volumes. This Azure feature is subject to a specific scope and certain limitations. More informations on this can be found in the official Azure documentation for Ultra Disks: (https://docs.microsoft.com/en-us/azure/virtual-machines/disks-enable-ultra-ssd?tabs=azure-portal#ga-scope-and-limitations).<br><p> <br><p> When omitted, if at least one Data Disk of type UltraSSD is specified, the platform will automatically enable the capability. If a Perisistent Volume backed by an UltraSSD is bound to a Pod on the Machine, when this field is ommitted, the platform will &#42;not&#42; automatically enable the capability (unless already enabled by the presence of an UltraSSD as Data Disk). This may manifest in the Pod being stuck in `ContainerCreating` phase. This defaulting behaviour may be subject to change in future.<br><p> <br><p> When set to "Enabled", if the capability is available for the Machine based on the scope and limitations described above, the capability will be set on the Machine. This will thus allow UltraSSD both as Data Disks and Persistent Volumes. If set to "Enabled" when the capability can't be available due to scope and limitations, the Machine will go into "Failed" state.<br><p> <br><p> When set to "Disabled", UltraSSDs will not be allowed either as Data Disks nor as Persistent Volumes. In this case if any UltraSSDs are specified as Data Disks on a Machine, the Machine will go into a "Failed" state. If instead any UltraSSDs are backing the volumes (via Persistent Volumes) of any Pods scheduled on a Node which is backed by the Machine, the Pod may get stuck in `ContainerCreating` phase.
+     */
     @JsonProperty("ultraSSDCapability")
     public void setUltraSSDCapability(String ultraSSDCapability) {
         this.ultraSSDCapability = ultraSSDCapability;
     }
 
+    /**
+     * AzureMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an Azure virtual machine. It is used by the Azure machine actuator to create a single Machine. Required parameters such as location that are not specified by this configuration, will be defaulted by the actuator. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("userDataSecret")
     public SecretReference getUserDataSecret() {
         return userDataSecret;
     }
 
+    /**
+     * AzureMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an Azure virtual machine. It is used by the Azure machine actuator to create a single Machine. Required parameters such as location that are not specified by this configuration, will be defaulted by the actuator. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("userDataSecret")
     public void setUserDataSecret(SecretReference userDataSecret) {
         this.userDataSecret = userDataSecret;
     }
 
+    /**
+     * VMSize is the size of the VM to create.
+     */
     @JsonProperty("vmSize")
     public String getVmSize() {
         return vmSize;
     }
 
+    /**
+     * VMSize is the size of the VM to create.
+     */
     @JsonProperty("vmSize")
     public void setVmSize(String vmSize) {
         this.vmSize = vmSize;
     }
 
+    /**
+     * Vnet to set virtual network name
+     */
     @JsonProperty("vnet")
     public String getVnet() {
         return vnet;
     }
 
+    /**
+     * Vnet to set virtual network name
+     */
     @JsonProperty("vnet")
     public void setVnet(String vnet) {
         this.vnet = vnet;
     }
 
+    /**
+     * Availability Zone for the virtual machine. If nil, the virtual machine should be deployed to no zone
+     */
     @JsonProperty("zone")
     public String getZone() {
         return zone;
     }
 
+    /**
+     * Availability Zone for the virtual machine. If nil, the virtual machine should be deployed to no zone
+     */
     @JsonProperty("zone")
     public void setZone(String zone) {
         this.zone = zone;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AzureMachineProviderStatus.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AzureMachineProviderStatus.java
index 92a7223a6b0..ebb3ca00482 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AzureMachineProviderStatus.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/AzureMachineProviderStatus.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzureMachineProviderStatus is the type that will be embedded in a Machine.Status.ProviderStatus field. It contains Azure-specific status information. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -80,17 +83,11 @@
 public class AzureMachineProviderStatus implements Editable<AzureMachineProviderStatusBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machine.openshift.io/v1beta1";
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<Condition> conditions = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AzureMachineProviderStatus";
     @JsonProperty("metadata")
@@ -119,7 +116,7 @@ public AzureMachineProviderStatus(String apiVersion, List<Condition> conditions,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -127,26 +124,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Conditions is a set of conditions associated with the Machine to indicate errors or other status.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions is a set of conditions associated with the Machine to indicate errors or other status.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -154,38 +157,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AzureMachineProviderStatus is the type that will be embedded in a Machine.Status.ProviderStatus field. It contains Azure-specific status information. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AzureMachineProviderStatus is the type that will be embedded in a Machine.Status.ProviderStatus field. It contains Azure-specific status information. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * VMID is the ID of the virtual machine created in Azure.
+     */
     @JsonProperty("vmId")
     public String getVmId() {
         return vmId;
     }
 
+    /**
+     * VMID is the ID of the virtual machine created in Azure.
+     */
     @JsonProperty("vmId")
     public void setVmId(String vmId) {
         this.vmId = vmId;
     }
 
+    /**
+     * VMState is the provisioning state of the Azure virtual machine.
+     */
     @JsonProperty("vmState")
     public String getVmState() {
         return vmState;
     }
 
+    /**
+     * VMState is the provisioning state of the Azure virtual machine.
+     */
     @JsonProperty("vmState")
     public void setVmState(String vmState) {
         this.vmState = vmState;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/BlockDeviceMappingSpec.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/BlockDeviceMappingSpec.java
index 72ff4e8c012..47516ab1f28 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/BlockDeviceMappingSpec.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/BlockDeviceMappingSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BlockDeviceMappingSpec describes a block device mapping
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public BlockDeviceMappingSpec(String deviceName, EBSBlockDeviceSpec ebs, String
         this.virtualName = virtualName;
     }
 
+    /**
+     * The device name exposed to the machine (for example, /dev/sdh or xvdh).
+     */
     @JsonProperty("deviceName")
     public String getDeviceName() {
         return deviceName;
     }
 
+    /**
+     * The device name exposed to the machine (for example, /dev/sdh or xvdh).
+     */
     @JsonProperty("deviceName")
     public void setDeviceName(String deviceName) {
         this.deviceName = deviceName;
     }
 
+    /**
+     * BlockDeviceMappingSpec describes a block device mapping
+     */
     @JsonProperty("ebs")
     public EBSBlockDeviceSpec getEbs() {
         return ebs;
     }
 
+    /**
+     * BlockDeviceMappingSpec describes a block device mapping
+     */
     @JsonProperty("ebs")
     public void setEbs(EBSBlockDeviceSpec ebs) {
         this.ebs = ebs;
     }
 
+    /**
+     * Suppresses the specified device included in the block device mapping of the AMI.
+     */
     @JsonProperty("noDevice")
     public String getNoDevice() {
         return noDevice;
     }
 
+    /**
+     * Suppresses the specified device included in the block device mapping of the AMI.
+     */
     @JsonProperty("noDevice")
     public void setNoDevice(String noDevice) {
         this.noDevice = noDevice;
     }
 
+    /**
+     * The virtual device name (ephemeralN). Machine store volumes are numbered starting from 0. An machine type with 2 available machine store volumes can specify mappings for ephemeral0 and ephemeral1.The number of available machine store volumes depends on the machine type. After you connect to the machine, you must mount the volume.<br><p> <br><p> Constraints: For M3 machines, you must specify machine store volumes in the block device mapping for the machine. When you launch an M3 machine, we ignore any machine store volumes specified in the block device mapping for the AMI.
+     */
     @JsonProperty("virtualName")
     public String getVirtualName() {
         return virtualName;
     }
 
+    /**
+     * The virtual device name (ephemeralN). Machine store volumes are numbered starting from 0. An machine type with 2 available machine store volumes can specify mappings for ephemeral0 and ephemeral1.The number of available machine store volumes depends on the machine type. After you connect to the machine, you must mount the volume.<br><p> <br><p> Constraints: For M3 machines, you must specify machine store volumes in the block device mapping for the machine. When you launch an M3 machine, we ignore any machine store volumes specified in the block device mapping for the AMI.
+     */
     @JsonProperty("virtualName")
     public void setVirtualName(String virtualName) {
         this.virtualName = virtualName;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/Condition.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/Condition.java
index 5f4746b26fd..77b22b95c11 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/Condition.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/Condition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Condition defines an observation of a Machine API resource operational state.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public Condition(String lastTransitionTime, String message, String reason, Strin
         this.type = type;
     }
 
+    /**
+     * Condition defines an observation of a Machine API resource operational state.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * Condition defines an observation of a Machine API resource operational state.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * A human readable message indicating details about the transition. This field may be empty.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * A human readable message indicating details about the transition. This field may be empty.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * The reason for the condition's last transition in CamelCase. The specific API may choose whether or not this field is considered a guaranteed API. This field may not be empty.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * The reason for the condition's last transition in CamelCase. The specific API may choose whether or not this field is considered a guaranteed API. This field may not be empty.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Severity provides an explicit classification of Reason code, so the users or machines can immediately understand the current situation and act accordingly. The Severity field MUST be set only when Status=False.
+     */
     @JsonProperty("severity")
     public String getSeverity() {
         return severity;
     }
 
+    /**
+     * Severity provides an explicit classification of Reason code, so the users or machines can immediately understand the current situation and act accordingly. The Severity field MUST be set only when Status=False.
+     */
     @JsonProperty("severity")
     public void setSeverity(String severity) {
         this.severity = severity;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type of condition in CamelCase or in foo.example.com/CamelCase. Many .condition.type values are consistent across resources like Available, but because arbitrary conditions can be useful (see .node.status.conditions), the ability to deconflict is important.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of condition in CamelCase or in foo.example.com/CamelCase. Many .condition.type values are consistent across resources like Available, but because arbitrary conditions can be useful (see .node.status.conditions), the ability to deconflict is important.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/ConfidentialVM.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/ConfidentialVM.java
index ee450fe6ebb..a5b637433ff 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/ConfidentialVM.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/ConfidentialVM.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConfidentialVM defines the UEFI settings for the virtual machine.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ConfidentialVM(UEFISettings uefiSettings) {
         this.uefiSettings = uefiSettings;
     }
 
+    /**
+     * ConfidentialVM defines the UEFI settings for the virtual machine.
+     */
     @JsonProperty("uefiSettings")
     public UEFISettings getUefiSettings() {
         return uefiSettings;
     }
 
+    /**
+     * ConfidentialVM defines the UEFI settings for the virtual machine.
+     */
     @JsonProperty("uefiSettings")
     public void setUefiSettings(UEFISettings uefiSettings) {
         this.uefiSettings = uefiSettings;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/DataDisk.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/DataDisk.java
index 1b4178fc617..58f7f6a8b17 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/DataDisk.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/DataDisk.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DataDisk specifies the parameters that are used to add one or more data disks to the machine. A Data Disk is a managed disk that's attached to a virtual machine to store application data. It differs from an OS Disk as it doesn't come with a pre-installed OS, and it cannot contain the boot volume. It is registered as SCSI drive and labeled with the chosen `lun`. e.g. for `lun: 0` the raw disk device will be available at `/dev/disk/azure/scsi1/lun0`.<br><p> <br><p> As the Data Disk disk device is attached raw to the virtual machine, it will need to be partitioned, formatted with a filesystem and mounted, in order for it to be usable. This can be done by creating a custom userdata Secret with custom Ignition configuration to achieve the desired initialization. At this stage the previously defined `lun` is to be used as the "device" key for referencing the raw disk device to be initialized. Once the custom userdata Secret has been created, it can be referenced in the Machine's `.providerSpec.userDataSecret`. For further guidance and examples, please refer to the official OpenShift docs.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public DataDisk(String cachingType, String deletionPolicy, Integer diskSizeGB, I
         this.nameSuffix = nameSuffix;
     }
 
+    /**
+     * CachingType specifies the caching requirements. Empty value means no opinion and the platform chooses a default, which is subject to change over time. Currently the default is CachingTypeNone.
+     */
     @JsonProperty("cachingType")
     public String getCachingType() {
         return cachingType;
     }
 
+    /**
+     * CachingType specifies the caching requirements. Empty value means no opinion and the platform chooses a default, which is subject to change over time. Currently the default is CachingTypeNone.
+     */
     @JsonProperty("cachingType")
     public void setCachingType(String cachingType) {
         this.cachingType = cachingType;
     }
 
+    /**
+     * DeletionPolicy specifies the data disk deletion policy upon Machine deletion. Possible values are "Delete","Detach". When "Delete" is used the data disk is deleted when the Machine is deleted. When "Detach" is used the data disk is detached from the Machine and retained when the Machine is deleted.
+     */
     @JsonProperty("deletionPolicy")
     public String getDeletionPolicy() {
         return deletionPolicy;
     }
 
+    /**
+     * DeletionPolicy specifies the data disk deletion policy upon Machine deletion. Possible values are "Delete","Detach". When "Delete" is used the data disk is deleted when the Machine is deleted. When "Detach" is used the data disk is detached from the Machine and retained when the Machine is deleted.
+     */
     @JsonProperty("deletionPolicy")
     public void setDeletionPolicy(String deletionPolicy) {
         this.deletionPolicy = deletionPolicy;
     }
 
+    /**
+     * DiskSizeGB is the size in GB to assign to the data disk.
+     */
     @JsonProperty("diskSizeGB")
     public Integer getDiskSizeGB() {
         return diskSizeGB;
     }
 
+    /**
+     * DiskSizeGB is the size in GB to assign to the data disk.
+     */
     @JsonProperty("diskSizeGB")
     public void setDiskSizeGB(Integer diskSizeGB) {
         this.diskSizeGB = diskSizeGB;
     }
 
+    /**
+     * Lun Specifies the logical unit number of the data disk. This value is used to identify data disks within the VM and therefore must be unique for each data disk attached to a VM. This value is also needed for referencing the data disks devices within userdata to perform disk initialization through Ignition (e.g. partition/format/mount). The value must be between 0 and 63.
+     */
     @JsonProperty("lun")
     public Integer getLun() {
         return lun;
     }
 
+    /**
+     * Lun Specifies the logical unit number of the data disk. This value is used to identify data disks within the VM and therefore must be unique for each data disk attached to a VM. This value is also needed for referencing the data disks devices within userdata to perform disk initialization through Ignition (e.g. partition/format/mount). The value must be between 0 and 63.
+     */
     @JsonProperty("lun")
     public void setLun(Integer lun) {
         this.lun = lun;
     }
 
+    /**
+     * DataDisk specifies the parameters that are used to add one or more data disks to the machine. A Data Disk is a managed disk that's attached to a virtual machine to store application data. It differs from an OS Disk as it doesn't come with a pre-installed OS, and it cannot contain the boot volume. It is registered as SCSI drive and labeled with the chosen `lun`. e.g. for `lun: 0` the raw disk device will be available at `/dev/disk/azure/scsi1/lun0`.<br><p> <br><p> As the Data Disk disk device is attached raw to the virtual machine, it will need to be partitioned, formatted with a filesystem and mounted, in order for it to be usable. This can be done by creating a custom userdata Secret with custom Ignition configuration to achieve the desired initialization. At this stage the previously defined `lun` is to be used as the "device" key for referencing the raw disk device to be initialized. Once the custom userdata Secret has been created, it can be referenced in the Machine's `.providerSpec.userDataSecret`. For further guidance and examples, please refer to the official OpenShift docs.
+     */
     @JsonProperty("managedDisk")
     public DataDiskManagedDiskParameters getManagedDisk() {
         return managedDisk;
     }
 
+    /**
+     * DataDisk specifies the parameters that are used to add one or more data disks to the machine. A Data Disk is a managed disk that's attached to a virtual machine to store application data. It differs from an OS Disk as it doesn't come with a pre-installed OS, and it cannot contain the boot volume. It is registered as SCSI drive and labeled with the chosen `lun`. e.g. for `lun: 0` the raw disk device will be available at `/dev/disk/azure/scsi1/lun0`.<br><p> <br><p> As the Data Disk disk device is attached raw to the virtual machine, it will need to be partitioned, formatted with a filesystem and mounted, in order for it to be usable. This can be done by creating a custom userdata Secret with custom Ignition configuration to achieve the desired initialization. At this stage the previously defined `lun` is to be used as the "device" key for referencing the raw disk device to be initialized. Once the custom userdata Secret has been created, it can be referenced in the Machine's `.providerSpec.userDataSecret`. For further guidance and examples, please refer to the official OpenShift docs.
+     */
     @JsonProperty("managedDisk")
     public void setManagedDisk(DataDiskManagedDiskParameters managedDisk) {
         this.managedDisk = managedDisk;
     }
 
+    /**
+     * NameSuffix is the suffix to be appended to the machine name to generate the disk name. Each disk name will be in format &lt;machineName&gt;_&lt;nameSuffix&gt;. NameSuffix name must start and finish with an alphanumeric character and can only contain letters, numbers, underscores, periods or hyphens. The overall disk name must not exceed 80 chars in length.
+     */
     @JsonProperty("nameSuffix")
     public String getNameSuffix() {
         return nameSuffix;
     }
 
+    /**
+     * NameSuffix is the suffix to be appended to the machine name to generate the disk name. Each disk name will be in format &lt;machineName&gt;_&lt;nameSuffix&gt;. NameSuffix name must start and finish with an alphanumeric character and can only contain letters, numbers, underscores, periods or hyphens. The overall disk name must not exceed 80 chars in length.
+     */
     @JsonProperty("nameSuffix")
     public void setNameSuffix(String nameSuffix) {
         this.nameSuffix = nameSuffix;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/DataDiskManagedDiskParameters.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/DataDiskManagedDiskParameters.java
index 73e150ee6a9..438ad5ef82f 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/DataDiskManagedDiskParameters.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/DataDiskManagedDiskParameters.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DataDiskManagedDiskParameters is the parameters of a DataDisk managed disk.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public DataDiskManagedDiskParameters(DiskEncryptionSetParameters diskEncryptionS
         this.storageAccountType = storageAccountType;
     }
 
+    /**
+     * DataDiskManagedDiskParameters is the parameters of a DataDisk managed disk.
+     */
     @JsonProperty("diskEncryptionSet")
     public DiskEncryptionSetParameters getDiskEncryptionSet() {
         return diskEncryptionSet;
     }
 
+    /**
+     * DataDiskManagedDiskParameters is the parameters of a DataDisk managed disk.
+     */
     @JsonProperty("diskEncryptionSet")
     public void setDiskEncryptionSet(DiskEncryptionSetParameters diskEncryptionSet) {
         this.diskEncryptionSet = diskEncryptionSet;
     }
 
+    /**
+     * StorageAccountType is the storage account type to use. Possible values include "Standard_LRS", "Premium_LRS" and "UltraSSD_LRS".
+     */
     @JsonProperty("storageAccountType")
     public String getStorageAccountType() {
         return storageAccountType;
     }
 
+    /**
+     * StorageAccountType is the storage account type to use. Possible values include "Standard_LRS", "Premium_LRS" and "UltraSSD_LRS".
+     */
     @JsonProperty("storageAccountType")
     public void setStorageAccountType(String storageAccountType) {
         this.storageAccountType = storageAccountType;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/DiskEncryptionSetParameters.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/DiskEncryptionSetParameters.java
index 8856a4b690b..8b5ab7e0ecd 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/DiskEncryptionSetParameters.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/DiskEncryptionSetParameters.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DiskEncryptionSetParameters is the disk encryption set properties
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public DiskEncryptionSetParameters(String id) {
         this.id = id;
     }
 
+    /**
+     * ID is the disk encryption set ID Empty value means no opinion and the platform chooses a default, which is subject to change over time. Currently the default is: "Default".
+     */
     @JsonProperty("id")
     public String getId() {
         return id;
     }
 
+    /**
+     * ID is the disk encryption set ID Empty value means no opinion and the platform chooses a default, which is subject to change over time. Currently the default is: "Default".
+     */
     @JsonProperty("id")
     public void setId(String id) {
         this.id = id;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/DiskSettings.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/DiskSettings.java
index 1f30d21bcb8..753cd9956ea 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/DiskSettings.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/DiskSettings.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DiskSettings describe ephemeral disk settings for the os disk.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public DiskSettings(String ephemeralStorageLocation) {
         this.ephemeralStorageLocation = ephemeralStorageLocation;
     }
 
+    /**
+     * EphemeralStorageLocation enables ephemeral OS when set to 'Local'. Possible values include: 'Local'. See https://docs.microsoft.com/en-us/azure/virtual-machines/ephemeral-os-disks for full details. Empty value means no opinion and the platform chooses a default, which is subject to change over time. Currently the default is that disks are saved to remote Azure storage.
+     */
     @JsonProperty("ephemeralStorageLocation")
     public String getEphemeralStorageLocation() {
         return ephemeralStorageLocation;
     }
 
+    /**
+     * EphemeralStorageLocation enables ephemeral OS when set to 'Local'. Possible values include: 'Local'. See https://docs.microsoft.com/en-us/azure/virtual-machines/ephemeral-os-disks for full details. Empty value means no opinion and the platform chooses a default, which is subject to change over time. Currently the default is that disks are saved to remote Azure storage.
+     */
     @JsonProperty("ephemeralStorageLocation")
     public void setEphemeralStorageLocation(String ephemeralStorageLocation) {
         this.ephemeralStorageLocation = ephemeralStorageLocation;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/EBSBlockDeviceSpec.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/EBSBlockDeviceSpec.java
index 851a42ba416..bc97bebd21f 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/EBSBlockDeviceSpec.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/EBSBlockDeviceSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EBSBlockDeviceSpec describes a block device for an EBS volume. https://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/EbsBlockDevice
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public EBSBlockDeviceSpec(Boolean deleteOnTermination, Boolean encrypted, Long i
         this.volumeType = volumeType;
     }
 
+    /**
+     * Indicates whether the EBS volume is deleted on machine termination.
+     */
     @JsonProperty("deleteOnTermination")
     public Boolean getDeleteOnTermination() {
         return deleteOnTermination;
     }
 
+    /**
+     * Indicates whether the EBS volume is deleted on machine termination.
+     */
     @JsonProperty("deleteOnTermination")
     public void setDeleteOnTermination(Boolean deleteOnTermination) {
         this.deleteOnTermination = deleteOnTermination;
     }
 
+    /**
+     * Indicates whether the EBS volume is encrypted. Encrypted Amazon EBS volumes may only be attached to machines that support Amazon EBS encryption.
+     */
     @JsonProperty("encrypted")
     public Boolean getEncrypted() {
         return encrypted;
     }
 
+    /**
+     * Indicates whether the EBS volume is encrypted. Encrypted Amazon EBS volumes may only be attached to machines that support Amazon EBS encryption.
+     */
     @JsonProperty("encrypted")
     public void setEncrypted(Boolean encrypted) {
         this.encrypted = encrypted;
     }
 
+    /**
+     * The number of I/O operations per second (IOPS) that the volume supports. For io1, this represents the number of IOPS that are provisioned for the volume. For gp2, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. For more information about General Purpose SSD baseline performance, I/O credits, and bursting, see Amazon EBS Volume Types (http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html) in the Amazon Elastic Compute Cloud User Guide.<br><p> <br><p> Minimal and maximal IOPS for io1 and gp2 are constrained. Please, check https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html for precise boundaries for individual volumes.<br><p> <br><p> Condition: This parameter is required for requests to create io1 volumes; it is not used in requests to create gp2, st1, sc1, or standard volumes.
+     */
     @JsonProperty("iops")
     public Long getIops() {
         return iops;
     }
 
+    /**
+     * The number of I/O operations per second (IOPS) that the volume supports. For io1, this represents the number of IOPS that are provisioned for the volume. For gp2, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. For more information about General Purpose SSD baseline performance, I/O credits, and bursting, see Amazon EBS Volume Types (http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html) in the Amazon Elastic Compute Cloud User Guide.<br><p> <br><p> Minimal and maximal IOPS for io1 and gp2 are constrained. Please, check https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html for precise boundaries for individual volumes.<br><p> <br><p> Condition: This parameter is required for requests to create io1 volumes; it is not used in requests to create gp2, st1, sc1, or standard volumes.
+     */
     @JsonProperty("iops")
     public void setIops(Long iops) {
         this.iops = iops;
     }
 
+    /**
+     * EBSBlockDeviceSpec describes a block device for an EBS volume. https://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/EbsBlockDevice
+     */
     @JsonProperty("kmsKey")
     public AWSResourceReference getKmsKey() {
         return kmsKey;
     }
 
+    /**
+     * EBSBlockDeviceSpec describes a block device for an EBS volume. https://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/EbsBlockDevice
+     */
     @JsonProperty("kmsKey")
     public void setKmsKey(AWSResourceReference kmsKey) {
         this.kmsKey = kmsKey;
     }
 
+    /**
+     * The size of the volume, in GiB.<br><p> <br><p> Constraints: 1-16384 for General Purpose SSD (gp2), 4-16384 for Provisioned IOPS SSD (io1), 500-16384 for Throughput Optimized HDD (st1), 500-16384 for Cold HDD (sc1), and 1-1024 for Magnetic (standard) volumes. If you specify a snapshot, the volume size must be equal to or larger than the snapshot size.<br><p> <br><p> Default: If you're creating the volume from a snapshot and don't specify a volume size, the default is the snapshot size.
+     */
     @JsonProperty("volumeSize")
     public Long getVolumeSize() {
         return volumeSize;
     }
 
+    /**
+     * The size of the volume, in GiB.<br><p> <br><p> Constraints: 1-16384 for General Purpose SSD (gp2), 4-16384 for Provisioned IOPS SSD (io1), 500-16384 for Throughput Optimized HDD (st1), 500-16384 for Cold HDD (sc1), and 1-1024 for Magnetic (standard) volumes. If you specify a snapshot, the volume size must be equal to or larger than the snapshot size.<br><p> <br><p> Default: If you're creating the volume from a snapshot and don't specify a volume size, the default is the snapshot size.
+     */
     @JsonProperty("volumeSize")
     public void setVolumeSize(Long volumeSize) {
         this.volumeSize = volumeSize;
     }
 
+    /**
+     * The volume type: gp2, io1, st1, sc1, or standard. Default: standard
+     */
     @JsonProperty("volumeType")
     public String getVolumeType() {
         return volumeType;
     }
 
+    /**
+     * The volume type: gp2, io1, st1, sc1, or standard. Default: standard
+     */
     @JsonProperty("volumeType")
     public void setVolumeType(String volumeType) {
         this.volumeType = volumeType;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/Filter.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/Filter.java
index 86cb707db1c..0e3c84ef10d 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/Filter.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/Filter.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Filter is a filter used to identify an AWS resource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public Filter(String name, List<String> values) {
         this.values = values;
     }
 
+    /**
+     * Name of the filter. Filter names are case-sensitive.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the filter. Filter names are case-sensitive.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Values includes one or more filter values. Filter values are case-sensitive.
+     */
     @JsonProperty("values")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getValues() {
         return values;
     }
 
+    /**
+     * Values includes one or more filter values. Filter values are case-sensitive.
+     */
     @JsonProperty("values")
     public void setValues(List<String> values) {
         this.values = values;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPDisk.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPDisk.java
index 59164610509..91f13f83afb 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPDisk.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPDisk.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPDisk describes disks for GCP.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -103,72 +106,114 @@ public GCPDisk(Boolean autoDelete, Boolean boot, GCPEncryptionKeyReference encry
         this.type = type;
     }
 
+    /**
+     * AutoDelete indicates if the disk will be auto-deleted when the instance is deleted (default false).
+     */
     @JsonProperty("autoDelete")
     public Boolean getAutoDelete() {
         return autoDelete;
     }
 
+    /**
+     * AutoDelete indicates if the disk will be auto-deleted when the instance is deleted (default false).
+     */
     @JsonProperty("autoDelete")
     public void setAutoDelete(Boolean autoDelete) {
         this.autoDelete = autoDelete;
     }
 
+    /**
+     * Boot indicates if this is a boot disk (default false).
+     */
     @JsonProperty("boot")
     public Boolean getBoot() {
         return boot;
     }
 
+    /**
+     * Boot indicates if this is a boot disk (default false).
+     */
     @JsonProperty("boot")
     public void setBoot(Boolean boot) {
         this.boot = boot;
     }
 
+    /**
+     * GCPDisk describes disks for GCP.
+     */
     @JsonProperty("encryptionKey")
     public GCPEncryptionKeyReference getEncryptionKey() {
         return encryptionKey;
     }
 
+    /**
+     * GCPDisk describes disks for GCP.
+     */
     @JsonProperty("encryptionKey")
     public void setEncryptionKey(GCPEncryptionKeyReference encryptionKey) {
         this.encryptionKey = encryptionKey;
     }
 
+    /**
+     * Image is the source image to create this disk.
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * Image is the source image to create this disk.
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
     }
 
+    /**
+     * Labels list of labels to apply to the disk.
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabels() {
         return labels;
     }
 
+    /**
+     * Labels list of labels to apply to the disk.
+     */
     @JsonProperty("labels")
     public void setLabels(Map<String, String> labels) {
         this.labels = labels;
     }
 
+    /**
+     * SizeGB is the size of the disk (in GB).
+     */
     @JsonProperty("sizeGb")
     public Long getSizeGb() {
         return sizeGb;
     }
 
+    /**
+     * SizeGB is the size of the disk (in GB).
+     */
     @JsonProperty("sizeGb")
     public void setSizeGb(Long sizeGb) {
         this.sizeGb = sizeGb;
     }
 
+    /**
+     * Type is the type of the disk (eg: pd-standard).
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of the disk (eg: pd-standard).
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPEncryptionKeyReference.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPEncryptionKeyReference.java
index 6d78bbf5877..305019bf67a 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPEncryptionKeyReference.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPEncryptionKeyReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPEncryptionKeyReference describes the encryptionKey to use for a disk's encryption.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public GCPEncryptionKeyReference(GCPKMSKeyReference kmsKey, String kmsKeyService
         this.kmsKeyServiceAccount = kmsKeyServiceAccount;
     }
 
+    /**
+     * GCPEncryptionKeyReference describes the encryptionKey to use for a disk's encryption.
+     */
     @JsonProperty("kmsKey")
     public GCPKMSKeyReference getKmsKey() {
         return kmsKey;
     }
 
+    /**
+     * GCPEncryptionKeyReference describes the encryptionKey to use for a disk's encryption.
+     */
     @JsonProperty("kmsKey")
     public void setKmsKey(GCPKMSKeyReference kmsKey) {
         this.kmsKey = kmsKey;
     }
 
+    /**
+     * KMSKeyServiceAccount is the service account being used for the encryption request for the given KMS key. If absent, the Compute Engine default service account is used. See https://cloud.google.com/compute/docs/access/service-accounts#compute_engine_service_account for details on the default service account.
+     */
     @JsonProperty("kmsKeyServiceAccount")
     public String getKmsKeyServiceAccount() {
         return kmsKeyServiceAccount;
     }
 
+    /**
+     * KMSKeyServiceAccount is the service account being used for the encryption request for the given KMS key. If absent, the Compute Engine default service account is used. See https://cloud.google.com/compute/docs/access/service-accounts#compute_engine_service_account for details on the default service account.
+     */
     @JsonProperty("kmsKeyServiceAccount")
     public void setKmsKeyServiceAccount(String kmsKeyServiceAccount) {
         this.kmsKeyServiceAccount = kmsKeyServiceAccount;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPGPUConfig.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPGPUConfig.java
index 8f55638a122..46e1e9662fb 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPGPUConfig.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPGPUConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPGPUConfig describes type and count of GPUs attached to the instance on GCP.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public GCPGPUConfig(Integer count, String type) {
         this.type = type;
     }
 
+    /**
+     * Count is the number of GPUs to be attached to an instance.
+     */
     @JsonProperty("count")
     public Integer getCount() {
         return count;
     }
 
+    /**
+     * Count is the number of GPUs to be attached to an instance.
+     */
     @JsonProperty("count")
     public void setCount(Integer count) {
         this.count = count;
     }
 
+    /**
+     * Type is the type of GPU to be attached to an instance. Supported GPU types are: nvidia-tesla-k80, nvidia-tesla-p100, nvidia-tesla-v100, nvidia-tesla-p4, nvidia-tesla-t4
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of GPU to be attached to an instance. Supported GPU types are: nvidia-tesla-k80, nvidia-tesla-p100, nvidia-tesla-v100, nvidia-tesla-p4, nvidia-tesla-t4
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPKMSKeyReference.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPKMSKeyReference.java
index b07f2907919..bcca6acda42 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPKMSKeyReference.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPKMSKeyReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPKMSKeyReference gathers required fields for looking up a GCP KMS Key
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public GCPKMSKeyReference(String keyRing, String location, String name, String p
         this.projectID = projectID;
     }
 
+    /**
+     * KeyRing is the name of the KMS Key Ring which the KMS Key belongs to.
+     */
     @JsonProperty("keyRing")
     public String getKeyRing() {
         return keyRing;
     }
 
+    /**
+     * KeyRing is the name of the KMS Key Ring which the KMS Key belongs to.
+     */
     @JsonProperty("keyRing")
     public void setKeyRing(String keyRing) {
         this.keyRing = keyRing;
     }
 
+    /**
+     * Location is the GCP location in which the Key Ring exists.
+     */
     @JsonProperty("location")
     public String getLocation() {
         return location;
     }
 
+    /**
+     * Location is the GCP location in which the Key Ring exists.
+     */
     @JsonProperty("location")
     public void setLocation(String location) {
         this.location = location;
     }
 
+    /**
+     * Name is the name of the customer managed encryption key to be used for the disk encryption.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the customer managed encryption key to be used for the disk encryption.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * ProjectID is the ID of the Project in which the KMS Key Ring exists. Defaults to the VM ProjectID if not set.
+     */
     @JsonProperty("projectID")
     public String getProjectID() {
         return projectID;
     }
 
+    /**
+     * ProjectID is the ID of the Project in which the KMS Key Ring exists. Defaults to the VM ProjectID if not set.
+     */
     @JsonProperty("projectID")
     public void setProjectID(String projectID) {
         this.projectID = projectID;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPMachineProviderSpec.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPMachineProviderSpec.java
index 65f30a41eeb..fccded27352 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPMachineProviderSpec.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPMachineProviderSpec.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an GCP virtual machine. It is used by the GCP machine actuator to create a single Machine. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,9 +101,6 @@
 public class GCPMachineProviderSpec implements Editable<GCPMachineProviderSpecBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machine.openshift.io/v1beta1";
     @JsonProperty("canIPForward")
@@ -120,9 +120,6 @@ public class GCPMachineProviderSpec implements Editable<GCPMachineProviderSpecBu
     @JsonProperty("gpus")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<GCPGPUConfig> gpus = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GCPMachineProviderSpec";
     @JsonProperty("labels")
@@ -202,7 +199,7 @@ public GCPMachineProviderSpec(String apiVersion, Boolean canIPForward, String co
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -210,88 +207,130 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * CanIPForward Allows this instance to send and receive packets with non-matching destination or source IPs. This is required if you plan to use this instance to forward routes.
+     */
     @JsonProperty("canIPForward")
     public Boolean getCanIPForward() {
         return canIPForward;
     }
 
+    /**
+     * CanIPForward Allows this instance to send and receive packets with non-matching destination or source IPs. This is required if you plan to use this instance to forward routes.
+     */
     @JsonProperty("canIPForward")
     public void setCanIPForward(Boolean canIPForward) {
         this.canIPForward = canIPForward;
     }
 
+    /**
+     * confidentialCompute Defines whether the instance should have confidential compute enabled. If enabled OnHostMaintenance is required to be set to "Terminate". If omitted, the platform chooses a default, which is subject to change over time, currently that default is false.
+     */
     @JsonProperty("confidentialCompute")
     public String getConfidentialCompute() {
         return confidentialCompute;
     }
 
+    /**
+     * confidentialCompute Defines whether the instance should have confidential compute enabled. If enabled OnHostMaintenance is required to be set to "Terminate". If omitted, the platform chooses a default, which is subject to change over time, currently that default is false.
+     */
     @JsonProperty("confidentialCompute")
     public void setConfidentialCompute(String confidentialCompute) {
         this.confidentialCompute = confidentialCompute;
     }
 
+    /**
+     * GCPMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an GCP virtual machine. It is used by the GCP machine actuator to create a single Machine. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("credentialsSecret")
     public LocalObjectReference getCredentialsSecret() {
         return credentialsSecret;
     }
 
+    /**
+     * GCPMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an GCP virtual machine. It is used by the GCP machine actuator to create a single Machine. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("credentialsSecret")
     public void setCredentialsSecret(LocalObjectReference credentialsSecret) {
         this.credentialsSecret = credentialsSecret;
     }
 
+    /**
+     * DeletionProtection whether the resource should be protected against deletion.
+     */
     @JsonProperty("deletionProtection")
     public Boolean getDeletionProtection() {
         return deletionProtection;
     }
 
+    /**
+     * DeletionProtection whether the resource should be protected against deletion.
+     */
     @JsonProperty("deletionProtection")
     public void setDeletionProtection(Boolean deletionProtection) {
         this.deletionProtection = deletionProtection;
     }
 
+    /**
+     * Disks is a list of disks to be attached to the VM.
+     */
     @JsonProperty("disks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GCPDisk> getDisks() {
         return disks;
     }
 
+    /**
+     * Disks is a list of disks to be attached to the VM.
+     */
     @JsonProperty("disks")
     public void setDisks(List<GCPDisk> disks) {
         this.disks = disks;
     }
 
+    /**
+     * Metadata key/value pairs to apply to the VM.
+     */
     @JsonProperty("gcpMetadata")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GCPMetadata> getGcpMetadata() {
         return gcpMetadata;
     }
 
+    /**
+     * Metadata key/value pairs to apply to the VM.
+     */
     @JsonProperty("gcpMetadata")
     public void setGcpMetadata(List<GCPMetadata> gcpMetadata) {
         this.gcpMetadata = gcpMetadata;
     }
 
+    /**
+     * GPUs is a list of GPUs to be attached to the VM.
+     */
     @JsonProperty("gpus")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GCPGPUConfig> getGpus() {
         return gpus;
     }
 
+    /**
+     * GPUs is a list of GPUs to be attached to the VM.
+     */
     @JsonProperty("gpus")
     public void setGpus(List<GCPGPUConfig> gpus) {
         this.gpus = gpus;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -299,174 +338,270 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Labels list of labels to apply to the VM.
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabels() {
         return labels;
     }
 
+    /**
+     * Labels list of labels to apply to the VM.
+     */
     @JsonProperty("labels")
     public void setLabels(Map<String, String> labels) {
         this.labels = labels;
     }
 
+    /**
+     * MachineType is the machine type to use for the VM.
+     */
     @JsonProperty("machineType")
     public String getMachineType() {
         return machineType;
     }
 
+    /**
+     * MachineType is the machine type to use for the VM.
+     */
     @JsonProperty("machineType")
     public void setMachineType(String machineType) {
         this.machineType = machineType;
     }
 
+    /**
+     * GCPMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an GCP virtual machine. It is used by the GCP machine actuator to create a single Machine. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * GCPMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an GCP virtual machine. It is used by the GCP machine actuator to create a single Machine. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * NetworkInterfaces is a list of network interfaces to be attached to the VM.
+     */
     @JsonProperty("networkInterfaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GCPNetworkInterface> getNetworkInterfaces() {
         return networkInterfaces;
     }
 
+    /**
+     * NetworkInterfaces is a list of network interfaces to be attached to the VM.
+     */
     @JsonProperty("networkInterfaces")
     public void setNetworkInterfaces(List<GCPNetworkInterface> networkInterfaces) {
         this.networkInterfaces = networkInterfaces;
     }
 
+    /**
+     * OnHostMaintenance determines the behavior when a maintenance event occurs that might cause the instance to reboot. This is required to be set to "Terminate" if you want to provision machine with attached GPUs. Otherwise, allowed values are "Migrate" and "Terminate". If omitted, the platform chooses a default, which is subject to change over time, currently that default is "Migrate".
+     */
     @JsonProperty("onHostMaintenance")
     public String getOnHostMaintenance() {
         return onHostMaintenance;
     }
 
+    /**
+     * OnHostMaintenance determines the behavior when a maintenance event occurs that might cause the instance to reboot. This is required to be set to "Terminate" if you want to provision machine with attached GPUs. Otherwise, allowed values are "Migrate" and "Terminate". If omitted, the platform chooses a default, which is subject to change over time, currently that default is "Migrate".
+     */
     @JsonProperty("onHostMaintenance")
     public void setOnHostMaintenance(String onHostMaintenance) {
         this.onHostMaintenance = onHostMaintenance;
     }
 
+    /**
+     * Preemptible indicates if created instance is preemptible.
+     */
     @JsonProperty("preemptible")
     public Boolean getPreemptible() {
         return preemptible;
     }
 
+    /**
+     * Preemptible indicates if created instance is preemptible.
+     */
     @JsonProperty("preemptible")
     public void setPreemptible(Boolean preemptible) {
         this.preemptible = preemptible;
     }
 
+    /**
+     * ProjectID is the project in which the GCP machine provider will create the VM.
+     */
     @JsonProperty("projectID")
     public String getProjectID() {
         return projectID;
     }
 
+    /**
+     * ProjectID is the project in which the GCP machine provider will create the VM.
+     */
     @JsonProperty("projectID")
     public void setProjectID(String projectID) {
         this.projectID = projectID;
     }
 
+    /**
+     * Region is the region in which the GCP machine provider will create the VM.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Region is the region in which the GCP machine provider will create the VM.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * resourceManagerTags is an optional list of tags to apply to the GCP resources created for the cluster. See https://cloud.google.com/resource-manager/docs/tags/tags-overview for information on tagging GCP resources. GCP supports a maximum of 50 tags per resource.
+     */
     @JsonProperty("resourceManagerTags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ResourceManagerTag> getResourceManagerTags() {
         return resourceManagerTags;
     }
 
+    /**
+     * resourceManagerTags is an optional list of tags to apply to the GCP resources created for the cluster. See https://cloud.google.com/resource-manager/docs/tags/tags-overview for information on tagging GCP resources. GCP supports a maximum of 50 tags per resource.
+     */
     @JsonProperty("resourceManagerTags")
     public void setResourceManagerTags(List<ResourceManagerTag> resourceManagerTags) {
         this.resourceManagerTags = resourceManagerTags;
     }
 
+    /**
+     * RestartPolicy determines the behavior when an instance crashes or the underlying infrastructure provider stops the instance as part of a maintenance event (default "Always"). Cannot be "Always" with preemptible instances. Otherwise, allowed values are "Always" and "Never". If omitted, the platform chooses a default, which is subject to change over time, currently that default is "Always". RestartPolicy represents AutomaticRestart in GCP compute api
+     */
     @JsonProperty("restartPolicy")
     public String getRestartPolicy() {
         return restartPolicy;
     }
 
+    /**
+     * RestartPolicy determines the behavior when an instance crashes or the underlying infrastructure provider stops the instance as part of a maintenance event (default "Always"). Cannot be "Always" with preemptible instances. Otherwise, allowed values are "Always" and "Never". If omitted, the platform chooses a default, which is subject to change over time, currently that default is "Always". RestartPolicy represents AutomaticRestart in GCP compute api
+     */
     @JsonProperty("restartPolicy")
     public void setRestartPolicy(String restartPolicy) {
         this.restartPolicy = restartPolicy;
     }
 
+    /**
+     * ServiceAccounts is a list of GCP service accounts to be used by the VM.
+     */
     @JsonProperty("serviceAccounts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GCPServiceAccount> getServiceAccounts() {
         return serviceAccounts;
     }
 
+    /**
+     * ServiceAccounts is a list of GCP service accounts to be used by the VM.
+     */
     @JsonProperty("serviceAccounts")
     public void setServiceAccounts(List<GCPServiceAccount> serviceAccounts) {
         this.serviceAccounts = serviceAccounts;
     }
 
+    /**
+     * GCPMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an GCP virtual machine. It is used by the GCP machine actuator to create a single Machine. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("shieldedInstanceConfig")
     public GCPShieldedInstanceConfig getShieldedInstanceConfig() {
         return shieldedInstanceConfig;
     }
 
+    /**
+     * GCPMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an GCP virtual machine. It is used by the GCP machine actuator to create a single Machine. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("shieldedInstanceConfig")
     public void setShieldedInstanceConfig(GCPShieldedInstanceConfig shieldedInstanceConfig) {
         this.shieldedInstanceConfig = shieldedInstanceConfig;
     }
 
+    /**
+     * Tags list of network tags to apply to the VM.
+     */
     @JsonProperty("tags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getTags() {
         return tags;
     }
 
+    /**
+     * Tags list of network tags to apply to the VM.
+     */
     @JsonProperty("tags")
     public void setTags(List<String> tags) {
         this.tags = tags;
     }
 
+    /**
+     * TargetPools are used for network TCP/UDP load balancing. A target pool references member instances, an associated legacy HttpHealthCheck resource, and, optionally, a backup target pool
+     */
     @JsonProperty("targetPools")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getTargetPools() {
         return targetPools;
     }
 
+    /**
+     * TargetPools are used for network TCP/UDP load balancing. A target pool references member instances, an associated legacy HttpHealthCheck resource, and, optionally, a backup target pool
+     */
     @JsonProperty("targetPools")
     public void setTargetPools(List<String> targetPools) {
         this.targetPools = targetPools;
     }
 
+    /**
+     * GCPMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an GCP virtual machine. It is used by the GCP machine actuator to create a single Machine. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("userDataSecret")
     public LocalObjectReference getUserDataSecret() {
         return userDataSecret;
     }
 
+    /**
+     * GCPMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an GCP virtual machine. It is used by the GCP machine actuator to create a single Machine. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("userDataSecret")
     public void setUserDataSecret(LocalObjectReference userDataSecret) {
         this.userDataSecret = userDataSecret;
     }
 
+    /**
+     * Zone is the zone in which the GCP machine provider will create the VM.
+     */
     @JsonProperty("zone")
     public String getZone() {
         return zone;
     }
 
+    /**
+     * Zone is the zone in which the GCP machine provider will create the VM.
+     */
     @JsonProperty("zone")
     public void setZone(String zone) {
         this.zone = zone;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPMachineProviderStatus.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPMachineProviderStatus.java
index ce03addf613..2262751386c 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPMachineProviderStatus.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPMachineProviderStatus.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPMachineProviderStatus is the type that will be embedded in a Machine.Status.ProviderStatus field. It contains GCP-specific status information. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -80,9 +83,6 @@
 public class GCPMachineProviderStatus implements Editable<GCPMachineProviderStatusBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machine.openshift.io/v1beta1";
     @JsonProperty("conditions")
@@ -92,9 +92,6 @@ public class GCPMachineProviderStatus implements Editable<GCPMachineProviderStat
     private String instanceId;
     @JsonProperty("instanceState")
     private String instanceState;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GCPMachineProviderStatus";
     @JsonProperty("metadata")
@@ -119,7 +116,7 @@ public GCPMachineProviderStatus(String apiVersion, List<Condition> conditions, S
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -127,46 +124,64 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Conditions is a set of conditions associated with the Machine to indicate errors or other status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions is a set of conditions associated with the Machine to indicate errors or other status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * InstanceID is the ID of the instance in GCP
+     */
     @JsonProperty("instanceId")
     public String getInstanceId() {
         return instanceId;
     }
 
+    /**
+     * InstanceID is the ID of the instance in GCP
+     */
     @JsonProperty("instanceId")
     public void setInstanceId(String instanceId) {
         this.instanceId = instanceId;
     }
 
+    /**
+     * InstanceState is the provisioning state of the GCP Instance.
+     */
     @JsonProperty("instanceState")
     public String getInstanceState() {
         return instanceState;
     }
 
+    /**
+     * InstanceState is the provisioning state of the GCP Instance.
+     */
     @JsonProperty("instanceState")
     public void setInstanceState(String instanceState) {
         this.instanceState = instanceState;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -174,18 +189,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * GCPMachineProviderStatus is the type that will be embedded in a Machine.Status.ProviderStatus field. It contains GCP-specific status information. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * GCPMachineProviderStatus is the type that will be embedded in a Machine.Status.ProviderStatus field. It contains GCP-specific status information. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPMetadata.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPMetadata.java
index 2e2aa655af7..080e184634e 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPMetadata.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPMetadata.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPMetadata describes metadata for GCP.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public GCPMetadata(String key, String value) {
         this.value = value;
     }
 
+    /**
+     * Key is the metadata key.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * Key is the metadata key.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * Value is the metadata value.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is the metadata value.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPNetworkInterface.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPNetworkInterface.java
index b315f2f3d41..4e7bcc1d2f5 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPNetworkInterface.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPNetworkInterface.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPNetworkInterface describes network interfaces for GCP
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public GCPNetworkInterface(String network, String projectID, Boolean publicIP, S
         this.subnetwork = subnetwork;
     }
 
+    /**
+     * Network is the network name.
+     */
     @JsonProperty("network")
     public String getNetwork() {
         return network;
     }
 
+    /**
+     * Network is the network name.
+     */
     @JsonProperty("network")
     public void setNetwork(String network) {
         this.network = network;
     }
 
+    /**
+     * ProjectID is the project in which the GCP machine provider will create the VM.
+     */
     @JsonProperty("projectID")
     public String getProjectID() {
         return projectID;
     }
 
+    /**
+     * ProjectID is the project in which the GCP machine provider will create the VM.
+     */
     @JsonProperty("projectID")
     public void setProjectID(String projectID) {
         this.projectID = projectID;
     }
 
+    /**
+     * PublicIP indicates if true a public IP will be used
+     */
     @JsonProperty("publicIP")
     public Boolean getPublicIP() {
         return publicIP;
     }
 
+    /**
+     * PublicIP indicates if true a public IP will be used
+     */
     @JsonProperty("publicIP")
     public void setPublicIP(Boolean publicIP) {
         this.publicIP = publicIP;
     }
 
+    /**
+     * Subnetwork is the subnetwork name.
+     */
     @JsonProperty("subnetwork")
     public String getSubnetwork() {
         return subnetwork;
     }
 
+    /**
+     * Subnetwork is the subnetwork name.
+     */
     @JsonProperty("subnetwork")
     public void setSubnetwork(String subnetwork) {
         this.subnetwork = subnetwork;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPServiceAccount.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPServiceAccount.java
index 9d815309e30..2c09730975c 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPServiceAccount.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPServiceAccount.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPServiceAccount describes service accounts for GCP.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public GCPServiceAccount(String email, List<String> scopes) {
         this.scopes = scopes;
     }
 
+    /**
+     * Email is the service account email.
+     */
     @JsonProperty("email")
     public String getEmail() {
         return email;
     }
 
+    /**
+     * Email is the service account email.
+     */
     @JsonProperty("email")
     public void setEmail(String email) {
         this.email = email;
     }
 
+    /**
+     * Scopes list of scopes to be assigned to the service account.
+     */
     @JsonProperty("scopes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getScopes() {
         return scopes;
     }
 
+    /**
+     * Scopes list of scopes to be assigned to the service account.
+     */
     @JsonProperty("scopes")
     public void setScopes(List<String> scopes) {
         this.scopes = scopes;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPShieldedInstanceConfig.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPShieldedInstanceConfig.java
index 53162959eca..86328183e3c 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPShieldedInstanceConfig.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/GCPShieldedInstanceConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPShieldedInstanceConfig describes the shielded VM configuration of the instance on GCP. Shielded VM configuration allow users to enable and disable Secure Boot, vTPM, and Integrity Monitoring.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public GCPShieldedInstanceConfig(String integrityMonitoring, String secureBoot,
         this.virtualizedTrustedPlatformModule = virtualizedTrustedPlatformModule;
     }
 
+    /**
+     * IntegrityMonitoring determines whether the instance should have integrity monitoring that verify the runtime boot integrity. Compares the most recent boot measurements to the integrity policy baseline and return a pair of pass/fail results depending on whether they match or not. If omitted, the platform chooses a default, which is subject to change over time, currently that default is Enabled.
+     */
     @JsonProperty("integrityMonitoring")
     public String getIntegrityMonitoring() {
         return integrityMonitoring;
     }
 
+    /**
+     * IntegrityMonitoring determines whether the instance should have integrity monitoring that verify the runtime boot integrity. Compares the most recent boot measurements to the integrity policy baseline and return a pair of pass/fail results depending on whether they match or not. If omitted, the platform chooses a default, which is subject to change over time, currently that default is Enabled.
+     */
     @JsonProperty("integrityMonitoring")
     public void setIntegrityMonitoring(String integrityMonitoring) {
         this.integrityMonitoring = integrityMonitoring;
     }
 
+    /**
+     * SecureBoot Defines whether the instance should have secure boot enabled. Secure Boot verify the digital signature of all boot components, and halting the boot process if signature verification fails. If omitted, the platform chooses a default, which is subject to change over time, currently that default is Disabled.
+     */
     @JsonProperty("secureBoot")
     public String getSecureBoot() {
         return secureBoot;
     }
 
+    /**
+     * SecureBoot Defines whether the instance should have secure boot enabled. Secure Boot verify the digital signature of all boot components, and halting the boot process if signature verification fails. If omitted, the platform chooses a default, which is subject to change over time, currently that default is Disabled.
+     */
     @JsonProperty("secureBoot")
     public void setSecureBoot(String secureBoot) {
         this.secureBoot = secureBoot;
     }
 
+    /**
+     * VirtualizedTrustedPlatformModule enable virtualized trusted platform module measurements to create a known good boot integrity policy baseline. The integrity policy baseline is used for comparison with measurements from subsequent VM boots to determine if anything has changed. This is required to be set to "Enabled" if IntegrityMonitoring is enabled. If omitted, the platform chooses a default, which is subject to change over time, currently that default is Enabled.
+     */
     @JsonProperty("virtualizedTrustedPlatformModule")
     public String getVirtualizedTrustedPlatformModule() {
         return virtualizedTrustedPlatformModule;
     }
 
+    /**
+     * VirtualizedTrustedPlatformModule enable virtualized trusted platform module measurements to create a known good boot integrity policy baseline. The integrity policy baseline is used for comparison with measurements from subsequent VM boots to determine if anything has changed. This is required to be set to "Enabled" if IntegrityMonitoring is enabled. If omitted, the platform chooses a default, which is subject to change over time, currently that default is Enabled.
+     */
     @JsonProperty("virtualizedTrustedPlatformModule")
     public void setVirtualizedTrustedPlatformModule(String virtualizedTrustedPlatformModule) {
         this.virtualizedTrustedPlatformModule = virtualizedTrustedPlatformModule;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/Image.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/Image.java
index 789c55ff40b..875ad89a951 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/Image.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/Image.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Image is a mirror of azure sdk compute.ImageReference
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public Image(String offer, String publisher, String resourceID, String sku, Stri
         this.version = version;
     }
 
+    /**
+     * Offer specifies the name of a group of related images created by the publisher. For example, UbuntuServer, WindowsServer
+     */
     @JsonProperty("offer")
     public String getOffer() {
         return offer;
     }
 
+    /**
+     * Offer specifies the name of a group of related images created by the publisher. For example, UbuntuServer, WindowsServer
+     */
     @JsonProperty("offer")
     public void setOffer(String offer) {
         this.offer = offer;
     }
 
+    /**
+     * Publisher is the name of the organization that created the image
+     */
     @JsonProperty("publisher")
     public String getPublisher() {
         return publisher;
     }
 
+    /**
+     * Publisher is the name of the organization that created the image
+     */
     @JsonProperty("publisher")
     public void setPublisher(String publisher) {
         this.publisher = publisher;
     }
 
+    /**
+     * ResourceID specifies an image to use by ID
+     */
     @JsonProperty("resourceID")
     public String getResourceID() {
         return resourceID;
     }
 
+    /**
+     * ResourceID specifies an image to use by ID
+     */
     @JsonProperty("resourceID")
     public void setResourceID(String resourceID) {
         this.resourceID = resourceID;
     }
 
+    /**
+     * SKU specifies an instance of an offer, such as a major release of a distribution. For example, 18.04-LTS, 2019-Datacenter
+     */
     @JsonProperty("sku")
     public String getSku() {
         return sku;
     }
 
+    /**
+     * SKU specifies an instance of an offer, such as a major release of a distribution. For example, 18.04-LTS, 2019-Datacenter
+     */
     @JsonProperty("sku")
     public void setSku(String sku) {
         this.sku = sku;
     }
 
+    /**
+     * Type identifies the source of the image and related information, such as purchase plans. Valid values are "ID", "MarketplaceWithPlan", "MarketplaceNoPlan", and omitted, which means no opinion and the platform chooses a good default which may change over time. Currently that default is "MarketplaceNoPlan" if publisher data is supplied, or "ID" if not. For more information about purchase plans, see: https://docs.microsoft.com/en-us/azure/virtual-machines/linux/cli-ps-findimage#check-the-purchase-plan-information
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type identifies the source of the image and related information, such as purchase plans. Valid values are "ID", "MarketplaceWithPlan", "MarketplaceNoPlan", and omitted, which means no opinion and the platform chooses a good default which may change over time. Currently that default is "MarketplaceNoPlan" if publisher data is supplied, or "ID" if not. For more information about purchase plans, see: https://docs.microsoft.com/en-us/azure/virtual-machines/linux/cli-ps-findimage#check-the-purchase-plan-information
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * Version specifies the version of an image sku. The allowed formats are Major.Minor.Build or 'latest'. Major, Minor, and Build are decimal numbers. Specify 'latest' to use the latest version of an image available at deploy time. Even if you use 'latest', the VM image will not automatically update after deploy time even if a new version becomes available.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * Version specifies the version of an image sku. The allowed formats are Major.Minor.Build or 'latest'. Major, Minor, and Build are decimal numbers. Specify 'latest' to use the latest version of an image available at deploy time. Even if you use 'latest', the VM image will not automatically update after deploy time even if a new version becomes available.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/LastOperation.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/LastOperation.java
index ff34ef530b0..440dc0b5cb3 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/LastOperation.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/LastOperation.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LastOperation represents the detail of the last performed operation on the MachineObject.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public LastOperation(String description, String lastUpdated, String state, Strin
         this.type = type;
     }
 
+    /**
+     * Description is the human-readable description of the last operation.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is the human-readable description of the last operation.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * LastOperation represents the detail of the last performed operation on the MachineObject.
+     */
     @JsonProperty("lastUpdated")
     public String getLastUpdated() {
         return lastUpdated;
     }
 
+    /**
+     * LastOperation represents the detail of the last performed operation on the MachineObject.
+     */
     @JsonProperty("lastUpdated")
     public void setLastUpdated(String lastUpdated) {
         this.lastUpdated = lastUpdated;
     }
 
+    /**
+     * State is the current status of the last performed operation. E.g. Processing, Failed, Successful etc
+     */
     @JsonProperty("state")
     public String getState() {
         return state;
     }
 
+    /**
+     * State is the current status of the last performed operation. E.g. Processing, Failed, Successful etc
+     */
     @JsonProperty("state")
     public void setState(String state) {
         this.state = state;
     }
 
+    /**
+     * Type is the type of operation which was last performed. E.g. Create, Delete, Update etc
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of operation which was last performed. E.g. Create, Delete, Update etc
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/LifecycleHook.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/LifecycleHook.java
index b594b00a6f3..b784d709a6d 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/LifecycleHook.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/LifecycleHook.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LifecycleHook represents a single instance of a lifecycle hook
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public LifecycleHook(String name, String owner) {
         this.owner = owner;
     }
 
+    /**
+     * Name defines a unique name for the lifcycle hook. The name should be unique and descriptive, ideally 1-3 words, in CamelCase or it may be namespaced, eg. foo.example.com/CamelCase. Names must be unique and should only be managed by a single entity.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name defines a unique name for the lifcycle hook. The name should be unique and descriptive, ideally 1-3 words, in CamelCase or it may be namespaced, eg. foo.example.com/CamelCase. Names must be unique and should only be managed by a single entity.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Owner defines the owner of the lifecycle hook. This should be descriptive enough so that users can identify who/what is responsible for blocking the lifecycle. This could be the name of a controller (e.g. clusteroperator/etcd) or an administrator managing the hook.
+     */
     @JsonProperty("owner")
     public String getOwner() {
         return owner;
     }
 
+    /**
+     * Owner defines the owner of the lifecycle hook. This should be descriptive enough so that users can identify who/what is responsible for blocking the lifecycle. This could be the name of a controller (e.g. clusteroperator/etcd) or an administrator managing the hook.
+     */
     @JsonProperty("owner")
     public void setOwner(String owner) {
         this.owner = owner;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/LifecycleHooks.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/LifecycleHooks.java
index b7d9d6e28e6..af91c94c335 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/LifecycleHooks.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/LifecycleHooks.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LifecycleHooks allow users to pause operations on the machine at certain prefedined points within the machine lifecycle.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public LifecycleHooks(List<LifecycleHook> preDrain, List<LifecycleHook> preTermi
         this.preTerminate = preTerminate;
     }
 
+    /**
+     * PreDrain hooks prevent the machine from being drained. This also blocks further lifecycle events, such as termination.
+     */
     @JsonProperty("preDrain")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LifecycleHook> getPreDrain() {
         return preDrain;
     }
 
+    /**
+     * PreDrain hooks prevent the machine from being drained. This also blocks further lifecycle events, such as termination.
+     */
     @JsonProperty("preDrain")
     public void setPreDrain(List<LifecycleHook> preDrain) {
         this.preDrain = preDrain;
     }
 
+    /**
+     * PreTerminate hooks prevent the machine from being terminated. PreTerminate hooks be actioned after the Machine has been drained.
+     */
     @JsonProperty("preTerminate")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LifecycleHook> getPreTerminate() {
         return preTerminate;
     }
 
+    /**
+     * PreTerminate hooks prevent the machine from being terminated. PreTerminate hooks be actioned after the Machine has been drained.
+     */
     @JsonProperty("preTerminate")
     public void setPreTerminate(List<LifecycleHook> preTerminate) {
         this.preTerminate = preTerminate;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/LoadBalancerReference.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/LoadBalancerReference.java
index 423e3f5fa03..9b4085c6c7e 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/LoadBalancerReference.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/LoadBalancerReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LoadBalancerReference is a reference to a load balancer on AWS.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public LoadBalancerReference(String name, String type) {
         this.type = type;
     }
 
+    /**
+     * LoadBalancerReference is a reference to a load balancer on AWS.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * LoadBalancerReference is a reference to a load balancer on AWS.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * LoadBalancerReference is a reference to a load balancer on AWS.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * LoadBalancerReference is a reference to a load balancer on AWS.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/Machine.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/Machine.java
index b425e896294..d4467c21cc7 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/Machine.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/Machine.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Machine is the Schema for the machines API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Machine implements Editable<MachineBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machine.openshift.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Machine";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Machine(String apiVersion, String kind, ObjectMeta metadata, MachineSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Machine is the Schema for the machines API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Machine is the Schema for the machines API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Machine is the Schema for the machines API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public MachineSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Machine is the Schema for the machines API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(MachineSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Machine is the Schema for the machines API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public MachineStatus getStatus() {
         return status;
     }
 
+    /**
+     * Machine is the Schema for the machines API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(MachineStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineHealthCheck.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineHealthCheck.java
index aad59e3b4cc..1c39ed3ffee 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineHealthCheck.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineHealthCheck.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineHealthCheck is the Schema for the machinehealthchecks API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class MachineHealthCheck implements Editable<MachineHealthCheckBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machine.openshift.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MachineHealthCheck";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public MachineHealthCheck(String apiVersion, String kind, ObjectMeta metadata, M
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MachineHealthCheck is the Schema for the machinehealthchecks API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MachineHealthCheck is the Schema for the machinehealthchecks API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * MachineHealthCheck is the Schema for the machinehealthchecks API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public MachineHealthCheckSpec getSpec() {
         return spec;
     }
 
+    /**
+     * MachineHealthCheck is the Schema for the machinehealthchecks API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(MachineHealthCheckSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * MachineHealthCheck is the Schema for the machinehealthchecks API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public MachineHealthCheckStatus getStatus() {
         return status;
     }
 
+    /**
+     * MachineHealthCheck is the Schema for the machinehealthchecks API Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(MachineHealthCheckStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineHealthCheckList.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineHealthCheckList.java
index 8268f685401..6658a60df8a 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineHealthCheckList.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineHealthCheckList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineHealthCheckList contains a list of MachineHealthCheck Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class MachineHealthCheckList implements Editable<MachineHealthCheckListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.machine.v1beta1.MachineHealthCheck>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machine.openshift.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.machine.v1beta1.MachineHealthCheck> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MachineHealthCheckList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public MachineHealthCheckList(String apiVersion, List<io.fabric8.openshift.api.m
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * MachineHealthCheckList contains a list of MachineHealthCheck Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.machine.v1beta1.MachineHealthCheck> getItems() {
         return items;
     }
 
+    /**
+     * MachineHealthCheckList contains a list of MachineHealthCheck Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.machine.v1beta1.MachineHealthCheck> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MachineHealthCheckList contains a list of MachineHealthCheck Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MachineHealthCheckList contains a list of MachineHealthCheck Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineHealthCheckSpec.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineHealthCheckSpec.java
index a3e1c5d778e..44cd1de179e 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineHealthCheckSpec.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineHealthCheckSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineHealthCheckSpec defines the desired state of MachineHealthCheck
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -97,52 +100,82 @@ public MachineHealthCheckSpec(IntOrString maxUnhealthy, String nodeStartupTimeou
         this.unhealthyConditions = unhealthyConditions;
     }
 
+    /**
+     * MachineHealthCheckSpec defines the desired state of MachineHealthCheck
+     */
     @JsonProperty("maxUnhealthy")
     public IntOrString getMaxUnhealthy() {
         return maxUnhealthy;
     }
 
+    /**
+     * MachineHealthCheckSpec defines the desired state of MachineHealthCheck
+     */
     @JsonProperty("maxUnhealthy")
     public void setMaxUnhealthy(IntOrString maxUnhealthy) {
         this.maxUnhealthy = maxUnhealthy;
     }
 
+    /**
+     * MachineHealthCheckSpec defines the desired state of MachineHealthCheck
+     */
     @JsonProperty("nodeStartupTimeout")
     public String getNodeStartupTimeout() {
         return nodeStartupTimeout;
     }
 
+    /**
+     * MachineHealthCheckSpec defines the desired state of MachineHealthCheck
+     */
     @JsonProperty("nodeStartupTimeout")
     public void setNodeStartupTimeout(String nodeStartupTimeout) {
         this.nodeStartupTimeout = nodeStartupTimeout;
     }
 
+    /**
+     * MachineHealthCheckSpec defines the desired state of MachineHealthCheck
+     */
     @JsonProperty("remediationTemplate")
     public ObjectReference getRemediationTemplate() {
         return remediationTemplate;
     }
 
+    /**
+     * MachineHealthCheckSpec defines the desired state of MachineHealthCheck
+     */
     @JsonProperty("remediationTemplate")
     public void setRemediationTemplate(ObjectReference remediationTemplate) {
         this.remediationTemplate = remediationTemplate;
     }
 
+    /**
+     * MachineHealthCheckSpec defines the desired state of MachineHealthCheck
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * MachineHealthCheckSpec defines the desired state of MachineHealthCheck
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * UnhealthyConditions contains a list of the conditions that determine whether a node is considered unhealthy.  The conditions are combined in a logical OR, i.e. if any of the conditions is met, the node is unhealthy.
+     */
     @JsonProperty("unhealthyConditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<UnhealthyCondition> getUnhealthyConditions() {
         return unhealthyConditions;
     }
 
+    /**
+     * UnhealthyConditions contains a list of the conditions that determine whether a node is considered unhealthy.  The conditions are combined in a logical OR, i.e. if any of the conditions is met, the node is unhealthy.
+     */
     @JsonProperty("unhealthyConditions")
     public void setUnhealthyConditions(List<UnhealthyCondition> unhealthyConditions) {
         this.unhealthyConditions = unhealthyConditions;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineHealthCheckStatus.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineHealthCheckStatus.java
index 83bb971521b..7372c1d3646 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineHealthCheckStatus.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineHealthCheckStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineHealthCheckStatus defines the observed state of MachineHealthCheck
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public MachineHealthCheckStatus(List<Condition> conditions, Integer currentHealt
         this.remediationsAllowed = remediationsAllowed;
     }
 
+    /**
+     * Conditions defines the current state of the MachineHealthCheck
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions defines the current state of the MachineHealthCheck
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * total number of machines counted by this machine health check
+     */
     @JsonProperty("currentHealthy")
     public Integer getCurrentHealthy() {
         return currentHealthy;
     }
 
+    /**
+     * total number of machines counted by this machine health check
+     */
     @JsonProperty("currentHealthy")
     public void setCurrentHealthy(Integer currentHealthy) {
         this.currentHealthy = currentHealthy;
     }
 
+    /**
+     * total number of machines counted by this machine health check
+     */
     @JsonProperty("expectedMachines")
     public Integer getExpectedMachines() {
         return expectedMachines;
     }
 
+    /**
+     * total number of machines counted by this machine health check
+     */
     @JsonProperty("expectedMachines")
     public void setExpectedMachines(Integer expectedMachines) {
         this.expectedMachines = expectedMachines;
     }
 
+    /**
+     * RemediationsAllowed is the number of further remediations allowed by this machine health check before maxUnhealthy short circuiting will be applied
+     */
     @JsonProperty("remediationsAllowed")
     public Integer getRemediationsAllowed() {
         return remediationsAllowed;
     }
 
+    /**
+     * RemediationsAllowed is the number of further remediations allowed by this machine health check before maxUnhealthy short circuiting will be applied
+     */
     @JsonProperty("remediationsAllowed")
     public void setRemediationsAllowed(Integer remediationsAllowed) {
         this.remediationsAllowed = remediationsAllowed;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineList.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineList.java
index 362488343a1..9f71c909171 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineList.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineList contains a list of Machine Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class MachineList implements Editable<MachineListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.machine.v1beta1.Machine>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machine.openshift.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.machine.v1beta1.Machine> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MachineList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public MachineList(String apiVersion, List<io.fabric8.openshift.api.model.machin
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * MachineList contains a list of Machine Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.machine.v1beta1.Machine> getItems() {
         return items;
     }
 
+    /**
+     * MachineList contains a list of Machine Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.machine.v1beta1.Machine> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MachineList contains a list of Machine Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MachineList contains a list of Machine Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineSet.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineSet.java
index be2715e5ca9..b1288506fd0 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineSet.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineSet.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineSet ensures that a specified number of machines replicas are running at any given time. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class MachineSet implements Editable<MachineSetBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machine.openshift.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MachineSet";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public MachineSet(String apiVersion, String kind, ObjectMeta metadata, MachineSe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MachineSet ensures that a specified number of machines replicas are running at any given time. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MachineSet ensures that a specified number of machines replicas are running at any given time. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * MachineSet ensures that a specified number of machines replicas are running at any given time. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public MachineSetSpec getSpec() {
         return spec;
     }
 
+    /**
+     * MachineSet ensures that a specified number of machines replicas are running at any given time. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(MachineSetSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * MachineSet ensures that a specified number of machines replicas are running at any given time. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public MachineSetStatus getStatus() {
         return status;
     }
 
+    /**
+     * MachineSet ensures that a specified number of machines replicas are running at any given time. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(MachineSetStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineSetList.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineSetList.java
index 59ce818e325..a70b9ad4e1f 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineSetList.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineSetList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineSetList contains a list of MachineSet Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class MachineSetList implements Editable<MachineSetListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.machine.v1beta1.MachineSet>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machine.openshift.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.machine.v1beta1.MachineSet> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MachineSetList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public MachineSetList(String apiVersion, List<io.fabric8.openshift.api.model.mac
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * MachineSetList contains a list of MachineSet Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.machine.v1beta1.MachineSet> getItems() {
         return items;
     }
 
+    /**
+     * MachineSetList contains a list of MachineSet Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.machine.v1beta1.MachineSet> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MachineSetList contains a list of MachineSet Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MachineSetList contains a list of MachineSet Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineSetSpec.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineSetSpec.java
index ead62f98a4b..4335e8bb2a5 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineSetSpec.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineSetSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineSetSpec defines the desired state of MachineSet
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public MachineSetSpec(String authoritativeAPI, String deletePolicy, Integer minR
         this.template = template;
     }
 
+    /**
+     * authoritativeAPI is the API that is authoritative for this resource. Valid values are MachineAPI and ClusterAPI. When set to MachineAPI, writes to the spec of the machine.openshift.io copy of this resource will be reflected into the cluster.x-k8s.io copy. When set to ClusterAPI, writes to the spec of the cluster.x-k8s.io copy of this resource will be reflected into the machine.openshift.io copy. Updates to the status will be reflected in both copies of the resource, based on the controller implementing the functionality of the API. Currently the authoritative API determines which controller will manage the resource, this will change in a future release. To ensure the change has been accepted, please verify that the `status.authoritativeAPI` field has been updated to the desired value and that the `Synchronized` condition is present and set to `True`.
+     */
     @JsonProperty("authoritativeAPI")
     public String getAuthoritativeAPI() {
         return authoritativeAPI;
     }
 
+    /**
+     * authoritativeAPI is the API that is authoritative for this resource. Valid values are MachineAPI and ClusterAPI. When set to MachineAPI, writes to the spec of the machine.openshift.io copy of this resource will be reflected into the cluster.x-k8s.io copy. When set to ClusterAPI, writes to the spec of the cluster.x-k8s.io copy of this resource will be reflected into the machine.openshift.io copy. Updates to the status will be reflected in both copies of the resource, based on the controller implementing the functionality of the API. Currently the authoritative API determines which controller will manage the resource, this will change in a future release. To ensure the change has been accepted, please verify that the `status.authoritativeAPI` field has been updated to the desired value and that the `Synchronized` condition is present and set to `True`.
+     */
     @JsonProperty("authoritativeAPI")
     public void setAuthoritativeAPI(String authoritativeAPI) {
         this.authoritativeAPI = authoritativeAPI;
     }
 
+    /**
+     * DeletePolicy defines the policy used to identify nodes to delete when downscaling. Defaults to "Random".  Valid values are "Random, "Newest", "Oldest"
+     */
     @JsonProperty("deletePolicy")
     public String getDeletePolicy() {
         return deletePolicy;
     }
 
+    /**
+     * DeletePolicy defines the policy used to identify nodes to delete when downscaling. Defaults to "Random".  Valid values are "Random, "Newest", "Oldest"
+     */
     @JsonProperty("deletePolicy")
     public void setDeletePolicy(String deletePolicy) {
         this.deletePolicy = deletePolicy;
     }
 
+    /**
+     * MinReadySeconds is the minimum number of seconds for which a newly created machine should be ready. Defaults to 0 (machine will be considered available as soon as it is ready)
+     */
     @JsonProperty("minReadySeconds")
     public Integer getMinReadySeconds() {
         return minReadySeconds;
     }
 
+    /**
+     * MinReadySeconds is the minimum number of seconds for which a newly created machine should be ready. Defaults to 0 (machine will be considered available as soon as it is ready)
+     */
     @JsonProperty("minReadySeconds")
     public void setMinReadySeconds(Integer minReadySeconds) {
         this.minReadySeconds = minReadySeconds;
     }
 
+    /**
+     * Replicas is the number of desired replicas. This is a pointer to distinguish between explicit zero and unspecified. Defaults to 1.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Replicas is the number of desired replicas. This is a pointer to distinguish between explicit zero and unspecified. Defaults to 1.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * MachineSetSpec defines the desired state of MachineSet
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * MachineSetSpec defines the desired state of MachineSet
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * MachineSetSpec defines the desired state of MachineSet
+     */
     @JsonProperty("template")
     public MachineTemplateSpec getTemplate() {
         return template;
     }
 
+    /**
+     * MachineSetSpec defines the desired state of MachineSet
+     */
     @JsonProperty("template")
     public void setTemplate(MachineTemplateSpec template) {
         this.template = template;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineSetStatus.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineSetStatus.java
index 0c4dc40ee18..061aae63787 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineSetStatus.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineSetStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineSetStatus defines the observed state of MachineSet
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -117,102 +120,162 @@ public MachineSetStatus(String authoritativeAPI, Integer availableReplicas, List
         this.synchronizedGeneration = synchronizedGeneration;
     }
 
+    /**
+     * authoritativeAPI is the API that is authoritative for this resource. Valid values are MachineAPI, ClusterAPI and Migrating. This value is updated by the migration controller to reflect the authoritative API. Machine API and Cluster API controllers use this value to determine whether or not to reconcile the resource. When set to Migrating, the migration controller is currently performing the handover of authority from one API to the other.
+     */
     @JsonProperty("authoritativeAPI")
     public String getAuthoritativeAPI() {
         return authoritativeAPI;
     }
 
+    /**
+     * authoritativeAPI is the API that is authoritative for this resource. Valid values are MachineAPI, ClusterAPI and Migrating. This value is updated by the migration controller to reflect the authoritative API. Machine API and Cluster API controllers use this value to determine whether or not to reconcile the resource. When set to Migrating, the migration controller is currently performing the handover of authority from one API to the other.
+     */
     @JsonProperty("authoritativeAPI")
     public void setAuthoritativeAPI(String authoritativeAPI) {
         this.authoritativeAPI = authoritativeAPI;
     }
 
+    /**
+     * The number of available replicas (ready for at least minReadySeconds) for this MachineSet.
+     */
     @JsonProperty("availableReplicas")
     public Integer getAvailableReplicas() {
         return availableReplicas;
     }
 
+    /**
+     * The number of available replicas (ready for at least minReadySeconds) for this MachineSet.
+     */
     @JsonProperty("availableReplicas")
     public void setAvailableReplicas(Integer availableReplicas) {
         this.availableReplicas = availableReplicas;
     }
 
+    /**
+     * Conditions defines the current state of the MachineSet
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions defines the current state of the MachineSet
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * MachineSetStatus defines the observed state of MachineSet
+     */
     @JsonProperty("errorMessage")
     public String getErrorMessage() {
         return errorMessage;
     }
 
+    /**
+     * MachineSetStatus defines the observed state of MachineSet
+     */
     @JsonProperty("errorMessage")
     public void setErrorMessage(String errorMessage) {
         this.errorMessage = errorMessage;
     }
 
+    /**
+     * In the event that there is a terminal problem reconciling the replicas, both ErrorReason and ErrorMessage will be set. ErrorReason will be populated with a succinct value suitable for machine interpretation, while ErrorMessage will contain a more verbose string suitable for logging and human consumption.<br><p> <br><p> These fields should not be set for transitive errors that a controller faces that are expected to be fixed automatically over time (like service outages), but instead indicate that something is fundamentally wrong with the MachineTemplate's spec or the configuration of the machine controller, and that manual intervention is required. Examples of terminal errors would be invalid combinations of settings in the spec, values that are unsupported by the machine controller, or the responsible machine controller itself being critically misconfigured.<br><p> <br><p> Any transient errors that occur during the reconciliation of Machines can be added as events to the MachineSet object and/or logged in the controller's output.
+     */
     @JsonProperty("errorReason")
     public String getErrorReason() {
         return errorReason;
     }
 
+    /**
+     * In the event that there is a terminal problem reconciling the replicas, both ErrorReason and ErrorMessage will be set. ErrorReason will be populated with a succinct value suitable for machine interpretation, while ErrorMessage will contain a more verbose string suitable for logging and human consumption.<br><p> <br><p> These fields should not be set for transitive errors that a controller faces that are expected to be fixed automatically over time (like service outages), but instead indicate that something is fundamentally wrong with the MachineTemplate's spec or the configuration of the machine controller, and that manual intervention is required. Examples of terminal errors would be invalid combinations of settings in the spec, values that are unsupported by the machine controller, or the responsible machine controller itself being critically misconfigured.<br><p> <br><p> Any transient errors that occur during the reconciliation of Machines can be added as events to the MachineSet object and/or logged in the controller's output.
+     */
     @JsonProperty("errorReason")
     public void setErrorReason(String errorReason) {
         this.errorReason = errorReason;
     }
 
+    /**
+     * The number of replicas that have labels matching the labels of the machine template of the MachineSet.
+     */
     @JsonProperty("fullyLabeledReplicas")
     public Integer getFullyLabeledReplicas() {
         return fullyLabeledReplicas;
     }
 
+    /**
+     * The number of replicas that have labels matching the labels of the machine template of the MachineSet.
+     */
     @JsonProperty("fullyLabeledReplicas")
     public void setFullyLabeledReplicas(Integer fullyLabeledReplicas) {
         this.fullyLabeledReplicas = fullyLabeledReplicas;
     }
 
+    /**
+     * ObservedGeneration reflects the generation of the most recently observed MachineSet.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration reflects the generation of the most recently observed MachineSet.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * The number of ready replicas for this MachineSet. A machine is considered ready when the node has been created and is "Ready".
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * The number of ready replicas for this MachineSet. A machine is considered ready when the node has been created and is "Ready".
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * Replicas is the most recently observed number of replicas.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Replicas is the most recently observed number of replicas.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * synchronizedGeneration is the generation of the authoritative resource that the non-authoritative resource is synchronised with. This field is set when the authoritative resource is updated and the sync controller has updated the non-authoritative resource to match.
+     */
     @JsonProperty("synchronizedGeneration")
     public Long getSynchronizedGeneration() {
         return synchronizedGeneration;
     }
 
+    /**
+     * synchronizedGeneration is the generation of the authoritative resource that the non-authoritative resource is synchronised with. This field is set when the authoritative resource is updated and the sync controller has updated the non-authoritative resource to match.
+     */
     @JsonProperty("synchronizedGeneration")
     public void setSynchronizedGeneration(Long synchronizedGeneration) {
         this.synchronizedGeneration = synchronizedGeneration;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineSpec.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineSpec.java
index d699b839fb4..c770fc6f104 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineSpec.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineSpec defines the desired state of Machine
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,62 +105,98 @@ public MachineSpec(String authoritativeAPI, LifecycleHooks lifecycleHooks, Objec
         this.taints = taints;
     }
 
+    /**
+     * authoritativeAPI is the API that is authoritative for this resource. Valid values are MachineAPI and ClusterAPI. When set to MachineAPI, writes to the spec of the machine.openshift.io copy of this resource will be reflected into the cluster.x-k8s.io copy. When set to ClusterAPI, writes to the spec of the cluster.x-k8s.io copy of this resource will be reflected into the machine.openshift.io copy. Updates to the status will be reflected in both copies of the resource, based on the controller implementing the functionality of the API. Currently the authoritative API determines which controller will manage the resource, this will change in a future release. To ensure the change has been accepted, please verify that the `status.authoritativeAPI` field has been updated to the desired value and that the `Synchronized` condition is present and set to `True`.
+     */
     @JsonProperty("authoritativeAPI")
     public String getAuthoritativeAPI() {
         return authoritativeAPI;
     }
 
+    /**
+     * authoritativeAPI is the API that is authoritative for this resource. Valid values are MachineAPI and ClusterAPI. When set to MachineAPI, writes to the spec of the machine.openshift.io copy of this resource will be reflected into the cluster.x-k8s.io copy. When set to ClusterAPI, writes to the spec of the cluster.x-k8s.io copy of this resource will be reflected into the machine.openshift.io copy. Updates to the status will be reflected in both copies of the resource, based on the controller implementing the functionality of the API. Currently the authoritative API determines which controller will manage the resource, this will change in a future release. To ensure the change has been accepted, please verify that the `status.authoritativeAPI` field has been updated to the desired value and that the `Synchronized` condition is present and set to `True`.
+     */
     @JsonProperty("authoritativeAPI")
     public void setAuthoritativeAPI(String authoritativeAPI) {
         this.authoritativeAPI = authoritativeAPI;
     }
 
+    /**
+     * MachineSpec defines the desired state of Machine
+     */
     @JsonProperty("lifecycleHooks")
     public LifecycleHooks getLifecycleHooks() {
         return lifecycleHooks;
     }
 
+    /**
+     * MachineSpec defines the desired state of Machine
+     */
     @JsonProperty("lifecycleHooks")
     public void setLifecycleHooks(LifecycleHooks lifecycleHooks) {
         this.lifecycleHooks = lifecycleHooks;
     }
 
+    /**
+     * MachineSpec defines the desired state of Machine
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MachineSpec defines the desired state of Machine
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ProviderID is the identification ID of the machine provided by the provider. This field must match the provider ID as seen on the node object corresponding to this machine. This field is required by higher level consumers of cluster-api. Example use case is cluster autoscaler with cluster-api as provider. Clean-up logic in the autoscaler compares machines to nodes to find out machines at provider which could not get registered as Kubernetes nodes. With cluster-api as a generic out-of-tree provider for autoscaler, this field is required by autoscaler to be able to have a provider view of the list of machines. Another list of nodes is queried from the k8s apiserver and then a comparison is done to find out unregistered machines and are marked for delete. This field will be set by the actuators and consumed by higher level entities like autoscaler that will be interfacing with cluster-api as generic provider.
+     */
     @JsonProperty("providerID")
     public String getProviderID() {
         return providerID;
     }
 
+    /**
+     * ProviderID is the identification ID of the machine provided by the provider. This field must match the provider ID as seen on the node object corresponding to this machine. This field is required by higher level consumers of cluster-api. Example use case is cluster autoscaler with cluster-api as provider. Clean-up logic in the autoscaler compares machines to nodes to find out machines at provider which could not get registered as Kubernetes nodes. With cluster-api as a generic out-of-tree provider for autoscaler, this field is required by autoscaler to be able to have a provider view of the list of machines. Another list of nodes is queried from the k8s apiserver and then a comparison is done to find out unregistered machines and are marked for delete. This field will be set by the actuators and consumed by higher level entities like autoscaler that will be interfacing with cluster-api as generic provider.
+     */
     @JsonProperty("providerID")
     public void setProviderID(String providerID) {
         this.providerID = providerID;
     }
 
+    /**
+     * MachineSpec defines the desired state of Machine
+     */
     @JsonProperty("providerSpec")
     public ProviderSpec getProviderSpec() {
         return providerSpec;
     }
 
+    /**
+     * MachineSpec defines the desired state of Machine
+     */
     @JsonProperty("providerSpec")
     public void setProviderSpec(ProviderSpec providerSpec) {
         this.providerSpec = providerSpec;
     }
 
+    /**
+     * The list of the taints to be applied to the corresponding Node in additive manner. This list will not overwrite any other taints added to the Node on an ongoing basis by other entities. These taints should be actively reconciled e.g. if you ask the machine controller to apply a taint and then manually remove the taint the machine controller will put it back) but not have the machine controller remove any taints
+     */
     @JsonProperty("taints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Taint> getTaints() {
         return taints;
     }
 
+    /**
+     * The list of the taints to be applied to the corresponding Node in additive manner. This list will not overwrite any other taints added to the Node on an ongoing basis by other entities. These taints should be actively reconciled e.g. if you ask the machine controller to apply a taint and then manually remove the taint the machine controller will put it back) but not have the machine controller remove any taints
+     */
     @JsonProperty("taints")
     public void setTaints(List<Taint> taints) {
         this.taints = taints;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineStatus.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineStatus.java
index bc62efc3697..37f1e95b872 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineStatus.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineStatus defines the observed state of Machine
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -124,114 +127,180 @@ public MachineStatus(List<NodeAddress> addresses, String authoritativeAPI, List<
         this.synchronizedGeneration = synchronizedGeneration;
     }
 
+    /**
+     * Addresses is a list of addresses assigned to the machine. Queried from cloud provider, if available.
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NodeAddress> getAddresses() {
         return addresses;
     }
 
+    /**
+     * Addresses is a list of addresses assigned to the machine. Queried from cloud provider, if available.
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<NodeAddress> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * authoritativeAPI is the API that is authoritative for this resource. Valid values are MachineAPI, ClusterAPI and Migrating. This value is updated by the migration controller to reflect the authoritative API. Machine API and Cluster API controllers use this value to determine whether or not to reconcile the resource. When set to Migrating, the migration controller is currently performing the handover of authority from one API to the other.
+     */
     @JsonProperty("authoritativeAPI")
     public String getAuthoritativeAPI() {
         return authoritativeAPI;
     }
 
+    /**
+     * authoritativeAPI is the API that is authoritative for this resource. Valid values are MachineAPI, ClusterAPI and Migrating. This value is updated by the migration controller to reflect the authoritative API. Machine API and Cluster API controllers use this value to determine whether or not to reconcile the resource. When set to Migrating, the migration controller is currently performing the handover of authority from one API to the other.
+     */
     @JsonProperty("authoritativeAPI")
     public void setAuthoritativeAPI(String authoritativeAPI) {
         this.authoritativeAPI = authoritativeAPI;
     }
 
+    /**
+     * Conditions defines the current state of the Machine
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions defines the current state of the Machine
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ErrorMessage will be set in the event that there is a terminal problem reconciling the Machine and will contain a more verbose string suitable for logging and human consumption.<br><p> <br><p> This field should not be set for transitive errors that a controller faces that are expected to be fixed automatically over time (like service outages), but instead indicate that something is fundamentally wrong with the Machine's spec or the configuration of the controller, and that manual intervention is required. Examples of terminal errors would be invalid combinations of settings in the spec, values that are unsupported by the controller, or the responsible controller itself being critically misconfigured.<br><p> <br><p> Any transient errors that occur during the reconciliation of Machines can be added as events to the Machine object and/or logged in the controller's output.
+     */
     @JsonProperty("errorMessage")
     public String getErrorMessage() {
         return errorMessage;
     }
 
+    /**
+     * ErrorMessage will be set in the event that there is a terminal problem reconciling the Machine and will contain a more verbose string suitable for logging and human consumption.<br><p> <br><p> This field should not be set for transitive errors that a controller faces that are expected to be fixed automatically over time (like service outages), but instead indicate that something is fundamentally wrong with the Machine's spec or the configuration of the controller, and that manual intervention is required. Examples of terminal errors would be invalid combinations of settings in the spec, values that are unsupported by the controller, or the responsible controller itself being critically misconfigured.<br><p> <br><p> Any transient errors that occur during the reconciliation of Machines can be added as events to the Machine object and/or logged in the controller's output.
+     */
     @JsonProperty("errorMessage")
     public void setErrorMessage(String errorMessage) {
         this.errorMessage = errorMessage;
     }
 
+    /**
+     * ErrorReason will be set in the event that there is a terminal problem reconciling the Machine and will contain a succinct value suitable for machine interpretation.<br><p> <br><p> This field should not be set for transitive errors that a controller faces that are expected to be fixed automatically over time (like service outages), but instead indicate that something is fundamentally wrong with the Machine's spec or the configuration of the controller, and that manual intervention is required. Examples of terminal errors would be invalid combinations of settings in the spec, values that are unsupported by the controller, or the responsible controller itself being critically misconfigured.<br><p> <br><p> Any transient errors that occur during the reconciliation of Machines can be added as events to the Machine object and/or logged in the controller's output.
+     */
     @JsonProperty("errorReason")
     public String getErrorReason() {
         return errorReason;
     }
 
+    /**
+     * ErrorReason will be set in the event that there is a terminal problem reconciling the Machine and will contain a succinct value suitable for machine interpretation.<br><p> <br><p> This field should not be set for transitive errors that a controller faces that are expected to be fixed automatically over time (like service outages), but instead indicate that something is fundamentally wrong with the Machine's spec or the configuration of the controller, and that manual intervention is required. Examples of terminal errors would be invalid combinations of settings in the spec, values that are unsupported by the controller, or the responsible controller itself being critically misconfigured.<br><p> <br><p> Any transient errors that occur during the reconciliation of Machines can be added as events to the Machine object and/or logged in the controller's output.
+     */
     @JsonProperty("errorReason")
     public void setErrorReason(String errorReason) {
         this.errorReason = errorReason;
     }
 
+    /**
+     * MachineStatus defines the observed state of Machine
+     */
     @JsonProperty("lastOperation")
     public LastOperation getLastOperation() {
         return lastOperation;
     }
 
+    /**
+     * MachineStatus defines the observed state of Machine
+     */
     @JsonProperty("lastOperation")
     public void setLastOperation(LastOperation lastOperation) {
         this.lastOperation = lastOperation;
     }
 
+    /**
+     * MachineStatus defines the observed state of Machine
+     */
     @JsonProperty("lastUpdated")
     public String getLastUpdated() {
         return lastUpdated;
     }
 
+    /**
+     * MachineStatus defines the observed state of Machine
+     */
     @JsonProperty("lastUpdated")
     public void setLastUpdated(String lastUpdated) {
         this.lastUpdated = lastUpdated;
     }
 
+    /**
+     * MachineStatus defines the observed state of Machine
+     */
     @JsonProperty("nodeRef")
     public ObjectReference getNodeRef() {
         return nodeRef;
     }
 
+    /**
+     * MachineStatus defines the observed state of Machine
+     */
     @JsonProperty("nodeRef")
     public void setNodeRef(ObjectReference nodeRef) {
         this.nodeRef = nodeRef;
     }
 
+    /**
+     * Phase represents the current phase of machine actuation. One of: Failed, Provisioning, Provisioned, Running, Deleting
+     */
     @JsonProperty("phase")
     public String getPhase() {
         return phase;
     }
 
+    /**
+     * Phase represents the current phase of machine actuation. One of: Failed, Provisioning, Provisioned, Running, Deleting
+     */
     @JsonProperty("phase")
     public void setPhase(String phase) {
         this.phase = phase;
     }
 
+    /**
+     * MachineStatus defines the observed state of Machine
+     */
     @JsonProperty("providerStatus")
     public Object getProviderStatus() {
         return providerStatus;
     }
 
+    /**
+     * MachineStatus defines the observed state of Machine
+     */
     @JsonProperty("providerStatus")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setProviderStatus(Object providerStatus) {
         this.providerStatus = providerStatus;
     }
 
+    /**
+     * synchronizedGeneration is the generation of the authoritative resource that the non-authoritative resource is synchronised with. This field is set when the authoritative resource is updated and the sync controller has updated the non-authoritative resource to match.
+     */
     @JsonProperty("synchronizedGeneration")
     public Long getSynchronizedGeneration() {
         return synchronizedGeneration;
     }
 
+    /**
+     * synchronizedGeneration is the generation of the authoritative resource that the non-authoritative resource is synchronised with. This field is set when the authoritative resource is updated and the sync controller has updated the non-authoritative resource to match.
+     */
     @JsonProperty("synchronizedGeneration")
     public void setSynchronizedGeneration(Long synchronizedGeneration) {
         this.synchronizedGeneration = synchronizedGeneration;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineTemplateSpec.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineTemplateSpec.java
index bde9f4d6bd6..10e3dbf49f1 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineTemplateSpec.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MachineTemplateSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineTemplateSpec describes the data needed to create a Machine from a template
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public MachineTemplateSpec(ObjectMeta metadata, MachineSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * MachineTemplateSpec describes the data needed to create a Machine from a template
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MachineTemplateSpec describes the data needed to create a Machine from a template
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * MachineTemplateSpec describes the data needed to create a Machine from a template
+     */
     @JsonProperty("spec")
     public MachineSpec getSpec() {
         return spec;
     }
 
+    /**
+     * MachineTemplateSpec describes the data needed to create a Machine from a template
+     */
     @JsonProperty("spec")
     public void setSpec(MachineSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MetadataServiceOptions.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MetadataServiceOptions.java
index fed1a23273c..d5c689f0b47 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MetadataServiceOptions.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/MetadataServiceOptions.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MetadataServiceOptions defines the options available to a user when configuring Instance Metadata Service (IMDS) Options.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public MetadataServiceOptions(String authentication) {
         this.authentication = authentication;
     }
 
+    /**
+     * Authentication determines whether or not the host requires the use of authentication when interacting with the metadata service. When using authentication, this enforces v2 interaction method (IMDSv2) with the metadata service. When omitted, this means the user has no opinion and the value is left to the platform to choose a good default, which is subject to change over time. The current default is optional. At this point this field represents `HttpTokens` parameter from `InstanceMetadataOptionsRequest` structure in AWS EC2 API https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_InstanceMetadataOptionsRequest.html
+     */
     @JsonProperty("authentication")
     public String getAuthentication() {
         return authentication;
     }
 
+    /**
+     * Authentication determines whether or not the host requires the use of authentication when interacting with the metadata service. When using authentication, this enforces v2 interaction method (IMDSv2) with the metadata service. When omitted, this means the user has no opinion and the value is left to the platform to choose a good default, which is subject to change over time. The current default is optional. At this point this field represents `HttpTokens` parameter from `InstanceMetadataOptionsRequest` structure in AWS EC2 API https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_InstanceMetadataOptionsRequest.html
+     */
     @JsonProperty("authentication")
     public void setAuthentication(String authentication) {
         this.authentication = authentication;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/NetworkDeviceSpec.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/NetworkDeviceSpec.java
index cd27318a4eb..5b231db4e63 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/NetworkDeviceSpec.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/NetworkDeviceSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkDeviceSpec defines the network configuration for a virtual machine's network device.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -99,54 +102,84 @@ public NetworkDeviceSpec(List<AddressesFromPool> addressesFromPools, String gate
         this.networkName = networkName;
     }
 
+    /**
+     * addressesFromPools is a list of references to IP pool types and instances which are handled by an external controller. addressesFromPool configurations provided via addressesFromPools defer IP address assignment to an external controller. IP addresses provided via ipAddrs, however, are intended to allow explicit assignment of a machine's IP address. If both addressesFromPool and ipAddrs are empty or not defined, DHCP will assign an IP address. If both ipAddrs and addressesFromPools are defined, the IP addresses associated with ipAddrs will be applied first followed by IP addresses from addressesFromPools.
+     */
     @JsonProperty("addressesFromPools")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AddressesFromPool> getAddressesFromPools() {
         return addressesFromPools;
     }
 
+    /**
+     * addressesFromPools is a list of references to IP pool types and instances which are handled by an external controller. addressesFromPool configurations provided via addressesFromPools defer IP address assignment to an external controller. IP addresses provided via ipAddrs, however, are intended to allow explicit assignment of a machine's IP address. If both addressesFromPool and ipAddrs are empty or not defined, DHCP will assign an IP address. If both ipAddrs and addressesFromPools are defined, the IP addresses associated with ipAddrs will be applied first followed by IP addresses from addressesFromPools.
+     */
     @JsonProperty("addressesFromPools")
     public void setAddressesFromPools(List<AddressesFromPool> addressesFromPools) {
         this.addressesFromPools = addressesFromPools;
     }
 
+    /**
+     * gateway is an IPv4 or IPv6 address which represents the subnet gateway, for example, 192.168.1.1.
+     */
     @JsonProperty("gateway")
     public String getGateway() {
         return gateway;
     }
 
+    /**
+     * gateway is an IPv4 or IPv6 address which represents the subnet gateway, for example, 192.168.1.1.
+     */
     @JsonProperty("gateway")
     public void setGateway(String gateway) {
         this.gateway = gateway;
     }
 
+    /**
+     * ipAddrs is a list of one or more IPv4 and/or IPv6 addresses and CIDR to assign to this device, for example, 192.168.1.100/24. IP addresses provided via ipAddrs are intended to allow explicit assignment of a machine's IP address. IP pool configurations provided via addressesFromPool, however, defer IP address assignment to an external controller. If both addressesFromPool and ipAddrs are empty or not defined, DHCP will be used to assign an IP address. If both ipAddrs and addressesFromPools are defined, the IP addresses associated with ipAddrs will be applied first followed by IP addresses from addressesFromPools.
+     */
     @JsonProperty("ipAddrs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIpAddrs() {
         return ipAddrs;
     }
 
+    /**
+     * ipAddrs is a list of one or more IPv4 and/or IPv6 addresses and CIDR to assign to this device, for example, 192.168.1.100/24. IP addresses provided via ipAddrs are intended to allow explicit assignment of a machine's IP address. IP pool configurations provided via addressesFromPool, however, defer IP address assignment to an external controller. If both addressesFromPool and ipAddrs are empty or not defined, DHCP will be used to assign an IP address. If both ipAddrs and addressesFromPools are defined, the IP addresses associated with ipAddrs will be applied first followed by IP addresses from addressesFromPools.
+     */
     @JsonProperty("ipAddrs")
     public void setIpAddrs(List<String> ipAddrs) {
         this.ipAddrs = ipAddrs;
     }
 
+    /**
+     * nameservers is a list of IPv4 and/or IPv6 addresses used as DNS nameservers, for example, 8.8.8.8. a nameserver is not provided by a fulfilled IPAddressClaim. If DHCP is not the source of IP addresses for this network device, nameservers should include a valid nameserver.
+     */
     @JsonProperty("nameservers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNameservers() {
         return nameservers;
     }
 
+    /**
+     * nameservers is a list of IPv4 and/or IPv6 addresses used as DNS nameservers, for example, 8.8.8.8. a nameserver is not provided by a fulfilled IPAddressClaim. If DHCP is not the source of IP addresses for this network device, nameservers should include a valid nameserver.
+     */
     @JsonProperty("nameservers")
     public void setNameservers(List<String> nameservers) {
         this.nameservers = nameservers;
     }
 
+    /**
+     * networkName is the name of the vSphere network or port group to which the network device will be connected, for example, port-group-1. When not provided, the vCenter API will attempt to select a default network. The available networks (port groups) can be listed using `govc ls 'network/&#42;'`
+     */
     @JsonProperty("networkName")
     public String getNetworkName() {
         return networkName;
     }
 
+    /**
+     * networkName is the name of the vSphere network or port group to which the network device will be connected, for example, port-group-1. When not provided, the vCenter API will attempt to select a default network. The available networks (port groups) can be listed using `govc ls 'network/&#42;'`
+     */
     @JsonProperty("networkName")
     public void setNetworkName(String networkName) {
         this.networkName = networkName;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/NetworkSpec.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/NetworkSpec.java
index 2bd5df80312..38f2238e6bf 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/NetworkSpec.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/NetworkSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkSpec defines the virtual machine's network configuration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public NetworkSpec(List<NetworkDeviceSpec> devices) {
         this.devices = devices;
     }
 
+    /**
+     * Devices defines the virtual machine's network interfaces.
+     */
     @JsonProperty("devices")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NetworkDeviceSpec> getDevices() {
         return devices;
     }
 
+    /**
+     * Devices defines the virtual machine's network interfaces.
+     */
     @JsonProperty("devices")
     public void setDevices(List<NetworkDeviceSpec> devices) {
         this.devices = devices;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/OSDisk.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/OSDisk.java
index 1a665210c09..f309d34042d 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/OSDisk.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/OSDisk.java
@@ -94,11 +94,17 @@ public OSDisk(String cachingType, DiskSettings diskSettings, Integer diskSizeGB,
         this.osType = osType;
     }
 
+    /**
+     * CachingType specifies the caching requirements. Possible values include: 'None', 'ReadOnly', 'ReadWrite'. Empty value means no opinion and the platform chooses a default, which is subject to change over time. Currently the default is `None`.
+     */
     @JsonProperty("cachingType")
     public String getCachingType() {
         return cachingType;
     }
 
+    /**
+     * CachingType specifies the caching requirements. Possible values include: 'None', 'ReadOnly', 'ReadWrite'. Empty value means no opinion and the platform chooses a default, which is subject to change over time. Currently the default is `None`.
+     */
     @JsonProperty("cachingType")
     public void setCachingType(String cachingType) {
         this.cachingType = cachingType;
@@ -114,11 +120,17 @@ public void setDiskSettings(DiskSettings diskSettings) {
         this.diskSettings = diskSettings;
     }
 
+    /**
+     * DiskSizeGB is the size in GB to assign to the data disk.
+     */
     @JsonProperty("diskSizeGB")
     public Integer getDiskSizeGB() {
         return diskSizeGB;
     }
 
+    /**
+     * DiskSizeGB is the size in GB to assign to the data disk.
+     */
     @JsonProperty("diskSizeGB")
     public void setDiskSizeGB(Integer diskSizeGB) {
         this.diskSizeGB = diskSizeGB;
@@ -134,11 +146,17 @@ public void setManagedDisk(OSDiskManagedDiskParameters managedDisk) {
         this.managedDisk = managedDisk;
     }
 
+    /**
+     * OSType is the operating system type of the OS disk. Possible values include "Linux" and "Windows".
+     */
     @JsonProperty("osType")
     public String getOsType() {
         return osType;
     }
 
+    /**
+     * OSType is the operating system type of the OS disk. Possible values include "Linux" and "Windows".
+     */
     @JsonProperty("osType")
     public void setOsType(String osType) {
         this.osType = osType;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/OSDiskManagedDiskParameters.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/OSDiskManagedDiskParameters.java
index 0a92493893e..bee8623ad7a 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/OSDiskManagedDiskParameters.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/OSDiskManagedDiskParameters.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OSDiskManagedDiskParameters is the parameters of a OSDisk managed disk.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public OSDiskManagedDiskParameters(DiskEncryptionSetParameters diskEncryptionSet
         this.storageAccountType = storageAccountType;
     }
 
+    /**
+     * OSDiskManagedDiskParameters is the parameters of a OSDisk managed disk.
+     */
     @JsonProperty("diskEncryptionSet")
     public DiskEncryptionSetParameters getDiskEncryptionSet() {
         return diskEncryptionSet;
     }
 
+    /**
+     * OSDiskManagedDiskParameters is the parameters of a OSDisk managed disk.
+     */
     @JsonProperty("diskEncryptionSet")
     public void setDiskEncryptionSet(DiskEncryptionSetParameters diskEncryptionSet) {
         this.diskEncryptionSet = diskEncryptionSet;
     }
 
+    /**
+     * OSDiskManagedDiskParameters is the parameters of a OSDisk managed disk.
+     */
     @JsonProperty("securityProfile")
     public VMDiskSecurityProfile getSecurityProfile() {
         return securityProfile;
     }
 
+    /**
+     * OSDiskManagedDiskParameters is the parameters of a OSDisk managed disk.
+     */
     @JsonProperty("securityProfile")
     public void setSecurityProfile(VMDiskSecurityProfile securityProfile) {
         this.securityProfile = securityProfile;
     }
 
+    /**
+     * StorageAccountType is the storage account type to use. Possible values include "Standard_LRS", "Premium_LRS".
+     */
     @JsonProperty("storageAccountType")
     public String getStorageAccountType() {
         return storageAccountType;
     }
 
+    /**
+     * StorageAccountType is the storage account type to use. Possible values include "Standard_LRS", "Premium_LRS".
+     */
     @JsonProperty("storageAccountType")
     public void setStorageAccountType(String storageAccountType) {
         this.storageAccountType = storageAccountType;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/ObjectMeta.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/ObjectMeta.java
index 3e3f07badec..a9cc28375e6 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/ObjectMeta.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/ObjectMeta.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. This is a copy of customizable fields from metav1.ObjectMeta.<br><p> <br><p> ObjectMeta is embedded in `Machine.Spec`, `MachineDeployment.Template` and `MachineSet.Template`, which are not top-level Kubernetes objects. Given that metav1.ObjectMeta has lots of special cases and read-only fields which end up in the generated CRD validation, having it as a subset simplifies the API and some issues that can impact user experience.<br><p> <br><p> During the [upgrade to controller-tools@v2](https://github.com/kubernetes-sigs/cluster-api/pull/1054) for v1alpha2, we noticed a failure would occur running Cluster API test suite against the new CRDs, specifically `spec.metadata.creationTimestamp in body must be of type string: "null"`. The investigation showed that `controller-tools@v2` behaves differently than its previous version when handling types from [metav1](k8s.io/apimachinery/pkg/apis/meta/v1) package.<br><p> <br><p> In more details, we found that embedded (non-top level) types that embedded `metav1.ObjectMeta` had validation properties, including for `creationTimestamp` (metav1.Time). The `metav1.Time` type specifies a custom json marshaller that, when IsZero() is true, returns `null` which breaks validation because the field isn't marked as nullable.<br><p> <br><p> In future versions, controller-tools@v2 might allow overriding the type and validation for embedded types. When that happens, this hack should be revisited.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -103,64 +106,100 @@ public ObjectMeta(Map<String, String> annotations, String generateName, Map<Stri
         this.ownerReferences = ownerReferences;
     }
 
+    /**
+     * Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: http://kubernetes.io/docs/user-guide/annotations
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: http://kubernetes.io/docs/user-guide/annotations
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.<br><p> <br><p> If this field is specified and the generated name exists, the server will NOT return a 409 - instead, it will either return 201 Created or 500 with Reason ServerTimeout indicating a unique name could not be found in the time allotted, and the client should retry (optionally after the time indicated in the Retry-After header).<br><p> <br><p> Applied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency
+     */
     @JsonProperty("generateName")
     public String getGenerateName() {
         return generateName;
     }
 
+    /**
+     * GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.<br><p> <br><p> If this field is specified and the generated name exists, the server will NOT return a 409 - instead, it will either return 201 Created or 500 with Reason ServerTimeout indicating a unique name could not be found in the time allotted, and the client should retry (optionally after the time indicated in the Retry-After header).<br><p> <br><p> Applied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency
+     */
     @JsonProperty("generateName")
     public void setGenerateName(String generateName) {
         this.generateName = generateName;
     }
 
+    /**
+     * Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: http://kubernetes.io/docs/user-guide/labels
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabels() {
         return labels;
     }
 
+    /**
+     * Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: http://kubernetes.io/docs/user-guide/labels
+     */
     @JsonProperty("labels")
     public void setLabels(Map<String, String> labels) {
         this.labels = labels;
     }
 
+    /**
+     * Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: http://kubernetes.io/docs/user-guide/identifiers#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: http://kubernetes.io/docs/user-guide/identifiers#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace defines the space within each name must be unique. An empty namespace is equivalent to the "default" namespace, but "default" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.<br><p> <br><p> Must be a DNS_LABEL. Cannot be updated. More info: http://kubernetes.io/docs/user-guide/namespaces
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace defines the space within each name must be unique. An empty namespace is equivalent to the "default" namespace, but "default" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.<br><p> <br><p> Must be a DNS_LABEL. Cannot be updated. More info: http://kubernetes.io/docs/user-guide/namespaces
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.
+     */
     @JsonProperty("ownerReferences")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OwnerReference> getOwnerReferences() {
         return ownerReferences;
     }
 
+    /**
+     * List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.
+     */
     @JsonProperty("ownerReferences")
     public void setOwnerReferences(List<OwnerReference> ownerReferences) {
         this.ownerReferences = ownerReferences;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/Placement.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/Placement.java
index c732a83fda5..91dcadfe1fb 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/Placement.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/Placement.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Placement indicates where to create the instance in AWS
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public Placement(String availabilityZone, String region, String tenancy) {
         this.tenancy = tenancy;
     }
 
+    /**
+     * AvailabilityZone is the availability zone of the instance
+     */
     @JsonProperty("availabilityZone")
     public String getAvailabilityZone() {
         return availabilityZone;
     }
 
+    /**
+     * AvailabilityZone is the availability zone of the instance
+     */
     @JsonProperty("availabilityZone")
     public void setAvailabilityZone(String availabilityZone) {
         this.availabilityZone = availabilityZone;
     }
 
+    /**
+     * Region is the region to use to create the instance
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Region is the region to use to create the instance
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * Tenancy indicates if instance should run on shared or single-tenant hardware. There are supported 3 options: default, dedicated and host.
+     */
     @JsonProperty("tenancy")
     public String getTenancy() {
         return tenancy;
     }
 
+    /**
+     * Tenancy indicates if instance should run on shared or single-tenant hardware. There are supported 3 options: default, dedicated and host.
+     */
     @JsonProperty("tenancy")
     public void setTenancy(String tenancy) {
         this.tenancy = tenancy;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/ProviderSpec.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/ProviderSpec.java
index 19289fe1e0e..34f0c824b48 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/ProviderSpec.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/ProviderSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ProviderSpec defines the configuration to use during node creation.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,11 +82,17 @@ public ProviderSpec(Object value) {
         this.value = value;
     }
 
+    /**
+     * ProviderSpec defines the configuration to use during node creation.
+     */
     @JsonProperty("value")
     public Object getValue() {
         return value;
     }
 
+    /**
+     * ProviderSpec defines the configuration to use during node creation.
+     */
     @JsonProperty("value")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setValue(Object value) {
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/ResourceManagerTag.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/ResourceManagerTag.java
index b14cb94ab7e..25826320002 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/ResourceManagerTag.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/ResourceManagerTag.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceManagerTag is a tag to apply to GCP resources created for the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ResourceManagerTag(String key, String parentID, String value) {
         this.value = value;
     }
 
+    /**
+     * key is the key part of the tag. A tag key can have a maximum of 63 characters and cannot be empty. Tag key must begin and end with an alphanumeric character, and must contain only uppercase, lowercase alphanumeric characters, and the following special characters `._-`.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * key is the key part of the tag. A tag key can have a maximum of 63 characters and cannot be empty. Tag key must begin and end with an alphanumeric character, and must contain only uppercase, lowercase alphanumeric characters, and the following special characters `._-`.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * parentID is the ID of the hierarchical resource where the tags are defined e.g. at the Organization or the Project level. To find the Organization or Project ID ref https://cloud.google.com/resource-manager/docs/creating-managing-organization#retrieving_your_organization_id https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects An OrganizationID can have a maximum of 32 characters and must consist of decimal numbers, and cannot have leading zeroes. A ProjectID must be 6 to 30 characters in length, can only contain lowercase letters, numbers, and hyphens, and must start with a letter, and cannot end with a hyphen.
+     */
     @JsonProperty("parentID")
     public String getParentID() {
         return parentID;
     }
 
+    /**
+     * parentID is the ID of the hierarchical resource where the tags are defined e.g. at the Organization or the Project level. To find the Organization or Project ID ref https://cloud.google.com/resource-manager/docs/creating-managing-organization#retrieving_your_organization_id https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects An OrganizationID can have a maximum of 32 characters and must consist of decimal numbers, and cannot have leading zeroes. A ProjectID must be 6 to 30 characters in length, can only contain lowercase letters, numbers, and hyphens, and must start with a letter, and cannot end with a hyphen.
+     */
     @JsonProperty("parentID")
     public void setParentID(String parentID) {
         this.parentID = parentID;
     }
 
+    /**
+     * value is the value part of the tag. A tag value can have a maximum of 63 characters and cannot be empty. Tag value must begin and end with an alphanumeric character, and must contain only uppercase, lowercase alphanumeric characters, and the following special characters `_-.@%=+:,&#42;#&amp;(){}[]` and spaces.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * value is the value part of the tag. A tag value can have a maximum of 63 characters and cannot be empty. Tag value must begin and end with an alphanumeric character, and must contain only uppercase, lowercase alphanumeric characters, and the following special characters `_-.@%=+:,&#42;#&amp;(){}[]` and spaces.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/SecurityProfile.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/SecurityProfile.java
index e0f19ada859..e52edf1c060 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/SecurityProfile.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/SecurityProfile.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SecurityProfile specifies the Security profile settings for a virtual machine or virtual machine scale set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public SecurityProfile(Boolean encryptionAtHost, SecuritySettings settings) {
         this.settings = settings;
     }
 
+    /**
+     * encryptionAtHost indicates whether Host Encryption should be enabled or disabled for a virtual machine or virtual machine scale set. This should be disabled when SecurityEncryptionType is set to DiskWithVMGuestState. Default is disabled.
+     */
     @JsonProperty("encryptionAtHost")
     public Boolean getEncryptionAtHost() {
         return encryptionAtHost;
     }
 
+    /**
+     * encryptionAtHost indicates whether Host Encryption should be enabled or disabled for a virtual machine or virtual machine scale set. This should be disabled when SecurityEncryptionType is set to DiskWithVMGuestState. Default is disabled.
+     */
     @JsonProperty("encryptionAtHost")
     public void setEncryptionAtHost(Boolean encryptionAtHost) {
         this.encryptionAtHost = encryptionAtHost;
     }
 
+    /**
+     * SecurityProfile specifies the Security profile settings for a virtual machine or virtual machine scale set.
+     */
     @JsonProperty("settings")
     public SecuritySettings getSettings() {
         return settings;
     }
 
+    /**
+     * SecurityProfile specifies the Security profile settings for a virtual machine or virtual machine scale set.
+     */
     @JsonProperty("settings")
     public void setSettings(SecuritySettings settings) {
         this.settings = settings;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/SecuritySettings.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/SecuritySettings.java
index 9d08aa90a34..02c2f50f665 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/SecuritySettings.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/SecuritySettings.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SecuritySettings define the security type and the UEFI settings of the virtual machine.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public SecuritySettings(ConfidentialVM confidentialVM, String securityType, Trus
         this.trustedLaunch = trustedLaunch;
     }
 
+    /**
+     * SecuritySettings define the security type and the UEFI settings of the virtual machine.
+     */
     @JsonProperty("confidentialVM")
     public ConfidentialVM getConfidentialVM() {
         return confidentialVM;
     }
 
+    /**
+     * SecuritySettings define the security type and the UEFI settings of the virtual machine.
+     */
     @JsonProperty("confidentialVM")
     public void setConfidentialVM(ConfidentialVM confidentialVM) {
         this.confidentialVM = confidentialVM;
     }
 
+    /**
+     * securityType specifies the SecurityType of the virtual machine. It has to be set to any specified value to enable UEFISettings. The default behavior is: UEFISettings will not be enabled unless this property is set.
+     */
     @JsonProperty("securityType")
     public String getSecurityType() {
         return securityType;
     }
 
+    /**
+     * securityType specifies the SecurityType of the virtual machine. It has to be set to any specified value to enable UEFISettings. The default behavior is: UEFISettings will not be enabled unless this property is set.
+     */
     @JsonProperty("securityType")
     public void setSecurityType(String securityType) {
         this.securityType = securityType;
     }
 
+    /**
+     * SecuritySettings define the security type and the UEFI settings of the virtual machine.
+     */
     @JsonProperty("trustedLaunch")
     public TrustedLaunch getTrustedLaunch() {
         return trustedLaunch;
     }
 
+    /**
+     * SecuritySettings define the security type and the UEFI settings of the virtual machine.
+     */
     @JsonProperty("trustedLaunch")
     public void setTrustedLaunch(TrustedLaunch trustedLaunch) {
         this.trustedLaunch = trustedLaunch;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/SpotMarketOptions.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/SpotMarketOptions.java
index 5902e41843c..095bc9bfb07 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/SpotMarketOptions.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/SpotMarketOptions.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SpotMarketOptions defines the options available to a user when configuring Machines to run on Spot instances. Most users should provide an empty struct.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public SpotMarketOptions(String maxPrice) {
         this.maxPrice = maxPrice;
     }
 
+    /**
+     * The maximum price the user is willing to pay for their instances Default: On-Demand price
+     */
     @JsonProperty("maxPrice")
     public String getMaxPrice() {
         return maxPrice;
     }
 
+    /**
+     * The maximum price the user is willing to pay for their instances Default: On-Demand price
+     */
     @JsonProperty("maxPrice")
     public void setMaxPrice(String maxPrice) {
         this.maxPrice = maxPrice;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/SpotVMOptions.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/SpotVMOptions.java
index a8db03cd288..7997bd03873 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/SpotVMOptions.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/SpotVMOptions.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SpotVMOptions defines the options relevant to running the Machine on Spot VMs
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,11 +82,17 @@ public SpotVMOptions(Quantity maxPrice) {
         this.maxPrice = maxPrice;
     }
 
+    /**
+     * SpotVMOptions defines the options relevant to running the Machine on Spot VMs
+     */
     @JsonProperty("maxPrice")
     public Quantity getMaxPrice() {
         return maxPrice;
     }
 
+    /**
+     * SpotVMOptions defines the options relevant to running the Machine on Spot VMs
+     */
     @JsonProperty("maxPrice")
     public void setMaxPrice(Quantity maxPrice) {
         this.maxPrice = maxPrice;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/TagSpecification.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/TagSpecification.java
index 6d7757a65a8..f2d75ad170d 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/TagSpecification.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/TagSpecification.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TagSpecification is the name/value pair for a tag
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public TagSpecification(String name, String value) {
         this.value = value;
     }
 
+    /**
+     * Name of the tag
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the tag
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Value of the tag
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value of the tag
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/TrustedLaunch.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/TrustedLaunch.java
index 0a960fe17b2..390b733f947 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/TrustedLaunch.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/TrustedLaunch.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TrustedLaunch defines the UEFI settings for the virtual machine.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public TrustedLaunch(UEFISettings uefiSettings) {
         this.uefiSettings = uefiSettings;
     }
 
+    /**
+     * TrustedLaunch defines the UEFI settings for the virtual machine.
+     */
     @JsonProperty("uefiSettings")
     public UEFISettings getUefiSettings() {
         return uefiSettings;
     }
 
+    /**
+     * TrustedLaunch defines the UEFI settings for the virtual machine.
+     */
     @JsonProperty("uefiSettings")
     public void setUefiSettings(UEFISettings uefiSettings) {
         this.uefiSettings = uefiSettings;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/UEFISettings.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/UEFISettings.java
index 248f635885a..82adb8ceb18 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/UEFISettings.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/UEFISettings.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UEFISettings specifies the security settings like secure boot and vTPM used while creating the virtual machine.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public UEFISettings(String secureBoot, String virtualizedTrustedPlatformModule)
         this.virtualizedTrustedPlatformModule = virtualizedTrustedPlatformModule;
     }
 
+    /**
+     * secureBoot specifies whether secure boot should be enabled on the virtual machine. Secure Boot verifies the digital signature of all boot components and halts the boot process if signature verification fails. If omitted, the platform chooses a default, which is subject to change over time, currently that default is disabled.
+     */
     @JsonProperty("secureBoot")
     public String getSecureBoot() {
         return secureBoot;
     }
 
+    /**
+     * secureBoot specifies whether secure boot should be enabled on the virtual machine. Secure Boot verifies the digital signature of all boot components and halts the boot process if signature verification fails. If omitted, the platform chooses a default, which is subject to change over time, currently that default is disabled.
+     */
     @JsonProperty("secureBoot")
     public void setSecureBoot(String secureBoot) {
         this.secureBoot = secureBoot;
     }
 
+    /**
+     * virtualizedTrustedPlatformModule specifies whether vTPM should be enabled on the virtual machine. When enabled the virtualized trusted platform module measurements are used to create a known good boot integrity policy baseline. The integrity policy baseline is used for comparison with measurements from subsequent VM boots to determine if anything has changed. This is required to be enabled if SecurityEncryptionType is defined. If omitted, the platform chooses a default, which is subject to change over time, currently that default is disabled.
+     */
     @JsonProperty("virtualizedTrustedPlatformModule")
     public String getVirtualizedTrustedPlatformModule() {
         return virtualizedTrustedPlatformModule;
     }
 
+    /**
+     * virtualizedTrustedPlatformModule specifies whether vTPM should be enabled on the virtual machine. When enabled the virtualized trusted platform module measurements are used to create a known good boot integrity policy baseline. The integrity policy baseline is used for comparison with measurements from subsequent VM boots to determine if anything has changed. This is required to be enabled if SecurityEncryptionType is defined. If omitted, the platform chooses a default, which is subject to change over time, currently that default is disabled.
+     */
     @JsonProperty("virtualizedTrustedPlatformModule")
     public void setVirtualizedTrustedPlatformModule(String virtualizedTrustedPlatformModule) {
         this.virtualizedTrustedPlatformModule = virtualizedTrustedPlatformModule;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/UnhealthyCondition.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/UnhealthyCondition.java
index b6566d79b1b..95ec87ca923 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/UnhealthyCondition.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/UnhealthyCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UnhealthyCondition represents a Node condition type and value with a timeout specified as a duration.  When the named condition has been in the given status for at least the timeout value, a node is considered unhealthy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public UnhealthyCondition(String status, String timeout, String type) {
         this.type = type;
     }
 
+    /**
+     * UnhealthyCondition represents a Node condition type and value with a timeout specified as a duration.  When the named condition has been in the given status for at least the timeout value, a node is considered unhealthy.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * UnhealthyCondition represents a Node condition type and value with a timeout specified as a duration.  When the named condition has been in the given status for at least the timeout value, a node is considered unhealthy.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * UnhealthyCondition represents a Node condition type and value with a timeout specified as a duration.  When the named condition has been in the given status for at least the timeout value, a node is considered unhealthy.
+     */
     @JsonProperty("timeout")
     public String getTimeout() {
         return timeout;
     }
 
+    /**
+     * UnhealthyCondition represents a Node condition type and value with a timeout specified as a duration.  When the named condition has been in the given status for at least the timeout value, a node is considered unhealthy.
+     */
     @JsonProperty("timeout")
     public void setTimeout(String timeout) {
         this.timeout = timeout;
     }
 
+    /**
+     * UnhealthyCondition represents a Node condition type and value with a timeout specified as a duration.  When the named condition has been in the given status for at least the timeout value, a node is considered unhealthy.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * UnhealthyCondition represents a Node condition type and value with a timeout specified as a duration.  When the named condition has been in the given status for at least the timeout value, a node is considered unhealthy.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/VMDiskSecurityProfile.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/VMDiskSecurityProfile.java
index f720de2ca0e..160d765310f 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/VMDiskSecurityProfile.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/VMDiskSecurityProfile.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VMDiskSecurityProfile specifies the security profile settings for the managed disk. It can be set only for Confidential VMs.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public VMDiskSecurityProfile(DiskEncryptionSetParameters diskEncryptionSet, Stri
         this.securityEncryptionType = securityEncryptionType;
     }
 
+    /**
+     * VMDiskSecurityProfile specifies the security profile settings for the managed disk. It can be set only for Confidential VMs.
+     */
     @JsonProperty("diskEncryptionSet")
     public DiskEncryptionSetParameters getDiskEncryptionSet() {
         return diskEncryptionSet;
     }
 
+    /**
+     * VMDiskSecurityProfile specifies the security profile settings for the managed disk. It can be set only for Confidential VMs.
+     */
     @JsonProperty("diskEncryptionSet")
     public void setDiskEncryptionSet(DiskEncryptionSetParameters diskEncryptionSet) {
         this.diskEncryptionSet = diskEncryptionSet;
     }
 
+    /**
+     * securityEncryptionType specifies the encryption type of the managed disk. It is set to DiskWithVMGuestState to encrypt the managed disk along with the VMGuestState blob, and to VMGuestStateOnly to encrypt the VMGuestState blob only. When set to VMGuestStateOnly, the vTPM should be enabled. When set to DiskWithVMGuestState, both SecureBoot and vTPM should be enabled. If the above conditions are not fulfilled, the VM will not be created and the respective error will be returned. It can be set only for Confidential VMs. Confidential VMs are defined by their SecurityProfile.SecurityType being set to ConfidentialVM, the SecurityEncryptionType of their OS disk being set to one of the allowed values and by enabling the respective SecurityProfile.UEFISettings of the VM (i.e. vTPM and SecureBoot), depending on the selected SecurityEncryptionType. For further details on Azure Confidential VMs, please refer to the respective documentation: https://learn.microsoft.com/azure/confidential-computing/confidential-vm-overview
+     */
     @JsonProperty("securityEncryptionType")
     public String getSecurityEncryptionType() {
         return securityEncryptionType;
     }
 
+    /**
+     * securityEncryptionType specifies the encryption type of the managed disk. It is set to DiskWithVMGuestState to encrypt the managed disk along with the VMGuestState blob, and to VMGuestStateOnly to encrypt the VMGuestState blob only. When set to VMGuestStateOnly, the vTPM should be enabled. When set to DiskWithVMGuestState, both SecureBoot and vTPM should be enabled. If the above conditions are not fulfilled, the VM will not be created and the respective error will be returned. It can be set only for Confidential VMs. Confidential VMs are defined by their SecurityProfile.SecurityType being set to ConfidentialVM, the SecurityEncryptionType of their OS disk being set to one of the allowed values and by enabling the respective SecurityProfile.UEFISettings of the VM (i.e. vTPM and SecureBoot), depending on the selected SecurityEncryptionType. For further details on Azure Confidential VMs, please refer to the respective documentation: https://learn.microsoft.com/azure/confidential-computing/confidential-vm-overview
+     */
     @JsonProperty("securityEncryptionType")
     public void setSecurityEncryptionType(String securityEncryptionType) {
         this.securityEncryptionType = securityEncryptionType;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/VSphereMachineProviderSpec.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/VSphereMachineProviderSpec.java
index 284de8b17b6..c9140fcc33c 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/VSphereMachineProviderSpec.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/VSphereMachineProviderSpec.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VSphereMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an VSphere virtual machine. It is used by the vSphere machine actuator to create a single Machine. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -88,9 +91,6 @@
 public class VSphereMachineProviderSpec implements Editable<VSphereMachineProviderSpecBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machine.openshift.io/v1beta1";
     @JsonProperty("cloneMode")
@@ -99,9 +99,6 @@ public class VSphereMachineProviderSpec implements Editable<VSphereMachineProvid
     private LocalObjectReference credentialsSecret;
     @JsonProperty("diskGiB")
     private Integer diskGiB;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VSphereMachineProviderSpec";
     @JsonProperty("memoryMiB")
@@ -154,7 +151,7 @@ public VSphereMachineProviderSpec(String apiVersion, String cloneMode, LocalObje
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -162,45 +159,63 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * CloneMode specifies the type of clone operation. The LinkedClone mode is only support for templates that have at least one snapshot. If the template has no snapshots, then CloneMode defaults to FullClone. When LinkedClone mode is enabled the DiskGiB field is ignored as it is not possible to expand disks of linked clones. Defaults to FullClone. When using LinkedClone, if no snapshots exist for the source template, falls back to FullClone.
+     */
     @JsonProperty("cloneMode")
     public String getCloneMode() {
         return cloneMode;
     }
 
+    /**
+     * CloneMode specifies the type of clone operation. The LinkedClone mode is only support for templates that have at least one snapshot. If the template has no snapshots, then CloneMode defaults to FullClone. When LinkedClone mode is enabled the DiskGiB field is ignored as it is not possible to expand disks of linked clones. Defaults to FullClone. When using LinkedClone, if no snapshots exist for the source template, falls back to FullClone.
+     */
     @JsonProperty("cloneMode")
     public void setCloneMode(String cloneMode) {
         this.cloneMode = cloneMode;
     }
 
+    /**
+     * VSphereMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an VSphere virtual machine. It is used by the vSphere machine actuator to create a single Machine. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("credentialsSecret")
     public LocalObjectReference getCredentialsSecret() {
         return credentialsSecret;
     }
 
+    /**
+     * VSphereMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an VSphere virtual machine. It is used by the vSphere machine actuator to create a single Machine. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("credentialsSecret")
     public void setCredentialsSecret(LocalObjectReference credentialsSecret) {
         this.credentialsSecret = credentialsSecret;
     }
 
+    /**
+     * DiskGiB is the size of a virtual machine's disk, in GiB. Defaults to the analogue property value in the template from which this machine is cloned. This parameter will be ignored if 'LinkedClone' CloneMode is set.
+     */
     @JsonProperty("diskGiB")
     public Integer getDiskGiB() {
         return diskGiB;
     }
 
+    /**
+     * DiskGiB is the size of a virtual machine's disk, in GiB. Defaults to the analogue property value in the template from which this machine is cloned. This parameter will be ignored if 'LinkedClone' CloneMode is set.
+     */
     @JsonProperty("diskGiB")
     public void setDiskGiB(Integer diskGiB) {
         this.diskGiB = diskGiB;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -208,109 +223,169 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MemoryMiB is the size of a virtual machine's memory, in MiB. Defaults to the analogue property value in the template from which this machine is cloned.
+     */
     @JsonProperty("memoryMiB")
     public Long getMemoryMiB() {
         return memoryMiB;
     }
 
+    /**
+     * MemoryMiB is the size of a virtual machine's memory, in MiB. Defaults to the analogue property value in the template from which this machine is cloned.
+     */
     @JsonProperty("memoryMiB")
     public void setMemoryMiB(Long memoryMiB) {
         this.memoryMiB = memoryMiB;
     }
 
+    /**
+     * VSphereMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an VSphere virtual machine. It is used by the vSphere machine actuator to create a single Machine. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * VSphereMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an VSphere virtual machine. It is used by the vSphere machine actuator to create a single Machine. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * VSphereMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an VSphere virtual machine. It is used by the vSphere machine actuator to create a single Machine. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("network")
     public NetworkSpec getNetwork() {
         return network;
     }
 
+    /**
+     * VSphereMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an VSphere virtual machine. It is used by the vSphere machine actuator to create a single Machine. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("network")
     public void setNetwork(NetworkSpec network) {
         this.network = network;
     }
 
+    /**
+     * NumCPUs is the number of virtual processors in a virtual machine. Defaults to the analogue property value in the template from which this machine is cloned.
+     */
     @JsonProperty("numCPUs")
     public Integer getNumCPUs() {
         return numCPUs;
     }
 
+    /**
+     * NumCPUs is the number of virtual processors in a virtual machine. Defaults to the analogue property value in the template from which this machine is cloned.
+     */
     @JsonProperty("numCPUs")
     public void setNumCPUs(Integer numCPUs) {
         this.numCPUs = numCPUs;
     }
 
+    /**
+     * NumCPUs is the number of cores among which to distribute CPUs in this virtual machine. Defaults to the analogue property value in the template from which this machine is cloned.
+     */
     @JsonProperty("numCoresPerSocket")
     public Integer getNumCoresPerSocket() {
         return numCoresPerSocket;
     }
 
+    /**
+     * NumCPUs is the number of cores among which to distribute CPUs in this virtual machine. Defaults to the analogue property value in the template from which this machine is cloned.
+     */
     @JsonProperty("numCoresPerSocket")
     public void setNumCoresPerSocket(Integer numCoresPerSocket) {
         this.numCoresPerSocket = numCoresPerSocket;
     }
 
+    /**
+     * Snapshot is the name of the snapshot from which the VM was cloned
+     */
     @JsonProperty("snapshot")
     public String getSnapshot() {
         return snapshot;
     }
 
+    /**
+     * Snapshot is the name of the snapshot from which the VM was cloned
+     */
     @JsonProperty("snapshot")
     public void setSnapshot(String snapshot) {
         this.snapshot = snapshot;
     }
 
+    /**
+     * tagIDs is an optional set of tags to add to an instance. Specified tagIDs must use URN-notation instead of display names. A maximum of 10 tag IDs may be specified.
+     */
     @JsonProperty("tagIDs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getTagIDs() {
         return tagIDs;
     }
 
+    /**
+     * tagIDs is an optional set of tags to add to an instance. Specified tagIDs must use URN-notation instead of display names. A maximum of 10 tag IDs may be specified.
+     */
     @JsonProperty("tagIDs")
     public void setTagIDs(List<String> tagIDs) {
         this.tagIDs = tagIDs;
     }
 
+    /**
+     * Template is the name, inventory path, or instance UUID of the template used to clone new machines.
+     */
     @JsonProperty("template")
     public String getTemplate() {
         return template;
     }
 
+    /**
+     * Template is the name, inventory path, or instance UUID of the template used to clone new machines.
+     */
     @JsonProperty("template")
     public void setTemplate(String template) {
         this.template = template;
     }
 
+    /**
+     * VSphereMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an VSphere virtual machine. It is used by the vSphere machine actuator to create a single Machine. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("userDataSecret")
     public LocalObjectReference getUserDataSecret() {
         return userDataSecret;
     }
 
+    /**
+     * VSphereMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an VSphere virtual machine. It is used by the vSphere machine actuator to create a single Machine. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("userDataSecret")
     public void setUserDataSecret(LocalObjectReference userDataSecret) {
         this.userDataSecret = userDataSecret;
     }
 
+    /**
+     * VSphereMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an VSphere virtual machine. It is used by the vSphere machine actuator to create a single Machine. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("workspace")
     public Workspace getWorkspace() {
         return workspace;
     }
 
+    /**
+     * VSphereMachineProviderSpec is the type that will be embedded in a Machine.Spec.ProviderSpec field for an VSphere virtual machine. It is used by the vSphere machine actuator to create a single Machine. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("workspace")
     public void setWorkspace(Workspace workspace) {
         this.workspace = workspace;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/VSphereMachineProviderStatus.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/VSphereMachineProviderStatus.java
index 0fbeab5b2b3..9ed31cb00a4 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/VSphereMachineProviderStatus.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/VSphereMachineProviderStatus.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VSphereMachineProviderStatus is the type that will be embedded in a Machine.Status.ProviderStatus field. It contains VSphere-specific status information. Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -80,9 +83,6 @@
 public class VSphereMachineProviderStatus implements Editable<VSphereMachineProviderStatusBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machine.openshift.io/v1beta1";
     @JsonProperty("conditions")
@@ -92,9 +92,6 @@ public class VSphereMachineProviderStatus implements Editable<VSphereMachineProv
     private String instanceId;
     @JsonProperty("instanceState")
     private String instanceState;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VSphereMachineProviderStatus";
     @JsonProperty("taskRef")
@@ -119,7 +116,7 @@ public VSphereMachineProviderStatus(String apiVersion, List<Condition> condition
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -127,46 +124,64 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Conditions is a set of conditions associated with the Machine to indicate errors or other status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions is a set of conditions associated with the Machine to indicate errors or other status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * InstanceID is the ID of the instance in VSphere
+     */
     @JsonProperty("instanceId")
     public String getInstanceId() {
         return instanceId;
     }
 
+    /**
+     * InstanceID is the ID of the instance in VSphere
+     */
     @JsonProperty("instanceId")
     public void setInstanceId(String instanceId) {
         this.instanceId = instanceId;
     }
 
+    /**
+     * InstanceState is the provisioning state of the VSphere Instance.
+     */
     @JsonProperty("instanceState")
     public String getInstanceState() {
         return instanceState;
     }
 
+    /**
+     * InstanceState is the provisioning state of the VSphere Instance.
+     */
     @JsonProperty("instanceState")
     public void setInstanceState(String instanceState) {
         this.instanceState = instanceState;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -174,18 +189,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TaskRef is a managed object reference to a Task related to the machine. This value is set automatically at runtime and should not be set or modified by users.
+     */
     @JsonProperty("taskRef")
     public String getTaskRef() {
         return taskRef;
     }
 
+    /**
+     * TaskRef is a managed object reference to a Task related to the machine. This value is set automatically at runtime and should not be set or modified by users.
+     */
     @JsonProperty("taskRef")
     public void setTaskRef(String taskRef) {
         this.taskRef = taskRef;
diff --git a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/Workspace.java b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/Workspace.java
index 2a8c6905895..7290a9fbef4 100644
--- a/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/Workspace.java
+++ b/kubernetes-model-generator/openshift-model-machine/src/generated/java/io/fabric8/openshift/api/model/machine/v1beta1/Workspace.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WorkspaceConfig defines a workspace configuration for the vSphere cloud provider.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public Workspace(String datacenter, String datastore, String folder, String reso
         this.server = server;
     }
 
+    /**
+     * Datacenter is the datacenter in which VMs are created/located.
+     */
     @JsonProperty("datacenter")
     public String getDatacenter() {
         return datacenter;
     }
 
+    /**
+     * Datacenter is the datacenter in which VMs are created/located.
+     */
     @JsonProperty("datacenter")
     public void setDatacenter(String datacenter) {
         this.datacenter = datacenter;
     }
 
+    /**
+     * Datastore is the datastore in which VMs are created/located.
+     */
     @JsonProperty("datastore")
     public String getDatastore() {
         return datastore;
     }
 
+    /**
+     * Datastore is the datastore in which VMs are created/located.
+     */
     @JsonProperty("datastore")
     public void setDatastore(String datastore) {
         this.datastore = datastore;
     }
 
+    /**
+     * Folder is the folder in which VMs are created/located.
+     */
     @JsonProperty("folder")
     public String getFolder() {
         return folder;
     }
 
+    /**
+     * Folder is the folder in which VMs are created/located.
+     */
     @JsonProperty("folder")
     public void setFolder(String folder) {
         this.folder = folder;
     }
 
+    /**
+     * ResourcePool is the resource pool in which VMs are created/located.
+     */
     @JsonProperty("resourcePool")
     public String getResourcePool() {
         return resourcePool;
     }
 
+    /**
+     * ResourcePool is the resource pool in which VMs are created/located.
+     */
     @JsonProperty("resourcePool")
     public void setResourcePool(String resourcePool) {
         this.resourcePool = resourcePool;
     }
 
+    /**
+     * Server is the IP address or FQDN of the vSphere endpoint.
+     */
     @JsonProperty("server")
     public String getServer() {
         return server;
     }
 
+    /**
+     * Server is the IP address or FQDN of the vSphere endpoint.
+     */
     @JsonProperty("server")
     public void setServer(String server) {
         this.server = server;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/CertExpiry.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/CertExpiry.java
index c400b74545e..8d63bae927e 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/CertExpiry.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/CertExpiry.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ceryExpiry contains the bundle name and the expiry date
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public CertExpiry(String bundle, String expiry, String subject) {
         this.subject = subject;
     }
 
+    /**
+     * bundle is the name of the bundle in which the subject certificate resides
+     */
     @JsonProperty("bundle")
     public String getBundle() {
         return bundle;
     }
 
+    /**
+     * bundle is the name of the bundle in which the subject certificate resides
+     */
     @JsonProperty("bundle")
     public void setBundle(String bundle) {
         this.bundle = bundle;
     }
 
+    /**
+     * ceryExpiry contains the bundle name and the expiry date
+     */
     @JsonProperty("expiry")
     public String getExpiry() {
         return expiry;
     }
 
+    /**
+     * ceryExpiry contains the bundle name and the expiry date
+     */
     @JsonProperty("expiry")
     public void setExpiry(String expiry) {
         this.expiry = expiry;
     }
 
+    /**
+     * subject is the subject of the certificate
+     */
     @JsonProperty("subject")
     public String getSubject() {
         return subject;
     }
 
+    /**
+     * subject is the subject of the certificate
+     */
     @JsonProperty("subject")
     public void setSubject(String subject) {
         this.subject = subject;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ContainerRuntimeConfig.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ContainerRuntimeConfig.java
index cb66b16d7e2..56dcd7f2c4c 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ContainerRuntimeConfig.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ContainerRuntimeConfig.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerRuntimeConfig describes a customized Container Runtime configuration.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ContainerRuntimeConfig implements Editable<ContainerRuntimeConfigBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machineconfiguration.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ContainerRuntimeConfig";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public ContainerRuntimeConfig(String apiVersion, String kind, ObjectMeta metadat
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ContainerRuntimeConfig describes a customized Container Runtime configuration.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ContainerRuntimeConfig describes a customized Container Runtime configuration.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ContainerRuntimeConfig describes a customized Container Runtime configuration.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ContainerRuntimeConfigSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ContainerRuntimeConfig describes a customized Container Runtime configuration.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ContainerRuntimeConfigSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ContainerRuntimeConfig describes a customized Container Runtime configuration.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public ContainerRuntimeConfigStatus getStatus() {
         return status;
     }
 
+    /**
+     * ContainerRuntimeConfig describes a customized Container Runtime configuration.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(ContainerRuntimeConfigStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ContainerRuntimeConfigCondition.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ContainerRuntimeConfigCondition.java
index 4a9721d3bff..2a89e36f070 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ContainerRuntimeConfigCondition.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ContainerRuntimeConfigCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerRuntimeConfigCondition defines the state of the ContainerRuntimeConfig
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public ContainerRuntimeConfigCondition(String lastTransitionTime, String message
         this.type = type;
     }
 
+    /**
+     * ContainerRuntimeConfigCondition defines the state of the ContainerRuntimeConfig
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * ContainerRuntimeConfigCondition defines the state of the ContainerRuntimeConfig
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * message provides additional information about the current condition. This is only to be consumed by humans.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message provides additional information about the current condition. This is only to be consumed by humans.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * reason is the reason for the condition's last transition.  Reasons are PascalCase
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * reason is the reason for the condition's last transition.  Reasons are PascalCase
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * type specifies the state of the operator's reconciliation functionality.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type specifies the state of the operator's reconciliation functionality.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ContainerRuntimeConfigList.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ContainerRuntimeConfigList.java
index f6ac24d3c08..f5c212170aa 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ContainerRuntimeConfigList.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ContainerRuntimeConfigList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerRuntimeConfigList is a list of ContainerRuntimeConfig resources<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ContainerRuntimeConfigList implements Editable<ContainerRuntimeConfigListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.machineconfiguration.v1.ContainerRuntimeConfig>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machineconfiguration.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.machineconfiguration.v1.ContainerRuntimeConfig> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ContainerRuntimeConfigList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ContainerRuntimeConfigList(String apiVersion, List<io.fabric8.openshift.a
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ContainerRuntimeConfigList is a list of ContainerRuntimeConfig resources<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.machineconfiguration.v1.ContainerRuntimeConfig> getItems() {
         return items;
     }
 
+    /**
+     * ContainerRuntimeConfigList is a list of ContainerRuntimeConfig resources<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.machineconfiguration.v1.ContainerRuntimeConfig> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ContainerRuntimeConfigList is a list of ContainerRuntimeConfig resources<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ContainerRuntimeConfigList is a list of ContainerRuntimeConfig resources<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ContainerRuntimeConfigSpec.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ContainerRuntimeConfigSpec.java
index b6773aac0ac..b3d582a9d91 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ContainerRuntimeConfigSpec.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ContainerRuntimeConfigSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerRuntimeConfigSpec defines the desired state of ContainerRuntimeConfig
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ContainerRuntimeConfigSpec(ContainerRuntimeConfiguration containerRuntime
         this.machineConfigPoolSelector = machineConfigPoolSelector;
     }
 
+    /**
+     * ContainerRuntimeConfigSpec defines the desired state of ContainerRuntimeConfig
+     */
     @JsonProperty("containerRuntimeConfig")
     public ContainerRuntimeConfiguration getContainerRuntimeConfig() {
         return containerRuntimeConfig;
     }
 
+    /**
+     * ContainerRuntimeConfigSpec defines the desired state of ContainerRuntimeConfig
+     */
     @JsonProperty("containerRuntimeConfig")
     public void setContainerRuntimeConfig(ContainerRuntimeConfiguration containerRuntimeConfig) {
         this.containerRuntimeConfig = containerRuntimeConfig;
     }
 
+    /**
+     * ContainerRuntimeConfigSpec defines the desired state of ContainerRuntimeConfig
+     */
     @JsonProperty("machineConfigPoolSelector")
     public LabelSelector getMachineConfigPoolSelector() {
         return machineConfigPoolSelector;
     }
 
+    /**
+     * ContainerRuntimeConfigSpec defines the desired state of ContainerRuntimeConfig
+     */
     @JsonProperty("machineConfigPoolSelector")
     public void setMachineConfigPoolSelector(LabelSelector machineConfigPoolSelector) {
         this.machineConfigPoolSelector = machineConfigPoolSelector;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ContainerRuntimeConfigStatus.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ContainerRuntimeConfigStatus.java
index 934ba230ac6..66358655821 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ContainerRuntimeConfigStatus.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ContainerRuntimeConfigStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerRuntimeConfigStatus defines the observed state of a ContainerRuntimeConfig
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public ContainerRuntimeConfigStatus(List<ContainerRuntimeConfigCondition> condit
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * conditions represents the latest available observations of current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ContainerRuntimeConfigCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions represents the latest available observations of current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ContainerRuntimeConfigCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * observedGeneration represents the generation observed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration represents the generation observed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ContainerRuntimeConfiguration.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ContainerRuntimeConfiguration.java
index e297b339815..aea81dcb4a3 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ContainerRuntimeConfiguration.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ContainerRuntimeConfiguration.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerRuntimeConfiguration defines the tuneables of the container runtime
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,51 +98,81 @@ public ContainerRuntimeConfiguration(String defaultRuntime, String logLevel, Qua
         this.pidsLimit = pidsLimit;
     }
 
+    /**
+     * defaultRuntime is the name of the OCI runtime to be used as the default.
+     */
     @JsonProperty("defaultRuntime")
     public String getDefaultRuntime() {
         return defaultRuntime;
     }
 
+    /**
+     * defaultRuntime is the name of the OCI runtime to be used as the default.
+     */
     @JsonProperty("defaultRuntime")
     public void setDefaultRuntime(String defaultRuntime) {
         this.defaultRuntime = defaultRuntime;
     }
 
+    /**
+     * logLevel specifies the verbosity of the logs based on the level it is set to. Options are fatal, panic, error, warn, info, and debug.
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * logLevel specifies the verbosity of the logs based on the level it is set to. Options are fatal, panic, error, warn, info, and debug.
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * ContainerRuntimeConfiguration defines the tuneables of the container runtime
+     */
     @JsonProperty("logSizeMax")
     public Quantity getLogSizeMax() {
         return logSizeMax;
     }
 
+    /**
+     * ContainerRuntimeConfiguration defines the tuneables of the container runtime
+     */
     @JsonProperty("logSizeMax")
     public void setLogSizeMax(Quantity logSizeMax) {
         this.logSizeMax = logSizeMax;
     }
 
+    /**
+     * ContainerRuntimeConfiguration defines the tuneables of the container runtime
+     */
     @JsonProperty("overlaySize")
     public Quantity getOverlaySize() {
         return overlaySize;
     }
 
+    /**
+     * ContainerRuntimeConfiguration defines the tuneables of the container runtime
+     */
     @JsonProperty("overlaySize")
     public void setOverlaySize(Quantity overlaySize) {
         this.overlaySize = overlaySize;
     }
 
+    /**
+     * pidsLimit specifies the maximum number of processes allowed in a container
+     */
     @JsonProperty("pidsLimit")
     public Long getPidsLimit() {
         return pidsLimit;
     }
 
+    /**
+     * pidsLimit specifies the maximum number of processes allowed in a container
+     */
     @JsonProperty("pidsLimit")
     public void setPidsLimit(Long pidsLimit) {
         this.pidsLimit = pidsLimit;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ControllerCertificate.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ControllerCertificate.java
index 4ebff449941..8b2095749c4 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ControllerCertificate.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ControllerCertificate.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ControllerCertificate contains info about a specific cert.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public ControllerCertificate(String bundleFile, String notAfter, String notBefor
         this.subject = subject;
     }
 
+    /**
+     * bundleFile is the larger bundle a cert comes from
+     */
     @JsonProperty("bundleFile")
     public String getBundleFile() {
         return bundleFile;
     }
 
+    /**
+     * bundleFile is the larger bundle a cert comes from
+     */
     @JsonProperty("bundleFile")
     public void setBundleFile(String bundleFile) {
         this.bundleFile = bundleFile;
     }
 
+    /**
+     * ControllerCertificate contains info about a specific cert.
+     */
     @JsonProperty("notAfter")
     public String getNotAfter() {
         return notAfter;
     }
 
+    /**
+     * ControllerCertificate contains info about a specific cert.
+     */
     @JsonProperty("notAfter")
     public void setNotAfter(String notAfter) {
         this.notAfter = notAfter;
     }
 
+    /**
+     * ControllerCertificate contains info about a specific cert.
+     */
     @JsonProperty("notBefore")
     public String getNotBefore() {
         return notBefore;
     }
 
+    /**
+     * ControllerCertificate contains info about a specific cert.
+     */
     @JsonProperty("notBefore")
     public void setNotBefore(String notBefore) {
         this.notBefore = notBefore;
     }
 
+    /**
+     * signer is the  cert Issuer
+     */
     @JsonProperty("signer")
     public String getSigner() {
         return signer;
     }
 
+    /**
+     * signer is the  cert Issuer
+     */
     @JsonProperty("signer")
     public void setSigner(String signer) {
         this.signer = signer;
     }
 
+    /**
+     * subject is the cert subject
+     */
     @JsonProperty("subject")
     public String getSubject() {
         return subject;
     }
 
+    /**
+     * subject is the cert subject
+     */
     @JsonProperty("subject")
     public void setSubject(String subject) {
         this.subject = subject;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ControllerConfig.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ControllerConfig.java
index bf236d4cb53..5e687c81979 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ControllerConfig.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ControllerConfig.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ControllerConfig describes configuration for MachineConfigController. This is currently only used to drive the MachineConfig objects generated by the TemplateController.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ControllerConfig implements Editable<ControllerConfigBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machineconfiguration.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ControllerConfig";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public ControllerConfig(String apiVersion, String kind, ObjectMeta metadata, Con
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ControllerConfig describes configuration for MachineConfigController. This is currently only used to drive the MachineConfig objects generated by the TemplateController.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ControllerConfig describes configuration for MachineConfigController. This is currently only used to drive the MachineConfig objects generated by the TemplateController.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ControllerConfig describes configuration for MachineConfigController. This is currently only used to drive the MachineConfig objects generated by the TemplateController.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ControllerConfigSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ControllerConfig describes configuration for MachineConfigController. This is currently only used to drive the MachineConfig objects generated by the TemplateController.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ControllerConfigSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ControllerConfig describes configuration for MachineConfigController. This is currently only used to drive the MachineConfig objects generated by the TemplateController.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public ControllerConfigStatus getStatus() {
         return status;
     }
 
+    /**
+     * ControllerConfig describes configuration for MachineConfigController. This is currently only used to drive the MachineConfig objects generated by the TemplateController.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(ControllerConfigStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ControllerConfigList.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ControllerConfigList.java
index 43d196a2d9e..d477d0b6e07 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ControllerConfigList.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ControllerConfigList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ControllerConfigList is a list of ControllerConfig resources<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ControllerConfigList implements Editable<ControllerConfigListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.machineconfiguration.v1.ControllerConfig>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machineconfiguration.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.machineconfiguration.v1.ControllerConfig> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ControllerConfigList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ControllerConfigList(String apiVersion, List<io.fabric8.openshift.api.mod
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ControllerConfigList is a list of ControllerConfig resources<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.machineconfiguration.v1.ControllerConfig> getItems() {
         return items;
     }
 
+    /**
+     * ControllerConfigList is a list of ControllerConfig resources<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.machineconfiguration.v1.ControllerConfig> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ControllerConfigList is a list of ControllerConfig resources<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ControllerConfigList is a list of ControllerConfig resources<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ControllerConfigSpec.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ControllerConfigSpec.java
index 91611a8f5da..785bd05f5e3 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ControllerConfigSpec.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ControllerConfigSpec.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ControllerConfigSpec is the spec for ControllerConfig resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -174,234 +177,372 @@ public ControllerConfigSpec(String additionalTrustBundle, String baseOSContainer
         this.rootCAData = rootCAData;
     }
 
+    /**
+     * additionalTrustBundle is a certificate bundle that will be added to the nodes trusted certificate store.
+     */
     @JsonProperty("additionalTrustBundle")
     public String getAdditionalTrustBundle() {
         return additionalTrustBundle;
     }
 
+    /**
+     * additionalTrustBundle is a certificate bundle that will be added to the nodes trusted certificate store.
+     */
     @JsonProperty("additionalTrustBundle")
     public void setAdditionalTrustBundle(String additionalTrustBundle) {
         this.additionalTrustBundle = additionalTrustBundle;
     }
 
+    /**
+     * BaseOSContainerImage is the new-format container image for operating system updates.
+     */
     @JsonProperty("baseOSContainerImage")
     public String getBaseOSContainerImage() {
         return baseOSContainerImage;
     }
 
+    /**
+     * BaseOSContainerImage is the new-format container image for operating system updates.
+     */
     @JsonProperty("baseOSContainerImage")
     public void setBaseOSContainerImage(String baseOSContainerImage) {
         this.baseOSContainerImage = baseOSContainerImage;
     }
 
+    /**
+     * BaseOSExtensionsContainerImage is the matching extensions container for the new-format container
+     */
     @JsonProperty("baseOSExtensionsContainerImage")
     public String getBaseOSExtensionsContainerImage() {
         return baseOSExtensionsContainerImage;
     }
 
+    /**
+     * BaseOSExtensionsContainerImage is the matching extensions container for the new-format container
+     */
     @JsonProperty("baseOSExtensionsContainerImage")
     public void setBaseOSExtensionsContainerImage(String baseOSExtensionsContainerImage) {
         this.baseOSExtensionsContainerImage = baseOSExtensionsContainerImage;
     }
 
+    /**
+     * cloudProvider specifies the cloud provider CA data
+     */
     @JsonProperty("cloudProviderCAData")
     public String getCloudProviderCAData() {
         return cloudProviderCAData;
     }
 
+    /**
+     * cloudProvider specifies the cloud provider CA data
+     */
     @JsonProperty("cloudProviderCAData")
     public void setCloudProviderCAData(String cloudProviderCAData) {
         this.cloudProviderCAData = cloudProviderCAData;
     }
 
+    /**
+     * cloudProviderConfig is the configuration for the given cloud provider
+     */
     @JsonProperty("cloudProviderConfig")
     public String getCloudProviderConfig() {
         return cloudProviderConfig;
     }
 
+    /**
+     * cloudProviderConfig is the configuration for the given cloud provider
+     */
     @JsonProperty("cloudProviderConfig")
     public void setCloudProviderConfig(String cloudProviderConfig) {
         this.cloudProviderConfig = cloudProviderConfig;
     }
 
+    /**
+     * clusterDNSIP is the cluster DNS IP address
+     */
     @JsonProperty("clusterDNSIP")
     public String getClusterDNSIP() {
         return clusterDNSIP;
     }
 
+    /**
+     * clusterDNSIP is the cluster DNS IP address
+     */
     @JsonProperty("clusterDNSIP")
     public void setClusterDNSIP(String clusterDNSIP) {
         this.clusterDNSIP = clusterDNSIP;
     }
 
+    /**
+     * ControllerConfigSpec is the spec for ControllerConfig resource.
+     */
     @JsonProperty("dns")
     public DNS getDns() {
         return dns;
     }
 
+    /**
+     * ControllerConfigSpec is the spec for ControllerConfig resource.
+     */
     @JsonProperty("dns")
     public void setDns(DNS dns) {
         this.dns = dns;
     }
 
+    /**
+     * etcdDiscoveryDomain is deprecated, use Infra.Status.EtcdDiscoveryDomain instead
+     */
     @JsonProperty("etcdDiscoveryDomain")
     public String getEtcdDiscoveryDomain() {
         return etcdDiscoveryDomain;
     }
 
+    /**
+     * etcdDiscoveryDomain is deprecated, use Infra.Status.EtcdDiscoveryDomain instead
+     */
     @JsonProperty("etcdDiscoveryDomain")
     public void setEtcdDiscoveryDomain(String etcdDiscoveryDomain) {
         this.etcdDiscoveryDomain = etcdDiscoveryDomain;
     }
 
+    /**
+     * imageRegistryBundleData is the ImageRegistryData
+     */
     @JsonProperty("imageRegistryBundleData")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ImageRegistryBundle> getImageRegistryBundleData() {
         return imageRegistryBundleData;
     }
 
+    /**
+     * imageRegistryBundleData is the ImageRegistryData
+     */
     @JsonProperty("imageRegistryBundleData")
     public void setImageRegistryBundleData(List<ImageRegistryBundle> imageRegistryBundleData) {
         this.imageRegistryBundleData = imageRegistryBundleData;
     }
 
+    /**
+     * imageRegistryBundleUserData is Image Registry Data provided by the user
+     */
     @JsonProperty("imageRegistryBundleUserData")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ImageRegistryBundle> getImageRegistryBundleUserData() {
         return imageRegistryBundleUserData;
     }
 
+    /**
+     * imageRegistryBundleUserData is Image Registry Data provided by the user
+     */
     @JsonProperty("imageRegistryBundleUserData")
     public void setImageRegistryBundleUserData(List<ImageRegistryBundle> imageRegistryBundleUserData) {
         this.imageRegistryBundleUserData = imageRegistryBundleUserData;
     }
 
+    /**
+     * images is map of images that are used by the controller to render templates under ./templates/
+     */
     @JsonProperty("images")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getImages() {
         return images;
     }
 
+    /**
+     * images is map of images that are used by the controller to render templates under ./templates/
+     */
     @JsonProperty("images")
     public void setImages(Map<String, String> images) {
         this.images = images;
     }
 
+    /**
+     * ControllerConfigSpec is the spec for ControllerConfig resource.
+     */
     @JsonProperty("infra")
     public Infrastructure getInfra() {
         return infra;
     }
 
+    /**
+     * ControllerConfigSpec is the spec for ControllerConfig resource.
+     */
     @JsonProperty("infra")
     public void setInfra(Infrastructure infra) {
         this.infra = infra;
     }
 
+    /**
+     * internalRegistryPullSecret is the pull secret for the internal registry, used by rpm-ostree to pull images from the internal registry if present
+     */
     @JsonProperty("internalRegistryPullSecret")
     public String getInternalRegistryPullSecret() {
         return internalRegistryPullSecret;
     }
 
+    /**
+     * internalRegistryPullSecret is the pull secret for the internal registry, used by rpm-ostree to pull images from the internal registry if present
+     */
     @JsonProperty("internalRegistryPullSecret")
     public void setInternalRegistryPullSecret(String internalRegistryPullSecret) {
         this.internalRegistryPullSecret = internalRegistryPullSecret;
     }
 
+    /**
+     * ipFamilies indicates the IP families in use by the cluster network
+     */
     @JsonProperty("ipFamilies")
     public String getIpFamilies() {
         return ipFamilies;
     }
 
+    /**
+     * ipFamilies indicates the IP families in use by the cluster network
+     */
     @JsonProperty("ipFamilies")
     public void setIpFamilies(String ipFamilies) {
         this.ipFamilies = ipFamilies;
     }
 
+    /**
+     * kubeAPIServerServingCAData managed Kubelet to API Server Cert... Rotated automatically
+     */
     @JsonProperty("kubeAPIServerServingCAData")
     public String getKubeAPIServerServingCAData() {
         return kubeAPIServerServingCAData;
     }
 
+    /**
+     * kubeAPIServerServingCAData managed Kubelet to API Server Cert... Rotated automatically
+     */
     @JsonProperty("kubeAPIServerServingCAData")
     public void setKubeAPIServerServingCAData(String kubeAPIServerServingCAData) {
         this.kubeAPIServerServingCAData = kubeAPIServerServingCAData;
     }
 
+    /**
+     * ControllerConfigSpec is the spec for ControllerConfig resource.
+     */
     @JsonProperty("network")
     public NetworkInfo getNetwork() {
         return network;
     }
 
+    /**
+     * ControllerConfigSpec is the spec for ControllerConfig resource.
+     */
     @JsonProperty("network")
     public void setNetwork(NetworkInfo network) {
         this.network = network;
     }
 
+    /**
+     * networkType holds the type of network the cluster is using XXX: this is temporary and will be dropped as soon as possible in favor of a better support to start network related services the proper way. Nobody is also changing this once the cluster is up and running the first time, so, disallow regeneration if this changes.
+     */
     @JsonProperty("networkType")
     public String getNetworkType() {
         return networkType;
     }
 
+    /**
+     * networkType holds the type of network the cluster is using XXX: this is temporary and will be dropped as soon as possible in favor of a better support to start network related services the proper way. Nobody is also changing this once the cluster is up and running the first time, so, disallow regeneration if this changes.
+     */
     @JsonProperty("networkType")
     public void setNetworkType(String networkType) {
         this.networkType = networkType;
     }
 
+    /**
+     * OSImageURL is the old-format container image that contains the OS update payload.
+     */
     @JsonProperty("osImageURL")
     public String getOsImageURL() {
         return osImageURL;
     }
 
+    /**
+     * OSImageURL is the old-format container image that contains the OS update payload.
+     */
     @JsonProperty("osImageURL")
     public void setOsImageURL(String osImageURL) {
         this.osImageURL = osImageURL;
     }
 
+    /**
+     * platform is deprecated, use Infra.Status.PlatformStatus.Type instead
+     */
     @JsonProperty("platform")
     public String getPlatform() {
         return platform;
     }
 
+    /**
+     * platform is deprecated, use Infra.Status.PlatformStatus.Type instead
+     */
     @JsonProperty("platform")
     public void setPlatform(String platform) {
         this.platform = platform;
     }
 
+    /**
+     * ControllerConfigSpec is the spec for ControllerConfig resource.
+     */
     @JsonProperty("proxy")
     public ProxyStatus getProxy() {
         return proxy;
     }
 
+    /**
+     * ControllerConfigSpec is the spec for ControllerConfig resource.
+     */
     @JsonProperty("proxy")
     public void setProxy(ProxyStatus proxy) {
         this.proxy = proxy;
     }
 
+    /**
+     * ControllerConfigSpec is the spec for ControllerConfig resource.
+     */
     @JsonProperty("pullSecret")
     public ObjectReference getPullSecret() {
         return pullSecret;
     }
 
+    /**
+     * ControllerConfigSpec is the spec for ControllerConfig resource.
+     */
     @JsonProperty("pullSecret")
     public void setPullSecret(ObjectReference pullSecret) {
         this.pullSecret = pullSecret;
     }
 
+    /**
+     * releaseImage is the image used when installing the cluster
+     */
     @JsonProperty("releaseImage")
     public String getReleaseImage() {
         return releaseImage;
     }
 
+    /**
+     * releaseImage is the image used when installing the cluster
+     */
     @JsonProperty("releaseImage")
     public void setReleaseImage(String releaseImage) {
         this.releaseImage = releaseImage;
     }
 
+    /**
+     * rootCAData specifies the root CA data
+     */
     @JsonProperty("rootCAData")
     public String getRootCAData() {
         return rootCAData;
     }
 
+    /**
+     * rootCAData specifies the root CA data
+     */
     @JsonProperty("rootCAData")
     public void setRootCAData(String rootCAData) {
         this.rootCAData = rootCAData;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ControllerConfigStatus.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ControllerConfigStatus.java
index ab34029afac..15b7e62296d 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ControllerConfigStatus.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ControllerConfigStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ControllerConfigStatus is the status for ControllerConfig
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public ControllerConfigStatus(List<ControllerConfigStatusCondition> conditions,
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * conditions represents the latest available observations of current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ControllerConfigStatusCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions represents the latest available observations of current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ControllerConfigStatusCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * controllerCertificates represents the latest available observations of the automatically rotating certificates in the MCO.
+     */
     @JsonProperty("controllerCertificates")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ControllerCertificate> getControllerCertificates() {
         return controllerCertificates;
     }
 
+    /**
+     * controllerCertificates represents the latest available observations of the automatically rotating certificates in the MCO.
+     */
     @JsonProperty("controllerCertificates")
     public void setControllerCertificates(List<ControllerCertificate> controllerCertificates) {
         this.controllerCertificates = controllerCertificates;
     }
 
+    /**
+     * observedGeneration represents the generation observed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration represents the generation observed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ControllerConfigStatusCondition.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ControllerConfigStatusCondition.java
index c1fd06c2cb9..a2fa107d305 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ControllerConfigStatusCondition.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ControllerConfigStatusCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ControllerConfigStatusCondition contains condition information for ControllerConfigStatus
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public ControllerConfigStatusCondition(String lastTransitionTime, String message
         this.type = type;
     }
 
+    /**
+     * ControllerConfigStatusCondition contains condition information for ControllerConfigStatus
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * ControllerConfigStatusCondition contains condition information for ControllerConfigStatus
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * message provides additional information about the current condition. This is only to be consumed by humans.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message provides additional information about the current condition. This is only to be consumed by humans.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * reason is the reason for the condition's last transition.  Reasons are PascalCase
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * reason is the reason for the condition's last transition.  Reasons are PascalCase
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * type specifies the state of the operator's reconciliation functionality.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type specifies the state of the operator's reconciliation functionality.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ImageRegistryBundle.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ImageRegistryBundle.java
index ca8b4b6a196..a8dd8a26d43 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ImageRegistryBundle.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/ImageRegistryBundle.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageRegistryBundle contains information for writing image registry certificates
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ImageRegistryBundle(String data, String file) {
         this.file = file;
     }
 
+    /**
+     * data holds the contents of the bundle that will be written to the file location
+     */
     @JsonProperty("data")
     public String getData() {
         return data;
     }
 
+    /**
+     * data holds the contents of the bundle that will be written to the file location
+     */
     @JsonProperty("data")
     public void setData(String data) {
         this.data = data;
     }
 
+    /**
+     * file holds the name of the file where the bundle will be written to disk
+     */
     @JsonProperty("file")
     public String getFile() {
         return file;
     }
 
+    /**
+     * file holds the name of the file where the bundle will be written to disk
+     */
     @JsonProperty("file")
     public void setFile(String file) {
         this.file = file;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/KubeletConfig.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/KubeletConfig.java
index c930ce69065..02bf423d1c9 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/KubeletConfig.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/KubeletConfig.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KubeletConfig describes a customized Kubelet configuration.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class KubeletConfig implements Editable<KubeletConfigBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machineconfiguration.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KubeletConfig";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public KubeletConfig(String apiVersion, String kind, ObjectMeta metadata, Kubele
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KubeletConfig describes a customized Kubelet configuration.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KubeletConfig describes a customized Kubelet configuration.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * KubeletConfig describes a customized Kubelet configuration.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public KubeletConfigSpec getSpec() {
         return spec;
     }
 
+    /**
+     * KubeletConfig describes a customized Kubelet configuration.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(KubeletConfigSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * KubeletConfig describes a customized Kubelet configuration.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public KubeletConfigStatus getStatus() {
         return status;
     }
 
+    /**
+     * KubeletConfig describes a customized Kubelet configuration.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(KubeletConfigStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/KubeletConfigCondition.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/KubeletConfigCondition.java
index 3781d6cbf88..ee58d6b091e 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/KubeletConfigCondition.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/KubeletConfigCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KubeletConfigCondition defines the state of the KubeletConfig
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public KubeletConfigCondition(String lastTransitionTime, String message, String
         this.type = type;
     }
 
+    /**
+     * KubeletConfigCondition defines the state of the KubeletConfig
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * KubeletConfigCondition defines the state of the KubeletConfig
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * message provides additional information about the current condition. This is only to be consumed by humans.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message provides additional information about the current condition. This is only to be consumed by humans.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * reason is the reason for the condition's last transition.  Reasons are PascalCase
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * reason is the reason for the condition's last transition.  Reasons are PascalCase
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * type specifies the state of the operator's reconciliation functionality.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type specifies the state of the operator's reconciliation functionality.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/KubeletConfigList.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/KubeletConfigList.java
index e0f5c91c20e..40353d8bd12 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/KubeletConfigList.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/KubeletConfigList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KubeletConfigList is a list of KubeletConfig resources<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class KubeletConfigList implements Editable<KubeletConfigListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.machineconfiguration.v1.KubeletConfig>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machineconfiguration.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.machineconfiguration.v1.KubeletConfig> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KubeletConfigList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public KubeletConfigList(String apiVersion, List<io.fabric8.openshift.api.model.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * KubeletConfigList is a list of KubeletConfig resources<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.machineconfiguration.v1.KubeletConfig> getItems() {
         return items;
     }
 
+    /**
+     * KubeletConfigList is a list of KubeletConfig resources<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.machineconfiguration.v1.KubeletConfig> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KubeletConfigList is a list of KubeletConfig resources<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KubeletConfigList is a list of KubeletConfig resources<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/KubeletConfigSpec.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/KubeletConfigSpec.java
index 76dc620f6d5..fb5fa7ce95a 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/KubeletConfigSpec.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/KubeletConfigSpec.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KubeletConfigSpec defines the desired state of KubeletConfig
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -96,52 +99,82 @@ public KubeletConfigSpec(Boolean autoSizingReserved, Object kubeletConfig, Integ
         this.tlsSecurityProfile = tlsSecurityProfile;
     }
 
+    /**
+     * KubeletConfigSpec defines the desired state of KubeletConfig
+     */
     @JsonProperty("autoSizingReserved")
     public Boolean getAutoSizingReserved() {
         return autoSizingReserved;
     }
 
+    /**
+     * KubeletConfigSpec defines the desired state of KubeletConfig
+     */
     @JsonProperty("autoSizingReserved")
     public void setAutoSizingReserved(Boolean autoSizingReserved) {
         this.autoSizingReserved = autoSizingReserved;
     }
 
+    /**
+     * KubeletConfigSpec defines the desired state of KubeletConfig
+     */
     @JsonProperty("kubeletConfig")
     public Object getKubeletConfig() {
         return kubeletConfig;
     }
 
+    /**
+     * KubeletConfigSpec defines the desired state of KubeletConfig
+     */
     @JsonProperty("kubeletConfig")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setKubeletConfig(Object kubeletConfig) {
         this.kubeletConfig = kubeletConfig;
     }
 
+    /**
+     * KubeletConfigSpec defines the desired state of KubeletConfig
+     */
     @JsonProperty("logLevel")
     public Integer getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * KubeletConfigSpec defines the desired state of KubeletConfig
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(Integer logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * KubeletConfigSpec defines the desired state of KubeletConfig
+     */
     @JsonProperty("machineConfigPoolSelector")
     public LabelSelector getMachineConfigPoolSelector() {
         return machineConfigPoolSelector;
     }
 
+    /**
+     * KubeletConfigSpec defines the desired state of KubeletConfig
+     */
     @JsonProperty("machineConfigPoolSelector")
     public void setMachineConfigPoolSelector(LabelSelector machineConfigPoolSelector) {
         this.machineConfigPoolSelector = machineConfigPoolSelector;
     }
 
+    /**
+     * KubeletConfigSpec defines the desired state of KubeletConfig
+     */
     @JsonProperty("tlsSecurityProfile")
     public TLSSecurityProfile getTlsSecurityProfile() {
         return tlsSecurityProfile;
     }
 
+    /**
+     * KubeletConfigSpec defines the desired state of KubeletConfig
+     */
     @JsonProperty("tlsSecurityProfile")
     public void setTlsSecurityProfile(TLSSecurityProfile tlsSecurityProfile) {
         this.tlsSecurityProfile = tlsSecurityProfile;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/KubeletConfigStatus.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/KubeletConfigStatus.java
index 40688795b39..66512a18bbe 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/KubeletConfigStatus.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/KubeletConfigStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KubeletConfigStatus defines the observed state of a KubeletConfig
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public KubeletConfigStatus(List<KubeletConfigCondition> conditions, Long observe
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * conditions represents the latest available observations of current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<KubeletConfigCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions represents the latest available observations of current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<KubeletConfigCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * observedGeneration represents the generation observed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration represents the generation observed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfig.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfig.java
index 1de18546c4a..b0164867be2 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfig.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfig.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineConfig defines the configuration for a machine<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class MachineConfig implements Editable<MachineConfigBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machineconfiguration.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MachineConfig";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public MachineConfig(String apiVersion, String kind, ObjectMeta metadata, Machin
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MachineConfig defines the configuration for a machine<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MachineConfig defines the configuration for a machine<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * MachineConfig defines the configuration for a machine<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public MachineConfigSpec getSpec() {
         return spec;
     }
 
+    /**
+     * MachineConfig defines the configuration for a machine<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(MachineConfigSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigList.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigList.java
index 10e8044eb1f..5a346b04a4d 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigList.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineConfigList is a list of MachineConfig resources<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class MachineConfigList implements Editable<MachineConfigListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.machineconfiguration.v1.MachineConfig>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machineconfiguration.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.machineconfiguration.v1.MachineConfig> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MachineConfigList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public MachineConfigList(String apiVersion, List<io.fabric8.openshift.api.model.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * MachineConfigList is a list of MachineConfig resources<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.machineconfiguration.v1.MachineConfig> getItems() {
         return items;
     }
 
+    /**
+     * MachineConfigList is a list of MachineConfig resources<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.machineconfiguration.v1.MachineConfig> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MachineConfigList is a list of MachineConfig resources<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MachineConfigList is a list of MachineConfig resources<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigPool.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigPool.java
index 10488c86b38..ed10b08280e 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigPool.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigPool.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineConfigPool describes a pool of MachineConfigs.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class MachineConfigPool implements Editable<MachineConfigPoolBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machineconfiguration.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MachineConfigPool";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public MachineConfigPool(String apiVersion, String kind, ObjectMeta metadata, Ma
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MachineConfigPool describes a pool of MachineConfigs.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MachineConfigPool describes a pool of MachineConfigs.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * MachineConfigPool describes a pool of MachineConfigs.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public MachineConfigPoolSpec getSpec() {
         return spec;
     }
 
+    /**
+     * MachineConfigPool describes a pool of MachineConfigs.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(MachineConfigPoolSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * MachineConfigPool describes a pool of MachineConfigs.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public MachineConfigPoolStatus getStatus() {
         return status;
     }
 
+    /**
+     * MachineConfigPool describes a pool of MachineConfigs.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(MachineConfigPoolStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigPoolCondition.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigPoolCondition.java
index 3347df86ec9..bffcb3cbda6 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigPoolCondition.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigPoolCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineConfigPoolCondition contains condition information for an MachineConfigPool.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public MachineConfigPoolCondition(String lastTransitionTime, String message, Str
         this.type = type;
     }
 
+    /**
+     * MachineConfigPoolCondition contains condition information for an MachineConfigPool.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * MachineConfigPoolCondition contains condition information for an MachineConfigPool.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * message is a human readable description of the details of the last transition, complementing reason.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message is a human readable description of the details of the last transition, complementing reason.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * reason is a brief machine readable explanation for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * reason is a brief machine readable explanation for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * status of the condition, one of ('True', 'False', 'Unknown').
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * status of the condition, one of ('True', 'False', 'Unknown').
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * type of the condition, currently ('Done', 'Updating', 'Failed').
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type of the condition, currently ('Done', 'Updating', 'Failed').
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigPoolList.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigPoolList.java
index c0dc981caac..18b49e64b85 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigPoolList.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigPoolList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineConfigPoolList is a list of MachineConfigPool resources<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class MachineConfigPoolList implements Editable<MachineConfigPoolListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.machineconfiguration.v1.MachineConfigPool>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machineconfiguration.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.machineconfiguration.v1.MachineConfigPool> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MachineConfigPoolList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public MachineConfigPoolList(String apiVersion, List<io.fabric8.openshift.api.mo
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * MachineConfigPoolList is a list of MachineConfigPool resources<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.machineconfiguration.v1.MachineConfigPool> getItems() {
         return items;
     }
 
+    /**
+     * MachineConfigPoolList is a list of MachineConfigPool resources<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.machineconfiguration.v1.MachineConfigPool> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MachineConfigPoolList is a list of MachineConfigPool resources<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MachineConfigPoolList is a list of MachineConfigPool resources<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigPoolSpec.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigPoolSpec.java
index 4b8daca2776..d8f6ef866e1 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigPoolSpec.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigPoolSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineConfigPoolSpec is the spec for MachineConfigPool resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,62 +104,98 @@ public MachineConfigPoolSpec(MachineConfigPoolStatusConfiguration configuration,
         this.pinnedImageSets = pinnedImageSets;
     }
 
+    /**
+     * MachineConfigPoolSpec is the spec for MachineConfigPool resource.
+     */
     @JsonProperty("configuration")
     public MachineConfigPoolStatusConfiguration getConfiguration() {
         return configuration;
     }
 
+    /**
+     * MachineConfigPoolSpec is the spec for MachineConfigPool resource.
+     */
     @JsonProperty("configuration")
     public void setConfiguration(MachineConfigPoolStatusConfiguration configuration) {
         this.configuration = configuration;
     }
 
+    /**
+     * MachineConfigPoolSpec is the spec for MachineConfigPool resource.
+     */
     @JsonProperty("machineConfigSelector")
     public LabelSelector getMachineConfigSelector() {
         return machineConfigSelector;
     }
 
+    /**
+     * MachineConfigPoolSpec is the spec for MachineConfigPool resource.
+     */
     @JsonProperty("machineConfigSelector")
     public void setMachineConfigSelector(LabelSelector machineConfigSelector) {
         this.machineConfigSelector = machineConfigSelector;
     }
 
+    /**
+     * MachineConfigPoolSpec is the spec for MachineConfigPool resource.
+     */
     @JsonProperty("maxUnavailable")
     public IntOrString getMaxUnavailable() {
         return maxUnavailable;
     }
 
+    /**
+     * MachineConfigPoolSpec is the spec for MachineConfigPool resource.
+     */
     @JsonProperty("maxUnavailable")
     public void setMaxUnavailable(IntOrString maxUnavailable) {
         this.maxUnavailable = maxUnavailable;
     }
 
+    /**
+     * MachineConfigPoolSpec is the spec for MachineConfigPool resource.
+     */
     @JsonProperty("nodeSelector")
     public LabelSelector getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * MachineConfigPoolSpec is the spec for MachineConfigPool resource.
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(LabelSelector nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * paused specifies whether or not changes to this machine config pool should be stopped. This includes generating new desiredMachineConfig and update of machines.
+     */
     @JsonProperty("paused")
     public Boolean getPaused() {
         return paused;
     }
 
+    /**
+     * paused specifies whether or not changes to this machine config pool should be stopped. This includes generating new desiredMachineConfig and update of machines.
+     */
     @JsonProperty("paused")
     public void setPaused(Boolean paused) {
         this.paused = paused;
     }
 
+    /**
+     * pinnedImageSets specifies a sequence of PinnedImageSetRef objects for the pool. Nodes within this pool will preload and pin images defined in the PinnedImageSet. Before pulling images the MachineConfigDaemon will ensure the total uncompressed size of all the images does not exceed available resources. If the total size of the images exceeds the available resources the controller will report a Degraded status to the MachineConfigPool and not attempt to pull any images. Also to help ensure the kubelet can mitigate storage risk, the pinned_image configuration and subsequent service reload will happen only after all of the images have been pulled for each set. Images from multiple PinnedImageSets are loaded and pinned sequentially as listed. Duplicate and existing images will be skipped.<br><p> <br><p> Any failure to prefetch or pin images will result in a Degraded pool. Resolving these failures is the responsibility of the user. The admin should be proactive in ensuring adequate storage and proper image authentication exists in advance.
+     */
     @JsonProperty("pinnedImageSets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PinnedImageSetRef> getPinnedImageSets() {
         return pinnedImageSets;
     }
 
+    /**
+     * pinnedImageSets specifies a sequence of PinnedImageSetRef objects for the pool. Nodes within this pool will preload and pin images defined in the PinnedImageSet. Before pulling images the MachineConfigDaemon will ensure the total uncompressed size of all the images does not exceed available resources. If the total size of the images exceeds the available resources the controller will report a Degraded status to the MachineConfigPool and not attempt to pull any images. Also to help ensure the kubelet can mitigate storage risk, the pinned_image configuration and subsequent service reload will happen only after all of the images have been pulled for each set. Images from multiple PinnedImageSets are loaded and pinned sequentially as listed. Duplicate and existing images will be skipped.<br><p> <br><p> Any failure to prefetch or pin images will result in a Degraded pool. Resolving these failures is the responsibility of the user. The admin should be proactive in ensuring adequate storage and proper image authentication exists in advance.
+     */
     @JsonProperty("pinnedImageSets")
     public void setPinnedImageSets(List<PinnedImageSetRef> pinnedImageSets) {
         this.pinnedImageSets = pinnedImageSets;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigPoolStatus.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigPoolStatus.java
index 144502bd46a..954139bec8c 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigPoolStatus.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigPoolStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineConfigPoolStatus is the status for MachineConfigPool resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -119,104 +122,164 @@ public MachineConfigPoolStatus(List<CertExpiry> certExpirys, List<MachineConfigP
         this.updatedMachineCount = updatedMachineCount;
     }
 
+    /**
+     * certExpirys keeps track of important certificate expiration data
+     */
     @JsonProperty("certExpirys")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CertExpiry> getCertExpirys() {
         return certExpirys;
     }
 
+    /**
+     * certExpirys keeps track of important certificate expiration data
+     */
     @JsonProperty("certExpirys")
     public void setCertExpirys(List<CertExpiry> certExpirys) {
         this.certExpirys = certExpirys;
     }
 
+    /**
+     * conditions represents the latest available observations of current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MachineConfigPoolCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions represents the latest available observations of current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<MachineConfigPoolCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * MachineConfigPoolStatus is the status for MachineConfigPool resource.
+     */
     @JsonProperty("configuration")
     public MachineConfigPoolStatusConfiguration getConfiguration() {
         return configuration;
     }
 
+    /**
+     * MachineConfigPoolStatus is the status for MachineConfigPool resource.
+     */
     @JsonProperty("configuration")
     public void setConfiguration(MachineConfigPoolStatusConfiguration configuration) {
         this.configuration = configuration;
     }
 
+    /**
+     * degradedMachineCount represents the total number of machines marked degraded (or unreconcilable). A node is marked degraded if applying a configuration failed..
+     */
     @JsonProperty("degradedMachineCount")
     public Integer getDegradedMachineCount() {
         return degradedMachineCount;
     }
 
+    /**
+     * degradedMachineCount represents the total number of machines marked degraded (or unreconcilable). A node is marked degraded if applying a configuration failed..
+     */
     @JsonProperty("degradedMachineCount")
     public void setDegradedMachineCount(Integer degradedMachineCount) {
         this.degradedMachineCount = degradedMachineCount;
     }
 
+    /**
+     * machineCount represents the total number of machines in the machine config pool.
+     */
     @JsonProperty("machineCount")
     public Integer getMachineCount() {
         return machineCount;
     }
 
+    /**
+     * machineCount represents the total number of machines in the machine config pool.
+     */
     @JsonProperty("machineCount")
     public void setMachineCount(Integer machineCount) {
         this.machineCount = machineCount;
     }
 
+    /**
+     * observedGeneration represents the generation observed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration represents the generation observed by the controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * poolSynchronizersStatus is the status of the machines managed by the pool synchronizers.
+     */
     @JsonProperty("poolSynchronizersStatus")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PoolSynchronizerStatus> getPoolSynchronizersStatus() {
         return poolSynchronizersStatus;
     }
 
+    /**
+     * poolSynchronizersStatus is the status of the machines managed by the pool synchronizers.
+     */
     @JsonProperty("poolSynchronizersStatus")
     public void setPoolSynchronizersStatus(List<PoolSynchronizerStatus> poolSynchronizersStatus) {
         this.poolSynchronizersStatus = poolSynchronizersStatus;
     }
 
+    /**
+     * readyMachineCount represents the total number of ready machines targeted by the pool.
+     */
     @JsonProperty("readyMachineCount")
     public Integer getReadyMachineCount() {
         return readyMachineCount;
     }
 
+    /**
+     * readyMachineCount represents the total number of ready machines targeted by the pool.
+     */
     @JsonProperty("readyMachineCount")
     public void setReadyMachineCount(Integer readyMachineCount) {
         this.readyMachineCount = readyMachineCount;
     }
 
+    /**
+     * unavailableMachineCount represents the total number of unavailable (non-ready) machines targeted by the pool. A node is marked unavailable if it is in updating state or NodeReady condition is false.
+     */
     @JsonProperty("unavailableMachineCount")
     public Integer getUnavailableMachineCount() {
         return unavailableMachineCount;
     }
 
+    /**
+     * unavailableMachineCount represents the total number of unavailable (non-ready) machines targeted by the pool. A node is marked unavailable if it is in updating state or NodeReady condition is false.
+     */
     @JsonProperty("unavailableMachineCount")
     public void setUnavailableMachineCount(Integer unavailableMachineCount) {
         this.unavailableMachineCount = unavailableMachineCount;
     }
 
+    /**
+     * updatedMachineCount represents the total number of machines targeted by the pool that have the CurrentMachineConfig as their config.
+     */
     @JsonProperty("updatedMachineCount")
     public Integer getUpdatedMachineCount() {
         return updatedMachineCount;
     }
 
+    /**
+     * updatedMachineCount represents the total number of machines targeted by the pool that have the CurrentMachineConfig as their config.
+     */
     @JsonProperty("updatedMachineCount")
     public void setUpdatedMachineCount(Integer updatedMachineCount) {
         this.updatedMachineCount = updatedMachineCount;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigPoolStatusConfiguration.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigPoolStatusConfiguration.java
index 324daadab59..46a5cb08ddc 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigPoolStatusConfiguration.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigPoolStatusConfiguration.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineConfigPoolStatusConfiguration stores the current configuration for the pool, and optionally also stores the list of MachineConfig objects used to generate the configuration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -109,82 +112,130 @@ public MachineConfigPoolStatusConfiguration(String apiVersion, String fieldPath,
         this.uid = uid;
     }
 
+    /**
+     * API version of the referent.
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * API version of the referent.
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * If referring to a piece of an object instead of an entire object, this string should contain a valid JSON/Go field access statement, such as desiredState.manifest.containers[2]. For example, if the object reference is to a container within a pod, this would take on a value like: "spec.containers{name}" (where "name" refers to the name of the container that triggered the event) or if no container name is specified "spec.containers[2]" (container with index 2 in this pod). This syntax is chosen only to have some well-defined way of referencing a part of an object.
+     */
     @JsonProperty("fieldPath")
     public String getFieldPath() {
         return fieldPath;
     }
 
+    /**
+     * If referring to a piece of an object instead of an entire object, this string should contain a valid JSON/Go field access statement, such as desiredState.manifest.containers[2]. For example, if the object reference is to a container within a pod, this would take on a value like: "spec.containers{name}" (where "name" refers to the name of the container that triggered the event) or if no container name is specified "spec.containers[2]" (container with index 2 in this pod). This syntax is chosen only to have some well-defined way of referencing a part of an object.
+     */
     @JsonProperty("fieldPath")
     public void setFieldPath(String fieldPath) {
         this.fieldPath = fieldPath;
     }
 
+    /**
+     * Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Specific resourceVersion to which this reference is made, if any. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency
+     */
     @JsonProperty("resourceVersion")
     public String getResourceVersion() {
         return resourceVersion;
     }
 
+    /**
+     * Specific resourceVersion to which this reference is made, if any. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency
+     */
     @JsonProperty("resourceVersion")
     public void setResourceVersion(String resourceVersion) {
         this.resourceVersion = resourceVersion;
     }
 
+    /**
+     * source is the list of MachineConfig objects that were used to generate the single MachineConfig object specified in `content`.
+     */
     @JsonProperty("source")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ObjectReference> getSource() {
         return source;
     }
 
+    /**
+     * source is the list of MachineConfig objects that were used to generate the single MachineConfig object specified in `content`.
+     */
     @JsonProperty("source")
     public void setSource(List<ObjectReference> source) {
         this.source = source;
     }
 
+    /**
+     * UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids
+     */
     @JsonProperty("uid")
     public String getUid() {
         return uid;
     }
 
+    /**
+     * UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids
+     */
     @JsonProperty("uid")
     public void setUid(String uid) {
         this.uid = uid;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigSpec.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigSpec.java
index b2516288eb6..3fb0b57a4d9 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigSpec.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/MachineConfigSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineConfigSpec is the spec for MachineConfig
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -107,74 +110,116 @@ public MachineConfigSpec(String baseOSExtensionsContainerImage, Object config, L
         this.osImageURL = osImageURL;
     }
 
+    /**
+     * BaseOSExtensionsContainerImage specifies the remote location that will be used to fetch the extensions container matching a new-format OS image
+     */
     @JsonProperty("baseOSExtensionsContainerImage")
     public String getBaseOSExtensionsContainerImage() {
         return baseOSExtensionsContainerImage;
     }
 
+    /**
+     * BaseOSExtensionsContainerImage specifies the remote location that will be used to fetch the extensions container matching a new-format OS image
+     */
     @JsonProperty("baseOSExtensionsContainerImage")
     public void setBaseOSExtensionsContainerImage(String baseOSExtensionsContainerImage) {
         this.baseOSExtensionsContainerImage = baseOSExtensionsContainerImage;
     }
 
+    /**
+     * MachineConfigSpec is the spec for MachineConfig
+     */
     @JsonProperty("config")
     public Object getConfig() {
         return config;
     }
 
+    /**
+     * MachineConfigSpec is the spec for MachineConfig
+     */
     @JsonProperty("config")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setConfig(Object config) {
         this.config = config;
     }
 
+    /**
+     * extensions contains a list of additional features that can be enabled on host
+     */
     @JsonProperty("extensions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getExtensions() {
         return extensions;
     }
 
+    /**
+     * extensions contains a list of additional features that can be enabled on host
+     */
     @JsonProperty("extensions")
     public void setExtensions(List<String> extensions) {
         this.extensions = extensions;
     }
 
+    /**
+     * fips controls FIPS mode
+     */
     @JsonProperty("fips")
     public Boolean getFips() {
         return fips;
     }
 
+    /**
+     * fips controls FIPS mode
+     */
     @JsonProperty("fips")
     public void setFips(Boolean fips) {
         this.fips = fips;
     }
 
+    /**
+     * kernelArguments contains a list of kernel arguments to be added
+     */
     @JsonProperty("kernelArguments")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getKernelArguments() {
         return kernelArguments;
     }
 
+    /**
+     * kernelArguments contains a list of kernel arguments to be added
+     */
     @JsonProperty("kernelArguments")
     public void setKernelArguments(List<String> kernelArguments) {
         this.kernelArguments = kernelArguments;
     }
 
+    /**
+     * kernelType contains which kernel we want to be running like default (traditional), realtime, 64k-pages (aarch64 only).
+     */
     @JsonProperty("kernelType")
     public String getKernelType() {
         return kernelType;
     }
 
+    /**
+     * kernelType contains which kernel we want to be running like default (traditional), realtime, 64k-pages (aarch64 only).
+     */
     @JsonProperty("kernelType")
     public void setKernelType(String kernelType) {
         this.kernelType = kernelType;
     }
 
+    /**
+     * OSImageURL specifies the remote location that will be used to fetch the OS.
+     */
     @JsonProperty("osImageURL")
     public String getOsImageURL() {
         return osImageURL;
     }
 
+    /**
+     * OSImageURL specifies the remote location that will be used to fetch the OS.
+     */
     @JsonProperty("osImageURL")
     public void setOsImageURL(String osImageURL) {
         this.osImageURL = osImageURL;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/NetworkInfo.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/NetworkInfo.java
index 3d1ee923779..5b7fb9a8b38 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/NetworkInfo.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/NetworkInfo.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Network contains network related configuration
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,11 +82,17 @@ public NetworkInfo(MTUMigration mtuMigration) {
         this.mtuMigration = mtuMigration;
     }
 
+    /**
+     * Network contains network related configuration
+     */
     @JsonProperty("mtuMigration")
     public MTUMigration getMtuMigration() {
         return mtuMigration;
     }
 
+    /**
+     * Network contains network related configuration
+     */
     @JsonProperty("mtuMigration")
     public void setMtuMigration(MTUMigration mtuMigration) {
         this.mtuMigration = mtuMigration;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/PinnedImageSetRef.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/PinnedImageSetRef.java
index 62e1cabc9c1..a6ea3d16d18 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/PinnedImageSetRef.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/PinnedImageSetRef.java
@@ -78,11 +78,17 @@ public PinnedImageSetRef(String name) {
         this.name = name;
     }
 
+    /**
+     * name is a reference to the name of a PinnedImageSet.  Must adhere to RFC-1123 (https://tools.ietf.org/html/rfc1123). Made up of one of more period-separated (.) segments, where each segment consists of alphanumeric characters and hyphens (-), must begin and end with an alphanumeric character, and is at most 63 characters in length. The total length of the name must not exceed 253 characters.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is a reference to the name of a PinnedImageSet.  Must adhere to RFC-1123 (https://tools.ietf.org/html/rfc1123). Made up of one of more period-separated (.) segments, where each segment consists of alphanumeric characters and hyphens (-), must begin and end with an alphanumeric character, and is at most 63 characters in length. The total length of the name must not exceed 253 characters.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/PoolSynchronizerStatus.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/PoolSynchronizerStatus.java
index 7a602fb0ca7..e310ae7918c 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/PoolSynchronizerStatus.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1/PoolSynchronizerStatus.java
@@ -102,71 +102,113 @@ public PoolSynchronizerStatus(Long availableMachineCount, Long machineCount, Lon
         this.updatedMachineCount = updatedMachineCount;
     }
 
+    /**
+     * availableMachineCount is the number of machines managed by the node synchronizer which are available.
+     */
     @JsonProperty("availableMachineCount")
     public Long getAvailableMachineCount() {
         return availableMachineCount;
     }
 
+    /**
+     * availableMachineCount is the number of machines managed by the node synchronizer which are available.
+     */
     @JsonProperty("availableMachineCount")
     public void setAvailableMachineCount(Long availableMachineCount) {
         this.availableMachineCount = availableMachineCount;
     }
 
+    /**
+     * machineCount is the number of machines that are managed by the node synchronizer.
+     */
     @JsonProperty("machineCount")
     public Long getMachineCount() {
         return machineCount;
     }
 
+    /**
+     * machineCount is the number of machines that are managed by the node synchronizer.
+     */
     @JsonProperty("machineCount")
     public void setMachineCount(Long machineCount) {
         this.machineCount = machineCount;
     }
 
+    /**
+     * observedGeneration is the last generation change that has been applied.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change that has been applied.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * poolSynchronizerType describes the type of the pool synchronizer.
+     */
     @JsonProperty("poolSynchronizerType")
     public String getPoolSynchronizerType() {
         return poolSynchronizerType;
     }
 
+    /**
+     * poolSynchronizerType describes the type of the pool synchronizer.
+     */
     @JsonProperty("poolSynchronizerType")
     public void setPoolSynchronizerType(String poolSynchronizerType) {
         this.poolSynchronizerType = poolSynchronizerType;
     }
 
+    /**
+     * readyMachineCount is the number of machines managed by the node synchronizer that are in a ready state.
+     */
     @JsonProperty("readyMachineCount")
     public Long getReadyMachineCount() {
         return readyMachineCount;
     }
 
+    /**
+     * readyMachineCount is the number of machines managed by the node synchronizer that are in a ready state.
+     */
     @JsonProperty("readyMachineCount")
     public void setReadyMachineCount(Long readyMachineCount) {
         this.readyMachineCount = readyMachineCount;
     }
 
+    /**
+     * unavailableMachineCount is the number of machines managed by the node synchronizer but are unavailable.
+     */
     @JsonProperty("unavailableMachineCount")
     public Long getUnavailableMachineCount() {
         return unavailableMachineCount;
     }
 
+    /**
+     * unavailableMachineCount is the number of machines managed by the node synchronizer but are unavailable.
+     */
     @JsonProperty("unavailableMachineCount")
     public void setUnavailableMachineCount(Long unavailableMachineCount) {
         this.unavailableMachineCount = unavailableMachineCount;
     }
 
+    /**
+     * updatedMachineCount is the number of machines that have been updated by the node synchronizer.
+     */
     @JsonProperty("updatedMachineCount")
     public Long getUpdatedMachineCount() {
         return updatedMachineCount;
     }
 
+    /**
+     * updatedMachineCount is the number of machines that have been updated by the node synchronizer.
+     */
     @JsonProperty("updatedMachineCount")
     public void setUpdatedMachineCount(Long updatedMachineCount) {
         this.updatedMachineCount = updatedMachineCount;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/BuildInputs.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/BuildInputs.java
index 3def7aec1c0..b2b8e17d220 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/BuildInputs.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/BuildInputs.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BuildInputs holds all of the information needed to trigger a build
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -109,82 +112,130 @@ public BuildInputs(ImageSecretObjectReference baseImagePullSecret, String baseOS
         this.renderedImagePushspec = renderedImagePushspec;
     }
 
+    /**
+     * BuildInputs holds all of the information needed to trigger a build
+     */
     @JsonProperty("baseImagePullSecret")
     public ImageSecretObjectReference getBaseImagePullSecret() {
         return baseImagePullSecret;
     }
 
+    /**
+     * BuildInputs holds all of the information needed to trigger a build
+     */
     @JsonProperty("baseImagePullSecret")
     public void setBaseImagePullSecret(ImageSecretObjectReference baseImagePullSecret) {
         this.baseImagePullSecret = baseImagePullSecret;
     }
 
+    /**
+     * baseOSExtensionsImagePullspec is the base Extensions image used in the build process the MachineOSConfig object will use the in cluster image registry configuration. if you wish to use a mirror or any other settings specific to registries.conf, please specify those in the cluster wide registries.conf. The format of the image pullspec is: host[:port][/namespace]/name@sha256:&lt;digest&gt;
+     */
     @JsonProperty("baseOSExtensionsImagePullspec")
     public String getBaseOSExtensionsImagePullspec() {
         return baseOSExtensionsImagePullspec;
     }
 
+    /**
+     * baseOSExtensionsImagePullspec is the base Extensions image used in the build process the MachineOSConfig object will use the in cluster image registry configuration. if you wish to use a mirror or any other settings specific to registries.conf, please specify those in the cluster wide registries.conf. The format of the image pullspec is: host[:port][/namespace]/name@sha256:&lt;digest&gt;
+     */
     @JsonProperty("baseOSExtensionsImagePullspec")
     public void setBaseOSExtensionsImagePullspec(String baseOSExtensionsImagePullspec) {
         this.baseOSExtensionsImagePullspec = baseOSExtensionsImagePullspec;
     }
 
+    /**
+     * baseOSImagePullspec is the base OSImage we use to build our custom image. the MachineOSConfig object will use the in cluster image registry configuration. if you wish to use a mirror or any other settings specific to registries.conf, please specify those in the cluster wide registries.conf. The format of the image pullspec is: host[:port][/namespace]/name@sha256:&lt;digest&gt;
+     */
     @JsonProperty("baseOSImagePullspec")
     public String getBaseOSImagePullspec() {
         return baseOSImagePullspec;
     }
 
+    /**
+     * baseOSImagePullspec is the base OSImage we use to build our custom image. the MachineOSConfig object will use the in cluster image registry configuration. if you wish to use a mirror or any other settings specific to registries.conf, please specify those in the cluster wide registries.conf. The format of the image pullspec is: host[:port][/namespace]/name@sha256:&lt;digest&gt;
+     */
     @JsonProperty("baseOSImagePullspec")
     public void setBaseOSImagePullspec(String baseOSImagePullspec) {
         this.baseOSImagePullspec = baseOSImagePullspec;
     }
 
+    /**
+     * containerFile describes the custom data the user has specified to build into the image. this is also commonly called a Dockerfile and you can treat it as such. The content is the content of your Dockerfile.
+     */
     @JsonProperty("containerFile")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MachineOSContainerfile> getContainerFile() {
         return containerFile;
     }
 
+    /**
+     * containerFile describes the custom data the user has specified to build into the image. this is also commonly called a Dockerfile and you can treat it as such. The content is the content of your Dockerfile.
+     */
     @JsonProperty("containerFile")
     public void setContainerFile(List<MachineOSContainerfile> containerFile) {
         this.containerFile = containerFile;
     }
 
+    /**
+     * BuildInputs holds all of the information needed to trigger a build
+     */
     @JsonProperty("imageBuilder")
     public MachineOSImageBuilder getImageBuilder() {
         return imageBuilder;
     }
 
+    /**
+     * BuildInputs holds all of the information needed to trigger a build
+     */
     @JsonProperty("imageBuilder")
     public void setImageBuilder(MachineOSImageBuilder imageBuilder) {
         this.imageBuilder = imageBuilder;
     }
 
+    /**
+     * releaseVersion is associated with the base OS Image. This is the version of Openshift that the Base Image is associated with. This field is populated from the machine-config-osimageurl configmap in the openshift-machine-config-operator namespace. It will come in the format: 4.16.0-0.nightly-2024-04-03-065948 or any valid release. The MachineOSBuilder populates this field and validates that this is a valid stream. This is used as a label in the dockerfile that builds the OS image.
+     */
     @JsonProperty("releaseVersion")
     public String getReleaseVersion() {
         return releaseVersion;
     }
 
+    /**
+     * releaseVersion is associated with the base OS Image. This is the version of Openshift that the Base Image is associated with. This field is populated from the machine-config-osimageurl configmap in the openshift-machine-config-operator namespace. It will come in the format: 4.16.0-0.nightly-2024-04-03-065948 or any valid release. The MachineOSBuilder populates this field and validates that this is a valid stream. This is used as a label in the dockerfile that builds the OS image.
+     */
     @JsonProperty("releaseVersion")
     public void setReleaseVersion(String releaseVersion) {
         this.releaseVersion = releaseVersion;
     }
 
+    /**
+     * BuildInputs holds all of the information needed to trigger a build
+     */
     @JsonProperty("renderedImagePushSecret")
     public ImageSecretObjectReference getRenderedImagePushSecret() {
         return renderedImagePushSecret;
     }
 
+    /**
+     * BuildInputs holds all of the information needed to trigger a build
+     */
     @JsonProperty("renderedImagePushSecret")
     public void setRenderedImagePushSecret(ImageSecretObjectReference renderedImagePushSecret) {
         this.renderedImagePushSecret = renderedImagePushSecret;
     }
 
+    /**
+     * renderedImagePushspec describes the location of the final image. the MachineOSConfig object will use the in cluster image registry configuration. if you wish to use a mirror or any other settings specific to registries.conf, please specify those in the cluster wide registries.conf. The format of the image pushspec is: host[:port][/namespace]/name:&lt;tag&gt; or svc_name.namespace.svc[:port]/repository/name:&lt;tag&gt;
+     */
     @JsonProperty("renderedImagePushspec")
     public String getRenderedImagePushspec() {
         return renderedImagePushspec;
     }
 
+    /**
+     * renderedImagePushspec describes the location of the final image. the MachineOSConfig object will use the in cluster image registry configuration. if you wish to use a mirror or any other settings specific to registries.conf, please specify those in the cluster wide registries.conf. The format of the image pushspec is: host[:port][/namespace]/name:&lt;tag&gt; or svc_name.namespace.svc[:port]/repository/name:&lt;tag&gt;
+     */
     @JsonProperty("renderedImagePushspec")
     public void setRenderedImagePushspec(String renderedImagePushspec) {
         this.renderedImagePushspec = renderedImagePushspec;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/BuildOutputs.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/BuildOutputs.java
index 88dfefe6344..4c89907766b 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/BuildOutputs.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/BuildOutputs.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BuildOutputs holds all information needed to handle booting the image after a build
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public BuildOutputs(ImageSecretObjectReference currentImagePullSecret) {
         this.currentImagePullSecret = currentImagePullSecret;
     }
 
+    /**
+     * BuildOutputs holds all information needed to handle booting the image after a build
+     */
     @JsonProperty("currentImagePullSecret")
     public ImageSecretObjectReference getCurrentImagePullSecret() {
         return currentImagePullSecret;
     }
 
+    /**
+     * BuildOutputs holds all information needed to handle booting the image after a build
+     */
     @JsonProperty("currentImagePullSecret")
     public void setCurrentImagePullSecret(ImageSecretObjectReference currentImagePullSecret) {
         this.currentImagePullSecret = currentImagePullSecret;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/ImageSecretObjectReference.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/ImageSecretObjectReference.java
index 4484bd09091..9db485976cc 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/ImageSecretObjectReference.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/ImageSecretObjectReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Refers to the name of an image registry push/pull secret needed in the build process.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ImageSecretObjectReference(String name) {
         this.name = name;
     }
 
+    /**
+     * name is the name of the secret used to push or pull this MachineOSConfig object. this secret must be in the openshift-machine-config-operator namespace.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the secret used to push or pull this MachineOSConfig object. this secret must be in the openshift-machine-config-operator namespace.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MCOObjectReference.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MCOObjectReference.java
index 6bc98af35f7..c5676953998 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MCOObjectReference.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MCOObjectReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MCOObjectReference holds information about an object the MCO either owns or modifies in some way
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public MCOObjectReference(String name) {
         this.name = name;
     }
 
+    /**
+     * name is the object name. Must be a lowercase RFC-1123 hostname (https://tools.ietf.org/html/rfc1123) It may consist of only alphanumeric characters, hyphens (-) and periods (.) and must be at most 253 characters in length.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the object name. Must be a lowercase RFC-1123 hostname (https://tools.ietf.org/html/rfc1123) It may consist of only alphanumeric characters, hyphens (-) and periods (.) and must be at most 253 characters in length.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNode.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNode.java
index 8932e486dad..0d06f35ff33 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNode.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNode.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineConfigNode describes the health of the Machines on the system Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class MachineConfigNode implements Editable<MachineConfigNodeBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machineconfiguration.openshift.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MachineConfigNode";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public MachineConfigNode(String apiVersion, String kind, ObjectMeta metadata, Ma
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MachineConfigNode describes the health of the Machines on the system Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MachineConfigNode describes the health of the Machines on the system Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * MachineConfigNode describes the health of the Machines on the system Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("spec")
     public MachineConfigNodeSpec getSpec() {
         return spec;
     }
 
+    /**
+     * MachineConfigNode describes the health of the Machines on the system Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("spec")
     public void setSpec(MachineConfigNodeSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * MachineConfigNode describes the health of the Machines on the system Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("status")
     public MachineConfigNodeStatus getStatus() {
         return status;
     }
 
+    /**
+     * MachineConfigNode describes the health of the Machines on the system Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("status")
     public void setStatus(MachineConfigNodeStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNodeList.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNodeList.java
index 08735a0ceef..ca654709a5d 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNodeList.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNodeList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineConfigNodeList describes all of the MachinesStates on the system<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class MachineConfigNodeList implements Editable<MachineConfigNodeListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.machineconfiguration.v1alpha1.MachineConfigNode>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machineconfiguration.openshift.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.machineconfiguration.v1alpha1.MachineConfigNode> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MachineConfigNodeList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public MachineConfigNodeList(String apiVersion, List<io.fabric8.openshift.api.mo
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * MachineConfigNodeList describes all of the MachinesStates on the system<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.machineconfiguration.v1alpha1.MachineConfigNode> getItems() {
         return items;
     }
 
+    /**
+     * MachineConfigNodeList describes all of the MachinesStates on the system<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.machineconfiguration.v1alpha1.MachineConfigNode> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MachineConfigNodeList describes all of the MachinesStates on the system<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MachineConfigNodeList describes all of the MachinesStates on the system<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNodeSpec.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNodeSpec.java
index 7bf5f45bcac..f022defcb1d 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNodeSpec.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNodeSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineConfigNodeSpec describes the MachineConfigNode we are managing.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public MachineConfigNodeSpec(MachineConfigNodeSpecMachineConfigVersion configVer
         this.pool = pool;
     }
 
+    /**
+     * MachineConfigNodeSpec describes the MachineConfigNode we are managing.
+     */
     @JsonProperty("configVersion")
     public MachineConfigNodeSpecMachineConfigVersion getConfigVersion() {
         return configVersion;
     }
 
+    /**
+     * MachineConfigNodeSpec describes the MachineConfigNode we are managing.
+     */
     @JsonProperty("configVersion")
     public void setConfigVersion(MachineConfigNodeSpecMachineConfigVersion configVersion) {
         this.configVersion = configVersion;
     }
 
+    /**
+     * MachineConfigNodeSpec describes the MachineConfigNode we are managing.
+     */
     @JsonProperty("node")
     public MCOObjectReference getNode() {
         return node;
     }
 
+    /**
+     * MachineConfigNodeSpec describes the MachineConfigNode we are managing.
+     */
     @JsonProperty("node")
     public void setNode(MCOObjectReference node) {
         this.node = node;
     }
 
+    /**
+     * pinnedImageSets holds the desired pinned image sets that this node should pin and pull.
+     */
     @JsonProperty("pinnedImageSets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MachineConfigNodeSpecPinnedImageSet> getPinnedImageSets() {
         return pinnedImageSets;
     }
 
+    /**
+     * pinnedImageSets holds the desired pinned image sets that this node should pin and pull.
+     */
     @JsonProperty("pinnedImageSets")
     public void setPinnedImageSets(List<MachineConfigNodeSpecPinnedImageSet> pinnedImageSets) {
         this.pinnedImageSets = pinnedImageSets;
     }
 
+    /**
+     * MachineConfigNodeSpec describes the MachineConfigNode we are managing.
+     */
     @JsonProperty("pool")
     public MCOObjectReference getPool() {
         return pool;
     }
 
+    /**
+     * MachineConfigNodeSpec describes the MachineConfigNode we are managing.
+     */
     @JsonProperty("pool")
     public void setPool(MCOObjectReference pool) {
         this.pool = pool;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNodeSpecMachineConfigVersion.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNodeSpecMachineConfigVersion.java
index 72ef8cd33ac..971d7d39bf1 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNodeSpecMachineConfigVersion.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNodeSpecMachineConfigVersion.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineConfigNodeSpecMachineConfigVersion holds the desired config version for the current observed machine config node. When Current is not equal to Desired; the MachineConfigOperator is in an upgrade phase and the machine config node will take account of upgrade related events. Otherwise they will be ignored given that certain operations happen both during the MCO's upgrade mode and the daily operations mode.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public MachineConfigNodeSpecMachineConfigVersion(String desired) {
         this.desired = desired;
     }
 
+    /**
+     * desired is the name of the machine config that the the node should be upgraded to. This value is set when the machine config pool generates a new version of its rendered configuration. When this value is changed, the machine config daemon starts the node upgrade process. This value gets set in the machine config node spec once the machine config has been targeted for upgrade and before it is validated. Must be a lowercase RFC-1123 hostname (https://tools.ietf.org/html/rfc1123) It may consist of only alphanumeric characters, hyphens (-) and periods (.) and must be at most 253 characters in length.
+     */
     @JsonProperty("desired")
     public String getDesired() {
         return desired;
     }
 
+    /**
+     * desired is the name of the machine config that the the node should be upgraded to. This value is set when the machine config pool generates a new version of its rendered configuration. When this value is changed, the machine config daemon starts the node upgrade process. This value gets set in the machine config node spec once the machine config has been targeted for upgrade and before it is validated. Must be a lowercase RFC-1123 hostname (https://tools.ietf.org/html/rfc1123) It may consist of only alphanumeric characters, hyphens (-) and periods (.) and must be at most 253 characters in length.
+     */
     @JsonProperty("desired")
     public void setDesired(String desired) {
         this.desired = desired;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNodeSpecPinnedImageSet.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNodeSpecPinnedImageSet.java
index d7e2dfab61c..dfd4ea5bd88 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNodeSpecPinnedImageSet.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNodeSpecPinnedImageSet.java
@@ -78,11 +78,17 @@ public MachineConfigNodeSpecPinnedImageSet(String name) {
         this.name = name;
     }
 
+    /**
+     * name is the name of the pinned image set. Must be a lowercase RFC-1123 hostname (https://tools.ietf.org/html/rfc1123) It may consist of only alphanumeric characters, hyphens (-) and periods (.) and must be at most 253 characters in length.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the pinned image set. Must be a lowercase RFC-1123 hostname (https://tools.ietf.org/html/rfc1123) It may consist of only alphanumeric characters, hyphens (-) and periods (.) and must be at most 253 characters in length.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNodeStatus.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNodeStatus.java
index 0d9faacbf1b..f85040c19e5 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNodeStatus.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNodeStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineConfigNodeStatus holds the reported information on a particular machine config node.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,43 +98,67 @@ public MachineConfigNodeStatus(List<Condition> conditions, MachineConfigNodeStat
         this.pinnedImageSets = pinnedImageSets;
     }
 
+    /**
+     * conditions represent the observations of a machine config node's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions represent the observations of a machine config node's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * MachineConfigNodeStatus holds the reported information on a particular machine config node.
+     */
     @JsonProperty("configVersion")
     public MachineConfigNodeStatusMachineConfigVersion getConfigVersion() {
         return configVersion;
     }
 
+    /**
+     * MachineConfigNodeStatus holds the reported information on a particular machine config node.
+     */
     @JsonProperty("configVersion")
     public void setConfigVersion(MachineConfigNodeStatusMachineConfigVersion configVersion) {
         this.configVersion = configVersion;
     }
 
+    /**
+     * observedGeneration represents the generation observed by the controller. This field is updated when the controller observes a change to the desiredConfig in the configVersion of the machine config node spec.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration represents the generation observed by the controller. This field is updated when the controller observes a change to the desiredConfig in the configVersion of the machine config node spec.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * pinnedImageSets describes the current and desired pinned image sets for this node. The current version is the generation of the pinned image set that has most recently been successfully pulled and pinned on this node. The desired version is the generation of the pinned image set that is targeted to be pulled and pinned on this node.
+     */
     @JsonProperty("pinnedImageSets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MachineConfigNodeStatusPinnedImageSet> getPinnedImageSets() {
         return pinnedImageSets;
     }
 
+    /**
+     * pinnedImageSets describes the current and desired pinned image sets for this node. The current version is the generation of the pinned image set that has most recently been successfully pulled and pinned on this node. The desired version is the generation of the pinned image set that is targeted to be pulled and pinned on this node.
+     */
     @JsonProperty("pinnedImageSets")
     public void setPinnedImageSets(List<MachineConfigNodeStatusPinnedImageSet> pinnedImageSets) {
         this.pinnedImageSets = pinnedImageSets;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNodeStatusMachineConfigVersion.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNodeStatusMachineConfigVersion.java
index 57b854bd44e..77b37f10adc 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNodeStatusMachineConfigVersion.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNodeStatusMachineConfigVersion.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineConfigNodeStatusMachineConfigVersion holds the current and desired config versions as last updated in the MCN status. When the current and desired versions are not matched, the machine config pool is processing an upgrade and the machine config node will monitor the upgrade process. When the current and desired versions do not match, the machine config node will ignore these events given that certain operations happen both during the MCO's upgrade mode and the daily operations mode.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public MachineConfigNodeStatusMachineConfigVersion(String current, String desire
         this.desired = desired;
     }
 
+    /**
+     * current is the name of the machine config currently in use on the node. This value is updated once the machine config daemon has completed the update of the configuration for the node. This value should match the desired version unless an upgrade is in progress. Must be a lowercase RFC-1123 hostname (https://tools.ietf.org/html/rfc1123) It may consist of only alphanumeric characters, hyphens (-) and periods (.) and must be at most 253 characters in length.
+     */
     @JsonProperty("current")
     public String getCurrent() {
         return current;
     }
 
+    /**
+     * current is the name of the machine config currently in use on the node. This value is updated once the machine config daemon has completed the update of the configuration for the node. This value should match the desired version unless an upgrade is in progress. Must be a lowercase RFC-1123 hostname (https://tools.ietf.org/html/rfc1123) It may consist of only alphanumeric characters, hyphens (-) and periods (.) and must be at most 253 characters in length.
+     */
     @JsonProperty("current")
     public void setCurrent(String current) {
         this.current = current;
     }
 
+    /**
+     * desired is the MachineConfig the node wants to upgrade to. This value gets set in the machine config node status once the machine config has been validated against the current machine config. Must be a lowercase RFC-1123 hostname (https://tools.ietf.org/html/rfc1123) It may consist of only alphanumeric characters, hyphens (-) and periods (.) and must be at most 253 characters in length.
+     */
     @JsonProperty("desired")
     public String getDesired() {
         return desired;
     }
 
+    /**
+     * desired is the MachineConfig the node wants to upgrade to. This value gets set in the machine config node status once the machine config has been validated against the current machine config. Must be a lowercase RFC-1123 hostname (https://tools.ietf.org/html/rfc1123) It may consist of only alphanumeric characters, hyphens (-) and periods (.) and must be at most 253 characters in length.
+     */
     @JsonProperty("desired")
     public void setDesired(String desired) {
         this.desired = desired;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNodeStatusPinnedImageSet.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNodeStatusPinnedImageSet.java
index 377937c8a45..d38f0621918 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNodeStatusPinnedImageSet.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigNodeStatusPinnedImageSet.java
@@ -97,52 +97,82 @@ public MachineConfigNodeStatusPinnedImageSet(Integer currentGeneration, Integer
         this.name = name;
     }
 
+    /**
+     * currentGeneration is the generation of the pinned image set that has most recently been successfully pulled and pinned on this node.
+     */
     @JsonProperty("currentGeneration")
     public Integer getCurrentGeneration() {
         return currentGeneration;
     }
 
+    /**
+     * currentGeneration is the generation of the pinned image set that has most recently been successfully pulled and pinned on this node.
+     */
     @JsonProperty("currentGeneration")
     public void setCurrentGeneration(Integer currentGeneration) {
         this.currentGeneration = currentGeneration;
     }
 
+    /**
+     * desiredGeneration version is the generation of the pinned image set that is targeted to be pulled and pinned on this node.
+     */
     @JsonProperty("desiredGeneration")
     public Integer getDesiredGeneration() {
         return desiredGeneration;
     }
 
+    /**
+     * desiredGeneration version is the generation of the pinned image set that is targeted to be pulled and pinned on this node.
+     */
     @JsonProperty("desiredGeneration")
     public void setDesiredGeneration(Integer desiredGeneration) {
         this.desiredGeneration = desiredGeneration;
     }
 
+    /**
+     * lastFailedGeneration is the generation of the most recent pinned image set that failed to be pulled and pinned on this node.
+     */
     @JsonProperty("lastFailedGeneration")
     public Integer getLastFailedGeneration() {
         return lastFailedGeneration;
     }
 
+    /**
+     * lastFailedGeneration is the generation of the most recent pinned image set that failed to be pulled and pinned on this node.
+     */
     @JsonProperty("lastFailedGeneration")
     public void setLastFailedGeneration(Integer lastFailedGeneration) {
         this.lastFailedGeneration = lastFailedGeneration;
     }
 
+    /**
+     * lastFailedGenerationErrors is a list of errors why the lastFailed generation failed to be pulled and pinned.
+     */
     @JsonProperty("lastFailedGenerationErrors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getLastFailedGenerationErrors() {
         return lastFailedGenerationErrors;
     }
 
+    /**
+     * lastFailedGenerationErrors is a list of errors why the lastFailed generation failed to be pulled and pinned.
+     */
     @JsonProperty("lastFailedGenerationErrors")
     public void setLastFailedGenerationErrors(List<String> lastFailedGenerationErrors) {
         this.lastFailedGenerationErrors = lastFailedGenerationErrors;
     }
 
+    /**
+     * name is the name of the pinned image set. Must be a lowercase RFC-1123 hostname (https://tools.ietf.org/html/rfc1123) It may consist of only alphanumeric characters, hyphens (-) and periods (.) and must be at most 253 characters in length.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the pinned image set. Must be a lowercase RFC-1123 hostname (https://tools.ietf.org/html/rfc1123) It may consist of only alphanumeric characters, hyphens (-) and periods (.) and must be at most 253 characters in length.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigPoolReference.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigPoolReference.java
index 41f52d531fb..34a57138fcc 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigPoolReference.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineConfigPoolReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Refers to the name of a MachineConfigPool (e.g., "worker", "infra", etc.): the MachineOSBuilder pod validates that the user has provided a valid pool
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public MachineConfigPoolReference(String name) {
         this.name = name;
     }
 
+    /**
+     * name of the MachineConfigPool object.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name of the MachineConfigPool object.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSBuild.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSBuild.java
index 92153d40df3..7e74d93bf2f 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSBuild.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSBuild.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineOSBuild describes a build process managed and deployed by the MCO Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class MachineOSBuild implements Editable<MachineOSBuildBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machineconfiguration.openshift.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MachineOSBuild";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public MachineOSBuild(String apiVersion, String kind, ObjectMeta metadata, Machi
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MachineOSBuild describes a build process managed and deployed by the MCO Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MachineOSBuild describes a build process managed and deployed by the MCO Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * MachineOSBuild describes a build process managed and deployed by the MCO Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("spec")
     public MachineOSBuildSpec getSpec() {
         return spec;
     }
 
+    /**
+     * MachineOSBuild describes a build process managed and deployed by the MCO Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("spec")
     public void setSpec(MachineOSBuildSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * MachineOSBuild describes a build process managed and deployed by the MCO Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("status")
     public MachineOSBuildStatus getStatus() {
         return status;
     }
 
+    /**
+     * MachineOSBuild describes a build process managed and deployed by the MCO Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("status")
     public void setStatus(MachineOSBuildStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSBuildList.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSBuildList.java
index 93a2b845b25..757dc7fd9da 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSBuildList.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSBuildList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineOSBuildList describes all of the Builds on the system<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class MachineOSBuildList implements Editable<MachineOSBuildListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.machineconfiguration.v1alpha1.MachineOSBuild>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machineconfiguration.openshift.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.machineconfiguration.v1alpha1.MachineOSBuild> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MachineOSBuildList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public MachineOSBuildList(String apiVersion, List<io.fabric8.openshift.api.model
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * MachineOSBuildList describes all of the Builds on the system<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.machineconfiguration.v1alpha1.MachineOSBuild> getItems() {
         return items;
     }
 
+    /**
+     * MachineOSBuildList describes all of the Builds on the system<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.machineconfiguration.v1alpha1.MachineOSBuild> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MachineOSBuildList describes all of the Builds on the system<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MachineOSBuildList describes all of the Builds on the system<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSBuildSpec.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSBuildSpec.java
index f5217c970bc..731e18b13f7 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSBuildSpec.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSBuildSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineOSBuildSpec describes information about a build process primarily populated from a MachineOSConfig object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public MachineOSBuildSpec(Long configGeneration, RenderedMachineConfigReference
         this.version = version;
     }
 
+    /**
+     * configGeneration tracks which version of MachineOSConfig this build is based off of
+     */
     @JsonProperty("configGeneration")
     public Long getConfigGeneration() {
         return configGeneration;
     }
 
+    /**
+     * configGeneration tracks which version of MachineOSConfig this build is based off of
+     */
     @JsonProperty("configGeneration")
     public void setConfigGeneration(Long configGeneration) {
         this.configGeneration = configGeneration;
     }
 
+    /**
+     * MachineOSBuildSpec describes information about a build process primarily populated from a MachineOSConfig object.
+     */
     @JsonProperty("desiredConfig")
     public RenderedMachineConfigReference getDesiredConfig() {
         return desiredConfig;
     }
 
+    /**
+     * MachineOSBuildSpec describes information about a build process primarily populated from a MachineOSConfig object.
+     */
     @JsonProperty("desiredConfig")
     public void setDesiredConfig(RenderedMachineConfigReference desiredConfig) {
         this.desiredConfig = desiredConfig;
     }
 
+    /**
+     * MachineOSBuildSpec describes information about a build process primarily populated from a MachineOSConfig object.
+     */
     @JsonProperty("machineOSConfig")
     public MachineOSConfigReference getMachineOSConfig() {
         return machineOSConfig;
     }
 
+    /**
+     * MachineOSBuildSpec describes information about a build process primarily populated from a MachineOSConfig object.
+     */
     @JsonProperty("machineOSConfig")
     public void setMachineOSConfig(MachineOSConfigReference machineOSConfig) {
         this.machineOSConfig = machineOSConfig;
     }
 
+    /**
+     * renderedImagePushspec is set from the MachineOSConfig The format of the image pullspec is: host[:port][/namespace]/name:&lt;tag&gt; or svc_name.namespace.svc[:port]/repository/name:&lt;tag&gt;
+     */
     @JsonProperty("renderedImagePushspec")
     public String getRenderedImagePushspec() {
         return renderedImagePushspec;
     }
 
+    /**
+     * renderedImagePushspec is set from the MachineOSConfig The format of the image pullspec is: host[:port][/namespace]/name:&lt;tag&gt; or svc_name.namespace.svc[:port]/repository/name:&lt;tag&gt;
+     */
     @JsonProperty("renderedImagePushspec")
     public void setRenderedImagePushspec(String renderedImagePushspec) {
         this.renderedImagePushspec = renderedImagePushspec;
     }
 
+    /**
+     * version tracks the newest MachineOSBuild for each MachineOSConfig
+     */
     @JsonProperty("version")
     public Long getVersion() {
         return version;
     }
 
+    /**
+     * version tracks the newest MachineOSBuild for each MachineOSConfig
+     */
     @JsonProperty("version")
     public void setVersion(Long version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSBuildStatus.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSBuildStatus.java
index 80e218b7538..9275f82c04e 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSBuildStatus.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSBuildStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineOSBuildStatus describes the state of a build and other helpful information.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -103,63 +106,99 @@ public MachineOSBuildStatus(String buildEnd, String buildStart, MachineOSBuilder
         this.relatedObjects = relatedObjects;
     }
 
+    /**
+     * MachineOSBuildStatus describes the state of a build and other helpful information.
+     */
     @JsonProperty("buildEnd")
     public String getBuildEnd() {
         return buildEnd;
     }
 
+    /**
+     * MachineOSBuildStatus describes the state of a build and other helpful information.
+     */
     @JsonProperty("buildEnd")
     public void setBuildEnd(String buildEnd) {
         this.buildEnd = buildEnd;
     }
 
+    /**
+     * MachineOSBuildStatus describes the state of a build and other helpful information.
+     */
     @JsonProperty("buildStart")
     public String getBuildStart() {
         return buildStart;
     }
 
+    /**
+     * MachineOSBuildStatus describes the state of a build and other helpful information.
+     */
     @JsonProperty("buildStart")
     public void setBuildStart(String buildStart) {
         this.buildStart = buildStart;
     }
 
+    /**
+     * MachineOSBuildStatus describes the state of a build and other helpful information.
+     */
     @JsonProperty("builderReference")
     public MachineOSBuilderReference getBuilderReference() {
         return builderReference;
     }
 
+    /**
+     * MachineOSBuildStatus describes the state of a build and other helpful information.
+     */
     @JsonProperty("builderReference")
     public void setBuilderReference(MachineOSBuilderReference builderReference) {
         this.builderReference = builderReference;
     }
 
+    /**
+     * conditions are state related conditions for the build. Valid types are: Prepared, Building, Failed, Interrupted, and Succeeded once a Build is marked as Failed, no future conditions can be set. This is enforced by the MCO.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions are state related conditions for the build. Valid types are: Prepared, Building, Failed, Interrupted, and Succeeded once a Build is marked as Failed, no future conditions can be set. This is enforced by the MCO.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * finalImagePushSpec describes the fully qualified pushspec produced by this build that the final image can be. Must be in sha format.
+     */
     @JsonProperty("finalImagePullspec")
     public String getFinalImagePullspec() {
         return finalImagePullspec;
     }
 
+    /**
+     * finalImagePushSpec describes the fully qualified pushspec produced by this build that the final image can be. Must be in sha format.
+     */
     @JsonProperty("finalImagePullspec")
     public void setFinalImagePullspec(String finalImagePullspec) {
         this.finalImagePullspec = finalImagePullspec;
     }
 
+    /**
+     * relatedObjects is a list of objects that are related to the build process.
+     */
     @JsonProperty("relatedObjects")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ObjectReference> getRelatedObjects() {
         return relatedObjects;
     }
 
+    /**
+     * relatedObjects is a list of objects that are related to the build process.
+     */
     @JsonProperty("relatedObjects")
     public void setRelatedObjects(List<ObjectReference> relatedObjects) {
         this.relatedObjects = relatedObjects;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSBuilderReference.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSBuilderReference.java
index e873aceccdc..375e4589cb9 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSBuilderReference.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSBuilderReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineOSBuilderReference describes which ImageBuilder backend to use for this build/
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public MachineOSBuilderReference(ObjectReference buildPod, String imageBuilderTy
         this.imageBuilderType = imageBuilderType;
     }
 
+    /**
+     * MachineOSBuilderReference describes which ImageBuilder backend to use for this build/
+     */
     @JsonProperty("buildPod")
     public ObjectReference getBuildPod() {
         return buildPod;
     }
 
+    /**
+     * MachineOSBuilderReference describes which ImageBuilder backend to use for this build/
+     */
     @JsonProperty("buildPod")
     public void setBuildPod(ObjectReference buildPod) {
         this.buildPod = buildPod;
     }
 
+    /**
+     * ImageBuilderType describes the image builder set in the MachineOSConfig
+     */
     @JsonProperty("imageBuilderType")
     public String getImageBuilderType() {
         return imageBuilderType;
     }
 
+    /**
+     * ImageBuilderType describes the image builder set in the MachineOSConfig
+     */
     @JsonProperty("imageBuilderType")
     public void setImageBuilderType(String imageBuilderType) {
         this.imageBuilderType = imageBuilderType;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSConfig.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSConfig.java
index c70df325bf2..d5a18cd009b 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSConfig.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSConfig.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineOSConfig describes the configuration for a build process managed by the MCO Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class MachineOSConfig implements Editable<MachineOSConfigBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machineconfiguration.openshift.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MachineOSConfig";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public MachineOSConfig(String apiVersion, String kind, ObjectMeta metadata, Mach
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MachineOSConfig describes the configuration for a build process managed by the MCO Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MachineOSConfig describes the configuration for a build process managed by the MCO Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * MachineOSConfig describes the configuration for a build process managed by the MCO Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("spec")
     public MachineOSConfigSpec getSpec() {
         return spec;
     }
 
+    /**
+     * MachineOSConfig describes the configuration for a build process managed by the MCO Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("spec")
     public void setSpec(MachineOSConfigSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * MachineOSConfig describes the configuration for a build process managed by the MCO Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("status")
     public MachineOSConfigStatus getStatus() {
         return status;
     }
 
+    /**
+     * MachineOSConfig describes the configuration for a build process managed by the MCO Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("status")
     public void setStatus(MachineOSConfigStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSConfigList.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSConfigList.java
index 91ee64bec03..9e50cf040b4 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSConfigList.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSConfigList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineOSConfigList describes all configurations for image builds on the system<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class MachineOSConfigList implements Editable<MachineOSConfigListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.machineconfiguration.v1alpha1.MachineOSConfig>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machineconfiguration.openshift.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.machineconfiguration.v1alpha1.MachineOSConfig> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MachineOSConfigList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public MachineOSConfigList(String apiVersion, List<io.fabric8.openshift.api.mode
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * MachineOSConfigList describes all configurations for image builds on the system<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.machineconfiguration.v1alpha1.MachineOSConfig> getItems() {
         return items;
     }
 
+    /**
+     * MachineOSConfigList describes all configurations for image builds on the system<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.machineconfiguration.v1alpha1.MachineOSConfig> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MachineOSConfigList describes all configurations for image builds on the system<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MachineOSConfigList describes all configurations for image builds on the system<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSConfigReference.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSConfigReference.java
index b53f7875761..715753a6fb1 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSConfigReference.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSConfigReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineOSConfigReference refers to the MachineOSConfig this build is based off of
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public MachineOSConfigReference(String name) {
         this.name = name;
     }
 
+    /**
+     * name of the MachineOSConfig
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name of the MachineOSConfig
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSConfigSpec.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSConfigSpec.java
index aeede69eae8..f064311d593 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSConfigSpec.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSConfigSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineOSConfigSpec describes user-configurable options as well as information about a build process.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public MachineOSConfigSpec(BuildInputs buildInputs, BuildOutputs buildOutputs, M
         this.machineConfigPool = machineConfigPool;
     }
 
+    /**
+     * MachineOSConfigSpec describes user-configurable options as well as information about a build process.
+     */
     @JsonProperty("buildInputs")
     public BuildInputs getBuildInputs() {
         return buildInputs;
     }
 
+    /**
+     * MachineOSConfigSpec describes user-configurable options as well as information about a build process.
+     */
     @JsonProperty("buildInputs")
     public void setBuildInputs(BuildInputs buildInputs) {
         this.buildInputs = buildInputs;
     }
 
+    /**
+     * MachineOSConfigSpec describes user-configurable options as well as information about a build process.
+     */
     @JsonProperty("buildOutputs")
     public BuildOutputs getBuildOutputs() {
         return buildOutputs;
     }
 
+    /**
+     * MachineOSConfigSpec describes user-configurable options as well as information about a build process.
+     */
     @JsonProperty("buildOutputs")
     public void setBuildOutputs(BuildOutputs buildOutputs) {
         this.buildOutputs = buildOutputs;
     }
 
+    /**
+     * MachineOSConfigSpec describes user-configurable options as well as information about a build process.
+     */
     @JsonProperty("machineConfigPool")
     public MachineConfigPoolReference getMachineConfigPool() {
         return machineConfigPool;
     }
 
+    /**
+     * MachineOSConfigSpec describes user-configurable options as well as information about a build process.
+     */
     @JsonProperty("machineConfigPool")
     public void setMachineConfigPool(MachineConfigPoolReference machineConfigPool) {
         this.machineConfigPool = machineConfigPool;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSConfigStatus.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSConfigStatus.java
index 6eaa210d11a..5320f2f3361 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSConfigStatus.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSConfigStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineOSConfigStatus describes the status this config object and relates it to the builds associated with this MachineOSConfig
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,32 +93,50 @@ public MachineOSConfigStatus(List<Condition> conditions, String currentImagePull
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * conditions are state related conditions for the config.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions are state related conditions for the config.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * currentImagePullspec is the fully qualified image pull spec used by the MCO to pull down the new OSImage. This must include sha256.
+     */
     @JsonProperty("currentImagePullspec")
     public String getCurrentImagePullspec() {
         return currentImagePullspec;
     }
 
+    /**
+     * currentImagePullspec is the fully qualified image pull spec used by the MCO to pull down the new OSImage. This must include sha256.
+     */
     @JsonProperty("currentImagePullspec")
     public void setCurrentImagePullspec(String currentImagePullspec) {
         this.currentImagePullspec = currentImagePullspec;
     }
 
+    /**
+     * observedGeneration represents the generation observed by the controller. this field is updated when the user changes the configuration in BuildSettings or the MCP this object is associated with.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration represents the generation observed by the controller. this field is updated when the user changes the configuration in BuildSettings or the MCP this object is associated with.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSContainerfile.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSContainerfile.java
index aa5761e765e..45bed72fb80 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSContainerfile.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSContainerfile.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineOSContainerfile contains all custom content the user wants built into the image
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public MachineOSContainerfile(String containerfileArch, String content) {
         this.content = content;
     }
 
+    /**
+     * containerfileArch describes the architecture this containerfile is to be built for this arch is optional. If the user does not specify an architecture, it is assumed that the content can be applied to all architectures, or in a single arch cluster: the only architecture.
+     */
     @JsonProperty("containerfileArch")
     public String getContainerfileArch() {
         return containerfileArch;
     }
 
+    /**
+     * containerfileArch describes the architecture this containerfile is to be built for this arch is optional. If the user does not specify an architecture, it is assumed that the content can be applied to all architectures, or in a single arch cluster: the only architecture.
+     */
     @JsonProperty("containerfileArch")
     public void setContainerfileArch(String containerfileArch) {
         this.containerfileArch = containerfileArch;
     }
 
+    /**
+     * content is the custom content to be built
+     */
     @JsonProperty("content")
     public String getContent() {
         return content;
     }
 
+    /**
+     * content is the custom content to be built
+     */
     @JsonProperty("content")
     public void setContent(String content) {
         this.content = content;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSImageBuilder.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSImageBuilder.java
index 578d54bab51..4b92a1913e6 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSImageBuilder.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/MachineOSImageBuilder.java
@@ -78,11 +78,17 @@ public MachineOSImageBuilder(String imageBuilderType) {
         this.imageBuilderType = imageBuilderType;
     }
 
+    /**
+     * imageBuilderType specifies the backend to be used to build the image. Valid options are: PodImageBuilder
+     */
     @JsonProperty("imageBuilderType")
     public String getImageBuilderType() {
         return imageBuilderType;
     }
 
+    /**
+     * imageBuilderType specifies the backend to be used to build the image. Valid options are: PodImageBuilder
+     */
     @JsonProperty("imageBuilderType")
     public void setImageBuilderType(String imageBuilderType) {
         this.imageBuilderType = imageBuilderType;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/ObjectReference.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/ObjectReference.java
index 4678e8dca69..531d8824233 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/ObjectReference.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/ObjectReference.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ObjectReference contains enough information to let you inspect or modify the referred object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,41 +92,65 @@ public ObjectReference(String group, String name, String namespace, String resou
         this.resource = resource;
     }
 
+    /**
+     * group of the referent.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * group of the referent.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * name of the referent.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name of the referent.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * namespace of the referent.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * namespace of the referent.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * resource of the referent.
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * resource of the referent.
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/PinnedImageRef.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/PinnedImageRef.java
index fb57062e041..9e5410a3478 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/PinnedImageRef.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/PinnedImageRef.java
@@ -78,11 +78,17 @@ public PinnedImageRef(String name) {
         this.name = name;
     }
 
+    /**
+     * name is an OCI Image referenced by digest.<br><p> <br><p> The format of the image ref is: host[:port][/namespace]/name@sha256:&lt;digest&gt;
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is an OCI Image referenced by digest.<br><p> <br><p> The format of the image ref is: host[:port][/namespace]/name@sha256:&lt;digest&gt;
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/PinnedImageSet.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/PinnedImageSet.java
index caf69d3c705..65664e8fb39 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/PinnedImageSet.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/PinnedImageSet.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PinnedImageSet describes a set of images that should be pinned by CRI-O and pulled to the nodes which are members of the declared MachineConfigPools.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class PinnedImageSet implements Editable<PinnedImageSetBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machineconfiguration.openshift.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PinnedImageSet";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public PinnedImageSet(String apiVersion, String kind, ObjectMeta metadata, Pinne
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PinnedImageSet describes a set of images that should be pinned by CRI-O and pulled to the nodes which are members of the declared MachineConfigPools.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PinnedImageSet describes a set of images that should be pinned by CRI-O and pulled to the nodes which are members of the declared MachineConfigPools.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PinnedImageSet describes a set of images that should be pinned by CRI-O and pulled to the nodes which are members of the declared MachineConfigPools.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("spec")
     public PinnedImageSetSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PinnedImageSet describes a set of images that should be pinned by CRI-O and pulled to the nodes which are members of the declared MachineConfigPools.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("spec")
     public void setSpec(PinnedImageSetSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PinnedImageSet describes a set of images that should be pinned by CRI-O and pulled to the nodes which are members of the declared MachineConfigPools.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("status")
     public PinnedImageSetStatus getStatus() {
         return status;
     }
 
+    /**
+     * PinnedImageSet describes a set of images that should be pinned by CRI-O and pulled to the nodes which are members of the declared MachineConfigPools.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("status")
     public void setStatus(PinnedImageSetStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/PinnedImageSetList.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/PinnedImageSetList.java
index 59a69186e63..6922b6d3d57 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/PinnedImageSetList.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/PinnedImageSetList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PinnedImageSetList is a list of PinnedImageSet resources<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PinnedImageSetList implements Editable<PinnedImageSetListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.machineconfiguration.v1alpha1.PinnedImageSet>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "machineconfiguration.openshift.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.machineconfiguration.v1alpha1.PinnedImageSet> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PinnedImageSetList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PinnedImageSetList(String apiVersion, List<io.fabric8.openshift.api.model
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PinnedImageSetList is a list of PinnedImageSet resources<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.machineconfiguration.v1alpha1.PinnedImageSet> getItems() {
         return items;
     }
 
+    /**
+     * PinnedImageSetList is a list of PinnedImageSet resources<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.machineconfiguration.v1alpha1.PinnedImageSet> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PinnedImageSetList is a list of PinnedImageSet resources<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PinnedImageSetList is a list of PinnedImageSet resources<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/PinnedImageSetSpec.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/PinnedImageSetSpec.java
index c6492690676..7c39ba1fc55 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/PinnedImageSetSpec.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/PinnedImageSetSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PinnedImageSetSpec defines the desired state of a PinnedImageSet.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public PinnedImageSetSpec(List<PinnedImageRef> pinnedImages) {
         this.pinnedImages = pinnedImages;
     }
 
+    /**
+     * pinnedImages is a list of OCI Image referenced by digest that should be pinned and pre-loaded by the nodes of a MachineConfigPool. Translates into a new file inside the /etc/crio/crio.conf.d directory with content similar to this:<br><p> <br><p>      pinned_images = [<br><p>              "quay.io/openshift-release-dev/ocp-release@sha256:...",<br><p>              "quay.io/openshift-release-dev/ocp-v4.0-art-dev@sha256:...",<br><p>              "quay.io/openshift-release-dev/ocp-v4.0-art-dev@sha256:...",<br><p>              ...<br><p>      ]<br><p> <br><p> These image references should all be by digest, tags aren't allowed.
+     */
     @JsonProperty("pinnedImages")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PinnedImageRef> getPinnedImages() {
         return pinnedImages;
     }
 
+    /**
+     * pinnedImages is a list of OCI Image referenced by digest that should be pinned and pre-loaded by the nodes of a MachineConfigPool. Translates into a new file inside the /etc/crio/crio.conf.d directory with content similar to this:<br><p> <br><p>      pinned_images = [<br><p>              "quay.io/openshift-release-dev/ocp-release@sha256:...",<br><p>              "quay.io/openshift-release-dev/ocp-v4.0-art-dev@sha256:...",<br><p>              "quay.io/openshift-release-dev/ocp-v4.0-art-dev@sha256:...",<br><p>              ...<br><p>      ]<br><p> <br><p> These image references should all be by digest, tags aren't allowed.
+     */
     @JsonProperty("pinnedImages")
     public void setPinnedImages(List<PinnedImageRef> pinnedImages) {
         this.pinnedImages = pinnedImages;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/PinnedImageSetStatus.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/PinnedImageSetStatus.java
index 15a6d33cab5..22b99ef37b4 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/PinnedImageSetStatus.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/PinnedImageSetStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PinnedImageSetStatus describes the current state of a PinnedImageSet.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,12 +85,18 @@ public PinnedImageSetStatus(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * conditions represent the observations of a pinned image set's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions represent the observations of a pinned image set's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
diff --git a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/RenderedMachineConfigReference.java b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/RenderedMachineConfigReference.java
index a8b92f15ff8..207160c7066 100644
--- a/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/RenderedMachineConfigReference.java
+++ b/kubernetes-model-generator/openshift-model-machineconfiguration/src/generated/java/io/fabric8/openshift/api/model/machineconfiguration/v1alpha1/RenderedMachineConfigReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Refers to the name of a rendered MachineConfig (e.g., "rendered-worker-ec40d2965ff81bce7cd7a7e82a680739", etc.): the build targets this MachineConfig, this is often used to tell us whether we need an update.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public RenderedMachineConfigReference(String name) {
         this.name = name;
     }
 
+    /**
+     * name is the name of the rendered MachineConfig object.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the rendered MachineConfig object.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/APIRequestCount.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/APIRequestCount.java
index 63b906ef1f4..268a08f585c 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/APIRequestCount.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/APIRequestCount.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * APIRequestCount tracks requests made to an API. The instance name must be of the form `resource.version.group`, matching the resource.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class APIRequestCount implements Editable<APIRequestCountBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apiserver.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "APIRequestCount";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public APIRequestCount(String apiVersion, String kind, ObjectMeta metadata, APIR
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * APIRequestCount tracks requests made to an API. The instance name must be of the form `resource.version.group`, matching the resource.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * APIRequestCount tracks requests made to an API. The instance name must be of the form `resource.version.group`, matching the resource.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * APIRequestCount tracks requests made to an API. The instance name must be of the form `resource.version.group`, matching the resource.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public APIRequestCountSpec getSpec() {
         return spec;
     }
 
+    /**
+     * APIRequestCount tracks requests made to an API. The instance name must be of the form `resource.version.group`, matching the resource.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(APIRequestCountSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * APIRequestCount tracks requests made to an API. The instance name must be of the form `resource.version.group`, matching the resource.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public APIRequestCountStatus getStatus() {
         return status;
     }
 
+    /**
+     * APIRequestCount tracks requests made to an API. The instance name must be of the form `resource.version.group`, matching the resource.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(APIRequestCountStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/APIRequestCountList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/APIRequestCountList.java
index a5e4b443ba5..2ad6fc0975a 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/APIRequestCountList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/APIRequestCountList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * APIRequestCountList is a list of APIRequestCount resources.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class APIRequestCountList implements Editable<APIRequestCountListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.apiserver.v1.APIRequestCount>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apiserver.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.apiserver.v1.APIRequestCount> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "APIRequestCountList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public APIRequestCountList(String apiVersion, List<io.fabric8.openshift.api.mode
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * APIRequestCountList is a list of APIRequestCount resources.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.miscellaneous.apiserver.v1.APIRequestCount> getItems() {
         return items;
     }
 
+    /**
+     * APIRequestCountList is a list of APIRequestCount resources.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.apiserver.v1.APIRequestCount> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * APIRequestCountList is a list of APIRequestCount resources.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * APIRequestCountList is a list of APIRequestCount resources.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/APIRequestCountSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/APIRequestCountSpec.java
index 02a6cc86d0c..8617aef1182 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/APIRequestCountSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/APIRequestCountSpec.java
@@ -78,11 +78,17 @@ public APIRequestCountSpec(Long numberOfUsersToReport) {
         this.numberOfUsersToReport = numberOfUsersToReport;
     }
 
+    /**
+     * numberOfUsersToReport is the number of users to include in the report. If unspecified or zero, the default is ten.  This is default is subject to change.
+     */
     @JsonProperty("numberOfUsersToReport")
     public Long getNumberOfUsersToReport() {
         return numberOfUsersToReport;
     }
 
+    /**
+     * numberOfUsersToReport is the number of users to include in the report. If unspecified or zero, the default is ten.  This is default is subject to change.
+     */
     @JsonProperty("numberOfUsersToReport")
     public void setNumberOfUsersToReport(Long numberOfUsersToReport) {
         this.numberOfUsersToReport = numberOfUsersToReport;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/APIRequestCountStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/APIRequestCountStatus.java
index bac2065bf54..a0adda95920 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/APIRequestCountStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/APIRequestCountStatus.java
@@ -99,12 +99,18 @@ public APIRequestCountStatus(List<Condition> conditions, PerResourceAPIRequestLo
         this.requestCount = requestCount;
     }
 
+    /**
+     * conditions contains details of the current status of this API Resource.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions contains details of the current status of this API Resource.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
@@ -120,32 +126,50 @@ public void setCurrentHour(PerResourceAPIRequestLog currentHour) {
         this.currentHour = currentHour;
     }
 
+    /**
+     * last24h contains request history for the last 24 hours, indexed by the hour, so 12:00AM-12:59 is in index 0, 6am-6:59am is index 6, etc. The index of the current hour is updated live and then duplicated into the requestsLastHour field.
+     */
     @JsonProperty("last24h")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PerResourceAPIRequestLog> getLast24h() {
         return last24h;
     }
 
+    /**
+     * last24h contains request history for the last 24 hours, indexed by the hour, so 12:00AM-12:59 is in index 0, 6am-6:59am is index 6, etc. The index of the current hour is updated live and then duplicated into the requestsLastHour field.
+     */
     @JsonProperty("last24h")
     public void setLast24h(List<PerResourceAPIRequestLog> last24h) {
         this.last24h = last24h;
     }
 
+    /**
+     * removedInRelease is when the API will be removed.
+     */
     @JsonProperty("removedInRelease")
     public String getRemovedInRelease() {
         return removedInRelease;
     }
 
+    /**
+     * removedInRelease is when the API will be removed.
+     */
     @JsonProperty("removedInRelease")
     public void setRemovedInRelease(String removedInRelease) {
         this.removedInRelease = removedInRelease;
     }
 
+    /**
+     * requestCount is a sum of all requestCounts across all current hours, nodes, and users.
+     */
     @JsonProperty("requestCount")
     public Long getRequestCount() {
         return requestCount;
     }
 
+    /**
+     * requestCount is a sum of all requestCounts across all current hours, nodes, and users.
+     */
     @JsonProperty("requestCount")
     public void setRequestCount(Long requestCount) {
         this.requestCount = requestCount;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/PerNodeAPIRequestLog.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/PerNodeAPIRequestLog.java
index 6e3521dc42e..b0a5bed52b4 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/PerNodeAPIRequestLog.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/PerNodeAPIRequestLog.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PerNodeAPIRequestLog contains logs of requests to a certain node.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public PerNodeAPIRequestLog(List<PerUserAPIRequestCount> byUser, String nodeName
         this.requestCount = requestCount;
     }
 
+    /**
+     * byUser contains request details by top .spec.numberOfUsersToReport users. Note that because in the case of an apiserver, restart the list of top users is determined on a best-effort basis, the list might be imprecise. In addition, some system users may be explicitly included in the list.
+     */
     @JsonProperty("byUser")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PerUserAPIRequestCount> getByUser() {
         return byUser;
     }
 
+    /**
+     * byUser contains request details by top .spec.numberOfUsersToReport users. Note that because in the case of an apiserver, restart the list of top users is determined on a best-effort basis, the list might be imprecise. In addition, some system users may be explicitly included in the list.
+     */
     @JsonProperty("byUser")
     public void setByUser(List<PerUserAPIRequestCount> byUser) {
         this.byUser = byUser;
     }
 
+    /**
+     * nodeName where the request are being handled.
+     */
     @JsonProperty("nodeName")
     public String getNodeName() {
         return nodeName;
     }
 
+    /**
+     * nodeName where the request are being handled.
+     */
     @JsonProperty("nodeName")
     public void setNodeName(String nodeName) {
         this.nodeName = nodeName;
     }
 
+    /**
+     * requestCount is a sum of all requestCounts across all users, even those outside of the top 10 users.
+     */
     @JsonProperty("requestCount")
     public Long getRequestCount() {
         return requestCount;
     }
 
+    /**
+     * requestCount is a sum of all requestCounts across all users, even those outside of the top 10 users.
+     */
     @JsonProperty("requestCount")
     public void setRequestCount(Long requestCount) {
         this.requestCount = requestCount;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/PerResourceAPIRequestLog.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/PerResourceAPIRequestLog.java
index 67ab1c18b0d..6b753334cde 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/PerResourceAPIRequestLog.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/PerResourceAPIRequestLog.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PerResourceAPIRequestLog logs request for various nodes.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public PerResourceAPIRequestLog(List<PerNodeAPIRequestLog> byNode, Long requestC
         this.requestCount = requestCount;
     }
 
+    /**
+     * byNode contains logs of requests per node.
+     */
     @JsonProperty("byNode")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PerNodeAPIRequestLog> getByNode() {
         return byNode;
     }
 
+    /**
+     * byNode contains logs of requests per node.
+     */
     @JsonProperty("byNode")
     public void setByNode(List<PerNodeAPIRequestLog> byNode) {
         this.byNode = byNode;
     }
 
+    /**
+     * requestCount is a sum of all requestCounts across nodes.
+     */
     @JsonProperty("requestCount")
     public Long getRequestCount() {
         return requestCount;
     }
 
+    /**
+     * requestCount is a sum of all requestCounts across nodes.
+     */
     @JsonProperty("requestCount")
     public void setRequestCount(Long requestCount) {
         this.requestCount = requestCount;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/PerUserAPIRequestCount.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/PerUserAPIRequestCount.java
index c22584a9905..49f08afe475 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/PerUserAPIRequestCount.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/PerUserAPIRequestCount.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PerUserAPIRequestCount contains logs of a user's requests.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public PerUserAPIRequestCount(List<PerVerbAPIRequestCount> byVerb, Long requestC
         this.username = username;
     }
 
+    /**
+     * byVerb details by verb.
+     */
     @JsonProperty("byVerb")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PerVerbAPIRequestCount> getByVerb() {
         return byVerb;
     }
 
+    /**
+     * byVerb details by verb.
+     */
     @JsonProperty("byVerb")
     public void setByVerb(List<PerVerbAPIRequestCount> byVerb) {
         this.byVerb = byVerb;
     }
 
+    /**
+     * requestCount of requests by the user across all verbs.
+     */
     @JsonProperty("requestCount")
     public Long getRequestCount() {
         return requestCount;
     }
 
+    /**
+     * requestCount of requests by the user across all verbs.
+     */
     @JsonProperty("requestCount")
     public void setRequestCount(Long requestCount) {
         this.requestCount = requestCount;
     }
 
+    /**
+     * userAgent that made the request. The same user often has multiple binaries which connect (pods with many containers).  The different binaries will have different userAgents, but the same user.  In addition, we have userAgents with version information embedded and the userName isn't likely to change.
+     */
     @JsonProperty("userAgent")
     public String getUserAgent() {
         return userAgent;
     }
 
+    /**
+     * userAgent that made the request. The same user often has multiple binaries which connect (pods with many containers).  The different binaries will have different userAgents, but the same user.  In addition, we have userAgents with version information embedded and the userName isn't likely to change.
+     */
     @JsonProperty("userAgent")
     public void setUserAgent(String userAgent) {
         this.userAgent = userAgent;
     }
 
+    /**
+     * userName that made the request.
+     */
     @JsonProperty("username")
     public String getUsername() {
         return username;
     }
 
+    /**
+     * userName that made the request.
+     */
     @JsonProperty("username")
     public void setUsername(String username) {
         this.username = username;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/PerVerbAPIRequestCount.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/PerVerbAPIRequestCount.java
index 9b6daa84475..5e10138941a 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/PerVerbAPIRequestCount.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/apiserver/v1/PerVerbAPIRequestCount.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PerVerbAPIRequestCount requestCounts requests by API request verb.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PerVerbAPIRequestCount(Long requestCount, String verb) {
         this.verb = verb;
     }
 
+    /**
+     * requestCount of requests for verb.
+     */
     @JsonProperty("requestCount")
     public Long getRequestCount() {
         return requestCount;
     }
 
+    /**
+     * requestCount of requests for verb.
+     */
     @JsonProperty("requestCount")
     public void setRequestCount(Long requestCount) {
         this.requestCount = requestCount;
     }
 
+    /**
+     * verb of API request (get, list, create, etc...)
+     */
     @JsonProperty("verb")
     public String getVerb() {
         return verb;
     }
 
+    /**
+     * verb of API request (get, list, create, etc...)
+     */
     @JsonProperty("verb")
     public void setVerb(String verb) {
         this.verb = verb;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/AWSProviderSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/AWSProviderSpec.java
index 2fe25fb0aa5..4be48827fc4 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/AWSProviderSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/AWSProviderSpec.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSProviderSpec contains the required information to create a user policy in AWS.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class AWSProviderSpec implements Editable<AWSProviderSpecBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cloudcredential.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AWSProviderSpec";
     @JsonProperty("statementEntries")
@@ -110,7 +107,7 @@ public AWSProviderSpec(String apiVersion, String kind, List<StatementEntry> stat
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,29 +131,41 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * StatementEntries contains a list of policy statements that should be associated with this credentials access key.
+     */
     @JsonProperty("statementEntries")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<StatementEntry> getStatementEntries() {
         return statementEntries;
     }
 
+    /**
+     * StatementEntries contains a list of policy statements that should be associated with this credentials access key.
+     */
     @JsonProperty("statementEntries")
     public void setStatementEntries(List<StatementEntry> statementEntries) {
         this.statementEntries = statementEntries;
     }
 
+    /**
+     * stsIAMRoleARN is the Amazon Resource Name (ARN) of an IAM Role which was created manually for the associated CredentialsRequest. The presence of an stsIAMRoleARN within the AWSProviderSpec initiates creation of a secret containing IAM Role details necessary for assuming the IAM Role via Amazon's Secure Token Service.
+     */
     @JsonProperty("stsIAMRoleARN")
     public String getStsIAMRoleARN() {
         return stsIAMRoleARN;
     }
 
+    /**
+     * stsIAMRoleARN is the Amazon Resource Name (ARN) of an IAM Role which was created manually for the associated CredentialsRequest. The presence of an stsIAMRoleARN within the AWSProviderSpec initiates creation of a secret containing IAM Role details necessary for assuming the IAM Role via Amazon's Secure Token Service.
+     */
     @JsonProperty("stsIAMRoleARN")
     public void setStsIAMRoleARN(String stsIAMRoleARN) {
         this.stsIAMRoleARN = stsIAMRoleARN;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/AWSProviderStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/AWSProviderStatus.java
index fc80e612c38..d108e96f33f 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/AWSProviderStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/AWSProviderStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSProviderStatus containes the status of the credentials request in AWS.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class AWSProviderStatus implements Editable<AWSProviderStatusBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cloudcredential.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AWSProviderStatus";
     @JsonProperty("policy")
@@ -107,7 +104,7 @@ public AWSProviderStatus(String apiVersion, String kind, String policy, String u
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Policy is the name of the policy attached to the user in AWS.
+     */
     @JsonProperty("policy")
     public String getPolicy() {
         return policy;
     }
 
+    /**
+     * Policy is the name of the policy attached to the user in AWS.
+     */
     @JsonProperty("policy")
     public void setPolicy(String policy) {
         this.policy = policy;
     }
 
+    /**
+     * User is the name of the User created in AWS for these credentials.
+     */
     @JsonProperty("user")
     public String getUser() {
         return user;
     }
 
+    /**
+     * User is the name of the User created in AWS for these credentials.
+     */
     @JsonProperty("user")
     public void setUser(String user) {
         this.user = user;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/AccessPolicy.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/AccessPolicy.java
index a9adc416ce7..16cc9ba2c17 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/AccessPolicy.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/AccessPolicy.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AccessPolicy is a definition of an IAM access policy
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public AccessPolicy(List<ResourceAttribute> attributes, List<String> roles) {
         this.roles = roles;
     }
 
+    /**
+     * Attributes identify the resources to which this policy applies
+     */
     @JsonProperty("attributes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ResourceAttribute> getAttributes() {
         return attributes;
     }
 
+    /**
+     * Attributes identify the resources to which this policy applies
+     */
     @JsonProperty("attributes")
     public void setAttributes(List<ResourceAttribute> attributes) {
         this.attributes = attributes;
     }
 
+    /**
+     * Roles are the IAM roles assigned to this policy
+     */
     @JsonProperty("roles")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getRoles() {
         return roles;
     }
 
+    /**
+     * Roles are the IAM roles assigned to this policy
+     */
     @JsonProperty("roles")
     public void setRoles(List<String> roles) {
         this.roles = roles;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/AzureProviderSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/AzureProviderSpec.java
index dc7a21544f4..65a506ab979 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/AzureProviderSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/AzureProviderSpec.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzureProviderSpec contains the required information to create RBAC role bindings for Azure.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,9 +85,6 @@
 public class AzureProviderSpec implements Editable<AzureProviderSpecBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cloudcredential.openshift.io/v1";
     @JsonProperty("azureClientID")
@@ -98,9 +98,6 @@ public class AzureProviderSpec implements Editable<AzureProviderSpecBuilder>, Ku
     @JsonProperty("dataPermissions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<String> dataPermissions = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AzureProviderSpec";
     @JsonProperty("permissions")
@@ -132,7 +129,7 @@ public AzureProviderSpec(String apiVersion, String azureClientID, String azureRe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -140,66 +137,96 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * The following fields are only required for Azure Workload Identity. AzureClientID is the ID of the specific application you created in Azure
+     */
     @JsonProperty("azureClientID")
     public String getAzureClientID() {
         return azureClientID;
     }
 
+    /**
+     * The following fields are only required for Azure Workload Identity. AzureClientID is the ID of the specific application you created in Azure
+     */
     @JsonProperty("azureClientID")
     public void setAzureClientID(String azureClientID) {
         this.azureClientID = azureClientID;
     }
 
+    /**
+     * AzureRegion is the geographic region of the Azure service.
+     */
     @JsonProperty("azureRegion")
     public String getAzureRegion() {
         return azureRegion;
     }
 
+    /**
+     * AzureRegion is the geographic region of the Azure service.
+     */
     @JsonProperty("azureRegion")
     public void setAzureRegion(String azureRegion) {
         this.azureRegion = azureRegion;
     }
 
+    /**
+     * Each Azure subscription has an ID associated with it, as does the tenant to which a subscription belongs. AzureSubscriptionID is the ID of the subscription.
+     */
     @JsonProperty("azureSubscriptionID")
     public String getAzureSubscriptionID() {
         return azureSubscriptionID;
     }
 
+    /**
+     * Each Azure subscription has an ID associated with it, as does the tenant to which a subscription belongs. AzureSubscriptionID is the ID of the subscription.
+     */
     @JsonProperty("azureSubscriptionID")
     public void setAzureSubscriptionID(String azureSubscriptionID) {
         this.azureSubscriptionID = azureSubscriptionID;
     }
 
+    /**
+     * AzureTenantID is the ID of the tenant to which the subscription belongs.
+     */
     @JsonProperty("azureTenantID")
     public String getAzureTenantID() {
         return azureTenantID;
     }
 
+    /**
+     * AzureTenantID is the ID of the tenant to which the subscription belongs.
+     */
     @JsonProperty("azureTenantID")
     public void setAzureTenantID(String azureTenantID) {
         this.azureTenantID = azureTenantID;
     }
 
+    /**
+     * DataPermissions is the list of Azure data permissions required to create a more fine-grained custom role to satisfy the CredentialsRequest. The DataPermissions field may be provided in addition to RoleBindings. When both fields are specified, the user-assigned managed identity will have union of permissions defined from both DataPermissions and RoleBindings.
+     */
     @JsonProperty("dataPermissions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDataPermissions() {
         return dataPermissions;
     }
 
+    /**
+     * DataPermissions is the list of Azure data permissions required to create a more fine-grained custom role to satisfy the CredentialsRequest. The DataPermissions field may be provided in addition to RoleBindings. When both fields are specified, the user-assigned managed identity will have union of permissions defined from both DataPermissions and RoleBindings.
+     */
     @JsonProperty("dataPermissions")
     public void setDataPermissions(List<String> dataPermissions) {
         this.dataPermissions = dataPermissions;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -207,30 +234,42 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Permissions is the list of Azure permissions required to create a more fine-grained custom role to satisfy the CredentialsRequest. The Permissions field may be provided in addition to RoleBindings. When both fields are specified, the user-assigned managed identity will have union of permissions defined from both Permissions and RoleBindings.
+     */
     @JsonProperty("permissions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPermissions() {
         return permissions;
     }
 
+    /**
+     * Permissions is the list of Azure permissions required to create a more fine-grained custom role to satisfy the CredentialsRequest. The Permissions field may be provided in addition to RoleBindings. When both fields are specified, the user-assigned managed identity will have union of permissions defined from both Permissions and RoleBindings.
+     */
     @JsonProperty("permissions")
     public void setPermissions(List<String> permissions) {
         this.permissions = permissions;
     }
 
+    /**
+     * RoleBindings contains a list of roles that should be associated with the minted credential.
+     */
     @JsonProperty("roleBindings")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RoleBinding> getRoleBindings() {
         return roleBindings;
     }
 
+    /**
+     * RoleBindings contains a list of roles that should be associated with the minted credential.
+     */
     @JsonProperty("roleBindings")
     public void setRoleBindings(List<RoleBinding> roleBindings) {
         this.roleBindings = roleBindings;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/AzureProviderStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/AzureProviderStatus.java
index 2c947a6e842..98644ac4bbd 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/AzureProviderStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/AzureProviderStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzureProviderStatus contains the status of the credentials request in Azure.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,16 +79,10 @@
 public class AzureProviderStatus implements Editable<AzureProviderStatusBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cloudcredential.openshift.io/v1";
     @JsonProperty("appID")
     private String appID;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AzureProviderStatus";
     @JsonProperty("name")
@@ -111,7 +108,7 @@ public AzureProviderStatus(String apiVersion, String appID, String kind, String
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,25 +116,31 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * AppID is the application id of the service principal created in Azure for these credentials.
+     */
     @JsonProperty("appID")
     public String getAppID() {
         return appID;
     }
 
+    /**
+     * AppID is the application id of the service principal created in Azure for these credentials.
+     */
     @JsonProperty("appID")
     public void setAppID(String appID) {
         this.appID = appID;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -145,28 +148,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ServicePrincipalName is the name of the service principal created in Azure for these credentials.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * ServicePrincipalName is the name of the service principal created in Azure for these credentials.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * SecretLastResourceVersion is the resource version of the secret resource that was last synced. Used to determine if the object has changed and requires a sync.
+     */
     @JsonProperty("secretLastResourceVersion")
     public String getSecretLastResourceVersion() {
         return secretLastResourceVersion;
     }
 
+    /**
+     * SecretLastResourceVersion is the resource version of the secret resource that was last synced. Used to determine if the object has changed and requires a sync.
+     */
     @JsonProperty("secretLastResourceVersion")
     public void setSecretLastResourceVersion(String secretLastResourceVersion) {
         this.secretLastResourceVersion = secretLastResourceVersion;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/CredentialsRequest.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/CredentialsRequest.java
index f9d926c15c4..a01f518fcf0 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/CredentialsRequest.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/CredentialsRequest.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CredentialsRequest is the Schema for the credentialsrequests API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class CredentialsRequest implements Editable<CredentialsRequestBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cloudcredential.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CredentialsRequest";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CredentialsRequest(String apiVersion, String kind, ObjectMeta metadata, C
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CredentialsRequest is the Schema for the credentialsrequests API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CredentialsRequest is the Schema for the credentialsrequests API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * CredentialsRequest is the Schema for the credentialsrequests API
+     */
     @JsonProperty("spec")
     public CredentialsRequestSpec getSpec() {
         return spec;
     }
 
+    /**
+     * CredentialsRequest is the Schema for the credentialsrequests API
+     */
     @JsonProperty("spec")
     public void setSpec(CredentialsRequestSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * CredentialsRequest is the Schema for the credentialsrequests API
+     */
     @JsonProperty("status")
     public CredentialsRequestStatus getStatus() {
         return status;
     }
 
+    /**
+     * CredentialsRequest is the Schema for the credentialsrequests API
+     */
     @JsonProperty("status")
     public void setStatus(CredentialsRequestStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/CredentialsRequestCondition.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/CredentialsRequestCondition.java
index 5a6737aab54..28bb3ede3ea 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/CredentialsRequestCondition.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/CredentialsRequestCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CredentialsRequestCondition contains details for any of the conditions on a CredentialsRequest object
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public CredentialsRequestCondition(String lastProbeTime, String lastTransitionTi
         this.type = type;
     }
 
+    /**
+     * CredentialsRequestCondition contains details for any of the conditions on a CredentialsRequest object
+     */
     @JsonProperty("lastProbeTime")
     public String getLastProbeTime() {
         return lastProbeTime;
     }
 
+    /**
+     * CredentialsRequestCondition contains details for any of the conditions on a CredentialsRequest object
+     */
     @JsonProperty("lastProbeTime")
     public void setLastProbeTime(String lastProbeTime) {
         this.lastProbeTime = lastProbeTime;
     }
 
+    /**
+     * CredentialsRequestCondition contains details for any of the conditions on a CredentialsRequest object
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * CredentialsRequestCondition contains details for any of the conditions on a CredentialsRequest object
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Message is a human-readable message indicating details about the last transition
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message is a human-readable message indicating details about the last transition
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Reason is a unique, one-word, CamelCase reason for the condition's last transition
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason is a unique, one-word, CamelCase reason for the condition's last transition
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status is the status of the condition
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status is the status of the condition
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type is the specific type of the condition
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the specific type of the condition
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/CredentialsRequestList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/CredentialsRequestList.java
index 50da35ad9bb..0fec32302d8 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/CredentialsRequestList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/CredentialsRequestList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CredentialsRequestList contains a list of CredentialsRequest
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class CredentialsRequestList implements Editable<CredentialsRequestListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.cloudcredential.v1.CredentialsRequest>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cloudcredential.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.cloudcredential.v1.CredentialsRequest> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CredentialsRequestList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CredentialsRequestList(String apiVersion, List<io.fabric8.openshift.api.m
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * CredentialsRequestList contains a list of CredentialsRequest
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.miscellaneous.cloudcredential.v1.CredentialsRequest> getItems() {
         return items;
     }
 
+    /**
+     * CredentialsRequestList contains a list of CredentialsRequest
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.cloudcredential.v1.CredentialsRequest> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CredentialsRequestList contains a list of CredentialsRequest
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CredentialsRequestList contains a list of CredentialsRequest
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/CredentialsRequestSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/CredentialsRequestSpec.java
index b9448db798e..10be91f359f 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/CredentialsRequestSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/CredentialsRequestSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CredentialsRequestSpec defines the desired state of CredentialsRequest
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,43 +97,67 @@ public CredentialsRequestSpec(String cloudTokenPath, Object providerSpec, Object
         this.serviceAccountNames = serviceAccountNames;
     }
 
+    /**
+     * cloudTokenPath is the path where the Kubernetes ServiceAccount token (JSON Web Token) is mounted on the deployment for the workload requesting a credentials secret. The presence of this field in combination with fields such as spec.providerSpec.stsIAMRoleARN indicate that CCO should broker creation of a credentials secret containing fields necessary for token based authentication methods such as with the AWS Secure Token Service (STS).<br><p> <br><p> cloudTokenPath may also be used to specify the azure_federated_token_file path used in Azure configuration secrets generated by ccoctl. Defaults to "/var/run/secrets/openshift/serviceaccount/token".
+     */
     @JsonProperty("cloudTokenPath")
     public String getCloudTokenPath() {
         return cloudTokenPath;
     }
 
+    /**
+     * cloudTokenPath is the path where the Kubernetes ServiceAccount token (JSON Web Token) is mounted on the deployment for the workload requesting a credentials secret. The presence of this field in combination with fields such as spec.providerSpec.stsIAMRoleARN indicate that CCO should broker creation of a credentials secret containing fields necessary for token based authentication methods such as with the AWS Secure Token Service (STS).<br><p> <br><p> cloudTokenPath may also be used to specify the azure_federated_token_file path used in Azure configuration secrets generated by ccoctl. Defaults to "/var/run/secrets/openshift/serviceaccount/token".
+     */
     @JsonProperty("cloudTokenPath")
     public void setCloudTokenPath(String cloudTokenPath) {
         this.cloudTokenPath = cloudTokenPath;
     }
 
+    /**
+     * CredentialsRequestSpec defines the desired state of CredentialsRequest
+     */
     @JsonProperty("providerSpec")
     public Object getProviderSpec() {
         return providerSpec;
     }
 
+    /**
+     * CredentialsRequestSpec defines the desired state of CredentialsRequest
+     */
     @JsonProperty("providerSpec")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setProviderSpec(Object providerSpec) {
         this.providerSpec = providerSpec;
     }
 
+    /**
+     * CredentialsRequestSpec defines the desired state of CredentialsRequest
+     */
     @JsonProperty("secretRef")
     public ObjectReference getSecretRef() {
         return secretRef;
     }
 
+    /**
+     * CredentialsRequestSpec defines the desired state of CredentialsRequest
+     */
     @JsonProperty("secretRef")
     public void setSecretRef(ObjectReference secretRef) {
         this.secretRef = secretRef;
     }
 
+    /**
+     * ServiceAccountNames contains a list of ServiceAccounts that will use permissions associated with this CredentialsRequest. This is not used by CCO, but the information is needed for being able to properly set up access control in the cloud provider when the ServiceAccounts are used as part of the cloud credentials flow.
+     */
     @JsonProperty("serviceAccountNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getServiceAccountNames() {
         return serviceAccountNames;
     }
 
+    /**
+     * ServiceAccountNames contains a list of ServiceAccounts that will use permissions associated with this CredentialsRequest. This is not used by CCO, but the information is needed for being able to properly set up access control in the cloud provider when the ServiceAccounts are used as part of the cloud credentials flow.
+     */
     @JsonProperty("serviceAccountNames")
     public void setServiceAccountNames(List<String> serviceAccountNames) {
         this.serviceAccountNames = serviceAccountNames;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/CredentialsRequestStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/CredentialsRequestStatus.java
index fa8115f953f..d5ead147d9d 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/CredentialsRequestStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/CredentialsRequestStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CredentialsRequestStatus defines the observed state of CredentialsRequest
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,63 +105,99 @@ public CredentialsRequestStatus(List<CredentialsRequestCondition> conditions, St
         this.provisioned = provisioned;
     }
 
+    /**
+     * Conditions includes detailed status for the CredentialsRequest
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CredentialsRequestCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions includes detailed status for the CredentialsRequest
+     */
     @JsonProperty("conditions")
     public void setConditions(List<CredentialsRequestCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * LastSyncCloudCredsSecretResourceVersion is the resource version of the cloud credentials secret resource when the credentials request resource was last synced. Used to determine if the cloud credentials have been updated since the last sync.
+     */
     @JsonProperty("lastSyncCloudCredsSecretResourceVersion")
     public String getLastSyncCloudCredsSecretResourceVersion() {
         return lastSyncCloudCredsSecretResourceVersion;
     }
 
+    /**
+     * LastSyncCloudCredsSecretResourceVersion is the resource version of the cloud credentials secret resource when the credentials request resource was last synced. Used to determine if the cloud credentials have been updated since the last sync.
+     */
     @JsonProperty("lastSyncCloudCredsSecretResourceVersion")
     public void setLastSyncCloudCredsSecretResourceVersion(String lastSyncCloudCredsSecretResourceVersion) {
         this.lastSyncCloudCredsSecretResourceVersion = lastSyncCloudCredsSecretResourceVersion;
     }
 
+    /**
+     * LastSyncGeneration is the generation of the credentials request resource that was last synced. Used to determine if the object has changed and requires a sync.
+     */
     @JsonProperty("lastSyncGeneration")
     public Long getLastSyncGeneration() {
         return lastSyncGeneration;
     }
 
+    /**
+     * LastSyncGeneration is the generation of the credentials request resource that was last synced. Used to determine if the object has changed and requires a sync.
+     */
     @JsonProperty("lastSyncGeneration")
     public void setLastSyncGeneration(Long lastSyncGeneration) {
         this.lastSyncGeneration = lastSyncGeneration;
     }
 
+    /**
+     * CredentialsRequestStatus defines the observed state of CredentialsRequest
+     */
     @JsonProperty("lastSyncTimestamp")
     public String getLastSyncTimestamp() {
         return lastSyncTimestamp;
     }
 
+    /**
+     * CredentialsRequestStatus defines the observed state of CredentialsRequest
+     */
     @JsonProperty("lastSyncTimestamp")
     public void setLastSyncTimestamp(String lastSyncTimestamp) {
         this.lastSyncTimestamp = lastSyncTimestamp;
     }
 
+    /**
+     * CredentialsRequestStatus defines the observed state of CredentialsRequest
+     */
     @JsonProperty("providerStatus")
     public Object getProviderStatus() {
         return providerStatus;
     }
 
+    /**
+     * CredentialsRequestStatus defines the observed state of CredentialsRequest
+     */
     @JsonProperty("providerStatus")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setProviderStatus(Object providerStatus) {
         this.providerStatus = providerStatus;
     }
 
+    /**
+     * Provisioned is true once the credentials have been initially provisioned.
+     */
     @JsonProperty("provisioned")
     public Boolean getProvisioned() {
         return provisioned;
     }
 
+    /**
+     * Provisioned is true once the credentials have been initially provisioned.
+     */
     @JsonProperty("provisioned")
     public void setProvisioned(Boolean provisioned) {
         this.provisioned = provisioned;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/GCPProviderSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/GCPProviderSpec.java
index cf36ffeddf9..3ff3df4d4f1 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/GCPProviderSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/GCPProviderSpec.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPProviderSpec contains the required information to create a service account with policy bindings in GCP.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -80,16 +83,10 @@
 public class GCPProviderSpec implements Editable<GCPProviderSpecBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cloudcredential.openshift.io/v1";
     @JsonProperty("audience")
     private String audience;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GCPProviderSpec";
     @JsonProperty("permissions")
@@ -123,7 +120,7 @@ public GCPProviderSpec(String apiVersion, String audience, String kind, List<Str
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -131,25 +128,31 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Audience that will be used with Workload Identity Federation. It should be formatted as follows: "//iam.googleapis.com/projects/&lt;PROJECT_NUMBER&gt;/locations/global/workloadIdentityPools/&lt;POOL_ID&gt;/providers/&lt;PROVIDER_ID&gt;" For more information see https://cloud.google.com/iam/docs/workload-identity-federation-with-other-providers#create-credential-config
+     */
     @JsonProperty("audience")
     public String getAudience() {
         return audience;
     }
 
+    /**
+     * Audience that will be used with Workload Identity Federation. It should be formatted as follows: "//iam.googleapis.com/projects/&lt;PROJECT_NUMBER&gt;/locations/global/workloadIdentityPools/&lt;POOL_ID&gt;/providers/&lt;PROVIDER_ID&gt;" For more information see https://cloud.google.com/iam/docs/workload-identity-federation-with-other-providers#create-credential-config
+     */
     @JsonProperty("audience")
     public void setAudience(String audience) {
         this.audience = audience;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -157,50 +160,74 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Permissions is the list of GCP permissions required to create a more fine-grained custom role to satisfy the CredentialsRequest. The Permissions field may be provided in addition to PredefinedRoles. When both fields are specified, the service account will have union of permissions defined from both Permissions and PredefinedRoles.
+     */
     @JsonProperty("permissions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPermissions() {
         return permissions;
     }
 
+    /**
+     * Permissions is the list of GCP permissions required to create a more fine-grained custom role to satisfy the CredentialsRequest. The Permissions field may be provided in addition to PredefinedRoles. When both fields are specified, the service account will have union of permissions defined from both Permissions and PredefinedRoles.
+     */
     @JsonProperty("permissions")
     public void setPermissions(List<String> permissions) {
         this.permissions = permissions;
     }
 
+    /**
+     * PredefinedRoles is the list of GCP pre-defined roles that the CredentialsRequest requires.
+     */
     @JsonProperty("predefinedRoles")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPredefinedRoles() {
         return predefinedRoles;
     }
 
+    /**
+     * PredefinedRoles is the list of GCP pre-defined roles that the CredentialsRequest requires.
+     */
     @JsonProperty("predefinedRoles")
     public void setPredefinedRoles(List<String> predefinedRoles) {
         this.predefinedRoles = predefinedRoles;
     }
 
+    /**
+     * ServiceAccountEmail that will be impersonated during Workload Identity Federation.
+     */
     @JsonProperty("serviceAccountEmail")
     public String getServiceAccountEmail() {
         return serviceAccountEmail;
     }
 
+    /**
+     * ServiceAccountEmail that will be impersonated during Workload Identity Federation.
+     */
     @JsonProperty("serviceAccountEmail")
     public void setServiceAccountEmail(String serviceAccountEmail) {
         this.serviceAccountEmail = serviceAccountEmail;
     }
 
+    /**
+     * SkipServiceCheck can be set to true to skip the check whether the requested roles or permissions have the necessary services enabled
+     */
     @JsonProperty("skipServiceCheck")
     public Boolean getSkipServiceCheck() {
         return skipServiceCheck;
     }
 
+    /**
+     * SkipServiceCheck can be set to true to skip the check whether the requested roles or permissions have the necessary services enabled
+     */
     @JsonProperty("skipServiceCheck")
     public void setSkipServiceCheck(Boolean skipServiceCheck) {
         this.skipServiceCheck = skipServiceCheck;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/GCPProviderStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/GCPProviderStatus.java
index 64d2e039569..517091d7041 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/GCPProviderStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/GCPProviderStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPProviderStatus contains the status of the GCP credentials request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class GCPProviderStatus implements Editable<GCPProviderStatusBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cloudcredential.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GCPProviderStatus";
     @JsonProperty("roleID")
@@ -107,7 +104,7 @@ public GCPProviderStatus(String apiVersion, String kind, String roleID, String s
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RoleID is the ID of the custom role created in GCP for the requested permissions apart from permissions granted by the pre-defined roles. RoleID is set by the Cloud Credential Operator controllers and should not be set manually.
+     */
     @JsonProperty("roleID")
     public String getRoleID() {
         return roleID;
     }
 
+    /**
+     * RoleID is the ID of the custom role created in GCP for the requested permissions apart from permissions granted by the pre-defined roles. RoleID is set by the Cloud Credential Operator controllers and should not be set manually.
+     */
     @JsonProperty("roleID")
     public void setRoleID(String roleID) {
         this.roleID = roleID;
     }
 
+    /**
+     * ServiceAccountID is the ID of the service account created in GCP for the requested credentials.
+     */
     @JsonProperty("serviceAccountID")
     public String getServiceAccountID() {
         return serviceAccountID;
     }
 
+    /**
+     * ServiceAccountID is the ID of the service account created in GCP for the requested credentials.
+     */
     @JsonProperty("serviceAccountID")
     public void setServiceAccountID(String serviceAccountID) {
         this.serviceAccountID = serviceAccountID;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/IBMCloudPowerVSProviderSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/IBMCloudPowerVSProviderSpec.java
index c46be5b4347..6b1e5f10bea 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/IBMCloudPowerVSProviderSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/IBMCloudPowerVSProviderSpec.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IBMCloudPowerVSProviderSpec is the specification of the credentials request in IBM Cloud Power VS.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class IBMCloudPowerVSProviderSpec implements Editable<IBMCloudPowerVSProviderSpecBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cloudcredential.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "IBMCloudPowerVSProviderSpec";
     @JsonProperty("policies")
@@ -106,7 +103,7 @@ public IBMCloudPowerVSProviderSpec(String apiVersion, String kind, List<AccessPo
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,19 +127,25 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Policies are a list of access policies to create for the generated credentials
+     */
     @JsonProperty("policies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AccessPolicy> getPolicies() {
         return policies;
     }
 
+    /**
+     * Policies are a list of access policies to create for the generated credentials
+     */
     @JsonProperty("policies")
     public void setPolicies(List<AccessPolicy> policies) {
         this.policies = policies;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/IBMCloudPowerVSProviderStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/IBMCloudPowerVSProviderStatus.java
index d8b38d05dd2..819c35977dd 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/IBMCloudPowerVSProviderStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/IBMCloudPowerVSProviderStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IBMCloudPowerVSProviderStatus contains the status of the IBM Cloud Power VS credentials request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -73,14 +76,8 @@
 public class IBMCloudPowerVSProviderStatus implements Editable<IBMCloudPowerVSProviderStatusBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cloudcredential.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "IBMCloudPowerVSProviderStatus";
     @JsonIgnore
@@ -99,7 +96,7 @@ public IBMCloudPowerVSProviderStatus(String apiVersion, String kind) {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -107,7 +104,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -115,7 +112,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -123,7 +120,7 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/IBMCloudProviderSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/IBMCloudProviderSpec.java
index 968988285e1..2d7519465b5 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/IBMCloudProviderSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/IBMCloudProviderSpec.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IBMCloudProviderSpec is the specification of the credentials request in IBM Cloud.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class IBMCloudProviderSpec implements Editable<IBMCloudProviderSpecBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cloudcredential.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "IBMCloudProviderSpec";
     @JsonProperty("policies")
@@ -106,7 +103,7 @@ public IBMCloudProviderSpec(String apiVersion, String kind, List<AccessPolicy> p
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,19 +127,25 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Policies are a list of access policies to create for the generated credentials
+     */
     @JsonProperty("policies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AccessPolicy> getPolicies() {
         return policies;
     }
 
+    /**
+     * Policies are a list of access policies to create for the generated credentials
+     */
     @JsonProperty("policies")
     public void setPolicies(List<AccessPolicy> policies) {
         this.policies = policies;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/IBMCloudProviderStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/IBMCloudProviderStatus.java
index 38c0f4d28aa..f5476eafc7d 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/IBMCloudProviderStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/IBMCloudProviderStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IBMCloudProviderStatus contains the status of the IBM Cloud credentials request.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -73,14 +76,8 @@
 public class IBMCloudProviderStatus implements Editable<IBMCloudProviderStatusBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cloudcredential.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "IBMCloudProviderStatus";
     @JsonIgnore
@@ -99,7 +96,7 @@ public IBMCloudProviderStatus(String apiVersion, String kind) {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -107,7 +104,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -115,7 +112,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -123,7 +120,7 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/KubevirtProviderSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/KubevirtProviderSpec.java
index 806d77d79e8..f8a71b8ed34 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/KubevirtProviderSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/KubevirtProviderSpec.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KubevirtProviderSpec the specification of the credentials request in Kubevirt.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -73,14 +76,8 @@
 public class KubevirtProviderSpec implements Editable<KubevirtProviderSpecBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cloudcredential.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KubevirtProviderSpec";
     @JsonIgnore
@@ -99,7 +96,7 @@ public KubevirtProviderSpec(String apiVersion, String kind) {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -107,7 +104,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -115,7 +112,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -123,7 +120,7 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/KubevirtProviderStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/KubevirtProviderStatus.java
index 3d5906ddb1c..94ec25de0d8 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/KubevirtProviderStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/KubevirtProviderStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KubevirtProviderSpec contains the status of the credentials request in Kubevirt.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -73,14 +76,8 @@
 public class KubevirtProviderStatus implements Editable<KubevirtProviderStatusBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cloudcredential.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KubevirtProviderStatus";
     @JsonIgnore
@@ -99,7 +96,7 @@ public KubevirtProviderStatus(String apiVersion, String kind) {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -107,7 +104,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -115,7 +112,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -123,7 +120,7 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/NutanixProviderSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/NutanixProviderSpec.java
index 12328e80074..d8a96138f9f 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/NutanixProviderSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/NutanixProviderSpec.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NutanixProviderSpec the specification of the credentials request in Nutanix.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -73,14 +76,8 @@
 public class NutanixProviderSpec implements Editable<NutanixProviderSpecBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cloudcredential.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "NutanixProviderSpec";
     @JsonIgnore
@@ -99,7 +96,7 @@ public NutanixProviderSpec(String apiVersion, String kind) {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -107,7 +104,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -115,7 +112,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -123,7 +120,7 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/NutanixProviderStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/NutanixProviderStatus.java
index b612e611e97..a164dbb6967 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/NutanixProviderStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/NutanixProviderStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NutanixProviderStatus contains the status of the credentials request in Nutanix.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -73,14 +76,8 @@
 public class NutanixProviderStatus implements Editable<NutanixProviderStatusBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cloudcredential.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "NutanixProviderStatus";
     @JsonIgnore
@@ -99,7 +96,7 @@ public NutanixProviderStatus(String apiVersion, String kind) {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -107,7 +104,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -115,7 +112,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -123,7 +120,7 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/OpenStackProviderSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/OpenStackProviderSpec.java
index d359128d63a..6004bc19c6c 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/OpenStackProviderSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/OpenStackProviderSpec.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OpenStackProviderSpec the specification of the credentials request in OpenStack.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -73,14 +76,8 @@
 public class OpenStackProviderSpec implements Editable<OpenStackProviderSpecBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cloudcredential.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OpenStackProviderSpec";
     @JsonIgnore
@@ -99,7 +96,7 @@ public OpenStackProviderSpec(String apiVersion, String kind) {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -107,7 +104,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -115,7 +112,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -123,7 +120,7 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/OpenStackProviderStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/OpenStackProviderStatus.java
index b2cd3f8708d..ced569404c6 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/OpenStackProviderStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/OpenStackProviderStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OpenStackProviderStatus contains the status of the credentials request in OpenStack.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -73,14 +76,8 @@
 public class OpenStackProviderStatus implements Editable<OpenStackProviderStatusBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cloudcredential.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OpenStackProviderStatus";
     @JsonIgnore
@@ -99,7 +96,7 @@ public OpenStackProviderStatus(String apiVersion, String kind) {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -107,7 +104,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -115,7 +112,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -123,7 +120,7 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/OvirtProviderSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/OvirtProviderSpec.java
index 403d285efb2..87382dad7d9 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/OvirtProviderSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/OvirtProviderSpec.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OvirtProviderSpec the specification of the credentials request in Ovirt.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -73,14 +76,8 @@
 public class OvirtProviderSpec implements Editable<OvirtProviderSpecBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cloudcredential.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OvirtProviderSpec";
     @JsonIgnore
@@ -99,7 +96,7 @@ public OvirtProviderSpec(String apiVersion, String kind) {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -107,7 +104,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -115,7 +112,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -123,7 +120,7 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/OvirtProviderStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/OvirtProviderStatus.java
index 0db6f6983cc..01dfccaa46e 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/OvirtProviderStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/OvirtProviderStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OvirtProviderStatus contains the status of the credentials request in Ovirt.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -73,14 +76,8 @@
 public class OvirtProviderStatus implements Editable<OvirtProviderStatusBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cloudcredential.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OvirtProviderStatus";
     @JsonIgnore
@@ -99,7 +96,7 @@ public OvirtProviderStatus(String apiVersion, String kind) {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -107,7 +104,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -115,7 +112,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -123,7 +120,7 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/ResourceAttribute.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/ResourceAttribute.java
index 9a3b4bf1eb4..844183761c3 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/ResourceAttribute.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/ResourceAttribute.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceAttribute is an attribute associated with a resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ResourceAttribute(String name, String operator, String value) {
         this.value = value;
     }
 
+    /**
+     * Name is the name of an attribute.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of an attribute.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Operator is the operator of an attribute.
+     */
     @JsonProperty("operator")
     public String getOperator() {
         return operator;
     }
 
+    /**
+     * Operator is the operator of an attribute.
+     */
     @JsonProperty("operator")
     public void setOperator(String operator) {
         this.operator = operator;
     }
 
+    /**
+     * Value is the value of an attribute.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is the value of an attribute.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/RoleBinding.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/RoleBinding.java
index 741cf06a173..4dd59e2865e 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/RoleBinding.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/RoleBinding.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RoleBinding models part of the Azure RBAC Role Binding
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public RoleBinding(String role) {
         this.role = role;
     }
 
+    /**
+     * Role defines a set of permissions that should be associated with the minted credential.
+     */
     @JsonProperty("role")
     public String getRole() {
         return role;
     }
 
+    /**
+     * Role defines a set of permissions that should be associated with the minted credential.
+     */
     @JsonProperty("role")
     public void setRole(String role) {
         this.role = role;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/StatementEntry.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/StatementEntry.java
index a3999fb426c..4ca5294a38b 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/StatementEntry.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/StatementEntry.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StatementEntry models an AWS policy statement entry.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,43 +97,67 @@ public StatementEntry(List<String> action, String effect, Map<String, Map<String
         this.resource = resource;
     }
 
+    /**
+     * Action describes the particular AWS service actions that should be allowed or denied. (i.e. ec2:StartInstances, iam:ChangePassword)
+     */
     @JsonProperty("action")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAction() {
         return action;
     }
 
+    /**
+     * Action describes the particular AWS service actions that should be allowed or denied. (i.e. ec2:StartInstances, iam:ChangePassword)
+     */
     @JsonProperty("action")
     public void setAction(List<String> action) {
         this.action = action;
     }
 
+    /**
+     * Effect indicates if this policy statement is to Allow or Deny.
+     */
     @JsonProperty("effect")
     public String getEffect() {
         return effect;
     }
 
+    /**
+     * Effect indicates if this policy statement is to Allow or Deny.
+     */
     @JsonProperty("effect")
     public void setEffect(String effect) {
         this.effect = effect;
     }
 
+    /**
+     * PolicyCondition specifies under which condition StatementEntry will apply
+     */
     @JsonProperty("policyCondition")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Map<String, Object>> getPolicyCondition() {
         return policyCondition;
     }
 
+    /**
+     * PolicyCondition specifies under which condition StatementEntry will apply
+     */
     @JsonProperty("policyCondition")
     public void setPolicyCondition(Map<String, Map<String, Object>> policyCondition) {
         this.policyCondition = policyCondition;
     }
 
+    /**
+     * Resource specifies the object(s) this statement should apply to. (or "&#42;" for all)
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * Resource specifies the object(s) this statement should apply to. (or "&#42;" for all)
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/VSpherePermission.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/VSpherePermission.java
index 8c2928416ad..a5e530e529a 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/VSpherePermission.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/VSpherePermission.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VSpherePermission captures the details of the privileges being requested for the list of entities.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public VSpherePermission(List<String> privileges) {
         this.privileges = privileges;
     }
 
+    /**
+     * Privileges is the list of access being requested.
+     */
     @JsonProperty("privileges")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPrivileges() {
         return privileges;
     }
 
+    /**
+     * Privileges is the list of access being requested.
+     */
     @JsonProperty("privileges")
     public void setPrivileges(List<String> privileges) {
         this.privileges = privileges;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/VSphereProviderSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/VSphereProviderSpec.java
index ea3cbb6ed7a..5a6336c6f21 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/VSphereProviderSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/VSphereProviderSpec.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VSphereProviderSpec contains the required information to create RBAC role bindings for VSphere.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class VSphereProviderSpec implements Editable<VSphereProviderSpecBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cloudcredential.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VSphereProviderSpec";
     @JsonProperty("permissions")
@@ -106,7 +103,7 @@ public VSphereProviderSpec(String apiVersion, String kind, List<VSpherePermissio
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,19 +127,25 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Permissions contains a list of groups of privileges that are being requested.
+     */
     @JsonProperty("permissions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VSpherePermission> getPermissions() {
         return permissions;
     }
 
+    /**
+     * Permissions contains a list of groups of privileges that are being requested.
+     */
     @JsonProperty("permissions")
     public void setPermissions(List<VSpherePermission> permissions) {
         this.permissions = permissions;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/VSphereProviderStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/VSphereProviderStatus.java
index 8cfdec41ee6..ae5cfa97118 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/VSphereProviderStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cloudcredential/v1/VSphereProviderStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VSphereProviderStatus contains the status of the credentials request in VSphere.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class VSphereProviderStatus implements Editable<VSphereProviderStatusBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cloudcredential.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "VSphereProviderStatus";
     @JsonProperty("secretLastResourceVersion")
@@ -103,7 +100,7 @@ public VSphereProviderStatus(String apiVersion, String kind, String secretLastRe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -111,7 +108,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -119,7 +116,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -127,18 +124,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SecretLastResourceVersion is the resource version of the secret resource that was last synced. Used to determine if the object has changed and requires a sync.
+     */
     @JsonProperty("secretLastResourceVersion")
     public String getSecretLastResourceVersion() {
         return secretLastResourceVersion;
     }
 
+    /**
+     * SecretLastResourceVersion is the resource version of the secret resource that was last synced. Used to determine if the object has changed and requires a sync.
+     */
     @JsonProperty("secretLastResourceVersion")
     public void setSecretLastResourceVersion(String secretLastResourceVersion) {
         this.secretLastResourceVersion = secretLastResourceVersion;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/BandwidthEntry.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/BandwidthEntry.java
index e8ea47a1d84..b90b901f037 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/BandwidthEntry.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/BandwidthEntry.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BandwidthEntry for CNI BandwidthEntry
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public BandwidthEntry(Integer egressBurst, Integer egressRate, Integer ingressBu
         this.ingressRate = ingressRate;
     }
 
+    /**
+     * BandwidthEntry for CNI BandwidthEntry
+     */
     @JsonProperty("egressBurst")
     public Integer getEgressBurst() {
         return egressBurst;
     }
 
+    /**
+     * BandwidthEntry for CNI BandwidthEntry
+     */
     @JsonProperty("egressBurst")
     public void setEgressBurst(Integer egressBurst) {
         this.egressBurst = egressBurst;
     }
 
+    /**
+     * BandwidthEntry for CNI BandwidthEntry
+     */
     @JsonProperty("egressRate")
     public Integer getEgressRate() {
         return egressRate;
     }
 
+    /**
+     * BandwidthEntry for CNI BandwidthEntry
+     */
     @JsonProperty("egressRate")
     public void setEgressRate(Integer egressRate) {
         this.egressRate = egressRate;
     }
 
+    /**
+     * BandwidthEntry for CNI BandwidthEntry
+     */
     @JsonProperty("ingressBurst")
     public Integer getIngressBurst() {
         return ingressBurst;
     }
 
+    /**
+     * BandwidthEntry for CNI BandwidthEntry
+     */
     @JsonProperty("ingressBurst")
     public void setIngressBurst(Integer ingressBurst) {
         this.ingressBurst = ingressBurst;
     }
 
+    /**
+     * BandwidthEntry for CNI BandwidthEntry
+     */
     @JsonProperty("ingressRate")
     public Integer getIngressRate() {
         return ingressRate;
     }
 
+    /**
+     * BandwidthEntry for CNI BandwidthEntry
+     */
     @JsonProperty("ingressRate")
     public void setIngressRate(Integer ingressRate) {
         this.ingressRate = ingressRate;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/DNS.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/DNS.java
index 4dad021c15d..04622489641 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/DNS.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/DNS.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNS contains values interesting for DNS resolvers
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,44 +98,68 @@ public DNS(String domain, List<String> nameservers, List<String> options, List<S
         this.search = search;
     }
 
+    /**
+     * DNS contains values interesting for DNS resolvers
+     */
     @JsonProperty("domain")
     public String getDomain() {
         return domain;
     }
 
+    /**
+     * DNS contains values interesting for DNS resolvers
+     */
     @JsonProperty("domain")
     public void setDomain(String domain) {
         this.domain = domain;
     }
 
+    /**
+     * DNS contains values interesting for DNS resolvers
+     */
     @JsonProperty("nameservers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNameservers() {
         return nameservers;
     }
 
+    /**
+     * DNS contains values interesting for DNS resolvers
+     */
     @JsonProperty("nameservers")
     public void setNameservers(List<String> nameservers) {
         this.nameservers = nameservers;
     }
 
+    /**
+     * DNS contains values interesting for DNS resolvers
+     */
     @JsonProperty("options")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getOptions() {
         return options;
     }
 
+    /**
+     * DNS contains values interesting for DNS resolvers
+     */
     @JsonProperty("options")
     public void setOptions(List<String> options) {
         this.options = options;
     }
 
+    /**
+     * DNS contains values interesting for DNS resolvers
+     */
     @JsonProperty("search")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSearch() {
         return search;
     }
 
+    /**
+     * DNS contains values interesting for DNS resolvers
+     */
     @JsonProperty("search")
     public void setSearch(List<String> search) {
         this.search = search;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/DeviceInfo.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/DeviceInfo.java
index f7840bc6959..8225a376b90 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/DeviceInfo.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/DeviceInfo.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeviceInfo contains the information of the device associated with this network (if any)
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public DeviceInfo(MemifDevice memif, PciDevice pci, String type, VdpaDevice vdpa
         this.vhostUser = vhostUser;
     }
 
+    /**
+     * DeviceInfo contains the information of the device associated with this network (if any)
+     */
     @JsonProperty("memif")
     public MemifDevice getMemif() {
         return memif;
     }
 
+    /**
+     * DeviceInfo contains the information of the device associated with this network (if any)
+     */
     @JsonProperty("memif")
     public void setMemif(MemifDevice memif) {
         this.memif = memif;
     }
 
+    /**
+     * DeviceInfo contains the information of the device associated with this network (if any)
+     */
     @JsonProperty("pci")
     public PciDevice getPci() {
         return pci;
     }
 
+    /**
+     * DeviceInfo contains the information of the device associated with this network (if any)
+     */
     @JsonProperty("pci")
     public void setPci(PciDevice pci) {
         this.pci = pci;
     }
 
+    /**
+     * DeviceInfo contains the information of the device associated with this network (if any)
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * DeviceInfo contains the information of the device associated with this network (if any)
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * DeviceInfo contains the information of the device associated with this network (if any)
+     */
     @JsonProperty("vdpa")
     public VdpaDevice getVdpa() {
         return vdpa;
     }
 
+    /**
+     * DeviceInfo contains the information of the device associated with this network (if any)
+     */
     @JsonProperty("vdpa")
     public void setVdpa(VdpaDevice vdpa) {
         this.vdpa = vdpa;
     }
 
+    /**
+     * DeviceInfo contains the information of the device associated with this network (if any)
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * DeviceInfo contains the information of the device associated with this network (if any)
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
     }
 
+    /**
+     * DeviceInfo contains the information of the device associated with this network (if any)
+     */
     @JsonProperty("vhost-user")
     public VhostDevice getVhostUser() {
         return vhostUser;
     }
 
+    /**
+     * DeviceInfo contains the information of the device associated with this network (if any)
+     */
     @JsonProperty("vhost-user")
     public void setVhostUser(VhostDevice vhostUser) {
         this.vhostUser = vhostUser;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/NetworkAttachmentDefinition.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/NetworkAttachmentDefinition.java
index a390744b12d..10a1b388b9f 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/NetworkAttachmentDefinition.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/NetworkAttachmentDefinition.java
@@ -75,14 +75,8 @@
 public class NetworkAttachmentDefinition implements Editable<NetworkAttachmentDefinitionBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "k8s.cni.cncf.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "NetworkAttachmentDefinition";
     @JsonProperty("metadata")
@@ -107,7 +101,7 @@ public NetworkAttachmentDefinition(String apiVersion, String kind, ObjectMeta me
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +109,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +117,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,7 +125,7 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/NetworkAttachmentDefinitionList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/NetworkAttachmentDefinitionList.java
index 29121ec4dc5..8c476d723b4 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/NetworkAttachmentDefinitionList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/NetworkAttachmentDefinitionList.java
@@ -78,17 +78,11 @@
 public class NetworkAttachmentDefinitionList implements Editable<NetworkAttachmentDefinitionListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.cncf.cni.v1.NetworkAttachmentDefinition>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "k8s.cni.cncf.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.cncf.cni.v1.NetworkAttachmentDefinition> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "NetworkAttachmentDefinitionList";
     @JsonProperty("metadata")
@@ -111,7 +105,7 @@ public NetworkAttachmentDefinitionList(String apiVersion, List<io.fabric8.opensh
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +113,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -138,7 +132,7 @@ public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.cncf.cni.
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,7 +140,7 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/NetworkSelectionElement.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/NetworkSelectionElement.java
index 45263c974d9..b463c3f59ad 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/NetworkSelectionElement.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/NetworkSelectionElement.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkSelectionElement represents one element of the JSON format Network Attachment Selection Annotation as described in section 4.1.2 of the CRD specification.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -125,116 +128,182 @@ public NetworkSelectionElement(BandwidthEntry bandwidth, Map<String, Object> cni
         this.portMappings = portMappings;
     }
 
+    /**
+     * NetworkSelectionElement represents one element of the JSON format Network Attachment Selection Annotation as described in section 4.1.2 of the CRD specification.
+     */
     @JsonProperty("bandwidth")
     public BandwidthEntry getBandwidth() {
         return bandwidth;
     }
 
+    /**
+     * NetworkSelectionElement represents one element of the JSON format Network Attachment Selection Annotation as described in section 4.1.2 of the CRD specification.
+     */
     @JsonProperty("bandwidth")
     public void setBandwidth(BandwidthEntry bandwidth) {
         this.bandwidth = bandwidth;
     }
 
+    /**
+     * CNIArgs contains additional CNI arguments for the network interface
+     */
     @JsonProperty("cni-args")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Object> getCniArgs() {
         return cniArgs;
     }
 
+    /**
+     * CNIArgs contains additional CNI arguments for the network interface
+     */
     @JsonProperty("cni-args")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializerForMap.class)
     public void setCniArgs(Map<String, Object> cniArgs) {
         this.cniArgs = cniArgs;
     }
 
+    /**
+     * GatewayRequest contains default route IP address for the pod
+     */
     @JsonProperty("default-route")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDefaultRoute() {
         return defaultRoute;
     }
 
+    /**
+     * GatewayRequest contains default route IP address for the pod
+     */
     @JsonProperty("default-route")
     public void setDefaultRoute(List<String> defaultRoute) {
         this.defaultRoute = defaultRoute;
     }
 
+    /**
+     * InfinibandGUIDRequest contains an optional requested Infiniband GUID address for this network attachment
+     */
     @JsonProperty("infiniband-guid")
     public String getInfinibandGuid() {
         return infinibandGuid;
     }
 
+    /**
+     * InfinibandGUIDRequest contains an optional requested Infiniband GUID address for this network attachment
+     */
     @JsonProperty("infiniband-guid")
     public void setInfinibandGuid(String infinibandGuid) {
         this.infinibandGuid = infinibandGuid;
     }
 
+    /**
+     * InterfaceRequest contains an optional requested name for the network interface this attachment will create in the container
+     */
     @JsonProperty("interface")
     public String getInterface() {
         return _interface;
     }
 
+    /**
+     * InterfaceRequest contains an optional requested name for the network interface this attachment will create in the container
+     */
     @JsonProperty("interface")
     public void setInterface(String _interface) {
         this._interface = _interface;
     }
 
+    /**
+     * IPAMClaimReference container the IPAMClaim name where the IPs for this attachment will be located.
+     */
     @JsonProperty("ipam-claim-reference")
     public String getIpamClaimReference() {
         return ipamClaimReference;
     }
 
+    /**
+     * IPAMClaimReference container the IPAMClaim name where the IPs for this attachment will be located.
+     */
     @JsonProperty("ipam-claim-reference")
     public void setIpamClaimReference(String ipamClaimReference) {
         this.ipamClaimReference = ipamClaimReference;
     }
 
+    /**
+     * IPRequest contains an optional requested IP addresses for this network attachment
+     */
     @JsonProperty("ips")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIps() {
         return ips;
     }
 
+    /**
+     * IPRequest contains an optional requested IP addresses for this network attachment
+     */
     @JsonProperty("ips")
     public void setIps(List<String> ips) {
         this.ips = ips;
     }
 
+    /**
+     * MacRequest contains an optional requested MAC address for this network attachment
+     */
     @JsonProperty("mac")
     public String getMac() {
         return mac;
     }
 
+    /**
+     * MacRequest contains an optional requested MAC address for this network attachment
+     */
     @JsonProperty("mac")
     public void setMac(String mac) {
         this.mac = mac;
     }
 
+    /**
+     * Name contains the name of the Network object this element selects
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name contains the name of the Network object this element selects
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace contains the optional namespace that the network referenced by Name exists in
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace contains the optional namespace that the network referenced by Name exists in
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * PortMappingsRequest contains an optional requested port mapping for the network
+     */
     @JsonProperty("portMappings")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PortMapEntry> getPortMappings() {
         return portMappings;
     }
 
+    /**
+     * PortMappingsRequest contains an optional requested port mapping for the network
+     */
     @JsonProperty("portMappings")
     public void setPortMappings(List<PortMapEntry> portMappings) {
         this.portMappings = portMappings;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/NetworkStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/NetworkStatus.java
index 11bc4ee37f3..1eb2afbefdf 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/NetworkStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/NetworkStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkStatus is for network status annotation for pod
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -114,93 +117,147 @@ public NetworkStatus(Boolean _default, DeviceInfo deviceInfo, DNS dns, List<Stri
         this.name = name;
     }
 
+    /**
+     * NetworkStatus is for network status annotation for pod
+     */
     @JsonProperty("default")
     public Boolean getDefault() {
         return _default;
     }
 
+    /**
+     * NetworkStatus is for network status annotation for pod
+     */
     @JsonProperty("default")
     public void setDefault(Boolean _default) {
         this._default = _default;
     }
 
+    /**
+     * NetworkStatus is for network status annotation for pod
+     */
     @JsonProperty("device-info")
     public DeviceInfo getDeviceInfo() {
         return deviceInfo;
     }
 
+    /**
+     * NetworkStatus is for network status annotation for pod
+     */
     @JsonProperty("device-info")
     public void setDeviceInfo(DeviceInfo deviceInfo) {
         this.deviceInfo = deviceInfo;
     }
 
+    /**
+     * NetworkStatus is for network status annotation for pod
+     */
     @JsonProperty("dns")
     public DNS getDns() {
         return dns;
     }
 
+    /**
+     * NetworkStatus is for network status annotation for pod
+     */
     @JsonProperty("dns")
     public void setDns(DNS dns) {
         this.dns = dns;
     }
 
+    /**
+     * NetworkStatus is for network status annotation for pod
+     */
     @JsonProperty("gateway")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getGateway() {
         return gateway;
     }
 
+    /**
+     * NetworkStatus is for network status annotation for pod
+     */
     @JsonProperty("gateway")
     public void setGateway(List<String> gateway) {
         this.gateway = gateway;
     }
 
+    /**
+     * NetworkStatus is for network status annotation for pod
+     */
     @JsonProperty("interface")
     public String getInterface() {
         return _interface;
     }
 
+    /**
+     * NetworkStatus is for network status annotation for pod
+     */
     @JsonProperty("interface")
     public void setInterface(String _interface) {
         this._interface = _interface;
     }
 
+    /**
+     * NetworkStatus is for network status annotation for pod
+     */
     @JsonProperty("ips")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIps() {
         return ips;
     }
 
+    /**
+     * NetworkStatus is for network status annotation for pod
+     */
     @JsonProperty("ips")
     public void setIps(List<String> ips) {
         this.ips = ips;
     }
 
+    /**
+     * NetworkStatus is for network status annotation for pod
+     */
     @JsonProperty("mac")
     public String getMac() {
         return mac;
     }
 
+    /**
+     * NetworkStatus is for network status annotation for pod
+     */
     @JsonProperty("mac")
     public void setMac(String mac) {
         this.mac = mac;
     }
 
+    /**
+     * NetworkStatus is for network status annotation for pod
+     */
     @JsonProperty("mtu")
     public Integer getMtu() {
         return mtu;
     }
 
+    /**
+     * NetworkStatus is for network status annotation for pod
+     */
     @JsonProperty("mtu")
     public void setMtu(Integer mtu) {
         this.mtu = mtu;
     }
 
+    /**
+     * NetworkStatus is for network status annotation for pod
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * NetworkStatus is for network status annotation for pod
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/NoK8sNetworkError.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/NoK8sNetworkError.java
index 934f2cf6e3f..6bddcda310a 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/NoK8sNetworkError.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/NoK8sNetworkError.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NoK8sNetworkError indicates error, no network in kubernetes
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public NoK8sNetworkError(String message) {
         this.message = message;
     }
 
+    /**
+     * NoK8sNetworkError indicates error, no network in kubernetes
+     */
     @JsonProperty("Message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * NoK8sNetworkError indicates error, no network in kubernetes
+     */
     @JsonProperty("Message")
     public void setMessage(String message) {
         this.message = message;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/PortMapEntry.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/PortMapEntry.java
index 28981594315..482649a3cd3 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/PortMapEntry.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/cncf/cni/v1/PortMapEntry.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PortMapEntry for CNI PortMapEntry
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public PortMapEntry(Integer containerPort, String hostIP, Integer hostPort, Stri
         this.protocol = protocol;
     }
 
+    /**
+     * PortMapEntry for CNI PortMapEntry
+     */
     @JsonProperty("containerPort")
     public Integer getContainerPort() {
         return containerPort;
     }
 
+    /**
+     * PortMapEntry for CNI PortMapEntry
+     */
     @JsonProperty("containerPort")
     public void setContainerPort(Integer containerPort) {
         this.containerPort = containerPort;
     }
 
+    /**
+     * PortMapEntry for CNI PortMapEntry
+     */
     @JsonProperty("hostIP")
     public String getHostIP() {
         return hostIP;
     }
 
+    /**
+     * PortMapEntry for CNI PortMapEntry
+     */
     @JsonProperty("hostIP")
     public void setHostIP(String hostIP) {
         this.hostIP = hostIP;
     }
 
+    /**
+     * PortMapEntry for CNI PortMapEntry
+     */
     @JsonProperty("hostPort")
     public Integer getHostPort() {
         return hostPort;
     }
 
+    /**
+     * PortMapEntry for CNI PortMapEntry
+     */
     @JsonProperty("hostPort")
     public void setHostPort(Integer hostPort) {
         this.hostPort = hostPort;
     }
 
+    /**
+     * PortMapEntry for CNI PortMapEntry
+     */
     @JsonProperty("protocol")
     public String getProtocol() {
         return protocol;
     }
 
+    /**
+     * PortMapEntry for CNI PortMapEntry
+     */
     @JsonProperty("protocol")
     public void setProtocol(String protocol) {
         this.protocol = protocol;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/ConnectionConfig.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/ConnectionConfig.java
index f40de13ed26..d063abba84c 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/ConnectionConfig.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/ConnectionConfig.java
@@ -108,11 +108,17 @@ public void setTlsClientConfig(SecretNameReference tlsClientConfig) {
         this.tlsClientConfig = tlsClientConfig;
     }
 
+    /**
+     * Chart repository URL
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * Chart repository URL
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/ConnectionConfigNamespaceScoped.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/ConnectionConfigNamespaceScoped.java
index d9299c4ed71..dc720e0cb76 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/ConnectionConfigNamespaceScoped.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/ConnectionConfigNamespaceScoped.java
@@ -122,11 +122,17 @@ public void setTlsClientConfig(SecretNameReference tlsClientConfig) {
         this.tlsClientConfig = tlsClientConfig;
     }
 
+    /**
+     * Chart repository URL
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * Chart repository URL
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/HelmChartRepository.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/HelmChartRepository.java
index b45890f34e9..d9a2876affc 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/HelmChartRepository.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/HelmChartRepository.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HelmChartRepository holds cluster-wide configuration for proxied Helm chart repository<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class HelmChartRepository implements Editable<HelmChartRepositoryBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "helm.openshift.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "HelmChartRepository";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public HelmChartRepository(String apiVersion, String kind, ObjectMeta metadata,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * HelmChartRepository holds cluster-wide configuration for proxied Helm chart repository<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * HelmChartRepository holds cluster-wide configuration for proxied Helm chart repository<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * HelmChartRepository holds cluster-wide configuration for proxied Helm chart repository<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public HelmChartRepositorySpec getSpec() {
         return spec;
     }
 
+    /**
+     * HelmChartRepository holds cluster-wide configuration for proxied Helm chart repository<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(HelmChartRepositorySpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * HelmChartRepository holds cluster-wide configuration for proxied Helm chart repository<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public HelmChartRepositoryStatus getStatus() {
         return status;
     }
 
+    /**
+     * HelmChartRepository holds cluster-wide configuration for proxied Helm chart repository<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(HelmChartRepositoryStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/HelmChartRepositoryList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/HelmChartRepositoryList.java
index 505f28dd32c..800d7f1f01e 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/HelmChartRepositoryList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/HelmChartRepositoryList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class HelmChartRepositoryList implements Editable<HelmChartRepositoryListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.helm.v1beta1.HelmChartRepository>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "helm.openshift.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.helm.v1beta1.HelmChartRepository> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "HelmChartRepositoryList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public HelmChartRepositoryList(String apiVersion, List<io.fabric8.openshift.api.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.miscellaneous.helm.v1beta1.HelmChartRepository> getItems() {
         return items;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.helm.v1beta1.HelmChartRepository> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/HelmChartRepositorySpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/HelmChartRepositorySpec.java
index be09087aafe..34a62405323 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/HelmChartRepositorySpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/HelmChartRepositorySpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Helm chart repository exposed within the cluster
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public HelmChartRepositorySpec(ConnectionConfig connectionConfig, String descrip
         this.name = name;
     }
 
+    /**
+     * Helm chart repository exposed within the cluster
+     */
     @JsonProperty("connectionConfig")
     public ConnectionConfig getConnectionConfig() {
         return connectionConfig;
     }
 
+    /**
+     * Helm chart repository exposed within the cluster
+     */
     @JsonProperty("connectionConfig")
     public void setConnectionConfig(ConnectionConfig connectionConfig) {
         this.connectionConfig = connectionConfig;
     }
 
+    /**
+     * Optional human readable repository description, it can be used by UI for displaying purposes
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Optional human readable repository description, it can be used by UI for displaying purposes
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * If set to true, disable the repo usage in the cluster/namespace
+     */
     @JsonProperty("disabled")
     public Boolean getDisabled() {
         return disabled;
     }
 
+    /**
+     * If set to true, disable the repo usage in the cluster/namespace
+     */
     @JsonProperty("disabled")
     public void setDisabled(Boolean disabled) {
         this.disabled = disabled;
     }
 
+    /**
+     * Optional associated human readable repository name, it can be used by UI for displaying purposes
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Optional associated human readable repository name, it can be used by UI for displaying purposes
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/HelmChartRepositoryStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/HelmChartRepositoryStatus.java
index 7709b927557..9a0a066a434 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/HelmChartRepositoryStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/HelmChartRepositoryStatus.java
@@ -82,12 +82,18 @@ public HelmChartRepositoryStatus(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their statuses
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their statuses
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/ProjectHelmChartRepository.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/ProjectHelmChartRepository.java
index 03a013bfeb6..1e2d6108634 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/ProjectHelmChartRepository.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/ProjectHelmChartRepository.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ProjectHelmChartRepository holds namespace-wide configuration for proxied Helm chart repository<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class ProjectHelmChartRepository implements Editable<ProjectHelmChartRepositoryBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "helm.openshift.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ProjectHelmChartRepository";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ProjectHelmChartRepository(String apiVersion, String kind, ObjectMeta met
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ProjectHelmChartRepository holds namespace-wide configuration for proxied Helm chart repository<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ProjectHelmChartRepository holds namespace-wide configuration for proxied Helm chart repository<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ProjectHelmChartRepository holds namespace-wide configuration for proxied Helm chart repository<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ProjectHelmChartRepositorySpec getSpec() {
         return spec;
     }
 
+    /**
+     * ProjectHelmChartRepository holds namespace-wide configuration for proxied Helm chart repository<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ProjectHelmChartRepositorySpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ProjectHelmChartRepository holds namespace-wide configuration for proxied Helm chart repository<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public HelmChartRepositoryStatus getStatus() {
         return status;
     }
 
+    /**
+     * ProjectHelmChartRepository holds namespace-wide configuration for proxied Helm chart repository<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(HelmChartRepositoryStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/ProjectHelmChartRepositoryList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/ProjectHelmChartRepositoryList.java
index 5b0af6428af..67f5bd9b8a8 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/ProjectHelmChartRepositoryList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/ProjectHelmChartRepositoryList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ProjectHelmChartRepositoryList implements Editable<ProjectHelmChartRepositoryListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.helm.v1beta1.ProjectHelmChartRepository>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "helm.openshift.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.helm.v1beta1.ProjectHelmChartRepository> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ProjectHelmChartRepositoryList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ProjectHelmChartRepositoryList(String apiVersion, List<io.fabric8.openshi
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.miscellaneous.helm.v1beta1.ProjectHelmChartRepository> getItems() {
         return items;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.helm.v1beta1.ProjectHelmChartRepository> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/ProjectHelmChartRepositorySpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/ProjectHelmChartRepositorySpec.java
index b58e9312184..089cedcf353 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/ProjectHelmChartRepositorySpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/helm/v1beta1/ProjectHelmChartRepositorySpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Project Helm chart repository exposed within a namespace
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ProjectHelmChartRepositorySpec(ConnectionConfigNamespaceScoped connection
         this.name = name;
     }
 
+    /**
+     * Project Helm chart repository exposed within a namespace
+     */
     @JsonProperty("connectionConfig")
     public ConnectionConfigNamespaceScoped getConnectionConfig() {
         return connectionConfig;
     }
 
+    /**
+     * Project Helm chart repository exposed within a namespace
+     */
     @JsonProperty("connectionConfig")
     public void setConnectionConfig(ConnectionConfigNamespaceScoped connectionConfig) {
         this.connectionConfig = connectionConfig;
     }
 
+    /**
+     * Optional human readable repository description, it can be used by UI for displaying purposes
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Optional human readable repository description, it can be used by UI for displaying purposes
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * If set to true, disable the repo usage in the namespace
+     */
     @JsonProperty("disabled")
     public Boolean getDisabled() {
         return disabled;
     }
 
+    /**
+     * If set to true, disable the repo usage in the namespace
+     */
     @JsonProperty("disabled")
     public void setDisabled(Boolean disabled) {
         this.disabled = disabled;
     }
 
+    /**
+     * Optional associated human readable repository name, it can be used by UI for displaying purposes
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Optional associated human readable repository name, it can be used by UI for displaying purposes
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/AttachedImageReference.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/AttachedImageReference.java
index 87ab9fbb847..8467c1bb947 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/AttachedImageReference.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/AttachedImageReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Contains the DataImage currently attached to the BMH.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public AttachedImageReference(String url) {
         this.url = url;
     }
 
+    /**
+     * Contains the DataImage currently attached to the BMH.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * Contains the DataImage currently attached to the BMH.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BIOS.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BIOS.java
index c102f28b50f..45331a1336a 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BIOS.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BIOS.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BIOS describes the BIOS version on the host.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public BIOS(String date, String vendor, String version) {
         this.version = version;
     }
 
+    /**
+     * The release/build date for this BIOS
+     */
     @JsonProperty("date")
     public String getDate() {
         return date;
     }
 
+    /**
+     * The release/build date for this BIOS
+     */
     @JsonProperty("date")
     public void setDate(String date) {
         this.date = date;
     }
 
+    /**
+     * The vendor name for this BIOS
+     */
     @JsonProperty("vendor")
     public String getVendor() {
         return vendor;
     }
 
+    /**
+     * The vendor name for this BIOS
+     */
     @JsonProperty("vendor")
     public void setVendor(String vendor) {
         this.vendor = vendor;
     }
 
+    /**
+     * The version of the BIOS
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * The version of the BIOS
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BMCDetails.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BMCDetails.java
index 2ce60390b1c..c1f2bc38e81 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BMCDetails.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BMCDetails.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BMCDetails contains the information necessary to communicate with the bare metal controller module on host.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public BMCDetails(String address, String credentialsName, Boolean disableCertifi
         this.disableCertificateVerification = disableCertificateVerification;
     }
 
+    /**
+     * Address holds the URL for accessing the controller on the network. The scheme part designates the driver to use with the host.
+     */
     @JsonProperty("address")
     public String getAddress() {
         return address;
     }
 
+    /**
+     * Address holds the URL for accessing the controller on the network. The scheme part designates the driver to use with the host.
+     */
     @JsonProperty("address")
     public void setAddress(String address) {
         this.address = address;
     }
 
+    /**
+     * The name of the secret containing the BMC credentials (requires keys "username" and "password").
+     */
     @JsonProperty("credentialsName")
     public String getCredentialsName() {
         return credentialsName;
     }
 
+    /**
+     * The name of the secret containing the BMC credentials (requires keys "username" and "password").
+     */
     @JsonProperty("credentialsName")
     public void setCredentialsName(String credentialsName) {
         this.credentialsName = credentialsName;
     }
 
+    /**
+     * DisableCertificateVerification disables verification of server certificates when using HTTPS to connect to the BMC. This is required when the server certificate is self-signed, but is insecure because it allows a man-in-the-middle to intercept the connection.
+     */
     @JsonProperty("disableCertificateVerification")
     public Boolean getDisableCertificateVerification() {
         return disableCertificateVerification;
     }
 
+    /**
+     * DisableCertificateVerification disables verification of server certificates when using HTTPS to connect to the BMC. This is required when the server certificate is self-signed, but is insecure because it allows a man-in-the-middle to intercept the connection.
+     */
     @JsonProperty("disableCertificateVerification")
     public void setDisableCertificateVerification(Boolean disableCertificateVerification) {
         this.disableCertificateVerification = disableCertificateVerification;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BMCEventSubscription.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BMCEventSubscription.java
index afd10a7a312..09441451c8a 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BMCEventSubscription.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BMCEventSubscription.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BMCEventSubscription is the Schema for the fast eventing API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class BMCEventSubscription implements Editable<BMCEventSubscriptionBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "metal3.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "BMCEventSubscription";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public BMCEventSubscription(String apiVersion, String kind, ObjectMeta metadata,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * BMCEventSubscription is the Schema for the fast eventing API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * BMCEventSubscription is the Schema for the fast eventing API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * BMCEventSubscription is the Schema for the fast eventing API
+     */
     @JsonProperty("spec")
     public BMCEventSubscriptionSpec getSpec() {
         return spec;
     }
 
+    /**
+     * BMCEventSubscription is the Schema for the fast eventing API
+     */
     @JsonProperty("spec")
     public void setSpec(BMCEventSubscriptionSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * BMCEventSubscription is the Schema for the fast eventing API
+     */
     @JsonProperty("status")
     public BMCEventSubscriptionStatus getStatus() {
         return status;
     }
 
+    /**
+     * BMCEventSubscription is the Schema for the fast eventing API
+     */
     @JsonProperty("status")
     public void setStatus(BMCEventSubscriptionStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BMCEventSubscriptionList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BMCEventSubscriptionList.java
index bf12feed38d..48fb4d8005a 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BMCEventSubscriptionList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BMCEventSubscriptionList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BMCEventSubscriptionList contains a list of BMCEventSubscriptions.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class BMCEventSubscriptionList implements Editable<BMCEventSubscriptionListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.BMCEventSubscription>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "metal3.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.BMCEventSubscription> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "BMCEventSubscriptionList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public BMCEventSubscriptionList(String apiVersion, List<io.fabric8.openshift.api
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * BMCEventSubscriptionList contains a list of BMCEventSubscriptions.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.BMCEventSubscription> getItems() {
         return items;
     }
 
+    /**
+     * BMCEventSubscriptionList contains a list of BMCEventSubscriptions.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.BMCEventSubscription> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * BMCEventSubscriptionList contains a list of BMCEventSubscriptions.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * BMCEventSubscriptionList contains a list of BMCEventSubscriptions.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BMCEventSubscriptionSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BMCEventSubscriptionSpec.java
index 32b499a32a1..06ad1465870 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BMCEventSubscriptionSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BMCEventSubscriptionSpec.java
@@ -91,31 +91,49 @@ public BMCEventSubscriptionSpec(String context, String destination, String hostN
         this.httpHeadersRef = httpHeadersRef;
     }
 
+    /**
+     * Arbitrary user-provided context for the event
+     */
     @JsonProperty("context")
     public String getContext() {
         return context;
     }
 
+    /**
+     * Arbitrary user-provided context for the event
+     */
     @JsonProperty("context")
     public void setContext(String context) {
         this.context = context;
     }
 
+    /**
+     * A webhook URL to send events to
+     */
     @JsonProperty("destination")
     public String getDestination() {
         return destination;
     }
 
+    /**
+     * A webhook URL to send events to
+     */
     @JsonProperty("destination")
     public void setDestination(String destination) {
         this.destination = destination;
     }
 
+    /**
+     * A reference to a BareMetalHost
+     */
     @JsonProperty("hostName")
     public String getHostName() {
         return hostName;
     }
 
+    /**
+     * A reference to a BareMetalHost
+     */
     @JsonProperty("hostName")
     public void setHostName(String hostName) {
         this.hostName = hostName;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BareMetalHost.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BareMetalHost.java
index 6da2aa9aa20..5891ca68448 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BareMetalHost.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BareMetalHost.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BareMetalHost is the Schema for the baremetalhosts API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class BareMetalHost implements Editable<BareMetalHostBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "metal3.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "BareMetalHost";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public BareMetalHost(String apiVersion, String kind, ObjectMeta metadata, BareMe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * BareMetalHost is the Schema for the baremetalhosts API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * BareMetalHost is the Schema for the baremetalhosts API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * BareMetalHost is the Schema for the baremetalhosts API
+     */
     @JsonProperty("spec")
     public BareMetalHostSpec getSpec() {
         return spec;
     }
 
+    /**
+     * BareMetalHost is the Schema for the baremetalhosts API
+     */
     @JsonProperty("spec")
     public void setSpec(BareMetalHostSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * BareMetalHost is the Schema for the baremetalhosts API
+     */
     @JsonProperty("status")
     public BareMetalHostStatus getStatus() {
         return status;
     }
 
+    /**
+     * BareMetalHost is the Schema for the baremetalhosts API
+     */
     @JsonProperty("status")
     public void setStatus(BareMetalHostStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BareMetalHostList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BareMetalHostList.java
index 4b6887689b0..2054d4aca09 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BareMetalHostList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BareMetalHostList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BareMetalHostList contains a list of BareMetalHost.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class BareMetalHostList implements Editable<BareMetalHostListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.BareMetalHost>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "metal3.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.BareMetalHost> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "BareMetalHostList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public BareMetalHostList(String apiVersion, List<io.fabric8.openshift.api.model.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * BareMetalHostList contains a list of BareMetalHost.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.BareMetalHost> getItems() {
         return items;
     }
 
+    /**
+     * BareMetalHostList contains a list of BareMetalHost.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.BareMetalHost> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * BareMetalHostList contains a list of BareMetalHost.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * BareMetalHostList contains a list of BareMetalHost.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BareMetalHostSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BareMetalHostSpec.java
index 4bf2e56a47b..05e47d3c618 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BareMetalHostSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BareMetalHostSpec.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BareMetalHostSpec defines the desired state of BareMetalHost.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -159,202 +162,322 @@ public BareMetalHostSpec(String architecture, String automatedCleaningMode, BMCD
         this.userData = userData;
     }
 
+    /**
+     * CPU architecture of the host, e.g. "x86_64" or "aarch64". If unset, eventually populated by inspection.
+     */
     @JsonProperty("architecture")
     public String getArchitecture() {
         return architecture;
     }
 
+    /**
+     * CPU architecture of the host, e.g. "x86_64" or "aarch64". If unset, eventually populated by inspection.
+     */
     @JsonProperty("architecture")
     public void setArchitecture(String architecture) {
         this.architecture = architecture;
     }
 
+    /**
+     * When set to disabled, automated cleaning will be skipped during provisioning and deprovisioning.
+     */
     @JsonProperty("automatedCleaningMode")
     public String getAutomatedCleaningMode() {
         return automatedCleaningMode;
     }
 
+    /**
+     * When set to disabled, automated cleaning will be skipped during provisioning and deprovisioning.
+     */
     @JsonProperty("automatedCleaningMode")
     public void setAutomatedCleaningMode(String automatedCleaningMode) {
         this.automatedCleaningMode = automatedCleaningMode;
     }
 
+    /**
+     * BareMetalHostSpec defines the desired state of BareMetalHost.
+     */
     @JsonProperty("bmc")
     public BMCDetails getBmc() {
         return bmc;
     }
 
+    /**
+     * BareMetalHostSpec defines the desired state of BareMetalHost.
+     */
     @JsonProperty("bmc")
     public void setBmc(BMCDetails bmc) {
         this.bmc = bmc;
     }
 
+    /**
+     * The MAC address of the NIC used for provisioning the host. In case of network boot, this is the MAC address of the PXE booting interface. The MAC address of the BMC must never be used here!
+     */
     @JsonProperty("bootMACAddress")
     public String getBootMACAddress() {
         return bootMACAddress;
     }
 
+    /**
+     * The MAC address of the NIC used for provisioning the host. In case of network boot, this is the MAC address of the PXE booting interface. The MAC address of the BMC must never be used here!
+     */
     @JsonProperty("bootMACAddress")
     public void setBootMACAddress(String bootMACAddress) {
         this.bootMACAddress = bootMACAddress;
     }
 
+    /**
+     * Select the method of initializing the hardware during boot. Defaults to UEFI. Legacy boot should only be used for hardware that does not support UEFI correctly. Set to UEFISecureBoot to turn secure boot on automatically after provisioning.
+     */
     @JsonProperty("bootMode")
     public String getBootMode() {
         return bootMode;
     }
 
+    /**
+     * Select the method of initializing the hardware during boot. Defaults to UEFI. Legacy boot should only be used for hardware that does not support UEFI correctly. Set to UEFISecureBoot to turn secure boot on automatically after provisioning.
+     */
     @JsonProperty("bootMode")
     public void setBootMode(String bootMode) {
         this.bootMode = bootMode;
     }
 
+    /**
+     * BareMetalHostSpec defines the desired state of BareMetalHost.
+     */
     @JsonProperty("consumerRef")
     public ObjectReference getConsumerRef() {
         return consumerRef;
     }
 
+    /**
+     * BareMetalHostSpec defines the desired state of BareMetalHost.
+     */
     @JsonProperty("consumerRef")
     public void setConsumerRef(ObjectReference consumerRef) {
         this.consumerRef = consumerRef;
     }
 
+    /**
+     * BareMetalHostSpec defines the desired state of BareMetalHost.
+     */
     @JsonProperty("customDeploy")
     public CustomDeploy getCustomDeploy() {
         return customDeploy;
     }
 
+    /**
+     * BareMetalHostSpec defines the desired state of BareMetalHost.
+     */
     @JsonProperty("customDeploy")
     public void setCustomDeploy(CustomDeploy customDeploy) {
         this.customDeploy = customDeploy;
     }
 
+    /**
+     * Description is a human-entered text used to help identify the host.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is a human-entered text used to help identify the host.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * ExternallyProvisioned means something else has provisioned the image running on the host, and the operator should only manage the power status. This field is used for integration with already provisioned hosts and when pivoting hosts between clusters. If unsure, leave this field as false.
+     */
     @JsonProperty("externallyProvisioned")
     public Boolean getExternallyProvisioned() {
         return externallyProvisioned;
     }
 
+    /**
+     * ExternallyProvisioned means something else has provisioned the image running on the host, and the operator should only manage the power status. This field is used for integration with already provisioned hosts and when pivoting hosts between clusters. If unsure, leave this field as false.
+     */
     @JsonProperty("externallyProvisioned")
     public void setExternallyProvisioned(Boolean externallyProvisioned) {
         this.externallyProvisioned = externallyProvisioned;
     }
 
+    /**
+     * BareMetalHostSpec defines the desired state of BareMetalHost.
+     */
     @JsonProperty("firmware")
     public FirmwareConfig getFirmware() {
         return firmware;
     }
 
+    /**
+     * BareMetalHostSpec defines the desired state of BareMetalHost.
+     */
     @JsonProperty("firmware")
     public void setFirmware(FirmwareConfig firmware) {
         this.firmware = firmware;
     }
 
+    /**
+     * What is the name of the hardware profile for this host? Hardware profiles are deprecated and should not be used. Use the separate fields Architecture and RootDeviceHints instead. Set to "empty" to prepare for the future version of the API without hardware profiles.
+     */
     @JsonProperty("hardwareProfile")
     public String getHardwareProfile() {
         return hardwareProfile;
     }
 
+    /**
+     * What is the name of the hardware profile for this host? Hardware profiles are deprecated and should not be used. Use the separate fields Architecture and RootDeviceHints instead. Set to "empty" to prepare for the future version of the API without hardware profiles.
+     */
     @JsonProperty("hardwareProfile")
     public void setHardwareProfile(String hardwareProfile) {
         this.hardwareProfile = hardwareProfile;
     }
 
+    /**
+     * BareMetalHostSpec defines the desired state of BareMetalHost.
+     */
     @JsonProperty("image")
     public Image getImage() {
         return image;
     }
 
+    /**
+     * BareMetalHostSpec defines the desired state of BareMetalHost.
+     */
     @JsonProperty("image")
     public void setImage(Image image) {
         this.image = image;
     }
 
+    /**
+     * BareMetalHostSpec defines the desired state of BareMetalHost.
+     */
     @JsonProperty("metaData")
     public SecretReference getMetaData() {
         return metaData;
     }
 
+    /**
+     * BareMetalHostSpec defines the desired state of BareMetalHost.
+     */
     @JsonProperty("metaData")
     public void setMetaData(SecretReference metaData) {
         this.metaData = metaData;
     }
 
+    /**
+     * BareMetalHostSpec defines the desired state of BareMetalHost.
+     */
     @JsonProperty("networkData")
     public SecretReference getNetworkData() {
         return networkData;
     }
 
+    /**
+     * BareMetalHostSpec defines the desired state of BareMetalHost.
+     */
     @JsonProperty("networkData")
     public void setNetworkData(SecretReference networkData) {
         this.networkData = networkData;
     }
 
+    /**
+     * Should the host be powered on? Changing this value will trigger a change in power state of the host.
+     */
     @JsonProperty("online")
     public Boolean getOnline() {
         return online;
     }
 
+    /**
+     * Should the host be powered on? Changing this value will trigger a change in power state of the host.
+     */
     @JsonProperty("online")
     public void setOnline(Boolean online) {
         this.online = online;
     }
 
+    /**
+     * PreprovisioningNetworkDataName is the name of the Secret in the local namespace containing network configuration which is passed to the preprovisioning image, and to the Config Drive if not overridden by specifying NetworkData.
+     */
     @JsonProperty("preprovisioningNetworkDataName")
     public String getPreprovisioningNetworkDataName() {
         return preprovisioningNetworkDataName;
     }
 
+    /**
+     * PreprovisioningNetworkDataName is the name of the Secret in the local namespace containing network configuration which is passed to the preprovisioning image, and to the Config Drive if not overridden by specifying NetworkData.
+     */
     @JsonProperty("preprovisioningNetworkDataName")
     public void setPreprovisioningNetworkDataName(String preprovisioningNetworkDataName) {
         this.preprovisioningNetworkDataName = preprovisioningNetworkDataName;
     }
 
+    /**
+     * BareMetalHostSpec defines the desired state of BareMetalHost.
+     */
     @JsonProperty("raid")
     public RAIDConfig getRaid() {
         return raid;
     }
 
+    /**
+     * BareMetalHostSpec defines the desired state of BareMetalHost.
+     */
     @JsonProperty("raid")
     public void setRaid(RAIDConfig raid) {
         this.raid = raid;
     }
 
+    /**
+     * BareMetalHostSpec defines the desired state of BareMetalHost.
+     */
     @JsonProperty("rootDeviceHints")
     public RootDeviceHints getRootDeviceHints() {
         return rootDeviceHints;
     }
 
+    /**
+     * BareMetalHostSpec defines the desired state of BareMetalHost.
+     */
     @JsonProperty("rootDeviceHints")
     public void setRootDeviceHints(RootDeviceHints rootDeviceHints) {
         this.rootDeviceHints = rootDeviceHints;
     }
 
+    /**
+     * Taints is the full, authoritative list of taints to apply to the corresponding Machine. This list will overwrite any modifications made to the Machine on an ongoing basis.
+     */
     @JsonProperty("taints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Taint> getTaints() {
         return taints;
     }
 
+    /**
+     * Taints is the full, authoritative list of taints to apply to the corresponding Machine. This list will overwrite any modifications made to the Machine on an ongoing basis.
+     */
     @JsonProperty("taints")
     public void setTaints(List<Taint> taints) {
         this.taints = taints;
     }
 
+    /**
+     * BareMetalHostSpec defines the desired state of BareMetalHost.
+     */
     @JsonProperty("userData")
     public SecretReference getUserData() {
         return userData;
     }
 
+    /**
+     * BareMetalHostSpec defines the desired state of BareMetalHost.
+     */
     @JsonProperty("userData")
     public void setUserData(SecretReference userData) {
         this.userData = userData;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BareMetalHostStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BareMetalHostStatus.java
index c6d4932c1c9..e58bcfa6779 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BareMetalHostStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/BareMetalHostStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BareMetalHostStatus defines the observed state of BareMetalHost.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -122,121 +125,193 @@ public BareMetalHostStatus(Integer errorCount, String errorMessage, String error
         this.triedCredentials = triedCredentials;
     }
 
+    /**
+     * ErrorCount records how many times the host has encoutered an error since the last successful operation
+     */
     @JsonProperty("errorCount")
     public Integer getErrorCount() {
         return errorCount;
     }
 
+    /**
+     * ErrorCount records how many times the host has encoutered an error since the last successful operation
+     */
     @JsonProperty("errorCount")
     public void setErrorCount(Integer errorCount) {
         this.errorCount = errorCount;
     }
 
+    /**
+     * The last error message reported by the provisioning subsystem.
+     */
     @JsonProperty("errorMessage")
     public String getErrorMessage() {
         return errorMessage;
     }
 
+    /**
+     * The last error message reported by the provisioning subsystem.
+     */
     @JsonProperty("errorMessage")
     public void setErrorMessage(String errorMessage) {
         this.errorMessage = errorMessage;
     }
 
+    /**
+     * ErrorType indicates the type of failure encountered when the OperationalStatus is OperationalStatusError
+     */
     @JsonProperty("errorType")
     public String getErrorType() {
         return errorType;
     }
 
+    /**
+     * ErrorType indicates the type of failure encountered when the OperationalStatus is OperationalStatusError
+     */
     @JsonProperty("errorType")
     public void setErrorType(String errorType) {
         this.errorType = errorType;
     }
 
+    /**
+     * BareMetalHostStatus defines the observed state of BareMetalHost.
+     */
     @JsonProperty("goodCredentials")
     public CredentialsStatus getGoodCredentials() {
         return goodCredentials;
     }
 
+    /**
+     * BareMetalHostStatus defines the observed state of BareMetalHost.
+     */
     @JsonProperty("goodCredentials")
     public void setGoodCredentials(CredentialsStatus goodCredentials) {
         this.goodCredentials = goodCredentials;
     }
 
+    /**
+     * BareMetalHostStatus defines the observed state of BareMetalHost.
+     */
     @JsonProperty("hardware")
     public HardwareDetails getHardware() {
         return hardware;
     }
 
+    /**
+     * BareMetalHostStatus defines the observed state of BareMetalHost.
+     */
     @JsonProperty("hardware")
     public void setHardware(HardwareDetails hardware) {
         this.hardware = hardware;
     }
 
+    /**
+     * The name of the profile matching the hardware details. Hardware profiles are deprecated and should not be relied on.
+     */
     @JsonProperty("hardwareProfile")
     public String getHardwareProfile() {
         return hardwareProfile;
     }
 
+    /**
+     * The name of the profile matching the hardware details. Hardware profiles are deprecated and should not be relied on.
+     */
     @JsonProperty("hardwareProfile")
     public void setHardwareProfile(String hardwareProfile) {
         this.hardwareProfile = hardwareProfile;
     }
 
+    /**
+     * BareMetalHostStatus defines the observed state of BareMetalHost.
+     */
     @JsonProperty("lastUpdated")
     public String getLastUpdated() {
         return lastUpdated;
     }
 
+    /**
+     * BareMetalHostStatus defines the observed state of BareMetalHost.
+     */
     @JsonProperty("lastUpdated")
     public void setLastUpdated(String lastUpdated) {
         this.lastUpdated = lastUpdated;
     }
 
+    /**
+     * BareMetalHostStatus defines the observed state of BareMetalHost.
+     */
     @JsonProperty("operationHistory")
     public OperationHistory getOperationHistory() {
         return operationHistory;
     }
 
+    /**
+     * BareMetalHostStatus defines the observed state of BareMetalHost.
+     */
     @JsonProperty("operationHistory")
     public void setOperationHistory(OperationHistory operationHistory) {
         this.operationHistory = operationHistory;
     }
 
+    /**
+     * OperationalStatus holds the status of the host
+     */
     @JsonProperty("operationalStatus")
     public String getOperationalStatus() {
         return operationalStatus;
     }
 
+    /**
+     * OperationalStatus holds the status of the host
+     */
     @JsonProperty("operationalStatus")
     public void setOperationalStatus(String operationalStatus) {
         this.operationalStatus = operationalStatus;
     }
 
+    /**
+     * Whether or not the host is currently powered on. This field may get briefly out of sync with the actual state of the hardware while provisioning processes are running.
+     */
     @JsonProperty("poweredOn")
     public Boolean getPoweredOn() {
         return poweredOn;
     }
 
+    /**
+     * Whether or not the host is currently powered on. This field may get briefly out of sync with the actual state of the hardware while provisioning processes are running.
+     */
     @JsonProperty("poweredOn")
     public void setPoweredOn(Boolean poweredOn) {
         this.poweredOn = poweredOn;
     }
 
+    /**
+     * BareMetalHostStatus defines the observed state of BareMetalHost.
+     */
     @JsonProperty("provisioning")
     public ProvisionStatus getProvisioning() {
         return provisioning;
     }
 
+    /**
+     * BareMetalHostStatus defines the observed state of BareMetalHost.
+     */
     @JsonProperty("provisioning")
     public void setProvisioning(ProvisionStatus provisioning) {
         this.provisioning = provisioning;
     }
 
+    /**
+     * BareMetalHostStatus defines the observed state of BareMetalHost.
+     */
     @JsonProperty("triedCredentials")
     public CredentialsStatus getTriedCredentials() {
         return triedCredentials;
     }
 
+    /**
+     * BareMetalHostStatus defines the observed state of BareMetalHost.
+     */
     @JsonProperty("triedCredentials")
     public void setTriedCredentials(CredentialsStatus triedCredentials) {
         this.triedCredentials = triedCredentials;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/CPU.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/CPU.java
index 5151437d1d8..bbf597963e4 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/CPU.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/CPU.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CPU describes one processor on the host.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -97,52 +100,82 @@ public CPU(String arch, Double clockMegahertz, Integer count, List<String> flags
         this.model = model;
     }
 
+    /**
+     * CPU describes one processor on the host.
+     */
     @JsonProperty("arch")
     public String getArch() {
         return arch;
     }
 
+    /**
+     * CPU describes one processor on the host.
+     */
     @JsonProperty("arch")
     public void setArch(String arch) {
         this.arch = arch;
     }
 
+    /**
+     * CPU describes one processor on the host.
+     */
     @JsonProperty("clockMegahertz")
     public Double getClockMegahertz() {
         return clockMegahertz;
     }
 
+    /**
+     * CPU describes one processor on the host.
+     */
     @JsonProperty("clockMegahertz")
     public void setClockMegahertz(Double clockMegahertz) {
         this.clockMegahertz = clockMegahertz;
     }
 
+    /**
+     * CPU describes one processor on the host.
+     */
     @JsonProperty("count")
     public Integer getCount() {
         return count;
     }
 
+    /**
+     * CPU describes one processor on the host.
+     */
     @JsonProperty("count")
     public void setCount(Integer count) {
         this.count = count;
     }
 
+    /**
+     * CPU describes one processor on the host.
+     */
     @JsonProperty("flags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getFlags() {
         return flags;
     }
 
+    /**
+     * CPU describes one processor on the host.
+     */
     @JsonProperty("flags")
     public void setFlags(List<String> flags) {
         this.flags = flags;
     }
 
+    /**
+     * CPU describes one processor on the host.
+     */
     @JsonProperty("model")
     public String getModel() {
         return model;
     }
 
+    /**
+     * CPU describes one processor on the host.
+     */
     @JsonProperty("model")
     public void setModel(String model) {
         this.model = model;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/CredentialsStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/CredentialsStatus.java
index 4019a735f60..ca8dca12b95 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/CredentialsStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/CredentialsStatus.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CredentialsStatus contains the reference and version of the last set of BMC credentials the controller was able to validate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public CredentialsStatus(SecretReference credentials, String credentialsVersion)
         this.credentialsVersion = credentialsVersion;
     }
 
+    /**
+     * CredentialsStatus contains the reference and version of the last set of BMC credentials the controller was able to validate.
+     */
     @JsonProperty("credentials")
     public SecretReference getCredentials() {
         return credentials;
     }
 
+    /**
+     * CredentialsStatus contains the reference and version of the last set of BMC credentials the controller was able to validate.
+     */
     @JsonProperty("credentials")
     public void setCredentials(SecretReference credentials) {
         this.credentials = credentials;
     }
 
+    /**
+     * CredentialsStatus contains the reference and version of the last set of BMC credentials the controller was able to validate.
+     */
     @JsonProperty("credentialsVersion")
     public String getCredentialsVersion() {
         return credentialsVersion;
     }
 
+    /**
+     * CredentialsStatus contains the reference and version of the last set of BMC credentials the controller was able to validate.
+     */
     @JsonProperty("credentialsVersion")
     public void setCredentialsVersion(String credentialsVersion) {
         this.credentialsVersion = credentialsVersion;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/CustomDeploy.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/CustomDeploy.java
index 7bcc0eca39e..4fdc5e0df06 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/CustomDeploy.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/CustomDeploy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Custom deploy is a description of a customized deploy process.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public CustomDeploy(String method) {
         this.method = method;
     }
 
+    /**
+     * Custom deploy method name. This name is specific to the deploy ramdisk used. If you don't have a custom deploy ramdisk, you shouldn't use CustomDeploy.
+     */
     @JsonProperty("method")
     public String getMethod() {
         return method;
     }
 
+    /**
+     * Custom deploy method name. This name is specific to the deploy ramdisk used. If you don't have a custom deploy ramdisk, you shouldn't use CustomDeploy.
+     */
     @JsonProperty("method")
     public void setMethod(String method) {
         this.method = method;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/DataImage.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/DataImage.java
index 2fb54f43f99..8fc1f880f37 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/DataImage.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/DataImage.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DataImage is the Schema for the dataimages API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class DataImage implements Editable<DataImageBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "metal3.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DataImage";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DataImage(String apiVersion, String kind, ObjectMeta metadata, DataImageS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DataImage is the Schema for the dataimages API.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DataImage is the Schema for the dataimages API.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * DataImage is the Schema for the dataimages API.
+     */
     @JsonProperty("spec")
     public DataImageSpec getSpec() {
         return spec;
     }
 
+    /**
+     * DataImage is the Schema for the dataimages API.
+     */
     @JsonProperty("spec")
     public void setSpec(DataImageSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * DataImage is the Schema for the dataimages API.
+     */
     @JsonProperty("status")
     public DataImageStatus getStatus() {
         return status;
     }
 
+    /**
+     * DataImage is the Schema for the dataimages API.
+     */
     @JsonProperty("status")
     public void setStatus(DataImageStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/DataImageError.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/DataImageError.java
index fe249c05b4c..fbfd4834db5 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/DataImageError.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/DataImageError.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Contains the count of errors and the last error message.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public DataImageError(Integer count, String message) {
         this.message = message;
     }
 
+    /**
+     * Contains the count of errors and the last error message.
+     */
     @JsonProperty("count")
     public Integer getCount() {
         return count;
     }
 
+    /**
+     * Contains the count of errors and the last error message.
+     */
     @JsonProperty("count")
     public void setCount(Integer count) {
         this.count = count;
     }
 
+    /**
+     * Contains the count of errors and the last error message.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Contains the count of errors and the last error message.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/DataImageList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/DataImageList.java
index a5003273af3..c6c9aebdbd0 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/DataImageList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/DataImageList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DataImageList contains a list of DataImage.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class DataImageList implements Editable<DataImageListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.DataImage>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "metal3.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.DataImage> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DataImageList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DataImageList(String apiVersion, List<io.fabric8.openshift.api.model.misc
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * DataImageList contains a list of DataImage.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.DataImage> getItems() {
         return items;
     }
 
+    /**
+     * DataImageList contains a list of DataImage.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.DataImage> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DataImageList contains a list of DataImage.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DataImageList contains a list of DataImage.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/DataImageSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/DataImageSpec.java
index c3bb200f107..086147e8725 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/DataImageSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/DataImageSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DataImageSpec defines the desired state of DataImage.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public DataImageSpec(String url) {
         this.url = url;
     }
 
+    /**
+     * Url is the address of the dataImage that we want to attach to a BareMetalHost
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * Url is the address of the dataImage that we want to attach to a BareMetalHost
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/DataImageStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/DataImageStatus.java
index cf60ed227be..d8a44dfb5fb 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/DataImageStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/DataImageStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DataImageStatus defines the observed state of DataImage.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public DataImageStatus(AttachedImageReference attachedImage, DataImageError erro
         this.lastReconciled = lastReconciled;
     }
 
+    /**
+     * DataImageStatus defines the observed state of DataImage.
+     */
     @JsonProperty("attachedImage")
     public AttachedImageReference getAttachedImage() {
         return attachedImage;
     }
 
+    /**
+     * DataImageStatus defines the observed state of DataImage.
+     */
     @JsonProperty("attachedImage")
     public void setAttachedImage(AttachedImageReference attachedImage) {
         this.attachedImage = attachedImage;
     }
 
+    /**
+     * DataImageStatus defines the observed state of DataImage.
+     */
     @JsonProperty("error")
     public DataImageError getError() {
         return error;
     }
 
+    /**
+     * DataImageStatus defines the observed state of DataImage.
+     */
     @JsonProperty("error")
     public void setError(DataImageError error) {
         this.error = error;
     }
 
+    /**
+     * DataImageStatus defines the observed state of DataImage.
+     */
     @JsonProperty("lastReconciled")
     public String getLastReconciled() {
         return lastReconciled;
     }
 
+    /**
+     * DataImageStatus defines the observed state of DataImage.
+     */
     @JsonProperty("lastReconciled")
     public void setLastReconciled(String lastReconciled) {
         this.lastReconciled = lastReconciled;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/DetachedAnnotationArguments.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/DetachedAnnotationArguments.java
index 8609d12c502..769533279fb 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/DetachedAnnotationArguments.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/DetachedAnnotationArguments.java
@@ -78,11 +78,17 @@ public DetachedAnnotationArguments(String deleteAction) {
         this.deleteAction = deleteAction;
     }
 
+    /**
+     * DeleteAction indicates the desired delete logic when the detached annotation is present
+     */
     @JsonProperty("deleteAction")
     public String getDeleteAction() {
         return deleteAction;
     }
 
+    /**
+     * DeleteAction indicates the desired delete logic when the detached annotation is present
+     */
     @JsonProperty("deleteAction")
     public void setDeleteAction(String deleteAction) {
         this.deleteAction = deleteAction;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/Firmware.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/Firmware.java
index 0e8dc06d97a..dfc6b73cdc2 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/Firmware.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/Firmware.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Firmware describes the firmware on the host.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public Firmware(BIOS bios) {
         this.bios = bios;
     }
 
+    /**
+     * Firmware describes the firmware on the host.
+     */
     @JsonProperty("bios")
     public BIOS getBios() {
         return bios;
     }
 
+    /**
+     * Firmware describes the firmware on the host.
+     */
     @JsonProperty("bios")
     public void setBios(BIOS bios) {
         this.bios = bios;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/FirmwareComponentStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/FirmwareComponentStatus.java
index 5b6f61da9a5..d1cfa9d2b30 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/FirmwareComponentStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/FirmwareComponentStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FirmwareComponentStatus defines the status of a firmware component.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public FirmwareComponentStatus(String component, String currentVersion, String i
         this.updatedAt = updatedAt;
     }
 
+    /**
+     * FirmwareComponentStatus defines the status of a firmware component.
+     */
     @JsonProperty("component")
     public String getComponent() {
         return component;
     }
 
+    /**
+     * FirmwareComponentStatus defines the status of a firmware component.
+     */
     @JsonProperty("component")
     public void setComponent(String component) {
         this.component = component;
     }
 
+    /**
+     * FirmwareComponentStatus defines the status of a firmware component.
+     */
     @JsonProperty("currentVersion")
     public String getCurrentVersion() {
         return currentVersion;
     }
 
+    /**
+     * FirmwareComponentStatus defines the status of a firmware component.
+     */
     @JsonProperty("currentVersion")
     public void setCurrentVersion(String currentVersion) {
         this.currentVersion = currentVersion;
     }
 
+    /**
+     * FirmwareComponentStatus defines the status of a firmware component.
+     */
     @JsonProperty("initialVersion")
     public String getInitialVersion() {
         return initialVersion;
     }
 
+    /**
+     * FirmwareComponentStatus defines the status of a firmware component.
+     */
     @JsonProperty("initialVersion")
     public void setInitialVersion(String initialVersion) {
         this.initialVersion = initialVersion;
     }
 
+    /**
+     * FirmwareComponentStatus defines the status of a firmware component.
+     */
     @JsonProperty("lastVersionFlashed")
     public String getLastVersionFlashed() {
         return lastVersionFlashed;
     }
 
+    /**
+     * FirmwareComponentStatus defines the status of a firmware component.
+     */
     @JsonProperty("lastVersionFlashed")
     public void setLastVersionFlashed(String lastVersionFlashed) {
         this.lastVersionFlashed = lastVersionFlashed;
     }
 
+    /**
+     * FirmwareComponentStatus defines the status of a firmware component.
+     */
     @JsonProperty("updatedAt")
     public String getUpdatedAt() {
         return updatedAt;
     }
 
+    /**
+     * FirmwareComponentStatus defines the status of a firmware component.
+     */
     @JsonProperty("updatedAt")
     public void setUpdatedAt(String updatedAt) {
         this.updatedAt = updatedAt;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/FirmwareConfig.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/FirmwareConfig.java
index c10b5bc8957..610cd9f05e1 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/FirmwareConfig.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/FirmwareConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FirmwareConfig contains the configuration that you want to configure BIOS settings in Bare metal server.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public FirmwareConfig(Boolean simultaneousMultithreadingEnabled, Boolean sriovEn
         this.virtualizationEnabled = virtualizationEnabled;
     }
 
+    /**
+     * Allows a single physical processor core to appear as several logical processors.
+     */
     @JsonProperty("simultaneousMultithreadingEnabled")
     public Boolean getSimultaneousMultithreadingEnabled() {
         return simultaneousMultithreadingEnabled;
     }
 
+    /**
+     * Allows a single physical processor core to appear as several logical processors.
+     */
     @JsonProperty("simultaneousMultithreadingEnabled")
     public void setSimultaneousMultithreadingEnabled(Boolean simultaneousMultithreadingEnabled) {
         this.simultaneousMultithreadingEnabled = simultaneousMultithreadingEnabled;
     }
 
+    /**
+     * SR-IOV support enables a hypervisor to create virtual instances of a PCI-express device, potentially increasing performance.
+     */
     @JsonProperty("sriovEnabled")
     public Boolean getSriovEnabled() {
         return sriovEnabled;
     }
 
+    /**
+     * SR-IOV support enables a hypervisor to create virtual instances of a PCI-express device, potentially increasing performance.
+     */
     @JsonProperty("sriovEnabled")
     public void setSriovEnabled(Boolean sriovEnabled) {
         this.sriovEnabled = sriovEnabled;
     }
 
+    /**
+     * Supports the virtualization of platform hardware.
+     */
     @JsonProperty("virtualizationEnabled")
     public Boolean getVirtualizationEnabled() {
         return virtualizationEnabled;
     }
 
+    /**
+     * Supports the virtualization of platform hardware.
+     */
     @JsonProperty("virtualizationEnabled")
     public void setVirtualizationEnabled(Boolean virtualizationEnabled) {
         this.virtualizationEnabled = virtualizationEnabled;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/FirmwareSchema.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/FirmwareSchema.java
index 0eb14f47b0f..dfa5f6646b2 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/FirmwareSchema.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/FirmwareSchema.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FirmwareSchema is the Schema for the firmwareschemas API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class FirmwareSchema implements Editable<FirmwareSchemaBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "metal3.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "FirmwareSchema";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public FirmwareSchema(String apiVersion, String kind, ObjectMeta metadata, Firmw
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * FirmwareSchema is the Schema for the firmwareschemas API.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * FirmwareSchema is the Schema for the firmwareschemas API.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * FirmwareSchema is the Schema for the firmwareschemas API.
+     */
     @JsonProperty("spec")
     public FirmwareSchemaSpec getSpec() {
         return spec;
     }
 
+    /**
+     * FirmwareSchema is the Schema for the firmwareschemas API.
+     */
     @JsonProperty("spec")
     public void setSpec(FirmwareSchemaSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/FirmwareSchemaList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/FirmwareSchemaList.java
index 143b07dd5ec..cd87774c28a 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/FirmwareSchemaList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/FirmwareSchemaList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FirmwareSchemaList contains a list of FirmwareSchema.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class FirmwareSchemaList implements Editable<FirmwareSchemaListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.FirmwareSchema>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "metal3.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.FirmwareSchema> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "FirmwareSchemaList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public FirmwareSchemaList(String apiVersion, List<io.fabric8.openshift.api.model
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * FirmwareSchemaList contains a list of FirmwareSchema.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.FirmwareSchema> getItems() {
         return items;
     }
 
+    /**
+     * FirmwareSchemaList contains a list of FirmwareSchema.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.FirmwareSchema> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * FirmwareSchemaList contains a list of FirmwareSchema.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * FirmwareSchemaList contains a list of FirmwareSchema.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/FirmwareSchemaSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/FirmwareSchemaSpec.java
index b4003eaa4aa..70cf7077f32 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/FirmwareSchemaSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/FirmwareSchemaSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FirmwareSchemaSpec defines the desired state of FirmwareSchema.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,32 +90,50 @@ public FirmwareSchemaSpec(String hardwareModel, String hardwareVendor, Map<Strin
         this.schema = schema;
     }
 
+    /**
+     * The hardware model associated with this schema
+     */
     @JsonProperty("hardwareModel")
     public String getHardwareModel() {
         return hardwareModel;
     }
 
+    /**
+     * The hardware model associated with this schema
+     */
     @JsonProperty("hardwareModel")
     public void setHardwareModel(String hardwareModel) {
         this.hardwareModel = hardwareModel;
     }
 
+    /**
+     * The hardware vendor associated with this schema
+     */
     @JsonProperty("hardwareVendor")
     public String getHardwareVendor() {
         return hardwareVendor;
     }
 
+    /**
+     * The hardware vendor associated with this schema
+     */
     @JsonProperty("hardwareVendor")
     public void setHardwareVendor(String hardwareVendor) {
         this.hardwareVendor = hardwareVendor;
     }
 
+    /**
+     * Map of firmware name to schema
+     */
     @JsonProperty("schema")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, SettingSchema> getSchema() {
         return schema;
     }
 
+    /**
+     * Map of firmware name to schema
+     */
     @JsonProperty("schema")
     public void setSchema(Map<String, SettingSchema> schema) {
         this.schema = schema;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/FirmwareUpdate.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/FirmwareUpdate.java
index f39508e82a2..1b8e470795f 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/FirmwareUpdate.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/FirmwareUpdate.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FirmwareUpdate defines a firmware update specification.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public FirmwareUpdate(String component, String url) {
         this.url = url;
     }
 
+    /**
+     * FirmwareUpdate defines a firmware update specification.
+     */
     @JsonProperty("component")
     public String getComponent() {
         return component;
     }
 
+    /**
+     * FirmwareUpdate defines a firmware update specification.
+     */
     @JsonProperty("component")
     public void setComponent(String component) {
         this.component = component;
     }
 
+    /**
+     * FirmwareUpdate defines a firmware update specification.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * FirmwareUpdate defines a firmware update specification.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HardwareData.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HardwareData.java
index 0e29c70b794..9aff1cd683e 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HardwareData.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HardwareData.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HardwareData is the Schema for the hardwaredata API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class HardwareData implements Editable<HardwareDataBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "metal3.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "HardwareData";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public HardwareData(String apiVersion, String kind, ObjectMeta metadata, Hardwar
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * HardwareData is the Schema for the hardwaredata API.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * HardwareData is the Schema for the hardwaredata API.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * HardwareData is the Schema for the hardwaredata API.
+     */
     @JsonProperty("spec")
     public HardwareDataSpec getSpec() {
         return spec;
     }
 
+    /**
+     * HardwareData is the Schema for the hardwaredata API.
+     */
     @JsonProperty("spec")
     public void setSpec(HardwareDataSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HardwareDataList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HardwareDataList.java
index 80a324f7ba3..6d8e40562e8 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HardwareDataList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HardwareDataList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HardwareDataList contains a list of HardwareData.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class HardwareDataList implements Editable<HardwareDataListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.HardwareData>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "metal3.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.HardwareData> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "HardwareDataList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public HardwareDataList(String apiVersion, List<io.fabric8.openshift.api.model.m
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * HardwareDataList contains a list of HardwareData.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.HardwareData> getItems() {
         return items;
     }
 
+    /**
+     * HardwareDataList contains a list of HardwareData.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.HardwareData> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * HardwareDataList contains a list of HardwareData.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * HardwareDataList contains a list of HardwareData.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HardwareDataSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HardwareDataSpec.java
index 5ccb4da537a..d2b519d73f0 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HardwareDataSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HardwareDataSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HardwareDataSpec defines the desired state of HardwareData.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public HardwareDataSpec(HardwareDetails hardware) {
         this.hardware = hardware;
     }
 
+    /**
+     * HardwareDataSpec defines the desired state of HardwareData.
+     */
     @JsonProperty("hardware")
     public HardwareDetails getHardware() {
         return hardware;
     }
 
+    /**
+     * HardwareDataSpec defines the desired state of HardwareData.
+     */
     @JsonProperty("hardware")
     public void setHardware(HardwareDetails hardware) {
         this.hardware = hardware;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HardwareDetails.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HardwareDetails.java
index 13ec2f2fee9..6254a6cc335 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HardwareDetails.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HardwareDetails.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HardwareDetails collects all of the information about hardware discovered on the host.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -106,73 +109,115 @@ public HardwareDetails(CPU cpu, Firmware firmware, String hostname, List<NIC> ni
         this.systemVendor = systemVendor;
     }
 
+    /**
+     * HardwareDetails collects all of the information about hardware discovered on the host.
+     */
     @JsonProperty("cpu")
     public CPU getCpu() {
         return cpu;
     }
 
+    /**
+     * HardwareDetails collects all of the information about hardware discovered on the host.
+     */
     @JsonProperty("cpu")
     public void setCpu(CPU cpu) {
         this.cpu = cpu;
     }
 
+    /**
+     * HardwareDetails collects all of the information about hardware discovered on the host.
+     */
     @JsonProperty("firmware")
     public Firmware getFirmware() {
         return firmware;
     }
 
+    /**
+     * HardwareDetails collects all of the information about hardware discovered on the host.
+     */
     @JsonProperty("firmware")
     public void setFirmware(Firmware firmware) {
         this.firmware = firmware;
     }
 
+    /**
+     * HardwareDetails collects all of the information about hardware discovered on the host.
+     */
     @JsonProperty("hostname")
     public String getHostname() {
         return hostname;
     }
 
+    /**
+     * HardwareDetails collects all of the information about hardware discovered on the host.
+     */
     @JsonProperty("hostname")
     public void setHostname(String hostname) {
         this.hostname = hostname;
     }
 
+    /**
+     * List of network interfaces for the host.
+     */
     @JsonProperty("nics")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NIC> getNics() {
         return nics;
     }
 
+    /**
+     * List of network interfaces for the host.
+     */
     @JsonProperty("nics")
     public void setNics(List<NIC> nics) {
         this.nics = nics;
     }
 
+    /**
+     * The host's amount of memory in Mebibytes.
+     */
     @JsonProperty("ramMebibytes")
     public Integer getRamMebibytes() {
         return ramMebibytes;
     }
 
+    /**
+     * The host's amount of memory in Mebibytes.
+     */
     @JsonProperty("ramMebibytes")
     public void setRamMebibytes(Integer ramMebibytes) {
         this.ramMebibytes = ramMebibytes;
     }
 
+    /**
+     * List of storage (disk, SSD, etc.) available to the host.
+     */
     @JsonProperty("storage")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Storage> getStorage() {
         return storage;
     }
 
+    /**
+     * List of storage (disk, SSD, etc.) available to the host.
+     */
     @JsonProperty("storage")
     public void setStorage(List<Storage> storage) {
         this.storage = storage;
     }
 
+    /**
+     * HardwareDetails collects all of the information about hardware discovered on the host.
+     */
     @JsonProperty("systemVendor")
     public HardwareSystemVendor getSystemVendor() {
         return systemVendor;
     }
 
+    /**
+     * HardwareDetails collects all of the information about hardware discovered on the host.
+     */
     @JsonProperty("systemVendor")
     public void setSystemVendor(HardwareSystemVendor systemVendor) {
         this.systemVendor = systemVendor;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HardwareRAIDVolume.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HardwareRAIDVolume.java
index 3095a58b871..21f03bc46f3 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HardwareRAIDVolume.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HardwareRAIDVolume.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HardwareRAIDVolume defines the desired configuration of volume in hardware RAID.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -105,72 +108,114 @@ public HardwareRAIDVolume(String controller, String level, String name, Integer
         this.sizeGibibytes = sizeGibibytes;
     }
 
+    /**
+     * The name of the RAID controller to use.
+     */
     @JsonProperty("controller")
     public String getController() {
         return controller;
     }
 
+    /**
+     * The name of the RAID controller to use.
+     */
     @JsonProperty("controller")
     public void setController(String controller) {
         this.controller = controller;
     }
 
+    /**
+     * RAID level for the logical disk. The following levels are supported: 0, 1, 2, 5, 6, 1+0, 5+0, 6+0 (drivers may support only some of them).
+     */
     @JsonProperty("level")
     public String getLevel() {
         return level;
     }
 
+    /**
+     * RAID level for the logical disk. The following levels are supported: 0, 1, 2, 5, 6, 1+0, 5+0, 6+0 (drivers may support only some of them).
+     */
     @JsonProperty("level")
     public void setLevel(String level) {
         this.level = level;
     }
 
+    /**
+     * Name of the volume. Should be unique within the Node. If not specified, the name will be auto-generated.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the volume. Should be unique within the Node. If not specified, the name will be auto-generated.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Integer, number of physical disks to use for the logical disk. Defaults to minimum number of disks required for the particular RAID level.
+     */
     @JsonProperty("numberOfPhysicalDisks")
     public Integer getNumberOfPhysicalDisks() {
         return numberOfPhysicalDisks;
     }
 
+    /**
+     * Integer, number of physical disks to use for the logical disk. Defaults to minimum number of disks required for the particular RAID level.
+     */
     @JsonProperty("numberOfPhysicalDisks")
     public void setNumberOfPhysicalDisks(Integer numberOfPhysicalDisks) {
         this.numberOfPhysicalDisks = numberOfPhysicalDisks;
     }
 
+    /**
+     * Optional list of physical disk names to be used for the hardware RAID volumes. The disk names are interpreted by the hardware RAID controller, and the format is hardware specific.
+     */
     @JsonProperty("physicalDisks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPhysicalDisks() {
         return physicalDisks;
     }
 
+    /**
+     * Optional list of physical disk names to be used for the hardware RAID volumes. The disk names are interpreted by the hardware RAID controller, and the format is hardware specific.
+     */
     @JsonProperty("physicalDisks")
     public void setPhysicalDisks(List<String> physicalDisks) {
         this.physicalDisks = physicalDisks;
     }
 
+    /**
+     * Select disks with only rotational (if set to true) or solid-state (if set to false) storage. By default, any disks can be picked.
+     */
     @JsonProperty("rotational")
     public Boolean getRotational() {
         return rotational;
     }
 
+    /**
+     * Select disks with only rotational (if set to true) or solid-state (if set to false) storage. By default, any disks can be picked.
+     */
     @JsonProperty("rotational")
     public void setRotational(Boolean rotational) {
         this.rotational = rotational;
     }
 
+    /**
+     * Size of the logical disk to be created in GiB. If unspecified or set be 0, the maximum capacity of disk will be used for logical disk.
+     */
     @JsonProperty("sizeGibibytes")
     public Integer getSizeGibibytes() {
         return sizeGibibytes;
     }
 
+    /**
+     * Size of the logical disk to be created in GiB. If unspecified or set be 0, the maximum capacity of disk will be used for logical disk.
+     */
     @JsonProperty("sizeGibibytes")
     public void setSizeGibibytes(Integer sizeGibibytes) {
         this.sizeGibibytes = sizeGibibytes;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HardwareSystemVendor.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HardwareSystemVendor.java
index ee37dd6bbe2..915f21cd0f2 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HardwareSystemVendor.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HardwareSystemVendor.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HardwareSystemVendor stores details about the whole hardware system.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public HardwareSystemVendor(String manufacturer, String productName, String seri
         this.serialNumber = serialNumber;
     }
 
+    /**
+     * HardwareSystemVendor stores details about the whole hardware system.
+     */
     @JsonProperty("manufacturer")
     public String getManufacturer() {
         return manufacturer;
     }
 
+    /**
+     * HardwareSystemVendor stores details about the whole hardware system.
+     */
     @JsonProperty("manufacturer")
     public void setManufacturer(String manufacturer) {
         this.manufacturer = manufacturer;
     }
 
+    /**
+     * HardwareSystemVendor stores details about the whole hardware system.
+     */
     @JsonProperty("productName")
     public String getProductName() {
         return productName;
     }
 
+    /**
+     * HardwareSystemVendor stores details about the whole hardware system.
+     */
     @JsonProperty("productName")
     public void setProductName(String productName) {
         this.productName = productName;
     }
 
+    /**
+     * HardwareSystemVendor stores details about the whole hardware system.
+     */
     @JsonProperty("serialNumber")
     public String getSerialNumber() {
         return serialNumber;
     }
 
+    /**
+     * HardwareSystemVendor stores details about the whole hardware system.
+     */
     @JsonProperty("serialNumber")
     public void setSerialNumber(String serialNumber) {
         this.serialNumber = serialNumber;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareComponents.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareComponents.java
index df606495234..b8210e2fdba 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareComponents.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareComponents.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HostFirmwareComponents is the Schema for the hostfirmwarecomponents API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class HostFirmwareComponents implements Editable<HostFirmwareComponentsBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "metal3.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "HostFirmwareComponents";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public HostFirmwareComponents(String apiVersion, String kind, ObjectMeta metadat
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * HostFirmwareComponents is the Schema for the hostfirmwarecomponents API.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * HostFirmwareComponents is the Schema for the hostfirmwarecomponents API.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * HostFirmwareComponents is the Schema for the hostfirmwarecomponents API.
+     */
     @JsonProperty("spec")
     public HostFirmwareComponentsSpec getSpec() {
         return spec;
     }
 
+    /**
+     * HostFirmwareComponents is the Schema for the hostfirmwarecomponents API.
+     */
     @JsonProperty("spec")
     public void setSpec(HostFirmwareComponentsSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * HostFirmwareComponents is the Schema for the hostfirmwarecomponents API.
+     */
     @JsonProperty("status")
     public HostFirmwareComponentsStatus getStatus() {
         return status;
     }
 
+    /**
+     * HostFirmwareComponents is the Schema for the hostfirmwarecomponents API.
+     */
     @JsonProperty("status")
     public void setStatus(HostFirmwareComponentsStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareComponentsList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareComponentsList.java
index 7362c69e3b5..1aa9138786d 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareComponentsList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareComponentsList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HostFirmwareComponentsList contains a list of HostFirmwareComponents.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class HostFirmwareComponentsList implements Editable<HostFirmwareComponentsListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.HostFirmwareComponents>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "metal3.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.HostFirmwareComponents> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "HostFirmwareComponentsList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public HostFirmwareComponentsList(String apiVersion, List<io.fabric8.openshift.a
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * HostFirmwareComponentsList contains a list of HostFirmwareComponents.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.HostFirmwareComponents> getItems() {
         return items;
     }
 
+    /**
+     * HostFirmwareComponentsList contains a list of HostFirmwareComponents.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.HostFirmwareComponents> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * HostFirmwareComponentsList contains a list of HostFirmwareComponents.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * HostFirmwareComponentsList contains a list of HostFirmwareComponents.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareComponentsSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareComponentsSpec.java
index 070d0df21e8..5f07678a0d2 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareComponentsSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareComponentsSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HostFirmwareComponentsSpec defines the desired state of HostFirmwareComponents.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public HostFirmwareComponentsSpec(List<FirmwareUpdate> updates) {
         this.updates = updates;
     }
 
+    /**
+     * HostFirmwareComponentsSpec defines the desired state of HostFirmwareComponents.
+     */
     @JsonProperty("updates")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<FirmwareUpdate> getUpdates() {
         return updates;
     }
 
+    /**
+     * HostFirmwareComponentsSpec defines the desired state of HostFirmwareComponents.
+     */
     @JsonProperty("updates")
     public void setUpdates(List<FirmwareUpdate> updates) {
         this.updates = updates;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareComponentsStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareComponentsStatus.java
index 5549c5a906d..8b2096854da 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareComponentsStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareComponentsStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HostFirmwareComponentsStatus defines the observed state of HostFirmwareComponents.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -96,44 +99,68 @@ public HostFirmwareComponentsStatus(List<FirmwareComponentStatus> components, Li
         this.updates = updates;
     }
 
+    /**
+     * Components is the list of all available firmware components and their information.
+     */
     @JsonProperty("components")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<FirmwareComponentStatus> getComponents() {
         return components;
     }
 
+    /**
+     * Components is the list of all available firmware components and their information.
+     */
     @JsonProperty("components")
     public void setComponents(List<FirmwareComponentStatus> components) {
         this.components = components;
     }
 
+    /**
+     * Track whether updates stored in the spec are valid based on the schema
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Track whether updates stored in the spec are valid based on the schema
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * HostFirmwareComponentsStatus defines the observed state of HostFirmwareComponents.
+     */
     @JsonProperty("lastUpdated")
     public String getLastUpdated() {
         return lastUpdated;
     }
 
+    /**
+     * HostFirmwareComponentsStatus defines the observed state of HostFirmwareComponents.
+     */
     @JsonProperty("lastUpdated")
     public void setLastUpdated(String lastUpdated) {
         this.lastUpdated = lastUpdated;
     }
 
+    /**
+     * Updates is the list of all firmware components that should be updated they are specified via name and url fields.
+     */
     @JsonProperty("updates")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<FirmwareUpdate> getUpdates() {
         return updates;
     }
 
+    /**
+     * Updates is the list of all firmware components that should be updated they are specified via name and url fields.
+     */
     @JsonProperty("updates")
     public void setUpdates(List<FirmwareUpdate> updates) {
         this.updates = updates;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareSettings.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareSettings.java
index 59a5cb9d0fe..70e02bb9d96 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareSettings.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareSettings.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HostFirmwareSettings is the Schema for the hostfirmwaresettings API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class HostFirmwareSettings implements Editable<HostFirmwareSettingsBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "metal3.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "HostFirmwareSettings";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public HostFirmwareSettings(String apiVersion, String kind, ObjectMeta metadata,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * HostFirmwareSettings is the Schema for the hostfirmwaresettings API.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * HostFirmwareSettings is the Schema for the hostfirmwaresettings API.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * HostFirmwareSettings is the Schema for the hostfirmwaresettings API.
+     */
     @JsonProperty("spec")
     public HostFirmwareSettingsSpec getSpec() {
         return spec;
     }
 
+    /**
+     * HostFirmwareSettings is the Schema for the hostfirmwaresettings API.
+     */
     @JsonProperty("spec")
     public void setSpec(HostFirmwareSettingsSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * HostFirmwareSettings is the Schema for the hostfirmwaresettings API.
+     */
     @JsonProperty("status")
     public HostFirmwareSettingsStatus getStatus() {
         return status;
     }
 
+    /**
+     * HostFirmwareSettings is the Schema for the hostfirmwaresettings API.
+     */
     @JsonProperty("status")
     public void setStatus(HostFirmwareSettingsStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareSettingsList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareSettingsList.java
index cebba9fbe97..c5e2b79ca6f 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareSettingsList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareSettingsList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HostFirmwareSettingsList contains a list of HostFirmwareSettings.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class HostFirmwareSettingsList implements Editable<HostFirmwareSettingsListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.HostFirmwareSettings>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "metal3.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.HostFirmwareSettings> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "HostFirmwareSettingsList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public HostFirmwareSettingsList(String apiVersion, List<io.fabric8.openshift.api
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * HostFirmwareSettingsList contains a list of HostFirmwareSettings.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.HostFirmwareSettings> getItems() {
         return items;
     }
 
+    /**
+     * HostFirmwareSettingsList contains a list of HostFirmwareSettings.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.HostFirmwareSettings> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * HostFirmwareSettingsList contains a list of HostFirmwareSettings.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * HostFirmwareSettingsList contains a list of HostFirmwareSettings.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareSettingsSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareSettingsSpec.java
index 462e001d44e..af3507f7297 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareSettingsSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareSettingsSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HostFirmwareSettingsSpec defines the desired state of HostFirmwareSettings.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,12 +82,18 @@ public HostFirmwareSettingsSpec(Map<String, IntOrString> settings) {
         this.settings = settings;
     }
 
+    /**
+     * Settings are the desired firmware settings stored as name/value pairs.
+     */
     @JsonProperty("settings")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, IntOrString> getSettings() {
         return settings;
     }
 
+    /**
+     * Settings are the desired firmware settings stored as name/value pairs.
+     */
     @JsonProperty("settings")
     public void setSettings(Map<String, IntOrString> settings) {
         this.settings = settings;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareSettingsStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareSettingsStatus.java
index 3eae214123e..dd1fb4ee219 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareSettingsStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostFirmwareSettingsStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HostFirmwareSettingsStatus defines the observed state of HostFirmwareSettings.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,43 +98,67 @@ public HostFirmwareSettingsStatus(List<Condition> conditions, String lastUpdated
         this.settings = settings;
     }
 
+    /**
+     * Track whether settings stored in the spec are valid based on the schema
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Track whether settings stored in the spec are valid based on the schema
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * HostFirmwareSettingsStatus defines the observed state of HostFirmwareSettings.
+     */
     @JsonProperty("lastUpdated")
     public String getLastUpdated() {
         return lastUpdated;
     }
 
+    /**
+     * HostFirmwareSettingsStatus defines the observed state of HostFirmwareSettings.
+     */
     @JsonProperty("lastUpdated")
     public void setLastUpdated(String lastUpdated) {
         this.lastUpdated = lastUpdated;
     }
 
+    /**
+     * HostFirmwareSettingsStatus defines the observed state of HostFirmwareSettings.
+     */
     @JsonProperty("schema")
     public SchemaReference getSchema() {
         return schema;
     }
 
+    /**
+     * HostFirmwareSettingsStatus defines the observed state of HostFirmwareSettings.
+     */
     @JsonProperty("schema")
     public void setSchema(SchemaReference schema) {
         this.schema = schema;
     }
 
+    /**
+     * Settings are the firmware settings stored as name/value pairs
+     */
     @JsonProperty("settings")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getSettings() {
         return settings;
     }
 
+    /**
+     * Settings are the firmware settings stored as name/value pairs
+     */
     @JsonProperty("settings")
     public void setSettings(Map<String, String> settings) {
         this.settings = settings;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostUpdatePolicy.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostUpdatePolicy.java
index c1a8ecf9212..12b2edd408b 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostUpdatePolicy.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostUpdatePolicy.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HostUpdatePolicy is the Schema for the hostupdatepolicy API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class HostUpdatePolicy implements Editable<HostUpdatePolicyBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "metal3.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "HostUpdatePolicy";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public HostUpdatePolicy(String apiVersion, String kind, ObjectMeta metadata, Hos
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * HostUpdatePolicy is the Schema for the hostupdatepolicy API.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * HostUpdatePolicy is the Schema for the hostupdatepolicy API.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * HostUpdatePolicy is the Schema for the hostupdatepolicy API.
+     */
     @JsonProperty("spec")
     public HostUpdatePolicySpec getSpec() {
         return spec;
     }
 
+    /**
+     * HostUpdatePolicy is the Schema for the hostupdatepolicy API.
+     */
     @JsonProperty("spec")
     public void setSpec(HostUpdatePolicySpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * HostUpdatePolicy is the Schema for the hostupdatepolicy API.
+     */
     @JsonProperty("status")
     public HostUpdatePolicyStatus getStatus() {
         return status;
     }
 
+    /**
+     * HostUpdatePolicy is the Schema for the hostupdatepolicy API.
+     */
     @JsonProperty("status")
     public void setStatus(HostUpdatePolicyStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostUpdatePolicyList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostUpdatePolicyList.java
index 900d6fc8f85..c126d256d6b 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostUpdatePolicyList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostUpdatePolicyList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HostUpdatePolicyList contains a list of HostUpdatePolicy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class HostUpdatePolicyList implements Editable<HostUpdatePolicyListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.HostUpdatePolicy>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "metal3.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.HostUpdatePolicy> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "HostUpdatePolicyList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public HostUpdatePolicyList(String apiVersion, List<io.fabric8.openshift.api.mod
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * HostUpdatePolicyList contains a list of HostUpdatePolicy.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.HostUpdatePolicy> getItems() {
         return items;
     }
 
+    /**
+     * HostUpdatePolicyList contains a list of HostUpdatePolicy.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.HostUpdatePolicy> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * HostUpdatePolicyList contains a list of HostUpdatePolicy.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * HostUpdatePolicyList contains a list of HostUpdatePolicy.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostUpdatePolicySpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostUpdatePolicySpec.java
index 5131b2b7bd9..3483b01880e 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostUpdatePolicySpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostUpdatePolicySpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HostUpdatePolicySpec defines the desired state of HostUpdatePolicy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public HostUpdatePolicySpec(String firmwareSettings, String firmwareUpdates) {
         this.firmwareUpdates = firmwareUpdates;
     }
 
+    /**
+     * Defines policy for changing firmware settings
+     */
     @JsonProperty("firmwareSettings")
     public String getFirmwareSettings() {
         return firmwareSettings;
     }
 
+    /**
+     * Defines policy for changing firmware settings
+     */
     @JsonProperty("firmwareSettings")
     public void setFirmwareSettings(String firmwareSettings) {
         this.firmwareSettings = firmwareSettings;
     }
 
+    /**
+     * Defines policy for updating firmware
+     */
     @JsonProperty("firmwareUpdates")
     public String getFirmwareUpdates() {
         return firmwareUpdates;
     }
 
+    /**
+     * Defines policy for updating firmware
+     */
     @JsonProperty("firmwareUpdates")
     public void setFirmwareUpdates(String firmwareUpdates) {
         this.firmwareUpdates = firmwareUpdates;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostUpdatePolicyStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostUpdatePolicyStatus.java
index 771a5d99485..e883e918902 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostUpdatePolicyStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/HostUpdatePolicyStatus.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HostUpdatePolicyStatus defines the observed state of HostUpdatePolicy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/Image.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/Image.java
index 9a3841d1103..7c9a162700c 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/Image.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/Image.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Image holds the details of an image either to provisioned or that has been provisioned.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public Image(String checksum, String checksumType, String format, String url) {
         this.url = url;
     }
 
+    /**
+     * Checksum is the checksum for the image. Required for all formats except for "live-iso".
+     */
     @JsonProperty("checksum")
     public String getChecksum() {
         return checksum;
     }
 
+    /**
+     * Checksum is the checksum for the image. Required for all formats except for "live-iso".
+     */
     @JsonProperty("checksum")
     public void setChecksum(String checksum) {
         this.checksum = checksum;
     }
 
+    /**
+     * ChecksumType is the checksum algorithm for the image, e.g md5, sha256 or sha512. The special value "auto" can be used to detect the algorithm from the checksum. If missing, MD5 is used. If in doubt, use "auto".
+     */
     @JsonProperty("checksumType")
     public String getChecksumType() {
         return checksumType;
     }
 
+    /**
+     * ChecksumType is the checksum algorithm for the image, e.g md5, sha256 or sha512. The special value "auto" can be used to detect the algorithm from the checksum. If missing, MD5 is used. If in doubt, use "auto".
+     */
     @JsonProperty("checksumType")
     public void setChecksumType(String checksumType) {
         this.checksumType = checksumType;
     }
 
+    /**
+     * Format contains the format of the image (raw, qcow2, ...). When set to "live-iso", an ISO 9660 image referenced by the url will be live-booted and not deployed to disk.
+     */
     @JsonProperty("format")
     public String getFormat() {
         return format;
     }
 
+    /**
+     * Format contains the format of the image (raw, qcow2, ...). When set to "live-iso", an ISO 9660 image referenced by the url will be live-booted and not deployed to disk.
+     */
     @JsonProperty("format")
     public void setFormat(String format) {
         this.format = format;
     }
 
+    /**
+     * URL is a location of an image to deploy.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * URL is a location of an image to deploy.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/NIC.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/NIC.java
index e4a1f2f3b40..377a8eaac83 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/NIC.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/NIC.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NIC describes one network interface on the host.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -109,82 +112,130 @@ public NIC(String ip, String mac, String model, String name, Boolean pxe, Intege
         this.vlans = vlans;
     }
 
+    /**
+     * The IP address of the interface. This will be an IPv4 or IPv6 address if one is present.  If both IPv4 and IPv6 addresses are present in a dual-stack environment, two nics will be output, one with each IP.
+     */
     @JsonProperty("ip")
     public String getIp() {
         return ip;
     }
 
+    /**
+     * The IP address of the interface. This will be an IPv4 or IPv6 address if one is present.  If both IPv4 and IPv6 addresses are present in a dual-stack environment, two nics will be output, one with each IP.
+     */
     @JsonProperty("ip")
     public void setIp(String ip) {
         this.ip = ip;
     }
 
+    /**
+     * The device MAC address
+     */
     @JsonProperty("mac")
     public String getMac() {
         return mac;
     }
 
+    /**
+     * The device MAC address
+     */
     @JsonProperty("mac")
     public void setMac(String mac) {
         this.mac = mac;
     }
 
+    /**
+     * The vendor and product IDs of the NIC, e.g. "0x8086 0x1572"
+     */
     @JsonProperty("model")
     public String getModel() {
         return model;
     }
 
+    /**
+     * The vendor and product IDs of the NIC, e.g. "0x8086 0x1572"
+     */
     @JsonProperty("model")
     public void setModel(String model) {
         this.model = model;
     }
 
+    /**
+     * The name of the network interface, e.g. "en0"
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The name of the network interface, e.g. "en0"
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Whether the NIC is PXE Bootable
+     */
     @JsonProperty("pxe")
     public Boolean getPxe() {
         return pxe;
     }
 
+    /**
+     * Whether the NIC is PXE Bootable
+     */
     @JsonProperty("pxe")
     public void setPxe(Boolean pxe) {
         this.pxe = pxe;
     }
 
+    /**
+     * The speed of the device in Gigabits per second
+     */
     @JsonProperty("speedGbps")
     public Integer getSpeedGbps() {
         return speedGbps;
     }
 
+    /**
+     * The speed of the device in Gigabits per second
+     */
     @JsonProperty("speedGbps")
     public void setSpeedGbps(Integer speedGbps) {
         this.speedGbps = speedGbps;
     }
 
+    /**
+     * The untagged VLAN ID
+     */
     @JsonProperty("vlanId")
     public Integer getVlanId() {
         return vlanId;
     }
 
+    /**
+     * The untagged VLAN ID
+     */
     @JsonProperty("vlanId")
     public void setVlanId(Integer vlanId) {
         this.vlanId = vlanId;
     }
 
+    /**
+     * The VLANs available
+     */
     @JsonProperty("vlans")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VLAN> getVlans() {
         return vlans;
     }
 
+    /**
+     * The VLANs available
+     */
     @JsonProperty("vlans")
     public void setVlans(List<VLAN> vlans) {
         this.vlans = vlans;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/OperationHistory.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/OperationHistory.java
index c2acf7e2b86..e48b4c0602f 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/OperationHistory.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/OperationHistory.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperationHistory holds information about operations performed on a host.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public OperationHistory(OperationMetric deprovision, OperationMetric inspect, Op
         this.register = register;
     }
 
+    /**
+     * OperationHistory holds information about operations performed on a host.
+     */
     @JsonProperty("deprovision")
     public OperationMetric getDeprovision() {
         return deprovision;
     }
 
+    /**
+     * OperationHistory holds information about operations performed on a host.
+     */
     @JsonProperty("deprovision")
     public void setDeprovision(OperationMetric deprovision) {
         this.deprovision = deprovision;
     }
 
+    /**
+     * OperationHistory holds information about operations performed on a host.
+     */
     @JsonProperty("inspect")
     public OperationMetric getInspect() {
         return inspect;
     }
 
+    /**
+     * OperationHistory holds information about operations performed on a host.
+     */
     @JsonProperty("inspect")
     public void setInspect(OperationMetric inspect) {
         this.inspect = inspect;
     }
 
+    /**
+     * OperationHistory holds information about operations performed on a host.
+     */
     @JsonProperty("provision")
     public OperationMetric getProvision() {
         return provision;
     }
 
+    /**
+     * OperationHistory holds information about operations performed on a host.
+     */
     @JsonProperty("provision")
     public void setProvision(OperationMetric provision) {
         this.provision = provision;
     }
 
+    /**
+     * OperationHistory holds information about operations performed on a host.
+     */
     @JsonProperty("register")
     public OperationMetric getRegister() {
         return register;
     }
 
+    /**
+     * OperationHistory holds information about operations performed on a host.
+     */
     @JsonProperty("register")
     public void setRegister(OperationMetric register) {
         this.register = register;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/OperationMetric.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/OperationMetric.java
index f57d1edaee1..800435839d9 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/OperationMetric.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/OperationMetric.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperationMetric contains metadata about an operation (inspection, provisioning, etc.) used for tracking metrics.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public OperationMetric(String end, String start) {
         this.start = start;
     }
 
+    /**
+     * OperationMetric contains metadata about an operation (inspection, provisioning, etc.) used for tracking metrics.
+     */
     @JsonProperty("end")
     public String getEnd() {
         return end;
     }
 
+    /**
+     * OperationMetric contains metadata about an operation (inspection, provisioning, etc.) used for tracking metrics.
+     */
     @JsonProperty("end")
     public void setEnd(String end) {
         this.end = end;
     }
 
+    /**
+     * OperationMetric contains metadata about an operation (inspection, provisioning, etc.) used for tracking metrics.
+     */
     @JsonProperty("start")
     public String getStart() {
         return start;
     }
 
+    /**
+     * OperationMetric contains metadata about an operation (inspection, provisioning, etc.) used for tracking metrics.
+     */
     @JsonProperty("start")
     public void setStart(String start) {
         this.start = start;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/PreprovisioningImage.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/PreprovisioningImage.java
index 44c1019f398..d3565cbe831 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/PreprovisioningImage.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/PreprovisioningImage.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PreprovisioningImage is the Schema for the preprovisioningimages API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class PreprovisioningImage implements Editable<PreprovisioningImageBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "metal3.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PreprovisioningImage";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PreprovisioningImage(String apiVersion, String kind, ObjectMeta metadata,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PreprovisioningImage is the Schema for the preprovisioningimages API.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PreprovisioningImage is the Schema for the preprovisioningimages API.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PreprovisioningImage is the Schema for the preprovisioningimages API.
+     */
     @JsonProperty("spec")
     public PreprovisioningImageSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PreprovisioningImage is the Schema for the preprovisioningimages API.
+     */
     @JsonProperty("spec")
     public void setSpec(PreprovisioningImageSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PreprovisioningImage is the Schema for the preprovisioningimages API.
+     */
     @JsonProperty("status")
     public PreprovisioningImageStatus getStatus() {
         return status;
     }
 
+    /**
+     * PreprovisioningImage is the Schema for the preprovisioningimages API.
+     */
     @JsonProperty("status")
     public void setStatus(PreprovisioningImageStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/PreprovisioningImageList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/PreprovisioningImageList.java
index 01faf4e0cdb..bdd377feca5 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/PreprovisioningImageList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/PreprovisioningImageList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PreprovisioningImageList contains a list of PreprovisioningImage.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PreprovisioningImageList implements Editable<PreprovisioningImageListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.PreprovisioningImage>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "metal3.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.PreprovisioningImage> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PreprovisioningImageList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PreprovisioningImageList(String apiVersion, List<io.fabric8.openshift.api
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PreprovisioningImageList contains a list of PreprovisioningImage.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.PreprovisioningImage> getItems() {
         return items;
     }
 
+    /**
+     * PreprovisioningImageList contains a list of PreprovisioningImage.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1alpha1.PreprovisioningImage> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PreprovisioningImageList contains a list of PreprovisioningImage.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PreprovisioningImageList contains a list of PreprovisioningImage.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/PreprovisioningImageSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/PreprovisioningImageSpec.java
index 4d396021975..9222b53f142 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/PreprovisioningImageSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/PreprovisioningImageSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PreprovisioningImageSpec defines the desired state of PreprovisioningImage.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public PreprovisioningImageSpec(List<String> acceptFormats, String architecture,
         this.networkDataName = networkDataName;
     }
 
+    /**
+     * acceptFormats is a list of acceptable image formats.
+     */
     @JsonProperty("acceptFormats")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAcceptFormats() {
         return acceptFormats;
     }
 
+    /**
+     * acceptFormats is a list of acceptable image formats.
+     */
     @JsonProperty("acceptFormats")
     public void setAcceptFormats(List<String> acceptFormats) {
         this.acceptFormats = acceptFormats;
     }
 
+    /**
+     * architecture is the processor architecture for which to build the image.
+     */
     @JsonProperty("architecture")
     public String getArchitecture() {
         return architecture;
     }
 
+    /**
+     * architecture is the processor architecture for which to build the image.
+     */
     @JsonProperty("architecture")
     public void setArchitecture(String architecture) {
         this.architecture = architecture;
     }
 
+    /**
+     * networkDataName is the name of a Secret in the local namespace that contains network data to build in to the image.
+     */
     @JsonProperty("networkDataName")
     public String getNetworkDataName() {
         return networkDataName;
     }
 
+    /**
+     * networkDataName is the name of a Secret in the local namespace that contains network data to build in to the image.
+     */
     @JsonProperty("networkDataName")
     public void setNetworkDataName(String networkDataName) {
         this.networkDataName = networkDataName;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/PreprovisioningImageStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/PreprovisioningImageStatus.java
index 2a2893c7cb2..e730a3ed27f 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/PreprovisioningImageStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/PreprovisioningImageStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PreprovisioningImageStatus defines the observed state of PreprovisioningImage.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -106,72 +109,114 @@ public PreprovisioningImageStatus(String architecture, List<Condition> condition
         this.networkData = networkData;
     }
 
+    /**
+     * architecture is the processor architecture for which the image is built
+     */
     @JsonProperty("architecture")
     public String getArchitecture() {
         return architecture;
     }
 
+    /**
+     * architecture is the processor architecture for which the image is built
+     */
     @JsonProperty("architecture")
     public void setArchitecture(String architecture) {
         this.architecture = architecture;
     }
 
+    /**
+     * conditions describe the state of the built image
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions describe the state of the built image
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * extraKernelParams is a string with extra parameters to pass to the kernel when booting the image over network. Only makes sense for initrd images.
+     */
     @JsonProperty("extraKernelParams")
     public String getExtraKernelParams() {
         return extraKernelParams;
     }
 
+    /**
+     * extraKernelParams is a string with extra parameters to pass to the kernel when booting the image over network. Only makes sense for initrd images.
+     */
     @JsonProperty("extraKernelParams")
     public void setExtraKernelParams(String extraKernelParams) {
         this.extraKernelParams = extraKernelParams;
     }
 
+    /**
+     * format is the type of image that is available at the download url: either iso or initrd.
+     */
     @JsonProperty("format")
     public String getFormat() {
         return format;
     }
 
+    /**
+     * format is the type of image that is available at the download url: either iso or initrd.
+     */
     @JsonProperty("format")
     public void setFormat(String format) {
         this.format = format;
     }
 
+    /**
+     * imageUrl is the URL from which the built image can be downloaded.
+     */
     @JsonProperty("imageUrl")
     public String getImageUrl() {
         return imageUrl;
     }
 
+    /**
+     * imageUrl is the URL from which the built image can be downloaded.
+     */
     @JsonProperty("imageUrl")
     public void setImageUrl(String imageUrl) {
         this.imageUrl = imageUrl;
     }
 
+    /**
+     * kernelUrl is the URL from which the kernel of the image can be downloaded. Only makes sense for initrd images.
+     */
     @JsonProperty("kernelUrl")
     public String getKernelUrl() {
         return kernelUrl;
     }
 
+    /**
+     * kernelUrl is the URL from which the kernel of the image can be downloaded. Only makes sense for initrd images.
+     */
     @JsonProperty("kernelUrl")
     public void setKernelUrl(String kernelUrl) {
         this.kernelUrl = kernelUrl;
     }
 
+    /**
+     * PreprovisioningImageStatus defines the observed state of PreprovisioningImage.
+     */
     @JsonProperty("networkData")
     public SecretStatus getNetworkData() {
         return networkData;
     }
 
+    /**
+     * PreprovisioningImageStatus defines the observed state of PreprovisioningImage.
+     */
     @JsonProperty("networkData")
     public void setNetworkData(SecretStatus networkData) {
         this.networkData = networkData;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/ProvisionStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/ProvisionStatus.java
index c918cdf7aa0..6575667796a 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/ProvisionStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/ProvisionStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ProvisionStatus holds the state information for a single target.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -106,81 +109,129 @@ public ProvisionStatus(String iD, String bootMode, CustomDeploy customDeploy, Fi
         this.state = state;
     }
 
+    /**
+     * The hosts's ID from the underlying provisioning tool (e.g. the Ironic node UUID).
+     */
     @JsonProperty("ID")
     public String getID() {
         return iD;
     }
 
+    /**
+     * The hosts's ID from the underlying provisioning tool (e.g. the Ironic node UUID).
+     */
     @JsonProperty("ID")
     public void setID(String iD) {
         this.iD = iD;
     }
 
+    /**
+     * BootMode indicates the boot mode used to provision the node
+     */
     @JsonProperty("bootMode")
     public String getBootMode() {
         return bootMode;
     }
 
+    /**
+     * BootMode indicates the boot mode used to provision the node
+     */
     @JsonProperty("bootMode")
     public void setBootMode(String bootMode) {
         this.bootMode = bootMode;
     }
 
+    /**
+     * ProvisionStatus holds the state information for a single target.
+     */
     @JsonProperty("customDeploy")
     public CustomDeploy getCustomDeploy() {
         return customDeploy;
     }
 
+    /**
+     * ProvisionStatus holds the state information for a single target.
+     */
     @JsonProperty("customDeploy")
     public void setCustomDeploy(CustomDeploy customDeploy) {
         this.customDeploy = customDeploy;
     }
 
+    /**
+     * ProvisionStatus holds the state information for a single target.
+     */
     @JsonProperty("firmware")
     public FirmwareConfig getFirmware() {
         return firmware;
     }
 
+    /**
+     * ProvisionStatus holds the state information for a single target.
+     */
     @JsonProperty("firmware")
     public void setFirmware(FirmwareConfig firmware) {
         this.firmware = firmware;
     }
 
+    /**
+     * ProvisionStatus holds the state information for a single target.
+     */
     @JsonProperty("image")
     public Image getImage() {
         return image;
     }
 
+    /**
+     * ProvisionStatus holds the state information for a single target.
+     */
     @JsonProperty("image")
     public void setImage(Image image) {
         this.image = image;
     }
 
+    /**
+     * ProvisionStatus holds the state information for a single target.
+     */
     @JsonProperty("raid")
     public RAIDConfig getRaid() {
         return raid;
     }
 
+    /**
+     * ProvisionStatus holds the state information for a single target.
+     */
     @JsonProperty("raid")
     public void setRaid(RAIDConfig raid) {
         this.raid = raid;
     }
 
+    /**
+     * ProvisionStatus holds the state information for a single target.
+     */
     @JsonProperty("rootDeviceHints")
     public RootDeviceHints getRootDeviceHints() {
         return rootDeviceHints;
     }
 
+    /**
+     * ProvisionStatus holds the state information for a single target.
+     */
     @JsonProperty("rootDeviceHints")
     public void setRootDeviceHints(RootDeviceHints rootDeviceHints) {
         this.rootDeviceHints = rootDeviceHints;
     }
 
+    /**
+     * An indicator for what the provisioner is doing with the host.
+     */
     @JsonProperty("state")
     public String getState() {
         return state;
     }
 
+    /**
+     * An indicator for what the provisioner is doing with the host.
+     */
     @JsonProperty("state")
     public void setState(String state) {
         this.state = state;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/RAIDConfig.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/RAIDConfig.java
index 4907f9902b9..5e62e2957e6 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/RAIDConfig.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/RAIDConfig.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RAIDConfig contains the configuration that are required to config RAID in Bare Metal server.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public RAIDConfig(List<HardwareRAIDVolume> hardwareRAIDVolumes, List<SoftwareRAI
         this.softwareRAIDVolumes = softwareRAIDVolumes;
     }
 
+    /**
+     * The list of logical disks for hardware RAID, if rootDeviceHints isn't used, first volume is root volume. You can set the value of this field to `[]` to clear all the hardware RAID configurations.
+     */
     @JsonProperty("hardwareRAIDVolumes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HardwareRAIDVolume> getHardwareRAIDVolumes() {
         return hardwareRAIDVolumes;
     }
 
+    /**
+     * The list of logical disks for hardware RAID, if rootDeviceHints isn't used, first volume is root volume. You can set the value of this field to `[]` to clear all the hardware RAID configurations.
+     */
     @JsonProperty("hardwareRAIDVolumes")
     public void setHardwareRAIDVolumes(List<HardwareRAIDVolume> hardwareRAIDVolumes) {
         this.hardwareRAIDVolumes = hardwareRAIDVolumes;
     }
 
+    /**
+     * The list of logical disks for software RAID, if rootDeviceHints isn't used, first volume is root volume. If HardwareRAIDVolumes is set this item will be invalid. The number of created Software RAID devices must be 1 or 2. If there is only one Software RAID device, it has to be a RAID-1. If there are two, the first one has to be a RAID-1, while the RAID level for the second one can be 0, 1, or 1+0. As the first RAID device will be the deployment device, enforcing a RAID-1 reduces the risk of ending up with a non-booting node in case of a disk failure. Software RAID will always be deleted.
+     */
     @JsonProperty("softwareRAIDVolumes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SoftwareRAIDVolume> getSoftwareRAIDVolumes() {
         return softwareRAIDVolumes;
     }
 
+    /**
+     * The list of logical disks for software RAID, if rootDeviceHints isn't used, first volume is root volume. If HardwareRAIDVolumes is set this item will be invalid. The number of created Software RAID devices must be 1 or 2. If there is only one Software RAID device, it has to be a RAID-1. If there are two, the first one has to be a RAID-1, while the RAID level for the second one can be 0, 1, or 1+0. As the first RAID device will be the deployment device, enforcing a RAID-1 reduces the risk of ending up with a non-booting node in case of a disk failure. Software RAID will always be deleted.
+     */
     @JsonProperty("softwareRAIDVolumes")
     public void setSoftwareRAIDVolumes(List<SoftwareRAIDVolume> softwareRAIDVolumes) {
         this.softwareRAIDVolumes = softwareRAIDVolumes;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/RebootAnnotationArguments.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/RebootAnnotationArguments.java
index 1e8e04a8593..23f5ca3bbc8 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/RebootAnnotationArguments.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/RebootAnnotationArguments.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RebootAnnotationArguments defines the arguments of the RebootAnnotation type.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public RebootAnnotationArguments(Boolean force, String mode) {
         this.mode = mode;
     }
 
+    /**
+     * RebootAnnotationArguments defines the arguments of the RebootAnnotation type.
+     */
     @JsonProperty("force")
     public Boolean getForce() {
         return force;
     }
 
+    /**
+     * RebootAnnotationArguments defines the arguments of the RebootAnnotation type.
+     */
     @JsonProperty("force")
     public void setForce(Boolean force) {
         this.force = force;
     }
 
+    /**
+     * RebootAnnotationArguments defines the arguments of the RebootAnnotation type.
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * RebootAnnotationArguments defines the arguments of the RebootAnnotation type.
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/RootDeviceHints.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/RootDeviceHints.java
index 25d4510e37b..cc522213938 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/RootDeviceHints.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/RootDeviceHints.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RootDeviceHints holds the hints for specifying the storage location for the root filesystem for the image.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -114,101 +117,161 @@ public RootDeviceHints(String deviceName, String hctl, Integer minSizeGigabytes,
         this.wwnWithExtension = wwnWithExtension;
     }
 
+    /**
+     * A Linux device name like "/dev/vda", or a by-path link to it like "/dev/disk/by-path/pci-0000:01:00.0-scsi-0:2:0:0". The hint must match the actual value exactly.
+     */
     @JsonProperty("deviceName")
     public String getDeviceName() {
         return deviceName;
     }
 
+    /**
+     * A Linux device name like "/dev/vda", or a by-path link to it like "/dev/disk/by-path/pci-0000:01:00.0-scsi-0:2:0:0". The hint must match the actual value exactly.
+     */
     @JsonProperty("deviceName")
     public void setDeviceName(String deviceName) {
         this.deviceName = deviceName;
     }
 
+    /**
+     * A SCSI bus address like 0:0:0:0. The hint must match the actual value exactly.
+     */
     @JsonProperty("hctl")
     public String getHctl() {
         return hctl;
     }
 
+    /**
+     * A SCSI bus address like 0:0:0:0. The hint must match the actual value exactly.
+     */
     @JsonProperty("hctl")
     public void setHctl(String hctl) {
         this.hctl = hctl;
     }
 
+    /**
+     * The minimum size of the device in Gigabytes.
+     */
     @JsonProperty("minSizeGigabytes")
     public Integer getMinSizeGigabytes() {
         return minSizeGigabytes;
     }
 
+    /**
+     * The minimum size of the device in Gigabytes.
+     */
     @JsonProperty("minSizeGigabytes")
     public void setMinSizeGigabytes(Integer minSizeGigabytes) {
         this.minSizeGigabytes = minSizeGigabytes;
     }
 
+    /**
+     * A vendor-specific device identifier. The hint can be a substring of the actual value.
+     */
     @JsonProperty("model")
     public String getModel() {
         return model;
     }
 
+    /**
+     * A vendor-specific device identifier. The hint can be a substring of the actual value.
+     */
     @JsonProperty("model")
     public void setModel(String model) {
         this.model = model;
     }
 
+    /**
+     * True if the device should use spinning media, false otherwise.
+     */
     @JsonProperty("rotational")
     public Boolean getRotational() {
         return rotational;
     }
 
+    /**
+     * True if the device should use spinning media, false otherwise.
+     */
     @JsonProperty("rotational")
     public void setRotational(Boolean rotational) {
         this.rotational = rotational;
     }
 
+    /**
+     * Device serial number. The hint must match the actual value exactly.
+     */
     @JsonProperty("serialNumber")
     public String getSerialNumber() {
         return serialNumber;
     }
 
+    /**
+     * Device serial number. The hint must match the actual value exactly.
+     */
     @JsonProperty("serialNumber")
     public void setSerialNumber(String serialNumber) {
         this.serialNumber = serialNumber;
     }
 
+    /**
+     * The name of the vendor or manufacturer of the device. The hint can be a substring of the actual value.
+     */
     @JsonProperty("vendor")
     public String getVendor() {
         return vendor;
     }
 
+    /**
+     * The name of the vendor or manufacturer of the device. The hint can be a substring of the actual value.
+     */
     @JsonProperty("vendor")
     public void setVendor(String vendor) {
         this.vendor = vendor;
     }
 
+    /**
+     * Unique storage identifier. The hint must match the actual value exactly.
+     */
     @JsonProperty("wwn")
     public String getWwn() {
         return wwn;
     }
 
+    /**
+     * Unique storage identifier. The hint must match the actual value exactly.
+     */
     @JsonProperty("wwn")
     public void setWwn(String wwn) {
         this.wwn = wwn;
     }
 
+    /**
+     * Unique vendor storage identifier. The hint must match the actual value exactly.
+     */
     @JsonProperty("wwnVendorExtension")
     public String getWwnVendorExtension() {
         return wwnVendorExtension;
     }
 
+    /**
+     * Unique vendor storage identifier. The hint must match the actual value exactly.
+     */
     @JsonProperty("wwnVendorExtension")
     public void setWwnVendorExtension(String wwnVendorExtension) {
         this.wwnVendorExtension = wwnVendorExtension;
     }
 
+    /**
+     * Unique storage identifier with the vendor extension appended. The hint must match the actual value exactly.
+     */
     @JsonProperty("wwnWithExtension")
     public String getWwnWithExtension() {
         return wwnWithExtension;
     }
 
+    /**
+     * Unique storage identifier with the vendor extension appended. The hint must match the actual value exactly.
+     */
     @JsonProperty("wwnWithExtension")
     public void setWwnWithExtension(String wwnWithExtension) {
         this.wwnWithExtension = wwnWithExtension;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/SchemaReference.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/SchemaReference.java
index 063d7572edb..2622321a9ce 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/SchemaReference.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/SchemaReference.java
@@ -82,21 +82,33 @@ public SchemaReference(String name, String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * `name` is the reference to the schema.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * `name` is the reference to the schema.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * `namespace` is the namespace of the where the schema is stored.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * `namespace` is the namespace of the where the schema is stored.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/SettingSchema.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/SettingSchema.java
index 3b40c98fbe3..ac1eb4b7711 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/SettingSchema.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/SettingSchema.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Additional data describing the firmware setting.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -109,82 +112,130 @@ public SettingSchema(List<String> allowableValues, String attributeType, Integer
         this.upperBound = upperBound;
     }
 
+    /**
+     * The allowable value for an Enumeration type setting.
+     */
     @JsonProperty("allowable_values")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAllowableValues() {
         return allowableValues;
     }
 
+    /**
+     * The allowable value for an Enumeration type setting.
+     */
     @JsonProperty("allowable_values")
     public void setAllowableValues(List<String> allowableValues) {
         this.allowableValues = allowableValues;
     }
 
+    /**
+     * The type of setting.
+     */
     @JsonProperty("attribute_type")
     public String getAttributeType() {
         return attributeType;
     }
 
+    /**
+     * The type of setting.
+     */
     @JsonProperty("attribute_type")
     public void setAttributeType(String attributeType) {
         this.attributeType = attributeType;
     }
 
+    /**
+     * The lowest value for an Integer type setting.
+     */
     @JsonProperty("lower_bound")
     public Integer getLowerBound() {
         return lowerBound;
     }
 
+    /**
+     * The lowest value for an Integer type setting.
+     */
     @JsonProperty("lower_bound")
     public void setLowerBound(Integer lowerBound) {
         this.lowerBound = lowerBound;
     }
 
+    /**
+     * Maximum length for a String type setting.
+     */
     @JsonProperty("max_length")
     public Integer getMaxLength() {
         return maxLength;
     }
 
+    /**
+     * Maximum length for a String type setting.
+     */
     @JsonProperty("max_length")
     public void setMaxLength(Integer maxLength) {
         this.maxLength = maxLength;
     }
 
+    /**
+     * Minimum length for a String type setting.
+     */
     @JsonProperty("min_length")
     public Integer getMinLength() {
         return minLength;
     }
 
+    /**
+     * Minimum length for a String type setting.
+     */
     @JsonProperty("min_length")
     public void setMinLength(Integer minLength) {
         this.minLength = minLength;
     }
 
+    /**
+     * Whether or not this setting is read only.
+     */
     @JsonProperty("read_only")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * Whether or not this setting is read only.
+     */
     @JsonProperty("read_only")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * Whether or not this setting's value is unique to this node, e.g. a serial number.
+     */
     @JsonProperty("unique")
     public Boolean getUnique() {
         return unique;
     }
 
+    /**
+     * Whether or not this setting's value is unique to this node, e.g. a serial number.
+     */
     @JsonProperty("unique")
     public void setUnique(Boolean unique) {
         this.unique = unique;
     }
 
+    /**
+     * The highest value for an Integer type setting.
+     */
     @JsonProperty("upper_bound")
     public Integer getUpperBound() {
         return upperBound;
     }
 
+    /**
+     * The highest value for an Integer type setting.
+     */
     @JsonProperty("upper_bound")
     public void setUpperBound(Integer upperBound) {
         this.upperBound = upperBound;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/SoftwareRAIDVolume.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/SoftwareRAIDVolume.java
index cdb3bb519d9..75b6e72facb 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/SoftwareRAIDVolume.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/SoftwareRAIDVolume.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SoftwareRAIDVolume defines the desired configuration of volume in software RAID.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public SoftwareRAIDVolume(String level, List<RootDeviceHints> physicalDisks, Int
         this.sizeGibibytes = sizeGibibytes;
     }
 
+    /**
+     * RAID level for the logical disk. The following levels are supported: 0, 1 and 1+0.
+     */
     @JsonProperty("level")
     public String getLevel() {
         return level;
     }
 
+    /**
+     * RAID level for the logical disk. The following levels are supported: 0, 1 and 1+0.
+     */
     @JsonProperty("level")
     public void setLevel(String level) {
         this.level = level;
     }
 
+    /**
+     * A list of device hints, the number of items should be greater than or equal to 2.
+     */
     @JsonProperty("physicalDisks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RootDeviceHints> getPhysicalDisks() {
         return physicalDisks;
     }
 
+    /**
+     * A list of device hints, the number of items should be greater than or equal to 2.
+     */
     @JsonProperty("physicalDisks")
     public void setPhysicalDisks(List<RootDeviceHints> physicalDisks) {
         this.physicalDisks = physicalDisks;
     }
 
+    /**
+     * Size of the logical disk to be created in GiB. If unspecified or set be 0, the maximum capacity of disk will be used for logical disk.
+     */
     @JsonProperty("sizeGibibytes")
     public Integer getSizeGibibytes() {
         return sizeGibibytes;
     }
 
+    /**
+     * Size of the logical disk to be created in GiB. If unspecified or set be 0, the maximum capacity of disk will be used for logical disk.
+     */
     @JsonProperty("sizeGibibytes")
     public void setSizeGibibytes(Integer sizeGibibytes) {
         this.sizeGibibytes = sizeGibibytes;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/Storage.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/Storage.java
index c7dbd741f4b..7415881daf1 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/Storage.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/Storage.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Storage describes one storage device (disk, SSD, etc.) on the host.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -125,122 +128,194 @@ public Storage(List<String> alternateNames, String hctl, String model, String na
         this.wwnWithExtension = wwnWithExtension;
     }
 
+    /**
+     * A list of alternate Linux device names of the disk, e.g. "/dev/sda". Note that this list is not exhaustive, and names may not be stable across reboots.
+     */
     @JsonProperty("alternateNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAlternateNames() {
         return alternateNames;
     }
 
+    /**
+     * A list of alternate Linux device names of the disk, e.g. "/dev/sda". Note that this list is not exhaustive, and names may not be stable across reboots.
+     */
     @JsonProperty("alternateNames")
     public void setAlternateNames(List<String> alternateNames) {
         this.alternateNames = alternateNames;
     }
 
+    /**
+     * The SCSI location of the device
+     */
     @JsonProperty("hctl")
     public String getHctl() {
         return hctl;
     }
 
+    /**
+     * The SCSI location of the device
+     */
     @JsonProperty("hctl")
     public void setHctl(String hctl) {
         this.hctl = hctl;
     }
 
+    /**
+     * Hardware model
+     */
     @JsonProperty("model")
     public String getModel() {
         return model;
     }
 
+    /**
+     * Hardware model
+     */
     @JsonProperty("model")
     public void setModel(String model) {
         this.model = model;
     }
 
+    /**
+     * A Linux device name of the disk, e.g. "/dev/disk/by-path/pci-0000:01:00.0-scsi-0:2:0:0". This will be a name that is stable across reboots if one is available.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * A Linux device name of the disk, e.g. "/dev/disk/by-path/pci-0000:01:00.0-scsi-0:2:0:0". This will be a name that is stable across reboots if one is available.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Whether this disk represents rotational storage. This field is not recommended for usage, please prefer using 'Type' field instead, this field will be deprecated eventually.
+     */
     @JsonProperty("rotational")
     public Boolean getRotational() {
         return rotational;
     }
 
+    /**
+     * Whether this disk represents rotational storage. This field is not recommended for usage, please prefer using 'Type' field instead, this field will be deprecated eventually.
+     */
     @JsonProperty("rotational")
     public void setRotational(Boolean rotational) {
         this.rotational = rotational;
     }
 
+    /**
+     * The serial number of the device
+     */
     @JsonProperty("serialNumber")
     public String getSerialNumber() {
         return serialNumber;
     }
 
+    /**
+     * The serial number of the device
+     */
     @JsonProperty("serialNumber")
     public void setSerialNumber(String serialNumber) {
         this.serialNumber = serialNumber;
     }
 
+    /**
+     * The size of the disk in Bytes
+     */
     @JsonProperty("sizeBytes")
     public Long getSizeBytes() {
         return sizeBytes;
     }
 
+    /**
+     * The size of the disk in Bytes
+     */
     @JsonProperty("sizeBytes")
     public void setSizeBytes(Long sizeBytes) {
         this.sizeBytes = sizeBytes;
     }
 
+    /**
+     * Device type, one of: HDD, SSD, NVME.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Device type, one of: HDD, SSD, NVME.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * The name of the vendor of the device
+     */
     @JsonProperty("vendor")
     public String getVendor() {
         return vendor;
     }
 
+    /**
+     * The name of the vendor of the device
+     */
     @JsonProperty("vendor")
     public void setVendor(String vendor) {
         this.vendor = vendor;
     }
 
+    /**
+     * The WWN of the device
+     */
     @JsonProperty("wwn")
     public String getWwn() {
         return wwn;
     }
 
+    /**
+     * The WWN of the device
+     */
     @JsonProperty("wwn")
     public void setWwn(String wwn) {
         this.wwn = wwn;
     }
 
+    /**
+     * The WWN Vendor extension of the device
+     */
     @JsonProperty("wwnVendorExtension")
     public String getWwnVendorExtension() {
         return wwnVendorExtension;
     }
 
+    /**
+     * The WWN Vendor extension of the device
+     */
     @JsonProperty("wwnVendorExtension")
     public void setWwnVendorExtension(String wwnVendorExtension) {
         this.wwnVendorExtension = wwnVendorExtension;
     }
 
+    /**
+     * The WWN with the extension
+     */
     @JsonProperty("wwnWithExtension")
     public String getWwnWithExtension() {
         return wwnWithExtension;
     }
 
+    /**
+     * The WWN with the extension
+     */
     @JsonProperty("wwnWithExtension")
     public void setWwnWithExtension(String wwnWithExtension) {
         this.wwnWithExtension = wwnWithExtension;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/VLAN.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/VLAN.java
index 6e728ee60a1..8630a1e69ba 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/VLAN.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1alpha1/VLAN.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VLAN represents the name and ID of a VLAN.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public VLAN(Integer id, String name) {
         this.name = name;
     }
 
+    /**
+     * VLAN represents the name and ID of a VLAN.
+     */
     @JsonProperty("id")
     public Integer getId() {
         return id;
     }
 
+    /**
+     * VLAN represents the name and ID of a VLAN.
+     */
     @JsonProperty("id")
     public void setId(Integer id) {
         this.id = id;
     }
 
+    /**
+     * VLAN represents the name and ID of a VLAN.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * VLAN represents the name and ID of a VLAN.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/APIEndpoint.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/APIEndpoint.java
index e5aed437389..8e4513e51b1 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/APIEndpoint.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/APIEndpoint.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * APIEndpoint represents a reachable Kubernetes API endpoint.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public APIEndpoint(String host, Integer port) {
         this.port = port;
     }
 
+    /**
+     * Host is the hostname on which the API server is serving.
+     */
     @JsonProperty("host")
     public String getHost() {
         return host;
     }
 
+    /**
+     * Host is the hostname on which the API server is serving.
+     */
     @JsonProperty("host")
     public void setHost(String host) {
         this.host = host;
     }
 
+    /**
+     * Port is the port on which the API server is serving.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * Port is the port on which the API server is serving.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/CustomDeploy.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/CustomDeploy.java
index 065437d94f4..42369300cb3 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/CustomDeploy.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/CustomDeploy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Custom deploy is a description of a customized deploy process.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public CustomDeploy(String method) {
         this.method = method;
     }
 
+    /**
+     * Custom deploy method name. This name is specific to the deploy ramdisk used. If you don't have a custom deploy ramdisk, you shouldn't use CustomDeploy.
+     */
     @JsonProperty("method")
     public String getMethod() {
         return method;
     }
 
+    /**
+     * Custom deploy method name. This name is specific to the deploy ramdisk used. If you don't have a custom deploy ramdisk, you shouldn't use CustomDeploy.
+     */
     @JsonProperty("method")
     public void setMethod(String method) {
         this.method = method;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/FromPool.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/FromPool.java
index 97880150dd7..0b339806f57 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/FromPool.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/FromPool.java
@@ -90,41 +90,65 @@ public FromPool(String apiGroup, String key, String kind, String name) {
         this.name = name;
     }
 
+    /**
+     * APIGroup is the api group of the IP pool.
+     */
     @JsonProperty("apiGroup")
     public String getApiGroup() {
         return apiGroup;
     }
 
+    /**
+     * APIGroup is the api group of the IP pool.
+     */
     @JsonProperty("apiGroup")
     public void setApiGroup(String apiGroup) {
         this.apiGroup = apiGroup;
     }
 
+    /**
+     * Key will be used as the key to set in the metadata map for cloud-init
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * Key will be used as the key to set in the metadata map for cloud-init
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * Kind is the kind of the IP pool
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind is the kind of the IP pool
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name is the name of the IP pool used to fetch the value to set in the metadata map for cloud-init
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the IP pool used to fetch the value to set in the metadata map for cloud-init
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/HostSelector.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/HostSelector.java
index f677e63a7c0..594040b5211 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/HostSelector.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/HostSelector.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HostSelector specifies matching criteria for labels on BareMetalHosts. This is used to limit the set of BareMetalHost objects considered for claiming for a Machine.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public HostSelector(List<HostSelectorRequirement> matchExpressions, Map<String,
         this.matchLabels = matchLabels;
     }
 
+    /**
+     * Label match expressions that must be true on a chosen BareMetalHost
+     */
     @JsonProperty("matchExpressions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HostSelectorRequirement> getMatchExpressions() {
         return matchExpressions;
     }
 
+    /**
+     * Label match expressions that must be true on a chosen BareMetalHost
+     */
     @JsonProperty("matchExpressions")
     public void setMatchExpressions(List<HostSelectorRequirement> matchExpressions) {
         this.matchExpressions = matchExpressions;
     }
 
+    /**
+     * Key/value pairs of labels that must exist on a chosen BareMetalHost
+     */
     @JsonProperty("matchLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getMatchLabels() {
         return matchLabels;
     }
 
+    /**
+     * Key/value pairs of labels that must exist on a chosen BareMetalHost
+     */
     @JsonProperty("matchLabels")
     public void setMatchLabels(Map<String, String> matchLabels) {
         this.matchLabels = matchLabels;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Image.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Image.java
index 4732d24bb7b..aa8321ae44f 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Image.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Image.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Image holds the details of an image to use during provisioning.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public Image(String checksum, String checksumType, String format, String url) {
         this.url = url;
     }
 
+    /**
+     * Checksum is a md5sum, sha256sum or sha512sum value or a URL to retrieve one.
+     */
     @JsonProperty("checksum")
     public String getChecksum() {
         return checksum;
     }
 
+    /**
+     * Checksum is a md5sum, sha256sum or sha512sum value or a URL to retrieve one.
+     */
     @JsonProperty("checksum")
     public void setChecksum(String checksum) {
         this.checksum = checksum;
     }
 
+    /**
+     * ChecksumType is the checksum algorithm for the image. e.g md5, sha256, sha512
+     */
     @JsonProperty("checksumType")
     public String getChecksumType() {
         return checksumType;
     }
 
+    /**
+     * ChecksumType is the checksum algorithm for the image. e.g md5, sha256, sha512
+     */
     @JsonProperty("checksumType")
     public void setChecksumType(String checksumType) {
         this.checksumType = checksumType;
     }
 
+    /**
+     * DiskFormat contains the image disk format.
+     */
     @JsonProperty("format")
     public String getFormat() {
         return format;
     }
 
+    /**
+     * DiskFormat contains the image disk format.
+     */
     @JsonProperty("format")
     public void setFormat(String format) {
         this.format = format;
     }
 
+    /**
+     * URL is a location of an image to deploy.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * URL is a location of an image to deploy.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaData.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaData.java
index 2121847ce03..c89855220f5 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaData.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaData.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MetaData represents a keyand value of the metadata.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -131,122 +134,188 @@ public MetaData(List<FromPool> dnsServersFromIPPool, List<MetaDataFromAnnotation
         this.strings = strings;
     }
 
+    /**
+     * DNSServersFromPool is the list of metadata items to be rendered as dns servers.
+     */
     @JsonProperty("dnsServersFromIPPool")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<FromPool> getDnsServersFromIPPool() {
         return dnsServersFromIPPool;
     }
 
+    /**
+     * DNSServersFromPool is the list of metadata items to be rendered as dns servers.
+     */
     @JsonProperty("dnsServersFromIPPool")
     public void setDnsServersFromIPPool(List<FromPool> dnsServersFromIPPool) {
         this.dnsServersFromIPPool = dnsServersFromIPPool;
     }
 
+    /**
+     * FromAnnotations is the list of metadata items to be fetched from object Annotations
+     */
     @JsonProperty("fromAnnotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MetaDataFromAnnotation> getFromAnnotations() {
         return fromAnnotations;
     }
 
+    /**
+     * FromAnnotations is the list of metadata items to be fetched from object Annotations
+     */
     @JsonProperty("fromAnnotations")
     public void setFromAnnotations(List<MetaDataFromAnnotation> fromAnnotations) {
         this.fromAnnotations = fromAnnotations;
     }
 
+    /**
+     * FromHostInterfaces is the list of metadata items to be rendered as MAC addresses of the host interfaces.
+     */
     @JsonProperty("fromHostInterfaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MetaDataHostInterface> getFromHostInterfaces() {
         return fromHostInterfaces;
     }
 
+    /**
+     * FromHostInterfaces is the list of metadata items to be rendered as MAC addresses of the host interfaces.
+     */
     @JsonProperty("fromHostInterfaces")
     public void setFromHostInterfaces(List<MetaDataHostInterface> fromHostInterfaces) {
         this.fromHostInterfaces = fromHostInterfaces;
     }
 
+    /**
+     * FromLabels is the list of metadata items to be fetched from object labels
+     */
     @JsonProperty("fromLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MetaDataFromLabel> getFromLabels() {
         return fromLabels;
     }
 
+    /**
+     * FromLabels is the list of metadata items to be fetched from object labels
+     */
     @JsonProperty("fromLabels")
     public void setFromLabels(List<MetaDataFromLabel> fromLabels) {
         this.fromLabels = fromLabels;
     }
 
+    /**
+     * GatewaysFromPool is the list of metadata items to be rendered as gateway addresses.
+     */
     @JsonProperty("gatewaysFromIPPool")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<FromPool> getGatewaysFromIPPool() {
         return gatewaysFromIPPool;
     }
 
+    /**
+     * GatewaysFromPool is the list of metadata items to be rendered as gateway addresses.
+     */
     @JsonProperty("gatewaysFromIPPool")
     public void setGatewaysFromIPPool(List<FromPool> gatewaysFromIPPool) {
         this.gatewaysFromIPPool = gatewaysFromIPPool;
     }
 
+    /**
+     * Indexes is the list of metadata items to be rendered from the index of the Metal3Data
+     */
     @JsonProperty("indexes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MetaDataIndex> getIndexes() {
         return indexes;
     }
 
+    /**
+     * Indexes is the list of metadata items to be rendered from the index of the Metal3Data
+     */
     @JsonProperty("indexes")
     public void setIndexes(List<MetaDataIndex> indexes) {
         this.indexes = indexes;
     }
 
+    /**
+     * IPAddressesFromPool is the list of metadata items to be rendered as ip addresses.
+     */
     @JsonProperty("ipAddressesFromIPPool")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<FromPool> getIpAddressesFromIPPool() {
         return ipAddressesFromIPPool;
     }
 
+    /**
+     * IPAddressesFromPool is the list of metadata items to be rendered as ip addresses.
+     */
     @JsonProperty("ipAddressesFromIPPool")
     public void setIpAddressesFromIPPool(List<FromPool> ipAddressesFromIPPool) {
         this.ipAddressesFromIPPool = ipAddressesFromIPPool;
     }
 
+    /**
+     * Namespaces is the list of metadata items to be rendered from the namespace
+     */
     @JsonProperty("namespaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MetaDataNamespace> getNamespaces() {
         return namespaces;
     }
 
+    /**
+     * Namespaces is the list of metadata items to be rendered from the namespace
+     */
     @JsonProperty("namespaces")
     public void setNamespaces(List<MetaDataNamespace> namespaces) {
         this.namespaces = namespaces;
     }
 
+    /**
+     * ObjectNames is the list of metadata items to be rendered from the name of objects.
+     */
     @JsonProperty("objectNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MetaDataObjectName> getObjectNames() {
         return objectNames;
     }
 
+    /**
+     * ObjectNames is the list of metadata items to be rendered from the name of objects.
+     */
     @JsonProperty("objectNames")
     public void setObjectNames(List<MetaDataObjectName> objectNames) {
         this.objectNames = objectNames;
     }
 
+    /**
+     * PrefixesFromPool is the list of metadata items to be rendered as network prefixes.
+     */
     @JsonProperty("prefixesFromIPPool")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<FromPool> getPrefixesFromIPPool() {
         return prefixesFromIPPool;
     }
 
+    /**
+     * PrefixesFromPool is the list of metadata items to be rendered as network prefixes.
+     */
     @JsonProperty("prefixesFromIPPool")
     public void setPrefixesFromIPPool(List<FromPool> prefixesFromIPPool) {
         this.prefixesFromIPPool = prefixesFromIPPool;
     }
 
+    /**
+     * Strings is the list of metadata items to be rendered from strings
+     */
     @JsonProperty("strings")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MetaDataString> getStrings() {
         return strings;
     }
 
+    /**
+     * Strings is the list of metadata items to be rendered from strings
+     */
     @JsonProperty("strings")
     public void setStrings(List<MetaDataString> strings) {
         this.strings = strings;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataFromAnnotation.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataFromAnnotation.java
index e68ff70f56b..6e002291a53 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataFromAnnotation.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataFromAnnotation.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MetaDataFromAnnotation contains the information to fetch an annotation content, if the label does not exist, it is rendered as empty string.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public MetaDataFromAnnotation(String annotation, String key, String object) {
         this.object = object;
     }
 
+    /**
+     * Annotation is the key of the Annotation to fetch
+     */
     @JsonProperty("annotation")
     public String getAnnotation() {
         return annotation;
     }
 
+    /**
+     * Annotation is the key of the Annotation to fetch
+     */
     @JsonProperty("annotation")
     public void setAnnotation(String annotation) {
         this.annotation = annotation;
     }
 
+    /**
+     * Key will be used as the key to set in the metadata map for cloud-init
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * Key will be used as the key to set in the metadata map for cloud-init
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * Object is the type of the object from which we retrieve the name
+     */
     @JsonProperty("object")
     public String getObject() {
         return object;
     }
 
+    /**
+     * Object is the type of the object from which we retrieve the name
+     */
     @JsonProperty("object")
     public void setObject(String object) {
         this.object = object;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataFromLabel.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataFromLabel.java
index 02859e49aec..f38f0d09a74 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataFromLabel.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataFromLabel.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MetaDataFromLabel contains the information to fetch a label content, if the label does not exist, it is rendered as empty string.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public MetaDataFromLabel(String key, String label, String object) {
         this.object = object;
     }
 
+    /**
+     * Key will be used as the key to set in the metadata map for cloud-init
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * Key will be used as the key to set in the metadata map for cloud-init
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * Label is the key of the label to fetch
+     */
     @JsonProperty("label")
     public String getLabel() {
         return label;
     }
 
+    /**
+     * Label is the key of the label to fetch
+     */
     @JsonProperty("label")
     public void setLabel(String label) {
         this.label = label;
     }
 
+    /**
+     * Object is the type of the object from which we retrieve the name
+     */
     @JsonProperty("object")
     public String getObject() {
         return object;
     }
 
+    /**
+     * Object is the type of the object from which we retrieve the name
+     */
     @JsonProperty("object")
     public void setObject(String object) {
         this.object = object;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataHostInterface.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataHostInterface.java
index 150c7733874..ba9fb952f72 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataHostInterface.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataHostInterface.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MetaDataHostInterface contains the information to render the object name.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public MetaDataHostInterface(String _interface, String key) {
         this.key = key;
     }
 
+    /**
+     * Interface is the name of the interface in the BareMetalHost Status Hardware Details list of interfaces from which to fetch the MAC address.
+     */
     @JsonProperty("interface")
     public String getInterface() {
         return _interface;
     }
 
+    /**
+     * Interface is the name of the interface in the BareMetalHost Status Hardware Details list of interfaces from which to fetch the MAC address.
+     */
     @JsonProperty("interface")
     public void setInterface(String _interface) {
         this._interface = _interface;
     }
 
+    /**
+     * Key will be used as the key to set in the metadata map for cloud-init
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * Key will be used as the key to set in the metadata map for cloud-init
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataIPAddress.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataIPAddress.java
index 9313381ad85..dbd34e98ad8 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataIPAddress.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataIPAddress.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MetaDataIPAddress contains the info to render th ip address. It is IP-version agnostic.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public MetaDataIPAddress(String end, String key, String start, Integer step, Str
         this.subnet = subnet;
     }
 
+    /**
+     * End is the last IP address that can be rendered. It is used as a validation that the rendered IP is in bound.
+     */
     @JsonProperty("end")
     public String getEnd() {
         return end;
     }
 
+    /**
+     * End is the last IP address that can be rendered. It is used as a validation that the rendered IP is in bound.
+     */
     @JsonProperty("end")
     public void setEnd(String end) {
         this.end = end;
     }
 
+    /**
+     * Key will be used as the key to set in the metadata map for cloud-init
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * Key will be used as the key to set in the metadata map for cloud-init
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * Start is the first ip address that can be rendered
+     */
     @JsonProperty("start")
     public String getStart() {
         return start;
     }
 
+    /**
+     * Start is the first ip address that can be rendered
+     */
     @JsonProperty("start")
     public void setStart(String start) {
         this.start = start;
     }
 
+    /**
+     * Step is the step between the IP addresses rendered.
+     */
     @JsonProperty("step")
     public Integer getStep() {
         return step;
     }
 
+    /**
+     * Step is the step between the IP addresses rendered.
+     */
     @JsonProperty("step")
     public void setStep(Integer step) {
         this.step = step;
     }
 
+    /**
+     * Subnet is used to validate that the rendered IP is in bounds. In case the Start value is not given, it is derived from the subnet ip incremented by 1 (`192.168.0.1` for `192.168.0.0/24`)
+     */
     @JsonProperty("subnet")
     public String getSubnet() {
         return subnet;
     }
 
+    /**
+     * Subnet is used to validate that the rendered IP is in bounds. In case the Start value is not given, it is derived from the subnet ip incremented by 1 (`192.168.0.1` for `192.168.0.0/24`)
+     */
     @JsonProperty("subnet")
     public void setSubnet(String subnet) {
         this.subnet = subnet;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataIndex.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataIndex.java
index d52d4ff0136..e24a928a331 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataIndex.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataIndex.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MetaDataIndex contains the information to render the index.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public MetaDataIndex(String key, Integer offset, String prefix, Integer step, St
         this.suffix = suffix;
     }
 
+    /**
+     * Key will be used as the key to set in the metadata map for cloud-init
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * Key will be used as the key to set in the metadata map for cloud-init
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * Offset is the offset to apply to the index when rendering it
+     */
     @JsonProperty("offset")
     public Integer getOffset() {
         return offset;
     }
 
+    /**
+     * Offset is the offset to apply to the index when rendering it
+     */
     @JsonProperty("offset")
     public void setOffset(Integer offset) {
         this.offset = offset;
     }
 
+    /**
+     * Prefix is the prefix string
+     */
     @JsonProperty("prefix")
     public String getPrefix() {
         return prefix;
     }
 
+    /**
+     * Prefix is the prefix string
+     */
     @JsonProperty("prefix")
     public void setPrefix(String prefix) {
         this.prefix = prefix;
     }
 
+    /**
+     * Step is the multiplier of the index
+     */
     @JsonProperty("step")
     public Integer getStep() {
         return step;
     }
 
+    /**
+     * Step is the multiplier of the index
+     */
     @JsonProperty("step")
     public void setStep(Integer step) {
         this.step = step;
     }
 
+    /**
+     * Suffix is the suffix string
+     */
     @JsonProperty("suffix")
     public String getSuffix() {
         return suffix;
     }
 
+    /**
+     * Suffix is the suffix string
+     */
     @JsonProperty("suffix")
     public void setSuffix(String suffix) {
         this.suffix = suffix;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataNamespace.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataNamespace.java
index 37f4b42408c..427f246ecdc 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataNamespace.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataNamespace.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MetaDataNamespace contains the information to render the namespace.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public MetaDataNamespace(String key) {
         this.key = key;
     }
 
+    /**
+     * Key will be used as the key to set in the metadata map for cloud-init
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * Key will be used as the key to set in the metadata map for cloud-init
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataObjectName.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataObjectName.java
index 5be917d0630..4f6fce5edea 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataObjectName.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataObjectName.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MetaDataObjectName contains the information to render the object name.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public MetaDataObjectName(String key, String object) {
         this.object = object;
     }
 
+    /**
+     * Key will be used as the key to set in the metadata map for cloud-init
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * Key will be used as the key to set in the metadata map for cloud-init
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * Object is the type of the object from which we retrieve the name
+     */
     @JsonProperty("object")
     public String getObject() {
         return object;
     }
 
+    /**
+     * Object is the type of the object from which we retrieve the name
+     */
     @JsonProperty("object")
     public void setObject(String object) {
         this.object = object;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataString.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataString.java
index e0d2edb4e30..69d7cb8d521 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataString.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/MetaDataString.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MetaDataString contains the information to render the string.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public MetaDataString(String key, String value) {
         this.value = value;
     }
 
+    /**
+     * Key will be used as the key to set in the metadata map for cloud-init
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * Key will be used as the key to set in the metadata map for cloud-init
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * Value is the string to render.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is the string to render.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3Cluster.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3Cluster.java
index 5f09a0a7b81..5e7eb8aafc8 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3Cluster.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3Cluster.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3Cluster is the Schema for the metal3clusters API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Metal3Cluster implements Editable<Metal3ClusterBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "infrastructure.cluster.x-k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Metal3Cluster";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Metal3Cluster(String apiVersion, String kind, ObjectMeta metadata, Metal3
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Metal3Cluster is the Schema for the metal3clusters API.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Metal3Cluster is the Schema for the metal3clusters API.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Metal3Cluster is the Schema for the metal3clusters API.
+     */
     @JsonProperty("spec")
     public Metal3ClusterSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Metal3Cluster is the Schema for the metal3clusters API.
+     */
     @JsonProperty("spec")
     public void setSpec(Metal3ClusterSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Metal3Cluster is the Schema for the metal3clusters API.
+     */
     @JsonProperty("status")
     public Metal3ClusterStatus getStatus() {
         return status;
     }
 
+    /**
+     * Metal3Cluster is the Schema for the metal3clusters API.
+     */
     @JsonProperty("status")
     public void setStatus(Metal3ClusterStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3ClusterList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3ClusterList.java
index c6dc080b3cf..b4304f89942 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3ClusterList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3ClusterList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3ClusterList contains a list of Metal3Cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class Metal3ClusterList implements Editable<Metal3ClusterListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3Cluster>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "infrastructure.cluster.x-k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3Cluster> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Metal3ClusterList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Metal3ClusterList(String apiVersion, List<io.fabric8.openshift.api.model.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Metal3ClusterList contains a list of Metal3Cluster.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3Cluster> getItems() {
         return items;
     }
 
+    /**
+     * Metal3ClusterList contains a list of Metal3Cluster.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3Cluster> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Metal3ClusterList contains a list of Metal3Cluster.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Metal3ClusterList contains a list of Metal3Cluster.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3ClusterSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3ClusterSpec.java
index 962fcc2f6e8..098cf5d3174 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3ClusterSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3ClusterSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3ClusterSpec defines the desired state of Metal3Cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Metal3ClusterSpec(APIEndpoint controlPlaneEndpoint, Boolean noCloudProvid
         this.noCloudProvider = noCloudProvider;
     }
 
+    /**
+     * Metal3ClusterSpec defines the desired state of Metal3Cluster.
+     */
     @JsonProperty("controlPlaneEndpoint")
     public APIEndpoint getControlPlaneEndpoint() {
         return controlPlaneEndpoint;
     }
 
+    /**
+     * Metal3ClusterSpec defines the desired state of Metal3Cluster.
+     */
     @JsonProperty("controlPlaneEndpoint")
     public void setControlPlaneEndpoint(APIEndpoint controlPlaneEndpoint) {
         this.controlPlaneEndpoint = controlPlaneEndpoint;
     }
 
+    /**
+     * Determines if the cluster is not to be deployed with an external cloud provider. If set to true, CAPM3 will use node labels to set providerID on the kubernetes nodes. If set to false, providerID is set on nodes by other entities and CAPM3 uses the value of the providerID on the m3m resource.
+     */
     @JsonProperty("noCloudProvider")
     public Boolean getNoCloudProvider() {
         return noCloudProvider;
     }
 
+    /**
+     * Determines if the cluster is not to be deployed with an external cloud provider. If set to true, CAPM3 will use node labels to set providerID on the kubernetes nodes. If set to false, providerID is set on nodes by other entities and CAPM3 uses the value of the providerID on the m3m resource.
+     */
     @JsonProperty("noCloudProvider")
     public void setNoCloudProvider(Boolean noCloudProvider) {
         this.noCloudProvider = noCloudProvider;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3ClusterStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3ClusterStatus.java
index f1e31520582..c213cf271dc 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3ClusterStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3ClusterStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3ClusterStatus defines the observed state of Metal3Cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,52 +101,82 @@ public Metal3ClusterStatus(List<Condition> conditions, String failureMessage, St
         this.ready = ready;
     }
 
+    /**
+     * Conditions defines current service state of the Metal3Cluster.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions defines current service state of the Metal3Cluster.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * FailureMessage indicates that there is a fatal problem reconciling the state, and will be set to a descriptive error message.
+     */
     @JsonProperty("failureMessage")
     public String getFailureMessage() {
         return failureMessage;
     }
 
+    /**
+     * FailureMessage indicates that there is a fatal problem reconciling the state, and will be set to a descriptive error message.
+     */
     @JsonProperty("failureMessage")
     public void setFailureMessage(String failureMessage) {
         this.failureMessage = failureMessage;
     }
 
+    /**
+     * FailureReason indicates that there is a fatal problem reconciling the state, and will be set to a token value suitable for programmatic interpretation.
+     */
     @JsonProperty("failureReason")
     public String getFailureReason() {
         return failureReason;
     }
 
+    /**
+     * FailureReason indicates that there is a fatal problem reconciling the state, and will be set to a token value suitable for programmatic interpretation.
+     */
     @JsonProperty("failureReason")
     public void setFailureReason(String failureReason) {
         this.failureReason = failureReason;
     }
 
+    /**
+     * Metal3ClusterStatus defines the observed state of Metal3Cluster.
+     */
     @JsonProperty("lastUpdated")
     public String getLastUpdated() {
         return lastUpdated;
     }
 
+    /**
+     * Metal3ClusterStatus defines the observed state of Metal3Cluster.
+     */
     @JsonProperty("lastUpdated")
     public void setLastUpdated(String lastUpdated) {
         this.lastUpdated = lastUpdated;
     }
 
+    /**
+     * Ready denotes that the Metal3 cluster (infrastructure) is ready. In Baremetal case, it does not mean anything for now as no infrastructure steps need to be performed. Required by Cluster API. Set to True by the metal3Cluster controller after creation.
+     */
     @JsonProperty("ready")
     public Boolean getReady() {
         return ready;
     }
 
+    /**
+     * Ready denotes that the Metal3 cluster (infrastructure) is ready. In Baremetal case, it does not mean anything for now as no infrastructure steps need to be performed. Required by Cluster API. Set to True by the metal3Cluster controller after creation.
+     */
     @JsonProperty("ready")
     public void setReady(Boolean ready) {
         this.ready = ready;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3ClusterTemplate.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3ClusterTemplate.java
index 03f628634fe..0cbe83acf18 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3ClusterTemplate.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3ClusterTemplate.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3ClusterTemplate is the Schema for the metal3clustertemplates API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Metal3ClusterTemplate implements Editable<Metal3ClusterTemplateBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "infrastructure.cluster.x-k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Metal3ClusterTemplate";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public Metal3ClusterTemplate(String apiVersion, String kind, ObjectMeta metadata
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Metal3ClusterTemplate is the Schema for the metal3clustertemplates API.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Metal3ClusterTemplate is the Schema for the metal3clustertemplates API.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Metal3ClusterTemplate is the Schema for the metal3clustertemplates API.
+     */
     @JsonProperty("spec")
     public Metal3ClusterTemplateSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Metal3ClusterTemplate is the Schema for the metal3clustertemplates API.
+     */
     @JsonProperty("spec")
     public void setSpec(Metal3ClusterTemplateSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3ClusterTemplateList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3ClusterTemplateList.java
index cfeb271f3e0..a9a2ebd7ffe 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3ClusterTemplateList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3ClusterTemplateList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3ClusterTemplateList contains a list of Metal3ClusterTemplate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class Metal3ClusterTemplateList implements Editable<Metal3ClusterTemplateListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3ClusterTemplate>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "infrastructure.cluster.x-k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3ClusterTemplate> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Metal3ClusterTemplateList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Metal3ClusterTemplateList(String apiVersion, List<io.fabric8.openshift.ap
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Metal3ClusterTemplateList contains a list of Metal3ClusterTemplate.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3ClusterTemplate> getItems() {
         return items;
     }
 
+    /**
+     * Metal3ClusterTemplateList contains a list of Metal3ClusterTemplate.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3ClusterTemplate> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Metal3ClusterTemplateList contains a list of Metal3ClusterTemplate.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Metal3ClusterTemplateList contains a list of Metal3ClusterTemplate.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3ClusterTemplateResource.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3ClusterTemplateResource.java
index 7960c2a3534..4b883accdb9 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3ClusterTemplateResource.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3ClusterTemplateResource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3ClusterTemplateResource describes the data for creating a Metal3Cluster from a template.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public Metal3ClusterTemplateResource(Metal3ClusterSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Metal3ClusterTemplateResource describes the data for creating a Metal3Cluster from a template.
+     */
     @JsonProperty("spec")
     public Metal3ClusterSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Metal3ClusterTemplateResource describes the data for creating a Metal3Cluster from a template.
+     */
     @JsonProperty("spec")
     public void setSpec(Metal3ClusterSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3ClusterTemplateSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3ClusterTemplateSpec.java
index 2074fbfbe80..330341818c1 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3ClusterTemplateSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3ClusterTemplateSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3ClusterTemplateSpec defines the desired state of Metal3ClusterTemplate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public Metal3ClusterTemplateSpec(Metal3ClusterTemplateResource template) {
         this.template = template;
     }
 
+    /**
+     * Metal3ClusterTemplateSpec defines the desired state of Metal3ClusterTemplate.
+     */
     @JsonProperty("template")
     public Metal3ClusterTemplateResource getTemplate() {
         return template;
     }
 
+    /**
+     * Metal3ClusterTemplateSpec defines the desired state of Metal3ClusterTemplate.
+     */
     @JsonProperty("template")
     public void setTemplate(Metal3ClusterTemplateResource template) {
         this.template = template;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3Data.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3Data.java
index f0b0866b7a1..c87c4a4309c 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3Data.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3Data.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3Data is the Schema for the metal3datas API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Metal3Data implements Editable<Metal3DataBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "infrastructure.cluster.x-k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Metal3Data";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Metal3Data(String apiVersion, String kind, ObjectMeta metadata, Metal3Dat
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Metal3Data is the Schema for the metal3datas API.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Metal3Data is the Schema for the metal3datas API.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Metal3Data is the Schema for the metal3datas API.
+     */
     @JsonProperty("spec")
     public Metal3DataSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Metal3Data is the Schema for the metal3datas API.
+     */
     @JsonProperty("spec")
     public void setSpec(Metal3DataSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Metal3Data is the Schema for the metal3datas API.
+     */
     @JsonProperty("status")
     public Metal3DataStatus getStatus() {
         return status;
     }
 
+    /**
+     * Metal3Data is the Schema for the metal3datas API.
+     */
     @JsonProperty("status")
     public void setStatus(Metal3DataStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataClaim.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataClaim.java
index 302dece9fe8..10687d2f6ac 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataClaim.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataClaim.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3DataClaim is the Schema for the metal3datas API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Metal3DataClaim implements Editable<Metal3DataClaimBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "infrastructure.cluster.x-k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Metal3DataClaim";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Metal3DataClaim(String apiVersion, String kind, ObjectMeta metadata, Meta
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Metal3DataClaim is the Schema for the metal3datas API.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Metal3DataClaim is the Schema for the metal3datas API.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Metal3DataClaim is the Schema for the metal3datas API.
+     */
     @JsonProperty("spec")
     public Metal3DataClaimSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Metal3DataClaim is the Schema for the metal3datas API.
+     */
     @JsonProperty("spec")
     public void setSpec(Metal3DataClaimSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Metal3DataClaim is the Schema for the metal3datas API.
+     */
     @JsonProperty("status")
     public Metal3DataClaimStatus getStatus() {
         return status;
     }
 
+    /**
+     * Metal3DataClaim is the Schema for the metal3datas API.
+     */
     @JsonProperty("status")
     public void setStatus(Metal3DataClaimStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataClaimList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataClaimList.java
index f204d35bb44..66766e6990b 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataClaimList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataClaimList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3DataClaimList contains a list of Metal3DataClaim.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class Metal3DataClaimList implements Editable<Metal3DataClaimListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3DataClaim>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "infrastructure.cluster.x-k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3DataClaim> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Metal3DataClaimList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Metal3DataClaimList(String apiVersion, List<io.fabric8.openshift.api.mode
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Metal3DataClaimList contains a list of Metal3DataClaim.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3DataClaim> getItems() {
         return items;
     }
 
+    /**
+     * Metal3DataClaimList contains a list of Metal3DataClaim.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3DataClaim> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Metal3DataClaimList contains a list of Metal3DataClaim.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Metal3DataClaimList contains a list of Metal3DataClaim.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataClaimSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataClaimSpec.java
index 9163fa8c9fd..7f2df9d8831 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataClaimSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataClaimSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3DataClaimSpec defines the desired state of Metal3DataClaim.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public Metal3DataClaimSpec(ObjectReference template) {
         this.template = template;
     }
 
+    /**
+     * Metal3DataClaimSpec defines the desired state of Metal3DataClaim.
+     */
     @JsonProperty("template")
     public ObjectReference getTemplate() {
         return template;
     }
 
+    /**
+     * Metal3DataClaimSpec defines the desired state of Metal3DataClaim.
+     */
     @JsonProperty("template")
     public void setTemplate(ObjectReference template) {
         this.template = template;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataClaimStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataClaimStatus.java
index dd8a39ae909..ba0b2e1fc86 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataClaimStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataClaimStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3DataClaimStatus defines the observed state of Metal3DataClaim.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Metal3DataClaimStatus(String errorMessage, ObjectReference renderedData)
         this.renderedData = renderedData;
     }
 
+    /**
+     * ErrorMessage contains the error message
+     */
     @JsonProperty("errorMessage")
     public String getErrorMessage() {
         return errorMessage;
     }
 
+    /**
+     * ErrorMessage contains the error message
+     */
     @JsonProperty("errorMessage")
     public void setErrorMessage(String errorMessage) {
         this.errorMessage = errorMessage;
     }
 
+    /**
+     * Metal3DataClaimStatus defines the observed state of Metal3DataClaim.
+     */
     @JsonProperty("renderedData")
     public ObjectReference getRenderedData() {
         return renderedData;
     }
 
+    /**
+     * Metal3DataClaimStatus defines the observed state of Metal3DataClaim.
+     */
     @JsonProperty("renderedData")
     public void setRenderedData(ObjectReference renderedData) {
         this.renderedData = renderedData;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataList.java
index 948fe6411d6..c45bf2ddf11 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3DataList contains a list of Metal3Data.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class Metal3DataList implements Editable<Metal3DataListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3Data>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "infrastructure.cluster.x-k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3Data> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Metal3DataList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Metal3DataList(String apiVersion, List<io.fabric8.openshift.api.model.mis
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Metal3DataList contains a list of Metal3Data.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3Data> getItems() {
         return items;
     }
 
+    /**
+     * Metal3DataList contains a list of Metal3Data.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3Data> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Metal3DataList contains a list of Metal3Data.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Metal3DataList contains a list of Metal3Data.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataSpec.java
index 24ed73d941d..44e115d3d61 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataSpec.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3DataSpec defines the desired state of Metal3Data.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -99,61 +102,97 @@ public Metal3DataSpec(ObjectReference claim, Integer index, SecretReference meta
         this.templateReference = templateReference;
     }
 
+    /**
+     * Metal3DataSpec defines the desired state of Metal3Data.
+     */
     @JsonProperty("claim")
     public ObjectReference getClaim() {
         return claim;
     }
 
+    /**
+     * Metal3DataSpec defines the desired state of Metal3Data.
+     */
     @JsonProperty("claim")
     public void setClaim(ObjectReference claim) {
         this.claim = claim;
     }
 
+    /**
+     * Index stores the index value of this instance in the Metal3DataTemplate.
+     */
     @JsonProperty("index")
     public Integer getIndex() {
         return index;
     }
 
+    /**
+     * Index stores the index value of this instance in the Metal3DataTemplate.
+     */
     @JsonProperty("index")
     public void setIndex(Integer index) {
         this.index = index;
     }
 
+    /**
+     * Metal3DataSpec defines the desired state of Metal3Data.
+     */
     @JsonProperty("metaData")
     public SecretReference getMetaData() {
         return metaData;
     }
 
+    /**
+     * Metal3DataSpec defines the desired state of Metal3Data.
+     */
     @JsonProperty("metaData")
     public void setMetaData(SecretReference metaData) {
         this.metaData = metaData;
     }
 
+    /**
+     * Metal3DataSpec defines the desired state of Metal3Data.
+     */
     @JsonProperty("networkData")
     public SecretReference getNetworkData() {
         return networkData;
     }
 
+    /**
+     * Metal3DataSpec defines the desired state of Metal3Data.
+     */
     @JsonProperty("networkData")
     public void setNetworkData(SecretReference networkData) {
         this.networkData = networkData;
     }
 
+    /**
+     * Metal3DataSpec defines the desired state of Metal3Data.
+     */
     @JsonProperty("template")
     public ObjectReference getTemplate() {
         return template;
     }
 
+    /**
+     * Metal3DataSpec defines the desired state of Metal3Data.
+     */
     @JsonProperty("template")
     public void setTemplate(ObjectReference template) {
         this.template = template;
     }
 
+    /**
+     * TemplateReference refers to the Template the Metal3MachineTemplate refers to. It can be matched against the key or it may also point to the name of the template Metal3Data refers to
+     */
     @JsonProperty("templateReference")
     public String getTemplateReference() {
         return templateReference;
     }
 
+    /**
+     * TemplateReference refers to the Template the Metal3MachineTemplate refers to. It can be matched against the key or it may also point to the name of the template Metal3Data refers to
+     */
     @JsonProperty("templateReference")
     public void setTemplateReference(String templateReference) {
         this.templateReference = templateReference;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataStatus.java
index 93d1aac4a1f..a853c27b72f 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3DataStatus defines the observed state of Metal3Data.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Metal3DataStatus(String errorMessage, Boolean ready) {
         this.ready = ready;
     }
 
+    /**
+     * ErrorMessage contains the error message
+     */
     @JsonProperty("errorMessage")
     public String getErrorMessage() {
         return errorMessage;
     }
 
+    /**
+     * ErrorMessage contains the error message
+     */
     @JsonProperty("errorMessage")
     public void setErrorMessage(String errorMessage) {
         this.errorMessage = errorMessage;
     }
 
+    /**
+     * Ready is a flag set to True if the secrets were rendered properly
+     */
     @JsonProperty("ready")
     public Boolean getReady() {
         return ready;
     }
 
+    /**
+     * Ready is a flag set to True if the secrets were rendered properly
+     */
     @JsonProperty("ready")
     public void setReady(Boolean ready) {
         this.ready = ready;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataTemplate.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataTemplate.java
index 36eaef95cca..841d4dac5d6 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataTemplate.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataTemplate.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3DataTemplate is the Schema for the metal3datatemplates API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Metal3DataTemplate implements Editable<Metal3DataTemplateBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "infrastructure.cluster.x-k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Metal3DataTemplate";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Metal3DataTemplate(String apiVersion, String kind, ObjectMeta metadata, M
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Metal3DataTemplate is the Schema for the metal3datatemplates API.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Metal3DataTemplate is the Schema for the metal3datatemplates API.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Metal3DataTemplate is the Schema for the metal3datatemplates API.
+     */
     @JsonProperty("spec")
     public Metal3DataTemplateSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Metal3DataTemplate is the Schema for the metal3datatemplates API.
+     */
     @JsonProperty("spec")
     public void setSpec(Metal3DataTemplateSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Metal3DataTemplate is the Schema for the metal3datatemplates API.
+     */
     @JsonProperty("status")
     public Metal3DataTemplateStatus getStatus() {
         return status;
     }
 
+    /**
+     * Metal3DataTemplate is the Schema for the metal3datatemplates API.
+     */
     @JsonProperty("status")
     public void setStatus(Metal3DataTemplateStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataTemplateList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataTemplateList.java
index d847ef7e96e..71641fa706c 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataTemplateList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataTemplateList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3DataTemplateList contains a list of Metal3DataTemplate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class Metal3DataTemplateList implements Editable<Metal3DataTemplateListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3DataTemplate>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "infrastructure.cluster.x-k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3DataTemplate> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Metal3DataTemplateList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Metal3DataTemplateList(String apiVersion, List<io.fabric8.openshift.api.m
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Metal3DataTemplateList contains a list of Metal3DataTemplate.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3DataTemplate> getItems() {
         return items;
     }
 
+    /**
+     * Metal3DataTemplateList contains a list of Metal3DataTemplate.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3DataTemplate> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Metal3DataTemplateList contains a list of Metal3DataTemplate.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Metal3DataTemplateList contains a list of Metal3DataTemplate.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataTemplateSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataTemplateSpec.java
index 0c3931b8f0a..873a6b176e7 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataTemplateSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataTemplateSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3DataTemplateSpec defines the desired state of Metal3DataTemplate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public Metal3DataTemplateSpec(String clusterName, MetaData metaData, NetworkData
         this.templateReference = templateReference;
     }
 
+    /**
+     * ClusterName is the name of the Cluster this object belongs to.
+     */
     @JsonProperty("clusterName")
     public String getClusterName() {
         return clusterName;
     }
 
+    /**
+     * ClusterName is the name of the Cluster this object belongs to.
+     */
     @JsonProperty("clusterName")
     public void setClusterName(String clusterName) {
         this.clusterName = clusterName;
     }
 
+    /**
+     * Metal3DataTemplateSpec defines the desired state of Metal3DataTemplate.
+     */
     @JsonProperty("metaData")
     public MetaData getMetaData() {
         return metaData;
     }
 
+    /**
+     * Metal3DataTemplateSpec defines the desired state of Metal3DataTemplate.
+     */
     @JsonProperty("metaData")
     public void setMetaData(MetaData metaData) {
         this.metaData = metaData;
     }
 
+    /**
+     * Metal3DataTemplateSpec defines the desired state of Metal3DataTemplate.
+     */
     @JsonProperty("networkData")
     public NetworkData getNetworkData() {
         return networkData;
     }
 
+    /**
+     * Metal3DataTemplateSpec defines the desired state of Metal3DataTemplate.
+     */
     @JsonProperty("networkData")
     public void setNetworkData(NetworkData networkData) {
         this.networkData = networkData;
     }
 
+    /**
+     * TemplateReference refers to the Template the Metal3MachineTemplate refers to. It can be matched against the key or it may also point to the name of the template Metal3Data refers to
+     */
     @JsonProperty("templateReference")
     public String getTemplateReference() {
         return templateReference;
     }
 
+    /**
+     * TemplateReference refers to the Template the Metal3MachineTemplate refers to. It can be matched against the key or it may also point to the name of the template Metal3Data refers to
+     */
     @JsonProperty("templateReference")
     public void setTemplateReference(String templateReference) {
         this.templateReference = templateReference;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataTemplateStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataTemplateStatus.java
index 6b0fd38544e..325645f4899 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataTemplateStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3DataTemplateStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3DataTemplateStatus defines the observed state of Metal3DataTemplate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,22 +86,34 @@ public Metal3DataTemplateStatus(Map<String, Integer> indexes, String lastUpdated
         this.lastUpdated = lastUpdated;
     }
 
+    /**
+     * Indexes contains the map of Metal3Machine and index used
+     */
     @JsonProperty("indexes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, Integer> getIndexes() {
         return indexes;
     }
 
+    /**
+     * Indexes contains the map of Metal3Machine and index used
+     */
     @JsonProperty("indexes")
     public void setIndexes(Map<String, Integer> indexes) {
         this.indexes = indexes;
     }
 
+    /**
+     * Metal3DataTemplateStatus defines the observed state of Metal3DataTemplate.
+     */
     @JsonProperty("lastUpdated")
     public String getLastUpdated() {
         return lastUpdated;
     }
 
+    /**
+     * Metal3DataTemplateStatus defines the observed state of Metal3DataTemplate.
+     */
     @JsonProperty("lastUpdated")
     public void setLastUpdated(String lastUpdated) {
         this.lastUpdated = lastUpdated;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3Machine.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3Machine.java
index d438fbaef84..980733dbbdb 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3Machine.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3Machine.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3Machine is the Schema for the metal3machines API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Metal3Machine implements Editable<Metal3MachineBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "infrastructure.cluster.x-k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Metal3Machine";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Metal3Machine(String apiVersion, String kind, ObjectMeta metadata, Metal3
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Metal3Machine is the Schema for the metal3machines API.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Metal3Machine is the Schema for the metal3machines API.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Metal3Machine is the Schema for the metal3machines API.
+     */
     @JsonProperty("spec")
     public Metal3MachineSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Metal3Machine is the Schema for the metal3machines API.
+     */
     @JsonProperty("spec")
     public void setSpec(Metal3MachineSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Metal3Machine is the Schema for the metal3machines API.
+     */
     @JsonProperty("status")
     public Metal3MachineStatus getStatus() {
         return status;
     }
 
+    /**
+     * Metal3Machine is the Schema for the metal3machines API.
+     */
     @JsonProperty("status")
     public void setStatus(Metal3MachineStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3MachineList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3MachineList.java
index 0f2e9746722..c2739c05cf6 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3MachineList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3MachineList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3MachineList contains a list of Metal3Machine.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class Metal3MachineList implements Editable<Metal3MachineListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3Machine>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "infrastructure.cluster.x-k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3Machine> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Metal3MachineList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Metal3MachineList(String apiVersion, List<io.fabric8.openshift.api.model.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Metal3MachineList contains a list of Metal3Machine.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3Machine> getItems() {
         return items;
     }
 
+    /**
+     * Metal3MachineList contains a list of Metal3Machine.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3Machine> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Metal3MachineList contains a list of Metal3Machine.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Metal3MachineList contains a list of Metal3Machine.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3MachineSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3MachineSpec.java
index 6776a59fdf9..b6b51d79cad 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3MachineSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3MachineSpec.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3MachineSpec defines the desired state of Metal3Machine.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -111,91 +114,145 @@ public Metal3MachineSpec(String automatedCleaningMode, CustomDeploy customDeploy
         this.userData = userData;
     }
 
+    /**
+     * When set to disabled, automated cleaning of host disks will be skipped during provisioning and deprovisioning.
+     */
     @JsonProperty("automatedCleaningMode")
     public String getAutomatedCleaningMode() {
         return automatedCleaningMode;
     }
 
+    /**
+     * When set to disabled, automated cleaning of host disks will be skipped during provisioning and deprovisioning.
+     */
     @JsonProperty("automatedCleaningMode")
     public void setAutomatedCleaningMode(String automatedCleaningMode) {
         this.automatedCleaningMode = automatedCleaningMode;
     }
 
+    /**
+     * Metal3MachineSpec defines the desired state of Metal3Machine.
+     */
     @JsonProperty("customDeploy")
     public CustomDeploy getCustomDeploy() {
         return customDeploy;
     }
 
+    /**
+     * Metal3MachineSpec defines the desired state of Metal3Machine.
+     */
     @JsonProperty("customDeploy")
     public void setCustomDeploy(CustomDeploy customDeploy) {
         this.customDeploy = customDeploy;
     }
 
+    /**
+     * Metal3MachineSpec defines the desired state of Metal3Machine.
+     */
     @JsonProperty("dataTemplate")
     public ObjectReference getDataTemplate() {
         return dataTemplate;
     }
 
+    /**
+     * Metal3MachineSpec defines the desired state of Metal3Machine.
+     */
     @JsonProperty("dataTemplate")
     public void setDataTemplate(ObjectReference dataTemplate) {
         this.dataTemplate = dataTemplate;
     }
 
+    /**
+     * Metal3MachineSpec defines the desired state of Metal3Machine.
+     */
     @JsonProperty("hostSelector")
     public HostSelector getHostSelector() {
         return hostSelector;
     }
 
+    /**
+     * Metal3MachineSpec defines the desired state of Metal3Machine.
+     */
     @JsonProperty("hostSelector")
     public void setHostSelector(HostSelector hostSelector) {
         this.hostSelector = hostSelector;
     }
 
+    /**
+     * Metal3MachineSpec defines the desired state of Metal3Machine.
+     */
     @JsonProperty("image")
     public Image getImage() {
         return image;
     }
 
+    /**
+     * Metal3MachineSpec defines the desired state of Metal3Machine.
+     */
     @JsonProperty("image")
     public void setImage(Image image) {
         this.image = image;
     }
 
+    /**
+     * Metal3MachineSpec defines the desired state of Metal3Machine.
+     */
     @JsonProperty("metaData")
     public SecretReference getMetaData() {
         return metaData;
     }
 
+    /**
+     * Metal3MachineSpec defines the desired state of Metal3Machine.
+     */
     @JsonProperty("metaData")
     public void setMetaData(SecretReference metaData) {
         this.metaData = metaData;
     }
 
+    /**
+     * Metal3MachineSpec defines the desired state of Metal3Machine.
+     */
     @JsonProperty("networkData")
     public SecretReference getNetworkData() {
         return networkData;
     }
 
+    /**
+     * Metal3MachineSpec defines the desired state of Metal3Machine.
+     */
     @JsonProperty("networkData")
     public void setNetworkData(SecretReference networkData) {
         this.networkData = networkData;
     }
 
+    /**
+     * ProviderID will be the Metal3 machine in ProviderID format (metal3://&lt;bmh-uuid&gt;)
+     */
     @JsonProperty("providerID")
     public String getProviderID() {
         return providerID;
     }
 
+    /**
+     * ProviderID will be the Metal3 machine in ProviderID format (metal3://&lt;bmh-uuid&gt;)
+     */
     @JsonProperty("providerID")
     public void setProviderID(String providerID) {
         this.providerID = providerID;
     }
 
+    /**
+     * Metal3MachineSpec defines the desired state of Metal3Machine.
+     */
     @JsonProperty("userData")
     public SecretReference getUserData() {
         return userData;
     }
 
+    /**
+     * Metal3MachineSpec defines the desired state of Metal3Machine.
+     */
     @JsonProperty("userData")
     public void setUserData(SecretReference userData) {
         this.userData = userData;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3MachineStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3MachineStatus.java
index 70334f194c5..349b4b26787 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3MachineStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3MachineStatus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3MachineStatus defines the observed state of Metal3Machine.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -125,113 +128,179 @@ public Metal3MachineStatus(List<MachineAddress> addresses, List<Condition> condi
         this.userData = userData;
     }
 
+    /**
+     * Addresses is a list of addresses assigned to the machine. This field is copied from the infrastructure provider reference.
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MachineAddress> getAddresses() {
         return addresses;
     }
 
+    /**
+     * Addresses is a list of addresses assigned to the machine. This field is copied from the infrastructure provider reference.
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<MachineAddress> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * Conditions defines current service state of the Metal3Machine.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions defines current service state of the Metal3Machine.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * FailureMessage will be set in the event that there is a terminal problem reconciling the metal3machine and will contain a more verbose string suitable for logging and human consumption.<br><p> <br><p> This field should not be set for transitive errors that a controller faces that are expected to be fixed automatically over time (like service outages), but instead indicate that something is fundamentally wrong with the metal3machine's spec or the configuration of the controller, and that manual intervention is required. Examples of terminal errors would be invalid combinations of settings in the spec, values that are unsupported by the controller, or the responsible controller itself being critically misconfigured.<br><p> <br><p> Any transient errors that occur during the reconciliation of metal3machines can be added as events to the metal3machine object and/or logged in the controller's output.
+     */
     @JsonProperty("failureMessage")
     public String getFailureMessage() {
         return failureMessage;
     }
 
+    /**
+     * FailureMessage will be set in the event that there is a terminal problem reconciling the metal3machine and will contain a more verbose string suitable for logging and human consumption.<br><p> <br><p> This field should not be set for transitive errors that a controller faces that are expected to be fixed automatically over time (like service outages), but instead indicate that something is fundamentally wrong with the metal3machine's spec or the configuration of the controller, and that manual intervention is required. Examples of terminal errors would be invalid combinations of settings in the spec, values that are unsupported by the controller, or the responsible controller itself being critically misconfigured.<br><p> <br><p> Any transient errors that occur during the reconciliation of metal3machines can be added as events to the metal3machine object and/or logged in the controller's output.
+     */
     @JsonProperty("failureMessage")
     public void setFailureMessage(String failureMessage) {
         this.failureMessage = failureMessage;
     }
 
+    /**
+     * FailureReason will be set in the event that there is a terminal problem reconciling the metal3machine and will contain a succinct value suitable for machine interpretation.<br><p> <br><p> This field should not be set for transitive errors that a controller faces that are expected to be fixed automatically over time (like service outages), but instead indicate that something is fundamentally wrong with the metal3machine's spec or the configuration of the controller, and that manual intervention is required. Examples of terminal errors would be invalid combinations of settings in the spec, values that are unsupported by the controller, or the responsible controller itself being critically misconfigured.<br><p> <br><p> Any transient errors that occur during the reconciliation of metal3machines can be added as events to the metal3machine object and/or logged in the controller's output.
+     */
     @JsonProperty("failureReason")
     public String getFailureReason() {
         return failureReason;
     }
 
+    /**
+     * FailureReason will be set in the event that there is a terminal problem reconciling the metal3machine and will contain a succinct value suitable for machine interpretation.<br><p> <br><p> This field should not be set for transitive errors that a controller faces that are expected to be fixed automatically over time (like service outages), but instead indicate that something is fundamentally wrong with the metal3machine's spec or the configuration of the controller, and that manual intervention is required. Examples of terminal errors would be invalid combinations of settings in the spec, values that are unsupported by the controller, or the responsible controller itself being critically misconfigured.<br><p> <br><p> Any transient errors that occur during the reconciliation of metal3machines can be added as events to the metal3machine object and/or logged in the controller's output.
+     */
     @JsonProperty("failureReason")
     public void setFailureReason(String failureReason) {
         this.failureReason = failureReason;
     }
 
+    /**
+     * Metal3MachineStatus defines the observed state of Metal3Machine.
+     */
     @JsonProperty("lastUpdated")
     public String getLastUpdated() {
         return lastUpdated;
     }
 
+    /**
+     * Metal3MachineStatus defines the observed state of Metal3Machine.
+     */
     @JsonProperty("lastUpdated")
     public void setLastUpdated(String lastUpdated) {
         this.lastUpdated = lastUpdated;
     }
 
+    /**
+     * Metal3MachineStatus defines the observed state of Metal3Machine.
+     */
     @JsonProperty("metaData")
     public SecretReference getMetaData() {
         return metaData;
     }
 
+    /**
+     * Metal3MachineStatus defines the observed state of Metal3Machine.
+     */
     @JsonProperty("metaData")
     public void setMetaData(SecretReference metaData) {
         this.metaData = metaData;
     }
 
+    /**
+     * Metal3MachineStatus defines the observed state of Metal3Machine.
+     */
     @JsonProperty("networkData")
     public SecretReference getNetworkData() {
         return networkData;
     }
 
+    /**
+     * Metal3MachineStatus defines the observed state of Metal3Machine.
+     */
     @JsonProperty("networkData")
     public void setNetworkData(SecretReference networkData) {
         this.networkData = networkData;
     }
 
+    /**
+     * Phase represents the current phase of machine actuation. E.g. Pending, Running, Terminating, Failed etc.
+     */
     @JsonProperty("phase")
     public String getPhase() {
         return phase;
     }
 
+    /**
+     * Phase represents the current phase of machine actuation. E.g. Pending, Running, Terminating, Failed etc.
+     */
     @JsonProperty("phase")
     public void setPhase(String phase) {
         this.phase = phase;
     }
 
+    /**
+     * Ready is the state of the metal3. mhrivnak: " it would be good to document what this means, how to interpret it, under what circumstances the value changes, etc."
+     */
     @JsonProperty("ready")
     public Boolean getReady() {
         return ready;
     }
 
+    /**
+     * Ready is the state of the metal3. mhrivnak: " it would be good to document what this means, how to interpret it, under what circumstances the value changes, etc."
+     */
     @JsonProperty("ready")
     public void setReady(Boolean ready) {
         this.ready = ready;
     }
 
+    /**
+     * Metal3MachineStatus defines the observed state of Metal3Machine.
+     */
     @JsonProperty("renderedData")
     public ObjectReference getRenderedData() {
         return renderedData;
     }
 
+    /**
+     * Metal3MachineStatus defines the observed state of Metal3Machine.
+     */
     @JsonProperty("renderedData")
     public void setRenderedData(ObjectReference renderedData) {
         this.renderedData = renderedData;
     }
 
+    /**
+     * Metal3MachineStatus defines the observed state of Metal3Machine.
+     */
     @JsonProperty("userData")
     public SecretReference getUserData() {
         return userData;
     }
 
+    /**
+     * Metal3MachineStatus defines the observed state of Metal3Machine.
+     */
     @JsonProperty("userData")
     public void setUserData(SecretReference userData) {
         this.userData = userData;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3MachineTemplate.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3MachineTemplate.java
index 2511db87a97..4f200e217a0 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3MachineTemplate.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3MachineTemplate.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3MachineTemplate is the Schema for the metal3machinetemplates API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Metal3MachineTemplate implements Editable<Metal3MachineTemplateBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "infrastructure.cluster.x-k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Metal3MachineTemplate";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public Metal3MachineTemplate(String apiVersion, String kind, ObjectMeta metadata
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Metal3MachineTemplate is the Schema for the metal3machinetemplates API.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Metal3MachineTemplate is the Schema for the metal3machinetemplates API.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Metal3MachineTemplate is the Schema for the metal3machinetemplates API.
+     */
     @JsonProperty("spec")
     public Metal3MachineTemplateSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Metal3MachineTemplate is the Schema for the metal3machinetemplates API.
+     */
     @JsonProperty("spec")
     public void setSpec(Metal3MachineTemplateSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3MachineTemplateList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3MachineTemplateList.java
index 5c0b071650d..c1b5c895b72 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3MachineTemplateList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3MachineTemplateList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3MachineTemplateList contains a list of Metal3MachineTemplate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class Metal3MachineTemplateList implements Editable<Metal3MachineTemplateListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3MachineTemplate>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "infrastructure.cluster.x-k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3MachineTemplate> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Metal3MachineTemplateList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Metal3MachineTemplateList(String apiVersion, List<io.fabric8.openshift.ap
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Metal3MachineTemplateList contains a list of Metal3MachineTemplate.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3MachineTemplate> getItems() {
         return items;
     }
 
+    /**
+     * Metal3MachineTemplateList contains a list of Metal3MachineTemplate.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3MachineTemplate> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Metal3MachineTemplateList contains a list of Metal3MachineTemplate.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Metal3MachineTemplateList contains a list of Metal3MachineTemplate.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3MachineTemplateResource.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3MachineTemplateResource.java
index 0c9113d7607..43e84de789d 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3MachineTemplateResource.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3MachineTemplateResource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3MachineTemplateResource describes the data needed to create a Metal3Machine from a template.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public Metal3MachineTemplateResource(Metal3MachineSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Metal3MachineTemplateResource describes the data needed to create a Metal3Machine from a template.
+     */
     @JsonProperty("spec")
     public Metal3MachineSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Metal3MachineTemplateResource describes the data needed to create a Metal3Machine from a template.
+     */
     @JsonProperty("spec")
     public void setSpec(Metal3MachineSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3MachineTemplateSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3MachineTemplateSpec.java
index bce291d191d..43b6a8fda98 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3MachineTemplateSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3MachineTemplateSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3MachineTemplateSpec defines the desired state of Metal3MachineTemplate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Metal3MachineTemplateSpec(Boolean nodeReuse, Metal3MachineTemplateResourc
         this.template = template;
     }
 
+    /**
+     * When set to True, CAPM3 Machine controller will pick the same pool of BMHs' that were released during the upgrade operation.
+     */
     @JsonProperty("nodeReuse")
     public Boolean getNodeReuse() {
         return nodeReuse;
     }
 
+    /**
+     * When set to True, CAPM3 Machine controller will pick the same pool of BMHs' that were released during the upgrade operation.
+     */
     @JsonProperty("nodeReuse")
     public void setNodeReuse(Boolean nodeReuse) {
         this.nodeReuse = nodeReuse;
     }
 
+    /**
+     * Metal3MachineTemplateSpec defines the desired state of Metal3MachineTemplate.
+     */
     @JsonProperty("template")
     public Metal3MachineTemplateResource getTemplate() {
         return template;
     }
 
+    /**
+     * Metal3MachineTemplateSpec defines the desired state of Metal3MachineTemplate.
+     */
     @JsonProperty("template")
     public void setTemplate(Metal3MachineTemplateResource template) {
         this.template = template;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3Remediation.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3Remediation.java
index d36deef875e..3c66af5e713 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3Remediation.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3Remediation.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3Remediation is the Schema for the metal3remediations API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Metal3Remediation implements Editable<Metal3RemediationBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "infrastructure.cluster.x-k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Metal3Remediation";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Metal3Remediation(String apiVersion, String kind, ObjectMeta metadata, Me
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Metal3Remediation is the Schema for the metal3remediations API.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Metal3Remediation is the Schema for the metal3remediations API.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Metal3Remediation is the Schema for the metal3remediations API.
+     */
     @JsonProperty("spec")
     public Metal3RemediationSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Metal3Remediation is the Schema for the metal3remediations API.
+     */
     @JsonProperty("spec")
     public void setSpec(Metal3RemediationSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Metal3Remediation is the Schema for the metal3remediations API.
+     */
     @JsonProperty("status")
     public Metal3RemediationStatus getStatus() {
         return status;
     }
 
+    /**
+     * Metal3Remediation is the Schema for the metal3remediations API.
+     */
     @JsonProperty("status")
     public void setStatus(Metal3RemediationStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationList.java
index c58d6a4619e..f54d9e10015 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3RemediationList contains a list of Metal3Remediation.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class Metal3RemediationList implements Editable<Metal3RemediationListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3Remediation>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "infrastructure.cluster.x-k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3Remediation> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Metal3RemediationList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Metal3RemediationList(String apiVersion, List<io.fabric8.openshift.api.mo
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Metal3RemediationList contains a list of Metal3Remediation.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3Remediation> getItems() {
         return items;
     }
 
+    /**
+     * Metal3RemediationList contains a list of Metal3Remediation.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3Remediation> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Metal3RemediationList contains a list of Metal3Remediation.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Metal3RemediationList contains a list of Metal3Remediation.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationSpec.java
index fdf8a6b599a..9c3fed88eaf 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3RemediationSpec defines the desired state of Metal3Remediation.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public Metal3RemediationSpec(RemediationStrategy strategy) {
         this.strategy = strategy;
     }
 
+    /**
+     * Metal3RemediationSpec defines the desired state of Metal3Remediation.
+     */
     @JsonProperty("strategy")
     public RemediationStrategy getStrategy() {
         return strategy;
     }
 
+    /**
+     * Metal3RemediationSpec defines the desired state of Metal3Remediation.
+     */
     @JsonProperty("strategy")
     public void setStrategy(RemediationStrategy strategy) {
         this.strategy = strategy;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationStatus.java
index 5f5514cff93..8a330183091 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3RemediationStatus defines the observed state of Metal3Remediation.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public Metal3RemediationStatus(String lastRemediated, String phase, Integer retr
         this.retryCount = retryCount;
     }
 
+    /**
+     * Metal3RemediationStatus defines the observed state of Metal3Remediation.
+     */
     @JsonProperty("lastRemediated")
     public String getLastRemediated() {
         return lastRemediated;
     }
 
+    /**
+     * Metal3RemediationStatus defines the observed state of Metal3Remediation.
+     */
     @JsonProperty("lastRemediated")
     public void setLastRemediated(String lastRemediated) {
         this.lastRemediated = lastRemediated;
     }
 
+    /**
+     * Phase represents the current phase of machine remediation. E.g. Pending, Running, Done etc.
+     */
     @JsonProperty("phase")
     public String getPhase() {
         return phase;
     }
 
+    /**
+     * Phase represents the current phase of machine remediation. E.g. Pending, Running, Done etc.
+     */
     @JsonProperty("phase")
     public void setPhase(String phase) {
         this.phase = phase;
     }
 
+    /**
+     * RetryCount can be used as a counter during the remediation. Field can hold number of reboots etc.
+     */
     @JsonProperty("retryCount")
     public Integer getRetryCount() {
         return retryCount;
     }
 
+    /**
+     * RetryCount can be used as a counter during the remediation. Field can hold number of reboots etc.
+     */
     @JsonProperty("retryCount")
     public void setRetryCount(Integer retryCount) {
         this.retryCount = retryCount;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationTemplate.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationTemplate.java
index 7f3187c6df4..159f5453cc3 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationTemplate.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationTemplate.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3RemediationTemplate is the Schema for the metal3remediationtemplates API.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Metal3RemediationTemplate implements Editable<Metal3RemediationTemplateBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "infrastructure.cluster.x-k8s.io/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Metal3RemediationTemplate";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Metal3RemediationTemplate(String apiVersion, String kind, ObjectMeta meta
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Metal3RemediationTemplate is the Schema for the metal3remediationtemplates API.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Metal3RemediationTemplate is the Schema for the metal3remediationtemplates API.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Metal3RemediationTemplate is the Schema for the metal3remediationtemplates API.
+     */
     @JsonProperty("spec")
     public Metal3RemediationTemplateSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Metal3RemediationTemplate is the Schema for the metal3remediationtemplates API.
+     */
     @JsonProperty("spec")
     public void setSpec(Metal3RemediationTemplateSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Metal3RemediationTemplate is the Schema for the metal3remediationtemplates API.
+     */
     @JsonProperty("status")
     public Metal3RemediationTemplateStatus getStatus() {
         return status;
     }
 
+    /**
+     * Metal3RemediationTemplate is the Schema for the metal3remediationtemplates API.
+     */
     @JsonProperty("status")
     public void setStatus(Metal3RemediationTemplateStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationTemplateList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationTemplateList.java
index 80f20ef2bb5..72b3c27ee5e 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationTemplateList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationTemplateList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3RemediationTemplateList contains a list of Metal3RemediationTemplate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class Metal3RemediationTemplateList implements Editable<Metal3RemediationTemplateListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3RemediationTemplate>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "infrastructure.cluster.x-k8s.io/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3RemediationTemplate> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Metal3RemediationTemplateList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Metal3RemediationTemplateList(String apiVersion, List<io.fabric8.openshif
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Metal3RemediationTemplateList contains a list of Metal3RemediationTemplate.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3RemediationTemplate> getItems() {
         return items;
     }
 
+    /**
+     * Metal3RemediationTemplateList contains a list of Metal3RemediationTemplate.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.metal3.v1beta1.Metal3RemediationTemplate> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Metal3RemediationTemplateList contains a list of Metal3RemediationTemplate.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Metal3RemediationTemplateList contains a list of Metal3RemediationTemplate.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationTemplateResource.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationTemplateResource.java
index aba48fabc3c..41b32cd101a 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationTemplateResource.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationTemplateResource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3RemediationTemplateResource describes the data needed to create a Metal3Remediation from a template.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public Metal3RemediationTemplateResource(Metal3RemediationSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Metal3RemediationTemplateResource describes the data needed to create a Metal3Remediation from a template.
+     */
     @JsonProperty("spec")
     public Metal3RemediationSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Metal3RemediationTemplateResource describes the data needed to create a Metal3Remediation from a template.
+     */
     @JsonProperty("spec")
     public void setSpec(Metal3RemediationSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationTemplateSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationTemplateSpec.java
index e890acfbf4a..55f00361091 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationTemplateSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationTemplateSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3RemediationTemplateSpec defines the desired state of Metal3RemediationTemplate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public Metal3RemediationTemplateSpec(Metal3RemediationTemplateResource template)
         this.template = template;
     }
 
+    /**
+     * Metal3RemediationTemplateSpec defines the desired state of Metal3RemediationTemplate.
+     */
     @JsonProperty("template")
     public Metal3RemediationTemplateResource getTemplate() {
         return template;
     }
 
+    /**
+     * Metal3RemediationTemplateSpec defines the desired state of Metal3RemediationTemplate.
+     */
     @JsonProperty("template")
     public void setTemplate(Metal3RemediationTemplateResource template) {
         this.template = template;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationTemplateStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationTemplateStatus.java
index 69b08aac036..55c26b4f690 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationTemplateStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/Metal3RemediationTemplateStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Metal3RemediationTemplateStatus defines the observed state of Metal3RemediationTemplate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public Metal3RemediationTemplateStatus(Metal3RemediationStatus status) {
         this.status = status;
     }
 
+    /**
+     * Metal3RemediationTemplateStatus defines the observed state of Metal3RemediationTemplate.
+     */
     @JsonProperty("status")
     public Metal3RemediationStatus getStatus() {
         return status;
     }
 
+    /**
+     * Metal3RemediationTemplateStatus defines the observed state of Metal3RemediationTemplate.
+     */
     @JsonProperty("status")
     public void setStatus(Metal3RemediationStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkData.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkData.java
index 14ad787b593..267c998e501 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkData.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkData.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkData represents a networkData object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public NetworkData(NetworkDataLink links, NetworkDataNetwork networks, NetworkDa
         this.services = services;
     }
 
+    /**
+     * NetworkData represents a networkData object.
+     */
     @JsonProperty("links")
     public NetworkDataLink getLinks() {
         return links;
     }
 
+    /**
+     * NetworkData represents a networkData object.
+     */
     @JsonProperty("links")
     public void setLinks(NetworkDataLink links) {
         this.links = links;
     }
 
+    /**
+     * NetworkData represents a networkData object.
+     */
     @JsonProperty("networks")
     public NetworkDataNetwork getNetworks() {
         return networks;
     }
 
+    /**
+     * NetworkData represents a networkData object.
+     */
     @JsonProperty("networks")
     public void setNetworks(NetworkDataNetwork networks) {
         this.networks = networks;
     }
 
+    /**
+     * NetworkData represents a networkData object.
+     */
     @JsonProperty("services")
     public NetworkDataService getServices() {
         return services;
     }
 
+    /**
+     * NetworkData represents a networkData object.
+     */
     @JsonProperty("services")
     public void setServices(NetworkDataService services) {
         this.services = services;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataIPv4.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataIPv4.java
index 1e5c779190e..e4afa4df5ae 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataIPv4.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataIPv4.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkDataIPv4 represents an ipv4 static network object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,52 +101,82 @@ public NetworkDataIPv4(TypedLocalObjectReference fromPoolRef, String id, String
         this.routes = routes;
     }
 
+    /**
+     * NetworkDataIPv4 represents an ipv4 static network object.
+     */
     @JsonProperty("fromPoolRef")
     public TypedLocalObjectReference getFromPoolRef() {
         return fromPoolRef;
     }
 
+    /**
+     * NetworkDataIPv4 represents an ipv4 static network object.
+     */
     @JsonProperty("fromPoolRef")
     public void setFromPoolRef(TypedLocalObjectReference fromPoolRef) {
         this.fromPoolRef = fromPoolRef;
     }
 
+    /**
+     * ID is the network ID (name)
+     */
     @JsonProperty("id")
     public String getId() {
         return id;
     }
 
+    /**
+     * ID is the network ID (name)
+     */
     @JsonProperty("id")
     public void setId(String id) {
         this.id = id;
     }
 
+    /**
+     * IPAddressFromIPPool contains the name of the IP pool to use to get an ip address
+     */
     @JsonProperty("ipAddressFromIPPool")
     public String getIpAddressFromIPPool() {
         return ipAddressFromIPPool;
     }
 
+    /**
+     * IPAddressFromIPPool contains the name of the IP pool to use to get an ip address
+     */
     @JsonProperty("ipAddressFromIPPool")
     public void setIpAddressFromIPPool(String ipAddressFromIPPool) {
         this.ipAddressFromIPPool = ipAddressFromIPPool;
     }
 
+    /**
+     * Link is the link on which the network applies
+     */
     @JsonProperty("link")
     public String getLink() {
         return link;
     }
 
+    /**
+     * Link is the link on which the network applies
+     */
     @JsonProperty("link")
     public void setLink(String link) {
         this.link = link;
     }
 
+    /**
+     * Routes contains a list of IPv4 routes
+     */
     @JsonProperty("routes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NetworkDataRoutev4> getRoutes() {
         return routes;
     }
 
+    /**
+     * Routes contains a list of IPv4 routes
+     */
     @JsonProperty("routes")
     public void setRoutes(List<NetworkDataRoutev4> routes) {
         this.routes = routes;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataIPv4DHCP.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataIPv4DHCP.java
index eafeebb2da4..8b6f5a6aaed 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataIPv4DHCP.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataIPv4DHCP.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkDataIPv4DHCP represents an ipv4 DHCP network object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public NetworkDataIPv4DHCP(String id, String link, List<NetworkDataRoutev4> rout
         this.routes = routes;
     }
 
+    /**
+     * ID is the network ID (name)
+     */
     @JsonProperty("id")
     public String getId() {
         return id;
     }
 
+    /**
+     * ID is the network ID (name)
+     */
     @JsonProperty("id")
     public void setId(String id) {
         this.id = id;
     }
 
+    /**
+     * Link is the link on which the network applies
+     */
     @JsonProperty("link")
     public String getLink() {
         return link;
     }
 
+    /**
+     * Link is the link on which the network applies
+     */
     @JsonProperty("link")
     public void setLink(String link) {
         this.link = link;
     }
 
+    /**
+     * Routes contains a list of IPv4 routes
+     */
     @JsonProperty("routes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NetworkDataRoutev4> getRoutes() {
         return routes;
     }
 
+    /**
+     * Routes contains a list of IPv4 routes
+     */
     @JsonProperty("routes")
     public void setRoutes(List<NetworkDataRoutev4> routes) {
         this.routes = routes;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataIPv6.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataIPv6.java
index a5e635b56e0..278633b1550 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataIPv6.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataIPv6.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkDataIPv6 represents an ipv6 static network object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,52 +101,82 @@ public NetworkDataIPv6(TypedLocalObjectReference fromPoolRef, String id, String
         this.routes = routes;
     }
 
+    /**
+     * NetworkDataIPv6 represents an ipv6 static network object.
+     */
     @JsonProperty("fromPoolRef")
     public TypedLocalObjectReference getFromPoolRef() {
         return fromPoolRef;
     }
 
+    /**
+     * NetworkDataIPv6 represents an ipv6 static network object.
+     */
     @JsonProperty("fromPoolRef")
     public void setFromPoolRef(TypedLocalObjectReference fromPoolRef) {
         this.fromPoolRef = fromPoolRef;
     }
 
+    /**
+     * ID is the network ID (name)
+     */
     @JsonProperty("id")
     public String getId() {
         return id;
     }
 
+    /**
+     * ID is the network ID (name)
+     */
     @JsonProperty("id")
     public void setId(String id) {
         this.id = id;
     }
 
+    /**
+     * IPAddressFromIPPool contains the name of the IPPool to use to get an ip address
+     */
     @JsonProperty("ipAddressFromIPPool")
     public String getIpAddressFromIPPool() {
         return ipAddressFromIPPool;
     }
 
+    /**
+     * IPAddressFromIPPool contains the name of the IPPool to use to get an ip address
+     */
     @JsonProperty("ipAddressFromIPPool")
     public void setIpAddressFromIPPool(String ipAddressFromIPPool) {
         this.ipAddressFromIPPool = ipAddressFromIPPool;
     }
 
+    /**
+     * Link is the link on which the network applies
+     */
     @JsonProperty("link")
     public String getLink() {
         return link;
     }
 
+    /**
+     * Link is the link on which the network applies
+     */
     @JsonProperty("link")
     public void setLink(String link) {
         this.link = link;
     }
 
+    /**
+     * Routes contains a list of IPv6 routes
+     */
     @JsonProperty("routes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NetworkDataRoutev6> getRoutes() {
         return routes;
     }
 
+    /**
+     * Routes contains a list of IPv6 routes
+     */
     @JsonProperty("routes")
     public void setRoutes(List<NetworkDataRoutev6> routes) {
         this.routes = routes;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataIPv6DHCP.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataIPv6DHCP.java
index cc38aa431fb..d9207f6d46b 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataIPv6DHCP.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataIPv6DHCP.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkDataIPv6DHCP represents an ipv6 DHCP network object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public NetworkDataIPv6DHCP(String id, String link, List<NetworkDataRoutev6> rout
         this.routes = routes;
     }
 
+    /**
+     * ID is the network ID (name)
+     */
     @JsonProperty("id")
     public String getId() {
         return id;
     }
 
+    /**
+     * ID is the network ID (name)
+     */
     @JsonProperty("id")
     public void setId(String id) {
         this.id = id;
     }
 
+    /**
+     * Link is the link on which the network applies
+     */
     @JsonProperty("link")
     public String getLink() {
         return link;
     }
 
+    /**
+     * Link is the link on which the network applies
+     */
     @JsonProperty("link")
     public void setLink(String link) {
         this.link = link;
     }
 
+    /**
+     * Routes contains a list of IPv6 routes
+     */
     @JsonProperty("routes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NetworkDataRoutev6> getRoutes() {
         return routes;
     }
 
+    /**
+     * Routes contains a list of IPv6 routes
+     */
     @JsonProperty("routes")
     public void setRoutes(List<NetworkDataRoutev6> routes) {
         this.routes = routes;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataLink.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataLink.java
index 2eaedb8884b..061ef6415e7 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataLink.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataLink.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkDataLink contains list of different link objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,34 +94,52 @@ public NetworkDataLink(List<NetworkDataLinkBond> bonds, List<NetworkDataLinkEthe
         this.vlans = vlans;
     }
 
+    /**
+     * Bonds contains a list of Bond links
+     */
     @JsonProperty("bonds")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NetworkDataLinkBond> getBonds() {
         return bonds;
     }
 
+    /**
+     * Bonds contains a list of Bond links
+     */
     @JsonProperty("bonds")
     public void setBonds(List<NetworkDataLinkBond> bonds) {
         this.bonds = bonds;
     }
 
+    /**
+     * Ethernets contains a list of Ethernet links
+     */
     @JsonProperty("ethernets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NetworkDataLinkEthernet> getEthernets() {
         return ethernets;
     }
 
+    /**
+     * Ethernets contains a list of Ethernet links
+     */
     @JsonProperty("ethernets")
     public void setEthernets(List<NetworkDataLinkEthernet> ethernets) {
         this.ethernets = ethernets;
     }
 
+    /**
+     * Vlans contains a list of Vlan links
+     */
     @JsonProperty("vlans")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NetworkDataLinkVlan> getVlans() {
         return vlans;
     }
 
+    /**
+     * Vlans contains a list of Vlan links
+     */
     @JsonProperty("vlans")
     public void setVlans(List<NetworkDataLinkVlan> vlans) {
         this.vlans = vlans;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataLinkBond.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataLinkBond.java
index 210b974cf7e..bd80cfe3493 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataLinkBond.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataLinkBond.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkDataLinkBond represents a bond link object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,62 +104,98 @@ public NetworkDataLinkBond(List<String> bondLinks, String bondMode, String bondX
         this.mtu = mtu;
     }
 
+    /**
+     * BondLinks is the list of links that are part of the bond.
+     */
     @JsonProperty("bondLinks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getBondLinks() {
         return bondLinks;
     }
 
+    /**
+     * BondLinks is the list of links that are part of the bond.
+     */
     @JsonProperty("bondLinks")
     public void setBondLinks(List<String> bondLinks) {
         this.bondLinks = bondLinks;
     }
 
+    /**
+     * BondMode is the mode of bond used. It can be one of balance-rr, active-backup, balance-xor, broadcast, balance-tlb, balance-alb, 802.3ad
+     */
     @JsonProperty("bondMode")
     public String getBondMode() {
         return bondMode;
     }
 
+    /**
+     * BondMode is the mode of bond used. It can be one of balance-rr, active-backup, balance-xor, broadcast, balance-tlb, balance-alb, 802.3ad
+     */
     @JsonProperty("bondMode")
     public void setBondMode(String bondMode) {
         this.bondMode = bondMode;
     }
 
+    /**
+     * Selects the transmit hash policy used for port selection in balance-xor and 802.3ad modes
+     */
     @JsonProperty("bondXmitHashPolicy")
     public String getBondXmitHashPolicy() {
         return bondXmitHashPolicy;
     }
 
+    /**
+     * Selects the transmit hash policy used for port selection in balance-xor and 802.3ad modes
+     */
     @JsonProperty("bondXmitHashPolicy")
     public void setBondXmitHashPolicy(String bondXmitHashPolicy) {
         this.bondXmitHashPolicy = bondXmitHashPolicy;
     }
 
+    /**
+     * Id is the ID of the interface (used for naming)
+     */
     @JsonProperty("id")
     public String getId() {
         return id;
     }
 
+    /**
+     * Id is the ID of the interface (used for naming)
+     */
     @JsonProperty("id")
     public void setId(String id) {
         this.id = id;
     }
 
+    /**
+     * NetworkDataLinkBond represents a bond link object.
+     */
     @JsonProperty("macAddress")
     public NetworkLinkEthernetMac getMacAddress() {
         return macAddress;
     }
 
+    /**
+     * NetworkDataLinkBond represents a bond link object.
+     */
     @JsonProperty("macAddress")
     public void setMacAddress(NetworkLinkEthernetMac macAddress) {
         this.macAddress = macAddress;
     }
 
+    /**
+     * MTU is the MTU of the interface
+     */
     @JsonProperty("mtu")
     public Integer getMtu() {
         return mtu;
     }
 
+    /**
+     * MTU is the MTU of the interface
+     */
     @JsonProperty("mtu")
     public void setMtu(Integer mtu) {
         this.mtu = mtu;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataLinkEthernet.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataLinkEthernet.java
index 19eff490355..81e40b4a764 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataLinkEthernet.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataLinkEthernet.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkDataLinkEthernet represents an ethernet link object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public NetworkDataLinkEthernet(String id, NetworkLinkEthernetMac macAddress, Int
         this.type = type;
     }
 
+    /**
+     * Id is the ID of the interface (used for naming)
+     */
     @JsonProperty("id")
     public String getId() {
         return id;
     }
 
+    /**
+     * Id is the ID of the interface (used for naming)
+     */
     @JsonProperty("id")
     public void setId(String id) {
         this.id = id;
     }
 
+    /**
+     * NetworkDataLinkEthernet represents an ethernet link object.
+     */
     @JsonProperty("macAddress")
     public NetworkLinkEthernetMac getMacAddress() {
         return macAddress;
     }
 
+    /**
+     * NetworkDataLinkEthernet represents an ethernet link object.
+     */
     @JsonProperty("macAddress")
     public void setMacAddress(NetworkLinkEthernetMac macAddress) {
         this.macAddress = macAddress;
     }
 
+    /**
+     * MTU is the MTU of the interface
+     */
     @JsonProperty("mtu")
     public Integer getMtu() {
         return mtu;
     }
 
+    /**
+     * MTU is the MTU of the interface
+     */
     @JsonProperty("mtu")
     public void setMtu(Integer mtu) {
         this.mtu = mtu;
     }
 
+    /**
+     * Type is the type of the ethernet link. It can be one of: bridge, dvs, hw_veb, hyperv, ovs, tap, vhostuser, vif, phy
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of the ethernet link. It can be one of: bridge, dvs, hw_veb, hyperv, ovs, tap, vhostuser, vif, phy
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataLinkVlan.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataLinkVlan.java
index 3614e89ca7e..7d51dfeae6e 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataLinkVlan.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataLinkVlan.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkDataLinkVlan represents a vlan link object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public NetworkDataLinkVlan(String id, NetworkLinkEthernetMac macAddress, Integer
         this.vlanLink = vlanLink;
     }
 
+    /**
+     * Id is the ID of the interface (used for naming)
+     */
     @JsonProperty("id")
     public String getId() {
         return id;
     }
 
+    /**
+     * Id is the ID of the interface (used for naming)
+     */
     @JsonProperty("id")
     public void setId(String id) {
         this.id = id;
     }
 
+    /**
+     * NetworkDataLinkVlan represents a vlan link object.
+     */
     @JsonProperty("macAddress")
     public NetworkLinkEthernetMac getMacAddress() {
         return macAddress;
     }
 
+    /**
+     * NetworkDataLinkVlan represents a vlan link object.
+     */
     @JsonProperty("macAddress")
     public void setMacAddress(NetworkLinkEthernetMac macAddress) {
         this.macAddress = macAddress;
     }
 
+    /**
+     * MTU is the MTU of the interface
+     */
     @JsonProperty("mtu")
     public Integer getMtu() {
         return mtu;
     }
 
+    /**
+     * MTU is the MTU of the interface
+     */
     @JsonProperty("mtu")
     public void setMtu(Integer mtu) {
         this.mtu = mtu;
     }
 
+    /**
+     * VlanID is the Vlan ID
+     */
     @JsonProperty("vlanID")
     public Integer getVlanID() {
         return vlanID;
     }
 
+    /**
+     * VlanID is the Vlan ID
+     */
     @JsonProperty("vlanID")
     public void setVlanID(Integer vlanID) {
         this.vlanID = vlanID;
     }
 
+    /**
+     * VlanLink is the name of the link on which the vlan should be added
+     */
     @JsonProperty("vlanLink")
     public String getVlanLink() {
         return vlanLink;
     }
 
+    /**
+     * VlanLink is the name of the link on which the vlan should be added
+     */
     @JsonProperty("vlanLink")
     public void setVlanLink(String vlanLink) {
         this.vlanLink = vlanLink;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataNetwork.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataNetwork.java
index 31b9b608e7b..6d06ab2cd30 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataNetwork.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataNetwork.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkDataNetwork represents a network object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,56 +104,86 @@ public NetworkDataNetwork(List<NetworkDataIPv4> ipv4, List<NetworkDataIPv4DHCP>
         this.ipv6SLAAC = ipv6SLAAC;
     }
 
+    /**
+     * IPv4 contains a list of IPv4 static allocations
+     */
     @JsonProperty("ipv4")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NetworkDataIPv4> getIpv4() {
         return ipv4;
     }
 
+    /**
+     * IPv4 contains a list of IPv4 static allocations
+     */
     @JsonProperty("ipv4")
     public void setIpv4(List<NetworkDataIPv4> ipv4) {
         this.ipv4 = ipv4;
     }
 
+    /**
+     * IPv4 contains a list of IPv4 DHCP allocations
+     */
     @JsonProperty("ipv4DHCP")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NetworkDataIPv4DHCP> getIpv4DHCP() {
         return ipv4DHCP;
     }
 
+    /**
+     * IPv4 contains a list of IPv4 DHCP allocations
+     */
     @JsonProperty("ipv4DHCP")
     public void setIpv4DHCP(List<NetworkDataIPv4DHCP> ipv4DHCP) {
         this.ipv4DHCP = ipv4DHCP;
     }
 
+    /**
+     * IPv4 contains a list of IPv6 static allocations
+     */
     @JsonProperty("ipv6")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NetworkDataIPv6> getIpv6() {
         return ipv6;
     }
 
+    /**
+     * IPv4 contains a list of IPv6 static allocations
+     */
     @JsonProperty("ipv6")
     public void setIpv6(List<NetworkDataIPv6> ipv6) {
         this.ipv6 = ipv6;
     }
 
+    /**
+     * IPv4 contains a list of IPv6 DHCP allocations
+     */
     @JsonProperty("ipv6DHCP")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NetworkDataIPv6DHCP> getIpv6DHCP() {
         return ipv6DHCP;
     }
 
+    /**
+     * IPv4 contains a list of IPv6 DHCP allocations
+     */
     @JsonProperty("ipv6DHCP")
     public void setIpv6DHCP(List<NetworkDataIPv6DHCP> ipv6DHCP) {
         this.ipv6DHCP = ipv6DHCP;
     }
 
+    /**
+     * IPv4 contains a list of IPv6 SLAAC allocations
+     */
     @JsonProperty("ipv6SLAAC")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NetworkDataIPv6DHCP> getIpv6SLAAC() {
         return ipv6SLAAC;
     }
 
+    /**
+     * IPv4 contains a list of IPv6 SLAAC allocations
+     */
     @JsonProperty("ipv6SLAAC")
     public void setIpv6SLAAC(List<NetworkDataIPv6DHCP> ipv6SLAAC) {
         this.ipv6SLAAC = ipv6SLAAC;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataRoutev4.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataRoutev4.java
index 68f39d0096e..1e05f7d5aa2 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataRoutev4.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataRoutev4.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkDataRoutev4 represents an ipv4 route object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public NetworkDataRoutev4(NetworkGatewayv4 gateway, String network, Integer pref
         this.services = services;
     }
 
+    /**
+     * NetworkDataRoutev4 represents an ipv4 route object.
+     */
     @JsonProperty("gateway")
     public NetworkGatewayv4 getGateway() {
         return gateway;
     }
 
+    /**
+     * NetworkDataRoutev4 represents an ipv4 route object.
+     */
     @JsonProperty("gateway")
     public void setGateway(NetworkGatewayv4 gateway) {
         this.gateway = gateway;
     }
 
+    /**
+     * Network is the IPv4 network address
+     */
     @JsonProperty("network")
     public String getNetwork() {
         return network;
     }
 
+    /**
+     * Network is the IPv4 network address
+     */
     @JsonProperty("network")
     public void setNetwork(String network) {
         this.network = network;
     }
 
+    /**
+     * Prefix is the mask of the network as integer (max 32)
+     */
     @JsonProperty("prefix")
     public Integer getPrefix() {
         return prefix;
     }
 
+    /**
+     * Prefix is the mask of the network as integer (max 32)
+     */
     @JsonProperty("prefix")
     public void setPrefix(Integer prefix) {
         this.prefix = prefix;
     }
 
+    /**
+     * NetworkDataRoutev4 represents an ipv4 route object.
+     */
     @JsonProperty("services")
     public NetworkDataServicev4 getServices() {
         return services;
     }
 
+    /**
+     * NetworkDataRoutev4 represents an ipv4 route object.
+     */
     @JsonProperty("services")
     public void setServices(NetworkDataServicev4 services) {
         this.services = services;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataRoutev6.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataRoutev6.java
index 31a87672c5f..867a292c218 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataRoutev6.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataRoutev6.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkDataRoutev6 represents an ipv6 route object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public NetworkDataRoutev6(NetworkGatewayv6 gateway, String network, Integer pref
         this.services = services;
     }
 
+    /**
+     * NetworkDataRoutev6 represents an ipv6 route object.
+     */
     @JsonProperty("gateway")
     public NetworkGatewayv6 getGateway() {
         return gateway;
     }
 
+    /**
+     * NetworkDataRoutev6 represents an ipv6 route object.
+     */
     @JsonProperty("gateway")
     public void setGateway(NetworkGatewayv6 gateway) {
         this.gateway = gateway;
     }
 
+    /**
+     * Network is the IPv6 network address
+     */
     @JsonProperty("network")
     public String getNetwork() {
         return network;
     }
 
+    /**
+     * Network is the IPv6 network address
+     */
     @JsonProperty("network")
     public void setNetwork(String network) {
         this.network = network;
     }
 
+    /**
+     * Prefix is the mask of the network as integer (max 128)
+     */
     @JsonProperty("prefix")
     public Integer getPrefix() {
         return prefix;
     }
 
+    /**
+     * Prefix is the mask of the network as integer (max 128)
+     */
     @JsonProperty("prefix")
     public void setPrefix(Integer prefix) {
         this.prefix = prefix;
     }
 
+    /**
+     * NetworkDataRoutev6 represents an ipv6 route object.
+     */
     @JsonProperty("services")
     public NetworkDataServicev6 getServices() {
         return services;
     }
 
+    /**
+     * NetworkDataRoutev6 represents an ipv6 route object.
+     */
     @JsonProperty("services")
     public void setServices(NetworkDataServicev6 services) {
         this.services = services;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataService.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataService.java
index a35b8f46026..aeec4191133 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataService.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataService.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkDataService represents a service object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public NetworkDataService(List<String> dns, String dnsFromIPPool) {
         this.dnsFromIPPool = dnsFromIPPool;
     }
 
+    /**
+     * DNS is a list of DNS services
+     */
     @JsonProperty("dns")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDns() {
         return dns;
     }
 
+    /**
+     * DNS is a list of DNS services
+     */
     @JsonProperty("dns")
     public void setDns(List<String> dns) {
         this.dns = dns;
     }
 
+    /**
+     * DNSFromIPPool is the name of the IPPool from which to get the DNS servers
+     */
     @JsonProperty("dnsFromIPPool")
     public String getDnsFromIPPool() {
         return dnsFromIPPool;
     }
 
+    /**
+     * DNSFromIPPool is the name of the IPPool from which to get the DNS servers
+     */
     @JsonProperty("dnsFromIPPool")
     public void setDnsFromIPPool(String dnsFromIPPool) {
         this.dnsFromIPPool = dnsFromIPPool;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataServicev4.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataServicev4.java
index ca08411568f..02f7a5a9b57 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataServicev4.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataServicev4.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkDataServicev4 represents a service object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public NetworkDataServicev4(List<String> dns, String dnsFromIPPool) {
         this.dnsFromIPPool = dnsFromIPPool;
     }
 
+    /**
+     * DNS is a list of IPv4 DNS services
+     */
     @JsonProperty("dns")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDns() {
         return dns;
     }
 
+    /**
+     * DNS is a list of IPv4 DNS services
+     */
     @JsonProperty("dns")
     public void setDns(List<String> dns) {
         this.dns = dns;
     }
 
+    /**
+     * DNSFromIPPool is the name of the IPPool from which to get the DNS servers
+     */
     @JsonProperty("dnsFromIPPool")
     public String getDnsFromIPPool() {
         return dnsFromIPPool;
     }
 
+    /**
+     * DNSFromIPPool is the name of the IPPool from which to get the DNS servers
+     */
     @JsonProperty("dnsFromIPPool")
     public void setDnsFromIPPool(String dnsFromIPPool) {
         this.dnsFromIPPool = dnsFromIPPool;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataServicev6.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataServicev6.java
index a651492af2d..5962ea74195 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataServicev6.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkDataServicev6.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkDataServicev6 represents a service object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public NetworkDataServicev6(List<String> dns, String dnsFromIPPool) {
         this.dnsFromIPPool = dnsFromIPPool;
     }
 
+    /**
+     * DNS is a list of IPv6 DNS services
+     */
     @JsonProperty("dns")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDns() {
         return dns;
     }
 
+    /**
+     * DNS is a list of IPv6 DNS services
+     */
     @JsonProperty("dns")
     public void setDns(List<String> dns) {
         this.dns = dns;
     }
 
+    /**
+     * DNSFromIPPool is the name of the IPPool from which to get the DNS servers
+     */
     @JsonProperty("dnsFromIPPool")
     public String getDnsFromIPPool() {
         return dnsFromIPPool;
     }
 
+    /**
+     * DNSFromIPPool is the name of the IPPool from which to get the DNS servers
+     */
     @JsonProperty("dnsFromIPPool")
     public void setDnsFromIPPool(String dnsFromIPPool) {
         this.dnsFromIPPool = dnsFromIPPool;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkGatewayv4.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkGatewayv4.java
index 23dedde819e..236ab3c7853 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkGatewayv4.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkGatewayv4.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkGatewayv4 represents a gateway, given as a string or as a reference to a Metal3IPPool.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public NetworkGatewayv4(String fromIPPool, String string) {
         this.string = string;
     }
 
+    /**
+     * FromIPPool is the name of the IPPool to fetch the gateway from
+     */
     @JsonProperty("fromIPPool")
     public String getFromIPPool() {
         return fromIPPool;
     }
 
+    /**
+     * FromIPPool is the name of the IPPool to fetch the gateway from
+     */
     @JsonProperty("fromIPPool")
     public void setFromIPPool(String fromIPPool) {
         this.fromIPPool = fromIPPool;
     }
 
+    /**
+     * String is the gateway given as a string
+     */
     @JsonProperty("string")
     public String getString() {
         return string;
     }
 
+    /**
+     * String is the gateway given as a string
+     */
     @JsonProperty("string")
     public void setString(String string) {
         this.string = string;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkGatewayv6.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkGatewayv6.java
index fb7b9041af4..fbe627091dc 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkGatewayv6.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkGatewayv6.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkGatewayv6 represents a gateway, given as a string or as a reference to a Metal3IPPool.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public NetworkGatewayv6(String fromIPPool, String string) {
         this.string = string;
     }
 
+    /**
+     * FromIPPool is the name of the IPPool to fetch the gateway from
+     */
     @JsonProperty("fromIPPool")
     public String getFromIPPool() {
         return fromIPPool;
     }
 
+    /**
+     * FromIPPool is the name of the IPPool to fetch the gateway from
+     */
     @JsonProperty("fromIPPool")
     public void setFromIPPool(String fromIPPool) {
         this.fromIPPool = fromIPPool;
     }
 
+    /**
+     * String is the gateway given as a string
+     */
     @JsonProperty("string")
     public String getString() {
         return string;
     }
 
+    /**
+     * String is the gateway given as a string
+     */
     @JsonProperty("string")
     public void setString(String string) {
         this.string = string;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkLinkEthernetMac.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkLinkEthernetMac.java
index 9d9f635c924..e37bcbbc239 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkLinkEthernetMac.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkLinkEthernetMac.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkLinkEthernetMac represents the Mac address content.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public NetworkLinkEthernetMac(NetworkLinkEthernetMacFromAnnotation fromAnnotatio
         this.string = string;
     }
 
+    /**
+     * NetworkLinkEthernetMac represents the Mac address content.
+     */
     @JsonProperty("fromAnnotation")
     public NetworkLinkEthernetMacFromAnnotation getFromAnnotation() {
         return fromAnnotation;
     }
 
+    /**
+     * NetworkLinkEthernetMac represents the Mac address content.
+     */
     @JsonProperty("fromAnnotation")
     public void setFromAnnotation(NetworkLinkEthernetMacFromAnnotation fromAnnotation) {
         this.fromAnnotation = fromAnnotation;
     }
 
+    /**
+     * FromHostInterface contains the name of the interface in the BareMetalHost Introspection details from which to fetch the MAC address
+     */
     @JsonProperty("fromHostInterface")
     public String getFromHostInterface() {
         return fromHostInterface;
     }
 
+    /**
+     * FromHostInterface contains the name of the interface in the BareMetalHost Introspection details from which to fetch the MAC address
+     */
     @JsonProperty("fromHostInterface")
     public void setFromHostInterface(String fromHostInterface) {
         this.fromHostInterface = fromHostInterface;
     }
 
+    /**
+     * String contains the MAC address given as a string
+     */
     @JsonProperty("string")
     public String getString() {
         return string;
     }
 
+    /**
+     * String contains the MAC address given as a string
+     */
     @JsonProperty("string")
     public void setString(String string) {
         this.string = string;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkLinkEthernetMacFromAnnotation.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkLinkEthernetMacFromAnnotation.java
index 0801fa7bff4..d15b0bfdc1e 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkLinkEthernetMacFromAnnotation.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/NetworkLinkEthernetMacFromAnnotation.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkLinkEthernetMacFromAnnotation contains the information to fetch an annotation content, if the label does not exist, it is rendered as empty string.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public NetworkLinkEthernetMacFromAnnotation(String annotation, String object) {
         this.object = object;
     }
 
+    /**
+     * Annotation is the key of the Annotation to fetch
+     */
     @JsonProperty("annotation")
     public String getAnnotation() {
         return annotation;
     }
 
+    /**
+     * Annotation is the key of the Annotation to fetch
+     */
     @JsonProperty("annotation")
     public void setAnnotation(String annotation) {
         this.annotation = annotation;
     }
 
+    /**
+     * Object is the type of the object from which we retrieve the name
+     */
     @JsonProperty("object")
     public String getObject() {
         return object;
     }
 
+    /**
+     * Object is the type of the object from which we retrieve the name
+     */
     @JsonProperty("object")
     public void setObject(String object) {
         this.object = object;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/RemediationStrategy.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/RemediationStrategy.java
index 6b48aaa4dde..cda6a5802ce 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/RemediationStrategy.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/metal3/v1beta1/RemediationStrategy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RemediationStrategy describes how to remediate machines.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public RemediationStrategy(Integer retryLimit, String timeout, String type) {
         this.type = type;
     }
 
+    /**
+     * Sets maximum number of remediation retries.
+     */
     @JsonProperty("retryLimit")
     public Integer getRetryLimit() {
         return retryLimit;
     }
 
+    /**
+     * Sets maximum number of remediation retries.
+     */
     @JsonProperty("retryLimit")
     public void setRetryLimit(Integer retryLimit) {
         this.retryLimit = retryLimit;
     }
 
+    /**
+     * RemediationStrategy describes how to remediate machines.
+     */
     @JsonProperty("timeout")
     public String getTimeout() {
         return timeout;
     }
 
+    /**
+     * RemediationStrategy describes how to remediate machines.
+     */
     @JsonProperty("timeout")
     public void setTimeout(String timeout) {
         this.timeout = timeout;
     }
 
+    /**
+     * Type of remediation.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of remediation.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/cloud/v1/CloudPrivateIPConfig.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/cloud/v1/CloudPrivateIPConfig.java
index 507add57622..cc398d0faaf 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/cloud/v1/CloudPrivateIPConfig.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/cloud/v1/CloudPrivateIPConfig.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CloudPrivateIPConfig performs an assignment of a private IP address to the primary NIC associated with cloud VMs. This is done by specifying the IP and Kubernetes node which the IP should be assigned to. This CRD is intended to be used by the network plugin which manages the cluster network. The spec side represents the desired state requested by the network plugin, and the status side represents the current state that this CRD's controller has executed. No users will have permission to modify it, and if a cluster-admin decides to edit it for some reason, their changes will be overwritten the next time the network plugin reconciles the object. Note: the CR's name must specify the requested private IP address (can be IPv4 or IPv6).<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class CloudPrivateIPConfig implements Editable<CloudPrivateIPConfigBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cloud.network.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CloudPrivateIPConfig";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public CloudPrivateIPConfig(String apiVersion, String kind, ObjectMeta metadata,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CloudPrivateIPConfig performs an assignment of a private IP address to the primary NIC associated with cloud VMs. This is done by specifying the IP and Kubernetes node which the IP should be assigned to. This CRD is intended to be used by the network plugin which manages the cluster network. The spec side represents the desired state requested by the network plugin, and the status side represents the current state that this CRD's controller has executed. No users will have permission to modify it, and if a cluster-admin decides to edit it for some reason, their changes will be overwritten the next time the network plugin reconciles the object. Note: the CR's name must specify the requested private IP address (can be IPv4 or IPv6).<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CloudPrivateIPConfig performs an assignment of a private IP address to the primary NIC associated with cloud VMs. This is done by specifying the IP and Kubernetes node which the IP should be assigned to. This CRD is intended to be used by the network plugin which manages the cluster network. The spec side represents the desired state requested by the network plugin, and the status side represents the current state that this CRD's controller has executed. No users will have permission to modify it, and if a cluster-admin decides to edit it for some reason, their changes will be overwritten the next time the network plugin reconciles the object. Note: the CR's name must specify the requested private IP address (can be IPv4 or IPv6).<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * CloudPrivateIPConfig performs an assignment of a private IP address to the primary NIC associated with cloud VMs. This is done by specifying the IP and Kubernetes node which the IP should be assigned to. This CRD is intended to be used by the network plugin which manages the cluster network. The spec side represents the desired state requested by the network plugin, and the status side represents the current state that this CRD's controller has executed. No users will have permission to modify it, and if a cluster-admin decides to edit it for some reason, their changes will be overwritten the next time the network plugin reconciles the object. Note: the CR's name must specify the requested private IP address (can be IPv4 or IPv6).<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public CloudPrivateIPConfigSpec getSpec() {
         return spec;
     }
 
+    /**
+     * CloudPrivateIPConfig performs an assignment of a private IP address to the primary NIC associated with cloud VMs. This is done by specifying the IP and Kubernetes node which the IP should be assigned to. This CRD is intended to be used by the network plugin which manages the cluster network. The spec side represents the desired state requested by the network plugin, and the status side represents the current state that this CRD's controller has executed. No users will have permission to modify it, and if a cluster-admin decides to edit it for some reason, their changes will be overwritten the next time the network plugin reconciles the object. Note: the CR's name must specify the requested private IP address (can be IPv4 or IPv6).<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(CloudPrivateIPConfigSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * CloudPrivateIPConfig performs an assignment of a private IP address to the primary NIC associated with cloud VMs. This is done by specifying the IP and Kubernetes node which the IP should be assigned to. This CRD is intended to be used by the network plugin which manages the cluster network. The spec side represents the desired state requested by the network plugin, and the status side represents the current state that this CRD's controller has executed. No users will have permission to modify it, and if a cluster-admin decides to edit it for some reason, their changes will be overwritten the next time the network plugin reconciles the object. Note: the CR's name must specify the requested private IP address (can be IPv4 or IPv6).<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public CloudPrivateIPConfigStatus getStatus() {
         return status;
     }
 
+    /**
+     * CloudPrivateIPConfig performs an assignment of a private IP address to the primary NIC associated with cloud VMs. This is done by specifying the IP and Kubernetes node which the IP should be assigned to. This CRD is intended to be used by the network plugin which manages the cluster network. The spec side represents the desired state requested by the network plugin, and the status side represents the current state that this CRD's controller has executed. No users will have permission to modify it, and if a cluster-admin decides to edit it for some reason, their changes will be overwritten the next time the network plugin reconciles the object. Note: the CR's name must specify the requested private IP address (can be IPv4 or IPv6).<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(CloudPrivateIPConfigStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/cloud/v1/CloudPrivateIPConfigList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/cloud/v1/CloudPrivateIPConfigList.java
index 4ee78ba740a..17494a65a5d 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/cloud/v1/CloudPrivateIPConfigList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/cloud/v1/CloudPrivateIPConfigList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer). CloudPrivateIPConfigList is the list of CloudPrivateIPConfigList.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class CloudPrivateIPConfigList implements Editable<CloudPrivateIPConfigListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.network.cloud.v1.CloudPrivateIPConfig>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "cloud.network.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.network.cloud.v1.CloudPrivateIPConfig> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CloudPrivateIPConfigList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CloudPrivateIPConfigList(String apiVersion, List<io.fabric8.openshift.api
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of CloudPrivateIPConfig.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.miscellaneous.network.cloud.v1.CloudPrivateIPConfig> getItems() {
         return items;
     }
 
+    /**
+     * List of CloudPrivateIPConfig.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.network.cloud.v1.CloudPrivateIPConfig> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer). CloudPrivateIPConfigList is the list of CloudPrivateIPConfigList.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer). CloudPrivateIPConfigList is the list of CloudPrivateIPConfigList.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/cloud/v1/CloudPrivateIPConfigSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/cloud/v1/CloudPrivateIPConfigSpec.java
index 718af46578f..c17d3bb9234 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/cloud/v1/CloudPrivateIPConfigSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/cloud/v1/CloudPrivateIPConfigSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CloudPrivateIPConfigSpec consists of a node name which the private IP should be assigned to.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public CloudPrivateIPConfigSpec(String node) {
         this.node = node;
     }
 
+    /**
+     * node is the node name, as specified by the Kubernetes field: node.metadata.name
+     */
     @JsonProperty("node")
     public String getNode() {
         return node;
     }
 
+    /**
+     * node is the node name, as specified by the Kubernetes field: node.metadata.name
+     */
     @JsonProperty("node")
     public void setNode(String node) {
         this.node = node;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/cloud/v1/CloudPrivateIPConfigStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/cloud/v1/CloudPrivateIPConfigStatus.java
index 11b9511a048..4e9e6b5b3fe 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/cloud/v1/CloudPrivateIPConfigStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/cloud/v1/CloudPrivateIPConfigStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CloudPrivateIPConfigStatus specifies the node assignment together with its assignment condition.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,22 +89,34 @@ public CloudPrivateIPConfigStatus(List<Condition> conditions, String node) {
         this.node = node;
     }
 
+    /**
+     * condition is the assignment condition of the private IP and its status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * condition is the assignment condition of the private IP and its status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * node is the node name, as specified by the Kubernetes field: node.metadata.name
+     */
     @JsonProperty("node")
     public String getNode() {
         return node;
     }
 
+    /**
+     * node is the node name, as specified by the Kubernetes field: node.metadata.name
+     */
     @JsonProperty("node")
     public void setNode(String node) {
         this.node = node;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/ClusterNetwork.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/ClusterNetwork.java
index ec6b28430d5..a867399b460 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/ClusterNetwork.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/ClusterNetwork.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterNetwork was used by OpenShift SDN. DEPRECATED: OpenShift SDN is no longer supported and this object is no longer used in any way by OpenShift.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,9 +85,6 @@
 public class ClusterNetwork implements Editable<ClusterNetworkBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "network.openshift.io/v1";
     @JsonProperty("clusterNetworks")
@@ -92,9 +92,6 @@ public class ClusterNetwork implements Editable<ClusterNetworkBuilder>, HasMetad
     private List<ClusterNetworkEntry> clusterNetworks = new ArrayList<>();
     @JsonProperty("hostsubnetlength")
     private Long hostsubnetlength;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterNetwork";
     @JsonProperty("metadata")
@@ -133,7 +130,7 @@ public ClusterNetwork(String apiVersion, List<ClusterNetworkEntry> clusterNetwor
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -141,36 +138,48 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ClusterNetworks is a list of ClusterNetwork objects that defines the global overlay network's L3 space by specifying a set of CIDR and netmasks that the SDN can allocate addresses from.
+     */
     @JsonProperty("clusterNetworks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ClusterNetworkEntry> getClusterNetworks() {
         return clusterNetworks;
     }
 
+    /**
+     * ClusterNetworks is a list of ClusterNetwork objects that defines the global overlay network's L3 space by specifying a set of CIDR and netmasks that the SDN can allocate addresses from.
+     */
     @JsonProperty("clusterNetworks")
     public void setClusterNetworks(List<ClusterNetworkEntry> clusterNetworks) {
         this.clusterNetworks = clusterNetworks;
     }
 
+    /**
+     * HostSubnetLength is the number of bits of network to allocate to each node. eg, 8 would mean that each node would have a /24 slice of the overlay network for its pods
+     */
     @JsonProperty("hostsubnetlength")
     public Long getHostsubnetlength() {
         return hostsubnetlength;
     }
 
+    /**
+     * HostSubnetLength is the number of bits of network to allocate to each node. eg, 8 would mean that each node would have a /24 slice of the overlay network for its pods
+     */
     @JsonProperty("hostsubnetlength")
     public void setHostsubnetlength(Long hostsubnetlength) {
         this.hostsubnetlength = hostsubnetlength;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -178,68 +187,104 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterNetwork was used by OpenShift SDN. DEPRECATED: OpenShift SDN is no longer supported and this object is no longer used in any way by OpenShift.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterNetwork was used by OpenShift SDN. DEPRECATED: OpenShift SDN is no longer supported and this object is no longer used in any way by OpenShift.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * MTU is the MTU for the overlay network. This should be 50 less than the MTU of the network connecting the nodes. It is normally autodetected by the cluster network operator.
+     */
     @JsonProperty("mtu")
     public Long getMtu() {
         return mtu;
     }
 
+    /**
+     * MTU is the MTU for the overlay network. This should be 50 less than the MTU of the network connecting the nodes. It is normally autodetected by the cluster network operator.
+     */
     @JsonProperty("mtu")
     public void setMtu(Long mtu) {
         this.mtu = mtu;
     }
 
+    /**
+     * Network is a CIDR string specifying the global overlay network's L3 space
+     */
     @JsonProperty("network")
     public String getNetwork() {
         return network;
     }
 
+    /**
+     * Network is a CIDR string specifying the global overlay network's L3 space
+     */
     @JsonProperty("network")
     public void setNetwork(String network) {
         this.network = network;
     }
 
+    /**
+     * PluginName is the name of the network plugin being used
+     */
     @JsonProperty("pluginName")
     public String getPluginName() {
         return pluginName;
     }
 
+    /**
+     * PluginName is the name of the network plugin being used
+     */
     @JsonProperty("pluginName")
     public void setPluginName(String pluginName) {
         this.pluginName = pluginName;
     }
 
+    /**
+     * ServiceNetwork is the CIDR range that Service IP addresses are allocated from
+     */
     @JsonProperty("serviceNetwork")
     public String getServiceNetwork() {
         return serviceNetwork;
     }
 
+    /**
+     * ServiceNetwork is the CIDR range that Service IP addresses are allocated from
+     */
     @JsonProperty("serviceNetwork")
     public void setServiceNetwork(String serviceNetwork) {
         this.serviceNetwork = serviceNetwork;
     }
 
+    /**
+     * VXLANPort sets the VXLAN destination port used by the cluster. It is set by the master configuration file on startup and cannot be edited manually. Valid values for VXLANPort are integers 1-65535 inclusive and if unset defaults to 4789. Changing VXLANPort allows users to resolve issues between openshift SDN and other software trying to use the same VXLAN destination port.
+     */
     @JsonProperty("vxlanPort")
     public Long getVxlanPort() {
         return vxlanPort;
     }
 
+    /**
+     * VXLANPort sets the VXLAN destination port used by the cluster. It is set by the master configuration file on startup and cannot be edited manually. Valid values for VXLANPort are integers 1-65535 inclusive and if unset defaults to 4789. Changing VXLANPort allows users to resolve issues between openshift SDN and other software trying to use the same VXLAN destination port.
+     */
     @JsonProperty("vxlanPort")
     public void setVxlanPort(Long vxlanPort) {
         this.vxlanPort = vxlanPort;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/ClusterNetworkEntry.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/ClusterNetworkEntry.java
index 019f767f03f..07bf1d70f64 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/ClusterNetworkEntry.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/ClusterNetworkEntry.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterNetworkEntry defines an individual cluster network. The CIDRs cannot overlap with other cluster network CIDRs, CIDRs reserved for external ips, CIDRs reserved for service networks, and CIDRs reserved for ingress ips.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ClusterNetworkEntry(String cIDR, Long hostSubnetLength) {
         this.hostSubnetLength = hostSubnetLength;
     }
 
+    /**
+     * CIDR defines the total range of a cluster networks address space.
+     */
     @JsonProperty("CIDR")
     public String getCIDR() {
         return cIDR;
     }
 
+    /**
+     * CIDR defines the total range of a cluster networks address space.
+     */
     @JsonProperty("CIDR")
     public void setCIDR(String cIDR) {
         this.cIDR = cIDR;
     }
 
+    /**
+     * HostSubnetLength is the number of bits of the accompanying CIDR address to allocate to each node. eg, 8 would mean that each node would have a /24 slice of the overlay network for its pods.
+     */
     @JsonProperty("hostSubnetLength")
     public Long getHostSubnetLength() {
         return hostSubnetLength;
     }
 
+    /**
+     * HostSubnetLength is the number of bits of the accompanying CIDR address to allocate to each node. eg, 8 would mean that each node would have a /24 slice of the overlay network for its pods.
+     */
     @JsonProperty("hostSubnetLength")
     public void setHostSubnetLength(Long hostSubnetLength) {
         this.hostSubnetLength = hostSubnetLength;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/ClusterNetworkList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/ClusterNetworkList.java
index e906a431a2b..72cc38ef653 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/ClusterNetworkList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/ClusterNetworkList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterNetworkList is a collection of ClusterNetworks<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ClusterNetworkList implements Editable<ClusterNetworkListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.network.v1.ClusterNetwork>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "network.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.network.v1.ClusterNetwork> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterNetworkList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterNetworkList(String apiVersion, List<io.fabric8.openshift.api.model
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of cluster networks
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.miscellaneous.network.v1.ClusterNetwork> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of cluster networks
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.network.v1.ClusterNetwork> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterNetworkList is a collection of ClusterNetworks<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterNetworkList is a collection of ClusterNetworks<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/EgressNetworkPolicy.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/EgressNetworkPolicy.java
index 3e185ea04b3..6553ac66f5a 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/EgressNetworkPolicy.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/EgressNetworkPolicy.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressNetworkPolicy was used by OpenShift SDN. DEPRECATED: OpenShift SDN is no longer supported and this object is no longer used in any way by OpenShift.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class EgressNetworkPolicy implements Editable<EgressNetworkPolicyBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "network.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EgressNetworkPolicy";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public EgressNetworkPolicy(String apiVersion, String kind, ObjectMeta metadata,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EgressNetworkPolicy was used by OpenShift SDN. DEPRECATED: OpenShift SDN is no longer supported and this object is no longer used in any way by OpenShift.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EgressNetworkPolicy was used by OpenShift SDN. DEPRECATED: OpenShift SDN is no longer supported and this object is no longer used in any way by OpenShift.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * EgressNetworkPolicy was used by OpenShift SDN. DEPRECATED: OpenShift SDN is no longer supported and this object is no longer used in any way by OpenShift.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public EgressNetworkPolicySpec getSpec() {
         return spec;
     }
 
+    /**
+     * EgressNetworkPolicy was used by OpenShift SDN. DEPRECATED: OpenShift SDN is no longer supported and this object is no longer used in any way by OpenShift.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(EgressNetworkPolicySpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/EgressNetworkPolicyList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/EgressNetworkPolicyList.java
index ddb4a7848ed..b4b1c79f7f9 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/EgressNetworkPolicyList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/EgressNetworkPolicyList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressNetworkPolicyList is a collection of EgressNetworkPolicy<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class EgressNetworkPolicyList implements Editable<EgressNetworkPolicyListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.network.v1.EgressNetworkPolicy>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "network.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.network.v1.EgressNetworkPolicy> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EgressNetworkPolicyList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EgressNetworkPolicyList(String apiVersion, List<io.fabric8.openshift.api.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is the list of policies
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.miscellaneous.network.v1.EgressNetworkPolicy> getItems() {
         return items;
     }
 
+    /**
+     * items is the list of policies
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.network.v1.EgressNetworkPolicy> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EgressNetworkPolicyList is a collection of EgressNetworkPolicy<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EgressNetworkPolicyList is a collection of EgressNetworkPolicy<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/EgressNetworkPolicyPeer.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/EgressNetworkPolicyPeer.java
index c90a6425bd6..c7a55e615ca 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/EgressNetworkPolicyPeer.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/EgressNetworkPolicyPeer.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressNetworkPolicyPeer specifies a target to apply egress network policy to
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public EgressNetworkPolicyPeer(String cidrSelector, String dnsName) {
         this.dnsName = dnsName;
     }
 
+    /**
+     * CIDRSelector is the CIDR range to allow/deny traffic to. If this is set, dnsName must be unset Ideally we would have liked to use the cidr openapi format for this property. But openshift-sdn only supports v4 while specifying the cidr format allows both v4 and v6 cidrs We are therefore using a regex pattern to validate instead.
+     */
     @JsonProperty("cidrSelector")
     public String getCidrSelector() {
         return cidrSelector;
     }
 
+    /**
+     * CIDRSelector is the CIDR range to allow/deny traffic to. If this is set, dnsName must be unset Ideally we would have liked to use the cidr openapi format for this property. But openshift-sdn only supports v4 while specifying the cidr format allows both v4 and v6 cidrs We are therefore using a regex pattern to validate instead.
+     */
     @JsonProperty("cidrSelector")
     public void setCidrSelector(String cidrSelector) {
         this.cidrSelector = cidrSelector;
     }
 
+    /**
+     * DNSName is the domain name to allow/deny traffic to. If this is set, cidrSelector must be unset
+     */
     @JsonProperty("dnsName")
     public String getDnsName() {
         return dnsName;
     }
 
+    /**
+     * DNSName is the domain name to allow/deny traffic to. If this is set, cidrSelector must be unset
+     */
     @JsonProperty("dnsName")
     public void setDnsName(String dnsName) {
         this.dnsName = dnsName;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/EgressNetworkPolicyRule.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/EgressNetworkPolicyRule.java
index ca4ee91afa1..c9384a94923 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/EgressNetworkPolicyRule.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/EgressNetworkPolicyRule.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressNetworkPolicyRule contains a single egress network policy rule
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public EgressNetworkPolicyRule(EgressNetworkPolicyPeer to, String type) {
         this.type = type;
     }
 
+    /**
+     * EgressNetworkPolicyRule contains a single egress network policy rule
+     */
     @JsonProperty("to")
     public EgressNetworkPolicyPeer getTo() {
         return to;
     }
 
+    /**
+     * EgressNetworkPolicyRule contains a single egress network policy rule
+     */
     @JsonProperty("to")
     public void setTo(EgressNetworkPolicyPeer to) {
         this.to = to;
     }
 
+    /**
+     * type marks this as an "Allow" or "Deny" rule
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type marks this as an "Allow" or "Deny" rule
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/EgressNetworkPolicySpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/EgressNetworkPolicySpec.java
index a659c2bdfd8..e782281f335 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/EgressNetworkPolicySpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/EgressNetworkPolicySpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressNetworkPolicySpec provides a list of policies on outgoing network traffic
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public EgressNetworkPolicySpec(List<EgressNetworkPolicyRule> egress) {
         this.egress = egress;
     }
 
+    /**
+     * egress contains the list of egress policy rules
+     */
     @JsonProperty("egress")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EgressNetworkPolicyRule> getEgress() {
         return egress;
     }
 
+    /**
+     * egress contains the list of egress policy rules
+     */
     @JsonProperty("egress")
     public void setEgress(List<EgressNetworkPolicyRule> egress) {
         this.egress = egress;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/HostSubnet.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/HostSubnet.java
index ae510d90b4e..e46872fa89a 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/HostSubnet.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/HostSubnet.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HostSubnet was used by OpenShift SDN. DEPRECATED: OpenShift SDN is no longer supported and this object is no longer used in any way by OpenShift.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -80,9 +83,6 @@
 public class HostSubnet implements Editable<HostSubnetBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "network.openshift.io/v1";
     @JsonProperty("egressCIDRs")
@@ -95,9 +95,6 @@ public class HostSubnet implements Editable<HostSubnetBuilder>, HasMetadata
     private String host;
     @JsonProperty("hostIP")
     private String hostIP;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "HostSubnet";
     @JsonProperty("metadata")
@@ -126,7 +123,7 @@ public HostSubnet(String apiVersion, List<String> egressCIDRs, List<String> egre
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -134,57 +131,81 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * EgressCIDRs is the list of CIDR ranges available for automatically assigning egress IPs to this node from. If this field is set then EgressIPs should be treated as read-only.
+     */
     @JsonProperty("egressCIDRs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEgressCIDRs() {
         return egressCIDRs;
     }
 
+    /**
+     * EgressCIDRs is the list of CIDR ranges available for automatically assigning egress IPs to this node from. If this field is set then EgressIPs should be treated as read-only.
+     */
     @JsonProperty("egressCIDRs")
     public void setEgressCIDRs(List<String> egressCIDRs) {
         this.egressCIDRs = egressCIDRs;
     }
 
+    /**
+     * EgressIPs is the list of automatic egress IP addresses currently hosted by this node. If EgressCIDRs is empty, this can be set by hand; if EgressCIDRs is set then the master will overwrite the value here with its own allocation of egress IPs.
+     */
     @JsonProperty("egressIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEgressIPs() {
         return egressIPs;
     }
 
+    /**
+     * EgressIPs is the list of automatic egress IP addresses currently hosted by this node. If EgressCIDRs is empty, this can be set by hand; if EgressCIDRs is set then the master will overwrite the value here with its own allocation of egress IPs.
+     */
     @JsonProperty("egressIPs")
     public void setEgressIPs(List<String> egressIPs) {
         this.egressIPs = egressIPs;
     }
 
+    /**
+     * Host is the name of the node. (This is the same as the object's name, but both fields must be set.)
+     */
     @JsonProperty("host")
     public String getHost() {
         return host;
     }
 
+    /**
+     * Host is the name of the node. (This is the same as the object's name, but both fields must be set.)
+     */
     @JsonProperty("host")
     public void setHost(String host) {
         this.host = host;
     }
 
+    /**
+     * HostIP is the IP address to be used as a VTEP by other nodes in the overlay network
+     */
     @JsonProperty("hostIP")
     public String getHostIP() {
         return hostIP;
     }
 
+    /**
+     * HostIP is the IP address to be used as a VTEP by other nodes in the overlay network
+     */
     @JsonProperty("hostIP")
     public void setHostIP(String hostIP) {
         this.hostIP = hostIP;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -192,28 +213,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * HostSubnet was used by OpenShift SDN. DEPRECATED: OpenShift SDN is no longer supported and this object is no longer used in any way by OpenShift.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * HostSubnet was used by OpenShift SDN. DEPRECATED: OpenShift SDN is no longer supported and this object is no longer used in any way by OpenShift.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Subnet is the CIDR range of the overlay network assigned to the node for its pods
+     */
     @JsonProperty("subnet")
     public String getSubnet() {
         return subnet;
     }
 
+    /**
+     * Subnet is the CIDR range of the overlay network assigned to the node for its pods
+     */
     @JsonProperty("subnet")
     public void setSubnet(String subnet) {
         this.subnet = subnet;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/HostSubnetList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/HostSubnetList.java
index c70e8b2b2bd..83cbd024a5d 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/HostSubnetList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/HostSubnetList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HostSubnetList is a collection of HostSubnets<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class HostSubnetList implements Editable<HostSubnetListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.network.v1.HostSubnet>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "network.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.network.v1.HostSubnet> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "HostSubnetList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public HostSubnetList(String apiVersion, List<io.fabric8.openshift.api.model.mis
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of host subnets
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.miscellaneous.network.v1.HostSubnet> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of host subnets
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.network.v1.HostSubnet> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * HostSubnetList is a collection of HostSubnets<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * HostSubnetList is a collection of HostSubnets<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/NetNamespace.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/NetNamespace.java
index cf54bbeb156..634cb420c22 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/NetNamespace.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/NetNamespace.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetNamespace was used by OpenShift SDN. DEPRECATED: OpenShift SDN is no longer supported and this object is no longer used in any way by OpenShift.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class NetNamespace implements Editable<NetNamespaceBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "network.openshift.io/v1";
     @JsonProperty("egressIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<String> egressIPs = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "NetNamespace";
     @JsonProperty("metadata")
@@ -117,7 +114,7 @@ public NetNamespace(String apiVersion, List<String> egressIPs, String kind, Obje
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -125,26 +122,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * EgressIPs is a list of reserved IPs that will be used as the source for external traffic coming from pods in this namespace. (If empty, external traffic will be masqueraded to Node IPs.)
+     */
     @JsonProperty("egressIPs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEgressIPs() {
         return egressIPs;
     }
 
+    /**
+     * EgressIPs is a list of reserved IPs that will be used as the source for external traffic coming from pods in this namespace. (If empty, external traffic will be masqueraded to Node IPs.)
+     */
     @JsonProperty("egressIPs")
     public void setEgressIPs(List<String> egressIPs) {
         this.egressIPs = egressIPs;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -152,38 +155,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * NetNamespace was used by OpenShift SDN. DEPRECATED: OpenShift SDN is no longer supported and this object is no longer used in any way by OpenShift.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * NetNamespace was used by OpenShift SDN. DEPRECATED: OpenShift SDN is no longer supported and this object is no longer used in any way by OpenShift.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * NetID is the network identifier of the network namespace assigned to each overlay network packet. This can be manipulated with the "oc adm pod-network" commands.
+     */
     @JsonProperty("netid")
     public Long getNetid() {
         return netid;
     }
 
+    /**
+     * NetID is the network identifier of the network namespace assigned to each overlay network packet. This can be manipulated with the "oc adm pod-network" commands.
+     */
     @JsonProperty("netid")
     public void setNetid(Long netid) {
         this.netid = netid;
     }
 
+    /**
+     * NetName is the name of the network namespace. (This is the same as the object's name, but both fields must be set.)
+     */
     @JsonProperty("netname")
     public String getNetname() {
         return netname;
     }
 
+    /**
+     * NetName is the name of the network namespace. (This is the same as the object's name, but both fields must be set.)
+     */
     @JsonProperty("netname")
     public void setNetname(String netname) {
         this.netname = netname;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/NetNamespaceList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/NetNamespaceList.java
index ca0b57208c6..40decabd72b 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/NetNamespaceList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1/NetNamespaceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetNamespaceList is a collection of NetNamespaces<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class NetNamespaceList implements Editable<NetNamespaceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.network.v1.NetNamespace>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "network.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.network.v1.NetNamespace> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "NetNamespaceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public NetNamespaceList(String apiVersion, List<io.fabric8.openshift.api.model.m
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of net namespaces
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.miscellaneous.network.v1.NetNamespace> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of net namespaces
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.network.v1.NetNamespace> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * NetNamespaceList is a collection of NetNamespaces<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * NetNamespaceList is a collection of NetNamespaces<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1alpha1/DNSNameResolver.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1alpha1/DNSNameResolver.java
index 650edd74cd9..4b8b1446f25 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1alpha1/DNSNameResolver.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1alpha1/DNSNameResolver.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSNameResolver stores the DNS name resolution information of a DNS name. It can be enabled by the TechPreviewNoUpgrade feature set. It can also be enabled by the feature gate DNSNameResolver when using CustomNoUpgrade feature set.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class DNSNameResolver implements Editable<DNSNameResolverBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "network.openshift.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DNSNameResolver";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DNSNameResolver(String apiVersion, String kind, ObjectMeta metadata, DNSN
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DNSNameResolver stores the DNS name resolution information of a DNS name. It can be enabled by the TechPreviewNoUpgrade feature set. It can also be enabled by the feature gate DNSNameResolver when using CustomNoUpgrade feature set.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DNSNameResolver stores the DNS name resolution information of a DNS name. It can be enabled by the TechPreviewNoUpgrade feature set. It can also be enabled by the feature gate DNSNameResolver when using CustomNoUpgrade feature set.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * DNSNameResolver stores the DNS name resolution information of a DNS name. It can be enabled by the TechPreviewNoUpgrade feature set. It can also be enabled by the feature gate DNSNameResolver when using CustomNoUpgrade feature set.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("spec")
     public DNSNameResolverSpec getSpec() {
         return spec;
     }
 
+    /**
+     * DNSNameResolver stores the DNS name resolution information of a DNS name. It can be enabled by the TechPreviewNoUpgrade feature set. It can also be enabled by the feature gate DNSNameResolver when using CustomNoUpgrade feature set.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("spec")
     public void setSpec(DNSNameResolverSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * DNSNameResolver stores the DNS name resolution information of a DNS name. It can be enabled by the TechPreviewNoUpgrade feature set. It can also be enabled by the feature gate DNSNameResolver when using CustomNoUpgrade feature set.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("status")
     public DNSNameResolverStatus getStatus() {
         return status;
     }
 
+    /**
+     * DNSNameResolver stores the DNS name resolution information of a DNS name. It can be enabled by the TechPreviewNoUpgrade feature set. It can also be enabled by the feature gate DNSNameResolver when using CustomNoUpgrade feature set.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("status")
     public void setStatus(DNSNameResolverStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1alpha1/DNSNameResolverList.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1alpha1/DNSNameResolverList.java
index c84d53507bd..73154cfb2b6 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1alpha1/DNSNameResolverList.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1alpha1/DNSNameResolverList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSNameResolverList contains a list of DNSNameResolvers.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class DNSNameResolverList implements Editable<DNSNameResolverListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.miscellaneous.network.v1alpha1.DNSNameResolver>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "network.openshift.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.miscellaneous.network.v1alpha1.DNSNameResolver> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DNSNameResolverList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DNSNameResolverList(String apiVersion, List<io.fabric8.openshift.api.mode
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items gives the list of DNSNameResolvers.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.miscellaneous.network.v1alpha1.DNSNameResolver> getItems() {
         return items;
     }
 
+    /**
+     * items gives the list of DNSNameResolvers.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.miscellaneous.network.v1alpha1.DNSNameResolver> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DNSNameResolverList contains a list of DNSNameResolvers.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DNSNameResolverList contains a list of DNSNameResolvers.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1alpha1/DNSNameResolverResolvedAddress.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1alpha1/DNSNameResolverResolvedAddress.java
index 927974c3025..b27b6b90d12 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1alpha1/DNSNameResolverResolvedAddress.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1alpha1/DNSNameResolverResolvedAddress.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSNameResolverResolvedAddress describes the details of an IP address for a resolved DNS name.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public DNSNameResolverResolvedAddress(String ip, String lastLookupTime, Integer
         this.ttlSeconds = ttlSeconds;
     }
 
+    /**
+     * ip is an IP address associated with the dnsName. The validity of the IP address expires after lastLookupTime + ttlSeconds. To refresh the information, a DNS lookup will be performed upon the expiration of the IP address's validity. If the information is not refreshed then it will be removed with a grace period after the expiration of the IP address's validity.
+     */
     @JsonProperty("ip")
     public String getIp() {
         return ip;
     }
 
+    /**
+     * ip is an IP address associated with the dnsName. The validity of the IP address expires after lastLookupTime + ttlSeconds. To refresh the information, a DNS lookup will be performed upon the expiration of the IP address's validity. If the information is not refreshed then it will be removed with a grace period after the expiration of the IP address's validity.
+     */
     @JsonProperty("ip")
     public void setIp(String ip) {
         this.ip = ip;
     }
 
+    /**
+     * DNSNameResolverResolvedAddress describes the details of an IP address for a resolved DNS name.
+     */
     @JsonProperty("lastLookupTime")
     public String getLastLookupTime() {
         return lastLookupTime;
     }
 
+    /**
+     * DNSNameResolverResolvedAddress describes the details of an IP address for a resolved DNS name.
+     */
     @JsonProperty("lastLookupTime")
     public void setLastLookupTime(String lastLookupTime) {
         this.lastLookupTime = lastLookupTime;
     }
 
+    /**
+     * ttlSeconds is the time-to-live value of the IP address. The validity of the IP address expires after lastLookupTime + ttlSeconds. On a successful DNS lookup the value of this field will be updated with the current time-to-live value. If the information is not refreshed then it will be removed with a grace period after the expiration of the IP address's validity.
+     */
     @JsonProperty("ttlSeconds")
     public Integer getTtlSeconds() {
         return ttlSeconds;
     }
 
+    /**
+     * ttlSeconds is the time-to-live value of the IP address. The validity of the IP address expires after lastLookupTime + ttlSeconds. On a successful DNS lookup the value of this field will be updated with the current time-to-live value. If the information is not refreshed then it will be removed with a grace period after the expiration of the IP address's validity.
+     */
     @JsonProperty("ttlSeconds")
     public void setTtlSeconds(Integer ttlSeconds) {
         this.ttlSeconds = ttlSeconds;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1alpha1/DNSNameResolverResolvedName.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1alpha1/DNSNameResolverResolvedName.java
index 9de580d25a4..b8b42443b70 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1alpha1/DNSNameResolverResolvedName.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1alpha1/DNSNameResolverResolvedName.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSNameResolverResolvedName describes the details of a resolved DNS name.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,43 +98,67 @@ public DNSNameResolverResolvedName(List<Condition> conditions, String dnsName, I
         this.resolvedAddresses = resolvedAddresses;
     }
 
+    /**
+     * conditions provide information about the state of the DNS name. Known .status.conditions.type is: "Degraded". "Degraded" is true when the last resolution failed for the DNS name, and false otherwise.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions provide information about the state of the DNS name. Known .status.conditions.type is: "Degraded". "Degraded" is true when the last resolution failed for the DNS name, and false otherwise.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * dnsName is the resolved DNS name matching the name field of DNSNameResolverSpec. This field can store both regular and wildcard DNS names which match the spec.name field. When the spec.name field contains a regular DNS name, this field will store the same regular DNS name after it is successfully resolved. When the spec.name field contains a wildcard DNS name, each resolvedName.dnsName will store the regular DNS names which match the wildcard DNS name and have been successfully resolved. If the wildcard DNS name can also be successfully resolved, then this field will store the wildcard DNS name as well.
+     */
     @JsonProperty("dnsName")
     public String getDnsName() {
         return dnsName;
     }
 
+    /**
+     * dnsName is the resolved DNS name matching the name field of DNSNameResolverSpec. This field can store both regular and wildcard DNS names which match the spec.name field. When the spec.name field contains a regular DNS name, this field will store the same regular DNS name after it is successfully resolved. When the spec.name field contains a wildcard DNS name, each resolvedName.dnsName will store the regular DNS names which match the wildcard DNS name and have been successfully resolved. If the wildcard DNS name can also be successfully resolved, then this field will store the wildcard DNS name as well.
+     */
     @JsonProperty("dnsName")
     public void setDnsName(String dnsName) {
         this.dnsName = dnsName;
     }
 
+    /**
+     * resolutionFailures keeps the count of how many consecutive times the DNS resolution failed for the dnsName. If the DNS resolution succeeds then the field will be set to zero. Upon every failure, the value of the field will be incremented by one. The details about the DNS name will be removed, if the value of resolutionFailures reaches 5 and the TTL of all the associated IP addresses have expired.
+     */
     @JsonProperty("resolutionFailures")
     public Integer getResolutionFailures() {
         return resolutionFailures;
     }
 
+    /**
+     * resolutionFailures keeps the count of how many consecutive times the DNS resolution failed for the dnsName. If the DNS resolution succeeds then the field will be set to zero. Upon every failure, the value of the field will be incremented by one. The details about the DNS name will be removed, if the value of resolutionFailures reaches 5 and the TTL of all the associated IP addresses have expired.
+     */
     @JsonProperty("resolutionFailures")
     public void setResolutionFailures(Integer resolutionFailures) {
         this.resolutionFailures = resolutionFailures;
     }
 
+    /**
+     * resolvedAddresses gives the list of associated IP addresses and their corresponding TTLs and last lookup times for the dnsName.
+     */
     @JsonProperty("resolvedAddresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DNSNameResolverResolvedAddress> getResolvedAddresses() {
         return resolvedAddresses;
     }
 
+    /**
+     * resolvedAddresses gives the list of associated IP addresses and their corresponding TTLs and last lookup times for the dnsName.
+     */
     @JsonProperty("resolvedAddresses")
     public void setResolvedAddresses(List<DNSNameResolverResolvedAddress> resolvedAddresses) {
         this.resolvedAddresses = resolvedAddresses;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1alpha1/DNSNameResolverSpec.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1alpha1/DNSNameResolverSpec.java
index 52466ec6938..5d0542bc410 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1alpha1/DNSNameResolverSpec.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1alpha1/DNSNameResolverSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSNameResolverSpec is a desired state description of DNSNameResolver.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public DNSNameResolverSpec(String name) {
         this.name = name;
     }
 
+    /**
+     * name is the DNS name for which the DNS name resolution information will be stored. For a regular DNS name, only the DNS name resolution information of the regular DNS name will be stored. For a wildcard DNS name, the DNS name resolution information of all the DNS names that match the wildcard DNS name will be stored. For a wildcard DNS name, the '&#42;' will match only one label. Additionally, only a single '&#42;' can be used at the beginning of the wildcard DNS name. For example, '&#42;.example.com.' will match 'sub1.example.com.' but won't match 'sub2.sub1.example.com.'
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the DNS name for which the DNS name resolution information will be stored. For a regular DNS name, only the DNS name resolution information of the regular DNS name will be stored. For a wildcard DNS name, the DNS name resolution information of all the DNS names that match the wildcard DNS name will be stored. For a wildcard DNS name, the '&#42;' will match only one label. Additionally, only a single '&#42;' can be used at the beginning of the wildcard DNS name. For example, '&#42;.example.com.' will match 'sub1.example.com.' but won't match 'sub2.sub1.example.com.'
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1alpha1/DNSNameResolverStatus.java b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1alpha1/DNSNameResolverStatus.java
index ffb1d275b33..e3e1ccc8fc5 100644
--- a/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1alpha1/DNSNameResolverStatus.java
+++ b/kubernetes-model-generator/openshift-model-miscellaneous/src/generated/java/io/fabric8/openshift/api/model/miscellaneous/network/v1alpha1/DNSNameResolverStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSNameResolverStatus defines the observed status of DNSNameResolver.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public DNSNameResolverStatus(List<DNSNameResolverResolvedName> resolvedNames) {
         this.resolvedNames = resolvedNames;
     }
 
+    /**
+     * resolvedNames contains a list of matching DNS names and their corresponding IP addresses along with their TTL and last DNS lookup times.
+     */
     @JsonProperty("resolvedNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DNSNameResolverResolvedName> getResolvedNames() {
         return resolvedNames;
     }
 
+    /**
+     * resolvedNames contains a list of matching DNS names and their corresponding IP addresses along with their TTL and last DNS lookup times.
+     */
     @JsonProperty("resolvedNames")
     public void setResolvedNames(List<DNSNameResolverResolvedName> resolvedNames) {
         this.resolvedNames = resolvedNames;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/APIServerConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/APIServerConfig.java
index 6aa8592214a..d441bc37d6d 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/APIServerConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/APIServerConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * APIServerConfig defines how the Prometheus server connects to the Kubernetes API server.<br><p> <br><p> More info: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kubernetes_sd_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public APIServerConfig(Authorization authorization, BasicAuth basicAuth, String
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * APIServerConfig defines how the Prometheus server connects to the Kubernetes API server.<br><p> <br><p> More info: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kubernetes_sd_config
+     */
     @JsonProperty("authorization")
     public Authorization getAuthorization() {
         return authorization;
     }
 
+    /**
+     * APIServerConfig defines how the Prometheus server connects to the Kubernetes API server.<br><p> <br><p> More info: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kubernetes_sd_config
+     */
     @JsonProperty("authorization")
     public void setAuthorization(Authorization authorization) {
         this.authorization = authorization;
     }
 
+    /**
+     * APIServerConfig defines how the Prometheus server connects to the Kubernetes API server.<br><p> <br><p> More info: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kubernetes_sd_config
+     */
     @JsonProperty("basicAuth")
     public BasicAuth getBasicAuth() {
         return basicAuth;
     }
 
+    /**
+     * APIServerConfig defines how the Prometheus server connects to the Kubernetes API server.<br><p> <br><p> More info: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kubernetes_sd_config
+     */
     @JsonProperty("basicAuth")
     public void setBasicAuth(BasicAuth basicAuth) {
         this.basicAuth = basicAuth;
     }
 
+    /**
+     * &#42;Warning: this field shouldn't be used because the token value appears in clear-text. Prefer using `authorization`.&#42;<br><p> <br><p> Deprecated: this will be removed in a future release.
+     */
     @JsonProperty("bearerToken")
     public String getBearerToken() {
         return bearerToken;
     }
 
+    /**
+     * &#42;Warning: this field shouldn't be used because the token value appears in clear-text. Prefer using `authorization`.&#42;<br><p> <br><p> Deprecated: this will be removed in a future release.
+     */
     @JsonProperty("bearerToken")
     public void setBearerToken(String bearerToken) {
         this.bearerToken = bearerToken;
     }
 
+    /**
+     * File to read bearer token for accessing apiserver.<br><p> <br><p> Cannot be set at the same time as `basicAuth`, `authorization`, or `bearerToken`.<br><p> <br><p> Deprecated: this will be removed in a future release. Prefer using `authorization`.
+     */
     @JsonProperty("bearerTokenFile")
     public String getBearerTokenFile() {
         return bearerTokenFile;
     }
 
+    /**
+     * File to read bearer token for accessing apiserver.<br><p> <br><p> Cannot be set at the same time as `basicAuth`, `authorization`, or `bearerToken`.<br><p> <br><p> Deprecated: this will be removed in a future release. Prefer using `authorization`.
+     */
     @JsonProperty("bearerTokenFile")
     public void setBearerTokenFile(String bearerTokenFile) {
         this.bearerTokenFile = bearerTokenFile;
     }
 
+    /**
+     * Kubernetes API address consisting of a hostname or IP address followed by an optional port number.
+     */
     @JsonProperty("host")
     public String getHost() {
         return host;
     }
 
+    /**
+     * Kubernetes API address consisting of a hostname or IP address followed by an optional port number.
+     */
     @JsonProperty("host")
     public void setHost(String host) {
         this.host = host;
     }
 
+    /**
+     * APIServerConfig defines how the Prometheus server connects to the Kubernetes API server.<br><p> <br><p> More info: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kubernetes_sd_config
+     */
     @JsonProperty("tlsConfig")
     public TLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * APIServerConfig defines how the Prometheus server connects to the Kubernetes API server.<br><p> <br><p> More info: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kubernetes_sd_config
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(TLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertRelabelConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertRelabelConfig.java
index 39a7ace5a11..54b05347763 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertRelabelConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertRelabelConfig.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AlertRelabelConfig defines a set of relabel configs for alerts.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class AlertRelabelConfig implements Editable<AlertRelabelConfigBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "monitoring.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AlertRelabelConfig";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public AlertRelabelConfig(String apiVersion, String kind, ObjectMeta metadata, A
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AlertRelabelConfig defines a set of relabel configs for alerts.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AlertRelabelConfig defines a set of relabel configs for alerts.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * AlertRelabelConfig defines a set of relabel configs for alerts.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public AlertRelabelConfigSpec getSpec() {
         return spec;
     }
 
+    /**
+     * AlertRelabelConfig defines a set of relabel configs for alerts.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(AlertRelabelConfigSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * AlertRelabelConfig defines a set of relabel configs for alerts.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public AlertRelabelConfigStatus getStatus() {
         return status;
     }
 
+    /**
+     * AlertRelabelConfig defines a set of relabel configs for alerts.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(AlertRelabelConfigStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertRelabelConfigList.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertRelabelConfigList.java
index 137cb45ea16..658ecaaf701 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertRelabelConfigList.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertRelabelConfigList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AlertRelabelConfigList is a list of AlertRelabelConfigs.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class AlertRelabelConfigList implements Editable<AlertRelabelConfigListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.monitoring.v1.AlertRelabelConfig>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "monitoring.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.monitoring.v1.AlertRelabelConfig> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AlertRelabelConfigList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public AlertRelabelConfigList(String apiVersion, List<io.fabric8.openshift.api.m
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is a list of AlertRelabelConfigs.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.monitoring.v1.AlertRelabelConfig> getItems() {
         return items;
     }
 
+    /**
+     * items is a list of AlertRelabelConfigs.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.monitoring.v1.AlertRelabelConfig> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AlertRelabelConfigList is a list of AlertRelabelConfigs.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AlertRelabelConfigList is a list of AlertRelabelConfigs.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertRelabelConfigSpec.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertRelabelConfigSpec.java
index d7d60374e25..f1d14fc6234 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertRelabelConfigSpec.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertRelabelConfigSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AlertRelabelConfigsSpec is the desired state of an AlertRelabelConfig resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public AlertRelabelConfigSpec(List<RelabelConfig> configs) {
         this.configs = configs;
     }
 
+    /**
+     * configs is a list of sequentially evaluated alert relabel configs.
+     */
     @JsonProperty("configs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RelabelConfig> getConfigs() {
         return configs;
     }
 
+    /**
+     * configs is a list of sequentially evaluated alert relabel configs.
+     */
     @JsonProperty("configs")
     public void setConfigs(List<RelabelConfig> configs) {
         this.configs = configs;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertRelabelConfigStatus.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertRelabelConfigStatus.java
index 0d8840ce0dd..46ef559ead3 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertRelabelConfigStatus.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertRelabelConfigStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AlertRelabelConfigStatus is the status of an AlertRelabelConfig resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,12 +85,18 @@ public AlertRelabelConfigStatus(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * conditions contains details on the state of the AlertRelabelConfig, may be empty.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions contains details on the state of the AlertRelabelConfig, may be empty.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertingRule.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertingRule.java
index 3612d874927..cd21c4460cf 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertingRule.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertingRule.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AlertingRule represents a set of user-defined Prometheus rule groups containing alerting rules.  This resource is the supported method for cluster admins to create alerts based on metrics recorded by the platform monitoring stack in OpenShift, i.e. the Prometheus instance deployed to the openshift-monitoring namespace.  You might use this to create custom alerting rules not shipped with OpenShift based on metrics from components such as the node_exporter, which provides machine-level metrics such as CPU usage, or kube-state-metrics, which provides metrics on Kubernetes usage.<br><p> <br><p> The API is mostly compatible with the upstream PrometheusRule type from the prometheus-operator.  The primary difference being that recording rules are not allowed here -- only alerting rules.  For each AlertingRule resource created, a corresponding PrometheusRule will be created in the openshift-monitoring namespace.  OpenShift requires admins to use the AlertingRule resource rather than the upstream type in order to allow better OpenShift specific defaulting and validation, while not modifying the upstream APIs directly.<br><p> <br><p> You can find upstream API documentation for PrometheusRule resources here:<br><p> <br><p> https://github.com/prometheus-operator/prometheus-operator/blob/main/Documentation/api.md<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class AlertingRule implements Editable<AlertingRuleBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "monitoring.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AlertingRule";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public AlertingRule(String apiVersion, String kind, ObjectMeta metadata, Alertin
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AlertingRule represents a set of user-defined Prometheus rule groups containing alerting rules.  This resource is the supported method for cluster admins to create alerts based on metrics recorded by the platform monitoring stack in OpenShift, i.e. the Prometheus instance deployed to the openshift-monitoring namespace.  You might use this to create custom alerting rules not shipped with OpenShift based on metrics from components such as the node_exporter, which provides machine-level metrics such as CPU usage, or kube-state-metrics, which provides metrics on Kubernetes usage.<br><p> <br><p> The API is mostly compatible with the upstream PrometheusRule type from the prometheus-operator.  The primary difference being that recording rules are not allowed here -- only alerting rules.  For each AlertingRule resource created, a corresponding PrometheusRule will be created in the openshift-monitoring namespace.  OpenShift requires admins to use the AlertingRule resource rather than the upstream type in order to allow better OpenShift specific defaulting and validation, while not modifying the upstream APIs directly.<br><p> <br><p> You can find upstream API documentation for PrometheusRule resources here:<br><p> <br><p> https://github.com/prometheus-operator/prometheus-operator/blob/main/Documentation/api.md<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AlertingRule represents a set of user-defined Prometheus rule groups containing alerting rules.  This resource is the supported method for cluster admins to create alerts based on metrics recorded by the platform monitoring stack in OpenShift, i.e. the Prometheus instance deployed to the openshift-monitoring namespace.  You might use this to create custom alerting rules not shipped with OpenShift based on metrics from components such as the node_exporter, which provides machine-level metrics such as CPU usage, or kube-state-metrics, which provides metrics on Kubernetes usage.<br><p> <br><p> The API is mostly compatible with the upstream PrometheusRule type from the prometheus-operator.  The primary difference being that recording rules are not allowed here -- only alerting rules.  For each AlertingRule resource created, a corresponding PrometheusRule will be created in the openshift-monitoring namespace.  OpenShift requires admins to use the AlertingRule resource rather than the upstream type in order to allow better OpenShift specific defaulting and validation, while not modifying the upstream APIs directly.<br><p> <br><p> You can find upstream API documentation for PrometheusRule resources here:<br><p> <br><p> https://github.com/prometheus-operator/prometheus-operator/blob/main/Documentation/api.md<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * AlertingRule represents a set of user-defined Prometheus rule groups containing alerting rules.  This resource is the supported method for cluster admins to create alerts based on metrics recorded by the platform monitoring stack in OpenShift, i.e. the Prometheus instance deployed to the openshift-monitoring namespace.  You might use this to create custom alerting rules not shipped with OpenShift based on metrics from components such as the node_exporter, which provides machine-level metrics such as CPU usage, or kube-state-metrics, which provides metrics on Kubernetes usage.<br><p> <br><p> The API is mostly compatible with the upstream PrometheusRule type from the prometheus-operator.  The primary difference being that recording rules are not allowed here -- only alerting rules.  For each AlertingRule resource created, a corresponding PrometheusRule will be created in the openshift-monitoring namespace.  OpenShift requires admins to use the AlertingRule resource rather than the upstream type in order to allow better OpenShift specific defaulting and validation, while not modifying the upstream APIs directly.<br><p> <br><p> You can find upstream API documentation for PrometheusRule resources here:<br><p> <br><p> https://github.com/prometheus-operator/prometheus-operator/blob/main/Documentation/api.md<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public AlertingRuleSpec getSpec() {
         return spec;
     }
 
+    /**
+     * AlertingRule represents a set of user-defined Prometheus rule groups containing alerting rules.  This resource is the supported method for cluster admins to create alerts based on metrics recorded by the platform monitoring stack in OpenShift, i.e. the Prometheus instance deployed to the openshift-monitoring namespace.  You might use this to create custom alerting rules not shipped with OpenShift based on metrics from components such as the node_exporter, which provides machine-level metrics such as CPU usage, or kube-state-metrics, which provides metrics on Kubernetes usage.<br><p> <br><p> The API is mostly compatible with the upstream PrometheusRule type from the prometheus-operator.  The primary difference being that recording rules are not allowed here -- only alerting rules.  For each AlertingRule resource created, a corresponding PrometheusRule will be created in the openshift-monitoring namespace.  OpenShift requires admins to use the AlertingRule resource rather than the upstream type in order to allow better OpenShift specific defaulting and validation, while not modifying the upstream APIs directly.<br><p> <br><p> You can find upstream API documentation for PrometheusRule resources here:<br><p> <br><p> https://github.com/prometheus-operator/prometheus-operator/blob/main/Documentation/api.md<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(AlertingRuleSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * AlertingRule represents a set of user-defined Prometheus rule groups containing alerting rules.  This resource is the supported method for cluster admins to create alerts based on metrics recorded by the platform monitoring stack in OpenShift, i.e. the Prometheus instance deployed to the openshift-monitoring namespace.  You might use this to create custom alerting rules not shipped with OpenShift based on metrics from components such as the node_exporter, which provides machine-level metrics such as CPU usage, or kube-state-metrics, which provides metrics on Kubernetes usage.<br><p> <br><p> The API is mostly compatible with the upstream PrometheusRule type from the prometheus-operator.  The primary difference being that recording rules are not allowed here -- only alerting rules.  For each AlertingRule resource created, a corresponding PrometheusRule will be created in the openshift-monitoring namespace.  OpenShift requires admins to use the AlertingRule resource rather than the upstream type in order to allow better OpenShift specific defaulting and validation, while not modifying the upstream APIs directly.<br><p> <br><p> You can find upstream API documentation for PrometheusRule resources here:<br><p> <br><p> https://github.com/prometheus-operator/prometheus-operator/blob/main/Documentation/api.md<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public AlertingRuleStatus getStatus() {
         return status;
     }
 
+    /**
+     * AlertingRule represents a set of user-defined Prometheus rule groups containing alerting rules.  This resource is the supported method for cluster admins to create alerts based on metrics recorded by the platform monitoring stack in OpenShift, i.e. the Prometheus instance deployed to the openshift-monitoring namespace.  You might use this to create custom alerting rules not shipped with OpenShift based on metrics from components such as the node_exporter, which provides machine-level metrics such as CPU usage, or kube-state-metrics, which provides metrics on Kubernetes usage.<br><p> <br><p> The API is mostly compatible with the upstream PrometheusRule type from the prometheus-operator.  The primary difference being that recording rules are not allowed here -- only alerting rules.  For each AlertingRule resource created, a corresponding PrometheusRule will be created in the openshift-monitoring namespace.  OpenShift requires admins to use the AlertingRule resource rather than the upstream type in order to allow better OpenShift specific defaulting and validation, while not modifying the upstream APIs directly.<br><p> <br><p> You can find upstream API documentation for PrometheusRule resources here:<br><p> <br><p> https://github.com/prometheus-operator/prometheus-operator/blob/main/Documentation/api.md<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(AlertingRuleStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertingRuleList.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertingRuleList.java
index 3e4df513ec2..9b227ec3cd7 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertingRuleList.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertingRuleList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AlertingRuleList is a list of AlertingRule objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class AlertingRuleList implements Editable<AlertingRuleListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.monitoring.v1.AlertingRule>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "monitoring.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.monitoring.v1.AlertingRule> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AlertingRuleList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public AlertingRuleList(String apiVersion, List<io.fabric8.openshift.api.model.m
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is a list of AlertingRule objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.monitoring.v1.AlertingRule> getItems() {
         return items;
     }
 
+    /**
+     * items is a list of AlertingRule objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.monitoring.v1.AlertingRule> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AlertingRuleList is a list of AlertingRule objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AlertingRuleList is a list of AlertingRule objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertingRuleSpec.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertingRuleSpec.java
index bf3c37fcb5b..fcdb5bb70ec 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertingRuleSpec.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertingRuleSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AlertingRuleSpec is the desired state of an AlertingRule resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public AlertingRuleSpec(List<RuleGroup> groups) {
         this.groups = groups;
     }
 
+    /**
+     * groups is a list of grouped alerting rules.  Rule groups are the unit at which Prometheus parallelizes rule processing.  All rules in a single group share a configured evaluation interval.  All rules in the group will be processed together on this interval, sequentially, and all rules will be processed.<br><p> <br><p> It's common to group related alerting rules into a single AlertingRule resources, and within that resource, closely related alerts, or simply alerts with the same interval, into individual groups.  You are also free to create AlertingRule resources with only a single rule group, but be aware that this can have a performance impact on Prometheus if the group is extremely large or has very complex query expressions to evaluate. Spreading very complex rules across multiple groups to allow them to be processed in parallel is also a common use-case.
+     */
     @JsonProperty("groups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RuleGroup> getGroups() {
         return groups;
     }
 
+    /**
+     * groups is a list of grouped alerting rules.  Rule groups are the unit at which Prometheus parallelizes rule processing.  All rules in a single group share a configured evaluation interval.  All rules in the group will be processed together on this interval, sequentially, and all rules will be processed.<br><p> <br><p> It's common to group related alerting rules into a single AlertingRule resources, and within that resource, closely related alerts, or simply alerts with the same interval, into individual groups.  You are also free to create AlertingRule resources with only a single rule group, but be aware that this can have a performance impact on Prometheus if the group is extremely large or has very complex query expressions to evaluate. Spreading very complex rules across multiple groups to allow them to be processed in parallel is also a common use-case.
+     */
     @JsonProperty("groups")
     public void setGroups(List<RuleGroup> groups) {
         this.groups = groups;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertingRuleStatus.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertingRuleStatus.java
index 89e34af6a00..90936b1df4d 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertingRuleStatus.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertingRuleStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AlertingRuleStatus is the status of an AlertingRule resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public AlertingRuleStatus(Long observedGeneration, PrometheusRuleRef prometheusR
         this.prometheusRule = prometheusRule;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * AlertingRuleStatus is the status of an AlertingRule resource.
+     */
     @JsonProperty("prometheusRule")
     public PrometheusRuleRef getPrometheusRule() {
         return prometheusRule;
     }
 
+    /**
+     * AlertingRuleStatus is the status of an AlertingRule resource.
+     */
     @JsonProperty("prometheusRule")
     public void setPrometheusRule(PrometheusRuleRef prometheusRule) {
         this.prometheusRule = prometheusRule;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertingSpec.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertingSpec.java
index cc958c53edf..f7ed5f84af1 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertingSpec.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertingSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AlertingSpec defines parameters for alerting configuration of Prometheus servers.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public AlertingSpec(List<AlertmanagerEndpoints> alertmanagers) {
         this.alertmanagers = alertmanagers;
     }
 
+    /**
+     * Alertmanager endpoints where Prometheus should send alerts to.
+     */
     @JsonProperty("alertmanagers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AlertmanagerEndpoints> getAlertmanagers() {
         return alertmanagers;
     }
 
+    /**
+     * Alertmanager endpoints where Prometheus should send alerts to.
+     */
     @JsonProperty("alertmanagers")
     public void setAlertmanagers(List<AlertmanagerEndpoints> alertmanagers) {
         this.alertmanagers = alertmanagers;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Alertmanager.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Alertmanager.java
index f62c0c8e440..8be723c66a0 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Alertmanager.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Alertmanager.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * The `Alertmanager` custom resource definition (CRD) defines a desired [Alertmanager](https://prometheus.io/docs/alerting) setup to run in a Kubernetes cluster. It allows to specify many options such as the number of replicas, persistent storage and many more.<br><p> <br><p> For each `Alertmanager` resource, the Operator deploys a `StatefulSet` in the same namespace. When there are two or more configured replicas, the Operator runs the Alertmanager instances in high-availability mode.<br><p> <br><p> The resource defines via label and namespace selectors which `AlertmanagerConfig` objects should be associated to the deployed Alertmanager instances.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Alertmanager implements Editable<AlertmanagerBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "monitoring.coreos.com/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Alertmanager";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Alertmanager(String apiVersion, String kind, ObjectMeta metadata, Alertma
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * The `Alertmanager` custom resource definition (CRD) defines a desired [Alertmanager](https://prometheus.io/docs/alerting) setup to run in a Kubernetes cluster. It allows to specify many options such as the number of replicas, persistent storage and many more.<br><p> <br><p> For each `Alertmanager` resource, the Operator deploys a `StatefulSet` in the same namespace. When there are two or more configured replicas, the Operator runs the Alertmanager instances in high-availability mode.<br><p> <br><p> The resource defines via label and namespace selectors which `AlertmanagerConfig` objects should be associated to the deployed Alertmanager instances.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * The `Alertmanager` custom resource definition (CRD) defines a desired [Alertmanager](https://prometheus.io/docs/alerting) setup to run in a Kubernetes cluster. It allows to specify many options such as the number of replicas, persistent storage and many more.<br><p> <br><p> For each `Alertmanager` resource, the Operator deploys a `StatefulSet` in the same namespace. When there are two or more configured replicas, the Operator runs the Alertmanager instances in high-availability mode.<br><p> <br><p> The resource defines via label and namespace selectors which `AlertmanagerConfig` objects should be associated to the deployed Alertmanager instances.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * The `Alertmanager` custom resource definition (CRD) defines a desired [Alertmanager](https://prometheus.io/docs/alerting) setup to run in a Kubernetes cluster. It allows to specify many options such as the number of replicas, persistent storage and many more.<br><p> <br><p> For each `Alertmanager` resource, the Operator deploys a `StatefulSet` in the same namespace. When there are two or more configured replicas, the Operator runs the Alertmanager instances in high-availability mode.<br><p> <br><p> The resource defines via label and namespace selectors which `AlertmanagerConfig` objects should be associated to the deployed Alertmanager instances.
+     */
     @JsonProperty("spec")
     public AlertmanagerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * The `Alertmanager` custom resource definition (CRD) defines a desired [Alertmanager](https://prometheus.io/docs/alerting) setup to run in a Kubernetes cluster. It allows to specify many options such as the number of replicas, persistent storage and many more.<br><p> <br><p> For each `Alertmanager` resource, the Operator deploys a `StatefulSet` in the same namespace. When there are two or more configured replicas, the Operator runs the Alertmanager instances in high-availability mode.<br><p> <br><p> The resource defines via label and namespace selectors which `AlertmanagerConfig` objects should be associated to the deployed Alertmanager instances.
+     */
     @JsonProperty("spec")
     public void setSpec(AlertmanagerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * The `Alertmanager` custom resource definition (CRD) defines a desired [Alertmanager](https://prometheus.io/docs/alerting) setup to run in a Kubernetes cluster. It allows to specify many options such as the number of replicas, persistent storage and many more.<br><p> <br><p> For each `Alertmanager` resource, the Operator deploys a `StatefulSet` in the same namespace. When there are two or more configured replicas, the Operator runs the Alertmanager instances in high-availability mode.<br><p> <br><p> The resource defines via label and namespace selectors which `AlertmanagerConfig` objects should be associated to the deployed Alertmanager instances.
+     */
     @JsonProperty("status")
     public AlertmanagerStatus getStatus() {
         return status;
     }
 
+    /**
+     * The `Alertmanager` custom resource definition (CRD) defines a desired [Alertmanager](https://prometheus.io/docs/alerting) setup to run in a Kubernetes cluster. It allows to specify many options such as the number of replicas, persistent storage and many more.<br><p> <br><p> For each `Alertmanager` resource, the Operator deploys a `StatefulSet` in the same namespace. When there are two or more configured replicas, the Operator runs the Alertmanager instances in high-availability mode.<br><p> <br><p> The resource defines via label and namespace selectors which `AlertmanagerConfig` objects should be associated to the deployed Alertmanager instances.
+     */
     @JsonProperty("status")
     public void setStatus(AlertmanagerStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerConfigMatcherStrategy.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerConfigMatcherStrategy.java
index 010c2c28aa8..60bd3a0a5f5 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerConfigMatcherStrategy.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerConfigMatcherStrategy.java
@@ -78,11 +78,17 @@ public AlertmanagerConfigMatcherStrategy(String type) {
         this.type = type;
     }
 
+    /**
+     * AlertmanagerConfigMatcherStrategyType defines the strategy used by AlertmanagerConfig objects to match alerts in the routes and inhibition rules.<br><p> <br><p> The default value is `OnNamespace`.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * AlertmanagerConfigMatcherStrategyType defines the strategy used by AlertmanagerConfig objects to match alerts in the routes and inhibition rules.<br><p> <br><p> The default value is `OnNamespace`.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerConfiguration.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerConfiguration.java
index e8782355f38..b382fe6a749 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerConfiguration.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerConfiguration.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AlertmanagerConfiguration defines the Alertmanager configuration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public AlertmanagerConfiguration(AlertmanagerGlobalConfig global, String name, L
         this.templates = templates;
     }
 
+    /**
+     * AlertmanagerConfiguration defines the Alertmanager configuration.
+     */
     @JsonProperty("global")
     public AlertmanagerGlobalConfig getGlobal() {
         return global;
     }
 
+    /**
+     * AlertmanagerConfiguration defines the Alertmanager configuration.
+     */
     @JsonProperty("global")
     public void setGlobal(AlertmanagerGlobalConfig global) {
         this.global = global;
     }
 
+    /**
+     * The name of the AlertmanagerConfig resource which is used to generate the Alertmanager configuration. It must be defined in the same namespace as the Alertmanager object. The operator will not enforce a `namespace` label for routes and inhibition rules.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The name of the AlertmanagerConfig resource which is used to generate the Alertmanager configuration. It must be defined in the same namespace as the Alertmanager object. The operator will not enforce a `namespace` label for routes and inhibition rules.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Custom notification templates.
+     */
     @JsonProperty("templates")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SecretOrConfigMap> getTemplates() {
         return templates;
     }
 
+    /**
+     * Custom notification templates.
+     */
     @JsonProperty("templates")
     public void setTemplates(List<SecretOrConfigMap> templates) {
         this.templates = templates;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerEndpoints.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerEndpoints.java
index f6106153893..53018cf209e 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerEndpoints.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerEndpoints.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AlertmanagerEndpoints defines a selection of a single Endpoints object containing Alertmanager IPs to fire alerts against.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -156,194 +159,308 @@ public AlertmanagerEndpoints(List<RelabelConfig> alertRelabelings, String apiVer
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * Relabeling configs applied before sending alerts to a specific Alertmanager. It requires Prometheus &gt;= v2.51.0.
+     */
     @JsonProperty("alertRelabelings")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RelabelConfig> getAlertRelabelings() {
         return alertRelabelings;
     }
 
+    /**
+     * Relabeling configs applied before sending alerts to a specific Alertmanager. It requires Prometheus &gt;= v2.51.0.
+     */
     @JsonProperty("alertRelabelings")
     public void setAlertRelabelings(List<RelabelConfig> alertRelabelings) {
         this.alertRelabelings = alertRelabelings;
     }
 
+    /**
+     * Version of the Alertmanager API that Prometheus uses to send alerts. It can be "V1" or "V2". The field has no effect for Prometheus &gt;= v3.0.0 because only the v2 API is supported.
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * Version of the Alertmanager API that Prometheus uses to send alerts. It can be "V1" or "V2". The field has no effect for Prometheus &gt;= v3.0.0 because only the v2 API is supported.
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * AlertmanagerEndpoints defines a selection of a single Endpoints object containing Alertmanager IPs to fire alerts against.
+     */
     @JsonProperty("authorization")
     public SafeAuthorization getAuthorization() {
         return authorization;
     }
 
+    /**
+     * AlertmanagerEndpoints defines a selection of a single Endpoints object containing Alertmanager IPs to fire alerts against.
+     */
     @JsonProperty("authorization")
     public void setAuthorization(SafeAuthorization authorization) {
         this.authorization = authorization;
     }
 
+    /**
+     * AlertmanagerEndpoints defines a selection of a single Endpoints object containing Alertmanager IPs to fire alerts against.
+     */
     @JsonProperty("basicAuth")
     public BasicAuth getBasicAuth() {
         return basicAuth;
     }
 
+    /**
+     * AlertmanagerEndpoints defines a selection of a single Endpoints object containing Alertmanager IPs to fire alerts against.
+     */
     @JsonProperty("basicAuth")
     public void setBasicAuth(BasicAuth basicAuth) {
         this.basicAuth = basicAuth;
     }
 
+    /**
+     * File to read bearer token for Alertmanager.<br><p> <br><p> Cannot be set at the same time as `basicAuth`, `authorization`, or `sigv4`.<br><p> <br><p> Deprecated: this will be removed in a future release. Prefer using `authorization`.
+     */
     @JsonProperty("bearerTokenFile")
     public String getBearerTokenFile() {
         return bearerTokenFile;
     }
 
+    /**
+     * File to read bearer token for Alertmanager.<br><p> <br><p> Cannot be set at the same time as `basicAuth`, `authorization`, or `sigv4`.<br><p> <br><p> Deprecated: this will be removed in a future release. Prefer using `authorization`.
+     */
     @JsonProperty("bearerTokenFile")
     public void setBearerTokenFile(String bearerTokenFile) {
         this.bearerTokenFile = bearerTokenFile;
     }
 
+    /**
+     * Whether to enable HTTP2.
+     */
     @JsonProperty("enableHttp2")
     public Boolean getEnableHttp2() {
         return enableHttp2;
     }
 
+    /**
+     * Whether to enable HTTP2.
+     */
     @JsonProperty("enableHttp2")
     public void setEnableHttp2(Boolean enableHttp2) {
         this.enableHttp2 = enableHttp2;
     }
 
+    /**
+     * Name of the Endpoints object in the namespace.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the Endpoints object in the namespace.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace of the Endpoints object.<br><p> <br><p> If not set, the object will be discovered in the namespace of the Prometheus object.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace of the Endpoints object.<br><p> <br><p> If not set, the object will be discovered in the namespace of the Prometheus object.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * Prefix for the HTTP path alerts are pushed to.
+     */
     @JsonProperty("pathPrefix")
     public String getPathPrefix() {
         return pathPrefix;
     }
 
+    /**
+     * Prefix for the HTTP path alerts are pushed to.
+     */
     @JsonProperty("pathPrefix")
     public void setPathPrefix(String pathPrefix) {
         this.pathPrefix = pathPrefix;
     }
 
+    /**
+     * AlertmanagerEndpoints defines a selection of a single Endpoints object containing Alertmanager IPs to fire alerts against.
+     */
     @JsonProperty("port")
     public IntOrString getPort() {
         return port;
     }
 
+    /**
+     * AlertmanagerEndpoints defines a selection of a single Endpoints object containing Alertmanager IPs to fire alerts against.
+     */
     @JsonProperty("port")
     public void setPort(IntOrString port) {
         this.port = port;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<SecretKeySelector>> getProxyConnectHeader() {
         return proxyConnectHeader;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     public void setProxyConnectHeader(Map<String, List<SecretKeySelector>> proxyConnectHeader) {
         this.proxyConnectHeader = proxyConnectHeader;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public Boolean getProxyFromEnvironment() {
         return proxyFromEnvironment;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public void setProxyFromEnvironment(Boolean proxyFromEnvironment) {
         this.proxyFromEnvironment = proxyFromEnvironment;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public String getProxyUrl() {
         return proxyUrl;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public void setProxyUrl(String proxyUrl) {
         this.proxyUrl = proxyUrl;
     }
 
+    /**
+     * Relabel configuration applied to the discovered Alertmanagers.
+     */
     @JsonProperty("relabelings")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RelabelConfig> getRelabelings() {
         return relabelings;
     }
 
+    /**
+     * Relabel configuration applied to the discovered Alertmanagers.
+     */
     @JsonProperty("relabelings")
     public void setRelabelings(List<RelabelConfig> relabelings) {
         this.relabelings = relabelings;
     }
 
+    /**
+     * Scheme to use when firing alerts.
+     */
     @JsonProperty("scheme")
     public String getScheme() {
         return scheme;
     }
 
+    /**
+     * Scheme to use when firing alerts.
+     */
     @JsonProperty("scheme")
     public void setScheme(String scheme) {
         this.scheme = scheme;
     }
 
+    /**
+     * AlertmanagerEndpoints defines a selection of a single Endpoints object containing Alertmanager IPs to fire alerts against.
+     */
     @JsonProperty("sigv4")
     public Sigv4 getSigv4() {
         return sigv4;
     }
 
+    /**
+     * AlertmanagerEndpoints defines a selection of a single Endpoints object containing Alertmanager IPs to fire alerts against.
+     */
     @JsonProperty("sigv4")
     public void setSigv4(Sigv4 sigv4) {
         this.sigv4 = sigv4;
     }
 
+    /**
+     * Timeout is a per-target Alertmanager timeout when pushing alerts.
+     */
     @JsonProperty("timeout")
     public String getTimeout() {
         return timeout;
     }
 
+    /**
+     * Timeout is a per-target Alertmanager timeout when pushing alerts.
+     */
     @JsonProperty("timeout")
     public void setTimeout(String timeout) {
         this.timeout = timeout;
     }
 
+    /**
+     * AlertmanagerEndpoints defines a selection of a single Endpoints object containing Alertmanager IPs to fire alerts against.
+     */
     @JsonProperty("tlsConfig")
     public TLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * AlertmanagerEndpoints defines a selection of a single Endpoints object containing Alertmanager IPs to fire alerts against.
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(TLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerGlobalConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerGlobalConfig.java
index ae126168afb..9971fcf4d62 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerGlobalConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerGlobalConfig.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AlertmanagerGlobalConfig configures parameters that are valid in all other configuration contexts. See https://prometheus.io/docs/alerting/latest/configuration/#configuration-file
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -103,71 +106,113 @@ public AlertmanagerGlobalConfig(HTTPConfig httpConfig, SecretKeySelector opsGeni
         this.smtp = smtp;
     }
 
+    /**
+     * AlertmanagerGlobalConfig configures parameters that are valid in all other configuration contexts. See https://prometheus.io/docs/alerting/latest/configuration/#configuration-file
+     */
     @JsonProperty("httpConfig")
     public HTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * AlertmanagerGlobalConfig configures parameters that are valid in all other configuration contexts. See https://prometheus.io/docs/alerting/latest/configuration/#configuration-file
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(HTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * AlertmanagerGlobalConfig configures parameters that are valid in all other configuration contexts. See https://prometheus.io/docs/alerting/latest/configuration/#configuration-file
+     */
     @JsonProperty("opsGenieApiKey")
     public SecretKeySelector getOpsGenieApiKey() {
         return opsGenieApiKey;
     }
 
+    /**
+     * AlertmanagerGlobalConfig configures parameters that are valid in all other configuration contexts. See https://prometheus.io/docs/alerting/latest/configuration/#configuration-file
+     */
     @JsonProperty("opsGenieApiKey")
     public void setOpsGenieApiKey(SecretKeySelector opsGenieApiKey) {
         this.opsGenieApiKey = opsGenieApiKey;
     }
 
+    /**
+     * AlertmanagerGlobalConfig configures parameters that are valid in all other configuration contexts. See https://prometheus.io/docs/alerting/latest/configuration/#configuration-file
+     */
     @JsonProperty("opsGenieApiUrl")
     public SecretKeySelector getOpsGenieApiUrl() {
         return opsGenieApiUrl;
     }
 
+    /**
+     * AlertmanagerGlobalConfig configures parameters that are valid in all other configuration contexts. See https://prometheus.io/docs/alerting/latest/configuration/#configuration-file
+     */
     @JsonProperty("opsGenieApiUrl")
     public void setOpsGenieApiUrl(SecretKeySelector opsGenieApiUrl) {
         this.opsGenieApiUrl = opsGenieApiUrl;
     }
 
+    /**
+     * The default Pagerduty URL.
+     */
     @JsonProperty("pagerdutyUrl")
     public String getPagerdutyUrl() {
         return pagerdutyUrl;
     }
 
+    /**
+     * The default Pagerduty URL.
+     */
     @JsonProperty("pagerdutyUrl")
     public void setPagerdutyUrl(String pagerdutyUrl) {
         this.pagerdutyUrl = pagerdutyUrl;
     }
 
+    /**
+     * ResolveTimeout is the default value used by alertmanager if the alert does not include EndsAt, after this time passes it can declare the alert as resolved if it has not been updated. This has no impact on alerts from Prometheus, as they always include EndsAt.
+     */
     @JsonProperty("resolveTimeout")
     public String getResolveTimeout() {
         return resolveTimeout;
     }
 
+    /**
+     * ResolveTimeout is the default value used by alertmanager if the alert does not include EndsAt, after this time passes it can declare the alert as resolved if it has not been updated. This has no impact on alerts from Prometheus, as they always include EndsAt.
+     */
     @JsonProperty("resolveTimeout")
     public void setResolveTimeout(String resolveTimeout) {
         this.resolveTimeout = resolveTimeout;
     }
 
+    /**
+     * AlertmanagerGlobalConfig configures parameters that are valid in all other configuration contexts. See https://prometheus.io/docs/alerting/latest/configuration/#configuration-file
+     */
     @JsonProperty("slackApiUrl")
     public SecretKeySelector getSlackApiUrl() {
         return slackApiUrl;
     }
 
+    /**
+     * AlertmanagerGlobalConfig configures parameters that are valid in all other configuration contexts. See https://prometheus.io/docs/alerting/latest/configuration/#configuration-file
+     */
     @JsonProperty("slackApiUrl")
     public void setSlackApiUrl(SecretKeySelector slackApiUrl) {
         this.slackApiUrl = slackApiUrl;
     }
 
+    /**
+     * AlertmanagerGlobalConfig configures parameters that are valid in all other configuration contexts. See https://prometheus.io/docs/alerting/latest/configuration/#configuration-file
+     */
     @JsonProperty("smtp")
     public GlobalSMTPConfig getSmtp() {
         return smtp;
     }
 
+    /**
+     * AlertmanagerGlobalConfig configures parameters that are valid in all other configuration contexts. See https://prometheus.io/docs/alerting/latest/configuration/#configuration-file
+     */
     @JsonProperty("smtp")
     public void setSmtp(GlobalSMTPConfig smtp) {
         this.smtp = smtp;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerList.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerList.java
index f87febfa5b0..196e985afaf 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerList.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AlertmanagerList is a list of Alertmanagers.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class AlertmanagerList implements Editable<AlertmanagerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.monitoring.v1.Alertmanager>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "monitoring.coreos.com/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.monitoring.v1.Alertmanager> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AlertmanagerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public AlertmanagerList(String apiVersion, List<io.fabric8.openshift.api.model.m
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of Alertmanagers
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.monitoring.v1.Alertmanager> getItems() {
         return items;
     }
 
+    /**
+     * List of Alertmanagers
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.monitoring.v1.Alertmanager> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AlertmanagerList is a list of Alertmanagers.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AlertmanagerList is a list of Alertmanagers.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerSpec.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerSpec.java
index 038475f711a..31faa0fce94 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerSpec.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerSpec.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AlertmanagerSpec is a specification of the desired behavior of the Alertmanager cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -302,534 +305,846 @@ public AlertmanagerSpec(List<String> additionalPeers, Affinity affinity, Alertma
         this.web = web;
     }
 
+    /**
+     * AdditionalPeers allows injecting a set of additional Alertmanagers to peer with to form a highly available cluster.
+     */
     @JsonProperty("additionalPeers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAdditionalPeers() {
         return additionalPeers;
     }
 
+    /**
+     * AdditionalPeers allows injecting a set of additional Alertmanagers to peer with to form a highly available cluster.
+     */
     @JsonProperty("additionalPeers")
     public void setAdditionalPeers(List<String> additionalPeers) {
         this.additionalPeers = additionalPeers;
     }
 
+    /**
+     * AlertmanagerSpec is a specification of the desired behavior of the Alertmanager cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("affinity")
     public Affinity getAffinity() {
         return affinity;
     }
 
+    /**
+     * AlertmanagerSpec is a specification of the desired behavior of the Alertmanager cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("affinity")
     public void setAffinity(Affinity affinity) {
         this.affinity = affinity;
     }
 
+    /**
+     * AlertmanagerSpec is a specification of the desired behavior of the Alertmanager cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("alertmanagerConfigMatcherStrategy")
     public AlertmanagerConfigMatcherStrategy getAlertmanagerConfigMatcherStrategy() {
         return alertmanagerConfigMatcherStrategy;
     }
 
+    /**
+     * AlertmanagerSpec is a specification of the desired behavior of the Alertmanager cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("alertmanagerConfigMatcherStrategy")
     public void setAlertmanagerConfigMatcherStrategy(AlertmanagerConfigMatcherStrategy alertmanagerConfigMatcherStrategy) {
         this.alertmanagerConfigMatcherStrategy = alertmanagerConfigMatcherStrategy;
     }
 
+    /**
+     * AlertmanagerSpec is a specification of the desired behavior of the Alertmanager cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("alertmanagerConfigNamespaceSelector")
     public LabelSelector getAlertmanagerConfigNamespaceSelector() {
         return alertmanagerConfigNamespaceSelector;
     }
 
+    /**
+     * AlertmanagerSpec is a specification of the desired behavior of the Alertmanager cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("alertmanagerConfigNamespaceSelector")
     public void setAlertmanagerConfigNamespaceSelector(LabelSelector alertmanagerConfigNamespaceSelector) {
         this.alertmanagerConfigNamespaceSelector = alertmanagerConfigNamespaceSelector;
     }
 
+    /**
+     * AlertmanagerSpec is a specification of the desired behavior of the Alertmanager cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("alertmanagerConfigSelector")
     public LabelSelector getAlertmanagerConfigSelector() {
         return alertmanagerConfigSelector;
     }
 
+    /**
+     * AlertmanagerSpec is a specification of the desired behavior of the Alertmanager cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("alertmanagerConfigSelector")
     public void setAlertmanagerConfigSelector(LabelSelector alertmanagerConfigSelector) {
         this.alertmanagerConfigSelector = alertmanagerConfigSelector;
     }
 
+    /**
+     * AlertmanagerSpec is a specification of the desired behavior of the Alertmanager cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("alertmanagerConfiguration")
     public AlertmanagerConfiguration getAlertmanagerConfiguration() {
         return alertmanagerConfiguration;
     }
 
+    /**
+     * AlertmanagerSpec is a specification of the desired behavior of the Alertmanager cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("alertmanagerConfiguration")
     public void setAlertmanagerConfiguration(AlertmanagerConfiguration alertmanagerConfiguration) {
         this.alertmanagerConfiguration = alertmanagerConfiguration;
     }
 
+    /**
+     * AutomountServiceAccountToken indicates whether a service account token should be automatically mounted in the pod. If the service account has `automountServiceAccountToken: true`, set the field to `false` to opt out of automounting API credentials.
+     */
     @JsonProperty("automountServiceAccountToken")
     public Boolean getAutomountServiceAccountToken() {
         return automountServiceAccountToken;
     }
 
+    /**
+     * AutomountServiceAccountToken indicates whether a service account token should be automatically mounted in the pod. If the service account has `automountServiceAccountToken: true`, set the field to `false` to opt out of automounting API credentials.
+     */
     @JsonProperty("automountServiceAccountToken")
     public void setAutomountServiceAccountToken(Boolean automountServiceAccountToken) {
         this.automountServiceAccountToken = automountServiceAccountToken;
     }
 
+    /**
+     * Base image that is used to deploy pods, without tag. Deprecated: use 'image' instead.
+     */
     @JsonProperty("baseImage")
     public String getBaseImage() {
         return baseImage;
     }
 
+    /**
+     * Base image that is used to deploy pods, without tag. Deprecated: use 'image' instead.
+     */
     @JsonProperty("baseImage")
     public void setBaseImage(String baseImage) {
         this.baseImage = baseImage;
     }
 
+    /**
+     * ClusterAdvertiseAddress is the explicit address to advertise in cluster. Needs to be provided for non RFC1918 [1] (public) addresses. [1] RFC1918: https://tools.ietf.org/html/rfc1918
+     */
     @JsonProperty("clusterAdvertiseAddress")
     public String getClusterAdvertiseAddress() {
         return clusterAdvertiseAddress;
     }
 
+    /**
+     * ClusterAdvertiseAddress is the explicit address to advertise in cluster. Needs to be provided for non RFC1918 [1] (public) addresses. [1] RFC1918: https://tools.ietf.org/html/rfc1918
+     */
     @JsonProperty("clusterAdvertiseAddress")
     public void setClusterAdvertiseAddress(String clusterAdvertiseAddress) {
         this.clusterAdvertiseAddress = clusterAdvertiseAddress;
     }
 
+    /**
+     * Interval between gossip attempts.
+     */
     @JsonProperty("clusterGossipInterval")
     public String getClusterGossipInterval() {
         return clusterGossipInterval;
     }
 
+    /**
+     * Interval between gossip attempts.
+     */
     @JsonProperty("clusterGossipInterval")
     public void setClusterGossipInterval(String clusterGossipInterval) {
         this.clusterGossipInterval = clusterGossipInterval;
     }
 
+    /**
+     * Defines the identifier that uniquely identifies the Alertmanager cluster. You should only set it when the Alertmanager cluster includes Alertmanager instances which are external to this Alertmanager resource. In practice, the addresses of the external instances are provided via the `.spec.additionalPeers` field.
+     */
     @JsonProperty("clusterLabel")
     public String getClusterLabel() {
         return clusterLabel;
     }
 
+    /**
+     * Defines the identifier that uniquely identifies the Alertmanager cluster. You should only set it when the Alertmanager cluster includes Alertmanager instances which are external to this Alertmanager resource. In practice, the addresses of the external instances are provided via the `.spec.additionalPeers` field.
+     */
     @JsonProperty("clusterLabel")
     public void setClusterLabel(String clusterLabel) {
         this.clusterLabel = clusterLabel;
     }
 
+    /**
+     * Timeout for cluster peering.
+     */
     @JsonProperty("clusterPeerTimeout")
     public String getClusterPeerTimeout() {
         return clusterPeerTimeout;
     }
 
+    /**
+     * Timeout for cluster peering.
+     */
     @JsonProperty("clusterPeerTimeout")
     public void setClusterPeerTimeout(String clusterPeerTimeout) {
         this.clusterPeerTimeout = clusterPeerTimeout;
     }
 
+    /**
+     * Interval between pushpull attempts.
+     */
     @JsonProperty("clusterPushpullInterval")
     public String getClusterPushpullInterval() {
         return clusterPushpullInterval;
     }
 
+    /**
+     * Interval between pushpull attempts.
+     */
     @JsonProperty("clusterPushpullInterval")
     public void setClusterPushpullInterval(String clusterPushpullInterval) {
         this.clusterPushpullInterval = clusterPushpullInterval;
     }
 
+    /**
+     * ConfigMaps is a list of ConfigMaps in the same namespace as the Alertmanager object, which shall be mounted into the Alertmanager Pods. Each ConfigMap is added to the StatefulSet definition as a volume named `configmap-&lt;configmap-name&gt;`. The ConfigMaps are mounted into `/etc/alertmanager/configmaps/&lt;configmap-name&gt;` in the 'alertmanager' container.
+     */
     @JsonProperty("configMaps")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getConfigMaps() {
         return configMaps;
     }
 
+    /**
+     * ConfigMaps is a list of ConfigMaps in the same namespace as the Alertmanager object, which shall be mounted into the Alertmanager Pods. Each ConfigMap is added to the StatefulSet definition as a volume named `configmap-&lt;configmap-name&gt;`. The ConfigMaps are mounted into `/etc/alertmanager/configmaps/&lt;configmap-name&gt;` in the 'alertmanager' container.
+     */
     @JsonProperty("configMaps")
     public void setConfigMaps(List<String> configMaps) {
         this.configMaps = configMaps;
     }
 
+    /**
+     * ConfigSecret is the name of a Kubernetes Secret in the same namespace as the Alertmanager object, which contains the configuration for this Alertmanager instance. If empty, it defaults to `alertmanager-&lt;alertmanager-name&gt;`.<br><p> <br><p> The Alertmanager configuration should be available under the `alertmanager.yaml` key. Additional keys from the original secret are copied to the generated secret and mounted into the `/etc/alertmanager/config` directory in the `alertmanager` container.<br><p> <br><p> If either the secret or the `alertmanager.yaml` key is missing, the operator provisions a minimal Alertmanager configuration with one empty receiver (effectively dropping alert notifications).
+     */
     @JsonProperty("configSecret")
     public String getConfigSecret() {
         return configSecret;
     }
 
+    /**
+     * ConfigSecret is the name of a Kubernetes Secret in the same namespace as the Alertmanager object, which contains the configuration for this Alertmanager instance. If empty, it defaults to `alertmanager-&lt;alertmanager-name&gt;`.<br><p> <br><p> The Alertmanager configuration should be available under the `alertmanager.yaml` key. Additional keys from the original secret are copied to the generated secret and mounted into the `/etc/alertmanager/config` directory in the `alertmanager` container.<br><p> <br><p> If either the secret or the `alertmanager.yaml` key is missing, the operator provisions a minimal Alertmanager configuration with one empty receiver (effectively dropping alert notifications).
+     */
     @JsonProperty("configSecret")
     public void setConfigSecret(String configSecret) {
         this.configSecret = configSecret;
     }
 
+    /**
+     * Containers allows injecting additional containers. This is meant to allow adding an authentication proxy to an Alertmanager pod. Containers described here modify an operator generated container if they share the same name and modifications are done via a strategic merge patch. The current container names are: `alertmanager` and `config-reloader`. Overriding containers is entirely outside the scope of what the maintainers will support and by doing so, you accept that this behaviour may break at any time without notice.
+     */
     @JsonProperty("containers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Container> getContainers() {
         return containers;
     }
 
+    /**
+     * Containers allows injecting additional containers. This is meant to allow adding an authentication proxy to an Alertmanager pod. Containers described here modify an operator generated container if they share the same name and modifications are done via a strategic merge patch. The current container names are: `alertmanager` and `config-reloader`. Overriding containers is entirely outside the scope of what the maintainers will support and by doing so, you accept that this behaviour may break at any time without notice.
+     */
     @JsonProperty("containers")
     public void setContainers(List<Container> containers) {
         this.containers = containers;
     }
 
+    /**
+     * AlertmanagerSpec is a specification of the desired behavior of the Alertmanager cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("dnsConfig")
     public PodDNSConfig getDnsConfig() {
         return dnsConfig;
     }
 
+    /**
+     * AlertmanagerSpec is a specification of the desired behavior of the Alertmanager cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("dnsConfig")
     public void setDnsConfig(PodDNSConfig dnsConfig) {
         this.dnsConfig = dnsConfig;
     }
 
+    /**
+     * Defines the DNS policy for the pods.
+     */
     @JsonProperty("dnsPolicy")
     public String getDnsPolicy() {
         return dnsPolicy;
     }
 
+    /**
+     * Defines the DNS policy for the pods.
+     */
     @JsonProperty("dnsPolicy")
     public void setDnsPolicy(String dnsPolicy) {
         this.dnsPolicy = dnsPolicy;
     }
 
+    /**
+     * Enable access to Alertmanager feature flags. By default, no features are enabled. Enabling features which are disabled by default is entirely outside the scope of what the maintainers will support and by doing so, you accept that this behaviour may break at any time without notice.<br><p> <br><p> It requires Alertmanager &gt;= 0.27.0.
+     */
     @JsonProperty("enableFeatures")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEnableFeatures() {
         return enableFeatures;
     }
 
+    /**
+     * Enable access to Alertmanager feature flags. By default, no features are enabled. Enabling features which are disabled by default is entirely outside the scope of what the maintainers will support and by doing so, you accept that this behaviour may break at any time without notice.<br><p> <br><p> It requires Alertmanager &gt;= 0.27.0.
+     */
     @JsonProperty("enableFeatures")
     public void setEnableFeatures(List<String> enableFeatures) {
         this.enableFeatures = enableFeatures;
     }
 
+    /**
+     * The external URL the Alertmanager instances will be available under. This is necessary to generate correct URLs. This is necessary if Alertmanager is not served from root of a DNS name.
+     */
     @JsonProperty("externalUrl")
     public String getExternalUrl() {
         return externalUrl;
     }
 
+    /**
+     * The external URL the Alertmanager instances will be available under. This is necessary to generate correct URLs. This is necessary if Alertmanager is not served from root of a DNS name.
+     */
     @JsonProperty("externalUrl")
     public void setExternalUrl(String externalUrl) {
         this.externalUrl = externalUrl;
     }
 
+    /**
+     * ForceEnableClusterMode ensures Alertmanager does not deactivate the cluster mode when running with a single replica. Use case is e.g. spanning an Alertmanager cluster across Kubernetes clusters with a single replica in each.
+     */
     @JsonProperty("forceEnableClusterMode")
     public Boolean getForceEnableClusterMode() {
         return forceEnableClusterMode;
     }
 
+    /**
+     * ForceEnableClusterMode ensures Alertmanager does not deactivate the cluster mode when running with a single replica. Use case is e.g. spanning an Alertmanager cluster across Kubernetes clusters with a single replica in each.
+     */
     @JsonProperty("forceEnableClusterMode")
     public void setForceEnableClusterMode(Boolean forceEnableClusterMode) {
         this.forceEnableClusterMode = forceEnableClusterMode;
     }
 
+    /**
+     * Pods' hostAliases configuration
+     */
     @JsonProperty("hostAliases")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HostAlias> getHostAliases() {
         return hostAliases;
     }
 
+    /**
+     * Pods' hostAliases configuration
+     */
     @JsonProperty("hostAliases")
     public void setHostAliases(List<HostAlias> hostAliases) {
         this.hostAliases = hostAliases;
     }
 
+    /**
+     * Image if specified has precedence over baseImage, tag and sha combinations. Specifying the version is still necessary to ensure the Prometheus Operator knows what version of Alertmanager is being configured.
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * Image if specified has precedence over baseImage, tag and sha combinations. Specifying the version is still necessary to ensure the Prometheus Operator knows what version of Alertmanager is being configured.
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
     }
 
+    /**
+     * Image pull policy for the 'alertmanager', 'init-config-reloader' and 'config-reloader' containers. See https://kubernetes.io/docs/concepts/containers/images/#image-pull-policy for more details.<br><p> <br><p> Possible enum values:<br><p>  - `"Always"` means that kubelet always attempts to pull the latest image. Container will fail If the pull fails.<br><p>  - `"IfNotPresent"` means that kubelet pulls if the image isn't present on disk. Container will fail if the image isn't present and the pull fails.<br><p>  - `"Never"` means that kubelet never pulls an image, but only uses a local image. Container will fail if the image isn't present
+     */
     @JsonProperty("imagePullPolicy")
     public String getImagePullPolicy() {
         return imagePullPolicy;
     }
 
+    /**
+     * Image pull policy for the 'alertmanager', 'init-config-reloader' and 'config-reloader' containers. See https://kubernetes.io/docs/concepts/containers/images/#image-pull-policy for more details.<br><p> <br><p> Possible enum values:<br><p>  - `"Always"` means that kubelet always attempts to pull the latest image. Container will fail If the pull fails.<br><p>  - `"IfNotPresent"` means that kubelet pulls if the image isn't present on disk. Container will fail if the image isn't present and the pull fails.<br><p>  - `"Never"` means that kubelet never pulls an image, but only uses a local image. Container will fail if the image isn't present
+     */
     @JsonProperty("imagePullPolicy")
     public void setImagePullPolicy(String imagePullPolicy) {
         this.imagePullPolicy = imagePullPolicy;
     }
 
+    /**
+     * An optional list of references to secrets in the same namespace to use for pulling prometheus and alertmanager images from registries see http://kubernetes.io/docs/user-guide/images#specifying-imagepullsecrets-on-a-pod
+     */
     @JsonProperty("imagePullSecrets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LocalObjectReference> getImagePullSecrets() {
         return imagePullSecrets;
     }
 
+    /**
+     * An optional list of references to secrets in the same namespace to use for pulling prometheus and alertmanager images from registries see http://kubernetes.io/docs/user-guide/images#specifying-imagepullsecrets-on-a-pod
+     */
     @JsonProperty("imagePullSecrets")
     public void setImagePullSecrets(List<LocalObjectReference> imagePullSecrets) {
         this.imagePullSecrets = imagePullSecrets;
     }
 
+    /**
+     * InitContainers allows adding initContainers to the pod definition. Those can be used to e.g. fetch secrets for injection into the Alertmanager configuration from external sources. Any errors during the execution of an initContainer will lead to a restart of the Pod. More info: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/ InitContainers described here modify an operator generated init containers if they share the same name and modifications are done via a strategic merge patch. The current init container name is: `init-config-reloader`. Overriding init containers is entirely outside the scope of what the maintainers will support and by doing so, you accept that this behaviour may break at any time without notice.
+     */
     @JsonProperty("initContainers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Container> getInitContainers() {
         return initContainers;
     }
 
+    /**
+     * InitContainers allows adding initContainers to the pod definition. Those can be used to e.g. fetch secrets for injection into the Alertmanager configuration from external sources. Any errors during the execution of an initContainer will lead to a restart of the Pod. More info: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/ InitContainers described here modify an operator generated init containers if they share the same name and modifications are done via a strategic merge patch. The current init container name is: `init-config-reloader`. Overriding init containers is entirely outside the scope of what the maintainers will support and by doing so, you accept that this behaviour may break at any time without notice.
+     */
     @JsonProperty("initContainers")
     public void setInitContainers(List<Container> initContainers) {
         this.initContainers = initContainers;
     }
 
+    /**
+     * ListenLocal makes the Alertmanager server listen on loopback, so that it does not bind against the Pod IP. Note this is only for the Alertmanager UI, not the gossip communication.
+     */
     @JsonProperty("listenLocal")
     public Boolean getListenLocal() {
         return listenLocal;
     }
 
+    /**
+     * ListenLocal makes the Alertmanager server listen on loopback, so that it does not bind against the Pod IP. Note this is only for the Alertmanager UI, not the gossip communication.
+     */
     @JsonProperty("listenLocal")
     public void setListenLocal(Boolean listenLocal) {
         this.listenLocal = listenLocal;
     }
 
+    /**
+     * Log format for Alertmanager to be configured with.
+     */
     @JsonProperty("logFormat")
     public String getLogFormat() {
         return logFormat;
     }
 
+    /**
+     * Log format for Alertmanager to be configured with.
+     */
     @JsonProperty("logFormat")
     public void setLogFormat(String logFormat) {
         this.logFormat = logFormat;
     }
 
+    /**
+     * Log level for Alertmanager to be configured with.
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * Log level for Alertmanager to be configured with.
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * Minimum number of seconds for which a newly created pod should be ready without any of its container crashing for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready) This is an alpha field from kubernetes 1.22 until 1.24 which requires enabling the StatefulSetMinReadySeconds feature gate.
+     */
     @JsonProperty("minReadySeconds")
     public Long getMinReadySeconds() {
         return minReadySeconds;
     }
 
+    /**
+     * Minimum number of seconds for which a newly created pod should be ready without any of its container crashing for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready) This is an alpha field from kubernetes 1.22 until 1.24 which requires enabling the StatefulSetMinReadySeconds feature gate.
+     */
     @JsonProperty("minReadySeconds")
     public void setMinReadySeconds(Long minReadySeconds) {
         this.minReadySeconds = minReadySeconds;
     }
 
+    /**
+     * Define which Nodes the Pods are scheduled on.
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * Define which Nodes the Pods are scheduled on.
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * If set to true all actions on the underlying managed objects are not goint to be performed, except for delete actions.
+     */
     @JsonProperty("paused")
     public Boolean getPaused() {
         return paused;
     }
 
+    /**
+     * If set to true all actions on the underlying managed objects are not goint to be performed, except for delete actions.
+     */
     @JsonProperty("paused")
     public void setPaused(Boolean paused) {
         this.paused = paused;
     }
 
+    /**
+     * AlertmanagerSpec is a specification of the desired behavior of the Alertmanager cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("persistentVolumeClaimRetentionPolicy")
     public StatefulSetPersistentVolumeClaimRetentionPolicy getPersistentVolumeClaimRetentionPolicy() {
         return persistentVolumeClaimRetentionPolicy;
     }
 
+    /**
+     * AlertmanagerSpec is a specification of the desired behavior of the Alertmanager cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("persistentVolumeClaimRetentionPolicy")
     public void setPersistentVolumeClaimRetentionPolicy(StatefulSetPersistentVolumeClaimRetentionPolicy persistentVolumeClaimRetentionPolicy) {
         this.persistentVolumeClaimRetentionPolicy = persistentVolumeClaimRetentionPolicy;
     }
 
+    /**
+     * AlertmanagerSpec is a specification of the desired behavior of the Alertmanager cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("podMetadata")
     public EmbeddedObjectMetadata getPodMetadata() {
         return podMetadata;
     }
 
+    /**
+     * AlertmanagerSpec is a specification of the desired behavior of the Alertmanager cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("podMetadata")
     public void setPodMetadata(EmbeddedObjectMetadata podMetadata) {
         this.podMetadata = podMetadata;
     }
 
+    /**
+     * Port name used for the pods and governing service. Defaults to `web`.
+     */
     @JsonProperty("portName")
     public String getPortName() {
         return portName;
     }
 
+    /**
+     * Port name used for the pods and governing service. Defaults to `web`.
+     */
     @JsonProperty("portName")
     public void setPortName(String portName) {
         this.portName = portName;
     }
 
+    /**
+     * Priority class assigned to the Pods
+     */
     @JsonProperty("priorityClassName")
     public String getPriorityClassName() {
         return priorityClassName;
     }
 
+    /**
+     * Priority class assigned to the Pods
+     */
     @JsonProperty("priorityClassName")
     public void setPriorityClassName(String priorityClassName) {
         this.priorityClassName = priorityClassName;
     }
 
+    /**
+     * Size is the expected size of the alertmanager cluster. The controller will eventually make the size of the running cluster equal to the expected size.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Size is the expected size of the alertmanager cluster. The controller will eventually make the size of the running cluster equal to the expected size.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * AlertmanagerSpec is a specification of the desired behavior of the Alertmanager cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * AlertmanagerSpec is a specification of the desired behavior of the Alertmanager cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * Time duration Alertmanager shall retain data for. Default is '120h', and must match the regular expression `[0-9]+(ms|s|m|h)` (milliseconds seconds minutes hours).
+     */
     @JsonProperty("retention")
     public String getRetention() {
         return retention;
     }
 
+    /**
+     * Time duration Alertmanager shall retain data for. Default is '120h', and must match the regular expression `[0-9]+(ms|s|m|h)` (milliseconds seconds minutes hours).
+     */
     @JsonProperty("retention")
     public void setRetention(String retention) {
         this.retention = retention;
     }
 
+    /**
+     * The route prefix Alertmanager registers HTTP handlers for. This is useful, if using ExternalURL and a proxy is rewriting HTTP routes of a request, and the actual ExternalURL is still true, but the server serves requests under a different route prefix. For example for use with `kubectl proxy`.
+     */
     @JsonProperty("routePrefix")
     public String getRoutePrefix() {
         return routePrefix;
     }
 
+    /**
+     * The route prefix Alertmanager registers HTTP handlers for. This is useful, if using ExternalURL and a proxy is rewriting HTTP routes of a request, and the actual ExternalURL is still true, but the server serves requests under a different route prefix. For example for use with `kubectl proxy`.
+     */
     @JsonProperty("routePrefix")
     public void setRoutePrefix(String routePrefix) {
         this.routePrefix = routePrefix;
     }
 
+    /**
+     * Secrets is a list of Secrets in the same namespace as the Alertmanager object, which shall be mounted into the Alertmanager Pods. Each Secret is added to the StatefulSet definition as a volume named `secret-&lt;secret-name&gt;`. The Secrets are mounted into `/etc/alertmanager/secrets/&lt;secret-name&gt;` in the 'alertmanager' container.
+     */
     @JsonProperty("secrets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSecrets() {
         return secrets;
     }
 
+    /**
+     * Secrets is a list of Secrets in the same namespace as the Alertmanager object, which shall be mounted into the Alertmanager Pods. Each Secret is added to the StatefulSet definition as a volume named `secret-&lt;secret-name&gt;`. The Secrets are mounted into `/etc/alertmanager/secrets/&lt;secret-name&gt;` in the 'alertmanager' container.
+     */
     @JsonProperty("secrets")
     public void setSecrets(List<String> secrets) {
         this.secrets = secrets;
     }
 
+    /**
+     * AlertmanagerSpec is a specification of the desired behavior of the Alertmanager cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("securityContext")
     public PodSecurityContext getSecurityContext() {
         return securityContext;
     }
 
+    /**
+     * AlertmanagerSpec is a specification of the desired behavior of the Alertmanager cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("securityContext")
     public void setSecurityContext(PodSecurityContext securityContext) {
         this.securityContext = securityContext;
     }
 
+    /**
+     * ServiceAccountName is the name of the ServiceAccount to use to run the Prometheus Pods.
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * ServiceAccountName is the name of the ServiceAccount to use to run the Prometheus Pods.
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * SHA of Alertmanager container image to be deployed. Defaults to the value of `version`. Similar to a tag, but the SHA explicitly deploys an immutable container image. Version and Tag are ignored if SHA is set. Deprecated: use 'image' instead. The image digest can be specified as part of the image URL.
+     */
     @JsonProperty("sha")
     public String getSha() {
         return sha;
     }
 
+    /**
+     * SHA of Alertmanager container image to be deployed. Defaults to the value of `version`. Similar to a tag, but the SHA explicitly deploys an immutable container image. Version and Tag are ignored if SHA is set. Deprecated: use 'image' instead. The image digest can be specified as part of the image URL.
+     */
     @JsonProperty("sha")
     public void setSha(String sha) {
         this.sha = sha;
     }
 
+    /**
+     * AlertmanagerSpec is a specification of the desired behavior of the Alertmanager cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("storage")
     public StorageSpec getStorage() {
         return storage;
     }
 
+    /**
+     * AlertmanagerSpec is a specification of the desired behavior of the Alertmanager cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("storage")
     public void setStorage(StorageSpec storage) {
         this.storage = storage;
     }
 
+    /**
+     * Tag of Alertmanager container image to be deployed. Defaults to the value of `version`. Version is ignored if Tag is set. Deprecated: use 'image' instead. The image tag can be specified as part of the image URL.
+     */
     @JsonProperty("tag")
     public String getTag() {
         return tag;
     }
 
+    /**
+     * Tag of Alertmanager container image to be deployed. Defaults to the value of `version`. Version is ignored if Tag is set. Deprecated: use 'image' instead. The image tag can be specified as part of the image URL.
+     */
     @JsonProperty("tag")
     public void setTag(String tag) {
         this.tag = tag;
     }
 
+    /**
+     * If specified, the pod's tolerations.
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * If specified, the pod's tolerations.
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
     }
 
+    /**
+     * If specified, the pod's topology spread constraints.
+     */
     @JsonProperty("topologySpreadConstraints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TopologySpreadConstraint> getTopologySpreadConstraints() {
         return topologySpreadConstraints;
     }
 
+    /**
+     * If specified, the pod's topology spread constraints.
+     */
     @JsonProperty("topologySpreadConstraints")
     public void setTopologySpreadConstraints(List<TopologySpreadConstraint> topologySpreadConstraints) {
         this.topologySpreadConstraints = topologySpreadConstraints;
     }
 
+    /**
+     * Version the cluster should be on.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * Version the cluster should be on.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
     }
 
+    /**
+     * VolumeMounts allows configuration of additional VolumeMounts on the output StatefulSet definition. VolumeMounts specified will be appended to other VolumeMounts in the alertmanager container, that are generated as a result of StorageSpec objects.
+     */
     @JsonProperty("volumeMounts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VolumeMount> getVolumeMounts() {
         return volumeMounts;
     }
 
+    /**
+     * VolumeMounts allows configuration of additional VolumeMounts on the output StatefulSet definition. VolumeMounts specified will be appended to other VolumeMounts in the alertmanager container, that are generated as a result of StorageSpec objects.
+     */
     @JsonProperty("volumeMounts")
     public void setVolumeMounts(List<VolumeMount> volumeMounts) {
         this.volumeMounts = volumeMounts;
     }
 
+    /**
+     * Volumes allows configuration of additional volumes on the output StatefulSet definition. Volumes specified will be appended to other volumes that are generated as a result of StorageSpec objects.
+     */
     @JsonProperty("volumes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Volume> getVolumes() {
         return volumes;
     }
 
+    /**
+     * Volumes allows configuration of additional volumes on the output StatefulSet definition. Volumes specified will be appended to other volumes that are generated as a result of StorageSpec objects.
+     */
     @JsonProperty("volumes")
     public void setVolumes(List<Volume> volumes) {
         this.volumes = volumes;
     }
 
+    /**
+     * AlertmanagerSpec is a specification of the desired behavior of the Alertmanager cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("web")
     public AlertmanagerWebSpec getWeb() {
         return web;
     }
 
+    /**
+     * AlertmanagerSpec is a specification of the desired behavior of the Alertmanager cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("web")
     public void setWeb(AlertmanagerWebSpec web) {
         this.web = web;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerStatus.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerStatus.java
index a2c1b0ba4df..ec620679f50 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerStatus.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AlertmanagerStatus is the most recent observed status of the Alertmanager cluster. Read-only. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -105,72 +108,114 @@ public AlertmanagerStatus(Integer availableReplicas, List<Condition> conditions,
         this.updatedReplicas = updatedReplicas;
     }
 
+    /**
+     * Total number of available pods (ready for at least minReadySeconds) targeted by this Alertmanager cluster.
+     */
     @JsonProperty("availableReplicas")
     public Integer getAvailableReplicas() {
         return availableReplicas;
     }
 
+    /**
+     * Total number of available pods (ready for at least minReadySeconds) targeted by this Alertmanager cluster.
+     */
     @JsonProperty("availableReplicas")
     public void setAvailableReplicas(Integer availableReplicas) {
         this.availableReplicas = availableReplicas;
     }
 
+    /**
+     * The current state of the Alertmanager object.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * The current state of the Alertmanager object.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Represents whether any actions on the underlying managed objects are being performed. Only delete actions will be performed.
+     */
     @JsonProperty("paused")
     public Boolean getPaused() {
         return paused;
     }
 
+    /**
+     * Represents whether any actions on the underlying managed objects are being performed. Only delete actions will be performed.
+     */
     @JsonProperty("paused")
     public void setPaused(Boolean paused) {
         this.paused = paused;
     }
 
+    /**
+     * Total number of non-terminated pods targeted by this Alertmanager object (their labels match the selector).
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Total number of non-terminated pods targeted by this Alertmanager object (their labels match the selector).
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * The selector used to match the pods targeted by this Alertmanager object.
+     */
     @JsonProperty("selector")
     public String getSelector() {
         return selector;
     }
 
+    /**
+     * The selector used to match the pods targeted by this Alertmanager object.
+     */
     @JsonProperty("selector")
     public void setSelector(String selector) {
         this.selector = selector;
     }
 
+    /**
+     * Total number of unavailable pods targeted by this Alertmanager object.
+     */
     @JsonProperty("unavailableReplicas")
     public Integer getUnavailableReplicas() {
         return unavailableReplicas;
     }
 
+    /**
+     * Total number of unavailable pods targeted by this Alertmanager object.
+     */
     @JsonProperty("unavailableReplicas")
     public void setUnavailableReplicas(Integer unavailableReplicas) {
         this.unavailableReplicas = unavailableReplicas;
     }
 
+    /**
+     * Total number of non-terminated pods targeted by this Alertmanager object that have the desired version spec.
+     */
     @JsonProperty("updatedReplicas")
     public Integer getUpdatedReplicas() {
         return updatedReplicas;
     }
 
+    /**
+     * Total number of non-terminated pods targeted by this Alertmanager object that have the desired version spec.
+     */
     @JsonProperty("updatedReplicas")
     public void setUpdatedReplicas(Integer updatedReplicas) {
         this.updatedReplicas = updatedReplicas;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerWebSpec.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerWebSpec.java
index c0c571163cd..4f932fcbf00 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerWebSpec.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AlertmanagerWebSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AlertmanagerWebSpec defines the web command line flags when starting Alertmanager.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public AlertmanagerWebSpec(Long getConcurrency, WebHTTPConfig httpConfig, Long t
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * Maximum number of GET requests processed concurrently. This corresponds to the Alertmanager's `--web.get-concurrency` flag.
+     */
     @JsonProperty("getConcurrency")
     public Long getGetConcurrency() {
         return getConcurrency;
     }
 
+    /**
+     * Maximum number of GET requests processed concurrently. This corresponds to the Alertmanager's `--web.get-concurrency` flag.
+     */
     @JsonProperty("getConcurrency")
     public void setGetConcurrency(Long getConcurrency) {
         this.getConcurrency = getConcurrency;
     }
 
+    /**
+     * AlertmanagerWebSpec defines the web command line flags when starting Alertmanager.
+     */
     @JsonProperty("httpConfig")
     public WebHTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * AlertmanagerWebSpec defines the web command line flags when starting Alertmanager.
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(WebHTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * Timeout for HTTP requests. This corresponds to the Alertmanager's `--web.timeout` flag.
+     */
     @JsonProperty("timeout")
     public Long getTimeout() {
         return timeout;
     }
 
+    /**
+     * Timeout for HTTP requests. This corresponds to the Alertmanager's `--web.timeout` flag.
+     */
     @JsonProperty("timeout")
     public void setTimeout(Long timeout) {
         this.timeout = timeout;
     }
 
+    /**
+     * AlertmanagerWebSpec defines the web command line flags when starting Alertmanager.
+     */
     @JsonProperty("tlsConfig")
     public WebTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * AlertmanagerWebSpec defines the web command line flags when starting Alertmanager.
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(WebTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ArbitraryFSAccessThroughSMsConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ArbitraryFSAccessThroughSMsConfig.java
index 72f7f535933..7ce751bb323 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ArbitraryFSAccessThroughSMsConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ArbitraryFSAccessThroughSMsConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ArbitraryFSAccessThroughSMsConfig enables users to configure, whether a service monitor selected by the Prometheus instance is allowed to use arbitrary files on the file system of the Prometheus container. This is the case when e.g. a service monitor specifies a BearerTokenFile in an endpoint. A malicious user could create a service monitor selecting arbitrary secret files in the Prometheus container. Those secrets would then be sent with a scrape request by Prometheus to a malicious target. Denying the above would prevent the attack, users can instead use the BearerTokenSecret field.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ArbitraryFSAccessThroughSMsConfig(Boolean deny) {
         this.deny = deny;
     }
 
+    /**
+     * ArbitraryFSAccessThroughSMsConfig enables users to configure, whether a service monitor selected by the Prometheus instance is allowed to use arbitrary files on the file system of the Prometheus container. This is the case when e.g. a service monitor specifies a BearerTokenFile in an endpoint. A malicious user could create a service monitor selecting arbitrary secret files in the Prometheus container. Those secrets would then be sent with a scrape request by Prometheus to a malicious target. Denying the above would prevent the attack, users can instead use the BearerTokenSecret field.
+     */
     @JsonProperty("deny")
     public Boolean getDeny() {
         return deny;
     }
 
+    /**
+     * ArbitraryFSAccessThroughSMsConfig enables users to configure, whether a service monitor selected by the Prometheus instance is allowed to use arbitrary files on the file system of the Prometheus container. This is the case when e.g. a service monitor specifies a BearerTokenFile in an endpoint. A malicious user could create a service monitor selecting arbitrary secret files in the Prometheus container. Those secrets would then be sent with a scrape request by Prometheus to a malicious target. Denying the above would prevent the attack, users can instead use the BearerTokenSecret field.
+     */
     @JsonProperty("deny")
     public void setDeny(Boolean deny) {
         this.deny = deny;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Argument.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Argument.java
index 54fa62fd62d..b6e98e29734 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Argument.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Argument.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Argument as part of the AdditionalArgs list.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Argument(String name, String value) {
         this.value = value;
     }
 
+    /**
+     * Name of the argument, e.g. "scrape.discovery-reload-interval".
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the argument, e.g. "scrape.discovery-reload-interval".
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Argument value, e.g. 30s. Can be empty for name-only arguments (e.g. --storage.tsdb.no-lockfile)
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Argument value, e.g. 30s. Can be empty for name-only arguments (e.g. --storage.tsdb.no-lockfile)
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AttachMetadata.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AttachMetadata.java
index 2a126321a7c..c5b8693d59a 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AttachMetadata.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AttachMetadata.java
@@ -78,11 +78,17 @@ public AttachMetadata(Boolean node) {
         this.node = node;
     }
 
+    /**
+     * When set to true, Prometheus attaches node metadata to the discovered targets.<br><p> <br><p> The Prometheus service account must have the `list` and `watch` permissions on the `Nodes` objects.
+     */
     @JsonProperty("node")
     public Boolean getNode() {
         return node;
     }
 
+    /**
+     * When set to true, Prometheus attaches node metadata to the discovered targets.<br><p> <br><p> The Prometheus service account must have the `list` and `watch` permissions on the `Nodes` objects.
+     */
     @JsonProperty("node")
     public void setNode(Boolean node) {
         this.node = node;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Authorization.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Authorization.java
index cc60acf1697..a1a309ccb5d 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Authorization.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Authorization.java
@@ -97,21 +97,33 @@ public void setCredentials(SecretKeySelector credentials) {
         this.credentials = credentials;
     }
 
+    /**
+     * File to read a secret from, mutually exclusive with `credentials`.
+     */
     @JsonProperty("credentialsFile")
     public String getCredentialsFile() {
         return credentialsFile;
     }
 
+    /**
+     * File to read a secret from, mutually exclusive with `credentials`.
+     */
     @JsonProperty("credentialsFile")
     public void setCredentialsFile(String credentialsFile) {
         this.credentialsFile = credentialsFile;
     }
 
+    /**
+     * Defines the authentication type. The value is case-insensitive.<br><p> <br><p> "Basic" is not a supported value.<br><p> <br><p> Default: "Bearer"
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Defines the authentication type. The value is case-insensitive.<br><p> <br><p> "Basic" is not a supported value.<br><p> <br><p> Default: "Bearer"
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AuthorizationValidationError.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AuthorizationValidationError.java
index 660b40c877d..49d1edb6431 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AuthorizationValidationError.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AuthorizationValidationError.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AuthorizationValidationError is returned by Authorization.Validate() on semantically invalid configurations.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AzureAD.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AzureAD.java
index dcc218ab272..267ac95b55d 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AzureAD.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AzureAD.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzureAD defines the configuration for remote write's azuread parameters.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public AzureAD(String cloud, ManagedIdentity managedIdentity, AzureOAuth oauth,
         this.sdk = sdk;
     }
 
+    /**
+     * The Azure Cloud. Options are 'AzurePublic', 'AzureChina', or 'AzureGovernment'.
+     */
     @JsonProperty("cloud")
     public String getCloud() {
         return cloud;
     }
 
+    /**
+     * The Azure Cloud. Options are 'AzurePublic', 'AzureChina', or 'AzureGovernment'.
+     */
     @JsonProperty("cloud")
     public void setCloud(String cloud) {
         this.cloud = cloud;
     }
 
+    /**
+     * AzureAD defines the configuration for remote write's azuread parameters.
+     */
     @JsonProperty("managedIdentity")
     public ManagedIdentity getManagedIdentity() {
         return managedIdentity;
     }
 
+    /**
+     * AzureAD defines the configuration for remote write's azuread parameters.
+     */
     @JsonProperty("managedIdentity")
     public void setManagedIdentity(ManagedIdentity managedIdentity) {
         this.managedIdentity = managedIdentity;
     }
 
+    /**
+     * AzureAD defines the configuration for remote write's azuread parameters.
+     */
     @JsonProperty("oauth")
     public AzureOAuth getOauth() {
         return oauth;
     }
 
+    /**
+     * AzureAD defines the configuration for remote write's azuread parameters.
+     */
     @JsonProperty("oauth")
     public void setOauth(AzureOAuth oauth) {
         this.oauth = oauth;
     }
 
+    /**
+     * AzureAD defines the configuration for remote write's azuread parameters.
+     */
     @JsonProperty("sdk")
     public AzureSDK getSdk() {
         return sdk;
     }
 
+    /**
+     * AzureAD defines the configuration for remote write's azuread parameters.
+     */
     @JsonProperty("sdk")
     public void setSdk(AzureSDK sdk) {
         this.sdk = sdk;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AzureOAuth.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AzureOAuth.java
index bbc50d400f2..2035ac002c6 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AzureOAuth.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AzureOAuth.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzureOAuth defines the Azure OAuth settings.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,31 +90,49 @@ public AzureOAuth(String clientId, SecretKeySelector clientSecret, String tenant
         this.tenantId = tenantId;
     }
 
+    /**
+     * `clientID` is the clientId of the Azure Active Directory application that is being used to authenticate.
+     */
     @JsonProperty("clientId")
     public String getClientId() {
         return clientId;
     }
 
+    /**
+     * `clientID` is the clientId of the Azure Active Directory application that is being used to authenticate.
+     */
     @JsonProperty("clientId")
     public void setClientId(String clientId) {
         this.clientId = clientId;
     }
 
+    /**
+     * AzureOAuth defines the Azure OAuth settings.
+     */
     @JsonProperty("clientSecret")
     public SecretKeySelector getClientSecret() {
         return clientSecret;
     }
 
+    /**
+     * AzureOAuth defines the Azure OAuth settings.
+     */
     @JsonProperty("clientSecret")
     public void setClientSecret(SecretKeySelector clientSecret) {
         this.clientSecret = clientSecret;
     }
 
+    /**
+     * `tenantId` is the tenant ID of the Azure Active Directory application that is being used to authenticate.
+     */
     @JsonProperty("tenantId")
     public String getTenantId() {
         return tenantId;
     }
 
+    /**
+     * `tenantId` is the tenant ID of the Azure Active Directory application that is being used to authenticate.
+     */
     @JsonProperty("tenantId")
     public void setTenantId(String tenantId) {
         this.tenantId = tenantId;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AzureSDK.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AzureSDK.java
index c7c555c852b..cc20845d90b 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AzureSDK.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/AzureSDK.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzureSDK is used to store azure SDK config values.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public AzureSDK(String tenantId) {
         this.tenantId = tenantId;
     }
 
+    /**
+     * `tenantId` is the tenant ID of the azure active directory application that is being used to authenticate.
+     */
     @JsonProperty("tenantId")
     public String getTenantId() {
         return tenantId;
     }
 
+    /**
+     * `tenantId` is the tenant ID of the azure active directory application that is being used to authenticate.
+     */
     @JsonProperty("tenantId")
     public void setTenantId(String tenantId) {
         this.tenantId = tenantId;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/BasicAuth.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/BasicAuth.java
index f03c6a6859c..db920f574ff 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/BasicAuth.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/BasicAuth.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BasicAuth configures HTTP Basic Authentication settings.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public BasicAuth(SecretKeySelector password, SecretKeySelector username) {
         this.username = username;
     }
 
+    /**
+     * BasicAuth configures HTTP Basic Authentication settings.
+     */
     @JsonProperty("password")
     public SecretKeySelector getPassword() {
         return password;
     }
 
+    /**
+     * BasicAuth configures HTTP Basic Authentication settings.
+     */
     @JsonProperty("password")
     public void setPassword(SecretKeySelector password) {
         this.password = password;
     }
 
+    /**
+     * BasicAuth configures HTTP Basic Authentication settings.
+     */
     @JsonProperty("username")
     public SecretKeySelector getUsername() {
         return username;
     }
 
+    /**
+     * BasicAuth configures HTTP Basic Authentication settings.
+     */
     @JsonProperty("username")
     public void setUsername(SecretKeySelector username) {
         this.username = username;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/CommonPrometheusFields.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/CommonPrometheusFields.java
index a3d6e6a5a03..6f7ff811eba 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/CommonPrometheusFields.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/CommonPrometheusFields.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -461,921 +464,1461 @@ public CommonPrometheusFields(List<Argument> additionalArgs, SecretKeySelector a
         this.web = web;
     }
 
+    /**
+     * AdditionalArgs allows setting additional arguments for the 'prometheus' container.<br><p> <br><p> It is intended for e.g. activating hidden flags which are not supported by the dedicated configuration options yet. The arguments are passed as-is to the Prometheus container which may cause issues if they are invalid or not supported by the given Prometheus version.<br><p> <br><p> In case of an argument conflict (e.g. an argument which is already set by the operator itself) or when providing an invalid argument, the reconciliation will fail and an error will be logged.
+     */
     @JsonProperty("additionalArgs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Argument> getAdditionalArgs() {
         return additionalArgs;
     }
 
+    /**
+     * AdditionalArgs allows setting additional arguments for the 'prometheus' container.<br><p> <br><p> It is intended for e.g. activating hidden flags which are not supported by the dedicated configuration options yet. The arguments are passed as-is to the Prometheus container which may cause issues if they are invalid or not supported by the given Prometheus version.<br><p> <br><p> In case of an argument conflict (e.g. an argument which is already set by the operator itself) or when providing an invalid argument, the reconciliation will fail and an error will be logged.
+     */
     @JsonProperty("additionalArgs")
     public void setAdditionalArgs(List<Argument> additionalArgs) {
         this.additionalArgs = additionalArgs;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("additionalScrapeConfigs")
     public SecretKeySelector getAdditionalScrapeConfigs() {
         return additionalScrapeConfigs;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("additionalScrapeConfigs")
     public void setAdditionalScrapeConfigs(SecretKeySelector additionalScrapeConfigs) {
         this.additionalScrapeConfigs = additionalScrapeConfigs;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("affinity")
     public Affinity getAffinity() {
         return affinity;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("affinity")
     public void setAffinity(Affinity affinity) {
         this.affinity = affinity;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("apiserverConfig")
     public APIServerConfig getApiserverConfig() {
         return apiserverConfig;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("apiserverConfig")
     public void setApiserverConfig(APIServerConfig apiserverConfig) {
         this.apiserverConfig = apiserverConfig;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("arbitraryFSAccessThroughSMs")
     public ArbitraryFSAccessThroughSMsConfig getArbitraryFSAccessThroughSMs() {
         return arbitraryFSAccessThroughSMs;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("arbitraryFSAccessThroughSMs")
     public void setArbitraryFSAccessThroughSMs(ArbitraryFSAccessThroughSMsConfig arbitraryFSAccessThroughSMs) {
         this.arbitraryFSAccessThroughSMs = arbitraryFSAccessThroughSMs;
     }
 
+    /**
+     * AutomountServiceAccountToken indicates whether a service account token should be automatically mounted in the pod. If the field isn't set, the operator mounts the service account token by default.<br><p> <br><p> &#42;&#42;Warning:&#42;&#42; be aware that by default, Prometheus requires the service account token for Kubernetes service discovery. It is possible to use strategic merge patch to project the service account token into the 'prometheus' container.
+     */
     @JsonProperty("automountServiceAccountToken")
     public Boolean getAutomountServiceAccountToken() {
         return automountServiceAccountToken;
     }
 
+    /**
+     * AutomountServiceAccountToken indicates whether a service account token should be automatically mounted in the pod. If the field isn't set, the operator mounts the service account token by default.<br><p> <br><p> &#42;&#42;Warning:&#42;&#42; be aware that by default, Prometheus requires the service account token for Kubernetes service discovery. It is possible to use strategic merge patch to project the service account token into the 'prometheus' container.
+     */
     @JsonProperty("automountServiceAccountToken")
     public void setAutomountServiceAccountToken(Boolean automountServiceAccountToken) {
         this.automountServiceAccountToken = automountServiceAccountToken;
     }
 
+    /**
+     * BodySizeLimit defines per-scrape on response body size. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedBodySizeLimit.
+     */
     @JsonProperty("bodySizeLimit")
     public String getBodySizeLimit() {
         return bodySizeLimit;
     }
 
+    /**
+     * BodySizeLimit defines per-scrape on response body size. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedBodySizeLimit.
+     */
     @JsonProperty("bodySizeLimit")
     public void setBodySizeLimit(String bodySizeLimit) {
         this.bodySizeLimit = bodySizeLimit;
     }
 
+    /**
+     * ConfigMaps is a list of ConfigMaps in the same namespace as the Prometheus object, which shall be mounted into the Prometheus Pods. Each ConfigMap is added to the StatefulSet definition as a volume named `configmap-&lt;configmap-name&gt;`. The ConfigMaps are mounted into /etc/prometheus/configmaps/&lt;configmap-name&gt; in the 'prometheus' container.
+     */
     @JsonProperty("configMaps")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getConfigMaps() {
         return configMaps;
     }
 
+    /**
+     * ConfigMaps is a list of ConfigMaps in the same namespace as the Prometheus object, which shall be mounted into the Prometheus Pods. Each ConfigMap is added to the StatefulSet definition as a volume named `configmap-&lt;configmap-name&gt;`. The ConfigMaps are mounted into /etc/prometheus/configmaps/&lt;configmap-name&gt; in the 'prometheus' container.
+     */
     @JsonProperty("configMaps")
     public void setConfigMaps(List<String> configMaps) {
         this.configMaps = configMaps;
     }
 
+    /**
+     * Containers allows injecting additional containers or modifying operator generated containers. This can be used to allow adding an authentication proxy to the Pods or to change the behavior of an operator generated container. Containers described here modify an operator generated container if they share the same name and modifications are done via a strategic merge patch.<br><p> <br><p> The names of containers managed by the operator are: &#42; `prometheus` &#42; `config-reloader` &#42; `thanos-sidecar`<br><p> <br><p> Overriding containers is entirely outside the scope of what the maintainers will support and by doing so, you accept that this behaviour may break at any time without notice.
+     */
     @JsonProperty("containers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Container> getContainers() {
         return containers;
     }
 
+    /**
+     * Containers allows injecting additional containers or modifying operator generated containers. This can be used to allow adding an authentication proxy to the Pods or to change the behavior of an operator generated container. Containers described here modify an operator generated container if they share the same name and modifications are done via a strategic merge patch.<br><p> <br><p> The names of containers managed by the operator are: &#42; `prometheus` &#42; `config-reloader` &#42; `thanos-sidecar`<br><p> <br><p> Overriding containers is entirely outside the scope of what the maintainers will support and by doing so, you accept that this behaviour may break at any time without notice.
+     */
     @JsonProperty("containers")
     public void setContainers(List<Container> containers) {
         this.containers = containers;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("dnsConfig")
     public PodDNSConfig getDnsConfig() {
         return dnsConfig;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("dnsConfig")
     public void setDnsConfig(PodDNSConfig dnsConfig) {
         this.dnsConfig = dnsConfig;
     }
 
+    /**
+     * Defines the DNS policy for the pods.
+     */
     @JsonProperty("dnsPolicy")
     public String getDnsPolicy() {
         return dnsPolicy;
     }
 
+    /**
+     * Defines the DNS policy for the pods.
+     */
     @JsonProperty("dnsPolicy")
     public void setDnsPolicy(String dnsPolicy) {
         this.dnsPolicy = dnsPolicy;
     }
 
+    /**
+     * Enable access to Prometheus feature flags. By default, no features are enabled.<br><p> <br><p> Enabling features which are disabled by default is entirely outside the scope of what the maintainers will support and by doing so, you accept that this behaviour may break at any time without notice.<br><p> <br><p> For more information see https://prometheus.io/docs/prometheus/latest/feature_flags/
+     */
     @JsonProperty("enableFeatures")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEnableFeatures() {
         return enableFeatures;
     }
 
+    /**
+     * Enable access to Prometheus feature flags. By default, no features are enabled.<br><p> <br><p> Enabling features which are disabled by default is entirely outside the scope of what the maintainers will support and by doing so, you accept that this behaviour may break at any time without notice.<br><p> <br><p> For more information see https://prometheus.io/docs/prometheus/latest/feature_flags/
+     */
     @JsonProperty("enableFeatures")
     public void setEnableFeatures(List<String> enableFeatures) {
         this.enableFeatures = enableFeatures;
     }
 
+    /**
+     * Enable Prometheus to be used as a receiver for the OTLP Metrics protocol.<br><p> <br><p> Note that the OTLP receiver endpoint is automatically enabled if `.spec.otlpConfig` is defined.<br><p> <br><p> It requires Prometheus &gt;= v2.47.0.
+     */
     @JsonProperty("enableOTLPReceiver")
     public Boolean getEnableOTLPReceiver() {
         return enableOTLPReceiver;
     }
 
+    /**
+     * Enable Prometheus to be used as a receiver for the OTLP Metrics protocol.<br><p> <br><p> Note that the OTLP receiver endpoint is automatically enabled if `.spec.otlpConfig` is defined.<br><p> <br><p> It requires Prometheus &gt;= v2.47.0.
+     */
     @JsonProperty("enableOTLPReceiver")
     public void setEnableOTLPReceiver(Boolean enableOTLPReceiver) {
         this.enableOTLPReceiver = enableOTLPReceiver;
     }
 
+    /**
+     * Enable Prometheus to be used as a receiver for the Prometheus remote write protocol.<br><p> <br><p> WARNING: This is not considered an efficient way of ingesting samples. Use it with caution for specific low-volume use cases. It is not suitable for replacing the ingestion via scraping and turning Prometheus into a push-based metrics collection system. For more information see https://prometheus.io/docs/prometheus/latest/querying/api/#remote-write-receiver<br><p> <br><p> It requires Prometheus &gt;= v2.33.0.
+     */
     @JsonProperty("enableRemoteWriteReceiver")
     public Boolean getEnableRemoteWriteReceiver() {
         return enableRemoteWriteReceiver;
     }
 
+    /**
+     * Enable Prometheus to be used as a receiver for the Prometheus remote write protocol.<br><p> <br><p> WARNING: This is not considered an efficient way of ingesting samples. Use it with caution for specific low-volume use cases. It is not suitable for replacing the ingestion via scraping and turning Prometheus into a push-based metrics collection system. For more information see https://prometheus.io/docs/prometheus/latest/querying/api/#remote-write-receiver<br><p> <br><p> It requires Prometheus &gt;= v2.33.0.
+     */
     @JsonProperty("enableRemoteWriteReceiver")
     public void setEnableRemoteWriteReceiver(Boolean enableRemoteWriteReceiver) {
         this.enableRemoteWriteReceiver = enableRemoteWriteReceiver;
     }
 
+    /**
+     * When defined, enforcedBodySizeLimit specifies a global limit on the size of uncompressed response body that will be accepted by Prometheus. Targets responding with a body larger than this many bytes will cause the scrape to fail.<br><p> <br><p> It requires Prometheus &gt;= v2.28.0.<br><p> <br><p> When both `enforcedBodySizeLimit` and `bodySizeLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined bodySizeLimit value will inherit the global bodySizeLimit value (Prometheus &gt;= 2.45.0) or the enforcedBodySizeLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedBodySizeLimit` is greater than the `bodySizeLimit`, the `bodySizeLimit` will be set to `enforcedBodySizeLimit`.<br><p> &#42; Scrape objects with a bodySizeLimit value less than or equal to enforcedBodySizeLimit keep their specific value. &#42; Scrape objects with a bodySizeLimit value greater than enforcedBodySizeLimit are set to enforcedBodySizeLimit.
+     */
     @JsonProperty("enforcedBodySizeLimit")
     public String getEnforcedBodySizeLimit() {
         return enforcedBodySizeLimit;
     }
 
+    /**
+     * When defined, enforcedBodySizeLimit specifies a global limit on the size of uncompressed response body that will be accepted by Prometheus. Targets responding with a body larger than this many bytes will cause the scrape to fail.<br><p> <br><p> It requires Prometheus &gt;= v2.28.0.<br><p> <br><p> When both `enforcedBodySizeLimit` and `bodySizeLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined bodySizeLimit value will inherit the global bodySizeLimit value (Prometheus &gt;= 2.45.0) or the enforcedBodySizeLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedBodySizeLimit` is greater than the `bodySizeLimit`, the `bodySizeLimit` will be set to `enforcedBodySizeLimit`.<br><p> &#42; Scrape objects with a bodySizeLimit value less than or equal to enforcedBodySizeLimit keep their specific value. &#42; Scrape objects with a bodySizeLimit value greater than enforcedBodySizeLimit are set to enforcedBodySizeLimit.
+     */
     @JsonProperty("enforcedBodySizeLimit")
     public void setEnforcedBodySizeLimit(String enforcedBodySizeLimit) {
         this.enforcedBodySizeLimit = enforcedBodySizeLimit;
     }
 
+    /**
+     * When defined, enforcedKeepDroppedTargets specifies a global limit on the number of targets dropped by relabeling that will be kept in memory. The value overrides any `spec.keepDroppedTargets` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.keepDroppedTargets` is greater than zero and less than `spec.enforcedKeepDroppedTargets`.<br><p> <br><p> It requires Prometheus &gt;= v2.47.0.<br><p> <br><p> When both `enforcedKeepDroppedTargets` and `keepDroppedTargets` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined keepDroppedTargets value will inherit the global keepDroppedTargets value (Prometheus &gt;= 2.45.0) or the enforcedKeepDroppedTargets value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedKeepDroppedTargets` is greater than the `keepDroppedTargets`, the `keepDroppedTargets` will be set to `enforcedKeepDroppedTargets`.<br><p> &#42; Scrape objects with a keepDroppedTargets value less than or equal to enforcedKeepDroppedTargets keep their specific value. &#42; Scrape objects with a keepDroppedTargets value greater than enforcedKeepDroppedTargets are set to enforcedKeepDroppedTargets.
+     */
     @JsonProperty("enforcedKeepDroppedTargets")
     public Long getEnforcedKeepDroppedTargets() {
         return enforcedKeepDroppedTargets;
     }
 
+    /**
+     * When defined, enforcedKeepDroppedTargets specifies a global limit on the number of targets dropped by relabeling that will be kept in memory. The value overrides any `spec.keepDroppedTargets` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.keepDroppedTargets` is greater than zero and less than `spec.enforcedKeepDroppedTargets`.<br><p> <br><p> It requires Prometheus &gt;= v2.47.0.<br><p> <br><p> When both `enforcedKeepDroppedTargets` and `keepDroppedTargets` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined keepDroppedTargets value will inherit the global keepDroppedTargets value (Prometheus &gt;= 2.45.0) or the enforcedKeepDroppedTargets value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedKeepDroppedTargets` is greater than the `keepDroppedTargets`, the `keepDroppedTargets` will be set to `enforcedKeepDroppedTargets`.<br><p> &#42; Scrape objects with a keepDroppedTargets value less than or equal to enforcedKeepDroppedTargets keep their specific value. &#42; Scrape objects with a keepDroppedTargets value greater than enforcedKeepDroppedTargets are set to enforcedKeepDroppedTargets.
+     */
     @JsonProperty("enforcedKeepDroppedTargets")
     public void setEnforcedKeepDroppedTargets(Long enforcedKeepDroppedTargets) {
         this.enforcedKeepDroppedTargets = enforcedKeepDroppedTargets;
     }
 
+    /**
+     * When defined, enforcedLabelLimit specifies a global limit on the number of labels per sample. The value overrides any `spec.labelLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.labelLimit` is greater than zero and less than `spec.enforcedLabelLimit`.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.<br><p> <br><p> When both `enforcedLabelLimit` and `labelLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined labelLimit value will inherit the global labelLimit value (Prometheus &gt;= 2.45.0) or the enforcedLabelLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedLabelLimit` is greater than the `labelLimit`, the `labelLimit` will be set to `enforcedLabelLimit`.<br><p> &#42; Scrape objects with a labelLimit value less than or equal to enforcedLabelLimit keep their specific value. &#42; Scrape objects with a labelLimit value greater than enforcedLabelLimit are set to enforcedLabelLimit.
+     */
     @JsonProperty("enforcedLabelLimit")
     public Long getEnforcedLabelLimit() {
         return enforcedLabelLimit;
     }
 
+    /**
+     * When defined, enforcedLabelLimit specifies a global limit on the number of labels per sample. The value overrides any `spec.labelLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.labelLimit` is greater than zero and less than `spec.enforcedLabelLimit`.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.<br><p> <br><p> When both `enforcedLabelLimit` and `labelLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined labelLimit value will inherit the global labelLimit value (Prometheus &gt;= 2.45.0) or the enforcedLabelLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedLabelLimit` is greater than the `labelLimit`, the `labelLimit` will be set to `enforcedLabelLimit`.<br><p> &#42; Scrape objects with a labelLimit value less than or equal to enforcedLabelLimit keep their specific value. &#42; Scrape objects with a labelLimit value greater than enforcedLabelLimit are set to enforcedLabelLimit.
+     */
     @JsonProperty("enforcedLabelLimit")
     public void setEnforcedLabelLimit(Long enforcedLabelLimit) {
         this.enforcedLabelLimit = enforcedLabelLimit;
     }
 
+    /**
+     * When defined, enforcedLabelNameLengthLimit specifies a global limit on the length of labels name per sample. The value overrides any `spec.labelNameLengthLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.labelNameLengthLimit` is greater than zero and less than `spec.enforcedLabelNameLengthLimit`.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.<br><p> <br><p> When both `enforcedLabelNameLengthLimit` and `labelNameLengthLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined labelNameLengthLimit value will inherit the global labelNameLengthLimit value (Prometheus &gt;= 2.45.0) or the enforcedLabelNameLengthLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedLabelNameLengthLimit` is greater than the `labelNameLengthLimit`, the `labelNameLengthLimit` will be set to `enforcedLabelNameLengthLimit`.<br><p> &#42; Scrape objects with a labelNameLengthLimit value less than or equal to enforcedLabelNameLengthLimit keep their specific value. &#42; Scrape objects with a labelNameLengthLimit value greater than enforcedLabelNameLengthLimit are set to enforcedLabelNameLengthLimit.
+     */
     @JsonProperty("enforcedLabelNameLengthLimit")
     public Long getEnforcedLabelNameLengthLimit() {
         return enforcedLabelNameLengthLimit;
     }
 
+    /**
+     * When defined, enforcedLabelNameLengthLimit specifies a global limit on the length of labels name per sample. The value overrides any `spec.labelNameLengthLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.labelNameLengthLimit` is greater than zero and less than `spec.enforcedLabelNameLengthLimit`.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.<br><p> <br><p> When both `enforcedLabelNameLengthLimit` and `labelNameLengthLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined labelNameLengthLimit value will inherit the global labelNameLengthLimit value (Prometheus &gt;= 2.45.0) or the enforcedLabelNameLengthLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedLabelNameLengthLimit` is greater than the `labelNameLengthLimit`, the `labelNameLengthLimit` will be set to `enforcedLabelNameLengthLimit`.<br><p> &#42; Scrape objects with a labelNameLengthLimit value less than or equal to enforcedLabelNameLengthLimit keep their specific value. &#42; Scrape objects with a labelNameLengthLimit value greater than enforcedLabelNameLengthLimit are set to enforcedLabelNameLengthLimit.
+     */
     @JsonProperty("enforcedLabelNameLengthLimit")
     public void setEnforcedLabelNameLengthLimit(Long enforcedLabelNameLengthLimit) {
         this.enforcedLabelNameLengthLimit = enforcedLabelNameLengthLimit;
     }
 
+    /**
+     * When not null, enforcedLabelValueLengthLimit defines a global limit on the length of labels value per sample. The value overrides any `spec.labelValueLengthLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.labelValueLengthLimit` is greater than zero and less than `spec.enforcedLabelValueLengthLimit`.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.<br><p> <br><p> When both `enforcedLabelValueLengthLimit` and `labelValueLengthLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined labelValueLengthLimit value will inherit the global labelValueLengthLimit value (Prometheus &gt;= 2.45.0) or the enforcedLabelValueLengthLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedLabelValueLengthLimit` is greater than the `labelValueLengthLimit`, the `labelValueLengthLimit` will be set to `enforcedLabelValueLengthLimit`.<br><p> &#42; Scrape objects with a labelValueLengthLimit value less than or equal to enforcedLabelValueLengthLimit keep their specific value. &#42; Scrape objects with a labelValueLengthLimit value greater than enforcedLabelValueLengthLimit are set to enforcedLabelValueLengthLimit.
+     */
     @JsonProperty("enforcedLabelValueLengthLimit")
     public Long getEnforcedLabelValueLengthLimit() {
         return enforcedLabelValueLengthLimit;
     }
 
+    /**
+     * When not null, enforcedLabelValueLengthLimit defines a global limit on the length of labels value per sample. The value overrides any `spec.labelValueLengthLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.labelValueLengthLimit` is greater than zero and less than `spec.enforcedLabelValueLengthLimit`.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.<br><p> <br><p> When both `enforcedLabelValueLengthLimit` and `labelValueLengthLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined labelValueLengthLimit value will inherit the global labelValueLengthLimit value (Prometheus &gt;= 2.45.0) or the enforcedLabelValueLengthLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedLabelValueLengthLimit` is greater than the `labelValueLengthLimit`, the `labelValueLengthLimit` will be set to `enforcedLabelValueLengthLimit`.<br><p> &#42; Scrape objects with a labelValueLengthLimit value less than or equal to enforcedLabelValueLengthLimit keep their specific value. &#42; Scrape objects with a labelValueLengthLimit value greater than enforcedLabelValueLengthLimit are set to enforcedLabelValueLengthLimit.
+     */
     @JsonProperty("enforcedLabelValueLengthLimit")
     public void setEnforcedLabelValueLengthLimit(Long enforcedLabelValueLengthLimit) {
         this.enforcedLabelValueLengthLimit = enforcedLabelValueLengthLimit;
     }
 
+    /**
+     * When not empty, a label will be added to:<br><p> <br><p> 1. All metrics scraped from `ServiceMonitor`, `PodMonitor`, `Probe` and `ScrapeConfig` objects. 2. All metrics generated from recording rules defined in `PrometheusRule` objects. 3. All alerts generated from alerting rules defined in `PrometheusRule` objects. 4. All vector selectors of PromQL expressions defined in `PrometheusRule` objects.<br><p> <br><p> The label will not added for objects referenced in `spec.excludedFromEnforcement`.<br><p> <br><p> The label's name is this field's value. The label's value is the namespace of the `ServiceMonitor`, `PodMonitor`, `Probe`, `PrometheusRule` or `ScrapeConfig` object.
+     */
     @JsonProperty("enforcedNamespaceLabel")
     public String getEnforcedNamespaceLabel() {
         return enforcedNamespaceLabel;
     }
 
+    /**
+     * When not empty, a label will be added to:<br><p> <br><p> 1. All metrics scraped from `ServiceMonitor`, `PodMonitor`, `Probe` and `ScrapeConfig` objects. 2. All metrics generated from recording rules defined in `PrometheusRule` objects. 3. All alerts generated from alerting rules defined in `PrometheusRule` objects. 4. All vector selectors of PromQL expressions defined in `PrometheusRule` objects.<br><p> <br><p> The label will not added for objects referenced in `spec.excludedFromEnforcement`.<br><p> <br><p> The label's name is this field's value. The label's value is the namespace of the `ServiceMonitor`, `PodMonitor`, `Probe`, `PrometheusRule` or `ScrapeConfig` object.
+     */
     @JsonProperty("enforcedNamespaceLabel")
     public void setEnforcedNamespaceLabel(String enforcedNamespaceLabel) {
         this.enforcedNamespaceLabel = enforcedNamespaceLabel;
     }
 
+    /**
+     * When defined, enforcedSampleLimit specifies a global limit on the number of scraped samples that will be accepted. This overrides any `spec.sampleLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.sampleLimit` is greater than zero and less than `spec.enforcedSampleLimit`.<br><p> <br><p> It is meant to be used by admins to keep the overall number of samples/series under a desired limit.<br><p> <br><p> When both `enforcedSampleLimit` and `sampleLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined sampleLimit value will inherit the global sampleLimit value (Prometheus &gt;= 2.45.0) or the enforcedSampleLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedSampleLimit` is greater than the `sampleLimit`, the `sampleLimit` will be set to `enforcedSampleLimit`.<br><p> &#42; Scrape objects with a sampleLimit value less than or equal to enforcedSampleLimit keep their specific value. &#42; Scrape objects with a sampleLimit value greater than enforcedSampleLimit are set to enforcedSampleLimit.
+     */
     @JsonProperty("enforcedSampleLimit")
     public Long getEnforcedSampleLimit() {
         return enforcedSampleLimit;
     }
 
+    /**
+     * When defined, enforcedSampleLimit specifies a global limit on the number of scraped samples that will be accepted. This overrides any `spec.sampleLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.sampleLimit` is greater than zero and less than `spec.enforcedSampleLimit`.<br><p> <br><p> It is meant to be used by admins to keep the overall number of samples/series under a desired limit.<br><p> <br><p> When both `enforcedSampleLimit` and `sampleLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined sampleLimit value will inherit the global sampleLimit value (Prometheus &gt;= 2.45.0) or the enforcedSampleLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedSampleLimit` is greater than the `sampleLimit`, the `sampleLimit` will be set to `enforcedSampleLimit`.<br><p> &#42; Scrape objects with a sampleLimit value less than or equal to enforcedSampleLimit keep their specific value. &#42; Scrape objects with a sampleLimit value greater than enforcedSampleLimit are set to enforcedSampleLimit.
+     */
     @JsonProperty("enforcedSampleLimit")
     public void setEnforcedSampleLimit(Long enforcedSampleLimit) {
         this.enforcedSampleLimit = enforcedSampleLimit;
     }
 
+    /**
+     * When defined, enforcedTargetLimit specifies a global limit on the number of scraped targets. The value overrides any `spec.targetLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.targetLimit` is greater than zero and less than `spec.enforcedTargetLimit`.<br><p> <br><p> It is meant to be used by admins to to keep the overall number of targets under a desired limit.<br><p> <br><p> When both `enforcedTargetLimit` and `targetLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined targetLimit value will inherit the global targetLimit value (Prometheus &gt;= 2.45.0) or the enforcedTargetLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedTargetLimit` is greater than the `targetLimit`, the `targetLimit` will be set to `enforcedTargetLimit`.<br><p> &#42; Scrape objects with a targetLimit value less than or equal to enforcedTargetLimit keep their specific value. &#42; Scrape objects with a targetLimit value greater than enforcedTargetLimit are set to enforcedTargetLimit.
+     */
     @JsonProperty("enforcedTargetLimit")
     public Long getEnforcedTargetLimit() {
         return enforcedTargetLimit;
     }
 
+    /**
+     * When defined, enforcedTargetLimit specifies a global limit on the number of scraped targets. The value overrides any `spec.targetLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.targetLimit` is greater than zero and less than `spec.enforcedTargetLimit`.<br><p> <br><p> It is meant to be used by admins to to keep the overall number of targets under a desired limit.<br><p> <br><p> When both `enforcedTargetLimit` and `targetLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined targetLimit value will inherit the global targetLimit value (Prometheus &gt;= 2.45.0) or the enforcedTargetLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedTargetLimit` is greater than the `targetLimit`, the `targetLimit` will be set to `enforcedTargetLimit`.<br><p> &#42; Scrape objects with a targetLimit value less than or equal to enforcedTargetLimit keep their specific value. &#42; Scrape objects with a targetLimit value greater than enforcedTargetLimit are set to enforcedTargetLimit.
+     */
     @JsonProperty("enforcedTargetLimit")
     public void setEnforcedTargetLimit(Long enforcedTargetLimit) {
         this.enforcedTargetLimit = enforcedTargetLimit;
     }
 
+    /**
+     * List of references to PodMonitor, ServiceMonitor, Probe and PrometheusRule objects to be excluded from enforcing a namespace label of origin.<br><p> <br><p> It is only applicable if `spec.enforcedNamespaceLabel` set to true.
+     */
     @JsonProperty("excludedFromEnforcement")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ObjectReference> getExcludedFromEnforcement() {
         return excludedFromEnforcement;
     }
 
+    /**
+     * List of references to PodMonitor, ServiceMonitor, Probe and PrometheusRule objects to be excluded from enforcing a namespace label of origin.<br><p> <br><p> It is only applicable if `spec.enforcedNamespaceLabel` set to true.
+     */
     @JsonProperty("excludedFromEnforcement")
     public void setExcludedFromEnforcement(List<ObjectReference> excludedFromEnforcement) {
         this.excludedFromEnforcement = excludedFromEnforcement;
     }
 
+    /**
+     * The labels to add to any time series or alerts when communicating with external systems (federation, remote storage, Alertmanager). Labels defined by `spec.replicaExternalLabelName` and `spec.prometheusExternalLabelName` take precedence over this list.
+     */
     @JsonProperty("externalLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getExternalLabels() {
         return externalLabels;
     }
 
+    /**
+     * The labels to add to any time series or alerts when communicating with external systems (federation, remote storage, Alertmanager). Labels defined by `spec.replicaExternalLabelName` and `spec.prometheusExternalLabelName` take precedence over this list.
+     */
     @JsonProperty("externalLabels")
     public void setExternalLabels(Map<String, String> externalLabels) {
         this.externalLabels = externalLabels;
     }
 
+    /**
+     * The external URL under which the Prometheus service is externally available. This is necessary to generate correct URLs (for instance if Prometheus is accessible behind an Ingress resource).
+     */
     @JsonProperty("externalUrl")
     public String getExternalUrl() {
         return externalUrl;
     }
 
+    /**
+     * The external URL under which the Prometheus service is externally available. This is necessary to generate correct URLs (for instance if Prometheus is accessible behind an Ingress resource).
+     */
     @JsonProperty("externalUrl")
     public void setExternalUrl(String externalUrl) {
         this.externalUrl = externalUrl;
     }
 
+    /**
+     * Optional list of hosts and IPs that will be injected into the Pod's hosts file if specified.
+     */
     @JsonProperty("hostAliases")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HostAlias> getHostAliases() {
         return hostAliases;
     }
 
+    /**
+     * Optional list of hosts and IPs that will be injected into the Pod's hosts file if specified.
+     */
     @JsonProperty("hostAliases")
     public void setHostAliases(List<HostAlias> hostAliases) {
         this.hostAliases = hostAliases;
     }
 
+    /**
+     * Use the host's network namespace if true.<br><p> <br><p> Make sure to understand the security implications if you want to enable it (https://kubernetes.io/docs/concepts/configuration/overview/).<br><p> <br><p> When hostNetwork is enabled, this will set the DNS policy to `ClusterFirstWithHostNet` automatically (unless `.spec.DNSPolicy` is set to a different value).
+     */
     @JsonProperty("hostNetwork")
     public Boolean getHostNetwork() {
         return hostNetwork;
     }
 
+    /**
+     * Use the host's network namespace if true.<br><p> <br><p> Make sure to understand the security implications if you want to enable it (https://kubernetes.io/docs/concepts/configuration/overview/).<br><p> <br><p> When hostNetwork is enabled, this will set the DNS policy to `ClusterFirstWithHostNet` automatically (unless `.spec.DNSPolicy` is set to a different value).
+     */
     @JsonProperty("hostNetwork")
     public void setHostNetwork(Boolean hostNetwork) {
         this.hostNetwork = hostNetwork;
     }
 
+    /**
+     * When true, `spec.namespaceSelector` from all PodMonitor, ServiceMonitor and Probe objects will be ignored. They will only discover targets within the namespace of the PodMonitor, ServiceMonitor and Probe object.
+     */
     @JsonProperty("ignoreNamespaceSelectors")
     public Boolean getIgnoreNamespaceSelectors() {
         return ignoreNamespaceSelectors;
     }
 
+    /**
+     * When true, `spec.namespaceSelector` from all PodMonitor, ServiceMonitor and Probe objects will be ignored. They will only discover targets within the namespace of the PodMonitor, ServiceMonitor and Probe object.
+     */
     @JsonProperty("ignoreNamespaceSelectors")
     public void setIgnoreNamespaceSelectors(Boolean ignoreNamespaceSelectors) {
         this.ignoreNamespaceSelectors = ignoreNamespaceSelectors;
     }
 
+    /**
+     * Container image name for Prometheus. If specified, it takes precedence over the `spec.baseImage`, `spec.tag` and `spec.sha` fields.<br><p> <br><p> Specifying `spec.version` is still necessary to ensure the Prometheus Operator knows which version of Prometheus is being configured.<br><p> <br><p> If neither `spec.image` nor `spec.baseImage` are defined, the operator will use the latest upstream version of Prometheus available at the time when the operator was released.
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * Container image name for Prometheus. If specified, it takes precedence over the `spec.baseImage`, `spec.tag` and `spec.sha` fields.<br><p> <br><p> Specifying `spec.version` is still necessary to ensure the Prometheus Operator knows which version of Prometheus is being configured.<br><p> <br><p> If neither `spec.image` nor `spec.baseImage` are defined, the operator will use the latest upstream version of Prometheus available at the time when the operator was released.
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
     }
 
+    /**
+     * Image pull policy for the 'prometheus', 'init-config-reloader' and 'config-reloader' containers. See https://kubernetes.io/docs/concepts/containers/images/#image-pull-policy for more details.<br><p> <br><p> Possible enum values:<br><p>  - `"Always"` means that kubelet always attempts to pull the latest image. Container will fail If the pull fails.<br><p>  - `"IfNotPresent"` means that kubelet pulls if the image isn't present on disk. Container will fail if the image isn't present and the pull fails.<br><p>  - `"Never"` means that kubelet never pulls an image, but only uses a local image. Container will fail if the image isn't present
+     */
     @JsonProperty("imagePullPolicy")
     public String getImagePullPolicy() {
         return imagePullPolicy;
     }
 
+    /**
+     * Image pull policy for the 'prometheus', 'init-config-reloader' and 'config-reloader' containers. See https://kubernetes.io/docs/concepts/containers/images/#image-pull-policy for more details.<br><p> <br><p> Possible enum values:<br><p>  - `"Always"` means that kubelet always attempts to pull the latest image. Container will fail If the pull fails.<br><p>  - `"IfNotPresent"` means that kubelet pulls if the image isn't present on disk. Container will fail if the image isn't present and the pull fails.<br><p>  - `"Never"` means that kubelet never pulls an image, but only uses a local image. Container will fail if the image isn't present
+     */
     @JsonProperty("imagePullPolicy")
     public void setImagePullPolicy(String imagePullPolicy) {
         this.imagePullPolicy = imagePullPolicy;
     }
 
+    /**
+     * An optional list of references to Secrets in the same namespace to use for pulling images from registries. See http://kubernetes.io/docs/user-guide/images#specifying-imagepullsecrets-on-a-pod
+     */
     @JsonProperty("imagePullSecrets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LocalObjectReference> getImagePullSecrets() {
         return imagePullSecrets;
     }
 
+    /**
+     * An optional list of references to Secrets in the same namespace to use for pulling images from registries. See http://kubernetes.io/docs/user-guide/images#specifying-imagepullsecrets-on-a-pod
+     */
     @JsonProperty("imagePullSecrets")
     public void setImagePullSecrets(List<LocalObjectReference> imagePullSecrets) {
         this.imagePullSecrets = imagePullSecrets;
     }
 
+    /**
+     * InitContainers allows injecting initContainers to the Pod definition. Those can be used to e.g.  fetch secrets for injection into the Prometheus configuration from external sources. Any errors during the execution of an initContainer will lead to a restart of the Pod. More info: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/ InitContainers described here modify an operator generated init containers if they share the same name and modifications are done via a strategic merge patch.<br><p> <br><p> The names of init container name managed by the operator are: &#42; `init-config-reloader`.<br><p> <br><p> Overriding init containers is entirely outside the scope of what the maintainers will support and by doing so, you accept that this behaviour may break at any time without notice.
+     */
     @JsonProperty("initContainers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Container> getInitContainers() {
         return initContainers;
     }
 
+    /**
+     * InitContainers allows injecting initContainers to the Pod definition. Those can be used to e.g.  fetch secrets for injection into the Prometheus configuration from external sources. Any errors during the execution of an initContainer will lead to a restart of the Pod. More info: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/ InitContainers described here modify an operator generated init containers if they share the same name and modifications are done via a strategic merge patch.<br><p> <br><p> The names of init container name managed by the operator are: &#42; `init-config-reloader`.<br><p> <br><p> Overriding init containers is entirely outside the scope of what the maintainers will support and by doing so, you accept that this behaviour may break at any time without notice.
+     */
     @JsonProperty("initContainers")
     public void setInitContainers(List<Container> initContainers) {
         this.initContainers = initContainers;
     }
 
+    /**
+     * Per-scrape limit on the number of targets dropped by relabeling that will be kept in memory. 0 means no limit.<br><p> <br><p> It requires Prometheus &gt;= v2.47.0.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedKeepDroppedTargets.
+     */
     @JsonProperty("keepDroppedTargets")
     public Long getKeepDroppedTargets() {
         return keepDroppedTargets;
     }
 
+    /**
+     * Per-scrape limit on the number of targets dropped by relabeling that will be kept in memory. 0 means no limit.<br><p> <br><p> It requires Prometheus &gt;= v2.47.0.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedKeepDroppedTargets.
+     */
     @JsonProperty("keepDroppedTargets")
     public void setKeepDroppedTargets(Long keepDroppedTargets) {
         this.keepDroppedTargets = keepDroppedTargets;
     }
 
+    /**
+     * Per-scrape limit on number of labels that will be accepted for a sample. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedLabelLimit.
+     */
     @JsonProperty("labelLimit")
     public Long getLabelLimit() {
         return labelLimit;
     }
 
+    /**
+     * Per-scrape limit on number of labels that will be accepted for a sample. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedLabelLimit.
+     */
     @JsonProperty("labelLimit")
     public void setLabelLimit(Long labelLimit) {
         this.labelLimit = labelLimit;
     }
 
+    /**
+     * Per-scrape limit on length of labels name that will be accepted for a sample. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedLabelNameLengthLimit.
+     */
     @JsonProperty("labelNameLengthLimit")
     public Long getLabelNameLengthLimit() {
         return labelNameLengthLimit;
     }
 
+    /**
+     * Per-scrape limit on length of labels name that will be accepted for a sample. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedLabelNameLengthLimit.
+     */
     @JsonProperty("labelNameLengthLimit")
     public void setLabelNameLengthLimit(Long labelNameLengthLimit) {
         this.labelNameLengthLimit = labelNameLengthLimit;
     }
 
+    /**
+     * Per-scrape limit on length of labels value that will be accepted for a sample. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedLabelValueLengthLimit.
+     */
     @JsonProperty("labelValueLengthLimit")
     public Long getLabelValueLengthLimit() {
         return labelValueLengthLimit;
     }
 
+    /**
+     * Per-scrape limit on length of labels value that will be accepted for a sample. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedLabelValueLengthLimit.
+     */
     @JsonProperty("labelValueLengthLimit")
     public void setLabelValueLengthLimit(Long labelValueLengthLimit) {
         this.labelValueLengthLimit = labelValueLengthLimit;
     }
 
+    /**
+     * When true, the Prometheus server listens on the loopback address instead of the Pod IP's address.
+     */
     @JsonProperty("listenLocal")
     public Boolean getListenLocal() {
         return listenLocal;
     }
 
+    /**
+     * When true, the Prometheus server listens on the loopback address instead of the Pod IP's address.
+     */
     @JsonProperty("listenLocal")
     public void setListenLocal(Boolean listenLocal) {
         this.listenLocal = listenLocal;
     }
 
+    /**
+     * Log format for Log level for Prometheus and the config-reloader sidecar.
+     */
     @JsonProperty("logFormat")
     public String getLogFormat() {
         return logFormat;
     }
 
+    /**
+     * Log format for Log level for Prometheus and the config-reloader sidecar.
+     */
     @JsonProperty("logFormat")
     public void setLogFormat(String logFormat) {
         this.logFormat = logFormat;
     }
 
+    /**
+     * Log level for Prometheus and the config-reloader sidecar.
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * Log level for Prometheus and the config-reloader sidecar.
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * Defines the maximum time that the `prometheus` container's startup probe will wait before being considered failed. The startup probe will return success after the WAL replay is complete. If set, the value should be greater than 60 (seconds). Otherwise it will be equal to 600 seconds (15 minutes).
+     */
     @JsonProperty("maximumStartupDurationSeconds")
     public Integer getMaximumStartupDurationSeconds() {
         return maximumStartupDurationSeconds;
     }
 
+    /**
+     * Defines the maximum time that the `prometheus` container's startup probe will wait before being considered failed. The startup probe will return success after the WAL replay is complete. If set, the value should be greater than 60 (seconds). Otherwise it will be equal to 600 seconds (15 minutes).
+     */
     @JsonProperty("maximumStartupDurationSeconds")
     public void setMaximumStartupDurationSeconds(Integer maximumStartupDurationSeconds) {
         this.maximumStartupDurationSeconds = maximumStartupDurationSeconds;
     }
 
+    /**
+     * Minimum number of seconds for which a newly created Pod should be ready without any of its container crashing for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready)<br><p> <br><p> This is an alpha field from kubernetes 1.22 until 1.24 which requires enabling the StatefulSetMinReadySeconds feature gate.
+     */
     @JsonProperty("minReadySeconds")
     public Long getMinReadySeconds() {
         return minReadySeconds;
     }
 
+    /**
+     * Minimum number of seconds for which a newly created Pod should be ready without any of its container crashing for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready)<br><p> <br><p> This is an alpha field from kubernetes 1.22 until 1.24 which requires enabling the StatefulSetMinReadySeconds feature gate.
+     */
     @JsonProperty("minReadySeconds")
     public void setMinReadySeconds(Long minReadySeconds) {
         this.minReadySeconds = minReadySeconds;
     }
 
+    /**
+     * Specifies the validation scheme for metric and label names.
+     */
     @JsonProperty("nameValidationScheme")
     public String getNameValidationScheme() {
         return nameValidationScheme;
     }
 
+    /**
+     * Specifies the validation scheme for metric and label names.
+     */
     @JsonProperty("nameValidationScheme")
     public void setNameValidationScheme(String nameValidationScheme) {
         this.nameValidationScheme = nameValidationScheme;
     }
 
+    /**
+     * Defines on which Nodes the Pods are scheduled.
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * Defines on which Nodes the Pods are scheduled.
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("otlp")
     public OTLPConfig getOtlp() {
         return otlp;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("otlp")
     public void setOtlp(OTLPConfig otlp) {
         this.otlp = otlp;
     }
 
+    /**
+     * When true, Prometheus resolves label conflicts by renaming the labels in the scraped data<br><p>  to "exported_" for all targets created from ServiceMonitor, PodMonitor and<br><p> ScrapeConfig objects. Otherwise the HonorLabels field of the service or pod monitor applies. In practice,`overrideHonorLaels:true` enforces `honorLabels:false` for all ServiceMonitor, PodMonitor and ScrapeConfig objects.
+     */
     @JsonProperty("overrideHonorLabels")
     public Boolean getOverrideHonorLabels() {
         return overrideHonorLabels;
     }
 
+    /**
+     * When true, Prometheus resolves label conflicts by renaming the labels in the scraped data<br><p>  to "exported_" for all targets created from ServiceMonitor, PodMonitor and<br><p> ScrapeConfig objects. Otherwise the HonorLabels field of the service or pod monitor applies. In practice,`overrideHonorLaels:true` enforces `honorLabels:false` for all ServiceMonitor, PodMonitor and ScrapeConfig objects.
+     */
     @JsonProperty("overrideHonorLabels")
     public void setOverrideHonorLabels(Boolean overrideHonorLabels) {
         this.overrideHonorLabels = overrideHonorLabels;
     }
 
+    /**
+     * When true, Prometheus ignores the timestamps for all the targets created from service and pod monitors. Otherwise the HonorTimestamps field of the service or pod monitor applies.
+     */
     @JsonProperty("overrideHonorTimestamps")
     public Boolean getOverrideHonorTimestamps() {
         return overrideHonorTimestamps;
     }
 
+    /**
+     * When true, Prometheus ignores the timestamps for all the targets created from service and pod monitors. Otherwise the HonorTimestamps field of the service or pod monitor applies.
+     */
     @JsonProperty("overrideHonorTimestamps")
     public void setOverrideHonorTimestamps(Boolean overrideHonorTimestamps) {
         this.overrideHonorTimestamps = overrideHonorTimestamps;
     }
 
+    /**
+     * When a Prometheus deployment is paused, no actions except for deletion will be performed on the underlying objects.
+     */
     @JsonProperty("paused")
     public Boolean getPaused() {
         return paused;
     }
 
+    /**
+     * When a Prometheus deployment is paused, no actions except for deletion will be performed on the underlying objects.
+     */
     @JsonProperty("paused")
     public void setPaused(Boolean paused) {
         this.paused = paused;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("persistentVolumeClaimRetentionPolicy")
     public StatefulSetPersistentVolumeClaimRetentionPolicy getPersistentVolumeClaimRetentionPolicy() {
         return persistentVolumeClaimRetentionPolicy;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("persistentVolumeClaimRetentionPolicy")
     public void setPersistentVolumeClaimRetentionPolicy(StatefulSetPersistentVolumeClaimRetentionPolicy persistentVolumeClaimRetentionPolicy) {
         this.persistentVolumeClaimRetentionPolicy = persistentVolumeClaimRetentionPolicy;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("podMetadata")
     public EmbeddedObjectMetadata getPodMetadata() {
         return podMetadata;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("podMetadata")
     public void setPodMetadata(EmbeddedObjectMetadata podMetadata) {
         this.podMetadata = podMetadata;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("podMonitorNamespaceSelector")
     public LabelSelector getPodMonitorNamespaceSelector() {
         return podMonitorNamespaceSelector;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("podMonitorNamespaceSelector")
     public void setPodMonitorNamespaceSelector(LabelSelector podMonitorNamespaceSelector) {
         this.podMonitorNamespaceSelector = podMonitorNamespaceSelector;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("podMonitorSelector")
     public LabelSelector getPodMonitorSelector() {
         return podMonitorSelector;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("podMonitorSelector")
     public void setPodMonitorSelector(LabelSelector podMonitorSelector) {
         this.podMonitorSelector = podMonitorSelector;
     }
 
+    /**
+     * PodTargetLabels are appended to the `spec.podTargetLabels` field of all PodMonitor and ServiceMonitor objects.
+     */
     @JsonProperty("podTargetLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPodTargetLabels() {
         return podTargetLabels;
     }
 
+    /**
+     * PodTargetLabels are appended to the `spec.podTargetLabels` field of all PodMonitor and ServiceMonitor objects.
+     */
     @JsonProperty("podTargetLabels")
     public void setPodTargetLabels(List<String> podTargetLabels) {
         this.podTargetLabels = podTargetLabels;
     }
 
+    /**
+     * Port name used for the pods and governing service. Default: "web"
+     */
     @JsonProperty("portName")
     public String getPortName() {
         return portName;
     }
 
+    /**
+     * Port name used for the pods and governing service. Default: "web"
+     */
     @JsonProperty("portName")
     public void setPortName(String portName) {
         this.portName = portName;
     }
 
+    /**
+     * Priority class assigned to the Pods.
+     */
     @JsonProperty("priorityClassName")
     public String getPriorityClassName() {
         return priorityClassName;
     }
 
+    /**
+     * Priority class assigned to the Pods.
+     */
     @JsonProperty("priorityClassName")
     public void setPriorityClassName(String priorityClassName) {
         this.priorityClassName = priorityClassName;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("probeNamespaceSelector")
     public LabelSelector getProbeNamespaceSelector() {
         return probeNamespaceSelector;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("probeNamespaceSelector")
     public void setProbeNamespaceSelector(LabelSelector probeNamespaceSelector) {
         this.probeNamespaceSelector = probeNamespaceSelector;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("probeSelector")
     public LabelSelector getProbeSelector() {
         return probeSelector;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("probeSelector")
     public void setProbeSelector(LabelSelector probeSelector) {
         this.probeSelector = probeSelector;
     }
 
+    /**
+     * Name of Prometheus external label used to denote the Prometheus instance name. The external label will _not_ be added when the field is set to the empty string (`""`).<br><p> <br><p> Default: "prometheus"
+     */
     @JsonProperty("prometheusExternalLabelName")
     public String getPrometheusExternalLabelName() {
         return prometheusExternalLabelName;
     }
 
+    /**
+     * Name of Prometheus external label used to denote the Prometheus instance name. The external label will _not_ be added when the field is set to the empty string (`""`).<br><p> <br><p> Default: "prometheus"
+     */
     @JsonProperty("prometheusExternalLabelName")
     public void setPrometheusExternalLabelName(String prometheusExternalLabelName) {
         this.prometheusExternalLabelName = prometheusExternalLabelName;
     }
 
+    /**
+     * Defines the strategy used to reload the Prometheus configuration. If not specified, the configuration is reloaded using the /-/reload HTTP endpoint.
+     */
     @JsonProperty("reloadStrategy")
     public String getReloadStrategy() {
         return reloadStrategy;
     }
 
+    /**
+     * Defines the strategy used to reload the Prometheus configuration. If not specified, the configuration is reloaded using the /-/reload HTTP endpoint.
+     */
     @JsonProperty("reloadStrategy")
     public void setReloadStrategy(String reloadStrategy) {
         this.reloadStrategy = reloadStrategy;
     }
 
+    /**
+     * Defines the list of remote write configurations.
+     */
     @JsonProperty("remoteWrite")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RemoteWriteSpec> getRemoteWrite() {
         return remoteWrite;
     }
 
+    /**
+     * Defines the list of remote write configurations.
+     */
     @JsonProperty("remoteWrite")
     public void setRemoteWrite(List<RemoteWriteSpec> remoteWrite) {
         this.remoteWrite = remoteWrite;
     }
 
+    /**
+     * List of the protobuf message versions to accept when receiving the remote writes.<br><p> <br><p> It requires Prometheus &gt;= v2.54.0.
+     */
     @JsonProperty("remoteWriteReceiverMessageVersions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getRemoteWriteReceiverMessageVersions() {
         return remoteWriteReceiverMessageVersions;
     }
 
+    /**
+     * List of the protobuf message versions to accept when receiving the remote writes.<br><p> <br><p> It requires Prometheus &gt;= v2.54.0.
+     */
     @JsonProperty("remoteWriteReceiverMessageVersions")
     public void setRemoteWriteReceiverMessageVersions(List<String> remoteWriteReceiverMessageVersions) {
         this.remoteWriteReceiverMessageVersions = remoteWriteReceiverMessageVersions;
     }
 
+    /**
+     * Name of Prometheus external label used to denote the replica name. The external label will _not_ be added when the field is set to the empty string (`""`).<br><p> <br><p> Default: "prometheus_replica"
+     */
     @JsonProperty("replicaExternalLabelName")
     public String getReplicaExternalLabelName() {
         return replicaExternalLabelName;
     }
 
+    /**
+     * Name of Prometheus external label used to denote the replica name. The external label will _not_ be added when the field is set to the empty string (`""`).<br><p> <br><p> Default: "prometheus_replica"
+     */
     @JsonProperty("replicaExternalLabelName")
     public void setReplicaExternalLabelName(String replicaExternalLabelName) {
         this.replicaExternalLabelName = replicaExternalLabelName;
     }
 
+    /**
+     * Number of replicas of each shard to deploy for a Prometheus deployment. `spec.replicas` multiplied by `spec.shards` is the total number of Pods created.<br><p> <br><p> Default: 1
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Number of replicas of each shard to deploy for a Prometheus deployment. `spec.replicas` multiplied by `spec.shards` is the total number of Pods created.<br><p> <br><p> Default: 1
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * The route prefix Prometheus registers HTTP handlers for.<br><p> <br><p> This is useful when using `spec.externalURL`, and a proxy is rewriting HTTP routes of a request, and the actual ExternalURL is still true, but the server serves requests under a different route prefix. For example for use with `kubectl proxy`.
+     */
     @JsonProperty("routePrefix")
     public String getRoutePrefix() {
         return routePrefix;
     }
 
+    /**
+     * The route prefix Prometheus registers HTTP handlers for.<br><p> <br><p> This is useful when using `spec.externalURL`, and a proxy is rewriting HTTP routes of a request, and the actual ExternalURL is still true, but the server serves requests under a different route prefix. For example for use with `kubectl proxy`.
+     */
     @JsonProperty("routePrefix")
     public void setRoutePrefix(String routePrefix) {
         this.routePrefix = routePrefix;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("runtime")
     public RuntimeConfig getRuntime() {
         return runtime;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("runtime")
     public void setRuntime(RuntimeConfig runtime) {
         this.runtime = runtime;
     }
 
+    /**
+     * SampleLimit defines per-scrape limit on number of scraped samples that will be accepted. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedSampleLimit.
+     */
     @JsonProperty("sampleLimit")
     public Long getSampleLimit() {
         return sampleLimit;
     }
 
+    /**
+     * SampleLimit defines per-scrape limit on number of scraped samples that will be accepted. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedSampleLimit.
+     */
     @JsonProperty("sampleLimit")
     public void setSampleLimit(Long sampleLimit) {
         this.sampleLimit = sampleLimit;
     }
 
+    /**
+     * List of scrape classes to expose to scraping objects such as PodMonitors, ServiceMonitors, Probes and ScrapeConfigs.<br><p> <br><p> This is an &#42;experimental feature&#42;, it may change in any upcoming release in a breaking way.
+     */
     @JsonProperty("scrapeClasses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ScrapeClass> getScrapeClasses() {
         return scrapeClasses;
     }
 
+    /**
+     * List of scrape classes to expose to scraping objects such as PodMonitors, ServiceMonitors, Probes and ScrapeConfigs.<br><p> <br><p> This is an &#42;experimental feature&#42;, it may change in any upcoming release in a breaking way.
+     */
     @JsonProperty("scrapeClasses")
     public void setScrapeClasses(List<ScrapeClass> scrapeClasses) {
         this.scrapeClasses = scrapeClasses;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("scrapeConfigNamespaceSelector")
     public LabelSelector getScrapeConfigNamespaceSelector() {
         return scrapeConfigNamespaceSelector;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("scrapeConfigNamespaceSelector")
     public void setScrapeConfigNamespaceSelector(LabelSelector scrapeConfigNamespaceSelector) {
         this.scrapeConfigNamespaceSelector = scrapeConfigNamespaceSelector;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("scrapeConfigSelector")
     public LabelSelector getScrapeConfigSelector() {
         return scrapeConfigSelector;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("scrapeConfigSelector")
     public void setScrapeConfigSelector(LabelSelector scrapeConfigSelector) {
         this.scrapeConfigSelector = scrapeConfigSelector;
     }
 
+    /**
+     * Interval between consecutive scrapes.<br><p> <br><p> Default: "30s"
+     */
     @JsonProperty("scrapeInterval")
     public String getScrapeInterval() {
         return scrapeInterval;
     }
 
+    /**
+     * Interval between consecutive scrapes.<br><p> <br><p> Default: "30s"
+     */
     @JsonProperty("scrapeInterval")
     public void setScrapeInterval(String scrapeInterval) {
         this.scrapeInterval = scrapeInterval;
     }
 
+    /**
+     * The protocols to negotiate during a scrape. It tells clients the protocols supported by Prometheus in order of preference (from most to least preferred).<br><p> <br><p> If unset, Prometheus uses its default value.<br><p> <br><p> It requires Prometheus &gt;= v2.49.0.<br><p> <br><p> `PrometheusText1.0.0` requires Prometheus &gt;= v3.0.0.
+     */
     @JsonProperty("scrapeProtocols")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getScrapeProtocols() {
         return scrapeProtocols;
     }
 
+    /**
+     * The protocols to negotiate during a scrape. It tells clients the protocols supported by Prometheus in order of preference (from most to least preferred).<br><p> <br><p> If unset, Prometheus uses its default value.<br><p> <br><p> It requires Prometheus &gt;= v2.49.0.<br><p> <br><p> `PrometheusText1.0.0` requires Prometheus &gt;= v3.0.0.
+     */
     @JsonProperty("scrapeProtocols")
     public void setScrapeProtocols(List<String> scrapeProtocols) {
         this.scrapeProtocols = scrapeProtocols;
     }
 
+    /**
+     * Number of seconds to wait until a scrape request times out.
+     */
     @JsonProperty("scrapeTimeout")
     public String getScrapeTimeout() {
         return scrapeTimeout;
     }
 
+    /**
+     * Number of seconds to wait until a scrape request times out.
+     */
     @JsonProperty("scrapeTimeout")
     public void setScrapeTimeout(String scrapeTimeout) {
         this.scrapeTimeout = scrapeTimeout;
     }
 
+    /**
+     * Secrets is a list of Secrets in the same namespace as the Prometheus object, which shall be mounted into the Prometheus Pods. Each Secret is added to the StatefulSet definition as a volume named `secret-&lt;secret-name&gt;`. The Secrets are mounted into /etc/prometheus/secrets/&lt;secret-name&gt; in the 'prometheus' container.
+     */
     @JsonProperty("secrets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSecrets() {
         return secrets;
     }
 
+    /**
+     * Secrets is a list of Secrets in the same namespace as the Prometheus object, which shall be mounted into the Prometheus Pods. Each Secret is added to the StatefulSet definition as a volume named `secret-&lt;secret-name&gt;`. The Secrets are mounted into /etc/prometheus/secrets/&lt;secret-name&gt; in the 'prometheus' container.
+     */
     @JsonProperty("secrets")
     public void setSecrets(List<String> secrets) {
         this.secrets = secrets;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("securityContext")
     public PodSecurityContext getSecurityContext() {
         return securityContext;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("securityContext")
     public void setSecurityContext(PodSecurityContext securityContext) {
         this.securityContext = securityContext;
     }
 
+    /**
+     * ServiceAccountName is the name of the ServiceAccount to use to run the Prometheus Pods.
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * ServiceAccountName is the name of the ServiceAccount to use to run the Prometheus Pods.
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * Defines the service discovery role used to discover targets from `ServiceMonitor` objects and Alertmanager endpoints.<br><p> <br><p> If set, the value should be either "Endpoints" or "EndpointSlice". If unset, the operator assumes the "Endpoints" role.
+     */
     @JsonProperty("serviceDiscoveryRole")
     public String getServiceDiscoveryRole() {
         return serviceDiscoveryRole;
     }
 
+    /**
+     * Defines the service discovery role used to discover targets from `ServiceMonitor` objects and Alertmanager endpoints.<br><p> <br><p> If set, the value should be either "Endpoints" or "EndpointSlice". If unset, the operator assumes the "Endpoints" role.
+     */
     @JsonProperty("serviceDiscoveryRole")
     public void setServiceDiscoveryRole(String serviceDiscoveryRole) {
         this.serviceDiscoveryRole = serviceDiscoveryRole;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("serviceMonitorNamespaceSelector")
     public LabelSelector getServiceMonitorNamespaceSelector() {
         return serviceMonitorNamespaceSelector;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("serviceMonitorNamespaceSelector")
     public void setServiceMonitorNamespaceSelector(LabelSelector serviceMonitorNamespaceSelector) {
         this.serviceMonitorNamespaceSelector = serviceMonitorNamespaceSelector;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("serviceMonitorSelector")
     public LabelSelector getServiceMonitorSelector() {
         return serviceMonitorSelector;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("serviceMonitorSelector")
     public void setServiceMonitorSelector(LabelSelector serviceMonitorSelector) {
         this.serviceMonitorSelector = serviceMonitorSelector;
     }
 
+    /**
+     * Number of shards to distribute scraped targets onto.<br><p> <br><p> `spec.replicas` multiplied by `spec.shards` is the total number of Pods being created.<br><p> <br><p> When not defined, the operator assumes only one shard.<br><p> <br><p> Note that scaling down shards will not reshard data onto the remaining instances, it must be manually moved. Increasing shards will not reshard data either but it will continue to be available from the same instances. To query globally, use Thanos sidecar and Thanos querier or remote write data to a central location. Alerting and recording rules<br><p> <br><p> By default, the sharding is performed on: &#42; The `__address__` target's metadata label for PodMonitor, ServiceMonitor and ScrapeConfig resources. &#42; The `__param_target__` label for Probe resources.<br><p> <br><p> Users can define their own sharding implementation by setting the `__tmp_hash` label during the target discovery with relabeling configuration (either in the monitoring resources or via scrape class).
+     */
     @JsonProperty("shards")
     public Integer getShards() {
         return shards;
     }
 
+    /**
+     * Number of shards to distribute scraped targets onto.<br><p> <br><p> `spec.replicas` multiplied by `spec.shards` is the total number of Pods being created.<br><p> <br><p> When not defined, the operator assumes only one shard.<br><p> <br><p> Note that scaling down shards will not reshard data onto the remaining instances, it must be manually moved. Increasing shards will not reshard data either but it will continue to be available from the same instances. To query globally, use Thanos sidecar and Thanos querier or remote write data to a central location. Alerting and recording rules<br><p> <br><p> By default, the sharding is performed on: &#42; The `__address__` target's metadata label for PodMonitor, ServiceMonitor and ScrapeConfig resources. &#42; The `__param_target__` label for Probe resources.<br><p> <br><p> Users can define their own sharding implementation by setting the `__tmp_hash` label during the target discovery with relabeling configuration (either in the monitoring resources or via scrape class).
+     */
     @JsonProperty("shards")
     public void setShards(Integer shards) {
         this.shards = shards;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("storage")
     public StorageSpec getStorage() {
         return storage;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("storage")
     public void setStorage(StorageSpec storage) {
         this.storage = storage;
     }
 
+    /**
+     * TargetLimit defines a limit on the number of scraped targets that will be accepted. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedTargetLimit.
+     */
     @JsonProperty("targetLimit")
     public Long getTargetLimit() {
         return targetLimit;
     }
 
+    /**
+     * TargetLimit defines a limit on the number of scraped targets that will be accepted. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedTargetLimit.
+     */
     @JsonProperty("targetLimit")
     public void setTargetLimit(Long targetLimit) {
         this.targetLimit = targetLimit;
     }
 
+    /**
+     * Defines the Pods' tolerations if specified.
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * Defines the Pods' tolerations if specified.
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
     }
 
+    /**
+     * Defines the pod's topology spread constraints if specified.
+     */
     @JsonProperty("topologySpreadConstraints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TopologySpreadConstraint> getTopologySpreadConstraints() {
         return topologySpreadConstraints;
     }
 
+    /**
+     * Defines the pod's topology spread constraints if specified.
+     */
     @JsonProperty("topologySpreadConstraints")
     public void setTopologySpreadConstraints(List<TopologySpreadConstraint> topologySpreadConstraints) {
         this.topologySpreadConstraints = topologySpreadConstraints;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("tracingConfig")
     public PrometheusTracingConfig getTracingConfig() {
         return tracingConfig;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("tracingConfig")
     public void setTracingConfig(PrometheusTracingConfig tracingConfig) {
         this.tracingConfig = tracingConfig;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("tsdb")
     public TSDBSpec getTsdb() {
         return tsdb;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("tsdb")
     public void setTsdb(TSDBSpec tsdb) {
         this.tsdb = tsdb;
     }
 
+    /**
+     * Version of Prometheus being deployed. The operator uses this information to generate the Prometheus StatefulSet + configuration files.<br><p> <br><p> If not specified, the operator assumes the latest upstream version of Prometheus available at the time when the version of the operator was released.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * Version of Prometheus being deployed. The operator uses this information to generate the Prometheus StatefulSet + configuration files.<br><p> <br><p> If not specified, the operator assumes the latest upstream version of Prometheus available at the time when the version of the operator was released.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
     }
 
+    /**
+     * VolumeMounts allows the configuration of additional VolumeMounts.<br><p> <br><p> VolumeMounts will be appended to other VolumeMounts in the 'prometheus' container, that are generated as a result of StorageSpec objects.
+     */
     @JsonProperty("volumeMounts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VolumeMount> getVolumeMounts() {
         return volumeMounts;
     }
 
+    /**
+     * VolumeMounts allows the configuration of additional VolumeMounts.<br><p> <br><p> VolumeMounts will be appended to other VolumeMounts in the 'prometheus' container, that are generated as a result of StorageSpec objects.
+     */
     @JsonProperty("volumeMounts")
     public void setVolumeMounts(List<VolumeMount> volumeMounts) {
         this.volumeMounts = volumeMounts;
     }
 
+    /**
+     * Volumes allows the configuration of additional volumes on the output StatefulSet definition. Volumes specified will be appended to other volumes that are generated as a result of StorageSpec objects.
+     */
     @JsonProperty("volumes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Volume> getVolumes() {
         return volumes;
     }
 
+    /**
+     * Volumes allows the configuration of additional volumes on the output StatefulSet definition. Volumes specified will be appended to other volumes that are generated as a result of StorageSpec objects.
+     */
     @JsonProperty("volumes")
     public void setVolumes(List<Volume> volumes) {
         this.volumes = volumes;
     }
 
+    /**
+     * Configures compression of the write-ahead log (WAL) using Snappy.<br><p> <br><p> WAL compression is enabled by default for Prometheus &gt;= 2.20.0<br><p> <br><p> Requires Prometheus v2.11.0 and above.
+     */
     @JsonProperty("walCompression")
     public Boolean getWalCompression() {
         return walCompression;
     }
 
+    /**
+     * Configures compression of the write-ahead log (WAL) using Snappy.<br><p> <br><p> WAL compression is enabled by default for Prometheus &gt;= 2.20.0<br><p> <br><p> Requires Prometheus v2.11.0 and above.
+     */
     @JsonProperty("walCompression")
     public void setWalCompression(Boolean walCompression) {
         this.walCompression = walCompression;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("web")
     public PrometheusWebSpec getWeb() {
         return web;
     }
 
+    /**
+     * CommonPrometheusFields are the options available to both the Prometheus server and agent.
+     */
     @JsonProperty("web")
     public void setWeb(PrometheusWebSpec web) {
         this.web = web;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Condition.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Condition.java
index b0316ee9d6b..fc6a9255c11 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Condition.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Condition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Condition represents the state of the resources associated with the Prometheus, Alertmanager or ThanosRuler resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public Condition(String lastTransitionTime, String message, Long observedGenerat
         this.type = type;
     }
 
+    /**
+     * Condition represents the state of the resources associated with the Prometheus, Alertmanager or ThanosRuler resource.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * Condition represents the state of the resources associated with the Prometheus, Alertmanager or ThanosRuler resource.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Human-readable message indicating details for the condition's last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Human-readable message indicating details for the condition's last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * ObservedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if `.metadata.generation` is currently 12, but the `.status.conditions[].observedGeneration` is 9, the condition is out of date with respect to the current state of the instance.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if `.metadata.generation` is currently 12, but the `.status.conditions[].observedGeneration` is 9, the condition is out of date with respect to the current state of the instance.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of the condition.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type of the condition being reported.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of the condition being reported.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/CoreV1TopologySpreadConstraint.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/CoreV1TopologySpreadConstraint.java
index 3c1c022c9e8..87c7a2ea1b1 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/CoreV1TopologySpreadConstraint.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/CoreV1TopologySpreadConstraint.java
@@ -119,72 +119,114 @@ public void setLabelSelector(LabelSelector labelSelector) {
         this.labelSelector = labelSelector;
     }
 
+    /**
+     * MatchLabelKeys is a set of pod label keys to select the pods over which spreading will be calculated. The keys are used to lookup values from the incoming pod labels, those key-value labels are ANDed with labelSelector to select the group of existing pods over which spreading will be calculated for the incoming pod. The same key is forbidden to exist in both MatchLabelKeys and LabelSelector. MatchLabelKeys cannot be set when LabelSelector isn't set. Keys that don't exist in the incoming pod labels will be ignored. A null or empty list means only match against labelSelector.<br><p> <br><p> This is a beta field and requires the MatchLabelKeysInPodTopologySpread feature gate to be enabled (enabled by default).
+     */
     @JsonProperty("matchLabelKeys")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMatchLabelKeys() {
         return matchLabelKeys;
     }
 
+    /**
+     * MatchLabelKeys is a set of pod label keys to select the pods over which spreading will be calculated. The keys are used to lookup values from the incoming pod labels, those key-value labels are ANDed with labelSelector to select the group of existing pods over which spreading will be calculated for the incoming pod. The same key is forbidden to exist in both MatchLabelKeys and LabelSelector. MatchLabelKeys cannot be set when LabelSelector isn't set. Keys that don't exist in the incoming pod labels will be ignored. A null or empty list means only match against labelSelector.<br><p> <br><p> This is a beta field and requires the MatchLabelKeysInPodTopologySpread feature gate to be enabled (enabled by default).
+     */
     @JsonProperty("matchLabelKeys")
     public void setMatchLabelKeys(List<String> matchLabelKeys) {
         this.matchLabelKeys = matchLabelKeys;
     }
 
+    /**
+     * MaxSkew describes the degree to which pods may be unevenly distributed. When `whenUnsatisfiable=DoNotSchedule`, it is the maximum permitted difference between the number of matching pods in the target topology and the global minimum. The global minimum is the minimum number of matching pods in an eligible domain or zero if the number of eligible domains is less than MinDomains. For example, in a 3-zone cluster, MaxSkew is set to 1, and pods with the same labelSelector spread as 2/2/1: In this case, the global minimum is 1. | zone1 | zone2 | zone3 | |  P P  |  P P  |   P   | - if MaxSkew is 1, incoming pod can only be scheduled to zone3 to become 2/2/2; scheduling it onto zone1(zone2) would make the ActualSkew(3-1) on zone1(zone2) violate MaxSkew(1). - if MaxSkew is 2, incoming pod can be scheduled onto any zone. When `whenUnsatisfiable=ScheduleAnyway`, it is used to give higher precedence to topologies that satisfy it. It's a required field. Default value is 1 and 0 is not allowed.
+     */
     @JsonProperty("maxSkew")
     public Integer getMaxSkew() {
         return maxSkew;
     }
 
+    /**
+     * MaxSkew describes the degree to which pods may be unevenly distributed. When `whenUnsatisfiable=DoNotSchedule`, it is the maximum permitted difference between the number of matching pods in the target topology and the global minimum. The global minimum is the minimum number of matching pods in an eligible domain or zero if the number of eligible domains is less than MinDomains. For example, in a 3-zone cluster, MaxSkew is set to 1, and pods with the same labelSelector spread as 2/2/1: In this case, the global minimum is 1. | zone1 | zone2 | zone3 | |  P P  |  P P  |   P   | - if MaxSkew is 1, incoming pod can only be scheduled to zone3 to become 2/2/2; scheduling it onto zone1(zone2) would make the ActualSkew(3-1) on zone1(zone2) violate MaxSkew(1). - if MaxSkew is 2, incoming pod can be scheduled onto any zone. When `whenUnsatisfiable=ScheduleAnyway`, it is used to give higher precedence to topologies that satisfy it. It's a required field. Default value is 1 and 0 is not allowed.
+     */
     @JsonProperty("maxSkew")
     public void setMaxSkew(Integer maxSkew) {
         this.maxSkew = maxSkew;
     }
 
+    /**
+     * MinDomains indicates a minimum number of eligible domains. When the number of eligible domains with matching topology keys is less than minDomains, Pod Topology Spread treats "global minimum" as 0, and then the calculation of Skew is performed. And when the number of eligible domains with matching topology keys equals or greater than minDomains, this value has no effect on scheduling. As a result, when the number of eligible domains is less than minDomains, scheduler won't schedule more than maxSkew Pods to those domains. If value is nil, the constraint behaves as if MinDomains is equal to 1. Valid values are integers greater than 0. When value is not nil, WhenUnsatisfiable must be DoNotSchedule.<br><p> <br><p> For example, in a 3-zone cluster, MaxSkew is set to 2, MinDomains is set to 5 and pods with the same labelSelector spread as 2/2/2: | zone1 | zone2 | zone3 | |  P P  |  P P  |  P P  | The number of domains is less than 5(MinDomains), so "global minimum" is treated as 0. In this situation, new pod with the same labelSelector cannot be scheduled, because computed skew will be 3(3 - 0) if new Pod is scheduled to any of the three zones, it will violate MaxSkew.
+     */
     @JsonProperty("minDomains")
     public Integer getMinDomains() {
         return minDomains;
     }
 
+    /**
+     * MinDomains indicates a minimum number of eligible domains. When the number of eligible domains with matching topology keys is less than minDomains, Pod Topology Spread treats "global minimum" as 0, and then the calculation of Skew is performed. And when the number of eligible domains with matching topology keys equals or greater than minDomains, this value has no effect on scheduling. As a result, when the number of eligible domains is less than minDomains, scheduler won't schedule more than maxSkew Pods to those domains. If value is nil, the constraint behaves as if MinDomains is equal to 1. Valid values are integers greater than 0. When value is not nil, WhenUnsatisfiable must be DoNotSchedule.<br><p> <br><p> For example, in a 3-zone cluster, MaxSkew is set to 2, MinDomains is set to 5 and pods with the same labelSelector spread as 2/2/2: | zone1 | zone2 | zone3 | |  P P  |  P P  |  P P  | The number of domains is less than 5(MinDomains), so "global minimum" is treated as 0. In this situation, new pod with the same labelSelector cannot be scheduled, because computed skew will be 3(3 - 0) if new Pod is scheduled to any of the three zones, it will violate MaxSkew.
+     */
     @JsonProperty("minDomains")
     public void setMinDomains(Integer minDomains) {
         this.minDomains = minDomains;
     }
 
+    /**
+     * NodeAffinityPolicy indicates how we will treat Pod's nodeAffinity/nodeSelector when calculating pod topology spread skew. Options are: - Honor: only nodes matching nodeAffinity/nodeSelector are included in the calculations. - Ignore: nodeAffinity/nodeSelector are ignored. All nodes are included in the calculations.<br><p> <br><p> If this value is nil, the behavior is equivalent to the Honor policy. This is a beta-level feature default enabled by the NodeInclusionPolicyInPodTopologySpread feature flag.<br><p> <br><p> Possible enum values:<br><p>  - `"Honor"` means use this scheduling directive when calculating pod topology spread skew.<br><p>  - `"Ignore"` means ignore this scheduling directive when calculating pod topology spread skew.
+     */
     @JsonProperty("nodeAffinityPolicy")
     public String getNodeAffinityPolicy() {
         return nodeAffinityPolicy;
     }
 
+    /**
+     * NodeAffinityPolicy indicates how we will treat Pod's nodeAffinity/nodeSelector when calculating pod topology spread skew. Options are: - Honor: only nodes matching nodeAffinity/nodeSelector are included in the calculations. - Ignore: nodeAffinity/nodeSelector are ignored. All nodes are included in the calculations.<br><p> <br><p> If this value is nil, the behavior is equivalent to the Honor policy. This is a beta-level feature default enabled by the NodeInclusionPolicyInPodTopologySpread feature flag.<br><p> <br><p> Possible enum values:<br><p>  - `"Honor"` means use this scheduling directive when calculating pod topology spread skew.<br><p>  - `"Ignore"` means ignore this scheduling directive when calculating pod topology spread skew.
+     */
     @JsonProperty("nodeAffinityPolicy")
     public void setNodeAffinityPolicy(String nodeAffinityPolicy) {
         this.nodeAffinityPolicy = nodeAffinityPolicy;
     }
 
+    /**
+     * NodeTaintsPolicy indicates how we will treat node taints when calculating pod topology spread skew. Options are: - Honor: nodes without taints, along with tainted nodes for which the incoming pod has a toleration, are included. - Ignore: node taints are ignored. All nodes are included.<br><p> <br><p> If this value is nil, the behavior is equivalent to the Ignore policy. This is a beta-level feature default enabled by the NodeInclusionPolicyInPodTopologySpread feature flag.<br><p> <br><p> Possible enum values:<br><p>  - `"Honor"` means use this scheduling directive when calculating pod topology spread skew.<br><p>  - `"Ignore"` means ignore this scheduling directive when calculating pod topology spread skew.
+     */
     @JsonProperty("nodeTaintsPolicy")
     public String getNodeTaintsPolicy() {
         return nodeTaintsPolicy;
     }
 
+    /**
+     * NodeTaintsPolicy indicates how we will treat node taints when calculating pod topology spread skew. Options are: - Honor: nodes without taints, along with tainted nodes for which the incoming pod has a toleration, are included. - Ignore: node taints are ignored. All nodes are included.<br><p> <br><p> If this value is nil, the behavior is equivalent to the Ignore policy. This is a beta-level feature default enabled by the NodeInclusionPolicyInPodTopologySpread feature flag.<br><p> <br><p> Possible enum values:<br><p>  - `"Honor"` means use this scheduling directive when calculating pod topology spread skew.<br><p>  - `"Ignore"` means ignore this scheduling directive when calculating pod topology spread skew.
+     */
     @JsonProperty("nodeTaintsPolicy")
     public void setNodeTaintsPolicy(String nodeTaintsPolicy) {
         this.nodeTaintsPolicy = nodeTaintsPolicy;
     }
 
+    /**
+     * TopologyKey is the key of node labels. Nodes that have a label with this key and identical values are considered to be in the same topology. We consider each &lt;key, value&gt; as a "bucket", and try to put balanced number of pods into each bucket. We define a domain as a particular instance of a topology. Also, we define an eligible domain as a domain whose nodes meet the requirements of nodeAffinityPolicy and nodeTaintsPolicy. e.g. If TopologyKey is "kubernetes.io/hostname", each Node is a domain of that topology. And, if TopologyKey is "topology.kubernetes.io/zone", each zone is a domain of that topology. It's a required field.
+     */
     @JsonProperty("topologyKey")
     public String getTopologyKey() {
         return topologyKey;
     }
 
+    /**
+     * TopologyKey is the key of node labels. Nodes that have a label with this key and identical values are considered to be in the same topology. We consider each &lt;key, value&gt; as a "bucket", and try to put balanced number of pods into each bucket. We define a domain as a particular instance of a topology. Also, we define an eligible domain as a domain whose nodes meet the requirements of nodeAffinityPolicy and nodeTaintsPolicy. e.g. If TopologyKey is "kubernetes.io/hostname", each Node is a domain of that topology. And, if TopologyKey is "topology.kubernetes.io/zone", each zone is a domain of that topology. It's a required field.
+     */
     @JsonProperty("topologyKey")
     public void setTopologyKey(String topologyKey) {
         this.topologyKey = topologyKey;
     }
 
+    /**
+     * WhenUnsatisfiable indicates how to deal with a pod if it doesn't satisfy the spread constraint. - DoNotSchedule (default) tells the scheduler not to schedule it. - ScheduleAnyway tells the scheduler to schedule the pod in any location,<br><p>   but giving higher precedence to topologies that would help reduce the<br><p>   skew.<br><p> A constraint is considered "Unsatisfiable" for an incoming pod if and only if every possible node assignment for that pod would violate "MaxSkew" on some topology. For example, in a 3-zone cluster, MaxSkew is set to 1, and pods with the same labelSelector spread as 3/1/1: | zone1 | zone2 | zone3 | | P P P |   P   |   P   | If WhenUnsatisfiable is set to DoNotSchedule, incoming pod can only be scheduled to zone2(zone3) to become 3/2/1(3/1/2) as ActualSkew(2-1) on zone2(zone3) satisfies MaxSkew(1). In other words, the cluster can still be imbalanced, but scheduler won't make it &#42;more&#42; imbalanced. It's a required field.<br><p> <br><p> Possible enum values:<br><p>  - `"DoNotSchedule"` instructs the scheduler not to schedule the pod when constraints are not satisfied.<br><p>  - `"ScheduleAnyway"` instructs the scheduler to schedule the pod even if constraints are not satisfied.
+     */
     @JsonProperty("whenUnsatisfiable")
     public String getWhenUnsatisfiable() {
         return whenUnsatisfiable;
     }
 
+    /**
+     * WhenUnsatisfiable indicates how to deal with a pod if it doesn't satisfy the spread constraint. - DoNotSchedule (default) tells the scheduler not to schedule it. - ScheduleAnyway tells the scheduler to schedule the pod in any location,<br><p>   but giving higher precedence to topologies that would help reduce the<br><p>   skew.<br><p> A constraint is considered "Unsatisfiable" for an incoming pod if and only if every possible node assignment for that pod would violate "MaxSkew" on some topology. For example, in a 3-zone cluster, MaxSkew is set to 1, and pods with the same labelSelector spread as 3/1/1: | zone1 | zone2 | zone3 | | P P P |   P   |   P   | If WhenUnsatisfiable is set to DoNotSchedule, incoming pod can only be scheduled to zone2(zone3) to become 3/2/1(3/1/2) as ActualSkew(2-1) on zone2(zone3) satisfies MaxSkew(1). In other words, the cluster can still be imbalanced, but scheduler won't make it &#42;more&#42; imbalanced. It's a required field.<br><p> <br><p> Possible enum values:<br><p>  - `"DoNotSchedule"` instructs the scheduler not to schedule the pod when constraints are not satisfied.<br><p>  - `"ScheduleAnyway"` instructs the scheduler to schedule the pod even if constraints are not satisfied.
+     */
     @JsonProperty("whenUnsatisfiable")
     public void setWhenUnsatisfiable(String whenUnsatisfiable) {
         this.whenUnsatisfiable = whenUnsatisfiable;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/EmbeddedObjectMetadata.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/EmbeddedObjectMetadata.java
index c41d1ef3f25..53cc55b5e88 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/EmbeddedObjectMetadata.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/EmbeddedObjectMetadata.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EmbeddedObjectMetadata contains a subset of the fields included in k8s.io/apimachinery/pkg/apis/meta/v1.ObjectMeta Only fields which are relevant to embedded resources are included.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -88,33 +91,51 @@ public EmbeddedObjectMetadata(Map<String, String> annotations, Map<String, Strin
         this.name = name;
     }
 
+    /**
+     * Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: http://kubernetes.io/docs/user-guide/annotations
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: http://kubernetes.io/docs/user-guide/annotations
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: http://kubernetes.io/docs/user-guide/labels
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabels() {
         return labels;
     }
 
+    /**
+     * Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: http://kubernetes.io/docs/user-guide/labels
+     */
     @JsonProperty("labels")
     public void setLabels(Map<String, String> labels) {
         this.labels = labels;
     }
 
+    /**
+     * Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: http://kubernetes.io/docs/user-guide/identifiers#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: http://kubernetes.io/docs/user-guide/identifiers#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/EmbeddedPersistentVolumeClaim.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/EmbeddedPersistentVolumeClaim.java
index 3d625434a31..eca4b46a71f 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/EmbeddedPersistentVolumeClaim.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/EmbeddedPersistentVolumeClaim.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EmbeddedPersistentVolumeClaim is an embedded version of k8s.io/api/core/v1.PersistentVolumeClaim. It contains TypeMeta and a reduced ObjectMeta.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,14 +81,8 @@
 public class EmbeddedPersistentVolumeClaim implements Editable<EmbeddedPersistentVolumeClaimBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "monitoring.coreos.com/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EmbeddedPersistentVolumeClaim";
     @JsonProperty("metadata")
@@ -113,7 +110,7 @@ public EmbeddedPersistentVolumeClaim(String apiVersion, String kind, EmbeddedObj
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -121,7 +118,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -129,7 +126,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -137,38 +134,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EmbeddedPersistentVolumeClaim is an embedded version of k8s.io/api/core/v1.PersistentVolumeClaim. It contains TypeMeta and a reduced ObjectMeta.
+     */
     @JsonProperty("metadata")
     public EmbeddedObjectMetadata getMetadata() {
         return metadata;
     }
 
+    /**
+     * EmbeddedPersistentVolumeClaim is an embedded version of k8s.io/api/core/v1.PersistentVolumeClaim. It contains TypeMeta and a reduced ObjectMeta.
+     */
     @JsonProperty("metadata")
     public void setMetadata(EmbeddedObjectMetadata metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * EmbeddedPersistentVolumeClaim is an embedded version of k8s.io/api/core/v1.PersistentVolumeClaim. It contains TypeMeta and a reduced ObjectMeta.
+     */
     @JsonProperty("spec")
     public PersistentVolumeClaimSpec getSpec() {
         return spec;
     }
 
+    /**
+     * EmbeddedPersistentVolumeClaim is an embedded version of k8s.io/api/core/v1.PersistentVolumeClaim. It contains TypeMeta and a reduced ObjectMeta.
+     */
     @JsonProperty("spec")
     public void setSpec(PersistentVolumeClaimSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * EmbeddedPersistentVolumeClaim is an embedded version of k8s.io/api/core/v1.PersistentVolumeClaim. It contains TypeMeta and a reduced ObjectMeta.
+     */
     @JsonProperty("status")
     public PersistentVolumeClaimStatus getStatus() {
         return status;
     }
 
+    /**
+     * EmbeddedPersistentVolumeClaim is an embedded version of k8s.io/api/core/v1.PersistentVolumeClaim. It contains TypeMeta and a reduced ObjectMeta.
+     */
     @JsonProperty("status")
     public void setStatus(PersistentVolumeClaimStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Endpoint.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Endpoint.java
index 5356063cbc2..4a311b28cce 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Endpoint.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Endpoint.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Endpoint defines an endpoint serving Prometheus metrics to be scraped by Prometheus.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -168,224 +171,356 @@ public Endpoint(SafeAuthorization authorization, BasicAuth basicAuth, String bea
         this.trackTimestampsStaleness = trackTimestampsStaleness;
     }
 
+    /**
+     * Endpoint defines an endpoint serving Prometheus metrics to be scraped by Prometheus.
+     */
     @JsonProperty("authorization")
     public SafeAuthorization getAuthorization() {
         return authorization;
     }
 
+    /**
+     * Endpoint defines an endpoint serving Prometheus metrics to be scraped by Prometheus.
+     */
     @JsonProperty("authorization")
     public void setAuthorization(SafeAuthorization authorization) {
         this.authorization = authorization;
     }
 
+    /**
+     * Endpoint defines an endpoint serving Prometheus metrics to be scraped by Prometheus.
+     */
     @JsonProperty("basicAuth")
     public BasicAuth getBasicAuth() {
         return basicAuth;
     }
 
+    /**
+     * Endpoint defines an endpoint serving Prometheus metrics to be scraped by Prometheus.
+     */
     @JsonProperty("basicAuth")
     public void setBasicAuth(BasicAuth basicAuth) {
         this.basicAuth = basicAuth;
     }
 
+    /**
+     * File to read bearer token for scraping the target.<br><p> <br><p> Deprecated: use `authorization` instead.
+     */
     @JsonProperty("bearerTokenFile")
     public String getBearerTokenFile() {
         return bearerTokenFile;
     }
 
+    /**
+     * File to read bearer token for scraping the target.<br><p> <br><p> Deprecated: use `authorization` instead.
+     */
     @JsonProperty("bearerTokenFile")
     public void setBearerTokenFile(String bearerTokenFile) {
         this.bearerTokenFile = bearerTokenFile;
     }
 
+    /**
+     * Endpoint defines an endpoint serving Prometheus metrics to be scraped by Prometheus.
+     */
     @JsonProperty("bearerTokenSecret")
     public SecretKeySelector getBearerTokenSecret() {
         return bearerTokenSecret;
     }
 
+    /**
+     * Endpoint defines an endpoint serving Prometheus metrics to be scraped by Prometheus.
+     */
     @JsonProperty("bearerTokenSecret")
     public void setBearerTokenSecret(SecretKeySelector bearerTokenSecret) {
         this.bearerTokenSecret = bearerTokenSecret;
     }
 
+    /**
+     * `enableHttp2` can be used to disable HTTP2 when scraping the target.
+     */
     @JsonProperty("enableHttp2")
     public Boolean getEnableHttp2() {
         return enableHttp2;
     }
 
+    /**
+     * `enableHttp2` can be used to disable HTTP2 when scraping the target.
+     */
     @JsonProperty("enableHttp2")
     public void setEnableHttp2(Boolean enableHttp2) {
         this.enableHttp2 = enableHttp2;
     }
 
+    /**
+     * When true, the pods which are not running (e.g. either in Failed or Succeeded state) are dropped during the target discovery.<br><p> <br><p> If unset, the filtering is enabled.<br><p> <br><p> More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#pod-phase
+     */
     @JsonProperty("filterRunning")
     public Boolean getFilterRunning() {
         return filterRunning;
     }
 
+    /**
+     * When true, the pods which are not running (e.g. either in Failed or Succeeded state) are dropped during the target discovery.<br><p> <br><p> If unset, the filtering is enabled.<br><p> <br><p> More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#pod-phase
+     */
     @JsonProperty("filterRunning")
     public void setFilterRunning(Boolean filterRunning) {
         this.filterRunning = filterRunning;
     }
 
+    /**
+     * `followRedirects` defines whether the scrape requests should follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public Boolean getFollowRedirects() {
         return followRedirects;
     }
 
+    /**
+     * `followRedirects` defines whether the scrape requests should follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public void setFollowRedirects(Boolean followRedirects) {
         this.followRedirects = followRedirects;
     }
 
+    /**
+     * When true, `honorLabels` preserves the metric's labels when they collide with the target's labels.
+     */
     @JsonProperty("honorLabels")
     public Boolean getHonorLabels() {
         return honorLabels;
     }
 
+    /**
+     * When true, `honorLabels` preserves the metric's labels when they collide with the target's labels.
+     */
     @JsonProperty("honorLabels")
     public void setHonorLabels(Boolean honorLabels) {
         this.honorLabels = honorLabels;
     }
 
+    /**
+     * `honorTimestamps` controls whether Prometheus preserves the timestamps when exposed by the target.
+     */
     @JsonProperty("honorTimestamps")
     public Boolean getHonorTimestamps() {
         return honorTimestamps;
     }
 
+    /**
+     * `honorTimestamps` controls whether Prometheus preserves the timestamps when exposed by the target.
+     */
     @JsonProperty("honorTimestamps")
     public void setHonorTimestamps(Boolean honorTimestamps) {
         this.honorTimestamps = honorTimestamps;
     }
 
+    /**
+     * Interval at which Prometheus scrapes the metrics from the target.<br><p> <br><p> If empty, Prometheus uses the global scrape interval.
+     */
     @JsonProperty("interval")
     public String getInterval() {
         return interval;
     }
 
+    /**
+     * Interval at which Prometheus scrapes the metrics from the target.<br><p> <br><p> If empty, Prometheus uses the global scrape interval.
+     */
     @JsonProperty("interval")
     public void setInterval(String interval) {
         this.interval = interval;
     }
 
+    /**
+     * `metricRelabelings` configures the relabeling rules to apply to the samples before ingestion.
+     */
     @JsonProperty("metricRelabelings")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RelabelConfig> getMetricRelabelings() {
         return metricRelabelings;
     }
 
+    /**
+     * `metricRelabelings` configures the relabeling rules to apply to the samples before ingestion.
+     */
     @JsonProperty("metricRelabelings")
     public void setMetricRelabelings(List<RelabelConfig> metricRelabelings) {
         this.metricRelabelings = metricRelabelings;
     }
 
+    /**
+     * Endpoint defines an endpoint serving Prometheus metrics to be scraped by Prometheus.
+     */
     @JsonProperty("oauth2")
     public OAuth2 getOauth2() {
         return oauth2;
     }
 
+    /**
+     * Endpoint defines an endpoint serving Prometheus metrics to be scraped by Prometheus.
+     */
     @JsonProperty("oauth2")
     public void setOauth2(OAuth2 oauth2) {
         this.oauth2 = oauth2;
     }
 
+    /**
+     * params define optional HTTP URL parameters.
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<String>> getParams() {
         return params;
     }
 
+    /**
+     * params define optional HTTP URL parameters.
+     */
     @JsonProperty("params")
     public void setParams(Map<String, List<String>> params) {
         this.params = params;
     }
 
+    /**
+     * HTTP path from which to scrape for metrics.<br><p> <br><p> If empty, Prometheus uses the default value (e.g. `/metrics`).
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * HTTP path from which to scrape for metrics.<br><p> <br><p> If empty, Prometheus uses the default value (e.g. `/metrics`).
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * Name of the Service port which this endpoint refers to.<br><p> <br><p> It takes precedence over `targetPort`.
+     */
     @JsonProperty("port")
     public String getPort() {
         return port;
     }
 
+    /**
+     * Name of the Service port which this endpoint refers to.<br><p> <br><p> It takes precedence over `targetPort`.
+     */
     @JsonProperty("port")
     public void setPort(String port) {
         this.port = port;
     }
 
+    /**
+     * `proxyURL` configures the HTTP Proxy URL (e.g. "http://proxyserver:2195") to go through when scraping the target.
+     */
     @JsonProperty("proxyUrl")
     public String getProxyUrl() {
         return proxyUrl;
     }
 
+    /**
+     * `proxyURL` configures the HTTP Proxy URL (e.g. "http://proxyserver:2195") to go through when scraping the target.
+     */
     @JsonProperty("proxyUrl")
     public void setProxyUrl(String proxyUrl) {
         this.proxyUrl = proxyUrl;
     }
 
+    /**
+     * `relabelings` configures the relabeling rules to apply the target's metadata labels.<br><p> <br><p> The Operator automatically adds relabelings for a few standard Kubernetes fields.<br><p> <br><p> The original scrape job's name is available via the `__tmp_prometheus_job_name` label.<br><p> <br><p> More info: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config
+     */
     @JsonProperty("relabelings")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RelabelConfig> getRelabelings() {
         return relabelings;
     }
 
+    /**
+     * `relabelings` configures the relabeling rules to apply the target's metadata labels.<br><p> <br><p> The Operator automatically adds relabelings for a few standard Kubernetes fields.<br><p> <br><p> The original scrape job's name is available via the `__tmp_prometheus_job_name` label.<br><p> <br><p> More info: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config
+     */
     @JsonProperty("relabelings")
     public void setRelabelings(List<RelabelConfig> relabelings) {
         this.relabelings = relabelings;
     }
 
+    /**
+     * HTTP scheme to use for scraping.<br><p> <br><p> `http` and `https` are the expected values unless you rewrite the `__scheme__` label via relabeling.<br><p> <br><p> If empty, Prometheus uses the default value `http`.
+     */
     @JsonProperty("scheme")
     public String getScheme() {
         return scheme;
     }
 
+    /**
+     * HTTP scheme to use for scraping.<br><p> <br><p> `http` and `https` are the expected values unless you rewrite the `__scheme__` label via relabeling.<br><p> <br><p> If empty, Prometheus uses the default value `http`.
+     */
     @JsonProperty("scheme")
     public void setScheme(String scheme) {
         this.scheme = scheme;
     }
 
+    /**
+     * Timeout after which Prometheus considers the scrape to be failed.<br><p> <br><p> If empty, Prometheus uses the global scrape timeout unless it is less than the target's scrape interval value in which the latter is used.
+     */
     @JsonProperty("scrapeTimeout")
     public String getScrapeTimeout() {
         return scrapeTimeout;
     }
 
+    /**
+     * Timeout after which Prometheus considers the scrape to be failed.<br><p> <br><p> If empty, Prometheus uses the global scrape timeout unless it is less than the target's scrape interval value in which the latter is used.
+     */
     @JsonProperty("scrapeTimeout")
     public void setScrapeTimeout(String scrapeTimeout) {
         this.scrapeTimeout = scrapeTimeout;
     }
 
+    /**
+     * Endpoint defines an endpoint serving Prometheus metrics to be scraped by Prometheus.
+     */
     @JsonProperty("targetPort")
     public IntOrString getTargetPort() {
         return targetPort;
     }
 
+    /**
+     * Endpoint defines an endpoint serving Prometheus metrics to be scraped by Prometheus.
+     */
     @JsonProperty("targetPort")
     public void setTargetPort(IntOrString targetPort) {
         this.targetPort = targetPort;
     }
 
+    /**
+     * Endpoint defines an endpoint serving Prometheus metrics to be scraped by Prometheus.
+     */
     @JsonProperty("tlsConfig")
     public TLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * Endpoint defines an endpoint serving Prometheus metrics to be scraped by Prometheus.
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(TLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * `trackTimestampsStaleness` defines whether Prometheus tracks staleness of the metrics that have an explicit timestamp present in scraped data. Has no effect if `honorTimestamps` is false.<br><p> <br><p> It requires Prometheus &gt;= v2.48.0.
+     */
     @JsonProperty("trackTimestampsStaleness")
     public Boolean getTrackTimestampsStaleness() {
         return trackTimestampsStaleness;
     }
 
+    /**
+     * `trackTimestampsStaleness` defines whether Prometheus tracks staleness of the metrics that have an explicit timestamp present in scraped data. Has no effect if `honorTimestamps` is false.<br><p> <br><p> It requires Prometheus &gt;= v2.48.0.
+     */
     @JsonProperty("trackTimestampsStaleness")
     public void setTrackTimestampsStaleness(Boolean trackTimestampsStaleness) {
         this.trackTimestampsStaleness = trackTimestampsStaleness;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Exemplars.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Exemplars.java
index 3c4d2d3a765..2647d5f9f48 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Exemplars.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Exemplars.java
@@ -78,11 +78,17 @@ public Exemplars(Long maxSize) {
         this.maxSize = maxSize;
     }
 
+    /**
+     * Maximum number of exemplars stored in memory for all series.<br><p> <br><p> exemplar-storage itself must be enabled using the `spec.enableFeature` option for exemplars to be scraped in the first place.<br><p> <br><p> If not set, Prometheus uses its default value. A value of zero or less than zero disables the storage.
+     */
     @JsonProperty("maxSize")
     public Long getMaxSize() {
         return maxSize;
     }
 
+    /**
+     * Maximum number of exemplars stored in memory for all series.<br><p> <br><p> exemplar-storage itself must be enabled using the `spec.enableFeature` option for exemplars to be scraped in the first place.<br><p> <br><p> If not set, Prometheus uses its default value. A value of zero or less than zero disables the storage.
+     */
     @JsonProperty("maxSize")
     public void setMaxSize(Long maxSize) {
         this.maxSize = maxSize;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/GlobalSMTPConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/GlobalSMTPConfig.java
index b66b65e7cf8..9de6866617e 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/GlobalSMTPConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/GlobalSMTPConfig.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GlobalSMTPConfig configures global SMTP parameters. See https://prometheus.io/docs/alerting/latest/configuration/#configuration-file
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -107,81 +110,129 @@ public GlobalSMTPConfig(String authIdentity, SecretKeySelector authPassword, Sec
         this.smartHost = smartHost;
     }
 
+    /**
+     * SMTP Auth using PLAIN
+     */
     @JsonProperty("authIdentity")
     public String getAuthIdentity() {
         return authIdentity;
     }
 
+    /**
+     * SMTP Auth using PLAIN
+     */
     @JsonProperty("authIdentity")
     public void setAuthIdentity(String authIdentity) {
         this.authIdentity = authIdentity;
     }
 
+    /**
+     * GlobalSMTPConfig configures global SMTP parameters. See https://prometheus.io/docs/alerting/latest/configuration/#configuration-file
+     */
     @JsonProperty("authPassword")
     public SecretKeySelector getAuthPassword() {
         return authPassword;
     }
 
+    /**
+     * GlobalSMTPConfig configures global SMTP parameters. See https://prometheus.io/docs/alerting/latest/configuration/#configuration-file
+     */
     @JsonProperty("authPassword")
     public void setAuthPassword(SecretKeySelector authPassword) {
         this.authPassword = authPassword;
     }
 
+    /**
+     * GlobalSMTPConfig configures global SMTP parameters. See https://prometheus.io/docs/alerting/latest/configuration/#configuration-file
+     */
     @JsonProperty("authSecret")
     public SecretKeySelector getAuthSecret() {
         return authSecret;
     }
 
+    /**
+     * GlobalSMTPConfig configures global SMTP parameters. See https://prometheus.io/docs/alerting/latest/configuration/#configuration-file
+     */
     @JsonProperty("authSecret")
     public void setAuthSecret(SecretKeySelector authSecret) {
         this.authSecret = authSecret;
     }
 
+    /**
+     * SMTP Auth using CRAM-MD5, LOGIN and PLAIN. If empty, Alertmanager doesn't authenticate to the SMTP server.
+     */
     @JsonProperty("authUsername")
     public String getAuthUsername() {
         return authUsername;
     }
 
+    /**
+     * SMTP Auth using CRAM-MD5, LOGIN and PLAIN. If empty, Alertmanager doesn't authenticate to the SMTP server.
+     */
     @JsonProperty("authUsername")
     public void setAuthUsername(String authUsername) {
         this.authUsername = authUsername;
     }
 
+    /**
+     * The default SMTP From header field.
+     */
     @JsonProperty("from")
     public String getFrom() {
         return from;
     }
 
+    /**
+     * The default SMTP From header field.
+     */
     @JsonProperty("from")
     public void setFrom(String from) {
         this.from = from;
     }
 
+    /**
+     * The default hostname to identify to the SMTP server.
+     */
     @JsonProperty("hello")
     public String getHello() {
         return hello;
     }
 
+    /**
+     * The default hostname to identify to the SMTP server.
+     */
     @JsonProperty("hello")
     public void setHello(String hello) {
         this.hello = hello;
     }
 
+    /**
+     * The default SMTP TLS requirement. Note that Go does not support unencrypted connections to remote SMTP endpoints.
+     */
     @JsonProperty("requireTLS")
     public Boolean getRequireTLS() {
         return requireTLS;
     }
 
+    /**
+     * The default SMTP TLS requirement. Note that Go does not support unencrypted connections to remote SMTP endpoints.
+     */
     @JsonProperty("requireTLS")
     public void setRequireTLS(Boolean requireTLS) {
         this.requireTLS = requireTLS;
     }
 
+    /**
+     * GlobalSMTPConfig configures global SMTP parameters. See https://prometheus.io/docs/alerting/latest/configuration/#configuration-file
+     */
     @JsonProperty("smartHost")
     public HostPort getSmartHost() {
         return smartHost;
     }
 
+    /**
+     * GlobalSMTPConfig configures global SMTP parameters. See https://prometheus.io/docs/alerting/latest/configuration/#configuration-file
+     */
     @JsonProperty("smartHost")
     public void setSmartHost(HostPort smartHost) {
         this.smartHost = smartHost;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/HTTPConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/HTTPConfig.java
index de33a607e1d..36187b28303 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/HTTPConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/HTTPConfig.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -117,102 +120,162 @@ public HTTPConfig(SafeAuthorization authorization, BasicAuth basicAuth, SecretKe
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("authorization")
     public SafeAuthorization getAuthorization() {
         return authorization;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("authorization")
     public void setAuthorization(SafeAuthorization authorization) {
         this.authorization = authorization;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("basicAuth")
     public BasicAuth getBasicAuth() {
         return basicAuth;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("basicAuth")
     public void setBasicAuth(BasicAuth basicAuth) {
         this.basicAuth = basicAuth;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("bearerTokenSecret")
     public SecretKeySelector getBearerTokenSecret() {
         return bearerTokenSecret;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("bearerTokenSecret")
     public void setBearerTokenSecret(SecretKeySelector bearerTokenSecret) {
         this.bearerTokenSecret = bearerTokenSecret;
     }
 
+    /**
+     * FollowRedirects specifies whether the client should follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public Boolean getFollowRedirects() {
         return followRedirects;
     }
 
+    /**
+     * FollowRedirects specifies whether the client should follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public void setFollowRedirects(Boolean followRedirects) {
         this.followRedirects = followRedirects;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("oauth2")
     public OAuth2 getOauth2() {
         return oauth2;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("oauth2")
     public void setOauth2(OAuth2 oauth2) {
         this.oauth2 = oauth2;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<SecretKeySelector>> getProxyConnectHeader() {
         return proxyConnectHeader;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     public void setProxyConnectHeader(Map<String, List<SecretKeySelector>> proxyConnectHeader) {
         this.proxyConnectHeader = proxyConnectHeader;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public Boolean getProxyFromEnvironment() {
         return proxyFromEnvironment;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public void setProxyFromEnvironment(Boolean proxyFromEnvironment) {
         this.proxyFromEnvironment = proxyFromEnvironment;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public String getProxyUrl() {
         return proxyUrl;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public void setProxyUrl(String proxyUrl) {
         this.proxyUrl = proxyUrl;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("tlsConfig")
     public SafeTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(SafeTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/HostAlias.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/HostAlias.java
index 096c55f4a92..b1b5faed89e 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/HostAlias.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/HostAlias.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HostAlias holds the mapping between IP and hostnames that will be injected as an entry in the pod's hosts file.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public HostAlias(List<String> hostnames, String ip) {
         this.ip = ip;
     }
 
+    /**
+     * Hostnames for the above IP address.
+     */
     @JsonProperty("hostnames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getHostnames() {
         return hostnames;
     }
 
+    /**
+     * Hostnames for the above IP address.
+     */
     @JsonProperty("hostnames")
     public void setHostnames(List<String> hostnames) {
         this.hostnames = hostnames;
     }
 
+    /**
+     * IP address of the host file entry.
+     */
     @JsonProperty("ip")
     public String getIp() {
         return ip;
     }
 
+    /**
+     * IP address of the host file entry.
+     */
     @JsonProperty("ip")
     public void setIp(String ip) {
         this.ip = ip;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/HostPort.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/HostPort.java
index 86f79da90fd..99214ee6fe8 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/HostPort.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/HostPort.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HostPort represents a "host:port" network address.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public HostPort(String host, String port) {
         this.port = port;
     }
 
+    /**
+     * Defines the host's address, it can be a DNS name or a literal IP address.
+     */
     @JsonProperty("host")
     public String getHost() {
         return host;
     }
 
+    /**
+     * Defines the host's address, it can be a DNS name or a literal IP address.
+     */
     @JsonProperty("host")
     public void setHost(String host) {
         this.host = host;
     }
 
+    /**
+     * Defines the host's port, it can be a literal port number or a port name.
+     */
     @JsonProperty("port")
     public String getPort() {
         return port;
     }
 
+    /**
+     * Defines the host's port, it can be a literal port number or a port name.
+     */
     @JsonProperty("port")
     public void setPort(String port) {
         this.port = port;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ManagedIdentity.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ManagedIdentity.java
index 49fbba9d184..c60e01cdf35 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ManagedIdentity.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ManagedIdentity.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ManagedIdentity defines the Azure User-assigned Managed identity.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ManagedIdentity(String clientId) {
         this.clientId = clientId;
     }
 
+    /**
+     * The client id
+     */
     @JsonProperty("clientId")
     public String getClientId() {
         return clientId;
     }
 
+    /**
+     * The client id
+     */
     @JsonProperty("clientId")
     public void setClientId(String clientId) {
         this.clientId = clientId;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/MetadataConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/MetadataConfig.java
index 533363e6d17..2df052d5613 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/MetadataConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/MetadataConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MetadataConfig configures the sending of series metadata to the remote storage.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public MetadataConfig(Boolean send, String sendInterval) {
         this.sendInterval = sendInterval;
     }
 
+    /**
+     * Defines whether metric metadata is sent to the remote storage or not.
+     */
     @JsonProperty("send")
     public Boolean getSend() {
         return send;
     }
 
+    /**
+     * Defines whether metric metadata is sent to the remote storage or not.
+     */
     @JsonProperty("send")
     public void setSend(Boolean send) {
         this.send = send;
     }
 
+    /**
+     * Defines how frequently metric metadata is sent to the remote storage.
+     */
     @JsonProperty("sendInterval")
     public String getSendInterval() {
         return sendInterval;
     }
 
+    /**
+     * Defines how frequently metric metadata is sent to the remote storage.
+     */
     @JsonProperty("sendInterval")
     public void setSendInterval(String sendInterval) {
         this.sendInterval = sendInterval;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/NamespaceSelector.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/NamespaceSelector.java
index b5f09a84c20..219d8a539f2 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/NamespaceSelector.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/NamespaceSelector.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NamespaceSelector is a selector for selecting either all namespaces or a list of namespaces. If `any` is true, it takes precedence over `matchNames`. If `matchNames` is empty and `any` is false, it means that the objects are selected from the current namespace.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public NamespaceSelector(Boolean any, List<String> matchNames) {
         this.matchNames = matchNames;
     }
 
+    /**
+     * Boolean describing whether all namespaces are selected in contrast to a list restricting them.
+     */
     @JsonProperty("any")
     public Boolean getAny() {
         return any;
     }
 
+    /**
+     * Boolean describing whether all namespaces are selected in contrast to a list restricting them.
+     */
     @JsonProperty("any")
     public void setAny(Boolean any) {
         this.any = any;
     }
 
+    /**
+     * List of namespace names to select from.
+     */
     @JsonProperty("matchNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMatchNames() {
         return matchNames;
     }
 
+    /**
+     * List of namespace names to select from.
+     */
     @JsonProperty("matchNames")
     public void setMatchNames(List<String> matchNames) {
         this.matchNames = matchNames;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/NativeHistogramConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/NativeHistogramConfig.java
index c8b2be3c5e0..4202cd4860d 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/NativeHistogramConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/NativeHistogramConfig.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NativeHistogramConfig extends the native histogram configuration settings.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,31 +90,49 @@ public NativeHistogramConfig(Long nativeHistogramBucketLimit, Quantity nativeHis
         this.scrapeClassicHistograms = scrapeClassicHistograms;
     }
 
+    /**
+     * If there are more than this many buckets in a native histogram, buckets will be merged to stay within the limit. It requires Prometheus &gt;= v2.45.0.
+     */
     @JsonProperty("nativeHistogramBucketLimit")
     public Long getNativeHistogramBucketLimit() {
         return nativeHistogramBucketLimit;
     }
 
+    /**
+     * If there are more than this many buckets in a native histogram, buckets will be merged to stay within the limit. It requires Prometheus &gt;= v2.45.0.
+     */
     @JsonProperty("nativeHistogramBucketLimit")
     public void setNativeHistogramBucketLimit(Long nativeHistogramBucketLimit) {
         this.nativeHistogramBucketLimit = nativeHistogramBucketLimit;
     }
 
+    /**
+     * NativeHistogramConfig extends the native histogram configuration settings.
+     */
     @JsonProperty("nativeHistogramMinBucketFactor")
     public Quantity getNativeHistogramMinBucketFactor() {
         return nativeHistogramMinBucketFactor;
     }
 
+    /**
+     * NativeHistogramConfig extends the native histogram configuration settings.
+     */
     @JsonProperty("nativeHistogramMinBucketFactor")
     public void setNativeHistogramMinBucketFactor(Quantity nativeHistogramMinBucketFactor) {
         this.nativeHistogramMinBucketFactor = nativeHistogramMinBucketFactor;
     }
 
+    /**
+     * Whether to scrape a classic histogram that is also exposed as a native histogram. It requires Prometheus &gt;= v2.45.0.
+     */
     @JsonProperty("scrapeClassicHistograms")
     public Boolean getScrapeClassicHistograms() {
         return scrapeClassicHistograms;
     }
 
+    /**
+     * Whether to scrape a classic histogram that is also exposed as a native histogram. It requires Prometheus &gt;= v2.45.0.
+     */
     @JsonProperty("scrapeClassicHistograms")
     public void setScrapeClassicHistograms(Boolean scrapeClassicHistograms) {
         this.scrapeClassicHistograms = scrapeClassicHistograms;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/OAuth2.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/OAuth2.java
index 42cea1683e1..a54853da54a 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/OAuth2.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/OAuth2.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OAuth2 configures OAuth2 settings.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -120,104 +123,164 @@ public OAuth2(SecretOrConfigMap clientId, SecretKeySelector clientSecret, Map<St
         this.tokenUrl = tokenUrl;
     }
 
+    /**
+     * OAuth2 configures OAuth2 settings.
+     */
     @JsonProperty("clientId")
     public SecretOrConfigMap getClientId() {
         return clientId;
     }
 
+    /**
+     * OAuth2 configures OAuth2 settings.
+     */
     @JsonProperty("clientId")
     public void setClientId(SecretOrConfigMap clientId) {
         this.clientId = clientId;
     }
 
+    /**
+     * OAuth2 configures OAuth2 settings.
+     */
     @JsonProperty("clientSecret")
     public SecretKeySelector getClientSecret() {
         return clientSecret;
     }
 
+    /**
+     * OAuth2 configures OAuth2 settings.
+     */
     @JsonProperty("clientSecret")
     public void setClientSecret(SecretKeySelector clientSecret) {
         this.clientSecret = clientSecret;
     }
 
+    /**
+     * `endpointParams` configures the HTTP parameters to append to the token URL.
+     */
     @JsonProperty("endpointParams")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getEndpointParams() {
         return endpointParams;
     }
 
+    /**
+     * `endpointParams` configures the HTTP parameters to append to the token URL.
+     */
     @JsonProperty("endpointParams")
     public void setEndpointParams(Map<String, String> endpointParams) {
         this.endpointParams = endpointParams;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<SecretKeySelector>> getProxyConnectHeader() {
         return proxyConnectHeader;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     public void setProxyConnectHeader(Map<String, List<SecretKeySelector>> proxyConnectHeader) {
         this.proxyConnectHeader = proxyConnectHeader;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public Boolean getProxyFromEnvironment() {
         return proxyFromEnvironment;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public void setProxyFromEnvironment(Boolean proxyFromEnvironment) {
         this.proxyFromEnvironment = proxyFromEnvironment;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public String getProxyUrl() {
         return proxyUrl;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public void setProxyUrl(String proxyUrl) {
         this.proxyUrl = proxyUrl;
     }
 
+    /**
+     * `scopes` defines the OAuth2 scopes used for the token request.
+     */
     @JsonProperty("scopes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getScopes() {
         return scopes;
     }
 
+    /**
+     * `scopes` defines the OAuth2 scopes used for the token request.
+     */
     @JsonProperty("scopes")
     public void setScopes(List<String> scopes) {
         this.scopes = scopes;
     }
 
+    /**
+     * OAuth2 configures OAuth2 settings.
+     */
     @JsonProperty("tlsConfig")
     public SafeTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * OAuth2 configures OAuth2 settings.
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(SafeTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * `tokenURL` configures the URL to fetch the token from.
+     */
     @JsonProperty("tokenUrl")
     public String getTokenUrl() {
         return tokenUrl;
     }
 
+    /**
+     * `tokenURL` configures the URL to fetch the token from.
+     */
     @JsonProperty("tokenUrl")
     public void setTokenUrl(String tokenUrl) {
         this.tokenUrl = tokenUrl;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/OTLPConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/OTLPConfig.java
index e963590176d..714fa2d07ad 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/OTLPConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/OTLPConfig.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OTLPConfig is the configuration for writing to the OTLP endpoint.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public OTLPConfig(List<String> promoteResourceAttributes, String translationStra
         this.translationStrategy = translationStrategy;
     }
 
+    /**
+     * List of OpenTelemetry Attributes that should be promoted to metric labels, defaults to none.
+     */
     @JsonProperty("promoteResourceAttributes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPromoteResourceAttributes() {
         return promoteResourceAttributes;
     }
 
+    /**
+     * List of OpenTelemetry Attributes that should be promoted to metric labels, defaults to none.
+     */
     @JsonProperty("promoteResourceAttributes")
     public void setPromoteResourceAttributes(List<String> promoteResourceAttributes) {
         this.promoteResourceAttributes = promoteResourceAttributes;
     }
 
+    /**
+     * Configures how the OTLP receiver endpoint translates the incoming metrics. If unset, Prometheus uses its default value.<br><p> <br><p> It requires Prometheus &gt;= v3.0.0.
+     */
     @JsonProperty("translationStrategy")
     public String getTranslationStrategy() {
         return translationStrategy;
     }
 
+    /**
+     * Configures how the OTLP receiver endpoint translates the incoming metrics. If unset, Prometheus uses its default value.<br><p> <br><p> It requires Prometheus &gt;= v3.0.0.
+     */
     @JsonProperty("translationStrategy")
     public void setTranslationStrategy(String translationStrategy) {
         this.translationStrategy = translationStrategy;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ObjectReference.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ObjectReference.java
index 1eccb1cbe7d..095ed2e8c19 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ObjectReference.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ObjectReference.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ObjectReference references a PodMonitor, ServiceMonitor, Probe or PrometheusRule object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,41 +92,65 @@ public ObjectReference(String group, String name, String namespace, String resou
         this.resource = resource;
     }
 
+    /**
+     * Group of the referent. When not specified, it defaults to `monitoring.coreos.com`
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * Group of the referent. When not specified, it defaults to `monitoring.coreos.com`
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * Name of the referent. When not set, all resources in the namespace are matched.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referent. When not set, all resources in the namespace are matched.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Resource of the referent.
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * Resource of the referent.
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PodDNSConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PodDNSConfig.java
index e00fba7ee4f..9755e1aa06e 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PodDNSConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PodDNSConfig.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodDNSConfig defines the DNS parameters of a pod in addition to those generated from DNSPolicy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,34 +94,52 @@ public PodDNSConfig(List<String> nameservers, List<PodDNSConfigOption> options,
         this.searches = searches;
     }
 
+    /**
+     * A list of DNS name server IP addresses. This will be appended to the base nameservers generated from DNSPolicy.
+     */
     @JsonProperty("nameservers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNameservers() {
         return nameservers;
     }
 
+    /**
+     * A list of DNS name server IP addresses. This will be appended to the base nameservers generated from DNSPolicy.
+     */
     @JsonProperty("nameservers")
     public void setNameservers(List<String> nameservers) {
         this.nameservers = nameservers;
     }
 
+    /**
+     * A list of DNS resolver options. This will be merged with the base options generated from DNSPolicy. Resolution options given in Options will override those that appear in the base DNSPolicy.
+     */
     @JsonProperty("options")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PodDNSConfigOption> getOptions() {
         return options;
     }
 
+    /**
+     * A list of DNS resolver options. This will be merged with the base options generated from DNSPolicy. Resolution options given in Options will override those that appear in the base DNSPolicy.
+     */
     @JsonProperty("options")
     public void setOptions(List<PodDNSConfigOption> options) {
         this.options = options;
     }
 
+    /**
+     * A list of DNS search domains for host-name lookup. This will be appended to the base search paths generated from DNSPolicy.
+     */
     @JsonProperty("searches")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSearches() {
         return searches;
     }
 
+    /**
+     * A list of DNS search domains for host-name lookup. This will be appended to the base search paths generated from DNSPolicy.
+     */
     @JsonProperty("searches")
     public void setSearches(List<String> searches) {
         this.searches = searches;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PodDNSConfigOption.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PodDNSConfigOption.java
index cd95a47d6c4..7ed0f58bd4d 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PodDNSConfigOption.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PodDNSConfigOption.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodDNSConfigOption defines DNS resolver options of a pod.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PodDNSConfigOption(String name, String value) {
         this.value = value;
     }
 
+    /**
+     * Name is required and must be unique.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is required and must be unique.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Value is optional.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value is optional.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PodMetricsEndpoint.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PodMetricsEndpoint.java
index 2d1d7090782..863427ea2fe 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PodMetricsEndpoint.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PodMetricsEndpoint.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodMetricsEndpoint defines an endpoint serving Prometheus metrics to be scraped by Prometheus.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -168,224 +171,356 @@ public PodMetricsEndpoint(SafeAuthorization authorization, BasicAuth basicAuth,
         this.trackTimestampsStaleness = trackTimestampsStaleness;
     }
 
+    /**
+     * PodMetricsEndpoint defines an endpoint serving Prometheus metrics to be scraped by Prometheus.
+     */
     @JsonProperty("authorization")
     public SafeAuthorization getAuthorization() {
         return authorization;
     }
 
+    /**
+     * PodMetricsEndpoint defines an endpoint serving Prometheus metrics to be scraped by Prometheus.
+     */
     @JsonProperty("authorization")
     public void setAuthorization(SafeAuthorization authorization) {
         this.authorization = authorization;
     }
 
+    /**
+     * PodMetricsEndpoint defines an endpoint serving Prometheus metrics to be scraped by Prometheus.
+     */
     @JsonProperty("basicAuth")
     public BasicAuth getBasicAuth() {
         return basicAuth;
     }
 
+    /**
+     * PodMetricsEndpoint defines an endpoint serving Prometheus metrics to be scraped by Prometheus.
+     */
     @JsonProperty("basicAuth")
     public void setBasicAuth(BasicAuth basicAuth) {
         this.basicAuth = basicAuth;
     }
 
+    /**
+     * PodMetricsEndpoint defines an endpoint serving Prometheus metrics to be scraped by Prometheus.
+     */
     @JsonProperty("bearerTokenSecret")
     public SecretKeySelector getBearerTokenSecret() {
         return bearerTokenSecret;
     }
 
+    /**
+     * PodMetricsEndpoint defines an endpoint serving Prometheus metrics to be scraped by Prometheus.
+     */
     @JsonProperty("bearerTokenSecret")
     public void setBearerTokenSecret(SecretKeySelector bearerTokenSecret) {
         this.bearerTokenSecret = bearerTokenSecret;
     }
 
+    /**
+     * `enableHttp2` can be used to disable HTTP2 when scraping the target.
+     */
     @JsonProperty("enableHttp2")
     public Boolean getEnableHttp2() {
         return enableHttp2;
     }
 
+    /**
+     * `enableHttp2` can be used to disable HTTP2 when scraping the target.
+     */
     @JsonProperty("enableHttp2")
     public void setEnableHttp2(Boolean enableHttp2) {
         this.enableHttp2 = enableHttp2;
     }
 
+    /**
+     * When true, the pods which are not running (e.g. either in Failed or Succeeded state) are dropped during the target discovery.<br><p> <br><p> If unset, the filtering is enabled.<br><p> <br><p> More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#pod-phase
+     */
     @JsonProperty("filterRunning")
     public Boolean getFilterRunning() {
         return filterRunning;
     }
 
+    /**
+     * When true, the pods which are not running (e.g. either in Failed or Succeeded state) are dropped during the target discovery.<br><p> <br><p> If unset, the filtering is enabled.<br><p> <br><p> More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#pod-phase
+     */
     @JsonProperty("filterRunning")
     public void setFilterRunning(Boolean filterRunning) {
         this.filterRunning = filterRunning;
     }
 
+    /**
+     * `followRedirects` defines whether the scrape requests should follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public Boolean getFollowRedirects() {
         return followRedirects;
     }
 
+    /**
+     * `followRedirects` defines whether the scrape requests should follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public void setFollowRedirects(Boolean followRedirects) {
         this.followRedirects = followRedirects;
     }
 
+    /**
+     * When true, `honorLabels` preserves the metric's labels when they collide with the target's labels.
+     */
     @JsonProperty("honorLabels")
     public Boolean getHonorLabels() {
         return honorLabels;
     }
 
+    /**
+     * When true, `honorLabels` preserves the metric's labels when they collide with the target's labels.
+     */
     @JsonProperty("honorLabels")
     public void setHonorLabels(Boolean honorLabels) {
         this.honorLabels = honorLabels;
     }
 
+    /**
+     * `honorTimestamps` controls whether Prometheus preserves the timestamps when exposed by the target.
+     */
     @JsonProperty("honorTimestamps")
     public Boolean getHonorTimestamps() {
         return honorTimestamps;
     }
 
+    /**
+     * `honorTimestamps` controls whether Prometheus preserves the timestamps when exposed by the target.
+     */
     @JsonProperty("honorTimestamps")
     public void setHonorTimestamps(Boolean honorTimestamps) {
         this.honorTimestamps = honorTimestamps;
     }
 
+    /**
+     * Interval at which Prometheus scrapes the metrics from the target.<br><p> <br><p> If empty, Prometheus uses the global scrape interval.
+     */
     @JsonProperty("interval")
     public String getInterval() {
         return interval;
     }
 
+    /**
+     * Interval at which Prometheus scrapes the metrics from the target.<br><p> <br><p> If empty, Prometheus uses the global scrape interval.
+     */
     @JsonProperty("interval")
     public void setInterval(String interval) {
         this.interval = interval;
     }
 
+    /**
+     * `metricRelabelings` configures the relabeling rules to apply to the samples before ingestion.
+     */
     @JsonProperty("metricRelabelings")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RelabelConfig> getMetricRelabelings() {
         return metricRelabelings;
     }
 
+    /**
+     * `metricRelabelings` configures the relabeling rules to apply to the samples before ingestion.
+     */
     @JsonProperty("metricRelabelings")
     public void setMetricRelabelings(List<RelabelConfig> metricRelabelings) {
         this.metricRelabelings = metricRelabelings;
     }
 
+    /**
+     * PodMetricsEndpoint defines an endpoint serving Prometheus metrics to be scraped by Prometheus.
+     */
     @JsonProperty("oauth2")
     public OAuth2 getOauth2() {
         return oauth2;
     }
 
+    /**
+     * PodMetricsEndpoint defines an endpoint serving Prometheus metrics to be scraped by Prometheus.
+     */
     @JsonProperty("oauth2")
     public void setOauth2(OAuth2 oauth2) {
         this.oauth2 = oauth2;
     }
 
+    /**
+     * `params` define optional HTTP URL parameters.
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<String>> getParams() {
         return params;
     }
 
+    /**
+     * `params` define optional HTTP URL parameters.
+     */
     @JsonProperty("params")
     public void setParams(Map<String, List<String>> params) {
         this.params = params;
     }
 
+    /**
+     * HTTP path from which to scrape for metrics.<br><p> <br><p> If empty, Prometheus uses the default value (e.g. `/metrics`).
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * HTTP path from which to scrape for metrics.<br><p> <br><p> If empty, Prometheus uses the default value (e.g. `/metrics`).
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * The `Pod` port name which exposes the endpoint.<br><p> <br><p> It takes precedence over the `portNumber` and `targetPort` fields.
+     */
     @JsonProperty("port")
     public String getPort() {
         return port;
     }
 
+    /**
+     * The `Pod` port name which exposes the endpoint.<br><p> <br><p> It takes precedence over the `portNumber` and `targetPort` fields.
+     */
     @JsonProperty("port")
     public void setPort(String port) {
         this.port = port;
     }
 
+    /**
+     * The `Pod` port number which exposes the endpoint.
+     */
     @JsonProperty("portNumber")
     public Integer getPortNumber() {
         return portNumber;
     }
 
+    /**
+     * The `Pod` port number which exposes the endpoint.
+     */
     @JsonProperty("portNumber")
     public void setPortNumber(Integer portNumber) {
         this.portNumber = portNumber;
     }
 
+    /**
+     * `proxyURL` configures the HTTP Proxy URL (e.g. "http://proxyserver:2195") to go through when scraping the target.
+     */
     @JsonProperty("proxyUrl")
     public String getProxyUrl() {
         return proxyUrl;
     }
 
+    /**
+     * `proxyURL` configures the HTTP Proxy URL (e.g. "http://proxyserver:2195") to go through when scraping the target.
+     */
     @JsonProperty("proxyUrl")
     public void setProxyUrl(String proxyUrl) {
         this.proxyUrl = proxyUrl;
     }
 
+    /**
+     * `relabelings` configures the relabeling rules to apply the target's metadata labels.<br><p> <br><p> The Operator automatically adds relabelings for a few standard Kubernetes fields.<br><p> <br><p> The original scrape job's name is available via the `__tmp_prometheus_job_name` label.<br><p> <br><p> More info: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config
+     */
     @JsonProperty("relabelings")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RelabelConfig> getRelabelings() {
         return relabelings;
     }
 
+    /**
+     * `relabelings` configures the relabeling rules to apply the target's metadata labels.<br><p> <br><p> The Operator automatically adds relabelings for a few standard Kubernetes fields.<br><p> <br><p> The original scrape job's name is available via the `__tmp_prometheus_job_name` label.<br><p> <br><p> More info: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config
+     */
     @JsonProperty("relabelings")
     public void setRelabelings(List<RelabelConfig> relabelings) {
         this.relabelings = relabelings;
     }
 
+    /**
+     * HTTP scheme to use for scraping.<br><p> <br><p> `http` and `https` are the expected values unless you rewrite the `__scheme__` label via relabeling.<br><p> <br><p> If empty, Prometheus uses the default value `http`.
+     */
     @JsonProperty("scheme")
     public String getScheme() {
         return scheme;
     }
 
+    /**
+     * HTTP scheme to use for scraping.<br><p> <br><p> `http` and `https` are the expected values unless you rewrite the `__scheme__` label via relabeling.<br><p> <br><p> If empty, Prometheus uses the default value `http`.
+     */
     @JsonProperty("scheme")
     public void setScheme(String scheme) {
         this.scheme = scheme;
     }
 
+    /**
+     * Timeout after which Prometheus considers the scrape to be failed.<br><p> <br><p> If empty, Prometheus uses the global scrape timeout unless it is less than the target's scrape interval value in which the latter is used.
+     */
     @JsonProperty("scrapeTimeout")
     public String getScrapeTimeout() {
         return scrapeTimeout;
     }
 
+    /**
+     * Timeout after which Prometheus considers the scrape to be failed.<br><p> <br><p> If empty, Prometheus uses the global scrape timeout unless it is less than the target's scrape interval value in which the latter is used.
+     */
     @JsonProperty("scrapeTimeout")
     public void setScrapeTimeout(String scrapeTimeout) {
         this.scrapeTimeout = scrapeTimeout;
     }
 
+    /**
+     * PodMetricsEndpoint defines an endpoint serving Prometheus metrics to be scraped by Prometheus.
+     */
     @JsonProperty("targetPort")
     public IntOrString getTargetPort() {
         return targetPort;
     }
 
+    /**
+     * PodMetricsEndpoint defines an endpoint serving Prometheus metrics to be scraped by Prometheus.
+     */
     @JsonProperty("targetPort")
     public void setTargetPort(IntOrString targetPort) {
         this.targetPort = targetPort;
     }
 
+    /**
+     * PodMetricsEndpoint defines an endpoint serving Prometheus metrics to be scraped by Prometheus.
+     */
     @JsonProperty("tlsConfig")
     public SafeTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * PodMetricsEndpoint defines an endpoint serving Prometheus metrics to be scraped by Prometheus.
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(SafeTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * `trackTimestampsStaleness` defines whether Prometheus tracks staleness of the metrics that have an explicit timestamp present in scraped data. Has no effect if `honorTimestamps` is false.<br><p> <br><p> It requires Prometheus &gt;= v2.48.0.
+     */
     @JsonProperty("trackTimestampsStaleness")
     public Boolean getTrackTimestampsStaleness() {
         return trackTimestampsStaleness;
     }
 
+    /**
+     * `trackTimestampsStaleness` defines whether Prometheus tracks staleness of the metrics that have an explicit timestamp present in scraped data. Has no effect if `honorTimestamps` is false.<br><p> <br><p> It requires Prometheus &gt;= v2.48.0.
+     */
     @JsonProperty("trackTimestampsStaleness")
     public void setTrackTimestampsStaleness(Boolean trackTimestampsStaleness) {
         this.trackTimestampsStaleness = trackTimestampsStaleness;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PodMonitor.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PodMonitor.java
index de698ff47cf..714d748e0e3 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PodMonitor.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PodMonitor.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * The `PodMonitor` custom resource definition (CRD) defines how `Prometheus` and `PrometheusAgent` can scrape metrics from a group of pods. Among other things, it allows to specify: &#42; The pods to scrape via label selectors. &#42; The container ports to scrape. &#42; Authentication credentials to use. &#42; Target and metric relabeling.<br><p> <br><p> `Prometheus` and `PrometheusAgent` objects select `PodMonitor` objects using label and namespace selectors.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class PodMonitor implements Editable<PodMonitorBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "monitoring.coreos.com/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodMonitor";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public PodMonitor(String apiVersion, String kind, ObjectMeta metadata, PodMonito
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * The `PodMonitor` custom resource definition (CRD) defines how `Prometheus` and `PrometheusAgent` can scrape metrics from a group of pods. Among other things, it allows to specify: &#42; The pods to scrape via label selectors. &#42; The container ports to scrape. &#42; Authentication credentials to use. &#42; Target and metric relabeling.<br><p> <br><p> `Prometheus` and `PrometheusAgent` objects select `PodMonitor` objects using label and namespace selectors.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * The `PodMonitor` custom resource definition (CRD) defines how `Prometheus` and `PrometheusAgent` can scrape metrics from a group of pods. Among other things, it allows to specify: &#42; The pods to scrape via label selectors. &#42; The container ports to scrape. &#42; Authentication credentials to use. &#42; Target and metric relabeling.<br><p> <br><p> `Prometheus` and `PrometheusAgent` objects select `PodMonitor` objects using label and namespace selectors.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * The `PodMonitor` custom resource definition (CRD) defines how `Prometheus` and `PrometheusAgent` can scrape metrics from a group of pods. Among other things, it allows to specify: &#42; The pods to scrape via label selectors. &#42; The container ports to scrape. &#42; Authentication credentials to use. &#42; Target and metric relabeling.<br><p> <br><p> `Prometheus` and `PrometheusAgent` objects select `PodMonitor` objects using label and namespace selectors.
+     */
     @JsonProperty("spec")
     public PodMonitorSpec getSpec() {
         return spec;
     }
 
+    /**
+     * The `PodMonitor` custom resource definition (CRD) defines how `Prometheus` and `PrometheusAgent` can scrape metrics from a group of pods. Among other things, it allows to specify: &#42; The pods to scrape via label selectors. &#42; The container ports to scrape. &#42; Authentication credentials to use. &#42; Target and metric relabeling.<br><p> <br><p> `Prometheus` and `PrometheusAgent` objects select `PodMonitor` objects using label and namespace selectors.
+     */
     @JsonProperty("spec")
     public void setSpec(PodMonitorSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PodMonitorList.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PodMonitorList.java
index 3d101b596c9..4626403669e 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PodMonitorList.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PodMonitorList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodMonitorList is a list of PodMonitors.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PodMonitorList implements Editable<PodMonitorListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.monitoring.v1.PodMonitor>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "monitoring.coreos.com/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.monitoring.v1.PodMonitor> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodMonitorList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PodMonitorList(String apiVersion, List<io.fabric8.openshift.api.model.mon
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of PodMonitors
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.monitoring.v1.PodMonitor> getItems() {
         return items;
     }
 
+    /**
+     * List of PodMonitors
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.monitoring.v1.PodMonitor> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodMonitorList is a list of PodMonitors.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodMonitorList is a list of PodMonitors.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PodMonitorSpec.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PodMonitorSpec.java
index 9a9a4e469fa..935ed398f84 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PodMonitorSpec.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PodMonitorSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodMonitorSpec contains specification parameters for a PodMonitor.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -160,204 +163,324 @@ public PodMonitorSpec(AttachMetadata attachMetadata, String bodySizeLimit, Strin
         this.targetLimit = targetLimit;
     }
 
+    /**
+     * PodMonitorSpec contains specification parameters for a PodMonitor.
+     */
     @JsonProperty("attachMetadata")
     public AttachMetadata getAttachMetadata() {
         return attachMetadata;
     }
 
+    /**
+     * PodMonitorSpec contains specification parameters for a PodMonitor.
+     */
     @JsonProperty("attachMetadata")
     public void setAttachMetadata(AttachMetadata attachMetadata) {
         this.attachMetadata = attachMetadata;
     }
 
+    /**
+     * When defined, bodySizeLimit specifies a job level limit on the size of uncompressed response body that will be accepted by Prometheus.<br><p> <br><p> It requires Prometheus &gt;= v2.28.0.
+     */
     @JsonProperty("bodySizeLimit")
     public String getBodySizeLimit() {
         return bodySizeLimit;
     }
 
+    /**
+     * When defined, bodySizeLimit specifies a job level limit on the size of uncompressed response body that will be accepted by Prometheus.<br><p> <br><p> It requires Prometheus &gt;= v2.28.0.
+     */
     @JsonProperty("bodySizeLimit")
     public void setBodySizeLimit(String bodySizeLimit) {
         this.bodySizeLimit = bodySizeLimit;
     }
 
+    /**
+     * The protocol to use if a scrape returns blank, unparseable, or otherwise invalid Content-Type.<br><p> <br><p> It requires Prometheus &gt;= v3.0.0.
+     */
     @JsonProperty("fallbackScrapeProtocol")
     public String getFallbackScrapeProtocol() {
         return fallbackScrapeProtocol;
     }
 
+    /**
+     * The protocol to use if a scrape returns blank, unparseable, or otherwise invalid Content-Type.<br><p> <br><p> It requires Prometheus &gt;= v3.0.0.
+     */
     @JsonProperty("fallbackScrapeProtocol")
     public void setFallbackScrapeProtocol(String fallbackScrapeProtocol) {
         this.fallbackScrapeProtocol = fallbackScrapeProtocol;
     }
 
+    /**
+     * The label to use to retrieve the job name from. `jobLabel` selects the label from the associated Kubernetes `Pod` object which will be used as the `job` label for all metrics.<br><p> <br><p> For example if `jobLabel` is set to `foo` and the Kubernetes `Pod` object is labeled with `foo: bar`, then Prometheus adds the `job="bar"` label to all ingested metrics.<br><p> <br><p> If the value of this field is empty, the `job` label of the metrics defaults to the namespace and name of the PodMonitor object (e.g. `&lt;namespace&gt;/&lt;name&gt;`).
+     */
     @JsonProperty("jobLabel")
     public String getJobLabel() {
         return jobLabel;
     }
 
+    /**
+     * The label to use to retrieve the job name from. `jobLabel` selects the label from the associated Kubernetes `Pod` object which will be used as the `job` label for all metrics.<br><p> <br><p> For example if `jobLabel` is set to `foo` and the Kubernetes `Pod` object is labeled with `foo: bar`, then Prometheus adds the `job="bar"` label to all ingested metrics.<br><p> <br><p> If the value of this field is empty, the `job` label of the metrics defaults to the namespace and name of the PodMonitor object (e.g. `&lt;namespace&gt;/&lt;name&gt;`).
+     */
     @JsonProperty("jobLabel")
     public void setJobLabel(String jobLabel) {
         this.jobLabel = jobLabel;
     }
 
+    /**
+     * Per-scrape limit on the number of targets dropped by relabeling that will be kept in memory. 0 means no limit.<br><p> <br><p> It requires Prometheus &gt;= v2.47.0.
+     */
     @JsonProperty("keepDroppedTargets")
     public Long getKeepDroppedTargets() {
         return keepDroppedTargets;
     }
 
+    /**
+     * Per-scrape limit on the number of targets dropped by relabeling that will be kept in memory. 0 means no limit.<br><p> <br><p> It requires Prometheus &gt;= v2.47.0.
+     */
     @JsonProperty("keepDroppedTargets")
     public void setKeepDroppedTargets(Long keepDroppedTargets) {
         this.keepDroppedTargets = keepDroppedTargets;
     }
 
+    /**
+     * Per-scrape limit on number of labels that will be accepted for a sample.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.
+     */
     @JsonProperty("labelLimit")
     public Long getLabelLimit() {
         return labelLimit;
     }
 
+    /**
+     * Per-scrape limit on number of labels that will be accepted for a sample.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.
+     */
     @JsonProperty("labelLimit")
     public void setLabelLimit(Long labelLimit) {
         this.labelLimit = labelLimit;
     }
 
+    /**
+     * Per-scrape limit on length of labels name that will be accepted for a sample.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.
+     */
     @JsonProperty("labelNameLengthLimit")
     public Long getLabelNameLengthLimit() {
         return labelNameLengthLimit;
     }
 
+    /**
+     * Per-scrape limit on length of labels name that will be accepted for a sample.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.
+     */
     @JsonProperty("labelNameLengthLimit")
     public void setLabelNameLengthLimit(Long labelNameLengthLimit) {
         this.labelNameLengthLimit = labelNameLengthLimit;
     }
 
+    /**
+     * Per-scrape limit on length of labels value that will be accepted for a sample.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.
+     */
     @JsonProperty("labelValueLengthLimit")
     public Long getLabelValueLengthLimit() {
         return labelValueLengthLimit;
     }
 
+    /**
+     * Per-scrape limit on length of labels value that will be accepted for a sample.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.
+     */
     @JsonProperty("labelValueLengthLimit")
     public void setLabelValueLengthLimit(Long labelValueLengthLimit) {
         this.labelValueLengthLimit = labelValueLengthLimit;
     }
 
+    /**
+     * PodMonitorSpec contains specification parameters for a PodMonitor.
+     */
     @JsonProperty("namespaceSelector")
     public NamespaceSelector getNamespaceSelector() {
         return namespaceSelector;
     }
 
+    /**
+     * PodMonitorSpec contains specification parameters for a PodMonitor.
+     */
     @JsonProperty("namespaceSelector")
     public void setNamespaceSelector(NamespaceSelector namespaceSelector) {
         this.namespaceSelector = namespaceSelector;
     }
 
+    /**
+     * If there are more than this many buckets in a native histogram, buckets will be merged to stay within the limit. It requires Prometheus &gt;= v2.45.0.
+     */
     @JsonProperty("nativeHistogramBucketLimit")
     public Long getNativeHistogramBucketLimit() {
         return nativeHistogramBucketLimit;
     }
 
+    /**
+     * If there are more than this many buckets in a native histogram, buckets will be merged to stay within the limit. It requires Prometheus &gt;= v2.45.0.
+     */
     @JsonProperty("nativeHistogramBucketLimit")
     public void setNativeHistogramBucketLimit(Long nativeHistogramBucketLimit) {
         this.nativeHistogramBucketLimit = nativeHistogramBucketLimit;
     }
 
+    /**
+     * PodMonitorSpec contains specification parameters for a PodMonitor.
+     */
     @JsonProperty("nativeHistogramMinBucketFactor")
     public Quantity getNativeHistogramMinBucketFactor() {
         return nativeHistogramMinBucketFactor;
     }
 
+    /**
+     * PodMonitorSpec contains specification parameters for a PodMonitor.
+     */
     @JsonProperty("nativeHistogramMinBucketFactor")
     public void setNativeHistogramMinBucketFactor(Quantity nativeHistogramMinBucketFactor) {
         this.nativeHistogramMinBucketFactor = nativeHistogramMinBucketFactor;
     }
 
+    /**
+     * Defines how to scrape metrics from the selected pods.
+     */
     @JsonProperty("podMetricsEndpoints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PodMetricsEndpoint> getPodMetricsEndpoints() {
         return podMetricsEndpoints;
     }
 
+    /**
+     * Defines how to scrape metrics from the selected pods.
+     */
     @JsonProperty("podMetricsEndpoints")
     public void setPodMetricsEndpoints(List<PodMetricsEndpoint> podMetricsEndpoints) {
         this.podMetricsEndpoints = podMetricsEndpoints;
     }
 
+    /**
+     * `podTargetLabels` defines the labels which are transferred from the associated Kubernetes `Pod` object onto the ingested metrics.
+     */
     @JsonProperty("podTargetLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPodTargetLabels() {
         return podTargetLabels;
     }
 
+    /**
+     * `podTargetLabels` defines the labels which are transferred from the associated Kubernetes `Pod` object onto the ingested metrics.
+     */
     @JsonProperty("podTargetLabels")
     public void setPodTargetLabels(List<String> podTargetLabels) {
         this.podTargetLabels = podTargetLabels;
     }
 
+    /**
+     * `sampleLimit` defines a per-scrape limit on the number of scraped samples that will be accepted.
+     */
     @JsonProperty("sampleLimit")
     public Long getSampleLimit() {
         return sampleLimit;
     }
 
+    /**
+     * `sampleLimit` defines a per-scrape limit on the number of scraped samples that will be accepted.
+     */
     @JsonProperty("sampleLimit")
     public void setSampleLimit(Long sampleLimit) {
         this.sampleLimit = sampleLimit;
     }
 
+    /**
+     * The scrape class to apply.
+     */
     @JsonProperty("scrapeClass")
     public String getScrapeClass() {
         return scrapeClass;
     }
 
+    /**
+     * The scrape class to apply.
+     */
     @JsonProperty("scrapeClass")
     public void setScrapeClass(String scrapeClass) {
         this.scrapeClass = scrapeClass;
     }
 
+    /**
+     * Whether to scrape a classic histogram that is also exposed as a native histogram. It requires Prometheus &gt;= v2.45.0.
+     */
     @JsonProperty("scrapeClassicHistograms")
     public Boolean getScrapeClassicHistograms() {
         return scrapeClassicHistograms;
     }
 
+    /**
+     * Whether to scrape a classic histogram that is also exposed as a native histogram. It requires Prometheus &gt;= v2.45.0.
+     */
     @JsonProperty("scrapeClassicHistograms")
     public void setScrapeClassicHistograms(Boolean scrapeClassicHistograms) {
         this.scrapeClassicHistograms = scrapeClassicHistograms;
     }
 
+    /**
+     * `scrapeProtocols` defines the protocols to negotiate during a scrape. It tells clients the protocols supported by Prometheus in order of preference (from most to least preferred).<br><p> <br><p> If unset, Prometheus uses its default value.<br><p> <br><p> It requires Prometheus &gt;= v2.49.0.
+     */
     @JsonProperty("scrapeProtocols")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getScrapeProtocols() {
         return scrapeProtocols;
     }
 
+    /**
+     * `scrapeProtocols` defines the protocols to negotiate during a scrape. It tells clients the protocols supported by Prometheus in order of preference (from most to least preferred).<br><p> <br><p> If unset, Prometheus uses its default value.<br><p> <br><p> It requires Prometheus &gt;= v2.49.0.
+     */
     @JsonProperty("scrapeProtocols")
     public void setScrapeProtocols(List<String> scrapeProtocols) {
         this.scrapeProtocols = scrapeProtocols;
     }
 
+    /**
+     * PodMonitorSpec contains specification parameters for a PodMonitor.
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * PodMonitorSpec contains specification parameters for a PodMonitor.
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * Mechanism used to select the endpoints to scrape. By default, the selection process relies on relabel configurations to filter the discovered targets. Alternatively, you can opt in for role selectors, which may offer better efficiency in large clusters. Which strategy is best for your use case needs to be carefully evaluated.<br><p> <br><p> It requires Prometheus &gt;= v2.17.0.
+     */
     @JsonProperty("selectorMechanism")
     public String getSelectorMechanism() {
         return selectorMechanism;
     }
 
+    /**
+     * Mechanism used to select the endpoints to scrape. By default, the selection process relies on relabel configurations to filter the discovered targets. Alternatively, you can opt in for role selectors, which may offer better efficiency in large clusters. Which strategy is best for your use case needs to be carefully evaluated.<br><p> <br><p> It requires Prometheus &gt;= v2.17.0.
+     */
     @JsonProperty("selectorMechanism")
     public void setSelectorMechanism(String selectorMechanism) {
         this.selectorMechanism = selectorMechanism;
     }
 
+    /**
+     * `targetLimit` defines a limit on the number of scraped targets that will be accepted.
+     */
     @JsonProperty("targetLimit")
     public Long getTargetLimit() {
         return targetLimit;
     }
 
+    /**
+     * `targetLimit` defines a limit on the number of scraped targets that will be accepted.
+     */
     @JsonProperty("targetLimit")
     public void setTargetLimit(Long targetLimit) {
         this.targetLimit = targetLimit;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Probe.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Probe.java
index 0ba5dd6b316..c229669ac3c 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Probe.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Probe.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * The `Probe` custom resource definition (CRD) defines how to scrape metrics from prober exporters such as the [blackbox exporter](https://github.com/prometheus/blackbox_exporter).<br><p> <br><p> The `Probe` resource needs 2 pieces of information: &#42; The list of probed addresses which can be defined statically or by discovering Kubernetes Ingress objects. &#42; The prober which exposes the availability of probed endpoints (over various protocols such HTTP, TCP, ICMP, ...) as Prometheus metrics.<br><p> <br><p> `Prometheus` and `PrometheusAgent` objects select `Probe` objects using label and namespace selectors.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Probe implements Editable<ProbeBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "monitoring.coreos.com/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Probe";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public Probe(String apiVersion, String kind, ObjectMeta metadata, ProbeSpec spec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * The `Probe` custom resource definition (CRD) defines how to scrape metrics from prober exporters such as the [blackbox exporter](https://github.com/prometheus/blackbox_exporter).<br><p> <br><p> The `Probe` resource needs 2 pieces of information: &#42; The list of probed addresses which can be defined statically or by discovering Kubernetes Ingress objects. &#42; The prober which exposes the availability of probed endpoints (over various protocols such HTTP, TCP, ICMP, ...) as Prometheus metrics.<br><p> <br><p> `Prometheus` and `PrometheusAgent` objects select `Probe` objects using label and namespace selectors.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * The `Probe` custom resource definition (CRD) defines how to scrape metrics from prober exporters such as the [blackbox exporter](https://github.com/prometheus/blackbox_exporter).<br><p> <br><p> The `Probe` resource needs 2 pieces of information: &#42; The list of probed addresses which can be defined statically or by discovering Kubernetes Ingress objects. &#42; The prober which exposes the availability of probed endpoints (over various protocols such HTTP, TCP, ICMP, ...) as Prometheus metrics.<br><p> <br><p> `Prometheus` and `PrometheusAgent` objects select `Probe` objects using label and namespace selectors.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * The `Probe` custom resource definition (CRD) defines how to scrape metrics from prober exporters such as the [blackbox exporter](https://github.com/prometheus/blackbox_exporter).<br><p> <br><p> The `Probe` resource needs 2 pieces of information: &#42; The list of probed addresses which can be defined statically or by discovering Kubernetes Ingress objects. &#42; The prober which exposes the availability of probed endpoints (over various protocols such HTTP, TCP, ICMP, ...) as Prometheus metrics.<br><p> <br><p> `Prometheus` and `PrometheusAgent` objects select `Probe` objects using label and namespace selectors.
+     */
     @JsonProperty("spec")
     public ProbeSpec getSpec() {
         return spec;
     }
 
+    /**
+     * The `Probe` custom resource definition (CRD) defines how to scrape metrics from prober exporters such as the [blackbox exporter](https://github.com/prometheus/blackbox_exporter).<br><p> <br><p> The `Probe` resource needs 2 pieces of information: &#42; The list of probed addresses which can be defined statically or by discovering Kubernetes Ingress objects. &#42; The prober which exposes the availability of probed endpoints (over various protocols such HTTP, TCP, ICMP, ...) as Prometheus metrics.<br><p> <br><p> `Prometheus` and `PrometheusAgent` objects select `Probe` objects using label and namespace selectors.
+     */
     @JsonProperty("spec")
     public void setSpec(ProbeSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProbeList.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProbeList.java
index bbcce7dd7a6..9b1cb669908 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProbeList.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProbeList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ProbeList is a list of Probes.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ProbeList implements Editable<ProbeListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.monitoring.v1.Probe>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "monitoring.coreos.com/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.monitoring.v1.Probe> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ProbeList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ProbeList(String apiVersion, List<io.fabric8.openshift.api.model.monitori
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of Probes
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.monitoring.v1.Probe> getItems() {
         return items;
     }
 
+    /**
+     * List of Probes
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.monitoring.v1.Probe> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ProbeList is a list of Probes.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ProbeList is a list of Probes.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProbeSpec.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProbeSpec.java
index 314f0c7ec32..a9a350182fa 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProbeSpec.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProbeSpec.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ProbeSpec contains specification parameters for a Probe.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -176,243 +179,387 @@ public ProbeSpec(SafeAuthorization authorization, BasicAuth basicAuth, SecretKey
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * ProbeSpec contains specification parameters for a Probe.
+     */
     @JsonProperty("authorization")
     public SafeAuthorization getAuthorization() {
         return authorization;
     }
 
+    /**
+     * ProbeSpec contains specification parameters for a Probe.
+     */
     @JsonProperty("authorization")
     public void setAuthorization(SafeAuthorization authorization) {
         this.authorization = authorization;
     }
 
+    /**
+     * ProbeSpec contains specification parameters for a Probe.
+     */
     @JsonProperty("basicAuth")
     public BasicAuth getBasicAuth() {
         return basicAuth;
     }
 
+    /**
+     * ProbeSpec contains specification parameters for a Probe.
+     */
     @JsonProperty("basicAuth")
     public void setBasicAuth(BasicAuth basicAuth) {
         this.basicAuth = basicAuth;
     }
 
+    /**
+     * ProbeSpec contains specification parameters for a Probe.
+     */
     @JsonProperty("bearerTokenSecret")
     public SecretKeySelector getBearerTokenSecret() {
         return bearerTokenSecret;
     }
 
+    /**
+     * ProbeSpec contains specification parameters for a Probe.
+     */
     @JsonProperty("bearerTokenSecret")
     public void setBearerTokenSecret(SecretKeySelector bearerTokenSecret) {
         this.bearerTokenSecret = bearerTokenSecret;
     }
 
+    /**
+     * The protocol to use if a scrape returns blank, unparseable, or otherwise invalid Content-Type.<br><p> <br><p> It requires Prometheus &gt;= v3.0.0.
+     */
     @JsonProperty("fallbackScrapeProtocol")
     public String getFallbackScrapeProtocol() {
         return fallbackScrapeProtocol;
     }
 
+    /**
+     * The protocol to use if a scrape returns blank, unparseable, or otherwise invalid Content-Type.<br><p> <br><p> It requires Prometheus &gt;= v3.0.0.
+     */
     @JsonProperty("fallbackScrapeProtocol")
     public void setFallbackScrapeProtocol(String fallbackScrapeProtocol) {
         this.fallbackScrapeProtocol = fallbackScrapeProtocol;
     }
 
+    /**
+     * Interval at which targets are probed using the configured prober. If not specified Prometheus' global scrape interval is used.
+     */
     @JsonProperty("interval")
     public String getInterval() {
         return interval;
     }
 
+    /**
+     * Interval at which targets are probed using the configured prober. If not specified Prometheus' global scrape interval is used.
+     */
     @JsonProperty("interval")
     public void setInterval(String interval) {
         this.interval = interval;
     }
 
+    /**
+     * The job name assigned to scraped metrics by default.
+     */
     @JsonProperty("jobName")
     public String getJobName() {
         return jobName;
     }
 
+    /**
+     * The job name assigned to scraped metrics by default.
+     */
     @JsonProperty("jobName")
     public void setJobName(String jobName) {
         this.jobName = jobName;
     }
 
+    /**
+     * Per-scrape limit on the number of targets dropped by relabeling that will be kept in memory. 0 means no limit.<br><p> <br><p> It requires Prometheus &gt;= v2.47.0.
+     */
     @JsonProperty("keepDroppedTargets")
     public Long getKeepDroppedTargets() {
         return keepDroppedTargets;
     }
 
+    /**
+     * Per-scrape limit on the number of targets dropped by relabeling that will be kept in memory. 0 means no limit.<br><p> <br><p> It requires Prometheus &gt;= v2.47.0.
+     */
     @JsonProperty("keepDroppedTargets")
     public void setKeepDroppedTargets(Long keepDroppedTargets) {
         this.keepDroppedTargets = keepDroppedTargets;
     }
 
+    /**
+     * Per-scrape limit on number of labels that will be accepted for a sample. Only valid in Prometheus versions 2.27.0 and newer.
+     */
     @JsonProperty("labelLimit")
     public Long getLabelLimit() {
         return labelLimit;
     }
 
+    /**
+     * Per-scrape limit on number of labels that will be accepted for a sample. Only valid in Prometheus versions 2.27.0 and newer.
+     */
     @JsonProperty("labelLimit")
     public void setLabelLimit(Long labelLimit) {
         this.labelLimit = labelLimit;
     }
 
+    /**
+     * Per-scrape limit on length of labels name that will be accepted for a sample. Only valid in Prometheus versions 2.27.0 and newer.
+     */
     @JsonProperty("labelNameLengthLimit")
     public Long getLabelNameLengthLimit() {
         return labelNameLengthLimit;
     }
 
+    /**
+     * Per-scrape limit on length of labels name that will be accepted for a sample. Only valid in Prometheus versions 2.27.0 and newer.
+     */
     @JsonProperty("labelNameLengthLimit")
     public void setLabelNameLengthLimit(Long labelNameLengthLimit) {
         this.labelNameLengthLimit = labelNameLengthLimit;
     }
 
+    /**
+     * Per-scrape limit on length of labels value that will be accepted for a sample. Only valid in Prometheus versions 2.27.0 and newer.
+     */
     @JsonProperty("labelValueLengthLimit")
     public Long getLabelValueLengthLimit() {
         return labelValueLengthLimit;
     }
 
+    /**
+     * Per-scrape limit on length of labels value that will be accepted for a sample. Only valid in Prometheus versions 2.27.0 and newer.
+     */
     @JsonProperty("labelValueLengthLimit")
     public void setLabelValueLengthLimit(Long labelValueLengthLimit) {
         this.labelValueLengthLimit = labelValueLengthLimit;
     }
 
+    /**
+     * MetricRelabelConfigs to apply to samples before ingestion.
+     */
     @JsonProperty("metricRelabelings")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RelabelConfig> getMetricRelabelings() {
         return metricRelabelings;
     }
 
+    /**
+     * MetricRelabelConfigs to apply to samples before ingestion.
+     */
     @JsonProperty("metricRelabelings")
     public void setMetricRelabelings(List<RelabelConfig> metricRelabelings) {
         this.metricRelabelings = metricRelabelings;
     }
 
+    /**
+     * The module to use for probing specifying how to probe the target. Example module configuring in the blackbox exporter: https://github.com/prometheus/blackbox_exporter/blob/master/example.yml
+     */
     @JsonProperty("module")
     public String getModule() {
         return module;
     }
 
+    /**
+     * The module to use for probing specifying how to probe the target. Example module configuring in the blackbox exporter: https://github.com/prometheus/blackbox_exporter/blob/master/example.yml
+     */
     @JsonProperty("module")
     public void setModule(String module) {
         this.module = module;
     }
 
+    /**
+     * If there are more than this many buckets in a native histogram, buckets will be merged to stay within the limit. It requires Prometheus &gt;= v2.45.0.
+     */
     @JsonProperty("nativeHistogramBucketLimit")
     public Long getNativeHistogramBucketLimit() {
         return nativeHistogramBucketLimit;
     }
 
+    /**
+     * If there are more than this many buckets in a native histogram, buckets will be merged to stay within the limit. It requires Prometheus &gt;= v2.45.0.
+     */
     @JsonProperty("nativeHistogramBucketLimit")
     public void setNativeHistogramBucketLimit(Long nativeHistogramBucketLimit) {
         this.nativeHistogramBucketLimit = nativeHistogramBucketLimit;
     }
 
+    /**
+     * ProbeSpec contains specification parameters for a Probe.
+     */
     @JsonProperty("nativeHistogramMinBucketFactor")
     public Quantity getNativeHistogramMinBucketFactor() {
         return nativeHistogramMinBucketFactor;
     }
 
+    /**
+     * ProbeSpec contains specification parameters for a Probe.
+     */
     @JsonProperty("nativeHistogramMinBucketFactor")
     public void setNativeHistogramMinBucketFactor(Quantity nativeHistogramMinBucketFactor) {
         this.nativeHistogramMinBucketFactor = nativeHistogramMinBucketFactor;
     }
 
+    /**
+     * ProbeSpec contains specification parameters for a Probe.
+     */
     @JsonProperty("oauth2")
     public OAuth2 getOauth2() {
         return oauth2;
     }
 
+    /**
+     * ProbeSpec contains specification parameters for a Probe.
+     */
     @JsonProperty("oauth2")
     public void setOauth2(OAuth2 oauth2) {
         this.oauth2 = oauth2;
     }
 
+    /**
+     * ProbeSpec contains specification parameters for a Probe.
+     */
     @JsonProperty("prober")
     public ProberSpec getProber() {
         return prober;
     }
 
+    /**
+     * ProbeSpec contains specification parameters for a Probe.
+     */
     @JsonProperty("prober")
     public void setProber(ProberSpec prober) {
         this.prober = prober;
     }
 
+    /**
+     * SampleLimit defines per-scrape limit on number of scraped samples that will be accepted.
+     */
     @JsonProperty("sampleLimit")
     public Long getSampleLimit() {
         return sampleLimit;
     }
 
+    /**
+     * SampleLimit defines per-scrape limit on number of scraped samples that will be accepted.
+     */
     @JsonProperty("sampleLimit")
     public void setSampleLimit(Long sampleLimit) {
         this.sampleLimit = sampleLimit;
     }
 
+    /**
+     * The scrape class to apply.
+     */
     @JsonProperty("scrapeClass")
     public String getScrapeClass() {
         return scrapeClass;
     }
 
+    /**
+     * The scrape class to apply.
+     */
     @JsonProperty("scrapeClass")
     public void setScrapeClass(String scrapeClass) {
         this.scrapeClass = scrapeClass;
     }
 
+    /**
+     * Whether to scrape a classic histogram that is also exposed as a native histogram. It requires Prometheus &gt;= v2.45.0.
+     */
     @JsonProperty("scrapeClassicHistograms")
     public Boolean getScrapeClassicHistograms() {
         return scrapeClassicHistograms;
     }
 
+    /**
+     * Whether to scrape a classic histogram that is also exposed as a native histogram. It requires Prometheus &gt;= v2.45.0.
+     */
     @JsonProperty("scrapeClassicHistograms")
     public void setScrapeClassicHistograms(Boolean scrapeClassicHistograms) {
         this.scrapeClassicHistograms = scrapeClassicHistograms;
     }
 
+    /**
+     * `scrapeProtocols` defines the protocols to negotiate during a scrape. It tells clients the protocols supported by Prometheus in order of preference (from most to least preferred).<br><p> <br><p> If unset, Prometheus uses its default value.<br><p> <br><p> It requires Prometheus &gt;= v2.49.0.
+     */
     @JsonProperty("scrapeProtocols")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getScrapeProtocols() {
         return scrapeProtocols;
     }
 
+    /**
+     * `scrapeProtocols` defines the protocols to negotiate during a scrape. It tells clients the protocols supported by Prometheus in order of preference (from most to least preferred).<br><p> <br><p> If unset, Prometheus uses its default value.<br><p> <br><p> It requires Prometheus &gt;= v2.49.0.
+     */
     @JsonProperty("scrapeProtocols")
     public void setScrapeProtocols(List<String> scrapeProtocols) {
         this.scrapeProtocols = scrapeProtocols;
     }
 
+    /**
+     * Timeout for scraping metrics from the Prometheus exporter. If not specified, the Prometheus global scrape timeout is used.
+     */
     @JsonProperty("scrapeTimeout")
     public String getScrapeTimeout() {
         return scrapeTimeout;
     }
 
+    /**
+     * Timeout for scraping metrics from the Prometheus exporter. If not specified, the Prometheus global scrape timeout is used.
+     */
     @JsonProperty("scrapeTimeout")
     public void setScrapeTimeout(String scrapeTimeout) {
         this.scrapeTimeout = scrapeTimeout;
     }
 
+    /**
+     * TargetLimit defines a limit on the number of scraped targets that will be accepted.
+     */
     @JsonProperty("targetLimit")
     public Long getTargetLimit() {
         return targetLimit;
     }
 
+    /**
+     * TargetLimit defines a limit on the number of scraped targets that will be accepted.
+     */
     @JsonProperty("targetLimit")
     public void setTargetLimit(Long targetLimit) {
         this.targetLimit = targetLimit;
     }
 
+    /**
+     * ProbeSpec contains specification parameters for a Probe.
+     */
     @JsonProperty("targets")
     public ProbeTargets getTargets() {
         return targets;
     }
 
+    /**
+     * ProbeSpec contains specification parameters for a Probe.
+     */
     @JsonProperty("targets")
     public void setTargets(ProbeTargets targets) {
         this.targets = targets;
     }
 
+    /**
+     * ProbeSpec contains specification parameters for a Probe.
+     */
     @JsonProperty("tlsConfig")
     public SafeTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * ProbeSpec contains specification parameters for a Probe.
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(SafeTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProbeTargetIngress.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProbeTargetIngress.java
index b4f90364912..03cb875d639 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProbeTargetIngress.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProbeTargetIngress.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ProbeTargetIngress defines the set of Ingress objects considered for probing. The operator configures a target for each host/path combination of each ingress object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public ProbeTargetIngress(NamespaceSelector namespaceSelector, List<RelabelConfi
         this.selector = selector;
     }
 
+    /**
+     * ProbeTargetIngress defines the set of Ingress objects considered for probing. The operator configures a target for each host/path combination of each ingress object.
+     */
     @JsonProperty("namespaceSelector")
     public NamespaceSelector getNamespaceSelector() {
         return namespaceSelector;
     }
 
+    /**
+     * ProbeTargetIngress defines the set of Ingress objects considered for probing. The operator configures a target for each host/path combination of each ingress object.
+     */
     @JsonProperty("namespaceSelector")
     public void setNamespaceSelector(NamespaceSelector namespaceSelector) {
         this.namespaceSelector = namespaceSelector;
     }
 
+    /**
+     * RelabelConfigs to apply to the label set of the target before it gets scraped. The original ingress address is available via the `__tmp_prometheus_ingress_address` label. It can be used to customize the probed URL. The original scrape job's name is available via the `__tmp_prometheus_job_name` label. More info: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config
+     */
     @JsonProperty("relabelingConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RelabelConfig> getRelabelingConfigs() {
         return relabelingConfigs;
     }
 
+    /**
+     * RelabelConfigs to apply to the label set of the target before it gets scraped. The original ingress address is available via the `__tmp_prometheus_ingress_address` label. It can be used to customize the probed URL. The original scrape job's name is available via the `__tmp_prometheus_job_name` label. More info: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config
+     */
     @JsonProperty("relabelingConfigs")
     public void setRelabelingConfigs(List<RelabelConfig> relabelingConfigs) {
         this.relabelingConfigs = relabelingConfigs;
     }
 
+    /**
+     * ProbeTargetIngress defines the set of Ingress objects considered for probing. The operator configures a target for each host/path combination of each ingress object.
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * ProbeTargetIngress defines the set of Ingress objects considered for probing. The operator configures a target for each host/path combination of each ingress object.
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProbeTargetStaticConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProbeTargetStaticConfig.java
index 968952675dc..bc8d3170575 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProbeTargetStaticConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProbeTargetStaticConfig.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ProbeTargetStaticConfig defines the set of static targets considered for probing.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,34 +94,52 @@ public ProbeTargetStaticConfig(Map<String, String> labels, List<RelabelConfig> r
         this._static = _static;
     }
 
+    /**
+     * Labels assigned to all metrics scraped from the targets.
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabels() {
         return labels;
     }
 
+    /**
+     * Labels assigned to all metrics scraped from the targets.
+     */
     @JsonProperty("labels")
     public void setLabels(Map<String, String> labels) {
         this.labels = labels;
     }
 
+    /**
+     * RelabelConfigs to apply to the label set of the targets before it gets scraped. More info: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config
+     */
     @JsonProperty("relabelingConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RelabelConfig> getRelabelingConfigs() {
         return relabelingConfigs;
     }
 
+    /**
+     * RelabelConfigs to apply to the label set of the targets before it gets scraped. More info: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config
+     */
     @JsonProperty("relabelingConfigs")
     public void setRelabelingConfigs(List<RelabelConfig> relabelingConfigs) {
         this.relabelingConfigs = relabelingConfigs;
     }
 
+    /**
+     * The list of hosts to probe.
+     */
     @JsonProperty("static")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getStatic() {
         return _static;
     }
 
+    /**
+     * The list of hosts to probe.
+     */
     @JsonProperty("static")
     public void setStatic(List<String> _static) {
         this._static = _static;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProbeTargets.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProbeTargets.java
index 9d6939e0a99..e15b528efc4 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProbeTargets.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProbeTargets.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ProbeTargets defines how to discover the probed targets. One of the `staticConfig` or `ingress` must be defined. If both are defined, `staticConfig` takes precedence.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ProbeTargets(ProbeTargetIngress ingress, ProbeTargetStaticConfig staticCo
         this.staticConfig = staticConfig;
     }
 
+    /**
+     * ProbeTargets defines how to discover the probed targets. One of the `staticConfig` or `ingress` must be defined. If both are defined, `staticConfig` takes precedence.
+     */
     @JsonProperty("ingress")
     public ProbeTargetIngress getIngress() {
         return ingress;
     }
 
+    /**
+     * ProbeTargets defines how to discover the probed targets. One of the `staticConfig` or `ingress` must be defined. If both are defined, `staticConfig` takes precedence.
+     */
     @JsonProperty("ingress")
     public void setIngress(ProbeTargetIngress ingress) {
         this.ingress = ingress;
     }
 
+    /**
+     * ProbeTargets defines how to discover the probed targets. One of the `staticConfig` or `ingress` must be defined. If both are defined, `staticConfig` takes precedence.
+     */
     @JsonProperty("staticConfig")
     public ProbeTargetStaticConfig getStaticConfig() {
         return staticConfig;
     }
 
+    /**
+     * ProbeTargets defines how to discover the probed targets. One of the `staticConfig` or `ingress` must be defined. If both are defined, `staticConfig` takes precedence.
+     */
     @JsonProperty("staticConfig")
     public void setStaticConfig(ProbeTargetStaticConfig staticConfig) {
         this.staticConfig = staticConfig;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProbeTargetsValidationError.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProbeTargetsValidationError.java
index 8cee417b16b..a7135a391d5 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProbeTargetsValidationError.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProbeTargetsValidationError.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ProbeTargetsValidationError is returned by ProbeTargets.Validate() on semantically invalid configurations.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProberSpec.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProberSpec.java
index 0ae2941a0ef..b88ebbf1d0c 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProberSpec.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProberSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ProberSpec contains specification parameters for the Prober used for probing.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ProberSpec(String path, String proxyUrl, String scheme, String url) {
         this.url = url;
     }
 
+    /**
+     * Path to collect metrics from. Defaults to `/probe`.
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Path to collect metrics from. Defaults to `/probe`.
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * Optional ProxyURL.
+     */
     @JsonProperty("proxyUrl")
     public String getProxyUrl() {
         return proxyUrl;
     }
 
+    /**
+     * Optional ProxyURL.
+     */
     @JsonProperty("proxyUrl")
     public void setProxyUrl(String proxyUrl) {
         this.proxyUrl = proxyUrl;
     }
 
+    /**
+     * HTTP scheme to use for scraping. `http` and `https` are the expected values unless you rewrite the `__scheme__` label via relabeling. If empty, Prometheus uses the default value `http`.
+     */
     @JsonProperty("scheme")
     public String getScheme() {
         return scheme;
     }
 
+    /**
+     * HTTP scheme to use for scraping. `http` and `https` are the expected values unless you rewrite the `__scheme__` label via relabeling. If empty, Prometheus uses the default value `http`.
+     */
     @JsonProperty("scheme")
     public void setScheme(String scheme) {
         this.scheme = scheme;
     }
 
+    /**
+     * Mandatory URL of the prober.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * Mandatory URL of the prober.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Prometheus.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Prometheus.java
index e50e002c7bb..deee45e5d21 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Prometheus.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Prometheus.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * The `Prometheus` custom resource definition (CRD) defines a desired [Prometheus](https://prometheus.io/docs/prometheus) setup to run in a Kubernetes cluster. It allows to specify many options such as the number of replicas, persistent storage, and Alertmanagers where firing alerts should be sent and many more.<br><p> <br><p> For each `Prometheus` resource, the Operator deploys one or several `StatefulSet` objects in the same namespace. The number of StatefulSets is equal to the number of shards which is 1 by default.<br><p> <br><p> The resource defines via label and namespace selectors which `ServiceMonitor`, `PodMonitor`, `Probe` and `PrometheusRule` objects should be associated to the deployed Prometheus instances.<br><p> <br><p> The Operator continuously reconciles the scrape and rules configuration and a sidecar container running in the Prometheus pods triggers a reload of the configuration when needed.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Prometheus implements Editable<PrometheusBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "monitoring.coreos.com/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Prometheus";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Prometheus(String apiVersion, String kind, ObjectMeta metadata, Prometheu
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * The `Prometheus` custom resource definition (CRD) defines a desired [Prometheus](https://prometheus.io/docs/prometheus) setup to run in a Kubernetes cluster. It allows to specify many options such as the number of replicas, persistent storage, and Alertmanagers where firing alerts should be sent and many more.<br><p> <br><p> For each `Prometheus` resource, the Operator deploys one or several `StatefulSet` objects in the same namespace. The number of StatefulSets is equal to the number of shards which is 1 by default.<br><p> <br><p> The resource defines via label and namespace selectors which `ServiceMonitor`, `PodMonitor`, `Probe` and `PrometheusRule` objects should be associated to the deployed Prometheus instances.<br><p> <br><p> The Operator continuously reconciles the scrape and rules configuration and a sidecar container running in the Prometheus pods triggers a reload of the configuration when needed.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * The `Prometheus` custom resource definition (CRD) defines a desired [Prometheus](https://prometheus.io/docs/prometheus) setup to run in a Kubernetes cluster. It allows to specify many options such as the number of replicas, persistent storage, and Alertmanagers where firing alerts should be sent and many more.<br><p> <br><p> For each `Prometheus` resource, the Operator deploys one or several `StatefulSet` objects in the same namespace. The number of StatefulSets is equal to the number of shards which is 1 by default.<br><p> <br><p> The resource defines via label and namespace selectors which `ServiceMonitor`, `PodMonitor`, `Probe` and `PrometheusRule` objects should be associated to the deployed Prometheus instances.<br><p> <br><p> The Operator continuously reconciles the scrape and rules configuration and a sidecar container running in the Prometheus pods triggers a reload of the configuration when needed.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * The `Prometheus` custom resource definition (CRD) defines a desired [Prometheus](https://prometheus.io/docs/prometheus) setup to run in a Kubernetes cluster. It allows to specify many options such as the number of replicas, persistent storage, and Alertmanagers where firing alerts should be sent and many more.<br><p> <br><p> For each `Prometheus` resource, the Operator deploys one or several `StatefulSet` objects in the same namespace. The number of StatefulSets is equal to the number of shards which is 1 by default.<br><p> <br><p> The resource defines via label and namespace selectors which `ServiceMonitor`, `PodMonitor`, `Probe` and `PrometheusRule` objects should be associated to the deployed Prometheus instances.<br><p> <br><p> The Operator continuously reconciles the scrape and rules configuration and a sidecar container running in the Prometheus pods triggers a reload of the configuration when needed.
+     */
     @JsonProperty("spec")
     public PrometheusSpec getSpec() {
         return spec;
     }
 
+    /**
+     * The `Prometheus` custom resource definition (CRD) defines a desired [Prometheus](https://prometheus.io/docs/prometheus) setup to run in a Kubernetes cluster. It allows to specify many options such as the number of replicas, persistent storage, and Alertmanagers where firing alerts should be sent and many more.<br><p> <br><p> For each `Prometheus` resource, the Operator deploys one or several `StatefulSet` objects in the same namespace. The number of StatefulSets is equal to the number of shards which is 1 by default.<br><p> <br><p> The resource defines via label and namespace selectors which `ServiceMonitor`, `PodMonitor`, `Probe` and `PrometheusRule` objects should be associated to the deployed Prometheus instances.<br><p> <br><p> The Operator continuously reconciles the scrape and rules configuration and a sidecar container running in the Prometheus pods triggers a reload of the configuration when needed.
+     */
     @JsonProperty("spec")
     public void setSpec(PrometheusSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * The `Prometheus` custom resource definition (CRD) defines a desired [Prometheus](https://prometheus.io/docs/prometheus) setup to run in a Kubernetes cluster. It allows to specify many options such as the number of replicas, persistent storage, and Alertmanagers where firing alerts should be sent and many more.<br><p> <br><p> For each `Prometheus` resource, the Operator deploys one or several `StatefulSet` objects in the same namespace. The number of StatefulSets is equal to the number of shards which is 1 by default.<br><p> <br><p> The resource defines via label and namespace selectors which `ServiceMonitor`, `PodMonitor`, `Probe` and `PrometheusRule` objects should be associated to the deployed Prometheus instances.<br><p> <br><p> The Operator continuously reconciles the scrape and rules configuration and a sidecar container running in the Prometheus pods triggers a reload of the configuration when needed.
+     */
     @JsonProperty("status")
     public PrometheusStatus getStatus() {
         return status;
     }
 
+    /**
+     * The `Prometheus` custom resource definition (CRD) defines a desired [Prometheus](https://prometheus.io/docs/prometheus) setup to run in a Kubernetes cluster. It allows to specify many options such as the number of replicas, persistent storage, and Alertmanagers where firing alerts should be sent and many more.<br><p> <br><p> For each `Prometheus` resource, the Operator deploys one or several `StatefulSet` objects in the same namespace. The number of StatefulSets is equal to the number of shards which is 1 by default.<br><p> <br><p> The resource defines via label and namespace selectors which `ServiceMonitor`, `PodMonitor`, `Probe` and `PrometheusRule` objects should be associated to the deployed Prometheus instances.<br><p> <br><p> The Operator continuously reconciles the scrape and rules configuration and a sidecar container running in the Prometheus pods triggers a reload of the configuration when needed.
+     */
     @JsonProperty("status")
     public void setStatus(PrometheusStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusList.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusList.java
index fe1ead111e1..c10cce27c06 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusList.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PrometheusList is a list of Prometheuses.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PrometheusList implements Editable<PrometheusListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.monitoring.v1.Prometheus>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "monitoring.coreos.com/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.monitoring.v1.Prometheus> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PrometheusList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PrometheusList(String apiVersion, List<io.fabric8.openshift.api.model.mon
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of Prometheuses
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.monitoring.v1.Prometheus> getItems() {
         return items;
     }
 
+    /**
+     * List of Prometheuses
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.monitoring.v1.Prometheus> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PrometheusList is a list of Prometheuses.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PrometheusList is a list of Prometheuses.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusRule.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusRule.java
index 4a9c4eb281e..beed9408117 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusRule.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusRule.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * The `PrometheusRule` custom resource definition (CRD) defines [alerting](https://prometheus.io/docs/prometheus/latest/configuration/alerting_rules/) and [recording](https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/) rules to be evaluated by `Prometheus` or `ThanosRuler` objects.<br><p> <br><p> `Prometheus` and `ThanosRuler` objects select `PrometheusRule` objects using label and namespace selectors.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class PrometheusRule implements Editable<PrometheusRuleBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "monitoring.coreos.com/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PrometheusRule";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public PrometheusRule(String apiVersion, String kind, ObjectMeta metadata, Prome
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * The `PrometheusRule` custom resource definition (CRD) defines [alerting](https://prometheus.io/docs/prometheus/latest/configuration/alerting_rules/) and [recording](https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/) rules to be evaluated by `Prometheus` or `ThanosRuler` objects.<br><p> <br><p> `Prometheus` and `ThanosRuler` objects select `PrometheusRule` objects using label and namespace selectors.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * The `PrometheusRule` custom resource definition (CRD) defines [alerting](https://prometheus.io/docs/prometheus/latest/configuration/alerting_rules/) and [recording](https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/) rules to be evaluated by `Prometheus` or `ThanosRuler` objects.<br><p> <br><p> `Prometheus` and `ThanosRuler` objects select `PrometheusRule` objects using label and namespace selectors.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * The `PrometheusRule` custom resource definition (CRD) defines [alerting](https://prometheus.io/docs/prometheus/latest/configuration/alerting_rules/) and [recording](https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/) rules to be evaluated by `Prometheus` or `ThanosRuler` objects.<br><p> <br><p> `Prometheus` and `ThanosRuler` objects select `PrometheusRule` objects using label and namespace selectors.
+     */
     @JsonProperty("spec")
     public PrometheusRuleSpec getSpec() {
         return spec;
     }
 
+    /**
+     * The `PrometheusRule` custom resource definition (CRD) defines [alerting](https://prometheus.io/docs/prometheus/latest/configuration/alerting_rules/) and [recording](https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/) rules to be evaluated by `Prometheus` or `ThanosRuler` objects.<br><p> <br><p> `Prometheus` and `ThanosRuler` objects select `PrometheusRule` objects using label and namespace selectors.
+     */
     @JsonProperty("spec")
     public void setSpec(PrometheusRuleSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusRuleExcludeConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusRuleExcludeConfig.java
index 6c2bf4f0ffc..cc54d30eeb9 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusRuleExcludeConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusRuleExcludeConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PrometheusRuleExcludeConfig enables users to configure excluded PrometheusRule names and their namespaces to be ignored while enforcing namespace label for alerts and metrics.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PrometheusRuleExcludeConfig(String ruleName, String ruleNamespace) {
         this.ruleNamespace = ruleNamespace;
     }
 
+    /**
+     * Name of the excluded PrometheusRule object.
+     */
     @JsonProperty("ruleName")
     public String getRuleName() {
         return ruleName;
     }
 
+    /**
+     * Name of the excluded PrometheusRule object.
+     */
     @JsonProperty("ruleName")
     public void setRuleName(String ruleName) {
         this.ruleName = ruleName;
     }
 
+    /**
+     * Namespace of the excluded PrometheusRule object.
+     */
     @JsonProperty("ruleNamespace")
     public String getRuleNamespace() {
         return ruleNamespace;
     }
 
+    /**
+     * Namespace of the excluded PrometheusRule object.
+     */
     @JsonProperty("ruleNamespace")
     public void setRuleNamespace(String ruleNamespace) {
         this.ruleNamespace = ruleNamespace;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusRuleList.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusRuleList.java
index 48da9d8e231..829197b9b6d 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusRuleList.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusRuleList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PrometheusRuleList is a list of PrometheusRules.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PrometheusRuleList implements Editable<PrometheusRuleListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.monitoring.v1.PrometheusRule>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "monitoring.coreos.com/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.monitoring.v1.PrometheusRule> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PrometheusRuleList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PrometheusRuleList(String apiVersion, List<io.fabric8.openshift.api.model
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of Rules
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.monitoring.v1.PrometheusRule> getItems() {
         return items;
     }
 
+    /**
+     * List of Rules
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.monitoring.v1.PrometheusRule> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PrometheusRuleList is a list of PrometheusRules.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PrometheusRuleList is a list of PrometheusRules.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusRuleRef.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusRuleRef.java
index 0ef01e30bfa..a0a9e0b4ccb 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusRuleRef.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusRuleRef.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PrometheusRuleRef is a reference to an existing PrometheusRule object.  Each AlertingRule instance results in a generated PrometheusRule object in the same namespace, which is always the openshift-monitoring namespace.  This is used to point to the generated PrometheusRule object in the AlertingRule status.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public PrometheusRuleRef(String name) {
         this.name = name;
     }
 
+    /**
+     * name of the referenced PrometheusRule.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name of the referenced PrometheusRule.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusRuleSpec.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusRuleSpec.java
index 3681ed84e53..2fc31e78af1 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusRuleSpec.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusRuleSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PrometheusRuleSpec contains specification parameters for a Rule.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public PrometheusRuleSpec(List<RuleGroup> groups) {
         this.groups = groups;
     }
 
+    /**
+     * Content of Prometheus rule file
+     */
     @JsonProperty("groups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RuleGroup> getGroups() {
         return groups;
     }
 
+    /**
+     * Content of Prometheus rule file
+     */
     @JsonProperty("groups")
     public void setGroups(List<RuleGroup> groups) {
         this.groups = groups;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusSpec.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusSpec.java
index f90b73786a2..44b4d96b7b6 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusSpec.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusSpec.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -551,1143 +554,1815 @@ public PrometheusSpec(SecretKeySelector additionalAlertManagerConfigs, SecretKey
         this.web = web;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("additionalAlertManagerConfigs")
     public SecretKeySelector getAdditionalAlertManagerConfigs() {
         return additionalAlertManagerConfigs;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("additionalAlertManagerConfigs")
     public void setAdditionalAlertManagerConfigs(SecretKeySelector additionalAlertManagerConfigs) {
         this.additionalAlertManagerConfigs = additionalAlertManagerConfigs;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("additionalAlertRelabelConfigs")
     public SecretKeySelector getAdditionalAlertRelabelConfigs() {
         return additionalAlertRelabelConfigs;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("additionalAlertRelabelConfigs")
     public void setAdditionalAlertRelabelConfigs(SecretKeySelector additionalAlertRelabelConfigs) {
         this.additionalAlertRelabelConfigs = additionalAlertRelabelConfigs;
     }
 
+    /**
+     * AdditionalArgs allows setting additional arguments for the 'prometheus' container.<br><p> <br><p> It is intended for e.g. activating hidden flags which are not supported by the dedicated configuration options yet. The arguments are passed as-is to the Prometheus container which may cause issues if they are invalid or not supported by the given Prometheus version.<br><p> <br><p> In case of an argument conflict (e.g. an argument which is already set by the operator itself) or when providing an invalid argument, the reconciliation will fail and an error will be logged.
+     */
     @JsonProperty("additionalArgs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Argument> getAdditionalArgs() {
         return additionalArgs;
     }
 
+    /**
+     * AdditionalArgs allows setting additional arguments for the 'prometheus' container.<br><p> <br><p> It is intended for e.g. activating hidden flags which are not supported by the dedicated configuration options yet. The arguments are passed as-is to the Prometheus container which may cause issues if they are invalid or not supported by the given Prometheus version.<br><p> <br><p> In case of an argument conflict (e.g. an argument which is already set by the operator itself) or when providing an invalid argument, the reconciliation will fail and an error will be logged.
+     */
     @JsonProperty("additionalArgs")
     public void setAdditionalArgs(List<Argument> additionalArgs) {
         this.additionalArgs = additionalArgs;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("additionalScrapeConfigs")
     public SecretKeySelector getAdditionalScrapeConfigs() {
         return additionalScrapeConfigs;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("additionalScrapeConfigs")
     public void setAdditionalScrapeConfigs(SecretKeySelector additionalScrapeConfigs) {
         this.additionalScrapeConfigs = additionalScrapeConfigs;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("affinity")
     public Affinity getAffinity() {
         return affinity;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("affinity")
     public void setAffinity(Affinity affinity) {
         this.affinity = affinity;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("alerting")
     public AlertingSpec getAlerting() {
         return alerting;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("alerting")
     public void setAlerting(AlertingSpec alerting) {
         this.alerting = alerting;
     }
 
+    /**
+     * AllowOverlappingBlocks enables vertical compaction and vertical query merge in Prometheus.<br><p> <br><p> Deprecated: this flag has no effect for Prometheus &gt;= 2.39.0 where overlapping blocks are enabled by default.
+     */
     @JsonProperty("allowOverlappingBlocks")
     public Boolean getAllowOverlappingBlocks() {
         return allowOverlappingBlocks;
     }
 
+    /**
+     * AllowOverlappingBlocks enables vertical compaction and vertical query merge in Prometheus.<br><p> <br><p> Deprecated: this flag has no effect for Prometheus &gt;= 2.39.0 where overlapping blocks are enabled by default.
+     */
     @JsonProperty("allowOverlappingBlocks")
     public void setAllowOverlappingBlocks(Boolean allowOverlappingBlocks) {
         this.allowOverlappingBlocks = allowOverlappingBlocks;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("apiserverConfig")
     public APIServerConfig getApiserverConfig() {
         return apiserverConfig;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("apiserverConfig")
     public void setApiserverConfig(APIServerConfig apiserverConfig) {
         this.apiserverConfig = apiserverConfig;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("arbitraryFSAccessThroughSMs")
     public ArbitraryFSAccessThroughSMsConfig getArbitraryFSAccessThroughSMs() {
         return arbitraryFSAccessThroughSMs;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("arbitraryFSAccessThroughSMs")
     public void setArbitraryFSAccessThroughSMs(ArbitraryFSAccessThroughSMsConfig arbitraryFSAccessThroughSMs) {
         this.arbitraryFSAccessThroughSMs = arbitraryFSAccessThroughSMs;
     }
 
+    /**
+     * AutomountServiceAccountToken indicates whether a service account token should be automatically mounted in the pod. If the field isn't set, the operator mounts the service account token by default.<br><p> <br><p> &#42;&#42;Warning:&#42;&#42; be aware that by default, Prometheus requires the service account token for Kubernetes service discovery. It is possible to use strategic merge patch to project the service account token into the 'prometheus' container.
+     */
     @JsonProperty("automountServiceAccountToken")
     public Boolean getAutomountServiceAccountToken() {
         return automountServiceAccountToken;
     }
 
+    /**
+     * AutomountServiceAccountToken indicates whether a service account token should be automatically mounted in the pod. If the field isn't set, the operator mounts the service account token by default.<br><p> <br><p> &#42;&#42;Warning:&#42;&#42; be aware that by default, Prometheus requires the service account token for Kubernetes service discovery. It is possible to use strategic merge patch to project the service account token into the 'prometheus' container.
+     */
     @JsonProperty("automountServiceAccountToken")
     public void setAutomountServiceAccountToken(Boolean automountServiceAccountToken) {
         this.automountServiceAccountToken = automountServiceAccountToken;
     }
 
+    /**
+     * Deprecated: use 'spec.image' instead.
+     */
     @JsonProperty("baseImage")
     public String getBaseImage() {
         return baseImage;
     }
 
+    /**
+     * Deprecated: use 'spec.image' instead.
+     */
     @JsonProperty("baseImage")
     public void setBaseImage(String baseImage) {
         this.baseImage = baseImage;
     }
 
+    /**
+     * BodySizeLimit defines per-scrape on response body size. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedBodySizeLimit.
+     */
     @JsonProperty("bodySizeLimit")
     public String getBodySizeLimit() {
         return bodySizeLimit;
     }
 
+    /**
+     * BodySizeLimit defines per-scrape on response body size. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedBodySizeLimit.
+     */
     @JsonProperty("bodySizeLimit")
     public void setBodySizeLimit(String bodySizeLimit) {
         this.bodySizeLimit = bodySizeLimit;
     }
 
+    /**
+     * ConfigMaps is a list of ConfigMaps in the same namespace as the Prometheus object, which shall be mounted into the Prometheus Pods. Each ConfigMap is added to the StatefulSet definition as a volume named `configmap-&lt;configmap-name&gt;`. The ConfigMaps are mounted into /etc/prometheus/configmaps/&lt;configmap-name&gt; in the 'prometheus' container.
+     */
     @JsonProperty("configMaps")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getConfigMaps() {
         return configMaps;
     }
 
+    /**
+     * ConfigMaps is a list of ConfigMaps in the same namespace as the Prometheus object, which shall be mounted into the Prometheus Pods. Each ConfigMap is added to the StatefulSet definition as a volume named `configmap-&lt;configmap-name&gt;`. The ConfigMaps are mounted into /etc/prometheus/configmaps/&lt;configmap-name&gt; in the 'prometheus' container.
+     */
     @JsonProperty("configMaps")
     public void setConfigMaps(List<String> configMaps) {
         this.configMaps = configMaps;
     }
 
+    /**
+     * Containers allows injecting additional containers or modifying operator generated containers. This can be used to allow adding an authentication proxy to the Pods or to change the behavior of an operator generated container. Containers described here modify an operator generated container if they share the same name and modifications are done via a strategic merge patch.<br><p> <br><p> The names of containers managed by the operator are: &#42; `prometheus` &#42; `config-reloader` &#42; `thanos-sidecar`<br><p> <br><p> Overriding containers is entirely outside the scope of what the maintainers will support and by doing so, you accept that this behaviour may break at any time without notice.
+     */
     @JsonProperty("containers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Container> getContainers() {
         return containers;
     }
 
+    /**
+     * Containers allows injecting additional containers or modifying operator generated containers. This can be used to allow adding an authentication proxy to the Pods or to change the behavior of an operator generated container. Containers described here modify an operator generated container if they share the same name and modifications are done via a strategic merge patch.<br><p> <br><p> The names of containers managed by the operator are: &#42; `prometheus` &#42; `config-reloader` &#42; `thanos-sidecar`<br><p> <br><p> Overriding containers is entirely outside the scope of what the maintainers will support and by doing so, you accept that this behaviour may break at any time without notice.
+     */
     @JsonProperty("containers")
     public void setContainers(List<Container> containers) {
         this.containers = containers;
     }
 
+    /**
+     * When true, the Prometheus compaction is disabled. When `spec.thanos.objectStorageConfig` or `spec.objectStorageConfigFile` are defined, the operator automatically disables block compaction to avoid race conditions during block uploads (as the Thanos documentation recommends).
+     */
     @JsonProperty("disableCompaction")
     public Boolean getDisableCompaction() {
         return disableCompaction;
     }
 
+    /**
+     * When true, the Prometheus compaction is disabled. When `spec.thanos.objectStorageConfig` or `spec.objectStorageConfigFile` are defined, the operator automatically disables block compaction to avoid race conditions during block uploads (as the Thanos documentation recommends).
+     */
     @JsonProperty("disableCompaction")
     public void setDisableCompaction(Boolean disableCompaction) {
         this.disableCompaction = disableCompaction;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("dnsConfig")
     public PodDNSConfig getDnsConfig() {
         return dnsConfig;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("dnsConfig")
     public void setDnsConfig(PodDNSConfig dnsConfig) {
         this.dnsConfig = dnsConfig;
     }
 
+    /**
+     * Defines the DNS policy for the pods.
+     */
     @JsonProperty("dnsPolicy")
     public String getDnsPolicy() {
         return dnsPolicy;
     }
 
+    /**
+     * Defines the DNS policy for the pods.
+     */
     @JsonProperty("dnsPolicy")
     public void setDnsPolicy(String dnsPolicy) {
         this.dnsPolicy = dnsPolicy;
     }
 
+    /**
+     * Enables access to the Prometheus web admin API.<br><p> <br><p> WARNING: Enabling the admin APIs enables mutating endpoints, to delete data, shutdown Prometheus, and more. Enabling this should be done with care and the user is advised to add additional authentication authorization via a proxy to ensure only clients authorized to perform these actions can do so.<br><p> <br><p> For more information: https://prometheus.io/docs/prometheus/latest/querying/api/#tsdb-admin-apis
+     */
     @JsonProperty("enableAdminAPI")
     public Boolean getEnableAdminAPI() {
         return enableAdminAPI;
     }
 
+    /**
+     * Enables access to the Prometheus web admin API.<br><p> <br><p> WARNING: Enabling the admin APIs enables mutating endpoints, to delete data, shutdown Prometheus, and more. Enabling this should be done with care and the user is advised to add additional authentication authorization via a proxy to ensure only clients authorized to perform these actions can do so.<br><p> <br><p> For more information: https://prometheus.io/docs/prometheus/latest/querying/api/#tsdb-admin-apis
+     */
     @JsonProperty("enableAdminAPI")
     public void setEnableAdminAPI(Boolean enableAdminAPI) {
         this.enableAdminAPI = enableAdminAPI;
     }
 
+    /**
+     * Enable access to Prometheus feature flags. By default, no features are enabled.<br><p> <br><p> Enabling features which are disabled by default is entirely outside the scope of what the maintainers will support and by doing so, you accept that this behaviour may break at any time without notice.<br><p> <br><p> For more information see https://prometheus.io/docs/prometheus/latest/feature_flags/
+     */
     @JsonProperty("enableFeatures")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEnableFeatures() {
         return enableFeatures;
     }
 
+    /**
+     * Enable access to Prometheus feature flags. By default, no features are enabled.<br><p> <br><p> Enabling features which are disabled by default is entirely outside the scope of what the maintainers will support and by doing so, you accept that this behaviour may break at any time without notice.<br><p> <br><p> For more information see https://prometheus.io/docs/prometheus/latest/feature_flags/
+     */
     @JsonProperty("enableFeatures")
     public void setEnableFeatures(List<String> enableFeatures) {
         this.enableFeatures = enableFeatures;
     }
 
+    /**
+     * Enable Prometheus to be used as a receiver for the OTLP Metrics protocol.<br><p> <br><p> Note that the OTLP receiver endpoint is automatically enabled if `.spec.otlpConfig` is defined.<br><p> <br><p> It requires Prometheus &gt;= v2.47.0.
+     */
     @JsonProperty("enableOTLPReceiver")
     public Boolean getEnableOTLPReceiver() {
         return enableOTLPReceiver;
     }
 
+    /**
+     * Enable Prometheus to be used as a receiver for the OTLP Metrics protocol.<br><p> <br><p> Note that the OTLP receiver endpoint is automatically enabled if `.spec.otlpConfig` is defined.<br><p> <br><p> It requires Prometheus &gt;= v2.47.0.
+     */
     @JsonProperty("enableOTLPReceiver")
     public void setEnableOTLPReceiver(Boolean enableOTLPReceiver) {
         this.enableOTLPReceiver = enableOTLPReceiver;
     }
 
+    /**
+     * Enable Prometheus to be used as a receiver for the Prometheus remote write protocol.<br><p> <br><p> WARNING: This is not considered an efficient way of ingesting samples. Use it with caution for specific low-volume use cases. It is not suitable for replacing the ingestion via scraping and turning Prometheus into a push-based metrics collection system. For more information see https://prometheus.io/docs/prometheus/latest/querying/api/#remote-write-receiver<br><p> <br><p> It requires Prometheus &gt;= v2.33.0.
+     */
     @JsonProperty("enableRemoteWriteReceiver")
     public Boolean getEnableRemoteWriteReceiver() {
         return enableRemoteWriteReceiver;
     }
 
+    /**
+     * Enable Prometheus to be used as a receiver for the Prometheus remote write protocol.<br><p> <br><p> WARNING: This is not considered an efficient way of ingesting samples. Use it with caution for specific low-volume use cases. It is not suitable for replacing the ingestion via scraping and turning Prometheus into a push-based metrics collection system. For more information see https://prometheus.io/docs/prometheus/latest/querying/api/#remote-write-receiver<br><p> <br><p> It requires Prometheus &gt;= v2.33.0.
+     */
     @JsonProperty("enableRemoteWriteReceiver")
     public void setEnableRemoteWriteReceiver(Boolean enableRemoteWriteReceiver) {
         this.enableRemoteWriteReceiver = enableRemoteWriteReceiver;
     }
 
+    /**
+     * When defined, enforcedBodySizeLimit specifies a global limit on the size of uncompressed response body that will be accepted by Prometheus. Targets responding with a body larger than this many bytes will cause the scrape to fail.<br><p> <br><p> It requires Prometheus &gt;= v2.28.0.<br><p> <br><p> When both `enforcedBodySizeLimit` and `bodySizeLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined bodySizeLimit value will inherit the global bodySizeLimit value (Prometheus &gt;= 2.45.0) or the enforcedBodySizeLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedBodySizeLimit` is greater than the `bodySizeLimit`, the `bodySizeLimit` will be set to `enforcedBodySizeLimit`.<br><p> &#42; Scrape objects with a bodySizeLimit value less than or equal to enforcedBodySizeLimit keep their specific value. &#42; Scrape objects with a bodySizeLimit value greater than enforcedBodySizeLimit are set to enforcedBodySizeLimit.
+     */
     @JsonProperty("enforcedBodySizeLimit")
     public String getEnforcedBodySizeLimit() {
         return enforcedBodySizeLimit;
     }
 
+    /**
+     * When defined, enforcedBodySizeLimit specifies a global limit on the size of uncompressed response body that will be accepted by Prometheus. Targets responding with a body larger than this many bytes will cause the scrape to fail.<br><p> <br><p> It requires Prometheus &gt;= v2.28.0.<br><p> <br><p> When both `enforcedBodySizeLimit` and `bodySizeLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined bodySizeLimit value will inherit the global bodySizeLimit value (Prometheus &gt;= 2.45.0) or the enforcedBodySizeLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedBodySizeLimit` is greater than the `bodySizeLimit`, the `bodySizeLimit` will be set to `enforcedBodySizeLimit`.<br><p> &#42; Scrape objects with a bodySizeLimit value less than or equal to enforcedBodySizeLimit keep their specific value. &#42; Scrape objects with a bodySizeLimit value greater than enforcedBodySizeLimit are set to enforcedBodySizeLimit.
+     */
     @JsonProperty("enforcedBodySizeLimit")
     public void setEnforcedBodySizeLimit(String enforcedBodySizeLimit) {
         this.enforcedBodySizeLimit = enforcedBodySizeLimit;
     }
 
+    /**
+     * When defined, enforcedKeepDroppedTargets specifies a global limit on the number of targets dropped by relabeling that will be kept in memory. The value overrides any `spec.keepDroppedTargets` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.keepDroppedTargets` is greater than zero and less than `spec.enforcedKeepDroppedTargets`.<br><p> <br><p> It requires Prometheus &gt;= v2.47.0.<br><p> <br><p> When both `enforcedKeepDroppedTargets` and `keepDroppedTargets` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined keepDroppedTargets value will inherit the global keepDroppedTargets value (Prometheus &gt;= 2.45.0) or the enforcedKeepDroppedTargets value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedKeepDroppedTargets` is greater than the `keepDroppedTargets`, the `keepDroppedTargets` will be set to `enforcedKeepDroppedTargets`.<br><p> &#42; Scrape objects with a keepDroppedTargets value less than or equal to enforcedKeepDroppedTargets keep their specific value. &#42; Scrape objects with a keepDroppedTargets value greater than enforcedKeepDroppedTargets are set to enforcedKeepDroppedTargets.
+     */
     @JsonProperty("enforcedKeepDroppedTargets")
     public Long getEnforcedKeepDroppedTargets() {
         return enforcedKeepDroppedTargets;
     }
 
+    /**
+     * When defined, enforcedKeepDroppedTargets specifies a global limit on the number of targets dropped by relabeling that will be kept in memory. The value overrides any `spec.keepDroppedTargets` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.keepDroppedTargets` is greater than zero and less than `spec.enforcedKeepDroppedTargets`.<br><p> <br><p> It requires Prometheus &gt;= v2.47.0.<br><p> <br><p> When both `enforcedKeepDroppedTargets` and `keepDroppedTargets` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined keepDroppedTargets value will inherit the global keepDroppedTargets value (Prometheus &gt;= 2.45.0) or the enforcedKeepDroppedTargets value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedKeepDroppedTargets` is greater than the `keepDroppedTargets`, the `keepDroppedTargets` will be set to `enforcedKeepDroppedTargets`.<br><p> &#42; Scrape objects with a keepDroppedTargets value less than or equal to enforcedKeepDroppedTargets keep their specific value. &#42; Scrape objects with a keepDroppedTargets value greater than enforcedKeepDroppedTargets are set to enforcedKeepDroppedTargets.
+     */
     @JsonProperty("enforcedKeepDroppedTargets")
     public void setEnforcedKeepDroppedTargets(Long enforcedKeepDroppedTargets) {
         this.enforcedKeepDroppedTargets = enforcedKeepDroppedTargets;
     }
 
+    /**
+     * When defined, enforcedLabelLimit specifies a global limit on the number of labels per sample. The value overrides any `spec.labelLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.labelLimit` is greater than zero and less than `spec.enforcedLabelLimit`.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.<br><p> <br><p> When both `enforcedLabelLimit` and `labelLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined labelLimit value will inherit the global labelLimit value (Prometheus &gt;= 2.45.0) or the enforcedLabelLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedLabelLimit` is greater than the `labelLimit`, the `labelLimit` will be set to `enforcedLabelLimit`.<br><p> &#42; Scrape objects with a labelLimit value less than or equal to enforcedLabelLimit keep their specific value. &#42; Scrape objects with a labelLimit value greater than enforcedLabelLimit are set to enforcedLabelLimit.
+     */
     @JsonProperty("enforcedLabelLimit")
     public Long getEnforcedLabelLimit() {
         return enforcedLabelLimit;
     }
 
+    /**
+     * When defined, enforcedLabelLimit specifies a global limit on the number of labels per sample. The value overrides any `spec.labelLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.labelLimit` is greater than zero and less than `spec.enforcedLabelLimit`.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.<br><p> <br><p> When both `enforcedLabelLimit` and `labelLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined labelLimit value will inherit the global labelLimit value (Prometheus &gt;= 2.45.0) or the enforcedLabelLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedLabelLimit` is greater than the `labelLimit`, the `labelLimit` will be set to `enforcedLabelLimit`.<br><p> &#42; Scrape objects with a labelLimit value less than or equal to enforcedLabelLimit keep their specific value. &#42; Scrape objects with a labelLimit value greater than enforcedLabelLimit are set to enforcedLabelLimit.
+     */
     @JsonProperty("enforcedLabelLimit")
     public void setEnforcedLabelLimit(Long enforcedLabelLimit) {
         this.enforcedLabelLimit = enforcedLabelLimit;
     }
 
+    /**
+     * When defined, enforcedLabelNameLengthLimit specifies a global limit on the length of labels name per sample. The value overrides any `spec.labelNameLengthLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.labelNameLengthLimit` is greater than zero and less than `spec.enforcedLabelNameLengthLimit`.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.<br><p> <br><p> When both `enforcedLabelNameLengthLimit` and `labelNameLengthLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined labelNameLengthLimit value will inherit the global labelNameLengthLimit value (Prometheus &gt;= 2.45.0) or the enforcedLabelNameLengthLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedLabelNameLengthLimit` is greater than the `labelNameLengthLimit`, the `labelNameLengthLimit` will be set to `enforcedLabelNameLengthLimit`.<br><p> &#42; Scrape objects with a labelNameLengthLimit value less than or equal to enforcedLabelNameLengthLimit keep their specific value. &#42; Scrape objects with a labelNameLengthLimit value greater than enforcedLabelNameLengthLimit are set to enforcedLabelNameLengthLimit.
+     */
     @JsonProperty("enforcedLabelNameLengthLimit")
     public Long getEnforcedLabelNameLengthLimit() {
         return enforcedLabelNameLengthLimit;
     }
 
+    /**
+     * When defined, enforcedLabelNameLengthLimit specifies a global limit on the length of labels name per sample. The value overrides any `spec.labelNameLengthLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.labelNameLengthLimit` is greater than zero and less than `spec.enforcedLabelNameLengthLimit`.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.<br><p> <br><p> When both `enforcedLabelNameLengthLimit` and `labelNameLengthLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined labelNameLengthLimit value will inherit the global labelNameLengthLimit value (Prometheus &gt;= 2.45.0) or the enforcedLabelNameLengthLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedLabelNameLengthLimit` is greater than the `labelNameLengthLimit`, the `labelNameLengthLimit` will be set to `enforcedLabelNameLengthLimit`.<br><p> &#42; Scrape objects with a labelNameLengthLimit value less than or equal to enforcedLabelNameLengthLimit keep their specific value. &#42; Scrape objects with a labelNameLengthLimit value greater than enforcedLabelNameLengthLimit are set to enforcedLabelNameLengthLimit.
+     */
     @JsonProperty("enforcedLabelNameLengthLimit")
     public void setEnforcedLabelNameLengthLimit(Long enforcedLabelNameLengthLimit) {
         this.enforcedLabelNameLengthLimit = enforcedLabelNameLengthLimit;
     }
 
+    /**
+     * When not null, enforcedLabelValueLengthLimit defines a global limit on the length of labels value per sample. The value overrides any `spec.labelValueLengthLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.labelValueLengthLimit` is greater than zero and less than `spec.enforcedLabelValueLengthLimit`.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.<br><p> <br><p> When both `enforcedLabelValueLengthLimit` and `labelValueLengthLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined labelValueLengthLimit value will inherit the global labelValueLengthLimit value (Prometheus &gt;= 2.45.0) or the enforcedLabelValueLengthLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedLabelValueLengthLimit` is greater than the `labelValueLengthLimit`, the `labelValueLengthLimit` will be set to `enforcedLabelValueLengthLimit`.<br><p> &#42; Scrape objects with a labelValueLengthLimit value less than or equal to enforcedLabelValueLengthLimit keep their specific value. &#42; Scrape objects with a labelValueLengthLimit value greater than enforcedLabelValueLengthLimit are set to enforcedLabelValueLengthLimit.
+     */
     @JsonProperty("enforcedLabelValueLengthLimit")
     public Long getEnforcedLabelValueLengthLimit() {
         return enforcedLabelValueLengthLimit;
     }
 
+    /**
+     * When not null, enforcedLabelValueLengthLimit defines a global limit on the length of labels value per sample. The value overrides any `spec.labelValueLengthLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.labelValueLengthLimit` is greater than zero and less than `spec.enforcedLabelValueLengthLimit`.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.<br><p> <br><p> When both `enforcedLabelValueLengthLimit` and `labelValueLengthLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined labelValueLengthLimit value will inherit the global labelValueLengthLimit value (Prometheus &gt;= 2.45.0) or the enforcedLabelValueLengthLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedLabelValueLengthLimit` is greater than the `labelValueLengthLimit`, the `labelValueLengthLimit` will be set to `enforcedLabelValueLengthLimit`.<br><p> &#42; Scrape objects with a labelValueLengthLimit value less than or equal to enforcedLabelValueLengthLimit keep their specific value. &#42; Scrape objects with a labelValueLengthLimit value greater than enforcedLabelValueLengthLimit are set to enforcedLabelValueLengthLimit.
+     */
     @JsonProperty("enforcedLabelValueLengthLimit")
     public void setEnforcedLabelValueLengthLimit(Long enforcedLabelValueLengthLimit) {
         this.enforcedLabelValueLengthLimit = enforcedLabelValueLengthLimit;
     }
 
+    /**
+     * When not empty, a label will be added to:<br><p> <br><p> 1. All metrics scraped from `ServiceMonitor`, `PodMonitor`, `Probe` and `ScrapeConfig` objects. 2. All metrics generated from recording rules defined in `PrometheusRule` objects. 3. All alerts generated from alerting rules defined in `PrometheusRule` objects. 4. All vector selectors of PromQL expressions defined in `PrometheusRule` objects.<br><p> <br><p> The label will not added for objects referenced in `spec.excludedFromEnforcement`.<br><p> <br><p> The label's name is this field's value. The label's value is the namespace of the `ServiceMonitor`, `PodMonitor`, `Probe`, `PrometheusRule` or `ScrapeConfig` object.
+     */
     @JsonProperty("enforcedNamespaceLabel")
     public String getEnforcedNamespaceLabel() {
         return enforcedNamespaceLabel;
     }
 
+    /**
+     * When not empty, a label will be added to:<br><p> <br><p> 1. All metrics scraped from `ServiceMonitor`, `PodMonitor`, `Probe` and `ScrapeConfig` objects. 2. All metrics generated from recording rules defined in `PrometheusRule` objects. 3. All alerts generated from alerting rules defined in `PrometheusRule` objects. 4. All vector selectors of PromQL expressions defined in `PrometheusRule` objects.<br><p> <br><p> The label will not added for objects referenced in `spec.excludedFromEnforcement`.<br><p> <br><p> The label's name is this field's value. The label's value is the namespace of the `ServiceMonitor`, `PodMonitor`, `Probe`, `PrometheusRule` or `ScrapeConfig` object.
+     */
     @JsonProperty("enforcedNamespaceLabel")
     public void setEnforcedNamespaceLabel(String enforcedNamespaceLabel) {
         this.enforcedNamespaceLabel = enforcedNamespaceLabel;
     }
 
+    /**
+     * When defined, enforcedSampleLimit specifies a global limit on the number of scraped samples that will be accepted. This overrides any `spec.sampleLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.sampleLimit` is greater than zero and less than `spec.enforcedSampleLimit`.<br><p> <br><p> It is meant to be used by admins to keep the overall number of samples/series under a desired limit.<br><p> <br><p> When both `enforcedSampleLimit` and `sampleLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined sampleLimit value will inherit the global sampleLimit value (Prometheus &gt;= 2.45.0) or the enforcedSampleLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedSampleLimit` is greater than the `sampleLimit`, the `sampleLimit` will be set to `enforcedSampleLimit`.<br><p> &#42; Scrape objects with a sampleLimit value less than or equal to enforcedSampleLimit keep their specific value. &#42; Scrape objects with a sampleLimit value greater than enforcedSampleLimit are set to enforcedSampleLimit.
+     */
     @JsonProperty("enforcedSampleLimit")
     public Long getEnforcedSampleLimit() {
         return enforcedSampleLimit;
     }
 
+    /**
+     * When defined, enforcedSampleLimit specifies a global limit on the number of scraped samples that will be accepted. This overrides any `spec.sampleLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.sampleLimit` is greater than zero and less than `spec.enforcedSampleLimit`.<br><p> <br><p> It is meant to be used by admins to keep the overall number of samples/series under a desired limit.<br><p> <br><p> When both `enforcedSampleLimit` and `sampleLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined sampleLimit value will inherit the global sampleLimit value (Prometheus &gt;= 2.45.0) or the enforcedSampleLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedSampleLimit` is greater than the `sampleLimit`, the `sampleLimit` will be set to `enforcedSampleLimit`.<br><p> &#42; Scrape objects with a sampleLimit value less than or equal to enforcedSampleLimit keep their specific value. &#42; Scrape objects with a sampleLimit value greater than enforcedSampleLimit are set to enforcedSampleLimit.
+     */
     @JsonProperty("enforcedSampleLimit")
     public void setEnforcedSampleLimit(Long enforcedSampleLimit) {
         this.enforcedSampleLimit = enforcedSampleLimit;
     }
 
+    /**
+     * When defined, enforcedTargetLimit specifies a global limit on the number of scraped targets. The value overrides any `spec.targetLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.targetLimit` is greater than zero and less than `spec.enforcedTargetLimit`.<br><p> <br><p> It is meant to be used by admins to to keep the overall number of targets under a desired limit.<br><p> <br><p> When both `enforcedTargetLimit` and `targetLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined targetLimit value will inherit the global targetLimit value (Prometheus &gt;= 2.45.0) or the enforcedTargetLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedTargetLimit` is greater than the `targetLimit`, the `targetLimit` will be set to `enforcedTargetLimit`.<br><p> &#42; Scrape objects with a targetLimit value less than or equal to enforcedTargetLimit keep their specific value. &#42; Scrape objects with a targetLimit value greater than enforcedTargetLimit are set to enforcedTargetLimit.
+     */
     @JsonProperty("enforcedTargetLimit")
     public Long getEnforcedTargetLimit() {
         return enforcedTargetLimit;
     }
 
+    /**
+     * When defined, enforcedTargetLimit specifies a global limit on the number of scraped targets. The value overrides any `spec.targetLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.targetLimit` is greater than zero and less than `spec.enforcedTargetLimit`.<br><p> <br><p> It is meant to be used by admins to to keep the overall number of targets under a desired limit.<br><p> <br><p> When both `enforcedTargetLimit` and `targetLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined targetLimit value will inherit the global targetLimit value (Prometheus &gt;= 2.45.0) or the enforcedTargetLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedTargetLimit` is greater than the `targetLimit`, the `targetLimit` will be set to `enforcedTargetLimit`.<br><p> &#42; Scrape objects with a targetLimit value less than or equal to enforcedTargetLimit keep their specific value. &#42; Scrape objects with a targetLimit value greater than enforcedTargetLimit are set to enforcedTargetLimit.
+     */
     @JsonProperty("enforcedTargetLimit")
     public void setEnforcedTargetLimit(Long enforcedTargetLimit) {
         this.enforcedTargetLimit = enforcedTargetLimit;
     }
 
+    /**
+     * Interval between rule evaluations. Default: "30s"
+     */
     @JsonProperty("evaluationInterval")
     public String getEvaluationInterval() {
         return evaluationInterval;
     }
 
+    /**
+     * Interval between rule evaluations. Default: "30s"
+     */
     @JsonProperty("evaluationInterval")
     public void setEvaluationInterval(String evaluationInterval) {
         this.evaluationInterval = evaluationInterval;
     }
 
+    /**
+     * List of references to PodMonitor, ServiceMonitor, Probe and PrometheusRule objects to be excluded from enforcing a namespace label of origin.<br><p> <br><p> It is only applicable if `spec.enforcedNamespaceLabel` set to true.
+     */
     @JsonProperty("excludedFromEnforcement")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ObjectReference> getExcludedFromEnforcement() {
         return excludedFromEnforcement;
     }
 
+    /**
+     * List of references to PodMonitor, ServiceMonitor, Probe and PrometheusRule objects to be excluded from enforcing a namespace label of origin.<br><p> <br><p> It is only applicable if `spec.enforcedNamespaceLabel` set to true.
+     */
     @JsonProperty("excludedFromEnforcement")
     public void setExcludedFromEnforcement(List<ObjectReference> excludedFromEnforcement) {
         this.excludedFromEnforcement = excludedFromEnforcement;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("exemplars")
     public Exemplars getExemplars() {
         return exemplars;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("exemplars")
     public void setExemplars(Exemplars exemplars) {
         this.exemplars = exemplars;
     }
 
+    /**
+     * The labels to add to any time series or alerts when communicating with external systems (federation, remote storage, Alertmanager). Labels defined by `spec.replicaExternalLabelName` and `spec.prometheusExternalLabelName` take precedence over this list.
+     */
     @JsonProperty("externalLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getExternalLabels() {
         return externalLabels;
     }
 
+    /**
+     * The labels to add to any time series or alerts when communicating with external systems (federation, remote storage, Alertmanager). Labels defined by `spec.replicaExternalLabelName` and `spec.prometheusExternalLabelName` take precedence over this list.
+     */
     @JsonProperty("externalLabels")
     public void setExternalLabels(Map<String, String> externalLabels) {
         this.externalLabels = externalLabels;
     }
 
+    /**
+     * The external URL under which the Prometheus service is externally available. This is necessary to generate correct URLs (for instance if Prometheus is accessible behind an Ingress resource).
+     */
     @JsonProperty("externalUrl")
     public String getExternalUrl() {
         return externalUrl;
     }
 
+    /**
+     * The external URL under which the Prometheus service is externally available. This is necessary to generate correct URLs (for instance if Prometheus is accessible behind an Ingress resource).
+     */
     @JsonProperty("externalUrl")
     public void setExternalUrl(String externalUrl) {
         this.externalUrl = externalUrl;
     }
 
+    /**
+     * Optional list of hosts and IPs that will be injected into the Pod's hosts file if specified.
+     */
     @JsonProperty("hostAliases")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HostAlias> getHostAliases() {
         return hostAliases;
     }
 
+    /**
+     * Optional list of hosts and IPs that will be injected into the Pod's hosts file if specified.
+     */
     @JsonProperty("hostAliases")
     public void setHostAliases(List<HostAlias> hostAliases) {
         this.hostAliases = hostAliases;
     }
 
+    /**
+     * Use the host's network namespace if true.<br><p> <br><p> Make sure to understand the security implications if you want to enable it (https://kubernetes.io/docs/concepts/configuration/overview/).<br><p> <br><p> When hostNetwork is enabled, this will set the DNS policy to `ClusterFirstWithHostNet` automatically (unless `.spec.DNSPolicy` is set to a different value).
+     */
     @JsonProperty("hostNetwork")
     public Boolean getHostNetwork() {
         return hostNetwork;
     }
 
+    /**
+     * Use the host's network namespace if true.<br><p> <br><p> Make sure to understand the security implications if you want to enable it (https://kubernetes.io/docs/concepts/configuration/overview/).<br><p> <br><p> When hostNetwork is enabled, this will set the DNS policy to `ClusterFirstWithHostNet` automatically (unless `.spec.DNSPolicy` is set to a different value).
+     */
     @JsonProperty("hostNetwork")
     public void setHostNetwork(Boolean hostNetwork) {
         this.hostNetwork = hostNetwork;
     }
 
+    /**
+     * When true, `spec.namespaceSelector` from all PodMonitor, ServiceMonitor and Probe objects will be ignored. They will only discover targets within the namespace of the PodMonitor, ServiceMonitor and Probe object.
+     */
     @JsonProperty("ignoreNamespaceSelectors")
     public Boolean getIgnoreNamespaceSelectors() {
         return ignoreNamespaceSelectors;
     }
 
+    /**
+     * When true, `spec.namespaceSelector` from all PodMonitor, ServiceMonitor and Probe objects will be ignored. They will only discover targets within the namespace of the PodMonitor, ServiceMonitor and Probe object.
+     */
     @JsonProperty("ignoreNamespaceSelectors")
     public void setIgnoreNamespaceSelectors(Boolean ignoreNamespaceSelectors) {
         this.ignoreNamespaceSelectors = ignoreNamespaceSelectors;
     }
 
+    /**
+     * Container image name for Prometheus. If specified, it takes precedence over the `spec.baseImage`, `spec.tag` and `spec.sha` fields.<br><p> <br><p> Specifying `spec.version` is still necessary to ensure the Prometheus Operator knows which version of Prometheus is being configured.<br><p> <br><p> If neither `spec.image` nor `spec.baseImage` are defined, the operator will use the latest upstream version of Prometheus available at the time when the operator was released.
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * Container image name for Prometheus. If specified, it takes precedence over the `spec.baseImage`, `spec.tag` and `spec.sha` fields.<br><p> <br><p> Specifying `spec.version` is still necessary to ensure the Prometheus Operator knows which version of Prometheus is being configured.<br><p> <br><p> If neither `spec.image` nor `spec.baseImage` are defined, the operator will use the latest upstream version of Prometheus available at the time when the operator was released.
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
     }
 
+    /**
+     * Image pull policy for the 'prometheus', 'init-config-reloader' and 'config-reloader' containers. See https://kubernetes.io/docs/concepts/containers/images/#image-pull-policy for more details.<br><p> <br><p> Possible enum values:<br><p>  - `"Always"` means that kubelet always attempts to pull the latest image. Container will fail If the pull fails.<br><p>  - `"IfNotPresent"` means that kubelet pulls if the image isn't present on disk. Container will fail if the image isn't present and the pull fails.<br><p>  - `"Never"` means that kubelet never pulls an image, but only uses a local image. Container will fail if the image isn't present
+     */
     @JsonProperty("imagePullPolicy")
     public String getImagePullPolicy() {
         return imagePullPolicy;
     }
 
+    /**
+     * Image pull policy for the 'prometheus', 'init-config-reloader' and 'config-reloader' containers. See https://kubernetes.io/docs/concepts/containers/images/#image-pull-policy for more details.<br><p> <br><p> Possible enum values:<br><p>  - `"Always"` means that kubelet always attempts to pull the latest image. Container will fail If the pull fails.<br><p>  - `"IfNotPresent"` means that kubelet pulls if the image isn't present on disk. Container will fail if the image isn't present and the pull fails.<br><p>  - `"Never"` means that kubelet never pulls an image, but only uses a local image. Container will fail if the image isn't present
+     */
     @JsonProperty("imagePullPolicy")
     public void setImagePullPolicy(String imagePullPolicy) {
         this.imagePullPolicy = imagePullPolicy;
     }
 
+    /**
+     * An optional list of references to Secrets in the same namespace to use for pulling images from registries. See http://kubernetes.io/docs/user-guide/images#specifying-imagepullsecrets-on-a-pod
+     */
     @JsonProperty("imagePullSecrets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LocalObjectReference> getImagePullSecrets() {
         return imagePullSecrets;
     }
 
+    /**
+     * An optional list of references to Secrets in the same namespace to use for pulling images from registries. See http://kubernetes.io/docs/user-guide/images#specifying-imagepullsecrets-on-a-pod
+     */
     @JsonProperty("imagePullSecrets")
     public void setImagePullSecrets(List<LocalObjectReference> imagePullSecrets) {
         this.imagePullSecrets = imagePullSecrets;
     }
 
+    /**
+     * InitContainers allows injecting initContainers to the Pod definition. Those can be used to e.g.  fetch secrets for injection into the Prometheus configuration from external sources. Any errors during the execution of an initContainer will lead to a restart of the Pod. More info: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/ InitContainers described here modify an operator generated init containers if they share the same name and modifications are done via a strategic merge patch.<br><p> <br><p> The names of init container name managed by the operator are: &#42; `init-config-reloader`.<br><p> <br><p> Overriding init containers is entirely outside the scope of what the maintainers will support and by doing so, you accept that this behaviour may break at any time without notice.
+     */
     @JsonProperty("initContainers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Container> getInitContainers() {
         return initContainers;
     }
 
+    /**
+     * InitContainers allows injecting initContainers to the Pod definition. Those can be used to e.g.  fetch secrets for injection into the Prometheus configuration from external sources. Any errors during the execution of an initContainer will lead to a restart of the Pod. More info: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/ InitContainers described here modify an operator generated init containers if they share the same name and modifications are done via a strategic merge patch.<br><p> <br><p> The names of init container name managed by the operator are: &#42; `init-config-reloader`.<br><p> <br><p> Overriding init containers is entirely outside the scope of what the maintainers will support and by doing so, you accept that this behaviour may break at any time without notice.
+     */
     @JsonProperty("initContainers")
     public void setInitContainers(List<Container> initContainers) {
         this.initContainers = initContainers;
     }
 
+    /**
+     * Per-scrape limit on the number of targets dropped by relabeling that will be kept in memory. 0 means no limit.<br><p> <br><p> It requires Prometheus &gt;= v2.47.0.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedKeepDroppedTargets.
+     */
     @JsonProperty("keepDroppedTargets")
     public Long getKeepDroppedTargets() {
         return keepDroppedTargets;
     }
 
+    /**
+     * Per-scrape limit on the number of targets dropped by relabeling that will be kept in memory. 0 means no limit.<br><p> <br><p> It requires Prometheus &gt;= v2.47.0.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedKeepDroppedTargets.
+     */
     @JsonProperty("keepDroppedTargets")
     public void setKeepDroppedTargets(Long keepDroppedTargets) {
         this.keepDroppedTargets = keepDroppedTargets;
     }
 
+    /**
+     * Per-scrape limit on number of labels that will be accepted for a sample. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedLabelLimit.
+     */
     @JsonProperty("labelLimit")
     public Long getLabelLimit() {
         return labelLimit;
     }
 
+    /**
+     * Per-scrape limit on number of labels that will be accepted for a sample. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedLabelLimit.
+     */
     @JsonProperty("labelLimit")
     public void setLabelLimit(Long labelLimit) {
         this.labelLimit = labelLimit;
     }
 
+    /**
+     * Per-scrape limit on length of labels name that will be accepted for a sample. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedLabelNameLengthLimit.
+     */
     @JsonProperty("labelNameLengthLimit")
     public Long getLabelNameLengthLimit() {
         return labelNameLengthLimit;
     }
 
+    /**
+     * Per-scrape limit on length of labels name that will be accepted for a sample. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedLabelNameLengthLimit.
+     */
     @JsonProperty("labelNameLengthLimit")
     public void setLabelNameLengthLimit(Long labelNameLengthLimit) {
         this.labelNameLengthLimit = labelNameLengthLimit;
     }
 
+    /**
+     * Per-scrape limit on length of labels value that will be accepted for a sample. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedLabelValueLengthLimit.
+     */
     @JsonProperty("labelValueLengthLimit")
     public Long getLabelValueLengthLimit() {
         return labelValueLengthLimit;
     }
 
+    /**
+     * Per-scrape limit on length of labels value that will be accepted for a sample. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedLabelValueLengthLimit.
+     */
     @JsonProperty("labelValueLengthLimit")
     public void setLabelValueLengthLimit(Long labelValueLengthLimit) {
         this.labelValueLengthLimit = labelValueLengthLimit;
     }
 
+    /**
+     * When true, the Prometheus server listens on the loopback address instead of the Pod IP's address.
+     */
     @JsonProperty("listenLocal")
     public Boolean getListenLocal() {
         return listenLocal;
     }
 
+    /**
+     * When true, the Prometheus server listens on the loopback address instead of the Pod IP's address.
+     */
     @JsonProperty("listenLocal")
     public void setListenLocal(Boolean listenLocal) {
         this.listenLocal = listenLocal;
     }
 
+    /**
+     * Log format for Log level for Prometheus and the config-reloader sidecar.
+     */
     @JsonProperty("logFormat")
     public String getLogFormat() {
         return logFormat;
     }
 
+    /**
+     * Log format for Log level for Prometheus and the config-reloader sidecar.
+     */
     @JsonProperty("logFormat")
     public void setLogFormat(String logFormat) {
         this.logFormat = logFormat;
     }
 
+    /**
+     * Log level for Prometheus and the config-reloader sidecar.
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * Log level for Prometheus and the config-reloader sidecar.
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * Defines the maximum time that the `prometheus` container's startup probe will wait before being considered failed. The startup probe will return success after the WAL replay is complete. If set, the value should be greater than 60 (seconds). Otherwise it will be equal to 600 seconds (15 minutes).
+     */
     @JsonProperty("maximumStartupDurationSeconds")
     public Integer getMaximumStartupDurationSeconds() {
         return maximumStartupDurationSeconds;
     }
 
+    /**
+     * Defines the maximum time that the `prometheus` container's startup probe will wait before being considered failed. The startup probe will return success after the WAL replay is complete. If set, the value should be greater than 60 (seconds). Otherwise it will be equal to 600 seconds (15 minutes).
+     */
     @JsonProperty("maximumStartupDurationSeconds")
     public void setMaximumStartupDurationSeconds(Integer maximumStartupDurationSeconds) {
         this.maximumStartupDurationSeconds = maximumStartupDurationSeconds;
     }
 
+    /**
+     * Minimum number of seconds for which a newly created Pod should be ready without any of its container crashing for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready)<br><p> <br><p> This is an alpha field from kubernetes 1.22 until 1.24 which requires enabling the StatefulSetMinReadySeconds feature gate.
+     */
     @JsonProperty("minReadySeconds")
     public Long getMinReadySeconds() {
         return minReadySeconds;
     }
 
+    /**
+     * Minimum number of seconds for which a newly created Pod should be ready without any of its container crashing for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready)<br><p> <br><p> This is an alpha field from kubernetes 1.22 until 1.24 which requires enabling the StatefulSetMinReadySeconds feature gate.
+     */
     @JsonProperty("minReadySeconds")
     public void setMinReadySeconds(Long minReadySeconds) {
         this.minReadySeconds = minReadySeconds;
     }
 
+    /**
+     * Specifies the validation scheme for metric and label names.
+     */
     @JsonProperty("nameValidationScheme")
     public String getNameValidationScheme() {
         return nameValidationScheme;
     }
 
+    /**
+     * Specifies the validation scheme for metric and label names.
+     */
     @JsonProperty("nameValidationScheme")
     public void setNameValidationScheme(String nameValidationScheme) {
         this.nameValidationScheme = nameValidationScheme;
     }
 
+    /**
+     * Defines on which Nodes the Pods are scheduled.
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * Defines on which Nodes the Pods are scheduled.
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("otlp")
     public OTLPConfig getOtlp() {
         return otlp;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("otlp")
     public void setOtlp(OTLPConfig otlp) {
         this.otlp = otlp;
     }
 
+    /**
+     * When true, Prometheus resolves label conflicts by renaming the labels in the scraped data<br><p>  to "exported_" for all targets created from ServiceMonitor, PodMonitor and<br><p> ScrapeConfig objects. Otherwise the HonorLabels field of the service or pod monitor applies. In practice,`overrideHonorLaels:true` enforces `honorLabels:false` for all ServiceMonitor, PodMonitor and ScrapeConfig objects.
+     */
     @JsonProperty("overrideHonorLabels")
     public Boolean getOverrideHonorLabels() {
         return overrideHonorLabels;
     }
 
+    /**
+     * When true, Prometheus resolves label conflicts by renaming the labels in the scraped data<br><p>  to "exported_" for all targets created from ServiceMonitor, PodMonitor and<br><p> ScrapeConfig objects. Otherwise the HonorLabels field of the service or pod monitor applies. In practice,`overrideHonorLaels:true` enforces `honorLabels:false` for all ServiceMonitor, PodMonitor and ScrapeConfig objects.
+     */
     @JsonProperty("overrideHonorLabels")
     public void setOverrideHonorLabels(Boolean overrideHonorLabels) {
         this.overrideHonorLabels = overrideHonorLabels;
     }
 
+    /**
+     * When true, Prometheus ignores the timestamps for all the targets created from service and pod monitors. Otherwise the HonorTimestamps field of the service or pod monitor applies.
+     */
     @JsonProperty("overrideHonorTimestamps")
     public Boolean getOverrideHonorTimestamps() {
         return overrideHonorTimestamps;
     }
 
+    /**
+     * When true, Prometheus ignores the timestamps for all the targets created from service and pod monitors. Otherwise the HonorTimestamps field of the service or pod monitor applies.
+     */
     @JsonProperty("overrideHonorTimestamps")
     public void setOverrideHonorTimestamps(Boolean overrideHonorTimestamps) {
         this.overrideHonorTimestamps = overrideHonorTimestamps;
     }
 
+    /**
+     * When a Prometheus deployment is paused, no actions except for deletion will be performed on the underlying objects.
+     */
     @JsonProperty("paused")
     public Boolean getPaused() {
         return paused;
     }
 
+    /**
+     * When a Prometheus deployment is paused, no actions except for deletion will be performed on the underlying objects.
+     */
     @JsonProperty("paused")
     public void setPaused(Boolean paused) {
         this.paused = paused;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("persistentVolumeClaimRetentionPolicy")
     public StatefulSetPersistentVolumeClaimRetentionPolicy getPersistentVolumeClaimRetentionPolicy() {
         return persistentVolumeClaimRetentionPolicy;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("persistentVolumeClaimRetentionPolicy")
     public void setPersistentVolumeClaimRetentionPolicy(StatefulSetPersistentVolumeClaimRetentionPolicy persistentVolumeClaimRetentionPolicy) {
         this.persistentVolumeClaimRetentionPolicy = persistentVolumeClaimRetentionPolicy;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("podMetadata")
     public EmbeddedObjectMetadata getPodMetadata() {
         return podMetadata;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("podMetadata")
     public void setPodMetadata(EmbeddedObjectMetadata podMetadata) {
         this.podMetadata = podMetadata;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("podMonitorNamespaceSelector")
     public LabelSelector getPodMonitorNamespaceSelector() {
         return podMonitorNamespaceSelector;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("podMonitorNamespaceSelector")
     public void setPodMonitorNamespaceSelector(LabelSelector podMonitorNamespaceSelector) {
         this.podMonitorNamespaceSelector = podMonitorNamespaceSelector;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("podMonitorSelector")
     public LabelSelector getPodMonitorSelector() {
         return podMonitorSelector;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("podMonitorSelector")
     public void setPodMonitorSelector(LabelSelector podMonitorSelector) {
         this.podMonitorSelector = podMonitorSelector;
     }
 
+    /**
+     * PodTargetLabels are appended to the `spec.podTargetLabels` field of all PodMonitor and ServiceMonitor objects.
+     */
     @JsonProperty("podTargetLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPodTargetLabels() {
         return podTargetLabels;
     }
 
+    /**
+     * PodTargetLabels are appended to the `spec.podTargetLabels` field of all PodMonitor and ServiceMonitor objects.
+     */
     @JsonProperty("podTargetLabels")
     public void setPodTargetLabels(List<String> podTargetLabels) {
         this.podTargetLabels = podTargetLabels;
     }
 
+    /**
+     * Port name used for the pods and governing service. Default: "web"
+     */
     @JsonProperty("portName")
     public String getPortName() {
         return portName;
     }
 
+    /**
+     * Port name used for the pods and governing service. Default: "web"
+     */
     @JsonProperty("portName")
     public void setPortName(String portName) {
         this.portName = portName;
     }
 
+    /**
+     * Priority class assigned to the Pods.
+     */
     @JsonProperty("priorityClassName")
     public String getPriorityClassName() {
         return priorityClassName;
     }
 
+    /**
+     * Priority class assigned to the Pods.
+     */
     @JsonProperty("priorityClassName")
     public void setPriorityClassName(String priorityClassName) {
         this.priorityClassName = priorityClassName;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("probeNamespaceSelector")
     public LabelSelector getProbeNamespaceSelector() {
         return probeNamespaceSelector;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("probeNamespaceSelector")
     public void setProbeNamespaceSelector(LabelSelector probeNamespaceSelector) {
         this.probeNamespaceSelector = probeNamespaceSelector;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("probeSelector")
     public LabelSelector getProbeSelector() {
         return probeSelector;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("probeSelector")
     public void setProbeSelector(LabelSelector probeSelector) {
         this.probeSelector = probeSelector;
     }
 
+    /**
+     * Name of Prometheus external label used to denote the Prometheus instance name. The external label will _not_ be added when the field is set to the empty string (`""`).<br><p> <br><p> Default: "prometheus"
+     */
     @JsonProperty("prometheusExternalLabelName")
     public String getPrometheusExternalLabelName() {
         return prometheusExternalLabelName;
     }
 
+    /**
+     * Name of Prometheus external label used to denote the Prometheus instance name. The external label will _not_ be added when the field is set to the empty string (`""`).<br><p> <br><p> Default: "prometheus"
+     */
     @JsonProperty("prometheusExternalLabelName")
     public void setPrometheusExternalLabelName(String prometheusExternalLabelName) {
         this.prometheusExternalLabelName = prometheusExternalLabelName;
     }
 
+    /**
+     * Defines the list of PrometheusRule objects to which the namespace label enforcement doesn't apply. This is only relevant when `spec.enforcedNamespaceLabel` is set to true. Deprecated: use `spec.excludedFromEnforcement` instead.
+     */
     @JsonProperty("prometheusRulesExcludedFromEnforce")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PrometheusRuleExcludeConfig> getPrometheusRulesExcludedFromEnforce() {
         return prometheusRulesExcludedFromEnforce;
     }
 
+    /**
+     * Defines the list of PrometheusRule objects to which the namespace label enforcement doesn't apply. This is only relevant when `spec.enforcedNamespaceLabel` is set to true. Deprecated: use `spec.excludedFromEnforcement` instead.
+     */
     @JsonProperty("prometheusRulesExcludedFromEnforce")
     public void setPrometheusRulesExcludedFromEnforce(List<PrometheusRuleExcludeConfig> prometheusRulesExcludedFromEnforce) {
         this.prometheusRulesExcludedFromEnforce = prometheusRulesExcludedFromEnforce;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("query")
     public QuerySpec getQuery() {
         return query;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("query")
     public void setQuery(QuerySpec query) {
         this.query = query;
     }
 
+    /**
+     * queryLogFile specifies where the file to which PromQL queries are logged.<br><p> <br><p> If the filename has an empty path, e.g. 'query.log', The Prometheus Pods will mount the file into an emptyDir volume at `/var/log/prometheus`. If a full path is provided, e.g. '/var/log/prometheus/query.log', you must mount a volume in the specified directory and it must be writable. This is because the prometheus container runs with a read-only root filesystem for security reasons. Alternatively, the location can be set to a standard I/O stream, e.g. `/dev/stdout`, to log query information to the default Prometheus log stream.
+     */
     @JsonProperty("queryLogFile")
     public String getQueryLogFile() {
         return queryLogFile;
     }
 
+    /**
+     * queryLogFile specifies where the file to which PromQL queries are logged.<br><p> <br><p> If the filename has an empty path, e.g. 'query.log', The Prometheus Pods will mount the file into an emptyDir volume at `/var/log/prometheus`. If a full path is provided, e.g. '/var/log/prometheus/query.log', you must mount a volume in the specified directory and it must be writable. This is because the prometheus container runs with a read-only root filesystem for security reasons. Alternatively, the location can be set to a standard I/O stream, e.g. `/dev/stdout`, to log query information to the default Prometheus log stream.
+     */
     @JsonProperty("queryLogFile")
     public void setQueryLogFile(String queryLogFile) {
         this.queryLogFile = queryLogFile;
     }
 
+    /**
+     * Defines the strategy used to reload the Prometheus configuration. If not specified, the configuration is reloaded using the /-/reload HTTP endpoint.
+     */
     @JsonProperty("reloadStrategy")
     public String getReloadStrategy() {
         return reloadStrategy;
     }
 
+    /**
+     * Defines the strategy used to reload the Prometheus configuration. If not specified, the configuration is reloaded using the /-/reload HTTP endpoint.
+     */
     @JsonProperty("reloadStrategy")
     public void setReloadStrategy(String reloadStrategy) {
         this.reloadStrategy = reloadStrategy;
     }
 
+    /**
+     * Defines the list of remote read configurations.
+     */
     @JsonProperty("remoteRead")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RemoteReadSpec> getRemoteRead() {
         return remoteRead;
     }
 
+    /**
+     * Defines the list of remote read configurations.
+     */
     @JsonProperty("remoteRead")
     public void setRemoteRead(List<RemoteReadSpec> remoteRead) {
         this.remoteRead = remoteRead;
     }
 
+    /**
+     * Defines the list of remote write configurations.
+     */
     @JsonProperty("remoteWrite")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RemoteWriteSpec> getRemoteWrite() {
         return remoteWrite;
     }
 
+    /**
+     * Defines the list of remote write configurations.
+     */
     @JsonProperty("remoteWrite")
     public void setRemoteWrite(List<RemoteWriteSpec> remoteWrite) {
         this.remoteWrite = remoteWrite;
     }
 
+    /**
+     * List of the protobuf message versions to accept when receiving the remote writes.<br><p> <br><p> It requires Prometheus &gt;= v2.54.0.
+     */
     @JsonProperty("remoteWriteReceiverMessageVersions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getRemoteWriteReceiverMessageVersions() {
         return remoteWriteReceiverMessageVersions;
     }
 
+    /**
+     * List of the protobuf message versions to accept when receiving the remote writes.<br><p> <br><p> It requires Prometheus &gt;= v2.54.0.
+     */
     @JsonProperty("remoteWriteReceiverMessageVersions")
     public void setRemoteWriteReceiverMessageVersions(List<String> remoteWriteReceiverMessageVersions) {
         this.remoteWriteReceiverMessageVersions = remoteWriteReceiverMessageVersions;
     }
 
+    /**
+     * Name of Prometheus external label used to denote the replica name. The external label will _not_ be added when the field is set to the empty string (`""`).<br><p> <br><p> Default: "prometheus_replica"
+     */
     @JsonProperty("replicaExternalLabelName")
     public String getReplicaExternalLabelName() {
         return replicaExternalLabelName;
     }
 
+    /**
+     * Name of Prometheus external label used to denote the replica name. The external label will _not_ be added when the field is set to the empty string (`""`).<br><p> <br><p> Default: "prometheus_replica"
+     */
     @JsonProperty("replicaExternalLabelName")
     public void setReplicaExternalLabelName(String replicaExternalLabelName) {
         this.replicaExternalLabelName = replicaExternalLabelName;
     }
 
+    /**
+     * Number of replicas of each shard to deploy for a Prometheus deployment. `spec.replicas` multiplied by `spec.shards` is the total number of Pods created.<br><p> <br><p> Default: 1
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Number of replicas of each shard to deploy for a Prometheus deployment. `spec.replicas` multiplied by `spec.shards` is the total number of Pods created.<br><p> <br><p> Default: 1
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * How long to retain the Prometheus data.<br><p> <br><p> Default: "24h" if `spec.retention` and `spec.retentionSize` are empty.
+     */
     @JsonProperty("retention")
     public String getRetention() {
         return retention;
     }
 
+    /**
+     * How long to retain the Prometheus data.<br><p> <br><p> Default: "24h" if `spec.retention` and `spec.retentionSize` are empty.
+     */
     @JsonProperty("retention")
     public void setRetention(String retention) {
         this.retention = retention;
     }
 
+    /**
+     * Maximum number of bytes used by the Prometheus data.
+     */
     @JsonProperty("retentionSize")
     public String getRetentionSize() {
         return retentionSize;
     }
 
+    /**
+     * Maximum number of bytes used by the Prometheus data.
+     */
     @JsonProperty("retentionSize")
     public void setRetentionSize(String retentionSize) {
         this.retentionSize = retentionSize;
     }
 
+    /**
+     * The route prefix Prometheus registers HTTP handlers for.<br><p> <br><p> This is useful when using `spec.externalURL`, and a proxy is rewriting HTTP routes of a request, and the actual ExternalURL is still true, but the server serves requests under a different route prefix. For example for use with `kubectl proxy`.
+     */
     @JsonProperty("routePrefix")
     public String getRoutePrefix() {
         return routePrefix;
     }
 
+    /**
+     * The route prefix Prometheus registers HTTP handlers for.<br><p> <br><p> This is useful when using `spec.externalURL`, and a proxy is rewriting HTTP routes of a request, and the actual ExternalURL is still true, but the server serves requests under a different route prefix. For example for use with `kubectl proxy`.
+     */
     @JsonProperty("routePrefix")
     public void setRoutePrefix(String routePrefix) {
         this.routePrefix = routePrefix;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("ruleNamespaceSelector")
     public LabelSelector getRuleNamespaceSelector() {
         return ruleNamespaceSelector;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("ruleNamespaceSelector")
     public void setRuleNamespaceSelector(LabelSelector ruleNamespaceSelector) {
         this.ruleNamespaceSelector = ruleNamespaceSelector;
     }
 
+    /**
+     * Defines the offset the rule evaluation timestamp of this particular group by the specified duration into the past. It requires Prometheus &gt;= v2.53.0.
+     */
     @JsonProperty("ruleQueryOffset")
     public String getRuleQueryOffset() {
         return ruleQueryOffset;
     }
 
+    /**
+     * Defines the offset the rule evaluation timestamp of this particular group by the specified duration into the past. It requires Prometheus &gt;= v2.53.0.
+     */
     @JsonProperty("ruleQueryOffset")
     public void setRuleQueryOffset(String ruleQueryOffset) {
         this.ruleQueryOffset = ruleQueryOffset;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("ruleSelector")
     public LabelSelector getRuleSelector() {
         return ruleSelector;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("ruleSelector")
     public void setRuleSelector(LabelSelector ruleSelector) {
         this.ruleSelector = ruleSelector;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("rules")
     public Rules getRules() {
         return rules;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("rules")
     public void setRules(Rules rules) {
         this.rules = rules;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("runtime")
     public RuntimeConfig getRuntime() {
         return runtime;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("runtime")
     public void setRuntime(RuntimeConfig runtime) {
         this.runtime = runtime;
     }
 
+    /**
+     * SampleLimit defines per-scrape limit on number of scraped samples that will be accepted. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedSampleLimit.
+     */
     @JsonProperty("sampleLimit")
     public Long getSampleLimit() {
         return sampleLimit;
     }
 
+    /**
+     * SampleLimit defines per-scrape limit on number of scraped samples that will be accepted. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedSampleLimit.
+     */
     @JsonProperty("sampleLimit")
     public void setSampleLimit(Long sampleLimit) {
         this.sampleLimit = sampleLimit;
     }
 
+    /**
+     * List of scrape classes to expose to scraping objects such as PodMonitors, ServiceMonitors, Probes and ScrapeConfigs.<br><p> <br><p> This is an &#42;experimental feature&#42;, it may change in any upcoming release in a breaking way.
+     */
     @JsonProperty("scrapeClasses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ScrapeClass> getScrapeClasses() {
         return scrapeClasses;
     }
 
+    /**
+     * List of scrape classes to expose to scraping objects such as PodMonitors, ServiceMonitors, Probes and ScrapeConfigs.<br><p> <br><p> This is an &#42;experimental feature&#42;, it may change in any upcoming release in a breaking way.
+     */
     @JsonProperty("scrapeClasses")
     public void setScrapeClasses(List<ScrapeClass> scrapeClasses) {
         this.scrapeClasses = scrapeClasses;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("scrapeConfigNamespaceSelector")
     public LabelSelector getScrapeConfigNamespaceSelector() {
         return scrapeConfigNamespaceSelector;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("scrapeConfigNamespaceSelector")
     public void setScrapeConfigNamespaceSelector(LabelSelector scrapeConfigNamespaceSelector) {
         this.scrapeConfigNamespaceSelector = scrapeConfigNamespaceSelector;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("scrapeConfigSelector")
     public LabelSelector getScrapeConfigSelector() {
         return scrapeConfigSelector;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("scrapeConfigSelector")
     public void setScrapeConfigSelector(LabelSelector scrapeConfigSelector) {
         this.scrapeConfigSelector = scrapeConfigSelector;
     }
 
+    /**
+     * Interval between consecutive scrapes.<br><p> <br><p> Default: "30s"
+     */
     @JsonProperty("scrapeInterval")
     public String getScrapeInterval() {
         return scrapeInterval;
     }
 
+    /**
+     * Interval between consecutive scrapes.<br><p> <br><p> Default: "30s"
+     */
     @JsonProperty("scrapeInterval")
     public void setScrapeInterval(String scrapeInterval) {
         this.scrapeInterval = scrapeInterval;
     }
 
+    /**
+     * The protocols to negotiate during a scrape. It tells clients the protocols supported by Prometheus in order of preference (from most to least preferred).<br><p> <br><p> If unset, Prometheus uses its default value.<br><p> <br><p> It requires Prometheus &gt;= v2.49.0.<br><p> <br><p> `PrometheusText1.0.0` requires Prometheus &gt;= v3.0.0.
+     */
     @JsonProperty("scrapeProtocols")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getScrapeProtocols() {
         return scrapeProtocols;
     }
 
+    /**
+     * The protocols to negotiate during a scrape. It tells clients the protocols supported by Prometheus in order of preference (from most to least preferred).<br><p> <br><p> If unset, Prometheus uses its default value.<br><p> <br><p> It requires Prometheus &gt;= v2.49.0.<br><p> <br><p> `PrometheusText1.0.0` requires Prometheus &gt;= v3.0.0.
+     */
     @JsonProperty("scrapeProtocols")
     public void setScrapeProtocols(List<String> scrapeProtocols) {
         this.scrapeProtocols = scrapeProtocols;
     }
 
+    /**
+     * Number of seconds to wait until a scrape request times out.
+     */
     @JsonProperty("scrapeTimeout")
     public String getScrapeTimeout() {
         return scrapeTimeout;
     }
 
+    /**
+     * Number of seconds to wait until a scrape request times out.
+     */
     @JsonProperty("scrapeTimeout")
     public void setScrapeTimeout(String scrapeTimeout) {
         this.scrapeTimeout = scrapeTimeout;
     }
 
+    /**
+     * Secrets is a list of Secrets in the same namespace as the Prometheus object, which shall be mounted into the Prometheus Pods. Each Secret is added to the StatefulSet definition as a volume named `secret-&lt;secret-name&gt;`. The Secrets are mounted into /etc/prometheus/secrets/&lt;secret-name&gt; in the 'prometheus' container.
+     */
     @JsonProperty("secrets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSecrets() {
         return secrets;
     }
 
+    /**
+     * Secrets is a list of Secrets in the same namespace as the Prometheus object, which shall be mounted into the Prometheus Pods. Each Secret is added to the StatefulSet definition as a volume named `secret-&lt;secret-name&gt;`. The Secrets are mounted into /etc/prometheus/secrets/&lt;secret-name&gt; in the 'prometheus' container.
+     */
     @JsonProperty("secrets")
     public void setSecrets(List<String> secrets) {
         this.secrets = secrets;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("securityContext")
     public PodSecurityContext getSecurityContext() {
         return securityContext;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("securityContext")
     public void setSecurityContext(PodSecurityContext securityContext) {
         this.securityContext = securityContext;
     }
 
+    /**
+     * ServiceAccountName is the name of the ServiceAccount to use to run the Prometheus Pods.
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * ServiceAccountName is the name of the ServiceAccount to use to run the Prometheus Pods.
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * Defines the service discovery role used to discover targets from `ServiceMonitor` objects and Alertmanager endpoints.<br><p> <br><p> If set, the value should be either "Endpoints" or "EndpointSlice". If unset, the operator assumes the "Endpoints" role.
+     */
     @JsonProperty("serviceDiscoveryRole")
     public String getServiceDiscoveryRole() {
         return serviceDiscoveryRole;
     }
 
+    /**
+     * Defines the service discovery role used to discover targets from `ServiceMonitor` objects and Alertmanager endpoints.<br><p> <br><p> If set, the value should be either "Endpoints" or "EndpointSlice". If unset, the operator assumes the "Endpoints" role.
+     */
     @JsonProperty("serviceDiscoveryRole")
     public void setServiceDiscoveryRole(String serviceDiscoveryRole) {
         this.serviceDiscoveryRole = serviceDiscoveryRole;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("serviceMonitorNamespaceSelector")
     public LabelSelector getServiceMonitorNamespaceSelector() {
         return serviceMonitorNamespaceSelector;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("serviceMonitorNamespaceSelector")
     public void setServiceMonitorNamespaceSelector(LabelSelector serviceMonitorNamespaceSelector) {
         this.serviceMonitorNamespaceSelector = serviceMonitorNamespaceSelector;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("serviceMonitorSelector")
     public LabelSelector getServiceMonitorSelector() {
         return serviceMonitorSelector;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("serviceMonitorSelector")
     public void setServiceMonitorSelector(LabelSelector serviceMonitorSelector) {
         this.serviceMonitorSelector = serviceMonitorSelector;
     }
 
+    /**
+     * Deprecated: use 'spec.image' instead. The image's digest can be specified as part of the image name.
+     */
     @JsonProperty("sha")
     public String getSha() {
         return sha;
     }
 
+    /**
+     * Deprecated: use 'spec.image' instead. The image's digest can be specified as part of the image name.
+     */
     @JsonProperty("sha")
     public void setSha(String sha) {
         this.sha = sha;
     }
 
+    /**
+     * Number of shards to distribute scraped targets onto.<br><p> <br><p> `spec.replicas` multiplied by `spec.shards` is the total number of Pods being created.<br><p> <br><p> When not defined, the operator assumes only one shard.<br><p> <br><p> Note that scaling down shards will not reshard data onto the remaining instances, it must be manually moved. Increasing shards will not reshard data either but it will continue to be available from the same instances. To query globally, use Thanos sidecar and Thanos querier or remote write data to a central location. Alerting and recording rules<br><p> <br><p> By default, the sharding is performed on: &#42; The `__address__` target's metadata label for PodMonitor, ServiceMonitor and ScrapeConfig resources. &#42; The `__param_target__` label for Probe resources.<br><p> <br><p> Users can define their own sharding implementation by setting the `__tmp_hash` label during the target discovery with relabeling configuration (either in the monitoring resources or via scrape class).
+     */
     @JsonProperty("shards")
     public Integer getShards() {
         return shards;
     }
 
+    /**
+     * Number of shards to distribute scraped targets onto.<br><p> <br><p> `spec.replicas` multiplied by `spec.shards` is the total number of Pods being created.<br><p> <br><p> When not defined, the operator assumes only one shard.<br><p> <br><p> Note that scaling down shards will not reshard data onto the remaining instances, it must be manually moved. Increasing shards will not reshard data either but it will continue to be available from the same instances. To query globally, use Thanos sidecar and Thanos querier or remote write data to a central location. Alerting and recording rules<br><p> <br><p> By default, the sharding is performed on: &#42; The `__address__` target's metadata label for PodMonitor, ServiceMonitor and ScrapeConfig resources. &#42; The `__param_target__` label for Probe resources.<br><p> <br><p> Users can define their own sharding implementation by setting the `__tmp_hash` label during the target discovery with relabeling configuration (either in the monitoring resources or via scrape class).
+     */
     @JsonProperty("shards")
     public void setShards(Integer shards) {
         this.shards = shards;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("storage")
     public StorageSpec getStorage() {
         return storage;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("storage")
     public void setStorage(StorageSpec storage) {
         this.storage = storage;
     }
 
+    /**
+     * Deprecated: use 'spec.image' instead. The image's tag can be specified as part of the image name.
+     */
     @JsonProperty("tag")
     public String getTag() {
         return tag;
     }
 
+    /**
+     * Deprecated: use 'spec.image' instead. The image's tag can be specified as part of the image name.
+     */
     @JsonProperty("tag")
     public void setTag(String tag) {
         this.tag = tag;
     }
 
+    /**
+     * TargetLimit defines a limit on the number of scraped targets that will be accepted. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedTargetLimit.
+     */
     @JsonProperty("targetLimit")
     public Long getTargetLimit() {
         return targetLimit;
     }
 
+    /**
+     * TargetLimit defines a limit on the number of scraped targets that will be accepted. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedTargetLimit.
+     */
     @JsonProperty("targetLimit")
     public void setTargetLimit(Long targetLimit) {
         this.targetLimit = targetLimit;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("thanos")
     public ThanosSpec getThanos() {
         return thanos;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("thanos")
     public void setThanos(ThanosSpec thanos) {
         this.thanos = thanos;
     }
 
+    /**
+     * Defines the Pods' tolerations if specified.
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * Defines the Pods' tolerations if specified.
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
     }
 
+    /**
+     * Defines the pod's topology spread constraints if specified.
+     */
     @JsonProperty("topologySpreadConstraints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TopologySpreadConstraint> getTopologySpreadConstraints() {
         return topologySpreadConstraints;
     }
 
+    /**
+     * Defines the pod's topology spread constraints if specified.
+     */
     @JsonProperty("topologySpreadConstraints")
     public void setTopologySpreadConstraints(List<TopologySpreadConstraint> topologySpreadConstraints) {
         this.topologySpreadConstraints = topologySpreadConstraints;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("tracingConfig")
     public PrometheusTracingConfig getTracingConfig() {
         return tracingConfig;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("tracingConfig")
     public void setTracingConfig(PrometheusTracingConfig tracingConfig) {
         this.tracingConfig = tracingConfig;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("tsdb")
     public TSDBSpec getTsdb() {
         return tsdb;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("tsdb")
     public void setTsdb(TSDBSpec tsdb) {
         this.tsdb = tsdb;
     }
 
+    /**
+     * Version of Prometheus being deployed. The operator uses this information to generate the Prometheus StatefulSet + configuration files.<br><p> <br><p> If not specified, the operator assumes the latest upstream version of Prometheus available at the time when the version of the operator was released.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * Version of Prometheus being deployed. The operator uses this information to generate the Prometheus StatefulSet + configuration files.<br><p> <br><p> If not specified, the operator assumes the latest upstream version of Prometheus available at the time when the version of the operator was released.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
     }
 
+    /**
+     * VolumeMounts allows the configuration of additional VolumeMounts.<br><p> <br><p> VolumeMounts will be appended to other VolumeMounts in the 'prometheus' container, that are generated as a result of StorageSpec objects.
+     */
     @JsonProperty("volumeMounts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VolumeMount> getVolumeMounts() {
         return volumeMounts;
     }
 
+    /**
+     * VolumeMounts allows the configuration of additional VolumeMounts.<br><p> <br><p> VolumeMounts will be appended to other VolumeMounts in the 'prometheus' container, that are generated as a result of StorageSpec objects.
+     */
     @JsonProperty("volumeMounts")
     public void setVolumeMounts(List<VolumeMount> volumeMounts) {
         this.volumeMounts = volumeMounts;
     }
 
+    /**
+     * Volumes allows the configuration of additional volumes on the output StatefulSet definition. Volumes specified will be appended to other volumes that are generated as a result of StorageSpec objects.
+     */
     @JsonProperty("volumes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Volume> getVolumes() {
         return volumes;
     }
 
+    /**
+     * Volumes allows the configuration of additional volumes on the output StatefulSet definition. Volumes specified will be appended to other volumes that are generated as a result of StorageSpec objects.
+     */
     @JsonProperty("volumes")
     public void setVolumes(List<Volume> volumes) {
         this.volumes = volumes;
     }
 
+    /**
+     * Configures compression of the write-ahead log (WAL) using Snappy.<br><p> <br><p> WAL compression is enabled by default for Prometheus &gt;= 2.20.0<br><p> <br><p> Requires Prometheus v2.11.0 and above.
+     */
     @JsonProperty("walCompression")
     public Boolean getWalCompression() {
         return walCompression;
     }
 
+    /**
+     * Configures compression of the write-ahead log (WAL) using Snappy.<br><p> <br><p> WAL compression is enabled by default for Prometheus &gt;= 2.20.0<br><p> <br><p> Requires Prometheus v2.11.0 and above.
+     */
     @JsonProperty("walCompression")
     public void setWalCompression(Boolean walCompression) {
         this.walCompression = walCompression;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("web")
     public PrometheusWebSpec getWeb() {
         return web;
     }
 
+    /**
+     * PrometheusSpec is a specification of the desired behavior of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("web")
     public void setWeb(PrometheusWebSpec web) {
         this.web = web;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusStatus.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusStatus.java
index a4bd4486945..90a552f430d 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusStatus.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PrometheusStatus is the most recent observed status of the Prometheus cluster. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -114,93 +117,147 @@ public PrometheusStatus(Integer availableReplicas, List<Condition> conditions, B
         this.updatedReplicas = updatedReplicas;
     }
 
+    /**
+     * Total number of available pods (ready for at least minReadySeconds) targeted by this Prometheus deployment.
+     */
     @JsonProperty("availableReplicas")
     public Integer getAvailableReplicas() {
         return availableReplicas;
     }
 
+    /**
+     * Total number of available pods (ready for at least minReadySeconds) targeted by this Prometheus deployment.
+     */
     @JsonProperty("availableReplicas")
     public void setAvailableReplicas(Integer availableReplicas) {
         this.availableReplicas = availableReplicas;
     }
 
+    /**
+     * The current state of the Prometheus deployment.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * The current state of the Prometheus deployment.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Represents whether any actions on the underlying managed objects are being performed. Only delete actions will be performed.
+     */
     @JsonProperty("paused")
     public Boolean getPaused() {
         return paused;
     }
 
+    /**
+     * Represents whether any actions on the underlying managed objects are being performed. Only delete actions will be performed.
+     */
     @JsonProperty("paused")
     public void setPaused(Boolean paused) {
         this.paused = paused;
     }
 
+    /**
+     * Total number of non-terminated pods targeted by this Prometheus deployment (their labels match the selector).
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Total number of non-terminated pods targeted by this Prometheus deployment (their labels match the selector).
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * The selector used to match the pods targeted by this Prometheus resource.
+     */
     @JsonProperty("selector")
     public String getSelector() {
         return selector;
     }
 
+    /**
+     * The selector used to match the pods targeted by this Prometheus resource.
+     */
     @JsonProperty("selector")
     public void setSelector(String selector) {
         this.selector = selector;
     }
 
+    /**
+     * The list has one entry per shard. Each entry provides a summary of the shard status.
+     */
     @JsonProperty("shardStatuses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ShardStatus> getShardStatuses() {
         return shardStatuses;
     }
 
+    /**
+     * The list has one entry per shard. Each entry provides a summary of the shard status.
+     */
     @JsonProperty("shardStatuses")
     public void setShardStatuses(List<ShardStatus> shardStatuses) {
         this.shardStatuses = shardStatuses;
     }
 
+    /**
+     * Shards is the most recently observed number of shards.
+     */
     @JsonProperty("shards")
     public Integer getShards() {
         return shards;
     }
 
+    /**
+     * Shards is the most recently observed number of shards.
+     */
     @JsonProperty("shards")
     public void setShards(Integer shards) {
         this.shards = shards;
     }
 
+    /**
+     * Total number of unavailable pods targeted by this Prometheus deployment.
+     */
     @JsonProperty("unavailableReplicas")
     public Integer getUnavailableReplicas() {
         return unavailableReplicas;
     }
 
+    /**
+     * Total number of unavailable pods targeted by this Prometheus deployment.
+     */
     @JsonProperty("unavailableReplicas")
     public void setUnavailableReplicas(Integer unavailableReplicas) {
         this.unavailableReplicas = unavailableReplicas;
     }
 
+    /**
+     * Total number of non-terminated pods targeted by this Prometheus deployment that have the desired version spec.
+     */
     @JsonProperty("updatedReplicas")
     public Integer getUpdatedReplicas() {
         return updatedReplicas;
     }
 
+    /**
+     * Total number of non-terminated pods targeted by this Prometheus deployment that have the desired version spec.
+     */
     @JsonProperty("updatedReplicas")
     public void setUpdatedReplicas(Integer updatedReplicas) {
         this.updatedReplicas = updatedReplicas;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusTracingConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusTracingConfig.java
index 6895614a151..8778edb062d 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusTracingConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusTracingConfig.java
@@ -108,52 +108,82 @@ public PrometheusTracingConfig(String clientType, String compression, String end
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * Client used to export the traces. Supported values are `http` or `grpc`.
+     */
     @JsonProperty("clientType")
     public String getClientType() {
         return clientType;
     }
 
+    /**
+     * Client used to export the traces. Supported values are `http` or `grpc`.
+     */
     @JsonProperty("clientType")
     public void setClientType(String clientType) {
         this.clientType = clientType;
     }
 
+    /**
+     * Compression key for supported compression types. The only supported value is `gzip`.
+     */
     @JsonProperty("compression")
     public String getCompression() {
         return compression;
     }
 
+    /**
+     * Compression key for supported compression types. The only supported value is `gzip`.
+     */
     @JsonProperty("compression")
     public void setCompression(String compression) {
         this.compression = compression;
     }
 
+    /**
+     * Endpoint to send the traces to. Should be provided in format &lt;host&gt;:&lt;port&gt;.
+     */
     @JsonProperty("endpoint")
     public String getEndpoint() {
         return endpoint;
     }
 
+    /**
+     * Endpoint to send the traces to. Should be provided in format &lt;host&gt;:&lt;port&gt;.
+     */
     @JsonProperty("endpoint")
     public void setEndpoint(String endpoint) {
         this.endpoint = endpoint;
     }
 
+    /**
+     * Key-value pairs to be used as headers associated with gRPC or HTTP requests.
+     */
     @JsonProperty("headers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getHeaders() {
         return headers;
     }
 
+    /**
+     * Key-value pairs to be used as headers associated with gRPC or HTTP requests.
+     */
     @JsonProperty("headers")
     public void setHeaders(Map<String, String> headers) {
         this.headers = headers;
     }
 
+    /**
+     * If disabled, the client will use a secure connection.
+     */
     @JsonProperty("insecure")
     public Boolean getInsecure() {
         return insecure;
     }
 
+    /**
+     * If disabled, the client will use a secure connection.
+     */
     @JsonProperty("insecure")
     public void setInsecure(Boolean insecure) {
         this.insecure = insecure;
@@ -169,11 +199,17 @@ public void setSamplingFraction(Quantity samplingFraction) {
         this.samplingFraction = samplingFraction;
     }
 
+    /**
+     * Maximum time the exporter will wait for each batch export.
+     */
     @JsonProperty("timeout")
     public String getTimeout() {
         return timeout;
     }
 
+    /**
+     * Maximum time the exporter will wait for each batch export.
+     */
     @JsonProperty("timeout")
     public void setTimeout(String timeout) {
         this.timeout = timeout;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusWebSpec.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusWebSpec.java
index 53df592807b..5ce0129611f 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusWebSpec.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/PrometheusWebSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PrometheusWebSpec defines the configuration of the Prometheus web server.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public PrometheusWebSpec(WebHTTPConfig httpConfig, Integer maxConnections, Strin
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * PrometheusWebSpec defines the configuration of the Prometheus web server.
+     */
     @JsonProperty("httpConfig")
     public WebHTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * PrometheusWebSpec defines the configuration of the Prometheus web server.
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(WebHTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * Defines the maximum number of simultaneous connections A zero value means that Prometheus doesn't accept any incoming connection.
+     */
     @JsonProperty("maxConnections")
     public Integer getMaxConnections() {
         return maxConnections;
     }
 
+    /**
+     * Defines the maximum number of simultaneous connections A zero value means that Prometheus doesn't accept any incoming connection.
+     */
     @JsonProperty("maxConnections")
     public void setMaxConnections(Integer maxConnections) {
         this.maxConnections = maxConnections;
     }
 
+    /**
+     * The prometheus web page title.
+     */
     @JsonProperty("pageTitle")
     public String getPageTitle() {
         return pageTitle;
     }
 
+    /**
+     * The prometheus web page title.
+     */
     @JsonProperty("pageTitle")
     public void setPageTitle(String pageTitle) {
         this.pageTitle = pageTitle;
     }
 
+    /**
+     * PrometheusWebSpec defines the configuration of the Prometheus web server.
+     */
     @JsonProperty("tlsConfig")
     public WebTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * PrometheusWebSpec defines the configuration of the Prometheus web server.
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(WebTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProxyConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProxyConfig.java
index 2b6b0650574..c739d7a43d6 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProxyConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ProxyConfig.java
@@ -93,42 +93,66 @@ public ProxyConfig(String noProxy, Map<String, List<SecretKeySelector>> proxyCon
         this.proxyUrl = proxyUrl;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<SecretKeySelector>> getProxyConnectHeader() {
         return proxyConnectHeader;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     public void setProxyConnectHeader(Map<String, List<SecretKeySelector>> proxyConnectHeader) {
         this.proxyConnectHeader = proxyConnectHeader;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public Boolean getProxyFromEnvironment() {
         return proxyFromEnvironment;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public void setProxyFromEnvironment(Boolean proxyFromEnvironment) {
         this.proxyFromEnvironment = proxyFromEnvironment;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public String getProxyUrl() {
         return proxyUrl;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public void setProxyUrl(String proxyUrl) {
         this.proxyUrl = proxyUrl;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/QuerySpec.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/QuerySpec.java
index adbd3ca9440..ebfcfb6d221 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/QuerySpec.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/QuerySpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * QuerySpec defines the query command line flags when starting Prometheus.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public QuerySpec(String lookbackDelta, Integer maxConcurrency, Integer maxSample
         this.timeout = timeout;
     }
 
+    /**
+     * The delta difference allowed for retrieving metrics during expression evaluations.
+     */
     @JsonProperty("lookbackDelta")
     public String getLookbackDelta() {
         return lookbackDelta;
     }
 
+    /**
+     * The delta difference allowed for retrieving metrics during expression evaluations.
+     */
     @JsonProperty("lookbackDelta")
     public void setLookbackDelta(String lookbackDelta) {
         this.lookbackDelta = lookbackDelta;
     }
 
+    /**
+     * Number of concurrent queries that can be run at once.
+     */
     @JsonProperty("maxConcurrency")
     public Integer getMaxConcurrency() {
         return maxConcurrency;
     }
 
+    /**
+     * Number of concurrent queries that can be run at once.
+     */
     @JsonProperty("maxConcurrency")
     public void setMaxConcurrency(Integer maxConcurrency) {
         this.maxConcurrency = maxConcurrency;
     }
 
+    /**
+     * Maximum number of samples a single query can load into memory. Note that queries will fail if they would load more samples than this into memory, so this also limits the number of samples a query can return.
+     */
     @JsonProperty("maxSamples")
     public Integer getMaxSamples() {
         return maxSamples;
     }
 
+    /**
+     * Maximum number of samples a single query can load into memory. Note that queries will fail if they would load more samples than this into memory, so this also limits the number of samples a query can return.
+     */
     @JsonProperty("maxSamples")
     public void setMaxSamples(Integer maxSamples) {
         this.maxSamples = maxSamples;
     }
 
+    /**
+     * Maximum time a query may take before being aborted.
+     */
     @JsonProperty("timeout")
     public String getTimeout() {
         return timeout;
     }
 
+    /**
+     * Maximum time a query may take before being aborted.
+     */
     @JsonProperty("timeout")
     public void setTimeout(String timeout) {
         this.timeout = timeout;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/QueueConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/QueueConfig.java
index 39b3f534fe2..470d6420551 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/QueueConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/QueueConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * QueueConfig allows the tuning of remote write's queue_config parameters. This object is referenced in the RemoteWriteSpec object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -114,101 +117,161 @@ public QueueConfig(String batchSendDeadline, Integer capacity, String maxBackoff
         this.sampleAgeLimit = sampleAgeLimit;
     }
 
+    /**
+     * BatchSendDeadline is the maximum time a sample will wait in buffer.
+     */
     @JsonProperty("batchSendDeadline")
     public String getBatchSendDeadline() {
         return batchSendDeadline;
     }
 
+    /**
+     * BatchSendDeadline is the maximum time a sample will wait in buffer.
+     */
     @JsonProperty("batchSendDeadline")
     public void setBatchSendDeadline(String batchSendDeadline) {
         this.batchSendDeadline = batchSendDeadline;
     }
 
+    /**
+     * Capacity is the number of samples to buffer per shard before we start dropping them.
+     */
     @JsonProperty("capacity")
     public Integer getCapacity() {
         return capacity;
     }
 
+    /**
+     * Capacity is the number of samples to buffer per shard before we start dropping them.
+     */
     @JsonProperty("capacity")
     public void setCapacity(Integer capacity) {
         this.capacity = capacity;
     }
 
+    /**
+     * MaxBackoff is the maximum retry delay.
+     */
     @JsonProperty("maxBackoff")
     public String getMaxBackoff() {
         return maxBackoff;
     }
 
+    /**
+     * MaxBackoff is the maximum retry delay.
+     */
     @JsonProperty("maxBackoff")
     public void setMaxBackoff(String maxBackoff) {
         this.maxBackoff = maxBackoff;
     }
 
+    /**
+     * MaxRetries is the maximum number of times to retry a batch on recoverable errors.
+     */
     @JsonProperty("maxRetries")
     public Integer getMaxRetries() {
         return maxRetries;
     }
 
+    /**
+     * MaxRetries is the maximum number of times to retry a batch on recoverable errors.
+     */
     @JsonProperty("maxRetries")
     public void setMaxRetries(Integer maxRetries) {
         this.maxRetries = maxRetries;
     }
 
+    /**
+     * MaxSamplesPerSend is the maximum number of samples per send.
+     */
     @JsonProperty("maxSamplesPerSend")
     public Integer getMaxSamplesPerSend() {
         return maxSamplesPerSend;
     }
 
+    /**
+     * MaxSamplesPerSend is the maximum number of samples per send.
+     */
     @JsonProperty("maxSamplesPerSend")
     public void setMaxSamplesPerSend(Integer maxSamplesPerSend) {
         this.maxSamplesPerSend = maxSamplesPerSend;
     }
 
+    /**
+     * MaxShards is the maximum number of shards, i.e. amount of concurrency.
+     */
     @JsonProperty("maxShards")
     public Integer getMaxShards() {
         return maxShards;
     }
 
+    /**
+     * MaxShards is the maximum number of shards, i.e. amount of concurrency.
+     */
     @JsonProperty("maxShards")
     public void setMaxShards(Integer maxShards) {
         this.maxShards = maxShards;
     }
 
+    /**
+     * MinBackoff is the initial retry delay. Gets doubled for every retry.
+     */
     @JsonProperty("minBackoff")
     public String getMinBackoff() {
         return minBackoff;
     }
 
+    /**
+     * MinBackoff is the initial retry delay. Gets doubled for every retry.
+     */
     @JsonProperty("minBackoff")
     public void setMinBackoff(String minBackoff) {
         this.minBackoff = minBackoff;
     }
 
+    /**
+     * MinShards is the minimum number of shards, i.e. amount of concurrency.
+     */
     @JsonProperty("minShards")
     public Integer getMinShards() {
         return minShards;
     }
 
+    /**
+     * MinShards is the minimum number of shards, i.e. amount of concurrency.
+     */
     @JsonProperty("minShards")
     public void setMinShards(Integer minShards) {
         this.minShards = minShards;
     }
 
+    /**
+     * Retry upon receiving a 429 status code from the remote-write storage.<br><p> <br><p> This is an &#42;experimental feature&#42;, it may change in any upcoming release in a breaking way.
+     */
     @JsonProperty("retryOnRateLimit")
     public Boolean getRetryOnRateLimit() {
         return retryOnRateLimit;
     }
 
+    /**
+     * Retry upon receiving a 429 status code from the remote-write storage.<br><p> <br><p> This is an &#42;experimental feature&#42;, it may change in any upcoming release in a breaking way.
+     */
     @JsonProperty("retryOnRateLimit")
     public void setRetryOnRateLimit(Boolean retryOnRateLimit) {
         this.retryOnRateLimit = retryOnRateLimit;
     }
 
+    /**
+     * SampleAgeLimit drops samples older than the limit. It requires Prometheus &gt;= v2.50.0.
+     */
     @JsonProperty("sampleAgeLimit")
     public String getSampleAgeLimit() {
         return sampleAgeLimit;
     }
 
+    /**
+     * SampleAgeLimit drops samples older than the limit. It requires Prometheus &gt;= v2.50.0.
+     */
     @JsonProperty("sampleAgeLimit")
     public void setSampleAgeLimit(String sampleAgeLimit) {
         this.sampleAgeLimit = sampleAgeLimit;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/RelabelConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/RelabelConfig.java
index 026cd0ea840..5fd6ae3fbe7 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/RelabelConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/RelabelConfig.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RelabelConfig allows dynamic rewriting of label sets for alerts. See Prometheus documentation: - https://prometheus.io/docs/prometheus/latest/configuration/configuration/#alert_relabel_configs - https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -105,72 +108,114 @@ public RelabelConfig(String action, Long modulus, String regex, String replaceme
         this.targetLabel = targetLabel;
     }
 
+    /**
+     * action to perform based on regex matching. Must be one of: 'Replace', 'Keep', 'Drop', 'HashMod', 'LabelMap', 'LabelDrop', or 'LabelKeep'. Default is: 'Replace'
+     */
     @JsonProperty("action")
     public String getAction() {
         return action;
     }
 
+    /**
+     * action to perform based on regex matching. Must be one of: 'Replace', 'Keep', 'Drop', 'HashMod', 'LabelMap', 'LabelDrop', or 'LabelKeep'. Default is: 'Replace'
+     */
     @JsonProperty("action")
     public void setAction(String action) {
         this.action = action;
     }
 
+    /**
+     * modulus to take of the hash of the source label values.  This can be combined with the 'HashMod' action to set 'target_label' to the 'modulus' of a hash of the concatenated 'source_labels'. This is only valid if sourceLabels is not empty and action is not 'LabelKeep' or 'LabelDrop'.
+     */
     @JsonProperty("modulus")
     public Long getModulus() {
         return modulus;
     }
 
+    /**
+     * modulus to take of the hash of the source label values.  This can be combined with the 'HashMod' action to set 'target_label' to the 'modulus' of a hash of the concatenated 'source_labels'. This is only valid if sourceLabels is not empty and action is not 'LabelKeep' or 'LabelDrop'.
+     */
     @JsonProperty("modulus")
     public void setModulus(Long modulus) {
         this.modulus = modulus;
     }
 
+    /**
+     * regex against which the extracted value is matched. Default is: '(.&#42;)' regex is required for all actions except 'HashMod'
+     */
     @JsonProperty("regex")
     public String getRegex() {
         return regex;
     }
 
+    /**
+     * regex against which the extracted value is matched. Default is: '(.&#42;)' regex is required for all actions except 'HashMod'
+     */
     @JsonProperty("regex")
     public void setRegex(String regex) {
         this.regex = regex;
     }
 
+    /**
+     * replacement value against which a regex replace is performed if the regular expression matches. This is required if the action is 'Replace' or 'LabelMap' and forbidden for actions 'LabelKeep' and 'LabelDrop'. Regex capture groups are available. Default is: '$1'
+     */
     @JsonProperty("replacement")
     public String getReplacement() {
         return replacement;
     }
 
+    /**
+     * replacement value against which a regex replace is performed if the regular expression matches. This is required if the action is 'Replace' or 'LabelMap' and forbidden for actions 'LabelKeep' and 'LabelDrop'. Regex capture groups are available. Default is: '$1'
+     */
     @JsonProperty("replacement")
     public void setReplacement(String replacement) {
         this.replacement = replacement;
     }
 
+    /**
+     * separator placed between concatenated source label values. When omitted, Prometheus will use its default value of ';'.
+     */
     @JsonProperty("separator")
     public String getSeparator() {
         return separator;
     }
 
+    /**
+     * separator placed between concatenated source label values. When omitted, Prometheus will use its default value of ';'.
+     */
     @JsonProperty("separator")
     public void setSeparator(String separator) {
         this.separator = separator;
     }
 
+    /**
+     * sourceLabels select values from existing labels. Their content is concatenated using the configured separator and matched against the configured regular expression for the 'Replace', 'Keep', and 'Drop' actions. Not allowed for actions 'LabelKeep' and 'LabelDrop'.
+     */
     @JsonProperty("sourceLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSourceLabels() {
         return sourceLabels;
     }
 
+    /**
+     * sourceLabels select values from existing labels. Their content is concatenated using the configured separator and matched against the configured regular expression for the 'Replace', 'Keep', and 'Drop' actions. Not allowed for actions 'LabelKeep' and 'LabelDrop'.
+     */
     @JsonProperty("sourceLabels")
     public void setSourceLabels(List<String> sourceLabels) {
         this.sourceLabels = sourceLabels;
     }
 
+    /**
+     * targetLabel to which the resulting value is written in a 'Replace' action. It is required for 'Replace' and 'HashMod' actions and forbidden for actions 'LabelKeep' and 'LabelDrop'. Regex capture groups are available.
+     */
     @JsonProperty("targetLabel")
     public String getTargetLabel() {
         return targetLabel;
     }
 
+    /**
+     * targetLabel to which the resulting value is written in a 'Replace' action. It is required for 'Replace' and 'HashMod' actions and forbidden for actions 'LabelKeep' and 'LabelDrop'. Regex capture groups are available.
+     */
     @JsonProperty("targetLabel")
     public void setTargetLabel(String targetLabel) {
         this.targetLabel = targetLabel;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/RemoteReadSpec.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/RemoteReadSpec.java
index f1820eb4749..c56e3db3f6e 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/RemoteReadSpec.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/RemoteReadSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RemoteReadSpec defines the configuration for Prometheus to read back samples from a remote endpoint.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -151,184 +154,292 @@ public RemoteReadSpec(Authorization authorization, BasicAuth basicAuth, String b
         this.url = url;
     }
 
+    /**
+     * RemoteReadSpec defines the configuration for Prometheus to read back samples from a remote endpoint.
+     */
     @JsonProperty("authorization")
     public Authorization getAuthorization() {
         return authorization;
     }
 
+    /**
+     * RemoteReadSpec defines the configuration for Prometheus to read back samples from a remote endpoint.
+     */
     @JsonProperty("authorization")
     public void setAuthorization(Authorization authorization) {
         this.authorization = authorization;
     }
 
+    /**
+     * RemoteReadSpec defines the configuration for Prometheus to read back samples from a remote endpoint.
+     */
     @JsonProperty("basicAuth")
     public BasicAuth getBasicAuth() {
         return basicAuth;
     }
 
+    /**
+     * RemoteReadSpec defines the configuration for Prometheus to read back samples from a remote endpoint.
+     */
     @JsonProperty("basicAuth")
     public void setBasicAuth(BasicAuth basicAuth) {
         this.basicAuth = basicAuth;
     }
 
+    /**
+     * &#42;Warning: this field shouldn't be used because the token value appears in clear-text. Prefer using `authorization`.&#42;<br><p> <br><p> Deprecated: this will be removed in a future release.
+     */
     @JsonProperty("bearerToken")
     public String getBearerToken() {
         return bearerToken;
     }
 
+    /**
+     * &#42;Warning: this field shouldn't be used because the token value appears in clear-text. Prefer using `authorization`.&#42;<br><p> <br><p> Deprecated: this will be removed in a future release.
+     */
     @JsonProperty("bearerToken")
     public void setBearerToken(String bearerToken) {
         this.bearerToken = bearerToken;
     }
 
+    /**
+     * File from which to read the bearer token for the URL.<br><p> <br><p> Deprecated: this will be removed in a future release. Prefer using `authorization`.
+     */
     @JsonProperty("bearerTokenFile")
     public String getBearerTokenFile() {
         return bearerTokenFile;
     }
 
+    /**
+     * File from which to read the bearer token for the URL.<br><p> <br><p> Deprecated: this will be removed in a future release. Prefer using `authorization`.
+     */
     @JsonProperty("bearerTokenFile")
     public void setBearerTokenFile(String bearerTokenFile) {
         this.bearerTokenFile = bearerTokenFile;
     }
 
+    /**
+     * Whether to use the external labels as selectors for the remote read endpoint.<br><p> <br><p> It requires Prometheus &gt;= v2.34.0.
+     */
     @JsonProperty("filterExternalLabels")
     public Boolean getFilterExternalLabels() {
         return filterExternalLabels;
     }
 
+    /**
+     * Whether to use the external labels as selectors for the remote read endpoint.<br><p> <br><p> It requires Prometheus &gt;= v2.34.0.
+     */
     @JsonProperty("filterExternalLabels")
     public void setFilterExternalLabels(Boolean filterExternalLabels) {
         this.filterExternalLabels = filterExternalLabels;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects.<br><p> <br><p> It requires Prometheus &gt;= v2.26.0.
+     */
     @JsonProperty("followRedirects")
     public Boolean getFollowRedirects() {
         return followRedirects;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects.<br><p> <br><p> It requires Prometheus &gt;= v2.26.0.
+     */
     @JsonProperty("followRedirects")
     public void setFollowRedirects(Boolean followRedirects) {
         this.followRedirects = followRedirects;
     }
 
+    /**
+     * Custom HTTP headers to be sent along with each remote read request. Be aware that headers that are set by Prometheus itself can't be overwritten. Only valid in Prometheus versions 2.26.0 and newer.
+     */
     @JsonProperty("headers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getHeaders() {
         return headers;
     }
 
+    /**
+     * Custom HTTP headers to be sent along with each remote read request. Be aware that headers that are set by Prometheus itself can't be overwritten. Only valid in Prometheus versions 2.26.0 and newer.
+     */
     @JsonProperty("headers")
     public void setHeaders(Map<String, String> headers) {
         this.headers = headers;
     }
 
+    /**
+     * The name of the remote read queue, it must be unique if specified. The name is used in metrics and logging in order to differentiate read configurations.<br><p> <br><p> It requires Prometheus &gt;= v2.15.0.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The name of the remote read queue, it must be unique if specified. The name is used in metrics and logging in order to differentiate read configurations.<br><p> <br><p> It requires Prometheus &gt;= v2.15.0.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * RemoteReadSpec defines the configuration for Prometheus to read back samples from a remote endpoint.
+     */
     @JsonProperty("oauth2")
     public OAuth2 getOauth2() {
         return oauth2;
     }
 
+    /**
+     * RemoteReadSpec defines the configuration for Prometheus to read back samples from a remote endpoint.
+     */
     @JsonProperty("oauth2")
     public void setOauth2(OAuth2 oauth2) {
         this.oauth2 = oauth2;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<SecretKeySelector>> getProxyConnectHeader() {
         return proxyConnectHeader;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     public void setProxyConnectHeader(Map<String, List<SecretKeySelector>> proxyConnectHeader) {
         this.proxyConnectHeader = proxyConnectHeader;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public Boolean getProxyFromEnvironment() {
         return proxyFromEnvironment;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public void setProxyFromEnvironment(Boolean proxyFromEnvironment) {
         this.proxyFromEnvironment = proxyFromEnvironment;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public String getProxyUrl() {
         return proxyUrl;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public void setProxyUrl(String proxyUrl) {
         this.proxyUrl = proxyUrl;
     }
 
+    /**
+     * Whether reads should be made for queries for time ranges that the local storage should have complete data for.
+     */
     @JsonProperty("readRecent")
     public Boolean getReadRecent() {
         return readRecent;
     }
 
+    /**
+     * Whether reads should be made for queries for time ranges that the local storage should have complete data for.
+     */
     @JsonProperty("readRecent")
     public void setReadRecent(Boolean readRecent) {
         this.readRecent = readRecent;
     }
 
+    /**
+     * Timeout for requests to the remote read endpoint.
+     */
     @JsonProperty("remoteTimeout")
     public String getRemoteTimeout() {
         return remoteTimeout;
     }
 
+    /**
+     * Timeout for requests to the remote read endpoint.
+     */
     @JsonProperty("remoteTimeout")
     public void setRemoteTimeout(String remoteTimeout) {
         this.remoteTimeout = remoteTimeout;
     }
 
+    /**
+     * An optional list of equality matchers which have to be present in a selector to query the remote read endpoint.
+     */
     @JsonProperty("requiredMatchers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getRequiredMatchers() {
         return requiredMatchers;
     }
 
+    /**
+     * An optional list of equality matchers which have to be present in a selector to query the remote read endpoint.
+     */
     @JsonProperty("requiredMatchers")
     public void setRequiredMatchers(Map<String, String> requiredMatchers) {
         this.requiredMatchers = requiredMatchers;
     }
 
+    /**
+     * RemoteReadSpec defines the configuration for Prometheus to read back samples from a remote endpoint.
+     */
     @JsonProperty("tlsConfig")
     public TLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * RemoteReadSpec defines the configuration for Prometheus to read back samples from a remote endpoint.
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(TLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * The URL of the endpoint to query from.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * The URL of the endpoint to query from.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/RemoteWriteSpec.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/RemoteWriteSpec.java
index 7962c635e01..9ee5bf1e171 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/RemoteWriteSpec.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/RemoteWriteSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RemoteWriteSpec defines the configuration to write samples from Prometheus to a remote endpoint.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -176,244 +179,388 @@ public RemoteWriteSpec(Authorization authorization, AzureAD azureAd, BasicAuth b
         this.writeRelabelConfigs = writeRelabelConfigs;
     }
 
+    /**
+     * RemoteWriteSpec defines the configuration to write samples from Prometheus to a remote endpoint.
+     */
     @JsonProperty("authorization")
     public Authorization getAuthorization() {
         return authorization;
     }
 
+    /**
+     * RemoteWriteSpec defines the configuration to write samples from Prometheus to a remote endpoint.
+     */
     @JsonProperty("authorization")
     public void setAuthorization(Authorization authorization) {
         this.authorization = authorization;
     }
 
+    /**
+     * RemoteWriteSpec defines the configuration to write samples from Prometheus to a remote endpoint.
+     */
     @JsonProperty("azureAd")
     public AzureAD getAzureAd() {
         return azureAd;
     }
 
+    /**
+     * RemoteWriteSpec defines the configuration to write samples from Prometheus to a remote endpoint.
+     */
     @JsonProperty("azureAd")
     public void setAzureAd(AzureAD azureAd) {
         this.azureAd = azureAd;
     }
 
+    /**
+     * RemoteWriteSpec defines the configuration to write samples from Prometheus to a remote endpoint.
+     */
     @JsonProperty("basicAuth")
     public BasicAuth getBasicAuth() {
         return basicAuth;
     }
 
+    /**
+     * RemoteWriteSpec defines the configuration to write samples from Prometheus to a remote endpoint.
+     */
     @JsonProperty("basicAuth")
     public void setBasicAuth(BasicAuth basicAuth) {
         this.basicAuth = basicAuth;
     }
 
+    /**
+     * &#42;Warning: this field shouldn't be used because the token value appears in clear-text. Prefer using `authorization`.&#42;<br><p> <br><p> Deprecated: this will be removed in a future release.
+     */
     @JsonProperty("bearerToken")
     public String getBearerToken() {
         return bearerToken;
     }
 
+    /**
+     * &#42;Warning: this field shouldn't be used because the token value appears in clear-text. Prefer using `authorization`.&#42;<br><p> <br><p> Deprecated: this will be removed in a future release.
+     */
     @JsonProperty("bearerToken")
     public void setBearerToken(String bearerToken) {
         this.bearerToken = bearerToken;
     }
 
+    /**
+     * File from which to read bearer token for the URL.<br><p> <br><p> Deprecated: this will be removed in a future release. Prefer using `authorization`.
+     */
     @JsonProperty("bearerTokenFile")
     public String getBearerTokenFile() {
         return bearerTokenFile;
     }
 
+    /**
+     * File from which to read bearer token for the URL.<br><p> <br><p> Deprecated: this will be removed in a future release. Prefer using `authorization`.
+     */
     @JsonProperty("bearerTokenFile")
     public void setBearerTokenFile(String bearerTokenFile) {
         this.bearerTokenFile = bearerTokenFile;
     }
 
+    /**
+     * Whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public Boolean getEnableHTTP2() {
         return enableHTTP2;
     }
 
+    /**
+     * Whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public void setEnableHTTP2(Boolean enableHTTP2) {
         this.enableHTTP2 = enableHTTP2;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects.<br><p> <br><p> It requires Prometheus &gt;= v2.26.0.
+     */
     @JsonProperty("followRedirects")
     public Boolean getFollowRedirects() {
         return followRedirects;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects.<br><p> <br><p> It requires Prometheus &gt;= v2.26.0.
+     */
     @JsonProperty("followRedirects")
     public void setFollowRedirects(Boolean followRedirects) {
         this.followRedirects = followRedirects;
     }
 
+    /**
+     * Custom HTTP headers to be sent along with each remote write request. Be aware that headers that are set by Prometheus itself can't be overwritten.<br><p> <br><p> It requires Prometheus &gt;= v2.25.0.
+     */
     @JsonProperty("headers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getHeaders() {
         return headers;
     }
 
+    /**
+     * Custom HTTP headers to be sent along with each remote write request. Be aware that headers that are set by Prometheus itself can't be overwritten.<br><p> <br><p> It requires Prometheus &gt;= v2.25.0.
+     */
     @JsonProperty("headers")
     public void setHeaders(Map<String, String> headers) {
         this.headers = headers;
     }
 
+    /**
+     * The Remote Write message's version to use when writing to the endpoint.<br><p> <br><p> `Version1.0` corresponds to the `prometheus.WriteRequest` protobuf message introduced in Remote Write 1.0. `Version2.0` corresponds to the `io.prometheus.write.v2.Request` protobuf message introduced in Remote Write 2.0.<br><p> <br><p> When `Version2.0` is selected, Prometheus will automatically be configured to append the metadata of scraped metrics to the WAL.<br><p> <br><p> Before setting this field, consult with your remote storage provider what message version it supports.<br><p> <br><p> It requires Prometheus &gt;= v2.54.0.
+     */
     @JsonProperty("messageVersion")
     public String getMessageVersion() {
         return messageVersion;
     }
 
+    /**
+     * The Remote Write message's version to use when writing to the endpoint.<br><p> <br><p> `Version1.0` corresponds to the `prometheus.WriteRequest` protobuf message introduced in Remote Write 1.0. `Version2.0` corresponds to the `io.prometheus.write.v2.Request` protobuf message introduced in Remote Write 2.0.<br><p> <br><p> When `Version2.0` is selected, Prometheus will automatically be configured to append the metadata of scraped metrics to the WAL.<br><p> <br><p> Before setting this field, consult with your remote storage provider what message version it supports.<br><p> <br><p> It requires Prometheus &gt;= v2.54.0.
+     */
     @JsonProperty("messageVersion")
     public void setMessageVersion(String messageVersion) {
         this.messageVersion = messageVersion;
     }
 
+    /**
+     * RemoteWriteSpec defines the configuration to write samples from Prometheus to a remote endpoint.
+     */
     @JsonProperty("metadataConfig")
     public MetadataConfig getMetadataConfig() {
         return metadataConfig;
     }
 
+    /**
+     * RemoteWriteSpec defines the configuration to write samples from Prometheus to a remote endpoint.
+     */
     @JsonProperty("metadataConfig")
     public void setMetadataConfig(MetadataConfig metadataConfig) {
         this.metadataConfig = metadataConfig;
     }
 
+    /**
+     * The name of the remote write queue, it must be unique if specified. The name is used in metrics and logging in order to differentiate queues.<br><p> <br><p> It requires Prometheus &gt;= v2.15.0.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The name of the remote write queue, it must be unique if specified. The name is used in metrics and logging in order to differentiate queues.<br><p> <br><p> It requires Prometheus &gt;= v2.15.0.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * RemoteWriteSpec defines the configuration to write samples from Prometheus to a remote endpoint.
+     */
     @JsonProperty("oauth2")
     public OAuth2 getOauth2() {
         return oauth2;
     }
 
+    /**
+     * RemoteWriteSpec defines the configuration to write samples from Prometheus to a remote endpoint.
+     */
     @JsonProperty("oauth2")
     public void setOauth2(OAuth2 oauth2) {
         this.oauth2 = oauth2;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<SecretKeySelector>> getProxyConnectHeader() {
         return proxyConnectHeader;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     public void setProxyConnectHeader(Map<String, List<SecretKeySelector>> proxyConnectHeader) {
         this.proxyConnectHeader = proxyConnectHeader;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public Boolean getProxyFromEnvironment() {
         return proxyFromEnvironment;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public void setProxyFromEnvironment(Boolean proxyFromEnvironment) {
         this.proxyFromEnvironment = proxyFromEnvironment;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public String getProxyUrl() {
         return proxyUrl;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public void setProxyUrl(String proxyUrl) {
         this.proxyUrl = proxyUrl;
     }
 
+    /**
+     * RemoteWriteSpec defines the configuration to write samples from Prometheus to a remote endpoint.
+     */
     @JsonProperty("queueConfig")
     public QueueConfig getQueueConfig() {
         return queueConfig;
     }
 
+    /**
+     * RemoteWriteSpec defines the configuration to write samples from Prometheus to a remote endpoint.
+     */
     @JsonProperty("queueConfig")
     public void setQueueConfig(QueueConfig queueConfig) {
         this.queueConfig = queueConfig;
     }
 
+    /**
+     * Timeout for requests to the remote write endpoint.
+     */
     @JsonProperty("remoteTimeout")
     public String getRemoteTimeout() {
         return remoteTimeout;
     }
 
+    /**
+     * Timeout for requests to the remote write endpoint.
+     */
     @JsonProperty("remoteTimeout")
     public void setRemoteTimeout(String remoteTimeout) {
         this.remoteTimeout = remoteTimeout;
     }
 
+    /**
+     * Enables sending of exemplars over remote write. Note that exemplar-storage itself must be enabled using the `spec.enableFeatures` option for exemplars to be scraped in the first place.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.
+     */
     @JsonProperty("sendExemplars")
     public Boolean getSendExemplars() {
         return sendExemplars;
     }
 
+    /**
+     * Enables sending of exemplars over remote write. Note that exemplar-storage itself must be enabled using the `spec.enableFeatures` option for exemplars to be scraped in the first place.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.
+     */
     @JsonProperty("sendExemplars")
     public void setSendExemplars(Boolean sendExemplars) {
         this.sendExemplars = sendExemplars;
     }
 
+    /**
+     * Enables sending of native histograms, also known as sparse histograms over remote write.<br><p> <br><p> It requires Prometheus &gt;= v2.40.0.
+     */
     @JsonProperty("sendNativeHistograms")
     public Boolean getSendNativeHistograms() {
         return sendNativeHistograms;
     }
 
+    /**
+     * Enables sending of native histograms, also known as sparse histograms over remote write.<br><p> <br><p> It requires Prometheus &gt;= v2.40.0.
+     */
     @JsonProperty("sendNativeHistograms")
     public void setSendNativeHistograms(Boolean sendNativeHistograms) {
         this.sendNativeHistograms = sendNativeHistograms;
     }
 
+    /**
+     * RemoteWriteSpec defines the configuration to write samples from Prometheus to a remote endpoint.
+     */
     @JsonProperty("sigv4")
     public Sigv4 getSigv4() {
         return sigv4;
     }
 
+    /**
+     * RemoteWriteSpec defines the configuration to write samples from Prometheus to a remote endpoint.
+     */
     @JsonProperty("sigv4")
     public void setSigv4(Sigv4 sigv4) {
         this.sigv4 = sigv4;
     }
 
+    /**
+     * RemoteWriteSpec defines the configuration to write samples from Prometheus to a remote endpoint.
+     */
     @JsonProperty("tlsConfig")
     public TLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * RemoteWriteSpec defines the configuration to write samples from Prometheus to a remote endpoint.
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(TLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * The URL of the endpoint to send samples to.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * The URL of the endpoint to send samples to.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
     }
 
+    /**
+     * The list of remote write relabel configurations.
+     */
     @JsonProperty("writeRelabelConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RelabelConfig> getWriteRelabelConfigs() {
         return writeRelabelConfigs;
     }
 
+    /**
+     * The list of remote write relabel configurations.
+     */
     @JsonProperty("writeRelabelConfigs")
     public void setWriteRelabelConfigs(List<RelabelConfig> writeRelabelConfigs) {
         this.writeRelabelConfigs = writeRelabelConfigs;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Rule.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Rule.java
index 636dda975b5..79d04bede43 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Rule.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Rule.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Rule describes an alerting or recording rule See Prometheus documentation: [alerting](https://www.prometheus.io/docs/prometheus/latest/configuration/alerting_rules/) or [recording](https://www.prometheus.io/docs/prometheus/latest/configuration/recording_rules/#recording-rules) rule
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -104,73 +107,115 @@ public Rule(String alert, Map<String, String> annotations, IntOrString expr, Str
         this.record = record;
     }
 
+    /**
+     * Name of the alert. Must be a valid label value. Only one of `record` and `alert` must be set.
+     */
     @JsonProperty("alert")
     public String getAlert() {
         return alert;
     }
 
+    /**
+     * Name of the alert. Must be a valid label value. Only one of `record` and `alert` must be set.
+     */
     @JsonProperty("alert")
     public void setAlert(String alert) {
         this.alert = alert;
     }
 
+    /**
+     * Annotations to add to each alert. Only valid for alerting rules.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations to add to each alert. Only valid for alerting rules.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Rule describes an alerting or recording rule See Prometheus documentation: [alerting](https://www.prometheus.io/docs/prometheus/latest/configuration/alerting_rules/) or [recording](https://www.prometheus.io/docs/prometheus/latest/configuration/recording_rules/#recording-rules) rule
+     */
     @JsonProperty("expr")
     public IntOrString getExpr() {
         return expr;
     }
 
+    /**
+     * Rule describes an alerting or recording rule See Prometheus documentation: [alerting](https://www.prometheus.io/docs/prometheus/latest/configuration/alerting_rules/) or [recording](https://www.prometheus.io/docs/prometheus/latest/configuration/recording_rules/#recording-rules) rule
+     */
     @JsonProperty("expr")
     public void setExpr(IntOrString expr) {
         this.expr = expr;
     }
 
+    /**
+     * Alerts are considered firing once they have been returned for this long.
+     */
     @JsonProperty("for")
     public String getFor() {
         return _for;
     }
 
+    /**
+     * Alerts are considered firing once they have been returned for this long.
+     */
     @JsonProperty("for")
     public void setFor(String _for) {
         this._for = _for;
     }
 
+    /**
+     * KeepFiringFor defines how long an alert will continue firing after the condition that triggered it has cleared.
+     */
     @JsonProperty("keep_firing_for")
     public String getKeepFiringFor() {
         return keepFiringFor;
     }
 
+    /**
+     * KeepFiringFor defines how long an alert will continue firing after the condition that triggered it has cleared.
+     */
     @JsonProperty("keep_firing_for")
     public void setKeepFiringFor(String keepFiringFor) {
         this.keepFiringFor = keepFiringFor;
     }
 
+    /**
+     * Labels to add or overwrite.
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabels() {
         return labels;
     }
 
+    /**
+     * Labels to add or overwrite.
+     */
     @JsonProperty("labels")
     public void setLabels(Map<String, String> labels) {
         this.labels = labels;
     }
 
+    /**
+     * Name of the time series to output to. Must be a valid metric name. Only one of `record` and `alert` must be set.
+     */
     @JsonProperty("record")
     public String getRecord() {
         return record;
     }
 
+    /**
+     * Name of the time series to output to. Must be a valid metric name. Only one of `record` and `alert` must be set.
+     */
     @JsonProperty("record")
     public void setRecord(String record) {
         this.record = record;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/RuleGroup.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/RuleGroup.java
index b9f656b1b2c..65436a1680f 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/RuleGroup.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/RuleGroup.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RuleGroup is a list of sequentially evaluated recording and alerting rules.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -106,73 +109,115 @@ public RuleGroup(String interval, Map<String, String> labels, Integer limit, Str
         this.rules = rules;
     }
 
+    /**
+     * Interval determines how often rules in the group are evaluated.
+     */
     @JsonProperty("interval")
     public String getInterval() {
         return interval;
     }
 
+    /**
+     * Interval determines how often rules in the group are evaluated.
+     */
     @JsonProperty("interval")
     public void setInterval(String interval) {
         this.interval = interval;
     }
 
+    /**
+     * Labels to add or overwrite before storing the result for its rules. The labels defined at the rule level take precedence.<br><p> <br><p> It requires Prometheus &gt;= 3.0.0. The field is ignored for Thanos Ruler.
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabels() {
         return labels;
     }
 
+    /**
+     * Labels to add or overwrite before storing the result for its rules. The labels defined at the rule level take precedence.<br><p> <br><p> It requires Prometheus &gt;= 3.0.0. The field is ignored for Thanos Ruler.
+     */
     @JsonProperty("labels")
     public void setLabels(Map<String, String> labels) {
         this.labels = labels;
     }
 
+    /**
+     * Limit the number of alerts an alerting rule and series a recording rule can produce. Limit is supported starting with Prometheus &gt;= 2.31 and Thanos Ruler &gt;= 0.24.
+     */
     @JsonProperty("limit")
     public Integer getLimit() {
         return limit;
     }
 
+    /**
+     * Limit the number of alerts an alerting rule and series a recording rule can produce. Limit is supported starting with Prometheus &gt;= 2.31 and Thanos Ruler &gt;= 0.24.
+     */
     @JsonProperty("limit")
     public void setLimit(Integer limit) {
         this.limit = limit;
     }
 
+    /**
+     * Name of the rule group.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the rule group.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * PartialResponseStrategy is only used by ThanosRuler and will be ignored by Prometheus instances. More info: https://github.com/thanos-io/thanos/blob/main/docs/components/rule.md#partial-response
+     */
     @JsonProperty("partial_response_strategy")
     public String getPartialResponseStrategy() {
         return partialResponseStrategy;
     }
 
+    /**
+     * PartialResponseStrategy is only used by ThanosRuler and will be ignored by Prometheus instances. More info: https://github.com/thanos-io/thanos/blob/main/docs/components/rule.md#partial-response
+     */
     @JsonProperty("partial_response_strategy")
     public void setPartialResponseStrategy(String partialResponseStrategy) {
         this.partialResponseStrategy = partialResponseStrategy;
     }
 
+    /**
+     * Defines the offset the rule evaluation timestamp of this particular group by the specified duration into the past.<br><p> <br><p> It requires Prometheus &gt;= v2.53.0. It is not supported for ThanosRuler.
+     */
     @JsonProperty("query_offset")
     public String getQueryOffset() {
         return queryOffset;
     }
 
+    /**
+     * Defines the offset the rule evaluation timestamp of this particular group by the specified duration into the past.<br><p> <br><p> It requires Prometheus &gt;= v2.53.0. It is not supported for ThanosRuler.
+     */
     @JsonProperty("query_offset")
     public void setQueryOffset(String queryOffset) {
         this.queryOffset = queryOffset;
     }
 
+    /**
+     * List of alerting and recording rules.
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Rule> getRules() {
         return rules;
     }
 
+    /**
+     * List of alerting and recording rules.
+     */
     @JsonProperty("rules")
     public void setRules(List<Rule> rules) {
         this.rules = rules;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/RulesAlert.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/RulesAlert.java
index 2d250b9175b..dcc76bdf29d 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/RulesAlert.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/RulesAlert.java
@@ -86,31 +86,49 @@ public RulesAlert(String forGracePeriod, String forOutageTolerance, String resen
         this.resendDelay = resendDelay;
     }
 
+    /**
+     * Minimum duration between alert and restored 'for' state.<br><p> <br><p> This is maintained only for alerts with a configured 'for' time greater than the grace period.
+     */
     @JsonProperty("forGracePeriod")
     public String getForGracePeriod() {
         return forGracePeriod;
     }
 
+    /**
+     * Minimum duration between alert and restored 'for' state.<br><p> <br><p> This is maintained only for alerts with a configured 'for' time greater than the grace period.
+     */
     @JsonProperty("forGracePeriod")
     public void setForGracePeriod(String forGracePeriod) {
         this.forGracePeriod = forGracePeriod;
     }
 
+    /**
+     * Max time to tolerate prometheus outage for restoring 'for' state of alert.
+     */
     @JsonProperty("forOutageTolerance")
     public String getForOutageTolerance() {
         return forOutageTolerance;
     }
 
+    /**
+     * Max time to tolerate prometheus outage for restoring 'for' state of alert.
+     */
     @JsonProperty("forOutageTolerance")
     public void setForOutageTolerance(String forOutageTolerance) {
         this.forOutageTolerance = forOutageTolerance;
     }
 
+    /**
+     * Minimum amount of time to wait before resending an alert to Alertmanager.
+     */
     @JsonProperty("resendDelay")
     public String getResendDelay() {
         return resendDelay;
     }
 
+    /**
+     * Minimum amount of time to wait before resending an alert to Alertmanager.
+     */
     @JsonProperty("resendDelay")
     public void setResendDelay(String resendDelay) {
         this.resendDelay = resendDelay;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/RuntimeConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/RuntimeConfig.java
index 85023370d98..b83921e5654 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/RuntimeConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/RuntimeConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RuntimeConfig configures the values for the process behavior.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public RuntimeConfig(Integer goGC) {
         this.goGC = goGC;
     }
 
+    /**
+     * The Go garbage collection target percentage. Lowering this number may increase the CPU usage. See: https://tip.golang.org/doc/gc-guide#GOGC
+     */
     @JsonProperty("goGC")
     public Integer getGoGC() {
         return goGC;
     }
 
+    /**
+     * The Go garbage collection target percentage. Lowering this number may increase the CPU usage. See: https://tip.golang.org/doc/gc-guide#GOGC
+     */
     @JsonProperty("goGC")
     public void setGoGC(Integer goGC) {
         this.goGC = goGC;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/SafeAuthorization.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/SafeAuthorization.java
index 59c39b86eb5..a50e624033d 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/SafeAuthorization.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/SafeAuthorization.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SafeAuthorization specifies a subset of the Authorization struct, that is safe for use because it doesn't provide access to the Prometheus container's filesystem.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public SafeAuthorization(SecretKeySelector credentials, String type) {
         this.type = type;
     }
 
+    /**
+     * SafeAuthorization specifies a subset of the Authorization struct, that is safe for use because it doesn't provide access to the Prometheus container's filesystem.
+     */
     @JsonProperty("credentials")
     public SecretKeySelector getCredentials() {
         return credentials;
     }
 
+    /**
+     * SafeAuthorization specifies a subset of the Authorization struct, that is safe for use because it doesn't provide access to the Prometheus container's filesystem.
+     */
     @JsonProperty("credentials")
     public void setCredentials(SecretKeySelector credentials) {
         this.credentials = credentials;
     }
 
+    /**
+     * Defines the authentication type. The value is case-insensitive.<br><p> <br><p> "Basic" is not a supported value.<br><p> <br><p> Default: "Bearer"
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Defines the authentication type. The value is case-insensitive.<br><p> <br><p> "Basic" is not a supported value.<br><p> <br><p> Default: "Bearer"
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/SafeTLSConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/SafeTLSConfig.java
index 1700937236a..ebff0bc87fc 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/SafeTLSConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/SafeTLSConfig.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SafeTLSConfig specifies safe TLS configuration parameters.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -103,71 +106,113 @@ public SafeTLSConfig(SecretOrConfigMap ca, SecretOrConfigMap cert, Boolean insec
         this.serverName = serverName;
     }
 
+    /**
+     * SafeTLSConfig specifies safe TLS configuration parameters.
+     */
     @JsonProperty("ca")
     public SecretOrConfigMap getCa() {
         return ca;
     }
 
+    /**
+     * SafeTLSConfig specifies safe TLS configuration parameters.
+     */
     @JsonProperty("ca")
     public void setCa(SecretOrConfigMap ca) {
         this.ca = ca;
     }
 
+    /**
+     * SafeTLSConfig specifies safe TLS configuration parameters.
+     */
     @JsonProperty("cert")
     public SecretOrConfigMap getCert() {
         return cert;
     }
 
+    /**
+     * SafeTLSConfig specifies safe TLS configuration parameters.
+     */
     @JsonProperty("cert")
     public void setCert(SecretOrConfigMap cert) {
         this.cert = cert;
     }
 
+    /**
+     * Disable target certificate validation.
+     */
     @JsonProperty("insecureSkipVerify")
     public Boolean getInsecureSkipVerify() {
         return insecureSkipVerify;
     }
 
+    /**
+     * Disable target certificate validation.
+     */
     @JsonProperty("insecureSkipVerify")
     public void setInsecureSkipVerify(Boolean insecureSkipVerify) {
         this.insecureSkipVerify = insecureSkipVerify;
     }
 
+    /**
+     * SafeTLSConfig specifies safe TLS configuration parameters.
+     */
     @JsonProperty("keySecret")
     public SecretKeySelector getKeySecret() {
         return keySecret;
     }
 
+    /**
+     * SafeTLSConfig specifies safe TLS configuration parameters.
+     */
     @JsonProperty("keySecret")
     public void setKeySecret(SecretKeySelector keySecret) {
         this.keySecret = keySecret;
     }
 
+    /**
+     * Maximum acceptable TLS version.<br><p> <br><p> It requires Prometheus &gt;= v2.41.0.
+     */
     @JsonProperty("maxVersion")
     public String getMaxVersion() {
         return maxVersion;
     }
 
+    /**
+     * Maximum acceptable TLS version.<br><p> <br><p> It requires Prometheus &gt;= v2.41.0.
+     */
     @JsonProperty("maxVersion")
     public void setMaxVersion(String maxVersion) {
         this.maxVersion = maxVersion;
     }
 
+    /**
+     * Minimum acceptable TLS version.<br><p> <br><p> It requires Prometheus &gt;= v2.35.0.
+     */
     @JsonProperty("minVersion")
     public String getMinVersion() {
         return minVersion;
     }
 
+    /**
+     * Minimum acceptable TLS version.<br><p> <br><p> It requires Prometheus &gt;= v2.35.0.
+     */
     @JsonProperty("minVersion")
     public void setMinVersion(String minVersion) {
         this.minVersion = minVersion;
     }
 
+    /**
+     * Used to verify the hostname for the targets.
+     */
     @JsonProperty("serverName")
     public String getServerName() {
         return serverName;
     }
 
+    /**
+     * Used to verify the hostname for the targets.
+     */
     @JsonProperty("serverName")
     public void setServerName(String serverName) {
         this.serverName = serverName;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ScrapeClass.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ScrapeClass.java
index ca073f51eb2..e5ee995a1f7 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ScrapeClass.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ScrapeClass.java
@@ -126,43 +126,67 @@ public void setAuthorization(Authorization authorization) {
         this.authorization = authorization;
     }
 
+    /**
+     * Default indicates that the scrape applies to all scrape objects that don't configure an explicit scrape class name.<br><p> <br><p> Only one scrape class can be set as the default.
+     */
     @JsonProperty("default")
     public Boolean getDefault() {
         return _default;
     }
 
+    /**
+     * Default indicates that the scrape applies to all scrape objects that don't configure an explicit scrape class name.<br><p> <br><p> Only one scrape class can be set as the default.
+     */
     @JsonProperty("default")
     public void setDefault(Boolean _default) {
         this._default = _default;
     }
 
+    /**
+     * MetricRelabelings configures the relabeling rules to apply to all samples before ingestion.<br><p> <br><p> The Operator adds the scrape class metric relabelings defined here. Then the Operator adds the target-specific metric relabelings defined in ServiceMonitors, PodMonitors, Probes and ScrapeConfigs. Then the Operator adds namespace enforcement relabeling rule, specified in '.spec.enforcedNamespaceLabel'.<br><p> <br><p> More info: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#metric_relabel_configs
+     */
     @JsonProperty("metricRelabelings")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RelabelConfig> getMetricRelabelings() {
         return metricRelabelings;
     }
 
+    /**
+     * MetricRelabelings configures the relabeling rules to apply to all samples before ingestion.<br><p> <br><p> The Operator adds the scrape class metric relabelings defined here. Then the Operator adds the target-specific metric relabelings defined in ServiceMonitors, PodMonitors, Probes and ScrapeConfigs. Then the Operator adds namespace enforcement relabeling rule, specified in '.spec.enforcedNamespaceLabel'.<br><p> <br><p> More info: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#metric_relabel_configs
+     */
     @JsonProperty("metricRelabelings")
     public void setMetricRelabelings(List<RelabelConfig> metricRelabelings) {
         this.metricRelabelings = metricRelabelings;
     }
 
+    /**
+     * Name of the scrape class.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the scrape class.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Relabelings configures the relabeling rules to apply to all scrape targets.<br><p> <br><p> The Operator automatically adds relabelings for a few standard Kubernetes fields like `__meta_kubernetes_namespace` and `__meta_kubernetes_service_name`. Then the Operator adds the scrape class relabelings defined here. Then the Operator adds the target-specific relabelings defined in the scrape object.<br><p> <br><p> More info: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config
+     */
     @JsonProperty("relabelings")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RelabelConfig> getRelabelings() {
         return relabelings;
     }
 
+    /**
+     * Relabelings configures the relabeling rules to apply to all scrape targets.<br><p> <br><p> The Operator automatically adds relabelings for a few standard Kubernetes fields like `__meta_kubernetes_namespace` and `__meta_kubernetes_service_name`. Then the Operator adds the scrape class relabelings defined here. Then the Operator adds the target-specific relabelings defined in the scrape object.<br><p> <br><p> More info: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config
+     */
     @JsonProperty("relabelings")
     public void setRelabelings(List<RelabelConfig> relabelings) {
         this.relabelings = relabelings;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/SecretOrConfigMap.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/SecretOrConfigMap.java
index 0a47ea1e609..2aa51810a83 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/SecretOrConfigMap.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/SecretOrConfigMap.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SecretOrConfigMap allows to specify data as a Secret or ConfigMap. Fields are mutually exclusive.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -84,21 +87,33 @@ public SecretOrConfigMap(ConfigMapKeySelector configMap, SecretKeySelector secre
         this.secret = secret;
     }
 
+    /**
+     * SecretOrConfigMap allows to specify data as a Secret or ConfigMap. Fields are mutually exclusive.
+     */
     @JsonProperty("configMap")
     public ConfigMapKeySelector getConfigMap() {
         return configMap;
     }
 
+    /**
+     * SecretOrConfigMap allows to specify data as a Secret or ConfigMap. Fields are mutually exclusive.
+     */
     @JsonProperty("configMap")
     public void setConfigMap(ConfigMapKeySelector configMap) {
         this.configMap = configMap;
     }
 
+    /**
+     * SecretOrConfigMap allows to specify data as a Secret or ConfigMap. Fields are mutually exclusive.
+     */
     @JsonProperty("secret")
     public SecretKeySelector getSecret() {
         return secret;
     }
 
+    /**
+     * SecretOrConfigMap allows to specify data as a Secret or ConfigMap. Fields are mutually exclusive.
+     */
     @JsonProperty("secret")
     public void setSecret(SecretKeySelector secret) {
         this.secret = secret;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ServiceMonitor.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ServiceMonitor.java
index c65cd08f734..c6c312dc66a 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ServiceMonitor.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ServiceMonitor.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * The `ServiceMonitor` custom resource definition (CRD) defines how `Prometheus` and `PrometheusAgent` can scrape metrics from a group of services. Among other things, it allows to specify: &#42; The services to scrape via label selectors. &#42; The container ports to scrape. &#42; Authentication credentials to use. &#42; Target and metric relabeling.<br><p> <br><p> `Prometheus` and `PrometheusAgent` objects select `ServiceMonitor` objects using label and namespace selectors.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ServiceMonitor implements Editable<ServiceMonitorBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "monitoring.coreos.com/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ServiceMonitor";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public ServiceMonitor(String apiVersion, String kind, ObjectMeta metadata, Servi
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * The `ServiceMonitor` custom resource definition (CRD) defines how `Prometheus` and `PrometheusAgent` can scrape metrics from a group of services. Among other things, it allows to specify: &#42; The services to scrape via label selectors. &#42; The container ports to scrape. &#42; Authentication credentials to use. &#42; Target and metric relabeling.<br><p> <br><p> `Prometheus` and `PrometheusAgent` objects select `ServiceMonitor` objects using label and namespace selectors.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * The `ServiceMonitor` custom resource definition (CRD) defines how `Prometheus` and `PrometheusAgent` can scrape metrics from a group of services. Among other things, it allows to specify: &#42; The services to scrape via label selectors. &#42; The container ports to scrape. &#42; Authentication credentials to use. &#42; Target and metric relabeling.<br><p> <br><p> `Prometheus` and `PrometheusAgent` objects select `ServiceMonitor` objects using label and namespace selectors.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * The `ServiceMonitor` custom resource definition (CRD) defines how `Prometheus` and `PrometheusAgent` can scrape metrics from a group of services. Among other things, it allows to specify: &#42; The services to scrape via label selectors. &#42; The container ports to scrape. &#42; Authentication credentials to use. &#42; Target and metric relabeling.<br><p> <br><p> `Prometheus` and `PrometheusAgent` objects select `ServiceMonitor` objects using label and namespace selectors.
+     */
     @JsonProperty("spec")
     public ServiceMonitorSpec getSpec() {
         return spec;
     }
 
+    /**
+     * The `ServiceMonitor` custom resource definition (CRD) defines how `Prometheus` and `PrometheusAgent` can scrape metrics from a group of services. Among other things, it allows to specify: &#42; The services to scrape via label selectors. &#42; The container ports to scrape. &#42; Authentication credentials to use. &#42; Target and metric relabeling.<br><p> <br><p> `Prometheus` and `PrometheusAgent` objects select `ServiceMonitor` objects using label and namespace selectors.
+     */
     @JsonProperty("spec")
     public void setSpec(ServiceMonitorSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ServiceMonitorList.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ServiceMonitorList.java
index b16813a5283..225f79fac72 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ServiceMonitorList.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ServiceMonitorList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceMonitorList is a list of ServiceMonitors.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ServiceMonitorList implements Editable<ServiceMonitorListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.monitoring.v1.ServiceMonitor>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "monitoring.coreos.com/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.monitoring.v1.ServiceMonitor> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ServiceMonitorList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ServiceMonitorList(String apiVersion, List<io.fabric8.openshift.api.model
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of ServiceMonitors
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.monitoring.v1.ServiceMonitor> getItems() {
         return items;
     }
 
+    /**
+     * List of ServiceMonitors
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.monitoring.v1.ServiceMonitor> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ServiceMonitorList is a list of ServiceMonitors.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ServiceMonitorList is a list of ServiceMonitors.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ServiceMonitorSpec.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ServiceMonitorSpec.java
index 033d6097089..df59f654071 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ServiceMonitorSpec.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ServiceMonitorSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceMonitorSpec defines the specification parameters for a ServiceMonitor.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -165,215 +168,341 @@ public ServiceMonitorSpec(AttachMetadata attachMetadata, String bodySizeLimit, L
         this.targetLimit = targetLimit;
     }
 
+    /**
+     * ServiceMonitorSpec defines the specification parameters for a ServiceMonitor.
+     */
     @JsonProperty("attachMetadata")
     public AttachMetadata getAttachMetadata() {
         return attachMetadata;
     }
 
+    /**
+     * ServiceMonitorSpec defines the specification parameters for a ServiceMonitor.
+     */
     @JsonProperty("attachMetadata")
     public void setAttachMetadata(AttachMetadata attachMetadata) {
         this.attachMetadata = attachMetadata;
     }
 
+    /**
+     * When defined, bodySizeLimit specifies a job level limit on the size of uncompressed response body that will be accepted by Prometheus.<br><p> <br><p> It requires Prometheus &gt;= v2.28.0.
+     */
     @JsonProperty("bodySizeLimit")
     public String getBodySizeLimit() {
         return bodySizeLimit;
     }
 
+    /**
+     * When defined, bodySizeLimit specifies a job level limit on the size of uncompressed response body that will be accepted by Prometheus.<br><p> <br><p> It requires Prometheus &gt;= v2.28.0.
+     */
     @JsonProperty("bodySizeLimit")
     public void setBodySizeLimit(String bodySizeLimit) {
         this.bodySizeLimit = bodySizeLimit;
     }
 
+    /**
+     * List of endpoints part of this ServiceMonitor. Defines how to scrape metrics from Kubernetes [Endpoints](https://kubernetes.io/docs/concepts/services-networking/service/#endpoints) objects. In most cases, an Endpoints object is backed by a Kubernetes [Service](https://kubernetes.io/docs/concepts/services-networking/service/) object with the same name and labels.
+     */
     @JsonProperty("endpoints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Endpoint> getEndpoints() {
         return endpoints;
     }
 
+    /**
+     * List of endpoints part of this ServiceMonitor. Defines how to scrape metrics from Kubernetes [Endpoints](https://kubernetes.io/docs/concepts/services-networking/service/#endpoints) objects. In most cases, an Endpoints object is backed by a Kubernetes [Service](https://kubernetes.io/docs/concepts/services-networking/service/) object with the same name and labels.
+     */
     @JsonProperty("endpoints")
     public void setEndpoints(List<Endpoint> endpoints) {
         this.endpoints = endpoints;
     }
 
+    /**
+     * The protocol to use if a scrape returns blank, unparseable, or otherwise invalid Content-Type.<br><p> <br><p> It requires Prometheus &gt;= v3.0.0.
+     */
     @JsonProperty("fallbackScrapeProtocol")
     public String getFallbackScrapeProtocol() {
         return fallbackScrapeProtocol;
     }
 
+    /**
+     * The protocol to use if a scrape returns blank, unparseable, or otherwise invalid Content-Type.<br><p> <br><p> It requires Prometheus &gt;= v3.0.0.
+     */
     @JsonProperty("fallbackScrapeProtocol")
     public void setFallbackScrapeProtocol(String fallbackScrapeProtocol) {
         this.fallbackScrapeProtocol = fallbackScrapeProtocol;
     }
 
+    /**
+     * `jobLabel` selects the label from the associated Kubernetes `Service` object which will be used as the `job` label for all metrics.<br><p> <br><p> For example if `jobLabel` is set to `foo` and the Kubernetes `Service` object is labeled with `foo: bar`, then Prometheus adds the `job="bar"` label to all ingested metrics.<br><p> <br><p> If the value of this field is empty or if the label doesn't exist for the given Service, the `job` label of the metrics defaults to the name of the associated Kubernetes `Service`.
+     */
     @JsonProperty("jobLabel")
     public String getJobLabel() {
         return jobLabel;
     }
 
+    /**
+     * `jobLabel` selects the label from the associated Kubernetes `Service` object which will be used as the `job` label for all metrics.<br><p> <br><p> For example if `jobLabel` is set to `foo` and the Kubernetes `Service` object is labeled with `foo: bar`, then Prometheus adds the `job="bar"` label to all ingested metrics.<br><p> <br><p> If the value of this field is empty or if the label doesn't exist for the given Service, the `job` label of the metrics defaults to the name of the associated Kubernetes `Service`.
+     */
     @JsonProperty("jobLabel")
     public void setJobLabel(String jobLabel) {
         this.jobLabel = jobLabel;
     }
 
+    /**
+     * Per-scrape limit on the number of targets dropped by relabeling that will be kept in memory. 0 means no limit.<br><p> <br><p> It requires Prometheus &gt;= v2.47.0.
+     */
     @JsonProperty("keepDroppedTargets")
     public Long getKeepDroppedTargets() {
         return keepDroppedTargets;
     }
 
+    /**
+     * Per-scrape limit on the number of targets dropped by relabeling that will be kept in memory. 0 means no limit.<br><p> <br><p> It requires Prometheus &gt;= v2.47.0.
+     */
     @JsonProperty("keepDroppedTargets")
     public void setKeepDroppedTargets(Long keepDroppedTargets) {
         this.keepDroppedTargets = keepDroppedTargets;
     }
 
+    /**
+     * Per-scrape limit on number of labels that will be accepted for a sample.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.
+     */
     @JsonProperty("labelLimit")
     public Long getLabelLimit() {
         return labelLimit;
     }
 
+    /**
+     * Per-scrape limit on number of labels that will be accepted for a sample.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.
+     */
     @JsonProperty("labelLimit")
     public void setLabelLimit(Long labelLimit) {
         this.labelLimit = labelLimit;
     }
 
+    /**
+     * Per-scrape limit on length of labels name that will be accepted for a sample.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.
+     */
     @JsonProperty("labelNameLengthLimit")
     public Long getLabelNameLengthLimit() {
         return labelNameLengthLimit;
     }
 
+    /**
+     * Per-scrape limit on length of labels name that will be accepted for a sample.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.
+     */
     @JsonProperty("labelNameLengthLimit")
     public void setLabelNameLengthLimit(Long labelNameLengthLimit) {
         this.labelNameLengthLimit = labelNameLengthLimit;
     }
 
+    /**
+     * Per-scrape limit on length of labels value that will be accepted for a sample.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.
+     */
     @JsonProperty("labelValueLengthLimit")
     public Long getLabelValueLengthLimit() {
         return labelValueLengthLimit;
     }
 
+    /**
+     * Per-scrape limit on length of labels value that will be accepted for a sample.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.
+     */
     @JsonProperty("labelValueLengthLimit")
     public void setLabelValueLengthLimit(Long labelValueLengthLimit) {
         this.labelValueLengthLimit = labelValueLengthLimit;
     }
 
+    /**
+     * ServiceMonitorSpec defines the specification parameters for a ServiceMonitor.
+     */
     @JsonProperty("namespaceSelector")
     public NamespaceSelector getNamespaceSelector() {
         return namespaceSelector;
     }
 
+    /**
+     * ServiceMonitorSpec defines the specification parameters for a ServiceMonitor.
+     */
     @JsonProperty("namespaceSelector")
     public void setNamespaceSelector(NamespaceSelector namespaceSelector) {
         this.namespaceSelector = namespaceSelector;
     }
 
+    /**
+     * If there are more than this many buckets in a native histogram, buckets will be merged to stay within the limit. It requires Prometheus &gt;= v2.45.0.
+     */
     @JsonProperty("nativeHistogramBucketLimit")
     public Long getNativeHistogramBucketLimit() {
         return nativeHistogramBucketLimit;
     }
 
+    /**
+     * If there are more than this many buckets in a native histogram, buckets will be merged to stay within the limit. It requires Prometheus &gt;= v2.45.0.
+     */
     @JsonProperty("nativeHistogramBucketLimit")
     public void setNativeHistogramBucketLimit(Long nativeHistogramBucketLimit) {
         this.nativeHistogramBucketLimit = nativeHistogramBucketLimit;
     }
 
+    /**
+     * ServiceMonitorSpec defines the specification parameters for a ServiceMonitor.
+     */
     @JsonProperty("nativeHistogramMinBucketFactor")
     public Quantity getNativeHistogramMinBucketFactor() {
         return nativeHistogramMinBucketFactor;
     }
 
+    /**
+     * ServiceMonitorSpec defines the specification parameters for a ServiceMonitor.
+     */
     @JsonProperty("nativeHistogramMinBucketFactor")
     public void setNativeHistogramMinBucketFactor(Quantity nativeHistogramMinBucketFactor) {
         this.nativeHistogramMinBucketFactor = nativeHistogramMinBucketFactor;
     }
 
+    /**
+     * `podTargetLabels` defines the labels which are transferred from the associated Kubernetes `Pod` object onto the ingested metrics.
+     */
     @JsonProperty("podTargetLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPodTargetLabels() {
         return podTargetLabels;
     }
 
+    /**
+     * `podTargetLabels` defines the labels which are transferred from the associated Kubernetes `Pod` object onto the ingested metrics.
+     */
     @JsonProperty("podTargetLabels")
     public void setPodTargetLabels(List<String> podTargetLabels) {
         this.podTargetLabels = podTargetLabels;
     }
 
+    /**
+     * `sampleLimit` defines a per-scrape limit on the number of scraped samples that will be accepted.
+     */
     @JsonProperty("sampleLimit")
     public Long getSampleLimit() {
         return sampleLimit;
     }
 
+    /**
+     * `sampleLimit` defines a per-scrape limit on the number of scraped samples that will be accepted.
+     */
     @JsonProperty("sampleLimit")
     public void setSampleLimit(Long sampleLimit) {
         this.sampleLimit = sampleLimit;
     }
 
+    /**
+     * The scrape class to apply.
+     */
     @JsonProperty("scrapeClass")
     public String getScrapeClass() {
         return scrapeClass;
     }
 
+    /**
+     * The scrape class to apply.
+     */
     @JsonProperty("scrapeClass")
     public void setScrapeClass(String scrapeClass) {
         this.scrapeClass = scrapeClass;
     }
 
+    /**
+     * Whether to scrape a classic histogram that is also exposed as a native histogram. It requires Prometheus &gt;= v2.45.0.
+     */
     @JsonProperty("scrapeClassicHistograms")
     public Boolean getScrapeClassicHistograms() {
         return scrapeClassicHistograms;
     }
 
+    /**
+     * Whether to scrape a classic histogram that is also exposed as a native histogram. It requires Prometheus &gt;= v2.45.0.
+     */
     @JsonProperty("scrapeClassicHistograms")
     public void setScrapeClassicHistograms(Boolean scrapeClassicHistograms) {
         this.scrapeClassicHistograms = scrapeClassicHistograms;
     }
 
+    /**
+     * `scrapeProtocols` defines the protocols to negotiate during a scrape. It tells clients the protocols supported by Prometheus in order of preference (from most to least preferred).<br><p> <br><p> If unset, Prometheus uses its default value.<br><p> <br><p> It requires Prometheus &gt;= v2.49.0.
+     */
     @JsonProperty("scrapeProtocols")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getScrapeProtocols() {
         return scrapeProtocols;
     }
 
+    /**
+     * `scrapeProtocols` defines the protocols to negotiate during a scrape. It tells clients the protocols supported by Prometheus in order of preference (from most to least preferred).<br><p> <br><p> If unset, Prometheus uses its default value.<br><p> <br><p> It requires Prometheus &gt;= v2.49.0.
+     */
     @JsonProperty("scrapeProtocols")
     public void setScrapeProtocols(List<String> scrapeProtocols) {
         this.scrapeProtocols = scrapeProtocols;
     }
 
+    /**
+     * ServiceMonitorSpec defines the specification parameters for a ServiceMonitor.
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * ServiceMonitorSpec defines the specification parameters for a ServiceMonitor.
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * Mechanism used to select the endpoints to scrape. By default, the selection process relies on relabel configurations to filter the discovered targets. Alternatively, you can opt in for role selectors, which may offer better efficiency in large clusters. Which strategy is best for your use case needs to be carefully evaluated.<br><p> <br><p> It requires Prometheus &gt;= v2.17.0.
+     */
     @JsonProperty("selectorMechanism")
     public String getSelectorMechanism() {
         return selectorMechanism;
     }
 
+    /**
+     * Mechanism used to select the endpoints to scrape. By default, the selection process relies on relabel configurations to filter the discovered targets. Alternatively, you can opt in for role selectors, which may offer better efficiency in large clusters. Which strategy is best for your use case needs to be carefully evaluated.<br><p> <br><p> It requires Prometheus &gt;= v2.17.0.
+     */
     @JsonProperty("selectorMechanism")
     public void setSelectorMechanism(String selectorMechanism) {
         this.selectorMechanism = selectorMechanism;
     }
 
+    /**
+     * `targetLabels` defines the labels which are transferred from the associated Kubernetes `Service` object onto the ingested metrics.
+     */
     @JsonProperty("targetLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getTargetLabels() {
         return targetLabels;
     }
 
+    /**
+     * `targetLabels` defines the labels which are transferred from the associated Kubernetes `Service` object onto the ingested metrics.
+     */
     @JsonProperty("targetLabels")
     public void setTargetLabels(List<String> targetLabels) {
         this.targetLabels = targetLabels;
     }
 
+    /**
+     * `targetLimit` defines a limit on the number of scraped targets that will be accepted.
+     */
     @JsonProperty("targetLimit")
     public Long getTargetLimit() {
         return targetLimit;
     }
 
+    /**
+     * `targetLimit` defines a limit on the number of scraped targets that will be accepted.
+     */
     @JsonProperty("targetLimit")
     public void setTargetLimit(Long targetLimit) {
         this.targetLimit = targetLimit;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ShardStatus.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ShardStatus.java
index 1052aca2ed8..1cf3f92b2f7 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ShardStatus.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ShardStatus.java
@@ -94,51 +94,81 @@ public ShardStatus(Integer availableReplicas, Integer replicas, String shardID,
         this.updatedReplicas = updatedReplicas;
     }
 
+    /**
+     * Total number of available pods (ready for at least minReadySeconds) targeted by this shard.
+     */
     @JsonProperty("availableReplicas")
     public Integer getAvailableReplicas() {
         return availableReplicas;
     }
 
+    /**
+     * Total number of available pods (ready for at least minReadySeconds) targeted by this shard.
+     */
     @JsonProperty("availableReplicas")
     public void setAvailableReplicas(Integer availableReplicas) {
         this.availableReplicas = availableReplicas;
     }
 
+    /**
+     * Total number of pods targeted by this shard.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Total number of pods targeted by this shard.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * Identifier of the shard.
+     */
     @JsonProperty("shardID")
     public String getShardID() {
         return shardID;
     }
 
+    /**
+     * Identifier of the shard.
+     */
     @JsonProperty("shardID")
     public void setShardID(String shardID) {
         this.shardID = shardID;
     }
 
+    /**
+     * Total number of unavailable pods targeted by this shard.
+     */
     @JsonProperty("unavailableReplicas")
     public Integer getUnavailableReplicas() {
         return unavailableReplicas;
     }
 
+    /**
+     * Total number of unavailable pods targeted by this shard.
+     */
     @JsonProperty("unavailableReplicas")
     public void setUnavailableReplicas(Integer unavailableReplicas) {
         this.unavailableReplicas = unavailableReplicas;
     }
 
+    /**
+     * Total number of non-terminated pods targeted by this shard that have the desired spec.
+     */
     @JsonProperty("updatedReplicas")
     public Integer getUpdatedReplicas() {
         return updatedReplicas;
     }
 
+    /**
+     * Total number of non-terminated pods targeted by this shard that have the desired spec.
+     */
     @JsonProperty("updatedReplicas")
     public void setUpdatedReplicas(Integer updatedReplicas) {
         this.updatedReplicas = updatedReplicas;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Sigv4.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Sigv4.java
index faca336b9c0..605f6acd919 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Sigv4.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/Sigv4.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Sigv4 optionally configures AWS's Signature Verification 4 signing process to sign requests.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,51 +98,81 @@ public Sigv4(SecretKeySelector accessKey, String profile, String region, String
         this.secretKey = secretKey;
     }
 
+    /**
+     * Sigv4 optionally configures AWS's Signature Verification 4 signing process to sign requests.
+     */
     @JsonProperty("accessKey")
     public SecretKeySelector getAccessKey() {
         return accessKey;
     }
 
+    /**
+     * Sigv4 optionally configures AWS's Signature Verification 4 signing process to sign requests.
+     */
     @JsonProperty("accessKey")
     public void setAccessKey(SecretKeySelector accessKey) {
         this.accessKey = accessKey;
     }
 
+    /**
+     * Profile is the named AWS profile used to authenticate.
+     */
     @JsonProperty("profile")
     public String getProfile() {
         return profile;
     }
 
+    /**
+     * Profile is the named AWS profile used to authenticate.
+     */
     @JsonProperty("profile")
     public void setProfile(String profile) {
         this.profile = profile;
     }
 
+    /**
+     * Region is the AWS region. If blank, the region from the default credentials chain used.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Region is the AWS region. If blank, the region from the default credentials chain used.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * RoleArn is the named AWS profile used to authenticate.
+     */
     @JsonProperty("roleArn")
     public String getRoleArn() {
         return roleArn;
     }
 
+    /**
+     * RoleArn is the named AWS profile used to authenticate.
+     */
     @JsonProperty("roleArn")
     public void setRoleArn(String roleArn) {
         this.roleArn = roleArn;
     }
 
+    /**
+     * Sigv4 optionally configures AWS's Signature Verification 4 signing process to sign requests.
+     */
     @JsonProperty("secretKey")
     public SecretKeySelector getSecretKey() {
         return secretKey;
     }
 
+    /**
+     * Sigv4 optionally configures AWS's Signature Verification 4 signing process to sign requests.
+     */
     @JsonProperty("secretKey")
     public void setSecretKey(SecretKeySelector secretKey) {
         this.secretKey = secretKey;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/StorageSpec.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/StorageSpec.java
index 20644120277..c7da5a9a0a3 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/StorageSpec.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/StorageSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StorageSpec defines the configured storage for a group Prometheus servers. If no storage option is specified, then by default an [EmptyDir](https://kubernetes.io/docs/concepts/storage/volumes/#emptydir) will be used.<br><p> <br><p> If multiple storage options are specified, priority will be given as follows:<br><p>  1. emptyDir<br><p>  2. ephemeral<br><p>  3. volumeClaimTemplate
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -92,41 +95,65 @@ public StorageSpec(Boolean disableMountSubPath, EmptyDirVolumeSource emptyDir, E
         this.volumeClaimTemplate = volumeClaimTemplate;
     }
 
+    /**
+     * Deprecated: subPath usage will be removed in a future release.
+     */
     @JsonProperty("disableMountSubPath")
     public Boolean getDisableMountSubPath() {
         return disableMountSubPath;
     }
 
+    /**
+     * Deprecated: subPath usage will be removed in a future release.
+     */
     @JsonProperty("disableMountSubPath")
     public void setDisableMountSubPath(Boolean disableMountSubPath) {
         this.disableMountSubPath = disableMountSubPath;
     }
 
+    /**
+     * StorageSpec defines the configured storage for a group Prometheus servers. If no storage option is specified, then by default an [EmptyDir](https://kubernetes.io/docs/concepts/storage/volumes/#emptydir) will be used.<br><p> <br><p> If multiple storage options are specified, priority will be given as follows:<br><p>  1. emptyDir<br><p>  2. ephemeral<br><p>  3. volumeClaimTemplate
+     */
     @JsonProperty("emptyDir")
     public EmptyDirVolumeSource getEmptyDir() {
         return emptyDir;
     }
 
+    /**
+     * StorageSpec defines the configured storage for a group Prometheus servers. If no storage option is specified, then by default an [EmptyDir](https://kubernetes.io/docs/concepts/storage/volumes/#emptydir) will be used.<br><p> <br><p> If multiple storage options are specified, priority will be given as follows:<br><p>  1. emptyDir<br><p>  2. ephemeral<br><p>  3. volumeClaimTemplate
+     */
     @JsonProperty("emptyDir")
     public void setEmptyDir(EmptyDirVolumeSource emptyDir) {
         this.emptyDir = emptyDir;
     }
 
+    /**
+     * StorageSpec defines the configured storage for a group Prometheus servers. If no storage option is specified, then by default an [EmptyDir](https://kubernetes.io/docs/concepts/storage/volumes/#emptydir) will be used.<br><p> <br><p> If multiple storage options are specified, priority will be given as follows:<br><p>  1. emptyDir<br><p>  2. ephemeral<br><p>  3. volumeClaimTemplate
+     */
     @JsonProperty("ephemeral")
     public EphemeralVolumeSource getEphemeral() {
         return ephemeral;
     }
 
+    /**
+     * StorageSpec defines the configured storage for a group Prometheus servers. If no storage option is specified, then by default an [EmptyDir](https://kubernetes.io/docs/concepts/storage/volumes/#emptydir) will be used.<br><p> <br><p> If multiple storage options are specified, priority will be given as follows:<br><p>  1. emptyDir<br><p>  2. ephemeral<br><p>  3. volumeClaimTemplate
+     */
     @JsonProperty("ephemeral")
     public void setEphemeral(EphemeralVolumeSource ephemeral) {
         this.ephemeral = ephemeral;
     }
 
+    /**
+     * StorageSpec defines the configured storage for a group Prometheus servers. If no storage option is specified, then by default an [EmptyDir](https://kubernetes.io/docs/concepts/storage/volumes/#emptydir) will be used.<br><p> <br><p> If multiple storage options are specified, priority will be given as follows:<br><p>  1. emptyDir<br><p>  2. ephemeral<br><p>  3. volumeClaimTemplate
+     */
     @JsonProperty("volumeClaimTemplate")
     public EmbeddedPersistentVolumeClaim getVolumeClaimTemplate() {
         return volumeClaimTemplate;
     }
 
+    /**
+     * StorageSpec defines the configured storage for a group Prometheus servers. If no storage option is specified, then by default an [EmptyDir](https://kubernetes.io/docs/concepts/storage/volumes/#emptydir) will be used.<br><p> <br><p> If multiple storage options are specified, priority will be given as follows:<br><p>  1. emptyDir<br><p>  2. ephemeral<br><p>  3. volumeClaimTemplate
+     */
     @JsonProperty("volumeClaimTemplate")
     public void setVolumeClaimTemplate(EmbeddedPersistentVolumeClaim volumeClaimTemplate) {
         this.volumeClaimTemplate = volumeClaimTemplate;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/TLSConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/TLSConfig.java
index b628d02cb57..c57a104d4fa 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/TLSConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/TLSConfig.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TLSConfig extends the safe TLS configuration with file parameters.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -115,101 +118,161 @@ public TLSConfig(SecretOrConfigMap ca, String caFile, SecretOrConfigMap cert, St
         this.serverName = serverName;
     }
 
+    /**
+     * TLSConfig extends the safe TLS configuration with file parameters.
+     */
     @JsonProperty("ca")
     public SecretOrConfigMap getCa() {
         return ca;
     }
 
+    /**
+     * TLSConfig extends the safe TLS configuration with file parameters.
+     */
     @JsonProperty("ca")
     public void setCa(SecretOrConfigMap ca) {
         this.ca = ca;
     }
 
+    /**
+     * Path to the CA cert in the Prometheus container to use for the targets.
+     */
     @JsonProperty("caFile")
     public String getCaFile() {
         return caFile;
     }
 
+    /**
+     * Path to the CA cert in the Prometheus container to use for the targets.
+     */
     @JsonProperty("caFile")
     public void setCaFile(String caFile) {
         this.caFile = caFile;
     }
 
+    /**
+     * TLSConfig extends the safe TLS configuration with file parameters.
+     */
     @JsonProperty("cert")
     public SecretOrConfigMap getCert() {
         return cert;
     }
 
+    /**
+     * TLSConfig extends the safe TLS configuration with file parameters.
+     */
     @JsonProperty("cert")
     public void setCert(SecretOrConfigMap cert) {
         this.cert = cert;
     }
 
+    /**
+     * Path to the client cert file in the Prometheus container for the targets.
+     */
     @JsonProperty("certFile")
     public String getCertFile() {
         return certFile;
     }
 
+    /**
+     * Path to the client cert file in the Prometheus container for the targets.
+     */
     @JsonProperty("certFile")
     public void setCertFile(String certFile) {
         this.certFile = certFile;
     }
 
+    /**
+     * Disable target certificate validation.
+     */
     @JsonProperty("insecureSkipVerify")
     public Boolean getInsecureSkipVerify() {
         return insecureSkipVerify;
     }
 
+    /**
+     * Disable target certificate validation.
+     */
     @JsonProperty("insecureSkipVerify")
     public void setInsecureSkipVerify(Boolean insecureSkipVerify) {
         this.insecureSkipVerify = insecureSkipVerify;
     }
 
+    /**
+     * Path to the client key file in the Prometheus container for the targets.
+     */
     @JsonProperty("keyFile")
     public String getKeyFile() {
         return keyFile;
     }
 
+    /**
+     * Path to the client key file in the Prometheus container for the targets.
+     */
     @JsonProperty("keyFile")
     public void setKeyFile(String keyFile) {
         this.keyFile = keyFile;
     }
 
+    /**
+     * TLSConfig extends the safe TLS configuration with file parameters.
+     */
     @JsonProperty("keySecret")
     public SecretKeySelector getKeySecret() {
         return keySecret;
     }
 
+    /**
+     * TLSConfig extends the safe TLS configuration with file parameters.
+     */
     @JsonProperty("keySecret")
     public void setKeySecret(SecretKeySelector keySecret) {
         this.keySecret = keySecret;
     }
 
+    /**
+     * Maximum acceptable TLS version.<br><p> <br><p> It requires Prometheus &gt;= v2.41.0.
+     */
     @JsonProperty("maxVersion")
     public String getMaxVersion() {
         return maxVersion;
     }
 
+    /**
+     * Maximum acceptable TLS version.<br><p> <br><p> It requires Prometheus &gt;= v2.41.0.
+     */
     @JsonProperty("maxVersion")
     public void setMaxVersion(String maxVersion) {
         this.maxVersion = maxVersion;
     }
 
+    /**
+     * Minimum acceptable TLS version.<br><p> <br><p> It requires Prometheus &gt;= v2.35.0.
+     */
     @JsonProperty("minVersion")
     public String getMinVersion() {
         return minVersion;
     }
 
+    /**
+     * Minimum acceptable TLS version.<br><p> <br><p> It requires Prometheus &gt;= v2.35.0.
+     */
     @JsonProperty("minVersion")
     public void setMinVersion(String minVersion) {
         this.minVersion = minVersion;
     }
 
+    /**
+     * Used to verify the hostname for the targets.
+     */
     @JsonProperty("serverName")
     public String getServerName() {
         return serverName;
     }
 
+    /**
+     * Used to verify the hostname for the targets.
+     */
     @JsonProperty("serverName")
     public void setServerName(String serverName) {
         this.serverName = serverName;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/TSDBSpec.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/TSDBSpec.java
index 58e33760cf3..4fc4857085d 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/TSDBSpec.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/TSDBSpec.java
@@ -78,11 +78,17 @@ public TSDBSpec(String outOfOrderTimeWindow) {
         this.outOfOrderTimeWindow = outOfOrderTimeWindow;
     }
 
+    /**
+     * Configures how old an out-of-order/out-of-bounds sample can be with respect to the TSDB max time.<br><p> <br><p> An out-of-order/out-of-bounds sample is ingested into the TSDB as long as the timestamp of the sample is &gt;= (TSDB.MaxTime - outOfOrderTimeWindow).<br><p> <br><p> This is an &#42;experimental feature&#42;, it may change in any upcoming release in a breaking way.<br><p> <br><p> It requires Prometheus &gt;= v2.39.0 or PrometheusAgent &gt;= v2.54.0.
+     */
     @JsonProperty("outOfOrderTimeWindow")
     public String getOutOfOrderTimeWindow() {
         return outOfOrderTimeWindow;
     }
 
+    /**
+     * Configures how old an out-of-order/out-of-bounds sample can be with respect to the TSDB max time.<br><p> <br><p> An out-of-order/out-of-bounds sample is ingested into the TSDB as long as the timestamp of the sample is &gt;= (TSDB.MaxTime - outOfOrderTimeWindow).<br><p> <br><p> This is an &#42;experimental feature&#42;, it may change in any upcoming release in a breaking way.<br><p> <br><p> It requires Prometheus &gt;= v2.39.0 or PrometheusAgent &gt;= v2.54.0.
+     */
     @JsonProperty("outOfOrderTimeWindow")
     public void setOutOfOrderTimeWindow(String outOfOrderTimeWindow) {
         this.outOfOrderTimeWindow = outOfOrderTimeWindow;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ThanosRuler.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ThanosRuler.java
index 51f108a4e4e..61737d16c53 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ThanosRuler.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ThanosRuler.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * The `ThanosRuler` custom resource definition (CRD) defines a desired [Thanos Ruler](https://github.com/thanos-io/thanos/blob/main/docs/components/rule.md) setup to run in a Kubernetes cluster.<br><p> <br><p> A `ThanosRuler` instance requires at least one compatible Prometheus API endpoint (either Thanos Querier or Prometheus services).<br><p> <br><p> The resource defines via label and namespace selectors which `PrometheusRule` objects should be associated to the deployed Thanos Ruler instances.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class ThanosRuler implements Editable<ThanosRulerBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "monitoring.coreos.com/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ThanosRuler";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ThanosRuler(String apiVersion, String kind, ObjectMeta metadata, ThanosRu
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * The `ThanosRuler` custom resource definition (CRD) defines a desired [Thanos Ruler](https://github.com/thanos-io/thanos/blob/main/docs/components/rule.md) setup to run in a Kubernetes cluster.<br><p> <br><p> A `ThanosRuler` instance requires at least one compatible Prometheus API endpoint (either Thanos Querier or Prometheus services).<br><p> <br><p> The resource defines via label and namespace selectors which `PrometheusRule` objects should be associated to the deployed Thanos Ruler instances.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * The `ThanosRuler` custom resource definition (CRD) defines a desired [Thanos Ruler](https://github.com/thanos-io/thanos/blob/main/docs/components/rule.md) setup to run in a Kubernetes cluster.<br><p> <br><p> A `ThanosRuler` instance requires at least one compatible Prometheus API endpoint (either Thanos Querier or Prometheus services).<br><p> <br><p> The resource defines via label and namespace selectors which `PrometheusRule` objects should be associated to the deployed Thanos Ruler instances.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * The `ThanosRuler` custom resource definition (CRD) defines a desired [Thanos Ruler](https://github.com/thanos-io/thanos/blob/main/docs/components/rule.md) setup to run in a Kubernetes cluster.<br><p> <br><p> A `ThanosRuler` instance requires at least one compatible Prometheus API endpoint (either Thanos Querier or Prometheus services).<br><p> <br><p> The resource defines via label and namespace selectors which `PrometheusRule` objects should be associated to the deployed Thanos Ruler instances.
+     */
     @JsonProperty("spec")
     public ThanosRulerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * The `ThanosRuler` custom resource definition (CRD) defines a desired [Thanos Ruler](https://github.com/thanos-io/thanos/blob/main/docs/components/rule.md) setup to run in a Kubernetes cluster.<br><p> <br><p> A `ThanosRuler` instance requires at least one compatible Prometheus API endpoint (either Thanos Querier or Prometheus services).<br><p> <br><p> The resource defines via label and namespace selectors which `PrometheusRule` objects should be associated to the deployed Thanos Ruler instances.
+     */
     @JsonProperty("spec")
     public void setSpec(ThanosRulerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * The `ThanosRuler` custom resource definition (CRD) defines a desired [Thanos Ruler](https://github.com/thanos-io/thanos/blob/main/docs/components/rule.md) setup to run in a Kubernetes cluster.<br><p> <br><p> A `ThanosRuler` instance requires at least one compatible Prometheus API endpoint (either Thanos Querier or Prometheus services).<br><p> <br><p> The resource defines via label and namespace selectors which `PrometheusRule` objects should be associated to the deployed Thanos Ruler instances.
+     */
     @JsonProperty("status")
     public ThanosRulerStatus getStatus() {
         return status;
     }
 
+    /**
+     * The `ThanosRuler` custom resource definition (CRD) defines a desired [Thanos Ruler](https://github.com/thanos-io/thanos/blob/main/docs/components/rule.md) setup to run in a Kubernetes cluster.<br><p> <br><p> A `ThanosRuler` instance requires at least one compatible Prometheus API endpoint (either Thanos Querier or Prometheus services).<br><p> <br><p> The resource defines via label and namespace selectors which `PrometheusRule` objects should be associated to the deployed Thanos Ruler instances.
+     */
     @JsonProperty("status")
     public void setStatus(ThanosRulerStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ThanosRulerList.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ThanosRulerList.java
index eca9dfa0ebe..0c309c00ad8 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ThanosRulerList.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ThanosRulerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ThanosRulerList is a list of ThanosRulers.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ThanosRulerList implements Editable<ThanosRulerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.monitoring.v1.ThanosRuler>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "monitoring.coreos.com/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.monitoring.v1.ThanosRuler> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ThanosRulerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ThanosRulerList(String apiVersion, List<io.fabric8.openshift.api.model.mo
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of Prometheuses
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.monitoring.v1.ThanosRuler> getItems() {
         return items;
     }
 
+    /**
+     * List of Prometheuses
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.monitoring.v1.ThanosRuler> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ThanosRulerList is a list of ThanosRulers.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ThanosRulerList is a list of ThanosRulers.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ThanosRulerSpec.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ThanosRulerSpec.java
index 0617dbc77cc..247e7833a31 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ThanosRulerSpec.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ThanosRulerSpec.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -309,547 +312,865 @@ public ThanosRulerSpec(List<Argument> additionalArgs, Affinity affinity, List<St
         this.web = web;
     }
 
+    /**
+     * AdditionalArgs allows setting additional arguments for the ThanosRuler container. It is intended for e.g. activating hidden flags which are not supported by the dedicated configuration options yet. The arguments are passed as-is to the ThanosRuler container which may cause issues if they are invalid or not supported by the given ThanosRuler version. In case of an argument conflict (e.g. an argument which is already set by the operator itself) or when providing an invalid argument the reconciliation will fail and an error will be logged.
+     */
     @JsonProperty("additionalArgs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Argument> getAdditionalArgs() {
         return additionalArgs;
     }
 
+    /**
+     * AdditionalArgs allows setting additional arguments for the ThanosRuler container. It is intended for e.g. activating hidden flags which are not supported by the dedicated configuration options yet. The arguments are passed as-is to the ThanosRuler container which may cause issues if they are invalid or not supported by the given ThanosRuler version. In case of an argument conflict (e.g. an argument which is already set by the operator itself) or when providing an invalid argument the reconciliation will fail and an error will be logged.
+     */
     @JsonProperty("additionalArgs")
     public void setAdditionalArgs(List<Argument> additionalArgs) {
         this.additionalArgs = additionalArgs;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("affinity")
     public Affinity getAffinity() {
         return affinity;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("affinity")
     public void setAffinity(Affinity affinity) {
         this.affinity = affinity;
     }
 
+    /**
+     * Configures the label names which should be dropped in Thanos Ruler alerts.<br><p> <br><p> The replica label `thanos_ruler_replica` will always be dropped from the alerts.
+     */
     @JsonProperty("alertDropLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAlertDropLabels() {
         return alertDropLabels;
     }
 
+    /**
+     * Configures the label names which should be dropped in Thanos Ruler alerts.<br><p> <br><p> The replica label `thanos_ruler_replica` will always be dropped from the alerts.
+     */
     @JsonProperty("alertDropLabels")
     public void setAlertDropLabels(List<String> alertDropLabels) {
         this.alertDropLabels = alertDropLabels;
     }
 
+    /**
+     * The external Query URL the Thanos Ruler will set in the 'Source' field of all alerts. Maps to the '--alert.query-url' CLI arg.
+     */
     @JsonProperty("alertQueryUrl")
     public String getAlertQueryUrl() {
         return alertQueryUrl;
     }
 
+    /**
+     * The external Query URL the Thanos Ruler will set in the 'Source' field of all alerts. Maps to the '--alert.query-url' CLI arg.
+     */
     @JsonProperty("alertQueryUrl")
     public void setAlertQueryUrl(String alertQueryUrl) {
         this.alertQueryUrl = alertQueryUrl;
     }
 
+    /**
+     * Configures the path to the alert relabeling configuration file.<br><p> <br><p> Alert relabel configuration must have the form as specified in the official Prometheus documentation: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#alert_relabel_configs<br><p> <br><p> The operator performs no validation of the configuration file.<br><p> <br><p> This field takes precedence over `alertRelabelConfig`.
+     */
     @JsonProperty("alertRelabelConfigFile")
     public String getAlertRelabelConfigFile() {
         return alertRelabelConfigFile;
     }
 
+    /**
+     * Configures the path to the alert relabeling configuration file.<br><p> <br><p> Alert relabel configuration must have the form as specified in the official Prometheus documentation: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#alert_relabel_configs<br><p> <br><p> The operator performs no validation of the configuration file.<br><p> <br><p> This field takes precedence over `alertRelabelConfig`.
+     */
     @JsonProperty("alertRelabelConfigFile")
     public void setAlertRelabelConfigFile(String alertRelabelConfigFile) {
         this.alertRelabelConfigFile = alertRelabelConfigFile;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("alertRelabelConfigs")
     public SecretKeySelector getAlertRelabelConfigs() {
         return alertRelabelConfigs;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("alertRelabelConfigs")
     public void setAlertRelabelConfigs(SecretKeySelector alertRelabelConfigs) {
         this.alertRelabelConfigs = alertRelabelConfigs;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("alertmanagersConfig")
     public SecretKeySelector getAlertmanagersConfig() {
         return alertmanagersConfig;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("alertmanagersConfig")
     public void setAlertmanagersConfig(SecretKeySelector alertmanagersConfig) {
         this.alertmanagersConfig = alertmanagersConfig;
     }
 
+    /**
+     * Configures the list of Alertmanager endpoints to send alerts to.<br><p> <br><p> For Thanos &gt;= v0.10.0, it is recommended to use `alertmanagersConfig` instead.<br><p> <br><p> `alertmanagersConfig` takes precedence over this field.
+     */
     @JsonProperty("alertmanagersUrl")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAlertmanagersUrl() {
         return alertmanagersUrl;
     }
 
+    /**
+     * Configures the list of Alertmanager endpoints to send alerts to.<br><p> <br><p> For Thanos &gt;= v0.10.0, it is recommended to use `alertmanagersConfig` instead.<br><p> <br><p> `alertmanagersConfig` takes precedence over this field.
+     */
     @JsonProperty("alertmanagersUrl")
     public void setAlertmanagersUrl(List<String> alertmanagersUrl) {
         this.alertmanagersUrl = alertmanagersUrl;
     }
 
+    /**
+     * Containers allows injecting additional containers or modifying operator generated containers. This can be used to allow adding an authentication proxy to a ThanosRuler pod or to change the behavior of an operator generated container. Containers described here modify an operator generated container if they share the same name and modifications are done via a strategic merge patch. The current container names are: `thanos-ruler` and `config-reloader`. Overriding containers is entirely outside the scope of what the maintainers will support and by doing so, you accept that this behaviour may break at any time without notice.
+     */
     @JsonProperty("containers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Container> getContainers() {
         return containers;
     }
 
+    /**
+     * Containers allows injecting additional containers or modifying operator generated containers. This can be used to allow adding an authentication proxy to a ThanosRuler pod or to change the behavior of an operator generated container. Containers described here modify an operator generated container if they share the same name and modifications are done via a strategic merge patch. The current container names are: `thanos-ruler` and `config-reloader`. Overriding containers is entirely outside the scope of what the maintainers will support and by doing so, you accept that this behaviour may break at any time without notice.
+     */
     @JsonProperty("containers")
     public void setContainers(List<Container> containers) {
         this.containers = containers;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("dnsConfig")
     public PodDNSConfig getDnsConfig() {
         return dnsConfig;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("dnsConfig")
     public void setDnsConfig(PodDNSConfig dnsConfig) {
         this.dnsConfig = dnsConfig;
     }
 
+    /**
+     * Defines the DNS policy for the pods.
+     */
     @JsonProperty("dnsPolicy")
     public String getDnsPolicy() {
         return dnsPolicy;
     }
 
+    /**
+     * Defines the DNS policy for the pods.
+     */
     @JsonProperty("dnsPolicy")
     public void setDnsPolicy(String dnsPolicy) {
         this.dnsPolicy = dnsPolicy;
     }
 
+    /**
+     * EnforcedNamespaceLabel enforces adding a namespace label of origin for each alert and metric that is user created. The label value will always be the namespace of the object that is being created.
+     */
     @JsonProperty("enforcedNamespaceLabel")
     public String getEnforcedNamespaceLabel() {
         return enforcedNamespaceLabel;
     }
 
+    /**
+     * EnforcedNamespaceLabel enforces adding a namespace label of origin for each alert and metric that is user created. The label value will always be the namespace of the object that is being created.
+     */
     @JsonProperty("enforcedNamespaceLabel")
     public void setEnforcedNamespaceLabel(String enforcedNamespaceLabel) {
         this.enforcedNamespaceLabel = enforcedNamespaceLabel;
     }
 
+    /**
+     * Interval between consecutive evaluations.
+     */
     @JsonProperty("evaluationInterval")
     public String getEvaluationInterval() {
         return evaluationInterval;
     }
 
+    /**
+     * Interval between consecutive evaluations.
+     */
     @JsonProperty("evaluationInterval")
     public void setEvaluationInterval(String evaluationInterval) {
         this.evaluationInterval = evaluationInterval;
     }
 
+    /**
+     * List of references to PrometheusRule objects to be excluded from enforcing a namespace label of origin. Applies only if enforcedNamespaceLabel set to true.
+     */
     @JsonProperty("excludedFromEnforcement")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ObjectReference> getExcludedFromEnforcement() {
         return excludedFromEnforcement;
     }
 
+    /**
+     * List of references to PrometheusRule objects to be excluded from enforcing a namespace label of origin. Applies only if enforcedNamespaceLabel set to true.
+     */
     @JsonProperty("excludedFromEnforcement")
     public void setExcludedFromEnforcement(List<ObjectReference> excludedFromEnforcement) {
         this.excludedFromEnforcement = excludedFromEnforcement;
     }
 
+    /**
+     * The external URL the Thanos Ruler instances will be available under. This is necessary to generate correct URLs. This is necessary if Thanos Ruler is not served from root of a DNS name.
+     */
     @JsonProperty("externalPrefix")
     public String getExternalPrefix() {
         return externalPrefix;
     }
 
+    /**
+     * The external URL the Thanos Ruler instances will be available under. This is necessary to generate correct URLs. This is necessary if Thanos Ruler is not served from root of a DNS name.
+     */
     @JsonProperty("externalPrefix")
     public void setExternalPrefix(String externalPrefix) {
         this.externalPrefix = externalPrefix;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("grpcServerTlsConfig")
     public TLSConfig getGrpcServerTlsConfig() {
         return grpcServerTlsConfig;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("grpcServerTlsConfig")
     public void setGrpcServerTlsConfig(TLSConfig grpcServerTlsConfig) {
         this.grpcServerTlsConfig = grpcServerTlsConfig;
     }
 
+    /**
+     * Pods' hostAliases configuration
+     */
     @JsonProperty("hostAliases")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HostAlias> getHostAliases() {
         return hostAliases;
     }
 
+    /**
+     * Pods' hostAliases configuration
+     */
     @JsonProperty("hostAliases")
     public void setHostAliases(List<HostAlias> hostAliases) {
         this.hostAliases = hostAliases;
     }
 
+    /**
+     * Thanos container image URL.
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * Thanos container image URL.
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
     }
 
+    /**
+     * Image pull policy for the 'thanos', 'init-config-reloader' and 'config-reloader' containers. See https://kubernetes.io/docs/concepts/containers/images/#image-pull-policy for more details.<br><p> <br><p> Possible enum values:<br><p>  - `"Always"` means that kubelet always attempts to pull the latest image. Container will fail If the pull fails.<br><p>  - `"IfNotPresent"` means that kubelet pulls if the image isn't present on disk. Container will fail if the image isn't present and the pull fails.<br><p>  - `"Never"` means that kubelet never pulls an image, but only uses a local image. Container will fail if the image isn't present
+     */
     @JsonProperty("imagePullPolicy")
     public String getImagePullPolicy() {
         return imagePullPolicy;
     }
 
+    /**
+     * Image pull policy for the 'thanos', 'init-config-reloader' and 'config-reloader' containers. See https://kubernetes.io/docs/concepts/containers/images/#image-pull-policy for more details.<br><p> <br><p> Possible enum values:<br><p>  - `"Always"` means that kubelet always attempts to pull the latest image. Container will fail If the pull fails.<br><p>  - `"IfNotPresent"` means that kubelet pulls if the image isn't present on disk. Container will fail if the image isn't present and the pull fails.<br><p>  - `"Never"` means that kubelet never pulls an image, but only uses a local image. Container will fail if the image isn't present
+     */
     @JsonProperty("imagePullPolicy")
     public void setImagePullPolicy(String imagePullPolicy) {
         this.imagePullPolicy = imagePullPolicy;
     }
 
+    /**
+     * An optional list of references to secrets in the same namespace to use for pulling thanos images from registries see http://kubernetes.io/docs/user-guide/images#specifying-imagepullsecrets-on-a-pod
+     */
     @JsonProperty("imagePullSecrets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LocalObjectReference> getImagePullSecrets() {
         return imagePullSecrets;
     }
 
+    /**
+     * An optional list of references to secrets in the same namespace to use for pulling thanos images from registries see http://kubernetes.io/docs/user-guide/images#specifying-imagepullsecrets-on-a-pod
+     */
     @JsonProperty("imagePullSecrets")
     public void setImagePullSecrets(List<LocalObjectReference> imagePullSecrets) {
         this.imagePullSecrets = imagePullSecrets;
     }
 
+    /**
+     * InitContainers allows adding initContainers to the pod definition. Those can be used to e.g. fetch secrets for injection into the ThanosRuler configuration from external sources. Any errors during the execution of an initContainer will lead to a restart of the Pod. More info: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/ Using initContainers for any use case other then secret fetching is entirely outside the scope of what the maintainers will support and by doing so, you accept that this behaviour may break at any time without notice.
+     */
     @JsonProperty("initContainers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Container> getInitContainers() {
         return initContainers;
     }
 
+    /**
+     * InitContainers allows adding initContainers to the pod definition. Those can be used to e.g. fetch secrets for injection into the ThanosRuler configuration from external sources. Any errors during the execution of an initContainer will lead to a restart of the Pod. More info: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/ Using initContainers for any use case other then secret fetching is entirely outside the scope of what the maintainers will support and by doing so, you accept that this behaviour may break at any time without notice.
+     */
     @JsonProperty("initContainers")
     public void setInitContainers(List<Container> initContainers) {
         this.initContainers = initContainers;
     }
 
+    /**
+     * Configures the external label pairs of the ThanosRuler resource.<br><p> <br><p> A default replica label `thanos_ruler_replica` will be always added as a label with the value of the pod's name.
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabels() {
         return labels;
     }
 
+    /**
+     * Configures the external label pairs of the ThanosRuler resource.<br><p> <br><p> A default replica label `thanos_ruler_replica` will be always added as a label with the value of the pod's name.
+     */
     @JsonProperty("labels")
     public void setLabels(Map<String, String> labels) {
         this.labels = labels;
     }
 
+    /**
+     * ListenLocal makes the Thanos ruler listen on loopback, so that it does not bind against the Pod IP.
+     */
     @JsonProperty("listenLocal")
     public Boolean getListenLocal() {
         return listenLocal;
     }
 
+    /**
+     * ListenLocal makes the Thanos ruler listen on loopback, so that it does not bind against the Pod IP.
+     */
     @JsonProperty("listenLocal")
     public void setListenLocal(Boolean listenLocal) {
         this.listenLocal = listenLocal;
     }
 
+    /**
+     * Log format for ThanosRuler to be configured with.
+     */
     @JsonProperty("logFormat")
     public String getLogFormat() {
         return logFormat;
     }
 
+    /**
+     * Log format for ThanosRuler to be configured with.
+     */
     @JsonProperty("logFormat")
     public void setLogFormat(String logFormat) {
         this.logFormat = logFormat;
     }
 
+    /**
+     * Log level for ThanosRuler to be configured with.
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * Log level for ThanosRuler to be configured with.
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * Minimum number of seconds for which a newly created pod should be ready without any of its container crashing for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready) This is an alpha field from kubernetes 1.22 until 1.24 which requires enabling the StatefulSetMinReadySeconds feature gate.
+     */
     @JsonProperty("minReadySeconds")
     public Long getMinReadySeconds() {
         return minReadySeconds;
     }
 
+    /**
+     * Minimum number of seconds for which a newly created pod should be ready without any of its container crashing for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready) This is an alpha field from kubernetes 1.22 until 1.24 which requires enabling the StatefulSetMinReadySeconds feature gate.
+     */
     @JsonProperty("minReadySeconds")
     public void setMinReadySeconds(Long minReadySeconds) {
         this.minReadySeconds = minReadySeconds;
     }
 
+    /**
+     * Define which Nodes the Pods are scheduled on.
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * Define which Nodes the Pods are scheduled on.
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("objectStorageConfig")
     public SecretKeySelector getObjectStorageConfig() {
         return objectStorageConfig;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("objectStorageConfig")
     public void setObjectStorageConfig(SecretKeySelector objectStorageConfig) {
         this.objectStorageConfig = objectStorageConfig;
     }
 
+    /**
+     * Configures the path of the object storage configuration file.<br><p> <br><p> The configuration format is defined at https://thanos.io/tip/thanos/storage.md/#configuring-access-to-object-storage<br><p> <br><p> The operator performs no validation of the configuration file.<br><p> <br><p> This field takes precedence over `objectStorageConfig`.
+     */
     @JsonProperty("objectStorageConfigFile")
     public String getObjectStorageConfigFile() {
         return objectStorageConfigFile;
     }
 
+    /**
+     * Configures the path of the object storage configuration file.<br><p> <br><p> The configuration format is defined at https://thanos.io/tip/thanos/storage.md/#configuring-access-to-object-storage<br><p> <br><p> The operator performs no validation of the configuration file.<br><p> <br><p> This field takes precedence over `objectStorageConfig`.
+     */
     @JsonProperty("objectStorageConfigFile")
     public void setObjectStorageConfigFile(String objectStorageConfigFile) {
         this.objectStorageConfigFile = objectStorageConfigFile;
     }
 
+    /**
+     * When a ThanosRuler deployment is paused, no actions except for deletion will be performed on the underlying objects.
+     */
     @JsonProperty("paused")
     public Boolean getPaused() {
         return paused;
     }
 
+    /**
+     * When a ThanosRuler deployment is paused, no actions except for deletion will be performed on the underlying objects.
+     */
     @JsonProperty("paused")
     public void setPaused(Boolean paused) {
         this.paused = paused;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("podMetadata")
     public EmbeddedObjectMetadata getPodMetadata() {
         return podMetadata;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("podMetadata")
     public void setPodMetadata(EmbeddedObjectMetadata podMetadata) {
         this.podMetadata = podMetadata;
     }
 
+    /**
+     * Port name used for the pods and governing service. Defaults to `web`.
+     */
     @JsonProperty("portName")
     public String getPortName() {
         return portName;
     }
 
+    /**
+     * Port name used for the pods and governing service. Defaults to `web`.
+     */
     @JsonProperty("portName")
     public void setPortName(String portName) {
         this.portName = portName;
     }
 
+    /**
+     * Priority class assigned to the Pods
+     */
     @JsonProperty("priorityClassName")
     public String getPriorityClassName() {
         return priorityClassName;
     }
 
+    /**
+     * Priority class assigned to the Pods
+     */
     @JsonProperty("priorityClassName")
     public void setPriorityClassName(String priorityClassName) {
         this.priorityClassName = priorityClassName;
     }
 
+    /**
+     * PrometheusRulesExcludedFromEnforce - list of Prometheus rules to be excluded from enforcing of adding namespace labels. Works only if enforcedNamespaceLabel set to true. Make sure both ruleNamespace and ruleName are set for each pair Deprecated: use excludedFromEnforcement instead.
+     */
     @JsonProperty("prometheusRulesExcludedFromEnforce")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PrometheusRuleExcludeConfig> getPrometheusRulesExcludedFromEnforce() {
         return prometheusRulesExcludedFromEnforce;
     }
 
+    /**
+     * PrometheusRulesExcludedFromEnforce - list of Prometheus rules to be excluded from enforcing of adding namespace labels. Works only if enforcedNamespaceLabel set to true. Make sure both ruleNamespace and ruleName are set for each pair Deprecated: use excludedFromEnforcement instead.
+     */
     @JsonProperty("prometheusRulesExcludedFromEnforce")
     public void setPrometheusRulesExcludedFromEnforce(List<PrometheusRuleExcludeConfig> prometheusRulesExcludedFromEnforce) {
         this.prometheusRulesExcludedFromEnforce = prometheusRulesExcludedFromEnforce;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("queryConfig")
     public SecretKeySelector getQueryConfig() {
         return queryConfig;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("queryConfig")
     public void setQueryConfig(SecretKeySelector queryConfig) {
         this.queryConfig = queryConfig;
     }
 
+    /**
+     * Configures the list of Thanos Query endpoints from which to query metrics.<br><p> <br><p> For Thanos &gt;= v0.11.0, it is recommended to use `queryConfig` instead.<br><p> <br><p> `queryConfig` takes precedence over this field.
+     */
     @JsonProperty("queryEndpoints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getQueryEndpoints() {
         return queryEndpoints;
     }
 
+    /**
+     * Configures the list of Thanos Query endpoints from which to query metrics.<br><p> <br><p> For Thanos &gt;= v0.11.0, it is recommended to use `queryConfig` instead.<br><p> <br><p> `queryConfig` takes precedence over this field.
+     */
     @JsonProperty("queryEndpoints")
     public void setQueryEndpoints(List<String> queryEndpoints) {
         this.queryEndpoints = queryEndpoints;
     }
 
+    /**
+     * Number of thanos ruler instances to deploy.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Number of thanos ruler instances to deploy.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * Time duration ThanosRuler shall retain data for. Default is '24h', and must match the regular expression `[0-9]+(ms|s|m|h|d|w|y)` (milliseconds seconds minutes hours days weeks years).
+     */
     @JsonProperty("retention")
     public String getRetention() {
         return retention;
     }
 
+    /**
+     * Time duration ThanosRuler shall retain data for. Default is '24h', and must match the regular expression `[0-9]+(ms|s|m|h|d|w|y)` (milliseconds seconds minutes hours days weeks years).
+     */
     @JsonProperty("retention")
     public void setRetention(String retention) {
         this.retention = retention;
     }
 
+    /**
+     * The route prefix ThanosRuler registers HTTP handlers for. This allows thanos UI to be served on a sub-path.
+     */
     @JsonProperty("routePrefix")
     public String getRoutePrefix() {
         return routePrefix;
     }
 
+    /**
+     * The route prefix ThanosRuler registers HTTP handlers for. This allows thanos UI to be served on a sub-path.
+     */
     @JsonProperty("routePrefix")
     public void setRoutePrefix(String routePrefix) {
         this.routePrefix = routePrefix;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("ruleNamespaceSelector")
     public LabelSelector getRuleNamespaceSelector() {
         return ruleNamespaceSelector;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("ruleNamespaceSelector")
     public void setRuleNamespaceSelector(LabelSelector ruleNamespaceSelector) {
         this.ruleNamespaceSelector = ruleNamespaceSelector;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("ruleSelector")
     public LabelSelector getRuleSelector() {
         return ruleSelector;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("ruleSelector")
     public void setRuleSelector(LabelSelector ruleSelector) {
         this.ruleSelector = ruleSelector;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("securityContext")
     public PodSecurityContext getSecurityContext() {
         return securityContext;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("securityContext")
     public void setSecurityContext(PodSecurityContext securityContext) {
         this.securityContext = securityContext;
     }
 
+    /**
+     * ServiceAccountName is the name of the ServiceAccount to use to run the Thanos Ruler Pods.
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * ServiceAccountName is the name of the ServiceAccount to use to run the Thanos Ruler Pods.
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("storage")
     public StorageSpec getStorage() {
         return storage;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("storage")
     public void setStorage(StorageSpec storage) {
         this.storage = storage;
     }
 
+    /**
+     * If specified, the pod's tolerations.
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * If specified, the pod's tolerations.
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
     }
 
+    /**
+     * If specified, the pod's topology spread constraints.
+     */
     @JsonProperty("topologySpreadConstraints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TopologySpreadConstraint> getTopologySpreadConstraints() {
         return topologySpreadConstraints;
     }
 
+    /**
+     * If specified, the pod's topology spread constraints.
+     */
     @JsonProperty("topologySpreadConstraints")
     public void setTopologySpreadConstraints(List<TopologySpreadConstraint> topologySpreadConstraints) {
         this.topologySpreadConstraints = topologySpreadConstraints;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("tracingConfig")
     public SecretKeySelector getTracingConfig() {
         return tracingConfig;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("tracingConfig")
     public void setTracingConfig(SecretKeySelector tracingConfig) {
         this.tracingConfig = tracingConfig;
     }
 
+    /**
+     * Configures the path of the tracing configuration file.<br><p> <br><p> The configuration format is defined at https://thanos.io/tip/thanos/tracing.md/#configuration<br><p> <br><p> This is an &#42;experimental feature&#42;, it may change in any upcoming release in a breaking way.<br><p> <br><p> The operator performs no validation of the configuration file.<br><p> <br><p> This field takes precedence over `tracingConfig`.
+     */
     @JsonProperty("tracingConfigFile")
     public String getTracingConfigFile() {
         return tracingConfigFile;
     }
 
+    /**
+     * Configures the path of the tracing configuration file.<br><p> <br><p> The configuration format is defined at https://thanos.io/tip/thanos/tracing.md/#configuration<br><p> <br><p> This is an &#42;experimental feature&#42;, it may change in any upcoming release in a breaking way.<br><p> <br><p> The operator performs no validation of the configuration file.<br><p> <br><p> This field takes precedence over `tracingConfig`.
+     */
     @JsonProperty("tracingConfigFile")
     public void setTracingConfigFile(String tracingConfigFile) {
         this.tracingConfigFile = tracingConfigFile;
     }
 
+    /**
+     * Version of Thanos to be deployed.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * Version of Thanos to be deployed.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
     }
 
+    /**
+     * VolumeMounts allows configuration of additional VolumeMounts on the output StatefulSet definition. VolumeMounts specified will be appended to other VolumeMounts in the ruler container, that are generated as a result of StorageSpec objects.
+     */
     @JsonProperty("volumeMounts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VolumeMount> getVolumeMounts() {
         return volumeMounts;
     }
 
+    /**
+     * VolumeMounts allows configuration of additional VolumeMounts on the output StatefulSet definition. VolumeMounts specified will be appended to other VolumeMounts in the ruler container, that are generated as a result of StorageSpec objects.
+     */
     @JsonProperty("volumeMounts")
     public void setVolumeMounts(List<VolumeMount> volumeMounts) {
         this.volumeMounts = volumeMounts;
     }
 
+    /**
+     * Volumes allows configuration of additional volumes on the output StatefulSet definition. Volumes specified will be appended to other volumes that are generated as a result of StorageSpec objects.
+     */
     @JsonProperty("volumes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Volume> getVolumes() {
         return volumes;
     }
 
+    /**
+     * Volumes allows configuration of additional volumes on the output StatefulSet definition. Volumes specified will be appended to other volumes that are generated as a result of StorageSpec objects.
+     */
     @JsonProperty("volumes")
     public void setVolumes(List<Volume> volumes) {
         this.volumes = volumes;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("web")
     public ThanosRulerWebSpec getWeb() {
         return web;
     }
 
+    /**
+     * ThanosRulerSpec is a specification of the desired behavior of the ThanosRuler. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("web")
     public void setWeb(ThanosRulerWebSpec web) {
         this.web = web;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ThanosRulerStatus.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ThanosRulerStatus.java
index 28125226237..c519e93f689 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ThanosRulerStatus.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ThanosRulerStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ThanosRulerStatus is the most recent observed status of the ThanosRuler. Read-only. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,62 +104,98 @@ public ThanosRulerStatus(Integer availableReplicas, List<Condition> conditions,
         this.updatedReplicas = updatedReplicas;
     }
 
+    /**
+     * Total number of available pods (ready for at least minReadySeconds) targeted by this ThanosRuler deployment.
+     */
     @JsonProperty("availableReplicas")
     public Integer getAvailableReplicas() {
         return availableReplicas;
     }
 
+    /**
+     * Total number of available pods (ready for at least minReadySeconds) targeted by this ThanosRuler deployment.
+     */
     @JsonProperty("availableReplicas")
     public void setAvailableReplicas(Integer availableReplicas) {
         this.availableReplicas = availableReplicas;
     }
 
+    /**
+     * The current state of the ThanosRuler object.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * The current state of the ThanosRuler object.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Represents whether any actions on the underlying managed objects are being performed. Only delete actions will be performed.
+     */
     @JsonProperty("paused")
     public Boolean getPaused() {
         return paused;
     }
 
+    /**
+     * Represents whether any actions on the underlying managed objects are being performed. Only delete actions will be performed.
+     */
     @JsonProperty("paused")
     public void setPaused(Boolean paused) {
         this.paused = paused;
     }
 
+    /**
+     * Total number of non-terminated pods targeted by this ThanosRuler deployment (their labels match the selector).
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Total number of non-terminated pods targeted by this ThanosRuler deployment (their labels match the selector).
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * Total number of unavailable pods targeted by this ThanosRuler deployment.
+     */
     @JsonProperty("unavailableReplicas")
     public Integer getUnavailableReplicas() {
         return unavailableReplicas;
     }
 
+    /**
+     * Total number of unavailable pods targeted by this ThanosRuler deployment.
+     */
     @JsonProperty("unavailableReplicas")
     public void setUnavailableReplicas(Integer unavailableReplicas) {
         this.unavailableReplicas = unavailableReplicas;
     }
 
+    /**
+     * Total number of non-terminated pods targeted by this ThanosRuler deployment that have the desired version spec.
+     */
     @JsonProperty("updatedReplicas")
     public Integer getUpdatedReplicas() {
         return updatedReplicas;
     }
 
+    /**
+     * Total number of non-terminated pods targeted by this ThanosRuler deployment that have the desired version spec.
+     */
     @JsonProperty("updatedReplicas")
     public void setUpdatedReplicas(Integer updatedReplicas) {
         this.updatedReplicas = updatedReplicas;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ThanosRulerWebSpec.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ThanosRulerWebSpec.java
index 78e66d9fc5f..d2fe26e2d0c 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ThanosRulerWebSpec.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ThanosRulerWebSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ThanosRulerWebSpec defines the configuration of the ThanosRuler web server.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ThanosRulerWebSpec(WebHTTPConfig httpConfig, WebTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * ThanosRulerWebSpec defines the configuration of the ThanosRuler web server.
+     */
     @JsonProperty("httpConfig")
     public WebHTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * ThanosRulerWebSpec defines the configuration of the ThanosRuler web server.
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(WebHTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * ThanosRulerWebSpec defines the configuration of the ThanosRuler web server.
+     */
     @JsonProperty("tlsConfig")
     public WebTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * ThanosRulerWebSpec defines the configuration of the ThanosRuler web server.
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(WebTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ThanosSpec.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ThanosSpec.java
index db9923133a6..fa801e300a0 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ThanosSpec.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/ThanosSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ThanosSpec defines the configuration of the Thanos sidecar.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -171,233 +174,371 @@ public ThanosSpec(List<Argument> additionalArgs, String baseImage, String blockS
         this.volumeMounts = volumeMounts;
     }
 
+    /**
+     * AdditionalArgs allows setting additional arguments for the Thanos container. The arguments are passed as-is to the Thanos container which may cause issues if they are invalid or not supported the given Thanos version. In case of an argument conflict (e.g. an argument which is already set by the operator itself) or when providing an invalid argument, the reconciliation will fail and an error will be logged.
+     */
     @JsonProperty("additionalArgs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Argument> getAdditionalArgs() {
         return additionalArgs;
     }
 
+    /**
+     * AdditionalArgs allows setting additional arguments for the Thanos container. The arguments are passed as-is to the Thanos container which may cause issues if they are invalid or not supported the given Thanos version. In case of an argument conflict (e.g. an argument which is already set by the operator itself) or when providing an invalid argument, the reconciliation will fail and an error will be logged.
+     */
     @JsonProperty("additionalArgs")
     public void setAdditionalArgs(List<Argument> additionalArgs) {
         this.additionalArgs = additionalArgs;
     }
 
+    /**
+     * Deprecated: use 'image' instead.
+     */
     @JsonProperty("baseImage")
     public String getBaseImage() {
         return baseImage;
     }
 
+    /**
+     * Deprecated: use 'image' instead.
+     */
     @JsonProperty("baseImage")
     public void setBaseImage(String baseImage) {
         this.baseImage = baseImage;
     }
 
+    /**
+     * BlockDuration controls the size of TSDB blocks produced by Prometheus. The default value is 2h to match the upstream Prometheus defaults.<br><p> <br><p> WARNING: Changing the block duration can impact the performance and efficiency of the entire Prometheus/Thanos stack due to how it interacts with memory and Thanos compactors. It is recommended to keep this value set to a multiple of 120 times your longest scrape or rule interval. For example, 30s &#42; 120 = 1h.
+     */
     @JsonProperty("blockSize")
     public String getBlockSize() {
         return blockSize;
     }
 
+    /**
+     * BlockDuration controls the size of TSDB blocks produced by Prometheus. The default value is 2h to match the upstream Prometheus defaults.<br><p> <br><p> WARNING: Changing the block duration can impact the performance and efficiency of the entire Prometheus/Thanos stack due to how it interacts with memory and Thanos compactors. It is recommended to keep this value set to a multiple of 120 times your longest scrape or rule interval. For example, 30s &#42; 120 = 1h.
+     */
     @JsonProperty("blockSize")
     public void setBlockSize(String blockSize) {
         this.blockSize = blockSize;
     }
 
+    /**
+     * How often to retrieve the Prometheus configuration.
+     */
     @JsonProperty("getConfigInterval")
     public String getGetConfigInterval() {
         return getConfigInterval;
     }
 
+    /**
+     * How often to retrieve the Prometheus configuration.
+     */
     @JsonProperty("getConfigInterval")
     public void setGetConfigInterval(String getConfigInterval) {
         this.getConfigInterval = getConfigInterval;
     }
 
+    /**
+     * Maximum time to wait when retrieving the Prometheus configuration.
+     */
     @JsonProperty("getConfigTimeout")
     public String getGetConfigTimeout() {
         return getConfigTimeout;
     }
 
+    /**
+     * Maximum time to wait when retrieving the Prometheus configuration.
+     */
     @JsonProperty("getConfigTimeout")
     public void setGetConfigTimeout(String getConfigTimeout) {
         this.getConfigTimeout = getConfigTimeout;
     }
 
+    /**
+     * When true, the Thanos sidecar listens on the loopback interface instead of the Pod IP's address for the gRPC endpoints.<br><p> <br><p> It has no effect if `listenLocal` is true.
+     */
     @JsonProperty("grpcListenLocal")
     public Boolean getGrpcListenLocal() {
         return grpcListenLocal;
     }
 
+    /**
+     * When true, the Thanos sidecar listens on the loopback interface instead of the Pod IP's address for the gRPC endpoints.<br><p> <br><p> It has no effect if `listenLocal` is true.
+     */
     @JsonProperty("grpcListenLocal")
     public void setGrpcListenLocal(Boolean grpcListenLocal) {
         this.grpcListenLocal = grpcListenLocal;
     }
 
+    /**
+     * ThanosSpec defines the configuration of the Thanos sidecar.
+     */
     @JsonProperty("grpcServerTlsConfig")
     public TLSConfig getGrpcServerTlsConfig() {
         return grpcServerTlsConfig;
     }
 
+    /**
+     * ThanosSpec defines the configuration of the Thanos sidecar.
+     */
     @JsonProperty("grpcServerTlsConfig")
     public void setGrpcServerTlsConfig(TLSConfig grpcServerTlsConfig) {
         this.grpcServerTlsConfig = grpcServerTlsConfig;
     }
 
+    /**
+     * When true, the Thanos sidecar listens on the loopback interface instead of the Pod IP's address for the HTTP endpoints.<br><p> <br><p> It has no effect if `listenLocal` is true.
+     */
     @JsonProperty("httpListenLocal")
     public Boolean getHttpListenLocal() {
         return httpListenLocal;
     }
 
+    /**
+     * When true, the Thanos sidecar listens on the loopback interface instead of the Pod IP's address for the HTTP endpoints.<br><p> <br><p> It has no effect if `listenLocal` is true.
+     */
     @JsonProperty("httpListenLocal")
     public void setHttpListenLocal(Boolean httpListenLocal) {
         this.httpListenLocal = httpListenLocal;
     }
 
+    /**
+     * Container image name for Thanos. If specified, it takes precedence over the `spec.thanos.baseImage`, `spec.thanos.tag` and `spec.thanos.sha` fields.<br><p> <br><p> Specifying `spec.thanos.version` is still necessary to ensure the Prometheus Operator knows which version of Thanos is being configured.<br><p> <br><p> If neither `spec.thanos.image` nor `spec.thanos.baseImage` are defined, the operator will use the latest upstream version of Thanos available at the time when the operator was released.
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * Container image name for Thanos. If specified, it takes precedence over the `spec.thanos.baseImage`, `spec.thanos.tag` and `spec.thanos.sha` fields.<br><p> <br><p> Specifying `spec.thanos.version` is still necessary to ensure the Prometheus Operator knows which version of Thanos is being configured.<br><p> <br><p> If neither `spec.thanos.image` nor `spec.thanos.baseImage` are defined, the operator will use the latest upstream version of Thanos available at the time when the operator was released.
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
     }
 
+    /**
+     * Deprecated: use `grpcListenLocal` and `httpListenLocal` instead.
+     */
     @JsonProperty("listenLocal")
     public Boolean getListenLocal() {
         return listenLocal;
     }
 
+    /**
+     * Deprecated: use `grpcListenLocal` and `httpListenLocal` instead.
+     */
     @JsonProperty("listenLocal")
     public void setListenLocal(Boolean listenLocal) {
         this.listenLocal = listenLocal;
     }
 
+    /**
+     * Log format for the Thanos sidecar.
+     */
     @JsonProperty("logFormat")
     public String getLogFormat() {
         return logFormat;
     }
 
+    /**
+     * Log format for the Thanos sidecar.
+     */
     @JsonProperty("logFormat")
     public void setLogFormat(String logFormat) {
         this.logFormat = logFormat;
     }
 
+    /**
+     * Log level for the Thanos sidecar.
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * Log level for the Thanos sidecar.
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * Defines the start of time range limit served by the Thanos sidecar's StoreAPI. The field's value should be a constant time in RFC3339 format or a time duration relative to current time, such as -1d or 2h45m. Valid duration units are ms, s, m, h, d, w, y.
+     */
     @JsonProperty("minTime")
     public String getMinTime() {
         return minTime;
     }
 
+    /**
+     * Defines the start of time range limit served by the Thanos sidecar's StoreAPI. The field's value should be a constant time in RFC3339 format or a time duration relative to current time, such as -1d or 2h45m. Valid duration units are ms, s, m, h, d, w, y.
+     */
     @JsonProperty("minTime")
     public void setMinTime(String minTime) {
         this.minTime = minTime;
     }
 
+    /**
+     * ThanosSpec defines the configuration of the Thanos sidecar.
+     */
     @JsonProperty("objectStorageConfig")
     public SecretKeySelector getObjectStorageConfig() {
         return objectStorageConfig;
     }
 
+    /**
+     * ThanosSpec defines the configuration of the Thanos sidecar.
+     */
     @JsonProperty("objectStorageConfig")
     public void setObjectStorageConfig(SecretKeySelector objectStorageConfig) {
         this.objectStorageConfig = objectStorageConfig;
     }
 
+    /**
+     * Defines the Thanos sidecar's configuration file to upload TSDB blocks to object storage.<br><p> <br><p> More info: https://thanos.io/tip/thanos/storage.md/<br><p> <br><p> This field takes precedence over objectStorageConfig.
+     */
     @JsonProperty("objectStorageConfigFile")
     public String getObjectStorageConfigFile() {
         return objectStorageConfigFile;
     }
 
+    /**
+     * Defines the Thanos sidecar's configuration file to upload TSDB blocks to object storage.<br><p> <br><p> More info: https://thanos.io/tip/thanos/storage.md/<br><p> <br><p> This field takes precedence over objectStorageConfig.
+     */
     @JsonProperty("objectStorageConfigFile")
     public void setObjectStorageConfigFile(String objectStorageConfigFile) {
         this.objectStorageConfigFile = objectStorageConfigFile;
     }
 
+    /**
+     * ReadyTimeout is the maximum time that the Thanos sidecar will wait for Prometheus to start.
+     */
     @JsonProperty("readyTimeout")
     public String getReadyTimeout() {
         return readyTimeout;
     }
 
+    /**
+     * ReadyTimeout is the maximum time that the Thanos sidecar will wait for Prometheus to start.
+     */
     @JsonProperty("readyTimeout")
     public void setReadyTimeout(String readyTimeout) {
         this.readyTimeout = readyTimeout;
     }
 
+    /**
+     * ThanosSpec defines the configuration of the Thanos sidecar.
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * ThanosSpec defines the configuration of the Thanos sidecar.
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * Deprecated: use 'image' instead.  The image digest can be specified as part of the image name.
+     */
     @JsonProperty("sha")
     public String getSha() {
         return sha;
     }
 
+    /**
+     * Deprecated: use 'image' instead.  The image digest can be specified as part of the image name.
+     */
     @JsonProperty("sha")
     public void setSha(String sha) {
         this.sha = sha;
     }
 
+    /**
+     * Deprecated: use 'image' instead. The image's tag can be specified as as part of the image name.
+     */
     @JsonProperty("tag")
     public String getTag() {
         return tag;
     }
 
+    /**
+     * Deprecated: use 'image' instead. The image's tag can be specified as as part of the image name.
+     */
     @JsonProperty("tag")
     public void setTag(String tag) {
         this.tag = tag;
     }
 
+    /**
+     * ThanosSpec defines the configuration of the Thanos sidecar.
+     */
     @JsonProperty("tracingConfig")
     public SecretKeySelector getTracingConfig() {
         return tracingConfig;
     }
 
+    /**
+     * ThanosSpec defines the configuration of the Thanos sidecar.
+     */
     @JsonProperty("tracingConfig")
     public void setTracingConfig(SecretKeySelector tracingConfig) {
         this.tracingConfig = tracingConfig;
     }
 
+    /**
+     * Defines the tracing configuration file for the Thanos sidecar.<br><p> <br><p> This field takes precedence over `tracingConfig`.<br><p> <br><p> More info: https://thanos.io/tip/thanos/tracing.md/<br><p> <br><p> This is an &#42;experimental feature&#42;, it may change in any upcoming release in a breaking way.
+     */
     @JsonProperty("tracingConfigFile")
     public String getTracingConfigFile() {
         return tracingConfigFile;
     }
 
+    /**
+     * Defines the tracing configuration file for the Thanos sidecar.<br><p> <br><p> This field takes precedence over `tracingConfig`.<br><p> <br><p> More info: https://thanos.io/tip/thanos/tracing.md/<br><p> <br><p> This is an &#42;experimental feature&#42;, it may change in any upcoming release in a breaking way.
+     */
     @JsonProperty("tracingConfigFile")
     public void setTracingConfigFile(String tracingConfigFile) {
         this.tracingConfigFile = tracingConfigFile;
     }
 
+    /**
+     * Version of Thanos being deployed. The operator uses this information to generate the Prometheus StatefulSet + configuration files.<br><p> <br><p> If not specified, the operator assumes the latest upstream release of Thanos available at the time when the version of the operator was released.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * Version of Thanos being deployed. The operator uses this information to generate the Prometheus StatefulSet + configuration files.<br><p> <br><p> If not specified, the operator assumes the latest upstream release of Thanos available at the time when the version of the operator was released.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
     }
 
+    /**
+     * VolumeMounts allows configuration of additional VolumeMounts for Thanos. VolumeMounts specified will be appended to other VolumeMounts in the 'thanos-sidecar' container.
+     */
     @JsonProperty("volumeMounts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VolumeMount> getVolumeMounts() {
         return volumeMounts;
     }
 
+    /**
+     * VolumeMounts allows configuration of additional VolumeMounts for Thanos. VolumeMounts specified will be appended to other VolumeMounts in the 'thanos-sidecar' container.
+     */
     @JsonProperty("volumeMounts")
     public void setVolumeMounts(List<VolumeMount> volumeMounts) {
         this.volumeMounts = volumeMounts;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/TopologySpreadConstraint.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/TopologySpreadConstraint.java
index 9b2f87492d3..eac5b36de7b 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/TopologySpreadConstraint.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/TopologySpreadConstraint.java
@@ -113,11 +113,17 @@ public TopologySpreadConstraint(String additionalLabelSelectors, LabelSelector l
         this.whenUnsatisfiable = whenUnsatisfiable;
     }
 
+    /**
+     * Defines what Prometheus Operator managed labels should be added to labelSelector on the topologySpreadConstraint.
+     */
     @JsonProperty("additionalLabelSelectors")
     public String getAdditionalLabelSelectors() {
         return additionalLabelSelectors;
     }
 
+    /**
+     * Defines what Prometheus Operator managed labels should be added to labelSelector on the topologySpreadConstraint.
+     */
     @JsonProperty("additionalLabelSelectors")
     public void setAdditionalLabelSelectors(String additionalLabelSelectors) {
         this.additionalLabelSelectors = additionalLabelSelectors;
@@ -133,72 +139,114 @@ public void setLabelSelector(LabelSelector labelSelector) {
         this.labelSelector = labelSelector;
     }
 
+    /**
+     * MatchLabelKeys is a set of pod label keys to select the pods over which spreading will be calculated. The keys are used to lookup values from the incoming pod labels, those key-value labels are ANDed with labelSelector to select the group of existing pods over which spreading will be calculated for the incoming pod. The same key is forbidden to exist in both MatchLabelKeys and LabelSelector. MatchLabelKeys cannot be set when LabelSelector isn't set. Keys that don't exist in the incoming pod labels will be ignored. A null or empty list means only match against labelSelector.<br><p> <br><p> This is a beta field and requires the MatchLabelKeysInPodTopologySpread feature gate to be enabled (enabled by default).
+     */
     @JsonProperty("matchLabelKeys")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMatchLabelKeys() {
         return matchLabelKeys;
     }
 
+    /**
+     * MatchLabelKeys is a set of pod label keys to select the pods over which spreading will be calculated. The keys are used to lookup values from the incoming pod labels, those key-value labels are ANDed with labelSelector to select the group of existing pods over which spreading will be calculated for the incoming pod. The same key is forbidden to exist in both MatchLabelKeys and LabelSelector. MatchLabelKeys cannot be set when LabelSelector isn't set. Keys that don't exist in the incoming pod labels will be ignored. A null or empty list means only match against labelSelector.<br><p> <br><p> This is a beta field and requires the MatchLabelKeysInPodTopologySpread feature gate to be enabled (enabled by default).
+     */
     @JsonProperty("matchLabelKeys")
     public void setMatchLabelKeys(List<String> matchLabelKeys) {
         this.matchLabelKeys = matchLabelKeys;
     }
 
+    /**
+     * MaxSkew describes the degree to which pods may be unevenly distributed. When `whenUnsatisfiable=DoNotSchedule`, it is the maximum permitted difference between the number of matching pods in the target topology and the global minimum. The global minimum is the minimum number of matching pods in an eligible domain or zero if the number of eligible domains is less than MinDomains. For example, in a 3-zone cluster, MaxSkew is set to 1, and pods with the same labelSelector spread as 2/2/1: In this case, the global minimum is 1. | zone1 | zone2 | zone3 | |  P P  |  P P  |   P   | - if MaxSkew is 1, incoming pod can only be scheduled to zone3 to become 2/2/2; scheduling it onto zone1(zone2) would make the ActualSkew(3-1) on zone1(zone2) violate MaxSkew(1). - if MaxSkew is 2, incoming pod can be scheduled onto any zone. When `whenUnsatisfiable=ScheduleAnyway`, it is used to give higher precedence to topologies that satisfy it. It's a required field. Default value is 1 and 0 is not allowed.
+     */
     @JsonProperty("maxSkew")
     public Integer getMaxSkew() {
         return maxSkew;
     }
 
+    /**
+     * MaxSkew describes the degree to which pods may be unevenly distributed. When `whenUnsatisfiable=DoNotSchedule`, it is the maximum permitted difference between the number of matching pods in the target topology and the global minimum. The global minimum is the minimum number of matching pods in an eligible domain or zero if the number of eligible domains is less than MinDomains. For example, in a 3-zone cluster, MaxSkew is set to 1, and pods with the same labelSelector spread as 2/2/1: In this case, the global minimum is 1. | zone1 | zone2 | zone3 | |  P P  |  P P  |   P   | - if MaxSkew is 1, incoming pod can only be scheduled to zone3 to become 2/2/2; scheduling it onto zone1(zone2) would make the ActualSkew(3-1) on zone1(zone2) violate MaxSkew(1). - if MaxSkew is 2, incoming pod can be scheduled onto any zone. When `whenUnsatisfiable=ScheduleAnyway`, it is used to give higher precedence to topologies that satisfy it. It's a required field. Default value is 1 and 0 is not allowed.
+     */
     @JsonProperty("maxSkew")
     public void setMaxSkew(Integer maxSkew) {
         this.maxSkew = maxSkew;
     }
 
+    /**
+     * MinDomains indicates a minimum number of eligible domains. When the number of eligible domains with matching topology keys is less than minDomains, Pod Topology Spread treats "global minimum" as 0, and then the calculation of Skew is performed. And when the number of eligible domains with matching topology keys equals or greater than minDomains, this value has no effect on scheduling. As a result, when the number of eligible domains is less than minDomains, scheduler won't schedule more than maxSkew Pods to those domains. If value is nil, the constraint behaves as if MinDomains is equal to 1. Valid values are integers greater than 0. When value is not nil, WhenUnsatisfiable must be DoNotSchedule.<br><p> <br><p> For example, in a 3-zone cluster, MaxSkew is set to 2, MinDomains is set to 5 and pods with the same labelSelector spread as 2/2/2: | zone1 | zone2 | zone3 | |  P P  |  P P  |  P P  | The number of domains is less than 5(MinDomains), so "global minimum" is treated as 0. In this situation, new pod with the same labelSelector cannot be scheduled, because computed skew will be 3(3 - 0) if new Pod is scheduled to any of the three zones, it will violate MaxSkew.
+     */
     @JsonProperty("minDomains")
     public Integer getMinDomains() {
         return minDomains;
     }
 
+    /**
+     * MinDomains indicates a minimum number of eligible domains. When the number of eligible domains with matching topology keys is less than minDomains, Pod Topology Spread treats "global minimum" as 0, and then the calculation of Skew is performed. And when the number of eligible domains with matching topology keys equals or greater than minDomains, this value has no effect on scheduling. As a result, when the number of eligible domains is less than minDomains, scheduler won't schedule more than maxSkew Pods to those domains. If value is nil, the constraint behaves as if MinDomains is equal to 1. Valid values are integers greater than 0. When value is not nil, WhenUnsatisfiable must be DoNotSchedule.<br><p> <br><p> For example, in a 3-zone cluster, MaxSkew is set to 2, MinDomains is set to 5 and pods with the same labelSelector spread as 2/2/2: | zone1 | zone2 | zone3 | |  P P  |  P P  |  P P  | The number of domains is less than 5(MinDomains), so "global minimum" is treated as 0. In this situation, new pod with the same labelSelector cannot be scheduled, because computed skew will be 3(3 - 0) if new Pod is scheduled to any of the three zones, it will violate MaxSkew.
+     */
     @JsonProperty("minDomains")
     public void setMinDomains(Integer minDomains) {
         this.minDomains = minDomains;
     }
 
+    /**
+     * NodeAffinityPolicy indicates how we will treat Pod's nodeAffinity/nodeSelector when calculating pod topology spread skew. Options are: - Honor: only nodes matching nodeAffinity/nodeSelector are included in the calculations. - Ignore: nodeAffinity/nodeSelector are ignored. All nodes are included in the calculations.<br><p> <br><p> If this value is nil, the behavior is equivalent to the Honor policy. This is a beta-level feature default enabled by the NodeInclusionPolicyInPodTopologySpread feature flag.<br><p> <br><p> Possible enum values:<br><p>  - `"Honor"` means use this scheduling directive when calculating pod topology spread skew.<br><p>  - `"Ignore"` means ignore this scheduling directive when calculating pod topology spread skew.
+     */
     @JsonProperty("nodeAffinityPolicy")
     public String getNodeAffinityPolicy() {
         return nodeAffinityPolicy;
     }
 
+    /**
+     * NodeAffinityPolicy indicates how we will treat Pod's nodeAffinity/nodeSelector when calculating pod topology spread skew. Options are: - Honor: only nodes matching nodeAffinity/nodeSelector are included in the calculations. - Ignore: nodeAffinity/nodeSelector are ignored. All nodes are included in the calculations.<br><p> <br><p> If this value is nil, the behavior is equivalent to the Honor policy. This is a beta-level feature default enabled by the NodeInclusionPolicyInPodTopologySpread feature flag.<br><p> <br><p> Possible enum values:<br><p>  - `"Honor"` means use this scheduling directive when calculating pod topology spread skew.<br><p>  - `"Ignore"` means ignore this scheduling directive when calculating pod topology spread skew.
+     */
     @JsonProperty("nodeAffinityPolicy")
     public void setNodeAffinityPolicy(String nodeAffinityPolicy) {
         this.nodeAffinityPolicy = nodeAffinityPolicy;
     }
 
+    /**
+     * NodeTaintsPolicy indicates how we will treat node taints when calculating pod topology spread skew. Options are: - Honor: nodes without taints, along with tainted nodes for which the incoming pod has a toleration, are included. - Ignore: node taints are ignored. All nodes are included.<br><p> <br><p> If this value is nil, the behavior is equivalent to the Ignore policy. This is a beta-level feature default enabled by the NodeInclusionPolicyInPodTopologySpread feature flag.<br><p> <br><p> Possible enum values:<br><p>  - `"Honor"` means use this scheduling directive when calculating pod topology spread skew.<br><p>  - `"Ignore"` means ignore this scheduling directive when calculating pod topology spread skew.
+     */
     @JsonProperty("nodeTaintsPolicy")
     public String getNodeTaintsPolicy() {
         return nodeTaintsPolicy;
     }
 
+    /**
+     * NodeTaintsPolicy indicates how we will treat node taints when calculating pod topology spread skew. Options are: - Honor: nodes without taints, along with tainted nodes for which the incoming pod has a toleration, are included. - Ignore: node taints are ignored. All nodes are included.<br><p> <br><p> If this value is nil, the behavior is equivalent to the Ignore policy. This is a beta-level feature default enabled by the NodeInclusionPolicyInPodTopologySpread feature flag.<br><p> <br><p> Possible enum values:<br><p>  - `"Honor"` means use this scheduling directive when calculating pod topology spread skew.<br><p>  - `"Ignore"` means ignore this scheduling directive when calculating pod topology spread skew.
+     */
     @JsonProperty("nodeTaintsPolicy")
     public void setNodeTaintsPolicy(String nodeTaintsPolicy) {
         this.nodeTaintsPolicy = nodeTaintsPolicy;
     }
 
+    /**
+     * TopologyKey is the key of node labels. Nodes that have a label with this key and identical values are considered to be in the same topology. We consider each &lt;key, value&gt; as a "bucket", and try to put balanced number of pods into each bucket. We define a domain as a particular instance of a topology. Also, we define an eligible domain as a domain whose nodes meet the requirements of nodeAffinityPolicy and nodeTaintsPolicy. e.g. If TopologyKey is "kubernetes.io/hostname", each Node is a domain of that topology. And, if TopologyKey is "topology.kubernetes.io/zone", each zone is a domain of that topology. It's a required field.
+     */
     @JsonProperty("topologyKey")
     public String getTopologyKey() {
         return topologyKey;
     }
 
+    /**
+     * TopologyKey is the key of node labels. Nodes that have a label with this key and identical values are considered to be in the same topology. We consider each &lt;key, value&gt; as a "bucket", and try to put balanced number of pods into each bucket. We define a domain as a particular instance of a topology. Also, we define an eligible domain as a domain whose nodes meet the requirements of nodeAffinityPolicy and nodeTaintsPolicy. e.g. If TopologyKey is "kubernetes.io/hostname", each Node is a domain of that topology. And, if TopologyKey is "topology.kubernetes.io/zone", each zone is a domain of that topology. It's a required field.
+     */
     @JsonProperty("topologyKey")
     public void setTopologyKey(String topologyKey) {
         this.topologyKey = topologyKey;
     }
 
+    /**
+     * WhenUnsatisfiable indicates how to deal with a pod if it doesn't satisfy the spread constraint. - DoNotSchedule (default) tells the scheduler not to schedule it. - ScheduleAnyway tells the scheduler to schedule the pod in any location,<br><p>   but giving higher precedence to topologies that would help reduce the<br><p>   skew.<br><p> A constraint is considered "Unsatisfiable" for an incoming pod if and only if every possible node assignment for that pod would violate "MaxSkew" on some topology. For example, in a 3-zone cluster, MaxSkew is set to 1, and pods with the same labelSelector spread as 3/1/1: | zone1 | zone2 | zone3 | | P P P |   P   |   P   | If WhenUnsatisfiable is set to DoNotSchedule, incoming pod can only be scheduled to zone2(zone3) to become 3/2/1(3/1/2) as ActualSkew(2-1) on zone2(zone3) satisfies MaxSkew(1). In other words, the cluster can still be imbalanced, but scheduler won't make it &#42;more&#42; imbalanced. It's a required field.<br><p> <br><p> Possible enum values:<br><p>  - `"DoNotSchedule"` instructs the scheduler not to schedule the pod when constraints are not satisfied.<br><p>  - `"ScheduleAnyway"` instructs the scheduler to schedule the pod even if constraints are not satisfied.
+     */
     @JsonProperty("whenUnsatisfiable")
     public String getWhenUnsatisfiable() {
         return whenUnsatisfiable;
     }
 
+    /**
+     * WhenUnsatisfiable indicates how to deal with a pod if it doesn't satisfy the spread constraint. - DoNotSchedule (default) tells the scheduler not to schedule it. - ScheduleAnyway tells the scheduler to schedule the pod in any location,<br><p>   but giving higher precedence to topologies that would help reduce the<br><p>   skew.<br><p> A constraint is considered "Unsatisfiable" for an incoming pod if and only if every possible node assignment for that pod would violate "MaxSkew" on some topology. For example, in a 3-zone cluster, MaxSkew is set to 1, and pods with the same labelSelector spread as 3/1/1: | zone1 | zone2 | zone3 | | P P P |   P   |   P   | If WhenUnsatisfiable is set to DoNotSchedule, incoming pod can only be scheduled to zone2(zone3) to become 3/2/1(3/1/2) as ActualSkew(2-1) on zone2(zone3) satisfies MaxSkew(1). In other words, the cluster can still be imbalanced, but scheduler won't make it &#42;more&#42; imbalanced. It's a required field.<br><p> <br><p> Possible enum values:<br><p>  - `"DoNotSchedule"` instructs the scheduler not to schedule the pod when constraints are not satisfied.<br><p>  - `"ScheduleAnyway"` instructs the scheduler to schedule the pod even if constraints are not satisfied.
+     */
     @JsonProperty("whenUnsatisfiable")
     public void setWhenUnsatisfiable(String whenUnsatisfiable) {
         this.whenUnsatisfiable = whenUnsatisfiable;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/WebConfigFileFields.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/WebConfigFileFields.java
index a1995c85b83..c3e09a7eed9 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/WebConfigFileFields.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/WebConfigFileFields.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WebConfigFileFields defines the file content for --web.config.file flag.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public WebConfigFileFields(WebHTTPConfig httpConfig, WebTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * WebConfigFileFields defines the file content for --web.config.file flag.
+     */
     @JsonProperty("httpConfig")
     public WebHTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * WebConfigFileFields defines the file content for --web.config.file flag.
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(WebHTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * WebConfigFileFields defines the file content for --web.config.file flag.
+     */
     @JsonProperty("tlsConfig")
     public WebTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * WebConfigFileFields defines the file content for --web.config.file flag.
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(WebTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/WebHTTPConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/WebHTTPConfig.java
index 76f0b515433..e02a1a2703b 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/WebHTTPConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/WebHTTPConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WebHTTPConfig defines HTTP parameters for web server.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public WebHTTPConfig(WebHTTPHeaders headers, Boolean http2) {
         this.http2 = http2;
     }
 
+    /**
+     * WebHTTPConfig defines HTTP parameters for web server.
+     */
     @JsonProperty("headers")
     public WebHTTPHeaders getHeaders() {
         return headers;
     }
 
+    /**
+     * WebHTTPConfig defines HTTP parameters for web server.
+     */
     @JsonProperty("headers")
     public void setHeaders(WebHTTPHeaders headers) {
         this.headers = headers;
     }
 
+    /**
+     * Enable HTTP/2 support. Note that HTTP/2 is only supported with TLS. When TLSConfig is not configured, HTTP/2 will be disabled. Whenever the value of the field changes, a rolling update will be triggered.
+     */
     @JsonProperty("http2")
     public Boolean getHttp2() {
         return http2;
     }
 
+    /**
+     * Enable HTTP/2 support. Note that HTTP/2 is only supported with TLS. When TLSConfig is not configured, HTTP/2 will be disabled. Whenever the value of the field changes, a rolling update will be triggered.
+     */
     @JsonProperty("http2")
     public void setHttp2(Boolean http2) {
         this.http2 = http2;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/WebHTTPHeaders.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/WebHTTPHeaders.java
index 5eec884e92e..3d010aa69d5 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/WebHTTPHeaders.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/WebHTTPHeaders.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WebHTTPHeaders defines the list of headers that can be added to HTTP responses.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public WebHTTPHeaders(String contentSecurityPolicy, String strictTransportSecuri
         this.xXSSProtection = xXSSProtection;
     }
 
+    /**
+     * Set the Content-Security-Policy header to HTTP responses. Unset if blank.
+     */
     @JsonProperty("contentSecurityPolicy")
     public String getContentSecurityPolicy() {
         return contentSecurityPolicy;
     }
 
+    /**
+     * Set the Content-Security-Policy header to HTTP responses. Unset if blank.
+     */
     @JsonProperty("contentSecurityPolicy")
     public void setContentSecurityPolicy(String contentSecurityPolicy) {
         this.contentSecurityPolicy = contentSecurityPolicy;
     }
 
+    /**
+     * Set the Strict-Transport-Security header to HTTP responses. Unset if blank. Please make sure that you use this with care as this header might force browsers to load Prometheus and the other applications hosted on the same domain and subdomains over HTTPS. https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Strict-Transport-Security
+     */
     @JsonProperty("strictTransportSecurity")
     public String getStrictTransportSecurity() {
         return strictTransportSecurity;
     }
 
+    /**
+     * Set the Strict-Transport-Security header to HTTP responses. Unset if blank. Please make sure that you use this with care as this header might force browsers to load Prometheus and the other applications hosted on the same domain and subdomains over HTTPS. https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Strict-Transport-Security
+     */
     @JsonProperty("strictTransportSecurity")
     public void setStrictTransportSecurity(String strictTransportSecurity) {
         this.strictTransportSecurity = strictTransportSecurity;
     }
 
+    /**
+     * Set the X-Content-Type-Options header to HTTP responses. Unset if blank. Accepted value is nosniff. https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Content-Type-Options
+     */
     @JsonProperty("xContentTypeOptions")
     public String getXContentTypeOptions() {
         return xContentTypeOptions;
     }
 
+    /**
+     * Set the X-Content-Type-Options header to HTTP responses. Unset if blank. Accepted value is nosniff. https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Content-Type-Options
+     */
     @JsonProperty("xContentTypeOptions")
     public void setXContentTypeOptions(String xContentTypeOptions) {
         this.xContentTypeOptions = xContentTypeOptions;
     }
 
+    /**
+     * Set the X-Frame-Options header to HTTP responses. Unset if blank. Accepted values are deny and sameorigin. https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Frame-Options
+     */
     @JsonProperty("xFrameOptions")
     public String getXFrameOptions() {
         return xFrameOptions;
     }
 
+    /**
+     * Set the X-Frame-Options header to HTTP responses. Unset if blank. Accepted values are deny and sameorigin. https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Frame-Options
+     */
     @JsonProperty("xFrameOptions")
     public void setXFrameOptions(String xFrameOptions) {
         this.xFrameOptions = xFrameOptions;
     }
 
+    /**
+     * Set the X-XSS-Protection header to all responses. Unset if blank. https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-XSS-Protection
+     */
     @JsonProperty("xXSSProtection")
     public String getXXSSProtection() {
         return xXSSProtection;
     }
 
+    /**
+     * Set the X-XSS-Protection header to all responses. Unset if blank. https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-XSS-Protection
+     */
     @JsonProperty("xXSSProtection")
     public void setXXSSProtection(String xXSSProtection) {
         this.xXSSProtection = xXSSProtection;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/WebTLSConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/WebTLSConfig.java
index c12c968cdfc..46bbde2887d 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/WebTLSConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1/WebTLSConfig.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WebTLSConfig defines the TLS parameters for HTTPS.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -127,123 +130,195 @@ public WebTLSConfig(SecretOrConfigMap cert, String certFile, List<String> cipher
         this.preferServerCipherSuites = preferServerCipherSuites;
     }
 
+    /**
+     * WebTLSConfig defines the TLS parameters for HTTPS.
+     */
     @JsonProperty("cert")
     public SecretOrConfigMap getCert() {
         return cert;
     }
 
+    /**
+     * WebTLSConfig defines the TLS parameters for HTTPS.
+     */
     @JsonProperty("cert")
     public void setCert(SecretOrConfigMap cert) {
         this.cert = cert;
     }
 
+    /**
+     * Path to the TLS certificate file in the Prometheus container for the server. Mutually exclusive with `cert`.
+     */
     @JsonProperty("certFile")
     public String getCertFile() {
         return certFile;
     }
 
+    /**
+     * Path to the TLS certificate file in the Prometheus container for the server. Mutually exclusive with `cert`.
+     */
     @JsonProperty("certFile")
     public void setCertFile(String certFile) {
         this.certFile = certFile;
     }
 
+    /**
+     * List of supported cipher suites for TLS versions up to TLS 1.2. If empty, Go default cipher suites are used. Available cipher suites are documented in the go documentation: https://golang.org/pkg/crypto/tls/#pkg-constants
+     */
     @JsonProperty("cipherSuites")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCipherSuites() {
         return cipherSuites;
     }
 
+    /**
+     * List of supported cipher suites for TLS versions up to TLS 1.2. If empty, Go default cipher suites are used. Available cipher suites are documented in the go documentation: https://golang.org/pkg/crypto/tls/#pkg-constants
+     */
     @JsonProperty("cipherSuites")
     public void setCipherSuites(List<String> cipherSuites) {
         this.cipherSuites = cipherSuites;
     }
 
+    /**
+     * Server policy for client authentication. Maps to ClientAuth Policies. For more detail on clientAuth options: https://golang.org/pkg/crypto/tls/#ClientAuthType
+     */
     @JsonProperty("clientAuthType")
     public String getClientAuthType() {
         return clientAuthType;
     }
 
+    /**
+     * Server policy for client authentication. Maps to ClientAuth Policies. For more detail on clientAuth options: https://golang.org/pkg/crypto/tls/#ClientAuthType
+     */
     @JsonProperty("clientAuthType")
     public void setClientAuthType(String clientAuthType) {
         this.clientAuthType = clientAuthType;
     }
 
+    /**
+     * Path to the CA certificate file for client certificate authentication to the server. Mutually exclusive with `client_ca`.
+     */
     @JsonProperty("clientCAFile")
     public String getClientCAFile() {
         return clientCAFile;
     }
 
+    /**
+     * Path to the CA certificate file for client certificate authentication to the server. Mutually exclusive with `client_ca`.
+     */
     @JsonProperty("clientCAFile")
     public void setClientCAFile(String clientCAFile) {
         this.clientCAFile = clientCAFile;
     }
 
+    /**
+     * WebTLSConfig defines the TLS parameters for HTTPS.
+     */
     @JsonProperty("client_ca")
     public SecretOrConfigMap getClientCa() {
         return clientCa;
     }
 
+    /**
+     * WebTLSConfig defines the TLS parameters for HTTPS.
+     */
     @JsonProperty("client_ca")
     public void setClientCa(SecretOrConfigMap clientCa) {
         this.clientCa = clientCa;
     }
 
+    /**
+     * Elliptic curves that will be used in an ECDHE handshake, in preference order. Available curves are documented in the go documentation: https://golang.org/pkg/crypto/tls/#CurveID
+     */
     @JsonProperty("curvePreferences")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCurvePreferences() {
         return curvePreferences;
     }
 
+    /**
+     * Elliptic curves that will be used in an ECDHE handshake, in preference order. Available curves are documented in the go documentation: https://golang.org/pkg/crypto/tls/#CurveID
+     */
     @JsonProperty("curvePreferences")
     public void setCurvePreferences(List<String> curvePreferences) {
         this.curvePreferences = curvePreferences;
     }
 
+    /**
+     * Path to the TLS key file in the Prometheus container for the server. Mutually exclusive with `keySecret`.
+     */
     @JsonProperty("keyFile")
     public String getKeyFile() {
         return keyFile;
     }
 
+    /**
+     * Path to the TLS key file in the Prometheus container for the server. Mutually exclusive with `keySecret`.
+     */
     @JsonProperty("keyFile")
     public void setKeyFile(String keyFile) {
         this.keyFile = keyFile;
     }
 
+    /**
+     * WebTLSConfig defines the TLS parameters for HTTPS.
+     */
     @JsonProperty("keySecret")
     public SecretKeySelector getKeySecret() {
         return keySecret;
     }
 
+    /**
+     * WebTLSConfig defines the TLS parameters for HTTPS.
+     */
     @JsonProperty("keySecret")
     public void setKeySecret(SecretKeySelector keySecret) {
         this.keySecret = keySecret;
     }
 
+    /**
+     * Maximum TLS version that is acceptable. Defaults to TLS13.
+     */
     @JsonProperty("maxVersion")
     public String getMaxVersion() {
         return maxVersion;
     }
 
+    /**
+     * Maximum TLS version that is acceptable. Defaults to TLS13.
+     */
     @JsonProperty("maxVersion")
     public void setMaxVersion(String maxVersion) {
         this.maxVersion = maxVersion;
     }
 
+    /**
+     * Minimum TLS version that is acceptable. Defaults to TLS12.
+     */
     @JsonProperty("minVersion")
     public String getMinVersion() {
         return minVersion;
     }
 
+    /**
+     * Minimum TLS version that is acceptable. Defaults to TLS12.
+     */
     @JsonProperty("minVersion")
     public void setMinVersion(String minVersion) {
         this.minVersion = minVersion;
     }
 
+    /**
+     * Controls whether the server selects the client's most preferred cipher suite, or the server's most preferred cipher suite. If true then the server's preference, as expressed in the order of elements in cipherSuites, is used.
+     */
     @JsonProperty("preferServerCipherSuites")
     public Boolean getPreferServerCipherSuites() {
         return preferServerCipherSuites;
     }
 
+    /**
+     * Controls whether the server selects the client's most preferred cipher suite, or the server's most preferred cipher suite. If true then the server's preference, as expressed in the order of elements in cipherSuites, is used.
+     */
     @JsonProperty("preferServerCipherSuites")
     public void setPreferServerCipherSuites(Boolean preferServerCipherSuites) {
         this.preferServerCipherSuites = preferServerCipherSuites;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/AlertmanagerConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/AlertmanagerConfig.java
index 388db5e4de7..52de9ee8fe8 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/AlertmanagerConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/AlertmanagerConfig.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AlertmanagerConfig configures the Prometheus Alertmanager, specifying how alerts should be grouped, inhibited and notified to external systems.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class AlertmanagerConfig implements Editable<AlertmanagerConfigBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "monitoring.coreos.com/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AlertmanagerConfig";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public AlertmanagerConfig(String apiVersion, String kind, ObjectMeta metadata, A
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AlertmanagerConfig configures the Prometheus Alertmanager, specifying how alerts should be grouped, inhibited and notified to external systems.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AlertmanagerConfig configures the Prometheus Alertmanager, specifying how alerts should be grouped, inhibited and notified to external systems.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * AlertmanagerConfig configures the Prometheus Alertmanager, specifying how alerts should be grouped, inhibited and notified to external systems.
+     */
     @JsonProperty("spec")
     public AlertmanagerConfigSpec getSpec() {
         return spec;
     }
 
+    /**
+     * AlertmanagerConfig configures the Prometheus Alertmanager, specifying how alerts should be grouped, inhibited and notified to external systems.
+     */
     @JsonProperty("spec")
     public void setSpec(AlertmanagerConfigSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/AlertmanagerConfigList.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/AlertmanagerConfigList.java
index f7e0f74467b..94d5c7365cf 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/AlertmanagerConfigList.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/AlertmanagerConfigList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AlertmanagerConfigList is a list of AlertmanagerConfig.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class AlertmanagerConfigList implements Editable<AlertmanagerConfigListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.monitoring.v1alpha1.AlertmanagerConfig>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "monitoring.coreos.com/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.monitoring.v1alpha1.AlertmanagerConfig> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AlertmanagerConfigList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public AlertmanagerConfigList(String apiVersion, List<io.fabric8.openshift.api.m
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of AlertmanagerConfig
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.monitoring.v1alpha1.AlertmanagerConfig> getItems() {
         return items;
     }
 
+    /**
+     * List of AlertmanagerConfig
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.monitoring.v1alpha1.AlertmanagerConfig> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AlertmanagerConfigList is a list of AlertmanagerConfig.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AlertmanagerConfigList is a list of AlertmanagerConfig.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/AlertmanagerConfigSpec.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/AlertmanagerConfigSpec.java
index 898e2acad01..5e82ec57170 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/AlertmanagerConfigSpec.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/AlertmanagerConfigSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AlertmanagerConfigSpec is a specification of the desired behavior of the Alertmanager configuration. By default, the Alertmanager configuration only applies to alerts for which the `namespace` label is equal to the namespace of the AlertmanagerConfig resource (see the `.spec.alertmanagerConfigMatcherStrategy` field of the Alertmanager CRD).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,44 +98,68 @@ public AlertmanagerConfigSpec(List<InhibitRule> inhibitRules, List<MuteTimeInter
         this.route = route;
     }
 
+    /**
+     * List of inhibition rules. The rules will only apply to alerts matching the resource's namespace.
+     */
     @JsonProperty("inhibitRules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<InhibitRule> getInhibitRules() {
         return inhibitRules;
     }
 
+    /**
+     * List of inhibition rules. The rules will only apply to alerts matching the resource's namespace.
+     */
     @JsonProperty("inhibitRules")
     public void setInhibitRules(List<InhibitRule> inhibitRules) {
         this.inhibitRules = inhibitRules;
     }
 
+    /**
+     * List of MuteTimeInterval specifying when the routes should be muted.
+     */
     @JsonProperty("muteTimeIntervals")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MuteTimeInterval> getMuteTimeIntervals() {
         return muteTimeIntervals;
     }
 
+    /**
+     * List of MuteTimeInterval specifying when the routes should be muted.
+     */
     @JsonProperty("muteTimeIntervals")
     public void setMuteTimeIntervals(List<MuteTimeInterval> muteTimeIntervals) {
         this.muteTimeIntervals = muteTimeIntervals;
     }
 
+    /**
+     * List of receivers.
+     */
     @JsonProperty("receivers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Receiver> getReceivers() {
         return receivers;
     }
 
+    /**
+     * List of receivers.
+     */
     @JsonProperty("receivers")
     public void setReceivers(List<Receiver> receivers) {
         this.receivers = receivers;
     }
 
+    /**
+     * AlertmanagerConfigSpec is a specification of the desired behavior of the Alertmanager configuration. By default, the Alertmanager configuration only applies to alerts for which the `namespace` label is equal to the namespace of the AlertmanagerConfig resource (see the `.spec.alertmanagerConfigMatcherStrategy` field of the Alertmanager CRD).
+     */
     @JsonProperty("route")
     public Route getRoute() {
         return route;
     }
 
+    /**
+     * AlertmanagerConfigSpec is a specification of the desired behavior of the Alertmanager configuration. By default, the Alertmanager configuration only applies to alerts for which the `namespace` label is equal to the namespace of the AlertmanagerConfig resource (see the `.spec.alertmanagerConfigMatcherStrategy` field of the Alertmanager CRD).
+     */
     @JsonProperty("route")
     public void setRoute(Route route) {
         this.route = route;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/AttachMetadata.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/AttachMetadata.java
index 13d344b7fff..abf776c7fe9 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/AttachMetadata.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/AttachMetadata.java
@@ -78,11 +78,17 @@ public AttachMetadata(Boolean node) {
         this.node = node;
     }
 
+    /**
+     * Attaches node metadata to discovered targets. When set to true, Prometheus must have the `get` permission on the `Nodes` objects. Only valid for Pod, Endpoint and Endpointslice roles.
+     */
     @JsonProperty("node")
     public Boolean getNode() {
         return node;
     }
 
+    /**
+     * Attaches node metadata to discovered targets. When set to true, Prometheus must have the `get` permission on the `Nodes` objects. Only valid for Pod, Endpoint and Endpointslice roles.
+     */
     @JsonProperty("node")
     public void setNode(Boolean node) {
         this.node = node;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/AzureSDConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/AzureSDConfig.java
index 727a2a82a76..5e0bb720813 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/AzureSDConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/AzureSDConfig.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzureSDConfig allow retrieving scrape targets from Azure VMs. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#azure_sd_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -111,91 +114,145 @@ public AzureSDConfig(String authenticationMethod, String clientID, SecretKeySele
         this.tenantID = tenantID;
     }
 
+    /**
+     * # The authentication method, either `OAuth` or `ManagedIdentity` or `SDK`. See https://docs.microsoft.com/en-us/azure/active-directory/managed-identities-azure-resources/overview SDK authentication method uses environment variables by default. See https://learn.microsoft.com/en-us/azure/developer/go/azure-sdk-authentication
+     */
     @JsonProperty("authenticationMethod")
     public String getAuthenticationMethod() {
         return authenticationMethod;
     }
 
+    /**
+     * # The authentication method, either `OAuth` or `ManagedIdentity` or `SDK`. See https://docs.microsoft.com/en-us/azure/active-directory/managed-identities-azure-resources/overview SDK authentication method uses environment variables by default. See https://learn.microsoft.com/en-us/azure/developer/go/azure-sdk-authentication
+     */
     @JsonProperty("authenticationMethod")
     public void setAuthenticationMethod(String authenticationMethod) {
         this.authenticationMethod = authenticationMethod;
     }
 
+    /**
+     * Optional client ID. Only required with the OAuth authentication method.
+     */
     @JsonProperty("clientID")
     public String getClientID() {
         return clientID;
     }
 
+    /**
+     * Optional client ID. Only required with the OAuth authentication method.
+     */
     @JsonProperty("clientID")
     public void setClientID(String clientID) {
         this.clientID = clientID;
     }
 
+    /**
+     * AzureSDConfig allow retrieving scrape targets from Azure VMs. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#azure_sd_config
+     */
     @JsonProperty("clientSecret")
     public SecretKeySelector getClientSecret() {
         return clientSecret;
     }
 
+    /**
+     * AzureSDConfig allow retrieving scrape targets from Azure VMs. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#azure_sd_config
+     */
     @JsonProperty("clientSecret")
     public void setClientSecret(SecretKeySelector clientSecret) {
         this.clientSecret = clientSecret;
     }
 
+    /**
+     * The Azure environment.
+     */
     @JsonProperty("environment")
     public String getEnvironment() {
         return environment;
     }
 
+    /**
+     * The Azure environment.
+     */
     @JsonProperty("environment")
     public void setEnvironment(String environment) {
         this.environment = environment;
     }
 
+    /**
+     * The port to scrape metrics from. If using the public IP address, this must instead be specified in the relabeling rule.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * The port to scrape metrics from. If using the public IP address, this must instead be specified in the relabeling rule.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * RefreshInterval configures the refresh interval at which Prometheus will re-read the instance list.
+     */
     @JsonProperty("refreshInterval")
     public String getRefreshInterval() {
         return refreshInterval;
     }
 
+    /**
+     * RefreshInterval configures the refresh interval at which Prometheus will re-read the instance list.
+     */
     @JsonProperty("refreshInterval")
     public void setRefreshInterval(String refreshInterval) {
         this.refreshInterval = refreshInterval;
     }
 
+    /**
+     * Optional resource group name. Limits discovery to this resource group.
+     */
     @JsonProperty("resourceGroup")
     public String getResourceGroup() {
         return resourceGroup;
     }
 
+    /**
+     * Optional resource group name. Limits discovery to this resource group.
+     */
     @JsonProperty("resourceGroup")
     public void setResourceGroup(String resourceGroup) {
         this.resourceGroup = resourceGroup;
     }
 
+    /**
+     * The subscription ID. Always required.
+     */
     @JsonProperty("subscriptionID")
     public String getSubscriptionID() {
         return subscriptionID;
     }
 
+    /**
+     * The subscription ID. Always required.
+     */
     @JsonProperty("subscriptionID")
     public void setSubscriptionID(String subscriptionID) {
         this.subscriptionID = subscriptionID;
     }
 
+    /**
+     * Optional tenant ID. Only required with the OAuth authentication method.
+     */
     @JsonProperty("tenantID")
     public String getTenantID() {
         return tenantID;
     }
 
+    /**
+     * Optional tenant ID. Only required with the OAuth authentication method.
+     */
     @JsonProperty("tenantID")
     public void setTenantID(String tenantID) {
         this.tenantID = tenantID;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/ConsulSDConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/ConsulSDConfig.java
index 85df76a8abf..6ea7ec8774a 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/ConsulSDConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/ConsulSDConfig.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsulSDConfig defines a Consul service discovery configuration See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#consul_sd_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -181,245 +184,389 @@ public ConsulSDConfig(Boolean allowStale, SafeAuthorization authorization, Basic
         this.tokenRef = tokenRef;
     }
 
+    /**
+     * Allow stale Consul results (see https://www.consul.io/api/features/consistency.html). Will reduce load on Consul. If unset, Prometheus uses its default value.
+     */
     @JsonProperty("allowStale")
     public Boolean getAllowStale() {
         return allowStale;
     }
 
+    /**
+     * Allow stale Consul results (see https://www.consul.io/api/features/consistency.html). Will reduce load on Consul. If unset, Prometheus uses its default value.
+     */
     @JsonProperty("allowStale")
     public void setAllowStale(Boolean allowStale) {
         this.allowStale = allowStale;
     }
 
+    /**
+     * ConsulSDConfig defines a Consul service discovery configuration See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#consul_sd_config
+     */
     @JsonProperty("authorization")
     public SafeAuthorization getAuthorization() {
         return authorization;
     }
 
+    /**
+     * ConsulSDConfig defines a Consul service discovery configuration See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#consul_sd_config
+     */
     @JsonProperty("authorization")
     public void setAuthorization(SafeAuthorization authorization) {
         this.authorization = authorization;
     }
 
+    /**
+     * ConsulSDConfig defines a Consul service discovery configuration See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#consul_sd_config
+     */
     @JsonProperty("basicAuth")
     public BasicAuth getBasicAuth() {
         return basicAuth;
     }
 
+    /**
+     * ConsulSDConfig defines a Consul service discovery configuration See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#consul_sd_config
+     */
     @JsonProperty("basicAuth")
     public void setBasicAuth(BasicAuth basicAuth) {
         this.basicAuth = basicAuth;
     }
 
+    /**
+     * Consul Datacenter name, if not provided it will use the local Consul Agent Datacenter.
+     */
     @JsonProperty("datacenter")
     public String getDatacenter() {
         return datacenter;
     }
 
+    /**
+     * Consul Datacenter name, if not provided it will use the local Consul Agent Datacenter.
+     */
     @JsonProperty("datacenter")
     public void setDatacenter(String datacenter) {
         this.datacenter = datacenter;
     }
 
+    /**
+     * Whether to enable HTTP2. If unset, Prometheus uses its default value.
+     */
     @JsonProperty("enableHTTP2")
     public Boolean getEnableHTTP2() {
         return enableHTTP2;
     }
 
+    /**
+     * Whether to enable HTTP2. If unset, Prometheus uses its default value.
+     */
     @JsonProperty("enableHTTP2")
     public void setEnableHTTP2(Boolean enableHTTP2) {
         this.enableHTTP2 = enableHTTP2;
     }
 
+    /**
+     * Filter expression used to filter the catalog results. See https://www.consul.io/api-docs/catalog#list-services It requires Prometheus &gt;= 3.0.0.
+     */
     @JsonProperty("filter")
     public String getFilter() {
         return filter;
     }
 
+    /**
+     * Filter expression used to filter the catalog results. See https://www.consul.io/api-docs/catalog#list-services It requires Prometheus &gt;= 3.0.0.
+     */
     @JsonProperty("filter")
     public void setFilter(String filter) {
         this.filter = filter;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects. If unset, Prometheus uses its default value.
+     */
     @JsonProperty("followRedirects")
     public Boolean getFollowRedirects() {
         return followRedirects;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects. If unset, Prometheus uses its default value.
+     */
     @JsonProperty("followRedirects")
     public void setFollowRedirects(Boolean followRedirects) {
         this.followRedirects = followRedirects;
     }
 
+    /**
+     * Namespaces are only supported in Consul Enterprise.<br><p> <br><p> It requires Prometheus &gt;= 2.28.0.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespaces are only supported in Consul Enterprise.<br><p> <br><p> It requires Prometheus &gt;= 2.28.0.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * Node metadata key/value pairs to filter nodes for a given service. Starting with Consul 1.14, it is recommended to use `filter` with the `NodeMeta` selector instead.
+     */
     @JsonProperty("nodeMeta")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeMeta() {
         return nodeMeta;
     }
 
+    /**
+     * Node metadata key/value pairs to filter nodes for a given service. Starting with Consul 1.14, it is recommended to use `filter` with the `NodeMeta` selector instead.
+     */
     @JsonProperty("nodeMeta")
     public void setNodeMeta(Map<String, String> nodeMeta) {
         this.nodeMeta = nodeMeta;
     }
 
+    /**
+     * ConsulSDConfig defines a Consul service discovery configuration See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#consul_sd_config
+     */
     @JsonProperty("oauth2")
     public OAuth2 getOauth2() {
         return oauth2;
     }
 
+    /**
+     * ConsulSDConfig defines a Consul service discovery configuration See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#consul_sd_config
+     */
     @JsonProperty("oauth2")
     public void setOauth2(OAuth2 oauth2) {
         this.oauth2 = oauth2;
     }
 
+    /**
+     * Admin Partitions are only supported in Consul Enterprise.
+     */
     @JsonProperty("partition")
     public String getPartition() {
         return partition;
     }
 
+    /**
+     * Admin Partitions are only supported in Consul Enterprise.
+     */
     @JsonProperty("partition")
     public void setPartition(String partition) {
         this.partition = partition;
     }
 
+    /**
+     * Prefix for URIs for when consul is behind an API gateway (reverse proxy).<br><p> <br><p> It requires Prometheus &gt;= 2.45.0.
+     */
     @JsonProperty("pathPrefix")
     public String getPathPrefix() {
         return pathPrefix;
     }
 
+    /**
+     * Prefix for URIs for when consul is behind an API gateway (reverse proxy).<br><p> <br><p> It requires Prometheus &gt;= 2.45.0.
+     */
     @JsonProperty("pathPrefix")
     public void setPathPrefix(String pathPrefix) {
         this.pathPrefix = pathPrefix;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<SecretKeySelector>> getProxyConnectHeader() {
         return proxyConnectHeader;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     public void setProxyConnectHeader(Map<String, List<SecretKeySelector>> proxyConnectHeader) {
         this.proxyConnectHeader = proxyConnectHeader;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public Boolean getProxyFromEnvironment() {
         return proxyFromEnvironment;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public void setProxyFromEnvironment(Boolean proxyFromEnvironment) {
         this.proxyFromEnvironment = proxyFromEnvironment;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public String getProxyUrl() {
         return proxyUrl;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public void setProxyUrl(String proxyUrl) {
         this.proxyUrl = proxyUrl;
     }
 
+    /**
+     * The time after which the provided names are refreshed. On large setup it might be a good idea to increase this value because the catalog will change all the time. If unset, Prometheus uses its default value.
+     */
     @JsonProperty("refreshInterval")
     public String getRefreshInterval() {
         return refreshInterval;
     }
 
+    /**
+     * The time after which the provided names are refreshed. On large setup it might be a good idea to increase this value because the catalog will change all the time. If unset, Prometheus uses its default value.
+     */
     @JsonProperty("refreshInterval")
     public void setRefreshInterval(String refreshInterval) {
         this.refreshInterval = refreshInterval;
     }
 
+    /**
+     * HTTP Scheme default "http"
+     */
     @JsonProperty("scheme")
     public String getScheme() {
         return scheme;
     }
 
+    /**
+     * HTTP Scheme default "http"
+     */
     @JsonProperty("scheme")
     public void setScheme(String scheme) {
         this.scheme = scheme;
     }
 
+    /**
+     * Consul server address. A valid string consisting of a hostname or IP followed by an optional port number.
+     */
     @JsonProperty("server")
     public String getServer() {
         return server;
     }
 
+    /**
+     * Consul server address. A valid string consisting of a hostname or IP followed by an optional port number.
+     */
     @JsonProperty("server")
     public void setServer(String server) {
         this.server = server;
     }
 
+    /**
+     * A list of services for which targets are retrieved. If omitted, all services are scraped.
+     */
     @JsonProperty("services")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getServices() {
         return services;
     }
 
+    /**
+     * A list of services for which targets are retrieved. If omitted, all services are scraped.
+     */
     @JsonProperty("services")
     public void setServices(List<String> services) {
         this.services = services;
     }
 
+    /**
+     * The string by which Consul tags are joined into the tag label. If unset, Prometheus uses its default value.
+     */
     @JsonProperty("tagSeparator")
     public String getTagSeparator() {
         return tagSeparator;
     }
 
+    /**
+     * The string by which Consul tags are joined into the tag label. If unset, Prometheus uses its default value.
+     */
     @JsonProperty("tagSeparator")
     public void setTagSeparator(String tagSeparator) {
         this.tagSeparator = tagSeparator;
     }
 
+    /**
+     * An optional list of tags used to filter nodes for a given service. Services must contain all tags in the list. Starting with Consul 1.14, it is recommended to use `filter` with the `ServiceTags` selector instead.
+     */
     @JsonProperty("tags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getTags() {
         return tags;
     }
 
+    /**
+     * An optional list of tags used to filter nodes for a given service. Services must contain all tags in the list. Starting with Consul 1.14, it is recommended to use `filter` with the `ServiceTags` selector instead.
+     */
     @JsonProperty("tags")
     public void setTags(List<String> tags) {
         this.tags = tags;
     }
 
+    /**
+     * ConsulSDConfig defines a Consul service discovery configuration See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#consul_sd_config
+     */
     @JsonProperty("tlsConfig")
     public SafeTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * ConsulSDConfig defines a Consul service discovery configuration See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#consul_sd_config
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(SafeTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * ConsulSDConfig defines a Consul service discovery configuration See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#consul_sd_config
+     */
     @JsonProperty("tokenRef")
     public SecretKeySelector getTokenRef() {
         return tokenRef;
     }
 
+    /**
+     * ConsulSDConfig defines a Consul service discovery configuration See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#consul_sd_config
+     */
     @JsonProperty("tokenRef")
     public void setTokenRef(SecretKeySelector tokenRef) {
         this.tokenRef = tokenRef;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/DNSSDConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/DNSSDConfig.java
index 3821c936a7f..3110e01a3eb 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/DNSSDConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/DNSSDConfig.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSSDConfig allows specifying a set of DNS domain names which are periodically queried to discover a list of targets. The DNS servers to be contacted are read from /etc/resolv.conf. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#dns_sd_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public DNSSDConfig(List<String> names, Integer port, String refreshInterval, Str
         this.type = type;
     }
 
+    /**
+     * A list of DNS domain names to be queried.
+     */
     @JsonProperty("names")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNames() {
         return names;
     }
 
+    /**
+     * A list of DNS domain names to be queried.
+     */
     @JsonProperty("names")
     public void setNames(List<String> names) {
         this.names = names;
     }
 
+    /**
+     * The port number used if the query type is not SRV Ignored for SRV records
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * The port number used if the query type is not SRV Ignored for SRV records
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * RefreshInterval configures the time after which the provided names are refreshed. If not set, Prometheus uses its default value.
+     */
     @JsonProperty("refreshInterval")
     public String getRefreshInterval() {
         return refreshInterval;
     }
 
+    /**
+     * RefreshInterval configures the time after which the provided names are refreshed. If not set, Prometheus uses its default value.
+     */
     @JsonProperty("refreshInterval")
     public void setRefreshInterval(String refreshInterval) {
         this.refreshInterval = refreshInterval;
     }
 
+    /**
+     * The type of DNS query to perform. One of SRV, A, AAAA, MX or NS. If not set, Prometheus uses its default value.<br><p> <br><p> When set to NS, it requires Prometheus &gt;= v2.49.0. When set to MX, it requires Prometheus &gt;= v2.38.0
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * The type of DNS query to perform. One of SRV, A, AAAA, MX or NS. If not set, Prometheus uses its default value.<br><p> <br><p> When set to NS, it requires Prometheus &gt;= v2.49.0. When set to MX, it requires Prometheus &gt;= v2.38.0
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/DayOfMonthRange.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/DayOfMonthRange.java
index 5260df7ebb7..ba3ddb7e18e 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/DayOfMonthRange.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/DayOfMonthRange.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DayOfMonthRange is an inclusive range of days of the month beginning at 1
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public DayOfMonthRange(Integer end, Integer start) {
         this.start = start;
     }
 
+    /**
+     * End of the inclusive range
+     */
     @JsonProperty("end")
     public Integer getEnd() {
         return end;
     }
 
+    /**
+     * End of the inclusive range
+     */
     @JsonProperty("end")
     public void setEnd(Integer end) {
         this.end = end;
     }
 
+    /**
+     * Start of the inclusive range
+     */
     @JsonProperty("start")
     public Integer getStart() {
         return start;
     }
 
+    /**
+     * Start of the inclusive range
+     */
     @JsonProperty("start")
     public void setStart(Integer start) {
         this.start = start;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/DigitalOceanSDConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/DigitalOceanSDConfig.java
index b7542f7e7f9..48f035c1eeb 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/DigitalOceanSDConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/DigitalOceanSDConfig.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DigitalOceanSDConfig allow retrieving scrape targets from DigitalOcean's Droplets API. This service discovery uses the public IPv4 address by default, by that can be changed with relabeling See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#digitalocean_sd_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -124,112 +127,178 @@ public DigitalOceanSDConfig(SafeAuthorization authorization, Boolean enableHTTP2
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * DigitalOceanSDConfig allow retrieving scrape targets from DigitalOcean's Droplets API. This service discovery uses the public IPv4 address by default, by that can be changed with relabeling See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#digitalocean_sd_config
+     */
     @JsonProperty("authorization")
     public SafeAuthorization getAuthorization() {
         return authorization;
     }
 
+    /**
+     * DigitalOceanSDConfig allow retrieving scrape targets from DigitalOcean's Droplets API. This service discovery uses the public IPv4 address by default, by that can be changed with relabeling See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#digitalocean_sd_config
+     */
     @JsonProperty("authorization")
     public void setAuthorization(SafeAuthorization authorization) {
         this.authorization = authorization;
     }
 
+    /**
+     * Whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public Boolean getEnableHTTP2() {
         return enableHTTP2;
     }
 
+    /**
+     * Whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public void setEnableHTTP2(Boolean enableHTTP2) {
         this.enableHTTP2 = enableHTTP2;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public Boolean getFollowRedirects() {
         return followRedirects;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public void setFollowRedirects(Boolean followRedirects) {
         this.followRedirects = followRedirects;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * DigitalOceanSDConfig allow retrieving scrape targets from DigitalOcean's Droplets API. This service discovery uses the public IPv4 address by default, by that can be changed with relabeling See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#digitalocean_sd_config
+     */
     @JsonProperty("oauth2")
     public OAuth2 getOauth2() {
         return oauth2;
     }
 
+    /**
+     * DigitalOceanSDConfig allow retrieving scrape targets from DigitalOcean's Droplets API. This service discovery uses the public IPv4 address by default, by that can be changed with relabeling See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#digitalocean_sd_config
+     */
     @JsonProperty("oauth2")
     public void setOauth2(OAuth2 oauth2) {
         this.oauth2 = oauth2;
     }
 
+    /**
+     * The port to scrape metrics from.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * The port to scrape metrics from.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<SecretKeySelector>> getProxyConnectHeader() {
         return proxyConnectHeader;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     public void setProxyConnectHeader(Map<String, List<SecretKeySelector>> proxyConnectHeader) {
         this.proxyConnectHeader = proxyConnectHeader;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public Boolean getProxyFromEnvironment() {
         return proxyFromEnvironment;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public void setProxyFromEnvironment(Boolean proxyFromEnvironment) {
         this.proxyFromEnvironment = proxyFromEnvironment;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public String getProxyUrl() {
         return proxyUrl;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public void setProxyUrl(String proxyUrl) {
         this.proxyUrl = proxyUrl;
     }
 
+    /**
+     * Refresh interval to re-read the instance list.
+     */
     @JsonProperty("refreshInterval")
     public String getRefreshInterval() {
         return refreshInterval;
     }
 
+    /**
+     * Refresh interval to re-read the instance list.
+     */
     @JsonProperty("refreshInterval")
     public void setRefreshInterval(String refreshInterval) {
         this.refreshInterval = refreshInterval;
     }
 
+    /**
+     * DigitalOceanSDConfig allow retrieving scrape targets from DigitalOcean's Droplets API. This service discovery uses the public IPv4 address by default, by that can be changed with relabeling See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#digitalocean_sd_config
+     */
     @JsonProperty("tlsConfig")
     public SafeTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * DigitalOceanSDConfig allow retrieving scrape targets from DigitalOcean's Droplets API. This service discovery uses the public IPv4 address by default, by that can be changed with relabeling See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#digitalocean_sd_config
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(SafeTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/DiscordConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/DiscordConfig.java
index db38b6d6888..8ca53736792 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/DiscordConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/DiscordConfig.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DiscordConfig configures notifications via Discord. See https://prometheus.io/docs/alerting/latest/configuration/#discord_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,51 +98,81 @@ public DiscordConfig(SecretKeySelector apiURL, HTTPConfig httpConfig, String mes
         this.title = title;
     }
 
+    /**
+     * DiscordConfig configures notifications via Discord. See https://prometheus.io/docs/alerting/latest/configuration/#discord_config
+     */
     @JsonProperty("apiURL")
     public SecretKeySelector getApiURL() {
         return apiURL;
     }
 
+    /**
+     * DiscordConfig configures notifications via Discord. See https://prometheus.io/docs/alerting/latest/configuration/#discord_config
+     */
     @JsonProperty("apiURL")
     public void setApiURL(SecretKeySelector apiURL) {
         this.apiURL = apiURL;
     }
 
+    /**
+     * DiscordConfig configures notifications via Discord. See https://prometheus.io/docs/alerting/latest/configuration/#discord_config
+     */
     @JsonProperty("httpConfig")
     public HTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * DiscordConfig configures notifications via Discord. See https://prometheus.io/docs/alerting/latest/configuration/#discord_config
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(HTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * The template of the message's body.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * The template of the message's body.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public Boolean getSendResolved() {
         return sendResolved;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public void setSendResolved(Boolean sendResolved) {
         this.sendResolved = sendResolved;
     }
 
+    /**
+     * The template of the message's title.
+     */
     @JsonProperty("title")
     public String getTitle() {
         return title;
     }
 
+    /**
+     * The template of the message's title.
+     */
     @JsonProperty("title")
     public void setTitle(String title) {
         this.title = title;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/DockerSDConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/DockerSDConfig.java
index e93bc3f89c3..58c5c2fbef7 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/DockerSDConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/DockerSDConfig.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Docker SD configurations allow retrieving scrape targets from Docker Engine hosts. This SD discovers "containers" and will create a target for each network IP and port the container is configured to expose. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#docker_sd_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -147,163 +150,259 @@ public DockerSDConfig(SafeAuthorization authorization, BasicAuth basicAuth, Bool
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * Docker SD configurations allow retrieving scrape targets from Docker Engine hosts. This SD discovers "containers" and will create a target for each network IP and port the container is configured to expose. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#docker_sd_config
+     */
     @JsonProperty("authorization")
     public SafeAuthorization getAuthorization() {
         return authorization;
     }
 
+    /**
+     * Docker SD configurations allow retrieving scrape targets from Docker Engine hosts. This SD discovers "containers" and will create a target for each network IP and port the container is configured to expose. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#docker_sd_config
+     */
     @JsonProperty("authorization")
     public void setAuthorization(SafeAuthorization authorization) {
         this.authorization = authorization;
     }
 
+    /**
+     * Docker SD configurations allow retrieving scrape targets from Docker Engine hosts. This SD discovers "containers" and will create a target for each network IP and port the container is configured to expose. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#docker_sd_config
+     */
     @JsonProperty("basicAuth")
     public BasicAuth getBasicAuth() {
         return basicAuth;
     }
 
+    /**
+     * Docker SD configurations allow retrieving scrape targets from Docker Engine hosts. This SD discovers "containers" and will create a target for each network IP and port the container is configured to expose. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#docker_sd_config
+     */
     @JsonProperty("basicAuth")
     public void setBasicAuth(BasicAuth basicAuth) {
         this.basicAuth = basicAuth;
     }
 
+    /**
+     * Whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public Boolean getEnableHTTP2() {
         return enableHTTP2;
     }
 
+    /**
+     * Whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public void setEnableHTTP2(Boolean enableHTTP2) {
         this.enableHTTP2 = enableHTTP2;
     }
 
+    /**
+     * Optional filters to limit the discovery process to a subset of the available resources.
+     */
     @JsonProperty("filters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Filter> getFilters() {
         return filters;
     }
 
+    /**
+     * Optional filters to limit the discovery process to a subset of the available resources.
+     */
     @JsonProperty("filters")
     public void setFilters(List<Filter> filters) {
         this.filters = filters;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public Boolean getFollowRedirects() {
         return followRedirects;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public void setFollowRedirects(Boolean followRedirects) {
         this.followRedirects = followRedirects;
     }
 
+    /**
+     * Address of the docker daemon
+     */
     @JsonProperty("host")
     public String getHost() {
         return host;
     }
 
+    /**
+     * Address of the docker daemon
+     */
     @JsonProperty("host")
     public void setHost(String host) {
         this.host = host;
     }
 
+    /**
+     * The host to use if the container is in host networking mode.
+     */
     @JsonProperty("hostNetworkingHost")
     public String getHostNetworkingHost() {
         return hostNetworkingHost;
     }
 
+    /**
+     * The host to use if the container is in host networking mode.
+     */
     @JsonProperty("hostNetworkingHost")
     public void setHostNetworkingHost(String hostNetworkingHost) {
         this.hostNetworkingHost = hostNetworkingHost;
     }
 
+    /**
+     * Configure whether to match the first network if the container has multiple networks defined. If unset, Prometheus uses true by default. It requires Prometheus &gt;= v2.54.1.
+     */
     @JsonProperty("matchFirstNetwork")
     public Boolean getMatchFirstNetwork() {
         return matchFirstNetwork;
     }
 
+    /**
+     * Configure whether to match the first network if the container has multiple networks defined. If unset, Prometheus uses true by default. It requires Prometheus &gt;= v2.54.1.
+     */
     @JsonProperty("matchFirstNetwork")
     public void setMatchFirstNetwork(Boolean matchFirstNetwork) {
         this.matchFirstNetwork = matchFirstNetwork;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * Docker SD configurations allow retrieving scrape targets from Docker Engine hosts. This SD discovers "containers" and will create a target for each network IP and port the container is configured to expose. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#docker_sd_config
+     */
     @JsonProperty("oauth2")
     public OAuth2 getOauth2() {
         return oauth2;
     }
 
+    /**
+     * Docker SD configurations allow retrieving scrape targets from Docker Engine hosts. This SD discovers "containers" and will create a target for each network IP and port the container is configured to expose. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#docker_sd_config
+     */
     @JsonProperty("oauth2")
     public void setOauth2(OAuth2 oauth2) {
         this.oauth2 = oauth2;
     }
 
+    /**
+     * The port to scrape metrics from.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * The port to scrape metrics from.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<SecretKeySelector>> getProxyConnectHeader() {
         return proxyConnectHeader;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     public void setProxyConnectHeader(Map<String, List<SecretKeySelector>> proxyConnectHeader) {
         this.proxyConnectHeader = proxyConnectHeader;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public Boolean getProxyFromEnvironment() {
         return proxyFromEnvironment;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public void setProxyFromEnvironment(Boolean proxyFromEnvironment) {
         this.proxyFromEnvironment = proxyFromEnvironment;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public String getProxyUrl() {
         return proxyUrl;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public void setProxyUrl(String proxyUrl) {
         this.proxyUrl = proxyUrl;
     }
 
+    /**
+     * Time after which the container is refreshed.
+     */
     @JsonProperty("refreshInterval")
     public String getRefreshInterval() {
         return refreshInterval;
     }
 
+    /**
+     * Time after which the container is refreshed.
+     */
     @JsonProperty("refreshInterval")
     public void setRefreshInterval(String refreshInterval) {
         this.refreshInterval = refreshInterval;
     }
 
+    /**
+     * Docker SD configurations allow retrieving scrape targets from Docker Engine hosts. This SD discovers "containers" and will create a target for each network IP and port the container is configured to expose. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#docker_sd_config
+     */
     @JsonProperty("tlsConfig")
     public SafeTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * Docker SD configurations allow retrieving scrape targets from Docker Engine hosts. This SD discovers "containers" and will create a target for each network IP and port the container is configured to expose. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#docker_sd_config
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(SafeTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/DockerSwarmSDConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/DockerSwarmSDConfig.java
index 949038e8979..27f61bd4ddd 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/DockerSwarmSDConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/DockerSwarmSDConfig.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DockerSwarmSDConfig configurations allow retrieving scrape targets from Docker Swarm engine. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#dockerswarm_sd_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -143,153 +146,243 @@ public DockerSwarmSDConfig(SafeAuthorization authorization, BasicAuth basicAuth,
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * DockerSwarmSDConfig configurations allow retrieving scrape targets from Docker Swarm engine. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#dockerswarm_sd_config
+     */
     @JsonProperty("authorization")
     public SafeAuthorization getAuthorization() {
         return authorization;
     }
 
+    /**
+     * DockerSwarmSDConfig configurations allow retrieving scrape targets from Docker Swarm engine. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#dockerswarm_sd_config
+     */
     @JsonProperty("authorization")
     public void setAuthorization(SafeAuthorization authorization) {
         this.authorization = authorization;
     }
 
+    /**
+     * DockerSwarmSDConfig configurations allow retrieving scrape targets from Docker Swarm engine. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#dockerswarm_sd_config
+     */
     @JsonProperty("basicAuth")
     public BasicAuth getBasicAuth() {
         return basicAuth;
     }
 
+    /**
+     * DockerSwarmSDConfig configurations allow retrieving scrape targets from Docker Swarm engine. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#dockerswarm_sd_config
+     */
     @JsonProperty("basicAuth")
     public void setBasicAuth(BasicAuth basicAuth) {
         this.basicAuth = basicAuth;
     }
 
+    /**
+     * Whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public Boolean getEnableHTTP2() {
         return enableHTTP2;
     }
 
+    /**
+     * Whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public void setEnableHTTP2(Boolean enableHTTP2) {
         this.enableHTTP2 = enableHTTP2;
     }
 
+    /**
+     * Optional filters to limit the discovery process to a subset of available resources. The available filters are listed in the upstream documentation: Services: https://docs.docker.com/engine/api/v1.40/#operation/ServiceList Tasks: https://docs.docker.com/engine/api/v1.40/#operation/TaskList Nodes: https://docs.docker.com/engine/api/v1.40/#operation/NodeList
+     */
     @JsonProperty("filters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Filter> getFilters() {
         return filters;
     }
 
+    /**
+     * Optional filters to limit the discovery process to a subset of available resources. The available filters are listed in the upstream documentation: Services: https://docs.docker.com/engine/api/v1.40/#operation/ServiceList Tasks: https://docs.docker.com/engine/api/v1.40/#operation/TaskList Nodes: https://docs.docker.com/engine/api/v1.40/#operation/NodeList
+     */
     @JsonProperty("filters")
     public void setFilters(List<Filter> filters) {
         this.filters = filters;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public Boolean getFollowRedirects() {
         return followRedirects;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public void setFollowRedirects(Boolean followRedirects) {
         this.followRedirects = followRedirects;
     }
 
+    /**
+     * Address of the Docker daemon
+     */
     @JsonProperty("host")
     public String getHost() {
         return host;
     }
 
+    /**
+     * Address of the Docker daemon
+     */
     @JsonProperty("host")
     public void setHost(String host) {
         this.host = host;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * DockerSwarmSDConfig configurations allow retrieving scrape targets from Docker Swarm engine. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#dockerswarm_sd_config
+     */
     @JsonProperty("oauth2")
     public OAuth2 getOauth2() {
         return oauth2;
     }
 
+    /**
+     * DockerSwarmSDConfig configurations allow retrieving scrape targets from Docker Swarm engine. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#dockerswarm_sd_config
+     */
     @JsonProperty("oauth2")
     public void setOauth2(OAuth2 oauth2) {
         this.oauth2 = oauth2;
     }
 
+    /**
+     * The port to scrape metrics from, when `role` is nodes, and for discovered tasks and services that don't have published ports.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * The port to scrape metrics from, when `role` is nodes, and for discovered tasks and services that don't have published ports.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<SecretKeySelector>> getProxyConnectHeader() {
         return proxyConnectHeader;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     public void setProxyConnectHeader(Map<String, List<SecretKeySelector>> proxyConnectHeader) {
         this.proxyConnectHeader = proxyConnectHeader;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public Boolean getProxyFromEnvironment() {
         return proxyFromEnvironment;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public void setProxyFromEnvironment(Boolean proxyFromEnvironment) {
         this.proxyFromEnvironment = proxyFromEnvironment;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public String getProxyUrl() {
         return proxyUrl;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public void setProxyUrl(String proxyUrl) {
         this.proxyUrl = proxyUrl;
     }
 
+    /**
+     * The time after which the service discovery data is refreshed.
+     */
     @JsonProperty("refreshInterval")
     public String getRefreshInterval() {
         return refreshInterval;
     }
 
+    /**
+     * The time after which the service discovery data is refreshed.
+     */
     @JsonProperty("refreshInterval")
     public void setRefreshInterval(String refreshInterval) {
         this.refreshInterval = refreshInterval;
     }
 
+    /**
+     * Role of the targets to retrieve. Must be `Services`, `Tasks`, or `Nodes`.
+     */
     @JsonProperty("role")
     public String getRole() {
         return role;
     }
 
+    /**
+     * Role of the targets to retrieve. Must be `Services`, `Tasks`, or `Nodes`.
+     */
     @JsonProperty("role")
     public void setRole(String role) {
         this.role = role;
     }
 
+    /**
+     * DockerSwarmSDConfig configurations allow retrieving scrape targets from Docker Swarm engine. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#dockerswarm_sd_config
+     */
     @JsonProperty("tlsConfig")
     public SafeTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * DockerSwarmSDConfig configurations allow retrieving scrape targets from Docker Swarm engine. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#dockerswarm_sd_config
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(SafeTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/EC2SDConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/EC2SDConfig.java
index 7fd764210c9..fe13750549a 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/EC2SDConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/EC2SDConfig.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EC2SDConfig allow retrieving scrape targets from AWS EC2 instances. The private IP address is used by default, but may be changed to the public IP address with relabeling. The IAM credentials used must have the ec2:DescribeInstances permission to discover scrape targets See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#ec2_sd_config<br><p> <br><p> The EC2 service discovery requires AWS API keys or role ARN for authentication. BasicAuth, Authorization and OAuth2 fields are not present on purpose.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -136,143 +139,227 @@ public EC2SDConfig(SecretKeySelector accessKey, Boolean enableHTTP2, List<Filter
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * EC2SDConfig allow retrieving scrape targets from AWS EC2 instances. The private IP address is used by default, but may be changed to the public IP address with relabeling. The IAM credentials used must have the ec2:DescribeInstances permission to discover scrape targets See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#ec2_sd_config<br><p> <br><p> The EC2 service discovery requires AWS API keys or role ARN for authentication. BasicAuth, Authorization and OAuth2 fields are not present on purpose.
+     */
     @JsonProperty("accessKey")
     public SecretKeySelector getAccessKey() {
         return accessKey;
     }
 
+    /**
+     * EC2SDConfig allow retrieving scrape targets from AWS EC2 instances. The private IP address is used by default, but may be changed to the public IP address with relabeling. The IAM credentials used must have the ec2:DescribeInstances permission to discover scrape targets See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#ec2_sd_config<br><p> <br><p> The EC2 service discovery requires AWS API keys or role ARN for authentication. BasicAuth, Authorization and OAuth2 fields are not present on purpose.
+     */
     @JsonProperty("accessKey")
     public void setAccessKey(SecretKeySelector accessKey) {
         this.accessKey = accessKey;
     }
 
+    /**
+     * Whether to enable HTTP2. It requires Prometheus &gt;= v2.41.0
+     */
     @JsonProperty("enableHTTP2")
     public Boolean getEnableHTTP2() {
         return enableHTTP2;
     }
 
+    /**
+     * Whether to enable HTTP2. It requires Prometheus &gt;= v2.41.0
+     */
     @JsonProperty("enableHTTP2")
     public void setEnableHTTP2(Boolean enableHTTP2) {
         this.enableHTTP2 = enableHTTP2;
     }
 
+    /**
+     * Filters can be used optionally to filter the instance list by other criteria. Available filter criteria can be found here: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html Filter API documentation: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_Filter.html It requires Prometheus &gt;= v2.3.0
+     */
     @JsonProperty("filters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Filter> getFilters() {
         return filters;
     }
 
+    /**
+     * Filters can be used optionally to filter the instance list by other criteria. Available filter criteria can be found here: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html Filter API documentation: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_Filter.html It requires Prometheus &gt;= v2.3.0
+     */
     @JsonProperty("filters")
     public void setFilters(List<Filter> filters) {
         this.filters = filters;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects. It requires Prometheus &gt;= v2.41.0
+     */
     @JsonProperty("followRedirects")
     public Boolean getFollowRedirects() {
         return followRedirects;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects. It requires Prometheus &gt;= v2.41.0
+     */
     @JsonProperty("followRedirects")
     public void setFollowRedirects(Boolean followRedirects) {
         this.followRedirects = followRedirects;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * The port to scrape metrics from. If using the public IP address, this must instead be specified in the relabeling rule.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * The port to scrape metrics from. If using the public IP address, this must instead be specified in the relabeling rule.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<SecretKeySelector>> getProxyConnectHeader() {
         return proxyConnectHeader;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     public void setProxyConnectHeader(Map<String, List<SecretKeySelector>> proxyConnectHeader) {
         this.proxyConnectHeader = proxyConnectHeader;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public Boolean getProxyFromEnvironment() {
         return proxyFromEnvironment;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public void setProxyFromEnvironment(Boolean proxyFromEnvironment) {
         this.proxyFromEnvironment = proxyFromEnvironment;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public String getProxyUrl() {
         return proxyUrl;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public void setProxyUrl(String proxyUrl) {
         this.proxyUrl = proxyUrl;
     }
 
+    /**
+     * RefreshInterval configures the refresh interval at which Prometheus will re-read the instance list.
+     */
     @JsonProperty("refreshInterval")
     public String getRefreshInterval() {
         return refreshInterval;
     }
 
+    /**
+     * RefreshInterval configures the refresh interval at which Prometheus will re-read the instance list.
+     */
     @JsonProperty("refreshInterval")
     public void setRefreshInterval(String refreshInterval) {
         this.refreshInterval = refreshInterval;
     }
 
+    /**
+     * The AWS region.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * The AWS region.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * AWS Role ARN, an alternative to using AWS API keys.
+     */
     @JsonProperty("roleARN")
     public String getRoleARN() {
         return roleARN;
     }
 
+    /**
+     * AWS Role ARN, an alternative to using AWS API keys.
+     */
     @JsonProperty("roleARN")
     public void setRoleARN(String roleARN) {
         this.roleARN = roleARN;
     }
 
+    /**
+     * EC2SDConfig allow retrieving scrape targets from AWS EC2 instances. The private IP address is used by default, but may be changed to the public IP address with relabeling. The IAM credentials used must have the ec2:DescribeInstances permission to discover scrape targets See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#ec2_sd_config<br><p> <br><p> The EC2 service discovery requires AWS API keys or role ARN for authentication. BasicAuth, Authorization and OAuth2 fields are not present on purpose.
+     */
     @JsonProperty("secretKey")
     public SecretKeySelector getSecretKey() {
         return secretKey;
     }
 
+    /**
+     * EC2SDConfig allow retrieving scrape targets from AWS EC2 instances. The private IP address is used by default, but may be changed to the public IP address with relabeling. The IAM credentials used must have the ec2:DescribeInstances permission to discover scrape targets See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#ec2_sd_config<br><p> <br><p> The EC2 service discovery requires AWS API keys or role ARN for authentication. BasicAuth, Authorization and OAuth2 fields are not present on purpose.
+     */
     @JsonProperty("secretKey")
     public void setSecretKey(SecretKeySelector secretKey) {
         this.secretKey = secretKey;
     }
 
+    /**
+     * EC2SDConfig allow retrieving scrape targets from AWS EC2 instances. The private IP address is used by default, but may be changed to the public IP address with relabeling. The IAM credentials used must have the ec2:DescribeInstances permission to discover scrape targets See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#ec2_sd_config<br><p> <br><p> The EC2 service discovery requires AWS API keys or role ARN for authentication. BasicAuth, Authorization and OAuth2 fields are not present on purpose.
+     */
     @JsonProperty("tlsConfig")
     public SafeTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * EC2SDConfig allow retrieving scrape targets from AWS EC2 instances. The private IP address is used by default, but may be changed to the public IP address with relabeling. The IAM credentials used must have the ec2:DescribeInstances permission to discover scrape targets See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#ec2_sd_config<br><p> <br><p> The EC2 service discovery requires AWS API keys or role ARN for authentication. BasicAuth, Authorization and OAuth2 fields are not present on purpose.
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(SafeTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/EmailConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/EmailConfig.java
index 766373ba616..c2b82a519f7 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/EmailConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/EmailConfig.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EmailConfig configures notifications via Email.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -135,142 +138,226 @@ public EmailConfig(String authIdentity, SecretKeySelector authPassword, SecretKe
         this.to = to;
     }
 
+    /**
+     * The identity to use for authentication.
+     */
     @JsonProperty("authIdentity")
     public String getAuthIdentity() {
         return authIdentity;
     }
 
+    /**
+     * The identity to use for authentication.
+     */
     @JsonProperty("authIdentity")
     public void setAuthIdentity(String authIdentity) {
         this.authIdentity = authIdentity;
     }
 
+    /**
+     * EmailConfig configures notifications via Email.
+     */
     @JsonProperty("authPassword")
     public SecretKeySelector getAuthPassword() {
         return authPassword;
     }
 
+    /**
+     * EmailConfig configures notifications via Email.
+     */
     @JsonProperty("authPassword")
     public void setAuthPassword(SecretKeySelector authPassword) {
         this.authPassword = authPassword;
     }
 
+    /**
+     * EmailConfig configures notifications via Email.
+     */
     @JsonProperty("authSecret")
     public SecretKeySelector getAuthSecret() {
         return authSecret;
     }
 
+    /**
+     * EmailConfig configures notifications via Email.
+     */
     @JsonProperty("authSecret")
     public void setAuthSecret(SecretKeySelector authSecret) {
         this.authSecret = authSecret;
     }
 
+    /**
+     * The username to use for authentication.
+     */
     @JsonProperty("authUsername")
     public String getAuthUsername() {
         return authUsername;
     }
 
+    /**
+     * The username to use for authentication.
+     */
     @JsonProperty("authUsername")
     public void setAuthUsername(String authUsername) {
         this.authUsername = authUsername;
     }
 
+    /**
+     * The sender address.
+     */
     @JsonProperty("from")
     public String getFrom() {
         return from;
     }
 
+    /**
+     * The sender address.
+     */
     @JsonProperty("from")
     public void setFrom(String from) {
         this.from = from;
     }
 
+    /**
+     * Further headers email header key/value pairs. Overrides any headers previously set by the notification implementation.
+     */
     @JsonProperty("headers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<KeyValue> getHeaders() {
         return headers;
     }
 
+    /**
+     * Further headers email header key/value pairs. Overrides any headers previously set by the notification implementation.
+     */
     @JsonProperty("headers")
     public void setHeaders(List<KeyValue> headers) {
         this.headers = headers;
     }
 
+    /**
+     * The hostname to identify to the SMTP server.
+     */
     @JsonProperty("hello")
     public String getHello() {
         return hello;
     }
 
+    /**
+     * The hostname to identify to the SMTP server.
+     */
     @JsonProperty("hello")
     public void setHello(String hello) {
         this.hello = hello;
     }
 
+    /**
+     * The HTML body of the email notification.
+     */
     @JsonProperty("html")
     public String getHtml() {
         return html;
     }
 
+    /**
+     * The HTML body of the email notification.
+     */
     @JsonProperty("html")
     public void setHtml(String html) {
         this.html = html;
     }
 
+    /**
+     * The SMTP TLS requirement. Note that Go does not support unencrypted connections to remote SMTP endpoints.
+     */
     @JsonProperty("requireTLS")
     public Boolean getRequireTLS() {
         return requireTLS;
     }
 
+    /**
+     * The SMTP TLS requirement. Note that Go does not support unencrypted connections to remote SMTP endpoints.
+     */
     @JsonProperty("requireTLS")
     public void setRequireTLS(Boolean requireTLS) {
         this.requireTLS = requireTLS;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public Boolean getSendResolved() {
         return sendResolved;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public void setSendResolved(Boolean sendResolved) {
         this.sendResolved = sendResolved;
     }
 
+    /**
+     * The SMTP host and port through which emails are sent. E.g. example.com:25
+     */
     @JsonProperty("smarthost")
     public String getSmarthost() {
         return smarthost;
     }
 
+    /**
+     * The SMTP host and port through which emails are sent. E.g. example.com:25
+     */
     @JsonProperty("smarthost")
     public void setSmarthost(String smarthost) {
         this.smarthost = smarthost;
     }
 
+    /**
+     * The text body of the email notification.
+     */
     @JsonProperty("text")
     public String getText() {
         return text;
     }
 
+    /**
+     * The text body of the email notification.
+     */
     @JsonProperty("text")
     public void setText(String text) {
         this.text = text;
     }
 
+    /**
+     * EmailConfig configures notifications via Email.
+     */
     @JsonProperty("tlsConfig")
     public SafeTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * EmailConfig configures notifications via Email.
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(SafeTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * The email address to send notifications to.
+     */
     @JsonProperty("to")
     public String getTo() {
         return to;
     }
 
+    /**
+     * The email address to send notifications to.
+     */
     @JsonProperty("to")
     public void setTo(String to) {
         this.to = to;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/EurekaSDConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/EurekaSDConfig.java
index 72d34cbfcbc..0b8dfc8a256 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/EurekaSDConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/EurekaSDConfig.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Eureka SD configurations allow retrieving scrape targets using the Eureka REST API. Prometheus will periodically check the REST endpoint and create a target for every app instance. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#eureka_sd_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -129,122 +132,194 @@ public EurekaSDConfig(SafeAuthorization authorization, BasicAuth basicAuth, Bool
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * Eureka SD configurations allow retrieving scrape targets using the Eureka REST API. Prometheus will periodically check the REST endpoint and create a target for every app instance. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#eureka_sd_config
+     */
     @JsonProperty("authorization")
     public SafeAuthorization getAuthorization() {
         return authorization;
     }
 
+    /**
+     * Eureka SD configurations allow retrieving scrape targets using the Eureka REST API. Prometheus will periodically check the REST endpoint and create a target for every app instance. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#eureka_sd_config
+     */
     @JsonProperty("authorization")
     public void setAuthorization(SafeAuthorization authorization) {
         this.authorization = authorization;
     }
 
+    /**
+     * Eureka SD configurations allow retrieving scrape targets using the Eureka REST API. Prometheus will periodically check the REST endpoint and create a target for every app instance. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#eureka_sd_config
+     */
     @JsonProperty("basicAuth")
     public BasicAuth getBasicAuth() {
         return basicAuth;
     }
 
+    /**
+     * Eureka SD configurations allow retrieving scrape targets using the Eureka REST API. Prometheus will periodically check the REST endpoint and create a target for every app instance. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#eureka_sd_config
+     */
     @JsonProperty("basicAuth")
     public void setBasicAuth(BasicAuth basicAuth) {
         this.basicAuth = basicAuth;
     }
 
+    /**
+     * Whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public Boolean getEnableHTTP2() {
         return enableHTTP2;
     }
 
+    /**
+     * Whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public void setEnableHTTP2(Boolean enableHTTP2) {
         this.enableHTTP2 = enableHTTP2;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public Boolean getFollowRedirects() {
         return followRedirects;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public void setFollowRedirects(Boolean followRedirects) {
         this.followRedirects = followRedirects;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * Eureka SD configurations allow retrieving scrape targets using the Eureka REST API. Prometheus will periodically check the REST endpoint and create a target for every app instance. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#eureka_sd_config
+     */
     @JsonProperty("oauth2")
     public OAuth2 getOauth2() {
         return oauth2;
     }
 
+    /**
+     * Eureka SD configurations allow retrieving scrape targets using the Eureka REST API. Prometheus will periodically check the REST endpoint and create a target for every app instance. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#eureka_sd_config
+     */
     @JsonProperty("oauth2")
     public void setOauth2(OAuth2 oauth2) {
         this.oauth2 = oauth2;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<SecretKeySelector>> getProxyConnectHeader() {
         return proxyConnectHeader;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     public void setProxyConnectHeader(Map<String, List<SecretKeySelector>> proxyConnectHeader) {
         this.proxyConnectHeader = proxyConnectHeader;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public Boolean getProxyFromEnvironment() {
         return proxyFromEnvironment;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public void setProxyFromEnvironment(Boolean proxyFromEnvironment) {
         this.proxyFromEnvironment = proxyFromEnvironment;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public String getProxyUrl() {
         return proxyUrl;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public void setProxyUrl(String proxyUrl) {
         this.proxyUrl = proxyUrl;
     }
 
+    /**
+     * Refresh interval to re-read the instance list.
+     */
     @JsonProperty("refreshInterval")
     public String getRefreshInterval() {
         return refreshInterval;
     }
 
+    /**
+     * Refresh interval to re-read the instance list.
+     */
     @JsonProperty("refreshInterval")
     public void setRefreshInterval(String refreshInterval) {
         this.refreshInterval = refreshInterval;
     }
 
+    /**
+     * The URL to connect to the Eureka server.
+     */
     @JsonProperty("server")
     public String getServer() {
         return server;
     }
 
+    /**
+     * The URL to connect to the Eureka server.
+     */
     @JsonProperty("server")
     public void setServer(String server) {
         this.server = server;
     }
 
+    /**
+     * Eureka SD configurations allow retrieving scrape targets using the Eureka REST API. Prometheus will periodically check the REST endpoint and create a target for every app instance. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#eureka_sd_config
+     */
     @JsonProperty("tlsConfig")
     public SafeTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * Eureka SD configurations allow retrieving scrape targets using the Eureka REST API. Prometheus will periodically check the REST endpoint and create a target for every app instance. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#eureka_sd_config
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(SafeTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/FileSDConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/FileSDConfig.java
index 5d7fbbad447..ba66a6e6741 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/FileSDConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/FileSDConfig.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FileSDConfig defines a Prometheus file service discovery configuration See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#file_sd_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public FileSDConfig(List<String> files, String refreshInterval) {
         this.refreshInterval = refreshInterval;
     }
 
+    /**
+     * List of files to be used for file discovery. Recommendation: use absolute paths. While relative paths work, the prometheus-operator project makes no guarantees about the working directory where the configuration file is stored. Files must be mounted using Prometheus.ConfigMaps or Prometheus.Secrets.
+     */
     @JsonProperty("files")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getFiles() {
         return files;
     }
 
+    /**
+     * List of files to be used for file discovery. Recommendation: use absolute paths. While relative paths work, the prometheus-operator project makes no guarantees about the working directory where the configuration file is stored. Files must be mounted using Prometheus.ConfigMaps or Prometheus.Secrets.
+     */
     @JsonProperty("files")
     public void setFiles(List<String> files) {
         this.files = files;
     }
 
+    /**
+     * RefreshInterval configures the refresh interval at which Prometheus will reload the content of the files.
+     */
     @JsonProperty("refreshInterval")
     public String getRefreshInterval() {
         return refreshInterval;
     }
 
+    /**
+     * RefreshInterval configures the refresh interval at which Prometheus will reload the content of the files.
+     */
     @JsonProperty("refreshInterval")
     public void setRefreshInterval(String refreshInterval) {
         this.refreshInterval = refreshInterval;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/Filter.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/Filter.java
index 746b20861ac..45e65f539c3 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/Filter.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/Filter.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Filter name and value pairs to limit the discovery process to a subset of available resources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public Filter(String name, List<String> values) {
         this.values = values;
     }
 
+    /**
+     * Name of the Filter.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the Filter.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Value to filter on.
+     */
     @JsonProperty("values")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getValues() {
         return values;
     }
 
+    /**
+     * Value to filter on.
+     */
     @JsonProperty("values")
     public void setValues(List<String> values) {
         this.values = values;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/GCESDConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/GCESDConfig.java
index c11617039f7..06a4cd07652 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/GCESDConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/GCESDConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCESDConfig configures scrape targets from GCP GCE instances. The private IP address is used by default, but may be changed to the public IP address with relabeling. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#gce_sd_config<br><p> <br><p> The GCE service discovery will load the Google Cloud credentials from the file specified by the GOOGLE_APPLICATION_CREDENTIALS environment variable. See https://cloud.google.com/kubernetes-engine/docs/tutorials/authenticating-to-cloud-platform<br><p> <br><p> A pre-requisite for using GCESDConfig is that a Secret containing valid Google Cloud credentials is mounted into the Prometheus or PrometheusAgent pod via the `.spec.secrets` field and that the GOOGLE_APPLICATION_CREDENTIALS environment variable is set to /etc/prometheus/secrets/&lt;secret-name&gt;/&lt;credentials-filename.json&gt;.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public GCESDConfig(String filter, Integer port, String project, String refreshIn
         this.zone = zone;
     }
 
+    /**
+     * Filter can be used optionally to filter the instance list by other criteria Syntax of this filter is described in the filter query parameter section: https://cloud.google.com/compute/docs/reference/latest/instances/list
+     */
     @JsonProperty("filter")
     public String getFilter() {
         return filter;
     }
 
+    /**
+     * Filter can be used optionally to filter the instance list by other criteria Syntax of this filter is described in the filter query parameter section: https://cloud.google.com/compute/docs/reference/latest/instances/list
+     */
     @JsonProperty("filter")
     public void setFilter(String filter) {
         this.filter = filter;
     }
 
+    /**
+     * The port to scrape metrics from. If using the public IP address, this must instead be specified in the relabeling rule.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * The port to scrape metrics from. If using the public IP address, this must instead be specified in the relabeling rule.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * The Google Cloud Project ID
+     */
     @JsonProperty("project")
     public String getProject() {
         return project;
     }
 
+    /**
+     * The Google Cloud Project ID
+     */
     @JsonProperty("project")
     public void setProject(String project) {
         this.project = project;
     }
 
+    /**
+     * RefreshInterval configures the refresh interval at which Prometheus will re-read the instance list.
+     */
     @JsonProperty("refreshInterval")
     public String getRefreshInterval() {
         return refreshInterval;
     }
 
+    /**
+     * RefreshInterval configures the refresh interval at which Prometheus will re-read the instance list.
+     */
     @JsonProperty("refreshInterval")
     public void setRefreshInterval(String refreshInterval) {
         this.refreshInterval = refreshInterval;
     }
 
+    /**
+     * The tag separator is used to separate the tags on concatenation
+     */
     @JsonProperty("tagSeparator")
     public String getTagSeparator() {
         return tagSeparator;
     }
 
+    /**
+     * The tag separator is used to separate the tags on concatenation
+     */
     @JsonProperty("tagSeparator")
     public void setTagSeparator(String tagSeparator) {
         this.tagSeparator = tagSeparator;
     }
 
+    /**
+     * The zone of the scrape targets. If you need multiple zones use multiple GCESDConfigs.
+     */
     @JsonProperty("zone")
     public String getZone() {
         return zone;
     }
 
+    /**
+     * The zone of the scrape targets. If you need multiple zones use multiple GCESDConfigs.
+     */
     @JsonProperty("zone")
     public void setZone(String zone) {
         this.zone = zone;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/HTTPConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/HTTPConfig.java
index 163d4c3b5d2..231dc8c2279 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/HTTPConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/HTTPConfig.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -125,112 +128,178 @@ public HTTPConfig(SafeAuthorization authorization, BasicAuth basicAuth, SecretKe
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("authorization")
     public SafeAuthorization getAuthorization() {
         return authorization;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("authorization")
     public void setAuthorization(SafeAuthorization authorization) {
         this.authorization = authorization;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("basicAuth")
     public BasicAuth getBasicAuth() {
         return basicAuth;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("basicAuth")
     public void setBasicAuth(BasicAuth basicAuth) {
         this.basicAuth = basicAuth;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("bearerTokenSecret")
     public SecretKeySelector getBearerTokenSecret() {
         return bearerTokenSecret;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("bearerTokenSecret")
     public void setBearerTokenSecret(SecretKeySelector bearerTokenSecret) {
         this.bearerTokenSecret = bearerTokenSecret;
     }
 
+    /**
+     * FollowRedirects specifies whether the client should follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public Boolean getFollowRedirects() {
         return followRedirects;
     }
 
+    /**
+     * FollowRedirects specifies whether the client should follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public void setFollowRedirects(Boolean followRedirects) {
         this.followRedirects = followRedirects;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("oauth2")
     public OAuth2 getOauth2() {
         return oauth2;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("oauth2")
     public void setOauth2(OAuth2 oauth2) {
         this.oauth2 = oauth2;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<SecretKeySelector>> getProxyConnectHeader() {
         return proxyConnectHeader;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     public void setProxyConnectHeader(Map<String, List<SecretKeySelector>> proxyConnectHeader) {
         this.proxyConnectHeader = proxyConnectHeader;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public Boolean getProxyFromEnvironment() {
         return proxyFromEnvironment;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public void setProxyFromEnvironment(Boolean proxyFromEnvironment) {
         this.proxyFromEnvironment = proxyFromEnvironment;
     }
 
+    /**
+     * Optional proxy URL.<br><p> <br><p> If defined, this field takes precedence over `proxyUrl`.
+     */
     @JsonProperty("proxyURL")
     public String getProxyURL() {
         return proxyURL;
     }
 
+    /**
+     * Optional proxy URL.<br><p> <br><p> If defined, this field takes precedence over `proxyUrl`.
+     */
     @JsonProperty("proxyURL")
     public void setProxyURL(String proxyURL) {
         this.proxyURL = proxyURL;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public String getProxyUrl() {
         return proxyUrl;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public void setProxyUrl(String proxyUrl) {
         this.proxyUrl = proxyUrl;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("tlsConfig")
     public SafeTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(SafeTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/HTTPSDConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/HTTPSDConfig.java
index ab5804db448..e79eb2bde48 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/HTTPSDConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/HTTPSDConfig.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPSDConfig defines a prometheus HTTP service discovery configuration See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#http_sd_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -129,122 +132,194 @@ public HTTPSDConfig(SafeAuthorization authorization, BasicAuth basicAuth, Boolea
         this.url = url;
     }
 
+    /**
+     * HTTPSDConfig defines a prometheus HTTP service discovery configuration See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#http_sd_config
+     */
     @JsonProperty("authorization")
     public SafeAuthorization getAuthorization() {
         return authorization;
     }
 
+    /**
+     * HTTPSDConfig defines a prometheus HTTP service discovery configuration See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#http_sd_config
+     */
     @JsonProperty("authorization")
     public void setAuthorization(SafeAuthorization authorization) {
         this.authorization = authorization;
     }
 
+    /**
+     * HTTPSDConfig defines a prometheus HTTP service discovery configuration See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#http_sd_config
+     */
     @JsonProperty("basicAuth")
     public BasicAuth getBasicAuth() {
         return basicAuth;
     }
 
+    /**
+     * HTTPSDConfig defines a prometheus HTTP service discovery configuration See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#http_sd_config
+     */
     @JsonProperty("basicAuth")
     public void setBasicAuth(BasicAuth basicAuth) {
         this.basicAuth = basicAuth;
     }
 
+    /**
+     * Whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public Boolean getEnableHTTP2() {
         return enableHTTP2;
     }
 
+    /**
+     * Whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public void setEnableHTTP2(Boolean enableHTTP2) {
         this.enableHTTP2 = enableHTTP2;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public Boolean getFollowRedirects() {
         return followRedirects;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public void setFollowRedirects(Boolean followRedirects) {
         this.followRedirects = followRedirects;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * HTTPSDConfig defines a prometheus HTTP service discovery configuration See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#http_sd_config
+     */
     @JsonProperty("oauth2")
     public OAuth2 getOauth2() {
         return oauth2;
     }
 
+    /**
+     * HTTPSDConfig defines a prometheus HTTP service discovery configuration See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#http_sd_config
+     */
     @JsonProperty("oauth2")
     public void setOauth2(OAuth2 oauth2) {
         this.oauth2 = oauth2;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<SecretKeySelector>> getProxyConnectHeader() {
         return proxyConnectHeader;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     public void setProxyConnectHeader(Map<String, List<SecretKeySelector>> proxyConnectHeader) {
         this.proxyConnectHeader = proxyConnectHeader;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public Boolean getProxyFromEnvironment() {
         return proxyFromEnvironment;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public void setProxyFromEnvironment(Boolean proxyFromEnvironment) {
         this.proxyFromEnvironment = proxyFromEnvironment;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public String getProxyUrl() {
         return proxyUrl;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public void setProxyUrl(String proxyUrl) {
         this.proxyUrl = proxyUrl;
     }
 
+    /**
+     * RefreshInterval configures the refresh interval at which Prometheus will re-query the endpoint to update the target list.
+     */
     @JsonProperty("refreshInterval")
     public String getRefreshInterval() {
         return refreshInterval;
     }
 
+    /**
+     * RefreshInterval configures the refresh interval at which Prometheus will re-query the endpoint to update the target list.
+     */
     @JsonProperty("refreshInterval")
     public void setRefreshInterval(String refreshInterval) {
         this.refreshInterval = refreshInterval;
     }
 
+    /**
+     * HTTPSDConfig defines a prometheus HTTP service discovery configuration See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#http_sd_config
+     */
     @JsonProperty("tlsConfig")
     public SafeTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * HTTPSDConfig defines a prometheus HTTP service discovery configuration See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#http_sd_config
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(SafeTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * URL from which the targets are fetched.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * URL from which the targets are fetched.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/HetznerSDConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/HetznerSDConfig.java
index 61eec80caa4..abd960c4dbb 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/HetznerSDConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/HetznerSDConfig.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HetznerSDConfig allow retrieving scrape targets from Hetzner Cloud API and Robot API. This service discovery uses the public IPv4 address by default, but that can be changed with relabeling See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#hetzner_sd_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -133,132 +136,210 @@ public HetznerSDConfig(SafeAuthorization authorization, BasicAuth basicAuth, Boo
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * HetznerSDConfig allow retrieving scrape targets from Hetzner Cloud API and Robot API. This service discovery uses the public IPv4 address by default, but that can be changed with relabeling See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#hetzner_sd_config
+     */
     @JsonProperty("authorization")
     public SafeAuthorization getAuthorization() {
         return authorization;
     }
 
+    /**
+     * HetznerSDConfig allow retrieving scrape targets from Hetzner Cloud API and Robot API. This service discovery uses the public IPv4 address by default, but that can be changed with relabeling See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#hetzner_sd_config
+     */
     @JsonProperty("authorization")
     public void setAuthorization(SafeAuthorization authorization) {
         this.authorization = authorization;
     }
 
+    /**
+     * HetznerSDConfig allow retrieving scrape targets from Hetzner Cloud API and Robot API. This service discovery uses the public IPv4 address by default, but that can be changed with relabeling See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#hetzner_sd_config
+     */
     @JsonProperty("basicAuth")
     public BasicAuth getBasicAuth() {
         return basicAuth;
     }
 
+    /**
+     * HetznerSDConfig allow retrieving scrape targets from Hetzner Cloud API and Robot API. This service discovery uses the public IPv4 address by default, but that can be changed with relabeling See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#hetzner_sd_config
+     */
     @JsonProperty("basicAuth")
     public void setBasicAuth(BasicAuth basicAuth) {
         this.basicAuth = basicAuth;
     }
 
+    /**
+     * Whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public Boolean getEnableHTTP2() {
         return enableHTTP2;
     }
 
+    /**
+     * Whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public void setEnableHTTP2(Boolean enableHTTP2) {
         this.enableHTTP2 = enableHTTP2;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public Boolean getFollowRedirects() {
         return followRedirects;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public void setFollowRedirects(Boolean followRedirects) {
         this.followRedirects = followRedirects;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * HetznerSDConfig allow retrieving scrape targets from Hetzner Cloud API and Robot API. This service discovery uses the public IPv4 address by default, but that can be changed with relabeling See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#hetzner_sd_config
+     */
     @JsonProperty("oauth2")
     public OAuth2 getOauth2() {
         return oauth2;
     }
 
+    /**
+     * HetznerSDConfig allow retrieving scrape targets from Hetzner Cloud API and Robot API. This service discovery uses the public IPv4 address by default, but that can be changed with relabeling See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#hetzner_sd_config
+     */
     @JsonProperty("oauth2")
     public void setOauth2(OAuth2 oauth2) {
         this.oauth2 = oauth2;
     }
 
+    /**
+     * The port to scrape metrics from.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * The port to scrape metrics from.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<SecretKeySelector>> getProxyConnectHeader() {
         return proxyConnectHeader;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     public void setProxyConnectHeader(Map<String, List<SecretKeySelector>> proxyConnectHeader) {
         this.proxyConnectHeader = proxyConnectHeader;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public Boolean getProxyFromEnvironment() {
         return proxyFromEnvironment;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public void setProxyFromEnvironment(Boolean proxyFromEnvironment) {
         this.proxyFromEnvironment = proxyFromEnvironment;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public String getProxyUrl() {
         return proxyUrl;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public void setProxyUrl(String proxyUrl) {
         this.proxyUrl = proxyUrl;
     }
 
+    /**
+     * The time after which the servers are refreshed.
+     */
     @JsonProperty("refreshInterval")
     public String getRefreshInterval() {
         return refreshInterval;
     }
 
+    /**
+     * The time after which the servers are refreshed.
+     */
     @JsonProperty("refreshInterval")
     public void setRefreshInterval(String refreshInterval) {
         this.refreshInterval = refreshInterval;
     }
 
+    /**
+     * The Hetzner role of entities that should be discovered.
+     */
     @JsonProperty("role")
     public String getRole() {
         return role;
     }
 
+    /**
+     * The Hetzner role of entities that should be discovered.
+     */
     @JsonProperty("role")
     public void setRole(String role) {
         this.role = role;
     }
 
+    /**
+     * HetznerSDConfig allow retrieving scrape targets from Hetzner Cloud API and Robot API. This service discovery uses the public IPv4 address by default, but that can be changed with relabeling See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#hetzner_sd_config
+     */
     @JsonProperty("tlsConfig")
     public SafeTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * HetznerSDConfig allow retrieving scrape targets from Hetzner Cloud API and Robot API. This service discovery uses the public IPv4 address by default, but that can be changed with relabeling See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#hetzner_sd_config
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(SafeTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/InhibitRule.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/InhibitRule.java
index 7a9ecccab80..89db2978879 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/InhibitRule.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/InhibitRule.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * InhibitRule defines an inhibition rule that allows to mute alerts when other alerts are already firing. See https://prometheus.io/docs/alerting/latest/configuration/#inhibit_rule
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,34 +94,52 @@ public InhibitRule(List<String> equal, List<Matcher> sourceMatch, List<Matcher>
         this.targetMatch = targetMatch;
     }
 
+    /**
+     * Labels that must have an equal value in the source and target alert for the inhibition to take effect.
+     */
     @JsonProperty("equal")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEqual() {
         return equal;
     }
 
+    /**
+     * Labels that must have an equal value in the source and target alert for the inhibition to take effect.
+     */
     @JsonProperty("equal")
     public void setEqual(List<String> equal) {
         this.equal = equal;
     }
 
+    /**
+     * Matchers for which one or more alerts have to exist for the inhibition to take effect. The operator enforces that the alert matches the resource's namespace.
+     */
     @JsonProperty("sourceMatch")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Matcher> getSourceMatch() {
         return sourceMatch;
     }
 
+    /**
+     * Matchers for which one or more alerts have to exist for the inhibition to take effect. The operator enforces that the alert matches the resource's namespace.
+     */
     @JsonProperty("sourceMatch")
     public void setSourceMatch(List<Matcher> sourceMatch) {
         this.sourceMatch = sourceMatch;
     }
 
+    /**
+     * Matchers that have to be fulfilled in the alerts to be muted. The operator enforces that the alert matches the resource's namespace.
+     */
     @JsonProperty("targetMatch")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Matcher> getTargetMatch() {
         return targetMatch;
     }
 
+    /**
+     * Matchers that have to be fulfilled in the alerts to be muted. The operator enforces that the alert matches the resource's namespace.
+     */
     @JsonProperty("targetMatch")
     public void setTargetMatch(List<Matcher> targetMatch) {
         this.targetMatch = targetMatch;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/IonosSDConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/IonosSDConfig.java
index 68cea282c88..32b99b608e9 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/IonosSDConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/IonosSDConfig.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IonosSDConfig configurations allow retrieving scrape targets from IONOS resources. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#ionos_sd_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -123,112 +126,178 @@ public IonosSDConfig(SafeAuthorization authorization, String datacenterID, Boole
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * IonosSDConfig configurations allow retrieving scrape targets from IONOS resources. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#ionos_sd_config
+     */
     @JsonProperty("authorization")
     public SafeAuthorization getAuthorization() {
         return authorization;
     }
 
+    /**
+     * IonosSDConfig configurations allow retrieving scrape targets from IONOS resources. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#ionos_sd_config
+     */
     @JsonProperty("authorization")
     public void setAuthorization(SafeAuthorization authorization) {
         this.authorization = authorization;
     }
 
+    /**
+     * The unique ID of the IONOS data center.
+     */
     @JsonProperty("datacenterID")
     public String getDatacenterID() {
         return datacenterID;
     }
 
+    /**
+     * The unique ID of the IONOS data center.
+     */
     @JsonProperty("datacenterID")
     public void setDatacenterID(String datacenterID) {
         this.datacenterID = datacenterID;
     }
 
+    /**
+     * Configure whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public Boolean getEnableHTTP2() {
         return enableHTTP2;
     }
 
+    /**
+     * Configure whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public void setEnableHTTP2(Boolean enableHTTP2) {
         this.enableHTTP2 = enableHTTP2;
     }
 
+    /**
+     * Configure whether the HTTP requests should follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public Boolean getFollowRedirects() {
         return followRedirects;
     }
 
+    /**
+     * Configure whether the HTTP requests should follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public void setFollowRedirects(Boolean followRedirects) {
         this.followRedirects = followRedirects;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * Port to scrape the metrics from.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * Port to scrape the metrics from.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<SecretKeySelector>> getProxyConnectHeader() {
         return proxyConnectHeader;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     public void setProxyConnectHeader(Map<String, List<SecretKeySelector>> proxyConnectHeader) {
         this.proxyConnectHeader = proxyConnectHeader;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public Boolean getProxyFromEnvironment() {
         return proxyFromEnvironment;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public void setProxyFromEnvironment(Boolean proxyFromEnvironment) {
         this.proxyFromEnvironment = proxyFromEnvironment;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public String getProxyUrl() {
         return proxyUrl;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public void setProxyUrl(String proxyUrl) {
         this.proxyUrl = proxyUrl;
     }
 
+    /**
+     * Refresh interval to re-read the list of resources.
+     */
     @JsonProperty("refreshInterval")
     public String getRefreshInterval() {
         return refreshInterval;
     }
 
+    /**
+     * Refresh interval to re-read the list of resources.
+     */
     @JsonProperty("refreshInterval")
     public void setRefreshInterval(String refreshInterval) {
         this.refreshInterval = refreshInterval;
     }
 
+    /**
+     * IonosSDConfig configurations allow retrieving scrape targets from IONOS resources. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#ionos_sd_config
+     */
     @JsonProperty("tlsConfig")
     public SafeTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * IonosSDConfig configurations allow retrieving scrape targets from IONOS resources. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#ionos_sd_config
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(SafeTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/K8SSelectorConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/K8SSelectorConfig.java
index 1757a3be44d..bb80139839e 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/K8SSelectorConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/K8SSelectorConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * K8SSelectorConfig is Kubernetes Selector Config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public K8SSelectorConfig(String field, String label, String role) {
         this.role = role;
     }
 
+    /**
+     * An optional field selector to limit the service discovery to resources which have fields with specific values. e.g: `metadata.name=foobar`
+     */
     @JsonProperty("field")
     public String getField() {
         return field;
     }
 
+    /**
+     * An optional field selector to limit the service discovery to resources which have fields with specific values. e.g: `metadata.name=foobar`
+     */
     @JsonProperty("field")
     public void setField(String field) {
         this.field = field;
     }
 
+    /**
+     * An optional label selector to limit the service discovery to resources with specific labels and label values. e.g: `node.kubernetes.io/instance-type=master`
+     */
     @JsonProperty("label")
     public String getLabel() {
         return label;
     }
 
+    /**
+     * An optional label selector to limit the service discovery to resources with specific labels and label values. e.g: `node.kubernetes.io/instance-type=master`
+     */
     @JsonProperty("label")
     public void setLabel(String label) {
         this.label = label;
     }
 
+    /**
+     * Role specifies the type of Kubernetes resource to limit the service discovery to. Accepted values are: Node, Pod, Endpoints, EndpointSlice, Service, Ingress.
+     */
     @JsonProperty("role")
     public String getRole() {
         return role;
     }
 
+    /**
+     * Role specifies the type of Kubernetes resource to limit the service discovery to. Accepted values are: Node, Pod, Endpoints, EndpointSlice, Service, Ingress.
+     */
     @JsonProperty("role")
     public void setRole(String role) {
         this.role = role;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/KeyValue.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/KeyValue.java
index 5cf3b1717ad..e619c20afd4 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/KeyValue.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/KeyValue.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KeyValue defines a (key, value) tuple.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public KeyValue(String key, String value) {
         this.value = value;
     }
 
+    /**
+     * Key of the tuple.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * Key of the tuple.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * Value of the tuple.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value of the tuple.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/KubernetesSDConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/KubernetesSDConfig.java
index af6424a0499..1813beb7eb1 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/KubernetesSDConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/KubernetesSDConfig.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KubernetesSDConfig allows retrieving scrape targets from Kubernetes' REST API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kubernetes_sd_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -143,153 +146,243 @@ public KubernetesSDConfig(String apiServer, AttachMetadata attachMetadata, SafeA
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * The API server address consisting of a hostname or IP address followed by an optional port number. If left empty, Prometheus is assumed to run inside of the cluster. It will discover API servers automatically and use the pod's CA certificate and bearer token file at /var/run/secrets/kubernetes.io/serviceaccount/.
+     */
     @JsonProperty("apiServer")
     public String getApiServer() {
         return apiServer;
     }
 
+    /**
+     * The API server address consisting of a hostname or IP address followed by an optional port number. If left empty, Prometheus is assumed to run inside of the cluster. It will discover API servers automatically and use the pod's CA certificate and bearer token file at /var/run/secrets/kubernetes.io/serviceaccount/.
+     */
     @JsonProperty("apiServer")
     public void setApiServer(String apiServer) {
         this.apiServer = apiServer;
     }
 
+    /**
+     * KubernetesSDConfig allows retrieving scrape targets from Kubernetes' REST API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kubernetes_sd_config
+     */
     @JsonProperty("attachMetadata")
     public AttachMetadata getAttachMetadata() {
         return attachMetadata;
     }
 
+    /**
+     * KubernetesSDConfig allows retrieving scrape targets from Kubernetes' REST API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kubernetes_sd_config
+     */
     @JsonProperty("attachMetadata")
     public void setAttachMetadata(AttachMetadata attachMetadata) {
         this.attachMetadata = attachMetadata;
     }
 
+    /**
+     * KubernetesSDConfig allows retrieving scrape targets from Kubernetes' REST API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kubernetes_sd_config
+     */
     @JsonProperty("authorization")
     public SafeAuthorization getAuthorization() {
         return authorization;
     }
 
+    /**
+     * KubernetesSDConfig allows retrieving scrape targets from Kubernetes' REST API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kubernetes_sd_config
+     */
     @JsonProperty("authorization")
     public void setAuthorization(SafeAuthorization authorization) {
         this.authorization = authorization;
     }
 
+    /**
+     * KubernetesSDConfig allows retrieving scrape targets from Kubernetes' REST API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kubernetes_sd_config
+     */
     @JsonProperty("basicAuth")
     public BasicAuth getBasicAuth() {
         return basicAuth;
     }
 
+    /**
+     * KubernetesSDConfig allows retrieving scrape targets from Kubernetes' REST API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kubernetes_sd_config
+     */
     @JsonProperty("basicAuth")
     public void setBasicAuth(BasicAuth basicAuth) {
         this.basicAuth = basicAuth;
     }
 
+    /**
+     * Whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public Boolean getEnableHTTP2() {
         return enableHTTP2;
     }
 
+    /**
+     * Whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public void setEnableHTTP2(Boolean enableHTTP2) {
         this.enableHTTP2 = enableHTTP2;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public Boolean getFollowRedirects() {
         return followRedirects;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public void setFollowRedirects(Boolean followRedirects) {
         this.followRedirects = followRedirects;
     }
 
+    /**
+     * KubernetesSDConfig allows retrieving scrape targets from Kubernetes' REST API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kubernetes_sd_config
+     */
     @JsonProperty("namespaces")
     public NamespaceDiscovery getNamespaces() {
         return namespaces;
     }
 
+    /**
+     * KubernetesSDConfig allows retrieving scrape targets from Kubernetes' REST API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kubernetes_sd_config
+     */
     @JsonProperty("namespaces")
     public void setNamespaces(NamespaceDiscovery namespaces) {
         this.namespaces = namespaces;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * KubernetesSDConfig allows retrieving scrape targets from Kubernetes' REST API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kubernetes_sd_config
+     */
     @JsonProperty("oauth2")
     public OAuth2 getOauth2() {
         return oauth2;
     }
 
+    /**
+     * KubernetesSDConfig allows retrieving scrape targets from Kubernetes' REST API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kubernetes_sd_config
+     */
     @JsonProperty("oauth2")
     public void setOauth2(OAuth2 oauth2) {
         this.oauth2 = oauth2;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<SecretKeySelector>> getProxyConnectHeader() {
         return proxyConnectHeader;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     public void setProxyConnectHeader(Map<String, List<SecretKeySelector>> proxyConnectHeader) {
         this.proxyConnectHeader = proxyConnectHeader;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public Boolean getProxyFromEnvironment() {
         return proxyFromEnvironment;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public void setProxyFromEnvironment(Boolean proxyFromEnvironment) {
         this.proxyFromEnvironment = proxyFromEnvironment;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public String getProxyUrl() {
         return proxyUrl;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public void setProxyUrl(String proxyUrl) {
         this.proxyUrl = proxyUrl;
     }
 
+    /**
+     * Role of the Kubernetes entities that should be discovered. Role `Endpointslice` requires Prometheus &gt;= v2.21.0
+     */
     @JsonProperty("role")
     public String getRole() {
         return role;
     }
 
+    /**
+     * Role of the Kubernetes entities that should be discovered. Role `Endpointslice` requires Prometheus &gt;= v2.21.0
+     */
     @JsonProperty("role")
     public void setRole(String role) {
         this.role = role;
     }
 
+    /**
+     * Selector to select objects. It requires Prometheus &gt;= v2.17.0
+     */
     @JsonProperty("selectors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<K8SSelectorConfig> getSelectors() {
         return selectors;
     }
 
+    /**
+     * Selector to select objects. It requires Prometheus &gt;= v2.17.0
+     */
     @JsonProperty("selectors")
     public void setSelectors(List<K8SSelectorConfig> selectors) {
         this.selectors = selectors;
     }
 
+    /**
+     * KubernetesSDConfig allows retrieving scrape targets from Kubernetes' REST API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kubernetes_sd_config
+     */
     @JsonProperty("tlsConfig")
     public SafeTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * KubernetesSDConfig allows retrieving scrape targets from Kubernetes' REST API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kubernetes_sd_config
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(SafeTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/KumaSDConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/KumaSDConfig.java
index 2d719e686b1..ba9db908a78 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/KumaSDConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/KumaSDConfig.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KumaSDConfig allow retrieving scrape targets from Kuma's control plane. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kuma_sd_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -137,142 +140,226 @@ public KumaSDConfig(SafeAuthorization authorization, BasicAuth basicAuth, String
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * KumaSDConfig allow retrieving scrape targets from Kuma's control plane. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kuma_sd_config
+     */
     @JsonProperty("authorization")
     public SafeAuthorization getAuthorization() {
         return authorization;
     }
 
+    /**
+     * KumaSDConfig allow retrieving scrape targets from Kuma's control plane. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kuma_sd_config
+     */
     @JsonProperty("authorization")
     public void setAuthorization(SafeAuthorization authorization) {
         this.authorization = authorization;
     }
 
+    /**
+     * KumaSDConfig allow retrieving scrape targets from Kuma's control plane. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kuma_sd_config
+     */
     @JsonProperty("basicAuth")
     public BasicAuth getBasicAuth() {
         return basicAuth;
     }
 
+    /**
+     * KumaSDConfig allow retrieving scrape targets from Kuma's control plane. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kuma_sd_config
+     */
     @JsonProperty("basicAuth")
     public void setBasicAuth(BasicAuth basicAuth) {
         this.basicAuth = basicAuth;
     }
 
+    /**
+     * Client id is used by Kuma Control Plane to compute Monitoring Assignment for specific Prometheus backend.
+     */
     @JsonProperty("clientID")
     public String getClientID() {
         return clientID;
     }
 
+    /**
+     * Client id is used by Kuma Control Plane to compute Monitoring Assignment for specific Prometheus backend.
+     */
     @JsonProperty("clientID")
     public void setClientID(String clientID) {
         this.clientID = clientID;
     }
 
+    /**
+     * Whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public Boolean getEnableHTTP2() {
         return enableHTTP2;
     }
 
+    /**
+     * Whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public void setEnableHTTP2(Boolean enableHTTP2) {
         this.enableHTTP2 = enableHTTP2;
     }
 
+    /**
+     * The time after which the monitoring assignments are refreshed.
+     */
     @JsonProperty("fetchTimeout")
     public String getFetchTimeout() {
         return fetchTimeout;
     }
 
+    /**
+     * The time after which the monitoring assignments are refreshed.
+     */
     @JsonProperty("fetchTimeout")
     public void setFetchTimeout(String fetchTimeout) {
         this.fetchTimeout = fetchTimeout;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public Boolean getFollowRedirects() {
         return followRedirects;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public void setFollowRedirects(Boolean followRedirects) {
         this.followRedirects = followRedirects;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * KumaSDConfig allow retrieving scrape targets from Kuma's control plane. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kuma_sd_config
+     */
     @JsonProperty("oauth2")
     public OAuth2 getOauth2() {
         return oauth2;
     }
 
+    /**
+     * KumaSDConfig allow retrieving scrape targets from Kuma's control plane. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kuma_sd_config
+     */
     @JsonProperty("oauth2")
     public void setOauth2(OAuth2 oauth2) {
         this.oauth2 = oauth2;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<SecretKeySelector>> getProxyConnectHeader() {
         return proxyConnectHeader;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     public void setProxyConnectHeader(Map<String, List<SecretKeySelector>> proxyConnectHeader) {
         this.proxyConnectHeader = proxyConnectHeader;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public Boolean getProxyFromEnvironment() {
         return proxyFromEnvironment;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public void setProxyFromEnvironment(Boolean proxyFromEnvironment) {
         this.proxyFromEnvironment = proxyFromEnvironment;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public String getProxyUrl() {
         return proxyUrl;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public void setProxyUrl(String proxyUrl) {
         this.proxyUrl = proxyUrl;
     }
 
+    /**
+     * The time to wait between polling update requests.
+     */
     @JsonProperty("refreshInterval")
     public String getRefreshInterval() {
         return refreshInterval;
     }
 
+    /**
+     * The time to wait between polling update requests.
+     */
     @JsonProperty("refreshInterval")
     public void setRefreshInterval(String refreshInterval) {
         this.refreshInterval = refreshInterval;
     }
 
+    /**
+     * Address of the Kuma Control Plane's MADS xDS server.
+     */
     @JsonProperty("server")
     public String getServer() {
         return server;
     }
 
+    /**
+     * Address of the Kuma Control Plane's MADS xDS server.
+     */
     @JsonProperty("server")
     public void setServer(String server) {
         this.server = server;
     }
 
+    /**
+     * KumaSDConfig allow retrieving scrape targets from Kuma's control plane. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kuma_sd_config
+     */
     @JsonProperty("tlsConfig")
     public SafeTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * KumaSDConfig allow retrieving scrape targets from Kuma's control plane. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kuma_sd_config
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(SafeTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/LightSailSDConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/LightSailSDConfig.java
index a8f70db10a7..361a415b1ab 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/LightSailSDConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/LightSailSDConfig.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LightSailSDConfig configurations allow retrieving scrape targets from AWS Lightsail instances. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#lightsail_sd_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -149,172 +152,274 @@ public LightSailSDConfig(SecretKeySelector accessKey, SafeAuthorization authoriz
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * LightSailSDConfig configurations allow retrieving scrape targets from AWS Lightsail instances. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#lightsail_sd_config
+     */
     @JsonProperty("accessKey")
     public SecretKeySelector getAccessKey() {
         return accessKey;
     }
 
+    /**
+     * LightSailSDConfig configurations allow retrieving scrape targets from AWS Lightsail instances. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#lightsail_sd_config
+     */
     @JsonProperty("accessKey")
     public void setAccessKey(SecretKeySelector accessKey) {
         this.accessKey = accessKey;
     }
 
+    /**
+     * LightSailSDConfig configurations allow retrieving scrape targets from AWS Lightsail instances. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#lightsail_sd_config
+     */
     @JsonProperty("authorization")
     public SafeAuthorization getAuthorization() {
         return authorization;
     }
 
+    /**
+     * LightSailSDConfig configurations allow retrieving scrape targets from AWS Lightsail instances. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#lightsail_sd_config
+     */
     @JsonProperty("authorization")
     public void setAuthorization(SafeAuthorization authorization) {
         this.authorization = authorization;
     }
 
+    /**
+     * LightSailSDConfig configurations allow retrieving scrape targets from AWS Lightsail instances. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#lightsail_sd_config
+     */
     @JsonProperty("basicAuth")
     public BasicAuth getBasicAuth() {
         return basicAuth;
     }
 
+    /**
+     * LightSailSDConfig configurations allow retrieving scrape targets from AWS Lightsail instances. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#lightsail_sd_config
+     */
     @JsonProperty("basicAuth")
     public void setBasicAuth(BasicAuth basicAuth) {
         this.basicAuth = basicAuth;
     }
 
+    /**
+     * Configure whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public Boolean getEnableHTTP2() {
         return enableHTTP2;
     }
 
+    /**
+     * Configure whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public void setEnableHTTP2(Boolean enableHTTP2) {
         this.enableHTTP2 = enableHTTP2;
     }
 
+    /**
+     * Custom endpoint to be used.
+     */
     @JsonProperty("endpoint")
     public String getEndpoint() {
         return endpoint;
     }
 
+    /**
+     * Custom endpoint to be used.
+     */
     @JsonProperty("endpoint")
     public void setEndpoint(String endpoint) {
         this.endpoint = endpoint;
     }
 
+    /**
+     * Configure whether the HTTP requests should follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public Boolean getFollowRedirects() {
         return followRedirects;
     }
 
+    /**
+     * Configure whether the HTTP requests should follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public void setFollowRedirects(Boolean followRedirects) {
         this.followRedirects = followRedirects;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * LightSailSDConfig configurations allow retrieving scrape targets from AWS Lightsail instances. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#lightsail_sd_config
+     */
     @JsonProperty("oauth2")
     public OAuth2 getOauth2() {
         return oauth2;
     }
 
+    /**
+     * LightSailSDConfig configurations allow retrieving scrape targets from AWS Lightsail instances. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#lightsail_sd_config
+     */
     @JsonProperty("oauth2")
     public void setOauth2(OAuth2 oauth2) {
         this.oauth2 = oauth2;
     }
 
+    /**
+     * Port to scrape the metrics from. If using the public IP address, this must instead be specified in the relabeling rule.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * Port to scrape the metrics from. If using the public IP address, this must instead be specified in the relabeling rule.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<SecretKeySelector>> getProxyConnectHeader() {
         return proxyConnectHeader;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     public void setProxyConnectHeader(Map<String, List<SecretKeySelector>> proxyConnectHeader) {
         this.proxyConnectHeader = proxyConnectHeader;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public Boolean getProxyFromEnvironment() {
         return proxyFromEnvironment;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public void setProxyFromEnvironment(Boolean proxyFromEnvironment) {
         this.proxyFromEnvironment = proxyFromEnvironment;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public String getProxyUrl() {
         return proxyUrl;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public void setProxyUrl(String proxyUrl) {
         this.proxyUrl = proxyUrl;
     }
 
+    /**
+     * Refresh interval to re-read the list of instances.
+     */
     @JsonProperty("refreshInterval")
     public String getRefreshInterval() {
         return refreshInterval;
     }
 
+    /**
+     * Refresh interval to re-read the list of instances.
+     */
     @JsonProperty("refreshInterval")
     public void setRefreshInterval(String refreshInterval) {
         this.refreshInterval = refreshInterval;
     }
 
+    /**
+     * The AWS region.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * The AWS region.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * AWS Role ARN, an alternative to using AWS API keys.
+     */
     @JsonProperty("roleARN")
     public String getRoleARN() {
         return roleARN;
     }
 
+    /**
+     * AWS Role ARN, an alternative to using AWS API keys.
+     */
     @JsonProperty("roleARN")
     public void setRoleARN(String roleARN) {
         this.roleARN = roleARN;
     }
 
+    /**
+     * LightSailSDConfig configurations allow retrieving scrape targets from AWS Lightsail instances. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#lightsail_sd_config
+     */
     @JsonProperty("secretKey")
     public SecretKeySelector getSecretKey() {
         return secretKey;
     }
 
+    /**
+     * LightSailSDConfig configurations allow retrieving scrape targets from AWS Lightsail instances. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#lightsail_sd_config
+     */
     @JsonProperty("secretKey")
     public void setSecretKey(SecretKeySelector secretKey) {
         this.secretKey = secretKey;
     }
 
+    /**
+     * LightSailSDConfig configurations allow retrieving scrape targets from AWS Lightsail instances. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#lightsail_sd_config
+     */
     @JsonProperty("tlsConfig")
     public SafeTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * LightSailSDConfig configurations allow retrieving scrape targets from AWS Lightsail instances. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#lightsail_sd_config
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(SafeTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/LinodeSDConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/LinodeSDConfig.java
index 26d31360a77..4cb15a2cc59 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/LinodeSDConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/LinodeSDConfig.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LinodeSDConfig configurations allow retrieving scrape targets from Linode's Linode APIv4. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#linode_sd_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -132,132 +135,210 @@ public LinodeSDConfig(SafeAuthorization authorization, Boolean enableHTTP2, Bool
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * LinodeSDConfig configurations allow retrieving scrape targets from Linode's Linode APIv4. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#linode_sd_config
+     */
     @JsonProperty("authorization")
     public SafeAuthorization getAuthorization() {
         return authorization;
     }
 
+    /**
+     * LinodeSDConfig configurations allow retrieving scrape targets from Linode's Linode APIv4. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#linode_sd_config
+     */
     @JsonProperty("authorization")
     public void setAuthorization(SafeAuthorization authorization) {
         this.authorization = authorization;
     }
 
+    /**
+     * Whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public Boolean getEnableHTTP2() {
         return enableHTTP2;
     }
 
+    /**
+     * Whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public void setEnableHTTP2(Boolean enableHTTP2) {
         this.enableHTTP2 = enableHTTP2;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public Boolean getFollowRedirects() {
         return followRedirects;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public void setFollowRedirects(Boolean followRedirects) {
         this.followRedirects = followRedirects;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * LinodeSDConfig configurations allow retrieving scrape targets from Linode's Linode APIv4. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#linode_sd_config
+     */
     @JsonProperty("oauth2")
     public OAuth2 getOauth2() {
         return oauth2;
     }
 
+    /**
+     * LinodeSDConfig configurations allow retrieving scrape targets from Linode's Linode APIv4. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#linode_sd_config
+     */
     @JsonProperty("oauth2")
     public void setOauth2(OAuth2 oauth2) {
         this.oauth2 = oauth2;
     }
 
+    /**
+     * Default port to scrape metrics from.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * Default port to scrape metrics from.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<SecretKeySelector>> getProxyConnectHeader() {
         return proxyConnectHeader;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     public void setProxyConnectHeader(Map<String, List<SecretKeySelector>> proxyConnectHeader) {
         this.proxyConnectHeader = proxyConnectHeader;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public Boolean getProxyFromEnvironment() {
         return proxyFromEnvironment;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public void setProxyFromEnvironment(Boolean proxyFromEnvironment) {
         this.proxyFromEnvironment = proxyFromEnvironment;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public String getProxyUrl() {
         return proxyUrl;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public void setProxyUrl(String proxyUrl) {
         this.proxyUrl = proxyUrl;
     }
 
+    /**
+     * Time after which the linode instances are refreshed.
+     */
     @JsonProperty("refreshInterval")
     public String getRefreshInterval() {
         return refreshInterval;
     }
 
+    /**
+     * Time after which the linode instances are refreshed.
+     */
     @JsonProperty("refreshInterval")
     public void setRefreshInterval(String refreshInterval) {
         this.refreshInterval = refreshInterval;
     }
 
+    /**
+     * Optional region to filter on.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Optional region to filter on.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * The string by which Linode Instance tags are joined into the tag label.
+     */
     @JsonProperty("tagSeparator")
     public String getTagSeparator() {
         return tagSeparator;
     }
 
+    /**
+     * The string by which Linode Instance tags are joined into the tag label.
+     */
     @JsonProperty("tagSeparator")
     public void setTagSeparator(String tagSeparator) {
         this.tagSeparator = tagSeparator;
     }
 
+    /**
+     * LinodeSDConfig configurations allow retrieving scrape targets from Linode's Linode APIv4. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#linode_sd_config
+     */
     @JsonProperty("tlsConfig")
     public SafeTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * LinodeSDConfig configurations allow retrieving scrape targets from Linode's Linode APIv4. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#linode_sd_config
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(SafeTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/MSTeamsConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/MSTeamsConfig.java
index b3a9d703e3c..0e595d356d4 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/MSTeamsConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/MSTeamsConfig.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MSTeamsConfig configures notifications via Microsoft Teams. It requires Alertmanager &gt;= 0.26.0.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -99,61 +102,97 @@ public MSTeamsConfig(HTTPConfig httpConfig, Boolean sendResolved, String summary
         this.webhookUrl = webhookUrl;
     }
 
+    /**
+     * MSTeamsConfig configures notifications via Microsoft Teams. It requires Alertmanager &gt;= 0.26.0.
+     */
     @JsonProperty("httpConfig")
     public HTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * MSTeamsConfig configures notifications via Microsoft Teams. It requires Alertmanager &gt;= 0.26.0.
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(HTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * Whether to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public Boolean getSendResolved() {
         return sendResolved;
     }
 
+    /**
+     * Whether to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public void setSendResolved(Boolean sendResolved) {
         this.sendResolved = sendResolved;
     }
 
+    /**
+     * Message summary template. It requires Alertmanager &gt;= 0.27.0.
+     */
     @JsonProperty("summary")
     public String getSummary() {
         return summary;
     }
 
+    /**
+     * Message summary template. It requires Alertmanager &gt;= 0.27.0.
+     */
     @JsonProperty("summary")
     public void setSummary(String summary) {
         this.summary = summary;
     }
 
+    /**
+     * Message body template.
+     */
     @JsonProperty("text")
     public String getText() {
         return text;
     }
 
+    /**
+     * Message body template.
+     */
     @JsonProperty("text")
     public void setText(String text) {
         this.text = text;
     }
 
+    /**
+     * Message title template.
+     */
     @JsonProperty("title")
     public String getTitle() {
         return title;
     }
 
+    /**
+     * Message title template.
+     */
     @JsonProperty("title")
     public void setTitle(String title) {
         this.title = title;
     }
 
+    /**
+     * MSTeamsConfig configures notifications via Microsoft Teams. It requires Alertmanager &gt;= 0.26.0.
+     */
     @JsonProperty("webhookUrl")
     public SecretKeySelector getWebhookUrl() {
         return webhookUrl;
     }
 
+    /**
+     * MSTeamsConfig configures notifications via Microsoft Teams. It requires Alertmanager &gt;= 0.26.0.
+     */
     @JsonProperty("webhookUrl")
     public void setWebhookUrl(SecretKeySelector webhookUrl) {
         this.webhookUrl = webhookUrl;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/Matcher.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/Matcher.java
index 0e7da7194e0..58640c143c5 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/Matcher.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/Matcher.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Matcher defines how to match on alert's labels.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public Matcher(String matchType, String name, Boolean regex, String value) {
         this.value = value;
     }
 
+    /**
+     * Match operation available with AlertManager &gt;= v0.22.0 and takes precedence over Regex (deprecated) if non-empty.
+     */
     @JsonProperty("matchType")
     public String getMatchType() {
         return matchType;
     }
 
+    /**
+     * Match operation available with AlertManager &gt;= v0.22.0 and takes precedence over Regex (deprecated) if non-empty.
+     */
     @JsonProperty("matchType")
     public void setMatchType(String matchType) {
         this.matchType = matchType;
     }
 
+    /**
+     * Label to match.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Label to match.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Whether to match on equality (false) or regular-expression (true). Deprecated: for AlertManager &gt;= v0.22.0, `matchType` should be used instead.
+     */
     @JsonProperty("regex")
     public Boolean getRegex() {
         return regex;
     }
 
+    /**
+     * Whether to match on equality (false) or regular-expression (true). Deprecated: for AlertManager &gt;= v0.22.0, `matchType` should be used instead.
+     */
     @JsonProperty("regex")
     public void setRegex(Boolean regex) {
         this.regex = regex;
     }
 
+    /**
+     * Label value to match.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Label value to match.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/MuteTimeInterval.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/MuteTimeInterval.java
index f8686c48aa4..d8670f5cd23 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/MuteTimeInterval.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/MuteTimeInterval.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MuteTimeInterval specifies the periods in time when notifications will be muted
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public MuteTimeInterval(String name, List<TimeInterval> timeIntervals) {
         this.timeIntervals = timeIntervals;
     }
 
+    /**
+     * Name of the time interval
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the time interval
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * TimeIntervals is a list of TimeInterval
+     */
     @JsonProperty("timeIntervals")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TimeInterval> getTimeIntervals() {
         return timeIntervals;
     }
 
+    /**
+     * TimeIntervals is a list of TimeInterval
+     */
     @JsonProperty("timeIntervals")
     public void setTimeIntervals(List<TimeInterval> timeIntervals) {
         this.timeIntervals = timeIntervals;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/NamespaceDiscovery.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/NamespaceDiscovery.java
index 0e55e271ac5..eb866533e61 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/NamespaceDiscovery.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/NamespaceDiscovery.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NamespaceDiscovery is the configuration for discovering Kubernetes namespaces.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public NamespaceDiscovery(List<String> names, Boolean ownNamespace) {
         this.ownNamespace = ownNamespace;
     }
 
+    /**
+     * List of namespaces where to watch for resources. If empty and `ownNamespace` isn't true, Prometheus watches for resources in all namespaces.
+     */
     @JsonProperty("names")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNames() {
         return names;
     }
 
+    /**
+     * List of namespaces where to watch for resources. If empty and `ownNamespace` isn't true, Prometheus watches for resources in all namespaces.
+     */
     @JsonProperty("names")
     public void setNames(List<String> names) {
         this.names = names;
     }
 
+    /**
+     * Includes the namespace in which the Prometheus pod runs to the list of watched namespaces.
+     */
     @JsonProperty("ownNamespace")
     public Boolean getOwnNamespace() {
         return ownNamespace;
     }
 
+    /**
+     * Includes the namespace in which the Prometheus pod runs to the list of watched namespaces.
+     */
     @JsonProperty("ownNamespace")
     public void setOwnNamespace(Boolean ownNamespace) {
         this.ownNamespace = ownNamespace;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/NomadSDConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/NomadSDConfig.java
index 0c4a5095ef9..1efd093bebc 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/NomadSDConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/NomadSDConfig.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NomadSDConfig configurations allow retrieving scrape targets from Nomad's Service API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#nomad_sd_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -145,162 +148,258 @@ public NomadSDConfig(Boolean allowStale, SafeAuthorization authorization, BasicA
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * The information to access the Nomad API. It is to be defined as the Nomad documentation requires.
+     */
     @JsonProperty("allowStale")
     public Boolean getAllowStale() {
         return allowStale;
     }
 
+    /**
+     * The information to access the Nomad API. It is to be defined as the Nomad documentation requires.
+     */
     @JsonProperty("allowStale")
     public void setAllowStale(Boolean allowStale) {
         this.allowStale = allowStale;
     }
 
+    /**
+     * NomadSDConfig configurations allow retrieving scrape targets from Nomad's Service API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#nomad_sd_config
+     */
     @JsonProperty("authorization")
     public SafeAuthorization getAuthorization() {
         return authorization;
     }
 
+    /**
+     * NomadSDConfig configurations allow retrieving scrape targets from Nomad's Service API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#nomad_sd_config
+     */
     @JsonProperty("authorization")
     public void setAuthorization(SafeAuthorization authorization) {
         this.authorization = authorization;
     }
 
+    /**
+     * NomadSDConfig configurations allow retrieving scrape targets from Nomad's Service API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#nomad_sd_config
+     */
     @JsonProperty("basicAuth")
     public BasicAuth getBasicAuth() {
         return basicAuth;
     }
 
+    /**
+     * NomadSDConfig configurations allow retrieving scrape targets from Nomad's Service API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#nomad_sd_config
+     */
     @JsonProperty("basicAuth")
     public void setBasicAuth(BasicAuth basicAuth) {
         this.basicAuth = basicAuth;
     }
 
+    /**
+     * Whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public Boolean getEnableHTTP2() {
         return enableHTTP2;
     }
 
+    /**
+     * Whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public void setEnableHTTP2(Boolean enableHTTP2) {
         this.enableHTTP2 = enableHTTP2;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public Boolean getFollowRedirects() {
         return followRedirects;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public void setFollowRedirects(Boolean followRedirects) {
         this.followRedirects = followRedirects;
     }
 
+    /**
+     * NomadSDConfig configurations allow retrieving scrape targets from Nomad's Service API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#nomad_sd_config
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * NomadSDConfig configurations allow retrieving scrape targets from Nomad's Service API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#nomad_sd_config
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * NomadSDConfig configurations allow retrieving scrape targets from Nomad's Service API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#nomad_sd_config
+     */
     @JsonProperty("oauth2")
     public OAuth2 getOauth2() {
         return oauth2;
     }
 
+    /**
+     * NomadSDConfig configurations allow retrieving scrape targets from Nomad's Service API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#nomad_sd_config
+     */
     @JsonProperty("oauth2")
     public void setOauth2(OAuth2 oauth2) {
         this.oauth2 = oauth2;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<SecretKeySelector>> getProxyConnectHeader() {
         return proxyConnectHeader;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     public void setProxyConnectHeader(Map<String, List<SecretKeySelector>> proxyConnectHeader) {
         this.proxyConnectHeader = proxyConnectHeader;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public Boolean getProxyFromEnvironment() {
         return proxyFromEnvironment;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public void setProxyFromEnvironment(Boolean proxyFromEnvironment) {
         this.proxyFromEnvironment = proxyFromEnvironment;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public String getProxyUrl() {
         return proxyUrl;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public void setProxyUrl(String proxyUrl) {
         this.proxyUrl = proxyUrl;
     }
 
+    /**
+     * NomadSDConfig configurations allow retrieving scrape targets from Nomad's Service API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#nomad_sd_config
+     */
     @JsonProperty("refreshInterval")
     public String getRefreshInterval() {
         return refreshInterval;
     }
 
+    /**
+     * NomadSDConfig configurations allow retrieving scrape targets from Nomad's Service API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#nomad_sd_config
+     */
     @JsonProperty("refreshInterval")
     public void setRefreshInterval(String refreshInterval) {
         this.refreshInterval = refreshInterval;
     }
 
+    /**
+     * NomadSDConfig configurations allow retrieving scrape targets from Nomad's Service API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#nomad_sd_config
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * NomadSDConfig configurations allow retrieving scrape targets from Nomad's Service API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#nomad_sd_config
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * NomadSDConfig configurations allow retrieving scrape targets from Nomad's Service API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#nomad_sd_config
+     */
     @JsonProperty("server")
     public String getServer() {
         return server;
     }
 
+    /**
+     * NomadSDConfig configurations allow retrieving scrape targets from Nomad's Service API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#nomad_sd_config
+     */
     @JsonProperty("server")
     public void setServer(String server) {
         this.server = server;
     }
 
+    /**
+     * NomadSDConfig configurations allow retrieving scrape targets from Nomad's Service API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#nomad_sd_config
+     */
     @JsonProperty("tagSeparator")
     public String getTagSeparator() {
         return tagSeparator;
     }
 
+    /**
+     * NomadSDConfig configurations allow retrieving scrape targets from Nomad's Service API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#nomad_sd_config
+     */
     @JsonProperty("tagSeparator")
     public void setTagSeparator(String tagSeparator) {
         this.tagSeparator = tagSeparator;
     }
 
+    /**
+     * NomadSDConfig configurations allow retrieving scrape targets from Nomad's Service API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#nomad_sd_config
+     */
     @JsonProperty("tlsConfig")
     public SafeTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * NomadSDConfig configurations allow retrieving scrape targets from Nomad's Service API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#nomad_sd_config
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(SafeTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/OVHCloudSDConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/OVHCloudSDConfig.java
index 05b14bd261f..4118cfc3c16 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/OVHCloudSDConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/OVHCloudSDConfig.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OVHCloudSDConfig configurations allow retrieving scrape targets from OVHcloud's dedicated servers and VPS using their API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#ovhcloud_sd_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -99,61 +102,97 @@ public OVHCloudSDConfig(String applicationKey, SecretKeySelector applicationSecr
         this.service = service;
     }
 
+    /**
+     * Access key to use. https://api.ovh.com.
+     */
     @JsonProperty("applicationKey")
     public String getApplicationKey() {
         return applicationKey;
     }
 
+    /**
+     * Access key to use. https://api.ovh.com.
+     */
     @JsonProperty("applicationKey")
     public void setApplicationKey(String applicationKey) {
         this.applicationKey = applicationKey;
     }
 
+    /**
+     * OVHCloudSDConfig configurations allow retrieving scrape targets from OVHcloud's dedicated servers and VPS using their API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#ovhcloud_sd_config
+     */
     @JsonProperty("applicationSecret")
     public SecretKeySelector getApplicationSecret() {
         return applicationSecret;
     }
 
+    /**
+     * OVHCloudSDConfig configurations allow retrieving scrape targets from OVHcloud's dedicated servers and VPS using their API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#ovhcloud_sd_config
+     */
     @JsonProperty("applicationSecret")
     public void setApplicationSecret(SecretKeySelector applicationSecret) {
         this.applicationSecret = applicationSecret;
     }
 
+    /**
+     * OVHCloudSDConfig configurations allow retrieving scrape targets from OVHcloud's dedicated servers and VPS using their API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#ovhcloud_sd_config
+     */
     @JsonProperty("consumerKey")
     public SecretKeySelector getConsumerKey() {
         return consumerKey;
     }
 
+    /**
+     * OVHCloudSDConfig configurations allow retrieving scrape targets from OVHcloud's dedicated servers and VPS using their API. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#ovhcloud_sd_config
+     */
     @JsonProperty("consumerKey")
     public void setConsumerKey(SecretKeySelector consumerKey) {
         this.consumerKey = consumerKey;
     }
 
+    /**
+     * Custom endpoint to be used.
+     */
     @JsonProperty("endpoint")
     public String getEndpoint() {
         return endpoint;
     }
 
+    /**
+     * Custom endpoint to be used.
+     */
     @JsonProperty("endpoint")
     public void setEndpoint(String endpoint) {
         this.endpoint = endpoint;
     }
 
+    /**
+     * Refresh interval to re-read the resources list.
+     */
     @JsonProperty("refreshInterval")
     public String getRefreshInterval() {
         return refreshInterval;
     }
 
+    /**
+     * Refresh interval to re-read the resources list.
+     */
     @JsonProperty("refreshInterval")
     public void setRefreshInterval(String refreshInterval) {
         this.refreshInterval = refreshInterval;
     }
 
+    /**
+     * Service of the targets to retrieve. Must be `VPS` or `DedicatedServer`.
+     */
     @JsonProperty("service")
     public String getService() {
         return service;
     }
 
+    /**
+     * Service of the targets to retrieve. Must be `VPS` or `DedicatedServer`.
+     */
     @JsonProperty("service")
     public void setService(String service) {
         this.service = service;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/OpenStackSDConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/OpenStackSDConfig.java
index d2ae2715b97..e37faffb358 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/OpenStackSDConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/OpenStackSDConfig.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OpenStackSDConfig allow retrieving scrape targets from OpenStack Nova instances. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#openstack_sd_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -148,181 +151,289 @@ public OpenStackSDConfig(Boolean allTenants, String applicationCredentialId, Str
         this.username = username;
     }
 
+    /**
+     * Whether the service discovery should list all instances for all projects. It is only relevant for the 'instance' role and usually requires admin permissions.
+     */
     @JsonProperty("allTenants")
     public Boolean getAllTenants() {
         return allTenants;
     }
 
+    /**
+     * Whether the service discovery should list all instances for all projects. It is only relevant for the 'instance' role and usually requires admin permissions.
+     */
     @JsonProperty("allTenants")
     public void setAllTenants(Boolean allTenants) {
         this.allTenants = allTenants;
     }
 
+    /**
+     * ApplicationCredentialID
+     */
     @JsonProperty("applicationCredentialId")
     public String getApplicationCredentialId() {
         return applicationCredentialId;
     }
 
+    /**
+     * ApplicationCredentialID
+     */
     @JsonProperty("applicationCredentialId")
     public void setApplicationCredentialId(String applicationCredentialId) {
         this.applicationCredentialId = applicationCredentialId;
     }
 
+    /**
+     * The ApplicationCredentialID or ApplicationCredentialName fields are required if using an application credential to authenticate. Some providers allow you to create an application credential to authenticate rather than a password.
+     */
     @JsonProperty("applicationCredentialName")
     public String getApplicationCredentialName() {
         return applicationCredentialName;
     }
 
+    /**
+     * The ApplicationCredentialID or ApplicationCredentialName fields are required if using an application credential to authenticate. Some providers allow you to create an application credential to authenticate rather than a password.
+     */
     @JsonProperty("applicationCredentialName")
     public void setApplicationCredentialName(String applicationCredentialName) {
         this.applicationCredentialName = applicationCredentialName;
     }
 
+    /**
+     * OpenStackSDConfig allow retrieving scrape targets from OpenStack Nova instances. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#openstack_sd_config
+     */
     @JsonProperty("applicationCredentialSecret")
     public SecretKeySelector getApplicationCredentialSecret() {
         return applicationCredentialSecret;
     }
 
+    /**
+     * OpenStackSDConfig allow retrieving scrape targets from OpenStack Nova instances. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#openstack_sd_config
+     */
     @JsonProperty("applicationCredentialSecret")
     public void setApplicationCredentialSecret(SecretKeySelector applicationCredentialSecret) {
         this.applicationCredentialSecret = applicationCredentialSecret;
     }
 
+    /**
+     * Availability of the endpoint to connect to.
+     */
     @JsonProperty("availability")
     public String getAvailability() {
         return availability;
     }
 
+    /**
+     * Availability of the endpoint to connect to.
+     */
     @JsonProperty("availability")
     public void setAvailability(String availability) {
         this.availability = availability;
     }
 
+    /**
+     * DomainID
+     */
     @JsonProperty("domainID")
     public String getDomainID() {
         return domainID;
     }
 
+    /**
+     * DomainID
+     */
     @JsonProperty("domainID")
     public void setDomainID(String domainID) {
         this.domainID = domainID;
     }
 
+    /**
+     * At most one of domainId and domainName must be provided if using username with Identity V3. Otherwise, either are optional.
+     */
     @JsonProperty("domainName")
     public String getDomainName() {
         return domainName;
     }
 
+    /**
+     * At most one of domainId and domainName must be provided if using username with Identity V3. Otherwise, either are optional.
+     */
     @JsonProperty("domainName")
     public void setDomainName(String domainName) {
         this.domainName = domainName;
     }
 
+    /**
+     * IdentityEndpoint specifies the HTTP endpoint that is required to work with the Identity API of the appropriate version.
+     */
     @JsonProperty("identityEndpoint")
     public String getIdentityEndpoint() {
         return identityEndpoint;
     }
 
+    /**
+     * IdentityEndpoint specifies the HTTP endpoint that is required to work with the Identity API of the appropriate version.
+     */
     @JsonProperty("identityEndpoint")
     public void setIdentityEndpoint(String identityEndpoint) {
         this.identityEndpoint = identityEndpoint;
     }
 
+    /**
+     * OpenStackSDConfig allow retrieving scrape targets from OpenStack Nova instances. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#openstack_sd_config
+     */
     @JsonProperty("password")
     public SecretKeySelector getPassword() {
         return password;
     }
 
+    /**
+     * OpenStackSDConfig allow retrieving scrape targets from OpenStack Nova instances. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#openstack_sd_config
+     */
     @JsonProperty("password")
     public void setPassword(SecretKeySelector password) {
         this.password = password;
     }
 
+    /**
+     * The port to scrape metrics from. If using the public IP address, this must instead be specified in the relabeling rule.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * The port to scrape metrics from. If using the public IP address, this must instead be specified in the relabeling rule.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * ProjectID
+     */
     @JsonProperty("projectID")
     public String getProjectID() {
         return projectID;
     }
 
+    /**
+     * ProjectID
+     */
     @JsonProperty("projectID")
     public void setProjectID(String projectID) {
         this.projectID = projectID;
     }
 
+    /**
+     * The ProjectId and ProjectName fields are optional for the Identity V2 API. Some providers allow you to specify a ProjectName instead of the ProjectId. Some require both. Your provider's authentication policies will determine how these fields influence authentication.
+     */
     @JsonProperty("projectName")
     public String getProjectName() {
         return projectName;
     }
 
+    /**
+     * The ProjectId and ProjectName fields are optional for the Identity V2 API. Some providers allow you to specify a ProjectName instead of the ProjectId. Some require both. Your provider's authentication policies will determine how these fields influence authentication.
+     */
     @JsonProperty("projectName")
     public void setProjectName(String projectName) {
         this.projectName = projectName;
     }
 
+    /**
+     * Refresh interval to re-read the instance list.
+     */
     @JsonProperty("refreshInterval")
     public String getRefreshInterval() {
         return refreshInterval;
     }
 
+    /**
+     * Refresh interval to re-read the instance list.
+     */
     @JsonProperty("refreshInterval")
     public void setRefreshInterval(String refreshInterval) {
         this.refreshInterval = refreshInterval;
     }
 
+    /**
+     * The OpenStack Region.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * The OpenStack Region.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * The OpenStack role of entities that should be discovered.
+     */
     @JsonProperty("role")
     public String getRole() {
         return role;
     }
 
+    /**
+     * The OpenStack role of entities that should be discovered.
+     */
     @JsonProperty("role")
     public void setRole(String role) {
         this.role = role;
     }
 
+    /**
+     * OpenStackSDConfig allow retrieving scrape targets from OpenStack Nova instances. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#openstack_sd_config
+     */
     @JsonProperty("tlsConfig")
     public SafeTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * OpenStackSDConfig allow retrieving scrape targets from OpenStack Nova instances. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#openstack_sd_config
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(SafeTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * UserID
+     */
     @JsonProperty("userid")
     public String getUserid() {
         return userid;
     }
 
+    /**
+     * UserID
+     */
     @JsonProperty("userid")
     public void setUserid(String userid) {
         this.userid = userid;
     }
 
+    /**
+     * Username is required if using Identity V2 API. Consult with your provider's control panel to discover your account's username. In Identity V3, either userid or a combination of username and domainId or domainName are needed
+     */
     @JsonProperty("username")
     public String getUsername() {
         return username;
     }
 
+    /**
+     * Username is required if using Identity V2 API. Consult with your provider's control panel to discover your account's username. In Identity V3, either userid or a combination of username and domainId or domainName are needed
+     */
     @JsonProperty("username")
     public void setUsername(String username) {
         this.username = username;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/OpsGenieConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/OpsGenieConfig.java
index 1c0391fe249..1524ecb5648 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/OpsGenieConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/OpsGenieConfig.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OpsGenieConfig configures notifications via OpsGenie. See https://prometheus.io/docs/alerting/latest/configuration/#opsgenie_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -139,153 +142,243 @@ public OpsGenieConfig(String actions, SecretKeySelector apiKey, String apiURL, S
         this.updateAlerts = updateAlerts;
     }
 
+    /**
+     * Comma separated list of actions that will be available for the alert.
+     */
     @JsonProperty("actions")
     public String getActions() {
         return actions;
     }
 
+    /**
+     * Comma separated list of actions that will be available for the alert.
+     */
     @JsonProperty("actions")
     public void setActions(String actions) {
         this.actions = actions;
     }
 
+    /**
+     * OpsGenieConfig configures notifications via OpsGenie. See https://prometheus.io/docs/alerting/latest/configuration/#opsgenie_config
+     */
     @JsonProperty("apiKey")
     public SecretKeySelector getApiKey() {
         return apiKey;
     }
 
+    /**
+     * OpsGenieConfig configures notifications via OpsGenie. See https://prometheus.io/docs/alerting/latest/configuration/#opsgenie_config
+     */
     @JsonProperty("apiKey")
     public void setApiKey(SecretKeySelector apiKey) {
         this.apiKey = apiKey;
     }
 
+    /**
+     * The URL to send OpsGenie API requests to.
+     */
     @JsonProperty("apiURL")
     public String getApiURL() {
         return apiURL;
     }
 
+    /**
+     * The URL to send OpsGenie API requests to.
+     */
     @JsonProperty("apiURL")
     public void setApiURL(String apiURL) {
         this.apiURL = apiURL;
     }
 
+    /**
+     * Description of the incident.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description of the incident.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * A set of arbitrary key/value pairs that provide further detail about the incident.
+     */
     @JsonProperty("details")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<KeyValue> getDetails() {
         return details;
     }
 
+    /**
+     * A set of arbitrary key/value pairs that provide further detail about the incident.
+     */
     @JsonProperty("details")
     public void setDetails(List<KeyValue> details) {
         this.details = details;
     }
 
+    /**
+     * Optional field that can be used to specify which domain alert is related to.
+     */
     @JsonProperty("entity")
     public String getEntity() {
         return entity;
     }
 
+    /**
+     * Optional field that can be used to specify which domain alert is related to.
+     */
     @JsonProperty("entity")
     public void setEntity(String entity) {
         this.entity = entity;
     }
 
+    /**
+     * OpsGenieConfig configures notifications via OpsGenie. See https://prometheus.io/docs/alerting/latest/configuration/#opsgenie_config
+     */
     @JsonProperty("httpConfig")
     public HTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * OpsGenieConfig configures notifications via OpsGenie. See https://prometheus.io/docs/alerting/latest/configuration/#opsgenie_config
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(HTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * Alert text limited to 130 characters.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Alert text limited to 130 characters.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Additional alert note.
+     */
     @JsonProperty("note")
     public String getNote() {
         return note;
     }
 
+    /**
+     * Additional alert note.
+     */
     @JsonProperty("note")
     public void setNote(String note) {
         this.note = note;
     }
 
+    /**
+     * Priority level of alert. Possible values are P1, P2, P3, P4, and P5.
+     */
     @JsonProperty("priority")
     public String getPriority() {
         return priority;
     }
 
+    /**
+     * Priority level of alert. Possible values are P1, P2, P3, P4, and P5.
+     */
     @JsonProperty("priority")
     public void setPriority(String priority) {
         this.priority = priority;
     }
 
+    /**
+     * List of responders responsible for notifications.
+     */
     @JsonProperty("responders")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OpsGenieConfigResponder> getResponders() {
         return responders;
     }
 
+    /**
+     * List of responders responsible for notifications.
+     */
     @JsonProperty("responders")
     public void setResponders(List<OpsGenieConfigResponder> responders) {
         this.responders = responders;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public Boolean getSendResolved() {
         return sendResolved;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public void setSendResolved(Boolean sendResolved) {
         this.sendResolved = sendResolved;
     }
 
+    /**
+     * Backlink to the sender of the notification.
+     */
     @JsonProperty("source")
     public String getSource() {
         return source;
     }
 
+    /**
+     * Backlink to the sender of the notification.
+     */
     @JsonProperty("source")
     public void setSource(String source) {
         this.source = source;
     }
 
+    /**
+     * Comma separated list of tags attached to the notifications.
+     */
     @JsonProperty("tags")
     public String getTags() {
         return tags;
     }
 
+    /**
+     * Comma separated list of tags attached to the notifications.
+     */
     @JsonProperty("tags")
     public void setTags(String tags) {
         this.tags = tags;
     }
 
+    /**
+     * Whether to update message and description of the alert in OpsGenie if it already exists By default, the alert is never updated in OpsGenie, the new message only appears in activity log.
+     */
     @JsonProperty("updateAlerts")
     public Boolean getUpdateAlerts() {
         return updateAlerts;
     }
 
+    /**
+     * Whether to update message and description of the alert in OpsGenie if it already exists By default, the alert is never updated in OpsGenie, the new message only appears in activity log.
+     */
     @JsonProperty("updateAlerts")
     public void setUpdateAlerts(Boolean updateAlerts) {
         this.updateAlerts = updateAlerts;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/OpsGenieConfigResponder.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/OpsGenieConfigResponder.java
index f9d4e4a0d97..0a3029f7e40 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/OpsGenieConfigResponder.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/OpsGenieConfigResponder.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OpsGenieConfigResponder defines a responder to an incident. One of `id`, `name` or `username` has to be defined.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public OpsGenieConfigResponder(String id, String name, String type, String usern
         this.username = username;
     }
 
+    /**
+     * ID of the responder.
+     */
     @JsonProperty("id")
     public String getId() {
         return id;
     }
 
+    /**
+     * ID of the responder.
+     */
     @JsonProperty("id")
     public void setId(String id) {
         this.id = id;
     }
 
+    /**
+     * Name of the responder.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the responder.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Type of responder.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of responder.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * Username of the responder.
+     */
     @JsonProperty("username")
     public String getUsername() {
         return username;
     }
 
+    /**
+     * Username of the responder.
+     */
     @JsonProperty("username")
     public void setUsername(String username) {
         this.username = username;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PagerDutyConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PagerDutyConfig.java
index de4a1ae5786..af04f4a1f19 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PagerDutyConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PagerDutyConfig.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PagerDutyConfig configures notifications via PagerDuty. See https://prometheus.io/docs/alerting/latest/configuration/#pagerduty_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -144,164 +147,260 @@ public PagerDutyConfig(String className, String client, String clientURL, String
         this.url = url;
     }
 
+    /**
+     * The class/type of the event.
+     */
     @JsonProperty("class")
     public String getClassName() {
         return className;
     }
 
+    /**
+     * The class/type of the event.
+     */
     @JsonProperty("class")
     public void setClassName(String className) {
         this.className = className;
     }
 
+    /**
+     * Client identification.
+     */
     @JsonProperty("client")
     public String getClient() {
         return client;
     }
 
+    /**
+     * Client identification.
+     */
     @JsonProperty("client")
     public void setClient(String client) {
         this.client = client;
     }
 
+    /**
+     * Backlink to the sender of notification.
+     */
     @JsonProperty("clientURL")
     public String getClientURL() {
         return clientURL;
     }
 
+    /**
+     * Backlink to the sender of notification.
+     */
     @JsonProperty("clientURL")
     public void setClientURL(String clientURL) {
         this.clientURL = clientURL;
     }
 
+    /**
+     * The part or component of the affected system that is broken.
+     */
     @JsonProperty("component")
     public String getComponent() {
         return component;
     }
 
+    /**
+     * The part or component of the affected system that is broken.
+     */
     @JsonProperty("component")
     public void setComponent(String component) {
         this.component = component;
     }
 
+    /**
+     * Description of the incident.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description of the incident.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * Arbitrary key/value pairs that provide further detail about the incident.
+     */
     @JsonProperty("details")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<KeyValue> getDetails() {
         return details;
     }
 
+    /**
+     * Arbitrary key/value pairs that provide further detail about the incident.
+     */
     @JsonProperty("details")
     public void setDetails(List<KeyValue> details) {
         this.details = details;
     }
 
+    /**
+     * A cluster or grouping of sources.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * A cluster or grouping of sources.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * PagerDutyConfig configures notifications via PagerDuty. See https://prometheus.io/docs/alerting/latest/configuration/#pagerduty_config
+     */
     @JsonProperty("httpConfig")
     public HTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * PagerDutyConfig configures notifications via PagerDuty. See https://prometheus.io/docs/alerting/latest/configuration/#pagerduty_config
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(HTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * A list of image details to attach that provide further detail about an incident.
+     */
     @JsonProperty("pagerDutyImageConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PagerDutyImageConfig> getPagerDutyImageConfigs() {
         return pagerDutyImageConfigs;
     }
 
+    /**
+     * A list of image details to attach that provide further detail about an incident.
+     */
     @JsonProperty("pagerDutyImageConfigs")
     public void setPagerDutyImageConfigs(List<PagerDutyImageConfig> pagerDutyImageConfigs) {
         this.pagerDutyImageConfigs = pagerDutyImageConfigs;
     }
 
+    /**
+     * A list of link details to attach that provide further detail about an incident.
+     */
     @JsonProperty("pagerDutyLinkConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PagerDutyLinkConfig> getPagerDutyLinkConfigs() {
         return pagerDutyLinkConfigs;
     }
 
+    /**
+     * A list of link details to attach that provide further detail about an incident.
+     */
     @JsonProperty("pagerDutyLinkConfigs")
     public void setPagerDutyLinkConfigs(List<PagerDutyLinkConfig> pagerDutyLinkConfigs) {
         this.pagerDutyLinkConfigs = pagerDutyLinkConfigs;
     }
 
+    /**
+     * PagerDutyConfig configures notifications via PagerDuty. See https://prometheus.io/docs/alerting/latest/configuration/#pagerduty_config
+     */
     @JsonProperty("routingKey")
     public SecretKeySelector getRoutingKey() {
         return routingKey;
     }
 
+    /**
+     * PagerDutyConfig configures notifications via PagerDuty. See https://prometheus.io/docs/alerting/latest/configuration/#pagerduty_config
+     */
     @JsonProperty("routingKey")
     public void setRoutingKey(SecretKeySelector routingKey) {
         this.routingKey = routingKey;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public Boolean getSendResolved() {
         return sendResolved;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public void setSendResolved(Boolean sendResolved) {
         this.sendResolved = sendResolved;
     }
 
+    /**
+     * PagerDutyConfig configures notifications via PagerDuty. See https://prometheus.io/docs/alerting/latest/configuration/#pagerduty_config
+     */
     @JsonProperty("serviceKey")
     public SecretKeySelector getServiceKey() {
         return serviceKey;
     }
 
+    /**
+     * PagerDutyConfig configures notifications via PagerDuty. See https://prometheus.io/docs/alerting/latest/configuration/#pagerduty_config
+     */
     @JsonProperty("serviceKey")
     public void setServiceKey(SecretKeySelector serviceKey) {
         this.serviceKey = serviceKey;
     }
 
+    /**
+     * Severity of the incident.
+     */
     @JsonProperty("severity")
     public String getSeverity() {
         return severity;
     }
 
+    /**
+     * Severity of the incident.
+     */
     @JsonProperty("severity")
     public void setSeverity(String severity) {
         this.severity = severity;
     }
 
+    /**
+     * Unique location of the affected system.
+     */
     @JsonProperty("source")
     public String getSource() {
         return source;
     }
 
+    /**
+     * Unique location of the affected system.
+     */
     @JsonProperty("source")
     public void setSource(String source) {
         this.source = source;
     }
 
+    /**
+     * The URL to send requests to.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * The URL to send requests to.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PagerDutyImageConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PagerDutyImageConfig.java
index 3922160b46f..6c9d9132612 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PagerDutyImageConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PagerDutyImageConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PagerDutyImageConfig attaches images to an incident
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public PagerDutyImageConfig(String alt, String href, String src) {
         this.src = src;
     }
 
+    /**
+     * Alt is the optional alternative text for the image.
+     */
     @JsonProperty("alt")
     public String getAlt() {
         return alt;
     }
 
+    /**
+     * Alt is the optional alternative text for the image.
+     */
     @JsonProperty("alt")
     public void setAlt(String alt) {
         this.alt = alt;
     }
 
+    /**
+     * Optional URL; makes the image a clickable link.
+     */
     @JsonProperty("href")
     public String getHref() {
         return href;
     }
 
+    /**
+     * Optional URL; makes the image a clickable link.
+     */
     @JsonProperty("href")
     public void setHref(String href) {
         this.href = href;
     }
 
+    /**
+     * Src of the image being attached to the incident
+     */
     @JsonProperty("src")
     public String getSrc() {
         return src;
     }
 
+    /**
+     * Src of the image being attached to the incident
+     */
     @JsonProperty("src")
     public void setSrc(String src) {
         this.src = src;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PagerDutyLinkConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PagerDutyLinkConfig.java
index ee96ffd0c1f..7aeaa6a2ad2 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PagerDutyLinkConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PagerDutyLinkConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PagerDutyLinkConfig attaches text links to an incident
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PagerDutyLinkConfig(String alt, String href) {
         this.href = href;
     }
 
+    /**
+     * Text that describes the purpose of the link, and can be used as the link's text.
+     */
     @JsonProperty("alt")
     public String getAlt() {
         return alt;
     }
 
+    /**
+     * Text that describes the purpose of the link, and can be used as the link's text.
+     */
     @JsonProperty("alt")
     public void setAlt(String alt) {
         this.alt = alt;
     }
 
+    /**
+     * Href is the URL of the link to be attached
+     */
     @JsonProperty("href")
     public String getHref() {
         return href;
     }
 
+    /**
+     * Href is the URL of the link to be attached
+     */
     @JsonProperty("href")
     public void setHref(String href) {
         this.href = href;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/ParsedRange.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/ParsedRange.java
index 01a4b9aeee3..b85f7073f60 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/ParsedRange.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/ParsedRange.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ParsedRange is an integer representation of a range
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ParsedRange(Integer end, Integer start) {
         this.start = start;
     }
 
+    /**
+     * End of the range
+     */
     @JsonProperty("end")
     public Integer getEnd() {
         return end;
     }
 
+    /**
+     * End of the range
+     */
     @JsonProperty("end")
     public void setEnd(Integer end) {
         this.end = end;
     }
 
+    /**
+     * Start is the beginning of the range
+     */
     @JsonProperty("start")
     public Integer getStart() {
         return start;
     }
 
+    /**
+     * Start is the beginning of the range
+     */
     @JsonProperty("start")
     public void setStart(Integer start) {
         this.start = start;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PrometheusAgent.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PrometheusAgent.java
index cc2adabf281..42d515b75fd 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PrometheusAgent.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PrometheusAgent.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * The `PrometheusAgent` custom resource definition (CRD) defines a desired [Prometheus Agent](https://prometheus.io/blog/2021/11/16/agent/) setup to run in a Kubernetes cluster.<br><p> <br><p> The CRD is very similar to the `Prometheus` CRD except for features which aren't available in agent mode like rule evaluation, persistent storage and Thanos sidecar.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class PrometheusAgent implements Editable<PrometheusAgentBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "monitoring.coreos.com/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PrometheusAgent";
     @JsonProperty("metadata")
@@ -112,7 +109,7 @@ public PrometheusAgent(String apiVersion, String kind, ObjectMeta metadata, Prom
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,38 +133,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * The `PrometheusAgent` custom resource definition (CRD) defines a desired [Prometheus Agent](https://prometheus.io/blog/2021/11/16/agent/) setup to run in a Kubernetes cluster.<br><p> <br><p> The CRD is very similar to the `Prometheus` CRD except for features which aren't available in agent mode like rule evaluation, persistent storage and Thanos sidecar.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * The `PrometheusAgent` custom resource definition (CRD) defines a desired [Prometheus Agent](https://prometheus.io/blog/2021/11/16/agent/) setup to run in a Kubernetes cluster.<br><p> <br><p> The CRD is very similar to the `Prometheus` CRD except for features which aren't available in agent mode like rule evaluation, persistent storage and Thanos sidecar.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * The `PrometheusAgent` custom resource definition (CRD) defines a desired [Prometheus Agent](https://prometheus.io/blog/2021/11/16/agent/) setup to run in a Kubernetes cluster.<br><p> <br><p> The CRD is very similar to the `Prometheus` CRD except for features which aren't available in agent mode like rule evaluation, persistent storage and Thanos sidecar.
+     */
     @JsonProperty("spec")
     public PrometheusAgentSpec getSpec() {
         return spec;
     }
 
+    /**
+     * The `PrometheusAgent` custom resource definition (CRD) defines a desired [Prometheus Agent](https://prometheus.io/blog/2021/11/16/agent/) setup to run in a Kubernetes cluster.<br><p> <br><p> The CRD is very similar to the `Prometheus` CRD except for features which aren't available in agent mode like rule evaluation, persistent storage and Thanos sidecar.
+     */
     @JsonProperty("spec")
     public void setSpec(PrometheusAgentSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * The `PrometheusAgent` custom resource definition (CRD) defines a desired [Prometheus Agent](https://prometheus.io/blog/2021/11/16/agent/) setup to run in a Kubernetes cluster.<br><p> <br><p> The CRD is very similar to the `Prometheus` CRD except for features which aren't available in agent mode like rule evaluation, persistent storage and Thanos sidecar.
+     */
     @JsonProperty("status")
     public PrometheusStatus getStatus() {
         return status;
     }
 
+    /**
+     * The `PrometheusAgent` custom resource definition (CRD) defines a desired [Prometheus Agent](https://prometheus.io/blog/2021/11/16/agent/) setup to run in a Kubernetes cluster.<br><p> <br><p> The CRD is very similar to the `Prometheus` CRD except for features which aren't available in agent mode like rule evaluation, persistent storage and Thanos sidecar.
+     */
     @JsonProperty("status")
     public void setStatus(PrometheusStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PrometheusAgentList.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PrometheusAgentList.java
index 7371f831f68..301a8b35545 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PrometheusAgentList.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PrometheusAgentList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PrometheusAgentList is a list of Prometheus agents.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PrometheusAgentList implements Editable<PrometheusAgentListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.monitoring.v1alpha1.PrometheusAgent>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "monitoring.coreos.com/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.monitoring.v1alpha1.PrometheusAgent> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PrometheusAgentList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PrometheusAgentList(String apiVersion, List<io.fabric8.openshift.api.mode
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of Prometheus agents
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.monitoring.v1alpha1.PrometheusAgent> getItems() {
         return items;
     }
 
+    /**
+     * List of Prometheus agents
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.monitoring.v1alpha1.PrometheusAgent> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PrometheusAgentList is a list of Prometheus agents.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PrometheusAgentList is a list of Prometheus agents.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PrometheusAgentSpec.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PrometheusAgentSpec.java
index ce62df7b39a..f7caa1c1df9 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PrometheusAgentSpec.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PrometheusAgentSpec.java
@@ -54,6 +54,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -480,931 +483,1477 @@ public PrometheusAgentSpec(List<Argument> additionalArgs, SecretKeySelector addi
         this.web = web;
     }
 
+    /**
+     * AdditionalArgs allows setting additional arguments for the 'prometheus' container.<br><p> <br><p> It is intended for e.g. activating hidden flags which are not supported by the dedicated configuration options yet. The arguments are passed as-is to the Prometheus container which may cause issues if they are invalid or not supported by the given Prometheus version.<br><p> <br><p> In case of an argument conflict (e.g. an argument which is already set by the operator itself) or when providing an invalid argument, the reconciliation will fail and an error will be logged.
+     */
     @JsonProperty("additionalArgs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Argument> getAdditionalArgs() {
         return additionalArgs;
     }
 
+    /**
+     * AdditionalArgs allows setting additional arguments for the 'prometheus' container.<br><p> <br><p> It is intended for e.g. activating hidden flags which are not supported by the dedicated configuration options yet. The arguments are passed as-is to the Prometheus container which may cause issues if they are invalid or not supported by the given Prometheus version.<br><p> <br><p> In case of an argument conflict (e.g. an argument which is already set by the operator itself) or when providing an invalid argument, the reconciliation will fail and an error will be logged.
+     */
     @JsonProperty("additionalArgs")
     public void setAdditionalArgs(List<Argument> additionalArgs) {
         this.additionalArgs = additionalArgs;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("additionalScrapeConfigs")
     public SecretKeySelector getAdditionalScrapeConfigs() {
         return additionalScrapeConfigs;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("additionalScrapeConfigs")
     public void setAdditionalScrapeConfigs(SecretKeySelector additionalScrapeConfigs) {
         this.additionalScrapeConfigs = additionalScrapeConfigs;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("affinity")
     public Affinity getAffinity() {
         return affinity;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("affinity")
     public void setAffinity(Affinity affinity) {
         this.affinity = affinity;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("apiserverConfig")
     public APIServerConfig getApiserverConfig() {
         return apiserverConfig;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("apiserverConfig")
     public void setApiserverConfig(APIServerConfig apiserverConfig) {
         this.apiserverConfig = apiserverConfig;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("arbitraryFSAccessThroughSMs")
     public ArbitraryFSAccessThroughSMsConfig getArbitraryFSAccessThroughSMs() {
         return arbitraryFSAccessThroughSMs;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("arbitraryFSAccessThroughSMs")
     public void setArbitraryFSAccessThroughSMs(ArbitraryFSAccessThroughSMsConfig arbitraryFSAccessThroughSMs) {
         this.arbitraryFSAccessThroughSMs = arbitraryFSAccessThroughSMs;
     }
 
+    /**
+     * AutomountServiceAccountToken indicates whether a service account token should be automatically mounted in the pod. If the field isn't set, the operator mounts the service account token by default.<br><p> <br><p> &#42;&#42;Warning:&#42;&#42; be aware that by default, Prometheus requires the service account token for Kubernetes service discovery. It is possible to use strategic merge patch to project the service account token into the 'prometheus' container.
+     */
     @JsonProperty("automountServiceAccountToken")
     public Boolean getAutomountServiceAccountToken() {
         return automountServiceAccountToken;
     }
 
+    /**
+     * AutomountServiceAccountToken indicates whether a service account token should be automatically mounted in the pod. If the field isn't set, the operator mounts the service account token by default.<br><p> <br><p> &#42;&#42;Warning:&#42;&#42; be aware that by default, Prometheus requires the service account token for Kubernetes service discovery. It is possible to use strategic merge patch to project the service account token into the 'prometheus' container.
+     */
     @JsonProperty("automountServiceAccountToken")
     public void setAutomountServiceAccountToken(Boolean automountServiceAccountToken) {
         this.automountServiceAccountToken = automountServiceAccountToken;
     }
 
+    /**
+     * BodySizeLimit defines per-scrape on response body size. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedBodySizeLimit.
+     */
     @JsonProperty("bodySizeLimit")
     public String getBodySizeLimit() {
         return bodySizeLimit;
     }
 
+    /**
+     * BodySizeLimit defines per-scrape on response body size. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedBodySizeLimit.
+     */
     @JsonProperty("bodySizeLimit")
     public void setBodySizeLimit(String bodySizeLimit) {
         this.bodySizeLimit = bodySizeLimit;
     }
 
+    /**
+     * ConfigMaps is a list of ConfigMaps in the same namespace as the Prometheus object, which shall be mounted into the Prometheus Pods. Each ConfigMap is added to the StatefulSet definition as a volume named `configmap-&lt;configmap-name&gt;`. The ConfigMaps are mounted into /etc/prometheus/configmaps/&lt;configmap-name&gt; in the 'prometheus' container.
+     */
     @JsonProperty("configMaps")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getConfigMaps() {
         return configMaps;
     }
 
+    /**
+     * ConfigMaps is a list of ConfigMaps in the same namespace as the Prometheus object, which shall be mounted into the Prometheus Pods. Each ConfigMap is added to the StatefulSet definition as a volume named `configmap-&lt;configmap-name&gt;`. The ConfigMaps are mounted into /etc/prometheus/configmaps/&lt;configmap-name&gt; in the 'prometheus' container.
+     */
     @JsonProperty("configMaps")
     public void setConfigMaps(List<String> configMaps) {
         this.configMaps = configMaps;
     }
 
+    /**
+     * Containers allows injecting additional containers or modifying operator generated containers. This can be used to allow adding an authentication proxy to the Pods or to change the behavior of an operator generated container. Containers described here modify an operator generated container if they share the same name and modifications are done via a strategic merge patch.<br><p> <br><p> The names of containers managed by the operator are: &#42; `prometheus` &#42; `config-reloader` &#42; `thanos-sidecar`<br><p> <br><p> Overriding containers is entirely outside the scope of what the maintainers will support and by doing so, you accept that this behaviour may break at any time without notice.
+     */
     @JsonProperty("containers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Container> getContainers() {
         return containers;
     }
 
+    /**
+     * Containers allows injecting additional containers or modifying operator generated containers. This can be used to allow adding an authentication proxy to the Pods or to change the behavior of an operator generated container. Containers described here modify an operator generated container if they share the same name and modifications are done via a strategic merge patch.<br><p> <br><p> The names of containers managed by the operator are: &#42; `prometheus` &#42; `config-reloader` &#42; `thanos-sidecar`<br><p> <br><p> Overriding containers is entirely outside the scope of what the maintainers will support and by doing so, you accept that this behaviour may break at any time without notice.
+     */
     @JsonProperty("containers")
     public void setContainers(List<Container> containers) {
         this.containers = containers;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("dnsConfig")
     public PodDNSConfig getDnsConfig() {
         return dnsConfig;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("dnsConfig")
     public void setDnsConfig(PodDNSConfig dnsConfig) {
         this.dnsConfig = dnsConfig;
     }
 
+    /**
+     * Defines the DNS policy for the pods.
+     */
     @JsonProperty("dnsPolicy")
     public String getDnsPolicy() {
         return dnsPolicy;
     }
 
+    /**
+     * Defines the DNS policy for the pods.
+     */
     @JsonProperty("dnsPolicy")
     public void setDnsPolicy(String dnsPolicy) {
         this.dnsPolicy = dnsPolicy;
     }
 
+    /**
+     * Enable access to Prometheus feature flags. By default, no features are enabled.<br><p> <br><p> Enabling features which are disabled by default is entirely outside the scope of what the maintainers will support and by doing so, you accept that this behaviour may break at any time without notice.<br><p> <br><p> For more information see https://prometheus.io/docs/prometheus/latest/feature_flags/
+     */
     @JsonProperty("enableFeatures")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEnableFeatures() {
         return enableFeatures;
     }
 
+    /**
+     * Enable access to Prometheus feature flags. By default, no features are enabled.<br><p> <br><p> Enabling features which are disabled by default is entirely outside the scope of what the maintainers will support and by doing so, you accept that this behaviour may break at any time without notice.<br><p> <br><p> For more information see https://prometheus.io/docs/prometheus/latest/feature_flags/
+     */
     @JsonProperty("enableFeatures")
     public void setEnableFeatures(List<String> enableFeatures) {
         this.enableFeatures = enableFeatures;
     }
 
+    /**
+     * Enable Prometheus to be used as a receiver for the OTLP Metrics protocol.<br><p> <br><p> Note that the OTLP receiver endpoint is automatically enabled if `.spec.otlpConfig` is defined.<br><p> <br><p> It requires Prometheus &gt;= v2.47.0.
+     */
     @JsonProperty("enableOTLPReceiver")
     public Boolean getEnableOTLPReceiver() {
         return enableOTLPReceiver;
     }
 
+    /**
+     * Enable Prometheus to be used as a receiver for the OTLP Metrics protocol.<br><p> <br><p> Note that the OTLP receiver endpoint is automatically enabled if `.spec.otlpConfig` is defined.<br><p> <br><p> It requires Prometheus &gt;= v2.47.0.
+     */
     @JsonProperty("enableOTLPReceiver")
     public void setEnableOTLPReceiver(Boolean enableOTLPReceiver) {
         this.enableOTLPReceiver = enableOTLPReceiver;
     }
 
+    /**
+     * Enable Prometheus to be used as a receiver for the Prometheus remote write protocol.<br><p> <br><p> WARNING: This is not considered an efficient way of ingesting samples. Use it with caution for specific low-volume use cases. It is not suitable for replacing the ingestion via scraping and turning Prometheus into a push-based metrics collection system. For more information see https://prometheus.io/docs/prometheus/latest/querying/api/#remote-write-receiver<br><p> <br><p> It requires Prometheus &gt;= v2.33.0.
+     */
     @JsonProperty("enableRemoteWriteReceiver")
     public Boolean getEnableRemoteWriteReceiver() {
         return enableRemoteWriteReceiver;
     }
 
+    /**
+     * Enable Prometheus to be used as a receiver for the Prometheus remote write protocol.<br><p> <br><p> WARNING: This is not considered an efficient way of ingesting samples. Use it with caution for specific low-volume use cases. It is not suitable for replacing the ingestion via scraping and turning Prometheus into a push-based metrics collection system. For more information see https://prometheus.io/docs/prometheus/latest/querying/api/#remote-write-receiver<br><p> <br><p> It requires Prometheus &gt;= v2.33.0.
+     */
     @JsonProperty("enableRemoteWriteReceiver")
     public void setEnableRemoteWriteReceiver(Boolean enableRemoteWriteReceiver) {
         this.enableRemoteWriteReceiver = enableRemoteWriteReceiver;
     }
 
+    /**
+     * When defined, enforcedBodySizeLimit specifies a global limit on the size of uncompressed response body that will be accepted by Prometheus. Targets responding with a body larger than this many bytes will cause the scrape to fail.<br><p> <br><p> It requires Prometheus &gt;= v2.28.0.<br><p> <br><p> When both `enforcedBodySizeLimit` and `bodySizeLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined bodySizeLimit value will inherit the global bodySizeLimit value (Prometheus &gt;= 2.45.0) or the enforcedBodySizeLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedBodySizeLimit` is greater than the `bodySizeLimit`, the `bodySizeLimit` will be set to `enforcedBodySizeLimit`.<br><p> &#42; Scrape objects with a bodySizeLimit value less than or equal to enforcedBodySizeLimit keep their specific value. &#42; Scrape objects with a bodySizeLimit value greater than enforcedBodySizeLimit are set to enforcedBodySizeLimit.
+     */
     @JsonProperty("enforcedBodySizeLimit")
     public String getEnforcedBodySizeLimit() {
         return enforcedBodySizeLimit;
     }
 
+    /**
+     * When defined, enforcedBodySizeLimit specifies a global limit on the size of uncompressed response body that will be accepted by Prometheus. Targets responding with a body larger than this many bytes will cause the scrape to fail.<br><p> <br><p> It requires Prometheus &gt;= v2.28.0.<br><p> <br><p> When both `enforcedBodySizeLimit` and `bodySizeLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined bodySizeLimit value will inherit the global bodySizeLimit value (Prometheus &gt;= 2.45.0) or the enforcedBodySizeLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedBodySizeLimit` is greater than the `bodySizeLimit`, the `bodySizeLimit` will be set to `enforcedBodySizeLimit`.<br><p> &#42; Scrape objects with a bodySizeLimit value less than or equal to enforcedBodySizeLimit keep their specific value. &#42; Scrape objects with a bodySizeLimit value greater than enforcedBodySizeLimit are set to enforcedBodySizeLimit.
+     */
     @JsonProperty("enforcedBodySizeLimit")
     public void setEnforcedBodySizeLimit(String enforcedBodySizeLimit) {
         this.enforcedBodySizeLimit = enforcedBodySizeLimit;
     }
 
+    /**
+     * When defined, enforcedKeepDroppedTargets specifies a global limit on the number of targets dropped by relabeling that will be kept in memory. The value overrides any `spec.keepDroppedTargets` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.keepDroppedTargets` is greater than zero and less than `spec.enforcedKeepDroppedTargets`.<br><p> <br><p> It requires Prometheus &gt;= v2.47.0.<br><p> <br><p> When both `enforcedKeepDroppedTargets` and `keepDroppedTargets` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined keepDroppedTargets value will inherit the global keepDroppedTargets value (Prometheus &gt;= 2.45.0) or the enforcedKeepDroppedTargets value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedKeepDroppedTargets` is greater than the `keepDroppedTargets`, the `keepDroppedTargets` will be set to `enforcedKeepDroppedTargets`.<br><p> &#42; Scrape objects with a keepDroppedTargets value less than or equal to enforcedKeepDroppedTargets keep their specific value. &#42; Scrape objects with a keepDroppedTargets value greater than enforcedKeepDroppedTargets are set to enforcedKeepDroppedTargets.
+     */
     @JsonProperty("enforcedKeepDroppedTargets")
     public Long getEnforcedKeepDroppedTargets() {
         return enforcedKeepDroppedTargets;
     }
 
+    /**
+     * When defined, enforcedKeepDroppedTargets specifies a global limit on the number of targets dropped by relabeling that will be kept in memory. The value overrides any `spec.keepDroppedTargets` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.keepDroppedTargets` is greater than zero and less than `spec.enforcedKeepDroppedTargets`.<br><p> <br><p> It requires Prometheus &gt;= v2.47.0.<br><p> <br><p> When both `enforcedKeepDroppedTargets` and `keepDroppedTargets` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined keepDroppedTargets value will inherit the global keepDroppedTargets value (Prometheus &gt;= 2.45.0) or the enforcedKeepDroppedTargets value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedKeepDroppedTargets` is greater than the `keepDroppedTargets`, the `keepDroppedTargets` will be set to `enforcedKeepDroppedTargets`.<br><p> &#42; Scrape objects with a keepDroppedTargets value less than or equal to enforcedKeepDroppedTargets keep their specific value. &#42; Scrape objects with a keepDroppedTargets value greater than enforcedKeepDroppedTargets are set to enforcedKeepDroppedTargets.
+     */
     @JsonProperty("enforcedKeepDroppedTargets")
     public void setEnforcedKeepDroppedTargets(Long enforcedKeepDroppedTargets) {
         this.enforcedKeepDroppedTargets = enforcedKeepDroppedTargets;
     }
 
+    /**
+     * When defined, enforcedLabelLimit specifies a global limit on the number of labels per sample. The value overrides any `spec.labelLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.labelLimit` is greater than zero and less than `spec.enforcedLabelLimit`.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.<br><p> <br><p> When both `enforcedLabelLimit` and `labelLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined labelLimit value will inherit the global labelLimit value (Prometheus &gt;= 2.45.0) or the enforcedLabelLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedLabelLimit` is greater than the `labelLimit`, the `labelLimit` will be set to `enforcedLabelLimit`.<br><p> &#42; Scrape objects with a labelLimit value less than or equal to enforcedLabelLimit keep their specific value. &#42; Scrape objects with a labelLimit value greater than enforcedLabelLimit are set to enforcedLabelLimit.
+     */
     @JsonProperty("enforcedLabelLimit")
     public Long getEnforcedLabelLimit() {
         return enforcedLabelLimit;
     }
 
+    /**
+     * When defined, enforcedLabelLimit specifies a global limit on the number of labels per sample. The value overrides any `spec.labelLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.labelLimit` is greater than zero and less than `spec.enforcedLabelLimit`.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.<br><p> <br><p> When both `enforcedLabelLimit` and `labelLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined labelLimit value will inherit the global labelLimit value (Prometheus &gt;= 2.45.0) or the enforcedLabelLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedLabelLimit` is greater than the `labelLimit`, the `labelLimit` will be set to `enforcedLabelLimit`.<br><p> &#42; Scrape objects with a labelLimit value less than or equal to enforcedLabelLimit keep their specific value. &#42; Scrape objects with a labelLimit value greater than enforcedLabelLimit are set to enforcedLabelLimit.
+     */
     @JsonProperty("enforcedLabelLimit")
     public void setEnforcedLabelLimit(Long enforcedLabelLimit) {
         this.enforcedLabelLimit = enforcedLabelLimit;
     }
 
+    /**
+     * When defined, enforcedLabelNameLengthLimit specifies a global limit on the length of labels name per sample. The value overrides any `spec.labelNameLengthLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.labelNameLengthLimit` is greater than zero and less than `spec.enforcedLabelNameLengthLimit`.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.<br><p> <br><p> When both `enforcedLabelNameLengthLimit` and `labelNameLengthLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined labelNameLengthLimit value will inherit the global labelNameLengthLimit value (Prometheus &gt;= 2.45.0) or the enforcedLabelNameLengthLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedLabelNameLengthLimit` is greater than the `labelNameLengthLimit`, the `labelNameLengthLimit` will be set to `enforcedLabelNameLengthLimit`.<br><p> &#42; Scrape objects with a labelNameLengthLimit value less than or equal to enforcedLabelNameLengthLimit keep their specific value. &#42; Scrape objects with a labelNameLengthLimit value greater than enforcedLabelNameLengthLimit are set to enforcedLabelNameLengthLimit.
+     */
     @JsonProperty("enforcedLabelNameLengthLimit")
     public Long getEnforcedLabelNameLengthLimit() {
         return enforcedLabelNameLengthLimit;
     }
 
+    /**
+     * When defined, enforcedLabelNameLengthLimit specifies a global limit on the length of labels name per sample. The value overrides any `spec.labelNameLengthLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.labelNameLengthLimit` is greater than zero and less than `spec.enforcedLabelNameLengthLimit`.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.<br><p> <br><p> When both `enforcedLabelNameLengthLimit` and `labelNameLengthLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined labelNameLengthLimit value will inherit the global labelNameLengthLimit value (Prometheus &gt;= 2.45.0) or the enforcedLabelNameLengthLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedLabelNameLengthLimit` is greater than the `labelNameLengthLimit`, the `labelNameLengthLimit` will be set to `enforcedLabelNameLengthLimit`.<br><p> &#42; Scrape objects with a labelNameLengthLimit value less than or equal to enforcedLabelNameLengthLimit keep their specific value. &#42; Scrape objects with a labelNameLengthLimit value greater than enforcedLabelNameLengthLimit are set to enforcedLabelNameLengthLimit.
+     */
     @JsonProperty("enforcedLabelNameLengthLimit")
     public void setEnforcedLabelNameLengthLimit(Long enforcedLabelNameLengthLimit) {
         this.enforcedLabelNameLengthLimit = enforcedLabelNameLengthLimit;
     }
 
+    /**
+     * When not null, enforcedLabelValueLengthLimit defines a global limit on the length of labels value per sample. The value overrides any `spec.labelValueLengthLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.labelValueLengthLimit` is greater than zero and less than `spec.enforcedLabelValueLengthLimit`.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.<br><p> <br><p> When both `enforcedLabelValueLengthLimit` and `labelValueLengthLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined labelValueLengthLimit value will inherit the global labelValueLengthLimit value (Prometheus &gt;= 2.45.0) or the enforcedLabelValueLengthLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedLabelValueLengthLimit` is greater than the `labelValueLengthLimit`, the `labelValueLengthLimit` will be set to `enforcedLabelValueLengthLimit`.<br><p> &#42; Scrape objects with a labelValueLengthLimit value less than or equal to enforcedLabelValueLengthLimit keep their specific value. &#42; Scrape objects with a labelValueLengthLimit value greater than enforcedLabelValueLengthLimit are set to enforcedLabelValueLengthLimit.
+     */
     @JsonProperty("enforcedLabelValueLengthLimit")
     public Long getEnforcedLabelValueLengthLimit() {
         return enforcedLabelValueLengthLimit;
     }
 
+    /**
+     * When not null, enforcedLabelValueLengthLimit defines a global limit on the length of labels value per sample. The value overrides any `spec.labelValueLengthLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.labelValueLengthLimit` is greater than zero and less than `spec.enforcedLabelValueLengthLimit`.<br><p> <br><p> It requires Prometheus &gt;= v2.27.0.<br><p> <br><p> When both `enforcedLabelValueLengthLimit` and `labelValueLengthLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined labelValueLengthLimit value will inherit the global labelValueLengthLimit value (Prometheus &gt;= 2.45.0) or the enforcedLabelValueLengthLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedLabelValueLengthLimit` is greater than the `labelValueLengthLimit`, the `labelValueLengthLimit` will be set to `enforcedLabelValueLengthLimit`.<br><p> &#42; Scrape objects with a labelValueLengthLimit value less than or equal to enforcedLabelValueLengthLimit keep their specific value. &#42; Scrape objects with a labelValueLengthLimit value greater than enforcedLabelValueLengthLimit are set to enforcedLabelValueLengthLimit.
+     */
     @JsonProperty("enforcedLabelValueLengthLimit")
     public void setEnforcedLabelValueLengthLimit(Long enforcedLabelValueLengthLimit) {
         this.enforcedLabelValueLengthLimit = enforcedLabelValueLengthLimit;
     }
 
+    /**
+     * When not empty, a label will be added to:<br><p> <br><p> 1. All metrics scraped from `ServiceMonitor`, `PodMonitor`, `Probe` and `ScrapeConfig` objects. 2. All metrics generated from recording rules defined in `PrometheusRule` objects. 3. All alerts generated from alerting rules defined in `PrometheusRule` objects. 4. All vector selectors of PromQL expressions defined in `PrometheusRule` objects.<br><p> <br><p> The label will not added for objects referenced in `spec.excludedFromEnforcement`.<br><p> <br><p> The label's name is this field's value. The label's value is the namespace of the `ServiceMonitor`, `PodMonitor`, `Probe`, `PrometheusRule` or `ScrapeConfig` object.
+     */
     @JsonProperty("enforcedNamespaceLabel")
     public String getEnforcedNamespaceLabel() {
         return enforcedNamespaceLabel;
     }
 
+    /**
+     * When not empty, a label will be added to:<br><p> <br><p> 1. All metrics scraped from `ServiceMonitor`, `PodMonitor`, `Probe` and `ScrapeConfig` objects. 2. All metrics generated from recording rules defined in `PrometheusRule` objects. 3. All alerts generated from alerting rules defined in `PrometheusRule` objects. 4. All vector selectors of PromQL expressions defined in `PrometheusRule` objects.<br><p> <br><p> The label will not added for objects referenced in `spec.excludedFromEnforcement`.<br><p> <br><p> The label's name is this field's value. The label's value is the namespace of the `ServiceMonitor`, `PodMonitor`, `Probe`, `PrometheusRule` or `ScrapeConfig` object.
+     */
     @JsonProperty("enforcedNamespaceLabel")
     public void setEnforcedNamespaceLabel(String enforcedNamespaceLabel) {
         this.enforcedNamespaceLabel = enforcedNamespaceLabel;
     }
 
+    /**
+     * When defined, enforcedSampleLimit specifies a global limit on the number of scraped samples that will be accepted. This overrides any `spec.sampleLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.sampleLimit` is greater than zero and less than `spec.enforcedSampleLimit`.<br><p> <br><p> It is meant to be used by admins to keep the overall number of samples/series under a desired limit.<br><p> <br><p> When both `enforcedSampleLimit` and `sampleLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined sampleLimit value will inherit the global sampleLimit value (Prometheus &gt;= 2.45.0) or the enforcedSampleLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedSampleLimit` is greater than the `sampleLimit`, the `sampleLimit` will be set to `enforcedSampleLimit`.<br><p> &#42; Scrape objects with a sampleLimit value less than or equal to enforcedSampleLimit keep their specific value. &#42; Scrape objects with a sampleLimit value greater than enforcedSampleLimit are set to enforcedSampleLimit.
+     */
     @JsonProperty("enforcedSampleLimit")
     public Long getEnforcedSampleLimit() {
         return enforcedSampleLimit;
     }
 
+    /**
+     * When defined, enforcedSampleLimit specifies a global limit on the number of scraped samples that will be accepted. This overrides any `spec.sampleLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.sampleLimit` is greater than zero and less than `spec.enforcedSampleLimit`.<br><p> <br><p> It is meant to be used by admins to keep the overall number of samples/series under a desired limit.<br><p> <br><p> When both `enforcedSampleLimit` and `sampleLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined sampleLimit value will inherit the global sampleLimit value (Prometheus &gt;= 2.45.0) or the enforcedSampleLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedSampleLimit` is greater than the `sampleLimit`, the `sampleLimit` will be set to `enforcedSampleLimit`.<br><p> &#42; Scrape objects with a sampleLimit value less than or equal to enforcedSampleLimit keep their specific value. &#42; Scrape objects with a sampleLimit value greater than enforcedSampleLimit are set to enforcedSampleLimit.
+     */
     @JsonProperty("enforcedSampleLimit")
     public void setEnforcedSampleLimit(Long enforcedSampleLimit) {
         this.enforcedSampleLimit = enforcedSampleLimit;
     }
 
+    /**
+     * When defined, enforcedTargetLimit specifies a global limit on the number of scraped targets. The value overrides any `spec.targetLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.targetLimit` is greater than zero and less than `spec.enforcedTargetLimit`.<br><p> <br><p> It is meant to be used by admins to to keep the overall number of targets under a desired limit.<br><p> <br><p> When both `enforcedTargetLimit` and `targetLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined targetLimit value will inherit the global targetLimit value (Prometheus &gt;= 2.45.0) or the enforcedTargetLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedTargetLimit` is greater than the `targetLimit`, the `targetLimit` will be set to `enforcedTargetLimit`.<br><p> &#42; Scrape objects with a targetLimit value less than or equal to enforcedTargetLimit keep their specific value. &#42; Scrape objects with a targetLimit value greater than enforcedTargetLimit are set to enforcedTargetLimit.
+     */
     @JsonProperty("enforcedTargetLimit")
     public Long getEnforcedTargetLimit() {
         return enforcedTargetLimit;
     }
 
+    /**
+     * When defined, enforcedTargetLimit specifies a global limit on the number of scraped targets. The value overrides any `spec.targetLimit` set by ServiceMonitor, PodMonitor, Probe objects unless `spec.targetLimit` is greater than zero and less than `spec.enforcedTargetLimit`.<br><p> <br><p> It is meant to be used by admins to to keep the overall number of targets under a desired limit.<br><p> <br><p> When both `enforcedTargetLimit` and `targetLimit` are defined and greater than zero, the following rules apply: &#42; Scrape objects without a defined targetLimit value will inherit the global targetLimit value (Prometheus &gt;= 2.45.0) or the enforcedTargetLimit value (Prometheus &lt; v2.45.0).<br><p>   If Prometheus version is &gt;= 2.45.0 and the `enforcedTargetLimit` is greater than the `targetLimit`, the `targetLimit` will be set to `enforcedTargetLimit`.<br><p> &#42; Scrape objects with a targetLimit value less than or equal to enforcedTargetLimit keep their specific value. &#42; Scrape objects with a targetLimit value greater than enforcedTargetLimit are set to enforcedTargetLimit.
+     */
     @JsonProperty("enforcedTargetLimit")
     public void setEnforcedTargetLimit(Long enforcedTargetLimit) {
         this.enforcedTargetLimit = enforcedTargetLimit;
     }
 
+    /**
+     * List of references to PodMonitor, ServiceMonitor, Probe and PrometheusRule objects to be excluded from enforcing a namespace label of origin.<br><p> <br><p> It is only applicable if `spec.enforcedNamespaceLabel` set to true.
+     */
     @JsonProperty("excludedFromEnforcement")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ObjectReference> getExcludedFromEnforcement() {
         return excludedFromEnforcement;
     }
 
+    /**
+     * List of references to PodMonitor, ServiceMonitor, Probe and PrometheusRule objects to be excluded from enforcing a namespace label of origin.<br><p> <br><p> It is only applicable if `spec.enforcedNamespaceLabel` set to true.
+     */
     @JsonProperty("excludedFromEnforcement")
     public void setExcludedFromEnforcement(List<ObjectReference> excludedFromEnforcement) {
         this.excludedFromEnforcement = excludedFromEnforcement;
     }
 
+    /**
+     * The labels to add to any time series or alerts when communicating with external systems (federation, remote storage, Alertmanager). Labels defined by `spec.replicaExternalLabelName` and `spec.prometheusExternalLabelName` take precedence over this list.
+     */
     @JsonProperty("externalLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getExternalLabels() {
         return externalLabels;
     }
 
+    /**
+     * The labels to add to any time series or alerts when communicating with external systems (federation, remote storage, Alertmanager). Labels defined by `spec.replicaExternalLabelName` and `spec.prometheusExternalLabelName` take precedence over this list.
+     */
     @JsonProperty("externalLabels")
     public void setExternalLabels(Map<String, String> externalLabels) {
         this.externalLabels = externalLabels;
     }
 
+    /**
+     * The external URL under which the Prometheus service is externally available. This is necessary to generate correct URLs (for instance if Prometheus is accessible behind an Ingress resource).
+     */
     @JsonProperty("externalUrl")
     public String getExternalUrl() {
         return externalUrl;
     }
 
+    /**
+     * The external URL under which the Prometheus service is externally available. This is necessary to generate correct URLs (for instance if Prometheus is accessible behind an Ingress resource).
+     */
     @JsonProperty("externalUrl")
     public void setExternalUrl(String externalUrl) {
         this.externalUrl = externalUrl;
     }
 
+    /**
+     * Optional list of hosts and IPs that will be injected into the Pod's hosts file if specified.
+     */
     @JsonProperty("hostAliases")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HostAlias> getHostAliases() {
         return hostAliases;
     }
 
+    /**
+     * Optional list of hosts and IPs that will be injected into the Pod's hosts file if specified.
+     */
     @JsonProperty("hostAliases")
     public void setHostAliases(List<HostAlias> hostAliases) {
         this.hostAliases = hostAliases;
     }
 
+    /**
+     * Use the host's network namespace if true.<br><p> <br><p> Make sure to understand the security implications if you want to enable it (https://kubernetes.io/docs/concepts/configuration/overview/).<br><p> <br><p> When hostNetwork is enabled, this will set the DNS policy to `ClusterFirstWithHostNet` automatically (unless `.spec.DNSPolicy` is set to a different value).
+     */
     @JsonProperty("hostNetwork")
     public Boolean getHostNetwork() {
         return hostNetwork;
     }
 
+    /**
+     * Use the host's network namespace if true.<br><p> <br><p> Make sure to understand the security implications if you want to enable it (https://kubernetes.io/docs/concepts/configuration/overview/).<br><p> <br><p> When hostNetwork is enabled, this will set the DNS policy to `ClusterFirstWithHostNet` automatically (unless `.spec.DNSPolicy` is set to a different value).
+     */
     @JsonProperty("hostNetwork")
     public void setHostNetwork(Boolean hostNetwork) {
         this.hostNetwork = hostNetwork;
     }
 
+    /**
+     * When true, `spec.namespaceSelector` from all PodMonitor, ServiceMonitor and Probe objects will be ignored. They will only discover targets within the namespace of the PodMonitor, ServiceMonitor and Probe object.
+     */
     @JsonProperty("ignoreNamespaceSelectors")
     public Boolean getIgnoreNamespaceSelectors() {
         return ignoreNamespaceSelectors;
     }
 
+    /**
+     * When true, `spec.namespaceSelector` from all PodMonitor, ServiceMonitor and Probe objects will be ignored. They will only discover targets within the namespace of the PodMonitor, ServiceMonitor and Probe object.
+     */
     @JsonProperty("ignoreNamespaceSelectors")
     public void setIgnoreNamespaceSelectors(Boolean ignoreNamespaceSelectors) {
         this.ignoreNamespaceSelectors = ignoreNamespaceSelectors;
     }
 
+    /**
+     * Container image name for Prometheus. If specified, it takes precedence over the `spec.baseImage`, `spec.tag` and `spec.sha` fields.<br><p> <br><p> Specifying `spec.version` is still necessary to ensure the Prometheus Operator knows which version of Prometheus is being configured.<br><p> <br><p> If neither `spec.image` nor `spec.baseImage` are defined, the operator will use the latest upstream version of Prometheus available at the time when the operator was released.
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * Container image name for Prometheus. If specified, it takes precedence over the `spec.baseImage`, `spec.tag` and `spec.sha` fields.<br><p> <br><p> Specifying `spec.version` is still necessary to ensure the Prometheus Operator knows which version of Prometheus is being configured.<br><p> <br><p> If neither `spec.image` nor `spec.baseImage` are defined, the operator will use the latest upstream version of Prometheus available at the time when the operator was released.
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
     }
 
+    /**
+     * Image pull policy for the 'prometheus', 'init-config-reloader' and 'config-reloader' containers. See https://kubernetes.io/docs/concepts/containers/images/#image-pull-policy for more details.<br><p> <br><p> Possible enum values:<br><p>  - `"Always"` means that kubelet always attempts to pull the latest image. Container will fail If the pull fails.<br><p>  - `"IfNotPresent"` means that kubelet pulls if the image isn't present on disk. Container will fail if the image isn't present and the pull fails.<br><p>  - `"Never"` means that kubelet never pulls an image, but only uses a local image. Container will fail if the image isn't present
+     */
     @JsonProperty("imagePullPolicy")
     public String getImagePullPolicy() {
         return imagePullPolicy;
     }
 
+    /**
+     * Image pull policy for the 'prometheus', 'init-config-reloader' and 'config-reloader' containers. See https://kubernetes.io/docs/concepts/containers/images/#image-pull-policy for more details.<br><p> <br><p> Possible enum values:<br><p>  - `"Always"` means that kubelet always attempts to pull the latest image. Container will fail If the pull fails.<br><p>  - `"IfNotPresent"` means that kubelet pulls if the image isn't present on disk. Container will fail if the image isn't present and the pull fails.<br><p>  - `"Never"` means that kubelet never pulls an image, but only uses a local image. Container will fail if the image isn't present
+     */
     @JsonProperty("imagePullPolicy")
     public void setImagePullPolicy(String imagePullPolicy) {
         this.imagePullPolicy = imagePullPolicy;
     }
 
+    /**
+     * An optional list of references to Secrets in the same namespace to use for pulling images from registries. See http://kubernetes.io/docs/user-guide/images#specifying-imagepullsecrets-on-a-pod
+     */
     @JsonProperty("imagePullSecrets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LocalObjectReference> getImagePullSecrets() {
         return imagePullSecrets;
     }
 
+    /**
+     * An optional list of references to Secrets in the same namespace to use for pulling images from registries. See http://kubernetes.io/docs/user-guide/images#specifying-imagepullsecrets-on-a-pod
+     */
     @JsonProperty("imagePullSecrets")
     public void setImagePullSecrets(List<LocalObjectReference> imagePullSecrets) {
         this.imagePullSecrets = imagePullSecrets;
     }
 
+    /**
+     * InitContainers allows injecting initContainers to the Pod definition. Those can be used to e.g.  fetch secrets for injection into the Prometheus configuration from external sources. Any errors during the execution of an initContainer will lead to a restart of the Pod. More info: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/ InitContainers described here modify an operator generated init containers if they share the same name and modifications are done via a strategic merge patch.<br><p> <br><p> The names of init container name managed by the operator are: &#42; `init-config-reloader`.<br><p> <br><p> Overriding init containers is entirely outside the scope of what the maintainers will support and by doing so, you accept that this behaviour may break at any time without notice.
+     */
     @JsonProperty("initContainers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Container> getInitContainers() {
         return initContainers;
     }
 
+    /**
+     * InitContainers allows injecting initContainers to the Pod definition. Those can be used to e.g.  fetch secrets for injection into the Prometheus configuration from external sources. Any errors during the execution of an initContainer will lead to a restart of the Pod. More info: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/ InitContainers described here modify an operator generated init containers if they share the same name and modifications are done via a strategic merge patch.<br><p> <br><p> The names of init container name managed by the operator are: &#42; `init-config-reloader`.<br><p> <br><p> Overriding init containers is entirely outside the scope of what the maintainers will support and by doing so, you accept that this behaviour may break at any time without notice.
+     */
     @JsonProperty("initContainers")
     public void setInitContainers(List<Container> initContainers) {
         this.initContainers = initContainers;
     }
 
+    /**
+     * Per-scrape limit on the number of targets dropped by relabeling that will be kept in memory. 0 means no limit.<br><p> <br><p> It requires Prometheus &gt;= v2.47.0.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedKeepDroppedTargets.
+     */
     @JsonProperty("keepDroppedTargets")
     public Long getKeepDroppedTargets() {
         return keepDroppedTargets;
     }
 
+    /**
+     * Per-scrape limit on the number of targets dropped by relabeling that will be kept in memory. 0 means no limit.<br><p> <br><p> It requires Prometheus &gt;= v2.47.0.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedKeepDroppedTargets.
+     */
     @JsonProperty("keepDroppedTargets")
     public void setKeepDroppedTargets(Long keepDroppedTargets) {
         this.keepDroppedTargets = keepDroppedTargets;
     }
 
+    /**
+     * Per-scrape limit on number of labels that will be accepted for a sample. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedLabelLimit.
+     */
     @JsonProperty("labelLimit")
     public Long getLabelLimit() {
         return labelLimit;
     }
 
+    /**
+     * Per-scrape limit on number of labels that will be accepted for a sample. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedLabelLimit.
+     */
     @JsonProperty("labelLimit")
     public void setLabelLimit(Long labelLimit) {
         this.labelLimit = labelLimit;
     }
 
+    /**
+     * Per-scrape limit on length of labels name that will be accepted for a sample. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedLabelNameLengthLimit.
+     */
     @JsonProperty("labelNameLengthLimit")
     public Long getLabelNameLengthLimit() {
         return labelNameLengthLimit;
     }
 
+    /**
+     * Per-scrape limit on length of labels name that will be accepted for a sample. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedLabelNameLengthLimit.
+     */
     @JsonProperty("labelNameLengthLimit")
     public void setLabelNameLengthLimit(Long labelNameLengthLimit) {
         this.labelNameLengthLimit = labelNameLengthLimit;
     }
 
+    /**
+     * Per-scrape limit on length of labels value that will be accepted for a sample. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedLabelValueLengthLimit.
+     */
     @JsonProperty("labelValueLengthLimit")
     public Long getLabelValueLengthLimit() {
         return labelValueLengthLimit;
     }
 
+    /**
+     * Per-scrape limit on length of labels value that will be accepted for a sample. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedLabelValueLengthLimit.
+     */
     @JsonProperty("labelValueLengthLimit")
     public void setLabelValueLengthLimit(Long labelValueLengthLimit) {
         this.labelValueLengthLimit = labelValueLengthLimit;
     }
 
+    /**
+     * When true, the Prometheus server listens on the loopback address instead of the Pod IP's address.
+     */
     @JsonProperty("listenLocal")
     public Boolean getListenLocal() {
         return listenLocal;
     }
 
+    /**
+     * When true, the Prometheus server listens on the loopback address instead of the Pod IP's address.
+     */
     @JsonProperty("listenLocal")
     public void setListenLocal(Boolean listenLocal) {
         this.listenLocal = listenLocal;
     }
 
+    /**
+     * Log format for Log level for Prometheus and the config-reloader sidecar.
+     */
     @JsonProperty("logFormat")
     public String getLogFormat() {
         return logFormat;
     }
 
+    /**
+     * Log format for Log level for Prometheus and the config-reloader sidecar.
+     */
     @JsonProperty("logFormat")
     public void setLogFormat(String logFormat) {
         this.logFormat = logFormat;
     }
 
+    /**
+     * Log level for Prometheus and the config-reloader sidecar.
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * Log level for Prometheus and the config-reloader sidecar.
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * Defines the maximum time that the `prometheus` container's startup probe will wait before being considered failed. The startup probe will return success after the WAL replay is complete. If set, the value should be greater than 60 (seconds). Otherwise it will be equal to 600 seconds (15 minutes).
+     */
     @JsonProperty("maximumStartupDurationSeconds")
     public Integer getMaximumStartupDurationSeconds() {
         return maximumStartupDurationSeconds;
     }
 
+    /**
+     * Defines the maximum time that the `prometheus` container's startup probe will wait before being considered failed. The startup probe will return success after the WAL replay is complete. If set, the value should be greater than 60 (seconds). Otherwise it will be equal to 600 seconds (15 minutes).
+     */
     @JsonProperty("maximumStartupDurationSeconds")
     public void setMaximumStartupDurationSeconds(Integer maximumStartupDurationSeconds) {
         this.maximumStartupDurationSeconds = maximumStartupDurationSeconds;
     }
 
+    /**
+     * Minimum number of seconds for which a newly created Pod should be ready without any of its container crashing for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready)<br><p> <br><p> This is an alpha field from kubernetes 1.22 until 1.24 which requires enabling the StatefulSetMinReadySeconds feature gate.
+     */
     @JsonProperty("minReadySeconds")
     public Long getMinReadySeconds() {
         return minReadySeconds;
     }
 
+    /**
+     * Minimum number of seconds for which a newly created Pod should be ready without any of its container crashing for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready)<br><p> <br><p> This is an alpha field from kubernetes 1.22 until 1.24 which requires enabling the StatefulSetMinReadySeconds feature gate.
+     */
     @JsonProperty("minReadySeconds")
     public void setMinReadySeconds(Long minReadySeconds) {
         this.minReadySeconds = minReadySeconds;
     }
 
+    /**
+     * Mode defines how the Prometheus operator deploys the PrometheusAgent pod(s). For now this field has no effect.<br><p> <br><p> (Alpha) Using this field requires the `PrometheusAgentDaemonSet` feature gate to be enabled.
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Mode defines how the Prometheus operator deploys the PrometheusAgent pod(s). For now this field has no effect.<br><p> <br><p> (Alpha) Using this field requires the `PrometheusAgentDaemonSet` feature gate to be enabled.
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
     }
 
+    /**
+     * Specifies the validation scheme for metric and label names.
+     */
     @JsonProperty("nameValidationScheme")
     public String getNameValidationScheme() {
         return nameValidationScheme;
     }
 
+    /**
+     * Specifies the validation scheme for metric and label names.
+     */
     @JsonProperty("nameValidationScheme")
     public void setNameValidationScheme(String nameValidationScheme) {
         this.nameValidationScheme = nameValidationScheme;
     }
 
+    /**
+     * Defines on which Nodes the Pods are scheduled.
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * Defines on which Nodes the Pods are scheduled.
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("otlp")
     public OTLPConfig getOtlp() {
         return otlp;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("otlp")
     public void setOtlp(OTLPConfig otlp) {
         this.otlp = otlp;
     }
 
+    /**
+     * When true, Prometheus resolves label conflicts by renaming the labels in the scraped data<br><p>  to "exported_" for all targets created from ServiceMonitor, PodMonitor and<br><p> ScrapeConfig objects. Otherwise the HonorLabels field of the service or pod monitor applies. In practice,`overrideHonorLaels:true` enforces `honorLabels:false` for all ServiceMonitor, PodMonitor and ScrapeConfig objects.
+     */
     @JsonProperty("overrideHonorLabels")
     public Boolean getOverrideHonorLabels() {
         return overrideHonorLabels;
     }
 
+    /**
+     * When true, Prometheus resolves label conflicts by renaming the labels in the scraped data<br><p>  to "exported_" for all targets created from ServiceMonitor, PodMonitor and<br><p> ScrapeConfig objects. Otherwise the HonorLabels field of the service or pod monitor applies. In practice,`overrideHonorLaels:true` enforces `honorLabels:false` for all ServiceMonitor, PodMonitor and ScrapeConfig objects.
+     */
     @JsonProperty("overrideHonorLabels")
     public void setOverrideHonorLabels(Boolean overrideHonorLabels) {
         this.overrideHonorLabels = overrideHonorLabels;
     }
 
+    /**
+     * When true, Prometheus ignores the timestamps for all the targets created from service and pod monitors. Otherwise the HonorTimestamps field of the service or pod monitor applies.
+     */
     @JsonProperty("overrideHonorTimestamps")
     public Boolean getOverrideHonorTimestamps() {
         return overrideHonorTimestamps;
     }
 
+    /**
+     * When true, Prometheus ignores the timestamps for all the targets created from service and pod monitors. Otherwise the HonorTimestamps field of the service or pod monitor applies.
+     */
     @JsonProperty("overrideHonorTimestamps")
     public void setOverrideHonorTimestamps(Boolean overrideHonorTimestamps) {
         this.overrideHonorTimestamps = overrideHonorTimestamps;
     }
 
+    /**
+     * When a Prometheus deployment is paused, no actions except for deletion will be performed on the underlying objects.
+     */
     @JsonProperty("paused")
     public Boolean getPaused() {
         return paused;
     }
 
+    /**
+     * When a Prometheus deployment is paused, no actions except for deletion will be performed on the underlying objects.
+     */
     @JsonProperty("paused")
     public void setPaused(Boolean paused) {
         this.paused = paused;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("persistentVolumeClaimRetentionPolicy")
     public StatefulSetPersistentVolumeClaimRetentionPolicy getPersistentVolumeClaimRetentionPolicy() {
         return persistentVolumeClaimRetentionPolicy;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("persistentVolumeClaimRetentionPolicy")
     public void setPersistentVolumeClaimRetentionPolicy(StatefulSetPersistentVolumeClaimRetentionPolicy persistentVolumeClaimRetentionPolicy) {
         this.persistentVolumeClaimRetentionPolicy = persistentVolumeClaimRetentionPolicy;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("podMetadata")
     public EmbeddedObjectMetadata getPodMetadata() {
         return podMetadata;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("podMetadata")
     public void setPodMetadata(EmbeddedObjectMetadata podMetadata) {
         this.podMetadata = podMetadata;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("podMonitorNamespaceSelector")
     public LabelSelector getPodMonitorNamespaceSelector() {
         return podMonitorNamespaceSelector;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("podMonitorNamespaceSelector")
     public void setPodMonitorNamespaceSelector(LabelSelector podMonitorNamespaceSelector) {
         this.podMonitorNamespaceSelector = podMonitorNamespaceSelector;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("podMonitorSelector")
     public LabelSelector getPodMonitorSelector() {
         return podMonitorSelector;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("podMonitorSelector")
     public void setPodMonitorSelector(LabelSelector podMonitorSelector) {
         this.podMonitorSelector = podMonitorSelector;
     }
 
+    /**
+     * PodTargetLabels are appended to the `spec.podTargetLabels` field of all PodMonitor and ServiceMonitor objects.
+     */
     @JsonProperty("podTargetLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPodTargetLabels() {
         return podTargetLabels;
     }
 
+    /**
+     * PodTargetLabels are appended to the `spec.podTargetLabels` field of all PodMonitor and ServiceMonitor objects.
+     */
     @JsonProperty("podTargetLabels")
     public void setPodTargetLabels(List<String> podTargetLabels) {
         this.podTargetLabels = podTargetLabels;
     }
 
+    /**
+     * Port name used for the pods and governing service. Default: "web"
+     */
     @JsonProperty("portName")
     public String getPortName() {
         return portName;
     }
 
+    /**
+     * Port name used for the pods and governing service. Default: "web"
+     */
     @JsonProperty("portName")
     public void setPortName(String portName) {
         this.portName = portName;
     }
 
+    /**
+     * Priority class assigned to the Pods.
+     */
     @JsonProperty("priorityClassName")
     public String getPriorityClassName() {
         return priorityClassName;
     }
 
+    /**
+     * Priority class assigned to the Pods.
+     */
     @JsonProperty("priorityClassName")
     public void setPriorityClassName(String priorityClassName) {
         this.priorityClassName = priorityClassName;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("probeNamespaceSelector")
     public LabelSelector getProbeNamespaceSelector() {
         return probeNamespaceSelector;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("probeNamespaceSelector")
     public void setProbeNamespaceSelector(LabelSelector probeNamespaceSelector) {
         this.probeNamespaceSelector = probeNamespaceSelector;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("probeSelector")
     public LabelSelector getProbeSelector() {
         return probeSelector;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("probeSelector")
     public void setProbeSelector(LabelSelector probeSelector) {
         this.probeSelector = probeSelector;
     }
 
+    /**
+     * Name of Prometheus external label used to denote the Prometheus instance name. The external label will _not_ be added when the field is set to the empty string (`""`).<br><p> <br><p> Default: "prometheus"
+     */
     @JsonProperty("prometheusExternalLabelName")
     public String getPrometheusExternalLabelName() {
         return prometheusExternalLabelName;
     }
 
+    /**
+     * Name of Prometheus external label used to denote the Prometheus instance name. The external label will _not_ be added when the field is set to the empty string (`""`).<br><p> <br><p> Default: "prometheus"
+     */
     @JsonProperty("prometheusExternalLabelName")
     public void setPrometheusExternalLabelName(String prometheusExternalLabelName) {
         this.prometheusExternalLabelName = prometheusExternalLabelName;
     }
 
+    /**
+     * Defines the strategy used to reload the Prometheus configuration. If not specified, the configuration is reloaded using the /-/reload HTTP endpoint.
+     */
     @JsonProperty("reloadStrategy")
     public String getReloadStrategy() {
         return reloadStrategy;
     }
 
+    /**
+     * Defines the strategy used to reload the Prometheus configuration. If not specified, the configuration is reloaded using the /-/reload HTTP endpoint.
+     */
     @JsonProperty("reloadStrategy")
     public void setReloadStrategy(String reloadStrategy) {
         this.reloadStrategy = reloadStrategy;
     }
 
+    /**
+     * Defines the list of remote write configurations.
+     */
     @JsonProperty("remoteWrite")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RemoteWriteSpec> getRemoteWrite() {
         return remoteWrite;
     }
 
+    /**
+     * Defines the list of remote write configurations.
+     */
     @JsonProperty("remoteWrite")
     public void setRemoteWrite(List<RemoteWriteSpec> remoteWrite) {
         this.remoteWrite = remoteWrite;
     }
 
+    /**
+     * List of the protobuf message versions to accept when receiving the remote writes.<br><p> <br><p> It requires Prometheus &gt;= v2.54.0.
+     */
     @JsonProperty("remoteWriteReceiverMessageVersions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getRemoteWriteReceiverMessageVersions() {
         return remoteWriteReceiverMessageVersions;
     }
 
+    /**
+     * List of the protobuf message versions to accept when receiving the remote writes.<br><p> <br><p> It requires Prometheus &gt;= v2.54.0.
+     */
     @JsonProperty("remoteWriteReceiverMessageVersions")
     public void setRemoteWriteReceiverMessageVersions(List<String> remoteWriteReceiverMessageVersions) {
         this.remoteWriteReceiverMessageVersions = remoteWriteReceiverMessageVersions;
     }
 
+    /**
+     * Name of Prometheus external label used to denote the replica name. The external label will _not_ be added when the field is set to the empty string (`""`).<br><p> <br><p> Default: "prometheus_replica"
+     */
     @JsonProperty("replicaExternalLabelName")
     public String getReplicaExternalLabelName() {
         return replicaExternalLabelName;
     }
 
+    /**
+     * Name of Prometheus external label used to denote the replica name. The external label will _not_ be added when the field is set to the empty string (`""`).<br><p> <br><p> Default: "prometheus_replica"
+     */
     @JsonProperty("replicaExternalLabelName")
     public void setReplicaExternalLabelName(String replicaExternalLabelName) {
         this.replicaExternalLabelName = replicaExternalLabelName;
     }
 
+    /**
+     * Number of replicas of each shard to deploy for a Prometheus deployment. `spec.replicas` multiplied by `spec.shards` is the total number of Pods created.<br><p> <br><p> Default: 1
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Number of replicas of each shard to deploy for a Prometheus deployment. `spec.replicas` multiplied by `spec.shards` is the total number of Pods created.<br><p> <br><p> Default: 1
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * The route prefix Prometheus registers HTTP handlers for.<br><p> <br><p> This is useful when using `spec.externalURL`, and a proxy is rewriting HTTP routes of a request, and the actual ExternalURL is still true, but the server serves requests under a different route prefix. For example for use with `kubectl proxy`.
+     */
     @JsonProperty("routePrefix")
     public String getRoutePrefix() {
         return routePrefix;
     }
 
+    /**
+     * The route prefix Prometheus registers HTTP handlers for.<br><p> <br><p> This is useful when using `spec.externalURL`, and a proxy is rewriting HTTP routes of a request, and the actual ExternalURL is still true, but the server serves requests under a different route prefix. For example for use with `kubectl proxy`.
+     */
     @JsonProperty("routePrefix")
     public void setRoutePrefix(String routePrefix) {
         this.routePrefix = routePrefix;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("runtime")
     public RuntimeConfig getRuntime() {
         return runtime;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("runtime")
     public void setRuntime(RuntimeConfig runtime) {
         this.runtime = runtime;
     }
 
+    /**
+     * SampleLimit defines per-scrape limit on number of scraped samples that will be accepted. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedSampleLimit.
+     */
     @JsonProperty("sampleLimit")
     public Long getSampleLimit() {
         return sampleLimit;
     }
 
+    /**
+     * SampleLimit defines per-scrape limit on number of scraped samples that will be accepted. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedSampleLimit.
+     */
     @JsonProperty("sampleLimit")
     public void setSampleLimit(Long sampleLimit) {
         this.sampleLimit = sampleLimit;
     }
 
+    /**
+     * List of scrape classes to expose to scraping objects such as PodMonitors, ServiceMonitors, Probes and ScrapeConfigs.<br><p> <br><p> This is an &#42;experimental feature&#42;, it may change in any upcoming release in a breaking way.
+     */
     @JsonProperty("scrapeClasses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ScrapeClass> getScrapeClasses() {
         return scrapeClasses;
     }
 
+    /**
+     * List of scrape classes to expose to scraping objects such as PodMonitors, ServiceMonitors, Probes and ScrapeConfigs.<br><p> <br><p> This is an &#42;experimental feature&#42;, it may change in any upcoming release in a breaking way.
+     */
     @JsonProperty("scrapeClasses")
     public void setScrapeClasses(List<ScrapeClass> scrapeClasses) {
         this.scrapeClasses = scrapeClasses;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("scrapeConfigNamespaceSelector")
     public LabelSelector getScrapeConfigNamespaceSelector() {
         return scrapeConfigNamespaceSelector;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("scrapeConfigNamespaceSelector")
     public void setScrapeConfigNamespaceSelector(LabelSelector scrapeConfigNamespaceSelector) {
         this.scrapeConfigNamespaceSelector = scrapeConfigNamespaceSelector;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("scrapeConfigSelector")
     public LabelSelector getScrapeConfigSelector() {
         return scrapeConfigSelector;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("scrapeConfigSelector")
     public void setScrapeConfigSelector(LabelSelector scrapeConfigSelector) {
         this.scrapeConfigSelector = scrapeConfigSelector;
     }
 
+    /**
+     * Interval between consecutive scrapes.<br><p> <br><p> Default: "30s"
+     */
     @JsonProperty("scrapeInterval")
     public String getScrapeInterval() {
         return scrapeInterval;
     }
 
+    /**
+     * Interval between consecutive scrapes.<br><p> <br><p> Default: "30s"
+     */
     @JsonProperty("scrapeInterval")
     public void setScrapeInterval(String scrapeInterval) {
         this.scrapeInterval = scrapeInterval;
     }
 
+    /**
+     * The protocols to negotiate during a scrape. It tells clients the protocols supported by Prometheus in order of preference (from most to least preferred).<br><p> <br><p> If unset, Prometheus uses its default value.<br><p> <br><p> It requires Prometheus &gt;= v2.49.0.<br><p> <br><p> `PrometheusText1.0.0` requires Prometheus &gt;= v3.0.0.
+     */
     @JsonProperty("scrapeProtocols")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getScrapeProtocols() {
         return scrapeProtocols;
     }
 
+    /**
+     * The protocols to negotiate during a scrape. It tells clients the protocols supported by Prometheus in order of preference (from most to least preferred).<br><p> <br><p> If unset, Prometheus uses its default value.<br><p> <br><p> It requires Prometheus &gt;= v2.49.0.<br><p> <br><p> `PrometheusText1.0.0` requires Prometheus &gt;= v3.0.0.
+     */
     @JsonProperty("scrapeProtocols")
     public void setScrapeProtocols(List<String> scrapeProtocols) {
         this.scrapeProtocols = scrapeProtocols;
     }
 
+    /**
+     * Number of seconds to wait until a scrape request times out.
+     */
     @JsonProperty("scrapeTimeout")
     public String getScrapeTimeout() {
         return scrapeTimeout;
     }
 
+    /**
+     * Number of seconds to wait until a scrape request times out.
+     */
     @JsonProperty("scrapeTimeout")
     public void setScrapeTimeout(String scrapeTimeout) {
         this.scrapeTimeout = scrapeTimeout;
     }
 
+    /**
+     * Secrets is a list of Secrets in the same namespace as the Prometheus object, which shall be mounted into the Prometheus Pods. Each Secret is added to the StatefulSet definition as a volume named `secret-&lt;secret-name&gt;`. The Secrets are mounted into /etc/prometheus/secrets/&lt;secret-name&gt; in the 'prometheus' container.
+     */
     @JsonProperty("secrets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSecrets() {
         return secrets;
     }
 
+    /**
+     * Secrets is a list of Secrets in the same namespace as the Prometheus object, which shall be mounted into the Prometheus Pods. Each Secret is added to the StatefulSet definition as a volume named `secret-&lt;secret-name&gt;`. The Secrets are mounted into /etc/prometheus/secrets/&lt;secret-name&gt; in the 'prometheus' container.
+     */
     @JsonProperty("secrets")
     public void setSecrets(List<String> secrets) {
         this.secrets = secrets;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("securityContext")
     public PodSecurityContext getSecurityContext() {
         return securityContext;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("securityContext")
     public void setSecurityContext(PodSecurityContext securityContext) {
         this.securityContext = securityContext;
     }
 
+    /**
+     * ServiceAccountName is the name of the ServiceAccount to use to run the Prometheus Pods.
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * ServiceAccountName is the name of the ServiceAccount to use to run the Prometheus Pods.
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * Defines the service discovery role used to discover targets from `ServiceMonitor` objects and Alertmanager endpoints.<br><p> <br><p> If set, the value should be either "Endpoints" or "EndpointSlice". If unset, the operator assumes the "Endpoints" role.
+     */
     @JsonProperty("serviceDiscoveryRole")
     public String getServiceDiscoveryRole() {
         return serviceDiscoveryRole;
     }
 
+    /**
+     * Defines the service discovery role used to discover targets from `ServiceMonitor` objects and Alertmanager endpoints.<br><p> <br><p> If set, the value should be either "Endpoints" or "EndpointSlice". If unset, the operator assumes the "Endpoints" role.
+     */
     @JsonProperty("serviceDiscoveryRole")
     public void setServiceDiscoveryRole(String serviceDiscoveryRole) {
         this.serviceDiscoveryRole = serviceDiscoveryRole;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("serviceMonitorNamespaceSelector")
     public LabelSelector getServiceMonitorNamespaceSelector() {
         return serviceMonitorNamespaceSelector;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("serviceMonitorNamespaceSelector")
     public void setServiceMonitorNamespaceSelector(LabelSelector serviceMonitorNamespaceSelector) {
         this.serviceMonitorNamespaceSelector = serviceMonitorNamespaceSelector;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("serviceMonitorSelector")
     public LabelSelector getServiceMonitorSelector() {
         return serviceMonitorSelector;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("serviceMonitorSelector")
     public void setServiceMonitorSelector(LabelSelector serviceMonitorSelector) {
         this.serviceMonitorSelector = serviceMonitorSelector;
     }
 
+    /**
+     * Number of shards to distribute scraped targets onto.<br><p> <br><p> `spec.replicas` multiplied by `spec.shards` is the total number of Pods being created.<br><p> <br><p> When not defined, the operator assumes only one shard.<br><p> <br><p> Note that scaling down shards will not reshard data onto the remaining instances, it must be manually moved. Increasing shards will not reshard data either but it will continue to be available from the same instances. To query globally, use Thanos sidecar and Thanos querier or remote write data to a central location. Alerting and recording rules<br><p> <br><p> By default, the sharding is performed on: &#42; The `__address__` target's metadata label for PodMonitor, ServiceMonitor and ScrapeConfig resources. &#42; The `__param_target__` label for Probe resources.<br><p> <br><p> Users can define their own sharding implementation by setting the `__tmp_hash` label during the target discovery with relabeling configuration (either in the monitoring resources or via scrape class).
+     */
     @JsonProperty("shards")
     public Integer getShards() {
         return shards;
     }
 
+    /**
+     * Number of shards to distribute scraped targets onto.<br><p> <br><p> `spec.replicas` multiplied by `spec.shards` is the total number of Pods being created.<br><p> <br><p> When not defined, the operator assumes only one shard.<br><p> <br><p> Note that scaling down shards will not reshard data onto the remaining instances, it must be manually moved. Increasing shards will not reshard data either but it will continue to be available from the same instances. To query globally, use Thanos sidecar and Thanos querier or remote write data to a central location. Alerting and recording rules<br><p> <br><p> By default, the sharding is performed on: &#42; The `__address__` target's metadata label for PodMonitor, ServiceMonitor and ScrapeConfig resources. &#42; The `__param_target__` label for Probe resources.<br><p> <br><p> Users can define their own sharding implementation by setting the `__tmp_hash` label during the target discovery with relabeling configuration (either in the monitoring resources or via scrape class).
+     */
     @JsonProperty("shards")
     public void setShards(Integer shards) {
         this.shards = shards;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("storage")
     public StorageSpec getStorage() {
         return storage;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("storage")
     public void setStorage(StorageSpec storage) {
         this.storage = storage;
     }
 
+    /**
+     * TargetLimit defines a limit on the number of scraped targets that will be accepted. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedTargetLimit.
+     */
     @JsonProperty("targetLimit")
     public Long getTargetLimit() {
         return targetLimit;
     }
 
+    /**
+     * TargetLimit defines a limit on the number of scraped targets that will be accepted. Only valid in Prometheus versions 2.45.0 and newer.<br><p> <br><p> Note that the global limit only applies to scrape objects that don't specify an explicit limit value. If you want to enforce a maximum limit for all scrape objects, refer to enforcedTargetLimit.
+     */
     @JsonProperty("targetLimit")
     public void setTargetLimit(Long targetLimit) {
         this.targetLimit = targetLimit;
     }
 
+    /**
+     * Defines the Pods' tolerations if specified.
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * Defines the Pods' tolerations if specified.
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
     }
 
+    /**
+     * Defines the pod's topology spread constraints if specified.
+     */
     @JsonProperty("topologySpreadConstraints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TopologySpreadConstraint> getTopologySpreadConstraints() {
         return topologySpreadConstraints;
     }
 
+    /**
+     * Defines the pod's topology spread constraints if specified.
+     */
     @JsonProperty("topologySpreadConstraints")
     public void setTopologySpreadConstraints(List<TopologySpreadConstraint> topologySpreadConstraints) {
         this.topologySpreadConstraints = topologySpreadConstraints;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("tracingConfig")
     public PrometheusTracingConfig getTracingConfig() {
         return tracingConfig;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("tracingConfig")
     public void setTracingConfig(PrometheusTracingConfig tracingConfig) {
         this.tracingConfig = tracingConfig;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("tsdb")
     public TSDBSpec getTsdb() {
         return tsdb;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("tsdb")
     public void setTsdb(TSDBSpec tsdb) {
         this.tsdb = tsdb;
     }
 
+    /**
+     * Version of Prometheus being deployed. The operator uses this information to generate the Prometheus StatefulSet + configuration files.<br><p> <br><p> If not specified, the operator assumes the latest upstream version of Prometheus available at the time when the version of the operator was released.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * Version of Prometheus being deployed. The operator uses this information to generate the Prometheus StatefulSet + configuration files.<br><p> <br><p> If not specified, the operator assumes the latest upstream version of Prometheus available at the time when the version of the operator was released.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
     }
 
+    /**
+     * VolumeMounts allows the configuration of additional VolumeMounts.<br><p> <br><p> VolumeMounts will be appended to other VolumeMounts in the 'prometheus' container, that are generated as a result of StorageSpec objects.
+     */
     @JsonProperty("volumeMounts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VolumeMount> getVolumeMounts() {
         return volumeMounts;
     }
 
+    /**
+     * VolumeMounts allows the configuration of additional VolumeMounts.<br><p> <br><p> VolumeMounts will be appended to other VolumeMounts in the 'prometheus' container, that are generated as a result of StorageSpec objects.
+     */
     @JsonProperty("volumeMounts")
     public void setVolumeMounts(List<VolumeMount> volumeMounts) {
         this.volumeMounts = volumeMounts;
     }
 
+    /**
+     * Volumes allows the configuration of additional volumes on the output StatefulSet definition. Volumes specified will be appended to other volumes that are generated as a result of StorageSpec objects.
+     */
     @JsonProperty("volumes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Volume> getVolumes() {
         return volumes;
     }
 
+    /**
+     * Volumes allows the configuration of additional volumes on the output StatefulSet definition. Volumes specified will be appended to other volumes that are generated as a result of StorageSpec objects.
+     */
     @JsonProperty("volumes")
     public void setVolumes(List<Volume> volumes) {
         this.volumes = volumes;
     }
 
+    /**
+     * Configures compression of the write-ahead log (WAL) using Snappy.<br><p> <br><p> WAL compression is enabled by default for Prometheus &gt;= 2.20.0<br><p> <br><p> Requires Prometheus v2.11.0 and above.
+     */
     @JsonProperty("walCompression")
     public Boolean getWalCompression() {
         return walCompression;
     }
 
+    /**
+     * Configures compression of the write-ahead log (WAL) using Snappy.<br><p> <br><p> WAL compression is enabled by default for Prometheus &gt;= 2.20.0<br><p> <br><p> Requires Prometheus v2.11.0 and above.
+     */
     @JsonProperty("walCompression")
     public void setWalCompression(Boolean walCompression) {
         this.walCompression = walCompression;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("web")
     public PrometheusWebSpec getWeb() {
         return web;
     }
 
+    /**
+     * PrometheusAgentSpec is a specification of the desired behavior of the Prometheus agent. More info: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+     */
     @JsonProperty("web")
     public void setWeb(PrometheusWebSpec web) {
         this.web = web;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PuppetDBSDConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PuppetDBSDConfig.java
index 14c5f246ae6..44cdf550786 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PuppetDBSDConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PuppetDBSDConfig.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PuppetDBSDConfig configurations allow retrieving scrape targets from PuppetDB resources. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#puppetdb_sd_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -141,152 +144,242 @@ public PuppetDBSDConfig(SafeAuthorization authorization, BasicAuth basicAuth, Bo
         this.url = url;
     }
 
+    /**
+     * PuppetDBSDConfig configurations allow retrieving scrape targets from PuppetDB resources. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#puppetdb_sd_config
+     */
     @JsonProperty("authorization")
     public SafeAuthorization getAuthorization() {
         return authorization;
     }
 
+    /**
+     * PuppetDBSDConfig configurations allow retrieving scrape targets from PuppetDB resources. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#puppetdb_sd_config
+     */
     @JsonProperty("authorization")
     public void setAuthorization(SafeAuthorization authorization) {
         this.authorization = authorization;
     }
 
+    /**
+     * PuppetDBSDConfig configurations allow retrieving scrape targets from PuppetDB resources. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#puppetdb_sd_config
+     */
     @JsonProperty("basicAuth")
     public BasicAuth getBasicAuth() {
         return basicAuth;
     }
 
+    /**
+     * PuppetDBSDConfig configurations allow retrieving scrape targets from PuppetDB resources. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#puppetdb_sd_config
+     */
     @JsonProperty("basicAuth")
     public void setBasicAuth(BasicAuth basicAuth) {
         this.basicAuth = basicAuth;
     }
 
+    /**
+     * Configure whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public Boolean getEnableHTTP2() {
         return enableHTTP2;
     }
 
+    /**
+     * Configure whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public void setEnableHTTP2(Boolean enableHTTP2) {
         this.enableHTTP2 = enableHTTP2;
     }
 
+    /**
+     * Configure whether the HTTP requests should follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public Boolean getFollowRedirects() {
         return followRedirects;
     }
 
+    /**
+     * Configure whether the HTTP requests should follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public void setFollowRedirects(Boolean followRedirects) {
         this.followRedirects = followRedirects;
     }
 
+    /**
+     * Whether to include the parameters as meta labels. Note: Enabling this exposes parameters in the Prometheus UI and API. Make sure that you don't have secrets exposed as parameters if you enable this.
+     */
     @JsonProperty("includeParameters")
     public Boolean getIncludeParameters() {
         return includeParameters;
     }
 
+    /**
+     * Whether to include the parameters as meta labels. Note: Enabling this exposes parameters in the Prometheus UI and API. Make sure that you don't have secrets exposed as parameters if you enable this.
+     */
     @JsonProperty("includeParameters")
     public void setIncludeParameters(Boolean includeParameters) {
         this.includeParameters = includeParameters;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * PuppetDBSDConfig configurations allow retrieving scrape targets from PuppetDB resources. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#puppetdb_sd_config
+     */
     @JsonProperty("oauth2")
     public OAuth2 getOauth2() {
         return oauth2;
     }
 
+    /**
+     * PuppetDBSDConfig configurations allow retrieving scrape targets from PuppetDB resources. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#puppetdb_sd_config
+     */
     @JsonProperty("oauth2")
     public void setOauth2(OAuth2 oauth2) {
         this.oauth2 = oauth2;
     }
 
+    /**
+     * Port to scrape the metrics from.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * Port to scrape the metrics from.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<SecretKeySelector>> getProxyConnectHeader() {
         return proxyConnectHeader;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     public void setProxyConnectHeader(Map<String, List<SecretKeySelector>> proxyConnectHeader) {
         this.proxyConnectHeader = proxyConnectHeader;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public Boolean getProxyFromEnvironment() {
         return proxyFromEnvironment;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public void setProxyFromEnvironment(Boolean proxyFromEnvironment) {
         this.proxyFromEnvironment = proxyFromEnvironment;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public String getProxyUrl() {
         return proxyUrl;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public void setProxyUrl(String proxyUrl) {
         this.proxyUrl = proxyUrl;
     }
 
+    /**
+     * Puppet Query Language (PQL) query. Only resources are supported. https://puppet.com/docs/puppetdb/latest/api/query/v4/pql.html
+     */
     @JsonProperty("query")
     public String getQuery() {
         return query;
     }
 
+    /**
+     * Puppet Query Language (PQL) query. Only resources are supported. https://puppet.com/docs/puppetdb/latest/api/query/v4/pql.html
+     */
     @JsonProperty("query")
     public void setQuery(String query) {
         this.query = query;
     }
 
+    /**
+     * Refresh interval to re-read the list of resources.
+     */
     @JsonProperty("refreshInterval")
     public String getRefreshInterval() {
         return refreshInterval;
     }
 
+    /**
+     * Refresh interval to re-read the list of resources.
+     */
     @JsonProperty("refreshInterval")
     public void setRefreshInterval(String refreshInterval) {
         this.refreshInterval = refreshInterval;
     }
 
+    /**
+     * PuppetDBSDConfig configurations allow retrieving scrape targets from PuppetDB resources. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#puppetdb_sd_config
+     */
     @JsonProperty("tlsConfig")
     public SafeTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * PuppetDBSDConfig configurations allow retrieving scrape targets from PuppetDB resources. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#puppetdb_sd_config
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(SafeTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * The URL of the PuppetDB root query endpoint.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * The URL of the PuppetDB root query endpoint.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PushoverConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PushoverConfig.java
index abc9376bc8b..3555f5c7e5a 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PushoverConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/PushoverConfig.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PushoverConfig configures notifications via Pushover. See https://prometheus.io/docs/alerting/latest/configuration/#pushover_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -143,171 +146,273 @@ public PushoverConfig(String device, String expire, Boolean html, HTTPConfig htt
         this.userKeyFile = userKeyFile;
     }
 
+    /**
+     * The name of a device to send the notification to
+     */
     @JsonProperty("device")
     public String getDevice() {
         return device;
     }
 
+    /**
+     * The name of a device to send the notification to
+     */
     @JsonProperty("device")
     public void setDevice(String device) {
         this.device = device;
     }
 
+    /**
+     * How long your notification will continue to be retried for, unless the user acknowledges the notification.
+     */
     @JsonProperty("expire")
     public String getExpire() {
         return expire;
     }
 
+    /**
+     * How long your notification will continue to be retried for, unless the user acknowledges the notification.
+     */
     @JsonProperty("expire")
     public void setExpire(String expire) {
         this.expire = expire;
     }
 
+    /**
+     * Whether notification message is HTML or plain text.
+     */
     @JsonProperty("html")
     public Boolean getHtml() {
         return html;
     }
 
+    /**
+     * Whether notification message is HTML or plain text.
+     */
     @JsonProperty("html")
     public void setHtml(Boolean html) {
         this.html = html;
     }
 
+    /**
+     * PushoverConfig configures notifications via Pushover. See https://prometheus.io/docs/alerting/latest/configuration/#pushover_config
+     */
     @JsonProperty("httpConfig")
     public HTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * PushoverConfig configures notifications via Pushover. See https://prometheus.io/docs/alerting/latest/configuration/#pushover_config
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(HTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * Notification message.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Notification message.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Priority, see https://pushover.net/api#priority
+     */
     @JsonProperty("priority")
     public String getPriority() {
         return priority;
     }
 
+    /**
+     * Priority, see https://pushover.net/api#priority
+     */
     @JsonProperty("priority")
     public void setPriority(String priority) {
         this.priority = priority;
     }
 
+    /**
+     * How often the Pushover servers will send the same notification to the user. Must be at least 30 seconds.
+     */
     @JsonProperty("retry")
     public String getRetry() {
         return retry;
     }
 
+    /**
+     * How often the Pushover servers will send the same notification to the user. Must be at least 30 seconds.
+     */
     @JsonProperty("retry")
     public void setRetry(String retry) {
         this.retry = retry;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public Boolean getSendResolved() {
         return sendResolved;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public void setSendResolved(Boolean sendResolved) {
         this.sendResolved = sendResolved;
     }
 
+    /**
+     * The name of one of the sounds supported by device clients to override the user's default sound choice
+     */
     @JsonProperty("sound")
     public String getSound() {
         return sound;
     }
 
+    /**
+     * The name of one of the sounds supported by device clients to override the user's default sound choice
+     */
     @JsonProperty("sound")
     public void setSound(String sound) {
         this.sound = sound;
     }
 
+    /**
+     * Notification title.
+     */
     @JsonProperty("title")
     public String getTitle() {
         return title;
     }
 
+    /**
+     * Notification title.
+     */
     @JsonProperty("title")
     public void setTitle(String title) {
         this.title = title;
     }
 
+    /**
+     * PushoverConfig configures notifications via Pushover. See https://prometheus.io/docs/alerting/latest/configuration/#pushover_config
+     */
     @JsonProperty("token")
     public SecretKeySelector getToken() {
         return token;
     }
 
+    /**
+     * PushoverConfig configures notifications via Pushover. See https://prometheus.io/docs/alerting/latest/configuration/#pushover_config
+     */
     @JsonProperty("token")
     public void setToken(SecretKeySelector token) {
         this.token = token;
     }
 
+    /**
+     * The token file that contains the registered application's API token, see https://pushover.net/apps. Either `token` or `tokenFile` is required. It requires Alertmanager &gt;= v0.26.0.
+     */
     @JsonProperty("tokenFile")
     public String getTokenFile() {
         return tokenFile;
     }
 
+    /**
+     * The token file that contains the registered application's API token, see https://pushover.net/apps. Either `token` or `tokenFile` is required. It requires Alertmanager &gt;= v0.26.0.
+     */
     @JsonProperty("tokenFile")
     public void setTokenFile(String tokenFile) {
         this.tokenFile = tokenFile;
     }
 
+    /**
+     * The time to live definition for the alert notification
+     */
     @JsonProperty("ttl")
     public String getTtl() {
         return ttl;
     }
 
+    /**
+     * The time to live definition for the alert notification
+     */
     @JsonProperty("ttl")
     public void setTtl(String ttl) {
         this.ttl = ttl;
     }
 
+    /**
+     * A supplementary URL shown alongside the message.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * A supplementary URL shown alongside the message.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
     }
 
+    /**
+     * A title for supplementary URL, otherwise just the URL is shown
+     */
     @JsonProperty("urlTitle")
     public String getUrlTitle() {
         return urlTitle;
     }
 
+    /**
+     * A title for supplementary URL, otherwise just the URL is shown
+     */
     @JsonProperty("urlTitle")
     public void setUrlTitle(String urlTitle) {
         this.urlTitle = urlTitle;
     }
 
+    /**
+     * PushoverConfig configures notifications via Pushover. See https://prometheus.io/docs/alerting/latest/configuration/#pushover_config
+     */
     @JsonProperty("userKey")
     public SecretKeySelector getUserKey() {
         return userKey;
     }
 
+    /**
+     * PushoverConfig configures notifications via Pushover. See https://prometheus.io/docs/alerting/latest/configuration/#pushover_config
+     */
     @JsonProperty("userKey")
     public void setUserKey(SecretKeySelector userKey) {
         this.userKey = userKey;
     }
 
+    /**
+     * The user key file that contains the recipient user's user key. Either `userKey` or `userKeyFile` is required. It requires Alertmanager &gt;= v0.26.0.
+     */
     @JsonProperty("userKeyFile")
     public String getUserKeyFile() {
         return userKeyFile;
     }
 
+    /**
+     * The user key file that contains the recipient user's user key. Either `userKey` or `userKeyFile` is required. It requires Alertmanager &gt;= v0.26.0.
+     */
     @JsonProperty("userKeyFile")
     public void setUserKeyFile(String userKeyFile) {
         this.userKeyFile = userKeyFile;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/Receiver.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/Receiver.java
index f1c276a3988..827d1cbc1bd 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/Receiver.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/Receiver.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Receiver defines one or more notification integrations.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -145,154 +148,238 @@ public Receiver(List<DiscordConfig> discordConfigs, List<EmailConfig> emailConfi
         this.wechatConfigs = wechatConfigs;
     }
 
+    /**
+     * List of Discord configurations.
+     */
     @JsonProperty("discordConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DiscordConfig> getDiscordConfigs() {
         return discordConfigs;
     }
 
+    /**
+     * List of Discord configurations.
+     */
     @JsonProperty("discordConfigs")
     public void setDiscordConfigs(List<DiscordConfig> discordConfigs) {
         this.discordConfigs = discordConfigs;
     }
 
+    /**
+     * List of Email configurations.
+     */
     @JsonProperty("emailConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EmailConfig> getEmailConfigs() {
         return emailConfigs;
     }
 
+    /**
+     * List of Email configurations.
+     */
     @JsonProperty("emailConfigs")
     public void setEmailConfigs(List<EmailConfig> emailConfigs) {
         this.emailConfigs = emailConfigs;
     }
 
+    /**
+     * List of MSTeams configurations. It requires Alertmanager &gt;= 0.26.0.
+     */
     @JsonProperty("msteamsConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MSTeamsConfig> getMsteamsConfigs() {
         return msteamsConfigs;
     }
 
+    /**
+     * List of MSTeams configurations. It requires Alertmanager &gt;= 0.26.0.
+     */
     @JsonProperty("msteamsConfigs")
     public void setMsteamsConfigs(List<MSTeamsConfig> msteamsConfigs) {
         this.msteamsConfigs = msteamsConfigs;
     }
 
+    /**
+     * Name of the receiver. Must be unique across all items from the list.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the receiver. Must be unique across all items from the list.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * List of OpsGenie configurations.
+     */
     @JsonProperty("opsgenieConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OpsGenieConfig> getOpsgenieConfigs() {
         return opsgenieConfigs;
     }
 
+    /**
+     * List of OpsGenie configurations.
+     */
     @JsonProperty("opsgenieConfigs")
     public void setOpsgenieConfigs(List<OpsGenieConfig> opsgenieConfigs) {
         this.opsgenieConfigs = opsgenieConfigs;
     }
 
+    /**
+     * List of PagerDuty configurations.
+     */
     @JsonProperty("pagerdutyConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PagerDutyConfig> getPagerdutyConfigs() {
         return pagerdutyConfigs;
     }
 
+    /**
+     * List of PagerDuty configurations.
+     */
     @JsonProperty("pagerdutyConfigs")
     public void setPagerdutyConfigs(List<PagerDutyConfig> pagerdutyConfigs) {
         this.pagerdutyConfigs = pagerdutyConfigs;
     }
 
+    /**
+     * List of Pushover configurations.
+     */
     @JsonProperty("pushoverConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PushoverConfig> getPushoverConfigs() {
         return pushoverConfigs;
     }
 
+    /**
+     * List of Pushover configurations.
+     */
     @JsonProperty("pushoverConfigs")
     public void setPushoverConfigs(List<PushoverConfig> pushoverConfigs) {
         this.pushoverConfigs = pushoverConfigs;
     }
 
+    /**
+     * List of Slack configurations.
+     */
     @JsonProperty("slackConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SlackConfig> getSlackConfigs() {
         return slackConfigs;
     }
 
+    /**
+     * List of Slack configurations.
+     */
     @JsonProperty("slackConfigs")
     public void setSlackConfigs(List<SlackConfig> slackConfigs) {
         this.slackConfigs = slackConfigs;
     }
 
+    /**
+     * List of SNS configurations
+     */
     @JsonProperty("snsConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SNSConfig> getSnsConfigs() {
         return snsConfigs;
     }
 
+    /**
+     * List of SNS configurations
+     */
     @JsonProperty("snsConfigs")
     public void setSnsConfigs(List<SNSConfig> snsConfigs) {
         this.snsConfigs = snsConfigs;
     }
 
+    /**
+     * List of Telegram configurations.
+     */
     @JsonProperty("telegramConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TelegramConfig> getTelegramConfigs() {
         return telegramConfigs;
     }
 
+    /**
+     * List of Telegram configurations.
+     */
     @JsonProperty("telegramConfigs")
     public void setTelegramConfigs(List<TelegramConfig> telegramConfigs) {
         this.telegramConfigs = telegramConfigs;
     }
 
+    /**
+     * List of VictorOps configurations.
+     */
     @JsonProperty("victoropsConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VictorOpsConfig> getVictoropsConfigs() {
         return victoropsConfigs;
     }
 
+    /**
+     * List of VictorOps configurations.
+     */
     @JsonProperty("victoropsConfigs")
     public void setVictoropsConfigs(List<VictorOpsConfig> victoropsConfigs) {
         this.victoropsConfigs = victoropsConfigs;
     }
 
+    /**
+     * List of Webex configurations.
+     */
     @JsonProperty("webexConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WebexConfig> getWebexConfigs() {
         return webexConfigs;
     }
 
+    /**
+     * List of Webex configurations.
+     */
     @JsonProperty("webexConfigs")
     public void setWebexConfigs(List<WebexConfig> webexConfigs) {
         this.webexConfigs = webexConfigs;
     }
 
+    /**
+     * List of webhook configurations.
+     */
     @JsonProperty("webhookConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WebhookConfig> getWebhookConfigs() {
         return webhookConfigs;
     }
 
+    /**
+     * List of webhook configurations.
+     */
     @JsonProperty("webhookConfigs")
     public void setWebhookConfigs(List<WebhookConfig> webhookConfigs) {
         this.webhookConfigs = webhookConfigs;
     }
 
+    /**
+     * List of WeChat configurations.
+     */
     @JsonProperty("wechatConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WeChatConfig> getWechatConfigs() {
         return wechatConfigs;
     }
 
+    /**
+     * List of WeChat configurations.
+     */
     @JsonProperty("wechatConfigs")
     public void setWechatConfigs(List<WeChatConfig> wechatConfigs) {
         this.wechatConfigs = wechatConfigs;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/Route.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/Route.java
index cf130f974e0..4949d0b6282 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/Route.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/Route.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Route defines a node in the routing tree.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -122,106 +125,166 @@ public Route(List<String> activeTimeIntervals, Boolean _continue, List<String> g
         this.routes = routes;
     }
 
+    /**
+     * ActiveTimeIntervals is a list of MuteTimeInterval names when this route should be active.
+     */
     @JsonProperty("activeTimeIntervals")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getActiveTimeIntervals() {
         return activeTimeIntervals;
     }
 
+    /**
+     * ActiveTimeIntervals is a list of MuteTimeInterval names when this route should be active.
+     */
     @JsonProperty("activeTimeIntervals")
     public void setActiveTimeIntervals(List<String> activeTimeIntervals) {
         this.activeTimeIntervals = activeTimeIntervals;
     }
 
+    /**
+     * Boolean indicating whether an alert should continue matching subsequent sibling nodes. It will always be overridden to true for the first-level route by the Prometheus operator.
+     */
     @JsonProperty("continue")
     public Boolean getContinue() {
         return _continue;
     }
 
+    /**
+     * Boolean indicating whether an alert should continue matching subsequent sibling nodes. It will always be overridden to true for the first-level route by the Prometheus operator.
+     */
     @JsonProperty("continue")
     public void setContinue(Boolean _continue) {
         this._continue = _continue;
     }
 
+    /**
+     * List of labels to group by. Labels must not be repeated (unique list). Special label "..." (aggregate by all possible labels), if provided, must be the only element in the list.
+     */
     @JsonProperty("groupBy")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getGroupBy() {
         return groupBy;
     }
 
+    /**
+     * List of labels to group by. Labels must not be repeated (unique list). Special label "..." (aggregate by all possible labels), if provided, must be the only element in the list.
+     */
     @JsonProperty("groupBy")
     public void setGroupBy(List<String> groupBy) {
         this.groupBy = groupBy;
     }
 
+    /**
+     * How long to wait before sending an updated notification. Must match the regular expression`^(([0-9]+)y)?(([0-9]+)w)?(([0-9]+)d)?(([0-9]+)h)?(([0-9]+)m)?(([0-9]+)s)?(([0-9]+)ms)?$` Example: "5m"
+     */
     @JsonProperty("groupInterval")
     public String getGroupInterval() {
         return groupInterval;
     }
 
+    /**
+     * How long to wait before sending an updated notification. Must match the regular expression`^(([0-9]+)y)?(([0-9]+)w)?(([0-9]+)d)?(([0-9]+)h)?(([0-9]+)m)?(([0-9]+)s)?(([0-9]+)ms)?$` Example: "5m"
+     */
     @JsonProperty("groupInterval")
     public void setGroupInterval(String groupInterval) {
         this.groupInterval = groupInterval;
     }
 
+    /**
+     * How long to wait before sending the initial notification. Must match the regular expression`^(([0-9]+)y)?(([0-9]+)w)?(([0-9]+)d)?(([0-9]+)h)?(([0-9]+)m)?(([0-9]+)s)?(([0-9]+)ms)?$` Example: "30s"
+     */
     @JsonProperty("groupWait")
     public String getGroupWait() {
         return groupWait;
     }
 
+    /**
+     * How long to wait before sending the initial notification. Must match the regular expression`^(([0-9]+)y)?(([0-9]+)w)?(([0-9]+)d)?(([0-9]+)h)?(([0-9]+)m)?(([0-9]+)s)?(([0-9]+)ms)?$` Example: "30s"
+     */
     @JsonProperty("groupWait")
     public void setGroupWait(String groupWait) {
         this.groupWait = groupWait;
     }
 
+    /**
+     * List of matchers that the alert's labels should match. For the first level route, the operator removes any existing equality and regexp matcher on the `namespace` label and adds a `namespace: &lt;object namespace&gt;` matcher.
+     */
     @JsonProperty("matchers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Matcher> getMatchers() {
         return matchers;
     }
 
+    /**
+     * List of matchers that the alert's labels should match. For the first level route, the operator removes any existing equality and regexp matcher on the `namespace` label and adds a `namespace: &lt;object namespace&gt;` matcher.
+     */
     @JsonProperty("matchers")
     public void setMatchers(List<Matcher> matchers) {
         this.matchers = matchers;
     }
 
+    /**
+     * Note: this comment applies to the field definition above but appears below otherwise it gets included in the generated manifest. CRD schema doesn't support self-referential types for now (see https://github.com/kubernetes/kubernetes/issues/62872). We have to use an alternative type to circumvent the limitation. The downside is that the Kube API can't validate the data beyond the fact that it is a valid JSON representation. MuteTimeIntervals is a list of MuteTimeInterval names that will mute this route when matched,
+     */
     @JsonProperty("muteTimeIntervals")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMuteTimeIntervals() {
         return muteTimeIntervals;
     }
 
+    /**
+     * Note: this comment applies to the field definition above but appears below otherwise it gets included in the generated manifest. CRD schema doesn't support self-referential types for now (see https://github.com/kubernetes/kubernetes/issues/62872). We have to use an alternative type to circumvent the limitation. The downside is that the Kube API can't validate the data beyond the fact that it is a valid JSON representation. MuteTimeIntervals is a list of MuteTimeInterval names that will mute this route when matched,
+     */
     @JsonProperty("muteTimeIntervals")
     public void setMuteTimeIntervals(List<String> muteTimeIntervals) {
         this.muteTimeIntervals = muteTimeIntervals;
     }
 
+    /**
+     * Name of the receiver for this route. If not empty, it should be listed in the `receivers` field.
+     */
     @JsonProperty("receiver")
     public String getReceiver() {
         return receiver;
     }
 
+    /**
+     * Name of the receiver for this route. If not empty, it should be listed in the `receivers` field.
+     */
     @JsonProperty("receiver")
     public void setReceiver(String receiver) {
         this.receiver = receiver;
     }
 
+    /**
+     * How long to wait before repeating the last notification. Must match the regular expression`^(([0-9]+)y)?(([0-9]+)w)?(([0-9]+)d)?(([0-9]+)h)?(([0-9]+)m)?(([0-9]+)s)?(([0-9]+)ms)?$` Example: "4h"
+     */
     @JsonProperty("repeatInterval")
     public String getRepeatInterval() {
         return repeatInterval;
     }
 
+    /**
+     * How long to wait before repeating the last notification. Must match the regular expression`^(([0-9]+)y)?(([0-9]+)w)?(([0-9]+)d)?(([0-9]+)h)?(([0-9]+)m)?(([0-9]+)s)?(([0-9]+)ms)?$` Example: "4h"
+     */
     @JsonProperty("repeatInterval")
     public void setRepeatInterval(String repeatInterval) {
         this.repeatInterval = repeatInterval;
     }
 
+    /**
+     * Child routes.
+     */
     @JsonProperty("routes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<JsonNode> getRoutes() {
         return routes;
     }
 
+    /**
+     * Child routes.
+     */
     @JsonProperty("routes")
     public void setRoutes(List<JsonNode> routes) {
         this.routes = routes;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/SNSConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/SNSConfig.java
index ffcb47134e8..1e7ada6b64e 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/SNSConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/SNSConfig.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SNSConfig configures notifications via AWS SNS. See https://prometheus.io/docs/alerting/latest/configuration/#sns_configs
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -116,102 +119,162 @@ public SNSConfig(String apiURL, Map<String, String> attributes, HTTPConfig httpC
         this.topicARN = topicARN;
     }
 
+    /**
+     * The SNS API URL i.e. https://sns.us-east-2.amazonaws.com. If not specified, the SNS API URL from the SNS SDK will be used.
+     */
     @JsonProperty("apiURL")
     public String getApiURL() {
         return apiURL;
     }
 
+    /**
+     * The SNS API URL i.e. https://sns.us-east-2.amazonaws.com. If not specified, the SNS API URL from the SNS SDK will be used.
+     */
     @JsonProperty("apiURL")
     public void setApiURL(String apiURL) {
         this.apiURL = apiURL;
     }
 
+    /**
+     * SNS message attributes.
+     */
     @JsonProperty("attributes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAttributes() {
         return attributes;
     }
 
+    /**
+     * SNS message attributes.
+     */
     @JsonProperty("attributes")
     public void setAttributes(Map<String, String> attributes) {
         this.attributes = attributes;
     }
 
+    /**
+     * SNSConfig configures notifications via AWS SNS. See https://prometheus.io/docs/alerting/latest/configuration/#sns_configs
+     */
     @JsonProperty("httpConfig")
     public HTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * SNSConfig configures notifications via AWS SNS. See https://prometheus.io/docs/alerting/latest/configuration/#sns_configs
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(HTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * The message content of the SNS notification.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * The message content of the SNS notification.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Phone number if message is delivered via SMS in E.164 format. If you don't specify this value, you must specify a value for the TopicARN or TargetARN.
+     */
     @JsonProperty("phoneNumber")
     public String getPhoneNumber() {
         return phoneNumber;
     }
 
+    /**
+     * Phone number if message is delivered via SMS in E.164 format. If you don't specify this value, you must specify a value for the TopicARN or TargetARN.
+     */
     @JsonProperty("phoneNumber")
     public void setPhoneNumber(String phoneNumber) {
         this.phoneNumber = phoneNumber;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public Boolean getSendResolved() {
         return sendResolved;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public void setSendResolved(Boolean sendResolved) {
         this.sendResolved = sendResolved;
     }
 
+    /**
+     * SNSConfig configures notifications via AWS SNS. See https://prometheus.io/docs/alerting/latest/configuration/#sns_configs
+     */
     @JsonProperty("sigv4")
     public Sigv4 getSigv4() {
         return sigv4;
     }
 
+    /**
+     * SNSConfig configures notifications via AWS SNS. See https://prometheus.io/docs/alerting/latest/configuration/#sns_configs
+     */
     @JsonProperty("sigv4")
     public void setSigv4(Sigv4 sigv4) {
         this.sigv4 = sigv4;
     }
 
+    /**
+     * Subject line when the message is delivered to email endpoints.
+     */
     @JsonProperty("subject")
     public String getSubject() {
         return subject;
     }
 
+    /**
+     * Subject line when the message is delivered to email endpoints.
+     */
     @JsonProperty("subject")
     public void setSubject(String subject) {
         this.subject = subject;
     }
 
+    /**
+     * The  mobile platform endpoint ARN if message is delivered via mobile notifications. If you don't specify this value, you must specify a value for the topic_arn or PhoneNumber.
+     */
     @JsonProperty("targetARN")
     public String getTargetARN() {
         return targetARN;
     }
 
+    /**
+     * The  mobile platform endpoint ARN if message is delivered via mobile notifications. If you don't specify this value, you must specify a value for the topic_arn or PhoneNumber.
+     */
     @JsonProperty("targetARN")
     public void setTargetARN(String targetARN) {
         this.targetARN = targetARN;
     }
 
+    /**
+     * SNS topic ARN, i.e. arn:aws:sns:us-east-2:698519295917:My-Topic If you don't specify this value, you must specify a value for the PhoneNumber or TargetARN.
+     */
     @JsonProperty("topicARN")
     public String getTopicARN() {
         return topicARN;
     }
 
+    /**
+     * SNS topic ARN, i.e. arn:aws:sns:us-east-2:698519295917:My-Topic If you don't specify this value, you must specify a value for the PhoneNumber or TargetARN.
+     */
     @JsonProperty("topicARN")
     public void setTopicARN(String topicARN) {
         this.topicARN = topicARN;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/ScalewaySDConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/ScalewaySDConfig.java
index dc217ad7580..e4783d6793a 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/ScalewaySDConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/ScalewaySDConfig.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ScalewaySDConfig configurations allow retrieving scrape targets from Scaleway instances and baremetal services. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#scaleway_sd_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -148,173 +151,275 @@ public ScalewaySDConfig(String accessKey, String apiURL, Boolean enableHTTP2, Bo
         this.zone = zone;
     }
 
+    /**
+     * Access key to use. https://console.scaleway.com/project/credentials
+     */
     @JsonProperty("accessKey")
     public String getAccessKey() {
         return accessKey;
     }
 
+    /**
+     * Access key to use. https://console.scaleway.com/project/credentials
+     */
     @JsonProperty("accessKey")
     public void setAccessKey(String accessKey) {
         this.accessKey = accessKey;
     }
 
+    /**
+     * API URL to use when doing the server listing requests.
+     */
     @JsonProperty("apiURL")
     public String getApiURL() {
         return apiURL;
     }
 
+    /**
+     * API URL to use when doing the server listing requests.
+     */
     @JsonProperty("apiURL")
     public void setApiURL(String apiURL) {
         this.apiURL = apiURL;
     }
 
+    /**
+     * Whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public Boolean getEnableHTTP2() {
         return enableHTTP2;
     }
 
+    /**
+     * Whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public void setEnableHTTP2(Boolean enableHTTP2) {
         this.enableHTTP2 = enableHTTP2;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public Boolean getFollowRedirects() {
         return followRedirects;
     }
 
+    /**
+     * Configure whether HTTP requests follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public void setFollowRedirects(Boolean followRedirects) {
         this.followRedirects = followRedirects;
     }
 
+    /**
+     * NameFilter specify a name filter (works as a LIKE) to apply on the server listing request.
+     */
     @JsonProperty("nameFilter")
     public String getNameFilter() {
         return nameFilter;
     }
 
+    /**
+     * NameFilter specify a name filter (works as a LIKE) to apply on the server listing request.
+     */
     @JsonProperty("nameFilter")
     public void setNameFilter(String nameFilter) {
         this.nameFilter = nameFilter;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * The port to scrape metrics from.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * The port to scrape metrics from.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * Project ID of the targets.
+     */
     @JsonProperty("projectID")
     public String getProjectID() {
         return projectID;
     }
 
+    /**
+     * Project ID of the targets.
+     */
     @JsonProperty("projectID")
     public void setProjectID(String projectID) {
         this.projectID = projectID;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<SecretKeySelector>> getProxyConnectHeader() {
         return proxyConnectHeader;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     public void setProxyConnectHeader(Map<String, List<SecretKeySelector>> proxyConnectHeader) {
         this.proxyConnectHeader = proxyConnectHeader;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public Boolean getProxyFromEnvironment() {
         return proxyFromEnvironment;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public void setProxyFromEnvironment(Boolean proxyFromEnvironment) {
         this.proxyFromEnvironment = proxyFromEnvironment;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public String getProxyUrl() {
         return proxyUrl;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public void setProxyUrl(String proxyUrl) {
         this.proxyUrl = proxyUrl;
     }
 
+    /**
+     * Refresh interval to re-read the list of instances.
+     */
     @JsonProperty("refreshInterval")
     public String getRefreshInterval() {
         return refreshInterval;
     }
 
+    /**
+     * Refresh interval to re-read the list of instances.
+     */
     @JsonProperty("refreshInterval")
     public void setRefreshInterval(String refreshInterval) {
         this.refreshInterval = refreshInterval;
     }
 
+    /**
+     * Service of the targets to retrieve. Must be `Instance` or `Baremetal`.
+     */
     @JsonProperty("role")
     public String getRole() {
         return role;
     }
 
+    /**
+     * Service of the targets to retrieve. Must be `Instance` or `Baremetal`.
+     */
     @JsonProperty("role")
     public void setRole(String role) {
         this.role = role;
     }
 
+    /**
+     * ScalewaySDConfig configurations allow retrieving scrape targets from Scaleway instances and baremetal services. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#scaleway_sd_config
+     */
     @JsonProperty("secretKey")
     public SecretKeySelector getSecretKey() {
         return secretKey;
     }
 
+    /**
+     * ScalewaySDConfig configurations allow retrieving scrape targets from Scaleway instances and baremetal services. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#scaleway_sd_config
+     */
     @JsonProperty("secretKey")
     public void setSecretKey(SecretKeySelector secretKey) {
         this.secretKey = secretKey;
     }
 
+    /**
+     * TagsFilter specify a tag filter (a server needs to have all defined tags to be listed) to apply on the server listing request.
+     */
     @JsonProperty("tagsFilter")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getTagsFilter() {
         return tagsFilter;
     }
 
+    /**
+     * TagsFilter specify a tag filter (a server needs to have all defined tags to be listed) to apply on the server listing request.
+     */
     @JsonProperty("tagsFilter")
     public void setTagsFilter(List<String> tagsFilter) {
         this.tagsFilter = tagsFilter;
     }
 
+    /**
+     * ScalewaySDConfig configurations allow retrieving scrape targets from Scaleway instances and baremetal services. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#scaleway_sd_config
+     */
     @JsonProperty("tlsConfig")
     public SafeTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * ScalewaySDConfig configurations allow retrieving scrape targets from Scaleway instances and baremetal services. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#scaleway_sd_config
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(SafeTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * Zone is the availability zone of your targets (e.g. fr-par-1).
+     */
     @JsonProperty("zone")
     public String getZone() {
         return zone;
     }
 
+    /**
+     * Zone is the availability zone of your targets (e.g. fr-par-1).
+     */
     @JsonProperty("zone")
     public void setZone(String zone) {
         this.zone = zone;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/ScrapeConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/ScrapeConfig.java
index 4b62b197bfa..71cabdd33b4 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/ScrapeConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/ScrapeConfig.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ScrapeConfig defines a namespaced Prometheus scrape_config to be aggregated across multiple namespaces into the Prometheus configuration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ScrapeConfig implements Editable<ScrapeConfigBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "monitoring.coreos.com/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ScrapeConfig";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public ScrapeConfig(String apiVersion, String kind, ObjectMeta metadata, ScrapeC
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ScrapeConfig defines a namespaced Prometheus scrape_config to be aggregated across multiple namespaces into the Prometheus configuration.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ScrapeConfig defines a namespaced Prometheus scrape_config to be aggregated across multiple namespaces into the Prometheus configuration.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ScrapeConfig defines a namespaced Prometheus scrape_config to be aggregated across multiple namespaces into the Prometheus configuration.
+     */
     @JsonProperty("spec")
     public ScrapeConfigSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ScrapeConfig defines a namespaced Prometheus scrape_config to be aggregated across multiple namespaces into the Prometheus configuration.
+     */
     @JsonProperty("spec")
     public void setSpec(ScrapeConfigSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/ScrapeConfigList.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/ScrapeConfigList.java
index 646e1e4a38b..0bff2966c6a 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/ScrapeConfigList.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/ScrapeConfigList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ScrapeConfigList is a list of ScrapeConfigs.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ScrapeConfigList implements Editable<ScrapeConfigListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.monitoring.v1alpha1.ScrapeConfig>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "monitoring.coreos.com/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.monitoring.v1alpha1.ScrapeConfig> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ScrapeConfigList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ScrapeConfigList(String apiVersion, List<io.fabric8.openshift.api.model.m
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of ScrapeConfigs
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.monitoring.v1alpha1.ScrapeConfig> getItems() {
         return items;
     }
 
+    /**
+     * List of ScrapeConfigs
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.monitoring.v1alpha1.ScrapeConfig> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ScrapeConfigList is a list of ScrapeConfigs.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ScrapeConfigList is a list of ScrapeConfigs.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/ScrapeConfigSpec.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/ScrapeConfigSpec.java
index 9b9e29d349c..a4e86048c50 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/ScrapeConfigSpec.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/ScrapeConfigSpec.java
@@ -41,6 +41,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ScrapeConfigSpec is a specification of the desired configuration for a scrape configuration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -335,589 +338,925 @@ public ScrapeConfigSpec(SafeAuthorization authorization, List<AzureSDConfig> azu
         this.trackTimestampsStaleness = trackTimestampsStaleness;
     }
 
+    /**
+     * ScrapeConfigSpec is a specification of the desired configuration for a scrape configuration.
+     */
     @JsonProperty("authorization")
     public SafeAuthorization getAuthorization() {
         return authorization;
     }
 
+    /**
+     * ScrapeConfigSpec is a specification of the desired configuration for a scrape configuration.
+     */
     @JsonProperty("authorization")
     public void setAuthorization(SafeAuthorization authorization) {
         this.authorization = authorization;
     }
 
+    /**
+     * AzureSDConfigs defines a list of Azure service discovery configurations.
+     */
     @JsonProperty("azureSDConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AzureSDConfig> getAzureSDConfigs() {
         return azureSDConfigs;
     }
 
+    /**
+     * AzureSDConfigs defines a list of Azure service discovery configurations.
+     */
     @JsonProperty("azureSDConfigs")
     public void setAzureSDConfigs(List<AzureSDConfig> azureSDConfigs) {
         this.azureSDConfigs = azureSDConfigs;
     }
 
+    /**
+     * ScrapeConfigSpec is a specification of the desired configuration for a scrape configuration.
+     */
     @JsonProperty("basicAuth")
     public BasicAuth getBasicAuth() {
         return basicAuth;
     }
 
+    /**
+     * ScrapeConfigSpec is a specification of the desired configuration for a scrape configuration.
+     */
     @JsonProperty("basicAuth")
     public void setBasicAuth(BasicAuth basicAuth) {
         this.basicAuth = basicAuth;
     }
 
+    /**
+     * ConsulSDConfigs defines a list of Consul service discovery configurations.
+     */
     @JsonProperty("consulSDConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ConsulSDConfig> getConsulSDConfigs() {
         return consulSDConfigs;
     }
 
+    /**
+     * ConsulSDConfigs defines a list of Consul service discovery configurations.
+     */
     @JsonProperty("consulSDConfigs")
     public void setConsulSDConfigs(List<ConsulSDConfig> consulSDConfigs) {
         this.consulSDConfigs = consulSDConfigs;
     }
 
+    /**
+     * DigitalOceanSDConfigs defines a list of DigitalOcean service discovery configurations.
+     */
     @JsonProperty("digitalOceanSDConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DigitalOceanSDConfig> getDigitalOceanSDConfigs() {
         return digitalOceanSDConfigs;
     }
 
+    /**
+     * DigitalOceanSDConfigs defines a list of DigitalOcean service discovery configurations.
+     */
     @JsonProperty("digitalOceanSDConfigs")
     public void setDigitalOceanSDConfigs(List<DigitalOceanSDConfig> digitalOceanSDConfigs) {
         this.digitalOceanSDConfigs = digitalOceanSDConfigs;
     }
 
+    /**
+     * DNSSDConfigs defines a list of DNS service discovery configurations.
+     */
     @JsonProperty("dnsSDConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DNSSDConfig> getDnsSDConfigs() {
         return dnsSDConfigs;
     }
 
+    /**
+     * DNSSDConfigs defines a list of DNS service discovery configurations.
+     */
     @JsonProperty("dnsSDConfigs")
     public void setDnsSDConfigs(List<DNSSDConfig> dnsSDConfigs) {
         this.dnsSDConfigs = dnsSDConfigs;
     }
 
+    /**
+     * DockerSDConfigs defines a list of Docker service discovery configurations.
+     */
     @JsonProperty("dockerSDConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DockerSDConfig> getDockerSDConfigs() {
         return dockerSDConfigs;
     }
 
+    /**
+     * DockerSDConfigs defines a list of Docker service discovery configurations.
+     */
     @JsonProperty("dockerSDConfigs")
     public void setDockerSDConfigs(List<DockerSDConfig> dockerSDConfigs) {
         this.dockerSDConfigs = dockerSDConfigs;
     }
 
+    /**
+     * DockerswarmSDConfigs defines a list of Dockerswarm service discovery configurations.
+     */
     @JsonProperty("dockerSwarmSDConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DockerSwarmSDConfig> getDockerSwarmSDConfigs() {
         return dockerSwarmSDConfigs;
     }
 
+    /**
+     * DockerswarmSDConfigs defines a list of Dockerswarm service discovery configurations.
+     */
     @JsonProperty("dockerSwarmSDConfigs")
     public void setDockerSwarmSDConfigs(List<DockerSwarmSDConfig> dockerSwarmSDConfigs) {
         this.dockerSwarmSDConfigs = dockerSwarmSDConfigs;
     }
 
+    /**
+     * EC2SDConfigs defines a list of EC2 service discovery configurations.
+     */
     @JsonProperty("ec2SDConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EC2SDConfig> getEc2SDConfigs() {
         return ec2SDConfigs;
     }
 
+    /**
+     * EC2SDConfigs defines a list of EC2 service discovery configurations.
+     */
     @JsonProperty("ec2SDConfigs")
     public void setEc2SDConfigs(List<EC2SDConfig> ec2SDConfigs) {
         this.ec2SDConfigs = ec2SDConfigs;
     }
 
+    /**
+     * When false, Prometheus will request uncompressed response from the scraped target.<br><p> <br><p> It requires Prometheus &gt;= v2.49.0.<br><p> <br><p> If unset, Prometheus uses true by default.
+     */
     @JsonProperty("enableCompression")
     public Boolean getEnableCompression() {
         return enableCompression;
     }
 
+    /**
+     * When false, Prometheus will request uncompressed response from the scraped target.<br><p> <br><p> It requires Prometheus &gt;= v2.49.0.<br><p> <br><p> If unset, Prometheus uses true by default.
+     */
     @JsonProperty("enableCompression")
     public void setEnableCompression(Boolean enableCompression) {
         this.enableCompression = enableCompression;
     }
 
+    /**
+     * Whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public Boolean getEnableHTTP2() {
         return enableHTTP2;
     }
 
+    /**
+     * Whether to enable HTTP2.
+     */
     @JsonProperty("enableHTTP2")
     public void setEnableHTTP2(Boolean enableHTTP2) {
         this.enableHTTP2 = enableHTTP2;
     }
 
+    /**
+     * EurekaSDConfigs defines a list of Eureka service discovery configurations.
+     */
     @JsonProperty("eurekaSDConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EurekaSDConfig> getEurekaSDConfigs() {
         return eurekaSDConfigs;
     }
 
+    /**
+     * EurekaSDConfigs defines a list of Eureka service discovery configurations.
+     */
     @JsonProperty("eurekaSDConfigs")
     public void setEurekaSDConfigs(List<EurekaSDConfig> eurekaSDConfigs) {
         this.eurekaSDConfigs = eurekaSDConfigs;
     }
 
+    /**
+     * The protocol to use if a scrape returns blank, unparseable, or otherwise invalid Content-Type.<br><p> <br><p> It requires Prometheus &gt;= v3.0.0.
+     */
     @JsonProperty("fallbackScrapeProtocol")
     public String getFallbackScrapeProtocol() {
         return fallbackScrapeProtocol;
     }
 
+    /**
+     * The protocol to use if a scrape returns blank, unparseable, or otherwise invalid Content-Type.<br><p> <br><p> It requires Prometheus &gt;= v3.0.0.
+     */
     @JsonProperty("fallbackScrapeProtocol")
     public void setFallbackScrapeProtocol(String fallbackScrapeProtocol) {
         this.fallbackScrapeProtocol = fallbackScrapeProtocol;
     }
 
+    /**
+     * FileSDConfigs defines a list of file service discovery configurations.
+     */
     @JsonProperty("fileSDConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<FileSDConfig> getFileSDConfigs() {
         return fileSDConfigs;
     }
 
+    /**
+     * FileSDConfigs defines a list of file service discovery configurations.
+     */
     @JsonProperty("fileSDConfigs")
     public void setFileSDConfigs(List<FileSDConfig> fileSDConfigs) {
         this.fileSDConfigs = fileSDConfigs;
     }
 
+    /**
+     * GCESDConfigs defines a list of GCE service discovery configurations.
+     */
     @JsonProperty("gceSDConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GCESDConfig> getGceSDConfigs() {
         return gceSDConfigs;
     }
 
+    /**
+     * GCESDConfigs defines a list of GCE service discovery configurations.
+     */
     @JsonProperty("gceSDConfigs")
     public void setGceSDConfigs(List<GCESDConfig> gceSDConfigs) {
         this.gceSDConfigs = gceSDConfigs;
     }
 
+    /**
+     * HetznerSDConfigs defines a list of Hetzner service discovery configurations.
+     */
     @JsonProperty("hetznerSDConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HetznerSDConfig> getHetznerSDConfigs() {
         return hetznerSDConfigs;
     }
 
+    /**
+     * HetznerSDConfigs defines a list of Hetzner service discovery configurations.
+     */
     @JsonProperty("hetznerSDConfigs")
     public void setHetznerSDConfigs(List<HetznerSDConfig> hetznerSDConfigs) {
         this.hetznerSDConfigs = hetznerSDConfigs;
     }
 
+    /**
+     * HonorLabels chooses the metric's labels on collisions with target labels.
+     */
     @JsonProperty("honorLabels")
     public Boolean getHonorLabels() {
         return honorLabels;
     }
 
+    /**
+     * HonorLabels chooses the metric's labels on collisions with target labels.
+     */
     @JsonProperty("honorLabels")
     public void setHonorLabels(Boolean honorLabels) {
         this.honorLabels = honorLabels;
     }
 
+    /**
+     * HonorTimestamps controls whether Prometheus respects the timestamps present in scraped data.
+     */
     @JsonProperty("honorTimestamps")
     public Boolean getHonorTimestamps() {
         return honorTimestamps;
     }
 
+    /**
+     * HonorTimestamps controls whether Prometheus respects the timestamps present in scraped data.
+     */
     @JsonProperty("honorTimestamps")
     public void setHonorTimestamps(Boolean honorTimestamps) {
         this.honorTimestamps = honorTimestamps;
     }
 
+    /**
+     * HTTPSDConfigs defines a list of HTTP service discovery configurations.
+     */
     @JsonProperty("httpSDConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HTTPSDConfig> getHttpSDConfigs() {
         return httpSDConfigs;
     }
 
+    /**
+     * HTTPSDConfigs defines a list of HTTP service discovery configurations.
+     */
     @JsonProperty("httpSDConfigs")
     public void setHttpSDConfigs(List<HTTPSDConfig> httpSDConfigs) {
         this.httpSDConfigs = httpSDConfigs;
     }
 
+    /**
+     * IonosSDConfigs defines a list of IONOS service discovery configurations.
+     */
     @JsonProperty("ionosSDConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IonosSDConfig> getIonosSDConfigs() {
         return ionosSDConfigs;
     }
 
+    /**
+     * IonosSDConfigs defines a list of IONOS service discovery configurations.
+     */
     @JsonProperty("ionosSDConfigs")
     public void setIonosSDConfigs(List<IonosSDConfig> ionosSDConfigs) {
         this.ionosSDConfigs = ionosSDConfigs;
     }
 
+    /**
+     * The value of the `job` label assigned to the scraped metrics by default.<br><p> <br><p> The `job_name` field in the rendered scrape configuration is always controlled by the operator to prevent duplicate job names, which Prometheus does not allow. Instead the `job` label is set by means of relabeling configs.
+     */
     @JsonProperty("jobName")
     public String getJobName() {
         return jobName;
     }
 
+    /**
+     * The value of the `job` label assigned to the scraped metrics by default.<br><p> <br><p> The `job_name` field in the rendered scrape configuration is always controlled by the operator to prevent duplicate job names, which Prometheus does not allow. Instead the `job` label is set by means of relabeling configs.
+     */
     @JsonProperty("jobName")
     public void setJobName(String jobName) {
         this.jobName = jobName;
     }
 
+    /**
+     * Per-scrape limit on the number of targets dropped by relabeling that will be kept in memory. 0 means no limit.<br><p> <br><p> It requires Prometheus &gt;= v2.47.0.
+     */
     @JsonProperty("keepDroppedTargets")
     public Long getKeepDroppedTargets() {
         return keepDroppedTargets;
     }
 
+    /**
+     * Per-scrape limit on the number of targets dropped by relabeling that will be kept in memory. 0 means no limit.<br><p> <br><p> It requires Prometheus &gt;= v2.47.0.
+     */
     @JsonProperty("keepDroppedTargets")
     public void setKeepDroppedTargets(Long keepDroppedTargets) {
         this.keepDroppedTargets = keepDroppedTargets;
     }
 
+    /**
+     * KubernetesSDConfigs defines a list of Kubernetes service discovery configurations.
+     */
     @JsonProperty("kubernetesSDConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<KubernetesSDConfig> getKubernetesSDConfigs() {
         return kubernetesSDConfigs;
     }
 
+    /**
+     * KubernetesSDConfigs defines a list of Kubernetes service discovery configurations.
+     */
     @JsonProperty("kubernetesSDConfigs")
     public void setKubernetesSDConfigs(List<KubernetesSDConfig> kubernetesSDConfigs) {
         this.kubernetesSDConfigs = kubernetesSDConfigs;
     }
 
+    /**
+     * KumaSDConfigs defines a list of Kuma service discovery configurations.
+     */
     @JsonProperty("kumaSDConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<KumaSDConfig> getKumaSDConfigs() {
         return kumaSDConfigs;
     }
 
+    /**
+     * KumaSDConfigs defines a list of Kuma service discovery configurations.
+     */
     @JsonProperty("kumaSDConfigs")
     public void setKumaSDConfigs(List<KumaSDConfig> kumaSDConfigs) {
         this.kumaSDConfigs = kumaSDConfigs;
     }
 
+    /**
+     * Per-scrape limit on number of labels that will be accepted for a sample. Only valid in Prometheus versions 2.27.0 and newer.
+     */
     @JsonProperty("labelLimit")
     public Long getLabelLimit() {
         return labelLimit;
     }
 
+    /**
+     * Per-scrape limit on number of labels that will be accepted for a sample. Only valid in Prometheus versions 2.27.0 and newer.
+     */
     @JsonProperty("labelLimit")
     public void setLabelLimit(Long labelLimit) {
         this.labelLimit = labelLimit;
     }
 
+    /**
+     * Per-scrape limit on length of labels name that will be accepted for a sample. Only valid in Prometheus versions 2.27.0 and newer.
+     */
     @JsonProperty("labelNameLengthLimit")
     public Long getLabelNameLengthLimit() {
         return labelNameLengthLimit;
     }
 
+    /**
+     * Per-scrape limit on length of labels name that will be accepted for a sample. Only valid in Prometheus versions 2.27.0 and newer.
+     */
     @JsonProperty("labelNameLengthLimit")
     public void setLabelNameLengthLimit(Long labelNameLengthLimit) {
         this.labelNameLengthLimit = labelNameLengthLimit;
     }
 
+    /**
+     * Per-scrape limit on length of labels value that will be accepted for a sample. Only valid in Prometheus versions 2.27.0 and newer.
+     */
     @JsonProperty("labelValueLengthLimit")
     public Long getLabelValueLengthLimit() {
         return labelValueLengthLimit;
     }
 
+    /**
+     * Per-scrape limit on length of labels value that will be accepted for a sample. Only valid in Prometheus versions 2.27.0 and newer.
+     */
     @JsonProperty("labelValueLengthLimit")
     public void setLabelValueLengthLimit(Long labelValueLengthLimit) {
         this.labelValueLengthLimit = labelValueLengthLimit;
     }
 
+    /**
+     * LightsailSDConfigs defines a list of Lightsail service discovery configurations.
+     */
     @JsonProperty("lightSailSDConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LightSailSDConfig> getLightSailSDConfigs() {
         return lightSailSDConfigs;
     }
 
+    /**
+     * LightsailSDConfigs defines a list of Lightsail service discovery configurations.
+     */
     @JsonProperty("lightSailSDConfigs")
     public void setLightSailSDConfigs(List<LightSailSDConfig> lightSailSDConfigs) {
         this.lightSailSDConfigs = lightSailSDConfigs;
     }
 
+    /**
+     * LinodeSDConfigs defines a list of Linode service discovery configurations.
+     */
     @JsonProperty("linodeSDConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LinodeSDConfig> getLinodeSDConfigs() {
         return linodeSDConfigs;
     }
 
+    /**
+     * LinodeSDConfigs defines a list of Linode service discovery configurations.
+     */
     @JsonProperty("linodeSDConfigs")
     public void setLinodeSDConfigs(List<LinodeSDConfig> linodeSDConfigs) {
         this.linodeSDConfigs = linodeSDConfigs;
     }
 
+    /**
+     * MetricRelabelConfigs to apply to samples before ingestion.
+     */
     @JsonProperty("metricRelabelings")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RelabelConfig> getMetricRelabelings() {
         return metricRelabelings;
     }
 
+    /**
+     * MetricRelabelConfigs to apply to samples before ingestion.
+     */
     @JsonProperty("metricRelabelings")
     public void setMetricRelabelings(List<RelabelConfig> metricRelabelings) {
         this.metricRelabelings = metricRelabelings;
     }
 
+    /**
+     * MetricsPath HTTP path to scrape for metrics. If empty, Prometheus uses the default value (e.g. /metrics).
+     */
     @JsonProperty("metricsPath")
     public String getMetricsPath() {
         return metricsPath;
     }
 
+    /**
+     * MetricsPath HTTP path to scrape for metrics. If empty, Prometheus uses the default value (e.g. /metrics).
+     */
     @JsonProperty("metricsPath")
     public void setMetricsPath(String metricsPath) {
         this.metricsPath = metricsPath;
     }
 
+    /**
+     * If there are more than this many buckets in a native histogram, buckets will be merged to stay within the limit. It requires Prometheus &gt;= v2.45.0.
+     */
     @JsonProperty("nativeHistogramBucketLimit")
     public Long getNativeHistogramBucketLimit() {
         return nativeHistogramBucketLimit;
     }
 
+    /**
+     * If there are more than this many buckets in a native histogram, buckets will be merged to stay within the limit. It requires Prometheus &gt;= v2.45.0.
+     */
     @JsonProperty("nativeHistogramBucketLimit")
     public void setNativeHistogramBucketLimit(Long nativeHistogramBucketLimit) {
         this.nativeHistogramBucketLimit = nativeHistogramBucketLimit;
     }
 
+    /**
+     * ScrapeConfigSpec is a specification of the desired configuration for a scrape configuration.
+     */
     @JsonProperty("nativeHistogramMinBucketFactor")
     public Quantity getNativeHistogramMinBucketFactor() {
         return nativeHistogramMinBucketFactor;
     }
 
+    /**
+     * ScrapeConfigSpec is a specification of the desired configuration for a scrape configuration.
+     */
     @JsonProperty("nativeHistogramMinBucketFactor")
     public void setNativeHistogramMinBucketFactor(Quantity nativeHistogramMinBucketFactor) {
         this.nativeHistogramMinBucketFactor = nativeHistogramMinBucketFactor;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * NomadSDConfigs defines a list of Nomad service discovery configurations.
+     */
     @JsonProperty("nomadSDConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NomadSDConfig> getNomadSDConfigs() {
         return nomadSDConfigs;
     }
 
+    /**
+     * NomadSDConfigs defines a list of Nomad service discovery configurations.
+     */
     @JsonProperty("nomadSDConfigs")
     public void setNomadSDConfigs(List<NomadSDConfig> nomadSDConfigs) {
         this.nomadSDConfigs = nomadSDConfigs;
     }
 
+    /**
+     * ScrapeConfigSpec is a specification of the desired configuration for a scrape configuration.
+     */
     @JsonProperty("oauth2")
     public OAuth2 getOauth2() {
         return oauth2;
     }
 
+    /**
+     * ScrapeConfigSpec is a specification of the desired configuration for a scrape configuration.
+     */
     @JsonProperty("oauth2")
     public void setOauth2(OAuth2 oauth2) {
         this.oauth2 = oauth2;
     }
 
+    /**
+     * OpenStackSDConfigs defines a list of OpenStack service discovery configurations.
+     */
     @JsonProperty("openstackSDConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OpenStackSDConfig> getOpenstackSDConfigs() {
         return openstackSDConfigs;
     }
 
+    /**
+     * OpenStackSDConfigs defines a list of OpenStack service discovery configurations.
+     */
     @JsonProperty("openstackSDConfigs")
     public void setOpenstackSDConfigs(List<OpenStackSDConfig> openstackSDConfigs) {
         this.openstackSDConfigs = openstackSDConfigs;
     }
 
+    /**
+     * OVHCloudSDConfigs defines a list of OVHcloud service discovery configurations.
+     */
     @JsonProperty("ovhcloudSDConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OVHCloudSDConfig> getOvhcloudSDConfigs() {
         return ovhcloudSDConfigs;
     }
 
+    /**
+     * OVHCloudSDConfigs defines a list of OVHcloud service discovery configurations.
+     */
     @JsonProperty("ovhcloudSDConfigs")
     public void setOvhcloudSDConfigs(List<OVHCloudSDConfig> ovhcloudSDConfigs) {
         this.ovhcloudSDConfigs = ovhcloudSDConfigs;
     }
 
+    /**
+     * Optional HTTP URL parameters
+     */
     @JsonProperty("params")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<String>> getParams() {
         return params;
     }
 
+    /**
+     * Optional HTTP URL parameters
+     */
     @JsonProperty("params")
     public void setParams(Map<String, List<String>> params) {
         this.params = params;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<SecretKeySelector>> getProxyConnectHeader() {
         return proxyConnectHeader;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     public void setProxyConnectHeader(Map<String, List<SecretKeySelector>> proxyConnectHeader) {
         this.proxyConnectHeader = proxyConnectHeader;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public Boolean getProxyFromEnvironment() {
         return proxyFromEnvironment;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public void setProxyFromEnvironment(Boolean proxyFromEnvironment) {
         this.proxyFromEnvironment = proxyFromEnvironment;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public String getProxyUrl() {
         return proxyUrl;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public void setProxyUrl(String proxyUrl) {
         this.proxyUrl = proxyUrl;
     }
 
+    /**
+     * PuppetDBSDConfigs defines a list of PuppetDB service discovery configurations.
+     */
     @JsonProperty("puppetDBSDConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PuppetDBSDConfig> getPuppetDBSDConfigs() {
         return puppetDBSDConfigs;
     }
 
+    /**
+     * PuppetDBSDConfigs defines a list of PuppetDB service discovery configurations.
+     */
     @JsonProperty("puppetDBSDConfigs")
     public void setPuppetDBSDConfigs(List<PuppetDBSDConfig> puppetDBSDConfigs) {
         this.puppetDBSDConfigs = puppetDBSDConfigs;
     }
 
+    /**
+     * RelabelConfigs defines how to rewrite the target's labels before scraping. Prometheus Operator automatically adds relabelings for a few standard Kubernetes fields. The original scrape job's name is available via the `__tmp_prometheus_job_name` label. More info: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config
+     */
     @JsonProperty("relabelings")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RelabelConfig> getRelabelings() {
         return relabelings;
     }
 
+    /**
+     * RelabelConfigs defines how to rewrite the target's labels before scraping. Prometheus Operator automatically adds relabelings for a few standard Kubernetes fields. The original scrape job's name is available via the `__tmp_prometheus_job_name` label. More info: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config
+     */
     @JsonProperty("relabelings")
     public void setRelabelings(List<RelabelConfig> relabelings) {
         this.relabelings = relabelings;
     }
 
+    /**
+     * SampleLimit defines per-scrape limit on number of scraped samples that will be accepted.
+     */
     @JsonProperty("sampleLimit")
     public Long getSampleLimit() {
         return sampleLimit;
     }
 
+    /**
+     * SampleLimit defines per-scrape limit on number of scraped samples that will be accepted.
+     */
     @JsonProperty("sampleLimit")
     public void setSampleLimit(Long sampleLimit) {
         this.sampleLimit = sampleLimit;
     }
 
+    /**
+     * ScalewaySDConfigs defines a list of Scaleway instances and baremetal service discovery configurations.
+     */
     @JsonProperty("scalewaySDConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ScalewaySDConfig> getScalewaySDConfigs() {
         return scalewaySDConfigs;
     }
 
+    /**
+     * ScalewaySDConfigs defines a list of Scaleway instances and baremetal service discovery configurations.
+     */
     @JsonProperty("scalewaySDConfigs")
     public void setScalewaySDConfigs(List<ScalewaySDConfig> scalewaySDConfigs) {
         this.scalewaySDConfigs = scalewaySDConfigs;
     }
 
+    /**
+     * Configures the protocol scheme used for requests. If empty, Prometheus uses HTTP by default.
+     */
     @JsonProperty("scheme")
     public String getScheme() {
         return scheme;
     }
 
+    /**
+     * Configures the protocol scheme used for requests. If empty, Prometheus uses HTTP by default.
+     */
     @JsonProperty("scheme")
     public void setScheme(String scheme) {
         this.scheme = scheme;
     }
 
+    /**
+     * The scrape class to apply.
+     */
     @JsonProperty("scrapeClass")
     public String getScrapeClass() {
         return scrapeClass;
     }
 
+    /**
+     * The scrape class to apply.
+     */
     @JsonProperty("scrapeClass")
     public void setScrapeClass(String scrapeClass) {
         this.scrapeClass = scrapeClass;
     }
 
+    /**
+     * Whether to scrape a classic histogram that is also exposed as a native histogram. It requires Prometheus &gt;= v2.45.0.
+     */
     @JsonProperty("scrapeClassicHistograms")
     public Boolean getScrapeClassicHistograms() {
         return scrapeClassicHistograms;
     }
 
+    /**
+     * Whether to scrape a classic histogram that is also exposed as a native histogram. It requires Prometheus &gt;= v2.45.0.
+     */
     @JsonProperty("scrapeClassicHistograms")
     public void setScrapeClassicHistograms(Boolean scrapeClassicHistograms) {
         this.scrapeClassicHistograms = scrapeClassicHistograms;
     }
 
+    /**
+     * ScrapeInterval is the interval between consecutive scrapes.
+     */
     @JsonProperty("scrapeInterval")
     public String getScrapeInterval() {
         return scrapeInterval;
     }
 
+    /**
+     * ScrapeInterval is the interval between consecutive scrapes.
+     */
     @JsonProperty("scrapeInterval")
     public void setScrapeInterval(String scrapeInterval) {
         this.scrapeInterval = scrapeInterval;
     }
 
+    /**
+     * The protocols to negotiate during a scrape. It tells clients the protocols supported by Prometheus in order of preference (from most to least preferred).<br><p> <br><p> If unset, Prometheus uses its default value.<br><p> <br><p> It requires Prometheus &gt;= v2.49.0.
+     */
     @JsonProperty("scrapeProtocols")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getScrapeProtocols() {
         return scrapeProtocols;
     }
 
+    /**
+     * The protocols to negotiate during a scrape. It tells clients the protocols supported by Prometheus in order of preference (from most to least preferred).<br><p> <br><p> If unset, Prometheus uses its default value.<br><p> <br><p> It requires Prometheus &gt;= v2.49.0.
+     */
     @JsonProperty("scrapeProtocols")
     public void setScrapeProtocols(List<String> scrapeProtocols) {
         this.scrapeProtocols = scrapeProtocols;
     }
 
+    /**
+     * ScrapeTimeout is the number of seconds to wait until a scrape request times out.
+     */
     @JsonProperty("scrapeTimeout")
     public String getScrapeTimeout() {
         return scrapeTimeout;
     }
 
+    /**
+     * ScrapeTimeout is the number of seconds to wait until a scrape request times out.
+     */
     @JsonProperty("scrapeTimeout")
     public void setScrapeTimeout(String scrapeTimeout) {
         this.scrapeTimeout = scrapeTimeout;
     }
 
+    /**
+     * StaticConfigs defines a list of static targets with a common label set.
+     */
     @JsonProperty("staticConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<StaticConfig> getStaticConfigs() {
         return staticConfigs;
     }
 
+    /**
+     * StaticConfigs defines a list of static targets with a common label set.
+     */
     @JsonProperty("staticConfigs")
     public void setStaticConfigs(List<StaticConfig> staticConfigs) {
         this.staticConfigs = staticConfigs;
     }
 
+    /**
+     * TargetLimit defines a limit on the number of scraped targets that will be accepted.
+     */
     @JsonProperty("targetLimit")
     public Long getTargetLimit() {
         return targetLimit;
     }
 
+    /**
+     * TargetLimit defines a limit on the number of scraped targets that will be accepted.
+     */
     @JsonProperty("targetLimit")
     public void setTargetLimit(Long targetLimit) {
         this.targetLimit = targetLimit;
     }
 
+    /**
+     * ScrapeConfigSpec is a specification of the desired configuration for a scrape configuration.
+     */
     @JsonProperty("tlsConfig")
     public SafeTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * ScrapeConfigSpec is a specification of the desired configuration for a scrape configuration.
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(SafeTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * TrackTimestampsStaleness whether Prometheus tracks staleness of the metrics that have an explicit timestamp present in scraped data. Has no effect if `honorTimestamps` is false. It requires Prometheus &gt;= v2.48.0.
+     */
     @JsonProperty("trackTimestampsStaleness")
     public Boolean getTrackTimestampsStaleness() {
         return trackTimestampsStaleness;
     }
 
+    /**
+     * TrackTimestampsStaleness whether Prometheus tracks staleness of the metrics that have an explicit timestamp present in scraped data. Has no effect if `honorTimestamps` is false. It requires Prometheus &gt;= v2.48.0.
+     */
     @JsonProperty("trackTimestampsStaleness")
     public void setTrackTimestampsStaleness(Boolean trackTimestampsStaleness) {
         this.trackTimestampsStaleness = trackTimestampsStaleness;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/SlackAction.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/SlackAction.java
index 0997155b9aa..a0035653471 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/SlackAction.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/SlackAction.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,71 +105,113 @@ public SlackAction(SlackConfirmationField confirm, String name, String style, St
         this.value = value;
     }
 
+    /**
+     * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+     */
     @JsonProperty("confirm")
     public SlackConfirmationField getConfirm() {
         return confirm;
     }
 
+    /**
+     * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+     */
     @JsonProperty("confirm")
     public void setConfirm(SlackConfirmationField confirm) {
         this.confirm = confirm;
     }
 
+    /**
+     * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+     */
     @JsonProperty("style")
     public String getStyle() {
         return style;
     }
 
+    /**
+     * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+     */
     @JsonProperty("style")
     public void setStyle(String style) {
         this.style = style;
     }
 
+    /**
+     * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+     */
     @JsonProperty("text")
     public String getText() {
         return text;
     }
 
+    /**
+     * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+     */
     @JsonProperty("text")
     public void setText(String text) {
         this.text = text;
     }
 
+    /**
+     * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
     }
 
+    /**
+     * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/SlackConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/SlackConfig.java
index 4ecf8d0e13b..ea073a9bbc8 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/SlackConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/SlackConfig.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -168,224 +171,356 @@ public SlackConfig(List<SlackAction> actions, SecretKeySelector apiURL, String c
         this.username = username;
     }
 
+    /**
+     * A list of Slack actions that are sent with each notification.
+     */
     @JsonProperty("actions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SlackAction> getActions() {
         return actions;
     }
 
+    /**
+     * A list of Slack actions that are sent with each notification.
+     */
     @JsonProperty("actions")
     public void setActions(List<SlackAction> actions) {
         this.actions = actions;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("apiURL")
     public SecretKeySelector getApiURL() {
         return apiURL;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("apiURL")
     public void setApiURL(SecretKeySelector apiURL) {
         this.apiURL = apiURL;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("callbackId")
     public String getCallbackId() {
         return callbackId;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("callbackId")
     public void setCallbackId(String callbackId) {
         this.callbackId = callbackId;
     }
 
+    /**
+     * The channel or user to send notifications to.
+     */
     @JsonProperty("channel")
     public String getChannel() {
         return channel;
     }
 
+    /**
+     * The channel or user to send notifications to.
+     */
     @JsonProperty("channel")
     public void setChannel(String channel) {
         this.channel = channel;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("color")
     public String getColor() {
         return color;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("color")
     public void setColor(String color) {
         this.color = color;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("fallback")
     public String getFallback() {
         return fallback;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("fallback")
     public void setFallback(String fallback) {
         this.fallback = fallback;
     }
 
+    /**
+     * A list of Slack fields that are sent with each notification.
+     */
     @JsonProperty("fields")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SlackField> getFields() {
         return fields;
     }
 
+    /**
+     * A list of Slack fields that are sent with each notification.
+     */
     @JsonProperty("fields")
     public void setFields(List<SlackField> fields) {
         this.fields = fields;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("footer")
     public String getFooter() {
         return footer;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("footer")
     public void setFooter(String footer) {
         this.footer = footer;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("httpConfig")
     public HTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(HTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("iconEmoji")
     public String getIconEmoji() {
         return iconEmoji;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("iconEmoji")
     public void setIconEmoji(String iconEmoji) {
         this.iconEmoji = iconEmoji;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("iconURL")
     public String getIconURL() {
         return iconURL;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("iconURL")
     public void setIconURL(String iconURL) {
         this.iconURL = iconURL;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("imageURL")
     public String getImageURL() {
         return imageURL;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("imageURL")
     public void setImageURL(String imageURL) {
         this.imageURL = imageURL;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("linkNames")
     public Boolean getLinkNames() {
         return linkNames;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("linkNames")
     public void setLinkNames(Boolean linkNames) {
         this.linkNames = linkNames;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("mrkdwnIn")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMrkdwnIn() {
         return mrkdwnIn;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("mrkdwnIn")
     public void setMrkdwnIn(List<String> mrkdwnIn) {
         this.mrkdwnIn = mrkdwnIn;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("pretext")
     public String getPretext() {
         return pretext;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("pretext")
     public void setPretext(String pretext) {
         this.pretext = pretext;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public Boolean getSendResolved() {
         return sendResolved;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public void setSendResolved(Boolean sendResolved) {
         this.sendResolved = sendResolved;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("shortFields")
     public Boolean getShortFields() {
         return shortFields;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("shortFields")
     public void setShortFields(Boolean shortFields) {
         this.shortFields = shortFields;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("text")
     public String getText() {
         return text;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("text")
     public void setText(String text) {
         this.text = text;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("thumbURL")
     public String getThumbURL() {
         return thumbURL;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("thumbURL")
     public void setThumbURL(String thumbURL) {
         this.thumbURL = thumbURL;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("title")
     public String getTitle() {
         return title;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("title")
     public void setTitle(String title) {
         this.title = title;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("titleLink")
     public String getTitleLink() {
         return titleLink;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("titleLink")
     public void setTitleLink(String titleLink) {
         this.titleLink = titleLink;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("username")
     public String getUsername() {
         return username;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("username")
     public void setUsername(String username) {
         this.username = username;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/SlackConfirmationField.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/SlackConfirmationField.java
index 1e5ddfe02f6..b51afd5d43a 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/SlackConfirmationField.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/SlackConfirmationField.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SlackConfirmationField protect users from destructive actions or particularly distinguished decisions by asking them to confirm their button click one more time. See https://api.slack.com/docs/interactive-message-field-guide#confirmation_fields for more information.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public SlackConfirmationField(String dismissText, String okText, String text, St
         this.title = title;
     }
 
+    /**
+     * SlackConfirmationField protect users from destructive actions or particularly distinguished decisions by asking them to confirm their button click one more time. See https://api.slack.com/docs/interactive-message-field-guide#confirmation_fields for more information.
+     */
     @JsonProperty("dismissText")
     public String getDismissText() {
         return dismissText;
     }
 
+    /**
+     * SlackConfirmationField protect users from destructive actions or particularly distinguished decisions by asking them to confirm their button click one more time. See https://api.slack.com/docs/interactive-message-field-guide#confirmation_fields for more information.
+     */
     @JsonProperty("dismissText")
     public void setDismissText(String dismissText) {
         this.dismissText = dismissText;
     }
 
+    /**
+     * SlackConfirmationField protect users from destructive actions or particularly distinguished decisions by asking them to confirm their button click one more time. See https://api.slack.com/docs/interactive-message-field-guide#confirmation_fields for more information.
+     */
     @JsonProperty("okText")
     public String getOkText() {
         return okText;
     }
 
+    /**
+     * SlackConfirmationField protect users from destructive actions or particularly distinguished decisions by asking them to confirm their button click one more time. See https://api.slack.com/docs/interactive-message-field-guide#confirmation_fields for more information.
+     */
     @JsonProperty("okText")
     public void setOkText(String okText) {
         this.okText = okText;
     }
 
+    /**
+     * SlackConfirmationField protect users from destructive actions or particularly distinguished decisions by asking them to confirm their button click one more time. See https://api.slack.com/docs/interactive-message-field-guide#confirmation_fields for more information.
+     */
     @JsonProperty("text")
     public String getText() {
         return text;
     }
 
+    /**
+     * SlackConfirmationField protect users from destructive actions or particularly distinguished decisions by asking them to confirm their button click one more time. See https://api.slack.com/docs/interactive-message-field-guide#confirmation_fields for more information.
+     */
     @JsonProperty("text")
     public void setText(String text) {
         this.text = text;
     }
 
+    /**
+     * SlackConfirmationField protect users from destructive actions or particularly distinguished decisions by asking them to confirm their button click one more time. See https://api.slack.com/docs/interactive-message-field-guide#confirmation_fields for more information.
+     */
     @JsonProperty("title")
     public String getTitle() {
         return title;
     }
 
+    /**
+     * SlackConfirmationField protect users from destructive actions or particularly distinguished decisions by asking them to confirm their button click one more time. See https://api.slack.com/docs/interactive-message-field-guide#confirmation_fields for more information.
+     */
     @JsonProperty("title")
     public void setTitle(String title) {
         this.title = title;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/SlackField.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/SlackField.java
index 7782069bbe8..847dc7d1f0f 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/SlackField.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/SlackField.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SlackField configures a single Slack field that is sent with each notification. Each field must contain a title, value, and optionally, a boolean value to indicate if the field is short enough to be displayed next to other fields designated as short. See https://api.slack.com/docs/message-attachments#fields for more information.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public SlackField(Boolean _short, String title, String value) {
         this.value = value;
     }
 
+    /**
+     * SlackField configures a single Slack field that is sent with each notification. Each field must contain a title, value, and optionally, a boolean value to indicate if the field is short enough to be displayed next to other fields designated as short. See https://api.slack.com/docs/message-attachments#fields for more information.
+     */
     @JsonProperty("short")
     public Boolean getShort() {
         return _short;
     }
 
+    /**
+     * SlackField configures a single Slack field that is sent with each notification. Each field must contain a title, value, and optionally, a boolean value to indicate if the field is short enough to be displayed next to other fields designated as short. See https://api.slack.com/docs/message-attachments#fields for more information.
+     */
     @JsonProperty("short")
     public void setShort(Boolean _short) {
         this._short = _short;
     }
 
+    /**
+     * SlackField configures a single Slack field that is sent with each notification. Each field must contain a title, value, and optionally, a boolean value to indicate if the field is short enough to be displayed next to other fields designated as short. See https://api.slack.com/docs/message-attachments#fields for more information.
+     */
     @JsonProperty("title")
     public String getTitle() {
         return title;
     }
 
+    /**
+     * SlackField configures a single Slack field that is sent with each notification. Each field must contain a title, value, and optionally, a boolean value to indicate if the field is short enough to be displayed next to other fields designated as short. See https://api.slack.com/docs/message-attachments#fields for more information.
+     */
     @JsonProperty("title")
     public void setTitle(String title) {
         this.title = title;
     }
 
+    /**
+     * SlackField configures a single Slack field that is sent with each notification. Each field must contain a title, value, and optionally, a boolean value to indicate if the field is short enough to be displayed next to other fields designated as short. See https://api.slack.com/docs/message-attachments#fields for more information.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * SlackField configures a single Slack field that is sent with each notification. Each field must contain a title, value, and optionally, a boolean value to indicate if the field is short enough to be displayed next to other fields designated as short. See https://api.slack.com/docs/message-attachments#fields for more information.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/StaticConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/StaticConfig.java
index 77492aa895f..44d0c4e8153 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/StaticConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/StaticConfig.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StaticConfig defines a Prometheus static configuration. See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#scrape_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public StaticConfig(Map<String, String> labels, List<String> targets) {
         this.targets = targets;
     }
 
+    /**
+     * Labels assigned to all metrics scraped from the targets.
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabels() {
         return labels;
     }
 
+    /**
+     * Labels assigned to all metrics scraped from the targets.
+     */
     @JsonProperty("labels")
     public void setLabels(Map<String, String> labels) {
         this.labels = labels;
     }
 
+    /**
+     * List of targets for this static configuration.
+     */
     @JsonProperty("targets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getTargets() {
         return targets;
     }
 
+    /**
+     * List of targets for this static configuration.
+     */
     @JsonProperty("targets")
     public void setTargets(List<String> targets) {
         this.targets = targets;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/TelegramConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/TelegramConfig.java
index af5cd73653c..882cffa8b77 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/TelegramConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/TelegramConfig.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TelegramConfig configures notifications via Telegram. See https://prometheus.io/docs/alerting/latest/configuration/#telegram_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -115,101 +118,161 @@ public TelegramConfig(String apiURL, SecretKeySelector botToken, String botToken
         this.sendResolved = sendResolved;
     }
 
+    /**
+     * The Telegram API URL i.e. https://api.telegram.org. If not specified, default API URL will be used.
+     */
     @JsonProperty("apiURL")
     public String getApiURL() {
         return apiURL;
     }
 
+    /**
+     * The Telegram API URL i.e. https://api.telegram.org. If not specified, default API URL will be used.
+     */
     @JsonProperty("apiURL")
     public void setApiURL(String apiURL) {
         this.apiURL = apiURL;
     }
 
+    /**
+     * TelegramConfig configures notifications via Telegram. See https://prometheus.io/docs/alerting/latest/configuration/#telegram_config
+     */
     @JsonProperty("botToken")
     public SecretKeySelector getBotToken() {
         return botToken;
     }
 
+    /**
+     * TelegramConfig configures notifications via Telegram. See https://prometheus.io/docs/alerting/latest/configuration/#telegram_config
+     */
     @JsonProperty("botToken")
     public void setBotToken(SecretKeySelector botToken) {
         this.botToken = botToken;
     }
 
+    /**
+     * File to read the Telegram bot token from. It is mutually exclusive with `botToken`. Either `botToken` or `botTokenFile` is required.<br><p> <br><p> It requires Alertmanager &gt;= v0.26.0.
+     */
     @JsonProperty("botTokenFile")
     public String getBotTokenFile() {
         return botTokenFile;
     }
 
+    /**
+     * File to read the Telegram bot token from. It is mutually exclusive with `botToken`. Either `botToken` or `botTokenFile` is required.<br><p> <br><p> It requires Alertmanager &gt;= v0.26.0.
+     */
     @JsonProperty("botTokenFile")
     public void setBotTokenFile(String botTokenFile) {
         this.botTokenFile = botTokenFile;
     }
 
+    /**
+     * The Telegram chat ID.
+     */
     @JsonProperty("chatID")
     public Long getChatID() {
         return chatID;
     }
 
+    /**
+     * The Telegram chat ID.
+     */
     @JsonProperty("chatID")
     public void setChatID(Long chatID) {
         this.chatID = chatID;
     }
 
+    /**
+     * Disable telegram notifications
+     */
     @JsonProperty("disableNotifications")
     public Boolean getDisableNotifications() {
         return disableNotifications;
     }
 
+    /**
+     * Disable telegram notifications
+     */
     @JsonProperty("disableNotifications")
     public void setDisableNotifications(Boolean disableNotifications) {
         this.disableNotifications = disableNotifications;
     }
 
+    /**
+     * TelegramConfig configures notifications via Telegram. See https://prometheus.io/docs/alerting/latest/configuration/#telegram_config
+     */
     @JsonProperty("httpConfig")
     public HTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * TelegramConfig configures notifications via Telegram. See https://prometheus.io/docs/alerting/latest/configuration/#telegram_config
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(HTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * Message template
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message template
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * The Telegram Group Topic ID. It requires Alertmanager &gt;= 0.26.0.
+     */
     @JsonProperty("messageThreadID")
     public Long getMessageThreadID() {
         return messageThreadID;
     }
 
+    /**
+     * The Telegram Group Topic ID. It requires Alertmanager &gt;= 0.26.0.
+     */
     @JsonProperty("messageThreadID")
     public void setMessageThreadID(Long messageThreadID) {
         this.messageThreadID = messageThreadID;
     }
 
+    /**
+     * Parse mode for telegram message
+     */
     @JsonProperty("parseMode")
     public String getParseMode() {
         return parseMode;
     }
 
+    /**
+     * Parse mode for telegram message
+     */
     @JsonProperty("parseMode")
     public void setParseMode(String parseMode) {
         this.parseMode = parseMode;
     }
 
+    /**
+     * Whether to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public Boolean getSendResolved() {
         return sendResolved;
     }
 
+    /**
+     * Whether to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public void setSendResolved(Boolean sendResolved) {
         this.sendResolved = sendResolved;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/TimeInterval.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/TimeInterval.java
index d9dfd28f84c..f94d726c26f 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/TimeInterval.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/TimeInterval.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TimeInterval describes intervals of time
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,56 +104,86 @@ public TimeInterval(List<DayOfMonthRange> daysOfMonth, List<String> months, List
         this.years = years;
     }
 
+    /**
+     * DaysOfMonth is a list of DayOfMonthRange
+     */
     @JsonProperty("daysOfMonth")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DayOfMonthRange> getDaysOfMonth() {
         return daysOfMonth;
     }
 
+    /**
+     * DaysOfMonth is a list of DayOfMonthRange
+     */
     @JsonProperty("daysOfMonth")
     public void setDaysOfMonth(List<DayOfMonthRange> daysOfMonth) {
         this.daysOfMonth = daysOfMonth;
     }
 
+    /**
+     * Months is a list of MonthRange
+     */
     @JsonProperty("months")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMonths() {
         return months;
     }
 
+    /**
+     * Months is a list of MonthRange
+     */
     @JsonProperty("months")
     public void setMonths(List<String> months) {
         this.months = months;
     }
 
+    /**
+     * Times is a list of TimeRange
+     */
     @JsonProperty("times")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TimeRange> getTimes() {
         return times;
     }
 
+    /**
+     * Times is a list of TimeRange
+     */
     @JsonProperty("times")
     public void setTimes(List<TimeRange> times) {
         this.times = times;
     }
 
+    /**
+     * Weekdays is a list of WeekdayRange
+     */
     @JsonProperty("weekdays")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getWeekdays() {
         return weekdays;
     }
 
+    /**
+     * Weekdays is a list of WeekdayRange
+     */
     @JsonProperty("weekdays")
     public void setWeekdays(List<String> weekdays) {
         this.weekdays = weekdays;
     }
 
+    /**
+     * Years is a list of YearRange
+     */
     @JsonProperty("years")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getYears() {
         return years;
     }
 
+    /**
+     * Years is a list of YearRange
+     */
     @JsonProperty("years")
     public void setYears(List<String> years) {
         this.years = years;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/TimeRange.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/TimeRange.java
index bbc0ddf7d77..a695bf1feee 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/TimeRange.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/TimeRange.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TimeRange defines a start and end time in 24hr format
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public TimeRange(String endTime, String startTime) {
         this.startTime = startTime;
     }
 
+    /**
+     * EndTime is the end time in 24hr format.
+     */
     @JsonProperty("endTime")
     public String getEndTime() {
         return endTime;
     }
 
+    /**
+     * EndTime is the end time in 24hr format.
+     */
     @JsonProperty("endTime")
     public void setEndTime(String endTime) {
         this.endTime = endTime;
     }
 
+    /**
+     * StartTime is the start time in 24hr format.
+     */
     @JsonProperty("startTime")
     public String getStartTime() {
         return startTime;
     }
 
+    /**
+     * StartTime is the start time in 24hr format.
+     */
     @JsonProperty("startTime")
     public void setStartTime(String startTime) {
         this.startTime = startTime;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/VictorOpsConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/VictorOpsConfig.java
index f8476b039b6..97471ce333c 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/VictorOpsConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/VictorOpsConfig.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VictorOpsConfig configures notifications via VictorOps. See https://prometheus.io/docs/alerting/latest/configuration/#victorops_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -118,102 +121,162 @@ public VictorOpsConfig(SecretKeySelector apiKey, String apiUrl, List<KeyValue> c
         this.stateMessage = stateMessage;
     }
 
+    /**
+     * VictorOpsConfig configures notifications via VictorOps. See https://prometheus.io/docs/alerting/latest/configuration/#victorops_config
+     */
     @JsonProperty("apiKey")
     public SecretKeySelector getApiKey() {
         return apiKey;
     }
 
+    /**
+     * VictorOpsConfig configures notifications via VictorOps. See https://prometheus.io/docs/alerting/latest/configuration/#victorops_config
+     */
     @JsonProperty("apiKey")
     public void setApiKey(SecretKeySelector apiKey) {
         this.apiKey = apiKey;
     }
 
+    /**
+     * The VictorOps API URL.
+     */
     @JsonProperty("apiUrl")
     public String getApiUrl() {
         return apiUrl;
     }
 
+    /**
+     * The VictorOps API URL.
+     */
     @JsonProperty("apiUrl")
     public void setApiUrl(String apiUrl) {
         this.apiUrl = apiUrl;
     }
 
+    /**
+     * Additional custom fields for notification.
+     */
     @JsonProperty("customFields")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<KeyValue> getCustomFields() {
         return customFields;
     }
 
+    /**
+     * Additional custom fields for notification.
+     */
     @JsonProperty("customFields")
     public void setCustomFields(List<KeyValue> customFields) {
         this.customFields = customFields;
     }
 
+    /**
+     * Contains summary of the alerted problem.
+     */
     @JsonProperty("entityDisplayName")
     public String getEntityDisplayName() {
         return entityDisplayName;
     }
 
+    /**
+     * Contains summary of the alerted problem.
+     */
     @JsonProperty("entityDisplayName")
     public void setEntityDisplayName(String entityDisplayName) {
         this.entityDisplayName = entityDisplayName;
     }
 
+    /**
+     * VictorOpsConfig configures notifications via VictorOps. See https://prometheus.io/docs/alerting/latest/configuration/#victorops_config
+     */
     @JsonProperty("httpConfig")
     public HTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * VictorOpsConfig configures notifications via VictorOps. See https://prometheus.io/docs/alerting/latest/configuration/#victorops_config
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(HTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * Describes the behavior of the alert (CRITICAL, WARNING, INFO).
+     */
     @JsonProperty("messageType")
     public String getMessageType() {
         return messageType;
     }
 
+    /**
+     * Describes the behavior of the alert (CRITICAL, WARNING, INFO).
+     */
     @JsonProperty("messageType")
     public void setMessageType(String messageType) {
         this.messageType = messageType;
     }
 
+    /**
+     * The monitoring tool the state message is from.
+     */
     @JsonProperty("monitoringTool")
     public String getMonitoringTool() {
         return monitoringTool;
     }
 
+    /**
+     * The monitoring tool the state message is from.
+     */
     @JsonProperty("monitoringTool")
     public void setMonitoringTool(String monitoringTool) {
         this.monitoringTool = monitoringTool;
     }
 
+    /**
+     * A key used to map the alert to a team.
+     */
     @JsonProperty("routingKey")
     public String getRoutingKey() {
         return routingKey;
     }
 
+    /**
+     * A key used to map the alert to a team.
+     */
     @JsonProperty("routingKey")
     public void setRoutingKey(String routingKey) {
         this.routingKey = routingKey;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public Boolean getSendResolved() {
         return sendResolved;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public void setSendResolved(Boolean sendResolved) {
         this.sendResolved = sendResolved;
     }
 
+    /**
+     * Contains long explanation of the alerted problem.
+     */
     @JsonProperty("stateMessage")
     public String getStateMessage() {
         return stateMessage;
     }
 
+    /**
+     * Contains long explanation of the alerted problem.
+     */
     @JsonProperty("stateMessage")
     public void setStateMessage(String stateMessage) {
         this.stateMessage = stateMessage;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/WeChatConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/WeChatConfig.java
index c1fe6d7be93..739ab84a996 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/WeChatConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/WeChatConfig.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -119,111 +122,177 @@ public WeChatConfig(String agentID, SecretKeySelector apiSecret, String apiURL,
         this.toUser = toUser;
     }
 
+    /**
+     * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+     */
     @JsonProperty("agentID")
     public String getAgentID() {
         return agentID;
     }
 
+    /**
+     * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+     */
     @JsonProperty("agentID")
     public void setAgentID(String agentID) {
         this.agentID = agentID;
     }
 
+    /**
+     * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+     */
     @JsonProperty("apiSecret")
     public SecretKeySelector getApiSecret() {
         return apiSecret;
     }
 
+    /**
+     * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+     */
     @JsonProperty("apiSecret")
     public void setApiSecret(SecretKeySelector apiSecret) {
         this.apiSecret = apiSecret;
     }
 
+    /**
+     * The WeChat API URL.
+     */
     @JsonProperty("apiURL")
     public String getApiURL() {
         return apiURL;
     }
 
+    /**
+     * The WeChat API URL.
+     */
     @JsonProperty("apiURL")
     public void setApiURL(String apiURL) {
         this.apiURL = apiURL;
     }
 
+    /**
+     * The corp id for authentication.
+     */
     @JsonProperty("corpID")
     public String getCorpID() {
         return corpID;
     }
 
+    /**
+     * The corp id for authentication.
+     */
     @JsonProperty("corpID")
     public void setCorpID(String corpID) {
         this.corpID = corpID;
     }
 
+    /**
+     * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+     */
     @JsonProperty("httpConfig")
     public HTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(HTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * API request data as defined by the WeChat API.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * API request data as defined by the WeChat API.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+     */
     @JsonProperty("messageType")
     public String getMessageType() {
         return messageType;
     }
 
+    /**
+     * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+     */
     @JsonProperty("messageType")
     public void setMessageType(String messageType) {
         this.messageType = messageType;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public Boolean getSendResolved() {
         return sendResolved;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public void setSendResolved(Boolean sendResolved) {
         this.sendResolved = sendResolved;
     }
 
+    /**
+     * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+     */
     @JsonProperty("toParty")
     public String getToParty() {
         return toParty;
     }
 
+    /**
+     * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+     */
     @JsonProperty("toParty")
     public void setToParty(String toParty) {
         this.toParty = toParty;
     }
 
+    /**
+     * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+     */
     @JsonProperty("toTag")
     public String getToTag() {
         return toTag;
     }
 
+    /**
+     * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+     */
     @JsonProperty("toTag")
     public void setToTag(String toTag) {
         this.toTag = toTag;
     }
 
+    /**
+     * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+     */
     @JsonProperty("toUser")
     public String getToUser() {
         return toUser;
     }
 
+    /**
+     * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+     */
     @JsonProperty("toUser")
     public void setToUser(String toUser) {
         this.toUser = toUser;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/WebexConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/WebexConfig.java
index 9c27c0eeb55..528e21056b1 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/WebexConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/WebexConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WebexConfig configures notification via Cisco Webex See https://prometheus.io/docs/alerting/latest/configuration/#webex_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public WebexConfig(String apiURL, HTTPConfig httpConfig, String message, String
         this.sendResolved = sendResolved;
     }
 
+    /**
+     * The Webex Teams API URL i.e. https://webexapis.com/v1/messages Provide if different from the default API URL.
+     */
     @JsonProperty("apiURL")
     public String getApiURL() {
         return apiURL;
     }
 
+    /**
+     * The Webex Teams API URL i.e. https://webexapis.com/v1/messages Provide if different from the default API URL.
+     */
     @JsonProperty("apiURL")
     public void setApiURL(String apiURL) {
         this.apiURL = apiURL;
     }
 
+    /**
+     * WebexConfig configures notification via Cisco Webex See https://prometheus.io/docs/alerting/latest/configuration/#webex_config
+     */
     @JsonProperty("httpConfig")
     public HTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * WebexConfig configures notification via Cisco Webex See https://prometheus.io/docs/alerting/latest/configuration/#webex_config
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(HTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * Message template
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message template
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * ID of the Webex Teams room where to send the messages.
+     */
     @JsonProperty("roomID")
     public String getRoomID() {
         return roomID;
     }
 
+    /**
+     * ID of the Webex Teams room where to send the messages.
+     */
     @JsonProperty("roomID")
     public void setRoomID(String roomID) {
         this.roomID = roomID;
     }
 
+    /**
+     * Whether to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public Boolean getSendResolved() {
         return sendResolved;
     }
 
+    /**
+     * Whether to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public void setSendResolved(Boolean sendResolved) {
         this.sendResolved = sendResolved;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/WebhookConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/WebhookConfig.java
index e5542753f60..3999ceaa28f 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/WebhookConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1alpha1/WebhookConfig.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WebhookConfig configures notifications via a generic receiver supporting the webhook payload. See https://prometheus.io/docs/alerting/latest/configuration/#webhook_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,51 +98,81 @@ public WebhookConfig(HTTPConfig httpConfig, Integer maxAlerts, Boolean sendResol
         this.urlSecret = urlSecret;
     }
 
+    /**
+     * WebhookConfig configures notifications via a generic receiver supporting the webhook payload. See https://prometheus.io/docs/alerting/latest/configuration/#webhook_config
+     */
     @JsonProperty("httpConfig")
     public HTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * WebhookConfig configures notifications via a generic receiver supporting the webhook payload. See https://prometheus.io/docs/alerting/latest/configuration/#webhook_config
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(HTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * Maximum number of alerts to be sent per webhook message. When 0, all alerts are included.
+     */
     @JsonProperty("maxAlerts")
     public Integer getMaxAlerts() {
         return maxAlerts;
     }
 
+    /**
+     * Maximum number of alerts to be sent per webhook message. When 0, all alerts are included.
+     */
     @JsonProperty("maxAlerts")
     public void setMaxAlerts(Integer maxAlerts) {
         this.maxAlerts = maxAlerts;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public Boolean getSendResolved() {
         return sendResolved;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public void setSendResolved(Boolean sendResolved) {
         this.sendResolved = sendResolved;
     }
 
+    /**
+     * The URL to send HTTP POST requests to. `urlSecret` takes precedence over `url`. One of `urlSecret` and `url` should be defined.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * The URL to send HTTP POST requests to. `urlSecret` takes precedence over `url`. One of `urlSecret` and `url` should be defined.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
     }
 
+    /**
+     * WebhookConfig configures notifications via a generic receiver supporting the webhook payload. See https://prometheus.io/docs/alerting/latest/configuration/#webhook_config
+     */
     @JsonProperty("urlSecret")
     public SecretKeySelector getUrlSecret() {
         return urlSecret;
     }
 
+    /**
+     * WebhookConfig configures notifications via a generic receiver supporting the webhook payload. See https://prometheus.io/docs/alerting/latest/configuration/#webhook_config
+     */
     @JsonProperty("urlSecret")
     public void setUrlSecret(SecretKeySelector urlSecret) {
         this.urlSecret = urlSecret;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/AlertmanagerConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/AlertmanagerConfig.java
index 50f13898f7e..eed228930c9 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/AlertmanagerConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/AlertmanagerConfig.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * The `AlertmanagerConfig` custom resource definition (CRD) defines how `Alertmanager` objects process Prometheus alerts. It allows to specify alert grouping and routing, notification receivers and inhibition rules.<br><p> <br><p> `Alertmanager` objects select `AlertmanagerConfig` objects using label and namespace selectors.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class AlertmanagerConfig implements Editable<AlertmanagerConfigBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "monitoring.coreos.com/v1beta1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AlertmanagerConfig";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public AlertmanagerConfig(String apiVersion, String kind, ObjectMeta metadata, A
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * The `AlertmanagerConfig` custom resource definition (CRD) defines how `Alertmanager` objects process Prometheus alerts. It allows to specify alert grouping and routing, notification receivers and inhibition rules.<br><p> <br><p> `Alertmanager` objects select `AlertmanagerConfig` objects using label and namespace selectors.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * The `AlertmanagerConfig` custom resource definition (CRD) defines how `Alertmanager` objects process Prometheus alerts. It allows to specify alert grouping and routing, notification receivers and inhibition rules.<br><p> <br><p> `Alertmanager` objects select `AlertmanagerConfig` objects using label and namespace selectors.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * The `AlertmanagerConfig` custom resource definition (CRD) defines how `Alertmanager` objects process Prometheus alerts. It allows to specify alert grouping and routing, notification receivers and inhibition rules.<br><p> <br><p> `Alertmanager` objects select `AlertmanagerConfig` objects using label and namespace selectors.
+     */
     @JsonProperty("spec")
     public AlertmanagerConfigSpec getSpec() {
         return spec;
     }
 
+    /**
+     * The `AlertmanagerConfig` custom resource definition (CRD) defines how `Alertmanager` objects process Prometheus alerts. It allows to specify alert grouping and routing, notification receivers and inhibition rules.<br><p> <br><p> `Alertmanager` objects select `AlertmanagerConfig` objects using label and namespace selectors.
+     */
     @JsonProperty("spec")
     public void setSpec(AlertmanagerConfigSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/AlertmanagerConfigList.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/AlertmanagerConfigList.java
index 6424f1b9f92..6125c0ef010 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/AlertmanagerConfigList.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/AlertmanagerConfigList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AlertmanagerConfigList is a list of AlertmanagerConfig.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class AlertmanagerConfigList implements Editable<AlertmanagerConfigListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.monitoring.v1beta1.AlertmanagerConfig>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "monitoring.coreos.com/v1beta1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.monitoring.v1beta1.AlertmanagerConfig> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AlertmanagerConfigList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public AlertmanagerConfigList(String apiVersion, List<io.fabric8.openshift.api.m
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of AlertmanagerConfig
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.monitoring.v1beta1.AlertmanagerConfig> getItems() {
         return items;
     }
 
+    /**
+     * List of AlertmanagerConfig
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.monitoring.v1beta1.AlertmanagerConfig> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AlertmanagerConfigList is a list of AlertmanagerConfig.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AlertmanagerConfigList is a list of AlertmanagerConfig.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/AlertmanagerConfigSpec.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/AlertmanagerConfigSpec.java
index 478cd28a46b..96c3422716c 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/AlertmanagerConfigSpec.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/AlertmanagerConfigSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AlertmanagerConfigSpec is a specification of the desired behavior of the Alertmanager configuration. By definition, the Alertmanager configuration only applies to alerts for which the `namespace` label is equal to the namespace of the AlertmanagerConfig resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,44 +98,68 @@ public AlertmanagerConfigSpec(List<InhibitRule> inhibitRules, List<Receiver> rec
         this.timeIntervals = timeIntervals;
     }
 
+    /**
+     * List of inhibition rules. The rules will only apply to alerts matching the resource's namespace.
+     */
     @JsonProperty("inhibitRules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<InhibitRule> getInhibitRules() {
         return inhibitRules;
     }
 
+    /**
+     * List of inhibition rules. The rules will only apply to alerts matching the resource's namespace.
+     */
     @JsonProperty("inhibitRules")
     public void setInhibitRules(List<InhibitRule> inhibitRules) {
         this.inhibitRules = inhibitRules;
     }
 
+    /**
+     * List of receivers.
+     */
     @JsonProperty("receivers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Receiver> getReceivers() {
         return receivers;
     }
 
+    /**
+     * List of receivers.
+     */
     @JsonProperty("receivers")
     public void setReceivers(List<Receiver> receivers) {
         this.receivers = receivers;
     }
 
+    /**
+     * AlertmanagerConfigSpec is a specification of the desired behavior of the Alertmanager configuration. By definition, the Alertmanager configuration only applies to alerts for which the `namespace` label is equal to the namespace of the AlertmanagerConfig resource.
+     */
     @JsonProperty("route")
     public Route getRoute() {
         return route;
     }
 
+    /**
+     * AlertmanagerConfigSpec is a specification of the desired behavior of the Alertmanager configuration. By definition, the Alertmanager configuration only applies to alerts for which the `namespace` label is equal to the namespace of the AlertmanagerConfig resource.
+     */
     @JsonProperty("route")
     public void setRoute(Route route) {
         this.route = route;
     }
 
+    /**
+     * List of TimeInterval specifying when the routes should be muted or active.
+     */
     @JsonProperty("timeIntervals")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TimeInterval> getTimeIntervals() {
         return timeIntervals;
     }
 
+    /**
+     * List of TimeInterval specifying when the routes should be muted or active.
+     */
     @JsonProperty("timeIntervals")
     public void setTimeIntervals(List<TimeInterval> timeIntervals) {
         this.timeIntervals = timeIntervals;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/DayOfMonthRange.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/DayOfMonthRange.java
index 7a68ac6223f..80993978df8 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/DayOfMonthRange.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/DayOfMonthRange.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DayOfMonthRange is an inclusive range of days of the month beginning at 1
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public DayOfMonthRange(Integer end, Integer start) {
         this.start = start;
     }
 
+    /**
+     * End of the inclusive range
+     */
     @JsonProperty("end")
     public Integer getEnd() {
         return end;
     }
 
+    /**
+     * End of the inclusive range
+     */
     @JsonProperty("end")
     public void setEnd(Integer end) {
         this.end = end;
     }
 
+    /**
+     * Start of the inclusive range
+     */
     @JsonProperty("start")
     public Integer getStart() {
         return start;
     }
 
+    /**
+     * Start of the inclusive range
+     */
     @JsonProperty("start")
     public void setStart(Integer start) {
         this.start = start;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/DiscordConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/DiscordConfig.java
index 1a8cbff0e08..41574376d01 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/DiscordConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/DiscordConfig.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DiscordConfig configures notifications via Discord. See https://prometheus.io/docs/alerting/latest/configuration/#discord_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,51 +98,81 @@ public DiscordConfig(SecretKeySelector apiURL, HTTPConfig httpConfig, String mes
         this.title = title;
     }
 
+    /**
+     * DiscordConfig configures notifications via Discord. See https://prometheus.io/docs/alerting/latest/configuration/#discord_config
+     */
     @JsonProperty("apiURL")
     public SecretKeySelector getApiURL() {
         return apiURL;
     }
 
+    /**
+     * DiscordConfig configures notifications via Discord. See https://prometheus.io/docs/alerting/latest/configuration/#discord_config
+     */
     @JsonProperty("apiURL")
     public void setApiURL(SecretKeySelector apiURL) {
         this.apiURL = apiURL;
     }
 
+    /**
+     * DiscordConfig configures notifications via Discord. See https://prometheus.io/docs/alerting/latest/configuration/#discord_config
+     */
     @JsonProperty("httpConfig")
     public HTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * DiscordConfig configures notifications via Discord. See https://prometheus.io/docs/alerting/latest/configuration/#discord_config
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(HTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * The template of the message's body.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * The template of the message's body.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public Boolean getSendResolved() {
         return sendResolved;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public void setSendResolved(Boolean sendResolved) {
         this.sendResolved = sendResolved;
     }
 
+    /**
+     * The template of the message's title.
+     */
     @JsonProperty("title")
     public String getTitle() {
         return title;
     }
 
+    /**
+     * The template of the message's title.
+     */
     @JsonProperty("title")
     public void setTitle(String title) {
         this.title = title;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/EmailConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/EmailConfig.java
index 77554407d3f..fc31d6be4cd 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/EmailConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/EmailConfig.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EmailConfig configures notifications via Email.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -134,142 +137,226 @@ public EmailConfig(String authIdentity, SecretKeySelector authPassword, SecretKe
         this.to = to;
     }
 
+    /**
+     * The identity to use for authentication.
+     */
     @JsonProperty("authIdentity")
     public String getAuthIdentity() {
         return authIdentity;
     }
 
+    /**
+     * The identity to use for authentication.
+     */
     @JsonProperty("authIdentity")
     public void setAuthIdentity(String authIdentity) {
         this.authIdentity = authIdentity;
     }
 
+    /**
+     * EmailConfig configures notifications via Email.
+     */
     @JsonProperty("authPassword")
     public SecretKeySelector getAuthPassword() {
         return authPassword;
     }
 
+    /**
+     * EmailConfig configures notifications via Email.
+     */
     @JsonProperty("authPassword")
     public void setAuthPassword(SecretKeySelector authPassword) {
         this.authPassword = authPassword;
     }
 
+    /**
+     * EmailConfig configures notifications via Email.
+     */
     @JsonProperty("authSecret")
     public SecretKeySelector getAuthSecret() {
         return authSecret;
     }
 
+    /**
+     * EmailConfig configures notifications via Email.
+     */
     @JsonProperty("authSecret")
     public void setAuthSecret(SecretKeySelector authSecret) {
         this.authSecret = authSecret;
     }
 
+    /**
+     * The username to use for authentication.
+     */
     @JsonProperty("authUsername")
     public String getAuthUsername() {
         return authUsername;
     }
 
+    /**
+     * The username to use for authentication.
+     */
     @JsonProperty("authUsername")
     public void setAuthUsername(String authUsername) {
         this.authUsername = authUsername;
     }
 
+    /**
+     * The sender address.
+     */
     @JsonProperty("from")
     public String getFrom() {
         return from;
     }
 
+    /**
+     * The sender address.
+     */
     @JsonProperty("from")
     public void setFrom(String from) {
         this.from = from;
     }
 
+    /**
+     * Further headers email header key/value pairs. Overrides any headers previously set by the notification implementation.
+     */
     @JsonProperty("headers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<KeyValue> getHeaders() {
         return headers;
     }
 
+    /**
+     * Further headers email header key/value pairs. Overrides any headers previously set by the notification implementation.
+     */
     @JsonProperty("headers")
     public void setHeaders(List<KeyValue> headers) {
         this.headers = headers;
     }
 
+    /**
+     * The hostname to identify to the SMTP server.
+     */
     @JsonProperty("hello")
     public String getHello() {
         return hello;
     }
 
+    /**
+     * The hostname to identify to the SMTP server.
+     */
     @JsonProperty("hello")
     public void setHello(String hello) {
         this.hello = hello;
     }
 
+    /**
+     * The HTML body of the email notification.
+     */
     @JsonProperty("html")
     public String getHtml() {
         return html;
     }
 
+    /**
+     * The HTML body of the email notification.
+     */
     @JsonProperty("html")
     public void setHtml(String html) {
         this.html = html;
     }
 
+    /**
+     * The SMTP TLS requirement. Note that Go does not support unencrypted connections to remote SMTP endpoints.
+     */
     @JsonProperty("requireTLS")
     public Boolean getRequireTLS() {
         return requireTLS;
     }
 
+    /**
+     * The SMTP TLS requirement. Note that Go does not support unencrypted connections to remote SMTP endpoints.
+     */
     @JsonProperty("requireTLS")
     public void setRequireTLS(Boolean requireTLS) {
         this.requireTLS = requireTLS;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public Boolean getSendResolved() {
         return sendResolved;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public void setSendResolved(Boolean sendResolved) {
         this.sendResolved = sendResolved;
     }
 
+    /**
+     * The SMTP host and port through which emails are sent. E.g. example.com:25
+     */
     @JsonProperty("smarthost")
     public String getSmarthost() {
         return smarthost;
     }
 
+    /**
+     * The SMTP host and port through which emails are sent. E.g. example.com:25
+     */
     @JsonProperty("smarthost")
     public void setSmarthost(String smarthost) {
         this.smarthost = smarthost;
     }
 
+    /**
+     * The text body of the email notification.
+     */
     @JsonProperty("text")
     public String getText() {
         return text;
     }
 
+    /**
+     * The text body of the email notification.
+     */
     @JsonProperty("text")
     public void setText(String text) {
         this.text = text;
     }
 
+    /**
+     * EmailConfig configures notifications via Email.
+     */
     @JsonProperty("tlsConfig")
     public SafeTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * EmailConfig configures notifications via Email.
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(SafeTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * The email address to send notifications to.
+     */
     @JsonProperty("to")
     public String getTo() {
         return to;
     }
 
+    /**
+     * The email address to send notifications to.
+     */
     @JsonProperty("to")
     public void setTo(String to) {
         this.to = to;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/HTTPConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/HTTPConfig.java
index 0d4b616bf76..450b39a2c54 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/HTTPConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/HTTPConfig.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -125,112 +128,178 @@ public HTTPConfig(SafeAuthorization authorization, BasicAuth basicAuth, SecretKe
         this.tlsConfig = tlsConfig;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("authorization")
     public SafeAuthorization getAuthorization() {
         return authorization;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("authorization")
     public void setAuthorization(SafeAuthorization authorization) {
         this.authorization = authorization;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("basicAuth")
     public BasicAuth getBasicAuth() {
         return basicAuth;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("basicAuth")
     public void setBasicAuth(BasicAuth basicAuth) {
         this.basicAuth = basicAuth;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("bearerTokenSecret")
     public SecretKeySelector getBearerTokenSecret() {
         return bearerTokenSecret;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("bearerTokenSecret")
     public void setBearerTokenSecret(SecretKeySelector bearerTokenSecret) {
         this.bearerTokenSecret = bearerTokenSecret;
     }
 
+    /**
+     * FollowRedirects specifies whether the client should follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public Boolean getFollowRedirects() {
         return followRedirects;
     }
 
+    /**
+     * FollowRedirects specifies whether the client should follow HTTP 3xx redirects.
+     */
     @JsonProperty("followRedirects")
     public void setFollowRedirects(Boolean followRedirects) {
         this.followRedirects = followRedirects;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * `noProxy` is a comma-separated string that can contain IPs, CIDR notation, domain names that should be excluded from proxying. IP and domain names can contain port numbers.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("oauth2")
     public OAuth2 getOauth2() {
         return oauth2;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("oauth2")
     public void setOauth2(OAuth2 oauth2) {
         this.oauth2 = oauth2;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<SecretKeySelector>> getProxyConnectHeader() {
         return proxyConnectHeader;
     }
 
+    /**
+     * ProxyConnectHeader optionally specifies headers to send to proxies during CONNECT requests.<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyConnectHeader")
     public void setProxyConnectHeader(Map<String, List<SecretKeySelector>> proxyConnectHeader) {
         this.proxyConnectHeader = proxyConnectHeader;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public Boolean getProxyFromEnvironment() {
         return proxyFromEnvironment;
     }
 
+    /**
+     * Whether to use the proxy configuration defined by environment variables (HTTP_PROXY, HTTPS_PROXY, and NO_PROXY).<br><p> <br><p> It requires Prometheus &gt;= v2.43.0 or Alertmanager &gt;= 0.25.0.
+     */
     @JsonProperty("proxyFromEnvironment")
     public void setProxyFromEnvironment(Boolean proxyFromEnvironment) {
         this.proxyFromEnvironment = proxyFromEnvironment;
     }
 
+    /**
+     * Optional proxy URL.<br><p> <br><p> If defined, this field takes precedence over `proxyUrl`.
+     */
     @JsonProperty("proxyURL")
     public String getProxyURL() {
         return proxyURL;
     }
 
+    /**
+     * Optional proxy URL.<br><p> <br><p> If defined, this field takes precedence over `proxyUrl`.
+     */
     @JsonProperty("proxyURL")
     public void setProxyURL(String proxyURL) {
         this.proxyURL = proxyURL;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public String getProxyUrl() {
         return proxyUrl;
     }
 
+    /**
+     * `proxyURL` defines the HTTP proxy server to use.
+     */
     @JsonProperty("proxyUrl")
     public void setProxyUrl(String proxyUrl) {
         this.proxyUrl = proxyUrl;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("tlsConfig")
     public SafeTLSConfig getTlsConfig() {
         return tlsConfig;
     }
 
+    /**
+     * HTTPConfig defines a client HTTP configuration. See https://prometheus.io/docs/alerting/latest/configuration/#http_config
+     */
     @JsonProperty("tlsConfig")
     public void setTlsConfig(SafeTLSConfig tlsConfig) {
         this.tlsConfig = tlsConfig;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/InhibitRule.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/InhibitRule.java
index 97a01cb102b..afccfd2b7cb 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/InhibitRule.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/InhibitRule.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * InhibitRule defines an inhibition rule that allows to mute alerts when other alerts are already firing. See https://prometheus.io/docs/alerting/latest/configuration/#inhibit_rule
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,34 +94,52 @@ public InhibitRule(List<String> equal, List<Matcher> sourceMatch, List<Matcher>
         this.targetMatch = targetMatch;
     }
 
+    /**
+     * Labels that must have an equal value in the source and target alert for the inhibition to take effect.
+     */
     @JsonProperty("equal")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEqual() {
         return equal;
     }
 
+    /**
+     * Labels that must have an equal value in the source and target alert for the inhibition to take effect.
+     */
     @JsonProperty("equal")
     public void setEqual(List<String> equal) {
         this.equal = equal;
     }
 
+    /**
+     * Matchers for which one or more alerts have to exist for the inhibition to take effect. The operator enforces that the alert matches the resource's namespace.
+     */
     @JsonProperty("sourceMatch")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Matcher> getSourceMatch() {
         return sourceMatch;
     }
 
+    /**
+     * Matchers for which one or more alerts have to exist for the inhibition to take effect. The operator enforces that the alert matches the resource's namespace.
+     */
     @JsonProperty("sourceMatch")
     public void setSourceMatch(List<Matcher> sourceMatch) {
         this.sourceMatch = sourceMatch;
     }
 
+    /**
+     * Matchers that have to be fulfilled in the alerts to be muted. The operator enforces that the alert matches the resource's namespace.
+     */
     @JsonProperty("targetMatch")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Matcher> getTargetMatch() {
         return targetMatch;
     }
 
+    /**
+     * Matchers that have to be fulfilled in the alerts to be muted. The operator enforces that the alert matches the resource's namespace.
+     */
     @JsonProperty("targetMatch")
     public void setTargetMatch(List<Matcher> targetMatch) {
         this.targetMatch = targetMatch;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/KeyValue.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/KeyValue.java
index eac40cd6fb6..2d3b50625e5 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/KeyValue.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/KeyValue.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KeyValue defines a (key, value) tuple.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public KeyValue(String key, String value) {
         this.value = value;
     }
 
+    /**
+     * Key of the tuple.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * Key of the tuple.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * Value of the tuple.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value of the tuple.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/MSTeamsConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/MSTeamsConfig.java
index 874e248f0c9..9bcd150b3f2 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/MSTeamsConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/MSTeamsConfig.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MSTeamsConfig configures notifications via Microsoft Teams. It requires Alertmanager &gt;= 0.26.0.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -99,61 +102,97 @@ public MSTeamsConfig(HTTPConfig httpConfig, Boolean sendResolved, String summary
         this.webhookUrl = webhookUrl;
     }
 
+    /**
+     * MSTeamsConfig configures notifications via Microsoft Teams. It requires Alertmanager &gt;= 0.26.0.
+     */
     @JsonProperty("httpConfig")
     public HTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * MSTeamsConfig configures notifications via Microsoft Teams. It requires Alertmanager &gt;= 0.26.0.
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(HTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * Whether to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public Boolean getSendResolved() {
         return sendResolved;
     }
 
+    /**
+     * Whether to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public void setSendResolved(Boolean sendResolved) {
         this.sendResolved = sendResolved;
     }
 
+    /**
+     * Message summary template. It requires Alertmanager &gt;= 0.27.0.
+     */
     @JsonProperty("summary")
     public String getSummary() {
         return summary;
     }
 
+    /**
+     * Message summary template. It requires Alertmanager &gt;= 0.27.0.
+     */
     @JsonProperty("summary")
     public void setSummary(String summary) {
         this.summary = summary;
     }
 
+    /**
+     * Message body template.
+     */
     @JsonProperty("text")
     public String getText() {
         return text;
     }
 
+    /**
+     * Message body template.
+     */
     @JsonProperty("text")
     public void setText(String text) {
         this.text = text;
     }
 
+    /**
+     * Message title template.
+     */
     @JsonProperty("title")
     public String getTitle() {
         return title;
     }
 
+    /**
+     * Message title template.
+     */
     @JsonProperty("title")
     public void setTitle(String title) {
         this.title = title;
     }
 
+    /**
+     * MSTeamsConfig configures notifications via Microsoft Teams. It requires Alertmanager &gt;= 0.26.0.
+     */
     @JsonProperty("webhookUrl")
     public SecretKeySelector getWebhookUrl() {
         return webhookUrl;
     }
 
+    /**
+     * MSTeamsConfig configures notifications via Microsoft Teams. It requires Alertmanager &gt;= 0.26.0.
+     */
     @JsonProperty("webhookUrl")
     public void setWebhookUrl(SecretKeySelector webhookUrl) {
         this.webhookUrl = webhookUrl;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/Matcher.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/Matcher.java
index 6c88415cb64..b14b28c72d1 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/Matcher.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/Matcher.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Matcher defines how to match on alert's labels.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public Matcher(String matchType, String name, String value) {
         this.value = value;
     }
 
+    /**
+     * Match operator, one of `=` (equal to), `!=` (not equal to), `=~` (regex match) or `!~` (not regex match). Negative operators (`!=` and `!~`) require Alertmanager &gt;= v0.22.0.
+     */
     @JsonProperty("matchType")
     public String getMatchType() {
         return matchType;
     }
 
+    /**
+     * Match operator, one of `=` (equal to), `!=` (not equal to), `=~` (regex match) or `!~` (not regex match). Negative operators (`!=` and `!~`) require Alertmanager &gt;= v0.22.0.
+     */
     @JsonProperty("matchType")
     public void setMatchType(String matchType) {
         this.matchType = matchType;
     }
 
+    /**
+     * Label to match.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Label to match.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Label value to match.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Label value to match.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/OpsGenieConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/OpsGenieConfig.java
index 540f6eda851..faf1a785615 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/OpsGenieConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/OpsGenieConfig.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OpsGenieConfig configures notifications via OpsGenie. See https://prometheus.io/docs/alerting/latest/configuration/#opsgenie_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -134,143 +137,227 @@ public OpsGenieConfig(String actions, SecretKeySelector apiKey, String apiURL, S
         this.tags = tags;
     }
 
+    /**
+     * Comma separated list of actions that will be available for the alert.
+     */
     @JsonProperty("actions")
     public String getActions() {
         return actions;
     }
 
+    /**
+     * Comma separated list of actions that will be available for the alert.
+     */
     @JsonProperty("actions")
     public void setActions(String actions) {
         this.actions = actions;
     }
 
+    /**
+     * OpsGenieConfig configures notifications via OpsGenie. See https://prometheus.io/docs/alerting/latest/configuration/#opsgenie_config
+     */
     @JsonProperty("apiKey")
     public SecretKeySelector getApiKey() {
         return apiKey;
     }
 
+    /**
+     * OpsGenieConfig configures notifications via OpsGenie. See https://prometheus.io/docs/alerting/latest/configuration/#opsgenie_config
+     */
     @JsonProperty("apiKey")
     public void setApiKey(SecretKeySelector apiKey) {
         this.apiKey = apiKey;
     }
 
+    /**
+     * The URL to send OpsGenie API requests to.
+     */
     @JsonProperty("apiURL")
     public String getApiURL() {
         return apiURL;
     }
 
+    /**
+     * The URL to send OpsGenie API requests to.
+     */
     @JsonProperty("apiURL")
     public void setApiURL(String apiURL) {
         this.apiURL = apiURL;
     }
 
+    /**
+     * Description of the incident.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description of the incident.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * A set of arbitrary key/value pairs that provide further detail about the incident.
+     */
     @JsonProperty("details")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<KeyValue> getDetails() {
         return details;
     }
 
+    /**
+     * A set of arbitrary key/value pairs that provide further detail about the incident.
+     */
     @JsonProperty("details")
     public void setDetails(List<KeyValue> details) {
         this.details = details;
     }
 
+    /**
+     * Optional field that can be used to specify which domain alert is related to.
+     */
     @JsonProperty("entity")
     public String getEntity() {
         return entity;
     }
 
+    /**
+     * Optional field that can be used to specify which domain alert is related to.
+     */
     @JsonProperty("entity")
     public void setEntity(String entity) {
         this.entity = entity;
     }
 
+    /**
+     * OpsGenieConfig configures notifications via OpsGenie. See https://prometheus.io/docs/alerting/latest/configuration/#opsgenie_config
+     */
     @JsonProperty("httpConfig")
     public HTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * OpsGenieConfig configures notifications via OpsGenie. See https://prometheus.io/docs/alerting/latest/configuration/#opsgenie_config
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(HTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * Alert text limited to 130 characters.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Alert text limited to 130 characters.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Additional alert note.
+     */
     @JsonProperty("note")
     public String getNote() {
         return note;
     }
 
+    /**
+     * Additional alert note.
+     */
     @JsonProperty("note")
     public void setNote(String note) {
         this.note = note;
     }
 
+    /**
+     * Priority level of alert. Possible values are P1, P2, P3, P4, and P5.
+     */
     @JsonProperty("priority")
     public String getPriority() {
         return priority;
     }
 
+    /**
+     * Priority level of alert. Possible values are P1, P2, P3, P4, and P5.
+     */
     @JsonProperty("priority")
     public void setPriority(String priority) {
         this.priority = priority;
     }
 
+    /**
+     * List of responders responsible for notifications.
+     */
     @JsonProperty("responders")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OpsGenieConfigResponder> getResponders() {
         return responders;
     }
 
+    /**
+     * List of responders responsible for notifications.
+     */
     @JsonProperty("responders")
     public void setResponders(List<OpsGenieConfigResponder> responders) {
         this.responders = responders;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public Boolean getSendResolved() {
         return sendResolved;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public void setSendResolved(Boolean sendResolved) {
         this.sendResolved = sendResolved;
     }
 
+    /**
+     * Backlink to the sender of the notification.
+     */
     @JsonProperty("source")
     public String getSource() {
         return source;
     }
 
+    /**
+     * Backlink to the sender of the notification.
+     */
     @JsonProperty("source")
     public void setSource(String source) {
         this.source = source;
     }
 
+    /**
+     * Comma separated list of tags attached to the notifications.
+     */
     @JsonProperty("tags")
     public String getTags() {
         return tags;
     }
 
+    /**
+     * Comma separated list of tags attached to the notifications.
+     */
     @JsonProperty("tags")
     public void setTags(String tags) {
         this.tags = tags;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/OpsGenieConfigResponder.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/OpsGenieConfigResponder.java
index 718b96cff28..f40e06fdf6f 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/OpsGenieConfigResponder.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/OpsGenieConfigResponder.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OpsGenieConfigResponder defines a responder to an incident. One of `id`, `name` or `username` has to be defined.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public OpsGenieConfigResponder(String id, String name, String type, String usern
         this.username = username;
     }
 
+    /**
+     * ID of the responder.
+     */
     @JsonProperty("id")
     public String getId() {
         return id;
     }
 
+    /**
+     * ID of the responder.
+     */
     @JsonProperty("id")
     public void setId(String id) {
         this.id = id;
     }
 
+    /**
+     * Name of the responder.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the responder.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Type of responder.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of responder.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * Username of the responder.
+     */
     @JsonProperty("username")
     public String getUsername() {
         return username;
     }
 
+    /**
+     * Username of the responder.
+     */
     @JsonProperty("username")
     public void setUsername(String username) {
         this.username = username;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/PagerDutyConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/PagerDutyConfig.java
index df44b719c80..f8ca17b6218 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/PagerDutyConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/PagerDutyConfig.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PagerDutyConfig configures notifications via PagerDuty. See https://prometheus.io/docs/alerting/latest/configuration/#pagerduty_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -143,164 +146,260 @@ public PagerDutyConfig(String className, String client, String clientURL, String
         this.url = url;
     }
 
+    /**
+     * The class/type of the event.
+     */
     @JsonProperty("class")
     public String getClassName() {
         return className;
     }
 
+    /**
+     * The class/type of the event.
+     */
     @JsonProperty("class")
     public void setClassName(String className) {
         this.className = className;
     }
 
+    /**
+     * Client identification.
+     */
     @JsonProperty("client")
     public String getClient() {
         return client;
     }
 
+    /**
+     * Client identification.
+     */
     @JsonProperty("client")
     public void setClient(String client) {
         this.client = client;
     }
 
+    /**
+     * Backlink to the sender of notification.
+     */
     @JsonProperty("clientURL")
     public String getClientURL() {
         return clientURL;
     }
 
+    /**
+     * Backlink to the sender of notification.
+     */
     @JsonProperty("clientURL")
     public void setClientURL(String clientURL) {
         this.clientURL = clientURL;
     }
 
+    /**
+     * The part or component of the affected system that is broken.
+     */
     @JsonProperty("component")
     public String getComponent() {
         return component;
     }
 
+    /**
+     * The part or component of the affected system that is broken.
+     */
     @JsonProperty("component")
     public void setComponent(String component) {
         this.component = component;
     }
 
+    /**
+     * Description of the incident.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description of the incident.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * Arbitrary key/value pairs that provide further detail about the incident.
+     */
     @JsonProperty("details")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<KeyValue> getDetails() {
         return details;
     }
 
+    /**
+     * Arbitrary key/value pairs that provide further detail about the incident.
+     */
     @JsonProperty("details")
     public void setDetails(List<KeyValue> details) {
         this.details = details;
     }
 
+    /**
+     * A cluster or grouping of sources.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * A cluster or grouping of sources.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * PagerDutyConfig configures notifications via PagerDuty. See https://prometheus.io/docs/alerting/latest/configuration/#pagerduty_config
+     */
     @JsonProperty("httpConfig")
     public HTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * PagerDutyConfig configures notifications via PagerDuty. See https://prometheus.io/docs/alerting/latest/configuration/#pagerduty_config
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(HTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * A list of image details to attach that provide further detail about an incident.
+     */
     @JsonProperty("pagerDutyImageConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PagerDutyImageConfig> getPagerDutyImageConfigs() {
         return pagerDutyImageConfigs;
     }
 
+    /**
+     * A list of image details to attach that provide further detail about an incident.
+     */
     @JsonProperty("pagerDutyImageConfigs")
     public void setPagerDutyImageConfigs(List<PagerDutyImageConfig> pagerDutyImageConfigs) {
         this.pagerDutyImageConfigs = pagerDutyImageConfigs;
     }
 
+    /**
+     * A list of link details to attach that provide further detail about an incident.
+     */
     @JsonProperty("pagerDutyLinkConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PagerDutyLinkConfig> getPagerDutyLinkConfigs() {
         return pagerDutyLinkConfigs;
     }
 
+    /**
+     * A list of link details to attach that provide further detail about an incident.
+     */
     @JsonProperty("pagerDutyLinkConfigs")
     public void setPagerDutyLinkConfigs(List<PagerDutyLinkConfig> pagerDutyLinkConfigs) {
         this.pagerDutyLinkConfigs = pagerDutyLinkConfigs;
     }
 
+    /**
+     * PagerDutyConfig configures notifications via PagerDuty. See https://prometheus.io/docs/alerting/latest/configuration/#pagerduty_config
+     */
     @JsonProperty("routingKey")
     public SecretKeySelector getRoutingKey() {
         return routingKey;
     }
 
+    /**
+     * PagerDutyConfig configures notifications via PagerDuty. See https://prometheus.io/docs/alerting/latest/configuration/#pagerduty_config
+     */
     @JsonProperty("routingKey")
     public void setRoutingKey(SecretKeySelector routingKey) {
         this.routingKey = routingKey;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public Boolean getSendResolved() {
         return sendResolved;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public void setSendResolved(Boolean sendResolved) {
         this.sendResolved = sendResolved;
     }
 
+    /**
+     * PagerDutyConfig configures notifications via PagerDuty. See https://prometheus.io/docs/alerting/latest/configuration/#pagerduty_config
+     */
     @JsonProperty("serviceKey")
     public SecretKeySelector getServiceKey() {
         return serviceKey;
     }
 
+    /**
+     * PagerDutyConfig configures notifications via PagerDuty. See https://prometheus.io/docs/alerting/latest/configuration/#pagerduty_config
+     */
     @JsonProperty("serviceKey")
     public void setServiceKey(SecretKeySelector serviceKey) {
         this.serviceKey = serviceKey;
     }
 
+    /**
+     * Severity of the incident.
+     */
     @JsonProperty("severity")
     public String getSeverity() {
         return severity;
     }
 
+    /**
+     * Severity of the incident.
+     */
     @JsonProperty("severity")
     public void setSeverity(String severity) {
         this.severity = severity;
     }
 
+    /**
+     * Unique location of the affected system.
+     */
     @JsonProperty("source")
     public String getSource() {
         return source;
     }
 
+    /**
+     * Unique location of the affected system.
+     */
     @JsonProperty("source")
     public void setSource(String source) {
         this.source = source;
     }
 
+    /**
+     * The URL to send requests to.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * The URL to send requests to.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/PagerDutyImageConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/PagerDutyImageConfig.java
index 35ad2651028..4ea56958474 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/PagerDutyImageConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/PagerDutyImageConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PagerDutyImageConfig attaches images to an incident
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public PagerDutyImageConfig(String alt, String href, String src) {
         this.src = src;
     }
 
+    /**
+     * Alt is the optional alternative text for the image.
+     */
     @JsonProperty("alt")
     public String getAlt() {
         return alt;
     }
 
+    /**
+     * Alt is the optional alternative text for the image.
+     */
     @JsonProperty("alt")
     public void setAlt(String alt) {
         this.alt = alt;
     }
 
+    /**
+     * Optional URL; makes the image a clickable link.
+     */
     @JsonProperty("href")
     public String getHref() {
         return href;
     }
 
+    /**
+     * Optional URL; makes the image a clickable link.
+     */
     @JsonProperty("href")
     public void setHref(String href) {
         this.href = href;
     }
 
+    /**
+     * Src of the image being attached to the incident
+     */
     @JsonProperty("src")
     public String getSrc() {
         return src;
     }
 
+    /**
+     * Src of the image being attached to the incident
+     */
     @JsonProperty("src")
     public void setSrc(String src) {
         this.src = src;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/PagerDutyLinkConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/PagerDutyLinkConfig.java
index 95ad84bffb0..f7c1061c37e 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/PagerDutyLinkConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/PagerDutyLinkConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PagerDutyLinkConfig attaches text links to an incident
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PagerDutyLinkConfig(String alt, String href) {
         this.href = href;
     }
 
+    /**
+     * Text that describes the purpose of the link, and can be used as the link's text.
+     */
     @JsonProperty("alt")
     public String getAlt() {
         return alt;
     }
 
+    /**
+     * Text that describes the purpose of the link, and can be used as the link's text.
+     */
     @JsonProperty("alt")
     public void setAlt(String alt) {
         this.alt = alt;
     }
 
+    /**
+     * Href is the URL of the link to be attached
+     */
     @JsonProperty("href")
     public String getHref() {
         return href;
     }
 
+    /**
+     * Href is the URL of the link to be attached
+     */
     @JsonProperty("href")
     public void setHref(String href) {
         this.href = href;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/ParsedRange.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/ParsedRange.java
index 54cdb861517..bffe5f1fa31 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/ParsedRange.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/ParsedRange.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ParsedRange is an integer representation of a range
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ParsedRange(Integer end, Integer start) {
         this.start = start;
     }
 
+    /**
+     * End of the range
+     */
     @JsonProperty("end")
     public Integer getEnd() {
         return end;
     }
 
+    /**
+     * End of the range
+     */
     @JsonProperty("end")
     public void setEnd(Integer end) {
         this.end = end;
     }
 
+    /**
+     * Start is the beginning of the range
+     */
     @JsonProperty("start")
     public Integer getStart() {
         return start;
     }
 
+    /**
+     * Start is the beginning of the range
+     */
     @JsonProperty("start")
     public void setStart(Integer start) {
         this.start = start;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/PushoverConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/PushoverConfig.java
index ed8084c7a8a..b97d52e3e4e 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/PushoverConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/PushoverConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PushoverConfig configures notifications via Pushover. See https://prometheus.io/docs/alerting/latest/configuration/#pushover_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -142,171 +145,273 @@ public PushoverConfig(String device, String expire, Boolean html, HTTPConfig htt
         this.userKeyFile = userKeyFile;
     }
 
+    /**
+     * The name of a device to send the notification to
+     */
     @JsonProperty("device")
     public String getDevice() {
         return device;
     }
 
+    /**
+     * The name of a device to send the notification to
+     */
     @JsonProperty("device")
     public void setDevice(String device) {
         this.device = device;
     }
 
+    /**
+     * How long your notification will continue to be retried for, unless the user acknowledges the notification.
+     */
     @JsonProperty("expire")
     public String getExpire() {
         return expire;
     }
 
+    /**
+     * How long your notification will continue to be retried for, unless the user acknowledges the notification.
+     */
     @JsonProperty("expire")
     public void setExpire(String expire) {
         this.expire = expire;
     }
 
+    /**
+     * Whether notification message is HTML or plain text.
+     */
     @JsonProperty("html")
     public Boolean getHtml() {
         return html;
     }
 
+    /**
+     * Whether notification message is HTML or plain text.
+     */
     @JsonProperty("html")
     public void setHtml(Boolean html) {
         this.html = html;
     }
 
+    /**
+     * PushoverConfig configures notifications via Pushover. See https://prometheus.io/docs/alerting/latest/configuration/#pushover_config
+     */
     @JsonProperty("httpConfig")
     public HTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * PushoverConfig configures notifications via Pushover. See https://prometheus.io/docs/alerting/latest/configuration/#pushover_config
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(HTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * Notification message.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Notification message.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Priority, see https://pushover.net/api#priority
+     */
     @JsonProperty("priority")
     public String getPriority() {
         return priority;
     }
 
+    /**
+     * Priority, see https://pushover.net/api#priority
+     */
     @JsonProperty("priority")
     public void setPriority(String priority) {
         this.priority = priority;
     }
 
+    /**
+     * How often the Pushover servers will send the same notification to the user. Must be at least 30 seconds.
+     */
     @JsonProperty("retry")
     public String getRetry() {
         return retry;
     }
 
+    /**
+     * How often the Pushover servers will send the same notification to the user. Must be at least 30 seconds.
+     */
     @JsonProperty("retry")
     public void setRetry(String retry) {
         this.retry = retry;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public Boolean getSendResolved() {
         return sendResolved;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public void setSendResolved(Boolean sendResolved) {
         this.sendResolved = sendResolved;
     }
 
+    /**
+     * The name of one of the sounds supported by device clients to override the user's default sound choice
+     */
     @JsonProperty("sound")
     public String getSound() {
         return sound;
     }
 
+    /**
+     * The name of one of the sounds supported by device clients to override the user's default sound choice
+     */
     @JsonProperty("sound")
     public void setSound(String sound) {
         this.sound = sound;
     }
 
+    /**
+     * Notification title.
+     */
     @JsonProperty("title")
     public String getTitle() {
         return title;
     }
 
+    /**
+     * Notification title.
+     */
     @JsonProperty("title")
     public void setTitle(String title) {
         this.title = title;
     }
 
+    /**
+     * PushoverConfig configures notifications via Pushover. See https://prometheus.io/docs/alerting/latest/configuration/#pushover_config
+     */
     @JsonProperty("token")
     public SecretKeySelector getToken() {
         return token;
     }
 
+    /**
+     * PushoverConfig configures notifications via Pushover. See https://prometheus.io/docs/alerting/latest/configuration/#pushover_config
+     */
     @JsonProperty("token")
     public void setToken(SecretKeySelector token) {
         this.token = token;
     }
 
+    /**
+     * The token file that contains the registered application's API token, see https://pushover.net/apps. Either `token` or `tokenFile` is required. It requires Alertmanager &gt;= v0.26.0.
+     */
     @JsonProperty("tokenFile")
     public String getTokenFile() {
         return tokenFile;
     }
 
+    /**
+     * The token file that contains the registered application's API token, see https://pushover.net/apps. Either `token` or `tokenFile` is required. It requires Alertmanager &gt;= v0.26.0.
+     */
     @JsonProperty("tokenFile")
     public void setTokenFile(String tokenFile) {
         this.tokenFile = tokenFile;
     }
 
+    /**
+     * The time to live definition for the alert notification
+     */
     @JsonProperty("ttl")
     public String getTtl() {
         return ttl;
     }
 
+    /**
+     * The time to live definition for the alert notification
+     */
     @JsonProperty("ttl")
     public void setTtl(String ttl) {
         this.ttl = ttl;
     }
 
+    /**
+     * A supplementary URL shown alongside the message.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * A supplementary URL shown alongside the message.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
     }
 
+    /**
+     * A title for supplementary URL, otherwise just the URL is shown
+     */
     @JsonProperty("urlTitle")
     public String getUrlTitle() {
         return urlTitle;
     }
 
+    /**
+     * A title for supplementary URL, otherwise just the URL is shown
+     */
     @JsonProperty("urlTitle")
     public void setUrlTitle(String urlTitle) {
         this.urlTitle = urlTitle;
     }
 
+    /**
+     * PushoverConfig configures notifications via Pushover. See https://prometheus.io/docs/alerting/latest/configuration/#pushover_config
+     */
     @JsonProperty("userKey")
     public SecretKeySelector getUserKey() {
         return userKey;
     }
 
+    /**
+     * PushoverConfig configures notifications via Pushover. See https://prometheus.io/docs/alerting/latest/configuration/#pushover_config
+     */
     @JsonProperty("userKey")
     public void setUserKey(SecretKeySelector userKey) {
         this.userKey = userKey;
     }
 
+    /**
+     * The user key file that contains the recipient user's user key. Either `userKey` or `userKeyFile` is required. It requires Alertmanager &gt;= v0.26.0.
+     */
     @JsonProperty("userKeyFile")
     public String getUserKeyFile() {
         return userKeyFile;
     }
 
+    /**
+     * The user key file that contains the recipient user's user key. Either `userKey` or `userKeyFile` is required. It requires Alertmanager &gt;= v0.26.0.
+     */
     @JsonProperty("userKeyFile")
     public void setUserKeyFile(String userKeyFile) {
         this.userKeyFile = userKeyFile;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/Receiver.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/Receiver.java
index 55d6ff92bcb..5b2b9be3949 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/Receiver.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/Receiver.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Receiver defines one or more notification integrations.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -145,154 +148,238 @@ public Receiver(List<DiscordConfig> discordConfigs, List<EmailConfig> emailConfi
         this.wechatConfigs = wechatConfigs;
     }
 
+    /**
+     * List of Slack configurations.
+     */
     @JsonProperty("discordConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DiscordConfig> getDiscordConfigs() {
         return discordConfigs;
     }
 
+    /**
+     * List of Slack configurations.
+     */
     @JsonProperty("discordConfigs")
     public void setDiscordConfigs(List<DiscordConfig> discordConfigs) {
         this.discordConfigs = discordConfigs;
     }
 
+    /**
+     * List of Email configurations.
+     */
     @JsonProperty("emailConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EmailConfig> getEmailConfigs() {
         return emailConfigs;
     }
 
+    /**
+     * List of Email configurations.
+     */
     @JsonProperty("emailConfigs")
     public void setEmailConfigs(List<EmailConfig> emailConfigs) {
         this.emailConfigs = emailConfigs;
     }
 
+    /**
+     * List of MSTeams configurations. It requires Alertmanager &gt;= 0.26.0.
+     */
     @JsonProperty("msteamsConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MSTeamsConfig> getMsteamsConfigs() {
         return msteamsConfigs;
     }
 
+    /**
+     * List of MSTeams configurations. It requires Alertmanager &gt;= 0.26.0.
+     */
     @JsonProperty("msteamsConfigs")
     public void setMsteamsConfigs(List<MSTeamsConfig> msteamsConfigs) {
         this.msteamsConfigs = msteamsConfigs;
     }
 
+    /**
+     * Name of the receiver. Must be unique across all items from the list.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the receiver. Must be unique across all items from the list.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * List of OpsGenie configurations.
+     */
     @JsonProperty("opsgenieConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OpsGenieConfig> getOpsgenieConfigs() {
         return opsgenieConfigs;
     }
 
+    /**
+     * List of OpsGenie configurations.
+     */
     @JsonProperty("opsgenieConfigs")
     public void setOpsgenieConfigs(List<OpsGenieConfig> opsgenieConfigs) {
         this.opsgenieConfigs = opsgenieConfigs;
     }
 
+    /**
+     * List of PagerDuty configurations.
+     */
     @JsonProperty("pagerdutyConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PagerDutyConfig> getPagerdutyConfigs() {
         return pagerdutyConfigs;
     }
 
+    /**
+     * List of PagerDuty configurations.
+     */
     @JsonProperty("pagerdutyConfigs")
     public void setPagerdutyConfigs(List<PagerDutyConfig> pagerdutyConfigs) {
         this.pagerdutyConfigs = pagerdutyConfigs;
     }
 
+    /**
+     * List of Pushover configurations.
+     */
     @JsonProperty("pushoverConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PushoverConfig> getPushoverConfigs() {
         return pushoverConfigs;
     }
 
+    /**
+     * List of Pushover configurations.
+     */
     @JsonProperty("pushoverConfigs")
     public void setPushoverConfigs(List<PushoverConfig> pushoverConfigs) {
         this.pushoverConfigs = pushoverConfigs;
     }
 
+    /**
+     * List of Slack configurations.
+     */
     @JsonProperty("slackConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SlackConfig> getSlackConfigs() {
         return slackConfigs;
     }
 
+    /**
+     * List of Slack configurations.
+     */
     @JsonProperty("slackConfigs")
     public void setSlackConfigs(List<SlackConfig> slackConfigs) {
         this.slackConfigs = slackConfigs;
     }
 
+    /**
+     * List of SNS configurations
+     */
     @JsonProperty("snsConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SNSConfig> getSnsConfigs() {
         return snsConfigs;
     }
 
+    /**
+     * List of SNS configurations
+     */
     @JsonProperty("snsConfigs")
     public void setSnsConfigs(List<SNSConfig> snsConfigs) {
         this.snsConfigs = snsConfigs;
     }
 
+    /**
+     * List of Telegram configurations.
+     */
     @JsonProperty("telegramConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TelegramConfig> getTelegramConfigs() {
         return telegramConfigs;
     }
 
+    /**
+     * List of Telegram configurations.
+     */
     @JsonProperty("telegramConfigs")
     public void setTelegramConfigs(List<TelegramConfig> telegramConfigs) {
         this.telegramConfigs = telegramConfigs;
     }
 
+    /**
+     * List of VictorOps configurations.
+     */
     @JsonProperty("victoropsConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VictorOpsConfig> getVictoropsConfigs() {
         return victoropsConfigs;
     }
 
+    /**
+     * List of VictorOps configurations.
+     */
     @JsonProperty("victoropsConfigs")
     public void setVictoropsConfigs(List<VictorOpsConfig> victoropsConfigs) {
         this.victoropsConfigs = victoropsConfigs;
     }
 
+    /**
+     * List of Webex configurations.
+     */
     @JsonProperty("webexConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WebexConfig> getWebexConfigs() {
         return webexConfigs;
     }
 
+    /**
+     * List of Webex configurations.
+     */
     @JsonProperty("webexConfigs")
     public void setWebexConfigs(List<WebexConfig> webexConfigs) {
         this.webexConfigs = webexConfigs;
     }
 
+    /**
+     * List of webhook configurations.
+     */
     @JsonProperty("webhookConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WebhookConfig> getWebhookConfigs() {
         return webhookConfigs;
     }
 
+    /**
+     * List of webhook configurations.
+     */
     @JsonProperty("webhookConfigs")
     public void setWebhookConfigs(List<WebhookConfig> webhookConfigs) {
         this.webhookConfigs = webhookConfigs;
     }
 
+    /**
+     * List of WeChat configurations.
+     */
     @JsonProperty("wechatConfigs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WeChatConfig> getWechatConfigs() {
         return wechatConfigs;
     }
 
+    /**
+     * List of WeChat configurations.
+     */
     @JsonProperty("wechatConfigs")
     public void setWechatConfigs(List<WeChatConfig> wechatConfigs) {
         this.wechatConfigs = wechatConfigs;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/Route.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/Route.java
index f374f3fa2f6..36bd4709928 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/Route.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/Route.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Route defines a node in the routing tree.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -122,106 +125,166 @@ public Route(List<String> activeTimeIntervals, Boolean _continue, List<String> g
         this.routes = routes;
     }
 
+    /**
+     * ActiveTimeIntervals is a list of TimeInterval names when this route should be active.
+     */
     @JsonProperty("activeTimeIntervals")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getActiveTimeIntervals() {
         return activeTimeIntervals;
     }
 
+    /**
+     * ActiveTimeIntervals is a list of TimeInterval names when this route should be active.
+     */
     @JsonProperty("activeTimeIntervals")
     public void setActiveTimeIntervals(List<String> activeTimeIntervals) {
         this.activeTimeIntervals = activeTimeIntervals;
     }
 
+    /**
+     * Boolean indicating whether an alert should continue matching subsequent sibling nodes. It will always be overridden to true for the first-level route by the Prometheus operator.
+     */
     @JsonProperty("continue")
     public Boolean getContinue() {
         return _continue;
     }
 
+    /**
+     * Boolean indicating whether an alert should continue matching subsequent sibling nodes. It will always be overridden to true for the first-level route by the Prometheus operator.
+     */
     @JsonProperty("continue")
     public void setContinue(Boolean _continue) {
         this._continue = _continue;
     }
 
+    /**
+     * List of labels to group by. Labels must not be repeated (unique list). Special label "..." (aggregate by all possible labels), if provided, must be the only element in the list.
+     */
     @JsonProperty("groupBy")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getGroupBy() {
         return groupBy;
     }
 
+    /**
+     * List of labels to group by. Labels must not be repeated (unique list). Special label "..." (aggregate by all possible labels), if provided, must be the only element in the list.
+     */
     @JsonProperty("groupBy")
     public void setGroupBy(List<String> groupBy) {
         this.groupBy = groupBy;
     }
 
+    /**
+     * How long to wait before sending an updated notification. Must match the regular expression`^(([0-9]+)y)?(([0-9]+)w)?(([0-9]+)d)?(([0-9]+)h)?(([0-9]+)m)?(([0-9]+)s)?(([0-9]+)ms)?$` Example: "5m"
+     */
     @JsonProperty("groupInterval")
     public String getGroupInterval() {
         return groupInterval;
     }
 
+    /**
+     * How long to wait before sending an updated notification. Must match the regular expression`^(([0-9]+)y)?(([0-9]+)w)?(([0-9]+)d)?(([0-9]+)h)?(([0-9]+)m)?(([0-9]+)s)?(([0-9]+)ms)?$` Example: "5m"
+     */
     @JsonProperty("groupInterval")
     public void setGroupInterval(String groupInterval) {
         this.groupInterval = groupInterval;
     }
 
+    /**
+     * How long to wait before sending the initial notification. Must match the regular expression`^(([0-9]+)y)?(([0-9]+)w)?(([0-9]+)d)?(([0-9]+)h)?(([0-9]+)m)?(([0-9]+)s)?(([0-9]+)ms)?$` Example: "30s"
+     */
     @JsonProperty("groupWait")
     public String getGroupWait() {
         return groupWait;
     }
 
+    /**
+     * How long to wait before sending the initial notification. Must match the regular expression`^(([0-9]+)y)?(([0-9]+)w)?(([0-9]+)d)?(([0-9]+)h)?(([0-9]+)m)?(([0-9]+)s)?(([0-9]+)ms)?$` Example: "30s"
+     */
     @JsonProperty("groupWait")
     public void setGroupWait(String groupWait) {
         this.groupWait = groupWait;
     }
 
+    /**
+     * List of matchers that the alert's labels should match. For the first level route, the operator removes any existing equality and regexp matcher on the `namespace` label and adds a `namespace: &lt;object namespace&gt;` matcher.
+     */
     @JsonProperty("matchers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Matcher> getMatchers() {
         return matchers;
     }
 
+    /**
+     * List of matchers that the alert's labels should match. For the first level route, the operator removes any existing equality and regexp matcher on the `namespace` label and adds a `namespace: &lt;object namespace&gt;` matcher.
+     */
     @JsonProperty("matchers")
     public void setMatchers(List<Matcher> matchers) {
         this.matchers = matchers;
     }
 
+    /**
+     * Note: this comment applies to the field definition above but appears below otherwise it gets included in the generated manifest. CRD schema doesn't support self-referential types for now (see https://github.com/kubernetes/kubernetes/issues/62872). We have to use an alternative type to circumvent the limitation. The downside is that the Kube API can't validate the data beyond the fact that it is a valid JSON representation. MuteTimeIntervals is a list of TimeInterval names that will mute this route when matched.
+     */
     @JsonProperty("muteTimeIntervals")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMuteTimeIntervals() {
         return muteTimeIntervals;
     }
 
+    /**
+     * Note: this comment applies to the field definition above but appears below otherwise it gets included in the generated manifest. CRD schema doesn't support self-referential types for now (see https://github.com/kubernetes/kubernetes/issues/62872). We have to use an alternative type to circumvent the limitation. The downside is that the Kube API can't validate the data beyond the fact that it is a valid JSON representation. MuteTimeIntervals is a list of TimeInterval names that will mute this route when matched.
+     */
     @JsonProperty("muteTimeIntervals")
     public void setMuteTimeIntervals(List<String> muteTimeIntervals) {
         this.muteTimeIntervals = muteTimeIntervals;
     }
 
+    /**
+     * Name of the receiver for this route. If not empty, it should be listed in the `receivers` field.
+     */
     @JsonProperty("receiver")
     public String getReceiver() {
         return receiver;
     }
 
+    /**
+     * Name of the receiver for this route. If not empty, it should be listed in the `receivers` field.
+     */
     @JsonProperty("receiver")
     public void setReceiver(String receiver) {
         this.receiver = receiver;
     }
 
+    /**
+     * How long to wait before repeating the last notification. Must match the regular expression`^(([0-9]+)y)?(([0-9]+)w)?(([0-9]+)d)?(([0-9]+)h)?(([0-9]+)m)?(([0-9]+)s)?(([0-9]+)ms)?$` Example: "4h"
+     */
     @JsonProperty("repeatInterval")
     public String getRepeatInterval() {
         return repeatInterval;
     }
 
+    /**
+     * How long to wait before repeating the last notification. Must match the regular expression`^(([0-9]+)y)?(([0-9]+)w)?(([0-9]+)d)?(([0-9]+)h)?(([0-9]+)m)?(([0-9]+)s)?(([0-9]+)ms)?$` Example: "4h"
+     */
     @JsonProperty("repeatInterval")
     public void setRepeatInterval(String repeatInterval) {
         this.repeatInterval = repeatInterval;
     }
 
+    /**
+     * Child routes.
+     */
     @JsonProperty("routes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<JsonNode> getRoutes() {
         return routes;
     }
 
+    /**
+     * Child routes.
+     */
     @JsonProperty("routes")
     public void setRoutes(List<JsonNode> routes) {
         this.routes = routes;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/SNSConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/SNSConfig.java
index ad58860bede..2595e65e953 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/SNSConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/SNSConfig.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SNSConfig configures notifications via AWS SNS. See https://prometheus.io/docs/alerting/latest/configuration/#sns_configs
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -116,102 +119,162 @@ public SNSConfig(String apiURL, Map<String, String> attributes, HTTPConfig httpC
         this.topicARN = topicARN;
     }
 
+    /**
+     * The SNS API URL i.e. https://sns.us-east-2.amazonaws.com. If not specified, the SNS API URL from the SNS SDK will be used.
+     */
     @JsonProperty("apiURL")
     public String getApiURL() {
         return apiURL;
     }
 
+    /**
+     * The SNS API URL i.e. https://sns.us-east-2.amazonaws.com. If not specified, the SNS API URL from the SNS SDK will be used.
+     */
     @JsonProperty("apiURL")
     public void setApiURL(String apiURL) {
         this.apiURL = apiURL;
     }
 
+    /**
+     * SNS message attributes.
+     */
     @JsonProperty("attributes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAttributes() {
         return attributes;
     }
 
+    /**
+     * SNS message attributes.
+     */
     @JsonProperty("attributes")
     public void setAttributes(Map<String, String> attributes) {
         this.attributes = attributes;
     }
 
+    /**
+     * SNSConfig configures notifications via AWS SNS. See https://prometheus.io/docs/alerting/latest/configuration/#sns_configs
+     */
     @JsonProperty("httpConfig")
     public HTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * SNSConfig configures notifications via AWS SNS. See https://prometheus.io/docs/alerting/latest/configuration/#sns_configs
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(HTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * The message content of the SNS notification.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * The message content of the SNS notification.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Phone number if message is delivered via SMS in E.164 format. If you don't specify this value, you must specify a value for the TopicARN or TargetARN.
+     */
     @JsonProperty("phoneNumber")
     public String getPhoneNumber() {
         return phoneNumber;
     }
 
+    /**
+     * Phone number if message is delivered via SMS in E.164 format. If you don't specify this value, you must specify a value for the TopicARN or TargetARN.
+     */
     @JsonProperty("phoneNumber")
     public void setPhoneNumber(String phoneNumber) {
         this.phoneNumber = phoneNumber;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public Boolean getSendResolved() {
         return sendResolved;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public void setSendResolved(Boolean sendResolved) {
         this.sendResolved = sendResolved;
     }
 
+    /**
+     * SNSConfig configures notifications via AWS SNS. See https://prometheus.io/docs/alerting/latest/configuration/#sns_configs
+     */
     @JsonProperty("sigv4")
     public Sigv4 getSigv4() {
         return sigv4;
     }
 
+    /**
+     * SNSConfig configures notifications via AWS SNS. See https://prometheus.io/docs/alerting/latest/configuration/#sns_configs
+     */
     @JsonProperty("sigv4")
     public void setSigv4(Sigv4 sigv4) {
         this.sigv4 = sigv4;
     }
 
+    /**
+     * Subject line when the message is delivered to email endpoints.
+     */
     @JsonProperty("subject")
     public String getSubject() {
         return subject;
     }
 
+    /**
+     * Subject line when the message is delivered to email endpoints.
+     */
     @JsonProperty("subject")
     public void setSubject(String subject) {
         this.subject = subject;
     }
 
+    /**
+     * The  mobile platform endpoint ARN if message is delivered via mobile notifications. If you don't specify this value, you must specify a value for the topic_arn or PhoneNumber.
+     */
     @JsonProperty("targetARN")
     public String getTargetARN() {
         return targetARN;
     }
 
+    /**
+     * The  mobile platform endpoint ARN if message is delivered via mobile notifications. If you don't specify this value, you must specify a value for the topic_arn or PhoneNumber.
+     */
     @JsonProperty("targetARN")
     public void setTargetARN(String targetARN) {
         this.targetARN = targetARN;
     }
 
+    /**
+     * SNS topic ARN, i.e. arn:aws:sns:us-east-2:698519295917:My-Topic If you don't specify this value, you must specify a value for the PhoneNumber or TargetARN.
+     */
     @JsonProperty("topicARN")
     public String getTopicARN() {
         return topicARN;
     }
 
+    /**
+     * SNS topic ARN, i.e. arn:aws:sns:us-east-2:698519295917:My-Topic If you don't specify this value, you must specify a value for the PhoneNumber or TargetARN.
+     */
     @JsonProperty("topicARN")
     public void setTopicARN(String topicARN) {
         this.topicARN = topicARN;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/SecretKeySelector.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/SecretKeySelector.java
index 213ce2075fa..73f7de4161b 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/SecretKeySelector.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/SecretKeySelector.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SecretKeySelector selects a key of a Secret.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public SecretKeySelector(String key, String name) {
         this.name = name;
     }
 
+    /**
+     * The key of the secret to select from.  Must be a valid secret key.
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * The key of the secret to select from.  Must be a valid secret key.
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * The name of the secret in the object's namespace to select from.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The name of the secret in the object's namespace to select from.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/SlackAction.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/SlackAction.java
index 4b4758efad6..7ef8b57e02b 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/SlackAction.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/SlackAction.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,71 +105,113 @@ public SlackAction(SlackConfirmationField confirm, String name, String style, St
         this.value = value;
     }
 
+    /**
+     * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+     */
     @JsonProperty("confirm")
     public SlackConfirmationField getConfirm() {
         return confirm;
     }
 
+    /**
+     * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+     */
     @JsonProperty("confirm")
     public void setConfirm(SlackConfirmationField confirm) {
         this.confirm = confirm;
     }
 
+    /**
+     * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+     */
     @JsonProperty("style")
     public String getStyle() {
         return style;
     }
 
+    /**
+     * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+     */
     @JsonProperty("style")
     public void setStyle(String style) {
         this.style = style;
     }
 
+    /**
+     * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+     */
     @JsonProperty("text")
     public String getText() {
         return text;
     }
 
+    /**
+     * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+     */
     @JsonProperty("text")
     public void setText(String text) {
         this.text = text;
     }
 
+    /**
+     * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
     }
 
+    /**
+     * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * SlackAction configures a single Slack action that is sent with each notification. See https://api.slack.com/docs/message-attachments#action_fields and https://api.slack.com/docs/message-buttons for more information.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/SlackConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/SlackConfig.java
index d57ac386f1e..f1eaaf61b7a 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/SlackConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/SlackConfig.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -167,224 +170,356 @@ public SlackConfig(List<SlackAction> actions, SecretKeySelector apiURL, String c
         this.username = username;
     }
 
+    /**
+     * A list of Slack actions that are sent with each notification.
+     */
     @JsonProperty("actions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SlackAction> getActions() {
         return actions;
     }
 
+    /**
+     * A list of Slack actions that are sent with each notification.
+     */
     @JsonProperty("actions")
     public void setActions(List<SlackAction> actions) {
         this.actions = actions;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("apiURL")
     public SecretKeySelector getApiURL() {
         return apiURL;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("apiURL")
     public void setApiURL(SecretKeySelector apiURL) {
         this.apiURL = apiURL;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("callbackId")
     public String getCallbackId() {
         return callbackId;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("callbackId")
     public void setCallbackId(String callbackId) {
         this.callbackId = callbackId;
     }
 
+    /**
+     * The channel or user to send notifications to.
+     */
     @JsonProperty("channel")
     public String getChannel() {
         return channel;
     }
 
+    /**
+     * The channel or user to send notifications to.
+     */
     @JsonProperty("channel")
     public void setChannel(String channel) {
         this.channel = channel;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("color")
     public String getColor() {
         return color;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("color")
     public void setColor(String color) {
         this.color = color;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("fallback")
     public String getFallback() {
         return fallback;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("fallback")
     public void setFallback(String fallback) {
         this.fallback = fallback;
     }
 
+    /**
+     * A list of Slack fields that are sent with each notification.
+     */
     @JsonProperty("fields")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SlackField> getFields() {
         return fields;
     }
 
+    /**
+     * A list of Slack fields that are sent with each notification.
+     */
     @JsonProperty("fields")
     public void setFields(List<SlackField> fields) {
         this.fields = fields;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("footer")
     public String getFooter() {
         return footer;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("footer")
     public void setFooter(String footer) {
         this.footer = footer;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("httpConfig")
     public HTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(HTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("iconEmoji")
     public String getIconEmoji() {
         return iconEmoji;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("iconEmoji")
     public void setIconEmoji(String iconEmoji) {
         this.iconEmoji = iconEmoji;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("iconURL")
     public String getIconURL() {
         return iconURL;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("iconURL")
     public void setIconURL(String iconURL) {
         this.iconURL = iconURL;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("imageURL")
     public String getImageURL() {
         return imageURL;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("imageURL")
     public void setImageURL(String imageURL) {
         this.imageURL = imageURL;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("linkNames")
     public Boolean getLinkNames() {
         return linkNames;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("linkNames")
     public void setLinkNames(Boolean linkNames) {
         this.linkNames = linkNames;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("mrkdwnIn")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMrkdwnIn() {
         return mrkdwnIn;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("mrkdwnIn")
     public void setMrkdwnIn(List<String> mrkdwnIn) {
         this.mrkdwnIn = mrkdwnIn;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("pretext")
     public String getPretext() {
         return pretext;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("pretext")
     public void setPretext(String pretext) {
         this.pretext = pretext;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public Boolean getSendResolved() {
         return sendResolved;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public void setSendResolved(Boolean sendResolved) {
         this.sendResolved = sendResolved;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("shortFields")
     public Boolean getShortFields() {
         return shortFields;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("shortFields")
     public void setShortFields(Boolean shortFields) {
         this.shortFields = shortFields;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("text")
     public String getText() {
         return text;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("text")
     public void setText(String text) {
         this.text = text;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("thumbURL")
     public String getThumbURL() {
         return thumbURL;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("thumbURL")
     public void setThumbURL(String thumbURL) {
         this.thumbURL = thumbURL;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("title")
     public String getTitle() {
         return title;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("title")
     public void setTitle(String title) {
         this.title = title;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("titleLink")
     public String getTitleLink() {
         return titleLink;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("titleLink")
     public void setTitleLink(String titleLink) {
         this.titleLink = titleLink;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("username")
     public String getUsername() {
         return username;
     }
 
+    /**
+     * SlackConfig configures notifications via Slack. See https://prometheus.io/docs/alerting/latest/configuration/#slack_config
+     */
     @JsonProperty("username")
     public void setUsername(String username) {
         this.username = username;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/SlackConfirmationField.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/SlackConfirmationField.java
index 2b1f8a93c71..08ec3be36f8 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/SlackConfirmationField.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/SlackConfirmationField.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SlackConfirmationField protect users from destructive actions or particularly distinguished decisions by asking them to confirm their button click one more time. See https://api.slack.com/docs/interactive-message-field-guide#confirmation_fields for more information.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public SlackConfirmationField(String dismissText, String okText, String text, St
         this.title = title;
     }
 
+    /**
+     * SlackConfirmationField protect users from destructive actions or particularly distinguished decisions by asking them to confirm their button click one more time. See https://api.slack.com/docs/interactive-message-field-guide#confirmation_fields for more information.
+     */
     @JsonProperty("dismissText")
     public String getDismissText() {
         return dismissText;
     }
 
+    /**
+     * SlackConfirmationField protect users from destructive actions or particularly distinguished decisions by asking them to confirm their button click one more time. See https://api.slack.com/docs/interactive-message-field-guide#confirmation_fields for more information.
+     */
     @JsonProperty("dismissText")
     public void setDismissText(String dismissText) {
         this.dismissText = dismissText;
     }
 
+    /**
+     * SlackConfirmationField protect users from destructive actions or particularly distinguished decisions by asking them to confirm their button click one more time. See https://api.slack.com/docs/interactive-message-field-guide#confirmation_fields for more information.
+     */
     @JsonProperty("okText")
     public String getOkText() {
         return okText;
     }
 
+    /**
+     * SlackConfirmationField protect users from destructive actions or particularly distinguished decisions by asking them to confirm their button click one more time. See https://api.slack.com/docs/interactive-message-field-guide#confirmation_fields for more information.
+     */
     @JsonProperty("okText")
     public void setOkText(String okText) {
         this.okText = okText;
     }
 
+    /**
+     * SlackConfirmationField protect users from destructive actions or particularly distinguished decisions by asking them to confirm their button click one more time. See https://api.slack.com/docs/interactive-message-field-guide#confirmation_fields for more information.
+     */
     @JsonProperty("text")
     public String getText() {
         return text;
     }
 
+    /**
+     * SlackConfirmationField protect users from destructive actions or particularly distinguished decisions by asking them to confirm their button click one more time. See https://api.slack.com/docs/interactive-message-field-guide#confirmation_fields for more information.
+     */
     @JsonProperty("text")
     public void setText(String text) {
         this.text = text;
     }
 
+    /**
+     * SlackConfirmationField protect users from destructive actions or particularly distinguished decisions by asking them to confirm their button click one more time. See https://api.slack.com/docs/interactive-message-field-guide#confirmation_fields for more information.
+     */
     @JsonProperty("title")
     public String getTitle() {
         return title;
     }
 
+    /**
+     * SlackConfirmationField protect users from destructive actions or particularly distinguished decisions by asking them to confirm their button click one more time. See https://api.slack.com/docs/interactive-message-field-guide#confirmation_fields for more information.
+     */
     @JsonProperty("title")
     public void setTitle(String title) {
         this.title = title;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/SlackField.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/SlackField.java
index 5b4ef7feddf..76ee4f025dc 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/SlackField.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/SlackField.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SlackField configures a single Slack field that is sent with each notification. Each field must contain a title, value, and optionally, a boolean value to indicate if the field is short enough to be displayed next to other fields designated as short. See https://api.slack.com/docs/message-attachments#fields for more information.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public SlackField(Boolean _short, String title, String value) {
         this.value = value;
     }
 
+    /**
+     * SlackField configures a single Slack field that is sent with each notification. Each field must contain a title, value, and optionally, a boolean value to indicate if the field is short enough to be displayed next to other fields designated as short. See https://api.slack.com/docs/message-attachments#fields for more information.
+     */
     @JsonProperty("short")
     public Boolean getShort() {
         return _short;
     }
 
+    /**
+     * SlackField configures a single Slack field that is sent with each notification. Each field must contain a title, value, and optionally, a boolean value to indicate if the field is short enough to be displayed next to other fields designated as short. See https://api.slack.com/docs/message-attachments#fields for more information.
+     */
     @JsonProperty("short")
     public void setShort(Boolean _short) {
         this._short = _short;
     }
 
+    /**
+     * SlackField configures a single Slack field that is sent with each notification. Each field must contain a title, value, and optionally, a boolean value to indicate if the field is short enough to be displayed next to other fields designated as short. See https://api.slack.com/docs/message-attachments#fields for more information.
+     */
     @JsonProperty("title")
     public String getTitle() {
         return title;
     }
 
+    /**
+     * SlackField configures a single Slack field that is sent with each notification. Each field must contain a title, value, and optionally, a boolean value to indicate if the field is short enough to be displayed next to other fields designated as short. See https://api.slack.com/docs/message-attachments#fields for more information.
+     */
     @JsonProperty("title")
     public void setTitle(String title) {
         this.title = title;
     }
 
+    /**
+     * SlackField configures a single Slack field that is sent with each notification. Each field must contain a title, value, and optionally, a boolean value to indicate if the field is short enough to be displayed next to other fields designated as short. See https://api.slack.com/docs/message-attachments#fields for more information.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * SlackField configures a single Slack field that is sent with each notification. Each field must contain a title, value, and optionally, a boolean value to indicate if the field is short enough to be displayed next to other fields designated as short. See https://api.slack.com/docs/message-attachments#fields for more information.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/TelegramConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/TelegramConfig.java
index a9096d0beb1..96b249fe155 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/TelegramConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/TelegramConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TelegramConfig configures notifications via Telegram. See https://prometheus.io/docs/alerting/latest/configuration/#telegram_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -114,101 +117,161 @@ public TelegramConfig(String apiURL, SecretKeySelector botToken, String botToken
         this.sendResolved = sendResolved;
     }
 
+    /**
+     * The Telegram API URL i.e. https://api.telegram.org. If not specified, default API URL will be used.
+     */
     @JsonProperty("apiURL")
     public String getApiURL() {
         return apiURL;
     }
 
+    /**
+     * The Telegram API URL i.e. https://api.telegram.org. If not specified, default API URL will be used.
+     */
     @JsonProperty("apiURL")
     public void setApiURL(String apiURL) {
         this.apiURL = apiURL;
     }
 
+    /**
+     * TelegramConfig configures notifications via Telegram. See https://prometheus.io/docs/alerting/latest/configuration/#telegram_config
+     */
     @JsonProperty("botToken")
     public SecretKeySelector getBotToken() {
         return botToken;
     }
 
+    /**
+     * TelegramConfig configures notifications via Telegram. See https://prometheus.io/docs/alerting/latest/configuration/#telegram_config
+     */
     @JsonProperty("botToken")
     public void setBotToken(SecretKeySelector botToken) {
         this.botToken = botToken;
     }
 
+    /**
+     * File to read the Telegram bot token from. It is mutually exclusive with `botToken`. Either `botToken` or `botTokenFile` is required.<br><p> <br><p> It requires Alertmanager &gt;= v0.26.0.
+     */
     @JsonProperty("botTokenFile")
     public String getBotTokenFile() {
         return botTokenFile;
     }
 
+    /**
+     * File to read the Telegram bot token from. It is mutually exclusive with `botToken`. Either `botToken` or `botTokenFile` is required.<br><p> <br><p> It requires Alertmanager &gt;= v0.26.0.
+     */
     @JsonProperty("botTokenFile")
     public void setBotTokenFile(String botTokenFile) {
         this.botTokenFile = botTokenFile;
     }
 
+    /**
+     * The Telegram chat ID.
+     */
     @JsonProperty("chatID")
     public Long getChatID() {
         return chatID;
     }
 
+    /**
+     * The Telegram chat ID.
+     */
     @JsonProperty("chatID")
     public void setChatID(Long chatID) {
         this.chatID = chatID;
     }
 
+    /**
+     * Disable telegram notifications
+     */
     @JsonProperty("disableNotifications")
     public Boolean getDisableNotifications() {
         return disableNotifications;
     }
 
+    /**
+     * Disable telegram notifications
+     */
     @JsonProperty("disableNotifications")
     public void setDisableNotifications(Boolean disableNotifications) {
         this.disableNotifications = disableNotifications;
     }
 
+    /**
+     * TelegramConfig configures notifications via Telegram. See https://prometheus.io/docs/alerting/latest/configuration/#telegram_config
+     */
     @JsonProperty("httpConfig")
     public HTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * TelegramConfig configures notifications via Telegram. See https://prometheus.io/docs/alerting/latest/configuration/#telegram_config
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(HTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * Message template
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message template
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * The Telegram Group Topic ID. It requires Alertmanager &gt;= 0.26.0.
+     */
     @JsonProperty("messageThreadID")
     public Long getMessageThreadID() {
         return messageThreadID;
     }
 
+    /**
+     * The Telegram Group Topic ID. It requires Alertmanager &gt;= 0.26.0.
+     */
     @JsonProperty("messageThreadID")
     public void setMessageThreadID(Long messageThreadID) {
         this.messageThreadID = messageThreadID;
     }
 
+    /**
+     * Parse mode for telegram message
+     */
     @JsonProperty("parseMode")
     public String getParseMode() {
         return parseMode;
     }
 
+    /**
+     * Parse mode for telegram message
+     */
     @JsonProperty("parseMode")
     public void setParseMode(String parseMode) {
         this.parseMode = parseMode;
     }
 
+    /**
+     * Whether to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public Boolean getSendResolved() {
         return sendResolved;
     }
 
+    /**
+     * Whether to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public void setSendResolved(Boolean sendResolved) {
         this.sendResolved = sendResolved;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/TimeInterval.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/TimeInterval.java
index 40d4671c3b1..fd3352d42fc 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/TimeInterval.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/TimeInterval.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TimeInterval specifies the periods in time when notifications will be muted or active.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public TimeInterval(String name, List<TimePeriod> timeIntervals) {
         this.timeIntervals = timeIntervals;
     }
 
+    /**
+     * Name of the time interval.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the time interval.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * TimeIntervals is a list of TimePeriod.
+     */
     @JsonProperty("timeIntervals")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TimePeriod> getTimeIntervals() {
         return timeIntervals;
     }
 
+    /**
+     * TimeIntervals is a list of TimePeriod.
+     */
     @JsonProperty("timeIntervals")
     public void setTimeIntervals(List<TimePeriod> timeIntervals) {
         this.timeIntervals = timeIntervals;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/TimePeriod.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/TimePeriod.java
index 4346f3062db..62118fad872 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/TimePeriod.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/TimePeriod.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TimePeriod describes periods of time.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,56 +104,86 @@ public TimePeriod(List<DayOfMonthRange> daysOfMonth, List<String> months, List<T
         this.years = years;
     }
 
+    /**
+     * DaysOfMonth is a list of DayOfMonthRange
+     */
     @JsonProperty("daysOfMonth")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DayOfMonthRange> getDaysOfMonth() {
         return daysOfMonth;
     }
 
+    /**
+     * DaysOfMonth is a list of DayOfMonthRange
+     */
     @JsonProperty("daysOfMonth")
     public void setDaysOfMonth(List<DayOfMonthRange> daysOfMonth) {
         this.daysOfMonth = daysOfMonth;
     }
 
+    /**
+     * Months is a list of MonthRange
+     */
     @JsonProperty("months")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMonths() {
         return months;
     }
 
+    /**
+     * Months is a list of MonthRange
+     */
     @JsonProperty("months")
     public void setMonths(List<String> months) {
         this.months = months;
     }
 
+    /**
+     * Times is a list of TimeRange
+     */
     @JsonProperty("times")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TimeRange> getTimes() {
         return times;
     }
 
+    /**
+     * Times is a list of TimeRange
+     */
     @JsonProperty("times")
     public void setTimes(List<TimeRange> times) {
         this.times = times;
     }
 
+    /**
+     * Weekdays is a list of WeekdayRange
+     */
     @JsonProperty("weekdays")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getWeekdays() {
         return weekdays;
     }
 
+    /**
+     * Weekdays is a list of WeekdayRange
+     */
     @JsonProperty("weekdays")
     public void setWeekdays(List<String> weekdays) {
         this.weekdays = weekdays;
     }
 
+    /**
+     * Years is a list of YearRange
+     */
     @JsonProperty("years")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getYears() {
         return years;
     }
 
+    /**
+     * Years is a list of YearRange
+     */
     @JsonProperty("years")
     public void setYears(List<String> years) {
         this.years = years;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/TimeRange.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/TimeRange.java
index 2174fab1cd1..5f806a46c58 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/TimeRange.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/TimeRange.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TimeRange defines a start and end time in 24hr format
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public TimeRange(String endTime, String startTime) {
         this.startTime = startTime;
     }
 
+    /**
+     * EndTime is the end time in 24hr format.
+     */
     @JsonProperty("endTime")
     public String getEndTime() {
         return endTime;
     }
 
+    /**
+     * EndTime is the end time in 24hr format.
+     */
     @JsonProperty("endTime")
     public void setEndTime(String endTime) {
         this.endTime = endTime;
     }
 
+    /**
+     * StartTime is the start time in 24hr format.
+     */
     @JsonProperty("startTime")
     public String getStartTime() {
         return startTime;
     }
 
+    /**
+     * StartTime is the start time in 24hr format.
+     */
     @JsonProperty("startTime")
     public void setStartTime(String startTime) {
         this.startTime = startTime;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/VictorOpsConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/VictorOpsConfig.java
index edf22d4312d..40ab781b6e0 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/VictorOpsConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/VictorOpsConfig.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VictorOpsConfig configures notifications via VictorOps. See https://prometheus.io/docs/alerting/latest/configuration/#victorops_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -117,102 +120,162 @@ public VictorOpsConfig(SecretKeySelector apiKey, String apiUrl, List<KeyValue> c
         this.stateMessage = stateMessage;
     }
 
+    /**
+     * VictorOpsConfig configures notifications via VictorOps. See https://prometheus.io/docs/alerting/latest/configuration/#victorops_config
+     */
     @JsonProperty("apiKey")
     public SecretKeySelector getApiKey() {
         return apiKey;
     }
 
+    /**
+     * VictorOpsConfig configures notifications via VictorOps. See https://prometheus.io/docs/alerting/latest/configuration/#victorops_config
+     */
     @JsonProperty("apiKey")
     public void setApiKey(SecretKeySelector apiKey) {
         this.apiKey = apiKey;
     }
 
+    /**
+     * The VictorOps API URL.
+     */
     @JsonProperty("apiUrl")
     public String getApiUrl() {
         return apiUrl;
     }
 
+    /**
+     * The VictorOps API URL.
+     */
     @JsonProperty("apiUrl")
     public void setApiUrl(String apiUrl) {
         this.apiUrl = apiUrl;
     }
 
+    /**
+     * Additional custom fields for notification.
+     */
     @JsonProperty("customFields")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<KeyValue> getCustomFields() {
         return customFields;
     }
 
+    /**
+     * Additional custom fields for notification.
+     */
     @JsonProperty("customFields")
     public void setCustomFields(List<KeyValue> customFields) {
         this.customFields = customFields;
     }
 
+    /**
+     * Contains summary of the alerted problem.
+     */
     @JsonProperty("entityDisplayName")
     public String getEntityDisplayName() {
         return entityDisplayName;
     }
 
+    /**
+     * Contains summary of the alerted problem.
+     */
     @JsonProperty("entityDisplayName")
     public void setEntityDisplayName(String entityDisplayName) {
         this.entityDisplayName = entityDisplayName;
     }
 
+    /**
+     * VictorOpsConfig configures notifications via VictorOps. See https://prometheus.io/docs/alerting/latest/configuration/#victorops_config
+     */
     @JsonProperty("httpConfig")
     public HTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * VictorOpsConfig configures notifications via VictorOps. See https://prometheus.io/docs/alerting/latest/configuration/#victorops_config
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(HTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * Describes the behavior of the alert (CRITICAL, WARNING, INFO).
+     */
     @JsonProperty("messageType")
     public String getMessageType() {
         return messageType;
     }
 
+    /**
+     * Describes the behavior of the alert (CRITICAL, WARNING, INFO).
+     */
     @JsonProperty("messageType")
     public void setMessageType(String messageType) {
         this.messageType = messageType;
     }
 
+    /**
+     * The monitoring tool the state message is from.
+     */
     @JsonProperty("monitoringTool")
     public String getMonitoringTool() {
         return monitoringTool;
     }
 
+    /**
+     * The monitoring tool the state message is from.
+     */
     @JsonProperty("monitoringTool")
     public void setMonitoringTool(String monitoringTool) {
         this.monitoringTool = monitoringTool;
     }
 
+    /**
+     * A key used to map the alert to a team.
+     */
     @JsonProperty("routingKey")
     public String getRoutingKey() {
         return routingKey;
     }
 
+    /**
+     * A key used to map the alert to a team.
+     */
     @JsonProperty("routingKey")
     public void setRoutingKey(String routingKey) {
         this.routingKey = routingKey;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public Boolean getSendResolved() {
         return sendResolved;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public void setSendResolved(Boolean sendResolved) {
         this.sendResolved = sendResolved;
     }
 
+    /**
+     * Contains long explanation of the alerted problem.
+     */
     @JsonProperty("stateMessage")
     public String getStateMessage() {
         return stateMessage;
     }
 
+    /**
+     * Contains long explanation of the alerted problem.
+     */
     @JsonProperty("stateMessage")
     public void setStateMessage(String stateMessage) {
         this.stateMessage = stateMessage;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/WeChatConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/WeChatConfig.java
index 4c7f900b97c..ff805bcfdf6 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/WeChatConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/WeChatConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -118,111 +121,177 @@ public WeChatConfig(String agentID, SecretKeySelector apiSecret, String apiURL,
         this.toUser = toUser;
     }
 
+    /**
+     * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+     */
     @JsonProperty("agentID")
     public String getAgentID() {
         return agentID;
     }
 
+    /**
+     * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+     */
     @JsonProperty("agentID")
     public void setAgentID(String agentID) {
         this.agentID = agentID;
     }
 
+    /**
+     * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+     */
     @JsonProperty("apiSecret")
     public SecretKeySelector getApiSecret() {
         return apiSecret;
     }
 
+    /**
+     * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+     */
     @JsonProperty("apiSecret")
     public void setApiSecret(SecretKeySelector apiSecret) {
         this.apiSecret = apiSecret;
     }
 
+    /**
+     * The WeChat API URL.
+     */
     @JsonProperty("apiURL")
     public String getApiURL() {
         return apiURL;
     }
 
+    /**
+     * The WeChat API URL.
+     */
     @JsonProperty("apiURL")
     public void setApiURL(String apiURL) {
         this.apiURL = apiURL;
     }
 
+    /**
+     * The corp id for authentication.
+     */
     @JsonProperty("corpID")
     public String getCorpID() {
         return corpID;
     }
 
+    /**
+     * The corp id for authentication.
+     */
     @JsonProperty("corpID")
     public void setCorpID(String corpID) {
         this.corpID = corpID;
     }
 
+    /**
+     * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+     */
     @JsonProperty("httpConfig")
     public HTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(HTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * API request data as defined by the WeChat API.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * API request data as defined by the WeChat API.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+     */
     @JsonProperty("messageType")
     public String getMessageType() {
         return messageType;
     }
 
+    /**
+     * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+     */
     @JsonProperty("messageType")
     public void setMessageType(String messageType) {
         this.messageType = messageType;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public Boolean getSendResolved() {
         return sendResolved;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public void setSendResolved(Boolean sendResolved) {
         this.sendResolved = sendResolved;
     }
 
+    /**
+     * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+     */
     @JsonProperty("toParty")
     public String getToParty() {
         return toParty;
     }
 
+    /**
+     * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+     */
     @JsonProperty("toParty")
     public void setToParty(String toParty) {
         this.toParty = toParty;
     }
 
+    /**
+     * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+     */
     @JsonProperty("toTag")
     public String getToTag() {
         return toTag;
     }
 
+    /**
+     * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+     */
     @JsonProperty("toTag")
     public void setToTag(String toTag) {
         this.toTag = toTag;
     }
 
+    /**
+     * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+     */
     @JsonProperty("toUser")
     public String getToUser() {
         return toUser;
     }
 
+    /**
+     * WeChatConfig configures notifications via WeChat. See https://prometheus.io/docs/alerting/latest/configuration/#wechat_config
+     */
     @JsonProperty("toUser")
     public void setToUser(String toUser) {
         this.toUser = toUser;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/WebexConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/WebexConfig.java
index 9ff9d7e50c4..7865392d309 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/WebexConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/WebexConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WebexConfig configures notification via Cisco Webex See https://prometheus.io/docs/alerting/latest/configuration/#webex_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public WebexConfig(String apiURL, HTTPConfig httpConfig, String message, String
         this.sendResolved = sendResolved;
     }
 
+    /**
+     * The Webex Teams API URL i.e. https://webexapis.com/v1/messages
+     */
     @JsonProperty("apiURL")
     public String getApiURL() {
         return apiURL;
     }
 
+    /**
+     * The Webex Teams API URL i.e. https://webexapis.com/v1/messages
+     */
     @JsonProperty("apiURL")
     public void setApiURL(String apiURL) {
         this.apiURL = apiURL;
     }
 
+    /**
+     * WebexConfig configures notification via Cisco Webex See https://prometheus.io/docs/alerting/latest/configuration/#webex_config
+     */
     @JsonProperty("httpConfig")
     public HTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * WebexConfig configures notification via Cisco Webex See https://prometheus.io/docs/alerting/latest/configuration/#webex_config
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(HTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * Message template
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message template
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * ID of the Webex Teams room where to send the messages.
+     */
     @JsonProperty("roomID")
     public String getRoomID() {
         return roomID;
     }
 
+    /**
+     * ID of the Webex Teams room where to send the messages.
+     */
     @JsonProperty("roomID")
     public void setRoomID(String roomID) {
         this.roomID = roomID;
     }
 
+    /**
+     * Whether to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public Boolean getSendResolved() {
         return sendResolved;
     }
 
+    /**
+     * Whether to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public void setSendResolved(Boolean sendResolved) {
         this.sendResolved = sendResolved;
diff --git a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/WebhookConfig.java b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/WebhookConfig.java
index 3b39f4416d3..41542f9207c 100644
--- a/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/WebhookConfig.java
+++ b/kubernetes-model-generator/openshift-model-monitoring/src/generated/java/io/fabric8/openshift/api/model/monitoring/v1beta1/WebhookConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WebhookConfig configures notifications via a generic receiver supporting the webhook payload. See https://prometheus.io/docs/alerting/latest/configuration/#webhook_config
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public WebhookConfig(HTTPConfig httpConfig, Integer maxAlerts, Boolean sendResol
         this.urlSecret = urlSecret;
     }
 
+    /**
+     * WebhookConfig configures notifications via a generic receiver supporting the webhook payload. See https://prometheus.io/docs/alerting/latest/configuration/#webhook_config
+     */
     @JsonProperty("httpConfig")
     public HTTPConfig getHttpConfig() {
         return httpConfig;
     }
 
+    /**
+     * WebhookConfig configures notifications via a generic receiver supporting the webhook payload. See https://prometheus.io/docs/alerting/latest/configuration/#webhook_config
+     */
     @JsonProperty("httpConfig")
     public void setHttpConfig(HTTPConfig httpConfig) {
         this.httpConfig = httpConfig;
     }
 
+    /**
+     * Maximum number of alerts to be sent per webhook message. When 0, all alerts are included.
+     */
     @JsonProperty("maxAlerts")
     public Integer getMaxAlerts() {
         return maxAlerts;
     }
 
+    /**
+     * Maximum number of alerts to be sent per webhook message. When 0, all alerts are included.
+     */
     @JsonProperty("maxAlerts")
     public void setMaxAlerts(Integer maxAlerts) {
         this.maxAlerts = maxAlerts;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public Boolean getSendResolved() {
         return sendResolved;
     }
 
+    /**
+     * Whether or not to notify about resolved alerts.
+     */
     @JsonProperty("sendResolved")
     public void setSendResolved(Boolean sendResolved) {
         this.sendResolved = sendResolved;
     }
 
+    /**
+     * The URL to send HTTP POST requests to. `urlSecret` takes precedence over `url`. One of `urlSecret` and `url` should be defined.
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * The URL to send HTTP POST requests to. `urlSecret` takes precedence over `url`. One of `urlSecret` and `url` should be defined.
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
     }
 
+    /**
+     * WebhookConfig configures notifications via a generic receiver supporting the webhook payload. See https://prometheus.io/docs/alerting/latest/configuration/#webhook_config
+     */
     @JsonProperty("urlSecret")
     public SecretKeySelector getUrlSecret() {
         return urlSecret;
     }
 
+    /**
+     * WebhookConfig configures notifications via a generic receiver supporting the webhook payload. See https://prometheus.io/docs/alerting/latest/configuration/#webhook_config
+     */
     @JsonProperty("urlSecret")
     public void setUrlSecret(SecretKeySelector urlSecret) {
         this.urlSecret = urlSecret;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/controlplane/v1alpha1/LogEntry.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/controlplane/v1alpha1/LogEntry.java
index afa20652598..79838a17835 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/controlplane/v1alpha1/LogEntry.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/controlplane/v1alpha1/LogEntry.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LogEntry records events
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public LogEntry(String latency, String message, String reason, Boolean success,
         this.time = time;
     }
 
+    /**
+     * LogEntry records events
+     */
     @JsonProperty("latency")
     public String getLatency() {
         return latency;
     }
 
+    /**
+     * LogEntry records events
+     */
     @JsonProperty("latency")
     public void setLatency(String latency) {
         this.latency = latency;
     }
 
+    /**
+     * Message explaining status in a human readable format.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message explaining status in a human readable format.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Reason for status in a machine readable format.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason for status in a machine readable format.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Success indicates if the log entry indicates a success or failure.
+     */
     @JsonProperty("success")
     public Boolean getSuccess() {
         return success;
     }
 
+    /**
+     * Success indicates if the log entry indicates a success or failure.
+     */
     @JsonProperty("success")
     public void setSuccess(Boolean success) {
         this.success = success;
     }
 
+    /**
+     * LogEntry records events
+     */
     @JsonProperty("time")
     public String getTime() {
         return time;
     }
 
+    /**
+     * LogEntry records events
+     */
     @JsonProperty("time")
     public void setTime(String time) {
         this.time = time;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/controlplane/v1alpha1/OutageEntry.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/controlplane/v1alpha1/OutageEntry.java
index bd96abbeec1..bb5e6d86499 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/controlplane/v1alpha1/OutageEntry.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/controlplane/v1alpha1/OutageEntry.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OutageEntry records time period of an outage
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,53 +101,83 @@ public OutageEntry(String end, List<LogEntry> endLogs, String message, String st
         this.startLogs = startLogs;
     }
 
+    /**
+     * OutageEntry records time period of an outage
+     */
     @JsonProperty("end")
     public String getEnd() {
         return end;
     }
 
+    /**
+     * OutageEntry records time period of an outage
+     */
     @JsonProperty("end")
     public void setEnd(String end) {
         this.end = end;
     }
 
+    /**
+     * EndLogs contains log entries related to the end of this outage. Should contain the success entry that resolved the outage and possibly a few of the failure log entries that preceded it.
+     */
     @JsonProperty("endLogs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LogEntry> getEndLogs() {
         return endLogs;
     }
 
+    /**
+     * EndLogs contains log entries related to the end of this outage. Should contain the success entry that resolved the outage and possibly a few of the failure log entries that preceded it.
+     */
     @JsonProperty("endLogs")
     public void setEndLogs(List<LogEntry> endLogs) {
         this.endLogs = endLogs;
     }
 
+    /**
+     * Message summarizes outage details in a human readable format.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message summarizes outage details in a human readable format.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * OutageEntry records time period of an outage
+     */
     @JsonProperty("start")
     public String getStart() {
         return start;
     }
 
+    /**
+     * OutageEntry records time period of an outage
+     */
     @JsonProperty("start")
     public void setStart(String start) {
         this.start = start;
     }
 
+    /**
+     * StartLogs contains log entries related to the start of this outage. Should contain the original failure, any entries where the failure mode changed.
+     */
     @JsonProperty("startLogs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LogEntry> getStartLogs() {
         return startLogs;
     }
 
+    /**
+     * StartLogs contains log entries related to the start of this outage. Should contain the original failure, any entries where the failure mode changed.
+     */
     @JsonProperty("startLogs")
     public void setStartLogs(List<LogEntry> startLogs) {
         this.startLogs = startLogs;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/controlplane/v1alpha1/PodNetworkConnectivityCheck.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/controlplane/v1alpha1/PodNetworkConnectivityCheck.java
index 41d4d01c390..56cdca0df82 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/controlplane/v1alpha1/PodNetworkConnectivityCheck.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/controlplane/v1alpha1/PodNetworkConnectivityCheck.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodNetworkConnectivityCheck<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class PodNetworkConnectivityCheck implements Editable<PodNetworkConnectivityCheckBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "controlplane.operator.openshift.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodNetworkConnectivityCheck";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PodNetworkConnectivityCheck(String apiVersion, String kind, ObjectMeta me
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodNetworkConnectivityCheck<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodNetworkConnectivityCheck<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PodNetworkConnectivityCheck<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("spec")
     public PodNetworkConnectivityCheckSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PodNetworkConnectivityCheck<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("spec")
     public void setSpec(PodNetworkConnectivityCheckSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PodNetworkConnectivityCheck<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("status")
     public PodNetworkConnectivityCheckStatus getStatus() {
         return status;
     }
 
+    /**
+     * PodNetworkConnectivityCheck<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("status")
     public void setStatus(PodNetworkConnectivityCheckStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/controlplane/v1alpha1/PodNetworkConnectivityCheckCondition.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/controlplane/v1alpha1/PodNetworkConnectivityCheckCondition.java
index 027e3a4fe5e..c673a1cd439 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/controlplane/v1alpha1/PodNetworkConnectivityCheckCondition.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/controlplane/v1alpha1/PodNetworkConnectivityCheckCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodNetworkConnectivityCheckCondition represents the overall status of the pod network connectivity.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public PodNetworkConnectivityCheckCondition(String lastTransitionTime, String me
         this.type = type;
     }
 
+    /**
+     * PodNetworkConnectivityCheckCondition represents the overall status of the pod network connectivity.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * PodNetworkConnectivityCheckCondition represents the overall status of the pod network connectivity.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Message indicating details about last transition in a human readable format.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message indicating details about last transition in a human readable format.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Reason for the condition's last status transition in a machine readable format.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason for the condition's last status transition in a machine readable format.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of the condition
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type of the condition
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of the condition
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/controlplane/v1alpha1/PodNetworkConnectivityCheckList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/controlplane/v1alpha1/PodNetworkConnectivityCheckList.java
index 8c3b70b8e08..db3eeca2aee 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/controlplane/v1alpha1/PodNetworkConnectivityCheckList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/controlplane/v1alpha1/PodNetworkConnectivityCheckList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodNetworkConnectivityCheckList is a collection of PodNetworkConnectivityCheck<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PodNetworkConnectivityCheckList implements Editable<PodNetworkConnectivityCheckListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.controlplane.v1alpha1.PodNetworkConnectivityCheck>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "controlplane.operator.openshift.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.controlplane.v1alpha1.PodNetworkConnectivityCheck> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodNetworkConnectivityCheckList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PodNetworkConnectivityCheckList(String apiVersion, List<io.fabric8.opensh
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items contains the items
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.controlplane.v1alpha1.PodNetworkConnectivityCheck> getItems() {
         return items;
     }
 
+    /**
+     * Items contains the items
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.controlplane.v1alpha1.PodNetworkConnectivityCheck> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodNetworkConnectivityCheckList is a collection of PodNetworkConnectivityCheck<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodNetworkConnectivityCheckList is a collection of PodNetworkConnectivityCheck<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/controlplane/v1alpha1/PodNetworkConnectivityCheckSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/controlplane/v1alpha1/PodNetworkConnectivityCheckSpec.java
index 40363ad184c..fe6d9c2e256 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/controlplane/v1alpha1/PodNetworkConnectivityCheckSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/controlplane/v1alpha1/PodNetworkConnectivityCheckSpec.java
@@ -87,21 +87,33 @@ public PodNetworkConnectivityCheckSpec(String sourcePod, String targetEndpoint,
         this.tlsClientCert = tlsClientCert;
     }
 
+    /**
+     * SourcePod names the pod from which the condition will be checked
+     */
     @JsonProperty("sourcePod")
     public String getSourcePod() {
         return sourcePod;
     }
 
+    /**
+     * SourcePod names the pod from which the condition will be checked
+     */
     @JsonProperty("sourcePod")
     public void setSourcePod(String sourcePod) {
         this.sourcePod = sourcePod;
     }
 
+    /**
+     * EndpointAddress to check. A TCP address of the form host:port. Note that if host is a DNS name, then the check would fail if the DNS name cannot be resolved. Specify an IP address for host to bypass DNS name lookup.
+     */
     @JsonProperty("targetEndpoint")
     public String getTargetEndpoint() {
         return targetEndpoint;
     }
 
+    /**
+     * EndpointAddress to check. A TCP address of the form host:port. Note that if host is a DNS name, then the check would fail if the DNS name cannot be resolved. Specify an IP address for host to bypass DNS name lookup.
+     */
     @JsonProperty("targetEndpoint")
     public void setTargetEndpoint(String targetEndpoint) {
         this.targetEndpoint = targetEndpoint;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/controlplane/v1alpha1/PodNetworkConnectivityCheckStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/controlplane/v1alpha1/PodNetworkConnectivityCheckStatus.java
index 6000e79b0ce..b913073049f 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/controlplane/v1alpha1/PodNetworkConnectivityCheckStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/controlplane/v1alpha1/PodNetworkConnectivityCheckStatus.java
@@ -96,45 +96,69 @@ public PodNetworkConnectivityCheckStatus(List<PodNetworkConnectivityCheckConditi
         this.successes = successes;
     }
 
+    /**
+     * Conditions summarize the status of the check
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PodNetworkConnectivityCheckCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions summarize the status of the check
+     */
     @JsonProperty("conditions")
     public void setConditions(List<PodNetworkConnectivityCheckCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Failures contains logs of unsuccessful check actions
+     */
     @JsonProperty("failures")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LogEntry> getFailures() {
         return failures;
     }
 
+    /**
+     * Failures contains logs of unsuccessful check actions
+     */
     @JsonProperty("failures")
     public void setFailures(List<LogEntry> failures) {
         this.failures = failures;
     }
 
+    /**
+     * Outages contains logs of time periods of outages
+     */
     @JsonProperty("outages")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OutageEntry> getOutages() {
         return outages;
     }
 
+    /**
+     * Outages contains logs of time periods of outages
+     */
     @JsonProperty("outages")
     public void setOutages(List<OutageEntry> outages) {
         this.outages = outages;
     }
 
+    /**
+     * Successes contains logs successful check actions
+     */
     @JsonProperty("successes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LogEntry> getSuccesses() {
         return successes;
     }
 
+    /**
+     * Successes contains logs successful check actions
+     */
     @JsonProperty("successes")
     public void setSuccesses(List<LogEntry> successes) {
         this.successes = successes;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/AzureNetworkAccess.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/AzureNetworkAccess.java
index 794f67a41c4..988993a5e63 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/AzureNetworkAccess.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/AzureNetworkAccess.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzureNetworkAccess defines the network access properties for the storage account.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public AzureNetworkAccess(AzureNetworkAccessInternal internal, String type) {
         this.type = type;
     }
 
+    /**
+     * AzureNetworkAccess defines the network access properties for the storage account.
+     */
     @JsonProperty("internal")
     public AzureNetworkAccessInternal getInternal() {
         return internal;
     }
 
+    /**
+     * AzureNetworkAccess defines the network access properties for the storage account.
+     */
     @JsonProperty("internal")
     public void setInternal(AzureNetworkAccessInternal internal) {
         this.internal = internal;
     }
 
+    /**
+     * type is the network access level to be used for the storage account. type: Internal means the storage account will be private, type: External means the storage account will be publicly accessible. Internal storage accounts are only exposed within the cluster's vnet. External storage accounts are publicly exposed on the internet. When type: Internal is used, a vnetName, subNetName and privateEndpointName may optionally be specified. If unspecificed, the image registry operator will discover vnet and subnet names, and generate a privateEndpointName. Defaults to "External".
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the network access level to be used for the storage account. type: Internal means the storage account will be private, type: External means the storage account will be publicly accessible. Internal storage accounts are only exposed within the cluster's vnet. External storage accounts are publicly exposed on the internet. When type: Internal is used, a vnetName, subNetName and privateEndpointName may optionally be specified. If unspecificed, the image registry operator will discover vnet and subnet names, and generate a privateEndpointName. Defaults to "External".
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/AzureNetworkAccessInternal.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/AzureNetworkAccessInternal.java
index e1b57a5f63a..65e946a95e4 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/AzureNetworkAccessInternal.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/AzureNetworkAccessInternal.java
@@ -90,41 +90,65 @@ public AzureNetworkAccessInternal(String networkResourceGroupName, String privat
         this.vnetName = vnetName;
     }
 
+    /**
+     * networkResourceGroupName is the resource group name where the cluster's vnet and subnet are. When omitted, the registry operator will use the cluster resource group (from in the infrastructure status). If you set a networkResourceGroupName on your install-config.yaml, that value will be used automatically (for clusters configured with publish:Internal). Note that both vnet and subnet must be in the same resource group. It must be between 1 and 90 characters in length and must consist only of alphanumeric characters, hyphens (-), periods (.) and underscores (_), and not end with a period.
+     */
     @JsonProperty("networkResourceGroupName")
     public String getNetworkResourceGroupName() {
         return networkResourceGroupName;
     }
 
+    /**
+     * networkResourceGroupName is the resource group name where the cluster's vnet and subnet are. When omitted, the registry operator will use the cluster resource group (from in the infrastructure status). If you set a networkResourceGroupName on your install-config.yaml, that value will be used automatically (for clusters configured with publish:Internal). Note that both vnet and subnet must be in the same resource group. It must be between 1 and 90 characters in length and must consist only of alphanumeric characters, hyphens (-), periods (.) and underscores (_), and not end with a period.
+     */
     @JsonProperty("networkResourceGroupName")
     public void setNetworkResourceGroupName(String networkResourceGroupName) {
         this.networkResourceGroupName = networkResourceGroupName;
     }
 
+    /**
+     * privateEndpointName is the name of the private endpoint for the registry. When provided, the registry will use it as the name of the private endpoint it will create for the storage account. When omitted, the registry will generate one. It must be between 2 and 64 characters in length and must consist only of alphanumeric characters, hyphens (-), periods (.) and underscores (_). It must start with an alphanumeric character and end with an alphanumeric character or an underscore.
+     */
     @JsonProperty("privateEndpointName")
     public String getPrivateEndpointName() {
         return privateEndpointName;
     }
 
+    /**
+     * privateEndpointName is the name of the private endpoint for the registry. When provided, the registry will use it as the name of the private endpoint it will create for the storage account. When omitted, the registry will generate one. It must be between 2 and 64 characters in length and must consist only of alphanumeric characters, hyphens (-), periods (.) and underscores (_). It must start with an alphanumeric character and end with an alphanumeric character or an underscore.
+     */
     @JsonProperty("privateEndpointName")
     public void setPrivateEndpointName(String privateEndpointName) {
         this.privateEndpointName = privateEndpointName;
     }
 
+    /**
+     * subnetName is the name of the subnet the registry operates in. When omitted, the registry operator will discover and set this by using the `kubernetes.io_cluster.&lt;cluster-id&gt;` tag in the vnet resource, then using one of listed subnets. Advanced cluster network configurations that use network security groups to protect subnets should ensure the provided subnetName has access to Azure Storage service. It must be between 1 and 80 characters in length and must consist only of alphanumeric characters, hyphens (-), periods (.) and underscores (_).
+     */
     @JsonProperty("subnetName")
     public String getSubnetName() {
         return subnetName;
     }
 
+    /**
+     * subnetName is the name of the subnet the registry operates in. When omitted, the registry operator will discover and set this by using the `kubernetes.io_cluster.&lt;cluster-id&gt;` tag in the vnet resource, then using one of listed subnets. Advanced cluster network configurations that use network security groups to protect subnets should ensure the provided subnetName has access to Azure Storage service. It must be between 1 and 80 characters in length and must consist only of alphanumeric characters, hyphens (-), periods (.) and underscores (_).
+     */
     @JsonProperty("subnetName")
     public void setSubnetName(String subnetName) {
         this.subnetName = subnetName;
     }
 
+    /**
+     * vnetName is the name of the vnet the registry operates in. When omitted, the registry operator will discover and set this by using the `kubernetes.io_cluster.&lt;cluster-id&gt;` tag in the vnet resource. This tag is set automatically by the installer. Commonly, this will be the same vnet as the cluster. Advanced cluster network configurations should ensure the provided vnetName is the vnet of the nodes where the image registry pods are running from. It must be between 2 and 64 characters in length and must consist only of alphanumeric characters, hyphens (-), periods (.) and underscores (_). It must start with an alphanumeric character and end with an alphanumeric character or an underscore.
+     */
     @JsonProperty("vnetName")
     public String getVnetName() {
         return vnetName;
     }
 
+    /**
+     * vnetName is the name of the vnet the registry operates in. When omitted, the registry operator will discover and set this by using the `kubernetes.io_cluster.&lt;cluster-id&gt;` tag in the vnet resource. This tag is set automatically by the installer. Commonly, this will be the same vnet as the cluster. Advanced cluster network configurations should ensure the provided vnetName is the vnet of the nodes where the image registry pods are running from. It must be between 2 and 64 characters in length and must consist only of alphanumeric characters, hyphens (-), periods (.) and underscores (_). It must start with an alphanumeric character and end with an alphanumeric character or an underscore.
+     */
     @JsonProperty("vnetName")
     public void setVnetName(String vnetName) {
         this.vnetName = vnetName;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/Config.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/Config.java
index 2fd8819996e..9ed954b3077 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/Config.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/Config.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Config is the configuration object for a registry instance managed by the registry operator<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Config implements Editable<ConfigBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "imageregistry.operator.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Config";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public Config(String apiVersion, String kind, ObjectMeta metadata, ImageRegistry
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Config is the configuration object for a registry instance managed by the registry operator<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Config is the configuration object for a registry instance managed by the registry operator<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Config is the configuration object for a registry instance managed by the registry operator<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ImageRegistrySpec getSpec() {
         return spec;
     }
 
+    /**
+     * Config is the configuration object for a registry instance managed by the registry operator<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ImageRegistrySpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Config is the configuration object for a registry instance managed by the registry operator<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public ImageRegistryStatus getStatus() {
         return status;
     }
 
+    /**
+     * Config is the configuration object for a registry instance managed by the registry operator<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(ImageRegistryStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ConfigList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ConfigList.java
index 3cb07845bcb..f8d9963c432 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ConfigList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ConfigList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConfigList is a slice of Config objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ConfigList implements Editable<ConfigListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.imageregistry.v1.Config>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "imageregistry.operator.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.imageregistry.v1.Config> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ConfigList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ConfigList(String apiVersion, List<io.fabric8.openshift.api.model.operato
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ConfigList is a slice of Config objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.imageregistry.v1.Config> getItems() {
         return items;
     }
 
+    /**
+     * ConfigList is a slice of Config objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.imageregistry.v1.Config> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ConfigList is a slice of Config objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ConfigList is a slice of Config objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/EncryptionAlibaba.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/EncryptionAlibaba.java
index c1bb70048c4..d687a1d7d38 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/EncryptionAlibaba.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/EncryptionAlibaba.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EncryptionAlibaba this a union type in kube parlance.  Depending on the value for the AlibabaEncryptionMethod, different pointers may be used
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public EncryptionAlibaba(KMSEncryptionAlibaba kms, String method) {
         this.method = method;
     }
 
+    /**
+     * EncryptionAlibaba this a union type in kube parlance.  Depending on the value for the AlibabaEncryptionMethod, different pointers may be used
+     */
     @JsonProperty("kms")
     public KMSEncryptionAlibaba getKms() {
         return kms;
     }
 
+    /**
+     * EncryptionAlibaba this a union type in kube parlance.  Depending on the value for the AlibabaEncryptionMethod, different pointers may be used
+     */
     @JsonProperty("kms")
     public void setKms(KMSEncryptionAlibaba kms) {
         this.kms = kms;
     }
 
+    /**
+     * Method defines the different encrytion modes available Empty value means no opinion and the platform chooses the a default, which is subject to change over time. Currently the default is `AES256`.
+     */
     @JsonProperty("method")
     public String getMethod() {
         return method;
     }
 
+    /**
+     * Method defines the different encrytion modes available Empty value means no opinion and the platform chooses the a default, which is subject to change over time. Currently the default is `AES256`.
+     */
     @JsonProperty("method")
     public void setMethod(String method) {
         this.method = method;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImagePruner.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImagePruner.java
index 4accac26556..1b40d6ffae6 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImagePruner.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImagePruner.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImagePruner is the configuration object for an image registry pruner managed by the registry operator.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ImagePruner implements Editable<ImagePrunerBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "imageregistry.operator.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ImagePruner";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public ImagePruner(String apiVersion, String kind, ObjectMeta metadata, ImagePru
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ImagePruner is the configuration object for an image registry pruner managed by the registry operator.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ImagePruner is the configuration object for an image registry pruner managed by the registry operator.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ImagePruner is the configuration object for an image registry pruner managed by the registry operator.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ImagePrunerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ImagePruner is the configuration object for an image registry pruner managed by the registry operator.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ImagePrunerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ImagePruner is the configuration object for an image registry pruner managed by the registry operator.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public ImagePrunerStatus getStatus() {
         return status;
     }
 
+    /**
+     * ImagePruner is the configuration object for an image registry pruner managed by the registry operator.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(ImagePrunerStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImagePrunerList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImagePrunerList.java
index d5ccccaecd7..c37795093e7 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImagePrunerList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImagePrunerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImagePrunerList is a slice of ImagePruner objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ImagePrunerList implements Editable<ImagePrunerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.imageregistry.v1.ImagePruner>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "imageregistry.operator.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.imageregistry.v1.ImagePruner> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ImagePrunerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ImagePrunerList(String apiVersion, List<io.fabric8.openshift.api.model.op
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ImagePrunerList is a slice of ImagePruner objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.imageregistry.v1.ImagePruner> getItems() {
         return items;
     }
 
+    /**
+     * ImagePrunerList is a slice of ImagePruner objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.imageregistry.v1.ImagePruner> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ImagePrunerList is a slice of ImagePruner objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ImagePrunerList is a slice of ImagePruner objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImagePrunerSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImagePrunerSpec.java
index f34c9824fa0..10f85d531f0 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImagePrunerSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImagePrunerSpec.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImagePrunerSpec defines the specs for the running image pruner.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -132,133 +135,211 @@ public ImagePrunerSpec(Affinity affinity, Integer failedJobsHistoryLimit, Boolea
         this.tolerations = tolerations;
     }
 
+    /**
+     * ImagePrunerSpec defines the specs for the running image pruner.
+     */
     @JsonProperty("affinity")
     public Affinity getAffinity() {
         return affinity;
     }
 
+    /**
+     * ImagePrunerSpec defines the specs for the running image pruner.
+     */
     @JsonProperty("affinity")
     public void setAffinity(Affinity affinity) {
         this.affinity = affinity;
     }
 
+    /**
+     * failedJobsHistoryLimit specifies how many failed image pruner jobs to retain. Defaults to 3 if not set.
+     */
     @JsonProperty("failedJobsHistoryLimit")
     public Integer getFailedJobsHistoryLimit() {
         return failedJobsHistoryLimit;
     }
 
+    /**
+     * failedJobsHistoryLimit specifies how many failed image pruner jobs to retain. Defaults to 3 if not set.
+     */
     @JsonProperty("failedJobsHistoryLimit")
     public void setFailedJobsHistoryLimit(Integer failedJobsHistoryLimit) {
         this.failedJobsHistoryLimit = failedJobsHistoryLimit;
     }
 
+    /**
+     * ignoreInvalidImageReferences indicates whether the pruner can ignore errors while parsing image references.
+     */
     @JsonProperty("ignoreInvalidImageReferences")
     public Boolean getIgnoreInvalidImageReferences() {
         return ignoreInvalidImageReferences;
     }
 
+    /**
+     * ignoreInvalidImageReferences indicates whether the pruner can ignore errors while parsing image references.
+     */
     @JsonProperty("ignoreInvalidImageReferences")
     public void setIgnoreInvalidImageReferences(Boolean ignoreInvalidImageReferences) {
         this.ignoreInvalidImageReferences = ignoreInvalidImageReferences;
     }
 
+    /**
+     * keepTagRevisions specifies the number of image revisions for a tag in an image stream that will be preserved. Defaults to 3.
+     */
     @JsonProperty("keepTagRevisions")
     public Integer getKeepTagRevisions() {
         return keepTagRevisions;
     }
 
+    /**
+     * keepTagRevisions specifies the number of image revisions for a tag in an image stream that will be preserved. Defaults to 3.
+     */
     @JsonProperty("keepTagRevisions")
     public void setKeepTagRevisions(Integer keepTagRevisions) {
         this.keepTagRevisions = keepTagRevisions;
     }
 
+    /**
+     * keepYoungerThan specifies the minimum age in nanoseconds of an image and its referrers for it to be considered a candidate for pruning. DEPRECATED: This field is deprecated in favor of keepYoungerThanDuration. If both are set, this field is ignored and keepYoungerThanDuration takes precedence.
+     */
     @JsonProperty("keepYoungerThan")
     public Long getKeepYoungerThan() {
         return keepYoungerThan;
     }
 
+    /**
+     * keepYoungerThan specifies the minimum age in nanoseconds of an image and its referrers for it to be considered a candidate for pruning. DEPRECATED: This field is deprecated in favor of keepYoungerThanDuration. If both are set, this field is ignored and keepYoungerThanDuration takes precedence.
+     */
     @JsonProperty("keepYoungerThan")
     public void setKeepYoungerThan(Long keepYoungerThan) {
         this.keepYoungerThan = keepYoungerThan;
     }
 
+    /**
+     * ImagePrunerSpec defines the specs for the running image pruner.
+     */
     @JsonProperty("keepYoungerThanDuration")
     public String getKeepYoungerThanDuration() {
         return keepYoungerThanDuration;
     }
 
+    /**
+     * ImagePrunerSpec defines the specs for the running image pruner.
+     */
     @JsonProperty("keepYoungerThanDuration")
     public void setKeepYoungerThanDuration(String keepYoungerThanDuration) {
         this.keepYoungerThanDuration = keepYoungerThanDuration;
     }
 
+    /**
+     * logLevel sets the level of log output for the pruner job.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * logLevel sets the level of log output for the pruner job.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * nodeSelector defines the node selection constraints for the image pruner pod.
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * nodeSelector defines the node selection constraints for the image pruner pod.
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * ImagePrunerSpec defines the specs for the running image pruner.
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * ImagePrunerSpec defines the specs for the running image pruner.
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * schedule specifies when to execute the job using standard cronjob syntax: https://wikipedia.org/wiki/Cron. Defaults to `0 0 &#42; &#42; &#42;`.
+     */
     @JsonProperty("schedule")
     public String getSchedule() {
         return schedule;
     }
 
+    /**
+     * schedule specifies when to execute the job using standard cronjob syntax: https://wikipedia.org/wiki/Cron. Defaults to `0 0 &#42; &#42; &#42;`.
+     */
     @JsonProperty("schedule")
     public void setSchedule(String schedule) {
         this.schedule = schedule;
     }
 
+    /**
+     * successfulJobsHistoryLimit specifies how many successful image pruner jobs to retain. Defaults to 3 if not set.
+     */
     @JsonProperty("successfulJobsHistoryLimit")
     public Integer getSuccessfulJobsHistoryLimit() {
         return successfulJobsHistoryLimit;
     }
 
+    /**
+     * successfulJobsHistoryLimit specifies how many successful image pruner jobs to retain. Defaults to 3 if not set.
+     */
     @JsonProperty("successfulJobsHistoryLimit")
     public void setSuccessfulJobsHistoryLimit(Integer successfulJobsHistoryLimit) {
         this.successfulJobsHistoryLimit = successfulJobsHistoryLimit;
     }
 
+    /**
+     * suspend specifies whether or not to suspend subsequent executions of this cronjob. Defaults to false.
+     */
     @JsonProperty("suspend")
     public Boolean getSuspend() {
         return suspend;
     }
 
+    /**
+     * suspend specifies whether or not to suspend subsequent executions of this cronjob. Defaults to false.
+     */
     @JsonProperty("suspend")
     public void setSuspend(Boolean suspend) {
         this.suspend = suspend;
     }
 
+    /**
+     * tolerations defines the node tolerations for the image pruner pod.
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * tolerations defines the node tolerations for the image pruner pod.
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImagePrunerStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImagePrunerStatus.java
index 049f621e7c4..90cd9b5a840 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImagePrunerStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImagePrunerStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImagePrunerStatus reports image pruner operational status.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,22 +89,34 @@ public ImagePrunerStatus(List<OperatorCondition> conditions, Long observedGenera
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * conditions is a list of conditions and their status.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * observedGeneration is the last generation change that has been applied.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change that has been applied.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigProxy.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigProxy.java
index bfe514163f8..16d5ad1202c 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigProxy.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigProxy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageRegistryConfigProxy defines proxy configuration to be used by registry.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ImageRegistryConfigProxy(String http, String https, String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * http defines the proxy to be used by the image registry when accessing HTTP endpoints.
+     */
     @JsonProperty("http")
     public String getHttp() {
         return http;
     }
 
+    /**
+     * http defines the proxy to be used by the image registry when accessing HTTP endpoints.
+     */
     @JsonProperty("http")
     public void setHttp(String http) {
         this.http = http;
     }
 
+    /**
+     * https defines the proxy to be used by the image registry when accessing HTTPS endpoints.
+     */
     @JsonProperty("https")
     public String getHttps() {
         return https;
     }
 
+    /**
+     * https defines the proxy to be used by the image registry when accessing HTTPS endpoints.
+     */
     @JsonProperty("https")
     public void setHttps(String https) {
         this.https = https;
     }
 
+    /**
+     * noProxy defines a comma-separated list of host names that shouldn't go through any proxy.
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * noProxy defines a comma-separated list of host names that shouldn't go through any proxy.
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigRequests.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigRequests.java
index 151cd1b2c30..24c04ccec6f 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigRequests.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigRequests.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageRegistryConfigRequests defines registry limits on requests read and write.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ImageRegistryConfigRequests(ImageRegistryConfigRequestsLimits read, Image
         this.write = write;
     }
 
+    /**
+     * ImageRegistryConfigRequests defines registry limits on requests read and write.
+     */
     @JsonProperty("read")
     public ImageRegistryConfigRequestsLimits getRead() {
         return read;
     }
 
+    /**
+     * ImageRegistryConfigRequests defines registry limits on requests read and write.
+     */
     @JsonProperty("read")
     public void setRead(ImageRegistryConfigRequestsLimits read) {
         this.read = read;
     }
 
+    /**
+     * ImageRegistryConfigRequests defines registry limits on requests read and write.
+     */
     @JsonProperty("write")
     public ImageRegistryConfigRequestsLimits getWrite() {
         return write;
     }
 
+    /**
+     * ImageRegistryConfigRequests defines registry limits on requests read and write.
+     */
     @JsonProperty("write")
     public void setWrite(ImageRegistryConfigRequestsLimits write) {
         this.write = write;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigRequestsLimits.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigRequestsLimits.java
index 5ee7a836343..83a9ffe9742 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigRequestsLimits.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigRequestsLimits.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageRegistryConfigRequestsLimits holds configuration on the max, enqueued and waiting registry's API requests.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ImageRegistryConfigRequestsLimits(Integer maxInQueue, Integer maxRunning,
         this.maxWaitInQueue = maxWaitInQueue;
     }
 
+    /**
+     * maxInQueue sets the maximum queued api requests to the registry.
+     */
     @JsonProperty("maxInQueue")
     public Integer getMaxInQueue() {
         return maxInQueue;
     }
 
+    /**
+     * maxInQueue sets the maximum queued api requests to the registry.
+     */
     @JsonProperty("maxInQueue")
     public void setMaxInQueue(Integer maxInQueue) {
         this.maxInQueue = maxInQueue;
     }
 
+    /**
+     * maxRunning sets the maximum in flight api requests to the registry.
+     */
     @JsonProperty("maxRunning")
     public Integer getMaxRunning() {
         return maxRunning;
     }
 
+    /**
+     * maxRunning sets the maximum in flight api requests to the registry.
+     */
     @JsonProperty("maxRunning")
     public void setMaxRunning(Integer maxRunning) {
         this.maxRunning = maxRunning;
     }
 
+    /**
+     * ImageRegistryConfigRequestsLimits holds configuration on the max, enqueued and waiting registry's API requests.
+     */
     @JsonProperty("maxWaitInQueue")
     public String getMaxWaitInQueue() {
         return maxWaitInQueue;
     }
 
+    /**
+     * ImageRegistryConfigRequestsLimits holds configuration on the max, enqueued and waiting registry's API requests.
+     */
     @JsonProperty("maxWaitInQueue")
     public void setMaxWaitInQueue(String maxWaitInQueue) {
         this.maxWaitInQueue = maxWaitInQueue;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigRoute.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigRoute.java
index 9d29284d5d5..d87cd29304b 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigRoute.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigRoute.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageRegistryConfigRoute holds information on external route access to image registry.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ImageRegistryConfigRoute(String hostname, String name, String secretName)
         this.secretName = secretName;
     }
 
+    /**
+     * hostname for the route.
+     */
     @JsonProperty("hostname")
     public String getHostname() {
         return hostname;
     }
 
+    /**
+     * hostname for the route.
+     */
     @JsonProperty("hostname")
     public void setHostname(String hostname) {
         this.hostname = hostname;
     }
 
+    /**
+     * name of the route to be created.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name of the route to be created.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * secretName points to secret containing the certificates to be used by the route.
+     */
     @JsonProperty("secretName")
     public String getSecretName() {
         return secretName;
     }
 
+    /**
+     * secretName points to secret containing the certificates to be used by the route.
+     */
     @JsonProperty("secretName")
     public void setSecretName(String secretName) {
         this.secretName = secretName;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorage.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorage.java
index 8fc27266f06..91744e83af9 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorage.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorage.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageRegistryConfigStorage describes how the storage should be configured for the image registry.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -110,91 +113,145 @@ public ImageRegistryConfigStorage(ImageRegistryConfigStorageAzure azure, ImageRe
         this.swift = swift;
     }
 
+    /**
+     * ImageRegistryConfigStorage describes how the storage should be configured for the image registry.
+     */
     @JsonProperty("azure")
     public ImageRegistryConfigStorageAzure getAzure() {
         return azure;
     }
 
+    /**
+     * ImageRegistryConfigStorage describes how the storage should be configured for the image registry.
+     */
     @JsonProperty("azure")
     public void setAzure(ImageRegistryConfigStorageAzure azure) {
         this.azure = azure;
     }
 
+    /**
+     * ImageRegistryConfigStorage describes how the storage should be configured for the image registry.
+     */
     @JsonProperty("emptyDir")
     public ImageRegistryConfigStorageEmptyDir getEmptyDir() {
         return emptyDir;
     }
 
+    /**
+     * ImageRegistryConfigStorage describes how the storage should be configured for the image registry.
+     */
     @JsonProperty("emptyDir")
     public void setEmptyDir(ImageRegistryConfigStorageEmptyDir emptyDir) {
         this.emptyDir = emptyDir;
     }
 
+    /**
+     * ImageRegistryConfigStorage describes how the storage should be configured for the image registry.
+     */
     @JsonProperty("gcs")
     public ImageRegistryConfigStorageGCS getGcs() {
         return gcs;
     }
 
+    /**
+     * ImageRegistryConfigStorage describes how the storage should be configured for the image registry.
+     */
     @JsonProperty("gcs")
     public void setGcs(ImageRegistryConfigStorageGCS gcs) {
         this.gcs = gcs;
     }
 
+    /**
+     * ImageRegistryConfigStorage describes how the storage should be configured for the image registry.
+     */
     @JsonProperty("ibmcos")
     public ImageRegistryConfigStorageIBMCOS getIbmcos() {
         return ibmcos;
     }
 
+    /**
+     * ImageRegistryConfigStorage describes how the storage should be configured for the image registry.
+     */
     @JsonProperty("ibmcos")
     public void setIbmcos(ImageRegistryConfigStorageIBMCOS ibmcos) {
         this.ibmcos = ibmcos;
     }
 
+    /**
+     * managementState indicates if the operator manages the underlying storage unit. If Managed the operator will remove the storage when this operator gets Removed.
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates if the operator manages the underlying storage unit. If Managed the operator will remove the storage when this operator gets Removed.
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
     }
 
+    /**
+     * ImageRegistryConfigStorage describes how the storage should be configured for the image registry.
+     */
     @JsonProperty("oss")
     public ImageRegistryConfigStorageAlibabaOSS getOss() {
         return oss;
     }
 
+    /**
+     * ImageRegistryConfigStorage describes how the storage should be configured for the image registry.
+     */
     @JsonProperty("oss")
     public void setOss(ImageRegistryConfigStorageAlibabaOSS oss) {
         this.oss = oss;
     }
 
+    /**
+     * ImageRegistryConfigStorage describes how the storage should be configured for the image registry.
+     */
     @JsonProperty("pvc")
     public ImageRegistryConfigStoragePVC getPvc() {
         return pvc;
     }
 
+    /**
+     * ImageRegistryConfigStorage describes how the storage should be configured for the image registry.
+     */
     @JsonProperty("pvc")
     public void setPvc(ImageRegistryConfigStoragePVC pvc) {
         this.pvc = pvc;
     }
 
+    /**
+     * ImageRegistryConfigStorage describes how the storage should be configured for the image registry.
+     */
     @JsonProperty("s3")
     public ImageRegistryConfigStorageS3 getS3() {
         return s3;
     }
 
+    /**
+     * ImageRegistryConfigStorage describes how the storage should be configured for the image registry.
+     */
     @JsonProperty("s3")
     public void setS3(ImageRegistryConfigStorageS3 s3) {
         this.s3 = s3;
     }
 
+    /**
+     * ImageRegistryConfigStorage describes how the storage should be configured for the image registry.
+     */
     @JsonProperty("swift")
     public ImageRegistryConfigStorageSwift getSwift() {
         return swift;
     }
 
+    /**
+     * ImageRegistryConfigStorage describes how the storage should be configured for the image registry.
+     */
     @JsonProperty("swift")
     public void setSwift(ImageRegistryConfigStorageSwift swift) {
         this.swift = swift;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageAlibabaOSS.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageAlibabaOSS.java
index a389483b489..8d908143812 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageAlibabaOSS.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageAlibabaOSS.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageRegistryConfigStorageAlibabaOSS holds Alibaba Cloud OSS configuration. Configures the registry to use Alibaba Cloud Object Storage Service for backend storage. More about oss, you can look at the [official documentation](https://www.alibabacloud.com/help/product/31815.htm)
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ImageRegistryConfigStorageAlibabaOSS(String bucket, EncryptionAlibaba enc
         this.region = region;
     }
 
+    /**
+     * Bucket is the bucket name in which you want to store the registry's data. About Bucket naming, more details you can look at the [official documentation](https://www.alibabacloud.com/help/doc-detail/257087.htm) Empty value means no opinion and the platform chooses the a default, which is subject to change over time. Currently the default will be autogenerated in the form of &lt;clusterid&gt;-image-registry-&lt;region&gt;-&lt;random string 27 chars&gt;
+     */
     @JsonProperty("bucket")
     public String getBucket() {
         return bucket;
     }
 
+    /**
+     * Bucket is the bucket name in which you want to store the registry's data. About Bucket naming, more details you can look at the [official documentation](https://www.alibabacloud.com/help/doc-detail/257087.htm) Empty value means no opinion and the platform chooses the a default, which is subject to change over time. Currently the default will be autogenerated in the form of &lt;clusterid&gt;-image-registry-&lt;region&gt;-&lt;random string 27 chars&gt;
+     */
     @JsonProperty("bucket")
     public void setBucket(String bucket) {
         this.bucket = bucket;
     }
 
+    /**
+     * ImageRegistryConfigStorageAlibabaOSS holds Alibaba Cloud OSS configuration. Configures the registry to use Alibaba Cloud Object Storage Service for backend storage. More about oss, you can look at the [official documentation](https://www.alibabacloud.com/help/product/31815.htm)
+     */
     @JsonProperty("encryption")
     public EncryptionAlibaba getEncryption() {
         return encryption;
     }
 
+    /**
+     * ImageRegistryConfigStorageAlibabaOSS holds Alibaba Cloud OSS configuration. Configures the registry to use Alibaba Cloud Object Storage Service for backend storage. More about oss, you can look at the [official documentation](https://www.alibabacloud.com/help/product/31815.htm)
+     */
     @JsonProperty("encryption")
     public void setEncryption(EncryptionAlibaba encryption) {
         this.encryption = encryption;
     }
 
+    /**
+     * EndpointAccessibility specifies whether the registry use the OSS VPC internal endpoint Empty value means no opinion and the platform chooses the a default, which is subject to change over time. Currently the default is `Internal`.
+     */
     @JsonProperty("endpointAccessibility")
     public String getEndpointAccessibility() {
         return endpointAccessibility;
     }
 
+    /**
+     * EndpointAccessibility specifies whether the registry use the OSS VPC internal endpoint Empty value means no opinion and the platform chooses the a default, which is subject to change over time. Currently the default is `Internal`.
+     */
     @JsonProperty("endpointAccessibility")
     public void setEndpointAccessibility(String endpointAccessibility) {
         this.endpointAccessibility = endpointAccessibility;
     }
 
+    /**
+     * Region is the Alibaba Cloud Region in which your bucket exists. For a list of regions, you can look at the [official documentation](https://www.alibabacloud.com/help/doc-detail/31837.html). Empty value means no opinion and the platform chooses the a default, which is subject to change over time. Currently the default will be based on the installed Alibaba Cloud Region.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * Region is the Alibaba Cloud Region in which your bucket exists. For a list of regions, you can look at the [official documentation](https://www.alibabacloud.com/help/doc-detail/31837.html). Empty value means no opinion and the platform chooses the a default, which is subject to change over time. Currently the default will be based on the installed Alibaba Cloud Region.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageAzure.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageAzure.java
index d8f51b09095..1585be6c8c9 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageAzure.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageAzure.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageRegistryConfigStorageAzure holds the information to configure the registry to use Azure Blob Storage for backend storage.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ImageRegistryConfigStorageAzure(String accountName, String cloudName, Str
         this.networkAccess = networkAccess;
     }
 
+    /**
+     * accountName defines the account to be used by the registry.
+     */
     @JsonProperty("accountName")
     public String getAccountName() {
         return accountName;
     }
 
+    /**
+     * accountName defines the account to be used by the registry.
+     */
     @JsonProperty("accountName")
     public void setAccountName(String accountName) {
         this.accountName = accountName;
     }
 
+    /**
+     * cloudName is the name of the Azure cloud environment to be used by the registry. If empty, the operator will set it based on the infrastructure object.
+     */
     @JsonProperty("cloudName")
     public String getCloudName() {
         return cloudName;
     }
 
+    /**
+     * cloudName is the name of the Azure cloud environment to be used by the registry. If empty, the operator will set it based on the infrastructure object.
+     */
     @JsonProperty("cloudName")
     public void setCloudName(String cloudName) {
         this.cloudName = cloudName;
     }
 
+    /**
+     * container defines Azure's container to be used by registry.
+     */
     @JsonProperty("container")
     public String getContainer() {
         return container;
     }
 
+    /**
+     * container defines Azure's container to be used by registry.
+     */
     @JsonProperty("container")
     public void setContainer(String container) {
         this.container = container;
     }
 
+    /**
+     * ImageRegistryConfigStorageAzure holds the information to configure the registry to use Azure Blob Storage for backend storage.
+     */
     @JsonProperty("networkAccess")
     public AzureNetworkAccess getNetworkAccess() {
         return networkAccess;
     }
 
+    /**
+     * ImageRegistryConfigStorageAzure holds the information to configure the registry to use Azure Blob Storage for backend storage.
+     */
     @JsonProperty("networkAccess")
     public void setNetworkAccess(AzureNetworkAccess networkAccess) {
         this.networkAccess = networkAccess;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageEmptyDir.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageEmptyDir.java
index d1d645040bb..50b9cc1b6fc 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageEmptyDir.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageEmptyDir.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageRegistryConfigStorageEmptyDir is an place holder to be used when when registry is leveraging ephemeral storage.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageGCS.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageGCS.java
index bf59afe6548..2450a2cb53c 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageGCS.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageGCS.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageRegistryConfigStorageGCS holds GCS configuration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ImageRegistryConfigStorageGCS(String bucket, String keyID, String project
         this.region = region;
     }
 
+    /**
+     * bucket is the bucket name in which you want to store the registry's data. Optional, will be generated if not provided.
+     */
     @JsonProperty("bucket")
     public String getBucket() {
         return bucket;
     }
 
+    /**
+     * bucket is the bucket name in which you want to store the registry's data. Optional, will be generated if not provided.
+     */
     @JsonProperty("bucket")
     public void setBucket(String bucket) {
         this.bucket = bucket;
     }
 
+    /**
+     * keyID is the KMS key ID to use for encryption. Optional, buckets are encrypted by default on GCP. This allows for the use of a custom encryption key.
+     */
     @JsonProperty("keyID")
     public String getKeyID() {
         return keyID;
     }
 
+    /**
+     * keyID is the KMS key ID to use for encryption. Optional, buckets are encrypted by default on GCP. This allows for the use of a custom encryption key.
+     */
     @JsonProperty("keyID")
     public void setKeyID(String keyID) {
         this.keyID = keyID;
     }
 
+    /**
+     * projectID is the Project ID of the GCP project that this bucket should be associated with.
+     */
     @JsonProperty("projectID")
     public String getProjectID() {
         return projectID;
     }
 
+    /**
+     * projectID is the Project ID of the GCP project that this bucket should be associated with.
+     */
     @JsonProperty("projectID")
     public void setProjectID(String projectID) {
         this.projectID = projectID;
     }
 
+    /**
+     * region is the GCS location in which your bucket exists. Optional, will be set based on the installed GCS Region.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * region is the GCS location in which your bucket exists. Optional, will be set based on the installed GCS Region.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageIBMCOS.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageIBMCOS.java
index 7cd993eb588..330c6b86b76 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageIBMCOS.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageIBMCOS.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageRegistryConfigStorageIBMCOS holds the information to configure the registry to use IBM Cloud Object Storage for backend storage.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public ImageRegistryConfigStorageIBMCOS(String bucket, String location, String r
         this.serviceInstanceCRN = serviceInstanceCRN;
     }
 
+    /**
+     * bucket is the bucket name in which you want to store the registry's data. Optional, will be generated if not provided.
+     */
     @JsonProperty("bucket")
     public String getBucket() {
         return bucket;
     }
 
+    /**
+     * bucket is the bucket name in which you want to store the registry's data. Optional, will be generated if not provided.
+     */
     @JsonProperty("bucket")
     public void setBucket(String bucket) {
         this.bucket = bucket;
     }
 
+    /**
+     * location is the IBM Cloud location in which your bucket exists. Optional, will be set based on the installed IBM Cloud location.
+     */
     @JsonProperty("location")
     public String getLocation() {
         return location;
     }
 
+    /**
+     * location is the IBM Cloud location in which your bucket exists. Optional, will be set based on the installed IBM Cloud location.
+     */
     @JsonProperty("location")
     public void setLocation(String location) {
         this.location = location;
     }
 
+    /**
+     * resourceGroupName is the name of the IBM Cloud resource group that this bucket and its service instance is associated with. Optional, will be set based on the installed IBM Cloud resource group.
+     */
     @JsonProperty("resourceGroupName")
     public String getResourceGroupName() {
         return resourceGroupName;
     }
 
+    /**
+     * resourceGroupName is the name of the IBM Cloud resource group that this bucket and its service instance is associated with. Optional, will be set based on the installed IBM Cloud resource group.
+     */
     @JsonProperty("resourceGroupName")
     public void setResourceGroupName(String resourceGroupName) {
         this.resourceGroupName = resourceGroupName;
     }
 
+    /**
+     * resourceKeyCRN is the CRN of the IBM Cloud resource key that is created for the service instance. Commonly referred as a service credential and must contain HMAC type credentials. Optional, will be computed if not provided.
+     */
     @JsonProperty("resourceKeyCRN")
     public String getResourceKeyCRN() {
         return resourceKeyCRN;
     }
 
+    /**
+     * resourceKeyCRN is the CRN of the IBM Cloud resource key that is created for the service instance. Commonly referred as a service credential and must contain HMAC type credentials. Optional, will be computed if not provided.
+     */
     @JsonProperty("resourceKeyCRN")
     public void setResourceKeyCRN(String resourceKeyCRN) {
         this.resourceKeyCRN = resourceKeyCRN;
     }
 
+    /**
+     * serviceInstanceCRN is the CRN of the IBM Cloud Object Storage service instance that this bucket is associated with. Optional, will be computed if not provided.
+     */
     @JsonProperty("serviceInstanceCRN")
     public String getServiceInstanceCRN() {
         return serviceInstanceCRN;
     }
 
+    /**
+     * serviceInstanceCRN is the CRN of the IBM Cloud Object Storage service instance that this bucket is associated with. Optional, will be computed if not provided.
+     */
     @JsonProperty("serviceInstanceCRN")
     public void setServiceInstanceCRN(String serviceInstanceCRN) {
         this.serviceInstanceCRN = serviceInstanceCRN;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStoragePVC.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStoragePVC.java
index 29155c35cb3..e28b512e1ca 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStoragePVC.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStoragePVC.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageRegistryConfigStoragePVC holds Persistent Volume Claims data to be used by the registry.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ImageRegistryConfigStoragePVC(String claim) {
         this.claim = claim;
     }
 
+    /**
+     * claim defines the Persisent Volume Claim's name to be used.
+     */
     @JsonProperty("claim")
     public String getClaim() {
         return claim;
     }
 
+    /**
+     * claim defines the Persisent Volume Claim's name to be used.
+     */
     @JsonProperty("claim")
     public void setClaim(String claim) {
         this.claim = claim;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageS3.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageS3.java
index 0875dc6cc32..b40f95b5fc8 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageS3.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageS3.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageRegistryConfigStorageS3 holds the information to configure the registry to use the AWS S3 service for backend storage https://docs.docker.com/registry/storage-drivers/s3/
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -110,91 +113,145 @@ public ImageRegistryConfigStorageS3(String bucket, Integer chunkSizeMiB, ImageRe
         this.virtualHostedStyle = virtualHostedStyle;
     }
 
+    /**
+     * bucket is the bucket name in which you want to store the registry's data. Optional, will be generated if not provided.
+     */
     @JsonProperty("bucket")
     public String getBucket() {
         return bucket;
     }
 
+    /**
+     * bucket is the bucket name in which you want to store the registry's data. Optional, will be generated if not provided.
+     */
     @JsonProperty("bucket")
     public void setBucket(String bucket) {
         this.bucket = bucket;
     }
 
+    /**
+     * chunkSizeMiB defines the size of the multipart upload chunks of the S3 API. The S3 API requires multipart upload chunks to be at least 5MiB. When omitted, this means no opinion and the platform is left to choose a reasonable default, which is subject to change over time. The current default value is 10 MiB. The value is an integer number of MiB. The minimum value is 5 and the maximum value is 5120 (5 GiB).
+     */
     @JsonProperty("chunkSizeMiB")
     public Integer getChunkSizeMiB() {
         return chunkSizeMiB;
     }
 
+    /**
+     * chunkSizeMiB defines the size of the multipart upload chunks of the S3 API. The S3 API requires multipart upload chunks to be at least 5MiB. When omitted, this means no opinion and the platform is left to choose a reasonable default, which is subject to change over time. The current default value is 10 MiB. The value is an integer number of MiB. The minimum value is 5 and the maximum value is 5120 (5 GiB).
+     */
     @JsonProperty("chunkSizeMiB")
     public void setChunkSizeMiB(Integer chunkSizeMiB) {
         this.chunkSizeMiB = chunkSizeMiB;
     }
 
+    /**
+     * ImageRegistryConfigStorageS3 holds the information to configure the registry to use the AWS S3 service for backend storage https://docs.docker.com/registry/storage-drivers/s3/
+     */
     @JsonProperty("cloudFront")
     public ImageRegistryConfigStorageS3CloudFront getCloudFront() {
         return cloudFront;
     }
 
+    /**
+     * ImageRegistryConfigStorageS3 holds the information to configure the registry to use the AWS S3 service for backend storage https://docs.docker.com/registry/storage-drivers/s3/
+     */
     @JsonProperty("cloudFront")
     public void setCloudFront(ImageRegistryConfigStorageS3CloudFront cloudFront) {
         this.cloudFront = cloudFront;
     }
 
+    /**
+     * encrypt specifies whether the registry stores the image in encrypted format or not. Optional, defaults to false.
+     */
     @JsonProperty("encrypt")
     public Boolean getEncrypt() {
         return encrypt;
     }
 
+    /**
+     * encrypt specifies whether the registry stores the image in encrypted format or not. Optional, defaults to false.
+     */
     @JsonProperty("encrypt")
     public void setEncrypt(Boolean encrypt) {
         this.encrypt = encrypt;
     }
 
+    /**
+     * keyID is the KMS key ID to use for encryption. Optional, Encrypt must be true, or this parameter is ignored.
+     */
     @JsonProperty("keyID")
     public String getKeyID() {
         return keyID;
     }
 
+    /**
+     * keyID is the KMS key ID to use for encryption. Optional, Encrypt must be true, or this parameter is ignored.
+     */
     @JsonProperty("keyID")
     public void setKeyID(String keyID) {
         this.keyID = keyID;
     }
 
+    /**
+     * region is the AWS region in which your bucket exists. Optional, will be set based on the installed AWS Region.
+     */
     @JsonProperty("region")
     public String getRegion() {
         return region;
     }
 
+    /**
+     * region is the AWS region in which your bucket exists. Optional, will be set based on the installed AWS Region.
+     */
     @JsonProperty("region")
     public void setRegion(String region) {
         this.region = region;
     }
 
+    /**
+     * regionEndpoint is the endpoint for S3 compatible storage services. It should be a valid URL with scheme, e.g. https://s3.example.com. Optional, defaults based on the Region that is provided.
+     */
     @JsonProperty("regionEndpoint")
     public String getRegionEndpoint() {
         return regionEndpoint;
     }
 
+    /**
+     * regionEndpoint is the endpoint for S3 compatible storage services. It should be a valid URL with scheme, e.g. https://s3.example.com. Optional, defaults based on the Region that is provided.
+     */
     @JsonProperty("regionEndpoint")
     public void setRegionEndpoint(String regionEndpoint) {
         this.regionEndpoint = regionEndpoint;
     }
 
+    /**
+     * ImageRegistryConfigStorageS3 holds the information to configure the registry to use the AWS S3 service for backend storage https://docs.docker.com/registry/storage-drivers/s3/
+     */
     @JsonProperty("trustedCA")
     public S3TrustedCASource getTrustedCA() {
         return trustedCA;
     }
 
+    /**
+     * ImageRegistryConfigStorageS3 holds the information to configure the registry to use the AWS S3 service for backend storage https://docs.docker.com/registry/storage-drivers/s3/
+     */
     @JsonProperty("trustedCA")
     public void setTrustedCA(S3TrustedCASource trustedCA) {
         this.trustedCA = trustedCA;
     }
 
+    /**
+     * virtualHostedStyle enables using S3 virtual hosted style bucket paths with a custom RegionEndpoint Optional, defaults to false.
+     */
     @JsonProperty("virtualHostedStyle")
     public Boolean getVirtualHostedStyle() {
         return virtualHostedStyle;
     }
 
+    /**
+     * virtualHostedStyle enables using S3 virtual hosted style bucket paths with a custom RegionEndpoint Optional, defaults to false.
+     */
     @JsonProperty("virtualHostedStyle")
     public void setVirtualHostedStyle(Boolean virtualHostedStyle) {
         this.virtualHostedStyle = virtualHostedStyle;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageS3CloudFront.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageS3CloudFront.java
index 7f2402d5c2c..ccbba871d5f 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageS3CloudFront.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageS3CloudFront.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageRegistryConfigStorageS3CloudFront holds the configuration to use Amazon Cloudfront as the storage middleware in a registry. https://docs.docker.com/registry/configuration/#cloudfront
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,41 +94,65 @@ public ImageRegistryConfigStorageS3CloudFront(String baseURL, String duration, S
         this.privateKey = privateKey;
     }
 
+    /**
+     * baseURL contains the SCHEME://HOST[/PATH] at which Cloudfront is served.
+     */
     @JsonProperty("baseURL")
     public String getBaseURL() {
         return baseURL;
     }
 
+    /**
+     * baseURL contains the SCHEME://HOST[/PATH] at which Cloudfront is served.
+     */
     @JsonProperty("baseURL")
     public void setBaseURL(String baseURL) {
         this.baseURL = baseURL;
     }
 
+    /**
+     * ImageRegistryConfigStorageS3CloudFront holds the configuration to use Amazon Cloudfront as the storage middleware in a registry. https://docs.docker.com/registry/configuration/#cloudfront
+     */
     @JsonProperty("duration")
     public String getDuration() {
         return duration;
     }
 
+    /**
+     * ImageRegistryConfigStorageS3CloudFront holds the configuration to use Amazon Cloudfront as the storage middleware in a registry. https://docs.docker.com/registry/configuration/#cloudfront
+     */
     @JsonProperty("duration")
     public void setDuration(String duration) {
         this.duration = duration;
     }
 
+    /**
+     * keypairID is key pair ID provided by AWS.
+     */
     @JsonProperty("keypairID")
     public String getKeypairID() {
         return keypairID;
     }
 
+    /**
+     * keypairID is key pair ID provided by AWS.
+     */
     @JsonProperty("keypairID")
     public void setKeypairID(String keypairID) {
         this.keypairID = keypairID;
     }
 
+    /**
+     * ImageRegistryConfigStorageS3CloudFront holds the configuration to use Amazon Cloudfront as the storage middleware in a registry. https://docs.docker.com/registry/configuration/#cloudfront
+     */
     @JsonProperty("privateKey")
     public SecretKeySelector getPrivateKey() {
         return privateKey;
     }
 
+    /**
+     * ImageRegistryConfigStorageS3CloudFront holds the configuration to use Amazon Cloudfront as the storage middleware in a registry. https://docs.docker.com/registry/configuration/#cloudfront
+     */
     @JsonProperty("privateKey")
     public void setPrivateKey(SecretKeySelector privateKey) {
         this.privateKey = privateKey;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageSwift.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageSwift.java
index 2334ea271fb..91fb995baeb 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageSwift.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryConfigStorageSwift.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageRegistryConfigStorageSwift holds the information to configure the registry to use the OpenStack Swift service for backend storage https://docs.docker.com/registry/storage-drivers/swift/
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -106,81 +109,129 @@ public ImageRegistryConfigStorageSwift(String authURL, String authVersion, Strin
         this.tenantID = tenantID;
     }
 
+    /**
+     * authURL defines the URL for obtaining an authentication token.
+     */
     @JsonProperty("authURL")
     public String getAuthURL() {
         return authURL;
     }
 
+    /**
+     * authURL defines the URL for obtaining an authentication token.
+     */
     @JsonProperty("authURL")
     public void setAuthURL(String authURL) {
         this.authURL = authURL;
     }
 
+    /**
+     * authVersion specifies the OpenStack Auth's version.
+     */
     @JsonProperty("authVersion")
     public String getAuthVersion() {
         return authVersion;
     }
 
+    /**
+     * authVersion specifies the OpenStack Auth's version.
+     */
     @JsonProperty("authVersion")
     public void setAuthVersion(String authVersion) {
         this.authVersion = authVersion;
     }
 
+    /**
+     * container defines the name of Swift container where to store the registry's data.
+     */
     @JsonProperty("container")
     public String getContainer() {
         return container;
     }
 
+    /**
+     * container defines the name of Swift container where to store the registry's data.
+     */
     @JsonProperty("container")
     public void setContainer(String container) {
         this.container = container;
     }
 
+    /**
+     * domain specifies Openstack's domain name for Identity v3 API.
+     */
     @JsonProperty("domain")
     public String getDomain() {
         return domain;
     }
 
+    /**
+     * domain specifies Openstack's domain name for Identity v3 API.
+     */
     @JsonProperty("domain")
     public void setDomain(String domain) {
         this.domain = domain;
     }
 
+    /**
+     * domainID specifies Openstack's domain id for Identity v3 API.
+     */
     @JsonProperty("domainID")
     public String getDomainID() {
         return domainID;
     }
 
+    /**
+     * domainID specifies Openstack's domain id for Identity v3 API.
+     */
     @JsonProperty("domainID")
     public void setDomainID(String domainID) {
         this.domainID = domainID;
     }
 
+    /**
+     * regionName defines Openstack's region in which container exists.
+     */
     @JsonProperty("regionName")
     public String getRegionName() {
         return regionName;
     }
 
+    /**
+     * regionName defines Openstack's region in which container exists.
+     */
     @JsonProperty("regionName")
     public void setRegionName(String regionName) {
         this.regionName = regionName;
     }
 
+    /**
+     * tenant defines Openstack tenant name to be used by registry.
+     */
     @JsonProperty("tenant")
     public String getTenant() {
         return tenant;
     }
 
+    /**
+     * tenant defines Openstack tenant name to be used by registry.
+     */
     @JsonProperty("tenant")
     public void setTenant(String tenant) {
         this.tenant = tenant;
     }
 
+    /**
+     * tenant defines Openstack tenant id to be used by registry.
+     */
     @JsonProperty("tenantID")
     public String getTenantID() {
         return tenantID;
     }
 
+    /**
+     * tenant defines Openstack tenant id to be used by registry.
+     */
     @JsonProperty("tenantID")
     public void setTenantID(String tenantID) {
         this.tenantID = tenantID;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistrySpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistrySpec.java
index f56902e6c90..3240224826d 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistrySpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistrySpec.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageRegistrySpec defines the specs for the running registry.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -169,216 +172,342 @@ public ImageRegistrySpec(Affinity affinity, Boolean defaultRoute, Boolean disabl
         this.unsupportedConfigOverrides = unsupportedConfigOverrides;
     }
 
+    /**
+     * ImageRegistrySpec defines the specs for the running registry.
+     */
     @JsonProperty("affinity")
     public Affinity getAffinity() {
         return affinity;
     }
 
+    /**
+     * ImageRegistrySpec defines the specs for the running registry.
+     */
     @JsonProperty("affinity")
     public void setAffinity(Affinity affinity) {
         this.affinity = affinity;
     }
 
+    /**
+     * defaultRoute indicates whether an external facing route for the registry should be created using the default generated hostname.
+     */
     @JsonProperty("defaultRoute")
     public Boolean getDefaultRoute() {
         return defaultRoute;
     }
 
+    /**
+     * defaultRoute indicates whether an external facing route for the registry should be created using the default generated hostname.
+     */
     @JsonProperty("defaultRoute")
     public void setDefaultRoute(Boolean defaultRoute) {
         this.defaultRoute = defaultRoute;
     }
 
+    /**
+     * disableRedirect controls whether to route all data through the Registry, rather than redirecting to the backend.
+     */
     @JsonProperty("disableRedirect")
     public Boolean getDisableRedirect() {
         return disableRedirect;
     }
 
+    /**
+     * disableRedirect controls whether to route all data through the Registry, rather than redirecting to the backend.
+     */
     @JsonProperty("disableRedirect")
     public void setDisableRedirect(Boolean disableRedirect) {
         this.disableRedirect = disableRedirect;
     }
 
+    /**
+     * httpSecret is the value needed by the registry to secure uploads, generated by default.
+     */
     @JsonProperty("httpSecret")
     public String getHttpSecret() {
         return httpSecret;
     }
 
+    /**
+     * httpSecret is the value needed by the registry to secure uploads, generated by default.
+     */
     @JsonProperty("httpSecret")
     public void setHttpSecret(String httpSecret) {
         this.httpSecret = httpSecret;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * logging is deprecated, use logLevel instead.
+     */
     @JsonProperty("logging")
     public Long getLogging() {
         return logging;
     }
 
+    /**
+     * logging is deprecated, use logLevel instead.
+     */
     @JsonProperty("logging")
     public void setLogging(Long logging) {
         this.logging = logging;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
     }
 
+    /**
+     * nodeSelector defines the node selection constraints for the registry pod.
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * nodeSelector defines the node selection constraints for the registry pod.
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * ImageRegistrySpec defines the specs for the running registry.
+     */
     @JsonProperty("observedConfig")
     public Object getObservedConfig() {
         return observedConfig;
     }
 
+    /**
+     * ImageRegistrySpec defines the specs for the running registry.
+     */
     @JsonProperty("observedConfig")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setObservedConfig(Object observedConfig) {
         this.observedConfig = observedConfig;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public String getOperatorLogLevel() {
         return operatorLogLevel;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public void setOperatorLogLevel(String operatorLogLevel) {
         this.operatorLogLevel = operatorLogLevel;
     }
 
+    /**
+     * ImageRegistrySpec defines the specs for the running registry.
+     */
     @JsonProperty("proxy")
     public ImageRegistryConfigProxy getProxy() {
         return proxy;
     }
 
+    /**
+     * ImageRegistrySpec defines the specs for the running registry.
+     */
     @JsonProperty("proxy")
     public void setProxy(ImageRegistryConfigProxy proxy) {
         this.proxy = proxy;
     }
 
+    /**
+     * readOnly indicates whether the registry instance should reject attempts to push new images or delete existing ones.
+     */
     @JsonProperty("readOnly")
     public Boolean getReadOnly() {
         return readOnly;
     }
 
+    /**
+     * readOnly indicates whether the registry instance should reject attempts to push new images or delete existing ones.
+     */
     @JsonProperty("readOnly")
     public void setReadOnly(Boolean readOnly) {
         this.readOnly = readOnly;
     }
 
+    /**
+     * replicas determines the number of registry instances to run.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * replicas determines the number of registry instances to run.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * ImageRegistrySpec defines the specs for the running registry.
+     */
     @JsonProperty("requests")
     public ImageRegistryConfigRequests getRequests() {
         return requests;
     }
 
+    /**
+     * ImageRegistrySpec defines the specs for the running registry.
+     */
     @JsonProperty("requests")
     public void setRequests(ImageRegistryConfigRequests requests) {
         this.requests = requests;
     }
 
+    /**
+     * ImageRegistrySpec defines the specs for the running registry.
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * ImageRegistrySpec defines the specs for the running registry.
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * rolloutStrategy defines rollout strategy for the image registry deployment.
+     */
     @JsonProperty("rolloutStrategy")
     public String getRolloutStrategy() {
         return rolloutStrategy;
     }
 
+    /**
+     * rolloutStrategy defines rollout strategy for the image registry deployment.
+     */
     @JsonProperty("rolloutStrategy")
     public void setRolloutStrategy(String rolloutStrategy) {
         this.rolloutStrategy = rolloutStrategy;
     }
 
+    /**
+     * routes defines additional external facing routes which should be created for the registry.
+     */
     @JsonProperty("routes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ImageRegistryConfigRoute> getRoutes() {
         return routes;
     }
 
+    /**
+     * routes defines additional external facing routes which should be created for the registry.
+     */
     @JsonProperty("routes")
     public void setRoutes(List<ImageRegistryConfigRoute> routes) {
         this.routes = routes;
     }
 
+    /**
+     * ImageRegistrySpec defines the specs for the running registry.
+     */
     @JsonProperty("storage")
     public ImageRegistryConfigStorage getStorage() {
         return storage;
     }
 
+    /**
+     * ImageRegistrySpec defines the specs for the running registry.
+     */
     @JsonProperty("storage")
     public void setStorage(ImageRegistryConfigStorage storage) {
         this.storage = storage;
     }
 
+    /**
+     * tolerations defines the tolerations for the registry pod.
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * tolerations defines the tolerations for the registry pod.
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
     }
 
+    /**
+     * topologySpreadConstraints specify how to spread matching pods among the given topology.
+     */
     @JsonProperty("topologySpreadConstraints")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TopologySpreadConstraint> getTopologySpreadConstraints() {
         return topologySpreadConstraints;
     }
 
+    /**
+     * topologySpreadConstraints specify how to spread matching pods among the given topology.
+     */
     @JsonProperty("topologySpreadConstraints")
     public void setTopologySpreadConstraints(List<TopologySpreadConstraint> topologySpreadConstraints) {
         this.topologySpreadConstraints = topologySpreadConstraints;
     }
 
+    /**
+     * ImageRegistrySpec defines the specs for the running registry.
+     */
     @JsonProperty("unsupportedConfigOverrides")
     public Object getUnsupportedConfigOverrides() {
         return unsupportedConfigOverrides;
     }
 
+    /**
+     * ImageRegistrySpec defines the specs for the running registry.
+     */
     @JsonProperty("unsupportedConfigOverrides")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setUnsupportedConfigOverrides(Object unsupportedConfigOverrides) {
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryStatus.java
index 90d76c4f96c..543f5cae77f 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/ImageRegistryStatus.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageRegistryStatus reports image registry operational status.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -112,83 +115,131 @@ public ImageRegistryStatus(List<OperatorCondition> conditions, List<GenerationSt
         this.version = version;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenerationStatus> getGenerations() {
         return generations;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     public void setGenerations(List<GenerationStatus> generations) {
         this.generations = generations;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public Integer getLatestAvailableRevision() {
         return latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public void setLatestAvailableRevision(Integer latestAvailableRevision) {
         this.latestAvailableRevision = latestAvailableRevision;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * ImageRegistryStatus reports image registry operational status.
+     */
     @JsonProperty("storage")
     public ImageRegistryConfigStorage getStorage() {
         return storage;
     }
 
+    /**
+     * ImageRegistryStatus reports image registry operational status.
+     */
     @JsonProperty("storage")
     public void setStorage(ImageRegistryConfigStorage storage) {
         this.storage = storage;
     }
 
+    /**
+     * storageManaged is deprecated, please refer to Storage.managementState
+     */
     @JsonProperty("storageManaged")
     public Boolean getStorageManaged() {
         return storageManaged;
     }
 
+    /**
+     * storageManaged is deprecated, please refer to Storage.managementState
+     */
     @JsonProperty("storageManaged")
     public void setStorageManaged(Boolean storageManaged) {
         this.storageManaged = storageManaged;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/KMSEncryptionAlibaba.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/KMSEncryptionAlibaba.java
index 2bf375d8bdb..85ad36f8d13 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/KMSEncryptionAlibaba.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/KMSEncryptionAlibaba.java
@@ -78,11 +78,17 @@ public KMSEncryptionAlibaba(String keyID) {
         this.keyID = keyID;
     }
 
+    /**
+     * KeyID holds the KMS encryption key ID
+     */
     @JsonProperty("keyID")
     public String getKeyID() {
         return keyID;
     }
 
+    /**
+     * KeyID holds the KMS encryption key ID
+     */
     @JsonProperty("keyID")
     public void setKeyID(String keyID) {
         this.keyID = keyID;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/S3TrustedCASource.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/S3TrustedCASource.java
index 1908e5460ba..29f58eadbca 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/S3TrustedCASource.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/imageregistry/v1/S3TrustedCASource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * S3TrustedCASource references a config map with a CA certificate bundle in the "openshift-config" namespace. The key for the bundle in the config map is "ca-bundle.crt".
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public S3TrustedCASource(String name) {
         this.name = name;
     }
 
+    /**
+     * name is the metadata.name of the referenced config map. This field must adhere to standard config map naming restrictions. The name must consist solely of alphanumeric characters, hyphens (-) and periods (.). It has a maximum length of 253 characters. If this field is not specified or is empty string, the default trust bundle will be used.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the metadata.name of the referenced config map. This field must adhere to standard config map naming restrictions. The name must consist solely of alphanumeric characters, hyphens (-) and periods (.). It has a maximum length of 253 characters. If this field is not specified or is empty string, the default trust bundle will be used.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/ingress/v1/DNSRecord.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/ingress/v1/DNSRecord.java
index 1d88f78a6f9..c223011b559 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/ingress/v1/DNSRecord.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/ingress/v1/DNSRecord.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSRecord is a DNS record managed in the zones defined by dns.config.openshift.io/cluster .spec.publicZone and .spec.privateZone.<br><p> <br><p> Cluster admin manipulation of this resource is not supported. This resource is only for internal communication of OpenShift operators.<br><p> <br><p> If DNSManagementPolicy is "Unmanaged", the operator will not be responsible for managing the DNS records on the cloud provider.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class DNSRecord implements Editable<DNSRecordBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "ingress.operator.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DNSRecord";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DNSRecord(String apiVersion, String kind, ObjectMeta metadata, DNSRecordS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DNSRecord is a DNS record managed in the zones defined by dns.config.openshift.io/cluster .spec.publicZone and .spec.privateZone.<br><p> <br><p> Cluster admin manipulation of this resource is not supported. This resource is only for internal communication of OpenShift operators.<br><p> <br><p> If DNSManagementPolicy is "Unmanaged", the operator will not be responsible for managing the DNS records on the cloud provider.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DNSRecord is a DNS record managed in the zones defined by dns.config.openshift.io/cluster .spec.publicZone and .spec.privateZone.<br><p> <br><p> Cluster admin manipulation of this resource is not supported. This resource is only for internal communication of OpenShift operators.<br><p> <br><p> If DNSManagementPolicy is "Unmanaged", the operator will not be responsible for managing the DNS records on the cloud provider.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * DNSRecord is a DNS record managed in the zones defined by dns.config.openshift.io/cluster .spec.publicZone and .spec.privateZone.<br><p> <br><p> Cluster admin manipulation of this resource is not supported. This resource is only for internal communication of OpenShift operators.<br><p> <br><p> If DNSManagementPolicy is "Unmanaged", the operator will not be responsible for managing the DNS records on the cloud provider.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public DNSRecordSpec getSpec() {
         return spec;
     }
 
+    /**
+     * DNSRecord is a DNS record managed in the zones defined by dns.config.openshift.io/cluster .spec.publicZone and .spec.privateZone.<br><p> <br><p> Cluster admin manipulation of this resource is not supported. This resource is only for internal communication of OpenShift operators.<br><p> <br><p> If DNSManagementPolicy is "Unmanaged", the operator will not be responsible for managing the DNS records on the cloud provider.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(DNSRecordSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * DNSRecord is a DNS record managed in the zones defined by dns.config.openshift.io/cluster .spec.publicZone and .spec.privateZone.<br><p> <br><p> Cluster admin manipulation of this resource is not supported. This resource is only for internal communication of OpenShift operators.<br><p> <br><p> If DNSManagementPolicy is "Unmanaged", the operator will not be responsible for managing the DNS records on the cloud provider.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public DNSRecordStatus getStatus() {
         return status;
     }
 
+    /**
+     * DNSRecord is a DNS record managed in the zones defined by dns.config.openshift.io/cluster .spec.publicZone and .spec.privateZone.<br><p> <br><p> Cluster admin manipulation of this resource is not supported. This resource is only for internal communication of OpenShift operators.<br><p> <br><p> If DNSManagementPolicy is "Unmanaged", the operator will not be responsible for managing the DNS records on the cloud provider.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(DNSRecordStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/ingress/v1/DNSRecordList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/ingress/v1/DNSRecordList.java
index 6437b6dcff1..8c0ecd60e9c 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/ingress/v1/DNSRecordList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/ingress/v1/DNSRecordList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSRecordList contains a list of dnsrecords.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class DNSRecordList implements Editable<DNSRecordListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.ingress.v1.DNSRecord>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "ingress.operator.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.ingress.v1.DNSRecord> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DNSRecordList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DNSRecordList(String apiVersion, List<io.fabric8.openshift.api.model.oper
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * DNSRecordList contains a list of dnsrecords.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.ingress.v1.DNSRecord> getItems() {
         return items;
     }
 
+    /**
+     * DNSRecordList contains a list of dnsrecords.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.ingress.v1.DNSRecord> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DNSRecordList contains a list of dnsrecords.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DNSRecordList contains a list of dnsrecords.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/ingress/v1/DNSRecordSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/ingress/v1/DNSRecordSpec.java
index f7774219d9a..7d6958d5b84 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/ingress/v1/DNSRecordSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/ingress/v1/DNSRecordSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSRecordSpec contains the details of a DNS record.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -97,52 +100,82 @@ public DNSRecordSpec(String dnsManagementPolicy, String dnsName, Long recordTTL,
         this.targets = targets;
     }
 
+    /**
+     * dnsManagementPolicy denotes the current policy applied on the DNS record. Records that have policy set as "Unmanaged" are ignored by the ingress operator.  This means that the DNS record on the cloud provider is not managed by the operator, and the "Published" status condition will be updated to "Unknown" status, since it is externally managed. Any existing record on the cloud provider can be deleted at the discretion of the cluster admin.<br><p> <br><p> This field defaults to Managed. Valid values are "Managed" and "Unmanaged".
+     */
     @JsonProperty("dnsManagementPolicy")
     public String getDnsManagementPolicy() {
         return dnsManagementPolicy;
     }
 
+    /**
+     * dnsManagementPolicy denotes the current policy applied on the DNS record. Records that have policy set as "Unmanaged" are ignored by the ingress operator.  This means that the DNS record on the cloud provider is not managed by the operator, and the "Published" status condition will be updated to "Unknown" status, since it is externally managed. Any existing record on the cloud provider can be deleted at the discretion of the cluster admin.<br><p> <br><p> This field defaults to Managed. Valid values are "Managed" and "Unmanaged".
+     */
     @JsonProperty("dnsManagementPolicy")
     public void setDnsManagementPolicy(String dnsManagementPolicy) {
         this.dnsManagementPolicy = dnsManagementPolicy;
     }
 
+    /**
+     * dnsName is the hostname of the DNS record
+     */
     @JsonProperty("dnsName")
     public String getDnsName() {
         return dnsName;
     }
 
+    /**
+     * dnsName is the hostname of the DNS record
+     */
     @JsonProperty("dnsName")
     public void setDnsName(String dnsName) {
         this.dnsName = dnsName;
     }
 
+    /**
+     * recordTTL is the record TTL in seconds. If zero, the default is 30. RecordTTL will not be used in AWS regions Alias targets, but will be used in CNAME targets, per AWS API contract.
+     */
     @JsonProperty("recordTTL")
     public Long getRecordTTL() {
         return recordTTL;
     }
 
+    /**
+     * recordTTL is the record TTL in seconds. If zero, the default is 30. RecordTTL will not be used in AWS regions Alias targets, but will be used in CNAME targets, per AWS API contract.
+     */
     @JsonProperty("recordTTL")
     public void setRecordTTL(Long recordTTL) {
         this.recordTTL = recordTTL;
     }
 
+    /**
+     * recordType is the DNS record type. For example, "A" or "CNAME".
+     */
     @JsonProperty("recordType")
     public String getRecordType() {
         return recordType;
     }
 
+    /**
+     * recordType is the DNS record type. For example, "A" or "CNAME".
+     */
     @JsonProperty("recordType")
     public void setRecordType(String recordType) {
         this.recordType = recordType;
     }
 
+    /**
+     * targets are record targets.
+     */
     @JsonProperty("targets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getTargets() {
         return targets;
     }
 
+    /**
+     * targets are record targets.
+     */
     @JsonProperty("targets")
     public void setTargets(List<String> targets) {
         this.targets = targets;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/ingress/v1/DNSRecordStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/ingress/v1/DNSRecordStatus.java
index 3a7014b1831..33ec4dd3ece 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/ingress/v1/DNSRecordStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/ingress/v1/DNSRecordStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSRecordStatus is the most recently observed status of each record.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public DNSRecordStatus(Long observedGeneration, List<DNSZoneStatus> zones) {
         this.zones = zones;
     }
 
+    /**
+     * observedGeneration is the most recently observed generation of the DNSRecord.  When the DNSRecord is updated, the controller updates the corresponding record in each managed zone.  If an update for a particular zone fails, that failure is recorded in the status condition for the zone so that the controller can determine that it needs to retry the update for that specific zone.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the most recently observed generation of the DNSRecord.  When the DNSRecord is updated, the controller updates the corresponding record in each managed zone.  If an update for a particular zone fails, that failure is recorded in the status condition for the zone so that the controller can determine that it needs to retry the update for that specific zone.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * zones are the status of the record in each zone.
+     */
     @JsonProperty("zones")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DNSZoneStatus> getZones() {
         return zones;
     }
 
+    /**
+     * zones are the status of the record in each zone.
+     */
     @JsonProperty("zones")
     public void setZones(List<DNSZoneStatus> zones) {
         this.zones = zones;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/ingress/v1/DNSZoneCondition.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/ingress/v1/DNSZoneCondition.java
index 7177cd760aa..988f92c6b6a 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/ingress/v1/DNSZoneCondition.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/ingress/v1/DNSZoneCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSZoneCondition is just the standard condition fields.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public DNSZoneCondition(String lastTransitionTime, String message, String reason
         this.type = type;
     }
 
+    /**
+     * DNSZoneCondition is just the standard condition fields.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * DNSZoneCondition is just the standard condition fields.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * DNSZoneCondition is just the standard condition fields.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * DNSZoneCondition is just the standard condition fields.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * DNSZoneCondition is just the standard condition fields.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * DNSZoneCondition is just the standard condition fields.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * DNSZoneCondition is just the standard condition fields.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * DNSZoneCondition is just the standard condition fields.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * DNSZoneCondition is just the standard condition fields.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * DNSZoneCondition is just the standard condition fields.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/ingress/v1/DNSZoneStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/ingress/v1/DNSZoneStatus.java
index de7f5ee3b45..a143a8859ef 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/ingress/v1/DNSZoneStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/ingress/v1/DNSZoneStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSZoneStatus is the status of a record within a specific zone.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,22 +89,34 @@ public DNSZoneStatus(List<DNSZoneCondition> conditions, DNSZone dnsZone) {
         this.dnsZone = dnsZone;
     }
 
+    /**
+     * conditions are any conditions associated with the record in the zone.<br><p> <br><p> If publishing the record succeeds, the "Published" condition will be set with status "True" and upon failure it will be set to "False" along with the reason and message describing the cause of the failure.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DNSZoneCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions are any conditions associated with the record in the zone.<br><p> <br><p> If publishing the record succeeds, the "Published" condition will be set with status "True" and upon failure it will be set to "False" along with the reason and message describing the cause of the failure.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<DNSZoneCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * DNSZoneStatus is the status of a record within a specific zone.
+     */
     @JsonProperty("dnsZone")
     public DNSZone getDnsZone() {
         return dnsZone;
     }
 
+    /**
+     * DNSZoneStatus is the status of a record within a specific zone.
+     */
     @JsonProperty("dnsZone")
     public void setDnsZone(DNSZone dnsZone) {
         this.dnsZone = dnsZone;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/CertSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/CertSpec.java
index 9b5bac8770b..d52ea5ebba0 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/CertSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/CertSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CertSpec defines common certificate configuration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public CertSpec(String commonName) {
         this.commonName = commonName;
     }
 
+    /**
+     * commonName is the value in the certificate's CN
+     */
     @JsonProperty("commonName")
     public String getCommonName() {
         return commonName;
     }
 
+    /**
+     * commonName is the value in the certificate's CN
+     */
     @JsonProperty("commonName")
     public void setCommonName(String commonName) {
         this.commonName = commonName;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/EgressRouter.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/EgressRouter.java
index 438ac2ba696..efaef818e33 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/EgressRouter.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/EgressRouter.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressRouter is a feature allowing the user to define an egress router that acts as a bridge between pods and external systems. The egress router runs a service that redirects egress traffic originating from a pod or a group of pods to a remote external system or multiple destinations as per configuration.<br><p> <br><p> It is consumed by the cluster-network-operator. More specifically, given an EgressRouter CR with &lt;name&gt;, the CNO will create and manage: - A service called &lt;name&gt; - An egress pod called &lt;name&gt; - A NAD called &lt;name&gt;<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).<br><p> <br><p> EgressRouter is a single egressrouter pod configuration object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class EgressRouter implements Editable<EgressRouterBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "network.operator.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EgressRouter";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EgressRouter(String apiVersion, String kind, ObjectMeta metadata, EgressR
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EgressRouter is a feature allowing the user to define an egress router that acts as a bridge between pods and external systems. The egress router runs a service that redirects egress traffic originating from a pod or a group of pods to a remote external system or multiple destinations as per configuration.<br><p> <br><p> It is consumed by the cluster-network-operator. More specifically, given an EgressRouter CR with &lt;name&gt;, the CNO will create and manage: - A service called &lt;name&gt; - An egress pod called &lt;name&gt; - A NAD called &lt;name&gt;<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).<br><p> <br><p> EgressRouter is a single egressrouter pod configuration object.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EgressRouter is a feature allowing the user to define an egress router that acts as a bridge between pods and external systems. The egress router runs a service that redirects egress traffic originating from a pod or a group of pods to a remote external system or multiple destinations as per configuration.<br><p> <br><p> It is consumed by the cluster-network-operator. More specifically, given an EgressRouter CR with &lt;name&gt;, the CNO will create and manage: - A service called &lt;name&gt; - An egress pod called &lt;name&gt; - A NAD called &lt;name&gt;<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).<br><p> <br><p> EgressRouter is a single egressrouter pod configuration object.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * EgressRouter is a feature allowing the user to define an egress router that acts as a bridge between pods and external systems. The egress router runs a service that redirects egress traffic originating from a pod or a group of pods to a remote external system or multiple destinations as per configuration.<br><p> <br><p> It is consumed by the cluster-network-operator. More specifically, given an EgressRouter CR with &lt;name&gt;, the CNO will create and manage: - A service called &lt;name&gt; - An egress pod called &lt;name&gt; - A NAD called &lt;name&gt;<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).<br><p> <br><p> EgressRouter is a single egressrouter pod configuration object.
+     */
     @JsonProperty("spec")
     public EgressRouterSpec getSpec() {
         return spec;
     }
 
+    /**
+     * EgressRouter is a feature allowing the user to define an egress router that acts as a bridge between pods and external systems. The egress router runs a service that redirects egress traffic originating from a pod or a group of pods to a remote external system or multiple destinations as per configuration.<br><p> <br><p> It is consumed by the cluster-network-operator. More specifically, given an EgressRouter CR with &lt;name&gt;, the CNO will create and manage: - A service called &lt;name&gt; - An egress pod called &lt;name&gt; - A NAD called &lt;name&gt;<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).<br><p> <br><p> EgressRouter is a single egressrouter pod configuration object.
+     */
     @JsonProperty("spec")
     public void setSpec(EgressRouterSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * EgressRouter is a feature allowing the user to define an egress router that acts as a bridge between pods and external systems. The egress router runs a service that redirects egress traffic originating from a pod or a group of pods to a remote external system or multiple destinations as per configuration.<br><p> <br><p> It is consumed by the cluster-network-operator. More specifically, given an EgressRouter CR with &lt;name&gt;, the CNO will create and manage: - A service called &lt;name&gt; - An egress pod called &lt;name&gt; - A NAD called &lt;name&gt;<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).<br><p> <br><p> EgressRouter is a single egressrouter pod configuration object.
+     */
     @JsonProperty("status")
     public EgressRouterStatus getStatus() {
         return status;
     }
 
+    /**
+     * EgressRouter is a feature allowing the user to define an egress router that acts as a bridge between pods and external systems. The egress router runs a service that redirects egress traffic originating from a pod or a group of pods to a remote external system or multiple destinations as per configuration.<br><p> <br><p> It is consumed by the cluster-network-operator. More specifically, given an EgressRouter CR with &lt;name&gt;, the CNO will create and manage: - A service called &lt;name&gt; - An egress pod called &lt;name&gt; - A NAD called &lt;name&gt;<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).<br><p> <br><p> EgressRouter is a single egressrouter pod configuration object.
+     */
     @JsonProperty("status")
     public void setStatus(EgressRouterStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/EgressRouterAddress.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/EgressRouterAddress.java
index adec0949faa..18184251ae6 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/EgressRouterAddress.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/EgressRouterAddress.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressRouterAddress contains a pair of IP CIDR and gateway to be configured on the router's interface
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public EgressRouterAddress(String gateway, String ip) {
         this.ip = ip;
     }
 
+    /**
+     * IP address of the next-hop gateway, if it cannot be automatically determined. Can be IPv4 or IPv6.
+     */
     @JsonProperty("gateway")
     public String getGateway() {
         return gateway;
     }
 
+    /**
+     * IP address of the next-hop gateway, if it cannot be automatically determined. Can be IPv4 or IPv6.
+     */
     @JsonProperty("gateway")
     public void setGateway(String gateway) {
         this.gateway = gateway;
     }
 
+    /**
+     * IP is the address to configure on the router's interface. Can be IPv4 or IPv6.
+     */
     @JsonProperty("ip")
     public String getIp() {
         return ip;
     }
 
+    /**
+     * IP is the address to configure on the router's interface. Can be IPv4 or IPv6.
+     */
     @JsonProperty("ip")
     public void setIp(String ip) {
         this.ip = ip;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/EgressRouterInterface.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/EgressRouterInterface.java
index 90c78654dc7..7a2c033e3f9 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/EgressRouterInterface.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/EgressRouterInterface.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressRouterInterface contains the configuration of interface to create/use.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public EgressRouterInterface(MacvlanConfig macvlan) {
         this.macvlan = macvlan;
     }
 
+    /**
+     * EgressRouterInterface contains the configuration of interface to create/use.
+     */
     @JsonProperty("macvlan")
     public MacvlanConfig getMacvlan() {
         return macvlan;
     }
 
+    /**
+     * EgressRouterInterface contains the configuration of interface to create/use.
+     */
     @JsonProperty("macvlan")
     public void setMacvlan(MacvlanConfig macvlan) {
         this.macvlan = macvlan;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/EgressRouterList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/EgressRouterList.java
index b5afa61360c..f8e59124cc9 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/EgressRouterList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/EgressRouterList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressRouterList is the list of egress router pods requested.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class EgressRouterList implements Editable<EgressRouterListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.network.v1.EgressRouter>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "network.operator.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.network.v1.EgressRouter> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EgressRouterList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EgressRouterList(String apiVersion, List<io.fabric8.openshift.api.model.o
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * EgressRouterList is the list of egress router pods requested.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.network.v1.EgressRouter> getItems() {
         return items;
     }
 
+    /**
+     * EgressRouterList is the list of egress router pods requested.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.network.v1.EgressRouter> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EgressRouterList is the list of egress router pods requested.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EgressRouterList is the list of egress router pods requested.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/EgressRouterSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/EgressRouterSpec.java
index a0f86c8006a..5268ed60a02 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/EgressRouterSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/EgressRouterSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressRouterSpec contains the configuration for an egress router. Mode, networkInterface and addresses fields must be specified along with exactly one "Config" that matches the mode. Each config consists of parameters specific to that mode.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public EgressRouterSpec(List<EgressRouterAddress> addresses, String mode, Egress
         this.redirect = redirect;
     }
 
+    /**
+     * List of IP addresses to configure on the pod's secondary interface.
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EgressRouterAddress> getAddresses() {
         return addresses;
     }
 
+    /**
+     * List of IP addresses to configure on the pod's secondary interface.
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<EgressRouterAddress> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * Mode depicts the mode that is used for the egress router. The default mode is "Redirect" and is the only supported mode currently.
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Mode depicts the mode that is used for the egress router. The default mode is "Redirect" and is the only supported mode currently.
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
     }
 
+    /**
+     * EgressRouterSpec contains the configuration for an egress router. Mode, networkInterface and addresses fields must be specified along with exactly one "Config" that matches the mode. Each config consists of parameters specific to that mode.
+     */
     @JsonProperty("networkInterface")
     public EgressRouterInterface getNetworkInterface() {
         return networkInterface;
     }
 
+    /**
+     * EgressRouterSpec contains the configuration for an egress router. Mode, networkInterface and addresses fields must be specified along with exactly one "Config" that matches the mode. Each config consists of parameters specific to that mode.
+     */
     @JsonProperty("networkInterface")
     public void setNetworkInterface(EgressRouterInterface networkInterface) {
         this.networkInterface = networkInterface;
     }
 
+    /**
+     * EgressRouterSpec contains the configuration for an egress router. Mode, networkInterface and addresses fields must be specified along with exactly one "Config" that matches the mode. Each config consists of parameters specific to that mode.
+     */
     @JsonProperty("redirect")
     public RedirectConfig getRedirect() {
         return redirect;
     }
 
+    /**
+     * EgressRouterSpec contains the configuration for an egress router. Mode, networkInterface and addresses fields must be specified along with exactly one "Config" that matches the mode. Each config consists of parameters specific to that mode.
+     */
     @JsonProperty("redirect")
     public void setRedirect(RedirectConfig redirect) {
         this.redirect = redirect;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/EgressRouterStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/EgressRouterStatus.java
index 5b52c7db1d1..10faed3740a 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/EgressRouterStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/EgressRouterStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressRouterStatus contains the observed status of EgressRouter. Read-only.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public EgressRouterStatus(List<EgressRouterStatusCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Observed status of the egress router
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EgressRouterStatusCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Observed status of the egress router
+     */
     @JsonProperty("conditions")
     public void setConditions(List<EgressRouterStatusCondition> conditions) {
         this.conditions = conditions;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/EgressRouterStatusCondition.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/EgressRouterStatusCondition.java
index 1c8596946ca..5ecb59abd44 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/EgressRouterStatusCondition.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/EgressRouterStatusCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressRouterStatusCondition represents the state of the egress router's managed and monitored components.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public EgressRouterStatusCondition(String lastTransitionTime, String message, St
         this.type = type;
     }
 
+    /**
+     * EgressRouterStatusCondition represents the state of the egress router's managed and monitored components.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * EgressRouterStatusCondition represents the state of the egress router's managed and monitored components.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Message provides additional information about the current condition. This is only to be consumed by humans.  It may contain Line Feed characters (U+000A), which should be rendered as new lines.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message provides additional information about the current condition. This is only to be consumed by humans.  It may contain Line Feed characters (U+000A), which should be rendered as new lines.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Reason is the CamelCase reason for the condition's current status.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason is the CamelCase reason for the condition's current status.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type specifies the aspect reported by this condition; one of Available, Progressing, Degraded
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type specifies the aspect reported by this condition; one of Available, Progressing, Degraded
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/L4RedirectRule.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/L4RedirectRule.java
index c644eddc8d0..f48fc1d1079 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/L4RedirectRule.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/L4RedirectRule.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * L4RedirectRule defines a DNAT redirection from a given port to a destination IP and port.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public L4RedirectRule(String destinationIP, Integer port, String protocol, Integ
         this.targetPort = targetPort;
     }
 
+    /**
+     * IP specifies the remote destination's IP address. Can be IPv4 or IPv6.
+     */
     @JsonProperty("destinationIP")
     public String getDestinationIP() {
         return destinationIP;
     }
 
+    /**
+     * IP specifies the remote destination's IP address. Can be IPv4 or IPv6.
+     */
     @JsonProperty("destinationIP")
     public void setDestinationIP(String destinationIP) {
         this.destinationIP = destinationIP;
     }
 
+    /**
+     * Port is the port number to which clients should send traffic to be redirected.
+     */
     @JsonProperty("port")
     public Integer getPort() {
         return port;
     }
 
+    /**
+     * Port is the port number to which clients should send traffic to be redirected.
+     */
     @JsonProperty("port")
     public void setPort(Integer port) {
         this.port = port;
     }
 
+    /**
+     * Protocol can be TCP, SCTP or UDP.
+     */
     @JsonProperty("protocol")
     public String getProtocol() {
         return protocol;
     }
 
+    /**
+     * Protocol can be TCP, SCTP or UDP.
+     */
     @JsonProperty("protocol")
     public void setProtocol(String protocol) {
         this.protocol = protocol;
     }
 
+    /**
+     * TargetPort allows specifying the port number on the remote destination to which the traffic gets redirected to. If unspecified, the value from "Port" is used.
+     */
     @JsonProperty("targetPort")
     public Integer getTargetPort() {
         return targetPort;
     }
 
+    /**
+     * TargetPort allows specifying the port number on the remote destination to which the traffic gets redirected to. If unspecified, the value from "Port" is used.
+     */
     @JsonProperty("targetPort")
     public void setTargetPort(Integer targetPort) {
         this.targetPort = targetPort;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/MacvlanConfig.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/MacvlanConfig.java
index 8a09e59c3c2..0250818a179 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/MacvlanConfig.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/MacvlanConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MacvlanConfig consists of arguments specific to the macvlan EgressRouterInterfaceType
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public MacvlanConfig(String master, String mode) {
         this.mode = mode;
     }
 
+    /**
+     * Name of the master interface. Need not be specified if it can be inferred from the IP address.
+     */
     @JsonProperty("master")
     public String getMaster() {
         return master;
     }
 
+    /**
+     * Name of the master interface. Need not be specified if it can be inferred from the IP address.
+     */
     @JsonProperty("master")
     public void setMaster(String master) {
         this.master = master;
     }
 
+    /**
+     * Mode depicts the mode that is used for the macvlan interface; one of Bridge|Private|VEPA|Passthru. The default mode is "Bridge".
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * Mode depicts the mode that is used for the macvlan interface; one of Bridge|Private|VEPA|Passthru. The default mode is "Bridge".
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/OperatorPKI.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/OperatorPKI.java
index 9abeade5cb7..02592ef82e7 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/OperatorPKI.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/OperatorPKI.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorPKI is a simple certificate authority. It is not intended for external use - rather, it is internal to the network operator. The CNO creates a CA and a certificate signed by that CA. The certificate has both ClientAuth and ServerAuth extended usages enabled.<br><p> <br><p> 	More specifically, given an OperatorPKI with &lt;name&gt;, the CNO will manage:<br><p> <br><p> - A Secret called &lt;name&gt;-ca with two data keys:<br><p>   - tls.key - the private key<br><p>   - tls.crt - the CA certificate<br><p> <br><p> - A ConfigMap called &lt;name&gt;-ca with a single data key:<br><p>   - cabundle.crt - the CA certificate(s)<br><p> <br><p> - A Secret called &lt;name&gt;-cert with two data keys:<br><p>   - tls.key - the private key<br><p>   - tls.crt - the certificate, signed by the CA<br><p> <br><p> The CA certificate will have a validity of 10 years, rotated after 9. The target certificate will have a validity of 6 months, rotated after 3<br><p> <br><p> The CA certificate will have a CommonName of "&lt;namespace&gt;_&lt;name&gt;-ca@&lt;timestamp&gt;", where &lt;timestamp&gt; is the last rotation time.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class OperatorPKI implements Editable<OperatorPKIBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "network.operator.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OperatorPKI";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public OperatorPKI(String apiVersion, String kind, ObjectMeta metadata, Operator
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OperatorPKI is a simple certificate authority. It is not intended for external use - rather, it is internal to the network operator. The CNO creates a CA and a certificate signed by that CA. The certificate has both ClientAuth and ServerAuth extended usages enabled.<br><p> <br><p> 	More specifically, given an OperatorPKI with &lt;name&gt;, the CNO will manage:<br><p> <br><p> - A Secret called &lt;name&gt;-ca with two data keys:<br><p>   - tls.key - the private key<br><p>   - tls.crt - the CA certificate<br><p> <br><p> - A ConfigMap called &lt;name&gt;-ca with a single data key:<br><p>   - cabundle.crt - the CA certificate(s)<br><p> <br><p> - A Secret called &lt;name&gt;-cert with two data keys:<br><p>   - tls.key - the private key<br><p>   - tls.crt - the certificate, signed by the CA<br><p> <br><p> The CA certificate will have a validity of 10 years, rotated after 9. The target certificate will have a validity of 6 months, rotated after 3<br><p> <br><p> The CA certificate will have a CommonName of "&lt;namespace&gt;_&lt;name&gt;-ca@&lt;timestamp&gt;", where &lt;timestamp&gt; is the last rotation time.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OperatorPKI is a simple certificate authority. It is not intended for external use - rather, it is internal to the network operator. The CNO creates a CA and a certificate signed by that CA. The certificate has both ClientAuth and ServerAuth extended usages enabled.<br><p> <br><p> 	More specifically, given an OperatorPKI with &lt;name&gt;, the CNO will manage:<br><p> <br><p> - A Secret called &lt;name&gt;-ca with two data keys:<br><p>   - tls.key - the private key<br><p>   - tls.crt - the CA certificate<br><p> <br><p> - A ConfigMap called &lt;name&gt;-ca with a single data key:<br><p>   - cabundle.crt - the CA certificate(s)<br><p> <br><p> - A Secret called &lt;name&gt;-cert with two data keys:<br><p>   - tls.key - the private key<br><p>   - tls.crt - the certificate, signed by the CA<br><p> <br><p> The CA certificate will have a validity of 10 years, rotated after 9. The target certificate will have a validity of 6 months, rotated after 3<br><p> <br><p> The CA certificate will have a CommonName of "&lt;namespace&gt;_&lt;name&gt;-ca@&lt;timestamp&gt;", where &lt;timestamp&gt; is the last rotation time.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * OperatorPKI is a simple certificate authority. It is not intended for external use - rather, it is internal to the network operator. The CNO creates a CA and a certificate signed by that CA. The certificate has both ClientAuth and ServerAuth extended usages enabled.<br><p> <br><p> 	More specifically, given an OperatorPKI with &lt;name&gt;, the CNO will manage:<br><p> <br><p> - A Secret called &lt;name&gt;-ca with two data keys:<br><p>   - tls.key - the private key<br><p>   - tls.crt - the CA certificate<br><p> <br><p> - A ConfigMap called &lt;name&gt;-ca with a single data key:<br><p>   - cabundle.crt - the CA certificate(s)<br><p> <br><p> - A Secret called &lt;name&gt;-cert with two data keys:<br><p>   - tls.key - the private key<br><p>   - tls.crt - the certificate, signed by the CA<br><p> <br><p> The CA certificate will have a validity of 10 years, rotated after 9. The target certificate will have a validity of 6 months, rotated after 3<br><p> <br><p> The CA certificate will have a CommonName of "&lt;namespace&gt;_&lt;name&gt;-ca@&lt;timestamp&gt;", where &lt;timestamp&gt; is the last rotation time.
+     */
     @JsonProperty("spec")
     public OperatorPKISpec getSpec() {
         return spec;
     }
 
+    /**
+     * OperatorPKI is a simple certificate authority. It is not intended for external use - rather, it is internal to the network operator. The CNO creates a CA and a certificate signed by that CA. The certificate has both ClientAuth and ServerAuth extended usages enabled.<br><p> <br><p> 	More specifically, given an OperatorPKI with &lt;name&gt;, the CNO will manage:<br><p> <br><p> - A Secret called &lt;name&gt;-ca with two data keys:<br><p>   - tls.key - the private key<br><p>   - tls.crt - the CA certificate<br><p> <br><p> - A ConfigMap called &lt;name&gt;-ca with a single data key:<br><p>   - cabundle.crt - the CA certificate(s)<br><p> <br><p> - A Secret called &lt;name&gt;-cert with two data keys:<br><p>   - tls.key - the private key<br><p>   - tls.crt - the certificate, signed by the CA<br><p> <br><p> The CA certificate will have a validity of 10 years, rotated after 9. The target certificate will have a validity of 6 months, rotated after 3<br><p> <br><p> The CA certificate will have a CommonName of "&lt;namespace&gt;_&lt;name&gt;-ca@&lt;timestamp&gt;", where &lt;timestamp&gt; is the last rotation time.
+     */
     @JsonProperty("spec")
     public void setSpec(OperatorPKISpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * OperatorPKI is a simple certificate authority. It is not intended for external use - rather, it is internal to the network operator. The CNO creates a CA and a certificate signed by that CA. The certificate has both ClientAuth and ServerAuth extended usages enabled.<br><p> <br><p> 	More specifically, given an OperatorPKI with &lt;name&gt;, the CNO will manage:<br><p> <br><p> - A Secret called &lt;name&gt;-ca with two data keys:<br><p>   - tls.key - the private key<br><p>   - tls.crt - the CA certificate<br><p> <br><p> - A ConfigMap called &lt;name&gt;-ca with a single data key:<br><p>   - cabundle.crt - the CA certificate(s)<br><p> <br><p> - A Secret called &lt;name&gt;-cert with two data keys:<br><p>   - tls.key - the private key<br><p>   - tls.crt - the certificate, signed by the CA<br><p> <br><p> The CA certificate will have a validity of 10 years, rotated after 9. The target certificate will have a validity of 6 months, rotated after 3<br><p> <br><p> The CA certificate will have a CommonName of "&lt;namespace&gt;_&lt;name&gt;-ca@&lt;timestamp&gt;", where &lt;timestamp&gt; is the last rotation time.
+     */
     @JsonProperty("status")
     public OperatorPKIStatus getStatus() {
         return status;
     }
 
+    /**
+     * OperatorPKI is a simple certificate authority. It is not intended for external use - rather, it is internal to the network operator. The CNO creates a CA and a certificate signed by that CA. The certificate has both ClientAuth and ServerAuth extended usages enabled.<br><p> <br><p> 	More specifically, given an OperatorPKI with &lt;name&gt;, the CNO will manage:<br><p> <br><p> - A Secret called &lt;name&gt;-ca with two data keys:<br><p>   - tls.key - the private key<br><p>   - tls.crt - the CA certificate<br><p> <br><p> - A ConfigMap called &lt;name&gt;-ca with a single data key:<br><p>   - cabundle.crt - the CA certificate(s)<br><p> <br><p> - A Secret called &lt;name&gt;-cert with two data keys:<br><p>   - tls.key - the private key<br><p>   - tls.crt - the certificate, signed by the CA<br><p> <br><p> The CA certificate will have a validity of 10 years, rotated after 9. The target certificate will have a validity of 6 months, rotated after 3<br><p> <br><p> The CA certificate will have a CommonName of "&lt;namespace&gt;_&lt;name&gt;-ca@&lt;timestamp&gt;", where &lt;timestamp&gt; is the last rotation time.
+     */
     @JsonProperty("status")
     public void setStatus(OperatorPKIStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/OperatorPKIList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/OperatorPKIList.java
index 668646ee64a..85d2277e4cb 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/OperatorPKIList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/OperatorPKIList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorPKIList contains a list of OperatorPKI
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class OperatorPKIList implements Editable<OperatorPKIListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.network.v1.OperatorPKI>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "network.operator.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.network.v1.OperatorPKI> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OperatorPKIList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public OperatorPKIList(String apiVersion, List<io.fabric8.openshift.api.model.op
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * OperatorPKIList contains a list of OperatorPKI
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.network.v1.OperatorPKI> getItems() {
         return items;
     }
 
+    /**
+     * OperatorPKIList contains a list of OperatorPKI
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.network.v1.OperatorPKI> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OperatorPKIList contains a list of OperatorPKI
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OperatorPKIList contains a list of OperatorPKI
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/OperatorPKISpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/OperatorPKISpec.java
index 0523d9b1d69..90b1aac3b5f 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/OperatorPKISpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/OperatorPKISpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorPKISpec is the PKI configuration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public OperatorPKISpec(CertSpec targetCert) {
         this.targetCert = targetCert;
     }
 
+    /**
+     * OperatorPKISpec is the PKI configuration.
+     */
     @JsonProperty("targetCert")
     public CertSpec getTargetCert() {
         return targetCert;
     }
 
+    /**
+     * OperatorPKISpec is the PKI configuration.
+     */
     @JsonProperty("targetCert")
     public void setTargetCert(CertSpec targetCert) {
         this.targetCert = targetCert;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/OperatorPKIStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/OperatorPKIStatus.java
index d88fe734ce1..d8e042dad12 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/OperatorPKIStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/OperatorPKIStatus.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorPKIStatus is not implemented.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/RedirectConfig.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/RedirectConfig.java
index 08ec8ce51a6..39ea8561f56 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/RedirectConfig.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/network/v1/RedirectConfig.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RedirectConfig represents the configuration parameters specific to redirect mode.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public RedirectConfig(String fallbackIP, List<L4RedirectRule> redirectRules) {
         this.redirectRules = redirectRules;
     }
 
+    /**
+     * FallbackIP specifies the remote destination's IP address. Can be IPv4 or IPv6. If no redirect rules are specified, all traffic from the router are redirected to this IP. If redirect rules are specified, then any connections on any other port (undefined in the rules) on the router will be redirected to this IP. If redirect rules are specified and no fallback IP is provided, connections on other ports will simply be rejected.
+     */
     @JsonProperty("fallbackIP")
     public String getFallbackIP() {
         return fallbackIP;
     }
 
+    /**
+     * FallbackIP specifies the remote destination's IP address. Can be IPv4 or IPv6. If no redirect rules are specified, all traffic from the router are redirected to this IP. If redirect rules are specified, then any connections on any other port (undefined in the rules) on the router will be redirected to this IP. If redirect rules are specified and no fallback IP is provided, connections on other ports will simply be rejected.
+     */
     @JsonProperty("fallbackIP")
     public void setFallbackIP(String fallbackIP) {
         this.fallbackIP = fallbackIP;
     }
 
+    /**
+     * List of L4RedirectRules that define the DNAT redirection from the pod to the destination in redirect mode.
+     */
     @JsonProperty("redirectRules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<L4RedirectRule> getRedirectRules() {
         return redirectRules;
     }
 
+    /**
+     * List of L4RedirectRules that define the DNAT redirection from the pod to the destination in redirect mode.
+     */
     @JsonProperty("redirectRules")
     public void setRedirectRules(List<L4RedirectRule> redirectRules) {
         this.redirectRules = redirectRules;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AWSCSIDriverConfigSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AWSCSIDriverConfigSpec.java
index df0293be043..bca90f2da40 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AWSCSIDriverConfigSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AWSCSIDriverConfigSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSCSIDriverConfigSpec defines properties that can be configured for the AWS CSI driver.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public AWSCSIDriverConfigSpec(AWSEFSVolumeMetrics efsVolumeMetrics, String kmsKe
         this.kmsKeyARN = kmsKeyARN;
     }
 
+    /**
+     * AWSCSIDriverConfigSpec defines properties that can be configured for the AWS CSI driver.
+     */
     @JsonProperty("efsVolumeMetrics")
     public AWSEFSVolumeMetrics getEfsVolumeMetrics() {
         return efsVolumeMetrics;
     }
 
+    /**
+     * AWSCSIDriverConfigSpec defines properties that can be configured for the AWS CSI driver.
+     */
     @JsonProperty("efsVolumeMetrics")
     public void setEfsVolumeMetrics(AWSEFSVolumeMetrics efsVolumeMetrics) {
         this.efsVolumeMetrics = efsVolumeMetrics;
     }
 
+    /**
+     * kmsKeyARN sets the cluster default storage class to encrypt volumes with a user-defined KMS key, rather than the default KMS key used by AWS. The value may be either the ARN or Alias ARN of a KMS key.
+     */
     @JsonProperty("kmsKeyARN")
     public String getKmsKeyARN() {
         return kmsKeyARN;
     }
 
+    /**
+     * kmsKeyARN sets the cluster default storage class to encrypt volumes with a user-defined KMS key, rather than the default KMS key used by AWS. The value may be either the ARN or Alias ARN of a KMS key.
+     */
     @JsonProperty("kmsKeyARN")
     public void setKmsKeyARN(String kmsKeyARN) {
         this.kmsKeyARN = kmsKeyARN;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AWSClassicLoadBalancerParameters.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AWSClassicLoadBalancerParameters.java
index f71e685dd80..3c58cc21edc 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AWSClassicLoadBalancerParameters.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AWSClassicLoadBalancerParameters.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSClassicLoadBalancerParameters holds configuration parameters for an AWS Classic load balancer.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public AWSClassicLoadBalancerParameters(String connectionIdleTimeout, AWSSubnets
         this.subnets = subnets;
     }
 
+    /**
+     * AWSClassicLoadBalancerParameters holds configuration parameters for an AWS Classic load balancer.
+     */
     @JsonProperty("connectionIdleTimeout")
     public String getConnectionIdleTimeout() {
         return connectionIdleTimeout;
     }
 
+    /**
+     * AWSClassicLoadBalancerParameters holds configuration parameters for an AWS Classic load balancer.
+     */
     @JsonProperty("connectionIdleTimeout")
     public void setConnectionIdleTimeout(String connectionIdleTimeout) {
         this.connectionIdleTimeout = connectionIdleTimeout;
     }
 
+    /**
+     * AWSClassicLoadBalancerParameters holds configuration parameters for an AWS Classic load balancer.
+     */
     @JsonProperty("subnets")
     public AWSSubnets getSubnets() {
         return subnets;
     }
 
+    /**
+     * AWSClassicLoadBalancerParameters holds configuration parameters for an AWS Classic load balancer.
+     */
     @JsonProperty("subnets")
     public void setSubnets(AWSSubnets subnets) {
         this.subnets = subnets;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AWSEFSVolumeMetrics.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AWSEFSVolumeMetrics.java
index 24c5fd5f897..55729560893 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AWSEFSVolumeMetrics.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AWSEFSVolumeMetrics.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSEFSVolumeMetrics defines the configuration for volume metrics in the EFS CSI Driver.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public AWSEFSVolumeMetrics(AWSEFSVolumeMetricsRecursiveWalkConfig recursiveWalk,
         this.state = state;
     }
 
+    /**
+     * AWSEFSVolumeMetrics defines the configuration for volume metrics in the EFS CSI Driver.
+     */
     @JsonProperty("recursiveWalk")
     public AWSEFSVolumeMetricsRecursiveWalkConfig getRecursiveWalk() {
         return recursiveWalk;
     }
 
+    /**
+     * AWSEFSVolumeMetrics defines the configuration for volume metrics in the EFS CSI Driver.
+     */
     @JsonProperty("recursiveWalk")
     public void setRecursiveWalk(AWSEFSVolumeMetricsRecursiveWalkConfig recursiveWalk) {
         this.recursiveWalk = recursiveWalk;
     }
 
+    /**
+     * state defines the state of metric collection in the AWS EFS CSI Driver. This field is required and must be set to one of the following values: Disabled or RecursiveWalk. Disabled means no metrics collection will be performed. This is the default value. RecursiveWalk means the AWS EFS CSI Driver will recursively scan volumes to collect metrics. This process may result in high CPU and memory usage, depending on the volume size.
+     */
     @JsonProperty("state")
     public String getState() {
         return state;
     }
 
+    /**
+     * state defines the state of metric collection in the AWS EFS CSI Driver. This field is required and must be set to one of the following values: Disabled or RecursiveWalk. Disabled means no metrics collection will be performed. This is the default value. RecursiveWalk means the AWS EFS CSI Driver will recursively scan volumes to collect metrics. This process may result in high CPU and memory usage, depending on the volume size.
+     */
     @JsonProperty("state")
     public void setState(String state) {
         this.state = state;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AWSEFSVolumeMetricsRecursiveWalkConfig.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AWSEFSVolumeMetricsRecursiveWalkConfig.java
index d09495a67c4..63f7f187159 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AWSEFSVolumeMetricsRecursiveWalkConfig.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AWSEFSVolumeMetricsRecursiveWalkConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSEFSVolumeMetricsRecursiveWalkConfig defines options for volume metrics in the EFS CSI Driver.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public AWSEFSVolumeMetricsRecursiveWalkConfig(Integer fsRateLimit, Integer refre
         this.refreshPeriodMinutes = refreshPeriodMinutes;
     }
 
+    /**
+     * fsRateLimit defines the rate limit, in goroutines per file system, for processing volume metrics. When omitted, this means no opinion and the platform is left to choose a reasonable default, which is subject to change over time. The current default is 5. The valid range is from 1 to 100 goroutines.
+     */
     @JsonProperty("fsRateLimit")
     public Integer getFsRateLimit() {
         return fsRateLimit;
     }
 
+    /**
+     * fsRateLimit defines the rate limit, in goroutines per file system, for processing volume metrics. When omitted, this means no opinion and the platform is left to choose a reasonable default, which is subject to change over time. The current default is 5. The valid range is from 1 to 100 goroutines.
+     */
     @JsonProperty("fsRateLimit")
     public void setFsRateLimit(Integer fsRateLimit) {
         this.fsRateLimit = fsRateLimit;
     }
 
+    /**
+     * refreshPeriodMinutes specifies the frequency, in minutes, at which volume metrics are refreshed. When omitted, this means no opinion and the platform is left to choose a reasonable default, which is subject to change over time. The current default is 240. The valid range is from 1 to 43200 minutes (30 days).
+     */
     @JsonProperty("refreshPeriodMinutes")
     public Integer getRefreshPeriodMinutes() {
         return refreshPeriodMinutes;
     }
 
+    /**
+     * refreshPeriodMinutes specifies the frequency, in minutes, at which volume metrics are refreshed. When omitted, this means no opinion and the platform is left to choose a reasonable default, which is subject to change over time. The current default is 240. The valid range is from 1 to 43200 minutes (30 days).
+     */
     @JsonProperty("refreshPeriodMinutes")
     public void setRefreshPeriodMinutes(Integer refreshPeriodMinutes) {
         this.refreshPeriodMinutes = refreshPeriodMinutes;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AWSLoadBalancerParameters.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AWSLoadBalancerParameters.java
index 00bbde2a9d8..4ce43224f10 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AWSLoadBalancerParameters.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AWSLoadBalancerParameters.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSLoadBalancerParameters provides configuration settings that are specific to AWS load balancers.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public AWSLoadBalancerParameters(AWSClassicLoadBalancerParameters classicLoadBal
         this.type = type;
     }
 
+    /**
+     * AWSLoadBalancerParameters provides configuration settings that are specific to AWS load balancers.
+     */
     @JsonProperty("classicLoadBalancer")
     public AWSClassicLoadBalancerParameters getClassicLoadBalancer() {
         return classicLoadBalancer;
     }
 
+    /**
+     * AWSLoadBalancerParameters provides configuration settings that are specific to AWS load balancers.
+     */
     @JsonProperty("classicLoadBalancer")
     public void setClassicLoadBalancer(AWSClassicLoadBalancerParameters classicLoadBalancer) {
         this.classicLoadBalancer = classicLoadBalancer;
     }
 
+    /**
+     * AWSLoadBalancerParameters provides configuration settings that are specific to AWS load balancers.
+     */
     @JsonProperty("networkLoadBalancer")
     public AWSNetworkLoadBalancerParameters getNetworkLoadBalancer() {
         return networkLoadBalancer;
     }
 
+    /**
+     * AWSLoadBalancerParameters provides configuration settings that are specific to AWS load balancers.
+     */
     @JsonProperty("networkLoadBalancer")
     public void setNetworkLoadBalancer(AWSNetworkLoadBalancerParameters networkLoadBalancer) {
         this.networkLoadBalancer = networkLoadBalancer;
     }
 
+    /**
+     * type is the type of AWS load balancer to instantiate for an ingresscontroller.<br><p> <br><p> Valid values are:<br><p> <br><p> &#42; "Classic": A Classic Load Balancer that makes routing decisions at either<br><p>   the transport layer (TCP/SSL) or the application layer (HTTP/HTTPS). See<br><p>   the following for additional details:<br><p> <br><p>     https://docs.aws.amazon.com/AmazonECS/latest/developerguide/load-balancer-types.html#clb<br><p> <br><p> &#42; "NLB": A Network Load Balancer that makes routing decisions at the<br><p>   transport layer (TCP/SSL). See the following for additional details:<br><p> <br><p>     https://docs.aws.amazon.com/AmazonECS/latest/developerguide/load-balancer-types.html#nlb
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the type of AWS load balancer to instantiate for an ingresscontroller.<br><p> <br><p> Valid values are:<br><p> <br><p> &#42; "Classic": A Classic Load Balancer that makes routing decisions at either<br><p>   the transport layer (TCP/SSL) or the application layer (HTTP/HTTPS). See<br><p>   the following for additional details:<br><p> <br><p>     https://docs.aws.amazon.com/AmazonECS/latest/developerguide/load-balancer-types.html#clb<br><p> <br><p> &#42; "NLB": A Network Load Balancer that makes routing decisions at the<br><p>   transport layer (TCP/SSL). See the following for additional details:<br><p> <br><p>     https://docs.aws.amazon.com/AmazonECS/latest/developerguide/load-balancer-types.html#nlb
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AWSNetworkLoadBalancerParameters.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AWSNetworkLoadBalancerParameters.java
index d4b1d611910..28db153623e 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AWSNetworkLoadBalancerParameters.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AWSNetworkLoadBalancerParameters.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSNetworkLoadBalancerParameters holds configuration parameters for an AWS Network load balancer. For Example: Setting AWS EIPs https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/elastic-ip-addresses-eip.html
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public AWSNetworkLoadBalancerParameters(List<String> eipAllocations, AWSSubnets
         this.subnets = subnets;
     }
 
+    /**
+     * eipAllocations is a list of IDs for Elastic IP (EIP) addresses that are assigned to the Network Load Balancer. The following restrictions apply:<br><p> <br><p> eipAllocations can only be used with external scope, not internal. An EIP can be allocated to only a single IngressController. The number of EIP allocations must match the number of subnets that are used for the load balancer. Each EIP allocation must be unique. A maximum of 10 EIP allocations are permitted.<br><p> <br><p> See https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/elastic-ip-addresses-eip.html for general information about configuration, characteristics, and limitations of Elastic IP addresses.
+     */
     @JsonProperty("eipAllocations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEipAllocations() {
         return eipAllocations;
     }
 
+    /**
+     * eipAllocations is a list of IDs for Elastic IP (EIP) addresses that are assigned to the Network Load Balancer. The following restrictions apply:<br><p> <br><p> eipAllocations can only be used with external scope, not internal. An EIP can be allocated to only a single IngressController. The number of EIP allocations must match the number of subnets that are used for the load balancer. Each EIP allocation must be unique. A maximum of 10 EIP allocations are permitted.<br><p> <br><p> See https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/elastic-ip-addresses-eip.html for general information about configuration, characteristics, and limitations of Elastic IP addresses.
+     */
     @JsonProperty("eipAllocations")
     public void setEipAllocations(List<String> eipAllocations) {
         this.eipAllocations = eipAllocations;
     }
 
+    /**
+     * AWSNetworkLoadBalancerParameters holds configuration parameters for an AWS Network load balancer. For Example: Setting AWS EIPs https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/elastic-ip-addresses-eip.html
+     */
     @JsonProperty("subnets")
     public AWSSubnets getSubnets() {
         return subnets;
     }
 
+    /**
+     * AWSNetworkLoadBalancerParameters holds configuration parameters for an AWS Network load balancer. For Example: Setting AWS EIPs https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/elastic-ip-addresses-eip.html
+     */
     @JsonProperty("subnets")
     public void setSubnets(AWSSubnets subnets) {
         this.subnets = subnets;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AWSSubnets.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AWSSubnets.java
index aade0e3a84c..02d63a4b682 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AWSSubnets.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AWSSubnets.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AWSSubnets contains a list of references to AWS subnets by ID or name.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public AWSSubnets(List<String> ids, List<String> names) {
         this.names = names;
     }
 
+    /**
+     * ids specifies a list of AWS subnets by subnet ID. Subnet IDs must start with "subnet-", consist only of alphanumeric characters, must be exactly 24 characters long, must be unique, and the total number of subnets specified by ids and names must not exceed 10.
+     */
     @JsonProperty("ids")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIds() {
         return ids;
     }
 
+    /**
+     * ids specifies a list of AWS subnets by subnet ID. Subnet IDs must start with "subnet-", consist only of alphanumeric characters, must be exactly 24 characters long, must be unique, and the total number of subnets specified by ids and names must not exceed 10.
+     */
     @JsonProperty("ids")
     public void setIds(List<String> ids) {
         this.ids = ids;
     }
 
+    /**
+     * names specifies a list of AWS subnets by subnet name. Subnet names must not start with "subnet-", must not include commas, must be under 256 characters in length, must be unique, and the total number of subnets specified by ids and names must not exceed 10.
+     */
     @JsonProperty("names")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNames() {
         return names;
     }
 
+    /**
+     * names specifies a list of AWS subnets by subnet name. Subnet names must not start with "subnet-", must not include commas, must be under 256 characters in length, must be unique, and the total number of subnets specified by ids and names must not exceed 10.
+     */
     @JsonProperty("names")
     public void setNames(List<String> names) {
         this.names = names;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AccessLogging.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AccessLogging.java
index 470ab1ed35b..0128fd9db9b 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AccessLogging.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AccessLogging.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AccessLogging describes how client requests should be logged.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -97,52 +100,82 @@ public AccessLogging(LoggingDestination destination, List<IngressControllerCaptu
         this.logEmptyRequests = logEmptyRequests;
     }
 
+    /**
+     * AccessLogging describes how client requests should be logged.
+     */
     @JsonProperty("destination")
     public LoggingDestination getDestination() {
         return destination;
     }
 
+    /**
+     * AccessLogging describes how client requests should be logged.
+     */
     @JsonProperty("destination")
     public void setDestination(LoggingDestination destination) {
         this.destination = destination;
     }
 
+    /**
+     * httpCaptureCookies specifies HTTP cookies that should be captured in access logs.  If this field is empty, no cookies are captured.
+     */
     @JsonProperty("httpCaptureCookies")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IngressControllerCaptureHTTPCookie> getHttpCaptureCookies() {
         return httpCaptureCookies;
     }
 
+    /**
+     * httpCaptureCookies specifies HTTP cookies that should be captured in access logs.  If this field is empty, no cookies are captured.
+     */
     @JsonProperty("httpCaptureCookies")
     public void setHttpCaptureCookies(List<IngressControllerCaptureHTTPCookie> httpCaptureCookies) {
         this.httpCaptureCookies = httpCaptureCookies;
     }
 
+    /**
+     * AccessLogging describes how client requests should be logged.
+     */
     @JsonProperty("httpCaptureHeaders")
     public IngressControllerCaptureHTTPHeaders getHttpCaptureHeaders() {
         return httpCaptureHeaders;
     }
 
+    /**
+     * AccessLogging describes how client requests should be logged.
+     */
     @JsonProperty("httpCaptureHeaders")
     public void setHttpCaptureHeaders(IngressControllerCaptureHTTPHeaders httpCaptureHeaders) {
         this.httpCaptureHeaders = httpCaptureHeaders;
     }
 
+    /**
+     * httpLogFormat specifies the format of the log message for an HTTP request.<br><p> <br><p> If this field is empty, log messages use the implementation's default HTTP log format.  For HAProxy's default HTTP log format, see the HAProxy documentation: http://cbonte.github.io/haproxy-dconv/2.0/configuration.html#8.2.3<br><p> <br><p> Note that this format only applies to cleartext HTTP connections and to secure HTTP connections for which the ingress controller terminates encryption (that is, edge-terminated or reencrypt connections).  It does not affect the log format for TLS passthrough connections.
+     */
     @JsonProperty("httpLogFormat")
     public String getHttpLogFormat() {
         return httpLogFormat;
     }
 
+    /**
+     * httpLogFormat specifies the format of the log message for an HTTP request.<br><p> <br><p> If this field is empty, log messages use the implementation's default HTTP log format.  For HAProxy's default HTTP log format, see the HAProxy documentation: http://cbonte.github.io/haproxy-dconv/2.0/configuration.html#8.2.3<br><p> <br><p> Note that this format only applies to cleartext HTTP connections and to secure HTTP connections for which the ingress controller terminates encryption (that is, edge-terminated or reencrypt connections).  It does not affect the log format for TLS passthrough connections.
+     */
     @JsonProperty("httpLogFormat")
     public void setHttpLogFormat(String httpLogFormat) {
         this.httpLogFormat = httpLogFormat;
     }
 
+    /**
+     * logEmptyRequests specifies how connections on which no request is received should be logged.  Typically, these empty requests come from load balancers' health probes or Web browsers' speculative connections ("preconnect"), in which case logging these requests may be undesirable.  However, these requests may also be caused by network errors, in which case logging empty requests may be useful for diagnosing the errors.  In addition, these requests may be caused by port scans, in which case logging empty requests may aid in detecting intrusion attempts.  Allowed values for this field are "Log" and "Ignore".  The default value is "Log".
+     */
     @JsonProperty("logEmptyRequests")
     public String getLogEmptyRequests() {
         return logEmptyRequests;
     }
 
+    /**
+     * logEmptyRequests specifies how connections on which no request is received should be logged.  Typically, these empty requests come from load balancers' health probes or Web browsers' speculative connections ("preconnect"), in which case logging these requests may be undesirable.  However, these requests may also be caused by network errors, in which case logging empty requests may be useful for diagnosing the errors.  In addition, these requests may be caused by port scans, in which case logging empty requests may aid in detecting intrusion attempts.  Allowed values for this field are "Log" and "Ignore".  The default value is "Log".
+     */
     @JsonProperty("logEmptyRequests")
     public void setLogEmptyRequests(String logEmptyRequests) {
         this.logEmptyRequests = logEmptyRequests;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AddPage.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AddPage.java
index 994a7bb9c29..7b61f1e6694 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AddPage.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AddPage.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AddPage allows customizing actions on the Add page in developer perspective.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public AddPage(List<String> disabledActions) {
         this.disabledActions = disabledActions;
     }
 
+    /**
+     * disabledActions is a list of actions that are not shown to users. Each action in the list is represented by its ID.
+     */
     @JsonProperty("disabledActions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDisabledActions() {
         return disabledActions;
     }
 
+    /**
+     * disabledActions is a list of actions that are not shown to users. Each action in the list is represented by its ID.
+     */
     @JsonProperty("disabledActions")
     public void setDisabledActions(List<String> disabledActions) {
         this.disabledActions = disabledActions;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AdditionalNetworkDefinition.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AdditionalNetworkDefinition.java
index add6d421fbc..5749506abf8 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AdditionalNetworkDefinition.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AdditionalNetworkDefinition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AdditionalNetworkDefinition configures an extra network that is available but not created by default. Instead, pods must request them by name. type must be specified, along with exactly one "Config" that matches the type.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public AdditionalNetworkDefinition(String name, String namespace, String rawCNIC
         this.type = type;
     }
 
+    /**
+     * name is the name of the network. This will be populated in the resulting CRD This must be unique.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the network. This will be populated in the resulting CRD This must be unique.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * namespace is the namespace of the network. This will be populated in the resulting CRD If not given the network will be created in the default namespace.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * namespace is the namespace of the network. This will be populated in the resulting CRD If not given the network will be created in the default namespace.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * rawCNIConfig is the raw CNI configuration json to create in the NetworkAttachmentDefinition CRD
+     */
     @JsonProperty("rawCNIConfig")
     public String getRawCNIConfig() {
         return rawCNIConfig;
     }
 
+    /**
+     * rawCNIConfig is the raw CNI configuration json to create in the NetworkAttachmentDefinition CRD
+     */
     @JsonProperty("rawCNIConfig")
     public void setRawCNIConfig(String rawCNIConfig) {
         this.rawCNIConfig = rawCNIConfig;
     }
 
+    /**
+     * AdditionalNetworkDefinition configures an extra network that is available but not created by default. Instead, pods must request them by name. type must be specified, along with exactly one "Config" that matches the type.
+     */
     @JsonProperty("simpleMacvlanConfig")
     public SimpleMacvlanConfig getSimpleMacvlanConfig() {
         return simpleMacvlanConfig;
     }
 
+    /**
+     * AdditionalNetworkDefinition configures an extra network that is available but not created by default. Instead, pods must request them by name. type must be specified, along with exactly one "Config" that matches the type.
+     */
     @JsonProperty("simpleMacvlanConfig")
     public void setSimpleMacvlanConfig(SimpleMacvlanConfig simpleMacvlanConfig) {
         this.simpleMacvlanConfig = simpleMacvlanConfig;
     }
 
+    /**
+     * type is the type of network The supported values are NetworkTypeRaw, NetworkTypeSimpleMacvlan
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the type of network The supported values are NetworkTypeRaw, NetworkTypeSimpleMacvlan
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AdditionalRoutingCapabilities.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AdditionalRoutingCapabilities.java
index f021042885e..0ecfe74d098 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AdditionalRoutingCapabilities.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AdditionalRoutingCapabilities.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AdditionalRoutingCapabilities describes components and relevant configuration providing advanced routing capabilities.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public AdditionalRoutingCapabilities(List<String> providers) {
         this.providers = providers;
     }
 
+    /**
+     * providers is a set of enabled components that provide additional routing capabilities. Entries on this list must be unique. The  only valid value is currrently "FRR" which provides FRR routing capabilities through the deployment of FRR.
+     */
     @JsonProperty("providers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getProviders() {
         return providers;
     }
 
+    /**
+     * providers is a set of enabled components that provide additional routing capabilities. Entries on this list must be unique. The  only valid value is currrently "FRR" which provides FRR routing capabilities through the deployment of FRR.
+     */
     @JsonProperty("providers")
     public void setProviders(List<String> providers) {
         this.providers = providers;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Authentication.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Authentication.java
index 27fe990e9e2..2e6d1ceeb91 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Authentication.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Authentication.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Authentication provides information to configure an operator to manage authentication.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Authentication implements Editable<AuthenticationBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Authentication";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public Authentication(String apiVersion, String kind, ObjectMeta metadata, Authe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Authentication provides information to configure an operator to manage authentication.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Authentication provides information to configure an operator to manage authentication.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Authentication provides information to configure an operator to manage authentication.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public AuthenticationSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Authentication provides information to configure an operator to manage authentication.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(AuthenticationSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Authentication provides information to configure an operator to manage authentication.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public AuthenticationStatus getStatus() {
         return status;
     }
 
+    /**
+     * Authentication provides information to configure an operator to manage authentication.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(AuthenticationStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AuthenticationList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AuthenticationList.java
index 9735a12416e..932efa548b2 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AuthenticationList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AuthenticationList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AuthenticationList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class AuthenticationList implements Editable<AuthenticationListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.v1.Authentication>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.v1.Authentication> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AuthenticationList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public AuthenticationList(String apiVersion, List<io.fabric8.openshift.api.model
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * AuthenticationList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.v1.Authentication> getItems() {
         return items;
     }
 
+    /**
+     * AuthenticationList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.v1.Authentication> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AuthenticationList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AuthenticationList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AuthenticationSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AuthenticationSpec.java
index 7b8486b5cf8..a5f5f0a27e9 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AuthenticationSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AuthenticationSpec.java
@@ -96,21 +96,33 @@ public AuthenticationSpec(String logLevel, String managementState, Object observ
         this.unsupportedConfigOverrides = unsupportedConfigOverrides;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
@@ -127,11 +139,17 @@ public void setObservedConfig(Object observedConfig) {
         this.observedConfig = observedConfig;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public String getOperatorLogLevel() {
         return operatorLogLevel;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public void setOperatorLogLevel(String operatorLogLevel) {
         this.operatorLogLevel = operatorLogLevel;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AuthenticationStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AuthenticationStatus.java
index 924caa25378..695177f2e27 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AuthenticationStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AuthenticationStatus.java
@@ -106,33 +106,51 @@ public AuthenticationStatus(List<OperatorCondition> conditions, List<GenerationS
         this.version = version;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenerationStatus> getGenerations() {
         return generations;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     public void setGenerations(List<GenerationStatus> generations) {
         this.generations = generations;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public Integer getLatestAvailableRevision() {
         return latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public void setLatestAvailableRevision(Integer latestAvailableRevision) {
         this.latestAvailableRevision = latestAvailableRevision;
@@ -148,31 +166,49 @@ public void setOauthAPIServer(OAuthAPIServerStatus oauthAPIServer) {
         this.oauthAPIServer = oauthAPIServer;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AzureCSIDriverConfigSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AzureCSIDriverConfigSpec.java
index 9b41ba3fd9f..2702cb12f83 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AzureCSIDriverConfigSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AzureCSIDriverConfigSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzureCSIDriverConfigSpec defines properties that can be configured for the Azure CSI driver.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public AzureCSIDriverConfigSpec(AzureDiskEncryptionSet diskEncryptionSet) {
         this.diskEncryptionSet = diskEncryptionSet;
     }
 
+    /**
+     * AzureCSIDriverConfigSpec defines properties that can be configured for the Azure CSI driver.
+     */
     @JsonProperty("diskEncryptionSet")
     public AzureDiskEncryptionSet getDiskEncryptionSet() {
         return diskEncryptionSet;
     }
 
+    /**
+     * AzureCSIDriverConfigSpec defines properties that can be configured for the Azure CSI driver.
+     */
     @JsonProperty("diskEncryptionSet")
     public void setDiskEncryptionSet(AzureDiskEncryptionSet diskEncryptionSet) {
         this.diskEncryptionSet = diskEncryptionSet;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AzureDiskEncryptionSet.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AzureDiskEncryptionSet.java
index f7a91ec728c..97cc8e6a181 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AzureDiskEncryptionSet.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/AzureDiskEncryptionSet.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AzureDiskEncryptionSet defines the configuration for a disk encryption set.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public AzureDiskEncryptionSet(String name, String resourceGroup, String subscrip
         this.subscriptionID = subscriptionID;
     }
 
+    /**
+     * name is the name of the disk encryption set that will be set on the default storage class. The value should consist of only alphanumberic characters, underscores (_), hyphens, and be at most 80 characters in length.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the disk encryption set that will be set on the default storage class. The value should consist of only alphanumberic characters, underscores (_), hyphens, and be at most 80 characters in length.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * resourceGroup defines the Azure resource group that contains the disk encryption set. The value should consist of only alphanumberic characters, underscores (_), parentheses, hyphens and periods. The value should not end in a period and be at most 90 characters in length.
+     */
     @JsonProperty("resourceGroup")
     public String getResourceGroup() {
         return resourceGroup;
     }
 
+    /**
+     * resourceGroup defines the Azure resource group that contains the disk encryption set. The value should consist of only alphanumberic characters, underscores (_), parentheses, hyphens and periods. The value should not end in a period and be at most 90 characters in length.
+     */
     @JsonProperty("resourceGroup")
     public void setResourceGroup(String resourceGroup) {
         this.resourceGroup = resourceGroup;
     }
 
+    /**
+     * subscriptionID defines the Azure subscription that contains the disk encryption set. The value should meet the following conditions: 1. It should be a 128-bit number. 2. It should be 36 characters (32 hexadecimal characters and 4 hyphens) long. 3. It should be displayed in five groups separated by hyphens (-). 4. The first group should be 8 characters long. 5. The second, third, and fourth groups should be 4 characters long. 6. The fifth group should be 12 characters long. An Example SubscrionID: f2007bbf-f802-4a47-9336-cf7c6b89b378
+     */
     @JsonProperty("subscriptionID")
     public String getSubscriptionID() {
         return subscriptionID;
     }
 
+    /**
+     * subscriptionID defines the Azure subscription that contains the disk encryption set. The value should meet the following conditions: 1. It should be a 128-bit number. 2. It should be 36 characters (32 hexadecimal characters and 4 hyphens) long. 3. It should be displayed in five groups separated by hyphens (-). 4. The first group should be 8 characters long. 5. The second, third, and fourth groups should be 4 characters long. 6. The fifth group should be 12 characters long. An Example SubscrionID: f2007bbf-f802-4a47-9336-cf7c6b89b378
+     */
     @JsonProperty("subscriptionID")
     public void setSubscriptionID(String subscriptionID) {
         this.subscriptionID = subscriptionID;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CSIDriverConfigSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CSIDriverConfigSpec.java
index 4921a190d64..b933380a5d4 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CSIDriverConfigSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CSIDriverConfigSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CSIDriverConfigSpec defines configuration spec that can be used to optionally configure a specific CSI Driver.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public CSIDriverConfigSpec(AWSCSIDriverConfigSpec aws, AzureCSIDriverConfigSpec
         this.vSphere = vSphere;
     }
 
+    /**
+     * CSIDriverConfigSpec defines configuration spec that can be used to optionally configure a specific CSI Driver.
+     */
     @JsonProperty("aws")
     public AWSCSIDriverConfigSpec getAws() {
         return aws;
     }
 
+    /**
+     * CSIDriverConfigSpec defines configuration spec that can be used to optionally configure a specific CSI Driver.
+     */
     @JsonProperty("aws")
     public void setAws(AWSCSIDriverConfigSpec aws) {
         this.aws = aws;
     }
 
+    /**
+     * CSIDriverConfigSpec defines configuration spec that can be used to optionally configure a specific CSI Driver.
+     */
     @JsonProperty("azure")
     public AzureCSIDriverConfigSpec getAzure() {
         return azure;
     }
 
+    /**
+     * CSIDriverConfigSpec defines configuration spec that can be used to optionally configure a specific CSI Driver.
+     */
     @JsonProperty("azure")
     public void setAzure(AzureCSIDriverConfigSpec azure) {
         this.azure = azure;
     }
 
+    /**
+     * driverType indicates type of CSI driver for which the driverConfig is being applied to. Valid values are: AWS, Azure, GCP, IBMCloud, vSphere and omitted. Consumers should treat unknown values as a NO-OP.
+     */
     @JsonProperty("driverType")
     public String getDriverType() {
         return driverType;
     }
 
+    /**
+     * driverType indicates type of CSI driver for which the driverConfig is being applied to. Valid values are: AWS, Azure, GCP, IBMCloud, vSphere and omitted. Consumers should treat unknown values as a NO-OP.
+     */
     @JsonProperty("driverType")
     public void setDriverType(String driverType) {
         this.driverType = driverType;
     }
 
+    /**
+     * CSIDriverConfigSpec defines configuration spec that can be used to optionally configure a specific CSI Driver.
+     */
     @JsonProperty("gcp")
     public GCPCSIDriverConfigSpec getGcp() {
         return gcp;
     }
 
+    /**
+     * CSIDriverConfigSpec defines configuration spec that can be used to optionally configure a specific CSI Driver.
+     */
     @JsonProperty("gcp")
     public void setGcp(GCPCSIDriverConfigSpec gcp) {
         this.gcp = gcp;
     }
 
+    /**
+     * CSIDriverConfigSpec defines configuration spec that can be used to optionally configure a specific CSI Driver.
+     */
     @JsonProperty("ibmcloud")
     public IBMCloudCSIDriverConfigSpec getIbmcloud() {
         return ibmcloud;
     }
 
+    /**
+     * CSIDriverConfigSpec defines configuration spec that can be used to optionally configure a specific CSI Driver.
+     */
     @JsonProperty("ibmcloud")
     public void setIbmcloud(IBMCloudCSIDriverConfigSpec ibmcloud) {
         this.ibmcloud = ibmcloud;
     }
 
+    /**
+     * CSIDriverConfigSpec defines configuration spec that can be used to optionally configure a specific CSI Driver.
+     */
     @JsonProperty("vSphere")
     public VSphereCSIDriverConfigSpec getVSphere() {
         return vSphere;
     }
 
+    /**
+     * CSIDriverConfigSpec defines configuration spec that can be used to optionally configure a specific CSI Driver.
+     */
     @JsonProperty("vSphere")
     public void setVSphere(VSphereCSIDriverConfigSpec vSphere) {
         this.vSphere = vSphere;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CSISnapshotController.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CSISnapshotController.java
index 41e67da3bf7..c8676b6e1e4 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CSISnapshotController.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CSISnapshotController.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CSISnapshotController provides a means to configure an operator to manage the CSI snapshots. `cluster` is the canonical name.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class CSISnapshotController implements Editable<CSISnapshotControllerBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CSISnapshotController";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public CSISnapshotController(String apiVersion, String kind, ObjectMeta metadata
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CSISnapshotController provides a means to configure an operator to manage the CSI snapshots. `cluster` is the canonical name.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CSISnapshotController provides a means to configure an operator to manage the CSI snapshots. `cluster` is the canonical name.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * CSISnapshotController provides a means to configure an operator to manage the CSI snapshots. `cluster` is the canonical name.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public CSISnapshotControllerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * CSISnapshotController provides a means to configure an operator to manage the CSI snapshots. `cluster` is the canonical name.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(CSISnapshotControllerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * CSISnapshotController provides a means to configure an operator to manage the CSI snapshots. `cluster` is the canonical name.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public CSISnapshotControllerStatus getStatus() {
         return status;
     }
 
+    /**
+     * CSISnapshotController provides a means to configure an operator to manage the CSI snapshots. `cluster` is the canonical name.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(CSISnapshotControllerStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CSISnapshotControllerList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CSISnapshotControllerList.java
index 16dd75761bc..c295117b884 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CSISnapshotControllerList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CSISnapshotControllerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CSISnapshotControllerList contains a list of CSISnapshotControllers.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class CSISnapshotControllerList implements Editable<CSISnapshotControllerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.v1.CSISnapshotController>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.v1.CSISnapshotController> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CSISnapshotControllerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CSISnapshotControllerList(String apiVersion, List<io.fabric8.openshift.ap
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * CSISnapshotControllerList contains a list of CSISnapshotControllers.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.v1.CSISnapshotController> getItems() {
         return items;
     }
 
+    /**
+     * CSISnapshotControllerList contains a list of CSISnapshotControllers.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.v1.CSISnapshotController> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CSISnapshotControllerList contains a list of CSISnapshotControllers.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CSISnapshotControllerList contains a list of CSISnapshotControllers.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CSISnapshotControllerSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CSISnapshotControllerSpec.java
index e48ffc87cda..95a75b1e2f3 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CSISnapshotControllerSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CSISnapshotControllerSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CSISnapshotControllerSpec is the specification of the desired behavior of the CSISnapshotController operator.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -96,52 +99,82 @@ public CSISnapshotControllerSpec(String logLevel, String managementState, Object
         this.unsupportedConfigOverrides = unsupportedConfigOverrides;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
     }
 
+    /**
+     * CSISnapshotControllerSpec is the specification of the desired behavior of the CSISnapshotController operator.
+     */
     @JsonProperty("observedConfig")
     public Object getObservedConfig() {
         return observedConfig;
     }
 
+    /**
+     * CSISnapshotControllerSpec is the specification of the desired behavior of the CSISnapshotController operator.
+     */
     @JsonProperty("observedConfig")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setObservedConfig(Object observedConfig) {
         this.observedConfig = observedConfig;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public String getOperatorLogLevel() {
         return operatorLogLevel;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public void setOperatorLogLevel(String operatorLogLevel) {
         this.operatorLogLevel = operatorLogLevel;
     }
 
+    /**
+     * CSISnapshotControllerSpec is the specification of the desired behavior of the CSISnapshotController operator.
+     */
     @JsonProperty("unsupportedConfigOverrides")
     public Object getUnsupportedConfigOverrides() {
         return unsupportedConfigOverrides;
     }
 
+    /**
+     * CSISnapshotControllerSpec is the specification of the desired behavior of the CSISnapshotController operator.
+     */
     @JsonProperty("unsupportedConfigOverrides")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setUnsupportedConfigOverrides(Object unsupportedConfigOverrides) {
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CSISnapshotControllerStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CSISnapshotControllerStatus.java
index 3b551c609a2..26e7418c573 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CSISnapshotControllerStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CSISnapshotControllerStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CSISnapshotControllerStatus defines the observed status of the CSISnapshotController operator.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,63 +105,99 @@ public CSISnapshotControllerStatus(List<OperatorCondition> conditions, List<Gene
         this.version = version;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenerationStatus> getGenerations() {
         return generations;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     public void setGenerations(List<GenerationStatus> generations) {
         this.generations = generations;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public Integer getLatestAvailableRevision() {
         return latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public void setLatestAvailableRevision(Integer latestAvailableRevision) {
         this.latestAvailableRevision = latestAvailableRevision;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Capability.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Capability.java
index 45ce2158785..f75bf2afd80 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Capability.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Capability.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Capabilities contains set of UI capabilities and their state in the console UI.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Capability(String name, CapabilityVisibility visibility) {
         this.visibility = visibility;
     }
 
+    /**
+     * name is the unique name of a capability. Available capabilities are LightspeedButton and GettingStartedBanner.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the unique name of a capability. Available capabilities are LightspeedButton and GettingStartedBanner.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Capabilities contains set of UI capabilities and their state in the console UI.
+     */
     @JsonProperty("visibility")
     public CapabilityVisibility getVisibility() {
         return visibility;
     }
 
+    /**
+     * Capabilities contains set of UI capabilities and their state in the console UI.
+     */
     @JsonProperty("visibility")
     public void setVisibility(CapabilityVisibility visibility) {
         this.visibility = visibility;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CapabilityVisibility.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CapabilityVisibility.java
index 361c9df1f11..11d1fba4df5 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CapabilityVisibility.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CapabilityVisibility.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CapabilityVisibility defines the criteria to enable/disable a capability.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public CapabilityVisibility(String state) {
         this.state = state;
     }
 
+    /**
+     * state defines if the capability is enabled or disabled in the console UI. Enabling the capability in the console UI is represented by the "Enabled" value. Disabling the capability in the console UI is represented by the "Disabled" value.
+     */
     @JsonProperty("state")
     public String getState() {
         return state;
     }
 
+    /**
+     * state defines if the capability is enabled or disabled in the console UI. Enabling the capability in the console UI is represented by the "Enabled" value. Disabling the capability in the console UI is represented by the "Disabled" value.
+     */
     @JsonProperty("state")
     public void setState(String state) {
         this.state = state;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ClientTLS.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ClientTLS.java
index d499bfd623e..77c2e9f27d0 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ClientTLS.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ClientTLS.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClientTLS specifies TLS configuration to enable client-to-server authentication, which can be used for mutual TLS.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,32 +93,50 @@ public ClientTLS(List<String> allowedSubjectPatterns, ConfigMapNameReference cli
         this.clientCertificatePolicy = clientCertificatePolicy;
     }
 
+    /**
+     * allowedSubjectPatterns specifies a list of regular expressions that should be matched against the distinguished name on a valid client certificate to filter requests.  The regular expressions must use PCRE syntax.  If this list is empty, no filtering is performed.  If the list is nonempty, then at least one pattern must match a client certificate's distinguished name or else the ingress controller rejects the certificate and denies the connection.
+     */
     @JsonProperty("allowedSubjectPatterns")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAllowedSubjectPatterns() {
         return allowedSubjectPatterns;
     }
 
+    /**
+     * allowedSubjectPatterns specifies a list of regular expressions that should be matched against the distinguished name on a valid client certificate to filter requests.  The regular expressions must use PCRE syntax.  If this list is empty, no filtering is performed.  If the list is nonempty, then at least one pattern must match a client certificate's distinguished name or else the ingress controller rejects the certificate and denies the connection.
+     */
     @JsonProperty("allowedSubjectPatterns")
     public void setAllowedSubjectPatterns(List<String> allowedSubjectPatterns) {
         this.allowedSubjectPatterns = allowedSubjectPatterns;
     }
 
+    /**
+     * ClientTLS specifies TLS configuration to enable client-to-server authentication, which can be used for mutual TLS.
+     */
     @JsonProperty("clientCA")
     public ConfigMapNameReference getClientCA() {
         return clientCA;
     }
 
+    /**
+     * ClientTLS specifies TLS configuration to enable client-to-server authentication, which can be used for mutual TLS.
+     */
     @JsonProperty("clientCA")
     public void setClientCA(ConfigMapNameReference clientCA) {
         this.clientCA = clientCA;
     }
 
+    /**
+     * clientCertificatePolicy specifies whether the ingress controller requires clients to provide certificates.  This field accepts the values "Required" or "Optional".<br><p> <br><p> Note that the ingress controller only checks client certificates for edge-terminated and reencrypt TLS routes; it cannot check certificates for cleartext HTTP or passthrough TLS routes.
+     */
     @JsonProperty("clientCertificatePolicy")
     public String getClientCertificatePolicy() {
         return clientCertificatePolicy;
     }
 
+    /**
+     * clientCertificatePolicy specifies whether the ingress controller requires clients to provide certificates.  This field accepts the values "Required" or "Optional".<br><p> <br><p> Note that the ingress controller only checks client certificates for edge-terminated and reencrypt TLS routes; it cannot check certificates for cleartext HTTP or passthrough TLS routes.
+     */
     @JsonProperty("clientCertificatePolicy")
     public void setClientCertificatePolicy(String clientCertificatePolicy) {
         this.clientCertificatePolicy = clientCertificatePolicy;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CloudCredential.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CloudCredential.java
index b9dfe9a2905..129d887dab4 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CloudCredential.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CloudCredential.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CloudCredential provides a means to configure an operator to manage CredentialsRequests.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class CloudCredential implements Editable<CloudCredentialBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CloudCredential";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public CloudCredential(String apiVersion, String kind, ObjectMeta metadata, Clou
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CloudCredential provides a means to configure an operator to manage CredentialsRequests.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CloudCredential provides a means to configure an operator to manage CredentialsRequests.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * CloudCredential provides a means to configure an operator to manage CredentialsRequests.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public CloudCredentialSpec getSpec() {
         return spec;
     }
 
+    /**
+     * CloudCredential provides a means to configure an operator to manage CredentialsRequests.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(CloudCredentialSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * CloudCredential provides a means to configure an operator to manage CredentialsRequests.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public CloudCredentialStatus getStatus() {
         return status;
     }
 
+    /**
+     * CloudCredential provides a means to configure an operator to manage CredentialsRequests.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(CloudCredentialStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CloudCredentialList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CloudCredentialList.java
index 70d337d97fb..de406b40ef8 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CloudCredentialList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CloudCredentialList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class CloudCredentialList implements Editable<CloudCredentialListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.v1.CloudCredential>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.v1.CloudCredential> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CloudCredentialList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CloudCredentialList(String apiVersion, List<io.fabric8.openshift.api.mode
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.v1.CloudCredential> getItems() {
         return items;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.v1.CloudCredential> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CloudCredentialSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CloudCredentialSpec.java
index d1f0003ab37..fd1c596caed 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CloudCredentialSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CloudCredentialSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CloudCredentialSpec is the specification of the desired behavior of the cloud-credential-operator.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -100,62 +103,98 @@ public CloudCredentialSpec(String credentialsMode, String logLevel, String manag
         this.unsupportedConfigOverrides = unsupportedConfigOverrides;
     }
 
+    /**
+     * CredentialsMode allows informing CCO that it should not attempt to dynamically determine the root cloud credentials capabilities, and it should just run in the specified mode. It also allows putting the operator into "manual" mode if desired. Leaving the field in default mode runs CCO so that the cluster's cloud credentials will be dynamically probed for capabilities (on supported clouds/platforms). Supported modes:<br><p>   AWS/Azure/GCP: "" (Default), "Mint", "Passthrough", "Manual"<br><p>   Others: Do not set value as other platforms only support running in "Passthrough"
+     */
     @JsonProperty("credentialsMode")
     public String getCredentialsMode() {
         return credentialsMode;
     }
 
+    /**
+     * CredentialsMode allows informing CCO that it should not attempt to dynamically determine the root cloud credentials capabilities, and it should just run in the specified mode. It also allows putting the operator into "manual" mode if desired. Leaving the field in default mode runs CCO so that the cluster's cloud credentials will be dynamically probed for capabilities (on supported clouds/platforms). Supported modes:<br><p>   AWS/Azure/GCP: "" (Default), "Mint", "Passthrough", "Manual"<br><p>   Others: Do not set value as other platforms only support running in "Passthrough"
+     */
     @JsonProperty("credentialsMode")
     public void setCredentialsMode(String credentialsMode) {
         this.credentialsMode = credentialsMode;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
     }
 
+    /**
+     * CloudCredentialSpec is the specification of the desired behavior of the cloud-credential-operator.
+     */
     @JsonProperty("observedConfig")
     public Object getObservedConfig() {
         return observedConfig;
     }
 
+    /**
+     * CloudCredentialSpec is the specification of the desired behavior of the cloud-credential-operator.
+     */
     @JsonProperty("observedConfig")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setObservedConfig(Object observedConfig) {
         this.observedConfig = observedConfig;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public String getOperatorLogLevel() {
         return operatorLogLevel;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public void setOperatorLogLevel(String operatorLogLevel) {
         this.operatorLogLevel = operatorLogLevel;
     }
 
+    /**
+     * CloudCredentialSpec is the specification of the desired behavior of the cloud-credential-operator.
+     */
     @JsonProperty("unsupportedConfigOverrides")
     public Object getUnsupportedConfigOverrides() {
         return unsupportedConfigOverrides;
     }
 
+    /**
+     * CloudCredentialSpec is the specification of the desired behavior of the cloud-credential-operator.
+     */
     @JsonProperty("unsupportedConfigOverrides")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setUnsupportedConfigOverrides(Object unsupportedConfigOverrides) {
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CloudCredentialStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CloudCredentialStatus.java
index 430b55ea3a6..6884f41c67f 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CloudCredentialStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/CloudCredentialStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CloudCredentialStatus defines the observed status of the cloud-credential-operator.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,63 +105,99 @@ public CloudCredentialStatus(List<OperatorCondition> conditions, List<Generation
         this.version = version;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenerationStatus> getGenerations() {
         return generations;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     public void setGenerations(List<GenerationStatus> generations) {
         this.generations = generations;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public Integer getLatestAvailableRevision() {
         return latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public void setLatestAvailableRevision(Integer latestAvailableRevision) {
         this.latestAvailableRevision = latestAvailableRevision;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ClusterCSIDriver.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ClusterCSIDriver.java
index 64247d4b920..90a19aa5796 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ClusterCSIDriver.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ClusterCSIDriver.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterCSIDriver object allows management and configuration of a CSI driver operator installed by default in OpenShift. Name of the object must be name of the CSI driver it operates. See CSIDriverName type for list of allowed values.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ClusterCSIDriver implements Editable<ClusterCSIDriverBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterCSIDriver";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public ClusterCSIDriver(String apiVersion, String kind, ObjectMeta metadata, Clu
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterCSIDriver object allows management and configuration of a CSI driver operator installed by default in OpenShift. Name of the object must be name of the CSI driver it operates. See CSIDriverName type for list of allowed values.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterCSIDriver object allows management and configuration of a CSI driver operator installed by default in OpenShift. Name of the object must be name of the CSI driver it operates. See CSIDriverName type for list of allowed values.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ClusterCSIDriver object allows management and configuration of a CSI driver operator installed by default in OpenShift. Name of the object must be name of the CSI driver it operates. See CSIDriverName type for list of allowed values.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ClusterCSIDriverSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ClusterCSIDriver object allows management and configuration of a CSI driver operator installed by default in OpenShift. Name of the object must be name of the CSI driver it operates. See CSIDriverName type for list of allowed values.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ClusterCSIDriverSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ClusterCSIDriver object allows management and configuration of a CSI driver operator installed by default in OpenShift. Name of the object must be name of the CSI driver it operates. See CSIDriverName type for list of allowed values.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public ClusterCSIDriverStatus getStatus() {
         return status;
     }
 
+    /**
+     * ClusterCSIDriver object allows management and configuration of a CSI driver operator installed by default in OpenShift. Name of the object must be name of the CSI driver it operates. See CSIDriverName type for list of allowed values.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(ClusterCSIDriverStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ClusterCSIDriverList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ClusterCSIDriverList.java
index 8c69104f160..30cf5053c88 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ClusterCSIDriverList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ClusterCSIDriverList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterCSIDriverList contains a list of ClusterCSIDriver<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ClusterCSIDriverList implements Editable<ClusterCSIDriverListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.v1.ClusterCSIDriver>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.v1.ClusterCSIDriver> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterCSIDriverList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterCSIDriverList(String apiVersion, List<io.fabric8.openshift.api.mod
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ClusterCSIDriverList contains a list of ClusterCSIDriver<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.v1.ClusterCSIDriver> getItems() {
         return items;
     }
 
+    /**
+     * ClusterCSIDriverList contains a list of ClusterCSIDriver<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.v1.ClusterCSIDriver> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterCSIDriverList contains a list of ClusterCSIDriver<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterCSIDriverList contains a list of ClusterCSIDriver<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ClusterCSIDriverSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ClusterCSIDriverSpec.java
index de1412231cb..30ff9237674 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ClusterCSIDriverSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ClusterCSIDriverSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterCSIDriverSpec is the desired behavior of CSI driver operator
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -104,72 +107,114 @@ public ClusterCSIDriverSpec(CSIDriverConfigSpec driverConfig, String logLevel, S
         this.unsupportedConfigOverrides = unsupportedConfigOverrides;
     }
 
+    /**
+     * ClusterCSIDriverSpec is the desired behavior of CSI driver operator
+     */
     @JsonProperty("driverConfig")
     public CSIDriverConfigSpec getDriverConfig() {
         return driverConfig;
     }
 
+    /**
+     * ClusterCSIDriverSpec is the desired behavior of CSI driver operator
+     */
     @JsonProperty("driverConfig")
     public void setDriverConfig(CSIDriverConfigSpec driverConfig) {
         this.driverConfig = driverConfig;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
     }
 
+    /**
+     * ClusterCSIDriverSpec is the desired behavior of CSI driver operator
+     */
     @JsonProperty("observedConfig")
     public Object getObservedConfig() {
         return observedConfig;
     }
 
+    /**
+     * ClusterCSIDriverSpec is the desired behavior of CSI driver operator
+     */
     @JsonProperty("observedConfig")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setObservedConfig(Object observedConfig) {
         this.observedConfig = observedConfig;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public String getOperatorLogLevel() {
         return operatorLogLevel;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public void setOperatorLogLevel(String operatorLogLevel) {
         this.operatorLogLevel = operatorLogLevel;
     }
 
+    /**
+     * StorageClassState determines if CSI operator should create and manage storage classes. If this field value is empty or Managed - CSI operator will continuously reconcile storage class and create if necessary. If this field value is Unmanaged - CSI operator will not reconcile any previously created storage class. If this field value is Removed - CSI operator will delete the storage class it created previously. When omitted, this means the user has no opinion and the platform chooses a reasonable default, which is subject to change over time. The current default behaviour is Managed.
+     */
     @JsonProperty("storageClassState")
     public String getStorageClassState() {
         return storageClassState;
     }
 
+    /**
+     * StorageClassState determines if CSI operator should create and manage storage classes. If this field value is empty or Managed - CSI operator will continuously reconcile storage class and create if necessary. If this field value is Unmanaged - CSI operator will not reconcile any previously created storage class. If this field value is Removed - CSI operator will delete the storage class it created previously. When omitted, this means the user has no opinion and the platform chooses a reasonable default, which is subject to change over time. The current default behaviour is Managed.
+     */
     @JsonProperty("storageClassState")
     public void setStorageClassState(String storageClassState) {
         this.storageClassState = storageClassState;
     }
 
+    /**
+     * ClusterCSIDriverSpec is the desired behavior of CSI driver operator
+     */
     @JsonProperty("unsupportedConfigOverrides")
     public Object getUnsupportedConfigOverrides() {
         return unsupportedConfigOverrides;
     }
 
+    /**
+     * ClusterCSIDriverSpec is the desired behavior of CSI driver operator
+     */
     @JsonProperty("unsupportedConfigOverrides")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setUnsupportedConfigOverrides(Object unsupportedConfigOverrides) {
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ClusterCSIDriverStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ClusterCSIDriverStatus.java
index d09f893caf8..d307a57c251 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ClusterCSIDriverStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ClusterCSIDriverStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterCSIDriverStatus is the observed status of CSI driver operator
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,63 +105,99 @@ public ClusterCSIDriverStatus(List<OperatorCondition> conditions, List<Generatio
         this.version = version;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenerationStatus> getGenerations() {
         return generations;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     public void setGenerations(List<GenerationStatus> generations) {
         this.generations = generations;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public Integer getLatestAvailableRevision() {
         return latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public void setLatestAvailableRevision(Integer latestAvailableRevision) {
         this.latestAvailableRevision = latestAvailableRevision;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ClusterNetworkEntry.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ClusterNetworkEntry.java
index c77e27701d8..78784aaf7f6 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ClusterNetworkEntry.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ClusterNetworkEntry.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterNetworkEntry is a subnet from which to allocate PodIPs. A network of size HostPrefix (in CIDR notation) will be allocated when nodes join the cluster. If the HostPrefix field is not used by the plugin, it can be left unset. Not all network providers support multiple ClusterNetworks
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ClusterNetworkEntry(String cidr, Long hostPrefix) {
         this.hostPrefix = hostPrefix;
     }
 
+    /**
+     * ClusterNetworkEntry is a subnet from which to allocate PodIPs. A network of size HostPrefix (in CIDR notation) will be allocated when nodes join the cluster. If the HostPrefix field is not used by the plugin, it can be left unset. Not all network providers support multiple ClusterNetworks
+     */
     @JsonProperty("cidr")
     public String getCidr() {
         return cidr;
     }
 
+    /**
+     * ClusterNetworkEntry is a subnet from which to allocate PodIPs. A network of size HostPrefix (in CIDR notation) will be allocated when nodes join the cluster. If the HostPrefix field is not used by the plugin, it can be left unset. Not all network providers support multiple ClusterNetworks
+     */
     @JsonProperty("cidr")
     public void setCidr(String cidr) {
         this.cidr = cidr;
     }
 
+    /**
+     * ClusterNetworkEntry is a subnet from which to allocate PodIPs. A network of size HostPrefix (in CIDR notation) will be allocated when nodes join the cluster. If the HostPrefix field is not used by the plugin, it can be left unset. Not all network providers support multiple ClusterNetworks
+     */
     @JsonProperty("hostPrefix")
     public Long getHostPrefix() {
         return hostPrefix;
     }
 
+    /**
+     * ClusterNetworkEntry is a subnet from which to allocate PodIPs. A network of size HostPrefix (in CIDR notation) will be allocated when nodes join the cluster. If the HostPrefix field is not used by the plugin, it can be left unset. Not all network providers support multiple ClusterNetworks
+     */
     @JsonProperty("hostPrefix")
     public void setHostPrefix(Long hostPrefix) {
         this.hostPrefix = hostPrefix;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Config.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Config.java
index 09cad846a2a..baeb19f099b 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Config.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Config.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Config specifies the behavior of the config operator which is responsible for creating the initial configuration of other components on the cluster.  The operator also handles installation, migration or synchronization of cloud configurations for AWS and Azure cloud based clusters<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Config implements Editable<ConfigBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Config";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public Config(String apiVersion, String kind, ObjectMeta metadata, ConfigSpec sp
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Config specifies the behavior of the config operator which is responsible for creating the initial configuration of other components on the cluster.  The operator also handles installation, migration or synchronization of cloud configurations for AWS and Azure cloud based clusters<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Config specifies the behavior of the config operator which is responsible for creating the initial configuration of other components on the cluster.  The operator also handles installation, migration or synchronization of cloud configurations for AWS and Azure cloud based clusters<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Config specifies the behavior of the config operator which is responsible for creating the initial configuration of other components on the cluster.  The operator also handles installation, migration or synchronization of cloud configurations for AWS and Azure cloud based clusters<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ConfigSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Config specifies the behavior of the config operator which is responsible for creating the initial configuration of other components on the cluster.  The operator also handles installation, migration or synchronization of cloud configurations for AWS and Azure cloud based clusters<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ConfigSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Config specifies the behavior of the config operator which is responsible for creating the initial configuration of other components on the cluster.  The operator also handles installation, migration or synchronization of cloud configurations for AWS and Azure cloud based clusters<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public ConfigStatus getStatus() {
         return status;
     }
 
+    /**
+     * Config specifies the behavior of the config operator which is responsible for creating the initial configuration of other components on the cluster.  The operator also handles installation, migration or synchronization of cloud configurations for AWS and Azure cloud based clusters<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(ConfigStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConfigList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConfigList.java
index d38752515d5..134c894a53a 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConfigList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConfigList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConfigList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ConfigList implements Editable<ConfigListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.v1.Config>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.v1.Config> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ConfigList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ConfigList(String apiVersion, List<io.fabric8.openshift.api.model.operato
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items contains the items
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.v1.Config> getItems() {
         return items;
     }
 
+    /**
+     * Items contains the items
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.v1.Config> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ConfigList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ConfigList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConfigSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConfigSpec.java
index 31ed5b8dd87..09e4ad58785 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConfigSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConfigSpec.java
@@ -96,21 +96,33 @@ public ConfigSpec(String logLevel, String managementState, Object observedConfig
         this.unsupportedConfigOverrides = unsupportedConfigOverrides;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
@@ -127,11 +139,17 @@ public void setObservedConfig(Object observedConfig) {
         this.observedConfig = observedConfig;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public String getOperatorLogLevel() {
         return operatorLogLevel;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public void setOperatorLogLevel(String operatorLogLevel) {
         this.operatorLogLevel = operatorLogLevel;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConfigStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConfigStatus.java
index 992592cd17d..3b2fa3862a2 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConfigStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConfigStatus.java
@@ -102,63 +102,99 @@ public ConfigStatus(List<OperatorCondition> conditions, List<GenerationStatus> g
         this.version = version;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenerationStatus> getGenerations() {
         return generations;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     public void setGenerations(List<GenerationStatus> generations) {
         this.generations = generations;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public Integer getLatestAvailableRevision() {
         return latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public void setLatestAvailableRevision(Integer latestAvailableRevision) {
         this.latestAvailableRevision = latestAvailableRevision;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Console.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Console.java
index 9467f9cab50..8aea720f039 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Console.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Console.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Console provides a means to configure an operator to manage the console.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Console implements Editable<ConsoleBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Console";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public Console(String apiVersion, String kind, ObjectMeta metadata, ConsoleSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Console provides a means to configure an operator to manage the console.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Console provides a means to configure an operator to manage the console.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Console provides a means to configure an operator to manage the console.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ConsoleSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Console provides a means to configure an operator to manage the console.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ConsoleSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Console provides a means to configure an operator to manage the console.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public ConsoleStatus getStatus() {
         return status;
     }
 
+    /**
+     * Console provides a means to configure an operator to manage the console.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(ConsoleStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConsoleConfigRoute.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConsoleConfigRoute.java
index aedb4760a7c..02fbde742b3 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConsoleConfigRoute.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConsoleConfigRoute.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleConfigRoute holds information on external route access to console. DEPRECATED
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public ConsoleConfigRoute(String hostname, SecretNameReference secret) {
         this.secret = secret;
     }
 
+    /**
+     * hostname is the desired custom domain under which console will be available.
+     */
     @JsonProperty("hostname")
     public String getHostname() {
         return hostname;
     }
 
+    /**
+     * hostname is the desired custom domain under which console will be available.
+     */
     @JsonProperty("hostname")
     public void setHostname(String hostname) {
         this.hostname = hostname;
     }
 
+    /**
+     * ConsoleConfigRoute holds information on external route access to console. DEPRECATED
+     */
     @JsonProperty("secret")
     public SecretNameReference getSecret() {
         return secret;
     }
 
+    /**
+     * ConsoleConfigRoute holds information on external route access to console. DEPRECATED
+     */
     @JsonProperty("secret")
     public void setSecret(SecretNameReference secret) {
         this.secret = secret;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConsoleCustomization.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConsoleCustomization.java
index 999084c2918..8cd04b5f351 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConsoleCustomization.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConsoleCustomization.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleCustomization defines a list of optional configuration for the console UI.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -119,103 +122,163 @@ public ConsoleCustomization(AddPage addPage, String brand, List<Capability> capa
         this.quickStarts = quickStarts;
     }
 
+    /**
+     * ConsoleCustomization defines a list of optional configuration for the console UI.
+     */
     @JsonProperty("addPage")
     public AddPage getAddPage() {
         return addPage;
     }
 
+    /**
+     * ConsoleCustomization defines a list of optional configuration for the console UI.
+     */
     @JsonProperty("addPage")
     public void setAddPage(AddPage addPage) {
         this.addPage = addPage;
     }
 
+    /**
+     * brand is the default branding of the web console which can be overridden by providing the brand field.  There is a limited set of specific brand options. This field controls elements of the console such as the logo. Invalid value will prevent a console rollout.
+     */
     @JsonProperty("brand")
     public String getBrand() {
         return brand;
     }
 
+    /**
+     * brand is the default branding of the web console which can be overridden by providing the brand field.  There is a limited set of specific brand options. This field controls elements of the console such as the logo. Invalid value will prevent a console rollout.
+     */
     @JsonProperty("brand")
     public void setBrand(String brand) {
         this.brand = brand;
     }
 
+    /**
+     * capabilities defines an array of capabilities that can be interacted with in the console UI. Each capability defines a visual state that can be interacted with the console to render in the UI. Available capabilities are LightspeedButton and GettingStartedBanner. Each of the available capabilities may appear only once in the list.
+     */
     @JsonProperty("capabilities")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Capability> getCapabilities() {
         return capabilities;
     }
 
+    /**
+     * capabilities defines an array of capabilities that can be interacted with in the console UI. Each capability defines a visual state that can be interacted with the console to render in the UI. Available capabilities are LightspeedButton and GettingStartedBanner. Each of the available capabilities may appear only once in the list.
+     */
     @JsonProperty("capabilities")
     public void setCapabilities(List<Capability> capabilities) {
         this.capabilities = capabilities;
     }
 
+    /**
+     * ConsoleCustomization defines a list of optional configuration for the console UI.
+     */
     @JsonProperty("customLogoFile")
     public ConfigMapFileReference getCustomLogoFile() {
         return customLogoFile;
     }
 
+    /**
+     * ConsoleCustomization defines a list of optional configuration for the console UI.
+     */
     @JsonProperty("customLogoFile")
     public void setCustomLogoFile(ConfigMapFileReference customLogoFile) {
         this.customLogoFile = customLogoFile;
     }
 
+    /**
+     * customProductName is the name that will be displayed in page titles, logo alt text, and the about dialog instead of the normal OpenShift product name.
+     */
     @JsonProperty("customProductName")
     public String getCustomProductName() {
         return customProductName;
     }
 
+    /**
+     * customProductName is the name that will be displayed in page titles, logo alt text, and the about dialog instead of the normal OpenShift product name.
+     */
     @JsonProperty("customProductName")
     public void setCustomProductName(String customProductName) {
         this.customProductName = customProductName;
     }
 
+    /**
+     * ConsoleCustomization defines a list of optional configuration for the console UI.
+     */
     @JsonProperty("developerCatalog")
     public DeveloperConsoleCatalogCustomization getDeveloperCatalog() {
         return developerCatalog;
     }
 
+    /**
+     * ConsoleCustomization defines a list of optional configuration for the console UI.
+     */
     @JsonProperty("developerCatalog")
     public void setDeveloperCatalog(DeveloperConsoleCatalogCustomization developerCatalog) {
         this.developerCatalog = developerCatalog;
     }
 
+    /**
+     * documentationBaseURL links to external documentation are shown in various sections of the web console.  Providing documentationBaseURL will override the default documentation URL. Invalid value will prevent a console rollout.
+     */
     @JsonProperty("documentationBaseURL")
     public String getDocumentationBaseURL() {
         return documentationBaseURL;
     }
 
+    /**
+     * documentationBaseURL links to external documentation are shown in various sections of the web console.  Providing documentationBaseURL will override the default documentation URL. Invalid value will prevent a console rollout.
+     */
     @JsonProperty("documentationBaseURL")
     public void setDocumentationBaseURL(String documentationBaseURL) {
         this.documentationBaseURL = documentationBaseURL;
     }
 
+    /**
+     * perspectives allows enabling/disabling of perspective(s) that user can see in the Perspective switcher dropdown.
+     */
     @JsonProperty("perspectives")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Perspective> getPerspectives() {
         return perspectives;
     }
 
+    /**
+     * perspectives allows enabling/disabling of perspective(s) that user can see in the Perspective switcher dropdown.
+     */
     @JsonProperty("perspectives")
     public void setPerspectives(List<Perspective> perspectives) {
         this.perspectives = perspectives;
     }
 
+    /**
+     * ConsoleCustomization defines a list of optional configuration for the console UI.
+     */
     @JsonProperty("projectAccess")
     public ProjectAccess getProjectAccess() {
         return projectAccess;
     }
 
+    /**
+     * ConsoleCustomization defines a list of optional configuration for the console UI.
+     */
     @JsonProperty("projectAccess")
     public void setProjectAccess(ProjectAccess projectAccess) {
         this.projectAccess = projectAccess;
     }
 
+    /**
+     * ConsoleCustomization defines a list of optional configuration for the console UI.
+     */
     @JsonProperty("quickStarts")
     public QuickStarts getQuickStarts() {
         return quickStarts;
     }
 
+    /**
+     * ConsoleCustomization defines a list of optional configuration for the console UI.
+     */
     @JsonProperty("quickStarts")
     public void setQuickStarts(QuickStarts quickStarts) {
         this.quickStarts = quickStarts;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConsoleList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConsoleList.java
index a38a1b8452f..52ae399dc6e 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConsoleList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConsoleList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ConsoleList implements Editable<ConsoleListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.v1.Console>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.v1.Console> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ConsoleList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ConsoleList(String apiVersion, List<io.fabric8.openshift.api.model.operat
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.v1.Console> getItems() {
         return items;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.v1.Console> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConsoleProviders.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConsoleProviders.java
index c13cb71a1aa..a85cdedcefd 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConsoleProviders.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConsoleProviders.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleProviders defines a list of optional additional providers of functionality to the console.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ConsoleProviders(StatuspageProvider statuspage) {
         this.statuspage = statuspage;
     }
 
+    /**
+     * ConsoleProviders defines a list of optional additional providers of functionality to the console.
+     */
     @JsonProperty("statuspage")
     public StatuspageProvider getStatuspage() {
         return statuspage;
     }
 
+    /**
+     * ConsoleProviders defines a list of optional additional providers of functionality to the console.
+     */
     @JsonProperty("statuspage")
     public void setStatuspage(StatuspageProvider statuspage) {
         this.statuspage = statuspage;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConsoleSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConsoleSpec.java
index 5030f3d36a3..b371274f210 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConsoleSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConsoleSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleSpec is the specification of the desired behavior of the Console.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -119,103 +122,163 @@ public ConsoleSpec(ConsoleCustomization customization, Ingress ingress, String l
         this.unsupportedConfigOverrides = unsupportedConfigOverrides;
     }
 
+    /**
+     * ConsoleSpec is the specification of the desired behavior of the Console.
+     */
     @JsonProperty("customization")
     public ConsoleCustomization getCustomization() {
         return customization;
     }
 
+    /**
+     * ConsoleSpec is the specification of the desired behavior of the Console.
+     */
     @JsonProperty("customization")
     public void setCustomization(ConsoleCustomization customization) {
         this.customization = customization;
     }
 
+    /**
+     * ConsoleSpec is the specification of the desired behavior of the Console.
+     */
     @JsonProperty("ingress")
     public Ingress getIngress() {
         return ingress;
     }
 
+    /**
+     * ConsoleSpec is the specification of the desired behavior of the Console.
+     */
     @JsonProperty("ingress")
     public void setIngress(Ingress ingress) {
         this.ingress = ingress;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
     }
 
+    /**
+     * ConsoleSpec is the specification of the desired behavior of the Console.
+     */
     @JsonProperty("observedConfig")
     public Object getObservedConfig() {
         return observedConfig;
     }
 
+    /**
+     * ConsoleSpec is the specification of the desired behavior of the Console.
+     */
     @JsonProperty("observedConfig")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setObservedConfig(Object observedConfig) {
         this.observedConfig = observedConfig;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public String getOperatorLogLevel() {
         return operatorLogLevel;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public void setOperatorLogLevel(String operatorLogLevel) {
         this.operatorLogLevel = operatorLogLevel;
     }
 
+    /**
+     * plugins defines a list of enabled console plugin names.
+     */
     @JsonProperty("plugins")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPlugins() {
         return plugins;
     }
 
+    /**
+     * plugins defines a list of enabled console plugin names.
+     */
     @JsonProperty("plugins")
     public void setPlugins(List<String> plugins) {
         this.plugins = plugins;
     }
 
+    /**
+     * ConsoleSpec is the specification of the desired behavior of the Console.
+     */
     @JsonProperty("providers")
     public ConsoleProviders getProviders() {
         return providers;
     }
 
+    /**
+     * ConsoleSpec is the specification of the desired behavior of the Console.
+     */
     @JsonProperty("providers")
     public void setProviders(ConsoleProviders providers) {
         this.providers = providers;
     }
 
+    /**
+     * ConsoleSpec is the specification of the desired behavior of the Console.
+     */
     @JsonProperty("route")
     public ConsoleConfigRoute getRoute() {
         return route;
     }
 
+    /**
+     * ConsoleSpec is the specification of the desired behavior of the Console.
+     */
     @JsonProperty("route")
     public void setRoute(ConsoleConfigRoute route) {
         this.route = route;
     }
 
+    /**
+     * ConsoleSpec is the specification of the desired behavior of the Console.
+     */
     @JsonProperty("unsupportedConfigOverrides")
     public Object getUnsupportedConfigOverrides() {
         return unsupportedConfigOverrides;
     }
 
+    /**
+     * ConsoleSpec is the specification of the desired behavior of the Console.
+     */
     @JsonProperty("unsupportedConfigOverrides")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setUnsupportedConfigOverrides(Object unsupportedConfigOverrides) {
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConsoleStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConsoleStatus.java
index 006beda97e0..e4e2980feb2 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConsoleStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ConsoleStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConsoleStatus defines the observed status of the Console.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,63 +105,99 @@ public ConsoleStatus(List<OperatorCondition> conditions, List<GenerationStatus>
         this.version = version;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenerationStatus> getGenerations() {
         return generations;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     public void setGenerations(List<GenerationStatus> generations) {
         this.generations = generations;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public Integer getLatestAvailableRevision() {
         return latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public void setLatestAvailableRevision(Integer latestAvailableRevision) {
         this.latestAvailableRevision = latestAvailableRevision;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ContainerLoggingDestinationParameters.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ContainerLoggingDestinationParameters.java
index 1c3d27ec069..cc808163e46 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ContainerLoggingDestinationParameters.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ContainerLoggingDestinationParameters.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ContainerLoggingDestinationParameters describes parameters for the Container logging destination type.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ContainerLoggingDestinationParameters(Integer maxLength) {
         this.maxLength = maxLength;
     }
 
+    /**
+     * maxLength is the maximum length of the log message.<br><p> <br><p> Valid values are integers in the range 480 to 8192, inclusive.<br><p> <br><p> When omitted, the default value is 1024.
+     */
     @JsonProperty("maxLength")
     public Integer getMaxLength() {
         return maxLength;
     }
 
+    /**
+     * maxLength is the maximum length of the log message.<br><p> <br><p> Valid values are integers in the range 480 to 8192, inclusive.<br><p> <br><p> When omitted, the default value is 1024.
+     */
     @JsonProperty("maxLength")
     public void setMaxLength(Integer maxLength) {
         this.maxLength = maxLength;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNS.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNS.java
index ae75d98d434..10ce7842f0c 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNS.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNS.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNS manages the CoreDNS component to provide a name resolution service for pods and services in the cluster.<br><p> <br><p> This supports the DNS-based service discovery specification: https://github.com/kubernetes/dns/blob/master/docs/specification.md<br><p> <br><p> More details: https://kubernetes.io/docs/tasks/administer-cluster/coredns<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class DNS implements Editable<DNSBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DNS";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public DNS(String apiVersion, String kind, ObjectMeta metadata, DNSSpec spec, DN
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DNS manages the CoreDNS component to provide a name resolution service for pods and services in the cluster.<br><p> <br><p> This supports the DNS-based service discovery specification: https://github.com/kubernetes/dns/blob/master/docs/specification.md<br><p> <br><p> More details: https://kubernetes.io/docs/tasks/administer-cluster/coredns<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DNS manages the CoreDNS component to provide a name resolution service for pods and services in the cluster.<br><p> <br><p> This supports the DNS-based service discovery specification: https://github.com/kubernetes/dns/blob/master/docs/specification.md<br><p> <br><p> More details: https://kubernetes.io/docs/tasks/administer-cluster/coredns<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * DNS manages the CoreDNS component to provide a name resolution service for pods and services in the cluster.<br><p> <br><p> This supports the DNS-based service discovery specification: https://github.com/kubernetes/dns/blob/master/docs/specification.md<br><p> <br><p> More details: https://kubernetes.io/docs/tasks/administer-cluster/coredns<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public DNSSpec getSpec() {
         return spec;
     }
 
+    /**
+     * DNS manages the CoreDNS component to provide a name resolution service for pods and services in the cluster.<br><p> <br><p> This supports the DNS-based service discovery specification: https://github.com/kubernetes/dns/blob/master/docs/specification.md<br><p> <br><p> More details: https://kubernetes.io/docs/tasks/administer-cluster/coredns<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(DNSSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * DNS manages the CoreDNS component to provide a name resolution service for pods and services in the cluster.<br><p> <br><p> This supports the DNS-based service discovery specification: https://github.com/kubernetes/dns/blob/master/docs/specification.md<br><p> <br><p> More details: https://kubernetes.io/docs/tasks/administer-cluster/coredns<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public DNSStatus getStatus() {
         return status;
     }
 
+    /**
+     * DNS manages the CoreDNS component to provide a name resolution service for pods and services in the cluster.<br><p> <br><p> This supports the DNS-based service discovery specification: https://github.com/kubernetes/dns/blob/master/docs/specification.md<br><p> <br><p> More details: https://kubernetes.io/docs/tasks/administer-cluster/coredns<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(DNSStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNSCache.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNSCache.java
index c1e02b38d8f..02f76f36cf4 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNSCache.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNSCache.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSCache defines the fields for configuring DNS caching.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public DNSCache(String negativeTTL, String positiveTTL) {
         this.positiveTTL = positiveTTL;
     }
 
+    /**
+     * DNSCache defines the fields for configuring DNS caching.
+     */
     @JsonProperty("negativeTTL")
     public String getNegativeTTL() {
         return negativeTTL;
     }
 
+    /**
+     * DNSCache defines the fields for configuring DNS caching.
+     */
     @JsonProperty("negativeTTL")
     public void setNegativeTTL(String negativeTTL) {
         this.negativeTTL = negativeTTL;
     }
 
+    /**
+     * DNSCache defines the fields for configuring DNS caching.
+     */
     @JsonProperty("positiveTTL")
     public String getPositiveTTL() {
         return positiveTTL;
     }
 
+    /**
+     * DNSCache defines the fields for configuring DNS caching.
+     */
     @JsonProperty("positiveTTL")
     public void setPositiveTTL(String positiveTTL) {
         this.positiveTTL = positiveTTL;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNSList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNSList.java
index 323331a3bfe..09b66f1d3c1 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNSList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNSList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSList contains a list of DNS<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class DNSList implements Editable<DNSListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.v1.DNS>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.v1.DNS> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DNSList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DNSList(String apiVersion, List<io.fabric8.openshift.api.model.operator.v
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * DNSList contains a list of DNS<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.v1.DNS> getItems() {
         return items;
     }
 
+    /**
+     * DNSList contains a list of DNS<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.v1.DNS> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DNSList contains a list of DNS<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DNSList contains a list of DNS<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNSNodePlacement.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNSNodePlacement.java
index 95da233b54c..d5a85f9aebb 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNSNodePlacement.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNSNodePlacement.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSNodePlacement describes the node scheduling configuration for DNS pods.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,23 +90,35 @@ public DNSNodePlacement(Map<String, String> nodeSelector, List<Toleration> toler
         this.tolerations = tolerations;
     }
 
+    /**
+     * nodeSelector is the node selector applied to DNS pods.<br><p> <br><p> If empty, the default is used, which is currently the following:<br><p> <br><p>   kubernetes.io/os: linux<br><p> <br><p> This default is subject to change.<br><p> <br><p> If set, the specified selector is used and replaces the default.
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * nodeSelector is the node selector applied to DNS pods.<br><p> <br><p> If empty, the default is used, which is currently the following:<br><p> <br><p>   kubernetes.io/os: linux<br><p> <br><p> This default is subject to change.<br><p> <br><p> If set, the specified selector is used and replaces the default.
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * tolerations is a list of tolerations applied to DNS pods.<br><p> <br><p> If empty, the DNS operator sets a toleration for the "node-role.kubernetes.io/master" taint.  This default is subject to change.  Specifying tolerations without including a toleration for the "node-role.kubernetes.io/master" taint may be risky as it could lead to an outage if all worker nodes become unavailable.<br><p> <br><p> Note that the daemon controller adds some tolerations as well.  See https://kubernetes.io/docs/concepts/scheduling-eviction/taint-and-toleration/
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * tolerations is a list of tolerations applied to DNS pods.<br><p> <br><p> If empty, the DNS operator sets a toleration for the "node-role.kubernetes.io/master" taint.  This default is subject to change.  Specifying tolerations without including a toleration for the "node-role.kubernetes.io/master" taint may be risky as it could lead to an outage if all worker nodes become unavailable.<br><p> <br><p> Note that the daemon controller adds some tolerations as well.  See https://kubernetes.io/docs/concepts/scheduling-eviction/taint-and-toleration/
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNSOverTLSConfig.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNSOverTLSConfig.java
index 0fbcc5be112..21f0bb2eccd 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNSOverTLSConfig.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNSOverTLSConfig.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSOverTLSConfig describes optional DNSTransportConfig fields that should be captured.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public DNSOverTLSConfig(ConfigMapNameReference caBundle, String serverName) {
         this.serverName = serverName;
     }
 
+    /**
+     * DNSOverTLSConfig describes optional DNSTransportConfig fields that should be captured.
+     */
     @JsonProperty("caBundle")
     public ConfigMapNameReference getCaBundle() {
         return caBundle;
     }
 
+    /**
+     * DNSOverTLSConfig describes optional DNSTransportConfig fields that should be captured.
+     */
     @JsonProperty("caBundle")
     public void setCaBundle(ConfigMapNameReference caBundle) {
         this.caBundle = caBundle;
     }
 
+    /**
+     * serverName is the upstream server to connect to when forwarding DNS queries. This is required when Transport is set to "TLS". ServerName will be validated against the DNS naming conventions in RFC 1123 and should match the TLS certificate installed in the upstream resolver(s).
+     */
     @JsonProperty("serverName")
     public String getServerName() {
         return serverName;
     }
 
+    /**
+     * serverName is the upstream server to connect to when forwarding DNS queries. This is required when Transport is set to "TLS". ServerName will be validated against the DNS naming conventions in RFC 1123 and should match the TLS certificate installed in the upstream resolver(s).
+     */
     @JsonProperty("serverName")
     public void setServerName(String serverName) {
         this.serverName = serverName;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNSSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNSSpec.java
index ba8739feb53..a494771acbb 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNSSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNSSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSSpec is the specification of the desired behavior of the DNS.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -105,72 +108,114 @@ public DNSSpec(DNSCache cache, String logLevel, String managementState, DNSNodeP
         this.upstreamResolvers = upstreamResolvers;
     }
 
+    /**
+     * DNSSpec is the specification of the desired behavior of the DNS.
+     */
     @JsonProperty("cache")
     public DNSCache getCache() {
         return cache;
     }
 
+    /**
+     * DNSSpec is the specification of the desired behavior of the DNS.
+     */
     @JsonProperty("cache")
     public void setCache(DNSCache cache) {
         this.cache = cache;
     }
 
+    /**
+     * logLevel describes the desired logging verbosity for CoreDNS. Any one of the following values may be specified: &#42; Normal logs errors from upstream resolvers. &#42; Debug logs errors, NXDOMAIN responses, and NODATA responses. &#42; Trace logs errors and all responses.<br><p>  Setting logLevel: Trace will produce extremely verbose logs.<br><p> Valid values are: "Normal", "Debug", "Trace". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * logLevel describes the desired logging verbosity for CoreDNS. Any one of the following values may be specified: &#42; Normal logs errors from upstream resolvers. &#42; Debug logs errors, NXDOMAIN responses, and NODATA responses. &#42; Trace logs errors and all responses.<br><p>  Setting logLevel: Trace will produce extremely verbose logs.<br><p> Valid values are: "Normal", "Debug", "Trace". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * managementState indicates whether the DNS operator should manage cluster DNS
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates whether the DNS operator should manage cluster DNS
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
     }
 
+    /**
+     * DNSSpec is the specification of the desired behavior of the DNS.
+     */
     @JsonProperty("nodePlacement")
     public DNSNodePlacement getNodePlacement() {
         return nodePlacement;
     }
 
+    /**
+     * DNSSpec is the specification of the desired behavior of the DNS.
+     */
     @JsonProperty("nodePlacement")
     public void setNodePlacement(DNSNodePlacement nodePlacement) {
         this.nodePlacement = nodePlacement;
     }
 
+    /**
+     * operatorLogLevel controls the logging level of the DNS Operator. Valid values are: "Normal", "Debug", "Trace". Defaults to "Normal". setting operatorLogLevel: Trace will produce extremely verbose logs.
+     */
     @JsonProperty("operatorLogLevel")
     public String getOperatorLogLevel() {
         return operatorLogLevel;
     }
 
+    /**
+     * operatorLogLevel controls the logging level of the DNS Operator. Valid values are: "Normal", "Debug", "Trace". Defaults to "Normal". setting operatorLogLevel: Trace will produce extremely verbose logs.
+     */
     @JsonProperty("operatorLogLevel")
     public void setOperatorLogLevel(String operatorLogLevel) {
         this.operatorLogLevel = operatorLogLevel;
     }
 
+    /**
+     * servers is a list of DNS resolvers that provide name query delegation for one or more subdomains outside the scope of the cluster domain. If servers consists of more than one Server, longest suffix match will be used to determine the Server.<br><p> <br><p> For example, if there are two Servers, one for "foo.com" and another for "a.foo.com", and the name query is for "www.a.foo.com", it will be routed to the Server with Zone "a.foo.com".<br><p> <br><p> If this field is nil, no servers are created.
+     */
     @JsonProperty("servers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Server> getServers() {
         return servers;
     }
 
+    /**
+     * servers is a list of DNS resolvers that provide name query delegation for one or more subdomains outside the scope of the cluster domain. If servers consists of more than one Server, longest suffix match will be used to determine the Server.<br><p> <br><p> For example, if there are two Servers, one for "foo.com" and another for "a.foo.com", and the name query is for "www.a.foo.com", it will be routed to the Server with Zone "a.foo.com".<br><p> <br><p> If this field is nil, no servers are created.
+     */
     @JsonProperty("servers")
     public void setServers(List<Server> servers) {
         this.servers = servers;
     }
 
+    /**
+     * DNSSpec is the specification of the desired behavior of the DNS.
+     */
     @JsonProperty("upstreamResolvers")
     public UpstreamResolvers getUpstreamResolvers() {
         return upstreamResolvers;
     }
 
+    /**
+     * DNSSpec is the specification of the desired behavior of the DNS.
+     */
     @JsonProperty("upstreamResolvers")
     public void setUpstreamResolvers(UpstreamResolvers upstreamResolvers) {
         this.upstreamResolvers = upstreamResolvers;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNSStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNSStatus.java
index 2486b872945..b69956a4656 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNSStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNSStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSStatus defines the observed status of the DNS.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public DNSStatus(String clusterDomain, String clusterIP, List<OperatorCondition>
         this.conditions = conditions;
     }
 
+    /**
+     * clusterDomain is the local cluster DNS domain suffix for DNS services. This will be a subdomain as defined in RFC 1034, section 3.5: https://tools.ietf.org/html/rfc1034#section-3.5 Example: "cluster.local"<br><p> <br><p> More info: https://kubernetes.io/docs/concepts/services-networking/dns-pod-service
+     */
     @JsonProperty("clusterDomain")
     public String getClusterDomain() {
         return clusterDomain;
     }
 
+    /**
+     * clusterDomain is the local cluster DNS domain suffix for DNS services. This will be a subdomain as defined in RFC 1034, section 3.5: https://tools.ietf.org/html/rfc1034#section-3.5 Example: "cluster.local"<br><p> <br><p> More info: https://kubernetes.io/docs/concepts/services-networking/dns-pod-service
+     */
     @JsonProperty("clusterDomain")
     public void setClusterDomain(String clusterDomain) {
         this.clusterDomain = clusterDomain;
     }
 
+    /**
+     * clusterIP is the service IP through which this DNS is made available.<br><p> <br><p> In the case of the default DNS, this will be a well known IP that is used as the default nameserver for pods that are using the default ClusterFirst DNS policy.<br><p> <br><p> In general, this IP can be specified in a pod's spec.dnsConfig.nameservers list or used explicitly when performing name resolution from within the cluster. Example: dig foo.com @&lt;service IP&gt;<br><p> <br><p> More info: https://kubernetes.io/docs/concepts/services-networking/service/#virtual-ips-and-service-proxies
+     */
     @JsonProperty("clusterIP")
     public String getClusterIP() {
         return clusterIP;
     }
 
+    /**
+     * clusterIP is the service IP through which this DNS is made available.<br><p> <br><p> In the case of the default DNS, this will be a well known IP that is used as the default nameserver for pods that are using the default ClusterFirst DNS policy.<br><p> <br><p> In general, this IP can be specified in a pod's spec.dnsConfig.nameservers list or used explicitly when performing name resolution from within the cluster. Example: dig foo.com @&lt;service IP&gt;<br><p> <br><p> More info: https://kubernetes.io/docs/concepts/services-networking/service/#virtual-ips-and-service-proxies
+     */
     @JsonProperty("clusterIP")
     public void setClusterIP(String clusterIP) {
         this.clusterIP = clusterIP;
     }
 
+    /**
+     * conditions provide information about the state of the DNS on the cluster.<br><p> <br><p> These are the supported DNS conditions:<br><p> <br><p>   &#42; Available<br><p>   - True if the following conditions are met:<br><p>     &#42; DNS controller daemonset is available.<br><p>   - False if any of those conditions are unsatisfied.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions provide information about the state of the DNS on the cluster.<br><p> <br><p> These are the supported DNS conditions:<br><p> <br><p>   &#42; Available<br><p>   - True if the following conditions are met:<br><p>     &#42; DNS controller daemonset is available.<br><p>   - False if any of those conditions are unsatisfied.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNSTransportConfig.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNSTransportConfig.java
index 24963667729..e629a4c1325 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNSTransportConfig.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DNSTransportConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DNSTransportConfig groups related configuration parameters used for configuring forwarding to upstream resolvers that support DNS-over-TLS.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public DNSTransportConfig(DNSOverTLSConfig tls, String transport) {
         this.transport = transport;
     }
 
+    /**
+     * DNSTransportConfig groups related configuration parameters used for configuring forwarding to upstream resolvers that support DNS-over-TLS.
+     */
     @JsonProperty("tls")
     public DNSOverTLSConfig getTls() {
         return tls;
     }
 
+    /**
+     * DNSTransportConfig groups related configuration parameters used for configuring forwarding to upstream resolvers that support DNS-over-TLS.
+     */
     @JsonProperty("tls")
     public void setTls(DNSOverTLSConfig tls) {
         this.tls = tls;
     }
 
+    /**
+     * transport allows cluster administrators to opt-in to using a DNS-over-TLS connection between cluster DNS and an upstream resolver(s). Configuring TLS as the transport at this level without configuring a CABundle will result in the system certificates being used to verify the serving certificate of the upstream resolver(s).<br><p> <br><p> Possible values: "" (empty) - This means no explicit choice has been made and the platform chooses the default which is subject to change over time. The current default is "Cleartext". "Cleartext" - Cluster admin specified cleartext option. This results in the same functionality as an empty value but may be useful when a cluster admin wants to be more explicit about the transport, or wants to switch from "TLS" to "Cleartext" explicitly. "TLS" - This indicates that DNS queries should be sent over a TLS connection. If Transport is set to TLS, you MUST also set ServerName. If a port is not included with the upstream IP, port 853 will be tried by default per RFC 7858 section 3.1; https://datatracker.ietf.org/doc/html/rfc7858#section-3.1.
+     */
     @JsonProperty("transport")
     public String getTransport() {
         return transport;
     }
 
+    /**
+     * transport allows cluster administrators to opt-in to using a DNS-over-TLS connection between cluster DNS and an upstream resolver(s). Configuring TLS as the transport at this level without configuring a CABundle will result in the system certificates being used to verify the serving certificate of the upstream resolver(s).<br><p> <br><p> Possible values: "" (empty) - This means no explicit choice has been made and the platform chooses the default which is subject to change over time. The current default is "Cleartext". "Cleartext" - Cluster admin specified cleartext option. This results in the same functionality as an empty value but may be useful when a cluster admin wants to be more explicit about the transport, or wants to switch from "TLS" to "Cleartext" explicitly. "TLS" - This indicates that DNS queries should be sent over a TLS connection. If Transport is set to TLS, you MUST also set ServerName. If a port is not included with the upstream IP, port 853 will be tried by default per RFC 7858 section 3.1; https://datatracker.ietf.org/doc/html/rfc7858#section-3.1.
+     */
     @JsonProperty("transport")
     public void setTransport(String transport) {
         this.transport = transport;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DefaultNetworkDefinition.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DefaultNetworkDefinition.java
index b378e5a15da..081ccf4cd9f 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DefaultNetworkDefinition.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DefaultNetworkDefinition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DefaultNetworkDefinition represents a single network plugin's configuration. type must be specified, along with exactly one "Config" that matches the type.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public DefaultNetworkDefinition(OpenShiftSDNConfig openshiftSDNConfig, OVNKubern
         this.type = type;
     }
 
+    /**
+     * DefaultNetworkDefinition represents a single network plugin's configuration. type must be specified, along with exactly one "Config" that matches the type.
+     */
     @JsonProperty("openshiftSDNConfig")
     public OpenShiftSDNConfig getOpenshiftSDNConfig() {
         return openshiftSDNConfig;
     }
 
+    /**
+     * DefaultNetworkDefinition represents a single network plugin's configuration. type must be specified, along with exactly one "Config" that matches the type.
+     */
     @JsonProperty("openshiftSDNConfig")
     public void setOpenshiftSDNConfig(OpenShiftSDNConfig openshiftSDNConfig) {
         this.openshiftSDNConfig = openshiftSDNConfig;
     }
 
+    /**
+     * DefaultNetworkDefinition represents a single network plugin's configuration. type must be specified, along with exactly one "Config" that matches the type.
+     */
     @JsonProperty("ovnKubernetesConfig")
     public OVNKubernetesConfig getOvnKubernetesConfig() {
         return ovnKubernetesConfig;
     }
 
+    /**
+     * DefaultNetworkDefinition represents a single network plugin's configuration. type must be specified, along with exactly one "Config" that matches the type.
+     */
     @JsonProperty("ovnKubernetesConfig")
     public void setOvnKubernetesConfig(OVNKubernetesConfig ovnKubernetesConfig) {
         this.ovnKubernetesConfig = ovnKubernetesConfig;
     }
 
+    /**
+     * type is the type of network All NetworkTypes are supported except for NetworkTypeRaw
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the type of network All NetworkTypes are supported except for NetworkTypeRaw
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DeveloperConsoleCatalogCategory.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DeveloperConsoleCatalogCategory.java
index 11cee11fb64..0b2ce0cc6cf 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DeveloperConsoleCatalogCategory.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DeveloperConsoleCatalogCategory.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeveloperConsoleCatalogCategory for the developer console catalog.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,43 +97,67 @@ public DeveloperConsoleCatalogCategory(String id, String label, List<DeveloperCo
         this.tags = tags;
     }
 
+    /**
+     * ID is an identifier used in the URL to enable deep linking in console. ID is required and must have 1-32 URL safe (A-Z, a-z, 0-9, - and _) characters.
+     */
     @JsonProperty("id")
     public String getId() {
         return id;
     }
 
+    /**
+     * ID is an identifier used in the URL to enable deep linking in console. ID is required and must have 1-32 URL safe (A-Z, a-z, 0-9, - and _) characters.
+     */
     @JsonProperty("id")
     public void setId(String id) {
         this.id = id;
     }
 
+    /**
+     * label defines a category display label. It is required and must have 1-64 characters.
+     */
     @JsonProperty("label")
     public String getLabel() {
         return label;
     }
 
+    /**
+     * label defines a category display label. It is required and must have 1-64 characters.
+     */
     @JsonProperty("label")
     public void setLabel(String label) {
         this.label = label;
     }
 
+    /**
+     * subcategories defines a list of child categories.
+     */
     @JsonProperty("subcategories")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DeveloperConsoleCatalogCategoryMeta> getSubcategories() {
         return subcategories;
     }
 
+    /**
+     * subcategories defines a list of child categories.
+     */
     @JsonProperty("subcategories")
     public void setSubcategories(List<DeveloperConsoleCatalogCategoryMeta> subcategories) {
         this.subcategories = subcategories;
     }
 
+    /**
+     * tags is a list of strings that will match the category. A selected category show all items which has at least one overlapping tag between category and item.
+     */
     @JsonProperty("tags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getTags() {
         return tags;
     }
 
+    /**
+     * tags is a list of strings that will match the category. A selected category show all items which has at least one overlapping tag between category and item.
+     */
     @JsonProperty("tags")
     public void setTags(List<String> tags) {
         this.tags = tags;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DeveloperConsoleCatalogCategoryMeta.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DeveloperConsoleCatalogCategoryMeta.java
index 96922cc1b75..8ebf56dd73a 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DeveloperConsoleCatalogCategoryMeta.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DeveloperConsoleCatalogCategoryMeta.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeveloperConsoleCatalogCategoryMeta are the key identifiers of a developer catalog category.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public DeveloperConsoleCatalogCategoryMeta(String id, String label, List<String>
         this.tags = tags;
     }
 
+    /**
+     * ID is an identifier used in the URL to enable deep linking in console. ID is required and must have 1-32 URL safe (A-Z, a-z, 0-9, - and _) characters.
+     */
     @JsonProperty("id")
     public String getId() {
         return id;
     }
 
+    /**
+     * ID is an identifier used in the URL to enable deep linking in console. ID is required and must have 1-32 URL safe (A-Z, a-z, 0-9, - and _) characters.
+     */
     @JsonProperty("id")
     public void setId(String id) {
         this.id = id;
     }
 
+    /**
+     * label defines a category display label. It is required and must have 1-64 characters.
+     */
     @JsonProperty("label")
     public String getLabel() {
         return label;
     }
 
+    /**
+     * label defines a category display label. It is required and must have 1-64 characters.
+     */
     @JsonProperty("label")
     public void setLabel(String label) {
         this.label = label;
     }
 
+    /**
+     * tags is a list of strings that will match the category. A selected category show all items which has at least one overlapping tag between category and item.
+     */
     @JsonProperty("tags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getTags() {
         return tags;
     }
 
+    /**
+     * tags is a list of strings that will match the category. A selected category show all items which has at least one overlapping tag between category and item.
+     */
     @JsonProperty("tags")
     public void setTags(List<String> tags) {
         this.tags = tags;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DeveloperConsoleCatalogCustomization.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DeveloperConsoleCatalogCustomization.java
index af86cfccedd..2b89b6cdbea 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DeveloperConsoleCatalogCustomization.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DeveloperConsoleCatalogCustomization.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeveloperConsoleCatalogCustomization allow cluster admin to configure developer catalog.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public DeveloperConsoleCatalogCustomization(List<DeveloperConsoleCatalogCategory
         this.types = types;
     }
 
+    /**
+     * categories which are shown in the developer catalog.
+     */
     @JsonProperty("categories")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DeveloperConsoleCatalogCategory> getCategories() {
         return categories;
     }
 
+    /**
+     * categories which are shown in the developer catalog.
+     */
     @JsonProperty("categories")
     public void setCategories(List<DeveloperConsoleCatalogCategory> categories) {
         this.categories = categories;
     }
 
+    /**
+     * DeveloperConsoleCatalogCustomization allow cluster admin to configure developer catalog.
+     */
     @JsonProperty("types")
     public DeveloperConsoleCatalogTypes getTypes() {
         return types;
     }
 
+    /**
+     * DeveloperConsoleCatalogCustomization allow cluster admin to configure developer catalog.
+     */
     @JsonProperty("types")
     public void setTypes(DeveloperConsoleCatalogTypes types) {
         this.types = types;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DeveloperConsoleCatalogTypes.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DeveloperConsoleCatalogTypes.java
index a6611ba68b5..77a8eb7646b 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DeveloperConsoleCatalogTypes.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/DeveloperConsoleCatalogTypes.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeveloperConsoleCatalogTypes defines the state of the sub-catalog types.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public DeveloperConsoleCatalogTypes(List<String> disabled, List<String> enabled,
         this.state = state;
     }
 
+    /**
+     * disabled is a list of developer catalog types (sub-catalogs IDs) that are not shown to users. Types (sub-catalogs) are added via console plugins, the available types (sub-catalog IDs) are available in the console on the cluster configuration page, or when editing the YAML in the console. Example: "Devfile", "HelmChart", "BuilderImage" If the list is empty or all the available sub-catalog types are added, then the complete developer catalog should be hidden.
+     */
     @JsonProperty("disabled")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDisabled() {
         return disabled;
     }
 
+    /**
+     * disabled is a list of developer catalog types (sub-catalogs IDs) that are not shown to users. Types (sub-catalogs) are added via console plugins, the available types (sub-catalog IDs) are available in the console on the cluster configuration page, or when editing the YAML in the console. Example: "Devfile", "HelmChart", "BuilderImage" If the list is empty or all the available sub-catalog types are added, then the complete developer catalog should be hidden.
+     */
     @JsonProperty("disabled")
     public void setDisabled(List<String> disabled) {
         this.disabled = disabled;
     }
 
+    /**
+     * enabled is a list of developer catalog types (sub-catalogs IDs) that will be shown to users. Types (sub-catalogs) are added via console plugins, the available types (sub-catalog IDs) are available in the console on the cluster configuration page, or when editing the YAML in the console. Example: "Devfile", "HelmChart", "BuilderImage" If the list is non-empty, a new type will not be shown to the user until it is added to list. If the list is empty the complete developer catalog will be shown.
+     */
     @JsonProperty("enabled")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getEnabled() {
         return enabled;
     }
 
+    /**
+     * enabled is a list of developer catalog types (sub-catalogs IDs) that will be shown to users. Types (sub-catalogs) are added via console plugins, the available types (sub-catalog IDs) are available in the console on the cluster configuration page, or when editing the YAML in the console. Example: "Devfile", "HelmChart", "BuilderImage" If the list is non-empty, a new type will not be shown to the user until it is added to list. If the list is empty the complete developer catalog will be shown.
+     */
     @JsonProperty("enabled")
     public void setEnabled(List<String> enabled) {
         this.enabled = enabled;
     }
 
+    /**
+     * state defines if a list of catalog types should be enabled or disabled.
+     */
     @JsonProperty("state")
     public String getState() {
         return state;
     }
 
+    /**
+     * state defines if a list of catalog types should be enabled or disabled.
+     */
     @JsonProperty("state")
     public void setState(String state) {
         this.state = state;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/EgressIPConfig.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/EgressIPConfig.java
index b37328a2019..271909ba5bc 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/EgressIPConfig.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/EgressIPConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EgressIPConfig defines the configuration knobs for egressip
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public EgressIPConfig(Long reachabilityTotalTimeoutSeconds) {
         this.reachabilityTotalTimeoutSeconds = reachabilityTotalTimeoutSeconds;
     }
 
+    /**
+     * reachabilityTotalTimeout configures the EgressIP node reachability check total timeout in seconds. If the EgressIP node cannot be reached within this timeout, the node is declared down. Setting a large value may cause the EgressIP feature to react slowly to node changes. In particular, it may react slowly for EgressIP nodes that really have a genuine problem and are unreachable. When omitted, this means the user has no opinion and the platform is left to choose a reasonable default, which is subject to change over time. The current default is 1 second. A value of 0 disables the EgressIP node's reachability check.
+     */
     @JsonProperty("reachabilityTotalTimeoutSeconds")
     public Long getReachabilityTotalTimeoutSeconds() {
         return reachabilityTotalTimeoutSeconds;
     }
 
+    /**
+     * reachabilityTotalTimeout configures the EgressIP node reachability check total timeout in seconds. If the EgressIP node cannot be reached within this timeout, the node is declared down. Setting a large value may cause the EgressIP feature to react slowly to node changes. In particular, it may react slowly for EgressIP nodes that really have a genuine problem and are unreachable. When omitted, this means the user has no opinion and the platform is left to choose a reasonable default, which is subject to change over time. The current default is 1 second. A value of 0 disables the EgressIP node's reachability check.
+     */
     @JsonProperty("reachabilityTotalTimeoutSeconds")
     public void setReachabilityTotalTimeoutSeconds(Long reachabilityTotalTimeoutSeconds) {
         this.reachabilityTotalTimeoutSeconds = reachabilityTotalTimeoutSeconds;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/EndpointPublishingStrategy.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/EndpointPublishingStrategy.java
index 50a4dc54342..28b33a82e28 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/EndpointPublishingStrategy.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/EndpointPublishingStrategy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EndpointPublishingStrategy is a way to publish the endpoints of an IngressController, and represents the type and any additional configuration for a specific type.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public EndpointPublishingStrategy(HostNetworkStrategy hostNetwork, LoadBalancerS
         this.type = type;
     }
 
+    /**
+     * EndpointPublishingStrategy is a way to publish the endpoints of an IngressController, and represents the type and any additional configuration for a specific type.
+     */
     @JsonProperty("hostNetwork")
     public HostNetworkStrategy getHostNetwork() {
         return hostNetwork;
     }
 
+    /**
+     * EndpointPublishingStrategy is a way to publish the endpoints of an IngressController, and represents the type and any additional configuration for a specific type.
+     */
     @JsonProperty("hostNetwork")
     public void setHostNetwork(HostNetworkStrategy hostNetwork) {
         this.hostNetwork = hostNetwork;
     }
 
+    /**
+     * EndpointPublishingStrategy is a way to publish the endpoints of an IngressController, and represents the type and any additional configuration for a specific type.
+     */
     @JsonProperty("loadBalancer")
     public LoadBalancerStrategy getLoadBalancer() {
         return loadBalancer;
     }
 
+    /**
+     * EndpointPublishingStrategy is a way to publish the endpoints of an IngressController, and represents the type and any additional configuration for a specific type.
+     */
     @JsonProperty("loadBalancer")
     public void setLoadBalancer(LoadBalancerStrategy loadBalancer) {
         this.loadBalancer = loadBalancer;
     }
 
+    /**
+     * EndpointPublishingStrategy is a way to publish the endpoints of an IngressController, and represents the type and any additional configuration for a specific type.
+     */
     @JsonProperty("nodePort")
     public NodePortStrategy getNodePort() {
         return nodePort;
     }
 
+    /**
+     * EndpointPublishingStrategy is a way to publish the endpoints of an IngressController, and represents the type and any additional configuration for a specific type.
+     */
     @JsonProperty("nodePort")
     public void setNodePort(NodePortStrategy nodePort) {
         this.nodePort = nodePort;
     }
 
+    /**
+     * EndpointPublishingStrategy is a way to publish the endpoints of an IngressController, and represents the type and any additional configuration for a specific type.
+     */
     @JsonProperty("private")
     public PrivateStrategy getPrivate() {
         return _private;
     }
 
+    /**
+     * EndpointPublishingStrategy is a way to publish the endpoints of an IngressController, and represents the type and any additional configuration for a specific type.
+     */
     @JsonProperty("private")
     public void setPrivate(PrivateStrategy _private) {
         this._private = _private;
     }
 
+    /**
+     * type is the publishing strategy to use. Valid values are:<br><p> <br><p> &#42; LoadBalancerService<br><p> <br><p> Publishes the ingress controller using a Kubernetes LoadBalancer Service.<br><p> <br><p> In this configuration, the ingress controller deployment uses container networking. A LoadBalancer Service is created to publish the deployment.<br><p> <br><p> See: https://kubernetes.io/docs/concepts/services-networking/service/#loadbalancer<br><p> <br><p> If domain is set, a wildcard DNS record will be managed to point at the LoadBalancer Service's external name. DNS records are managed only in DNS zones defined by dns.config.openshift.io/cluster .spec.publicZone and .spec.privateZone.<br><p> <br><p> Wildcard DNS management is currently supported only on the AWS, Azure, and GCP platforms.<br><p> <br><p> &#42; HostNetwork<br><p> <br><p> Publishes the ingress controller on node ports where the ingress controller is deployed.<br><p> <br><p> In this configuration, the ingress controller deployment uses host networking, bound to node ports 80 and 443. The user is responsible for configuring an external load balancer to publish the ingress controller via the node ports.<br><p> <br><p> &#42; Private<br><p> <br><p> Does not publish the ingress controller.<br><p> <br><p> In this configuration, the ingress controller deployment uses container networking, and is not explicitly published. The user must manually publish the ingress controller.<br><p> <br><p> &#42; NodePortService<br><p> <br><p> Publishes the ingress controller using a Kubernetes NodePort Service.<br><p> <br><p> In this configuration, the ingress controller deployment uses container networking. A NodePort Service is created to publish the deployment. The specific node ports are dynamically allocated by OpenShift; however, to support static port allocations, user changes to the node port field of the managed NodePort Service will preserved.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the publishing strategy to use. Valid values are:<br><p> <br><p> &#42; LoadBalancerService<br><p> <br><p> Publishes the ingress controller using a Kubernetes LoadBalancer Service.<br><p> <br><p> In this configuration, the ingress controller deployment uses container networking. A LoadBalancer Service is created to publish the deployment.<br><p> <br><p> See: https://kubernetes.io/docs/concepts/services-networking/service/#loadbalancer<br><p> <br><p> If domain is set, a wildcard DNS record will be managed to point at the LoadBalancer Service's external name. DNS records are managed only in DNS zones defined by dns.config.openshift.io/cluster .spec.publicZone and .spec.privateZone.<br><p> <br><p> Wildcard DNS management is currently supported only on the AWS, Azure, and GCP platforms.<br><p> <br><p> &#42; HostNetwork<br><p> <br><p> Publishes the ingress controller on node ports where the ingress controller is deployed.<br><p> <br><p> In this configuration, the ingress controller deployment uses host networking, bound to node ports 80 and 443. The user is responsible for configuring an external load balancer to publish the ingress controller via the node ports.<br><p> <br><p> &#42; Private<br><p> <br><p> Does not publish the ingress controller.<br><p> <br><p> In this configuration, the ingress controller deployment uses container networking, and is not explicitly published. The user must manually publish the ingress controller.<br><p> <br><p> &#42; NodePortService<br><p> <br><p> Publishes the ingress controller using a Kubernetes NodePort Service.<br><p> <br><p> In this configuration, the ingress controller deployment uses container networking. A NodePort Service is created to publish the deployment. The specific node ports are dynamically allocated by OpenShift; however, to support static port allocations, user changes to the node port field of the managed NodePort Service will preserved.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Etcd.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Etcd.java
index bed09a5dfef..6eacfdbbbd2 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Etcd.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Etcd.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Etcd provides information to configure an operator to manage etcd.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Etcd implements Editable<EtcdBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Etcd";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public Etcd(String apiVersion, String kind, ObjectMeta metadata, EtcdSpec spec,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Etcd provides information to configure an operator to manage etcd.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Etcd provides information to configure an operator to manage etcd.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Etcd provides information to configure an operator to manage etcd.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public EtcdSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Etcd provides information to configure an operator to manage etcd.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(EtcdSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Etcd provides information to configure an operator to manage etcd.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public EtcdStatus getStatus() {
         return status;
     }
 
+    /**
+     * Etcd provides information to configure an operator to manage etcd.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(EtcdStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/EtcdList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/EtcdList.java
index a9741afc343..be9a85671c7 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/EtcdList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/EtcdList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KubeAPISOperatorConfigList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class EtcdList implements Editable<EtcdListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.v1.Etcd>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.v1.Etcd> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EtcdList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EtcdList(String apiVersion, List<io.fabric8.openshift.api.model.operator.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items contains the items
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.v1.Etcd> getItems() {
         return items;
     }
 
+    /**
+     * Items contains the items
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.v1.Etcd> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KubeAPISOperatorConfigList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KubeAPISOperatorConfigList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/EtcdSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/EtcdSpec.java
index a44b0c554d4..8f8614e5622 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/EtcdSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/EtcdSpec.java
@@ -116,61 +116,97 @@ public EtcdSpec(Integer backendQuotaGiB, String controlPlaneHardwareSpeed, Integ
         this.unsupportedConfigOverrides = unsupportedConfigOverrides;
     }
 
+    /**
+     * backendQuotaGiB sets the etcd backend storage size limit in gibibytes. The value should be an integer not less than 8 and not more than 32. When not specified, the default value is 8.
+     */
     @JsonProperty("backendQuotaGiB")
     public Integer getBackendQuotaGiB() {
         return backendQuotaGiB;
     }
 
+    /**
+     * backendQuotaGiB sets the etcd backend storage size limit in gibibytes. The value should be an integer not less than 8 and not more than 32. When not specified, the default value is 8.
+     */
     @JsonProperty("backendQuotaGiB")
     public void setBackendQuotaGiB(Integer backendQuotaGiB) {
         this.backendQuotaGiB = backendQuotaGiB;
     }
 
+    /**
+     * HardwareSpeed allows user to change the etcd tuning profile which configures the latency parameters for heartbeat interval and leader election timeouts allowing the cluster to tolerate longer round-trip-times between etcd members. Valid values are "", "Standard" and "Slower".<br><p> 	"" means no opinion and the platform is left to choose a reasonable default<br><p> 	which is subject to change without notice.<br><p> <br><p> Possible enum values:<br><p>  - `"Slower"` provides more tolerance for slower hardware and/or higher latency networks. Sets (values subject to change): ETCD_HEARTBEAT_INTERVAL: 5x Standard ETCD_LEADER_ELECTION_TIMEOUT: 2.5x Standard<br><p>  - `"Standard"` provides the normal tolerances for hardware speed and latency. Currently sets (values subject to change at any time): ETCD_HEARTBEAT_INTERVAL: 100ms ETCD_LEADER_ELECTION_TIMEOUT: 1000ms
+     */
     @JsonProperty("controlPlaneHardwareSpeed")
     public String getControlPlaneHardwareSpeed() {
         return controlPlaneHardwareSpeed;
     }
 
+    /**
+     * HardwareSpeed allows user to change the etcd tuning profile which configures the latency parameters for heartbeat interval and leader election timeouts allowing the cluster to tolerate longer round-trip-times between etcd members. Valid values are "", "Standard" and "Slower".<br><p> 	"" means no opinion and the platform is left to choose a reasonable default<br><p> 	which is subject to change without notice.<br><p> <br><p> Possible enum values:<br><p>  - `"Slower"` provides more tolerance for slower hardware and/or higher latency networks. Sets (values subject to change): ETCD_HEARTBEAT_INTERVAL: 5x Standard ETCD_LEADER_ELECTION_TIMEOUT: 2.5x Standard<br><p>  - `"Standard"` provides the normal tolerances for hardware speed and latency. Currently sets (values subject to change at any time): ETCD_HEARTBEAT_INTERVAL: 100ms ETCD_LEADER_ELECTION_TIMEOUT: 1000ms
+     */
     @JsonProperty("controlPlaneHardwareSpeed")
     public void setControlPlaneHardwareSpeed(String controlPlaneHardwareSpeed) {
         this.controlPlaneHardwareSpeed = controlPlaneHardwareSpeed;
     }
 
+    /**
+     * failedRevisionLimit is the number of failed static pod installer revisions to keep on disk and in the api -1 = unlimited, 0 or unset = 5 (default)
+     */
     @JsonProperty("failedRevisionLimit")
     public Integer getFailedRevisionLimit() {
         return failedRevisionLimit;
     }
 
+    /**
+     * failedRevisionLimit is the number of failed static pod installer revisions to keep on disk and in the api -1 = unlimited, 0 or unset = 5 (default)
+     */
     @JsonProperty("failedRevisionLimit")
     public void setFailedRevisionLimit(Integer failedRevisionLimit) {
         this.failedRevisionLimit = failedRevisionLimit;
     }
 
+    /**
+     * forceRedeploymentReason can be used to force the redeployment of the operand by providing a unique string. This provides a mechanism to kick a previously failed deployment and provide a reason why you think it will work this time instead of failing again on the same config.
+     */
     @JsonProperty("forceRedeploymentReason")
     public String getForceRedeploymentReason() {
         return forceRedeploymentReason;
     }
 
+    /**
+     * forceRedeploymentReason can be used to force the redeployment of the operand by providing a unique string. This provides a mechanism to kick a previously failed deployment and provide a reason why you think it will work this time instead of failing again on the same config.
+     */
     @JsonProperty("forceRedeploymentReason")
     public void setForceRedeploymentReason(String forceRedeploymentReason) {
         this.forceRedeploymentReason = forceRedeploymentReason;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
@@ -187,21 +223,33 @@ public void setObservedConfig(Object observedConfig) {
         this.observedConfig = observedConfig;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public String getOperatorLogLevel() {
         return operatorLogLevel;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public void setOperatorLogLevel(String operatorLogLevel) {
         this.operatorLogLevel = operatorLogLevel;
     }
 
+    /**
+     * succeededRevisionLimit is the number of successful static pod installer revisions to keep on disk and in the api -1 = unlimited, 0 or unset = 5 (default)
+     */
     @JsonProperty("succeededRevisionLimit")
     public Integer getSucceededRevisionLimit() {
         return succeededRevisionLimit;
     }
 
+    /**
+     * succeededRevisionLimit is the number of successful static pod installer revisions to keep on disk and in the api -1 = unlimited, 0 or unset = 5 (default)
+     */
     @JsonProperty("succeededRevisionLimit")
     public void setSucceededRevisionLimit(Integer succeededRevisionLimit) {
         this.succeededRevisionLimit = succeededRevisionLimit;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/EtcdStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/EtcdStatus.java
index 8e6fc4b8954..479563f0db6 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/EtcdStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/EtcdStatus.java
@@ -115,94 +115,148 @@ public EtcdStatus(List<OperatorCondition> conditions, String controlPlaneHardwar
         this.version = version;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Possible enum values:<br><p>  - `"Slower"` provides more tolerance for slower hardware and/or higher latency networks. Sets (values subject to change): ETCD_HEARTBEAT_INTERVAL: 5x Standard ETCD_LEADER_ELECTION_TIMEOUT: 2.5x Standard<br><p>  - `"Standard"` provides the normal tolerances for hardware speed and latency. Currently sets (values subject to change at any time): ETCD_HEARTBEAT_INTERVAL: 100ms ETCD_LEADER_ELECTION_TIMEOUT: 1000ms
+     */
     @JsonProperty("controlPlaneHardwareSpeed")
     public String getControlPlaneHardwareSpeed() {
         return controlPlaneHardwareSpeed;
     }
 
+    /**
+     * Possible enum values:<br><p>  - `"Slower"` provides more tolerance for slower hardware and/or higher latency networks. Sets (values subject to change): ETCD_HEARTBEAT_INTERVAL: 5x Standard ETCD_LEADER_ELECTION_TIMEOUT: 2.5x Standard<br><p>  - `"Standard"` provides the normal tolerances for hardware speed and latency. Currently sets (values subject to change at any time): ETCD_HEARTBEAT_INTERVAL: 100ms ETCD_LEADER_ELECTION_TIMEOUT: 1000ms
+     */
     @JsonProperty("controlPlaneHardwareSpeed")
     public void setControlPlaneHardwareSpeed(String controlPlaneHardwareSpeed) {
         this.controlPlaneHardwareSpeed = controlPlaneHardwareSpeed;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenerationStatus> getGenerations() {
         return generations;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     public void setGenerations(List<GenerationStatus> generations) {
         this.generations = generations;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public Integer getLatestAvailableRevision() {
         return latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public void setLatestAvailableRevision(Integer latestAvailableRevision) {
         this.latestAvailableRevision = latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevisionReason describe the detailed reason for the most recent deployment
+     */
     @JsonProperty("latestAvailableRevisionReason")
     public String getLatestAvailableRevisionReason() {
         return latestAvailableRevisionReason;
     }
 
+    /**
+     * latestAvailableRevisionReason describe the detailed reason for the most recent deployment
+     */
     @JsonProperty("latestAvailableRevisionReason")
     public void setLatestAvailableRevisionReason(String latestAvailableRevisionReason) {
         this.latestAvailableRevisionReason = latestAvailableRevisionReason;
     }
 
+    /**
+     * nodeStatuses track the deployment values and errors across individual nodes
+     */
     @JsonProperty("nodeStatuses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NodeStatus> getNodeStatuses() {
         return nodeStatuses;
     }
 
+    /**
+     * nodeStatuses track the deployment values and errors across individual nodes
+     */
     @JsonProperty("nodeStatuses")
     public void setNodeStatuses(List<NodeStatus> nodeStatuses) {
         this.nodeStatuses = nodeStatuses;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/FeaturesMigration.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/FeaturesMigration.java
index 5726fa4b807..5e9d092986b 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/FeaturesMigration.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/FeaturesMigration.java
@@ -86,31 +86,49 @@ public FeaturesMigration(Boolean egressFirewall, Boolean egressIP, Boolean multi
         this.multicast = multicast;
     }
 
+    /**
+     * egressFirewall specified whether or not the Egress Firewall configuration was migrated. DEPRECATED: network type migration is no longer supported.
+     */
     @JsonProperty("egressFirewall")
     public Boolean getEgressFirewall() {
         return egressFirewall;
     }
 
+    /**
+     * egressFirewall specified whether or not the Egress Firewall configuration was migrated. DEPRECATED: network type migration is no longer supported.
+     */
     @JsonProperty("egressFirewall")
     public void setEgressFirewall(Boolean egressFirewall) {
         this.egressFirewall = egressFirewall;
     }
 
+    /**
+     * egressIP specified whether or not the Egress IP configuration was migrated. DEPRECATED: network type migration is no longer supported.
+     */
     @JsonProperty("egressIP")
     public Boolean getEgressIP() {
         return egressIP;
     }
 
+    /**
+     * egressIP specified whether or not the Egress IP configuration was migrated. DEPRECATED: network type migration is no longer supported.
+     */
     @JsonProperty("egressIP")
     public void setEgressIP(Boolean egressIP) {
         this.egressIP = egressIP;
     }
 
+    /**
+     * multicast specified whether or not the multicast configuration was migrated. DEPRECATED: network type migration is no longer supported.
+     */
     @JsonProperty("multicast")
     public Boolean getMulticast() {
         return multicast;
     }
 
+    /**
+     * multicast specified whether or not the multicast configuration was migrated. DEPRECATED: network type migration is no longer supported.
+     */
     @JsonProperty("multicast")
     public void setMulticast(Boolean multicast) {
         this.multicast = multicast;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ForwardPlugin.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ForwardPlugin.java
index 1c7206c81d0..bf97f531417 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ForwardPlugin.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ForwardPlugin.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ForwardPlugin defines a schema for configuring the CoreDNS forward plugin.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public ForwardPlugin(String policy, String protocolStrategy, DNSTransportConfig
         this.upstreams = upstreams;
     }
 
+    /**
+     * policy is used to determine the order in which upstream servers are selected for querying. Any one of the following values may be specified:<br><p> <br><p> &#42; "Random" picks a random upstream server for each query. &#42; "RoundRobin" picks upstream servers in a round-robin order, moving to the next server for each new query. &#42; "Sequential" tries querying upstream servers in a sequential order until one responds, starting with the first server for each new query.<br><p> <br><p> The default value is "Random"
+     */
     @JsonProperty("policy")
     public String getPolicy() {
         return policy;
     }
 
+    /**
+     * policy is used to determine the order in which upstream servers are selected for querying. Any one of the following values may be specified:<br><p> <br><p> &#42; "Random" picks a random upstream server for each query. &#42; "RoundRobin" picks upstream servers in a round-robin order, moving to the next server for each new query. &#42; "Sequential" tries querying upstream servers in a sequential order until one responds, starting with the first server for each new query.<br><p> <br><p> The default value is "Random"
+     */
     @JsonProperty("policy")
     public void setPolicy(String policy) {
         this.policy = policy;
     }
 
+    /**
+     * protocolStrategy specifies the protocol to use for upstream DNS requests. Valid values for protocolStrategy are "TCP" and omitted. When omitted, this means no opinion and the platform is left to choose a reasonable default, which is subject to change over time. The current default is to use the protocol of the original client request. "TCP" specifies that the platform should use TCP for all upstream DNS requests, even if the client request uses UDP. "TCP" is useful for UDP-specific issues such as those created by non-compliant upstream resolvers, but may consume more bandwidth or increase DNS response time. Note that protocolStrategy only affects the protocol of DNS requests that CoreDNS makes to upstream resolvers. It does not affect the protocol of DNS requests between clients and CoreDNS.
+     */
     @JsonProperty("protocolStrategy")
     public String getProtocolStrategy() {
         return protocolStrategy;
     }
 
+    /**
+     * protocolStrategy specifies the protocol to use for upstream DNS requests. Valid values for protocolStrategy are "TCP" and omitted. When omitted, this means no opinion and the platform is left to choose a reasonable default, which is subject to change over time. The current default is to use the protocol of the original client request. "TCP" specifies that the platform should use TCP for all upstream DNS requests, even if the client request uses UDP. "TCP" is useful for UDP-specific issues such as those created by non-compliant upstream resolvers, but may consume more bandwidth or increase DNS response time. Note that protocolStrategy only affects the protocol of DNS requests that CoreDNS makes to upstream resolvers. It does not affect the protocol of DNS requests between clients and CoreDNS.
+     */
     @JsonProperty("protocolStrategy")
     public void setProtocolStrategy(String protocolStrategy) {
         this.protocolStrategy = protocolStrategy;
     }
 
+    /**
+     * ForwardPlugin defines a schema for configuring the CoreDNS forward plugin.
+     */
     @JsonProperty("transportConfig")
     public DNSTransportConfig getTransportConfig() {
         return transportConfig;
     }
 
+    /**
+     * ForwardPlugin defines a schema for configuring the CoreDNS forward plugin.
+     */
     @JsonProperty("transportConfig")
     public void setTransportConfig(DNSTransportConfig transportConfig) {
         this.transportConfig = transportConfig;
     }
 
+    /**
+     * upstreams is a list of resolvers to forward name queries for subdomains of Zones. Each instance of CoreDNS performs health checking of Upstreams. When a healthy upstream returns an error during the exchange, another resolver is tried from Upstreams. The Upstreams are selected in the order specified in Policy. Each upstream is represented by an IP address or IP:port if the upstream listens on a port other than 53.<br><p> <br><p> A maximum of 15 upstreams is allowed per ForwardPlugin.
+     */
     @JsonProperty("upstreams")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getUpstreams() {
         return upstreams;
     }
 
+    /**
+     * upstreams is a list of resolvers to forward name queries for subdomains of Zones. Each instance of CoreDNS performs health checking of Upstreams. When a healthy upstream returns an error during the exchange, another resolver is tried from Upstreams. The Upstreams are selected in the order specified in Policy. Each upstream is represented by an IP address or IP:port if the upstream listens on a port other than 53.<br><p> <br><p> A maximum of 15 upstreams is allowed per ForwardPlugin.
+     */
     @JsonProperty("upstreams")
     public void setUpstreams(List<String> upstreams) {
         this.upstreams = upstreams;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/GCPCSIDriverConfigSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/GCPCSIDriverConfigSpec.java
index c45d6b87d20..420380f7265 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/GCPCSIDriverConfigSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/GCPCSIDriverConfigSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPCSIDriverConfigSpec defines properties that can be configured for the GCP CSI driver.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public GCPCSIDriverConfigSpec(GCPKMSKeyReference kmsKey) {
         this.kmsKey = kmsKey;
     }
 
+    /**
+     * GCPCSIDriverConfigSpec defines properties that can be configured for the GCP CSI driver.
+     */
     @JsonProperty("kmsKey")
     public GCPKMSKeyReference getKmsKey() {
         return kmsKey;
     }
 
+    /**
+     * GCPCSIDriverConfigSpec defines properties that can be configured for the GCP CSI driver.
+     */
     @JsonProperty("kmsKey")
     public void setKmsKey(GCPKMSKeyReference kmsKey) {
         this.kmsKey = kmsKey;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/GCPKMSKeyReference.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/GCPKMSKeyReference.java
index b363c9fc3cc..eabbc602ac6 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/GCPKMSKeyReference.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/GCPKMSKeyReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPKMSKeyReference gathers required fields for looking up a GCP KMS Key
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public GCPKMSKeyReference(String keyRing, String location, String name, String p
         this.projectID = projectID;
     }
 
+    /**
+     * keyRing is the name of the KMS Key Ring which the KMS Key belongs to. The value should correspond to an existing KMS key ring and should consist of only alphanumeric characters, hyphens (-) and underscores (_), and be at most 63 characters in length.
+     */
     @JsonProperty("keyRing")
     public String getKeyRing() {
         return keyRing;
     }
 
+    /**
+     * keyRing is the name of the KMS Key Ring which the KMS Key belongs to. The value should correspond to an existing KMS key ring and should consist of only alphanumeric characters, hyphens (-) and underscores (_), and be at most 63 characters in length.
+     */
     @JsonProperty("keyRing")
     public void setKeyRing(String keyRing) {
         this.keyRing = keyRing;
     }
 
+    /**
+     * location is the GCP location in which the Key Ring exists. The value must match an existing GCP location, or "global". Defaults to global, if not set.
+     */
     @JsonProperty("location")
     public String getLocation() {
         return location;
     }
 
+    /**
+     * location is the GCP location in which the Key Ring exists. The value must match an existing GCP location, or "global". Defaults to global, if not set.
+     */
     @JsonProperty("location")
     public void setLocation(String location) {
         this.location = location;
     }
 
+    /**
+     * name is the name of the customer-managed encryption key to be used for disk encryption. The value should correspond to an existing KMS key and should consist of only alphanumeric characters, hyphens (-) and underscores (_), and be at most 63 characters in length.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the customer-managed encryption key to be used for disk encryption. The value should correspond to an existing KMS key and should consist of only alphanumeric characters, hyphens (-) and underscores (_), and be at most 63 characters in length.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * projectID is the ID of the Project in which the KMS Key Ring exists. It must be 6 to 30 lowercase letters, digits, or hyphens. It must start with a letter. Trailing hyphens are prohibited.
+     */
     @JsonProperty("projectID")
     public String getProjectID() {
         return projectID;
     }
 
+    /**
+     * projectID is the ID of the Project in which the KMS Key Ring exists. It must be 6 to 30 lowercase letters, digits, or hyphens. It must start with a letter. Trailing hyphens are prohibited.
+     */
     @JsonProperty("projectID")
     public void setProjectID(String projectID) {
         this.projectID = projectID;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/GCPLoadBalancerParameters.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/GCPLoadBalancerParameters.java
index 617d87c23c1..0b37d25d03a 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/GCPLoadBalancerParameters.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/GCPLoadBalancerParameters.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GCPLoadBalancerParameters provides configuration settings that are specific to GCP load balancers.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public GCPLoadBalancerParameters(String clientAccess) {
         this.clientAccess = clientAccess;
     }
 
+    /**
+     * clientAccess describes how client access is restricted for internal load balancers.<br><p> <br><p> Valid values are: &#42; "Global": Specifying an internal load balancer with Global client access<br><p>   allows clients from any region within the VPC to communicate with the load<br><p>   balancer.<br><p> <br><p>     https://cloud.google.com/kubernetes-engine/docs/how-to/internal-load-balancing#global_access<br><p> <br><p> &#42; "Local": Specifying an internal load balancer with Local client access<br><p>   means only clients within the same region (and VPC) as the GCP load balancer<br><p>   can communicate with the load balancer. Note that this is the default behavior.<br><p> <br><p>     https://cloud.google.com/load-balancing/docs/internal#client_access
+     */
     @JsonProperty("clientAccess")
     public String getClientAccess() {
         return clientAccess;
     }
 
+    /**
+     * clientAccess describes how client access is restricted for internal load balancers.<br><p> <br><p> Valid values are: &#42; "Global": Specifying an internal load balancer with Global client access<br><p>   allows clients from any region within the VPC to communicate with the load<br><p>   balancer.<br><p> <br><p>     https://cloud.google.com/kubernetes-engine/docs/how-to/internal-load-balancing#global_access<br><p> <br><p> &#42; "Local": Specifying an internal load balancer with Local client access<br><p>   means only clients within the same region (and VPC) as the GCP load balancer<br><p>   can communicate with the load balancer. Note that this is the default behavior.<br><p> <br><p>     https://cloud.google.com/load-balancing/docs/internal#client_access
+     */
     @JsonProperty("clientAccess")
     public void setClientAccess(String clientAccess) {
         this.clientAccess = clientAccess;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/GatewayConfig.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/GatewayConfig.java
index 8328fdf0fab..9fc92b70370 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/GatewayConfig.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/GatewayConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GatewayConfig holds node gateway-related parsed config file parameters and command-line overrides
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public GatewayConfig(String ipForwarding, IPv4GatewayConfig ipv4, IPv6GatewayCon
         this.routingViaHost = routingViaHost;
     }
 
+    /**
+     * IPForwarding controls IP forwarding for all traffic on OVN-Kubernetes managed interfaces (such as br-ex). By default this is set to Restricted, and Kubernetes related traffic is still forwarded appropriately, but other IP traffic will not be routed by the OCP node. If there is a desire to allow the host to forward traffic across OVN-Kubernetes managed interfaces, then set this field to "Global". The supported values are "Restricted" and "Global".
+     */
     @JsonProperty("ipForwarding")
     public String getIpForwarding() {
         return ipForwarding;
     }
 
+    /**
+     * IPForwarding controls IP forwarding for all traffic on OVN-Kubernetes managed interfaces (such as br-ex). By default this is set to Restricted, and Kubernetes related traffic is still forwarded appropriately, but other IP traffic will not be routed by the OCP node. If there is a desire to allow the host to forward traffic across OVN-Kubernetes managed interfaces, then set this field to "Global". The supported values are "Restricted" and "Global".
+     */
     @JsonProperty("ipForwarding")
     public void setIpForwarding(String ipForwarding) {
         this.ipForwarding = ipForwarding;
     }
 
+    /**
+     * GatewayConfig holds node gateway-related parsed config file parameters and command-line overrides
+     */
     @JsonProperty("ipv4")
     public IPv4GatewayConfig getIpv4() {
         return ipv4;
     }
 
+    /**
+     * GatewayConfig holds node gateway-related parsed config file parameters and command-line overrides
+     */
     @JsonProperty("ipv4")
     public void setIpv4(IPv4GatewayConfig ipv4) {
         this.ipv4 = ipv4;
     }
 
+    /**
+     * GatewayConfig holds node gateway-related parsed config file parameters and command-line overrides
+     */
     @JsonProperty("ipv6")
     public IPv6GatewayConfig getIpv6() {
         return ipv6;
     }
 
+    /**
+     * GatewayConfig holds node gateway-related parsed config file parameters and command-line overrides
+     */
     @JsonProperty("ipv6")
     public void setIpv6(IPv6GatewayConfig ipv6) {
         this.ipv6 = ipv6;
     }
 
+    /**
+     * RoutingViaHost allows pod egress traffic to exit via the ovn-k8s-mp0 management port into the host before sending it out. If this is not set, traffic will always egress directly from OVN to outside without touching the host stack. Setting this to true means hardware offload will not be supported. Default is false if GatewayConfig is specified.
+     */
     @JsonProperty("routingViaHost")
     public Boolean getRoutingViaHost() {
         return routingViaHost;
     }
 
+    /**
+     * RoutingViaHost allows pod egress traffic to exit via the ovn-k8s-mp0 management port into the host before sending it out. If this is not set, traffic will always egress directly from OVN to outside without touching the host stack. Setting this to true means hardware offload will not be supported. Default is false if GatewayConfig is specified.
+     */
     @JsonProperty("routingViaHost")
     public void setRoutingViaHost(Boolean routingViaHost) {
         this.routingViaHost = routingViaHost;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/GatherStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/GatherStatus.java
index 4905a536796..12f956edc7d 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/GatherStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/GatherStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * gatherStatus provides information about the last known gather event.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public GatherStatus(List<GathererStatus> gatherers, String lastGatherDuration, S
         this.lastGatherTime = lastGatherTime;
     }
 
+    /**
+     * gatherers is a list of active gatherers (and their statuses) in the last gathering.
+     */
     @JsonProperty("gatherers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GathererStatus> getGatherers() {
         return gatherers;
     }
 
+    /**
+     * gatherers is a list of active gatherers (and their statuses) in the last gathering.
+     */
     @JsonProperty("gatherers")
     public void setGatherers(List<GathererStatus> gatherers) {
         this.gatherers = gatherers;
     }
 
+    /**
+     * gatherStatus provides information about the last known gather event.
+     */
     @JsonProperty("lastGatherDuration")
     public String getLastGatherDuration() {
         return lastGatherDuration;
     }
 
+    /**
+     * gatherStatus provides information about the last known gather event.
+     */
     @JsonProperty("lastGatherDuration")
     public void setLastGatherDuration(String lastGatherDuration) {
         this.lastGatherDuration = lastGatherDuration;
     }
 
+    /**
+     * gatherStatus provides information about the last known gather event.
+     */
     @JsonProperty("lastGatherTime")
     public String getLastGatherTime() {
         return lastGatherTime;
     }
 
+    /**
+     * gatherStatus provides information about the last known gather event.
+     */
     @JsonProperty("lastGatherTime")
     public void setLastGatherTime(String lastGatherTime) {
         this.lastGatherTime = lastGatherTime;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/GathererStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/GathererStatus.java
index 8c402154fe5..1c5aa3ba9ba 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/GathererStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/GathererStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * gathererStatus represents information about a particular data gatherer.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,32 +93,50 @@ public GathererStatus(List<Condition> conditions, String lastGatherDuration, Str
         this.name = name;
     }
 
+    /**
+     * conditions provide details on the status of each gatherer.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions provide details on the status of each gatherer.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * gathererStatus represents information about a particular data gatherer.
+     */
     @JsonProperty("lastGatherDuration")
     public String getLastGatherDuration() {
         return lastGatherDuration;
     }
 
+    /**
+     * gathererStatus represents information about a particular data gatherer.
+     */
     @JsonProperty("lastGatherDuration")
     public void setLastGatherDuration(String lastGatherDuration) {
         this.lastGatherDuration = lastGatherDuration;
     }
 
+    /**
+     * name is the name of the gatherer.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the gatherer.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/GenerationStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/GenerationStatus.java
index 86931902f60..f6da643677b 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/GenerationStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/GenerationStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GenerationStatus keeps track of the generation for a given resource so that decisions about forced updates can be made.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public GenerationStatus(String group, String hash, Long lastGeneration, String n
         this.resource = resource;
     }
 
+    /**
+     * group is the group of the thing you're tracking
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * group is the group of the thing you're tracking
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * hash is an optional field set for resources without generation that are content sensitive like secrets and configmaps
+     */
     @JsonProperty("hash")
     public String getHash() {
         return hash;
     }
 
+    /**
+     * hash is an optional field set for resources without generation that are content sensitive like secrets and configmaps
+     */
     @JsonProperty("hash")
     public void setHash(String hash) {
         this.hash = hash;
     }
 
+    /**
+     * lastGeneration is the last generation of the workload controller involved
+     */
     @JsonProperty("lastGeneration")
     public Long getLastGeneration() {
         return lastGeneration;
     }
 
+    /**
+     * lastGeneration is the last generation of the workload controller involved
+     */
     @JsonProperty("lastGeneration")
     public void setLastGeneration(Long lastGeneration) {
         this.lastGeneration = lastGeneration;
     }
 
+    /**
+     * name is the name of the thing you're tracking
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the thing you're tracking
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * namespace is where the thing you're tracking is
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * namespace is where the thing you're tracking is
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * resource is the resource type of the thing you're tracking
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * resource is the resource type of the thing you're tracking
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/HTTPCompressionPolicy.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/HTTPCompressionPolicy.java
index b05cb79a00d..75d2a2986cd 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/HTTPCompressionPolicy.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/HTTPCompressionPolicy.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * httpCompressionPolicy turns on compression for the specified MIME types.<br><p> <br><p> This field is optional, and its absence implies that compression should not be enabled globally in HAProxy.<br><p> <br><p> If httpCompressionPolicy exists, compression should be enabled only for the specified MIME types.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public HTTPCompressionPolicy(List<String> mimeTypes) {
         this.mimeTypes = mimeTypes;
     }
 
+    /**
+     * mimeTypes is a list of MIME types that should have compression applied. This list can be empty, in which case the ingress controller does not apply compression.<br><p> <br><p> Note: Not all MIME types benefit from compression, but HAProxy will still use resources to try to compress if instructed to.  Generally speaking, text (html, css, js, etc.) formats benefit from compression, but formats that are already compressed (image, audio, video, etc.) benefit little in exchange for the time and cpu spent on compressing again. See https://joehonton.medium.com/the-gzip-penalty-d31bd697f1a2
+     */
     @JsonProperty("mimeTypes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMimeTypes() {
         return mimeTypes;
     }
 
+    /**
+     * mimeTypes is a list of MIME types that should have compression applied. This list can be empty, in which case the ingress controller does not apply compression.<br><p> <br><p> Note: Not all MIME types benefit from compression, but HAProxy will still use resources to try to compress if instructed to.  Generally speaking, text (html, css, js, etc.) formats benefit from compression, but formats that are already compressed (image, audio, video, etc.) benefit little in exchange for the time and cpu spent on compressing again. See https://joehonton.medium.com/the-gzip-penalty-d31bd697f1a2
+     */
     @JsonProperty("mimeTypes")
     public void setMimeTypes(List<String> mimeTypes) {
         this.mimeTypes = mimeTypes;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/HealthCheck.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/HealthCheck.java
index 77208831128..90f6c4f49af 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/HealthCheck.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/HealthCheck.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * healthCheck represents an Insights health check attributes.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public HealthCheck(String advisorURI, String description, String state, Integer
         this.totalRisk = totalRisk;
     }
 
+    /**
+     * advisorURI provides the URL link to the Insights Advisor.
+     */
     @JsonProperty("advisorURI")
     public String getAdvisorURI() {
         return advisorURI;
     }
 
+    /**
+     * advisorURI provides the URL link to the Insights Advisor.
+     */
     @JsonProperty("advisorURI")
     public void setAdvisorURI(String advisorURI) {
         this.advisorURI = advisorURI;
     }
 
+    /**
+     * description provides basic description of the healtcheck.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * description provides basic description of the healtcheck.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * state determines what the current state of the health check is. Health check is enabled by default and can be disabled by the user in the Insights advisor user interface.
+     */
     @JsonProperty("state")
     public String getState() {
         return state;
     }
 
+    /**
+     * state determines what the current state of the health check is. Health check is enabled by default and can be disabled by the user in the Insights advisor user interface.
+     */
     @JsonProperty("state")
     public void setState(String state) {
         this.state = state;
     }
 
+    /**
+     * totalRisk of the healthcheck. Indicator of the total risk posed by the detected issue; combination of impact and likelihood. The values can be from 1 to 4, and the higher the number, the more important the issue.
+     */
     @JsonProperty("totalRisk")
     public Integer getTotalRisk() {
         return totalRisk;
     }
 
+    /**
+     * totalRisk of the healthcheck. Indicator of the total risk posed by the detected issue; combination of impact and likelihood. The values can be from 1 to 4, and the higher the number, the more important the issue.
+     */
     @JsonProperty("totalRisk")
     public void setTotalRisk(Integer totalRisk) {
         this.totalRisk = totalRisk;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/HostNetworkStrategy.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/HostNetworkStrategy.java
index 22c2a9719fc..fc6006605af 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/HostNetworkStrategy.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/HostNetworkStrategy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * HostNetworkStrategy holds parameters for the HostNetwork endpoint publishing strategy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public HostNetworkStrategy(Integer httpPort, Integer httpsPort, String protocol,
         this.statsPort = statsPort;
     }
 
+    /**
+     * httpPort is the port on the host which should be used to listen for HTTP requests. This field should be set when port 80 is already in use. The value should not coincide with the NodePort range of the cluster. When the value is 0 or is not specified it defaults to 80.
+     */
     @JsonProperty("httpPort")
     public Integer getHttpPort() {
         return httpPort;
     }
 
+    /**
+     * httpPort is the port on the host which should be used to listen for HTTP requests. This field should be set when port 80 is already in use. The value should not coincide with the NodePort range of the cluster. When the value is 0 or is not specified it defaults to 80.
+     */
     @JsonProperty("httpPort")
     public void setHttpPort(Integer httpPort) {
         this.httpPort = httpPort;
     }
 
+    /**
+     * httpsPort is the port on the host which should be used to listen for HTTPS requests. This field should be set when port 443 is already in use. The value should not coincide with the NodePort range of the cluster. When the value is 0 or is not specified it defaults to 443.
+     */
     @JsonProperty("httpsPort")
     public Integer getHttpsPort() {
         return httpsPort;
     }
 
+    /**
+     * httpsPort is the port on the host which should be used to listen for HTTPS requests. This field should be set when port 443 is already in use. The value should not coincide with the NodePort range of the cluster. When the value is 0 or is not specified it defaults to 443.
+     */
     @JsonProperty("httpsPort")
     public void setHttpsPort(Integer httpsPort) {
         this.httpsPort = httpsPort;
     }
 
+    /**
+     * protocol specifies whether the IngressController expects incoming connections to use plain TCP or whether the IngressController expects PROXY protocol.<br><p> <br><p> PROXY protocol can be used with load balancers that support it to communicate the source addresses of client connections when forwarding those connections to the IngressController.  Using PROXY protocol enables the IngressController to report those source addresses instead of reporting the load balancer's address in HTTP headers and logs.  Note that enabling PROXY protocol on the IngressController will cause connections to fail if you are not using a load balancer that uses PROXY protocol to forward connections to the IngressController.  See http://www.haproxy.org/download/2.2/doc/proxy-protocol.txt for information about PROXY protocol.<br><p> <br><p> The following values are valid for this field:<br><p> <br><p> &#42; The empty string. &#42; "TCP". &#42; "PROXY".<br><p> <br><p> The empty string specifies the default, which is TCP without PROXY protocol.  Note that the default is subject to change.
+     */
     @JsonProperty("protocol")
     public String getProtocol() {
         return protocol;
     }
 
+    /**
+     * protocol specifies whether the IngressController expects incoming connections to use plain TCP or whether the IngressController expects PROXY protocol.<br><p> <br><p> PROXY protocol can be used with load balancers that support it to communicate the source addresses of client connections when forwarding those connections to the IngressController.  Using PROXY protocol enables the IngressController to report those source addresses instead of reporting the load balancer's address in HTTP headers and logs.  Note that enabling PROXY protocol on the IngressController will cause connections to fail if you are not using a load balancer that uses PROXY protocol to forward connections to the IngressController.  See http://www.haproxy.org/download/2.2/doc/proxy-protocol.txt for information about PROXY protocol.<br><p> <br><p> The following values are valid for this field:<br><p> <br><p> &#42; The empty string. &#42; "TCP". &#42; "PROXY".<br><p> <br><p> The empty string specifies the default, which is TCP without PROXY protocol.  Note that the default is subject to change.
+     */
     @JsonProperty("protocol")
     public void setProtocol(String protocol) {
         this.protocol = protocol;
     }
 
+    /**
+     * statsPort is the port on the host where the stats from the router are published. The value should not coincide with the NodePort range of the cluster. If an external load balancer is configured to forward connections to this IngressController, the load balancer should use this port for health checks. The load balancer can send HTTP probes on this port on a given node, with the path /healthz/ready to determine if the ingress controller is ready to receive traffic on the node. For proper operation the load balancer must not forward traffic to a node until the health check reports ready. The load balancer should also stop forwarding requests within a maximum of 45 seconds after /healthz/ready starts reporting not-ready. Probing every 5 to 10 seconds, with a 5-second timeout and with a threshold of two successful or failed requests to become healthy or unhealthy respectively, are well-tested values. When the value is 0 or is not specified it defaults to 1936.
+     */
     @JsonProperty("statsPort")
     public Integer getStatsPort() {
         return statsPort;
     }
 
+    /**
+     * statsPort is the port on the host where the stats from the router are published. The value should not coincide with the NodePort range of the cluster. If an external load balancer is configured to forward connections to this IngressController, the load balancer should use this port for health checks. The load balancer can send HTTP probes on this port on a given node, with the path /healthz/ready to determine if the ingress controller is ready to receive traffic on the node. For proper operation the load balancer must not forward traffic to a node until the health check reports ready. The load balancer should also stop forwarding requests within a maximum of 45 seconds after /healthz/ready starts reporting not-ready. Probing every 5 to 10 seconds, with a 5-second timeout and with a threshold of two successful or failed requests to become healthy or unhealthy respectively, are well-tested values. When the value is 0 or is not specified it defaults to 1936.
+     */
     @JsonProperty("statsPort")
     public void setStatsPort(Integer statsPort) {
         this.statsPort = statsPort;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/HybridOverlayConfig.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/HybridOverlayConfig.java
index 0f28c172c06..0ff7f5b6be7 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/HybridOverlayConfig.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/HybridOverlayConfig.java
@@ -85,22 +85,34 @@ public HybridOverlayConfig(List<ClusterNetworkEntry> hybridClusterNetwork, Long
         this.hybridOverlayVXLANPort = hybridOverlayVXLANPort;
     }
 
+    /**
+     * HybridClusterNetwork defines a network space given to nodes on an additional overlay network.
+     */
     @JsonProperty("hybridClusterNetwork")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ClusterNetworkEntry> getHybridClusterNetwork() {
         return hybridClusterNetwork;
     }
 
+    /**
+     * HybridClusterNetwork defines a network space given to nodes on an additional overlay network.
+     */
     @JsonProperty("hybridClusterNetwork")
     public void setHybridClusterNetwork(List<ClusterNetworkEntry> hybridClusterNetwork) {
         this.hybridClusterNetwork = hybridClusterNetwork;
     }
 
+    /**
+     * HybridOverlayVXLANPort defines the VXLAN port number to be used by the additional overlay network. Default is 4789
+     */
     @JsonProperty("hybridOverlayVXLANPort")
     public Long getHybridOverlayVXLANPort() {
         return hybridOverlayVXLANPort;
     }
 
+    /**
+     * HybridOverlayVXLANPort defines the VXLAN port number to be used by the additional overlay network. Default is 4789
+     */
     @JsonProperty("hybridOverlayVXLANPort")
     public void setHybridOverlayVXLANPort(Long hybridOverlayVXLANPort) {
         this.hybridOverlayVXLANPort = hybridOverlayVXLANPort;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IBMCloudCSIDriverConfigSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IBMCloudCSIDriverConfigSpec.java
index 76640c880ee..a3c5e459645 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IBMCloudCSIDriverConfigSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IBMCloudCSIDriverConfigSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IBMCloudCSIDriverConfigSpec defines the properties that can be configured for the IBM Cloud CSI driver.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public IBMCloudCSIDriverConfigSpec(String encryptionKeyCRN) {
         this.encryptionKeyCRN = encryptionKeyCRN;
     }
 
+    /**
+     * encryptionKeyCRN is the IBM Cloud CRN of the customer-managed root key to use for disk encryption of volumes for the default storage classes.
+     */
     @JsonProperty("encryptionKeyCRN")
     public String getEncryptionKeyCRN() {
         return encryptionKeyCRN;
     }
 
+    /**
+     * encryptionKeyCRN is the IBM Cloud CRN of the customer-managed root key to use for disk encryption of volumes for the default storage classes.
+     */
     @JsonProperty("encryptionKeyCRN")
     public void setEncryptionKeyCRN(String encryptionKeyCRN) {
         this.encryptionKeyCRN = encryptionKeyCRN;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IBMLoadBalancerParameters.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IBMLoadBalancerParameters.java
index bbb77dea20f..20cfb8b74c4 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IBMLoadBalancerParameters.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IBMLoadBalancerParameters.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IBMLoadBalancerParameters provides configuration settings that are specific to IBM Cloud load balancers.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public IBMLoadBalancerParameters(String protocol) {
         this.protocol = protocol;
     }
 
+    /**
+     * protocol specifies whether the load balancer uses PROXY protocol to forward connections to the IngressController. See "service.kubernetes.io/ibm-load-balancer-cloud-provider-enable-features: "proxy-protocol"" at https://cloud.ibm.com/docs/containers?topic=containers-vpc-lbaas"<br><p> <br><p> PROXY protocol can be used with load balancers that support it to communicate the source addresses of client connections when forwarding those connections to the IngressController.  Using PROXY protocol enables the IngressController to report those source addresses instead of reporting the load balancer's address in HTTP headers and logs.  Note that enabling PROXY protocol on the IngressController will cause connections to fail if you are not using a load balancer that uses PROXY protocol to forward connections to the IngressController.  See http://www.haproxy.org/download/2.2/doc/proxy-protocol.txt for information about PROXY protocol.<br><p> <br><p> Valid values for protocol are TCP, PROXY and omitted. When omitted, this means no opinion and the platform is left to choose a reasonable default, which is subject to change over time. The current default is TCP, without the proxy protocol enabled.
+     */
     @JsonProperty("protocol")
     public String getProtocol() {
         return protocol;
     }
 
+    /**
+     * protocol specifies whether the load balancer uses PROXY protocol to forward connections to the IngressController. See "service.kubernetes.io/ibm-load-balancer-cloud-provider-enable-features: "proxy-protocol"" at https://cloud.ibm.com/docs/containers?topic=containers-vpc-lbaas"<br><p> <br><p> PROXY protocol can be used with load balancers that support it to communicate the source addresses of client connections when forwarding those connections to the IngressController.  Using PROXY protocol enables the IngressController to report those source addresses instead of reporting the load balancer's address in HTTP headers and logs.  Note that enabling PROXY protocol on the IngressController will cause connections to fail if you are not using a load balancer that uses PROXY protocol to forward connections to the IngressController.  See http://www.haproxy.org/download/2.2/doc/proxy-protocol.txt for information about PROXY protocol.<br><p> <br><p> Valid values for protocol are TCP, PROXY and omitted. When omitted, this means no opinion and the platform is left to choose a reasonable default, which is subject to change over time. The current default is TCP, without the proxy protocol enabled.
+     */
     @JsonProperty("protocol")
     public void setProtocol(String protocol) {
         this.protocol = protocol;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IPAMConfig.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IPAMConfig.java
index 3d580285b34..94af1eac70f 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IPAMConfig.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IPAMConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IPAMConfig contains configurations for IPAM (IP Address Management)
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public IPAMConfig(StaticIPAMConfig staticIPAMConfig, String type) {
         this.type = type;
     }
 
+    /**
+     * IPAMConfig contains configurations for IPAM (IP Address Management)
+     */
     @JsonProperty("staticIPAMConfig")
     public StaticIPAMConfig getStaticIPAMConfig() {
         return staticIPAMConfig;
     }
 
+    /**
+     * IPAMConfig contains configurations for IPAM (IP Address Management)
+     */
     @JsonProperty("staticIPAMConfig")
     public void setStaticIPAMConfig(StaticIPAMConfig staticIPAMConfig) {
         this.staticIPAMConfig = staticIPAMConfig;
     }
 
+    /**
+     * Type is the type of IPAM module will be used for IP Address Management(IPAM). The supported values are IPAMTypeDHCP, IPAMTypeStatic
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of IPAM module will be used for IP Address Management(IPAM). The supported values are IPAMTypeDHCP, IPAMTypeStatic
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IPFIXConfig.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IPFIXConfig.java
index 426e1aa5db7..9eae7e611e4 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IPFIXConfig.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IPFIXConfig.java
@@ -81,12 +81,18 @@ public IPFIXConfig(List<String> collectors) {
         this.collectors = collectors;
     }
 
+    /**
+     * ipfixCollectors is list of strings formatted as ip:port with a maximum of ten items
+     */
     @JsonProperty("collectors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCollectors() {
         return collectors;
     }
 
+    /**
+     * ipfixCollectors is list of strings formatted as ip:port with a maximum of ten items
+     */
     @JsonProperty("collectors")
     public void setCollectors(List<String> collectors) {
         this.collectors = collectors;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IPsecConfig.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IPsecConfig.java
index 06176d1df58..dce27eca1e3 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IPsecConfig.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IPsecConfig.java
@@ -78,11 +78,17 @@ public IPsecConfig(String mode) {
         this.mode = mode;
     }
 
+    /**
+     * mode defines the behaviour of the ipsec configuration within the platform. Valid values are `Disabled`, `External` and `Full`. When 'Disabled', ipsec will not be enabled at the node level. When 'External', ipsec is enabled on the node level but requires the user to configure the secure communication parameters. This mode is for external secure communications and the configuration can be done using the k8s-nmstate operator. When 'Full', ipsec is configured on the node level and inter-pod secure communication within the cluster is configured. Note with `Full`, if ipsec is desired for communication with external (to the cluster) entities (such as storage arrays), this is left to the user to configure.
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * mode defines the behaviour of the ipsec configuration within the platform. Valid values are `Disabled`, `External` and `Full`. When 'Disabled', ipsec will not be enabled at the node level. When 'External', ipsec is enabled on the node level but requires the user to configure the secure communication parameters. This mode is for external secure communications and the configuration can be done using the k8s-nmstate operator. When 'Full', ipsec is configured on the node level and inter-pod secure communication within the cluster is configured. Note with `Full`, if ipsec is desired for communication with external (to the cluster) entities (such as storage arrays), this is left to the user to configure.
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IPv4GatewayConfig.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IPv4GatewayConfig.java
index c97de976df3..4af55fda3e8 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IPv4GatewayConfig.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IPv4GatewayConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IPV4GatewayConfig holds the configuration paramaters for IPV4 connections in the GatewayConfig for OVN-Kubernetes
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public IPv4GatewayConfig(String internalMasqueradeSubnet) {
         this.internalMasqueradeSubnet = internalMasqueradeSubnet;
     }
 
+    /**
+     * internalMasqueradeSubnet contains the masquerade addresses in IPV4 CIDR format used internally by ovn-kubernetes to enable host to service traffic. Each host in the cluster is configured with these addresses, as well as the shared gateway bridge interface. The values can be changed after installation. The subnet chosen should not overlap with other networks specified for OVN-Kubernetes as well as other networks used on the host. Additionally the subnet must be large enough to accommodate 6 IPs (maximum prefix length /29). When omitted, this means no opinion and the platform is left to choose a reasonable default which is subject to change over time. The current default subnet is 169.254.169.0/29 The value must be in proper IPV4 CIDR format
+     */
     @JsonProperty("internalMasqueradeSubnet")
     public String getInternalMasqueradeSubnet() {
         return internalMasqueradeSubnet;
     }
 
+    /**
+     * internalMasqueradeSubnet contains the masquerade addresses in IPV4 CIDR format used internally by ovn-kubernetes to enable host to service traffic. Each host in the cluster is configured with these addresses, as well as the shared gateway bridge interface. The values can be changed after installation. The subnet chosen should not overlap with other networks specified for OVN-Kubernetes as well as other networks used on the host. Additionally the subnet must be large enough to accommodate 6 IPs (maximum prefix length /29). When omitted, this means no opinion and the platform is left to choose a reasonable default which is subject to change over time. The current default subnet is 169.254.169.0/29 The value must be in proper IPV4 CIDR format
+     */
     @JsonProperty("internalMasqueradeSubnet")
     public void setInternalMasqueradeSubnet(String internalMasqueradeSubnet) {
         this.internalMasqueradeSubnet = internalMasqueradeSubnet;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IPv4OVNKubernetesConfig.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IPv4OVNKubernetesConfig.java
index 87113b4b6bb..3fc054a280e 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IPv4OVNKubernetesConfig.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IPv4OVNKubernetesConfig.java
@@ -82,21 +82,33 @@ public IPv4OVNKubernetesConfig(String internalJoinSubnet, String internalTransit
         this.internalTransitSwitchSubnet = internalTransitSwitchSubnet;
     }
 
+    /**
+     * internalJoinSubnet is a v4 subnet used internally by ovn-kubernetes in case the default one is being already used by something else. It must not overlap with any other subnet being used by OpenShift or by the node network. The size of the subnet must be larger than the number of nodes. The value cannot be changed after installation. The current default value is 100.64.0.0/16 The subnet must be large enough to accomadate one IP per node in your cluster The value must be in proper IPV4 CIDR format
+     */
     @JsonProperty("internalJoinSubnet")
     public String getInternalJoinSubnet() {
         return internalJoinSubnet;
     }
 
+    /**
+     * internalJoinSubnet is a v4 subnet used internally by ovn-kubernetes in case the default one is being already used by something else. It must not overlap with any other subnet being used by OpenShift or by the node network. The size of the subnet must be larger than the number of nodes. The value cannot be changed after installation. The current default value is 100.64.0.0/16 The subnet must be large enough to accomadate one IP per node in your cluster The value must be in proper IPV4 CIDR format
+     */
     @JsonProperty("internalJoinSubnet")
     public void setInternalJoinSubnet(String internalJoinSubnet) {
         this.internalJoinSubnet = internalJoinSubnet;
     }
 
+    /**
+     * internalTransitSwitchSubnet is a v4 subnet in IPV4 CIDR format used internally by OVN-Kubernetes for the distributed transit switch in the OVN Interconnect architecture that connects the cluster routers on each node together to enable east west traffic. The subnet chosen should not overlap with other networks specified for OVN-Kubernetes as well as other networks used on the host. The value cannot be changed after installation. When ommitted, this means no opinion and the platform is left to choose a reasonable default which is subject to change over time. The current default subnet is 100.88.0.0/16 The subnet must be large enough to accomadate one IP per node in your cluster The value must be in proper IPV4 CIDR format
+     */
     @JsonProperty("internalTransitSwitchSubnet")
     public String getInternalTransitSwitchSubnet() {
         return internalTransitSwitchSubnet;
     }
 
+    /**
+     * internalTransitSwitchSubnet is a v4 subnet in IPV4 CIDR format used internally by OVN-Kubernetes for the distributed transit switch in the OVN Interconnect architecture that connects the cluster routers on each node together to enable east west traffic. The subnet chosen should not overlap with other networks specified for OVN-Kubernetes as well as other networks used on the host. The value cannot be changed after installation. When ommitted, this means no opinion and the platform is left to choose a reasonable default which is subject to change over time. The current default subnet is 100.88.0.0/16 The subnet must be large enough to accomadate one IP per node in your cluster The value must be in proper IPV4 CIDR format
+     */
     @JsonProperty("internalTransitSwitchSubnet")
     public void setInternalTransitSwitchSubnet(String internalTransitSwitchSubnet) {
         this.internalTransitSwitchSubnet = internalTransitSwitchSubnet;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IPv6GatewayConfig.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IPv6GatewayConfig.java
index 399d53820ce..a33434f800c 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IPv6GatewayConfig.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IPv6GatewayConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IPV6GatewayConfig holds the configuration paramaters for IPV6 connections in the GatewayConfig for OVN-Kubernetes
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public IPv6GatewayConfig(String internalMasqueradeSubnet) {
         this.internalMasqueradeSubnet = internalMasqueradeSubnet;
     }
 
+    /**
+     * internalMasqueradeSubnet contains the masquerade addresses in IPV6 CIDR format used internally by ovn-kubernetes to enable host to service traffic. Each host in the cluster is configured with these addresses, as well as the shared gateway bridge interface. The values can be changed after installation. The subnet chosen should not overlap with other networks specified for OVN-Kubernetes as well as other networks used on the host. Additionally the subnet must be large enough to accommodate 6 IPs (maximum prefix length /125). When omitted, this means no opinion and the platform is left to choose a reasonable default which is subject to change over time. The current default subnet is fd69::/125 Note that IPV6 dual addresses are not permitted
+     */
     @JsonProperty("internalMasqueradeSubnet")
     public String getInternalMasqueradeSubnet() {
         return internalMasqueradeSubnet;
     }
 
+    /**
+     * internalMasqueradeSubnet contains the masquerade addresses in IPV6 CIDR format used internally by ovn-kubernetes to enable host to service traffic. Each host in the cluster is configured with these addresses, as well as the shared gateway bridge interface. The values can be changed after installation. The subnet chosen should not overlap with other networks specified for OVN-Kubernetes as well as other networks used on the host. Additionally the subnet must be large enough to accommodate 6 IPs (maximum prefix length /125). When omitted, this means no opinion and the platform is left to choose a reasonable default which is subject to change over time. The current default subnet is fd69::/125 Note that IPV6 dual addresses are not permitted
+     */
     @JsonProperty("internalMasqueradeSubnet")
     public void setInternalMasqueradeSubnet(String internalMasqueradeSubnet) {
         this.internalMasqueradeSubnet = internalMasqueradeSubnet;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IPv6OVNKubernetesConfig.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IPv6OVNKubernetesConfig.java
index d77d413a623..7726ffef323 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IPv6OVNKubernetesConfig.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IPv6OVNKubernetesConfig.java
@@ -82,21 +82,33 @@ public IPv6OVNKubernetesConfig(String internalJoinSubnet, String internalTransit
         this.internalTransitSwitchSubnet = internalTransitSwitchSubnet;
     }
 
+    /**
+     * internalJoinSubnet is a v6 subnet used internally by ovn-kubernetes in case the default one is being already used by something else. It must not overlap with any other subnet being used by OpenShift or by the node network. The size of the subnet must be larger than the number of nodes. The value cannot be changed after installation. The subnet must be large enough to accomadate one IP per node in your cluster The current default value is fd98::/48 The value must be in proper IPV6 CIDR format Note that IPV6 dual addresses are not permitted
+     */
     @JsonProperty("internalJoinSubnet")
     public String getInternalJoinSubnet() {
         return internalJoinSubnet;
     }
 
+    /**
+     * internalJoinSubnet is a v6 subnet used internally by ovn-kubernetes in case the default one is being already used by something else. It must not overlap with any other subnet being used by OpenShift or by the node network. The size of the subnet must be larger than the number of nodes. The value cannot be changed after installation. The subnet must be large enough to accomadate one IP per node in your cluster The current default value is fd98::/48 The value must be in proper IPV6 CIDR format Note that IPV6 dual addresses are not permitted
+     */
     @JsonProperty("internalJoinSubnet")
     public void setInternalJoinSubnet(String internalJoinSubnet) {
         this.internalJoinSubnet = internalJoinSubnet;
     }
 
+    /**
+     * internalTransitSwitchSubnet is a v4 subnet in IPV4 CIDR format used internally by OVN-Kubernetes for the distributed transit switch in the OVN Interconnect architecture that connects the cluster routers on each node together to enable east west traffic. The subnet chosen should not overlap with other networks specified for OVN-Kubernetes as well as other networks used on the host. The value cannot be changed after installation. When ommitted, this means no opinion and the platform is left to choose a reasonable default which is subject to change over time. The subnet must be large enough to accomadate one IP per node in your cluster The current default subnet is fd97::/64 The value must be in proper IPV6 CIDR format Note that IPV6 dual addresses are not permitted
+     */
     @JsonProperty("internalTransitSwitchSubnet")
     public String getInternalTransitSwitchSubnet() {
         return internalTransitSwitchSubnet;
     }
 
+    /**
+     * internalTransitSwitchSubnet is a v4 subnet in IPV4 CIDR format used internally by OVN-Kubernetes for the distributed transit switch in the OVN Interconnect architecture that connects the cluster routers on each node together to enable east west traffic. The subnet chosen should not overlap with other networks specified for OVN-Kubernetes as well as other networks used on the host. The value cannot be changed after installation. When ommitted, this means no opinion and the platform is left to choose a reasonable default which is subject to change over time. The subnet must be large enough to accomadate one IP per node in your cluster The current default subnet is fd97::/64 The value must be in proper IPV6 CIDR format Note that IPV6 dual addresses are not permitted
+     */
     @JsonProperty("internalTransitSwitchSubnet")
     public void setInternalTransitSwitchSubnet(String internalTransitSwitchSubnet) {
         this.internalTransitSwitchSubnet = internalTransitSwitchSubnet;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Ingress.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Ingress.java
index 2b3ea2b15ed..c88b65650b9 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Ingress.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Ingress.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Ingress allows cluster admin to configure alternative ingress for the console.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Ingress(String clientDownloadsURL, String consoleURL) {
         this.consoleURL = consoleURL;
     }
 
+    /**
+     * clientDownloadsURL is a URL to be used as the address to download client binaries. If not specified, the downloads route hostname will be used. This field is required for clusters without ingress capability, where access to routes is not possible. The console operator will monitor the URL and may go degraded if it's unreachable for an extended period. Must use the HTTPS scheme.
+     */
     @JsonProperty("clientDownloadsURL")
     public String getClientDownloadsURL() {
         return clientDownloadsURL;
     }
 
+    /**
+     * clientDownloadsURL is a URL to be used as the address to download client binaries. If not specified, the downloads route hostname will be used. This field is required for clusters without ingress capability, where access to routes is not possible. The console operator will monitor the URL and may go degraded if it's unreachable for an extended period. Must use the HTTPS scheme.
+     */
     @JsonProperty("clientDownloadsURL")
     public void setClientDownloadsURL(String clientDownloadsURL) {
         this.clientDownloadsURL = clientDownloadsURL;
     }
 
+    /**
+     * consoleURL is a URL to be used as the base console address. If not specified, the console route hostname will be used. This field is required for clusters without ingress capability, where access to routes is not possible. Make sure that appropriate ingress is set up at this URL. The console operator will monitor the URL and may go degraded if it's unreachable for an extended period. Must use the HTTPS scheme.
+     */
     @JsonProperty("consoleURL")
     public String getConsoleURL() {
         return consoleURL;
     }
 
+    /**
+     * consoleURL is a URL to be used as the base console address. If not specified, the console route hostname will be used. This field is required for clusters without ingress capability, where access to routes is not possible. Make sure that appropriate ingress is set up at this URL. The console operator will monitor the URL and may go degraded if it's unreachable for an extended period. Must use the HTTPS scheme.
+     */
     @JsonProperty("consoleURL")
     public void setConsoleURL(String consoleURL) {
         this.consoleURL = consoleURL;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressController.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressController.java
index 82cb9408117..4ddf44296d4 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressController.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressController.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressController describes a managed ingress controller for the cluster. The controller can service OpenShift Route and Kubernetes Ingress resources.<br><p> <br><p> When an IngressController is created, a new ingress controller deployment is created to allow external traffic to reach the services that expose Ingress or Route resources. Updating this resource may lead to disruption for public facing network connections as a new ingress controller revision may be rolled out.<br><p> <br><p> https://kubernetes.io/docs/concepts/services-networking/ingress-controllers<br><p> <br><p> Whenever possible, sensible defaults for the platform are used. See each field for more details.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class IngressController implements Editable<IngressControllerBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "IngressController";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public IngressController(String apiVersion, String kind, ObjectMeta metadata, In
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * IngressController describes a managed ingress controller for the cluster. The controller can service OpenShift Route and Kubernetes Ingress resources.<br><p> <br><p> When an IngressController is created, a new ingress controller deployment is created to allow external traffic to reach the services that expose Ingress or Route resources. Updating this resource may lead to disruption for public facing network connections as a new ingress controller revision may be rolled out.<br><p> <br><p> https://kubernetes.io/docs/concepts/services-networking/ingress-controllers<br><p> <br><p> Whenever possible, sensible defaults for the platform are used. See each field for more details.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * IngressController describes a managed ingress controller for the cluster. The controller can service OpenShift Route and Kubernetes Ingress resources.<br><p> <br><p> When an IngressController is created, a new ingress controller deployment is created to allow external traffic to reach the services that expose Ingress or Route resources. Updating this resource may lead to disruption for public facing network connections as a new ingress controller revision may be rolled out.<br><p> <br><p> https://kubernetes.io/docs/concepts/services-networking/ingress-controllers<br><p> <br><p> Whenever possible, sensible defaults for the platform are used. See each field for more details.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * IngressController describes a managed ingress controller for the cluster. The controller can service OpenShift Route and Kubernetes Ingress resources.<br><p> <br><p> When an IngressController is created, a new ingress controller deployment is created to allow external traffic to reach the services that expose Ingress or Route resources. Updating this resource may lead to disruption for public facing network connections as a new ingress controller revision may be rolled out.<br><p> <br><p> https://kubernetes.io/docs/concepts/services-networking/ingress-controllers<br><p> <br><p> Whenever possible, sensible defaults for the platform are used. See each field for more details.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public IngressControllerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * IngressController describes a managed ingress controller for the cluster. The controller can service OpenShift Route and Kubernetes Ingress resources.<br><p> <br><p> When an IngressController is created, a new ingress controller deployment is created to allow external traffic to reach the services that expose Ingress or Route resources. Updating this resource may lead to disruption for public facing network connections as a new ingress controller revision may be rolled out.<br><p> <br><p> https://kubernetes.io/docs/concepts/services-networking/ingress-controllers<br><p> <br><p> Whenever possible, sensible defaults for the platform are used. See each field for more details.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(IngressControllerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * IngressController describes a managed ingress controller for the cluster. The controller can service OpenShift Route and Kubernetes Ingress resources.<br><p> <br><p> When an IngressController is created, a new ingress controller deployment is created to allow external traffic to reach the services that expose Ingress or Route resources. Updating this resource may lead to disruption for public facing network connections as a new ingress controller revision may be rolled out.<br><p> <br><p> https://kubernetes.io/docs/concepts/services-networking/ingress-controllers<br><p> <br><p> Whenever possible, sensible defaults for the platform are used. See each field for more details.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public IngressControllerStatus getStatus() {
         return status;
     }
 
+    /**
+     * IngressController describes a managed ingress controller for the cluster. The controller can service OpenShift Route and Kubernetes Ingress resources.<br><p> <br><p> When an IngressController is created, a new ingress controller deployment is created to allow external traffic to reach the services that expose Ingress or Route resources. Updating this resource may lead to disruption for public facing network connections as a new ingress controller revision may be rolled out.<br><p> <br><p> https://kubernetes.io/docs/concepts/services-networking/ingress-controllers<br><p> <br><p> Whenever possible, sensible defaults for the platform are used. See each field for more details.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(IngressControllerStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerCaptureHTTPCookie.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerCaptureHTTPCookie.java
index e539a475639..504286a9c88 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerCaptureHTTPCookie.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerCaptureHTTPCookie.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressControllerCaptureHTTPCookie describes an HTTP cookie that should be captured.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public IngressControllerCaptureHTTPCookie(String matchType, Integer maxLength, S
         this.namePrefix = namePrefix;
     }
 
+    /**
+     * matchType specifies the type of match to be performed on the cookie name.  Allowed values are "Exact" for an exact string match and "Prefix" for a string prefix match.  If "Exact" is specified, a name must be specified in the name field.  If "Prefix" is provided, a prefix must be specified in the namePrefix field.  For example, specifying matchType "Prefix" and namePrefix "foo" will capture a cookie named "foo" or "foobar" but not one named "bar".  The first matching cookie is captured.
+     */
     @JsonProperty("matchType")
     public String getMatchType() {
         return matchType;
     }
 
+    /**
+     * matchType specifies the type of match to be performed on the cookie name.  Allowed values are "Exact" for an exact string match and "Prefix" for a string prefix match.  If "Exact" is specified, a name must be specified in the name field.  If "Prefix" is provided, a prefix must be specified in the namePrefix field.  For example, specifying matchType "Prefix" and namePrefix "foo" will capture a cookie named "foo" or "foobar" but not one named "bar".  The first matching cookie is captured.
+     */
     @JsonProperty("matchType")
     public void setMatchType(String matchType) {
         this.matchType = matchType;
     }
 
+    /**
+     * maxLength specifies a maximum length of the string that will be logged, which includes the cookie name, cookie value, and one-character delimiter.  If the log entry exceeds this length, the value will be truncated in the log message.  Note that the ingress controller may impose a separate bound on the total length of HTTP headers in a request.
+     */
     @JsonProperty("maxLength")
     public Integer getMaxLength() {
         return maxLength;
     }
 
+    /**
+     * maxLength specifies a maximum length of the string that will be logged, which includes the cookie name, cookie value, and one-character delimiter.  If the log entry exceeds this length, the value will be truncated in the log message.  Note that the ingress controller may impose a separate bound on the total length of HTTP headers in a request.
+     */
     @JsonProperty("maxLength")
     public void setMaxLength(Integer maxLength) {
         this.maxLength = maxLength;
     }
 
+    /**
+     * name specifies a cookie name.  Its value must be a valid HTTP cookie name as defined in RFC 6265 section 4.1.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name specifies a cookie name.  Its value must be a valid HTTP cookie name as defined in RFC 6265 section 4.1.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * namePrefix specifies a cookie name prefix.  Its value must be a valid HTTP cookie name as defined in RFC 6265 section 4.1.
+     */
     @JsonProperty("namePrefix")
     public String getNamePrefix() {
         return namePrefix;
     }
 
+    /**
+     * namePrefix specifies a cookie name prefix.  Its value must be a valid HTTP cookie name as defined in RFC 6265 section 4.1.
+     */
     @JsonProperty("namePrefix")
     public void setNamePrefix(String namePrefix) {
         this.namePrefix = namePrefix;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerCaptureHTTPCookieUnion.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerCaptureHTTPCookieUnion.java
index e41ed99d2fb..ef4e931c8f8 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerCaptureHTTPCookieUnion.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerCaptureHTTPCookieUnion.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressControllerCaptureHTTPCookieUnion describes optional fields of an HTTP cookie that should be captured.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public IngressControllerCaptureHTTPCookieUnion(String matchType, String name, St
         this.namePrefix = namePrefix;
     }
 
+    /**
+     * matchType specifies the type of match to be performed on the cookie name.  Allowed values are "Exact" for an exact string match and "Prefix" for a string prefix match.  If "Exact" is specified, a name must be specified in the name field.  If "Prefix" is provided, a prefix must be specified in the namePrefix field.  For example, specifying matchType "Prefix" and namePrefix "foo" will capture a cookie named "foo" or "foobar" but not one named "bar".  The first matching cookie is captured.
+     */
     @JsonProperty("matchType")
     public String getMatchType() {
         return matchType;
     }
 
+    /**
+     * matchType specifies the type of match to be performed on the cookie name.  Allowed values are "Exact" for an exact string match and "Prefix" for a string prefix match.  If "Exact" is specified, a name must be specified in the name field.  If "Prefix" is provided, a prefix must be specified in the namePrefix field.  For example, specifying matchType "Prefix" and namePrefix "foo" will capture a cookie named "foo" or "foobar" but not one named "bar".  The first matching cookie is captured.
+     */
     @JsonProperty("matchType")
     public void setMatchType(String matchType) {
         this.matchType = matchType;
     }
 
+    /**
+     * name specifies a cookie name.  Its value must be a valid HTTP cookie name as defined in RFC 6265 section 4.1.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name specifies a cookie name.  Its value must be a valid HTTP cookie name as defined in RFC 6265 section 4.1.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * namePrefix specifies a cookie name prefix.  Its value must be a valid HTTP cookie name as defined in RFC 6265 section 4.1.
+     */
     @JsonProperty("namePrefix")
     public String getNamePrefix() {
         return namePrefix;
     }
 
+    /**
+     * namePrefix specifies a cookie name prefix.  Its value must be a valid HTTP cookie name as defined in RFC 6265 section 4.1.
+     */
     @JsonProperty("namePrefix")
     public void setNamePrefix(String namePrefix) {
         this.namePrefix = namePrefix;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerCaptureHTTPHeader.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerCaptureHTTPHeader.java
index 5c8dddcc760..42b50f1551f 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerCaptureHTTPHeader.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerCaptureHTTPHeader.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressControllerCaptureHTTPHeader describes an HTTP header that should be captured.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public IngressControllerCaptureHTTPHeader(Integer maxLength, String name) {
         this.name = name;
     }
 
+    /**
+     * maxLength specifies a maximum length for the header value.  If a header value exceeds this length, the value will be truncated in the log message.  Note that the ingress controller may impose a separate bound on the total length of HTTP headers in a request.
+     */
     @JsonProperty("maxLength")
     public Integer getMaxLength() {
         return maxLength;
     }
 
+    /**
+     * maxLength specifies a maximum length for the header value.  If a header value exceeds this length, the value will be truncated in the log message.  Note that the ingress controller may impose a separate bound on the total length of HTTP headers in a request.
+     */
     @JsonProperty("maxLength")
     public void setMaxLength(Integer maxLength) {
         this.maxLength = maxLength;
     }
 
+    /**
+     * name specifies a header name.  Its value must be a valid HTTP header name as defined in RFC 2616 section 4.2.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name specifies a header name.  Its value must be a valid HTTP header name as defined in RFC 2616 section 4.2.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerCaptureHTTPHeaders.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerCaptureHTTPHeaders.java
index 41af513e12b..366c9c92dff 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerCaptureHTTPHeaders.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerCaptureHTTPHeaders.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressControllerCaptureHTTPHeaders specifies which HTTP headers the IngressController captures.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public IngressControllerCaptureHTTPHeaders(List<IngressControllerCaptureHTTPHead
         this.response = response;
     }
 
+    /**
+     * request specifies which HTTP request headers to capture.<br><p> <br><p> If this field is empty, no request headers are captured.
+     */
     @JsonProperty("request")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IngressControllerCaptureHTTPHeader> getRequest() {
         return request;
     }
 
+    /**
+     * request specifies which HTTP request headers to capture.<br><p> <br><p> If this field is empty, no request headers are captured.
+     */
     @JsonProperty("request")
     public void setRequest(List<IngressControllerCaptureHTTPHeader> request) {
         this.request = request;
     }
 
+    /**
+     * response specifies which HTTP response headers to capture.<br><p> <br><p> If this field is empty, no response headers are captured.
+     */
     @JsonProperty("response")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IngressControllerCaptureHTTPHeader> getResponse() {
         return response;
     }
 
+    /**
+     * response specifies which HTTP response headers to capture.<br><p> <br><p> If this field is empty, no response headers are captured.
+     */
     @JsonProperty("response")
     public void setResponse(List<IngressControllerCaptureHTTPHeader> response) {
         this.response = response;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerHTTPHeader.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerHTTPHeader.java
index ef28d508079..7e658c5eb49 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerHTTPHeader.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerHTTPHeader.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressControllerHTTPHeader specifies configuration for setting or deleting an HTTP header.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public IngressControllerHTTPHeader(IngressControllerHTTPHeaderActionUnion action
         this.name = name;
     }
 
+    /**
+     * IngressControllerHTTPHeader specifies configuration for setting or deleting an HTTP header.
+     */
     @JsonProperty("action")
     public IngressControllerHTTPHeaderActionUnion getAction() {
         return action;
     }
 
+    /**
+     * IngressControllerHTTPHeader specifies configuration for setting or deleting an HTTP header.
+     */
     @JsonProperty("action")
     public void setAction(IngressControllerHTTPHeaderActionUnion action) {
         this.action = action;
     }
 
+    /**
+     * name specifies the name of a header on which to perform an action. Its value must be a valid HTTP header name as defined in RFC 2616 section 4.2. The name must consist only of alphanumeric and the following special characters, "-!#$%&amp;'&#42;+.^_`". The following header names are reserved and may not be modified via this API: Strict-Transport-Security, Proxy, Host, Cookie, Set-Cookie. It must be no more than 255 characters in length. Header name must be unique.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name specifies the name of a header on which to perform an action. Its value must be a valid HTTP header name as defined in RFC 2616 section 4.2. The name must consist only of alphanumeric and the following special characters, "-!#$%&amp;'&#42;+.^_`". The following header names are reserved and may not be modified via this API: Strict-Transport-Security, Proxy, Host, Cookie, Set-Cookie. It must be no more than 255 characters in length. Header name must be unique.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerHTTPHeaderActionUnion.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerHTTPHeaderActionUnion.java
index 838ffa1c041..927db543597 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerHTTPHeaderActionUnion.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerHTTPHeaderActionUnion.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressControllerHTTPHeaderActionUnion specifies an action to take on an HTTP header.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public IngressControllerHTTPHeaderActionUnion(IngressControllerSetHTTPHeader set
         this.type = type;
     }
 
+    /**
+     * IngressControllerHTTPHeaderActionUnion specifies an action to take on an HTTP header.
+     */
     @JsonProperty("set")
     public IngressControllerSetHTTPHeader getSet() {
         return set;
     }
 
+    /**
+     * IngressControllerHTTPHeaderActionUnion specifies an action to take on an HTTP header.
+     */
     @JsonProperty("set")
     public void setSet(IngressControllerSetHTTPHeader set) {
         this.set = set;
     }
 
+    /**
+     * type defines the type of the action to be applied on the header. Possible values are Set or Delete. Set allows you to set HTTP request and response headers. Delete allows you to delete HTTP request and response headers.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type defines the type of the action to be applied on the header. Possible values are Set or Delete. Set allows you to set HTTP request and response headers. Delete allows you to delete HTTP request and response headers.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerHTTPHeaderActions.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerHTTPHeaderActions.java
index 8d1da96d59a..482421ab5cf 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerHTTPHeaderActions.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerHTTPHeaderActions.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressControllerHTTPHeaderActions defines configuration for actions on HTTP request and response headers.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public IngressControllerHTTPHeaderActions(List<IngressControllerHTTPHeader> requ
         this.response = response;
     }
 
+    /**
+     * request is a list of HTTP request headers to modify. Actions defined here will modify the request headers of all requests passing through an ingress controller. These actions are applied to all Routes i.e. for all connections handled by the ingress controller defined within a cluster. IngressController actions for request headers will be executed before Route actions. Currently, actions may define to either `Set` or `Delete` headers values. Actions are applied in sequence as defined in this list. A maximum of 20 request header actions may be configured. Sample fetchers allowed are "req.hdr" and "ssl_c_der". Converters allowed are "lower" and "base64". Example header values: "%[req.hdr(X-target),lower]", "%{+Q}[ssl_c_der,base64]".
+     */
     @JsonProperty("request")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IngressControllerHTTPHeader> getRequest() {
         return request;
     }
 
+    /**
+     * request is a list of HTTP request headers to modify. Actions defined here will modify the request headers of all requests passing through an ingress controller. These actions are applied to all Routes i.e. for all connections handled by the ingress controller defined within a cluster. IngressController actions for request headers will be executed before Route actions. Currently, actions may define to either `Set` or `Delete` headers values. Actions are applied in sequence as defined in this list. A maximum of 20 request header actions may be configured. Sample fetchers allowed are "req.hdr" and "ssl_c_der". Converters allowed are "lower" and "base64". Example header values: "%[req.hdr(X-target),lower]", "%{+Q}[ssl_c_der,base64]".
+     */
     @JsonProperty("request")
     public void setRequest(List<IngressControllerHTTPHeader> request) {
         this.request = request;
     }
 
+    /**
+     * response is a list of HTTP response headers to modify. Actions defined here will modify the response headers of all requests passing through an ingress controller. These actions are applied to all Routes i.e. for all connections handled by the ingress controller defined within a cluster. IngressController actions for response headers will be executed after Route actions. Currently, actions may define to either `Set` or `Delete` headers values. Actions are applied in sequence as defined in this list. A maximum of 20 response header actions may be configured. Sample fetchers allowed are "res.hdr" and "ssl_c_der". Converters allowed are "lower" and "base64". Example header values: "%[res.hdr(X-target),lower]", "%{+Q}[ssl_c_der,base64]".
+     */
     @JsonProperty("response")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IngressControllerHTTPHeader> getResponse() {
         return response;
     }
 
+    /**
+     * response is a list of HTTP response headers to modify. Actions defined here will modify the response headers of all requests passing through an ingress controller. These actions are applied to all Routes i.e. for all connections handled by the ingress controller defined within a cluster. IngressController actions for response headers will be executed after Route actions. Currently, actions may define to either `Set` or `Delete` headers values. Actions are applied in sequence as defined in this list. A maximum of 20 response header actions may be configured. Sample fetchers allowed are "res.hdr" and "ssl_c_der". Converters allowed are "lower" and "base64". Example header values: "%[res.hdr(X-target),lower]", "%{+Q}[ssl_c_der,base64]".
+     */
     @JsonProperty("response")
     public void setResponse(List<IngressControllerHTTPHeader> response) {
         this.response = response;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerHTTPHeaders.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerHTTPHeaders.java
index 50c6298b674..5718ce6b6c6 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerHTTPHeaders.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerHTTPHeaders.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressControllerHTTPHeaders specifies how the IngressController handles certain HTTP headers.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public IngressControllerHTTPHeaders(IngressControllerHTTPHeaderActions actions,
         this.uniqueId = uniqueId;
     }
 
+    /**
+     * IngressControllerHTTPHeaders specifies how the IngressController handles certain HTTP headers.
+     */
     @JsonProperty("actions")
     public IngressControllerHTTPHeaderActions getActions() {
         return actions;
     }
 
+    /**
+     * IngressControllerHTTPHeaders specifies how the IngressController handles certain HTTP headers.
+     */
     @JsonProperty("actions")
     public void setActions(IngressControllerHTTPHeaderActions actions) {
         this.actions = actions;
     }
 
+    /**
+     * forwardedHeaderPolicy specifies when and how the IngressController sets the Forwarded, X-Forwarded-For, X-Forwarded-Host, X-Forwarded-Port, X-Forwarded-Proto, and X-Forwarded-Proto-Version HTTP headers.  The value may be one of the following:<br><p> <br><p> &#42; "Append", which specifies that the IngressController appends the<br><p>   headers, preserving existing headers.<br><p> <br><p> &#42; "Replace", which specifies that the IngressController sets the<br><p>   headers, replacing any existing Forwarded or X-Forwarded-&#42; headers.<br><p> <br><p> &#42; "IfNone", which specifies that the IngressController sets the<br><p>   headers if they are not already set.<br><p> <br><p> &#42; "Never", which specifies that the IngressController never sets the<br><p>   headers, preserving any existing headers.<br><p> <br><p> By default, the policy is "Append".
+     */
     @JsonProperty("forwardedHeaderPolicy")
     public String getForwardedHeaderPolicy() {
         return forwardedHeaderPolicy;
     }
 
+    /**
+     * forwardedHeaderPolicy specifies when and how the IngressController sets the Forwarded, X-Forwarded-For, X-Forwarded-Host, X-Forwarded-Port, X-Forwarded-Proto, and X-Forwarded-Proto-Version HTTP headers.  The value may be one of the following:<br><p> <br><p> &#42; "Append", which specifies that the IngressController appends the<br><p>   headers, preserving existing headers.<br><p> <br><p> &#42; "Replace", which specifies that the IngressController sets the<br><p>   headers, replacing any existing Forwarded or X-Forwarded-&#42; headers.<br><p> <br><p> &#42; "IfNone", which specifies that the IngressController sets the<br><p>   headers if they are not already set.<br><p> <br><p> &#42; "Never", which specifies that the IngressController never sets the<br><p>   headers, preserving any existing headers.<br><p> <br><p> By default, the policy is "Append".
+     */
     @JsonProperty("forwardedHeaderPolicy")
     public void setForwardedHeaderPolicy(String forwardedHeaderPolicy) {
         this.forwardedHeaderPolicy = forwardedHeaderPolicy;
     }
 
+    /**
+     * headerNameCaseAdjustments specifies case adjustments that can be applied to HTTP header names.  Each adjustment is specified as an HTTP header name with the desired capitalization.  For example, specifying "X-Forwarded-For" indicates that the "x-forwarded-for" HTTP header should be adjusted to have the specified capitalization.<br><p> <br><p> These adjustments are only applied to cleartext, edge-terminated, and re-encrypt routes, and only when using HTTP/1.<br><p> <br><p> For request headers, these adjustments are applied only for routes that have the haproxy.router.openshift.io/h1-adjust-case=true annotation.  For response headers, these adjustments are applied to all HTTP responses.<br><p> <br><p> If this field is empty, no request headers are adjusted.
+     */
     @JsonProperty("headerNameCaseAdjustments")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getHeaderNameCaseAdjustments() {
         return headerNameCaseAdjustments;
     }
 
+    /**
+     * headerNameCaseAdjustments specifies case adjustments that can be applied to HTTP header names.  Each adjustment is specified as an HTTP header name with the desired capitalization.  For example, specifying "X-Forwarded-For" indicates that the "x-forwarded-for" HTTP header should be adjusted to have the specified capitalization.<br><p> <br><p> These adjustments are only applied to cleartext, edge-terminated, and re-encrypt routes, and only when using HTTP/1.<br><p> <br><p> For request headers, these adjustments are applied only for routes that have the haproxy.router.openshift.io/h1-adjust-case=true annotation.  For response headers, these adjustments are applied to all HTTP responses.<br><p> <br><p> If this field is empty, no request headers are adjusted.
+     */
     @JsonProperty("headerNameCaseAdjustments")
     public void setHeaderNameCaseAdjustments(List<String> headerNameCaseAdjustments) {
         this.headerNameCaseAdjustments = headerNameCaseAdjustments;
     }
 
+    /**
+     * IngressControllerHTTPHeaders specifies how the IngressController handles certain HTTP headers.
+     */
     @JsonProperty("uniqueId")
     public IngressControllerHTTPUniqueIdHeaderPolicy getUniqueId() {
         return uniqueId;
     }
 
+    /**
+     * IngressControllerHTTPHeaders specifies how the IngressController handles certain HTTP headers.
+     */
     @JsonProperty("uniqueId")
     public void setUniqueId(IngressControllerHTTPUniqueIdHeaderPolicy uniqueId) {
         this.uniqueId = uniqueId;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerHTTPUniqueIdHeaderPolicy.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerHTTPUniqueIdHeaderPolicy.java
index 3f9db858e13..0607f7985b2 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerHTTPUniqueIdHeaderPolicy.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerHTTPUniqueIdHeaderPolicy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressControllerHTTPUniqueIdHeaderPolicy describes configuration for a unique id header.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public IngressControllerHTTPUniqueIdHeaderPolicy(String format, String name) {
         this.name = name;
     }
 
+    /**
+     * format specifies the format for the injected HTTP header's value. This field has no effect unless name is specified.  For the HAProxy-based ingress controller implementation, this format uses the same syntax as the HTTP log format.  If the field is empty, the default value is "%{+X}o\\ %ci:%cp_%fi:%fp_%Ts_%rt:%pid"; see the corresponding HAProxy documentation: http://cbonte.github.io/haproxy-dconv/2.0/configuration.html#8.2.3
+     */
     @JsonProperty("format")
     public String getFormat() {
         return format;
     }
 
+    /**
+     * format specifies the format for the injected HTTP header's value. This field has no effect unless name is specified.  For the HAProxy-based ingress controller implementation, this format uses the same syntax as the HTTP log format.  If the field is empty, the default value is "%{+X}o\\ %ci:%cp_%fi:%fp_%Ts_%rt:%pid"; see the corresponding HAProxy documentation: http://cbonte.github.io/haproxy-dconv/2.0/configuration.html#8.2.3
+     */
     @JsonProperty("format")
     public void setFormat(String format) {
         this.format = format;
     }
 
+    /**
+     * name specifies the name of the HTTP header (for example, "unique-id") that the ingress controller should inject into HTTP requests.  The field's value must be a valid HTTP header name as defined in RFC 2616 section 4.2.  If the field is empty, no header is injected.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name specifies the name of the HTTP header (for example, "unique-id") that the ingress controller should inject into HTTP requests.  The field's value must be a valid HTTP header name as defined in RFC 2616 section 4.2.  If the field is empty, no header is injected.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerList.java
index 8252066f65b..e1bdcbcad3c 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressControllerList contains a list of IngressControllers.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class IngressControllerList implements Editable<IngressControllerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.v1.IngressController>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.v1.IngressController> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "IngressControllerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public IngressControllerList(String apiVersion, List<io.fabric8.openshift.api.mo
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * IngressControllerList contains a list of IngressControllers.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.v1.IngressController> getItems() {
         return items;
     }
 
+    /**
+     * IngressControllerList contains a list of IngressControllers.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.v1.IngressController> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * IngressControllerList contains a list of IngressControllers.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * IngressControllerList contains a list of IngressControllers.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerLogging.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerLogging.java
index 6656cb00487..a7f8acd9ab6 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerLogging.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerLogging.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressControllerLogging describes what should be logged where.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public IngressControllerLogging(AccessLogging access) {
         this.access = access;
     }
 
+    /**
+     * IngressControllerLogging describes what should be logged where.
+     */
     @JsonProperty("access")
     public AccessLogging getAccess() {
         return access;
     }
 
+    /**
+     * IngressControllerLogging describes what should be logged where.
+     */
     @JsonProperty("access")
     public void setAccess(AccessLogging access) {
         this.access = access;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerSetHTTPHeader.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerSetHTTPHeader.java
index 116b8547825..55f718b1667 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerSetHTTPHeader.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerSetHTTPHeader.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressControllerSetHTTPHeader defines the value which needs to be set on an HTTP header.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public IngressControllerSetHTTPHeader(String value) {
         this.value = value;
     }
 
+    /**
+     * value specifies a header value. Dynamic values can be added. The value will be interpreted as an HAProxy format string as defined in http://cbonte.github.io/haproxy-dconv/2.6/configuration.html#8.2.6  and may use HAProxy's %[] syntax and otherwise must be a valid HTTP header value as defined in https://datatracker.ietf.org/doc/html/rfc7230#section-3.2. The value of this field must be no more than 16384 characters in length. Note that the total size of all net added headers &#42;after&#42; interpolating dynamic values must not exceed the value of spec.tuningOptions.headerBufferMaxRewriteBytes on the IngressController.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * value specifies a header value. Dynamic values can be added. The value will be interpreted as an HAProxy format string as defined in http://cbonte.github.io/haproxy-dconv/2.6/configuration.html#8.2.6  and may use HAProxy's %[] syntax and otherwise must be a valid HTTP header value as defined in https://datatracker.ietf.org/doc/html/rfc7230#section-3.2. The value of this field must be no more than 16384 characters in length. Note that the total size of all net added headers &#42;after&#42; interpolating dynamic values must not exceed the value of spec.tuningOptions.headerBufferMaxRewriteBytes on the IngressController.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerSpec.java
index 811785186b5..745c6d94045 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -145,171 +148,273 @@ public IngressControllerSpec(ClientTLS clientTLS, LocalObjectReference defaultCe
         this.unsupportedConfigOverrides = unsupportedConfigOverrides;
     }
 
+    /**
+     * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+     */
     @JsonProperty("clientTLS")
     public ClientTLS getClientTLS() {
         return clientTLS;
     }
 
+    /**
+     * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+     */
     @JsonProperty("clientTLS")
     public void setClientTLS(ClientTLS clientTLS) {
         this.clientTLS = clientTLS;
     }
 
+    /**
+     * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+     */
     @JsonProperty("defaultCertificate")
     public LocalObjectReference getDefaultCertificate() {
         return defaultCertificate;
     }
 
+    /**
+     * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+     */
     @JsonProperty("defaultCertificate")
     public void setDefaultCertificate(LocalObjectReference defaultCertificate) {
         this.defaultCertificate = defaultCertificate;
     }
 
+    /**
+     * domain is a DNS name serviced by the ingress controller and is used to configure multiple features:<br><p> <br><p> &#42; For the LoadBalancerService endpoint publishing strategy, domain is<br><p>   used to configure DNS records. See endpointPublishingStrategy.<br><p> <br><p> &#42; When using a generated default certificate, the certificate will be valid<br><p>   for domain and its subdomains. See defaultCertificate.<br><p> <br><p> &#42; The value is published to individual Route statuses so that end-users<br><p>   know where to target external DNS records.<br><p> <br><p> domain must be unique among all IngressControllers, and cannot be updated.<br><p> <br><p> If empty, defaults to ingress.config.openshift.io/cluster .spec.domain.
+     */
     @JsonProperty("domain")
     public String getDomain() {
         return domain;
     }
 
+    /**
+     * domain is a DNS name serviced by the ingress controller and is used to configure multiple features:<br><p> <br><p> &#42; For the LoadBalancerService endpoint publishing strategy, domain is<br><p>   used to configure DNS records. See endpointPublishingStrategy.<br><p> <br><p> &#42; When using a generated default certificate, the certificate will be valid<br><p>   for domain and its subdomains. See defaultCertificate.<br><p> <br><p> &#42; The value is published to individual Route statuses so that end-users<br><p>   know where to target external DNS records.<br><p> <br><p> domain must be unique among all IngressControllers, and cannot be updated.<br><p> <br><p> If empty, defaults to ingress.config.openshift.io/cluster .spec.domain.
+     */
     @JsonProperty("domain")
     public void setDomain(String domain) {
         this.domain = domain;
     }
 
+    /**
+     * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+     */
     @JsonProperty("endpointPublishingStrategy")
     public EndpointPublishingStrategy getEndpointPublishingStrategy() {
         return endpointPublishingStrategy;
     }
 
+    /**
+     * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+     */
     @JsonProperty("endpointPublishingStrategy")
     public void setEndpointPublishingStrategy(EndpointPublishingStrategy endpointPublishingStrategy) {
         this.endpointPublishingStrategy = endpointPublishingStrategy;
     }
 
+    /**
+     * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+     */
     @JsonProperty("httpCompression")
     public HTTPCompressionPolicy getHttpCompression() {
         return httpCompression;
     }
 
+    /**
+     * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+     */
     @JsonProperty("httpCompression")
     public void setHttpCompression(HTTPCompressionPolicy httpCompression) {
         this.httpCompression = httpCompression;
     }
 
+    /**
+     * httpEmptyRequestsPolicy describes how HTTP connections should be handled if the connection times out before a request is received. Allowed values for this field are "Respond" and "Ignore".  If the field is set to "Respond", the ingress controller sends an HTTP 400 or 408 response, logs the connection (if access logging is enabled), and counts the connection in the appropriate metrics.  If the field is set to "Ignore", the ingress controller closes the connection without sending a response, logging the connection, or incrementing metrics.  The default value is "Respond".<br><p> <br><p> Typically, these connections come from load balancers' health probes or Web browsers' speculative connections ("preconnect") and can be safely ignored.  However, these requests may also be caused by network errors, and so setting this field to "Ignore" may impede detection and diagnosis of problems.  In addition, these requests may be caused by port scans, in which case logging empty requests may aid in detecting intrusion attempts.
+     */
     @JsonProperty("httpEmptyRequestsPolicy")
     public String getHttpEmptyRequestsPolicy() {
         return httpEmptyRequestsPolicy;
     }
 
+    /**
+     * httpEmptyRequestsPolicy describes how HTTP connections should be handled if the connection times out before a request is received. Allowed values for this field are "Respond" and "Ignore".  If the field is set to "Respond", the ingress controller sends an HTTP 400 or 408 response, logs the connection (if access logging is enabled), and counts the connection in the appropriate metrics.  If the field is set to "Ignore", the ingress controller closes the connection without sending a response, logging the connection, or incrementing metrics.  The default value is "Respond".<br><p> <br><p> Typically, these connections come from load balancers' health probes or Web browsers' speculative connections ("preconnect") and can be safely ignored.  However, these requests may also be caused by network errors, and so setting this field to "Ignore" may impede detection and diagnosis of problems.  In addition, these requests may be caused by port scans, in which case logging empty requests may aid in detecting intrusion attempts.
+     */
     @JsonProperty("httpEmptyRequestsPolicy")
     public void setHttpEmptyRequestsPolicy(String httpEmptyRequestsPolicy) {
         this.httpEmptyRequestsPolicy = httpEmptyRequestsPolicy;
     }
 
+    /**
+     * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+     */
     @JsonProperty("httpErrorCodePages")
     public ConfigMapNameReference getHttpErrorCodePages() {
         return httpErrorCodePages;
     }
 
+    /**
+     * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+     */
     @JsonProperty("httpErrorCodePages")
     public void setHttpErrorCodePages(ConfigMapNameReference httpErrorCodePages) {
         this.httpErrorCodePages = httpErrorCodePages;
     }
 
+    /**
+     * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+     */
     @JsonProperty("httpHeaders")
     public IngressControllerHTTPHeaders getHttpHeaders() {
         return httpHeaders;
     }
 
+    /**
+     * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+     */
     @JsonProperty("httpHeaders")
     public void setHttpHeaders(IngressControllerHTTPHeaders httpHeaders) {
         this.httpHeaders = httpHeaders;
     }
 
+    /**
+     * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+     */
     @JsonProperty("logging")
     public IngressControllerLogging getLogging() {
         return logging;
     }
 
+    /**
+     * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+     */
     @JsonProperty("logging")
     public void setLogging(IngressControllerLogging logging) {
         this.logging = logging;
     }
 
+    /**
+     * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+     */
     @JsonProperty("namespaceSelector")
     public LabelSelector getNamespaceSelector() {
         return namespaceSelector;
     }
 
+    /**
+     * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+     */
     @JsonProperty("namespaceSelector")
     public void setNamespaceSelector(LabelSelector namespaceSelector) {
         this.namespaceSelector = namespaceSelector;
     }
 
+    /**
+     * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+     */
     @JsonProperty("nodePlacement")
     public NodePlacement getNodePlacement() {
         return nodePlacement;
     }
 
+    /**
+     * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+     */
     @JsonProperty("nodePlacement")
     public void setNodePlacement(NodePlacement nodePlacement) {
         this.nodePlacement = nodePlacement;
     }
 
+    /**
+     * replicas is the desired number of ingress controller replicas. If unset, the default depends on the value of the defaultPlacement field in the cluster config.openshift.io/v1/ingresses status.<br><p> <br><p> The value of replicas is set based on the value of a chosen field in the Infrastructure CR. If defaultPlacement is set to ControlPlane, the chosen field will be controlPlaneTopology. If it is set to Workers the chosen field will be infrastructureTopology. Replicas will then be set to 1 or 2 based whether the chosen field's value is SingleReplica or HighlyAvailable, respectively.<br><p> <br><p> These defaults are subject to change.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * replicas is the desired number of ingress controller replicas. If unset, the default depends on the value of the defaultPlacement field in the cluster config.openshift.io/v1/ingresses status.<br><p> <br><p> The value of replicas is set based on the value of a chosen field in the Infrastructure CR. If defaultPlacement is set to ControlPlane, the chosen field will be controlPlaneTopology. If it is set to Workers the chosen field will be infrastructureTopology. Replicas will then be set to 1 or 2 based whether the chosen field's value is SingleReplica or HighlyAvailable, respectively.<br><p> <br><p> These defaults are subject to change.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+     */
     @JsonProperty("routeAdmission")
     public RouteAdmissionPolicy getRouteAdmission() {
         return routeAdmission;
     }
 
+    /**
+     * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+     */
     @JsonProperty("routeAdmission")
     public void setRouteAdmission(RouteAdmissionPolicy routeAdmission) {
         this.routeAdmission = routeAdmission;
     }
 
+    /**
+     * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+     */
     @JsonProperty("routeSelector")
     public LabelSelector getRouteSelector() {
         return routeSelector;
     }
 
+    /**
+     * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+     */
     @JsonProperty("routeSelector")
     public void setRouteSelector(LabelSelector routeSelector) {
         this.routeSelector = routeSelector;
     }
 
+    /**
+     * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+     */
     @JsonProperty("tlsSecurityProfile")
     public TLSSecurityProfile getTlsSecurityProfile() {
         return tlsSecurityProfile;
     }
 
+    /**
+     * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+     */
     @JsonProperty("tlsSecurityProfile")
     public void setTlsSecurityProfile(TLSSecurityProfile tlsSecurityProfile) {
         this.tlsSecurityProfile = tlsSecurityProfile;
     }
 
+    /**
+     * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+     */
     @JsonProperty("tuningOptions")
     public IngressControllerTuningOptions getTuningOptions() {
         return tuningOptions;
     }
 
+    /**
+     * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+     */
     @JsonProperty("tuningOptions")
     public void setTuningOptions(IngressControllerTuningOptions tuningOptions) {
         this.tuningOptions = tuningOptions;
     }
 
+    /**
+     * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+     */
     @JsonProperty("unsupportedConfigOverrides")
     public Object getUnsupportedConfigOverrides() {
         return unsupportedConfigOverrides;
     }
 
+    /**
+     * IngressControllerSpec is the specification of the desired behavior of the IngressController.
+     */
     @JsonProperty("unsupportedConfigOverrides")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setUnsupportedConfigOverrides(Object unsupportedConfigOverrides) {
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerStatus.java
index da3261aca95..43468201de2 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressControllerStatus defines the observed status of the IngressController.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -114,92 +117,146 @@ public IngressControllerStatus(Integer availableReplicas, List<OperatorCondition
         this.tlsProfile = tlsProfile;
     }
 
+    /**
+     * availableReplicas is number of observed available replicas according to the ingress controller deployment.
+     */
     @JsonProperty("availableReplicas")
     public Integer getAvailableReplicas() {
         return availableReplicas;
     }
 
+    /**
+     * availableReplicas is number of observed available replicas according to the ingress controller deployment.
+     */
     @JsonProperty("availableReplicas")
     public void setAvailableReplicas(Integer availableReplicas) {
         this.availableReplicas = availableReplicas;
     }
 
+    /**
+     * conditions is a list of conditions and their status.<br><p> <br><p> Available means the ingress controller deployment is available and servicing route and ingress resources (i.e, .status.availableReplicas equals .spec.replicas)<br><p> <br><p> There are additional conditions which indicate the status of other ingress controller features and capabilities.<br><p> <br><p>   &#42; LoadBalancerManaged<br><p>   - True if the following conditions are met:<br><p>     &#42; The endpoint publishing strategy requires a service load balancer.<br><p>   - False if any of those conditions are unsatisfied.<br><p> <br><p>   &#42; LoadBalancerReady<br><p>   - True if the following conditions are met:<br><p>     &#42; A load balancer is managed.<br><p>     &#42; The load balancer is ready.<br><p>   - False if any of those conditions are unsatisfied.<br><p> <br><p>   &#42; DNSManaged<br><p>   - True if the following conditions are met:<br><p>     &#42; The endpoint publishing strategy and platform support DNS.<br><p>     &#42; The ingress controller domain is set.<br><p>     &#42; dns.config.openshift.io/cluster configures DNS zones.<br><p>   - False if any of those conditions are unsatisfied.<br><p> <br><p>   &#42; DNSReady<br><p>   - True if the following conditions are met:<br><p>     &#42; DNS is managed.<br><p>     &#42; DNS records have been successfully created.<br><p>   - False if any of those conditions are unsatisfied.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status.<br><p> <br><p> Available means the ingress controller deployment is available and servicing route and ingress resources (i.e, .status.availableReplicas equals .spec.replicas)<br><p> <br><p> There are additional conditions which indicate the status of other ingress controller features and capabilities.<br><p> <br><p>   &#42; LoadBalancerManaged<br><p>   - True if the following conditions are met:<br><p>     &#42; The endpoint publishing strategy requires a service load balancer.<br><p>   - False if any of those conditions are unsatisfied.<br><p> <br><p>   &#42; LoadBalancerReady<br><p>   - True if the following conditions are met:<br><p>     &#42; A load balancer is managed.<br><p>     &#42; The load balancer is ready.<br><p>   - False if any of those conditions are unsatisfied.<br><p> <br><p>   &#42; DNSManaged<br><p>   - True if the following conditions are met:<br><p>     &#42; The endpoint publishing strategy and platform support DNS.<br><p>     &#42; The ingress controller domain is set.<br><p>     &#42; dns.config.openshift.io/cluster configures DNS zones.<br><p>   - False if any of those conditions are unsatisfied.<br><p> <br><p>   &#42; DNSReady<br><p>   - True if the following conditions are met:<br><p>     &#42; DNS is managed.<br><p>     &#42; DNS records have been successfully created.<br><p>   - False if any of those conditions are unsatisfied.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * domain is the actual domain in use.
+     */
     @JsonProperty("domain")
     public String getDomain() {
         return domain;
     }
 
+    /**
+     * domain is the actual domain in use.
+     */
     @JsonProperty("domain")
     public void setDomain(String domain) {
         this.domain = domain;
     }
 
+    /**
+     * IngressControllerStatus defines the observed status of the IngressController.
+     */
     @JsonProperty("endpointPublishingStrategy")
     public EndpointPublishingStrategy getEndpointPublishingStrategy() {
         return endpointPublishingStrategy;
     }
 
+    /**
+     * IngressControllerStatus defines the observed status of the IngressController.
+     */
     @JsonProperty("endpointPublishingStrategy")
     public void setEndpointPublishingStrategy(EndpointPublishingStrategy endpointPublishingStrategy) {
         this.endpointPublishingStrategy = endpointPublishingStrategy;
     }
 
+    /**
+     * IngressControllerStatus defines the observed status of the IngressController.
+     */
     @JsonProperty("namespaceSelector")
     public LabelSelector getNamespaceSelector() {
         return namespaceSelector;
     }
 
+    /**
+     * IngressControllerStatus defines the observed status of the IngressController.
+     */
     @JsonProperty("namespaceSelector")
     public void setNamespaceSelector(LabelSelector namespaceSelector) {
         this.namespaceSelector = namespaceSelector;
     }
 
+    /**
+     * observedGeneration is the most recent generation observed.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the most recent generation observed.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * IngressControllerStatus defines the observed status of the IngressController.
+     */
     @JsonProperty("routeSelector")
     public LabelSelector getRouteSelector() {
         return routeSelector;
     }
 
+    /**
+     * IngressControllerStatus defines the observed status of the IngressController.
+     */
     @JsonProperty("routeSelector")
     public void setRouteSelector(LabelSelector routeSelector) {
         this.routeSelector = routeSelector;
     }
 
+    /**
+     * selector is a label selector, in string format, for ingress controller pods corresponding to the IngressController. The number of matching pods should equal the value of availableReplicas.
+     */
     @JsonProperty("selector")
     public String getSelector() {
         return selector;
     }
 
+    /**
+     * selector is a label selector, in string format, for ingress controller pods corresponding to the IngressController. The number of matching pods should equal the value of availableReplicas.
+     */
     @JsonProperty("selector")
     public void setSelector(String selector) {
         this.selector = selector;
     }
 
+    /**
+     * IngressControllerStatus defines the observed status of the IngressController.
+     */
     @JsonProperty("tlsProfile")
     public TLSProfileSpec getTlsProfile() {
         return tlsProfile;
     }
 
+    /**
+     * IngressControllerStatus defines the observed status of the IngressController.
+     */
     @JsonProperty("tlsProfile")
     public void setTlsProfile(TLSProfileSpec tlsProfile) {
         this.tlsProfile = tlsProfile;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerTuningOptions.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerTuningOptions.java
index 6cc9ef081df..7ebe5fd926e 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerTuningOptions.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/IngressControllerTuningOptions.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IngressControllerTuningOptions specifies options for tuning the performance of ingress controller pods
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -126,131 +129,209 @@ public IngressControllerTuningOptions(String clientFinTimeout, String clientTime
         this.tunnelTimeout = tunnelTimeout;
     }
 
+    /**
+     * IngressControllerTuningOptions specifies options for tuning the performance of ingress controller pods
+     */
     @JsonProperty("clientFinTimeout")
     public String getClientFinTimeout() {
         return clientFinTimeout;
     }
 
+    /**
+     * IngressControllerTuningOptions specifies options for tuning the performance of ingress controller pods
+     */
     @JsonProperty("clientFinTimeout")
     public void setClientFinTimeout(String clientFinTimeout) {
         this.clientFinTimeout = clientFinTimeout;
     }
 
+    /**
+     * IngressControllerTuningOptions specifies options for tuning the performance of ingress controller pods
+     */
     @JsonProperty("clientTimeout")
     public String getClientTimeout() {
         return clientTimeout;
     }
 
+    /**
+     * IngressControllerTuningOptions specifies options for tuning the performance of ingress controller pods
+     */
     @JsonProperty("clientTimeout")
     public void setClientTimeout(String clientTimeout) {
         this.clientTimeout = clientTimeout;
     }
 
+    /**
+     * IngressControllerTuningOptions specifies options for tuning the performance of ingress controller pods
+     */
     @JsonProperty("connectTimeout")
     public String getConnectTimeout() {
         return connectTimeout;
     }
 
+    /**
+     * IngressControllerTuningOptions specifies options for tuning the performance of ingress controller pods
+     */
     @JsonProperty("connectTimeout")
     public void setConnectTimeout(String connectTimeout) {
         this.connectTimeout = connectTimeout;
     }
 
+    /**
+     * headerBufferBytes describes how much memory should be reserved (in bytes) for IngressController connection sessions. Note that this value must be at least 16384 if HTTP/2 is enabled for the IngressController (https://tools.ietf.org/html/rfc7540). If this field is empty, the IngressController will use a default value of 32768 bytes.<br><p> <br><p> Setting this field is generally not recommended as headerBufferBytes values that are too small may break the IngressController and headerBufferBytes values that are too large could cause the IngressController to use significantly more memory than necessary.
+     */
     @JsonProperty("headerBufferBytes")
     public Integer getHeaderBufferBytes() {
         return headerBufferBytes;
     }
 
+    /**
+     * headerBufferBytes describes how much memory should be reserved (in bytes) for IngressController connection sessions. Note that this value must be at least 16384 if HTTP/2 is enabled for the IngressController (https://tools.ietf.org/html/rfc7540). If this field is empty, the IngressController will use a default value of 32768 bytes.<br><p> <br><p> Setting this field is generally not recommended as headerBufferBytes values that are too small may break the IngressController and headerBufferBytes values that are too large could cause the IngressController to use significantly more memory than necessary.
+     */
     @JsonProperty("headerBufferBytes")
     public void setHeaderBufferBytes(Integer headerBufferBytes) {
         this.headerBufferBytes = headerBufferBytes;
     }
 
+    /**
+     * headerBufferMaxRewriteBytes describes how much memory should be reserved (in bytes) from headerBufferBytes for HTTP header rewriting and appending for IngressController connection sessions. Note that incoming HTTP requests will be limited to (headerBufferBytes - headerBufferMaxRewriteBytes) bytes, meaning headerBufferBytes must be greater than headerBufferMaxRewriteBytes. If this field is empty, the IngressController will use a default value of 8192 bytes.<br><p> <br><p> Setting this field is generally not recommended as headerBufferMaxRewriteBytes values that are too small may break the IngressController and headerBufferMaxRewriteBytes values that are too large could cause the IngressController to use significantly more memory than necessary.
+     */
     @JsonProperty("headerBufferMaxRewriteBytes")
     public Integer getHeaderBufferMaxRewriteBytes() {
         return headerBufferMaxRewriteBytes;
     }
 
+    /**
+     * headerBufferMaxRewriteBytes describes how much memory should be reserved (in bytes) from headerBufferBytes for HTTP header rewriting and appending for IngressController connection sessions. Note that incoming HTTP requests will be limited to (headerBufferBytes - headerBufferMaxRewriteBytes) bytes, meaning headerBufferBytes must be greater than headerBufferMaxRewriteBytes. If this field is empty, the IngressController will use a default value of 8192 bytes.<br><p> <br><p> Setting this field is generally not recommended as headerBufferMaxRewriteBytes values that are too small may break the IngressController and headerBufferMaxRewriteBytes values that are too large could cause the IngressController to use significantly more memory than necessary.
+     */
     @JsonProperty("headerBufferMaxRewriteBytes")
     public void setHeaderBufferMaxRewriteBytes(Integer headerBufferMaxRewriteBytes) {
         this.headerBufferMaxRewriteBytes = headerBufferMaxRewriteBytes;
     }
 
+    /**
+     * IngressControllerTuningOptions specifies options for tuning the performance of ingress controller pods
+     */
     @JsonProperty("healthCheckInterval")
     public String getHealthCheckInterval() {
         return healthCheckInterval;
     }
 
+    /**
+     * IngressControllerTuningOptions specifies options for tuning the performance of ingress controller pods
+     */
     @JsonProperty("healthCheckInterval")
     public void setHealthCheckInterval(String healthCheckInterval) {
         this.healthCheckInterval = healthCheckInterval;
     }
 
+    /**
+     * maxConnections defines the maximum number of simultaneous connections that can be established per HAProxy process. Increasing this value allows each ingress controller pod to handle more connections but at the cost of additional system resources being consumed.<br><p> <br><p> Permitted values are: empty, 0, -1, and the range 2000-2000000.<br><p> <br><p> If this field is empty or 0, the IngressController will use the default value of 50000, but the default is subject to change in future releases.<br><p> <br><p> If the value is -1 then HAProxy will dynamically compute a maximum value based on the available ulimits in the running container. Selecting -1 (i.e., auto) will result in a large value being computed (~520000 on OpenShift &gt;=4.10 clusters) and therefore each HAProxy process will incur significant memory usage compared to the current default of 50000.<br><p> <br><p> Setting a value that is greater than the current operating system limit will prevent the HAProxy process from starting.<br><p> <br><p> If you choose a discrete value (e.g., 750000) and the router pod is migrated to a new node, there's no guarantee that that new node has identical ulimits configured. In such a scenario the pod would fail to start. If you have nodes with different ulimits configured (e.g., different tuned profiles) and you choose a discrete value then the guidance is to use -1 and let the value be computed dynamically at runtime.<br><p> <br><p> You can monitor memory usage for router containers with the following metric: 'container_memory_working_set_bytes{container="router",namespace="openshift-ingress"}'.<br><p> <br><p> You can monitor memory usage of individual HAProxy processes in router containers with the following metric: 'container_memory_working_set_bytes{container="router",namespace="openshift-ingress"}/container_processes{container="router",namespace="openshift-ingress"}'.
+     */
     @JsonProperty("maxConnections")
     public Integer getMaxConnections() {
         return maxConnections;
     }
 
+    /**
+     * maxConnections defines the maximum number of simultaneous connections that can be established per HAProxy process. Increasing this value allows each ingress controller pod to handle more connections but at the cost of additional system resources being consumed.<br><p> <br><p> Permitted values are: empty, 0, -1, and the range 2000-2000000.<br><p> <br><p> If this field is empty or 0, the IngressController will use the default value of 50000, but the default is subject to change in future releases.<br><p> <br><p> If the value is -1 then HAProxy will dynamically compute a maximum value based on the available ulimits in the running container. Selecting -1 (i.e., auto) will result in a large value being computed (~520000 on OpenShift &gt;=4.10 clusters) and therefore each HAProxy process will incur significant memory usage compared to the current default of 50000.<br><p> <br><p> Setting a value that is greater than the current operating system limit will prevent the HAProxy process from starting.<br><p> <br><p> If you choose a discrete value (e.g., 750000) and the router pod is migrated to a new node, there's no guarantee that that new node has identical ulimits configured. In such a scenario the pod would fail to start. If you have nodes with different ulimits configured (e.g., different tuned profiles) and you choose a discrete value then the guidance is to use -1 and let the value be computed dynamically at runtime.<br><p> <br><p> You can monitor memory usage for router containers with the following metric: 'container_memory_working_set_bytes{container="router",namespace="openshift-ingress"}'.<br><p> <br><p> You can monitor memory usage of individual HAProxy processes in router containers with the following metric: 'container_memory_working_set_bytes{container="router",namespace="openshift-ingress"}/container_processes{container="router",namespace="openshift-ingress"}'.
+     */
     @JsonProperty("maxConnections")
     public void setMaxConnections(Integer maxConnections) {
         this.maxConnections = maxConnections;
     }
 
+    /**
+     * IngressControllerTuningOptions specifies options for tuning the performance of ingress controller pods
+     */
     @JsonProperty("reloadInterval")
     public String getReloadInterval() {
         return reloadInterval;
     }
 
+    /**
+     * IngressControllerTuningOptions specifies options for tuning the performance of ingress controller pods
+     */
     @JsonProperty("reloadInterval")
     public void setReloadInterval(String reloadInterval) {
         this.reloadInterval = reloadInterval;
     }
 
+    /**
+     * IngressControllerTuningOptions specifies options for tuning the performance of ingress controller pods
+     */
     @JsonProperty("serverFinTimeout")
     public String getServerFinTimeout() {
         return serverFinTimeout;
     }
 
+    /**
+     * IngressControllerTuningOptions specifies options for tuning the performance of ingress controller pods
+     */
     @JsonProperty("serverFinTimeout")
     public void setServerFinTimeout(String serverFinTimeout) {
         this.serverFinTimeout = serverFinTimeout;
     }
 
+    /**
+     * IngressControllerTuningOptions specifies options for tuning the performance of ingress controller pods
+     */
     @JsonProperty("serverTimeout")
     public String getServerTimeout() {
         return serverTimeout;
     }
 
+    /**
+     * IngressControllerTuningOptions specifies options for tuning the performance of ingress controller pods
+     */
     @JsonProperty("serverTimeout")
     public void setServerTimeout(String serverTimeout) {
         this.serverTimeout = serverTimeout;
     }
 
+    /**
+     * threadCount defines the number of threads created per HAProxy process. Creating more threads allows each ingress controller pod to handle more connections, at the cost of more system resources being used. HAProxy currently supports up to 64 threads. If this field is empty, the IngressController will use the default value.  The current default is 4 threads, but this may change in future releases.<br><p> <br><p> Setting this field is generally not recommended. Increasing the number of HAProxy threads allows ingress controller pods to utilize more CPU time under load, potentially starving other pods if set too high. Reducing the number of threads may cause the ingress controller to perform poorly.
+     */
     @JsonProperty("threadCount")
     public Integer getThreadCount() {
         return threadCount;
     }
 
+    /**
+     * threadCount defines the number of threads created per HAProxy process. Creating more threads allows each ingress controller pod to handle more connections, at the cost of more system resources being used. HAProxy currently supports up to 64 threads. If this field is empty, the IngressController will use the default value.  The current default is 4 threads, but this may change in future releases.<br><p> <br><p> Setting this field is generally not recommended. Increasing the number of HAProxy threads allows ingress controller pods to utilize more CPU time under load, potentially starving other pods if set too high. Reducing the number of threads may cause the ingress controller to perform poorly.
+     */
     @JsonProperty("threadCount")
     public void setThreadCount(Integer threadCount) {
         this.threadCount = threadCount;
     }
 
+    /**
+     * IngressControllerTuningOptions specifies options for tuning the performance of ingress controller pods
+     */
     @JsonProperty("tlsInspectDelay")
     public String getTlsInspectDelay() {
         return tlsInspectDelay;
     }
 
+    /**
+     * IngressControllerTuningOptions specifies options for tuning the performance of ingress controller pods
+     */
     @JsonProperty("tlsInspectDelay")
     public void setTlsInspectDelay(String tlsInspectDelay) {
         this.tlsInspectDelay = tlsInspectDelay;
     }
 
+    /**
+     * IngressControllerTuningOptions specifies options for tuning the performance of ingress controller pods
+     */
     @JsonProperty("tunnelTimeout")
     public String getTunnelTimeout() {
         return tunnelTimeout;
     }
 
+    /**
+     * IngressControllerTuningOptions specifies options for tuning the performance of ingress controller pods
+     */
     @JsonProperty("tunnelTimeout")
     public void setTunnelTimeout(String tunnelTimeout) {
         this.tunnelTimeout = tunnelTimeout;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/InsightsOperator.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/InsightsOperator.java
index 069476e1d2c..177188b13dc 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/InsightsOperator.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/InsightsOperator.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * InsightsOperator holds cluster-wide information about the Insights Operator.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class InsightsOperator implements Editable<InsightsOperatorBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "InsightsOperator";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public InsightsOperator(String apiVersion, String kind, ObjectMeta metadata, Ins
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * InsightsOperator holds cluster-wide information about the Insights Operator.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * InsightsOperator holds cluster-wide information about the Insights Operator.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * InsightsOperator holds cluster-wide information about the Insights Operator.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public InsightsOperatorSpec getSpec() {
         return spec;
     }
 
+    /**
+     * InsightsOperator holds cluster-wide information about the Insights Operator.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(InsightsOperatorSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * InsightsOperator holds cluster-wide information about the Insights Operator.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public InsightsOperatorStatus getStatus() {
         return status;
     }
 
+    /**
+     * InsightsOperator holds cluster-wide information about the Insights Operator.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(InsightsOperatorStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/InsightsOperatorList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/InsightsOperatorList.java
index 2b0e4b38a6c..96f3e22a03b 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/InsightsOperatorList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/InsightsOperatorList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * InsightsOperatorList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class InsightsOperatorList implements Editable<InsightsOperatorListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.v1.InsightsOperator>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.v1.InsightsOperator> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "InsightsOperatorList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public InsightsOperatorList(String apiVersion, List<io.fabric8.openshift.api.mod
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * InsightsOperatorList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.v1.InsightsOperator> getItems() {
         return items;
     }
 
+    /**
+     * InsightsOperatorList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.v1.InsightsOperator> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * InsightsOperatorList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * InsightsOperatorList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/InsightsOperatorSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/InsightsOperatorSpec.java
index 8e2bcb84714..14c4100213e 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/InsightsOperatorSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/InsightsOperatorSpec.java
@@ -96,21 +96,33 @@ public InsightsOperatorSpec(String logLevel, String managementState, Object obse
         this.unsupportedConfigOverrides = unsupportedConfigOverrides;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
@@ -127,11 +139,17 @@ public void setObservedConfig(Object observedConfig) {
         this.observedConfig = observedConfig;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public String getOperatorLogLevel() {
         return operatorLogLevel;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public void setOperatorLogLevel(String operatorLogLevel) {
         this.operatorLogLevel = operatorLogLevel;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/InsightsOperatorStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/InsightsOperatorStatus.java
index b0850198b35..50ab743faac 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/InsightsOperatorStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/InsightsOperatorStatus.java
@@ -110,12 +110,18 @@ public InsightsOperatorStatus(List<OperatorCondition> conditions, GatherStatus g
         this.version = version;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
@@ -131,12 +137,18 @@ public void setGatherStatus(GatherStatus gatherStatus) {
         this.gatherStatus = gatherStatus;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenerationStatus> getGenerations() {
         return generations;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     public void setGenerations(List<GenerationStatus> generations) {
         this.generations = generations;
@@ -152,41 +164,65 @@ public void setInsightsReport(InsightsReport insightsReport) {
         this.insightsReport = insightsReport;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public Integer getLatestAvailableRevision() {
         return latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public void setLatestAvailableRevision(Integer latestAvailableRevision) {
         this.latestAvailableRevision = latestAvailableRevision;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/InsightsReport.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/InsightsReport.java
index df89d0282a3..2bd9ba3cfea 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/InsightsReport.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/InsightsReport.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * insightsReport provides Insights health check report based on the most recently sent Insights data.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public InsightsReport(String downloadedAt, List<HealthCheck> healthChecks) {
         this.healthChecks = healthChecks;
     }
 
+    /**
+     * insightsReport provides Insights health check report based on the most recently sent Insights data.
+     */
     @JsonProperty("downloadedAt")
     public String getDownloadedAt() {
         return downloadedAt;
     }
 
+    /**
+     * insightsReport provides Insights health check report based on the most recently sent Insights data.
+     */
     @JsonProperty("downloadedAt")
     public void setDownloadedAt(String downloadedAt) {
         this.downloadedAt = downloadedAt;
     }
 
+    /**
+     * healthChecks provides basic information about active Insights health checks in a cluster.
+     */
     @JsonProperty("healthChecks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<HealthCheck> getHealthChecks() {
         return healthChecks;
     }
 
+    /**
+     * healthChecks provides basic information about active Insights health checks in a cluster.
+     */
     @JsonProperty("healthChecks")
     public void setHealthChecks(List<HealthCheck> healthChecks) {
         this.healthChecks = healthChecks;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeAPIServer.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeAPIServer.java
index e0640706f14..797d4724dba 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeAPIServer.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeAPIServer.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KubeAPIServer provides information to configure an operator to manage kube-apiserver.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class KubeAPIServer implements Editable<KubeAPIServerBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KubeAPIServer";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public KubeAPIServer(String apiVersion, String kind, ObjectMeta metadata, KubeAP
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KubeAPIServer provides information to configure an operator to manage kube-apiserver.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KubeAPIServer provides information to configure an operator to manage kube-apiserver.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * KubeAPIServer provides information to configure an operator to manage kube-apiserver.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public KubeAPIServerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * KubeAPIServer provides information to configure an operator to manage kube-apiserver.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(KubeAPIServerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * KubeAPIServer provides information to configure an operator to manage kube-apiserver.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public KubeAPIServerStatus getStatus() {
         return status;
     }
 
+    /**
+     * KubeAPIServer provides information to configure an operator to manage kube-apiserver.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(KubeAPIServerStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeAPIServerList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeAPIServerList.java
index 70d67fb68ed..7b7f7fa8ba4 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeAPIServerList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeAPIServerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KubeAPIServerList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class KubeAPIServerList implements Editable<KubeAPIServerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.v1.KubeAPIServer>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.v1.KubeAPIServer> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KubeAPIServerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public KubeAPIServerList(String apiVersion, List<io.fabric8.openshift.api.model.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items contains the items
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.v1.KubeAPIServer> getItems() {
         return items;
     }
 
+    /**
+     * Items contains the items
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.v1.KubeAPIServer> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KubeAPIServerList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KubeAPIServerList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeAPIServerSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeAPIServerSpec.java
index 8ca12a82100..e153756f42f 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeAPIServerSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeAPIServerSpec.java
@@ -108,41 +108,65 @@ public KubeAPIServerSpec(Integer failedRevisionLimit, String forceRedeploymentRe
         this.unsupportedConfigOverrides = unsupportedConfigOverrides;
     }
 
+    /**
+     * failedRevisionLimit is the number of failed static pod installer revisions to keep on disk and in the api -1 = unlimited, 0 or unset = 5 (default)
+     */
     @JsonProperty("failedRevisionLimit")
     public Integer getFailedRevisionLimit() {
         return failedRevisionLimit;
     }
 
+    /**
+     * failedRevisionLimit is the number of failed static pod installer revisions to keep on disk and in the api -1 = unlimited, 0 or unset = 5 (default)
+     */
     @JsonProperty("failedRevisionLimit")
     public void setFailedRevisionLimit(Integer failedRevisionLimit) {
         this.failedRevisionLimit = failedRevisionLimit;
     }
 
+    /**
+     * forceRedeploymentReason can be used to force the redeployment of the operand by providing a unique string. This provides a mechanism to kick a previously failed deployment and provide a reason why you think it will work this time instead of failing again on the same config.
+     */
     @JsonProperty("forceRedeploymentReason")
     public String getForceRedeploymentReason() {
         return forceRedeploymentReason;
     }
 
+    /**
+     * forceRedeploymentReason can be used to force the redeployment of the operand by providing a unique string. This provides a mechanism to kick a previously failed deployment and provide a reason why you think it will work this time instead of failing again on the same config.
+     */
     @JsonProperty("forceRedeploymentReason")
     public void setForceRedeploymentReason(String forceRedeploymentReason) {
         this.forceRedeploymentReason = forceRedeploymentReason;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
@@ -159,21 +183,33 @@ public void setObservedConfig(Object observedConfig) {
         this.observedConfig = observedConfig;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public String getOperatorLogLevel() {
         return operatorLogLevel;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public void setOperatorLogLevel(String operatorLogLevel) {
         this.operatorLogLevel = operatorLogLevel;
     }
 
+    /**
+     * succeededRevisionLimit is the number of successful static pod installer revisions to keep on disk and in the api -1 = unlimited, 0 or unset = 5 (default)
+     */
     @JsonProperty("succeededRevisionLimit")
     public Integer getSucceededRevisionLimit() {
         return succeededRevisionLimit;
     }
 
+    /**
+     * succeededRevisionLimit is the number of successful static pod installer revisions to keep on disk and in the api -1 = unlimited, 0 or unset = 5 (default)
+     */
     @JsonProperty("succeededRevisionLimit")
     public void setSucceededRevisionLimit(Integer succeededRevisionLimit) {
         this.succeededRevisionLimit = succeededRevisionLimit;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeAPIServerStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeAPIServerStatus.java
index e795ba2dc29..f9b98efdd79 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeAPIServerStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeAPIServerStatus.java
@@ -116,95 +116,149 @@ public KubeAPIServerStatus(List<OperatorCondition> conditions, List<GenerationSt
         this.version = version;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenerationStatus> getGenerations() {
         return generations;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     public void setGenerations(List<GenerationStatus> generations) {
         this.generations = generations;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public Integer getLatestAvailableRevision() {
         return latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public void setLatestAvailableRevision(Integer latestAvailableRevision) {
         this.latestAvailableRevision = latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevisionReason describe the detailed reason for the most recent deployment
+     */
     @JsonProperty("latestAvailableRevisionReason")
     public String getLatestAvailableRevisionReason() {
         return latestAvailableRevisionReason;
     }
 
+    /**
+     * latestAvailableRevisionReason describe the detailed reason for the most recent deployment
+     */
     @JsonProperty("latestAvailableRevisionReason")
     public void setLatestAvailableRevisionReason(String latestAvailableRevisionReason) {
         this.latestAvailableRevisionReason = latestAvailableRevisionReason;
     }
 
+    /**
+     * nodeStatuses track the deployment values and errors across individual nodes
+     */
     @JsonProperty("nodeStatuses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NodeStatus> getNodeStatuses() {
         return nodeStatuses;
     }
 
+    /**
+     * nodeStatuses track the deployment values and errors across individual nodes
+     */
     @JsonProperty("nodeStatuses")
     public void setNodeStatuses(List<NodeStatus> nodeStatuses) {
         this.nodeStatuses = nodeStatuses;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * serviceAccountIssuers tracks history of used service account issuers. The item without expiration time represents the currently used service account issuer. The other items represents service account issuers that were used previously and are still being trusted. The default expiration for the items is set by the platform and it defaults to 24h. see: https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/#service-account-token-volume-projection
+     */
     @JsonProperty("serviceAccountIssuers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ServiceAccountIssuerStatus> getServiceAccountIssuers() {
         return serviceAccountIssuers;
     }
 
+    /**
+     * serviceAccountIssuers tracks history of used service account issuers. The item without expiration time represents the currently used service account issuer. The other items represents service account issuers that were used previously and are still being trusted. The default expiration for the items is set by the platform and it defaults to 24h. see: https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/#service-account-token-volume-projection
+     */
     @JsonProperty("serviceAccountIssuers")
     public void setServiceAccountIssuers(List<ServiceAccountIssuerStatus> serviceAccountIssuers) {
         this.serviceAccountIssuers = serviceAccountIssuers;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeControllerManager.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeControllerManager.java
index 1c43f7eb516..01059b9f6f2 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeControllerManager.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeControllerManager.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KubeControllerManager provides information to configure an operator to manage kube-controller-manager.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class KubeControllerManager implements Editable<KubeControllerManagerBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KubeControllerManager";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public KubeControllerManager(String apiVersion, String kind, ObjectMeta metadata
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KubeControllerManager provides information to configure an operator to manage kube-controller-manager.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KubeControllerManager provides information to configure an operator to manage kube-controller-manager.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * KubeControllerManager provides information to configure an operator to manage kube-controller-manager.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public KubeControllerManagerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * KubeControllerManager provides information to configure an operator to manage kube-controller-manager.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(KubeControllerManagerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * KubeControllerManager provides information to configure an operator to manage kube-controller-manager.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public KubeControllerManagerStatus getStatus() {
         return status;
     }
 
+    /**
+     * KubeControllerManager provides information to configure an operator to manage kube-controller-manager.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(KubeControllerManagerStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeControllerManagerList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeControllerManagerList.java
index 5ad2c928c49..4c6beb7f652 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeControllerManagerList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeControllerManagerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KubeControllerManagerList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class KubeControllerManagerList implements Editable<KubeControllerManagerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.v1.KubeControllerManager>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.v1.KubeControllerManager> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KubeControllerManagerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public KubeControllerManagerList(String apiVersion, List<io.fabric8.openshift.ap
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items contains the items
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.v1.KubeControllerManager> getItems() {
         return items;
     }
 
+    /**
+     * Items contains the items
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.v1.KubeControllerManager> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KubeControllerManagerList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KubeControllerManagerList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeControllerManagerSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeControllerManagerSpec.java
index 893cb62e19a..5617b194d4f 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeControllerManagerSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeControllerManagerSpec.java
@@ -112,41 +112,65 @@ public KubeControllerManagerSpec(Integer failedRevisionLimit, String forceRedepl
         this.useMoreSecureServiceCA = useMoreSecureServiceCA;
     }
 
+    /**
+     * failedRevisionLimit is the number of failed static pod installer revisions to keep on disk and in the api -1 = unlimited, 0 or unset = 5 (default)
+     */
     @JsonProperty("failedRevisionLimit")
     public Integer getFailedRevisionLimit() {
         return failedRevisionLimit;
     }
 
+    /**
+     * failedRevisionLimit is the number of failed static pod installer revisions to keep on disk and in the api -1 = unlimited, 0 or unset = 5 (default)
+     */
     @JsonProperty("failedRevisionLimit")
     public void setFailedRevisionLimit(Integer failedRevisionLimit) {
         this.failedRevisionLimit = failedRevisionLimit;
     }
 
+    /**
+     * forceRedeploymentReason can be used to force the redeployment of the operand by providing a unique string. This provides a mechanism to kick a previously failed deployment and provide a reason why you think it will work this time instead of failing again on the same config.
+     */
     @JsonProperty("forceRedeploymentReason")
     public String getForceRedeploymentReason() {
         return forceRedeploymentReason;
     }
 
+    /**
+     * forceRedeploymentReason can be used to force the redeployment of the operand by providing a unique string. This provides a mechanism to kick a previously failed deployment and provide a reason why you think it will work this time instead of failing again on the same config.
+     */
     @JsonProperty("forceRedeploymentReason")
     public void setForceRedeploymentReason(String forceRedeploymentReason) {
         this.forceRedeploymentReason = forceRedeploymentReason;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
@@ -163,21 +187,33 @@ public void setObservedConfig(Object observedConfig) {
         this.observedConfig = observedConfig;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public String getOperatorLogLevel() {
         return operatorLogLevel;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public void setOperatorLogLevel(String operatorLogLevel) {
         this.operatorLogLevel = operatorLogLevel;
     }
 
+    /**
+     * succeededRevisionLimit is the number of successful static pod installer revisions to keep on disk and in the api -1 = unlimited, 0 or unset = 5 (default)
+     */
     @JsonProperty("succeededRevisionLimit")
     public Integer getSucceededRevisionLimit() {
         return succeededRevisionLimit;
     }
 
+    /**
+     * succeededRevisionLimit is the number of successful static pod installer revisions to keep on disk and in the api -1 = unlimited, 0 or unset = 5 (default)
+     */
     @JsonProperty("succeededRevisionLimit")
     public void setSucceededRevisionLimit(Integer succeededRevisionLimit) {
         this.succeededRevisionLimit = succeededRevisionLimit;
@@ -194,11 +230,17 @@ public void setUnsupportedConfigOverrides(Object unsupportedConfigOverrides) {
         this.unsupportedConfigOverrides = unsupportedConfigOverrides;
     }
 
+    /**
+     * useMoreSecureServiceCA indicates that the service-ca.crt provided in SA token volumes should include only enough certificates to validate service serving certificates. Once set to true, it cannot be set to false. Even if someone finds a way to set it back to false, the service-ca.crt files that previously existed will only have the more secure content.
+     */
     @JsonProperty("useMoreSecureServiceCA")
     public Boolean getUseMoreSecureServiceCA() {
         return useMoreSecureServiceCA;
     }
 
+    /**
+     * useMoreSecureServiceCA indicates that the service-ca.crt provided in SA token volumes should include only enough certificates to validate service serving certificates. Once set to true, it cannot be set to false. Even if someone finds a way to set it back to false, the service-ca.crt files that previously existed will only have the more secure content.
+     */
     @JsonProperty("useMoreSecureServiceCA")
     public void setUseMoreSecureServiceCA(Boolean useMoreSecureServiceCA) {
         this.useMoreSecureServiceCA = useMoreSecureServiceCA;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeControllerManagerStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeControllerManagerStatus.java
index 601b3f75bf9..df7c48fd125 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeControllerManagerStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeControllerManagerStatus.java
@@ -111,84 +111,132 @@ public KubeControllerManagerStatus(List<OperatorCondition> conditions, List<Gene
         this.version = version;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenerationStatus> getGenerations() {
         return generations;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     public void setGenerations(List<GenerationStatus> generations) {
         this.generations = generations;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public Integer getLatestAvailableRevision() {
         return latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public void setLatestAvailableRevision(Integer latestAvailableRevision) {
         this.latestAvailableRevision = latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevisionReason describe the detailed reason for the most recent deployment
+     */
     @JsonProperty("latestAvailableRevisionReason")
     public String getLatestAvailableRevisionReason() {
         return latestAvailableRevisionReason;
     }
 
+    /**
+     * latestAvailableRevisionReason describe the detailed reason for the most recent deployment
+     */
     @JsonProperty("latestAvailableRevisionReason")
     public void setLatestAvailableRevisionReason(String latestAvailableRevisionReason) {
         this.latestAvailableRevisionReason = latestAvailableRevisionReason;
     }
 
+    /**
+     * nodeStatuses track the deployment values and errors across individual nodes
+     */
     @JsonProperty("nodeStatuses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NodeStatus> getNodeStatuses() {
         return nodeStatuses;
     }
 
+    /**
+     * nodeStatuses track the deployment values and errors across individual nodes
+     */
     @JsonProperty("nodeStatuses")
     public void setNodeStatuses(List<NodeStatus> nodeStatuses) {
         this.nodeStatuses = nodeStatuses;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeScheduler.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeScheduler.java
index 4534a7deaad..61355579284 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeScheduler.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeScheduler.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KubeScheduler provides information to configure an operator to manage scheduler.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class KubeScheduler implements Editable<KubeSchedulerBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KubeScheduler";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public KubeScheduler(String apiVersion, String kind, ObjectMeta metadata, KubeSc
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KubeScheduler provides information to configure an operator to manage scheduler.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KubeScheduler provides information to configure an operator to manage scheduler.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * KubeScheduler provides information to configure an operator to manage scheduler.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public KubeSchedulerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * KubeScheduler provides information to configure an operator to manage scheduler.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(KubeSchedulerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * KubeScheduler provides information to configure an operator to manage scheduler.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public KubeSchedulerStatus getStatus() {
         return status;
     }
 
+    /**
+     * KubeScheduler provides information to configure an operator to manage scheduler.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(KubeSchedulerStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeSchedulerList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeSchedulerList.java
index 9cf3e52a9bf..38d1b0a3e55 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeSchedulerList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeSchedulerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KubeSchedulerList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class KubeSchedulerList implements Editable<KubeSchedulerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.v1.KubeScheduler>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.v1.KubeScheduler> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KubeSchedulerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public KubeSchedulerList(String apiVersion, List<io.fabric8.openshift.api.model.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items contains the items
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.v1.KubeScheduler> getItems() {
         return items;
     }
 
+    /**
+     * Items contains the items
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.v1.KubeScheduler> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KubeSchedulerList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KubeSchedulerList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeSchedulerSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeSchedulerSpec.java
index b848d9b82ff..4e8c4c0881e 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeSchedulerSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeSchedulerSpec.java
@@ -108,41 +108,65 @@ public KubeSchedulerSpec(Integer failedRevisionLimit, String forceRedeploymentRe
         this.unsupportedConfigOverrides = unsupportedConfigOverrides;
     }
 
+    /**
+     * failedRevisionLimit is the number of failed static pod installer revisions to keep on disk and in the api -1 = unlimited, 0 or unset = 5 (default)
+     */
     @JsonProperty("failedRevisionLimit")
     public Integer getFailedRevisionLimit() {
         return failedRevisionLimit;
     }
 
+    /**
+     * failedRevisionLimit is the number of failed static pod installer revisions to keep on disk and in the api -1 = unlimited, 0 or unset = 5 (default)
+     */
     @JsonProperty("failedRevisionLimit")
     public void setFailedRevisionLimit(Integer failedRevisionLimit) {
         this.failedRevisionLimit = failedRevisionLimit;
     }
 
+    /**
+     * forceRedeploymentReason can be used to force the redeployment of the operand by providing a unique string. This provides a mechanism to kick a previously failed deployment and provide a reason why you think it will work this time instead of failing again on the same config.
+     */
     @JsonProperty("forceRedeploymentReason")
     public String getForceRedeploymentReason() {
         return forceRedeploymentReason;
     }
 
+    /**
+     * forceRedeploymentReason can be used to force the redeployment of the operand by providing a unique string. This provides a mechanism to kick a previously failed deployment and provide a reason why you think it will work this time instead of failing again on the same config.
+     */
     @JsonProperty("forceRedeploymentReason")
     public void setForceRedeploymentReason(String forceRedeploymentReason) {
         this.forceRedeploymentReason = forceRedeploymentReason;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
@@ -159,21 +183,33 @@ public void setObservedConfig(Object observedConfig) {
         this.observedConfig = observedConfig;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public String getOperatorLogLevel() {
         return operatorLogLevel;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public void setOperatorLogLevel(String operatorLogLevel) {
         this.operatorLogLevel = operatorLogLevel;
     }
 
+    /**
+     * succeededRevisionLimit is the number of successful static pod installer revisions to keep on disk and in the api -1 = unlimited, 0 or unset = 5 (default)
+     */
     @JsonProperty("succeededRevisionLimit")
     public Integer getSucceededRevisionLimit() {
         return succeededRevisionLimit;
     }
 
+    /**
+     * succeededRevisionLimit is the number of successful static pod installer revisions to keep on disk and in the api -1 = unlimited, 0 or unset = 5 (default)
+     */
     @JsonProperty("succeededRevisionLimit")
     public void setSucceededRevisionLimit(Integer succeededRevisionLimit) {
         this.succeededRevisionLimit = succeededRevisionLimit;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeSchedulerStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeSchedulerStatus.java
index 66f2bc5b3d0..0960b3cd58a 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeSchedulerStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeSchedulerStatus.java
@@ -111,84 +111,132 @@ public KubeSchedulerStatus(List<OperatorCondition> conditions, List<GenerationSt
         this.version = version;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenerationStatus> getGenerations() {
         return generations;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     public void setGenerations(List<GenerationStatus> generations) {
         this.generations = generations;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public Integer getLatestAvailableRevision() {
         return latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public void setLatestAvailableRevision(Integer latestAvailableRevision) {
         this.latestAvailableRevision = latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevisionReason describe the detailed reason for the most recent deployment
+     */
     @JsonProperty("latestAvailableRevisionReason")
     public String getLatestAvailableRevisionReason() {
         return latestAvailableRevisionReason;
     }
 
+    /**
+     * latestAvailableRevisionReason describe the detailed reason for the most recent deployment
+     */
     @JsonProperty("latestAvailableRevisionReason")
     public void setLatestAvailableRevisionReason(String latestAvailableRevisionReason) {
         this.latestAvailableRevisionReason = latestAvailableRevisionReason;
     }
 
+    /**
+     * nodeStatuses track the deployment values and errors across individual nodes
+     */
     @JsonProperty("nodeStatuses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NodeStatus> getNodeStatuses() {
         return nodeStatuses;
     }
 
+    /**
+     * nodeStatuses track the deployment values and errors across individual nodes
+     */
     @JsonProperty("nodeStatuses")
     public void setNodeStatuses(List<NodeStatus> nodeStatuses) {
         this.nodeStatuses = nodeStatuses;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeStorageVersionMigrator.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeStorageVersionMigrator.java
index f579a6bfd3f..924d0ac6c36 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeStorageVersionMigrator.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeStorageVersionMigrator.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KubeStorageVersionMigrator provides information to configure an operator to manage kube-storage-version-migrator.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class KubeStorageVersionMigrator implements Editable<KubeStorageVersionMigratorBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KubeStorageVersionMigrator";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public KubeStorageVersionMigrator(String apiVersion, String kind, ObjectMeta met
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KubeStorageVersionMigrator provides information to configure an operator to manage kube-storage-version-migrator.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KubeStorageVersionMigrator provides information to configure an operator to manage kube-storage-version-migrator.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * KubeStorageVersionMigrator provides information to configure an operator to manage kube-storage-version-migrator.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public KubeStorageVersionMigratorSpec getSpec() {
         return spec;
     }
 
+    /**
+     * KubeStorageVersionMigrator provides information to configure an operator to manage kube-storage-version-migrator.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(KubeStorageVersionMigratorSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * KubeStorageVersionMigrator provides information to configure an operator to manage kube-storage-version-migrator.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public KubeStorageVersionMigratorStatus getStatus() {
         return status;
     }
 
+    /**
+     * KubeStorageVersionMigrator provides information to configure an operator to manage kube-storage-version-migrator.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(KubeStorageVersionMigratorStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeStorageVersionMigratorList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeStorageVersionMigratorList.java
index 500dd7f6b28..ada529fb36c 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeStorageVersionMigratorList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeStorageVersionMigratorList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * KubeStorageVersionMigratorList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class KubeStorageVersionMigratorList implements Editable<KubeStorageVersionMigratorListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.v1.KubeStorageVersionMigrator>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.v1.KubeStorageVersionMigrator> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "KubeStorageVersionMigratorList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public KubeStorageVersionMigratorList(String apiVersion, List<io.fabric8.openshi
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items contains the items
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.v1.KubeStorageVersionMigrator> getItems() {
         return items;
     }
 
+    /**
+     * Items contains the items
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.v1.KubeStorageVersionMigrator> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * KubeStorageVersionMigratorList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * KubeStorageVersionMigratorList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeStorageVersionMigratorSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeStorageVersionMigratorSpec.java
index 033aad95e43..daaa2ba627a 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeStorageVersionMigratorSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeStorageVersionMigratorSpec.java
@@ -96,21 +96,33 @@ public KubeStorageVersionMigratorSpec(String logLevel, String managementState, O
         this.unsupportedConfigOverrides = unsupportedConfigOverrides;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
@@ -127,11 +139,17 @@ public void setObservedConfig(Object observedConfig) {
         this.observedConfig = observedConfig;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public String getOperatorLogLevel() {
         return operatorLogLevel;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public void setOperatorLogLevel(String operatorLogLevel) {
         this.operatorLogLevel = operatorLogLevel;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeStorageVersionMigratorStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeStorageVersionMigratorStatus.java
index f4046cc992b..b871e81f89c 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeStorageVersionMigratorStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/KubeStorageVersionMigratorStatus.java
@@ -102,63 +102,99 @@ public KubeStorageVersionMigratorStatus(List<OperatorCondition> conditions, List
         this.version = version;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenerationStatus> getGenerations() {
         return generations;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     public void setGenerations(List<GenerationStatus> generations) {
         this.generations = generations;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public Integer getLatestAvailableRevision() {
         return latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public void setLatestAvailableRevision(Integer latestAvailableRevision) {
         this.latestAvailableRevision = latestAvailableRevision;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/LoadBalancerStrategy.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/LoadBalancerStrategy.java
index 1183be02626..b72fd7e9d76 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/LoadBalancerStrategy.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/LoadBalancerStrategy.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LoadBalancerStrategy holds parameters for a load balancer.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public LoadBalancerStrategy(List<String> allowedSourceRanges, String dnsManageme
         this.scope = scope;
     }
 
+    /**
+     * allowedSourceRanges specifies an allowlist of IP address ranges to which access to the load balancer should be restricted.  Each range must be specified using CIDR notation (e.g. "10.0.0.0/8" or "fd00::/8"). If no range is specified, "0.0.0.0/0" for IPv4 and "::/0" for IPv6 are used by default, which allows all source addresses.<br><p> <br><p> To facilitate migration from earlier versions of OpenShift that did not have the allowedSourceRanges field, you may set the service.beta.kubernetes.io/load-balancer-source-ranges annotation on the "router-&lt;ingresscontroller name&gt;" service in the "openshift-ingress" namespace, and this annotation will take effect if allowedSourceRanges is empty on OpenShift 4.12.
+     */
     @JsonProperty("allowedSourceRanges")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAllowedSourceRanges() {
         return allowedSourceRanges;
     }
 
+    /**
+     * allowedSourceRanges specifies an allowlist of IP address ranges to which access to the load balancer should be restricted.  Each range must be specified using CIDR notation (e.g. "10.0.0.0/8" or "fd00::/8"). If no range is specified, "0.0.0.0/0" for IPv4 and "::/0" for IPv6 are used by default, which allows all source addresses.<br><p> <br><p> To facilitate migration from earlier versions of OpenShift that did not have the allowedSourceRanges field, you may set the service.beta.kubernetes.io/load-balancer-source-ranges annotation on the "router-&lt;ingresscontroller name&gt;" service in the "openshift-ingress" namespace, and this annotation will take effect if allowedSourceRanges is empty on OpenShift 4.12.
+     */
     @JsonProperty("allowedSourceRanges")
     public void setAllowedSourceRanges(List<String> allowedSourceRanges) {
         this.allowedSourceRanges = allowedSourceRanges;
     }
 
+    /**
+     * dnsManagementPolicy indicates if the lifecycle of the wildcard DNS record associated with the load balancer service will be managed by the ingress operator. It defaults to Managed. Valid values are: Managed and Unmanaged.
+     */
     @JsonProperty("dnsManagementPolicy")
     public String getDnsManagementPolicy() {
         return dnsManagementPolicy;
     }
 
+    /**
+     * dnsManagementPolicy indicates if the lifecycle of the wildcard DNS record associated with the load balancer service will be managed by the ingress operator. It defaults to Managed. Valid values are: Managed and Unmanaged.
+     */
     @JsonProperty("dnsManagementPolicy")
     public void setDnsManagementPolicy(String dnsManagementPolicy) {
         this.dnsManagementPolicy = dnsManagementPolicy;
     }
 
+    /**
+     * LoadBalancerStrategy holds parameters for a load balancer.
+     */
     @JsonProperty("providerParameters")
     public ProviderLoadBalancerParameters getProviderParameters() {
         return providerParameters;
     }
 
+    /**
+     * LoadBalancerStrategy holds parameters for a load balancer.
+     */
     @JsonProperty("providerParameters")
     public void setProviderParameters(ProviderLoadBalancerParameters providerParameters) {
         this.providerParameters = providerParameters;
     }
 
+    /**
+     * scope indicates the scope at which the load balancer is exposed. Possible values are "External" and "Internal".
+     */
     @JsonProperty("scope")
     public String getScope() {
         return scope;
     }
 
+    /**
+     * scope indicates the scope at which the load balancer is exposed. Possible values are "External" and "Internal".
+     */
     @JsonProperty("scope")
     public void setScope(String scope) {
         this.scope = scope;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/LoggingDestination.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/LoggingDestination.java
index dc0aaa84070..652746f139f 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/LoggingDestination.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/LoggingDestination.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LoggingDestination describes a destination for log messages.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public LoggingDestination(ContainerLoggingDestinationParameters container, Syslo
         this.type = type;
     }
 
+    /**
+     * LoggingDestination describes a destination for log messages.
+     */
     @JsonProperty("container")
     public ContainerLoggingDestinationParameters getContainer() {
         return container;
     }
 
+    /**
+     * LoggingDestination describes a destination for log messages.
+     */
     @JsonProperty("container")
     public void setContainer(ContainerLoggingDestinationParameters container) {
         this.container = container;
     }
 
+    /**
+     * LoggingDestination describes a destination for log messages.
+     */
     @JsonProperty("syslog")
     public SyslogLoggingDestinationParameters getSyslog() {
         return syslog;
     }
 
+    /**
+     * LoggingDestination describes a destination for log messages.
+     */
     @JsonProperty("syslog")
     public void setSyslog(SyslogLoggingDestinationParameters syslog) {
         this.syslog = syslog;
     }
 
+    /**
+     * type is the type of destination for logs.  It must be one of the following:<br><p> <br><p> &#42; Container<br><p> <br><p> The ingress operator configures the sidecar container named "logs" on the ingress controller pod and configures the ingress controller to write logs to the sidecar.  The logs are then available as container logs.  The expectation is that the administrator configures a custom logging solution that reads logs from this sidecar.  Note that using container logs means that logs may be dropped if the rate of logs exceeds the container runtime's or the custom logging solution's capacity.<br><p> <br><p> &#42; Syslog<br><p> <br><p> Logs are sent to a syslog endpoint.  The administrator must specify an endpoint that can receive syslog messages.  The expectation is that the administrator has configured a custom syslog instance.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the type of destination for logs.  It must be one of the following:<br><p> <br><p> &#42; Container<br><p> <br><p> The ingress operator configures the sidecar container named "logs" on the ingress controller pod and configures the ingress controller to write logs to the sidecar.  The logs are then available as container logs.  The expectation is that the administrator configures a custom logging solution that reads logs from this sidecar.  Note that using container logs means that logs may be dropped if the rate of logs exceeds the container runtime's or the custom logging solution's capacity.<br><p> <br><p> &#42; Syslog<br><p> <br><p> Logs are sent to a syslog endpoint.  The administrator must specify an endpoint that can receive syslog messages.  The expectation is that the administrator has configured a custom syslog instance.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MTUMigration.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MTUMigration.java
index 3a3f18f256f..dd69f19983b 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MTUMigration.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MTUMigration.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MTUMigration contains infomation about MTU migration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public MTUMigration(MTUMigrationValues machine, MTUMigrationValues network) {
         this.network = network;
     }
 
+    /**
+     * MTUMigration contains infomation about MTU migration.
+     */
     @JsonProperty("machine")
     public MTUMigrationValues getMachine() {
         return machine;
     }
 
+    /**
+     * MTUMigration contains infomation about MTU migration.
+     */
     @JsonProperty("machine")
     public void setMachine(MTUMigrationValues machine) {
         this.machine = machine;
     }
 
+    /**
+     * MTUMigration contains infomation about MTU migration.
+     */
     @JsonProperty("network")
     public MTUMigrationValues getNetwork() {
         return network;
     }
 
+    /**
+     * MTUMigration contains infomation about MTU migration.
+     */
     @JsonProperty("network")
     public void setNetwork(MTUMigrationValues network) {
         this.network = network;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MTUMigrationValues.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MTUMigrationValues.java
index e6c4f8c2ef6..05fe2da7565 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MTUMigrationValues.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MTUMigrationValues.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MTUMigrationValues contains the values for a MTU migration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public MTUMigrationValues(Long from, Long to) {
         this.to = to;
     }
 
+    /**
+     * from is the MTU to migrate from.
+     */
     @JsonProperty("from")
     public Long getFrom() {
         return from;
     }
 
+    /**
+     * from is the MTU to migrate from.
+     */
     @JsonProperty("from")
     public void setFrom(Long from) {
         this.from = from;
     }
 
+    /**
+     * to is the MTU to migrate to.
+     */
     @JsonProperty("to")
     public Long getTo() {
         return to;
     }
 
+    /**
+     * to is the MTU to migrate to.
+     */
     @JsonProperty("to")
     public void setTo(Long to) {
         this.to = to;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MachineConfiguration.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MachineConfiguration.java
index 202a2f47516..3da87a090d2 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MachineConfiguration.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MachineConfiguration.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineConfiguration provides information to configure an operator to manage Machine Configuration.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class MachineConfiguration implements Editable<MachineConfigurationBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MachineConfiguration";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public MachineConfiguration(String apiVersion, String kind, ObjectMeta metadata,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MachineConfiguration provides information to configure an operator to manage Machine Configuration.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MachineConfiguration provides information to configure an operator to manage Machine Configuration.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * MachineConfiguration provides information to configure an operator to manage Machine Configuration.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public MachineConfigurationSpec getSpec() {
         return spec;
     }
 
+    /**
+     * MachineConfiguration provides information to configure an operator to manage Machine Configuration.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(MachineConfigurationSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * MachineConfiguration provides information to configure an operator to manage Machine Configuration.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public MachineConfigurationStatus getStatus() {
         return status;
     }
 
+    /**
+     * MachineConfiguration provides information to configure an operator to manage Machine Configuration.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(MachineConfigurationStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MachineConfigurationList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MachineConfigurationList.java
index f41def238f4..8de298e4bc0 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MachineConfigurationList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MachineConfigurationList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineConfigurationList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class MachineConfigurationList implements Editable<MachineConfigurationListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.v1.MachineConfiguration>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.v1.MachineConfiguration> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MachineConfigurationList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public MachineConfigurationList(String apiVersion, List<io.fabric8.openshift.api
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items contains the items
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.v1.MachineConfiguration> getItems() {
         return items;
     }
 
+    /**
+     * Items contains the items
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.v1.MachineConfiguration> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MachineConfigurationList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MachineConfigurationList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MachineConfigurationSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MachineConfigurationSpec.java
index 24df75efc8d..2b065c7aedf 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MachineConfigurationSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MachineConfigurationSpec.java
@@ -116,31 +116,49 @@ public MachineConfigurationSpec(Integer failedRevisionLimit, String forceRedeplo
         this.unsupportedConfigOverrides = unsupportedConfigOverrides;
     }
 
+    /**
+     * failedRevisionLimit is the number of failed static pod installer revisions to keep on disk and in the api -1 = unlimited, 0 or unset = 5 (default)
+     */
     @JsonProperty("failedRevisionLimit")
     public Integer getFailedRevisionLimit() {
         return failedRevisionLimit;
     }
 
+    /**
+     * failedRevisionLimit is the number of failed static pod installer revisions to keep on disk and in the api -1 = unlimited, 0 or unset = 5 (default)
+     */
     @JsonProperty("failedRevisionLimit")
     public void setFailedRevisionLimit(Integer failedRevisionLimit) {
         this.failedRevisionLimit = failedRevisionLimit;
     }
 
+    /**
+     * forceRedeploymentReason can be used to force the redeployment of the operand by providing a unique string. This provides a mechanism to kick a previously failed deployment and provide a reason why you think it will work this time instead of failing again on the same config.
+     */
     @JsonProperty("forceRedeploymentReason")
     public String getForceRedeploymentReason() {
         return forceRedeploymentReason;
     }
 
+    /**
+     * forceRedeploymentReason can be used to force the redeployment of the operand by providing a unique string. This provides a mechanism to kick a previously failed deployment and provide a reason why you think it will work this time instead of failing again on the same config.
+     */
     @JsonProperty("forceRedeploymentReason")
     public void setForceRedeploymentReason(String forceRedeploymentReason) {
         this.forceRedeploymentReason = forceRedeploymentReason;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
@@ -156,11 +174,17 @@ public void setManagedBootImages(ManagedBootImages managedBootImages) {
         this.managedBootImages = managedBootImages;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
@@ -187,21 +211,33 @@ public void setObservedConfig(Object observedConfig) {
         this.observedConfig = observedConfig;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public String getOperatorLogLevel() {
         return operatorLogLevel;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public void setOperatorLogLevel(String operatorLogLevel) {
         this.operatorLogLevel = operatorLogLevel;
     }
 
+    /**
+     * succeededRevisionLimit is the number of successful static pod installer revisions to keep on disk and in the api -1 = unlimited, 0 or unset = 5 (default)
+     */
     @JsonProperty("succeededRevisionLimit")
     public Integer getSucceededRevisionLimit() {
         return succeededRevisionLimit;
     }
 
+    /**
+     * succeededRevisionLimit is the number of successful static pod installer revisions to keep on disk and in the api -1 = unlimited, 0 or unset = 5 (default)
+     */
     @JsonProperty("succeededRevisionLimit")
     public void setSucceededRevisionLimit(Integer succeededRevisionLimit) {
         this.succeededRevisionLimit = succeededRevisionLimit;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MachineConfigurationStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MachineConfigurationStatus.java
index 57d501eed16..2c87d117314 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MachineConfigurationStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MachineConfigurationStatus.java
@@ -90,12 +90,18 @@ public MachineConfigurationStatus(List<Condition> conditions, NodeDisruptionPoli
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
@@ -111,11 +117,17 @@ public void setNodeDisruptionPolicyStatus(NodeDisruptionPolicyStatus nodeDisrupt
         this.nodeDisruptionPolicyStatus = nodeDisruptionPolicyStatus;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MachineManager.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MachineManager.java
index 07de4693137..b1f76fea223 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MachineManager.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MachineManager.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MachineManager describes a target machine resource that is registered for boot image updates. It stores identifying information such as the resource type and the API Group of the resource. It also provides granular control via the selection field.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public MachineManager(String apiGroup, String resource, MachineManagerSelector s
         this.selection = selection;
     }
 
+    /**
+     * apiGroup is name of the APIGroup that the machine management resource belongs to. The only current valid value is machine.openshift.io. machine.openshift.io means that the machine manager will only register resources that belong to OpenShift machine API group.
+     */
     @JsonProperty("apiGroup")
     public String getApiGroup() {
         return apiGroup;
     }
 
+    /**
+     * apiGroup is name of the APIGroup that the machine management resource belongs to. The only current valid value is machine.openshift.io. machine.openshift.io means that the machine manager will only register resources that belong to OpenShift machine API group.
+     */
     @JsonProperty("apiGroup")
     public void setApiGroup(String apiGroup) {
         this.apiGroup = apiGroup;
     }
 
+    /**
+     * resource is the machine management resource's type. The only current valid value is machinesets. machinesets means that the machine manager will only register resources of the kind MachineSet.
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * resource is the machine management resource's type. The only current valid value is machinesets. machinesets means that the machine manager will only register resources of the kind MachineSet.
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
     }
 
+    /**
+     * MachineManager describes a target machine resource that is registered for boot image updates. It stores identifying information such as the resource type and the API Group of the resource. It also provides granular control via the selection field.
+     */
     @JsonProperty("selection")
     public MachineManagerSelector getSelection() {
         return selection;
     }
 
+    /**
+     * MachineManager describes a target machine resource that is registered for boot image updates. It stores identifying information such as the resource type and the API Group of the resource. It also provides granular control via the selection field.
+     */
     @JsonProperty("selection")
     public void setSelection(MachineManagerSelector selection) {
         this.selection = selection;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MachineManagerSelector.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MachineManagerSelector.java
index ec16900b811..313d63e3274 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MachineManagerSelector.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MachineManagerSelector.java
@@ -82,11 +82,17 @@ public MachineManagerSelector(String mode, PartialSelector partial) {
         this.partial = partial;
     }
 
+    /**
+     * mode determines how machine managers will be selected for updates. Valid values are All and Partial. All means that every resource matched by the machine manager will be updated. Partial requires specified selector(s) and allows customisation of which resources matched by the machine manager will be updated.
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * mode determines how machine managers will be selected for updates. Valid values are All and Partial. All means that every resource matched by the machine manager will be updated. Partial requires specified selector(s) and allows customisation of which resources matched by the machine manager will be updated.
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ManagedBootImages.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ManagedBootImages.java
index 0cb1a7745e6..daf4e1e1f1a 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ManagedBootImages.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ManagedBootImages.java
@@ -81,12 +81,18 @@ public ManagedBootImages(List<MachineManager> machineManagers) {
         this.machineManagers = machineManagers;
     }
 
+    /**
+     * machineManagers can be used to register machine management resources for boot image updates. The Machine Config Operator will watch for changes to this list. Only one entry is permitted per type of machine management resource.
+     */
     @JsonProperty("machineManagers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<MachineManager> getMachineManagers() {
         return machineManagers;
     }
 
+    /**
+     * machineManagers can be used to register machine management resources for boot image updates. The Machine Config Operator will watch for changes to this list. Only one entry is permitted per type of machine management resource.
+     */
     @JsonProperty("machineManagers")
     public void setMachineManagers(List<MachineManager> machineManagers) {
         this.machineManagers = machineManagers;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MyOperatorResource.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MyOperatorResource.java
index 45003485db6..4df64049e1c 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MyOperatorResource.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MyOperatorResource.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * MyOperatorResource is an example operator configuration type<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class MyOperatorResource implements Editable<MyOperatorResourceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "MyOperatorResource";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public MyOperatorResource(String apiVersion, String kind, ObjectMeta metadata, M
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * MyOperatorResource is an example operator configuration type<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * MyOperatorResource is an example operator configuration type<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * MyOperatorResource is an example operator configuration type<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("spec")
     public MyOperatorResourceSpec getSpec() {
         return spec;
     }
 
+    /**
+     * MyOperatorResource is an example operator configuration type<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("spec")
     public void setSpec(MyOperatorResourceSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * MyOperatorResource is an example operator configuration type<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("status")
     public MyOperatorResourceStatus getStatus() {
         return status;
     }
 
+    /**
+     * MyOperatorResource is an example operator configuration type<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("status")
     public void setStatus(MyOperatorResourceStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MyOperatorResourceSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MyOperatorResourceSpec.java
index 3c5c86d0314..6022b0d694f 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MyOperatorResourceSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MyOperatorResourceSpec.java
@@ -96,21 +96,33 @@ public MyOperatorResourceSpec(String logLevel, String managementState, Object ob
         this.unsupportedConfigOverrides = unsupportedConfigOverrides;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
@@ -127,11 +139,17 @@ public void setObservedConfig(Object observedConfig) {
         this.observedConfig = observedConfig;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public String getOperatorLogLevel() {
         return operatorLogLevel;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public void setOperatorLogLevel(String operatorLogLevel) {
         this.operatorLogLevel = operatorLogLevel;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MyOperatorResourceStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MyOperatorResourceStatus.java
index 444d9b1813b..11165c9645b 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MyOperatorResourceStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/MyOperatorResourceStatus.java
@@ -102,63 +102,99 @@ public MyOperatorResourceStatus(List<OperatorCondition> conditions, List<Generat
         this.version = version;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenerationStatus> getGenerations() {
         return generations;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     public void setGenerations(List<GenerationStatus> generations) {
         this.generations = generations;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public Integer getLatestAvailableRevision() {
         return latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public void setLatestAvailableRevision(Integer latestAvailableRevision) {
         this.latestAvailableRevision = latestAvailableRevision;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NetFlowConfig.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NetFlowConfig.java
index ff8f23537a7..364f637ddee 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NetFlowConfig.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NetFlowConfig.java
@@ -81,12 +81,18 @@ public NetFlowConfig(List<String> collectors) {
         this.collectors = collectors;
     }
 
+    /**
+     * netFlow defines the NetFlow collectors that will consume the flow data exported from OVS. It is a list of strings formatted as ip:port with a maximum of ten items
+     */
     @JsonProperty("collectors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCollectors() {
         return collectors;
     }
 
+    /**
+     * netFlow defines the NetFlow collectors that will consume the flow data exported from OVS. It is a list of strings formatted as ip:port with a maximum of ten items
+     */
     @JsonProperty("collectors")
     public void setCollectors(List<String> collectors) {
         this.collectors = collectors;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Network.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Network.java
index 5b5b54b7ae5..af0688cf036 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Network.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Network.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Network describes the cluster's desired network configuration. It is consumed by the cluster-network-operator.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Network implements Editable<NetworkBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Network";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public Network(String apiVersion, String kind, ObjectMeta metadata, NetworkSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Network describes the cluster's desired network configuration. It is consumed by the cluster-network-operator.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Network describes the cluster's desired network configuration. It is consumed by the cluster-network-operator.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Network describes the cluster's desired network configuration. It is consumed by the cluster-network-operator.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public NetworkSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Network describes the cluster's desired network configuration. It is consumed by the cluster-network-operator.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(NetworkSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Network describes the cluster's desired network configuration. It is consumed by the cluster-network-operator.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public NetworkStatus getStatus() {
         return status;
     }
 
+    /**
+     * Network describes the cluster's desired network configuration. It is consumed by the cluster-network-operator.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(NetworkStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NetworkList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NetworkList.java
index 93672a0566f..49ffbee8004 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NetworkList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NetworkList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkList contains a list of Network configurations<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class NetworkList implements Editable<NetworkListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.v1.Network>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.v1.Network> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "NetworkList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public NetworkList(String apiVersion, List<io.fabric8.openshift.api.model.operat
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * NetworkList contains a list of Network configurations<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.v1.Network> getItems() {
         return items;
     }
 
+    /**
+     * NetworkList contains a list of Network configurations<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.v1.Network> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * NetworkList contains a list of Network configurations<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * NetworkList contains a list of Network configurations<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NetworkMigration.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NetworkMigration.java
index e7e59d07398..67baca8c917 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NetworkMigration.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NetworkMigration.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkMigration represents the cluster network migration configuration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public NetworkMigration(FeaturesMigration features, String mode, MTUMigration mt
         this.networkType = networkType;
     }
 
+    /**
+     * NetworkMigration represents the cluster network migration configuration.
+     */
     @JsonProperty("features")
     public FeaturesMigration getFeatures() {
         return features;
     }
 
+    /**
+     * NetworkMigration represents the cluster network migration configuration.
+     */
     @JsonProperty("features")
     public void setFeatures(FeaturesMigration features) {
         this.features = features;
     }
 
+    /**
+     * mode indicates the mode of network type migration. DEPRECATED: network type migration is no longer supported, and setting this to a non-empty value will result in the network operator rejecting the configuration.
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * mode indicates the mode of network type migration. DEPRECATED: network type migration is no longer supported, and setting this to a non-empty value will result in the network operator rejecting the configuration.
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
     }
 
+    /**
+     * NetworkMigration represents the cluster network migration configuration.
+     */
     @JsonProperty("mtu")
     public MTUMigration getMtu() {
         return mtu;
     }
 
+    /**
+     * NetworkMigration represents the cluster network migration configuration.
+     */
     @JsonProperty("mtu")
     public void setMtu(MTUMigration mtu) {
         this.mtu = mtu;
     }
 
+    /**
+     * networkType was previously used when changing the default network type. DEPRECATED: network type migration is no longer supported, and setting this to a non-empty value will result in the network operator rejecting the configuration.
+     */
     @JsonProperty("networkType")
     public String getNetworkType() {
         return networkType;
     }
 
+    /**
+     * networkType was previously used when changing the default network type. DEPRECATED: network type migration is no longer supported, and setting this to a non-empty value will result in the network operator rejecting the configuration.
+     */
     @JsonProperty("networkType")
     public void setNetworkType(String networkType) {
         this.networkType = networkType;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NetworkSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NetworkSpec.java
index b5d0fc25c46..6785e8a4795 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NetworkSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NetworkSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkSpec is the top-level network configuration object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -149,176 +152,278 @@ public NetworkSpec(List<AdditionalNetworkDefinition> additionalNetworks, Additio
         this.useMultiNetworkPolicy = useMultiNetworkPolicy;
     }
 
+    /**
+     * additionalNetworks is a list of extra networks to make available to pods when multiple networks are enabled.
+     */
     @JsonProperty("additionalNetworks")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AdditionalNetworkDefinition> getAdditionalNetworks() {
         return additionalNetworks;
     }
 
+    /**
+     * additionalNetworks is a list of extra networks to make available to pods when multiple networks are enabled.
+     */
     @JsonProperty("additionalNetworks")
     public void setAdditionalNetworks(List<AdditionalNetworkDefinition> additionalNetworks) {
         this.additionalNetworks = additionalNetworks;
     }
 
+    /**
+     * NetworkSpec is the top-level network configuration object.
+     */
     @JsonProperty("additionalRoutingCapabilities")
     public AdditionalRoutingCapabilities getAdditionalRoutingCapabilities() {
         return additionalRoutingCapabilities;
     }
 
+    /**
+     * NetworkSpec is the top-level network configuration object.
+     */
     @JsonProperty("additionalRoutingCapabilities")
     public void setAdditionalRoutingCapabilities(AdditionalRoutingCapabilities additionalRoutingCapabilities) {
         this.additionalRoutingCapabilities = additionalRoutingCapabilities;
     }
 
+    /**
+     * clusterNetwork is the IP address pool to use for pod IPs. Some network providers support multiple ClusterNetworks. Others only support one. This is equivalent to the cluster-cidr.
+     */
     @JsonProperty("clusterNetwork")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ClusterNetworkEntry> getClusterNetwork() {
         return clusterNetwork;
     }
 
+    /**
+     * clusterNetwork is the IP address pool to use for pod IPs. Some network providers support multiple ClusterNetworks. Others only support one. This is equivalent to the cluster-cidr.
+     */
     @JsonProperty("clusterNetwork")
     public void setClusterNetwork(List<ClusterNetworkEntry> clusterNetwork) {
         this.clusterNetwork = clusterNetwork;
     }
 
+    /**
+     * NetworkSpec is the top-level network configuration object.
+     */
     @JsonProperty("defaultNetwork")
     public DefaultNetworkDefinition getDefaultNetwork() {
         return defaultNetwork;
     }
 
+    /**
+     * NetworkSpec is the top-level network configuration object.
+     */
     @JsonProperty("defaultNetwork")
     public void setDefaultNetwork(DefaultNetworkDefinition defaultNetwork) {
         this.defaultNetwork = defaultNetwork;
     }
 
+    /**
+     * deployKubeProxy specifies whether or not a standalone kube-proxy should be deployed by the operator. Some network providers include kube-proxy or similar functionality. If unset, the plugin will attempt to select the correct value, which is false when ovn-kubernetes is used and true otherwise.
+     */
     @JsonProperty("deployKubeProxy")
     public Boolean getDeployKubeProxy() {
         return deployKubeProxy;
     }
 
+    /**
+     * deployKubeProxy specifies whether or not a standalone kube-proxy should be deployed by the operator. Some network providers include kube-proxy or similar functionality. If unset, the plugin will attempt to select the correct value, which is false when ovn-kubernetes is used and true otherwise.
+     */
     @JsonProperty("deployKubeProxy")
     public void setDeployKubeProxy(Boolean deployKubeProxy) {
         this.deployKubeProxy = deployKubeProxy;
     }
 
+    /**
+     * disableMultiNetwork specifies whether or not multiple pod network support should be disabled. If unset, this property defaults to 'false' and multiple network support is enabled.
+     */
     @JsonProperty("disableMultiNetwork")
     public Boolean getDisableMultiNetwork() {
         return disableMultiNetwork;
     }
 
+    /**
+     * disableMultiNetwork specifies whether or not multiple pod network support should be disabled. If unset, this property defaults to 'false' and multiple network support is enabled.
+     */
     @JsonProperty("disableMultiNetwork")
     public void setDisableMultiNetwork(Boolean disableMultiNetwork) {
         this.disableMultiNetwork = disableMultiNetwork;
     }
 
+    /**
+     * disableNetworkDiagnostics specifies whether or not PodNetworkConnectivityCheck CRs from a test pod to every node, apiserver and LB should be disabled or not. If unset, this property defaults to 'false' and network diagnostics is enabled. Setting this to 'true' would reduce the additional load of the pods performing the checks.
+     */
     @JsonProperty("disableNetworkDiagnostics")
     public Boolean getDisableNetworkDiagnostics() {
         return disableNetworkDiagnostics;
     }
 
+    /**
+     * disableNetworkDiagnostics specifies whether or not PodNetworkConnectivityCheck CRs from a test pod to every node, apiserver and LB should be disabled or not. If unset, this property defaults to 'false' and network diagnostics is enabled. Setting this to 'true' would reduce the additional load of the pods performing the checks.
+     */
     @JsonProperty("disableNetworkDiagnostics")
     public void setDisableNetworkDiagnostics(Boolean disableNetworkDiagnostics) {
         this.disableNetworkDiagnostics = disableNetworkDiagnostics;
     }
 
+    /**
+     * NetworkSpec is the top-level network configuration object.
+     */
     @JsonProperty("exportNetworkFlows")
     public ExportNetworkFlows getExportNetworkFlows() {
         return exportNetworkFlows;
     }
 
+    /**
+     * NetworkSpec is the top-level network configuration object.
+     */
     @JsonProperty("exportNetworkFlows")
     public void setExportNetworkFlows(ExportNetworkFlows exportNetworkFlows) {
         this.exportNetworkFlows = exportNetworkFlows;
     }
 
+    /**
+     * NetworkSpec is the top-level network configuration object.
+     */
     @JsonProperty("kubeProxyConfig")
     public ProxyConfig getKubeProxyConfig() {
         return kubeProxyConfig;
     }
 
+    /**
+     * NetworkSpec is the top-level network configuration object.
+     */
     @JsonProperty("kubeProxyConfig")
     public void setKubeProxyConfig(ProxyConfig kubeProxyConfig) {
         this.kubeProxyConfig = kubeProxyConfig;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
     }
 
+    /**
+     * NetworkSpec is the top-level network configuration object.
+     */
     @JsonProperty("migration")
     public NetworkMigration getMigration() {
         return migration;
     }
 
+    /**
+     * NetworkSpec is the top-level network configuration object.
+     */
     @JsonProperty("migration")
     public void setMigration(NetworkMigration migration) {
         this.migration = migration;
     }
 
+    /**
+     * NetworkSpec is the top-level network configuration object.
+     */
     @JsonProperty("observedConfig")
     public Object getObservedConfig() {
         return observedConfig;
     }
 
+    /**
+     * NetworkSpec is the top-level network configuration object.
+     */
     @JsonProperty("observedConfig")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setObservedConfig(Object observedConfig) {
         this.observedConfig = observedConfig;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public String getOperatorLogLevel() {
         return operatorLogLevel;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public void setOperatorLogLevel(String operatorLogLevel) {
         this.operatorLogLevel = operatorLogLevel;
     }
 
+    /**
+     * serviceNetwork is the ip address pool to use for Service IPs Currently, all existing network providers only support a single value here, but this is an array to allow for growth.
+     */
     @JsonProperty("serviceNetwork")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getServiceNetwork() {
         return serviceNetwork;
     }
 
+    /**
+     * serviceNetwork is the ip address pool to use for Service IPs Currently, all existing network providers only support a single value here, but this is an array to allow for growth.
+     */
     @JsonProperty("serviceNetwork")
     public void setServiceNetwork(List<String> serviceNetwork) {
         this.serviceNetwork = serviceNetwork;
     }
 
+    /**
+     * NetworkSpec is the top-level network configuration object.
+     */
     @JsonProperty("unsupportedConfigOverrides")
     public Object getUnsupportedConfigOverrides() {
         return unsupportedConfigOverrides;
     }
 
+    /**
+     * NetworkSpec is the top-level network configuration object.
+     */
     @JsonProperty("unsupportedConfigOverrides")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setUnsupportedConfigOverrides(Object unsupportedConfigOverrides) {
         this.unsupportedConfigOverrides = unsupportedConfigOverrides;
     }
 
+    /**
+     * useMultiNetworkPolicy enables a controller which allows for MultiNetworkPolicy objects to be used on additional networks as created by Multus CNI. MultiNetworkPolicy are similar to NetworkPolicy objects, but NetworkPolicy objects only apply to the primary interface. With MultiNetworkPolicy, you can control the traffic that a pod can receive over the secondary interfaces. If unset, this property defaults to 'false' and MultiNetworkPolicy objects are ignored. If 'disableMultiNetwork' is 'true' then the value of this field is ignored.
+     */
     @JsonProperty("useMultiNetworkPolicy")
     public Boolean getUseMultiNetworkPolicy() {
         return useMultiNetworkPolicy;
     }
 
+    /**
+     * useMultiNetworkPolicy enables a controller which allows for MultiNetworkPolicy objects to be used on additional networks as created by Multus CNI. MultiNetworkPolicy are similar to NetworkPolicy objects, but NetworkPolicy objects only apply to the primary interface. With MultiNetworkPolicy, you can control the traffic that a pod can receive over the secondary interfaces. If unset, this property defaults to 'false' and MultiNetworkPolicy objects are ignored. If 'disableMultiNetwork' is 'true' then the value of this field is ignored.
+     */
     @JsonProperty("useMultiNetworkPolicy")
     public void setUseMultiNetworkPolicy(Boolean useMultiNetworkPolicy) {
         this.useMultiNetworkPolicy = useMultiNetworkPolicy;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NetworkStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NetworkStatus.java
index 05e1e6a3e40..6852dbe191a 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NetworkStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NetworkStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NetworkStatus is detailed operator status, which is distilled up to the Network clusteroperator object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,63 +105,99 @@ public NetworkStatus(List<OperatorCondition> conditions, List<GenerationStatus>
         this.version = version;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenerationStatus> getGenerations() {
         return generations;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     public void setGenerations(List<GenerationStatus> generations) {
         this.generations = generations;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public Integer getLatestAvailableRevision() {
         return latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public void setLatestAvailableRevision(Integer latestAvailableRevision) {
         this.latestAvailableRevision = latestAvailableRevision;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicyClusterStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicyClusterStatus.java
index 6d7355e01af..9683e1511e6 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicyClusterStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicyClusterStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NodeDisruptionPolicyClusterStatus is the type for the status object, rendered by the controller as a merge of cluster defaults and user provided policies
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public NodeDisruptionPolicyClusterStatus(List<NodeDisruptionPolicyStatusFile> fi
         this.units = units;
     }
 
+    /**
+     * files is a list of MachineConfig file definitions and actions to take to changes on those paths
+     */
     @JsonProperty("files")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NodeDisruptionPolicyStatusFile> getFiles() {
         return files;
     }
 
+    /**
+     * files is a list of MachineConfig file definitions and actions to take to changes on those paths
+     */
     @JsonProperty("files")
     public void setFiles(List<NodeDisruptionPolicyStatusFile> files) {
         this.files = files;
     }
 
+    /**
+     * NodeDisruptionPolicyClusterStatus is the type for the status object, rendered by the controller as a merge of cluster defaults and user provided policies
+     */
     @JsonProperty("sshkey")
     public NodeDisruptionPolicyStatusSSHKey getSshkey() {
         return sshkey;
     }
 
+    /**
+     * NodeDisruptionPolicyClusterStatus is the type for the status object, rendered by the controller as a merge of cluster defaults and user provided policies
+     */
     @JsonProperty("sshkey")
     public void setSshkey(NodeDisruptionPolicyStatusSSHKey sshkey) {
         this.sshkey = sshkey;
     }
 
+    /**
+     * units is a list MachineConfig unit definitions and actions to take on changes to those services
+     */
     @JsonProperty("units")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NodeDisruptionPolicyStatusUnit> getUnits() {
         return units;
     }
 
+    /**
+     * units is a list MachineConfig unit definitions and actions to take on changes to those services
+     */
     @JsonProperty("units")
     public void setUnits(List<NodeDisruptionPolicyStatusUnit> units) {
         this.units = units;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicyConfig.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicyConfig.java
index 1d7f16225b1..df599216913 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicyConfig.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicyConfig.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NodeDisruptionPolicyConfig is the overall spec definition for files/units/sshkeys
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public NodeDisruptionPolicyConfig(List<NodeDisruptionPolicySpecFile> files, Node
         this.units = units;
     }
 
+    /**
+     * files is a list of MachineConfig file definitions and actions to take to changes on those paths This list supports a maximum of 50 entries.
+     */
     @JsonProperty("files")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NodeDisruptionPolicySpecFile> getFiles() {
         return files;
     }
 
+    /**
+     * files is a list of MachineConfig file definitions and actions to take to changes on those paths This list supports a maximum of 50 entries.
+     */
     @JsonProperty("files")
     public void setFiles(List<NodeDisruptionPolicySpecFile> files) {
         this.files = files;
     }
 
+    /**
+     * NodeDisruptionPolicyConfig is the overall spec definition for files/units/sshkeys
+     */
     @JsonProperty("sshkey")
     public NodeDisruptionPolicySpecSSHKey getSshkey() {
         return sshkey;
     }
 
+    /**
+     * NodeDisruptionPolicyConfig is the overall spec definition for files/units/sshkeys
+     */
     @JsonProperty("sshkey")
     public void setSshkey(NodeDisruptionPolicySpecSSHKey sshkey) {
         this.sshkey = sshkey;
     }
 
+    /**
+     * units is a list MachineConfig unit definitions and actions to take on changes to those services This list supports a maximum of 50 entries.
+     */
     @JsonProperty("units")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NodeDisruptionPolicySpecUnit> getUnits() {
         return units;
     }
 
+    /**
+     * units is a list MachineConfig unit definitions and actions to take on changes to those services This list supports a maximum of 50 entries.
+     */
     @JsonProperty("units")
     public void setUnits(List<NodeDisruptionPolicySpecUnit> units) {
         this.units = units;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicySpecAction.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicySpecAction.java
index a34624b0313..5f533194e82 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicySpecAction.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicySpecAction.java
@@ -106,11 +106,17 @@ public void setRestart(RestartService restart) {
         this.restart = restart;
     }
 
+    /**
+     * type represents the commands that will be carried out if this NodeDisruptionPolicySpecActionType is executed Valid values are Reboot, Drain, Reload, Restart, DaemonReload and None. reload/restart requires a corresponding service target specified in the reload/restart field. Other values require no further configuration
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type represents the commands that will be carried out if this NodeDisruptionPolicySpecActionType is executed Valid values are Reboot, Drain, Reload, Restart, DaemonReload and None. reload/restart requires a corresponding service target specified in the reload/restart field. Other values require no further configuration
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicySpecFile.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicySpecFile.java
index 452e2351e00..ca943c13e4f 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicySpecFile.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicySpecFile.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NodeDisruptionPolicySpecFile is a file entry and corresponding actions to take and is used in the NodeDisruptionPolicyConfig object
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public NodeDisruptionPolicySpecFile(List<NodeDisruptionPolicySpecAction> actions
         this.path = path;
     }
 
+    /**
+     * actions represents the series of commands to be executed on changes to the file at the corresponding file path. Actions will be applied in the order that they are set in this list. If there are other incoming changes to other MachineConfig entries in the same update that require a reboot, the reboot will supercede these actions. Valid actions are Reboot, Drain, Reload, DaemonReload and None. The Reboot action and the None action cannot be used in conjunction with any of the other actions. This list supports a maximum of 10 entries.
+     */
     @JsonProperty("actions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NodeDisruptionPolicySpecAction> getActions() {
         return actions;
     }
 
+    /**
+     * actions represents the series of commands to be executed on changes to the file at the corresponding file path. Actions will be applied in the order that they are set in this list. If there are other incoming changes to other MachineConfig entries in the same update that require a reboot, the reboot will supercede these actions. Valid actions are Reboot, Drain, Reload, DaemonReload and None. The Reboot action and the None action cannot be used in conjunction with any of the other actions. This list supports a maximum of 10 entries.
+     */
     @JsonProperty("actions")
     public void setActions(List<NodeDisruptionPolicySpecAction> actions) {
         this.actions = actions;
     }
 
+    /**
+     * path is the location of a file being managed through a MachineConfig. The Actions in the policy will apply to changes to the file at this path.
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * path is the location of a file being managed through a MachineConfig. The Actions in the policy will apply to changes to the file at this path.
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicySpecSSHKey.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicySpecSSHKey.java
index bdefbf3a38e..2074a44eabc 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicySpecSSHKey.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicySpecSSHKey.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NodeDisruptionPolicySpecSSHKey is actions to take for any SSHKey change and is used in the NodeDisruptionPolicyConfig object
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public NodeDisruptionPolicySpecSSHKey(List<NodeDisruptionPolicySpecAction> actio
         this.actions = actions;
     }
 
+    /**
+     * actions represents the series of commands to be executed on changes to the file at the corresponding file path. Actions will be applied in the order that they are set in this list. If there are other incoming changes to other MachineConfig entries in the same update that require a reboot, the reboot will supercede these actions. Valid actions are Reboot, Drain, Reload, DaemonReload and None. The Reboot action and the None action cannot be used in conjunction with any of the other actions. This list supports a maximum of 10 entries.
+     */
     @JsonProperty("actions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NodeDisruptionPolicySpecAction> getActions() {
         return actions;
     }
 
+    /**
+     * actions represents the series of commands to be executed on changes to the file at the corresponding file path. Actions will be applied in the order that they are set in this list. If there are other incoming changes to other MachineConfig entries in the same update that require a reboot, the reboot will supercede these actions. Valid actions are Reboot, Drain, Reload, DaemonReload and None. The Reboot action and the None action cannot be used in conjunction with any of the other actions. This list supports a maximum of 10 entries.
+     */
     @JsonProperty("actions")
     public void setActions(List<NodeDisruptionPolicySpecAction> actions) {
         this.actions = actions;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicySpecUnit.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicySpecUnit.java
index 58c6e360d93..d2422a24f87 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicySpecUnit.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicySpecUnit.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NodeDisruptionPolicySpecUnit is a systemd unit name and corresponding actions to take and is used in the NodeDisruptionPolicyConfig object
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public NodeDisruptionPolicySpecUnit(List<NodeDisruptionPolicySpecAction> actions
         this.name = name;
     }
 
+    /**
+     * actions represents the series of commands to be executed on changes to the file at the corresponding file path. Actions will be applied in the order that they are set in this list. If there are other incoming changes to other MachineConfig entries in the same update that require a reboot, the reboot will supercede these actions. Valid actions are Reboot, Drain, Reload, DaemonReload and None. The Reboot action and the None action cannot be used in conjunction with any of the other actions. This list supports a maximum of 10 entries.
+     */
     @JsonProperty("actions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NodeDisruptionPolicySpecAction> getActions() {
         return actions;
     }
 
+    /**
+     * actions represents the series of commands to be executed on changes to the file at the corresponding file path. Actions will be applied in the order that they are set in this list. If there are other incoming changes to other MachineConfig entries in the same update that require a reboot, the reboot will supercede these actions. Valid actions are Reboot, Drain, Reload, DaemonReload and None. The Reboot action and the None action cannot be used in conjunction with any of the other actions. This list supports a maximum of 10 entries.
+     */
     @JsonProperty("actions")
     public void setActions(List<NodeDisruptionPolicySpecAction> actions) {
         this.actions = actions;
     }
 
+    /**
+     * name represents the service name of a systemd service managed through a MachineConfig Actions specified will be applied for changes to the named service. Service names should be of the format ${NAME}${SERVICETYPE} and can up to 255 characters long. ${NAME} must be atleast 1 character long and can only consist of alphabets, digits, ":", "-", "_", ".", and "\". ${SERVICETYPE} must be one of ".service", ".socket", ".device", ".mount", ".automount", ".swap", ".target", ".path", ".timer", ".snapshot", ".slice" or ".scope".
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name represents the service name of a systemd service managed through a MachineConfig Actions specified will be applied for changes to the named service. Service names should be of the format ${NAME}${SERVICETYPE} and can up to 255 characters long. ${NAME} must be atleast 1 character long and can only consist of alphabets, digits, ":", "-", "_", ".", and "\". ${SERVICETYPE} must be one of ".service", ".socket", ".device", ".mount", ".automount", ".swap", ".target", ".path", ".timer", ".snapshot", ".slice" or ".scope".
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicyStatusAction.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicyStatusAction.java
index 07b1db1430e..2171bd867f3 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicyStatusAction.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicyStatusAction.java
@@ -106,11 +106,17 @@ public void setRestart(RestartService restart) {
         this.restart = restart;
     }
 
+    /**
+     * type represents the commands that will be carried out if this NodeDisruptionPolicyStatusActionType is executed Valid values are Reboot, Drain, Reload, Restart, DaemonReload, None and Special. reload/restart requires a corresponding service target specified in the reload/restart field. Other values require no further configuration
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type represents the commands that will be carried out if this NodeDisruptionPolicyStatusActionType is executed Valid values are Reboot, Drain, Reload, Restart, DaemonReload, None and Special. reload/restart requires a corresponding service target specified in the reload/restart field. Other values require no further configuration
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicyStatusFile.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicyStatusFile.java
index 46a50123670..119ece5d9af 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicyStatusFile.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicyStatusFile.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NodeDisruptionPolicyStatusFile is a file entry and corresponding actions to take and is used in the NodeDisruptionPolicyClusterStatus object
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public NodeDisruptionPolicyStatusFile(List<NodeDisruptionPolicyStatusAction> act
         this.path = path;
     }
 
+    /**
+     * actions represents the series of commands to be executed on changes to the file at the corresponding file path. Actions will be applied in the order that they are set in this list. If there are other incoming changes to other MachineConfig entries in the same update that require a reboot, the reboot will supercede these actions. Valid actions are Reboot, Drain, Reload, DaemonReload and None. The Reboot action and the None action cannot be used in conjunction with any of the other actions. This list supports a maximum of 10 entries.
+     */
     @JsonProperty("actions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NodeDisruptionPolicyStatusAction> getActions() {
         return actions;
     }
 
+    /**
+     * actions represents the series of commands to be executed on changes to the file at the corresponding file path. Actions will be applied in the order that they are set in this list. If there are other incoming changes to other MachineConfig entries in the same update that require a reboot, the reboot will supercede these actions. Valid actions are Reboot, Drain, Reload, DaemonReload and None. The Reboot action and the None action cannot be used in conjunction with any of the other actions. This list supports a maximum of 10 entries.
+     */
     @JsonProperty("actions")
     public void setActions(List<NodeDisruptionPolicyStatusAction> actions) {
         this.actions = actions;
     }
 
+    /**
+     * path is the location of a file being managed through a MachineConfig. The Actions in the policy will apply to changes to the file at this path.
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * path is the location of a file being managed through a MachineConfig. The Actions in the policy will apply to changes to the file at this path.
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicyStatusSSHKey.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicyStatusSSHKey.java
index e4d0f8ee7ff..371b1f6eaac 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicyStatusSSHKey.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicyStatusSSHKey.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NodeDisruptionPolicyStatusSSHKey is actions to take for any SSHKey change and is used in the NodeDisruptionPolicyClusterStatus object
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public NodeDisruptionPolicyStatusSSHKey(List<NodeDisruptionPolicyStatusAction> a
         this.actions = actions;
     }
 
+    /**
+     * actions represents the series of commands to be executed on changes to the file at the corresponding file path. Actions will be applied in the order that they are set in this list. If there are other incoming changes to other MachineConfig entries in the same update that require a reboot, the reboot will supercede these actions. Valid actions are Reboot, Drain, Reload, DaemonReload and None. The Reboot action and the None action cannot be used in conjunction with any of the other actions. This list supports a maximum of 10 entries.
+     */
     @JsonProperty("actions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NodeDisruptionPolicyStatusAction> getActions() {
         return actions;
     }
 
+    /**
+     * actions represents the series of commands to be executed on changes to the file at the corresponding file path. Actions will be applied in the order that they are set in this list. If there are other incoming changes to other MachineConfig entries in the same update that require a reboot, the reboot will supercede these actions. Valid actions are Reboot, Drain, Reload, DaemonReload and None. The Reboot action and the None action cannot be used in conjunction with any of the other actions. This list supports a maximum of 10 entries.
+     */
     @JsonProperty("actions")
     public void setActions(List<NodeDisruptionPolicyStatusAction> actions) {
         this.actions = actions;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicyStatusUnit.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicyStatusUnit.java
index cff5420667a..f7cb3b87ea4 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicyStatusUnit.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeDisruptionPolicyStatusUnit.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NodeDisruptionPolicyStatusUnit is a systemd unit name and corresponding actions to take and is used in the NodeDisruptionPolicyClusterStatus object
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public NodeDisruptionPolicyStatusUnit(List<NodeDisruptionPolicyStatusAction> act
         this.name = name;
     }
 
+    /**
+     * actions represents the series of commands to be executed on changes to the file at the corresponding file path. Actions will be applied in the order that they are set in this list. If there are other incoming changes to other MachineConfig entries in the same update that require a reboot, the reboot will supercede these actions. Valid actions are Reboot, Drain, Reload, DaemonReload and None. The Reboot action and the None action cannot be used in conjunction with any of the other actions. This list supports a maximum of 10 entries.
+     */
     @JsonProperty("actions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NodeDisruptionPolicyStatusAction> getActions() {
         return actions;
     }
 
+    /**
+     * actions represents the series of commands to be executed on changes to the file at the corresponding file path. Actions will be applied in the order that they are set in this list. If there are other incoming changes to other MachineConfig entries in the same update that require a reboot, the reboot will supercede these actions. Valid actions are Reboot, Drain, Reload, DaemonReload and None. The Reboot action and the None action cannot be used in conjunction with any of the other actions. This list supports a maximum of 10 entries.
+     */
     @JsonProperty("actions")
     public void setActions(List<NodeDisruptionPolicyStatusAction> actions) {
         this.actions = actions;
     }
 
+    /**
+     * name represents the service name of a systemd service managed through a MachineConfig Actions specified will be applied for changes to the named service. Service names should be of the format ${NAME}${SERVICETYPE} and can up to 255 characters long. ${NAME} must be atleast 1 character long and can only consist of alphabets, digits, ":", "-", "_", ".", and "\". ${SERVICETYPE} must be one of ".service", ".socket", ".device", ".mount", ".automount", ".swap", ".target", ".path", ".timer", ".snapshot", ".slice" or ".scope".
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name represents the service name of a systemd service managed through a MachineConfig Actions specified will be applied for changes to the named service. Service names should be of the format ${NAME}${SERVICETYPE} and can up to 255 characters long. ${NAME} must be atleast 1 character long and can only consist of alphabets, digits, ":", "-", "_", ".", and "\". ${SERVICETYPE} must be one of ".service", ".socket", ".device", ".mount", ".automount", ".swap", ".target", ".path", ".timer", ".snapshot", ".slice" or ".scope".
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodePlacement.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodePlacement.java
index a93be62c551..15e2c214ef5 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodePlacement.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodePlacement.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NodePlacement describes node scheduling configuration for an ingress controller.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,22 +89,34 @@ public NodePlacement(LabelSelector nodeSelector, List<Toleration> tolerations) {
         this.tolerations = tolerations;
     }
 
+    /**
+     * NodePlacement describes node scheduling configuration for an ingress controller.
+     */
     @JsonProperty("nodeSelector")
     public LabelSelector getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * NodePlacement describes node scheduling configuration for an ingress controller.
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(LabelSelector nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * tolerations is a list of tolerations applied to ingress controller deployments.<br><p> <br><p> The default is an empty list.<br><p> <br><p> See https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * tolerations is a list of tolerations applied to ingress controller deployments.<br><p> <br><p> The default is an empty list.<br><p> <br><p> See https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodePortStrategy.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodePortStrategy.java
index ae7101c9ad7..66837f313ca 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodePortStrategy.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodePortStrategy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NodePortStrategy holds parameters for the NodePortService endpoint publishing strategy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public NodePortStrategy(String protocol) {
         this.protocol = protocol;
     }
 
+    /**
+     * protocol specifies whether the IngressController expects incoming connections to use plain TCP or whether the IngressController expects PROXY protocol.<br><p> <br><p> PROXY protocol can be used with load balancers that support it to communicate the source addresses of client connections when forwarding those connections to the IngressController.  Using PROXY protocol enables the IngressController to report those source addresses instead of reporting the load balancer's address in HTTP headers and logs.  Note that enabling PROXY protocol on the IngressController will cause connections to fail if you are not using a load balancer that uses PROXY protocol to forward connections to the IngressController.  See http://www.haproxy.org/download/2.2/doc/proxy-protocol.txt for information about PROXY protocol.<br><p> <br><p> The following values are valid for this field:<br><p> <br><p> &#42; The empty string. &#42; "TCP". &#42; "PROXY".<br><p> <br><p> The empty string specifies the default, which is TCP without PROXY protocol.  Note that the default is subject to change.
+     */
     @JsonProperty("protocol")
     public String getProtocol() {
         return protocol;
     }
 
+    /**
+     * protocol specifies whether the IngressController expects incoming connections to use plain TCP or whether the IngressController expects PROXY protocol.<br><p> <br><p> PROXY protocol can be used with load balancers that support it to communicate the source addresses of client connections when forwarding those connections to the IngressController.  Using PROXY protocol enables the IngressController to report those source addresses instead of reporting the load balancer's address in HTTP headers and logs.  Note that enabling PROXY protocol on the IngressController will cause connections to fail if you are not using a load balancer that uses PROXY protocol to forward connections to the IngressController.  See http://www.haproxy.org/download/2.2/doc/proxy-protocol.txt for information about PROXY protocol.<br><p> <br><p> The following values are valid for this field:<br><p> <br><p> &#42; The empty string. &#42; "TCP". &#42; "PROXY".<br><p> <br><p> The empty string specifies the default, which is TCP without PROXY protocol.  Note that the default is subject to change.
+     */
     @JsonProperty("protocol")
     public void setProtocol(String protocol) {
         this.protocol = protocol;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeStatus.java
index 54fb7bada94..07d69560293 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/NodeStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NodeStatus provides information about the current state of a particular node managed by this operator.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -113,92 +116,146 @@ public NodeStatus(Integer currentRevision, Integer lastFailedCount, String lastF
         this.targetRevision = targetRevision;
     }
 
+    /**
+     * currentRevision is the generation of the most recently successful deployment
+     */
     @JsonProperty("currentRevision")
     public Integer getCurrentRevision() {
         return currentRevision;
     }
 
+    /**
+     * currentRevision is the generation of the most recently successful deployment
+     */
     @JsonProperty("currentRevision")
     public void setCurrentRevision(Integer currentRevision) {
         this.currentRevision = currentRevision;
     }
 
+    /**
+     * lastFailedCount is how often the installer pod of the last failed revision failed.
+     */
     @JsonProperty("lastFailedCount")
     public Integer getLastFailedCount() {
         return lastFailedCount;
     }
 
+    /**
+     * lastFailedCount is how often the installer pod of the last failed revision failed.
+     */
     @JsonProperty("lastFailedCount")
     public void setLastFailedCount(Integer lastFailedCount) {
         this.lastFailedCount = lastFailedCount;
     }
 
+    /**
+     * lastFailedReason is a machine readable failure reason string.
+     */
     @JsonProperty("lastFailedReason")
     public String getLastFailedReason() {
         return lastFailedReason;
     }
 
+    /**
+     * lastFailedReason is a machine readable failure reason string.
+     */
     @JsonProperty("lastFailedReason")
     public void setLastFailedReason(String lastFailedReason) {
         this.lastFailedReason = lastFailedReason;
     }
 
+    /**
+     * lastFailedRevision is the generation of the deployment we tried and failed to deploy.
+     */
     @JsonProperty("lastFailedRevision")
     public Integer getLastFailedRevision() {
         return lastFailedRevision;
     }
 
+    /**
+     * lastFailedRevision is the generation of the deployment we tried and failed to deploy.
+     */
     @JsonProperty("lastFailedRevision")
     public void setLastFailedRevision(Integer lastFailedRevision) {
         this.lastFailedRevision = lastFailedRevision;
     }
 
+    /**
+     * lastFailedRevisionErrors is a list of human readable errors during the failed deployment referenced in lastFailedRevision.
+     */
     @JsonProperty("lastFailedRevisionErrors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getLastFailedRevisionErrors() {
         return lastFailedRevisionErrors;
     }
 
+    /**
+     * lastFailedRevisionErrors is a list of human readable errors during the failed deployment referenced in lastFailedRevision.
+     */
     @JsonProperty("lastFailedRevisionErrors")
     public void setLastFailedRevisionErrors(List<String> lastFailedRevisionErrors) {
         this.lastFailedRevisionErrors = lastFailedRevisionErrors;
     }
 
+    /**
+     * NodeStatus provides information about the current state of a particular node managed by this operator.
+     */
     @JsonProperty("lastFailedTime")
     public String getLastFailedTime() {
         return lastFailedTime;
     }
 
+    /**
+     * NodeStatus provides information about the current state of a particular node managed by this operator.
+     */
     @JsonProperty("lastFailedTime")
     public void setLastFailedTime(String lastFailedTime) {
         this.lastFailedTime = lastFailedTime;
     }
 
+    /**
+     * lastFallbackCount is how often a fallback to a previous revision happened.
+     */
     @JsonProperty("lastFallbackCount")
     public Integer getLastFallbackCount() {
         return lastFallbackCount;
     }
 
+    /**
+     * lastFallbackCount is how often a fallback to a previous revision happened.
+     */
     @JsonProperty("lastFallbackCount")
     public void setLastFallbackCount(Integer lastFallbackCount) {
         this.lastFallbackCount = lastFallbackCount;
     }
 
+    /**
+     * nodeName is the name of the node
+     */
     @JsonProperty("nodeName")
     public String getNodeName() {
         return nodeName;
     }
 
+    /**
+     * nodeName is the name of the node
+     */
     @JsonProperty("nodeName")
     public void setNodeName(String nodeName) {
         this.nodeName = nodeName;
     }
 
+    /**
+     * targetRevision is the generation of the deployment we're trying to apply
+     */
     @JsonProperty("targetRevision")
     public Integer getTargetRevision() {
         return targetRevision;
     }
 
+    /**
+     * targetRevision is the generation of the deployment we're trying to apply
+     */
     @JsonProperty("targetRevision")
     public void setTargetRevision(Integer targetRevision) {
         this.targetRevision = targetRevision;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OAuthAPIServerStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OAuthAPIServerStatus.java
index 2c7685cf272..7d92f87ba4c 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OAuthAPIServerStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OAuthAPIServerStatus.java
@@ -78,11 +78,17 @@ public OAuthAPIServerStatus(Integer latestAvailableRevision) {
         this.latestAvailableRevision = latestAvailableRevision;
     }
 
+    /**
+     * LatestAvailableRevision is the latest revision used as suffix of revisioned secrets like encryption-config. A new revision causes a new deployment of pods.
+     */
     @JsonProperty("latestAvailableRevision")
     public Integer getLatestAvailableRevision() {
         return latestAvailableRevision;
     }
 
+    /**
+     * LatestAvailableRevision is the latest revision used as suffix of revisioned secrets like encryption-config. A new revision causes a new deployment of pods.
+     */
     @JsonProperty("latestAvailableRevision")
     public void setLatestAvailableRevision(Integer latestAvailableRevision) {
         this.latestAvailableRevision = latestAvailableRevision;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OVNKubernetesConfig.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OVNKubernetesConfig.java
index 1b4b8ab6228..86680bd8491 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OVNKubernetesConfig.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OVNKubernetesConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ovnKubernetesConfig contains the configuration parameters for networks using the ovn-kubernetes network project
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -122,121 +125,193 @@ public OVNKubernetesConfig(EgressIPConfig egressIPConfig, GatewayConfig gatewayC
         this.v6InternalSubnet = v6InternalSubnet;
     }
 
+    /**
+     * ovnKubernetesConfig contains the configuration parameters for networks using the ovn-kubernetes network project
+     */
     @JsonProperty("egressIPConfig")
     public EgressIPConfig getEgressIPConfig() {
         return egressIPConfig;
     }
 
+    /**
+     * ovnKubernetesConfig contains the configuration parameters for networks using the ovn-kubernetes network project
+     */
     @JsonProperty("egressIPConfig")
     public void setEgressIPConfig(EgressIPConfig egressIPConfig) {
         this.egressIPConfig = egressIPConfig;
     }
 
+    /**
+     * ovnKubernetesConfig contains the configuration parameters for networks using the ovn-kubernetes network project
+     */
     @JsonProperty("gatewayConfig")
     public GatewayConfig getGatewayConfig() {
         return gatewayConfig;
     }
 
+    /**
+     * ovnKubernetesConfig contains the configuration parameters for networks using the ovn-kubernetes network project
+     */
     @JsonProperty("gatewayConfig")
     public void setGatewayConfig(GatewayConfig gatewayConfig) {
         this.gatewayConfig = gatewayConfig;
     }
 
+    /**
+     * geneve port is the UDP port to be used by geneve encapulation. Default is 6081
+     */
     @JsonProperty("genevePort")
     public Long getGenevePort() {
         return genevePort;
     }
 
+    /**
+     * geneve port is the UDP port to be used by geneve encapulation. Default is 6081
+     */
     @JsonProperty("genevePort")
     public void setGenevePort(Long genevePort) {
         this.genevePort = genevePort;
     }
 
+    /**
+     * ovnKubernetesConfig contains the configuration parameters for networks using the ovn-kubernetes network project
+     */
     @JsonProperty("hybridOverlayConfig")
     public HybridOverlayConfig getHybridOverlayConfig() {
         return hybridOverlayConfig;
     }
 
+    /**
+     * ovnKubernetesConfig contains the configuration parameters for networks using the ovn-kubernetes network project
+     */
     @JsonProperty("hybridOverlayConfig")
     public void setHybridOverlayConfig(HybridOverlayConfig hybridOverlayConfig) {
         this.hybridOverlayConfig = hybridOverlayConfig;
     }
 
+    /**
+     * ovnKubernetesConfig contains the configuration parameters for networks using the ovn-kubernetes network project
+     */
     @JsonProperty("ipsecConfig")
     public IPsecConfig getIpsecConfig() {
         return ipsecConfig;
     }
 
+    /**
+     * ovnKubernetesConfig contains the configuration parameters for networks using the ovn-kubernetes network project
+     */
     @JsonProperty("ipsecConfig")
     public void setIpsecConfig(IPsecConfig ipsecConfig) {
         this.ipsecConfig = ipsecConfig;
     }
 
+    /**
+     * ovnKubernetesConfig contains the configuration parameters for networks using the ovn-kubernetes network project
+     */
     @JsonProperty("ipv4")
     public IPv4OVNKubernetesConfig getIpv4() {
         return ipv4;
     }
 
+    /**
+     * ovnKubernetesConfig contains the configuration parameters for networks using the ovn-kubernetes network project
+     */
     @JsonProperty("ipv4")
     public void setIpv4(IPv4OVNKubernetesConfig ipv4) {
         this.ipv4 = ipv4;
     }
 
+    /**
+     * ovnKubernetesConfig contains the configuration parameters for networks using the ovn-kubernetes network project
+     */
     @JsonProperty("ipv6")
     public IPv6OVNKubernetesConfig getIpv6() {
         return ipv6;
     }
 
+    /**
+     * ovnKubernetesConfig contains the configuration parameters for networks using the ovn-kubernetes network project
+     */
     @JsonProperty("ipv6")
     public void setIpv6(IPv6OVNKubernetesConfig ipv6) {
         this.ipv6 = ipv6;
     }
 
+    /**
+     * mtu is the MTU to use for the tunnel interface. This must be 100 bytes smaller than the uplink mtu. Default is 1400
+     */
     @JsonProperty("mtu")
     public Long getMtu() {
         return mtu;
     }
 
+    /**
+     * mtu is the MTU to use for the tunnel interface. This must be 100 bytes smaller than the uplink mtu. Default is 1400
+     */
     @JsonProperty("mtu")
     public void setMtu(Long mtu) {
         this.mtu = mtu;
     }
 
+    /**
+     * ovnKubernetesConfig contains the configuration parameters for networks using the ovn-kubernetes network project
+     */
     @JsonProperty("policyAuditConfig")
     public PolicyAuditConfig getPolicyAuditConfig() {
         return policyAuditConfig;
     }
 
+    /**
+     * ovnKubernetesConfig contains the configuration parameters for networks using the ovn-kubernetes network project
+     */
     @JsonProperty("policyAuditConfig")
     public void setPolicyAuditConfig(PolicyAuditConfig policyAuditConfig) {
         this.policyAuditConfig = policyAuditConfig;
     }
 
+    /**
+     * routeAdvertisements determines if the functionality to advertise cluster network routes through a dynamic routing protocol, such as BGP, is enabled or not. This functionality is configured through the ovn-kubernetes RouteAdvertisements CRD. Requires the 'FRR' routing capability provider to be enabled as an additional routing capability. Allowed values are "Enabled", "Disabled" and ommited. When omitted, this means the user has no opinion and the platform is left to choose reasonable defaults. These defaults are subject to change over time. The current default is "Disabled".
+     */
     @JsonProperty("routeAdvertisements")
     public String getRouteAdvertisements() {
         return routeAdvertisements;
     }
 
+    /**
+     * routeAdvertisements determines if the functionality to advertise cluster network routes through a dynamic routing protocol, such as BGP, is enabled or not. This functionality is configured through the ovn-kubernetes RouteAdvertisements CRD. Requires the 'FRR' routing capability provider to be enabled as an additional routing capability. Allowed values are "Enabled", "Disabled" and ommited. When omitted, this means the user has no opinion and the platform is left to choose reasonable defaults. These defaults are subject to change over time. The current default is "Disabled".
+     */
     @JsonProperty("routeAdvertisements")
     public void setRouteAdvertisements(String routeAdvertisements) {
         this.routeAdvertisements = routeAdvertisements;
     }
 
+    /**
+     * v4InternalSubnet is a v4 subnet used internally by ovn-kubernetes in case the default one is being already used by something else. It must not overlap with any other subnet being used by OpenShift or by the node network. The size of the subnet must be larger than the number of nodes. The value cannot be changed after installation. Default is 100.64.0.0/16
+     */
     @JsonProperty("v4InternalSubnet")
     public String getV4InternalSubnet() {
         return v4InternalSubnet;
     }
 
+    /**
+     * v4InternalSubnet is a v4 subnet used internally by ovn-kubernetes in case the default one is being already used by something else. It must not overlap with any other subnet being used by OpenShift or by the node network. The size of the subnet must be larger than the number of nodes. The value cannot be changed after installation. Default is 100.64.0.0/16
+     */
     @JsonProperty("v4InternalSubnet")
     public void setV4InternalSubnet(String v4InternalSubnet) {
         this.v4InternalSubnet = v4InternalSubnet;
     }
 
+    /**
+     * v6InternalSubnet is a v6 subnet used internally by ovn-kubernetes in case the default one is being already used by something else. It must not overlap with any other subnet being used by OpenShift or by the node network. The size of the subnet must be larger than the number of nodes. The value cannot be changed after installation. Default is fd98::/48
+     */
     @JsonProperty("v6InternalSubnet")
     public String getV6InternalSubnet() {
         return v6InternalSubnet;
     }
 
+    /**
+     * v6InternalSubnet is a v6 subnet used internally by ovn-kubernetes in case the default one is being already used by something else. It must not overlap with any other subnet being used by OpenShift or by the node network. The size of the subnet must be larger than the number of nodes. The value cannot be changed after installation. Default is fd98::/48
+     */
     @JsonProperty("v6InternalSubnet")
     public void setV6InternalSubnet(String v6InternalSubnet) {
         this.v6InternalSubnet = v6InternalSubnet;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftAPIServer.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftAPIServer.java
index 70e0daf3574..12975920c14 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftAPIServer.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftAPIServer.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OpenShiftAPIServer provides information to configure an operator to manage openshift-apiserver.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class OpenShiftAPIServer implements Editable<OpenShiftAPIServerBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OpenShiftAPIServer";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public OpenShiftAPIServer(String apiVersion, String kind, ObjectMeta metadata, O
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OpenShiftAPIServer provides information to configure an operator to manage openshift-apiserver.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OpenShiftAPIServer provides information to configure an operator to manage openshift-apiserver.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * OpenShiftAPIServer provides information to configure an operator to manage openshift-apiserver.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public OpenShiftAPIServerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * OpenShiftAPIServer provides information to configure an operator to manage openshift-apiserver.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(OpenShiftAPIServerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * OpenShiftAPIServer provides information to configure an operator to manage openshift-apiserver.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public OpenShiftAPIServerStatus getStatus() {
         return status;
     }
 
+    /**
+     * OpenShiftAPIServer provides information to configure an operator to manage openshift-apiserver.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(OpenShiftAPIServerStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftAPIServerList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftAPIServerList.java
index 1703b2d2499..e4fb24de0f9 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftAPIServerList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftAPIServerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OpenShiftAPIServerList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class OpenShiftAPIServerList implements Editable<OpenShiftAPIServerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.v1.OpenShiftAPIServer>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.v1.OpenShiftAPIServer> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OpenShiftAPIServerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public OpenShiftAPIServerList(String apiVersion, List<io.fabric8.openshift.api.m
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items contains the items
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.v1.OpenShiftAPIServer> getItems() {
         return items;
     }
 
+    /**
+     * Items contains the items
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.v1.OpenShiftAPIServer> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OpenShiftAPIServerList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OpenShiftAPIServerList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftAPIServerSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftAPIServerSpec.java
index 14aaf4fd1ed..bade51d5b51 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftAPIServerSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftAPIServerSpec.java
@@ -96,21 +96,33 @@ public OpenShiftAPIServerSpec(String logLevel, String managementState, Object ob
         this.unsupportedConfigOverrides = unsupportedConfigOverrides;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
@@ -127,11 +139,17 @@ public void setObservedConfig(Object observedConfig) {
         this.observedConfig = observedConfig;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public String getOperatorLogLevel() {
         return operatorLogLevel;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public void setOperatorLogLevel(String operatorLogLevel) {
         this.operatorLogLevel = operatorLogLevel;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftAPIServerStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftAPIServerStatus.java
index 8709207b348..ae52b3b34a6 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftAPIServerStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftAPIServerStatus.java
@@ -102,63 +102,99 @@ public OpenShiftAPIServerStatus(List<OperatorCondition> conditions, List<Generat
         this.version = version;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenerationStatus> getGenerations() {
         return generations;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     public void setGenerations(List<GenerationStatus> generations) {
         this.generations = generations;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public Integer getLatestAvailableRevision() {
         return latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public void setLatestAvailableRevision(Integer latestAvailableRevision) {
         this.latestAvailableRevision = latestAvailableRevision;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftControllerManager.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftControllerManager.java
index 8443b49e5bf..cdd78d6aaab 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftControllerManager.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftControllerManager.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OpenShiftControllerManager provides information to configure an operator to manage openshift-controller-manager.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class OpenShiftControllerManager implements Editable<OpenShiftControllerManagerBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OpenShiftControllerManager";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public OpenShiftControllerManager(String apiVersion, String kind, ObjectMeta met
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OpenShiftControllerManager provides information to configure an operator to manage openshift-controller-manager.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OpenShiftControllerManager provides information to configure an operator to manage openshift-controller-manager.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * OpenShiftControllerManager provides information to configure an operator to manage openshift-controller-manager.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public OpenShiftControllerManagerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * OpenShiftControllerManager provides information to configure an operator to manage openshift-controller-manager.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(OpenShiftControllerManagerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * OpenShiftControllerManager provides information to configure an operator to manage openshift-controller-manager.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public OpenShiftControllerManagerStatus getStatus() {
         return status;
     }
 
+    /**
+     * OpenShiftControllerManager provides information to configure an operator to manage openshift-controller-manager.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(OpenShiftControllerManagerStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftControllerManagerList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftControllerManagerList.java
index cf4729a82fb..fd1f3381370 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftControllerManagerList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftControllerManagerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OpenShiftControllerManagerList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class OpenShiftControllerManagerList implements Editable<OpenShiftControllerManagerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.v1.OpenShiftControllerManager>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.v1.OpenShiftControllerManager> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OpenShiftControllerManagerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public OpenShiftControllerManagerList(String apiVersion, List<io.fabric8.openshi
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items contains the items
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.v1.OpenShiftControllerManager> getItems() {
         return items;
     }
 
+    /**
+     * Items contains the items
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.v1.OpenShiftControllerManager> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OpenShiftControllerManagerList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OpenShiftControllerManagerList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftControllerManagerSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftControllerManagerSpec.java
index 454b3ce661e..cbca4e58f9c 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftControllerManagerSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftControllerManagerSpec.java
@@ -96,21 +96,33 @@ public OpenShiftControllerManagerSpec(String logLevel, String managementState, O
         this.unsupportedConfigOverrides = unsupportedConfigOverrides;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
@@ -127,11 +139,17 @@ public void setObservedConfig(Object observedConfig) {
         this.observedConfig = observedConfig;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public String getOperatorLogLevel() {
         return operatorLogLevel;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public void setOperatorLogLevel(String operatorLogLevel) {
         this.operatorLogLevel = operatorLogLevel;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftControllerManagerStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftControllerManagerStatus.java
index 81a10b5c0b2..d5a7158a9e8 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftControllerManagerStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftControllerManagerStatus.java
@@ -102,63 +102,99 @@ public OpenShiftControllerManagerStatus(List<OperatorCondition> conditions, List
         this.version = version;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenerationStatus> getGenerations() {
         return generations;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     public void setGenerations(List<GenerationStatus> generations) {
         this.generations = generations;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public Integer getLatestAvailableRevision() {
         return latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public void setLatestAvailableRevision(Integer latestAvailableRevision) {
         this.latestAvailableRevision = latestAvailableRevision;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftSDNConfig.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftSDNConfig.java
index 8022feabb7c..e5f9c463f14 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftSDNConfig.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OpenShiftSDNConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OpenShiftSDNConfig was used to configure the OpenShift SDN plugin. It is no longer used.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public OpenShiftSDNConfig(Boolean enableUnidling, String mode, Long mtu, Boolean
         this.vxlanPort = vxlanPort;
     }
 
+    /**
+     * enableUnidling controls whether or not the service proxy will support idling and unidling of services. By default, unidling is enabled.
+     */
     @JsonProperty("enableUnidling")
     public Boolean getEnableUnidling() {
         return enableUnidling;
     }
 
+    /**
+     * enableUnidling controls whether or not the service proxy will support idling and unidling of services. By default, unidling is enabled.
+     */
     @JsonProperty("enableUnidling")
     public void setEnableUnidling(Boolean enableUnidling) {
         this.enableUnidling = enableUnidling;
     }
 
+    /**
+     * mode is one of "Multitenant", "Subnet", or "NetworkPolicy"
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * mode is one of "Multitenant", "Subnet", or "NetworkPolicy"
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
     }
 
+    /**
+     * mtu is the mtu to use for the tunnel interface. Defaults to 1450 if unset. This must be 50 bytes smaller than the machine's uplink.
+     */
     @JsonProperty("mtu")
     public Long getMtu() {
         return mtu;
     }
 
+    /**
+     * mtu is the mtu to use for the tunnel interface. Defaults to 1450 if unset. This must be 50 bytes smaller than the machine's uplink.
+     */
     @JsonProperty("mtu")
     public void setMtu(Long mtu) {
         this.mtu = mtu;
     }
 
+    /**
+     * useExternalOpenvswitch used to control whether the operator would deploy an OVS DaemonSet itself or expect someone else to start OVS. As of 4.6, OVS is always run as a system service, and this flag is ignored.
+     */
     @JsonProperty("useExternalOpenvswitch")
     public Boolean getUseExternalOpenvswitch() {
         return useExternalOpenvswitch;
     }
 
+    /**
+     * useExternalOpenvswitch used to control whether the operator would deploy an OVS DaemonSet itself or expect someone else to start OVS. As of 4.6, OVS is always run as a system service, and this flag is ignored.
+     */
     @JsonProperty("useExternalOpenvswitch")
     public void setUseExternalOpenvswitch(Boolean useExternalOpenvswitch) {
         this.useExternalOpenvswitch = useExternalOpenvswitch;
     }
 
+    /**
+     * vxlanPort is the port to use for all vxlan packets. The default is 4789.
+     */
     @JsonProperty("vxlanPort")
     public Long getVxlanPort() {
         return vxlanPort;
     }
 
+    /**
+     * vxlanPort is the port to use for all vxlan packets. The default is 4789.
+     */
     @JsonProperty("vxlanPort")
     public void setVxlanPort(Long vxlanPort) {
         this.vxlanPort = vxlanPort;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OperatorCondition.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OperatorCondition.java
index f55f7240c0c..08dd4adfd02 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OperatorCondition.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OperatorCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorCondition is just the standard condition fields.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public OperatorCondition(String lastTransitionTime, String message, String reaso
         this.type = type;
     }
 
+    /**
+     * OperatorCondition is just the standard condition fields.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * OperatorCondition is just the standard condition fields.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * OperatorCondition is just the standard condition fields.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * OperatorCondition is just the standard condition fields.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * OperatorCondition is just the standard condition fields.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * OperatorCondition is just the standard condition fields.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * OperatorCondition is just the standard condition fields.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * OperatorCondition is just the standard condition fields.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * OperatorCondition is just the standard condition fields.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * OperatorCondition is just the standard condition fields.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OperatorSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OperatorSpec.java
index e6d840a47b0..e876272a736 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OperatorSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OperatorSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorSpec contains common fields operators need.  It is intended to be anonymous included inside of the Spec struct for your particular operator.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -96,52 +99,82 @@ public OperatorSpec(String logLevel, String managementState, Object observedConf
         this.unsupportedConfigOverrides = unsupportedConfigOverrides;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
     }
 
+    /**
+     * OperatorSpec contains common fields operators need.  It is intended to be anonymous included inside of the Spec struct for your particular operator.
+     */
     @JsonProperty("observedConfig")
     public Object getObservedConfig() {
         return observedConfig;
     }
 
+    /**
+     * OperatorSpec contains common fields operators need.  It is intended to be anonymous included inside of the Spec struct for your particular operator.
+     */
     @JsonProperty("observedConfig")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setObservedConfig(Object observedConfig) {
         this.observedConfig = observedConfig;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public String getOperatorLogLevel() {
         return operatorLogLevel;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public void setOperatorLogLevel(String operatorLogLevel) {
         this.operatorLogLevel = operatorLogLevel;
     }
 
+    /**
+     * OperatorSpec contains common fields operators need.  It is intended to be anonymous included inside of the Spec struct for your particular operator.
+     */
     @JsonProperty("unsupportedConfigOverrides")
     public Object getUnsupportedConfigOverrides() {
         return unsupportedConfigOverrides;
     }
 
+    /**
+     * OperatorSpec contains common fields operators need.  It is intended to be anonymous included inside of the Spec struct for your particular operator.
+     */
     @JsonProperty("unsupportedConfigOverrides")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setUnsupportedConfigOverrides(Object unsupportedConfigOverrides) {
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OperatorStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OperatorStatus.java
index 061c1cf8896..4d762850c71 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OperatorStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/OperatorStatus.java
@@ -102,63 +102,99 @@ public OperatorStatus(List<OperatorCondition> conditions, List<GenerationStatus>
         this.version = version;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenerationStatus> getGenerations() {
         return generations;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     public void setGenerations(List<GenerationStatus> generations) {
         this.generations = generations;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public Integer getLatestAvailableRevision() {
         return latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public void setLatestAvailableRevision(Integer latestAvailableRevision) {
         this.latestAvailableRevision = latestAvailableRevision;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/PartialSelector.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/PartialSelector.java
index a00f0049f71..71c9ed29fbe 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/PartialSelector.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/PartialSelector.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PartialSelector provides label selector(s) that can be used to match machine management resources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public PartialSelector(LabelSelector machineResourceSelector) {
         this.machineResourceSelector = machineResourceSelector;
     }
 
+    /**
+     * PartialSelector provides label selector(s) that can be used to match machine management resources.
+     */
     @JsonProperty("machineResourceSelector")
     public LabelSelector getMachineResourceSelector() {
         return machineResourceSelector;
     }
 
+    /**
+     * PartialSelector provides label selector(s) that can be used to match machine management resources.
+     */
     @JsonProperty("machineResourceSelector")
     public void setMachineResourceSelector(LabelSelector machineResourceSelector) {
         this.machineResourceSelector = machineResourceSelector;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Perspective.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Perspective.java
index c16d2b19223..4d7f184526e 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Perspective.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Perspective.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Perspective defines a perspective that cluster admins want to show/hide in the perspective switcher dropdown
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public Perspective(String id, List<PinnedResourceReference> pinnedResources, Per
         this.visibility = visibility;
     }
 
+    /**
+     * id defines the id of the perspective. Example: "dev", "admin". The available perspective ids can be found in the code snippet section next to the yaml editor. Incorrect or unknown ids will be ignored.
+     */
     @JsonProperty("id")
     public String getId() {
         return id;
     }
 
+    /**
+     * id defines the id of the perspective. Example: "dev", "admin". The available perspective ids can be found in the code snippet section next to the yaml editor. Incorrect or unknown ids will be ignored.
+     */
     @JsonProperty("id")
     public void setId(String id) {
         this.id = id;
     }
 
+    /**
+     * pinnedResources defines the list of default pinned resources that users will see on the perspective navigation if they have not customized these pinned resources themselves. The list of available Kubernetes resources could be read via `kubectl api-resources`. The console will also provide a configuration UI and a YAML snippet that will list the available resources that can be pinned to the navigation. Incorrect or unknown resources will be ignored.
+     */
     @JsonProperty("pinnedResources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PinnedResourceReference> getPinnedResources() {
         return pinnedResources;
     }
 
+    /**
+     * pinnedResources defines the list of default pinned resources that users will see on the perspective navigation if they have not customized these pinned resources themselves. The list of available Kubernetes resources could be read via `kubectl api-resources`. The console will also provide a configuration UI and a YAML snippet that will list the available resources that can be pinned to the navigation. Incorrect or unknown resources will be ignored.
+     */
     @JsonProperty("pinnedResources")
     public void setPinnedResources(List<PinnedResourceReference> pinnedResources) {
         this.pinnedResources = pinnedResources;
     }
 
+    /**
+     * Perspective defines a perspective that cluster admins want to show/hide in the perspective switcher dropdown
+     */
     @JsonProperty("visibility")
     public PerspectiveVisibility getVisibility() {
         return visibility;
     }
 
+    /**
+     * Perspective defines a perspective that cluster admins want to show/hide in the perspective switcher dropdown
+     */
     @JsonProperty("visibility")
     public void setVisibility(PerspectiveVisibility visibility) {
         this.visibility = visibility;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/PerspectiveVisibility.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/PerspectiveVisibility.java
index 36ee1066722..a433948008b 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/PerspectiveVisibility.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/PerspectiveVisibility.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PerspectiveVisibility defines the criteria to show/hide a perspective
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public PerspectiveVisibility(ResourceAttributesAccessReview accessReview, String
         this.state = state;
     }
 
+    /**
+     * PerspectiveVisibility defines the criteria to show/hide a perspective
+     */
     @JsonProperty("accessReview")
     public ResourceAttributesAccessReview getAccessReview() {
         return accessReview;
     }
 
+    /**
+     * PerspectiveVisibility defines the criteria to show/hide a perspective
+     */
     @JsonProperty("accessReview")
     public void setAccessReview(ResourceAttributesAccessReview accessReview) {
         this.accessReview = accessReview;
     }
 
+    /**
+     * state defines the perspective is enabled or disabled or access review check is required.
+     */
     @JsonProperty("state")
     public String getState() {
         return state;
     }
 
+    /**
+     * state defines the perspective is enabled or disabled or access review check is required.
+     */
     @JsonProperty("state")
     public void setState(String state) {
         this.state = state;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/PinnedResourceReference.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/PinnedResourceReference.java
index 5000c4f9e98..a5f1f6082d9 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/PinnedResourceReference.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/PinnedResourceReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PinnedResourceReference includes the group, version and type of resource
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public PinnedResourceReference(String group, String resource, String version) {
         this.version = version;
     }
 
+    /**
+     * group is the API Group of the Resource. Enter empty string for the core group. This value should consist of only lowercase alphanumeric characters, hyphens and periods. Example: "", "apps", "build.openshift.io", etc.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * group is the API Group of the Resource. Enter empty string for the core group. This value should consist of only lowercase alphanumeric characters, hyphens and periods. Example: "", "apps", "build.openshift.io", etc.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * resource is the type that is being referenced. It is normally the plural form of the resource kind in lowercase. This value should consist of only lowercase alphanumeric characters and hyphens. Example: "deployments", "deploymentconfigs", "pods", etc.
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * resource is the type that is being referenced. It is normally the plural form of the resource kind in lowercase. This value should consist of only lowercase alphanumeric characters and hyphens. Example: "deployments", "deploymentconfigs", "pods", etc.
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
     }
 
+    /**
+     * version is the API Version of the Resource. This value should consist of only lowercase alphanumeric characters. Example: "v1", "v1beta1", etc.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the API Version of the Resource. This value should consist of only lowercase alphanumeric characters. Example: "v1", "v1beta1", etc.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/PolicyAuditConfig.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/PolicyAuditConfig.java
index 5fbeae688ec..a80b6fa0400 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/PolicyAuditConfig.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/PolicyAuditConfig.java
@@ -94,51 +94,81 @@ public PolicyAuditConfig(String destination, Long maxFileSize, Integer maxLogFil
         this.syslogFacility = syslogFacility;
     }
 
+    /**
+     * destination is the location for policy log messages. Regardless of this config, persistent logs will always be dumped to the host at /var/log/ovn/ however Additionally syslog output may be configured as follows. Valid values are: - "libc" -&gt; to use the libc syslog() function of the host node's journdald process - "udp:host:port" -&gt; for sending syslog over UDP - "unix:file" -&gt; for using the UNIX domain socket directly - "null" -&gt; to discard all messages logged to syslog The default is "null"
+     */
     @JsonProperty("destination")
     public String getDestination() {
         return destination;
     }
 
+    /**
+     * destination is the location for policy log messages. Regardless of this config, persistent logs will always be dumped to the host at /var/log/ovn/ however Additionally syslog output may be configured as follows. Valid values are: - "libc" -&gt; to use the libc syslog() function of the host node's journdald process - "udp:host:port" -&gt; for sending syslog over UDP - "unix:file" -&gt; for using the UNIX domain socket directly - "null" -&gt; to discard all messages logged to syslog The default is "null"
+     */
     @JsonProperty("destination")
     public void setDestination(String destination) {
         this.destination = destination;
     }
 
+    /**
+     * maxFilesSize is the max size an ACL_audit log file is allowed to reach before rotation occurs Units are in MB and the Default is 50MB
+     */
     @JsonProperty("maxFileSize")
     public Long getMaxFileSize() {
         return maxFileSize;
     }
 
+    /**
+     * maxFilesSize is the max size an ACL_audit log file is allowed to reach before rotation occurs Units are in MB and the Default is 50MB
+     */
     @JsonProperty("maxFileSize")
     public void setMaxFileSize(Long maxFileSize) {
         this.maxFileSize = maxFileSize;
     }
 
+    /**
+     * maxLogFiles specifies the maximum number of ACL_audit log files that can be present.
+     */
     @JsonProperty("maxLogFiles")
     public Integer getMaxLogFiles() {
         return maxLogFiles;
     }
 
+    /**
+     * maxLogFiles specifies the maximum number of ACL_audit log files that can be present.
+     */
     @JsonProperty("maxLogFiles")
     public void setMaxLogFiles(Integer maxLogFiles) {
         this.maxLogFiles = maxLogFiles;
     }
 
+    /**
+     * rateLimit is the approximate maximum number of messages to generate per-second per-node. If unset the default of 20 msg/sec is used.
+     */
     @JsonProperty("rateLimit")
     public Long getRateLimit() {
         return rateLimit;
     }
 
+    /**
+     * rateLimit is the approximate maximum number of messages to generate per-second per-node. If unset the default of 20 msg/sec is used.
+     */
     @JsonProperty("rateLimit")
     public void setRateLimit(Long rateLimit) {
         this.rateLimit = rateLimit;
     }
 
+    /**
+     * syslogFacility the RFC5424 facility for generated messages, e.g. "kern". Default is "local0"
+     */
     @JsonProperty("syslogFacility")
     public String getSyslogFacility() {
         return syslogFacility;
     }
 
+    /**
+     * syslogFacility the RFC5424 facility for generated messages, e.g. "kern". Default is "local0"
+     */
     @JsonProperty("syslogFacility")
     public void setSyslogFacility(String syslogFacility) {
         this.syslogFacility = syslogFacility;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/PrivateStrategy.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/PrivateStrategy.java
index 0f95e05763b..ab2aabc0a7b 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/PrivateStrategy.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/PrivateStrategy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PrivateStrategy holds parameters for the Private endpoint publishing strategy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public PrivateStrategy(String protocol) {
         this.protocol = protocol;
     }
 
+    /**
+     * protocol specifies whether the IngressController expects incoming connections to use plain TCP or whether the IngressController expects PROXY protocol.<br><p> <br><p> PROXY protocol can be used with load balancers that support it to communicate the source addresses of client connections when forwarding those connections to the IngressController.  Using PROXY protocol enables the IngressController to report those source addresses instead of reporting the load balancer's address in HTTP headers and logs.  Note that enabling PROXY protocol on the IngressController will cause connections to fail if you are not using a load balancer that uses PROXY protocol to forward connections to the IngressController.  See http://www.haproxy.org/download/2.2/doc/proxy-protocol.txt for information about PROXY protocol.<br><p> <br><p> The following values are valid for this field:<br><p> <br><p> &#42; The empty string. &#42; "TCP". &#42; "PROXY".<br><p> <br><p> The empty string specifies the default, which is TCP without PROXY protocol.  Note that the default is subject to change.
+     */
     @JsonProperty("protocol")
     public String getProtocol() {
         return protocol;
     }
 
+    /**
+     * protocol specifies whether the IngressController expects incoming connections to use plain TCP or whether the IngressController expects PROXY protocol.<br><p> <br><p> PROXY protocol can be used with load balancers that support it to communicate the source addresses of client connections when forwarding those connections to the IngressController.  Using PROXY protocol enables the IngressController to report those source addresses instead of reporting the load balancer's address in HTTP headers and logs.  Note that enabling PROXY protocol on the IngressController will cause connections to fail if you are not using a load balancer that uses PROXY protocol to forward connections to the IngressController.  See http://www.haproxy.org/download/2.2/doc/proxy-protocol.txt for information about PROXY protocol.<br><p> <br><p> The following values are valid for this field:<br><p> <br><p> &#42; The empty string. &#42; "TCP". &#42; "PROXY".<br><p> <br><p> The empty string specifies the default, which is TCP without PROXY protocol.  Note that the default is subject to change.
+     */
     @JsonProperty("protocol")
     public void setProtocol(String protocol) {
         this.protocol = protocol;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ProjectAccess.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ProjectAccess.java
index 0213fa7a49e..700e418f35c 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ProjectAccess.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ProjectAccess.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ProjectAccess contains options for project access roles
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public ProjectAccess(List<String> availableClusterRoles) {
         this.availableClusterRoles = availableClusterRoles;
     }
 
+    /**
+     * availableClusterRoles is the list of ClusterRole names that are assignable to users through the project access tab.
+     */
     @JsonProperty("availableClusterRoles")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAvailableClusterRoles() {
         return availableClusterRoles;
     }
 
+    /**
+     * availableClusterRoles is the list of ClusterRole names that are assignable to users through the project access tab.
+     */
     @JsonProperty("availableClusterRoles")
     public void setAvailableClusterRoles(List<String> availableClusterRoles) {
         this.availableClusterRoles = availableClusterRoles;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ProviderLoadBalancerParameters.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ProviderLoadBalancerParameters.java
index c9ddcca3491..08502b0c800 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ProviderLoadBalancerParameters.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ProviderLoadBalancerParameters.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ProviderLoadBalancerParameters holds desired load balancer information specific to the underlying infrastructure provider.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ProviderLoadBalancerParameters(AWSLoadBalancerParameters aws, GCPLoadBala
         this.type = type;
     }
 
+    /**
+     * ProviderLoadBalancerParameters holds desired load balancer information specific to the underlying infrastructure provider.
+     */
     @JsonProperty("aws")
     public AWSLoadBalancerParameters getAws() {
         return aws;
     }
 
+    /**
+     * ProviderLoadBalancerParameters holds desired load balancer information specific to the underlying infrastructure provider.
+     */
     @JsonProperty("aws")
     public void setAws(AWSLoadBalancerParameters aws) {
         this.aws = aws;
     }
 
+    /**
+     * ProviderLoadBalancerParameters holds desired load balancer information specific to the underlying infrastructure provider.
+     */
     @JsonProperty("gcp")
     public GCPLoadBalancerParameters getGcp() {
         return gcp;
     }
 
+    /**
+     * ProviderLoadBalancerParameters holds desired load balancer information specific to the underlying infrastructure provider.
+     */
     @JsonProperty("gcp")
     public void setGcp(GCPLoadBalancerParameters gcp) {
         this.gcp = gcp;
     }
 
+    /**
+     * ProviderLoadBalancerParameters holds desired load balancer information specific to the underlying infrastructure provider.
+     */
     @JsonProperty("ibm")
     public IBMLoadBalancerParameters getIbm() {
         return ibm;
     }
 
+    /**
+     * ProviderLoadBalancerParameters holds desired load balancer information specific to the underlying infrastructure provider.
+     */
     @JsonProperty("ibm")
     public void setIbm(IBMLoadBalancerParameters ibm) {
         this.ibm = ibm;
     }
 
+    /**
+     * type is the underlying infrastructure provider for the load balancer. Allowed values are "AWS", "Azure", "BareMetal", "GCP", "IBM", "Nutanix", "OpenStack", and "VSphere".
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the underlying infrastructure provider for the load balancer. Allowed values are "AWS", "Azure", "BareMetal", "GCP", "IBM", "Nutanix", "OpenStack", and "VSphere".
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ProxyConfig.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ProxyConfig.java
index d52ce9e234a..15bcae79ac3 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ProxyConfig.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ProxyConfig.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ProxyConfig defines the configuration knobs for kubeproxy All of these are optional and have sensible defaults
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -88,32 +91,50 @@ public ProxyConfig(String bindAddress, String iptablesSyncPeriod, Map<String, Li
         this.proxyArguments = proxyArguments;
     }
 
+    /**
+     * The address to "bind" on Defaults to 0.0.0.0
+     */
     @JsonProperty("bindAddress")
     public String getBindAddress() {
         return bindAddress;
     }
 
+    /**
+     * The address to "bind" on Defaults to 0.0.0.0
+     */
     @JsonProperty("bindAddress")
     public void setBindAddress(String bindAddress) {
         this.bindAddress = bindAddress;
     }
 
+    /**
+     * An internal kube-proxy parameter. In older releases of OCP, this sometimes needed to be adjusted in large clusters for performance reasons, but this is no longer necessary, and there is no reason to change this from the default value. Default: 30s
+     */
     @JsonProperty("iptablesSyncPeriod")
     public String getIptablesSyncPeriod() {
         return iptablesSyncPeriod;
     }
 
+    /**
+     * An internal kube-proxy parameter. In older releases of OCP, this sometimes needed to be adjusted in large clusters for performance reasons, but this is no longer necessary, and there is no reason to change this from the default value. Default: 30s
+     */
     @JsonProperty("iptablesSyncPeriod")
     public void setIptablesSyncPeriod(String iptablesSyncPeriod) {
         this.iptablesSyncPeriod = iptablesSyncPeriod;
     }
 
+    /**
+     * Any additional arguments to pass to the kubeproxy process
+     */
     @JsonProperty("proxyArguments")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<String>> getProxyArguments() {
         return proxyArguments;
     }
 
+    /**
+     * Any additional arguments to pass to the kubeproxy process
+     */
     @JsonProperty("proxyArguments")
     public void setProxyArguments(Map<String, List<String>> proxyArguments) {
         this.proxyArguments = proxyArguments;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/QuickStarts.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/QuickStarts.java
index b1d204a077f..01565a186fd 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/QuickStarts.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/QuickStarts.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * QuickStarts allow cluster admins to customize available ConsoleQuickStart resources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public QuickStarts(List<String> disabled) {
         this.disabled = disabled;
     }
 
+    /**
+     * disabled is a list of ConsoleQuickStart resource names that are not shown to users.
+     */
     @JsonProperty("disabled")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDisabled() {
         return disabled;
     }
 
+    /**
+     * disabled is a list of ConsoleQuickStart resource names that are not shown to users.
+     */
     @JsonProperty("disabled")
     public void setDisabled(List<String> disabled) {
         this.disabled = disabled;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ReloadService.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ReloadService.java
index a0202c713a4..00ffd3a7d03 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ReloadService.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ReloadService.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ReloadService allows the user to specify the services to be reloaded
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ReloadService(String serviceName) {
         this.serviceName = serviceName;
     }
 
+    /**
+     * serviceName is the full name (e.g. crio.service) of the service to be reloaded Service names should be of the format ${NAME}${SERVICETYPE} and can up to 255 characters long. ${NAME} must be atleast 1 character long and can only consist of alphabets, digits, ":", "-", "_", ".", and "\". ${SERVICETYPE} must be one of ".service", ".socket", ".device", ".mount", ".automount", ".swap", ".target", ".path", ".timer", ".snapshot", ".slice" or ".scope".
+     */
     @JsonProperty("serviceName")
     public String getServiceName() {
         return serviceName;
     }
 
+    /**
+     * serviceName is the full name (e.g. crio.service) of the service to be reloaded Service names should be of the format ${NAME}${SERVICETYPE} and can up to 255 characters long. ${NAME} must be atleast 1 character long and can only consist of alphabets, digits, ":", "-", "_", ".", and "\". ${SERVICETYPE} must be one of ".service", ".socket", ".device", ".mount", ".automount", ".swap", ".target", ".path", ".timer", ".snapshot", ".slice" or ".scope".
+     */
     @JsonProperty("serviceName")
     public void setServiceName(String serviceName) {
         this.serviceName = serviceName;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ResourceAttributesAccessReview.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ResourceAttributesAccessReview.java
index 1665f384bd0..e742e16af9b 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ResourceAttributesAccessReview.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ResourceAttributesAccessReview.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceAttributesAccessReview defines the visibility of the perspective depending on the access review checks. `required` and  `missing` can work together esp. in the case where the cluster admin wants to show another perspective to users without specific permissions. Out of `required` and `missing` atleast one property should be non-empty.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,23 +90,35 @@ public ResourceAttributesAccessReview(List<ResourceAttributes> missing, List<Res
         this.required = required;
     }
 
+    /**
+     * missing defines a list of permission checks. The perspective will only be shown when at least one check fails. When omitted, the access review is skipped and the perspective will not be shown unless it is required to do so based on the configuration of the required access review list.
+     */
     @JsonProperty("missing")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ResourceAttributes> getMissing() {
         return missing;
     }
 
+    /**
+     * missing defines a list of permission checks. The perspective will only be shown when at least one check fails. When omitted, the access review is skipped and the perspective will not be shown unless it is required to do so based on the configuration of the required access review list.
+     */
     @JsonProperty("missing")
     public void setMissing(List<ResourceAttributes> missing) {
         this.missing = missing;
     }
 
+    /**
+     * required defines a list of permission checks. The perspective will only be shown when all checks are successful. When omitted, the access review is skipped and the perspective will not be shown unless it is required to do so based on the configuration of the missing access review list.
+     */
     @JsonProperty("required")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ResourceAttributes> getRequired() {
         return required;
     }
 
+    /**
+     * required defines a list of permission checks. The perspective will only be shown when all checks are successful. When omitted, the access review is skipped and the perspective will not be shown unless it is required to do so based on the configuration of the missing access review list.
+     */
     @JsonProperty("required")
     public void setRequired(List<ResourceAttributes> required) {
         this.required = required;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/RestartService.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/RestartService.java
index 3671890946b..7943d435096 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/RestartService.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/RestartService.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RestartService allows the user to specify the services to be restarted
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public RestartService(String serviceName) {
         this.serviceName = serviceName;
     }
 
+    /**
+     * serviceName is the full name (e.g. crio.service) of the service to be restarted Service names should be of the format ${NAME}${SERVICETYPE} and can up to 255 characters long. ${NAME} must be atleast 1 character long and can only consist of alphabets, digits, ":", "-", "_", ".", and "\". ${SERVICETYPE} must be one of ".service", ".socket", ".device", ".mount", ".automount", ".swap", ".target", ".path", ".timer", ".snapshot", ".slice" or ".scope".
+     */
     @JsonProperty("serviceName")
     public String getServiceName() {
         return serviceName;
     }
 
+    /**
+     * serviceName is the full name (e.g. crio.service) of the service to be restarted Service names should be of the format ${NAME}${SERVICETYPE} and can up to 255 characters long. ${NAME} must be atleast 1 character long and can only consist of alphabets, digits, ":", "-", "_", ".", and "\". ${SERVICETYPE} must be one of ".service", ".socket", ".device", ".mount", ".automount", ".swap", ".target", ".path", ".timer", ".snapshot", ".slice" or ".scope".
+     */
     @JsonProperty("serviceName")
     public void setServiceName(String serviceName) {
         this.serviceName = serviceName;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/RouteAdmissionPolicy.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/RouteAdmissionPolicy.java
index 960fe2d3784..100074498c5 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/RouteAdmissionPolicy.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/RouteAdmissionPolicy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RouteAdmissionPolicy is an admission policy for allowing new route claims.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public RouteAdmissionPolicy(String namespaceOwnership, String wildcardPolicy) {
         this.wildcardPolicy = wildcardPolicy;
     }
 
+    /**
+     * namespaceOwnership describes how host name claims across namespaces should be handled.<br><p> <br><p> Value must be one of:<br><p> <br><p> - Strict: Do not allow routes in different namespaces to claim the same host.<br><p> <br><p> - InterNamespaceAllowed: Allow routes to claim different paths of the same<br><p>   host name across namespaces.<br><p> <br><p> If empty, the default is Strict.
+     */
     @JsonProperty("namespaceOwnership")
     public String getNamespaceOwnership() {
         return namespaceOwnership;
     }
 
+    /**
+     * namespaceOwnership describes how host name claims across namespaces should be handled.<br><p> <br><p> Value must be one of:<br><p> <br><p> - Strict: Do not allow routes in different namespaces to claim the same host.<br><p> <br><p> - InterNamespaceAllowed: Allow routes to claim different paths of the same<br><p>   host name across namespaces.<br><p> <br><p> If empty, the default is Strict.
+     */
     @JsonProperty("namespaceOwnership")
     public void setNamespaceOwnership(String namespaceOwnership) {
         this.namespaceOwnership = namespaceOwnership;
     }
 
+    /**
+     * wildcardPolicy describes how routes with wildcard policies should be handled for the ingress controller. WildcardPolicy controls use of routes [1] exposed by the ingress controller based on the route's wildcard policy.<br><p> <br><p> [1] https://github.com/openshift/api/blob/master/route/v1/types.go<br><p> <br><p> Note: Updating WildcardPolicy from WildcardsAllowed to WildcardsDisallowed will cause admitted routes with a wildcard policy of Subdomain to stop working. These routes must be updated to a wildcard policy of None to be readmitted by the ingress controller.<br><p> <br><p> WildcardPolicy supports WildcardsAllowed and WildcardsDisallowed values.<br><p> <br><p> If empty, defaults to "WildcardsDisallowed".
+     */
     @JsonProperty("wildcardPolicy")
     public String getWildcardPolicy() {
         return wildcardPolicy;
     }
 
+    /**
+     * wildcardPolicy describes how routes with wildcard policies should be handled for the ingress controller. WildcardPolicy controls use of routes [1] exposed by the ingress controller based on the route's wildcard policy.<br><p> <br><p> [1] https://github.com/openshift/api/blob/master/route/v1/types.go<br><p> <br><p> Note: Updating WildcardPolicy from WildcardsAllowed to WildcardsDisallowed will cause admitted routes with a wildcard policy of Subdomain to stop working. These routes must be updated to a wildcard policy of None to be readmitted by the ingress controller.<br><p> <br><p> WildcardPolicy supports WildcardsAllowed and WildcardsDisallowed values.<br><p> <br><p> If empty, defaults to "WildcardsDisallowed".
+     */
     @JsonProperty("wildcardPolicy")
     public void setWildcardPolicy(String wildcardPolicy) {
         this.wildcardPolicy = wildcardPolicy;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/SFlowConfig.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/SFlowConfig.java
index f9134c07feb..4fca2bc6720 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/SFlowConfig.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/SFlowConfig.java
@@ -81,12 +81,18 @@ public SFlowConfig(List<String> collectors) {
         this.collectors = collectors;
     }
 
+    /**
+     * sFlowCollectors is list of strings formatted as ip:port with a maximum of ten items
+     */
     @JsonProperty("collectors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCollectors() {
         return collectors;
     }
 
+    /**
+     * sFlowCollectors is list of strings formatted as ip:port with a maximum of ten items
+     */
     @JsonProperty("collectors")
     public void setCollectors(List<String> collectors) {
         this.collectors = collectors;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Server.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Server.java
index fdb99e7661b..d31742b801c 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Server.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Server.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Server defines the schema for a server that runs per instance of CoreDNS.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public Server(ForwardPlugin forwardPlugin, String name, List<String> zones) {
         this.zones = zones;
     }
 
+    /**
+     * Server defines the schema for a server that runs per instance of CoreDNS.
+     */
     @JsonProperty("forwardPlugin")
     public ForwardPlugin getForwardPlugin() {
         return forwardPlugin;
     }
 
+    /**
+     * Server defines the schema for a server that runs per instance of CoreDNS.
+     */
     @JsonProperty("forwardPlugin")
     public void setForwardPlugin(ForwardPlugin forwardPlugin) {
         this.forwardPlugin = forwardPlugin;
     }
 
+    /**
+     * name is required and specifies a unique name for the server. Name must comply with the Service Name Syntax of rfc6335.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is required and specifies a unique name for the server. Name must comply with the Service Name Syntax of rfc6335.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * zones is required and specifies the subdomains that Server is authoritative for. Zones must conform to the rfc1123 definition of a subdomain. Specifying the cluster domain (i.e., "cluster.local") is invalid.
+     */
     @JsonProperty("zones")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getZones() {
         return zones;
     }
 
+    /**
+     * zones is required and specifies the subdomains that Server is authoritative for. Zones must conform to the rfc1123 definition of a subdomain. Specifying the cluster domain (i.e., "cluster.local") is invalid.
+     */
     @JsonProperty("zones")
     public void setZones(List<String> zones) {
         this.zones = zones;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceAccountIssuerStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceAccountIssuerStatus.java
index df49bf907ba..4e5193dc2d9 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceAccountIssuerStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceAccountIssuerStatus.java
@@ -92,11 +92,17 @@ public void setExpirationTime(String expirationTime) {
         this.expirationTime = expirationTime;
     }
 
+    /**
+     * name is the name of the service account issuer
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the service account issuer
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCA.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCA.java
index d7e2a7745af..393270b91ff 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCA.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCA.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceCA provides information to configure an operator to manage the service cert controllers<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ServiceCA implements Editable<ServiceCABuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ServiceCA";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public ServiceCA(String apiVersion, String kind, ObjectMeta metadata, ServiceCAS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ServiceCA provides information to configure an operator to manage the service cert controllers<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ServiceCA provides information to configure an operator to manage the service cert controllers<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ServiceCA provides information to configure an operator to manage the service cert controllers<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ServiceCASpec getSpec() {
         return spec;
     }
 
+    /**
+     * ServiceCA provides information to configure an operator to manage the service cert controllers<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ServiceCASpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ServiceCA provides information to configure an operator to manage the service cert controllers<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public ServiceCAStatus getStatus() {
         return status;
     }
 
+    /**
+     * ServiceCA provides information to configure an operator to manage the service cert controllers<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(ServiceCAStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCAList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCAList.java
index 06dda8fe0d6..6f4f59c7f0e 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCAList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCAList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceCAList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ServiceCAList implements Editable<ServiceCAListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.v1.ServiceCA>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.v1.ServiceCA> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ServiceCAList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ServiceCAList(String apiVersion, List<io.fabric8.openshift.api.model.oper
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items contains the items
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.v1.ServiceCA> getItems() {
         return items;
     }
 
+    /**
+     * Items contains the items
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.v1.ServiceCA> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ServiceCAList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ServiceCAList is a collection of items<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCASpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCASpec.java
index 59d56ab1c0b..7bb0d0e6734 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCASpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCASpec.java
@@ -96,21 +96,33 @@ public ServiceCASpec(String logLevel, String managementState, Object observedCon
         this.unsupportedConfigOverrides = unsupportedConfigOverrides;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
@@ -127,11 +139,17 @@ public void setObservedConfig(Object observedConfig) {
         this.observedConfig = observedConfig;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public String getOperatorLogLevel() {
         return operatorLogLevel;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public void setOperatorLogLevel(String operatorLogLevel) {
         this.operatorLogLevel = operatorLogLevel;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCAStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCAStatus.java
index 76cd7ff116b..443072d3a8b 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCAStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCAStatus.java
@@ -102,63 +102,99 @@ public ServiceCAStatus(List<OperatorCondition> conditions, List<GenerationStatus
         this.version = version;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenerationStatus> getGenerations() {
         return generations;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     public void setGenerations(List<GenerationStatus> generations) {
         this.generations = generations;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public Integer getLatestAvailableRevision() {
         return latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public void setLatestAvailableRevision(Integer latestAvailableRevision) {
         this.latestAvailableRevision = latestAvailableRevision;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogAPIServer.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogAPIServer.java
index c82f9481a32..87f58e4b9c9 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogAPIServer.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogAPIServer.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceCatalogAPIServer provides information to configure an operator to manage Service Catalog API Server DEPRECATED: will be removed in 4.6<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ServiceCatalogAPIServer implements Editable<ServiceCatalogAPIServerBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ServiceCatalogAPIServer";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public ServiceCatalogAPIServer(String apiVersion, String kind, ObjectMeta metada
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ServiceCatalogAPIServer provides information to configure an operator to manage Service Catalog API Server DEPRECATED: will be removed in 4.6<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ServiceCatalogAPIServer provides information to configure an operator to manage Service Catalog API Server DEPRECATED: will be removed in 4.6<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ServiceCatalogAPIServer provides information to configure an operator to manage Service Catalog API Server DEPRECATED: will be removed in 4.6<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ServiceCatalogAPIServerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ServiceCatalogAPIServer provides information to configure an operator to manage Service Catalog API Server DEPRECATED: will be removed in 4.6<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ServiceCatalogAPIServerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ServiceCatalogAPIServer provides information to configure an operator to manage Service Catalog API Server DEPRECATED: will be removed in 4.6<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public ServiceCatalogAPIServerStatus getStatus() {
         return status;
     }
 
+    /**
+     * ServiceCatalogAPIServer provides information to configure an operator to manage Service Catalog API Server DEPRECATED: will be removed in 4.6<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(ServiceCatalogAPIServerStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogAPIServerList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogAPIServerList.java
index 3db51d8ee6f..79ca82877a9 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogAPIServerList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogAPIServerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceCatalogAPIServerList is a collection of items DEPRECATED: will be removed in 4.6<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ServiceCatalogAPIServerList implements Editable<ServiceCatalogAPIServerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.v1.ServiceCatalogAPIServer>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.v1.ServiceCatalogAPIServer> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ServiceCatalogAPIServerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ServiceCatalogAPIServerList(String apiVersion, List<io.fabric8.openshift.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items contains the items
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.v1.ServiceCatalogAPIServer> getItems() {
         return items;
     }
 
+    /**
+     * Items contains the items
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.v1.ServiceCatalogAPIServer> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ServiceCatalogAPIServerList is a collection of items DEPRECATED: will be removed in 4.6<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ServiceCatalogAPIServerList is a collection of items DEPRECATED: will be removed in 4.6<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogAPIServerSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogAPIServerSpec.java
index 2f62e4f6cd8..381f0815094 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogAPIServerSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogAPIServerSpec.java
@@ -96,21 +96,33 @@ public ServiceCatalogAPIServerSpec(String logLevel, String managementState, Obje
         this.unsupportedConfigOverrides = unsupportedConfigOverrides;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
@@ -127,11 +139,17 @@ public void setObservedConfig(Object observedConfig) {
         this.observedConfig = observedConfig;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public String getOperatorLogLevel() {
         return operatorLogLevel;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public void setOperatorLogLevel(String operatorLogLevel) {
         this.operatorLogLevel = operatorLogLevel;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogAPIServerStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogAPIServerStatus.java
index 6296ac9f63c..6734a8926c0 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogAPIServerStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogAPIServerStatus.java
@@ -102,63 +102,99 @@ public ServiceCatalogAPIServerStatus(List<OperatorCondition> conditions, List<Ge
         this.version = version;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenerationStatus> getGenerations() {
         return generations;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     public void setGenerations(List<GenerationStatus> generations) {
         this.generations = generations;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public Integer getLatestAvailableRevision() {
         return latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public void setLatestAvailableRevision(Integer latestAvailableRevision) {
         this.latestAvailableRevision = latestAvailableRevision;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogControllerManager.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogControllerManager.java
index 318253b8d65..1aae6bbcce8 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogControllerManager.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogControllerManager.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceCatalogControllerManager provides information to configure an operator to manage Service Catalog Controller Manager DEPRECATED: will be removed in 4.6<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ServiceCatalogControllerManager implements Editable<ServiceCatalogControllerManagerBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ServiceCatalogControllerManager";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public ServiceCatalogControllerManager(String apiVersion, String kind, ObjectMet
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ServiceCatalogControllerManager provides information to configure an operator to manage Service Catalog Controller Manager DEPRECATED: will be removed in 4.6<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ServiceCatalogControllerManager provides information to configure an operator to manage Service Catalog Controller Manager DEPRECATED: will be removed in 4.6<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ServiceCatalogControllerManager provides information to configure an operator to manage Service Catalog Controller Manager DEPRECATED: will be removed in 4.6<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ServiceCatalogControllerManagerSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ServiceCatalogControllerManager provides information to configure an operator to manage Service Catalog Controller Manager DEPRECATED: will be removed in 4.6<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ServiceCatalogControllerManagerSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ServiceCatalogControllerManager provides information to configure an operator to manage Service Catalog Controller Manager DEPRECATED: will be removed in 4.6<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public ServiceCatalogControllerManagerStatus getStatus() {
         return status;
     }
 
+    /**
+     * ServiceCatalogControllerManager provides information to configure an operator to manage Service Catalog Controller Manager DEPRECATED: will be removed in 4.6<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(ServiceCatalogControllerManagerStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogControllerManagerList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogControllerManagerList.java
index 5d6dc78f973..10193cf556d 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogControllerManagerList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogControllerManagerList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceCatalogControllerManagerList is a collection of items DEPRECATED: will be removed in 4.6<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ServiceCatalogControllerManagerList implements Editable<ServiceCatalogControllerManagerListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.v1.ServiceCatalogControllerManager>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.v1.ServiceCatalogControllerManager> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ServiceCatalogControllerManagerList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ServiceCatalogControllerManagerList(String apiVersion, List<io.fabric8.op
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items contains the items
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.v1.ServiceCatalogControllerManager> getItems() {
         return items;
     }
 
+    /**
+     * Items contains the items
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.v1.ServiceCatalogControllerManager> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ServiceCatalogControllerManagerList is a collection of items DEPRECATED: will be removed in 4.6<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ServiceCatalogControllerManagerList is a collection of items DEPRECATED: will be removed in 4.6<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogControllerManagerSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogControllerManagerSpec.java
index d55bdfe225a..bff83d47632 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogControllerManagerSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogControllerManagerSpec.java
@@ -96,21 +96,33 @@ public ServiceCatalogControllerManagerSpec(String logLevel, String managementSta
         this.unsupportedConfigOverrides = unsupportedConfigOverrides;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
@@ -127,11 +139,17 @@ public void setObservedConfig(Object observedConfig) {
         this.observedConfig = observedConfig;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public String getOperatorLogLevel() {
         return operatorLogLevel;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public void setOperatorLogLevel(String operatorLogLevel) {
         this.operatorLogLevel = operatorLogLevel;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogControllerManagerStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogControllerManagerStatus.java
index 00ad7027ffa..20fb0c3d1b2 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogControllerManagerStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/ServiceCatalogControllerManagerStatus.java
@@ -102,63 +102,99 @@ public ServiceCatalogControllerManagerStatus(List<OperatorCondition> conditions,
         this.version = version;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenerationStatus> getGenerations() {
         return generations;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     public void setGenerations(List<GenerationStatus> generations) {
         this.generations = generations;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public Integer getLatestAvailableRevision() {
         return latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public void setLatestAvailableRevision(Integer latestAvailableRevision) {
         this.latestAvailableRevision = latestAvailableRevision;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/SimpleMacvlanConfig.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/SimpleMacvlanConfig.java
index fccb687fcc5..0d9b9eb3eae 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/SimpleMacvlanConfig.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/SimpleMacvlanConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SimpleMacvlanConfig contains configurations for macvlan interface.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public SimpleMacvlanConfig(IPAMConfig ipamConfig, String master, String mode, Lo
         this.mtu = mtu;
     }
 
+    /**
+     * SimpleMacvlanConfig contains configurations for macvlan interface.
+     */
     @JsonProperty("ipamConfig")
     public IPAMConfig getIpamConfig() {
         return ipamConfig;
     }
 
+    /**
+     * SimpleMacvlanConfig contains configurations for macvlan interface.
+     */
     @JsonProperty("ipamConfig")
     public void setIpamConfig(IPAMConfig ipamConfig) {
         this.ipamConfig = ipamConfig;
     }
 
+    /**
+     * master is the host interface to create the macvlan interface from. If not specified, it will be default route interface
+     */
     @JsonProperty("master")
     public String getMaster() {
         return master;
     }
 
+    /**
+     * master is the host interface to create the macvlan interface from. If not specified, it will be default route interface
+     */
     @JsonProperty("master")
     public void setMaster(String master) {
         this.master = master;
     }
 
+    /**
+     * mode is the macvlan mode: bridge, private, vepa, passthru. The default is bridge
+     */
     @JsonProperty("mode")
     public String getMode() {
         return mode;
     }
 
+    /**
+     * mode is the macvlan mode: bridge, private, vepa, passthru. The default is bridge
+     */
     @JsonProperty("mode")
     public void setMode(String mode) {
         this.mode = mode;
     }
 
+    /**
+     * mtu is the mtu to use for the macvlan interface. if unset, host's kernel will select the value.
+     */
     @JsonProperty("mtu")
     public Long getMtu() {
         return mtu;
     }
 
+    /**
+     * mtu is the mtu to use for the macvlan interface. if unset, host's kernel will select the value.
+     */
     @JsonProperty("mtu")
     public void setMtu(Long mtu) {
         this.mtu = mtu;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StaticIPAMAddresses.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StaticIPAMAddresses.java
index 4bbe0aba4c6..5b1fe2a8eba 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StaticIPAMAddresses.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StaticIPAMAddresses.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StaticIPAMAddresses provides IP address and Gateway for static IPAM addresses
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public StaticIPAMAddresses(String address, String gateway) {
         this.gateway = gateway;
     }
 
+    /**
+     * Address is the IP address in CIDR format
+     */
     @JsonProperty("address")
     public String getAddress() {
         return address;
     }
 
+    /**
+     * Address is the IP address in CIDR format
+     */
     @JsonProperty("address")
     public void setAddress(String address) {
         this.address = address;
     }
 
+    /**
+     * Gateway is IP inside of subnet to designate as the gateway
+     */
     @JsonProperty("gateway")
     public String getGateway() {
         return gateway;
     }
 
+    /**
+     * Gateway is IP inside of subnet to designate as the gateway
+     */
     @JsonProperty("gateway")
     public void setGateway(String gateway) {
         this.gateway = gateway;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StaticIPAMConfig.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StaticIPAMConfig.java
index e5fd77aa7f2..8e21219586f 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StaticIPAMConfig.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StaticIPAMConfig.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StaticIPAMConfig contains configurations for static IPAM (IP Address Management)
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public StaticIPAMConfig(List<StaticIPAMAddresses> addresses, StaticIPAMDNS dns,
         this.routes = routes;
     }
 
+    /**
+     * Addresses configures IP address for the interface
+     */
     @JsonProperty("addresses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<StaticIPAMAddresses> getAddresses() {
         return addresses;
     }
 
+    /**
+     * Addresses configures IP address for the interface
+     */
     @JsonProperty("addresses")
     public void setAddresses(List<StaticIPAMAddresses> addresses) {
         this.addresses = addresses;
     }
 
+    /**
+     * StaticIPAMConfig contains configurations for static IPAM (IP Address Management)
+     */
     @JsonProperty("dns")
     public StaticIPAMDNS getDns() {
         return dns;
     }
 
+    /**
+     * StaticIPAMConfig contains configurations for static IPAM (IP Address Management)
+     */
     @JsonProperty("dns")
     public void setDns(StaticIPAMDNS dns) {
         this.dns = dns;
     }
 
+    /**
+     * Routes configures IP routes for the interface
+     */
     @JsonProperty("routes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<StaticIPAMRoutes> getRoutes() {
         return routes;
     }
 
+    /**
+     * Routes configures IP routes for the interface
+     */
     @JsonProperty("routes")
     public void setRoutes(List<StaticIPAMRoutes> routes) {
         this.routes = routes;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StaticIPAMDNS.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StaticIPAMDNS.java
index fefb3c5be44..b9824ec739c 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StaticIPAMDNS.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StaticIPAMDNS.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StaticIPAMDNS provides DNS related information for static IPAM
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public StaticIPAMDNS(String domain, List<String> nameservers, List<String> searc
         this.search = search;
     }
 
+    /**
+     * Domain configures the domainname the local domain used for short hostname lookups
+     */
     @JsonProperty("domain")
     public String getDomain() {
         return domain;
     }
 
+    /**
+     * Domain configures the domainname the local domain used for short hostname lookups
+     */
     @JsonProperty("domain")
     public void setDomain(String domain) {
         this.domain = domain;
     }
 
+    /**
+     * Nameservers points DNS servers for IP lookup
+     */
     @JsonProperty("nameservers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNameservers() {
         return nameservers;
     }
 
+    /**
+     * Nameservers points DNS servers for IP lookup
+     */
     @JsonProperty("nameservers")
     public void setNameservers(List<String> nameservers) {
         this.nameservers = nameservers;
     }
 
+    /**
+     * Search configures priority ordered search domains for short hostname lookups
+     */
     @JsonProperty("search")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSearch() {
         return search;
     }
 
+    /**
+     * Search configures priority ordered search domains for short hostname lookups
+     */
     @JsonProperty("search")
     public void setSearch(List<String> search) {
         this.search = search;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StaticIPAMRoutes.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StaticIPAMRoutes.java
index e5c4a3fea60..11073c977fe 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StaticIPAMRoutes.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StaticIPAMRoutes.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StaticIPAMRoutes provides Destination/Gateway pairs for static IPAM routes
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public StaticIPAMRoutes(String destination, String gateway) {
         this.gateway = gateway;
     }
 
+    /**
+     * Destination points the IP route destination
+     */
     @JsonProperty("destination")
     public String getDestination() {
         return destination;
     }
 
+    /**
+     * Destination points the IP route destination
+     */
     @JsonProperty("destination")
     public void setDestination(String destination) {
         this.destination = destination;
     }
 
+    /**
+     * Gateway is the route's next-hop IP address If unset, a default gateway is assumed (as determined by the CNI plugin).
+     */
     @JsonProperty("gateway")
     public String getGateway() {
         return gateway;
     }
 
+    /**
+     * Gateway is the route's next-hop IP address If unset, a default gateway is assumed (as determined by the CNI plugin).
+     */
     @JsonProperty("gateway")
     public void setGateway(String gateway) {
         this.gateway = gateway;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StaticPodOperatorSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StaticPodOperatorSpec.java
index 5a37a011a08..5e747e528d2 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StaticPodOperatorSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StaticPodOperatorSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StaticPodOperatorSpec is spec for controllers that manage static pods.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -108,82 +111,130 @@ public StaticPodOperatorSpec(Integer failedRevisionLimit, String forceRedeployme
         this.unsupportedConfigOverrides = unsupportedConfigOverrides;
     }
 
+    /**
+     * failedRevisionLimit is the number of failed static pod installer revisions to keep on disk and in the api -1 = unlimited, 0 or unset = 5 (default)
+     */
     @JsonProperty("failedRevisionLimit")
     public Integer getFailedRevisionLimit() {
         return failedRevisionLimit;
     }
 
+    /**
+     * failedRevisionLimit is the number of failed static pod installer revisions to keep on disk and in the api -1 = unlimited, 0 or unset = 5 (default)
+     */
     @JsonProperty("failedRevisionLimit")
     public void setFailedRevisionLimit(Integer failedRevisionLimit) {
         this.failedRevisionLimit = failedRevisionLimit;
     }
 
+    /**
+     * forceRedeploymentReason can be used to force the redeployment of the operand by providing a unique string. This provides a mechanism to kick a previously failed deployment and provide a reason why you think it will work this time instead of failing again on the same config.
+     */
     @JsonProperty("forceRedeploymentReason")
     public String getForceRedeploymentReason() {
         return forceRedeploymentReason;
     }
 
+    /**
+     * forceRedeploymentReason can be used to force the redeployment of the operand by providing a unique string. This provides a mechanism to kick a previously failed deployment and provide a reason why you think it will work this time instead of failing again on the same config.
+     */
     @JsonProperty("forceRedeploymentReason")
     public void setForceRedeploymentReason(String forceRedeploymentReason) {
         this.forceRedeploymentReason = forceRedeploymentReason;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
     }
 
+    /**
+     * StaticPodOperatorSpec is spec for controllers that manage static pods.
+     */
     @JsonProperty("observedConfig")
     public Object getObservedConfig() {
         return observedConfig;
     }
 
+    /**
+     * StaticPodOperatorSpec is spec for controllers that manage static pods.
+     */
     @JsonProperty("observedConfig")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setObservedConfig(Object observedConfig) {
         this.observedConfig = observedConfig;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public String getOperatorLogLevel() {
         return operatorLogLevel;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public void setOperatorLogLevel(String operatorLogLevel) {
         this.operatorLogLevel = operatorLogLevel;
     }
 
+    /**
+     * succeededRevisionLimit is the number of successful static pod installer revisions to keep on disk and in the api -1 = unlimited, 0 or unset = 5 (default)
+     */
     @JsonProperty("succeededRevisionLimit")
     public Integer getSucceededRevisionLimit() {
         return succeededRevisionLimit;
     }
 
+    /**
+     * succeededRevisionLimit is the number of successful static pod installer revisions to keep on disk and in the api -1 = unlimited, 0 or unset = 5 (default)
+     */
     @JsonProperty("succeededRevisionLimit")
     public void setSucceededRevisionLimit(Integer succeededRevisionLimit) {
         this.succeededRevisionLimit = succeededRevisionLimit;
     }
 
+    /**
+     * StaticPodOperatorSpec is spec for controllers that manage static pods.
+     */
     @JsonProperty("unsupportedConfigOverrides")
     public Object getUnsupportedConfigOverrides() {
         return unsupportedConfigOverrides;
     }
 
+    /**
+     * StaticPodOperatorSpec is spec for controllers that manage static pods.
+     */
     @JsonProperty("unsupportedConfigOverrides")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setUnsupportedConfigOverrides(Object unsupportedConfigOverrides) {
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StaticPodOperatorStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StaticPodOperatorStatus.java
index 51db39810a6..e78d1b71d5f 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StaticPodOperatorStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StaticPodOperatorStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StaticPodOperatorStatus is status for controllers that manage static pods.  There are different needs because individual node status must be tracked.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -111,84 +114,132 @@ public StaticPodOperatorStatus(List<OperatorCondition> conditions, List<Generati
         this.version = version;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenerationStatus> getGenerations() {
         return generations;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     public void setGenerations(List<GenerationStatus> generations) {
         this.generations = generations;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public Integer getLatestAvailableRevision() {
         return latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public void setLatestAvailableRevision(Integer latestAvailableRevision) {
         this.latestAvailableRevision = latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevisionReason describe the detailed reason for the most recent deployment
+     */
     @JsonProperty("latestAvailableRevisionReason")
     public String getLatestAvailableRevisionReason() {
         return latestAvailableRevisionReason;
     }
 
+    /**
+     * latestAvailableRevisionReason describe the detailed reason for the most recent deployment
+     */
     @JsonProperty("latestAvailableRevisionReason")
     public void setLatestAvailableRevisionReason(String latestAvailableRevisionReason) {
         this.latestAvailableRevisionReason = latestAvailableRevisionReason;
     }
 
+    /**
+     * nodeStatuses track the deployment values and errors across individual nodes
+     */
     @JsonProperty("nodeStatuses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NodeStatus> getNodeStatuses() {
         return nodeStatuses;
     }
 
+    /**
+     * nodeStatuses track the deployment values and errors across individual nodes
+     */
     @JsonProperty("nodeStatuses")
     public void setNodeStatuses(List<NodeStatus> nodeStatuses) {
         this.nodeStatuses = nodeStatuses;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StatuspageProvider.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StatuspageProvider.java
index 789b3bc88ee..c305f95038f 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StatuspageProvider.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StatuspageProvider.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StatuspageProvider provides identity for statuspage account.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public StatuspageProvider(String pageID) {
         this.pageID = pageID;
     }
 
+    /**
+     * pageID is the unique ID assigned by Statuspage for your page. This must be a public page.
+     */
     @JsonProperty("pageID")
     public String getPageID() {
         return pageID;
     }
 
+    /**
+     * pageID is the unique ID assigned by Statuspage for your page. This must be a public page.
+     */
     @JsonProperty("pageID")
     public void setPageID(String pageID) {
         this.pageID = pageID;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Storage.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Storage.java
index 51b81910ea7..5e537c979ae 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Storage.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Storage.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Storage provides a means to configure an operator to manage the cluster storage operator. `cluster` is the canonical name.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Storage implements Editable<StorageBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Storage";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public Storage(String apiVersion, String kind, ObjectMeta metadata, StorageSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Storage provides a means to configure an operator to manage the cluster storage operator. `cluster` is the canonical name.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Storage provides a means to configure an operator to manage the cluster storage operator. `cluster` is the canonical name.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Storage provides a means to configure an operator to manage the cluster storage operator. `cluster` is the canonical name.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public StorageSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Storage provides a means to configure an operator to manage the cluster storage operator. `cluster` is the canonical name.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(StorageSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Storage provides a means to configure an operator to manage the cluster storage operator. `cluster` is the canonical name.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public StorageStatus getStatus() {
         return status;
     }
 
+    /**
+     * Storage provides a means to configure an operator to manage the cluster storage operator. `cluster` is the canonical name.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(StorageStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StorageList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StorageList.java
index bd814d5f9ed..f0ea5775f4e 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StorageList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StorageList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StorageList contains a list of Storages.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class StorageList implements Editable<StorageListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.v1.Storage>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.v1.Storage> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "StorageList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public StorageList(String apiVersion, List<io.fabric8.openshift.api.model.operat
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * StorageList contains a list of Storages.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.v1.Storage> getItems() {
         return items;
     }
 
+    /**
+     * StorageList contains a list of Storages.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.v1.Storage> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * StorageList contains a list of Storages.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * StorageList contains a list of Storages.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StorageSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StorageSpec.java
index cd8caa731de..5514b0ed2e9 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StorageSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StorageSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StorageSpec is the specification of the desired behavior of the cluster storage operator.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -100,63 +103,99 @@ public StorageSpec(String logLevel, String managementState, Object observedConfi
         this.vsphereStorageDriver = vsphereStorageDriver;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
     }
 
+    /**
+     * StorageSpec is the specification of the desired behavior of the cluster storage operator.
+     */
     @JsonProperty("observedConfig")
     public Object getObservedConfig() {
         return observedConfig;
     }
 
+    /**
+     * StorageSpec is the specification of the desired behavior of the cluster storage operator.
+     */
     @JsonProperty("observedConfig")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setObservedConfig(Object observedConfig) {
         this.observedConfig = observedConfig;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public String getOperatorLogLevel() {
         return operatorLogLevel;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public void setOperatorLogLevel(String operatorLogLevel) {
         this.operatorLogLevel = operatorLogLevel;
     }
 
+    /**
+     * StorageSpec is the specification of the desired behavior of the cluster storage operator.
+     */
     @JsonProperty("unsupportedConfigOverrides")
     public Object getUnsupportedConfigOverrides() {
         return unsupportedConfigOverrides;
     }
 
+    /**
+     * StorageSpec is the specification of the desired behavior of the cluster storage operator.
+     */
     @JsonProperty("unsupportedConfigOverrides")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setUnsupportedConfigOverrides(Object unsupportedConfigOverrides) {
         this.unsupportedConfigOverrides = unsupportedConfigOverrides;
     }
 
+    /**
+     * VSphereStorageDriver indicates the storage driver to use on VSphere clusters. Once this field is set to CSIWithMigrationDriver, it can not be changed. If this is empty, the platform will choose a good default, which may change over time without notice. The current default is CSIWithMigrationDriver and may not be changed. DEPRECATED: This field will be removed in a future release.
+     */
     @JsonProperty("vsphereStorageDriver")
     public String getVsphereStorageDriver() {
         return vsphereStorageDriver;
     }
 
+    /**
+     * VSphereStorageDriver indicates the storage driver to use on VSphere clusters. Once this field is set to CSIWithMigrationDriver, it can not be changed. If this is empty, the platform will choose a good default, which may change over time without notice. The current default is CSIWithMigrationDriver and may not be changed. DEPRECATED: This field will be removed in a future release.
+     */
     @JsonProperty("vsphereStorageDriver")
     public void setVsphereStorageDriver(String vsphereStorageDriver) {
         this.vsphereStorageDriver = vsphereStorageDriver;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StorageStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StorageStatus.java
index c431e406a38..45032eed3bb 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StorageStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/StorageStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StorageStatus defines the observed status of the cluster storage operator.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,63 +105,99 @@ public StorageStatus(List<OperatorCondition> conditions, List<GenerationStatus>
         this.version = version;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenerationStatus> getGenerations() {
         return generations;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     public void setGenerations(List<GenerationStatus> generations) {
         this.generations = generations;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public Integer getLatestAvailableRevision() {
         return latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public void setLatestAvailableRevision(Integer latestAvailableRevision) {
         this.latestAvailableRevision = latestAvailableRevision;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/SyslogLoggingDestinationParameters.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/SyslogLoggingDestinationParameters.java
index 097367261d3..0d2556e9ead 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/SyslogLoggingDestinationParameters.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/SyslogLoggingDestinationParameters.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SyslogLoggingDestinationParameters describes parameters for the Syslog logging destination type.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public SyslogLoggingDestinationParameters(String address, String facility, Long
         this.port = port;
     }
 
+    /**
+     * address is the IP address of the syslog endpoint that receives log messages.
+     */
     @JsonProperty("address")
     public String getAddress() {
         return address;
     }
 
+    /**
+     * address is the IP address of the syslog endpoint that receives log messages.
+     */
     @JsonProperty("address")
     public void setAddress(String address) {
         this.address = address;
     }
 
+    /**
+     * facility specifies the syslog facility of log messages.<br><p> <br><p> If this field is empty, the facility is "local1".
+     */
     @JsonProperty("facility")
     public String getFacility() {
         return facility;
     }
 
+    /**
+     * facility specifies the syslog facility of log messages.<br><p> <br><p> If this field is empty, the facility is "local1".
+     */
     @JsonProperty("facility")
     public void setFacility(String facility) {
         this.facility = facility;
     }
 
+    /**
+     * maxLength is the maximum length of the log message.<br><p> <br><p> Valid values are integers in the range 480 to 4096, inclusive.<br><p> <br><p> When omitted, the default value is 1024.
+     */
     @JsonProperty("maxLength")
     public Long getMaxLength() {
         return maxLength;
     }
 
+    /**
+     * maxLength is the maximum length of the log message.<br><p> <br><p> Valid values are integers in the range 480 to 4096, inclusive.<br><p> <br><p> When omitted, the default value is 1024.
+     */
     @JsonProperty("maxLength")
     public void setMaxLength(Long maxLength) {
         this.maxLength = maxLength;
     }
 
+    /**
+     * port is the UDP port number of the syslog endpoint that receives log messages.
+     */
     @JsonProperty("port")
     public Long getPort() {
         return port;
     }
 
+    /**
+     * port is the UDP port number of the syslog endpoint that receives log messages.
+     */
     @JsonProperty("port")
     public void setPort(Long port) {
         this.port = port;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Upstream.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Upstream.java
index 51e0c43ab23..4494cae8acf 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Upstream.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/Upstream.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Upstream can either be of type SystemResolvConf, or of type Network.<br><p> <br><p>   - For an Upstream of type SystemResolvConf, no further fields are necessary:<br><p>     The upstream will be configured to use /etc/resolv.conf.<br><p>   - For an Upstream of type Network, a NetworkResolver field needs to be defined<br><p>     with an IP address or IP:port if the upstream listens on a port other than 53.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public Upstream(String address, Long port, String type) {
         this.type = type;
     }
 
+    /**
+     * Address must be defined when Type is set to Network. It will be ignored otherwise. It must be a valid ipv4 or ipv6 address.
+     */
     @JsonProperty("address")
     public String getAddress() {
         return address;
     }
 
+    /**
+     * Address must be defined when Type is set to Network. It will be ignored otherwise. It must be a valid ipv4 or ipv6 address.
+     */
     @JsonProperty("address")
     public void setAddress(String address) {
         this.address = address;
     }
 
+    /**
+     * Port may be defined when Type is set to Network. It will be ignored otherwise. Port must be between 65535
+     */
     @JsonProperty("port")
     public Long getPort() {
         return port;
     }
 
+    /**
+     * Port may be defined when Type is set to Network. It will be ignored otherwise. Port must be between 65535
+     */
     @JsonProperty("port")
     public void setPort(Long port) {
         this.port = port;
     }
 
+    /**
+     * Type defines whether this upstream contains an IP/IP:port resolver or the local /etc/resolv.conf. Type accepts 2 possible values: SystemResolvConf or Network.<br><p> <br><p> &#42; When SystemResolvConf is used, the Upstream structure does not require any further fields to be defined:<br><p>   /etc/resolv.conf will be used<br><p> &#42; When Network is used, the Upstream structure must contain at least an Address
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type defines whether this upstream contains an IP/IP:port resolver or the local /etc/resolv.conf. Type accepts 2 possible values: SystemResolvConf or Network.<br><p> <br><p> &#42; When SystemResolvConf is used, the Upstream structure does not require any further fields to be defined:<br><p>   /etc/resolv.conf will be used<br><p> &#42; When Network is used, the Upstream structure must contain at least an Address
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/UpstreamResolvers.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/UpstreamResolvers.java
index 407ee570081..2e5dc6a56de 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/UpstreamResolvers.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/UpstreamResolvers.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UpstreamResolvers defines a schema for configuring the CoreDNS forward plugin in the specific case of the default (".") server. It defers from ForwardPlugin in the default values it accepts: &#42; At least one upstream should be specified. &#42; the default policy is Sequential
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public UpstreamResolvers(String policy, String protocolStrategy, DNSTransportCon
         this.upstreams = upstreams;
     }
 
+    /**
+     * Policy is used to determine the order in which upstream servers are selected for querying. Any one of the following values may be specified:<br><p> <br><p> &#42; "Random" picks a random upstream server for each query. &#42; "RoundRobin" picks upstream servers in a round-robin order, moving to the next server for each new query. &#42; "Sequential" tries querying upstream servers in a sequential order until one responds, starting with the first server for each new query.<br><p> <br><p> The default value is "Sequential"
+     */
     @JsonProperty("policy")
     public String getPolicy() {
         return policy;
     }
 
+    /**
+     * Policy is used to determine the order in which upstream servers are selected for querying. Any one of the following values may be specified:<br><p> <br><p> &#42; "Random" picks a random upstream server for each query. &#42; "RoundRobin" picks upstream servers in a round-robin order, moving to the next server for each new query. &#42; "Sequential" tries querying upstream servers in a sequential order until one responds, starting with the first server for each new query.<br><p> <br><p> The default value is "Sequential"
+     */
     @JsonProperty("policy")
     public void setPolicy(String policy) {
         this.policy = policy;
     }
 
+    /**
+     * protocolStrategy specifies the protocol to use for upstream DNS requests. Valid values for protocolStrategy are "TCP" and omitted. When omitted, this means no opinion and the platform is left to choose a reasonable default, which is subject to change over time. The current default is to use the protocol of the original client request. "TCP" specifies that the platform should use TCP for all upstream DNS requests, even if the client request uses UDP. "TCP" is useful for UDP-specific issues such as those created by non-compliant upstream resolvers, but may consume more bandwidth or increase DNS response time. Note that protocolStrategy only affects the protocol of DNS requests that CoreDNS makes to upstream resolvers. It does not affect the protocol of DNS requests between clients and CoreDNS.
+     */
     @JsonProperty("protocolStrategy")
     public String getProtocolStrategy() {
         return protocolStrategy;
     }
 
+    /**
+     * protocolStrategy specifies the protocol to use for upstream DNS requests. Valid values for protocolStrategy are "TCP" and omitted. When omitted, this means no opinion and the platform is left to choose a reasonable default, which is subject to change over time. The current default is to use the protocol of the original client request. "TCP" specifies that the platform should use TCP for all upstream DNS requests, even if the client request uses UDP. "TCP" is useful for UDP-specific issues such as those created by non-compliant upstream resolvers, but may consume more bandwidth or increase DNS response time. Note that protocolStrategy only affects the protocol of DNS requests that CoreDNS makes to upstream resolvers. It does not affect the protocol of DNS requests between clients and CoreDNS.
+     */
     @JsonProperty("protocolStrategy")
     public void setProtocolStrategy(String protocolStrategy) {
         this.protocolStrategy = protocolStrategy;
     }
 
+    /**
+     * UpstreamResolvers defines a schema for configuring the CoreDNS forward plugin in the specific case of the default (".") server. It defers from ForwardPlugin in the default values it accepts: &#42; At least one upstream should be specified. &#42; the default policy is Sequential
+     */
     @JsonProperty("transportConfig")
     public DNSTransportConfig getTransportConfig() {
         return transportConfig;
     }
 
+    /**
+     * UpstreamResolvers defines a schema for configuring the CoreDNS forward plugin in the specific case of the default (".") server. It defers from ForwardPlugin in the default values it accepts: &#42; At least one upstream should be specified. &#42; the default policy is Sequential
+     */
     @JsonProperty("transportConfig")
     public void setTransportConfig(DNSTransportConfig transportConfig) {
         this.transportConfig = transportConfig;
     }
 
+    /**
+     * Upstreams is a list of resolvers to forward name queries for the "." domain. Each instance of CoreDNS performs health checking of Upstreams. When a healthy upstream returns an error during the exchange, another resolver is tried from Upstreams. The Upstreams are selected in the order specified in Policy.<br><p> <br><p> A maximum of 15 upstreams is allowed per ForwardPlugin. If no Upstreams are specified, /etc/resolv.conf is used by default
+     */
     @JsonProperty("upstreams")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Upstream> getUpstreams() {
         return upstreams;
     }
 
+    /**
+     * Upstreams is a list of resolvers to forward name queries for the "." domain. Each instance of CoreDNS performs health checking of Upstreams. When a healthy upstream returns an error during the exchange, another resolver is tried from Upstreams. The Upstreams are selected in the order specified in Policy.<br><p> <br><p> A maximum of 15 upstreams is allowed per ForwardPlugin. If no Upstreams are specified, /etc/resolv.conf is used by default
+     */
     @JsonProperty("upstreams")
     public void setUpstreams(List<Upstream> upstreams) {
         this.upstreams = upstreams;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/VSphereCSIDriverConfigSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/VSphereCSIDriverConfigSpec.java
index 0483e0a009d..1b66dda4877 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/VSphereCSIDriverConfigSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1/VSphereCSIDriverConfigSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VSphereCSIDriverConfigSpec defines properties that can be configured for vsphere CSI driver.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public VSphereCSIDriverConfigSpec(Long globalMaxSnapshotsPerBlockVolume, Long gr
         this.topologyCategories = topologyCategories;
     }
 
+    /**
+     * globalMaxSnapshotsPerBlockVolume is a global configuration parameter that applies to volumes on all kinds of datastores. If omitted, the platform chooses a default, which is subject to change over time, currently that default is 3. Snapshots can not be disabled using this parameter. Increasing number of snapshots above 3 can have negative impact on performance, for more details see: https://kb.vmware.com/s/article/1025279 Volume snapshot documentation: https://docs.vmware.com/en/VMware-vSphere-Container-Storage-Plug-in/3.0/vmware-vsphere-csp-getting-started/GUID-E0B41C69-7EEB-450F-A73D-5FD2FF39E891.html
+     */
     @JsonProperty("globalMaxSnapshotsPerBlockVolume")
     public Long getGlobalMaxSnapshotsPerBlockVolume() {
         return globalMaxSnapshotsPerBlockVolume;
     }
 
+    /**
+     * globalMaxSnapshotsPerBlockVolume is a global configuration parameter that applies to volumes on all kinds of datastores. If omitted, the platform chooses a default, which is subject to change over time, currently that default is 3. Snapshots can not be disabled using this parameter. Increasing number of snapshots above 3 can have negative impact on performance, for more details see: https://kb.vmware.com/s/article/1025279 Volume snapshot documentation: https://docs.vmware.com/en/VMware-vSphere-Container-Storage-Plug-in/3.0/vmware-vsphere-csp-getting-started/GUID-E0B41C69-7EEB-450F-A73D-5FD2FF39E891.html
+     */
     @JsonProperty("globalMaxSnapshotsPerBlockVolume")
     public void setGlobalMaxSnapshotsPerBlockVolume(Long globalMaxSnapshotsPerBlockVolume) {
         this.globalMaxSnapshotsPerBlockVolume = globalMaxSnapshotsPerBlockVolume;
     }
 
+    /**
+     * granularMaxSnapshotsPerBlockVolumeInVSAN is a granular configuration parameter on vSAN datastore only. It overrides GlobalMaxSnapshotsPerBlockVolume if set, while it falls back to the global constraint if unset. Snapshots for VSAN can not be disabled using this parameter.
+     */
     @JsonProperty("granularMaxSnapshotsPerBlockVolumeInVSAN")
     public Long getGranularMaxSnapshotsPerBlockVolumeInVSAN() {
         return granularMaxSnapshotsPerBlockVolumeInVSAN;
     }
 
+    /**
+     * granularMaxSnapshotsPerBlockVolumeInVSAN is a granular configuration parameter on vSAN datastore only. It overrides GlobalMaxSnapshotsPerBlockVolume if set, while it falls back to the global constraint if unset. Snapshots for VSAN can not be disabled using this parameter.
+     */
     @JsonProperty("granularMaxSnapshotsPerBlockVolumeInVSAN")
     public void setGranularMaxSnapshotsPerBlockVolumeInVSAN(Long granularMaxSnapshotsPerBlockVolumeInVSAN) {
         this.granularMaxSnapshotsPerBlockVolumeInVSAN = granularMaxSnapshotsPerBlockVolumeInVSAN;
     }
 
+    /**
+     * granularMaxSnapshotsPerBlockVolumeInVVOL is a granular configuration parameter on Virtual Volumes datastore only. It overrides GlobalMaxSnapshotsPerBlockVolume if set, while it falls back to the global constraint if unset. Snapshots for VVOL can not be disabled using this parameter.
+     */
     @JsonProperty("granularMaxSnapshotsPerBlockVolumeInVVOL")
     public Long getGranularMaxSnapshotsPerBlockVolumeInVVOL() {
         return granularMaxSnapshotsPerBlockVolumeInVVOL;
     }
 
+    /**
+     * granularMaxSnapshotsPerBlockVolumeInVVOL is a granular configuration parameter on Virtual Volumes datastore only. It overrides GlobalMaxSnapshotsPerBlockVolume if set, while it falls back to the global constraint if unset. Snapshots for VVOL can not be disabled using this parameter.
+     */
     @JsonProperty("granularMaxSnapshotsPerBlockVolumeInVVOL")
     public void setGranularMaxSnapshotsPerBlockVolumeInVVOL(Long granularMaxSnapshotsPerBlockVolumeInVVOL) {
         this.granularMaxSnapshotsPerBlockVolumeInVVOL = granularMaxSnapshotsPerBlockVolumeInVVOL;
     }
 
+    /**
+     * topologyCategories indicates tag categories with which vcenter resources such as hostcluster or datacenter were tagged with. If cluster Infrastructure object has a topology, values specified in Infrastructure object will be used and modifications to topologyCategories will be rejected.
+     */
     @JsonProperty("topologyCategories")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getTopologyCategories() {
         return topologyCategories;
     }
 
+    /**
+     * topologyCategories indicates tag categories with which vcenter resources such as hostcluster or datacenter were tagged with. If cluster Infrastructure object has a topology, values specified in Infrastructure object will be used and modifications to topologyCategories will be rejected.
+     */
     @JsonProperty("topologyCategories")
     public void setTopologyCategories(List<String> topologyCategories) {
         this.topologyCategories = topologyCategories;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/BackupJobReference.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/BackupJobReference.java
index da015773a30..b3b10bf7aa7 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/BackupJobReference.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/BackupJobReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BackupJobReference holds a reference to the batch/v1 Job created to run the etcd backup
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public BackupJobReference(String name, String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * name is the name of the Job. Required
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the Job. Required
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * namespace is the namespace of the Job. this is always expected to be "openshift-etcd" since the user provided PVC is also required to be in "openshift-etcd" Required
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * namespace is the namespace of the Job. this is always expected to be "openshift-etcd" since the user provided PVC is also required to be in "openshift-etcd" Required
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/DelegatedAuthentication.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/DelegatedAuthentication.java
index 4cc0fe665ea..c764eee08c4 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/DelegatedAuthentication.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/DelegatedAuthentication.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DelegatedAuthentication allows authentication to be disabled.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public DelegatedAuthentication(Boolean disabled) {
         this.disabled = disabled;
     }
 
+    /**
+     * disabled indicates that authentication should be disabled.  By default it will use delegated authentication.
+     */
     @JsonProperty("disabled")
     public Boolean getDisabled() {
         return disabled;
     }
 
+    /**
+     * disabled indicates that authentication should be disabled.  By default it will use delegated authentication.
+     */
     @JsonProperty("disabled")
     public void setDisabled(Boolean disabled) {
         this.disabled = disabled;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/DelegatedAuthorization.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/DelegatedAuthorization.java
index eb7e211be7f..9a68ec1ec15 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/DelegatedAuthorization.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/DelegatedAuthorization.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DelegatedAuthorization allows authorization to be disabled.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public DelegatedAuthorization(Boolean disabled) {
         this.disabled = disabled;
     }
 
+    /**
+     * disabled indicates that authorization should be disabled.  By default it will use delegated authorization.
+     */
     @JsonProperty("disabled")
     public Boolean getDisabled() {
         return disabled;
     }
 
+    /**
+     * disabled indicates that authorization should be disabled.  By default it will use delegated authorization.
+     */
     @JsonProperty("disabled")
     public void setDisabled(Boolean disabled) {
         this.disabled = disabled;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/EtcdBackup.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/EtcdBackup.java
index fe71ec50187..36af0d36e95 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/EtcdBackup.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/EtcdBackup.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * # EtcdBackup provides configuration options and status for a one-time backup attempt of the etcd cluster<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class EtcdBackup implements Editable<EtcdBackupBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EtcdBackup";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public EtcdBackup(String apiVersion, String kind, ObjectMeta metadata, EtcdBacku
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * # EtcdBackup provides configuration options and status for a one-time backup attempt of the etcd cluster<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * # EtcdBackup provides configuration options and status for a one-time backup attempt of the etcd cluster<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * # EtcdBackup provides configuration options and status for a one-time backup attempt of the etcd cluster<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("spec")
     public EtcdBackupSpec getSpec() {
         return spec;
     }
 
+    /**
+     * # EtcdBackup provides configuration options and status for a one-time backup attempt of the etcd cluster<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("spec")
     public void setSpec(EtcdBackupSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * # EtcdBackup provides configuration options and status for a one-time backup attempt of the etcd cluster<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("status")
     public EtcdBackupStatus getStatus() {
         return status;
     }
 
+    /**
+     * # EtcdBackup provides configuration options and status for a one-time backup attempt of the etcd cluster<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("status")
     public void setStatus(EtcdBackupStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/EtcdBackupList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/EtcdBackupList.java
index b29a7f8ad22..2e363440647 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/EtcdBackupList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/EtcdBackupList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * EtcdBackupList is a collection of items<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class EtcdBackupList implements Editable<EtcdBackupListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.v1alpha1.EtcdBackup>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.v1alpha1.EtcdBackup> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "EtcdBackupList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public EtcdBackupList(String apiVersion, List<io.fabric8.openshift.api.model.ope
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * EtcdBackupList is a collection of items<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.v1alpha1.EtcdBackup> getItems() {
         return items;
     }
 
+    /**
+     * EtcdBackupList is a collection of items<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.v1alpha1.EtcdBackup> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * EtcdBackupList is a collection of items<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * EtcdBackupList is a collection of items<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/EtcdBackupSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/EtcdBackupSpec.java
index a0555a598e5..a082f78726e 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/EtcdBackupSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/EtcdBackupSpec.java
@@ -78,11 +78,17 @@ public EtcdBackupSpec(String pvcName) {
         this.pvcName = pvcName;
     }
 
+    /**
+     * PVCName specifies the name of the PersistentVolumeClaim (PVC) which binds a PersistentVolume where the etcd backup file would be saved The PVC itself must always be created in the "openshift-etcd" namespace If the PVC is left unspecified "" then the platform will choose a reasonable default location to save the backup. In the future this would be backups saved across the control-plane master nodes.
+     */
     @JsonProperty("pvcName")
     public String getPvcName() {
         return pvcName;
     }
 
+    /**
+     * PVCName specifies the name of the PersistentVolumeClaim (PVC) which binds a PersistentVolume where the etcd backup file would be saved The PVC itself must always be created in the "openshift-etcd" namespace If the PVC is left unspecified "" then the platform will choose a reasonable default location to save the backup. In the future this would be backups saved across the control-plane master nodes.
+     */
     @JsonProperty("pvcName")
     public void setPvcName(String pvcName) {
         this.pvcName = pvcName;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/EtcdBackupStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/EtcdBackupStatus.java
index f30a3dc7a32..4cf33cf7c69 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/EtcdBackupStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/EtcdBackupStatus.java
@@ -96,12 +96,18 @@ public void setBackupJob(BackupJobReference backupJob) {
         this.backupJob = backupJob;
     }
 
+    /**
+     * conditions provide details on the status of the etcd backup job.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions provide details on the status of the etcd backup job.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/GenerationHistory.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/GenerationHistory.java
index 4bd39f4dcd7..163f51470fb 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/GenerationHistory.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/GenerationHistory.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GenerationHistory keeps track of the generation for a given resource so that decisions about forced updated can be made. DEPRECATED: Use fields in v1.GenerationStatus instead
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public GenerationHistory(String group, Long lastGeneration, String name, String
         this.resource = resource;
     }
 
+    /**
+     * group is the group of the thing you're tracking
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * group is the group of the thing you're tracking
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * lastGeneration is the last generation of the workload controller involved
+     */
     @JsonProperty("lastGeneration")
     public Long getLastGeneration() {
         return lastGeneration;
     }
 
+    /**
+     * lastGeneration is the last generation of the workload controller involved
+     */
     @JsonProperty("lastGeneration")
     public void setLastGeneration(Long lastGeneration) {
         this.lastGeneration = lastGeneration;
     }
 
+    /**
+     * name is the name of the thing you're tracking
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the thing you're tracking
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * namespace is where the thing you're tracking is
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * namespace is where the thing you're tracking is
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * resource is the resource type of the thing you're tracking
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * resource is the resource type of the thing you're tracking
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/GenericOperatorConfig.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/GenericOperatorConfig.java
index ec016ce3f96..fe3b37362e8 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/GenericOperatorConfig.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/GenericOperatorConfig.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GenericOperatorConfig provides information to configure an operator<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,18 +82,12 @@
 public class GenericOperatorConfig implements Editable<GenericOperatorConfigBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1alpha1";
     @JsonProperty("authentication")
     private DelegatedAuthentication authentication;
     @JsonProperty("authorization")
     private DelegatedAuthorization authorization;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GenericOperatorConfig";
     @JsonProperty("leaderElection")
@@ -117,7 +114,7 @@ public GenericOperatorConfig(String apiVersion, DelegatedAuthentication authenti
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -125,35 +122,47 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * GenericOperatorConfig provides information to configure an operator<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("authentication")
     public DelegatedAuthentication getAuthentication() {
         return authentication;
     }
 
+    /**
+     * GenericOperatorConfig provides information to configure an operator<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("authentication")
     public void setAuthentication(DelegatedAuthentication authentication) {
         this.authentication = authentication;
     }
 
+    /**
+     * GenericOperatorConfig provides information to configure an operator<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("authorization")
     public DelegatedAuthorization getAuthorization() {
         return authorization;
     }
 
+    /**
+     * GenericOperatorConfig provides information to configure an operator<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("authorization")
     public void setAuthorization(DelegatedAuthorization authorization) {
         this.authorization = authorization;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -161,28 +170,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * GenericOperatorConfig provides information to configure an operator<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("leaderElection")
     public LeaderElection getLeaderElection() {
         return leaderElection;
     }
 
+    /**
+     * GenericOperatorConfig provides information to configure an operator<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("leaderElection")
     public void setLeaderElection(LeaderElection leaderElection) {
         this.leaderElection = leaderElection;
     }
 
+    /**
+     * GenericOperatorConfig provides information to configure an operator<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("servingInfo")
     public HTTPServingInfo getServingInfo() {
         return servingInfo;
     }
 
+    /**
+     * GenericOperatorConfig provides information to configure an operator<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("servingInfo")
     public void setServingInfo(HTTPServingInfo servingInfo) {
         this.servingInfo = servingInfo;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/ImageContentSourcePolicy.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/ImageContentSourcePolicy.java
index 3391f37c17d..a4654b77a8e 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/ImageContentSourcePolicy.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/ImageContentSourcePolicy.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageContentSourcePolicy holds cluster-wide information about how to handle registry mirror rules. When multiple policies are defined, the outcome of the behavior is defined on each field.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class ImageContentSourcePolicy implements Editable<ImageContentSourcePolicyBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ImageContentSourcePolicy";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public ImageContentSourcePolicy(String apiVersion, String kind, ObjectMeta metad
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ImageContentSourcePolicy holds cluster-wide information about how to handle registry mirror rules. When multiple policies are defined, the outcome of the behavior is defined on each field.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ImageContentSourcePolicy holds cluster-wide information about how to handle registry mirror rules. When multiple policies are defined, the outcome of the behavior is defined on each field.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ImageContentSourcePolicy holds cluster-wide information about how to handle registry mirror rules. When multiple policies are defined, the outcome of the behavior is defined on each field.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("spec")
     public ImageContentSourcePolicySpec getSpec() {
         return spec;
     }
 
+    /**
+     * ImageContentSourcePolicy holds cluster-wide information about how to handle registry mirror rules. When multiple policies are defined, the outcome of the behavior is defined on each field.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("spec")
     public void setSpec(ImageContentSourcePolicySpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/ImageContentSourcePolicyList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/ImageContentSourcePolicyList.java
index 027b074a027..a6ffeebf9da 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/ImageContentSourcePolicyList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/ImageContentSourcePolicyList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageContentSourcePolicyList lists the items in the ImageContentSourcePolicy CRD.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ImageContentSourcePolicyList implements Editable<ImageContentSourcePolicyListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.v1alpha1.ImageContentSourcePolicy>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.v1alpha1.ImageContentSourcePolicy> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ImageContentSourcePolicyList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ImageContentSourcePolicyList(String apiVersion, List<io.fabric8.openshift
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ImageContentSourcePolicyList lists the items in the ImageContentSourcePolicy CRD.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.v1alpha1.ImageContentSourcePolicy> getItems() {
         return items;
     }
 
+    /**
+     * ImageContentSourcePolicyList lists the items in the ImageContentSourcePolicy CRD.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.v1alpha1.ImageContentSourcePolicy> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ImageContentSourcePolicyList lists the items in the ImageContentSourcePolicy CRD.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ImageContentSourcePolicyList lists the items in the ImageContentSourcePolicy CRD.<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/ImageContentSourcePolicySpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/ImageContentSourcePolicySpec.java
index 2699ccbb4d2..c9ca6e81569 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/ImageContentSourcePolicySpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/ImageContentSourcePolicySpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageContentSourcePolicySpec is the specification of the ImageContentSourcePolicy CRD.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public ImageContentSourcePolicySpec(List<RepositoryDigestMirrors> repositoryDige
         this.repositoryDigestMirrors = repositoryDigestMirrors;
     }
 
+    /**
+     * repositoryDigestMirrors allows images referenced by image digests in pods to be pulled from alternative mirrored repository locations. The image pull specification provided to the pod will be compared to the source locations described in RepositoryDigestMirrors and the image may be pulled down from any of the mirrors in the list instead of the specified repository allowing administrators to choose a potentially faster mirror. Only image pull specifications that have an image digest will have this behavior applied to them - tags will continue to be pulled from the specified repository in the pull spec.<br><p> <br><p> Each "source" repository is treated independently; configurations for different "source" repositories don’t interact.<br><p> <br><p> When multiple policies are defined for the same "source" repository, the sets of defined mirrors will be merged together, preserving the relative order of the mirrors, if possible. For example, if policy A has mirrors `a, b, c` and policy B has mirrors `c, d, e`, the mirrors will be used in the order `a, b, c, d, e`.  If the orders of mirror entries conflict (e.g. `a, b` vs. `b, a`) the configuration is not rejected but the resulting order is unspecified.
+     */
     @JsonProperty("repositoryDigestMirrors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RepositoryDigestMirrors> getRepositoryDigestMirrors() {
         return repositoryDigestMirrors;
     }
 
+    /**
+     * repositoryDigestMirrors allows images referenced by image digests in pods to be pulled from alternative mirrored repository locations. The image pull specification provided to the pod will be compared to the source locations described in RepositoryDigestMirrors and the image may be pulled down from any of the mirrors in the list instead of the specified repository allowing administrators to choose a potentially faster mirror. Only image pull specifications that have an image digest will have this behavior applied to them - tags will continue to be pulled from the specified repository in the pull spec.<br><p> <br><p> Each "source" repository is treated independently; configurations for different "source" repositories don’t interact.<br><p> <br><p> When multiple policies are defined for the same "source" repository, the sets of defined mirrors will be merged together, preserving the relative order of the mirrors, if possible. For example, if policy A has mirrors `a, b, c` and policy B has mirrors `c, d, e`, the mirrors will be used in the order `a, b, c, d, e`.  If the orders of mirror entries conflict (e.g. `a, b` vs. `b, a`) the configuration is not rejected but the resulting order is unspecified.
+     */
     @JsonProperty("repositoryDigestMirrors")
     public void setRepositoryDigestMirrors(List<RepositoryDigestMirrors> repositoryDigestMirrors) {
         this.repositoryDigestMirrors = repositoryDigestMirrors;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/LoggingConfig.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/LoggingConfig.java
index 416dfa5da84..7668d751c2c 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/LoggingConfig.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/LoggingConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LoggingConfig holds information about configuring logging DEPRECATED: Use v1.LogLevel instead
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public LoggingConfig(Long level, String vmodule) {
         this.vmodule = vmodule;
     }
 
+    /**
+     * level is passed to glog.
+     */
     @JsonProperty("level")
     public Long getLevel() {
         return level;
     }
 
+    /**
+     * level is passed to glog.
+     */
     @JsonProperty("level")
     public void setLevel(Long level) {
         this.level = level;
     }
 
+    /**
+     * vmodule is passed to glog.
+     */
     @JsonProperty("vmodule")
     public String getVmodule() {
         return vmodule;
     }
 
+    /**
+     * vmodule is passed to glog.
+     */
     @JsonProperty("vmodule")
     public void setVmodule(String vmodule) {
         this.vmodule = vmodule;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/NodeStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/NodeStatus.java
index cd16e80d9b4..369230bfedd 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/NodeStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/NodeStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NodeStatus provides information about the current state of a particular node managed by this operator. Deprecated: Use v1.NodeStatus instead
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -97,52 +100,82 @@ public NodeStatus(Integer currentDeploymentGeneration, List<String> lastFailedDe
         this.targetDeploymentGeneration = targetDeploymentGeneration;
     }
 
+    /**
+     * currentDeploymentGeneration is the generation of the most recently successful deployment
+     */
     @JsonProperty("currentDeploymentGeneration")
     public Integer getCurrentDeploymentGeneration() {
         return currentDeploymentGeneration;
     }
 
+    /**
+     * currentDeploymentGeneration is the generation of the most recently successful deployment
+     */
     @JsonProperty("currentDeploymentGeneration")
     public void setCurrentDeploymentGeneration(Integer currentDeploymentGeneration) {
         this.currentDeploymentGeneration = currentDeploymentGeneration;
     }
 
+    /**
+     * lastFailedDeploymentGenerationErrors is a list of the errors during the failed deployment referenced in lastFailedDeploymentGeneration
+     */
     @JsonProperty("lastFailedDeploymentErrors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getLastFailedDeploymentErrors() {
         return lastFailedDeploymentErrors;
     }
 
+    /**
+     * lastFailedDeploymentGenerationErrors is a list of the errors during the failed deployment referenced in lastFailedDeploymentGeneration
+     */
     @JsonProperty("lastFailedDeploymentErrors")
     public void setLastFailedDeploymentErrors(List<String> lastFailedDeploymentErrors) {
         this.lastFailedDeploymentErrors = lastFailedDeploymentErrors;
     }
 
+    /**
+     * lastFailedDeploymentGeneration is the generation of the deployment we tried and failed to deploy.
+     */
     @JsonProperty("lastFailedDeploymentGeneration")
     public Integer getLastFailedDeploymentGeneration() {
         return lastFailedDeploymentGeneration;
     }
 
+    /**
+     * lastFailedDeploymentGeneration is the generation of the deployment we tried and failed to deploy.
+     */
     @JsonProperty("lastFailedDeploymentGeneration")
     public void setLastFailedDeploymentGeneration(Integer lastFailedDeploymentGeneration) {
         this.lastFailedDeploymentGeneration = lastFailedDeploymentGeneration;
     }
 
+    /**
+     * nodeName is the name of the node
+     */
     @JsonProperty("nodeName")
     public String getNodeName() {
         return nodeName;
     }
 
+    /**
+     * nodeName is the name of the node
+     */
     @JsonProperty("nodeName")
     public void setNodeName(String nodeName) {
         this.nodeName = nodeName;
     }
 
+    /**
+     * targetDeploymentGeneration is the generation of the deployment we're trying to apply
+     */
     @JsonProperty("targetDeploymentGeneration")
     public Integer getTargetDeploymentGeneration() {
         return targetDeploymentGeneration;
     }
 
+    /**
+     * targetDeploymentGeneration is the generation of the deployment we're trying to apply
+     */
     @JsonProperty("targetDeploymentGeneration")
     public void setTargetDeploymentGeneration(Integer targetDeploymentGeneration) {
         this.targetDeploymentGeneration = targetDeploymentGeneration;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/OLM.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/OLM.java
index 56456585e44..8ff3ab3f3c6 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/OLM.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/OLM.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OLM provides information to configure an operator to manage the OLM controllers<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class OLM implements Editable<OLMBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OLM";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public OLM(String apiVersion, String kind, ObjectMeta metadata, OLMSpec spec, OL
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OLM provides information to configure an operator to manage the OLM controllers<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OLM provides information to configure an operator to manage the OLM controllers<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * OLM provides information to configure an operator to manage the OLM controllers<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("spec")
     public OLMSpec getSpec() {
         return spec;
     }
 
+    /**
+     * OLM provides information to configure an operator to manage the OLM controllers<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("spec")
     public void setSpec(OLMSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * OLM provides information to configure an operator to manage the OLM controllers<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("status")
     public OLMStatus getStatus() {
         return status;
     }
 
+    /**
+     * OLM provides information to configure an operator to manage the OLM controllers<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("status")
     public void setStatus(OLMStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/OLMList.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/OLMList.java
index ed41c74a54d..29ac76a080e 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/OLMList.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/OLMList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OLMList is a collection of items<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class OLMList implements Editable<OLMListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operator.v1alpha1.OLM>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operator.openshift.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operator.v1alpha1.OLM> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OLMList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public OLMList(String apiVersion, List<io.fabric8.openshift.api.model.operator.v
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items contains the items
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operator.v1alpha1.OLM> getItems() {
         return items;
     }
 
+    /**
+     * Items contains the items
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operator.v1alpha1.OLM> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OLMList is a collection of items<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OLMList is a collection of items<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/OLMSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/OLMSpec.java
index 5393bdd4d98..e7ab8112b33 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/OLMSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/OLMSpec.java
@@ -96,21 +96,33 @@ public OLMSpec(String logLevel, String managementState, Object observedConfig, S
         this.unsupportedConfigOverrides = unsupportedConfigOverrides;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public String getLogLevel() {
         return logLevel;
     }
 
+    /**
+     * logLevel is an intent based logging for an overall component.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for their operands.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("logLevel")
     public void setLogLevel(String logLevel) {
         this.logLevel = logLevel;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
@@ -127,11 +139,17 @@ public void setObservedConfig(Object observedConfig) {
         this.observedConfig = observedConfig;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public String getOperatorLogLevel() {
         return operatorLogLevel;
     }
 
+    /**
+     * operatorLogLevel is an intent based logging for the operator itself.  It does not give fine grained control, but it is a simple way to manage coarse grained logging choices that operators have to interpret for themselves.<br><p> <br><p> Valid values are: "Normal", "Debug", "Trace", "TraceAll". Defaults to "Normal".
+     */
     @JsonProperty("operatorLogLevel")
     public void setOperatorLogLevel(String operatorLogLevel) {
         this.operatorLogLevel = operatorLogLevel;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/OLMStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/OLMStatus.java
index f492c4bf507..33096641354 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/OLMStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/OLMStatus.java
@@ -104,63 +104,99 @@ public OLMStatus(List<OperatorCondition> conditions, List<GenerationStatus> gene
         this.version = version;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenerationStatus> getGenerations() {
         return generations;
     }
 
+    /**
+     * generations are used to determine when an item needs to be reconciled or has changed in a way that needs a reaction.
+     */
     @JsonProperty("generations")
     public void setGenerations(List<GenerationStatus> generations) {
         this.generations = generations;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public Integer getLatestAvailableRevision() {
         return latestAvailableRevision;
     }
 
+    /**
+     * latestAvailableRevision is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableRevision")
     public void setLatestAvailableRevision(Integer latestAvailableRevision) {
         this.latestAvailableRevision = latestAvailableRevision;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/OperatorCondition.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/OperatorCondition.java
index efa3c9c2930..7532830d69b 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/OperatorCondition.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/OperatorCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorCondition is just the standard condition fields. DEPRECATED: Use v1.OperatorCondition instead
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public OperatorCondition(String lastTransitionTime, String message, String reaso
         this.type = type;
     }
 
+    /**
+     * OperatorCondition is just the standard condition fields. DEPRECATED: Use v1.OperatorCondition instead
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * OperatorCondition is just the standard condition fields. DEPRECATED: Use v1.OperatorCondition instead
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * OperatorCondition is just the standard condition fields. DEPRECATED: Use v1.OperatorCondition instead
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * OperatorCondition is just the standard condition fields. DEPRECATED: Use v1.OperatorCondition instead
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * OperatorCondition is just the standard condition fields. DEPRECATED: Use v1.OperatorCondition instead
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * OperatorCondition is just the standard condition fields. DEPRECATED: Use v1.OperatorCondition instead
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * OperatorCondition is just the standard condition fields. DEPRECATED: Use v1.OperatorCondition instead
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * OperatorCondition is just the standard condition fields. DEPRECATED: Use v1.OperatorCondition instead
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * OperatorCondition is just the standard condition fields. DEPRECATED: Use v1.OperatorCondition instead
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * OperatorCondition is just the standard condition fields. DEPRECATED: Use v1.OperatorCondition instead
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/OperatorSpec.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/OperatorSpec.java
index 8fa598b7477..998079616dc 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/OperatorSpec.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/OperatorSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorSpec contains common fields for an operator to need.  It is intended to be anonymous included inside of the Spec struct for you particular operator. DEPRECATED: Use v1.OperatorSpec instead
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public OperatorSpec(String imagePullPolicy, String imagePullSpec, LoggingConfig
         this.version = version;
     }
 
+    /**
+     * imagePullPolicy specifies the image pull policy. One of Always, Never, IfNotPresent. Defaults to Always if :latest tag is specified, or IfNotPresent otherwise.
+     */
     @JsonProperty("imagePullPolicy")
     public String getImagePullPolicy() {
         return imagePullPolicy;
     }
 
+    /**
+     * imagePullPolicy specifies the image pull policy. One of Always, Never, IfNotPresent. Defaults to Always if :latest tag is specified, or IfNotPresent otherwise.
+     */
     @JsonProperty("imagePullPolicy")
     public void setImagePullPolicy(String imagePullPolicy) {
         this.imagePullPolicy = imagePullPolicy;
     }
 
+    /**
+     * imagePullSpec is the image to use for the component.
+     */
     @JsonProperty("imagePullSpec")
     public String getImagePullSpec() {
         return imagePullSpec;
     }
 
+    /**
+     * imagePullSpec is the image to use for the component.
+     */
     @JsonProperty("imagePullSpec")
     public void setImagePullSpec(String imagePullSpec) {
         this.imagePullSpec = imagePullSpec;
     }
 
+    /**
+     * OperatorSpec contains common fields for an operator to need.  It is intended to be anonymous included inside of the Spec struct for you particular operator. DEPRECATED: Use v1.OperatorSpec instead
+     */
     @JsonProperty("logging")
     public LoggingConfig getLogging() {
         return logging;
     }
 
+    /**
+     * OperatorSpec contains common fields for an operator to need.  It is intended to be anonymous included inside of the Spec struct for you particular operator. DEPRECATED: Use v1.OperatorSpec instead
+     */
     @JsonProperty("logging")
     public void setLogging(LoggingConfig logging) {
         this.logging = logging;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates whether and how the operator should manage the component
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
     }
 
+    /**
+     * version is the desired state in major.minor.micro-patch.  Usually patch is ignored.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the desired state in major.minor.micro-patch.  Usually patch is ignored.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/OperatorStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/OperatorStatus.java
index 392a43bc86b..502de395a6d 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/OperatorStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/OperatorStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorStatus contains common fields for an operator to need.  It is intended to be anonymous included inside of the Status struct for you particular operator. DEPRECATED: Use v1.OperatorStatus instead
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,62 +104,98 @@ public OperatorStatus(List<OperatorCondition> conditions, VersionAvailability cu
         this.taskSummary = taskSummary;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * OperatorStatus contains common fields for an operator to need.  It is intended to be anonymous included inside of the Status struct for you particular operator. DEPRECATED: Use v1.OperatorStatus instead
+     */
     @JsonProperty("currentVersionAvailability")
     public VersionAvailability getCurrentVersionAvailability() {
         return currentVersionAvailability;
     }
 
+    /**
+     * OperatorStatus contains common fields for an operator to need.  It is intended to be anonymous included inside of the Status struct for you particular operator. DEPRECATED: Use v1.OperatorStatus instead
+     */
     @JsonProperty("currentVersionAvailability")
     public void setCurrentVersionAvailability(VersionAvailability currentVersionAvailability) {
         this.currentVersionAvailability = currentVersionAvailability;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * state indicates what the operator has observed to be its current operational status.
+     */
     @JsonProperty("state")
     public String getState() {
         return state;
     }
 
+    /**
+     * state indicates what the operator has observed to be its current operational status.
+     */
     @JsonProperty("state")
     public void setState(String state) {
         this.state = state;
     }
 
+    /**
+     * OperatorStatus contains common fields for an operator to need.  It is intended to be anonymous included inside of the Status struct for you particular operator. DEPRECATED: Use v1.OperatorStatus instead
+     */
     @JsonProperty("targetVersionAvailability")
     public VersionAvailability getTargetVersionAvailability() {
         return targetVersionAvailability;
     }
 
+    /**
+     * OperatorStatus contains common fields for an operator to need.  It is intended to be anonymous included inside of the Status struct for you particular operator. DEPRECATED: Use v1.OperatorStatus instead
+     */
     @JsonProperty("targetVersionAvailability")
     public void setTargetVersionAvailability(VersionAvailability targetVersionAvailability) {
         this.targetVersionAvailability = targetVersionAvailability;
     }
 
+    /**
+     * taskSummary is a high level summary of what the controller is currently attempting to do.  It is high-level, human-readable and not guaranteed in any way. (I needed this for debugging and realized it made a great summary).
+     */
     @JsonProperty("taskSummary")
     public String getTaskSummary() {
         return taskSummary;
     }
 
+    /**
+     * taskSummary is a high level summary of what the controller is currently attempting to do.  It is high-level, human-readable and not guaranteed in any way. (I needed this for debugging and realized it made a great summary).
+     */
     @JsonProperty("taskSummary")
     public void setTaskSummary(String taskSummary) {
         this.taskSummary = taskSummary;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/RepositoryDigestMirrors.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/RepositoryDigestMirrors.java
index 7cdd423d7b3..cfe1bf73ff0 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/RepositoryDigestMirrors.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/RepositoryDigestMirrors.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RepositoryDigestMirrors holds cluster-wide information about how to handle mirros in the registries config. Note: the mirrors only work when pulling the images that are referenced by their digests.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public RepositoryDigestMirrors(List<String> mirrors, String source) {
         this.source = source;
     }
 
+    /**
+     * mirrors is one or more repositories that may also contain the same images. The order of mirrors in this list is treated as the user's desired priority, while source is by default considered lower priority than all mirrors. Other cluster configuration, including (but not limited to) other repositoryDigestMirrors objects, may impact the exact order mirrors are contacted in, or some mirrors may be contacted in parallel, so this should be considered a preference rather than a guarantee of ordering.
+     */
     @JsonProperty("mirrors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getMirrors() {
         return mirrors;
     }
 
+    /**
+     * mirrors is one or more repositories that may also contain the same images. The order of mirrors in this list is treated as the user's desired priority, while source is by default considered lower priority than all mirrors. Other cluster configuration, including (but not limited to) other repositoryDigestMirrors objects, may impact the exact order mirrors are contacted in, or some mirrors may be contacted in parallel, so this should be considered a preference rather than a guarantee of ordering.
+     */
     @JsonProperty("mirrors")
     public void setMirrors(List<String> mirrors) {
         this.mirrors = mirrors;
     }
 
+    /**
+     * source is the repository that users refer to, e.g. in image pull specifications.
+     */
     @JsonProperty("source")
     public String getSource() {
         return source;
     }
 
+    /**
+     * source is the repository that users refer to, e.g. in image pull specifications.
+     */
     @JsonProperty("source")
     public void setSource(String source) {
         this.source = source;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/StaticPodOperatorStatus.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/StaticPodOperatorStatus.java
index 2fb1d2d14ef..315bf91c234 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/StaticPodOperatorStatus.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/StaticPodOperatorStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StaticPodOperatorStatus is status for controllers that manage static pods.  There are different needs because individual node status must be tracked. DEPRECATED: Use v1.StaticPodOperatorStatus instead
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -110,83 +113,131 @@ public StaticPodOperatorStatus(List<OperatorCondition> conditions, VersionAvaila
         this.taskSummary = taskSummary;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<OperatorCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is a list of conditions and their status
+     */
     @JsonProperty("conditions")
     public void setConditions(List<OperatorCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * StaticPodOperatorStatus is status for controllers that manage static pods.  There are different needs because individual node status must be tracked. DEPRECATED: Use v1.StaticPodOperatorStatus instead
+     */
     @JsonProperty("currentVersionAvailability")
     public VersionAvailability getCurrentVersionAvailability() {
         return currentVersionAvailability;
     }
 
+    /**
+     * StaticPodOperatorStatus is status for controllers that manage static pods.  There are different needs because individual node status must be tracked. DEPRECATED: Use v1.StaticPodOperatorStatus instead
+     */
     @JsonProperty("currentVersionAvailability")
     public void setCurrentVersionAvailability(VersionAvailability currentVersionAvailability) {
         this.currentVersionAvailability = currentVersionAvailability;
     }
 
+    /**
+     * latestAvailableDeploymentGeneration is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableDeploymentGeneration")
     public Integer getLatestAvailableDeploymentGeneration() {
         return latestAvailableDeploymentGeneration;
     }
 
+    /**
+     * latestAvailableDeploymentGeneration is the deploymentID of the most recent deployment
+     */
     @JsonProperty("latestAvailableDeploymentGeneration")
     public void setLatestAvailableDeploymentGeneration(Integer latestAvailableDeploymentGeneration) {
         this.latestAvailableDeploymentGeneration = latestAvailableDeploymentGeneration;
     }
 
+    /**
+     * nodeStatuses track the deployment values and errors across individual nodes
+     */
     @JsonProperty("nodeStatuses")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NodeStatus> getNodeStatuses() {
         return nodeStatuses;
     }
 
+    /**
+     * nodeStatuses track the deployment values and errors across individual nodes
+     */
     @JsonProperty("nodeStatuses")
     public void setNodeStatuses(List<NodeStatus> nodeStatuses) {
         this.nodeStatuses = nodeStatuses;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * observedGeneration is the last generation change you've dealt with
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * state indicates what the operator has observed to be its current operational status.
+     */
     @JsonProperty("state")
     public String getState() {
         return state;
     }
 
+    /**
+     * state indicates what the operator has observed to be its current operational status.
+     */
     @JsonProperty("state")
     public void setState(String state) {
         this.state = state;
     }
 
+    /**
+     * StaticPodOperatorStatus is status for controllers that manage static pods.  There are different needs because individual node status must be tracked. DEPRECATED: Use v1.StaticPodOperatorStatus instead
+     */
     @JsonProperty("targetVersionAvailability")
     public VersionAvailability getTargetVersionAvailability() {
         return targetVersionAvailability;
     }
 
+    /**
+     * StaticPodOperatorStatus is status for controllers that manage static pods.  There are different needs because individual node status must be tracked. DEPRECATED: Use v1.StaticPodOperatorStatus instead
+     */
     @JsonProperty("targetVersionAvailability")
     public void setTargetVersionAvailability(VersionAvailability targetVersionAvailability) {
         this.targetVersionAvailability = targetVersionAvailability;
     }
 
+    /**
+     * taskSummary is a high level summary of what the controller is currently attempting to do.  It is high-level, human-readable and not guaranteed in any way. (I needed this for debugging and realized it made a great summary).
+     */
     @JsonProperty("taskSummary")
     public String getTaskSummary() {
         return taskSummary;
     }
 
+    /**
+     * taskSummary is a high level summary of what the controller is currently attempting to do.  It is high-level, human-readable and not guaranteed in any way. (I needed this for debugging and realized it made a great summary).
+     */
     @JsonProperty("taskSummary")
     public void setTaskSummary(String taskSummary) {
         this.taskSummary = taskSummary;
diff --git a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/VersionAvailability.java b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/VersionAvailability.java
index 35b629d5bad..2b29ebc5550 100644
--- a/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/VersionAvailability.java
+++ b/kubernetes-model-generator/openshift-model-operator/src/generated/java/io/fabric8/openshift/api/model/operator/v1alpha1/VersionAvailability.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * VersionAvailability gives information about the synchronization and operational status of a particular version of the component DEPRECATED: Use fields in v1.OperatorStatus instead
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,53 +101,83 @@ public VersionAvailability(List<String> errors, List<GenerationHistory> generati
         this.version = version;
     }
 
+    /**
+     * errors indicates what failures are associated with the operator trying to manage this version
+     */
     @JsonProperty("errors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getErrors() {
         return errors;
     }
 
+    /**
+     * errors indicates what failures are associated with the operator trying to manage this version
+     */
     @JsonProperty("errors")
     public void setErrors(List<String> errors) {
         this.errors = errors;
     }
 
+    /**
+     * generations allows an operator to track what the generation of "important" resources was the last time we updated them
+     */
     @JsonProperty("generations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GenerationHistory> getGenerations() {
         return generations;
     }
 
+    /**
+     * generations allows an operator to track what the generation of "important" resources was the last time we updated them
+     */
     @JsonProperty("generations")
     public void setGenerations(List<GenerationHistory> generations) {
         this.generations = generations;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * readyReplicas indicates how many replicas are ready and at the desired state
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * updatedReplicas indicates how many replicas are at the desired state
+     */
     @JsonProperty("updatedReplicas")
     public Integer getUpdatedReplicas() {
         return updatedReplicas;
     }
 
+    /**
+     * updatedReplicas indicates how many replicas are at the desired state
+     */
     @JsonProperty("updatedReplicas")
     public void setUpdatedReplicas(Integer updatedReplicas) {
         this.updatedReplicas = updatedReplicas;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * version is the level this availability applies to
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/AppLink.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/AppLink.java
index 97a37805df8..e6851145287 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/AppLink.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/AppLink.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AppLink defines a link to an application
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public AppLink(String name, String url) {
         this.url = url;
     }
 
+    /**
+     * AppLink defines a link to an application
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * AppLink defines a link to an application
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * AppLink defines a link to an application
+     */
     @JsonProperty("url")
     public String getUrl() {
         return url;
     }
 
+    /**
+     * AppLink defines a link to an application
+     */
     @JsonProperty("url")
     public void setUrl(String url) {
         this.url = url;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/CSVDescription.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/CSVDescription.java
index 589b885f691..4543754e2f7 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/CSVDescription.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/CSVDescription.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CSVDescription defines a description of a CSV
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -152,169 +155,265 @@ public CSVDescription(Map<String, String> annotations, APIServiceDefinitions api
         this.version = version;
     }
 
+    /**
+     * CSVDescription defines a description of a CSV
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * CSVDescription defines a description of a CSV
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * CSVDescription defines a description of a CSV
+     */
     @JsonProperty("apiservicedefinitions")
     public APIServiceDefinitions getApiservicedefinitions() {
         return apiservicedefinitions;
     }
 
+    /**
+     * CSVDescription defines a description of a CSV
+     */
     @JsonProperty("apiservicedefinitions")
     public void setApiservicedefinitions(APIServiceDefinitions apiservicedefinitions) {
         this.apiservicedefinitions = apiservicedefinitions;
     }
 
+    /**
+     * CSVDescription defines a description of a CSV
+     */
     @JsonProperty("customresourcedefinitions")
     public CustomResourceDefinitions getCustomresourcedefinitions() {
         return customresourcedefinitions;
     }
 
+    /**
+     * CSVDescription defines a description of a CSV
+     */
     @JsonProperty("customresourcedefinitions")
     public void setCustomresourcedefinitions(CustomResourceDefinitions customresourcedefinitions) {
         this.customresourcedefinitions = customresourcedefinitions;
     }
 
+    /**
+     * LongDescription is the CSV's description
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * LongDescription is the CSV's description
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * DisplayName is the CSV's display name
+     */
     @JsonProperty("displayName")
     public String getDisplayName() {
         return displayName;
     }
 
+    /**
+     * DisplayName is the CSV's display name
+     */
     @JsonProperty("displayName")
     public void setDisplayName(String displayName) {
         this.displayName = displayName;
     }
 
+    /**
+     * Icon is the CSV's base64 encoded icon
+     */
     @JsonProperty("icon")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Icon> getIcon() {
         return icon;
     }
 
+    /**
+     * Icon is the CSV's base64 encoded icon
+     */
     @JsonProperty("icon")
     public void setIcon(List<Icon> icon) {
         this.icon = icon;
     }
 
+    /**
+     * InstallModes specify supported installation types
+     */
     @JsonProperty("installModes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<InstallMode> getInstallModes() {
         return installModes;
     }
 
+    /**
+     * InstallModes specify supported installation types
+     */
     @JsonProperty("installModes")
     public void setInstallModes(List<InstallMode> installModes) {
         this.installModes = installModes;
     }
 
+    /**
+     * CSVDescription defines a description of a CSV
+     */
     @JsonProperty("keywords")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getKeywords() {
         return keywords;
     }
 
+    /**
+     * CSVDescription defines a description of a CSV
+     */
     @JsonProperty("keywords")
     public void setKeywords(List<String> keywords) {
         this.keywords = keywords;
     }
 
+    /**
+     * CSVDescription defines a description of a CSV
+     */
     @JsonProperty("links")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AppLink> getLinks() {
         return links;
     }
 
+    /**
+     * CSVDescription defines a description of a CSV
+     */
     @JsonProperty("links")
     public void setLinks(List<AppLink> links) {
         this.links = links;
     }
 
+    /**
+     * CSVDescription defines a description of a CSV
+     */
     @JsonProperty("maintainers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Maintainer> getMaintainers() {
         return maintainers;
     }
 
+    /**
+     * CSVDescription defines a description of a CSV
+     */
     @JsonProperty("maintainers")
     public void setMaintainers(List<Maintainer> maintainers) {
         this.maintainers = maintainers;
     }
 
+    /**
+     * CSVDescription defines a description of a CSV
+     */
     @JsonProperty("maturity")
     public String getMaturity() {
         return maturity;
     }
 
+    /**
+     * CSVDescription defines a description of a CSV
+     */
     @JsonProperty("maturity")
     public void setMaturity(String maturity) {
         this.maturity = maturity;
     }
 
+    /**
+     * Minimum Kubernetes version for operator installation
+     */
     @JsonProperty("minKubeVersion")
     public String getMinKubeVersion() {
         return minKubeVersion;
     }
 
+    /**
+     * Minimum Kubernetes version for operator installation
+     */
     @JsonProperty("minKubeVersion")
     public void setMinKubeVersion(String minKubeVersion) {
         this.minKubeVersion = minKubeVersion;
     }
 
+    /**
+     * CSVDescription defines a description of a CSV
+     */
     @JsonProperty("nativeApis")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GroupVersionKind> getNativeApis() {
         return nativeApis;
     }
 
+    /**
+     * CSVDescription defines a description of a CSV
+     */
     @JsonProperty("nativeApis")
     public void setNativeApis(List<GroupVersionKind> nativeApis) {
         this.nativeApis = nativeApis;
     }
 
+    /**
+     * CSVDescription defines a description of a CSV
+     */
     @JsonProperty("provider")
     public AppLink getProvider() {
         return provider;
     }
 
+    /**
+     * CSVDescription defines a description of a CSV
+     */
     @JsonProperty("provider")
     public void setProvider(AppLink provider) {
         this.provider = provider;
     }
 
+    /**
+     * List of related images
+     */
     @JsonProperty("relatedImages")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getRelatedImages() {
         return relatedImages;
     }
 
+    /**
+     * List of related images
+     */
     @JsonProperty("relatedImages")
     public void setRelatedImages(List<String> relatedImages) {
         this.relatedImages = relatedImages;
     }
 
+    /**
+     * CSVDescription defines a description of a CSV
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * CSVDescription defines a description of a CSV
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/ChannelEntry.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/ChannelEntry.java
index 68f9f8d33ce..712122a9bb8 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/ChannelEntry.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/ChannelEntry.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ChannelEntry defines a member of a package channel.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ChannelEntry(Deprecation deprecation, String name, String version) {
         this.version = version;
     }
 
+    /**
+     * ChannelEntry defines a member of a package channel.
+     */
     @JsonProperty("deprecation")
     public Deprecation getDeprecation() {
         return deprecation;
     }
 
+    /**
+     * ChannelEntry defines a member of a package channel.
+     */
     @JsonProperty("deprecation")
     public void setDeprecation(Deprecation deprecation) {
         this.deprecation = deprecation;
     }
 
+    /**
+     * Name is the name of the bundle for this entry.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the bundle for this entry.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Version is the version of the bundle for this entry.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * Version is the version of the bundle for this entry.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/Deprecation.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/Deprecation.java
index 7b375700949..0a09dae083e 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/Deprecation.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/Deprecation.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Deprecation conveys information regarding a deprecated resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public Deprecation(String message) {
         this.message = message;
     }
 
+    /**
+     * Message is a human readable message describing the deprecation.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message is a human readable message describing the deprecation.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/Icon.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/Icon.java
index 0914b707f2f..5d9d2ffdb58 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/Icon.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/Icon.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Icon defines a base64 encoded icon and media type
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Icon(String base64data, String mediatype) {
         this.mediatype = mediatype;
     }
 
+    /**
+     * Icon defines a base64 encoded icon and media type
+     */
     @JsonProperty("base64data")
     public String getBase64data() {
         return base64data;
     }
 
+    /**
+     * Icon defines a base64 encoded icon and media type
+     */
     @JsonProperty("base64data")
     public void setBase64data(String base64data) {
         this.base64data = base64data;
     }
 
+    /**
+     * Icon defines a base64 encoded icon and media type
+     */
     @JsonProperty("mediatype")
     public String getMediatype() {
         return mediatype;
     }
 
+    /**
+     * Icon defines a base64 encoded icon and media type
+     */
     @JsonProperty("mediatype")
     public void setMediatype(String mediatype) {
         this.mediatype = mediatype;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/Maintainer.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/Maintainer.java
index 8326f69150f..fbb978a57e4 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/Maintainer.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/Maintainer.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Maintainer defines a project maintainer
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Maintainer(String email, String name) {
         this.name = name;
     }
 
+    /**
+     * Maintainer defines a project maintainer
+     */
     @JsonProperty("email")
     public String getEmail() {
         return email;
     }
 
+    /**
+     * Maintainer defines a project maintainer
+     */
     @JsonProperty("email")
     public void setEmail(String email) {
         this.email = email;
     }
 
+    /**
+     * Maintainer defines a project maintainer
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Maintainer defines a project maintainer
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/PackageChannel.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/PackageChannel.java
index 38c6450c4f0..219b3fd35c9 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/PackageChannel.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/PackageChannel.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PackageChannel defines a single channel under a package, pointing to a version of that package.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -97,52 +100,82 @@ public PackageChannel(String currentCSV, CSVDescription currentCSVDesc, Deprecat
         this.name = name;
     }
 
+    /**
+     * CurrentCSV defines a reference to the CSV holding the version of this package currently for the channel.
+     */
     @JsonProperty("currentCSV")
     public String getCurrentCSV() {
         return currentCSV;
     }
 
+    /**
+     * CurrentCSV defines a reference to the CSV holding the version of this package currently for the channel.
+     */
     @JsonProperty("currentCSV")
     public void setCurrentCSV(String currentCSV) {
         this.currentCSV = currentCSV;
     }
 
+    /**
+     * PackageChannel defines a single channel under a package, pointing to a version of that package.
+     */
     @JsonProperty("currentCSVDesc")
     public CSVDescription getCurrentCSVDesc() {
         return currentCSVDesc;
     }
 
+    /**
+     * PackageChannel defines a single channel under a package, pointing to a version of that package.
+     */
     @JsonProperty("currentCSVDesc")
     public void setCurrentCSVDesc(CSVDescription currentCSVDesc) {
         this.currentCSVDesc = currentCSVDesc;
     }
 
+    /**
+     * PackageChannel defines a single channel under a package, pointing to a version of that package.
+     */
     @JsonProperty("deprecation")
     public Deprecation getDeprecation() {
         return deprecation;
     }
 
+    /**
+     * PackageChannel defines a single channel under a package, pointing to a version of that package.
+     */
     @JsonProperty("deprecation")
     public void setDeprecation(Deprecation deprecation) {
         this.deprecation = deprecation;
     }
 
+    /**
+     * Entries lists all CSVs in the channel, with their upgrade edges.
+     */
     @JsonProperty("entries")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ChannelEntry> getEntries() {
         return entries;
     }
 
+    /**
+     * Entries lists all CSVs in the channel, with their upgrade edges.
+     */
     @JsonProperty("entries")
     public void setEntries(List<ChannelEntry> entries) {
         this.entries = entries;
     }
 
+    /**
+     * Name is the name of the channel, e.g. `alpha` or `stable`
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the channel, e.g. `alpha` or `stable`
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/PackageManifest.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/PackageManifest.java
index 53c67039ae2..98b2d550835 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/PackageManifest.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/PackageManifest.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PackageManifest holds information about a package, which is a reference to one (or more) channels under a single package.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class PackageManifest implements Editable<PackageManifestBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "packages.operators.coreos.com/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PackageManifest";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PackageManifest(String apiVersion, String kind, ObjectMeta metadata, Pack
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PackageManifest holds information about a package, which is a reference to one (or more) channels under a single package.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PackageManifest holds information about a package, which is a reference to one (or more) channels under a single package.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PackageManifest holds information about a package, which is a reference to one (or more) channels under a single package.
+     */
     @JsonProperty("spec")
     public PackageManifestSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PackageManifest holds information about a package, which is a reference to one (or more) channels under a single package.
+     */
     @JsonProperty("spec")
     public void setSpec(PackageManifestSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PackageManifest holds information about a package, which is a reference to one (or more) channels under a single package.
+     */
     @JsonProperty("status")
     public PackageManifestStatus getStatus() {
         return status;
     }
 
+    /**
+     * PackageManifest holds information about a package, which is a reference to one (or more) channels under a single package.
+     */
     @JsonProperty("status")
     public void setStatus(PackageManifestStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/PackageManifestList.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/PackageManifestList.java
index 28e43bd3cfe..b5858b97b7c 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/PackageManifestList.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/PackageManifestList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PackageManifestList is a list of PackageManifest objects.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class PackageManifestList implements Editable<PackageManifestListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operatorhub.packages.v1.PackageManifest>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "packages.operators.coreos.com/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operatorhub.packages.v1.PackageManifest> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PackageManifestList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PackageManifestList(String apiVersion, List<io.fabric8.openshift.api.mode
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * PackageManifestList is a list of PackageManifest objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operatorhub.packages.v1.PackageManifest> getItems() {
         return items;
     }
 
+    /**
+     * PackageManifestList is a list of PackageManifest objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operatorhub.packages.v1.PackageManifest> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PackageManifestList is a list of PackageManifest objects.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PackageManifestList is a list of PackageManifest objects.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/PackageManifestSpec.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/PackageManifestSpec.java
index 2641209144d..e97f5e67936 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/PackageManifestSpec.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/PackageManifestSpec.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PackageManifestSpec defines the desired state of PackageManifest
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/PackageManifestStatus.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/PackageManifestStatus.java
index 944e6ebcda3..a97b808fe7e 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/PackageManifestStatus.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/packages/v1/PackageManifestStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PackageManifestStatus represents the current status of the PackageManifest
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -113,92 +116,146 @@ public PackageManifestStatus(String catalogSource, String catalogSourceDisplayNa
         this.provider = provider;
     }
 
+    /**
+     * CatalogSource is the name of the CatalogSource this package belongs to
+     */
     @JsonProperty("catalogSource")
     public String getCatalogSource() {
         return catalogSource;
     }
 
+    /**
+     * CatalogSource is the name of the CatalogSource this package belongs to
+     */
     @JsonProperty("catalogSource")
     public void setCatalogSource(String catalogSource) {
         this.catalogSource = catalogSource;
     }
 
+    /**
+     * PackageManifestStatus represents the current status of the PackageManifest
+     */
     @JsonProperty("catalogSourceDisplayName")
     public String getCatalogSourceDisplayName() {
         return catalogSourceDisplayName;
     }
 
+    /**
+     * PackageManifestStatus represents the current status of the PackageManifest
+     */
     @JsonProperty("catalogSourceDisplayName")
     public void setCatalogSourceDisplayName(String catalogSourceDisplayName) {
         this.catalogSourceDisplayName = catalogSourceDisplayName;
     }
 
+    /**
+     * CatalogSourceNamespace is the namespace of the owning CatalogSource
+     */
     @JsonProperty("catalogSourceNamespace")
     public String getCatalogSourceNamespace() {
         return catalogSourceNamespace;
     }
 
+    /**
+     * CatalogSourceNamespace is the namespace of the owning CatalogSource
+     */
     @JsonProperty("catalogSourceNamespace")
     public void setCatalogSourceNamespace(String catalogSourceNamespace) {
         this.catalogSourceNamespace = catalogSourceNamespace;
     }
 
+    /**
+     * PackageManifestStatus represents the current status of the PackageManifest
+     */
     @JsonProperty("catalogSourcePublisher")
     public String getCatalogSourcePublisher() {
         return catalogSourcePublisher;
     }
 
+    /**
+     * PackageManifestStatus represents the current status of the PackageManifest
+     */
     @JsonProperty("catalogSourcePublisher")
     public void setCatalogSourcePublisher(String catalogSourcePublisher) {
         this.catalogSourcePublisher = catalogSourcePublisher;
     }
 
+    /**
+     * Channels are the declared channels for the package, ala `stable` or `alpha`.
+     */
     @JsonProperty("channels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PackageChannel> getChannels() {
         return channels;
     }
 
+    /**
+     * Channels are the declared channels for the package, ala `stable` or `alpha`.
+     */
     @JsonProperty("channels")
     public void setChannels(List<PackageChannel> channels) {
         this.channels = channels;
     }
 
+    /**
+     * DefaultChannel is, if specified, the name of the default channel for the package. The default channel will be installed if no other channel is explicitly given. If the package has a single channel, then that channel is implicitly the default.
+     */
     @JsonProperty("defaultChannel")
     public String getDefaultChannel() {
         return defaultChannel;
     }
 
+    /**
+     * DefaultChannel is, if specified, the name of the default channel for the package. The default channel will be installed if no other channel is explicitly given. If the package has a single channel, then that channel is implicitly the default.
+     */
     @JsonProperty("defaultChannel")
     public void setDefaultChannel(String defaultChannel) {
         this.defaultChannel = defaultChannel;
     }
 
+    /**
+     * PackageManifestStatus represents the current status of the PackageManifest
+     */
     @JsonProperty("deprecation")
     public Deprecation getDeprecation() {
         return deprecation;
     }
 
+    /**
+     * PackageManifestStatus represents the current status of the PackageManifest
+     */
     @JsonProperty("deprecation")
     public void setDeprecation(Deprecation deprecation) {
         this.deprecation = deprecation;
     }
 
+    /**
+     * PackageName is the name of the overall package, ala `etcd`.
+     */
     @JsonProperty("packageName")
     public String getPackageName() {
         return packageName;
     }
 
+    /**
+     * PackageName is the name of the overall package, ala `etcd`.
+     */
     @JsonProperty("packageName")
     public void setPackageName(String packageName) {
         this.packageName = packageName;
     }
 
+    /**
+     * PackageManifestStatus represents the current status of the PackageManifest
+     */
     @JsonProperty("provider")
     public AppLink getProvider() {
         return provider;
     }
 
+    /**
+     * PackageManifestStatus represents the current status of the PackageManifest
+     */
     @JsonProperty("provider")
     public void setProvider(AppLink provider) {
         this.provider = provider;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/Components.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/Components.java
index 1789f3b940a..57f88da294a 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/Components.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/Components.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Components tracks the resources that compose an operator.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public Components(LabelSelector labelSelector, List<RichReference> refs) {
         this.refs = refs;
     }
 
+    /**
+     * Components tracks the resources that compose an operator.
+     */
     @JsonProperty("labelSelector")
     public LabelSelector getLabelSelector() {
         return labelSelector;
     }
 
+    /**
+     * Components tracks the resources that compose an operator.
+     */
     @JsonProperty("labelSelector")
     public void setLabelSelector(LabelSelector labelSelector) {
         this.labelSelector = labelSelector;
     }
 
+    /**
+     * Refs are a set of references to the operator's component resources, selected with LabelSelector.
+     */
     @JsonProperty("refs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RichReference> getRefs() {
         return refs;
     }
 
+    /**
+     * Refs are a set of references to the operator's component resources, selected with LabelSelector.
+     */
     @JsonProperty("refs")
     public void setRefs(List<RichReference> refs) {
         this.refs = refs;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/Condition.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/Condition.java
index 9ee4d7d572f..f870b83a9e4 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/Condition.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/Condition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Condition represent the latest available observations of an component's state.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public Condition(String lastTransitionTime, String lastUpdateTime, String messag
         this.type = type;
     }
 
+    /**
+     * Condition represent the latest available observations of an component's state.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * Condition represent the latest available observations of an component's state.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Condition represent the latest available observations of an component's state.
+     */
     @JsonProperty("lastUpdateTime")
     public String getLastUpdateTime() {
         return lastUpdateTime;
     }
 
+    /**
+     * Condition represent the latest available observations of an component's state.
+     */
     @JsonProperty("lastUpdateTime")
     public void setLastUpdateTime(String lastUpdateTime) {
         this.lastUpdateTime = lastUpdateTime;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type of condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/Features.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/Features.java
index 6ec297ac988..eed35af2d65 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/Features.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/Features.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Features contains the list of configurable OLM features.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public Features(Boolean disableCopiedCSVs, String packageServerSyncInterval) {
         this.packageServerSyncInterval = packageServerSyncInterval;
     }
 
+    /**
+     * DisableCopiedCSVs is used to disable OLM's "Copied CSV" feature for operators installed at the cluster scope, where a cluster scoped operator is one that has been installed in an OperatorGroup that targets all namespaces. When reenabled, OLM will recreate the "Copied CSVs" for each cluster scoped operator.
+     */
     @JsonProperty("disableCopiedCSVs")
     public Boolean getDisableCopiedCSVs() {
         return disableCopiedCSVs;
     }
 
+    /**
+     * DisableCopiedCSVs is used to disable OLM's "Copied CSV" feature for operators installed at the cluster scope, where a cluster scoped operator is one that has been installed in an OperatorGroup that targets all namespaces. When reenabled, OLM will recreate the "Copied CSVs" for each cluster scoped operator.
+     */
     @JsonProperty("disableCopiedCSVs")
     public void setDisableCopiedCSVs(Boolean disableCopiedCSVs) {
         this.disableCopiedCSVs = disableCopiedCSVs;
     }
 
+    /**
+     * Features contains the list of configurable OLM features.
+     */
     @JsonProperty("packageServerSyncInterval")
     public String getPackageServerSyncInterval() {
         return packageServerSyncInterval;
     }
 
+    /**
+     * Features contains the list of configurable OLM features.
+     */
     @JsonProperty("packageServerSyncInterval")
     public void setPackageServerSyncInterval(String packageServerSyncInterval) {
         this.packageServerSyncInterval = packageServerSyncInterval;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OLMConfig.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OLMConfig.java
index e9fa40c8cf5..6b276ce0839 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OLMConfig.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OLMConfig.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OLMConfig is a resource responsible for configuring OLM.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class OLMConfig implements Editable<OLMConfigBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operators.coreos.com/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OLMConfig";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public OLMConfig(String apiVersion, String kind, ObjectMeta metadata, OLMConfigS
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OLMConfig is a resource responsible for configuring OLM.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OLMConfig is a resource responsible for configuring OLM.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * OLMConfig is a resource responsible for configuring OLM.
+     */
     @JsonProperty("spec")
     public OLMConfigSpec getSpec() {
         return spec;
     }
 
+    /**
+     * OLMConfig is a resource responsible for configuring OLM.
+     */
     @JsonProperty("spec")
     public void setSpec(OLMConfigSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * OLMConfig is a resource responsible for configuring OLM.
+     */
     @JsonProperty("status")
     public OLMConfigStatus getStatus() {
         return status;
     }
 
+    /**
+     * OLMConfig is a resource responsible for configuring OLM.
+     */
     @JsonProperty("status")
     public void setStatus(OLMConfigStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OLMConfigList.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OLMConfigList.java
index 5a9807701f7..badb63a7b8f 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OLMConfigList.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OLMConfigList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OLMConfigList is a list of OLMConfig resources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class OLMConfigList implements Editable<OLMConfigListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operatorhub.v1.OLMConfig>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operators.coreos.com/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operatorhub.v1.OLMConfig> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OLMConfigList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public OLMConfigList(String apiVersion, List<io.fabric8.openshift.api.model.oper
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * OLMConfigList is a list of OLMConfig resources.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operatorhub.v1.OLMConfig> getItems() {
         return items;
     }
 
+    /**
+     * OLMConfigList is a list of OLMConfig resources.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operatorhub.v1.OLMConfig> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OLMConfigList is a list of OLMConfig resources.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OLMConfigList is a list of OLMConfig resources.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OLMConfigSpec.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OLMConfigSpec.java
index 649f92b3844..0e2de7d35c2 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OLMConfigSpec.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OLMConfigSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OLMConfigSpec is the spec for an OLMConfig resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public OLMConfigSpec(Features features) {
         this.features = features;
     }
 
+    /**
+     * OLMConfigSpec is the spec for an OLMConfig resource.
+     */
     @JsonProperty("features")
     public Features getFeatures() {
         return features;
     }
 
+    /**
+     * OLMConfigSpec is the spec for an OLMConfig resource.
+     */
     @JsonProperty("features")
     public void setFeatures(Features features) {
         this.features = features;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OLMConfigStatus.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OLMConfigStatus.java
index a69377b0689..c5b9328456c 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OLMConfigStatus.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OLMConfigStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OLMConfigStatus is the status for an OLMConfig resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,12 +85,18 @@ public OLMConfigStatus(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * OLMConfigStatus is the status for an OLMConfig resource.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * OLMConfigStatus is the status for an OLMConfig resource.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/Operator.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/Operator.java
index c7f355e2195..d775b4e15a7 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/Operator.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/Operator.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Operator represents a cluster operator.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Operator implements Editable<OperatorBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operators.coreos.com/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Operator";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public Operator(String apiVersion, String kind, ObjectMeta metadata, OperatorSpe
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Operator represents a cluster operator.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Operator represents a cluster operator.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Operator represents a cluster operator.
+     */
     @JsonProperty("spec")
     public OperatorSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Operator represents a cluster operator.
+     */
     @JsonProperty("spec")
     public void setSpec(OperatorSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Operator represents a cluster operator.
+     */
     @JsonProperty("status")
     public OperatorStatus getStatus() {
         return status;
     }
 
+    /**
+     * Operator represents a cluster operator.
+     */
     @JsonProperty("status")
     public void setStatus(OperatorStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorCondition.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorCondition.java
index 890f2701069..fe29060273a 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorCondition.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorCondition.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorCondition is a Custom Resource of type `OperatorCondition` which is used to convey information to OLM about the state of an operator.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class OperatorCondition implements Editable<OperatorConditionBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operators.coreos.com/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OperatorCondition";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public OperatorCondition(String apiVersion, String kind, ObjectMeta metadata, Op
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OperatorCondition is a Custom Resource of type `OperatorCondition` which is used to convey information to OLM about the state of an operator.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OperatorCondition is a Custom Resource of type `OperatorCondition` which is used to convey information to OLM about the state of an operator.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * OperatorCondition is a Custom Resource of type `OperatorCondition` which is used to convey information to OLM about the state of an operator.
+     */
     @JsonProperty("spec")
     public OperatorConditionSpec getSpec() {
         return spec;
     }
 
+    /**
+     * OperatorCondition is a Custom Resource of type `OperatorCondition` which is used to convey information to OLM about the state of an operator.
+     */
     @JsonProperty("spec")
     public void setSpec(OperatorConditionSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * OperatorCondition is a Custom Resource of type `OperatorCondition` which is used to convey information to OLM about the state of an operator.
+     */
     @JsonProperty("status")
     public OperatorConditionStatus getStatus() {
         return status;
     }
 
+    /**
+     * OperatorCondition is a Custom Resource of type `OperatorCondition` which is used to convey information to OLM about the state of an operator.
+     */
     @JsonProperty("status")
     public void setStatus(OperatorConditionStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorConditionList.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorConditionList.java
index 53bfe1ec2ba..dd7cbfef951 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorConditionList.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorConditionList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorConditionList represents a list of Conditions.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class OperatorConditionList implements Editable<OperatorConditionListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operatorhub.v1.OperatorCondition>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operators.coreos.com/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operatorhub.v1.OperatorCondition> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OperatorConditionList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public OperatorConditionList(String apiVersion, List<io.fabric8.openshift.api.mo
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * OperatorConditionList represents a list of Conditions.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operatorhub.v1.OperatorCondition> getItems() {
         return items;
     }
 
+    /**
+     * OperatorConditionList represents a list of Conditions.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operatorhub.v1.OperatorCondition> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OperatorConditionList represents a list of Conditions.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OperatorConditionList represents a list of Conditions.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorConditionSpec.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorConditionSpec.java
index 31ce67206f8..2d6096ae536 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorConditionSpec.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorConditionSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorConditionSpec allows a cluster admin to convey information about the state of an operator to OLM, potentially overriding state reported by the operator.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -92,34 +95,52 @@ public OperatorConditionSpec(List<String> deployments, List<Condition> overrides
         this.serviceAccounts = serviceAccounts;
     }
 
+    /**
+     * OperatorConditionSpec allows a cluster admin to convey information about the state of an operator to OLM, potentially overriding state reported by the operator.
+     */
     @JsonProperty("deployments")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDeployments() {
         return deployments;
     }
 
+    /**
+     * OperatorConditionSpec allows a cluster admin to convey information about the state of an operator to OLM, potentially overriding state reported by the operator.
+     */
     @JsonProperty("deployments")
     public void setDeployments(List<String> deployments) {
         this.deployments = deployments;
     }
 
+    /**
+     * OperatorConditionSpec allows a cluster admin to convey information about the state of an operator to OLM, potentially overriding state reported by the operator.
+     */
     @JsonProperty("overrides")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getOverrides() {
         return overrides;
     }
 
+    /**
+     * OperatorConditionSpec allows a cluster admin to convey information about the state of an operator to OLM, potentially overriding state reported by the operator.
+     */
     @JsonProperty("overrides")
     public void setOverrides(List<Condition> overrides) {
         this.overrides = overrides;
     }
 
+    /**
+     * OperatorConditionSpec allows a cluster admin to convey information about the state of an operator to OLM, potentially overriding state reported by the operator.
+     */
     @JsonProperty("serviceAccounts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getServiceAccounts() {
         return serviceAccounts;
     }
 
+    /**
+     * OperatorConditionSpec allows a cluster admin to convey information about the state of an operator to OLM, potentially overriding state reported by the operator.
+     */
     @JsonProperty("serviceAccounts")
     public void setServiceAccounts(List<String> serviceAccounts) {
         this.serviceAccounts = serviceAccounts;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorConditionStatus.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorConditionStatus.java
index f9de6df379d..ef33342260c 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorConditionStatus.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorConditionStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorConditionStatus allows an operator to convey information its state to OLM. The status may trail the actual state of a system.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,12 +85,18 @@ public OperatorConditionStatus(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * OperatorConditionStatus allows an operator to convey information its state to OLM. The status may trail the actual state of a system.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * OperatorConditionStatus allows an operator to convey information its state to OLM. The status may trail the actual state of a system.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorGroup.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorGroup.java
index 73113c1a817..670cf64c453 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorGroup.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorGroup.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorGroup is the unit of multitenancy for OLM managed operators. It constrains the installation of operators in its namespace to a specified set of target namespaces.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class OperatorGroup implements Editable<OperatorGroupBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operators.coreos.com/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OperatorGroup";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public OperatorGroup(String apiVersion, String kind, ObjectMeta metadata, Operat
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OperatorGroup is the unit of multitenancy for OLM managed operators. It constrains the installation of operators in its namespace to a specified set of target namespaces.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OperatorGroup is the unit of multitenancy for OLM managed operators. It constrains the installation of operators in its namespace to a specified set of target namespaces.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * OperatorGroup is the unit of multitenancy for OLM managed operators. It constrains the installation of operators in its namespace to a specified set of target namespaces.
+     */
     @JsonProperty("spec")
     public OperatorGroupSpec getSpec() {
         return spec;
     }
 
+    /**
+     * OperatorGroup is the unit of multitenancy for OLM managed operators. It constrains the installation of operators in its namespace to a specified set of target namespaces.
+     */
     @JsonProperty("spec")
     public void setSpec(OperatorGroupSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * OperatorGroup is the unit of multitenancy for OLM managed operators. It constrains the installation of operators in its namespace to a specified set of target namespaces.
+     */
     @JsonProperty("status")
     public OperatorGroupStatus getStatus() {
         return status;
     }
 
+    /**
+     * OperatorGroup is the unit of multitenancy for OLM managed operators. It constrains the installation of operators in its namespace to a specified set of target namespaces.
+     */
     @JsonProperty("status")
     public void setStatus(OperatorGroupStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorGroupList.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorGroupList.java
index f0a2d0fb79d..7e7eaf87bcb 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorGroupList.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorGroupList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorGroupList is a list of OperatorGroup resources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class OperatorGroupList implements Editable<OperatorGroupListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operatorhub.v1.OperatorGroup>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operators.coreos.com/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operatorhub.v1.OperatorGroup> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OperatorGroupList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public OperatorGroupList(String apiVersion, List<io.fabric8.openshift.api.model.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * OperatorGroupList is a list of OperatorGroup resources.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operatorhub.v1.OperatorGroup> getItems() {
         return items;
     }
 
+    /**
+     * OperatorGroupList is a list of OperatorGroup resources.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operatorhub.v1.OperatorGroup> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OperatorGroupList is a list of OperatorGroup resources.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OperatorGroupList is a list of OperatorGroup resources.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorGroupSpec.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorGroupSpec.java
index bb2315a0daf..84dc4381ebe 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorGroupSpec.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorGroupSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorGroupSpec is the spec for an OperatorGroup resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -97,52 +100,82 @@ public OperatorGroupSpec(LabelSelector selector, String serviceAccountName, Bool
         this.upgradeStrategy = upgradeStrategy;
     }
 
+    /**
+     * OperatorGroupSpec is the spec for an OperatorGroup resource.
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * OperatorGroupSpec is the spec for an OperatorGroup resource.
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * ServiceAccountName is the admin specified service account which will be used to deploy operator(s) in this operator group.
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * ServiceAccountName is the admin specified service account which will be used to deploy operator(s) in this operator group.
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * Static tells OLM not to update the OperatorGroup's providedAPIs annotation
+     */
     @JsonProperty("staticProvidedAPIs")
     public Boolean getStaticProvidedAPIs() {
         return staticProvidedAPIs;
     }
 
+    /**
+     * Static tells OLM not to update the OperatorGroup's providedAPIs annotation
+     */
     @JsonProperty("staticProvidedAPIs")
     public void setStaticProvidedAPIs(Boolean staticProvidedAPIs) {
         this.staticProvidedAPIs = staticProvidedAPIs;
     }
 
+    /**
+     * TargetNamespaces is an explicit set of namespaces to target. If it is set, Selector is ignored.
+     */
     @JsonProperty("targetNamespaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getTargetNamespaces() {
         return targetNamespaces;
     }
 
+    /**
+     * TargetNamespaces is an explicit set of namespaces to target. If it is set, Selector is ignored.
+     */
     @JsonProperty("targetNamespaces")
     public void setTargetNamespaces(List<String> targetNamespaces) {
         this.targetNamespaces = targetNamespaces;
     }
 
+    /**
+     * UpgradeStrategy defines the upgrade strategy for operators in the namespace. There are currently two supported upgrade strategies:<br><p> <br><p> Default: OLM will only allow clusterServiceVersions to move to the replacing phase from the succeeded phase. This effectively means that OLM will not allow operators to move to the next version if an installation or upgrade has failed.<br><p> <br><p> TechPreviewUnsafeFailForward: OLM will allow clusterServiceVersions to move to the replacing phase from the succeeded phase or from the failed phase. Additionally, OLM will generate new installPlans when a subscription references a failed installPlan and the catalog has been updated with a new upgrade for the existing set of operators.<br><p> <br><p> WARNING: The TechPreviewUnsafeFailForward upgrade strategy is unsafe and may result in unexpected behavior or unrecoverable data loss unless you have deep understanding of the set of operators being managed in the namespace.
+     */
     @JsonProperty("upgradeStrategy")
     public String getUpgradeStrategy() {
         return upgradeStrategy;
     }
 
+    /**
+     * UpgradeStrategy defines the upgrade strategy for operators in the namespace. There are currently two supported upgrade strategies:<br><p> <br><p> Default: OLM will only allow clusterServiceVersions to move to the replacing phase from the succeeded phase. This effectively means that OLM will not allow operators to move to the next version if an installation or upgrade has failed.<br><p> <br><p> TechPreviewUnsafeFailForward: OLM will allow clusterServiceVersions to move to the replacing phase from the succeeded phase or from the failed phase. Additionally, OLM will generate new installPlans when a subscription references a failed installPlan and the catalog has been updated with a new upgrade for the existing set of operators.<br><p> <br><p> WARNING: The TechPreviewUnsafeFailForward upgrade strategy is unsafe and may result in unexpected behavior or unrecoverable data loss unless you have deep understanding of the set of operators being managed in the namespace.
+     */
     @JsonProperty("upgradeStrategy")
     public void setUpgradeStrategy(String upgradeStrategy) {
         this.upgradeStrategy = upgradeStrategy;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorGroupStatus.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorGroupStatus.java
index a4b62023333..f8d8ef73b11 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorGroupStatus.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorGroupStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorGroupStatus is the status for an OperatorGroupResource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,43 +98,67 @@ public OperatorGroupStatus(List<Condition> conditions, String lastUpdated, List<
         this.serviceAccountRef = serviceAccountRef;
     }
 
+    /**
+     * Conditions is an array of the OperatorGroup's conditions.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions is an array of the OperatorGroup's conditions.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * OperatorGroupStatus is the status for an OperatorGroupResource.
+     */
     @JsonProperty("lastUpdated")
     public String getLastUpdated() {
         return lastUpdated;
     }
 
+    /**
+     * OperatorGroupStatus is the status for an OperatorGroupResource.
+     */
     @JsonProperty("lastUpdated")
     public void setLastUpdated(String lastUpdated) {
         this.lastUpdated = lastUpdated;
     }
 
+    /**
+     * Namespaces is the set of target namespaces for the OperatorGroup.
+     */
     @JsonProperty("namespaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNamespaces() {
         return namespaces;
     }
 
+    /**
+     * Namespaces is the set of target namespaces for the OperatorGroup.
+     */
     @JsonProperty("namespaces")
     public void setNamespaces(List<String> namespaces) {
         this.namespaces = namespaces;
     }
 
+    /**
+     * OperatorGroupStatus is the status for an OperatorGroupResource.
+     */
     @JsonProperty("serviceAccountRef")
     public ObjectReference getServiceAccountRef() {
         return serviceAccountRef;
     }
 
+    /**
+     * OperatorGroupStatus is the status for an OperatorGroupResource.
+     */
     @JsonProperty("serviceAccountRef")
     public void setServiceAccountRef(ObjectReference serviceAccountRef) {
         this.serviceAccountRef = serviceAccountRef;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorList.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorList.java
index f2ed2f75b77..b9df7b74691 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorList.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorList contains a list of Operators.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class OperatorList implements Editable<OperatorListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operatorhub.v1.Operator>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operators.coreos.com/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operatorhub.v1.Operator> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OperatorList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public OperatorList(String apiVersion, List<io.fabric8.openshift.api.model.opera
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * OperatorList contains a list of Operators.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operatorhub.v1.Operator> getItems() {
         return items;
     }
 
+    /**
+     * OperatorList contains a list of Operators.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operatorhub.v1.Operator> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OperatorList contains a list of Operators.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OperatorList contains a list of Operators.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorSpec.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorSpec.java
index d942d908876..212dac84bbc 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorSpec.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorSpec.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorSpec defines the desired state of Operator
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorStatus.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorStatus.java
index cd8da41e5dc..41173917f28 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorStatus.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/OperatorStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorStatus defines the observed state of an Operator and its components
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public OperatorStatus(Components components) {
         this.components = components;
     }
 
+    /**
+     * OperatorStatus defines the observed state of an Operator and its components
+     */
     @JsonProperty("components")
     public Components getComponents() {
         return components;
     }
 
+    /**
+     * OperatorStatus defines the observed state of an Operator and its components
+     */
     @JsonProperty("components")
     public void setComponents(Components components) {
         this.components = components;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/RichReference.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/RichReference.java
index 26fd36f6daa..5d5957972ac 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/RichReference.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1/RichReference.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RichReference is a reference to a resource, enriched with its status conditions.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -109,82 +112,130 @@ public RichReference(String apiVersion, List<Condition> conditions, String field
         this.uid = uid;
     }
 
+    /**
+     * API version of the referent.
+     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
+    /**
+     * API version of the referent.
+     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Conditions represents the latest state of the component.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions represents the latest state of the component.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * If referring to a piece of an object instead of an entire object, this string should contain a valid JSON/Go field access statement, such as desiredState.manifest.containers[2]. For example, if the object reference is to a container within a pod, this would take on a value like: "spec.containers{name}" (where "name" refers to the name of the container that triggered the event) or if no container name is specified "spec.containers[2]" (container with index 2 in this pod). This syntax is chosen only to have some well-defined way of referencing a part of an object.
+     */
     @JsonProperty("fieldPath")
     public String getFieldPath() {
         return fieldPath;
     }
 
+    /**
+     * If referring to a piece of an object instead of an entire object, this string should contain a valid JSON/Go field access statement, such as desiredState.manifest.containers[2]. For example, if the object reference is to a container within a pod, this would take on a value like: "spec.containers{name}" (where "name" refers to the name of the container that triggered the event) or if no container name is specified "spec.containers[2]" (container with index 2 in this pod). This syntax is chosen only to have some well-defined way of referencing a part of an object.
+     */
     @JsonProperty("fieldPath")
     public void setFieldPath(String fieldPath) {
         this.fieldPath = fieldPath;
     }
 
+    /**
+     * Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Specific resourceVersion to which this reference is made, if any. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency
+     */
     @JsonProperty("resourceVersion")
     public String getResourceVersion() {
         return resourceVersion;
     }
 
+    /**
+     * Specific resourceVersion to which this reference is made, if any. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency
+     */
     @JsonProperty("resourceVersion")
     public void setResourceVersion(String resourceVersion) {
         this.resourceVersion = resourceVersion;
     }
 
+    /**
+     * UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids
+     */
     @JsonProperty("uid")
     public String getUid() {
         return uid;
     }
 
+    /**
+     * UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids
+     */
     @JsonProperty("uid")
     public void setUid(String uid) {
         this.uid = uid;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/APIResourceReference.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/APIResourceReference.java
index 5e7815532ca..0a7079396d7 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/APIResourceReference.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/APIResourceReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * APIResourceReference is a reference to a Kubernetes resource type that the referrer utilizes.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public APIResourceReference(String kind, String name, String version) {
         this.version = version;
     }
 
+    /**
+     * Kind of the referenced resource type.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * Kind of the referenced resource type.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Plural name of the referenced resource type (CustomResourceDefinition.Spec.Names[].Plural). Empty string if the referenced resource type is not a custom resource.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Plural name of the referenced resource type (CustomResourceDefinition.Spec.Names[].Plural). Empty string if the referenced resource type is not a custom resource.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * API Version of the referenced resource type.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * API Version of the referenced resource type.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/APIServiceDefinitions.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/APIServiceDefinitions.java
index fcb5a1ecda2..4e0b55e6c7d 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/APIServiceDefinitions.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/APIServiceDefinitions.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * APIServiceDefinitions declares all of the extension apis managed or required by an operator being ran by ClusterServiceVersion.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public APIServiceDefinitions(List<APIServiceDescription> owned, List<APIServiceD
         this.required = required;
     }
 
+    /**
+     * APIServiceDefinitions declares all of the extension apis managed or required by an operator being ran by ClusterServiceVersion.
+     */
     @JsonProperty("owned")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<APIServiceDescription> getOwned() {
         return owned;
     }
 
+    /**
+     * APIServiceDefinitions declares all of the extension apis managed or required by an operator being ran by ClusterServiceVersion.
+     */
     @JsonProperty("owned")
     public void setOwned(List<APIServiceDescription> owned) {
         this.owned = owned;
     }
 
+    /**
+     * APIServiceDefinitions declares all of the extension apis managed or required by an operator being ran by ClusterServiceVersion.
+     */
     @JsonProperty("required")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<APIServiceDescription> getRequired() {
         return required;
     }
 
+    /**
+     * APIServiceDefinitions declares all of the extension apis managed or required by an operator being ran by ClusterServiceVersion.
+     */
     @JsonProperty("required")
     public void setRequired(List<APIServiceDescription> required) {
         this.required = required;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/APIServiceDescription.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/APIServiceDescription.java
index d1bad8cf8d7..7feb4b1dd85 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/APIServiceDescription.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/APIServiceDescription.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * APIServiceDescription provides details to OLM about apis provided via aggregation
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -128,125 +131,197 @@ public APIServiceDescription(List<ActionDescriptor> actionDescriptors, Integer c
         this.version = version;
     }
 
+    /**
+     * APIServiceDescription provides details to OLM about apis provided via aggregation
+     */
     @JsonProperty("actionDescriptors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ActionDescriptor> getActionDescriptors() {
         return actionDescriptors;
     }
 
+    /**
+     * APIServiceDescription provides details to OLM about apis provided via aggregation
+     */
     @JsonProperty("actionDescriptors")
     public void setActionDescriptors(List<ActionDescriptor> actionDescriptors) {
         this.actionDescriptors = actionDescriptors;
     }
 
+    /**
+     * APIServiceDescription provides details to OLM about apis provided via aggregation
+     */
     @JsonProperty("containerPort")
     public Integer getContainerPort() {
         return containerPort;
     }
 
+    /**
+     * APIServiceDescription provides details to OLM about apis provided via aggregation
+     */
     @JsonProperty("containerPort")
     public void setContainerPort(Integer containerPort) {
         this.containerPort = containerPort;
     }
 
+    /**
+     * APIServiceDescription provides details to OLM about apis provided via aggregation
+     */
     @JsonProperty("deploymentName")
     public String getDeploymentName() {
         return deploymentName;
     }
 
+    /**
+     * APIServiceDescription provides details to OLM about apis provided via aggregation
+     */
     @JsonProperty("deploymentName")
     public void setDeploymentName(String deploymentName) {
         this.deploymentName = deploymentName;
     }
 
+    /**
+     * APIServiceDescription provides details to OLM about apis provided via aggregation
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * APIServiceDescription provides details to OLM about apis provided via aggregation
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * APIServiceDescription provides details to OLM about apis provided via aggregation
+     */
     @JsonProperty("displayName")
     public String getDisplayName() {
         return displayName;
     }
 
+    /**
+     * APIServiceDescription provides details to OLM about apis provided via aggregation
+     */
     @JsonProperty("displayName")
     public void setDisplayName(String displayName) {
         this.displayName = displayName;
     }
 
+    /**
+     * APIServiceDescription provides details to OLM about apis provided via aggregation
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * APIServiceDescription provides details to OLM about apis provided via aggregation
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * APIServiceDescription provides details to OLM about apis provided via aggregation
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * APIServiceDescription provides details to OLM about apis provided via aggregation
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * APIServiceDescription provides details to OLM about apis provided via aggregation
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * APIServiceDescription provides details to OLM about apis provided via aggregation
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * APIServiceDescription provides details to OLM about apis provided via aggregation
+     */
     @JsonProperty("resources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<APIResourceReference> getResources() {
         return resources;
     }
 
+    /**
+     * APIServiceDescription provides details to OLM about apis provided via aggregation
+     */
     @JsonProperty("resources")
     public void setResources(List<APIResourceReference> resources) {
         this.resources = resources;
     }
 
+    /**
+     * APIServiceDescription provides details to OLM about apis provided via aggregation
+     */
     @JsonProperty("specDescriptors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SpecDescriptor> getSpecDescriptors() {
         return specDescriptors;
     }
 
+    /**
+     * APIServiceDescription provides details to OLM about apis provided via aggregation
+     */
     @JsonProperty("specDescriptors")
     public void setSpecDescriptors(List<SpecDescriptor> specDescriptors) {
         this.specDescriptors = specDescriptors;
     }
 
+    /**
+     * APIServiceDescription provides details to OLM about apis provided via aggregation
+     */
     @JsonProperty("statusDescriptors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<StatusDescriptor> getStatusDescriptors() {
         return statusDescriptors;
     }
 
+    /**
+     * APIServiceDescription provides details to OLM about apis provided via aggregation
+     */
     @JsonProperty("statusDescriptors")
     public void setStatusDescriptors(List<StatusDescriptor> statusDescriptors) {
         this.statusDescriptors = statusDescriptors;
     }
 
+    /**
+     * APIServiceDescription provides details to OLM about apis provided via aggregation
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * APIServiceDescription provides details to OLM about apis provided via aggregation
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ActionDescriptor.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ActionDescriptor.java
index fb2ea6038d5..fa77e1a0801 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ActionDescriptor.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ActionDescriptor.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ActionDescriptor describes a declarative action that can be performed on a custom resource instance
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -97,52 +100,82 @@ public ActionDescriptor(String description, String displayName, String path, Str
         this.xDescriptors = xDescriptors;
     }
 
+    /**
+     * ActionDescriptor describes a declarative action that can be performed on a custom resource instance
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * ActionDescriptor describes a declarative action that can be performed on a custom resource instance
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * ActionDescriptor describes a declarative action that can be performed on a custom resource instance
+     */
     @JsonProperty("displayName")
     public String getDisplayName() {
         return displayName;
     }
 
+    /**
+     * ActionDescriptor describes a declarative action that can be performed on a custom resource instance
+     */
     @JsonProperty("displayName")
     public void setDisplayName(String displayName) {
         this.displayName = displayName;
     }
 
+    /**
+     * ActionDescriptor describes a declarative action that can be performed on a custom resource instance
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * ActionDescriptor describes a declarative action that can be performed on a custom resource instance
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * ActionDescriptor describes a declarative action that can be performed on a custom resource instance
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * ActionDescriptor describes a declarative action that can be performed on a custom resource instance
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
     }
 
+    /**
+     * ActionDescriptor describes a declarative action that can be performed on a custom resource instance
+     */
     @JsonProperty("x-descriptors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getXDescriptors() {
         return xDescriptors;
     }
 
+    /**
+     * ActionDescriptor describes a declarative action that can be performed on a custom resource instance
+     */
     @JsonProperty("x-descriptors")
     public void setXDescriptors(List<String> xDescriptors) {
         this.xDescriptors = xDescriptors;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/BundleLookup.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/BundleLookup.java
index 62653ec5847..423d1ee6053 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/BundleLookup.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/BundleLookup.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BundleLookup is a request to pull and unpackage the content of a bundle to the cluster.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,62 +104,98 @@ public BundleLookup(ObjectReference catalogSourceRef, List<BundleLookupCondition
         this.replaces = replaces;
     }
 
+    /**
+     * BundleLookup is a request to pull and unpackage the content of a bundle to the cluster.
+     */
     @JsonProperty("catalogSourceRef")
     public ObjectReference getCatalogSourceRef() {
         return catalogSourceRef;
     }
 
+    /**
+     * BundleLookup is a request to pull and unpackage the content of a bundle to the cluster.
+     */
     @JsonProperty("catalogSourceRef")
     public void setCatalogSourceRef(ObjectReference catalogSourceRef) {
         this.catalogSourceRef = catalogSourceRef;
     }
 
+    /**
+     * Conditions represents the overall state of a BundleLookup.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<BundleLookupCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions represents the overall state of a BundleLookup.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<BundleLookupCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Identifier is the catalog-unique name of the operator (the name of the CSV for bundles that contain CSVs)
+     */
     @JsonProperty("identifier")
     public String getIdentifier() {
         return identifier;
     }
 
+    /**
+     * Identifier is the catalog-unique name of the operator (the name of the CSV for bundles that contain CSVs)
+     */
     @JsonProperty("identifier")
     public void setIdentifier(String identifier) {
         this.identifier = identifier;
     }
 
+    /**
+     * Path refers to the location of a bundle to pull. It's typically an image reference.
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Path refers to the location of a bundle to pull. It's typically an image reference.
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * The effective properties of the unpacked bundle.
+     */
     @JsonProperty("properties")
     public String getProperties() {
         return properties;
     }
 
+    /**
+     * The effective properties of the unpacked bundle.
+     */
     @JsonProperty("properties")
     public void setProperties(String properties) {
         this.properties = properties;
     }
 
+    /**
+     * Replaces is the name of the bundle to replace with the one found at Path.
+     */
     @JsonProperty("replaces")
     public String getReplaces() {
         return replaces;
     }
 
+    /**
+     * Replaces is the name of the bundle to replace with the one found at Path.
+     */
     @JsonProperty("replaces")
     public void setReplaces(String replaces) {
         this.replaces = replaces;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/BundleLookupCondition.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/BundleLookupCondition.java
index 13c3275f4fe..79f596ae9ab 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/BundleLookupCondition.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/BundleLookupCondition.java
@@ -118,41 +118,65 @@ public void setLastUpdateTime(String lastUpdateTime) {
         this.lastUpdateTime = lastUpdateTime;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type of condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/CRDDescription.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/CRDDescription.java
index be5819b8c28..cac5fe72858 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/CRDDescription.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/CRDDescription.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CRDDescription provides details to OLM about the CRDs
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -116,95 +119,149 @@ public CRDDescription(List<ActionDescriptor> actionDescriptors, String descripti
         this.version = version;
     }
 
+    /**
+     * CRDDescription provides details to OLM about the CRDs
+     */
     @JsonProperty("actionDescriptors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ActionDescriptor> getActionDescriptors() {
         return actionDescriptors;
     }
 
+    /**
+     * CRDDescription provides details to OLM about the CRDs
+     */
     @JsonProperty("actionDescriptors")
     public void setActionDescriptors(List<ActionDescriptor> actionDescriptors) {
         this.actionDescriptors = actionDescriptors;
     }
 
+    /**
+     * CRDDescription provides details to OLM about the CRDs
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * CRDDescription provides details to OLM about the CRDs
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * CRDDescription provides details to OLM about the CRDs
+     */
     @JsonProperty("displayName")
     public String getDisplayName() {
         return displayName;
     }
 
+    /**
+     * CRDDescription provides details to OLM about the CRDs
+     */
     @JsonProperty("displayName")
     public void setDisplayName(String displayName) {
         this.displayName = displayName;
     }
 
+    /**
+     * CRDDescription provides details to OLM about the CRDs
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * CRDDescription provides details to OLM about the CRDs
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CRDDescription provides details to OLM about the CRDs
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * CRDDescription provides details to OLM about the CRDs
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * CRDDescription provides details to OLM about the CRDs
+     */
     @JsonProperty("resources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<APIResourceReference> getResources() {
         return resources;
     }
 
+    /**
+     * CRDDescription provides details to OLM about the CRDs
+     */
     @JsonProperty("resources")
     public void setResources(List<APIResourceReference> resources) {
         this.resources = resources;
     }
 
+    /**
+     * CRDDescription provides details to OLM about the CRDs
+     */
     @JsonProperty("specDescriptors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SpecDescriptor> getSpecDescriptors() {
         return specDescriptors;
     }
 
+    /**
+     * CRDDescription provides details to OLM about the CRDs
+     */
     @JsonProperty("specDescriptors")
     public void setSpecDescriptors(List<SpecDescriptor> specDescriptors) {
         this.specDescriptors = specDescriptors;
     }
 
+    /**
+     * CRDDescription provides details to OLM about the CRDs
+     */
     @JsonProperty("statusDescriptors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<StatusDescriptor> getStatusDescriptors() {
         return statusDescriptors;
     }
 
+    /**
+     * CRDDescription provides details to OLM about the CRDs
+     */
     @JsonProperty("statusDescriptors")
     public void setStatusDescriptors(List<StatusDescriptor> statusDescriptors) {
         this.statusDescriptors = statusDescriptors;
     }
 
+    /**
+     * CRDDescription provides details to OLM about the CRDs
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * CRDDescription provides details to OLM about the CRDs
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/CatalogSource.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/CatalogSource.java
index 5fb0dc64392..c81f1f706ee 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/CatalogSource.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/CatalogSource.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CatalogSource is a repository of CSVs, CRDs, and operator packages.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class CatalogSource implements Editable<CatalogSourceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operators.coreos.com/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CatalogSource";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CatalogSource(String apiVersion, String kind, ObjectMeta metadata, Catalo
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CatalogSource is a repository of CSVs, CRDs, and operator packages.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CatalogSource is a repository of CSVs, CRDs, and operator packages.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * CatalogSource is a repository of CSVs, CRDs, and operator packages.
+     */
     @JsonProperty("spec")
     public CatalogSourceSpec getSpec() {
         return spec;
     }
 
+    /**
+     * CatalogSource is a repository of CSVs, CRDs, and operator packages.
+     */
     @JsonProperty("spec")
     public void setSpec(CatalogSourceSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * CatalogSource is a repository of CSVs, CRDs, and operator packages.
+     */
     @JsonProperty("status")
     public CatalogSourceStatus getStatus() {
         return status;
     }
 
+    /**
+     * CatalogSource is a repository of CSVs, CRDs, and operator packages.
+     */
     @JsonProperty("status")
     public void setStatus(CatalogSourceStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/CatalogSourceList.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/CatalogSourceList.java
index 3c3202c5bfd..6ba409aa4aa 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/CatalogSourceList.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/CatalogSourceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CatalogSourceList is a repository of CSVs, CRDs, and operator packages.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class CatalogSourceList implements Editable<CatalogSourceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operatorhub.v1alpha1.CatalogSource>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operators.coreos.com/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operatorhub.v1alpha1.CatalogSource> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "CatalogSourceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public CatalogSourceList(String apiVersion, List<io.fabric8.openshift.api.model.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * CatalogSourceList is a repository of CSVs, CRDs, and operator packages.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operatorhub.v1alpha1.CatalogSource> getItems() {
         return items;
     }
 
+    /**
+     * CatalogSourceList is a repository of CSVs, CRDs, and operator packages.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operatorhub.v1alpha1.CatalogSource> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * CatalogSourceList is a repository of CSVs, CRDs, and operator packages.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * CatalogSourceList is a repository of CSVs, CRDs, and operator packages.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/CatalogSourceSpec.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/CatalogSourceSpec.java
index 7b82850f317..2587da7ee70 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/CatalogSourceSpec.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/CatalogSourceSpec.java
@@ -125,21 +125,33 @@ public CatalogSourceSpec(String address, String configMap, String description, S
         this.updateStrategy = updateStrategy;
     }
 
+    /**
+     * Address is a host that OLM can use to connect to a pre-existing registry. Format: &lt;registry-host or ip&gt;:&lt;port&gt; Only used when SourceType = SourceTypeGrpc. Ignored when the Image field is set.
+     */
     @JsonProperty("address")
     public String getAddress() {
         return address;
     }
 
+    /**
+     * Address is a host that OLM can use to connect to a pre-existing registry. Format: &lt;registry-host or ip&gt;:&lt;port&gt; Only used when SourceType = SourceTypeGrpc. Ignored when the Image field is set.
+     */
     @JsonProperty("address")
     public void setAddress(String address) {
         this.address = address;
     }
 
+    /**
+     * ConfigMap is the name of the ConfigMap to be used to back a configmap-server registry. Only used when SourceType = SourceTypeConfigmap or SourceTypeInternal.
+     */
     @JsonProperty("configMap")
     public String getConfigMap() {
         return configMap;
     }
 
+    /**
+     * ConfigMap is the name of the ConfigMap to be used to back a configmap-server registry. Only used when SourceType = SourceTypeConfigmap or SourceTypeInternal.
+     */
     @JsonProperty("configMap")
     public void setConfigMap(String configMap) {
         this.configMap = configMap;
@@ -155,11 +167,17 @@ public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * Metadata
+     */
     @JsonProperty("displayName")
     public String getDisplayName() {
         return displayName;
     }
 
+    /**
+     * Metadata
+     */
     @JsonProperty("displayName")
     public void setDisplayName(String displayName) {
         this.displayName = displayName;
@@ -185,21 +203,33 @@ public void setIcon(Icon icon) {
         this.icon = icon;
     }
 
+    /**
+     * Image is an operator-registry container image to instantiate a registry-server with. Only used when SourceType = SourceTypeGrpc. If present, the address field is ignored.
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * Image is an operator-registry container image to instantiate a registry-server with. Only used when SourceType = SourceTypeGrpc. If present, the address field is ignored.
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
     }
 
+    /**
+     * Priority field assigns a weight to the catalog source to prioritize them so that it can be consumed by the dependency resolver. Usage: Higher weight indicates that this catalog source is preferred over lower weighted catalog sources during dependency resolution. The range of the priority value can go from positive to negative in the range of int32. The default value to a catalog source with unassigned priority would be 0. The catalog source with the same priority values will be ranked lexicographically based on its name.
+     */
     @JsonProperty("priority")
     public Integer getPriority() {
         return priority;
     }
 
+    /**
+     * Priority field assigns a weight to the catalog source to prioritize them so that it can be consumed by the dependency resolver. Usage: Higher weight indicates that this catalog source is preferred over lower weighted catalog sources during dependency resolution. The range of the priority value can go from positive to negative in the range of int32. The default value to a catalog source with unassigned priority would be 0. The catalog source with the same priority values will be ranked lexicographically based on its name.
+     */
     @JsonProperty("priority")
     public void setPriority(Integer priority) {
         this.priority = priority;
@@ -215,22 +245,34 @@ public void setPublisher(String publisher) {
         this.publisher = publisher;
     }
 
+    /**
+     * Secrets represent set of secrets that can be used to access the contents of the catalog. It is best to keep this list small, since each will need to be tried for every catalog entry.
+     */
     @JsonProperty("secrets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSecrets() {
         return secrets;
     }
 
+    /**
+     * Secrets represent set of secrets that can be used to access the contents of the catalog. It is best to keep this list small, since each will need to be tried for every catalog entry.
+     */
     @JsonProperty("secrets")
     public void setSecrets(List<String> secrets) {
         this.secrets = secrets;
     }
 
+    /**
+     * SourceType is the type of source
+     */
     @JsonProperty("sourceType")
     public String getSourceType() {
         return sourceType;
     }
 
+    /**
+     * SourceType is the type of source
+     */
     @JsonProperty("sourceType")
     public void setSourceType(String sourceType) {
         this.sourceType = sourceType;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/CatalogSourceStatus.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/CatalogSourceStatus.java
index ce40251e488..19cc03b4db8 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/CatalogSourceStatus.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/CatalogSourceStatus.java
@@ -106,12 +106,18 @@ public CatalogSourceStatus(List<Condition> conditions, ConfigMapResourceReferenc
         this.registryService = registryService;
     }
 
+    /**
+     * Represents the state of a CatalogSource. Note that Message and Reason represent the original status information, which may be migrated to be conditions based in the future. Any new features introduced will use conditions.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Represents the state of a CatalogSource. Note that Message and Reason represent the original status information, which may be migrated to be conditions based in the future. Any new features introduced will use conditions.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
@@ -147,21 +153,33 @@ public void setLatestImageRegistryPoll(String latestImageRegistryPoll) {
         this.latestImageRegistryPoll = latestImageRegistryPoll;
     }
 
+    /**
+     * A human readable message indicating details about why the CatalogSource is in this condition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * A human readable message indicating details about why the CatalogSource is in this condition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Reason is the reason the CatalogSource was transitioned to its current state.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason is the reason the CatalogSource was transitioned to its current state.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/CleanupStatus.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/CleanupStatus.java
index 117b783a56e..e0403397a3a 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/CleanupStatus.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/CleanupStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CleanupStatus represents information about the status of cleanup while a CSV is pending deletion
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public CleanupStatus(List<ResourceList> pendingDeletion) {
         this.pendingDeletion = pendingDeletion;
     }
 
+    /**
+     * PendingDeletion is the list of custom resource objects that are pending deletion and blocked on finalizers. This indicates the progress of cleanup that is blocking CSV deletion or operator uninstall.
+     */
     @JsonProperty("pendingDeletion")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ResourceList> getPendingDeletion() {
         return pendingDeletion;
     }
 
+    /**
+     * PendingDeletion is the list of custom resource objects that are pending deletion and blocked on finalizers. This indicates the progress of cleanup that is blocking CSV deletion or operator uninstall.
+     */
     @JsonProperty("pendingDeletion")
     public void setPendingDeletion(List<ResourceList> pendingDeletion) {
         this.pendingDeletion = pendingDeletion;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ClusterServiceVersion.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ClusterServiceVersion.java
index af0f69de589..82e4c01d217 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ClusterServiceVersion.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ClusterServiceVersion.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterServiceVersion is a Custom Resource of type `ClusterServiceVersionSpec`.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class ClusterServiceVersion implements Editable<ClusterServiceVersionBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operators.coreos.com/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterServiceVersion";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterServiceVersion(String apiVersion, String kind, ObjectMeta metadata
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterServiceVersion is a Custom Resource of type `ClusterServiceVersionSpec`.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterServiceVersion is a Custom Resource of type `ClusterServiceVersionSpec`.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ClusterServiceVersion is a Custom Resource of type `ClusterServiceVersionSpec`.
+     */
     @JsonProperty("spec")
     public ClusterServiceVersionSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ClusterServiceVersion is a Custom Resource of type `ClusterServiceVersionSpec`.
+     */
     @JsonProperty("spec")
     public void setSpec(ClusterServiceVersionSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ClusterServiceVersion is a Custom Resource of type `ClusterServiceVersionSpec`.
+     */
     @JsonProperty("status")
     public ClusterServiceVersionStatus getStatus() {
         return status;
     }
 
+    /**
+     * ClusterServiceVersion is a Custom Resource of type `ClusterServiceVersionSpec`.
+     */
     @JsonProperty("status")
     public void setStatus(ClusterServiceVersionStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ClusterServiceVersionCondition.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ClusterServiceVersionCondition.java
index eb867c2bb15..bf6bcbecdaa 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ClusterServiceVersionCondition.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ClusterServiceVersionCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Conditions appear in the status as a record of state transitions on the ClusterServiceVersion
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public ClusterServiceVersionCondition(String lastTransitionTime, String lastUpda
         this.reason = reason;
     }
 
+    /**
+     * Conditions appear in the status as a record of state transitions on the ClusterServiceVersion
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * Conditions appear in the status as a record of state transitions on the ClusterServiceVersion
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Conditions appear in the status as a record of state transitions on the ClusterServiceVersion
+     */
     @JsonProperty("lastUpdateTime")
     public String getLastUpdateTime() {
         return lastUpdateTime;
     }
 
+    /**
+     * Conditions appear in the status as a record of state transitions on the ClusterServiceVersion
+     */
     @JsonProperty("lastUpdateTime")
     public void setLastUpdateTime(String lastUpdateTime) {
         this.lastUpdateTime = lastUpdateTime;
     }
 
+    /**
+     * A human readable message indicating details about why the ClusterServiceVersion is in this condition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * A human readable message indicating details about why the ClusterServiceVersion is in this condition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Condition of the ClusterServiceVersion
+     */
     @JsonProperty("phase")
     public String getPhase() {
         return phase;
     }
 
+    /**
+     * Condition of the ClusterServiceVersion
+     */
     @JsonProperty("phase")
     public void setPhase(String phase) {
         this.phase = phase;
     }
 
+    /**
+     * A brief CamelCase message indicating details about why the ClusterServiceVersion is in this state. e.g. 'RequirementsNotMet'
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * A brief CamelCase message indicating details about why the ClusterServiceVersion is in this state. e.g. 'RequirementsNotMet'
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ClusterServiceVersionList.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ClusterServiceVersionList.java
index 28dcf2db9e1..f72b260cbdd 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ClusterServiceVersionList.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ClusterServiceVersionList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterServiceVersionList represents a list of ClusterServiceVersions.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ClusterServiceVersionList implements Editable<ClusterServiceVersionListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operatorhub.v1alpha1.ClusterServiceVersion>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operators.coreos.com/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operatorhub.v1alpha1.ClusterServiceVersion> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterServiceVersionList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterServiceVersionList(String apiVersion, List<io.fabric8.openshift.ap
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ClusterServiceVersionList represents a list of ClusterServiceVersions.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operatorhub.v1alpha1.ClusterServiceVersion> getItems() {
         return items;
     }
 
+    /**
+     * ClusterServiceVersionList represents a list of ClusterServiceVersions.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operatorhub.v1alpha1.ClusterServiceVersion> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterServiceVersionList represents a list of ClusterServiceVersions.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterServiceVersionList represents a list of ClusterServiceVersions.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ClusterServiceVersionSpec.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ClusterServiceVersionSpec.java
index 47a0b7d95ae..0870f1bfb64 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ClusterServiceVersionSpec.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ClusterServiceVersionSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterServiceVersionSpec declarations tell OLM how to install an operator that can manage apps for a given version.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -180,242 +183,380 @@ public ClusterServiceVersionSpec(Map<String, String> annotations, APIServiceDefi
         this.webhookdefinitions = webhookdefinitions;
     }
 
+    /**
+     * Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * ClusterServiceVersionSpec declarations tell OLM how to install an operator that can manage apps for a given version.
+     */
     @JsonProperty("apiservicedefinitions")
     public APIServiceDefinitions getApiservicedefinitions() {
         return apiservicedefinitions;
     }
 
+    /**
+     * ClusterServiceVersionSpec declarations tell OLM how to install an operator that can manage apps for a given version.
+     */
     @JsonProperty("apiservicedefinitions")
     public void setApiservicedefinitions(APIServiceDefinitions apiservicedefinitions) {
         this.apiservicedefinitions = apiservicedefinitions;
     }
 
+    /**
+     * ClusterServiceVersionSpec declarations tell OLM how to install an operator that can manage apps for a given version.
+     */
     @JsonProperty("cleanup")
     public CleanupSpec getCleanup() {
         return cleanup;
     }
 
+    /**
+     * ClusterServiceVersionSpec declarations tell OLM how to install an operator that can manage apps for a given version.
+     */
     @JsonProperty("cleanup")
     public void setCleanup(CleanupSpec cleanup) {
         this.cleanup = cleanup;
     }
 
+    /**
+     * ClusterServiceVersionSpec declarations tell OLM how to install an operator that can manage apps for a given version.
+     */
     @JsonProperty("customresourcedefinitions")
     public CustomResourceDefinitions getCustomresourcedefinitions() {
         return customresourcedefinitions;
     }
 
+    /**
+     * ClusterServiceVersionSpec declarations tell OLM how to install an operator that can manage apps for a given version.
+     */
     @JsonProperty("customresourcedefinitions")
     public void setCustomresourcedefinitions(CustomResourceDefinitions customresourcedefinitions) {
         this.customresourcedefinitions = customresourcedefinitions;
     }
 
+    /**
+     * Description of the operator. Can include the features, limitations or use-cases of the operator.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description of the operator. Can include the features, limitations or use-cases of the operator.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * The name of the operator in display format.
+     */
     @JsonProperty("displayName")
     public String getDisplayName() {
         return displayName;
     }
 
+    /**
+     * The name of the operator in display format.
+     */
     @JsonProperty("displayName")
     public void setDisplayName(String displayName) {
         this.displayName = displayName;
     }
 
+    /**
+     * The icon for this operator.
+     */
     @JsonProperty("icon")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Icon> getIcon() {
         return icon;
     }
 
+    /**
+     * The icon for this operator.
+     */
     @JsonProperty("icon")
     public void setIcon(List<Icon> icon) {
         this.icon = icon;
     }
 
+    /**
+     * ClusterServiceVersionSpec declarations tell OLM how to install an operator that can manage apps for a given version.
+     */
     @JsonProperty("install")
     public NamedInstallStrategy getInstall() {
         return install;
     }
 
+    /**
+     * ClusterServiceVersionSpec declarations tell OLM how to install an operator that can manage apps for a given version.
+     */
     @JsonProperty("install")
     public void setInstall(NamedInstallStrategy install) {
         this.install = install;
     }
 
+    /**
+     * InstallModes specify supported installation types
+     */
     @JsonProperty("installModes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<InstallMode> getInstallModes() {
         return installModes;
     }
 
+    /**
+     * InstallModes specify supported installation types
+     */
     @JsonProperty("installModes")
     public void setInstallModes(List<InstallMode> installModes) {
         this.installModes = installModes;
     }
 
+    /**
+     * A list of keywords describing the operator.
+     */
     @JsonProperty("keywords")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getKeywords() {
         return keywords;
     }
 
+    /**
+     * A list of keywords describing the operator.
+     */
     @JsonProperty("keywords")
     public void setKeywords(List<String> keywords) {
         this.keywords = keywords;
     }
 
+    /**
+     * Map of string keys and values that can be used to organize and categorize (scope and select) objects.
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabels() {
         return labels;
     }
 
+    /**
+     * Map of string keys and values that can be used to organize and categorize (scope and select) objects.
+     */
     @JsonProperty("labels")
     public void setLabels(Map<String, String> labels) {
         this.labels = labels;
     }
 
+    /**
+     * A list of links related to the operator.
+     */
     @JsonProperty("links")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AppLink> getLinks() {
         return links;
     }
 
+    /**
+     * A list of links related to the operator.
+     */
     @JsonProperty("links")
     public void setLinks(List<AppLink> links) {
         this.links = links;
     }
 
+    /**
+     * A list of organizational entities maintaining the operator.
+     */
     @JsonProperty("maintainers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Maintainer> getMaintainers() {
         return maintainers;
     }
 
+    /**
+     * A list of organizational entities maintaining the operator.
+     */
     @JsonProperty("maintainers")
     public void setMaintainers(List<Maintainer> maintainers) {
         this.maintainers = maintainers;
     }
 
+    /**
+     * ClusterServiceVersionSpec declarations tell OLM how to install an operator that can manage apps for a given version.
+     */
     @JsonProperty("maturity")
     public String getMaturity() {
         return maturity;
     }
 
+    /**
+     * ClusterServiceVersionSpec declarations tell OLM how to install an operator that can manage apps for a given version.
+     */
     @JsonProperty("maturity")
     public void setMaturity(String maturity) {
         this.maturity = maturity;
     }
 
+    /**
+     * ClusterServiceVersionSpec declarations tell OLM how to install an operator that can manage apps for a given version.
+     */
     @JsonProperty("minKubeVersion")
     public String getMinKubeVersion() {
         return minKubeVersion;
     }
 
+    /**
+     * ClusterServiceVersionSpec declarations tell OLM how to install an operator that can manage apps for a given version.
+     */
     @JsonProperty("minKubeVersion")
     public void setMinKubeVersion(String minKubeVersion) {
         this.minKubeVersion = minKubeVersion;
     }
 
+    /**
+     * ClusterServiceVersionSpec declarations tell OLM how to install an operator that can manage apps for a given version.
+     */
     @JsonProperty("nativeAPIs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GroupVersionKind> getNativeAPIs() {
         return nativeAPIs;
     }
 
+    /**
+     * ClusterServiceVersionSpec declarations tell OLM how to install an operator that can manage apps for a given version.
+     */
     @JsonProperty("nativeAPIs")
     public void setNativeAPIs(List<GroupVersionKind> nativeAPIs) {
         this.nativeAPIs = nativeAPIs;
     }
 
+    /**
+     * ClusterServiceVersionSpec declarations tell OLM how to install an operator that can manage apps for a given version.
+     */
     @JsonProperty("provider")
     public AppLink getProvider() {
         return provider;
     }
 
+    /**
+     * ClusterServiceVersionSpec declarations tell OLM how to install an operator that can manage apps for a given version.
+     */
     @JsonProperty("provider")
     public void setProvider(AppLink provider) {
         this.provider = provider;
     }
 
+    /**
+     * List any related images, or other container images that your Operator might require to perform their functions. This list should also include operand images as well. All image references should be specified by digest (SHA) and not by tag. This field is only used during catalog creation and plays no part in cluster runtime.
+     */
     @JsonProperty("relatedImages")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RelatedImage> getRelatedImages() {
         return relatedImages;
     }
 
+    /**
+     * List any related images, or other container images that your Operator might require to perform their functions. This list should also include operand images as well. All image references should be specified by digest (SHA) and not by tag. This field is only used during catalog creation and plays no part in cluster runtime.
+     */
     @JsonProperty("relatedImages")
     public void setRelatedImages(List<RelatedImage> relatedImages) {
         this.relatedImages = relatedImages;
     }
 
+    /**
+     * The name of a CSV this one replaces. Should match the `metadata.Name` field of the old CSV.
+     */
     @JsonProperty("replaces")
     public String getReplaces() {
         return replaces;
     }
 
+    /**
+     * The name of a CSV this one replaces. Should match the `metadata.Name` field of the old CSV.
+     */
     @JsonProperty("replaces")
     public void setReplaces(String replaces) {
         this.replaces = replaces;
     }
 
+    /**
+     * ClusterServiceVersionSpec declarations tell OLM how to install an operator that can manage apps for a given version.
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * ClusterServiceVersionSpec declarations tell OLM how to install an operator that can manage apps for a given version.
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * The name(s) of one or more CSV(s) that should be skipped in the upgrade graph. Should match the `metadata.Name` field of the CSV that should be skipped. This field is only used during catalog creation and plays no part in cluster runtime.
+     */
     @JsonProperty("skips")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSkips() {
         return skips;
     }
 
+    /**
+     * The name(s) of one or more CSV(s) that should be skipped in the upgrade graph. Should match the `metadata.Name` field of the CSV that should be skipped. This field is only used during catalog creation and plays no part in cluster runtime.
+     */
     @JsonProperty("skips")
     public void setSkips(List<String> skips) {
         this.skips = skips;
     }
 
+    /**
+     * ClusterServiceVersionSpec declarations tell OLM how to install an operator that can manage apps for a given version.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * ClusterServiceVersionSpec declarations tell OLM how to install an operator that can manage apps for a given version.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
     }
 
+    /**
+     * ClusterServiceVersionSpec declarations tell OLM how to install an operator that can manage apps for a given version.
+     */
     @JsonProperty("webhookdefinitions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<WebhookDescription> getWebhookdefinitions() {
         return webhookdefinitions;
     }
 
+    /**
+     * ClusterServiceVersionSpec declarations tell OLM how to install an operator that can manage apps for a given version.
+     */
     @JsonProperty("webhookdefinitions")
     public void setWebhookdefinitions(List<WebhookDescription> webhookdefinitions) {
         this.webhookdefinitions = webhookdefinitions;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ClusterServiceVersionStatus.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ClusterServiceVersionStatus.java
index 85190160ff0..9e31f9527e2 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ClusterServiceVersionStatus.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ClusterServiceVersionStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterServiceVersionStatus represents information about the status of a CSV. Status may trail the actual state of a system.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -118,103 +121,163 @@ public ClusterServiceVersionStatus(String certsLastUpdated, String certsRotateAt
         this.requirementStatus = requirementStatus;
     }
 
+    /**
+     * ClusterServiceVersionStatus represents information about the status of a CSV. Status may trail the actual state of a system.
+     */
     @JsonProperty("certsLastUpdated")
     public String getCertsLastUpdated() {
         return certsLastUpdated;
     }
 
+    /**
+     * ClusterServiceVersionStatus represents information about the status of a CSV. Status may trail the actual state of a system.
+     */
     @JsonProperty("certsLastUpdated")
     public void setCertsLastUpdated(String certsLastUpdated) {
         this.certsLastUpdated = certsLastUpdated;
     }
 
+    /**
+     * ClusterServiceVersionStatus represents information about the status of a CSV. Status may trail the actual state of a system.
+     */
     @JsonProperty("certsRotateAt")
     public String getCertsRotateAt() {
         return certsRotateAt;
     }
 
+    /**
+     * ClusterServiceVersionStatus represents information about the status of a CSV. Status may trail the actual state of a system.
+     */
     @JsonProperty("certsRotateAt")
     public void setCertsRotateAt(String certsRotateAt) {
         this.certsRotateAt = certsRotateAt;
     }
 
+    /**
+     * ClusterServiceVersionStatus represents information about the status of a CSV. Status may trail the actual state of a system.
+     */
     @JsonProperty("cleanup")
     public CleanupStatus getCleanup() {
         return cleanup;
     }
 
+    /**
+     * ClusterServiceVersionStatus represents information about the status of a CSV. Status may trail the actual state of a system.
+     */
     @JsonProperty("cleanup")
     public void setCleanup(CleanupStatus cleanup) {
         this.cleanup = cleanup;
     }
 
+    /**
+     * List of conditions, a history of state transitions
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ClusterServiceVersionCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * List of conditions, a history of state transitions
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ClusterServiceVersionCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * ClusterServiceVersionStatus represents information about the status of a CSV. Status may trail the actual state of a system.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * ClusterServiceVersionStatus represents information about the status of a CSV. Status may trail the actual state of a system.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * ClusterServiceVersionStatus represents information about the status of a CSV. Status may trail the actual state of a system.
+     */
     @JsonProperty("lastUpdateTime")
     public String getLastUpdateTime() {
         return lastUpdateTime;
     }
 
+    /**
+     * ClusterServiceVersionStatus represents information about the status of a CSV. Status may trail the actual state of a system.
+     */
     @JsonProperty("lastUpdateTime")
     public void setLastUpdateTime(String lastUpdateTime) {
         this.lastUpdateTime = lastUpdateTime;
     }
 
+    /**
+     * A human readable message indicating details about why the ClusterServiceVersion is in this condition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * A human readable message indicating details about why the ClusterServiceVersion is in this condition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Current condition of the ClusterServiceVersion
+     */
     @JsonProperty("phase")
     public String getPhase() {
         return phase;
     }
 
+    /**
+     * Current condition of the ClusterServiceVersion
+     */
     @JsonProperty("phase")
     public void setPhase(String phase) {
         this.phase = phase;
     }
 
+    /**
+     * A brief CamelCase message indicating details about why the ClusterServiceVersion is in this state. e.g. 'RequirementsNotMet'
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * A brief CamelCase message indicating details about why the ClusterServiceVersion is in this state. e.g. 'RequirementsNotMet'
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * The status of each requirement for this CSV
+     */
     @JsonProperty("requirementStatus")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RequirementStatus> getRequirementStatus() {
         return requirementStatus;
     }
 
+    /**
+     * The status of each requirement for this CSV
+     */
     @JsonProperty("requirementStatus")
     public void setRequirementStatus(List<RequirementStatus> requirementStatus) {
         this.requirementStatus = requirementStatus;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/CustomResourceDefinitions.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/CustomResourceDefinitions.java
index 803b55b7fde..61693511929 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/CustomResourceDefinitions.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/CustomResourceDefinitions.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomResourceDefinitions declares all of the CRDs managed or required by an operator being ran by ClusterServiceVersion.<br><p> <br><p> If the CRD is present in the Owned list, it is implicitly required.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public CustomResourceDefinitions(List<CRDDescription> owned, List<CRDDescription
         this.required = required;
     }
 
+    /**
+     * CustomResourceDefinitions declares all of the CRDs managed or required by an operator being ran by ClusterServiceVersion.<br><p> <br><p> If the CRD is present in the Owned list, it is implicitly required.
+     */
     @JsonProperty("owned")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CRDDescription> getOwned() {
         return owned;
     }
 
+    /**
+     * CustomResourceDefinitions declares all of the CRDs managed or required by an operator being ran by ClusterServiceVersion.<br><p> <br><p> If the CRD is present in the Owned list, it is implicitly required.
+     */
     @JsonProperty("owned")
     public void setOwned(List<CRDDescription> owned) {
         this.owned = owned;
     }
 
+    /**
+     * CustomResourceDefinitions declares all of the CRDs managed or required by an operator being ran by ClusterServiceVersion.<br><p> <br><p> If the CRD is present in the Owned list, it is implicitly required.
+     */
     @JsonProperty("required")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<CRDDescription> getRequired() {
         return required;
     }
 
+    /**
+     * CustomResourceDefinitions declares all of the CRDs managed or required by an operator being ran by ClusterServiceVersion.<br><p> <br><p> If the CRD is present in the Owned list, it is implicitly required.
+     */
     @JsonProperty("required")
     public void setRequired(List<CRDDescription> required) {
         this.required = required;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/DependentStatus.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/DependentStatus.java
index b83ed2c6c6c..e2fdf66cd30 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/DependentStatus.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/DependentStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DependentStatus is the status for a dependent requirement (to prevent infinite nesting)
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public DependentStatus(String group, String kind, String message, String status,
         this.version = version;
     }
 
+    /**
+     * DependentStatus is the status for a dependent requirement (to prevent infinite nesting)
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * DependentStatus is the status for a dependent requirement (to prevent infinite nesting)
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * DependentStatus is the status for a dependent requirement (to prevent infinite nesting)
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * DependentStatus is the status for a dependent requirement (to prevent infinite nesting)
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DependentStatus is the status for a dependent requirement (to prevent infinite nesting)
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * DependentStatus is the status for a dependent requirement (to prevent infinite nesting)
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * DependentStatus is the status for a dependent requirement (to prevent infinite nesting)
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * DependentStatus is the status for a dependent requirement (to prevent infinite nesting)
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * DependentStatus is the status for a dependent requirement (to prevent infinite nesting)
+     */
     @JsonProperty("uuid")
     public String getUuid() {
         return uuid;
     }
 
+    /**
+     * DependentStatus is the status for a dependent requirement (to prevent infinite nesting)
+     */
     @JsonProperty("uuid")
     public void setUuid(String uuid) {
         this.uuid = uuid;
     }
 
+    /**
+     * DependentStatus is the status for a dependent requirement (to prevent infinite nesting)
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * DependentStatus is the status for a dependent requirement (to prevent infinite nesting)
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ExtractContentConfig.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ExtractContentConfig.java
index 3bea0c593e3..d4469342d5b 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ExtractContentConfig.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ExtractContentConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ExtractContentConfig configures context extraction from a file-based catalog index image.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ExtractContentConfig(String cacheDir, String catalogDir) {
         this.catalogDir = catalogDir;
     }
 
+    /**
+     * CacheDir is the directory storing the pre-calculated API cache.
+     */
     @JsonProperty("cacheDir")
     public String getCacheDir() {
         return cacheDir;
     }
 
+    /**
+     * CacheDir is the directory storing the pre-calculated API cache.
+     */
     @JsonProperty("cacheDir")
     public void setCacheDir(String cacheDir) {
         this.cacheDir = cacheDir;
     }
 
+    /**
+     * CatalogDir is the directory storing the file-based catalog contents.
+     */
     @JsonProperty("catalogDir")
     public String getCatalogDir() {
         return catalogDir;
     }
 
+    /**
+     * CatalogDir is the directory storing the file-based catalog contents.
+     */
     @JsonProperty("catalogDir")
     public void setCatalogDir(String catalogDir) {
         this.catalogDir = catalogDir;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/GrpcPodConfig.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/GrpcPodConfig.java
index 70acb6e68b2..55093c1e5a9 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/GrpcPodConfig.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/GrpcPodConfig.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GrpcPodConfig contains configuration specified for a catalog source
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -109,73 +112,115 @@ public GrpcPodConfig(Affinity affinity, ExtractContentConfig extractContent, Qua
         this.tolerations = tolerations;
     }
 
+    /**
+     * GrpcPodConfig contains configuration specified for a catalog source
+     */
     @JsonProperty("affinity")
     public Affinity getAffinity() {
         return affinity;
     }
 
+    /**
+     * GrpcPodConfig contains configuration specified for a catalog source
+     */
     @JsonProperty("affinity")
     public void setAffinity(Affinity affinity) {
         this.affinity = affinity;
     }
 
+    /**
+     * GrpcPodConfig contains configuration specified for a catalog source
+     */
     @JsonProperty("extractContent")
     public ExtractContentConfig getExtractContent() {
         return extractContent;
     }
 
+    /**
+     * GrpcPodConfig contains configuration specified for a catalog source
+     */
     @JsonProperty("extractContent")
     public void setExtractContent(ExtractContentConfig extractContent) {
         this.extractContent = extractContent;
     }
 
+    /**
+     * GrpcPodConfig contains configuration specified for a catalog source
+     */
     @JsonProperty("memoryTarget")
     public Quantity getMemoryTarget() {
         return memoryTarget;
     }
 
+    /**
+     * GrpcPodConfig contains configuration specified for a catalog source
+     */
     @JsonProperty("memoryTarget")
     public void setMemoryTarget(Quantity memoryTarget) {
         this.memoryTarget = memoryTarget;
     }
 
+    /**
+     * NodeSelector is a selector which must be true for the pod to fit on a node. Selector which must match a node's labels for the pod to be scheduled on that node.
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * NodeSelector is a selector which must be true for the pod to fit on a node. Selector which must match a node's labels for the pod to be scheduled on that node.
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * If specified, indicates the pod's priority. If not specified, the pod priority will be default or zero if there is no default.
+     */
     @JsonProperty("priorityClassName")
     public String getPriorityClassName() {
         return priorityClassName;
     }
 
+    /**
+     * If specified, indicates the pod's priority. If not specified, the pod priority will be default or zero if there is no default.
+     */
     @JsonProperty("priorityClassName")
     public void setPriorityClassName(String priorityClassName) {
         this.priorityClassName = priorityClassName;
     }
 
+    /**
+     * SecurityContextConfig can be one of `legacy` or `restricted`. The CatalogSource's pod is either injected with the right pod.spec.securityContext and pod.spec.container[&#42;].securityContext values to allow the pod to run in Pod Security Admission (PSA) `restricted` mode, or doesn't set these values at all, in which case the pod can only be run in PSA `baseline` or `privileged` namespaces. If the SecurityContextConfig is unspecified, the mode will be determined by the namespace's PSA configuration. If the namespace is enforcing `restricted` mode, then the pod will be configured as if `restricted` was specified. Otherwise, it will be configured as if `legacy` was specified. Specifying a value other than `legacy` or `restricted` result in a validation error. When using older catalog images, which can not run in `restricted` mode, the SecurityContextConfig should be set to `legacy`.<br><p> <br><p> More information about PSA can be found here: https://kubernetes.io/docs/concepts/security/pod-security-admission/'
+     */
     @JsonProperty("securityContextConfig")
     public String getSecurityContextConfig() {
         return securityContextConfig;
     }
 
+    /**
+     * SecurityContextConfig can be one of `legacy` or `restricted`. The CatalogSource's pod is either injected with the right pod.spec.securityContext and pod.spec.container[&#42;].securityContext values to allow the pod to run in Pod Security Admission (PSA) `restricted` mode, or doesn't set these values at all, in which case the pod can only be run in PSA `baseline` or `privileged` namespaces. If the SecurityContextConfig is unspecified, the mode will be determined by the namespace's PSA configuration. If the namespace is enforcing `restricted` mode, then the pod will be configured as if `restricted` was specified. Otherwise, it will be configured as if `legacy` was specified. Specifying a value other than `legacy` or `restricted` result in a validation error. When using older catalog images, which can not run in `restricted` mode, the SecurityContextConfig should be set to `legacy`.<br><p> <br><p> More information about PSA can be found here: https://kubernetes.io/docs/concepts/security/pod-security-admission/'
+     */
     @JsonProperty("securityContextConfig")
     public void setSecurityContextConfig(String securityContextConfig) {
         this.securityContextConfig = securityContextConfig;
     }
 
+    /**
+     * Tolerations are the catalog source's pod's tolerations.
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * Tolerations are the catalog source's pod's tolerations.
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/InstallMode.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/InstallMode.java
index 3e3caeb2da7..f8b4328c188 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/InstallMode.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/InstallMode.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * InstallMode associates an InstallModeType with a flag representing if the CSV supports it
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public InstallMode(Boolean supported, String type) {
         this.type = type;
     }
 
+    /**
+     * InstallMode associates an InstallModeType with a flag representing if the CSV supports it
+     */
     @JsonProperty("supported")
     public Boolean getSupported() {
         return supported;
     }
 
+    /**
+     * InstallMode associates an InstallModeType with a flag representing if the CSV supports it
+     */
     @JsonProperty("supported")
     public void setSupported(Boolean supported) {
         this.supported = supported;
     }
 
+    /**
+     * InstallMode associates an InstallModeType with a flag representing if the CSV supports it
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * InstallMode associates an InstallModeType with a flag representing if the CSV supports it
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/InstallPlan.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/InstallPlan.java
index f3e59a81968..f5fe76df079 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/InstallPlan.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/InstallPlan.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * InstallPlan defines the installation of a set of operators.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class InstallPlan implements Editable<InstallPlanBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operators.coreos.com/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "InstallPlan";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public InstallPlan(String apiVersion, String kind, ObjectMeta metadata, InstallP
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * InstallPlan defines the installation of a set of operators.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * InstallPlan defines the installation of a set of operators.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * InstallPlan defines the installation of a set of operators.
+     */
     @JsonProperty("spec")
     public InstallPlanSpec getSpec() {
         return spec;
     }
 
+    /**
+     * InstallPlan defines the installation of a set of operators.
+     */
     @JsonProperty("spec")
     public void setSpec(InstallPlanSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * InstallPlan defines the installation of a set of operators.
+     */
     @JsonProperty("status")
     public InstallPlanStatus getStatus() {
         return status;
     }
 
+    /**
+     * InstallPlan defines the installation of a set of operators.
+     */
     @JsonProperty("status")
     public void setStatus(InstallPlanStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/InstallPlanCondition.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/InstallPlanCondition.java
index 8ad8dd6136b..54a9967d020 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/InstallPlanCondition.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/InstallPlanCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * InstallPlanCondition represents the overall status of the execution of an InstallPlan.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public InstallPlanCondition(String lastTransitionTime, String lastUpdateTime, St
         this.type = type;
     }
 
+    /**
+     * InstallPlanCondition represents the overall status of the execution of an InstallPlan.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * InstallPlanCondition represents the overall status of the execution of an InstallPlan.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * InstallPlanCondition represents the overall status of the execution of an InstallPlan.
+     */
     @JsonProperty("lastUpdateTime")
     public String getLastUpdateTime() {
         return lastUpdateTime;
     }
 
+    /**
+     * InstallPlanCondition represents the overall status of the execution of an InstallPlan.
+     */
     @JsonProperty("lastUpdateTime")
     public void setLastUpdateTime(String lastUpdateTime) {
         this.lastUpdateTime = lastUpdateTime;
     }
 
+    /**
+     * InstallPlanCondition represents the overall status of the execution of an InstallPlan.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * InstallPlanCondition represents the overall status of the execution of an InstallPlan.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * InstallPlanCondition represents the overall status of the execution of an InstallPlan.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * InstallPlanCondition represents the overall status of the execution of an InstallPlan.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * InstallPlanCondition represents the overall status of the execution of an InstallPlan.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * InstallPlanCondition represents the overall status of the execution of an InstallPlan.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * InstallPlanCondition represents the overall status of the execution of an InstallPlan.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * InstallPlanCondition represents the overall status of the execution of an InstallPlan.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/InstallPlanList.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/InstallPlanList.java
index 9a7a546cca1..6fa465e199a 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/InstallPlanList.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/InstallPlanList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * InstallPlanList is a list of InstallPlan resources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class InstallPlanList implements Editable<InstallPlanListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operatorhub.v1alpha1.InstallPlan>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operators.coreos.com/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operatorhub.v1alpha1.InstallPlan> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "InstallPlanList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public InstallPlanList(String apiVersion, List<io.fabric8.openshift.api.model.op
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * InstallPlanList is a list of InstallPlan resources.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operatorhub.v1alpha1.InstallPlan> getItems() {
         return items;
     }
 
+    /**
+     * InstallPlanList is a list of InstallPlan resources.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operatorhub.v1alpha1.InstallPlan> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * InstallPlanList is a list of InstallPlan resources.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * InstallPlanList is a list of InstallPlan resources.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/InstallPlanSpec.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/InstallPlanSpec.java
index 0b2d8b5f4dd..48f83c0fa4d 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/InstallPlanSpec.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/InstallPlanSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * InstallPlanSpec defines a set of Application resources to be installed
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -101,62 +104,98 @@ public InstallPlanSpec(String approval, Boolean approved, List<String> clusterSe
         this.sourceNamespace = sourceNamespace;
     }
 
+    /**
+     * InstallPlanSpec defines a set of Application resources to be installed
+     */
     @JsonProperty("approval")
     public String getApproval() {
         return approval;
     }
 
+    /**
+     * InstallPlanSpec defines a set of Application resources to be installed
+     */
     @JsonProperty("approval")
     public void setApproval(String approval) {
         this.approval = approval;
     }
 
+    /**
+     * InstallPlanSpec defines a set of Application resources to be installed
+     */
     @JsonProperty("approved")
     public Boolean getApproved() {
         return approved;
     }
 
+    /**
+     * InstallPlanSpec defines a set of Application resources to be installed
+     */
     @JsonProperty("approved")
     public void setApproved(Boolean approved) {
         this.approved = approved;
     }
 
+    /**
+     * InstallPlanSpec defines a set of Application resources to be installed
+     */
     @JsonProperty("clusterServiceVersionNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getClusterServiceVersionNames() {
         return clusterServiceVersionNames;
     }
 
+    /**
+     * InstallPlanSpec defines a set of Application resources to be installed
+     */
     @JsonProperty("clusterServiceVersionNames")
     public void setClusterServiceVersionNames(List<String> clusterServiceVersionNames) {
         this.clusterServiceVersionNames = clusterServiceVersionNames;
     }
 
+    /**
+     * InstallPlanSpec defines a set of Application resources to be installed
+     */
     @JsonProperty("generation")
     public Integer getGeneration() {
         return generation;
     }
 
+    /**
+     * InstallPlanSpec defines a set of Application resources to be installed
+     */
     @JsonProperty("generation")
     public void setGeneration(Integer generation) {
         this.generation = generation;
     }
 
+    /**
+     * InstallPlanSpec defines a set of Application resources to be installed
+     */
     @JsonProperty("source")
     public String getSource() {
         return source;
     }
 
+    /**
+     * InstallPlanSpec defines a set of Application resources to be installed
+     */
     @JsonProperty("source")
     public void setSource(String source) {
         this.source = source;
     }
 
+    /**
+     * InstallPlanSpec defines a set of Application resources to be installed
+     */
     @JsonProperty("sourceNamespace")
     public String getSourceNamespace() {
         return sourceNamespace;
     }
 
+    /**
+     * InstallPlanSpec defines a set of Application resources to be installed
+     */
     @JsonProperty("sourceNamespace")
     public void setSourceNamespace(String sourceNamespace) {
         this.sourceNamespace = sourceNamespace;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/InstallPlanStatus.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/InstallPlanStatus.java
index 871781a3036..64b5cb85c74 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/InstallPlanStatus.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/InstallPlanStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * InstallPlanStatus represents the information about the status of steps required to complete installation.<br><p> <br><p> Status may trail the actual state of a system.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -112,85 +115,133 @@ public InstallPlanStatus(ObjectReference attenuatedServiceAccountRef, List<Bundl
         this.startTime = startTime;
     }
 
+    /**
+     * InstallPlanStatus represents the information about the status of steps required to complete installation.<br><p> <br><p> Status may trail the actual state of a system.
+     */
     @JsonProperty("attenuatedServiceAccountRef")
     public ObjectReference getAttenuatedServiceAccountRef() {
         return attenuatedServiceAccountRef;
     }
 
+    /**
+     * InstallPlanStatus represents the information about the status of steps required to complete installation.<br><p> <br><p> Status may trail the actual state of a system.
+     */
     @JsonProperty("attenuatedServiceAccountRef")
     public void setAttenuatedServiceAccountRef(ObjectReference attenuatedServiceAccountRef) {
         this.attenuatedServiceAccountRef = attenuatedServiceAccountRef;
     }
 
+    /**
+     * BundleLookups is the set of in-progress requests to pull and unpackage bundle content to the cluster.
+     */
     @JsonProperty("bundleLookups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<BundleLookup> getBundleLookups() {
         return bundleLookups;
     }
 
+    /**
+     * BundleLookups is the set of in-progress requests to pull and unpackage bundle content to the cluster.
+     */
     @JsonProperty("bundleLookups")
     public void setBundleLookups(List<BundleLookup> bundleLookups) {
         this.bundleLookups = bundleLookups;
     }
 
+    /**
+     * InstallPlanStatus represents the information about the status of steps required to complete installation.<br><p> <br><p> Status may trail the actual state of a system.
+     */
     @JsonProperty("catalogSources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCatalogSources() {
         return catalogSources;
     }
 
+    /**
+     * InstallPlanStatus represents the information about the status of steps required to complete installation.<br><p> <br><p> Status may trail the actual state of a system.
+     */
     @JsonProperty("catalogSources")
     public void setCatalogSources(List<String> catalogSources) {
         this.catalogSources = catalogSources;
     }
 
+    /**
+     * InstallPlanStatus represents the information about the status of steps required to complete installation.<br><p> <br><p> Status may trail the actual state of a system.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<InstallPlanCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * InstallPlanStatus represents the information about the status of steps required to complete installation.<br><p> <br><p> Status may trail the actual state of a system.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<InstallPlanCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Message is a human-readable message containing detailed information that may be important to understanding why the plan has its current status.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message is a human-readable message containing detailed information that may be important to understanding why the plan has its current status.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * InstallPlanStatus represents the information about the status of steps required to complete installation.<br><p> <br><p> Status may trail the actual state of a system.
+     */
     @JsonProperty("phase")
     public String getPhase() {
         return phase;
     }
 
+    /**
+     * InstallPlanStatus represents the information about the status of steps required to complete installation.<br><p> <br><p> Status may trail the actual state of a system.
+     */
     @JsonProperty("phase")
     public void setPhase(String phase) {
         this.phase = phase;
     }
 
+    /**
+     * InstallPlanStatus represents the information about the status of steps required to complete installation.<br><p> <br><p> Status may trail the actual state of a system.
+     */
     @JsonProperty("plan")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Step> getPlan() {
         return plan;
     }
 
+    /**
+     * InstallPlanStatus represents the information about the status of steps required to complete installation.<br><p> <br><p> Status may trail the actual state of a system.
+     */
     @JsonProperty("plan")
     public void setPlan(List<Step> plan) {
         this.plan = plan;
     }
 
+    /**
+     * InstallPlanStatus represents the information about the status of steps required to complete installation.<br><p> <br><p> Status may trail the actual state of a system.
+     */
     @JsonProperty("startTime")
     public String getStartTime() {
         return startTime;
     }
 
+    /**
+     * InstallPlanStatus represents the information about the status of steps required to complete installation.<br><p> <br><p> Status may trail the actual state of a system.
+     */
     @JsonProperty("startTime")
     public void setStartTime(String startTime) {
         this.startTime = startTime;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/NamedInstallStrategy.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/NamedInstallStrategy.java
index 0a4cf15a094..08f516a0dd8 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/NamedInstallStrategy.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/NamedInstallStrategy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NamedInstallStrategy represents the block of an ClusterServiceVersion resource where the install strategy is specified.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public NamedInstallStrategy(StrategyDetailsDeployment spec, String strategy) {
         this.strategy = strategy;
     }
 
+    /**
+     * NamedInstallStrategy represents the block of an ClusterServiceVersion resource where the install strategy is specified.
+     */
     @JsonProperty("spec")
     public StrategyDetailsDeployment getSpec() {
         return spec;
     }
 
+    /**
+     * NamedInstallStrategy represents the block of an ClusterServiceVersion resource where the install strategy is specified.
+     */
     @JsonProperty("spec")
     public void setSpec(StrategyDetailsDeployment spec) {
         this.spec = spec;
     }
 
+    /**
+     * NamedInstallStrategy represents the block of an ClusterServiceVersion resource where the install strategy is specified.
+     */
     @JsonProperty("strategy")
     public String getStrategy() {
         return strategy;
     }
 
+    /**
+     * NamedInstallStrategy represents the block of an ClusterServiceVersion resource where the install strategy is specified.
+     */
     @JsonProperty("strategy")
     public void setStrategy(String strategy) {
         this.strategy = strategy;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/RegistryPoll.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/RegistryPoll.java
index 353f93c3c20..47e906a0b8b 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/RegistryPoll.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/RegistryPoll.java
@@ -78,11 +78,17 @@ public RegistryPoll(String interval) {
         this.interval = interval;
     }
 
+    /**
+     * Interval is used to determine the time interval between checks of the latest catalog source version. The catalog operator polls to see if a new version of the catalog source is available. If available, the latest image is pulled and gRPC traffic is directed to the latest catalog source.
+     */
     @JsonProperty("interval")
     public String getInterval() {
         return interval;
     }
 
+    /**
+     * Interval is used to determine the time interval between checks of the latest catalog source version. The catalog operator polls to see if a new version of the catalog source is available. If available, the latest image is pulled and gRPC traffic is directed to the latest catalog source.
+     */
     @JsonProperty("interval")
     public void setInterval(String interval) {
         this.interval = interval;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ResourceInstance.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ResourceInstance.java
index d87dd43e230..e339404567e 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ResourceInstance.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ResourceInstance.java
@@ -92,11 +92,17 @@ public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace can be empty for cluster-scoped resources
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace can be empty for cluster-scoped resources
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ResourceList.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ResourceList.java
index 2433c2f403f..960ac2bf7a4 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ResourceList.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/ResourceList.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceList represents a list of resources which are of the same Group/Kind
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public ResourceList(String group, List<ResourceInstance> instances, String kind)
         this.kind = kind;
     }
 
+    /**
+     * ResourceList represents a list of resources which are of the same Group/Kind
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * ResourceList represents a list of resources which are of the same Group/Kind
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * ResourceList represents a list of resources which are of the same Group/Kind
+     */
     @JsonProperty("instances")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ResourceInstance> getInstances() {
         return instances;
     }
 
+    /**
+     * ResourceList represents a list of resources which are of the same Group/Kind
+     */
     @JsonProperty("instances")
     public void setInstances(List<ResourceInstance> instances) {
         this.instances = instances;
     }
 
+    /**
+     * ResourceList represents a list of resources which are of the same Group/Kind
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * ResourceList represents a list of resources which are of the same Group/Kind
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/SpecDescriptor.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/SpecDescriptor.java
index 6c6089c8dbf..282beb91f1a 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/SpecDescriptor.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/SpecDescriptor.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SpecDescriptor describes a field in a spec block of a CRD so that OLM can consume it
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -97,52 +100,82 @@ public SpecDescriptor(String description, String displayName, String path, Strin
         this.xDescriptors = xDescriptors;
     }
 
+    /**
+     * SpecDescriptor describes a field in a spec block of a CRD so that OLM can consume it
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * SpecDescriptor describes a field in a spec block of a CRD so that OLM can consume it
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * SpecDescriptor describes a field in a spec block of a CRD so that OLM can consume it
+     */
     @JsonProperty("displayName")
     public String getDisplayName() {
         return displayName;
     }
 
+    /**
+     * SpecDescriptor describes a field in a spec block of a CRD so that OLM can consume it
+     */
     @JsonProperty("displayName")
     public void setDisplayName(String displayName) {
         this.displayName = displayName;
     }
 
+    /**
+     * SpecDescriptor describes a field in a spec block of a CRD so that OLM can consume it
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * SpecDescriptor describes a field in a spec block of a CRD so that OLM can consume it
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * SpecDescriptor describes a field in a spec block of a CRD so that OLM can consume it
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * SpecDescriptor describes a field in a spec block of a CRD so that OLM can consume it
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
     }
 
+    /**
+     * SpecDescriptor describes a field in a spec block of a CRD so that OLM can consume it
+     */
     @JsonProperty("x-descriptors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getXDescriptors() {
         return xDescriptors;
     }
 
+    /**
+     * SpecDescriptor describes a field in a spec block of a CRD so that OLM can consume it
+     */
     @JsonProperty("x-descriptors")
     public void setXDescriptors(List<String> xDescriptors) {
         this.xDescriptors = xDescriptors;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/StatusDescriptor.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/StatusDescriptor.java
index fc8e803cda1..510edd10f8b 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/StatusDescriptor.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/StatusDescriptor.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StatusDescriptor describes a field in a status block of a CRD so that OLM can consume it
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -97,52 +100,82 @@ public StatusDescriptor(String description, String displayName, String path, Str
         this.xDescriptors = xDescriptors;
     }
 
+    /**
+     * StatusDescriptor describes a field in a status block of a CRD so that OLM can consume it
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * StatusDescriptor describes a field in a status block of a CRD so that OLM can consume it
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * StatusDescriptor describes a field in a status block of a CRD so that OLM can consume it
+     */
     @JsonProperty("displayName")
     public String getDisplayName() {
         return displayName;
     }
 
+    /**
+     * StatusDescriptor describes a field in a status block of a CRD so that OLM can consume it
+     */
     @JsonProperty("displayName")
     public void setDisplayName(String displayName) {
         this.displayName = displayName;
     }
 
+    /**
+     * StatusDescriptor describes a field in a status block of a CRD so that OLM can consume it
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * StatusDescriptor describes a field in a status block of a CRD so that OLM can consume it
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * StatusDescriptor describes a field in a status block of a CRD so that OLM can consume it
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * StatusDescriptor describes a field in a status block of a CRD so that OLM can consume it
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
     }
 
+    /**
+     * StatusDescriptor describes a field in a status block of a CRD so that OLM can consume it
+     */
     @JsonProperty("x-descriptors")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getXDescriptors() {
         return xDescriptors;
     }
 
+    /**
+     * StatusDescriptor describes a field in a status block of a CRD so that OLM can consume it
+     */
     @JsonProperty("x-descriptors")
     public void setXDescriptors(List<String> xDescriptors) {
         this.xDescriptors = xDescriptors;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/Step.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/Step.java
index 8bbdc812f91..a22f8c50c29 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/Step.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/Step.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Step represents the status of an individual step in an InstallPlan.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public Step(Boolean optional, String resolving, StepResource resource, String st
         this.status = status;
     }
 
+    /**
+     * Step represents the status of an individual step in an InstallPlan.
+     */
     @JsonProperty("optional")
     public Boolean getOptional() {
         return optional;
     }
 
+    /**
+     * Step represents the status of an individual step in an InstallPlan.
+     */
     @JsonProperty("optional")
     public void setOptional(Boolean optional) {
         this.optional = optional;
     }
 
+    /**
+     * Step represents the status of an individual step in an InstallPlan.
+     */
     @JsonProperty("resolving")
     public String getResolving() {
         return resolving;
     }
 
+    /**
+     * Step represents the status of an individual step in an InstallPlan.
+     */
     @JsonProperty("resolving")
     public void setResolving(String resolving) {
         this.resolving = resolving;
     }
 
+    /**
+     * Step represents the status of an individual step in an InstallPlan.
+     */
     @JsonProperty("resource")
     public StepResource getResource() {
         return resource;
     }
 
+    /**
+     * Step represents the status of an individual step in an InstallPlan.
+     */
     @JsonProperty("resource")
     public void setResource(StepResource resource) {
         this.resource = resource;
     }
 
+    /**
+     * Step represents the status of an individual step in an InstallPlan.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Step represents the status of an individual step in an InstallPlan.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/StepResource.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/StepResource.java
index e57d4f48024..3141f661fb0 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/StepResource.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/StepResource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StepResource represents the status of a resource to be tracked by an InstallPlan.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,71 +105,113 @@ public StepResource(String group, String kind, String manifest, String name, Str
         this.version = version;
     }
 
+    /**
+     * StepResource represents the status of a resource to be tracked by an InstallPlan.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * StepResource represents the status of a resource to be tracked by an InstallPlan.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * StepResource represents the status of a resource to be tracked by an InstallPlan.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * StepResource represents the status of a resource to be tracked by an InstallPlan.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * StepResource represents the status of a resource to be tracked by an InstallPlan.
+     */
     @JsonProperty("manifest")
     public String getManifest() {
         return manifest;
     }
 
+    /**
+     * StepResource represents the status of a resource to be tracked by an InstallPlan.
+     */
     @JsonProperty("manifest")
     public void setManifest(String manifest) {
         this.manifest = manifest;
     }
 
+    /**
+     * StepResource represents the status of a resource to be tracked by an InstallPlan.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * StepResource represents the status of a resource to be tracked by an InstallPlan.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * StepResource represents the status of a resource to be tracked by an InstallPlan.
+     */
     @JsonProperty("sourceName")
     public String getSourceName() {
         return sourceName;
     }
 
+    /**
+     * StepResource represents the status of a resource to be tracked by an InstallPlan.
+     */
     @JsonProperty("sourceName")
     public void setSourceName(String sourceName) {
         this.sourceName = sourceName;
     }
 
+    /**
+     * StepResource represents the status of a resource to be tracked by an InstallPlan.
+     */
     @JsonProperty("sourceNamespace")
     public String getSourceNamespace() {
         return sourceNamespace;
     }
 
+    /**
+     * StepResource represents the status of a resource to be tracked by an InstallPlan.
+     */
     @JsonProperty("sourceNamespace")
     public void setSourceNamespace(String sourceNamespace) {
         this.sourceNamespace = sourceNamespace;
     }
 
+    /**
+     * StepResource represents the status of a resource to be tracked by an InstallPlan.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * StepResource represents the status of a resource to be tracked by an InstallPlan.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/StrategyDeploymentPermissions.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/StrategyDeploymentPermissions.java
index e54446ab8b2..98dd030892c 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/StrategyDeploymentPermissions.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/StrategyDeploymentPermissions.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StrategyDeploymentPermissions describe the rbac rules and service account needed by the install strategy
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,22 +89,34 @@ public StrategyDeploymentPermissions(List<PolicyRule> rules, String serviceAccou
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * StrategyDeploymentPermissions describe the rbac rules and service account needed by the install strategy
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PolicyRule> getRules() {
         return rules;
     }
 
+    /**
+     * StrategyDeploymentPermissions describe the rbac rules and service account needed by the install strategy
+     */
     @JsonProperty("rules")
     public void setRules(List<PolicyRule> rules) {
         this.rules = rules;
     }
 
+    /**
+     * StrategyDeploymentPermissions describe the rbac rules and service account needed by the install strategy
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * StrategyDeploymentPermissions describe the rbac rules and service account needed by the install strategy
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/StrategyDeploymentSpec.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/StrategyDeploymentSpec.java
index e77fa61ecff..d0b64abe1fc 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/StrategyDeploymentSpec.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/StrategyDeploymentSpec.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StrategyDeploymentSpec contains the name, spec and labels for the deployment ALM should create
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -88,32 +91,50 @@ public StrategyDeploymentSpec(Map<String, String> label, String name, Deployment
         this.spec = spec;
     }
 
+    /**
+     * StrategyDeploymentSpec contains the name, spec and labels for the deployment ALM should create
+     */
     @JsonProperty("label")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabel() {
         return label;
     }
 
+    /**
+     * StrategyDeploymentSpec contains the name, spec and labels for the deployment ALM should create
+     */
     @JsonProperty("label")
     public void setLabel(Map<String, String> label) {
         this.label = label;
     }
 
+    /**
+     * StrategyDeploymentSpec contains the name, spec and labels for the deployment ALM should create
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * StrategyDeploymentSpec contains the name, spec and labels for the deployment ALM should create
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * StrategyDeploymentSpec contains the name, spec and labels for the deployment ALM should create
+     */
     @JsonProperty("spec")
     public DeploymentSpec getSpec() {
         return spec;
     }
 
+    /**
+     * StrategyDeploymentSpec contains the name, spec and labels for the deployment ALM should create
+     */
     @JsonProperty("spec")
     public void setSpec(DeploymentSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/StrategyDetailsDeployment.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/StrategyDetailsDeployment.java
index 73d088a27d2..2e38975a07c 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/StrategyDetailsDeployment.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/StrategyDetailsDeployment.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StrategyDetailsDeployment represents the parsed details of a Deployment InstallStrategy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,34 +94,52 @@ public StrategyDetailsDeployment(List<StrategyDeploymentPermissions> clusterPerm
         this.permissions = permissions;
     }
 
+    /**
+     * StrategyDetailsDeployment represents the parsed details of a Deployment InstallStrategy.
+     */
     @JsonProperty("clusterPermissions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<StrategyDeploymentPermissions> getClusterPermissions() {
         return clusterPermissions;
     }
 
+    /**
+     * StrategyDetailsDeployment represents the parsed details of a Deployment InstallStrategy.
+     */
     @JsonProperty("clusterPermissions")
     public void setClusterPermissions(List<StrategyDeploymentPermissions> clusterPermissions) {
         this.clusterPermissions = clusterPermissions;
     }
 
+    /**
+     * StrategyDetailsDeployment represents the parsed details of a Deployment InstallStrategy.
+     */
     @JsonProperty("deployments")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<StrategyDeploymentSpec> getDeployments() {
         return deployments;
     }
 
+    /**
+     * StrategyDetailsDeployment represents the parsed details of a Deployment InstallStrategy.
+     */
     @JsonProperty("deployments")
     public void setDeployments(List<StrategyDeploymentSpec> deployments) {
         this.deployments = deployments;
     }
 
+    /**
+     * StrategyDetailsDeployment represents the parsed details of a Deployment InstallStrategy.
+     */
     @JsonProperty("permissions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<StrategyDeploymentPermissions> getPermissions() {
         return permissions;
     }
 
+    /**
+     * StrategyDetailsDeployment represents the parsed details of a Deployment InstallStrategy.
+     */
     @JsonProperty("permissions")
     public void setPermissions(List<StrategyDeploymentPermissions> permissions) {
         this.permissions = permissions;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/Subscription.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/Subscription.java
index f855975ebbe..f44b9cbeaff 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/Subscription.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/Subscription.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Subscription keeps operators up to date by tracking changes to Catalogs.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Subscription implements Editable<SubscriptionBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operators.coreos.com/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Subscription";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Subscription(String apiVersion, String kind, ObjectMeta metadata, Subscri
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Subscription keeps operators up to date by tracking changes to Catalogs.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Subscription keeps operators up to date by tracking changes to Catalogs.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Subscription keeps operators up to date by tracking changes to Catalogs.
+     */
     @JsonProperty("spec")
     public SubscriptionSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Subscription keeps operators up to date by tracking changes to Catalogs.
+     */
     @JsonProperty("spec")
     public void setSpec(SubscriptionSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Subscription keeps operators up to date by tracking changes to Catalogs.
+     */
     @JsonProperty("status")
     public SubscriptionStatus getStatus() {
         return status;
     }
 
+    /**
+     * Subscription keeps operators up to date by tracking changes to Catalogs.
+     */
     @JsonProperty("status")
     public void setStatus(SubscriptionStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/SubscriptionCatalogHealth.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/SubscriptionCatalogHealth.java
index 1c8ec5776d3..d9fce887dcf 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/SubscriptionCatalogHealth.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/SubscriptionCatalogHealth.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubscriptionCatalogHealth describes the health of a CatalogSource the Subscription knows about.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public SubscriptionCatalogHealth(ObjectReference catalogSourceRef, Boolean healt
         this.lastUpdated = lastUpdated;
     }
 
+    /**
+     * SubscriptionCatalogHealth describes the health of a CatalogSource the Subscription knows about.
+     */
     @JsonProperty("catalogSourceRef")
     public ObjectReference getCatalogSourceRef() {
         return catalogSourceRef;
     }
 
+    /**
+     * SubscriptionCatalogHealth describes the health of a CatalogSource the Subscription knows about.
+     */
     @JsonProperty("catalogSourceRef")
     public void setCatalogSourceRef(ObjectReference catalogSourceRef) {
         this.catalogSourceRef = catalogSourceRef;
     }
 
+    /**
+     * Healthy is true if the CatalogSource is healthy; false otherwise.
+     */
     @JsonProperty("healthy")
     public Boolean getHealthy() {
         return healthy;
     }
 
+    /**
+     * Healthy is true if the CatalogSource is healthy; false otherwise.
+     */
     @JsonProperty("healthy")
     public void setHealthy(Boolean healthy) {
         this.healthy = healthy;
     }
 
+    /**
+     * SubscriptionCatalogHealth describes the health of a CatalogSource the Subscription knows about.
+     */
     @JsonProperty("lastUpdated")
     public String getLastUpdated() {
         return lastUpdated;
     }
 
+    /**
+     * SubscriptionCatalogHealth describes the health of a CatalogSource the Subscription knows about.
+     */
     @JsonProperty("lastUpdated")
     public void setLastUpdated(String lastUpdated) {
         this.lastUpdated = lastUpdated;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/SubscriptionCondition.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/SubscriptionCondition.java
index 06443eca5cf..09604439a92 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/SubscriptionCondition.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/SubscriptionCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubscriptionCondition represents the latest available observations of a Subscription's state.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public SubscriptionCondition(String lastHeartbeatTime, String lastTransitionTime
         this.type = type;
     }
 
+    /**
+     * SubscriptionCondition represents the latest available observations of a Subscription's state.
+     */
     @JsonProperty("lastHeartbeatTime")
     public String getLastHeartbeatTime() {
         return lastHeartbeatTime;
     }
 
+    /**
+     * SubscriptionCondition represents the latest available observations of a Subscription's state.
+     */
     @JsonProperty("lastHeartbeatTime")
     public void setLastHeartbeatTime(String lastHeartbeatTime) {
         this.lastHeartbeatTime = lastHeartbeatTime;
     }
 
+    /**
+     * SubscriptionCondition represents the latest available observations of a Subscription's state.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * SubscriptionCondition represents the latest available observations of a Subscription's state.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Message is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message is a human-readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Reason is a one-word CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason is a one-word CamelCase reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status is the status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status is the status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type is the type of Subscription condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of Subscription condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/SubscriptionConfig.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/SubscriptionConfig.java
index e6c36fd4c93..498dcc521b0 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/SubscriptionConfig.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/SubscriptionConfig.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubscriptionConfig contains configuration specified for a subscription.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -126,108 +129,168 @@ public SubscriptionConfig(Affinity affinity, Map<String, String> annotations, Li
         this.volumes = volumes;
     }
 
+    /**
+     * SubscriptionConfig contains configuration specified for a subscription.
+     */
     @JsonProperty("affinity")
     public Affinity getAffinity() {
         return affinity;
     }
 
+    /**
+     * SubscriptionConfig contains configuration specified for a subscription.
+     */
     @JsonProperty("affinity")
     public void setAffinity(Affinity affinity) {
         this.affinity = affinity;
     }
 
+    /**
+     * Annotations is an unstructured key value map stored with each Deployment, Pod, APIService in the Operator. Typically, annotations may be set by external tools to store and retrieve arbitrary metadata. Use this field to pre-define annotations that OLM should add to each of the Subscription's deployments, pods, and apiservices.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is an unstructured key value map stored with each Deployment, Pod, APIService in the Operator. Typically, annotations may be set by external tools to store and retrieve arbitrary metadata. Use this field to pre-define annotations that OLM should add to each of the Subscription's deployments, pods, and apiservices.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * Env is a list of environment variables to set in the container. Cannot be updated.
+     */
     @JsonProperty("env")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvVar> getEnv() {
         return env;
     }
 
+    /**
+     * Env is a list of environment variables to set in the container. Cannot be updated.
+     */
     @JsonProperty("env")
     public void setEnv(List<EnvVar> env) {
         this.env = env;
     }
 
+    /**
+     * EnvFrom is a list of sources to populate environment variables in the container. The keys defined within a source must be a C_IDENTIFIER. All invalid keys will be reported as an event when the container is starting. When a key exists in multiple sources, the value associated with the last source will take precedence. Values defined by an Env with a duplicate key will take precedence. Immutable.
+     */
     @JsonProperty("envFrom")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvFromSource> getEnvFrom() {
         return envFrom;
     }
 
+    /**
+     * EnvFrom is a list of sources to populate environment variables in the container. The keys defined within a source must be a C_IDENTIFIER. All invalid keys will be reported as an event when the container is starting. When a key exists in multiple sources, the value associated with the last source will take precedence. Values defined by an Env with a duplicate key will take precedence. Immutable.
+     */
     @JsonProperty("envFrom")
     public void setEnvFrom(List<EnvFromSource> envFrom) {
         this.envFrom = envFrom;
     }
 
+    /**
+     * NodeSelector is a selector which must be true for the pod to fit on a node. Selector which must match a node's labels for the pod to be scheduled on that node. More info: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * NodeSelector is a selector which must be true for the pod to fit on a node. Selector which must match a node's labels for the pod to be scheduled on that node. More info: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * SubscriptionConfig contains configuration specified for a subscription.
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * SubscriptionConfig contains configuration specified for a subscription.
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * SubscriptionConfig contains configuration specified for a subscription.
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * SubscriptionConfig contains configuration specified for a subscription.
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * Tolerations are the pod's tolerations.
+     */
     @JsonProperty("tolerations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Toleration> getTolerations() {
         return tolerations;
     }
 
+    /**
+     * Tolerations are the pod's tolerations.
+     */
     @JsonProperty("tolerations")
     public void setTolerations(List<Toleration> tolerations) {
         this.tolerations = tolerations;
     }
 
+    /**
+     * List of VolumeMounts to set in the container.
+     */
     @JsonProperty("volumeMounts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<VolumeMount> getVolumeMounts() {
         return volumeMounts;
     }
 
+    /**
+     * List of VolumeMounts to set in the container.
+     */
     @JsonProperty("volumeMounts")
     public void setVolumeMounts(List<VolumeMount> volumeMounts) {
         this.volumeMounts = volumeMounts;
     }
 
+    /**
+     * List of Volumes to set in the podSpec.
+     */
     @JsonProperty("volumes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Volume> getVolumes() {
         return volumes;
     }
 
+    /**
+     * List of Volumes to set in the podSpec.
+     */
     @JsonProperty("volumes")
     public void setVolumes(List<Volume> volumes) {
         this.volumes = volumes;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/SubscriptionList.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/SubscriptionList.java
index fba96949243..72e90d5facf 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/SubscriptionList.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/SubscriptionList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubscriptionList is a list of Subscription resources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class SubscriptionList implements Editable<SubscriptionListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operatorhub.v1alpha1.Subscription>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operators.coreos.com/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operatorhub.v1alpha1.Subscription> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SubscriptionList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public SubscriptionList(String apiVersion, List<io.fabric8.openshift.api.model.o
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * SubscriptionList is a list of Subscription resources.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operatorhub.v1alpha1.Subscription> getItems() {
         return items;
     }
 
+    /**
+     * SubscriptionList is a list of Subscription resources.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operatorhub.v1alpha1.Subscription> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SubscriptionList is a list of Subscription resources.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SubscriptionList is a list of Subscription resources.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/SubscriptionSpec.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/SubscriptionSpec.java
index 098066bf782..06d5ae1df98 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/SubscriptionSpec.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/SubscriptionSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubscriptionSpec defines an Application that can be installed
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,71 +105,113 @@ public SubscriptionSpec(String channel, SubscriptionConfig config, String instal
         this.startingCSV = startingCSV;
     }
 
+    /**
+     * SubscriptionSpec defines an Application that can be installed
+     */
     @JsonProperty("channel")
     public String getChannel() {
         return channel;
     }
 
+    /**
+     * SubscriptionSpec defines an Application that can be installed
+     */
     @JsonProperty("channel")
     public void setChannel(String channel) {
         this.channel = channel;
     }
 
+    /**
+     * SubscriptionSpec defines an Application that can be installed
+     */
     @JsonProperty("config")
     public SubscriptionConfig getConfig() {
         return config;
     }
 
+    /**
+     * SubscriptionSpec defines an Application that can be installed
+     */
     @JsonProperty("config")
     public void setConfig(SubscriptionConfig config) {
         this.config = config;
     }
 
+    /**
+     * SubscriptionSpec defines an Application that can be installed
+     */
     @JsonProperty("installPlanApproval")
     public String getInstallPlanApproval() {
         return installPlanApproval;
     }
 
+    /**
+     * SubscriptionSpec defines an Application that can be installed
+     */
     @JsonProperty("installPlanApproval")
     public void setInstallPlanApproval(String installPlanApproval) {
         this.installPlanApproval = installPlanApproval;
     }
 
+    /**
+     * SubscriptionSpec defines an Application that can be installed
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * SubscriptionSpec defines an Application that can be installed
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * SubscriptionSpec defines an Application that can be installed
+     */
     @JsonProperty("source")
     public String getSource() {
         return source;
     }
 
+    /**
+     * SubscriptionSpec defines an Application that can be installed
+     */
     @JsonProperty("source")
     public void setSource(String source) {
         this.source = source;
     }
 
+    /**
+     * SubscriptionSpec defines an Application that can be installed
+     */
     @JsonProperty("sourceNamespace")
     public String getSourceNamespace() {
         return sourceNamespace;
     }
 
+    /**
+     * SubscriptionSpec defines an Application that can be installed
+     */
     @JsonProperty("sourceNamespace")
     public void setSourceNamespace(String sourceNamespace) {
         this.sourceNamespace = sourceNamespace;
     }
 
+    /**
+     * SubscriptionSpec defines an Application that can be installed
+     */
     @JsonProperty("startingCSV")
     public String getStartingCSV() {
         return startingCSV;
     }
 
+    /**
+     * SubscriptionSpec defines an Application that can be installed
+     */
     @JsonProperty("startingCSV")
     public void setStartingCSV(String startingCSV) {
         this.startingCSV = startingCSV;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/SubscriptionStatus.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/SubscriptionStatus.java
index 26546450256..f0c43e5250e 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/SubscriptionStatus.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/SubscriptionStatus.java
@@ -118,43 +118,67 @@ public SubscriptionStatus(List<SubscriptionCatalogHealth> catalogHealth, List<Su
         this.state = state;
     }
 
+    /**
+     * CatalogHealth contains the Subscription's view of its relevant CatalogSources' status. It is used to determine SubscriptionStatusConditions related to CatalogSources.
+     */
     @JsonProperty("catalogHealth")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SubscriptionCatalogHealth> getCatalogHealth() {
         return catalogHealth;
     }
 
+    /**
+     * CatalogHealth contains the Subscription's view of its relevant CatalogSources' status. It is used to determine SubscriptionStatusConditions related to CatalogSources.
+     */
     @JsonProperty("catalogHealth")
     public void setCatalogHealth(List<SubscriptionCatalogHealth> catalogHealth) {
         this.catalogHealth = catalogHealth;
     }
 
+    /**
+     * Conditions is a list of the latest available observations about a Subscription's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SubscriptionCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions is a list of the latest available observations about a Subscription's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<SubscriptionCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * CurrentCSV is the CSV the Subscription is progressing to.
+     */
     @JsonProperty("currentCSV")
     public String getCurrentCSV() {
         return currentCSV;
     }
 
+    /**
+     * CurrentCSV is the CSV the Subscription is progressing to.
+     */
     @JsonProperty("currentCSV")
     public void setCurrentCSV(String currentCSV) {
         this.currentCSV = currentCSV;
     }
 
+    /**
+     * InstallPlanGeneration is the current generation of the installplan
+     */
     @JsonProperty("installPlanGeneration")
     public Integer getInstallPlanGeneration() {
         return installPlanGeneration;
     }
 
+    /**
+     * InstallPlanGeneration is the current generation of the installplan
+     */
     @JsonProperty("installPlanGeneration")
     public void setInstallPlanGeneration(Integer installPlanGeneration) {
         this.installPlanGeneration = installPlanGeneration;
@@ -170,11 +194,17 @@ public void setInstallPlanRef(ObjectReference installPlanRef) {
         this.installPlanRef = installPlanRef;
     }
 
+    /**
+     * InstalledCSV is the CSV currently installed by the Subscription.
+     */
     @JsonProperty("installedCSV")
     public String getInstalledCSV() {
         return installedCSV;
     }
 
+    /**
+     * InstalledCSV is the CSV currently installed by the Subscription.
+     */
     @JsonProperty("installedCSV")
     public void setInstalledCSV(String installedCSV) {
         this.installedCSV = installedCSV;
@@ -200,21 +230,33 @@ public void setLastUpdated(String lastUpdated) {
         this.lastUpdated = lastUpdated;
     }
 
+    /**
+     * Reason is the reason the Subscription was transitioned to its current state.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason is the reason the Subscription was transitioned to its current state.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * State represents the current state of the Subscription
+     */
     @JsonProperty("state")
     public String getState() {
         return state;
     }
 
+    /**
+     * State represents the current state of the Subscription
+     */
     @JsonProperty("state")
     public void setState(String state) {
         this.state = state;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/UpdateStrategy.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/UpdateStrategy.java
index 2f4ee18abf3..397019534f9 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/UpdateStrategy.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/UpdateStrategy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UpdateStrategy holds all the different types of catalog source update strategies Currently only registry polling strategy is implemented
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public UpdateStrategy(RegistryPoll registryPoll) {
         this.registryPoll = registryPoll;
     }
 
+    /**
+     * UpdateStrategy holds all the different types of catalog source update strategies Currently only registry polling strategy is implemented
+     */
     @JsonProperty("registryPoll")
     public RegistryPoll getRegistryPoll() {
         return registryPoll;
     }
 
+    /**
+     * UpdateStrategy holds all the different types of catalog source update strategies Currently only registry polling strategy is implemented
+     */
     @JsonProperty("registryPoll")
     public void setRegistryPoll(RegistryPoll registryPoll) {
         this.registryPoll = registryPoll;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/WebhookDescription.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/WebhookDescription.java
index 5e1044483d9..5fa4f660b5d 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/WebhookDescription.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha1/WebhookDescription.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WebhookDescription provides details to OLM about required webhooks
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -140,154 +143,244 @@ public WebhookDescription(List<String> admissionReviewVersions, Integer containe
         this.webhookPath = webhookPath;
     }
 
+    /**
+     * WebhookDescription provides details to OLM about required webhooks
+     */
     @JsonProperty("admissionReviewVersions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAdmissionReviewVersions() {
         return admissionReviewVersions;
     }
 
+    /**
+     * WebhookDescription provides details to OLM about required webhooks
+     */
     @JsonProperty("admissionReviewVersions")
     public void setAdmissionReviewVersions(List<String> admissionReviewVersions) {
         this.admissionReviewVersions = admissionReviewVersions;
     }
 
+    /**
+     * WebhookDescription provides details to OLM about required webhooks
+     */
     @JsonProperty("containerPort")
     public Integer getContainerPort() {
         return containerPort;
     }
 
+    /**
+     * WebhookDescription provides details to OLM about required webhooks
+     */
     @JsonProperty("containerPort")
     public void setContainerPort(Integer containerPort) {
         this.containerPort = containerPort;
     }
 
+    /**
+     * WebhookDescription provides details to OLM about required webhooks
+     */
     @JsonProperty("conversionCRDs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getConversionCRDs() {
         return conversionCRDs;
     }
 
+    /**
+     * WebhookDescription provides details to OLM about required webhooks
+     */
     @JsonProperty("conversionCRDs")
     public void setConversionCRDs(List<String> conversionCRDs) {
         this.conversionCRDs = conversionCRDs;
     }
 
+    /**
+     * WebhookDescription provides details to OLM about required webhooks
+     */
     @JsonProperty("deploymentName")
     public String getDeploymentName() {
         return deploymentName;
     }
 
+    /**
+     * WebhookDescription provides details to OLM about required webhooks
+     */
     @JsonProperty("deploymentName")
     public void setDeploymentName(String deploymentName) {
         this.deploymentName = deploymentName;
     }
 
+    /**
+     * Possible enum values:<br><p>  - `"Fail"` means that an error calling the webhook causes the admission to fail.<br><p>  - `"Ignore"` means that an error calling the webhook is ignored.
+     */
     @JsonProperty("failurePolicy")
     public String getFailurePolicy() {
         return failurePolicy;
     }
 
+    /**
+     * Possible enum values:<br><p>  - `"Fail"` means that an error calling the webhook causes the admission to fail.<br><p>  - `"Ignore"` means that an error calling the webhook is ignored.
+     */
     @JsonProperty("failurePolicy")
     public void setFailurePolicy(String failurePolicy) {
         this.failurePolicy = failurePolicy;
     }
 
+    /**
+     * WebhookDescription provides details to OLM about required webhooks
+     */
     @JsonProperty("generateName")
     public String getGenerateName() {
         return generateName;
     }
 
+    /**
+     * WebhookDescription provides details to OLM about required webhooks
+     */
     @JsonProperty("generateName")
     public void setGenerateName(String generateName) {
         this.generateName = generateName;
     }
 
+    /**
+     * Possible enum values:<br><p>  - `"Equivalent"` means requests should be sent to the webhook if they modify a resource listed in rules via another API group or version.<br><p>  - `"Exact"` means requests should only be sent to the webhook if they exactly match a given rule.
+     */
     @JsonProperty("matchPolicy")
     public String getMatchPolicy() {
         return matchPolicy;
     }
 
+    /**
+     * Possible enum values:<br><p>  - `"Equivalent"` means requests should be sent to the webhook if they modify a resource listed in rules via another API group or version.<br><p>  - `"Exact"` means requests should only be sent to the webhook if they exactly match a given rule.
+     */
     @JsonProperty("matchPolicy")
     public void setMatchPolicy(String matchPolicy) {
         this.matchPolicy = matchPolicy;
     }
 
+    /**
+     * WebhookDescription provides details to OLM about required webhooks
+     */
     @JsonProperty("objectSelector")
     public LabelSelector getObjectSelector() {
         return objectSelector;
     }
 
+    /**
+     * WebhookDescription provides details to OLM about required webhooks
+     */
     @JsonProperty("objectSelector")
     public void setObjectSelector(LabelSelector objectSelector) {
         this.objectSelector = objectSelector;
     }
 
+    /**
+     * Possible enum values:<br><p>  - `"IfNeeded"` indicates that the webhook may be called at least one additional time as part of the admission evaluation if the object being admitted is modified by other admission plugins after the initial webhook call.<br><p>  - `"Never"` indicates that the webhook must not be called more than once in a single admission evaluation.
+     */
     @JsonProperty("reinvocationPolicy")
     public String getReinvocationPolicy() {
         return reinvocationPolicy;
     }
 
+    /**
+     * Possible enum values:<br><p>  - `"IfNeeded"` indicates that the webhook may be called at least one additional time as part of the admission evaluation if the object being admitted is modified by other admission plugins after the initial webhook call.<br><p>  - `"Never"` indicates that the webhook must not be called more than once in a single admission evaluation.
+     */
     @JsonProperty("reinvocationPolicy")
     public void setReinvocationPolicy(String reinvocationPolicy) {
         this.reinvocationPolicy = reinvocationPolicy;
     }
 
+    /**
+     * WebhookDescription provides details to OLM about required webhooks
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RuleWithOperations> getRules() {
         return rules;
     }
 
+    /**
+     * WebhookDescription provides details to OLM about required webhooks
+     */
     @JsonProperty("rules")
     public void setRules(List<RuleWithOperations> rules) {
         this.rules = rules;
     }
 
+    /**
+     * Possible enum values:<br><p>  - `"None"` means that calling the webhook will have no side effects.<br><p>  - `"NoneOnDryRun"` means that calling the webhook will possibly have side effects, but if the request being reviewed has the dry-run attribute, the side effects will be suppressed.<br><p>  - `"Some"` means that calling the webhook will possibly have side effects. If a request with the dry-run attribute would trigger a call to this webhook, the request will instead fail.<br><p>  - `"Unknown"` means that no information is known about the side effects of calling the webhook. If a request with the dry-run attribute would trigger a call to this webhook, the request will instead fail.
+     */
     @JsonProperty("sideEffects")
     public String getSideEffects() {
         return sideEffects;
     }
 
+    /**
+     * Possible enum values:<br><p>  - `"None"` means that calling the webhook will have no side effects.<br><p>  - `"NoneOnDryRun"` means that calling the webhook will possibly have side effects, but if the request being reviewed has the dry-run attribute, the side effects will be suppressed.<br><p>  - `"Some"` means that calling the webhook will possibly have side effects. If a request with the dry-run attribute would trigger a call to this webhook, the request will instead fail.<br><p>  - `"Unknown"` means that no information is known about the side effects of calling the webhook. If a request with the dry-run attribute would trigger a call to this webhook, the request will instead fail.
+     */
     @JsonProperty("sideEffects")
     public void setSideEffects(String sideEffects) {
         this.sideEffects = sideEffects;
     }
 
+    /**
+     * WebhookDescription provides details to OLM about required webhooks
+     */
     @JsonProperty("targetPort")
     public IntOrString getTargetPort() {
         return targetPort;
     }
 
+    /**
+     * WebhookDescription provides details to OLM about required webhooks
+     */
     @JsonProperty("targetPort")
     public void setTargetPort(IntOrString targetPort) {
         this.targetPort = targetPort;
     }
 
+    /**
+     * WebhookDescription provides details to OLM about required webhooks
+     */
     @JsonProperty("timeoutSeconds")
     public Integer getTimeoutSeconds() {
         return timeoutSeconds;
     }
 
+    /**
+     * WebhookDescription provides details to OLM about required webhooks
+     */
     @JsonProperty("timeoutSeconds")
     public void setTimeoutSeconds(Integer timeoutSeconds) {
         this.timeoutSeconds = timeoutSeconds;
     }
 
+    /**
+     * WebhookDescription provides details to OLM about required webhooks
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * WebhookDescription provides details to OLM about required webhooks
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * WebhookDescription provides details to OLM about required webhooks
+     */
     @JsonProperty("webhookPath")
     public String getWebhookPath() {
         return webhookPath;
     }
 
+    /**
+     * WebhookDescription provides details to OLM about required webhooks
+     */
     @JsonProperty("webhookPath")
     public void setWebhookPath(String webhookPath) {
         this.webhookPath = webhookPath;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha2/OperatorGroup.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha2/OperatorGroup.java
index 859cfe7fb90..1fdd81741c0 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha2/OperatorGroup.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha2/OperatorGroup.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorGroup is the unit of multitenancy for OLM managed operators. It constrains the installation of operators in its namespace to a specified set of target namespaces.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class OperatorGroup implements Editable<OperatorGroupBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operators.coreos.com/v1alpha2";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OperatorGroup";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public OperatorGroup(String apiVersion, String kind, ObjectMeta metadata, Operat
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OperatorGroup is the unit of multitenancy for OLM managed operators. It constrains the installation of operators in its namespace to a specified set of target namespaces.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OperatorGroup is the unit of multitenancy for OLM managed operators. It constrains the installation of operators in its namespace to a specified set of target namespaces.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * OperatorGroup is the unit of multitenancy for OLM managed operators. It constrains the installation of operators in its namespace to a specified set of target namespaces.
+     */
     @JsonProperty("spec")
     public OperatorGroupSpec getSpec() {
         return spec;
     }
 
+    /**
+     * OperatorGroup is the unit of multitenancy for OLM managed operators. It constrains the installation of operators in its namespace to a specified set of target namespaces.
+     */
     @JsonProperty("spec")
     public void setSpec(OperatorGroupSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * OperatorGroup is the unit of multitenancy for OLM managed operators. It constrains the installation of operators in its namespace to a specified set of target namespaces.
+     */
     @JsonProperty("status")
     public OperatorGroupStatus getStatus() {
         return status;
     }
 
+    /**
+     * OperatorGroup is the unit of multitenancy for OLM managed operators. It constrains the installation of operators in its namespace to a specified set of target namespaces.
+     */
     @JsonProperty("status")
     public void setStatus(OperatorGroupStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha2/OperatorGroupList.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha2/OperatorGroupList.java
index f14a36948c3..aeac995127a 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha2/OperatorGroupList.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha2/OperatorGroupList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorGroupList is a list of OperatorGroup resources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class OperatorGroupList implements Editable<OperatorGroupListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operatorhub.v1alpha2.OperatorGroup>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operators.coreos.com/v1alpha2";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operatorhub.v1alpha2.OperatorGroup> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OperatorGroupList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public OperatorGroupList(String apiVersion, List<io.fabric8.openshift.api.model.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * OperatorGroupList is a list of OperatorGroup resources.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operatorhub.v1alpha2.OperatorGroup> getItems() {
         return items;
     }
 
+    /**
+     * OperatorGroupList is a list of OperatorGroup resources.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operatorhub.v1alpha2.OperatorGroup> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OperatorGroupList is a list of OperatorGroup resources.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OperatorGroupList is a list of OperatorGroup resources.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha2/OperatorGroupSpec.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha2/OperatorGroupSpec.java
index 9eff0d59c18..11b0fe55ba1 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha2/OperatorGroupSpec.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha2/OperatorGroupSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorGroupSpec is the spec for an OperatorGroup resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public OperatorGroupSpec(LabelSelector selector, String serviceAccountName, Bool
         this.targetNamespaces = targetNamespaces;
     }
 
+    /**
+     * OperatorGroupSpec is the spec for an OperatorGroup resource.
+     */
     @JsonProperty("selector")
     public LabelSelector getSelector() {
         return selector;
     }
 
+    /**
+     * OperatorGroupSpec is the spec for an OperatorGroup resource.
+     */
     @JsonProperty("selector")
     public void setSelector(LabelSelector selector) {
         this.selector = selector;
     }
 
+    /**
+     * ServiceAccountName is the admin specified service account which will be used to deploy operator(s) in this operator group.
+     */
     @JsonProperty("serviceAccountName")
     public String getServiceAccountName() {
         return serviceAccountName;
     }
 
+    /**
+     * ServiceAccountName is the admin specified service account which will be used to deploy operator(s) in this operator group.
+     */
     @JsonProperty("serviceAccountName")
     public void setServiceAccountName(String serviceAccountName) {
         this.serviceAccountName = serviceAccountName;
     }
 
+    /**
+     * Static tells OLM not to update the OperatorGroup's providedAPIs annotation
+     */
     @JsonProperty("staticProvidedAPIs")
     public Boolean getStaticProvidedAPIs() {
         return staticProvidedAPIs;
     }
 
+    /**
+     * Static tells OLM not to update the OperatorGroup's providedAPIs annotation
+     */
     @JsonProperty("staticProvidedAPIs")
     public void setStaticProvidedAPIs(Boolean staticProvidedAPIs) {
         this.staticProvidedAPIs = staticProvidedAPIs;
     }
 
+    /**
+     * TargetNamespaces is an explicit set of namespaces to target. If it is set, Selector is ignored.
+     */
     @JsonProperty("targetNamespaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getTargetNamespaces() {
         return targetNamespaces;
     }
 
+    /**
+     * TargetNamespaces is an explicit set of namespaces to target. If it is set, Selector is ignored.
+     */
     @JsonProperty("targetNamespaces")
     public void setTargetNamespaces(List<String> targetNamespaces) {
         this.targetNamespaces = targetNamespaces;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha2/OperatorGroupStatus.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha2/OperatorGroupStatus.java
index f1a74bbaf51..8bc334db91b 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha2/OperatorGroupStatus.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v1alpha2/OperatorGroupStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorGroupStatus is the status for an OperatorGroupResource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public OperatorGroupStatus(String lastUpdated, List<String> namespaces, ObjectRe
         this.serviceAccountRef = serviceAccountRef;
     }
 
+    /**
+     * OperatorGroupStatus is the status for an OperatorGroupResource.
+     */
     @JsonProperty("lastUpdated")
     public String getLastUpdated() {
         return lastUpdated;
     }
 
+    /**
+     * OperatorGroupStatus is the status for an OperatorGroupResource.
+     */
     @JsonProperty("lastUpdated")
     public void setLastUpdated(String lastUpdated) {
         this.lastUpdated = lastUpdated;
     }
 
+    /**
+     * Namespaces is the set of target namespaces for the OperatorGroup.
+     */
     @JsonProperty("namespaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNamespaces() {
         return namespaces;
     }
 
+    /**
+     * Namespaces is the set of target namespaces for the OperatorGroup.
+     */
     @JsonProperty("namespaces")
     public void setNamespaces(List<String> namespaces) {
         this.namespaces = namespaces;
     }
 
+    /**
+     * OperatorGroupStatus is the status for an OperatorGroupResource.
+     */
     @JsonProperty("serviceAccountRef")
     public ObjectReference getServiceAccountRef() {
         return serviceAccountRef;
     }
 
+    /**
+     * OperatorGroupStatus is the status for an OperatorGroupResource.
+     */
     @JsonProperty("serviceAccountRef")
     public void setServiceAccountRef(ObjectReference serviceAccountRef) {
         this.serviceAccountRef = serviceAccountRef;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v2/OperatorCondition.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v2/OperatorCondition.java
index 6f026d0f53c..52fddf909ae 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v2/OperatorCondition.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v2/OperatorCondition.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorCondition is a Custom Resource of type `OperatorCondition` which is used to convey information to OLM about the state of an operator.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class OperatorCondition implements Editable<OperatorConditionBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operators.coreos.com/v2";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OperatorCondition";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public OperatorCondition(String apiVersion, String kind, ObjectMeta metadata, Op
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OperatorCondition is a Custom Resource of type `OperatorCondition` which is used to convey information to OLM about the state of an operator.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OperatorCondition is a Custom Resource of type `OperatorCondition` which is used to convey information to OLM about the state of an operator.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * OperatorCondition is a Custom Resource of type `OperatorCondition` which is used to convey information to OLM about the state of an operator.
+     */
     @JsonProperty("spec")
     public OperatorConditionSpec getSpec() {
         return spec;
     }
 
+    /**
+     * OperatorCondition is a Custom Resource of type `OperatorCondition` which is used to convey information to OLM about the state of an operator.
+     */
     @JsonProperty("spec")
     public void setSpec(OperatorConditionSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * OperatorCondition is a Custom Resource of type `OperatorCondition` which is used to convey information to OLM about the state of an operator.
+     */
     @JsonProperty("status")
     public OperatorConditionStatus getStatus() {
         return status;
     }
 
+    /**
+     * OperatorCondition is a Custom Resource of type `OperatorCondition` which is used to convey information to OLM about the state of an operator.
+     */
     @JsonProperty("status")
     public void setStatus(OperatorConditionStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v2/OperatorConditionList.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v2/OperatorConditionList.java
index 76bd7e49fe5..3d1a337dd96 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v2/OperatorConditionList.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v2/OperatorConditionList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorConditionList represents a list of Conditions.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class OperatorConditionList implements Editable<OperatorConditionListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.operatorhub.v2.OperatorCondition>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "operators.coreos.com/v2";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.operatorhub.v2.OperatorCondition> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OperatorConditionList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public OperatorConditionList(String apiVersion, List<io.fabric8.openshift.api.mo
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * OperatorConditionList represents a list of Conditions.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.operatorhub.v2.OperatorCondition> getItems() {
         return items;
     }
 
+    /**
+     * OperatorConditionList represents a list of Conditions.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.operatorhub.v2.OperatorCondition> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OperatorConditionList represents a list of Conditions.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OperatorConditionList represents a list of Conditions.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v2/OperatorConditionSpec.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v2/OperatorConditionSpec.java
index 7d7937bbbe5..30036c79ea9 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v2/OperatorConditionSpec.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v2/OperatorConditionSpec.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorConditionSpec allows an operator to report state to OLM and provides cluster admin with the ability to manually override state reported by the operator.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -97,45 +100,69 @@ public OperatorConditionSpec(List<Condition> conditions, List<String> deployment
         this.serviceAccounts = serviceAccounts;
     }
 
+    /**
+     * OperatorConditionSpec allows an operator to report state to OLM and provides cluster admin with the ability to manually override state reported by the operator.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * OperatorConditionSpec allows an operator to report state to OLM and provides cluster admin with the ability to manually override state reported by the operator.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * OperatorConditionSpec allows an operator to report state to OLM and provides cluster admin with the ability to manually override state reported by the operator.
+     */
     @JsonProperty("deployments")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDeployments() {
         return deployments;
     }
 
+    /**
+     * OperatorConditionSpec allows an operator to report state to OLM and provides cluster admin with the ability to manually override state reported by the operator.
+     */
     @JsonProperty("deployments")
     public void setDeployments(List<String> deployments) {
         this.deployments = deployments;
     }
 
+    /**
+     * OperatorConditionSpec allows an operator to report state to OLM and provides cluster admin with the ability to manually override state reported by the operator.
+     */
     @JsonProperty("overrides")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getOverrides() {
         return overrides;
     }
 
+    /**
+     * OperatorConditionSpec allows an operator to report state to OLM and provides cluster admin with the ability to manually override state reported by the operator.
+     */
     @JsonProperty("overrides")
     public void setOverrides(List<Condition> overrides) {
         this.overrides = overrides;
     }
 
+    /**
+     * OperatorConditionSpec allows an operator to report state to OLM and provides cluster admin with the ability to manually override state reported by the operator.
+     */
     @JsonProperty("serviceAccounts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getServiceAccounts() {
         return serviceAccounts;
     }
 
+    /**
+     * OperatorConditionSpec allows an operator to report state to OLM and provides cluster admin with the ability to manually override state reported by the operator.
+     */
     @JsonProperty("serviceAccounts")
     public void setServiceAccounts(List<String> serviceAccounts) {
         this.serviceAccounts = serviceAccounts;
diff --git a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v2/OperatorConditionStatus.java b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v2/OperatorConditionStatus.java
index f0e3b340276..c3e8d40256a 100644
--- a/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v2/OperatorConditionStatus.java
+++ b/kubernetes-model-generator/openshift-model-operatorhub/src/generated/java/io/fabric8/openshift/api/model/operatorhub/v2/OperatorConditionStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OperatorConditionStatus allows OLM to convey which conditions have been observed.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,12 +85,18 @@ public OperatorConditionStatus(List<Condition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * OperatorConditionStatus allows OLM to convey which conditions have been observed.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Condition> getConditions() {
         return conditions;
     }
 
+    /**
+     * OperatorConditionStatus allows OLM to convey which conditions have been observed.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<Condition> conditions) {
         this.conditions = conditions;
diff --git a/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageState.java b/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageState.java
index a5f8a0f675c..36c6aac5a56 100644
--- a/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageState.java
+++ b/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageState.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * The state of the storage of a specific resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class StorageState implements Editable<StorageStateBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "migration.k8s.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "StorageState";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public StorageState(String apiVersion, String kind, ObjectMeta metadata, Storage
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * The state of the storage of a specific resource.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * The state of the storage of a specific resource.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * The state of the storage of a specific resource.
+     */
     @JsonProperty("spec")
     public StorageStateSpec getSpec() {
         return spec;
     }
 
+    /**
+     * The state of the storage of a specific resource.
+     */
     @JsonProperty("spec")
     public void setSpec(StorageStateSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * The state of the storage of a specific resource.
+     */
     @JsonProperty("status")
     public StorageStateStatus getStatus() {
         return status;
     }
 
+    /**
+     * The state of the storage of a specific resource.
+     */
     @JsonProperty("status")
     public void setStatus(StorageStateStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageStateList.java b/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageStateList.java
index 496132b0383..5dc88d97d8f 100644
--- a/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageStateList.java
+++ b/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageStateList.java
@@ -78,17 +78,11 @@
 public class StorageStateList implements Editable<StorageStateListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.storageversionmigrator.v1alpha1.StorageState>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "migration.k8s.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.storageversionmigrator.v1alpha1.StorageState> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "StorageStateList";
     @JsonProperty("metadata")
@@ -110,17 +104,11 @@ public StorageStateList(String apiVersion, List<io.fabric8.openshift.api.model.s
         this.metadata = metadata;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
@@ -137,17 +125,11 @@ public void setItems(List<io.fabric8.openshift.api.model.storageversionmigrator.
         this.items = items;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageStateSpec.java b/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageStateSpec.java
index 521bd463231..6aa0fad58ac 100644
--- a/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageStateSpec.java
+++ b/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageStateSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Specification of the storage state.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public StorageStateSpec(StorageStateSpecResource resource) {
         this.resource = resource;
     }
 
+    /**
+     * Specification of the storage state.
+     */
     @JsonProperty("resource")
     public StorageStateSpecResource getResource() {
         return resource;
     }
 
+    /**
+     * Specification of the storage state.
+     */
     @JsonProperty("resource")
     public void setResource(StorageStateSpecResource resource) {
         this.resource = resource;
diff --git a/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageStateSpecResource.java b/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageStateSpecResource.java
index 2999979d148..9aebe9da841 100644
--- a/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageStateSpecResource.java
+++ b/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageStateSpecResource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * The resource this storageState is about.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public StorageStateSpecResource(String group, String resource) {
         this.resource = resource;
     }
 
+    /**
+     * The name of the group.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * The name of the group.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * The name of the resource.
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * The name of the resource.
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
diff --git a/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageStateStatus.java b/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageStateStatus.java
index 38f6cb04b77..eb4eec0c946 100644
--- a/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageStateStatus.java
+++ b/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageStateStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Status of the storage state.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public StorageStateStatus(String currentStorageVersionHash, String lastHeartbeat
         this.persistedStorageVersionHashes = persistedStorageVersionHashes;
     }
 
+    /**
+     * The hash value of the current storage version, as shown in the discovery document served by the API server. Storage Version is the version to which objects are converted to before persisted.
+     */
     @JsonProperty("currentStorageVersionHash")
     public String getCurrentStorageVersionHash() {
         return currentStorageVersionHash;
     }
 
+    /**
+     * The hash value of the current storage version, as shown in the discovery document served by the API server. Storage Version is the version to which objects are converted to before persisted.
+     */
     @JsonProperty("currentStorageVersionHash")
     public void setCurrentStorageVersionHash(String currentStorageVersionHash) {
         this.currentStorageVersionHash = currentStorageVersionHash;
     }
 
+    /**
+     * LastHeartbeatTime is the last time the storage migration triggering controller checks the storage version hash of this resource in the discovery document and updates this field.
+     */
     @JsonProperty("lastHeartbeatTime")
     public String getLastHeartbeatTime() {
         return lastHeartbeatTime;
     }
 
+    /**
+     * LastHeartbeatTime is the last time the storage migration triggering controller checks the storage version hash of this resource in the discovery document and updates this field.
+     */
     @JsonProperty("lastHeartbeatTime")
     public void setLastHeartbeatTime(String lastHeartbeatTime) {
         this.lastHeartbeatTime = lastHeartbeatTime;
     }
 
+    /**
+     * The hash values of storage versions that persisted instances of spec.resource might still be encoded in. "Unknown" is a valid value in the list, and is the default value. It is not safe to upgrade or downgrade to an apiserver binary that does not support all versions listed in this field, or if "Unknown" is listed. Once the storage version migration for this resource has completed, the value of this field is refined to only contain the currentStorageVersionHash. Once the apiserver has changed the storage version, the new storage version is appended to the list.
+     */
     @JsonProperty("persistedStorageVersionHashes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getPersistedStorageVersionHashes() {
         return persistedStorageVersionHashes;
     }
 
+    /**
+     * The hash values of storage versions that persisted instances of spec.resource might still be encoded in. "Unknown" is a valid value in the list, and is the default value. It is not safe to upgrade or downgrade to an apiserver binary that does not support all versions listed in this field, or if "Unknown" is listed. Once the storage version migration for this resource has completed, the value of this field is refined to only contain the currentStorageVersionHash. Once the apiserver has changed the storage version, the new storage version is appended to the list.
+     */
     @JsonProperty("persistedStorageVersionHashes")
     public void setPersistedStorageVersionHashes(List<String> persistedStorageVersionHashes) {
         this.persistedStorageVersionHashes = persistedStorageVersionHashes;
diff --git a/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageVersionMigration.java b/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageVersionMigration.java
index ff15d39f57d..32ba0cd40ce 100644
--- a/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageVersionMigration.java
+++ b/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageVersionMigration.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StorageVersionMigration represents a migration of stored data to the latest storage version.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class StorageVersionMigration implements Editable<StorageVersionMigrationBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "migration.k8s.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "StorageVersionMigration";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public StorageVersionMigration(String apiVersion, String kind, ObjectMeta metada
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * StorageVersionMigration represents a migration of stored data to the latest storage version.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * StorageVersionMigration represents a migration of stored data to the latest storage version.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * StorageVersionMigration represents a migration of stored data to the latest storage version.
+     */
     @JsonProperty("spec")
     public StorageVersionMigrationSpec getSpec() {
         return spec;
     }
 
+    /**
+     * StorageVersionMigration represents a migration of stored data to the latest storage version.
+     */
     @JsonProperty("spec")
     public void setSpec(StorageVersionMigrationSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * StorageVersionMigration represents a migration of stored data to the latest storage version.
+     */
     @JsonProperty("status")
     public StorageVersionMigrationStatus getStatus() {
         return status;
     }
 
+    /**
+     * StorageVersionMigration represents a migration of stored data to the latest storage version.
+     */
     @JsonProperty("status")
     public void setStatus(StorageVersionMigrationStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageVersionMigrationList.java b/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageVersionMigrationList.java
index 0a11bc9fbd3..ccae4993c0c 100644
--- a/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageVersionMigrationList.java
+++ b/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageVersionMigrationList.java
@@ -78,17 +78,11 @@
 public class StorageVersionMigrationList implements Editable<StorageVersionMigrationListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.storageversionmigrator.v1alpha1.StorageVersionMigration>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "migration.k8s.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.storageversionmigrator.v1alpha1.StorageVersionMigration> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "StorageVersionMigrationList";
     @JsonProperty("metadata")
@@ -110,17 +104,11 @@ public StorageVersionMigrationList(String apiVersion, List<io.fabric8.openshift.
         this.metadata = metadata;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
@@ -137,17 +125,11 @@ public void setItems(List<io.fabric8.openshift.api.model.storageversionmigrator.
         this.items = items;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageVersionMigrationSpec.java b/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageVersionMigrationSpec.java
index b51febbdd27..c296c867bfd 100644
--- a/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageVersionMigrationSpec.java
+++ b/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageVersionMigrationSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Specification of the migration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public StorageVersionMigrationSpec(String continueToken, StorageVersionMigration
         this.resource = resource;
     }
 
+    /**
+     * The token used in the list options to get the next chunk of objects to migrate. When the .status.conditions indicates the migration is "Running", users can use this token to check the progress of the migration.
+     */
     @JsonProperty("continueToken")
     public String getContinueToken() {
         return continueToken;
     }
 
+    /**
+     * The token used in the list options to get the next chunk of objects to migrate. When the .status.conditions indicates the migration is "Running", users can use this token to check the progress of the migration.
+     */
     @JsonProperty("continueToken")
     public void setContinueToken(String continueToken) {
         this.continueToken = continueToken;
     }
 
+    /**
+     * Specification of the migration.
+     */
     @JsonProperty("resource")
     public StorageVersionMigrationSpecResource getResource() {
         return resource;
     }
 
+    /**
+     * Specification of the migration.
+     */
     @JsonProperty("resource")
     public void setResource(StorageVersionMigrationSpecResource resource) {
         this.resource = resource;
diff --git a/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageVersionMigrationSpecResource.java b/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageVersionMigrationSpecResource.java
index 5caceb4a891..79a5d0570bb 100644
--- a/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageVersionMigrationSpecResource.java
+++ b/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageVersionMigrationSpecResource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * The resource that is being migrated. The migrator sends requests to the endpoint serving the resource. Immutable.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public StorageVersionMigrationSpecResource(String group, String resource, String
         this.version = version;
     }
 
+    /**
+     * The name of the group.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * The name of the group.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * The name of the resource.
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * The name of the resource.
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
     }
 
+    /**
+     * The name of the version.
+     */
     @JsonProperty("version")
     public String getVersion() {
         return version;
     }
 
+    /**
+     * The name of the version.
+     */
     @JsonProperty("version")
     public void setVersion(String version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageVersionMigrationStatus.java b/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageVersionMigrationStatus.java
index 28765e355d7..beac148e0eb 100644
--- a/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageVersionMigrationStatus.java
+++ b/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageVersionMigrationStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Status of the migration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public StorageVersionMigrationStatus(List<StorageVersionMigrationStatusCondition
         this.conditions = conditions;
     }
 
+    /**
+     * The latest available observations of the migration's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<StorageVersionMigrationStatusConditions> getConditions() {
         return conditions;
     }
 
+    /**
+     * The latest available observations of the migration's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<StorageVersionMigrationStatusConditions> conditions) {
         this.conditions = conditions;
diff --git a/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageVersionMigrationStatusConditions.java b/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageVersionMigrationStatusConditions.java
index 2dd8dc68adf..0ad69db4355 100644
--- a/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageVersionMigrationStatusConditions.java
+++ b/kubernetes-model-generator/openshift-model-storageversionmigrator/src/generated/java/io/fabric8/openshift/api/model/storageversionmigrator/v1alpha1/StorageVersionMigrationStatusConditions.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Describes the state of a migration at a certain point.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public StorageVersionMigrationStatusConditions(String lastUpdateTime, String mes
         this.type = type;
     }
 
+    /**
+     * The last time this condition was updated.
+     */
     @JsonProperty("lastUpdateTime")
     public String getLastUpdateTime() {
         return lastUpdateTime;
     }
 
+    /**
+     * The last time this condition was updated.
+     */
     @JsonProperty("lastUpdateTime")
     public void setLastUpdateTime(String lastUpdateTime) {
         this.lastUpdateTime = lastUpdateTime;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type of the condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of the condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/OperandConfig.java b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/OperandConfig.java
index 473c7baeb52..712eada921a 100644
--- a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/OperandConfig.java
+++ b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/OperandConfig.java
@@ -86,11 +86,17 @@ public OperandConfig(Boolean debug, TuneDConfig tunedConfig, Integer verbosity)
         this.verbosity = verbosity;
     }
 
+    /**
+     * turn debugging on/off for the TuneD daemon: true/false (default is false)
+     */
     @JsonProperty("debug")
     public Boolean getDebug() {
         return debug;
     }
 
+    /**
+     * turn debugging on/off for the TuneD daemon: true/false (default is false)
+     */
     @JsonProperty("debug")
     public void setDebug(Boolean debug) {
         this.debug = debug;
@@ -106,11 +112,17 @@ public void setTunedConfig(TuneDConfig tunedConfig) {
         this.tunedConfig = tunedConfig;
     }
 
+    /**
+     * klog logging verbosity
+     */
     @JsonProperty("verbosity")
     public Integer getVerbosity() {
         return verbosity;
     }
 
+    /**
+     * klog logging verbosity
+     */
     @JsonProperty("verbosity")
     public void setVerbosity(Integer verbosity) {
         this.verbosity = verbosity;
diff --git a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/Profile.java b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/Profile.java
index c8f5c46cf8c..0b461f69c59 100644
--- a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/Profile.java
+++ b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/Profile.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Profile is a specification for a Profile resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Profile implements Editable<ProfileBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tuned.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Profile";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Profile(String apiVersion, String kind, ObjectMeta metadata, ProfileSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Profile is a specification for a Profile resource.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Profile is a specification for a Profile resource.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Profile is a specification for a Profile resource.
+     */
     @JsonProperty("spec")
     public ProfileSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Profile is a specification for a Profile resource.
+     */
     @JsonProperty("spec")
     public void setSpec(ProfileSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Profile is a specification for a Profile resource.
+     */
     @JsonProperty("status")
     public ProfileStatus getStatus() {
         return status;
     }
 
+    /**
+     * Profile is a specification for a Profile resource.
+     */
     @JsonProperty("status")
     public void setStatus(ProfileStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/ProfileConfig.java b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/ProfileConfig.java
index 1d9f1955a9e..88449aaf6d8 100644
--- a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/ProfileConfig.java
+++ b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/ProfileConfig.java
@@ -94,21 +94,33 @@ public ProfileConfig(Boolean debug, String providerName, TuneDConfig tunedConfig
         this.verbosity = verbosity;
     }
 
+    /**
+     * option to debug TuneD daemon execution
+     */
     @JsonProperty("debug")
     public Boolean getDebug() {
         return debug;
     }
 
+    /**
+     * option to debug TuneD daemon execution
+     */
     @JsonProperty("debug")
     public void setDebug(Boolean debug) {
         this.debug = debug;
     }
 
+    /**
+     * Name of the cloud provider as taken from the Node providerID: &lt;ProviderName&gt;://&lt;ProviderSpecificNodeID&gt;
+     */
     @JsonProperty("providerName")
     public String getProviderName() {
         return providerName;
     }
 
+    /**
+     * Name of the cloud provider as taken from the Node providerID: &lt;ProviderName&gt;://&lt;ProviderSpecificNodeID&gt;
+     */
     @JsonProperty("providerName")
     public void setProviderName(String providerName) {
         this.providerName = providerName;
@@ -124,21 +136,33 @@ public void setTunedConfig(TuneDConfig tunedConfig) {
         this.tunedConfig = tunedConfig;
     }
 
+    /**
+     * TuneD profile to apply
+     */
     @JsonProperty("tunedProfile")
     public String getTunedProfile() {
         return tunedProfile;
     }
 
+    /**
+     * TuneD profile to apply
+     */
     @JsonProperty("tunedProfile")
     public void setTunedProfile(String tunedProfile) {
         this.tunedProfile = tunedProfile;
     }
 
+    /**
+     * klog logging verbosity
+     */
     @JsonProperty("verbosity")
     public Integer getVerbosity() {
         return verbosity;
     }
 
+    /**
+     * klog logging verbosity
+     */
     @JsonProperty("verbosity")
     public void setVerbosity(Integer verbosity) {
         this.verbosity = verbosity;
diff --git a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/ProfileList.java b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/ProfileList.java
index df2d5073400..f211a03251b 100644
--- a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/ProfileList.java
+++ b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/ProfileList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ProfileList is a list of Profile resources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ProfileList implements Editable<ProfileListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.tuned.v1.Profile>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tuned.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.tuned.v1.Profile> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ProfileList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ProfileList(String apiVersion, List<io.fabric8.openshift.api.model.tuned.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ProfileList is a list of Profile resources.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.tuned.v1.Profile> getItems() {
         return items;
     }
 
+    /**
+     * ProfileList is a list of Profile resources.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.tuned.v1.Profile> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ProfileList is a list of Profile resources.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ProfileList is a list of Profile resources.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/ProfileSpec.java b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/ProfileSpec.java
index 1d7dc5ea212..3a053c54bdf 100644
--- a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/ProfileSpec.java
+++ b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/ProfileSpec.java
@@ -95,12 +95,18 @@ public void setConfig(ProfileConfig config) {
         this.config = config;
     }
 
+    /**
+     * Tuned profiles.
+     */
     @JsonProperty("profile")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TunedProfile> getProfile() {
         return profile;
     }
 
+    /**
+     * Tuned profiles.
+     */
     @JsonProperty("profile")
     public void setProfile(List<TunedProfile> profile) {
         this.profile = profile;
diff --git a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/ProfileStatus.java b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/ProfileStatus.java
index dc5b832b37f..934cb6ef695 100644
--- a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/ProfileStatus.java
+++ b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/ProfileStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ProfileStatus is the status for a Profile resource; the status is for internal use only and its fields may be changed/removed in the future.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public ProfileStatus(List<ProfileStatusCondition> conditions, String tunedProfil
         this.tunedProfile = tunedProfile;
     }
 
+    /**
+     * conditions represents the state of the per-node Profile application
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ProfileStatusCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions represents the state of the per-node Profile application
+     */
     @JsonProperty("conditions")
     public void setConditions(List<ProfileStatusCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * the current profile in use by the Tuned daemon
+     */
     @JsonProperty("tunedProfile")
     public String getTunedProfile() {
         return tunedProfile;
     }
 
+    /**
+     * the current profile in use by the Tuned daemon
+     */
     @JsonProperty("tunedProfile")
     public void setTunedProfile(String tunedProfile) {
         this.tunedProfile = tunedProfile;
diff --git a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/ProfileStatusCondition.java b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/ProfileStatusCondition.java
index d9c54a68db2..a9cb8028ccf 100644
--- a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/ProfileStatusCondition.java
+++ b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/ProfileStatusCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ProfileStatusCondition represents a partial state of the per-node Profile application.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public ProfileStatusCondition(String lastTransitionTime, String message, String
         this.type = type;
     }
 
+    /**
+     * ProfileStatusCondition represents a partial state of the per-node Profile application.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * ProfileStatusCondition represents a partial state of the per-node Profile application.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * message provides additional information about the current condition. This is only to be consumed by humans.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message provides additional information about the current condition. This is only to be consumed by humans.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * reason is the CamelCase reason for the condition's current status.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * reason is the CamelCase reason for the condition's current status.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * type specifies the aspect reported by this condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type specifies the aspect reported by this condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/TuneDConfig.java b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/TuneDConfig.java
index 86f4c668a2b..e3fd0889064 100644
--- a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/TuneDConfig.java
+++ b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/TuneDConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Global configuration for the TuneD daemon as defined in tuned-main.conf
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public TuneDConfig(Boolean reapplySysctl) {
         this.reapplySysctl = reapplySysctl;
     }
 
+    /**
+     * turn reapply_sysctl functionality on/off for the TuneD daemon: true/false
+     */
     @JsonProperty("reapply_sysctl")
     public Boolean getReapplySysctl() {
         return reapplySysctl;
     }
 
+    /**
+     * turn reapply_sysctl functionality on/off for the TuneD daemon: true/false
+     */
     @JsonProperty("reapply_sysctl")
     public void setReapplySysctl(Boolean reapplySysctl) {
         this.reapplySysctl = reapplySysctl;
diff --git a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/Tuned.java b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/Tuned.java
index eb446974d2b..5a5fa6d12d3 100644
--- a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/Tuned.java
+++ b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/Tuned.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Tuned is a collection of rules that allows cluster-wide deployment of node-level sysctls and more flexibility to add custom tuning specified by user needs.  These rules are translated and passed to all containerized Tuned daemons running in the cluster in the format that the daemons understand. The responsibility for applying the node-level tuning then lies with the containerized Tuned daemons. More info: https://github.com/openshift/cluster-node-tuning-operator
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Tuned implements Editable<TunedBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tuned.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Tuned";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Tuned(String apiVersion, String kind, ObjectMeta metadata, TunedSpec spec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Tuned is a collection of rules that allows cluster-wide deployment of node-level sysctls and more flexibility to add custom tuning specified by user needs.  These rules are translated and passed to all containerized Tuned daemons running in the cluster in the format that the daemons understand. The responsibility for applying the node-level tuning then lies with the containerized Tuned daemons. More info: https://github.com/openshift/cluster-node-tuning-operator
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Tuned is a collection of rules that allows cluster-wide deployment of node-level sysctls and more flexibility to add custom tuning specified by user needs.  These rules are translated and passed to all containerized Tuned daemons running in the cluster in the format that the daemons understand. The responsibility for applying the node-level tuning then lies with the containerized Tuned daemons. More info: https://github.com/openshift/cluster-node-tuning-operator
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Tuned is a collection of rules that allows cluster-wide deployment of node-level sysctls and more flexibility to add custom tuning specified by user needs.  These rules are translated and passed to all containerized Tuned daemons running in the cluster in the format that the daemons understand. The responsibility for applying the node-level tuning then lies with the containerized Tuned daemons. More info: https://github.com/openshift/cluster-node-tuning-operator
+     */
     @JsonProperty("spec")
     public TunedSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Tuned is a collection of rules that allows cluster-wide deployment of node-level sysctls and more flexibility to add custom tuning specified by user needs.  These rules are translated and passed to all containerized Tuned daemons running in the cluster in the format that the daemons understand. The responsibility for applying the node-level tuning then lies with the containerized Tuned daemons. More info: https://github.com/openshift/cluster-node-tuning-operator
+     */
     @JsonProperty("spec")
     public void setSpec(TunedSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Tuned is a collection of rules that allows cluster-wide deployment of node-level sysctls and more flexibility to add custom tuning specified by user needs.  These rules are translated and passed to all containerized Tuned daemons running in the cluster in the format that the daemons understand. The responsibility for applying the node-level tuning then lies with the containerized Tuned daemons. More info: https://github.com/openshift/cluster-node-tuning-operator
+     */
     @JsonProperty("status")
     public TunedStatus getStatus() {
         return status;
     }
 
+    /**
+     * Tuned is a collection of rules that allows cluster-wide deployment of node-level sysctls and more flexibility to add custom tuning specified by user needs.  These rules are translated and passed to all containerized Tuned daemons running in the cluster in the format that the daemons understand. The responsibility for applying the node-level tuning then lies with the containerized Tuned daemons. More info: https://github.com/openshift/cluster-node-tuning-operator
+     */
     @JsonProperty("status")
     public void setStatus(TunedStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/TunedList.java b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/TunedList.java
index 5bbb18e6892..509231688f4 100644
--- a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/TunedList.java
+++ b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/TunedList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TunedList is a list of Tuned resources.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class TunedList implements Editable<TunedListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.tuned.v1.Tuned>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "tuned.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.tuned.v1.Tuned> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TunedList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TunedList(String apiVersion, List<io.fabric8.openshift.api.model.tuned.v1
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * TunedList is a list of Tuned resources.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.tuned.v1.Tuned> getItems() {
         return items;
     }
 
+    /**
+     * TunedList is a list of Tuned resources.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.tuned.v1.Tuned> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TunedList is a list of Tuned resources.
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TunedList is a list of Tuned resources.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/TunedMatch.java b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/TunedMatch.java
index 8870fd0b431..766adb89328 100644
--- a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/TunedMatch.java
+++ b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/TunedMatch.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Rules governing application of a Tuned profile.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public TunedMatch(String label, List<io.fabric8.openshift.api.model.tuned.v1.Tun
         this.value = value;
     }
 
+    /**
+     * Node or Pod label name.
+     */
     @JsonProperty("label")
     public String getLabel() {
         return label;
     }
 
+    /**
+     * Node or Pod label name.
+     */
     @JsonProperty("label")
     public void setLabel(String label) {
         this.label = label;
     }
 
+    /**
+     * Additional rules governing application of the tuned profile connected by logical AND operator.
+     */
     @JsonProperty("match")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.tuned.v1.TunedMatch> getMatch() {
         return match;
     }
 
+    /**
+     * Additional rules governing application of the tuned profile connected by logical AND operator.
+     */
     @JsonProperty("match")
     public void setMatch(List<io.fabric8.openshift.api.model.tuned.v1.TunedMatch> match) {
         this.match = match;
     }
 
+    /**
+     * Match type: [node/pod]. If omitted, "node" is assumed.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Match type: [node/pod]. If omitted, "node" is assumed.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * Node or Pod label value. If omitted, the presence of label name is enough to match.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Node or Pod label value. If omitted, the presence of label name is enough to match.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/TunedProfile.java b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/TunedProfile.java
index d48ed25d28a..e62757f0ec9 100644
--- a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/TunedProfile.java
+++ b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/TunedProfile.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * A Tuned profile.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public TunedProfile(String data, String name) {
         this.name = name;
     }
 
+    /**
+     * Specification of the Tuned profile to be consumed by the Tuned daemon.
+     */
     @JsonProperty("data")
     public String getData() {
         return data;
     }
 
+    /**
+     * Specification of the Tuned profile to be consumed by the Tuned daemon.
+     */
     @JsonProperty("data")
     public void setData(String data) {
         this.data = data;
     }
 
+    /**
+     * Name of the Tuned profile to be used in the recommend section.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the Tuned profile to be used in the recommend section.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/TunedRecommend.java b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/TunedRecommend.java
index 1aebcc97910..c3e80c83bb7 100644
--- a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/TunedRecommend.java
+++ b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/TunedRecommend.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Selection logic for a single Tuned profile.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,53 +101,83 @@ public TunedRecommend(Map<String, String> machineConfigLabels, List<TunedMatch>
         this.profile = profile;
     }
 
+    /**
+     * MachineConfigLabels specifies the labels for a MachineConfig. The MachineConfig is created automatically to apply additional host settings (e.g. kernel boot parameters) profile 'Profile' needs and can only be applied by creating a MachineConfig. This involves finding all MachineConfigPools with machineConfigSelector matching the MachineConfigLabels and setting the profile 'Profile' on all nodes that match the MachineConfigPools' nodeSelectors.
+     */
     @JsonProperty("machineConfigLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getMachineConfigLabels() {
         return machineConfigLabels;
     }
 
+    /**
+     * MachineConfigLabels specifies the labels for a MachineConfig. The MachineConfig is created automatically to apply additional host settings (e.g. kernel boot parameters) profile 'Profile' needs and can only be applied by creating a MachineConfig. This involves finding all MachineConfigPools with machineConfigSelector matching the MachineConfigLabels and setting the profile 'Profile' on all nodes that match the MachineConfigPools' nodeSelectors.
+     */
     @JsonProperty("machineConfigLabels")
     public void setMachineConfigLabels(Map<String, String> machineConfigLabels) {
         this.machineConfigLabels = machineConfigLabels;
     }
 
+    /**
+     * Rules governing application of a Tuned profile connected by logical OR operator.
+     */
     @JsonProperty("match")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TunedMatch> getMatch() {
         return match;
     }
 
+    /**
+     * Rules governing application of a Tuned profile connected by logical OR operator.
+     */
     @JsonProperty("match")
     public void setMatch(List<TunedMatch> match) {
         this.match = match;
     }
 
+    /**
+     * Selection logic for a single Tuned profile.
+     */
     @JsonProperty("operand")
     public OperandConfig getOperand() {
         return operand;
     }
 
+    /**
+     * Selection logic for a single Tuned profile.
+     */
     @JsonProperty("operand")
     public void setOperand(OperandConfig operand) {
         this.operand = operand;
     }
 
+    /**
+     * Tuned profile priority. Highest priority is 0.
+     */
     @JsonProperty("priority")
     public Long getPriority() {
         return priority;
     }
 
+    /**
+     * Tuned profile priority. Highest priority is 0.
+     */
     @JsonProperty("priority")
     public void setPriority(Long priority) {
         this.priority = priority;
     }
 
+    /**
+     * Name of the Tuned profile to recommend.
+     */
     @JsonProperty("profile")
     public String getProfile() {
         return profile;
     }
 
+    /**
+     * Name of the Tuned profile to recommend.
+     */
     @JsonProperty("profile")
     public void setProfile(String profile) {
         this.profile = profile;
diff --git a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/TunedSpec.java b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/TunedSpec.java
index 9c1dee7de3d..7e058191064 100644
--- a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/TunedSpec.java
+++ b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/TunedSpec.java
@@ -90,33 +90,51 @@ public TunedSpec(String managementState, List<TunedProfile> profile, List<TunedR
         this.recommend = recommend;
     }
 
+    /**
+     * managementState indicates whether the registry instance represented by this config instance is under operator management or not.  Valid values are Force, Managed, Unmanaged, and Removed.
+     */
     @JsonProperty("managementState")
     public String getManagementState() {
         return managementState;
     }
 
+    /**
+     * managementState indicates whether the registry instance represented by this config instance is under operator management or not.  Valid values are Force, Managed, Unmanaged, and Removed.
+     */
     @JsonProperty("managementState")
     public void setManagementState(String managementState) {
         this.managementState = managementState;
     }
 
+    /**
+     * Tuned profiles.
+     */
     @JsonProperty("profile")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TunedProfile> getProfile() {
         return profile;
     }
 
+    /**
+     * Tuned profiles.
+     */
     @JsonProperty("profile")
     public void setProfile(List<TunedProfile> profile) {
         this.profile = profile;
     }
 
+    /**
+     * Selection logic for all Tuned profiles.
+     */
     @JsonProperty("recommend")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TunedRecommend> getRecommend() {
         return recommend;
     }
 
+    /**
+     * Selection logic for all Tuned profiles.
+     */
     @JsonProperty("recommend")
     public void setRecommend(List<TunedRecommend> recommend) {
         this.recommend = recommend;
diff --git a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/TunedStatus.java b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/TunedStatus.java
index 5123144469c..6335eb76ebf 100644
--- a/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/TunedStatus.java
+++ b/kubernetes-model-generator/openshift-model-tuned/src/generated/java/io/fabric8/openshift/api/model/tuned/v1/TunedStatus.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TunedStatus is the status for a Tuned resource.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
diff --git a/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/IPPool.java b/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/IPPool.java
index 56679033cca..61f1453812a 100644
--- a/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/IPPool.java
+++ b/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/IPPool.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IPPool is the Schema for the ippools API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class IPPool implements Editable<IPPoolBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "whereabouts.cni.cncf.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "IPPool";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public IPPool(String apiVersion, String kind, ObjectMeta metadata, IPPoolSpec sp
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object.<br><p> Servers should convert recognized schemas to the latest internal value, and<br><p> may reject unrecognized values.<br><p> More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object.<br><p> Servers should convert recognized schemas to the latest internal value, and<br><p> may reject unrecognized values.<br><p> More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents.<br><p> Servers may infer this from the endpoint the client submits requests to.<br><p> Cannot be updated.<br><p> In CamelCase.<br><p> More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents.<br><p> Servers may infer this from the endpoint the client submits requests to.<br><p> Cannot be updated.<br><p> In CamelCase.<br><p> More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * IPPool is the Schema for the ippools API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * IPPool is the Schema for the ippools API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * IPPool is the Schema for the ippools API
+     */
     @JsonProperty("spec")
     public IPPoolSpec getSpec() {
         return spec;
     }
 
+    /**
+     * IPPool is the Schema for the ippools API
+     */
     @JsonProperty("spec")
     public void setSpec(IPPoolSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/IPPoolList.java b/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/IPPoolList.java
index 2f5c6e3be45..e5390fcdba5 100644
--- a/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/IPPoolList.java
+++ b/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/IPPoolList.java
@@ -78,17 +78,11 @@
 public class IPPoolList implements Editable<IPPoolListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.whereabouts.v1alpha1.IPPool>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "whereabouts.cni.cncf.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.whereabouts.v1alpha1.IPPool> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "IPPoolList";
     @JsonProperty("metadata")
@@ -110,17 +104,11 @@ public IPPoolList(String apiVersion, List<io.fabric8.openshift.api.model.whereab
         this.metadata = metadata;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
@@ -137,17 +125,11 @@ public void setItems(List<io.fabric8.openshift.api.model.whereabouts.v1alpha1.IP
         this.items = items;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/IPPoolSpec.java b/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/IPPoolSpec.java
index 1f67d200d68..45d1c992171 100644
--- a/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/IPPoolSpec.java
+++ b/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/IPPoolSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IPPoolSpec defines the desired state of IPPool
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,22 +86,34 @@ public IPPoolSpec(Map<String, IPPoolSpecAllocations> allocations, String range)
         this.range = range;
     }
 
+    /**
+     * Allocations is the set of allocated IPs for the given range. Its` indices are a direct mapping to the<br><p> IP with the same index/offset for the pool's range.
+     */
     @JsonProperty("allocations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, IPPoolSpecAllocations> getAllocations() {
         return allocations;
     }
 
+    /**
+     * Allocations is the set of allocated IPs for the given range. Its` indices are a direct mapping to the<br><p> IP with the same index/offset for the pool's range.
+     */
     @JsonProperty("allocations")
     public void setAllocations(Map<String, IPPoolSpecAllocations> allocations) {
         this.allocations = allocations;
     }
 
+    /**
+     * Range is a RFC 4632/4291-style string that represents an IP address and prefix length in CIDR notation
+     */
     @JsonProperty("range")
     public String getRange() {
         return range;
     }
 
+    /**
+     * Range is a RFC 4632/4291-style string that represents an IP address and prefix length in CIDR notation
+     */
     @JsonProperty("range")
     public void setRange(String range) {
         this.range = range;
diff --git a/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/IPPoolSpecAllocations.java b/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/IPPoolSpecAllocations.java
index 8fd0a50f279..00fac7f414e 100644
--- a/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/IPPoolSpecAllocations.java
+++ b/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/IPPoolSpecAllocations.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IPAllocation represents metadata about the pod/container owner of a specific IP
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public IPPoolSpecAllocations(String id, String ifname, String podref) {
         this.podref = podref;
     }
 
+    /**
+     * IPAllocation represents metadata about the pod/container owner of a specific IP
+     */
     @JsonProperty("id")
     public String getId() {
         return id;
     }
 
+    /**
+     * IPAllocation represents metadata about the pod/container owner of a specific IP
+     */
     @JsonProperty("id")
     public void setId(String id) {
         this.id = id;
     }
 
+    /**
+     * IPAllocation represents metadata about the pod/container owner of a specific IP
+     */
     @JsonProperty("ifname")
     public String getIfname() {
         return ifname;
     }
 
+    /**
+     * IPAllocation represents metadata about the pod/container owner of a specific IP
+     */
     @JsonProperty("ifname")
     public void setIfname(String ifname) {
         this.ifname = ifname;
     }
 
+    /**
+     * IPAllocation represents metadata about the pod/container owner of a specific IP
+     */
     @JsonProperty("podref")
     public String getPodref() {
         return podref;
     }
 
+    /**
+     * IPAllocation represents metadata about the pod/container owner of a specific IP
+     */
     @JsonProperty("podref")
     public void setPodref(String podref) {
         this.podref = podref;
diff --git a/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/NodeSlicePool.java b/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/NodeSlicePool.java
index aadde776cef..cff04ef5ff7 100644
--- a/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/NodeSlicePool.java
+++ b/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/NodeSlicePool.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NodeSlicePool is the Schema for the nodesliceippools API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class NodeSlicePool implements Editable<NodeSlicePoolBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "whereabouts.cni.cncf.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "NodeSlicePool";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public NodeSlicePool(String apiVersion, String kind, ObjectMeta metadata, NodeSl
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object.<br><p> Servers should convert recognized schemas to the latest internal value, and<br><p> may reject unrecognized values.<br><p> More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object.<br><p> Servers should convert recognized schemas to the latest internal value, and<br><p> may reject unrecognized values.<br><p> More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents.<br><p> Servers may infer this from the endpoint the client submits requests to.<br><p> Cannot be updated.<br><p> In CamelCase.<br><p> More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents.<br><p> Servers may infer this from the endpoint the client submits requests to.<br><p> Cannot be updated.<br><p> In CamelCase.<br><p> More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * NodeSlicePool is the Schema for the nodesliceippools API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * NodeSlicePool is the Schema for the nodesliceippools API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * NodeSlicePool is the Schema for the nodesliceippools API
+     */
     @JsonProperty("spec")
     public NodeSlicePoolSpec getSpec() {
         return spec;
     }
 
+    /**
+     * NodeSlicePool is the Schema for the nodesliceippools API
+     */
     @JsonProperty("spec")
     public void setSpec(NodeSlicePoolSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * NodeSlicePool is the Schema for the nodesliceippools API
+     */
     @JsonProperty("status")
     public NodeSlicePoolStatus getStatus() {
         return status;
     }
 
+    /**
+     * NodeSlicePool is the Schema for the nodesliceippools API
+     */
     @JsonProperty("status")
     public void setStatus(NodeSlicePoolStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/NodeSlicePoolList.java b/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/NodeSlicePoolList.java
index 25243d1152c..c6fe121aa74 100644
--- a/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/NodeSlicePoolList.java
+++ b/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/NodeSlicePoolList.java
@@ -78,17 +78,11 @@
 public class NodeSlicePoolList implements Editable<NodeSlicePoolListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.whereabouts.v1alpha1.NodeSlicePool>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "whereabouts.cni.cncf.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.whereabouts.v1alpha1.NodeSlicePool> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "NodeSlicePoolList";
     @JsonProperty("metadata")
@@ -110,17 +104,11 @@ public NodeSlicePoolList(String apiVersion, List<io.fabric8.openshift.api.model.
         this.metadata = metadata;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
@@ -137,17 +125,11 @@ public void setItems(List<io.fabric8.openshift.api.model.whereabouts.v1alpha1.No
         this.items = items;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/NodeSlicePoolSpec.java b/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/NodeSlicePoolSpec.java
index 543085512c3..a54ccea24b3 100644
--- a/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/NodeSlicePoolSpec.java
+++ b/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/NodeSlicePoolSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NodeSlicePoolSpec defines the desired state of NodeSlicePool
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public NodeSlicePoolSpec(String range, String sliceSize) {
         this.sliceSize = sliceSize;
     }
 
+    /**
+     * Range is a RFC 4632/4291-style string that represents an IP address and prefix length in CIDR notation<br><p> this refers to the entire range where the node is allocated a subset
+     */
     @JsonProperty("range")
     public String getRange() {
         return range;
     }
 
+    /**
+     * Range is a RFC 4632/4291-style string that represents an IP address and prefix length in CIDR notation<br><p> this refers to the entire range where the node is allocated a subset
+     */
     @JsonProperty("range")
     public void setRange(String range) {
         this.range = range;
     }
 
+    /**
+     * SliceSize is the size of subnets or slices of the range that each node will be assigned
+     */
     @JsonProperty("sliceSize")
     public String getSliceSize() {
         return sliceSize;
     }
 
+    /**
+     * SliceSize is the size of subnets or slices of the range that each node will be assigned
+     */
     @JsonProperty("sliceSize")
     public void setSliceSize(String sliceSize) {
         this.sliceSize = sliceSize;
diff --git a/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/NodeSlicePoolStatus.java b/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/NodeSlicePoolStatus.java
index 3debf72d978..95f227340d0 100644
--- a/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/NodeSlicePoolStatus.java
+++ b/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/NodeSlicePoolStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NodeSlicePoolStatus defines the desired state of NodeSlicePool
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public NodeSlicePoolStatus(List<NodeSlicePoolStatusAllocations> allocations) {
         this.allocations = allocations;
     }
 
+    /**
+     * Allocations holds the allocations of nodes to slices
+     */
     @JsonProperty("allocations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NodeSlicePoolStatusAllocations> getAllocations() {
         return allocations;
     }
 
+    /**
+     * Allocations holds the allocations of nodes to slices
+     */
     @JsonProperty("allocations")
     public void setAllocations(List<NodeSlicePoolStatusAllocations> allocations) {
         this.allocations = allocations;
diff --git a/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/NodeSlicePoolStatusAllocations.java b/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/NodeSlicePoolStatusAllocations.java
index 7147d3ceb1e..69e293ec855 100644
--- a/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/NodeSlicePoolStatusAllocations.java
+++ b/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/NodeSlicePoolStatusAllocations.java
@@ -82,21 +82,33 @@ public NodeSlicePoolStatusAllocations(String nodeName, String sliceRange) {
         this.sliceRange = sliceRange;
     }
 
+    /**
+     * NodeName is the name of the node assigned to this slice, empty node name is an available slice for assignment
+     */
     @JsonProperty("nodeName")
     public String getNodeName() {
         return nodeName;
     }
 
+    /**
+     * NodeName is the name of the node assigned to this slice, empty node name is an available slice for assignment
+     */
     @JsonProperty("nodeName")
     public void setNodeName(String nodeName) {
         this.nodeName = nodeName;
     }
 
+    /**
+     * SliceRange is the subnet of this slice
+     */
     @JsonProperty("sliceRange")
     public String getSliceRange() {
         return sliceRange;
     }
 
+    /**
+     * SliceRange is the subnet of this slice
+     */
     @JsonProperty("sliceRange")
     public void setSliceRange(String sliceRange) {
         this.sliceRange = sliceRange;
diff --git a/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/OverlappingRangeIPReservation.java b/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/OverlappingRangeIPReservation.java
index ea72dc03ae0..bd119ec497e 100644
--- a/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/OverlappingRangeIPReservation.java
+++ b/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/OverlappingRangeIPReservation.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OverlappingRangeIPReservation is the Schema for the OverlappingRangeIPReservations API
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class OverlappingRangeIPReservation implements Editable<OverlappingRangeIPReservationBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "whereabouts.cni.cncf.io/v1alpha1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OverlappingRangeIPReservation";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public OverlappingRangeIPReservation(String apiVersion, String kind, ObjectMeta
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object.<br><p> Servers should convert recognized schemas to the latest internal value, and<br><p> may reject unrecognized values.<br><p> More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object.<br><p> Servers should convert recognized schemas to the latest internal value, and<br><p> may reject unrecognized values.<br><p> More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents.<br><p> Servers may infer this from the endpoint the client submits requests to.<br><p> Cannot be updated.<br><p> In CamelCase.<br><p> More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents.<br><p> Servers may infer this from the endpoint the client submits requests to.<br><p> Cannot be updated.<br><p> In CamelCase.<br><p> More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OverlappingRangeIPReservation is the Schema for the OverlappingRangeIPReservations API
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OverlappingRangeIPReservation is the Schema for the OverlappingRangeIPReservations API
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * OverlappingRangeIPReservation is the Schema for the OverlappingRangeIPReservations API
+     */
     @JsonProperty("spec")
     public OverlappingRangeIPReservationSpec getSpec() {
         return spec;
     }
 
+    /**
+     * OverlappingRangeIPReservation is the Schema for the OverlappingRangeIPReservations API
+     */
     @JsonProperty("spec")
     public void setSpec(OverlappingRangeIPReservationSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/OverlappingRangeIPReservationList.java b/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/OverlappingRangeIPReservationList.java
index 49c85bd887c..f69169c060f 100644
--- a/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/OverlappingRangeIPReservationList.java
+++ b/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/OverlappingRangeIPReservationList.java
@@ -78,17 +78,11 @@
 public class OverlappingRangeIPReservationList implements Editable<OverlappingRangeIPReservationListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.whereabouts.v1alpha1.OverlappingRangeIPReservation>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "whereabouts.cni.cncf.io/v1alpha1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.whereabouts.v1alpha1.OverlappingRangeIPReservation> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OverlappingRangeIPReservationList";
     @JsonProperty("metadata")
@@ -110,17 +104,11 @@ public OverlappingRangeIPReservationList(String apiVersion, List<io.fabric8.open
         this.metadata = metadata;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
         return apiVersion;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
@@ -137,17 +125,11 @@ public void setItems(List<io.fabric8.openshift.api.model.whereabouts.v1alpha1.Ov
         this.items = items;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
diff --git a/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/OverlappingRangeIPReservationSpec.java b/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/OverlappingRangeIPReservationSpec.java
index 4bb2400440a..97242cc45f2 100644
--- a/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/OverlappingRangeIPReservationSpec.java
+++ b/kubernetes-model-generator/openshift-model-whereabouts/src/generated/java/io/fabric8/openshift/api/model/whereabouts/v1alpha1/OverlappingRangeIPReservationSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OverlappingRangeIPReservationSpec defines the desired state of OverlappingRangeIPReservation
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public OverlappingRangeIPReservationSpec(String containerid, String ifname, Stri
         this.podref = podref;
     }
 
+    /**
+     * OverlappingRangeIPReservationSpec defines the desired state of OverlappingRangeIPReservation
+     */
     @JsonProperty("containerid")
     public String getContainerid() {
         return containerid;
     }
 
+    /**
+     * OverlappingRangeIPReservationSpec defines the desired state of OverlappingRangeIPReservation
+     */
     @JsonProperty("containerid")
     public void setContainerid(String containerid) {
         this.containerid = containerid;
     }
 
+    /**
+     * OverlappingRangeIPReservationSpec defines the desired state of OverlappingRangeIPReservation
+     */
     @JsonProperty("ifname")
     public String getIfname() {
         return ifname;
     }
 
+    /**
+     * OverlappingRangeIPReservationSpec defines the desired state of OverlappingRangeIPReservation
+     */
     @JsonProperty("ifname")
     public void setIfname(String ifname) {
         this.ifname = ifname;
     }
 
+    /**
+     * OverlappingRangeIPReservationSpec defines the desired state of OverlappingRangeIPReservation
+     */
     @JsonProperty("podref")
     public String getPodref() {
         return podref;
     }
 
+    /**
+     * OverlappingRangeIPReservationSpec defines the desired state of OverlappingRangeIPReservation
+     */
     @JsonProperty("podref")
     public void setPodref(String podref) {
         this.podref = podref;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Action.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Action.java
index 6fbef6815da..2a2b7a6f03a 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Action.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Action.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Action describes a request to the API server
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -111,92 +114,146 @@ public Action(Object content, Boolean isNonResourceURL, String namespace, String
         this.verb = verb;
     }
 
+    /**
+     * Action describes a request to the API server
+     */
     @JsonProperty("content")
     public Object getContent() {
         return content;
     }
 
+    /**
+     * Action describes a request to the API server
+     */
     @JsonProperty("content")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setContent(Object content) {
         this.content = content;
     }
 
+    /**
+     * IsNonResourceURL is true if this is a request for a non-resource URL (outside of the resource hierarchy)
+     */
     @JsonProperty("isNonResourceURL")
     public Boolean getIsNonResourceURL() {
         return isNonResourceURL;
     }
 
+    /**
+     * IsNonResourceURL is true if this is a request for a non-resource URL (outside of the resource hierarchy)
+     */
     @JsonProperty("isNonResourceURL")
     public void setIsNonResourceURL(Boolean isNonResourceURL) {
         this.isNonResourceURL = isNonResourceURL;
     }
 
+    /**
+     * Namespace is the namespace of the action being requested.  Currently, there is no distinction between no namespace and all namespaces
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace of the action being requested.  Currently, there is no distinction between no namespace and all namespaces
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Path is the path of a non resource URL
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Path is the path of a non resource URL
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * Resource is one of the existing resource types
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * Resource is one of the existing resource types
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
     }
 
+    /**
+     * Group is the API group of the resource Serialized as resourceAPIGroup to avoid confusion with the 'groups' field when inlined
+     */
     @JsonProperty("resourceAPIGroup")
     public String getResourceAPIGroup() {
         return resourceAPIGroup;
     }
 
+    /**
+     * Group is the API group of the resource Serialized as resourceAPIGroup to avoid confusion with the 'groups' field when inlined
+     */
     @JsonProperty("resourceAPIGroup")
     public void setResourceAPIGroup(String resourceAPIGroup) {
         this.resourceAPIGroup = resourceAPIGroup;
     }
 
+    /**
+     * Version is the API version of the resource Serialized as resourceAPIVersion to avoid confusion with TypeMeta.apiVersion and ObjectMeta.resourceVersion when inlined
+     */
     @JsonProperty("resourceAPIVersion")
     public String getResourceAPIVersion() {
         return resourceAPIVersion;
     }
 
+    /**
+     * Version is the API version of the resource Serialized as resourceAPIVersion to avoid confusion with TypeMeta.apiVersion and ObjectMeta.resourceVersion when inlined
+     */
     @JsonProperty("resourceAPIVersion")
     public void setResourceAPIVersion(String resourceAPIVersion) {
         this.resourceAPIVersion = resourceAPIVersion;
     }
 
+    /**
+     * ResourceName is the name of the resource being requested for a "get" or deleted for a "delete"
+     */
     @JsonProperty("resourceName")
     public String getResourceName() {
         return resourceName;
     }
 
+    /**
+     * ResourceName is the name of the resource being requested for a "get" or deleted for a "delete"
+     */
     @JsonProperty("resourceName")
     public void setResourceName(String resourceName) {
         this.resourceName = resourceName;
     }
 
+    /**
+     * Verb is one of: get, list, watch, create, update, delete
+     */
     @JsonProperty("verb")
     public String getVerb() {
         return verb;
     }
 
+    /**
+     * Verb is one of: get, list, watch, create, update, delete
+     */
     @JsonProperty("verb")
     public void setVerb(String verb) {
         this.verb = verb;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/AllowedFlexVolume.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/AllowedFlexVolume.java
index 8140adae68b..de8f047a7ec 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/AllowedFlexVolume.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/AllowedFlexVolume.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AllowedFlexVolume represents a single Flexvolume that is allowed to be used.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public AllowedFlexVolume(String driver) {
         this.driver = driver;
     }
 
+    /**
+     * Driver is the name of the Flexvolume driver.
+     */
     @JsonProperty("driver")
     public String getDriver() {
         return driver;
     }
 
+    /**
+     * Driver is the name of the Flexvolume driver.
+     */
     @JsonProperty("driver")
     public void setDriver(String driver) {
         this.driver = driver;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/AppliedClusterResourceQuota.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/AppliedClusterResourceQuota.java
index e8cee34c351..38ce6249cbb 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/AppliedClusterResourceQuota.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/AppliedClusterResourceQuota.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AppliedClusterResourceQuota mirrors ClusterResourceQuota at a project scope, for projection into a project.  It allows a project-admin to know which ClusterResourceQuotas are applied to his project and their associated usage.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class AppliedClusterResourceQuota implements Editable<AppliedClusterResourceQuotaBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "quota.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AppliedClusterResourceQuota";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public AppliedClusterResourceQuota(String apiVersion, String kind, ObjectMeta me
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AppliedClusterResourceQuota mirrors ClusterResourceQuota at a project scope, for projection into a project.  It allows a project-admin to know which ClusterResourceQuotas are applied to his project and their associated usage.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AppliedClusterResourceQuota mirrors ClusterResourceQuota at a project scope, for projection into a project.  It allows a project-admin to know which ClusterResourceQuotas are applied to his project and their associated usage.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * AppliedClusterResourceQuota mirrors ClusterResourceQuota at a project scope, for projection into a project.  It allows a project-admin to know which ClusterResourceQuotas are applied to his project and their associated usage.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ClusterResourceQuotaSpec getSpec() {
         return spec;
     }
 
+    /**
+     * AppliedClusterResourceQuota mirrors ClusterResourceQuota at a project scope, for projection into a project.  It allows a project-admin to know which ClusterResourceQuotas are applied to his project and their associated usage.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ClusterResourceQuotaSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * AppliedClusterResourceQuota mirrors ClusterResourceQuota at a project scope, for projection into a project.  It allows a project-admin to know which ClusterResourceQuotas are applied to his project and their associated usage.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public ClusterResourceQuotaStatus getStatus() {
         return status;
     }
 
+    /**
+     * AppliedClusterResourceQuota mirrors ClusterResourceQuota at a project scope, for projection into a project.  It allows a project-admin to know which ClusterResourceQuotas are applied to his project and their associated usage.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(ClusterResourceQuotaStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/AppliedClusterResourceQuotaList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/AppliedClusterResourceQuotaList.java
index 714456e98f6..266b17868c8 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/AppliedClusterResourceQuotaList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/AppliedClusterResourceQuotaList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * AppliedClusterResourceQuotaList is a collection of AppliedClusterResourceQuotas<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class AppliedClusterResourceQuotaList implements Editable<AppliedClusterResourceQuotaListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.AppliedClusterResourceQuota>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "quota.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.AppliedClusterResourceQuota> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "AppliedClusterResourceQuotaList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public AppliedClusterResourceQuotaList(String apiVersion, List<io.fabric8.opensh
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of AppliedClusterResourceQuota
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.AppliedClusterResourceQuota> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of AppliedClusterResourceQuota
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.AppliedClusterResourceQuota> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * AppliedClusterResourceQuotaList is a collection of AppliedClusterResourceQuotas<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * AppliedClusterResourceQuotaList is a collection of AppliedClusterResourceQuotas<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BinaryBuildSource.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BinaryBuildSource.java
index 07464960477..1f58319acab 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BinaryBuildSource.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BinaryBuildSource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BinaryBuildSource describes a binary file to be used for the Docker and Source build strategies, where the file will be extracted and used as the build source.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public BinaryBuildSource(String asFile) {
         this.asFile = asFile;
     }
 
+    /**
+     * asFile indicates that the provided binary input should be considered a single file within the build input. For example, specifying "webapp.war" would place the provided binary as `/webapp.war` for the builder. If left empty, the Docker and Source build strategies assume this file is a zip, tar, or tar.gz file and extract it as the source. The custom strategy receives this binary as standard input. This filename may not contain slashes or be '..' or '.'.
+     */
     @JsonProperty("asFile")
     public String getAsFile() {
         return asFile;
     }
 
+    /**
+     * asFile indicates that the provided binary input should be considered a single file within the build input. For example, specifying "webapp.war" would place the provided binary as `/webapp.war` for the builder. If left empty, the Docker and Source build strategies assume this file is a zip, tar, or tar.gz file and extract it as the source. The custom strategy receives this binary as standard input. This filename may not contain slashes or be '..' or '.'.
+     */
     @JsonProperty("asFile")
     public void setAsFile(String asFile) {
         this.asFile = asFile;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BitbucketWebHookCause.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BitbucketWebHookCause.java
index fba13e76d29..ee77e4df8d2 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BitbucketWebHookCause.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BitbucketWebHookCause.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BitbucketWebHookCause has information about a Bitbucket webhook that triggered a build.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public BitbucketWebHookCause(SourceRevision revision, String secret) {
         this.secret = secret;
     }
 
+    /**
+     * BitbucketWebHookCause has information about a Bitbucket webhook that triggered a build.
+     */
     @JsonProperty("revision")
     public SourceRevision getRevision() {
         return revision;
     }
 
+    /**
+     * BitbucketWebHookCause has information about a Bitbucket webhook that triggered a build.
+     */
     @JsonProperty("revision")
     public void setRevision(SourceRevision revision) {
         this.revision = revision;
     }
 
+    /**
+     * Secret is the obfuscated webhook secret that triggered a build.
+     */
     @JsonProperty("secret")
     public String getSecret() {
         return secret;
     }
 
+    /**
+     * Secret is the obfuscated webhook secret that triggered a build.
+     */
     @JsonProperty("secret")
     public void setSecret(String secret) {
         this.secret = secret;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BrokerTemplateInstance.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BrokerTemplateInstance.java
index 191008561a3..394b15be3e2 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BrokerTemplateInstance.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BrokerTemplateInstance.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BrokerTemplateInstance holds the service broker-related state associated with a TemplateInstance.  BrokerTemplateInstance is part of an experimental API.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -74,14 +77,8 @@
 public class BrokerTemplateInstance implements Editable<BrokerTemplateInstanceBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "template.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "BrokerTemplateInstance";
     @JsonProperty("metadata")
@@ -106,7 +103,7 @@ public BrokerTemplateInstance(String apiVersion, String kind, ObjectMeta metadat
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -114,7 +111,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -122,7 +119,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -130,28 +127,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * BrokerTemplateInstance holds the service broker-related state associated with a TemplateInstance.  BrokerTemplateInstance is part of an experimental API.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * BrokerTemplateInstance holds the service broker-related state associated with a TemplateInstance.  BrokerTemplateInstance is part of an experimental API.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * BrokerTemplateInstance holds the service broker-related state associated with a TemplateInstance.  BrokerTemplateInstance is part of an experimental API.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public BrokerTemplateInstanceSpec getSpec() {
         return spec;
     }
 
+    /**
+     * BrokerTemplateInstance holds the service broker-related state associated with a TemplateInstance.  BrokerTemplateInstance is part of an experimental API.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(BrokerTemplateInstanceSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BrokerTemplateInstanceList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BrokerTemplateInstanceList.java
index 72ebd3e2b7b..b5911798f14 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BrokerTemplateInstanceList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BrokerTemplateInstanceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BrokerTemplateInstanceList is a list of BrokerTemplateInstance objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class BrokerTemplateInstanceList implements Editable<BrokerTemplateInstanceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.BrokerTemplateInstance>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "template.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.BrokerTemplateInstance> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "BrokerTemplateInstanceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public BrokerTemplateInstanceList(String apiVersion, List<io.fabric8.openshift.a
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is a list of BrokerTemplateInstances
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.BrokerTemplateInstance> getItems() {
         return items;
     }
 
+    /**
+     * items is a list of BrokerTemplateInstances
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.BrokerTemplateInstance> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * BrokerTemplateInstanceList is a list of BrokerTemplateInstance objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * BrokerTemplateInstanceList is a list of BrokerTemplateInstance objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BrokerTemplateInstanceSpec.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BrokerTemplateInstanceSpec.java
index 20dc65f7eef..a8023354d0f 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BrokerTemplateInstanceSpec.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BrokerTemplateInstanceSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BrokerTemplateInstanceSpec describes the state of a BrokerTemplateInstance.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public BrokerTemplateInstanceSpec(List<String> bindingIDs, ObjectReference secre
         this.templateInstance = templateInstance;
     }
 
+    /**
+     * bindingids is a list of 'binding_id's provided during successive bind calls to the template service broker.
+     */
     @JsonProperty("bindingIDs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getBindingIDs() {
         return bindingIDs;
     }
 
+    /**
+     * bindingids is a list of 'binding_id's provided during successive bind calls to the template service broker.
+     */
     @JsonProperty("bindingIDs")
     public void setBindingIDs(List<String> bindingIDs) {
         this.bindingIDs = bindingIDs;
     }
 
+    /**
+     * BrokerTemplateInstanceSpec describes the state of a BrokerTemplateInstance.
+     */
     @JsonProperty("secret")
     public ObjectReference getSecret() {
         return secret;
     }
 
+    /**
+     * BrokerTemplateInstanceSpec describes the state of a BrokerTemplateInstance.
+     */
     @JsonProperty("secret")
     public void setSecret(ObjectReference secret) {
         this.secret = secret;
     }
 
+    /**
+     * BrokerTemplateInstanceSpec describes the state of a BrokerTemplateInstance.
+     */
     @JsonProperty("templateInstance")
     public ObjectReference getTemplateInstance() {
         return templateInstance;
     }
 
+    /**
+     * BrokerTemplateInstanceSpec describes the state of a BrokerTemplateInstance.
+     */
     @JsonProperty("templateInstance")
     public void setTemplateInstance(ObjectReference templateInstance) {
         this.templateInstance = templateInstance;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Build.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Build.java
index b06884c43bd..a81f22da95f 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Build.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Build.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Build encapsulates the inputs needed to produce a new deployable image, as well as the status of the execution and a reference to the Pod which executed the build.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Build implements Editable<BuildBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "build.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Build";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Build(String apiVersion, String kind, ObjectMeta metadata, BuildSpec spec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Build encapsulates the inputs needed to produce a new deployable image, as well as the status of the execution and a reference to the Pod which executed the build.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Build encapsulates the inputs needed to produce a new deployable image, as well as the status of the execution and a reference to the Pod which executed the build.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Build encapsulates the inputs needed to produce a new deployable image, as well as the status of the execution and a reference to the Pod which executed the build.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public BuildSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Build encapsulates the inputs needed to produce a new deployable image, as well as the status of the execution and a reference to the Pod which executed the build.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(BuildSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Build encapsulates the inputs needed to produce a new deployable image, as well as the status of the execution and a reference to the Pod which executed the build.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public BuildStatus getStatus() {
         return status;
     }
 
+    /**
+     * Build encapsulates the inputs needed to produce a new deployable image, as well as the status of the execution and a reference to the Pod which executed the build.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(BuildStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildCondition.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildCondition.java
index 50915101a12..8c53b0a4e77 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildCondition.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BuildCondition describes the state of a build at a certain point.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public BuildCondition(String lastTransitionTime, String lastUpdateTime, String m
         this.type = type;
     }
 
+    /**
+     * BuildCondition describes the state of a build at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * BuildCondition describes the state of a build at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * BuildCondition describes the state of a build at a certain point.
+     */
     @JsonProperty("lastUpdateTime")
     public String getLastUpdateTime() {
         return lastUpdateTime;
     }
 
+    /**
+     * BuildCondition describes the state of a build at a certain point.
+     */
     @JsonProperty("lastUpdateTime")
     public void setLastUpdateTime(String lastUpdateTime) {
         this.lastUpdateTime = lastUpdateTime;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type of build condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of build condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildConfig.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildConfig.java
index 90dc9c657b0..4dbbedc4368 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildConfig.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildConfig.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Build configurations define a build process for new container images. There are three types of builds possible - a container image build using a Dockerfile, a Source-to-Image build that uses a specially prepared base image that accepts source code that it can make runnable, and a custom build that can run // arbitrary container images as a base and accept the build parameters. Builds run on the cluster and on completion are pushed to the container image registry specified in the "output" section. A build can be triggered via a webhook, when the base image changes, or when a user manually requests a new build be // created.<br><p> <br><p> Each build created by a build configuration is numbered and refers back to its parent configuration. Multiple builds can be triggered at once. Builds that do not have "output" set can be used to test code or run a verification build.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class BuildConfig implements Editable<BuildConfigBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "build.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "BuildConfig";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public BuildConfig(String apiVersion, String kind, ObjectMeta metadata, BuildCon
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Build configurations define a build process for new container images. There are three types of builds possible - a container image build using a Dockerfile, a Source-to-Image build that uses a specially prepared base image that accepts source code that it can make runnable, and a custom build that can run // arbitrary container images as a base and accept the build parameters. Builds run on the cluster and on completion are pushed to the container image registry specified in the "output" section. A build can be triggered via a webhook, when the base image changes, or when a user manually requests a new build be // created.<br><p> <br><p> Each build created by a build configuration is numbered and refers back to its parent configuration. Multiple builds can be triggered at once. Builds that do not have "output" set can be used to test code or run a verification build.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Build configurations define a build process for new container images. There are three types of builds possible - a container image build using a Dockerfile, a Source-to-Image build that uses a specially prepared base image that accepts source code that it can make runnable, and a custom build that can run // arbitrary container images as a base and accept the build parameters. Builds run on the cluster and on completion are pushed to the container image registry specified in the "output" section. A build can be triggered via a webhook, when the base image changes, or when a user manually requests a new build be // created.<br><p> <br><p> Each build created by a build configuration is numbered and refers back to its parent configuration. Multiple builds can be triggered at once. Builds that do not have "output" set can be used to test code or run a verification build.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Build configurations define a build process for new container images. There are three types of builds possible - a container image build using a Dockerfile, a Source-to-Image build that uses a specially prepared base image that accepts source code that it can make runnable, and a custom build that can run // arbitrary container images as a base and accept the build parameters. Builds run on the cluster and on completion are pushed to the container image registry specified in the "output" section. A build can be triggered via a webhook, when the base image changes, or when a user manually requests a new build be // created.<br><p> <br><p> Each build created by a build configuration is numbered and refers back to its parent configuration. Multiple builds can be triggered at once. Builds that do not have "output" set can be used to test code or run a verification build.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public BuildConfigSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Build configurations define a build process for new container images. There are three types of builds possible - a container image build using a Dockerfile, a Source-to-Image build that uses a specially prepared base image that accepts source code that it can make runnable, and a custom build that can run // arbitrary container images as a base and accept the build parameters. Builds run on the cluster and on completion are pushed to the container image registry specified in the "output" section. A build can be triggered via a webhook, when the base image changes, or when a user manually requests a new build be // created.<br><p> <br><p> Each build created by a build configuration is numbered and refers back to its parent configuration. Multiple builds can be triggered at once. Builds that do not have "output" set can be used to test code or run a verification build.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(BuildConfigSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Build configurations define a build process for new container images. There are three types of builds possible - a container image build using a Dockerfile, a Source-to-Image build that uses a specially prepared base image that accepts source code that it can make runnable, and a custom build that can run // arbitrary container images as a base and accept the build parameters. Builds run on the cluster and on completion are pushed to the container image registry specified in the "output" section. A build can be triggered via a webhook, when the base image changes, or when a user manually requests a new build be // created.<br><p> <br><p> Each build created by a build configuration is numbered and refers back to its parent configuration. Multiple builds can be triggered at once. Builds that do not have "output" set can be used to test code or run a verification build.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public BuildConfigStatus getStatus() {
         return status;
     }
 
+    /**
+     * Build configurations define a build process for new container images. There are three types of builds possible - a container image build using a Dockerfile, a Source-to-Image build that uses a specially prepared base image that accepts source code that it can make runnable, and a custom build that can run // arbitrary container images as a base and accept the build parameters. Builds run on the cluster and on completion are pushed to the container image registry specified in the "output" section. A build can be triggered via a webhook, when the base image changes, or when a user manually requests a new build be // created.<br><p> <br><p> Each build created by a build configuration is numbered and refers back to its parent configuration. Multiple builds can be triggered at once. Builds that do not have "output" set can be used to test code or run a verification build.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(BuildConfigStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildConfigList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildConfigList.java
index 9412ea3aa35..3df909ed025 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildConfigList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildConfigList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BuildConfigList is a collection of BuildConfigs.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class BuildConfigList implements Editable<BuildConfigListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.BuildConfig>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "build.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.BuildConfig> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "BuildConfigList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public BuildConfigList(String apiVersion, List<io.fabric8.openshift.api.model.Bu
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is a list of build configs
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.BuildConfig> getItems() {
         return items;
     }
 
+    /**
+     * items is a list of build configs
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.BuildConfig> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * BuildConfigList is a collection of BuildConfigs.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * BuildConfigList is a collection of BuildConfigs.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildConfigSpec.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildConfigSpec.java
index 07872537f44..a379be46f2e 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildConfigSpec.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildConfigSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BuildConfigSpec describes when and how builds are created
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -134,143 +137,227 @@ public BuildConfigSpec(Long completionDeadlineSeconds, Integer failedBuildsHisto
         this.triggers = triggers;
     }
 
+    /**
+     * completionDeadlineSeconds is an optional duration in seconds, counted from the time when a build pod gets scheduled in the system, that the build may be active on a node before the system actively tries to terminate the build; value must be positive integer
+     */
     @JsonProperty("completionDeadlineSeconds")
     public Long getCompletionDeadlineSeconds() {
         return completionDeadlineSeconds;
     }
 
+    /**
+     * completionDeadlineSeconds is an optional duration in seconds, counted from the time when a build pod gets scheduled in the system, that the build may be active on a node before the system actively tries to terminate the build; value must be positive integer
+     */
     @JsonProperty("completionDeadlineSeconds")
     public void setCompletionDeadlineSeconds(Long completionDeadlineSeconds) {
         this.completionDeadlineSeconds = completionDeadlineSeconds;
     }
 
+    /**
+     * failedBuildsHistoryLimit is the number of old failed builds to retain. When a BuildConfig is created, the 5 most recent failed builds are retained unless this value is set. If removed after the BuildConfig has been created, all failed builds are retained.
+     */
     @JsonProperty("failedBuildsHistoryLimit")
     public Integer getFailedBuildsHistoryLimit() {
         return failedBuildsHistoryLimit;
     }
 
+    /**
+     * failedBuildsHistoryLimit is the number of old failed builds to retain. When a BuildConfig is created, the 5 most recent failed builds are retained unless this value is set. If removed after the BuildConfig has been created, all failed builds are retained.
+     */
     @JsonProperty("failedBuildsHistoryLimit")
     public void setFailedBuildsHistoryLimit(Integer failedBuildsHistoryLimit) {
         this.failedBuildsHistoryLimit = failedBuildsHistoryLimit;
     }
 
+    /**
+     * mountTrustedCA bind mounts the cluster's trusted certificate authorities, as defined in the cluster's proxy configuration, into the build. This lets processes within a build trust components signed by custom PKI certificate authorities, such as private artifact repositories and HTTPS proxies.<br><p> <br><p> When this field is set to true, the contents of `/etc/pki/ca-trust` within the build are managed by the build container, and any changes to this directory or its subdirectories (for example - within a Dockerfile `RUN` instruction) are not persisted in the build's output image.
+     */
     @JsonProperty("mountTrustedCA")
     public Boolean getMountTrustedCA() {
         return mountTrustedCA;
     }
 
+    /**
+     * mountTrustedCA bind mounts the cluster's trusted certificate authorities, as defined in the cluster's proxy configuration, into the build. This lets processes within a build trust components signed by custom PKI certificate authorities, such as private artifact repositories and HTTPS proxies.<br><p> <br><p> When this field is set to true, the contents of `/etc/pki/ca-trust` within the build are managed by the build container, and any changes to this directory or its subdirectories (for example - within a Dockerfile `RUN` instruction) are not persisted in the build's output image.
+     */
     @JsonProperty("mountTrustedCA")
     public void setMountTrustedCA(Boolean mountTrustedCA) {
         this.mountTrustedCA = mountTrustedCA;
     }
 
+    /**
+     * nodeSelector is a selector which must be true for the build pod to fit on a node If nil, it can be overridden by default build nodeselector values for the cluster. If set to an empty map or a map with any values, default build nodeselector values are ignored.
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * nodeSelector is a selector which must be true for the build pod to fit on a node If nil, it can be overridden by default build nodeselector values for the cluster. If set to an empty map or a map with any values, default build nodeselector values are ignored.
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * BuildConfigSpec describes when and how builds are created
+     */
     @JsonProperty("output")
     public BuildOutput getOutput() {
         return output;
     }
 
+    /**
+     * BuildConfigSpec describes when and how builds are created
+     */
     @JsonProperty("output")
     public void setOutput(BuildOutput output) {
         this.output = output;
     }
 
+    /**
+     * BuildConfigSpec describes when and how builds are created
+     */
     @JsonProperty("postCommit")
     public BuildPostCommitSpec getPostCommit() {
         return postCommit;
     }
 
+    /**
+     * BuildConfigSpec describes when and how builds are created
+     */
     @JsonProperty("postCommit")
     public void setPostCommit(BuildPostCommitSpec postCommit) {
         this.postCommit = postCommit;
     }
 
+    /**
+     * BuildConfigSpec describes when and how builds are created
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * BuildConfigSpec describes when and how builds are created
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * BuildConfigSpec describes when and how builds are created
+     */
     @JsonProperty("revision")
     public SourceRevision getRevision() {
         return revision;
     }
 
+    /**
+     * BuildConfigSpec describes when and how builds are created
+     */
     @JsonProperty("revision")
     public void setRevision(SourceRevision revision) {
         this.revision = revision;
     }
 
+    /**
+     * RunPolicy describes how the new build created from this build configuration will be scheduled for execution. This is optional, if not specified we default to "Serial".
+     */
     @JsonProperty("runPolicy")
     public String getRunPolicy() {
         return runPolicy;
     }
 
+    /**
+     * RunPolicy describes how the new build created from this build configuration will be scheduled for execution. This is optional, if not specified we default to "Serial".
+     */
     @JsonProperty("runPolicy")
     public void setRunPolicy(String runPolicy) {
         this.runPolicy = runPolicy;
     }
 
+    /**
+     * serviceAccount is the name of the ServiceAccount to use to run the pod created by this build. The pod will be allowed to use secrets referenced by the ServiceAccount
+     */
     @JsonProperty("serviceAccount")
     public String getServiceAccount() {
         return serviceAccount;
     }
 
+    /**
+     * serviceAccount is the name of the ServiceAccount to use to run the pod created by this build. The pod will be allowed to use secrets referenced by the ServiceAccount
+     */
     @JsonProperty("serviceAccount")
     public void setServiceAccount(String serviceAccount) {
         this.serviceAccount = serviceAccount;
     }
 
+    /**
+     * BuildConfigSpec describes when and how builds are created
+     */
     @JsonProperty("source")
     public BuildSource getSource() {
         return source;
     }
 
+    /**
+     * BuildConfigSpec describes when and how builds are created
+     */
     @JsonProperty("source")
     public void setSource(BuildSource source) {
         this.source = source;
     }
 
+    /**
+     * BuildConfigSpec describes when and how builds are created
+     */
     @JsonProperty("strategy")
     public BuildStrategy getStrategy() {
         return strategy;
     }
 
+    /**
+     * BuildConfigSpec describes when and how builds are created
+     */
     @JsonProperty("strategy")
     public void setStrategy(BuildStrategy strategy) {
         this.strategy = strategy;
     }
 
+    /**
+     * successfulBuildsHistoryLimit is the number of old successful builds to retain. When a BuildConfig is created, the 5 most recent successful builds are retained unless this value is set. If removed after the BuildConfig has been created, all successful builds are retained.
+     */
     @JsonProperty("successfulBuildsHistoryLimit")
     public Integer getSuccessfulBuildsHistoryLimit() {
         return successfulBuildsHistoryLimit;
     }
 
+    /**
+     * successfulBuildsHistoryLimit is the number of old successful builds to retain. When a BuildConfig is created, the 5 most recent successful builds are retained unless this value is set. If removed after the BuildConfig has been created, all successful builds are retained.
+     */
     @JsonProperty("successfulBuildsHistoryLimit")
     public void setSuccessfulBuildsHistoryLimit(Integer successfulBuildsHistoryLimit) {
         this.successfulBuildsHistoryLimit = successfulBuildsHistoryLimit;
     }
 
+    /**
+     * triggers determine how new Builds can be launched from a BuildConfig. If no triggers are defined, a new build can only occur as a result of an explicit client build creation.
+     */
     @JsonProperty("triggers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<BuildTriggerPolicy> getTriggers() {
         return triggers;
     }
 
+    /**
+     * triggers determine how new Builds can be launched from a BuildConfig. If no triggers are defined, a new build can only occur as a result of an explicit client build creation.
+     */
     @JsonProperty("triggers")
     public void setTriggers(List<BuildTriggerPolicy> triggers) {
         this.triggers = triggers;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildConfigStatus.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildConfigStatus.java
index 042aa3c00ef..073857c12bf 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildConfigStatus.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildConfigStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BuildConfigStatus contains current state of the build config object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public BuildConfigStatus(List<ImageChangeTriggerStatus> imageChangeTriggers, Lon
         this.lastVersion = lastVersion;
     }
 
+    /**
+     * ImageChangeTriggers captures the runtime state of any ImageChangeTrigger specified in the BuildConfigSpec, including the value reconciled by the OpenShift APIServer for the lastTriggeredImageID. There is a single entry in this array for each image change trigger in spec. Each trigger status references the ImageStreamTag that acts as the source of the trigger.
+     */
     @JsonProperty("imageChangeTriggers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ImageChangeTriggerStatus> getImageChangeTriggers() {
         return imageChangeTriggers;
     }
 
+    /**
+     * ImageChangeTriggers captures the runtime state of any ImageChangeTrigger specified in the BuildConfigSpec, including the value reconciled by the OpenShift APIServer for the lastTriggeredImageID. There is a single entry in this array for each image change trigger in spec. Each trigger status references the ImageStreamTag that acts as the source of the trigger.
+     */
     @JsonProperty("imageChangeTriggers")
     public void setImageChangeTriggers(List<ImageChangeTriggerStatus> imageChangeTriggers) {
         this.imageChangeTriggers = imageChangeTriggers;
     }
 
+    /**
+     * lastVersion is used to inform about number of last triggered build.
+     */
     @JsonProperty("lastVersion")
     public Long getLastVersion() {
         return lastVersion;
     }
 
+    /**
+     * lastVersion is used to inform about number of last triggered build.
+     */
     @JsonProperty("lastVersion")
     public void setLastVersion(Long lastVersion) {
         this.lastVersion = lastVersion;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildList.java
index 1312e030d19..346ff0b5c6b 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BuildList is a collection of Builds.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class BuildList implements Editable<BuildListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.Build>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "build.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.Build> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "BuildList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public BuildList(String apiVersion, List<io.fabric8.openshift.api.model.Build> i
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is a list of builds
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.Build> getItems() {
         return items;
     }
 
+    /**
+     * items is a list of builds
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.Build> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * BuildList is a collection of Builds.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * BuildList is a collection of Builds.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildLog.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildLog.java
index c001f786edc..594d33ca702 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildLog.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildLog.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BuildLog is the (unused) resource associated with the build log redirector<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -73,14 +76,8 @@
 public class BuildLog implements Editable<BuildLogBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "build.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "BuildLog";
     @JsonIgnore
@@ -99,7 +96,7 @@ public BuildLog(String apiVersion, String kind) {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -107,7 +104,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -115,7 +112,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -123,7 +120,7 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildLogOptions.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildLogOptions.java
index a83355da7cb..9564f73ff92 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildLogOptions.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildLogOptions.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BuildLogOptions is the REST options for a build log<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -84,9 +87,6 @@
 public class BuildLogOptions implements Editable<BuildLogOptionsBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "build.openshift.io/v1";
     @JsonProperty("container")
@@ -95,9 +95,6 @@ public class BuildLogOptions implements Editable<BuildLogOptionsBuilder>, Kubern
     private Boolean follow;
     @JsonProperty("insecureSkipTLSVerifyBackend")
     private Boolean insecureSkipTLSVerifyBackend;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "BuildLogOptions";
     @JsonProperty("limitBytes")
@@ -143,7 +140,7 @@ public BuildLogOptions(String apiVersion, String container, Boolean follow, Bool
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -151,45 +148,63 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * cointainer for which to stream logs. Defaults to only container if there is one container in the pod.
+     */
     @JsonProperty("container")
     public String getContainer() {
         return container;
     }
 
+    /**
+     * cointainer for which to stream logs. Defaults to only container if there is one container in the pod.
+     */
     @JsonProperty("container")
     public void setContainer(String container) {
         this.container = container;
     }
 
+    /**
+     * follow if true indicates that the build log should be streamed until the build terminates.
+     */
     @JsonProperty("follow")
     public Boolean getFollow() {
         return follow;
     }
 
+    /**
+     * follow if true indicates that the build log should be streamed until the build terminates.
+     */
     @JsonProperty("follow")
     public void setFollow(Boolean follow) {
         this.follow = follow;
     }
 
+    /**
+     * insecureSkipTLSVerifyBackend indicates that the apiserver should not confirm the validity of the serving certificate of the backend it is connecting to.  This will make the HTTPS connection between the apiserver and the backend insecure. This means the apiserver cannot verify the log data it is receiving came from the real kubelet.  If the kubelet is configured to verify the apiserver's TLS credentials, it does not mean the connection to the real kubelet is vulnerable to a man in the middle attack (e.g. an attacker could not intercept the actual log data coming from the real kubelet).
+     */
     @JsonProperty("insecureSkipTLSVerifyBackend")
     public Boolean getInsecureSkipTLSVerifyBackend() {
         return insecureSkipTLSVerifyBackend;
     }
 
+    /**
+     * insecureSkipTLSVerifyBackend indicates that the apiserver should not confirm the validity of the serving certificate of the backend it is connecting to.  This will make the HTTPS connection between the apiserver and the backend insecure. This means the apiserver cannot verify the log data it is receiving came from the real kubelet.  If the kubelet is configured to verify the apiserver's TLS credentials, it does not mean the connection to the real kubelet is vulnerable to a man in the middle attack (e.g. an attacker could not intercept the actual log data coming from the real kubelet).
+     */
     @JsonProperty("insecureSkipTLSVerifyBackend")
     public void setInsecureSkipTLSVerifyBackend(Boolean insecureSkipTLSVerifyBackend) {
         this.insecureSkipTLSVerifyBackend = insecureSkipTLSVerifyBackend;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -197,88 +212,136 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * limitBytes, If set, is the number of bytes to read from the server before terminating the log output. This may not display a complete final line of logging, and may return slightly more or slightly less than the specified limit.
+     */
     @JsonProperty("limitBytes")
     public Long getLimitBytes() {
         return limitBytes;
     }
 
+    /**
+     * limitBytes, If set, is the number of bytes to read from the server before terminating the log output. This may not display a complete final line of logging, and may return slightly more or slightly less than the specified limit.
+     */
     @JsonProperty("limitBytes")
     public void setLimitBytes(Long limitBytes) {
         this.limitBytes = limitBytes;
     }
 
+    /**
+     * noWait if true causes the call to return immediately even if the build is not available yet. Otherwise the server will wait until the build has started.
+     */
     @JsonProperty("nowait")
     public Boolean getNowait() {
         return nowait;
     }
 
+    /**
+     * noWait if true causes the call to return immediately even if the build is not available yet. Otherwise the server will wait until the build has started.
+     */
     @JsonProperty("nowait")
     public void setNowait(Boolean nowait) {
         this.nowait = nowait;
     }
 
+    /**
+     * previous returns previous build logs. Defaults to false.
+     */
     @JsonProperty("previous")
     public Boolean getPrevious() {
         return previous;
     }
 
+    /**
+     * previous returns previous build logs. Defaults to false.
+     */
     @JsonProperty("previous")
     public void setPrevious(Boolean previous) {
         this.previous = previous;
     }
 
+    /**
+     * sinceSeconds is a relative time in seconds before the current time from which to show logs. If this value precedes the time a pod was started, only logs since the pod start will be returned. If this value is in the future, no logs will be returned. Only one of sinceSeconds or sinceTime may be specified.
+     */
     @JsonProperty("sinceSeconds")
     public Long getSinceSeconds() {
         return sinceSeconds;
     }
 
+    /**
+     * sinceSeconds is a relative time in seconds before the current time from which to show logs. If this value precedes the time a pod was started, only logs since the pod start will be returned. If this value is in the future, no logs will be returned. Only one of sinceSeconds or sinceTime may be specified.
+     */
     @JsonProperty("sinceSeconds")
     public void setSinceSeconds(Long sinceSeconds) {
         this.sinceSeconds = sinceSeconds;
     }
 
+    /**
+     * BuildLogOptions is the REST options for a build log<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("sinceTime")
     public String getSinceTime() {
         return sinceTime;
     }
 
+    /**
+     * BuildLogOptions is the REST options for a build log<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("sinceTime")
     public void setSinceTime(String sinceTime) {
         this.sinceTime = sinceTime;
     }
 
+    /**
+     * tailLines, If set, is the number of lines from the end of the logs to show. If not specified, logs are shown from the creation of the container or sinceSeconds or sinceTime
+     */
     @JsonProperty("tailLines")
     public Long getTailLines() {
         return tailLines;
     }
 
+    /**
+     * tailLines, If set, is the number of lines from the end of the logs to show. If not specified, logs are shown from the creation of the container or sinceSeconds or sinceTime
+     */
     @JsonProperty("tailLines")
     public void setTailLines(Long tailLines) {
         this.tailLines = tailLines;
     }
 
+    /**
+     * timestamps, If true, add an RFC3339 or RFC3339Nano timestamp at the beginning of every line of log output. Defaults to false.
+     */
     @JsonProperty("timestamps")
     public Boolean getTimestamps() {
         return timestamps;
     }
 
+    /**
+     * timestamps, If true, add an RFC3339 or RFC3339Nano timestamp at the beginning of every line of log output. Defaults to false.
+     */
     @JsonProperty("timestamps")
     public void setTimestamps(Boolean timestamps) {
         this.timestamps = timestamps;
     }
 
+    /**
+     * version of the build for which to view logs.
+     */
     @JsonProperty("version")
     public Long getVersion() {
         return version;
     }
 
+    /**
+     * version of the build for which to view logs.
+     */
     @JsonProperty("version")
     public void setVersion(Long version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildOutput.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildOutput.java
index 0832734186d..80d21af094f 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildOutput.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildOutput.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BuildOutput is input to a build strategy and describes the container image that the strategy should produce.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public BuildOutput(List<ImageLabel> imageLabels, LocalObjectReference pushSecret
         this.to = to;
     }
 
+    /**
+     * imageLabels define a list of labels that are applied to the resulting image. If there are multiple labels with the same name then the last one in the list is used.
+     */
     @JsonProperty("imageLabels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ImageLabel> getImageLabels() {
         return imageLabels;
     }
 
+    /**
+     * imageLabels define a list of labels that are applied to the resulting image. If there are multiple labels with the same name then the last one in the list is used.
+     */
     @JsonProperty("imageLabels")
     public void setImageLabels(List<ImageLabel> imageLabels) {
         this.imageLabels = imageLabels;
     }
 
+    /**
+     * BuildOutput is input to a build strategy and describes the container image that the strategy should produce.
+     */
     @JsonProperty("pushSecret")
     public LocalObjectReference getPushSecret() {
         return pushSecret;
     }
 
+    /**
+     * BuildOutput is input to a build strategy and describes the container image that the strategy should produce.
+     */
     @JsonProperty("pushSecret")
     public void setPushSecret(LocalObjectReference pushSecret) {
         this.pushSecret = pushSecret;
     }
 
+    /**
+     * BuildOutput is input to a build strategy and describes the container image that the strategy should produce.
+     */
     @JsonProperty("to")
     public ObjectReference getTo() {
         return to;
     }
 
+    /**
+     * BuildOutput is input to a build strategy and describes the container image that the strategy should produce.
+     */
     @JsonProperty("to")
     public void setTo(ObjectReference to) {
         this.to = to;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildPostCommitSpec.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildPostCommitSpec.java
index 0c265783ac1..19401dde990 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildPostCommitSpec.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildPostCommitSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * A BuildPostCommitSpec holds a build post commit hook specification. The hook executes a command in a temporary container running the build output image, immediately after the last layer of the image is committed and before the image is pushed to a registry. The command is executed with the current working directory ($PWD) set to the image's WORKDIR.<br><p> <br><p> The build will be marked as failed if the hook execution fails. It will fail if the script or command return a non-zero exit code, or if there is any other error related to starting the temporary container.<br><p> <br><p> There are five different ways to configure the hook. As an example, all forms below are equivalent and will execute `rake test --verbose`.<br><p> <br><p> 1. Shell script:<br><p> <br><p> 	   "postCommit": {<br><p> 	     "script": "rake test --verbose",<br><p> 	   }<br><p> <br><p> 	The above is a convenient form which is equivalent to:<br><p> <br><p> 	   "postCommit": {<br><p> 	     "command": ["/bin/sh", "-ic"],<br><p> 	     "args":    ["rake test --verbose"]<br><p> 	   }<br><p> <br><p> 2. A command as the image entrypoint:<br><p> <br><p> 	   "postCommit": {<br><p> 	     "commit": ["rake", "test", "--verbose"]<br><p> 	   }<br><p> <br><p> 	Command overrides the image entrypoint in the exec form, as documented in<br><p> 	Docker: https://docs.docker.com/engine/reference/builder/#entrypoint.<br><p> <br><p> 3. Pass arguments to the default entrypoint:<br><p> <br><p> 	       "postCommit": {<br><p> 			      "args": ["rake", "test", "--verbose"]<br><p> 		      }<br><p> <br><p> 	    This form is only useful if the image entrypoint can handle arguments.<br><p> <br><p> 4. Shell script with arguments:<br><p> <br><p> 	   "postCommit": {<br><p> 	     "script": "rake test $1",<br><p> 	     "args":   ["--verbose"]<br><p> 	   }<br><p> <br><p> 	This form is useful if you need to pass arguments that would otherwise be<br><p> 	hard to quote properly in the shell script. In the script, $0 will be<br><p> 	"/bin/sh" and $1, $2, etc, are the positional arguments from Args.<br><p> <br><p> 5. Command with arguments:<br><p> <br><p> 	   "postCommit": {<br><p> 	     "command": ["rake", "test"],<br><p> 	     "args":    ["--verbose"]<br><p> 	   }<br><p> <br><p> 	This form is equivalent to appending the arguments to the Command slice.<br><p> <br><p> It is invalid to provide both Script and Command simultaneously. If none of the fields are specified, the hook is not executed.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public BuildPostCommitSpec(List<String> args, List<String> command, String scrip
         this.script = script;
     }
 
+    /**
+     * args is a list of arguments that are provided to either Command, Script or the container image's default entrypoint. The arguments are placed immediately after the command to be run.
+     */
     @JsonProperty("args")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getArgs() {
         return args;
     }
 
+    /**
+     * args is a list of arguments that are provided to either Command, Script or the container image's default entrypoint. The arguments are placed immediately after the command to be run.
+     */
     @JsonProperty("args")
     public void setArgs(List<String> args) {
         this.args = args;
     }
 
+    /**
+     * command is the command to run. It may not be specified with Script. This might be needed if the image doesn't have `/bin/sh`, or if you do not want to use a shell. In all other cases, using Script might be more convenient.
+     */
     @JsonProperty("command")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCommand() {
         return command;
     }
 
+    /**
+     * command is the command to run. It may not be specified with Script. This might be needed if the image doesn't have `/bin/sh`, or if you do not want to use a shell. In all other cases, using Script might be more convenient.
+     */
     @JsonProperty("command")
     public void setCommand(List<String> command) {
         this.command = command;
     }
 
+    /**
+     * script is a shell script to be run with `/bin/sh -ic`. It may not be specified with Command. Use Script when a shell script is appropriate to execute the post build hook, for example for running unit tests with `rake test`. If you need control over the image entrypoint, or if the image does not have `/bin/sh`, use Command and/or Args. The `-i` flag is needed to support CentOS and RHEL images that use Software Collections (SCL), in order to have the appropriate collections enabled in the shell. E.g., in the Ruby image, this is necessary to make `ruby`, `bundle` and other binaries available in the PATH.
+     */
     @JsonProperty("script")
     public String getScript() {
         return script;
     }
 
+    /**
+     * script is a shell script to be run with `/bin/sh -ic`. It may not be specified with Command. Use Script when a shell script is appropriate to execute the post build hook, for example for running unit tests with `rake test`. If you need control over the image entrypoint, or if the image does not have `/bin/sh`, use Command and/or Args. The `-i` flag is needed to support CentOS and RHEL images that use Software Collections (SCL), in order to have the appropriate collections enabled in the shell. E.g., in the Ruby image, this is necessary to make `ruby`, `bundle` and other binaries available in the PATH.
+     */
     @JsonProperty("script")
     public void setScript(String script) {
         this.script = script;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildRequest.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildRequest.java
index bf82fa20260..de38667c7e5 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildRequest.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildRequest.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BuildRequest is the resource used to pass parameters to build generator<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,9 +88,6 @@
 public class BuildRequest implements Editable<BuildRequestBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "build.openshift.io/v1";
     @JsonProperty("binary")
@@ -99,9 +99,6 @@ public class BuildRequest implements Editable<BuildRequestBuilder>, HasMetadata,
     private List<EnvVar> env = new ArrayList<>();
     @JsonProperty("from")
     private ObjectReference from;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "BuildRequest";
     @JsonProperty("lastVersion")
@@ -143,7 +140,7 @@ public BuildRequest(String apiVersion, BinaryBuildSource binary, DockerStrategyO
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -151,56 +148,80 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * BuildRequest is the resource used to pass parameters to build generator<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("binary")
     public BinaryBuildSource getBinary() {
         return binary;
     }
 
+    /**
+     * BuildRequest is the resource used to pass parameters to build generator<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("binary")
     public void setBinary(BinaryBuildSource binary) {
         this.binary = binary;
     }
 
+    /**
+     * BuildRequest is the resource used to pass parameters to build generator<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("dockerStrategyOptions")
     public DockerStrategyOptions getDockerStrategyOptions() {
         return dockerStrategyOptions;
     }
 
+    /**
+     * BuildRequest is the resource used to pass parameters to build generator<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("dockerStrategyOptions")
     public void setDockerStrategyOptions(DockerStrategyOptions dockerStrategyOptions) {
         this.dockerStrategyOptions = dockerStrategyOptions;
     }
 
+    /**
+     * env contains additional environment variables you want to pass into a builder container.
+     */
     @JsonProperty("env")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvVar> getEnv() {
         return env;
     }
 
+    /**
+     * env contains additional environment variables you want to pass into a builder container.
+     */
     @JsonProperty("env")
     public void setEnv(List<EnvVar> env) {
         this.env = env;
     }
 
+    /**
+     * BuildRequest is the resource used to pass parameters to build generator<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("from")
     public ObjectReference getFrom() {
         return from;
     }
 
+    /**
+     * BuildRequest is the resource used to pass parameters to build generator<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("from")
     public void setFrom(ObjectReference from) {
         this.from = from;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -208,69 +229,105 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * lastVersion (optional) is the LastVersion of the BuildConfig that was used to generate the build. If the BuildConfig in the generator doesn't match, a build will not be generated.
+     */
     @JsonProperty("lastVersion")
     public Long getLastVersion() {
         return lastVersion;
     }
 
+    /**
+     * lastVersion (optional) is the LastVersion of the BuildConfig that was used to generate the build. If the BuildConfig in the generator doesn't match, a build will not be generated.
+     */
     @JsonProperty("lastVersion")
     public void setLastVersion(Long lastVersion) {
         this.lastVersion = lastVersion;
     }
 
+    /**
+     * BuildRequest is the resource used to pass parameters to build generator<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * BuildRequest is the resource used to pass parameters to build generator<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * BuildRequest is the resource used to pass parameters to build generator<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("revision")
     public SourceRevision getRevision() {
         return revision;
     }
 
+    /**
+     * BuildRequest is the resource used to pass parameters to build generator<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("revision")
     public void setRevision(SourceRevision revision) {
         this.revision = revision;
     }
 
+    /**
+     * BuildRequest is the resource used to pass parameters to build generator<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("sourceStrategyOptions")
     public SourceStrategyOptions getSourceStrategyOptions() {
         return sourceStrategyOptions;
     }
 
+    /**
+     * BuildRequest is the resource used to pass parameters to build generator<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("sourceStrategyOptions")
     public void setSourceStrategyOptions(SourceStrategyOptions sourceStrategyOptions) {
         this.sourceStrategyOptions = sourceStrategyOptions;
     }
 
+    /**
+     * triggeredBy describes which triggers started the most recent update to the build configuration and contains information about those triggers.
+     */
     @JsonProperty("triggeredBy")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<BuildTriggerCause> getTriggeredBy() {
         return triggeredBy;
     }
 
+    /**
+     * triggeredBy describes which triggers started the most recent update to the build configuration and contains information about those triggers.
+     */
     @JsonProperty("triggeredBy")
     public void setTriggeredBy(List<BuildTriggerCause> triggeredBy) {
         this.triggeredBy = triggeredBy;
     }
 
+    /**
+     * BuildRequest is the resource used to pass parameters to build generator<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("triggeredByImage")
     public ObjectReference getTriggeredByImage() {
         return triggeredByImage;
     }
 
+    /**
+     * BuildRequest is the resource used to pass parameters to build generator<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("triggeredByImage")
     public void setTriggeredByImage(ObjectReference triggeredByImage) {
         this.triggeredByImage = triggeredByImage;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildSource.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildSource.java
index b86b770fdbe..f6be95c2b33 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildSource.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildSource.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BuildSource is the SCM used for the build.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -115,94 +118,148 @@ public BuildSource(BinaryBuildSource binary, List<ConfigMapBuildSource> configMa
         this.type = type;
     }
 
+    /**
+     * BuildSource is the SCM used for the build.
+     */
     @JsonProperty("binary")
     public BinaryBuildSource getBinary() {
         return binary;
     }
 
+    /**
+     * BuildSource is the SCM used for the build.
+     */
     @JsonProperty("binary")
     public void setBinary(BinaryBuildSource binary) {
         this.binary = binary;
     }
 
+    /**
+     * configMaps represents a list of configMaps and their destinations that will be used for the build.
+     */
     @JsonProperty("configMaps")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ConfigMapBuildSource> getConfigMaps() {
         return configMaps;
     }
 
+    /**
+     * configMaps represents a list of configMaps and their destinations that will be used for the build.
+     */
     @JsonProperty("configMaps")
     public void setConfigMaps(List<ConfigMapBuildSource> configMaps) {
         this.configMaps = configMaps;
     }
 
+    /**
+     * contextDir specifies the sub-directory where the source code for the application exists. This allows to have buildable sources in directory other than root of repository.
+     */
     @JsonProperty("contextDir")
     public String getContextDir() {
         return contextDir;
     }
 
+    /**
+     * contextDir specifies the sub-directory where the source code for the application exists. This allows to have buildable sources in directory other than root of repository.
+     */
     @JsonProperty("contextDir")
     public void setContextDir(String contextDir) {
         this.contextDir = contextDir;
     }
 
+    /**
+     * dockerfile is the raw contents of a Dockerfile which should be built. When this option is specified, the FROM may be modified based on your strategy base image and additional ENV stanzas from your strategy environment will be added after the FROM, but before the rest of your Dockerfile stanzas. The Dockerfile source type may be used with other options like git - in those cases the Git repo will have any innate Dockerfile replaced in the context dir.
+     */
     @JsonProperty("dockerfile")
     public String getDockerfile() {
         return dockerfile;
     }
 
+    /**
+     * dockerfile is the raw contents of a Dockerfile which should be built. When this option is specified, the FROM may be modified based on your strategy base image and additional ENV stanzas from your strategy environment will be added after the FROM, but before the rest of your Dockerfile stanzas. The Dockerfile source type may be used with other options like git - in those cases the Git repo will have any innate Dockerfile replaced in the context dir.
+     */
     @JsonProperty("dockerfile")
     public void setDockerfile(String dockerfile) {
         this.dockerfile = dockerfile;
     }
 
+    /**
+     * BuildSource is the SCM used for the build.
+     */
     @JsonProperty("git")
     public GitBuildSource getGit() {
         return git;
     }
 
+    /**
+     * BuildSource is the SCM used for the build.
+     */
     @JsonProperty("git")
     public void setGit(GitBuildSource git) {
         this.git = git;
     }
 
+    /**
+     * images describes a set of images to be used to provide source for the build
+     */
     @JsonProperty("images")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ImageSource> getImages() {
         return images;
     }
 
+    /**
+     * images describes a set of images to be used to provide source for the build
+     */
     @JsonProperty("images")
     public void setImages(List<ImageSource> images) {
         this.images = images;
     }
 
+    /**
+     * secrets represents a list of secrets and their destinations that will be used only for the build.
+     */
     @JsonProperty("secrets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SecretBuildSource> getSecrets() {
         return secrets;
     }
 
+    /**
+     * secrets represents a list of secrets and their destinations that will be used only for the build.
+     */
     @JsonProperty("secrets")
     public void setSecrets(List<SecretBuildSource> secrets) {
         this.secrets = secrets;
     }
 
+    /**
+     * BuildSource is the SCM used for the build.
+     */
     @JsonProperty("sourceSecret")
     public LocalObjectReference getSourceSecret() {
         return sourceSecret;
     }
 
+    /**
+     * BuildSource is the SCM used for the build.
+     */
     @JsonProperty("sourceSecret")
     public void setSourceSecret(LocalObjectReference sourceSecret) {
         this.sourceSecret = sourceSecret;
     }
 
+    /**
+     * type of build input to accept
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type of build input to accept
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildSpec.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildSpec.java
index f82f9ea7c40..ffdd376d351 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildSpec.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BuildSpec has the information to represent a build and also additional information about a build
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -122,113 +125,179 @@ public BuildSpec(Long completionDeadlineSeconds, Boolean mountTrustedCA, Map<Str
         this.triggeredBy = triggeredBy;
     }
 
+    /**
+     * completionDeadlineSeconds is an optional duration in seconds, counted from the time when a build pod gets scheduled in the system, that the build may be active on a node before the system actively tries to terminate the build; value must be positive integer
+     */
     @JsonProperty("completionDeadlineSeconds")
     public Long getCompletionDeadlineSeconds() {
         return completionDeadlineSeconds;
     }
 
+    /**
+     * completionDeadlineSeconds is an optional duration in seconds, counted from the time when a build pod gets scheduled in the system, that the build may be active on a node before the system actively tries to terminate the build; value must be positive integer
+     */
     @JsonProperty("completionDeadlineSeconds")
     public void setCompletionDeadlineSeconds(Long completionDeadlineSeconds) {
         this.completionDeadlineSeconds = completionDeadlineSeconds;
     }
 
+    /**
+     * mountTrustedCA bind mounts the cluster's trusted certificate authorities, as defined in the cluster's proxy configuration, into the build. This lets processes within a build trust components signed by custom PKI certificate authorities, such as private artifact repositories and HTTPS proxies.<br><p> <br><p> When this field is set to true, the contents of `/etc/pki/ca-trust` within the build are managed by the build container, and any changes to this directory or its subdirectories (for example - within a Dockerfile `RUN` instruction) are not persisted in the build's output image.
+     */
     @JsonProperty("mountTrustedCA")
     public Boolean getMountTrustedCA() {
         return mountTrustedCA;
     }
 
+    /**
+     * mountTrustedCA bind mounts the cluster's trusted certificate authorities, as defined in the cluster's proxy configuration, into the build. This lets processes within a build trust components signed by custom PKI certificate authorities, such as private artifact repositories and HTTPS proxies.<br><p> <br><p> When this field is set to true, the contents of `/etc/pki/ca-trust` within the build are managed by the build container, and any changes to this directory or its subdirectories (for example - within a Dockerfile `RUN` instruction) are not persisted in the build's output image.
+     */
     @JsonProperty("mountTrustedCA")
     public void setMountTrustedCA(Boolean mountTrustedCA) {
         this.mountTrustedCA = mountTrustedCA;
     }
 
+    /**
+     * nodeSelector is a selector which must be true for the build pod to fit on a node If nil, it can be overridden by default build nodeselector values for the cluster. If set to an empty map or a map with any values, default build nodeselector values are ignored.
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * nodeSelector is a selector which must be true for the build pod to fit on a node If nil, it can be overridden by default build nodeselector values for the cluster. If set to an empty map or a map with any values, default build nodeselector values are ignored.
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * BuildSpec has the information to represent a build and also additional information about a build
+     */
     @JsonProperty("output")
     public BuildOutput getOutput() {
         return output;
     }
 
+    /**
+     * BuildSpec has the information to represent a build and also additional information about a build
+     */
     @JsonProperty("output")
     public void setOutput(BuildOutput output) {
         this.output = output;
     }
 
+    /**
+     * BuildSpec has the information to represent a build and also additional information about a build
+     */
     @JsonProperty("postCommit")
     public BuildPostCommitSpec getPostCommit() {
         return postCommit;
     }
 
+    /**
+     * BuildSpec has the information to represent a build and also additional information about a build
+     */
     @JsonProperty("postCommit")
     public void setPostCommit(BuildPostCommitSpec postCommit) {
         this.postCommit = postCommit;
     }
 
+    /**
+     * BuildSpec has the information to represent a build and also additional information about a build
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * BuildSpec has the information to represent a build and also additional information about a build
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * BuildSpec has the information to represent a build and also additional information about a build
+     */
     @JsonProperty("revision")
     public SourceRevision getRevision() {
         return revision;
     }
 
+    /**
+     * BuildSpec has the information to represent a build and also additional information about a build
+     */
     @JsonProperty("revision")
     public void setRevision(SourceRevision revision) {
         this.revision = revision;
     }
 
+    /**
+     * serviceAccount is the name of the ServiceAccount to use to run the pod created by this build. The pod will be allowed to use secrets referenced by the ServiceAccount
+     */
     @JsonProperty("serviceAccount")
     public String getServiceAccount() {
         return serviceAccount;
     }
 
+    /**
+     * serviceAccount is the name of the ServiceAccount to use to run the pod created by this build. The pod will be allowed to use secrets referenced by the ServiceAccount
+     */
     @JsonProperty("serviceAccount")
     public void setServiceAccount(String serviceAccount) {
         this.serviceAccount = serviceAccount;
     }
 
+    /**
+     * BuildSpec has the information to represent a build and also additional information about a build
+     */
     @JsonProperty("source")
     public BuildSource getSource() {
         return source;
     }
 
+    /**
+     * BuildSpec has the information to represent a build and also additional information about a build
+     */
     @JsonProperty("source")
     public void setSource(BuildSource source) {
         this.source = source;
     }
 
+    /**
+     * BuildSpec has the information to represent a build and also additional information about a build
+     */
     @JsonProperty("strategy")
     public BuildStrategy getStrategy() {
         return strategy;
     }
 
+    /**
+     * BuildSpec has the information to represent a build and also additional information about a build
+     */
     @JsonProperty("strategy")
     public void setStrategy(BuildStrategy strategy) {
         this.strategy = strategy;
     }
 
+    /**
+     * triggeredBy describes which triggers started the most recent update to the build configuration and contains information about those triggers.
+     */
     @JsonProperty("triggeredBy")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<BuildTriggerCause> getTriggeredBy() {
         return triggeredBy;
     }
 
+    /**
+     * triggeredBy describes which triggers started the most recent update to the build configuration and contains information about those triggers.
+     */
     @JsonProperty("triggeredBy")
     public void setTriggeredBy(List<BuildTriggerCause> triggeredBy) {
         this.triggeredBy = triggeredBy;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildStatus.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildStatus.java
index 8e511ca66e4..0c2b78965d6 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildStatus.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BuildStatus contains the status of a build
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -130,133 +133,211 @@ public BuildStatus(Boolean cancelled, String completionTimestamp, List<BuildCond
         this.startTimestamp = startTimestamp;
     }
 
+    /**
+     * cancelled describes if a cancel event was triggered for the build.
+     */
     @JsonProperty("cancelled")
     public Boolean getCancelled() {
         return cancelled;
     }
 
+    /**
+     * cancelled describes if a cancel event was triggered for the build.
+     */
     @JsonProperty("cancelled")
     public void setCancelled(Boolean cancelled) {
         this.cancelled = cancelled;
     }
 
+    /**
+     * BuildStatus contains the status of a build
+     */
     @JsonProperty("completionTimestamp")
     public String getCompletionTimestamp() {
         return completionTimestamp;
     }
 
+    /**
+     * BuildStatus contains the status of a build
+     */
     @JsonProperty("completionTimestamp")
     public void setCompletionTimestamp(String completionTimestamp) {
         this.completionTimestamp = completionTimestamp;
     }
 
+    /**
+     * Conditions represents the latest available observations of a build's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<BuildCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions represents the latest available observations of a build's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<BuildCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * BuildStatus contains the status of a build
+     */
     @JsonProperty("config")
     public ObjectReference getConfig() {
         return config;
     }
 
+    /**
+     * BuildStatus contains the status of a build
+     */
     @JsonProperty("config")
     public void setConfig(ObjectReference config) {
         this.config = config;
     }
 
+    /**
+     * duration contains time.Duration object describing build time.
+     */
     @JsonProperty("duration")
     public Long getDuration() {
         return duration;
     }
 
+    /**
+     * duration contains time.Duration object describing build time.
+     */
     @JsonProperty("duration")
     public void setDuration(Long duration) {
         this.duration = duration;
     }
 
+    /**
+     * logSnippet is the last few lines of the build log.  This value is only set for builds that failed.
+     */
     @JsonProperty("logSnippet")
     public String getLogSnippet() {
         return logSnippet;
     }
 
+    /**
+     * logSnippet is the last few lines of the build log.  This value is only set for builds that failed.
+     */
     @JsonProperty("logSnippet")
     public void setLogSnippet(String logSnippet) {
         this.logSnippet = logSnippet;
     }
 
+    /**
+     * message is a human-readable message indicating details about why the build has this status.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message is a human-readable message indicating details about why the build has this status.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * BuildStatus contains the status of a build
+     */
     @JsonProperty("output")
     public BuildStatusOutput getOutput() {
         return output;
     }
 
+    /**
+     * BuildStatus contains the status of a build
+     */
     @JsonProperty("output")
     public void setOutput(BuildStatusOutput output) {
         this.output = output;
     }
 
+    /**
+     * outputDockerImageReference contains a reference to the container image that will be built by this build. Its value is computed from Build.Spec.Output.To, and should include the registry address, so that it can be used to push and pull the image.
+     */
     @JsonProperty("outputDockerImageReference")
     public String getOutputDockerImageReference() {
         return outputDockerImageReference;
     }
 
+    /**
+     * outputDockerImageReference contains a reference to the container image that will be built by this build. Its value is computed from Build.Spec.Output.To, and should include the registry address, so that it can be used to push and pull the image.
+     */
     @JsonProperty("outputDockerImageReference")
     public void setOutputDockerImageReference(String outputDockerImageReference) {
         this.outputDockerImageReference = outputDockerImageReference;
     }
 
+    /**
+     * phase is the point in the build lifecycle. Possible values are "New", "Pending", "Running", "Complete", "Failed", "Error", and "Cancelled".
+     */
     @JsonProperty("phase")
     public String getPhase() {
         return phase;
     }
 
+    /**
+     * phase is the point in the build lifecycle. Possible values are "New", "Pending", "Running", "Complete", "Failed", "Error", and "Cancelled".
+     */
     @JsonProperty("phase")
     public void setPhase(String phase) {
         this.phase = phase;
     }
 
+    /**
+     * reason is a brief CamelCase string that describes any failure and is meant for machine parsing and tidy display in the CLI.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * reason is a brief CamelCase string that describes any failure and is meant for machine parsing and tidy display in the CLI.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * stages contains details about each stage that occurs during the build including start time, duration (in milliseconds), and the steps that occured within each stage.
+     */
     @JsonProperty("stages")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<StageInfo> getStages() {
         return stages;
     }
 
+    /**
+     * stages contains details about each stage that occurs during the build including start time, duration (in milliseconds), and the steps that occured within each stage.
+     */
     @JsonProperty("stages")
     public void setStages(List<StageInfo> stages) {
         this.stages = stages;
     }
 
+    /**
+     * BuildStatus contains the status of a build
+     */
     @JsonProperty("startTimestamp")
     public String getStartTimestamp() {
         return startTimestamp;
     }
 
+    /**
+     * BuildStatus contains the status of a build
+     */
     @JsonProperty("startTimestamp")
     public void setStartTimestamp(String startTimestamp) {
         this.startTimestamp = startTimestamp;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildStatusOutput.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildStatusOutput.java
index 02387b0b0ff..425f1d2bd80 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildStatusOutput.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildStatusOutput.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BuildStatusOutput contains the status of the built image.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public BuildStatusOutput(BuildStatusOutputTo to) {
         this.to = to;
     }
 
+    /**
+     * BuildStatusOutput contains the status of the built image.
+     */
     @JsonProperty("to")
     public BuildStatusOutputTo getTo() {
         return to;
     }
 
+    /**
+     * BuildStatusOutput contains the status of the built image.
+     */
     @JsonProperty("to")
     public void setTo(BuildStatusOutputTo to) {
         this.to = to;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildStatusOutputTo.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildStatusOutputTo.java
index de4554a06cd..b3623404ecf 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildStatusOutputTo.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildStatusOutputTo.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BuildStatusOutputTo describes the status of the built image with regards to image registry to which it was supposed to be pushed.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public BuildStatusOutputTo(String imageDigest) {
         this.imageDigest = imageDigest;
     }
 
+    /**
+     * imageDigest is the digest of the built container image. The digest uniquely identifies the image in the registry to which it was pushed.<br><p> <br><p> Please note that this field may not always be set even if the push completes successfully - e.g. when the registry returns no digest or returns it in a format that the builder doesn't understand.
+     */
     @JsonProperty("imageDigest")
     public String getImageDigest() {
         return imageDigest;
     }
 
+    /**
+     * imageDigest is the digest of the built container image. The digest uniquely identifies the image in the registry to which it was pushed.<br><p> <br><p> Please note that this field may not always be set even if the push completes successfully - e.g. when the registry returns no digest or returns it in a format that the builder doesn't understand.
+     */
     @JsonProperty("imageDigest")
     public void setImageDigest(String imageDigest) {
         this.imageDigest = imageDigest;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildStrategy.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildStrategy.java
index f0998981d86..01adb90b347 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildStrategy.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildStrategy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BuildStrategy contains the details of how to perform a build.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public BuildStrategy(CustomBuildStrategy customStrategy, DockerBuildStrategy doc
         this.type = type;
     }
 
+    /**
+     * BuildStrategy contains the details of how to perform a build.
+     */
     @JsonProperty("customStrategy")
     public CustomBuildStrategy getCustomStrategy() {
         return customStrategy;
     }
 
+    /**
+     * BuildStrategy contains the details of how to perform a build.
+     */
     @JsonProperty("customStrategy")
     public void setCustomStrategy(CustomBuildStrategy customStrategy) {
         this.customStrategy = customStrategy;
     }
 
+    /**
+     * BuildStrategy contains the details of how to perform a build.
+     */
     @JsonProperty("dockerStrategy")
     public DockerBuildStrategy getDockerStrategy() {
         return dockerStrategy;
     }
 
+    /**
+     * BuildStrategy contains the details of how to perform a build.
+     */
     @JsonProperty("dockerStrategy")
     public void setDockerStrategy(DockerBuildStrategy dockerStrategy) {
         this.dockerStrategy = dockerStrategy;
     }
 
+    /**
+     * BuildStrategy contains the details of how to perform a build.
+     */
     @JsonProperty("jenkinsPipelineStrategy")
     public JenkinsPipelineBuildStrategy getJenkinsPipelineStrategy() {
         return jenkinsPipelineStrategy;
     }
 
+    /**
+     * BuildStrategy contains the details of how to perform a build.
+     */
     @JsonProperty("jenkinsPipelineStrategy")
     public void setJenkinsPipelineStrategy(JenkinsPipelineBuildStrategy jenkinsPipelineStrategy) {
         this.jenkinsPipelineStrategy = jenkinsPipelineStrategy;
     }
 
+    /**
+     * BuildStrategy contains the details of how to perform a build.
+     */
     @JsonProperty("sourceStrategy")
     public SourceBuildStrategy getSourceStrategy() {
         return sourceStrategy;
     }
 
+    /**
+     * BuildStrategy contains the details of how to perform a build.
+     */
     @JsonProperty("sourceStrategy")
     public void setSourceStrategy(SourceBuildStrategy sourceStrategy) {
         this.sourceStrategy = sourceStrategy;
     }
 
+    /**
+     * type is the kind of build strategy.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the kind of build strategy.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildTriggerCause.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildTriggerCause.java
index f049a79635b..2607d33078a 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildTriggerCause.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildTriggerCause.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BuildTriggerCause holds information about a triggered build. It is used for displaying build trigger data for each build and build configuration in oc describe. It is also used to describe which triggers led to the most recent update in the build configuration.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public BuildTriggerCause(BitbucketWebHookCause bitbucketWebHook, GenericWebHookC
         this.message = message;
     }
 
+    /**
+     * BuildTriggerCause holds information about a triggered build. It is used for displaying build trigger data for each build and build configuration in oc describe. It is also used to describe which triggers led to the most recent update in the build configuration.
+     */
     @JsonProperty("bitbucketWebHook")
     public BitbucketWebHookCause getBitbucketWebHook() {
         return bitbucketWebHook;
     }
 
+    /**
+     * BuildTriggerCause holds information about a triggered build. It is used for displaying build trigger data for each build and build configuration in oc describe. It is also used to describe which triggers led to the most recent update in the build configuration.
+     */
     @JsonProperty("bitbucketWebHook")
     public void setBitbucketWebHook(BitbucketWebHookCause bitbucketWebHook) {
         this.bitbucketWebHook = bitbucketWebHook;
     }
 
+    /**
+     * BuildTriggerCause holds information about a triggered build. It is used for displaying build trigger data for each build and build configuration in oc describe. It is also used to describe which triggers led to the most recent update in the build configuration.
+     */
     @JsonProperty("genericWebHook")
     public GenericWebHookCause getGenericWebHook() {
         return genericWebHook;
     }
 
+    /**
+     * BuildTriggerCause holds information about a triggered build. It is used for displaying build trigger data for each build and build configuration in oc describe. It is also used to describe which triggers led to the most recent update in the build configuration.
+     */
     @JsonProperty("genericWebHook")
     public void setGenericWebHook(GenericWebHookCause genericWebHook) {
         this.genericWebHook = genericWebHook;
     }
 
+    /**
+     * BuildTriggerCause holds information about a triggered build. It is used for displaying build trigger data for each build and build configuration in oc describe. It is also used to describe which triggers led to the most recent update in the build configuration.
+     */
     @JsonProperty("githubWebHook")
     public GitHubWebHookCause getGithubWebHook() {
         return githubWebHook;
     }
 
+    /**
+     * BuildTriggerCause holds information about a triggered build. It is used for displaying build trigger data for each build and build configuration in oc describe. It is also used to describe which triggers led to the most recent update in the build configuration.
+     */
     @JsonProperty("githubWebHook")
     public void setGithubWebHook(GitHubWebHookCause githubWebHook) {
         this.githubWebHook = githubWebHook;
     }
 
+    /**
+     * BuildTriggerCause holds information about a triggered build. It is used for displaying build trigger data for each build and build configuration in oc describe. It is also used to describe which triggers led to the most recent update in the build configuration.
+     */
     @JsonProperty("gitlabWebHook")
     public GitLabWebHookCause getGitlabWebHook() {
         return gitlabWebHook;
     }
 
+    /**
+     * BuildTriggerCause holds information about a triggered build. It is used for displaying build trigger data for each build and build configuration in oc describe. It is also used to describe which triggers led to the most recent update in the build configuration.
+     */
     @JsonProperty("gitlabWebHook")
     public void setGitlabWebHook(GitLabWebHookCause gitlabWebHook) {
         this.gitlabWebHook = gitlabWebHook;
     }
 
+    /**
+     * BuildTriggerCause holds information about a triggered build. It is used for displaying build trigger data for each build and build configuration in oc describe. It is also used to describe which triggers led to the most recent update in the build configuration.
+     */
     @JsonProperty("imageChangeBuild")
     public ImageChangeCause getImageChangeBuild() {
         return imageChangeBuild;
     }
 
+    /**
+     * BuildTriggerCause holds information about a triggered build. It is used for displaying build trigger data for each build and build configuration in oc describe. It is also used to describe which triggers led to the most recent update in the build configuration.
+     */
     @JsonProperty("imageChangeBuild")
     public void setImageChangeBuild(ImageChangeCause imageChangeBuild) {
         this.imageChangeBuild = imageChangeBuild;
     }
 
+    /**
+     * message is used to store a human readable message for why the build was triggered. E.g.: "Manually triggered by user", "Configuration change",etc.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message is used to store a human readable message for why the build was triggered. E.g.: "Manually triggered by user", "Configuration change",etc.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildTriggerPolicy.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildTriggerPolicy.java
index bfd034eb4a7..b23d6798781 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildTriggerPolicy.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildTriggerPolicy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BuildTriggerPolicy describes a policy for a single trigger that results in a new Build.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public BuildTriggerPolicy(WebHookTrigger bitbucket, WebHookTrigger generic, WebH
         this.type = type;
     }
 
+    /**
+     * BuildTriggerPolicy describes a policy for a single trigger that results in a new Build.
+     */
     @JsonProperty("bitbucket")
     public WebHookTrigger getBitbucket() {
         return bitbucket;
     }
 
+    /**
+     * BuildTriggerPolicy describes a policy for a single trigger that results in a new Build.
+     */
     @JsonProperty("bitbucket")
     public void setBitbucket(WebHookTrigger bitbucket) {
         this.bitbucket = bitbucket;
     }
 
+    /**
+     * BuildTriggerPolicy describes a policy for a single trigger that results in a new Build.
+     */
     @JsonProperty("generic")
     public WebHookTrigger getGeneric() {
         return generic;
     }
 
+    /**
+     * BuildTriggerPolicy describes a policy for a single trigger that results in a new Build.
+     */
     @JsonProperty("generic")
     public void setGeneric(WebHookTrigger generic) {
         this.generic = generic;
     }
 
+    /**
+     * BuildTriggerPolicy describes a policy for a single trigger that results in a new Build.
+     */
     @JsonProperty("github")
     public WebHookTrigger getGithub() {
         return github;
     }
 
+    /**
+     * BuildTriggerPolicy describes a policy for a single trigger that results in a new Build.
+     */
     @JsonProperty("github")
     public void setGithub(WebHookTrigger github) {
         this.github = github;
     }
 
+    /**
+     * BuildTriggerPolicy describes a policy for a single trigger that results in a new Build.
+     */
     @JsonProperty("gitlab")
     public WebHookTrigger getGitlab() {
         return gitlab;
     }
 
+    /**
+     * BuildTriggerPolicy describes a policy for a single trigger that results in a new Build.
+     */
     @JsonProperty("gitlab")
     public void setGitlab(WebHookTrigger gitlab) {
         this.gitlab = gitlab;
     }
 
+    /**
+     * BuildTriggerPolicy describes a policy for a single trigger that results in a new Build.
+     */
     @JsonProperty("imageChange")
     public ImageChangeTrigger getImageChange() {
         return imageChange;
     }
 
+    /**
+     * BuildTriggerPolicy describes a policy for a single trigger that results in a new Build.
+     */
     @JsonProperty("imageChange")
     public void setImageChange(ImageChangeTrigger imageChange) {
         this.imageChange = imageChange;
     }
 
+    /**
+     * type is the type of build trigger. Valid values:<br><p> <br><p> - GitHub GitHubWebHookBuildTriggerType represents a trigger that launches builds on GitHub webhook invocations<br><p> <br><p> - Generic GenericWebHookBuildTriggerType represents a trigger that launches builds on generic webhook invocations<br><p> <br><p> - GitLab GitLabWebHookBuildTriggerType represents a trigger that launches builds on GitLab webhook invocations<br><p> <br><p> - Bitbucket BitbucketWebHookBuildTriggerType represents a trigger that launches builds on Bitbucket webhook invocations<br><p> <br><p> - ImageChange ImageChangeBuildTriggerType represents a trigger that launches builds on availability of a new version of an image<br><p> <br><p> - ConfigChange ConfigChangeBuildTriggerType will trigger a build on an initial build config creation WARNING: In the future the behavior will change to trigger a build on any config change
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the type of build trigger. Valid values:<br><p> <br><p> - GitHub GitHubWebHookBuildTriggerType represents a trigger that launches builds on GitHub webhook invocations<br><p> <br><p> - Generic GenericWebHookBuildTriggerType represents a trigger that launches builds on generic webhook invocations<br><p> <br><p> - GitLab GitLabWebHookBuildTriggerType represents a trigger that launches builds on GitLab webhook invocations<br><p> <br><p> - Bitbucket BitbucketWebHookBuildTriggerType represents a trigger that launches builds on Bitbucket webhook invocations<br><p> <br><p> - ImageChange ImageChangeBuildTriggerType represents a trigger that launches builds on availability of a new version of an image<br><p> <br><p> - ConfigChange ConfigChangeBuildTriggerType will trigger a build on an initial build config creation WARNING: In the future the behavior will change to trigger a build on any config change
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildVolume.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildVolume.java
index 55813458423..fcb9b06279b 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildVolume.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildVolume.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BuildVolume describes a volume that is made available to build pods, such that it can be mounted into buildah's runtime environment. Only a subset of Kubernetes Volume sources are supported.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public BuildVolume(List<BuildVolumeMount> mounts, String name, BuildVolumeSource
         this.source = source;
     }
 
+    /**
+     * mounts represents the location of the volume in the image build container
+     */
     @JsonProperty("mounts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<BuildVolumeMount> getMounts() {
         return mounts;
     }
 
+    /**
+     * mounts represents the location of the volume in the image build container
+     */
     @JsonProperty("mounts")
     public void setMounts(List<BuildVolumeMount> mounts) {
         this.mounts = mounts;
     }
 
+    /**
+     * name is a unique identifier for this BuildVolume. It must conform to the Kubernetes DNS label standard and be unique within the pod. Names that collide with those added by the build controller will result in a failed build with an error message detailing which name caused the error. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is a unique identifier for this BuildVolume. It must conform to the Kubernetes DNS label standard and be unique within the pod. Names that collide with those added by the build controller will result in a failed build with an error message detailing which name caused the error. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * BuildVolume describes a volume that is made available to build pods, such that it can be mounted into buildah's runtime environment. Only a subset of Kubernetes Volume sources are supported.
+     */
     @JsonProperty("source")
     public BuildVolumeSource getSource() {
         return source;
     }
 
+    /**
+     * BuildVolume describes a volume that is made available to build pods, such that it can be mounted into buildah's runtime environment. Only a subset of Kubernetes Volume sources are supported.
+     */
     @JsonProperty("source")
     public void setSource(BuildVolumeSource source) {
         this.source = source;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildVolumeMount.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildVolumeMount.java
index f995fd5f4e1..7123754d957 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildVolumeMount.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildVolumeMount.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BuildVolumeMount describes the mounting of a Volume within buildah's runtime environment.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public BuildVolumeMount(String destinationPath) {
         this.destinationPath = destinationPath;
     }
 
+    /**
+     * destinationPath is the path within the buildah runtime environment at which the volume should be mounted. The transient mount within the build image and the backing volume will both be mounted read only. Must be an absolute path, must not contain '..' or ':', and must not collide with a destination path generated by the builder process Paths that collide with those added by the build controller will result in a failed build with an error message detailing which path caused the error.
+     */
     @JsonProperty("destinationPath")
     public String getDestinationPath() {
         return destinationPath;
     }
 
+    /**
+     * destinationPath is the path within the buildah runtime environment at which the volume should be mounted. The transient mount within the build image and the backing volume will both be mounted read only. Must be an absolute path, must not contain '..' or ':', and must not collide with a destination path generated by the builder process Paths that collide with those added by the build controller will result in a failed build with an error message detailing which path caused the error.
+     */
     @JsonProperty("destinationPath")
     public void setDestinationPath(String destinationPath) {
         this.destinationPath = destinationPath;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildVolumeSource.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildVolumeSource.java
index 83f176315ee..20064505aa9 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildVolumeSource.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/BuildVolumeSource.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * BuildVolumeSource represents the source of a volume to mount Only one of its supported types may be specified at any given time.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,41 +96,65 @@ public BuildVolumeSource(ConfigMapVolumeSource configMap, CSIVolumeSource csi, S
         this.type = type;
     }
 
+    /**
+     * BuildVolumeSource represents the source of a volume to mount Only one of its supported types may be specified at any given time.
+     */
     @JsonProperty("configMap")
     public ConfigMapVolumeSource getConfigMap() {
         return configMap;
     }
 
+    /**
+     * BuildVolumeSource represents the source of a volume to mount Only one of its supported types may be specified at any given time.
+     */
     @JsonProperty("configMap")
     public void setConfigMap(ConfigMapVolumeSource configMap) {
         this.configMap = configMap;
     }
 
+    /**
+     * BuildVolumeSource represents the source of a volume to mount Only one of its supported types may be specified at any given time.
+     */
     @JsonProperty("csi")
     public CSIVolumeSource getCsi() {
         return csi;
     }
 
+    /**
+     * BuildVolumeSource represents the source of a volume to mount Only one of its supported types may be specified at any given time.
+     */
     @JsonProperty("csi")
     public void setCsi(CSIVolumeSource csi) {
         this.csi = csi;
     }
 
+    /**
+     * BuildVolumeSource represents the source of a volume to mount Only one of its supported types may be specified at any given time.
+     */
     @JsonProperty("secret")
     public SecretVolumeSource getSecret() {
         return secret;
     }
 
+    /**
+     * BuildVolumeSource represents the source of a volume to mount Only one of its supported types may be specified at any given time.
+     */
     @JsonProperty("secret")
     public void setSecret(SecretVolumeSource secret) {
         this.secret = secret;
     }
 
+    /**
+     * type is the BuildVolumeSourceType for the volume source. Type must match the populated volume source. Valid types are: Secret, ConfigMap
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the BuildVolumeSourceType for the volume source. Type must match the populated volume source. Valid types are: Secret, ConfigMap
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterResourceQuota.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterResourceQuota.java
index 2e91bcecd84..5625738d001 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterResourceQuota.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterResourceQuota.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterResourceQuota mirrors ResourceQuota at a cluster scope.  This object is easily convertible to synthetic ResourceQuota object to allow quota evaluation re-use.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class ClusterResourceQuota implements Editable<ClusterResourceQuotaBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "quota.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterResourceQuota";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public ClusterResourceQuota(String apiVersion, String kind, ObjectMeta metadata,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterResourceQuota mirrors ResourceQuota at a cluster scope.  This object is easily convertible to synthetic ResourceQuota object to allow quota evaluation re-use.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterResourceQuota mirrors ResourceQuota at a cluster scope.  This object is easily convertible to synthetic ResourceQuota object to allow quota evaluation re-use.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ClusterResourceQuota mirrors ResourceQuota at a cluster scope.  This object is easily convertible to synthetic ResourceQuota object to allow quota evaluation re-use.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ClusterResourceQuotaSpec getSpec() {
         return spec;
     }
 
+    /**
+     * ClusterResourceQuota mirrors ResourceQuota at a cluster scope.  This object is easily convertible to synthetic ResourceQuota object to allow quota evaluation re-use.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ClusterResourceQuotaSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * ClusterResourceQuota mirrors ResourceQuota at a cluster scope.  This object is easily convertible to synthetic ResourceQuota object to allow quota evaluation re-use.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public ClusterResourceQuotaStatus getStatus() {
         return status;
     }
 
+    /**
+     * ClusterResourceQuota mirrors ResourceQuota at a cluster scope.  This object is easily convertible to synthetic ResourceQuota object to allow quota evaluation re-use.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(ClusterResourceQuotaStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterResourceQuotaList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterResourceQuotaList.java
index 8f44ccd2969..253ddedc902 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterResourceQuotaList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterResourceQuotaList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterResourceQuotaList is a collection of ClusterResourceQuotas<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ClusterResourceQuotaList implements Editable<ClusterResourceQuotaListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.ClusterResourceQuota>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "quota.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.ClusterResourceQuota> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterResourceQuotaList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterResourceQuotaList(String apiVersion, List<io.fabric8.openshift.api
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of ClusterResourceQuotas
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.ClusterResourceQuota> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of ClusterResourceQuotas
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.ClusterResourceQuota> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterResourceQuotaList is a collection of ClusterResourceQuotas<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterResourceQuotaList is a collection of ClusterResourceQuotas<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterResourceQuotaSelector.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterResourceQuotaSelector.java
index 2ea2a2848a8..d4d03984c74 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterResourceQuotaSelector.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterResourceQuotaSelector.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterResourceQuotaSelector is used to select projects.  At least one of LabelSelector or AnnotationSelector must present.  If only one is present, it is the only selection criteria.  If both are specified, the project must match both restrictions.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,22 +86,34 @@ public ClusterResourceQuotaSelector(Map<String, String> annotations, LabelSelect
         this.labels = labels;
     }
 
+    /**
+     * AnnotationSelector is used to select projects by annotation.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * AnnotationSelector is used to select projects by annotation.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * ClusterResourceQuotaSelector is used to select projects.  At least one of LabelSelector or AnnotationSelector must present.  If only one is present, it is the only selection criteria.  If both are specified, the project must match both restrictions.
+     */
     @JsonProperty("labels")
     public LabelSelector getLabels() {
         return labels;
     }
 
+    /**
+     * ClusterResourceQuotaSelector is used to select projects.  At least one of LabelSelector or AnnotationSelector must present.  If only one is present, it is the only selection criteria.  If both are specified, the project must match both restrictions.
+     */
     @JsonProperty("labels")
     public void setLabels(LabelSelector labels) {
         this.labels = labels;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterResourceQuotaSpec.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterResourceQuotaSpec.java
index 0575c003df2..d30abc68774 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterResourceQuotaSpec.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterResourceQuotaSpec.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterResourceQuotaSpec defines the desired quota restrictions
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public ClusterResourceQuotaSpec(ResourceQuotaSpec quota, ClusterResourceQuotaSel
         this.selector = selector;
     }
 
+    /**
+     * ClusterResourceQuotaSpec defines the desired quota restrictions
+     */
     @JsonProperty("quota")
     public ResourceQuotaSpec getQuota() {
         return quota;
     }
 
+    /**
+     * ClusterResourceQuotaSpec defines the desired quota restrictions
+     */
     @JsonProperty("quota")
     public void setQuota(ResourceQuotaSpec quota) {
         this.quota = quota;
     }
 
+    /**
+     * ClusterResourceQuotaSpec defines the desired quota restrictions
+     */
     @JsonProperty("selector")
     public ClusterResourceQuotaSelector getSelector() {
         return selector;
     }
 
+    /**
+     * ClusterResourceQuotaSpec defines the desired quota restrictions
+     */
     @JsonProperty("selector")
     public void setSelector(ClusterResourceQuotaSelector selector) {
         this.selector = selector;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterResourceQuotaStatus.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterResourceQuotaStatus.java
index 5eb9735e636..0e0cdd4e64f 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterResourceQuotaStatus.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterResourceQuotaStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterResourceQuotaStatus defines the actual enforced quota and its current usage
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,22 +89,34 @@ public ClusterResourceQuotaStatus(List<ResourceQuotaStatusByNamespace> namespace
         this.total = total;
     }
 
+    /**
+     * Namespaces slices the usage by project.  This division allows for quick resolution of deletion reconciliation inside of a single project without requiring a recalculation across all projects.  This can be used to pull the deltas for a given project.
+     */
     @JsonProperty("namespaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ResourceQuotaStatusByNamespace> getNamespaces() {
         return namespaces;
     }
 
+    /**
+     * Namespaces slices the usage by project.  This division allows for quick resolution of deletion reconciliation inside of a single project without requiring a recalculation across all projects.  This can be used to pull the deltas for a given project.
+     */
     @JsonProperty("namespaces")
     public void setNamespaces(List<ResourceQuotaStatusByNamespace> namespaces) {
         this.namespaces = namespaces;
     }
 
+    /**
+     * ClusterResourceQuotaStatus defines the actual enforced quota and its current usage
+     */
     @JsonProperty("total")
     public ResourceQuotaStatus getTotal() {
         return total;
     }
 
+    /**
+     * ClusterResourceQuotaStatus defines the actual enforced quota and its current usage
+     */
     @JsonProperty("total")
     public void setTotal(ResourceQuotaStatus total) {
         this.total = total;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterRole.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterRole.java
index bd1611e8a30..0a16968251c 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterRole.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterRole.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterRole is a logical grouping of PolicyRules that can be referenced as a unit by ClusterRoleBindings.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -80,14 +83,8 @@ public class ClusterRole implements Editable<ClusterRoleBuilder>, HasMetadata
 
     @JsonProperty("aggregationRule")
     private AggregationRule aggregationRule;
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authorization.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterRole";
     @JsonProperty("metadata")
@@ -113,18 +110,24 @@ public ClusterRole(AggregationRule aggregationRule, String apiVersion, String ki
         this.rules = rules;
     }
 
+    /**
+     * ClusterRole is a logical grouping of PolicyRules that can be referenced as a unit by ClusterRoleBindings.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("aggregationRule")
     public AggregationRule getAggregationRule() {
         return aggregationRule;
     }
 
+    /**
+     * ClusterRole is a logical grouping of PolicyRules that can be referenced as a unit by ClusterRoleBindings.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("aggregationRule")
     public void setAggregationRule(AggregationRule aggregationRule) {
         this.aggregationRule = aggregationRule;
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -132,7 +135,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -140,7 +143,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -148,29 +151,41 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterRole is a logical grouping of PolicyRules that can be referenced as a unit by ClusterRoleBindings.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterRole is a logical grouping of PolicyRules that can be referenced as a unit by ClusterRoleBindings.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Rules holds all the PolicyRules for this ClusterRole
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PolicyRule> getRules() {
         return rules;
     }
 
+    /**
+     * Rules holds all the PolicyRules for this ClusterRole
+     */
     @JsonProperty("rules")
     public void setRules(List<PolicyRule> rules) {
         this.rules = rules;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterRoleBinding.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterRoleBinding.java
index 4b2fb818a51..10417f66d65 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterRoleBinding.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterRoleBinding.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterRoleBinding references a ClusterRole, but not contain it.  It can reference any ClusterRole in the same namespace or in the global namespace. It adds who information via (Users and Groups) OR Subjects and namespace information by which namespace it exists in. ClusterRoleBindings in a given namespace only have effect in that namespace (excepting the master namespace which has power in all namespaces).<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,17 +82,11 @@
 public class ClusterRoleBinding implements Editable<ClusterRoleBindingBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authorization.openshift.io/v1";
     @JsonProperty("groupNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<String> groupNames = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterRoleBinding";
     @JsonProperty("metadata")
@@ -123,7 +120,7 @@ public ClusterRoleBinding(String apiVersion, List<String> groupNames, String kin
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -131,26 +128,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * GroupNames holds all the groups directly bound to the role. This field should only be specified when supporting legacy clients and servers. See Subjects for further details.
+     */
     @JsonProperty("groupNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getGroupNames() {
         return groupNames;
     }
 
+    /**
+     * GroupNames holds all the groups directly bound to the role. This field should only be specified when supporting legacy clients and servers. See Subjects for further details.
+     */
     @JsonProperty("groupNames")
     public void setGroupNames(List<String> groupNames) {
         this.groupNames = groupNames;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -158,50 +161,74 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterRoleBinding references a ClusterRole, but not contain it.  It can reference any ClusterRole in the same namespace or in the global namespace. It adds who information via (Users and Groups) OR Subjects and namespace information by which namespace it exists in. ClusterRoleBindings in a given namespace only have effect in that namespace (excepting the master namespace which has power in all namespaces).<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterRoleBinding references a ClusterRole, but not contain it.  It can reference any ClusterRole in the same namespace or in the global namespace. It adds who information via (Users and Groups) OR Subjects and namespace information by which namespace it exists in. ClusterRoleBindings in a given namespace only have effect in that namespace (excepting the master namespace which has power in all namespaces).<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ClusterRoleBinding references a ClusterRole, but not contain it.  It can reference any ClusterRole in the same namespace or in the global namespace. It adds who information via (Users and Groups) OR Subjects and namespace information by which namespace it exists in. ClusterRoleBindings in a given namespace only have effect in that namespace (excepting the master namespace which has power in all namespaces).<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("roleRef")
     public ObjectReference getRoleRef() {
         return roleRef;
     }
 
+    /**
+     * ClusterRoleBinding references a ClusterRole, but not contain it.  It can reference any ClusterRole in the same namespace or in the global namespace. It adds who information via (Users and Groups) OR Subjects and namespace information by which namespace it exists in. ClusterRoleBindings in a given namespace only have effect in that namespace (excepting the master namespace which has power in all namespaces).<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("roleRef")
     public void setRoleRef(ObjectReference roleRef) {
         this.roleRef = roleRef;
     }
 
+    /**
+     * Subjects hold object references to authorize with this rule. This field is ignored if UserNames or GroupNames are specified to support legacy clients and servers. Thus newer clients that do not need to support backwards compatibility should send only fully qualified Subjects and should omit the UserNames and GroupNames fields. Clients that need to support backwards compatibility can use this field to build the UserNames and GroupNames.
+     */
     @JsonProperty("subjects")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ObjectReference> getSubjects() {
         return subjects;
     }
 
+    /**
+     * Subjects hold object references to authorize with this rule. This field is ignored if UserNames or GroupNames are specified to support legacy clients and servers. Thus newer clients that do not need to support backwards compatibility should send only fully qualified Subjects and should omit the UserNames and GroupNames fields. Clients that need to support backwards compatibility can use this field to build the UserNames and GroupNames.
+     */
     @JsonProperty("subjects")
     public void setSubjects(List<ObjectReference> subjects) {
         this.subjects = subjects;
     }
 
+    /**
+     * UserNames holds all the usernames directly bound to the role. This field should only be specified when supporting legacy clients and servers. See Subjects for further details.
+     */
     @JsonProperty("userNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getUserNames() {
         return userNames;
     }
 
+    /**
+     * UserNames holds all the usernames directly bound to the role. This field should only be specified when supporting legacy clients and servers. See Subjects for further details.
+     */
     @JsonProperty("userNames")
     public void setUserNames(List<String> userNames) {
         this.userNames = userNames;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterRoleBindingList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterRoleBindingList.java
index 044eb87d45e..a97d5bcb3b6 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterRoleBindingList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterRoleBindingList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterRoleBindingList is a collection of ClusterRoleBindings<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ClusterRoleBindingList implements Editable<ClusterRoleBindingListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.ClusterRoleBinding>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authorization.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.ClusterRoleBinding> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterRoleBindingList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterRoleBindingList(String apiVersion, List<io.fabric8.openshift.api.m
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of ClusterRoleBindings
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.ClusterRoleBinding> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of ClusterRoleBindings
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.ClusterRoleBinding> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterRoleBindingList is a collection of ClusterRoleBindings<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterRoleBindingList is a collection of ClusterRoleBindings<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterRoleList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterRoleList.java
index c762c7311b7..9d30e38c2f6 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterRoleList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterRoleList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterRoleList is a collection of ClusterRoles<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ClusterRoleList implements Editable<ClusterRoleListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.ClusterRole>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authorization.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.ClusterRole> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ClusterRoleList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ClusterRoleList(String apiVersion, List<io.fabric8.openshift.api.model.Cl
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of ClusterRoles
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.ClusterRole> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of ClusterRoles
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.ClusterRole> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ClusterRoleList is a collection of ClusterRoles<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ClusterRoleList is a collection of ClusterRoles<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterRoleScopeRestriction.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterRoleScopeRestriction.java
index 0f0c781d2c3..f8dde1dc5d8 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterRoleScopeRestriction.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ClusterRoleScopeRestriction.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ClusterRoleScopeRestriction describes restrictions on cluster role scopes
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public ClusterRoleScopeRestriction(Boolean allowEscalation, List<String> namespa
         this.roleNames = roleNames;
     }
 
+    /**
+     * AllowEscalation indicates whether you can request roles and their escalating resources
+     */
     @JsonProperty("allowEscalation")
     public Boolean getAllowEscalation() {
         return allowEscalation;
     }
 
+    /**
+     * AllowEscalation indicates whether you can request roles and their escalating resources
+     */
     @JsonProperty("allowEscalation")
     public void setAllowEscalation(Boolean allowEscalation) {
         this.allowEscalation = allowEscalation;
     }
 
+    /**
+     * Namespaces is the list of namespaces that can be referenced.  &#42; means any of them (including &#42;)
+     */
     @JsonProperty("namespaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNamespaces() {
         return namespaces;
     }
 
+    /**
+     * Namespaces is the list of namespaces that can be referenced.  &#42; means any of them (including &#42;)
+     */
     @JsonProperty("namespaces")
     public void setNamespaces(List<String> namespaces) {
         this.namespaces = namespaces;
     }
 
+    /**
+     * RoleNames is the list of cluster roles that can referenced.  &#42; means anything
+     */
     @JsonProperty("roleNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getRoleNames() {
         return roleNames;
     }
 
+    /**
+     * RoleNames is the list of cluster roles that can referenced.  &#42; means anything
+     */
     @JsonProperty("roleNames")
     public void setRoleNames(List<String> roleNames) {
         this.roleNames = roleNames;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/CommonSpec.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/CommonSpec.java
index 8011332518a..0dbde0fb88f 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/CommonSpec.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/CommonSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CommonSpec encapsulates all the inputs necessary to represent a build.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -115,102 +118,162 @@ public CommonSpec(Long completionDeadlineSeconds, Boolean mountTrustedCA, Map<St
         this.strategy = strategy;
     }
 
+    /**
+     * completionDeadlineSeconds is an optional duration in seconds, counted from the time when a build pod gets scheduled in the system, that the build may be active on a node before the system actively tries to terminate the build; value must be positive integer
+     */
     @JsonProperty("completionDeadlineSeconds")
     public Long getCompletionDeadlineSeconds() {
         return completionDeadlineSeconds;
     }
 
+    /**
+     * completionDeadlineSeconds is an optional duration in seconds, counted from the time when a build pod gets scheduled in the system, that the build may be active on a node before the system actively tries to terminate the build; value must be positive integer
+     */
     @JsonProperty("completionDeadlineSeconds")
     public void setCompletionDeadlineSeconds(Long completionDeadlineSeconds) {
         this.completionDeadlineSeconds = completionDeadlineSeconds;
     }
 
+    /**
+     * mountTrustedCA bind mounts the cluster's trusted certificate authorities, as defined in the cluster's proxy configuration, into the build. This lets processes within a build trust components signed by custom PKI certificate authorities, such as private artifact repositories and HTTPS proxies.<br><p> <br><p> When this field is set to true, the contents of `/etc/pki/ca-trust` within the build are managed by the build container, and any changes to this directory or its subdirectories (for example - within a Dockerfile `RUN` instruction) are not persisted in the build's output image.
+     */
     @JsonProperty("mountTrustedCA")
     public Boolean getMountTrustedCA() {
         return mountTrustedCA;
     }
 
+    /**
+     * mountTrustedCA bind mounts the cluster's trusted certificate authorities, as defined in the cluster's proxy configuration, into the build. This lets processes within a build trust components signed by custom PKI certificate authorities, such as private artifact repositories and HTTPS proxies.<br><p> <br><p> When this field is set to true, the contents of `/etc/pki/ca-trust` within the build are managed by the build container, and any changes to this directory or its subdirectories (for example - within a Dockerfile `RUN` instruction) are not persisted in the build's output image.
+     */
     @JsonProperty("mountTrustedCA")
     public void setMountTrustedCA(Boolean mountTrustedCA) {
         this.mountTrustedCA = mountTrustedCA;
     }
 
+    /**
+     * nodeSelector is a selector which must be true for the build pod to fit on a node If nil, it can be overridden by default build nodeselector values for the cluster. If set to an empty map or a map with any values, default build nodeselector values are ignored.
+     */
     @JsonProperty("nodeSelector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getNodeSelector() {
         return nodeSelector;
     }
 
+    /**
+     * nodeSelector is a selector which must be true for the build pod to fit on a node If nil, it can be overridden by default build nodeselector values for the cluster. If set to an empty map or a map with any values, default build nodeselector values are ignored.
+     */
     @JsonProperty("nodeSelector")
     public void setNodeSelector(Map<String, String> nodeSelector) {
         this.nodeSelector = nodeSelector;
     }
 
+    /**
+     * CommonSpec encapsulates all the inputs necessary to represent a build.
+     */
     @JsonProperty("output")
     public BuildOutput getOutput() {
         return output;
     }
 
+    /**
+     * CommonSpec encapsulates all the inputs necessary to represent a build.
+     */
     @JsonProperty("output")
     public void setOutput(BuildOutput output) {
         this.output = output;
     }
 
+    /**
+     * CommonSpec encapsulates all the inputs necessary to represent a build.
+     */
     @JsonProperty("postCommit")
     public BuildPostCommitSpec getPostCommit() {
         return postCommit;
     }
 
+    /**
+     * CommonSpec encapsulates all the inputs necessary to represent a build.
+     */
     @JsonProperty("postCommit")
     public void setPostCommit(BuildPostCommitSpec postCommit) {
         this.postCommit = postCommit;
     }
 
+    /**
+     * CommonSpec encapsulates all the inputs necessary to represent a build.
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * CommonSpec encapsulates all the inputs necessary to represent a build.
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * CommonSpec encapsulates all the inputs necessary to represent a build.
+     */
     @JsonProperty("revision")
     public SourceRevision getRevision() {
         return revision;
     }
 
+    /**
+     * CommonSpec encapsulates all the inputs necessary to represent a build.
+     */
     @JsonProperty("revision")
     public void setRevision(SourceRevision revision) {
         this.revision = revision;
     }
 
+    /**
+     * serviceAccount is the name of the ServiceAccount to use to run the pod created by this build. The pod will be allowed to use secrets referenced by the ServiceAccount
+     */
     @JsonProperty("serviceAccount")
     public String getServiceAccount() {
         return serviceAccount;
     }
 
+    /**
+     * serviceAccount is the name of the ServiceAccount to use to run the pod created by this build. The pod will be allowed to use secrets referenced by the ServiceAccount
+     */
     @JsonProperty("serviceAccount")
     public void setServiceAccount(String serviceAccount) {
         this.serviceAccount = serviceAccount;
     }
 
+    /**
+     * CommonSpec encapsulates all the inputs necessary to represent a build.
+     */
     @JsonProperty("source")
     public BuildSource getSource() {
         return source;
     }
 
+    /**
+     * CommonSpec encapsulates all the inputs necessary to represent a build.
+     */
     @JsonProperty("source")
     public void setSource(BuildSource source) {
         this.source = source;
     }
 
+    /**
+     * CommonSpec encapsulates all the inputs necessary to represent a build.
+     */
     @JsonProperty("strategy")
     public BuildStrategy getStrategy() {
         return strategy;
     }
 
+    /**
+     * CommonSpec encapsulates all the inputs necessary to represent a build.
+     */
     @JsonProperty("strategy")
     public void setStrategy(BuildStrategy strategy) {
         this.strategy = strategy;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/CommonWebHookCause.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/CommonWebHookCause.java
index 597f3f5d15d..a225644d04f 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/CommonWebHookCause.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/CommonWebHookCause.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CommonWebHookCause factors out the identical format of these webhook causes into struct so we can share it in the specific causes;  it is too late for GitHub and Generic but we can leverage this pattern with GitLab and Bitbucket.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public CommonWebHookCause(SourceRevision revision, String secret) {
         this.secret = secret;
     }
 
+    /**
+     * CommonWebHookCause factors out the identical format of these webhook causes into struct so we can share it in the specific causes;  it is too late for GitHub and Generic but we can leverage this pattern with GitLab and Bitbucket.
+     */
     @JsonProperty("revision")
     public SourceRevision getRevision() {
         return revision;
     }
 
+    /**
+     * CommonWebHookCause factors out the identical format of these webhook causes into struct so we can share it in the specific causes;  it is too late for GitHub and Generic but we can leverage this pattern with GitLab and Bitbucket.
+     */
     @JsonProperty("revision")
     public void setRevision(SourceRevision revision) {
         this.revision = revision;
     }
 
+    /**
+     * Secret is the obfuscated webhook secret that triggered a build.
+     */
     @JsonProperty("secret")
     public String getSecret() {
         return secret;
     }
 
+    /**
+     * Secret is the obfuscated webhook secret that triggered a build.
+     */
     @JsonProperty("secret")
     public void setSecret(String secret) {
         this.secret = secret;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ConfigMapBuildSource.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ConfigMapBuildSource.java
index 5750cfb4766..50ca36e0ff8 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ConfigMapBuildSource.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ConfigMapBuildSource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ConfigMapBuildSource describes a configmap and its destination directory that will be used only at the build time. The content of the configmap referenced here will be copied into the destination directory instead of mounting.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ConfigMapBuildSource(LocalObjectReference configMap, String destinationDi
         this.destinationDir = destinationDir;
     }
 
+    /**
+     * ConfigMapBuildSource describes a configmap and its destination directory that will be used only at the build time. The content of the configmap referenced here will be copied into the destination directory instead of mounting.
+     */
     @JsonProperty("configMap")
     public LocalObjectReference getConfigMap() {
         return configMap;
     }
 
+    /**
+     * ConfigMapBuildSource describes a configmap and its destination directory that will be used only at the build time. The content of the configmap referenced here will be copied into the destination directory instead of mounting.
+     */
     @JsonProperty("configMap")
     public void setConfigMap(LocalObjectReference configMap) {
         this.configMap = configMap;
     }
 
+    /**
+     * destinationDir is the directory where the files from the configmap should be available for the build time. For the Source build strategy, these will be injected into a container where the assemble script runs. For the container image build strategy, these will be copied into the build directory, where the Dockerfile is located, so users can ADD or COPY them during container image build.
+     */
     @JsonProperty("destinationDir")
     public String getDestinationDir() {
         return destinationDir;
     }
 
+    /**
+     * destinationDir is the directory where the files from the configmap should be available for the build time. For the Source build strategy, these will be injected into a container where the assemble script runs. For the container image build strategy, these will be copied into the build directory, where the Dockerfile is located, so users can ADD or COPY them during container image build.
+     */
     @JsonProperty("destinationDir")
     public void setDestinationDir(String destinationDir) {
         this.destinationDir = destinationDir;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/CustomBuildStrategy.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/CustomBuildStrategy.java
index 3385a4b3fcf..dbd45f99d97 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/CustomBuildStrategy.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/CustomBuildStrategy.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomBuildStrategy defines input parameters specific to Custom build.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -106,73 +109,115 @@ public CustomBuildStrategy(String buildAPIVersion, List<EnvVar> env, Boolean exp
         this.secrets = secrets;
     }
 
+    /**
+     * buildAPIVersion is the requested API version for the Build object serialized and passed to the custom builder
+     */
     @JsonProperty("buildAPIVersion")
     public String getBuildAPIVersion() {
         return buildAPIVersion;
     }
 
+    /**
+     * buildAPIVersion is the requested API version for the Build object serialized and passed to the custom builder
+     */
     @JsonProperty("buildAPIVersion")
     public void setBuildAPIVersion(String buildAPIVersion) {
         this.buildAPIVersion = buildAPIVersion;
     }
 
+    /**
+     * env contains additional environment variables you want to pass into a builder container.
+     */
     @JsonProperty("env")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvVar> getEnv() {
         return env;
     }
 
+    /**
+     * env contains additional environment variables you want to pass into a builder container.
+     */
     @JsonProperty("env")
     public void setEnv(List<EnvVar> env) {
         this.env = env;
     }
 
+    /**
+     * exposeDockerSocket will allow running Docker commands (and build container images) from inside the container.
+     */
     @JsonProperty("exposeDockerSocket")
     public Boolean getExposeDockerSocket() {
         return exposeDockerSocket;
     }
 
+    /**
+     * exposeDockerSocket will allow running Docker commands (and build container images) from inside the container.
+     */
     @JsonProperty("exposeDockerSocket")
     public void setExposeDockerSocket(Boolean exposeDockerSocket) {
         this.exposeDockerSocket = exposeDockerSocket;
     }
 
+    /**
+     * forcePull describes if the controller should configure the build pod to always pull the images for the builder or only pull if it is not present locally
+     */
     @JsonProperty("forcePull")
     public Boolean getForcePull() {
         return forcePull;
     }
 
+    /**
+     * forcePull describes if the controller should configure the build pod to always pull the images for the builder or only pull if it is not present locally
+     */
     @JsonProperty("forcePull")
     public void setForcePull(Boolean forcePull) {
         this.forcePull = forcePull;
     }
 
+    /**
+     * CustomBuildStrategy defines input parameters specific to Custom build.
+     */
     @JsonProperty("from")
     public ObjectReference getFrom() {
         return from;
     }
 
+    /**
+     * CustomBuildStrategy defines input parameters specific to Custom build.
+     */
     @JsonProperty("from")
     public void setFrom(ObjectReference from) {
         this.from = from;
     }
 
+    /**
+     * CustomBuildStrategy defines input parameters specific to Custom build.
+     */
     @JsonProperty("pullSecret")
     public LocalObjectReference getPullSecret() {
         return pullSecret;
     }
 
+    /**
+     * CustomBuildStrategy defines input parameters specific to Custom build.
+     */
     @JsonProperty("pullSecret")
     public void setPullSecret(LocalObjectReference pullSecret) {
         this.pullSecret = pullSecret;
     }
 
+    /**
+     * secrets is a list of additional secrets that will be included in the build pod
+     */
     @JsonProperty("secrets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SecretSpec> getSecrets() {
         return secrets;
     }
 
+    /**
+     * secrets is a list of additional secrets that will be included in the build pod
+     */
     @JsonProperty("secrets")
     public void setSecrets(List<SecretSpec> secrets) {
         this.secrets = secrets;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/CustomDeploymentStrategyParams.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/CustomDeploymentStrategyParams.java
index 7c0533ca78e..3a2ad8483df 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/CustomDeploymentStrategyParams.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/CustomDeploymentStrategyParams.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * CustomDeploymentStrategyParams are the input to the Custom deployment strategy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public CustomDeploymentStrategyParams(List<String> command, List<EnvVar> environ
         this.image = image;
     }
 
+    /**
+     * Command is optional and overrides CMD in the container Image.
+     */
     @JsonProperty("command")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCommand() {
         return command;
     }
 
+    /**
+     * Command is optional and overrides CMD in the container Image.
+     */
     @JsonProperty("command")
     public void setCommand(List<String> command) {
         this.command = command;
     }
 
+    /**
+     * Environment holds the environment which will be given to the container for Image.
+     */
     @JsonProperty("environment")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvVar> getEnvironment() {
         return environment;
     }
 
+    /**
+     * Environment holds the environment which will be given to the container for Image.
+     */
     @JsonProperty("environment")
     public void setEnvironment(List<EnvVar> environment) {
         this.environment = environment;
     }
 
+    /**
+     * Image specifies a container image which can carry out a deployment.
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * Image specifies a container image which can carry out a deployment.
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentCause.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentCause.java
index 8e9ea8fa85e..1f0975484fd 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentCause.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentCause.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeploymentCause captures information about a particular cause of a deployment.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public DeploymentCause(DeploymentCauseImageTrigger imageTrigger, String type) {
         this.type = type;
     }
 
+    /**
+     * DeploymentCause captures information about a particular cause of a deployment.
+     */
     @JsonProperty("imageTrigger")
     public DeploymentCauseImageTrigger getImageTrigger() {
         return imageTrigger;
     }
 
+    /**
+     * DeploymentCause captures information about a particular cause of a deployment.
+     */
     @JsonProperty("imageTrigger")
     public void setImageTrigger(DeploymentCauseImageTrigger imageTrigger) {
         this.imageTrigger = imageTrigger;
     }
 
+    /**
+     * Type of the trigger that resulted in the creation of a new deployment
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of the trigger that resulted in the creation of a new deployment
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentCauseImageTrigger.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentCauseImageTrigger.java
index bad7377adf5..c47b91649c0 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentCauseImageTrigger.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentCauseImageTrigger.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeploymentCauseImageTrigger represents details about the cause of a deployment originating from an image change trigger
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public DeploymentCauseImageTrigger(ObjectReference from) {
         this.from = from;
     }
 
+    /**
+     * DeploymentCauseImageTrigger represents details about the cause of a deployment originating from an image change trigger
+     */
     @JsonProperty("from")
     public ObjectReference getFrom() {
         return from;
     }
 
+    /**
+     * DeploymentCauseImageTrigger represents details about the cause of a deployment originating from an image change trigger
+     */
     @JsonProperty("from")
     public void setFrom(ObjectReference from) {
         this.from = from;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentCondition.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentCondition.java
index a574fef76d0..a1b65d8956f 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentCondition.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeploymentCondition describes the state of a deployment config at a certain point.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public DeploymentCondition(String lastTransitionTime, String lastUpdateTime, Str
         this.type = type;
     }
 
+    /**
+     * DeploymentCondition describes the state of a deployment config at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * DeploymentCondition describes the state of a deployment config at a certain point.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * DeploymentCondition describes the state of a deployment config at a certain point.
+     */
     @JsonProperty("lastUpdateTime")
     public String getLastUpdateTime() {
         return lastUpdateTime;
     }
 
+    /**
+     * DeploymentCondition describes the state of a deployment config at a certain point.
+     */
     @JsonProperty("lastUpdateTime")
     public void setLastUpdateTime(String lastUpdateTime) {
         this.lastUpdateTime = lastUpdateTime;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * A human readable message indicating details about the transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * The reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type of deployment condition.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of deployment condition.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentConfig.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentConfig.java
index 60abf21be87..e80a2a22690 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentConfig.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentConfig.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Deployment Configs define the template for a pod and manages deploying new images or configuration changes. A single deployment configuration is usually analogous to a single micro-service. Can support many different deployment patterns, including full restart, customizable rolling updates, and  fully custom behaviors, as well as pre- and post- deployment hooks. Each individual deployment is represented as a replication controller.<br><p> <br><p> A deployment is "triggered" when its configuration is changed or a tag in an Image Stream is changed. Triggers can be disabled to allow manual control over a deployment. The "strategy" determines how the deployment is carried out and may be changed at any time. The `latestVersion` field is updated when a new deployment is triggered by any means.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer). Deprecated: Use deployments or other means for declarative updates for pods instead.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class DeploymentConfig implements Editable<DeploymentConfigBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apps.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DeploymentConfig";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DeploymentConfig(String apiVersion, String kind, ObjectMeta metadata, Dep
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Deployment Configs define the template for a pod and manages deploying new images or configuration changes. A single deployment configuration is usually analogous to a single micro-service. Can support many different deployment patterns, including full restart, customizable rolling updates, and  fully custom behaviors, as well as pre- and post- deployment hooks. Each individual deployment is represented as a replication controller.<br><p> <br><p> A deployment is "triggered" when its configuration is changed or a tag in an Image Stream is changed. Triggers can be disabled to allow manual control over a deployment. The "strategy" determines how the deployment is carried out and may be changed at any time. The `latestVersion` field is updated when a new deployment is triggered by any means.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer). Deprecated: Use deployments or other means for declarative updates for pods instead.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Deployment Configs define the template for a pod and manages deploying new images or configuration changes. A single deployment configuration is usually analogous to a single micro-service. Can support many different deployment patterns, including full restart, customizable rolling updates, and  fully custom behaviors, as well as pre- and post- deployment hooks. Each individual deployment is represented as a replication controller.<br><p> <br><p> A deployment is "triggered" when its configuration is changed or a tag in an Image Stream is changed. Triggers can be disabled to allow manual control over a deployment. The "strategy" determines how the deployment is carried out and may be changed at any time. The `latestVersion` field is updated when a new deployment is triggered by any means.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer). Deprecated: Use deployments or other means for declarative updates for pods instead.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Deployment Configs define the template for a pod and manages deploying new images or configuration changes. A single deployment configuration is usually analogous to a single micro-service. Can support many different deployment patterns, including full restart, customizable rolling updates, and  fully custom behaviors, as well as pre- and post- deployment hooks. Each individual deployment is represented as a replication controller.<br><p> <br><p> A deployment is "triggered" when its configuration is changed or a tag in an Image Stream is changed. Triggers can be disabled to allow manual control over a deployment. The "strategy" determines how the deployment is carried out and may be changed at any time. The `latestVersion` field is updated when a new deployment is triggered by any means.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer). Deprecated: Use deployments or other means for declarative updates for pods instead.
+     */
     @JsonProperty("spec")
     public DeploymentConfigSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Deployment Configs define the template for a pod and manages deploying new images or configuration changes. A single deployment configuration is usually analogous to a single micro-service. Can support many different deployment patterns, including full restart, customizable rolling updates, and  fully custom behaviors, as well as pre- and post- deployment hooks. Each individual deployment is represented as a replication controller.<br><p> <br><p> A deployment is "triggered" when its configuration is changed or a tag in an Image Stream is changed. Triggers can be disabled to allow manual control over a deployment. The "strategy" determines how the deployment is carried out and may be changed at any time. The `latestVersion` field is updated when a new deployment is triggered by any means.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer). Deprecated: Use deployments or other means for declarative updates for pods instead.
+     */
     @JsonProperty("spec")
     public void setSpec(DeploymentConfigSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Deployment Configs define the template for a pod and manages deploying new images or configuration changes. A single deployment configuration is usually analogous to a single micro-service. Can support many different deployment patterns, including full restart, customizable rolling updates, and  fully custom behaviors, as well as pre- and post- deployment hooks. Each individual deployment is represented as a replication controller.<br><p> <br><p> A deployment is "triggered" when its configuration is changed or a tag in an Image Stream is changed. Triggers can be disabled to allow manual control over a deployment. The "strategy" determines how the deployment is carried out and may be changed at any time. The `latestVersion` field is updated when a new deployment is triggered by any means.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer). Deprecated: Use deployments or other means for declarative updates for pods instead.
+     */
     @JsonProperty("status")
     public DeploymentConfigStatus getStatus() {
         return status;
     }
 
+    /**
+     * Deployment Configs define the template for a pod and manages deploying new images or configuration changes. A single deployment configuration is usually analogous to a single micro-service. Can support many different deployment patterns, including full restart, customizable rolling updates, and  fully custom behaviors, as well as pre- and post- deployment hooks. Each individual deployment is represented as a replication controller.<br><p> <br><p> A deployment is "triggered" when its configuration is changed or a tag in an Image Stream is changed. Triggers can be disabled to allow manual control over a deployment. The "strategy" determines how the deployment is carried out and may be changed at any time. The `latestVersion` field is updated when a new deployment is triggered by any means.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer). Deprecated: Use deployments or other means for declarative updates for pods instead.
+     */
     @JsonProperty("status")
     public void setStatus(DeploymentConfigStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentConfigList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentConfigList.java
index 19c03905811..e9092eadef9 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentConfigList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentConfigList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeploymentConfigList is a collection of deployment configs.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class DeploymentConfigList implements Editable<DeploymentConfigListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.DeploymentConfig>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apps.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.DeploymentConfig> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DeploymentConfigList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public DeploymentConfigList(String apiVersion, List<io.fabric8.openshift.api.mod
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of deployment configs
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.DeploymentConfig> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of deployment configs
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.DeploymentConfig> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * DeploymentConfigList is a collection of deployment configs.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * DeploymentConfigList is a collection of deployment configs.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentConfigRollback.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentConfigRollback.java
index 6e398ce6f75..3f4b27b878a 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentConfigRollback.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentConfigRollback.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeploymentConfigRollback provides the input to rollback generation.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class DeploymentConfigRollback implements Editable<DeploymentConfigRollbackBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apps.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DeploymentConfigRollback";
     @JsonProperty("name")
@@ -112,7 +109,7 @@ public DeploymentConfigRollback(String apiVersion, String kind, String name, Dep
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -120,7 +117,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -128,7 +125,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -136,39 +133,57 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Name of the deployment config that will be rolled back.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the deployment config that will be rolled back.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * DeploymentConfigRollback provides the input to rollback generation.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public DeploymentConfigRollbackSpec getSpec() {
         return spec;
     }
 
+    /**
+     * DeploymentConfigRollback provides the input to rollback generation.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(DeploymentConfigRollbackSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * UpdatedAnnotations is a set of new annotations that will be added in the deployment config.
+     */
     @JsonProperty("updatedAnnotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getUpdatedAnnotations() {
         return updatedAnnotations;
     }
 
+    /**
+     * UpdatedAnnotations is a set of new annotations that will be added in the deployment config.
+     */
     @JsonProperty("updatedAnnotations")
     public void setUpdatedAnnotations(Map<String, String> updatedAnnotations) {
         this.updatedAnnotations = updatedAnnotations;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentConfigRollbackSpec.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentConfigRollbackSpec.java
index d6c107031b9..eef526e38af 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentConfigRollbackSpec.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentConfigRollbackSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeploymentConfigRollbackSpec represents the options for rollback generation.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public DeploymentConfigRollbackSpec(ObjectReference from, Boolean includeReplica
         this.revision = revision;
     }
 
+    /**
+     * DeploymentConfigRollbackSpec represents the options for rollback generation.
+     */
     @JsonProperty("from")
     public ObjectReference getFrom() {
         return from;
     }
 
+    /**
+     * DeploymentConfigRollbackSpec represents the options for rollback generation.
+     */
     @JsonProperty("from")
     public void setFrom(ObjectReference from) {
         this.from = from;
     }
 
+    /**
+     * IncludeReplicationMeta specifies whether to include the replica count and selector.
+     */
     @JsonProperty("includeReplicationMeta")
     public Boolean getIncludeReplicationMeta() {
         return includeReplicationMeta;
     }
 
+    /**
+     * IncludeReplicationMeta specifies whether to include the replica count and selector.
+     */
     @JsonProperty("includeReplicationMeta")
     public void setIncludeReplicationMeta(Boolean includeReplicationMeta) {
         this.includeReplicationMeta = includeReplicationMeta;
     }
 
+    /**
+     * IncludeStrategy specifies whether to include the deployment Strategy.
+     */
     @JsonProperty("includeStrategy")
     public Boolean getIncludeStrategy() {
         return includeStrategy;
     }
 
+    /**
+     * IncludeStrategy specifies whether to include the deployment Strategy.
+     */
     @JsonProperty("includeStrategy")
     public void setIncludeStrategy(Boolean includeStrategy) {
         this.includeStrategy = includeStrategy;
     }
 
+    /**
+     * IncludeTemplate specifies whether to include the PodTemplateSpec.
+     */
     @JsonProperty("includeTemplate")
     public Boolean getIncludeTemplate() {
         return includeTemplate;
     }
 
+    /**
+     * IncludeTemplate specifies whether to include the PodTemplateSpec.
+     */
     @JsonProperty("includeTemplate")
     public void setIncludeTemplate(Boolean includeTemplate) {
         this.includeTemplate = includeTemplate;
     }
 
+    /**
+     * IncludeTriggers specifies whether to include config Triggers.
+     */
     @JsonProperty("includeTriggers")
     public Boolean getIncludeTriggers() {
         return includeTriggers;
     }
 
+    /**
+     * IncludeTriggers specifies whether to include config Triggers.
+     */
     @JsonProperty("includeTriggers")
     public void setIncludeTriggers(Boolean includeTriggers) {
         this.includeTriggers = includeTriggers;
     }
 
+    /**
+     * Revision to rollback to. If set to 0, rollback to the last revision.
+     */
     @JsonProperty("revision")
     public Long getRevision() {
         return revision;
     }
 
+    /**
+     * Revision to rollback to. If set to 0, rollback to the last revision.
+     */
     @JsonProperty("revision")
     public void setRevision(Long revision) {
         this.revision = revision;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentConfigSpec.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentConfigSpec.java
index d124cbc7ee6..e200f3ab16d 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentConfigSpec.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentConfigSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeploymentConfigSpec represents the desired state of the deployment.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -114,93 +117,147 @@ public DeploymentConfigSpec(Integer minReadySeconds, Boolean paused, Integer rep
         this.triggers = triggers;
     }
 
+    /**
+     * MinReadySeconds is the minimum number of seconds for which a newly created pod should be ready without any of its container crashing, for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready)
+     */
     @JsonProperty("minReadySeconds")
     public Integer getMinReadySeconds() {
         return minReadySeconds;
     }
 
+    /**
+     * MinReadySeconds is the minimum number of seconds for which a newly created pod should be ready without any of its container crashing, for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready)
+     */
     @JsonProperty("minReadySeconds")
     public void setMinReadySeconds(Integer minReadySeconds) {
         this.minReadySeconds = minReadySeconds;
     }
 
+    /**
+     * Paused indicates that the deployment config is paused resulting in no new deployments on template changes or changes in the template caused by other triggers.
+     */
     @JsonProperty("paused")
     public Boolean getPaused() {
         return paused;
     }
 
+    /**
+     * Paused indicates that the deployment config is paused resulting in no new deployments on template changes or changes in the template caused by other triggers.
+     */
     @JsonProperty("paused")
     public void setPaused(Boolean paused) {
         this.paused = paused;
     }
 
+    /**
+     * Replicas is the number of desired replicas.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Replicas is the number of desired replicas.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * RevisionHistoryLimit is the number of old ReplicationControllers to retain to allow for rollbacks. This field is a pointer to allow for differentiation between an explicit zero and not specified. Defaults to 10. (This only applies to DeploymentConfigs created via the new group API resource, not the legacy resource.)
+     */
     @JsonProperty("revisionHistoryLimit")
     public Integer getRevisionHistoryLimit() {
         return revisionHistoryLimit;
     }
 
+    /**
+     * RevisionHistoryLimit is the number of old ReplicationControllers to retain to allow for rollbacks. This field is a pointer to allow for differentiation between an explicit zero and not specified. Defaults to 10. (This only applies to DeploymentConfigs created via the new group API resource, not the legacy resource.)
+     */
     @JsonProperty("revisionHistoryLimit")
     public void setRevisionHistoryLimit(Integer revisionHistoryLimit) {
         this.revisionHistoryLimit = revisionHistoryLimit;
     }
 
+    /**
+     * Selector is a label query over pods that should match the Replicas count.
+     */
     @JsonProperty("selector")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getSelector() {
         return selector;
     }
 
+    /**
+     * Selector is a label query over pods that should match the Replicas count.
+     */
     @JsonProperty("selector")
     public void setSelector(Map<String, String> selector) {
         this.selector = selector;
     }
 
+    /**
+     * DeploymentConfigSpec represents the desired state of the deployment.
+     */
     @JsonProperty("strategy")
     public DeploymentStrategy getStrategy() {
         return strategy;
     }
 
+    /**
+     * DeploymentConfigSpec represents the desired state of the deployment.
+     */
     @JsonProperty("strategy")
     public void setStrategy(DeploymentStrategy strategy) {
         this.strategy = strategy;
     }
 
+    /**
+     * DeploymentConfigSpec represents the desired state of the deployment.
+     */
     @JsonProperty("template")
     public PodTemplateSpec getTemplate() {
         return template;
     }
 
+    /**
+     * DeploymentConfigSpec represents the desired state of the deployment.
+     */
     @JsonProperty("template")
     public void setTemplate(PodTemplateSpec template) {
         this.template = template;
     }
 
+    /**
+     * Test ensures that this deployment config will have zero replicas except while a deployment is running. This allows the deployment config to be used as a continuous deployment test - triggering on images, running the deployment, and then succeeding or failing. Post strategy hooks and After actions can be used to integrate successful deployment with an action.
+     */
     @JsonProperty("test")
     public Boolean getTest() {
         return test;
     }
 
+    /**
+     * Test ensures that this deployment config will have zero replicas except while a deployment is running. This allows the deployment config to be used as a continuous deployment test - triggering on images, running the deployment, and then succeeding or failing. Post strategy hooks and After actions can be used to integrate successful deployment with an action.
+     */
     @JsonProperty("test")
     public void setTest(Boolean test) {
         this.test = test;
     }
 
+    /**
+     * Triggers determine how updates to a DeploymentConfig result in new deployments. If no triggers are defined, a new deployment can only occur as a result of an explicit client update to the DeploymentConfig with a new LatestVersion. If null, defaults to having a config change trigger.
+     */
     @JsonProperty("triggers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DeploymentTriggerPolicy> getTriggers() {
         return triggers;
     }
 
+    /**
+     * Triggers determine how updates to a DeploymentConfig result in new deployments. If no triggers are defined, a new deployment can only occur as a result of an explicit client update to the DeploymentConfig with a new LatestVersion. If null, defaults to having a config change trigger.
+     */
     @JsonProperty("triggers")
     public void setTriggers(List<DeploymentTriggerPolicy> triggers) {
         this.triggers = triggers;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentConfigStatus.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentConfigStatus.java
index 862b61076df..0dd60e27ce8 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentConfigStatus.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentConfigStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeploymentConfigStatus represents the current deployment state.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -113,92 +116,146 @@ public DeploymentConfigStatus(Integer availableReplicas, List<DeploymentConditio
         this.updatedReplicas = updatedReplicas;
     }
 
+    /**
+     * AvailableReplicas is the total number of available pods targeted by this deployment config.
+     */
     @JsonProperty("availableReplicas")
     public Integer getAvailableReplicas() {
         return availableReplicas;
     }
 
+    /**
+     * AvailableReplicas is the total number of available pods targeted by this deployment config.
+     */
     @JsonProperty("availableReplicas")
     public void setAvailableReplicas(Integer availableReplicas) {
         this.availableReplicas = availableReplicas;
     }
 
+    /**
+     * Conditions represents the latest available observations of a deployment config's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DeploymentCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions represents the latest available observations of a deployment config's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<DeploymentCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * DeploymentConfigStatus represents the current deployment state.
+     */
     @JsonProperty("details")
     public DeploymentDetails getDetails() {
         return details;
     }
 
+    /**
+     * DeploymentConfigStatus represents the current deployment state.
+     */
     @JsonProperty("details")
     public void setDetails(DeploymentDetails details) {
         this.details = details;
     }
 
+    /**
+     * LatestVersion is used to determine whether the current deployment associated with a deployment config is out of sync.
+     */
     @JsonProperty("latestVersion")
     public Long getLatestVersion() {
         return latestVersion;
     }
 
+    /**
+     * LatestVersion is used to determine whether the current deployment associated with a deployment config is out of sync.
+     */
     @JsonProperty("latestVersion")
     public void setLatestVersion(Long latestVersion) {
         this.latestVersion = latestVersion;
     }
 
+    /**
+     * ObservedGeneration is the most recent generation observed by the deployment config controller.
+     */
     @JsonProperty("observedGeneration")
     public Long getObservedGeneration() {
         return observedGeneration;
     }
 
+    /**
+     * ObservedGeneration is the most recent generation observed by the deployment config controller.
+     */
     @JsonProperty("observedGeneration")
     public void setObservedGeneration(Long observedGeneration) {
         this.observedGeneration = observedGeneration;
     }
 
+    /**
+     * Total number of ready pods targeted by this deployment.
+     */
     @JsonProperty("readyReplicas")
     public Integer getReadyReplicas() {
         return readyReplicas;
     }
 
+    /**
+     * Total number of ready pods targeted by this deployment.
+     */
     @JsonProperty("readyReplicas")
     public void setReadyReplicas(Integer readyReplicas) {
         this.readyReplicas = readyReplicas;
     }
 
+    /**
+     * Replicas is the total number of pods targeted by this deployment config.
+     */
     @JsonProperty("replicas")
     public Integer getReplicas() {
         return replicas;
     }
 
+    /**
+     * Replicas is the total number of pods targeted by this deployment config.
+     */
     @JsonProperty("replicas")
     public void setReplicas(Integer replicas) {
         this.replicas = replicas;
     }
 
+    /**
+     * UnavailableReplicas is the total number of unavailable pods targeted by this deployment config.
+     */
     @JsonProperty("unavailableReplicas")
     public Integer getUnavailableReplicas() {
         return unavailableReplicas;
     }
 
+    /**
+     * UnavailableReplicas is the total number of unavailable pods targeted by this deployment config.
+     */
     @JsonProperty("unavailableReplicas")
     public void setUnavailableReplicas(Integer unavailableReplicas) {
         this.unavailableReplicas = unavailableReplicas;
     }
 
+    /**
+     * UpdatedReplicas is the total number of non-terminated pods targeted by this deployment config that have the desired template spec.
+     */
     @JsonProperty("updatedReplicas")
     public Integer getUpdatedReplicas() {
         return updatedReplicas;
     }
 
+    /**
+     * UpdatedReplicas is the total number of non-terminated pods targeted by this deployment config that have the desired template spec.
+     */
     @JsonProperty("updatedReplicas")
     public void setUpdatedReplicas(Integer updatedReplicas) {
         this.updatedReplicas = updatedReplicas;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentDetails.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentDetails.java
index 58d3a8e30fc..edfcba00a11 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentDetails.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentDetails.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeploymentDetails captures information about the causes of a deployment.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public DeploymentDetails(List<DeploymentCause> causes, String message) {
         this.message = message;
     }
 
+    /**
+     * Causes are extended data associated with all the causes for creating a new deployment
+     */
     @JsonProperty("causes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<DeploymentCause> getCauses() {
         return causes;
     }
 
+    /**
+     * Causes are extended data associated with all the causes for creating a new deployment
+     */
     @JsonProperty("causes")
     public void setCauses(List<DeploymentCause> causes) {
         this.causes = causes;
     }
 
+    /**
+     * Message is the user specified change message, if this deployment was triggered manually by the user
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message is the user specified change message, if this deployment was triggered manually by the user
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentLog.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentLog.java
index e7846f73138..b987a92ea9b 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentLog.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentLog.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeploymentLog represents the logs for a deployment<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -73,14 +76,8 @@
 public class DeploymentLog implements Editable<DeploymentLogBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apps.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DeploymentLog";
     @JsonIgnore
@@ -99,7 +96,7 @@ public DeploymentLog(String apiVersion, String kind) {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -107,7 +104,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -115,7 +112,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -123,7 +120,7 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentLogOptions.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentLogOptions.java
index c7984b0bcbd..e52f283d530 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentLogOptions.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentLogOptions.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeploymentLogOptions is the REST options for a deployment log<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,18 +86,12 @@
 public class DeploymentLogOptions implements Editable<DeploymentLogOptionsBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apps.openshift.io/v1";
     @JsonProperty("container")
     private String container;
     @JsonProperty("follow")
     private Boolean follow;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DeploymentLogOptions";
     @JsonProperty("limitBytes")
@@ -139,7 +136,7 @@ public DeploymentLogOptions(String apiVersion, String container, Boolean follow,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -147,35 +144,47 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * The container for which to stream logs. Defaults to only container if there is one container in the pod.
+     */
     @JsonProperty("container")
     public String getContainer() {
         return container;
     }
 
+    /**
+     * The container for which to stream logs. Defaults to only container if there is one container in the pod.
+     */
     @JsonProperty("container")
     public void setContainer(String container) {
         this.container = container;
     }
 
+    /**
+     * Follow if true indicates that the build log should be streamed until the build terminates.
+     */
     @JsonProperty("follow")
     public Boolean getFollow() {
         return follow;
     }
 
+    /**
+     * Follow if true indicates that the build log should be streamed until the build terminates.
+     */
     @JsonProperty("follow")
     public void setFollow(Boolean follow) {
         this.follow = follow;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -183,88 +192,136 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * If set, the number of bytes to read from the server before terminating the log output. This may not display a complete final line of logging, and may return slightly more or slightly less than the specified limit.
+     */
     @JsonProperty("limitBytes")
     public Long getLimitBytes() {
         return limitBytes;
     }
 
+    /**
+     * If set, the number of bytes to read from the server before terminating the log output. This may not display a complete final line of logging, and may return slightly more or slightly less than the specified limit.
+     */
     @JsonProperty("limitBytes")
     public void setLimitBytes(Long limitBytes) {
         this.limitBytes = limitBytes;
     }
 
+    /**
+     * NoWait if true causes the call to return immediately even if the deployment is not available yet. Otherwise the server will wait until the deployment has started.
+     */
     @JsonProperty("nowait")
     public Boolean getNowait() {
         return nowait;
     }
 
+    /**
+     * NoWait if true causes the call to return immediately even if the deployment is not available yet. Otherwise the server will wait until the deployment has started.
+     */
     @JsonProperty("nowait")
     public void setNowait(Boolean nowait) {
         this.nowait = nowait;
     }
 
+    /**
+     * Return previous deployment logs. Defaults to false.
+     */
     @JsonProperty("previous")
     public Boolean getPrevious() {
         return previous;
     }
 
+    /**
+     * Return previous deployment logs. Defaults to false.
+     */
     @JsonProperty("previous")
     public void setPrevious(Boolean previous) {
         this.previous = previous;
     }
 
+    /**
+     * A relative time in seconds before the current time from which to show logs. If this value precedes the time a pod was started, only logs since the pod start will be returned. If this value is in the future, no logs will be returned. Only one of sinceSeconds or sinceTime may be specified.
+     */
     @JsonProperty("sinceSeconds")
     public Long getSinceSeconds() {
         return sinceSeconds;
     }
 
+    /**
+     * A relative time in seconds before the current time from which to show logs. If this value precedes the time a pod was started, only logs since the pod start will be returned. If this value is in the future, no logs will be returned. Only one of sinceSeconds or sinceTime may be specified.
+     */
     @JsonProperty("sinceSeconds")
     public void setSinceSeconds(Long sinceSeconds) {
         this.sinceSeconds = sinceSeconds;
     }
 
+    /**
+     * DeploymentLogOptions is the REST options for a deployment log<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("sinceTime")
     public String getSinceTime() {
         return sinceTime;
     }
 
+    /**
+     * DeploymentLogOptions is the REST options for a deployment log<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("sinceTime")
     public void setSinceTime(String sinceTime) {
         this.sinceTime = sinceTime;
     }
 
+    /**
+     * If set, the number of lines from the end of the logs to show. If not specified, logs are shown from the creation of the container or sinceSeconds or sinceTime
+     */
     @JsonProperty("tailLines")
     public Long getTailLines() {
         return tailLines;
     }
 
+    /**
+     * If set, the number of lines from the end of the logs to show. If not specified, logs are shown from the creation of the container or sinceSeconds or sinceTime
+     */
     @JsonProperty("tailLines")
     public void setTailLines(Long tailLines) {
         this.tailLines = tailLines;
     }
 
+    /**
+     * If true, add an RFC3339 or RFC3339Nano timestamp at the beginning of every line of log output. Defaults to false.
+     */
     @JsonProperty("timestamps")
     public Boolean getTimestamps() {
         return timestamps;
     }
 
+    /**
+     * If true, add an RFC3339 or RFC3339Nano timestamp at the beginning of every line of log output. Defaults to false.
+     */
     @JsonProperty("timestamps")
     public void setTimestamps(Boolean timestamps) {
         this.timestamps = timestamps;
     }
 
+    /**
+     * Version of the deployment for which to view logs.
+     */
     @JsonProperty("version")
     public Long getVersion() {
         return version;
     }
 
+    /**
+     * Version of the deployment for which to view logs.
+     */
     @JsonProperty("version")
     public void setVersion(Long version) {
         this.version = version;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentRequest.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentRequest.java
index 9fd9544d87d..b5619356f70 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentRequest.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentRequest.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeploymentRequest is a request to a deployment config for a new deployment.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,9 +82,6 @@
 public class DeploymentRequest implements Editable<DeploymentRequestBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "apps.openshift.io/v1";
     @JsonProperty("excludeTriggers")
@@ -89,9 +89,6 @@ public class DeploymentRequest implements Editable<DeploymentRequestBuilder>, Ku
     private List<String> excludeTriggers = new ArrayList<>();
     @JsonProperty("force")
     private Boolean force;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "DeploymentRequest";
     @JsonProperty("latest")
@@ -118,7 +115,7 @@ public DeploymentRequest(String apiVersion, List<String> excludeTriggers, Boolea
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -126,36 +123,48 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ExcludeTriggers instructs the instantiator to avoid processing the specified triggers. This field overrides the triggers from latest and allows clients to control specific logic. This field is ignored if not specified.
+     */
     @JsonProperty("excludeTriggers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getExcludeTriggers() {
         return excludeTriggers;
     }
 
+    /**
+     * ExcludeTriggers instructs the instantiator to avoid processing the specified triggers. This field overrides the triggers from latest and allows clients to control specific logic. This field is ignored if not specified.
+     */
     @JsonProperty("excludeTriggers")
     public void setExcludeTriggers(List<String> excludeTriggers) {
         this.excludeTriggers = excludeTriggers;
     }
 
+    /**
+     * Force will try to force a new deployment to run. If the deployment config is paused, then setting this to true will return an Invalid error.
+     */
     @JsonProperty("force")
     public Boolean getForce() {
         return force;
     }
 
+    /**
+     * Force will try to force a new deployment to run. If the deployment config is paused, then setting this to true will return an Invalid error.
+     */
     @JsonProperty("force")
     public void setForce(Boolean force) {
         this.force = force;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -163,28 +172,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Latest will update the deployment config with the latest state from all triggers.
+     */
     @JsonProperty("latest")
     public Boolean getLatest() {
         return latest;
     }
 
+    /**
+     * Latest will update the deployment config with the latest state from all triggers.
+     */
     @JsonProperty("latest")
     public void setLatest(Boolean latest) {
         this.latest = latest;
     }
 
+    /**
+     * Name of the deployment config for requesting a new deployment.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the deployment config for requesting a new deployment.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentStrategy.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentStrategy.java
index 018eae1dcc0..50323be2d92 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentStrategy.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentStrategy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeploymentStrategy describes how to perform a deployment.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -108,83 +111,131 @@ public DeploymentStrategy(Long activeDeadlineSeconds, Map<String, String> annota
         this.type = type;
     }
 
+    /**
+     * ActiveDeadlineSeconds is the duration in seconds that the deployer pods for this deployment config may be active on a node before the system actively tries to terminate them.
+     */
     @JsonProperty("activeDeadlineSeconds")
     public Long getActiveDeadlineSeconds() {
         return activeDeadlineSeconds;
     }
 
+    /**
+     * ActiveDeadlineSeconds is the duration in seconds that the deployer pods for this deployment config may be active on a node before the system actively tries to terminate them.
+     */
     @JsonProperty("activeDeadlineSeconds")
     public void setActiveDeadlineSeconds(Long activeDeadlineSeconds) {
         this.activeDeadlineSeconds = activeDeadlineSeconds;
     }
 
+    /**
+     * Annotations is a set of key, value pairs added to custom deployer and lifecycle pre/post hook pods.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Annotations is a set of key, value pairs added to custom deployer and lifecycle pre/post hook pods.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * DeploymentStrategy describes how to perform a deployment.
+     */
     @JsonProperty("customParams")
     public CustomDeploymentStrategyParams getCustomParams() {
         return customParams;
     }
 
+    /**
+     * DeploymentStrategy describes how to perform a deployment.
+     */
     @JsonProperty("customParams")
     public void setCustomParams(CustomDeploymentStrategyParams customParams) {
         this.customParams = customParams;
     }
 
+    /**
+     * Labels is a set of key, value pairs added to custom deployer and lifecycle pre/post hook pods.
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabels() {
         return labels;
     }
 
+    /**
+     * Labels is a set of key, value pairs added to custom deployer and lifecycle pre/post hook pods.
+     */
     @JsonProperty("labels")
     public void setLabels(Map<String, String> labels) {
         this.labels = labels;
     }
 
+    /**
+     * DeploymentStrategy describes how to perform a deployment.
+     */
     @JsonProperty("recreateParams")
     public RecreateDeploymentStrategyParams getRecreateParams() {
         return recreateParams;
     }
 
+    /**
+     * DeploymentStrategy describes how to perform a deployment.
+     */
     @JsonProperty("recreateParams")
     public void setRecreateParams(RecreateDeploymentStrategyParams recreateParams) {
         this.recreateParams = recreateParams;
     }
 
+    /**
+     * DeploymentStrategy describes how to perform a deployment.
+     */
     @JsonProperty("resources")
     public ResourceRequirements getResources() {
         return resources;
     }
 
+    /**
+     * DeploymentStrategy describes how to perform a deployment.
+     */
     @JsonProperty("resources")
     public void setResources(ResourceRequirements resources) {
         this.resources = resources;
     }
 
+    /**
+     * DeploymentStrategy describes how to perform a deployment.
+     */
     @JsonProperty("rollingParams")
     public RollingDeploymentStrategyParams getRollingParams() {
         return rollingParams;
     }
 
+    /**
+     * DeploymentStrategy describes how to perform a deployment.
+     */
     @JsonProperty("rollingParams")
     public void setRollingParams(RollingDeploymentStrategyParams rollingParams) {
         this.rollingParams = rollingParams;
     }
 
+    /**
+     * Type is the name of a deployment strategy.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the name of a deployment strategy.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentTriggerImageChangeParams.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentTriggerImageChangeParams.java
index 610af4a0022..7c040ff4e69 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentTriggerImageChangeParams.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentTriggerImageChangeParams.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeploymentTriggerImageChangeParams represents the parameters to the ImageChange trigger.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public DeploymentTriggerImageChangeParams(Boolean automatic, List<String> contai
         this.lastTriggeredImage = lastTriggeredImage;
     }
 
+    /**
+     * Automatic means that the detection of a new tag value should result in an image update inside the pod template.
+     */
     @JsonProperty("automatic")
     public Boolean getAutomatic() {
         return automatic;
     }
 
+    /**
+     * Automatic means that the detection of a new tag value should result in an image update inside the pod template.
+     */
     @JsonProperty("automatic")
     public void setAutomatic(Boolean automatic) {
         this.automatic = automatic;
     }
 
+    /**
+     * ContainerNames is used to restrict tag updates to the specified set of container names in a pod. If multiple triggers point to the same containers, the resulting behavior is undefined. Future API versions will make this a validation error. If ContainerNames does not point to a valid container, the trigger will be ignored. Future API versions will make this a validation error.
+     */
     @JsonProperty("containerNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getContainerNames() {
         return containerNames;
     }
 
+    /**
+     * ContainerNames is used to restrict tag updates to the specified set of container names in a pod. If multiple triggers point to the same containers, the resulting behavior is undefined. Future API versions will make this a validation error. If ContainerNames does not point to a valid container, the trigger will be ignored. Future API versions will make this a validation error.
+     */
     @JsonProperty("containerNames")
     public void setContainerNames(List<String> containerNames) {
         this.containerNames = containerNames;
     }
 
+    /**
+     * DeploymentTriggerImageChangeParams represents the parameters to the ImageChange trigger.
+     */
     @JsonProperty("from")
     public ObjectReference getFrom() {
         return from;
     }
 
+    /**
+     * DeploymentTriggerImageChangeParams represents the parameters to the ImageChange trigger.
+     */
     @JsonProperty("from")
     public void setFrom(ObjectReference from) {
         this.from = from;
     }
 
+    /**
+     * LastTriggeredImage is the last image to be triggered.
+     */
     @JsonProperty("lastTriggeredImage")
     public String getLastTriggeredImage() {
         return lastTriggeredImage;
     }
 
+    /**
+     * LastTriggeredImage is the last image to be triggered.
+     */
     @JsonProperty("lastTriggeredImage")
     public void setLastTriggeredImage(String lastTriggeredImage) {
         this.lastTriggeredImage = lastTriggeredImage;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentTriggerPolicy.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentTriggerPolicy.java
index 07d7aba74df..4f2d998b84b 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentTriggerPolicy.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DeploymentTriggerPolicy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DeploymentTriggerPolicy describes a policy for a single trigger that results in a new deployment.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public DeploymentTriggerPolicy(DeploymentTriggerImageChangeParams imageChangePar
         this.type = type;
     }
 
+    /**
+     * DeploymentTriggerPolicy describes a policy for a single trigger that results in a new deployment.
+     */
     @JsonProperty("imageChangeParams")
     public DeploymentTriggerImageChangeParams getImageChangeParams() {
         return imageChangeParams;
     }
 
+    /**
+     * DeploymentTriggerPolicy describes a policy for a single trigger that results in a new deployment.
+     */
     @JsonProperty("imageChangeParams")
     public void setImageChangeParams(DeploymentTriggerImageChangeParams imageChangeParams) {
         this.imageChangeParams = imageChangeParams;
     }
 
+    /**
+     * Type of the trigger
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of the trigger
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DockerBuildStrategy.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DockerBuildStrategy.java
index 521401fbb87..da65940311e 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DockerBuildStrategy.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DockerBuildStrategy.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DockerBuildStrategy defines input parameters specific to container image build.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -115,94 +118,148 @@ public DockerBuildStrategy(List<EnvVar> buildArgs, String dockerfilePath, List<E
         this.volumes = volumes;
     }
 
+    /**
+     * buildArgs contains build arguments that will be resolved in the Dockerfile.  See https://docs.docker.com/engine/reference/builder/#/arg for more details. NOTE: Only the 'name' and 'value' fields are supported. Any settings on the 'valueFrom' field are ignored.
+     */
     @JsonProperty("buildArgs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvVar> getBuildArgs() {
         return buildArgs;
     }
 
+    /**
+     * buildArgs contains build arguments that will be resolved in the Dockerfile.  See https://docs.docker.com/engine/reference/builder/#/arg for more details. NOTE: Only the 'name' and 'value' fields are supported. Any settings on the 'valueFrom' field are ignored.
+     */
     @JsonProperty("buildArgs")
     public void setBuildArgs(List<EnvVar> buildArgs) {
         this.buildArgs = buildArgs;
     }
 
+    /**
+     * dockerfilePath is the path of the Dockerfile that will be used to build the container image, relative to the root of the context (contextDir). Defaults to `Dockerfile` if unset.
+     */
     @JsonProperty("dockerfilePath")
     public String getDockerfilePath() {
         return dockerfilePath;
     }
 
+    /**
+     * dockerfilePath is the path of the Dockerfile that will be used to build the container image, relative to the root of the context (contextDir). Defaults to `Dockerfile` if unset.
+     */
     @JsonProperty("dockerfilePath")
     public void setDockerfilePath(String dockerfilePath) {
         this.dockerfilePath = dockerfilePath;
     }
 
+    /**
+     * env contains additional environment variables you want to pass into a builder container.
+     */
     @JsonProperty("env")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvVar> getEnv() {
         return env;
     }
 
+    /**
+     * env contains additional environment variables you want to pass into a builder container.
+     */
     @JsonProperty("env")
     public void setEnv(List<EnvVar> env) {
         this.env = env;
     }
 
+    /**
+     * forcePull describes if the builder should pull the images from registry prior to building.
+     */
     @JsonProperty("forcePull")
     public Boolean getForcePull() {
         return forcePull;
     }
 
+    /**
+     * forcePull describes if the builder should pull the images from registry prior to building.
+     */
     @JsonProperty("forcePull")
     public void setForcePull(Boolean forcePull) {
         this.forcePull = forcePull;
     }
 
+    /**
+     * DockerBuildStrategy defines input parameters specific to container image build.
+     */
     @JsonProperty("from")
     public ObjectReference getFrom() {
         return from;
     }
 
+    /**
+     * DockerBuildStrategy defines input parameters specific to container image build.
+     */
     @JsonProperty("from")
     public void setFrom(ObjectReference from) {
         this.from = from;
     }
 
+    /**
+     * imageOptimizationPolicy describes what optimizations the system can use when building images to reduce the final size or time spent building the image. The default policy is 'None' which means the final build image will be equivalent to an image created by the container image build API. The experimental policy 'SkipLayers' will avoid commiting new layers in between each image step, and will fail if the Dockerfile cannot provide compatibility with the 'None' policy. An additional experimental policy 'SkipLayersAndWarn' is the same as 'SkipLayers' but simply warns if compatibility cannot be preserved.
+     */
     @JsonProperty("imageOptimizationPolicy")
     public String getImageOptimizationPolicy() {
         return imageOptimizationPolicy;
     }
 
+    /**
+     * imageOptimizationPolicy describes what optimizations the system can use when building images to reduce the final size or time spent building the image. The default policy is 'None' which means the final build image will be equivalent to an image created by the container image build API. The experimental policy 'SkipLayers' will avoid commiting new layers in between each image step, and will fail if the Dockerfile cannot provide compatibility with the 'None' policy. An additional experimental policy 'SkipLayersAndWarn' is the same as 'SkipLayers' but simply warns if compatibility cannot be preserved.
+     */
     @JsonProperty("imageOptimizationPolicy")
     public void setImageOptimizationPolicy(String imageOptimizationPolicy) {
         this.imageOptimizationPolicy = imageOptimizationPolicy;
     }
 
+    /**
+     * noCache if set to true indicates that the container image build must be executed with the --no-cache=true flag
+     */
     @JsonProperty("noCache")
     public Boolean getNoCache() {
         return noCache;
     }
 
+    /**
+     * noCache if set to true indicates that the container image build must be executed with the --no-cache=true flag
+     */
     @JsonProperty("noCache")
     public void setNoCache(Boolean noCache) {
         this.noCache = noCache;
     }
 
+    /**
+     * DockerBuildStrategy defines input parameters specific to container image build.
+     */
     @JsonProperty("pullSecret")
     public LocalObjectReference getPullSecret() {
         return pullSecret;
     }
 
+    /**
+     * DockerBuildStrategy defines input parameters specific to container image build.
+     */
     @JsonProperty("pullSecret")
     public void setPullSecret(LocalObjectReference pullSecret) {
         this.pullSecret = pullSecret;
     }
 
+    /**
+     * volumes is a list of input volumes that can be mounted into the builds runtime environment. Only a subset of Kubernetes Volume sources are supported by builds. More info: https://kubernetes.io/docs/concepts/storage/volumes
+     */
     @JsonProperty("volumes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<BuildVolume> getVolumes() {
         return volumes;
     }
 
+    /**
+     * volumes is a list of input volumes that can be mounted into the builds runtime environment. Only a subset of Kubernetes Volume sources are supported by builds. More info: https://kubernetes.io/docs/concepts/storage/volumes
+     */
     @JsonProperty("volumes")
     public void setVolumes(List<BuildVolume> volumes) {
         this.volumes = volumes;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DockerImageReference.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DockerImageReference.java
index 550f04a0ccc..1bb1fc6d07e 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DockerImageReference.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DockerImageReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DockerImageReference points to a container image.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public DockerImageReference(String iD, String name, String namespace, String reg
         this.tag = tag;
     }
 
+    /**
+     * ID is the identifier for the container image
+     */
     @JsonProperty("iD")
     public String getID() {
         return iD;
     }
 
+    /**
+     * ID is the identifier for the container image
+     */
     @JsonProperty("iD")
     public void setID(String iD) {
         this.iD = iD;
     }
 
+    /**
+     * Name is the name of the container image
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the container image
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace is the namespace that contains the container image
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace that contains the container image
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Registry is the registry that contains the container image
+     */
     @JsonProperty("registry")
     public String getRegistry() {
         return registry;
     }
 
+    /**
+     * Registry is the registry that contains the container image
+     */
     @JsonProperty("registry")
     public void setRegistry(String registry) {
         this.registry = registry;
     }
 
+    /**
+     * Tag is which tag of the container image is being referenced
+     */
     @JsonProperty("tag")
     public String getTag() {
         return tag;
     }
 
+    /**
+     * Tag is which tag of the container image is being referenced
+     */
     @JsonProperty("tag")
     public void setTag(String tag) {
         this.tag = tag;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DockerStrategyOptions.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DockerStrategyOptions.java
index c940a4d1b33..c5d201724bb 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DockerStrategyOptions.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/DockerStrategyOptions.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * DockerStrategyOptions contains extra strategy options for container image builds
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public DockerStrategyOptions(List<EnvVar> buildArgs, Boolean noCache) {
         this.noCache = noCache;
     }
 
+    /**
+     * Args contains any build arguments that are to be passed to Docker.  See https://docs.docker.com/engine/reference/builder/#/arg for more details
+     */
     @JsonProperty("buildArgs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvVar> getBuildArgs() {
         return buildArgs;
     }
 
+    /**
+     * Args contains any build arguments that are to be passed to Docker.  See https://docs.docker.com/engine/reference/builder/#/arg for more details
+     */
     @JsonProperty("buildArgs")
     public void setBuildArgs(List<EnvVar> buildArgs) {
         this.buildArgs = buildArgs;
     }
 
+    /**
+     * noCache overrides the docker-strategy noCache option in the build config
+     */
     @JsonProperty("noCache")
     public Boolean getNoCache() {
         return noCache;
     }
 
+    /**
+     * noCache overrides the docker-strategy noCache option in the build config
+     */
     @JsonProperty("noCache")
     public void setNoCache(Boolean noCache) {
         this.noCache = noCache;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ExecNewPodHook.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ExecNewPodHook.java
index 3814fd5889e..89a0418ff3f 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ExecNewPodHook.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ExecNewPodHook.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ExecNewPodHook is a hook implementation which runs a command in a new pod based on the specified container which is assumed to be part of the deployment template.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -95,44 +98,68 @@ public ExecNewPodHook(List<String> command, String containerName, List<EnvVar> e
         this.volumes = volumes;
     }
 
+    /**
+     * Command is the action command and its arguments.
+     */
     @JsonProperty("command")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getCommand() {
         return command;
     }
 
+    /**
+     * Command is the action command and its arguments.
+     */
     @JsonProperty("command")
     public void setCommand(List<String> command) {
         this.command = command;
     }
 
+    /**
+     * ContainerName is the name of a container in the deployment pod template whose container image will be used for the hook pod's container.
+     */
     @JsonProperty("containerName")
     public String getContainerName() {
         return containerName;
     }
 
+    /**
+     * ContainerName is the name of a container in the deployment pod template whose container image will be used for the hook pod's container.
+     */
     @JsonProperty("containerName")
     public void setContainerName(String containerName) {
         this.containerName = containerName;
     }
 
+    /**
+     * Env is a set of environment variables to supply to the hook pod's container.
+     */
     @JsonProperty("env")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvVar> getEnv() {
         return env;
     }
 
+    /**
+     * Env is a set of environment variables to supply to the hook pod's container.
+     */
     @JsonProperty("env")
     public void setEnv(List<EnvVar> env) {
         this.env = env;
     }
 
+    /**
+     * Volumes is a list of named volumes from the pod template which should be copied to the hook pod. Volumes names not found in pod spec are ignored. An empty list means no volumes will be copied.
+     */
     @JsonProperty("volumes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getVolumes() {
         return volumes;
     }
 
+    /**
+     * Volumes is a list of named volumes from the pod template which should be copied to the hook pod. Volumes names not found in pod spec are ignored. An empty list means no volumes will be copied.
+     */
     @JsonProperty("volumes")
     public void setVolumes(List<String> volumes) {
         this.volumes = volumes;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/FSGroupStrategyOptions.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/FSGroupStrategyOptions.java
index f9770bcaa46..f318e02ca19 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/FSGroupStrategyOptions.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/FSGroupStrategyOptions.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * FSGroupStrategyOptions defines the strategy type and options used to create the strategy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public FSGroupStrategyOptions(List<IDRange> ranges, String type) {
         this.type = type;
     }
 
+    /**
+     * Ranges are the allowed ranges of fs groups.  If you would like to force a single fs group then supply a single range with the same start and end.
+     */
     @JsonProperty("ranges")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IDRange> getRanges() {
         return ranges;
     }
 
+    /**
+     * Ranges are the allowed ranges of fs groups.  If you would like to force a single fs group then supply a single range with the same start and end.
+     */
     @JsonProperty("ranges")
     public void setRanges(List<IDRange> ranges) {
         this.ranges = ranges;
     }
 
+    /**
+     * Type is the strategy that will dictate what FSGroup is used in the SecurityContext.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the strategy that will dictate what FSGroup is used in the SecurityContext.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GenericWebHookCause.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GenericWebHookCause.java
index 08df1791b3d..c6c4f1761f2 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GenericWebHookCause.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GenericWebHookCause.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GenericWebHookCause holds information about a generic WebHook that triggered a build.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public GenericWebHookCause(SourceRevision revision, String secret) {
         this.secret = secret;
     }
 
+    /**
+     * GenericWebHookCause holds information about a generic WebHook that triggered a build.
+     */
     @JsonProperty("revision")
     public SourceRevision getRevision() {
         return revision;
     }
 
+    /**
+     * GenericWebHookCause holds information about a generic WebHook that triggered a build.
+     */
     @JsonProperty("revision")
     public void setRevision(SourceRevision revision) {
         this.revision = revision;
     }
 
+    /**
+     * secret is the obfuscated webhook secret that triggered a build.
+     */
     @JsonProperty("secret")
     public String getSecret() {
         return secret;
     }
 
+    /**
+     * secret is the obfuscated webhook secret that triggered a build.
+     */
     @JsonProperty("secret")
     public void setSecret(String secret) {
         this.secret = secret;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GenericWebHookEvent.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GenericWebHookEvent.java
index cdbaeefae7a..daa828d9008 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GenericWebHookEvent.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GenericWebHookEvent.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GenericWebHookEvent is the payload expected for a generic webhook post
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public GenericWebHookEvent(DockerStrategyOptions dockerStrategyOptions, List<Env
         this.type = type;
     }
 
+    /**
+     * GenericWebHookEvent is the payload expected for a generic webhook post
+     */
     @JsonProperty("dockerStrategyOptions")
     public DockerStrategyOptions getDockerStrategyOptions() {
         return dockerStrategyOptions;
     }
 
+    /**
+     * GenericWebHookEvent is the payload expected for a generic webhook post
+     */
     @JsonProperty("dockerStrategyOptions")
     public void setDockerStrategyOptions(DockerStrategyOptions dockerStrategyOptions) {
         this.dockerStrategyOptions = dockerStrategyOptions;
     }
 
+    /**
+     * env contains additional environment variables you want to pass into a builder container. ValueFrom is not supported.
+     */
     @JsonProperty("env")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvVar> getEnv() {
         return env;
     }
 
+    /**
+     * env contains additional environment variables you want to pass into a builder container. ValueFrom is not supported.
+     */
     @JsonProperty("env")
     public void setEnv(List<EnvVar> env) {
         this.env = env;
     }
 
+    /**
+     * GenericWebHookEvent is the payload expected for a generic webhook post
+     */
     @JsonProperty("git")
     public GitInfo getGit() {
         return git;
     }
 
+    /**
+     * GenericWebHookEvent is the payload expected for a generic webhook post
+     */
     @JsonProperty("git")
     public void setGit(GitInfo git) {
         this.git = git;
     }
 
+    /**
+     * type is the type of source repository
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type is the type of source repository
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GitBuildSource.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GitBuildSource.java
index 358adcc1e60..14ca8bf1af7 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GitBuildSource.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GitBuildSource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GitBuildSource defines the parameters of a Git SCM
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public GitBuildSource(String httpProxy, String httpsProxy, String noProxy, Strin
         this.uri = uri;
     }
 
+    /**
+     * httpProxy is a proxy used to reach the git repository over http
+     */
     @JsonProperty("httpProxy")
     public String getHttpProxy() {
         return httpProxy;
     }
 
+    /**
+     * httpProxy is a proxy used to reach the git repository over http
+     */
     @JsonProperty("httpProxy")
     public void setHttpProxy(String httpProxy) {
         this.httpProxy = httpProxy;
     }
 
+    /**
+     * httpsProxy is a proxy used to reach the git repository over https
+     */
     @JsonProperty("httpsProxy")
     public String getHttpsProxy() {
         return httpsProxy;
     }
 
+    /**
+     * httpsProxy is a proxy used to reach the git repository over https
+     */
     @JsonProperty("httpsProxy")
     public void setHttpsProxy(String httpsProxy) {
         this.httpsProxy = httpsProxy;
     }
 
+    /**
+     * noProxy is the list of domains for which the proxy should not be used
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * noProxy is the list of domains for which the proxy should not be used
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * ref is the branch/tag/ref to build.
+     */
     @JsonProperty("ref")
     public String getRef() {
         return ref;
     }
 
+    /**
+     * ref is the branch/tag/ref to build.
+     */
     @JsonProperty("ref")
     public void setRef(String ref) {
         this.ref = ref;
     }
 
+    /**
+     * uri points to the source that will be built. The structure of the source will depend on the type of build to run
+     */
     @JsonProperty("uri")
     public String getUri() {
         return uri;
     }
 
+    /**
+     * uri points to the source that will be built. The structure of the source will depend on the type of build to run
+     */
     @JsonProperty("uri")
     public void setUri(String uri) {
         this.uri = uri;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GitHubWebHookCause.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GitHubWebHookCause.java
index 2feae39fe8c..05743546ae1 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GitHubWebHookCause.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GitHubWebHookCause.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GitHubWebHookCause has information about a GitHub webhook that triggered a build.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public GitHubWebHookCause(SourceRevision revision, String secret) {
         this.secret = secret;
     }
 
+    /**
+     * GitHubWebHookCause has information about a GitHub webhook that triggered a build.
+     */
     @JsonProperty("revision")
     public SourceRevision getRevision() {
         return revision;
     }
 
+    /**
+     * GitHubWebHookCause has information about a GitHub webhook that triggered a build.
+     */
     @JsonProperty("revision")
     public void setRevision(SourceRevision revision) {
         this.revision = revision;
     }
 
+    /**
+     * secret is the obfuscated webhook secret that triggered a build.
+     */
     @JsonProperty("secret")
     public String getSecret() {
         return secret;
     }
 
+    /**
+     * secret is the obfuscated webhook secret that triggered a build.
+     */
     @JsonProperty("secret")
     public void setSecret(String secret) {
         this.secret = secret;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GitInfo.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GitInfo.java
index ae8f2759565..55d45959ac2 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GitInfo.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GitInfo.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GitInfo is the aggregated git information for a generic webhook post
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -117,102 +120,162 @@ public GitInfo(SourceControlUser author, String commit, SourceControlUser commit
         this.uri = uri;
     }
 
+    /**
+     * GitInfo is the aggregated git information for a generic webhook post
+     */
     @JsonProperty("author")
     public SourceControlUser getAuthor() {
         return author;
     }
 
+    /**
+     * GitInfo is the aggregated git information for a generic webhook post
+     */
     @JsonProperty("author")
     public void setAuthor(SourceControlUser author) {
         this.author = author;
     }
 
+    /**
+     * commit is the commit hash identifying a specific commit
+     */
     @JsonProperty("commit")
     public String getCommit() {
         return commit;
     }
 
+    /**
+     * commit is the commit hash identifying a specific commit
+     */
     @JsonProperty("commit")
     public void setCommit(String commit) {
         this.commit = commit;
     }
 
+    /**
+     * GitInfo is the aggregated git information for a generic webhook post
+     */
     @JsonProperty("committer")
     public SourceControlUser getCommitter() {
         return committer;
     }
 
+    /**
+     * GitInfo is the aggregated git information for a generic webhook post
+     */
     @JsonProperty("committer")
     public void setCommitter(SourceControlUser committer) {
         this.committer = committer;
     }
 
+    /**
+     * httpProxy is a proxy used to reach the git repository over http
+     */
     @JsonProperty("httpProxy")
     public String getHttpProxy() {
         return httpProxy;
     }
 
+    /**
+     * httpProxy is a proxy used to reach the git repository over http
+     */
     @JsonProperty("httpProxy")
     public void setHttpProxy(String httpProxy) {
         this.httpProxy = httpProxy;
     }
 
+    /**
+     * httpsProxy is a proxy used to reach the git repository over https
+     */
     @JsonProperty("httpsProxy")
     public String getHttpsProxy() {
         return httpsProxy;
     }
 
+    /**
+     * httpsProxy is a proxy used to reach the git repository over https
+     */
     @JsonProperty("httpsProxy")
     public void setHttpsProxy(String httpsProxy) {
         this.httpsProxy = httpsProxy;
     }
 
+    /**
+     * message is the description of a specific commit
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message is the description of a specific commit
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * noProxy is the list of domains for which the proxy should not be used
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * noProxy is the list of domains for which the proxy should not be used
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * ref is the branch/tag/ref to build.
+     */
     @JsonProperty("ref")
     public String getRef() {
         return ref;
     }
 
+    /**
+     * ref is the branch/tag/ref to build.
+     */
     @JsonProperty("ref")
     public void setRef(String ref) {
         this.ref = ref;
     }
 
+    /**
+     * Refs is a list of GitRefs for the provided repo - generally sent when used from a post-receive hook. This field is optional and is used when sending multiple refs
+     */
     @JsonProperty("refs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<GitRefInfo> getRefs() {
         return refs;
     }
 
+    /**
+     * Refs is a list of GitRefs for the provided repo - generally sent when used from a post-receive hook. This field is optional and is used when sending multiple refs
+     */
     @JsonProperty("refs")
     public void setRefs(List<GitRefInfo> refs) {
         this.refs = refs;
     }
 
+    /**
+     * uri points to the source that will be built. The structure of the source will depend on the type of build to run
+     */
     @JsonProperty("uri")
     public String getUri() {
         return uri;
     }
 
+    /**
+     * uri points to the source that will be built. The structure of the source will depend on the type of build to run
+     */
     @JsonProperty("uri")
     public void setUri(String uri) {
         this.uri = uri;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GitLabWebHookCause.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GitLabWebHookCause.java
index 27241859a9a..d1be112a717 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GitLabWebHookCause.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GitLabWebHookCause.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GitLabWebHookCause has information about a GitLab webhook that triggered a build.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public GitLabWebHookCause(SourceRevision revision, String secret) {
         this.secret = secret;
     }
 
+    /**
+     * GitLabWebHookCause has information about a GitLab webhook that triggered a build.
+     */
     @JsonProperty("revision")
     public SourceRevision getRevision() {
         return revision;
     }
 
+    /**
+     * GitLabWebHookCause has information about a GitLab webhook that triggered a build.
+     */
     @JsonProperty("revision")
     public void setRevision(SourceRevision revision) {
         this.revision = revision;
     }
 
+    /**
+     * Secret is the obfuscated webhook secret that triggered a build.
+     */
     @JsonProperty("secret")
     public String getSecret() {
         return secret;
     }
 
+    /**
+     * Secret is the obfuscated webhook secret that triggered a build.
+     */
     @JsonProperty("secret")
     public void setSecret(String secret) {
         this.secret = secret;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GitRefInfo.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GitRefInfo.java
index 9069608ba38..f0adf7d09d9 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GitRefInfo.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GitRefInfo.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GitRefInfo is a single ref
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -110,91 +113,145 @@ public GitRefInfo(SourceControlUser author, String commit, SourceControlUser com
         this.uri = uri;
     }
 
+    /**
+     * GitRefInfo is a single ref
+     */
     @JsonProperty("author")
     public SourceControlUser getAuthor() {
         return author;
     }
 
+    /**
+     * GitRefInfo is a single ref
+     */
     @JsonProperty("author")
     public void setAuthor(SourceControlUser author) {
         this.author = author;
     }
 
+    /**
+     * commit is the commit hash identifying a specific commit
+     */
     @JsonProperty("commit")
     public String getCommit() {
         return commit;
     }
 
+    /**
+     * commit is the commit hash identifying a specific commit
+     */
     @JsonProperty("commit")
     public void setCommit(String commit) {
         this.commit = commit;
     }
 
+    /**
+     * GitRefInfo is a single ref
+     */
     @JsonProperty("committer")
     public SourceControlUser getCommitter() {
         return committer;
     }
 
+    /**
+     * GitRefInfo is a single ref
+     */
     @JsonProperty("committer")
     public void setCommitter(SourceControlUser committer) {
         this.committer = committer;
     }
 
+    /**
+     * httpProxy is a proxy used to reach the git repository over http
+     */
     @JsonProperty("httpProxy")
     public String getHttpProxy() {
         return httpProxy;
     }
 
+    /**
+     * httpProxy is a proxy used to reach the git repository over http
+     */
     @JsonProperty("httpProxy")
     public void setHttpProxy(String httpProxy) {
         this.httpProxy = httpProxy;
     }
 
+    /**
+     * httpsProxy is a proxy used to reach the git repository over https
+     */
     @JsonProperty("httpsProxy")
     public String getHttpsProxy() {
         return httpsProxy;
     }
 
+    /**
+     * httpsProxy is a proxy used to reach the git repository over https
+     */
     @JsonProperty("httpsProxy")
     public void setHttpsProxy(String httpsProxy) {
         this.httpsProxy = httpsProxy;
     }
 
+    /**
+     * message is the description of a specific commit
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message is the description of a specific commit
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * noProxy is the list of domains for which the proxy should not be used
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * noProxy is the list of domains for which the proxy should not be used
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * ref is the branch/tag/ref to build.
+     */
     @JsonProperty("ref")
     public String getRef() {
         return ref;
     }
 
+    /**
+     * ref is the branch/tag/ref to build.
+     */
     @JsonProperty("ref")
     public void setRef(String ref) {
         this.ref = ref;
     }
 
+    /**
+     * uri points to the source that will be built. The structure of the source will depend on the type of build to run
+     */
     @JsonProperty("uri")
     public String getUri() {
         return uri;
     }
 
+    /**
+     * uri points to the source that will be built. The structure of the source will depend on the type of build to run
+     */
     @JsonProperty("uri")
     public void setUri(String uri) {
         this.uri = uri;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GitSourceRevision.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GitSourceRevision.java
index 2ed7031650c..12226d3e416 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GitSourceRevision.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GitSourceRevision.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GitSourceRevision is the commit information from a git source for a build
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public GitSourceRevision(SourceControlUser author, String commit, SourceControlU
         this.message = message;
     }
 
+    /**
+     * GitSourceRevision is the commit information from a git source for a build
+     */
     @JsonProperty("author")
     public SourceControlUser getAuthor() {
         return author;
     }
 
+    /**
+     * GitSourceRevision is the commit information from a git source for a build
+     */
     @JsonProperty("author")
     public void setAuthor(SourceControlUser author) {
         this.author = author;
     }
 
+    /**
+     * commit is the commit hash identifying a specific commit
+     */
     @JsonProperty("commit")
     public String getCommit() {
         return commit;
     }
 
+    /**
+     * commit is the commit hash identifying a specific commit
+     */
     @JsonProperty("commit")
     public void setCommit(String commit) {
         this.commit = commit;
     }
 
+    /**
+     * GitSourceRevision is the commit information from a git source for a build
+     */
     @JsonProperty("committer")
     public SourceControlUser getCommitter() {
         return committer;
     }
 
+    /**
+     * GitSourceRevision is the commit information from a git source for a build
+     */
     @JsonProperty("committer")
     public void setCommitter(SourceControlUser committer) {
         this.committer = committer;
     }
 
+    /**
+     * message is the description of a specific commit
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message is the description of a specific commit
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Group.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Group.java
index 92662935ece..0f1fe7ca89c 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Group.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Group.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Group represents a referenceable set of Users<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Group implements Editable<GroupBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "user.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Group";
     @JsonProperty("metadata")
@@ -108,7 +105,7 @@ public Group(String apiVersion, String kind, ObjectMeta metadata, List<String> u
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -116,7 +113,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -124,7 +121,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -132,29 +129,41 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Group represents a referenceable set of Users<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Group represents a referenceable set of Users<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Users is the list of users in this group.
+     */
     @JsonProperty("users")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getUsers() {
         return users;
     }
 
+    /**
+     * Users is the list of users in this group.
+     */
     @JsonProperty("users")
     public void setUsers(List<String> users) {
         this.users = users;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GroupList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GroupList.java
index d71611d5758..7cd73beee63 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GroupList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GroupList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GroupList is a collection of Groups<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class GroupList implements Editable<GroupListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.Group>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "user.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.Group> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "GroupList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public GroupList(String apiVersion, List<io.fabric8.openshift.api.model.Group> i
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of groups
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.Group> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of groups
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.Group> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * GroupList is a collection of Groups<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * GroupList is a collection of Groups<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GroupRestriction.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GroupRestriction.java
index 6fe50eec694..af3b095d74b 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GroupRestriction.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/GroupRestriction.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * GroupRestriction matches a group either by a string match on the group name or a label selector applied to group labels.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public GroupRestriction(List<String> groups, List<LabelSelector> labels) {
         this.labels = labels;
     }
 
+    /**
+     * Groups is a list of groups used to match against an individual user's groups. If the user is a member of one of the whitelisted groups, the user is allowed to be bound to a role.
+     */
     @JsonProperty("groups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getGroups() {
         return groups;
     }
 
+    /**
+     * Groups is a list of groups used to match against an individual user's groups. If the user is a member of one of the whitelisted groups, the user is allowed to be bound to a role.
+     */
     @JsonProperty("groups")
     public void setGroups(List<String> groups) {
         this.groups = groups;
     }
 
+    /**
+     * Selectors specifies a list of label selectors over group labels.
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LabelSelector> getLabels() {
         return labels;
     }
 
+    /**
+     * Selectors specifies a list of label selectors over group labels.
+     */
     @JsonProperty("labels")
     public void setLabels(List<LabelSelector> labels) {
         this.labels = labels;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/IDRange.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/IDRange.java
index 456c759c158..7ac69375a4d 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/IDRange.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/IDRange.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IDRange provides a min/max of an allowed range of IDs.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public IDRange(Long max, Long min) {
         this.min = min;
     }
 
+    /**
+     * Max is the end of the range, inclusive.
+     */
     @JsonProperty("max")
     public Long getMax() {
         return max;
     }
 
+    /**
+     * Max is the end of the range, inclusive.
+     */
     @JsonProperty("max")
     public void setMax(Long max) {
         this.max = max;
     }
 
+    /**
+     * Min is the start of the range, inclusive.
+     */
     @JsonProperty("min")
     public Long getMin() {
         return min;
     }
 
+    /**
+     * Min is the start of the range, inclusive.
+     */
     @JsonProperty("min")
     public void setMin(Long min) {
         this.min = min;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Identity.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Identity.java
index eb3c7bd4981..674e252af53 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Identity.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Identity.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Identity records a successful authentication of a user with an identity provider. The information about the source of authentication is stored on the identity, and the identity is then associated with a single user object. Multiple identities can reference a single user. Information retrieved from the authentication provider is stored in the extra field using a schema determined by the provider.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,17 +80,11 @@
 public class Identity implements Editable<IdentityBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "user.openshift.io/v1";
     @JsonProperty("extra")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private Map<String, String> extra = new LinkedHashMap<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Identity";
     @JsonProperty("metadata")
@@ -119,7 +116,7 @@ public Identity(String apiVersion, Map<String, String> extra, String kind, Objec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -127,26 +124,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Extra holds extra information about this identity
+     */
     @JsonProperty("extra")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getExtra() {
         return extra;
     }
 
+    /**
+     * Extra holds extra information about this identity
+     */
     @JsonProperty("extra")
     public void setExtra(Map<String, String> extra) {
         this.extra = extra;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -154,48 +157,72 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Identity records a successful authentication of a user with an identity provider. The information about the source of authentication is stored on the identity, and the identity is then associated with a single user object. Multiple identities can reference a single user. Information retrieved from the authentication provider is stored in the extra field using a schema determined by the provider.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Identity records a successful authentication of a user with an identity provider. The information about the source of authentication is stored on the identity, and the identity is then associated with a single user object. Multiple identities can reference a single user. Information retrieved from the authentication provider is stored in the extra field using a schema determined by the provider.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ProviderName is the source of identity information
+     */
     @JsonProperty("providerName")
     public String getProviderName() {
         return providerName;
     }
 
+    /**
+     * ProviderName is the source of identity information
+     */
     @JsonProperty("providerName")
     public void setProviderName(String providerName) {
         this.providerName = providerName;
     }
 
+    /**
+     * ProviderUserName uniquely represents this identity in the scope of the provider
+     */
     @JsonProperty("providerUserName")
     public String getProviderUserName() {
         return providerUserName;
     }
 
+    /**
+     * ProviderUserName uniquely represents this identity in the scope of the provider
+     */
     @JsonProperty("providerUserName")
     public void setProviderUserName(String providerUserName) {
         this.providerUserName = providerUserName;
     }
 
+    /**
+     * Identity records a successful authentication of a user with an identity provider. The information about the source of authentication is stored on the identity, and the identity is then associated with a single user object. Multiple identities can reference a single user. Information retrieved from the authentication provider is stored in the extra field using a schema determined by the provider.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("user")
     public ObjectReference getUser() {
         return user;
     }
 
+    /**
+     * Identity records a successful authentication of a user with an identity provider. The information about the source of authentication is stored on the identity, and the identity is then associated with a single user object. Multiple identities can reference a single user. Information retrieved from the authentication provider is stored in the extra field using a schema determined by the provider.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("user")
     public void setUser(ObjectReference user) {
         this.user = user;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/IdentityList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/IdentityList.java
index d57deed619b..6fa5a236818 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/IdentityList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/IdentityList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IdentityList is a collection of Identities<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class IdentityList implements Editable<IdentityListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.Identity>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "user.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.Identity> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "IdentityList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public IdentityList(String apiVersion, List<io.fabric8.openshift.api.model.Ident
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of identities
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.Identity> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of identities
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.Identity> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * IdentityList is a collection of Identities<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * IdentityList is a collection of Identities<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Image.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Image.java
index 6e3ee70b4da..dcbc6cde582 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Image.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Image.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Image is an immutable representation of a container image and metadata at a point in time. Images are named by taking a hash of their contents (metadata and content) and any change in format, content, or metadata results in a new name. The images resource is primarily for use by cluster administrators and integrations like the cluster image registry - end users instead access images via the imagestreamtags or imagestreamimages resources. While image metadata is stored in the API, any integration that implements the container image registry API must provide its own storage for the raw manifest data, image config, and layer contents.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,9 +88,6 @@
 public class Image implements Editable<ImageBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "image.openshift.io/v1";
     @JsonProperty("dockerImageConfig")
@@ -112,9 +112,6 @@ public class Image implements Editable<ImageBuilder>, HasMetadata
     @JsonProperty("dockerImageSignatures")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<String> dockerImageSignatures = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Image";
     @JsonProperty("metadata")
@@ -149,7 +146,7 @@ public Image(String apiVersion, String dockerImageConfig, List<ImageLayer> docke
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -157,109 +154,163 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * DockerImageConfig is a JSON blob that the runtime uses to set up the container. This is a part of manifest schema v2. Will not be set when the image represents a manifest list.
+     */
     @JsonProperty("dockerImageConfig")
     public String getDockerImageConfig() {
         return dockerImageConfig;
     }
 
+    /**
+     * DockerImageConfig is a JSON blob that the runtime uses to set up the container. This is a part of manifest schema v2. Will not be set when the image represents a manifest list.
+     */
     @JsonProperty("dockerImageConfig")
     public void setDockerImageConfig(String dockerImageConfig) {
         this.dockerImageConfig = dockerImageConfig;
     }
 
+    /**
+     * DockerImageLayers represents the layers in the image. May not be set if the image does not define that data or if the image represents a manifest list.
+     */
     @JsonProperty("dockerImageLayers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ImageLayer> getDockerImageLayers() {
         return dockerImageLayers;
     }
 
+    /**
+     * DockerImageLayers represents the layers in the image. May not be set if the image does not define that data or if the image represents a manifest list.
+     */
     @JsonProperty("dockerImageLayers")
     public void setDockerImageLayers(List<ImageLayer> dockerImageLayers) {
         this.dockerImageLayers = dockerImageLayers;
     }
 
+    /**
+     * DockerImageManifest is the raw JSON of the manifest
+     */
     @JsonProperty("dockerImageManifest")
     public String getDockerImageManifest() {
         return dockerImageManifest;
     }
 
+    /**
+     * DockerImageManifest is the raw JSON of the manifest
+     */
     @JsonProperty("dockerImageManifest")
     public void setDockerImageManifest(String dockerImageManifest) {
         this.dockerImageManifest = dockerImageManifest;
     }
 
+    /**
+     * DockerImageManifestMediaType specifies the mediaType of manifest. This is a part of manifest schema v2.
+     */
     @JsonProperty("dockerImageManifestMediaType")
     public String getDockerImageManifestMediaType() {
         return dockerImageManifestMediaType;
     }
 
+    /**
+     * DockerImageManifestMediaType specifies the mediaType of manifest. This is a part of manifest schema v2.
+     */
     @JsonProperty("dockerImageManifestMediaType")
     public void setDockerImageManifestMediaType(String dockerImageManifestMediaType) {
         this.dockerImageManifestMediaType = dockerImageManifestMediaType;
     }
 
+    /**
+     * DockerImageManifests holds information about sub-manifests when the image represents a manifest list. When this field is present, no DockerImageLayers should be specified.
+     */
     @JsonProperty("dockerImageManifests")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ImageManifest> getDockerImageManifests() {
         return dockerImageManifests;
     }
 
+    /**
+     * DockerImageManifests holds information about sub-manifests when the image represents a manifest list. When this field is present, no DockerImageLayers should be specified.
+     */
     @JsonProperty("dockerImageManifests")
     public void setDockerImageManifests(List<ImageManifest> dockerImageManifests) {
         this.dockerImageManifests = dockerImageManifests;
     }
 
+    /**
+     * Image is an immutable representation of a container image and metadata at a point in time. Images are named by taking a hash of their contents (metadata and content) and any change in format, content, or metadata results in a new name. The images resource is primarily for use by cluster administrators and integrations like the cluster image registry - end users instead access images via the imagestreamtags or imagestreamimages resources. While image metadata is stored in the API, any integration that implements the container image registry API must provide its own storage for the raw manifest data, image config, and layer contents.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("dockerImageMetadata")
     public Object getDockerImageMetadata() {
         return dockerImageMetadata;
     }
 
+    /**
+     * Image is an immutable representation of a container image and metadata at a point in time. Images are named by taking a hash of their contents (metadata and content) and any change in format, content, or metadata results in a new name. The images resource is primarily for use by cluster administrators and integrations like the cluster image registry - end users instead access images via the imagestreamtags or imagestreamimages resources. While image metadata is stored in the API, any integration that implements the container image registry API must provide its own storage for the raw manifest data, image config, and layer contents.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("dockerImageMetadata")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setDockerImageMetadata(Object dockerImageMetadata) {
         this.dockerImageMetadata = dockerImageMetadata;
     }
 
+    /**
+     * DockerImageMetadataVersion conveys the version of the object, which if empty defaults to "1.0"
+     */
     @JsonProperty("dockerImageMetadataVersion")
     public String getDockerImageMetadataVersion() {
         return dockerImageMetadataVersion;
     }
 
+    /**
+     * DockerImageMetadataVersion conveys the version of the object, which if empty defaults to "1.0"
+     */
     @JsonProperty("dockerImageMetadataVersion")
     public void setDockerImageMetadataVersion(String dockerImageMetadataVersion) {
         this.dockerImageMetadataVersion = dockerImageMetadataVersion;
     }
 
+    /**
+     * DockerImageReference is the string that can be used to pull this image.
+     */
     @JsonProperty("dockerImageReference")
     public String getDockerImageReference() {
         return dockerImageReference;
     }
 
+    /**
+     * DockerImageReference is the string that can be used to pull this image.
+     */
     @JsonProperty("dockerImageReference")
     public void setDockerImageReference(String dockerImageReference) {
         this.dockerImageReference = dockerImageReference;
     }
 
+    /**
+     * DockerImageSignatures provides the signatures as opaque blobs. This is a part of manifest schema v1.
+     */
     @JsonProperty("dockerImageSignatures")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDockerImageSignatures() {
         return dockerImageSignatures;
     }
 
+    /**
+     * DockerImageSignatures provides the signatures as opaque blobs. This is a part of manifest schema v1.
+     */
     @JsonProperty("dockerImageSignatures")
     public void setDockerImageSignatures(List<String> dockerImageSignatures) {
         this.dockerImageSignatures = dockerImageSignatures;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -267,29 +318,41 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Image is an immutable representation of a container image and metadata at a point in time. Images are named by taking a hash of their contents (metadata and content) and any change in format, content, or metadata results in a new name. The images resource is primarily for use by cluster administrators and integrations like the cluster image registry - end users instead access images via the imagestreamtags or imagestreamimages resources. While image metadata is stored in the API, any integration that implements the container image registry API must provide its own storage for the raw manifest data, image config, and layer contents.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Image is an immutable representation of a container image and metadata at a point in time. Images are named by taking a hash of their contents (metadata and content) and any change in format, content, or metadata results in a new name. The images resource is primarily for use by cluster administrators and integrations like the cluster image registry - end users instead access images via the imagestreamtags or imagestreamimages resources. While image metadata is stored in the API, any integration that implements the container image registry API must provide its own storage for the raw manifest data, image config, and layer contents.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Signatures holds all signatures of the image.
+     */
     @JsonProperty("signatures")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ImageSignature> getSignatures() {
         return signatures;
     }
 
+    /**
+     * Signatures holds all signatures of the image.
+     */
     @JsonProperty("signatures")
     public void setSignatures(List<ImageSignature> signatures) {
         this.signatures = signatures;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageBlobReferences.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageBlobReferences.java
index 3eeda2679eb..10508420baf 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageBlobReferences.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageBlobReferences.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageBlobReferences describes the blob references within an image.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,43 +97,67 @@ public ImageBlobReferences(String config, Boolean imageMissing, List<String> lay
         this.manifests = manifests;
     }
 
+    /**
+     * config, if set, is the blob that contains the image config. Some images do not have separate config blobs and this field will be set to nil if so.
+     */
     @JsonProperty("config")
     public String getConfig() {
         return config;
     }
 
+    /**
+     * config, if set, is the blob that contains the image config. Some images do not have separate config blobs and this field will be set to nil if so.
+     */
     @JsonProperty("config")
     public void setConfig(String config) {
         this.config = config;
     }
 
+    /**
+     * imageMissing is true if the image is referenced by the image stream but the image object has been deleted from the API by an administrator. When this field is set, layers and config fields may be empty and callers that depend on the image metadata should consider the image to be unavailable for download or viewing.
+     */
     @JsonProperty("imageMissing")
     public Boolean getImageMissing() {
         return imageMissing;
     }
 
+    /**
+     * imageMissing is true if the image is referenced by the image stream but the image object has been deleted from the API by an administrator. When this field is set, layers and config fields may be empty and callers that depend on the image metadata should consider the image to be unavailable for download or viewing.
+     */
     @JsonProperty("imageMissing")
     public void setImageMissing(Boolean imageMissing) {
         this.imageMissing = imageMissing;
     }
 
+    /**
+     * layers is the list of blobs that compose this image, from base layer to top layer. All layers referenced by this array will be defined in the blobs map. Some images may have zero layers.
+     */
     @JsonProperty("layers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getLayers() {
         return layers;
     }
 
+    /**
+     * layers is the list of blobs that compose this image, from base layer to top layer. All layers referenced by this array will be defined in the blobs map. Some images may have zero layers.
+     */
     @JsonProperty("layers")
     public void setLayers(List<String> layers) {
         this.layers = layers;
     }
 
+    /**
+     * manifests is the list of other image names that this image points to. For a single architecture image, it is empty. For a multi-arch image, it consists of the digests of single architecture images, such images shouldn't have layers nor config.
+     */
     @JsonProperty("manifests")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getManifests() {
         return manifests;
     }
 
+    /**
+     * manifests is the list of other image names that this image points to. For a single architecture image, it is empty. For a multi-arch image, it consists of the digests of single architecture images, such images shouldn't have layers nor config.
+     */
     @JsonProperty("manifests")
     public void setManifests(List<String> manifests) {
         this.manifests = manifests;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageChangeCause.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageChangeCause.java
index b1f2b7bdf0d..f039fa73c20 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageChangeCause.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageChangeCause.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageChangeCause contains information about the image that triggered a build
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ImageChangeCause(ObjectReference fromRef, String imageID) {
         this.imageID = imageID;
     }
 
+    /**
+     * ImageChangeCause contains information about the image that triggered a build
+     */
     @JsonProperty("fromRef")
     public ObjectReference getFromRef() {
         return fromRef;
     }
 
+    /**
+     * ImageChangeCause contains information about the image that triggered a build
+     */
     @JsonProperty("fromRef")
     public void setFromRef(ObjectReference fromRef) {
         this.fromRef = fromRef;
     }
 
+    /**
+     * imageID is the ID of the image that triggered a new build.
+     */
     @JsonProperty("imageID")
     public String getImageID() {
         return imageID;
     }
 
+    /**
+     * imageID is the ID of the image that triggered a new build.
+     */
     @JsonProperty("imageID")
     public void setImageID(String imageID) {
         this.imageID = imageID;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageChangeTrigger.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageChangeTrigger.java
index c916ba770f7..90a66abd406 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageChangeTrigger.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageChangeTrigger.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageChangeTrigger allows builds to be triggered when an ImageStream changes
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ImageChangeTrigger(ObjectReference from, String lastTriggeredImageID, Boo
         this.paused = paused;
     }
 
+    /**
+     * ImageChangeTrigger allows builds to be triggered when an ImageStream changes
+     */
     @JsonProperty("from")
     public ObjectReference getFrom() {
         return from;
     }
 
+    /**
+     * ImageChangeTrigger allows builds to be triggered when an ImageStream changes
+     */
     @JsonProperty("from")
     public void setFrom(ObjectReference from) {
         this.from = from;
     }
 
+    /**
+     * lastTriggeredImageID is used internally by the ImageChangeController to save last used image ID for build This field is deprecated and will be removed in a future release. Deprecated
+     */
     @JsonProperty("lastTriggeredImageID")
     public String getLastTriggeredImageID() {
         return lastTriggeredImageID;
     }
 
+    /**
+     * lastTriggeredImageID is used internally by the ImageChangeController to save last used image ID for build This field is deprecated and will be removed in a future release. Deprecated
+     */
     @JsonProperty("lastTriggeredImageID")
     public void setLastTriggeredImageID(String lastTriggeredImageID) {
         this.lastTriggeredImageID = lastTriggeredImageID;
     }
 
+    /**
+     * paused is true if this trigger is temporarily disabled. Optional.
+     */
     @JsonProperty("paused")
     public Boolean getPaused() {
         return paused;
     }
 
+    /**
+     * paused is true if this trigger is temporarily disabled. Optional.
+     */
     @JsonProperty("paused")
     public void setPaused(Boolean paused) {
         this.paused = paused;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageChangeTriggerStatus.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageChangeTriggerStatus.java
index d63f6cf3c90..924eb2e118f 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageChangeTriggerStatus.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageChangeTriggerStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageChangeTriggerStatus tracks the latest resolved status of the associated ImageChangeTrigger policy specified in the BuildConfigSpec.Triggers struct.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ImageChangeTriggerStatus(ImageStreamTagReference from, String lastTrigger
         this.lastTriggeredImageID = lastTriggeredImageID;
     }
 
+    /**
+     * ImageChangeTriggerStatus tracks the latest resolved status of the associated ImageChangeTrigger policy specified in the BuildConfigSpec.Triggers struct.
+     */
     @JsonProperty("from")
     public ImageStreamTagReference getFrom() {
         return from;
     }
 
+    /**
+     * ImageChangeTriggerStatus tracks the latest resolved status of the associated ImageChangeTrigger policy specified in the BuildConfigSpec.Triggers struct.
+     */
     @JsonProperty("from")
     public void setFrom(ImageStreamTagReference from) {
         this.from = from;
     }
 
+    /**
+     * ImageChangeTriggerStatus tracks the latest resolved status of the associated ImageChangeTrigger policy specified in the BuildConfigSpec.Triggers struct.
+     */
     @JsonProperty("lastTriggerTime")
     public String getLastTriggerTime() {
         return lastTriggerTime;
     }
 
+    /**
+     * ImageChangeTriggerStatus tracks the latest resolved status of the associated ImageChangeTrigger policy specified in the BuildConfigSpec.Triggers struct.
+     */
     @JsonProperty("lastTriggerTime")
     public void setLastTriggerTime(String lastTriggerTime) {
         this.lastTriggerTime = lastTriggerTime;
     }
 
+    /**
+     * lastTriggeredImageID represents the sha/id of the ImageStreamTag when a Build for this BuildConfig was started. The lastTriggeredImageID is updated each time a Build for this BuildConfig is started, even if this ImageStreamTag is not the reason the Build is started.
+     */
     @JsonProperty("lastTriggeredImageID")
     public String getLastTriggeredImageID() {
         return lastTriggeredImageID;
     }
 
+    /**
+     * lastTriggeredImageID represents the sha/id of the ImageStreamTag when a Build for this BuildConfig was started. The lastTriggeredImageID is updated each time a Build for this BuildConfig is started, even if this ImageStreamTag is not the reason the Build is started.
+     */
     @JsonProperty("lastTriggeredImageID")
     public void setLastTriggeredImageID(String lastTriggeredImageID) {
         this.lastTriggeredImageID = lastTriggeredImageID;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageImportSpec.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageImportSpec.java
index 8d104a122e0..792d9ef743b 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageImportSpec.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageImportSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageImportSpec describes a request to import a specific image.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public ImageImportSpec(ObjectReference from, TagImportPolicy importPolicy, Boole
         this.to = to;
     }
 
+    /**
+     * ImageImportSpec describes a request to import a specific image.
+     */
     @JsonProperty("from")
     public ObjectReference getFrom() {
         return from;
     }
 
+    /**
+     * ImageImportSpec describes a request to import a specific image.
+     */
     @JsonProperty("from")
     public void setFrom(ObjectReference from) {
         this.from = from;
     }
 
+    /**
+     * ImageImportSpec describes a request to import a specific image.
+     */
     @JsonProperty("importPolicy")
     public TagImportPolicy getImportPolicy() {
         return importPolicy;
     }
 
+    /**
+     * ImageImportSpec describes a request to import a specific image.
+     */
     @JsonProperty("importPolicy")
     public void setImportPolicy(TagImportPolicy importPolicy) {
         this.importPolicy = importPolicy;
     }
 
+    /**
+     * IncludeManifest determines if the manifest for each image is returned in the response
+     */
     @JsonProperty("includeManifest")
     public Boolean getIncludeManifest() {
         return includeManifest;
     }
 
+    /**
+     * IncludeManifest determines if the manifest for each image is returned in the response
+     */
     @JsonProperty("includeManifest")
     public void setIncludeManifest(Boolean includeManifest) {
         this.includeManifest = includeManifest;
     }
 
+    /**
+     * ImageImportSpec describes a request to import a specific image.
+     */
     @JsonProperty("referencePolicy")
     public TagReferencePolicy getReferencePolicy() {
         return referencePolicy;
     }
 
+    /**
+     * ImageImportSpec describes a request to import a specific image.
+     */
     @JsonProperty("referencePolicy")
     public void setReferencePolicy(TagReferencePolicy referencePolicy) {
         this.referencePolicy = referencePolicy;
     }
 
+    /**
+     * ImageImportSpec describes a request to import a specific image.
+     */
     @JsonProperty("to")
     public LocalObjectReference getTo() {
         return to;
     }
 
+    /**
+     * ImageImportSpec describes a request to import a specific image.
+     */
     @JsonProperty("to")
     public void setTo(LocalObjectReference to) {
         this.to = to;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageImportStatus.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageImportStatus.java
index 7cb58d4ac42..5cd07a29039 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageImportStatus.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageImportStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageImportStatus describes the result of an image import.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,42 +97,66 @@ public ImageImportStatus(Image image, List<Image> manifests, Status status, Stri
         this.tag = tag;
     }
 
+    /**
+     * ImageImportStatus describes the result of an image import.
+     */
     @JsonProperty("image")
     public Image getImage() {
         return image;
     }
 
+    /**
+     * ImageImportStatus describes the result of an image import.
+     */
     @JsonProperty("image")
     public void setImage(Image image) {
         this.image = image;
     }
 
+    /**
+     * Manifests holds sub-manifests metadata when importing a manifest list
+     */
     @JsonProperty("manifests")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Image> getManifests() {
         return manifests;
     }
 
+    /**
+     * Manifests holds sub-manifests metadata when importing a manifest list
+     */
     @JsonProperty("manifests")
     public void setManifests(List<Image> manifests) {
         this.manifests = manifests;
     }
 
+    /**
+     * ImageImportStatus describes the result of an image import.
+     */
     @JsonProperty("status")
     public Status getStatus() {
         return status;
     }
 
+    /**
+     * ImageImportStatus describes the result of an image import.
+     */
     @JsonProperty("status")
     public void setStatus(Status status) {
         this.status = status;
     }
 
+    /**
+     * Tag is the tag this image was located under, if any
+     */
     @JsonProperty("tag")
     public String getTag() {
         return tag;
     }
 
+    /**
+     * Tag is the tag this image was located under, if any
+     */
     @JsonProperty("tag")
     public void setTag(String tag) {
         this.tag = tag;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageLabel.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageLabel.java
index fc4605681ec..25fb7d0ef8e 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageLabel.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageLabel.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageLabel represents a label applied to the resulting image.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ImageLabel(String name, String value) {
         this.value = value;
     }
 
+    /**
+     * name defines the name of the label. It must have non-zero length.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name defines the name of the label. It must have non-zero length.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * value defines the literal value of the label.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * value defines the literal value of the label.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageLayer.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageLayer.java
index cd25473a992..bed382e63af 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageLayer.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageLayer.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageLayer represents a single layer of the image. Some images may have multiple layers. Some may have none.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ImageLayer(String mediaType, String name, Long size) {
         this.size = size;
     }
 
+    /**
+     * MediaType of the referenced object.
+     */
     @JsonProperty("mediaType")
     public String getMediaType() {
         return mediaType;
     }
 
+    /**
+     * MediaType of the referenced object.
+     */
     @JsonProperty("mediaType")
     public void setMediaType(String mediaType) {
         this.mediaType = mediaType;
     }
 
+    /**
+     * Name of the layer as defined by the underlying store.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the layer as defined by the underlying store.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Size of the layer in bytes as defined by the underlying store.
+     */
     @JsonProperty("size")
     public Long getSize() {
         return size;
     }
 
+    /**
+     * Size of the layer in bytes as defined by the underlying store.
+     */
     @JsonProperty("size")
     public void setSize(Long size) {
         this.size = size;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageLayerData.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageLayerData.java
index af8dc1aec1a..586fd81b3a1 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageLayerData.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageLayerData.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageLayerData contains metadata about an image layer.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ImageLayerData(String mediaType, Long size) {
         this.size = size;
     }
 
+    /**
+     * MediaType of the referenced object.
+     */
     @JsonProperty("mediaType")
     public String getMediaType() {
         return mediaType;
     }
 
+    /**
+     * MediaType of the referenced object.
+     */
     @JsonProperty("mediaType")
     public void setMediaType(String mediaType) {
         this.mediaType = mediaType;
     }
 
+    /**
+     * Size of the layer in bytes as defined by the underlying store. This field is optional if the necessary information about size is not available.
+     */
     @JsonProperty("size")
     public Long getSize() {
         return size;
     }
 
+    /**
+     * Size of the layer in bytes as defined by the underlying store. This field is optional if the necessary information about size is not available.
+     */
     @JsonProperty("size")
     public void setSize(Long size) {
         this.size = size;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageList.java
index 626999d016c..e76ae86da1e 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageList is a list of Image objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ImageList implements Editable<ImageListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.Image>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "image.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.Image> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ImageList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ImageList(String apiVersion, List<io.fabric8.openshift.api.model.Image> i
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of images
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.Image> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of images
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.Image> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ImageList is a list of Image objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ImageList is a list of Image objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageLookupPolicy.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageLookupPolicy.java
index ebd5c7b2cbc..56989e67ee0 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageLookupPolicy.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageLookupPolicy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageLookupPolicy describes how an image stream can be used to override the image references used by pods, builds, and other resources in a namespace.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public ImageLookupPolicy(Boolean local) {
         this.local = local;
     }
 
+    /**
+     * local will change the docker short image references (like "mysql" or "php:latest") on objects in this namespace to the image ID whenever they match this image stream, instead of reaching out to a remote registry. The name will be fully qualified to an image ID if found. The tag's referencePolicy is taken into account on the replaced value. Only works within the current namespace.
+     */
     @JsonProperty("local")
     public Boolean getLocal() {
         return local;
     }
 
+    /**
+     * local will change the docker short image references (like "mysql" or "php:latest") on objects in this namespace to the image ID whenever they match this image stream, instead of reaching out to a remote registry. The name will be fully qualified to an image ID if found. The tag's referencePolicy is taken into account on the replaced value. Only works within the current namespace.
+     */
     @JsonProperty("local")
     public void setLocal(Boolean local) {
         this.local = local;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageManifest.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageManifest.java
index 9614d6313b5..aed52595251 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageManifest.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageManifest.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageManifest represents sub-manifests of a manifest list. The Digest field points to a regular Image object.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public ImageManifest(String architecture, String digest, Long manifestSize, Stri
         this.variant = variant;
     }
 
+    /**
+     * Architecture specifies the supported CPU architecture, for example `amd64` or `ppc64le`.
+     */
     @JsonProperty("architecture")
     public String getArchitecture() {
         return architecture;
     }
 
+    /**
+     * Architecture specifies the supported CPU architecture, for example `amd64` or `ppc64le`.
+     */
     @JsonProperty("architecture")
     public void setArchitecture(String architecture) {
         this.architecture = architecture;
     }
 
+    /**
+     * Digest is the unique identifier for the manifest. It refers to an Image object.
+     */
     @JsonProperty("digest")
     public String getDigest() {
         return digest;
     }
 
+    /**
+     * Digest is the unique identifier for the manifest. It refers to an Image object.
+     */
     @JsonProperty("digest")
     public void setDigest(String digest) {
         this.digest = digest;
     }
 
+    /**
+     * ManifestSize represents the size of the raw object contents, in bytes.
+     */
     @JsonProperty("manifestSize")
     public Long getManifestSize() {
         return manifestSize;
     }
 
+    /**
+     * ManifestSize represents the size of the raw object contents, in bytes.
+     */
     @JsonProperty("manifestSize")
     public void setManifestSize(Long manifestSize) {
         this.manifestSize = manifestSize;
     }
 
+    /**
+     * MediaType defines the type of the manifest, possible values are application/vnd.oci.image.manifest.v1+json, application/vnd.docker.distribution.manifest.v2+json or application/vnd.docker.distribution.manifest.v1+json.
+     */
     @JsonProperty("mediaType")
     public String getMediaType() {
         return mediaType;
     }
 
+    /**
+     * MediaType defines the type of the manifest, possible values are application/vnd.oci.image.manifest.v1+json, application/vnd.docker.distribution.manifest.v2+json or application/vnd.docker.distribution.manifest.v1+json.
+     */
     @JsonProperty("mediaType")
     public void setMediaType(String mediaType) {
         this.mediaType = mediaType;
     }
 
+    /**
+     * OS specifies the operating system, for example `linux`.
+     */
     @JsonProperty("os")
     public String getOs() {
         return os;
     }
 
+    /**
+     * OS specifies the operating system, for example `linux`.
+     */
     @JsonProperty("os")
     public void setOs(String os) {
         this.os = os;
     }
 
+    /**
+     * Variant is an optional field repreenting a variant of the CPU, for example v6 to specify a particular CPU variant of the ARM CPU.
+     */
     @JsonProperty("variant")
     public String getVariant() {
         return variant;
     }
 
+    /**
+     * Variant is an optional field repreenting a variant of the CPU, for example v6 to specify a particular CPU variant of the ARM CPU.
+     */
     @JsonProperty("variant")
     public void setVariant(String variant) {
         this.variant = variant;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageSignature.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageSignature.java
index ba9ab691704..4c59b610e18 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageSignature.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageSignature.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageSignature holds a signature of an image. It allows to verify image identity and possibly other claims as long as the signature is trusted. Based on this information it is possible to restrict runnable images to those matching cluster-wide policy. Mandatory fields should be parsed by clients doing image verification. The others are parsed from signature's content by the server. They serve just an informative purpose.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,9 +86,6 @@
 public class ImageSignature implements Editable<ImageSignatureBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "image.openshift.io/v1";
     @JsonProperty("conditions")
@@ -101,9 +101,6 @@ public class ImageSignature implements Editable<ImageSignatureBuilder>, HasMetad
     private SignatureIssuer issuedBy;
     @JsonProperty("issuedTo")
     private SignatureSubject issuedTo;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ImageSignature";
     @JsonProperty("metadata")
@@ -138,7 +135,7 @@ public ImageSignature(String apiVersion, List<SignatureCondition> conditions, St
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -146,76 +143,112 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Conditions represent the latest available observations of a signature's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<SignatureCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions represent the latest available observations of a signature's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<SignatureCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Required: An opaque binary string which is an image's signature.
+     */
     @JsonProperty("content")
     public String getContent() {
         return content;
     }
 
+    /**
+     * Required: An opaque binary string which is an image's signature.
+     */
     @JsonProperty("content")
     public void setContent(String content) {
         this.content = content;
     }
 
+    /**
+     * ImageSignature holds a signature of an image. It allows to verify image identity and possibly other claims as long as the signature is trusted. Based on this information it is possible to restrict runnable images to those matching cluster-wide policy. Mandatory fields should be parsed by clients doing image verification. The others are parsed from signature's content by the server. They serve just an informative purpose.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("created")
     public String getCreated() {
         return created;
     }
 
+    /**
+     * ImageSignature holds a signature of an image. It allows to verify image identity and possibly other claims as long as the signature is trusted. Based on this information it is possible to restrict runnable images to those matching cluster-wide policy. Mandatory fields should be parsed by clients doing image verification. The others are parsed from signature's content by the server. They serve just an informative purpose.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("created")
     public void setCreated(String created) {
         this.created = created;
     }
 
+    /**
+     * A human readable string representing image's identity. It could be a product name and version, or an image pull spec (e.g. "registry.access.redhat.com/rhel7/rhel:7.2").
+     */
     @JsonProperty("imageIdentity")
     public String getImageIdentity() {
         return imageIdentity;
     }
 
+    /**
+     * A human readable string representing image's identity. It could be a product name and version, or an image pull spec (e.g. "registry.access.redhat.com/rhel7/rhel:7.2").
+     */
     @JsonProperty("imageIdentity")
     public void setImageIdentity(String imageIdentity) {
         this.imageIdentity = imageIdentity;
     }
 
+    /**
+     * ImageSignature holds a signature of an image. It allows to verify image identity and possibly other claims as long as the signature is trusted. Based on this information it is possible to restrict runnable images to those matching cluster-wide policy. Mandatory fields should be parsed by clients doing image verification. The others are parsed from signature's content by the server. They serve just an informative purpose.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("issuedBy")
     public SignatureIssuer getIssuedBy() {
         return issuedBy;
     }
 
+    /**
+     * ImageSignature holds a signature of an image. It allows to verify image identity and possibly other claims as long as the signature is trusted. Based on this information it is possible to restrict runnable images to those matching cluster-wide policy. Mandatory fields should be parsed by clients doing image verification. The others are parsed from signature's content by the server. They serve just an informative purpose.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("issuedBy")
     public void setIssuedBy(SignatureIssuer issuedBy) {
         this.issuedBy = issuedBy;
     }
 
+    /**
+     * ImageSignature holds a signature of an image. It allows to verify image identity and possibly other claims as long as the signature is trusted. Based on this information it is possible to restrict runnable images to those matching cluster-wide policy. Mandatory fields should be parsed by clients doing image verification. The others are parsed from signature's content by the server. They serve just an informative purpose.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("issuedTo")
     public SignatureSubject getIssuedTo() {
         return issuedTo;
     }
 
+    /**
+     * ImageSignature holds a signature of an image. It allows to verify image identity and possibly other claims as long as the signature is trusted. Based on this information it is possible to restrict runnable images to those matching cluster-wide policy. Mandatory fields should be parsed by clients doing image verification. The others are parsed from signature's content by the server. They serve just an informative purpose.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("issuedTo")
     public void setIssuedTo(SignatureSubject issuedTo) {
         this.issuedTo = issuedTo;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -223,39 +256,57 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ImageSignature holds a signature of an image. It allows to verify image identity and possibly other claims as long as the signature is trusted. Based on this information it is possible to restrict runnable images to those matching cluster-wide policy. Mandatory fields should be parsed by clients doing image verification. The others are parsed from signature's content by the server. They serve just an informative purpose.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ImageSignature holds a signature of an image. It allows to verify image identity and possibly other claims as long as the signature is trusted. Based on this information it is possible to restrict runnable images to those matching cluster-wide policy. Mandatory fields should be parsed by clients doing image verification. The others are parsed from signature's content by the server. They serve just an informative purpose.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Contains claims from the signature.
+     */
     @JsonProperty("signedClaims")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getSignedClaims() {
         return signedClaims;
     }
 
+    /**
+     * Contains claims from the signature.
+     */
     @JsonProperty("signedClaims")
     public void setSignedClaims(Map<String, String> signedClaims) {
         this.signedClaims = signedClaims;
     }
 
+    /**
+     * Required: Describes a type of stored blob.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Required: Describes a type of stored blob.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageSource.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageSource.java
index 0b6922832ce..7de63199120 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageSource.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageSource.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageSource is used to describe build source that will be extracted from an image or used during a multi stage build. A reference of type ImageStreamTag, ImageStreamImage or DockerImage may be used. A pull secret can be specified to pull the image from an external registry or override the default service account secret if pulling from the internal registry. Image sources can either be used to extract content from an image and place it into the build context along with the repository source, or used directly during a multi-stage container image build to allow content to be copied without overwriting the contents of the repository source (see the 'paths' and 'as' fields).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,43 +97,67 @@ public ImageSource(List<String> as, ObjectReference from, List<ImageSourcePath>
         this.pullSecret = pullSecret;
     }
 
+    /**
+     * A list of image names that this source will be used in place of during a multi-stage container image build. For instance, a Dockerfile that uses "COPY --from=nginx:latest" will first check for an image source that has "nginx:latest" in this field before attempting to pull directly. If the Dockerfile does not reference an image source it is ignored. This field and paths may both be set, in which case the contents will be used twice.
+     */
     @JsonProperty("as")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAs() {
         return as;
     }
 
+    /**
+     * A list of image names that this source will be used in place of during a multi-stage container image build. For instance, a Dockerfile that uses "COPY --from=nginx:latest" will first check for an image source that has "nginx:latest" in this field before attempting to pull directly. If the Dockerfile does not reference an image source it is ignored. This field and paths may both be set, in which case the contents will be used twice.
+     */
     @JsonProperty("as")
     public void setAs(List<String> as) {
         this.as = as;
     }
 
+    /**
+     * ImageSource is used to describe build source that will be extracted from an image or used during a multi stage build. A reference of type ImageStreamTag, ImageStreamImage or DockerImage may be used. A pull secret can be specified to pull the image from an external registry or override the default service account secret if pulling from the internal registry. Image sources can either be used to extract content from an image and place it into the build context along with the repository source, or used directly during a multi-stage container image build to allow content to be copied without overwriting the contents of the repository source (see the 'paths' and 'as' fields).
+     */
     @JsonProperty("from")
     public ObjectReference getFrom() {
         return from;
     }
 
+    /**
+     * ImageSource is used to describe build source that will be extracted from an image or used during a multi stage build. A reference of type ImageStreamTag, ImageStreamImage or DockerImage may be used. A pull secret can be specified to pull the image from an external registry or override the default service account secret if pulling from the internal registry. Image sources can either be used to extract content from an image and place it into the build context along with the repository source, or used directly during a multi-stage container image build to allow content to be copied without overwriting the contents of the repository source (see the 'paths' and 'as' fields).
+     */
     @JsonProperty("from")
     public void setFrom(ObjectReference from) {
         this.from = from;
     }
 
+    /**
+     * paths is a list of source and destination paths to copy from the image. This content will be copied into the build context prior to starting the build. If no paths are set, the build context will not be altered.
+     */
     @JsonProperty("paths")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ImageSourcePath> getPaths() {
         return paths;
     }
 
+    /**
+     * paths is a list of source and destination paths to copy from the image. This content will be copied into the build context prior to starting the build. If no paths are set, the build context will not be altered.
+     */
     @JsonProperty("paths")
     public void setPaths(List<ImageSourcePath> paths) {
         this.paths = paths;
     }
 
+    /**
+     * ImageSource is used to describe build source that will be extracted from an image or used during a multi stage build. A reference of type ImageStreamTag, ImageStreamImage or DockerImage may be used. A pull secret can be specified to pull the image from an external registry or override the default service account secret if pulling from the internal registry. Image sources can either be used to extract content from an image and place it into the build context along with the repository source, or used directly during a multi-stage container image build to allow content to be copied without overwriting the contents of the repository source (see the 'paths' and 'as' fields).
+     */
     @JsonProperty("pullSecret")
     public LocalObjectReference getPullSecret() {
         return pullSecret;
     }
 
+    /**
+     * ImageSource is used to describe build source that will be extracted from an image or used during a multi stage build. A reference of type ImageStreamTag, ImageStreamImage or DockerImage may be used. A pull secret can be specified to pull the image from an external registry or override the default service account secret if pulling from the internal registry. Image sources can either be used to extract content from an image and place it into the build context along with the repository source, or used directly during a multi-stage container image build to allow content to be copied without overwriting the contents of the repository source (see the 'paths' and 'as' fields).
+     */
     @JsonProperty("pullSecret")
     public void setPullSecret(LocalObjectReference pullSecret) {
         this.pullSecret = pullSecret;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageSourcePath.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageSourcePath.java
index 672e9ffb7f8..24a36eb7ed2 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageSourcePath.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageSourcePath.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageSourcePath describes a path to be copied from a source image and its destination within the build directory.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ImageSourcePath(String destinationDir, String sourcePath) {
         this.sourcePath = sourcePath;
     }
 
+    /**
+     * destinationDir is the relative directory within the build directory where files copied from the image are placed.
+     */
     @JsonProperty("destinationDir")
     public String getDestinationDir() {
         return destinationDir;
     }
 
+    /**
+     * destinationDir is the relative directory within the build directory where files copied from the image are placed.
+     */
     @JsonProperty("destinationDir")
     public void setDestinationDir(String destinationDir) {
         this.destinationDir = destinationDir;
     }
 
+    /**
+     * sourcePath is the absolute path of the file or directory inside the image to copy to the build directory.  If the source path ends in /. then the content of the directory will be copied, but the directory itself will not be created at the destination.
+     */
     @JsonProperty("sourcePath")
     public String getSourcePath() {
         return sourcePath;
     }
 
+    /**
+     * sourcePath is the absolute path of the file or directory inside the image to copy to the build directory.  If the source path ends in /. then the content of the directory will be copied, but the directory itself will not be created at the destination.
+     */
     @JsonProperty("sourcePath")
     public void setSourcePath(String sourcePath) {
         this.sourcePath = sourcePath;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStream.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStream.java
index 9338730b35d..9a333c52c89 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStream.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStream.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * An ImageStream stores a mapping of tags to images, metadata overrides that are applied when images are tagged in a stream, and an optional reference to a container image repository on a registry. Users typically update the spec.tags field to point to external images which are imported from container registries using credentials in your namespace with the pull secret type, or to existing image stream tags and images which are immediately accessible for tagging or pulling. The history of images applied to a tag is visible in the status.tags field and any user who can view an image stream is allowed to tag that image into their own image streams. Access to pull images from the integrated registry is granted by having the "get imagestreams/layers" permission on a given image stream. Users may remove a tag by deleting the imagestreamtag resource, which causes both spec and status for that tag to be removed. Image stream history is retained until an administrator runs the prune operation, which removes references that are no longer in use. To preserve a historical image, ensure there is a tag in spec pointing to that image by its digest.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class ImageStream implements Editable<ImageStreamBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "image.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ImageStream";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ImageStream(String apiVersion, String kind, ObjectMeta metadata, ImageStr
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * An ImageStream stores a mapping of tags to images, metadata overrides that are applied when images are tagged in a stream, and an optional reference to a container image repository on a registry. Users typically update the spec.tags field to point to external images which are imported from container registries using credentials in your namespace with the pull secret type, or to existing image stream tags and images which are immediately accessible for tagging or pulling. The history of images applied to a tag is visible in the status.tags field and any user who can view an image stream is allowed to tag that image into their own image streams. Access to pull images from the integrated registry is granted by having the "get imagestreams/layers" permission on a given image stream. Users may remove a tag by deleting the imagestreamtag resource, which causes both spec and status for that tag to be removed. Image stream history is retained until an administrator runs the prune operation, which removes references that are no longer in use. To preserve a historical image, ensure there is a tag in spec pointing to that image by its digest.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * An ImageStream stores a mapping of tags to images, metadata overrides that are applied when images are tagged in a stream, and an optional reference to a container image repository on a registry. Users typically update the spec.tags field to point to external images which are imported from container registries using credentials in your namespace with the pull secret type, or to existing image stream tags and images which are immediately accessible for tagging or pulling. The history of images applied to a tag is visible in the status.tags field and any user who can view an image stream is allowed to tag that image into their own image streams. Access to pull images from the integrated registry is granted by having the "get imagestreams/layers" permission on a given image stream. Users may remove a tag by deleting the imagestreamtag resource, which causes both spec and status for that tag to be removed. Image stream history is retained until an administrator runs the prune operation, which removes references that are no longer in use. To preserve a historical image, ensure there is a tag in spec pointing to that image by its digest.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * An ImageStream stores a mapping of tags to images, metadata overrides that are applied when images are tagged in a stream, and an optional reference to a container image repository on a registry. Users typically update the spec.tags field to point to external images which are imported from container registries using credentials in your namespace with the pull secret type, or to existing image stream tags and images which are immediately accessible for tagging or pulling. The history of images applied to a tag is visible in the status.tags field and any user who can view an image stream is allowed to tag that image into their own image streams. Access to pull images from the integrated registry is granted by having the "get imagestreams/layers" permission on a given image stream. Users may remove a tag by deleting the imagestreamtag resource, which causes both spec and status for that tag to be removed. Image stream history is retained until an administrator runs the prune operation, which removes references that are no longer in use. To preserve a historical image, ensure there is a tag in spec pointing to that image by its digest.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ImageStreamSpec getSpec() {
         return spec;
     }
 
+    /**
+     * An ImageStream stores a mapping of tags to images, metadata overrides that are applied when images are tagged in a stream, and an optional reference to a container image repository on a registry. Users typically update the spec.tags field to point to external images which are imported from container registries using credentials in your namespace with the pull secret type, or to existing image stream tags and images which are immediately accessible for tagging or pulling. The history of images applied to a tag is visible in the status.tags field and any user who can view an image stream is allowed to tag that image into their own image streams. Access to pull images from the integrated registry is granted by having the "get imagestreams/layers" permission on a given image stream. Users may remove a tag by deleting the imagestreamtag resource, which causes both spec and status for that tag to be removed. Image stream history is retained until an administrator runs the prune operation, which removes references that are no longer in use. To preserve a historical image, ensure there is a tag in spec pointing to that image by its digest.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ImageStreamSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * An ImageStream stores a mapping of tags to images, metadata overrides that are applied when images are tagged in a stream, and an optional reference to a container image repository on a registry. Users typically update the spec.tags field to point to external images which are imported from container registries using credentials in your namespace with the pull secret type, or to existing image stream tags and images which are immediately accessible for tagging or pulling. The history of images applied to a tag is visible in the status.tags field and any user who can view an image stream is allowed to tag that image into their own image streams. Access to pull images from the integrated registry is granted by having the "get imagestreams/layers" permission on a given image stream. Users may remove a tag by deleting the imagestreamtag resource, which causes both spec and status for that tag to be removed. Image stream history is retained until an administrator runs the prune operation, which removes references that are no longer in use. To preserve a historical image, ensure there is a tag in spec pointing to that image by its digest.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public ImageStreamStatus getStatus() {
         return status;
     }
 
+    /**
+     * An ImageStream stores a mapping of tags to images, metadata overrides that are applied when images are tagged in a stream, and an optional reference to a container image repository on a registry. Users typically update the spec.tags field to point to external images which are imported from container registries using credentials in your namespace with the pull secret type, or to existing image stream tags and images which are immediately accessible for tagging or pulling. The history of images applied to a tag is visible in the status.tags field and any user who can view an image stream is allowed to tag that image into their own image streams. Access to pull images from the integrated registry is granted by having the "get imagestreams/layers" permission on a given image stream. Users may remove a tag by deleting the imagestreamtag resource, which causes both spec and status for that tag to be removed. Image stream history is retained until an administrator runs the prune operation, which removes references that are no longer in use. To preserve a historical image, ensure there is a tag in spec pointing to that image by its digest.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(ImageStreamStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamImage.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamImage.java
index 3a2d3fc80d5..52d70e70d71 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamImage.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamImage.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageStreamImage represents an Image that is retrieved by image name from an ImageStream. User interfaces and regular users can use this resource to access the metadata details of a tagged image in the image stream history for viewing, since Image resources are not directly accessible to end users. A not found error will be returned if no such image is referenced by a tag within the ImageStream. Images are created when spec tags are set on an image stream that represent an image in an external registry, when pushing to the integrated registry, or when tagging an existing image from one image stream to another. The name of an image stream image is in the form "&lt;STREAM&gt;@&lt;DIGEST&gt;", where the digest is the content addressible identifier for the image (sha256:xxxxx...). You can use ImageStreamImages as the from.kind of an image stream spec tag to reference an image exactly. The only operations supported on the imagestreamimage endpoint are retrieving the image.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,16 +78,10 @@
 public class ImageStreamImage implements Editable<ImageStreamImageBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "image.openshift.io/v1";
     @JsonProperty("image")
     private Image image;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ImageStreamImage";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public ImageStreamImage(String apiVersion, Image image, String kind, ObjectMeta
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,25 +112,31 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ImageStreamImage represents an Image that is retrieved by image name from an ImageStream. User interfaces and regular users can use this resource to access the metadata details of a tagged image in the image stream history for viewing, since Image resources are not directly accessible to end users. A not found error will be returned if no such image is referenced by a tag within the ImageStream. Images are created when spec tags are set on an image stream that represent an image in an external registry, when pushing to the integrated registry, or when tagging an existing image from one image stream to another. The name of an image stream image is in the form "&lt;STREAM&gt;@&lt;DIGEST&gt;", where the digest is the content addressible identifier for the image (sha256:xxxxx...). You can use ImageStreamImages as the from.kind of an image stream spec tag to reference an image exactly. The only operations supported on the imagestreamimage endpoint are retrieving the image.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("image")
     public Image getImage() {
         return image;
     }
 
+    /**
+     * ImageStreamImage represents an Image that is retrieved by image name from an ImageStream. User interfaces and regular users can use this resource to access the metadata details of a tagged image in the image stream history for viewing, since Image resources are not directly accessible to end users. A not found error will be returned if no such image is referenced by a tag within the ImageStream. Images are created when spec tags are set on an image stream that represent an image in an external registry, when pushing to the integrated registry, or when tagging an existing image from one image stream to another. The name of an image stream image is in the form "&lt;STREAM&gt;@&lt;DIGEST&gt;", where the digest is the content addressible identifier for the image (sha256:xxxxx...). You can use ImageStreamImages as the from.kind of an image stream spec tag to reference an image exactly. The only operations supported on the imagestreamimage endpoint are retrieving the image.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("image")
     public void setImage(Image image) {
         this.image = image;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -141,18 +144,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ImageStreamImage represents an Image that is retrieved by image name from an ImageStream. User interfaces and regular users can use this resource to access the metadata details of a tagged image in the image stream history for viewing, since Image resources are not directly accessible to end users. A not found error will be returned if no such image is referenced by a tag within the ImageStream. Images are created when spec tags are set on an image stream that represent an image in an external registry, when pushing to the integrated registry, or when tagging an existing image from one image stream to another. The name of an image stream image is in the form "&lt;STREAM&gt;@&lt;DIGEST&gt;", where the digest is the content addressible identifier for the image (sha256:xxxxx...). You can use ImageStreamImages as the from.kind of an image stream spec tag to reference an image exactly. The only operations supported on the imagestreamimage endpoint are retrieving the image.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ImageStreamImage represents an Image that is retrieved by image name from an ImageStream. User interfaces and regular users can use this resource to access the metadata details of a tagged image in the image stream history for viewing, since Image resources are not directly accessible to end users. A not found error will be returned if no such image is referenced by a tag within the ImageStream. Images are created when spec tags are set on an image stream that represent an image in an external registry, when pushing to the integrated registry, or when tagging an existing image from one image stream to another. The name of an image stream image is in the form "&lt;STREAM&gt;@&lt;DIGEST&gt;", where the digest is the content addressible identifier for the image (sha256:xxxxx...). You can use ImageStreamImages as the from.kind of an image stream spec tag to reference an image exactly. The only operations supported on the imagestreamimage endpoint are retrieving the image.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamImport.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamImport.java
index b2077f64842..eb05951d242 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamImport.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamImport.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * The image stream import resource provides an easy way for a user to find and import container images from other container image registries into the server. Individual images or an entire image repository may be imported, and users may choose to see the results of the import prior to tagging the resulting images into the specified image stream.<br><p> <br><p> This API is intended for end-user tools that need to see the metadata of the image prior to import (for instance, to generate an application from it). Clients that know the desired image can continue to create spec.tags directly into their image streams.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class ImageStreamImport implements Editable<ImageStreamImportBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "image.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ImageStreamImport";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ImageStreamImport(String apiVersion, String kind, ObjectMeta metadata, Im
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * The image stream import resource provides an easy way for a user to find and import container images from other container image registries into the server. Individual images or an entire image repository may be imported, and users may choose to see the results of the import prior to tagging the resulting images into the specified image stream.<br><p> <br><p> This API is intended for end-user tools that need to see the metadata of the image prior to import (for instance, to generate an application from it). Clients that know the desired image can continue to create spec.tags directly into their image streams.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * The image stream import resource provides an easy way for a user to find and import container images from other container image registries into the server. Individual images or an entire image repository may be imported, and users may choose to see the results of the import prior to tagging the resulting images into the specified image stream.<br><p> <br><p> This API is intended for end-user tools that need to see the metadata of the image prior to import (for instance, to generate an application from it). Clients that know the desired image can continue to create spec.tags directly into their image streams.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * The image stream import resource provides an easy way for a user to find and import container images from other container image registries into the server. Individual images or an entire image repository may be imported, and users may choose to see the results of the import prior to tagging the resulting images into the specified image stream.<br><p> <br><p> This API is intended for end-user tools that need to see the metadata of the image prior to import (for instance, to generate an application from it). Clients that know the desired image can continue to create spec.tags directly into their image streams.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ImageStreamImportSpec getSpec() {
         return spec;
     }
 
+    /**
+     * The image stream import resource provides an easy way for a user to find and import container images from other container image registries into the server. Individual images or an entire image repository may be imported, and users may choose to see the results of the import prior to tagging the resulting images into the specified image stream.<br><p> <br><p> This API is intended for end-user tools that need to see the metadata of the image prior to import (for instance, to generate an application from it). Clients that know the desired image can continue to create spec.tags directly into their image streams.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ImageStreamImportSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * The image stream import resource provides an easy way for a user to find and import container images from other container image registries into the server. Individual images or an entire image repository may be imported, and users may choose to see the results of the import prior to tagging the resulting images into the specified image stream.<br><p> <br><p> This API is intended for end-user tools that need to see the metadata of the image prior to import (for instance, to generate an application from it). Clients that know the desired image can continue to create spec.tags directly into their image streams.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public ImageStreamImportStatus getStatus() {
         return status;
     }
 
+    /**
+     * The image stream import resource provides an easy way for a user to find and import container images from other container image registries into the server. Individual images or an entire image repository may be imported, and users may choose to see the results of the import prior to tagging the resulting images into the specified image stream.<br><p> <br><p> This API is intended for end-user tools that need to see the metadata of the image prior to import (for instance, to generate an application from it). Clients that know the desired image can continue to create spec.tags directly into their image streams.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(ImageStreamImportStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamImportSpec.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamImportSpec.java
index 83a9427497d..56d0d2a52e7 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamImportSpec.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamImportSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageStreamImportSpec defines what images should be imported.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public ImageStreamImportSpec(List<ImageImportSpec> images, Boolean _import, Repo
         this.repository = repository;
     }
 
+    /**
+     * Images are a list of individual images to import.
+     */
     @JsonProperty("images")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ImageImportSpec> getImages() {
         return images;
     }
 
+    /**
+     * Images are a list of individual images to import.
+     */
     @JsonProperty("images")
     public void setImages(List<ImageImportSpec> images) {
         this.images = images;
     }
 
+    /**
+     * Import indicates whether to perform an import - if so, the specified tags are set on the spec and status of the image stream defined by the type meta.
+     */
     @JsonProperty("import")
     public Boolean getImport() {
         return _import;
     }
 
+    /**
+     * Import indicates whether to perform an import - if so, the specified tags are set on the spec and status of the image stream defined by the type meta.
+     */
     @JsonProperty("import")
     public void setImport(Boolean _import) {
         this._import = _import;
     }
 
+    /**
+     * ImageStreamImportSpec defines what images should be imported.
+     */
     @JsonProperty("repository")
     public RepositoryImportSpec getRepository() {
         return repository;
     }
 
+    /**
+     * ImageStreamImportSpec defines what images should be imported.
+     */
     @JsonProperty("repository")
     public void setRepository(RepositoryImportSpec repository) {
         this.repository = repository;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamImportStatus.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamImportStatus.java
index 6c862e5702a..22b3c531fe5 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamImportStatus.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamImportStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageStreamImportStatus contains information about the status of an image stream import.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public ImageStreamImportStatus(List<ImageImportStatus> images, ImageStream _impo
         this.repository = repository;
     }
 
+    /**
+     * Images is set with the result of importing spec.images
+     */
     @JsonProperty("images")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ImageImportStatus> getImages() {
         return images;
     }
 
+    /**
+     * Images is set with the result of importing spec.images
+     */
     @JsonProperty("images")
     public void setImages(List<ImageImportStatus> images) {
         this.images = images;
     }
 
+    /**
+     * ImageStreamImportStatus contains information about the status of an image stream import.
+     */
     @JsonProperty("import")
     public ImageStream getImport() {
         return _import;
     }
 
+    /**
+     * ImageStreamImportStatus contains information about the status of an image stream import.
+     */
     @JsonProperty("import")
     public void setImport(ImageStream _import) {
         this._import = _import;
     }
 
+    /**
+     * ImageStreamImportStatus contains information about the status of an image stream import.
+     */
     @JsonProperty("repository")
     public RepositoryImportStatus getRepository() {
         return repository;
     }
 
+    /**
+     * ImageStreamImportStatus contains information about the status of an image stream import.
+     */
     @JsonProperty("repository")
     public void setRepository(RepositoryImportStatus repository) {
         this.repository = repository;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamLayers.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamLayers.java
index 9827d62b9d4..4c8b02daee0 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamLayers.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamLayers.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageStreamLayers describes information about the layers referenced by images in this image stream.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,9 +79,6 @@
 public class ImageStreamLayers implements Editable<ImageStreamLayersBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "image.openshift.io/v1";
     @JsonProperty("blobs")
@@ -87,9 +87,6 @@ public class ImageStreamLayers implements Editable<ImageStreamLayersBuilder>, Ha
     @JsonProperty("images")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private Map<String, ImageBlobReferences> images = new LinkedHashMap<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ImageStreamLayers";
     @JsonProperty("metadata")
@@ -113,7 +110,7 @@ public ImageStreamLayers(String apiVersion, Map<String, ImageLayerData> blobs, M
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -121,37 +118,49 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * blobs is a map of blob name to metadata about the blob.
+     */
     @JsonProperty("blobs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, ImageLayerData> getBlobs() {
         return blobs;
     }
 
+    /**
+     * blobs is a map of blob name to metadata about the blob.
+     */
     @JsonProperty("blobs")
     public void setBlobs(Map<String, ImageLayerData> blobs) {
         this.blobs = blobs;
     }
 
+    /**
+     * images is a map between an image name and the names of the blobs and config that comprise the image.
+     */
     @JsonProperty("images")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, ImageBlobReferences> getImages() {
         return images;
     }
 
+    /**
+     * images is a map between an image name and the names of the blobs and config that comprise the image.
+     */
     @JsonProperty("images")
     public void setImages(Map<String, ImageBlobReferences> images) {
         this.images = images;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -159,18 +168,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ImageStreamLayers describes information about the layers referenced by images in this image stream.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ImageStreamLayers describes information about the layers referenced by images in this image stream.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamList.java
index 7170e9173c6..7fcc728279b 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageStreamList is a list of ImageStream objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ImageStreamList implements Editable<ImageStreamListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.ImageStream>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "image.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.ImageStream> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ImageStreamList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ImageStreamList(String apiVersion, List<io.fabric8.openshift.api.model.Im
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of imageStreams
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.ImageStream> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of imageStreams
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.ImageStream> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ImageStreamList is a list of ImageStream objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ImageStreamList is a list of ImageStream objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamMapping.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamMapping.java
index 8913192856a..b065b43a158 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamMapping.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamMapping.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageStreamMapping represents a mapping from a single image stream tag to a container image as well as the reference to the container image stream the image came from. This resource is used by privileged integrators to create an image resource and to associate it with an image stream in the status tags field. Creating an ImageStreamMapping will allow any user who can view the image stream to tag or pull that image, so only create mappings where the user has proven they have access to the image contents directly. The only operation supported for this resource is create and the metadata name and namespace should be set to the image stream containing the tag that should be updated.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,16 +79,10 @@
 public class ImageStreamMapping implements Editable<ImageStreamMappingBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "image.openshift.io/v1";
     @JsonProperty("image")
     private Image image;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ImageStreamMapping";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ImageStreamMapping(String apiVersion, Image image, String kind, ObjectMet
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,25 +116,31 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ImageStreamMapping represents a mapping from a single image stream tag to a container image as well as the reference to the container image stream the image came from. This resource is used by privileged integrators to create an image resource and to associate it with an image stream in the status tags field. Creating an ImageStreamMapping will allow any user who can view the image stream to tag or pull that image, so only create mappings where the user has proven they have access to the image contents directly. The only operation supported for this resource is create and the metadata name and namespace should be set to the image stream containing the tag that should be updated.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("image")
     public Image getImage() {
         return image;
     }
 
+    /**
+     * ImageStreamMapping represents a mapping from a single image stream tag to a container image as well as the reference to the container image stream the image came from. This resource is used by privileged integrators to create an image resource and to associate it with an image stream in the status tags field. Creating an ImageStreamMapping will allow any user who can view the image stream to tag or pull that image, so only create mappings where the user has proven they have access to the image contents directly. The only operation supported for this resource is create and the metadata name and namespace should be set to the image stream containing the tag that should be updated.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("image")
     public void setImage(Image image) {
         this.image = image;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -145,28 +148,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ImageStreamMapping represents a mapping from a single image stream tag to a container image as well as the reference to the container image stream the image came from. This resource is used by privileged integrators to create an image resource and to associate it with an image stream in the status tags field. Creating an ImageStreamMapping will allow any user who can view the image stream to tag or pull that image, so only create mappings where the user has proven they have access to the image contents directly. The only operation supported for this resource is create and the metadata name and namespace should be set to the image stream containing the tag that should be updated.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ImageStreamMapping represents a mapping from a single image stream tag to a container image as well as the reference to the container image stream the image came from. This resource is used by privileged integrators to create an image resource and to associate it with an image stream in the status tags field. Creating an ImageStreamMapping will allow any user who can view the image stream to tag or pull that image, so only create mappings where the user has proven they have access to the image contents directly. The only operation supported for this resource is create and the metadata name and namespace should be set to the image stream containing the tag that should be updated.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Tag is a string value this image can be located with inside the stream.
+     */
     @JsonProperty("tag")
     public String getTag() {
         return tag;
     }
 
+    /**
+     * Tag is a string value this image can be located with inside the stream.
+     */
     @JsonProperty("tag")
     public void setTag(String tag) {
         this.tag = tag;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamSpec.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamSpec.java
index 9484e286712..c5af3c42745 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamSpec.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageStreamSpec represents options for ImageStreams.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public ImageStreamSpec(String dockerImageRepository, ImageLookupPolicy lookupPol
         this.tags = tags;
     }
 
+    /**
+     * dockerImageRepository is optional, if specified this stream is backed by a container repository on this server Deprecated: This field is deprecated as of v3.7 and will be removed in a future release. Specify the source for the tags to be imported in each tag via the spec.tags.from reference instead.
+     */
     @JsonProperty("dockerImageRepository")
     public String getDockerImageRepository() {
         return dockerImageRepository;
     }
 
+    /**
+     * dockerImageRepository is optional, if specified this stream is backed by a container repository on this server Deprecated: This field is deprecated as of v3.7 and will be removed in a future release. Specify the source for the tags to be imported in each tag via the spec.tags.from reference instead.
+     */
     @JsonProperty("dockerImageRepository")
     public void setDockerImageRepository(String dockerImageRepository) {
         this.dockerImageRepository = dockerImageRepository;
     }
 
+    /**
+     * ImageStreamSpec represents options for ImageStreams.
+     */
     @JsonProperty("lookupPolicy")
     public ImageLookupPolicy getLookupPolicy() {
         return lookupPolicy;
     }
 
+    /**
+     * ImageStreamSpec represents options for ImageStreams.
+     */
     @JsonProperty("lookupPolicy")
     public void setLookupPolicy(ImageLookupPolicy lookupPolicy) {
         this.lookupPolicy = lookupPolicy;
     }
 
+    /**
+     * tags map arbitrary string values to specific image locators
+     */
     @JsonProperty("tags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TagReference> getTags() {
         return tags;
     }
 
+    /**
+     * tags map arbitrary string values to specific image locators
+     */
     @JsonProperty("tags")
     public void setTags(List<TagReference> tags) {
         this.tags = tags;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamStatus.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamStatus.java
index d1a92bac03d..b59166bb70f 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamStatus.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageStreamStatus contains information about the state of this image stream.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public ImageStreamStatus(String dockerImageRepository, String publicDockerImageR
         this.tags = tags;
     }
 
+    /**
+     * DockerImageRepository represents the effective location this stream may be accessed at. May be empty until the server determines where the repository is located
+     */
     @JsonProperty("dockerImageRepository")
     public String getDockerImageRepository() {
         return dockerImageRepository;
     }
 
+    /**
+     * DockerImageRepository represents the effective location this stream may be accessed at. May be empty until the server determines where the repository is located
+     */
     @JsonProperty("dockerImageRepository")
     public void setDockerImageRepository(String dockerImageRepository) {
         this.dockerImageRepository = dockerImageRepository;
     }
 
+    /**
+     * PublicDockerImageRepository represents the public location from where the image can be pulled outside the cluster. This field may be empty if the administrator has not exposed the integrated registry externally.
+     */
     @JsonProperty("publicDockerImageRepository")
     public String getPublicDockerImageRepository() {
         return publicDockerImageRepository;
     }
 
+    /**
+     * PublicDockerImageRepository represents the public location from where the image can be pulled outside the cluster. This field may be empty if the administrator has not exposed the integrated registry externally.
+     */
     @JsonProperty("publicDockerImageRepository")
     public void setPublicDockerImageRepository(String publicDockerImageRepository) {
         this.publicDockerImageRepository = publicDockerImageRepository;
     }
 
+    /**
+     * Tags are a historical record of images associated with each tag. The first entry in the TagEvent array is the currently tagged image.
+     */
     @JsonProperty("tags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NamedTagEventList> getTags() {
         return tags;
     }
 
+    /**
+     * Tags are a historical record of images associated with each tag. The first entry in the TagEvent array is the currently tagged image.
+     */
     @JsonProperty("tags")
     public void setTags(List<NamedTagEventList> tags) {
         this.tags = tags;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamTag.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamTag.java
index 89b3ffe4d00..8cb68e09ee8 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamTag.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamTag.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageStreamTag represents an Image that is retrieved by tag name from an ImageStream. Use this resource to interact with the tags and images in an image stream by tag, or to see the image details for a particular tag. The image associated with this resource is the most recently successfully tagged, imported, or pushed image (as described in the image stream status.tags.items list for this tag). If an import is in progress or has failed the previous image will be shown. Deleting an image stream tag clears both the status and spec fields of an image stream. If no image can be retrieved for a given tag, a not found error will be returned.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,9 +84,6 @@
 public class ImageStreamTag implements Editable<ImageStreamTagBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "image.openshift.io/v1";
     @JsonProperty("conditions")
@@ -93,9 +93,6 @@ public class ImageStreamTag implements Editable<ImageStreamTagBuilder>, HasMetad
     private Long generation;
     @JsonProperty("image")
     private Image image;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ImageStreamTag";
     @JsonProperty("lookupPolicy")
@@ -126,7 +123,7 @@ public ImageStreamTag(String apiVersion, List<TagEventCondition> conditions, Lon
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -134,46 +131,64 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * conditions is an array of conditions that apply to the image stream tag.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TagEventCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions is an array of conditions that apply to the image stream tag.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<TagEventCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * generation is the current generation of the tagged image - if tag is provided and this value is not equal to the tag generation, a user has requested an import that has not completed, or conditions will be filled out indicating any error.
+     */
     @JsonProperty("generation")
     public Long getGeneration() {
         return generation;
     }
 
+    /**
+     * generation is the current generation of the tagged image - if tag is provided and this value is not equal to the tag generation, a user has requested an import that has not completed, or conditions will be filled out indicating any error.
+     */
     @JsonProperty("generation")
     public void setGeneration(Long generation) {
         this.generation = generation;
     }
 
+    /**
+     * ImageStreamTag represents an Image that is retrieved by tag name from an ImageStream. Use this resource to interact with the tags and images in an image stream by tag, or to see the image details for a particular tag. The image associated with this resource is the most recently successfully tagged, imported, or pushed image (as described in the image stream status.tags.items list for this tag). If an import is in progress or has failed the previous image will be shown. Deleting an image stream tag clears both the status and spec fields of an image stream. If no image can be retrieved for a given tag, a not found error will be returned.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("image")
     public Image getImage() {
         return image;
     }
 
+    /**
+     * ImageStreamTag represents an Image that is retrieved by tag name from an ImageStream. Use this resource to interact with the tags and images in an image stream by tag, or to see the image details for a particular tag. The image associated with this resource is the most recently successfully tagged, imported, or pushed image (as described in the image stream status.tags.items list for this tag). If an import is in progress or has failed the previous image will be shown. Deleting an image stream tag clears both the status and spec fields of an image stream. If no image can be retrieved for a given tag, a not found error will be returned.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("image")
     public void setImage(Image image) {
         this.image = image;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -181,38 +196,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ImageStreamTag represents an Image that is retrieved by tag name from an ImageStream. Use this resource to interact with the tags and images in an image stream by tag, or to see the image details for a particular tag. The image associated with this resource is the most recently successfully tagged, imported, or pushed image (as described in the image stream status.tags.items list for this tag). If an import is in progress or has failed the previous image will be shown. Deleting an image stream tag clears both the status and spec fields of an image stream. If no image can be retrieved for a given tag, a not found error will be returned.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("lookupPolicy")
     public ImageLookupPolicy getLookupPolicy() {
         return lookupPolicy;
     }
 
+    /**
+     * ImageStreamTag represents an Image that is retrieved by tag name from an ImageStream. Use this resource to interact with the tags and images in an image stream by tag, or to see the image details for a particular tag. The image associated with this resource is the most recently successfully tagged, imported, or pushed image (as described in the image stream status.tags.items list for this tag). If an import is in progress or has failed the previous image will be shown. Deleting an image stream tag clears both the status and spec fields of an image stream. If no image can be retrieved for a given tag, a not found error will be returned.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("lookupPolicy")
     public void setLookupPolicy(ImageLookupPolicy lookupPolicy) {
         this.lookupPolicy = lookupPolicy;
     }
 
+    /**
+     * ImageStreamTag represents an Image that is retrieved by tag name from an ImageStream. Use this resource to interact with the tags and images in an image stream by tag, or to see the image details for a particular tag. The image associated with this resource is the most recently successfully tagged, imported, or pushed image (as described in the image stream status.tags.items list for this tag). If an import is in progress or has failed the previous image will be shown. Deleting an image stream tag clears both the status and spec fields of an image stream. If no image can be retrieved for a given tag, a not found error will be returned.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ImageStreamTag represents an Image that is retrieved by tag name from an ImageStream. Use this resource to interact with the tags and images in an image stream by tag, or to see the image details for a particular tag. The image associated with this resource is the most recently successfully tagged, imported, or pushed image (as described in the image stream status.tags.items list for this tag). If an import is in progress or has failed the previous image will be shown. Deleting an image stream tag clears both the status and spec fields of an image stream. If no image can be retrieved for a given tag, a not found error will be returned.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ImageStreamTag represents an Image that is retrieved by tag name from an ImageStream. Use this resource to interact with the tags and images in an image stream by tag, or to see the image details for a particular tag. The image associated with this resource is the most recently successfully tagged, imported, or pushed image (as described in the image stream status.tags.items list for this tag). If an import is in progress or has failed the previous image will be shown. Deleting an image stream tag clears both the status and spec fields of an image stream. If no image can be retrieved for a given tag, a not found error will be returned.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("tag")
     public TagReference getTag() {
         return tag;
     }
 
+    /**
+     * ImageStreamTag represents an Image that is retrieved by tag name from an ImageStream. Use this resource to interact with the tags and images in an image stream by tag, or to see the image details for a particular tag. The image associated with this resource is the most recently successfully tagged, imported, or pushed image (as described in the image stream status.tags.items list for this tag). If an import is in progress or has failed the previous image will be shown. Deleting an image stream tag clears both the status and spec fields of an image stream. If no image can be retrieved for a given tag, a not found error will be returned.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("tag")
     public void setTag(TagReference tag) {
         this.tag = tag;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamTagList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamTagList.java
index 000559da001..5cdacc0c248 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamTagList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamTagList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageStreamTagList is a list of ImageStreamTag objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ImageStreamTagList implements Editable<ImageStreamTagListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.ImageStreamTag>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "image.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.ImageStreamTag> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ImageStreamTagList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ImageStreamTagList(String apiVersion, List<io.fabric8.openshift.api.model
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of image stream tags
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.ImageStreamTag> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of image stream tags
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.ImageStreamTag> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ImageStreamTagList is a list of ImageStreamTag objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ImageStreamTagList is a list of ImageStreamTag objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamTagReference.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamTagReference.java
index 53569e9464c..d3efcf573cc 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamTagReference.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageStreamTagReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageStreamTagReference references the ImageStreamTag in an image change trigger by namespace and name.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ImageStreamTagReference(String name, String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * name is the name of the ImageStreamTag for an ImageChangeTrigger
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is the name of the ImageStreamTag for an ImageChangeTrigger
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * namespace is the namespace where the ImageStreamTag for an ImageChangeTrigger is located
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * namespace is the namespace where the ImageStreamTag for an ImageChangeTrigger is located
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageTag.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageTag.java
index 36790e2f355..72aaa47a731 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageTag.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageTag.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageTag represents a single tag within an image stream and includes the spec, the status history, and the currently referenced image (if any) of the provided tag. This type replaces the ImageStreamTag by providing a full view of the tag. ImageTags are returned for every spec or status tag present on the image stream. If no tag exists in either form a not found error will be returned by the API. A create operation will succeed if no spec tag has already been defined and the spec field is set. Delete will remove both spec and status elements from the image stream.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,16 +80,10 @@
 public class ImageTag implements Editable<ImageTagBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "image.openshift.io/v1";
     @JsonProperty("image")
     private Image image;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ImageTag";
     @JsonProperty("metadata")
@@ -115,7 +112,7 @@ public ImageTag(String apiVersion, Image image, String kind, ObjectMeta metadata
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -123,25 +120,31 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ImageTag represents a single tag within an image stream and includes the spec, the status history, and the currently referenced image (if any) of the provided tag. This type replaces the ImageStreamTag by providing a full view of the tag. ImageTags are returned for every spec or status tag present on the image stream. If no tag exists in either form a not found error will be returned by the API. A create operation will succeed if no spec tag has already been defined and the spec field is set. Delete will remove both spec and status elements from the image stream.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("image")
     public Image getImage() {
         return image;
     }
 
+    /**
+     * ImageTag represents a single tag within an image stream and includes the spec, the status history, and the currently referenced image (if any) of the provided tag. This type replaces the ImageStreamTag by providing a full view of the tag. ImageTags are returned for every spec or status tag present on the image stream. If no tag exists in either form a not found error will be returned by the API. A create operation will succeed if no spec tag has already been defined and the spec field is set. Delete will remove both spec and status elements from the image stream.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("image")
     public void setImage(Image image) {
         this.image = image;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -149,38 +152,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ImageTag represents a single tag within an image stream and includes the spec, the status history, and the currently referenced image (if any) of the provided tag. This type replaces the ImageStreamTag by providing a full view of the tag. ImageTags are returned for every spec or status tag present on the image stream. If no tag exists in either form a not found error will be returned by the API. A create operation will succeed if no spec tag has already been defined and the spec field is set. Delete will remove both spec and status elements from the image stream.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ImageTag represents a single tag within an image stream and includes the spec, the status history, and the currently referenced image (if any) of the provided tag. This type replaces the ImageStreamTag by providing a full view of the tag. ImageTags are returned for every spec or status tag present on the image stream. If no tag exists in either form a not found error will be returned by the API. A create operation will succeed if no spec tag has already been defined and the spec field is set. Delete will remove both spec and status elements from the image stream.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * ImageTag represents a single tag within an image stream and includes the spec, the status history, and the currently referenced image (if any) of the provided tag. This type replaces the ImageStreamTag by providing a full view of the tag. ImageTags are returned for every spec or status tag present on the image stream. If no tag exists in either form a not found error will be returned by the API. A create operation will succeed if no spec tag has already been defined and the spec field is set. Delete will remove both spec and status elements from the image stream.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public TagReference getSpec() {
         return spec;
     }
 
+    /**
+     * ImageTag represents a single tag within an image stream and includes the spec, the status history, and the currently referenced image (if any) of the provided tag. This type replaces the ImageStreamTag by providing a full view of the tag. ImageTags are returned for every spec or status tag present on the image stream. If no tag exists in either form a not found error will be returned by the API. A create operation will succeed if no spec tag has already been defined and the spec field is set. Delete will remove both spec and status elements from the image stream.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(TagReference spec) {
         this.spec = spec;
     }
 
+    /**
+     * ImageTag represents a single tag within an image stream and includes the spec, the status history, and the currently referenced image (if any) of the provided tag. This type replaces the ImageStreamTag by providing a full view of the tag. ImageTags are returned for every spec or status tag present on the image stream. If no tag exists in either form a not found error will be returned by the API. A create operation will succeed if no spec tag has already been defined and the spec field is set. Delete will remove both spec and status elements from the image stream.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public NamedTagEventList getStatus() {
         return status;
     }
 
+    /**
+     * ImageTag represents a single tag within an image stream and includes the spec, the status history, and the currently referenced image (if any) of the provided tag. This type replaces the ImageStreamTag by providing a full view of the tag. ImageTags are returned for every spec or status tag present on the image stream. If no tag exists in either form a not found error will be returned by the API. A create operation will succeed if no spec tag has already been defined and the spec field is set. Delete will remove both spec and status elements from the image stream.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(NamedTagEventList status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageTagList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageTagList.java
index 5169b708712..d2df051d37d 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageTagList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ImageTagList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ImageTagList is a list of ImageTag objects. When listing image tags, the image field is not populated. Tags are returned in alphabetical order by image stream and then tag.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ImageTagList implements Editable<ImageTagListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.ImageTag>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "image.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.ImageTag> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ImageTagList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ImageTagList(String apiVersion, List<io.fabric8.openshift.api.model.Image
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of image stream tags
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.ImageTag> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of image stream tags
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.ImageTag> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ImageTagList is a list of ImageTag objects. When listing image tags, the image field is not populated. Tags are returned in alphabetical order by image stream and then tag.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ImageTagList is a list of ImageTag objects. When listing image tags, the image field is not populated. Tags are returned in alphabetical order by image stream and then tag.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/IsPersonalSubjectAccessReview.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/IsPersonalSubjectAccessReview.java
index c46d4c2a7f9..44e77c6de6d 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/IsPersonalSubjectAccessReview.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/IsPersonalSubjectAccessReview.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * IsPersonalSubjectAccessReview is a marker for PolicyRule.AttributeRestrictions that denotes that subjectaccessreviews on self should be allowed<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -73,14 +76,8 @@
 public class IsPersonalSubjectAccessReview implements Editable<IsPersonalSubjectAccessReviewBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authorization.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "IsPersonalSubjectAccessReview";
     @JsonIgnore
@@ -99,7 +96,7 @@ public IsPersonalSubjectAccessReview(String apiVersion, String kind) {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -107,7 +104,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -115,7 +112,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -123,7 +120,7 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/JenkinsPipelineBuildStrategy.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/JenkinsPipelineBuildStrategy.java
index 2e49236f43b..8013f7ed7fc 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/JenkinsPipelineBuildStrategy.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/JenkinsPipelineBuildStrategy.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * JenkinsPipelineBuildStrategy holds parameters specific to a Jenkins Pipeline build. Deprecated: use OpenShift Pipelines
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public JenkinsPipelineBuildStrategy(List<EnvVar> env, String jenkinsfile, String
         this.jenkinsfilePath = jenkinsfilePath;
     }
 
+    /**
+     * env contains additional environment variables you want to pass into a build pipeline.
+     */
     @JsonProperty("env")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvVar> getEnv() {
         return env;
     }
 
+    /**
+     * env contains additional environment variables you want to pass into a build pipeline.
+     */
     @JsonProperty("env")
     public void setEnv(List<EnvVar> env) {
         this.env = env;
     }
 
+    /**
+     * Jenkinsfile defines the optional raw contents of a Jenkinsfile which defines a Jenkins pipeline build.
+     */
     @JsonProperty("jenkinsfile")
     public String getJenkinsfile() {
         return jenkinsfile;
     }
 
+    /**
+     * Jenkinsfile defines the optional raw contents of a Jenkinsfile which defines a Jenkins pipeline build.
+     */
     @JsonProperty("jenkinsfile")
     public void setJenkinsfile(String jenkinsfile) {
         this.jenkinsfile = jenkinsfile;
     }
 
+    /**
+     * JenkinsfilePath is the optional path of the Jenkinsfile that will be used to configure the pipeline relative to the root of the context (contextDir). If both JenkinsfilePath &amp; Jenkinsfile are both not specified, this defaults to Jenkinsfile in the root of the specified contextDir.
+     */
     @JsonProperty("jenkinsfilePath")
     public String getJenkinsfilePath() {
         return jenkinsfilePath;
     }
 
+    /**
+     * JenkinsfilePath is the optional path of the Jenkinsfile that will be used to configure the pipeline relative to the root of the context (contextDir). If both JenkinsfilePath &amp; Jenkinsfile are both not specified, this defaults to Jenkinsfile in the root of the specified contextDir.
+     */
     @JsonProperty("jenkinsfilePath")
     public void setJenkinsfilePath(String jenkinsfilePath) {
         this.jenkinsfilePath = jenkinsfilePath;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/LifecycleHook.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/LifecycleHook.java
index 132d75012df..9d58fe0f595 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/LifecycleHook.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/LifecycleHook.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LifecycleHook defines a specific deployment lifecycle action. Only one type of action may be specified at any time.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public LifecycleHook(ExecNewPodHook execNewPod, String failurePolicy, List<TagIm
         this.tagImages = tagImages;
     }
 
+    /**
+     * LifecycleHook defines a specific deployment lifecycle action. Only one type of action may be specified at any time.
+     */
     @JsonProperty("execNewPod")
     public ExecNewPodHook getExecNewPod() {
         return execNewPod;
     }
 
+    /**
+     * LifecycleHook defines a specific deployment lifecycle action. Only one type of action may be specified at any time.
+     */
     @JsonProperty("execNewPod")
     public void setExecNewPod(ExecNewPodHook execNewPod) {
         this.execNewPod = execNewPod;
     }
 
+    /**
+     * FailurePolicy specifies what action to take if the hook fails.
+     */
     @JsonProperty("failurePolicy")
     public String getFailurePolicy() {
         return failurePolicy;
     }
 
+    /**
+     * FailurePolicy specifies what action to take if the hook fails.
+     */
     @JsonProperty("failurePolicy")
     public void setFailurePolicy(String failurePolicy) {
         this.failurePolicy = failurePolicy;
     }
 
+    /**
+     * TagImages instructs the deployer to tag the current image referenced under a container onto an image stream tag.
+     */
     @JsonProperty("tagImages")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TagImageHook> getTagImages() {
         return tagImages;
     }
 
+    /**
+     * TagImages instructs the deployer to tag the current image referenced under a container onto an image stream tag.
+     */
     @JsonProperty("tagImages")
     public void setTagImages(List<TagImageHook> tagImages) {
         this.tagImages = tagImages;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/LocalObjectReference.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/LocalObjectReference.java
index 9fc271c382c..0a5c3f89e89 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/LocalObjectReference.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/LocalObjectReference.java
@@ -31,6 +31,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LocalObjectReference contains enough information to let you locate the referenced object inside the same namespace.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,11 +80,17 @@ public LocalObjectReference(String name) {
         this.name = name;
     }
 
+    /**
+     * name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/LocalResourceAccessReview.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/LocalResourceAccessReview.java
index f76ad660d28..ac280eca2a6 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/LocalResourceAccessReview.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/LocalResourceAccessReview.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LocalResourceAccessReview is a means to request a list of which users and groups are authorized to perform the action specified by spec in a particular namespace<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,9 +86,6 @@
 public class LocalResourceAccessReview implements Editable<LocalResourceAccessReviewBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authorization.openshift.io/v1";
     @JsonProperty("content")
@@ -93,9 +93,6 @@ public class LocalResourceAccessReview implements Editable<LocalResourceAccessRe
     private Object content;
     @JsonProperty("isNonResourceURL")
     private Boolean isNonResourceURL;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "LocalResourceAccessReview";
     @JsonProperty("metadata")
@@ -140,7 +137,7 @@ public LocalResourceAccessReview(String apiVersion, Object content, Boolean isNo
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -148,36 +145,48 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * LocalResourceAccessReview is a means to request a list of which users and groups are authorized to perform the action specified by spec in a particular namespace<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("content")
     public Object getContent() {
         return content;
     }
 
+    /**
+     * LocalResourceAccessReview is a means to request a list of which users and groups are authorized to perform the action specified by spec in a particular namespace<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("content")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setContent(Object content) {
         this.content = content;
     }
 
+    /**
+     * IsNonResourceURL is true if this is a request for a non-resource URL (outside of the resource hierarchy)
+     */
     @JsonProperty("isNonResourceURL")
     public Boolean getIsNonResourceURL() {
         return isNonResourceURL;
     }
 
+    /**
+     * IsNonResourceURL is true if this is a request for a non-resource URL (outside of the resource hierarchy)
+     */
     @JsonProperty("isNonResourceURL")
     public void setIsNonResourceURL(Boolean isNonResourceURL) {
         this.isNonResourceURL = isNonResourceURL;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -185,88 +194,136 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * LocalResourceAccessReview is a means to request a list of which users and groups are authorized to perform the action specified by spec in a particular namespace<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * LocalResourceAccessReview is a means to request a list of which users and groups are authorized to perform the action specified by spec in a particular namespace<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Namespace is the namespace of the action being requested.  Currently, there is no distinction between no namespace and all namespaces
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace of the action being requested.  Currently, there is no distinction between no namespace and all namespaces
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Path is the path of a non resource URL
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Path is the path of a non resource URL
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * Resource is one of the existing resource types
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * Resource is one of the existing resource types
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
     }
 
+    /**
+     * Group is the API group of the resource Serialized as resourceAPIGroup to avoid confusion with the 'groups' field when inlined
+     */
     @JsonProperty("resourceAPIGroup")
     public String getResourceAPIGroup() {
         return resourceAPIGroup;
     }
 
+    /**
+     * Group is the API group of the resource Serialized as resourceAPIGroup to avoid confusion with the 'groups' field when inlined
+     */
     @JsonProperty("resourceAPIGroup")
     public void setResourceAPIGroup(String resourceAPIGroup) {
         this.resourceAPIGroup = resourceAPIGroup;
     }
 
+    /**
+     * Version is the API version of the resource Serialized as resourceAPIVersion to avoid confusion with TypeMeta.apiVersion and ObjectMeta.resourceVersion when inlined
+     */
     @JsonProperty("resourceAPIVersion")
     public String getResourceAPIVersion() {
         return resourceAPIVersion;
     }
 
+    /**
+     * Version is the API version of the resource Serialized as resourceAPIVersion to avoid confusion with TypeMeta.apiVersion and ObjectMeta.resourceVersion when inlined
+     */
     @JsonProperty("resourceAPIVersion")
     public void setResourceAPIVersion(String resourceAPIVersion) {
         this.resourceAPIVersion = resourceAPIVersion;
     }
 
+    /**
+     * ResourceName is the name of the resource being requested for a "get" or deleted for a "delete"
+     */
     @JsonProperty("resourceName")
     public String getResourceName() {
         return resourceName;
     }
 
+    /**
+     * ResourceName is the name of the resource being requested for a "get" or deleted for a "delete"
+     */
     @JsonProperty("resourceName")
     public void setResourceName(String resourceName) {
         this.resourceName = resourceName;
     }
 
+    /**
+     * Verb is one of: get, list, watch, create, update, delete
+     */
     @JsonProperty("verb")
     public String getVerb() {
         return verb;
     }
 
+    /**
+     * Verb is one of: get, list, watch, create, update, delete
+     */
     @JsonProperty("verb")
     public void setVerb(String verb) {
         this.verb = verb;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/LocalSubjectAccessReview.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/LocalSubjectAccessReview.java
index 6b31b08c75e..9885464dbe1 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/LocalSubjectAccessReview.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/LocalSubjectAccessReview.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * LocalSubjectAccessReview is an object for requesting information about whether a user or group can perform an action in a particular namespace<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -88,9 +91,6 @@
 public class LocalSubjectAccessReview implements Editable<LocalSubjectAccessReviewBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authorization.openshift.io/v1";
     @JsonProperty("content")
@@ -101,9 +101,6 @@ public class LocalSubjectAccessReview implements Editable<LocalSubjectAccessRevi
     private List<String> groups = new ArrayList<>();
     @JsonProperty("isNonResourceURL")
     private Boolean isNonResourceURL;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "LocalSubjectAccessReview";
     @JsonProperty("metadata")
@@ -156,7 +153,7 @@ public LocalSubjectAccessReview(String apiVersion, Object content, List<String>
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -164,47 +161,65 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * LocalSubjectAccessReview is an object for requesting information about whether a user or group can perform an action in a particular namespace<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("content")
     public Object getContent() {
         return content;
     }
 
+    /**
+     * LocalSubjectAccessReview is an object for requesting information about whether a user or group can perform an action in a particular namespace<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("content")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setContent(Object content) {
         this.content = content;
     }
 
+    /**
+     * Groups is optional.  Groups is the list of groups to which the User belongs.
+     */
     @JsonProperty("groups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getGroups() {
         return groups;
     }
 
+    /**
+     * Groups is optional.  Groups is the list of groups to which the User belongs.
+     */
     @JsonProperty("groups")
     public void setGroups(List<String> groups) {
         this.groups = groups;
     }
 
+    /**
+     * IsNonResourceURL is true if this is a request for a non-resource URL (outside of the resource hierarchy)
+     */
     @JsonProperty("isNonResourceURL")
     public Boolean getIsNonResourceURL() {
         return isNonResourceURL;
     }
 
+    /**
+     * IsNonResourceURL is true if this is a request for a non-resource URL (outside of the resource hierarchy)
+     */
     @JsonProperty("isNonResourceURL")
     public void setIsNonResourceURL(Boolean isNonResourceURL) {
         this.isNonResourceURL = isNonResourceURL;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -212,109 +227,169 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * LocalSubjectAccessReview is an object for requesting information about whether a user or group can perform an action in a particular namespace<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * LocalSubjectAccessReview is an object for requesting information about whether a user or group can perform an action in a particular namespace<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Namespace is the namespace of the action being requested.  Currently, there is no distinction between no namespace and all namespaces
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace of the action being requested.  Currently, there is no distinction between no namespace and all namespaces
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Path is the path of a non resource URL
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Path is the path of a non resource URL
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * Resource is one of the existing resource types
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * Resource is one of the existing resource types
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
     }
 
+    /**
+     * Group is the API group of the resource Serialized as resourceAPIGroup to avoid confusion with the 'groups' field when inlined
+     */
     @JsonProperty("resourceAPIGroup")
     public String getResourceAPIGroup() {
         return resourceAPIGroup;
     }
 
+    /**
+     * Group is the API group of the resource Serialized as resourceAPIGroup to avoid confusion with the 'groups' field when inlined
+     */
     @JsonProperty("resourceAPIGroup")
     public void setResourceAPIGroup(String resourceAPIGroup) {
         this.resourceAPIGroup = resourceAPIGroup;
     }
 
+    /**
+     * Version is the API version of the resource Serialized as resourceAPIVersion to avoid confusion with TypeMeta.apiVersion and ObjectMeta.resourceVersion when inlined
+     */
     @JsonProperty("resourceAPIVersion")
     public String getResourceAPIVersion() {
         return resourceAPIVersion;
     }
 
+    /**
+     * Version is the API version of the resource Serialized as resourceAPIVersion to avoid confusion with TypeMeta.apiVersion and ObjectMeta.resourceVersion when inlined
+     */
     @JsonProperty("resourceAPIVersion")
     public void setResourceAPIVersion(String resourceAPIVersion) {
         this.resourceAPIVersion = resourceAPIVersion;
     }
 
+    /**
+     * ResourceName is the name of the resource being requested for a "get" or deleted for a "delete"
+     */
     @JsonProperty("resourceName")
     public String getResourceName() {
         return resourceName;
     }
 
+    /**
+     * ResourceName is the name of the resource being requested for a "get" or deleted for a "delete"
+     */
     @JsonProperty("resourceName")
     public void setResourceName(String resourceName) {
         this.resourceName = resourceName;
     }
 
+    /**
+     * Scopes to use for the evaluation.  Empty means "use the unscoped (full) permissions of the user/groups". Nil for a self-SAR, means "use the scopes on this request". Nil for a regular SAR, means the same as empty.
+     */
     @JsonProperty("scopes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getScopes() {
         return scopes;
     }
 
+    /**
+     * Scopes to use for the evaluation.  Empty means "use the unscoped (full) permissions of the user/groups". Nil for a self-SAR, means "use the scopes on this request". Nil for a regular SAR, means the same as empty.
+     */
     @JsonProperty("scopes")
     public void setScopes(List<String> scopes) {
         this.scopes = scopes;
     }
 
+    /**
+     * User is optional.  If both User and Groups are empty, the current authenticated user is used.
+     */
     @JsonProperty("user")
     public String getUser() {
         return user;
     }
 
+    /**
+     * User is optional.  If both User and Groups are empty, the current authenticated user is used.
+     */
     @JsonProperty("user")
     public void setUser(String user) {
         this.user = user;
     }
 
+    /**
+     * Verb is one of: get, list, watch, create, update, delete
+     */
     @JsonProperty("verb")
     public String getVerb() {
         return verb;
     }
 
+    /**
+     * Verb is one of: get, list, watch, create, update, delete
+     */
     @JsonProperty("verb")
     public void setVerb(String verb) {
         this.verb = verb;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/NamedClusterRole.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/NamedClusterRole.java
index 44254b417b8..c94c6b89d37 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/NamedClusterRole.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/NamedClusterRole.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NamedClusterRole relates a name with a cluster role
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public NamedClusterRole(String name, ClusterRole role) {
         this.role = role;
     }
 
+    /**
+     * Name is the name of the cluster role
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the cluster role
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * NamedClusterRole relates a name with a cluster role
+     */
     @JsonProperty("role")
     public ClusterRole getRole() {
         return role;
     }
 
+    /**
+     * NamedClusterRole relates a name with a cluster role
+     */
     @JsonProperty("role")
     public void setRole(ClusterRole role) {
         this.role = role;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/NamedClusterRoleBinding.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/NamedClusterRoleBinding.java
index ce4148ec321..8695bcac91b 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/NamedClusterRoleBinding.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/NamedClusterRoleBinding.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NamedClusterRoleBinding relates a name with a cluster role binding
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public NamedClusterRoleBinding(String name, ClusterRoleBinding roleBinding) {
         this.roleBinding = roleBinding;
     }
 
+    /**
+     * Name is the name of the cluster role binding
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the cluster role binding
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * NamedClusterRoleBinding relates a name with a cluster role binding
+     */
     @JsonProperty("roleBinding")
     public ClusterRoleBinding getRoleBinding() {
         return roleBinding;
     }
 
+    /**
+     * NamedClusterRoleBinding relates a name with a cluster role binding
+     */
     @JsonProperty("roleBinding")
     public void setRoleBinding(ClusterRoleBinding roleBinding) {
         this.roleBinding = roleBinding;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/NamedRole.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/NamedRole.java
index 2fac88a06e1..ce7f0ad2328 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/NamedRole.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/NamedRole.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NamedRole relates a Role with a name
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public NamedRole(String name, Role role) {
         this.role = role;
     }
 
+    /**
+     * Name is the name of the role
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the role
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * NamedRole relates a Role with a name
+     */
     @JsonProperty("role")
     public Role getRole() {
         return role;
     }
 
+    /**
+     * NamedRole relates a Role with a name
+     */
     @JsonProperty("role")
     public void setRole(Role role) {
         this.role = role;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/NamedRoleBinding.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/NamedRoleBinding.java
index ae8b1c8ce59..e57bdf4d49d 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/NamedRoleBinding.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/NamedRoleBinding.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NamedRoleBinding relates a role binding with a name
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public NamedRoleBinding(String name, RoleBinding roleBinding) {
         this.roleBinding = roleBinding;
     }
 
+    /**
+     * Name is the name of the role binding
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the role binding
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * NamedRoleBinding relates a role binding with a name
+     */
     @JsonProperty("roleBinding")
     public RoleBinding getRoleBinding() {
         return roleBinding;
     }
 
+    /**
+     * NamedRoleBinding relates a role binding with a name
+     */
     @JsonProperty("roleBinding")
     public void setRoleBinding(RoleBinding roleBinding) {
         this.roleBinding = roleBinding;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/NamedTagEventList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/NamedTagEventList.java
index 4062cacc891..85624848b1f 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/NamedTagEventList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/NamedTagEventList.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * NamedTagEventList relates a tag to its image history.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public NamedTagEventList(List<TagEventCondition> conditions, List<TagEvent> item
         this.tag = tag;
     }
 
+    /**
+     * Conditions is an array of conditions that apply to the tag event list.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TagEventCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions is an array of conditions that apply to the tag event list.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<TagEventCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Standard object's metadata.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TagEvent> getItems() {
         return items;
     }
 
+    /**
+     * Standard object's metadata.
+     */
     @JsonProperty("items")
     public void setItems(List<TagEvent> items) {
         this.items = items;
     }
 
+    /**
+     * Tag is the tag for which the history is recorded
+     */
     @JsonProperty("tag")
     public String getTag() {
         return tag;
     }
 
+    /**
+     * Tag is the tag for which the history is recorded
+     */
     @JsonProperty("tag")
     public void setTag(String tag) {
         this.tag = tag;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthAccessToken.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthAccessToken.java
index 907ea922439..24e58fd5abd 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthAccessToken.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthAccessToken.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OAuthAccessToken describes an OAuth access token. The name of a token must be prefixed with a `sha256~` string, must not contain "/" or "%" characters and must be at least 32 characters long.<br><p> <br><p> The name of the token is constructed from the actual token by sha256-hashing it and using URL-safe unpadded base64-encoding (as described in RFC4648) on the hashed result.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -84,9 +87,6 @@
 public class OAuthAccessToken implements Editable<OAuthAccessTokenBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "oauth.openshift.io/v1";
     @JsonProperty("authorizeToken")
@@ -97,9 +97,6 @@ public class OAuthAccessToken implements Editable<OAuthAccessTokenBuilder>, HasM
     private Long expiresIn;
     @JsonProperty("inactivityTimeoutSeconds")
     private Integer inactivityTimeoutSeconds;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OAuthAccessToken";
     @JsonProperty("metadata")
@@ -141,7 +138,7 @@ public OAuthAccessToken(String apiVersion, String authorizeToken, String clientN
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -149,55 +146,79 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * AuthorizeToken contains the token that authorized this token
+     */
     @JsonProperty("authorizeToken")
     public String getAuthorizeToken() {
         return authorizeToken;
     }
 
+    /**
+     * AuthorizeToken contains the token that authorized this token
+     */
     @JsonProperty("authorizeToken")
     public void setAuthorizeToken(String authorizeToken) {
         this.authorizeToken = authorizeToken;
     }
 
+    /**
+     * ClientName references the client that created this token.
+     */
     @JsonProperty("clientName")
     public String getClientName() {
         return clientName;
     }
 
+    /**
+     * ClientName references the client that created this token.
+     */
     @JsonProperty("clientName")
     public void setClientName(String clientName) {
         this.clientName = clientName;
     }
 
+    /**
+     * ExpiresIn is the seconds from CreationTime before this token expires.
+     */
     @JsonProperty("expiresIn")
     public Long getExpiresIn() {
         return expiresIn;
     }
 
+    /**
+     * ExpiresIn is the seconds from CreationTime before this token expires.
+     */
     @JsonProperty("expiresIn")
     public void setExpiresIn(Long expiresIn) {
         this.expiresIn = expiresIn;
     }
 
+    /**
+     * InactivityTimeoutSeconds is the value in seconds, from the CreationTimestamp, after which this token can no longer be used. The value is automatically incremented when the token is used.
+     */
     @JsonProperty("inactivityTimeoutSeconds")
     public Integer getInactivityTimeoutSeconds() {
         return inactivityTimeoutSeconds;
     }
 
+    /**
+     * InactivityTimeoutSeconds is the value in seconds, from the CreationTimestamp, after which this token can no longer be used. The value is automatically incremented when the token is used.
+     */
     @JsonProperty("inactivityTimeoutSeconds")
     public void setInactivityTimeoutSeconds(Integer inactivityTimeoutSeconds) {
         this.inactivityTimeoutSeconds = inactivityTimeoutSeconds;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -205,69 +226,105 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OAuthAccessToken describes an OAuth access token. The name of a token must be prefixed with a `sha256~` string, must not contain "/" or "%" characters and must be at least 32 characters long.<br><p> <br><p> The name of the token is constructed from the actual token by sha256-hashing it and using URL-safe unpadded base64-encoding (as described in RFC4648) on the hashed result.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OAuthAccessToken describes an OAuth access token. The name of a token must be prefixed with a `sha256~` string, must not contain "/" or "%" characters and must be at least 32 characters long.<br><p> <br><p> The name of the token is constructed from the actual token by sha256-hashing it and using URL-safe unpadded base64-encoding (as described in RFC4648) on the hashed result.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * RedirectURI is the redirection associated with the token.
+     */
     @JsonProperty("redirectURI")
     public String getRedirectURI() {
         return redirectURI;
     }
 
+    /**
+     * RedirectURI is the redirection associated with the token.
+     */
     @JsonProperty("redirectURI")
     public void setRedirectURI(String redirectURI) {
         this.redirectURI = redirectURI;
     }
 
+    /**
+     * RefreshToken is the value by which this token can be renewed. Can be blank.
+     */
     @JsonProperty("refreshToken")
     public String getRefreshToken() {
         return refreshToken;
     }
 
+    /**
+     * RefreshToken is the value by which this token can be renewed. Can be blank.
+     */
     @JsonProperty("refreshToken")
     public void setRefreshToken(String refreshToken) {
         this.refreshToken = refreshToken;
     }
 
+    /**
+     * Scopes is an array of the requested scopes.
+     */
     @JsonProperty("scopes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getScopes() {
         return scopes;
     }
 
+    /**
+     * Scopes is an array of the requested scopes.
+     */
     @JsonProperty("scopes")
     public void setScopes(List<String> scopes) {
         this.scopes = scopes;
     }
 
+    /**
+     * UserName is the user name associated with this token
+     */
     @JsonProperty("userName")
     public String getUserName() {
         return userName;
     }
 
+    /**
+     * UserName is the user name associated with this token
+     */
     @JsonProperty("userName")
     public void setUserName(String userName) {
         this.userName = userName;
     }
 
+    /**
+     * UserUID is the unique UID associated with this token
+     */
     @JsonProperty("userUID")
     public String getUserUID() {
         return userUID;
     }
 
+    /**
+     * UserUID is the unique UID associated with this token
+     */
     @JsonProperty("userUID")
     public void setUserUID(String userUID) {
         this.userUID = userUID;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthAccessTokenList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthAccessTokenList.java
index 44cdfca1185..74178b3e2ce 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthAccessTokenList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthAccessTokenList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OAuthAccessTokenList is a collection of OAuth access tokens<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class OAuthAccessTokenList implements Editable<OAuthAccessTokenListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.OAuthAccessToken>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "oauth.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.OAuthAccessToken> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OAuthAccessTokenList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public OAuthAccessTokenList(String apiVersion, List<io.fabric8.openshift.api.mod
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of OAuth access tokens
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.OAuthAccessToken> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of OAuth access tokens
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.OAuthAccessToken> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OAuthAccessTokenList is a collection of OAuth access tokens<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OAuthAccessTokenList is a collection of OAuth access tokens<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthAuthorizeToken.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthAuthorizeToken.java
index 7b4537203b8..5ef23613891 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthAuthorizeToken.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthAuthorizeToken.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OAuthAuthorizeToken describes an OAuth authorization token<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -84,9 +87,6 @@
 public class OAuthAuthorizeToken implements Editable<OAuthAuthorizeTokenBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "oauth.openshift.io/v1";
     @JsonProperty("clientName")
@@ -97,9 +97,6 @@ public class OAuthAuthorizeToken implements Editable<OAuthAuthorizeTokenBuilder>
     private String codeChallengeMethod;
     @JsonProperty("expiresIn")
     private Long expiresIn;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OAuthAuthorizeToken";
     @JsonProperty("metadata")
@@ -141,7 +138,7 @@ public OAuthAuthorizeToken(String apiVersion, String clientName, String codeChal
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -149,55 +146,79 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ClientName references the client that created this token.
+     */
     @JsonProperty("clientName")
     public String getClientName() {
         return clientName;
     }
 
+    /**
+     * ClientName references the client that created this token.
+     */
     @JsonProperty("clientName")
     public void setClientName(String clientName) {
         this.clientName = clientName;
     }
 
+    /**
+     * CodeChallenge is the optional code_challenge associated with this authorization code, as described in rfc7636
+     */
     @JsonProperty("codeChallenge")
     public String getCodeChallenge() {
         return codeChallenge;
     }
 
+    /**
+     * CodeChallenge is the optional code_challenge associated with this authorization code, as described in rfc7636
+     */
     @JsonProperty("codeChallenge")
     public void setCodeChallenge(String codeChallenge) {
         this.codeChallenge = codeChallenge;
     }
 
+    /**
+     * CodeChallengeMethod is the optional code_challenge_method associated with this authorization code, as described in rfc7636
+     */
     @JsonProperty("codeChallengeMethod")
     public String getCodeChallengeMethod() {
         return codeChallengeMethod;
     }
 
+    /**
+     * CodeChallengeMethod is the optional code_challenge_method associated with this authorization code, as described in rfc7636
+     */
     @JsonProperty("codeChallengeMethod")
     public void setCodeChallengeMethod(String codeChallengeMethod) {
         this.codeChallengeMethod = codeChallengeMethod;
     }
 
+    /**
+     * ExpiresIn is the seconds from CreationTime before this token expires.
+     */
     @JsonProperty("expiresIn")
     public Long getExpiresIn() {
         return expiresIn;
     }
 
+    /**
+     * ExpiresIn is the seconds from CreationTime before this token expires.
+     */
     @JsonProperty("expiresIn")
     public void setExpiresIn(Long expiresIn) {
         this.expiresIn = expiresIn;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -205,69 +226,105 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OAuthAuthorizeToken describes an OAuth authorization token<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OAuthAuthorizeToken describes an OAuth authorization token<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * RedirectURI is the redirection associated with the token.
+     */
     @JsonProperty("redirectURI")
     public String getRedirectURI() {
         return redirectURI;
     }
 
+    /**
+     * RedirectURI is the redirection associated with the token.
+     */
     @JsonProperty("redirectURI")
     public void setRedirectURI(String redirectURI) {
         this.redirectURI = redirectURI;
     }
 
+    /**
+     * Scopes is an array of the requested scopes.
+     */
     @JsonProperty("scopes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getScopes() {
         return scopes;
     }
 
+    /**
+     * Scopes is an array of the requested scopes.
+     */
     @JsonProperty("scopes")
     public void setScopes(List<String> scopes) {
         this.scopes = scopes;
     }
 
+    /**
+     * State data from request
+     */
     @JsonProperty("state")
     public String getState() {
         return state;
     }
 
+    /**
+     * State data from request
+     */
     @JsonProperty("state")
     public void setState(String state) {
         this.state = state;
     }
 
+    /**
+     * UserName is the user name associated with this token
+     */
     @JsonProperty("userName")
     public String getUserName() {
         return userName;
     }
 
+    /**
+     * UserName is the user name associated with this token
+     */
     @JsonProperty("userName")
     public void setUserName(String userName) {
         this.userName = userName;
     }
 
+    /**
+     * UserUID is the unique UID associated with this token. UserUID and UserName must both match for this token to be valid.
+     */
     @JsonProperty("userUID")
     public String getUserUID() {
         return userUID;
     }
 
+    /**
+     * UserUID is the unique UID associated with this token. UserUID and UserName must both match for this token to be valid.
+     */
     @JsonProperty("userUID")
     public void setUserUID(String userUID) {
         this.userUID = userUID;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthAuthorizeTokenList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthAuthorizeTokenList.java
index 0c9035886c1..73fcaeaa649 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthAuthorizeTokenList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthAuthorizeTokenList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OAuthAuthorizeTokenList is a collection of OAuth authorization tokens<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class OAuthAuthorizeTokenList implements Editable<OAuthAuthorizeTokenListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.OAuthAuthorizeToken>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "oauth.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.OAuthAuthorizeToken> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OAuthAuthorizeTokenList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public OAuthAuthorizeTokenList(String apiVersion, List<io.fabric8.openshift.api.
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of OAuth authorization tokens
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.OAuthAuthorizeToken> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of OAuth authorization tokens
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.OAuthAuthorizeToken> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OAuthAuthorizeTokenList is a collection of OAuth authorization tokens<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OAuthAuthorizeTokenList is a collection of OAuth authorization tokens<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthClient.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthClient.java
index 2646768269e..070ffcf4588 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthClient.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthClient.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OAuthClient describes an OAuth client<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,16 +93,10 @@ public class OAuthClient implements Editable<OAuthClientBuilder>, HasMetadata
     @JsonProperty("additionalSecrets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<String> additionalSecrets = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "oauth.openshift.io/v1";
     @JsonProperty("grantMethod")
     private String grantMethod;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OAuthClient";
     @JsonProperty("metadata")
@@ -138,39 +135,57 @@ public OAuthClient(Integer accessTokenInactivityTimeoutSeconds, Integer accessTo
         this.secret = secret;
     }
 
+    /**
+     * AccessTokenInactivityTimeoutSeconds overrides the default token inactivity timeout for tokens granted to this client. The value represents the maximum amount of time that can occur between consecutive uses of the token. Tokens become invalid if they are not used within this temporal window. The user will need to acquire a new token to regain access once a token times out. This value needs to be set only if the default set in configuration is not appropriate for this client. Valid values are: - 0: Tokens for this client never time out - X: Tokens time out if there is no activity for X seconds The current minimum allowed value for X is 300 (5 minutes)<br><p> <br><p> WARNING: existing tokens' timeout will not be affected (lowered) by changing this value
+     */
     @JsonProperty("accessTokenInactivityTimeoutSeconds")
     public Integer getAccessTokenInactivityTimeoutSeconds() {
         return accessTokenInactivityTimeoutSeconds;
     }
 
+    /**
+     * AccessTokenInactivityTimeoutSeconds overrides the default token inactivity timeout for tokens granted to this client. The value represents the maximum amount of time that can occur between consecutive uses of the token. Tokens become invalid if they are not used within this temporal window. The user will need to acquire a new token to regain access once a token times out. This value needs to be set only if the default set in configuration is not appropriate for this client. Valid values are: - 0: Tokens for this client never time out - X: Tokens time out if there is no activity for X seconds The current minimum allowed value for X is 300 (5 minutes)<br><p> <br><p> WARNING: existing tokens' timeout will not be affected (lowered) by changing this value
+     */
     @JsonProperty("accessTokenInactivityTimeoutSeconds")
     public void setAccessTokenInactivityTimeoutSeconds(Integer accessTokenInactivityTimeoutSeconds) {
         this.accessTokenInactivityTimeoutSeconds = accessTokenInactivityTimeoutSeconds;
     }
 
+    /**
+     * AccessTokenMaxAgeSeconds overrides the default access token max age for tokens granted to this client. 0 means no expiration.
+     */
     @JsonProperty("accessTokenMaxAgeSeconds")
     public Integer getAccessTokenMaxAgeSeconds() {
         return accessTokenMaxAgeSeconds;
     }
 
+    /**
+     * AccessTokenMaxAgeSeconds overrides the default access token max age for tokens granted to this client. 0 means no expiration.
+     */
     @JsonProperty("accessTokenMaxAgeSeconds")
     public void setAccessTokenMaxAgeSeconds(Integer accessTokenMaxAgeSeconds) {
         this.accessTokenMaxAgeSeconds = accessTokenMaxAgeSeconds;
     }
 
+    /**
+     * AdditionalSecrets holds other secrets that may be used to identify the client.  This is useful for rotation and for service account token validation
+     */
     @JsonProperty("additionalSecrets")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAdditionalSecrets() {
         return additionalSecrets;
     }
 
+    /**
+     * AdditionalSecrets holds other secrets that may be used to identify the client.  This is useful for rotation and for service account token validation
+     */
     @JsonProperty("additionalSecrets")
     public void setAdditionalSecrets(List<String> additionalSecrets) {
         this.additionalSecrets = additionalSecrets;
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -178,25 +193,31 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * GrantMethod is a required field which determines how to handle grants for this client. Valid grant handling methods are:<br><p>  - auto:   always approves grant requests, useful for trusted clients<br><p>  - prompt: prompts the end user for approval of grant requests, useful for third-party clients
+     */
     @JsonProperty("grantMethod")
     public String getGrantMethod() {
         return grantMethod;
     }
 
+    /**
+     * GrantMethod is a required field which determines how to handle grants for this client. Valid grant handling methods are:<br><p>  - auto:   always approves grant requests, useful for trusted clients<br><p>  - prompt: prompts the end user for approval of grant requests, useful for third-party clients
+     */
     @JsonProperty("grantMethod")
     public void setGrantMethod(String grantMethod) {
         this.grantMethod = grantMethod;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -204,60 +225,90 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OAuthClient describes an OAuth client<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OAuthClient describes an OAuth client<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * RedirectURIs is the valid redirection URIs associated with a client
+     */
     @JsonProperty("redirectURIs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getRedirectURIs() {
         return redirectURIs;
     }
 
+    /**
+     * RedirectURIs is the valid redirection URIs associated with a client
+     */
     @JsonProperty("redirectURIs")
     public void setRedirectURIs(List<String> redirectURIs) {
         this.redirectURIs = redirectURIs;
     }
 
+    /**
+     * RespondWithChallenges indicates whether the client wants authentication needed responses made in the form of challenges instead of redirects
+     */
     @JsonProperty("respondWithChallenges")
     public Boolean getRespondWithChallenges() {
         return respondWithChallenges;
     }
 
+    /**
+     * RespondWithChallenges indicates whether the client wants authentication needed responses made in the form of challenges instead of redirects
+     */
     @JsonProperty("respondWithChallenges")
     public void setRespondWithChallenges(Boolean respondWithChallenges) {
         this.respondWithChallenges = respondWithChallenges;
     }
 
+    /**
+     * ScopeRestrictions describes which scopes this client can request.  Each requested scope is checked against each restriction.  If any restriction matches, then the scope is allowed. If no restriction matches, then the scope is denied.
+     */
     @JsonProperty("scopeRestrictions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ScopeRestriction> getScopeRestrictions() {
         return scopeRestrictions;
     }
 
+    /**
+     * ScopeRestrictions describes which scopes this client can request.  Each requested scope is checked against each restriction.  If any restriction matches, then the scope is allowed. If no restriction matches, then the scope is denied.
+     */
     @JsonProperty("scopeRestrictions")
     public void setScopeRestrictions(List<ScopeRestriction> scopeRestrictions) {
         this.scopeRestrictions = scopeRestrictions;
     }
 
+    /**
+     * Secret is the unique secret associated with a client
+     */
     @JsonProperty("secret")
     public String getSecret() {
         return secret;
     }
 
+    /**
+     * Secret is the unique secret associated with a client
+     */
     @JsonProperty("secret")
     public void setSecret(String secret) {
         this.secret = secret;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthClientAuthorization.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthClientAuthorization.java
index b2a80b2a103..fc7827e0f57 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthClientAuthorization.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthClientAuthorization.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OAuthClientAuthorization describes an authorization created by an OAuth client<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,16 +82,10 @@
 public class OAuthClientAuthorization implements Editable<OAuthClientAuthorizationBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "oauth.openshift.io/v1";
     @JsonProperty("clientName")
     private String clientName;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OAuthClientAuthorization";
     @JsonProperty("metadata")
@@ -121,7 +118,7 @@ public OAuthClientAuthorization(String apiVersion, String clientName, String kin
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -129,25 +126,31 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ClientName references the client that created this authorization
+     */
     @JsonProperty("clientName")
     public String getClientName() {
         return clientName;
     }
 
+    /**
+     * ClientName references the client that created this authorization
+     */
     @JsonProperty("clientName")
     public void setClientName(String clientName) {
         this.clientName = clientName;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -155,49 +158,73 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OAuthClientAuthorization describes an authorization created by an OAuth client<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OAuthClientAuthorization describes an authorization created by an OAuth client<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Scopes is an array of the granted scopes.
+     */
     @JsonProperty("scopes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getScopes() {
         return scopes;
     }
 
+    /**
+     * Scopes is an array of the granted scopes.
+     */
     @JsonProperty("scopes")
     public void setScopes(List<String> scopes) {
         this.scopes = scopes;
     }
 
+    /**
+     * UserName is the user name that authorized this client
+     */
     @JsonProperty("userName")
     public String getUserName() {
         return userName;
     }
 
+    /**
+     * UserName is the user name that authorized this client
+     */
     @JsonProperty("userName")
     public void setUserName(String userName) {
         this.userName = userName;
     }
 
+    /**
+     * UserUID is the unique UID associated with this authorization. UserUID and UserName must both match for this authorization to be valid.
+     */
     @JsonProperty("userUID")
     public String getUserUID() {
         return userUID;
     }
 
+    /**
+     * UserUID is the unique UID associated with this authorization. UserUID and UserName must both match for this authorization to be valid.
+     */
     @JsonProperty("userUID")
     public void setUserUID(String userUID) {
         this.userUID = userUID;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthClientAuthorizationList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthClientAuthorizationList.java
index b3b17c00b0d..8f443afd3a7 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthClientAuthorizationList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthClientAuthorizationList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OAuthClientAuthorizationList is a collection of OAuth client authorizations<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class OAuthClientAuthorizationList implements Editable<OAuthClientAuthorizationListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.OAuthClientAuthorization>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "oauth.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.OAuthClientAuthorization> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OAuthClientAuthorizationList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public OAuthClientAuthorizationList(String apiVersion, List<io.fabric8.openshift
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of OAuth client authorizations
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.OAuthClientAuthorization> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of OAuth client authorizations
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.OAuthClientAuthorization> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OAuthClientAuthorizationList is a collection of OAuth client authorizations<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OAuthClientAuthorizationList is a collection of OAuth client authorizations<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthClientList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthClientList.java
index 2c58104685c..08be4d1a164 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthClientList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthClientList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OAuthClientList is a collection of OAuth clients<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class OAuthClientList implements Editable<OAuthClientListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.OAuthClient>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "oauth.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.OAuthClient> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OAuthClientList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public OAuthClientList(String apiVersion, List<io.fabric8.openshift.api.model.OA
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of OAuth clients
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.OAuthClient> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of OAuth clients
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.OAuthClient> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OAuthClientList is a collection of OAuth clients<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OAuthClientList is a collection of OAuth clients<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthRedirectReference.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthRedirectReference.java
index 960a7724a46..6e04bc0624d 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthRedirectReference.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/OAuthRedirectReference.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * OAuthRedirectReference is a reference to an OAuth redirect object.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class OAuthRedirectReference implements Editable<OAuthRedirectReferenceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "oauth.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "OAuthRedirectReference";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public OAuthRedirectReference(String apiVersion, String kind, ObjectMeta metadat
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * OAuthRedirectReference is a reference to an OAuth redirect object.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * OAuthRedirectReference is a reference to an OAuth redirect object.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * OAuthRedirectReference is a reference to an OAuth redirect object.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("reference")
     public RedirectReference getReference() {
         return reference;
     }
 
+    /**
+     * OAuthRedirectReference is a reference to an OAuth redirect object.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("reference")
     public void setReference(RedirectReference reference) {
         this.reference = reference;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Parameter.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Parameter.java
index ea7dab4adf9..2af17e0fa5f 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Parameter.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Parameter.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Parameter defines a name/value variable that is to be processed during the Template to Config transformation.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,71 +105,113 @@ public Parameter(String description, String displayName, String from, String gen
         this.value = value;
     }
 
+    /**
+     * Description of a parameter. Optional.
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description of a parameter. Optional.
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * Optional: The name that will show in UI instead of parameter 'Name'
+     */
     @JsonProperty("displayName")
     public String getDisplayName() {
         return displayName;
     }
 
+    /**
+     * Optional: The name that will show in UI instead of parameter 'Name'
+     */
     @JsonProperty("displayName")
     public void setDisplayName(String displayName) {
         this.displayName = displayName;
     }
 
+    /**
+     * From is an input value for the generator. Optional.
+     */
     @JsonProperty("from")
     public String getFrom() {
         return from;
     }
 
+    /**
+     * From is an input value for the generator. Optional.
+     */
     @JsonProperty("from")
     public void setFrom(String from) {
         this.from = from;
     }
 
+    /**
+     * generate specifies the generator to be used to generate random string from an input value specified by From field. The result string is stored into Value field. If empty, no generator is being used, leaving the result Value untouched. Optional.<br><p> <br><p> The only supported generator is "expression", which accepts a "from" value in the form of a simple regular expression containing the range expression "[a-zA-Z0-9]", and the length expression "a{length}".<br><p> <br><p> Examples:<br><p> <br><p> from             | value ----------------------------- "test[0-9]{1}x"  | "test7x" "[0-1]{8}"       | "01001100" "0x[A-F0-9]{4}"  | "0xB3AF" "[a-zA-Z0-9]{8}" | "hW4yQU5i"
+     */
     @JsonProperty("generate")
     public String getGenerate() {
         return generate;
     }
 
+    /**
+     * generate specifies the generator to be used to generate random string from an input value specified by From field. The result string is stored into Value field. If empty, no generator is being used, leaving the result Value untouched. Optional.<br><p> <br><p> The only supported generator is "expression", which accepts a "from" value in the form of a simple regular expression containing the range expression "[a-zA-Z0-9]", and the length expression "a{length}".<br><p> <br><p> Examples:<br><p> <br><p> from             | value ----------------------------- "test[0-9]{1}x"  | "test7x" "[0-1]{8}"       | "01001100" "0x[A-F0-9]{4}"  | "0xB3AF" "[a-zA-Z0-9]{8}" | "hW4yQU5i"
+     */
     @JsonProperty("generate")
     public void setGenerate(String generate) {
         this.generate = generate;
     }
 
+    /**
+     * Name must be set and it can be referenced in Template Items using ${PARAMETER_NAME}. Required.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name must be set and it can be referenced in Template Items using ${PARAMETER_NAME}. Required.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Optional: Indicates the parameter must have a value.  Defaults to false.
+     */
     @JsonProperty("required")
     public Boolean getRequired() {
         return required;
     }
 
+    /**
+     * Optional: Indicates the parameter must have a value.  Defaults to false.
+     */
     @JsonProperty("required")
     public void setRequired(Boolean required) {
         this.required = required;
     }
 
+    /**
+     * Value holds the Parameter data. If specified, the generator will be ignored. The value replaces all occurrences of the Parameter ${Name} expression during the Template to Config transformation. Optional.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * Value holds the Parameter data. If specified, the generator will be ignored. The value replaces all occurrences of the Parameter ${Name} expression during the Template to Config transformation. Optional.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicyReview.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicyReview.java
index 34c4ae9f83f..141e2d23910 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicyReview.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicyReview.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodSecurityPolicyReview checks which service accounts (not users, since that would be cluster-wide) can create the `PodTemplateSpec` in question.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class PodSecurityPolicyReview implements Editable<PodSecurityPolicyReviewBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "security.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodSecurityPolicyReview";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PodSecurityPolicyReview(String apiVersion, String kind, ObjectMeta metada
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodSecurityPolicyReview checks which service accounts (not users, since that would be cluster-wide) can create the `PodTemplateSpec` in question.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodSecurityPolicyReview checks which service accounts (not users, since that would be cluster-wide) can create the `PodTemplateSpec` in question.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PodSecurityPolicyReview checks which service accounts (not users, since that would be cluster-wide) can create the `PodTemplateSpec` in question.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public PodSecurityPolicyReviewSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PodSecurityPolicyReview checks which service accounts (not users, since that would be cluster-wide) can create the `PodTemplateSpec` in question.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(PodSecurityPolicyReviewSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PodSecurityPolicyReview checks which service accounts (not users, since that would be cluster-wide) can create the `PodTemplateSpec` in question.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public PodSecurityPolicyReviewStatus getStatus() {
         return status;
     }
 
+    /**
+     * PodSecurityPolicyReview checks which service accounts (not users, since that would be cluster-wide) can create the `PodTemplateSpec` in question.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(PodSecurityPolicyReviewStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicyReviewSpec.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicyReviewSpec.java
index 16c10873e2f..b3768f5317f 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicyReviewSpec.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicyReviewSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodSecurityPolicyReviewSpec defines specification for PodSecurityPolicyReview
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public PodSecurityPolicyReviewSpec(List<String> serviceAccountNames, PodTemplate
         this.template = template;
     }
 
+    /**
+     * serviceAccountNames is an optional set of ServiceAccounts to run the check with. If serviceAccountNames is empty, the template.spec.serviceAccountName is used, unless it's empty, in which case "default" is used instead. If serviceAccountNames is specified, template.spec.serviceAccountName is ignored.
+     */
     @JsonProperty("serviceAccountNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getServiceAccountNames() {
         return serviceAccountNames;
     }
 
+    /**
+     * serviceAccountNames is an optional set of ServiceAccounts to run the check with. If serviceAccountNames is empty, the template.spec.serviceAccountName is used, unless it's empty, in which case "default" is used instead. If serviceAccountNames is specified, template.spec.serviceAccountName is ignored.
+     */
     @JsonProperty("serviceAccountNames")
     public void setServiceAccountNames(List<String> serviceAccountNames) {
         this.serviceAccountNames = serviceAccountNames;
     }
 
+    /**
+     * PodSecurityPolicyReviewSpec defines specification for PodSecurityPolicyReview
+     */
     @JsonProperty("template")
     public PodTemplateSpec getTemplate() {
         return template;
     }
 
+    /**
+     * PodSecurityPolicyReviewSpec defines specification for PodSecurityPolicyReview
+     */
     @JsonProperty("template")
     public void setTemplate(PodTemplateSpec template) {
         this.template = template;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicyReviewStatus.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicyReviewStatus.java
index d0764758c8e..e537f13a14c 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicyReviewStatus.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicyReviewStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodSecurityPolicyReviewStatus represents the status of PodSecurityPolicyReview.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public PodSecurityPolicyReviewStatus(List<ServiceAccountPodSecurityPolicyReviewS
         this.allowedServiceAccounts = allowedServiceAccounts;
     }
 
+    /**
+     * allowedServiceAccounts returns the list of service accounts in &#42;this&#42; namespace that have the power to create the PodTemplateSpec.
+     */
     @JsonProperty("allowedServiceAccounts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ServiceAccountPodSecurityPolicyReviewStatus> getAllowedServiceAccounts() {
         return allowedServiceAccounts;
     }
 
+    /**
+     * allowedServiceAccounts returns the list of service accounts in &#42;this&#42; namespace that have the power to create the PodTemplateSpec.
+     */
     @JsonProperty("allowedServiceAccounts")
     public void setAllowedServiceAccounts(List<ServiceAccountPodSecurityPolicyReviewStatus> allowedServiceAccounts) {
         this.allowedServiceAccounts = allowedServiceAccounts;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicySelfSubjectReview.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicySelfSubjectReview.java
index 7fa6df0c5f0..73e1656243d 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicySelfSubjectReview.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicySelfSubjectReview.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodSecurityPolicySelfSubjectReview checks whether this user/SA tuple can create the PodTemplateSpec<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class PodSecurityPolicySelfSubjectReview implements Editable<PodSecurityPolicySelfSubjectReviewBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "security.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodSecurityPolicySelfSubjectReview";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PodSecurityPolicySelfSubjectReview(String apiVersion, String kind, Object
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodSecurityPolicySelfSubjectReview checks whether this user/SA tuple can create the PodTemplateSpec<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodSecurityPolicySelfSubjectReview checks whether this user/SA tuple can create the PodTemplateSpec<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PodSecurityPolicySelfSubjectReview checks whether this user/SA tuple can create the PodTemplateSpec<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public PodSecurityPolicySelfSubjectReviewSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PodSecurityPolicySelfSubjectReview checks whether this user/SA tuple can create the PodTemplateSpec<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(PodSecurityPolicySelfSubjectReviewSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PodSecurityPolicySelfSubjectReview checks whether this user/SA tuple can create the PodTemplateSpec<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public PodSecurityPolicySubjectReviewStatus getStatus() {
         return status;
     }
 
+    /**
+     * PodSecurityPolicySelfSubjectReview checks whether this user/SA tuple can create the PodTemplateSpec<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(PodSecurityPolicySubjectReviewStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicySelfSubjectReviewSpec.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicySelfSubjectReviewSpec.java
index 305bd79cfa7..506b721a79b 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicySelfSubjectReviewSpec.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicySelfSubjectReviewSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodSecurityPolicySelfSubjectReviewSpec contains specification for PodSecurityPolicySelfSubjectReview.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public PodSecurityPolicySelfSubjectReviewSpec(PodTemplateSpec template) {
         this.template = template;
     }
 
+    /**
+     * PodSecurityPolicySelfSubjectReviewSpec contains specification for PodSecurityPolicySelfSubjectReview.
+     */
     @JsonProperty("template")
     public PodTemplateSpec getTemplate() {
         return template;
     }
 
+    /**
+     * PodSecurityPolicySelfSubjectReviewSpec contains specification for PodSecurityPolicySelfSubjectReview.
+     */
     @JsonProperty("template")
     public void setTemplate(PodTemplateSpec template) {
         this.template = template;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicySubjectReview.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicySubjectReview.java
index d2ab8bbfc44..0f002d5d431 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicySubjectReview.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicySubjectReview.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodSecurityPolicySubjectReview checks whether a particular user/SA tuple can create the PodTemplateSpec.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class PodSecurityPolicySubjectReview implements Editable<PodSecurityPolicySubjectReviewBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "security.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "PodSecurityPolicySubjectReview";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public PodSecurityPolicySubjectReview(String apiVersion, String kind, ObjectMeta
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * PodSecurityPolicySubjectReview checks whether a particular user/SA tuple can create the PodTemplateSpec.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * PodSecurityPolicySubjectReview checks whether a particular user/SA tuple can create the PodTemplateSpec.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * PodSecurityPolicySubjectReview checks whether a particular user/SA tuple can create the PodTemplateSpec.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public PodSecurityPolicySubjectReviewSpec getSpec() {
         return spec;
     }
 
+    /**
+     * PodSecurityPolicySubjectReview checks whether a particular user/SA tuple can create the PodTemplateSpec.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(PodSecurityPolicySubjectReviewSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * PodSecurityPolicySubjectReview checks whether a particular user/SA tuple can create the PodTemplateSpec.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public PodSecurityPolicySubjectReviewStatus getStatus() {
         return status;
     }
 
+    /**
+     * PodSecurityPolicySubjectReview checks whether a particular user/SA tuple can create the PodTemplateSpec.<br><p> <br><p> Compatibility level 2: Stable within a major release for a minimum of 9 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(PodSecurityPolicySubjectReviewStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicySubjectReviewSpec.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicySubjectReviewSpec.java
index 99a803b35b4..95abba07052 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicySubjectReviewSpec.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicySubjectReviewSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodSecurityPolicySubjectReviewSpec defines specification for PodSecurityPolicySubjectReview
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -89,32 +92,50 @@ public PodSecurityPolicySubjectReviewSpec(List<String> groups, PodTemplateSpec t
         this.user = user;
     }
 
+    /**
+     * groups is the groups you're testing for.
+     */
     @JsonProperty("groups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getGroups() {
         return groups;
     }
 
+    /**
+     * groups is the groups you're testing for.
+     */
     @JsonProperty("groups")
     public void setGroups(List<String> groups) {
         this.groups = groups;
     }
 
+    /**
+     * PodSecurityPolicySubjectReviewSpec defines specification for PodSecurityPolicySubjectReview
+     */
     @JsonProperty("template")
     public PodTemplateSpec getTemplate() {
         return template;
     }
 
+    /**
+     * PodSecurityPolicySubjectReviewSpec defines specification for PodSecurityPolicySubjectReview
+     */
     @JsonProperty("template")
     public void setTemplate(PodTemplateSpec template) {
         this.template = template;
     }
 
+    /**
+     * user is the user you're testing for. If you specify "user" but not "group", then is it interpreted as "What if user were not a member of any groups. If user and groups are empty, then the check is performed using &#42;only&#42; the serviceAccountName in the template.
+     */
     @JsonProperty("user")
     public String getUser() {
         return user;
     }
 
+    /**
+     * user is the user you're testing for. If you specify "user" but not "group", then is it interpreted as "What if user were not a member of any groups. If user and groups are empty, then the check is performed using &#42;only&#42; the serviceAccountName in the template.
+     */
     @JsonProperty("user")
     public void setUser(String user) {
         this.user = user;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicySubjectReviewStatus.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicySubjectReviewStatus.java
index 8f0b482f48b..06d0fd8036c 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicySubjectReviewStatus.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PodSecurityPolicySubjectReviewStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PodSecurityPolicySubjectReviewStatus contains information/status for PodSecurityPolicySubjectReview.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public PodSecurityPolicySubjectReviewStatus(ObjectReference allowedBy, String re
         this.template = template;
     }
 
+    /**
+     * PodSecurityPolicySubjectReviewStatus contains information/status for PodSecurityPolicySubjectReview.
+     */
     @JsonProperty("allowedBy")
     public ObjectReference getAllowedBy() {
         return allowedBy;
     }
 
+    /**
+     * PodSecurityPolicySubjectReviewStatus contains information/status for PodSecurityPolicySubjectReview.
+     */
     @JsonProperty("allowedBy")
     public void setAllowedBy(ObjectReference allowedBy) {
         this.allowedBy = allowedBy;
     }
 
+    /**
+     * A machine-readable description of why this operation is in the "Failure" status. If this value is empty there is no information available.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * A machine-readable description of why this operation is in the "Failure" status. If this value is empty there is no information available.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * PodSecurityPolicySubjectReviewStatus contains information/status for PodSecurityPolicySubjectReview.
+     */
     @JsonProperty("template")
     public PodTemplateSpec getTemplate() {
         return template;
     }
 
+    /**
+     * PodSecurityPolicySubjectReviewStatus contains information/status for PodSecurityPolicySubjectReview.
+     */
     @JsonProperty("template")
     public void setTemplate(PodTemplateSpec template) {
         this.template = template;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PolicyRule.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PolicyRule.java
index 5d58f217fff..080ba2e48cd 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PolicyRule.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/PolicyRule.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * PolicyRule holds information that describes a policy rule, but does not contain information about who the rule applies to or which namespace the rule applies to.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -106,67 +109,103 @@ public PolicyRule(List<String> apiGroups, Object attributeRestrictions, List<Str
         this.verbs = verbs;
     }
 
+    /**
+     * APIGroups is the name of the APIGroup that contains the resources.  If this field is empty, then both kubernetes and origin API groups are assumed. That means that if an action is requested against one of the enumerated resources in either the kubernetes or the origin API group, the request will be allowed
+     */
     @JsonProperty("apiGroups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getApiGroups() {
         return apiGroups;
     }
 
+    /**
+     * APIGroups is the name of the APIGroup that contains the resources.  If this field is empty, then both kubernetes and origin API groups are assumed. That means that if an action is requested against one of the enumerated resources in either the kubernetes or the origin API group, the request will be allowed
+     */
     @JsonProperty("apiGroups")
     public void setApiGroups(List<String> apiGroups) {
         this.apiGroups = apiGroups;
     }
 
+    /**
+     * PolicyRule holds information that describes a policy rule, but does not contain information about who the rule applies to or which namespace the rule applies to.
+     */
     @JsonProperty("attributeRestrictions")
     public Object getAttributeRestrictions() {
         return attributeRestrictions;
     }
 
+    /**
+     * PolicyRule holds information that describes a policy rule, but does not contain information about who the rule applies to or which namespace the rule applies to.
+     */
     @JsonProperty("attributeRestrictions")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setAttributeRestrictions(Object attributeRestrictions) {
         this.attributeRestrictions = attributeRestrictions;
     }
 
+    /**
+     * NonResourceURLsSlice is a set of partial urls that a user should have access to.  &#42;s are allowed, but only as the full, final step in the path This name is intentionally different than the internal type so that the DefaultConvert works nicely and because the ordering may be different.
+     */
     @JsonProperty("nonResourceURLs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNonResourceURLs() {
         return nonResourceURLs;
     }
 
+    /**
+     * NonResourceURLsSlice is a set of partial urls that a user should have access to.  &#42;s are allowed, but only as the full, final step in the path This name is intentionally different than the internal type so that the DefaultConvert works nicely and because the ordering may be different.
+     */
     @JsonProperty("nonResourceURLs")
     public void setNonResourceURLs(List<String> nonResourceURLs) {
         this.nonResourceURLs = nonResourceURLs;
     }
 
+    /**
+     * ResourceNames is an optional white list of names that the rule applies to.  An empty set means that everything is allowed.
+     */
     @JsonProperty("resourceNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getResourceNames() {
         return resourceNames;
     }
 
+    /**
+     * ResourceNames is an optional white list of names that the rule applies to.  An empty set means that everything is allowed.
+     */
     @JsonProperty("resourceNames")
     public void setResourceNames(List<String> resourceNames) {
         this.resourceNames = resourceNames;
     }
 
+    /**
+     * Resources is a list of resources this rule applies to.  ResourceAll represents all resources.
+     */
     @JsonProperty("resources")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getResources() {
         return resources;
     }
 
+    /**
+     * Resources is a list of resources this rule applies to.  ResourceAll represents all resources.
+     */
     @JsonProperty("resources")
     public void setResources(List<String> resources) {
         this.resources = resources;
     }
 
+    /**
+     * Verbs is a list of Verbs that apply to ALL the ResourceKinds and AttributeRestrictions contained in this rule.  VerbAll represents all kinds.
+     */
     @JsonProperty("verbs")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getVerbs() {
         return verbs;
     }
 
+    /**
+     * Verbs is a list of Verbs that apply to ALL the ResourceKinds and AttributeRestrictions contained in this rule.  VerbAll represents all kinds.
+     */
     @JsonProperty("verbs")
     public void setVerbs(List<String> verbs) {
         this.verbs = verbs;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Project.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Project.java
index 44497fcfefe..ee8beb83f2d 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Project.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Project.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Projects are the unit of isolation and collaboration in OpenShift. A project has one or more members, a quota on the resources that the project may consume, and the security controls on the resources in the project. Within a project, members may have different roles - project administrators can set membership, editors can create and manage the resources, and viewers can see but not access running containers. In a normal cluster project administrators are not able to alter their quotas - that is restricted to cluster administrators.<br><p> <br><p> Listing or watching projects will return only projects the user has the reader role on.<br><p> <br><p> An OpenShift project is an alternative representation of a Kubernetes namespace. Projects are exposed as editable to end users while namespaces are not. Direct creation of a project is typically restricted to administrators, while end users should use the requestproject resource.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class Project implements Editable<ProjectBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "project.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Project";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public Project(String apiVersion, String kind, ObjectMeta metadata, ProjectSpec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,38 +131,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Projects are the unit of isolation and collaboration in OpenShift. A project has one or more members, a quota on the resources that the project may consume, and the security controls on the resources in the project. Within a project, members may have different roles - project administrators can set membership, editors can create and manage the resources, and viewers can see but not access running containers. In a normal cluster project administrators are not able to alter their quotas - that is restricted to cluster administrators.<br><p> <br><p> Listing or watching projects will return only projects the user has the reader role on.<br><p> <br><p> An OpenShift project is an alternative representation of a Kubernetes namespace. Projects are exposed as editable to end users while namespaces are not. Direct creation of a project is typically restricted to administrators, while end users should use the requestproject resource.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Projects are the unit of isolation and collaboration in OpenShift. A project has one or more members, a quota on the resources that the project may consume, and the security controls on the resources in the project. Within a project, members may have different roles - project administrators can set membership, editors can create and manage the resources, and viewers can see but not access running containers. In a normal cluster project administrators are not able to alter their quotas - that is restricted to cluster administrators.<br><p> <br><p> Listing or watching projects will return only projects the user has the reader role on.<br><p> <br><p> An OpenShift project is an alternative representation of a Kubernetes namespace. Projects are exposed as editable to end users while namespaces are not. Direct creation of a project is typically restricted to administrators, while end users should use the requestproject resource.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Projects are the unit of isolation and collaboration in OpenShift. A project has one or more members, a quota on the resources that the project may consume, and the security controls on the resources in the project. Within a project, members may have different roles - project administrators can set membership, editors can create and manage the resources, and viewers can see but not access running containers. In a normal cluster project administrators are not able to alter their quotas - that is restricted to cluster administrators.<br><p> <br><p> Listing or watching projects will return only projects the user has the reader role on.<br><p> <br><p> An OpenShift project is an alternative representation of a Kubernetes namespace. Projects are exposed as editable to end users while namespaces are not. Direct creation of a project is typically restricted to administrators, while end users should use the requestproject resource.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public ProjectSpec getSpec() {
         return spec;
     }
 
+    /**
+     * Projects are the unit of isolation and collaboration in OpenShift. A project has one or more members, a quota on the resources that the project may consume, and the security controls on the resources in the project. Within a project, members may have different roles - project administrators can set membership, editors can create and manage the resources, and viewers can see but not access running containers. In a normal cluster project administrators are not able to alter their quotas - that is restricted to cluster administrators.<br><p> <br><p> Listing or watching projects will return only projects the user has the reader role on.<br><p> <br><p> An OpenShift project is an alternative representation of a Kubernetes namespace. Projects are exposed as editable to end users while namespaces are not. Direct creation of a project is typically restricted to administrators, while end users should use the requestproject resource.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(ProjectSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * Projects are the unit of isolation and collaboration in OpenShift. A project has one or more members, a quota on the resources that the project may consume, and the security controls on the resources in the project. Within a project, members may have different roles - project administrators can set membership, editors can create and manage the resources, and viewers can see but not access running containers. In a normal cluster project administrators are not able to alter their quotas - that is restricted to cluster administrators.<br><p> <br><p> Listing or watching projects will return only projects the user has the reader role on.<br><p> <br><p> An OpenShift project is an alternative representation of a Kubernetes namespace. Projects are exposed as editable to end users while namespaces are not. Direct creation of a project is typically restricted to administrators, while end users should use the requestproject resource.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public ProjectStatus getStatus() {
         return status;
     }
 
+    /**
+     * Projects are the unit of isolation and collaboration in OpenShift. A project has one or more members, a quota on the resources that the project may consume, and the security controls on the resources in the project. Within a project, members may have different roles - project administrators can set membership, editors can create and manage the resources, and viewers can see but not access running containers. In a normal cluster project administrators are not able to alter their quotas - that is restricted to cluster administrators.<br><p> <br><p> Listing or watching projects will return only projects the user has the reader role on.<br><p> <br><p> An OpenShift project is an alternative representation of a Kubernetes namespace. Projects are exposed as editable to end users while namespaces are not. Direct creation of a project is typically restricted to administrators, while end users should use the requestproject resource.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(ProjectStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ProjectList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ProjectList.java
index ac5d0a94e61..41cf8f54735 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ProjectList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ProjectList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ProjectList is a list of Project objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class ProjectList implements Editable<ProjectListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.Project>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "project.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.Project> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ProjectList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public ProjectList(String apiVersion, List<io.fabric8.openshift.api.model.Projec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of projects
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.Project> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of projects
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.Project> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ProjectList is a list of Project objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ProjectList is a list of Project objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ProjectRequest.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ProjectRequest.java
index 753381167c3..7a27da5fb9e 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ProjectRequest.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ProjectRequest.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ProjectRequest is the set of options necessary to fully qualify a project request<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,18 +78,12 @@
 public class ProjectRequest implements Editable<ProjectRequestBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "project.openshift.io/v1";
     @JsonProperty("description")
     private String description;
     @JsonProperty("displayName")
     private String displayName;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ProjectRequest";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public ProjectRequest(String apiVersion, String description, String displayName,
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,35 +115,47 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Description is the description to apply to a project
+     */
     @JsonProperty("description")
     public String getDescription() {
         return description;
     }
 
+    /**
+     * Description is the description to apply to a project
+     */
     @JsonProperty("description")
     public void setDescription(String description) {
         this.description = description;
     }
 
+    /**
+     * DisplayName is the display name to apply to a project
+     */
     @JsonProperty("displayName")
     public String getDisplayName() {
         return displayName;
     }
 
+    /**
+     * DisplayName is the display name to apply to a project
+     */
     @JsonProperty("displayName")
     public void setDisplayName(String displayName) {
         this.displayName = displayName;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -154,18 +163,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ProjectRequest is the set of options necessary to fully qualify a project request<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ProjectRequest is the set of options necessary to fully qualify a project request<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ProjectSpec.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ProjectSpec.java
index e1244544cc6..4a1822303d1 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ProjectSpec.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ProjectSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ProjectSpec describes the attributes on a Project
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public ProjectSpec(List<String> finalizers) {
         this.finalizers = finalizers;
     }
 
+    /**
+     * Finalizers is an opaque list of values that must be empty to permanently remove object from storage
+     */
     @JsonProperty("finalizers")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getFinalizers() {
         return finalizers;
     }
 
+    /**
+     * Finalizers is an opaque list of values that must be empty to permanently remove object from storage
+     */
     @JsonProperty("finalizers")
     public void setFinalizers(List<String> finalizers) {
         this.finalizers = finalizers;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ProjectStatus.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ProjectStatus.java
index e60f809bb56..799d4158efc 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ProjectStatus.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ProjectStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ProjectStatus is information about the current status of a Project
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,22 +89,34 @@ public ProjectStatus(List<NamespaceCondition> conditions, String phase) {
         this.phase = phase;
     }
 
+    /**
+     * Represents the latest available observations of the project current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<NamespaceCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Represents the latest available observations of the project current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<NamespaceCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Phase is the current lifecycle phase of the project<br><p> <br><p> Possible enum values:<br><p>  - `"Active"` means the namespace is available for use in the system<br><p>  - `"Terminating"` means the namespace is undergoing graceful termination
+     */
     @JsonProperty("phase")
     public String getPhase() {
         return phase;
     }
 
+    /**
+     * Phase is the current lifecycle phase of the project<br><p> <br><p> Possible enum values:<br><p>  - `"Active"` means the namespace is available for use in the system<br><p>  - `"Terminating"` means the namespace is undergoing graceful termination
+     */
     @JsonProperty("phase")
     public void setPhase(String phase) {
         this.phase = phase;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ProxyConfig.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ProxyConfig.java
index 9d33615c353..750afa81f95 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ProxyConfig.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ProxyConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ProxyConfig defines what proxies to use for an operation
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public ProxyConfig(String httpProxy, String httpsProxy, String noProxy) {
         this.noProxy = noProxy;
     }
 
+    /**
+     * httpProxy is a proxy used to reach the git repository over http
+     */
     @JsonProperty("httpProxy")
     public String getHttpProxy() {
         return httpProxy;
     }
 
+    /**
+     * httpProxy is a proxy used to reach the git repository over http
+     */
     @JsonProperty("httpProxy")
     public void setHttpProxy(String httpProxy) {
         this.httpProxy = httpProxy;
     }
 
+    /**
+     * httpsProxy is a proxy used to reach the git repository over https
+     */
     @JsonProperty("httpsProxy")
     public String getHttpsProxy() {
         return httpsProxy;
     }
 
+    /**
+     * httpsProxy is a proxy used to reach the git repository over https
+     */
     @JsonProperty("httpsProxy")
     public void setHttpsProxy(String httpsProxy) {
         this.httpsProxy = httpsProxy;
     }
 
+    /**
+     * noProxy is the list of domains for which the proxy should not be used
+     */
     @JsonProperty("noProxy")
     public String getNoProxy() {
         return noProxy;
     }
 
+    /**
+     * noProxy is the list of domains for which the proxy should not be used
+     */
     @JsonProperty("noProxy")
     public void setNoProxy(String noProxy) {
         this.noProxy = noProxy;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RangeAllocation.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RangeAllocation.java
index 4f2de552574..4ba3c51e345 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RangeAllocation.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RangeAllocation.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RangeAllocation is used so we can easily expose a RangeAllocation typed for security group<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,16 +78,10 @@
 public class RangeAllocation implements Editable<RangeAllocationBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "security.openshift.io/v1";
     @JsonProperty("data")
     private String data;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "RangeAllocation";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public RangeAllocation(String apiVersion, String data, String kind, ObjectMeta m
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,25 +115,31 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * data is a byte array representing the serialized state of a range allocation.  It is a bitmap with each bit set to one to represent a range is taken.
+     */
     @JsonProperty("data")
     public String getData() {
         return data;
     }
 
+    /**
+     * data is a byte array representing the serialized state of a range allocation.  It is a bitmap with each bit set to one to represent a range is taken.
+     */
     @JsonProperty("data")
     public void setData(String data) {
         this.data = data;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -144,28 +147,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RangeAllocation is used so we can easily expose a RangeAllocation typed for security group<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RangeAllocation is used so we can easily expose a RangeAllocation typed for security group<br><p> <br><p> Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support.
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * range is a string representing a unique label for a range of uids, "1000000000-2000000000/10000".
+     */
     @JsonProperty("range")
     public String getRange() {
         return range;
     }
 
+    /**
+     * range is a string representing a unique label for a range of uids, "1000000000-2000000000/10000".
+     */
     @JsonProperty("range")
     public void setRange(String range) {
         this.range = range;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RangeAllocationList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RangeAllocationList.java
index 04fa3a266db..496214b1942 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RangeAllocationList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RangeAllocationList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RangeAllocationList is a list of RangeAllocations objects<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class RangeAllocationList implements Editable<RangeAllocationListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.RangeAllocation>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "security.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.RangeAllocation> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "RangeAllocationList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public RangeAllocationList(String apiVersion, List<io.fabric8.openshift.api.mode
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of RangeAllocations.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.RangeAllocation> getItems() {
         return items;
     }
 
+    /**
+     * List of RangeAllocations.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.RangeAllocation> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RangeAllocationList is a list of RangeAllocations objects<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RangeAllocationList is a list of RangeAllocations objects<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RecreateDeploymentStrategyParams.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RecreateDeploymentStrategyParams.java
index aa5e393acad..08867b9fe94 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RecreateDeploymentStrategyParams.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RecreateDeploymentStrategyParams.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RecreateDeploymentStrategyParams are the input to the Recreate deployment strategy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public RecreateDeploymentStrategyParams(LifecycleHook mid, LifecycleHook post, L
         this.timeoutSeconds = timeoutSeconds;
     }
 
+    /**
+     * RecreateDeploymentStrategyParams are the input to the Recreate deployment strategy.
+     */
     @JsonProperty("mid")
     public LifecycleHook getMid() {
         return mid;
     }
 
+    /**
+     * RecreateDeploymentStrategyParams are the input to the Recreate deployment strategy.
+     */
     @JsonProperty("mid")
     public void setMid(LifecycleHook mid) {
         this.mid = mid;
     }
 
+    /**
+     * RecreateDeploymentStrategyParams are the input to the Recreate deployment strategy.
+     */
     @JsonProperty("post")
     public LifecycleHook getPost() {
         return post;
     }
 
+    /**
+     * RecreateDeploymentStrategyParams are the input to the Recreate deployment strategy.
+     */
     @JsonProperty("post")
     public void setPost(LifecycleHook post) {
         this.post = post;
     }
 
+    /**
+     * RecreateDeploymentStrategyParams are the input to the Recreate deployment strategy.
+     */
     @JsonProperty("pre")
     public LifecycleHook getPre() {
         return pre;
     }
 
+    /**
+     * RecreateDeploymentStrategyParams are the input to the Recreate deployment strategy.
+     */
     @JsonProperty("pre")
     public void setPre(LifecycleHook pre) {
         this.pre = pre;
     }
 
+    /**
+     * TimeoutSeconds is the time to wait for updates before giving up. If the value is nil, a default will be used.
+     */
     @JsonProperty("timeoutSeconds")
     public Long getTimeoutSeconds() {
         return timeoutSeconds;
     }
 
+    /**
+     * TimeoutSeconds is the time to wait for updates before giving up. If the value is nil, a default will be used.
+     */
     @JsonProperty("timeoutSeconds")
     public void setTimeoutSeconds(Long timeoutSeconds) {
         this.timeoutSeconds = timeoutSeconds;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RedirectReference.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RedirectReference.java
index a2e795a7bcf..481d1587171 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RedirectReference.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RedirectReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RedirectReference specifies the target in the current namespace that resolves into redirect URIs.  Only the 'Route' kind is currently allowed.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public RedirectReference(String group, String kind, String name) {
         this.name = name;
     }
 
+    /**
+     * The group of the target that is being referred to.
+     */
     @JsonProperty("group")
     public String getGroup() {
         return group;
     }
 
+    /**
+     * The group of the target that is being referred to.
+     */
     @JsonProperty("group")
     public void setGroup(String group) {
         this.group = group;
     }
 
+    /**
+     * The kind of the target that is being referred to.  Currently, only 'Route' is allowed.
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * The kind of the target that is being referred to.  Currently, only 'Route' is allowed.
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * The name of the target that is being referred to. e.g. name of the Route.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * The name of the target that is being referred to. e.g. name of the Route.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RepositoryImportSpec.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RepositoryImportSpec.java
index 7900f48871a..7c563e9833d 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RepositoryImportSpec.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RepositoryImportSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RepositoryImportSpec describes a request to import images from a container image repository.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public RepositoryImportSpec(ObjectReference from, TagImportPolicy importPolicy,
         this.referencePolicy = referencePolicy;
     }
 
+    /**
+     * RepositoryImportSpec describes a request to import images from a container image repository.
+     */
     @JsonProperty("from")
     public ObjectReference getFrom() {
         return from;
     }
 
+    /**
+     * RepositoryImportSpec describes a request to import images from a container image repository.
+     */
     @JsonProperty("from")
     public void setFrom(ObjectReference from) {
         this.from = from;
     }
 
+    /**
+     * RepositoryImportSpec describes a request to import images from a container image repository.
+     */
     @JsonProperty("importPolicy")
     public TagImportPolicy getImportPolicy() {
         return importPolicy;
     }
 
+    /**
+     * RepositoryImportSpec describes a request to import images from a container image repository.
+     */
     @JsonProperty("importPolicy")
     public void setImportPolicy(TagImportPolicy importPolicy) {
         this.importPolicy = importPolicy;
     }
 
+    /**
+     * IncludeManifest determines if the manifest for each image is returned in the response
+     */
     @JsonProperty("includeManifest")
     public Boolean getIncludeManifest() {
         return includeManifest;
     }
 
+    /**
+     * IncludeManifest determines if the manifest for each image is returned in the response
+     */
     @JsonProperty("includeManifest")
     public void setIncludeManifest(Boolean includeManifest) {
         this.includeManifest = includeManifest;
     }
 
+    /**
+     * RepositoryImportSpec describes a request to import images from a container image repository.
+     */
     @JsonProperty("referencePolicy")
     public TagReferencePolicy getReferencePolicy() {
         return referencePolicy;
     }
 
+    /**
+     * RepositoryImportSpec describes a request to import images from a container image repository.
+     */
     @JsonProperty("referencePolicy")
     public void setReferencePolicy(TagReferencePolicy referencePolicy) {
         this.referencePolicy = referencePolicy;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RepositoryImportStatus.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RepositoryImportStatus.java
index 38b5523b9c4..237350d746e 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RepositoryImportStatus.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RepositoryImportStatus.java
@@ -35,6 +35,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RepositoryImportStatus describes the result of an image repository import
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,33 +94,51 @@ public RepositoryImportStatus(List<String> additionalTags, List<ImageImportStatu
         this.status = status;
     }
 
+    /**
+     * AdditionalTags are tags that exist in the repository but were not imported because a maximum limit of automatic imports was applied.
+     */
     @JsonProperty("additionalTags")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAdditionalTags() {
         return additionalTags;
     }
 
+    /**
+     * AdditionalTags are tags that exist in the repository but were not imported because a maximum limit of automatic imports was applied.
+     */
     @JsonProperty("additionalTags")
     public void setAdditionalTags(List<String> additionalTags) {
         this.additionalTags = additionalTags;
     }
 
+    /**
+     * Images is a list of images successfully retrieved by the import of the repository.
+     */
     @JsonProperty("images")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ImageImportStatus> getImages() {
         return images;
     }
 
+    /**
+     * Images is a list of images successfully retrieved by the import of the repository.
+     */
     @JsonProperty("images")
     public void setImages(List<ImageImportStatus> images) {
         this.images = images;
     }
 
+    /**
+     * RepositoryImportStatus describes the result of an image repository import
+     */
     @JsonProperty("status")
     public Status getStatus() {
         return status;
     }
 
+    /**
+     * RepositoryImportStatus describes the result of an image repository import
+     */
     @JsonProperty("status")
     public void setStatus(Status status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ResourceAccessReview.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ResourceAccessReview.java
index 25981a0eba9..27d43e16450 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ResourceAccessReview.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ResourceAccessReview.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceAccessReview is a means to request a list of which users and groups are authorized to perform the action specified by spec<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,9 +85,6 @@
 public class ResourceAccessReview implements Editable<ResourceAccessReviewBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authorization.openshift.io/v1";
     @JsonProperty("content")
@@ -92,9 +92,6 @@ public class ResourceAccessReview implements Editable<ResourceAccessReviewBuilde
     private Object content;
     @JsonProperty("isNonResourceURL")
     private Boolean isNonResourceURL;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResourceAccessReview";
     @JsonProperty("metadata")
@@ -139,7 +136,7 @@ public ResourceAccessReview(String apiVersion, Object content, Boolean isNonReso
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -147,36 +144,48 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * ResourceAccessReview is a means to request a list of which users and groups are authorized to perform the action specified by spec<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("content")
     public Object getContent() {
         return content;
     }
 
+    /**
+     * ResourceAccessReview is a means to request a list of which users and groups are authorized to perform the action specified by spec<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("content")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setContent(Object content) {
         this.content = content;
     }
 
+    /**
+     * IsNonResourceURL is true if this is a request for a non-resource URL (outside of the resource hierarchy)
+     */
     @JsonProperty("isNonResourceURL")
     public Boolean getIsNonResourceURL() {
         return isNonResourceURL;
     }
 
+    /**
+     * IsNonResourceURL is true if this is a request for a non-resource URL (outside of the resource hierarchy)
+     */
     @JsonProperty("isNonResourceURL")
     public void setIsNonResourceURL(Boolean isNonResourceURL) {
         this.isNonResourceURL = isNonResourceURL;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -184,88 +193,136 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * ResourceAccessReview is a means to request a list of which users and groups are authorized to perform the action specified by spec<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * ResourceAccessReview is a means to request a list of which users and groups are authorized to perform the action specified by spec<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Namespace is the namespace of the action being requested.  Currently, there is no distinction between no namespace and all namespaces
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace of the action being requested.  Currently, there is no distinction between no namespace and all namespaces
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Path is the path of a non resource URL
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Path is the path of a non resource URL
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * Resource is one of the existing resource types
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * Resource is one of the existing resource types
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
     }
 
+    /**
+     * Group is the API group of the resource Serialized as resourceAPIGroup to avoid confusion with the 'groups' field when inlined
+     */
     @JsonProperty("resourceAPIGroup")
     public String getResourceAPIGroup() {
         return resourceAPIGroup;
     }
 
+    /**
+     * Group is the API group of the resource Serialized as resourceAPIGroup to avoid confusion with the 'groups' field when inlined
+     */
     @JsonProperty("resourceAPIGroup")
     public void setResourceAPIGroup(String resourceAPIGroup) {
         this.resourceAPIGroup = resourceAPIGroup;
     }
 
+    /**
+     * Version is the API version of the resource Serialized as resourceAPIVersion to avoid confusion with TypeMeta.apiVersion and ObjectMeta.resourceVersion when inlined
+     */
     @JsonProperty("resourceAPIVersion")
     public String getResourceAPIVersion() {
         return resourceAPIVersion;
     }
 
+    /**
+     * Version is the API version of the resource Serialized as resourceAPIVersion to avoid confusion with TypeMeta.apiVersion and ObjectMeta.resourceVersion when inlined
+     */
     @JsonProperty("resourceAPIVersion")
     public void setResourceAPIVersion(String resourceAPIVersion) {
         this.resourceAPIVersion = resourceAPIVersion;
     }
 
+    /**
+     * ResourceName is the name of the resource being requested for a "get" or deleted for a "delete"
+     */
     @JsonProperty("resourceName")
     public String getResourceName() {
         return resourceName;
     }
 
+    /**
+     * ResourceName is the name of the resource being requested for a "get" or deleted for a "delete"
+     */
     @JsonProperty("resourceName")
     public void setResourceName(String resourceName) {
         this.resourceName = resourceName;
     }
 
+    /**
+     * Verb is one of: get, list, watch, create, update, delete
+     */
     @JsonProperty("verb")
     public String getVerb() {
         return verb;
     }
 
+    /**
+     * Verb is one of: get, list, watch, create, update, delete
+     */
     @JsonProperty("verb")
     public void setVerb(String verb) {
         this.verb = verb;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ResourceAccessReviewResponse.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ResourceAccessReviewResponse.java
index 8a21a2951bf..ca0d4896b6c 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ResourceAccessReviewResponse.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ResourceAccessReviewResponse.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceAccessReviewResponse describes who can perform the action<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,9 +82,6 @@
 public class ResourceAccessReviewResponse implements Editable<ResourceAccessReviewResponseBuilder>, KubernetesResource, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authorization.openshift.io/v1";
     @JsonProperty("evalutionError")
@@ -89,9 +89,6 @@ public class ResourceAccessReviewResponse implements Editable<ResourceAccessRevi
     @JsonProperty("groups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<String> groups = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "ResourceAccessReviewResponse";
     @JsonProperty("namespace")
@@ -119,7 +116,7 @@ public ResourceAccessReviewResponse(String apiVersion, String evalutionError, Li
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -127,36 +124,48 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * EvaluationError is an indication that some error occurred during resolution, but partial results can still be returned. It is entirely possible to get an error and be able to continue determine authorization status in spite of it.  This is most common when a bound role is missing, but enough roles are still present and bound to reason about the request.
+     */
     @JsonProperty("evalutionError")
     public String getEvalutionError() {
         return evalutionError;
     }
 
+    /**
+     * EvaluationError is an indication that some error occurred during resolution, but partial results can still be returned. It is entirely possible to get an error and be able to continue determine authorization status in spite of it.  This is most common when a bound role is missing, but enough roles are still present and bound to reason about the request.
+     */
     @JsonProperty("evalutionError")
     public void setEvalutionError(String evalutionError) {
         this.evalutionError = evalutionError;
     }
 
+    /**
+     * GroupsSlice is the list of groups who can perform the action
+     */
     @JsonProperty("groups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getGroups() {
         return groups;
     }
 
+    /**
+     * GroupsSlice is the list of groups who can perform the action
+     */
     @JsonProperty("groups")
     public void setGroups(List<String> groups) {
         this.groups = groups;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -164,29 +173,41 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Namespace is the namespace used for the access review
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace used for the access review
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * UsersSlice is the list of users who can perform the action
+     */
     @JsonProperty("users")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getUsers() {
         return users;
     }
 
+    /**
+     * UsersSlice is the list of users who can perform the action
+     */
     @JsonProperty("users")
     public void setUsers(List<String> users) {
         this.users = users;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ResourceQuotaStatusByNamespace.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ResourceQuotaStatusByNamespace.java
index 31c620e8f63..af9772e1612 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ResourceQuotaStatusByNamespace.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ResourceQuotaStatusByNamespace.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ResourceQuotaStatusByNamespace gives status for a particular project
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public ResourceQuotaStatusByNamespace(String namespace, ResourceQuotaStatus stat
         this.status = status;
     }
 
+    /**
+     * Namespace the project this status applies to
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace the project this status applies to
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * ResourceQuotaStatusByNamespace gives status for a particular project
+     */
     @JsonProperty("status")
     public ResourceQuotaStatus getStatus() {
         return status;
     }
 
+    /**
+     * ResourceQuotaStatusByNamespace gives status for a particular project
+     */
     @JsonProperty("status")
     public void setStatus(ResourceQuotaStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Role.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Role.java
index ce888cc8728..b2fa61c7ecc 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Role.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Role.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Role is a logical grouping of PolicyRules that can be referenced as a unit by RoleBindings.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -77,14 +80,8 @@
 public class Role implements Editable<RoleBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authorization.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Role";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public Role(String apiVersion, String kind, ObjectMeta metadata, List<PolicyRule
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,7 +115,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -126,7 +123,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -134,29 +131,41 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Role is a logical grouping of PolicyRules that can be referenced as a unit by RoleBindings.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Role is a logical grouping of PolicyRules that can be referenced as a unit by RoleBindings.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Rules holds all the PolicyRules for this Role
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PolicyRule> getRules() {
         return rules;
     }
 
+    /**
+     * Rules holds all the PolicyRules for this Role
+     */
     @JsonProperty("rules")
     public void setRules(List<PolicyRule> rules) {
         this.rules = rules;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RoleBinding.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RoleBinding.java
index 9d28b61c27b..5289dca4832 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RoleBinding.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RoleBinding.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RoleBinding references a Role, but not contain it.  It can reference any Role in the same namespace or in the global namespace. It adds who information via (Users and Groups) OR Subjects and namespace information by which namespace it exists in. RoleBindings in a given namespace only have effect in that namespace (excepting the master namespace which has power in all namespaces).<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -80,17 +83,11 @@
 public class RoleBinding implements Editable<RoleBindingBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authorization.openshift.io/v1";
     @JsonProperty("groupNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<String> groupNames = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "RoleBinding";
     @JsonProperty("metadata")
@@ -124,7 +121,7 @@ public RoleBinding(String apiVersion, List<String> groupNames, String kind, Obje
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -132,26 +129,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * GroupNames holds all the groups directly bound to the role. This field should only be specified when supporting legacy clients and servers. See Subjects for further details.
+     */
     @JsonProperty("groupNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getGroupNames() {
         return groupNames;
     }
 
+    /**
+     * GroupNames holds all the groups directly bound to the role. This field should only be specified when supporting legacy clients and servers. See Subjects for further details.
+     */
     @JsonProperty("groupNames")
     public void setGroupNames(List<String> groupNames) {
         this.groupNames = groupNames;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -159,50 +162,74 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RoleBinding references a Role, but not contain it.  It can reference any Role in the same namespace or in the global namespace. It adds who information via (Users and Groups) OR Subjects and namespace information by which namespace it exists in. RoleBindings in a given namespace only have effect in that namespace (excepting the master namespace which has power in all namespaces).<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RoleBinding references a Role, but not contain it.  It can reference any Role in the same namespace or in the global namespace. It adds who information via (Users and Groups) OR Subjects and namespace information by which namespace it exists in. RoleBindings in a given namespace only have effect in that namespace (excepting the master namespace which has power in all namespaces).<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * RoleBinding references a Role, but not contain it.  It can reference any Role in the same namespace or in the global namespace. It adds who information via (Users and Groups) OR Subjects and namespace information by which namespace it exists in. RoleBindings in a given namespace only have effect in that namespace (excepting the master namespace which has power in all namespaces).<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("roleRef")
     public ObjectReference getRoleRef() {
         return roleRef;
     }
 
+    /**
+     * RoleBinding references a Role, but not contain it.  It can reference any Role in the same namespace or in the global namespace. It adds who information via (Users and Groups) OR Subjects and namespace information by which namespace it exists in. RoleBindings in a given namespace only have effect in that namespace (excepting the master namespace which has power in all namespaces).<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("roleRef")
     public void setRoleRef(ObjectReference roleRef) {
         this.roleRef = roleRef;
     }
 
+    /**
+     * Subjects hold object references to authorize with this rule. This field is ignored if UserNames or GroupNames are specified to support legacy clients and servers. Thus newer clients that do not need to support backwards compatibility should send only fully qualified Subjects and should omit the UserNames and GroupNames fields. Clients that need to support backwards compatibility can use this field to build the UserNames and GroupNames.
+     */
     @JsonProperty("subjects")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ObjectReference> getSubjects() {
         return subjects;
     }
 
+    /**
+     * Subjects hold object references to authorize with this rule. This field is ignored if UserNames or GroupNames are specified to support legacy clients and servers. Thus newer clients that do not need to support backwards compatibility should send only fully qualified Subjects and should omit the UserNames and GroupNames fields. Clients that need to support backwards compatibility can use this field to build the UserNames and GroupNames.
+     */
     @JsonProperty("subjects")
     public void setSubjects(List<ObjectReference> subjects) {
         this.subjects = subjects;
     }
 
+    /**
+     * UserNames holds all the usernames directly bound to the role. This field should only be specified when supporting legacy clients and servers. See Subjects for further details.
+     */
     @JsonProperty("userNames")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getUserNames() {
         return userNames;
     }
 
+    /**
+     * UserNames holds all the usernames directly bound to the role. This field should only be specified when supporting legacy clients and servers. See Subjects for further details.
+     */
     @JsonProperty("userNames")
     public void setUserNames(List<String> userNames) {
         this.userNames = userNames;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RoleBindingList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RoleBindingList.java
index 759823db513..6c7c548812b 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RoleBindingList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RoleBindingList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RoleBindingList is a collection of RoleBindings<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class RoleBindingList implements Editable<RoleBindingListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.RoleBinding>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authorization.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.RoleBinding> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "RoleBindingList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public RoleBindingList(String apiVersion, List<io.fabric8.openshift.api.model.Ro
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of RoleBindings
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.RoleBinding> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of RoleBindings
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.RoleBinding> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RoleBindingList is a collection of RoleBindings<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RoleBindingList is a collection of RoleBindings<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RoleBindingRestriction.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RoleBindingRestriction.java
index 6791c100acf..d3cf071319c 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RoleBindingRestriction.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RoleBindingRestriction.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RoleBindingRestriction is an object that can be matched against a subject (user, group, or service account) to determine whether rolebindings on that subject are allowed in the namespace to which the RoleBindingRestriction belongs.  If any one of those RoleBindingRestriction objects matches a subject, rolebindings on that subject in the namespace are allowed.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,14 +78,8 @@
 public class RoleBindingRestriction implements Editable<RoleBindingRestrictionBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authorization.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "RoleBindingRestriction";
     @JsonProperty("metadata")
@@ -107,7 +104,7 @@ public RoleBindingRestriction(String apiVersion, String kind, ObjectMeta metadat
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -115,7 +112,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -123,7 +120,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -131,28 +128,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RoleBindingRestriction is an object that can be matched against a subject (user, group, or service account) to determine whether rolebindings on that subject are allowed in the namespace to which the RoleBindingRestriction belongs.  If any one of those RoleBindingRestriction objects matches a subject, rolebindings on that subject in the namespace are allowed.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RoleBindingRestriction is an object that can be matched against a subject (user, group, or service account) to determine whether rolebindings on that subject are allowed in the namespace to which the RoleBindingRestriction belongs.  If any one of those RoleBindingRestriction objects matches a subject, rolebindings on that subject in the namespace are allowed.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * RoleBindingRestriction is an object that can be matched against a subject (user, group, or service account) to determine whether rolebindings on that subject are allowed in the namespace to which the RoleBindingRestriction belongs.  If any one of those RoleBindingRestriction objects matches a subject, rolebindings on that subject in the namespace are allowed.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public RoleBindingRestrictionSpec getSpec() {
         return spec;
     }
 
+    /**
+     * RoleBindingRestriction is an object that can be matched against a subject (user, group, or service account) to determine whether rolebindings on that subject are allowed in the namespace to which the RoleBindingRestriction belongs.  If any one of those RoleBindingRestriction objects matches a subject, rolebindings on that subject in the namespace are allowed.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(RoleBindingRestrictionSpec spec) {
         this.spec = spec;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RoleBindingRestrictionList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RoleBindingRestrictionList.java
index 220529aed14..66691352d41 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RoleBindingRestrictionList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RoleBindingRestrictionList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RoleBindingRestrictionList is a collection of RoleBindingRestriction objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class RoleBindingRestrictionList implements Editable<RoleBindingRestrictionListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.RoleBindingRestriction>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authorization.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.RoleBindingRestriction> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "RoleBindingRestrictionList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public RoleBindingRestrictionList(String apiVersion, List<io.fabric8.openshift.a
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of RoleBindingRestriction objects.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.RoleBindingRestriction> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of RoleBindingRestriction objects.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.RoleBindingRestriction> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RoleBindingRestrictionList is a collection of RoleBindingRestriction objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RoleBindingRestrictionList is a collection of RoleBindingRestriction objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RoleBindingRestrictionSpec.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RoleBindingRestrictionSpec.java
index fe061f86aee..11c9e522636 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RoleBindingRestrictionSpec.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RoleBindingRestrictionSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RoleBindingRestrictionSpec defines a rolebinding restriction.  Exactly one field must be non-nil.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public RoleBindingRestrictionSpec(GroupRestriction grouprestriction, ServiceAcco
         this.userrestriction = userrestriction;
     }
 
+    /**
+     * RoleBindingRestrictionSpec defines a rolebinding restriction.  Exactly one field must be non-nil.
+     */
     @JsonProperty("grouprestriction")
     public GroupRestriction getGrouprestriction() {
         return grouprestriction;
     }
 
+    /**
+     * RoleBindingRestrictionSpec defines a rolebinding restriction.  Exactly one field must be non-nil.
+     */
     @JsonProperty("grouprestriction")
     public void setGrouprestriction(GroupRestriction grouprestriction) {
         this.grouprestriction = grouprestriction;
     }
 
+    /**
+     * RoleBindingRestrictionSpec defines a rolebinding restriction.  Exactly one field must be non-nil.
+     */
     @JsonProperty("serviceaccountrestriction")
     public ServiceAccountRestriction getServiceaccountrestriction() {
         return serviceaccountrestriction;
     }
 
+    /**
+     * RoleBindingRestrictionSpec defines a rolebinding restriction.  Exactly one field must be non-nil.
+     */
     @JsonProperty("serviceaccountrestriction")
     public void setServiceaccountrestriction(ServiceAccountRestriction serviceaccountrestriction) {
         this.serviceaccountrestriction = serviceaccountrestriction;
     }
 
+    /**
+     * RoleBindingRestrictionSpec defines a rolebinding restriction.  Exactly one field must be non-nil.
+     */
     @JsonProperty("userrestriction")
     public UserRestriction getUserrestriction() {
         return userrestriction;
     }
 
+    /**
+     * RoleBindingRestrictionSpec defines a rolebinding restriction.  Exactly one field must be non-nil.
+     */
     @JsonProperty("userrestriction")
     public void setUserrestriction(UserRestriction userrestriction) {
         this.userrestriction = userrestriction;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RoleList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RoleList.java
index 9c1b81bcf91..e83ac0ecc9a 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RoleList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RoleList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RoleList is a collection of Roles<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class RoleList implements Editable<RoleListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.Role>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authorization.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.Role> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "RoleList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public RoleList(String apiVersion, List<io.fabric8.openshift.api.model.Role> ite
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of Roles
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.Role> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of Roles
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.Role> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RoleList is a collection of Roles<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RoleList is a collection of Roles<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RollingDeploymentStrategyParams.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RollingDeploymentStrategyParams.java
index 721caedc063..d2f6b632d0c 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RollingDeploymentStrategyParams.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RollingDeploymentStrategyParams.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RollingDeploymentStrategyParams are the input to the Rolling deployment strategy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,71 +105,113 @@ public RollingDeploymentStrategyParams(Long intervalSeconds, IntOrString maxSurg
         this.updatePeriodSeconds = updatePeriodSeconds;
     }
 
+    /**
+     * IntervalSeconds is the time to wait between polling deployment status after update. If the value is nil, a default will be used.
+     */
     @JsonProperty("intervalSeconds")
     public Long getIntervalSeconds() {
         return intervalSeconds;
     }
 
+    /**
+     * IntervalSeconds is the time to wait between polling deployment status after update. If the value is nil, a default will be used.
+     */
     @JsonProperty("intervalSeconds")
     public void setIntervalSeconds(Long intervalSeconds) {
         this.intervalSeconds = intervalSeconds;
     }
 
+    /**
+     * RollingDeploymentStrategyParams are the input to the Rolling deployment strategy.
+     */
     @JsonProperty("maxSurge")
     public IntOrString getMaxSurge() {
         return maxSurge;
     }
 
+    /**
+     * RollingDeploymentStrategyParams are the input to the Rolling deployment strategy.
+     */
     @JsonProperty("maxSurge")
     public void setMaxSurge(IntOrString maxSurge) {
         this.maxSurge = maxSurge;
     }
 
+    /**
+     * RollingDeploymentStrategyParams are the input to the Rolling deployment strategy.
+     */
     @JsonProperty("maxUnavailable")
     public IntOrString getMaxUnavailable() {
         return maxUnavailable;
     }
 
+    /**
+     * RollingDeploymentStrategyParams are the input to the Rolling deployment strategy.
+     */
     @JsonProperty("maxUnavailable")
     public void setMaxUnavailable(IntOrString maxUnavailable) {
         this.maxUnavailable = maxUnavailable;
     }
 
+    /**
+     * RollingDeploymentStrategyParams are the input to the Rolling deployment strategy.
+     */
     @JsonProperty("post")
     public LifecycleHook getPost() {
         return post;
     }
 
+    /**
+     * RollingDeploymentStrategyParams are the input to the Rolling deployment strategy.
+     */
     @JsonProperty("post")
     public void setPost(LifecycleHook post) {
         this.post = post;
     }
 
+    /**
+     * RollingDeploymentStrategyParams are the input to the Rolling deployment strategy.
+     */
     @JsonProperty("pre")
     public LifecycleHook getPre() {
         return pre;
     }
 
+    /**
+     * RollingDeploymentStrategyParams are the input to the Rolling deployment strategy.
+     */
     @JsonProperty("pre")
     public void setPre(LifecycleHook pre) {
         this.pre = pre;
     }
 
+    /**
+     * TimeoutSeconds is the time to wait for updates before giving up. If the value is nil, a default will be used.
+     */
     @JsonProperty("timeoutSeconds")
     public Long getTimeoutSeconds() {
         return timeoutSeconds;
     }
 
+    /**
+     * TimeoutSeconds is the time to wait for updates before giving up. If the value is nil, a default will be used.
+     */
     @JsonProperty("timeoutSeconds")
     public void setTimeoutSeconds(Long timeoutSeconds) {
         this.timeoutSeconds = timeoutSeconds;
     }
 
+    /**
+     * UpdatePeriodSeconds is the time to wait between individual pod updates. If the value is nil, a default will be used.
+     */
     @JsonProperty("updatePeriodSeconds")
     public Long getUpdatePeriodSeconds() {
         return updatePeriodSeconds;
     }
 
+    /**
+     * UpdatePeriodSeconds is the time to wait between individual pod updates. If the value is nil, a default will be used.
+     */
     @JsonProperty("updatePeriodSeconds")
     public void setUpdatePeriodSeconds(Long updatePeriodSeconds) {
         this.updatePeriodSeconds = updatePeriodSeconds;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Route.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Route.java
index 6c24f843577..7d51c90c746 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Route.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Route.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * A route allows developers to expose services through an HTTP(S) aware load balancing and proxy layer via a public DNS entry. The route may further specify TLS options and a certificate, or specify a public CNAME that the router should also accept for HTTP and HTTPS traffic. An administrator typically configures their router to be visible outside the cluster firewall, and may also add additional security, caching, or traffic controls on the service content. Routers usually talk directly to the service endpoints.<br><p> <br><p> Once a route is created, the `host` field may not be changed. Generally, routers use the oldest route with a given host when resolving conflicts.<br><p> <br><p> Routers are subject to additional customization and may support additional controls via the annotations field.<br><p> <br><p> Because administrators may configure multiple routers, the route status field is used to return information to clients about the names and states of the route under each router. If a client chooses a duplicate name, for instance, the route status conditions are used to indicate the route cannot be chosen.<br><p> <br><p> To enable HTTP/2 ALPN on a route it requires a custom (non-wildcard) certificate. This prevents connection coalescing by clients, notably web browsers. We do not support HTTP/2 ALPN on routes that use the default certificate because of the risk of connection re-use/coalescing. Routes that do not have their own custom certificate will not be HTTP/2 ALPN-enabled on either the frontend or the backend.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class Route implements Editable<RouteBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "route.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Route";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public Route(String apiVersion, String kind, ObjectMeta metadata, RouteSpec spec
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * A route allows developers to expose services through an HTTP(S) aware load balancing and proxy layer via a public DNS entry. The route may further specify TLS options and a certificate, or specify a public CNAME that the router should also accept for HTTP and HTTPS traffic. An administrator typically configures their router to be visible outside the cluster firewall, and may also add additional security, caching, or traffic controls on the service content. Routers usually talk directly to the service endpoints.<br><p> <br><p> Once a route is created, the `host` field may not be changed. Generally, routers use the oldest route with a given host when resolving conflicts.<br><p> <br><p> Routers are subject to additional customization and may support additional controls via the annotations field.<br><p> <br><p> Because administrators may configure multiple routers, the route status field is used to return information to clients about the names and states of the route under each router. If a client chooses a duplicate name, for instance, the route status conditions are used to indicate the route cannot be chosen.<br><p> <br><p> To enable HTTP/2 ALPN on a route it requires a custom (non-wildcard) certificate. This prevents connection coalescing by clients, notably web browsers. We do not support HTTP/2 ALPN on routes that use the default certificate because of the risk of connection re-use/coalescing. Routes that do not have their own custom certificate will not be HTTP/2 ALPN-enabled on either the frontend or the backend.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * A route allows developers to expose services through an HTTP(S) aware load balancing and proxy layer via a public DNS entry. The route may further specify TLS options and a certificate, or specify a public CNAME that the router should also accept for HTTP and HTTPS traffic. An administrator typically configures their router to be visible outside the cluster firewall, and may also add additional security, caching, or traffic controls on the service content. Routers usually talk directly to the service endpoints.<br><p> <br><p> Once a route is created, the `host` field may not be changed. Generally, routers use the oldest route with a given host when resolving conflicts.<br><p> <br><p> Routers are subject to additional customization and may support additional controls via the annotations field.<br><p> <br><p> Because administrators may configure multiple routers, the route status field is used to return information to clients about the names and states of the route under each router. If a client chooses a duplicate name, for instance, the route status conditions are used to indicate the route cannot be chosen.<br><p> <br><p> To enable HTTP/2 ALPN on a route it requires a custom (non-wildcard) certificate. This prevents connection coalescing by clients, notably web browsers. We do not support HTTP/2 ALPN on routes that use the default certificate because of the risk of connection re-use/coalescing. Routes that do not have their own custom certificate will not be HTTP/2 ALPN-enabled on either the frontend or the backend.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * A route allows developers to expose services through an HTTP(S) aware load balancing and proxy layer via a public DNS entry. The route may further specify TLS options and a certificate, or specify a public CNAME that the router should also accept for HTTP and HTTPS traffic. An administrator typically configures their router to be visible outside the cluster firewall, and may also add additional security, caching, or traffic controls on the service content. Routers usually talk directly to the service endpoints.<br><p> <br><p> Once a route is created, the `host` field may not be changed. Generally, routers use the oldest route with a given host when resolving conflicts.<br><p> <br><p> Routers are subject to additional customization and may support additional controls via the annotations field.<br><p> <br><p> Because administrators may configure multiple routers, the route status field is used to return information to clients about the names and states of the route under each router. If a client chooses a duplicate name, for instance, the route status conditions are used to indicate the route cannot be chosen.<br><p> <br><p> To enable HTTP/2 ALPN on a route it requires a custom (non-wildcard) certificate. This prevents connection coalescing by clients, notably web browsers. We do not support HTTP/2 ALPN on routes that use the default certificate because of the risk of connection re-use/coalescing. Routes that do not have their own custom certificate will not be HTTP/2 ALPN-enabled on either the frontend or the backend.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public RouteSpec getSpec() {
         return spec;
     }
 
+    /**
+     * A route allows developers to expose services through an HTTP(S) aware load balancing and proxy layer via a public DNS entry. The route may further specify TLS options and a certificate, or specify a public CNAME that the router should also accept for HTTP and HTTPS traffic. An administrator typically configures their router to be visible outside the cluster firewall, and may also add additional security, caching, or traffic controls on the service content. Routers usually talk directly to the service endpoints.<br><p> <br><p> Once a route is created, the `host` field may not be changed. Generally, routers use the oldest route with a given host when resolving conflicts.<br><p> <br><p> Routers are subject to additional customization and may support additional controls via the annotations field.<br><p> <br><p> Because administrators may configure multiple routers, the route status field is used to return information to clients about the names and states of the route under each router. If a client chooses a duplicate name, for instance, the route status conditions are used to indicate the route cannot be chosen.<br><p> <br><p> To enable HTTP/2 ALPN on a route it requires a custom (non-wildcard) certificate. This prevents connection coalescing by clients, notably web browsers. We do not support HTTP/2 ALPN on routes that use the default certificate because of the risk of connection re-use/coalescing. Routes that do not have their own custom certificate will not be HTTP/2 ALPN-enabled on either the frontend or the backend.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(RouteSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * A route allows developers to expose services through an HTTP(S) aware load balancing and proxy layer via a public DNS entry. The route may further specify TLS options and a certificate, or specify a public CNAME that the router should also accept for HTTP and HTTPS traffic. An administrator typically configures their router to be visible outside the cluster firewall, and may also add additional security, caching, or traffic controls on the service content. Routers usually talk directly to the service endpoints.<br><p> <br><p> Once a route is created, the `host` field may not be changed. Generally, routers use the oldest route with a given host when resolving conflicts.<br><p> <br><p> Routers are subject to additional customization and may support additional controls via the annotations field.<br><p> <br><p> Because administrators may configure multiple routers, the route status field is used to return information to clients about the names and states of the route under each router. If a client chooses a duplicate name, for instance, the route status conditions are used to indicate the route cannot be chosen.<br><p> <br><p> To enable HTTP/2 ALPN on a route it requires a custom (non-wildcard) certificate. This prevents connection coalescing by clients, notably web browsers. We do not support HTTP/2 ALPN on routes that use the default certificate because of the risk of connection re-use/coalescing. Routes that do not have their own custom certificate will not be HTTP/2 ALPN-enabled on either the frontend or the backend.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public RouteStatus getStatus() {
         return status;
     }
 
+    /**
+     * A route allows developers to expose services through an HTTP(S) aware load balancing and proxy layer via a public DNS entry. The route may further specify TLS options and a certificate, or specify a public CNAME that the router should also accept for HTTP and HTTPS traffic. An administrator typically configures their router to be visible outside the cluster firewall, and may also add additional security, caching, or traffic controls on the service content. Routers usually talk directly to the service endpoints.<br><p> <br><p> Once a route is created, the `host` field may not be changed. Generally, routers use the oldest route with a given host when resolving conflicts.<br><p> <br><p> Routers are subject to additional customization and may support additional controls via the annotations field.<br><p> <br><p> Because administrators may configure multiple routers, the route status field is used to return information to clients about the names and states of the route under each router. If a client chooses a duplicate name, for instance, the route status conditions are used to indicate the route cannot be chosen.<br><p> <br><p> To enable HTTP/2 ALPN on a route it requires a custom (non-wildcard) certificate. This prevents connection coalescing by clients, notably web browsers. We do not support HTTP/2 ALPN on routes that use the default certificate because of the risk of connection re-use/coalescing. Routes that do not have their own custom certificate will not be HTTP/2 ALPN-enabled on either the frontend or the backend.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(RouteStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteHTTPHeader.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteHTTPHeader.java
index 551a88a5eb4..4dbf871770b 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteHTTPHeader.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteHTTPHeader.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RouteHTTPHeader specifies configuration for setting or deleting an HTTP header.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public RouteHTTPHeader(RouteHTTPHeaderActionUnion action, String name) {
         this.name = name;
     }
 
+    /**
+     * RouteHTTPHeader specifies configuration for setting or deleting an HTTP header.
+     */
     @JsonProperty("action")
     public RouteHTTPHeaderActionUnion getAction() {
         return action;
     }
 
+    /**
+     * RouteHTTPHeader specifies configuration for setting or deleting an HTTP header.
+     */
     @JsonProperty("action")
     public void setAction(RouteHTTPHeaderActionUnion action) {
         this.action = action;
     }
 
+    /**
+     * name specifies the name of a header on which to perform an action. Its value must be a valid HTTP header name as defined in RFC 2616 section 4.2. The name must consist only of alphanumeric and the following special characters, "-!#$%&amp;'&#42;+.^_`". The following header names are reserved and may not be modified via this API: Strict-Transport-Security, Proxy, Cookie, Set-Cookie. It must be no more than 255 characters in length. Header name must be unique.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name specifies the name of a header on which to perform an action. Its value must be a valid HTTP header name as defined in RFC 2616 section 4.2. The name must consist only of alphanumeric and the following special characters, "-!#$%&amp;'&#42;+.^_`". The following header names are reserved and may not be modified via this API: Strict-Transport-Security, Proxy, Cookie, Set-Cookie. It must be no more than 255 characters in length. Header name must be unique.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteHTTPHeaderActionUnion.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteHTTPHeaderActionUnion.java
index 035f94f315e..b37c2826236 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteHTTPHeaderActionUnion.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteHTTPHeaderActionUnion.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RouteHTTPHeaderActionUnion specifies an action to take on an HTTP header.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public RouteHTTPHeaderActionUnion(RouteSetHTTPHeader set, String type) {
         this.type = type;
     }
 
+    /**
+     * RouteHTTPHeaderActionUnion specifies an action to take on an HTTP header.
+     */
     @JsonProperty("set")
     public RouteSetHTTPHeader getSet() {
         return set;
     }
 
+    /**
+     * RouteHTTPHeaderActionUnion specifies an action to take on an HTTP header.
+     */
     @JsonProperty("set")
     public void setSet(RouteSetHTTPHeader set) {
         this.set = set;
     }
 
+    /**
+     * type defines the type of the action to be applied on the header. Possible values are Set or Delete. Set allows you to set HTTP request and response headers. Delete allows you to delete HTTP request and response headers.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type defines the type of the action to be applied on the header. Possible values are Set or Delete. Set allows you to set HTTP request and response headers. Delete allows you to delete HTTP request and response headers.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteHTTPHeaderActions.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteHTTPHeaderActions.java
index 780c16e31d5..15c9ef80566 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteHTTPHeaderActions.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteHTTPHeaderActions.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RouteHTTPHeaderActions defines configuration for actions on HTTP request and response headers.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public RouteHTTPHeaderActions(List<RouteHTTPHeader> request, List<RouteHTTPHeade
         this.response = response;
     }
 
+    /**
+     * request is a list of HTTP request headers to modify. Currently, actions may define to either `Set` or `Delete` headers values. Actions defined here will modify the request headers of all requests made through a route. These actions are applied to a specific Route defined within a cluster i.e. connections made through a route. Currently, actions may define to either `Set` or `Delete` headers values. Route actions will be executed after IngressController actions for request headers. Actions are applied in sequence as defined in this list. A maximum of 20 request header actions may be configured. You can use this field to specify HTTP request headers that should be set or deleted when forwarding connections from the client to your application. Sample fetchers allowed are "req.hdr" and "ssl_c_der". Converters allowed are "lower" and "base64". Example header values: "%[req.hdr(X-target),lower]", "%{+Q}[ssl_c_der,base64]". Any request header configuration applied directly via a Route resource using this API will override header configuration for a header of the same name applied via spec.httpHeaders.actions on the IngressController or route annotation. Note: This field cannot be used if your route uses TLS passthrough.
+     */
     @JsonProperty("request")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RouteHTTPHeader> getRequest() {
         return request;
     }
 
+    /**
+     * request is a list of HTTP request headers to modify. Currently, actions may define to either `Set` or `Delete` headers values. Actions defined here will modify the request headers of all requests made through a route. These actions are applied to a specific Route defined within a cluster i.e. connections made through a route. Currently, actions may define to either `Set` or `Delete` headers values. Route actions will be executed after IngressController actions for request headers. Actions are applied in sequence as defined in this list. A maximum of 20 request header actions may be configured. You can use this field to specify HTTP request headers that should be set or deleted when forwarding connections from the client to your application. Sample fetchers allowed are "req.hdr" and "ssl_c_der". Converters allowed are "lower" and "base64". Example header values: "%[req.hdr(X-target),lower]", "%{+Q}[ssl_c_der,base64]". Any request header configuration applied directly via a Route resource using this API will override header configuration for a header of the same name applied via spec.httpHeaders.actions on the IngressController or route annotation. Note: This field cannot be used if your route uses TLS passthrough.
+     */
     @JsonProperty("request")
     public void setRequest(List<RouteHTTPHeader> request) {
         this.request = request;
     }
 
+    /**
+     * response is a list of HTTP response headers to modify. Currently, actions may define to either `Set` or `Delete` headers values. Actions defined here will modify the response headers of all requests made through a route. These actions are applied to a specific Route defined within a cluster i.e. connections made through a route. Route actions will be executed before IngressController actions for response headers. Actions are applied in sequence as defined in this list. A maximum of 20 response header actions may be configured. You can use this field to specify HTTP response headers that should be set or deleted when forwarding responses from your application to the client. Sample fetchers allowed are "res.hdr" and "ssl_c_der". Converters allowed are "lower" and "base64". Example header values: "%[res.hdr(X-target),lower]", "%{+Q}[ssl_c_der,base64]". Note: This field cannot be used if your route uses TLS passthrough.
+     */
     @JsonProperty("response")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RouteHTTPHeader> getResponse() {
         return response;
     }
 
+    /**
+     * response is a list of HTTP response headers to modify. Currently, actions may define to either `Set` or `Delete` headers values. Actions defined here will modify the response headers of all requests made through a route. These actions are applied to a specific Route defined within a cluster i.e. connections made through a route. Route actions will be executed before IngressController actions for response headers. Actions are applied in sequence as defined in this list. A maximum of 20 response header actions may be configured. You can use this field to specify HTTP response headers that should be set or deleted when forwarding responses from your application to the client. Sample fetchers allowed are "res.hdr" and "ssl_c_der". Converters allowed are "lower" and "base64". Example header values: "%[res.hdr(X-target),lower]", "%{+Q}[ssl_c_der,base64]". Note: This field cannot be used if your route uses TLS passthrough.
+     */
     @JsonProperty("response")
     public void setResponse(List<RouteHTTPHeader> response) {
         this.response = response;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteHTTPHeaders.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteHTTPHeaders.java
index fdda6184e00..640aa0781cb 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteHTTPHeaders.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteHTTPHeaders.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RouteHTTPHeaders defines policy for HTTP headers.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public RouteHTTPHeaders(RouteHTTPHeaderActions actions) {
         this.actions = actions;
     }
 
+    /**
+     * RouteHTTPHeaders defines policy for HTTP headers.
+     */
     @JsonProperty("actions")
     public RouteHTTPHeaderActions getActions() {
         return actions;
     }
 
+    /**
+     * RouteHTTPHeaders defines policy for HTTP headers.
+     */
     @JsonProperty("actions")
     public void setActions(RouteHTTPHeaderActions actions) {
         this.actions = actions;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteIngress.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteIngress.java
index e0d82f41151..03aceb7db45 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteIngress.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteIngress.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RouteIngress holds information about the places where a route is exposed.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -97,52 +100,82 @@ public RouteIngress(List<RouteIngressCondition> conditions, String host, String
         this.wildcardPolicy = wildcardPolicy;
     }
 
+    /**
+     * Conditions is the state of the route, may be empty.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RouteIngressCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * Conditions is the state of the route, may be empty.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<RouteIngressCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Host is the host string under which the route is exposed; this value is required
+     */
     @JsonProperty("host")
     public String getHost() {
         return host;
     }
 
+    /**
+     * Host is the host string under which the route is exposed; this value is required
+     */
     @JsonProperty("host")
     public void setHost(String host) {
         this.host = host;
     }
 
+    /**
+     * CanonicalHostname is the external host name for the router that can be used as a CNAME for the host requested for this route. This value is optional and may not be set in all cases.
+     */
     @JsonProperty("routerCanonicalHostname")
     public String getRouterCanonicalHostname() {
         return routerCanonicalHostname;
     }
 
+    /**
+     * CanonicalHostname is the external host name for the router that can be used as a CNAME for the host requested for this route. This value is optional and may not be set in all cases.
+     */
     @JsonProperty("routerCanonicalHostname")
     public void setRouterCanonicalHostname(String routerCanonicalHostname) {
         this.routerCanonicalHostname = routerCanonicalHostname;
     }
 
+    /**
+     * Name is a name chosen by the router to identify itself; this value is required
+     */
     @JsonProperty("routerName")
     public String getRouterName() {
         return routerName;
     }
 
+    /**
+     * Name is a name chosen by the router to identify itself; this value is required
+     */
     @JsonProperty("routerName")
     public void setRouterName(String routerName) {
         this.routerName = routerName;
     }
 
+    /**
+     * Wildcard policy is the wildcard policy that was allowed where this route is exposed.
+     */
     @JsonProperty("wildcardPolicy")
     public String getWildcardPolicy() {
         return wildcardPolicy;
     }
 
+    /**
+     * Wildcard policy is the wildcard policy that was allowed where this route is exposed.
+     */
     @JsonProperty("wildcardPolicy")
     public void setWildcardPolicy(String wildcardPolicy) {
         this.wildcardPolicy = wildcardPolicy;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteIngressCondition.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteIngressCondition.java
index e84faa28cc4..a86cbeb3899 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteIngressCondition.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteIngressCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RouteIngressCondition contains details for the current condition of this route on a particular router.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public RouteIngressCondition(String lastTransitionTime, String message, String r
         this.type = type;
     }
 
+    /**
+     * RouteIngressCondition contains details for the current condition of this route on a particular router.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * RouteIngressCondition contains details for the current condition of this route on a particular router.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Human readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Human readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * (brief) reason for the condition's last transition, and is usually a machine and human readable constant
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * (brief) reason for the condition's last transition, and is usually a machine and human readable constant
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status is the status of the condition. Can be True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status is the status of the condition. Can be True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type is the type of the condition. Currently only Admitted or UnservableInFutureVersions.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the type of the condition. Currently only Admitted or UnservableInFutureVersions.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteList.java
index 69449b80042..1008d178b9d 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RouteList is a collection of Routes.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class RouteList implements Editable<RouteListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.Route>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "route.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.Route> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "RouteList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public RouteList(String apiVersion, List<io.fabric8.openshift.api.model.Route> i
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is a list of routes
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.Route> getItems() {
         return items;
     }
 
+    /**
+     * items is a list of routes
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.Route> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * RouteList is a collection of Routes.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * RouteList is a collection of Routes.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RoutePort.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RoutePort.java
index 6777cb0010e..e07c84c28cc 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RoutePort.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RoutePort.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RoutePort defines a port mapping from a router to an endpoint in the service endpoints.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public RoutePort(IntOrString targetPort) {
         this.targetPort = targetPort;
     }
 
+    /**
+     * RoutePort defines a port mapping from a router to an endpoint in the service endpoints.
+     */
     @JsonProperty("targetPort")
     public IntOrString getTargetPort() {
         return targetPort;
     }
 
+    /**
+     * RoutePort defines a port mapping from a router to an endpoint in the service endpoints.
+     */
     @JsonProperty("targetPort")
     public void setTargetPort(IntOrString targetPort) {
         this.targetPort = targetPort;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteSetHTTPHeader.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteSetHTTPHeader.java
index 7b42aad0730..61accef88e9 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteSetHTTPHeader.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteSetHTTPHeader.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RouteSetHTTPHeader specifies what value needs to be set on an HTTP header.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public RouteSetHTTPHeader(String value) {
         this.value = value;
     }
 
+    /**
+     * value specifies a header value. Dynamic values can be added. The value will be interpreted as an HAProxy format string as defined in http://cbonte.github.io/haproxy-dconv/2.6/configuration.html#8.2.6 and may use HAProxy's %[] syntax and otherwise must be a valid HTTP header value as defined in https://datatracker.ietf.org/doc/html/rfc7230#section-3.2. The value of this field must be no more than 16384 characters in length. Note that the total size of all net added headers &#42;after&#42; interpolating dynamic values must not exceed the value of spec.tuningOptions.headerBufferMaxRewriteBytes on the IngressController.
+     */
     @JsonProperty("value")
     public String getValue() {
         return value;
     }
 
+    /**
+     * value specifies a header value. Dynamic values can be added. The value will be interpreted as an HAProxy format string as defined in http://cbonte.github.io/haproxy-dconv/2.6/configuration.html#8.2.6 and may use HAProxy's %[] syntax and otherwise must be a valid HTTP header value as defined in https://datatracker.ietf.org/doc/html/rfc7230#section-3.2. The value of this field must be no more than 16384 characters in length. Note that the total size of all net added headers &#42;after&#42; interpolating dynamic values must not exceed the value of spec.tuningOptions.headerBufferMaxRewriteBytes on the IngressController.
+     */
     @JsonProperty("value")
     public void setValue(String value) {
         this.value = value;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteSpec.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteSpec.java
index 1133bdc7606..a6c0721af81 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteSpec.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RouteSpec describes the hostname or path the route exposes, any security information, and one to four backends (services) the route points to. Requests are distributed among the backends depending on the weights assigned to each backend. When using roundrobin scheduling the portion of requests that go to each backend is the backend weight divided by the sum of all of the backend weights. When the backend has more than one endpoint the requests that end up on the backend are roundrobin distributed among the endpoints. Weights are between 0 and 256 with default 100. Weight 0 causes no requests to the backend. If all weights are zero the route will be considered to have no backends and return a standard 503 response.<br><p> <br><p> The `tls` field is optional and allows specific certificates or behavior for the route. Routers typically configure a default certificate on a wildcard domain to terminate routes without explicit certificates, but custom hostnames usually must choose passthrough (send traffic directly to the backend via the TLS Server-Name- Indication field) or provide a certificate.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -113,92 +116,146 @@ public RouteSpec(List<RouteTargetReference> alternateBackends, String host, Rout
         this.wildcardPolicy = wildcardPolicy;
     }
 
+    /**
+     * alternateBackends allows up to 3 additional backends to be assigned to the route. Only the Service kind is allowed, and it will be defaulted to Service. Use the weight field in RouteTargetReference object to specify relative preference.
+     */
     @JsonProperty("alternateBackends")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RouteTargetReference> getAlternateBackends() {
         return alternateBackends;
     }
 
+    /**
+     * alternateBackends allows up to 3 additional backends to be assigned to the route. Only the Service kind is allowed, and it will be defaulted to Service. Use the weight field in RouteTargetReference object to specify relative preference.
+     */
     @JsonProperty("alternateBackends")
     public void setAlternateBackends(List<RouteTargetReference> alternateBackends) {
         this.alternateBackends = alternateBackends;
     }
 
+    /**
+     * host is an alias/DNS that points to the service. Optional. If not specified a route name will typically be automatically chosen. Must follow DNS952 subdomain conventions.
+     */
     @JsonProperty("host")
     public String getHost() {
         return host;
     }
 
+    /**
+     * host is an alias/DNS that points to the service. Optional. If not specified a route name will typically be automatically chosen. Must follow DNS952 subdomain conventions.
+     */
     @JsonProperty("host")
     public void setHost(String host) {
         this.host = host;
     }
 
+    /**
+     * RouteSpec describes the hostname or path the route exposes, any security information, and one to four backends (services) the route points to. Requests are distributed among the backends depending on the weights assigned to each backend. When using roundrobin scheduling the portion of requests that go to each backend is the backend weight divided by the sum of all of the backend weights. When the backend has more than one endpoint the requests that end up on the backend are roundrobin distributed among the endpoints. Weights are between 0 and 256 with default 100. Weight 0 causes no requests to the backend. If all weights are zero the route will be considered to have no backends and return a standard 503 response.<br><p> <br><p> The `tls` field is optional and allows specific certificates or behavior for the route. Routers typically configure a default certificate on a wildcard domain to terminate routes without explicit certificates, but custom hostnames usually must choose passthrough (send traffic directly to the backend via the TLS Server-Name- Indication field) or provide a certificate.
+     */
     @JsonProperty("httpHeaders")
     public RouteHTTPHeaders getHttpHeaders() {
         return httpHeaders;
     }
 
+    /**
+     * RouteSpec describes the hostname or path the route exposes, any security information, and one to four backends (services) the route points to. Requests are distributed among the backends depending on the weights assigned to each backend. When using roundrobin scheduling the portion of requests that go to each backend is the backend weight divided by the sum of all of the backend weights. When the backend has more than one endpoint the requests that end up on the backend are roundrobin distributed among the endpoints. Weights are between 0 and 256 with default 100. Weight 0 causes no requests to the backend. If all weights are zero the route will be considered to have no backends and return a standard 503 response.<br><p> <br><p> The `tls` field is optional and allows specific certificates or behavior for the route. Routers typically configure a default certificate on a wildcard domain to terminate routes without explicit certificates, but custom hostnames usually must choose passthrough (send traffic directly to the backend via the TLS Server-Name- Indication field) or provide a certificate.
+     */
     @JsonProperty("httpHeaders")
     public void setHttpHeaders(RouteHTTPHeaders httpHeaders) {
         this.httpHeaders = httpHeaders;
     }
 
+    /**
+     * path that the router watches for, to route traffic for to the service. Optional
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * path that the router watches for, to route traffic for to the service. Optional
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * RouteSpec describes the hostname or path the route exposes, any security information, and one to four backends (services) the route points to. Requests are distributed among the backends depending on the weights assigned to each backend. When using roundrobin scheduling the portion of requests that go to each backend is the backend weight divided by the sum of all of the backend weights. When the backend has more than one endpoint the requests that end up on the backend are roundrobin distributed among the endpoints. Weights are between 0 and 256 with default 100. Weight 0 causes no requests to the backend. If all weights are zero the route will be considered to have no backends and return a standard 503 response.<br><p> <br><p> The `tls` field is optional and allows specific certificates or behavior for the route. Routers typically configure a default certificate on a wildcard domain to terminate routes without explicit certificates, but custom hostnames usually must choose passthrough (send traffic directly to the backend via the TLS Server-Name- Indication field) or provide a certificate.
+     */
     @JsonProperty("port")
     public RoutePort getPort() {
         return port;
     }
 
+    /**
+     * RouteSpec describes the hostname or path the route exposes, any security information, and one to four backends (services) the route points to. Requests are distributed among the backends depending on the weights assigned to each backend. When using roundrobin scheduling the portion of requests that go to each backend is the backend weight divided by the sum of all of the backend weights. When the backend has more than one endpoint the requests that end up on the backend are roundrobin distributed among the endpoints. Weights are between 0 and 256 with default 100. Weight 0 causes no requests to the backend. If all weights are zero the route will be considered to have no backends and return a standard 503 response.<br><p> <br><p> The `tls` field is optional and allows specific certificates or behavior for the route. Routers typically configure a default certificate on a wildcard domain to terminate routes without explicit certificates, but custom hostnames usually must choose passthrough (send traffic directly to the backend via the TLS Server-Name- Indication field) or provide a certificate.
+     */
     @JsonProperty("port")
     public void setPort(RoutePort port) {
         this.port = port;
     }
 
+    /**
+     * subdomain is a DNS subdomain that is requested within the ingress controller's domain (as a subdomain). If host is set this field is ignored. An ingress controller may choose to ignore this suggested name, in which case the controller will report the assigned name in the status.ingress array or refuse to admit the route. If this value is set and the server does not support this field host will be populated automatically. Otherwise host is left empty. The field may have multiple parts separated by a dot, but not all ingress controllers may honor the request. This field may not be changed after creation except by a user with the update routes/custom-host permission.<br><p> <br><p> Example: subdomain `frontend` automatically receives the router subdomain `apps.mycluster.com` to have a full hostname `frontend.apps.mycluster.com`.
+     */
     @JsonProperty("subdomain")
     public String getSubdomain() {
         return subdomain;
     }
 
+    /**
+     * subdomain is a DNS subdomain that is requested within the ingress controller's domain (as a subdomain). If host is set this field is ignored. An ingress controller may choose to ignore this suggested name, in which case the controller will report the assigned name in the status.ingress array or refuse to admit the route. If this value is set and the server does not support this field host will be populated automatically. Otherwise host is left empty. The field may have multiple parts separated by a dot, but not all ingress controllers may honor the request. This field may not be changed after creation except by a user with the update routes/custom-host permission.<br><p> <br><p> Example: subdomain `frontend` automatically receives the router subdomain `apps.mycluster.com` to have a full hostname `frontend.apps.mycluster.com`.
+     */
     @JsonProperty("subdomain")
     public void setSubdomain(String subdomain) {
         this.subdomain = subdomain;
     }
 
+    /**
+     * RouteSpec describes the hostname or path the route exposes, any security information, and one to four backends (services) the route points to. Requests are distributed among the backends depending on the weights assigned to each backend. When using roundrobin scheduling the portion of requests that go to each backend is the backend weight divided by the sum of all of the backend weights. When the backend has more than one endpoint the requests that end up on the backend are roundrobin distributed among the endpoints. Weights are between 0 and 256 with default 100. Weight 0 causes no requests to the backend. If all weights are zero the route will be considered to have no backends and return a standard 503 response.<br><p> <br><p> The `tls` field is optional and allows specific certificates or behavior for the route. Routers typically configure a default certificate on a wildcard domain to terminate routes without explicit certificates, but custom hostnames usually must choose passthrough (send traffic directly to the backend via the TLS Server-Name- Indication field) or provide a certificate.
+     */
     @JsonProperty("tls")
     public TLSConfig getTls() {
         return tls;
     }
 
+    /**
+     * RouteSpec describes the hostname or path the route exposes, any security information, and one to four backends (services) the route points to. Requests are distributed among the backends depending on the weights assigned to each backend. When using roundrobin scheduling the portion of requests that go to each backend is the backend weight divided by the sum of all of the backend weights. When the backend has more than one endpoint the requests that end up on the backend are roundrobin distributed among the endpoints. Weights are between 0 and 256 with default 100. Weight 0 causes no requests to the backend. If all weights are zero the route will be considered to have no backends and return a standard 503 response.<br><p> <br><p> The `tls` field is optional and allows specific certificates or behavior for the route. Routers typically configure a default certificate on a wildcard domain to terminate routes without explicit certificates, but custom hostnames usually must choose passthrough (send traffic directly to the backend via the TLS Server-Name- Indication field) or provide a certificate.
+     */
     @JsonProperty("tls")
     public void setTls(TLSConfig tls) {
         this.tls = tls;
     }
 
+    /**
+     * RouteSpec describes the hostname or path the route exposes, any security information, and one to four backends (services) the route points to. Requests are distributed among the backends depending on the weights assigned to each backend. When using roundrobin scheduling the portion of requests that go to each backend is the backend weight divided by the sum of all of the backend weights. When the backend has more than one endpoint the requests that end up on the backend are roundrobin distributed among the endpoints. Weights are between 0 and 256 with default 100. Weight 0 causes no requests to the backend. If all weights are zero the route will be considered to have no backends and return a standard 503 response.<br><p> <br><p> The `tls` field is optional and allows specific certificates or behavior for the route. Routers typically configure a default certificate on a wildcard domain to terminate routes without explicit certificates, but custom hostnames usually must choose passthrough (send traffic directly to the backend via the TLS Server-Name- Indication field) or provide a certificate.
+     */
     @JsonProperty("to")
     public RouteTargetReference getTo() {
         return to;
     }
 
+    /**
+     * RouteSpec describes the hostname or path the route exposes, any security information, and one to four backends (services) the route points to. Requests are distributed among the backends depending on the weights assigned to each backend. When using roundrobin scheduling the portion of requests that go to each backend is the backend weight divided by the sum of all of the backend weights. When the backend has more than one endpoint the requests that end up on the backend are roundrobin distributed among the endpoints. Weights are between 0 and 256 with default 100. Weight 0 causes no requests to the backend. If all weights are zero the route will be considered to have no backends and return a standard 503 response.<br><p> <br><p> The `tls` field is optional and allows specific certificates or behavior for the route. Routers typically configure a default certificate on a wildcard domain to terminate routes without explicit certificates, but custom hostnames usually must choose passthrough (send traffic directly to the backend via the TLS Server-Name- Indication field) or provide a certificate.
+     */
     @JsonProperty("to")
     public void setTo(RouteTargetReference to) {
         this.to = to;
     }
 
+    /**
+     * Wildcard policy if any for the route. Currently only 'Subdomain' or 'None' is allowed.
+     */
     @JsonProperty("wildcardPolicy")
     public String getWildcardPolicy() {
         return wildcardPolicy;
     }
 
+    /**
+     * Wildcard policy if any for the route. Currently only 'Subdomain' or 'None' is allowed.
+     */
     @JsonProperty("wildcardPolicy")
     public void setWildcardPolicy(String wildcardPolicy) {
         this.wildcardPolicy = wildcardPolicy;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteStatus.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteStatus.java
index bdad22e6127..7615c7a3f2c 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteStatus.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RouteStatus provides relevant info about the status of a route, including which routers acknowledge it.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public RouteStatus(List<RouteIngress> ingress) {
         this.ingress = ingress;
     }
 
+    /**
+     * ingress describes the places where the route may be exposed. The list of ingress points may contain duplicate Host or RouterName values. Routes are considered live once they are `Ready`
+     */
     @JsonProperty("ingress")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<RouteIngress> getIngress() {
         return ingress;
     }
 
+    /**
+     * ingress describes the places where the route may be exposed. The list of ingress points may contain duplicate Host or RouterName values. Routes are considered live once they are `Ready`
+     */
     @JsonProperty("ingress")
     public void setIngress(List<RouteIngress> ingress) {
         this.ingress = ingress;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteTargetReference.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteTargetReference.java
index ee2464d0b50..a61e65fbee8 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteTargetReference.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouteTargetReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RouteTargetReference specifies the target that resolve into endpoints. Only the 'Service' kind is allowed. Use 'weight' field to emphasize one over others.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public RouteTargetReference(String kind, String name, Integer weight) {
         this.weight = weight;
     }
 
+    /**
+     * The kind of target that the route is referring to. Currently, only 'Service' is allowed
+     */
     @JsonProperty("kind")
     public String getKind() {
         return kind;
     }
 
+    /**
+     * The kind of target that the route is referring to. Currently, only 'Service' is allowed
+     */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * name of the service/target that is being referred to. e.g. name of the service
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name of the service/target that is being referred to. e.g. name of the service
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * weight as an integer between 0 and 256, default 100, that specifies the target's relative weight against other target reference objects. 0 suppresses requests to this backend.
+     */
     @JsonProperty("weight")
     public Integer getWeight() {
         return weight;
     }
 
+    /**
+     * weight as an integer between 0 and 256, default 100, that specifies the target's relative weight against other target reference objects. 0 suppresses requests to this backend.
+     */
     @JsonProperty("weight")
     public void setWeight(Integer weight) {
         this.weight = weight;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouterShard.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouterShard.java
index e8aba556751..0e5c63a9415 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouterShard.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RouterShard.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RouterShard has information of a routing shard and is used to generate host names and routing table entries when a routing shard is allocated for a specific route. Caveat: This is WIP and will likely undergo modifications when sharding support is added.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public RouterShard(String dnsSuffix, String shardName) {
         this.shardName = shardName;
     }
 
+    /**
+     * dnsSuffix for the shard ala: shard-1.v3.openshift.com
+     */
     @JsonProperty("dnsSuffix")
     public String getDnsSuffix() {
         return dnsSuffix;
     }
 
+    /**
+     * dnsSuffix for the shard ala: shard-1.v3.openshift.com
+     */
     @JsonProperty("dnsSuffix")
     public void setDnsSuffix(String dnsSuffix) {
         this.dnsSuffix = dnsSuffix;
     }
 
+    /**
+     * shardName uniquely identifies a router shard in the "set" of routers used for routing traffic to the services.
+     */
     @JsonProperty("shardName")
     public String getShardName() {
         return shardName;
     }
 
+    /**
+     * shardName uniquely identifies a router shard in the "set" of routers used for routing traffic to the services.
+     */
     @JsonProperty("shardName")
     public void setShardName(String shardName) {
         this.shardName = shardName;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RunAsUserStrategyOptions.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RunAsUserStrategyOptions.java
index 502efc62a60..0fd45df5782 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RunAsUserStrategyOptions.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/RunAsUserStrategyOptions.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * RunAsUserStrategyOptions defines the strategy type and any options used to create the strategy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public RunAsUserStrategyOptions(String type, Long uid, Long uidRangeMax, Long ui
         this.uidRangeMin = uidRangeMin;
     }
 
+    /**
+     * Type is the strategy that will dictate what RunAsUser is used in the SecurityContext.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the strategy that will dictate what RunAsUser is used in the SecurityContext.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
     }
 
+    /**
+     * UID is the user id that containers must run as.  Required for the MustRunAs strategy if not using namespace/service account allocated uids.
+     */
     @JsonProperty("uid")
     public Long getUid() {
         return uid;
     }
 
+    /**
+     * UID is the user id that containers must run as.  Required for the MustRunAs strategy if not using namespace/service account allocated uids.
+     */
     @JsonProperty("uid")
     public void setUid(Long uid) {
         this.uid = uid;
     }
 
+    /**
+     * UIDRangeMax defines the max value for a strategy that allocates by range.
+     */
     @JsonProperty("uidRangeMax")
     public Long getUidRangeMax() {
         return uidRangeMax;
     }
 
+    /**
+     * UIDRangeMax defines the max value for a strategy that allocates by range.
+     */
     @JsonProperty("uidRangeMax")
     public void setUidRangeMax(Long uidRangeMax) {
         this.uidRangeMax = uidRangeMax;
     }
 
+    /**
+     * UIDRangeMin defines the min value for a strategy that allocates by range.
+     */
     @JsonProperty("uidRangeMin")
     public Long getUidRangeMin() {
         return uidRangeMin;
     }
 
+    /**
+     * UIDRangeMin defines the min value for a strategy that allocates by range.
+     */
     @JsonProperty("uidRangeMin")
     public void setUidRangeMin(Long uidRangeMin) {
         this.uidRangeMin = uidRangeMin;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SELinuxContextStrategyOptions.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SELinuxContextStrategyOptions.java
index 7851b439f1d..47673102c72 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SELinuxContextStrategyOptions.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SELinuxContextStrategyOptions.java
@@ -33,6 +33,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SELinuxContextStrategyOptions defines the strategy type and any options used to create the strategy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -83,21 +86,33 @@ public SELinuxContextStrategyOptions(SELinuxOptions seLinuxOptions, String type)
         this.type = type;
     }
 
+    /**
+     * SELinuxContextStrategyOptions defines the strategy type and any options used to create the strategy.
+     */
     @JsonProperty("seLinuxOptions")
     public SELinuxOptions getSeLinuxOptions() {
         return seLinuxOptions;
     }
 
+    /**
+     * SELinuxContextStrategyOptions defines the strategy type and any options used to create the strategy.
+     */
     @JsonProperty("seLinuxOptions")
     public void setSeLinuxOptions(SELinuxOptions seLinuxOptions) {
         this.seLinuxOptions = seLinuxOptions;
     }
 
+    /**
+     * Type is the strategy that will dictate what SELinux context is used in the SecurityContext.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the strategy that will dictate what SELinux context is used in the SecurityContext.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ScopeRestriction.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ScopeRestriction.java
index 1d8a5900211..2ce0a697cba 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ScopeRestriction.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ScopeRestriction.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ScopeRestriction describe one restriction on scopes.  Exactly one option must be non-nil.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public ScopeRestriction(ClusterRoleScopeRestriction clusterRole, List<String> li
         this.literals = literals;
     }
 
+    /**
+     * ScopeRestriction describe one restriction on scopes.  Exactly one option must be non-nil.
+     */
     @JsonProperty("clusterRole")
     public ClusterRoleScopeRestriction getClusterRole() {
         return clusterRole;
     }
 
+    /**
+     * ScopeRestriction describe one restriction on scopes.  Exactly one option must be non-nil.
+     */
     @JsonProperty("clusterRole")
     public void setClusterRole(ClusterRoleScopeRestriction clusterRole) {
         this.clusterRole = clusterRole;
     }
 
+    /**
+     * ExactValues means the scope has to match a particular set of strings exactly
+     */
     @JsonProperty("literals")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getLiterals() {
         return literals;
     }
 
+    /**
+     * ExactValues means the scope has to match a particular set of strings exactly
+     */
     @JsonProperty("literals")
     public void setLiterals(List<String> literals) {
         this.literals = literals;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SecretBuildSource.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SecretBuildSource.java
index 6433efb7d36..e27e1e77656 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SecretBuildSource.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SecretBuildSource.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SecretBuildSource describes a secret and its destination directory that will be used only at the build time. The content of the secret referenced here will be copied into the destination directory instead of mounting.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public SecretBuildSource(String destinationDir, LocalObjectReference secret) {
         this.secret = secret;
     }
 
+    /**
+     * destinationDir is the directory where the files from the secret should be available for the build time. For the Source build strategy, these will be injected into a container where the assemble script runs. Later, when the script finishes, all files injected will be truncated to zero length. For the container image build strategy, these will be copied into the build directory, where the Dockerfile is located, so users can ADD or COPY them during container image build.
+     */
     @JsonProperty("destinationDir")
     public String getDestinationDir() {
         return destinationDir;
     }
 
+    /**
+     * destinationDir is the directory where the files from the secret should be available for the build time. For the Source build strategy, these will be injected into a container where the assemble script runs. Later, when the script finishes, all files injected will be truncated to zero length. For the container image build strategy, these will be copied into the build directory, where the Dockerfile is located, so users can ADD or COPY them during container image build.
+     */
     @JsonProperty("destinationDir")
     public void setDestinationDir(String destinationDir) {
         this.destinationDir = destinationDir;
     }
 
+    /**
+     * SecretBuildSource describes a secret and its destination directory that will be used only at the build time. The content of the secret referenced here will be copied into the destination directory instead of mounting.
+     */
     @JsonProperty("secret")
     public LocalObjectReference getSecret() {
         return secret;
     }
 
+    /**
+     * SecretBuildSource describes a secret and its destination directory that will be used only at the build time. The content of the secret referenced here will be copied into the destination directory instead of mounting.
+     */
     @JsonProperty("secret")
     public void setSecret(LocalObjectReference secret) {
         this.secret = secret;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SecretLocalReference.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SecretLocalReference.java
index 05881a17f4e..8383db209a0 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SecretLocalReference.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SecretLocalReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SecretLocalReference contains information that points to the local secret being used
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public SecretLocalReference(String name) {
         this.name = name;
     }
 
+    /**
+     * Name is the name of the resource in the same namespace being referenced
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the resource in the same namespace being referenced
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SecretSpec.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SecretSpec.java
index c1c3b9ee796..83f70d015e9 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SecretSpec.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SecretSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SecretSpec specifies a secret to be included in a build pod and its corresponding mount point
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public SecretSpec(String mountPath, LocalObjectReference secretSource) {
         this.secretSource = secretSource;
     }
 
+    /**
+     * mountPath is the path at which to mount the secret
+     */
     @JsonProperty("mountPath")
     public String getMountPath() {
         return mountPath;
     }
 
+    /**
+     * mountPath is the path at which to mount the secret
+     */
     @JsonProperty("mountPath")
     public void setMountPath(String mountPath) {
         this.mountPath = mountPath;
     }
 
+    /**
+     * SecretSpec specifies a secret to be included in a build pod and its corresponding mount point
+     */
     @JsonProperty("secretSource")
     public LocalObjectReference getSecretSource() {
         return secretSource;
     }
 
+    /**
+     * SecretSpec specifies a secret to be included in a build pod and its corresponding mount point
+     */
     @JsonProperty("secretSource")
     public void setSecretSource(LocalObjectReference secretSource) {
         this.secretSource = secretSource;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SecurityContextConstraints.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SecurityContextConstraints.java
index 2ef774b32de..503f022403d 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SecurityContextConstraints.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SecurityContextConstraints.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SecurityContextConstraints governs the ability to make requests that affect the SecurityContext that will be applied to a container. For historical reasons SCC was exposed under the core Kubernetes API group. That exposure is deprecated and will be removed in a future release - users should instead use the security.openshift.io group to manage SecurityContextConstraints.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -123,9 +126,6 @@ public class SecurityContextConstraints implements Editable<SecurityContextConst
     @JsonProperty("allowedUnsafeSysctls")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<String> allowedUnsafeSysctls = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "security.openshift.io/v1";
     @JsonProperty("defaultAddCapabilities")
@@ -141,9 +141,6 @@ public class SecurityContextConstraints implements Editable<SecurityContextConst
     @JsonProperty("groups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<String> groups = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SecurityContextConstraints";
     @JsonProperty("metadata")
@@ -213,111 +210,171 @@ public SecurityContextConstraints(Boolean allowHostDirVolumePlugin, Boolean allo
         this.volumes = volumes;
     }
 
+    /**
+     * AllowHostDirVolumePlugin determines if the policy allow containers to use the HostDir volume plugin
+     */
     @JsonProperty("allowHostDirVolumePlugin")
     public Boolean getAllowHostDirVolumePlugin() {
         return allowHostDirVolumePlugin;
     }
 
+    /**
+     * AllowHostDirVolumePlugin determines if the policy allow containers to use the HostDir volume plugin
+     */
     @JsonProperty("allowHostDirVolumePlugin")
     public void setAllowHostDirVolumePlugin(Boolean allowHostDirVolumePlugin) {
         this.allowHostDirVolumePlugin = allowHostDirVolumePlugin;
     }
 
+    /**
+     * AllowHostIPC determines if the policy allows host ipc in the containers.
+     */
     @JsonProperty("allowHostIPC")
     public Boolean getAllowHostIPC() {
         return allowHostIPC;
     }
 
+    /**
+     * AllowHostIPC determines if the policy allows host ipc in the containers.
+     */
     @JsonProperty("allowHostIPC")
     public void setAllowHostIPC(Boolean allowHostIPC) {
         this.allowHostIPC = allowHostIPC;
     }
 
+    /**
+     * AllowHostNetwork determines if the policy allows the use of HostNetwork in the pod spec.
+     */
     @JsonProperty("allowHostNetwork")
     public Boolean getAllowHostNetwork() {
         return allowHostNetwork;
     }
 
+    /**
+     * AllowHostNetwork determines if the policy allows the use of HostNetwork in the pod spec.
+     */
     @JsonProperty("allowHostNetwork")
     public void setAllowHostNetwork(Boolean allowHostNetwork) {
         this.allowHostNetwork = allowHostNetwork;
     }
 
+    /**
+     * AllowHostPID determines if the policy allows host pid in the containers.
+     */
     @JsonProperty("allowHostPID")
     public Boolean getAllowHostPID() {
         return allowHostPID;
     }
 
+    /**
+     * AllowHostPID determines if the policy allows host pid in the containers.
+     */
     @JsonProperty("allowHostPID")
     public void setAllowHostPID(Boolean allowHostPID) {
         this.allowHostPID = allowHostPID;
     }
 
+    /**
+     * AllowHostPorts determines if the policy allows host ports in the containers.
+     */
     @JsonProperty("allowHostPorts")
     public Boolean getAllowHostPorts() {
         return allowHostPorts;
     }
 
+    /**
+     * AllowHostPorts determines if the policy allows host ports in the containers.
+     */
     @JsonProperty("allowHostPorts")
     public void setAllowHostPorts(Boolean allowHostPorts) {
         this.allowHostPorts = allowHostPorts;
     }
 
+    /**
+     * AllowPrivilegeEscalation determines if a pod can request to allow privilege escalation. If unspecified, defaults to true.
+     */
     @JsonProperty("allowPrivilegeEscalation")
     public Boolean getAllowPrivilegeEscalation() {
         return allowPrivilegeEscalation;
     }
 
+    /**
+     * AllowPrivilegeEscalation determines if a pod can request to allow privilege escalation. If unspecified, defaults to true.
+     */
     @JsonProperty("allowPrivilegeEscalation")
     public void setAllowPrivilegeEscalation(Boolean allowPrivilegeEscalation) {
         this.allowPrivilegeEscalation = allowPrivilegeEscalation;
     }
 
+    /**
+     * AllowPrivilegedContainer determines if a container can request to be run as privileged.
+     */
     @JsonProperty("allowPrivilegedContainer")
     public Boolean getAllowPrivilegedContainer() {
         return allowPrivilegedContainer;
     }
 
+    /**
+     * AllowPrivilegedContainer determines if a container can request to be run as privileged.
+     */
     @JsonProperty("allowPrivilegedContainer")
     public void setAllowPrivilegedContainer(Boolean allowPrivilegedContainer) {
         this.allowPrivilegedContainer = allowPrivilegedContainer;
     }
 
+    /**
+     * AllowedCapabilities is a list of capabilities that can be requested to add to the container. Capabilities in this field maybe added at the pod author's discretion. You must not list a capability in both AllowedCapabilities and RequiredDropCapabilities. To allow all capabilities you may use '&#42;'.
+     */
     @JsonProperty("allowedCapabilities")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAllowedCapabilities() {
         return allowedCapabilities;
     }
 
+    /**
+     * AllowedCapabilities is a list of capabilities that can be requested to add to the container. Capabilities in this field maybe added at the pod author's discretion. You must not list a capability in both AllowedCapabilities and RequiredDropCapabilities. To allow all capabilities you may use '&#42;'.
+     */
     @JsonProperty("allowedCapabilities")
     public void setAllowedCapabilities(List<String> allowedCapabilities) {
         this.allowedCapabilities = allowedCapabilities;
     }
 
+    /**
+     * AllowedFlexVolumes is a whitelist of allowed Flexvolumes.  Empty or nil indicates that all Flexvolumes may be used.  This parameter is effective only when the usage of the Flexvolumes is allowed in the "Volumes" field.
+     */
     @JsonProperty("allowedFlexVolumes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<AllowedFlexVolume> getAllowedFlexVolumes() {
         return allowedFlexVolumes;
     }
 
+    /**
+     * AllowedFlexVolumes is a whitelist of allowed Flexvolumes.  Empty or nil indicates that all Flexvolumes may be used.  This parameter is effective only when the usage of the Flexvolumes is allowed in the "Volumes" field.
+     */
     @JsonProperty("allowedFlexVolumes")
     public void setAllowedFlexVolumes(List<AllowedFlexVolume> allowedFlexVolumes) {
         this.allowedFlexVolumes = allowedFlexVolumes;
     }
 
+    /**
+     * AllowedUnsafeSysctls is a list of explicitly allowed unsafe sysctls, defaults to none. Each entry is either a plain sysctl name or ends in "&#42;" in which case it is considered as a prefix of allowed sysctls. Single &#42; means all unsafe sysctls are allowed. Kubelet has to whitelist all allowed unsafe sysctls explicitly to avoid rejection.<br><p> <br><p> Examples: e.g. "foo/&#42;" allows "foo/bar", "foo/baz", etc. e.g. "foo.&#42;" allows "foo.bar", "foo.baz", etc.
+     */
     @JsonProperty("allowedUnsafeSysctls")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getAllowedUnsafeSysctls() {
         return allowedUnsafeSysctls;
     }
 
+    /**
+     * AllowedUnsafeSysctls is a list of explicitly allowed unsafe sysctls, defaults to none. Each entry is either a plain sysctl name or ends in "&#42;" in which case it is considered as a prefix of allowed sysctls. Single &#42; means all unsafe sysctls are allowed. Kubelet has to whitelist all allowed unsafe sysctls explicitly to avoid rejection.<br><p> <br><p> Examples: e.g. "foo/&#42;" allows "foo/bar", "foo/baz", etc. e.g. "foo.&#42;" allows "foo.bar", "foo.baz", etc.
+     */
     @JsonProperty("allowedUnsafeSysctls")
     public void setAllowedUnsafeSysctls(List<String> allowedUnsafeSysctls) {
         this.allowedUnsafeSysctls = allowedUnsafeSysctls;
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -325,68 +382,98 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * DefaultAddCapabilities is the default set of capabilities that will be added to the container unless the pod spec specifically drops the capability.  You may not list a capabiility in both DefaultAddCapabilities and RequiredDropCapabilities.
+     */
     @JsonProperty("defaultAddCapabilities")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getDefaultAddCapabilities() {
         return defaultAddCapabilities;
     }
 
+    /**
+     * DefaultAddCapabilities is the default set of capabilities that will be added to the container unless the pod spec specifically drops the capability.  You may not list a capabiility in both DefaultAddCapabilities and RequiredDropCapabilities.
+     */
     @JsonProperty("defaultAddCapabilities")
     public void setDefaultAddCapabilities(List<String> defaultAddCapabilities) {
         this.defaultAddCapabilities = defaultAddCapabilities;
     }
 
+    /**
+     * DefaultAllowPrivilegeEscalation controls the default setting for whether a process can gain more privileges than its parent process.
+     */
     @JsonProperty("defaultAllowPrivilegeEscalation")
     public Boolean getDefaultAllowPrivilegeEscalation() {
         return defaultAllowPrivilegeEscalation;
     }
 
+    /**
+     * DefaultAllowPrivilegeEscalation controls the default setting for whether a process can gain more privileges than its parent process.
+     */
     @JsonProperty("defaultAllowPrivilegeEscalation")
     public void setDefaultAllowPrivilegeEscalation(Boolean defaultAllowPrivilegeEscalation) {
         this.defaultAllowPrivilegeEscalation = defaultAllowPrivilegeEscalation;
     }
 
+    /**
+     * ForbiddenSysctls is a list of explicitly forbidden sysctls, defaults to none. Each entry is either a plain sysctl name or ends in "&#42;" in which case it is considered as a prefix of forbidden sysctls. Single &#42; means all sysctls are forbidden.<br><p> <br><p> Examples: e.g. "foo/&#42;" forbids "foo/bar", "foo/baz", etc. e.g. "foo.&#42;" forbids "foo.bar", "foo.baz", etc.
+     */
     @JsonProperty("forbiddenSysctls")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getForbiddenSysctls() {
         return forbiddenSysctls;
     }
 
+    /**
+     * ForbiddenSysctls is a list of explicitly forbidden sysctls, defaults to none. Each entry is either a plain sysctl name or ends in "&#42;" in which case it is considered as a prefix of forbidden sysctls. Single &#42; means all sysctls are forbidden.<br><p> <br><p> Examples: e.g. "foo/&#42;" forbids "foo/bar", "foo/baz", etc. e.g. "foo.&#42;" forbids "foo.bar", "foo.baz", etc.
+     */
     @JsonProperty("forbiddenSysctls")
     public void setForbiddenSysctls(List<String> forbiddenSysctls) {
         this.forbiddenSysctls = forbiddenSysctls;
     }
 
+    /**
+     * SecurityContextConstraints governs the ability to make requests that affect the SecurityContext that will be applied to a container. For historical reasons SCC was exposed under the core Kubernetes API group. That exposure is deprecated and will be removed in a future release - users should instead use the security.openshift.io group to manage SecurityContextConstraints.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("fsGroup")
     public FSGroupStrategyOptions getFsGroup() {
         return fsGroup;
     }
 
+    /**
+     * SecurityContextConstraints governs the ability to make requests that affect the SecurityContext that will be applied to a container. For historical reasons SCC was exposed under the core Kubernetes API group. That exposure is deprecated and will be removed in a future release - users should instead use the security.openshift.io group to manage SecurityContextConstraints.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("fsGroup")
     public void setFsGroup(FSGroupStrategyOptions fsGroup) {
         this.fsGroup = fsGroup;
     }
 
+    /**
+     * The groups that have permission to use this security context constraints
+     */
     @JsonProperty("groups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getGroups() {
         return groups;
     }
 
+    /**
+     * The groups that have permission to use this security context constraints
+     */
     @JsonProperty("groups")
     public void setGroups(List<String> groups) {
         this.groups = groups;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -394,122 +481,188 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SecurityContextConstraints governs the ability to make requests that affect the SecurityContext that will be applied to a container. For historical reasons SCC was exposed under the core Kubernetes API group. That exposure is deprecated and will be removed in a future release - users should instead use the security.openshift.io group to manage SecurityContextConstraints.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SecurityContextConstraints governs the ability to make requests that affect the SecurityContext that will be applied to a container. For historical reasons SCC was exposed under the core Kubernetes API group. That exposure is deprecated and will be removed in a future release - users should instead use the security.openshift.io group to manage SecurityContextConstraints.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Priority influences the sort order of SCCs when evaluating which SCCs to try first for a given pod request based on access in the Users and Groups fields.  The higher the int, the higher priority. An unset value is considered a 0 priority. If scores for multiple SCCs are equal they will be sorted from most restrictive to least restrictive. If both priorities and restrictions are equal the SCCs will be sorted by name.
+     */
     @JsonProperty("priority")
     public Integer getPriority() {
         return priority;
     }
 
+    /**
+     * Priority influences the sort order of SCCs when evaluating which SCCs to try first for a given pod request based on access in the Users and Groups fields.  The higher the int, the higher priority. An unset value is considered a 0 priority. If scores for multiple SCCs are equal they will be sorted from most restrictive to least restrictive. If both priorities and restrictions are equal the SCCs will be sorted by name.
+     */
     @JsonProperty("priority")
     public void setPriority(Integer priority) {
         this.priority = priority;
     }
 
+    /**
+     * ReadOnlyRootFilesystem when set to true will force containers to run with a read only root file system.  If the container specifically requests to run with a non-read only root file system the SCC should deny the pod. If set to false the container may run with a read only root file system if it wishes but it will not be forced to.
+     */
     @JsonProperty("readOnlyRootFilesystem")
     public Boolean getReadOnlyRootFilesystem() {
         return readOnlyRootFilesystem;
     }
 
+    /**
+     * ReadOnlyRootFilesystem when set to true will force containers to run with a read only root file system.  If the container specifically requests to run with a non-read only root file system the SCC should deny the pod. If set to false the container may run with a read only root file system if it wishes but it will not be forced to.
+     */
     @JsonProperty("readOnlyRootFilesystem")
     public void setReadOnlyRootFilesystem(Boolean readOnlyRootFilesystem) {
         this.readOnlyRootFilesystem = readOnlyRootFilesystem;
     }
 
+    /**
+     * RequiredDropCapabilities are the capabilities that will be dropped from the container.  These are required to be dropped and cannot be added.
+     */
     @JsonProperty("requiredDropCapabilities")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getRequiredDropCapabilities() {
         return requiredDropCapabilities;
     }
 
+    /**
+     * RequiredDropCapabilities are the capabilities that will be dropped from the container.  These are required to be dropped and cannot be added.
+     */
     @JsonProperty("requiredDropCapabilities")
     public void setRequiredDropCapabilities(List<String> requiredDropCapabilities) {
         this.requiredDropCapabilities = requiredDropCapabilities;
     }
 
+    /**
+     * SecurityContextConstraints governs the ability to make requests that affect the SecurityContext that will be applied to a container. For historical reasons SCC was exposed under the core Kubernetes API group. That exposure is deprecated and will be removed in a future release - users should instead use the security.openshift.io group to manage SecurityContextConstraints.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("runAsUser")
     public RunAsUserStrategyOptions getRunAsUser() {
         return runAsUser;
     }
 
+    /**
+     * SecurityContextConstraints governs the ability to make requests that affect the SecurityContext that will be applied to a container. For historical reasons SCC was exposed under the core Kubernetes API group. That exposure is deprecated and will be removed in a future release - users should instead use the security.openshift.io group to manage SecurityContextConstraints.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("runAsUser")
     public void setRunAsUser(RunAsUserStrategyOptions runAsUser) {
         this.runAsUser = runAsUser;
     }
 
+    /**
+     * SecurityContextConstraints governs the ability to make requests that affect the SecurityContext that will be applied to a container. For historical reasons SCC was exposed under the core Kubernetes API group. That exposure is deprecated and will be removed in a future release - users should instead use the security.openshift.io group to manage SecurityContextConstraints.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("seLinuxContext")
     public SELinuxContextStrategyOptions getSeLinuxContext() {
         return seLinuxContext;
     }
 
+    /**
+     * SecurityContextConstraints governs the ability to make requests that affect the SecurityContext that will be applied to a container. For historical reasons SCC was exposed under the core Kubernetes API group. That exposure is deprecated and will be removed in a future release - users should instead use the security.openshift.io group to manage SecurityContextConstraints.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("seLinuxContext")
     public void setSeLinuxContext(SELinuxContextStrategyOptions seLinuxContext) {
         this.seLinuxContext = seLinuxContext;
     }
 
+    /**
+     * SeccompProfiles lists the allowed profiles that may be set for the pod or container's seccomp annotations.  An unset (nil) or empty value means that no profiles may be specifid by the pod or container.	The wildcard '&#42;' may be used to allow all profiles.  When used to generate a value for a pod the first non-wildcard profile will be used as the default.
+     */
     @JsonProperty("seccompProfiles")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getSeccompProfiles() {
         return seccompProfiles;
     }
 
+    /**
+     * SeccompProfiles lists the allowed profiles that may be set for the pod or container's seccomp annotations.  An unset (nil) or empty value means that no profiles may be specifid by the pod or container.	The wildcard '&#42;' may be used to allow all profiles.  When used to generate a value for a pod the first non-wildcard profile will be used as the default.
+     */
     @JsonProperty("seccompProfiles")
     public void setSeccompProfiles(List<String> seccompProfiles) {
         this.seccompProfiles = seccompProfiles;
     }
 
+    /**
+     * SecurityContextConstraints governs the ability to make requests that affect the SecurityContext that will be applied to a container. For historical reasons SCC was exposed under the core Kubernetes API group. That exposure is deprecated and will be removed in a future release - users should instead use the security.openshift.io group to manage SecurityContextConstraints.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("supplementalGroups")
     public SupplementalGroupsStrategyOptions getSupplementalGroups() {
         return supplementalGroups;
     }
 
+    /**
+     * SecurityContextConstraints governs the ability to make requests that affect the SecurityContext that will be applied to a container. For historical reasons SCC was exposed under the core Kubernetes API group. That exposure is deprecated and will be removed in a future release - users should instead use the security.openshift.io group to manage SecurityContextConstraints.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("supplementalGroups")
     public void setSupplementalGroups(SupplementalGroupsStrategyOptions supplementalGroups) {
         this.supplementalGroups = supplementalGroups;
     }
 
+    /**
+     * userNamespaceLevel determines if the policy allows host users in containers. Valid values are "AllowHostLevel", "RequirePodLevel", and omitted. When "AllowHostLevel" is set, a pod author may set `hostUsers` to either `true` or `false`. When "RequirePodLevel" is set, a pod author must set `hostUsers` to `false`. When omitted, the default value is "AllowHostLevel".
+     */
     @JsonProperty("userNamespaceLevel")
     public String getUserNamespaceLevel() {
         return userNamespaceLevel;
     }
 
+    /**
+     * userNamespaceLevel determines if the policy allows host users in containers. Valid values are "AllowHostLevel", "RequirePodLevel", and omitted. When "AllowHostLevel" is set, a pod author may set `hostUsers` to either `true` or `false`. When "RequirePodLevel" is set, a pod author must set `hostUsers` to `false`. When omitted, the default value is "AllowHostLevel".
+     */
     @JsonProperty("userNamespaceLevel")
     public void setUserNamespaceLevel(String userNamespaceLevel) {
         this.userNamespaceLevel = userNamespaceLevel;
     }
 
+    /**
+     * The users who have permissions to use this security context constraints
+     */
     @JsonProperty("users")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getUsers() {
         return users;
     }
 
+    /**
+     * The users who have permissions to use this security context constraints
+     */
     @JsonProperty("users")
     public void setUsers(List<String> users) {
         this.users = users;
     }
 
+    /**
+     * Volumes is a white list of allowed volume plugins.  FSType corresponds directly with the field names of a VolumeSource (azureFile, configMap, emptyDir).  To allow all volumes you may use "&#42;". To allow no volumes, set to ["none"].
+     */
     @JsonProperty("volumes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getVolumes() {
         return volumes;
     }
 
+    /**
+     * Volumes is a white list of allowed volume plugins.  FSType corresponds directly with the field names of a VolumeSource (azureFile, configMap, emptyDir).  To allow all volumes you may use "&#42;". To allow no volumes, set to ["none"].
+     */
     @JsonProperty("volumes")
     public void setVolumes(List<String> volumes) {
         this.volumes = volumes;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SecurityContextConstraintsList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SecurityContextConstraintsList.java
index d57bd78cada..85f0007fb2f 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SecurityContextConstraintsList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SecurityContextConstraintsList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SecurityContextConstraintsList is a list of SecurityContextConstraints objects<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class SecurityContextConstraintsList implements Editable<SecurityContextConstraintsListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.SecurityContextConstraints>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "security.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.SecurityContextConstraints> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SecurityContextConstraintsList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public SecurityContextConstraintsList(String apiVersion, List<io.fabric8.openshi
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * List of security context constraints.
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.SecurityContextConstraints> getItems() {
         return items;
     }
 
+    /**
+     * List of security context constraints.
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.SecurityContextConstraints> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SecurityContextConstraintsList is a list of SecurityContextConstraints objects<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SecurityContextConstraintsList is a list of SecurityContextConstraints objects<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SelfSubjectRulesReview.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SelfSubjectRulesReview.java
index 4395c3cb22a..e8b04a7716f 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SelfSubjectRulesReview.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SelfSubjectRulesReview.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SelfSubjectRulesReview is a resource you can create to determine which actions you can perform in a namespace<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class SelfSubjectRulesReview implements Editable<SelfSubjectRulesReviewBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authorization.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SelfSubjectRulesReview";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public SelfSubjectRulesReview(String apiVersion, String kind, ObjectMeta metadat
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SelfSubjectRulesReview is a resource you can create to determine which actions you can perform in a namespace<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SelfSubjectRulesReview is a resource you can create to determine which actions you can perform in a namespace<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * SelfSubjectRulesReview is a resource you can create to determine which actions you can perform in a namespace<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public SelfSubjectRulesReviewSpec getSpec() {
         return spec;
     }
 
+    /**
+     * SelfSubjectRulesReview is a resource you can create to determine which actions you can perform in a namespace<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(SelfSubjectRulesReviewSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * SelfSubjectRulesReview is a resource you can create to determine which actions you can perform in a namespace<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public SubjectRulesReviewStatus getStatus() {
         return status;
     }
 
+    /**
+     * SelfSubjectRulesReview is a resource you can create to determine which actions you can perform in a namespace<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(SubjectRulesReviewStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SelfSubjectRulesReviewSpec.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SelfSubjectRulesReviewSpec.java
index 863e62f4e59..1a656daa734 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SelfSubjectRulesReviewSpec.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SelfSubjectRulesReviewSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SelfSubjectRulesReviewSpec adds information about how to conduct the check
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -81,12 +84,18 @@ public SelfSubjectRulesReviewSpec(List<String> scopes) {
         this.scopes = scopes;
     }
 
+    /**
+     * Scopes to use for the evaluation.  Empty means "use the unscoped (full) permissions of the user/groups". Nil means "use the scopes on this request".
+     */
     @JsonProperty("scopes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getScopes() {
         return scopes;
     }
 
+    /**
+     * Scopes to use for the evaluation.  Empty means "use the unscoped (full) permissions of the user/groups". Nil means "use the scopes on this request".
+     */
     @JsonProperty("scopes")
     public void setScopes(List<String> scopes) {
         this.scopes = scopes;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ServiceAccountPodSecurityPolicyReviewStatus.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ServiceAccountPodSecurityPolicyReviewStatus.java
index 9e1a854572b..060588e370c 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ServiceAccountPodSecurityPolicyReviewStatus.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ServiceAccountPodSecurityPolicyReviewStatus.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceAccountPodSecurityPolicyReviewStatus represents ServiceAccount name and related review status
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public ServiceAccountPodSecurityPolicyReviewStatus(ObjectReference allowedBy, St
         this.template = template;
     }
 
+    /**
+     * ServiceAccountPodSecurityPolicyReviewStatus represents ServiceAccount name and related review status
+     */
     @JsonProperty("allowedBy")
     public ObjectReference getAllowedBy() {
         return allowedBy;
     }
 
+    /**
+     * ServiceAccountPodSecurityPolicyReviewStatus represents ServiceAccount name and related review status
+     */
     @JsonProperty("allowedBy")
     public void setAllowedBy(ObjectReference allowedBy) {
         this.allowedBy = allowedBy;
     }
 
+    /**
+     * name contains the allowed and the denied ServiceAccount name
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name contains the allowed and the denied ServiceAccount name
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * A machine-readable description of why this operation is in the "Failure" status. If this value is empty there is no information available.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * A machine-readable description of why this operation is in the "Failure" status. If this value is empty there is no information available.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * ServiceAccountPodSecurityPolicyReviewStatus represents ServiceAccount name and related review status
+     */
     @JsonProperty("template")
     public PodTemplateSpec getTemplate() {
         return template;
     }
 
+    /**
+     * ServiceAccountPodSecurityPolicyReviewStatus represents ServiceAccount name and related review status
+     */
     @JsonProperty("template")
     public void setTemplate(PodTemplateSpec template) {
         this.template = template;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ServiceAccountReference.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ServiceAccountReference.java
index 6e6ee10eedc..ff9806319da 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ServiceAccountReference.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ServiceAccountReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceAccountReference specifies a service account and namespace by their names.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public ServiceAccountReference(String name, String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Name is the name of the service account.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name is the name of the service account.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Namespace is the namespace of the service account.  Service accounts from inside the whitelisted namespaces are allowed to be bound to roles.  If Namespace is empty, then the namespace of the RoleBindingRestriction in which the ServiceAccountReference is embedded is used.
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace of the service account.  Service accounts from inside the whitelisted namespaces are allowed to be bound to roles.  If Namespace is empty, then the namespace of the RoleBindingRestriction in which the ServiceAccountReference is embedded is used.
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ServiceAccountRestriction.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ServiceAccountRestriction.java
index 436e776e8a6..1ec1207a101 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ServiceAccountRestriction.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/ServiceAccountRestriction.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * ServiceAccountRestriction matches a service account by a string match on either the service-account name or the name of the service account's namespace.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public ServiceAccountRestriction(List<String> namespaces, List<ServiceAccountRef
         this.serviceaccounts = serviceaccounts;
     }
 
+    /**
+     * Namespaces specifies a list of literal namespace names.
+     */
     @JsonProperty("namespaces")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getNamespaces() {
         return namespaces;
     }
 
+    /**
+     * Namespaces specifies a list of literal namespace names.
+     */
     @JsonProperty("namespaces")
     public void setNamespaces(List<String> namespaces) {
         this.namespaces = namespaces;
     }
 
+    /**
+     * ServiceAccounts specifies a list of literal service-account names.
+     */
     @JsonProperty("serviceaccounts")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<ServiceAccountReference> getServiceaccounts() {
         return serviceaccounts;
     }
 
+    /**
+     * ServiceAccounts specifies a list of literal service-account names.
+     */
     @JsonProperty("serviceaccounts")
     public void setServiceaccounts(List<ServiceAccountReference> serviceaccounts) {
         this.serviceaccounts = serviceaccounts;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SignatureCondition.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SignatureCondition.java
index 0ea14422591..9d2e6e9dd98 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SignatureCondition.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SignatureCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SignatureCondition describes an image signature condition of particular kind at particular probe time.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public SignatureCondition(String lastProbeTime, String lastTransitionTime, Strin
         this.type = type;
     }
 
+    /**
+     * SignatureCondition describes an image signature condition of particular kind at particular probe time.
+     */
     @JsonProperty("lastProbeTime")
     public String getLastProbeTime() {
         return lastProbeTime;
     }
 
+    /**
+     * SignatureCondition describes an image signature condition of particular kind at particular probe time.
+     */
     @JsonProperty("lastProbeTime")
     public void setLastProbeTime(String lastProbeTime) {
         this.lastProbeTime = lastProbeTime;
     }
 
+    /**
+     * SignatureCondition describes an image signature condition of particular kind at particular probe time.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * SignatureCondition describes an image signature condition of particular kind at particular probe time.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Human readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Human readable message indicating details about last transition.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * (brief) reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * (brief) reason for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type of signature condition, Complete or Failed.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of signature condition, Complete or Failed.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SignatureGenericEntity.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SignatureGenericEntity.java
index 292dbc158b2..63f5c55bad4 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SignatureGenericEntity.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SignatureGenericEntity.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SignatureGenericEntity holds a generic information about a person or entity who is an issuer or a subject of signing certificate or key.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public SignatureGenericEntity(String commonName, String organization) {
         this.organization = organization;
     }
 
+    /**
+     * Common name (e.g. openshift-signing-service).
+     */
     @JsonProperty("commonName")
     public String getCommonName() {
         return commonName;
     }
 
+    /**
+     * Common name (e.g. openshift-signing-service).
+     */
     @JsonProperty("commonName")
     public void setCommonName(String commonName) {
         this.commonName = commonName;
     }
 
+    /**
+     * Organization name.
+     */
     @JsonProperty("organization")
     public String getOrganization() {
         return organization;
     }
 
+    /**
+     * Organization name.
+     */
     @JsonProperty("organization")
     public void setOrganization(String organization) {
         this.organization = organization;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SignatureIssuer.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SignatureIssuer.java
index 2b5938bb805..262a659e4e1 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SignatureIssuer.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SignatureIssuer.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SignatureIssuer holds information about an issuer of signing certificate or key.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public SignatureIssuer(String commonName, String organization) {
         this.organization = organization;
     }
 
+    /**
+     * Common name (e.g. openshift-signing-service).
+     */
     @JsonProperty("commonName")
     public String getCommonName() {
         return commonName;
     }
 
+    /**
+     * Common name (e.g. openshift-signing-service).
+     */
     @JsonProperty("commonName")
     public void setCommonName(String commonName) {
         this.commonName = commonName;
     }
 
+    /**
+     * Organization name.
+     */
     @JsonProperty("organization")
     public String getOrganization() {
         return organization;
     }
 
+    /**
+     * Organization name.
+     */
     @JsonProperty("organization")
     public void setOrganization(String organization) {
         this.organization = organization;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SignatureSubject.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SignatureSubject.java
index 7558c541bd6..516e7dc60b8 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SignatureSubject.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SignatureSubject.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SignatureSubject holds information about a person or entity who created the signature.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public SignatureSubject(String commonName, String organization, String publicKey
         this.publicKeyID = publicKeyID;
     }
 
+    /**
+     * Common name (e.g. openshift-signing-service).
+     */
     @JsonProperty("commonName")
     public String getCommonName() {
         return commonName;
     }
 
+    /**
+     * Common name (e.g. openshift-signing-service).
+     */
     @JsonProperty("commonName")
     public void setCommonName(String commonName) {
         this.commonName = commonName;
     }
 
+    /**
+     * Organization name.
+     */
     @JsonProperty("organization")
     public String getOrganization() {
         return organization;
     }
 
+    /**
+     * Organization name.
+     */
     @JsonProperty("organization")
     public void setOrganization(String organization) {
         this.organization = organization;
     }
 
+    /**
+     * If present, it is a human readable key id of public key belonging to the subject used to verify image signature. It should contain at least 64 lowest bits of public key's fingerprint (e.g. 0x685ebe62bf278440).
+     */
     @JsonProperty("publicKeyID")
     public String getPublicKeyID() {
         return publicKeyID;
     }
 
+    /**
+     * If present, it is a human readable key id of public key belonging to the subject used to verify image signature. It should contain at least 64 lowest bits of public key's fingerprint (e.g. 0x685ebe62bf278440).
+     */
     @JsonProperty("publicKeyID")
     public void setPublicKeyID(String publicKeyID) {
         this.publicKeyID = publicKeyID;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SourceBuildStrategy.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SourceBuildStrategy.java
index 9dc2b2d1223..8a3d60e6f0d 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SourceBuildStrategy.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SourceBuildStrategy.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SourceBuildStrategy defines input parameters specific to an Source build.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -106,73 +109,115 @@ public SourceBuildStrategy(List<EnvVar> env, Boolean forcePull, ObjectReference
         this.volumes = volumes;
     }
 
+    /**
+     * env contains additional environment variables you want to pass into a builder container.
+     */
     @JsonProperty("env")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<EnvVar> getEnv() {
         return env;
     }
 
+    /**
+     * env contains additional environment variables you want to pass into a builder container.
+     */
     @JsonProperty("env")
     public void setEnv(List<EnvVar> env) {
         this.env = env;
     }
 
+    /**
+     * forcePull describes if the builder should pull the images from registry prior to building.
+     */
     @JsonProperty("forcePull")
     public Boolean getForcePull() {
         return forcePull;
     }
 
+    /**
+     * forcePull describes if the builder should pull the images from registry prior to building.
+     */
     @JsonProperty("forcePull")
     public void setForcePull(Boolean forcePull) {
         this.forcePull = forcePull;
     }
 
+    /**
+     * SourceBuildStrategy defines input parameters specific to an Source build.
+     */
     @JsonProperty("from")
     public ObjectReference getFrom() {
         return from;
     }
 
+    /**
+     * SourceBuildStrategy defines input parameters specific to an Source build.
+     */
     @JsonProperty("from")
     public void setFrom(ObjectReference from) {
         this.from = from;
     }
 
+    /**
+     * incremental flag forces the Source build to do incremental builds if true.
+     */
     @JsonProperty("incremental")
     public Boolean getIncremental() {
         return incremental;
     }
 
+    /**
+     * incremental flag forces the Source build to do incremental builds if true.
+     */
     @JsonProperty("incremental")
     public void setIncremental(Boolean incremental) {
         this.incremental = incremental;
     }
 
+    /**
+     * SourceBuildStrategy defines input parameters specific to an Source build.
+     */
     @JsonProperty("pullSecret")
     public LocalObjectReference getPullSecret() {
         return pullSecret;
     }
 
+    /**
+     * SourceBuildStrategy defines input parameters specific to an Source build.
+     */
     @JsonProperty("pullSecret")
     public void setPullSecret(LocalObjectReference pullSecret) {
         this.pullSecret = pullSecret;
     }
 
+    /**
+     * scripts is the location of Source scripts
+     */
     @JsonProperty("scripts")
     public String getScripts() {
         return scripts;
     }
 
+    /**
+     * scripts is the location of Source scripts
+     */
     @JsonProperty("scripts")
     public void setScripts(String scripts) {
         this.scripts = scripts;
     }
 
+    /**
+     * volumes is a list of input volumes that can be mounted into the builds runtime environment. Only a subset of Kubernetes Volume sources are supported by builds. More info: https://kubernetes.io/docs/concepts/storage/volumes
+     */
     @JsonProperty("volumes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<BuildVolume> getVolumes() {
         return volumes;
     }
 
+    /**
+     * volumes is a list of input volumes that can be mounted into the builds runtime environment. Only a subset of Kubernetes Volume sources are supported by builds. More info: https://kubernetes.io/docs/concepts/storage/volumes
+     */
     @JsonProperty("volumes")
     public void setVolumes(List<BuildVolume> volumes) {
         this.volumes = volumes;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SourceControlUser.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SourceControlUser.java
index 29b4183e033..cbc0a0c5181 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SourceControlUser.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SourceControlUser.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SourceControlUser defines the identity of a user of source control
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public SourceControlUser(String email, String name) {
         this.name = name;
     }
 
+    /**
+     * email of the source control user
+     */
     @JsonProperty("email")
     public String getEmail() {
         return email;
     }
 
+    /**
+     * email of the source control user
+     */
     @JsonProperty("email")
     public void setEmail(String email) {
         this.email = email;
     }
 
+    /**
+     * name of the source control user
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name of the source control user
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SourceRevision.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SourceRevision.java
index f6b0da3020d..e30e4bc5082 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SourceRevision.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SourceRevision.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SourceRevision is the revision or commit information from the source for the build
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public SourceRevision(GitSourceRevision git, String type) {
         this.type = type;
     }
 
+    /**
+     * SourceRevision is the revision or commit information from the source for the build
+     */
     @JsonProperty("git")
     public GitSourceRevision getGit() {
         return git;
     }
 
+    /**
+     * SourceRevision is the revision or commit information from the source for the build
+     */
     @JsonProperty("git")
     public void setGit(GitSourceRevision git) {
         this.git = git;
     }
 
+    /**
+     * type of the build source, may be one of 'Source', 'Dockerfile', 'Binary', or 'Images'
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * type of the build source, may be one of 'Source', 'Dockerfile', 'Binary', or 'Images'
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SourceStrategyOptions.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SourceStrategyOptions.java
index 76264e5665d..e792bddb082 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SourceStrategyOptions.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SourceStrategyOptions.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SourceStrategyOptions contains extra strategy options for Source builds
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public SourceStrategyOptions(Boolean incremental) {
         this.incremental = incremental;
     }
 
+    /**
+     * incremental overrides the source-strategy incremental option in the build config
+     */
     @JsonProperty("incremental")
     public Boolean getIncremental() {
         return incremental;
     }
 
+    /**
+     * incremental overrides the source-strategy incremental option in the build config
+     */
     @JsonProperty("incremental")
     public void setIncremental(Boolean incremental) {
         this.incremental = incremental;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/StageInfo.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/StageInfo.java
index f19031f5982..0b7bc8264e7 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/StageInfo.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/StageInfo.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StageInfo contains details about a build stage.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -93,42 +96,66 @@ public StageInfo(Long durationMilliseconds, String name, String startTime, List<
         this.steps = steps;
     }
 
+    /**
+     * durationMilliseconds identifies how long the stage took to complete in milliseconds. Note: the duration of a stage can exceed the sum of the duration of the steps within the stage as not all actions are accounted for in explicit build steps.
+     */
     @JsonProperty("durationMilliseconds")
     public Long getDurationMilliseconds() {
         return durationMilliseconds;
     }
 
+    /**
+     * durationMilliseconds identifies how long the stage took to complete in milliseconds. Note: the duration of a stage can exceed the sum of the duration of the steps within the stage as not all actions are accounted for in explicit build steps.
+     */
     @JsonProperty("durationMilliseconds")
     public void setDurationMilliseconds(Long durationMilliseconds) {
         this.durationMilliseconds = durationMilliseconds;
     }
 
+    /**
+     * name is a unique identifier for each build stage that occurs.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is a unique identifier for each build stage that occurs.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * StageInfo contains details about a build stage.
+     */
     @JsonProperty("startTime")
     public String getStartTime() {
         return startTime;
     }
 
+    /**
+     * StageInfo contains details about a build stage.
+     */
     @JsonProperty("startTime")
     public void setStartTime(String startTime) {
         this.startTime = startTime;
     }
 
+    /**
+     * steps contains details about each step that occurs during a build stage including start time and duration in milliseconds.
+     */
     @JsonProperty("steps")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<StepInfo> getSteps() {
         return steps;
     }
 
+    /**
+     * steps contains details about each step that occurs during a build stage including start time and duration in milliseconds.
+     */
     @JsonProperty("steps")
     public void setSteps(List<StepInfo> steps) {
         this.steps = steps;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/StepInfo.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/StepInfo.java
index 0bf9d19a1f9..f7298137cd0 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/StepInfo.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/StepInfo.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * StepInfo contains details about a build step.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public StepInfo(Long durationMilliseconds, String name, String startTime) {
         this.startTime = startTime;
     }
 
+    /**
+     * durationMilliseconds identifies how long the step took to complete in milliseconds.
+     */
     @JsonProperty("durationMilliseconds")
     public Long getDurationMilliseconds() {
         return durationMilliseconds;
     }
 
+    /**
+     * durationMilliseconds identifies how long the step took to complete in milliseconds.
+     */
     @JsonProperty("durationMilliseconds")
     public void setDurationMilliseconds(Long durationMilliseconds) {
         this.durationMilliseconds = durationMilliseconds;
     }
 
+    /**
+     * name is a unique identifier for each build step.
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * name is a unique identifier for each build step.
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * StepInfo contains details about a build step.
+     */
     @JsonProperty("startTime")
     public String getStartTime() {
         return startTime;
     }
 
+    /**
+     * StepInfo contains details about a build step.
+     */
     @JsonProperty("startTime")
     public void setStartTime(String startTime) {
         this.startTime = startTime;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SubjectAccessReview.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SubjectAccessReview.java
index 6592d76a8c7..4b582023130 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SubjectAccessReview.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SubjectAccessReview.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubjectAccessReview is an object for requesting information about whether a user or group can perform an action<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -87,9 +90,6 @@
 public class SubjectAccessReview implements Editable<SubjectAccessReviewBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authorization.openshift.io/v1";
     @JsonProperty("content")
@@ -100,9 +100,6 @@ public class SubjectAccessReview implements Editable<SubjectAccessReviewBuilder>
     private List<String> groups = new ArrayList<>();
     @JsonProperty("isNonResourceURL")
     private Boolean isNonResourceURL;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SubjectAccessReview";
     @JsonProperty("metadata")
@@ -155,7 +152,7 @@ public SubjectAccessReview(String apiVersion, Object content, List<String> group
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -163,47 +160,65 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * SubjectAccessReview is an object for requesting information about whether a user or group can perform an action<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("content")
     public Object getContent() {
         return content;
     }
 
+    /**
+     * SubjectAccessReview is an object for requesting information about whether a user or group can perform an action<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("content")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializer.class)
     public void setContent(Object content) {
         this.content = content;
     }
 
+    /**
+     * GroupsSlice is optional. Groups is the list of groups to which the User belongs.
+     */
     @JsonProperty("groups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getGroups() {
         return groups;
     }
 
+    /**
+     * GroupsSlice is optional. Groups is the list of groups to which the User belongs.
+     */
     @JsonProperty("groups")
     public void setGroups(List<String> groups) {
         this.groups = groups;
     }
 
+    /**
+     * IsNonResourceURL is true if this is a request for a non-resource URL (outside of the resource hierarchy)
+     */
     @JsonProperty("isNonResourceURL")
     public Boolean getIsNonResourceURL() {
         return isNonResourceURL;
     }
 
+    /**
+     * IsNonResourceURL is true if this is a request for a non-resource URL (outside of the resource hierarchy)
+     */
     @JsonProperty("isNonResourceURL")
     public void setIsNonResourceURL(Boolean isNonResourceURL) {
         this.isNonResourceURL = isNonResourceURL;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -211,109 +226,169 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SubjectAccessReview is an object for requesting information about whether a user or group can perform an action<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SubjectAccessReview is an object for requesting information about whether a user or group can perform an action<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * Namespace is the namespace of the action being requested.  Currently, there is no distinction between no namespace and all namespaces
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace of the action being requested.  Currently, there is no distinction between no namespace and all namespaces
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Path is the path of a non resource URL
+     */
     @JsonProperty("path")
     public String getPath() {
         return path;
     }
 
+    /**
+     * Path is the path of a non resource URL
+     */
     @JsonProperty("path")
     public void setPath(String path) {
         this.path = path;
     }
 
+    /**
+     * Resource is one of the existing resource types
+     */
     @JsonProperty("resource")
     public String getResource() {
         return resource;
     }
 
+    /**
+     * Resource is one of the existing resource types
+     */
     @JsonProperty("resource")
     public void setResource(String resource) {
         this.resource = resource;
     }
 
+    /**
+     * Group is the API group of the resource Serialized as resourceAPIGroup to avoid confusion with the 'groups' field when inlined
+     */
     @JsonProperty("resourceAPIGroup")
     public String getResourceAPIGroup() {
         return resourceAPIGroup;
     }
 
+    /**
+     * Group is the API group of the resource Serialized as resourceAPIGroup to avoid confusion with the 'groups' field when inlined
+     */
     @JsonProperty("resourceAPIGroup")
     public void setResourceAPIGroup(String resourceAPIGroup) {
         this.resourceAPIGroup = resourceAPIGroup;
     }
 
+    /**
+     * Version is the API version of the resource Serialized as resourceAPIVersion to avoid confusion with TypeMeta.apiVersion and ObjectMeta.resourceVersion when inlined
+     */
     @JsonProperty("resourceAPIVersion")
     public String getResourceAPIVersion() {
         return resourceAPIVersion;
     }
 
+    /**
+     * Version is the API version of the resource Serialized as resourceAPIVersion to avoid confusion with TypeMeta.apiVersion and ObjectMeta.resourceVersion when inlined
+     */
     @JsonProperty("resourceAPIVersion")
     public void setResourceAPIVersion(String resourceAPIVersion) {
         this.resourceAPIVersion = resourceAPIVersion;
     }
 
+    /**
+     * ResourceName is the name of the resource being requested for a "get" or deleted for a "delete"
+     */
     @JsonProperty("resourceName")
     public String getResourceName() {
         return resourceName;
     }
 
+    /**
+     * ResourceName is the name of the resource being requested for a "get" or deleted for a "delete"
+     */
     @JsonProperty("resourceName")
     public void setResourceName(String resourceName) {
         this.resourceName = resourceName;
     }
 
+    /**
+     * Scopes to use for the evaluation.  Empty means "use the unscoped (full) permissions of the user/groups". Nil for a self-SAR, means "use the scopes on this request". Nil for a regular SAR, means the same as empty.
+     */
     @JsonProperty("scopes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getScopes() {
         return scopes;
     }
 
+    /**
+     * Scopes to use for the evaluation.  Empty means "use the unscoped (full) permissions of the user/groups". Nil for a self-SAR, means "use the scopes on this request". Nil for a regular SAR, means the same as empty.
+     */
     @JsonProperty("scopes")
     public void setScopes(List<String> scopes) {
         this.scopes = scopes;
     }
 
+    /**
+     * User is optional. If both User and Groups are empty, the current authenticated user is used.
+     */
     @JsonProperty("user")
     public String getUser() {
         return user;
     }
 
+    /**
+     * User is optional. If both User and Groups are empty, the current authenticated user is used.
+     */
     @JsonProperty("user")
     public void setUser(String user) {
         this.user = user;
     }
 
+    /**
+     * Verb is one of: get, list, watch, create, update, delete
+     */
     @JsonProperty("verb")
     public String getVerb() {
         return verb;
     }
 
+    /**
+     * Verb is one of: get, list, watch, create, update, delete
+     */
     @JsonProperty("verb")
     public void setVerb(String verb) {
         this.verb = verb;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SubjectAccessReviewResponse.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SubjectAccessReviewResponse.java
index eb228a5f1b5..5664760640e 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SubjectAccessReviewResponse.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SubjectAccessReviewResponse.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubjectAccessReviewResponse describes whether or not a user or group can perform an action<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -79,16 +82,10 @@ public class SubjectAccessReviewResponse implements Editable<SubjectAccessReview
 
     @JsonProperty("allowed")
     private Boolean allowed;
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authorization.openshift.io/v1";
     @JsonProperty("evaluationError")
     private String evaluationError;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SubjectAccessReviewResponse";
     @JsonProperty("namespace")
@@ -114,18 +111,24 @@ public SubjectAccessReviewResponse(Boolean allowed, String apiVersion, String ev
         this.reason = reason;
     }
 
+    /**
+     * Allowed is required.  True if the action would be allowed, false otherwise.
+     */
     @JsonProperty("allowed")
     public Boolean getAllowed() {
         return allowed;
     }
 
+    /**
+     * Allowed is required.  True if the action would be allowed, false otherwise.
+     */
     @JsonProperty("allowed")
     public void setAllowed(Boolean allowed) {
         this.allowed = allowed;
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -133,25 +136,31 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * EvaluationError is an indication that some error occurred during the authorization check. It is entirely possible to get an error and be able to continue determine authorization status in spite of it.  This is most common when a bound role is missing, but enough roles are still present and bound to reason about the request.
+     */
     @JsonProperty("evaluationError")
     public String getEvaluationError() {
         return evaluationError;
     }
 
+    /**
+     * EvaluationError is an indication that some error occurred during the authorization check. It is entirely possible to get an error and be able to continue determine authorization status in spite of it.  This is most common when a bound role is missing, but enough roles are still present and bound to reason about the request.
+     */
     @JsonProperty("evaluationError")
     public void setEvaluationError(String evaluationError) {
         this.evaluationError = evaluationError;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -159,28 +168,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Namespace is the namespace used for the access review
+     */
     @JsonProperty("namespace")
     public String getNamespace() {
         return namespace;
     }
 
+    /**
+     * Namespace is the namespace used for the access review
+     */
     @JsonProperty("namespace")
     public void setNamespace(String namespace) {
         this.namespace = namespace;
     }
 
+    /**
+     * Reason is optional.  It indicates why a request was allowed or denied.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason is optional.  It indicates why a request was allowed or denied.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SubjectRulesReview.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SubjectRulesReview.java
index c248a9abde5..ab716be8b88 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SubjectRulesReview.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SubjectRulesReview.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubjectRulesReview is a resource you can create to determine which actions another user can perform in a namespace<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class SubjectRulesReview implements Editable<SubjectRulesReviewBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "authorization.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "SubjectRulesReview";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public SubjectRulesReview(String apiVersion, String kind, ObjectMeta metadata, S
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * SubjectRulesReview is a resource you can create to determine which actions another user can perform in a namespace<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * SubjectRulesReview is a resource you can create to determine which actions another user can perform in a namespace<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * SubjectRulesReview is a resource you can create to determine which actions another user can perform in a namespace<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public SubjectRulesReviewSpec getSpec() {
         return spec;
     }
 
+    /**
+     * SubjectRulesReview is a resource you can create to determine which actions another user can perform in a namespace<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(SubjectRulesReviewSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * SubjectRulesReview is a resource you can create to determine which actions another user can perform in a namespace<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public SubjectRulesReviewStatus getStatus() {
         return status;
     }
 
+    /**
+     * SubjectRulesReview is a resource you can create to determine which actions another user can perform in a namespace<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(SubjectRulesReviewStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SubjectRulesReviewSpec.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SubjectRulesReviewSpec.java
index 0dcc81e28a7..08c92efd215 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SubjectRulesReviewSpec.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SubjectRulesReviewSpec.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubjectRulesReviewSpec adds information about how to conduct the check
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,33 +93,51 @@ public SubjectRulesReviewSpec(List<String> groups, List<String> scopes, String u
         this.user = user;
     }
 
+    /**
+     * Groups is optional.  Groups is the list of groups to which the User belongs.  At least one of User and Groups must be specified.
+     */
     @JsonProperty("groups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getGroups() {
         return groups;
     }
 
+    /**
+     * Groups is optional.  Groups is the list of groups to which the User belongs.  At least one of User and Groups must be specified.
+     */
     @JsonProperty("groups")
     public void setGroups(List<String> groups) {
         this.groups = groups;
     }
 
+    /**
+     * Scopes to use for the evaluation.  Empty means "use the unscoped (full) permissions of the user/groups".
+     */
     @JsonProperty("scopes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getScopes() {
         return scopes;
     }
 
+    /**
+     * Scopes to use for the evaluation.  Empty means "use the unscoped (full) permissions of the user/groups".
+     */
     @JsonProperty("scopes")
     public void setScopes(List<String> scopes) {
         this.scopes = scopes;
     }
 
+    /**
+     * User is optional.  At least one of User and Groups must be specified.
+     */
     @JsonProperty("user")
     public String getUser() {
         return user;
     }
 
+    /**
+     * User is optional.  At least one of User and Groups must be specified.
+     */
     @JsonProperty("user")
     public void setUser(String user) {
         this.user = user;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SubjectRulesReviewStatus.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SubjectRulesReviewStatus.java
index 5fdff7ee7af..19e3bb69d6c 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SubjectRulesReviewStatus.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SubjectRulesReviewStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SubjectRulesReviewStatus is contains the result of a rules check
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public SubjectRulesReviewStatus(String evaluationError, List<PolicyRule> rules)
         this.rules = rules;
     }
 
+    /**
+     * EvaluationError can appear in combination with Rules.  It means some error happened during evaluation that may have prevented additional rules from being populated.
+     */
     @JsonProperty("evaluationError")
     public String getEvaluationError() {
         return evaluationError;
     }
 
+    /**
+     * EvaluationError can appear in combination with Rules.  It means some error happened during evaluation that may have prevented additional rules from being populated.
+     */
     @JsonProperty("evaluationError")
     public void setEvaluationError(String evaluationError) {
         this.evaluationError = evaluationError;
     }
 
+    /**
+     * Rules is the list of rules (no particular sort) that are allowed for the subject
+     */
     @JsonProperty("rules")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<PolicyRule> getRules() {
         return rules;
     }
 
+    /**
+     * Rules is the list of rules (no particular sort) that are allowed for the subject
+     */
     @JsonProperty("rules")
     public void setRules(List<PolicyRule> rules) {
         this.rules = rules;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SupplementalGroupsStrategyOptions.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SupplementalGroupsStrategyOptions.java
index f9cc060ea6a..59a1ee0d8d0 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SupplementalGroupsStrategyOptions.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/SupplementalGroupsStrategyOptions.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * SupplementalGroupsStrategyOptions defines the strategy type and options used to create the strategy.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -85,22 +88,34 @@ public SupplementalGroupsStrategyOptions(List<IDRange> ranges, String type) {
         this.type = type;
     }
 
+    /**
+     * Ranges are the allowed ranges of supplemental groups.  If you would like to force a single supplemental group then supply a single range with the same start and end.
+     */
     @JsonProperty("ranges")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<IDRange> getRanges() {
         return ranges;
     }
 
+    /**
+     * Ranges are the allowed ranges of supplemental groups.  If you would like to force a single supplemental group then supply a single range with the same start and end.
+     */
     @JsonProperty("ranges")
     public void setRanges(List<IDRange> ranges) {
         this.ranges = ranges;
     }
 
+    /**
+     * Type is the strategy that will dictate what supplemental groups is used in the SecurityContext.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type is the strategy that will dictate what supplemental groups is used in the SecurityContext.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TLSConfig.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TLSConfig.java
index 6d0245e76d6..88158e69a0e 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TLSConfig.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TLSConfig.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TLSConfig defines config used to secure a route and provide termination
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -102,71 +105,113 @@ public TLSConfig(String caCertificate, String certificate, String destinationCAC
         this.termination = termination;
     }
 
+    /**
+     * caCertificate provides the cert authority certificate contents
+     */
     @JsonProperty("caCertificate")
     public String getCaCertificate() {
         return caCertificate;
     }
 
+    /**
+     * caCertificate provides the cert authority certificate contents
+     */
     @JsonProperty("caCertificate")
     public void setCaCertificate(String caCertificate) {
         this.caCertificate = caCertificate;
     }
 
+    /**
+     * certificate provides certificate contents. This should be a single serving certificate, not a certificate chain. Do not include a CA certificate.
+     */
     @JsonProperty("certificate")
     public String getCertificate() {
         return certificate;
     }
 
+    /**
+     * certificate provides certificate contents. This should be a single serving certificate, not a certificate chain. Do not include a CA certificate.
+     */
     @JsonProperty("certificate")
     public void setCertificate(String certificate) {
         this.certificate = certificate;
     }
 
+    /**
+     * destinationCACertificate provides the contents of the ca certificate of the final destination.  When using reencrypt termination this file should be provided in order to have routers use it for health checks on the secure connection. If this field is not specified, the router may provide its own destination CA and perform hostname validation using the short service name (service.namespace.svc), which allows infrastructure generated certificates to automatically verify.
+     */
     @JsonProperty("destinationCACertificate")
     public String getDestinationCACertificate() {
         return destinationCACertificate;
     }
 
+    /**
+     * destinationCACertificate provides the contents of the ca certificate of the final destination.  When using reencrypt termination this file should be provided in order to have routers use it for health checks on the secure connection. If this field is not specified, the router may provide its own destination CA and perform hostname validation using the short service name (service.namespace.svc), which allows infrastructure generated certificates to automatically verify.
+     */
     @JsonProperty("destinationCACertificate")
     public void setDestinationCACertificate(String destinationCACertificate) {
         this.destinationCACertificate = destinationCACertificate;
     }
 
+    /**
+     * TLSConfig defines config used to secure a route and provide termination
+     */
     @JsonProperty("externalCertificate")
     public LocalObjectReference getExternalCertificate() {
         return externalCertificate;
     }
 
+    /**
+     * TLSConfig defines config used to secure a route and provide termination
+     */
     @JsonProperty("externalCertificate")
     public void setExternalCertificate(LocalObjectReference externalCertificate) {
         this.externalCertificate = externalCertificate;
     }
 
+    /**
+     * insecureEdgeTerminationPolicy indicates the desired behavior for insecure connections to a route. While each router may make its own decisions on which ports to expose, this is normally port 80.<br><p> <br><p> If a route does not specify insecureEdgeTerminationPolicy, then the default behavior is "None".<br><p> <br><p> &#42; Allow - traffic is sent to the server on the insecure port (edge/reencrypt terminations only).<br><p> <br><p> &#42; None - no traffic is allowed on the insecure port (default).<br><p> <br><p> &#42; Redirect - clients are redirected to the secure port.
+     */
     @JsonProperty("insecureEdgeTerminationPolicy")
     public String getInsecureEdgeTerminationPolicy() {
         return insecureEdgeTerminationPolicy;
     }
 
+    /**
+     * insecureEdgeTerminationPolicy indicates the desired behavior for insecure connections to a route. While each router may make its own decisions on which ports to expose, this is normally port 80.<br><p> <br><p> If a route does not specify insecureEdgeTerminationPolicy, then the default behavior is "None".<br><p> <br><p> &#42; Allow - traffic is sent to the server on the insecure port (edge/reencrypt terminations only).<br><p> <br><p> &#42; None - no traffic is allowed on the insecure port (default).<br><p> <br><p> &#42; Redirect - clients are redirected to the secure port.
+     */
     @JsonProperty("insecureEdgeTerminationPolicy")
     public void setInsecureEdgeTerminationPolicy(String insecureEdgeTerminationPolicy) {
         this.insecureEdgeTerminationPolicy = insecureEdgeTerminationPolicy;
     }
 
+    /**
+     * key provides key file contents
+     */
     @JsonProperty("key")
     public String getKey() {
         return key;
     }
 
+    /**
+     * key provides key file contents
+     */
     @JsonProperty("key")
     public void setKey(String key) {
         this.key = key;
     }
 
+    /**
+     * termination indicates termination type.<br><p> <br><p> &#42; edge - TLS termination is done by the router and http is used to communicate with the backend (default) &#42; passthrough - Traffic is sent straight to the destination without the router providing TLS termination &#42; reencrypt - TLS termination is done by the router and https is used to communicate with the backend<br><p> <br><p> Note: passthrough termination is incompatible with httpHeader actions
+     */
     @JsonProperty("termination")
     public String getTermination() {
         return termination;
     }
 
+    /**
+     * termination indicates termination type.<br><p> <br><p> &#42; edge - TLS termination is done by the router and http is used to communicate with the backend (default) &#42; passthrough - Traffic is sent straight to the destination without the router providing TLS termination &#42; reencrypt - TLS termination is done by the router and https is used to communicate with the backend<br><p> <br><p> Note: passthrough termination is incompatible with httpHeader actions
+     */
     @JsonProperty("termination")
     public void setTermination(String termination) {
         this.termination = termination;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TagEvent.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TagEvent.java
index c915565d53d..454015eafe2 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TagEvent.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TagEvent.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TagEvent is used by ImageStreamStatus to keep a historical record of images associated with a tag.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -90,41 +93,65 @@ public TagEvent(String created, String dockerImageReference, Long generation, St
         this.image = image;
     }
 
+    /**
+     * TagEvent is used by ImageStreamStatus to keep a historical record of images associated with a tag.
+     */
     @JsonProperty("created")
     public String getCreated() {
         return created;
     }
 
+    /**
+     * TagEvent is used by ImageStreamStatus to keep a historical record of images associated with a tag.
+     */
     @JsonProperty("created")
     public void setCreated(String created) {
         this.created = created;
     }
 
+    /**
+     * DockerImageReference is the string that can be used to pull this image
+     */
     @JsonProperty("dockerImageReference")
     public String getDockerImageReference() {
         return dockerImageReference;
     }
 
+    /**
+     * DockerImageReference is the string that can be used to pull this image
+     */
     @JsonProperty("dockerImageReference")
     public void setDockerImageReference(String dockerImageReference) {
         this.dockerImageReference = dockerImageReference;
     }
 
+    /**
+     * Generation is the spec tag generation that resulted in this tag being updated
+     */
     @JsonProperty("generation")
     public Long getGeneration() {
         return generation;
     }
 
+    /**
+     * Generation is the spec tag generation that resulted in this tag being updated
+     */
     @JsonProperty("generation")
     public void setGeneration(Long generation) {
         this.generation = generation;
     }
 
+    /**
+     * Image is the image
+     */
     @JsonProperty("image")
     public String getImage() {
         return image;
     }
 
+    /**
+     * Image is the image
+     */
     @JsonProperty("image")
     public void setImage(String image) {
         this.image = image;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TagEventCondition.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TagEventCondition.java
index 38130fc620f..4b71b2453e4 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TagEventCondition.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TagEventCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TagEventCondition contains condition information for a tag event.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public TagEventCondition(Long generation, String lastTransitionTime, String mess
         this.type = type;
     }
 
+    /**
+     * Generation is the spec tag generation that this status corresponds to
+     */
     @JsonProperty("generation")
     public Long getGeneration() {
         return generation;
     }
 
+    /**
+     * Generation is the spec tag generation that this status corresponds to
+     */
     @JsonProperty("generation")
     public void setGeneration(Long generation) {
         this.generation = generation;
     }
 
+    /**
+     * TagEventCondition contains condition information for a tag event.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * TagEventCondition contains condition information for a tag event.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Message is a human readable description of the details about last transition, complementing reason.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message is a human readable description of the details about last transition, complementing reason.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Reason is a brief machine readable explanation for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason is a brief machine readable explanation for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition, one of True, False, Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type of tag event condition, currently only ImportSuccess
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of tag event condition, currently only ImportSuccess
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TagImageHook.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TagImageHook.java
index cb4e1458cbb..30e3e0ab248 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TagImageHook.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TagImageHook.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TagImageHook is a request to tag the image in a particular container onto an ImageStreamTag.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -82,21 +85,33 @@ public TagImageHook(String containerName, ObjectReference to) {
         this.to = to;
     }
 
+    /**
+     * ContainerName is the name of a container in the deployment config whose image value will be used as the source of the tag. If there is only a single container this value will be defaulted to the name of that container.
+     */
     @JsonProperty("containerName")
     public String getContainerName() {
         return containerName;
     }
 
+    /**
+     * ContainerName is the name of a container in the deployment config whose image value will be used as the source of the tag. If there is only a single container this value will be defaulted to the name of that container.
+     */
     @JsonProperty("containerName")
     public void setContainerName(String containerName) {
         this.containerName = containerName;
     }
 
+    /**
+     * TagImageHook is a request to tag the image in a particular container onto an ImageStreamTag.
+     */
     @JsonProperty("to")
     public ObjectReference getTo() {
         return to;
     }
 
+    /**
+     * TagImageHook is a request to tag the image in a particular container onto an ImageStreamTag.
+     */
     @JsonProperty("to")
     public void setTo(ObjectReference to) {
         this.to = to;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TagImportPolicy.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TagImportPolicy.java
index 1fc9757ec46..2a9d1fb27d4 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TagImportPolicy.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TagImportPolicy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TagImportPolicy controls how images related to this tag will be imported.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public TagImportPolicy(String importMode, Boolean insecure, Boolean scheduled) {
         this.scheduled = scheduled;
     }
 
+    /**
+     * ImportMode describes how to import an image manifest.
+     */
     @JsonProperty("importMode")
     public String getImportMode() {
         return importMode;
     }
 
+    /**
+     * ImportMode describes how to import an image manifest.
+     */
     @JsonProperty("importMode")
     public void setImportMode(String importMode) {
         this.importMode = importMode;
     }
 
+    /**
+     * Insecure is true if the server may bypass certificate verification or connect directly over HTTP during image import.
+     */
     @JsonProperty("insecure")
     public Boolean getInsecure() {
         return insecure;
     }
 
+    /**
+     * Insecure is true if the server may bypass certificate verification or connect directly over HTTP during image import.
+     */
     @JsonProperty("insecure")
     public void setInsecure(Boolean insecure) {
         this.insecure = insecure;
     }
 
+    /**
+     * Scheduled indicates to the server that this tag should be periodically checked to ensure it is up to date, and imported
+     */
     @JsonProperty("scheduled")
     public Boolean getScheduled() {
         return scheduled;
     }
 
+    /**
+     * Scheduled indicates to the server that this tag should be periodically checked to ensure it is up to date, and imported
+     */
     @JsonProperty("scheduled")
     public void setScheduled(Boolean scheduled) {
         this.scheduled = scheduled;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TagReference.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TagReference.java
index de245ddfe01..b661f16d60e 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TagReference.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TagReference.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TagReference specifies optional annotations for images using this tag and an optional reference to an ImageStreamTag, ImageStreamImage, or DockerImage this tag should track.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -103,72 +106,114 @@ public TagReference(Map<String, String> annotations, ObjectReference from, Long
         this.referencePolicy = referencePolicy;
     }
 
+    /**
+     * Optional; if specified, annotations that are applied to images retrieved via ImageStreamTags.
+     */
     @JsonProperty("annotations")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getAnnotations() {
         return annotations;
     }
 
+    /**
+     * Optional; if specified, annotations that are applied to images retrieved via ImageStreamTags.
+     */
     @JsonProperty("annotations")
     public void setAnnotations(Map<String, String> annotations) {
         this.annotations = annotations;
     }
 
+    /**
+     * TagReference specifies optional annotations for images using this tag and an optional reference to an ImageStreamTag, ImageStreamImage, or DockerImage this tag should track.
+     */
     @JsonProperty("from")
     public ObjectReference getFrom() {
         return from;
     }
 
+    /**
+     * TagReference specifies optional annotations for images using this tag and an optional reference to an ImageStreamTag, ImageStreamImage, or DockerImage this tag should track.
+     */
     @JsonProperty("from")
     public void setFrom(ObjectReference from) {
         this.from = from;
     }
 
+    /**
+     * Generation is a counter that tracks mutations to the spec tag (user intent). When a tag reference is changed the generation is set to match the current stream generation (which is incremented every time spec is changed). Other processes in the system like the image importer observe that the generation of spec tag is newer than the generation recorded in the status and use that as a trigger to import the newest remote tag. To trigger a new import, clients may set this value to zero which will reset the generation to the latest stream generation. Legacy clients will send this value as nil which will be merged with the current tag generation.
+     */
     @JsonProperty("generation")
     public Long getGeneration() {
         return generation;
     }
 
+    /**
+     * Generation is a counter that tracks mutations to the spec tag (user intent). When a tag reference is changed the generation is set to match the current stream generation (which is incremented every time spec is changed). Other processes in the system like the image importer observe that the generation of spec tag is newer than the generation recorded in the status and use that as a trigger to import the newest remote tag. To trigger a new import, clients may set this value to zero which will reset the generation to the latest stream generation. Legacy clients will send this value as nil which will be merged with the current tag generation.
+     */
     @JsonProperty("generation")
     public void setGeneration(Long generation) {
         this.generation = generation;
     }
 
+    /**
+     * TagReference specifies optional annotations for images using this tag and an optional reference to an ImageStreamTag, ImageStreamImage, or DockerImage this tag should track.
+     */
     @JsonProperty("importPolicy")
     public TagImportPolicy getImportPolicy() {
         return importPolicy;
     }
 
+    /**
+     * TagReference specifies optional annotations for images using this tag and an optional reference to an ImageStreamTag, ImageStreamImage, or DockerImage this tag should track.
+     */
     @JsonProperty("importPolicy")
     public void setImportPolicy(TagImportPolicy importPolicy) {
         this.importPolicy = importPolicy;
     }
 
+    /**
+     * Name of the tag
+     */
     @JsonProperty("name")
     public String getName() {
         return name;
     }
 
+    /**
+     * Name of the tag
+     */
     @JsonProperty("name")
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * Reference states if the tag will be imported. Default value is false, which means the tag will be imported.
+     */
     @JsonProperty("reference")
     public Boolean getReference() {
         return reference;
     }
 
+    /**
+     * Reference states if the tag will be imported. Default value is false, which means the tag will be imported.
+     */
     @JsonProperty("reference")
     public void setReference(Boolean reference) {
         this.reference = reference;
     }
 
+    /**
+     * TagReference specifies optional annotations for images using this tag and an optional reference to an ImageStreamTag, ImageStreamImage, or DockerImage this tag should track.
+     */
     @JsonProperty("referencePolicy")
     public TagReferencePolicy getReferencePolicy() {
         return referencePolicy;
     }
 
+    /**
+     * TagReference specifies optional annotations for images using this tag and an optional reference to an ImageStreamTag, ImageStreamImage, or DockerImage this tag should track.
+     */
     @JsonProperty("referencePolicy")
     public void setReferencePolicy(TagReferencePolicy referencePolicy) {
         this.referencePolicy = referencePolicy;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TagReferencePolicy.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TagReferencePolicy.java
index 17378efc55d..bdfded22765 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TagReferencePolicy.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TagReferencePolicy.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TagReferencePolicy describes how pull-specs for images in this image stream tag are generated when image change triggers in deployment configs or builds are resolved. This allows the image stream author to control how images are accessed.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public TagReferencePolicy(String type) {
         this.type = type;
     }
 
+    /**
+     * Type determines how the image pull spec should be transformed when the image stream tag is used in deployment config triggers or new builds. The default value is `Source`, indicating the original location of the image should be used (if imported). The user may also specify `Local`, indicating that the pull spec should point to the integrated container image registry and leverage the registry's ability to proxy the pull to an upstream registry. `Local` allows the credentials used to pull this image to be managed from the image stream's namespace, so others on the platform can access a remote image but have no access to the remote secret. It also allows the image layers to be mirrored into the local registry which the images can still be pulled even if the upstream registry is unavailable.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type determines how the image pull spec should be transformed when the image stream tag is used in deployment config triggers or new builds. The default value is `Source`, indicating the original location of the image should be used (if imported). The user may also specify `Local`, indicating that the pull spec should point to the integrated container image registry and leverage the registry's ability to proxy the pull to an upstream registry. `Local` allows the credentials used to pull this image to be managed from the image stream's namespace, so others on the platform can access a remote image but have no access to the remote secret. It also allows the image layers to be mirrored into the local registry which the images can still be pulled even if the upstream registry is unavailable.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Template.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Template.java
index 9bfc39b1baf..bdb115cac34 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Template.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/Template.java
@@ -39,6 +39,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Template contains the inputs needed to produce a Config.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = io.fabric8.openshift.api.model.TemplateDeserializer.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -80,14 +83,8 @@
 public class Template implements Editable<TemplateBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "template.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "Template";
     @JsonProperty("labels")
@@ -125,7 +122,7 @@ public Template(String apiVersion, String kind, Map<String, String> labels, Stri
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -133,7 +130,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -141,7 +138,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -149,62 +146,92 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * labels is a optional set of labels that are applied to every object during the Template to Config transformation.
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, String> getLabels() {
         return labels;
     }
 
+    /**
+     * labels is a optional set of labels that are applied to every object during the Template to Config transformation.
+     */
     @JsonProperty("labels")
     public void setLabels(Map<String, String> labels) {
         this.labels = labels;
     }
 
+    /**
+     * message is an optional instructional message that will be displayed when this template is instantiated. This field should inform the user how to utilize the newly created resources. Parameter substitution will be performed on the message before being displayed so that generated credentials and other parameters can be included in the output.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * message is an optional instructional message that will be displayed when this template is instantiated. This field should inform the user how to utilize the newly created resources. Parameter substitution will be performed on the message before being displayed so that generated credentials and other parameters can be included in the output.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Template contains the inputs needed to produce a Config.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Template contains the inputs needed to produce a Config.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * objects is an array of resources to include in this template. If a namespace value is hardcoded in the object, it will be removed during template instantiation, however if the namespace value is, or contains, a ${PARAMETER_REFERENCE}, the resolved value after parameter substitution will be respected and the object will be created in that namespace.
+     */
     @JsonProperty("objects")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Object> getObjects() {
         return objects;
     }
 
+    /**
+     * objects is an array of resources to include in this template. If a namespace value is hardcoded in the object, it will be removed during template instantiation, however if the namespace value is, or contains, a ${PARAMETER_REFERENCE}, the resolved value after parameter substitution will be respected and the object will be created in that namespace.
+     */
     @JsonProperty("objects")
     @JsonDeserialize(using = io.fabric8.kubernetes.internal.KubernetesDeserializerForList.class)
     public void setObjects(List<Object> objects) {
         this.objects = objects;
     }
 
+    /**
+     * parameters is an optional array of Parameters used during the Template to Config transformation.
+     */
     @JsonProperty("parameters")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<Parameter> getParameters() {
         return parameters;
     }
 
+    /**
+     * parameters is an optional array of Parameters used during the Template to Config transformation.
+     */
     @JsonProperty("parameters")
     public void setParameters(List<Parameter> parameters) {
         this.parameters = parameters;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateInstance.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateInstance.java
index 87c8e29aa69..41d26401693 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateInstance.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateInstance.java
@@ -37,6 +37,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TemplateInstance requests and records the instantiation of a Template. TemplateInstance is part of an experimental API.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -76,14 +79,8 @@
 public class TemplateInstance implements Editable<TemplateInstanceBuilder>, HasMetadata, Namespaced
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "template.openshift.io/v1";
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TemplateInstance";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TemplateInstance(String apiVersion, String kind, ObjectMeta metadata, Tem
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,7 +116,7 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
@@ -127,7 +124,7 @@ public void setApiVersion(String apiVersion) {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -135,38 +132,56 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TemplateInstance requests and records the instantiation of a Template. TemplateInstance is part of an experimental API.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TemplateInstance requests and records the instantiation of a Template. TemplateInstance is part of an experimental API.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * TemplateInstance requests and records the instantiation of a Template. TemplateInstance is part of an experimental API.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public TemplateInstanceSpec getSpec() {
         return spec;
     }
 
+    /**
+     * TemplateInstance requests and records the instantiation of a Template. TemplateInstance is part of an experimental API.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("spec")
     public void setSpec(TemplateInstanceSpec spec) {
         this.spec = spec;
     }
 
+    /**
+     * TemplateInstance requests and records the instantiation of a Template. TemplateInstance is part of an experimental API.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public TemplateInstanceStatus getStatus() {
         return status;
     }
 
+    /**
+     * TemplateInstance requests and records the instantiation of a Template. TemplateInstance is part of an experimental API.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("status")
     public void setStatus(TemplateInstanceStatus status) {
         this.status = status;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateInstanceCondition.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateInstanceCondition.java
index 2ff33195925..c0e5bc4e621 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateInstanceCondition.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateInstanceCondition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TemplateInstanceCondition contains condition information for a TemplateInstance.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,51 +97,81 @@ public TemplateInstanceCondition(String lastTransitionTime, String message, Stri
         this.type = type;
     }
 
+    /**
+     * TemplateInstanceCondition contains condition information for a TemplateInstance.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * TemplateInstanceCondition contains condition information for a TemplateInstance.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Message is a human readable description of the details of the last transition, complementing reason.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Message is a human readable description of the details of the last transition, complementing reason.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Reason is a brief machine readable explanation for the condition's last transition.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Reason is a brief machine readable explanation for the condition's last transition.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Status of the condition, one of True, False or Unknown.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Status of the condition, one of True, False or Unknown.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Type of the condition, currently Ready or InstantiateFailure.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Type of the condition, currently Ready or InstantiateFailure.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateInstanceList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateInstanceList.java
index 5b68fea06fd..930912c9f74 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateInstanceList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateInstanceList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TemplateInstanceList is a list of TemplateInstance objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class TemplateInstanceList implements Editable<TemplateInstanceListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.TemplateInstance>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "template.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.TemplateInstance> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TemplateInstanceList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TemplateInstanceList(String apiVersion, List<io.fabric8.openshift.api.mod
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * items is a list of Templateinstances
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.TemplateInstance> getItems() {
         return items;
     }
 
+    /**
+     * items is a list of Templateinstances
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.TemplateInstance> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TemplateInstanceList is a list of TemplateInstance objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TemplateInstanceList is a list of TemplateInstance objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateInstanceObject.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateInstanceObject.java
index 90a878fc8a0..c230cd37cb3 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateInstanceObject.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateInstanceObject.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TemplateInstanceObject references an object created by a TemplateInstance.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,11 +81,17 @@ public TemplateInstanceObject(ObjectReference ref) {
         this.ref = ref;
     }
 
+    /**
+     * TemplateInstanceObject references an object created by a TemplateInstance.
+     */
     @JsonProperty("ref")
     public ObjectReference getRef() {
         return ref;
     }
 
+    /**
+     * TemplateInstanceObject references an object created by a TemplateInstance.
+     */
     @JsonProperty("ref")
     public void setRef(ObjectReference ref) {
         this.ref = ref;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateInstanceRequester.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateInstanceRequester.java
index 7a7757f244a..3a0894af048 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateInstanceRequester.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateInstanceRequester.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TemplateInstanceRequester holds the identity of an agent requesting a template instantiation.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -94,43 +97,67 @@ public TemplateInstanceRequester(Map<String, List<String>> extra, List<String> g
         this.username = username;
     }
 
+    /**
+     * extra holds additional information provided by the authenticator.
+     */
     @JsonProperty("extra")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public Map<String, List<String>> getExtra() {
         return extra;
     }
 
+    /**
+     * extra holds additional information provided by the authenticator.
+     */
     @JsonProperty("extra")
     public void setExtra(Map<String, List<String>> extra) {
         this.extra = extra;
     }
 
+    /**
+     * groups represent the groups this user is a part of.
+     */
     @JsonProperty("groups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getGroups() {
         return groups;
     }
 
+    /**
+     * groups represent the groups this user is a part of.
+     */
     @JsonProperty("groups")
     public void setGroups(List<String> groups) {
         this.groups = groups;
     }
 
+    /**
+     * uid is a unique value that identifies this user across time; if this user is deleted and another user by the same name is added, they will have different UIDs.
+     */
     @JsonProperty("uid")
     public String getUid() {
         return uid;
     }
 
+    /**
+     * uid is a unique value that identifies this user across time; if this user is deleted and another user by the same name is added, they will have different UIDs.
+     */
     @JsonProperty("uid")
     public void setUid(String uid) {
         this.uid = uid;
     }
 
+    /**
+     * username uniquely identifies this user among all active users.
+     */
     @JsonProperty("username")
     public String getUsername() {
         return username;
     }
 
+    /**
+     * username uniquely identifies this user among all active users.
+     */
     @JsonProperty("username")
     public void setUsername(String username) {
         this.username = username;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateInstanceSpec.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateInstanceSpec.java
index 3e6feb478ae..a6be88076bb 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateInstanceSpec.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateInstanceSpec.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TemplateInstanceSpec describes the desired state of a TemplateInstance.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public TemplateInstanceSpec(TemplateInstanceRequester requester, LocalObjectRefe
         this.template = template;
     }
 
+    /**
+     * TemplateInstanceSpec describes the desired state of a TemplateInstance.
+     */
     @JsonProperty("requester")
     public TemplateInstanceRequester getRequester() {
         return requester;
     }
 
+    /**
+     * TemplateInstanceSpec describes the desired state of a TemplateInstance.
+     */
     @JsonProperty("requester")
     public void setRequester(TemplateInstanceRequester requester) {
         this.requester = requester;
     }
 
+    /**
+     * TemplateInstanceSpec describes the desired state of a TemplateInstance.
+     */
     @JsonProperty("secret")
     public LocalObjectReference getSecret() {
         return secret;
     }
 
+    /**
+     * TemplateInstanceSpec describes the desired state of a TemplateInstance.
+     */
     @JsonProperty("secret")
     public void setSecret(LocalObjectReference secret) {
         this.secret = secret;
     }
 
+    /**
+     * TemplateInstanceSpec describes the desired state of a TemplateInstance.
+     */
     @JsonProperty("template")
     public Template getTemplate() {
         return template;
     }
 
+    /**
+     * TemplateInstanceSpec describes the desired state of a TemplateInstance.
+     */
     @JsonProperty("template")
     public void setTemplate(Template template) {
         this.template = template;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateInstanceStatus.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateInstanceStatus.java
index 5b002aac233..611af6c93f0 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateInstanceStatus.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateInstanceStatus.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TemplateInstanceStatus describes the current state of a TemplateInstance.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,23 +89,35 @@ public TemplateInstanceStatus(List<TemplateInstanceCondition> conditions, List<T
         this.objects = objects;
     }
 
+    /**
+     * conditions represent the latest available observations of a TemplateInstance's current state.
+     */
     @JsonProperty("conditions")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TemplateInstanceCondition> getConditions() {
         return conditions;
     }
 
+    /**
+     * conditions represent the latest available observations of a TemplateInstance's current state.
+     */
     @JsonProperty("conditions")
     public void setConditions(List<TemplateInstanceCondition> conditions) {
         this.conditions = conditions;
     }
 
+    /**
+     * Objects references the objects created by the TemplateInstance.
+     */
     @JsonProperty("objects")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<TemplateInstanceObject> getObjects() {
         return objects;
     }
 
+    /**
+     * Objects references the objects created by the TemplateInstance.
+     */
     @JsonProperty("objects")
     public void setObjects(List<TemplateInstanceObject> objects) {
         this.objects = objects;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateList.java
index 18615201595..a3fa55e3aec 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/TemplateList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * TemplateList is a list of Template objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class TemplateList implements Editable<TemplateListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.Template>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "template.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.Template> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "TemplateList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public TemplateList(String apiVersion, List<io.fabric8.openshift.api.model.Templ
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is a list of templates
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.Template> getItems() {
         return items;
     }
 
+    /**
+     * Items is a list of templates
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.Template> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * TemplateList is a list of Template objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * TemplateList is a list of Template objects.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/User.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/User.java
index a247ad0fd69..b4df8e91256 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/User.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/User.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Upon log in, every user of the system receives a User and Identity resource. Administrators may directly manipulate the attributes of the users for their own tracking, or set groups via the API. The user name is unique and is chosen based on the value provided by the identity provider - if a user already exists with the incoming name, the user name may have a number appended to it depending on the configuration of the system.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,9 +81,6 @@
 public class User implements Editable<UserBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "user.openshift.io/v1";
     @JsonProperty("fullName")
@@ -91,9 +91,6 @@ public class User implements Editable<UserBuilder>, HasMetadata
     @JsonProperty("identities")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<String> identities = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "User";
     @JsonProperty("metadata")
@@ -118,7 +115,7 @@ public User(String apiVersion, String fullName, List<String> groups, List<String
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -126,47 +123,65 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * FullName is the full name of user
+     */
     @JsonProperty("fullName")
     public String getFullName() {
         return fullName;
     }
 
+    /**
+     * FullName is the full name of user
+     */
     @JsonProperty("fullName")
     public void setFullName(String fullName) {
         this.fullName = fullName;
     }
 
+    /**
+     * Groups specifies group names this user is a member of. This field is deprecated and will be removed in a future release. Instead, create a Group object containing the name of this User.
+     */
     @JsonProperty("groups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getGroups() {
         return groups;
     }
 
+    /**
+     * Groups specifies group names this user is a member of. This field is deprecated and will be removed in a future release. Instead, create a Group object containing the name of this User.
+     */
     @JsonProperty("groups")
     public void setGroups(List<String> groups) {
         this.groups = groups;
     }
 
+    /**
+     * Identities are the identities associated with this user
+     */
     @JsonProperty("identities")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getIdentities() {
         return identities;
     }
 
+    /**
+     * Identities are the identities associated with this user
+     */
     @JsonProperty("identities")
     public void setIdentities(List<String> identities) {
         this.identities = identities;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -174,18 +189,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * Upon log in, every user of the system receives a User and Identity resource. Administrators may directly manipulate the attributes of the users for their own tracking, or set groups via the API. The user name is unique and is chosen based on the value provided by the identity provider - if a user already exists with the incoming name, the user name may have a number appended to it depending on the configuration of the system.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * Upon log in, every user of the system receives a User and Identity resource. Administrators may directly manipulate the attributes of the users for their own tracking, or set groups via the API. The user name is unique and is chosen based on the value provided by the identity provider - if a user already exists with the incoming name, the user name may have a number appended to it depending on the configuration of the system.<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/UserIdentityMapping.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/UserIdentityMapping.java
index 2818c26b25c..67c15965a72 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/UserIdentityMapping.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/UserIdentityMapping.java
@@ -36,6 +36,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UserIdentityMapping maps a user to an identity<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -75,16 +78,10 @@
 public class UserIdentityMapping implements Editable<UserIdentityMappingBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "user.openshift.io/v1";
     @JsonProperty("identity")
     private ObjectReference identity;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "UserIdentityMapping";
     @JsonProperty("metadata")
@@ -110,7 +107,7 @@ public UserIdentityMapping(String apiVersion, ObjectReference identity, String k
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -118,25 +115,31 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * UserIdentityMapping maps a user to an identity<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("identity")
     public ObjectReference getIdentity() {
         return identity;
     }
 
+    /**
+     * UserIdentityMapping maps a user to an identity<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("identity")
     public void setIdentity(ObjectReference identity) {
         this.identity = identity;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -144,28 +147,40 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * UserIdentityMapping maps a user to an identity<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * UserIdentityMapping maps a user to an identity<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * UserIdentityMapping maps a user to an identity<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("user")
     public ObjectReference getUser() {
         return user;
     }
 
+    /**
+     * UserIdentityMapping maps a user to an identity<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("user")
     public void setUser(ObjectReference user) {
         this.user = user;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/UserList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/UserList.java
index 38dfb881eff..7084a2fdd1f 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/UserList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/UserList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UserList is a collection of Users<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class UserList implements Editable<UserListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.User>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "user.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.User> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "UserList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public UserList(String apiVersion, List<io.fabric8.openshift.api.model.User> ite
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * Items is the list of users
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.User> getItems() {
         return items;
     }
 
+    /**
+     * Items is the list of users
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.User> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * UserList is a collection of Users<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * UserList is a collection of Users<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/UserOAuthAccessToken.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/UserOAuthAccessToken.java
index da578189845..4746b9bb35f 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/UserOAuthAccessToken.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/UserOAuthAccessToken.java
@@ -38,6 +38,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UserOAuthAccessToken is a virtual resource to mirror OAuthAccessTokens to the user the access token was issued for
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -84,9 +87,6 @@
 public class UserOAuthAccessToken implements Editable<UserOAuthAccessTokenBuilder>, HasMetadata
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "oauth.openshift.io/v1";
     @JsonProperty("authorizeToken")
@@ -97,9 +97,6 @@ public class UserOAuthAccessToken implements Editable<UserOAuthAccessTokenBuilde
     private Long expiresIn;
     @JsonProperty("inactivityTimeoutSeconds")
     private Integer inactivityTimeoutSeconds;
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "UserOAuthAccessToken";
     @JsonProperty("metadata")
@@ -141,7 +138,7 @@ public UserOAuthAccessToken(String apiVersion, String authorizeToken, String cli
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -149,55 +146,79 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * AuthorizeToken contains the token that authorized this token
+     */
     @JsonProperty("authorizeToken")
     public String getAuthorizeToken() {
         return authorizeToken;
     }
 
+    /**
+     * AuthorizeToken contains the token that authorized this token
+     */
     @JsonProperty("authorizeToken")
     public void setAuthorizeToken(String authorizeToken) {
         this.authorizeToken = authorizeToken;
     }
 
+    /**
+     * ClientName references the client that created this token.
+     */
     @JsonProperty("clientName")
     public String getClientName() {
         return clientName;
     }
 
+    /**
+     * ClientName references the client that created this token.
+     */
     @JsonProperty("clientName")
     public void setClientName(String clientName) {
         this.clientName = clientName;
     }
 
+    /**
+     * ExpiresIn is the seconds from CreationTime before this token expires.
+     */
     @JsonProperty("expiresIn")
     public Long getExpiresIn() {
         return expiresIn;
     }
 
+    /**
+     * ExpiresIn is the seconds from CreationTime before this token expires.
+     */
     @JsonProperty("expiresIn")
     public void setExpiresIn(Long expiresIn) {
         this.expiresIn = expiresIn;
     }
 
+    /**
+     * InactivityTimeoutSeconds is the value in seconds, from the CreationTimestamp, after which this token can no longer be used. The value is automatically incremented when the token is used.
+     */
     @JsonProperty("inactivityTimeoutSeconds")
     public Integer getInactivityTimeoutSeconds() {
         return inactivityTimeoutSeconds;
     }
 
+    /**
+     * InactivityTimeoutSeconds is the value in seconds, from the CreationTimestamp, after which this token can no longer be used. The value is automatically incremented when the token is used.
+     */
     @JsonProperty("inactivityTimeoutSeconds")
     public void setInactivityTimeoutSeconds(Integer inactivityTimeoutSeconds) {
         this.inactivityTimeoutSeconds = inactivityTimeoutSeconds;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -205,69 +226,105 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * UserOAuthAccessToken is a virtual resource to mirror OAuthAccessTokens to the user the access token was issued for
+     */
     @JsonProperty("metadata")
     public ObjectMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * UserOAuthAccessToken is a virtual resource to mirror OAuthAccessTokens to the user the access token was issued for
+     */
     @JsonProperty("metadata")
     public void setMetadata(ObjectMeta metadata) {
         this.metadata = metadata;
     }
 
+    /**
+     * RedirectURI is the redirection associated with the token.
+     */
     @JsonProperty("redirectURI")
     public String getRedirectURI() {
         return redirectURI;
     }
 
+    /**
+     * RedirectURI is the redirection associated with the token.
+     */
     @JsonProperty("redirectURI")
     public void setRedirectURI(String redirectURI) {
         this.redirectURI = redirectURI;
     }
 
+    /**
+     * RefreshToken is the value by which this token can be renewed. Can be blank.
+     */
     @JsonProperty("refreshToken")
     public String getRefreshToken() {
         return refreshToken;
     }
 
+    /**
+     * RefreshToken is the value by which this token can be renewed. Can be blank.
+     */
     @JsonProperty("refreshToken")
     public void setRefreshToken(String refreshToken) {
         this.refreshToken = refreshToken;
     }
 
+    /**
+     * Scopes is an array of the requested scopes.
+     */
     @JsonProperty("scopes")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getScopes() {
         return scopes;
     }
 
+    /**
+     * Scopes is an array of the requested scopes.
+     */
     @JsonProperty("scopes")
     public void setScopes(List<String> scopes) {
         this.scopes = scopes;
     }
 
+    /**
+     * UserName is the user name associated with this token
+     */
     @JsonProperty("userName")
     public String getUserName() {
         return userName;
     }
 
+    /**
+     * UserName is the user name associated with this token
+     */
     @JsonProperty("userName")
     public void setUserName(String userName) {
         this.userName = userName;
     }
 
+    /**
+     * UserUID is the unique UID associated with this token
+     */
     @JsonProperty("userUID")
     public String getUserUID() {
         return userUID;
     }
 
+    /**
+     * UserUID is the unique UID associated with this token
+     */
     @JsonProperty("userUID")
     public void setUserUID(String userUID) {
         this.userUID = userUID;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/UserOAuthAccessTokenList.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/UserOAuthAccessTokenList.java
index a34fb3b3e13..d078288b450 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/UserOAuthAccessTokenList.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/UserOAuthAccessTokenList.java
@@ -40,6 +40,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UserOAuthAccessTokenList is a collection of access tokens issued on behalf of the requesting user<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -78,17 +81,11 @@
 public class UserOAuthAccessTokenList implements Editable<UserOAuthAccessTokenListBuilder>, KubernetesResource, KubernetesResourceList<io.fabric8.openshift.api.model.UserOAuthAccessToken>
 {
 
-    /**
-     * (Required)
-     */
     @JsonProperty("apiVersion")
     private String apiVersion = "oauth.openshift.io/v1";
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     private List<io.fabric8.openshift.api.model.UserOAuthAccessToken> items = new ArrayList<>();
-    /**
-     * (Required)
-     */
     @JsonProperty("kind")
     private String kind = "UserOAuthAccessTokenList";
     @JsonProperty("metadata")
@@ -111,7 +108,7 @@ public UserOAuthAccessTokenList(String apiVersion, List<io.fabric8.openshift.api
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public String getApiVersion() {
@@ -119,26 +116,32 @@ public String getApiVersion() {
     }
 
     /**
-     * (Required)
+     * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
      */
     @JsonProperty("apiVersion")
     public void setApiVersion(String apiVersion) {
         this.apiVersion = apiVersion;
     }
 
+    /**
+     * UserOAuthAccessTokenList is a collection of access tokens issued on behalf of the requesting user<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<io.fabric8.openshift.api.model.UserOAuthAccessToken> getItems() {
         return items;
     }
 
+    /**
+     * UserOAuthAccessTokenList is a collection of access tokens issued on behalf of the requesting user<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("items")
     public void setItems(List<io.fabric8.openshift.api.model.UserOAuthAccessToken> items) {
         this.items = items;
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public String getKind() {
@@ -146,18 +149,24 @@ public String getKind() {
     }
 
     /**
-     * (Required)
+     * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      */
     @JsonProperty("kind")
     public void setKind(String kind) {
         this.kind = kind;
     }
 
+    /**
+     * UserOAuthAccessTokenList is a collection of access tokens issued on behalf of the requesting user<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public ListMeta getMetadata() {
         return metadata;
     }
 
+    /**
+     * UserOAuthAccessTokenList is a collection of access tokens issued on behalf of the requesting user<br><p> <br><p> Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
+     */
     @JsonProperty("metadata")
     public void setMetadata(ListMeta metadata) {
         this.metadata = metadata;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/UserRestriction.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/UserRestriction.java
index f5264c3f824..a9cd7aee303 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/UserRestriction.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/UserRestriction.java
@@ -34,6 +34,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * UserRestriction matches a user either by a string match on the user name, a string match on the name of a group to which the user belongs, or a label selector applied to the user labels.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -91,34 +94,52 @@ public UserRestriction(List<String> groups, List<LabelSelector> labels, List<Str
         this.users = users;
     }
 
+    /**
+     * Groups specifies a list of literal group names.
+     */
     @JsonProperty("groups")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getGroups() {
         return groups;
     }
 
+    /**
+     * Groups specifies a list of literal group names.
+     */
     @JsonProperty("groups")
     public void setGroups(List<String> groups) {
         this.groups = groups;
     }
 
+    /**
+     * Selectors specifies a list of label selectors over user labels.
+     */
     @JsonProperty("labels")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<LabelSelector> getLabels() {
         return labels;
     }
 
+    /**
+     * Selectors specifies a list of label selectors over user labels.
+     */
     @JsonProperty("labels")
     public void setLabels(List<LabelSelector> labels) {
         this.labels = labels;
     }
 
+    /**
+     * Users specifies a list of literal user names.
+     */
     @JsonProperty("users")
     @JsonInclude(JsonInclude.Include.NON_EMPTY)
     public List<String> getUsers() {
         return users;
     }
 
+    /**
+     * Users specifies a list of literal user names.
+     */
     @JsonProperty("users")
     public void setUsers(List<String> users) {
         this.users = users;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/WebHookTrigger.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/WebHookTrigger.java
index 7f5b8256d7a..698d7a5fb6e 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/WebHookTrigger.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/WebHookTrigger.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * WebHookTrigger is a trigger that gets invoked using a webhook type of post
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -86,31 +89,49 @@ public WebHookTrigger(Boolean allowEnv, String secret, SecretLocalReference secr
         this.secretReference = secretReference;
     }
 
+    /**
+     * allowEnv determines whether the webhook can set environment variables; can only be set to true for GenericWebHook.
+     */
     @JsonProperty("allowEnv")
     public Boolean getAllowEnv() {
         return allowEnv;
     }
 
+    /**
+     * allowEnv determines whether the webhook can set environment variables; can only be set to true for GenericWebHook.
+     */
     @JsonProperty("allowEnv")
     public void setAllowEnv(Boolean allowEnv) {
         this.allowEnv = allowEnv;
     }
 
+    /**
+     * secret used to validate requests. Deprecated: use SecretReference instead.
+     */
     @JsonProperty("secret")
     public String getSecret() {
         return secret;
     }
 
+    /**
+     * secret used to validate requests. Deprecated: use SecretReference instead.
+     */
     @JsonProperty("secret")
     public void setSecret(String secret) {
         this.secret = secret;
     }
 
+    /**
+     * WebHookTrigger is a trigger that gets invoked using a webhook type of post
+     */
     @JsonProperty("secretReference")
     public SecretLocalReference getSecretReference() {
         return secretReference;
     }
 
+    /**
+     * WebHookTrigger is a trigger that gets invoked using a webhook type of post
+     */
     @JsonProperty("secretReference")
     public void setSecretReference(SecretLocalReference secretReference) {
         this.secretReference = secretReference;
diff --git a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/customresourcestatus/conditions/v1/Condition.java b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/customresourcestatus/conditions/v1/Condition.java
index 2677fc34e6a..695f6273d65 100644
--- a/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/customresourcestatus/conditions/v1/Condition.java
+++ b/kubernetes-model-generator/openshift-model/src/generated/java/io/fabric8/openshift/api/model/customresourcestatus/conditions/v1/Condition.java
@@ -32,6 +32,9 @@
 import lombok.ToString;
 import lombok.experimental.Accessors;
 
+/**
+ * Condition represents the state of the operator's reconciliation functionality.
+ */
 @JsonDeserialize(using = com.fasterxml.jackson.databind.JsonDeserializer.None.class)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 @JsonPropertyOrder({
@@ -98,61 +101,97 @@ public Condition(String lastHeartbeatTime, String lastTransitionTime, String mes
         this.type = type;
     }
 
+    /**
+     * Condition represents the state of the operator's reconciliation functionality.
+     */
     @JsonProperty("lastHeartbeatTime")
     public String getLastHeartbeatTime() {
         return lastHeartbeatTime;
     }
 
+    /**
+     * Condition represents the state of the operator's reconciliation functionality.
+     */
     @JsonProperty("lastHeartbeatTime")
     public void setLastHeartbeatTime(String lastHeartbeatTime) {
         this.lastHeartbeatTime = lastHeartbeatTime;
     }
 
+    /**
+     * Condition represents the state of the operator's reconciliation functionality.
+     */
     @JsonProperty("lastTransitionTime")
     public String getLastTransitionTime() {
         return lastTransitionTime;
     }
 
+    /**
+     * Condition represents the state of the operator's reconciliation functionality.
+     */
     @JsonProperty("lastTransitionTime")
     public void setLastTransitionTime(String lastTransitionTime) {
         this.lastTransitionTime = lastTransitionTime;
     }
 
+    /**
+     * Condition represents the state of the operator's reconciliation functionality.
+     */
     @JsonProperty("message")
     public String getMessage() {
         return message;
     }
 
+    /**
+     * Condition represents the state of the operator's reconciliation functionality.
+     */
     @JsonProperty("message")
     public void setMessage(String message) {
         this.message = message;
     }
 
+    /**
+     * Condition represents the state of the operator's reconciliation functionality.
+     */
     @JsonProperty("reason")
     public String getReason() {
         return reason;
     }
 
+    /**
+     * Condition represents the state of the operator's reconciliation functionality.
+     */
     @JsonProperty("reason")
     public void setReason(String reason) {
         this.reason = reason;
     }
 
+    /**
+     * Condition represents the state of the operator's reconciliation functionality.
+     */
     @JsonProperty("status")
     public String getStatus() {
         return status;
     }
 
+    /**
+     * Condition represents the state of the operator's reconciliation functionality.
+     */
     @JsonProperty("status")
     public void setStatus(String status) {
         this.status = status;
     }
 
+    /**
+     * Condition represents the state of the operator's reconciliation functionality.
+     */
     @JsonProperty("type")
     public String getType() {
         return type;
     }
 
+    /**
+     * Condition represents the state of the operator's reconciliation functionality.
+     */
     @JsonProperty("type")
     public void setType(String type) {
         this.type = type;
diff --git a/kubernetes-model-generator/pom.xml b/kubernetes-model-generator/pom.xml
index cb4caa527b3..4f52d1aa386 100644
--- a/kubernetes-model-generator/pom.xml
+++ b/kubernetes-model-generator/pom.xml
@@ -172,7 +172,7 @@
               <packageName>io.fabric8.kubernetes.api.model</packageName>
               <builderPackage>io.fabric8.kubernetes.api.builder</builderPackage>
               <addBuildableReferences>true</addBuildableReferences>
-              <generateJavadoc>false</generateJavadoc>
+              <generateJavadoc>true</generateJavadoc>
               <packageMappings>
                 <com.coreos.monitoring>io.fabric8.openshift.api.model.monitoring</com.coreos.monitoring>
                 <com.github.openshift.custom-resource-status>io.fabric8.openshift.api.model.customresourcestatus</com.github.openshift.custom-resource-status>